@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/harness/amux/amuxBridge.d.ts

@@ -0,0 +1,71 @@
+/**
+ * agent-mux integration bridge for agent-platform.
+ *
+ * Replaces the direct child-process invocation in `invoker.ts` for
+ * external harnesses by delegating to an AmuxClient instance. The
+ * client is injected so agent-platform never imports @agent-mux/core
+ * directly -- it only depends on the interfaces defined in amuxTypes.ts.
+ *
+ * @module harness/amux/amuxBridge
+ */
+import type { HarnessInvokeOptions, HarnessInvokeResult } from "../types";
+import type { AmuxClient } from "./amuxTypes";
+import { type BabysitterEvent } from "./amuxEventMapper";
+/**
+ * Options that extend the standard HarnessInvokeOptions with fields
+ * specific to the agent-mux bridge.
+ */
+export interface AmuxBridgeOptions extends HarnessInvokeOptions {
+    /** Session ID for session resumption via agent-mux. */
+    sessionId?: string;
+    /** Whether to suppress interactive prompts (yolo mode). */
+    nonInteractive?: boolean;
+    /** Maximum agent turns before force-stop. */
+    maxTurns?: number;
+    /** Hook configuration forwarded to the agent. */
+    hooks?: unknown;
+    /** Skills to enable for this run. */
+    skills?: string[];
+}
+/**
+ * Extended result that includes agent-mux-specific metadata on top of
+ * the standard HarnessInvokeResult.
+ */
+export interface AmuxBridgeResult extends HarnessInvokeResult {
+    /** Session ID returned by agent-mux (for session resumption). */
+    sessionId?: string;
+    /** Accumulated cost from cost events. */
+    totalCost: number;
+    /** All babysitter-mapped events collected during the run. */
+    events: BabysitterEvent[];
+    /** The last assistant text message accumulated from text_delta events. */
+    lastMessage: string;
+}
+/**
+ * Optional callback invoked for each mapped babysitter event during
+ * stream consumption. Useful for live governance checks, cost tracking,
+ * and webhook forwarding without waiting for the full run to complete.
+ */
+export type AmuxEventCallback = (event: BabysitterEvent) => void | Promise<void>;
+/**
+ * Invoke a harness through agent-mux instead of spawning the CLI directly.
+ *
+ * The function:
+ *   1. Maps the babysitter harness name to an agent-mux adapter name.
+ *   2. Calls `client.run()` with the translated options.
+ *   3. Consumes the async event stream, mapping each AgentEvent to a
+ *      BabysitterEvent.
+ *   4. Accumulates text deltas, cost totals, and error state.
+ *   5. Returns an AmuxBridgeResult compatible with HarnessInvokeResult.
+ *
+ * @param client      - AmuxClient instance (injected, no hard dep on @agent-mux/core).
+ * @param harness     - babysitter harness name (e.g. "claude-code", "codex").
+ * @param options     - Invocation options.
+ * @param onEvent     - Optional per-event callback for live processing.
+ * @returns Promise resolving to the bridge result.
+ *
+ * @throws {Error} if `harness` is "pi" / "internal" (use agent-core).
+ * @throws {Error} if the harness has no agent-mux adapter mapping.
+ */
+export declare function invokeViaAgentMux(client: AmuxClient, harness: string, options: AmuxBridgeOptions, onEvent?: AmuxEventCallback): Promise<AmuxBridgeResult>;
+//# sourceMappingURL=amuxBridge.d.ts.map

package/dist/harness/amux/amuxBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amuxBridge.d.ts","sourceRoot":"","sources":["../../../src/harness/amux/amuxBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAM3B;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAMjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAuF3B"}

