@skaile/workspaces 0.8.5

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

@@ -0,0 +1,90 @@
+/**
+ * Model catalog — static fallback + live provider API fetching.
+ *
+ * Provides `fetchProviderModels(provider, apiKey)` for live model lists and
+ * `getStaticModels(provider)` as an offline fallback.
+ * OMP model listing is handled by `OmpDriver.listModels()` in the bridge driver.
+ */
+/**
+ * A single LLM model entry returned by the model catalog.
+ *
+ * Used by `getModels`, `getStaticModels`, and `fetchProviderModels` to represent
+ * an available model for a provider.
+ *
+ * @docLink packages/bridge/api-reference#models
+ */
+export interface ModelEntry {
+    /** Provider-specific model identifier used in API calls (e.g. `"claude-sonnet-4-5"`). */
+    id: string;
+    /** Human-readable display name for UIs and logs (e.g. `"Claude Sonnet 4.5"`). */
+    name: string;
+}
+/**
+ * Result of a model-list fetch operation, with source attribution.
+ *
+ * Returned by {@link fetchProviderModels} and {@link getModels}. When `ok` is `false`,
+ * `models` is empty and `error` describes the failure. The `source` field indicates
+ * whether the list came from a live API call or the offline static catalog.
+ *
+ * @docLink packages/bridge/api-reference#models
+ */
+export interface FetchModelsResult {
+    /** `true` when the fetch succeeded and `models` is populated. */
+    ok: boolean;
+    /** Fetched model list; empty on failure. */
+    models: ModelEntry[];
+    /** Human-readable error description when `ok` is `false`. */
+    error?: string;
+    /** Whether the result came from a live API call or the static fallback. */
+    source: "api" | "static";
+}
+/**
+ * Fetch the model list from a provider's REST API.
+ *
+ * Returns `{ ok: true, models, source: 'api' }` on success, or
+ * `{ ok: false, models: [], error }` on any HTTP or network failure — the
+ * caller should fall back to {@link getStaticModels} in that case.
+ *
+ * @param provider - Provider name matching a key in the internal `PROVIDER_API` map
+ *   (e.g. `"anthropic"`, `"openai"`, `"google"`).
+ * @param apiKey - API key forwarded in the request header or query parameter.
+ * @returns Resolved model list with source attribution.
+ * @docLink packages/bridge/api-reference#models
+ */
+export declare function fetchProviderModels(provider: string, apiKey: string): Promise<FetchModelsResult>;
+/**
+ * Get models for a provider, trying the live API first and falling back to the static catalog.
+ *
+ * When no `apiKey` is provided the static catalog is returned immediately without
+ * a network call. When the live API fails or returns an empty list, the static
+ * catalog is used as a fallback — the result's `source` field indicates which was used.
+ *
+ * @param provider - Provider name (e.g. `"anthropic"`, `"openai"`, `"google"`).
+ * @param apiKey - Optional API key; omit to skip the live fetch and use the static catalog.
+ * @returns Resolved model list with source attribution.
+ * @docLink packages/bridge/api-reference#models
+ */
+export declare function getModels(provider: string, apiKey?: string): Promise<FetchModelsResult>;
+/**
+ * Offline model catalog keyed by provider name.
+ *
+ * Used as a fallback by {@link getModels} when the live provider API is unreachable or
+ * returns an empty list. Covers Anthropic, OpenAI, Google, Mistral, Groq, DeepSeek,
+ * xAI, Together, Fireworks, and OpenRouter. Update this list when providers add new
+ * models and a live fetch is not available.
+ *
+ * @docLink packages/bridge/api-reference#models
+ */
+export declare const STATIC_MODELS: Record<string, ModelEntry[]>;
+/**
+ * Get models for a specific provider from the static catalog, or empty array if unknown.
+ *
+ * Pure synchronous lookup — no network call. Use when the provider API is unavailable
+ * or when a fast offline fallback is needed (e.g. in the UI before credentials are configured).
+ *
+ * @param provider - Provider name matching a key in {@link STATIC_MODELS}.
+ * @returns Offline model list, or `[]` for unknown providers.
+ * @docLink packages/bridge/api-reference#models
+ */
+export declare function getStaticModels(provider: string): ModelEntry[];
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../bridge/src/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AA4JD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,EAAE,EAAE,OAAO,CAAC;IACZ,4CAA4C;IAC5C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA8C5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7F;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAgEtD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAE9D"}

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

