agent-bundle 0.1.0

package/dist/agent/agent.test-helpers.js

@@ -0,0 +1,170 @@
+import { AgentImpl } from "./agent.js";
+export class FakeLoop {
+    initConfigs = [];
+    runInputs = [];
+    disposeCount = 0;
+    initError = null;
+    queuedRuns = [];
+    setInitError(error) {
+        this.initError = error;
+    }
+    enqueueRun(events) {
+        this.queuedRuns.push(events);
+    }
+    async init(config) {
+        if (this.initError) {
+            throw this.initError;
+        }
+        this.initConfigs.push(config);
+    }
+    async *run(input, options) {
+        void options;
+        this.runInputs.push(input);
+        const events = this.queuedRuns.shift() ?? [];
+        for (const event of events) {
+            yield event;
+        }
+    }
+    async dispose() {
+        this.disposeCount += 1;
+    }
+}
+export class FakeSandbox {
+    id = "sandbox-1";
+    status = "idle";
+    execCalls = [];
+    spawnCalls = [];
+    readCalls = [];
+    writeCalls = [];
+    startCount = 0;
+    shutdownCount = 0;
+    nextReadResult = "sandbox-file-content";
+    nextExecResult = {
+        stdout: "",
+        stderr: "",
+        exitCode: 0,
+    };
+    nextSpawnedProcess = createSpawnedProcessStub();
+    async start() {
+        this.startCount += 1;
+        this.status = "ready";
+    }
+    async shutdown() {
+        this.shutdownCount += 1;
+        this.status = "stopped";
+    }
+    async exec(command, options) {
+        this.execCalls.push({ command, options });
+        return this.nextExecResult;
+    }
+    async spawn(command, args = [], options) {
+        this.spawnCalls.push({ command, args, options });
+        return this.nextSpawnedProcess;
+    }
+    file = {
+        read: async (path) => {
+            this.readCalls.push(path);
+            return this.nextReadResult;
+        },
+        write: async (path, content) => {
+            this.writeCalls.push({ path, content });
+        },
+        list: async (path) => {
+            void path;
+            return [];
+        },
+        delete: async (path) => {
+            void path;
+            return undefined;
+        },
+    };
+}
+function createBaseSandboxConfig() {
+    return {
+        provider: "e2b",
+        timeout: 900,
+        resources: {
+            cpu: 2,
+            memory: "512MB",
+        },
+    };
+}
+function createBaseAgentConfig(overrides = {}) {
+    return {
+        name: "invoice-processor",
+        sandbox: createBaseSandboxConfig(),
+        model: {
+            provider: "ollama",
+            model: "qwen2.5-coder",
+        },
+        systemPrompt: "Current user: {{user_name}}",
+        variables: ["user_name"],
+        ...overrides,
+    };
+}
+function createBaseInitOptions(overrides = {}) {
+    return {
+        variables: {
+            user_name: "Alice",
+        },
+        ...overrides,
+    };
+}
+export function createHarness(options = {}) {
+    const loop = new FakeLoop();
+    const sandbox = new FakeSandbox();
+    const dependencies = {
+        createSandbox: (config, hooks) => {
+            void config;
+            void hooks;
+            options.order?.push("createSandbox");
+            return sandbox;
+        },
+        createLoop: () => {
+            options.order?.push("createLoop");
+            return loop;
+        },
+        createMcpClientManager: async (servers, tokens, mcpSandbox) => {
+            void servers;
+            void tokens;
+            void mcpSandbox;
+            options.order?.push("createMcpClientManager");
+            return options.mcpClientManager ?? null;
+        },
+    };
+    const agent = new AgentImpl(createBaseAgentConfig(options.configOverrides), createBaseInitOptions(options.initOverrides), dependencies);
+    return {
+        agent,
+        loop,
+        sandbox,
+        dependencies,
+    };
+}
+export async function collectEvents(iterable) {
+    const events = [];
+    for await (const event of iterable) {
+        events.push(event);
+    }
+    return events;
+}
+function createSpawnedProcessStub() {
+    return {
+        pid: 1,
+        stdin: new WritableStream({
+            write: async () => undefined,
+        }),
+        stdout: new ReadableStream({
+            start(controller) {
+                controller.close();
+            },
+        }),
+        stderr: new ReadableStream({
+            start(controller) {
+                controller.close();
+            },
+        }),
+        exited: Promise.resolve(0),
+        kill: async () => undefined,
+    };
+}
+//# sourceMappingURL=agent.test-helpers.js.map

