@a5c-ai/agent-runtime 5.0.1-staging.016f0b0e8119

package/dist/daemon/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * GAP-REMOTE-001: Daemon Mode — Type definitions.
+ */
+import type { AutomationRule, TimerAutomationRule, WebhookAutomationRule } from "@a5c-ai/agent-comm-mux";
+export interface DaemonConfig {
+    workspace: string;
+    triggers: TriggerConfig[];
+    maxConcurrentRuns?: number;
+}
+export interface FileTriggerConfig {
+    type: "file";
+    pattern: string;
+    processId: string;
+    entrypoint: string;
+    debounceMs?: number;
+}
+export type TriggerConfig = FileTriggerConfig | AutomationRule;
+export interface FileTriggerEvent {
+    type: "file";
+    processId: string;
+    entrypoint: string;
+    inputs?: Record<string, unknown>;
+}
+export interface AutomationTriggerEvent {
+    type: "automation";
+    rule: AutomationRule;
+    inputs?: Record<string, unknown>;
+}
+export type TriggerEvent = FileTriggerEvent | AutomationTriggerEvent;
+export declare function isFileTriggerConfig(trigger: TriggerConfig): trigger is FileTriggerConfig;
+export declare function isTimerAutomationRule(trigger: TriggerConfig): trigger is TimerAutomationRule;
+export declare function isWebhookAutomationRule(trigger: TriggerConfig): trigger is WebhookAutomationRule;
+export declare function isFileTriggerEvent(event: TriggerEvent): event is FileTriggerEvent;
+export declare function isAutomationTriggerEvent(event: TriggerEvent): event is AutomationTriggerEvent;
+export interface LegacyTriggerConfig {
+    type: "file" | "webhook" | "timer";
+    processId: string;
+    entrypoint: string;
+    pattern?: string;
+    port?: number;
+    cron?: string;
+    debounceMs?: number;
+}
+export interface DaemonStartOptions {
+    daemonDir: string;
+    workspace: string;
+    foreground?: boolean;
+    config?: DaemonConfig;
+}
+export interface DaemonStartOutput {
+    pid: number;
+    daemonDir: string;
+    startedAt: string;
+}
+export interface DaemonStopOptions {
+    daemonDir: string;
+    gracePeriodMs?: number;
+}
+export interface DaemonStopOutput {
+    pid: number;
+    stoppedAt: string;
+}
+export interface DaemonStatusOptions {
+    daemonDir: string;
+}
+export interface DaemonStatusOutput {
+    running: boolean;
+    pid?: number;
+    uptime?: number;
+    startedAt?: string;
+    activeTriggers?: number;
+    pendingRuns?: number;
+}
+export interface FileWatcherHandle {
+    dispose(): void;
+}
+export interface WebhookListenerOptions {
+    rule: WebhookAutomationRule;
+    onTrigger: TriggerCallback;
+}
+export interface WebhookListenerHandle {
+    close(): Promise<void>;
+    port: number;
+}
+export type TriggerCallback = (trigger: TriggerEvent) => void | Promise<void>;
+export interface DaemonMetadata {
+    workspace: string;
+    startedAt: string;
+    triggers: TriggerConfig[];
+    maxConcurrentRuns: number;
+    pid: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/daemon/types.d.ts.map

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

package/dist/daemon/types.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: Daemon Mode — Type definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFileTriggerConfig = isFileTriggerConfig;
+exports.isTimerAutomationRule = isTimerAutomationRule;
+exports.isWebhookAutomationRule = isWebhookAutomationRule;
+exports.isFileTriggerEvent = isFileTriggerEvent;
+exports.isAutomationTriggerEvent = isAutomationTriggerEvent;
+function isFileTriggerConfig(trigger) {
+    return "type" in trigger && trigger.type === "file";
+}
+function isTimerAutomationRule(trigger) {
+    return "trigger" in trigger && trigger.trigger.type === "timer";
+}
+function isWebhookAutomationRule(trigger) {
+    return "trigger" in trigger && trigger.trigger.type === "webhook";
+}
+function isFileTriggerEvent(event) {
+    return event.type !== "automation";
+}
+function isAutomationTriggerEvent(event) {
+    return event.type === "automation";
+}

package/dist/daemon/webhookListener.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GAP-REMOTE-001: Webhook Listener — HTTP trigger endpoint.
+ */
+import type { WebhookListenerOptions, WebhookListenerHandle } from "./types";
+export declare function createWebhookListener(options: WebhookListenerOptions): Promise<WebhookListenerHandle>;
+//# sourceMappingURL=webhookListener.d.ts.map

package/dist/daemon/webhookListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhookListener.d.ts","sourceRoot":"","sources":["../../src/daemon/webhookListener.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAI7E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA0EhC"}

package/dist/daemon/webhookListener.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: Webhook Listener — HTTP trigger endpoint.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebhookListener = createWebhookListener;
+const http = __importStar(require("node:http"));
+const MAX_BODY_BYTES = 1024 * 1024; // 1 MiB
+async function createWebhookListener(options) {
+    const { rule, onTrigger } = options;
+    const port = rule.trigger.port;
+    const path = rule.trigger.path ?? "/trigger";
+    const method = rule.trigger.method ?? "POST";
+    const authToken = rule.trigger.auth?.type === "bearer" ? rule.trigger.auth.token : undefined;
+    const server = http.createServer((req, res) => {
+        if (req.method !== method || req.url !== path) {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Not found" }));
+            return;
+        }
+        // Auth check
+        if (authToken) {
+            const authHeader = req.headers.authorization;
+            if (!authHeader || authHeader !== `Bearer ${authToken}`) {
+                res.writeHead(401, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Unauthorized" }));
+                return;
+            }
+        }
+        let body = "";
+        let bodySize = 0;
+        req.on("data", (chunk) => {
+            bodySize += chunk.length;
+            if (bodySize > MAX_BODY_BYTES) {
+                res.writeHead(413, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Payload too large" }));
+                req.destroy();
+                return;
+            }
+            body += chunk.toString();
+        });
+        req.on("end", () => {
+            try {
+                const payload = JSON.parse(body);
+                const inputs = typeof payload.inputs === "object" && payload.inputs !== null && !Array.isArray(payload.inputs)
+                    ? payload.inputs
+                    : undefined;
+                void onTrigger({
+                    type: "automation",
+                    rule,
+                    inputs,
+                });
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ ok: true }));
+            }
+            catch {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Invalid JSON body" }));
+            }
+        });
+    });
+    return new Promise((resolve, reject) => {
+        server.on("error", reject);
+        server.listen(port, () => {
+            const addr = server.address();
+            const actualPort = typeof addr === "object" && addr ? addr.port : port;
+            resolve({
+                port: actualPort,
+                async close() {
+                    return new Promise((res, rej) => {
+                        server.close((err) => (err ? rej(err) : res()));
+                    });
+                },
+            });
+        });
+    });
+}

