@skaile/workspaces 5.19.0 → 6.1.0

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-VJ7NU7GD.js';
-import { dispatchCapability } from '../../chunk-AJ7EGIFR.js';
-import { fetchProviderModels } from '../../chunk-MKRWN7XP.js';
-import { ReconfigureLedger, AuthError, stripRunnerPrivateEnv, classifyClaudeSdkError, reclassifyAuthAsAccountUnavailable, AccountUnavailableError, isLongContextEntitlementRejection, LONG_CONTEXT_CREDITS_API_ERROR } from '../../chunk-RPZVHXQ3.js';
-import { agentExecRequested, wrapAgentCommand, resolveAgentExec } from '../../chunk-YROR332M.js';
-import { AgentDriver, getBridgeLogger, registryDriverConfig } from '../../chunk-XWOPZW26.js';
-import { BUILTIN_DRIVER_CATALOG, entryCredentialValue } from '../../chunk-CQJH4G2K.js';
-import '../../chunk-6E6PKKAD.js';
-import { withActivityLabelShape } from '../../chunk-Y56YIT6J.js';
-import '../../chunk-335ENCCS.js';
-import { loadDriverSdk } from '../../chunk-N46LQR46.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, unsupportedSurfaceNotice, claudeEndpointMode, buildClaudeEndpointEnv, APPROVE_ONCE, DENY } from '../../chunk-SVTMNSPI.js';
+import { dispatchCapability } from '../../chunk-BIRW3HOG.js';
+import { fetchProviderModels } from '../../chunk-5J4NPGFM.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-FKQNBCDW.js';
+import { BUILTIN_HARNESS_CATALOG, entryCredentialValue } from '../../chunk-ILLTBKDJ.js';
+import '../../chunk-G5SUWZEU.js';
+import { withActivityLabelShape } from '../../chunk-JCPD4QRM.js';
+import '../../chunk-E572OHGY.js';
+import { loadHarnessSdk } from '../../chunk-VMVDAZLA.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-TIIXG3PN.js';
-import '../../chunk-5TBFN46Z.js';
-import '../../chunk-5BEFNLOR.js';
+import '../../chunk-ZDLUQLI6.js';
+import '../../chunk-5KRMNUL4.js';
+import '../../chunk-Z7ZEZZB6.js';
 import '../../chunk-MWXYN6NY.js';
-import '../../chunk-V257LUBM.js';
+import '../../chunk-ZHGKAZJ7.js';
 import '../../chunk-L5VSIPQD.js';
-import '../../chunk-IG5LZ3WU.js';
-import '../../chunk-UQ33Y4DM.js';
+import '../../chunk-VTETQCR6.js';
+import '../../chunk-ZBHZLWV3.js';
 import '../../chunk-RVRB27AN.js';
-import '../../chunk-GOCWM7FN.js';
-import '../../chunk-WDXZA7QW.js';
-import '../../chunk-ICSCSM5D.js';
+import '../../chunk-RHN5MRQO.js';
+import '../../chunk-LSSYC5IC.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,7 +1948,7 @@ 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_DRIVER_CATALOG["claude-sdk"].surfaces;
+    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);
@@ -1963,12 +1963,8 @@ var ClaudeSdkDriver = class extends AgentDriver {
     if (!entry || !providerId) {
       return { mode: "anthropic", baseEnv, lookupEnv, configEnv };
     }
-    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 notice = unsupportedSurfaceNotice(providerId, entry);
+    if (notice) this.log.info(notice);
     const model = providerId === named ? void 0 : selected?.providerModelId;
     const credential = entryCredentialValue(providerId, entry, { env: lookupEnv });
     return {
@@ -2000,7 +1996,7 @@ var ClaudeSdkDriver = class extends AgentDriver {
     const apiKey = endpoint.mode === "anthropic" && endpoint.entry?.credential?.kind === "api_key_header" ? endpoint.credential : void 0;
     this.usingOauthCredential = endpoint.mode === "anthropic" && !endpoint.credential;
     const claudePath = this.findClaudeBinary();
-    const onStderr = (data) => this.log.warn("claude stderr", { line: data.trim() });
+    const onStderr = (data) => this.log.info("claude stderr", { line: data.trim() });
     const { patch: mcpServersPatch, dropped: droppedMcpTools } = await this.buildEffectiveMcpServers();
     const systemPromptAppend = [this.config.systemPrompt, formatDroppedToolsNotice(droppedMcpTools)].filter((part) => !!part).join("\n\n");
     this.appendedSystemPrompt = systemPromptAppend;
@@ -2080,7 +2076,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 } : {},
@@ -2445,7 +2441,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')
@@ -2652,7 +2648,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.
@@ -2681,7 +2677,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
@@ -3415,7 +3411,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
@@ -3452,15 +3448,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
@@ -3620,21 +3616,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