@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @a5c-ai/agent-comm-mux
+ *
+ * Core runtime, types, and utilities for agent-mux.
+ * Runtime deps: @a5c-ai/agent-catalog and @a5c-ai/agent-mux-observability.
+ */
+// Errors
+export { AgentMuxError, CapabilityError, ValidationError, AuthError, } from './errors.js';
+export { DEFAULT_RETRY_POLICY } from './retry.js';
+export { resolveStoragePaths } from './storage.js';
+export { WorkspaceService, resolveWorkspaceDefaultCwd } from './workspaces.js';
+export { sumCost, sumCostAsync, filterEvents, filterEventsAsync, } from './cost-utils.js';
+export { TERMINAL_STATES, VALID_TRANSITIONS, isTerminal, assertTransition, } from './state-machine.js';
+// Interaction channel implementation
+export { InteractionChannelImpl } from './interaction-channel-impl.js';
+// RunHandle implementation
+export { RunHandleImpl } from './run-handle-impl.js';
+export { processTracker } from './process-tracker.js';
+export { HARNESS_IMAGE_CATALOG, lookupHarnessImage } from './invocation.js';
+export { buildInvocationCommand } from './spawn-runner.js';
+export { validateRunOptions, PROHIBITED_PROFILE_FIELDS, validateProfileData, } from './run-options.js';
+export { RuntimeHookDispatcher, RuntimeHookDispatcher as PerRunRuntimeHookDispatcher } from './runtime-hook-dispatcher.js';
+export { classifyTool } from './tools/index.js';
+// Merge
+export { deepMerge, stripUndefined, resolveRunOptions } from './merge.js';
+export { ProfileManagerImpl } from './profiles.js';
+export { StreamAssembler } from './stream-assembler.js';
+export { normalizeKanbanIssue, resolveKanbanWorkflowState, resolveKanbanSwimlane, resolveKanbanStatusForWorkflowState, summarizeKanbanReviewArtifact, evaluateKanbanIssueMove, computeKanbanProjectMetrics, buildKanbanBacklogSnapshot, buildKanbanProjectBoard, buildKanbanBoardSnapshot, upsertKanbanProjectRepository, updateKanbanProjectRepositorySettings, linkKanbanIssueRepository, createKanbanIssuePullRequest, } from './kanban.js';
+export { AdapterRegistryImpl } from './adapter-registry.js';
+export { ModelRegistryImpl } from './model-registry.js';
+export { SessionManagerImpl } from './session-manager.js';
+export { ConfigManagerImpl } from './config-manager.js';
+export { AuthManagerImpl } from './auth-manager.js';
+export { PluginManagerImpl } from './plugin-manager-impl.js';
+export { detectHostHarness, DEFAULT_HOST_SIGNALS, DEFAULT_HOST_METADATA } from './host-detection.js';
+export { AgentMuxClient, createClient } from './client.js';
+export { HookConfigManager } from './hooks.js';
+export { BuiltInHooksRegistry, builtInHooks } from './builtin-hooks.js';
+export { HookDispatcher } from './hook-dispatcher.js';
+export { HOOK_CATALOG, getHookCatalog, isKnownHookType } from './hook-catalog.js';
+export { parseHookPayload, formatHookResult } from './hook-payload.js';
+export { writeFileAtomic, writeJsonAtomic } from './atomic-fs.js';
+export { PROVIDER_DEFAULTS, translateModelId, MODEL_TRANSLATION_TABLE } from './provider-config.js';
+export { resolveProvider } from './provider-resolver.js';
+export { resolveProvidersFilePath, loadProvidersFile, writeProvidersFile, upsertProviderProfile, updateProviderDefaults, loadProfile, loadProviderDefaults } from './provider-profiles.js';
+// Provider support matrix
+export { isNativelySupported, getNativeMechanism, getRequiredProxyTransport, getHarnessDefaultTransport, isTransportCompatible } from './provider-support-matrix.js';
+// Event schemas (TypeBox JSON Schema definitions for all 67 event types)
+export * as schema from './schema/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/interaction-channel-impl.d.ts