package/dist/execution/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Execution module — execution mode abstraction interfaces and implementations.
+ */
+export type { ExecutionMode, LocalExecutionConfig, DockerExecutionConfig, SshExecutionConfig, KubernetesExecutionConfig, ExecutionConfig, ExecutionHandle, ExecutionProvider, } from "./types";
+export { LocalExecutor, DockerExecutor, SshExecutor, KubernetesExecutor, } from "./modes";
+export type { Executor, KubernetesExecutionHandle } from "./modes";
+export { ExecutionProviderImpl } from "./provider";
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionProviderImpl = exports.KubernetesExecutor = exports.SshExecutor = exports.DockerExecutor = exports.LocalExecutor = void 0;
+// Mode executors
+var modes_1 = require("./modes");
+Object.defineProperty(exports, "LocalExecutor", { enumerable: true, get: function () { return modes_1.LocalExecutor; } });
+Object.defineProperty(exports, "DockerExecutor", { enumerable: true, get: function () { return modes_1.DockerExecutor; } });
+Object.defineProperty(exports, "SshExecutor", { enumerable: true, get: function () { return modes_1.SshExecutor; } });
+Object.defineProperty(exports, "KubernetesExecutor", { enumerable: true, get: function () { return modes_1.KubernetesExecutor; } });
+// Provider
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "ExecutionProviderImpl", { enumerable: true, get: function () { return provider_1.ExecutionProviderImpl; } });

