@multiplayer-app/agent 0.0.1

package/dist/mcp/mcp-tool-schema.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_AUTH_EXPIRED = exports.CALL_RESULT_MAX_BYTES = exports.INPUT_SCHEMA_MAX_BYTES = exports.TOOL_DESCRIPTION_MAX = exports.TOOL_NAME_MAX = exports.MAX_TOOLS = void 0;
+exports.sanitizeInputSchema = sanitizeInputSchema;
+exports.sanitizeDiscoveredTools = sanitizeDiscoveredTools;
+exports.mergeTools = mergeTools;
+exports.mcpErrorMessage = mcpErrorMessage;
+exports.shapeCallToolResult = shapeCallToolResult;
+exports.MAX_TOOLS = 200;
+exports.TOOL_NAME_MAX = 200;
+exports.TOOL_DESCRIPTION_MAX = 500;
+exports.INPUT_SCHEMA_MAX_BYTES = 8 * 1024;
+exports.CALL_RESULT_MAX_BYTES = 32 * 1024;
+exports.MCP_AUTH_EXPIRED = 'MCP server authentication expired. Re-authenticate this connection.';
+function sanitizeInputSchema(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return undefined;
+    try {
+        const serialized = JSON.stringify(schema);
+        if (!serialized || serialized.length > exports.INPUT_SCHEMA_MAX_BYTES)
+            return undefined;
+        return JSON.parse(serialized);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+function sanitizeDiscoveredTools(tools) {
+    const seen = new Set();
+    const result = [];
+    for (const tool of tools) {
+        const name = tool.name.trim().slice(0, exports.TOOL_NAME_MAX);
+        if (!name || seen.has(name))
+            continue;
+        seen.add(name);
+        const description = (tool.description || tool.title || '').trim().slice(0, exports.TOOL_DESCRIPTION_MAX);
+        result.push({
+            name,
+            description: description || undefined,
+            enabled: true,
+            inputSchema: sanitizeInputSchema(tool.inputSchema),
+        });
+        if (result.length >= exports.MAX_TOOLS)
+            break;
+    }
+    return result;
+}
+function mergeTools(existing, discovered) {
+    const previous = new Map((existing !== null && existing !== void 0 ? existing : []).map((tool) => [tool.name, tool]));
+    return discovered.map((tool) => {
+        var _a, _b;
+        return ({
+            ...tool,
+            enabled: (_b = (_a = previous.get(tool.name)) === null || _a === void 0 ? void 0 : _a.enabled) !== null && _b !== void 0 ? _b : true,
+        });
+    });
+}
+function mcpErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.startsWith('Unauthorized') ||
+        message.includes('authentication expired') ||
+        message.includes(exports.MCP_AUTH_EXPIRED)) {
+        return exports.MCP_AUTH_EXPIRED;
+    }
+    return message;
+}
+function shapeCallToolResult(result) {
+    const parts = [];
+    const content = Array.isArray(result.content) ? result.content : [];
+    for (const part of content) {
+        if (!part || typeof part !== 'object')
+            continue;
+        const item = part;
+        if (item.type === 'text' && typeof item.text === 'string') {
+            parts.push(item.text);
+            continue;
+        }
+        if (item.type === 'image' || item.type === 'audio' || item.type === 'resource' || item.type === 'resource_link') {
+            parts.push('[binary omitted]');
+        }
+    }
+    let text = parts.join('\n');
+    if (!text && result.structuredContent !== undefined) {
+        try {
+            text = JSON.stringify(result.structuredContent);
+        }
+        catch (_a) {
+            text = '';
+        }
+    }
+    if (text.length > exports.CALL_RESULT_MAX_BYTES) {
+        text = `${text.slice(0, exports.CALL_RESULT_MAX_BYTES)}…[truncated]`;
+    }
+    return { isError: Boolean(result.isError), content: text };
+}
+//# sourceMappingURL=mcp-tool-schema.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { McpConnectionRecord } from './mcp-connection';
+/** Builds the three MCP-access tools scoped to this run's connection list (from MCP_SERVERS_JSON). */
+export declare function createMcpTools(connections: McpConnectionRecord[]): {
+    search_tools: import("ai").Tool<{
+        query?: string | undefined;
+        server?: string | undefined;
+        detail?: "names" | "names_and_descriptions" | undefined;
+        limit?: number | undefined;
+    }, import("./search-mcp-tools").McpToolSearchResult>;
+    get_tool_details: import("ai").Tool<{
+        name: string;
+        mcpConnectionId?: string | undefined;
+        server?: string | undefined;
+    }, {
+        isError: boolean;
+        message: string;
+        server?: undefined;
+        name?: undefined;
+        description?: undefined;
+        inputSchema?: undefined;
+    } | {
+        isError: boolean;
+        server: {
+            mcpConnectionId: string;
+            name: string;
+        };
+        name: string;
+        description: string | undefined;
+        inputSchema: Record<string, unknown>;
+        message?: undefined;
+    }>;
+    call_mcp_tool: import("ai").Tool<{
+        name: string;
+        mcpConnectionId?: string | undefined;
+        server?: string | undefined;
+        arguments?: Record<string, unknown> | undefined;
+    }, {
+        isError: boolean;
+        message: string;
+        server?: undefined;
+        name?: undefined;
+        content?: undefined;
+    } | {
+        isError: boolean;
+        server: {
+            mcpConnectionId: string;
+            name: string;
+        };
+        name: string;
+        content: string;
+        message: string | undefined;
+    }>;
+};
+//# sourceMappingURL=mcp-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AA4B3D,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,WAAW,EAAE,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8EhE"}

