JSON-RPC stdio server

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "server_info": {
      "name": "meerkat-rpc",
      "version": "0.8.22"
    },
    "contract_version": "0.8.22",
    "methods": [
      "initialize", "initialized",
      "session/create", "session/list", "session/read",
      "turn/start", "turn/interrupt",
      "runtime/host_info", "config/get",
      "live/open", "mob/create"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "session/create",
  "params": {
    "prompt": "What is Rust?"
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "session/create",
  "params": {
    "prompt": "What is Rust?",
    "model": "claude-sonnet-4-6",
    "provider": "anthropic",
    "max_tokens": 4096,
    "system_prompt": "You are a helpful assistant.",
    "output_schema": {
      "schema": {"type": "object", "properties": {"answer": {"type": "string"}}},
      "name": "answer"
    },
    "structured_output_retries": 2,
    "hooks_override": null,
    "enable_builtins": false,
    "enable_shell": false,
    "enable_memory": false,
    "enable_schedule": null,
    "enable_workgraph": null,
    "keep_alive": null,
    "comms_name": null,
    "provider_params": null,
    "preload_skills": [
      {"source_uuid": "dc256086-0d2f-4f61-a307-320d4148107f", "skill_name": "extraction-email"}
    ],
    "skill_refs": [
      {
        "kind": "structured",
        "source_uuid": "dc256086-0d2f-4f61-a307-320d4148107f",
        "skill_name": "formatting-markdown"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "session_id": "01936f8a-7b2c-7000-8000-000000000001",
    "text": "Rust is a systems programming language...",
    "turns": 1,
    "tool_calls": 0,
    "usage": {
      "input_tokens": 50,
      "output_tokens": 200,
      "total_tokens": 250
    },
    "structured_output": null,
    "schema_warnings": null
  }
}

{"jsonrpc":"2.0","id":3,"method":"session/list"}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "sessions": [
      {"session_id": "01936f8a-...", "state": "idle"},
      {"session_id": "01936f8b-...", "state": "running"}
    ]
  }
}

{"jsonrpc":"2.0","id":4,"method":"session/read","params":{"session_id":"01936f8a-..."}}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "session_id": "01936f8a-...",
    "state": "idle",
    "message_count": 4,
    "total_tokens": 500
  }
}

{"jsonrpc":"2.0","id":5,"method":"session/archive","params":{"session_id":"01936f8a-..."}}

{"jsonrpc":"2.0","id":5,"result":{"archived":true}}

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "turn/start",
  "params": {
    "session_id": "01936f8a-...",
    "prompt": "Can you explain ownership?",
    "skill_refs": [
      {
        "kind": "structured",
        "source_uuid": "dc256086-0d2f-4f61-a307-320d4148107f",
        "skill_name": "rust-patterns-ownership"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "session_id": "01936f8a-...",
    "text": "Ownership is Rust's approach to memory management...",
    "turns": 1,
    "tool_calls": 0,
    "usage": {
      "input_tokens": 300,
      "output_tokens": 400,
      "total_tokens": 700
    },
    "structured_output": null,
    "schema_warnings": null
  }
}

{"jsonrpc":"2.0","id":7,"method":"turn/interrupt","params":{"session_id":"01936f8a-..."}}

{"jsonrpc":"2.0","id":7,"result":{"interrupted":true}}

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "session/external_event",
  "params": {
    "session_id": "01936f8a-...",
    "kind": "generic_json",
    "event_type": "ci-pipeline",
    "payload": {"alert": "build failed", "repo": "main"}
  }
}

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "outcome_type": "accepted"
  }
}

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "session/peer_response_terminal",
  "params": {
    "session_id": "01936f8a-...",
    "peer_id": "00000000-0000-4000-8000-000000000161",
    "display_name": "analyst",
    "request_id": "00000000-0000-4000-8000-000000000162",
    "status": "completed",
    "result": {"token": "silver harbor"}
  }
}

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "outcome_type": "accepted",
    "input_id": "01936f8a-..."
  }
}

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "comms/peers",
  "params": {
    "session_id": "01936f8a-..."
  }
}

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "peers": [
      {
        "peer_id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "reviewer",
        "address": {
          "transport": "tcp",
          "endpoint": "127.0.0.1:4201"
        },
        "source": "trusted",
        "sendable_kinds": ["peer_message", "peer_request", "peer_response"],
        "capabilities": {
          "version": 1,
          "extensions": {"review": true}
        },
        "meta": {
          "description": "Reviews pull requests",
          "labels": {"role": "reviewer"}
        }
      },
      {
        "peer_id": "550e8400-e29b-41d4-a716-446655440002",
        "name": "coordinator",
        "address": {
          "transport": "inproc",
          "endpoint": "coordinator"
        },
        "source": "inproc",
        "sendable_kinds": ["peer_message", "peer_request", "peer_response"],
        "capabilities": {"version": 1, "extensions": {}},
        "meta": {}
      }
    ]
  }
}

