agent-bundle 0.1.0

package/dist/mcp/connect-server.js

@@ -0,0 +1,170 @@
+import { Client } from "@modelcontextprotocol/sdk/client";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { SandboxStdioTransport } from "./sandbox-stdio-transport.js";
+const CLIENT_INFO = {
+    name: "agent-bundle",
+    version: "1.0.0",
+};
+function toErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toDescription(description) {
+    if (typeof description === "string" && description.trim().length > 0) {
+        return description;
+    }
+    return "MCP tool";
+}
+function normalizeInputSchema(schema) {
+    if (!isRecord(schema) || schema.type !== "object") {
+        return { type: "object" };
+    }
+    const normalizedSchema = {
+        ...schema,
+        type: "object",
+    };
+    const properties = isRecord(schema.properties) ? schema.properties : undefined;
+    if (properties) {
+        normalizedSchema.properties = properties;
+    }
+    else {
+        delete normalizedSchema.properties;
+    }
+    const required = Array.isArray(schema.required)
+        && schema.required.every((entry) => typeof entry === "string")
+        ? schema.required
+        : undefined;
+    if (required) {
+        normalizedSchema.required = required;
+    }
+    else {
+        delete normalizedSchema.required;
+    }
+    return normalizedSchema;
+}
+function extractTextContent(result) {
+    if ("toolResult" in result) {
+        return null;
+    }
+    const textBlocks = result.content
+        .flatMap((item) => (item.type === "text" ? [item.text] : []))
+        .map((text) => text.trim())
+        .filter((text) => text.length > 0);
+    if (textBlocks.length === 0) {
+        return null;
+    }
+    return textBlocks.join("\n\n");
+}
+function toToolOutput(result) {
+    if ("toolResult" in result) {
+        return result.toolResult;
+    }
+    const textOutput = extractTextContent(result);
+    if (textOutput !== null) {
+        return textOutput;
+    }
+    if (result.structuredContent) {
+        return result.structuredContent;
+    }
+    return result.content;
+}
+function isToolCallError(result) {
+    return !("toolResult" in result) && result.isError === true;
+}
+async function listAllTools(client, cursor) {
+    const page = await client.listTools(cursor ? { cursor } : undefined);
+    const next = page.nextCursor ? await listAllTools(client, page.nextCursor) : [];
+    return [...page.tools, ...next];
+}
+function createAuthHeaders(token) {
+    if (!token) {
+        return undefined;
+    }
+    return {
+        Authorization: `Bearer ${token}`,
+    };
+}
+function toCloseErrorMessage(results) {
+    const failures = results
+        .flatMap((result) => {
+        if (result.status === "fulfilled") {
+            return [];
+        }
+        return [toErrorMessage(result.reason)];
+    });
+    if (failures.length === 0) {
+        return null;
+    }
+    return failures.join(" | ");
+}
+async function createConnectionFromTransport(serverName, transport) {
+    const client = new Client(CLIENT_INFO, { capabilities: {} });
+    await client.connect(transport);
+    const tools = await listAllTools(client);
+    const discoveredTools = tools.map((tool) => ({
+        name: tool.name,
+        description: toDescription(tool.description),
+        inputSchema: normalizeInputSchema(tool.inputSchema),
+    }));
+    return {
+        serverName,
+        tools: discoveredTools,
+        callTool: async (toolName, input) => {
+            const result = await client.callTool({
+                name: toolName,
+                arguments: input,
+            });
+            return {
+                output: toToolOutput(result),
+                isError: isToolCallError(result),
+            };
+        },
+        close: async () => {
+            const closeResults = await Promise.allSettled([
+                client.close(),
+                transport.close(),
+            ]);
+            const closeErrorMessage = toCloseErrorMessage(closeResults);
+            if (closeErrorMessage) {
+                throw new Error(closeErrorMessage);
+            }
+        },
+    };
+}
+export function toServerLocation(server) {
+    if (server.transport === "stdio") {
+        return `${server.command} ${server.args?.join(" ") ?? ""}`.trim();
+    }
+    return server.url;
+}
+export async function defaultConnectServer(server, token, sandbox) {
+    if (server.transport === "http") {
+        const headers = createAuthHeaders(token);
+        const requestInit = headers ? { headers } : undefined;
+        const transport = new StreamableHTTPClientTransport(new URL(server.url), requestInit ? { requestInit } : undefined);
+        return await createConnectionFromTransport(server.name, transport);
+    }
+    if (server.transport === "stdio") {
+        if (!sandbox) {
+            throw new Error(`stdio MCP server "${server.name}" requires a sandbox`);
+        }
+        const transport = new SandboxStdioTransport({
+            sandbox,
+            command: server.command,
+            args: server.args,
+            env: server.env,
+        });
+        return await createConnectionFromTransport(server.name, transport);
+    }
+    const headers = server.auth === "bearer" ? createAuthHeaders(token) : undefined;
+    const requestInit = headers ? { headers } : undefined;
+    const transport = new SSEClientTransport(new URL(server.url), requestInit ? { requestInit } : undefined);
+    return await createConnectionFromTransport(server.name, transport);
+}
+//# sourceMappingURL=connect-server.js.map

