@skaile/workspaces 5.19.0 → 6.0.0

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

@@ -1,19 +1,19 @@
 import type { AIProviderRegistry, MergedAIProviderRegistry } from "@skaile/workspaces/core/provider-registry";
-import type { DriverContext } from "@skaile/workspaces/plugin-registry";
+import type { HarnessContext } from "@skaile/workspaces/plugin-registry";
 import { type PluginRegistry } from "@skaile/workspaces/plugin-registry";
 import type { ModelEntry } from "./models.js";
 import type { RegistryCredentialOptions } from "./provider-materialize/credential-env.js";
-import type { AgentConfig, AgentDriver, DriverInfo } from "./types.js";
+import type { AgentConfig, AgentHarness, HarnessInfo } from "./types.js";
 /**
  * Static capability metadata for every built-in harness.
  *
- * Pure data — this object imports no driver module and references no harness
- * SDK. {@link listDrivers} returns it (merged with any third-party drivers)
+ * Pure data — this object imports no harness module and references no harness
+ * SDK. {@link listHarnesses} returns it (merged with any third-party harnesses)
  * so selection UIs can enumerate every harness without loading a single
- * driver module. The matching driver module's `DriverTarget` is registered
- * into the plugin registry by {@link registerBuiltinDrivers}.
+ * harness module. The matching harness module's `HarnessTarget` is registered
+ * into the plugin registry by {@link registerBuiltinHarnesses}.
  *
- * `surfaces` and `providerPlurality` are the driver-capability declaration
+ * `surfaces` and `providerPlurality` are the harness-capability declaration
  * the AI provider registry resolves against (plan §2.3): which wire protocols
  * a harness can be pointed at, and how many registry entries it can use at
  * once. The platform's resolver filters candidate entries on `surfaces`
@@ -21,19 +21,12 @@ import type { AgentConfig, AgentDriver, DriverInfo } from "./types.js";
  *
  * @docLink packages/bridge/api-reference#registry
  */
-export declare const BUILTIN_DRIVER_CATALOG: Record<string, DriverInfo>;
+export declare const BUILTIN_HARNESS_CATALOG: Record<string, HarnessInfo>;
 /**
- * Back-compat alias for {@link BUILTIN_DRIVER_CATALOG}. Consumers and tests that
- * predate the plugin-registry refactor still import `DRIVER_CATALOG`.
- *
- * @docLink packages/bridge/api-reference#registry
- */
-export declare const DRIVER_CATALOG: Record<string, DriverInfo>;
-/**
- * Register every built-in driver's `DriverTarget` into the plugin registry.
+ * Register every built-in harness's `HarnessTarget` into the plugin registry.
  *
  * This is the single id → module map in bridge core. Every specifier is a
- * literal string so `bun --compile` can statically bundle the driver module
+ * literal string so `bun --compile` can statically bundle the harness module
  * (and, transitively, its SDK). The in-process-SDK harnesses (`claude-sdk`,
  * `codex`) are wrapped in build-constant guards so an excluded harness's
  * `await import` folds to dead code in the compiled binary. `omp` and `echo`
@@ -49,54 +42,54 @@ export declare const DRIVER_CATALOG: Record<string, DriverInfo>;
  *
  * @docLink packages/bridge/api-reference#registry
  */