package/dist/agent/agent.test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test-helpers.js","sourceRoot":"","sources":["../../src/agent/agent.test-helpers.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,MAAM,OAAO,QAAQ;IACH,WAAW,GAAsB,EAAE,CAAC;IACpC,SAAS,GAAoB,EAAE,CAAC;IAEzC,YAAY,GAAG,CAAC,CAAC;IAEhB,SAAS,GAAiB,IAAI,CAAC;IACtB,UAAU,GAAsB,EAAE,CAAC;IAE7C,YAAY,CAAC,KAAY;QAC9B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAEM,UAAU,CAAC,MAAuB;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAuB;QACvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,SAAS,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,CAAC,GAAG,CAAC,KAAoB,EAAE,OAAoB;QAC1D,KAAK,OAAO,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IACN,EAAE,GAAG,WAAW,CAAC;IAE1B,MAAM,GAAkB,MAAM,CAAC;IAEtB,SAAS,GAAsD,EAAE,CAAC;IAClE,UAAU,GAIrB,EAAE,CAAC;IACQ,SAAS,GAAa,EAAE,CAAC;IACzB,UAAU,GAAsD,EAAE,CAAC;IAE5E,UAAU,GAAG,CAAC,CAAC;IACf,aAAa,GAAG,CAAC,CAAC;IAElB,cAAc,GAAG,sBAAsB,CAAC;IACxC,cAAc,GAAe;QAClC,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,CAAC;KACZ,CAAC;IACK,kBAAkB,GAAmB,wBAAwB,EAAE,CAAC;IAEhE,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAAqB;QACtD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,KAAK,CAChB,OAAe,EACf,OAAiB,EAAE,EACnB,OAAsB;QAEtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAEe,IAAI,GAAG;QACrB,IAAI,EAAE,KAAK,EAAE,IAAY,EAAmB,EAAE;YAC5C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,OAAwB,EAAiB,EAAE;YACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,IAAY,EAAwB,EAAE;YACjD,KAAK,IAAI,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAY,EAAiB,EAAE;YAC5C,KAAK,IAAI,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;CACH;AASD,SAAS,uBAAuB;IAC9B,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE;YACT,GAAG,EAAE,CAAC;YACN,MAAM,EAAE,OAAO;SAChB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,YAA+C,EAAE;IAC9E,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,uBAAuB,EAAE;QAClC,KAAK,EAAE;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,eAAe;SACvB;QACD,YAAY,EAAE,6BAA6B;QAC3C,SAAS,EAAE,CAAC,WAAW,CAAU;QACjC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,YAA+C,EAAE;IAC9E,OAAO;QACL,SAAS,EAAE;YACT,SAAS,EAAE,OAAO;SACnB;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAK1B,EAAE;IACJ,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAElC,MAAM,YAAY,GAAsB;QACtC,aAAa,EAAE,CAAC,MAAqB,EAAE,KAAoB,EAAE,EAAE;YAC7D,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK,CAAC;YACX,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE;YACf,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,sBAAsB,EAAE,KAAK,EAC3B,OAAmC,EACnC,MAA8B,EAC9B,UAA6B,EAC7B,EAAE;YACF,KAAK,OAAO,CAAC;YACb,KAAK,MAAM,CAAC;YACZ,KAAK,UAAU,CAAC;YAChB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC9C,OAAO,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;QAC1C,CAAC;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,SAAS,CACzB,qBAAqB,CAAC,OAAO,CAAC,eAAe,CAAC,EAC9C,qBAAqB,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5C,YAAY,CACb,CAAC;IAEF,OAAO;QACL,KAAK;QACL,IAAI;QACJ,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAsC;IACxE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO;QACL,GAAG,EAAE,CAAC;QACN,KAAK,EAAE,IAAI,cAAc,CAAa;YACpC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;SAC7B,CAAC;QACF,MAAM,EAAE,IAAI,cAAc,CAAa;YACrC,KAAK,CAAC,UAAU;gBACd,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;SACF,CAAC;QACF,MAAM,EAAE,IAAI,cAAc,CAAa;YACrC,KAAK,CAAC,UAAU;gBACd,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;SACF,CAAC;QACF,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC"}

