@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/adapters/adapterEventEmitter.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Emits adapters compatible JSONL events to stdout during harness execution.
+ *
+ * Used when `--output-format adapters-events` is passed to `invoke` or
+ * `call`. Each event is a single JSON line matching the
+ * {@link AdapterAgentEvent} shape so the adapters babysitter adapter's
+ * `parseEvent()` can consume it directly.
+ *
+ * @module harness/adapters/adapterEventEmitter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterEventEmitter = void 0;
+/**
+ * Stateful emitter that writes adapters 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 AdapterEventEmitter {
+    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.AdapterEventEmitter = AdapterEventEmitter;

package/dist/harness/adapters/adapterEventMapper.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Maps adapters 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 harnes./adapters/adapterEventMapper
+ */
+import type { AdapterAgentEvent } from "./adapterTypes";
+/**
+ * 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;
+    /** adapters run ID. */
+    runId: string;
+    /** Payload varies by kind. */
+    data: Record<string, unknown>;
+}
+/**
+ * Known babysitter event kinds derived from adapters event types.
+ *
+ * The const array is the single source of truth -- the type union and
+ * runtime Set are both derived from it so they can never drift apart.
+ */
+declare const BABYSITTER_EVENT_KINDS: readonly ["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"];
+export type BabysitterEventKind = (typeof BABYSITTER_EVENT_KINDS)[number];
+/**
+ * Map an adapters AgentEvent to a agent-platform internal event.
+ *
+ * Returns `null` for event types agent-platform doesn't care about
+ * (e.g. internal debug events from adapters). Unknown but non-null
+ * events are mapped with kind "unknown" so downstream consumers can
+ * log or ignore them.
+ *
+ * @param event - The raw adapters event.
+ * @returns The mapped BabysitterEvent, or null to drop.
+ */
+export declare function mapAmuxEvent(event: AdapterAgentEvent): 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;
+export {};
+//# sourceMappingURL=adapterEventMapper.d.ts.map

package/dist/harness/adapters/adapterEventMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventMapper.d.ts","sourceRoot":"","sources":["../../../src/harness/adapters/adapterEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD;;;;;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,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,QAAA,MAAM,sBAAsB,4NAelB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAc1E;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI,CAmB7E;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/adapters/adapterEventMapper.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Maps adapters 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 harnes./adapters/adapterEventMapper
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapAmuxEvent = mapAmuxEvent;
+exports.isToolEvent = isToolEvent;
+exports.isCostEvent = isCostEvent;
+exports.isInteractiveEvent = isInteractiveEvent;
+exports.isErrorEvent = isErrorEvent;
+exports.isSessionLifecycleEvent = isSessionLifecycleEvent;
+/**
+ * Known babysitter event kinds derived from adapters event types.
+ *
+ * The const array is the single source of truth -- the type union and
+ * runtime Set are both derived from it so they can never drift apart.
+ */
+const BABYSITTER_EVENT_KINDS = [
+    "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",
+];
+// ---------------------------------------------------------------------------
+// Well-known event type set (derived from the const array above)
+// ---------------------------------------------------------------------------
+const KNOWN_EVENT_TYPES = new Set(BABYSITTER_EVENT_KINDS.filter((k) => k !== "unknown"));
+// ---------------------------------------------------------------------------
+// Mapper
+// ---------------------------------------------------------------------------
+/**
+ * Map an adapters AgentEvent to a agent-platform internal event.
+ *
+ * Returns `null` for event types agent-platform doesn't care about
+ * (e.g. internal debug events from adapters). Unknown but non-null
+ * events are mapped with kind "unknown" so downstream consumers can
+ * log or ignore them.
+ *
+ * @param event - The raw adapters 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";
+}

package/dist/harness/adapters/adapterHarnessMap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Mapping from babysitter harness identifiers to adapters adapter names.
+ *
+ * Pi is intentionally excluded -- it uses agent-core directly rather than
+ * the adapters subprocess model.
+ *
+ * @module harness/adapters/adapterHarnessMap
+ */
+/**
+ * Maps agent-platform harness names to the
+ * corresponding adapters adapter identifier.
+ */
+export declare const HARNESS_TO_AGENT_MUX_ADAPTER: Readonly<Record<string, string>>;
+/**
+ * Resolve a babysitter harness name to an adapters adapter name.
+ *
+ * @throws {Error} if `harness` is "pi" (Pi uses agent-core, not adapters)
+ *         or if the harness has no known mapping.
+ */
+export declare function mapHarnessToAmuxAdapter(harness: string): string;
+/**
+ * Check whether a harness name has a corresponding adapters adapter.
+ */
+export declare function hasAmuxAdapter(harness: string): boolean;
+//# sourceMappingURL=adapterHarnessMap.d.ts.map

