@agentsean/mcp 1.0.0

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACxE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,GAAG,aAAa,CA4ChB"}

package/dist/client.js

@@ -0,0 +1,44 @@
+/**
+ * MCP *client* so Sean can consume OpenSEO if the user already runs it.
+ * LEARN_FROM OpenSEO's streamable-HTTP transport; we speak JSON-RPC over POST.
+ * Agent Sean is not a fork of OpenSEO.
+ */
+export function createOpenSeoClient(opts) {
+    const fetchFn = opts.fetch ?? fetch;
+    let nextId = 1;
+    async function rpc(method, params) {
+        const headers = {
+            "content-type": "application/json",
+            accept: "application/json, text/event-stream",
+        };
+        if (opts.apiKey)
+            headers["authorization"] = `Bearer ${opts.apiKey}`;
+        const res = await fetchFn(opts.url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: nextId++,
+                method,
+                ...(params ? { params } : {}),
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`OpenSEO MCP HTTP ${res.status}`);
+        const json = (await res.json());
+        if (json.error)
+            throw new Error(json.error.message ?? "OpenSEO MCP error");
+        return json.result;
+    }
+    return {
+        url: opts.url,
+        async listTools() {
+            const result = (await rpc("tools/list"));
+            return result.tools ?? [];
+        },
+        async callTool(name, args) {
+            return rpc("tools/call", { name, arguments: args ?? {} });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,UAAU,GAAG,CAChB,MAAc,EACd,MAAgC;QAEhC,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,qCAAqC;SAC9C,CAAC;QACF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,MAAM,EAAE;gBACZ,MAAM;gBACN,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,CAAC,SAAS;YACb,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,YAAY,CAAC,CAEtC,CAAC;YACF,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;YACvB,OAAO,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,31 @@
+export type CallToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
+    isError?: boolean;
+};
+type McpResponseMeta = {
+    url?: string;
+    projectId?: string;
+    runId?: string;
+    creditsCharged?: number;
+    creditsRemaining?: number;
+};
+export declare function mcpResponse<T extends Record<string, unknown>>(opts: {
+    text: string;
+    meta?: McpResponseMeta;
+    structuredContent: T;
+}): CallToolResult & {
+    structuredContent: T & {
+        meta?: Record<string, unknown>;
+    };
+};
+export declare function mcpResponse(opts: {
+    text: string;
+    meta?: McpResponseMeta;
+}): CallToolResult;
+export {};
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAOF,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,iBAAiB,EAAE,CAAC,CAAC;CACtB,GAAG,cAAc,GAAG;IACnB,iBAAiB,EAAE,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC3D,CAAC;AACF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,GAAG,cAAc,CAAC"}

package/dist/formatters.js

@@ -0,0 +1,31 @@
+// Copied from OpenSEO (every-app/open-seo) src/server/mcp/formatters.ts
+// under the MIT License. Copyright (c) 2026 Ben Senescu and contributors.
+// COPY_VERBATIM except the CallToolResult import: OpenSEO used
+// `@modelcontextprotocol/server`; Sean's MCP is stdio-first and uses a local
+// type matching the MCP spec so we do not take a Workers MCP runtime.
+export function mcpResponse(opts) {
+    const result = {
+        content: [{ type: "text", text: opts.text }],
+    };
+    let meta;
+    if (opts.meta) {
+        meta = {};
+        for (const [key, value] of Object.entries(opts.meta)) {
+            if (value !== undefined)
+                meta[key] = value;
+        }
+    }
+    const hasMeta = meta != null && Object.keys(meta).length > 0;
+    if (opts.structuredContent) {
+        result.structuredContent =
+            hasMeta && meta ? { ...opts.structuredContent, meta } : opts.structuredContent;
+    }
+    else if (hasMeta && meta) {
+        result.structuredContent = { meta };
+    }
+    if (hasMeta && meta) {
+        result._meta = meta;
+    }
+    return result;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,+DAA+D;AAC/D,6EAA6E;AAC7E,sEAAsE;AAiCtE,MAAM,UAAU,WAAW,CAAC,IAI3B;IACC,MAAM,MAAM,GAAmB;QAC7B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KAC7C,CAAC;IACF,IAAI,IAAyC,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,GAAG,EAAE,CAAC;QACV,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,CAAC,iBAAiB;YACtB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnF,CAAC;SAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,CAAC,iBAAiB,GAAG,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { formatMcpCell, formatMcpTable, truncatedCell, readPath, type McpTableColumn, } from "./table.js";
+export { mcpResponse, type CallToolResult } from "./formatters.js";
+export { MCP_TOOLS, callTool, type McpTool, type ToolContext } from "./tools.js";
+export { MCP_PROTOCOL, handleMcpMessage, handleMcpMessageAsync, serveStdio, } from "./server.js";
+export { createOpenSeoClient, type OpenSeoClient } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,QAAQ,EACR,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { formatMcpCell, formatMcpTable, truncatedCell, readPath, } from "./table.js";
+export { mcpResponse } from "./formatters.js";
+export { MCP_TOOLS, callTool } from "./tools.js";
+export { MCP_PROTOCOL, handleMcpMessage, handleMcpMessageAsync, serveStdio, } from "./server.js";
+export { createOpenSeoClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,QAAQ,GAET,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAuB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAkC,MAAM,YAAY,CAAC;AACjF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+import { type ToolContext } from "./tools.js";
+export declare const MCP_PROTOCOL = "2024-11-05";
+type JsonRpc = {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+};
+export declare function handleMcpMessage(_ctx: ToolContext, msg: JsonRpc): JsonRpc | null;
+export declare function handleMcpMessageAsync(ctx: ToolContext, msg: JsonRpc): Promise<JsonRpc | null>;
+export declare function serveStdio(ctx: ToolContext, stdin?: NodeJS.ReadStream & {
+    fd: 0;
+}, stdout?: NodeJS.WriteStream & {
+    fd: 1;
+}): Promise<void>;
+export {};
+//# 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":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,KAAK,OAAO,GAAG;IACb,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAiDhF;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUzB;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK;;CAAgB,EACrB,MAAM;;CAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/server.js

@@ -0,0 +1,90 @@
+import { MCP_TOOLS, callTool } from "./tools.js";
+export const MCP_PROTOCOL = "2024-11-05";
+export function handleMcpMessage(_ctx, msg) {
+    if (msg.method === "notifications/initialized" ||
+        msg.method === "notifications/cancelled") {
+        return null;
+    }
+    const id = msg.id ?? null;
+    if (msg.method === "initialize") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                protocolVersion: MCP_PROTOCOL,
+                capabilities: { tools: {} },
+                serverInfo: { name: "agentsean", version: "2026.9.0" },
+                instructions: "Agent Sean MCP. Demand-side intelligence from GSC + Bing by default. DataForSEO upgrades in place. Sean never scrapes Google. The LLM never holds write credentials.",
+            },
+        };
+    }
+    if (msg.method === "ping") {
+        return { jsonrpc: "2.0", id, result: {} };
+    }
+    if (msg.method === "tools/list") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                tools: MCP_TOOLS.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                })),
+            },
+        };
+    }
+    if (msg.method === "tools/call") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: -32603, message: "tools/call requires handleMcpMessageAsync" },
+        };
+    }
+    return {
+        jsonrpc: "2.0",
+        id,
+        error: { code: -32601, message: `Method not found: ${msg.method ?? "unknown"}` },
+    };
+}
+export async function handleMcpMessageAsync(ctx, msg) {
+    if (msg.method === "tools/call") {
+        const params = (msg.params ?? {});
+        const result = await callTool(ctx, params.name ?? "", params.arguments ?? {});
+        return { jsonrpc: "2.0", id: msg.id ?? null, result };
+    }
+    return handleMcpMessage(ctx, msg);
+}
+export async function serveStdio(ctx, stdin = process.stdin, stdout = process.stdout) {
+    stdin.setEncoding("utf8");
+    let buf = "";
+    const write = (msg) => {
+        stdout.write(JSON.stringify(msg) + "\n");
+    };
+    for await (const chunk of stdin) {
+        buf += chunk;
+        let idx;
+        while ((idx = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, idx).trim();
+            buf = buf.slice(idx + 1);
+            if (!line)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                write({
+                    jsonrpc: "2.0",
+                    id: null,
+                    error: { code: -32700, message: "Parse error" },
+                });
+                continue;
+            }
+            const reply = await handleMcpMessageAsync(ctx, parsed);
+            if (reply)
+                write(reply);
+        }
+    }
+}
+//# 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/table.d.ts