package/dist/mcp/mcp-tools.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpTools = createMcpTools;
+// The three-tool MCP indirection pattern from
+// libs/builder-api/src/agents/automation/automation.tools.ts (search_tools -> get_tool_details
+// -> call_mcp_tool), adapted to resolve against an in-memory connection list instead of a
+// database-backed "attached to this automation" lookup — the env var already hands us the
+// full resolved connection list, so there's nothing to look up.
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const mcp_client_1 = require("./mcp-client");
+const mcp_tool_schema_1 = require("./mcp-tool-schema");
+const search_mcp_tools_1 = require("./search-mcp-tools");
+function findConnection(connections, toolName, hint) {
+    var _a;
+    const candidates = connections.filter((connection) => {
+        if (hint.mcpConnectionId)
+            return connection.mcpConnectionId === hint.mcpConnectionId;
+        if (hint.server) {
+            const needle = hint.server.trim().toLowerCase();
+            if (connection.mcpConnectionId.toLowerCase() !== needle && !connection.name.toLowerCase().includes(needle)) {
+                return false;
+            }
+        }
+        return connection.enabled && connection.transport === 'remote';
+    });
+    return (_a = candidates.find((connection) => connection.tools.some((t) => t.name === toolName && t.enabled))) !== null && _a !== void 0 ? _a : candidates[0];
+}
+const mcpToolSelectSchema = zod_1.z.object({
+    name: zod_1.z.string().trim().min(1).max(200).describe('Exact MCP tool name from search_tools.'),
+    mcpConnectionId: zod_1.z.string().trim().max(24).optional().describe('MCP connection id from search_tools.server.mcpConnectionId.'),
+    server: zod_1.z.string().trim().max(100).optional().describe('MCP connection name when it uniquely identifies the server.'),
+});
+/** Builds the three MCP-access tools scoped to this run's connection list (from MCP_SERVERS_JSON). */
+function createMcpTools(connections) {
+    const searchToolsTool = (0, ai_1.tool)({
+        description: [
+            'Search MCP tools available in this session.',
+            'Returns matching tool names and brief descriptions grouped by server.',
+            'MCP tools are not in your tool list — search first, then get_tool_details, then call_mcp_tool.',
+        ].join(' '),
+        inputSchema: zod_1.z.object({
+            query: zod_1.z.string().max(200).optional().describe('Natural-language search. Omit to list servers and tool counts only.'),
+            server: zod_1.z.string().max(100).optional().describe('Optional filter: MCP connection name substring or mcpConnectionId.'),
+            detail: zod_1.z.enum(['names', 'names_and_descriptions']).optional(),
+            limit: zod_1.z.number().int().min(1).max(25).optional(),
+        }),
+        execute: async (input) => {
+            var _a;
+            if (connections.length === 0)
+                return { total: 0, matches: [], message: 'No MCP connections configured for this session.' };
+            const result = (0, search_mcp_tools_1.searchMcpTools)(connections, input);
+            if (result.total === 0 && result.matches.length === 0 && !((_a = result.servers) === null || _a === void 0 ? void 0 : _a.length)) {
+                return { ...result, message: 'No matching MCP tools. Try a broader query, or omit query to list servers.' };
+            }
+            return result;
+        },
+    });
+    const getToolDetailsTool = (0, ai_1.tool)({
+        description: 'Get the input JSON Schema for one MCP tool available in this session. Call this for the tool you will invoke, after search_tools.',
+        inputSchema: mcpToolSelectSchema,
+        execute: async (input) => {
+            var _a;
+            const connection = findConnection(connections, input.name, input);
+            if (!connection)
+                return { isError: true, message: `No MCP connection has a tool named "${input.name}".` };
+            try {
+                let match = connection.tools.find((t) => t.name === input.name);
+                if (!(match === null || match === void 0 ? void 0 : match.inputSchema)) {
+                    const discovered = await (0, mcp_client_1.listRemoteTools)(connection);
+                    connection.tools = (0, mcp_tool_schema_1.mergeTools)(connection.tools, discovered);
+                    match = (_a = discovered.find((t) => t.name === input.name)) !== null && _a !== void 0 ? _a : match;
+                }
+                if (!(match === null || match === void 0 ? void 0 : match.inputSchema)) {
+                    return { isError: true, message: `No input schema available for "${input.name}". Try again.` };
+                }
+                return {
+                    isError: false,
+                    server: { mcpConnectionId: connection.mcpConnectionId, name: connection.name },
+                    name: match.name,
+                    description: match.description,
+                    inputSchema: match.inputSchema,
+                };
+            }
+            catch (error) {
+                return { isError: true, message: (0, mcp_tool_schema_1.mcpErrorMessage)(error) };
+            }
+        },
+    });
+    const callMcpToolTool = (0, ai_1.tool)({
+        description: [
+            'Call one MCP tool available in this session.',
+            'Pass the exact name and server from search_tools, and arguments matching get_tool_details.',
+            'Only claim the action succeeded when isError is false.',
+        ].join(' '),
+        inputSchema: mcpToolSelectSchema.extend({
+            arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('Arguments matching the tool inputSchema from get_tool_details.'),
+        }),
+        execute: async (input) => {
+            const connection = findConnection(connections, input.name, input);
+            if (!connection)
+                return { isError: true, message: `No MCP connection has a tool named "${input.name}".` };
+            const result = await (0, mcp_client_1.callRemoteTool)(connection, input.name, input.arguments);
+            return {
+                isError: result.isError,
+                server: { mcpConnectionId: connection.mcpConnectionId, name: connection.name },
+                name: input.name,
+                content: result.content,
+                message: result.isError ? result.content : undefined,
+            };
+        },
+    });
+    return { search_tools: searchToolsTool, get_tool_details: getToolDetailsTool, call_mcp_tool: callMcpToolTool };
+}
+//# sourceMappingURL=mcp-tools.js.map

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

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

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