package/dist/harness/amux/amuxBridge.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * agent-mux integration bridge for agent-platform.
+ *
+ * Replaces the direct child-process invocation in `invoker.ts` for
+ * external harnesses by delegating to an AmuxClient instance. The
+ * client is injected so agent-platform never imports @agent-mux/core
+ * directly -- it only depends on the interfaces defined in amuxTypes.ts.
+ *
+ * @module harness/amux/amuxBridge
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeViaAgentMux = invokeViaAgentMux;
+const amuxHarnessMap_1 = require("./amuxHarnessMap");
+const amuxEventMapper_1 = require("./amuxEventMapper");
+// ---------------------------------------------------------------------------
+// Bridge implementation
+// ---------------------------------------------------------------------------
+/**
+ * Invoke a harness through agent-mux instead of spawning the CLI directly.
+ *
+ * The function:
+ *   1. Maps the babysitter harness name to an agent-mux adapter name.
+ *   2. Calls `client.run()` with the translated options.
+ *   3. Consumes the async event stream, mapping each AgentEvent to a
+ *      BabysitterEvent.
+ *   4. Accumulates text deltas, cost totals, and error state.
+ *   5. Returns an AmuxBridgeResult compatible with HarnessInvokeResult.
+ *
+ * @param client      - AmuxClient instance (injected, no hard dep on @agent-mux/core).
+ * @param harness     - babysitter harness name (e.g. "claude-code", "codex").
+ * @param options     - Invocation options.
+ * @param onEvent     - Optional per-event callback for live processing.
+ * @returns Promise resolving to the bridge result.
+ *
+ * @throws {Error} if `harness` is "pi" / "internal" (use agent-core).
+ * @throws {Error} if the harness has no agent-mux adapter mapping.
+ */
+async function invokeViaAgentMux(client, harness, options, onEvent) {
+    const adapterName = (0, amuxHarnessMap_1.mapHarnessToAmuxAdapter)(harness);
+    const startTime = Date.now();
+    const handle = client.run({
+        agent: adapterName,
+        prompt: options.prompt,
+        model: options.model,
+        cwd: options.workspace,
+        timeout: options.timeout,
+        sessionId: options.sessionId,
+        approvalMode: options.nonInteractive ? "yolo" : "prompt",
+        stream: true,
+        nonInteractive: options.nonInteractive,
+        maxTurns: options.maxTurns,
+        env: {
+            ...(options.sessionId ? { AGENT_SESSION_ID: options.sessionId } : {}),
+            ...options.env,
+        },
+        hooks: options.hooks,
+        skills: options.skills,
+    });
+    // Wire AbortSignal to agent-mux handle
+    if (options.signal) {
+        if (options.signal.aborted) {
+            handle.abort();
+        }
+        else {
+            options.signal.addEventListener("abort", () => handle.abort(), {
+                once: true,
+            });
+        }
+    }
+    // Consume the event stream
+    const collectedEvents = [];
+    let lastMessage = "";
+    let totalCost = 0;
+    let hasError = false;
+    for await (const rawEvent of handle.events) {
+        const mapped = (0, amuxEventMapper_1.mapAmuxEvent)(rawEvent);
+        if (!mapped)
+            continue;
+        collectedEvents.push(mapped);
+        // Accumulate text deltas
+        if (mapped.kind === "text_delta") {
+            const text = mapped.data["text"];
+            if (typeof text === "string") {
+                lastMessage += text;
+            }
+        }
+        // Accumulate cost
+        if ((0, amuxEventMapper_1.isCostEvent)(mapped)) {
+            const eventCost = mapped.data["totalCost"];
+            if (typeof eventCost === "number") {
+                totalCost += eventCost;
+            }
+        }
+        // Track errors
+        if ((0, amuxEventMapper_1.isErrorEvent)(mapped)) {
+            hasError = true;
+        }
+        // Forward to caller's live callback
+        if (onEvent) {
+            await onEvent(mapped);
+        }
+    }
+    const duration = Date.now() - startTime;
+    const exitCode = handle.exitCode ?? (hasError ? 1 : 0);
+    return {
+        success: exitCode === 0 && !hasError,
+        output: lastMessage.trim(),
+        exitCode,
+        duration,
+        harness,
+        sessionId: handle.sessionId,
+        totalCost,
+        events: collectedEvents,
+        lastMessage: lastMessage.trim(),
+    };
+}

package/dist/harness/amux/amuxClientFactory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Factory for obtaining an AmuxClient instance.
+ *
+ * The package is a direct dependency, but some runtimes still cannot load the
+ * full agent-mux graph (for example when a required Node built-in is absent).
+ */
+import type { AmuxClient } from "./amuxTypes";
+/**
+ * Get or create the singleton AmuxClient.
+ */
+export declare function getAmuxClient(): Promise<AmuxClient>;
+/**
+ * Check whether agent-mux client can be created.
+ */
+export declare function isAmuxAvailable(): Promise<boolean>;
+/**
+ * Reset the cached client. For testing.
+ * @internal
+ */
+export declare function _resetAmuxClientCache(): void;
+/**
+ * Override the agent-mux module for testing.
+ * Pass `undefined` to restore require-based resolution.
+ * @internal
+ */
+export declare function _setAmuxModuleForTesting(mod: {
+    createClient: (options: Record<string, unknown>) => AmuxClient;
+} | undefined): void;
+//# sourceMappingURL=amuxClientFactory.d.ts.map