-export declare function registerBuiltinDrivers(registry?: PluginRegistry): Promise<void>;
+export declare function registerBuiltinHarnesses(registry?: PluginRegistry): Promise<void>;
 /**
- * Creates a new driver instance for the given harness id.
+ * Creates a new harness instance for the given harness id.
  *
- * Ensures the built-in driver targets are registered (idempotent), then looks
+ * Ensures the built-in harness targets are registered (idempotent), then looks
  * up the target in the plugin registry and calls its `create()`. The returned
- * driver has not been started yet — call `driver.start()` before sending
+ * harness has not been started yet — call `harness.start()` before sending
  * prompts.
  *
- * @param id - Registered driver identifier (e.g. `"omp"`, `"claude-sdk"`).
- * @param config - Configuration forwarded to the driver constructor.
- * @param ctx - Optional driver context (logger / abort signal). Defaults to `{}`.
- * @returns A freshly constructed (not yet started) {@link AgentDriver}.
+ * @param id - Registered harness identifier (e.g. `"omp"`, `"claude-sdk"`).
+ * @param config - Configuration forwarded to the harness constructor.
+ * @param ctx - Optional harness context (logger / abort signal). Defaults to `{}`.
+ * @returns A freshly constructed (not yet started) {@link AgentHarness}.
  * @throws {Error} When `id` is a known harness excluded from this build, or
- *   when `id` does not match any registered driver at all.
+ *   when `id` does not match any registered harness at all.
  * @docLink packages/bridge/api-reference#registry
  */
-export declare function createDriver(id: string, config: AgentConfig, ctx?: DriverContext): Promise<AgentDriver>;
+export declare function createHarness(id: string, config: AgentConfig, ctx?: HarnessContext): Promise<AgentHarness>;
 /**
- * Returns the capability metadata for every available driver.
+ * Returns the capability metadata for every available harness.
  *
- * Enumerates every built-in harness from {@link BUILTIN_DRIVER_CATALOG} without
- * loading a single driver module or harness SDK, then merges in any third-party
- * driver targets registered into the plugin registry that are not already in
- * the catalog. Use this to populate driver selection UIs.
+ * Enumerates every built-in harness from {@link BUILTIN_HARNESS_CATALOG} without
+ * loading a single harness module or harness SDK, then merges in any third-party
+ * harness targets registered into the plugin registry that are not already in
+ * the catalog. Use this to populate harness selection UIs.
  *
- * @returns Array of {@link DriverInfo} objects, one per available driver.
+ * @returns Array of {@link HarnessInfo} objects, one per available harness.
  * @docLink packages/bridge/api-reference#registry
  */
-export declare function listDrivers(): DriverInfo[];
+export declare function listHarnesses(): HarnessInfo[];
 /**
- * List models available to a specific driver without starting a full agent session.
+ * List models available to a specific harness without starting a full agent session.
  *
- * Ensures the built-in driver targets are registered (idempotent), then
+ * Ensures the built-in harness targets are registered (idempotent), then
  * delegates to the target's optional `listModels()`. Throws on an unknown /
- * not-bundled id (same contract as {@link createDriver}); returns `[]` only
+ * not-bundled id (same contract as {@link createHarness}); returns `[]` only
  * when the target exists but exposes no `listModels`.
  *
- * @param driverId - Registered driver id (e.g. `"omp"`, `"claude-sdk"`, `"codex"`).
+ * @param harnessId - Registered harness id (e.g. `"omp"`, `"claude-sdk"`, `"codex"`).
  * @param registry - The AI provider registry to discover against — either the
  *   bare `id → entry` map or a merged view. Each entry names its credential by
  *   reference, resolved through `options` and delivered to the throwaway
- *   driver as `SKAILE_AIP_<ID>_KEY` environment entries.
+ *   harness as `SKAILE_AIP_<ID>_KEY` environment entries.
  * @param options - Which entry to restrict to, and where `env:` / `platform:`
  *   references resolve from. Defaults to the whole registry against
  *   `process.env`.
- * @throws {Error} When `driverId` is unknown or excluded from this build.
+ * @throws {Error} When `harnessId` is unknown or excluded from this build.
  * @docLink packages/bridge/api-reference#registry
  */
-export declare function listModelsForDriver(driverId: string, registry: AIProviderRegistry | MergedAIProviderRegistry, options?: RegistryCredentialOptions): Promise<ModelEntry[]>;
+export declare function listModelsForHarness(harnessId: string, registry: AIProviderRegistry | MergedAIProviderRegistry, options?: RegistryCredentialOptions): Promise<ModelEntry[]>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/bridge/src/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../bridge/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE1F,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4BvE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA+F7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,4BAAyB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,GAAE,cAA+B,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAGtB;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,UAAU,EAAE,CA0B1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB,EACvD,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../bridge/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE1F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4BzE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA+F/D,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,GAAE,cAA+B,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,YAAY,CAAC,CAGvB;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CA0B7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB,EACvD,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB"}

