@tleblancureta/proto 0.1.0

package/dist/core-mcp/src/define-tool.js

@@ -0,0 +1,38 @@
+/**
+ * Identity helper with type inference. Pass a definition object, get it back
+ * unchanged. Use in default exports of app/tools files:
+ *
+ *   export default [defineTool({ ... }), defineTool({ ... })]
+ */
+export function defineTool(def) {
+    return def;
+}
+/**
+ * Register an array of tool definitions on a server instance. Wraps each
+ * handler in a try/catch that emits a normalized error response if the tool
+ * throws.
+ */
+export function registerTools(server, defs) {
+    for (const def of defs) {
+        server.tool(def.name, def.description, def.schema, async (args) => {
+            try {
+                return await def.handler(args);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                summary: `Error en ${def.name}: ${message}`,
+                                error: true,
+                            }),
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=define-tool.js.map

package/dist/core-mcp/src/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../../../core-mcp/src/define-tool.ts"],"names":[],"mappings":"AA2DA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,GAAsB;IAEtB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,IAA+B;IAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CACT,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,MAAM,EACV,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,IAAa,CAAC,CAAA;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACtE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,YAAY,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE;gCAC3C,KAAK,EAAE,IAAI;6BACZ,CAAC;yBACH;qBACF;iBACF,CAAA;YACH,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/core-mcp/src/entity-tools.d.ts

@@ -0,0 +1,27 @@
+/**
+ * registerEntityTools — generates activate_<name> / deactivate_<name> /
+ * get_active_<name> MCP tools from an array of entity definitions.
+ *
+ * The active state lives in a module-level Map, which is naturally per-process
+ * for stdio transport (one subprocess per session) and per-session for HTTP
+ * transport (each session builds a fresh server via `buildServer()`).
+ *
+ * Apps call this from their tools/index.ts:
+ *
+ *   import { registerEntityTools } from 'proto/mcp'
+ *   import { ENTITIES } from '../entities/index.js'
+ *
+ *   export function registerAppTools(server) {
+ *     registerUiTools(server)
+ *     registerTools(server, ALL_APP_TOOLS)
+ *     registerEntityTools(server, ENTITIES)
+ *   }
+ */
+import { z } from 'zod';
+import type { EntityDefinition } from '../../core-shared/src/index.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function buildEntityTools(defs: readonly EntityDefinition[]): (import("./define-tool.js").ToolDefinition<{
+    [x: string]: z.ZodString;
+}> | import("./define-tool.js").ToolDefinition<{}>)[];
+export declare function registerEntityTools(server: McpServer, defs: readonly EntityDefinition[]): void;
+//# sourceMappingURL=entity-tools.d.ts.map

package/dist/core-mcp/src/entity-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-tools.d.ts","sourceRoot":"","sources":["../../../core-mcp/src/entity-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAexE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE;;sDAwEjE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAChC,IAAI,CAEN"}

package/dist/core-mcp/src/entity-tools.js

@@ -0,0 +1,99 @@
+/**
+ * registerEntityTools — generates activate_<name> / deactivate_<name> /
+ * get_active_<name> MCP tools from an array of entity definitions.
+ *
+ * The active state lives in a module-level Map, which is naturally per-process
+ * for stdio transport (one subprocess per session) and per-session for HTTP
+ * transport (each session builds a fresh server via `buildServer()`).
+ *
+ * Apps call this from their tools/index.ts:
+ *
+ *   import { registerEntityTools } from 'proto/mcp'
+ *   import { ENTITIES } from '../entities/index.js'
+ *
+ *   export function registerAppTools(server) {
+ *     registerUiTools(server)
+ *     registerTools(server, ALL_APP_TOOLS)
+ *     registerEntityTools(server, ENTITIES)
+ *   }
+ */
+import { z } from 'zod';
+import { defineTool, registerTools } from './define-tool.js';
+import { getSupabase } from './supabase.js';
+import { ok } from './tools/_helpers.js';
+const activeByName = new Map();
+function json(obj) {
+    return ok(JSON.stringify(obj, null, 2));
+}
+export function buildEntityTools(defs) {
+    return defs.flatMap(def => {
+        const idField = `${def.name}_id`;
+        const singular = def.displayName || def.name;
+        const activateDesc = def.activateDescription
+            ?? `Activa un ${singular} como foco del agente. Llama esta tool cuando empieces a trabajar sobre un ${singular} especifico, y cada vez que cambies de ${singular}. El frontend entra en "cockpit mode" con los widgets focalizados y las tools scoped operan sobre este ${singular} sin necesidad de repetir el id en cada llamada.`;
+        const deactivateDesc = `Desactiva el ${singular} activo. El frontend vuelve al layout general.`;
+        const getActiveDesc = `Devuelve el ${singular} activo actual (si hay).`;
+        return [
+            defineTool({
+                name: `activate_${def.name}`,
+                description: activateDesc,
+                schema: { [idField]: z.string().describe(`UUID del ${singular} a activar`) },
+                handler: async (args) => {
+                    const id = args[idField];
+                    const db = getSupabase();
+                    const { data, error } = await db
+                        .from(def.table)
+                        .select('*')
+                        .eq('id', id)
+                        .maybeSingle();
+                    if (error)
+                        return ok(`Error: ${error.message}`);
+                    if (!data)
+                        return ok(`${singular} ${id} no encontrado`);
+                    activeByName.set(def.name, { id });
+                    return json({
+                        ok: true,
+                        activated: {
+                            type: def.name,
+                            id,
+                            label: data[def.labelField] ?? null,
+                        },
+                        entity: data,
+                        message: `${singular} activado. El cockpit del frontend quedo abierto.`,
+                    });
+                },
+            }),
+            defineTool({
+                name: `deactivate_${def.name}`,
+                description: deactivateDesc,
+                schema: {},
+                handler: async () => {
+                    const prev = activeByName.get(def.name) ?? null;
+                    activeByName.set(def.name, null);
+                    return json({ ok: true, deactivated: prev?.id ?? null });
+                },
+            }),
+            defineTool({
+                name: `get_active_${def.name}`,
+                description: getActiveDesc,
+                schema: {},
+                handler: async () => {
+                    const active = activeByName.get(def.name) ?? null;
+                    if (!active)
+                        return json({ active: null });
+                    const db = getSupabase();
+                    const { data } = await db
+                        .from(def.table)
+                        .select('*')
+                        .eq('id', active.id)
+                        .maybeSingle();
+                    return json({ active, entity: data });
+                },
+            }),
+        ];
+    });
+}
+export function registerEntityTools(server, defs) {
+    registerTools(server, buildEntityTools(defs));
+}
+//# sourceMappingURL=entity-tools.js.map

package/dist/core-mcp/src/entity-tools.js.map

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

package/dist/core-mcp/src/index.d.ts

@@ -0,0 +1,36 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { getSupabase } from './supabase.js';
+export { ok, json, err, agent, agentErr } from './tools/_helpers.js';
+export { registerUiTools } from './tools/ui.js';
+export { McpServer };
+export { defineTool, registerTools, type ToolDefinition, type ToolHandler, type ToolResult, } from './define-tool.js';
+export { buildEntityTools, registerEntityTools } from './entity-tools.js';
+export { buildWorkflowTools, registerWorkflowTools } from './workflow-tools.js';
+export { createProtoMcp, type ProtoMcpOptions } from './app.js';
+export interface CreateMcpServerOptions {
+    name: string;
+    version?: string;
+}
+export declare function createMcpServer(opts: CreateMcpServerOptions): McpServer;
+/**
+ * Run the given server over stdio. Blocks until the transport closes.
+ * Used when the MCP server is spawned as a subprocess by Claude Code CLI.
+ */
+export declare function runStdio(server: McpServer): Promise<void>;
+export interface RunHttpOptions {
+    port: number;
+    /**
+     * Factory called per-session to build a fresh McpServer with tools registered.
+     * Each Claude Code session gets an isolated server instance so active-order
+     * (and other per-session state) doesn't leak between users.
+     */
+    buildServer: () => McpServer;
+    /** Optional display name used in log output. */
+    displayName?: string;
+}
+/**
+ * Run an HTTP streamable MCP server with session management.
+ * Handles /mcp (POST/GET/DELETE) and /health endpoints.
+ */
+export declare function runHttp(opts: RunHttpOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core-mcp/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core-mcp/src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAMnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAI/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS,CAKvE;AAID;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,SAAS,CAAA;IAC5B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFjE"}

package/dist/core-mcp/src/index.js

@@ -0,0 +1,116 @@
+/**
+ * @proto/core-mcp — MCP server framework library.
+ *
+ * Provides factory functions to build and run MCP servers over stdio or HTTP,
+ * plus shared helpers that app-space tools use to compose responses.
+ *
+ * Apps consume this as a library:
+ *
+ *   import { createMcpServer, runStdio } from 'proto/mcp'
+ *   const server = createMcpServer({ name: 'my-app' })
+ *   registerMyTools(server)
+ *   await runStdio(server)
+ */
+import { createServer as createHttpServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+// ── Re-exports for app tools ──
+export { getSupabase } from './supabase.js';
+export { ok, json, err, agent, agentErr } from './tools/_helpers.js';
+export { registerUiTools } from './tools/ui.js';
+export { McpServer };
+export { defineTool, registerTools, } from './define-tool.js';
+export { buildEntityTools, registerEntityTools } from './entity-tools.js';
+export { buildWorkflowTools, registerWorkflowTools } from './workflow-tools.js';
+export { createProtoMcp } from './app.js';
+export function createMcpServer(opts) {
+    return new McpServer({
+        name: opts.name,
+        version: opts.version || '0.1.0',
+    });
+}
+// ── Stdio transport ──
+/**
+ * Run the given server over stdio. Blocks until the transport closes.
+ * Used when the MCP server is spawned as a subprocess by Claude Code CLI.
+ */
+export async function runStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/**
+ * Run an HTTP streamable MCP server with session management.
+ * Handles /mcp (POST/GET/DELETE) and /health endpoints.
+ */
+export async function runHttp(opts) {
+    const sessions = new Map();
+    const name = opts.displayName || 'proto-mcp';
+    const httpServer = createHttpServer(async (req, res) => {
+        // CORS
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, mcp-session-id');
+        res.setHeader('Access-Control-Expose-Headers', 'mcp-session-id');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok', sessions: sessions.size }));
+            return;
+        }
+        if (req.url !== '/mcp') {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
+        const sessionId = req.headers['mcp-session-id'];
+        if (req.method === 'GET' || req.method === 'DELETE') {
+            if (!sessionId || !sessions.has(sessionId)) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Invalid or missing session' }));
+                return;
+            }
+            const transport = sessions.get(sessionId);
+            await transport.handleRequest(req, res);
+            if (req.method === 'DELETE') {
+                sessions.delete(sessionId);
+            }
+            return;
+        }
+        if (req.method === 'POST') {
+            if (sessionId && sessions.has(sessionId)) {
+                const transport = sessions.get(sessionId);
+                await transport.handleRequest(req, res);
+                return;
+            }
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            const server = opts.buildServer();
+            await server.connect(transport);
+            transport.onclose = () => {
+                if (transport.sessionId)
+                    sessions.delete(transport.sessionId);
+            };
+            await transport.handleRequest(req, res);
+            if (transport.sessionId) {
+                sessions.set(transport.sessionId, transport);
+            }
+            return;
+        }
+        res.writeHead(405);
+        res.end('Method not allowed');
+    });
+    return new Promise(resolve => {
+        httpServer.listen(opts.port, () => {
+            console.log(`${name} MCP server listening on port ${opts.port}`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/core-mcp/src/index.js.map

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

package/dist/core-mcp/src/supabase.d.ts

@@ -0,0 +1,7 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+/**
+ * Get Supabase client initialized with service role key from environment.
+ * Service role key bypasses RLS — only used server-side in MCP tools.
+ */
+export declare function getSupabase(): SupabaseClient;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/core-mcp/src/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../../core-mcp/src/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAIpE;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAY5C"}

package/dist/core-mcp/src/supabase.js

@@ -0,0 +1,18 @@
+import { createClient } from '@supabase/supabase-js';
+let client = null;
+/**
+ * Get Supabase client initialized with service role key from environment.
+ * Service role key bypasses RLS — only used server-side in MCP tools.
+ */
+export function getSupabase() {
+    if (client)
+        return client;
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_ROLE_KEY;
+    if (!url || !key) {
+        throw new Error('SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY must be set');
+    }
+    client = createClient(url, key);
+    return client;
+}
+//# sourceMappingURL=supabase.js.map

package/dist/core-mcp/src/supabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.js","sourceRoot":"","sources":["../../../core-mcp/src/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAEpE,IAAI,MAAM,GAA0B,IAAI,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAA;IAEjD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/core-mcp/src/tools/_helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Framework-level tool helpers. Keep this tiny and dependency-free —
+ * only reusable primitives live here. Domain-specific helpers live
+ * in the app (e.g. examples/hermes/app/tools/_hermes-helpers.ts).
+ */
+export declare const ok: (text: string) => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare const json: (obj: unknown) => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare const err: (msg: string) => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+interface AgentResponse {
+    summary: string;
+    data: Record<string, unknown>;
+    hint?: string;
+}
+/** Structured response for the agent: summary + curated data + optional hint. */
+export declare function agent(r: AgentResponse): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Structured error for the agent with optional context. */
+export declare function agentErr(summary: string, details?: Record<string, unknown>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export {};
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/core-mcp/src/tools/_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../../../core-mcp/src/tools/_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,EAAE,GAAI,MAAM,MAAM;;;;;CAAqD,CAAA;AACpF,eAAO,MAAM,IAAI,GAAI,KAAK,OAAO;;;;;CAAqC,CAAA;AACtE,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM;;;;;CAAwB,CAAA;AAIvD,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,CAAC,EAAE,aAAa;;;;;EAIrC;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EAI1E"}

package/dist/core-mcp/src/tools/_helpers.js

@@ -0,0 +1,23 @@
+/**
+ * Framework-level tool helpers. Keep this tiny and dependency-free —
+ * only reusable primitives live here. Domain-specific helpers live
+ * in the app (e.g. examples/hermes/app/tools/_hermes-helpers.ts).
+ */
+export const ok = (text) => ({ content: [{ type: 'text', text }] });
+export const json = (obj) => ok(JSON.stringify(obj, null, 2));
+export const err = (msg) => ok(`Error: ${msg}`);
+/** Structured response for the agent: summary + curated data + optional hint. */
+export function agent(r) {
+    const out = { summary: r.summary, data: r.data };
+    if (r.hint)
+        out.hint = r.hint;
+    return ok(JSON.stringify(out));
+}
+/** Structured error for the agent with optional context. */
+export function agentErr(summary, details) {
+    const out = { summary, error: true };
+    if (details)
+        out.data = details;
+    return ok(JSON.stringify(out));
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/core-mcp/src/tools/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../../../core-mcp/src/tools/_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;AACpF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AACtE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,CAAA;AAUvD,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,CAAgB;IACpC,MAAM,GAAG,GAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACzE,IAAI,CAAC,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAA;IAC7B,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,OAAiC;IACzE,MAAM,GAAG,GAA4B,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAC7D,IAAI,OAAO;QAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAA;IAC/B,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC"}

package/dist/core-mcp/src/tools/ui.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Generative UI: the agent calls `render_ui` to project an interactive
+ * component tree into the frontend shell. The tool itself is a no-op on the
+ * server — its purpose is to emit a `tool_use` event in the SSE stream that
+ * the frontend can intercept and render.
+ */
+export declare function registerUiTools(server: McpServer): void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/core-mcp/src/tools/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../core-mcp/src/tools/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGnE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAgGhD"}

package/dist/core-mcp/src/tools/ui.js

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+/**
+ * Generative UI: the agent calls `render_ui` to project an interactive
+ * component tree into the frontend shell. The tool itself is a no-op on the
+ * server — its purpose is to emit a `tool_use` event in the SSE stream that
+ * the frontend can intercept and render.
+ */
+export function registerUiTools(server) {
+    server.tool('render_ui', `Project an interactive component tree into the user's shell (right canvas). The other widgets minimize so the user can focus on exploring the generated UI.
+
+Use this WHENEVER you have structured data the user should browse visually: supplier search results, product comparisons, timelines, dashboards, tables, etc. Prefer this over large markdown tables in chat.
+
+The \`spec\` is a JSON tree of primitives. Each node = { "type": "PrimitiveName", ...props, "children": [...] }.
+
+## Available primitives
+
+### Layout
+- **Stack** { gap?: 1-6, children } — vertical flex column.
+- **Row** { gap?: 1-6, align?: "start"|"center"|"end"|"baseline", children } — horizontal flex.
+- **Grid** { cols: 1|2|3|4, gap?: 1-6, children } — responsive grid.
+
+### Typography
+- **Heading** { text: string, level?: 1|2|3 }
+- **Text** { text: string, muted?: boolean, size?: "xs"|"sm" }
+
+### Content
+- **Image** { src: string, alt?: string, aspect?: "square"|"video"|"auto" (default "square"), fit?: "cover"|"contain" (default "contain" — shows whole image) }
+- **Badge** { text: string, variant?: "default"|"secondary"|"outline"|"success"|"warning" }
+- **Stat** { label: string, value: string, hint?: string, tone?: "default"|"success"|"warning"|"danger" } — big number card.
+- **Rating** { score: number, count?: number } — star rating.
+- **GoldSupplier** { years: number } — Alibaba gold supplier badge.
+
+### Containers
+- **Card** { children } — elevated rounded container. Usually holds Image + CardBody.
+- **CardBody** { children } — padded flex-column inside a Card.
+
+### Interactive
+- **LinkOut** { href: string, label?: string } — external link button.
+- **Button** { label: string, send?: string, action?: string, actionPayload?: object, variant?: "default"|"primary"|"ghost" } — clicking either sends \`send\` as a new chat message OR fires a frontend \`action\` directly (no LLM roundtrip). If \`action\` is set it takes priority. Available actions:
+  - \`save_alternative\`: saves an Alibaba supplier to product_alternatives. actionPayload = { company_id (required), product_id?, supplier (required), title?, url?, thumbnail?, price?, moq?, review_score?, review_count?, gold_supplier_years?, country? }. Button shows "✓ <supplier> guardado como alternativa" on success.
+
+### Tabular
+- **Table** { columns: string[], rows: (string|number)[][] } — simple table.
+
+## Example (supplier results)
+
+{
+  "type": "Stack", "gap": 3, "children": [
+    { "type": "Text", "text": "5 proveedores encontrados", "muted": true },
+    { "type": "Grid", "cols": 2, "gap": 3, "children": [
+      {
+        "type": "Card", "children": [
+          { "type": "Image", "src": "https://...", "aspect": "video" },
+          { "type": "CardBody", "children": [
+            { "type": "Text", "text": "Albornoz spa algodon 100%" },
+            { "type": "Row", "gap": 2, "children": [
+              { "type": "Badge", "text": "USD 6.60-8.80", "variant": "success" },
+              { "type": "Badge", "text": "MOQ 50" }
+            ]},
+            { "type": "Row", "gap": 2, "children": [
+              { "type": "Rating", "score": 4.9, "count": 120 },
+              { "type": "GoldSupplier", "years": 9 }
+            ]},
+            { "type": "Text", "text": "Shanghai General Textile", "muted": true, "size": "xs" },
+            { "type": "Row", "gap": 1, "children": [
+              { "type": "LinkOut", "href": "https://alibaba.com/...", "label": "Ver" },
+              { "type": "Button", "label": "Guardar", "send": "Guarda Shanghai General Textile como referencia", "variant": "primary" }
+            ]}
+          ]}
+        ]
+      }
+    ]}
+  ]
+}
+
+## Rules
+- Keep specs compact. Don't duplicate text that's already in chat.
+- Use Grid cols:2 for 4-10 cards, cols:3 for 12+.
+- Always include a Button with a useful follow-up action per card when possible.
+- Unknown primitives render a placeholder — don't invent new types.`, {
+        spec: z
+            .any()
+            .describe('UI tree: { type, ...props, children? } or an array of such nodes.'),
+        title: z
+            .string()
+            .optional()
+            .describe('Widget title shown in the header. Keep it short (e.g. "Proveedores").'),
+    }, async ({ spec, title }) => {
+        // No-op. The value is in the tool_use event itself.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ rendered: true, title: title || 'Vista generada' }),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=ui.js.map

package/dist/core-mcp/src/tools/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../../core-mcp/src/tools/ui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,IAAI,CACT,WAAW,EACX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAuEgE,EAChE;QACE,IAAI,EAAE,CAAC;aACJ,GAAG,EAAE;aACL,QAAQ,CAAC,mEAAmE,CAAC;QAChF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,uEAAuE,CAAC;KACrF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxB,oDAAoD;QACpD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,gBAAgB,EAAE,CAAC;iBAC3E;aACF;SACF,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/core-mcp/src/workflow-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * buildWorkflowTools — generates MCP tools from a WorkflowDefinition.
+ *
+ * Emits 9 tools per workflow (names are configurable via `toolNames`):
+ *
+ *   get_item_state, list_items_by_phase, advance_step,
+ *   block_item, unblock_item, hold_item, resume_item, cancel_item,
+ *   request_human_approval
+ *
+ * Defaults keep the tool names stable so existing skills keep working. If an
+ * app has multiple workflows, set `toolNames` on each to avoid collisions.
+ */
+import { z } from 'zod';
+import type { WorkflowDefinition } from '../../core-shared/src/index.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolDefinition } from './define-tool.js';
+export declare function buildWorkflowTools(wf: WorkflowDefinition): (ToolDefinition<{
+    item_id: z.ZodString;
+}> | ToolDefinition<{
+    company_id: z.ZodString;
+    phase: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    include_cancelled: z.ZodDefault<z.ZodBoolean>;
+}> | ToolDefinition<{
+    item_id: z.ZodString;
+    to_phase: z.ZodEnum<[string, ...string[]]>;
+    to_step: z.ZodString;
+    actor: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}> | ToolDefinition<{
+    item_id: z.ZodString;
+    reason: z.ZodString;
+}> | ToolDefinition<{
+    item_id: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}> | ToolDefinition<{
+    item_id: z.ZodString;
+    packet: z.ZodRecord<z.ZodString, z.ZodAny>;
+}>)[];
+export declare function registerWorkflowTools(server: McpServer, wf: WorkflowDefinition): void;
+//# sourceMappingURL=workflow-tools.d.ts.map

package/dist/core-mcp/src/workflow-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../../../core-mcp/src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,gCAAgC,CAAA;AASvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAkEjF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;MAuTxD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAErF"}