agent-bundle 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.test-helpers.js","sourceRoot":"","sources":["../../../src/cli/serve/serve.test-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AA6B5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAEnF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IACzD,MAAM,aAAa,GAAG;QACpB,EAAE,EAAE,CAAC,MAAc,EAAE,QAAwB,EAAE,EAAE;YAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC7D,SAAS,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,CAAC,MAAc,EAAE,QAAwB,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;oBAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,aAAa,CAAC;QACvB,CAAC;KAC+C,CAAC;IAEnD,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,EAAE;QAC9B,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1D,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,YAAY;SACpB;QACD,MAAM,EAAE;YACN,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,EAAE;SACd;QACD,OAAO,EAAE;YACP,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE;gBACT,GAAG,EAAE,CAAC;gBACN,MAAM,EAAE,OAAO;aAChB;YACD,UAAU,EAAE;gBACV,KAAK,EAAE,2BAA2B;aACnC;SACF;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,sBAAsB;aAC7B;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC;SACZ,CAAC;QACF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAClB,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,IAAI,cAAc,CAAa;gBACpC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;aAC7B,CAAC;YACF,MAAM,EAAE,IAAI,cAAc,CAAa;gBACrC,KAAK,CAAC,UAAU;oBACd,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC;YACF,MAAM,EAAE,IAAI,cAAc,CAAa;gBACrC,KAAK,CAAC,UAAU;oBACd,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC;YACF,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;SAC5B,CAAC;QACF,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACpB,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;YAC5B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACpB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;SAC9B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;QACL;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,+EAA+E;YACxF,UAAU,EAAE,yDAAyD;SACtE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE;QAChB,OAAO;YACL,KAAK,EAAE,KAAK,EAAE,OAAgB,EAAE,EAAE;gBAChC,KAAK,OAAO,CAAC;gBACb,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CACnC,iBAA2C;IAE3C,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9B,KAAK,KAAK,CAAC;QACX,OAAO;YACL,GAAG,EAAE;gBACH,KAAK,EAAE,KAAK,EAAE,OAAgB,EAAE,EAAE;oBAChC,KAAK,OAAO,CAAC;oBACb,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC5B,CAAC;aACF;YACD,QAAQ,EAAE;gBACR,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS;gBAChC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;gBACrB,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;gBACtB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;aACzB;YACD,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS;YAC9B,QAAQ,EAAE,iBAAiB;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAClC,eAAyC;IAEzC,OAAO,EAAE,CAAC,EAAE,CACV,KAAK,EAAE,KAA2B,EAA8B,EAAE;QAChE,KAAK,KAAK,CAAC;QACX,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,eAAe;SACvB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC9B,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;IAC5D,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,KAAK,GAAU;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACpB,EAAE,EAAE,QAAQ;YACZ,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE;gBACL,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;aACf;SACF,CAAC;QACF,aAAa,EAAE,KAAK,SAAS,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IAEF,MAAM,QAAQ,GAA6B;QACzC,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;KAClB,CAAC;IAEF,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;IACzD,MAAM,wBAAwB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,WAAgC,EAAwB,EAAE;QACvF,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,KAAK,EAAE,WAAgC,EAAE,EAAE;gBAC/C,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;gBACnC,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;gBAClD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;IAC/C,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAClC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IAE9E,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAEzE,OAAO;QACL,KAAK;QACL,GAAG;QACH,QAAQ;QACR,cAAc;QACd,cAAc;QACd,wBAAwB;QACxB,eAAe;QACf,gBAAgB;QAChB,qBAAqB;QACrB,mBAAmB;QACnB,eAAe;QACf,iBAAiB;QACjB,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/cli/serve/worktree-port.d.ts

