@runcore-sh/runcore 0.1.2

package/dist/agents/runtime/bus.js

@@ -0,0 +1,174 @@
+/**
+ * Agent Runtime Environment — Inter-agent event bus.
+ *
+ * EventEmitter-based pub/sub with typed events, message routing,
+ * and request/response correlation patterns.
+ */
+import { EventEmitter } from "node:events";
+import { randomBytes } from "node:crypto";
+export class RuntimeBus {
+    emitter = new EventEmitter();
+    /** Pending request/response callbacks keyed by correlationId. */
+    pendingRequests = new Map();
+    /** Per-agent message subscriptions. */
+    agentSubscriptions = new Map();
+    constructor() {
+        // Prevent memory leak warnings for many agent listeners
+        this.emitter.setMaxListeners(200);
+    }
+    // -------------------------------------------------------------------------
+    // Typed pub/sub for runtime events
+    // -------------------------------------------------------------------------
+    on(event, handler) {
+        this.emitter.on(event, handler);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    once(event, handler) {
+        this.emitter.once(event, handler);
+    }
+    emit(event, data) {
+        this.emitter.emit(event, data);
+    }
+    // -------------------------------------------------------------------------
+    // Inter-agent messaging
+    // -------------------------------------------------------------------------
+    /** Send a message to a specific agent or broadcast to all. */
+    send(message) {
+        const full = {
+            ...message,
+            id: generateMessageId(),
+            timestamp: new Date().toISOString(),
+        };
+        // Check if this is a response to a pending request
+        if (full.correlationId && this.pendingRequests.has(full.correlationId)) {
+            const pending = this.pendingRequests.get(full.correlationId);
+            this.pendingRequests.delete(full.correlationId);
+            clearTimeout(pending.timer);
+            pending.resolve(full);
+        }
+        // Emit on the bus for listeners
+        this.emit("agent:message", full);
+        return full;
+    }
+    /**
+     * Send a request and wait for a correlated response.
+     * Times out after timeoutMs (default 30s).
+     */
+    request(message, timeoutMs = 30_000) {
+        const correlationId = generateMessageId();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(correlationId);
+                reject(new Error(`Request to ${message.to} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pendingRequests.set(correlationId, { resolve, reject, timer });
+            // Emit the outbound request directly instead of using send() to avoid
+            // send()'s correlationId check resolving the pending request immediately
+            const outbound = {
+                ...message,
+                correlationId,
+                id: generateMessageId(),
+                timestamp: new Date().toISOString(),
+            };
+            this.emit("agent:message", outbound);
+        });
+    }
+    /**
+     * Subscribe an agent to receive messages. When a message is sent to
+     * this agent's ID (or broadcast to "*"), the handler is called.
+     */
+    subscribe(agentId, handler) {
+        if (!this.agentSubscriptions.has(agentId)) {
+            this.agentSubscriptions.set(agentId, new Set());
+        }
+        const wrappedHandler = (msg) => {
+            if (msg.to === agentId || msg.to === "*") {
+                // Skip expired messages
+                if (msg.ttlMs) {
+                    const age = Date.now() - new Date(msg.timestamp).getTime();
+                    if (age > msg.ttlMs)
+                        return;
+                }
+                handler(msg);
+            }
+        };
+        // Store a key for the handler so we can clean up
+        const handlerKey = `msg:${agentId}`;
+        this.emitter.on(handlerKey, wrappedHandler);
+        this.agentSubscriptions.get(agentId).add(handlerKey);
+        // Also listen to the global agent:message topic for routing
+        const globalHandler = (msg) => {
+            if (msg.to === agentId || msg.to === "*") {
+                if (msg.ttlMs) {
+                    const age = Date.now() - new Date(msg.timestamp).getTime();
+                    if (age > msg.ttlMs)
+                        return;
+                }
+                handler(msg);
+            }
+        };
+        this.emitter.on("agent:message", globalHandler);
+        // Store cleanup ref
+        this.agentSubscriptions.get(agentId).add(`cleanup:${agentId}:${Date.now()}`);
+        // Store actual handler ref for cleanup
+        this._globalHandlers.set(agentId, globalHandler);
+    }
+    // Store global handlers for cleanup
+    _globalHandlers = new Map();
+    /** Unsubscribe an agent from all messages. */
+    unsubscribe(agentId) {
+        const handler = this._globalHandlers.get(agentId);
+        if (handler) {
+            this.emitter.off("agent:message", handler);
+            this._globalHandlers.delete(agentId);
+        }
+        this.agentSubscriptions.delete(agentId);
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle event helpers
+    // -------------------------------------------------------------------------
+    emitLifecycle(event) {
+        this.emit("agent:lifecycle", event);
+    }
+    emitError(agentId, error) {
+        this.emit("agent:error", { agentId, error });
+    }
+    emitSpawned(agentId, pid) {
+        this.emit("agent:spawned", { agentId, pid });
+    }
+    emitCompleted(agentId, exitCode) {
+        this.emit("agent:completed", { agentId, exitCode });
+    }
+    emitFailed(agentId, error) {
+        this.emit("agent:failed", { agentId, error });
+    }
+    emitResourceWarning(usage) {
+        this.emit("runtime:resource-warning", { usage });
+    }
+    emitShutdown(reason) {
+        this.emit("runtime:shutdown", { reason });
+    }
+    // -------------------------------------------------------------------------
+    // Cleanup
+    // -------------------------------------------------------------------------
+    /** Clear all listeners and pending requests. For shutdown. */
+    destroy() {
+        for (const [, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error("Bus destroyed"));
+        }
+        this.pendingRequests.clear();
+        this._globalHandlers.clear();
+        this.agentSubscriptions.clear();
+        this.emitter.removeAllListeners();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function generateMessageId() {
+    return `msg_${Date.now()}_${randomBytes(4).toString("hex")}`;
+}
+//# sourceMappingURL=bus.js.map

package/dist/agents/runtime/bus.js.map

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

package/dist/agents/runtime/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Agent Runtime Environment — Configuration.
+ *
+ * Loads defaults, merges env var overrides, produces a frozen RuntimeConfig.
+ * Environment variables use the CORE_RUNTIME_ prefix (DASH_RUNTIME_ also supported).
+ */
+import type { RuntimeConfig, AgentInstanceConfig, ResourceAllocation } from "./types.js";
+/** Build RuntimeConfig from defaults + env var overrides. */
+export declare function loadRuntimeConfig(overrides?: Partial<RuntimeConfig>): RuntimeConfig;
+/** Build per-instance config by merging runtime defaults with request overrides. */
+export declare function resolveInstanceConfig(runtimeConfig: RuntimeConfig, overrides?: Partial<AgentInstanceConfig>): AgentInstanceConfig;
+/** Build resource allocation from runtime defaults with request overrides. */
+export declare function resolveResources(runtimeConfig: RuntimeConfig, overrides?: Partial<ResourceAllocation>): ResourceAllocation;
+//# sourceMappingURL=config.d.ts.map

package/dist/agents/runtime/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuCzF,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CA2DnF;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACvC,mBAAmB,CAWrB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACtC,kBAAkB,CAKpB"}

package/dist/agents/runtime/config.js

@@ -0,0 +1,100 @@
+/**
+ * Agent Runtime Environment — Configuration.
+ *
+ * Loads defaults, merges env var overrides, produces a frozen RuntimeConfig.
+ * Environment variables use the CORE_RUNTIME_ prefix (DASH_RUNTIME_ also supported).
+ */
+import { join } from "node:path";
+import { resolveEnv } from "../../instance.js";
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULTS = {
+    maxConcurrentAgents: 5,
+    defaultTimeoutMs: 10 * 60 * 1000, // 10 minutes
+    defaultMaxRetries: 2,
+    defaultBackoffMs: 2_000,
+    defaultBackoffMultiplier: 2,
+    defaultMaxBackoffMs: 30_000,
+    maxTotalMemoryMB: 2048, // 2 GB aggregate cap
+    defaultMemoryLimitMB: 512,
+    defaultCpuWeight: 50,
+    monitorIntervalMs: 10_000, // 10 seconds
+    persistDir: join(process.cwd(), "brain", "agents", "runtime"),
+};
+// ---------------------------------------------------------------------------
+// Env var resolver
+// ---------------------------------------------------------------------------
+function envInt(suffix) {
+    const v = resolveEnv(suffix);
+    if (v == null)
+        return undefined;
+    const n = parseInt(v, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+function envStr(suffix) {
+    return resolveEnv(suffix) || undefined;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Build RuntimeConfig from defaults + env var overrides. */
+export function loadRuntimeConfig(overrides) {
+    const config = {
+        maxConcurrentAgents: overrides?.maxConcurrentAgents ??
+            envInt("RUNTIME_MAX_AGENTS") ??
+            DEFAULTS.maxConcurrentAgents,
+        defaultTimeoutMs: overrides?.defaultTimeoutMs ??
+            envInt("RUNTIME_TIMEOUT_MS") ??
+            DEFAULTS.defaultTimeoutMs,
+        defaultMaxRetries: overrides?.defaultMaxRetries ??
+            envInt("RUNTIME_MAX_RETRIES") ??
+            DEFAULTS.defaultMaxRetries,
+        defaultBackoffMs: overrides?.defaultBackoffMs ??
+            envInt("RUNTIME_BACKOFF_MS") ??
+            DEFAULTS.defaultBackoffMs,
+        defaultBackoffMultiplier: overrides?.defaultBackoffMultiplier ??
+            envInt("RUNTIME_BACKOFF_MULT") ??
+            DEFAULTS.defaultBackoffMultiplier,
+        defaultMaxBackoffMs: overrides?.defaultMaxBackoffMs ??
+            envInt("RUNTIME_MAX_BACKOFF_MS") ??
+            DEFAULTS.defaultMaxBackoffMs,
+        maxTotalMemoryMB: overrides?.maxTotalMemoryMB ??
+            envInt("RUNTIME_MAX_MEMORY_MB") ??
+            DEFAULTS.maxTotalMemoryMB,
+        defaultMemoryLimitMB: overrides?.defaultMemoryLimitMB ??
+            envInt("RUNTIME_DEFAULT_MEM_MB") ??
+            DEFAULTS.defaultMemoryLimitMB,
+        defaultCpuWeight: overrides?.defaultCpuWeight ??
+            envInt("RUNTIME_DEFAULT_CPU") ??
+            DEFAULTS.defaultCpuWeight,
+        monitorIntervalMs: overrides?.monitorIntervalMs ??
+            envInt("RUNTIME_MONITOR_MS") ??
+            DEFAULTS.monitorIntervalMs,
+        persistDir: overrides?.persistDir ??
+            envStr("RUNTIME_PERSIST_DIR") ??
+            DEFAULTS.persistDir,
+    };
+    return Object.freeze(config);
+}
+/** Build per-instance config by merging runtime defaults with request overrides. */
+export function resolveInstanceConfig(runtimeConfig, overrides) {
+    return {
+        timeoutMs: overrides?.timeoutMs ?? runtimeConfig.defaultTimeoutMs,
+        maxRetries: overrides?.maxRetries ?? runtimeConfig.defaultMaxRetries,
+        backoffMs: overrides?.backoffMs ?? runtimeConfig.defaultBackoffMs,
+        backoffMultiplier: overrides?.backoffMultiplier ?? runtimeConfig.defaultBackoffMultiplier,
+        maxBackoffMs: overrides?.maxBackoffMs ?? runtimeConfig.defaultMaxBackoffMs,
+        env: overrides?.env ?? {},
+        isolation: overrides?.isolation ?? "shared",
+        priority: overrides?.priority ?? 50,
+    };
+}
+/** Build resource allocation from runtime defaults with request overrides. */
+export function resolveResources(runtimeConfig, overrides) {
+    return {
+        memoryLimitMB: overrides?.memoryLimitMB ?? runtimeConfig.defaultMemoryLimitMB,
+        cpuWeight: overrides?.cpuWeight ?? runtimeConfig.defaultCpuWeight,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/agents/runtime/config.js.map

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

package/dist/agents/runtime/driver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Agent Runtime Environment — Claude CLI agent driver.
+ *
+ * Implements the AgentDriver interface using the existing Core agent
+ * spawn machinery. This bridges the new runtime layer with the proven
+ * process spawning in src/agents/spawn.ts.
+ */
+import { type ChildProcess } from "node:child_process";
+import type { AgentDriver, AgentInstance } from "./types.js";
+export declare class ClaudeCliDriver implements AgentDriver {
+    readonly name = "claude-cli";
+    /** Register a callback for when a process exits. */
+    onExit(instanceId: string, handler: (code: number | null) => void): void;
+    spawn(instance: AgentInstance): Promise<number | undefined>;
+    pause(instance: AgentInstance): Promise<string | undefined>;
+    resume(instance: AgentInstance, checkpoint?: string): Promise<number | undefined>;
+    terminate(instance: AgentInstance): Promise<void>;
+    isAlive(instance: AgentInstance): boolean;
+    private resolvePrompt;
+    /** Get the process for an instance (for monitoring). */
+    getProcess(instanceId: string): ChildProcess | undefined;
+    /** Get all tracked instance IDs. */
+    getActiveIds(): string[];
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/agents/runtime/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuB7D,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,oDAAoD;IACpD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAIlE,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0G3D,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA4B3D,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQjF,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO;IAqBzC,OAAO,CAAC,aAAa;IAMrB,wDAAwD;IACxD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD,oCAAoC;IACpC,YAAY,IAAI,MAAM,EAAE;CAGzB"}

package/dist/agents/runtime/driver.js

@@ -0,0 +1,215 @@
+/**
+ * Agent Runtime Environment — Claude CLI agent driver.
+ *
+ * Implements the AgentDriver interface using the existing Core agent
+ * spawn machinery. This bridges the new runtime layer with the proven
+ * process spawning in src/agents/spawn.ts.
+ */
+import { spawn } from "node:child_process";
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { LOGS_DIR } from "../store.js";
+import { createLogger } from "../../utils/logger.js";
+const log = createLogger("agent-driver");
+// ---------------------------------------------------------------------------
+// Process tracking
+// ---------------------------------------------------------------------------
+/** Map of instance ID → child process (only for current session). */
+const processes = new Map();
+/** Map of instance ID → timeout timer. */
+const timers = new Map();
+/** Exit handlers registered per instance. */
+const exitHandlers = new Map();
+// ---------------------------------------------------------------------------
+// Claude CLI Driver
+// ---------------------------------------------------------------------------
+export class ClaudeCliDriver {
+    name = "claude-cli";
+    /** Register a callback for when a process exits. */
+    onExit(instanceId, handler) {
+        exitHandlers.set(instanceId, handler);
+    }
+    async spawn(instance) {
+        const stdoutPath = join(LOGS_DIR, `${instance.taskId}.stdout.log`);
+        const stderrPath = join(LOGS_DIR, `${instance.taskId}.stderr.log`);
+        const promptPath = join(LOGS_DIR, `${instance.taskId}.prompt.txt`);
+        // Resolve prompt: if resuming with checkpoint, prepend context
+        const prompt = instance.checkpointData
+            ? `[Resuming from previous session]\n\nPrevious context:\n${instance.checkpointData}\n\nContinue the task.`
+            : this.resolvePrompt(instance);
+        writeFileSync(promptPath, prompt, "utf-8");
+        // Clean env to allow nested Claude Code sessions
+        const cleanEnv = { ...process.env, ...instance.config.env };
+        delete cleanEnv.CLAUDECODE;
+        const cwd = instance.metadata.label; // Will be resolved from task
+        const taskCwd = process.cwd();
+        const wrapperScript = `
+      const fs = require("fs");
+      const { spawnSync } = require("child_process");
+      const prompt = fs.readFileSync(${JSON.stringify(promptPath)}, "utf-8");
+      const r = spawnSync("claude", [
+        "--print", "--output-format", "text", "--dangerously-skip-permissions", prompt
+      ], {
+        cwd: ${JSON.stringify(taskCwd)},
+        encoding: "utf-8",
+        maxBuffer: 50 * 1024 * 1024,
+        timeout: ${instance.config.timeoutMs},
+        windowsHide: true
+      });
+      fs.writeFileSync(${JSON.stringify(stdoutPath)}, r.stdout || "", "utf-8");
+      fs.writeFileSync(${JSON.stringify(stderrPath)}, r.stderr || "", "utf-8");
+      process.exit(r.status || 0);
+    `;
+        const child = spawn(process.execPath, ["--eval", wrapperScript], {
+            cwd: taskCwd,
+            detached: true,
+            stdio: "ignore",
+            env: cleanEnv,
+            windowsHide: true,
+        });
+        child.unref();
+        processes.set(instance.id, child);
+        log.info("Agent process spawned", { instanceId: instance.id, taskId: instance.taskId, pid: child.pid, label: instance.metadata.label });
+        // Wire exit handler — classify exit reason for diagnostics
+        child.on("exit", (code, signal) => {
+            const reason = signal
+                ? `signal:${signal}` // killed externally or by timeout
+                : code === null
+                    ? "exit:null (likely timeout or OOM)"
+                    : code === 0
+                        ? "clean exit"
+                        : `exit code ${code}`;
+            log.info("Agent process exited", { instanceId: instance.id, taskId: instance.taskId, exitCode: code, signal, reason });
+            // Log stderr content for failed exits to aid debugging
+            if (code !== 0) {
+                import("node:fs/promises").then(({ readFile }) => readFile(stderrPath, "utf-8").then((stderr) => {
+                    if (stderr.trim()) {
+                        log.warn("Agent stderr output", { instanceId: instance.id, stderr: stderr.slice(-1000) });
+                    }
+                })).catch(() => { });
+            }
+            processes.delete(instance.id);
+            clearTimer(instance.id);
+            const handler = exitHandlers.get(instance.id);
+            if (handler) {
+                exitHandlers.delete(instance.id);
+                // Small delay for file flush
+                setTimeout(() => handler(code), 300);
+            }
+        });
+        // Wire error handler
+        child.on("error", (err) => {
+            log.error("Agent process error", { instanceId: instance.id, taskId: instance.taskId, error: err.message });
+            processes.delete(instance.id);
+            clearTimer(instance.id);
+            const handler = exitHandlers.get(instance.id);
+            if (handler) {
+                exitHandlers.delete(instance.id);
+                handler(-1);
+            }
+        });
+        // Set timeout
+        if (instance.config.timeoutMs > 0) {
+            const timer = setTimeout(() => {
+                if (processes.has(instance.id)) {
+                    this.terminate(instance).catch(() => { });
+                }
+            }, instance.config.timeoutMs);
+            timers.set(instance.id, timer);
+        }
+        return child.pid;
+    }
+    async pause(instance) {
+        log.info("Pausing agent process", { instanceId: instance.id, taskId: instance.taskId });
+        // Claude CLI processes can't be truly paused. We kill the process
+        // and save partial output as checkpoint data for resumption.
+        const child = processes.get(instance.id);
+        if (!child)
+            return undefined;
+        // Read any output so far as checkpoint
+        let checkpoint;
+        try {
+            const { readFile } = await import("node:fs/promises");
+            const stdout = await readFile(join(LOGS_DIR, `${instance.taskId}.stdout.log`), "utf-8");
+            if (stdout.trim()) {
+                checkpoint = stdout.trim().slice(0, 2000);
+            }
+        }
+        catch {
+            // No output yet
+        }
+        // Kill the process
+        await this.terminate(instance);
+        return checkpoint;
+    }
+    async resume(instance, checkpoint) {
+        // Store checkpoint data on the instance for spawn to use
+        if (checkpoint) {
+            instance.checkpointData = checkpoint;
+        }
+        return this.spawn(instance);
+    }
+    async terminate(instance) {
+        log.info("Terminating agent process", { instanceId: instance.id, taskId: instance.taskId, pid: instance.pid });
+        const child = processes.get(instance.id);
+        clearTimer(instance.id);
+        exitHandlers.delete(instance.id);
+        if (!child)
+            return;
+        processes.delete(instance.id);
+        try {
+            if (process.platform === "win32" && child.pid) {
+                spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"], { shell: true });
+            }
+            else {
+                child.kill("SIGTERM");
+            }
+        }
+        catch {
+            log.debug("Process already exited during terminate", { instanceId: instance.id });
+        }
+    }
+    isAlive(instance) {
+        // Check our tracked processes first
+        if (processes.has(instance.id))
+            return true;
+        // Fall back to PID check for recovered processes
+        if (instance.pid) {
+            try {
+                process.kill(instance.pid, 0);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    resolvePrompt(instance) {
+        // The prompt is stored on the linked AgentTask.
+        // The runtime manager will set this before calling spawn.
+        return instance._prompt ?? "";
+    }
+    /** Get the process for an instance (for monitoring). */
+    getProcess(instanceId) {
+        return processes.get(instanceId);
+    }
+    /** Get all tracked instance IDs. */
+    getActiveIds() {
+        return Array.from(processes.keys());
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clearTimer(instanceId) {
+    const timer = timers.get(instanceId);
+    if (timer) {
+        clearTimeout(timer);
+        timers.delete(instanceId);
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/agents/runtime/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/agents/runtime/driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAEzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,qEAAqE;AACrE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;AAElD,0CAA0C;AAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEhE,6CAA6C;AAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEtE,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,YAAY,CAAC;IAE7B,oDAAoD;IACpD,MAAM,CAAC,UAAkB,EAAE,OAAsC;QAC/D,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAuB;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,aAAa,CAAC,CAAC;QAEnE,+DAA+D;QAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc;YACpC,CAAC,CAAC,0DAA0D,QAAQ,CAAC,cAAc,wBAAwB;YAC3G,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEjC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAE3C,iDAAiD;QACjD,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC5D,OAAO,QAAQ,CAAC,UAAU,CAAC;QAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,6BAA6B;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE9B,MAAM,aAAa,GAAG;;;uCAGa,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;;;;eAIlD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;mBAGnB,QAAQ,CAAC,MAAM,CAAC,SAAS;;;yBAGnB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;yBAC1B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;;KAE9C,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;YAC/D,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,GAAG,EAAE,QAAQ;YACb,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAExI,2DAA2D;QAC3D,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,MAAM;gBACnB,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC,kCAAkC;gBACvD,CAAC,CAAC,IAAI,KAAK,IAAI;oBACb,CAAC,CAAC,mCAAmC;oBACrC,CAAC,CAAC,IAAI,KAAK,CAAC;wBACV,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAEvH,uDAAuD;YACvD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC/C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;oBAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;wBAClB,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC5F,CAAC;gBACH,CAAC,CAAC,CACH,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACpB,CAAC;YAED,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9B,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjC,6BAA6B;gBAC7B,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,qBAAqB;QACrB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACtH,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9B,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAuB;QACjC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,kEAAkE;QAClE,6DAA6D;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,uCAAuC;QACvC,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,aAAa,CAAC,EAC/C,OAAO,CACR,CAAC;YACF,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClB,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QAED,mBAAmB;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE/B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAuB,EAAE,UAAmB;QACvD,yDAAyD;QACzD,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,cAAc,GAAG,UAAU,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/G,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxB,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEjC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAE9B,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC9C,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAuB;QAC7B,oCAAoC;QACpC,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5C,iDAAiD;QACjD,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0EAA0E;IAC1E,UAAU;IACV,0EAA0E;IAElE,aAAa,CAAC,QAAuB;QAC3C,gDAAgD;QAChD,0DAA0D;QAC1D,OAAQ,QAAiD,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,wDAAwD;IACxD,UAAU,CAAC,UAAkB;QAC3B,OAAO,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,oCAAoC;IACpC,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,UAAU,CAAC,UAAkB;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/agents/runtime/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent Runtime Environment — Error types and codes.
+ */
+/** Runtime-specific error with structured code and recoverability flag. */
+export declare class RuntimeError extends Error {
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, recoverable?: boolean, context?: Record<string, unknown> | undefined);
+}
+/** All known error codes. */
+export declare const ErrorCodes: {
+    readonly RESOURCE_EXHAUSTED: "RESOURCE_EXHAUSTED";
+    readonly MAX_AGENTS_REACHED: "MAX_AGENTS_REACHED";
+    readonly MEMORY_LIMIT_EXCEEDED: "MEMORY_LIMIT_EXCEEDED";
+    readonly INVALID_TRANSITION: "INVALID_TRANSITION";
+    readonly AGENT_NOT_FOUND: "AGENT_NOT_FOUND";
+    readonly ALREADY_TERMINATED: "ALREADY_TERMINATED";
+    readonly SPAWN_FAILED: "SPAWN_FAILED";
+    readonly RESUME_FAILED: "RESUME_FAILED";
+    readonly PAUSE_NOT_SUPPORTED: "PAUSE_NOT_SUPPORTED";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly DRIVER_ERROR: "DRIVER_ERROR";
+    readonly MAX_RETRIES_EXCEEDED: "MAX_RETRIES_EXCEEDED";
+    readonly SHUTDOWN_IN_PROGRESS: "SHUTDOWN_IN_PROGRESS";
+    readonly REGISTRY_CORRUPT: "REGISTRY_CORRUPT";
+    readonly BUS_DELIVERY_FAILED: "BUS_DELIVERY_FAILED";
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+//# sourceMappingURL=errors.d.ts.map

package/dist/agents/runtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,qBAAa,YAAa,SAAQ,KAAK;aAEnB,IAAI,EAAE,MAAM;aAEZ,WAAW,EAAE,OAAO;aACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,WAAW,GAAE,OAAe,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,6BAA6B;AAC7B,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;CAyBb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/agents/runtime/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Agent Runtime Environment — Error types and codes.
+ */
+/** Runtime-specific error with structured code and recoverability flag. */
+export class RuntimeError extends Error {
+    code;
+    recoverable;
+    context;
+    constructor(code, message, recoverable = false, context) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.context = context;
+        this.name = "RuntimeError";
+    }
+}
+/** All known error codes. */
+export const ErrorCodes = {
+    // Resource limits
+    RESOURCE_EXHAUSTED: "RESOURCE_EXHAUSTED",
+    MAX_AGENTS_REACHED: "MAX_AGENTS_REACHED",
+    MEMORY_LIMIT_EXCEEDED: "MEMORY_LIMIT_EXCEEDED",
+    // Lifecycle
+    INVALID_TRANSITION: "INVALID_TRANSITION",
+    AGENT_NOT_FOUND: "AGENT_NOT_FOUND",
+    ALREADY_TERMINATED: "ALREADY_TERMINATED",
+    // Spawning
+    SPAWN_FAILED: "SPAWN_FAILED",
+    RESUME_FAILED: "RESUME_FAILED",
+    PAUSE_NOT_SUPPORTED: "PAUSE_NOT_SUPPORTED",
+    // Execution
+    TIMEOUT: "TIMEOUT",
+    DRIVER_ERROR: "DRIVER_ERROR",
+    MAX_RETRIES_EXCEEDED: "MAX_RETRIES_EXCEEDED",
+    // System
+    SHUTDOWN_IN_PROGRESS: "SHUTDOWN_IN_PROGRESS",
+    REGISTRY_CORRUPT: "REGISTRY_CORRUPT",
+    BUS_DELIVERY_FAILED: "BUS_DELIVERY_FAILED",
+};
+//# sourceMappingURL=errors.js.map

package/dist/agents/runtime/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/agents/runtime/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,MAAM,OAAO,YAAa,SAAQ,KAAK;IAEnB;IAEA;IACA;IAJlB,YACkB,IAAY,EAC5B,OAAe,EACC,cAAuB,KAAK,EAC5B,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,gBAAW,GAAX,WAAW,CAAiB;QAC5B,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB;IAClB,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAE9C,YAAY;IACZ,kBAAkB,EAAE,oBAAoB;IACxC,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IAExC,WAAW;IACX,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAE1C,YAAY;IACZ,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,oBAAoB,EAAE,sBAAsB;IAE5C,SAAS;IACT,oBAAoB,EAAE,sBAAsB;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,mBAAmB,EAAE,qBAAqB;CAClC,CAAC"}