@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/tools.d.ts

@@ -1,2933 +0,0 @@
-declare const TOOLS: readonly [{
-    readonly name: "list_instances";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {};
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "create_instance";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly name: {
-                readonly type: "string";
-                readonly description: "Unique name for the instance (min 3 chars)";
-            };
-            readonly tier: {
-                readonly type: "string";
-                readonly enum: readonly ["free", "dev", "pro", "speed", "business"];
-                readonly description: "Pricing tier. Start with \"free\" for testing.";
-            };
-        };
-        readonly required: readonly ["name", "tier"];
-    };
-}, {
-    readonly name: "get_instance";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the instance (from list_instances)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "get_connection_string";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the instance";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "delete_instance";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the instance to delete";
-            };
-            readonly confirm: {
-                readonly type: "boolean";
-                readonly description: "Must be true to confirm deletion";
-            };
-        };
-        readonly required: readonly ["instance_id", "confirm"];
-    };
-}, {
-    readonly name: "cache_get";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Cache key to retrieve";
-            };
-            readonly org_id: {
-                readonly type: "string";
-                readonly description: "Optional org ID — if the direct key misses, falls back to the shared org namespace org:{org_id}:sem:{key}";
-            };
-        };
-        readonly required: readonly ["instance_id", "key"];
-    };
-}, {
-    readonly name: "cache_set";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (from list_instances)";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Cache key";
-            };
-            readonly value: {
-                readonly type: "string";
-                readonly description: "Value to store (string or JSON)";
-            };
-            readonly ttl: {
-                readonly type: "number";
-                readonly description: "Time-to-live in seconds (optional, omit for no expiry)";
-            };
-            readonly org_id: {
-                readonly type: "string";
-                readonly description: "Optional org ID — also writes the key to the shared org namespace org:{org_id}:sem:{key} with the same TTL";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "value"];
-    };
-}, {
-    readonly name: "cache_delete";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance to delete keys from (get from list_instances)";
-            };
-            readonly keys: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "One or more cache keys to delete. Accepts exact keys only (no glob patterns — use cache_keys to list first).";
-            };
-        };
-        readonly required: readonly ["instance_id", "keys"];
-    };
-}, {
-    readonly name: "cache_exists";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance to check (get from list_instances)";
-            };
-            readonly keys: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Keys to check for existence. Accepts exact keys only (no glob patterns).";
-            };
-        };
-        readonly required: readonly ["instance_id", "keys"];
-    };
-}, {
-    readonly name: "cache_ttl";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (from list_instances)";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Cache key to inspect";
-            };
-        };
-        readonly required: readonly ["instance_id", "key"];
-    };
-}, {
-    readonly name: "cache_keys";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-            };
-            readonly pattern: {
-                readonly type: "string";
-                readonly description: "Glob pattern (default: *)";
-            };
-            readonly count: {
-                readonly type: "number";
-                readonly description: "Max keys to return (default: 50, max: 500)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "cache_stats";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (from list_instances)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "semantic_search";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (from list_instances)";
-            };
-            readonly query: {
-                readonly type: "string";
-                readonly description: "Natural-language query to find similar cached content";
-            };
-            readonly threshold: {
-                readonly type: "number";
-                readonly description: "Minimum cosine similarity 0–1 (default: 0.82). Lower = broader matches.";
-            };
-            readonly namespace: {
-                readonly type: "string";
-                readonly description: "Semantic namespace to search in (default: cachly:sem)";
-            };
-            readonly top_k: {
-                readonly type: "number";
-                readonly description: "Maximum number of results to return (default: 5)";
-            };
-            readonly use_hybrid: {
-                readonly type: "boolean";
-                readonly description: string;
-            };
-            readonly auto_namespace: {
-                readonly type: "boolean";
-                readonly description: string;
-            };
-        };
-        readonly required: readonly ["instance_id", "query"];
-    };
-}, {
-    readonly name: "detect_namespace";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly prompt: {
-                readonly type: "string";
-                readonly description: "The text prompt to classify into a semantic namespace";
-            };
-        };
-        readonly required: readonly ["prompt"];
-    };
-}, {
-    readonly name: "cache_warmup";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly entries: {
-                readonly type: "array";
-                readonly description: "List of prompt/value pairs to pre-warm into the cache";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly prompt: {
-                            readonly type: "string";
-                            readonly description: "The query or question to cache";
-                        };
-                        readonly value: {
-                            readonly type: "string";
-                            readonly description: "The answer or response to store for this prompt";
-                        };
-                        readonly namespace: {
-                            readonly type: "string";
-                            readonly description: "Optional per-entry namespace override";
-                        };
-                    };
-                    readonly required: readonly ["prompt", "value"];
-                };
-            };
-            readonly namespace: {
-                readonly type: "string";
-                readonly description: "Default namespace for all entries (default: cachly:sem)";
-            };
-            readonly ttl: {
-                readonly type: "number";
-                readonly description: "Time-to-live in seconds for warmed entries (omit for no expiry)";
-            };
-            readonly auto_namespace: {
-                readonly type: "boolean";
-                readonly description: string;
-            };
-        };
-        readonly required: readonly ["instance_id", "entries"];
-    };
-}, {
-    readonly name: "index_project";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cachly instance";
-            };
-            readonly dir: {
-                readonly type: "string";
-                readonly description: "Absolute path to the directory to index (e.g. /Users/you/myproject/src)";
-            };
-            readonly extensions: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "File extensions to include (default: [\"ts\",\"js\",\"go\",\"py\",\"java\",\"rs\",\"md\",\"kt\",\"swift\"])";
-            };
-            readonly max_files: {
-                readonly type: "number";
-                readonly description: "Maximum number of files to index (default: 100)";
-            };
-            readonly ttl: {
-                readonly type: "number";
-                readonly description: "TTL in seconds for indexed entries (default: 86400 = 24 h)";
-            };
-            readonly summary_chars: {
-                readonly type: "number";
-                readonly description: "Characters to use as summary per file (default: 1200)";
-            };
-            readonly namespace: {
-                readonly type: "string";
-                readonly description: "Semantic namespace to store under (default: cachly:sem:code)";
-            };
-        };
-        readonly required: readonly ["instance_id", "dir"];
-    };
-}, {
-    readonly name: "cache_mset";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly items: {
-                readonly type: "array";
-                readonly description: "Key-value pairs to set";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly key: {
-                            readonly type: "string";
-                            readonly description: "Cache key";
-                        };
-                        readonly value: {
-                            readonly description: "Value to store (JSON-serialised)";
-                        };
-                        readonly ttl: {
-                            readonly type: "number";
-                            readonly description: "Per-key TTL in seconds (optional)";
-                        };
-                    };
-                    readonly required: readonly ["key", "value"];
-                };
-            };
-        };
-        readonly required: readonly ["instance_id", "items"];
-    };
-}, {
-    readonly name: "cache_mget";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly keys: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "List of keys to fetch";
-            };
-        };
-        readonly required: readonly ["instance_id", "keys"];
-    };
-}, {
-    readonly name: "cache_lock_acquire";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Lock resource identifier";
-            };
-            readonly ttl_ms: {
-                readonly type: "number";
-                readonly description: "Safety TTL in milliseconds (e.g. 5000)";
-            };
-            readonly retries: {
-                readonly type: "number";
-                readonly description: "Max acquire attempts (default: 3)";
-            };
-            readonly retry_delay_ms: {
-                readonly type: "number";
-                readonly description: "Milliseconds between retries (default: 50)";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "ttl_ms"];
-    };
-}, {
-    readonly name: "cache_lock_release";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Lock resource identifier (same as in cache_lock_acquire)";
-            };
-            readonly token: {
-                readonly type: "string";
-                readonly description: "Fencing token returned by cache_lock_acquire";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "token"];
-    };
-}, {
-    readonly name: "get_api_status";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {};
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "remember_context";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Descriptive key like \"project_overview\", \"auth_architecture\", \"file:src/index.ts\"";
-            };
-            readonly content: {
-                readonly type: "string";
-                readonly description: "The context/summary/analysis to remember";
-            };
-            readonly category: {
-                readonly type: "string";
-                readonly enum: readonly ["overview", "architecture", "file_summary", "dependency", "thinking", "custom"];
-                readonly description: "Category for organization (default: custom)";
-            };
-            readonly ttl: {
-                readonly type: "number";
-                readonly description: "Time-to-live in seconds (default: 86400 = 24h, use 0 for no expiry)";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "content"];
-    };
-}, {
-    readonly name: "recall_context";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "The key to look up (supports glob pattern like \"file:*\")";
-            };
-        };
-        readonly required: readonly ["instance_id", "key"];
-    };
-}, {
-    readonly name: "list_remembered";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly category: {
-                readonly type: "string";
-                readonly enum: readonly ["overview", "architecture", "file_summary", "dependency", "thinking", "custom", "all"];
-                readonly description: "Filter by category (default: all)";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max entries to return (default: 50)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "forget_context";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly keys: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Keys to delete (supports glob)";
-            };
-        };
-        readonly required: readonly ["instance_id", "keys"];
-    };
-}, {
-    readonly name: "learn_from_attempts";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Short slug, e.g. \"deploy:web\", \"debug:redis-tls\", \"fix:generate-series\"";
-            };
-            readonly outcome: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure", "partial"];
-                readonly description: "Did it work?";
-            };
-            readonly what_worked: {
-                readonly type: "string";
-                readonly description: "What solved the problem or what approach succeeded";
-            };
-            readonly what_failed: {
-                readonly type: "string";
-                readonly description: "What did NOT work (optional but valuable)";
-            };
-            readonly context: {
-                readonly type: "string";
-                readonly description: "Additional context, error messages, root cause (optional)";
-            };
-            readonly severity: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "major", "minor"];
-                readonly description: "Impact severity: critical (blocks work/deploy), major (significant slowdown), minor (nice to know). Default: major.";
-            };
-            readonly file_paths: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Files involved in this lesson (e.g. [\"infra/deploy.sh\", \".env\"])";
-            };
-            readonly commands: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Commands that worked or failed (e.g. [\"rsync -avz ...\", \"docker compose up -d\"])";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Topic tags for filtering (e.g. [\"bash\", \"deploy\", \"env\"])";
-            };
-            readonly depends_on: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Prerequisites this lesson depends on (e.g. [\"node:>=20\", \"docker:running\", \"wireguard:active\"]). When a dependency is marked stale, all dependent lessons get needs_review.";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Name or handle of the person storing this lesson (e.g. \"alice\", \"bob\"). Used for Team Telepathy — teammates see each other's lessons in session_start. Also powers brain_who_knows and team_expertise_map.";
-            };
-            readonly visibility: {
-                readonly type: "string";
-                readonly enum: readonly ["team", "private", "public"];
-                readonly description: "Who can see this lesson. \"team\" (default) = all team members. \"private\" = only accessible via exact recall_best_solution, never surfaced in smart_recall or team_recall. \"public\" = same as team (public syndication planned).";
-            };
-            readonly service: {
-                readonly type: "string";
-                readonly description: "The service or system this lesson concerns (e.g. \"prometheus\", \"cachly-web\", \"auth-service\"). Builds a Service node in the knowledge graph linking the people who operate it and the files that run in it. Powers brain_service_map for instant incident triage.";
-            };
-            readonly service_kind: {
-                readonly type: "string";
-                readonly enum: readonly ["service", "system"];
-                readonly description: "Whether `service` is an application service (\"service\", default) or infrastructure (\"system\", e.g. prometheus, kubernetes, redis). Shown as 🛰️/🖥️ in brain_service_map.";
-            };
-            readonly group: {
-                readonly type: "string";
-                readonly description: "Optional team scope — restricts this lesson to a named group/sub-team (e.g. \"backend\", \"security\"). Only members of that group (managed via team_grant_scope) and admins see it in smart_recall. Orthogonal to visibility: a team-wide lesson has no group; a private lesson is author-only regardless of group.";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "outcome", "what_worked"];
-    };
-}, {
-    readonly name: "recall_best_solution";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic slug to look up, e.g. \"deploy:web\". Supports partial match.";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic"];
-    };
-}, {
-    readonly name: "smart_recall";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly query: {
-                readonly type: "string";
-                readonly description: "Natural language query to find relevant cached context";
-            };
-            readonly threshold: {
-                readonly type: "number";
-                readonly description: "Similarity threshold 0-1 (default: 0.78)";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Handle of the person doing the recall (optional). Enables team-knowledge-reuse tracking: when you recall a lesson written by a teammate, cachly counts it as cross-author reuse — the value only a shared brain delivers.";
-            };
-            readonly context_files: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "File paths you are currently working on (e.g. [\"src/auth/service.ts\", \"src/api/routes.ts\"]). When provided, lessons that were learned in the context of these files are boosted in ranking — surfacing file-specific knowledge even when the query does not mention the file name. Pair with author for fully personalized recall.";
-            };
-        };
-        readonly required: readonly ["instance_id", "query"];
-    };
-}, {
-    readonly name: "session_start";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly focus: {
-                readonly type: "string";
-                readonly description: "Keywords for what you plan to work on today (e.g. \"deploy infra api\"). Used to surface relevant lessons at the top.";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Your name or handle (e.g. \"alice\"). Enables Team Telepathy — filters YOUR lessons vs TEAM lessons from past 7 days.";
-            };
-            readonly provider: {
-                readonly type: "string";
-                readonly description: "Current AI provider (e.g. \"claude-code\", \"copilot\", \"cursor\", \"windsurf\"). Shown in the briefing header and saved so the next provider can see who was last active.";
-            };
-            readonly workspace_path: {
-                readonly type: "string";
-                readonly description: "Absolute path to the project root. If no session_end was found (e.g. context limit hit), reads git log to reconstruct what happened since last session.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "session_start_summary";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly focus: {
-                readonly type: "string";
-                readonly description: "The topic or task you are about to work on (e.g. \"deploy infra\", \"api auth\"). Used to score and rank lessons by relevance.";
-            };
-            readonly top_n: {
-                readonly type: "number";
-                readonly description: "Number of lessons to return (default 10, max 25). Lessons are ranked by relevance to focus.";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Your name or handle (optional). Same as session_start — used for team lesson filtering.";
-            };
-        };
-        readonly required: readonly ["instance_id", "focus"];
-    };
-}, {
-    readonly name: "session_end";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly summary: {
-                readonly type: "string";
-                readonly description: "Brief summary of what was accomplished this session (2-3 sentences)";
-            };
-            readonly files_changed: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Key files changed this session (optional)";
-            };
-            readonly lessons_learned: {
-                readonly type: "number";
-                readonly description: "Number of new lessons stored this session (optional)";
-            };
-            readonly workspace_path: {
-                readonly type: "string";
-                readonly description: "Absolute path to the project root (e.g. \"/Users/you/myproject\"). Enables Ambient Learning — reads git log since session start and auto-learns from commit messages.";
-            };
-        };
-        readonly required: readonly ["instance_id", "summary"];
-    };
-}, {
-    readonly name: "session_handoff";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly completed_tasks: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Tasks that were fully completed (e.g. \"Implemented brainSearch() in JS SDK\")";
-            };
-            readonly remaining_tasks: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Tasks NOT yet done — the next window MUST pick these up";
-            };
-            readonly files_changed: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly path: {
-                            readonly type: "string";
-                            readonly description: "File path relative to project root";
-                        };
-                        readonly status: {
-                            readonly type: "string";
-                            readonly enum: readonly ["complete", "partial", "broken"];
-                            readonly description: "State of this file";
-                        };
-                        readonly description: {
-                            readonly type: "string";
-                            readonly description: "What was changed and what still needs work";
-                        };
-                    };
-                    readonly required: readonly ["path", "status"];
-                };
-                readonly description: "Changed files with their current state — marks partial/broken files so next window knows to fix them";
-            };
-            readonly instructions: {
-                readonly type: "string";
-                readonly description: "Free-form instructions for the next assistant. Be specific: what to do next, what to avoid, what broke.";
-            };
-            readonly context_summary: {
-                readonly type: "string";
-                readonly description: "Brief summary of what happened this session (architecture decisions, key findings, blockers)";
-            };
-            readonly blocked_on: {
-                readonly type: "string";
-                readonly description: "If work is blocked, describe what is needed to unblock (e.g. \"waiting for API deploy\", \"needs user input on design\")";
-            };
-        };
-        readonly required: readonly ["instance_id", "completed_tasks", "remaining_tasks"];
-    };
-}, {
-    readonly name: "session_ping";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly task: {
-                readonly type: "string";
-                readonly description: "What you are currently working on (e.g. \"Implementing invite handler in handler/invite.go\")";
-            };
-            readonly files_touched: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Files modified so far this session";
-            };
-            readonly next_step: {
-                readonly type: "string";
-                readonly description: "What the NEXT step is after this checkpoint (helps next provider resume immediately)";
-            };
-            readonly provider: {
-                readonly type: "string";
-                readonly description: "Current AI provider (e.g. \"claude-code\", \"copilot\", \"cursor\", \"windsurf\")";
-            };
-        };
-        readonly required: readonly ["instance_id", "task"];
-    };
-}, {
-    readonly name: "auto_learn_session";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly observations: {
-                readonly type: "array";
-                readonly description: "List of observations from this session";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly action: {
-                            readonly type: "string";
-                            readonly description: "What was tried (command, approach, code change)";
-                        };
-                        readonly outcome: {
-                            readonly type: "string";
-                            readonly enum: readonly ["success", "failure", "partial"];
-                            readonly description: "Result";
-                        };
-                        readonly details: {
-                            readonly type: "string";
-                            readonly description: "Error message, output, or explanation";
-                        };
-                        readonly topic: {
-                            readonly type: "string";
-                            readonly description: "Optional topic key (auto-generated if omitted)";
-                        };
-                        readonly severity: {
-                            readonly type: "string";
-                            readonly enum: readonly ["critical", "major", "minor"];
-                            readonly description: "Severity (default: minor)";
-                        };
-                    };
-                    readonly required: readonly ["action", "outcome"];
-                };
-            };
-        };
-        readonly required: readonly ["instance_id", "observations"];
-    };
-}, {
-    readonly name: "brain_who_knows";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic or question to find experts for";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max number of experts to return (default: 10)";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic"];
-    };
-}, {
-    readonly name: "brain_file_map";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly file_paths: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "File paths to look up (max 10)";
-            };
-        };
-        readonly required: readonly ["instance_id", "file_paths"];
-    };
-}, {
-    readonly name: "team_expertise_map";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly top_n: {
-                readonly type: "number";
-                readonly description: "Max contributors to show (default: 20)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_collab_pairs";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly min_weight: {
-                readonly type: "number";
-                readonly description: "Minimum collaboration events to show a pair (default: 1)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_portability";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "skill_gaps";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly min_failures: {
-                readonly type: "number";
-                readonly description: "Min failure count to flag a domain as a gap (default: 1)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_coverage";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly repo_path: {
-                readonly type: "string";
-                readonly description: "Path to the git repository (default: current directory)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_metrics";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_changelog";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly days: {
-                readonly type: "number";
-                readonly description: "How many days back to include (default: 7)";
-            };
-            readonly max_lessons: {
-                readonly type: "number";
-                readonly description: "Maximum number of lessons to include (default: 30)";
-            };
-            readonly include_failures: {
-                readonly type: "boolean";
-                readonly description: "Include failure-outcome lessons (default: true)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_service_map";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly service: {
-                readonly type: "string";
-                readonly description: "Name of the service/system to map (e.g. \"prometheus\", \"cachly-web\", \"auth-service\"). Matches the `service` tag on stored lessons.";
-            };
-        };
-        readonly required: readonly ["instance_id", "service"];
-    };
-}, {
-    readonly name: "sync_file_changes";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly changed_files: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "List of changed file paths";
-            };
-            readonly git_diff_stat: {
-                readonly type: "string";
-                readonly description: "Output of `git diff --stat` (optional)";
-            };
-            readonly commit_msg: {
-                readonly type: "string";
-                readonly description: "Commit message (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id", "changed_files"];
-    };
-}, {
-    readonly name: "team_learn";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Your name or handle (required for team attribution)";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic in category:keyword format (e.g. \"deploy:api\")";
-            };
-            readonly outcome: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure", "partial"];
-                readonly description: "What happened";
-            };
-            readonly what_worked: {
-                readonly type: "string";
-                readonly description: "What worked (the solution)";
-            };
-            readonly what_failed: {
-                readonly type: "string";
-                readonly description: "What did NOT work (avoid this)";
-            };
-            readonly severity: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "major", "minor"];
-                readonly description: "Impact level";
-            };
-            readonly file_paths: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Relevant file paths";
-            };
-            readonly commands: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Commands that worked";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Tags for categorization";
-            };
-        };
-        readonly required: readonly ["instance_id", "author", "topic", "outcome", "what_worked"];
-    };
-}, {
-    readonly name: "team_confirm";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic slug of the lesson to confirm (e.g. \"deploy:api\")";
-            };
-            readonly reviewer: {
-                readonly type: "string";
-                readonly description: "Your name or handle (the reviewer endorsing this lesson)";
-            };
-            readonly level: {
-                readonly type: "string";
-                readonly enum: readonly ["senior", "peer"];
-                readonly description: "Review weight — \"senior\" ranks higher than \"peer\" (default: peer)";
-            };
-            readonly note: {
-                readonly type: "string";
-                readonly description: "Optional review note (kept in the lesson audit trail)";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "reviewer"];
-    };
-}, {
-    readonly name: "team_assign_role";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly handle: {
-                readonly type: "string";
-                readonly description: "Handle or name of the team member to assign a role to";
-            };
-            readonly role: {
-                readonly type: "string";
-                readonly enum: readonly ["admin", "reviewer", "contributor", "viewer"];
-                readonly description: "Role to assign. admin: manage roles + all actions. reviewer: senior-review (🛡️). contributor: store + peer-review. viewer: read-only.";
-            };
-            readonly assigned_by: {
-                readonly type: "string";
-                readonly description: "Handle of the admin performing the assignment (required after governance bootstrap)";
-            };
-        };
-        readonly required: readonly ["instance_id", "handle", "role"];
-    };
-}, {
-    readonly name: "team_whoami";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly handle: {
-                readonly type: "string";
-                readonly description: "Your handle or name";
-            };
-        };
-        readonly required: readonly ["instance_id", "handle"];
-    };
-}, {
-    readonly name: "team_roster";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "team_audit";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly requester: {
-                readonly type: "string";
-                readonly description: "Your handle — must be an admin once governance is active";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max events to show, newest first (default: 50, max: 200)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "team_grant_scope";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly handle: {
-                readonly type: "string";
-                readonly description: "Handle of the team member to add/remove";
-            };
-            readonly group: {
-                readonly type: "string";
-                readonly description: "Group/sub-team name (e.g. \"backend\", \"security\", \"platform\")";
-            };
-            readonly action: {
-                readonly type: "string";
-                readonly enum: readonly ["add", "remove"];
-                readonly description: "add (default) or remove the member from the group";
-            };
-            readonly assigned_by: {
-                readonly type: "string";
-                readonly description: "Handle of the admin performing the change (required after governance bootstrap)";
-            };
-        };
-        readonly required: readonly ["instance_id", "handle", "group"];
-    };
-}, {
-    readonly name: "team_scopes";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly handle: {
-                readonly type: "string";
-                readonly description: "Optional — show only this person's group memberships";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "team_recall";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic or keyword to filter lessons (optional)";
-            };
-            readonly author: {
-                readonly type: "string";
-                readonly description: "Filter by author name (optional)";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max lessons to return (default: 10)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "team_synthesize";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic slug to synthesize (e.g. \"deploy:api\")";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic"];
-    };
-}, {
-    readonly name: "memory_crystalize";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly label: {
-                readonly type: "string";
-                readonly description: "Optional label for this crystal (e.g. \"Q1 2026\", \"v2 launch\"). Auto-generated from date if omitted.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "team_crystallize";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the shared team brain instance";
-            };
-            readonly min_authors: {
-                readonly type: "number";
-                readonly description: "Min distinct authors that must converge for a pattern to crystallize (default: 2, min: 2)";
-            };
-            readonly label: {
-                readonly type: "string";
-                readonly description: "Optional label (e.g. \"Q1 2026\"). Auto-generated from date if omitted.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "roadmap_add";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly title: {
-                readonly type: "string";
-                readonly description: "Short title of the task/feature (3–10 words)";
-            };
-            readonly description: {
-                readonly type: "string";
-                readonly description: "What needs to be done, acceptance criteria, context";
-            };
-            readonly priority: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "high", "medium", "low"];
-                readonly description: "Priority level (default: medium)";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Tags for filtering (e.g. [\"api\", \"web\", \"sdk\", \"infra\"])";
-            };
-            readonly milestone: {
-                readonly type: "string";
-                readonly description: "Milestone/epic this belongs to (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id", "title"];
-    };
-}, {
-    readonly name: "roadmap_update";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly id: {
-                readonly type: "string";
-                readonly description: "Item ID returned by roadmap_add or roadmap_list";
-            };
-            readonly status: {
-                readonly type: "string";
-                readonly enum: readonly ["planned", "in-progress", "done", "blocked", "cancelled"];
-                readonly description: "New status for the item";
-            };
-            readonly priority: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "high", "medium", "low"];
-                readonly description: "Updated priority (optional)";
-            };
-            readonly notes: {
-                readonly type: "string";
-                readonly description: "Progress notes, findings, or blockers (appended to existing notes)";
-            };
-            readonly title: {
-                readonly type: "string";
-                readonly description: "Updated title (optional)";
-            };
-            readonly description: {
-                readonly type: "string";
-                readonly description: "Updated description (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id", "id"];
-    };
-}, {
-    readonly name: "roadmap_list";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly status: {
-                readonly type: "string";
-                readonly enum: readonly ["planned", "in-progress", "done", "blocked", "cancelled", "open"];
-                readonly description: "Filter by status. Use 'open' to see planned+in-progress+blocked (default: open)";
-            };
-            readonly tag: {
-                readonly type: "string";
-                readonly description: "Filter by tag (optional)";
-            };
-            readonly milestone: {
-                readonly type: "string";
-                readonly description: "Filter by milestone (optional)";
-            };
-            readonly priority: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "high", "medium", "low"];
-                readonly description: "Filter by minimum priority (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "roadmap_next";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly tag: {
-                readonly type: "string";
-                readonly description: "Filter by tag (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_doctor";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly workspace_path: {
-                readonly type: "string";
-                readonly description: "Absolute path to workspace root — enables package.json analysis for openclaw cross-promo (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_hygiene";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "Report changes without applying them (default false)";
-            };
-            readonly provisional_threshold: {
-                readonly type: "number";
-                readonly description: "Confidence below which a lesson is flagged provisional (default 0.5)";
-            };
-            readonly archive_days: {
-                readonly type: "number";
-                readonly description: "Days after which a provisional low-recall lesson is archived (default 30)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "global_learn";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (used for connection)";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic key in format \"category:keyword\"";
-            };
-            readonly lesson: {
-                readonly type: "string";
-                readonly description: "The lesson content";
-            };
-            readonly severity: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "major", "minor"];
-                readonly description: "Severity (default: minor)";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Optional tags";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "lesson"];
-    };
-}, {
-    readonly name: "global_recall";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (used for connection)";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic or keyword filter (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "publish_lesson";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic key (used as public category)";
-            };
-            readonly lesson: {
-                readonly type: "string";
-                readonly description: "Lesson to publish (PII will be stripped)";
-            };
-            readonly framework: {
-                readonly type: "string";
-                readonly description: "Framework/platform tag (nextjs, fastapi, go, docker, etc.)";
-            };
-            readonly severity: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "major", "minor"];
-                readonly description: "Severity";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "lesson"];
-    };
-}, {
-    readonly name: "import_public_brain";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance to import into";
-            };
-            readonly framework: {
-                readonly type: "string";
-                readonly description: "Framework/platform to import lessons for";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max lessons to import (default: 20)";
-            };
-        };
-        readonly required: readonly ["instance_id", "framework"];
-    };
-}, {
-    readonly name: "recall_at";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic slug to look up, e.g. \"deploy:api\"";
-            };
-            readonly date: {
-                readonly type: "string";
-                readonly description: "ISO date string (e.g. \"2026-01-15\") — returns entries stored BEFORE this date";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "date"];
-    };
-}, {
-    readonly name: "trace_dependency";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly dependency: {
-                readonly type: "string";
-                readonly description: "Dependency to trace (e.g. \"node:>=20\", \"docker:running\", \"wireguard:active\")";
-            };
-            readonly mark_review: {
-                readonly type: "boolean";
-                readonly description: "If true, marks all dependent lessons as needs_review (default: false)";
-            };
-        };
-        readonly required: readonly ["instance_id", "dependency"];
-    };
-}, {
-    readonly name: "list_orgs";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {};
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "create_org";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly name: {
-                readonly type: "string";
-                readonly description: "Organization display name (e.g. \"Acme Engineering\")";
-            };
-            readonly slug: {
-                readonly type: "string";
-                readonly description: "URL-safe slug (e.g. \"acme-eng\"). Auto-generated from name if omitted.";
-            };
-        };
-        readonly required: readonly ["name"];
-    };
-}, {
-    readonly name: "invite_member";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly org_id: {
-                readonly type: "string";
-                readonly description: "UUID of the organization";
-            };
-            readonly email: {
-                readonly type: "string";
-                readonly description: "Email address to invite";
-            };
-            readonly role: {
-                readonly type: "string";
-                readonly enum: readonly ["admin", "member"];
-                readonly description: "Role for the invited member (default: member)";
-            };
-        };
-        readonly required: readonly ["org_id", "email"];
-    };
-}, {
-    readonly name: "get_org_plan";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly org_id: {
-                readonly type: "string";
-                readonly description: "UUID of the organization";
-            };
-        };
-        readonly required: readonly ["org_id"];
-    };
-}, {
-    readonly name: "setup_ai_memory";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cachly instance to use as the AI brain";
-            };
-            readonly project_dir: {
-                readonly type: "string";
-                readonly description: string;
-            };
-            readonly embed_provider: {
-                readonly type: "string";
-                readonly enum: readonly ["openai", "mistral", "cohere", "ollama", "gemini"];
-                readonly description: string;
-            };
-            readonly project_description: {
-                readonly type: "string";
-                readonly description: "Short description of the project (used in the generated instructions)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "cache_stream_set";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Cache key";
-            };
-            readonly chunks: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Ordered list of string chunks";
-            };
-            readonly ttl: {
-                readonly type: "number";
-                readonly description: "TTL in seconds for the stored list (optional)";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "chunks"];
-    };
-}, {
-    readonly name: "cache_stream_get";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Cache key";
-            };
-        };
-        readonly required: readonly ["instance_id", "key"];
-    };
-}, {
-    readonly name: "cache_org_stats";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly org_id: {
-                readonly type: "string";
-                readonly description: "Org ID to inspect (e.g. \"acme\", \"my-company\")";
-            };
-        };
-        readonly required: readonly ["instance_id", "org_id"];
-    };
-}, {
-    readonly name: "set_cost_per_call";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly cost_per_call_usd: {
-                readonly type: "number";
-                readonly description: "Cost per LLM API call in USD. Common values: 0.02 (claude-opus-4.8), 0.015 (gpt-5.5), 0.009 (claude-sonnet-4.6), 0.002 (gpt-5.5-mini), 0.001 (claude-haiku-4.5).";
-            };
-        };
-        readonly required: readonly ["instance_id", "cost_per_call_usd"];
-    };
-}, {
-    readonly name: "memory_consolidate";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "If true, report what would change without writing (default: false)";
-            };
-            readonly stale_days: {
-                readonly type: "number";
-                readonly description: "Lessons not recalled in this many days are flagged stale (default: 90)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_diff";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly since: {
-                readonly type: "string";
-                readonly description: "Time window: \"1d\", \"7d\", \"30d\", or ISO-8601 date (default: \"7d\")";
-            };
-            readonly format: {
-                readonly type: "string";
-                readonly enum: readonly ["summary", "detailed"];
-                readonly description: "Output format (default: summary)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "causal_trace";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly problem: {
-                readonly type: "string";
-                readonly description: "Describe the problem or error you are seeing right now";
-            };
-            readonly max_depth: {
-                readonly type: "number";
-                readonly description: "Max causal chain depth to trace (default: 5)";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Optional: narrow search to these tags";
-            };
-        };
-        readonly required: readonly ["instance_id", "problem"];
-    };
-}, {
-    readonly name: "knowledge_decay";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly min_age_days: {
-                readonly type: "number";
-                readonly description: "Only include lessons older than N days (default: 0 = all)";
-            };
-            readonly show_top: {
-                readonly type: "number";
-                readonly description: "Number of entries to return, sorted by lowest confidence first (default: 20)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "autopilot";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly editor: {
-                readonly type: "string";
-                readonly enum: readonly ["claude", "cursor", "copilot", "windsurf", "gemini", "continue", "all"];
-                readonly description: "Target editor (default: claude)";
-            };
-            readonly project_name: {
-                readonly type: "string";
-                readonly description: "Your project name (used in generated instructions)";
-            };
-            readonly style: {
-                readonly type: "string";
-                readonly enum: readonly ["minimal", "full"];
-                readonly description: "minimal = just the hooks, full = full ruleset with examples (default: full)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "syndicate";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic key in category:keyword format (e.g. \"fix:clickhouse-ipv6\", \"deploy:docker-compose\")";
-            };
-            readonly outcome: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure", "partial"];
-                readonly description: "Result of the attempt (default: success)";
-            };
-            readonly what_worked: {
-                readonly type: "string";
-                readonly description: "Exact approach, command, or fix that worked. File paths are stripped automatically.";
-            };
-            readonly what_failed: {
-                readonly type: "string";
-                readonly description: "What failed or was wrong — helps others avoid the same trap.";
-            };
-            readonly severity: {
-                readonly type: "string";
-                readonly enum: readonly ["critical", "major", "minor"];
-                readonly description: "How severe the issue was (default: minor)";
-            };
-            readonly tags: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Up to 10 keywords for better discoverability";
-            };
-            readonly scope: {
-                readonly type: "string";
-                readonly enum: readonly ["public", "org"];
-                readonly description: "Visibility: \"public\" = global commons (default), \"org\" = private to your org only";
-            };
-        };
-        readonly required: readonly ["topic", "what_worked"];
-    };
-}, {
-    readonly name: "syndicate_search";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly q: {
-                readonly type: "string";
-                readonly description: "Free-text search query (leave empty for most recent lessons)";
-            };
-            readonly category: {
-                readonly type: "string";
-                readonly description: "Filter by category prefix: \"fix\", \"deploy\", \"debug\", \"infra\", \"api\", \"web\"";
-            };
-            readonly scope: {
-                readonly type: "string";
-                readonly enum: readonly ["public", "org"];
-                readonly description: "\"public\" = global commons (default), \"org\" = public + your org-private lessons";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results to return (default: 20, max: 50)";
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "syndicate_stats";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {};
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "syndicate_trending";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results (default: 10, max: 50)";
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "brain_marketplace";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly min_confirms: {
-                readonly type: "number";
-                readonly description: "Only count lessons with at least this many community confirmations (default: 1)";
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "brain_install";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance";
-            };
-            readonly slug: {
-                readonly type: "string";
-                readonly description: "Domain brain slug from brain_marketplace (e.g. \"k8s\", \"auth\", \"db\")";
-            };
-            readonly min_confirms: {
-                readonly type: "number";
-                readonly description: "Only install lessons with at least this many community confirmations (default: 1)";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max lessons to install (default: 200, max: 500)";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "Preview what would be installed without writing anything (default: false)";
-            };
-        };
-        readonly required: readonly ["instance_id", "slug"];
-    };
-}, {
-    readonly name: "brain_search";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly query: {
-                readonly type: "string";
-                readonly description: "What to search for";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results (default: 15)";
-            };
-        };
-        readonly required: readonly ["instance_id", "query"];
-    };
-}, {
-    readonly name: "ckg_inspect";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly concept: {
-                readonly type: "string";
-                readonly description: "Concept to inspect, e.g. \"fix:clickhouse-ipv6\" or \"docker\"";
-            };
-            readonly max_hops: {
-                readonly type: "number";
-                readonly description: "Traversal depth (default: 2)";
-            };
-        };
-        readonly required: readonly ["instance_id", "concept"];
-    };
-}, {
-    readonly name: "brain_predict";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly context: {
-                readonly type: "string";
-                readonly description: "What you're working on, e.g. \"upgrading Keycloak from 21 to 24\"";
-            };
-            readonly top_k: {
-                readonly type: "number";
-                readonly description: "Max predictions to return (default: 5)";
-            };
-            readonly scope: {
-                readonly type: "string";
-                readonly enum: readonly ["instance", "org", "org+commons"];
-                readonly description: string;
-            };
-        };
-        readonly required: readonly ["instance_id", "context"];
-    };
-}, {
-    readonly name: "brain_plan";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly task: {
-                readonly type: "string";
-                readonly description: "The change you are about to make, e.g. \"migrate auth from sessions to JWT\"";
-            };
-            readonly top_k: {
-                readonly type: "number";
-                readonly description: "Max items per section (default: 5)";
-            };
-        };
-        readonly required: readonly ["instance_id", "task"];
-    };
-}, {
-    readonly name: "brain_conflicts";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_resolve_conflict";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "The contested topic, e.g. \"fix:jwks-rotation\"";
-            };
-            readonly winner: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure"];
-                readonly description: "Which side wins the arbitration";
-            };
-            readonly resolved_by: {
-                readonly type: "string";
-                readonly description: "Who resolved it (agent name or \"human\"); default \"human\"";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic", "winner"];
-    };
-}, {
-    readonly name: "brain_confirm_ci";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly job_status: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure", "cancelled"];
-                readonly description: "Outcome of the CI job";
-            };
-            readonly topics: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Topics touched by this CI run (e.g. [\"auth:jwt\", \"deploy:k8s\"])";
-            };
-            readonly scan_topics: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Topics the brain predicted would fail (from the scan response). Used to detect false positives.";
-            };
-            readonly source: {
-                readonly type: "string";
-                readonly description: "Optional: \"github_actions\", \"gitlab_ci\", etc.";
-            };
-        };
-        readonly required: readonly ["instance_id", "job_status", "topics"];
-    };
-}, {
-    readonly name: "brain_briefing";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly event_type: {
-                readonly type: "string";
-                readonly enum: readonly ["file_open", "pr_open", "deploy", "manual"];
-                readonly description: "What triggered this briefing — determines how the context is interpreted";
-            };
-            readonly context: {
-                readonly type: "string";
-                readonly description: "The event context: file path for file_open, title+body for pr_open, short description for deploy/manual";
-            };
-            readonly threshold: {
-                readonly type: "number";
-                readonly description: "Minimum confidence (0–1) for a warning to be surfaced. Default 0.6 — raise it to reduce noise.";
-            };
-        };
-        readonly required: readonly ["instance_id", "event_type", "context"];
-    };
-}, {
-    readonly name: "brain_contribute_signal";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly topic_category: {
-                readonly type: "string";
-                readonly description: "Normalised topic, e.g. \"auth:jwt\" or \"deploy:k8s\"";
-            };
-            readonly outcome: {
-                readonly type: "string";
-                readonly enum: readonly ["success", "failure", "partial"];
-                readonly description: "Outcome of the pattern";
-            };
-            readonly confidence: {
-                readonly type: "number";
-                readonly description: "Confidence 0–1 (bucketed before sending; default 0.5)";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic_category", "outcome"];
-    };
-}, {
-    readonly name: "brain_import_meta";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly category: {
-                readonly type: "string";
-                readonly description: "Optional filter, e.g. \"auth\" or \"deploy\"";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max meta-lessons to import (default 20, max 200)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "madc_deliberate";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Topic to deliberate, e.g. \"fix:jwks-rotation\"";
-            };
-            readonly context: {
-                readonly type: "string";
-                readonly description: "Optional context for the deliberation";
-            };
-        };
-        readonly required: readonly ["instance_id", "topic"];
-    };
-}, {
-    readonly name: "cls_ingest";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly source: {
-                readonly type: "string";
-                readonly enum: readonly ["git_commit", "ci_outcome", "ide_diagnostic"];
-                readonly description: "Event source type";
-            };
-            readonly payload: {
-                readonly type: "object";
-                readonly description: string;
-            };
-        };
-        readonly required: readonly ["instance_id", "source", "payload"];
-    };
-}, {
-    readonly name: "cls_install_hooks";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly repo_path: {
-                readonly type: "string";
-                readonly description: "Path to repo root (default: current dir)";
-            };
-            readonly hooks: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                    readonly enum: readonly ["git", "ci"];
-                };
-                readonly description: "Which hooks to output (default: [\"git\", \"ci\"])";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "fedbrain_contribute";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly lesson_key: {
-                readonly type: "string";
-                readonly description: "Topic key to contribute, e.g. \"fix:clickhouse-ipv6\"";
-            };
-            readonly visibility: {
-                readonly type: "string";
-                readonly enum: readonly ["public", "org_private"];
-                readonly description: "Visibility (default: public)";
-            };
-        };
-        readonly required: readonly ["instance_id", "lesson_key"];
-    };
-}, {
-    readonly name: "fedbrain_search";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly query: {
-                readonly type: "string";
-                readonly description: "What to search for";
-            };
-            readonly context_hints: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Your tech stack, e.g. [\"go\", \"kubernetes\", \"postgres\"]";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results (default: 10)";
-            };
-        };
-        readonly required: readonly ["instance_id", "query"];
-    };
-}, {
-    readonly name: "fedbrain_confirm";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly id: {
-                readonly type: "string";
-                readonly description: "Syndicated lesson id to confirm (shown next to each fedbrain_search result)";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Optional topic of the lesson — also updates your local CKG confidence for it";
-            };
-            readonly outcome: {
-                readonly type: "string";
-                readonly enum: readonly ["worked", "partially_worked", "did_not_work"];
-                readonly description: "Did the lesson work for you?";
-            };
-        };
-        readonly required: readonly ["instance_id", "id", "outcome"];
-    };
-}, {
-    readonly name: "fedbrain_status";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_federate";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Your brain instance ID (destination)";
-            };
-            readonly source: {
-                readonly type: "string";
-                readonly description: "Source brain instance ID to federate from";
-            };
-            readonly domain: {
-                readonly type: "string";
-                readonly description: "Domain to transfer, e.g. \"billing\", \"auth\", \"deploy\", \"infra\". Use \"*\" for all domains.";
-            };
-            readonly min_confidence: {
-                readonly type: "number";
-                readonly description: "Minimum edge confidence to transfer (default: 0.6)";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "Preview what would be transferred without writing (default: false)";
-            };
-        };
-        readonly required: readonly ["instance_id", "source", "domain"];
-    };
-}, {
-    readonly name: "crystal_view";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly show_raw: {
-                readonly type: "boolean";
-                readonly description: "Include raw JSON crystal data (default: false)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "compact_recover";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly focus: {
-                readonly type: "string";
-                readonly description: "What you were working on (helps filter relevant context)";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_from_git";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly repo_path: {
-                readonly type: "string";
-                readonly description: "Path to git repository (default: current directory)";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max commits to process (default: 100, max: 500)";
-            };
-            readonly branch: {
-                readonly type: "string";
-                readonly description: "Git branch to parse (default: current branch / HEAD)";
-            };
-            readonly since: {
-                readonly type: "string";
-                readonly description: "Only commits after this date, e.g. \"2024-01-01\" (optional)";
-            };
-            readonly incremental: {
-                readonly type: "boolean";
-                readonly description: "Only process commits since last run (default: true). Set false to reprocess all.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_from_ci";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly outcomes: {
-                readonly type: "array";
-                readonly description: "List of CI run outcomes to ingest";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly job: {
-                            readonly type: "string";
-                            readonly description: "Job name (e.g. \"test\", \"build\", \"lint\")";
-                        };
-                        readonly status: {
-                            readonly type: "string";
-                            readonly description: "Current status: success|failure|error";
-                        };
-                        readonly prev_status: {
-                            readonly type: "string";
-                            readonly description: "Previous run status (optional, needed to detect transitions)";
-                        };
-                        readonly context: {
-                            readonly type: "string";
-                            readonly description: "Optional: error message, branch, commit hash, etc.";
-                        };
-                    };
-                    readonly required: readonly ["job", "status"];
-                };
-            };
-        };
-        readonly required: readonly ["instance_id", "outcomes"];
-    };
-}, {
-    readonly name: "brain_watch";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID to learn into";
-            };
-            readonly project_dir: {
-                readonly type: "string";
-                readonly description: "Path to the git repository (default: current directory \".\")";
-            };
-            readonly api_key: {
-                readonly type: "string";
-                readonly description: "Optional cachly API key (cky_…) to embed in the hook for authentication";
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "brain_predict_failures";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "Brain instance ID";
-            };
-            readonly context: {
-                readonly type: "string";
-                readonly description: "What you are about to do, e.g. \"upgrading Keycloak 21 to 24\"";
-            };
-            readonly top_k: {
-                readonly type: "number";
-                readonly description: "Number of failure predictions to return (default: 5)";
-            };
-            readonly format: {
-                readonly type: "string";
-                readonly enum: readonly ["brief", "detailed"];
-                readonly description: "Output format (default: detailed)";
-            };
-        };
-        readonly required: readonly ["instance_id", "context"];
-    };
-}, {
-    readonly name: "brain_share";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance to export from.";
-            };
-            readonly title: {
-                readonly type: "string";
-                readonly description: "Human-readable title for the shared Brain snapshot. Default: \"My Brain Snapshot\".";
-            };
-            readonly description: {
-                readonly type: "string";
-                readonly description: "Short description of what knowledge this Brain contains.";
-            };
-            readonly topic_filter: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Only export lessons whose topic contains one of these strings. Omit to export all lessons.";
-            };
-            readonly visibility: {
-                readonly type: "string";
-                readonly enum: readonly ["public", "unlisted"];
-                readonly description: "\"public\" = discoverable in the Brain marketplace. \"unlisted\" = only accessible by direct link. Default: unlisted.";
-            };
-            readonly max_lessons: {
-                readonly type: "number";
-                readonly description: "Maximum number of lessons to include (default 100, max 500).";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "If true, preview what would be shared without creating the public link.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_import";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance to import lessons into.";
-            };
-            readonly share_id: {
-                readonly type: "string";
-                readonly description: "Share ID (UUID) or full share URL from brain_share.";
-            };
-            readonly topic_prefix: {
-                readonly type: "string";
-                readonly description: "Optional prefix to prepend to all imported topic names (e.g. \"team\" → \"team:auth:jwt-expiry\"). Prevents collisions with your own lessons.";
-            };
-            readonly min_confidence: {
-                readonly type: "number";
-                readonly description: "Skip lessons below this confidence threshold (0.0–1.0). Default: 0 (import all).";
-            };
-            readonly overwrite: {
-                readonly type: "boolean";
-                readonly description: "Replace existing lessons with the same topic. Default false.";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "Preview what would be imported without writing to the Brain.";
-            };
-        };
-        readonly required: readonly ["instance_id", "share_id"];
-    };
-}, {
-    readonly name: "brain_share_list";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance that created the shares.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_unshare";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance that owns the share.";
-            };
-            readonly share_id: {
-                readonly type: "string";
-                readonly description: "Share ID to revoke (from brain_share or brain_share_list).";
-            };
-        };
-        readonly required: readonly ["instance_id", "share_id"];
-    };
-}, {
-    readonly name: "brain_discover";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly query: {
-                readonly type: "string";
-                readonly description: "Full-text search query across Brain titles and descriptions.";
-            };
-            readonly topic: {
-                readonly type: "string";
-                readonly description: "Filter by topic prefix (e.g. \"auth\", \"docker\", \"nextjs\").";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max number of results to return (default 10, max 50).";
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "brain_seed_starter";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance to seed.";
-            };
-            readonly topic_filter: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-                readonly description: "Only seed lessons whose topic or tags match one of these strings (e.g. [\"docker\", \"auth\"]). Omit to seed all.";
-            };
-            readonly force: {
-                readonly type: "boolean";
-                readonly description: "Re-seed even if already seeded; also overwrites same-topic lessons. Default false.";
-            };
-            readonly dry_run: {
-                readonly type: "boolean";
-                readonly description: "Preview which starter lessons would be seeded without writing.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_graph";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance to export.";
-            };
-            readonly max_nodes: {
-                readonly type: "number";
-                readonly description: "Cap on nodes returned (default 400, max 2000). Edges to dropped nodes are pruned.";
-            };
-            readonly domain: {
-                readonly type: "string";
-                readonly description: "Only include nodes whose domain or id contains this string (e.g. \"auth\", \"docker\"). Omit for the whole graph.";
-            };
-            readonly min_confidence: {
-                readonly type: "number";
-                readonly description: "Drop edges below this confidence 0..1 (default 0 = keep all).";
-            };
-            readonly format: {
-                readonly type: "string";
-                readonly enum: readonly ["json", "summary"];
-                readonly description: "\"json\" (default) emits the full renderable payload; \"summary\" emits a human-readable overview.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}, {
-    readonly name: "brain_set_pref";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the cache instance (Brain ID).";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Preference key (e.g. \"auto_changelog\").";
-            };
-            readonly value: {
-                readonly type: "string";
-                readonly description: "Value to set (e.g. \"false\" to disable, \"true\" to re-enable).";
-            };
-        };
-        readonly required: readonly ["instance_id", "key", "value"];
-    };
-}, {
-    readonly name: "brain_get_pref";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly instance_id: {
-                readonly type: "string";
-                readonly description: "UUID of the Brain instance.";
-            };
-            readonly key: {
-                readonly type: "string";
-                readonly description: "Preference key to read. Omit to list all preferences.";
-            };
-        };
-        readonly required: readonly ["instance_id"];
-    };
-}];
-export { TOOLS };