@@ -0,0 +1,56 @@
+/**
+ * InteractionChannelImpl — concrete implementation of InteractionChannel.
+ *
+ * Maintains a pending queue of interactions, fires onPending callbacks,
+ * and performs auto-resolution for 'yolo' and 'deny' approval modes.
+ */
+import type { InteractionChannel, PendingInteraction, InteractionResponse } from './interaction.js';
+import type { ApprovalRequestEvent, InputRequiredEvent } from './events.js';
+export declare class InteractionChannelImpl implements InteractionChannel {
+    /** Currently pending interactions, in arrival order. */
+    private _pending;
+    /** Registered onPending handlers. */
+    private _handlers;
+    /**
+     * Response dispatcher injected by RunHandleImpl.
+     * Called when the consumer responds to an interaction; the run handle
+     * is responsible for writing the response to the agent subprocess.
+     */
+    private _dispatch;
+    /** Whether the run is still active. Set to false when the run terminates. */
+    private _active;
+    /** Approval mode for auto-resolution. */
+    private readonly _approvalMode;
+    constructor(approvalMode?: 'yolo' | 'prompt' | 'deny');
+    get pending(): PendingInteraction[];
+    onPending(handler: (interaction: PendingInteraction) => void): () => void;
+    respond(id: string, response: InteractionResponse): Promise<void>;
+    approveAll(): Promise<void>;
+    denyAll(reason?: string): Promise<void>;
+    /**
+     * Inject the response dispatcher. Called by RunHandleImpl during construction.
+     */
+    setDispatch(dispatch: (id: string, response: InteractionResponse) => Promise<void>): void;
+    /**
+     * Mark the run as terminated. Clears pending interactions (they expire).
+     */
+    terminate(): void;
+    /**
+     * Handle an incoming approval_request event.
+     *
+     * If approvalMode is 'yolo', auto-approves without queuing.
+     * If approvalMode is 'deny', auto-denies without queuing.
+     * Otherwise, queues to pending and fires onPending handlers.
+     *
+     * @returns Whether the interaction was auto-resolved (true = handled internally).
+     */
+    handleApprovalRequest(event: ApprovalRequestEvent): boolean;
+    /**
+     * Handle an incoming input_required event.
+     *
+     * Input interactions are always queued regardless of approvalMode.
+     * (approvalMode only affects approval-type interactions.)
+     */
+    handleInputRequired(event: InputRequiredEvent): void;
+    private _addPending;
+}

package/dist/interaction-channel-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-channel-impl.d.ts","sourceRoot":"","sources":["../src/interaction-channel-impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EAGpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAM5E,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAA4B;IAE5C,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAAqD;IAEtE;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAA+E;IAEhG,6EAA6E;IAC7E,OAAO,CAAC,OAAO,CAAQ;IAEvB,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE/C,YAAY,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAiB;IAM/D,IAAI,OAAO,IAAI,kBAAkB,EAAE,CAElC;IAED,SAAS,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAQnE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIzF;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;;;;;;;OAQG;IACH,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;IAoC3D;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAoBpD,OAAO,CAAC,WAAW;CAUpB"}

package/dist/interaction-channel-impl.js

