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

package/dist/session-types.d.ts

@@ -0,0 +1,358 @@
+/**
+ * Session-related types for @a5c-ai/agent-mux.
+ *
+ * Defines the data structures for session summaries, messages, tool calls,
+ * queries, cost aggregation, and session diffs.
+ *
+ * @see 07-session-manager.md
+ */
+import type { AgentName, CostRecord } from './types.js';
+import type { WorkspaceSessionContext } from './workspaces.js';
+/** A tool call within a session message. */
+export interface SessionToolCall {
+    /** Tool call ID (agent-assigned). */
+    readonly toolCallId: string;
+    /** Name of the tool that was called. */
+    readonly toolName: string;
+    /** Input arguments passed to the tool. */
+    readonly input: unknown;
+    /** Tool output, if available. */
+    readonly output?: unknown;
+    /** Duration of the tool call in milliseconds, if recorded. */
+    readonly durationMs?: number;
+}
+/** A single message within a session. */
+export interface SessionMessage {
+    /** Role of the message author. */
+    readonly role: 'user' | 'assistant' | 'system' | 'tool';
+    /** Text content of the message. Empty string for tool-only messages. */
+    readonly content: string;
+    /** Timestamp when this message was recorded. */
+    readonly timestamp?: Date;
+    /** Tool calls initiated by this message (assistant role only). */
+    readonly toolCalls?: SessionToolCall[];
+    /** Tool result (tool role only). */
+    readonly toolResult?: {
+        readonly toolCallId: string;
+        readonly toolName: string;
+        readonly output: unknown;
+    };
+    /** Token usage for this message, if available. */
+    readonly tokenUsage?: {
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+        readonly thinkingTokens?: number;
+        readonly cachedTokens?: number;
+    };
+    /** Cost for this individual message, if available. */
+    readonly cost?: CostRecord;
+    /** Thinking/reasoning content, if the agent exposed it. */
+    readonly thinking?: string;
+    /** Model used for this specific message (may differ within a session). */
+    readonly model?: string;
+}
+export interface WorkspaceRuntimeDeviceProfile {
+    readonly id: 'desktop' | 'tablet' | 'mobile';
+    readonly label: string;
+    readonly width: number;
+    readonly height: number;
+}
+export interface WorkspaceRuntimeLogLine {
+    readonly timestamp: number;
+    readonly stream: 'stdout' | 'stderr' | 'system';
+    readonly text: string;
+}
+export interface WorkspaceTerminalCommand {
+    readonly id: string;
+    readonly runId: string;
+    readonly source: 'shell' | 'tool';
+    readonly toolName?: string;
+    readonly command: string;
+    readonly status: 'running' | 'completed' | 'failed';
+    readonly startedAt: number;
+    readonly endedAt?: number;
+    readonly exitCode?: number;
+    readonly logs: readonly WorkspaceRuntimeLogLine[];
+}
+export interface WorkspacePreviewSurface {
+    readonly status: 'ready' | 'unavailable';
+    readonly primaryUrl?: string;
+    readonly urls: readonly string[];
+    readonly detectedAt?: number;
+    readonly deviceProfiles: readonly WorkspaceRuntimeDeviceProfile[];
+}
+export interface WorkspaceTerminalSurface {
+    readonly status: 'active' | 'idle';
+    readonly commands: readonly WorkspaceTerminalCommand[];
+}
+export interface WorkspaceDevServerSurface {
+    readonly status: 'running' | 'starting' | 'idle' | 'error';
+    readonly command?: string;
+    readonly primaryUrl?: string;
+    readonly urls: readonly string[];
+    readonly port?: number;
+    readonly detectedAt?: number;
+    readonly logs: readonly WorkspaceRuntimeLogLine[];
+}
+export type WorkspaceRebaseStatus = 'idle' | 'rebase-needed' | 'rebase-conflicts' | 'ready-for-review' | 'ready-for-merge';
+export type WorkspaceRebaseLastAction = 'start' | 'auto-resolve' | 'open-in-editor' | 'manual-resolve' | 'abort';
+export interface WorkspaceRebaseSurface {
+    readonly status: WorkspaceRebaseStatus;
+    readonly branch?: string;
+    readonly targetBranch?: string;
+    readonly attemptCount: number;
+    readonly unresolvedFiles: readonly string[];
+    readonly resolvedFiles: readonly string[];
+    readonly followUpInstructions: readonly string[];
+    readonly manualResolutionSuggested: boolean;
+    readonly readyFor: 'review' | 'merge';
+    readonly editorHref?: string;
+    readonly lastAction?: WorkspaceRebaseLastAction;
+    readonly persistedAt?: number;
+}
+export interface WorkspaceRuntimeSurface {
+    readonly workspacePath?: string;
+    readonly updatedAt: number;
+    readonly preview: WorkspacePreviewSurface;
+    readonly terminal: WorkspaceTerminalSurface;
+    readonly devServer: WorkspaceDevServerSurface;
+    readonly rebase?: WorkspaceRebaseSurface;
+}
+/** Lightweight session summary returned by list() and search(). */
+export interface SessionSummary {
+    /** The agent that owns this session. */
+    readonly agent: AgentName;
+    /** The agent's native session identifier. */
+    readonly sessionId: string;
+    /** The deterministic unified ID: `<agent>:<sessionId>`. */
+    readonly unifiedId: string;
+    /** Human-readable session title. */
+    readonly title: string;
+    /** When the session was created. */
+    readonly createdAt: Date;
+    /** When the session was last modified. */
+    readonly updatedAt: Date;
+    /** Total number of conversational turns (user-assistant pairs). */
+    readonly turnCount: number;
+    /** Total number of messages (all roles). */
+    readonly messageCount: number;
+    /** Model ID used in the session. */
+    readonly model?: string;
+    /** Aggregated cost for the entire session, if available. */
+    readonly cost?: CostRecord;
+    /** Consumer-provided tags. */
+    readonly tags: string[];
+    /** Working directory at session start. */
+    readonly cwd?: string;
+    /** Workspace/worktree binding inferred or wrapped for this session. */
+    readonly workspace?: WorkspaceSessionContext;
+    /** Convenience alias for the bound workspace identifier, when known. */
+    readonly workspaceId?: string;
+    /** Whether this session was forked from another. */
+    readonly forkedFrom?: string;
+    /** Relevance score (0.0 to 1.0), present only in search results. */
+    readonly relevanceScore?: number;
+    /** Derived runtime surfaces for the session's workspace, when available. */
+    readonly runtime?: WorkspaceRuntimeSurface;
+}
+/** Full session object with all messages and metadata. */
+export interface FullSession {
+    /** The agent that owns this session. */
+    readonly agent: AgentName;
+    /** The agent's native session identifier. */
+    readonly sessionId: string;
+    /** The deterministic unified ID: `<agent>:<sessionId>`. */
+    readonly unifiedId: string;
+    /** Human-readable session title. */
+    readonly title: string;
+    /** When the session was created. */
+    readonly createdAt: Date;
+    /** When the session was last modified. */
+    readonly updatedAt: Date;
+    /** Total number of conversational turns. */
+    readonly turnCount: number;
+    /** Model ID used in the session. */
+    readonly model?: string;
+    /** Aggregated cost for the entire session. */
+    readonly cost?: CostRecord;
+    /** Consumer-provided tags. */
+    readonly tags: string[];
+    /** Working directory at session start. */
+    readonly cwd?: string;
+    /** Workspace/worktree binding inferred or wrapped for this session. */
+    readonly workspace?: WorkspaceSessionContext;
+    /** Convenience alias for the bound workspace identifier, when known. */
+    readonly workspaceId?: string;
+    /** Parent session ID if forked. */
+    readonly forkedFrom?: string;
+    /** Derived runtime surfaces for the session's workspace, when available. */
+    readonly runtime?: WorkspaceRuntimeSurface;
+    /** The ordered list of messages in this session. */
+    readonly messages: SessionMessage[];
+    /** Raw session data in the agent's native format. */
+    readonly raw?: unknown;
+}
+/**
+ * Parsed session data returned by adapter.parseSessionFile().
+ *
+ * This is the adapter-level type. The SessionManager wraps it into
+ * a FullSession with unified IDs.
+ */
+export interface Session {
+    /** Session identifier. */
+    readonly sessionId: string;
+    /** Agent that owns this session. */
+    readonly agent: AgentName;
+    /** Number of turns in the session. */
+    readonly turnCount: number;
+    /** When the session was created (ISO 8601). */
+    readonly createdAt: string;
+    /** When the session was last updated (ISO 8601). */
+    readonly updatedAt: string;
+    /** Human-readable session title. */
+    readonly title?: string;
+    /** Model used in the session. */
+    readonly model?: string;
+    /** Aggregated cost for the session. */
+    readonly cost?: CostRecord;
+    /** Consumer-provided tags. */
+    readonly tags?: string[];
+    /** Working directory at session start. */
+    readonly cwd?: string;
+    /** Workspace/worktree binding inferred or wrapped for this session. */
+    readonly workspace?: WorkspaceSessionContext;
+    /** Convenience alias for the bound workspace identifier, when known. */
+    readonly workspaceId?: string;
+    /** Parent session ID if forked. */
+    readonly forkedFrom?: string;
+    /** Parsed messages, if available. */
+    readonly messages?: SessionMessage[];
+    /** Raw session data. */
+    readonly raw?: unknown;
+}
+/** Options for the list() method. */
+export interface SessionListOptions {
+    /** Only include sessions created on or after this date. */
+    readonly since?: Date;
+    /** Only include sessions created on or before this date. */
+    readonly until?: Date;
+    /** Filter to sessions that used a specific model. */
+    readonly model?: string;
+    /** Filter to sessions with any of the specified tags. */
+    readonly tags?: string[];
+    /** Maximum number of results to return. Default: 100. */
+    readonly limit?: number;
+    /** Sort field. Default: 'date'. */
+    readonly sort?: 'date' | 'cost' | 'turns';
+    /** Sort direction. Default: 'desc'. */
+    readonly sortDirection?: 'asc' | 'desc';
+    /** Filter to sessions started in a specific working directory. */
+    readonly cwd?: string;
+}
+/** Parameters for the search() method. */
+export interface SessionQuery {
+    /** Free-text search string. */
+    readonly text: string;
+    /** Restrict search to a single agent. */
+    readonly agent?: AgentName;
+    /** Only include sessions created on or after this date. */
+    readonly since?: Date;
+    /** Only include sessions created on or before this date. */
+    readonly until?: Date;
+    /** Filter by model ID. */
+    readonly model?: string;
+    /** Filter by tags (OR match). */
+    readonly tags?: string[];
+    /** Maximum number of results. Default: 50. */
+    readonly limit?: number;
+    /** Sort order. Default: 'relevance'. */
+    readonly sort?: 'relevance' | 'date' | 'cost';
+}
+/** Parameters for cost aggregation. */
+export interface CostAggregationOptions {
+    /** Restrict to a single agent. */
+    readonly agent?: AgentName;
+    /** Only include sessions on or after this date. */
+    readonly since?: Date;
+    /** Only include sessions on or before this date. */
+    readonly until?: Date;
+    /** Filter by model ID. */
+    readonly model?: string;
+    /** Filter by tags. */
+    readonly tags?: string[];
+    /** Group results by dimension. */
+    readonly groupBy?: 'agent' | 'model' | 'day' | 'tag';
+}
+/** Aggregated cost summary. */
+export interface CostSummary {
+    /** Total cost in USD. */
+    totalUsd: number;
+    /** Total input tokens. */
+    inputTokens: number;
+    /** Total output tokens. */
+    outputTokens: number;
+    /** Total thinking tokens. */
+    thinkingTokens: number;
+    /** Total cached tokens. */
+    cachedTokens: number;
+    /** Sessions in aggregation. */
+    sessionCount: number;
+    /** Runs in aggregation. */
+    runCount: number;
+    /** Per-group breakdowns when groupBy is set. */
+    breakdowns?: Record<string, CostBreakdown>;
+}
+/** Cost breakdown for a single group. */
+export interface CostBreakdown {
+    /** Group key. */
+    readonly key: string;
+    /** Total cost in USD for this group. */
+    totalUsd: number;
+    /** Input tokens for this group. */
+    inputTokens: number;
+    /** Output tokens for this group. */
+    outputTokens: number;
+    /** Thinking tokens for this group. */
+    thinkingTokens: number;
+    /** Cached tokens for this group. */
+    cachedTokens: number;
+    /** Sessions in this group. */
+    sessionCount: number;
+}
+/** Structural diff between two sessions. */
+export interface SessionDiff {
+    /** Reference to the first session. */
+    readonly a: {
+        readonly agent: AgentName;
+        readonly sessionId: string;
+        readonly unifiedId: string;
+    };
+    /** Reference to the second session. */
+    readonly b: {
+        readonly agent: AgentName;
+        readonly sessionId: string;
+        readonly unifiedId: string;
+    };
+    /** Ordered list of diff operations. */
+    readonly operations: DiffOperation[];
+    /** Summary statistics. */
+    readonly summary: {
+        readonly added: number;
+        readonly removed: number;
+        readonly modified: number;
+        readonly unchanged: number;
+    };
+}
+/** A single diff operation describing a structural difference. */
+export interface DiffOperation {
+    /** Type of change. */
+    readonly type: 'added' | 'removed' | 'modified' | 'unchanged';
+    /** Zero-based index in session A (undefined for additions). */
+    readonly indexA?: number;
+    /** Zero-based index in session B (undefined for removals). */
+    readonly indexB?: number;
+    /** Message from session A (undefined for additions). */
+    readonly messageA?: SessionMessage;
+    /** Message from session B (undefined for removals). */
+    readonly messageB?: SessionMessage;
+}

