agent-bundle 0.1.0

package/dist/cli/serve/init.d.ts

@@ -0,0 +1,42 @@
+import type { Agent, AgentConfig, AgentFactory } from "../../agent/types.js";
+import type { Command } from "../../commands/types.js";
+import type { BundleConfig } from "../../schema/bundle.js";
+import type { Sandbox, SandboxIO } from "../../sandbox/types.js";
+import { resolveServeInputs, type KeyValueArgInput, type SkillInfo } from "./runtime.js";
+import type { StartedHttpServer, StartHttpServerInput } from "./http.js";
+export declare const DEFAULT_SERVE_PORT = 3000;
+export type DefineAgentForServe = (config: AgentConfig<string>) => AgentFactory<string>;
+export type ServeDependencies = {
+    defineAgentImpl?: DefineAgentForServe;
+    startHttpServerImpl?: (input: StartHttpServerInput) => Promise<StartedHttpServer>;
+    signalProcess?: Pick<NodeJS.Process, "on" | "off">;
+    env?: NodeJS.ProcessEnv;
+    exit?: (code: number) => void;
+    loadConfig?: Parameters<typeof resolveServeInputs>[1];
+    loadSkills?: Parameters<typeof resolveServeInputs>[2];
+    generateSystemPrompt?: Parameters<typeof resolveServeInputs>[3];
+};
+export type InitializedServeContext = {
+    configPath: string;
+    config: BundleConfig;
+    agent: Agent;
+    webUISandbox: Sandbox;
+    commands: Command[];
+    skills: SkillInfo[];
+};
+export type RunServeOptions = {
+    configPath: string;
+    port?: number;
+    variableEntries?: KeyValueArgInput;
+    mcpTokenEntries?: KeyValueArgInput;
+    stdin?: NodeJS.ReadableStream;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+};
+export type RunServeResult = {
+    port: number;
+};
+export declare function validatePort(port: number): void;
+export declare function toWebUISandboxAdapter(sandboxIO: SandboxIO): Sandbox;
+export declare function initializeServeContext(options: RunServeOptions, dependencies: ServeDependencies): Promise<InitializedServeContext>;
+export declare function wireSignalShutdown(signalProcess: Pick<NodeJS.Process, "on" | "off">, shutdown: () => Promise<void>, exit: (code: number) => void, stderr: NodeJS.WritableStream): Promise<void>;

package/dist/cli/serve/init.js

