catcode/protocol.schema.json at master · catalystctl/catcode · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://catalystctl.dev/catcode/protocol.schema.json",
  "title": "CatCode JSONL protocol v2",
  "anyOf": [
    { "$ref": "#/$defs/command" },
    { "$ref": "#/$defs/event" }
  ],
  "$defs": {
    "client": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "version": { "type": "string" },
        "capabilities": { "type": "array", "items": { "type": "string" } }
      },
      "additionalProperties": true
    },
    "command": {
      "type": "object",
      "required": ["type"],
      "properties": {
        "type": {
          "enum": [
            "init", "set_key", "set_search_key", "set_provider",
            "list_provider_presets", "login", "logout", "login_oauth",
            "oauth_code", "oauth_cancel", "send", "steer", "abort", "clear_queue",

            "reset", "clear", "undo", "create_checkpoint",
            "list_checkpoints", "restore_checkpoint", "compact",
            "list_sessions", "load_session", "rename_session",
            "delete_session", "pin_session", "new_session", "stats", "runtime_status",
            "context", "usage", "approve", "set_approval", "set_config",
            "install_plugin", "remove_plugin", "enable_plugin",
            "disable_plugin", "list_plugins", "reload_plugins",
            "plugin_trust_prompt", "plugin_trust_decisions",
            "list_mcp", "upsert_mcp", "remove_mcp",
            "plugin_command", "list_plugin_commands", "list_agents",
            "refresh_memory", "save_memory", "list_memory", "forget_memory",
            "intercom_reply", "ask_reply", "sudo_reply", "get_vision_config",
            "set_vision_config", "list_skills", "list_marketplace_skills", "accept_skill_disclaimer",
            "search_marketplace_skills", "install_marketplace_skill", "update_marketplace_skill",
            "remove_marketplace_skill", "refresh_models", "refresh_index", "apply_skill", "start_goal",
            "cancel_goal", "goal_status", "approve_goal_plan", "revise_goal",
            "job_list", "job_status", "job_wait", "job_cancel", "session_tree", "session_branch",
            "user_bash", "add_custom_provider", "discover_provider_models",
            "get_sandbox_status", "prepare_sandbox", "reset_sandbox",
            "get_browser_status", "prepare_browser"
          ]
        },
        "protocol_version": { "type": "integer", "minimum": 1 },
        "client": { "$ref": "#/$defs/client" }
      },
      "additionalProperties": true
    },
    "event": {
      "type": "object",
      "required": ["type", "protocol_version"],
      "properties": {
        "type": {
          "enum": [
            "aborted", "agents", "approval_changed", "approval_expired",
            "approval_request", "ask_request", "audit", "authed",
            "bash_execution", "checkpoint_created", "checkpoint_restored",
            "checkpoints", "compacted", "compacting", "config_changed",
            "context_breakdown", "cost_update", "delta", "digested", "done",
            "error", "file_change", "goal_certified", "goal_completion_summary",
            "goal_iteration", "goal_phase", "goal_plan", "goal_review_verdict",
            "goal_state", "goal_step_complete", "goal_step_verdict",
            "goal_verify_verdict", "history", "http_retry", "info",
            "intercom_message", "memory_list", "memory_saved", "metrics",
            "models", "models_refreshed", "index_refreshed", "mcp_servers", "oauth_prompt", "oauth_cancelled", "plugin_commands", "plugin_disabled",
            "plugin_enabled", "plugin_error", "plugin_installed", "plugin_removed",
            "plugin_status", "plugins_list", "protocol_hello", "provider_changed",
            "plugin_trust_applied", "plugin_trust_prompt",
            "provider_presets", "ready", "reflecting", "reset", "run_cancelled",
            "runtime_status", "search_key_set", "session_change_failed",
            "session_changed", "session_deleted", "session_pinned",
            "session_recovered", "session_renamed", "sessions", "skills",
            "skill_marketplace_state", "skill_marketplace_results", "skill_marketplace_changed",
            "skill_marketplace_error", "job_list", "job_status", "job_wait_result",
            "job_cancel_requested", "job_cancel_result", "job_wait_timeout", "session_tree",
            "session_branch", "subagent_delivery", "stats", "steer", "subagent_done",
            "subagent_message", "subagent_progress", "subagent_start", "subagent_tool_call",
            "subagent_tool_result", "sudo_request", "thinking", "tool_call", "tool_call_args",
            "tool_call_name", "tool_call_start", "tool_result", "umans_conc", "usage",
            "vision_config", "work_state", "worktree_cleaned", "worktree_promoted",
            "worktree_ready", "worktree_seeded", "provider_models_preview", "sandbox_error",
            "sandbox_prepare_progress", "sandbox_ready", "sandbox_status", "stuck_nudge",
            "summary_required", "unfinished_work", "advisor_note", "advisor_status", "cleared", "discard_partial",
            "browser_status", "browser_prepare_progress", "browser_ready", "browser_error"
          ]
        },
        "protocol_version": { "const": 2 },
        "session_id": { "type": "string", "minLength": 1 },
        "run_id": { "type": "string", "minLength": 1 },
        "sequence": { "type": "integer", "minimum": 1 }
      },
      "additionalProperties": true
    }
  }
}