@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.1

package/dist/providers/provider-registry.js

@@ -1,74 +1,105 @@
 import { createLogger } from "@nodetool-ai/config";
+// Stryker disable next-line StringLiteral: logger name is diagnostic, not a behavioural contract.
 const log = createLogger("nodetool.runtime.provider-registry");
-let _secretResolver = null;
 const _PROVIDER_REGISTRY = new Map();
-// Cache keyed by "providerId:userId" for per-user provider instances
-const _providerCache = new Map();
-export function registerProvider(providerId, cls, kwargs = {}) {
-    _PROVIDER_REGISTRY.set(providerId, { cls, kwargs });
+export function registerProvider(providerId, cls, kwargs = {}, optionalKwargs = {}, metadata = {}) {
+    _PROVIDER_REGISTRY.set(providerId, {
+        cls,
+        kwargs,
+        optionalKwargs,
+        metadata: {
+            access: metadata.access ?? "remote_api",
+            displayName: metadata.displayName ?? providerId
+        }
+    });
 }
 export function getRegisteredProvider(providerId) {
     return _PROVIDER_REGISTRY.get(providerId) ?? null;
 }
+export function listRegisteredProviderIds() {
+    return Array.from(_PROVIDER_REGISTRY.keys());
+}
+/** Remove a provider from the registry. Returns true if one was removed. */
+export function unregisterProvider(providerId) {
+    return _PROVIDER_REGISTRY.delete(providerId);
+}
 /**
- * Set a secret resolver so that providers can resolve API keys from
- * sources beyond process.env (e.g. encrypted secrets DB).
+ * Environment variable names accepted in place of a credential key, in order.
  *
- * The resolver receives (secretKey, userId) so secrets are resolved per-user.
+ * A provider's own SDK often reads a different name than NodeTool's registered
+ * key, so a machine set up for that SDK looks unconfigured here and the run
+ * fails with a 401 that names the wrong thing. Only names the vendor itself
+ * documents belong in this list — it is an interop shim, not a guessing game.
  */
-export function setSecretResolver(resolver) {
-    _secretResolver = resolver;
-    // Clear cache so providers are re-created with resolved secrets
-    _providerCache.clear();
-}
-export async function getProvider(providerId, userId = "1") {
-    const cacheKey = `${providerId}:${userId}`;
-    const cached = _providerCache.get(cacheKey);
-    if (cached) {
-        return cached;
+const CREDENTIAL_ENV_ALIASES = {
+    // fal's own JS and Python clients read FAL_KEY.
+    FAL_API_KEY: ["FAL_KEY"]
+};
+/** `process.env[key]`, falling back to the names that vendor's SDK uses. */
+export function readCredentialEnv(key) {
+    const direct = process.env[key];
+    if (direct)
+        return direct;
+    for (const alias of CREDENTIAL_ENV_ALIASES[key] ?? []) {
+        const value = process.env[alias];
+        if (value)
+            return value;
     }
+    return undefined;
+}
+/** Resolve one credential exactly as provider construction does. */
+export async function resolveCredentialValue(key, getSecret) {
+    const stored = await getSecret(key);
+    return stored || readCredentialEnv(key);
+}
+/**
+ * Build a fresh provider instance, resolving any unset credential kwargs via
+ * `getSecret` first, then `process.env` as fallback. The caller owns any
+ * caching — instance reuse is a property of a ProcessingContext, not a module
+ * global.
+ */
+export async function getProvider(providerId, getSecret) {
     const registration = _PROVIDER_REGISTRY.get(providerId);
     if (!registration) {
         throw new Error(`No provider registered for "${providerId}"`);
     }
-    // Re-resolve any unset values via secret resolver (DB → env) or direct env
-    // var lookup as final fallback. Only treat empty string / null / undefined
-    // as "needs resolution" so that valid falsy defaults (`0`, `false`) on
-    // numeric/boolean kwargs are preserved.
+    // A kwarg is "needs resolution" when the registration declares the key with
+    // an empty-string / null / undefined value. Valid falsy defaults like `0`
+    // or `false` on numeric/boolean kwargs are preserved.
     const kwargs = { ...registration.kwargs };
     for (const [key, value] of Object.entries(kwargs)) {
         if (value === "" || value == null) {
-            if (_secretResolver) {
-                const resolved = await _secretResolver(key, userId);
-                if (resolved) {
-                    kwargs[key] = resolved;
-                    continue;
-                }
-            }
-            const envVal = process.env[key];
-            if (envVal) {
-                kwargs[key] = envVal;
+            const resolved = await resolveCredentialValue(key, getSecret);
+            if (resolved) {
+                kwargs[key] = resolved;
             }
         }
     }
-    const instance = new registration.cls(kwargs);
-    _providerCache.set(cacheKey, instance);
-    return instance;
-}
-export function clearProviderCache() {
-    const size = _providerCache.size;
-    _providerCache.clear();
-    return size;
-}
-export function listRegisteredProviderIds() {
-    return Array.from(_PROVIDER_REGISTRY.keys());
+    // Optional kwargs: resolve from secret store / env when available, else use
+    // the registered default. These are not required for the provider to be
+    // "configured" (see isProviderConfigured) but still flow into the
+    // constructor so user-set values (e.g. LMSTUDIO_API_URL) take effect on
+    // every getProvider() call without a restart.
+    for (const [key, fallback] of Object.entries(registration.optionalKwargs)) {
+        const fromSecret = await getSecret(key);
+        if (fromSecret) {
+            kwargs[key] = fromSecret;
+            continue;
+        }
+        const envVal = process.env[key];
+        if (envVal) {
+            kwargs[key] = envVal;
+            continue;
+        }
+        kwargs[key] = fallback;
+    }
+    return new registration.cls(kwargs);
 }
 /** Get the secret key name required by a provider (e.g. "OPENAI_API_KEY"), or null. */
 export function getProviderSecretKey(providerId) {
     const reg = _PROVIDER_REGISTRY.get(providerId);
     if (!reg)
         return null;
-    // The kwargs keys are the secret names; find the first one that looks like a key/token
     for (const key of Object.keys(reg.kwargs)) {
         if (key.includes("KEY") ||
             key.includes("TOKEN") ||
@@ -76,45 +107,31 @@ export function getProviderSecretKey(providerId) {
             return key;
         }
     }
-    // No secret — provider is local (ollama, llama_cpp, etc.)
     return null;
 }
-/** Check if a provider has credentials available for a given user (DB, env, or is local). */
-export async function isProviderConfigured(providerId, userId = "1") {
+/** Check if a provider's required credentials are resolvable. */
+export async function isProviderConfigured(providerId, getSecret) {
     const reg = _PROVIDER_REGISTRY.get(providerId);
     if (!reg) {
+        // Stryker disable next-line StringLiteral,ObjectLiteral: diagnostic log, not asserted.
         log.debug("isProviderConfigured: not registered", { providerId });
         return false;
     }
-    // A kwarg is "required at runtime" when the registration declares the key
-    // with an empty-string / null / undefined value — registerProvider() uses
-    // empty strings to mark credentials that must be resolved from the DB or
-    // environment. Non-empty registration values (including valid falsy
-    // defaults like `0` or `false`) are defaults the constructor can use
-    // directly. Keys starting with "_" are runtime injections (e.g.
-    // `_bridge`, `_id` for Python providers) and excluded from the
-    // required-credentials check since they can't be resolved via secret
-    // resolver or env vars.
+    // Keys starting with "_" are runtime injections (e.g. `_bridge`, `_id` for
+    // Python providers) and excluded from the credentials check.
     const required = Object.entries(reg.kwargs)
         .filter(([key, value]) => (value === "" || value == null) && !key.startsWith("_"))
         .map(([key]) => key);
-    if (required.length === 0) {
-        log.debug("isProviderConfigured: no required kwargs", { providerId });
+    // Stryker disable next-line ConditionalExpression: forcing this false just falls into the empty loop below, which also returns true — equivalent.
+    if (required.length === 0)
         return true;
-    }
     for (const key of required) {
-        let value = null;
-        if (_secretResolver) {
-            value = await _secretResolver(key, userId);
-        }
-        if (!value)
-            value = process.env[key];
+        const value = await resolveCredentialValue(key, getSecret);
         if (!value) {
+            // Stryker disable next-line StringLiteral,ObjectLiteral: diagnostic log, not asserted.
             log.debug("isProviderConfigured: missing credential", {
                 providerId,
-                userId,
-                key,
-                hasResolver: Boolean(_secretResolver)
+                key
             });
             return false;
         }

package/dist/providers/provider-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/providers/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,GAAG,GAAG,YAAY,CAAC,oCAAoC,CAAC,CAAC;AAW/D,IAAI,eAAe,GAA0B,IAAI,CAAC;AAElD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAgC,CAAC;AACnE,qEAAqE;AACrE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,GAAyC,EACzC,SAAkC,EAAE;IAEpC,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAkB;IAElB,OAAO,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,eAAe,GAAG,QAAQ,CAAC;IAC3B,gEAAgE;IAChE,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,MAAM,GAAG,GAAG;IAEZ,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,uEAAuE;IACvE,wCAAwC;IACxC,MAAM,MAAM,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClC,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBACpD,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;oBACvB,SAAS;gBACX,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IACjC,cAAc,CAAC,KAAK,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,uFAAuF;IACvF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IACE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YACnB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACtB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,0DAA0D;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,MAAM,GAAG,GAAG;IAEZ,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,gEAAgE;IAChE,+DAA+D;IAC/D,qEAAqE;IACrE,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;SACxC,MAAM,CACL,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAC1D;SACA,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAEvB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,KAAK,GAA8B,IAAI,CAAC;QAC5C,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE;gBACpD,UAAU;gBACV,MAAM;gBACN,GAAG;gBACH,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC;aACtC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/providers/provider-registry.ts"],"names":[],"mappings":"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"}

package/dist/providers/provider-request-log.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Central failure logging for provider calls.
+ *
+ * When an LLM provider call fails (e.g. a 422 Unprocessable Entity), we want a
+ * precise record of what was sent — the actual wire payload, not just the
+ * opaque error. {@link logProviderRequestFailure} is invoked from
+ * `BaseProvider`'s traced wrappers so every provider gets identical, redacted,
+ * size-bounded failure logging from one place.
+ *
+ * Providers feed their exact request body via `recordRequestPayload` (see
+ * `BaseProvider`); when a provider hasn't been instrumented, the wrapper falls
+ * back to logging the NodeTool-level request args.
+ */
+import { type Logger } from "@nodetool-ai/config";
+interface SanitizeOptions {
+    /** Strings longer than this are truncated (default 1000). */
+    maxStringLength?: number;
+    /** Arrays longer than this are truncated (default 200). */
+    maxArrayLength?: number;
+    /** Recursion is cut off at this depth (default 12). */
+    maxDepth?: number;
+}
+/**
+ * Deep-clone `value` into a JSON-safe, log-friendly shape: long strings and
+ * arrays are truncated, binary buffers become size markers, secret-bearing
+ * keys are redacted, and circular references are broken. Never throws.
+ */
+/**
+ * A JSON-safe value: what {@link sanitizeForLog} produces. `undefined` is kept
+ * rather than rewritten, so a log line still shows a field that was unset.
+ */
+export type LogSafeValue = string | number | boolean | null | undefined | LogSafeValue[] | {
+    [key: string]: LogSafeValue;
+};
+export declare function sanitizeForLog(value: unknown, opts?: SanitizeOptions): LogSafeValue;
+interface ProviderFailureLog {
+    provider: string;
+    model: string;
+    /** The exact wire payload the provider sent, if it was recorded. */
+    request?: unknown;
+    /** NodeTool-level request args, logged when no wire payload was recorded. */
+    nodetoolArgs?: unknown;
+    error: unknown;
+}
+/**
+ * Log precisely what was sent to a provider when its call fails. Prefers the
+ * recorded wire payload; falls back to the NodeTool-level args. Aborted
+ * requests are skipped. The `logger` arg is for testing — production calls use
+ * the module logger.
+ */
+export declare function logProviderRequestFailure(params: ProviderFailureLog, logger?: Logger): void;
+export {};
+//# sourceMappingURL=provider-request-log.d.ts.map

package/dist/providers/provider-request-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-request-log.d.ts","sourceRoot":"","sources":["../../src/providers/provider-request-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAKhE,UAAU,eAAe;IACvB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6CD;;;;GAIG;AACH;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,eAAoB,GACzB,YAAY,CAiDd;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAuBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,MAAY,GACnB,IAAI,CAeN"}

package/dist/providers/provider-request-log.js

@@ -0,0 +1,157 @@
+/**
+ * Central failure logging for provider calls.
+ *
+ * When an LLM provider call fails (e.g. a 422 Unprocessable Entity), we want a
+ * precise record of what was sent — the actual wire payload, not just the
+ * opaque error. {@link logProviderRequestFailure} is invoked from
+ * `BaseProvider`'s traced wrappers so every provider gets identical, redacted,
+ * size-bounded failure logging from one place.
+ *
+ * Providers feed their exact request body via `recordRequestPayload` (see
+ * `BaseProvider`); when a provider hasn't been instrumented, the wrapper falls
+ * back to logging the NodeTool-level request args.
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { isNumber, isObjectLike, isString } from "@nodetool-ai/protocol";
+const log = createLogger("nodetool.runtime.provider.request");
+const SANITIZE_DEFAULTS = {
+    maxStringLength: 1000,
+    maxArrayLength: 200,
+    maxDepth: 12
+};
+/**
+ * A key holds a secret when its normalized form (lowercased, separators
+ * stripped) contains a secret marker or exactly names a credential field.
+ * Deliberately conservative so diagnostic fields like `max_tokens` (→
+ * "maxtokens") are never mistaken for the credential field `token`.
+ */
+function isSecretKey(key) {
+    const k = key.toLowerCase().replace(/[-_\s]/g, "");
+    if (k.includes("apikey") ||
+        k.includes("secret") ||
+        k.includes("password") ||
+        k.includes("passwd") ||
+        k.includes("authorization")) {
+        return true;
+    }
+    return SECRET_EXACT.has(k);
+}
+const SECRET_EXACT = new Set([
+    "token",
+    "auth",
+    "bearer",
+    "accesstoken",
+    "refreshtoken",
+    "sessiontoken",
+    "idtoken",
+    "privatekey",
+    "credentials"
+]);
+function truncateString(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max)}… [truncated ${s.length} chars total]`;
+}
+export function sanitizeForLog(value, opts = {}) {
+    const o = { ...SANITIZE_DEFAULTS, ...opts };
+    // Tracks the current DFS path (not all visited nodes) so shared-but-acyclic
+    // references aren't falsely flagged as circular.
+    const ancestors = new WeakSet();
+    function walk(v, depth) {
+        if (v === null || v === undefined)
+            return v;
+        const t = typeof v;
+        if (t === "string")
+            return truncateString(v, o.maxStringLength);
+        // SAFETY: `t` is `typeof v`, so this arm has proved v is a number/boolean.
+        if (t === "number" || t === "boolean")
+            return v;
+        if (t === "bigint")
+            return `${v.toString()}n`;
+        if (t === "function") {
+            return `[function ${v.name || "anonymous"}]`;
+        }
+        if (t === "symbol")
+            return v.toString();
+        if (v instanceof ArrayBuffer)
+            return `[binary ${v.byteLength} bytes]`;
+        if (ArrayBuffer.isView(v)) {
+            return `[binary ${v.byteLength} bytes]`;
+        }
+        if (t === "object") {
+            const obj = v;
+            if (ancestors.has(obj))
+                return "[circular]";
+            if (depth >= o.maxDepth)
+                return "[max depth exceeded]";
+            ancestors.add(obj);
+            try {
+                if (Array.isArray(v)) {
+                    const out = v
+                        .slice(0, o.maxArrayLength)
+                        .map((item) => walk(item, depth + 1));
+                    if (v.length > o.maxArrayLength) {
+                        out.push(`[${v.length - o.maxArrayLength} more items truncated]`);
+                    }
+                    return out;
+                }
+                const out = {};
+                for (const [k, val] of Object.entries(v)) {
+                    out[k] = isSecretKey(k) ? "[redacted]" : walk(val, depth + 1);
+                }
+                return out;
+            }
+            finally {
+                ancestors.delete(obj);
+            }
+        }
+        return String(v);
+    }
+    return walk(value, 0);
+}
+/** Caller cancellations (AbortSignal) are not provider failures — skip them. */
+function isAbortError(error) {
+    if (!isObjectLike(error))
+        return false;
+    const name = error.name;
+    if (isString(name) && /abort/i.test(name))
+        return true;
+    const code = error.code;
+    return code === 20 || code === "ABORT_ERR";
+}
+function httpStatus(error) {
+    if (!isObjectLike(error))
+        return undefined;
+    const e = error;
+    if (isNumber(e.status))
+        return e.status;
+    if (isNumber(e.statusCode))
+        return e.statusCode;
+    return undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Log precisely what was sent to a provider when its call fails. Prefers the
+ * recorded wire payload; falls back to the NodeTool-level args. Aborted
+ * requests are skipped. The `logger` arg is for testing — production calls use
+ * the module logger.
+ */
+export function logProviderRequestFailure(params, logger = log) {
+    if (isAbortError(params.error))
+        return;
+    const hasWire = params.request !== undefined && params.request !== null;
+    const entry = {
+        provider: params.provider,
+        model: params.model,
+        requestSource: hasWire ? "wire" : "nodetool-args",
+        error: errorMessage(params.error),
+        request: sanitizeForLog(hasWire ? params.request : params.nodetoolArgs)
+    };
+    const status = httpStatus(params.error);
+    if (status !== undefined)
+        entry.status = status;
+    logger.error("Provider request failed", entry);
+}
+//# sourceMappingURL=provider-request-log.js.map

package/dist/providers/provider-request-log.js.map

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

package/dist/providers/provider-session.d.ts

@@ -0,0 +1,3 @@
+/** Stable, dependency-free 32-bit hash (FNV-1a) of a provider system prompt. */
+export declare function hashSystemPrompt(prompt: string): string;
+//# sourceMappingURL=provider-session.d.ts.map

package/dist/providers/provider-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-session.d.ts","sourceRoot":"","sources":["../../src/providers/provider-session.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/dist/providers/provider-session.js

@@ -0,0 +1,10 @@
+/** Stable, dependency-free 32-bit hash (FNV-1a) of a provider system prompt. */
+export function hashSystemPrompt(prompt) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < prompt.length; i++) {
+        h ^= prompt.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16);
+}
+//# sourceMappingURL=provider-session.js.map

package/dist/providers/provider-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-session.js","sourceRoot":"","sources":["../../src/providers/provider-session.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/providers/provider-transport.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The transport surface node packages share with their runtime provider.
+ *
+ * Reached from a node package as `@nodetool-ai/runtime/provider-transport` — a
+ * leaf entry point, so importing the retry rules does not drag in the whole
+ * runtime.
+ */
+export * from "./http-transport.js";
+export * from "./image-ref.js";
+export * from "./atlascloud-transport.js";
+//# sourceMappingURL=provider-transport.d.ts.map

package/dist/providers/provider-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-transport.d.ts","sourceRoot":"","sources":["../../src/providers/provider-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC"}

package/dist/providers/provider-transport.js

@@ -0,0 +1,11 @@
+/**
+ * The transport surface node packages share with their runtime provider.
+ *
+ * Reached from a node package as `@nodetool-ai/runtime/provider-transport` — a
+ * leaf entry point, so importing the retry rules does not drag in the whole
+ * runtime.
+ */
+export * from "./http-transport.js";
+export * from "./image-ref.js";
+export * from "./atlascloud-transport.js";
+//# sourceMappingURL=provider-transport.js.map

package/dist/providers/provider-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-transport.js","sourceRoot":"","sources":["../../src/providers/provider-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC"}

package/dist/providers/python-provider.d.ts

@@ -6,17 +6,24 @@
  * and proxies all BaseProvider methods through the bridge.
  */
 import { BaseProvider } from "./base-provider.js";
-import type { LanguageModel, ImageModel, TTSModel, ASRModel, EmbeddingModel, VideoModel, Message, ProviderTool, ProviderStreamItem, StreamingAudioChunk, TextToImageParams, ImageToImageParams } from "./types.js";
-import type { PythonStdioBridge } from "../python-stdio-bridge.js";
+import type { LanguageModel, ImageModel, TTSModel, ASRModel, EmbeddingModel, VideoModel, MusicModel, Message, ProviderTool, ProviderStreamItem, StreamingAudioChunk, TextToImageParams, ImageToImageParams, TextToSpeechParams, TextToVideoParams, ImageToVideoParams, ReferenceToVideoInputs, ReferenceToVideoParams, TextToMusicParams, EncodedAudioResult } from "./types.js";
+import type { PythonBridgeBase } from "../python-bridge-base.js";
 type PythonProviderOptions = Record<string, unknown> & {
     _id: string;
-    _bridge: PythonStdioBridge;
+    _bridge: PythonBridgeBase;
+    /** Provider id understood by the Python worker when the public id is aliased. */
+    _bridgeProviderId?: string;
+    /** Operations advertised by the Python worker for this provider. */
+    _capabilities?: string[];
 };
 export declare class PythonProvider extends BaseProvider {
     private _bridge;
     private _pythonProviderId;
     private _secrets;
-    constructor(providerId: string, bridge: PythonStdioBridge, secrets?: Record<string, string>);
+    private _supportsStreamingTTS;
+    private _supportsEncodedTTS;
+    private _workerCapabilities;
+    constructor(providerId: string, bridge: PythonBridgeBase, secrets?: Record<string, string>);
     constructor(options: PythonProviderOptions);
     static requiredSecrets(): string[];
     getAvailableLanguageModels(): Promise<LanguageModel[]>;
@@ -25,6 +32,7 @@ export declare class PythonProvider extends BaseProvider {
     getAvailableASRModels(): Promise<ASRModel[]>;
     getAvailableEmbeddingModels(): Promise<EmbeddingModel[]>;
     getAvailableVideoModels(): Promise<VideoModel[]>;
+    getAvailableMusicModels(): Promise<MusicModel[]>;
     private _getModels;
     generateMessage(args: {
         messages: Message[];
@@ -49,14 +57,14 @@ export declare class PythonProvider extends BaseProvider {
         audio?: Record<string, unknown>;
     }): AsyncGenerator<ProviderStreamItem>;
     textToImage(params: TextToImageParams): Promise<Uint8Array>;
-    imageToImage(image: Uint8Array, params: ImageToImageParams): Promise<Uint8Array>;
-    textToSpeech(args: {
-        text: string;
-        model: string;
-        voice?: string;
-        speed?: number;
-        audioFormat?: string;
-    }): AsyncGenerator<StreamingAudioChunk>;
+    imageToImage(images: Uint8Array[], params: ImageToImageParams): Promise<Uint8Array>;
+    textToVideo(params: TextToVideoParams): Promise<Uint8Array>;
+    imageToVideo(image: Uint8Array, params: ImageToVideoParams): Promise<Uint8Array>;
+    referenceToVideo(inputs: ReferenceToVideoInputs, params: ReferenceToVideoParams): Promise<Uint8Array>;
+    textToSpeech(args: TextToSpeechParams): AsyncGenerator<StreamingAudioChunk>;
+    supportsStreamingTextToSpeech(): boolean;
+    textToSpeechEncoded(args: TextToSpeechParams): Promise<EncodedAudioResult | null>;
+    textToMusic(params: TextToMusicParams): Promise<EncodedAudioResult>;
     automaticSpeechRecognition(args: {
         audio: Uint8Array;
         model: string;

package/dist/providers/python-provider.d.ts.map

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