@@ -0,0 +1,36 @@
+export type WorktreePortResult = {
+    port: number;
+    worktreeName: string;
+};
+/**
+ * Resolve a deterministic port for the current worktree.
+ * Returns null when not running inside a worktree.
+ *
+ * Port formula: basePort + (fnv1a(worktreeName) % 99 + 1) * 10
+ * This yields offsets 10..990 in steps of 10, giving each worktree
+ * a block of 10 ports (e.g. 3010-3019, 3140-3149).
+ *
+ * @deprecated Use {@link resolveServicePort} for new code.
+ */
+export declare function resolveWorktreePort(basePort: number, cwd?: string): WorktreePortResult | null;
+/**
+ * Check whether a TCP port is available on localhost.
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Compute a service port: `prefix × 1000 + suffix`.
+ *
+ * - **suffix** (last three digits): stable service identity
+ *   (0 = serve/dev, 1 = code-formatter/e2b, 2 = code-formatter/k8s, 3 = financial-plugin, 5 = personalized-recommend, 6 = observability-demo, …).
+ * - **prefix**: `defaultPrefix` (3) for the main repo,
+ *   hash-based 10–63 for worktrees.
+ *
+ * Priority:
+ * 1. `PORT` env var → returned directly.
+ * 2. Auto-computed `prefix × 1000 + suffix`, with collision
+ *    fallback that rotates the prefix (never the suffix).
+ */
+export declare function resolveServicePort(suffix: number, options?: {
+    defaultPrefix?: number;
+    cwd?: string;
+}): Promise<number>;

package/dist/cli/serve/worktree-port.js