{"jsonrpc":"2.0","id":12,"method":"skills/list"}

{
  "jsonrpc": "2.0",
  "id": 12,
  "result": {
    "skills": [
      {
        "key": {
          "source_uuid": "00000000-0000-4b11-8111-000000000001",
          "skill_name": "task-workflow"
        },
        "name": "Task Workflow",
        "description": "How to use task tools",
        "scope": "builtin",
        "source": {
          "source_uuid": "00000000-0000-4b11-8111-000000000001",
          "display_name": "embedded",
          "transport_kind": "embedded",
          "fingerprint": "embedded:inventory",
          "status": "active"
        },
        "is_active": true
      },
      {
        "key": {
          "source_uuid": "00000000-0000-4b11-8111-000000000002",
          "skill_name": "my-deployment"
        },
        "name": "Deployment Guide",
        "description": "Project-specific deployment",
        "scope": "project",
        "source": {
          "source_uuid": "00000000-0000-4b11-8111-000000000002",
          "display_name": "project",
          "transport_kind": "filesystem",
          "fingerprint": "filesystem:.rkat/skills",
          "status": "active"
        },
        "is_active": true
      },
      {
        "key": {
          "source_uuid": "dc256086-0d2f-4f61-a307-320d4148107f",
          "skill_name": "task-workflow"
        },
        "name": "Custom Task Workflow",
        "description": "Override tasks",
        "scope": "project",
        "source": {
          "source_uuid": "dc256086-0d2f-4f61-a307-320d4148107f",
          "display_name": "company",
          "transport_kind": "git",
          "fingerprint": "repo-7cc66f36fd9db1a1",
          "status": "active"
        },
        "is_active": true
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 22,
  "method": "live/status",
  "params": {
    "channel_id": "ch_01936f8a-..."
  }
}

{
  "jsonrpc": "2.0",
  "id": 23,
  "method": "live/send_input",
  "params": {
    "channel_id": "ch_01936f8a-...",
    "chunk": {
      "kind": "image",
      "idempotency_key": "turn-42-diagram",
      "mime": "image/png",
      "data": "iVBORw0KGgo..."
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 14,
  "method": "mcp/add",
  "params": {
    "session_id": "01936f8a-...",
    "server_config": {
      "name": "my-tools",
      "command": "npx",
      "args": ["-y", "@my/mcp-server"]
    },
    "persisted": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 14,
  "result": {
    "session_id": "01936f8a-...",
    "operation": "add",
    "server_name": "my-tools",
    "status": "staged",
    "persisted": false,
    "applied_at_turn": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 15,
  "method": "mcp/remove",
  "params": {
    "session_id": "01936f8a-...",
    "server_name": "my-tools",
    "persisted": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 15,
  "result": {
    "session_id": "01936f8a-...",
    "operation": "remove",
    "server_name": "my-tools",
    "status": "staged",
    "persisted": false,
    "applied_at_turn": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 16,
  "method": "mcp/reload",
  "params": {
    "session_id": "01936f8a-...",
    "server_name": "my-tools"
  }
}

{
  "jsonrpc": "2.0",
  "id": 16,
  "result": {
    "session_id": "01936f8a-...",
    "operation": "reload",
    "server_name": "my-tools",
    "status": "staged",
    "persisted": false,
    "applied_at_turn": null
  }
}

{"jsonrpc":"2.0","id":17,"method":"models/catalog"}

{
  "jsonrpc": "2.0",
  "id": 17,
  "result": {
    "contract_version": "0.8.22",
    "providers": [
      {
        "provider": "anthropic",
        "default_model_id": "claude-opus-5",
        "models": [
          {
            "id": "claude-opus-5",
            "display_name": "Claude Opus 5",
            "tier": "recommended",
            "context_window": 1000000,
            "max_output_tokens": 128000,
            "profile": {
              "model_family": "claude-opus-5",
              "supports_temperature": false,
              "supports_thinking": true,
              "supports_reasoning": false,
              "params_schema": {}
            }
          }
        ]
      }
    ]
  }
}

{"jsonrpc":"2.0","id":8,"method":"capabilities/get"}

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "contract_version": {"major": 0, "minor": 8, "patch": 22},
    "capabilities": [
      {
        "id": "sessions",
        "description": "Session lifecycle management",
        "status": "Available"
      },
      {
        "id": "structured_output",
        "description": "Structured output extraction with JSON schema",
        "status": "Available"
      },
      {
        "id": "hooks",
        "description": "Lifecycle hooks for tool and turn events",
        "status": "Available"
      },
      {
        "id": "builtins",
        "description": "Built-in tools (task management)",
        "status": {"DisabledByPolicy": {"description": "Disabled by config"}}
      },
      {
        "id": "shell",
        "description": "Shell command execution",
        "status": {"DisabledByPolicy": {"description": "Disabled by config"}}
      },
      {
        "id": "comms",
        "description": "Inter-agent communication",
        "status": {"NotCompiled": {"feature": "comms"}}
      },
      {
        "id": "memory_store",
        "description": "Semantic memory indexing",
        "status": "Available"
      },
      {
        "id": "skills",
        "description": "Skill loading and injection",
        "status": "Available"
      }
    ]
  }
}

{"jsonrpc":"2.0","id":9,"method":"config/get"}

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "config": {
      "agent": {
        "model": "claude-sonnet-4-6",
        "max_tokens_per_turn": 8192
      }
    },
    "generation": 3,
    "realm_id": "team-alpha",
    "instance_id": "rpc-worker-1",
    "backend": "sqlite",
    "resolved_paths": {
      "root": "/.../meerkat/realms/team-alpha",
      "manifest_path": "/.../realm_manifest.json",
      "config_path": "/.../config.toml",
      "sessions_sqlite_path": "/.../sessions.sqlite3",
      "sessions_jsonl_dir": "/.../sessions_jsonl"
    }
  }
}

{
  "jsonrpc":"2.0",
  "id":10,
  "method":"config/set",
  "params":{
    "config": {"agent":{"model":"gpt-5.5"}},
    "expected_generation": 3
  }
}

{
  "jsonrpc":"2.0",
  "id":10,
  "result": {
    "config": {"agent":{"model":"gpt-5.5"}},
    "generation": 4,
    "realm_id": "team-alpha",
    "instance_id": null,
    "backend": "sqlite",
    "resolved_paths": { "...": "..." }
  }
}

{
  "jsonrpc":"2.0",
  "id":11,
  "method":"config/patch",
  "params":{
    "patch":{"agent":{"max_tokens_per_turn":8192}},
    "expected_generation": 4
  }
}

{
  "jsonrpc":"2.0",
  "id":11,
  "result": {
    "config": {"agent":{"max_tokens_per_turn":8192}},
    "generation": 5,
    "realm_id": "team-alpha",
    "instance_id": null,
    "backend": "sqlite",
    "resolved_paths": { "...": "..." }
  }
}