@@ -0,0 +1,33 @@
+import type { McpConnectionSummary } from './mcp-connection';
+export type McpToolSearchDetail = 'names' | 'names_and_descriptions';
+export interface McpToolSearchInput {
+    query?: string;
+    server?: string;
+    detail?: McpToolSearchDetail;
+    limit?: number;
+}
+export interface McpToolSearchMatch {
+    server: {
+        mcpConnectionId: string;
+        name: string;
+    };
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+export interface McpToolSearchServerSummary {
+    mcpConnectionId: string;
+    name: string;
+    toolCount: number;
+}
+export interface McpToolSearchResult {
+    total: number;
+    matches: McpToolSearchMatch[];
+    servers?: McpToolSearchServerSummary[];
+    message?: string;
+}
+export declare function tokenize(text: string): string[];
+export declare function listSearchableServers(connections: McpConnectionSummary[]): McpToolSearchServerSummary[];
+export declare function searchMcpTools(connections: McpConnectionSummary[], input?: McpToolSearchInput): McpToolSearchResult;
+//# sourceMappingURL=search-mcp-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-mcp-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/search-mcp-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,kBAAkB,CAAA;AAE5E,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,wBAAwB,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACjD,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAA;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAYD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAa/C;AAOD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,0BAA0B,EAAE,CAMvG;AA0FD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,oBAAoB,EAAE,EACnC,KAAK,GAAE,kBAAuB,GAC7B,mBAAmB,CA6BrB"}

package/dist/mcp/search-mcp-tools.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenize = tokenize;
+exports.listSearchableServers = listSearchableServers;
+exports.searchMcpTools = searchMcpTools;
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 25;
+function tokenize(text) {
+    const split = text
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .toLowerCase();
+    const seen = new Set();
+    const tokens = [];
+    for (const token of split.split(/[^a-z0-9]+/)) {
+        if (token.length < 2 || seen.has(token))
+            continue;
+        seen.add(token);
+        tokens.push(token);
+    }
+    return tokens;
+}
+function enabledRemoteTools(connection) {
+    var _a;
+    if (!connection.enabled || connection.transport !== 'remote')
+        return [];
+    return ((_a = connection.tools) !== null && _a !== void 0 ? _a : []).filter((tool) => tool.enabled && tool.name.trim().length > 0);
+}
+function listSearchableServers(connections) {
+    return connections.flatMap((connection) => {
+        const tools = enabledRemoteTools(connection);
+        if (tools.length === 0)
+            return [];
+        return [{ mcpConnectionId: connection.mcpConnectionId, name: connection.name, toolCount: tools.length }];
+    });
+}
+function matchesServerFilter(connection, server) {
+    if (!server)
+        return true;
+    const needle = server.trim().toLowerCase();
+    if (!needle)
+        return true;
+    if (connection.mcpConnectionId.toLowerCase() === needle)
+        return true;
+    return connection.name.toLowerCase().includes(needle);
+}
+function catalogTools(connections, server) {
+    const tools = [];
+    for (const connection of connections) {
+        if (!matchesServerFilter(connection, server))
+            continue;
+        for (const tool of enabledRemoteTools(connection)) {
+            tools.push({
+                mcpConnectionId: connection.mcpConnectionId,
+                serverName: connection.name,
+                name: tool.name,
+                description: tool.description,
+            });
+        }
+    }
+    return tools;
+}
+function tokenScore(token, nameTokens, nameHaystack, serverTokens, serverHaystack, descriptionHaystack) {
+    if (nameTokens.includes(token))
+        return 10;
+    if (nameTokens.some((nameToken) => nameToken.startsWith(token) || nameToken.includes(token)) || nameHaystack.includes(token)) {
+        return 6;
+    }
+    if (serverTokens.includes(token) || serverHaystack.includes(token))
+        return 4;
+    if (descriptionHaystack.includes(token))
+        return 2;
+    return 0;
+}
+function scoreTool(tool, queryTokens) {
+    var _a;
+    const nameTokens = tokenize(tool.name);
+    const nameHaystack = tool.name.toLowerCase();
+    const serverTokens = tokenize(tool.serverName);
+    const serverHaystack = tool.serverName.toLowerCase();
+    const descriptionHaystack = ((_a = tool.description) !== null && _a !== void 0 ? _a : '').toLowerCase();
+    let score = 0;
+    let hits = 0;
+    for (const token of queryTokens) {
+        const points = tokenScore(token, nameTokens, nameHaystack, serverTokens, serverHaystack, descriptionHaystack);
+        if (points > 0)
+            hits += 1;
+        score += points;
+    }
+    if (hits === queryTokens.length)
+        score += 5;
+    return score;
+}
+function clampLimit(limit) {
+    if (limit === undefined)
+        return DEFAULT_LIMIT;
+    return Math.min(MAX_LIMIT, Math.max(1, Math.floor(limit)));
+}
+function toMatchTool(tool, detail) {
+    if (detail === 'names')
+        return { name: tool.name };
+    return { name: tool.name, description: tool.description };
+}
+function groupMatches(tools, detail) {
+    const matches = [];
+    const indexByServer = new Map();
+    for (const tool of tools) {
+        const existing = indexByServer.get(tool.mcpConnectionId);
+        const mapped = toMatchTool(tool, detail);
+        if (existing === undefined) {
+            indexByServer.set(tool.mcpConnectionId, matches.length);
+            matches.push({
+                server: { mcpConnectionId: tool.mcpConnectionId, name: tool.serverName },
+                tools: [mapped],
+            });
+            continue;
+        }
+        matches[existing].tools.push(mapped);
+    }
+    return matches;
+}
+function searchMcpTools(connections, input = {}) {
+    var _a, _b;
+    const detail = input.detail === 'names' ? 'names' : 'names_and_descriptions';
+    const limit = clampLimit(input.limit);
+    const query = (_b = (_a = input.query) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : '';
+    const filteredConnections = connections.filter((connection) => matchesServerFilter(connection, input.server));
+    const servers = listSearchableServers(filteredConnections);
+    if (!query) {
+        const total = servers.reduce((sum, server) => sum + server.toolCount, 0);
+        return { total, matches: [], servers };
+    }
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0) {
+        const total = servers.reduce((sum, server) => sum + server.toolCount, 0);
+        return { total, matches: [], servers };
+    }
+    const ranked = catalogTools(connections, input.server)
+        .map((tool) => ({ tool, score: scoreTool(tool, queryTokens) }))
+        .filter((entry) => entry.score > 0)
+        .sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name))
+        .slice(0, limit)
+        .map((entry) => entry.tool);
+    return {
+        total: ranked.length,
+        matches: groupMatches(ranked, detail),
+    };
+}
+//# sourceMappingURL=search-mcp-tools.js.map

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

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

