mixdog 0.7.1

package/tools.json

@@ -0,0 +1,1653 @@
+[
+  {
+    "name": "reply",
+    "title": "Discord Reply",
+    "annotations": {
+      "title": "Discord Reply",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true
+    },
+    "description": "Reply on channel.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat_id": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "reply_to": {
+          "type": "string"
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "embeds": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "components": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      },
+      "required": [
+        "chat_id",
+        "text"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "react",
+    "title": "Reaction",
+    "annotations": {
+      "title": "Reaction",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "description": "React to message.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat_id": {
+          "type": "string"
+        },
+        "message_id": {
+          "type": "string"
+        },
+        "emoji": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "chat_id",
+        "message_id",
+        "emoji"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "edit_message",
+    "title": "Edit Message",
+    "annotations": {
+      "title": "Edit Message",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "description": "Edit bot message.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat_id": {
+          "type": "string"
+        },
+        "message_id": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "embeds": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "components": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      },
+      "required": [
+        "chat_id",
+        "message_id",
+        "text"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "download_attachment",
+    "title": "Download Attachment",
+    "annotations": {
+      "title": "Download Attachment",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "description": "Download attachments.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat_id": {
+          "type": "string"
+        },
+        "message_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "chat_id",
+        "message_id"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "fetch",
+    "title": "Fetch",
+    "annotations": {
+      "title": "Fetch",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "description": "Discord-only: fetch recent messages from a Discord channel. Requires channel (id); optional limit (count). NOT for URLs or web pages — use web_fetch for those.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "channel"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "schedule_status",
+    "title": "Schedule Status",
+    "annotations": {
+      "title": "Schedule Status",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Show schedules.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "module": "channels"
+  },
+  {
+    "name": "trigger_schedule",
+    "title": "Trigger Schedule",
+    "annotations": {
+      "title": "Trigger Schedule",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Run a scheduled task immediately by name (fire it now). Requires name.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "schedule_control",
+    "title": "Schedule Control",
+    "annotations": {
+      "title": "Schedule Control",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Defer or skip a schedule (not run it now): action=defer (push by `minutes`) | skip_today. Requires name + action.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "action": {
+          "type": "string",
+          "enum": [
+            "defer",
+            "skip_today"
+          ]
+        },
+        "minutes": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "name",
+        "action"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "activate_channel_bridge",
+    "title": "Activate Channel Bridge",
+    "annotations": {
+      "title": "Activate Channel Bridge",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Set channel bridge active.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "active": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "active"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "reload_config",
+    "title": "Reload Config",
+    "annotations": {
+      "title": "Reload Config",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Reload config.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "module": "channels"
+  },
+  {
+    "name": "inject_command",
+    "title": "Inject Claude Code Slash Command",
+    "annotations": {
+      "title": "Inject Claude Code Slash Command",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    },
+    "description": "Inject slash command.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string",
+          "enum": [
+            "reload-plugins",
+            "clear"
+          ]
+        }
+      },
+      "required": [
+        "command"
+      ]
+    },
+    "module": "channels"
+  },
+  {
+    "name": "memory",
+    "title": "Memory Cycle",
+    "annotations": {
+      "title": "Memory Cycle",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Persistent memory operations. Requires action (status|core|manage|prune|rebuild|...). For core: op (add/edit/delete/list) + category + summary + project_id. To retrieve, use the recall tool.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "core",
+            "manage",
+            "status",
+            "sleep",
+            "cycle1",
+            "cycle2",
+            "cycle3",
+            "flush",
+            "backfill",
+            "prune",
+            "rebuild",
+            "purge",
+            "retro_eval_active"
+          ]
+        },
+        "op": {
+          "type": "string",
+          "enum": [
+            "add",
+            "edit",
+            "delete",
+            "list"
+          ]
+        },
+        "id": {
+          "type": "number"
+        },
+        "element": {
+          "type": "string"
+        },
+        "summary": {
+          "type": "string"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "rule",
+            "constraint",
+            "decision",
+            "fact",
+            "goal",
+            "preference",
+            "task",
+            "issue"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "active",
+            "archived"
+          ]
+        },
+        "maxDays": {
+          "type": "number"
+        },
+        "window": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "number"
+        },
+        "concurrency": {
+          "type": "number"
+        },
+        "confirm": {
+          "type": "string"
+        },
+        "cycle3Mode": {
+          "type": "string",
+          "enum": [
+            "proposal",
+            "conservative"
+          ]
+        },
+        "project_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "action"
+      ]
+    },
+    "module": "memory"
+  },
+  {
+    "name": "recall",
+    "title": "Recall",
+    "annotations": {
+      "title": "Recall",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Retrieve stored memory (past decisions, prior work, session history). Use when the user references earlier work (\"last time\", \"as we decided\"), when resuming a paused task, before re-proposing something possibly already decided, or when context beyond the injected core/recap slice is needed — the inject is a thin excerpt, not the store. query (string|array fan-out) and/or id; category/period/projectScope filters. Read-only and cheap: when in doubt, recall first.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "id": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "period": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "number"
+        },
+        "offset": {
+          "type": "number"
+        },
+        "sort": {
+          "type": "string",
+          "enum": [
+            "importance",
+            "date"
+          ]
+        },
+        "category": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "rule",
+                "constraint",
+                "decision",
+                "fact",
+                "goal",
+                "preference",
+                "task",
+                "issue"
+              ]
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "rule",
+                  "constraint",
+                  "decision",
+                  "fact",
+                  "goal",
+                  "preference",
+                  "task",
+                  "issue"
+                ]
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "includeArchived": {
+          "type": "boolean"
+        },
+        "projectScope": {
+          "type": "string"
+        },
+        "cwd": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "module": "memory"
+  },
+  {
+    "name": "search",
+    "title": "Mixdog Web Search",
+    "description": "Web search (SERP) for external/current info. Requires query (string|array). Snippets+URLs; web_fetch for bodies.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "site": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "web",
+            "news",
+            "images"
+          ]
+        },
+        "maxResults": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 20
+        },
+        "locale": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "country": {
+                  "type": "string"
+                },
+                "language": {
+                  "type": "string"
+                },
+                "region": {
+                  "type": "string"
+                },
+                "city": {
+                  "type": "string"
+                },
+                "timezone": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "contextSize": {
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high"
+          ]
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "additionalProperties": false
+    },
+    "annotations": {
+      "title": "Mixdog Web Search",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "module": "search"
+  },
+  {
+    "name": "web_fetch",
+    "title": "Mixdog Web Fetch",
+    "description": "Fetch full page body from a URL (web page, article, docs). Requires url. Use after search to read a result.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "startIndex": {
+          "type": "number",
+          "minimum": 0
+        },
+        "maxLength": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "additionalProperties": false
+    },
+    "annotations": {
+      "title": "Mixdog Web Fetch",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "module": "search"
+  },
+  {
+    "name": "list_models",
+    "title": "List Models",
+    "annotations": {
+      "title": "List Models",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "List models.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "module": "agent"
+  },
+  {
+    "name": "explore",
+    "title": "Explore",
+    "aiWrapped": true,
+    "annotations": {
+      "title": "Explore",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Read-only codebase EXPLORATION — fact-finding only: locate/map where and how things are implemented, for open-ended/unknown scope (for a known or partial identifier use code_graph; recall=memory, search=web). NOT a reviewer/auditor: explorers LOCATE and DESCRIBE code, never judge it — bug/quality/risk claims in explore output are UNVERIFIED leads; verify them (reviewer role or direct reads) before acting on or reporting them. Shape every query as a LOCATION/INVENTORY question (\"where is X handled\", \"which files implement Y\", \"what does Z read/write\") — NEVER a verdict question (\"is X correct/missing/inconsistent?\", \"are there gaps/bugs?\"); the judgment stays with the caller, applied to the coordinates explore returns. Query shaping (one-line, one topic per item, decompose a multi-part brief) is specified on the query parameter — follow it. Fan-out runs items in parallel; wall-clock = the slowest item. LEAD: default background:true (answer pushed via channel, avoids the 120s sync cap). BRIDGE WORKERS run it sync and SHOULD prefer it for a tree-wide enumeration or broad/unanchored exploration — ONE call offloads the whole sweep into a sub-agent instead of a long grep/code_graph storm; a bounded/known-anchor lookup stays a direct code_graph/grep call.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Array of independent ONE-LINE questions: each item is ONE short question on ONE topic — do NOT pass a whole brief/context dump as one item; DECOMPOSE a multi-part task into several one-line per-topic questions here. Split by topic; never one broad query. Each item must be location/inventory-shaped (where/which/what), never verdict-shaped (is-it-correct / are-there-problems)."
+        },
+        "cwd": {
+          "type": "string"
+        },
+        "background": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "additionalProperties": false
+    },
+    "module": "agent"
+  },
+  {
+    "name": "bridge",
+    "title": "Bridge to External Model",
+    "annotations": {
+      "title": "Bridge to External Model",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "bridgeHidden": true
+    },
+    "description": "Unified worker session control. type selects the action (default \"spawn\"). spawn: dispatch a detached worker — requires role + message (alias: prompt); optional tag names the session for later send/close (auto \"<role><n>\" if omitted). send: resume a worker by tag (or raw sess_ id) — requires tag + message. To CONTINUE the same task on the same files/context — fix rounds, re-reviews, iterative refinement, or any follow-up — PREFER reusing the original tag over a new spawn: it preserves the worker's transcript + file context + change history, so it is faster, cheaper (the prompt cache stays warm), and more accurate than re-discovering from scratch. The return's respawned flag = false when the live session continued (context kept), true when a closed/cold tag was respawned fresh (context reset). close: stop a worker — requires tag. list: enumerate active worker sessions with stage/staleness — no args (optional role/status filter).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "spawn",
+            "send",
+            "close",
+            "list"
+          ],
+          "description": "Action discriminator. Default \"spawn\"."
+        },
+        "role": {
+          "type": "string",
+          "description": "Worker role (from user-workflow). Required for spawn; optional filter for list."
+        },
+        "tag": {
+          "type": "string",
+          "description": "Stable session handle. spawn: optional name; send/close: required target (tag or raw sess_ id)."
+        },
+        "message": {
+          "type": "string",
+          "description": "Brief for spawn / follow-up for send. `prompt` is accepted as an alias on spawn. A spawn brief must state: goal+why, mode (write-code vs research-only), anchor (file:line/symbol/command), and done (output shape + stop condition)."
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Alias of message for spawn (backward compat)."
+        },
+        "status": {
+          "type": "string",
+          "description": "list: optional status filter (e.g. running, idle, error)."
+        },
+        "provider": {
+          "type": "string",
+          "description": "spawn: override the worker provider."
+        },
+        "model": {
+          "type": "string",
+          "description": "spawn: override the worker model."
+        },
+        "effort": {
+          "type": "string",
+          "description": "spawn: reasoning effort level for the worker."
+        },
+        "fast": {
+          "type": "boolean",
+          "description": "spawn: enable fast mode (lower-latency, lighter worker)."
+        },
+        "preset": {
+          "type": "string",
+          "description": "spawn: profile preset selecting provider/model/effort."
+        },
+        "isolation": {
+          "type": "string",
+          "enum": [
+            "worktree"
+          ],
+          "description": "spawn: run the worker in a dedicated git worktree + branch (opt-in; best-effort — falls back to the plain cwd outside a git repo). Use when parallel workers must edit the same files."
+        },
+        "brief": {
+          "type": "boolean",
+          "description": "list: return brief (condensed) session output."
+        },
+        "includeClosed": {
+          "type": "boolean",
+          "description": "list: include closed/finished sessions in the listing."
+        },
+        "context": {
+          "type": "string"
+        },
+        "ref": {
+          "type": "string"
+        },
+        "file": {
+          "type": "string"
+        },
+        "cwd": {
+          "type": "string"
+        },
+        "permission_mode": {
+          "type": "string",
+          "enum": [
+            "default",
+            "acceptEdits",
+            "bypassPermissions",
+            "plan"
+          ]
+        }
+      },
+      "required": []
+    },
+    "module": "agent"
+  },
+  {
+    "name": "code_graph",
+    "title": "Code Graph",
+    "annotations": {
+      "title": "Code Graph",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "compressible": false,
+      "compressibleLossless": true
+    },
+    "description": "Query the project code graph by `mode` — ONE call replaces many grep+read turns; the first-class way to locate a SYMBOL (function/class/variable/constant) or map a file. Reach for it BEFORE grep — grep is only for free-text / non-symbol content (string literals, config keys, log messages, comments).\n\nUPSTREAM-TRACE RULE (read first): to find who ultimately triggers a symbol, make EXACTLY ONE `callers` call with depth:N (2-5) on the ROOT and treat the returned tree as the FINAL, COMPLETE answer — every returned caller node carries its call-site file:line, so do NOT re-run `callers` on a node listed in the tree and do NOT grep/read those nodes to verify. One call, then report — and if the result ends with \"# NEXT\", just re-run with page:N+1 (still code_graph, never grep/read) until \"# END\".\n\nMODES:\n• LOCATE — find_symbol (exact name; body:true by default returns location + callees + full body in one call) or search (keyword/substring, file-less; lists matching symbol names + declaration file:line).\n• FILE-SCOPED (set file:) — overview (file summary; OR omit file for a whole-project summary), symbols (symbols declared in the file), imports (the file imports), dependents (files that import it), related (connected files).\n• TRACE A SYMBOL — callers / callees / references (who calls / is called / uses). Omit file: for exhaustive cross-module results; add file: only to narrow.\n• IMPACT — file-scoped blast-radius for a file (file: required), optionally narrowed by symbol.\n• BATCH — find_symbol / callers / callees / references accept symbols:[] to run many names in ONE call, so a call chain costs one call per LEVEL, not per symbol.\n• PREWARM — warm the graph/symbol cache; returns immediately.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "overview",
+            "imports",
+            "dependents",
+            "related",
+            "impact",
+            "symbols",
+            "find_symbol",
+            "search",
+            "references",
+            "callers",
+            "callees",
+            "prewarm"
+          ]
+        },
+        "file": {
+          "type": "string",
+          "description": "Target file (overview/symbols/imports/dependents/related/impact), or a scope filter on a symbol query."
+        },
+        "symbol": {
+          "type": "string",
+          "description": "Target identifier. For mode search, a keyword/substring to match symbol names (file-less)."
+        },
+        "symbols": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Batch query: find_symbol/callers/callees/references (and prewarm) run once per name in a single call. Use symbol for a single lookup."
+        },
+        "body": {
+          "type": "boolean",
+          "description": "find_symbol: include the declaration body. DEFAULT true — one call returns location + callees + body, no follow-up read; pass false for a compact locate-only result. Bodies over 120 lines arrive head/tail-elided with a \"read <path> symbol=<name>\" hint for the full text (300-line hard cap)."
+        },
+        "language": {
+          "type": "string",
+          "description": "Optional language hint (auto-detected from the file extension otherwise)."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max results to return."
+        },
+        "depth": {
+          "type": "number",
+          "description": "callers only. 1 = direct callers (default). 2-5 returns the transitive caller TREE (caller-of-caller) in ONE call, each node tagged with its call-site file:line — see the UPSTREAM-TRACE RULE in the tool description. Name-based (same-named functions across files merge)."
+        },
+        "page": {
+          "type": "number",
+          "description": "callers tree (depth>=2) only: 1-based page, 100 nodes/page. On \"# NEXT\", re-run the SAME query with page:N+1 (per the UPSTREAM-TRACE RULE)."
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Project root to scope the graph (defaults to the session cwd)."
+        }
+      },
+      "required": [
+        "mode"
+      ]
+    },
+    "module": "code_graph"
+  },
+  {
+    "name": "glob",
+    "title": "Mixdog Glob",
+    "annotations": {
+      "title": "Mixdog Glob",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "compressible": true
+    },
+    "description": "Find files by glob pattern (mtime-sorted). For name/size/date filters use list mode:find.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "pattern": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Glob or array."
+        },
+        "path": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Base dir or array."
+        },
+        "head_limit": {
+          "type": "number",
+          "description": "Max entries returned (mtime-sorted). A truncated listing ends with \"pass offset:N to continue\" — re-call with that offset to page."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Skip N entries before head_limit applies; use the footer-suggested value to page."
+        }
+      },
+      "required": [
+        "pattern"
+      ]
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "list",
+    "title": "Mixdog List Directory",
+    "annotations": {
+      "title": "Mixdog List Directory",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "compressible": true
+    },
+    "description": "List or find directory entries. mode: list | tree | find (name/size/date filter). fuzzy ranks by partial name. Default cwd.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "list",
+            "tree",
+            "find"
+          ],
+          "description": "Default list (flat dir). tree = recursive tree; find = name/size/date filter."
+        },
+        "depth": {
+          "type": "number"
+        },
+        "hidden": {
+          "type": "boolean"
+        },
+        "sort": {
+          "type": "string",
+          "enum": [
+            "name",
+            "mtime",
+            "size"
+          ]
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "any",
+            "file",
+            "dir"
+          ]
+        },
+        "head_limit": {
+          "type": "number",
+          "description": "Max entries returned. A truncated listing ends with \"[entries X-Y of T; pass offset:N to continue]\" — re-call with that offset to page."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Skip N entries before head_limit applies; use the footer-suggested value to page."
+        },
+        "include_noise": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "min_size": {
+          "type": "number"
+        },
+        "max_size": {
+          "type": "number"
+        },
+        "modified_after": {
+          "type": "string"
+        },
+        "modified_before": {
+          "type": "string"
+        },
+        "fuzzy": {
+          "type": "string",
+          "description": "Rank files by subsequence match of this partial name; overrides mode. e.g. \"edeng\" -> edit-engine.mjs."
+        }
+      },
+      "required": []
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "grep",
+    "title": "Mixdog Grep",
+    "annotations": {
+      "title": "Mixdog Grep",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "compressible": true
+    },
+    "description": "Search file contents (ripgrep): free-text / non-symbol content. For a symbol by name use code_graph, not grep. pattern (regex) or glob. output_mode: content (default) | files_with_matches | count. Array pattern matches several in ONE call. -A/-B/-C is line-based — useless on minified/single-line files; use -o or multiline.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "pattern": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Ripgrep regex, or an array of regexes (OR-matched; <=20, <=5 with multiline) to match several in one call."
+        },
+        "path": {
+          "type": "string"
+        },
+        "glob": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Glob, or an array of globs, to filter files."
+        },
+        "output_mode": {
+          "type": "string",
+          "enum": [
+            "files_with_matches",
+            "content",
+            "count"
+          ],
+          "description": "Default content (matching lines). files_with_matches = paths only; count = per-file counts."
+        },
+        "head_limit": {
+          "type": "number",
+          "description": "Max result lines (default 80; 0 = unlimited). Truncated output says how many results remain."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Skip N result lines before head_limit applies — for paging large result sets."
+        },
+        "-i": {
+          "type": "boolean"
+        },
+        "-n": {
+          "type": "boolean"
+        },
+        "-A": {
+          "type": "number"
+        },
+        "-B": {
+          "type": "number"
+        },
+        "-C": {
+          "type": "number",
+          "description": "Context lines (with -A/-B). Line-based; no effect on single-line/minified files — use -o."
+        },
+        "context": {
+          "type": "number"
+        },
+        "multiline": {
+          "type": "boolean",
+          "description": "Dot matches newlines; patterns span lines (rg -U). Pair with -o on single-line/minified files."
+        },
+        "-o": {
+          "type": "boolean",
+          "description": "Only matching parts (rg --only-matching)."
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "required": []
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "read",
+    "title": "Mixdog Read",
+    "annotations": {
+      "title": "Mixdog Read",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false,
+      "compressible": false
+    },
+    "description": "Read file contents (path required). symbol=NAME = whole definition; offset/limit or line/context = window; mode/max_lines = whole-file glance. Batch all regions of a file in one call. Output is the file text verbatim (line-number prefix only, no character escaping) — a \\uXXXX you see is literally in the file.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "offset": {
+          "type": "number",
+          "description": "Start line for a windowed read (1-based)."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max lines to read (default 2000; full:true uncaps)."
+        },
+        "line": {
+          "type": "number"
+        },
+        "context": {
+          "type": "number",
+          "description": "Lines around `line` (default 20)."
+        },
+        "pages": {
+          "type": "string"
+        },
+        "symbol": {
+          "type": "string",
+          "description": "Read a whole symbol body (function/class/const) via the code graph."
+        },
+        "language": {
+          "type": "string",
+          "description": "Language hint for symbol resolution."
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "head",
+            "tail",
+            "count",
+            "summary",
+            "hex"
+          ],
+          "description": "Whole-file glance: head/tail (first/last n), count (line/word/byte stats), summary (stats+head), hex (binary preview). For a window use offset/limit."
+        },
+        "n": {
+          "type": "number",
+          "description": "Line count for mode head/tail/summary (default 20)."
+        },
+        "full": {
+          "type": "boolean",
+          "description": "Default false. true = return whole file (bypass 2000-line cap; still byte-capped)."
+        },
+        "max_lines": {
+          "type": "number",
+          "description": "Whole-file read: cap output to ~N lines. Ignored with offset/limit/mode."
+        },
+        "budget": {
+          "type": "string",
+          "enum": [
+            "compact"
+          ],
+          "description": "Auto-shrink: whole-file -> count; line -> context<=20; range -> limit<=120."
+        }
+      }
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "edit",
+    "title": "Mixdog Edit",
+    "annotations": {
+      "title": "Mixdog Edit",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Exact-string editor for small known substitutions; for large or structural changes prefer apply_patch. operation: replace (default) | notebook | rename.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "operation": {
+          "type": "string",
+          "enum": [
+            "replace",
+            "notebook",
+            "rename"
+          ],
+          "description": "Edit mode: \"replace\" (default, exact text edit), \"notebook\" (Jupyter cell edit), or \"rename\" (symbol rename)."
+        },
+        "path": {
+          "type": "string"
+        },
+        "old_string": {
+          "type": "string"
+        },
+        "new_string": {
+          "type": "string"
+        },
+        "replace_all": {
+          "type": "boolean"
+        },
+        "edits": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "old_string": {
+                "type": "string"
+              },
+              "new_string": {
+                "type": "string"
+              },
+              "replace_all": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "old_string",
+              "new_string"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1,
+          "description": "Batch replacements (operation:\"replace\")."
+        },
+        "notebook_path": {
+          "type": "string",
+          "description": "operation:\"notebook\" — path to the .ipynb notebook to edit."
+        },
+        "cell_id": {
+          "type": "string",
+          "description": "operation:\"notebook\" — target cell: a real cell.id or a cell-N index. For insert, the new cell is placed after this cell (or at the start if omitted)."
+        },
+        "new_source": {
+          "type": "string",
+          "description": "operation:\"notebook\" — new source for the cell (not required for delete)."
+        },
+        "cell_type": {
+          "type": "string",
+          "enum": [
+            "code",
+            "markdown"
+          ],
+          "description": "operation:\"notebook\" — cell type. Required for insert; otherwise defaults to the current cell type."
+        },
+        "edit_mode": {
+          "type": "string",
+          "enum": [
+            "replace",
+            "insert",
+            "delete"
+          ],
+          "description": "operation:\"notebook\" — replace (default), insert, or delete."
+        },
+        "symbol": {
+          "type": "string",
+          "description": "operation:\"rename\" — identifier to rename."
+        },
+        "new_name": {
+          "type": "string",
+          "description": "operation:\"rename\" — new identifier."
+        },
+        "file": {
+          "type": "string",
+          "description": "operation:\"rename\" — optional file to scope the reference search."
+        },
+        "apply": {
+          "type": "boolean",
+          "description": "operation:\"rename\" — default false (preview). Set true to perform the rename."
+        }
+      }
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "write",
+    "title": "Mixdog Write",
+    "annotations": {
+      "title": "Mixdog Write",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Write a whole file — new, or a full rewrite of one already read. For partial edits use apply_patch; never overwrite an unread file.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "allow_unread_overwrite": {
+          "type": "boolean",
+          "description": "Default false. true = skip ONLY the read-before-overwrite snapshot gate when you already know the full intended content; all other write safety checks still apply."
+        },
+        "writes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path",
+              "content"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1,
+          "description": "Batch writes."
+        }
+      }
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "apply_patch",
+    "title": "Mixdog Apply Patch",
+    "annotations": {
+      "title": "Mixdog Apply Patch",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": false,
+      "compressible": false,
+      "compressibleLossless": true
+    },
+    "description": "The default editor for existing files — prefer over write/edit for any non-trivial change: self-validating — the hunk context lines ARE the match proof, so they must match the CURRENT file bytes EXACTLY (indentation included). If you have not read the target region this turn, read it first; guessed or stale context is the top cause of \"context not found\". Apply a patch (unified or V4A); set base_path to the repo root so a/... paths resolve. Multi-hunk/multi-file; dry_run validates without writing. Prefer V4A; see patch field for hunk syntax.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "patch": {
+          "type": "string",
+          "description": "Patch text; match `format`. V4A (preferred): `*** Begin Patch`…`*** End Patch`; per file `*** Update/Add/Delete File: <real path>` (no `a/`·`b/`); body lines ` `=context/`-`=del/`+`=add. Include ~3 UNCHANGED context lines above AND below each change, copied verbatim from the current file (indentation included). If 3 lines do not uniquely locate the snippet, add `@@ <enclosing class/function>` immediately above it; if a block repeats so often that one `@@`+3 lines is still ambiguous, stack multiple `@@` (e.g. `@@ class Foo` then `@@ def bar():`). `@@ <ctx>` anchors must quote a UNIQUE line ABOVE the whole context block — NOT a line you also include in the hunk body, and never below the edit (→ \"context not found\"). For files without classes/functions (JSON, config), prefer extra context lines over `@@`, or anchor on the enclosing key (e.g. `@@   \"items\": [`). No line counts. Unified: counted `@@ -A,B +C,D @@` headers required (bare `@@` rejected); `a/`·`b/` prefixes stripped on apply."
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "unified",
+            "v4a"
+          ],
+          "description": "Auto-detected if omitted. Prefer v4a (`*** Begin Patch` envelope, `@@ <ctx>` anchors, no line counts); unified needs counted `@@ -A,B +C,D @@` headers."
+        },
+        "base_path": {
+          "type": "string",
+          "description": "Repo root so a/... paths resolve."
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Default false. true = validate only, no write."
+        },
+        "reject_partial": {
+          "type": "boolean",
+          "description": "Default true (all-or-nothing). false = apply landed hunks, skip failures."
+        },
+        "fuzzy": {
+          "type": "boolean",
+          "description": "Default true: tolerate minor context drift; false = exact match."
+        }
+      },
+      "required": [
+        "patch"
+      ]
+    },
+    "module": "patch"
+  },
+  {
+    "name": "bash",
+    "title": "Mixdog Shell",
+    "annotations": {
+      "title": "Mixdog Shell",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "compressible": true
+    },
+    "description": "Shell for git/build/test/run. Use current-OS syntax: Windows default = PowerShell; POSIX default = /bin/sh. Always pass shell matching your syntax: 'bash' = POSIX via Git Bash, 'powershell' = PS cmdlets; omitting uses the OS default and mis-parses the other. run_in_background works for both shells, including Windows shell:'bash' (Git Bash). Single shell entry point; not for inline code you were asked to return.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string"
+        },
+        "cwd": {
+          "type": "string"
+        },
+        "timeout": {
+          "type": "number",
+          "description": "Timeout in ms, or seconds when <=600."
+        },
+        "merge_stderr": {
+          "type": "boolean"
+        },
+        "run_in_background": {
+          "type": "boolean"
+        },
+        "persistent": {
+          "type": "boolean"
+        },
+        "session_id": {
+          "type": "string"
+        },
+        "create": {
+          "type": "boolean",
+          "description": "Allow creating a new persistent session for an explicit session_id."
+        },
+        "close": {
+          "type": "boolean"
+        },
+        "shell": {
+          "type": "string",
+          "enum": [
+            "bash",
+            "powershell"
+          ],
+          "description": "Force the shell. On Windows: 'bash' runs the command through Git Bash (POSIX syntax), 'powershell' forces PowerShell. On POSIX: 'powershell' resolves pwsh if installed (errors if absent); 'bash' is /bin/sh (already the default). Always set this explicitly; omitting uses the OS default (PowerShell on Windows), where POSIX syntax fails to parse."
+        }
+      },
+      "required": [
+        "command"
+      ]
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "job_wait",
+    "title": "Background Job Control",
+    "annotations": {
+      "title": "Background Job Control",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    },
+    "description": "Control a bash run_in_background job by job_id. action: wait (default) | peek | kill. Not for bridge_*/sess_* ids.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "job_id": {
+          "type": "string",
+          "description": "job_id from bash with run_in_background:true."
+        },
+        "action": {
+          "type": "string",
+          "enum": [
+            "wait",
+            "peek",
+            "kill"
+          ],
+          "description": "wait (default) = block until done; peek = non-blocking status + output tail; kill = terminate."
+        },
+        "timeout_ms": {
+          "type": "number"
+        },
+        "poll_ms": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "job_id"
+      ]
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "diagnostics",
+    "title": "Mixdog Diagnostics",
+    "annotations": {
+      "title": "Mixdog Diagnostics",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "compressible": true
+    },
+    "description": "Run the matching type/lint checker under path (tsc/eslint/ruff/etc.). Default cwd; no LSP.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File or directory to diagnose. Defaults to cwd."
+        }
+      },
+      "required": []
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "open_config",
+    "title": "Open Config UI",
+    "annotations": {
+      "title": "Open Config UI",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Open the mixdog settings UI (Providers + Presets) in the browser. Starts the resident config server if needed and returns the UI URL. No params.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "module": "builtin"
+  },
+  {
+    "name": "inject_input",
+    "title": "Inject Input",
+    "annotations": {
+      "title": "Inject Input",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true,
+      "compressible": false
+    },
+    "description": "Inject text into the host session as if the user typed it at the prompt. Requires text.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "module": "host_input"
+  },
+  {
+    "name": "cwd",
+    "title": "Session CWD",
+    "annotations": {
+      "title": "Session CWD",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "description": "Session cwd for relative paths (not a sandbox): get/set/list. set updates session-wide cwd for tools and bridge workers — set on project switch. list: repos you commit to (cwd.identityEmails), minus plugin-cache/codex; all:true for full scan.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "get",
+            "set",
+            "list"
+          ]
+        },
+        "path": {
+          "type": "string"
+        },
+        "refresh": {
+          "type": "boolean"
+        },
+        "all": {
+          "type": "boolean"
+        }
+      }
+    },
+    "module": "cwd"
+  }
+]