package/dist/harness/adapters/adapterHarnessMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterHarnessMap.d.ts","sourceRoot":"","sources":["../../../src/harness/adapters/adapterHarnessMap.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWzE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/harness/adapters/adapterHarnessMap.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HARNESS_TO_AGENT_MUX_ADAPTER = void 0;
+exports.mapHarnessToAmuxAdapter = mapHarnessToAmuxAdapter;
+exports.hasAmuxAdapter = hasAmuxAdapter;
+const builtInHarness_1 = require("../builtInHarness");
+/**
+ * Mapping from babysitter harness identifiers to adapters adapter names.
+ *
+ * Pi is intentionally excluded -- it uses agent-core directly rather than
+ * the adapters subprocess model.
+ *
+ * @module harness/adapters/adapterHarnessMap
+ */
+/**
+ * Maps agent-platform harness names to the
+ * corresponding adapters adapter identifier.
+ */
+exports.HARNESS_TO_AGENT_MUX_ADAPTER = {
+    "claude-code": "claude",
+    "codex": "codex",
+    "gemini-cli": "gemini",
+    "github-copilot": "copilot",
+    "cursor": "cursor",
+    "opencode": "opencode",
+    "openclaw": "openclaw",
+    "oh-my-pi": "omp",
+    "hermes": "hermes",
+    // Pi is NOT here -- uses agent-core directly.
+};
+/**
+ * Resolve a babysitter harness name to an adapters adapter name.
+ *
+ * @throws {Error} if `harness` is "pi" (Pi uses agent-core, not adapters)
+ *         or if the harness has no known mapping.
+ */
+function mapHarnessToAmuxAdapter(harness) {
+    const normalizedHarness = (0, builtInHarness_1.normalizeBuiltInHarnessName)(harness);
+    if (normalizedHarness === "pi" || normalizedHarness === "agent-core") {
+        throw new Error(`Harness "${harness}" uses agent-core and cannot be invoked via adapters.`);
+    }
+    const adapter = exports.HARNESS_TO_AGENT_MUX_ADAPTER[normalizedHarness];
+    if (!adapter) {
+        throw new Error(`No adapters adapter mapping for harness "${harness}". ` +
+            `Known mappings: ${Object.keys(exports.HARNESS_TO_AGENT_MUX_ADAPTER).join(", ")}`);
+    }
+    return adapter;
+}
+/**
+ * Check whether a harness name has a corresponding adapters adapter.
+ */
+function hasAmuxAdapter(harness) {
+    const normalizedHarness = (0, builtInHarness_1.normalizeBuiltInHarnessName)(harness);
+    return normalizedHarness in exports.HARNESS_TO_AGENT_MUX_ADAPTER;
+}

package/dist/harness/adapters/adapterStdinReader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Read adapters interaction responses from stdin.
+ *
+ * When agent-platform runs under adapters with `--output-format adapters-events`,
+ * the adapter adapter may write JSONL interaction events to stdin (e.g.
+ * `approval_response`, `input_response`). This module provides an
+ * async-iterable reader that parses those events.
+ *
+ * @module harness/adapters/adapterStdinReader
+ */
+/**
+ * An interaction event received on stdin from adapters.
+ *
+ * Known types:
+ *   - `approval_response` -- response to an `approval_request` event
+ *   - `input_response`    -- response to an `input_required` event
+ */
+export interface AdapterInteractionEvent {
+    /** Event type discriminator. */
+    type: string;
+    /** Interaction ID this response corresponds to. */
+    id: string;
+    /** The response payload (varies by type). */
+    response: unknown;
+    /** Whether the action was approved (for approval_response). */
+    approved?: boolean;
+}
+/**
+ * Create an async-iterable that yields interaction events parsed from stdin.
+ *
+ * Each line on stdin is expected to be a JSON object with at least a `type`
+ * and `id` field. Non-JSON lines and parse errors are silently ignored (they
+ * may be noise from the host terminal).
+ *
+ * The iterable ends when stdin is closed (EOF).
+ */
+export declare function createAmuxStdinReader(): AsyncIterable<AdapterInteractionEvent>;
+/**
+ * Wait for a single interaction response matching `interactionId`.
+ *
+ * Consumes events from the reader until a matching response is found or
+ * the stream ends. Returns `null` if the stream ends without a match.
+ */
+export declare function waitForInteractionResponse(reader: AsyncIterable<AdapterInteractionEvent>, interactionId: string): Promise<AdapterInteractionEvent | null>;
+//# sourceMappingURL=adapterStdinReader.d.ts.map