package/dist/execution/modes/docker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DockerExecutor — constructs `docker run` commands and spawns them
+ * via child_process.
+ *
+ * This is a structural stub: it correctly assembles the Docker CLI
+ * invocation from DockerExecutionConfig, but the host must have Docker
+ * installed and the daemon running for it to work at runtime.
+ */
+import type { ExecutionHandle, DockerExecutionConfig } from "../types";
+import type { Executor } from "./local";
+export declare class DockerExecutor implements Executor<DockerExecutionConfig> {
+    private readonly processes;
+    spawn(command: string, args: string[], config: DockerExecutionConfig): Promise<ExecutionHandle>;
+    attach(id: string): Promise<ExecutionHandle | undefined>;
+    list(): ExecutionHandle[];
+    destroy(id: string): Promise<void>;
+    /** Build the full `docker run` argument list. */
+    _buildDockerArgs(id: string, command: string, args: string[], config: DockerExecutionConfig): string[];
+    private _toPublicHandle;
+}
+//# sourceMappingURL=docker.d.ts.map

package/dist/execution/modes/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../src/execution/modes/docker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAsBxC,qBAAa,cAAe,YAAW,QAAQ,CAAC,qBAAqB,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAExD,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC;IA2BrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAM9D,IAAI,IAAI,eAAe,EAAE;IAInB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxC,iDAAiD;IACjD,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,qBAAqB,GAC5B,MAAM,EAAE;IA+BX,OAAO,CAAC,eAAe;CAyBxB"}

package/dist/execution/modes/docker.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * DockerExecutor — constructs `docker run` commands and spawns them
+ * via child_process.
+ *
+ * This is a structural stub: it correctly assembles the Docker CLI
+ * invocation from DockerExecutionConfig, but the host must have Docker
+ * installed and the daemon running for it to work at runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DockerExecutor = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+// ---------------------------------------------------------------------------
+// DockerExecutor
+// ---------------------------------------------------------------------------
+class DockerExecutor {
+    processes = new Map();
+    async spawn(command, args, config) {
+        const id = (0, node_crypto_1.randomUUID)();
+        const dockerArgs = this._buildDockerArgs(id, command, args, config);
+        const child = (0, node_child_process_1.spawn)("docker", dockerArgs, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const handle = {
+            id,
+            mode: "docker",
+            status: "running",
+        };
+        const entry = { handle, process: child, config };
+        this.processes.set(id, entry);
+        child.on("exit", (code) => {
+            handle.status = code === 0 ? "stopped" : "failed";
+        });
+        child.on("error", () => {
+            handle.status = "failed";
+        });
+        return this._toPublicHandle(entry);
+    }
+    async attach(id) {
+        const entry = this.processes.get(id);
+        if (!entry)
+            return undefined;
+        return this._toPublicHandle(entry);
+    }
+    list() {
+        return [...this.processes.values()].map((e) => this._toPublicHandle(e));
+    }
+    async destroy(id) {
+        const entry = this.processes.get(id);
+        if (!entry)
+            return;
+        // Attempt `docker stop` on the container (uses the handle id as name).
+        const child = entry.process;
+        if (!child.killed && child.exitCode === null) {
+            child.kill("SIGTERM");
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    if (!child.killed && child.exitCode === null) {
+                        child.kill("SIGKILL");
+                    }
+                    resolve();
+                }, 5_000);
+                child.on("exit", () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+        }
+        entry.handle.status = "stopped";
+        this.processes.delete(id);
+    }
+    // ---------- Helpers -------------------------------------------------------
+    /** Build the full `docker run` argument list. */
+    _buildDockerArgs(id, command, args, config) {
+        const dockerArgs = ["run", "--rm", "--name", `babysitter-${id.slice(0, 8)}`];
+        // Volume mounts.
+        if (config.volumes) {
+            for (const vol of config.volumes) {
+                dockerArgs.push("-v", vol);
+            }
+        }
+        // Network.
+        if (config.network) {
+            dockerArgs.push("--network", config.network);
+        }
+        // Environment variables.
+        if (config.env) {
+            for (const [key, value] of Object.entries(config.env)) {
+                dockerArgs.push("-e", `${key}=${value}`);
+            }
+        }
+        // Image.
+        dockerArgs.push(config.image);
+        // Command and arguments.
+        dockerArgs.push(command, ...args);
+        return dockerArgs;
+    }
+    _toPublicHandle(entry) {
+        const self = this;
+        return {
+            get id() {
+                return entry.handle.id;
+            },
+            get mode() {
+                return entry.handle.mode;
+            },
+            get status() {
+                return entry.handle.status;
+            },
+            async attach() {
+                if (entry.process.stdout) {
+                    entry.process.stdout.pipe(process.stdout, { end: false });
+                }
+                if (entry.process.stderr) {
+                    entry.process.stderr.pipe(process.stderr, { end: false });
+                }
+            },
+            async destroy() {
+                await self.destroy(entry.handle.id);
+            },
+        };
+    }
+}
+exports.DockerExecutor = DockerExecutor;