package/dist/agent/define-agent.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig, AgentFactory } from "./types.js";
+export declare function defineAgent<V extends string>(config: AgentConfig<V>): AgentFactory<V>;

package/dist/agent/define-agent.js

@@ -0,0 +1,18 @@
+import { createInitializedAgent } from "./agent.js";
+function validateRequiredVariables(expectedVariables, variables) {
+    const missingVariables = expectedVariables.filter((name) => !Object.hasOwn(variables, name));
+    if (missingVariables.length === 0) {
+        return;
+    }
+    throw new Error(`Missing required init variables: ${missingVariables.join(", ")}`);
+}
+export function defineAgent(config) {
+    return {
+        name: config.name,
+        init: async (options) => {
+            validateRequiredVariables(config.variables, options.variables);
+            return await createInitializedAgent(config, options);
+        },
+    };
+}
+//# sourceMappingURL=define-agent.js.map

package/dist/agent/define-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent.js","sourceRoot":"","sources":["../../src/agent/define-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,SAAS,yBAAyB,CAChC,iBAA+B,EAC/B,SAA4B;IAE5B,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,WAAW,CAAmB,MAAsB;IAClE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,yBAAyB,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/D,OAAO,MAAM,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/dependencies.d.ts

@@ -0,0 +1,15 @@
+import { type AgentLoop } from "../agent-loop/index.js";
+import { type McpClientManager } from "../mcp/index.js";
+import type { ObservabilityProvider } from "../observability/types.js";
+import { type CreateSandbox } from "../sandbox/index.js";
+import type { SandboxIO } from "../sandbox/types.js";
+import type { McpServerConfig } from "./types.js";
+export type { McpClientManager } from "../mcp/index.js";
+export type CreateMcpClientManager = (servers: readonly McpServerConfig[], tokens: Record<string, string>, sandbox?: SandboxIO | null) => Promise<McpClientManager | null>;
+export type AgentDependencies = {
+    createSandbox: CreateSandbox;
+    createLoop: () => AgentLoop;
+    createMcpClientManager: CreateMcpClientManager;
+    observability?: ObservabilityProvider;
+};
+export declare function createDefaultDependencies(): AgentDependencies;

package/dist/agent/dependencies.js

