@skaile/workspaces 5.18.1 → 6.0.0

package/dist/asset-manager/src/mcp-config.d.ts

@@ -5,13 +5,13 @@
  * skaile's own agent loop wires up.
  *
  * This is the sibling of skill deployment (`.claude/skills/`): skills already
- * render into the driver target's native tree, MCP servers now do too.
+ * render into the harness target's native tree, MCP servers now do too.
  *
  * Declarations come from the single resolver `loadMcpServerDeclarations()` in
  * `@skaile/workspaces/core` — the same one the runner uses. There is no second
  * resolver here.
  */
-import type { DriverTarget, McpServerDeclaration } from "@skaile/workspaces/core";
+import type { HarnessName, McpServerDeclaration } from "@skaile/workspaces/core";
 /** A skipped declaration and the human-readable reason it was not rendered. */
 export interface SkippedMcpServer {
     id: string;
@@ -40,7 +40,13 @@ export interface RenderMcpConfigOptions {
      */
     fetchPayload?: (url: string) => Promise<Uint8Array>;
 }
-declare function readNotedSkips(projectDir: string, target: DriverTarget): Promise<Record<string, string>>;
+/**
+ * The key of a `sensitive` (or `password`) field whose value is written into the declaration as
+ * a literal. The rendered `.mcp.json` is committed, so a secret may only be an `env:NAME`
+ * reference, which becomes `${NAME}` for the coding agent to expand.
+ */
+export declare function literalSecretField(decl: McpServerDeclaration): string | undefined;
+declare function readNotedSkips(projectDir: string, target: HarnessName): Promise<Record<string, string>>;
 /** What differs between an MCP server's declaration and what a render wrote for it. */
 export interface McpServerDrift {
     /** The declaration id (the unscoped asset name). */
@@ -51,6 +57,12 @@ export interface McpServerDrift {
     modified: string[];
     /** Entries of skaile's payload directory the declaration does not ship. */
     extra: string[];
+    /**
+     * Config entries skaile wrote that nothing edited since, but that differ from what the
+     * declaration renders now: `skaile.yaml` (or a newer asset) changed after the last render.
+     * A pending render, not drift; `skaile install` writes them.
+     */
+    stale: string[];
     /** The config entry as the declaration renders it and as found, when they differ (for `diff`). */
     entry?: {
         expected: unknown;
@@ -65,14 +77,15 @@ export interface McpServerDrift {
 }
 /**
  * Compare what {@link renderMcpServerConfig} writes for each declared MCP server (the payload
- * file under `.skaile/assets/mcp-server/<name>/` and the entry in the driver target's MCP config)
+ * file under `.skaile/assets/mcp-server/<name>/` and the entry in the harness target's MCP config)
  * with what is on disk. Reads only; nothing is fetched or written.
  *
  * - A payload file that is gone, has other bytes than the pinned sha256, or a payload directory
  *   that holds files the server does not ship is drift.
- * - A config entry skaile owns (the `.mcp.json` ledger names it) that is gone or differs from the
- *   declaration is drift; so is a missing entry of a locked server. A hand-written entry is
- *   never compared: skaile does not own it.
+ * - A config entry skaile owns (the `.mcp.json` ledger names it) that is gone or was edited by
+ *   hand is drift; so is a missing entry of a locked server. An entry that still reads as the
+ *   last render wrote it but differs from the declaration now is `stale`: a pending render. A
+ *   hand-written entry is never compared: skaile does not own it.
  * - A server the last render skipped (see {@link readSkippedMcpServers}) has nothing written
  *   and is not compared.
  *
@@ -80,7 +93,7 @@ export interface McpServerDrift {
  * @param opts.locked - Ids of the MCP servers the lock holds (a missing entry of those counts).
  * @returns One row per drifted server; empty for a target with no MCP config file.
  */
-export declare function mcpServerDrift(projectDir: string, driverTarget: DriverTarget, opts?: {
+export declare function mcpServerDrift(projectDir: string, harnessTarget: HarnessName, opts?: {
     declarations?: McpServerDeclaration[];
     locked?: ReadonlySet<string>;
 }): Promise<McpServerDrift[]>;
@@ -90,7 +103,7 @@ export declare function mcpServerDrift(projectDir: string, driverTarget: DriverT
  */
 export declare function mcpDriftDiff(drift: McpServerDrift): string;
 /**
- * The MCP servers the last render did not write to the driver target's config, with the reason
+ * The MCP servers the last render did not write to the harness target's config, with the reason
  * (`{ [id]: reason }`). Reads the `.skaile/mcp-skipped.json` ledger; empty for a target with no
  * MCP config file or when nothing was skipped.
  */
@@ -99,8 +112,21 @@ export declare const readSkippedMcpServers: typeof readNotedSkips;
 export declare function unsetRequiredFields(decl: McpServerDeclaration): string[];
 /** What a server with unset required fields needs: follows the server's name in a line. */
 export declare function requiredFieldsAdvice(id: string, keys: string[]): string;
+/** The project-relative MCP config file skaile writes for `harnessTarget`, or `undefined` when it writes none. */
+export declare function mcpConfigFileOf(harnessTarget: HarnessName): string | undefined;
+/**
+ * What the last render wrote for one MCP server: the config file, and the payload directory when
+ * the server has one. `undefined` when `harnessTarget` has no MCP config, or the config holds no
+ * entry skaile owns for `name` (the server was skipped, or never rendered).
+ *
+ * @param name - The server's declaration id (the asset name).
+ */
+export declare function mcpRenderedFootprint(projectDir: string, harnessTarget: HarnessName, name: string): Promise<{
+    file: string;
+    payloadDir?: string;
+} | undefined>;
 /**
- * Render every MCP server declared for `projectDir` into `driverTarget`'s
+ * Render every MCP server declared for `projectDir` into `harnessTarget`'s
  * native project-scope MCP config.
  *
  * Merge rules, in short:
@@ -110,14 +136,14 @@ export declare function requiredFieldsAdvice(id: string, keys: string[]): string
  * - Every other key of the config file survives verbatim.
  * - A project with no renderable servers and no prior state writes nothing.
  *
- * Unsupported driver targets (`codex`, `omp`) are a silent no-op.
+ * Unsupported harness targets (`codex`, `omp`) are a silent no-op.
  *
  * @param projectDir - Workspace root where `skaile.yaml` lives.
- * @param driverTarget - Coding agent whose native MCP config to write.
+ * @param harnessTarget - Coding agent whose native MCP config to write.
  * @param opts - Optional warning sink.
  * @returns What was written, removed and skipped.
  * @docLink packages/asset-manager/concepts#coding-agent-mcp-config
  */
-export declare function renderMcpServerConfig(projectDir: string, driverTarget: DriverTarget, opts?: RenderMcpConfigOptions): Promise<RenderMcpConfigResult>;
+export declare function renderMcpServerConfig(projectDir: string, harnessTarget: HarnessName, opts?: RenderMcpConfigOptions): Promise<RenderMcpConfigResult>;
 export {};
 //# sourceMappingURL=mcp-config.d.ts.map

package/dist/asset-manager/src/mcp-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAoB,MAAM,yBAAyB,CAAC;AA8DpG,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACrD;AA6WD,iBAAe,cAAc,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAGjC;AAkGD,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,2GAA2G;IAC3G,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kGAAkG;IAClG,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,gEAAgE;IAChE,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,EAC1B,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAO,GACjF,OAAO,CAAC,cAAc,EAAE,CAAC,CA8D3B;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAmB1D;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,uBAAiB,CAAC;AAEpD,2GAA2G;AAC3G,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAKxE;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvE;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA0FhC"}
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/asset-manager/src/renderers.d.ts

@@ -4,13 +4,13 @@
  * Each renderer transforms a parsed GitAgent package (agent.yaml + SOUL.md + RULES.md)
  * into the native file format that the target agent framework natively reads.
  *
- * Only harnesses with a full bridge driver (runtime execution) are included:
+ * Only harnesses with a full bridge harness (runtime execution) are included:
  *   claude-code → .claude/agents/<name>.md     (YAML frontmatter + markdown body)
  *   omp         → .omp/agents/<name>/          (directory with agent.yaml + SOUL.md)
  *   codex       → .codex/agents/<name>.toml    (TOML)
  *
- * Removed (no bridge driver): cursor, roo, github-copilot, gemini, amp.
- * Add them back when a bridge driver is implemented.
+ * Removed (no bridge harness): cursor, roo, github-copilot, gemini, amp.
+ * Add them back when a bridge harness is implemented.
  */
 import { type AgentLifecycle, type AgentManifest } from "@skaile/workspaces/types/manifests";
 import type { AbilityRef, ContractRef } from "./fragments.js";
@@ -99,7 +99,7 @@ export declare const CODEX_IDENTITY_DIR = "skaile-agents";
  * TOML multi-line strings are escaped to avoid syntax errors.
  *
  * Also writes the agent's identity as `.codex/skaile-agents/<name>.md`, which
- * the Codex driver combines with the session's runtime prompt (one file per
+ * the Codex harness combines with the session's runtime prompt (one file per
  * agent, so several instances never overwrite each other).
  *
  * @docLink packages/asset-manager/api-reference#renderers
@@ -124,27 +124,27 @@ export type Log = (msg: string) => void;
  * Shared by both the simple deploy path (`deployAsset`) and the enriched scaffold path (agents layer).
  *
  * @param input - Full render input including manifest, SOUL/RULES text, and resolved refs.
- * @param driverTarget - Agent framework ID to look up in {@link AGENT_RENDERERS}.
+ * @param harnessTarget - Agent framework ID to look up in {@link AGENT_RENDERERS}.
  * @param log - Optional logger callback for progress messages.
  * @returns Object with `created` file paths and `warnings` list.
  * @docLink packages/asset-manager/api-reference#renderers
  */
-export declare function renderAgentToFramework(input: AgentRenderInput, driverTarget: string, log?: Log): AgentRenderResult;
+export declare function renderAgentToFramework(input: AgentRenderInput, harnessTarget: string, log?: Log): AgentRenderResult;
 /**
  * Registry mapping framework IDs to their {@link AgentRenderer} functions.
  *
- * Only harnesses with a full bridge driver are registered. Add new entries
- * when a bridge driver is implemented in `workspaces/bridge/src/drivers/`.
+ * Only harnesses with a full bridge harness are registered. Add new entries
+ * when a bridge harness is implemented in `workspaces/bridge/src/harnesses/`.
  *
  * @docLink packages/asset-manager/api-reference#renderers
  */
 export declare const AGENT_RENDERERS: Record<string, AgentRenderer>;
 /**
- * Returns `true` if the given driver target supports file-based sub-agent installation.
+ * Returns `true` if the given harness target supports file-based sub-agent installation.
  *
- * @param driverTarget - Agent framework ID to check.
- * @returns `true` when `driverTarget` has a registered entry in {@link AGENT_RENDERERS}.
+ * @param harnessTarget - Agent framework ID to check.
+ * @returns `true` when `harnessTarget` has a registered entry in {@link AGENT_RENDERERS}.
  * @docLink packages/asset-manager/api-reference#renderers
  */
-export declare function driverTargetSupportsAgents(driverTarget: string): boolean;
+export declare function harnessTargetSupportsAgents(harnessTarget: string): boolean;
 //# sourceMappingURL=renderers.d.ts.map

package/dist/asset-manager/src/renderers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI9D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,aAAa,CAAC;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kGAAkG;IAClG,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,gGAAgG;IAChG,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,wGAAwG;IACxG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,EAAE,cAAc,CAAC;IAC1B,wFAAwF;IACxF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gIAAgI;IAChI,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,iBAAiB,CAAC;AA8K3E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,aA6EhC,CAAC;AA2BF,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAkD3B,CAAC;AAiBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,aA8FzB,CAAC;AAIF,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAGxC;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,GAAU,GACd,iBAAiB,CAanB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIzD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAExE"}
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI9D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,aAAa,CAAC;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kGAAkG;IAClG,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,gGAAgG;IAChG,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,wGAAwG;IACxG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,EAAE,cAAc,CAAC;IAC1B,wFAAwF;IACxF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gIAAgI;IAChI,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,iBAAiB,CAAC;AA8K3E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,aA6EhC,CAAC;AA2BF,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAkD3B,CAAC;AAiBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,aA8FzB,CAAC;AAIF,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAGxC;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,GAAU,GACd,iBAAiB,CAanB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIzD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/bridge/codex-app-server.js

@@ -1,6 +1,6 @@
-export { CodexAppServerClient, CodexAppServerError } from '../chunk-K4O6L3WH.js';
+export { CodexAppServerClient, CodexAppServerError } from '../chunk-KNY356I3.js';
 import '../chunk-LOO5CB5M.js';
-import '../chunk-YROR332M.js';
+import '../chunk-7DN6JKP2.js';
 import '../chunk-4GY63JU6.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=codex-app-server.js.map

package/dist/bridge/harnesses/claude-sdk.d.ts

@@ -0,0 +1,2 @@
+// Auto-generated by _scripts/emit-dts-sidecars.ts — do not edit by hand.
+export * from "../src/harnesses/claude-sdk.js";

package/dist/bridge/{drivers → harnesses}/claude-sdk.js

@@ -1,32 +1,32 @@
-import { formatDroppedToolsNotice, filterInProcessMcpServerTools, checkToolPropertyKeys, TOOL_PROPERTY_KEY_PATTERN } from '../../chunk-L2AMXONH.js';
-import { freshBudget, isFirstAttempt, spend, isSpent, decide, isAvailable } from '../../chunk-IZCR27MU.js';
-import { AskSlots } from '../../chunk-EPBKISS5.js';
-import { scrubPoisonedTranscript, transcriptStoreForRuntime, resolveClaudeConfigDir, claudeEndpointMode, buildClaudeEndpointEnv, APPROVE_ONCE, DENY } from '../../chunk-3KMREAR2.js';
-import { dispatchCapability } from '../../chunk-AJ7EGIFR.js';
-import { fetchProviderModels } from '../../chunk-BBWSGVVE.js';
-import { ReconfigureLedger, AuthError, stripRunnerPrivateEnv, classifyClaudeSdkError, reclassifyAuthAsAccountUnavailable, AccountUnavailableError, isLongContextEntitlementRejection, LONG_CONTEXT_CREDITS_API_ERROR } from '../../chunk-B4X2N7JQ.js';
-import { agentExecRequested, wrapAgentCommand, resolveAgentExec } from '../../chunk-YROR332M.js';
-import { AgentDriver, getBridgeLogger, registryDriverConfig } from '../../chunk-34C2EKWJ.js';
-import { BUILTIN_DRIVER_CATALOG, entryCredentialValue } from '../../chunk-KY4UXX7M.js';
-import '../../chunk-6E6PKKAD.js';
-import { withActivityLabelShape } from '../../chunk-Y56YIT6J.js';
-import '../../chunk-CKNIYIV2.js';
-import { loadDriverSdk } from '../../chunk-T2TQAH2X.js';
+import { formatDroppedToolsNotice, filterInProcessMcpServerTools, checkToolPropertyKeys, TOOL_PROPERTY_KEY_PATTERN } from '../../chunk-3X7VTCPG.js';
+import { freshBudget, isFirstAttempt, spend, isSpent, decide, isAvailable } from '../../chunk-7EKQDY2T.js';
+import { AskSlots } from '../../chunk-3TG2NV2F.js';
+import { scrubPoisonedTranscript, transcriptStoreForRuntime, resolveClaudeConfigDir, claudeEndpointMode, buildClaudeEndpointEnv, APPROVE_ONCE, DENY } from '../../chunk-4DWBSTYA.js';
+import { dispatchCapability } from '../../chunk-BIRW3HOG.js';
+import { fetchProviderModels } from '../../chunk-7CV3HFWJ.js';
+import { ReconfigureLedger, AuthError, stripRunnerPrivateEnv, classifyClaudeSdkError, reclassifyAuthAsAccountUnavailable, AccountUnavailableError, isLongContextEntitlementRejection, LONG_CONTEXT_CREDITS_API_ERROR } from '../../chunk-XFIEVEU7.js';
+import { agentExecRequested, wrapAgentCommand, resolveAgentExec } from '../../chunk-7DN6JKP2.js';
+import { AgentHarness, getBridgeLogger, registryHarnessConfig } from '../../chunk-UVVVR4XO.js';
+import { BUILTIN_HARNESS_CATALOG, entryCredentialValue } from '../../chunk-F2GOZMRA.js';
+import '../../chunk-G5SUWZEU.js';
+import { withActivityLabelShape } from '../../chunk-JCPD4QRM.js';
+import '../../chunk-E572OHGY.js';
+import { loadHarnessSdk } from '../../chunk-L4YKW5AY.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-KC6HGWXN.js';
-import '../../chunk-5TBFN46Z.js';
-import '../../chunk-5BEFNLOR.js';
-import '../../chunk-A2ULN3KX.js';
-import '../../chunk-2NOLF7B2.js';
+import '../../chunk-OTIB4D2K.js';
+import '../../chunk-5KRMNUL4.js';
+import '../../chunk-Z7ZEZZB6.js';
+import '../../chunk-MWXYN6NY.js';
+import '../../chunk-OHNKYHRR.js';
 import '../../chunk-L5VSIPQD.js';
-import '../../chunk-IG5LZ3WU.js';
-import '../../chunk-CKICWXMU.js';
+import '../../chunk-VTETQCR6.js';
+import '../../chunk-UQ33Y4DM.js';
 import '../../chunk-RVRB27AN.js';
 import '../../chunk-GOCWM7FN.js';
 import '../../chunk-WDXZA7QW.js';
-import '../../chunk-ICSCSM5D.js';
+import '../../chunk-ADPM6AYF.js';
 import '../../chunk-DKXNKFKP.js';
-import { mergeRegistries, parseModelRef, isEntryEnabled, resolveEntryBaseUrl } from '../../chunk-MJHSLODD.js';
+import { mergeRegistries, parseModelRef, isEntryEnabled, resolveEntryBaseUrl } from '../../chunk-LSI2IVFT.js';
 import '../../chunk-C3CAXQMA.js';
 import { createLogger } from '../../chunk-BOFL7GIF.js';
 import '../../chunk-NSBPE2FW.js';
@@ -36,7 +36,7 @@ import { readFileSync, existsSync } from 'fs';
 import { createRequire } from 'module';
 import * as zNS from 'zod';
 
-// bridge/src/drivers/claude-context-usage.ts
+// bridge/src/harnesses/claude-context-usage.ts
 var USED_ROW = {
   systemPrompt: "System prompt",
   systemTools: "System tools",
@@ -166,7 +166,7 @@ function sumBucket(items) {
   return { tokens: sumTokens(items), items };
 }
 
-// bridge/src/drivers/claude-self-turns.ts
+// bridge/src/harnesses/claude-self-turns.ts
 var MAX_TRACKED_TASKS = 64;
 var SelfTurnTracker = class {
   constructor(emit) {
@@ -186,14 +186,14 @@ var SelfTurnTracker = class {
   foreground = /* @__PURE__ */ new Set();
   /** Tasks announced with `background_task_started`, the only ids a host can tie to a turn. */
   reported = /* @__PURE__ */ new Set();
-  /** Whether the turn running now is one the driver did not prompt. */
+  /** Whether the turn running now is one the harness did not prompt. */
   get selfTurnActive() {
     return this.active;
   }
   /**
-   * Feed every SDK message before the driver handles it, so a self-started
+   * Feed every SDK message before the harness handles it, so a self-started
    * turn is announced ahead of its first output. `promptedTurnInFlight` is true
-   * while a turn the driver dispatched holds the CLI.
+   * while a turn the harness dispatched holds the CLI.
    */
   observe(msg, promptedTurnInFlight) {
     const inTurn = promptedTurnInFlight || this.active;
@@ -226,7 +226,7 @@ var SelfTurnTracker = class {
     return this.active && !this.joined && this.queuedPrompt !== null;
   }
   /**
-   * The driver pushed a prompt (`uuid`) into the live CLI. During a self-started
+   * The harness pushed a prompt (`uuid`) into the live CLI. During a self-started
    * turn the CLI may fold it into that turn or answer it in a turn of its own;
    * the prompt joins the wake only once the CLI stamps its uuid on the wake's
    * output. A CLI not seen to stamp uuids is assumed to fold it in.
@@ -313,7 +313,7 @@ function remember(set, taskId) {
   }
 }
 
-// bridge/src/drivers/claude-tool-allowlist.ts
+// bridge/src/harnesses/claude-tool-allowlist.ts
 var CAPABILITY_MCP_SERVER = "skaile-capabilities";
 var CLAUDE_CODE_BUILTIN_TOOLS = /* @__PURE__ */ new Set([
   "Agent",
@@ -378,7 +378,7 @@ function toolAllowlistDenial(toolName, allowed) {
   return `The tool ${toolName} is not available in this turn. Answer with the tools you have.`;
 }
 
-// bridge/src/drivers/sanitize-assistant-text.ts
+// bridge/src/harnesses/sanitize-assistant-text.ts
 var NS = "(?:[a-z][a-z0-9]*:)?";
 var FUNCTION_CALL_BLOCK = new RegExp(
   `\\[\\s*${NS}function_calls\\s*\\][\\s\\S]*?\\[\\s*/\\s*${NS}function_calls\\s*\\]`,
@@ -484,7 +484,7 @@ function streamingSafeSanitize(text) {
   return cleaned.replace(/\s+$/, "");
 }
 
-// bridge/src/drivers/claude-sdk.ts
+// bridge/src/harnesses/claude-sdk.ts
 var zStatic = zNS.z ?? zNS.default ?? zNS;
 function capabilityToolsKey(tools) {
   return JSON.stringify(
@@ -647,7 +647,7 @@ var PushableInputStream = class {
   }
 };
 var ABORT_GRACE_MS = 3e3;
-var KILLED_TURN_MESSAGE = "driver was killed";
+var KILLED_TURN_MESSAGE = "harness was killed";
 var MODEL_USAGE_COUNTERS = [
   ["inputTokens", "inputTokens"],
   ["outputTokens", "outputTokens"],
@@ -752,13 +752,13 @@ function withoutExpectedSdkWarnings(fn) {
     process.emitWarning = original;
   }
 }
-var ClaudeSdkDriver = class extends AgentDriver {
-  driverInfo = {
+var ClaudeSdkHarness = class extends AgentHarness {
+  harnessInfo = {
     id: "claude-sdk",
     name: "Claude Agent SDK",
     modelAgnostic: false,
     supportsInBandAbort: true,
-    capabilities: BUILTIN_DRIVER_CATALOG["claude-sdk"]?.capabilities
+    capabilities: BUILTIN_HARNESS_CATALOG["claude-sdk"]?.capabilities
   };
   log = getBridgeLogger("claude-sdk");
   /** `kind: mcp` logger for tool-schema drops, alongside the runner's MCP rows. */
@@ -889,7 +889,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
       });
     }
   });
-  /** Set by {@link kill}: no turn may start or replay on this driver again. */
+  /** Set by {@link kill}: no turn may start or replay on this harness again. */
   killed = false;
   /** `Date.now()` of the most recent SDK message — the watchdog's liveness signal. */
   lastSdkMessageAt = 0;
@@ -958,7 +958,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
   failoverUsageCarry = null;
   /**
    * Whether this attempt already reported a provider rejection. One upstream
-   * failure routinely reaches the driver twice — `rejected` telemetry followed
+   * failure routinely reaches the harness twice — `rejected` telemetry followed
    * by the error result, or an `is_error` result followed by the iterator throw
    * carrying the real text — and these observations feed counters, so counting
    * one rejection twice would overstate the seat's pressure.
@@ -1052,14 +1052,14 @@ var ClaudeSdkDriver = class extends AgentDriver {
   /** Capability tools already warned about, so a per-turn rebuild logs each once. */
   warnedDroppedCapabilityTools = /* @__PURE__ */ new Set();
   /**
-   * @param config - Driver configuration. Claude SDK-relevant fields:
+   * @param config - Harness configuration. Claude SDK-relevant fields:
    *   - `cwd` — working directory; SDK session files and agent definitions are read from here.
    *   - `registry` + `modelRef` — the AI provider registry and the selector into it. The
    *     selected entry is the endpoint: its `base_url`, `headers` and `credential.kind`
    *     become the SDK child env on every transport (`buildClaudeEndpointEnv`), and its
    *     `model_map` resolves the model id.
    *   - `model` — model identifier (e.g. `"claude-sonnet-4-5"`); the selector's fallback and
-   *     the driver's own default (`"sonnet"`) when no entry names a model.
+   *     the harness's own default (`"sonnet"`) when no entry names a model.
    *   - `env` — the child environment the endpoint vars are layered on, and where the
    *     session boundary delivered each entry's credential as `SKAILE_AIP_<ID>_KEY`. A
    *     session with no registry entry inherits the environment and lets the SDK resolve
@@ -1068,7 +1068,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    *   - `mcpServers` — in-process MCP server instances injected as native `tool_use` tools.
    *   - `systemPrompt` — appended to the `claude_code` preset system prompt (the preset is
    *     sent even when this is empty).
-   *   - `resumeSessionId` — SDK session UUID to resume from a prior driver lifetime.
+   *   - `resumeSessionId` — SDK session UUID to resume from a prior harness lifetime.
    *   - `maxTurns` — maximum agentic turns per `prompt()` call (default: 15).
    */
   constructor(config) {
@@ -1093,7 +1093,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * live (thinking/effort, a model on another registry entry, a rejected or
    * timed-out `setModel`) recycles the query at the next turn boundary, so the
    * fresh CLI resumes with the new config. The {@link ReconfigureLedger} owns
-   * the scope rule, ordering and drift; {@link applyLive} is this driver's hook.
+   * the scope rule, ordering and drift; {@link applyLive} is this harness's hook.
    */
   reconfigure(patch) {
     return this.reconfig.reconfigure(patch);
@@ -1160,7 +1160,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    *   the package manager's add command for `@anthropic-ai/claude-agent-sdk`.
    */
   async start() {
-    this.sdk = await loadDriverSdk(
+    this.sdk = await loadHarnessSdk(
       "@anthropic-ai/claude-agent-sdk",
       this.config.cwd,
       () => import('@anthropic-ai/claude-agent-sdk'),
@@ -1188,7 +1188,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
   }
   /**
    * Text plus an optional per-turn tool allowlist. An allowlist naming a tool
-   * this driver does not recognize is rejected before the turn is queued.
+   * this harness does not recognize is rejected before the turn is queued.
    */
   promptInput(input) {
     if (input.attachments?.length) return Promise.reject(new Error("Structured input unsupported"));
@@ -1830,7 +1830,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
   }
   /**
    * Resolve the Claude Code config directory — the parent of `projects/` — from
-   * the driver config, the process environment, or the `~/.claude` default.
+   * the harness config, the process environment, or the `~/.claude` default.
    */
   resolveClaudeConfigDir() {
     return resolveClaudeConfigDir(this.config.env);
@@ -1841,7 +1841,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * The reactive {@link scrubPoisonedTranscript} pass in `prompt()` only fires
    * *after* a turn has already failed with a `400 invalid_request_error`,
    * costing a wasted round-trip and surfacing a scary (if non-fatal) error to
-   * the user. A transcript poisoned in a prior driver lifetime — most commonly
+   * the user. A transcript poisoned in a prior harness lifetime — most commonly
    * an image block whose `media_type` does not match its bytes, produced by the
    * Claude Code `Read` tool on a PDF with embedded JPEGs (anthropics/claude-code
    * #55338) — would otherwise 400 on the very first resumed turn.
@@ -1904,9 +1904,9 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * first result of a resumed spawn restates everything booked before it. The
    * restored totals are therefore the baseline, not new spend:
    * - resuming the session the in-memory baseline belongs to (a recycle or a
-   *   replay in this driver lifetime) keeps that baseline. It is what was
+   *   replay in this harness lifetime) keeps that baseline. It is what was
    *   booked, so spend the old process made without a result still counts;
-   * - resuming any other session (a wake: a new driver) takes the transcript's
+   * - resuming any other session (a wake: a new harness) takes the transcript's
    *   `cost-state`, read in the same pass as the scrub;
    * - a fresh session, or a transcript without a `cost-state`, starts at zero.
    * A first total below the kept baseline means the CLI restored an older
@@ -1937,7 +1937,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * everything derived from it: the child env, the credential, the
    * provider-side model id.
    *
-   * This is the driver's single endpoint decision, taken on **every**
+   * This is the harness's single endpoint decision, taken on **every**
    * transport — a plain `direct` endpoint with a custom `base_url` reaches
    * that base URL, which the deleted `cloud !== "default"` gate made
    * impossible.
@@ -1948,24 +1948,26 @@ var ClaudeSdkDriver = class extends AgentDriver {
     const registry = this.config.registry ?? mergeRegistries([]);
     const selected = this.config.modelRef ? parseModelRef(this.config.modelRef, registry, this.config.roles) : void 0;
     const { providers } = registry;
+    const supported = BUILTIN_HARNESS_CATALOG["claude-sdk"].surfaces;
+    const speaksSurface = (candidate) => {
+      const surface = "surface" in candidate ? candidate.surface : void 0;
+      return !surface || !supported || supported.includes(surface);
+    };
     const named = this.config.modelRef?.trim();
     const providerId = named && providers[named] ? named : selected?.providerId ?? registry.order.find((id) => {
       const candidate = providers[id];
-      return !!candidate && (candidate.kind === "llm" || candidate.kind === "embed") && isEntryEnabled(candidate);
+      return !!candidate && (candidate.kind === "llm" || candidate.kind === "embed") && isEntryEnabled(candidate) && speaksSurface(candidate);
     });
     const entry = providerId ? providers[providerId] : void 0;
     const configEnv = { ...this.config.env ?? {} };
     if (!entry || !providerId) {
       return { mode: "anthropic", baseEnv, lookupEnv, configEnv };
     }
-    const surface = "surface" in entry ? entry.surface : void 0;
-    const supported = BUILTIN_DRIVER_CATALOG["claude-sdk"].surfaces;
-    if (surface && supported && !supported.includes(surface)) {
-      this.log.warn("provider entry declares a surface the Claude Agent SDK cannot speak", {
-        providerId,
-        surface,
-        supported
-      });
+    if (!speaksSurface(entry)) {
+      const surface = "surface" in entry ? entry.surface : void 0;
+      this.log.warn(
+        `provider '${providerId}' uses the '${surface}' surface, which the Claude Agent SDK cannot speak (it speaks: ${(supported ?? []).join(", ")})`
+      );
     }
     const model = providerId === named ? void 0 : selected?.providerModelId;
     const credential = entryCredentialValue(providerId, entry, { env: lookupEnv });
@@ -2078,7 +2080,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
       // ── Session continuity ────────────────────────────────────────────────
       // Three-level fallback ensures the right session is always resumed:
       //   resumeSessionId — caller explicitly wants this session (skaile resume)
-      //   sessionId       — a session was already started this driver lifetime (multi-turn)
+      //   sessionId       — a session was already started this harness lifetime (multi-turn)
       //   continue: true  — resume the most recent session in cwd (between restarts)
       //   (none)          — start fresh
       ...this.config.resumeSessionId ? { resume: this.config.resumeSessionId } : this.sessionId ? { resume: this.sessionId } : this.hasSession ? { continue: true } : {},
@@ -2443,7 +2445,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
     if (tools.length === 0) return { server: null, dropped };
     let sdk;
     try {
-      sdk = await loadDriverSdk(
+      sdk = await loadHarnessSdk(
         "@anthropic-ai/claude-agent-sdk",
         this.config.cwd,
         () => import('@anthropic-ai/claude-agent-sdk')
@@ -2650,7 +2652,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * Reject the current turn WITHOUT emitting an `agent-event: error`.
    *
    * The one legitimate use is a turn that is about to be replayed: the host
-   * must not see an error for a failure the driver is itself recovering from
+   * must not see an error for a failure the harness is itself recovering from
    * (the same reasoning as `failTurn`'s auth self-heal deferral). Ordering
    * mirrors {@link failTurn} — settle the promise before touching anything
    * else — so a turn can never be left pending.
@@ -2679,7 +2681,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
    * listener throws (transport.send on a closed socket, normalizer bug,
    * compaction tracking error, etc.) the throw would otherwise propagate
    * out of failTurn before `turnReject` can run, leaving `await
-   * turnPromise` pending forever and silently hanging `driver.prompt(...)`
+   * turnPromise` pending forever and silently hanging `harness.prompt(...)`
    * — which in turn prevents the runner's `onAuthError` callback from
    * firing on stale-token 401s. Settling the promise first guarantees the
    * caller transitions even if the listener chain misbehaves; the emit is
@@ -3413,7 +3415,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
   }
   /**
    * Requests the current SDK query to stop processing via `query.interrupt()` and
-   * signals the underlying `AbortController`. The driver remains usable after abort.
+   * signals the underlying `AbortController`. The harness remains usable after abort.
    *
    * Also SIGKILLs every OS descendant of the CLI subprocess (e.g. a running
    * Bash command) on either path the turn ends — see
@@ -3450,15 +3452,15 @@ var ClaudeSdkDriver = class extends AgentDriver {
     }
     this.killPids(descendants);
   }
-  /** `true` while the driver is processing a `prompt()` call. */
+  /** `true` while the harness is processing a `prompt()` call. */
   get isRunning() {
     return this.running;
   }
   /**
    * Closes the active SDK query and resets all session state.
    *
-   * The driver instance must not be reused after `kill()`. Session IDs are cleared,
-   * so a new `ClaudeSdkDriver` will start a fresh session.
+   * The harness instance must not be reused after `kill()`. Session IDs are cleared,
+   * so a new `ClaudeSdkHarness` will start a fresh session.
    *
    * Also SIGKILLs every OS descendant of the CLI subprocess (e.g. a running
    * Bash command) — see {@link snapshotDescendantPids}'s doc for why that
@@ -3618,21 +3620,21 @@ var ClaudeSdkDriver = class extends AgentDriver {
     return claudeBinaryCache;
   }
 };
-var claudeSdkDriverTarget = {
+var claudeSdkHarnessTarget = {
   id: "claude-sdk",
-  displayName: BUILTIN_DRIVER_CATALOG["claude-sdk"]?.name ?? "Claude Agent SDK",
+  displayName: BUILTIN_HARNESS_CATALOG["claude-sdk"]?.name ?? "Claude Agent SDK",
   apiVersion: 1,
-  // Drivers take AgentConfig; passthrough — full schema validation is out of scope.
+  // Harnesses take AgentConfig; passthrough — full schema validation is out of scope.
   // `zStatic.custom` keeps the static-import discipline (see zNS unwrap above).
   configSchema: zStatic.custom(() => true),
-  create: async (config, _ctx) => new ClaudeSdkDriver(config),
-  listModels: async (registry, options) => new ClaudeSdkDriver({
+  create: async (config, _ctx) => new ClaudeSdkHarness(config),
+  listModels: async (registry, options) => new ClaudeSdkHarness({
     cwd: process.cwd(),
     sessionId: "model-list",
-    ...registryDriverConfig(registry, options)
+    ...registryHarnessConfig(registry, options)
   }).listModels()
 };
 
-export { ClaudeSdkDriver, claudeSdkDriverTarget, diffModelUsage, withoutExpectedSdkWarnings };
+export { ClaudeSdkHarness, claudeSdkHarnessTarget, diffModelUsage, withoutExpectedSdkWarnings };
 //# sourceMappingURL=claude-sdk.js.map
 //# sourceMappingURL=claude-sdk.js.map