@skaile/workspaces 5.18.1 → 6.0.0

package/dist/runner/src/session-builder.d.ts

@@ -6,19 +6,19 @@
  * serve.ts (WebSocket server) into a single reusable module.
  *
  * The shared setup pipeline:
- *   1. resolveSettings → driverType, provider, model, apiKey
+ *   1. resolveSettings → harnessType, provider, model, apiKey
  *   2. loadAgentManifest → manifest (model, maxTurns, tools, name)
  *   3. buildAgentResources → resourceManager, resourcePromptSection, mcpServers, dispose
  *   4. Load workspace config, build contextSection + home + environmentSection, load prompt-extensions
  *   5. assembleSystemPrompt (context + env + resources + extensions + additional sections)
  *   6. Resolve maxTurns (config override wins over manifest)
- *   7. createDriver (NOT started — caller calls driver.start() when ready)
+ *   7. createHarness (NOT started — caller calls harness.start() when ready)
  *
  * Agent identity (SOUL.md, RULES.md, knowledge/) is never assembled here.
  * It is rendered at install time by the renderers in asset-manager and read
  * natively by each harness at runtime.
  */
-import type { AgentDriver, AgentEffort, BridgeCapabilityHooks, CodexManagedRuntimeOptions, CodexDriverOptions } from "@skaile/workspaces/bridge";
+import type { AgentHarness, AgentEffort, BridgeCapabilityHooks, CodexManagedRuntimeOptions, CodexHarnessOptions } from "@skaile/workspaces/bridge";
 import type { RuntimeAssetsResult, SkWorkspaceConfig } from "@skaile/workspaces/core";
 import { type AgentManifest } from "@skaile/workspaces/types/manifests";
 import { type AIProviderRegistry, type MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
@@ -43,9 +43,9 @@ export interface AgentSessionConfig {
         runtime: Omit<CodexManagedRuntimeOptions, "prepareTools">;
         approvals: import("./codex-tools.js").CodexNativeApprovalHandlers;
         requiredTools: readonly string[];
-        approvalPolicy: NonNullable<CodexDriverOptions["approvalPolicy"]>;
-        sandboxMode: Exclude<NonNullable<CodexDriverOptions["sandboxMode"]>, "danger-full-access">;
-        reasoningEffort: NonNullable<CodexDriverOptions["reasoningEffort"]>;
+        approvalPolicy: NonNullable<CodexHarnessOptions["approvalPolicy"]>;
+        sandboxMode: Exclude<NonNullable<CodexHarnessOptions["sandboxMode"]>, "danger-full-access">;
+        reasoningEffort: NonNullable<CodexHarnessOptions["reasoningEffort"]>;
         /** Managed subprompt tier mapping and authoritative models available to this account. */
         subpromptModels?: {
             small: string;
@@ -68,7 +68,7 @@ export interface AgentSessionConfig {
      * (lifecycle, model, memory scope, triggers, connector slots).
      */
     instanceId?: string;
-    driver?: string;
+    harness?: string;
     model?: string;
     /**
      * AI provider registry supplied by a higher layer — the platform's
@@ -100,7 +100,7 @@ export interface AgentSessionConfig {
     /**
      * The runner's loopback model endpoint, when `model_endpoint.enabled`. Adds the
      * `skaile-endpoint` registry entry (lowest layer) and the endpoint env vars to the
-     * driver env. The token is a secret: never logged, never written to a file
+     * harness env. The token is a secret: never logged, never written to a file
      * besides `.skaile/model-endpoint.json`.
      */
     modelEndpoint?: ModelEndpointAddress;
@@ -127,7 +127,7 @@ export interface AgentSessionConfig {
     /**
      * `auto` (act on its own) or `interactive` (approve per tool call). Default: the
      * `permissions.permission_mode` of the `skaile.yaml` `agents:` instance this session runs
-     * (`auto` without one). Which drivers honour it: see `AgentConfig.permissionMode` in the bridge.
+     * (`auto` without one). Which harnesses honour it: see `AgentConfig.permissionMode` in the bridge.
      */
     permissionMode?: "auto" | "interactive";
     /**
@@ -195,22 +195,22 @@ export interface AgentSessionConfig {
     /**
      * Platform `AIProviderConfig.id` for the AI credential provisioned into
      * this session. Threaded into `AgentConfig.aiProviderConfigId` so that
-     * driver recreates (tier-1 native SDK resume, subagents, etc.) preserve
-     * the link to the platform mediator. The driver itself does not consume
+     * harness recreates (tier-1 native SDK resume, subagents, etc.) preserve
+     * the link to the platform mediator. The harness itself does not consume
      * this field; only the runner's 401-mediation handler reads it.
      */
     aiProviderConfigId?: string;
     /**
-     * Optional auth-refresh callback threaded into the bridge driver. Invoked
-     * by the driver when the underlying agent surfaces an
+     * Optional auth-refresh callback threaded into the bridge harness. Invoked
+     * by the harness when the underlying agent surfaces an
      * `authentication_error`; in v3 the runner mediates a fresh credential
      * via the `host.refresh_credential` capability and returns a typed
-     * {@link CredentialMint}. The driver branches on the discriminator:
+     * {@link CredentialMint}. The harness branches on the discriminator:
      * `ok: true` triggers a one-shot retry of the in-flight prompt;
      * `ok: false` surfaces the original auth error to the caller.
      *
-     * Centralising auth-retry inside the driver removes the need to wrap
-     * every `driver.prompt(...)` call site (compaction, flow turns, serve
+     * Centralising auth-retry inside the harness removes the need to wrap
+     * every `harness.prompt(...)` call site (compaction, flow turns, serve
      * handler) with a runner-side retry helper. Standalone CLI / forge
      * sessions leave it undefined.
      *
@@ -221,10 +221,10 @@ export interface AgentSessionConfig {
         configId: string;
     }) => Promise<import("@skaile/workspaces/types").CredentialMint>;
     /**
-     * Optional callback for the driver's seat-failover path: a turn blocked by an
+     * Optional callback for the harness's seat-failover path: a turn blocked by an
      * upstream usage limit (not a bad credential). The runner asks the platform
      * to re-resolve the AI provider config and reports whether the session moved
-     * to a different one, which the driver acts on by respawning its CLI and
+     * to a different one, which the harness acts on by respawning its CLI and
      * replaying the prompt once. Standalone CLI / forge sessions leave it
      * undefined and the limit error surfaces unchanged.
      *
@@ -255,12 +255,12 @@ export interface AgentSessionConfig {
     onLog?: (line: string) => void;
     /** Telemetry provider for observability. Optional — omit to disable tracing. */
     telemetry?: TelemetryProvider;
-    /** Active trace to attach to this session's driver. */
+    /** Active trace to attach to this session's harness. */
     trace?: Trace;
     /**
      * Protocol v2 capability dispatch hooks built from the runner's
-     * CapabilityRegistry. When present, the driver routes registered tool
-     * calls through `hooks.invoke()` instead of the legacy in-driver dispatch.
+     * CapabilityRegistry. When present, the harness routes registered tool
+     * calls through `hooks.invoke()` instead of the legacy in-harness dispatch.
      *
      * @since 2.0.0
      */
@@ -270,7 +270,7 @@ export interface AgentSessionConfig {
      * (declarative / recipe-backed) MCP servers are spawned and connected BY THE
      * RUNNER during `buildAgentResources`, with each tool registered into this
      * registry as an `mcp`-origin capability — the bridge-agnostic surface every
-     * driver consumes. Omit (CLI / flow) to fall back to the legacy
+     * harness consumes. Omit (CLI / flow) to fall back to the legacy
      * claude-sdk-only SDK delegation for external stdio servers.
      *
      * @since 3.5.0
@@ -298,11 +298,11 @@ export interface AgentSessionConfig {
         maxChars: number;
     }>) => Promise<Record<string, string> | undefined>;
     /**
-     * Extra in-process SDK MCP servers for a claude-sdk driver, merged over the
+     * Extra in-process SDK MCP servers for a claude-sdk harness, merged over the
      * session's own. A factory, not instances: an SDK server object belongs to the
-     * query it was handed to, so every driver (re)creation needs fresh ones. Serve
-     * mode uses it to give every driver a permanent `skaile-flow` server. Ignored
-     * for other drivers.
+     * query it was handed to, so every harness (re)creation needs fresh ones. Serve
+     * mode uses it to give every harness a permanent `skaile-flow` server. Ignored
+     * for other harnesses.
      *
      * @since 3.25.0
      */
@@ -311,21 +311,21 @@ export interface AgentSessionConfig {
 /**
  * A configured agent session returned by {@link createAgentSession}.
  *
- * Carries a driver instance (not yet started), connected resource and
+ * Carries a harness instance (not yet started), connected resource and
  * mount managers, resolved runtime assets, and the parsed agent manifest.
  *
  * @docLink packages/runner/dev-guide#flow-execution-turn-based-model
  */
 export interface AgentSession {
-    /** Driver configured but NOT started. Caller must call driver.start(). */
-    driver: AgentDriver;
+    /** Harness configured but NOT started. Caller must call harness.start(). */
+    harness: AgentHarness;
     /** Connected ConnectorManager — null if no connectors declared. any intentional (optional dep). */
     resourceManager: any | null;
     /**
      * Resolved runtime assets — catalog entries, implicit refs, npm deps,
      * warnings, plus refresh() / findEntry() helpers. Live-update paths
      * (add_resource, configure) hold this reference and call refresh() when
-     * a new repository is cloned or driver installed mid-session.
+     * a new repository is cloned or harness installed mid-session.
      */
     runtimeAssets: RuntimeAssetsResult | null;
     /**
@@ -337,14 +337,14 @@ export interface AgentSession {
     composition: ResolvedAgentInstance | null;
     /** Parsed agent.yaml manifest — model, maxTurns, tools, name. */
     manifest: AgentManifest | undefined;
-    /** Active driver type string ('omp' | 'claude-sdk'). */
-    driverType: string;
+    /** Active harness type string ('omp' | 'claude-sdk'). */
+    harnessType: string;
     model: string | undefined;
     /**
      * The AI provider registry this session resolved — merged `providers.yml`
      * layers plus any control-plane layer.
      *
-     * Read by anything that builds a second driver for the same session (the
+     * Read by anything that builds a second harness for the same session (the
      * sub-prompt runner) so it addresses the identical endpoints.
      */
     registry: MergedAIProviderRegistry;
@@ -372,7 +372,7 @@ export interface AgentSession {
      * build never loaded. Non-empty means only a rebuild can offer them.
      */
     unloadedMcpDeclarationIds: () => Promise<string[]>;
-    /** The resume hint this session's driver was built with, if any. */
+    /** The resume hint this session's harness was built with, if any. */
     resumeSessionId: string | undefined;
     /** Telemetry provider for this session (noop if not configured). */
     telemetry?: TelemetryProvider;
@@ -391,10 +391,10 @@ export interface AgentSession {
 /**
  * Create an agent session by resolving settings, loading the agent
  * manifest, building resources (connectors, mounts, MCP servers),
- * and creating the driver.
+ * and creating the harness.
  *
- * The returned driver is NOT started — the caller must call
- * `driver.start()` after optionally attaching event handlers.
+ * The returned harness is NOT started — the caller must call
+ * `harness.start()` after optionally attaching event handlers.
  *
  * @param config - Session configuration
  * @returns A fully configured AgentSession ready for start()
@@ -402,12 +402,12 @@ export interface AgentSession {
  */
 export declare function createAgentSession(config: AgentSessionConfig): Promise<AgentSession>;
 /** Build a disposable managed Codex child with the parent's resolved authority and fresh state. */
-export declare function createManagedCodexSubpromptDriver(config: AgentSessionConfig, model: string | undefined, cwd: string, privateDirectory: string): Promise<AgentDriver>;
+export declare function createManagedCodexSubpromptHarness(config: AgentSessionConfig, model: string | undefined, cwd: string, privateDirectory: string): Promise<AgentHarness>;
 /**
- * The manifest's `model.preferred` as the session's driver can take it. The Claude aliases
+ * The manifest's `model.preferred` as the session's harness can take it. The Claude aliases
  * (`sonnet`, `opus`, `haiku`, `inherit`) name a model of the Claude harness only; any other
- * driver would send the alias to its own provider as a model id, so it starts on its default
+ * harness would send the alias to its own provider as a model id, so it starts on its default
  * instead (the same rule the agent renderers apply).
  */
-export declare function manifestModelForDriver(manifest: AgentManifest | undefined, driverType: string): string | undefined;
+export declare function manifestModelForHarness(manifest: AgentManifest | undefined, harnessType: string): string | undefined;
 //# sourceMappingURL=session-builder.d.ts.map

package/dist/runner/src/session-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-builder.d.ts","sourceRoot":"","sources":["../../../runner/src/session-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAatF,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACjG,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAE9B,MAAM,2CAA2C,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,mCAAmC,CAAC;AAU3C,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAEL,KAAK,oBAAoB,EAI1B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAMvC;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC;QAC1D,SAAS,EAAE,OAAO,kBAAkB,EAAE,2BAA2B,CAAC;QAClE,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,cAAc,EAAE,WAAW,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAClE,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC3F,eAAe,EAAE,WAAW,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACpE,yFAAyF;QACzF,eAAe,CAAC,EAAE;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;SAC9B,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACxC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,+BAA+B,EAAE,aAAa,CAAC;IACtE;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,+BAA+B,EAAE,WAAW,CAAC;IAClE;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,+BAA+B,EAAE,uBAAuB,CAAC;IACnF;;;;;;;;OAQG;IACH,6BAA6B,CAAC,EAAE,OAAO,+BAA+B,EAAE,oBAAoB,EAAE,CAAC;IAC/F;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,MAAM,OAAO,yBAAyB,EAAE,oBAAoB,EAAE,CAAC;IACzF;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,OAAO,0BAA0B,EAAE,cAAc,CAAC,CAAC;IACjE;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,CACf,GAAG,EAAE,OAAO,2BAA2B,EAAE,mBAAmB,KACzD,OAAO,CAAC,OAAO,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;IACtE;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CACnB,WAAW,EAAE,OAAO,2BAA2B,EAAE,2BAA2B,KACzE,IAAI,CAAC;IACV;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAChB,WAAW,EAAE,OAAO,2BAA2B,EAAE,wBAAwB,KACtE,IAAI,CAAC;IACV;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gFAAgF;IAChF,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,uDAAuD;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IACjD;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;CAC/E;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,MAAM,EAAE,WAAW,CAAC;IACpB,mGAAmG;IAEnG,eAAe,EAAE,GAAG,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,EAAE,wBAAwB,CAAC;IACnC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,wEAAwE;IACxE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,kFAAkF;IAClF,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;OAIG;IACH,6BAA6B,EAAE,MAAM,OAAO,mBAAmB,EAAE,kBAAkB,CAAC;IACpF,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,OAAO,mBAAmB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnF;;;OAGG;IACH,yBAAyB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,oEAAoE;IACpE,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,oEAAoE;IACpE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;;;;;;OASG;IACH,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+S1F;AAED,mGAAmG;AACnG,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,WAAW,CAAC,CAsCtB;AAkPD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAIpB"}
+{"version":3,"file":"session-builder.d.ts","sourceRoot":"","sources":["../../../runner/src/session-builder.ts"],"names":[],"mappings":"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"}

package/dist/runner/src/session-capability-wiring.d.ts

@@ -36,27 +36,27 @@ export interface SessionCapabilityWiringDeps {
     getPreMintedSecrets: () => PreMintedSecretProvider | undefined;
     /** Re-emit `resources_available` so the frontend reflects the live change. */
     emitResourcesAvailable: () => void;
-    /** True when the active driver picks up newly-registered tools without a restart. */
-    driverPicksUpToolsLive: () => boolean;
+    /** True when the active harness picks up newly-registered tools without a restart. */
+    harnessPicksUpToolsLive: () => boolean;
     /** Returns `null` during the brief session-recreate gap; guard before use. */
     getOrCreateMcpManager: () => ExternalMcpManager | null;
-    /** The current compaction orchestrator, or null before the driver is built. */
+    /** The current compaction orchestrator, or null before the harness is built. */
     getCompactionOrchestrator: () => CompactionOrchestrator | null;
     /** Absolute path to the session project directory. */
     getProjectDir: () => string;
     /** Stage-then-fast-restart a skill by name (owned by `serve.ts`). */
     attachSkillInstance: (name: string) => Promise<AttachResult>;
-    /** Unstage a skill and restart the driver behind the swap gate (owned by `serve.ts`). */
+    /** Unstage a skill and restart the harness behind the swap gate (owned by `serve.ts`). */
     detachSkillInstance: (name: string) => Promise<DetachResult>;
     /** Record a live-attached MCP server so later session rebuilds respawn it (owned by `serve.ts`). */
     registerLiveAttachedMcp: (declaration: McpServerDeclaration) => void;
     /** Forget a live-attached MCP server so later rebuilds do not respawn it (owned by `serve.ts`). */
     unregisterLiveAttachedMcp: (id: string) => void;
-    /** Queue a (backgrounded) driver restart so a non-live driver re-bakes its tool set. */
-    scheduleDriverRestartForToolChanges: (reason: string) => void;
-    /** The live driver `runner.reconfigure` patches; null during a recreate. */
-    getDriver: ReconfigureHandlerDeps["getDriver"];
-    /** Record a live reconfigure in the config a driver recreate starts from (owned by `serve.ts`). */
+    /** Queue a (backgrounded) harness restart so a non-live harness re-bakes its tool set. */
+    scheduleHarnessRestartForToolChanges: (reason: string) => void;
+    /** The live harness `runner.reconfigure` patches; null during a recreate. */
+    getHarness: ReconfigureHandlerDeps["getHarness"];
+    /** Record a live reconfigure in the config a harness recreate starts from (owned by `serve.ts`). */
     rememberReconfigure: ReconfigureHandlerDeps["rememberPatch"];
     log: (msg: string) => void;
 }

package/dist/runner/src/session-capability-wiring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-capability-wiring.d.ts","sourceRoot":"","sources":["../../../runner/src/session-capability-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,gCAAgC,CAAC;AAEjG,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,OAAO,CAChC,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CACpE,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,8EAA8E;IAC9E,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAClD;;;OAGG;IACH,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,uBAAuB,GAAG,SAAS,CAAC;IAC/D,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,qFAAqF;IACrF,sBAAsB,EAAE,MAAM,OAAO,CAAC;IACtC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IACvD,+EAA+E;IAC/E,yBAAyB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IAC/D,sDAAsD;IACtD,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,qEAAqE;IACrE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,yFAAyF;IACzF,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,oGAAoG;IACpG,uBAAuB,EAAE,CAAC,WAAW,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACrE,mGAAmG;IACnG,yBAAyB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,wFAAwF;IACxF,mCAAmC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC/C,mGAAmG;IACnG,mBAAmB,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAwI/E"}
+{"version":3,"file":"session-capability-wiring.d.ts","sourceRoot":"","sources":["../../../runner/src/session-capability-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,gCAAgC,CAAC;AAEjG,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,OAAO,CAChC,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CACpE,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,8EAA8E;IAC9E,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAClD;;;OAGG;IACH,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,uBAAuB,GAAG,SAAS,CAAC;IAC/D,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,sFAAsF;IACtF,uBAAuB,EAAE,MAAM,OAAO,CAAC;IACvC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IACvD,gFAAgF;IAChF,yBAAyB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IAC/D,sDAAsD;IACtD,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,qEAAqE;IACrE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,0FAA0F;IAC1F,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,oGAAoG;IACpG,uBAAuB,EAAE,CAAC,WAAW,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACrE,mGAAmG;IACnG,yBAAyB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,0FAA0F;IAC1F,oCAAoC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,6EAA6E;IAC7E,UAAU,EAAE,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACjD,oGAAoG;IACpG,mBAAmB,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAwI/E"}

package/dist/runner/src/session-stimulus.d.ts

@@ -62,7 +62,7 @@ export interface SessionStimulusBus {
 }
 /**
  * Drives one agent turn given a concatenated prompt fragment. The runner
- * supplies this when constructing the bus — typically wraps `driver.prompt`
+ * supplies this when constructing the bus — typically wraps `harness.prompt`
  * + waits for `agent_end`. The bus calls it with all coalesced fragments
  * joined by newline.
  */

package/dist/runner/src/session.d.ts

@@ -1,8 +1,8 @@
 /**
  * Runner session metadata.
  *
- * Holds only what the runner needs to resume the agent driver across
- * process restarts — notably `driverSessionId` for SDK session resume.
+ * Holds only what the runner needs to resume the agent harness across
+ * process restarts — notably `harnessSessionId` for SDK session resume.
  *
  * Flow execution state (per-node status, approvals, outputs) moved out
  * of the session file in Phase 2 of the flow-execution plan. It now
@@ -26,11 +26,11 @@ export interface SessionState {
      */
     agentDir?: string;
     /** Agent harness used for this session (e.g. `"omp"`, `"claude-sdk"`). */
-    driver: string;
+    harness: string;
     /** Model name (if set), e.g. `"claude-opus-4-5"`. */
     model?: string;
     /** Provider-native session/thread identifier for resume support. */
-    driverSessionId?: string;
+    harnessSessionId?: string;
     /** ISO 8601 timestamp when the session was created. */
     startedAt: string;
     /** ISO 8601 timestamp of the last state change. */
@@ -39,7 +39,7 @@ export interface SessionState {
     label?: string;
     /** Session lifecycle status. */
     status?: "running" | "complete" | "failed" | "paused";
-    /** Why the session ended `failed` (for example the driver could not start). */
+    /** Why the session ended `failed` (for example the harness could not start). */
     error?: string;
 }
 /**

package/dist/runner/src/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../runner/src/session.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuDD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CASlF;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmB9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,UAAU,UAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAepF;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,GACvE,YAAY,CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAE9D"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../runner/src/session.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CASlF;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmB9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,UAAU,UAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAepF;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,GACvE,YAAY,CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAE9D"}

package/dist/runner/src/skill-staging.d.ts

@@ -43,27 +43,27 @@ export type StagedSkills = Map<string, StagedSkillRecord>;
 export declare function recordStagedSkills(staged: StagedSkills, projectDir: string, skillsDir: string, names: readonly string[], timeoutMs?: number): Promise<void>;
 /**
  * Whether `path` is still exactly the dir this process staged: the same full
- * path (a driver switch changes the skills dir) and the same dev/ino (a user
+ * path (a harness switch changes the skills dir) and the same dev/ino (a user
  * may have replaced it with their own). Anything else is treated as unmarked.
  */
 export declare function isStillOurs(record: StagedSkillRecord | undefined, path: string, timeoutMs?: number): Promise<boolean>;
 export interface SkillStagingDeps {
     projectDir: string;
-    /** The active driver's skills dir, relative to the project dir. */
+    /** The active harness's skills dir, relative to the project dir. */
     skillsDir: () => string;
     /** What the runner has staged in this process; shared with the restage. */
     stagedSkillDirs: StagedSkills;
-    /** What the driver has loaded, or loads on its next start; shared with the restage. */
+    /** What the harness has loaded, or loads on its next start; shared with the restage. */
     loadedSkillDigests: LoadedSkillDigests;
     /** The lock shared with every other staging copy. */
     withSkillFsLock: <T>(fn: () => Promise<T>) => Promise<T>;
-    /** Queue a driver restart (never awaited: the capability call is capped at 30s). */
+    /** Queue a harness restart (never awaited: the capability call is capped at 30s). */
     scheduleSkillRestart: (actions: SkillAction[]) => void;
-    driverStarted: () => boolean;
+    harnessStarted: () => boolean;
     log: (msg: string) => void;
 }
 /**
- * Dir name -> the staged path and content digest of the copy the driver has
+ * Dir name -> the staged path and content digest of the copy the harness has
  * loaded or loads on its next (re)start. A `null` digest is unknown and never
  * matches. Separate from {@link StagedSkills} because that record is `null`
  * wherever the filesystem reports no birth time.
@@ -73,14 +73,14 @@ export type LoadedSkillDigests = Map<string, {
     digest: string | null;
 }>;
 /**
- * Record the digest of each just-staged copy the driver will load: every one
- * while the driver is down (it reads them at start), else only names new to
+ * Record the digest of each just-staged copy the harness will load: every one
+ * while the harness is down (it reads them at start), else only names new to
  * `previouslyStaged` (the restage restarts for exactly those). A copy re-staged
- * over a running driver keeps its old entry, so a later attach still sees the
- * driver's copy as stale. Call under the skill-fs lock, right after the copy.
+ * over a running harness keeps its old entry, so a later attach still sees the
+ * harness's copy as stale. Call under the skill-fs lock, right after the copy.
  */
 export declare function recordLoadedSkillDigests(loaded: LoadedSkillDigests, projectDir: string, skillsDir: string, names: readonly string[], opts: {
-    driverUp: boolean;
+    harnessUp: boolean;
     previouslyStaged: ReadonlySet<string>;
 }): Promise<void>;
 /**
@@ -92,9 +92,9 @@ export declare function recordLoadedSkillDigests(loaded: LoadedSkillDigests, pro
  */
 export declare function stagedSkillDigest(dir: string, timeoutMs?: number): Promise<string | null>;
 /**
- * Stage one materialized skill and schedule a restart so the driver rediscovers
+ * Stage one materialized skill and schedule a restart so the harness rediscovers
  * it. Like the per-prompt restage, it restarts only for a skill new to this
- * process or whose staged copy differs from the one the driver loaded: the
+ * process or whose staged copy differs from the one the harness loaded: the
  * broker wake push re-sends every delivered skill, and restarting for an
  * unchanged one rebuilds MCP and reconnects every connector for nothing.
  * Never throws.
@@ -102,11 +102,11 @@ export declare function stagedSkillDigest(dir: string, timeoutMs?: number): Prom
 export declare function attachStagedSkill(deps: SkillStagingDeps, name: string): Promise<AttachSkillResult>;
 /**
  * Unload a skill the platform unassigned: remove its staged copy and its
- * materialized asset, then schedule a driver restart, which waits for an
+ * materialized asset, then schedule a harness restart, which waits for an
  * in-flight turn. A same-named dir the runner did not stage is left in place
  * (`reason: "not_staged"`). The restart also fires when this process had
  * tracked the dir as staged but it is already gone (an earlier removal that
- * timed out yet completed): the running driver still holds that skill.
+ * timed out yet completed): the running harness still holds that skill.
  * Never throws.
  */
 export declare function detachStagedSkill(deps: SkillStagingDeps, name: string): Promise<DetachSkillResult>;
@@ -123,7 +123,7 @@ export declare function detachStagedSkill(deps: SkillStagingDeps, name: string):
  *   older runner's empty marker, does not count), or exactly the dir this
  *   process staged (see {@link isStillOurs}).
  *
- * The caller holds the skill-fs lock and schedules the driver restart for the
+ * The caller holds the skill-fs lock and schedules the harness restart for the
  * returned names. Never throws.
  */
 export declare function removeUnlistedStagedSkills(deps: Pick<SkillStagingDeps, "projectDir" | "stagedSkillDirs" | "log">, skillsDir: string): Promise<string[]>;

package/dist/runner/src/skill-staging.d.ts.map

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

package/dist/runner/src/turn-end-contract.d.ts

@@ -0,0 +1,55 @@
+import type { AgentEvent } from "@skaile/workspaces/types";
+/** What the {@link TurnScheduler} calls around a turn the host sent. */
+export interface TurnEndHooks {
+    /** A prompt or reply turn starts. */
+    begin(): void;
+    /** The turn is over: the `finished` it owes goes out now. Safe to call twice. */
+    end(): void;
+    /**
+     * The turn's prompt has settled. A fatal `error` after this is a new failure, not a repeat
+     * of the turn's own, and goes out.
+     */
+    settle(): void;
+    /**
+     * A turn the contract does not manage (a flow turn, a compaction) takes the harness: its
+     * `finished` is its own, not a repeat of the closed turn's.
+     */
+    foreignTurn(): void;
+}
+/**
+ * Orders and completes the events of one host-sent turn at a time.
+ *
+ * While a turn is open: `finished` is held until the turn ends, so a failure
+ * reported after it still comes first; a second fatal `error` is dropped; a
+ * turn that produced no `finished` gets one when it ends. A turn that asked a
+ * question gets none: the host closes the open question on `finished`.
+ * After `end()` the turn stays closed until the next `begin()` or `foreignTurn()`:
+ * a `finished` the harness sends on a later tick repeats the one the turn already got
+ * and is dropped. A second fatal `error` is dropped only until the turn's prompt has
+ * settled (`settle()`): that is the scheduler's `Prompt failed` after the harness's own
+ * report. After it, a fatal `error` (a harness crash while idle) goes out.
+ * Events outside a turn (flow turns, turns the agent starts itself, compactions)
+ * pass untouched.
+ */
+export declare class TurnEndContract implements TurnEndHooks {
+    private readonly release;
+    private open;
+    /** The turn ended and no other turn started since: a late `finished` is a repeat. */
+    private closed;
+    /** Between `end()` and `settle()`: a second fatal `error` repeats this turn's failure. */
+    private settling;
+    /** `end()` is sending the turn's own `finished`; that one must pass. */
+    private releasing;
+    private held;
+    private fatalSent;
+    private questionAsked;
+    /** @param release Sends one event the way every harness event is sent. */
+    constructor(release: (event: AgentEvent) => void);
+    begin(): void;
+    /** `false`: do not send this event now (it is held, or it repeats a fatal `error`). */
+    admit(event: AgentEvent): boolean;
+    end(): void;
+    settle(): void;
+    foreignTurn(): void;
+}
+//# sourceMappingURL=turn-end-contract.d.ts.map

package/dist/runner/src/turn-end-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-end-contract.d.ts","sourceRoot":"","sources":["../../../runner/src/turn-end-contract.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;IACd,iFAAiF;IACjF,GAAG,IAAI,IAAI,CAAC;IACZ;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IACf;;;OAGG;IACH,WAAW,IAAI,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAatC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,OAAO,CAAC,IAAI,CAAS;IACrB,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAS;IACvB,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAS;IACzB,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAA0D;IACtE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAE9B,0EAA0E;gBAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;IAEjE,KAAK,IAAI,IAAI;IAWb,uFAAuF;IACvF,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAiCjC,GAAG,IAAI,IAAI;IA2BX,MAAM,IAAI,IAAI;IAId,WAAW,IAAI,IAAI;CAIpB"}