@@ -0,0 +1,20 @@
+export type McpTableColumn<T> = {
+    header: string;
+    value: (row: T) => unknown;
+    /** Override the default cell formatting for this column. */
+    format?: (value: unknown) => string;
+};
+/** Format a single cell. Nullish/empty -> "—"; integers stay exact; other
+ *  numbers get 2 decimals; strings are collapsed to a single line so a stray
+ *  newline can't break the table layout. */
+export declare function formatMcpCell(value: unknown): string;
+/** Column `format` that truncates long text after normal cell formatting, so
+ *  provider prose can't dominate the table (full text stays in
+ *  structuredContent). */
+export declare function truncatedCell(maxLength: number): (value: unknown) => string;
+/** Render rows as a `header | header` table with one line per row. */
+export declare function formatMcpTable<T>(rows: readonly T[], columns: readonly McpTableColumn<T>[]): string;
+/** Walk a chain of keys through nested unknown records (provider rows).
+ *  Returns undefined if any hop isn't an object. */
+export declare function readPath(source: unknown, ...path: string[]): unknown;
+//# sourceMappingURL=table.d.ts.map

package/dist/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../src/table.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACrC,CAAC;AAEF;;4CAE4C;AAC5C,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBpD;AAED;;0BAE0B;AAC1B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,IACrC,OAAO,OAAO,KAAG,MAAM,CAIhC;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,OAAO,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GACpC,MAAM,CAWR;AAED;oDACoD;AACpD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAOpE"}