@@ -0,0 +1,91 @@
+/**
+ * EventNormalizer — converts bridge-level AgentEvent (raw driver events) to
+ * skaile-agent-types AgentEvent (normalized, human-readable events).
+ *
+ * Stateful: tracks active subagents and dev-server detection across a session.
+ * Call reset() between sessions.
+ */
+import type { AgentEvent as NormalizedEvent } from "@skaile/workspaces/types";
+import type { AgentEvent as BridgeEvent } from "./types.js";
+/**
+ * Converts raw bridge-level {@link BridgeEvent} payloads into normalized
+ * `@skaile/workspaces/types` `AgentEvent` payloads consumed by the runner and transport.
+ *
+ * Stateful: tracks active subagents and dev-server detection across a session.
+ * Call {@link EventNormalizer.reset} between sessions to clear accumulated state.
+ *
+ * @docLink packages/bridge/api-reference#normalizer
+ */
+export declare class EventNormalizer {
+    private activeSubagents;
+    private devServerStartingEmitted;
+    private devServerReadyEmitted;
+    /** True when message_update deltas have been emitted for the current message. */
+    private hasStreamedText;
+    /**
+     * Convert a single bridge event into zero or more normalized events.
+     * One bridge event can produce multiple normalized events (e.g., a message_start
+     * with text + tool_use blocks produces both text and tool_call events).
+     */
+    normalize(event: BridgeEvent): NormalizedEvent[];
+    /** Clear all stateful tracking between sessions. */
+    reset(): void;
+    private handleMessageStart;
+    private handleToolUse;
+    private handleMessageUpdate;
+    private handleTurnEnd;
+    private isSubagentResult;
+    private resolveSubagentName;
+    private handleResult;
+    private detectDevServerStarting;
+    private detectDevServerReady;
+    private getContentBlocks;
+}
+/**
+ * Produce a human-readable one-line summary of a tool call for the activity log.
+ *
+ * Returns a string like `$ git status` for Bash, `Read src/index.ts` for Read, etc.
+ * Falls back to `ToolName({...input...})` for unrecognised tools.
+ *
+ * @param tool - Tool name (e.g. `"Bash"`, `"Write"`, `"Grep"`).
+ * @param input - Tool input record passed to the call.
+ * @returns A short display string suitable for the activity feed.
+ * @docLink packages/bridge/api-reference#normalizer
+ */
+export declare function summarizeToolCall(tool: string, input: Record<string, unknown>): string;
+/**
+ * Produce a human-readable one-line summary of a tool result for the activity log.
+ *
+ * Handles Bash stdout/stderr, Write/Edit file paths, ApplyPatch change counts, and
+ * Anthropic content-block arrays. Falls back to `JSON.stringify` for unknown shapes.
+ *
+ * @param tool - Tool name.
+ * @param result - Raw tool result payload.
+ * @returns A short display string, truncated to 200 characters.
+ * @docLink packages/bridge/api-reference#normalizer
+ */
+export declare function summarizeToolResult(tool: string, result: unknown): string;
+/**
+ * Detect file-change events from a tool result, returning zero or more `file_changed` events.
+ *
+ * Handles `Write` (single create/edit), `Edit` (single edit), and `ApplyPatch` (multi-file
+ * patch with per-change `kind` classification). Returns an empty array for all other tools.
+ *
+ * @param toolName - Name of the tool that produced the result.
+ * @param result - Raw tool result payload.
+ * @returns Array of `file_changed` normalized events.
+ * @docLink packages/bridge/api-reference#normalizer
+ */
+export declare function detectFileChanges(toolName: string, result: unknown): NormalizedEvent[];
+/**
+ * Backward-compatible single-event helper; returns the first `file_changed` event or `null`.
+ *
+ * Prefer {@link detectFileChanges} for multi-file patches (e.g. `ApplyPatch`).
+ *
+ * @param toolName - Name of the tool that produced the result.
+ * @param result - Raw tool result payload.
+ * @returns First detected `file_changed` event, or `null`.
+ * @docLink packages/bridge/api-reference#normalizer
+ */
+export declare function detectFileChange(toolName: string, result: unknown): NormalizedEvent | null;
+//# sourceMappingURL=normalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../bridge/src/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE9E,OAAO,KAAK,EAAgB,UAAU,IAAI,WAAW,EAAgB,MAAM,YAAY,CAAC;AAExF;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,qBAAqB,CAAS;IACtC,iFAAiF;IACjF,OAAO,CAAC,eAAe,CAAS;IAEhC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,EAAE;IAyDhD,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,aAAa;IA2CrB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,gBAAgB;CAOzB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBtF;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CA6BzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,CAiCtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAE1F"}

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