package/dist/bridge/src/runner-private-env.d.ts

@@ -5,10 +5,10 @@
  * `SKAILE_WS_AUTH_TOKEN` authenticates the host on the runner's own WebSocket.
  * An agent that can read it can connect to the runner as the host and send host
  * commands (prompts, connector mutations such as flow-gate approvals). The
- * runner removes it from `process.env` at startup; every driver strips it again
+ * runner removes it from `process.env` at startup; every harness strips it again
  * from the env it hands its child, so a value that slips back in through
  * `AgentConfig.env` or an embedder that skipped the startup scrub still stops
- * at the driver.
+ * at the harness.
  */
 export declare const RUNNER_PRIVATE_ENV_KEYS: readonly string[];
 /**

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

@@ -1,26 +1,26 @@
 /**
  * BridgeRuntime — implements IAgentRuntime from @skaile/workspaces/types by wrapping
- * an AgentDriver + EventNormalizer. This is the primary integration point for
- * consumers that want normalized events from any driver.
+ * an AgentHarness + EventNormalizer. This is the primary integration point for
+ * consumers that want normalized events from any harness.
  */
 import type { AgentEvent, AgentPromptInput, AgentReconfigureOptions, AgentRuntimeConfig, IAgentRuntime } from "@skaile/workspaces/types";
 /**
- * Implements `IAgentRuntime` from `@skaile/workspaces/types` by wrapping an {@link AgentDriver}
+ * Implements `IAgentRuntime` from `@skaile/workspaces/types` by wrapping an {@link AgentHarness}
  * and an {@link EventNormalizer}.
  *
  * This is the primary integration point for consumers that want normalized `AgentEvent`
- * payloads from any driver without managing the driver lifecycle directly. Create via
+ * payloads from any harness without managing the harness lifecycle directly. Create via
  * {@link createRuntime} to avoid coupling to `BridgeRuntime` directly.
  *
  * @docLink packages/bridge/api-reference#runtime
  */
 export declare class BridgeRuntime implements IAgentRuntime {
-    private driver;
+    private harness;
     private normalizer;
     private handlers;
     private boundEventHandler;
-    private driverId;
-    constructor(driverId?: string);
+    private harnessId;
+    constructor(harnessId?: string);
     start(config: AgentRuntimeConfig): Promise<void>;
     configure(_config: AgentReconfigureOptions): Promise<void>;
     prompt(message: string): Promise<void>;
@@ -33,11 +33,11 @@ export declare class BridgeRuntime implements IAgentRuntime {
     get isRunning(): boolean;
 }
 /**
- * Factory function to create a {@link BridgeRuntime} with the specified driver.
+ * Factory function to create a {@link BridgeRuntime} with the specified harness.
  *
- * @param driverId - Registered driver id (default: `"claude-sdk"`).
- * @returns A new `IAgentRuntime` wrapping the selected driver with event normalization.
+ * @param harnessId - Registered harness id (default: `"claude-sdk"`).
+ * @returns A new `IAgentRuntime` wrapping the selected harness with event normalization.
  * @docLink packages/bridge/api-reference#runtime
  */
-export declare function createRuntime(driverId?: string): IAgentRuntime;
+export declare function createRuntime(harnessId?: string): IAgentRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/bridge/src/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../bridge/src/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAOlC;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAqB;IAIrC,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChD,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAInD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAqB,GAAG,aAAa,CAE5E"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../bridge/src/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAOlC;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,GAAE,MAAqB;IAItC,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChD,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAInD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,GAAE,MAAqB,GAAG,aAAa,CAE7E"}