grokbot-mcp 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nuncio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,6 +1,3 @@
 #!/usr/bin/env node
-export declare function listMcpTools(): {
-    name: string;
-    description: string;
-}[];
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,wBAAgB,YAAY;;;IAK3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,12 +1,22 @@
 #!/usr/bin/env node
-import { GROKBOT_TOOLS, GROKBOT_VERSION } from "grokbot-core";
-export function listMcpTools() {
-    return GROKBOT_TOOLS.map((t) => ({
-        name: `grokbot_${t.name}`,
-        description: t.summary,
-    }));
-}
-if (import.meta.url === `file://${process.argv[1]}`) {
-    console.log(`grokbot-mcp v${GROKBOT_VERSION} (${listMcpTools().length} tools)`);
-}
+import { createCommandRunner, GROKBOT_VERSION, } from "grokbot-core";
+import { serve } from "./server.js";
+// Built on the first tools/call, so initialize and tools/list never read the Keychain.
+let runner;
+const lazyRunner = {
+    run: (name, input, options) => {
+        runner ??= createCommandRunner({
+            defaultAgent: process.env.GROKBOT_AGENT,
+        });
+        return runner.run(name, input, options);
+    },
+};
+const log = (line) => process.stderr.write(`grokbot-mcp: ${line}\n`);
+log(`v${GROKBOT_VERSION} serving MCP on stdio`);
+await serve({
+    input: process.stdin,
+    output: process.stdout,
+    runner: lazyRunner,
+    log,
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,CAAC,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,OAAO,CAAC,GAAG,CACT,gBAAgB,eAAe,KAAK,YAAY,EAAE,CAAC,MAAM,SAAS,CACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAEL,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,uFAAuF;AACvF,IAAI,MAAiC,CAAC;AACtC,MAAM,UAAU,GAAkB;IAChC,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5B,MAAM,KAAK,mBAAmB,CAAC;YAC7B,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;SACxC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC;AAEF,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;AAE7E,GAAG,CAAC,IAAI,eAAe,uBAAuB,CAAC,CAAC;AAChD,MAAM,KAAK,CAAC;IACV,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,UAAU;IAClB,GAAG;CACJ,CAAC,CAAC"}

package/dist/json-rpc.d.ts

@@ -0,0 +1,37 @@
+import type { JsonObject } from "grokbot-core";
+export type RequestId = string | number;
+export interface RpcError {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: object;
+}
+export type Outcome = {
+    readonly result: object;
+} | {
+    readonly error: RpcError;
+};
+export type Incoming = {
+    readonly kind: "request";
+    readonly id: RequestId;
+    readonly method: string;
+    readonly params: JsonObject;
+} | {
+    readonly kind: "notification";
+    readonly method: string;
+    readonly params: JsonObject;
+} | {
+    readonly kind: "invalid";
+    readonly id: RequestId | null;
+    readonly error: RpcError;
+};
+export declare const PARSE_ERROR: RpcError;
+export declare const INVALID_REQUEST: RpcError;
+export declare const INTERNAL_ERROR: RpcError;
+export declare const methodNotFound: (method: string) => RpcError;
+export declare const invalidParams: (detail: string) => RpcError;
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function isRequestId(value: unknown): value is RequestId;
+/** Parses one stdio line. MCP forbids batches and null ids, so both are invalid. */
+export declare function parseIncoming(line: string): Incoming;
+export declare function encodeResponse(id: RequestId | null, outcome: Outcome): string;
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../src/json-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,QAAQ,GAChB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B,CAAC;AAEN,eAAO,MAAM,WAAW,EAAE,QAAmD,CAAC;AAC9E,eAAO,MAAM,eAAe,EAAE,QAG7B,CAAC;AACF,eAAO,MAAM,cAAc,EAAE,QAG5B,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,QAG9C,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,QAG7C,CAAC;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAqCpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7E"}

package/dist/json-rpc.js

@@ -0,0 +1,67 @@
+export const PARSE_ERROR = { code: -32700, message: "Parse error" };
+export const INVALID_REQUEST = {
+    code: -32600,
+    message: "Invalid Request",
+};
+export const INTERNAL_ERROR = {
+    code: -32603,
+    message: "Internal error",
+};
+export const methodNotFound = (method) => ({
+    code: -32601,
+    message: `Method not found: ${method}`,
+});
+export const invalidParams = (detail) => ({
+    code: -32602,
+    message: `Invalid params: ${detail}`,
+});
+export function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isRequestId(value) {
+    return typeof value === "string" || Number.isInteger(value);
+}
+/** Parses one stdio line. MCP forbids batches and null ids, so both are invalid. */
+export function parseIncoming(line) {
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return { kind: "invalid", id: null, error: PARSE_ERROR };
+    }
+    if (!isJsonObject(message)) {
+        return { kind: "invalid", id: null, error: INVALID_REQUEST };
+    }
+    const { id, method, params = {} } = message;
+    const hasId = Object.hasOwn(message, "id");
+    if (message.jsonrpc !== "2.0" || typeof method !== "string") {
+        return {
+            kind: "invalid",
+            id: isRequestId(id) ? id : null,
+            error: INVALID_REQUEST,
+        };
+    }
+    if (!hasId) {
+        return {
+            kind: "notification",
+            method,
+            params: isJsonObject(params) ? params : {},
+        };
+    }
+    if (!isRequestId(id)) {
+        return { kind: "invalid", id: null, error: INVALID_REQUEST };
+    }
+    if (!isJsonObject(params)) {
+        return {
+            kind: "invalid",
+            id,
+            error: invalidParams("params must be an object"),
+        };
+    }
+    return { kind: "request", id, method, params };
+}
+export function encodeResponse(id, outcome) {
+    return `${JSON.stringify({ jsonrpc: "2.0", id, ...outcome })}\n`;
+}
+//# sourceMappingURL=json-rpc.js.map

package/dist/json-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.js","sourceRoot":"","sources":["../src/json-rpc.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,WAAW,GAAa,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,IAAI,EAAE,CAAC,KAAK;IACZ,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,IAAI,EAAE,CAAC,KAAK;IACZ,OAAO,EAAE,gBAAgB;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAY,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,KAAK;IACZ,OAAO,EAAE,qBAAqB,MAAM,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAY,EAAE,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,KAAK;IACZ,OAAO,EAAE,mBAAmB,MAAM,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO;YACL,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;YAC/B,KAAK,EAAE,eAAe;SACvB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,MAAM;YACN,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;SAC3C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,EAAE;YACF,KAAK,EAAE,aAAa,CAAC,0BAA0B,CAAC;SACjD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAoB,EAAE,OAAgB;IACnE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC;AACnE,CAAC"}

package/dist/mcp-era-handlers.d.ts

@@ -0,0 +1,7 @@
+import { type CommandRunner, type JsonObject } from "grokbot-core";
+import type { Outcome } from "./json-rpc.js";
+import { type Era } from "./mcp-era-request.js";
+export type Handler = (params: JsonObject, signal: AbortSignal) => Outcome | Promise<Outcome>;
+/** Each era's methods. Modern drops initialize and ping and adds server/discover. */
+export declare function eraHandlers(runner: CommandRunner): Readonly<Record<Era, ReadonlyMap<string, Handler>>>;
+//# sourceMappingURL=mcp-era-handlers.d.ts.map

package/dist/mcp-era-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-era-handlers.d.ts","sourceRoot":"","sources":["../src/mcp-era-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,KAAK,GAAG,EAGT,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,OAAO,GAAG,CACpB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,WAAW,KAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAsChC,qFAAqF;AACrF,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GACpB,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA4BrD"}

package/dist/mcp-era-handlers.js

@@ -0,0 +1,64 @@
+import { GROKBOT_VERSION, } from "grokbot-core";
+import { LEGACY_VERSIONS, SUPPORTED_VERSIONS, } from "./mcp-era-request.js";
+import { callTool, mcpTools } from "./mcp-tools.js";
+const SERVER_INFO = { name: "grokbot-mcp", version: GROKBOT_VERSION };
+const INSTRUCTIONS = "Drives a GrokBot workforce: the AI agents on the owner's Grok Bot account. Start with grokbot_agents or grokbot_team to see who is available. Never pass yes: true without the owner's explicit approval.";
+/** Both results come from the catalog, so they are identical for every caller until an upgrade. */
+const CACHE_HINTS = { ttlMs: 3_600_000, cacheScope: "public" };
+function initialize(params) {
+    const protocolVersion = LEGACY_VERSIONS.find((v) => v === params.protocolVersion) ??
+        LEGACY_VERSIONS[0];
+    return {
+        result: {
+            protocolVersion,
+            capabilities: { tools: {} },
+            serverInfo: SERVER_INFO,
+        },
+    };
+}
+/** 2026-07-28 results carry `resultType`, and serverInfo rides in `_meta` because there is no handshake. */
+function complete(handler) {
+    return async (params, signal) => {
+        const outcome = await handler(params, signal);
+        if (!("result" in outcome))
+            return outcome;
+        return {
+            result: {
+                resultType: "complete",
+                ...outcome.result,
+                _meta: { "io.modelcontextprotocol/serverInfo": SERVER_INFO },
+            },
+        };
+    };
+}
+/** Each era's methods. Modern drops initialize and ping and adds server/discover. */
+export function eraHandlers(runner) {
+    const call = (params, signal) => callTool(params, runner, signal);
+    return {
+        legacy: new Map([
+            ["initialize", initialize],
+            ["ping", () => ({ result: {} })],
+            ["tools/list", () => ({ result: { tools: mcpTools() } })],
+            ["tools/call", call],
+        ]),
+        modern: new Map([
+            [
+                "server/discover",
+                complete(() => ({
+                    result: {
+                        supportedVersions: SUPPORTED_VERSIONS,
+                        capabilities: { tools: {} },
+                        instructions: INSTRUCTIONS,
+                        ...CACHE_HINTS,
+                    },
+                })),
+            ],
+            [
+                "tools/list",
+                complete(() => ({ result: { tools: mcpTools(), ...CACHE_HINTS } })),
+            ],
+            ["tools/call", complete(call)],
+        ]),
+    };
+}
+//# sourceMappingURL=mcp-era-handlers.js.map

package/dist/mcp-era-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-era-handlers.js","sourceRoot":"","sources":["../src/mcp-era-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,GAEhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAOpD,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAEtE,MAAM,YAAY,GAChB,2MAA2M,CAAC;AAE9M,mGAAmG;AACnG,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAW,CAAC;AAExE,SAAS,UAAU,CAAC,MAAkB;IACpC,MAAM,eAAe,GACnB,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,eAAe,CAAC;QACzD,eAAe,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO;QACL,MAAM,EAAE;YACN,eAAe;YACf,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAC3B,UAAU,EAAE,WAAW;SACxB;KACF,CAAC;AACJ,CAAC;AAED,4GAA4G;AAC5G,SAAS,QAAQ,CAAC,OAAgB;IAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC3C,OAAO;YACL,MAAM,EAAE;gBACN,UAAU,EAAE,UAAU;gBACtB,GAAG,OAAO,CAAC,MAAM;gBACjB,KAAK,EAAE,EAAE,oCAAoC,EAAE,WAAW,EAAE;aAC7D;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CACzB,MAAqB;IAErB,MAAM,IAAI,GAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3E,OAAO;QACL,MAAM,EAAE,IAAI,GAAG,CAAkB;YAC/B,CAAC,YAAY,EAAE,UAAU,CAAC;YAC1B,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC,YAAY,EAAE,IAAI,CAAC;SACrB,CAAC;QACF,MAAM,EAAE,IAAI,GAAG,CAAkB;YAC/B;gBACE,iBAAiB;gBACjB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;oBACd,MAAM,EAAE;wBACN,iBAAiB,EAAE,kBAAkB;wBACrC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;wBAC3B,YAAY,EAAE,YAAY;wBAC1B,GAAG,WAAW;qBACf;iBACF,CAAC,CAAC;aACJ;YACD;gBACE,YAAY;gBACZ,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,CAAC,CAAC;aACpE;YACD,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;SAC/B,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/mcp-era-request.d.ts

@@ -0,0 +1,19 @@
+import type { JsonObject } from "grokbot-core";
+import { type RpcError } from "./json-rpc.js";
+/** Revisions that open with the initialize handshake, newest first. */
+export declare const LEGACY_VERSIONS: readonly ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+/** Stateless revisions: every request carries its version and client capabilities in `_meta`. */
+export declare const MODERN_VERSIONS: readonly ["2026-07-28"];
+/** Advertised by server/discover and by -32022: every version this server answers, modern first. */
+export declare const SUPPORTED_VERSIONS: readonly string[];
+export type Era = "legacy" | "modern";
+/**
+ * Reads a request's era from its own `_meta`, never from earlier requests.
+ * The version is checked before the other fields because a newer revision may define them differently.
+ */
+export declare function requestEra(params: JsonObject): {
+    readonly era: Era;
+} | {
+    readonly error: RpcError;
+};
+//# sourceMappingURL=mcp-era-request.d.ts.map

package/dist/mcp-era-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-era-request.d.ts","sourceRoot":"","sources":["../src/mcp-era-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3E,uEAAuE;AACvE,eAAO,MAAM,eAAe,mEAKlB,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,eAAe,yBAA0B,CAAC;AAEvD,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAG/C,CAAC;AAEF,MAAM,MAAM,GAAG,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAWtC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,GACjB;IAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAuBtD"}

package/dist/mcp-era-request.js

@@ -0,0 +1,51 @@
+import { invalidParams, isJsonObject } from "./json-rpc.js";
+/** Revisions that open with the initialize handshake, newest first. */
+export const LEGACY_VERSIONS = [
+    "2025-11-25",
+    "2025-06-18",
+    "2025-03-26",
+    "2024-11-05",
+];
+/** Stateless revisions: every request carries its version and client capabilities in `_meta`. */
+export const MODERN_VERSIONS = ["2026-07-28"];
+/** Advertised by server/discover and by -32022: every version this server answers, modern first. */
+export const SUPPORTED_VERSIONS = [
+    ...MODERN_VERSIONS,
+    ...LEGACY_VERSIONS,
+];
+const PROTOCOL_VERSION = "io.modelcontextprotocol/protocolVersion";
+const CLIENT_CAPABILITIES = "io.modelcontextprotocol/clientCapabilities";
+const unsupportedVersion = (requested) => ({
+    code: -32022,
+    message: "Unsupported protocol version",
+    data: { supported: SUPPORTED_VERSIONS, requested },
+});
+/**
+ * Reads a request's era from its own `_meta`, never from earlier requests.
+ * The version is checked before the other fields because a newer revision may define them differently.
+ */
+export function requestEra(params) {
+    const meta = params._meta;
+    if (!isJsonObject(meta) || !Object.hasOwn(meta, PROTOCOL_VERSION)) {
+        return { era: "legacy" };
+    }
+    const version = meta[PROTOCOL_VERSION];
+    if (typeof version !== "string") {
+        return {
+            error: invalidParams(`_meta ${PROTOCOL_VERSION} must be a string`),
+        };
+    }
+    if (!MODERN_VERSIONS.some((modern) => modern === version)) {
+        return { error: unsupportedVersion(version) };
+    }
+    if (!Object.hasOwn(meta, CLIENT_CAPABILITIES)) {
+        return { error: invalidParams(`_meta ${CLIENT_CAPABILITIES} is required`) };
+    }
+    if (!isJsonObject(meta[CLIENT_CAPABILITIES])) {
+        return {
+            error: invalidParams(`_meta ${CLIENT_CAPABILITIES} must be an object`),
+        };
+    }
+    return { era: "modern" };
+}
+//# sourceMappingURL=mcp-era-request.js.map

package/dist/mcp-era-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-era-request.js","sourceRoot":"","sources":["../src/mcp-era-request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAE3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;CACJ,CAAC;AAEX,iGAAiG;AACjG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,CAAU,CAAC;AAEvD,oGAAoG;AACpG,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,GAAG,eAAe;IAClB,GAAG,eAAe;CACnB,CAAC;AAIF,MAAM,gBAAgB,GAAG,yCAAyC,CAAC;AACnE,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAY,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,KAAK;IACZ,OAAO,EAAE,8BAA8B;IACvC,IAAI,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE;CACnD,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,MAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,aAAa,CAAC,SAAS,gBAAgB,mBAAmB,CAAC;SACnE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,SAAS,mBAAmB,cAAc,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,aAAa,CAAC,SAAS,mBAAmB,oBAAoB,CAAC;SACvE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/mcp-tool-parts.d.ts

@@ -0,0 +1,23 @@
+import type { CommandName, CommandOutputs } from "grokbot-core";
+export type ToolSummary<N extends CommandName> = (output: CommandOutputs[N]) => string;
+/** One command group's tools/call summaries, exhaustive over the group's names. */
+export type ToolSummaries<Names extends CommandName> = {
+    readonly [N in Names]: ToolSummary<N>;
+};
+/** How one tool differs from its catalog entry. */
+export interface McpOverride {
+    readonly note?: string;
+    /** Replaces catalog defaults when the client leaves the param out. */
+    readonly defaults?: Readonly<Record<string, number>>;
+    readonly destructive?: true;
+    /** Params an MCP client may never set (hidden from the schema, refused on call). */
+    readonly hiddenParams?: readonly string[];
+    /** The command is not offered over MCP at all (CLI only). */
+    readonly cliOnly?: true;
+}
+export type McpOverrides<Names extends CommandName> = {
+    readonly [N in Names]?: McpOverride;
+};
+export declare const plural: (n: number, one: string, many: string) => string;
+export declare const waitHint: (jobId: string) => string;
+//# sourceMappingURL=mcp-tool-parts.d.ts.map

package/dist/mcp-tool-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-parts.d.ts","sourceRoot":"","sources":["../src/mcp-tool-parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,IAAI,CAC/C,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,KACtB,MAAM,CAAC;AAEZ,mFAAmF;AACnF,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,WAAW,IAAI;IACrD,QAAQ,EAAE,CAAC,IAAI,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,WAAW,IAAI;IACpD,QAAQ,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,WAAW;CACpC,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,WAC3B,CAAC;AAEjC,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,WACsB,CAAC"}

package/dist/mcp-tool-parts.js

@@ -0,0 +1,3 @@
+export const plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+export const waitHint = (jobId) => `call grokbot_wait with ${JSON.stringify({ job: jobId })}`;
+//# sourceMappingURL=mcp-tool-parts.js.map

package/dist/mcp-tool-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-parts.js","sourceRoot":"","sources":["../src/mcp-tool-parts.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,IAAY,EAAE,EAAE,CAC7D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CACxC,0BAA0B,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC"}

package/dist/mcp-tools-dispatch.d.ts

@@ -0,0 +1,5 @@
+import { type DispatchCommandName } from "grokbot-core";
+import { type McpOverrides, type ToolSummaries } from "./mcp-tool-parts.js";
+export declare const DISPATCH_OVERRIDES: McpOverrides<DispatchCommandName>;
+export declare const DISPATCH_SUMMARIES: ToolSummaries<DispatchCommandName>;
+//# sourceMappingURL=mcp-tools-dispatch.d.ts.map

package/dist/mcp-tools-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-dispatch.d.ts","sourceRoot":"","sources":["../src/mcp-tools-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAKzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAY7B,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,mBAAmB,CAUhE,CAAC;AA8CF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,mBAAmB,CA2BjE,CAAC"}

package/dist/mcp-tools-dispatch.js

@@ -0,0 +1,85 @@
+import { isActive, } from "grokbot-core";
+import { plural, waitHint, } from "./mcp-tool-parts.js";
+/**
+ * Well under the ~300 s at which MCP hosts kill a tool call (Hermes), so ask and wait
+ * return a still-running result with the job id first instead of dying mid-wait.
+ */
+const MCP_WAIT_TIMEOUT_SECONDS = 45;
+/** What a finished result means, shared by every tool that waits on a job. */
+const OUTCOMES = '"done" means the bot\'s run for this message ended, not that the task is verified; "ambiguous" means one run answered this message together with another, and the result holds every reply of that run';
+export const DISPATCH_OVERRIDES = {
+    ask: {
+        note: `Waits ${MCP_WAIT_TIMEOUT_SECONDS} s unless timeout is set; a still-running result carries a job id, and grokbot_wait resumes it. ${OUTCOMES}`,
+        defaults: { timeout: MCP_WAIT_TIMEOUT_SECONDS },
+    },
+    wait: {
+        note: `Waits ${MCP_WAIT_TIMEOUT_SECONDS} s unless timeout is set, to stay under MCP host time limits; a still-running result carries the job id, so call grokbot_wait again with it. ${OUTCOMES}`,
+        defaults: { timeout: MCP_WAIT_TIMEOUT_SECONDS },
+    },
+    interrupt: { destructive: true },
+};
+function outcomeText(who, jobId, outcome) {
+    switch (outcome.status) {
+        case "done":
+            return `${who} replied:\n${outcome.finalReply}`;
+        case "ambiguous":
+            return `${who} finished, but the reply is ambiguous: ${outcome.reason}. Every reply of that run, in order:\n${outcome.replyText}`;
+        case "pending":
+            return outcome.queued
+                ? `${outcome.reason}. Job ${jobId} is saved; ${waitHint(jobId)} to send it and keep waiting.`
+                : `${who} is still working (${outcome.reason}). Job ${jobId} is saved; ${waitHint(jobId)} to keep waiting.`;
+        case "awaiting-approval":
+            return `${who} is waiting for owner approval (${outcome.reason}). Approve it in the Grok Bot app, then ${waitHint(jobId)}.`;
+    }
+}
+function memberText({ agent, status }) {
+    if (status.awaiting) {
+        return `- ${agent.name}: awaiting owner (${status.awaiting.reason})`;
+    }
+    if (!isActive(status))
+        return `- ${agent.name}: idle`;
+    const tool = status.activityTool ? ` (${status.activityTool})` : "";
+    return `- ${agent.name}: running${tool}`;
+}
+function entryText(entry) {
+    switch (entry.kind) {
+        case "user-message":
+            return `user${entry.fromAgent ? ` (from ${entry.fromAgent.name})` : ""}: ${entry.content}`;
+        case "assistant-message":
+            return `assistant${entry.toAgent ? ` (to ${entry.toAgent.name})` : ""}: ${entry.content}`;
+        // Attachment URLs may be signed links, so only the file name is shown.
+        case "reply":
+            return entry.reply.type === "text"
+                ? `reply: ${entry.reply.content}`
+                : `reply: ${`${entry.reply.fileName} [attachment]`.trim()}`;
+        case "card":
+            return `card ${entry.cardType}`;
+        case "blob":
+            return `blob ${entry.blobHash}`;
+        case "unknown":
+            return `unknown ${entry.entryKind}`;
+    }
+}
+export const DISPATCH_SUMMARIES = {
+    agents: ({ agents }) => [
+        `${plural(agents.length, "agent", "agents")}:`,
+        ...agents.map((a) => `- ${a.name} (${a.kind}, ${a.agentId})`),
+    ].join("\n"),
+    team: ({ members }) => [
+        `${plural(members.length, "agent", "agents")}:`,
+        ...members.map(memberText),
+    ].join("\n"),
+    ask: ({ jobId, agent, outcome }) => outcomeText(agent.name, jobId, outcome),
+    send: ({ jobId, agent, queued }) => queued
+        ? `Queued for ${agent.name}: it is busy, so the message goes out once it is free. Job ${jobId} is saved; ${waitHint(jobId)} to send it and get the reply.`
+        : `Sent to ${agent.name}. Job ${jobId} is saved; ${waitHint(jobId)} for the reply.`,
+    wait: ({ jobId, agentId, agentName, outcome }) => outcomeText(agentName ?? `Agent ${agentId}`, jobId, outcome),
+    tail: ({ agent, entries }) => [
+        `${agent.name}, last ${plural(entries.length, "entry", "entries")}:`,
+        ...entries.map((e) => `#${e.seq} ${entryText(e)}`),
+    ].join("\n"),
+    interrupt: ({ agent, hadActiveRun }) => hadActiveRun
+        ? `Interrupted the active run on ${agent.name}.`
+        : `${agent.name} had no active run.`,
+};
+//# sourceMappingURL=mcp-tools-dispatch.js.map

package/dist/mcp-tools-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-dispatch.js","sourceRoot":"","sources":["../src/mcp-tools-dispatch.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tools-governance.d.ts

@@ -0,0 +1,5 @@
+import type { GovernanceCommandName } from "grokbot-core";
+import { type McpOverrides, type ToolSummaries } from "./mcp-tool-parts.js";
+export declare const GOVERNANCE_OVERRIDES: McpOverrides<GovernanceCommandName>;
+export declare const GOVERNANCE_SUMMARIES: ToolSummaries<GovernanceCommandName>;
+//# sourceMappingURL=mcp-tools-governance.d.ts.map

package/dist/mcp-tools-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-governance.d.ts","sourceRoot":"","sources":["../src/mcp-tools-governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,qBAAqB,CAWpE,CAAC;AAkBF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,qBAAqB,CAwCrE,CAAC"}

package/dist/mcp-tools-governance.js

@@ -0,0 +1,53 @@
+import { plural, } from "./mcp-tool-parts.js";
+export const GOVERNANCE_OVERRIDES = {
+    answer: {
+        note: "Pass value to answer the open widget, or dismiss: true to close it",
+    },
+    // The viewer URL is a credential, so it never lands in structuredContent.
+    vnc: {
+        note: "Opens the viewer on the host Mac",
+        hiddenParams: ["print-url"],
+    },
+    // The worker inherits stdio, which is this server's JSON-RPC pipe.
+    "worker-start": { cliOnly: true },
+};
+function cardText(card) {
+    switch (card.type) {
+        case "widget":
+            return `widget ${card.entryId}: ${card.prompt}${card.options.length > 0 ? ` [${card.options.join(" | ")}]` : ""}`;
+        case "auto-review-approval":
+            return `auto-review-approval ${card.entryId}: ${card.summary}${card.command ? ` (${card.command})` : ""}`;
+        case "local-tool-permission":
+            return `local-tool-permission ${card.entryId}: ${card.action} ${card.target}`;
+        default:
+            return `${card.type} ${card.entryId}`;
+    }
+}
+const resolved = (out) => `${out.resolution}: ${out.card.type} ${out.card.entryId} on ${out.agent.name}.${out.wroteLocalApproval ? " Also recorded in ~/.grokbot/local-tool-approvals.json." : ""}`;
+export const GOVERNANCE_SUMMARIES = {
+    approvals: ({ agents }) => agents.length === 0
+        ? "No open approval cards."
+        : agents
+            .flatMap(({ agent, awaiting, cards }) => cards.length === 0
+            ? [`- ${agent.name}: awaiting ${awaiting ?? ""}`.trimEnd()]
+            : cards.map((card) => `- ${agent.name}: ${cardText(card)}`))
+            .join("\n"),
+    answer: ({ agent, card, dismissed, value }) => dismissed
+        ? `Dismissed widget ${card.entryId} on ${agent.name}.`
+        : `Accepted: answered widget ${card.entryId} on ${agent.name} with ${JSON.stringify(value ?? "")}.`,
+    approve: resolved,
+    deny: resolved,
+    computers: ({ computers }) => [
+        `${plural(computers.length, "computer", "computers")}:`,
+        ...computers.map((c) => `- ${c.label || c.machineId} (${c.kind || "unknown"}, ${c.machineId})`),
+    ].join("\n"),
+    "mcp-list": ({ servers }) => [
+        `${plural(servers.length, "MCP server", "MCP servers")}:`,
+        ...servers.map((s) => `- ${s.serverIdentifier} (${s.name}): ${plural(s.toolCount, "tool", "tools")}, ${s.status || "unknown"}`),
+    ].join("\n"),
+    "mcp-call": ({ server, tool, result }) => `${server}/${tool}${result.isError ? " reported an error" : ""}:\n${result.text}`,
+    vnc: ({ window }) => `Opened desktop window ${window} on the host.`,
+    "worker-plan": ({ plan, registered }) => `Nothing started. Command:\n${plan.command.join(" ")}\nenv: ${plan.envNames.join(" ")}\nRegistered computers now: ${registered.join(", ") || "none"}.`,
+    "worker-start": ({ exitCode, tokenServes }) => `Worker exited with code ${exitCode ?? "null (signal)"}. Served the token ${plural(tokenServes, "time", "times")}.`,
+};
+//# sourceMappingURL=mcp-tools-governance.js.map

package/dist/mcp-tools-governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-governance.js","sourceRoot":"","sources":["../src/mcp-tools-governance.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tools-workforce.d.ts

@@ -0,0 +1,5 @@
+import type { WorkforceCommandName } from "grokbot-core";
+import { type McpOverrides, type ToolSummaries } from "./mcp-tool-parts.js";
+export declare const WORKFORCE_OVERRIDES: McpOverrides<WorkforceCommandName>;
+export declare const WORKFORCE_SUMMARIES: ToolSummaries<WorkforceCommandName>;
+//# sourceMappingURL=mcp-tools-workforce.d.ts.map

package/dist/mcp-tools-workforce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-workforce.d.ts","sourceRoot":"","sources":["../src/mcp-tools-workforce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,oBAAoB,CAuBlE,CAAC;AAiBF,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,oBAAoB,CAsCnE,CAAC"}

package/dist/mcp-tools-workforce.js

@@ -0,0 +1,63 @@
+import { plural, } from "./mcp-tool-parts.js";
+/** Overrides on protected bots and managed skills, and local file paths, are CLI only. */
+const FORCE = "force-protected";
+const MANAGED = "include-managed";
+export const WORKFORCE_OVERRIDES = {
+    hire: {
+        note: "Idempotent: calling it again with the same name re-briefs the bot it hired and keeps its instructions unless you pass new ones",
+        hiddenParams: ["instructions-file"],
+    },
+    update: { hiddenParams: ["instructions-file"] },
+    fire: { hiddenParams: [FORCE] },
+    "skills-list": {
+        note: "The skill library is Box-wide: every bot sees the same one",
+    },
+    "skills-push": {
+        note: "Pass the SKILL.md text as markdown. The library is Box-wide (all bots). Same name and content: no-op; different content needs replace and yes, which deletes the old copy for every bot",
+        hiddenParams: ["file"],
+        destructive: true,
+    },
+    "skills-remove": {
+        note: "Removes an imported skill for every bot (the library is Box-wide)",
+        hiddenParams: [MANAGED, FORCE],
+    },
+    "skills-run": { hiddenParams: [MANAGED] },
+    "routines-enable": { hiddenParams: [FORCE] },
+    "routines-disable": { hiddenParams: [FORCE] },
+    "routines-delete": { hiddenParams: [FORCE] },
+};
+const PUSHED = {
+    imported: "Imported skill",
+    replaced: "Replaced skill",
+    unchanged: "Nothing imported: it already has the same content as skill",
+    exists: "Nothing imported: its content could not be compared with the existing skill",
+};
+const names = (agents) => agents.map((a) => a.name).join(", ");
+const routineText = (r) => `${r.name} (${r.automationId}): ${r.enabled ? "on" : "off"}, ${r.schedule || r.trigger || "no trigger"}${r.nextRunAt ? `, next run ${r.nextRunAt}` : ""}`;
+export const WORKFORCE_SUMMARIES = {
+    hire: ({ agent, folder, result }) => `${result === "created" ? "Hired" : "Re-briefed the already hired"} ${agent.name} (${agent.agentId}). Folder: ${folder}`,
+    update: ({ agent, changed }) => changed.length === 0
+        ? `${agent.name} already had those values; nothing changed.`
+        : `Updated ${agent.name}: ${changed.join(", ")}.`,
+    fire: ({ agent }) => `Deleted ${agent.name} (${agent.agentId}).`,
+    "room-create": ({ room, members, result }) => `${result === "created" ? "Created" : "Found existing"} room ${room.name} (${room.agentId}) with ${names(members)}. Send it a message with the ask tool.`,
+    "room-members": ({ room, members }) => `Room ${room.name} now has ${names(members)}.`,
+    "skills-list": ({ agent, skills }) => [
+        `The Box-wide (all bots) skill library has ${plural(skills.length, "skill", "skills")} (read through ${agent.name}):`,
+        ...skills.map((s) => `- ${s.name || s.id} (${s.source}, ${s.id})`),
+    ].join("\n"),
+    "skills-push": ({ agent, skill, result }) => result === "exists"
+        ? `${PUSHED[result]} ${skill.name} (${skill.id}) in the Box-wide (all bots) skill library. Pass replace and yes to import over it.`
+        : `${PUSHED[result]} ${skill.name} (${skill.id}) ${result === "imported" ? "into" : "in"} the Box-wide (all bots) skill library, through ${agent.name}.`,
+    "skills-remove": ({ agent, skill, remaining }) => `Removed skill ${skill.name} (${skill.id}) from the Box-wide (all bots) skill library, through ${agent.name}; ${plural(remaining, "skill", "skills")} left.`,
+    "skills-run": ({ agent, skill }) => `Started skill ${skill.name} (${skill.id}) from the Box-wide (all bots) skill library on ${agent.name}.`,
+    "routines-list": ({ agent, routines }) => [
+        `${agent.name} has ${plural(routines.length, "routine", "routines")}:`,
+        ...routines.map((r) => `- ${routineText(r)}`),
+    ].join("\n"),
+    "routines-enable": ({ agent, routine }) => `Turned on ${agent.name}'s routine ${routineText(routine)}.`,
+    "routines-disable": ({ agent, routine }) => `Turned off ${agent.name}'s routine ${routineText(routine)}.`,
+    "routines-delete": ({ agent, routine, remaining }) => `Deleted ${agent.name}'s routine ${routine.name} (${routine.automationId}); ${plural(remaining, "routine", "routines")} left.`,
+    "routines-create": ({ agent, routine, result }) => `${result === "created" ? "Created" : "Found existing"} routine for ${agent.name}: ${routineText(routine)}.`,
+};
+//# sourceMappingURL=mcp-tools-workforce.js.map

package/dist/mcp-tools-workforce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools-workforce.js","sourceRoot":"","sources":["../src/mcp-tools-workforce.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tools.d.ts

@@ -0,0 +1,24 @@
+import { type Command, type CommandJsonSchema, type CommandName, type CommandRunner } from "grokbot-core";
+import { type Outcome } from "./json-rpc.js";
+import type { McpOverride } from "./mcp-tool-parts.js";
+interface ToolAnnotations {
+    readonly readOnlyHint: boolean;
+    readonly destructiveHint: boolean;
+}
+export interface McpTool {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: CommandJsonSchema;
+    readonly annotations: ToolAnnotations;
+}
+/** `room-create` -> `grokbot_room_create`: one separator style across every MCP tool name. */
+export declare function toolName(command: CommandName): string;
+/** Inverse of `toolName`; undefined for anything that is not a catalog tool. */
+export declare function commandForTool(tool: string): CommandName | undefined;
+/** The tools/list entry of one catalog command. */
+export declare function mcpTool(command: Command, override?: McpOverride): McpTool;
+export declare function mcpTools(): readonly McpTool[];
+/** `tools/call`: bad tool names are protocol errors; bad arguments and GrokBot failures are tool errors. */
+export declare function callTool(params: Readonly<Record<string, unknown>>, runner: CommandRunner, signal: AbortSignal): Promise<Outcome>;
+export {};
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAOnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAQrE,UAAU,eAAe;IACvB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;CACvC;AAgED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMpE;AAED,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAezE;AAED,wBAAgB,QAAQ,IAAI,SAAS,OAAO,EAAE,CAI7C;AAiDD,4GAA4G;AAC5G,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/mcp-tools.js

@@ -0,0 +1,131 @@
+import { GrokBotError, isCommandName, listCommands, paramsJsonSchema, parseCommandInput, } from "grokbot-core";
+import { invalidParams, isJsonObject } from "./json-rpc.js";
+import { DISPATCH_OVERRIDES } from "./mcp-tools-dispatch.js";
+import { GOVERNANCE_OVERRIDES } from "./mcp-tools-governance.js";
+import { WORKFORCE_OVERRIDES } from "./mcp-tools-workforce.js";
+import { summarize } from "./tool-summaries.js";
+const TOOL_PREFIX = "grokbot_";
+const SAFETY = {
+    "read-only": {
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    writes: {
+        note: "Writes: changes state on a live GrokBot agent",
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    },
+    destructive: {
+        note: "Destructive: deletes live GrokBot data; pass yes: true only after the owner approves",
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    sensitive: {
+        note: "Sensitive: acts with the owner's authority; pass yes: true only after the owner approves",
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+};
+const MCP_OVERRIDES = {
+    ...DISPATCH_OVERRIDES,
+    ...WORKFORCE_OVERRIDES,
+    ...GOVERNANCE_OVERRIDES,
+};
+/** Params never offered over MCP: `json` (results are always structured) plus the tool's hidden ones. */
+const hiddenOver = (override) => new Set(["json", ...(override?.hiddenParams ?? [])]);
+/** MCP results are always structured, so the CLI-only `json` flag is dropped. */
+function inputSchema(command, override) {
+    const defaults = override?.defaults ?? {};
+    const hidden = hiddenOver(override);
+    const schema = paramsJsonSchema(command.params);
+    const properties = Object.fromEntries(Object.entries(schema.properties)
+        .filter(([key]) => !hidden.has(key))
+        .map(([key, prop]) => {
+        const value = defaults[key];
+        return [key, value === undefined ? prop : { ...prop, default: value }];
+    }));
+    const required = schema.required?.filter((key) => !hidden.has(key));
+    const { required: _drop, ...rest } = schema;
+    return {
+        ...rest,
+        properties,
+        ...(required && required.length > 0 ? { required } : {}),
+    };
+}
+/** `room-create` -> `grokbot_room_create`: one separator style across every MCP tool name. */
+export function toolName(command) {
+    return `${TOOL_PREFIX}${command.replaceAll("-", "_")}`;
+}
+/** Inverse of `toolName`; undefined for anything that is not a catalog tool. */
+export function commandForTool(tool) {
+    if (!tool.startsWith(TOOL_PREFIX))
+        return undefined;
+    const command = tool.slice(TOOL_PREFIX.length).replaceAll("_", "-");
+    return isCommandName(command) && toolName(command) === tool
+        ? command
+        : undefined;
+}
+/** The tools/list entry of one catalog command. */
+export function mcpTool(command, override) {
+    const { name, summary, safety } = command;
+    const notes = [SAFETY[safety].note, override?.note].filter((note) => note !== undefined);
+    const { annotations } = SAFETY[safety];
+    return {
+        name: toolName(name),
+        description: notes.length === 0 ? summary : `${[summary, ...notes].join(". ")}.`,
+        inputSchema: inputSchema(command, override),
+        annotations: override?.destructive
+            ? { ...annotations, destructiveHint: true }
+            : annotations,
+    };
+}
+export function mcpTools() {
+    return listCommands()
+        .filter((command) => !MCP_OVERRIDES[command.name]?.cliOnly)
+        .map((command) => mcpTool(command, MCP_OVERRIDES[command.name]));
+}
+const isBlank = (value) => value === undefined || (typeof value === "string" && !value.trim());
+function withMcpDefaults(name, args) {
+    const defaults = Object.entries(MCP_OVERRIDES[name]?.defaults ?? {});
+    const missing = defaults.filter(([key]) => isBlank(args[key]));
+    return missing.length > 0
+        ? { ...args, ...Object.fromEntries(missing) }
+        : args;
+}
+const errorResult = (text) => ({
+    content: [{ type: "text", text }],
+    isError: true,
+});
+async function runTool(name, args, runner, signal) {
+    const hidden = [...hiddenOver(MCP_OVERRIDES[name])].filter((key) => key !== "json" && args[key] !== undefined);
+    if (hidden.length > 0) {
+        return errorResult(`${toolName(name)}: ${hidden.join(", ")} cannot be set over MCP; use the grokbot CLI.`);
+    }
+    const parsed = parseCommandInput(name, withMcpDefaults(name, args));
+    if (!parsed.ok)
+        return errorResult(parsed.errors.join("\n"));
+    try {
+        const output = await runner.run(name, parsed.input, { signal });
+        return {
+            content: [{ type: "text", text: summarize(name, output) }],
+            structuredContent: output,
+        };
+    }
+    catch (error) {
+        if (error instanceof GrokBotError)
+            return errorResult(error.message);
+        throw error;
+    }
+}
+/** `tools/call`: bad tool names are protocol errors; bad arguments and GrokBot failures are tool errors. */
+export async function callTool(params, runner, signal) {
+    const { name, arguments: args = {} } = params;
+    if (typeof name !== "string") {
+        return { error: invalidParams("name must be a string") };
+    }
+    if (!isJsonObject(args)) {
+        return { error: invalidParams("arguments must be an object") };
+    }
+    const command = commandForTool(name);
+    if (command === undefined || MCP_OVERRIDES[command]?.cliOnly) {
+        return { error: { code: -32602, message: `Unknown tool: ${name}` } };
+    }
+    return { result: await runTool(command, args, runner, signal) };
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import type { CommandRunner } from "grokbot-core";
+export interface ServeOptions {
+    readonly input: NodeJS.ReadableStream;
+    /** Receives only newline-terminated JSON-RPC messages. */
+    readonly output: {
+        readonly write: (chunk: string) => unknown;
+    };
+    readonly runner: CommandRunner;
+    /** Diagnostics; index.ts sends them to stderr. */
+    readonly log: (line: string) => void;
+}
+/**
+ * Serves MCP over newline-delimited JSON-RPC until `input` ends.
+ * Dual-era: a request whose `_meta` names a protocol version is served statelessly
+ * by the 2026-07-28 rules; anything else gets today's initialize-era behavior.
+ */
+export declare function serve(options: ServeOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,cAAc,CAAC;AAa9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEhE"}

package/dist/server.js

@@ -0,0 +1,78 @@
+import { createInterface } from "node:readline";
+import { encodeResponse, INTERNAL_ERROR, isRequestId, methodNotFound, parseIncoming, } from "./json-rpc.js";
+import { eraHandlers } from "./mcp-era-handlers.js";
+import { requestEra } from "./mcp-era-request.js";
+/**
+ * Serves MCP over newline-delimited JSON-RPC until `input` ends.
+ * Dual-era: a request whose `_meta` names a protocol version is served statelessly
+ * by the 2026-07-28 rules; anything else gets today's initialize-era behavior.
+ */
+export async function serve(options) {
+    const { input, output, runner, log } = options;
+    const handlers = eraHandlers(runner);
+    const inFlight = new Map();
+    const running = new Set();
+    const send = (id, outcome) => {
+        output.write(encodeResponse(id, outcome));
+    };
+    // An aborted request gets no response: the client cancelled it or hung up.
+    async function respond(id, method, params) {
+        const route = requestEra(params);
+        if ("error" in route)
+            return send(id, { error: route.error });
+        const handler = handlers[route.era].get(method);
+        if (!handler)
+            return send(id, { error: methodNotFound(method) });
+        const controller = new AbortController();
+        inFlight.set(id, controller);
+        let outcome;
+        try {
+            outcome = await handler(params, controller.signal);
+        }
+        catch (error) {
+            if (!controller.signal.aborted) {
+                log(`${method} ${id} failed: ${String(error)}`);
+            }
+            outcome = { error: INTERNAL_ERROR };
+        }
+        finally {
+            inFlight.delete(id);
+        }
+        if (!controller.signal.aborted)
+            send(id, outcome);
+    }
+    function cancel(params) {
+        const { requestId, reason } = params;
+        const controller = isRequestId(requestId)
+            ? inFlight.get(requestId)
+            : undefined;
+        if (!controller)
+            return;
+        log(`cancelled request ${requestId}: ${String(reason ?? "no reason")}`);
+        controller.abort();
+    }
+    for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+        if (!line.trim())
+            continue;
+        const message = parseIncoming(line);
+        switch (message.kind) {
+            case "invalid":
+                send(message.id, { error: message.error });
+                break;
+            case "notification":
+                if (message.method === "notifications/cancelled") {
+                    cancel(message.params);
+                }
+                break;
+            case "request": {
+                const task = respond(message.id, message.method, message.params);
+                running.add(task);
+                task.finally(() => running.delete(task));
+            }
+        }
+    }
+    for (const controller of inFlight.values())
+        controller.abort();
+    await Promise.all(running);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tool-summaries.d.ts

@@ -0,0 +1,4 @@
+import type { CommandName, CommandOutput } from "grokbot-core";
+/** The text block of a tools/call result; the typed output rides in structuredContent. */
+export declare function summarize<N extends CommandName>(name: N, output: CommandOutput<N>): string;
+//# sourceMappingURL=tool-summaries.d.ts.map

package/dist/tool-summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-summaries.d.ts","sourceRoot":"","sources":["../src/tool-summaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAY/D,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,EAC7C,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,MAAM,CAGR"}

package/dist/tool-summaries.js

@@ -0,0 +1,14 @@
+import { DISPATCH_SUMMARIES } from "./mcp-tools-dispatch.js";
+import { GOVERNANCE_SUMMARIES } from "./mcp-tools-governance.js";
+import { WORKFORCE_SUMMARIES } from "./mcp-tools-workforce.js";
+const SUMMARIES = {
+    ...DISPATCH_SUMMARIES,
+    ...WORKFORCE_SUMMARIES,
+    ...GOVERNANCE_SUMMARIES,
+};
+/** The text block of a tools/call result; the typed output rides in structuredContent. */
+export function summarize(name, output) {
+    const summary = SUMMARIES[name];
+    return summary(output);
+}
+//# sourceMappingURL=tool-summaries.js.map

package/dist/tool-summaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-summaries.js","sourceRoot":"","sources":["../src/tool-summaries.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,SAAS,GAA+B;IAC5C,GAAG,kBAAkB;IACrB,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;CACxB,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,SAAS,CACvB,IAAO,EACP,MAAwB;IAExB,MAAM,OAAO,GAAmB,SAAS,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,19 +1,24 @@
 {
   "name": "grokbot-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server over grokbot-core for driving a GrokBot workforce from any MCP-compatible agent.",
   "license": "MIT",
   "type": "module",
+  "engines": {
+    "node": ">=20.3"
+  },
   "bin": {
     "grokbot-mcp": "dist/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/fixtures"
   ],
   "dependencies": {
-    "grokbot-core": "^0.1.0"
+    "grokbot-core": "^0.1.2"
   },
   "repository": {
     "type": "git",