@@ -0,0 +1,159 @@
+/**
+ * InteractionChannelImpl — concrete implementation of InteractionChannel.
+ *
+ * Maintains a pending queue of interactions, fires onPending callbacks,
+ * and performs auto-resolution for 'yolo' and 'deny' approval modes.
+ */
+import { AgentMuxError } from './errors.js';
+// ---------------------------------------------------------------------------
+// InteractionChannelImpl
+// ---------------------------------------------------------------------------
+export class InteractionChannelImpl {
+    /** Currently pending interactions, in arrival order. */
+    _pending = [];
+    /** Registered onPending handlers. */
+    _handlers = [];
+    /**
+     * Response dispatcher injected by RunHandleImpl.
+     * Called when the consumer responds to an interaction; the run handle
+     * is responsible for writing the response to the agent subprocess.
+     */
+    _dispatch = null;
+    /** Whether the run is still active. Set to false when the run terminates. */
+    _active = true;
+    /** Approval mode for auto-resolution. */
+    _approvalMode;
+    constructor(approvalMode = 'prompt') {
+        this._approvalMode = approvalMode;
+    }
+    // ── InteractionChannel interface ─────────────────────────────────────────
+    get pending() {
+        return [...this._pending];
+    }
+    onPending(handler) {
+        this._handlers.push(handler);
+        return () => {
+            const idx = this._handlers.indexOf(handler);
+            if (idx !== -1)
+                this._handlers.splice(idx, 1);
+        };
+    }
+    async respond(id, response) {
+        if (!this._active) {
+            throw new AgentMuxError('RUN_NOT_ACTIVE', 'Cannot respond to an interaction after the run has terminated', false);
+        }
+        const idx = this._pending.findIndex((p) => p.id === id);
+        if (idx === -1) {
+            throw new AgentMuxError('INTERACTION_NOT_FOUND', `No pending interaction with id '${id}'`, false);
+        }
+        // Remove from pending before dispatching (prevents double-response).
+        this._pending.splice(idx, 1);
+        if (this._dispatch) {
+            await this._dispatch(id, response);
+        }
+    }
+    async approveAll() {
+        const approvals = this._pending.filter((p) => p.type === 'approval');
+        for (const interaction of approvals) {
+            await this.respond(interaction.id, { type: 'approve' });
+        }
+    }
+    async denyAll(reason) {
+        const approvals = this._pending.filter((p) => p.type === 'approval');
+        for (const interaction of approvals) {
+            await this.respond(interaction.id, { type: 'deny', reason });
+        }
+    }
+    // ── Internal methods (called by RunHandleImpl) ────────────────────────────
+    /**
+     * Inject the response dispatcher. Called by RunHandleImpl during construction.
+     */
+    setDispatch(dispatch) {
+        this._dispatch = dispatch;
+    }
+    /**
+     * Mark the run as terminated. Clears pending interactions (they expire).
+     */
+    terminate() {
+        this._active = false;
+        this._pending = [];
+    }
+    /**
+     * Handle an incoming approval_request event.
+     *
+     * If approvalMode is 'yolo', auto-approves without queuing.
+     * If approvalMode is 'deny', auto-denies without queuing.
+     * Otherwise, queues to pending and fires onPending handlers.
+     *
+     * @returns Whether the interaction was auto-resolved (true = handled internally).
+     */
+    handleApprovalRequest(event) {
+        if (this._approvalMode === 'yolo') {
+            // Auto-approve — do not queue, caller should emit approval_granted
+            if (this._dispatch) {
+                void this._dispatch(event.interactionId, { type: 'approve' });
+            }
+            return true;
+        }
+        if (this._approvalMode === 'deny') {
+            // Auto-deny — do not queue, caller should emit approval_denied
+            if (this._dispatch) {
+                void this._dispatch(event.interactionId, { type: 'deny' });
+            }
+            return true;
+        }
+        // 'prompt' mode — queue it
+        const detail = {
+            kind: 'approval',
+            action: event.action,
+            toolName: event.toolName,
+            riskLevel: event.riskLevel,
+        };
+        const interaction = {
+            id: event.interactionId,
+            type: 'approval',
+            runId: event.runId,
+            description: event.detail,
+            detail,
+            createdAt: event.timestamp,
+        };
+        this._addPending(interaction);
+        return false;
+    }
+    /**
+     * Handle an incoming input_required event.
+     *
+     * Input interactions are always queued regardless of approvalMode.
+     * (approvalMode only affects approval-type interactions.)
+     */
+    handleInputRequired(event) {
+        const detail = {
+            kind: 'input',
+            question: event.question,
+            context: event.context,
+            source: event.source,
+        };
+        const interaction = {
+            id: event.interactionId,
+            type: 'input',
+            runId: event.runId,
+            description: event.question,
+            detail,
+            createdAt: event.timestamp,
+        };
+        this._addPending(interaction);
+    }
+    // ── Private helpers ───────────────────────────────────────────────────────
+    _addPending(interaction) {
+        this._pending.push(interaction);
+        for (const handler of this._handlers) {
+            try {
+                handler(interaction);
+            }
+            catch (_err) {
+                // Swallow handler errors — they must not disrupt the interaction pipeline.
+            }
+        }
+    }
+}
+//# sourceMappingURL=interaction-channel-impl.js.map

package/dist/interaction-channel-impl.js.map

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

package/dist/interaction.d.ts