package/dist/session-types.d.ts.map

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

package/dist/session-types.js

@@ -0,0 +1,10 @@
+/**
+ * Session-related types for @a5c-ai/agent-mux.
+ *
+ * Defines the data structures for session summaries, messages, tool calls,
+ * queries, cost aggregation, and session diffs.
+ *
+ * @see 07-session-manager.md
+ */
+export {};
+//# sourceMappingURL=session-types.js.map

package/dist/session-types.js.map

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

package/dist/spawn-invocation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Invocation mode dispatch for spawn-runner.
+ *
+ * Pure function `buildInvocationCommand` transforms a SpawnArgs + agent name
+ * into a concrete host command based on the invocation mode (local, docker,
+ * ssh, k8s). Split out of spawn-runner.ts for file-size hygiene — no
+ * behavior change.
+ */
+import type { SpawnArgs } from './adapter.js';
+import type { InvocationMode } from './invocation.js';
+/** Result of applying an invocation mode to a SpawnArgs. */
+export interface InvocationCommand {
+    /** The process to spawn on the host machine. */
+    command: string;
+    /** Arguments passed to the host process. */
+    args: string[];
+    /** Environment variables for the host process (union of host-inherited + inline). */
+    env: Record<string, string>;
+    /** Working directory for the host process. */
+    cwd: string;
+    /** Initial stdin (forwarded verbatim). */
+    stdin?: string;
+    /** Whether the host process requires shell mode. */
+    shell: boolean;
+}
+/**
+ * Transform a SpawnArgs + agent name into an InvocationCommand based on the
+ * invocation mode. This is a pure function — no subprocess is started.
+ *
+ * Modes:
+ *  - local  — returns spawnArgs unchanged (env merged).
+ *  - docker — `docker run --rm -i [-v cwd:/workspace] [-w /workspace] [-e K=V]* <image> <cmd> <args...>`.
+ *  - ssh    — `ssh [-p N] [-i key] [user@]host -- cd <cwd> && <K=V> <cmd> <args...>`.
+ *  - k8s    — `kubectl [--context C] [-n NS] exec -i <pod> -- <K=V> <cmd> <args...>`.
+ */
+export declare function buildInvocationCommand(mode: InvocationMode | undefined, spawnArgs: SpawnArgs, agent: string): InvocationCommandWithCleanup;
+/**
+ * Describe the k8s cleanup action the caller should perform on abort/exit.
+ * For ephemeral `kubectl run --rm` invocations we still emit a best-effort
+ * `kubectl delete pod --grace-period=0` so abandoned pods don't linger when
+ * the local ssh/kubectl client is killed before `--rm` fires.
+ */
+export interface K8sCleanup {
+    readonly command: 'kubectl';
+    readonly args: readonly string[];
+}
+/** Cleanup attached to an InvocationCommand built in k8s-ephemeral mode. */
+export interface InvocationCommandWithCleanup extends InvocationCommand {
+    readonly cleanup?: K8sCleanup;
+}
+/** Fire-and-forget a cleanup command (detached, stdio ignored, unref'd). */
+export declare function runCleanupDetached(cleanup: K8sCleanup): void;