package/dist/mcp/connect-server.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client-manager.js";
+export * from "./sandbox-stdio-transport.js";

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+export * from "./client-manager.js";
+export * from "./sandbox-stdio-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

package/dist/mcp/sandbox-stdio-transport.d.ts

@@ -0,0 +1,32 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import type { SandboxIO } from "../sandbox/types.js";
+export type SandboxStdioTransportOptions = {
+    sandbox: SandboxIO;
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+};
+export declare class SandboxStdioTransport implements Transport {
+    private readonly options;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    private readonly encoder;
+    private readonly decoder;
+    private process;
+    private stdinWriter;
+    private stdoutReaderTask;
+    private stderrReaderTask;
+    private isClosed;
+    private isClosing;
+    constructor(options: SandboxStdioTransportOptions);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+    private finalizeClose;
+    private watchExit;
+    private consumeStdout;
+    private consumeStderr;
+}

package/dist/mcp/sandbox-stdio-transport.js

@@ -0,0 +1,199 @@
+import { deserializeMessage, serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
+function toError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}
+function readLines(buffer) {
+    const lines = [];
+    let remaining = buffer;
+    for (;;) {
+        const newline = remaining.indexOf("\n");
+        if (newline < 0) {
+            break;
+        }
+        const line = remaining.slice(0, newline).replace(/\r$/, "");
+        remaining = remaining.slice(newline + 1);
+        if (line.length > 0) {
+            lines.push(line);
+        }
+    }
+    return { rest: remaining, lines };
+}
+function closeWriter(writer) {
+    if (writer === null) {
+        return;
+    }
+    try {
+        writer.releaseLock();
+    }
+    catch {
+        // Writer lock might already be released.
+    }
+}
+export class SandboxStdioTransport {
+    options;
+    onclose;
+    onerror;
+    onmessage;
+    encoder = new TextEncoder();
+    decoder = new TextDecoder();
+    process = null;
+    stdinWriter = null;
+    stdoutReaderTask = null;
+    stderrReaderTask = null;
+    isClosed = false;
+    isClosing = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async start() {
+        if (this.process !== null) {
+            throw new Error("SandboxStdioTransport already started.");
+        }
+        this.process = await this.options.sandbox.spawn(this.options.command, this.options.args ?? [], {
+            cwd: this.options.cwd,
+            env: this.options.env,
+        });
+        this.stdinWriter = this.process.stdin.getWriter();
+        this.stdoutReaderTask = this.consumeStdout(this.process.stdout);
+        this.stderrReaderTask = this.consumeStderr(this.process.stderr);
+        void this.watchExit(this.process);
+    }
+    async send(message) {
+        const writer = this.stdinWriter;
+        if (!writer) {
+            throw new Error("SandboxStdioTransport is not connected.");
+        }
+        const payload = this.encoder.encode(serializeMessage(message));
+        await writer.write(payload);
+    }
+    async close() {
+        if (this.isClosed || this.isClosing) {
+            return;
+        }
+        this.isClosing = true;
+        const process = this.process;
+        const writer = this.stdinWriter;
+        try {
+            if (writer) {
+                await writer.close();
+            }
+        }
+        catch {
+            // Process may already be closing.
+        }
+        finally {
+            closeWriter(writer);
+            this.stdinWriter = null;
+        }
+        try {
+            await process?.kill("SIGTERM");
+        }
+        catch {
+            // Best effort.
+        }
+        await Promise.allSettled([
+            process?.exited ?? Promise.resolve(0),
+            this.stdoutReaderTask ?? Promise.resolve(),
+            this.stderrReaderTask ?? Promise.resolve(),
+        ]);
+        this.finalizeClose();
+    }
+    finalizeClose() {
+        if (this.isClosed) {
+            return;
+        }
+        closeWriter(this.stdinWriter);
+        this.stdinWriter = null;
+        this.process = null;
+        this.isClosed = true;
+        this.onclose?.();
+    }
+    async watchExit(process) {
+        try {
+            const exitCode = await process.exited;
+            if (exitCode !== 0 && !this.isClosing) {
+                this.onerror?.(new Error(`MCP stdio process exited with code ${exitCode}.`));
+            }
+        }
+        catch (error) {
+            if (!this.isClosing) {
+                this.onerror?.(toError(error));
+            }
+        }
+        finally {
+            this.finalizeClose();
+        }
+    }
+    async consumeStdout(stream) {
+        const reader = stream.getReader();
+        let buffer = "";
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                buffer += this.decoder.decode(value, { stream: true });
+                const parsed = readLines(buffer);
+                buffer = parsed.rest;
+                parsed.lines.forEach((line) => {
+                    try {
+                        this.onmessage?.(deserializeMessage(line));
+                    }
+                    catch (error) {
+                        this.onerror?.(toError(error));
+                    }
+                });
+            }
+            buffer += this.decoder.decode();
+            if (buffer.trim().length > 0) {
+                try {
+                    this.onmessage?.(deserializeMessage(buffer.trim()));
+                }
+                catch (error) {
+                    this.onerror?.(toError(error));
+                }
+            }
+        }
+        catch (error) {
+            if (!this.isClosing) {
+                this.onerror?.(toError(error));
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async consumeStderr(stream) {
+        const reader = stream.getReader();
+        const decoder = new TextDecoder();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                const text = decoder.decode(value, { stream: true }).trim();
+                if (text.length > 0) {
+                    this.onerror?.(new Error(`MCP stdio stderr: ${text}`));
+                }
+            }
+            const trailing = decoder.decode().trim();
+            if (trailing.length > 0) {
+                this.onerror?.(new Error(`MCP stdio stderr: ${trailing}`));
+            }
+        }
+        catch (error) {
+            if (!this.isClosing) {
+                this.onerror?.(toError(error));
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=sandbox-stdio-transport.js.map

package/dist/mcp/sandbox-stdio-transport.js.map

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

package/dist/observability/hooks.d.ts

@@ -0,0 +1,10 @@
+import type { ToolCall, ToolResult, TokenUsage } from "../agent-loop/types.js";
+import { type ObservabilityProvider } from "./types.js";
+export type AgentObservabilityHooks = {
+    onRespondStart: () => number;
+    onRespondEnd: (startMs: number, error?: unknown) => void;
+    onTokenUsage: (usage: TokenUsage) => void;
+};
+export declare function createAgentHooks(provider: ObservabilityProvider, agentName?: string): AgentObservabilityHooks;
+export declare function createToolCallInstrumenter(provider: ObservabilityProvider): (call: ToolCall, execute: (call: ToolCall) => Promise<ToolResult>) => Promise<ToolResult>;
+export declare function createMcpCallInstrumenter(provider: ObservabilityProvider): (serverName: string, toolName: string, execute: () => Promise<ToolResult>) => Promise<ToolResult>;

package/dist/observability/hooks.js

@@ -0,0 +1,97 @@
+import { createAgentMetrics, createGenAiMetrics, createMcpMetrics, createToolMetrics, } from "./metrics.js";
+import { elapsed, now, withSpan } from "./tracing.js";
+import { AgentAttributes, McpAttributes, } from "./types.js";
+export function createAgentHooks(provider, agentName) {
+    const agentMetrics = createAgentMetrics(provider.meter);
+    const genAiMetrics = createGenAiMetrics(provider.meter);
+    const baseAttrs = agentName ? { [AgentAttributes.AGENT_NAME]: agentName } : {};
+    return {
+        onRespondStart() {
+            agentMetrics.respondActive.add(1, baseAttrs);
+            return now();
+        },
+        onRespondEnd(startMs, error) {
+            const errorFlag = error !== undefined && error !== null;
+            agentMetrics.respondActive.add(-1, baseAttrs);
+            agentMetrics.respondDuration.record(elapsed(startMs), {
+                ...baseAttrs,
+                [AgentAttributes.AGENT_STATUS]: errorFlag ? "error" : "ok",
+            });
+        },
+        onTokenUsage(usage) {
+            genAiMetrics.inputTokens.add(usage.inputTokens, baseAttrs);
+            genAiMetrics.outputTokens.add(usage.outputTokens, baseAttrs);
+        },
+    };
+}
+/* ------------------------------------------------------------------ */
+/*  Tool call instrumentation                                          */
+/* ------------------------------------------------------------------ */
+export function createToolCallInstrumenter(provider) {
+    const toolMetrics = createToolMetrics(provider.meter);
+    return async function instrumentToolCall(call, execute) {
+        const startMs = now();
+        let threw = false;
+        try {
+            const result = await withSpan(provider.tracer, `tool ${call.name}`, { [AgentAttributes.TOOL_NAME]: call.name }, async () => execute(call));
+            if (result.isError) {
+                toolMetrics.callErrors.add(1, {
+                    [AgentAttributes.TOOL_NAME]: call.name,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            threw = true;
+            toolMetrics.callErrors.add(1, {
+                [AgentAttributes.TOOL_NAME]: call.name,
+            });
+            throw error;
+        }
+        finally {
+            toolMetrics.callDuration.record(elapsed(startMs), {
+                [AgentAttributes.TOOL_NAME]: call.name,
+                [AgentAttributes.TOOL_ERROR]: String(threw),
+            });
+        }
+    };
+}
+/* ------------------------------------------------------------------ */
+/*  MCP call instrumentation                                           */
+/* ------------------------------------------------------------------ */
+export function createMcpCallInstrumenter(provider) {
+    const mcpMetrics = createMcpMetrics(provider.meter);
+    return async function instrumentMcpCall(serverName, toolName, execute) {
+        const startMs = now();
+        let threw = false;
+        try {
+            const result = await withSpan(provider.tracer, `mcp ${serverName}/${toolName}`, {
+                [McpAttributes.SERVER_NAME]: serverName,
+                [McpAttributes.TOOL_NAME]: toolName,
+            }, async () => execute());
+            if (result.isError) {
+                mcpMetrics.callErrors.add(1, {
+                    [McpAttributes.SERVER_NAME]: serverName,
+                    [McpAttributes.TOOL_NAME]: toolName,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            threw = true;
+            mcpMetrics.callErrors.add(1, {
+                [McpAttributes.SERVER_NAME]: serverName,
+                [McpAttributes.TOOL_NAME]: toolName,
+            });
+            throw error;
+        }
+        finally {
+            mcpMetrics.callDuration.record(elapsed(startMs), {
+                [McpAttributes.SERVER_NAME]: serverName,
+                [McpAttributes.TOOL_NAME]: toolName,
+                [McpAttributes.TOOL_ERROR]: String(threw),
+            });
+        }
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/observability/hooks.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./provider.js";
+export * from "./metrics.js";
+export * from "./tracing.js";
+export * from "./middleware.js";
+export * from "./hooks.js";

package/dist/observability/index.js

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export * from "./provider.js";
+export * from "./metrics.js";
+export * from "./tracing.js";
+export * from "./middleware.js";
+export * from "./hooks.js";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,31 @@
+import type { Counter, Histogram, Meter, UpDownCounter } from "@opentelemetry/api";
+/** Lazily-created instruments for the HTTP server layer. */
+export type HttpMetrics = {
+    requestDuration: Histogram;
+    activeRequests: UpDownCounter;
+};
+/** Lazily-created instruments for agent lifecycle. */
+export type AgentMetrics = {
+    respondDuration: Histogram;
+    respondActive: UpDownCounter;
+};
+/** Lazily-created instruments for tool calls. */
+export type ToolMetrics = {
+    callDuration: Histogram;
+    callErrors: Counter;
+};
+/** Lazily-created instruments for GenAI token usage. */
+export type GenAiMetrics = {
+    inputTokens: Counter;
+    outputTokens: Counter;
+};
+/** Lazily-created instruments for MCP tool calls. */
+export type McpMetrics = {
+    callDuration: Histogram;
+    callErrors: Counter;
+};
+export declare function createHttpMetrics(meter: Meter): HttpMetrics;
+export declare function createAgentMetrics(meter: Meter): AgentMetrics;
+export declare function createToolMetrics(meter: Meter): ToolMetrics;
+export declare function createGenAiMetrics(meter: Meter): GenAiMetrics;
+export declare function createMcpMetrics(meter: Meter): McpMetrics;

package/dist/observability/metrics.js

@@ -0,0 +1,61 @@
+export function createHttpMetrics(meter) {
+    return {
+        requestDuration: meter.createHistogram("http.server.request.duration", {
+            description: "HTTP request latency",
+            unit: "ms",
+        }),
+        activeRequests: meter.createUpDownCounter("http.server.active_requests", {
+            description: "Number of in-flight HTTP requests",
+            unit: "{request}",
+        }),
+    };
+}
+export function createAgentMetrics(meter) {
+    return {
+        respondDuration: meter.createHistogram("agent.respond.duration", {
+            description: "End-to-end agent respond time",
+            unit: "ms",
+        }),
+        respondActive: meter.createUpDownCounter("agent.respond.active", {
+            description: "Number of active respond calls",
+            unit: "{request}",
+        }),
+    };
+}
+export function createToolMetrics(meter) {
+    return {
+        callDuration: meter.createHistogram("agent.tool_call.duration", {
+            description: "Tool call execution time",
+            unit: "ms",
+        }),
+        callErrors: meter.createCounter("agent.tool_call.errors", {
+            description: "Number of failed tool calls",
+            unit: "{error}",
+        }),
+    };
+}
+export function createGenAiMetrics(meter) {
+    return {
+        inputTokens: meter.createCounter("gen_ai.usage.input_tokens", {
+            description: "Input tokens consumed",
+            unit: "{token}",
+        }),
+        outputTokens: meter.createCounter("gen_ai.usage.output_tokens", {
+            description: "Output tokens consumed",
+            unit: "{token}",
+        }),
+    };
+}
+export function createMcpMetrics(meter) {
+    return {
+        callDuration: meter.createHistogram("mcp.tool_call.duration", {
+            description: "MCP tool call latency",
+            unit: "ms",
+        }),
+        callErrors: meter.createCounter("mcp.tool_call.errors", {
+            description: "Number of failed MCP tool calls",
+            unit: "{error}",
+        }),
+    };
+}
+//# sourceMappingURL=metrics.js.map