@@ -0,0 +1,93 @@
+/**
+ * InteractionChannel types for @a5c-ai/agent-mux.
+ *
+ * Defines the queue-based interaction handler for pending agent requests
+ * (approval requests and input prompts), and associated response types.
+ */
+export interface ApprovalDetail {
+    readonly kind: 'approval';
+    readonly action: string;
+    readonly toolName: string | undefined;
+    readonly riskLevel: 'low' | 'medium' | 'high';
+}
+export interface InputDetail {
+    readonly kind: 'input';
+    readonly question: string;
+    readonly context: string | undefined;
+    readonly source: 'agent' | 'tool';
+}
+/** Discriminated union for the additional context carried by a PendingInteraction. */
+export type InteractionDetail = ApprovalDetail | InputDetail;
+/**
+ * A pending interaction awaiting a response from the consumer.
+ *
+ * Created when the agent emits an `approval_request` or `input_required`
+ * event and not yet resolved.
+ */
+export interface PendingInteraction {
+    /** Unique identifier for this interaction. Matches the `interactionId` on the source event. */
+    readonly id: string;
+    /** Discriminant for the interaction type. */
+    readonly type: 'approval' | 'input';
+    /** The `runId` of the run that generated this interaction. */
+    readonly runId: string;
+    /** Human-readable description of what the agent wants to do or needs. */
+    readonly description: string;
+    /** Additional context about the interaction. */
+    readonly detail: InteractionDetail;
+    /** Timestamp (ms since epoch) when the interaction was created. */
+    readonly createdAt: number;
+}
+export interface ApproveResponse {
+    readonly type: 'approve';
+    readonly detail?: string;
+}
+export interface DenyResponse {
+    readonly type: 'deny';
+    readonly reason?: string;
+}
+export interface TextInputResponse {
+    readonly type: 'text';
+    readonly text: string;
+}
+/** A response to a pending interaction. */
+export type InteractionResponse = ApproveResponse | DenyResponse | TextInputResponse;
+/**
+ * Queue-based interaction handler for pending agent requests.
+ *
+ * Tracks all unresolved approval requests and input prompts, provides
+ * notification when new interactions arrive, and offers response methods
+ * for individual or batch resolution.
+ */
+export interface InteractionChannel {
+    /**
+     * Array of currently pending interactions, in arrival order.
+     * Read this each time you need the current state — it is not updated in place.
+     */
+    readonly pending: PendingInteraction[];
+    /**
+     * Register a callback invoked whenever a new interaction becomes pending.
+     *
+     * @returns An unsubscribe function.
+     */
+    onPending(handler: (interaction: PendingInteraction) => void): () => void;
+    /**
+     * Respond to a specific pending interaction by its ID.
+     *
+     * @throws {AgentMuxError} code `INTERACTION_NOT_FOUND` if no pending interaction matches.
+     * @throws {AgentMuxError} code `RUN_NOT_ACTIVE` if the run has terminated.
+     */
+    respond(id: string, response: InteractionResponse): Promise<void>;
+    /**
+     * Approve all currently pending approval interactions at once.
+     * Input interactions are skipped.
+     */
+    approveAll(): Promise<void>;
+    /**
+     * Deny all currently pending approval interactions.
+     * Input interactions are skipped.
+     *
+     * @param reason - Optional denial reason forwarded to the agent.
+     */
+    denyAll(reason?: string): Promise<void>;
+}

package/dist/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../src/interaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,WAAW,CAAC;AAM7D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAEpC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAMrF;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAEvC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAE1E;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/interaction.js