@@ -0,0 +1,110 @@
+import { defineAgent } from "../../agent/define-agent.js";
+import { toErrorMessage } from "../error.js";
+import { parseKeyValueEntries, resolveInitVariables, resolveMcpTokens, resolveServeInputs, resolveServeSandboxConfig, } from "./runtime.js";
+export const DEFAULT_SERVE_PORT = 3000;
+export function validatePort(port) {
+    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+        throw new Error("Serve port must be an integer between 1 and 65535.");
+    }
+}
+export function toWebUISandboxAdapter(sandboxIO) {
+    let status = "ready";
+    return {
+        id: "serve-sandbox",
+        get status() {
+            return status;
+        },
+        // Adapter does not own lifecycle; the real sandbox is managed by AgentImpl.
+        start: async () => {
+            status = "ready";
+        },
+        // Reflect shutdown state for any status-based observer in WebUI integrations.
+        shutdown: async () => {
+            status = "stopped";
+        },
+        exec: async (command, options) => {
+            return await sandboxIO.exec(command, options);
+        },
+        spawn: async (command, args, options) => {
+            return await sandboxIO.spawn(command, args, options);
+        },
+        file: sandboxIO.file,
+    };
+}
+export async function initializeServeContext(options, dependencies) {
+    const defineAgentImpl = dependencies.defineAgentImpl ?? defineAgent;
+    const env = dependencies.env ?? process.env;
+    const variableOverrides = parseKeyValueEntries(options.variableEntries, "--var");
+    const mcpTokenOverrides = parseKeyValueEntries(options.mcpTokenEntries, "--mcp-token");
+    const { configPath, config, systemPrompt, commands, skills } = await resolveServeInputs(options.configPath, dependencies.loadConfig, dependencies.loadSkills, dependencies.generateSystemPrompt);
+    const variables = resolveInitVariables(config.prompt.variables, variableOverrides, env);
+    const mcpServers = config.mcp?.servers ?? [];
+    const mcpTokens = resolveMcpTokens(mcpServers, mcpTokenOverrides, env);
+    const agentFactoryConfig = {
+        name: config.name,
+        sandbox: resolveServeSandboxConfig(config.sandbox),
+        model: config.model,
+        systemPrompt,
+        variables: config.prompt.variables,
+        ...(mcpServers.length > 0 ? { mcp: mcpServers } : {}),
+    };
+    let capturedSandboxIO = null;
+    const initOptions = {
+        variables,
+        hooks: {
+            postMount: async (io) => {
+                capturedSandboxIO = io;
+            },
+        },
+        ...(Object.keys(mcpTokens).length > 0 ? { mcpTokens } : {}),
+    };
+    const agent = await defineAgentImpl(agentFactoryConfig).init(initOptions);
+    if (!capturedSandboxIO) {
+        await agent.shutdown();
+        throw new Error("Agent initialized without exposing sandbox IO for WebUI.");
+    }
+    return {
+        configPath,
+        config,
+        agent,
+        webUISandbox: toWebUISandboxAdapter(capturedSandboxIO),
+        commands,
+        skills,
+    };
+}
+export async function wireSignalShutdown(signalProcess, shutdown, exit, stderr) {
+    const onSignal = (signal) => {
+        void shutdown()
+            .then(() => exit(0))
+            .catch((error) => {
+            stderr.write(`[serve] failed to shutdown on ${signal}: ${toErrorMessage(error)}\n`);
+            exit(1);
+        });
+    };
+    let resolveShutdown = null;
+    const onShutdownSignal = () => {
+        resolveShutdown?.();
+    };
+    signalProcess.on("SIGINT", onSignal);
+    signalProcess.on("SIGTERM", onSignal);
+    signalProcess.on("SIGINT", onShutdownSignal);
+    signalProcess.on("SIGTERM", onShutdownSignal);
+    try {
+        await new Promise((resolve) => {
+            resolveShutdown = () => {
+                if (!resolveShutdown) {
+                    return;
+                }
+                resolveShutdown = null;
+                resolve();
+            };
+        });
+    }
+    finally {
+        signalProcess.off("SIGINT", onSignal);
+        signalProcess.off("SIGTERM", onSignal);
+        signalProcess.off("SIGINT", onShutdownSignal);
+        signalProcess.off("SIGTERM", onShutdownSignal);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/serve/init.js.map

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

package/dist/cli/serve/runtime.d.ts

@@ -0,0 +1,25 @@
+import { generateSystemPromptTemplate } from "../../agent-loop/system-prompt/generate.js";
+import type { McpServerConfig } from "../../agent/types.js";
+import { loadAllCommands } from "../../commands/loader.js";
+import type { Command } from "../../commands/types.js";
+import { loadAllPlugins, type LoadPluginOptions } from "../../plugins/loader.js";
+import type { BundleConfig } from "../../schema/bundle.js";
+import { loadAllSkills } from "../../skills/loader.js";
+import { loadBundleConfig } from "../config/load-bundle-config.js";
+export type KeyValueArgInput = string | string[] | boolean | undefined;
+export type SkillInfo = {
+    name: string;
+    description: string;
+};
+export type ResolvedServeInputs = {
+    configPath: string;
+    config: BundleConfig;
+    systemPrompt: string;
+    commands: Command[];
+    skills: SkillInfo[];
+};
+export declare function parseKeyValueEntries(raw: KeyValueArgInput, optionName: string): Record<string, string>;
+export declare function resolveInitVariables(variableNames: readonly string[], cliOverrides: Record<string, string>, env: NodeJS.ProcessEnv): Record<string, string>;
+export declare function resolveMcpTokens(servers: readonly McpServerConfig[], cliOverrides: Record<string, string>, env: NodeJS.ProcessEnv): Record<string, string>;
+export declare function resolveServeSandboxConfig(sandbox: BundleConfig["sandbox"]): BundleConfig["sandbox"];
+export declare function resolveServeInputs(configPath: string, loadConfigImpl?: typeof loadBundleConfig, loadSkillsImpl?: typeof loadAllSkills, generateSystemPromptImpl?: typeof generateSystemPromptTemplate, loadPluginsImpl?: typeof loadAllPlugins, pluginOptions?: LoadPluginOptions, loadCommandsImpl?: typeof loadAllCommands): Promise<ResolvedServeInputs>;

package/dist/cli/serve/runtime.js

@@ -0,0 +1,142 @@
+import { dirname, resolve } from "node:path";
+import { generateSystemPromptTemplate } from "../../agent-loop/system-prompt/generate.js";
+import { loadAllCommands } from "../../commands/loader.js";
+import { loadAllPlugins } from "../../plugins/loader.js";
+import { mergePluginComponents } from "../../plugins/merge.js";
+import { loadAllSkills } from "../../skills/loader.js";
+import { toSkillSummaries } from "../../skills/summaries.js";
+import { loadBundleConfig } from "../config/load-bundle-config.js";
+const VARIABLE_ENV_PREFIX = "AGENT_BUNDLE_VAR_";
+const MCP_TOKEN_ENV_PREFIX = "AGENT_BUNDLE_MCP_TOKEN_";
+const MCP_TOKEN_ENV_FALLBACK_PREFIX = "MCP_TOKEN_";
+function toEnvSuffix(name) {
+    return name.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase();
+}
+function normalizeArgEntries(raw, optionName) {
+    if (raw === undefined || raw === false) {
+        return [];
+    }
+    if (raw === true) {
+        throw new Error(`${optionName} requires a value in key=value format.`);
+    }
+    const values = Array.isArray(raw) ? raw : [raw];
+    return values
+        .flatMap((value) => value.split(","))
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+}
+export function parseKeyValueEntries(raw, optionName) {
+    const entries = normalizeArgEntries(raw, optionName);
+    return entries.reduce((acc, entry) => {
+        const separatorIndex = entry.indexOf("=");
+        const key = separatorIndex >= 0 ? entry.slice(0, separatorIndex).trim() : "";
+        const value = separatorIndex >= 0 ? entry.slice(separatorIndex + 1) : "";
+        if (separatorIndex <= 0 || key.length === 0) {
+            throw new Error(`Invalid ${optionName} entry "${entry}". Expected key=value with a non-empty key.`);
+        }
+        acc[key] = value;
+        return acc;
+    }, {});
+}
+function readRequiredVariable(name, cliOverrides, env) {
+    const override = cliOverrides[name];
+    if (override !== undefined) {
+        return override;
+    }
+    const direct = env[name];
+    if (typeof direct === "string") {
+        return direct;
+    }
+    const prefixed = env[`${VARIABLE_ENV_PREFIX}${toEnvSuffix(name)}`];
+    if (typeof prefixed === "string") {
+        return prefixed;
+    }
+    return undefined;
+}
+export function resolveInitVariables(variableNames, cliOverrides, env) {
+    const knownVariables = new Set(variableNames);
+    const unknownCliVariables = Object.keys(cliOverrides).filter((name) => !knownVariables.has(name));
+    if (unknownCliVariables.length > 0) {
+        const expected = variableNames.length > 0 ? variableNames.join(", ") : "<none>";
+        throw new Error(`Unknown --var entries: ${unknownCliVariables.join(", ")}. Expected variables: ${expected}.`);
+    }
+    const missing = [];
+    const variables = variableNames.reduce((acc, name) => {
+        const value = readRequiredVariable(name, cliOverrides, env);
+        if (value === undefined) {
+            missing.push(name);
+            return acc;
+        }
+        acc[name] = value;
+        return acc;
+    }, {});
+    if (missing.length > 0) {
+        throw new Error(`Missing required init variables: ${missing.join(", ")}. ` +
+            "Provide them with --var <name>=<value> or env vars <name> / AGENT_BUNDLE_VAR_<NAME>.");
+    }
+    return variables;
+}
+export function resolveMcpTokens(servers, cliOverrides, env) {
+    const knownServers = new Set(servers.map((server) => server.name));
+    const unknownServers = Object.keys(cliOverrides).filter((name) => !knownServers.has(name));
+    if (unknownServers.length > 0) {
+        const expected = servers.length > 0 ? servers.map((server) => server.name).join(", ") : "<none>";
+        throw new Error(`Unknown --mcp-token entries: ${unknownServers.join(", ")}. Expected MCP servers: ${expected}.`);
+    }
+    return servers.reduce((tokens, server) => {
+        if (cliOverrides[server.name] !== undefined) {
+            tokens[server.name] = cliOverrides[server.name];
+            return tokens;
+        }
+        const suffix = toEnvSuffix(server.name);
+        const prefixed = env[`${MCP_TOKEN_ENV_PREFIX}${suffix}`];
+        const fallback = env[`${MCP_TOKEN_ENV_FALLBACK_PREFIX}${suffix}`];
+        const value = prefixed ?? fallback;
+        if (typeof value === "string") {
+            tokens[server.name] = value;
+        }
+        return tokens;
+    }, {});
+}
+export function resolveServeSandboxConfig(sandbox) {
+    if (!sandbox.serve?.provider) {
+        return sandbox;
+    }
+    return {
+        ...sandbox,
+        provider: sandbox.serve.provider,
+    };
+}
+export async function resolveServeInputs(configPath, loadConfigImpl = loadBundleConfig, loadSkillsImpl = loadAllSkills, generateSystemPromptImpl = generateSystemPromptTemplate, loadPluginsImpl = loadAllPlugins, pluginOptions, loadCommandsImpl = loadAllCommands) {
+    const absoluteConfigPath = resolve(configPath);
+    const config = await loadConfigImpl(absoluteConfigPath);
+    const bundleDir = dirname(absoluteConfigPath);
+    const baseSkills = await loadSkillsImpl(config.skills, bundleDir);
+    const baseCommands = config.commands
+        ? await loadCommandsImpl(config.commands, bundleDir)
+        : [];
+    const pluginResults = config.plugins
+        ? await loadPluginsImpl(config.plugins, pluginOptions)
+        : [];
+    const existingMcpServers = config.mcp?.servers ?? [];
+    const merged = mergePluginComponents(baseSkills, baseCommands, existingMcpServers, pluginResults);
+    const systemPrompt = generateSystemPromptImpl({
+        basePrompt: config.prompt.system,
+        skills: toSkillSummaries(merged.skills),
+    });
+    const mergedConfig = merged.mcpServers.length > 0
+        ? { ...config, mcp: { servers: merged.mcpServers } }
+        : config;
+    const skills = merged.skills.map((s) => ({
+        name: s.name,
+        description: s.description,
+    }));
+    return {
+        configPath: absoluteConfigPath,
+        config: mergedConfig,
+        systemPrompt,
+        commands: merged.commands,
+        skills,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/cli/serve/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/cli/serve/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,cAAc,EAA0B,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAChD,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AACvD,MAAM,6BAA6B,GAAG,YAAY,CAAC;AAiBnD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAqB,EAAE,UAAkB;IACpE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,wCAAwC,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,MAAM;SACV,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAqB,EAAE,UAAkB;IAC5E,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzE,IAAI,cAAc,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,WAAW,KAAK,6CAA6C,CACnF,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,YAAoC,EACpC,GAAsB;IAEtB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,mBAAmB,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,aAAgC,EAChC,YAAoC,EACpC,GAAsB;IAEtB,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClG,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChF,MAAM,IAAI,KAAK,CACb,0BAA0B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,QAAQ,GAAG,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3E,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,GAAG,CAAC;QACb,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAClB,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,oCAAoC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC1D,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAmC,EACnC,YAAoC,EACpC,GAAsB;IAEtB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3F,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjG,MAAM,IAAI,KAAK,CACb,gCAAgC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,QAAQ,GAAG,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC/D,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,oBAAoB,GAAG,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,6BAA6B,GAAG,MAAM,EAAE,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,QAAQ,IAAI,QAAQ,CAAC;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAgC;IACxE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,iBAA0C,gBAAgB,EAC1D,iBAAuC,aAAa,EACpD,2BAAgE,4BAA4B,EAC5F,kBAAyC,cAAc,EACvD,aAAiC,EACjC,mBAA2C,eAAe;IAE1D,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ;QAClC,CAAC,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;QACpD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO;QAClC,CAAC,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;QACtD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAElG,MAAM,YAAY,GAAG,wBAAwB,CAAC;QAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QAChC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAC/C,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE;QACpD,CAAC,CAAC,MAAM,CAAC;IAEX,MAAM,MAAM,GAAgB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,MAAM,EAAE,YAAY;QACpB,YAAY;QACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/cli/serve/serve.d.ts

@@ -0,0 +1,7 @@
+import { createServer } from "../../service/create-server.js";
+import { type RunServeOptions, type RunServeResult, type ServeDependencies as SharedServeDependencies } from "./init.js";
+export { DEFAULT_SERVE_PORT } from "./init.js";
+export type ServeDependencies = SharedServeDependencies & {
+    createServerImpl?: typeof createServer;
+};
+export declare function runServeCommand(options: RunServeOptions, dependencies?: ServeDependencies): Promise<RunServeResult>;

package/dist/cli/serve/serve.js

@@ -0,0 +1,63 @@
+import { createServer } from "../../service/create-server.js";
+import { startHttpServer } from "./http.js";
+import { initializeServeContext, validatePort, wireSignalShutdown, } from "./init.js";
+import { resolveServicePort } from "./worktree-port.js";
+export { DEFAULT_SERVE_PORT } from "./init.js";
+async function shutdownServeResources(resources) {
+    const errors = [];
+    try {
+        await resources.httpServer?.close();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        await resources.agent.shutdown();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    if (errors.length > 0) {
+        throw errors[0];
+    }
+}
+export async function runServeCommand(options, dependencies = {}) {
+    const createServerImpl = dependencies.createServerImpl ?? createServer;
+    const startHttpServerImpl = dependencies.startHttpServerImpl ?? startHttpServer;
+    const signalProcess = dependencies.signalProcess ?? process;
+    const exit = dependencies.exit ?? ((code) => process.exit(code));
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const port = options.port ?? await resolveServicePort(0);
+    validatePort(port);
+    const context = await initializeServeContext(options, dependencies);
+    stdout.write(`Starting bundle "${context.config.name}" from ${context.configPath}\n`);
+    let httpServer = null;
+    let shutdownPromise = null;
+    const shutdown = async () => {
+        if (!shutdownPromise) {
+            shutdownPromise = shutdownServeResources({ agent: context.agent, httpServer });
+        }
+        return await shutdownPromise;
+    };
+    try {
+        const app = createServerImpl(context.agent, {
+            commands: context.commands,
+        });
+        httpServer = await startHttpServerImpl({
+            appFetch: app.fetch.bind(app),
+            port,
+            stderr,
+        });
+        stdout.write(`Serve ready at http://localhost:${httpServer.port}\n`);
+        await wireSignalShutdown(signalProcess, shutdown, exit, stderr);
+    }
+    finally {
+        await shutdown();
+    }
+    if (!httpServer) {
+        throw new Error("Serve HTTP server did not start.");
+    }
+    return { port: httpServer.port };
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/serve/serve.js.map

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

package/dist/cli/serve/serve.test-helpers.d.ts

@@ -0,0 +1,36 @@
+import type { Agent, AgentConfig, InitOptions } from "../../agent/types.js";
+import type { BundleConfig } from "../../schema/bundle.js";
+import { vi } from "vitest";
+type ServeHarnessOptions = {
+    config?: BundleConfig;
+    env?: NodeJS.ProcessEnv;
+    callPostMountHook?: boolean;
+};
+type SignalListener = (...args: unknown[]) => void;
+export type ServeHarness = {
+    agent: Agent;
+    env: NodeJS.ProcessEnv;
+    captured: {
+        agentConfig: AgentConfig<string> | null;
+        initOptions: InitOptions<string> | null;
+    };
+    loadConfigMock: ReturnType<typeof vi.fn>;
+    loadSkillsMock: ReturnType<typeof vi.fn>;
+    generateSystemPromptMock: ReturnType<typeof vi.fn>;
+    defineAgentMock: ReturnType<typeof vi.fn>;
+    createServerMock: ReturnType<typeof vi.fn>;
+    createWebUIServerMock: ReturnType<typeof vi.fn>;
+    startHttpServerMock: ReturnType<typeof vi.fn>;
+    closeServerMock: ReturnType<typeof vi.fn>;
+    webUIShutdownMock: ReturnType<typeof vi.fn>;
+    agentShutdownMock: ReturnType<typeof vi.fn>;
+};
+export declare const DEFAULT_CONFIG_PATH = "/tmp/agent-bundle-workspace/agent-bundle.yaml";
+export declare function createSignalMock(): {
+    signalProcess: Pick<NodeJS.Process, "on" | "off">;
+    fire: (signal: string) => void;
+    listeners: Map<string, Set<SignalListener>>;
+};
+export declare function createBaseConfig(): BundleConfig;
+export declare function createServeHarness(options?: ServeHarnessOptions): ServeHarness;
+export {};

package/dist/cli/serve/serve.test-helpers.js

@@ -0,0 +1,205 @@
+import { vi } from "vitest";
+export const DEFAULT_CONFIG_PATH = "/tmp/agent-bundle-workspace/agent-bundle.yaml";
+export function createSignalMock() {
+    const listeners = new Map();
+    const signalProcess = {
+        on: (signal, listener) => {
+            if (!listeners.has(signal))
+                listeners.set(signal, new Set());
+            listeners.get(signal).add(listener);
+            return signalProcess;
+        },
+        off: (signal, listener) => {
+            const set = listeners.get(signal);
+            if (set) {
+                set.delete(listener);
+                if (set.size === 0)
+                    listeners.delete(signal);
+            }
+            return signalProcess;
+        },
+    };
+    const fire = (signal) => {
+        for (const listener of [...(listeners.get(signal) ?? [])]) {
+            listener(signal);
+        }
+    };
+    return { signalProcess, fire, listeners };
+}
+export function createBaseConfig() {
+    return {
+        name: "invoice-processor",
+        model: {
+            provider: "openai",
+            model: "gpt-5-mini",
+        },
+        prompt: {
+            system: "You are concise.",
+            variables: [],
+        },
+        sandbox: {
+            provider: "kubernetes",
+            timeout: 900,
+            resources: {
+                cpu: 2,
+                memory: "512MB",
+            },
+            kubernetes: {
+                image: "agent-bundle/execd:latest",
+            },
+        },
+        skills: [
+            {
+                path: "./skills/format-code",
+            },
+        ],
+    };
+}
+function createSandboxIO() {
+    return {
+        exec: async () => ({
+            stdout: "",
+            stderr: "",
+            exitCode: 0,
+        }),
+        spawn: async () => ({
+            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,
+        }),
+        file: {
+            read: async () => "",
+            write: async () => undefined,
+            list: async () => [],
+            delete: async () => undefined,
+        },
+    };
+}
+function createSkills() {
+    return [
+        {
+            name: "FormatCode",
+            description: "Format source files inside sandbox",
+            content: "---\nname: FormatCode\ndescription: Format source files inside sandbox\n---\n",
+            sourcePath: "/tmp/agent-bundle-workspace/skills/format-code/SKILL.md",
+        },
+    ];
+}
+function createApiServerMock() {
+    return vi.fn(() => {
+        return {
+            fetch: async (request) => {
+                void request;
+                return new Response("ok");
+            },
+        };
+    });
+}
+function createWebUIServerMockFactory(webUIShutdownMock) {
+    return vi.fn((input) => {
+        void input;
+        return {
+            app: {
+                fetch: async (request) => {
+                    void request;
+                    return new Response("ok");
+                },
+            },
+            eventBus: {
+                subscribe: () => () => undefined,
+                emit: () => undefined,
+                listenerCount: () => 0,
+                dispose: () => undefined,
+            },
+            handleUpgrade: () => undefined,
+            shutdown: webUIShutdownMock,
+        };
+    });
+}
+function createHttpServerStarterMock(closeServerMock) {
+    return vi.fn(async (input) => {
+        void input;
+        return {
+            port: 4310,
+            close: closeServerMock,
+        };
+    });
+}
+export function createServeHarness(options = {}) {
+    const config = options.config ?? createBaseConfig();
+    const env = options.env ?? {};
+    const callPostMountHook = options.callPostMountHook ?? true;
+    const sandboxIO = createSandboxIO();
+    const agentShutdownMock = vi.fn(async () => undefined);
+    const agent = {
+        name: config.name,
+        status: "ready",
+        respond: async () => ({
+            id: "resp-1",
+            output: "ok",
+            usage: {
+                inputTokens: 1,
+                outputTokens: 1,
+                totalTokens: 2,
+            },
+        }),
+        respondStream: async function* () {
+            return;
+        },
+        shutdown: agentShutdownMock,
+    };
+    const captured = {
+        agentConfig: null,
+        initOptions: null,
+    };
+    const loadConfigMock = vi.fn(async () => config);
+    const loadSkillsMock = vi.fn(async () => createSkills());
+    const generateSystemPromptMock = vi.fn(() => "generated-system-prompt");
+    const defineAgentMock = vi.fn((agentConfig) => {
+        captured.agentConfig = agentConfig;
+        return {
+            name: config.name,
+            init: async (initOptions) => {
+                captured.initOptions = initOptions;
+                if (callPostMountHook) {
+                    await initOptions.hooks?.postMount?.(sandboxIO);
+                }
+                return agent;
+            },
+        };
+    });
+    const createServerMock = createApiServerMock();
+    const webUIShutdownMock = vi.fn();
+    const createWebUIServerMock = createWebUIServerMockFactory(webUIShutdownMock);
+    const closeServerMock = vi.fn(async () => undefined);
+    const startHttpServerMock = createHttpServerStarterMock(closeServerMock);
+    return {
+        agent,
+        env,
+        captured,
+        loadConfigMock,
+        loadSkillsMock,
+        generateSystemPromptMock,
+        defineAgentMock,
+        createServerMock,
+        createWebUIServerMock,
+        startHttpServerMock,
+        closeServerMock,
+        webUIShutdownMock,
+        agentShutdownMock,
+    };
+}
+//# sourceMappingURL=serve.test-helpers.js.map