package/dist/harness/adapters/adapterStdinReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterStdinReader.d.ts","sourceRoot":"","sources":["../../../src/harness/adapters/adapterStdinReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAAC,uBAAuB,CAAC,CAkC9E;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,EAC9C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAOzC"}

package/dist/harness/adapters/adapterStdinReader.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Read adapters interaction responses from stdin.
+ *
+ * When agent-platform runs under adapters with `--output-format adapters-events`,
+ * the adapter adapter may write JSONL interaction events to stdin (e.g.
+ * `approval_response`, `input_response`). This module provides an
+ * async-iterable reader that parses those events.
+ *
+ * @module harness/adapters/adapterStdinReader
+ */
+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.createAmuxStdinReader = createAmuxStdinReader;
+exports.waitForInteractionResponse = waitForInteractionResponse;
+const readline = __importStar(require("node:readline"));
+// ---------------------------------------------------------------------------
+// Reader implementation
+// ---------------------------------------------------------------------------
+/**
+ * Create an async-iterable that yields interaction events parsed from stdin.
+ *
+ * Each line on stdin is expected to be a JSON object with at least a `type`
+ * and `id` field. Non-JSON lines and parse errors are silently ignored (they
+ * may be noise from the host terminal).
+ *
+ * The iterable ends when stdin is closed (EOF).
+ */
+function createAmuxStdinReader() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        crlfDelay: Infinity,
+    });
+    // Build an AsyncGenerator so callers can `for await ... of` the stream.
+    async function* generate() {
+        for await (const line of rl) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(trimmed);
+            }
+            catch (e) {
+                process.stderr.write(`[babysitter] adapters stdin: invalid JSON line, skipping\n`);
+                continue;
+            }
+            if (typeof parsed["type"] !== "string" || typeof parsed["id"] !== "string") {
+                continue;
+            }
+            yield {
+                type: parsed["type"],
+                id: parsed["id"],
+                response: parsed["response"],
+                approved: typeof parsed["approved"] === "boolean" ? parsed["approved"] : undefined,
+            };
+        }
+    }
+    return generate();
+}
+/**
+ * Wait for a single interaction response matching `interactionId`.
+ *
+ * Consumes events from the reader until a matching response is found or
+ * the stream ends. Returns `null` if the stream ends without a match.
+ */
+async function waitForInteractionResponse(reader, interactionId) {
+    for await (const event of reader) {
+        if (event.id === interactionId) {
+            return event;
+        }
+    }
+    return null;
+}

package/dist/harness/adapters/adapterTypes.d.ts

