actoviq-agent-sdk 0.4.2 → 0.4.6

package/dist/src/parity/bridgeConfigs.js

@@ -0,0 +1,134 @@
+/**
+ * Named bridge connection configs (apiKey + baseURL presets).
+ *
+ * Persisted to ~/.actoviq/bridge-configs.json. Each config bundles a provider
+ * (now 'anthropic'|'openai' — the in-process SDK enum) plus apiKey/baseURL/model
+ * so the user can pre-configure e.g. one anthropic profile pointed at DeepSeek
+ * and another at Qwen, and switch between them by name.
+ *
+ * At activation the TUI pre-builds a ModelApi via buildRouteModelApi and injects
+ * it per-run into session.stream({model, modelApi}) — same session, no child
+ * process, context naturally survives switching bridge↔hadamard.
+ *
+ * Legacy config files stored provider as RuntimeProviderId ('claude'|'pi'|…);
+ * readBridgeConfigs auto-migrates these to 'anthropic'|'openai'.
+ * Mirrors mcpServerConfig for persistence.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/** Map a runtime id to the wire protocol (in-process provider). */
+export function runtimeToProvider(rt) {
+    switch (rt) {
+        case 'claude':
+        case 'codewhale':
+            return 'anthropic';
+        case 'reasonix':
+        case 'pi':
+        case 'codex':
+        case 'crush':
+            return 'openai';
+        default:
+            return null; // hadamard — no separate provider
+    }
+}
+const VALID_PROVIDERS = ['anthropic', 'openai'];
+// Legacy RuntimeProviderId → InProcessProvider migration (v0.6→v0.7).
+// The TUI used to spawn external CLIs keyed by these ids; now the bridge is
+// in-process and configs carry only 'anthropic'|'openai'. Best-effort mapping
+// preserves saved configs across the upgrade.
+const LEGACY_PROVIDER_MIGRATION = {
+    claude: 'anthropic',
+    codewhale: 'anthropic',
+    pi: 'openai',
+    codex: 'openai',
+    reasonix: 'openai',
+    crush: 'openai',
+};
+function migrateProvider(raw) {
+    if (VALID_PROVIDERS.includes(raw))
+        return raw;
+    return LEGACY_PROVIDER_MIGRATION[raw] ?? 'anthropic'; // fallback safe: unknown → anthropic
+}
+export function getBridgeConfigsPath(homeDir = os.homedir()) {
+    return path.join(homeDir, '.actoviq', 'bridge-configs.json');
+}
+export const VALID_RUNTIMES = ['hadamard', 'claude', 'codewhale', 'pi', 'codex', 'reasonix', 'crush'];
+function isValidRuntime(raw) {
+    return VALID_RUNTIMES.includes(raw);
+}
+function isValidConfig(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const c = value;
+    return typeof c.name === 'string' && typeof c.provider === 'string';
+}
+export function readBridgeConfigs(homeDir = os.homedir()) {
+    const file = getBridgeConfigsPath(homeDir);
+    if (!existsSync(file))
+        return { configs: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+        const configs = Array.isArray(parsed.configs)
+            ? parsed.configs.filter(isValidConfig).map((c) => {
+                const out = {
+                    name: c.name,
+                    provider: migrateProvider(c.provider),
+                    // Pre-v0.8 legacy: missing/unknown runtime defaults to 'claude'.
+                    runtime: isValidRuntime(c.runtime) ? c.runtime : 'claude',
+                };
+                if (typeof c.apiKey === 'string' && c.apiKey)
+                    out.apiKey = c.apiKey;
+                if (typeof c.baseURL === 'string' && c.baseURL)
+                    out.baseURL = c.baseURL;
+                if (typeof c.model === 'string' && c.model)
+                    out.model = c.model;
+                if (Array.isArray(c.models)) {
+                    out.models = c.models.filter((m) => typeof m === 'object' && m !== null && typeof m.name === 'string');
+                }
+                return out;
+            })
+            : [];
+        // Best-effort re-save: write the migrated configs back so the file stays
+        // current. Ignore failures (read-only fs, etc.).
+        try {
+            writeFileSync(file, JSON.stringify({ configs }, null, 2), 'utf-8');
+        }
+        catch { /* ignore */ }
+        return { configs };
+    }
+    catch {
+        return { configs: [] };
+    }
+}
+export function writeBridgeConfigs(configs, homeDir = os.homedir()) {
+    const file = getBridgeConfigsPath(homeDir);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(configs, null, 2), 'utf-8');
+}
+export function addBridgeConfig(config, homeDir = os.homedir()) {
+    const current = readBridgeConfigs(homeDir);
+    const without = current.configs.filter((c) => c.name !== config.name);
+    without.push(config);
+    const next = { configs: without };
+    writeBridgeConfigs(next, homeDir);
+    return next;
+}
+export function removeBridgeConfig(name, homeDir = os.homedir()) {
+    const current = readBridgeConfigs(homeDir);
+    const next = { configs: current.configs.filter((c) => c.name !== name) };
+    writeBridgeConfigs(next, homeDir);
+    return next;
+}
+export function findBridgeConfig(name, homeDir = os.homedir()) {
+    return readBridgeConfigs(homeDir).configs.find((c) => c.name === name);
+}
+/** Mask an API key for display: first 4 + … + last 4. */
+export function maskApiKey(key) {
+    if (!key)
+        return '(none)';
+    if (key.length <= 8)
+        return '****';
+    return `${key.slice(0, 4)}…${key.slice(-4)}`;
+}
+//# sourceMappingURL=bridgeConfigs.js.map

