actoviq-agent-sdk 0.4.2 → 0.4.5

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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"}