@@ -0,0 +1,122 @@
+/**
+ * adapters type adapters for agent-platform.
+ *
+ * Keeps a structural compatibility layer for the subset of adapters surface
+ * that agent-platform consumes, without requiring TypeScript to resolve the
+ * full @a5c-ai/adapters package during agent-platform compilation.
+ *
+ * @module harness/adapters/adapterTypes
+ */
+/**
+ * Options accepted by AgentMuxClient.run().
+ */
+export interface AgentMuxRunOptions {
+    agent: string;
+    prompt: string;
+    model?: string;
+    cwd?: string;
+    sessionId?: string;
+    timeout?: number;
+    approvalMode?: string;
+    stream?: boolean;
+    nonInteractive?: boolean;
+    maxTurns?: number;
+    env?: Record<string, string>;
+    skills?: string[];
+    /** Hook configuration forwarded to the agent. */
+    hooks?: unknown;
+}
+/**
+ * Adapter interface for the RunHandle returned by AgentMuxClient.run().
+ *
+ * The real run handle is simultaneously an AsyncIterable<AgentEvent>,
+ * an EventEmitter, and a thenable (Promise<RunResult>). agent-platform
+ * only needs the event stream, session metadata, and abort control.
+ */
+export interface AgentMuxRunHandle {
+    /** Async-iterable stream of normalised agent events. */
+    events: AsyncIterable<AdapterAgentEvent>;
+    /** Channel for responding to interactive requests (approvals, inputs). */
+    interactions: AdapterInteractionChannel;
+    /** Session ID allocated or resumed by adapters. */
+    sessionId?: string;
+    /** Process exit code (set after the event stream ends). */
+    exitCode?: number;
+    /** Abort the running agent process. */
+    abort(): void;
+}
+/**
+ * Canonical agent event emitted by adapters adapters.
+ *
+ * The real type uses `timestamp: number` (Unix epoch ms); this adapter keeps
+ * `string` (ISO-8601) for backward compat with babysitter event mappers. The
+ * bridge and tests rely on structural compatibility only.
+ */
+export interface AdapterAgentEvent {
+    /** Event type discriminator. */
+    type: string;
+    /** Run identifier assigned by adapters. */
+    runId: string;
+    /** Adapter/agent name that produced the event. */
+    agent: string;
+    /** ISO-8601 timestamp. */
+    timestamp: string;
+    /** Arbitrary additional fields (schema depends on `type`). */
+    [key: string]: unknown;
+}
+/**
+ * Channel for responding to interactive events during a run.
+ *
+ * Simplified from the real MuxInteractionChannel — agent-platform
+ * only uses the basic respond-by-ID pattern.
+ */
+export interface AdapterInteractionChannel {
+    /** Respond to an interactive request by its ID. */
+    respond(id: string, response: unknown): Promise<void>;
+}
+/**
+ * Programmatic client for invoking agents via adapters.
+ *
+ * This is the subset of the real client that agent-platform depends on.
+ * The concrete adapters client has many more methods (adapters, models,
+ * sessions, config, auth, profiles, plugins, detectHost).
+ */
+export interface AgentMuxClient {
+    /** Start an agent run and return a handle for streaming events. */
+    run(options: AgentMuxRunOptions): AgentMuxRunHandle;
+}
+/** Metadata about an adapters adapter. Re-uses canonical AdapterRegistry. */
+export interface AdapterAdapterInfo {
+    /** Adapter identifier (e.g. "claude", "codex"). */
+    agent: string;
+    /** Human-readable display name. */
+    displayName: string;
+}
+/** Result of checking whether an adapter's CLI is installed. */
+export interface AdapterAdapterInstallationCheck {
+    /** Whether the CLI binary is found on PATH. */
+    installed: boolean;
+    /** Detected version, if available. */
+    version?: string;
+}
+/** Result of checking adapter authentication state. */
+export interface AdapterAuthCheck {
+    /** Auth state discriminator. */
+    state: "authenticated" | "unauthenticated" | "unknown";
+}
+/**
+ * Extended client interface that exposes adapter discovery.
+ *
+ * Maps to the real client which has `.adapters` and `.auth`
+ * sub-managers.
+ */
+export interface AgentMuxClientWithDiscovery extends AgentMuxClient {
+    adapters: {
+        list(): AdapterAdapterInfo[];
+        detectInstallation(agent: string): Promise<AdapterAdapterInstallationCheck>;
+    };
+    auth: {
+        check(agent: string): Promise<AdapterAuthCheck>;
+    };
+}
+//# sourceMappingURL=adapterTypes.d.ts.map

package/dist/harness/adapters/adapterTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterTypes.d.ts","sourceRoot":"","sources":["../../../src/harness/adapters/adapterTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzC,0EAA0E;IAC1E,YAAY,EAAE,yBAAyB,CAAC;IACxC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;CACrD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IACjE,QAAQ,EAAE;QACR,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC7B,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;KAC7E,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;KACjD,CAAC;CACH"}