@@ -0,0 +1,8 @@
+/**
+ * InteractionChannel types for @a5c-ai/agent-mux.
+ *
+ * Defines the queue-based interaction handler for pending agent requests
+ * (approval requests and input prompts), and associated response types.
+ */
+export {};
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../src/interaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/invocation.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Invocation mode types for @a5c-ai/agent-mux.
+ *
+ * Defines how a harness process is spawned: locally, in Docker,
+ * on a remote machine via SSH, or on a remote k8s cluster.
+ */
+/** Local process invocation (default). Spawns directly on the host machine. */
+export interface LocalInvocation {
+    readonly mode: 'local';
+}
+/**
+ * Docker invocation. Runs the harness inside a Docker container with
+ * the working directory mounted.
+ */
+export interface DockerInvocation {
+    readonly mode: 'docker';
+    /** Docker image to use. If omitted, uses the catalog default for the harness. */
+    readonly image?: string;
+    /** Additional volumes to mount (host:container format). */
+    readonly volumes?: string[];
+    /** Additional environment variables for the container. */
+    readonly env?: Record<string, string>;
+    /** Docker network to attach to. */
+    readonly network?: string;
+    /** Working directory inside the container. @default '/workspace' */
+    readonly workdir?: string;
+}
+/**
+ * Remote SSH invocation. Connects to a remote machine, installs the
+ * harness if needed, transfers files, invokes the CLI, and copies
+ * modified files back.
+ */
+export interface SshInvocation {
+    readonly mode: 'ssh';
+    /** SSH host (user@host or just host). */
+    readonly host: string;
+    /** SSH port. @default 22 */
+    readonly port?: number;
+    /** Path to SSH identity file (private key). */
+    readonly identityFile?: string;
+    /** Remote working directory. Files are scp'd here before invocation. */
+    readonly remoteDir?: string;
+    /** Whether to install the harness on the remote machine if missing. @default true */
+    readonly autoInstall?: boolean;
+}
+/**
+ * Remote Kubernetes invocation. Snapshots relevant data, transfers it
+ * to a pod, runs the harness in a container, and copies results back.
+ */
+export interface K8sInvocation {
+    readonly mode: 'k8s';
+    /** Kubernetes namespace. @default 'default' */
+    readonly namespace?: string;
+    /** Docker image for the pod. Uses the catalog default if omitted. */
+    readonly image?: string;
+    /** Resource requests/limits for the pod. */
+    readonly resources?: {
+        readonly cpu?: string;
+        readonly memory?: string;
+    };
+    /** Kubernetes context to use. */
+    readonly context?: string;
+    /** Service account for the pod. */
+    readonly serviceAccount?: string;
+    /** Timeout for pod startup in milliseconds. @default 120000 */
+    readonly podStartupTimeoutMs?: number;
+    /**
+     * If set, `kubectl exec` into this existing pod instead of creating a new
+     * one. Mutually exclusive with `ephemeral`.
+     */
+    readonly pod?: string;
+    /**
+     * When true (default if `pod` is not provided), create a fresh ephemeral
+     * pod via `kubectl run --rm` and tear it down on exit. When false, expect
+     * `pod` to be set and `kubectl exec` into it.
+     */
+    readonly ephemeral?: boolean;
+}
+/** Discriminated union of all invocation modes. */
+export type InvocationMode = LocalInvocation | DockerInvocation | SshInvocation | K8sInvocation;
+/** All valid invocation mode discriminant strings. */
+export type InvocationModeType = InvocationMode['mode'];
+/** Entry in the harness Docker image catalog. */
+export interface HarnessImageEntry {
+    /** Harness name (e.g., 'claude-code', 'codex'). */
+    readonly harness: string;
+    /** Default Docker image for this harness. */
+    readonly image: string;
+    /** Tag to use. @default 'latest' */
+    readonly tag?: string;
+    /** Whether the image includes the harness CLI pre-installed. */
+    readonly preinstalled: boolean;
+}
+/** Default image catalog for built-in harnesses. */
+export declare const HARNESS_IMAGE_CATALOG: readonly HarnessImageEntry[];
+/**
+ * Look up the default image for a harness.
+ * Returns undefined if no catalog entry exists.
+ */
+export declare function lookupHarnessImage(harness: string): HarnessImageEntry | undefined;

package/dist/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../src/invocation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,mDAAmD;AACnD,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,aAAa,CAAC;AAElB,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAMxD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,SAAS,iBAAiB,EAAuB,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEjF"}

package/dist/invocation.js

@@ -0,0 +1,17 @@
+/**
+ * Invocation mode types for @a5c-ai/agent-mux.
+ *
+ * Defines how a harness process is spawned: locally, in Docker,
+ * on a remote machine via SSH, or on a remote k8s cluster.
+ */
+import { getHarnessImages, lookupHarnessImage as lookupCatalogHarnessImage, } from '@a5c-ai/agent-catalog';
+/** Default image catalog for built-in harnesses. */
+export const HARNESS_IMAGE_CATALOG = getHarnessImages();
+/**
+ * Look up the default image for a harness.
+ * Returns undefined if no catalog entry exists.
+ */
+export function lookupHarnessImage(harness) {
+    return lookupCatalogHarnessImage(harness);
+}
+//# sourceMappingURL=invocation.js.map

package/dist/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../src/invocation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,IAAI,yBAAyB,GAChD,MAAM,uBAAuB,CAAC;AA4G/B,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAiC,gBAAgB,EAAE,CAAC;AAEtF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}