package/dist/table.js

@@ -0,0 +1,61 @@
+// Copied from OpenSEO (every-app/open-seo) src/server/mcp/table.ts
+// under the MIT License. Copyright (c) 2026 Ben Senescu and contributors.
+// COPY_VERBATIM — token-efficient MCP table rendering.
+/** Format a single cell. Nullish/empty -> "—"; integers stay exact; other
+ *  numbers get 2 decimals; strings are collapsed to a single line so a stray
+ *  newline can't break the table layout. */
+export function formatMcpCell(value) {
+    if (value == null || value === "")
+        return "—";
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            return "—";
+        return Number.isInteger(value) ? String(value) : value.toFixed(2);
+    }
+    if (typeof value === "boolean")
+        return value ? "yes" : "no";
+    if (typeof value === "string")
+        return value.replace(/\s+/g, " ").trim();
+    if (typeof value === "bigint")
+        return value.toString();
+    // Arrays/objects would stringify to "[object Object]"; emit compact JSON so a
+    // stray nested value still reads as something in the text table.
+    try {
+        return JSON.stringify(value) ?? "—";
+    }
+    catch {
+        return "—";
+    }
+}
+/** Column `format` that truncates long text after normal cell formatting, so
+ *  provider prose can't dominate the table (full text stays in
+ *  structuredContent). */
+export function truncatedCell(maxLength) {
+    return (value) => {
+        const cell = formatMcpCell(value);
+        return cell.length > maxLength ? `${cell.slice(0, maxLength - 1)}…` : cell;
+    };
+}
+/** Render rows as a `header | header` table with one line per row. */
+export function formatMcpTable(rows, columns) {
+    const headerLine = columns.map((column) => column.header).join(" | ");
+    const rowLines = rows.map((row) => columns
+        .map((column) => {
+        const raw = column.value(row);
+        return column.format ? column.format(raw) : formatMcpCell(raw);
+    })
+        .join(" | "));
+    return [headerLine, ...rowLines].join("\n");
+}
+/** Walk a chain of keys through nested unknown records (provider rows).
+ *  Returns undefined if any hop isn't an object. */
+export function readPath(source, ...path) {
+    let current = source;
+    for (const key of path) {
+        if (typeof current !== "object" || current === null)
+            return undefined;
+        current = Reflect.get(current, key);
+    }
+    return current;
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../src/table.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,0EAA0E;AAC1E,uDAAuD;AASvD;;4CAE4C;AAC5C,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACxC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,8EAA8E;IAC9E,iEAAiE;IACjE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;0BAE0B;AAC1B,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,CAAC,KAAc,EAAU,EAAE;QAChC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,OAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAChC,OAAO;SACJ,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC,CAAC;SACD,IAAI,CAAC,KAAK,CAAC,CACf,CAAC;IACF,OAAO,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;oDACoD;AACpD,MAAM,UAAU,QAAQ,CAAC,MAAe,EAAE,GAAG,IAAc;IACzD,IAAI,OAAO,GAAY,MAAM,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACtE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,13 @@
+import { type SqliteDatabase } from "@agentsean/db";
+import { type CallToolResult } from "./formatters.js";
+export type McpTool = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+};
+export declare const MCP_TOOLS: McpTool[];
+export type ToolContext = {
+    db: SqliteDatabase;
+};
+export declare function callTool(ctx: ToolContext, name: string, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAWpF,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OAAO,EA2F9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,cAAc,CAAC;CACpB,CAAC;AAEF,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CA4BzB"}