@@ -0,0 +1,14 @@
+import { PiMonoAgentLoop } from "../agent-loop/index.js";
+import { createMcpClientManager } from "../mcp/index.js";
+import { createSandbox } from "../sandbox/index.js";
+function defaultCreateMcpClientManager(servers, tokens, sandbox) {
+    return createMcpClientManager(servers, tokens, { sandbox: sandbox ?? null });
+}
+export function createDefaultDependencies() {
+    return {
+        createSandbox,
+        createLoop: () => new PiMonoAgentLoop(),
+        createMcpClientManager: defaultCreateMcpClientManager,
+    };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/agent/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/agent/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAyB,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAmBxE,SAAS,6BAA6B,CACpC,OAAmC,EACnC,MAA8B,EAC9B,OAA0B;IAE1B,OAAO,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,aAAa;QACb,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;QACvC,sBAAsB,EAAE,6BAA6B;KACtD,CAAC;AACJ,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./agent.js";
+export * from "./define-agent.js";
+export * from "./session.js";
+export * from "./types.js";

package/dist/agent/index.js

@@ -0,0 +1,5 @@
+export * from "./agent.js";
+export * from "./define-agent.js";
+export * from "./session.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

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

package/dist/agent/internals.d.ts

@@ -0,0 +1,28 @@
+import type { AgentLoop, ModelProvider, ResponseInput, ResponseOutput, ToolResult } from "../agent-loop/index.js";
+import type { ExecResult, Sandbox } from "../sandbox/index.js";
+import type { AgentStatus } from "./types.js";
+import type { McpClientManager } from "./dependencies.js";
+export declare function toErrorMessage(error: unknown): string;
+export declare function toToolError(toolCallId: string, message: string): ToolResult;
+export declare function toConversationInput(conversationHistory: ResponseInput, input: ResponseInput): ResponseInput;
+export declare function toNextConversationHistory(runInput: ResponseInput, output: ResponseOutput): ResponseInput;
+export declare function extractRequiredString(input: Record<string, unknown>, fieldName: string): string | null;
+export declare function extractRequiredNonEmptyString(input: Record<string, unknown>, fieldName: string): string | null;
+export declare function extractOptionalString(input: Record<string, unknown>, fieldName: string): string | undefined;
+export declare function extractOptionalNumber(input: Record<string, unknown>, fieldName: string): number | undefined;
+export declare function extractOptionalChunkHandler(input: Record<string, unknown>, fieldName: string): ((chunk: string) => void) | undefined;
+export declare function formatExecResult(result: ExecResult): string;
+export declare function readFieldError(toolCallId: string, toolName: string, fieldName: string): ToolResult;
+export declare function readFieldTypeError(toolCallId: string, toolName: string, fieldName: string): ToolResult;
+export declare function disposeResources(loop: AgentLoop | null, mcpClientManager: McpClientManager | null, sandbox: Sandbox | null): Promise<void>;
+export declare function ensureRunnableStatus(status: AgentStatus): void;
+export declare function isMcpTool(name: string): boolean;
+/**
+ * Parse an MCP tool name (e.g. `mcp__server__tool`) into server and tool parts.
+ * Returns null if the name does not match the expected format.
+ */
+export declare function parseMcpToolName(name: string): {
+    serverName: string;
+    toolName: string;
+} | null;
+export declare function validateModelApiKey(provider: ModelProvider): void;

package/dist/agent/internals.js

@@ -0,0 +1,160 @@
+const MCP_TOOL_PREFIX = "mcp__";
+export function toErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === "string") {
+        return error;
+    }
+    return "Unknown error";
+}
+export function toToolError(toolCallId, message) {
+    return {
+        toolCallId,
+        output: message,
+        isError: true,
+    };
+}
+export function toConversationInput(conversationHistory, input) {
+    return [...conversationHistory, ...input];
+}
+export function toNextConversationHistory(runInput, output) {
+    return [
+        ...runInput,
+        {
+            role: "assistant",
+            content: output.output,
+        },
+    ];
+}
+export function extractRequiredString(input, fieldName) {
+    const value = input[fieldName];
+    if (typeof value === "string") {
+        return value;
+    }
+    return null;
+}
+export function extractRequiredNonEmptyString(input, fieldName) {
+    const value = input[fieldName];
+    if (typeof value === "string" && value.length > 0) {
+        return value;
+    }
+    return null;
+}
+export function extractOptionalString(input, fieldName) {
+    const value = input[fieldName];
+    if (value === undefined) {
+        return undefined;
+    }
+    return typeof value === "string" ? value : undefined;
+}
+export function extractOptionalNumber(input, fieldName) {
+    const value = input[fieldName];
+    if (value === undefined) {
+        return undefined;
+    }
+    return typeof value === "number" ? value : undefined;
+}
+export function extractOptionalChunkHandler(input, fieldName) {
+    const value = input[fieldName];
+    if (!isChunkHandler(value)) {
+        return undefined;
+    }
+    return value;
+}
+function isChunkHandler(value) {
+    return typeof value === "function";
+}
+export function formatExecResult(result) {
+    const sections = [
+        `exitCode: ${result.exitCode}`,
+        result.stdout.length > 0 ? `stdout:\n${result.stdout}` : "stdout: (empty)",
+        result.stderr.length > 0 ? `stderr:\n${result.stderr}` : "stderr: (empty)",
+    ];
+    return sections.join("\n\n");
+}
+export function readFieldError(toolCallId, toolName, fieldName) {
+    return toToolError(toolCallId, `${toolName} tool requires a non-empty string field \"${fieldName}\".`);
+}
+export function readFieldTypeError(toolCallId, toolName, fieldName) {
+    return toToolError(toolCallId, `${toolName} tool requires a string field \"${fieldName}\".`);
+}
+export async function disposeResources(loop, mcpClientManager, sandbox) {
+    const failures = [];
+    if (loop) {
+        try {
+            await loop.dispose();
+        }
+        catch (error) {
+            failures.push(`loop.dispose failed: ${toErrorMessage(error)}`);
+        }
+    }
+    if (mcpClientManager) {
+        try {
+            await mcpClientManager.dispose();
+        }
+        catch (error) {
+            failures.push(`mcp.dispose failed: ${toErrorMessage(error)}`);
+        }
+    }
+    if (sandbox) {
+        try {
+            await sandbox.shutdown();
+        }
+        catch (error) {
+            failures.push(`sandbox.shutdown failed: ${toErrorMessage(error)}`);
+        }
+    }
+    if (failures.length > 0) {
+        throw new Error(`Agent shutdown encountered errors: ${failures.join(" | ")}`);
+    }
+}
+export function ensureRunnableStatus(status) {
+    if (status === "stopped") {
+        throw new Error("Agent is stopped.");
+    }
+    if (status === "running") {
+        throw new Error("Agent is already running.");
+    }
+}
+export function isMcpTool(name) {
+    return name.startsWith(MCP_TOOL_PREFIX);
+}
+/**
+ * Parse an MCP tool name (e.g. `mcp__server__tool`) into server and tool parts.
+ * Returns null if the name does not match the expected format.
+ */
+export function parseMcpToolName(name) {
+    if (!name.startsWith(MCP_TOOL_PREFIX))
+        return null;
+    const rest = name.slice(MCP_TOOL_PREFIX.length);
+    const separatorIndex = rest.indexOf("__");
+    if (separatorIndex < 1)
+        return null;
+    return {
+        serverName: rest.slice(0, separatorIndex),
+        toolName: rest.slice(separatorIndex + 2),
+    };
+}
+const MODEL_PROVIDER_CREDENTIAL_ENVS = {
+    anthropic: ["ANTHROPIC_OAUTH_TOKEN", "ANTHROPIC_API_KEY"],
+    openai: ["OPENAI_API_KEY"],
+    gemini: ["GEMINI_API_KEY"],
+    openrouter: ["OPENROUTER_API_KEY"],
+};
+export function validateModelApiKey(provider) {
+    const requiredEnvNames = MODEL_PROVIDER_CREDENTIAL_ENVS[provider];
+    if (!requiredEnvNames || requiredEnvNames.length === 0) {
+        // Ollama does not require an API key by default.
+        return;
+    }
+    const hasCredential = requiredEnvNames.some((envName) => {
+        const rawValue = process.env[envName];
+        return typeof rawValue === "string" && rawValue.trim().length > 0;
+    });
+    if (hasCredential) {
+        return;
+    }
+    throw new Error(`Missing credentials for provider "${provider}". Set ${requiredEnvNames.join(" or ")} before starting the agent.`);
+}
+//# sourceMappingURL=internals.js.map

