{
  "id": "agent-knock-knock",
  "name": "Agent Knock Knock",
  "categories": ["developer-tools"],
  "description": "Select a conversation once; AKK prefers the shared backend for Codex and an exact managed terminal for new Claude Code Sends, using the Claude native inbox when no controllable terminal exists. Existing tasks keep their original routes and uncertain input is never replayed. Control loaded Codex CLI threads directly for discovery, tasks, exact completion callbacks, approvals, answers and permission settings without tmux or Herdr. Discover Codex Desktop sidebar members or search history, send to live owners, observe exact completion, handle supported approvals and questions, change current-conversation settings, and cancel exact tasks. Standard Claude Code and configured wrappers such as tclaude share the same adapter. Eligible tmux or Herdr controls provide native inspection, model and thread lifecycle operations, managed monitoring, approvals and question responses; permission-mode switching remains Codex-only. Availability follows exact identity, runtime evidence and current action authority.",
  "activation": {
    "onStartup": true,
    "onCommands": ["akk"]
  },
  "commandAliases": [
    {
      "name": "akk",
      "kind": "runtime-slash"
    }
  ],
  "contracts": {
    "tools": [
      "agent_knock_knock_list",
      "agent_knock_knock_watches",
      "agent_knock_knock_watch",
      "agent_knock_knock_unwatch",
      "agent_knock_knock_list_resumable_threads",
      "agent_knock_knock_native_inspect",
      "agent_knock_knock_model_options",
      "agent_knock_knock_repair_model_control",
      "agent_knock_knock_set_model",
      "agent_knock_knock_permission_options",
      "agent_knock_knock_set_permissions",
      "agent_knock_knock_identify_foreground",
      "agent_knock_knock_identify_and_send",
      "agent_knock_knock_new_thread",
      "agent_knock_knock_desktop_create",
      "agent_knock_knock_reconcile_binding",
      "agent_knock_knock_resume_thread",
      "agent_knock_knock_status",
      "agent_knock_knock_send",
      "agent_knock_knock_respond",
      "agent_knock_knock_respond_interaction",
      "agent_knock_knock_renew",
      "agent_knock_knock_recover",
      "agent_knock_knock_retry_callback",
      "agent_knock_knock_cancel",
      "agent_knock_knock_close",
      "agent_knock_knock_approve"
    ]
  },
  "toolMetadata": {
    "agent_knock_knock_list": {
      "optional": true
    },
    "agent_knock_knock_watches": {
      "optional": true
    },
    "agent_knock_knock_watch": {
      "optional": true
    },
    "agent_knock_knock_unwatch": {
      "optional": true
    },
    "agent_knock_knock_list_resumable_threads": {
      "optional": true
    },
    "agent_knock_knock_native_inspect": {
      "optional": true
    },
    "agent_knock_knock_model_options": {
      "optional": true
    },
    "agent_knock_knock_repair_model_control": {
      "optional": true
    },
    "agent_knock_knock_set_model": {
      "optional": true
    },
    "agent_knock_knock_permission_options": {
      "optional": true
    },
    "agent_knock_knock_set_permissions": {
      "optional": true
    },
    "agent_knock_knock_identify_foreground": {
      "optional": true
    },
    "agent_knock_knock_identify_and_send": {
      "optional": true
    },
    "agent_knock_knock_new_thread": {
      "optional": true
    },
    "agent_knock_knock_desktop_create": {
      "optional": true
    },
    "agent_knock_knock_reconcile_binding": {
      "optional": true
    },
    "agent_knock_knock_resume_thread": {
      "optional": true
    },
    "agent_knock_knock_status": {
      "optional": true
    },
    "agent_knock_knock_send": {
      "optional": true
    },
    "agent_knock_knock_respond": {
      "optional": true
    },
    "agent_knock_knock_respond_interaction": {
      "optional": true
    },
    "agent_knock_knock_renew": {
      "optional": true
    },
    "agent_knock_knock_recover": {
      "optional": true
    },
    "agent_knock_knock_retry_callback": {
      "optional": true
    },
    "agent_knock_knock_cancel": {
      "optional": true
    },
    "agent_knock_knock_close": {
      "optional": true
    },
    "agent_knock_knock_approve": {
      "optional": true
    }
  },
  "skills": [
    "templates/openclaw-skills/agent-knock-knock"
  ],
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "storeDir": {
        "type": "string",
        "description": "Stable AKK Store root. Defaults to ~/.agent-knock-knock/store and contains the compatibility manifest, authoritative managed Sessions and Turns, plus durable terminal and Desktop Watch records."
      },
      "openclawBin": {
        "type": "string",
        "description": "Path to the OpenClaw CLI used by callback delivery. Defaults to PATH plus common user install locations."
      },
      "codexHome": {
        "type": "string",
        "description": "Optional CODEX_HOME path used for Codex terminal metadata and local Desktop conversation discovery and IPC."
      },
      "idleTimeoutMinutes": {
        "type": "number",
        "description": "Minutes a completed or idle AKK turn record remains retained before controlled reconciliation closes that turn. The continuing AKK session identity is preserved. Defaults to 10080."
      },
      "agentTimeoutMinutes": {
        "type": "number",
        "description": "Minutes without terminal activity or a coding-agent callback before AKK marks a managed turn stalled. Defaults to 60."
      },
      "agentHardTimeoutMinutes": {
        "type": "number",
        "exclusiveMinimum": 0,
        "description": "Default hard monitoring lifetime for Codex CLI backend/Desktop Send and Watch, Terminal Watch, and managed terminal tasks; also used by backend renew when minutes is omitted. Explicit call parameters take precedence. Defaults to 720 minutes. Independent of the managed terminal inactivity timeout."
      },
      "autoApprove": {
        "type": "object",
        "additionalProperties": false,
        "description": "Deterministic, default-disabled exact command-vector and workspace policy for terminal-controlled Codex and hookless Claude. Claude auto-approval also requires a current managed one-time Bash prompt with matching local transcript evidence. Policy configuration is trusted and never exposed as model-controlled tool parameters.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false
          },
          "rules": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": ["id", "agents", "workspaces", "commands"],
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1
                },
                "agents": {
                  "type": "array",
                  "minItems": 1,
                  "items": {
                    "type": "string",
                    "enum": ["codex", "claude"]
                  }
                },
                "workspaces": {
                  "type": "array",
                  "minItems": 1,
                  "description": "One or more absolute workspace roots authorized by this automatic-approval rule.",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "commands": {
                  "type": "array",
                  "minItems": 1,
                  "items": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
