cwtools-shared 0.1.0

package/dist/generated/mcpTools.js

@@ -0,0 +1,1247 @@
+"use strict";
+// Generated by tools/generate-mcp-schema.cjs from client/extension/ai/tools/definitions.ts and registry.ts.
+// Do not edit by hand; run npm run generate:mcp-schema.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATED_MCP_TOOLS = void 0;
+exports.GENERATED_MCP_TOOLS = [
+    {
+        "tool": {
+            "name": "query_types",
+            "description": "Warning: MANDATORY before using any game ID. Query defined instances of a current-game PDXScript type from mod + vanilla cache. PDXscript IDs are routinely hallucinated - always verify through this tool. Set filter to narrow results.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "typeName": {
+                        "type": "string",
+                        "description": "Exact current-game type name returned by query_cwt_schema, completion, or another typed LSP result."
+                    },
+                    "filter": {
+                        "type": "string",
+                        "description": "Prefix or substring filter. ALWAYS use when looking up a specific vanilla ID to avoid unrelated results."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results to return (default 30, keep low for token efficiency)"
+                    },
+                    "vanilla": {
+                        "type": "boolean",
+                        "description": "If true, return ONLY vanilla game definitions. If false (default), return mod + vanilla combined."
+                    }
+                },
+                "required": [
+                    "typeName"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_types",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_rules",
+            "description": "Query syntax rules for triggers, effects, scope changes, or modifiers from CWT/LSP-backed rule evidence. Returns hardFacts (legal syntax/scopes/push_scope/type filters) plus semanticHints from trigger_docs.log/scopes.cwt comments. Treat semanticHints as search guidance, not proof of legality. Fuzzy-matches if exact name not found.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "category": {
+                        "type": "string",
+                        "enum": [
+                            "trigger",
+                            "effect",
+                            "scope_change",
+                            "modifier"
+                        ],
+                        "description": "Rule category"
+                    },
+                    "name": {
+                        "type": "string",
+                        "description": "Specific rule name (optional, lists all if omitted or returns fuzzy matches if exact miss)"
+                    },
+                    "scope": {
+                        "type": "string",
+                        "description": "Filter by an exact supported scope returned by query_scope/explain_scope. Optional, but heavily recommended."
+                    }
+                },
+                "required": [
+                    "category"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_rules",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_cwt_schema",
+            "description": "CWT-FIRST schema lookup for entity definitions and other non-trigger/effect rules. Use BEFORE writing or planning a PDXScript target. Pass the actual project file/directory plus an optional field/rule name. Returns active CWT source snippets, line numbers, and parsed type/path/subtype entity summaries. If snippets are structural only, confirm intent from verified current-version examples.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "type": "string",
+                        "description": "Actual project file/directory or a CWT-relative path returned by active schema metadata."
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Alias for target when you have a concrete project file path."
+                    },
+                    "directory": {
+                        "type": "string",
+                        "description": "Alias for target when an active project/schema result supplied the entity directory."
+                    },
+                    "name": {
+                        "type": "string",
+                        "description": "Optional field, type, alias, or rule name to locate inside matched CWT files."
+                    },
+                    "includeContent": {
+                        "type": "boolean",
+                        "description": "If true, return a larger excerpt from matched schema files. Default false."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum CWT files to return. Default 5, max 20."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_cwt_schema",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "search_rule_capabilities",
+            "description": "Search CWT/LSP rule evidence by intent and scope capability instead of guessing a rule name. Use this when you know what you want to do but do not know the exact trigger/effect/scope_change name. Returns ranked candidates with hardFacts and semanticHints; validate the selected rule before writing.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "intent": {
+                        "type": "string",
+                        "description": "Natural-language intent. Exact current-game terms from CWT docs improve ranking."
+                    },
+                    "category": {
+                        "type": "string",
+                        "enum": [
+                            "trigger",
+                            "effect",
+                            "scope_change",
+                            "modifier",
+                            "all"
+                        ],
+                        "description": "Optional CWT rule category filter."
+                    },
+                    "currentScope": {
+                        "type": "string",
+                        "description": "Optional exact current CWT scope returned by query_scope."
+                    },
+                    "desiredPushScope": {
+                        "type": "string",
+                        "description": "Optional exact resulting scope returned by explain_scope/schema evidence."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum candidates to return. Default 10, max 50."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "search_rule_capabilities",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "explain_scope",
+            "description": "Explain a current CWT scope from scopes.cwt, including aliases, is_subscope_of, source location, and semantic hints. Scope descriptions are hints, not legality proof.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "scope": {
+                        "type": "string",
+                        "description": "Exact scope or alias observed in current CWT/LSP output."
+                    }
+                },
+                "required": [
+                    "scope"
+                ]
+            }
+        },
+        "registry": {
+            "name": "explain_scope",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "parse_pdx_fragment",
+            "description": "Parse a PDXScript fragment through the CWTools language server without writing a file. Use this for quick syntax, brace, and recovery checks after selecting rules. This is not a full semantic validation substitute; final project edits still need get_diagnostics/completions or verified examples.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "code": {
+                        "type": "string",
+                        "description": "PDXScript fragment text to parse."
+                    }
+                },
+                "required": [
+                    "code"
+                ]
+            }
+        },
+        "registry": {
+            "name": "parse_pdx_fragment",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_scope",
+            "description": "Query the scope context at a specific position in a file. Returns current/root/prior scope chains plus provenance and inference evidence reported by CWTools. Use it to determine which active CWT rules are valid at that position.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path"
+                    },
+                    "line": {
+                        "type": "number",
+                        "description": "Line number (0-based)"
+                    },
+                    "column": {
+                        "type": "number",
+                        "description": "Column number (0-based)"
+                    }
+                },
+                "required": [
+                    "file",
+                    "line",
+                    "column"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_scope",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "get_diagnostics",
+            "description": "Get errors, warnings, information, and hints from the VS Code Problems diagnostics snapshot, optionally filtered by file and severity. Returns totals and truncation metadata; check truncated before treating the returned list as complete.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Optional: restrict to a specific file path (absolute) or a path substring to match. Leave empty to get all workspace diagnostics."
+                    },
+                    "severity": {
+                        "type": "string",
+                        "enum": [
+                            "error",
+                            "warning",
+                            "info",
+                            "hint",
+                            "all"
+                        ],
+                        "description": "Filter by severity. Default: \"all\""
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max diagnostics to return (default 500, max 2000). For full project reviews, omit this parameter to get all diagnostics. Only set a low limit when you want a quick summary."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "get_diagnostics",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "analyze_diagnostic_error",
+            "description": "Classify an existing diagnostic or tool/write failure and return routing advice. Use after a write, validation, ReadTracker, or tool-argument failure. Prefer passing diagnosticsSnapshot/toolResult from get_diagnostics or a write tool so this does not re-query diagnostics. When a concrete identifier/sprite/sound/localisation key appears, the result tells the agent to verify it against project + vanilla sources; when LSP has no feedback, it avoids blind searches.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Optional file where the diagnostic or failed tool operation occurred. Used only to scope a fallback get_diagnostics call if no snapshot is supplied."
+                    },
+                    "errorCode": {
+                        "type": "string",
+                        "description": "Optional diagnostic code or compact error message."
+                    },
+                    "message": {
+                        "type": "string",
+                        "description": "Optional raw failure message from a tool or validation step."
+                    },
+                    "previousAttempt": {
+                        "type": "string",
+                        "description": "Optional summary of the last attempted fix. Helps detect repeated blind retries."
+                    },
+                    "toolName": {
+                        "type": "string",
+                        "description": "Optional name of the tool that failed, e.g. edit_file, write_localisation, get_diagnostics."
+                    },
+                    "diagnosticsSnapshot": {
+                        "type": "object",
+                        "description": "Optional raw get_diagnostics result, write-tool diagnostics payload, or compact diagnostic object to classify without querying diagnostics again."
+                    },
+                    "toolResult": {
+                        "type": "object",
+                        "description": "Optional raw failed tool result to classify without querying diagnostics again."
+                    },
+                    "reflection": {
+                        "type": "string",
+                        "description": "Optional legacy free-form analysis from the model. Kept for backward compatibility; the host still returns deterministic routing advice."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "analyze_diagnostic_error",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "none",
+            "riskLevel": 2,
+            "concurrencyClass": "global-exclusive"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_project_profile",
+            "description": "Read the /init-generated Agent project profile from .cwtools/project/profile.json. Use this before broad scans to get workspace type, key directories, localisation languages/encoding, namespaces, workflow routing, validation hints, and mode-specific prompt cards.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "section": {
+                        "type": "string",
+                        "enum": [
+                            "summary",
+                            "routing",
+                            "directories",
+                            "localisation",
+                            "identifiers",
+                            "validation",
+                            "promptCards",
+                            "all"
+                        ],
+                        "description": "Targeted profile section to return. Default summary. Use all only when you need the whole profile."
+                    },
+                    "mode": {
+                        "type": "string",
+                        "enum": [
+                            "build",
+                            "plan",
+                            "explore",
+                            "general",
+                            "utility",
+                            "review",
+                            "gui_expert",
+                            "script_reviewer",
+                            "loc_translator",
+                            "loc_writer",
+                            "orchestrator",
+                            "script",
+                            "asset"
+                        ],
+                        "description": "Optional mode card to return, e.g. build, plan, loc_writer, asset, orchestrator, script."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_project_profile",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_project_knowledge",
+            "description": "Query the /init-generated project + vanilla SQLite knowledge graph for complex cross-subsystem work. Returns project patterns, bounded vanilla archetypes, definition stacks, dependency edges, typed relationship structure/logic, freshness, and unresolved facts with source paths. Use this before write_design_blueprint or any plan spanning multiple current-game entity families. CWT/LSP exact checks remain authoritative.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "intent": {
+                        "type": "string",
+                        "description": "Concise design or investigation intent used to rank evidence."
+                    },
+                    "domains": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "Subsystem domains returned by the project knowledge manifest or an earlier query."
+                    },
+                    "identifiers": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "Known or proposed IDs used as indexed graph seeds. Exact IDs and stable prefixes give the fastest, most accurate retrieval."
+                    },
+                    "entityTypes": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "CWTools entity types to prioritize."
+                    },
+                    "includeProjectPatterns": {
+                        "type": "boolean",
+                        "description": "Include existing workspace examples. Default true."
+                    },
+                    "includeVanillaArchetypes": {
+                        "type": "boolean",
+                        "description": "Include bounded vanilla examples with exact sources. Default true."
+                    },
+                    "includeTopology": {
+                        "type": "boolean",
+                        "description": "Include project dependency/reference edges. Default true."
+                    },
+                    "includeUnresolved": {
+                        "type": "boolean",
+                        "description": "Include ambiguous definition stacks and snapshot warnings. Default true."
+                    },
+                    "includeEventGraph": {
+                        "type": "boolean",
+                        "description": "Include event nodes, structural call/entry edges, and state/scope logic relations. Default true."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "minimum": 1,
+                        "maximum": 300,
+                        "description": "Maximum ranked evidence records. Default 80."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_project_knowledge",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_workspace_index",
+            "description": "Query the shared incremental workspace index for PDXScript symbols and named .gfx/.asset/.gui assets without scanning files. Use this before broad grep/search for any named project symbol. Results report indexedSymbolNames, indexUpdatedAt, fileVersion, and optional lightweight references for freshness/coverage awareness.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "name": {
+                        "type": "string",
+                        "description": "Exact, prefix, or substring symbol/asset name to search for."
+                    },
+                    "kind": {
+                        "type": "string",
+                        "description": "Optional exact kind returned by the active index or CWT type metadata."
+                    },
+                    "category": {
+                        "type": "string",
+                        "description": "Optional broad category returned by an earlier index result."
+                    },
+                    "source": {
+                        "type": "string",
+                        "enum": [
+                            "script",
+                            "asset",
+                            "gui"
+                        ],
+                        "description": "Optional source filter. script=.txt, asset=.gfx/.asset, gui=.gui."
+                    },
+                    "origin": {
+                        "type": "string",
+                        "enum": [
+                            "workspace",
+                            "vanilla",
+                            "both"
+                        ],
+                        "description": "Optional origin filter. workspace=mod files, vanilla=configured game cache, both/default=combined."
+                    },
+                    "directory": {
+                        "type": "string",
+                        "description": "Optional project path fragment; prefer a path returned by project profile or CWT schema."
+                    },
+                    "prefix": {
+                        "type": "boolean",
+                        "description": "If true, name is treated as a prefix. Default false."
+                    },
+                    "exact": {
+                        "type": "boolean",
+                        "description": "If true, name must match exactly. Default false."
+                    },
+                    "includeReferences": {
+                        "type": "boolean",
+                        "description": "If true, include lightweight cross-file reference contexts captured by the index. Default false."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum entries to return. Default 50, max 200."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_workspace_index",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "explore_pdx_project",
+            "description": "Primary semantic exploration entry point for large Paradox projects. Queries the live CWTools type/reference graph and returns bounded entry points, typed nodes, dependency edges, file facts, provenance, truncation, and freshness without scanning or reading whole files. Use this FIRST for questions such as how an entity is connected, what calls or references an ID, what a file depends on, or what may be affected by a change. Follow with exact query_rules/query_scope/query_types/get_pdx_block checks before writing.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "query": {
+                        "type": "string",
+                        "description": "Identifier or concise semantic search text. Exact PDX IDs give the strongest results. Optional when file or typeName is supplied."
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Optional workspace-relative or absolute file path used to restrict entry points."
+                    },
+                    "typeName": {
+                        "type": "string",
+                        "description": "Optional exact CWTools type name obtained from active schema/type evidence."
+                    },
+                    "exact": {
+                        "type": "boolean",
+                        "description": "Require query to exactly match an entity ID. Default false."
+                    },
+                    "depth": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 3,
+                        "description": "Incoming/outgoing graph traversal depth. Default 1; use 2-3 only for focused IDs."
+                    },
+                    "maxNodes": {
+                        "type": "number",
+                        "minimum": 1,
+                        "maximum": 100,
+                        "description": "Maximum graph nodes. Default 30."
+                    },
+                    "maxEdges": {
+                        "type": "number",
+                        "minimum": 1,
+                        "maximum": 300,
+                        "description": "Maximum graph edges and per-file semantic facts. Default 80."
+                    },
+                    "includeMetadata": {
+                        "type": "boolean",
+                        "description": "Include documentation, variables, event targets, and block metadata. Default true."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "explore_pdx_project",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_localisation_index",
+            "description": "Query the shared incremental localisation index for mod YML keys without scanning files. Use this before creating or updating localisation keys, and when checking whether a key already exists.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "key": {
+                        "type": "string",
+                        "description": "Exact key, prefix, or substring to search for."
+                    },
+                    "language": {
+                        "type": "string",
+                        "description": "Optional language tag returned by the active project/profile localisation metadata."
+                    },
+                    "prefix": {
+                        "type": "boolean",
+                        "description": "If true, key is treated as a prefix. Default false."
+                    },
+                    "contains": {
+                        "type": "boolean",
+                        "description": "If true, key is treated as a case-insensitive substring. Useful when you only know part of a localisation key."
+                    },
+                    "caseSensitive": {
+                        "type": "boolean",
+                        "description": "Only applies to prefix/contains searches. Default false."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum entries to return. Default 20, max 100."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_localisation_index",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "get_pdx_block",
+            "description": "Extract exactly one complete AST block by symbol name. Works with .txt (events, common), .gui (containerWindowType by name), and .gfx (pdxmesh by name). Returns 1-based startLine/endLine that can be passed directly to replace_lines. If the symbol is not found, the error response includes a full list of available symbols with line ranges so you can retry with the correct name.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path"
+                    },
+                    "symbol": {
+                        "type": "string",
+                        "description": "Exact symbol returned by document_symbols or another active typed lookup. If not found, the error lists available symbols and line ranges."
+                    }
+                },
+                "required": [
+                    "file",
+                    "symbol"
+                ]
+            }
+        },
+        "registry": {
+            "name": "get_pdx_block",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "get_completion_at",
+            "description": "Get auto-completion suggestions and bounded context at a specific position through the active VS Code language provider. In Paradox projects, CWTools may enrich the result with game-aware scope and schema context.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path (must be in the workspace)"
+                    },
+                    "line": {
+                        "type": "number",
+                        "description": "Line number (0-based)"
+                    },
+                    "column": {
+                        "type": "number",
+                        "description": "Column number (0-based)"
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max completions to return (default 30). Increase if you need to see more options."
+                    }
+                },
+                "required": [
+                    "file",
+                    "line",
+                    "column"
+                ]
+            }
+        },
+        "registry": {
+            "name": "get_completion_at",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "document_symbols",
+            "description": "Get symbols defined in a file as a hierarchical tree with 0-based line ranges from the active VS Code language provider. Use this first to understand file structure before choosing targeted reads.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path"
+                    }
+                },
+                "required": [
+                    "file"
+                ]
+            }
+        },
+        "registry": {
+            "name": "document_symbols",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "workspace_symbols",
+            "description": "Search symbol definitions by name through active VS Code workspace symbol providers. Use a specific query. Empty results may reflect provider coverage or indexing state and are not proof that text is absent from the repository.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "query": {
+                        "type": "string",
+                        "description": "Symbol name or partial name to search for. Be specific to avoid large result sets."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results (default 20; keep low for broad searches to avoid token waste)."
+                    }
+                },
+                "required": [
+                    "query"
+                ]
+            }
+        },
+        "registry": {
+            "name": "workspace_symbols",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_definition",
+            "description": "GoToDefinition at a position, or FindAllRefs if no definition exists. Uses CWTools AST - faster than grep. If you know the symbol name, prefer query_definition_by_name instead.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path"
+                    },
+                    "line": {
+                        "type": "number",
+                        "description": "Line number (0-based)"
+                    },
+                    "column": {
+                        "type": "number",
+                        "description": "Column number (0-based)"
+                    }
+                },
+                "required": [
+                    "file",
+                    "line",
+                    "column"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_definition",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_definition_by_name",
+            "description": "Find where a named symbol is defined - no file/position needed. Returns file path and line number. Works for any top-level PDXScript key (events, triggers, effects, etc.).",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "symbolName": {
+                        "type": "string",
+                        "description": "The exact name of the symbol to find (e.g. \"kuat_has_psionic_research\", \"distar.001\")"
+                    }
+                },
+                "required": [
+                    "symbolName"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_definition_by_name",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_references",
+            "description": "Find references to an identifier through the active language provider, with a bounded workspace text-search fallback.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "identifier": {
+                        "type": "string",
+                        "description": "The identifier to search for"
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Optional file to limit search to"
+                    }
+                },
+                "required": [
+                    "identifier"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_references",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_scripted_effects",
+            "description": "Warning: MANDATORY before using any scripted_effect. Lists all scripted effects with name, scope constraints, and type. PDXscript effect names are frequently hallucinated - always verify here first.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "filter": {
+                        "type": "string",
+                        "description": "Optional substring filter on effect name. Without filter, results are limited to 50; with filter, up to 200."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results (default 50 without filter, 200 with filter)"
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_scripted_effects",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_scripted_triggers",
+            "description": "Warning: MANDATORY before using any scripted_trigger. Lists all scripted triggers with name, scope constraints, and type. Trigger names are frequently hallucinated - always verify here first.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "filter": {
+                        "type": "string",
+                        "description": "Optional substring filter on trigger name. Without filter, results are limited to 50; with filter, up to 200."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results (default 50 without filter, 200 with filter)"
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_scripted_triggers",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_enums",
+            "description": "Warning: MANDATORY before using any enum field. Query enum values from CWTools rules. Call with no enumName to list all enums, then query specific enum for values. Always verify - enum values are domain-specific.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "enumName": {
+                        "type": "string",
+                        "description": "Exact enum name discovered from CWT/schema evidence. Leave empty to list all enum names."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max values to return (default 500)"
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_enums",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_static_modifiers",
+            "description": "Warning: MANDATORY before using add_modifier. Lists static modifiers with categories. Modifier names are domain-specific - always verify. Dynamic/engine modifiers may not appear here - use query_rules(category=\"modifier\") as fallback.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "filter": {
+                        "type": "string",
+                        "description": "Optional substring filter on modifier tag"
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results (default 300)"
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_static_modifiers",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_variables",
+            "description": "List all scripted variables (@variable_name = value) defined across the mod and vanilla. Use this to look up numeric constant values defined with @-prefix before using them in generated code.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "filter": {
+                        "type": "string",
+                        "description": "Optional substring filter on variable name"
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_variables",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "get_entity_info",
+            "description": "Get deep structural info from the CWTools cache, including referenced types, variables, classified rule blocks, and saved scopes. Use it to understand file dependencies before modification.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute file path (must be a parsed mod file)"
+                    }
+                },
+                "required": [
+                    "file"
+                ]
+            }
+        },
+        "registry": {
+            "name": "get_entity_info",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "parallel"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_shader_symbol",
+            "description": "Read-only. Query declared Paradox shader symbols (Effects, MainCode stages, constant buffers, render states) from the CWTools shader model across mod, dependencies, and vanilla. Effect entries carry a reachability classification: engine_or_unreferenced means reachability is UNKNOWN, not dead code - never treat it as safe to delete. Page with cursor when nextCursor is non-null.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "filter": {
+                        "type": "string",
+                        "description": "Optional case-insensitive substring filter on the symbol name."
+                    },
+                    "kind": {
+                        "type": "string",
+                        "enum": [
+                            "all",
+                            "effect",
+                            "maincode",
+                            "constantbuffer",
+                            "state"
+                        ],
+                        "description": "Symbol kind filter. Default all."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results to return (1-500, default 100)."
+                    },
+                    "cursor": {
+                        "type": "number",
+                        "description": "Numeric offset returned as nextCursor by a previous call. Default 0."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_shader_symbol",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_shader_compile_unit",
+            "description": "Read-only. Return the compile unit for a .shader root or .fxh include: root file, include members with resolution status and origin, include problems (missing/ambiguous/cycle), and the roots that include this file. MANDATORY before editing any .fxh: symbol validity depends on the whole compile unit (root + Includes + platform conditions), so raw text search across the repo does not prove shader semantics.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                    }
+                },
+                "required": [
+                    "file"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_shader_compile_unit",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_shader_platform_variants",
+            "description": "Read-only. Compare presence conditions, macros, and active symbols for every supported Paradox shader platform profile in a compile unit. MANDATORY before changing conditional shader code or macros; validating only the current platform is insufficient.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                    }
+                },
+                "required": [
+                    "file"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_shader_platform_variants",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "query_shader_callers",
+            "description": "Read-only. Return evidence of what references a shader Effect: data-script assignments and effectFile selections, each with file, logicalPath, origin, enclosingBlock, interfaceSprite/rendererSubtype, direct renderer inputs and bounded static GUI use sites when known, range, and provenance (sourceKind, confidence, gameVersion). MANDATORY before renaming or deleting an Effect.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "effectName": {
+                        "type": "string",
+                        "description": "Exact shader Effect name."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max evidence entries to return (default 100)."
+                    }
+                },
+                "required": [
+                    "effectName"
+                ]
+            }
+        },
+        "registry": {
+            "name": "query_shader_callers",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "explain_shader_reachability",
+            "description": "Read-only. Explain why a shader Effect is reachable or why reachability is unknown: classification, declarations, evidence with provenance/confidence, and the rename policy decision. Respect renamePolicy - engine_hardcoded or unknown entry points must not be renamed. A newly declared Effect is NOT executed unless reachable via a data call, an effectFile convention, or a known engine entry. Pass effectName for one Effect, or file to page through all Effects declared in a shader file.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "effectName": {
+                        "type": "string",
+                        "description": "Exact shader Effect name. Takes precedence over file."
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute or workspace-relative path of a .shader/.fxh file; lists its Effects with cursor pagination."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Max results for the per-file form (1-500, default 100)."
+                    },
+                    "cursor": {
+                        "type": "number",
+                        "description": "Numeric offset returned as nextCursor by a previous per-file call. Default 0."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "explain_shader_reachability",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "validate_shader",
+            "description": "Read-only. Validate a .shader/.fxh file inside its compile unit and return structured diagnostics (code, severity, message, range). Run this on every affected compile-unit root after editing shader files.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                    }
+                },
+                "required": [
+                    "file"
+                ]
+            }
+        },
+        "registry": {
+            "name": "validate_shader",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "compare_shader_with_vanilla",
+            "description": "Read-only. Structurally compare workspace shader declarations with vanilla: which declarations are effective and which vanilla declarations they override. Pass effectName for one Effect, or file for all Effects declared in a shader file.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "effectName": {
+                        "type": "string",
+                        "description": "Exact shader Effect name. Takes precedence over file."
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Absolute or workspace-relative path of a .shader/.fxh file."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "compare_shader_with_vanilla",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    }
+];