package/dist/agent/internals.js.map

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

package/dist/agent/session.d.ts

@@ -0,0 +1,4 @@
+import type { ResponseInput } from "../agent-loop/types.js";
+export type SessionState = {
+    conversationHistory: ResponseInput;
+};

package/dist/agent/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/agent/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/agent/session.ts"],"names":[],"mappings":""}

package/dist/agent/types.d.ts

@@ -0,0 +1,52 @@
+import type { ModelConfig, ResponseEvent, ResponseInput, ResponseOutput } from "../agent-loop/types.js";
+import type { SandboxConfig, SandboxHooks } from "../sandbox/types.js";
+import type { SessionState } from "./session.js";
+export type McpServerHttpConfig = {
+    transport: "http";
+    name: string;
+    url: string;
+    auth: "bearer";
+};
+export type McpServerStdioConfig = {
+    transport: "stdio";
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+};
+export type McpServerSseConfig = {
+    transport: "sse";
+    name: string;
+    url: string;
+    auth?: "bearer";
+};
+export type McpServerConfig = McpServerHttpConfig | McpServerStdioConfig | McpServerSseConfig;
+export type AgentStatus = "ready" | "running" | "stopped";
+export type RespondStreamOptions = {
+    signal?: AbortSignal;
+};
+export interface Agent {
+    readonly name: string;
+    readonly status: AgentStatus;
+    respond(input: ResponseInput): Promise<ResponseOutput>;
+    respondStream(input: ResponseInput, options?: RespondStreamOptions): AsyncIterable<ResponseEvent>;
+    shutdown(): Promise<void>;
+}
+export type InitOptions<V extends string> = {
+    variables: Record<V, string>;
+    hooks?: SandboxHooks;
+    session?: SessionState;
+    mcpTokens?: Record<string, string>;
+};
+export type AgentConfig<V extends string> = {
+    name: string;
+    sandbox: SandboxConfig;
+    model: ModelConfig;
+    systemPrompt: string;
+    variables: readonly V[];
+    mcp?: McpServerConfig[];
+};
+export type AgentFactory<V extends string> = {
+    name: string;
+    init(options: InitOptions<V>): Promise<Agent>;
+};