package/dist/execution/modes/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Execution mode implementations — barrel export.
+ */
+export { LocalExecutor } from "./local";
+export type { Executor } from "./local";
+export { DockerExecutor } from "./docker";
+export { SshExecutor } from "./ssh";
+export { KubernetesExecutor } from "./kubernetes";
+export type { KubernetesExecutionHandle } from "./kubernetes";
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/modes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/modes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/execution/modes/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Execution mode implementations — barrel export.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KubernetesExecutor = exports.SshExecutor = exports.DockerExecutor = exports.LocalExecutor = void 0;
+var local_1 = require("./local");
+Object.defineProperty(exports, "LocalExecutor", { enumerable: true, get: function () { return local_1.LocalExecutor; } });
+var docker_1 = require("./docker");
+Object.defineProperty(exports, "DockerExecutor", { enumerable: true, get: function () { return docker_1.DockerExecutor; } });
+var ssh_1 = require("./ssh");
+Object.defineProperty(exports, "SshExecutor", { enumerable: true, get: function () { return ssh_1.SshExecutor; } });
+var kubernetes_1 = require("./kubernetes");
+Object.defineProperty(exports, "KubernetesExecutor", { enumerable: true, get: function () { return kubernetes_1.KubernetesExecutor; } });

package/dist/execution/modes/kubernetes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * KubernetesExecutor — generates Kubernetes Job manifests from
+ * KubernetesExecutionConfig.
+ *
+ * This is a structural stub: it generates a valid Job YAML manifest and
+ * stores it on the handle. In production this would `kubectl apply` the
+ * manifest and poll for completion; here it creates a placeholder process
+ * to satisfy the handle contract.
+ */
+import type { ExecutionHandle, KubernetesExecutionConfig } from "../types";
+import type { Executor } from "./local";
+export interface KubernetesExecutionHandle extends ExecutionHandle {
+    readonly mode: "kubernetes";
+    /** The generated Kubernetes Job manifest (YAML string). */
+    readonly manifest: string;
+}
+export declare class KubernetesExecutor implements Executor<KubernetesExecutionConfig> {
+    private readonly entries;
+    spawn(command: string, args: string[], config: KubernetesExecutionConfig): Promise<KubernetesExecutionHandle>;
+    attach(id: string): Promise<KubernetesExecutionHandle | undefined>;
+    list(): KubernetesExecutionHandle[];
+    destroy(id: string): Promise<void>;
+    /** Build a Kubernetes Job manifest YAML. */
+    _buildManifest(jobName: string, command: string, args: string[], config: KubernetesExecutionConfig): string;
+    /** Render a resources block for the container spec. */
+    private _resourcesYaml;
+    private _toPublicHandle;
+}
+//# sourceMappingURL=kubernetes.d.ts.map

package/dist/execution/modes/kubernetes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes.d.ts","sourceRoot":"","sources":["../../../src/execution/modes/kubernetes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAuBxC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,kBAAmB,YAAW,QAAQ,CAAC,yBAAyB,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEjD,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,yBAAyB,CAAC;IAqB/B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAMxE,IAAI,IAAI,yBAAyB,EAAE;IAI7B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC,4CAA4C;IAC5C,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,yBAAyB,GAChC,MAAM;IAmCT,uDAAuD;IACvD,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,eAAe;CAwBxB"}