package/dist/report.d.ts

@@ -0,0 +1,30 @@
+export type AgentEvent = {
+    type: 'tool_call';
+    sessionId: string;
+    toolName: string;
+    input: unknown;
+    output: unknown;
+    timestamp: string;
+} | {
+    type: 'message';
+    sessionId: string;
+    text: string;
+    timestamp: string;
+} | {
+    type: 'done';
+    sessionId: string;
+    summary: string;
+    timestamp: string;
+} | {
+    type: 'error';
+    sessionId: string;
+    message: string;
+    timestamp: string;
+};
+export interface Reporter {
+    send(event: AgentEvent): Promise<void>;
+    /** Call once after the run finishes (success or failure) so the last event can flush. */
+    close(): Promise<void>;
+}
+export declare function createReporter(socketUrl: string | undefined, socketToken: string | undefined, sessionId: string): Reporter;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9G;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,yFAAyF;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AASD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAChB,QAAQ,CA8BV"}

package/dist/report.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReporter = createReporter;
+// Reports progress back to the chat UI over a Socket.IO connection to the gateway's
+// agent-socket-server (services/gateway/src/services/agent-socket-server.ts) — not a direct
+// HTTP call to the api. The gateway relays each event onward (io.serverSideEmit over the
+// shared Redis adapter); the api persists it and pushes it live into the chat's socket room.
+// A failed/unavailable connection never fails the run — the agent's actual work (files/
+// commands) already happened; losing a progress update is a lesser problem than aborting a
+// task over a flaky socket.
+const socket_io_client_1 = require("socket.io-client");
+const AGENT_SESSION_EVENT = 'agent-session:event';
+// Grace period before disconnecting in close(), so the last emit (the 'done'/'error' event)
+// actually reaches the gateway before the process exits — socket.io buffers emits made before
+// 'connect' fires, but a bare process.exit() right after send() resolves can still race the
+// underlying write.
+const CLOSE_GRACE_MS = 200;
+const noopReporter = {
+    async send(event) {
+        console.log('[report]', JSON.stringify(event));
+    },
+    async close() { },
+};
+function createReporter(socketUrl, socketToken, sessionId) {
+    if (!socketUrl)
+        return noopReporter;
+    let socket;
+    let connected;
+    function ensureConnected() {
+        if (connected)
+            return connected;
+        socket = (0, socket_io_client_1.io)(socketUrl, { auth: { sessionId, token: socketToken } });
+        connected = new Promise((resolve) => {
+            socket === null || socket === void 0 ? void 0 : socket.once('connect', () => resolve());
+            socket === null || socket === void 0 ? void 0 : socket.once('connect_error', (error) => {
+                console.error('[report] socket connect failed:', error.message);
+                resolve(); // don't block the run — the emit below will just have nowhere to go
+            });
+        });
+        return connected;
+    }
+    return {
+        async send(event) {
+            await ensureConnected();
+            socket === null || socket === void 0 ? void 0 : socket.emit(AGENT_SESSION_EVENT, event);
+        },
+        async close() {
+            if (!socket)
+                return;
+            await new Promise((resolve) => setTimeout(resolve, CLOSE_GRACE_MS));
+            socket.disconnect();
+        },
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":";;AAmCA,wCAkCC;AArED,oFAAoF;AACpF,4FAA4F;AAC5F,yFAAyF;AACzF,6FAA6F;AAC7F,wFAAwF;AACxF,2FAA2F;AAC3F,4BAA4B;AAC5B,uDAA8D;AAE9D,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AACjD,4FAA4F;AAC5F,8FAA8F;AAC9F,4FAA4F;AAC5F,oBAAoB;AACpB,MAAM,cAAc,GAAG,GAAG,CAAA;AAc1B,MAAM,YAAY,GAAa;IAC7B,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAChD,CAAC;IACD,KAAK,CAAC,KAAK,KAAI,CAAC;CACjB,CAAA;AAED,SAAgB,cAAc,CAC5B,SAA6B,EAC7B,WAA+B,EAC/B,SAAiB;IAEjB,IAAI,CAAC,SAAS;QAAE,OAAO,YAAY,CAAA;IAEnC,IAAI,MAA0B,CAAA;IAC9B,IAAI,SAAoC,CAAA;IAExC,SAAS,eAAe;QACtB,IAAI,SAAS;YAAE,OAAO,SAAS,CAAA;QAC/B,MAAM,GAAG,IAAA,qBAAQ,EAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QACzE,SAAS,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YACxC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,eAAe,EAAE,CAAC,KAAY,EAAE,EAAE;gBAC7C,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;gBAC/D,OAAO,EAAE,CAAA,CAAC,oEAAoE;YAChF,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAK;YACd,MAAM,eAAe,EAAE,CAAA;YACvB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;QAC1C,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;YACnE,MAAM,CAAC,UAAU,EAAE,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/tools/exec-tools.d.ts

@@ -0,0 +1,8 @@
+export declare function createExecTools(workspaceDir: string): {
+    run_command: import("ai").Tool<{
+        command: string;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    }, unknown>;
+};
+//# sourceMappingURL=exec-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec-tools.d.ts","sourceRoot":"","sources":["../../src/tools/exec-tools.ts"],"names":[],"mappings":"AAeA,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM;;;;;;EAqCnD"}

package/dist/tools/exec-tools.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExecTools = createExecTools;
+// Local equivalent of app-vm.tools.ts's runAppCommandTool — a direct child_process.exec
+// against the workspace, no RPC/session bridge (the agent already runs inside the VM).
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const MAX_OUTPUT_BYTES = 1024 * 1024;
+const DEFAULT_TIMEOUT_MS = 60000;
+function truncate(text) {
+    if (Buffer.byteLength(text, 'utf8') <= MAX_OUTPUT_BYTES)
+        return { text, truncated: false };
+    return { text: `${text.slice(0, MAX_OUTPUT_BYTES)}…[truncated]`, truncated: true };
+}
+function createExecTools(workspaceDir) {
+    const runCommandTool = (0, ai_1.tool)({
+        description: "Run a shell command inside the session's workspace (npm install, build steps, starting a dev server). Returns exit code and captured output. For a long-lived process (a dev server), background it (e.g. `nohup npm run dev &`) so this call returns promptly — the live preview picks it up once it's listening on $PORT.",
+        inputSchema: zod_1.z.object({
+            command: zod_1.z.string().min(1).max(4000).describe('Shell command run in the workspace root (or cwd)'),
+            cwd: zod_1.z.string().max(500).optional().describe('Workspace-relative working directory'),
+            timeoutMs: zod_1.z.number().int().positive().max(300000).optional().describe('Wall-clock limit, default 60000'),
+        }),
+        execute: async (input) => {
+            const cwd = input.cwd ? path_1.default.resolve(workspaceDir, input.cwd) : workspaceDir;
+            const startedAt = Date.now();
+            return new Promise((resolve) => {
+                var _a;
+                const child = (0, child_process_1.exec)(input.command, { cwd, timeout: (_a = input.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MS, maxBuffer: MAX_OUTPUT_BYTES * 2 }, (error, stdout, stderr) => {
+                    const durationMs = Date.now() - startedAt;
+                    const timedOut = Boolean((error === null || error === void 0 ? void 0 : error.killed) && error.signal === 'SIGTERM');
+                    const out = truncate(stdout);
+                    const err = truncate(stderr);
+                    resolve({
+                        exitCode: error && typeof error.code === 'number' ? error.code : error ? 1 : 0,
+                        stdout: out.text,
+                        stderr: err.text,
+                        durationMs,
+                        truncated: out.truncated || err.truncated,
+                        timedOut,
+                    });
+                });
+                void child;
+            });
+        },
+    });
+    return { run_command: runCommandTool };
+}
+//# sourceMappingURL=exec-tools.js.map