@@ -0,0 +1,124 @@
+import { readFileSync, statSync } from "node:fs";
+import { createServer } from "node:net";
+import { basename, resolve } from "node:path";
+/**
+ * FNV-1a 32-bit hash for deterministic port offset computation.
+ */
+function fnv1a32(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+/**
+ * Detect if cwd is inside a Git worktree (not the main repo).
+ * Walks up parent directories to find the nearest `.git` entry.
+ * In a worktree the `.git` path is a file containing `gitdir: <path>`,
+ * whereas in the main repo `.git` is a directory.
+ * Returns the worktree root directory basename, or null if not a worktree.
+ */
+function detectWorktreeName(cwd) {
+    let dir = resolve(cwd);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const dotGitPath = resolve(dir, ".git");
+        try {
+            const stat = statSync(dotGitPath);
+            if (stat.isDirectory()) {
+                return null; // main repo root
+            }
+            // .git is a file — check if it's a worktree pointer
+            const content = readFileSync(dotGitPath, "utf-8").trim();
+            if (content.startsWith("gitdir:")) {
+                return basename(dir);
+            }
+            return null;
+        }
+        catch {
+            // no .git here, try parent
+        }
+        const parent = resolve(dir, "..");
+        if (parent === dir) {
+            return null; // reached filesystem root
+        }
+        dir = parent;
+    }
+}
+/**
+ * Resolve a deterministic port for the current worktree.
+ * Returns null when not running inside a worktree.
+ *
+ * Port formula: basePort + (fnv1a(worktreeName) % 99 + 1) * 10
+ * This yields offsets 10..990 in steps of 10, giving each worktree
+ * a block of 10 ports (e.g. 3010-3019, 3140-3149).
+ *
+ * @deprecated Use {@link resolveServicePort} for new code.
+ */
+export function resolveWorktreePort(basePort, cwd = process.cwd()) {
+    const name = detectWorktreeName(cwd);
+    if (!name) {
+        return null;
+    }
+    const offset = (fnv1a32(name) % 99 + 1) * 10;
+    return { port: basePort + offset, worktreeName: name };
+}
+// ── Service port allocation (prefix × 1000 + suffix) ────────────
+const MIN_WORKTREE_PREFIX = 10;
+const PREFIX_COUNT = 54; // prefixes 10–63
+/**
+ * Check whether a TCP port is available on localhost.
+ */
+export async function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once("error", () => resolve(false));
+        server.once("listening", () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+/**
+ * Compute a service port: `prefix × 1000 + suffix`.
+ *
+ * - **suffix** (last three digits): stable service identity
+ *   (0 = serve/dev, 1 = code-formatter/e2b, 2 = code-formatter/k8s, 3 = financial-plugin, 5 = personalized-recommend, 6 = observability-demo, …).
+ * - **prefix**: `defaultPrefix` (3) for the main repo,
+ *   hash-based 10–63 for worktrees.
+ *
+ * Priority:
+ * 1. `PORT` env var → returned directly.
+ * 2. Auto-computed `prefix × 1000 + suffix`, with collision
+ *    fallback that rotates the prefix (never the suffix).
+ */
+export async function resolveServicePort(suffix, options) {
+    const envPort = process.env.PORT;
+    if (envPort !== undefined && envPort !== "") {
+        return Number(envPort);
+    }
+    const defaultPrefix = options?.defaultPrefix ?? 3;
+    const cwd = options?.cwd ?? process.cwd();
+    const worktreeName = detectWorktreeName(cwd);
+    if (!worktreeName) {
+        const preferred = defaultPrefix * 1000 + suffix;
+        if (await isPortAvailable(preferred))
+            return preferred;
+        for (let i = 0; i < PREFIX_COUNT; i++) {
+            const candidate = (MIN_WORKTREE_PREFIX + i) * 1000 + suffix;
+            if (await isPortAvailable(candidate))
+                return candidate;
+        }
+        throw new Error(`No available port found for suffix ${suffix}`);
+    }
+    const base = MIN_WORKTREE_PREFIX + (fnv1a32(worktreeName) % PREFIX_COUNT);
+    for (let i = 0; i < PREFIX_COUNT; i++) {
+        const p = MIN_WORKTREE_PREFIX + ((base - MIN_WORKTREE_PREFIX + i) % PREFIX_COUNT);
+        const candidate = p * 1000 + suffix;
+        if (await isPortAvailable(candidate))
+            return candidate;
+    }
+    throw new Error(`No available port found for suffix ${suffix}`);
+}
+//# sourceMappingURL=worktree-port.js.map

package/dist/cli/serve/worktree-port.js.map

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

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

@@ -0,0 +1,12 @@
+import { type IncomingMessage } from "node:http";
+export type StartHttpServerInput = {
+    appFetch: (request: Request) => Response | Promise<Response>;
+    handleUpgrade: (request: IncomingMessage, socket: unknown, head: Buffer) => void;
+    port: number;
+    stderr: NodeJS.WritableStream;
+};
+export type StartedHttpServer = {
+    port: number;
+    close: () => Promise<void>;
+};
+export declare function startHttpServer(input: StartHttpServerInput): Promise<StartedHttpServer>;

package/dist/cli/serve-http.js

@@ -0,0 +1,112 @@
+import { createServer as createHttpServer, } from "node:http";
+import { toErrorMessage } from "./error.js";
+function hasRequestBody(method) {
+    return method !== undefined && method !== "GET" && method !== "HEAD";
+}
+function toFetchRequest(request) {
+    const origin = typeof request.headers.host === "string"
+        ? `http://${request.headers.host}`
+        : "http://127.0.0.1";
+    const url = new URL(request.url ?? "/", origin);
+    const headers = new Headers();
+    Object.entries(request.headers).forEach(([name, value]) => {
+        if (typeof value === "string") {
+            headers.set(name, value);
+            return;
+        }
+        if (Array.isArray(value)) {
+            value.forEach((entry) => {
+                headers.append(name, entry);
+            });
+        }
+    });
+    const init = {
+        method: request.method,
+        headers,
+    };
+    if (hasRequestBody(request.method)) {
+        init.body = request;
+        init.duplex = "half";
+    }
+    return new Request(url, init);
+}
+async function writeFetchResponse(response, output) {
+    response.headers.forEach((value, key) => {
+        output.setHeader(key, value);
+    });
+    output.statusCode = response.status;
+    if (!response.body) {
+        output.end();
+        return;
+    }
+    const reader = response.body.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        if (value) {
+            output.write(Buffer.from(value));
+        }
+    }
+    output.end();
+}
+async function closeNodeServer(server) {
+    await new Promise((resolveClose, rejectClose) => {
+        server.close((error) => {
+            if (!error) {
+                resolveClose();
+                return;
+            }
+            const nodeError = error;
+            if (nodeError.code === "ERR_SERVER_NOT_RUNNING") {
+                resolveClose();
+                return;
+            }
+            rejectClose(error);
+        });
+    });
+}
+export async function startHttpServer(input) {
+    const server = createHttpServer((request, response) => {
+        const fetchRequest = toFetchRequest(request);
+        void Promise.resolve(input.appFetch(fetchRequest))
+            .then(async (fetchResponse) => {
+            await writeFetchResponse(fetchResponse, response);
+        })
+            .catch((error) => {
+            input.stderr.write(`[serve] request handling failed: ${toErrorMessage(error)}\n`);
+            if (!response.headersSent) {
+                response.statusCode = 500;
+                response.setHeader("content-type", "text/plain; charset=utf-8");
+            }
+            response.end("Internal Server Error");
+        });
+    });
+    server.on("upgrade", input.handleUpgrade);
+    await new Promise((resolveListen, rejectListen) => {
+        const onError = (error) => {
+            server.off("listening", onListening);
+            rejectListen(error);
+        };
+        const onListening = () => {
+            server.off("error", onError);
+            resolveListen();
+        };
+        server.once("error", onError);
+        server.once("listening", onListening);
+        server.listen(input.port);
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        await closeNodeServer(server);
+        throw new Error("Failed to resolve serve port from HTTP server address.");
+    }
+    return {
+        port: address.port,
+        close: async () => {
+            await closeNodeServer(server);
+        },
+    };
+}
+//# sourceMappingURL=serve-http.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { generateSystemPromptTemplate } from "../agent-loop/system-prompt/generate.js";
+import type { McpServerConfig } from "../agent/types.js";
+import type { BundleConfig } from "../schema/bundle.js";
+import { loadAllSkills } from "../skills/loader.js";
+import { loadBundleConfig } from "./load-bundle-config.js";
+export type KeyValueArgInput = string | string[] | boolean | undefined;
+export type ResolvedServeInputs = {
+    configPath: string;
+    config: BundleConfig;
+    systemPrompt: string;
+};
+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): Promise<ResolvedServeInputs>;

