@skaile/workspaces 5.18.1 → 6.0.0

package/dist/bridge/src/types.d.ts

@@ -1,23 +1,23 @@
 import { EventEmitter } from "node:events";
 import type { Span, TelemetryProvider, Trace } from "@skaile/workspaces/telemetry";
-import type { AgentPromptInput, Capability, CredentialMint, CodexCredentialDelivery, ContextUsageDetail, DriverContextReport, DriverInfo, ErrorRetryReason, CodexSubscriptionRefreshInput, CodexSubscriptionRefreshResult, FlowExecution, ModelTokenUsage, RenderInvokedEvent, TokenUsage } from "@skaile/workspaces/types";
+import type { AgentPromptInput, Capability, CredentialMint, CodexCredentialDelivery, ContextUsageDetail, HarnessContextReport, HarnessInfo, ErrorRetryReason, CodexSubscriptionRefreshInput, CodexSubscriptionRefreshResult, FlowExecution, ModelTokenUsage, RenderInvokedEvent, TokenUsage } from "@skaile/workspaces/types";
 import type { CodexServerRequestHandlers } from "./codex-app-server.js";
 export type { AgentPromptInput } from "@skaile/workspaces/types";
 import type { MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
 import type { ModelEntry } from "./models.js";
 /**
- * Test-only hook injected by the runner so a no-LLM driver (the echo driver's
+ * Test-only hook injected by the runner so a no-LLM harness (the echo harness's
  * scripted-flow mode) can read flow state and drive flow-adapter mutations
  * without an SDK/MCP round-trip. The runner wires this in `createActiveFlow`
  * from the active FlowAdapter + handle.
  *
- * This is an internal runner↔driver interface — NOT part of any wire
- * protocol or flow contract. Production drivers ignore it.
+ * This is an internal runner↔harness interface — NOT part of any wire
+ * protocol or flow contract. Production harnesses ignore it.
  *
- * @see packages/bridge/drivers/echo — scripted-flow mode
+ * @see packages/bridge/harnesses/echo — scripted-flow mode
  * @since 3.6.0
  */
-export interface FlowTestDriverHook {
+export interface FlowTestHarnessHook {
     /** Current flow execution snapshot, or `null` when no flow is active. */
     getState(): FlowExecution | null;
     /**
@@ -36,7 +36,7 @@ export interface FlowTestDriverHook {
 }
 /**
  * Minimal LLM tool descriptor used by the capability dispatch path. Mirrors
- * the runner's `LLMTool` shape so drivers can consume registry output without
+ * the runner's `LLMTool` shape so harnesses can consume registry output without
  * importing `@skaile/workspaces/runner` (which would create a circular dep).
  *
  * @category Capabilities
@@ -75,12 +75,12 @@ export type BridgeRenderEmit = (event: RenderInvokedEvent) => void;
  */
 export type BridgeTextEmit = (text: string) => void;
 /**
- * Bundle of capability dispatch hooks. Registered into the driver via
- * `AgentConfig.capabilities`; the driver routes registered LLM tool calls
+ * Bundle of capability dispatch hooks. Registered into the harness via
+ * `AgentConfig.capabilities`; the harness routes registered LLM tool calls
  * back into `invoke()` instead of using its native dispatch path.
  *
  * The runner constructs this from a `CapabilityRegistry` instance and threads
- * it through `createAgentSession()`. Drivers that don't yet implement
+ * it through `createAgentSession()`. Harnesses that don't yet implement
  * capability dispatch ignore the field — legacy v1 paths stay intact.
  *
  * @category Capabilities
@@ -97,7 +97,7 @@ export interface BridgeCapabilityHooks {
      * registry.
      *
      * `callId` is the per-dispatch id minted by `dispatchCapability`. It MUST be
-     * unique per process (never a driver/provider tool-call id, which only the
+     * unique per process (never a harness/provider tool-call id, which only the
      * model backend keeps unique): it is the `render_invoked.callId`, the
      * registry's log correlation id, the handler's `ctx.callId` and — for client
      * capabilities — the `capability_invoked.callId` keying the runner's pending
@@ -116,18 +116,18 @@ export interface BridgeCapabilityHooks {
     sessionId: string;
 }
 /**
- * Static metadata for a registered agent driver (the harness it drives).
+ * Static metadata for a registered agent harness (the coding-agent product it drives).
  *
  * Declared once in `@skaile/workspaces/types` — it is protocol surface (the
  * platform reads `surfaces` to decide which AI provider registry entries a
- * driver can serve) and was previously duplicated here field-for-field.
+ * harness can serve) and was previously duplicated here field-for-field.
  *
- * Returned by {@link listDrivers} and exposed on every {@link AgentDriver}
- * instance via `driverInfo`.
+ * Returned by {@link listHarnesses} and exposed on every {@link AgentHarness}
+ * instance via `harnessInfo`.
  *
- * @docLink packages/bridge/concepts#driver-info
+ * @docLink packages/bridge/concepts#harness-info
  */
-export type { DriverInfo };
+export type { HarnessInfo };
 /** Closed, passive managed-MCP observations. Counts saturate at 512. */
 export interface CodexNativeMcpDiagnostics {
     startupBeforeTurn: "unknown" | "starting" | "ready" | "failed" | "cancelled";
@@ -189,12 +189,12 @@ export interface CodexManagedRuntimeOptions {
     interactionTimeoutMs?: number;
 }
 /**
- * Codex-specific tuning options passed through `DriverOptions.codex`.
+ * Codex-specific tuning options passed through `HarnessOptions.codex`.
  *
- * @remarks These are forwarded verbatim to the Codex driver and have no effect on other drivers.
- * @docLink packages/bridge/concepts#codex-driver-options
+ * @remarks These are forwarded verbatim to the Codex harness and have no effect on other harnesses.
+ * @docLink packages/bridge/concepts#codex-harness-options
  */
-export interface CodexDriverOptions {
+export interface CodexHarnessOptions {
     /** Omission retains the standalone SDK path; managed mode always requires App Server inputs. */
     authSource?: "local" | "managed";
     managedRuntime?: CodexManagedRuntimeOptions;
@@ -210,16 +210,16 @@ export interface CodexDriverOptions {
     additionalDirectories?: string[];
 }
 /**
- * omp-specific options passed through `DriverOptions.omp`.
+ * omp-specific options passed through `HarnessOptions.omp`.
  *
  * They govern the session-private agent directory the omp adapter renders the
  * provider registry into (`omp-models-yml.ts`); every one of them has a
  * working default, so a caller that sets none still gets a correct session.
  *
- * @remarks Forwarded verbatim to the omp driver; no effect on other drivers.
+ * @remarks Forwarded verbatim to the omp harness; no effect on other harnesses.
  * @see PROVIDER-CONFIG-PLAN.md §2.3
  */
-export interface OmpDriverOptions {
+export interface OmpHarnessOptions {
     /**
      * Explicit session-private agent directory for `PI_CODING_AGENT_DIR`.
      * Defaults to `<cwd>/.omp/agent-home/<sessionId>`.
@@ -227,7 +227,7 @@ export interface OmpDriverOptions {
     agentHome?: string;
     /**
      * Inherit the developer's own omp state (auth store, blobs, extensions) by
-     * symlinking {@link OmpDriverOptions.userAgentDir} into the session
+     * symlinking {@link OmpHarnessOptions.userAgentDir} into the session
      * directory. Defaults to *on when that directory exists*, which is exactly
      * the standalone case: a platform container has none, so its session starts
      * empty. Set `false` to force an empty session directory regardless.
@@ -237,21 +237,21 @@ export interface OmpDriverOptions {
     userAgentDir?: string;
 }
 /**
- * Driver-specific configuration bag.
+ * Harness-specific configuration bag.
  *
- * Fields are keyed by driver ID so that callers can pass driver-specific options
- * through the common {@link AgentConfig} without breaking other drivers.
+ * Fields are keyed by harness ID so that callers can pass harness-specific options
+ * through the common {@link AgentConfig} without breaking other harnesses.
  *
- * @docLink packages/bridge/concepts#driver-options
+ * @docLink packages/bridge/concepts#harness-options
  */
-export interface DriverOptions {
-    /** Codex-specific options. Ignored by all other drivers. */
-    codex?: CodexDriverOptions;
-    /** omp-specific options. Ignored by all other drivers. */
-    omp?: OmpDriverOptions;
+export interface HarnessOptions {
+    /** Codex-specific options. Ignored by all other harnesses. */
+    codex?: CodexHarnessOptions;
+    /** omp-specific options. Ignored by all other harnesses. */
+    omp?: OmpHarnessOptions;
 }
 /**
- * What the driver tells the host about a turn blocked by an upstream usage
+ * What the harness tells the host about a turn blocked by an upstream usage
  * limit. Everything but `configId` is best-effort: the SDK reports the limit
  * window only on its structured telemetry, not on the error result text.
  *
@@ -271,7 +271,7 @@ export interface LimitBlockedContext {
 }
 /**
  * The host's verdict on a limit-blocked turn. `switched: true` is a promise
- * that a different seat's credential is already on disk — the driver acts on it
+ * that a different seat's credential is already on disk — the harness acts on it
  * by respawning the CLI and replaying the prompt, so returning it without
  * having rewritten the credential file would just replay onto the dead seat.
  *
@@ -288,7 +288,7 @@ export interface LimitFailoverResult {
      * Why no switch happened: `same-config`, `standalone`,
      * `platform-omitted-config-id` (the mint succeeded but named no seat, so a
      * re-resolution is indistinguishable from none), or a `CredentialMint`
-     * failure code. Diagnostic only — the driver branches on `switched`.
+     * failure code. Diagnostic only — the harness branches on `switched`.
      */
     reason?: string;
 }
@@ -311,15 +311,15 @@ export interface ProviderResponseObservation {
     /** Epoch seconds at which the limit window resets, when reported. */
     resetsAt?: number;
     /**
-     * What the 429 was, when the driver recognised something narrower than a
+     * What the 429 was, when the harness recognised something narrower than a
      * usage limit. `long-context-entitlement`: the account may not use a long
      * (1M) context window; the seat is not out of quota. Diagnostic only — the
-     * driver still treats the rejection as before.
+     * harness still treats the rejection as before.
      */
     cause?: ProviderResponseCause;
 }
 /**
- * Why a 429 {@link ProviderResponseObservation} was rejected, when the driver
+ * Why a 429 {@link ProviderResponseObservation} was rejected, when the harness
  * recognised it. Consumers must tolerate values they do not know.
  *
  * @category Configuration
@@ -358,14 +358,14 @@ export type AgentEffort = (typeof AGENT_EFFORT_LEVELS)[number];
 /**
  * Narrow a free-form effort (the wire `agentConfig.effort`, a `skaile.yaml`
  * default) to an {@link AgentEffort}; anything else gives `undefined`, so an
- * unknown value never reaches a driver.
+ * unknown value never reaches a harness.
  */
 export declare function toAgentEffort(value: unknown): AgentEffort | undefined;
 /**
- * Configuration passed to a driver when it is created via {@link createDriver}.
+ * Configuration passed to a harness when it is created via {@link createHarness}.
  *
- * All fields are shared across drivers; driver-specific behaviour is documented
- * per field. Fields that are silently ignored by a driver are marked accordingly.
+ * All fields are shared across harnesses; harness-specific behaviour is documented
+ * per field. Fields that are silently ignored by a harness are marked accordingly.
  *
  * @docLink packages/bridge/concepts#agent-config
  */
@@ -376,22 +376,22 @@ export interface AgentConfig {
      * LLM model identifier (e.g. `"claude-sonnet-4-5"`, `"gpt-4o"`).
      *
      * The unscoped fallback: {@link AgentConfig.modelRef} is what a session
-     * normally carries, and this is what a driver falls back to when no
+     * normally carries, and this is what a harness falls back to when no
      * registry entry resolved one.
      */
     model?: string;
     /**
-     * The AI provider registry for this session — every endpoint the driver may
+     * The AI provider registry for this session — every endpoint the harness may
      * address, already merged across the catalog / user / workspace / runtime /
      * control-plane layers and in registry order.
      *
-     * This is the *only* provider surface a driver reads. Entries reference
+     * This is the *only* provider surface a harness reads. Entries reference
      * their credential (`credential.ref`) and never carry the secret itself;
      * the value reaches the child under `SKAILE_AIP_<ID>_KEY`
      * (`provider-materialize/credential-env.ts`), which the session boundary
      * puts in {@link AgentConfig.env}.
      *
-     * Absent (or empty) means no endpoint was configured at all — the driver
+     * Absent (or empty) means no endpoint was configured at all — the harness
      * then falls back to whatever native auth it can discover on its own (a
      * `claude` OAuth login, `codex login`, an ambient vendor key).
      */
@@ -400,7 +400,7 @@ export interface AgentConfig {
      * Model selector resolved against {@link AgentConfig.registry}:
      * `"<providerId>/<modelId>"`, a bare `"<modelId>"` (first registry entry
      * that maps it wins), or `"@role"`. Absent when no model was configured at
-     * all — the driver then applies its own default, exactly as it does for an
+     * all — the harness then applies its own default, exactly as it does for an
      * absent `model`.
      */
     modelRef?: string;
@@ -408,7 +408,7 @@ export interface AgentConfig {
      * The `skaile.yaml` `roles` table — role name → model selector
      * (`{default: "anthropic/opus", smol: "groq/llama-3.1-8b"}`, §9.8). It is
      * what `"@role"` in {@link AgentConfig.modelRef} expands through, and what
-     * a driver that supports per-role models materializes natively: omp renders
+     * a harness that supports per-role models materializes natively: omp renders
      * it as `modelRoles` in its session-private `config.yml`, so `@smol` inside
      * the session reaches a different provider than `@default`.
      *
@@ -420,12 +420,12 @@ export interface AgentConfig {
      * Additional environment variables merged into the child process
      * environment. The session boundary delivers resolved registry credentials
      * here as `SKAILE_AIP_<ID>_KEY` entries; anything else the caller sets is
-     * merged over the driver's own allowlist, never instead of it.
+     * merged over the harness's own allowlist, never instead of it.
      */
     env?: Record<string, string>;
-    /** Inline system prompt — written to .omp/system.md and passed via --append-system-prompt (omp driver) */
+    /** Inline system prompt — written to .omp/system.md and passed via --append-system-prompt (omp harness) */
     systemPrompt?: string;
-    /** Path to project .omp/ directory (PI_CODING_AGENT_DIR for omp driver) */
+    /** Path to project .omp/ directory (PI_CODING_AGENT_DIR for omp harness) */
     agentDir?: string;
     /** SSH key path — injected as GIT_SSH_COMMAND */
     sshKeyPath?: string;
@@ -445,11 +445,11 @@ export interface AgentConfig {
      *   `Deny`) answered through `answerQuestion`. With {@link AgentConfig.unattended} the call is
      *   refused instead.
      * - codex (standalone SDK path): `interactive` sets `approvalPolicy: "on-request"` instead of
-     *   `never`, unless `driverOptions.codex.approvalPolicy` is set. The standalone SDK path has no
+     *   `never`, unless `harnessOptions.codex.approvalPolicy` is set. The standalone SDK path has no
      *   way to show an approval card, so codex refuses a command that needs to leave its sandbox
      *   instead of asking; nothing is ever approved. A managed codex session keeps the host's own
      *   policy.
-     * - omp, echo and the subprocess CLI drivers (gemini, qwen, opencode, goose, continue): ignored.
+     * - omp, echo and the subprocess CLI harnesses (gemini, qwen, opencode, goose, continue): ignored.
      */
     permissionMode?: "auto" | "interactive";
     /**
@@ -462,7 +462,7 @@ export interface AgentConfig {
      *  claude-sdk: passed as `agent` option to query() → reads .claude/agents/<name>.md natively.
      *  omp: ignored (omp uses agentDir/PI_CODING_AGENT_DIR instead). */
     agentName?: string;
-    /** In-process SDK MCP servers for custom tool injection (Claude SDK only, ignored by other drivers) */
+    /** In-process SDK MCP servers for custom tool injection (Claude SDK only, ignored by other harnesses) */
     mcpServers?: Record<string, unknown>;
     /** Tool restrictions from agent.yaml — applied to the main agent session */
     tools?: {
@@ -473,12 +473,12 @@ export interface AgentConfig {
     };
     /** Thinking mode for Claude models: adaptive (Claude decides), enabled (always think), disabled (no thinking). */
     thinking?: "adaptive" | "enabled" | "disabled";
-    /** Reasoning effort level; each driver maps it to its own scale (see {@link AgentEffort}). */
+    /** Reasoning effort level; each harness maps it to its own scale (see {@link AgentEffort}). */
     effort?: AgentEffort;
-    /** Driver-specific configuration bag. */
-    driverOptions?: DriverOptions;
+    /** Harness-specific configuration bag. */
+    harnessOptions?: HarnessOptions;
     /**
-     * Protocol v2 capability dispatch hooks. When present, the driver uses the
+     * Protocol v2 capability dispatch hooks. When present, the harness uses the
      * registry as the source of LLM tool definitions and routes invocations
      * through `capabilities.invoke()`. Absent → legacy v1 path (existing
      * mcpServers / native dispatch).
@@ -488,9 +488,9 @@ export interface AgentConfig {
     capabilities?: BridgeCapabilityHooks;
     /**
      * The platform's `AIProviderConfig.id` for the AI credential currently
-     * provisioned into this driver. The runner reads this off `AgentConfig`
+     * provisioned into this harness. The runner reads this off `AgentConfig`
      * during 401 mediation and passes it as `configId` in
-     * `request_access_token { kind: 'ai-credentials' }`. The driver itself
+     * `request_access_token { kind: 'ai-credentials' }`. The harness itself
      * does not consume this field — only the runner uses it.
      *
      * Set by the platform agent-gateway in `ConfigureCommandV2` for mediated
@@ -505,27 +505,27 @@ export interface AgentConfig {
      */
     aiProviderConfigId?: string;
     /**
-     * Optional callback invoked by the driver when the underlying agent
+     * Optional callback invoked by the harness when the underlying agent
      * surfaces an `authentication_error`. In Protocol v3 the runner mediates
      * the refresh via the `host.refresh_credential` capability and returns a
-     * typed {@link CredentialMint}. The driver inspects the discriminator:
+     * typed {@link CredentialMint}. The harness inspects the discriminator:
      *
      *   - `mint.ok === true`: a fresh credential is now provisioned. The
-     *     driver re-attempts the in-flight prompt once.
+     *     harness re-attempts the in-flight prompt once.
      *   - `mint.ok === false`: refresh failed (`code` carries a stable reason
      *     such as `revoked`, `not-configured`, `provider-error`,
-     *     `backend-error`). The driver surfaces the original `AuthError` to
+     *     `backend-error`). The harness surfaces the original `AuthError` to
      *     the caller.
      *
-     * `args.configId` carries the platform `AIProviderConfig.id` the driver
+     * `args.configId` carries the platform `AIProviderConfig.id` the harness
      * was provisioned with (mirrors {@link AgentConfig.aiProviderConfigId}).
      * The runner uses it to scope the refresh to the correct AI credential.
      *
-     * When omitted, the driver throws `AuthError` immediately as before
+     * When omitted, the harness throws `AuthError` immediately as before
      * (standalone CLI / forge mode — there is no platform mediator to ask).
      *
-     * Centralising auth-retry inside the driver means every consumer of
-     * `driver.prompt(...)` (serve handler, compaction orchestrator, flow
+     * Centralising auth-retry inside the harness means every consumer of
+     * `harness.prompt(...)` (serve handler, compaction orchestrator, flow
      * orchestrator, …) gets self-healing for free — there is no per-call-site
      * wrapping.
      *
@@ -538,7 +538,7 @@ export interface AgentConfig {
         configId: string;
     }) => Promise<CredentialMint>;
     /**
-     * Optional callback invoked by the driver when a turn is blocked by an
+     * Optional callback invoked by the harness when a turn is blocked by an
      * upstream **usage limit** rather than a bad credential — the subscription
      * five-hour / seven-day ceiling, or any `rate_limit` the classifier
      * recognises. Called at most once per logical turn, and only after the
@@ -547,11 +547,11 @@ export interface AgentConfig {
      * The runner implements it by asking the platform to re-resolve the seat:
      *
      *   - `switched: true` — the session was repointed at a DIFFERENT AI
-     *     provider config and `.credentials.json` was rewritten. The driver
+     *     provider config and `.credentials.json` was rewritten. The harness
      *     drops its query (forcing a fresh CLI spawn, which is what clears a
      *     resident CLI's cached "blocked until <reset>" state — a hot file
      *     rewrite alone does not) and replays the prompt once.
-     *   - `switched: false` — no alternative seat was available. The driver
+     *   - `switched: false` — no alternative seat was available. The harness
      *     surfaces the original limit error unchanged.
      *
      * Left unset by standalone runners (CLI / forge / Claude plugin): there is
@@ -566,14 +566,14 @@ export interface AgentConfig {
      */
     onLimitBlocked?: (ctx: LimitBlockedContext) => Promise<LimitFailoverResult>;
     /**
-     * Optional fire-and-forget hook invoked when the driver observes a 401 or a
+     * Optional fire-and-forget hook invoked when the harness observes a 401 or a
      * 429 / subscription-limit rejection from the AI provider. The runner
      * forwards it to the platform as a `provider_response_seen` event so the
      * owning `AIProviderConfig`'s live health counters can be bumped — the cron
      * health probe only samples auth, never capacity
      * (skaile-ai/workspaces#368, skaile-ai/platform#3539).
      *
-     * Never awaited and never retried; the driver swallows a throwing
+     * Never awaited and never retried; the harness swallows a throwing
      * implementation so telemetry can never fail a turn.
      *
      * @since 3.9.0
@@ -586,7 +586,7 @@ export interface AgentConfig {
      * the platform has for a seat whose token cannot read the OAuth usage
      * endpoint (a `claude setup-token` seat).
      *
-     * Never awaited and never retried; the driver swallows a throwing
+     * Never awaited and never retried; the harness swallows a throwing
      * implementation so telemetry can never fail a turn. Unlike
      * {@link onProviderResponse} it fires on every event, so dedupe at the host.
      *
@@ -594,14 +594,14 @@ export interface AgentConfig {
      */
     onProviderQuota?: (observation: ProviderQuotaObservation) => void;
     /**
-     * Test-only flow driver hook. When present, the echo driver's scripted-flow
+     * Test-only flow harness hook. When present, the echo harness's scripted-flow
      * mode uses it to advance flow nodes deterministically (no LLM). The runner
-     * injects it in `createActiveFlow`; every other driver ignores it.
+     * injects it in `createActiveFlow`; every other harness ignores it.
      *
-     * @see FlowTestDriverHook
+     * @see FlowTestHarnessHook
      * @since 3.6.0
      */
-    flowTestDriver?: FlowTestDriverHook;
+    flowTestHarness?: FlowTestHarnessHook;
 }
 /**
  * A single message in an agent conversation.
@@ -632,7 +632,7 @@ export interface AgentMessage {
 /**
  * A typed block within an {@link AgentMessage}'s content array.
  *
- * Mirrors the Anthropic content block schema but is driver-agnostic.
+ * Mirrors the Anthropic content block schema but is harness-agnostic.
  *
  * @docLink packages/bridge/concepts#content-block
  */
@@ -707,12 +707,12 @@ export interface SlashCommandInfo {
     argumentHint?: string;
 }
 /**
- * Discriminated union of all events emitted by a driver on the `'agent-event'` channel.
+ * Discriminated union of all events emitted by a harness on the `'agent-event'` channel.
  *
  * @remarks
- * Consumers listen via `driver.on('agent-event', (event: AgentEvent) => ...)`.
- * The `[k: string]: any` index signature on most variants allows drivers to attach
- * driver-specific fields (e.g. `_textDelta`) without breaking the union.
+ * Consumers listen via `harness.on('agent-event', (event: AgentEvent) => ...)`.
+ * The `[k: string]: any` index signature on most variants allows harnesses to attach
+ * harness-specific fields (e.g. `_textDelta`) without breaking the union.
  *
  * @docLink packages/bridge/concepts#agent-event
  */
@@ -731,7 +731,7 @@ export type AgentEvent = {
 }
 /**
  * Takes back `text`, the unfinished tail of streamed `_textDelta`s, before the
- * driver replays an abandoned attempt. Always a suffix of what was streamed
+ * harness replays an abandoned attempt. Always a suffix of what was streamed
  * since the last completed assistant message; see `TextRetractEvent` in the types package.
  */
  | {
@@ -752,7 +752,7 @@ export type AgentEvent = {
     taskId: string;
     [k: string]: any;
 }
-/** A turn the driver was not prompted for began; see `SelfTurnStartedEvent`. */
+/** A turn the harness was not prompted for began; see `SelfTurnStartedEvent`. */
  | {
     type: "self_turn_started";
     taskIds: string[];
@@ -762,7 +762,7 @@ export type AgentEvent = {
     subtype: string;
     summary?: string;
     costUsd?: number;
-    /** Per-turn token usage when the driver tracks it. Added in 3.1.0. */
+    /** Per-turn token usage when the harness tracks it. Added in 3.1.0. */
     tokens?: TokenUsage;
     /** Per-turn usage keyed by model, subagent calls included. Added in 3.11.0. */
     modelUsage?: Record<string, ModelTokenUsage>;
@@ -777,7 +777,7 @@ export type AgentEvent = {
     error: string;
     detail?: AgentError;
     fatal?: boolean;
-    /** Set (with `fatal: false`) when the driver replays the prompt in place; see `ErrorEvent.retrying`. */
+    /** Set (with `fatal: false`) when the harness replays the prompt in place; see `ErrorEvent.retrying`. */
     retrying?: boolean;
     retryReason?: ErrorRetryReason;
     /** Usage of a failed provider turn, when reported. */
@@ -806,7 +806,7 @@ export type AgentEvent = {
     commands: SlashCommandInfo[];
 } | {
     type: "session_info";
-    driverSessionId: string;
+    harnessSessionId: string;
     sessionFile?: string;
 } | {
     type: "ui_render";
@@ -826,7 +826,7 @@ export type AgentEvent = {
 /** The settings a live reconfigure may change. */
 export type ReconfigurePatch = Partial<Pick<AgentConfig, "model" | "thinking" | "effort">>;
 /**
- * What a driver now holds for the fields of an accepted reconfigure. `modelRef`
+ * What a harness now holds for the fields of an accepted reconfigure. `modelRef`
  * is the registry selector the model was scoped to; it is absent when the
  * session has none. A host remembers exactly this, never the raw patch.
  */
@@ -837,14 +837,14 @@ export interface ReconfigureApplied {
     effort?: AgentConfig["effort"];
 }
 /**
- * Result of `AgentDriver.reconfigure()`. `ok: true` means effective from the
- * next turn (live switch, query recycle or respawn); a driver that cannot
+ * Result of `AgentHarness.reconfigure()`. `ok: true` means effective from the
+ * next turn (live switch, query recycle or respawn); a harness that cannot
  * promise that answers `ok: false` instead.
  *
- * - `not_supported`: the driver cannot change settings live.
+ * - `not_supported`: the harness cannot change settings live.
  * - `model_not_on_provider`: the session's AI provider entry does not list the
  *   model (`providerId` names the entry).
- * - `rejected`: the running process refused the change; the driver config is
+ * - `rejected`: the running process refused the change; the harness config is
  *   unchanged.
  *
  * @category Bridge
@@ -859,50 +859,50 @@ export type ReconfigureOutcome = {
     providerId?: string;
 };
 /**
- * A reconfigure the driver answered `ok` (it landed mid-turn) and then refused
- * at the next turn boundary. The driver already rolled its config back;
+ * A reconfigure the harness answered `ok` (it landed mid-turn) and then refused
+ * at the next turn boundary. The harness already rolled its config back;
  * `requested` is what was asked, `restored` what it holds again. Emitted as the
- * driver event `'reconfigure-rollback'`.
+ * harness event `'reconfigure-rollback'`.
  */
 export interface ReconfigureRollback {
     message: string;
     requested: ReconfigureApplied;
     restored: ReconfigureApplied;
 }
-/** Rejection message of a driver asked to run a turn under a tool allowlist it cannot enforce. */
+/** Rejection message of a harness asked to run a turn under a tool allowlist it cannot enforce. */
 export declare const TOOL_ALLOWLIST_UNSUPPORTED = "This agent harness cannot enforce a tool allowlist";
 /**
- * Abstract base class for agent drivers.
+ * Abstract base class for agent harnesses.
  *
  * Wraps an LLM coding agent behind a single `prompt()` interface.
- * All drivers emit `'agent-event'` with {@link AgentEvent} payloads.
+ * All harnesses emit `'agent-event'` with {@link AgentEvent} payloads.
  *
  * @remarks
  * Subclasses must implement `start`, `prompt`, `abort`, `kill`, and `isRunning`.
  * Implementations should never emit an event name other than `'agent-event'` as
  * the public streaming channel — internal events (`'ready'`, `'exit'`, etc.) are
- * driver-private. The one other public event is `'reconfigure-rollback'` (a
- * {@link ReconfigureRollback}): a live reconfigure the driver had accepted and
- * then refused at the turn boundary, already rolled back in the driver.
+ * harness-private. The one other public event is `'reconfigure-rollback'` (a
+ * {@link ReconfigureRollback}): a live reconfigure the harness had accepted and
+ * then refused at the turn boundary, already rolled back in the harness.
  *
  * @example
  * ```ts
- * const driver = createDriver('omp', config);
- * driver.on('agent-event', (event) => console.log(event.type));
- * await driver.start();
- * await driver.prompt('Refactor the auth module');
- * driver.kill();
+ * const harness = createHarness('omp', config);
+ * harness.on('agent-event', (event) => console.log(event.type));
+ * await harness.start();
+ * await harness.prompt('Refactor the auth module');
+ * harness.kill();
  * ```
  *
- * @docLink packages/bridge/concepts#agent-driver
+ * @docLink packages/bridge/concepts#agent-harness
  */
-export declare abstract class AgentDriver extends EventEmitter {
-    /** Static metadata describing this driver's capabilities. */
-    abstract readonly driverInfo: DriverInfo;
+export declare abstract class AgentHarness extends EventEmitter {
+    /** Static metadata describing this harness's capabilities. */
+    abstract readonly harnessInfo: HarnessInfo;
     /**
-     * Initialises the driver's harness — spawns the child process (omp) or loads
+     * Initialises the harness — spawns the child process (omp) or loads
      * the SDK module (claude-sdk). Resolves when the harness is ready to accept
-     * prompts. Idempotent: calling `start()` on an already-running driver is a no-op.
+     * prompts. Idempotent: calling `start()` on an already-running harness is a no-op.
      *
      * @throws {Error} When the harness binary is missing or the SDK cannot be loaded.
      */
@@ -912,64 +912,64 @@ export declare abstract class AgentDriver extends EventEmitter {
      * (i.e. after the `agent_end` event has been emitted).
      *
      * @param message - Plain-text user prompt to send to the agent.
-     * @throws {Error} When the driver is not running or the underlying harness reports a fatal error.
+     * @throws {Error} When the harness is not running or the underlying coding agent reports a fatal error.
      */
     abstract prompt(message: string): Promise<void>;
     /**
-     * Preserve text-only callers; drivers must explicitly support attachments.
-     * A `toolAllowlist` is refused here: only a driver that overrides
+     * Preserve text-only callers; harnesses must explicitly support attachments.
+     * A `toolAllowlist` is refused here: only a harness that overrides
      * {@link enforcesToolAllowlist} may run a restricted turn.
      */
     promptInput(input: AgentPromptInput): Promise<void>;
     /**
      * Whether {@link promptInput} enforces `AgentPromptInput.toolAllowlist` for
-     * the whole turn, subagents included. A driver that answers `false` must
+     * the whole turn, subagents included. A harness that answers `false` must
      * reject an input carrying one; the runner refuses such a prompt before it
-     * reaches the driver.
+     * reaches the harness.
      */
     get enforcesToolAllowlist(): boolean;
     /**
-     * The names in `allowlist` this driver does not recognize as a tool it could
+     * The names in `allowlist` this harness does not recognize as a tool it could
      * offer. The runner refuses a prompt whose allowlist names any, rather than
-     * guess. A driver that does not enforce allowlists recognizes none.
+     * guess. A harness that does not enforce allowlists recognizes none.
      */
     unknownAllowlistedTools(allowlist: readonly string[]): string[];
     /** Managed replies never fall back to a new prompt after a request has settled. */
     get acceptsReplyAsPrompt(): boolean;
     /**
      * Sends an in-band abort signal to the agent, requesting it to stop the current
-     * turn without terminating the process. The driver remains usable after `abort()`.
+     * turn without terminating the process. The harness remains usable after `abort()`.
      *
-     * @remarks Only meaningful when `driverInfo.supportsInBandAbort` is `true`.
-     *   For other drivers, prefer `kill()` followed by creating a new driver instance.
+     * @remarks Only meaningful when `harnessInfo.supportsInBandAbort` is `true`.
+     *   For other harnesses, prefer `kill()` followed by creating a new harness instance.
      */
     abstract abort(): Promise<void>;
     /**
-     * Terminates the agent harness immediately (SIGTERM for subprocess drivers,
-     * `close()` for in-process drivers). The driver instance must not be reused
+     * Terminates the agent harness immediately (SIGTERM for subprocess harnesses,
+     * `close()` for in-process harnesses). The harness instance must not be reused
      * after `kill()`.
      */
     abstract kill(): void;
-    /** Stop the driver and await owned process/state cleanup when the harness supports it. */
+    /** Stop the harness and await owned process/state cleanup when the harness supports it. */
     dispose(): Promise<void>;
     /** `true` when the harness is alive and able to accept new prompts. */
     abstract get isRunning(): boolean;
     /** Optional provider-native session/thread identifier for resume support. */
     get runtimeSessionId(): string | undefined;
-    /** Slash commands discovered from the agent runtime. Override in drivers that support introspection. */
+    /** Slash commands discovered from the agent runtime. Override in harnesses that support introspection. */
     getSlashCommands(): SlashCommandInfo[];
     /**
-     * `true` while the driver is paused on an interactive question and waiting
+     * `true` while the harness is paused on an interactive question and waiting
      * for the user's answer rather than a new prompt. The runner routes a
      * `reply` command to {@link answerQuestion} instead of {@link prompt} when
-     * this returns `true`. Drivers without interactive-question support return
+     * this returns `true`. Harnesses without interactive-question support return
      * `false` (the default), so a `reply` falls back to `prompt`.
      */
     hasPendingQuestion(): boolean;
     /**
-     * Deliver the user's answer to the question the driver is currently paused
+     * Deliver the user's answer to the question the harness is currently paused
      * on. This resumes the in-flight turn — it does NOT start a new one. When a
-     * single tool call asks several questions, the driver resolves the underlying
+     * single tool call asks several questions, the harness resolves the underlying
      * call only once every sub-question has an answer.
      *
      * @param answer - The user's reply text (an option label, free text, or for
@@ -983,26 +983,26 @@ export declare abstract class AgentDriver extends EventEmitter {
      */
     answerQuestion(answer: string, question?: string, requestId?: string): boolean;
     /**
-     * Apply this driver's rule for a new prompt that meets a pending question,
+     * Apply this harness's rule for a new prompt that meets a pending question,
      * ahead of the prompt itself. The runner queues a prompt behind the turn in
      * flight, so a turn paused on a question would otherwise hold that prompt
-     * until the user answered. Drivers whose `prompt()` cancels the question
+     * until the user answered. Harnesses whose `prompt()` cancels the question
      * (claude-sdk, omp) do the same here; the default keeps the question.
      */
     supersedePendingQuestion(): void;
     /**
-     * Live-update driver configuration. `ok: true` means effective from the next
+     * Live-update harness configuration. `ok: true` means effective from the next
      * turn: the next turn runs on the new settings, by live switch, query recycle
      * or respawn, and the host needs no restart. A turn in progress finishes on
      * the old settings. Only model/thinking/effort are reconfigurable mid-session.
      *
-     * Drivers that can honour that promise build a `ReconfigureLedger` and
+     * Harnesses that can honour that promise build a `ReconfigureLedger` and
      * delegate to it; it owns the model scope rule, ordering, drift and rollback.
      * The base implementation answers `not_supported`.
      */
     reconfigure(patch: ReconfigurePatch): Promise<ReconfigureOutcome>;
     /**
-     * Returns the model identifier currently configured on this driver.
+     * Returns the model identifier currently configured on this harness.
      * Subclasses that store config locally should override this.
      */
     getModel(): string | undefined;
@@ -1010,16 +1010,16 @@ export declare abstract class AgentDriver extends EventEmitter {
      * `Date.now()` of the harness's most recent sign of life, counting messages
      * that emit no `agent-event` (thinking deltas, rate-limit telemetry, API
      * retries). A stall check reads it alongside the events it sees. `null` when
-     * the driver does not track it.
+     * the harness does not track it.
      */
     lastActivityAt(): number | null;
     /**
      * Returns the token usage from the most recent completed turn.
-     * Returns `null` if usage data is unavailable (e.g. driver doesn't track it).
+     * Returns `null` if usage data is unavailable (e.g. harness doesn't track it).
      *
      * Widened in 3.1.0 to return the full `TokenUsage` shape (input / output /
      * cache-read / cache-creation / reasoning). All fields are optional so
-     * drivers can populate just what their provider reports. Existing callers
+     * harnesses can populate just what their provider reports. Existing callers
      * that read only `inputTokens` / `outputTokens` keep working — those fields
      * are still present and carry the same semantics as before.
      */
@@ -1034,11 +1034,11 @@ export declare abstract class AgentDriver extends EventEmitter {
      * (compaction thresholds) must prefer this; callers billing a turn
      * (usage ledgers, the `finished` event) must keep using `getTokenUsage()`.
      *
-     * Returns `null` both when the driver cannot report a per-call figure at all
+     * Returns `null` both when the harness cannot report a per-call figure at all
      * and when it can but has no reading yet. Falling back to `getTokenUsage()`
-     * is safe in either case only because a driver clears the two in lockstep: no
+     * is safe in either case only because a harness clears the two in lockstep: no
      * reading means no API call landed, so there is no cumulative usage to
-     * overstate. A driver implementing this must preserve that invariant.
+     * overstate. A harness implementing this must preserve that invariant.
      */
     getContextTokens(): number | null;
     /**
@@ -1047,8 +1047,8 @@ export declare abstract class AgentDriver extends EventEmitter {
      */
     getContextWindow(): number | null;
     /**
-     * What the driver can measure natively about its context window, in the
-     * neutral {@link DriverContextReport} shape, or `null` when it measures
+     * What the harness can measure natively about its context window, in the
+     * neutral {@link HarnessContextReport} shape, or `null` when it measures
      * nothing beyond {@link getContextTokens} / {@link getContextWindow}.
      *
      * `detail: "full"` (the default) may be expensive — claude-sdk issues
@@ -1060,17 +1060,17 @@ export declare abstract class AgentDriver extends EventEmitter {
      */
     getContextUsageReport(_opts?: {
         detail?: ContextUsageDetail;
-    }): Promise<DriverContextReport | null>;
+    }): Promise<HarnessContextReport | null>;
     /**
-     * Returns the list of models available to this driver without starting a session.
-     * Drivers that can enumerate their own models override this method.
+     * Returns the list of models available to this harness without starting a session.
+     * Harnesses that can enumerate their own models override this method.
      * Returns an empty array by default.
      */
     listModels(): Promise<ModelEntry[]>;
     /**
      * Closes the current conversation session and prepares for a fresh start.
      * The next `prompt()` call will begin a new session without prior history.
-     * The driver remains usable after `resetSession()`.
+     * The harness remains usable after `resetSession()`.
      */
     abstract resetSession(): Promise<void>;
     protected _telemetry?: TelemetryProvider;
@@ -1078,8 +1078,8 @@ export declare abstract class AgentDriver extends EventEmitter {
     protected _activeTurnSpan?: Span;
     private _turnStartTime?;
     /**
-     * Attach a telemetry provider and active trace to this driver.
-     * Called by the runner after creating the driver but before start().
+     * Attach a telemetry provider and active trace to this harness.
+     * Called by the runner after creating the harness but before start().
      */
     setTelemetry(provider: TelemetryProvider, trace: Trace): void;
     /**
@@ -1091,7 +1091,7 @@ export declare abstract class AgentDriver extends EventEmitter {
     /**
      * End the current turn span with generation data.
      * Called by the runner after agent_end. Model and provider are passed
-     * explicitly — the driver base class does not access config directly.
+     * explicitly — the harness base class does not access config directly.
      */
     endTurnSpan(result?: {
         model?: string;
@@ -1103,11 +1103,11 @@ export declare abstract class AgentDriver extends EventEmitter {
     }): void;
 }
 /**
- * Factory function signature registered in the driver registry.
+ * Factory function signature registered in the harness registry.
  *
- * @param config - Configuration for the new driver instance.
- * @returns A freshly constructed (not yet started) {@link AgentDriver}.
- * @docLink packages/bridge/concepts#driver-factory
+ * @param config - Configuration for the new harness instance.
+ * @returns A freshly constructed (not yet started) {@link AgentHarness}.
+ * @docLink packages/bridge/concepts#harness-factory
  */
-export type DriverFactory = (config: AgentConfig) => AgentDriver;
+export type HarnessFactory = (config: AgentConfig) => AgentHarness;
 //# sourceMappingURL=types.d.ts.map