package/dist/spawn-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-invocation.d.ts","sourceRoot":"","sources":["../src/spawn-invocation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,iBAAiB,CAAC;AAOrE,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,GACZ,4BAA4B,CAgG9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,4EAA4E;AAC5E,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAY5D"}

package/dist/spawn-invocation.js

@@ -0,0 +1,218 @@
+/**
+ * Invocation mode dispatch for spawn-runner.
+ *
+ * Pure function `buildInvocationCommand` transforms a SpawnArgs + agent name
+ * into a concrete host command based on the invocation mode (local, docker,
+ * ssh, k8s). Split out of spawn-runner.ts for file-size hygiene — no
+ * behavior change.
+ */
+import { spawn } from 'node:child_process';
+import { lookupHarnessImage } from './invocation.js';
+/** Shell-quote a single argument for use in a remote shell (ssh/docker sh -c). */
+function shQuote(arg) {
+    if (arg.length > 0 && /^[A-Za-z0-9_\-./=:@%+,]+$/.test(arg))
+        return arg;
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+/**
+ * Transform a SpawnArgs + agent name into an InvocationCommand based on the
+ * invocation mode. This is a pure function — no subprocess is started.
+ *
+ * Modes:
+ *  - local  — returns spawnArgs unchanged (env merged).
+ *  - docker — `docker run --rm -i [-v cwd:/workspace] [-w /workspace] [-e K=V]* <image> <cmd> <args...>`.
+ *  - ssh    — `ssh [-p N] [-i key] [user@]host -- cd <cwd> && <K=V> <cmd> <args...>`.
+ *  - k8s    — `kubectl [--context C] [-n NS] exec -i <pod> -- <K=V> <cmd> <args...>`.
+ */
+export function buildInvocationCommand(mode, spawnArgs, agent) {
+    const baseEnv = { ...spawnArgs.env };
+    if (!mode || mode.mode === 'local') {
+        return {
+            command: spawnArgs.command,
+            args: [...spawnArgs.args],
+            env: baseEnv,
+            cwd: spawnArgs.cwd,
+            stdin: spawnArgs.stdin,
+            shell: spawnArgs.shell ?? false,
+        };
+    }
+    if (mode.mode === 'docker') {
+        const image = mode.image ?? lookupHarnessImage(agent)?.image;
+        if (!image) {
+            throw new Error(`DockerInvocation: no image specified and no default docker image found for agent "${agent}"`);
+        }
+        const workdir = mode.workdir ?? '/workspace';
+        const args = ['run', '--rm', '-i'];
+        // Mount the host cwd into the container at workdir.
+        args.push('-v', `${spawnArgs.cwd}:${workdir}`);
+        args.push('-w', workdir);
+        for (const vol of mode.volumes ?? []) {
+            args.push('-v', vol);
+        }
+        if (mode.network)
+            args.push('--network', mode.network);
+        // Merge adapter env and invocation env into -e flags.
+        const merged = { ...baseEnv, ...(mode.env ?? {}) };
+        for (const [k, v] of Object.entries(merged)) {
+            args.push('-e', `${k}=${v}`);
+        }
+        args.push(image);
+        args.push(spawnArgs.command, ...spawnArgs.args);
+        return {
+            command: 'docker',
+            args,
+            env: {},
+            cwd: spawnArgs.cwd,
+            stdin: spawnArgs.stdin,
+            shell: false,
+        };
+    }
+    if (mode.mode === 'ssh') {
+        const host = mode.host;
+        const args = [];
+        if (mode.port !== undefined)
+            args.push('-p', String(mode.port));
+        if (mode.identityFile)
+            args.push('-i', mode.identityFile);
+        // `-t` forces pseudo-tty allocation so SIGTERM/SIGINT are propagated from
+        // the local ssh client to the remote process group. Required for clean
+        // teardown of long-running harness CLIs; see spec 11.
+        args.push('-t');
+        // Don't hang indefinitely on host key prompts in tests; still honour user config otherwise.
+        args.push('-o', 'BatchMode=yes');
+        args.push(host);
+        // Build the remote command: "cd <dir> && K=V ... cmd arg1 arg2" wrapped in
+        // a shell that forwards TERM/INT to the spawned child and `exec`s away so
+        // signal delivery is a single hop. `$$` is the wrapper shell's pid; since
+        // we launch the real command in the background and `wait` on its pid, the
+        // trap can forward TERM to it precisely.
+        const remoteDir = mode.remoteDir ?? spawnArgs.cwd;
+        const envPrefix = Object.entries(baseEnv)
+            .map(([k, v]) => `${k}=${shQuote(v)}`)
+            .join(' ');
+        const cmdLine = [spawnArgs.command, ...spawnArgs.args].map(shQuote).join(' ');
+        const inner = `cd ${shQuote(remoteDir)} && ${envPrefix ? envPrefix + ' ' : ''}${cmdLine}`;
+        // POSIX-sh compatible PID-forwarding wrapper. Single-quoted so the remote
+        // shell expands $! / $pid, not the local one.
+        const wrapper = `exec /bin/sh -c '` +
+            `${inner.replace(/'/g, `'\\''`)} & ` +
+            `pid=$!; ` +
+            `trap "kill -TERM $pid 2>/dev/null" TERM INT; ` +
+            `wait $pid'`;
+        args.push('--', wrapper);
+        return {
+            command: 'ssh',
+            args,
+            env: {},
+            cwd: spawnArgs.cwd,
+            stdin: spawnArgs.stdin,
+            shell: false,
+        };
+    }
+    if (mode.mode === 'k8s') {
+        return buildK8sInvocation(mode, spawnArgs, agent, baseEnv);
+    }
+    // Exhaustiveness guard.
+    const _never = mode;
+    throw new Error(`Unknown invocation mode: ${JSON.stringify(_never)}`);
+}
+/** Fire-and-forget a cleanup command (detached, stdio ignored, unref'd). */
+export function runCleanupDetached(cleanup) {
+    try {
+        const child = spawn(cleanup.command, [...cleanup.args], {
+            stdio: 'ignore',
+            shell: false,
+            detached: true,
+        });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch {
+        // best-effort
+    }
+}
+let k8sPodCounter = 0;
+function generatePodName(agent) {
+    const safe = agent.toLowerCase().replace(/[^a-z0-9-]/g, '-').slice(0, 30) || 'agent';
+    const rand = Math.random().toString(36).slice(2, 8);
+    const seq = (++k8sPodCounter).toString(36);
+    return `amux-${safe}-${Date.now().toString(36)}-${seq}-${rand}`;
+}
+function buildK8sInvocation(mode, spawnArgs, agent, baseEnv) {
+    // Existing-pod mode: explicit `pod` (or legacy AMUX_K8S_POD) and ephemeral not true.
+    const envPodOverride = process.env['AMUX_K8S_POD'];
+    const wantsEphemeral = mode.ephemeral ?? (!mode.pod && !envPodOverride);
+    const namespace = mode.namespace;
+    if (!wantsEphemeral) {
+        const args = [];
+        if (mode.context)
+            args.push('--context', mode.context);
+        if (namespace)
+            args.push('-n', namespace);
+        args.push('exec', '-i');
+        const pod = mode.pod ?? envPodOverride ?? agent;
+        args.push(pod);
+        args.push('--');
+        const envEntries = Object.entries(baseEnv);
+        if (envEntries.length > 0) {
+            args.push('env');
+            for (const [k, v] of envEntries)
+                args.push(`${k}=${v}`);
+        }
+        args.push(spawnArgs.command, ...spawnArgs.args);
+        return {
+            command: 'kubectl',
+            args,
+            env: {},
+            cwd: spawnArgs.cwd,
+            stdin: spawnArgs.stdin,
+            shell: false,
+        };
+    }
+    // Ephemeral pod lifecycle: create + run + auto-delete.
+    const image = mode.image ?? lookupHarnessImage(agent)?.image;
+    if (!image) {
+        throw new Error(`K8sInvocation: no image specified and no default docker image found for agent "${agent}"`);
+    }
+    const podName = generatePodName(agent);
+    const args = [];
+    if (mode.context)
+        args.push('--context', mode.context);
+    if (namespace)
+        args.push('-n', namespace);
+    args.push('run', '--rm', '-i', '--restart=Never', `--image=${image}`, podName);
+    if (mode.serviceAccount)
+        args.push(`--serviceaccount=${mode.serviceAccount}`);
+    if (mode.podStartupTimeoutMs !== undefined) {
+        // kubectl expects a duration; ms -> seconds rounded up.
+        const secs = Math.max(1, Math.ceil(mode.podStartupTimeoutMs / 1000));
+        args.push(`--timeout=${secs}s`);
+    }
+    const limitParts = [];
+    if (mode.resources?.cpu)
+        limitParts.push(`cpu=${mode.resources.cpu}`);
+    if (mode.resources?.memory)
+        limitParts.push(`memory=${mode.resources.memory}`);
+    if (limitParts.length > 0)
+        args.push(`--limits=${limitParts.join(',')}`);
+    for (const [k, v] of Object.entries(baseEnv)) {
+        args.push(`--env=${k}=${v}`);
+    }
+    args.push('--', spawnArgs.command, ...spawnArgs.args);
+    const cleanupArgs = [];
+    if (mode.context)
+        cleanupArgs.push('--context', mode.context);
+    if (namespace)
+        cleanupArgs.push('-n', namespace);
+    cleanupArgs.push('delete', 'pod', podName, '--grace-period=0', '--ignore-not-found=true');
+    return {
+        command: 'kubectl',
+        args,
+        env: {},
+        cwd: spawnArgs.cwd,
+        stdin: spawnArgs.stdin,
+        shell: false,
+        cleanup: { command: 'kubectl', args: cleanupArgs },
+    };
+}
+//# sourceMappingURL=spawn-invocation.js.map