package/dist/cli/serve-runtime.js

@@ -0,0 +1,122 @@
+import { dirname, resolve } from "node:path";
+import { generateSystemPromptTemplate } from "../agent-loop/system-prompt/generate.js";
+import { loadAllSkills } from "../skills/loader.js";
+import { toSkillSummaries } from "../skills/summaries.js";
+import { loadBundleConfig } from "./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) {
+    const absoluteConfigPath = resolve(configPath);
+    const config = await loadConfigImpl(absoluteConfigPath);
+    const bundleDir = dirname(absoluteConfigPath);
+    const skills = await loadSkillsImpl(config.skills, bundleDir);
+    const systemPrompt = generateSystemPromptImpl({
+        basePrompt: config.prompt.system,
+        skills: toSkillSummaries(skills),
+    });
+    return {
+        configPath: absoluteConfigPath,
+        config,
+        systemPrompt,
+    };
+}
+//# sourceMappingURL=serve-runtime.js.map

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

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

package/dist/cli/serve.d.ts

@@ -0,0 +1,33 @@
+import type { AgentConfig, AgentFactory } from "../agent/types.js";
+import { serveTUI } from "../tui/tui.js";
+import { createWebUIServer } from "../webui/create-webui-server.js";
+import { resolveServeInputs, type KeyValueArgInput } from "./serve-runtime.js";
+import { type StartedHttpServer, type StartHttpServerInput } from "./serve-http.js";
+export declare const DEFAULT_SERVE_PORT = 3000;
+type DefineAgentForServe = (config: AgentConfig<string>) => AgentFactory<string>;
+type ServeDependencies = {
+    defineAgentImpl?: DefineAgentForServe;
+    createWebUIServerImpl?: typeof createWebUIServer;
+    startHttpServerImpl?: (input: StartHttpServerInput) => Promise<StartedHttpServer>;
+    serveTUIImpl?: typeof serveTUI;
+    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 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 runServeCommand(options: RunServeOptions, dependencies?: ServeDependencies): Promise<RunServeResult>;
+export {};

package/dist/cli/serve.js

@@ -0,0 +1,150 @@
+import { defineAgent } from "../agent/define-agent.js";
+import { serveTUI } from "../tui/tui.js";
+import { createWebUIServer } from "../webui/create-webui-server.js";
+import { toErrorMessage } from "./error.js";
+import { parseKeyValueEntries, resolveInitVariables, resolveMcpTokens, resolveServeInputs, resolveServeSandboxConfig, } from "./serve-runtime.js";
+import { startHttpServer } from "./serve-http.js";
+export const DEFAULT_SERVE_PORT = 3000;
+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.");
+    }
+}
+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);
+        },
+        file: sandboxIO.file,
+    };
+}
+async function shutdownServeResources(resources) {
+    const errors = [];
+    try {
+        await resources.httpServer?.close();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        resources.webUI?.shutdown();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        await resources.agent.shutdown();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    if (errors.length > 0) {
+        throw errors[0];
+    }
+}
+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 } = 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),
+    };
+}
+export async function runServeCommand(options, dependencies = {}) {
+    const createWebUIServerImpl = dependencies.createWebUIServerImpl ?? createWebUIServer;
+    const startHttpServerImpl = dependencies.startHttpServerImpl ?? startHttpServer;
+    const serveTUIImpl = dependencies.serveTUIImpl ?? serveTUI;
+    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 stdin = options.stdin ?? process.stdin;
+    const port = options.port ?? DEFAULT_SERVE_PORT;
+    validatePort(port);
+    const context = await initializeServeContext(options, dependencies);
+    stdout.write(`Starting bundle "${context.config.name}" from ${context.configPath}\n`);
+    let webUI = null;
+    let httpServer = null;
+    let shutdownPromise = null;
+    const shutdown = async () => {
+        if (!shutdownPromise) {
+            shutdownPromise = shutdownServeResources({ agent: context.agent, webUI, httpServer });
+        }
+        return await shutdownPromise;
+    };
+    const onSignal = (signal) => {
+        void shutdown()
+            .then(() => exit(0))
+            .catch((error) => {
+            stderr.write(`[serve] failed to shutdown on ${signal}: ${toErrorMessage(error)}\n`);
+            exit(1);
+        });
+    };
+    signalProcess.on("SIGINT", onSignal);
+    signalProcess.on("SIGTERM", onSignal);
+    try {
+        webUI = createWebUIServerImpl({ agent: context.agent, sandbox: context.webUISandbox });
+        httpServer = await startHttpServerImpl({
+            appFetch: webUI.app.fetch.bind(webUI.app),
+            handleUpgrade: webUI.handleUpgrade,
+            port,
+            stderr,
+        });
+        stdout.write(`Serve ready at http://localhost:${httpServer.port}\n`);
+        await serveTUIImpl(context.agent, { input: stdin, output: stdout });
+    }
+    finally {
+        signalProcess.off("SIGINT", onSignal);
+        signalProcess.off("SIGTERM", onSignal);
+        await shutdown();
+    }
+    if (!httpServer) {
+        throw new Error("Serve HTTP server did not start.");
+    }
+    return { port: httpServer.port };
+}
+//# sourceMappingURL=serve.js.map