package/dist/harness/amux/amuxClientFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amuxClientFactory.d.ts","sourceRoot":"","sources":["../../../src/harness/amux/amuxClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuC9C;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAqBnD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE;IAAE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAA;CAAE,GAAG,SAAS,GAClF,IAAI,CAGN"}

package/dist/harness/amux/amuxClientFactory.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Factory for obtaining an AmuxClient instance.
+ *
+ * The package is a direct dependency, but some runtimes still cannot load the
+ * full agent-mux graph (for example when a required Node built-in is absent).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAmuxClient = getAmuxClient;
+exports.isAmuxAvailable = isAmuxAvailable;
+exports._resetAmuxClientCache = _resetAmuxClientCache;
+exports._setAmuxModuleForTesting = _setAmuxModuleForTesting;
+const node_module_1 = require("node:module");
+let cachedClient = null;
+let amuxOverride;
+function hasNodeSqliteBuiltin() {
+    return node_module_1.builtinModules.includes("node:sqlite") || node_module_1.builtinModules.includes("sqlite");
+}
+function requireAmux() {
+    if (amuxOverride) {
+        return amuxOverride;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment
+    const mod = require("@a5c-ai/agent-mux");
+    return mod;
+}
+function normalizeAmuxLoadError(error) {
+    const code = typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : "";
+    const message = error instanceof Error ? error.message : String(error);
+    if (code === "ERR_UNKNOWN_BUILTIN_MODULE" ||
+        code === "ERR_MODULE_NOT_FOUND" ||
+        code === "MODULE_NOT_FOUND" ||
+        message.includes("node:sqlite")) {
+        return new Error(`agent-mux runtime is unavailable in this Node environment: ${message}`, { cause: error });
+    }
+    return error instanceof Error ? error : new Error(message);
+}
+/**
+ * Get or create the singleton AmuxClient.
+ */
+function getAmuxClient() {
+    if (cachedClient) {
+        return Promise.resolve(cachedClient);
+    }
+    if (!amuxOverride && !hasNodeSqliteBuiltin()) {
+        throw normalizeAmuxLoadError(new Error("Missing required built-in module: node:sqlite"));
+    }
+    try {
+        const { createClient } = requireAmux();
+        const client = createClient({
+            stream: true,
+            debug: false,
+        });
+        cachedClient = client;
+        return Promise.resolve(cachedClient);
+    }
+    catch (error) {
+        throw normalizeAmuxLoadError(error);
+    }
+}
+/**
+ * Check whether agent-mux client can be created.
+ */
+async function isAmuxAvailable() {
+    try {
+        await getAmuxClient();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reset the cached client. For testing.
+ * @internal
+ */
+function _resetAmuxClientCache() {
+    cachedClient = null;
+}
+/**
+ * Override the agent-mux module for testing.
+ * Pass `undefined` to restore require-based resolution.
+ * @internal
+ */
+function _setAmuxModuleForTesting(mod) {
+    amuxOverride = mod;
+    cachedClient = null;
+}

package/dist/harness/amux/amuxEventEmitter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Emits agent-mux compatible JSONL events to stdout during harness execution.
+ *
+ * Used when `--output-format amux-events` is passed to `invoke` or
+ * `call`. Each event is a single JSON line matching the
+ * {@link AmuxAgentEvent} shape so the agent-mux babysitter adapter's
+ * `parseEvent()` can consume it directly.
+ *
+ * @module harness/amux/amuxEventEmitter
+ */
+import type { AmuxAgentEvent } from "./amuxTypes";
+/**
+ * Stateful emitter that writes agent-mux compatible JSONL events to stdout.
+ *
+ * Each `emit()` call writes one JSON line to `process.stdout`. The emitter
+ * auto-stamps every event with `runId`, `agent`, and `timestamp` so callers
+ * only need to supply the event-specific fields.
+ */
+export declare class AmuxEventEmitter {
+    private readonly runId;
+    private readonly agent;
+    constructor(runId: string, agent?: string);
+    /**
+     * Write a single JSONL event to stdout.
+     *
+     * Base fields (`runId`, `agent`, `timestamp`) are merged automatically.
+     * Any field in `event` overrides the base fields.
+     */
+    emit(event: Partial<AmuxAgentEvent>): void;
+    /** Mark the beginning of a session / run. */
+    sessionStart(sessionId?: string): void;
+    /** Mark the end of a session / run. */
+    sessionEnd(exitReason: string, turnCount?: number): void;
+    /** Emit a text output chunk. */
+    textDelta(text: string): void;
+    /** Signal the start of a tool invocation. */
+    toolCallStart(toolCallId: string, toolName: string, input?: unknown): void;
+    /** Signal a tool invocation result. */
+    toolResult(toolCallId: string, toolName: string, output: unknown): void;
+    /** Emit cost / token usage information. */
+    cost(inputTokens: number, outputTokens: number, totalCost: number): void;
+    /** Signal the start of an orchestration iteration / turn. */
+    turnStart(iteration: number): void;
+    /** Signal the end of an orchestration iteration / turn. */
+    turnEnd(iteration: number): void;
+    /** Emit an error event. */
+    error(message: string, code?: string): void;
+    /** Request user approval for an action. */
+    approvalRequest(id: string, description: string): void;
+}
+//# sourceMappingURL=amuxEventEmitter.d.ts.map

package/dist/harness/amux/amuxEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amuxEventEmitter.d.ts","sourceRoot":"","sources":["../../../src/harness/amux/amuxEventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAqB;IAK/C;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAa1C,6CAA6C;IAC7C,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQtC,uCAAuC;IACvC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAWxD,gCAAgC;IAChC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU7B,6CAA6C;IAC7C,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAS1E,uCAAuC;IACvC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAWvE,2CAA2C;IAC3C,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBxE,6DAA6D;IAC7D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQlC,2DAA2D;IAC3D,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUhC,2BAA2B;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAW3C,2CAA2C;IAC3C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAOvD"}

package/dist/harness/amux/amuxEventEmitter.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Emits agent-mux compatible JSONL events to stdout during harness execution.
+ *
+ * Used when `--output-format amux-events` is passed to `invoke` or
+ * `call`. Each event is a single JSON line matching the
+ * {@link AmuxAgentEvent} shape so the agent-mux babysitter adapter's
+ * `parseEvent()` can consume it directly.
+ *
+ * @module harness/amux/amuxEventEmitter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmuxEventEmitter = void 0;
+/**
+ * Stateful emitter that writes agent-mux compatible JSONL events to stdout.
+ *
+ * Each `emit()` call writes one JSON line to `process.stdout`. The emitter
+ * auto-stamps every event with `runId`, `agent`, and `timestamp` so callers
+ * only need to supply the event-specific fields.
+ */
+class AmuxEventEmitter {
+    runId;
+    agent;
+    constructor(runId, agent = "babysitter") {
+        this.runId = runId;
+        this.agent = agent;
+    }
+    // ── Core emit ───────────────────────────────────────────────────────
+    /**
+     * Write a single JSONL event to stdout.
+     *
+     * Base fields (`runId`, `agent`, `timestamp`) are merged automatically.
+     * Any field in `event` overrides the base fields.
+     */
+    emit(event) {
+        const full = {
+            type: "unknown",
+            runId: this.runId,
+            agent: this.agent,
+            timestamp: new Date().toISOString(),
+            ...event,
+        };
+        process.stdout.write(JSON.stringify(full) + "\n");
+    }
+    // ── Session lifecycle ───────────────────────────────────────────────
+    /** Mark the beginning of a session / run. */
+    sessionStart(sessionId) {
+        this.emit({
+            type: "session_start",
+            sessionId: sessionId ?? this.runId,
+            resumed: false,
+        });
+    }
+    /** Mark the end of a session / run. */
+    sessionEnd(exitReason, turnCount) {
+        this.emit({
+            type: "session_end",
+            sessionId: this.runId,
+            exitReason,
+            turnCount: turnCount ?? 0,
+        });
+    }
+    // ── Content streaming ───────────────────────────────────────────────
+    /** Emit a text output chunk. */
+    textDelta(text) {
+        this.emit({
+            type: "text_delta",
+            text,
+            delta: text,
+        });
+    }
+    // ── Tool calls ──────────────────────────────────────────────────────
+    /** Signal the start of a tool invocation. */
+    toolCallStart(toolCallId, toolName, input) {
+        this.emit({
+            type: "tool_call_start",
+            toolCallId,
+            toolName,
+            input: input ?? {},
+        });
+    }
+    /** Signal a tool invocation result. */
+    toolResult(toolCallId, toolName, output) {
+        this.emit({
+            type: "tool_result",
+            toolCallId,
+            toolName,
+            output,
+        });
+    }
+    // ── Cost / usage ────────────────────────────────────────────────────
+    /** Emit cost / token usage information. */
+    cost(inputTokens, outputTokens, totalCost) {
+        this.emit({
+            type: "cost",
+            cost: {
+                inputTokens,
+                outputTokens,
+                totalCost,
+            },
+            inputTokens,
+            outputTokens,
+            totalCost,
+        });
+    }
+    // ── Turn / iteration boundaries ─────────────────────────────────────
+    /** Signal the start of an orchestration iteration / turn. */
+    turnStart(iteration) {
+        this.emit({
+            type: "turn_start",
+            turnIndex: iteration,
+            iteration,
+        });
+    }
+    /** Signal the end of an orchestration iteration / turn. */
+    turnEnd(iteration) {
+        this.emit({
+            type: "turn_end",
+            turnIndex: iteration,
+            iteration,
+        });
+    }
+    // ── Errors ──────────────────────────────────────────────────────────
+    /** Emit an error event. */
+    error(message, code) {
+        this.emit({
+            type: "error",
+            message,
+            error: message,
+            code: code ?? "INTERNAL",
+        });
+    }
+    // ── Approval requests ───────────────────────────────────────────────
+    /** Request user approval for an action. */
+    approvalRequest(id, description) {
+        this.emit({
+            type: "approval_request",
+            id,
+            description,
+        });
+    }
+}
+exports.AmuxEventEmitter = AmuxEventEmitter;

package/dist/harness/amux/amuxEventMapper.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Maps agent-mux AgentEvent instances to agent-platform internal events.
+ *
+ * agent-platform consumes these mapped events for:
+ *   - Session history recording
+ *   - Cost journaling
+ *   - Governance checks
+ *   - Webhook forwarding
+ *   - Stop-hook orchestration loop
+ *
+ * @module harness/amux/amuxEventMapper
+ */
+import type { AmuxAgentEvent } from "./amuxTypes";
+/**
+ * Internal event representation used within agent-platform.
+ *
+ * This is intentionally a simple tagged union so downstream consumers
+ * (session history, cost journal, webhooks) can switch on `kind`.
+ */
+export interface BabysitterEvent {
+    /** Discriminator. */
+    kind: BabysitterEventKind;
+    /** ISO-8601 timestamp from the source event. */
+    timestamp: string;
+    /** Agent/adapter that produced the event. */
+    agent: string;
+    /** agent-mux run ID. */
+    runId: string;
+    /** Payload varies by kind. */
+    data: Record<string, unknown>;
+}
+/**
+ * Known babysitter event kinds derived from agent-mux event types.
+ */
+export type BabysitterEventKind = "session_start" | "session_end" | "text_delta" | "thinking_delta" | "tool_call_start" | "tool_result" | "cost" | "token_usage" | "approval_request" | "input_required" | "error" | "crash" | "context_compacted" | "unknown";
+/**
+ * Map an agent-mux AgentEvent to a agent-platform internal event.
+ *
+ * Returns `null` for event types agent-platform doesn't care about
+ * (e.g. internal debug events from agent-mux). Unknown but non-null
+ * events are mapped with kind "unknown" so downstream consumers can
+ * log or ignore them.
+ *
+ * @param event - The raw agent-mux event.
+ * @returns The mapped BabysitterEvent, or null to drop.
+ */
+export declare function mapAmuxEvent(event: AmuxAgentEvent): BabysitterEvent | null;
+/** Returns true if the event represents a governance-relevant tool call. */
+export declare function isToolEvent(event: BabysitterEvent): boolean;
+/** Returns true if the event carries cost/token information. */
+export declare function isCostEvent(event: BabysitterEvent): boolean;
+/** Returns true if the event requires an interactive response. */
+export declare function isInteractiveEvent(event: BabysitterEvent): boolean;
+/** Returns true if the event signals an error condition. */
+export declare function isErrorEvent(event: BabysitterEvent): boolean;
+/** Returns true if the event represents a session lifecycle boundary. */
+export declare function isSessionLifecycleEvent(event: BabysitterEvent): boolean;
+//# sourceMappingURL=amuxEventMapper.d.ts.map

package/dist/harness/amux/amuxEventMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amuxEventMapper.d.ts","sourceRoot":"","sources":["../../../src/harness/amux/amuxEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,MAAM,GACN,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,OAAO,GACP,OAAO,GACP,mBAAmB,GACnB,SAAS,CAAC;AA0Bd;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,GAAG,IAAI,CAmB1E;AAMD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3D;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3D;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAElE;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE5D;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEvE"}

package/dist/harness/amux/amuxEventMapper.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Maps agent-mux AgentEvent instances to agent-platform internal events.
+ *
+ * agent-platform consumes these mapped events for:
+ *   - Session history recording
+ *   - Cost journaling
+ *   - Governance checks
+ *   - Webhook forwarding
+ *   - Stop-hook orchestration loop
+ *
+ * @module harness/amux/amuxEventMapper
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapAmuxEvent = mapAmuxEvent;
+exports.isToolEvent = isToolEvent;
+exports.isCostEvent = isCostEvent;
+exports.isInteractiveEvent = isInteractiveEvent;
+exports.isErrorEvent = isErrorEvent;
+exports.isSessionLifecycleEvent = isSessionLifecycleEvent;
+// ---------------------------------------------------------------------------
+// Well-known event type set
+// ---------------------------------------------------------------------------
+const KNOWN_EVENT_TYPES = new Set([
+    "session_start",
+    "session_end",
+    "text_delta",
+    "thinking_delta",
+    "tool_call_start",
+    "tool_result",
+    "cost",
+    "token_usage",
+    "approval_request",
+    "input_required",
+    "error",
+    "crash",
+    "context_compacted",
+]);
+// ---------------------------------------------------------------------------
+// Mapper
+// ---------------------------------------------------------------------------
+/**
+ * Map an agent-mux AgentEvent to a agent-platform internal event.
+ *
+ * Returns `null` for event types agent-platform doesn't care about
+ * (e.g. internal debug events from agent-mux). Unknown but non-null
+ * events are mapped with kind "unknown" so downstream consumers can
+ * log or ignore them.
+ *
+ * @param event - The raw agent-mux event.
+ * @returns The mapped BabysitterEvent, or null to drop.
+ */
+function mapAmuxEvent(event) {
+    if (!event || !event.type) {
+        return null;
+    }
+    // Extract the base fields every BabysitterEvent needs.
+    const { type, runId, agent, timestamp, ...rest } = event;
+    const kind = KNOWN_EVENT_TYPES.has(type)
+        ? type
+        : "unknown";
+    return {
+        kind,
+        timestamp: timestamp ?? new Date().toISOString(),
+        agent: agent ?? "unknown",
+        runId: runId ?? "",
+        data: { originalType: type, ...rest },
+    };
+}
+// ---------------------------------------------------------------------------
+// Convenience predicates
+// ---------------------------------------------------------------------------
+/** Returns true if the event represents a governance-relevant tool call. */
+function isToolEvent(event) {
+    return event.kind === "tool_call_start" || event.kind === "tool_result";
+}
+/** Returns true if the event carries cost/token information. */
+function isCostEvent(event) {
+    return event.kind === "cost" || event.kind === "token_usage";
+}
+/** Returns true if the event requires an interactive response. */
+function isInteractiveEvent(event) {
+    return event.kind === "approval_request" || event.kind === "input_required";
+}
+/** Returns true if the event signals an error condition. */
+function isErrorEvent(event) {
+    return event.kind === "error" || event.kind === "crash";
+}
+/** Returns true if the event represents a session lifecycle boundary. */
+function isSessionLifecycleEvent(event) {
+    return event.kind === "session_start" || event.kind === "session_end";
+}