@@ -0,0 +1,90 @@
+import type { ModelEntry } from "./models.js";
+import type { AgentConfig, AgentDriver, DriverFactory, DriverInfo } from "./types.js";
+/**
+ * Static capability metadata for every built-in backend.
+ *
+ * Pure data — this object imports no driver module and references no backend
+ * SDK. {@link listDrivers} returns it (merged with any third-party drivers)
+ * so selection UIs can enumerate every backend without loading a single
+ * driver module. The matching driver module self-registers its factory via
+ * {@link registerDriver} when {@link loadDriver} imports it.
+ *
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare const DRIVER_CATALOG: Record<string, DriverInfo>;
+/**
+ * Registers a driver factory under a stable string identifier.
+ *
+ * Built-in drivers (`omp`, `claude-sdk`, `codex`, `echo`) self-register when
+ * their driver module is imported by {@link loadDriver} — `createDriver` and
+ * `listModelsForDriver` trigger that load for the requested id. Third-party
+ * drivers can call `registerDriver` directly at any time before the first
+ * `createDriver` call that uses their id.
+ *
+ * @param id - Stable identifier used to look up the driver (e.g. `"omp"`).
+ * @param factory - Function that constructs a new driver instance for the given config.
+ * @param info - Static capability metadata returned by {@link listDrivers}.
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare function registerDriver(id: string, factory: DriverFactory, info: DriverInfo): void;
+/**
+ * Imports the driver module for the given built-in backend id, which
+ * self-registers its factory via {@link registerDriver} on import.
+ *
+ * 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
+ * (and, transitively, its SDK). The in-process-SDK backends (`claude-sdk`,
+ * `codex`) are wrapped in build-constant guards so an excluded backend's
+ * `await import` folds to dead code in the compiled binary. `omp` and `echo`
+ * carry no SDK weight and are always available.
+ *
+ * Unknown ids are a no-op — {@link createDriver} surfaces the clear error.
+ * Idempotent: a second call re-imports an already-cached module.
+ *
+ * @param id - Built-in driver identifier (e.g. `"omp"`, `"claude-sdk"`).
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare function loadDriver(id: string): Promise<void>;
+/**
+ * Creates a new driver instance for the given backend id.
+ *
+ * Lazily loads the driver module via {@link loadDriver} first, so callers
+ * never have to register built-ins themselves. The returned driver has not
+ * been started yet — call `driver.start()` before sending prompts.
+ *
+ * @param id - Registered driver identifier (e.g. `"omp"`, `"claude-sdk"`).
+ * @param config - Configuration forwarded to the driver constructor.
+ * @returns A freshly constructed (not yet started) {@link AgentDriver}.
+ * @throws {Error} When `id` is a known backend excluded from this build, or
+ *   when `id` does not match any registered driver at all.
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare function createDriver(id: string, config: AgentConfig): Promise<AgentDriver>;
+/**
+ * Returns the capability metadata for every available driver.
+ *
+ * Enumerates every built-in backend from {@link DRIVER_CATALOG} without
+ * loading a single driver module or backend SDK, then merges in any
+ * third-party drivers registered via {@link registerDriver} that are not
+ * already in the catalog. Use this to populate driver selection UIs.
+ *
+ * @returns Array of {@link DriverInfo} objects, one per available driver.
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare function listDrivers(): DriverInfo[];
+/**
+ * List models available to a specific driver without starting a full agent session.
+ *
+ * Lazily loads the driver module via {@link loadDriver}, creates a minimal
+ * driver instance (no subprocess spawned, no `start()` call), delegates to
+ * its `listModels()` method, and returns the result. API keys are forwarded
+ * so drivers can authenticate against provider REST APIs if needed. Returns
+ * `[]` when `driverId` is not registered.
+ *
+ * @param driverId - Registered driver id (e.g. `"omp"`, `"claude-sdk"`, `"codex"`).
+ * @param apiKeys - Provider API keys keyed by provider name (e.g. `{ anthropic: "sk-..." }`).
+ *   Pass `settings.apiKeys ?? {}` from forge-assistant's resolved settings.
+ * @docLink packages/bridge/api-reference#registry
+ */
+export declare function listModelsForDriver(driverId: string, apiKeys: Record<string, string>): Promise<ModelEntry[]>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../bridge/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAetF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAyBrD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAEzF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAcxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAS1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}

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

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+import type { AgentEvent, AgentReconfigureOptions, AgentRuntimeConfig, IAgentRuntime } from "@skaile/workspaces/types";
+/**
+ * Implements `IAgentRuntime` from `@skaile/workspaces/types` by wrapping an {@link AgentDriver}
+ * 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
+ * {@link createRuntime} to avoid coupling to `BridgeRuntime` directly.
+ *
+ * @docLink packages/bridge/api-reference#runtime
+ */
+export declare class BridgeRuntime implements IAgentRuntime {
+    private driver;
+    private normalizer;
+    private handlers;
+    private boundEventHandler;
+    private driverId;
+    constructor(driverId?: string);
+    start(config: AgentRuntimeConfig): Promise<void>;
+    configure(_config: AgentReconfigureOptions): Promise<void>;
+    prompt(message: string): Promise<void>;
+    reply(answer: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): Promise<void>;
+    onEvent(handler: (event: AgentEvent) => void): void;
+    offEvent(handler: (event: AgentEvent) => void): void;
+    get isRunning(): boolean;
+}
+/**
+ * Factory function to create a {@link BridgeRuntime} with the specified driver.
+ *
+ * @param driverId - Registered driver id (default: `"claude-sdk"`).
+ * @returns A new `IAgentRuntime` wrapping the selected driver with event normalization.
+ * @docLink packages/bridge/api-reference#runtime
+ */
+export declare function createRuntime(driverId?: string): IAgentRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../bridge/src/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;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,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,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"}