package/dist/src/parity/bridgeConfigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeConfigs.js","sourceRoot":"","sources":["../../../src/parity/bridgeConfigs.ts"],"names":[],"mappings":"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"}

package/dist/src/parity/bridgeEventAdapter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Bridge → Agent event adapter.
+ *
+ * Maps `ActoviqBridgeJsonEvent` (the canonical system/assistant/result trio
+ * that all directCli providers normalize into) to the `AgentEvent` union that
+ * the GUI's `forwardAgentEvent` already switches on. This is the inverse of
+ * `cleanEventToBridgeEvents` in actoviqCleanBridgeCompatSdk.ts.
+ */
+import type { ActoviqBridgeJsonEvent, ActoviqBridgeRunResult, AgentEvent, AgentRunResult } from '../types.js';
+export declare function bridgeEventToAgentEvents(event: ActoviqBridgeJsonEvent, _sessionId: string, runId: string, model: string): AgentEvent[];
+export interface BridgeAgentRunStream {
+    [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
+    result: Promise<AgentRunResult>;
+}
+/**
+ * Wrap an `ActoviqBridgeRunStream` into an async iterable of `AgentEvent`
+ * + a `.result` promise, so the GUI run loop can branch ONLY the stream source.
+ */
+export declare function adaptBridgeRun(bridgeStream: AsyncIterable<ActoviqBridgeJsonEvent>, bridgeResult: Promise<ActoviqBridgeRunResult>, runId: string, model: string): BridgeAgentRunStream;
+//# sourceMappingURL=bridgeEventAdapter.d.ts.map

package/dist/src/parity/bridgeEventAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeEventAdapter.d.ts","sourceRoot":"","sources":["../../../src/parity/bridgeEventAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9G,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAwEd;AAID,MAAM,WAAW,oBAAoB;IACnC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,aAAa,CAAC,sBAAsB,CAAC,EACnD,YAAY,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC7C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAiDtB"}

package/dist/src/parity/bridgeEventAdapter.js

@@ -0,0 +1,121 @@
+/**
+ * Bridge → Agent event adapter.
+ *
+ * Maps `ActoviqBridgeJsonEvent` (the canonical system/assistant/result trio
+ * that all directCli providers normalize into) to the `AgentEvent` union that
+ * the GUI's `forwardAgentEvent` already switches on. This is the inverse of
+ * `cleanEventToBridgeEvents` in actoviqCleanBridgeCompatSdk.ts.
+ */
+// ---------- per-event adaptation ----------
+export function bridgeEventToAgentEvents(event, _sessionId, runId, model) {
+    const events = [];
+    if (event.type === 'system' && event.subtype === 'init') {
+        events.push({
+            type: 'run.started',
+            runId,
+            sessionId: String(event.session_id ?? ''),
+            model: typeof event.model === 'string' ? event.model : model,
+            timestamp: new Date().toISOString(),
+            input: '',
+        });
+    }
+    if (event.type === 'stream_event' && typeof event.event === 'object' && event.event !== null) {
+        const inner = event.event;
+        if (inner.type === 'content_block_delta' &&
+            typeof inner.delta === 'object' &&
+            inner.delta !== null &&
+            inner.delta.type === 'text_delta') {
+            events.push({
+                type: 'response.text.delta',
+                delta: String(inner.delta.text ?? ''),
+                snapshot: String(inner.delta.text ?? ''),
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    if (event.type === 'assistant') {
+        const msg = event.message;
+        if (msg?.content && Array.isArray(msg.content)) {
+            for (const block of msg.content) {
+                if (typeof block === 'object' && block !== null) {
+                    const b = block;
+                    if (b.type === 'tool_use') {
+                        events.push({
+                            type: 'tool.call',
+                            call: {
+                                id: String(b.id ?? ''),
+                                name: String(b.name ?? ''),
+                                input: (b.input ?? {}),
+                            },
+                            publicName: String(b.name ?? ''),
+                            provider: 'bridge',
+                            runId,
+                            iteration: 0,
+                            timestamp: new Date().toISOString(),
+                        });
+                    }
+                }
+            }
+        }
+    }
+    if (event.type === 'user') {
+        const tr = event.tool_result;
+        if (tr && typeof tr === 'object') {
+            events.push({
+                type: 'tool.result',
+                result: {
+                    id: String(tr.tool_use_id ?? ''),
+                    output: tr,
+                },
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    return events;
+}
+/**
+ * Wrap an `ActoviqBridgeRunStream` into an async iterable of `AgentEvent`
+ * + a `.result` promise, so the GUI run loop can branch ONLY the stream source.
+ */
+export function adaptBridgeRun(bridgeStream, bridgeResult, runId, model) {
+    let finalResult;
+    const resultPromise = bridgeResult.then((r) => {
+        finalResult = {
+            sessionId: r.sessionId,
+            text: r.text,
+            model,
+            runId,
+            startedAt: r.initEvent?.['timestamp'] ?? new Date().toISOString(),
+            completedAt: new Date().toISOString(),
+            requests: [],
+            messages: [],
+            toolCalls: [],
+            message: {
+                id: `bridge-${runId}`,
+                role: 'assistant',
+                type: 'message',
+                model,
+                stop_reason: 'end_turn',
+                content: [{ type: 'text', text: r.text }],
+            },
+            stopReason: r.stopReason ?? 'end_turn',
+        };
+        if (r.isError) {
+            return Promise.reject(new Error(r.text || 'Bridge run failed'));
+        }
+        return finalResult;
+    }, (err) => Promise.reject(err));
+    const iterator = (async function* () {
+        for await (const event of bridgeStream) {
+            const agentEvents = bridgeEventToAgentEvents(event, '', runId, model);
+            for (const ae of agentEvents)
+                yield ae;
+        }
+        await resultPromise.catch(() => undefined);
+    })();
+    return {
+        [Symbol.asyncIterator]: () => iterator,
+        result: resultPromise,
+    };
+}
+//# sourceMappingURL=bridgeEventAdapter.js.map

package/dist/src/parity/bridgeEventAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeEventAdapter.js","sourceRoot":"","sources":["../../../src/parity/bridgeEventAdapter.ts"],"names":[],"mappings":"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"}

package/dist/src/parity/bridgeExecResolver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Executable resolution primitives shared by the bridge SDK and its provider
+ * layer. Kept in a leaf module so `bridgeProviders.ts` can resolve a provider
+ * binary on PATH without importing the full `actoviqBridgeSdk.ts` (which would
+ * create a circular import).
+ */
+declare const IS_WINDOWS: boolean;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function isExecutable(filePath: string): Promise<boolean>;
+export declare function splitPathEnv(pathValue: string | undefined): string[];
+export declare function findExecutableOnPath(name: string): Promise<string | undefined>;
+export declare function findFirstExistingPath(candidates: string[]): Promise<string | undefined>;
+/**
+ * Quote a single argument for `cmd.exe` when `spawn(..., { shell: true })` is
+ * used (required for `.cmd`/`.bat` shims on Windows). Node's `shell: true`
+ * joins args with spaces and passes them to `cmd /c` UNquoted, so an arg
+ * containing a space — e.g. the prompt passed to `claude -p "<prompt>"` —
+ * gets split by cmd.exe into multiple tokens ("My favorite number…" → "My").
+ * This wraps space-containing args in double quotes and escapes internal
+ * quotes/backslashes per the cmd.exe command-line parsing rules.
+ *
+ * Only meaningful when spawning through a shell; argv-mode spawns pass each
+ * arg verbatim and must NOT be pre-quoted.
+ */
+export declare function quoteForWindowsShell(arg: string): string;
+export { IS_WINDOWS };
+//# sourceMappingURL=bridgeExecResolver.d.ts.map

package/dist/src/parity/bridgeExecResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeExecResolver.d.ts","sourceRoot":"","sources":["../../../src/parity/bridgeExecResolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,QAAA,MAAM,UAAU,SAA+B,CAAC;AAEhD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAKpE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyBpF;AAED,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7F;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASxD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/parity/bridgeExecResolver.js

@@ -0,0 +1,95 @@
+/**
+ * Executable resolution primitives shared by the bridge SDK and its provider
+ * layer. Kept in a leaf module so `bridgeProviders.ts` can resolve a provider
+ * binary on PATH without importing the full `actoviqBridgeSdk.ts` (which would
+ * create a circular import).
+ */
+import { constants as fsConstants } from 'node:fs';
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+const IS_WINDOWS = process.platform === 'win32';
+export async function pathExists(filePath) {
+    try {
+        await access(filePath, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function isExecutable(filePath) {
+    try {
+        await access(filePath, IS_WINDOWS ? fsConstants.F_OK : fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function splitPathEnv(pathValue) {
+    if (!pathValue) {
+        return [];
+    }
+    return pathValue.split(path.delimiter).filter(Boolean);
+}
+export async function findExecutableOnPath(name) {
+    const pathDirectories = splitPathEnv(process.env.PATH);
+    const extensions = IS_WINDOWS
+        ? (process.env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD')
+            .split(';')
+            .filter(Boolean)
+        : [''];
+    for (const directory of pathDirectories) {
+        const directCandidate = path.join(directory, name);
+        if (!IS_WINDOWS && (await isExecutable(directCandidate))) {
+            return directCandidate;
+        }
+        for (const extension of extensions) {
+            const candidate = directCandidate.endsWith(extension.toLowerCase())
+                ? directCandidate
+                : `${directCandidate}${extension.toLowerCase()}`;
+            if (await isExecutable(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return undefined;
+}
+export async function findFirstExistingPath(candidates) {
+    for (const candidate of candidates) {
+        if (!candidate) {
+            continue;
+        }
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+const WINDOWS_SHELL_SAFE = /^[A-Za-z0-9@_+=:,./-]+$/;
+/**
+ * Quote a single argument for `cmd.exe` when `spawn(..., { shell: true })` is
+ * used (required for `.cmd`/`.bat` shims on Windows). Node's `shell: true`
+ * joins args with spaces and passes them to `cmd /c` UNquoted, so an arg
+ * containing a space — e.g. the prompt passed to `claude -p "<prompt>"` —
+ * gets split by cmd.exe into multiple tokens ("My favorite number…" → "My").
+ * This wraps space-containing args in double quotes and escapes internal
+ * quotes/backslashes per the cmd.exe command-line parsing rules.
+ *
+ * Only meaningful when spawning through a shell; argv-mode spawns pass each
+ * arg verbatim and must NOT be pre-quoted.
+ */
+export function quoteForWindowsShell(arg) {
+    if (arg === '')
+        return '""';
+    if (WINDOWS_SHELL_SAFE.test(arg))
+        return arg;
+    // Double backslashes that precede a quote, escape the quote, then double
+    // any trailing backslashes (so they don't escape the closing quote).
+    const escaped = arg
+        .replace(/(\\*)"/g, (_m, bs) => bs + bs + '\\"')
+        .replace(/(\\*)$/, (_m, bs) => bs + bs);
+    return `"${escaped}"`;
+}
+export { IS_WINDOWS };
+//# sourceMappingURL=bridgeExecResolver.js.map

package/dist/src/parity/bridgeExecResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeExecResolver.js","sourceRoot":"","sources":["../../../src/parity/bridgeExecResolver.ts"],"names":[],"mappings":"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"}

package/dist/src/parity/bridgeProviders.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Multi-provider abstraction for the bridge SDK's directCli mode.
+ *
+ * The vendored-bundle path and the original Claude Code `-p` stream-json path
+ * are both the `claude` provider. `pi` and `codex` reuse the same spawn +
+ * line-by-line JSONL pipeline but speak their own wire protocols, so each
+ * provider supplies four pieces the rest of `actoviqBridgeSdk.ts` stays
+ * protocol-agnostic around:
+ *
+ *   1. executable resolution (which binary on PATH, default error message)
+ *   2. argv construction (the provider's CLI flags + prompt placement)
+ *   3. child-process env injection (provider-specific credential variables)
+ *   4. event normalization (provider JSONL → the `system/assistant/result`
+ *      trio `execute()` already switches on — plus claude content-block shape)
+ *
+ * Normalization is stateful (pi's session id arrives once in a header line;
+ * codex's model is never in the stream; assistant text accumulates across
+ * deltas), so each provider hands back a fresh normalizer per run.
+ */
+import type { ActoviqBridgeJsonEvent, ActoviqBridgeRunOptions, BridgeProviderDetection, RuntimeProviderId } from '../types.js';
+/**
+ * Per-run state + the translate step. `translate(rawLine)` returns the
+ * normalized event to forward, or `null` to drop the line (e.g. a provider
+ * status event with no bridge equivalent). Multiple native events may map to
+ * a single normalized event; one native event may also emit several.
+ */
+export interface BridgeEventNormalizer {
+    /**
+     * Translate one parsed JSON line (stream-json/JSONL providers) into
+     * normalized events. Return `[]` to drop the line.
+     */
+    translate(raw: Record<string, unknown>): ActoviqBridgeJsonEvent[];
+    /**
+     * When true, the provider emits plain text (not JSONL). `translate()` is
+     * called with each raw text line as `{_raw: line}`, and `flush()` is
+     * called once when stdout ends.
+     */
+    rawText?: true;
+    /** Flush accumulated state at end-of-stream (raw-text providers only). */
+    flush?(): ActoviqBridgeJsonEvent[];
+}
+export interface RuntimeProvider {
+    readonly id: RuntimeProviderId;
+    /** Binary name looked up on PATH when `executable` is not provided. */
+    readonly pathBinary: string;
+    /** Human-readable name for "not found on PATH" errors. */
+    readonly displayName: string;
+    resolveExecutable(explicitPath?: string): Promise<string>;
+    /**
+     * Best-effort `<binary> --version` probe. Returns the version string on
+     * success, or `undefined` if the binary cannot be probed (missing, exits
+     * non-zero, hangs, etc.). Used by `detectBridgeProviders()` only — never on
+     * the run path.
+     */
+    probeVersion(executablePath: string): Promise<string | undefined>;
+    buildArgs(prompt: string, options: ActoviqBridgeRunOptions): string[];
+    /**
+     * Build the child env. `settingsEnv` is the `~/.actoviq/settings.json` env
+     * block; `baseEnv` is the inherited process env already filtered to
+     * string values. Providers emit whatever credential variables their CLI
+     * reads (claude: ANTHROPIC_*, pi/codex: their own).
+     */
+    buildChildEnv(baseEnv: Record<string, string>, settingsEnv: Record<string, string>, overrides?: Record<string, string>): Record<string, string>;
+    /** A fresh normalizer for one run. */
+    createNormalizer(): BridgeEventNormalizer;
+    /** Recommended model IDs for this provider (used by TUI `/bridge model`). */
+    suggestedModels(): string[];
+}
+/** Shared base for executable resolution (PATH lookup + explicit-path check). */
+export declare abstract class BaseRuntimeProvider implements RuntimeProvider {
+    abstract readonly id: RuntimeProviderId;
+    abstract readonly pathBinary: string;
+    abstract readonly displayName: string;
+    /**
+     * Resolve the executable for a run. Precedence (all in-memory; mirrors
+     * `buildChildEnvironment` in actoviqBridgeSdk.ts — no file I/O here):
+     *   1. `explicitPath` arg (caller-supplied `{ executable }`)
+     *   2. `ACTOVIQ_<ID>_PATH` env var (top-level or `env:` block — both are
+     *      captured by `extractEnv` in loadJsonConfigFile.ts)
+     *   3. `raw.bridge.providers[id].path` from the loaded settings store
+     *   4. `findExecutableOnPath(this.pathBinary)` — the binary on PATH
+     *
+     * Mirrors the `ACTOVIQ_BASH_PATH` precedent in src/tools/bash/BashTool.ts.
+     */
+    resolveExecutable(explicitPath?: string): Promise<string>;
+    probeVersion(executablePath: string): Promise<string | undefined>;
+    abstract buildArgs(prompt: string, options: ActoviqBridgeRunOptions): string[];
+    abstract buildChildEnv(baseEnv: Record<string, string>, settingsEnv: Record<string, string>, overrides?: Record<string, string>): Record<string, string>;
+    abstract createNormalizer(): BridgeEventNormalizer;
+    abstract suggestedModels(): string[];
+}
+/**
+ * Build a single normalized event with common optional fields pre-stamped.
+ * Normalizers route every native event through this so the downstream
+ * `execute()` switch (system/assistant/result) and `runtimeInfoFromInitEvent`
+ * keep working untouched.
+ */
+export declare function bridgeEvent(type: string, fields?: Record<string, unknown>): ActoviqBridgeJsonEvent;
+/**
+ * The configured default provider, read from `bridge.defaultProvider` in the
+ * loaded settings store. Falls back to `'claude'`. Explicit
+ * `directCliProvider` (passed to `resolveProvider`) always wins over this.
+ */
+export declare function getDefaultProviderId(): RuntimeProviderId;
+export declare function resolveProvider(id?: RuntimeProviderId): RuntimeProvider;
+/**
+ * Probe the locally installed agent CLIs. Resolves each provider via the
+ * env/settings/PATH chain (so env overrides are honored) and best-effort
+ * `--version`. Never throws — a missing provider is reported as
+ * `available: false` with `path: undefined`.
+ */
+export declare function detectBridgeProviders(): Promise<BridgeProviderDetection[]>;
+/** Package-private seam for tests that need the ambient provider. */
+export declare function _setCurrentProvider(provider: RuntimeProvider | undefined): void;
+export declare function _getCurrentProvider(): RuntimeProvider | undefined;
+export declare const claudeProvider: RuntimeProvider;
+export declare const piProvider: RuntimeProvider;
+export declare const codexProvider: RuntimeProvider;
+export declare const codewhaleProvider: RuntimeProvider;
+export declare const reasonixProvider: RuntimeProvider;
+export declare const crushProvider: RuntimeProvider;
+export declare const BRIDGE_PROVIDERS: Record<RuntimeProviderId, RuntimeProvider>;
+/**
+ * Best-effort credential env-var names each provider's CLI reads. The TUI
+ * treats "any one of these set" (across the settings env block ∪ process.env)
+ * as "credentials likely configured". Empty arrays mean the provider's
+ * credential var is not known from its public surface (codewhale/crush are
+ * multi-backend); the UI shows an honest "(unknown)" rather than a wrong key.
+ * This is advisory display data only — it never gates a run.
+ */
+export declare const BRIDGE_PROVIDER_CREDENTIALS: Record<RuntimeProviderId, string[]>;
+//# sourceMappingURL=bridgeProviders.d.ts.map

package/dist/src/parity/bridgeProviders.d.ts.map

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