package/dist/execution/modes/kubernetes.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * KubernetesExecutor — generates Kubernetes Job manifests from
+ * KubernetesExecutionConfig.
+ *
+ * This is a structural stub: it generates a valid Job YAML manifest and
+ * stores it on the handle. In production this would `kubectl apply` the
+ * manifest and poll for completion; here it creates a placeholder process
+ * to satisfy the handle contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KubernetesExecutor = void 0;
+const node_crypto_1 = require("node:crypto");
+// ---------------------------------------------------------------------------
+// KubernetesExecutor
+// ---------------------------------------------------------------------------
+class KubernetesExecutor {
+    entries = new Map();
+    async spawn(command, args, config) {
+        const id = (0, node_crypto_1.randomUUID)();
+        const jobName = `babysitter-${id.slice(0, 8)}`;
+        const manifest = this._buildManifest(jobName, command, args, config);
+        const handle = {
+            id,
+            mode: "kubernetes",
+            status: "running",
+        };
+        const entry = { handle, config, manifest };
+        this.entries.set(id, entry);
+        // In production: kubectl apply -f - <<< manifest
+        // Stub: mark as running immediately.
+        return this._toPublicHandle(entry);
+    }
+    async attach(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return undefined;
+        return this._toPublicHandle(entry);
+    }
+    list() {
+        return [...this.entries.values()].map((e) => this._toPublicHandle(e));
+    }
+    async destroy(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return;
+        // In production: kubectl delete job <name> -n <namespace>
+        entry.handle.status = "stopped";
+        this.entries.delete(id);
+    }
+    // ---------- Manifest generation -------------------------------------------
+    /** Build a Kubernetes Job manifest YAML. */
+    _buildManifest(jobName, command, args, config) {
+        const resourceBlock = config.resources
+            ? this._resourcesYaml(config.resources)
+            : "";
+        const serviceAccountLine = config.serviceAccount
+            ? `      serviceAccountName: ${config.serviceAccount}\n`
+            : "";
+        const commandYaml = `          command: ${JSON.stringify([command, ...args])}`;
+        return [
+            `apiVersion: batch/v1`,
+            `kind: Job`,
+            `metadata:`,
+            `  name: ${jobName}`,
+            `  namespace: ${config.namespace}`,
+            `  labels:`,
+            `    app.kubernetes.io/managed-by: babysitter`,
+            `spec:`,
+            `  backoffLimit: 0`,
+            `  template:`,
+            `    spec:`,
+            serviceAccountLine ? serviceAccountLine.trimEnd() : null,
+            `      restartPolicy: Never`,
+            `      containers:`,
+            `        - name: main`,
+            `          image: ${config.image}`,
+            commandYaml,
+            resourceBlock || null,
+        ]
+            .filter((line) => line !== null)
+            .join("\n");
+    }
+    /** Render a resources block for the container spec. */
+    _resourcesYaml(resources) {
+        const lines = Object.entries(resources).map(([key, value]) => `              ${key}: "${value}"`);
+        return [
+            `          resources:`,
+            `            requests:`,
+            ...lines,
+            `            limits:`,
+            ...lines,
+        ].join("\n");
+    }
+    // ---------- Handle --------------------------------------------------------
+    _toPublicHandle(entry) {
+        const self = this;
+        return {
+            get id() {
+                return entry.handle.id;
+            },
+            get mode() {
+                return entry.handle.mode;
+            },
+            get status() {
+                return entry.handle.status;
+            },
+            get manifest() {
+                return entry.manifest;
+            },
+            async attach() {
+                // In production: kubectl logs -f job/<name> -n <namespace>
+                // Stub: no-op.
+            },
+            async destroy() {
+                await self.destroy(entry.handle.id);
+            },
+        };
+    }
+}
+exports.KubernetesExecutor = KubernetesExecutor;

package/dist/execution/modes/local.d.ts

@@ -0,0 +1,23 @@
+/**
+ * LocalExecutor — spawns processes on the host machine via child_process.
+ *
+ * This is the fully-functional executor: it creates real child processes,
+ * tracks them by handle ID, and supports attach (reconnect to streams)
+ * and destroy (kill process) operations.
+ */
+import type { ExecutionHandle, LocalExecutionConfig } from "../types";
+export interface Executor<C> {
+    spawn(command: string, args: string[], config: C): Promise<ExecutionHandle>;
+    attach(id: string): Promise<ExecutionHandle | undefined>;
+    list(): ExecutionHandle[];
+    destroy(id: string): Promise<void>;
+}
+export declare class LocalExecutor implements Executor<LocalExecutionConfig> {
+    private readonly processes;
+    spawn(command: string, args: string[], config: LocalExecutionConfig): Promise<ExecutionHandle>;
+    attach(id: string): Promise<ExecutionHandle | undefined>;
+    list(): ExecutionHandle[];
+    destroy(id: string): Promise<void>;
+    private _toPublicHandle;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/execution/modes/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/execution/modes/local.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAsBlB,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IACzD,IAAI,IAAI,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD,qBAAa,aAAc,YAAW,QAAQ,CAAC,oBAAoB,CAAC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAEvD,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC;IA6BrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAM9D,IAAI,IAAI,eAAe,EAAE;IAInB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxC,OAAO,CAAC,eAAe;CA0BxB"}