package/dist/agent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":""}

package/dist/agent-loop/agent-loop.d.ts

@@ -0,0 +1,27 @@
+import type { ModelConfig, ResponseEvent, ResponseInput, ToolCall, ToolResult } from "./types.js";
+export type ToolHandler = (call: ToolCall) => Promise<ToolResult>;
+export type ToolInputSchema = {
+    type: "object";
+    properties?: Record<string, unknown>;
+    required?: string[];
+    [key: string]: unknown;
+};
+export type AgentLoopTool = {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+};
+export type AgentLoopConfig = {
+    systemPrompt: string;
+    model: ModelConfig;
+    toolHandler: ToolHandler;
+    externalTools?: readonly AgentLoopTool[];
+};
+export type RunOptions = {
+    signal?: AbortSignal;
+};
+export interface AgentLoop {
+    init(config: AgentLoopConfig): Promise<void>;
+    run(input: ResponseInput, options?: RunOptions): AsyncIterable<ResponseEvent>;
+    dispose(): Promise<void>;
+}

package/dist/agent-loop/agent-loop.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-loop.js.map

package/dist/agent-loop/agent-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../src/agent-loop/agent-loop.ts"],"names":[],"mappings":""}

package/dist/agent-loop/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./agent-loop.js";
+export * from "./pi-mono/index.js";
+export * from "./system-prompt/index.js";
+export * from "./types.js";

package/dist/agent-loop/index.js

@@ -0,0 +1,5 @@
+export * from "./agent-loop.js";
+export * from "./pi-mono/index.js";
+export * from "./system-prompt/index.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/agent-loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-loop/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC"}

package/dist/agent-loop/pi-mono/events.d.ts

@@ -0,0 +1,3 @@
+import type { AgentEvent } from "@mariozechner/pi-agent-core";
+import type { ResponseEvent } from "../types.js";
+export declare function toResponseEvent(event: AgentEvent): ResponseEvent | null;

package/dist/agent-loop/pi-mono/events.js

@@ -0,0 +1,73 @@
+import { toInputRecord } from "./utils.js";
+import { toBundleToolCallName } from "./tools.js";
+function toToolCallEvent(toolCallId, toolName, args) {
+    return {
+        id: toolCallId,
+        name: toBundleToolCallName(toolName),
+        input: toInputRecord(args),
+    };
+}
+function toToolResultEvent(toolCallId, result, isError) {
+    return {
+        toolCallId,
+        output: result,
+        isError,
+    };
+}
+function toToolUpdateChunk(partialResult) {
+    if (typeof partialResult !== "object"
+        || partialResult === null
+        || !Object.hasOwn(partialResult, "content")) {
+        return "";
+    }
+    const content = Reflect.get(partialResult, "content");
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return content
+        .filter((item) => {
+        if (typeof item !== "object" || item === null) {
+            return false;
+        }
+        return Reflect.get(item, "type") === "text" && typeof Reflect.get(item, "text") === "string";
+    })
+        .map((item) => {
+        return typeof item === "object" && item !== null
+            ? String(Reflect.get(item, "text"))
+            : "";
+    })
+        .join("");
+}
+export function toResponseEvent(event) {
+    if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+        return {
+            type: "response.output_text.delta",
+            delta: event.assistantMessageEvent.delta,
+        };
+    }
+    if (event.type === "tool_execution_start") {
+        return {
+            type: "response.tool_call.created",
+            toolCall: toToolCallEvent(event.toolCallId, event.toolName, event.args),
+        };
+    }
+    if (event.type === "tool_execution_update") {
+        const chunk = toToolUpdateChunk(event.partialResult);
+        if (chunk.length === 0) {
+            return null;
+        }
+        return {
+            type: "tool_execution_update",
+            toolCallId: event.toolCallId,
+            chunk,
+        };
+    }
+    if (event.type === "tool_execution_end") {
+        return {
+            type: "response.tool_call.done",
+            result: toToolResultEvent(event.toolCallId, event.result, event.isError),
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=events.js.map