@deepthonk/providers 0.1.4 → 0.2.0

package/dist/providerReplay.d.ts

@@ -0,0 +1,282 @@
+import { z } from "zod";
+import type { ProviderConfig } from "./types.js";
+export declare const providerReplaySchema: z.ZodObject<{
+    provider: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    apiKeyEnv: z.ZodOptional<z.ZodString>;
+    supportsJsonMode: z.ZodDefault<z.ZodBoolean>;
+    models: z.ZodObject<{
+        generator: z.ZodString;
+        mutator: z.ZodString;
+        judge: z.ZodString;
+        finalizer: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        generator: string;
+        mutator: string;
+        judge: string;
+        finalizer?: string | undefined;
+    }, {
+        generator: string;
+        mutator: string;
+        judge: string;
+        finalizer?: string | undefined;
+    }>;
+    roleProviders: z.ZodOptional<z.ZodObject<{
+        generator: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+            supportsJsonMode: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }>>;
+        mutator: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+            supportsJsonMode: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }>>;
+        judge: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+            supportsJsonMode: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }>>;
+        finalizer: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+            supportsJsonMode: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }, {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        generator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        mutator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        judge?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        finalizer?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+    }, {
+        generator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        mutator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        judge?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        finalizer?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+    }>>;
+    samplingPreferences: z.ZodOptional<z.ZodObject<{
+        modelHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        costPriority: z.ZodOptional<z.ZodNumber>;
+        speedPriority: z.ZodOptional<z.ZodNumber>;
+        intelligencePriority: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        modelHints?: string[] | undefined;
+        costPriority?: number | undefined;
+        speedPriority?: number | undefined;
+        intelligencePriority?: number | undefined;
+    }, {
+        modelHints?: string[] | undefined;
+        costPriority?: number | undefined;
+        speedPriority?: number | undefined;
+        intelligencePriority?: number | undefined;
+    }>>;
+    routeFingerprint: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    provider: string;
+    models: {
+        generator: string;
+        mutator: string;
+        judge: string;
+        finalizer?: string | undefined;
+    };
+    supportsJsonMode: boolean;
+    routeFingerprint?: string | undefined;
+    baseUrl?: string | undefined;
+    apiKeyEnv?: string | undefined;
+    roleProviders?: {
+        generator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        mutator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        judge?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        finalizer?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    samplingPreferences?: {
+        modelHints?: string[] | undefined;
+        costPriority?: number | undefined;
+        speedPriority?: number | undefined;
+        intelligencePriority?: number | undefined;
+    } | undefined;
+}, {
+    provider: string;
+    models: {
+        generator: string;
+        mutator: string;
+        judge: string;
+        finalizer?: string | undefined;
+    };
+    routeFingerprint?: string | undefined;
+    baseUrl?: string | undefined;
+    apiKeyEnv?: string | undefined;
+    supportsJsonMode?: boolean | undefined;
+    roleProviders?: {
+        generator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        mutator?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        judge?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+        finalizer?: {
+            provider: string;
+            model: string;
+            baseUrl?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            supportsJsonMode?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    samplingPreferences?: {
+        modelHints?: string[] | undefined;
+        costPriority?: number | undefined;
+        speedPriority?: number | undefined;
+        intelligencePriority?: number | undefined;
+    } | undefined;
+}>;
+export type ProviderReplay = z.infer<typeof providerReplaySchema>;
+export declare function providerReplayFromConfig(config: ProviderConfig): ProviderReplay;
+export declare function parseProviderReplay(value: unknown): ProviderReplay | undefined;
+export declare function providerConfigFromReplay(replay: ProviderReplay, retry?: ProviderConfig["retry"], options?: {
+    providerMaxConcurrency?: number;
+    samplingTransport?: ProviderConfig["samplingTransport"];
+}): ProviderConfig;
+export declare function providerRouteFingerprint(replay: Omit<ProviderReplay, "routeFingerprint"> | ProviderReplay): string;
+export declare function assertProviderReplayFingerprint(replay: ProviderReplay): void;

package/dist/providerReplay.js

@@ -0,0 +1,186 @@
+import { createHash } from "node:crypto";
+import { ConfigError } from "@deepthonk/core";
+import { z } from "zod";
+import { resolveProviderConfig } from "./defaults.js";
+const providerRoles = ["generator", "mutator", "judge", "finalizer"];
+const providerReplayRoleSchema = z.object({
+    provider: z.string().min(1),
+    baseUrl: z.string().optional(),
+    apiKeyEnv: z.string().optional(),
+    model: z.string().min(1),
+    supportsJsonMode: z.boolean().optional()
+}).strict();
+export const providerReplaySchema = z.object({
+    provider: z.string().min(1),
+    baseUrl: z.string().optional(),
+    apiKeyEnv: z.string().optional(),
+    supportsJsonMode: z.boolean().default(true),
+    models: z.object({
+        generator: z.string().min(1),
+        mutator: z.string().min(1),
+        judge: z.string().min(1),
+        finalizer: z.string().min(1).optional()
+    }).strict(),
+    roleProviders: z
+        .object({
+        generator: providerReplayRoleSchema.optional(),
+        mutator: providerReplayRoleSchema.optional(),
+        judge: providerReplayRoleSchema.optional(),
+        finalizer: providerReplayRoleSchema.optional()
+    })
+        .strict()
+        .optional(),
+    samplingPreferences: z
+        .object({
+        modelHints: z.array(z.string().min(1)).optional(),
+        costPriority: z.number().min(0).max(1).optional(),
+        speedPriority: z.number().min(0).max(1).optional(),
+        intelligencePriority: z.number().min(0).max(1).optional()
+    })
+        .strict()
+        .optional(),
+    routeFingerprint: z.string().regex(/^sha256:[a-f0-9]{64}$/).optional()
+}).strict();
+export function providerReplayFromConfig(config) {
+    const replay = {
+        provider: config.provider,
+        baseUrl: config.baseUrl,
+        apiKeyEnv: config.apiKeyEnv,
+        supportsJsonMode: config.supportsJsonMode ?? true,
+        models: compactObject({
+            generator: config.models.generator,
+            mutator: config.models.mutator,
+            judge: config.models.judge,
+            finalizer: config.models.finalizer
+        })
+    };
+    const roleProviders = replayRoleProviders(config);
+    if (roleProviders)
+        replay.roleProviders = roleProviders;
+    const samplingPreferences = compactObject({
+        modelHints: config.modelHints,
+        costPriority: config.costPriority,
+        speedPriority: config.speedPriority,
+        intelligencePriority: config.intelligencePriority
+    });
+    if (Object.keys(samplingPreferences).length > 0) {
+        replay.samplingPreferences = samplingPreferences;
+    }
+    replay.routeFingerprint = providerRouteFingerprint(replay);
+    return replay;
+}
+export function parseProviderReplay(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = providerReplaySchema.safeParse(value);
+    if (!parsed.success) {
+        throw invalidReplay(`Stored provider replay is invalid: ${parsed.error.issues.map((issue) => `${issue.path.join(".") || "root"}: ${issue.message}`).join("; ")}`);
+    }
+    assertProviderReplayFingerprint(parsed.data);
+    return parsed.data;
+}
+export function providerConfigFromReplay(replay, retry, options = {}) {
+    assertProviderReplayFingerprint(replay);
+    return resolveProviderConfig({
+        provider: replay.provider,
+        routeFingerprint: replay.routeFingerprint,
+        providerMaxConcurrency: options.providerMaxConcurrency,
+        baseUrl: replay.baseUrl,
+        apiKeyEnv: replay.apiKeyEnv,
+        supportsJsonMode: replay.supportsJsonMode,
+        models: replay.models,
+        roleProviders: replay.roleProviders,
+        retry,
+        samplingTransport: options.samplingTransport,
+        modelHints: replay.samplingPreferences?.modelHints,
+        costPriority: replay.samplingPreferences?.costPriority,
+        speedPriority: replay.samplingPreferences?.speedPriority,
+        intelligencePriority: replay.samplingPreferences?.intelligencePriority
+    });
+}
+export function providerRouteFingerprint(replay) {
+    const roles = Object.fromEntries(providerRoles.flatMap((role) => {
+        const route = replay.roleProviders?.[role];
+        return route
+            ? [[role, routeFingerprintValue(route.provider, route.baseUrl, route.apiKeyEnv, route.model, route.supportsJsonMode)]]
+            : [];
+    }));
+    const fingerprintValue = {
+        base: routeFingerprintValue(replay.provider, replay.baseUrl, replay.apiKeyEnv, replay.models, replay.supportsJsonMode),
+        roles,
+        samplingPreferences: replay.samplingPreferences ?? null
+    };
+    return `sha256:${createHash("sha256").update(stableJson(fingerprintValue)).digest("hex")}`;
+}
+export function assertProviderReplayFingerprint(replay) {
+    if (replay.routeFingerprint && replay.routeFingerprint !== providerRouteFingerprint(replay)) {
+        throw invalidReplay("Stored provider replay route fingerprint does not match its provider route fields.");
+    }
+}
+function replayRoleProviders(config) {
+    if (!config.roleProviders)
+        return undefined;
+    const entries = providerRoles.flatMap((role) => {
+        const roleConfig = config.roleProviders?.[role];
+        if (!roleConfig)
+            return [];
+        return [
+            [
+                role,
+                compactObject({
+                    provider: roleConfig.provider,
+                    baseUrl: roleConfig.baseUrl,
+                    apiKeyEnv: roleConfig.apiKeyEnv,
+                    model: roleConfig.model,
+                    supportsJsonMode: roleConfig.supportsJsonMode
+                })
+            ]
+        ];
+    });
+    return entries.length ? Object.fromEntries(entries) : undefined;
+}
+function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entryValue]) => entryValue !== undefined));
+}
+function routeFingerprintValue(provider, baseUrl, apiKeyEnv, model, supportsJsonMode) {
+    return compactObject({
+        provider,
+        baseUrl: normalizeFingerprintUrl(baseUrl),
+        apiKeyEnv,
+        model,
+        supportsJsonMode
+    });
+}
+function normalizeFingerprintUrl(baseUrl) {
+    if (!baseUrl)
+        return undefined;
+    try {
+        const parsed = new URL(baseUrl);
+        parsed.hash = "";
+        parsed.hostname = parsed.hostname.toLowerCase();
+        parsed.pathname = parsed.pathname.replace(/\/+$/, "");
+        return parsed.toString().replace(/\/$/, "");
+    }
+    catch {
+        return baseUrl.replace(/\/+$/, "");
+    }
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, inner]) => `${JSON.stringify(key)}:${stableJson(inner)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+function invalidReplay(message) {
+    return new ConfigError(message, {
+        code: "provider.replay_route_mismatch",
+        retryable: false,
+        fix: "Resume with the original provider route, or explicitly select a complete replacement route instead of editing config.json."
+    });
+}
+//# sourceMappingURL=providerReplay.js.map

package/dist/providerReplay.js.map

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

package/dist/registry.d.ts

@@ -1,2 +1,4 @@
 import type { ModelDriver, ProviderConfig } from "./types.js";
 export declare function createDriver(config: ProviderConfig): ModelDriver;
+/** Route-only driver for validation and dry-run planning; every model method refuses execution. */
+export declare function createDriverIdentity(config: ProviderConfig): ModelDriver;

package/dist/registry.js

@@ -4,9 +4,47 @@ import { ConfigError, ProviderError } from "@deepthonk/core";
 import { SamplingDriver } from "./sampling.js";
 export function createDriver(config) {
     const baseDriver = createSingleDriver({ ...config, roleProviders: undefined });
-    if (config.roleProviders)
-        return new RoleRoutingDriver(baseDriver, config.roleProviders);
-    return baseDriver;
+    const driver = config.roleProviders ? new RoleRoutingDriver(baseDriver, config.roleProviders) : baseDriver;
+    if (config.routeFingerprint) {
+        Object.defineProperty(driver, "routeFingerprint", { value: config.routeFingerprint, enumerable: false });
+    }
+    return driver;
+}
+/** Route-only driver for validation and dry-run planning; every model method refuses execution. */
+export function createDriverIdentity(config) {
+    const unavailable = async () => {
+        throw new ConfigError("A route-identity driver cannot make model calls.", {
+            code: "provider.identity_driver_call",
+            retryable: false,
+            fix: "Construct a real provider driver before executing the run."
+        });
+    };
+    const identity = {
+        provider: config.provider,
+        baseUrl: config.baseUrl,
+        routeFingerprint: config.routeFingerprint,
+        generate: unavailable,
+        compare: unavailable,
+        mutate: unavailable,
+        finalize: unavailable
+    };
+    if (config.roleProviders) {
+        identity.routes = Object.fromEntries(Object.entries(config.roleProviders).map(([role, route]) => [
+            role,
+            {
+                driver: {
+                    provider: route.provider,
+                    baseUrl: route.baseUrl,
+                    generate: unavailable,
+                    compare: unavailable,
+                    mutate: unavailable,
+                    finalize: unavailable
+                },
+                model: route.model
+            }
+        ]));
+    }
+    return identity;
 }
 function createSingleDriver(config) {
     if (config.provider === "fake")
@@ -78,6 +116,7 @@ function roleProviderToConfig(config) {
             judge: config.model,
             finalizer: config.model
         },
+        providerMaxConcurrency: config.providerMaxConcurrency,
         retry: config.retry,
         supportsJsonMode: config.supportsJsonMode
     };

package/dist/registry.js.map

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

package/dist/routeLimiter.d.ts

@@ -0,0 +1,36 @@
+import type { ProviderConfig } from "./types.js";
+export interface RouteLimiterSnapshot {
+    key: string;
+    active: number;
+    queued: number;
+    ceiling: number;
+    configuredMax: number;
+    explicitMaxConfigured: boolean;
+    successesTowardIncrease: number;
+}
+/** FIFO adaptive concurrency limiter shared by every matching provider route in this process. */
+export declare class AdaptiveRouteLimiter {
+    readonly key: string;
+    private active;
+    private readonly queue;
+    private ceilingValue;
+    private configuredMaxValue;
+    private explicitMaxConfiguredValue;
+    private successesTowardIncrease;
+    constructor(key: string, initialCeiling: number, configuredMax: number, explicitMaxConfigured?: boolean);
+    acquire(signal?: AbortSignal): Promise<() => void>;
+    recordRateLimit(): void;
+    recordSuccess(): void;
+    /**
+     * Unspecified defaults establish a starting point, not a permanent cap. Once a route
+     * receives explicit maxima, conflicting explicit values resolve to their conservative minimum.
+     */
+    constrainConfiguredMax(configuredMax: number, explicitlyConfigured?: boolean): void;
+    snapshot(): RouteLimiterSnapshot;
+    private releaseOnce;
+    private drain;
+}
+export declare function getSharedRouteLimiter(config: ProviderConfig): AdaptiveRouteLimiter;
+export declare function providerRouteLimiterKey(config: Pick<ProviderConfig, "provider" | "baseUrl" | "apiKeyEnv" | "apiKey">): string;
+/** Test-only process registry reset. */
+export declare function resetSharedRouteLimiters(): void;