dolphin_ping

Instructions

Implementation Reference

• src/tools.ts:66-74 (registration)

  Tool definition/registration for dolphin_ping in the TOOLS array. Declares name, description, and empty input schema.

  {
    name: "dolphin_ping",
    description:
      "PURPOSE: Verify the Dolphin Python bridge is reachable and responding. " +
      "USAGE: Call once at session start before other tool calls. Issues the bridge's `bridge.ping` method — doubles as a liveness probe and bridge-version sniff. " +
      "BEHAVIOR: No side effects. mcp-dolphin connects to the bridge on demand (TCP 127.0.0.1:55355 by default). The bridge must be loaded inside Dolphin via Scripting → Add New Script → mcp_bridge.py. 10-second timeout if the bridge isn't running, Dolphin isn't running, or the port is wrong. " +
      "RETURNS: Single line 'OK — bridge vBRIDGE_VERSION (DOLPHIN_LABEL)'.",
    inputSchema: { type: "object", properties: {} },
  },

• src/tools.ts:497-500 (handler)

  Handler implementation for dolphin_ping in the CallToolRequestSchema switch. Calls bridge.ping RPC and returns formatted OK string.

  case "dolphin_ping": {
    const r = await dol.call<{ bridge_version: string; dolphin: string }>("bridge.ping");
    return ok(`OK — bridge v${r.bridge_version} (${r.dolphin})`);
  }

• src/tools.ts:66-74 (schema)

  Schema definition for dolphin_ping — empty inputSchema (no params required) and the ok() helper used to format output.

  {
    name: "dolphin_ping",
    description:
      "PURPOSE: Verify the Dolphin Python bridge is reachable and responding. " +
      "USAGE: Call once at session start before other tool calls. Issues the bridge's `bridge.ping` method — doubles as a liveness probe and bridge-version sniff. " +
      "BEHAVIOR: No side effects. mcp-dolphin connects to the bridge on demand (TCP 127.0.0.1:55355 by default). The bridge must be loaded inside Dolphin via Scripting → Add New Script → mcp_bridge.py. 10-second timeout if the bridge isn't running, Dolphin isn't running, or the port is wrong. " +
      "RETURNS: Single line 'OK — bridge vBRIDGE_VERSION (DOLPHIN_LABEL)'.",
    inputSchema: { type: "object", properties: {} },
  },

• bridge/mcp_bridge.py:65-66 (helper)

  Python bridge handler for the 'bridge.ping' RPC method. Returns bridge version and Dolphin label.

  def _ping(_p):     return {"bridge_version": BRIDGE_VERSION, "dolphin": "Felk Python fork"}
  def _status(_p):   return {"state": "unknown (use dolphin_pause/dolphin_resume to control — but see bridge known-limitation about paused-deadlock)"}

• bridge/mcp_bridge.py:129-131 (registration)

  Registration of bridge.ping in the Python bridge HANDLERS dispatch table.

  HANDLERS = {
      "bridge.ping":                    _ping,
      "bridge.status":                  _status,