@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/providers/runtime-metadata.js

@@ -0,0 +1,129 @@
+import { listBuiltinSubscriptionProviders } from '../config/subscription-providers.js';
+function determineFreshness(expiresAt) {
+    if (typeof expiresAt !== 'number' || !Number.isFinite(expiresAt))
+        return 'healthy';
+    if (expiresAt <= Date.now())
+        return 'expired';
+    if (expiresAt <= Date.now() + 24 * 60 * 60 * 1000)
+        return 'expiring';
+    return 'healthy';
+}
+export async function buildStandardProviderAuthRoutes(options, deps) {
+    const secretKeys = [...new Set([...(options.secretKeys ?? []), ...(options.apiKeyEnvVars ?? [])])];
+    const detailedSecrets = await deps.secretsManager.listDetailed();
+    const matchingSecretRecords = detailedSecrets.filter((record) => secretKeys.includes(record.key) && record.source !== 'env');
+    const hasSecretRef = matchingSecretRecords.some((record) => Boolean(record.refSource));
+    const hasStoredDirectSecret = matchingSecretRecords.some((record) => !record.refSource);
+    const hasEnv = (options.apiKeyEnvVars ?? []).some((envVar) => {
+        const value = process.env[envVar];
+        return typeof value === 'string' && value.length > 0;
+    });
+    const builtinSubscriptions = new Set(listBuiltinSubscriptionProviders().map((entry) => entry.provider));
+    const subscriptionProviderId = options.subscriptionProviderId ?? options.providerId;
+    const subscription = deps.subscriptionManager.get(subscriptionProviderId);
+    const pendingSubscription = deps.subscriptionManager.getPending(subscriptionProviderId);
+    const hasSubscriptionRoute = builtinSubscriptions.has(subscriptionProviderId) || subscription != null || pendingSubscription != null;
+    const subscriptionFreshness = pendingSubscription
+        ? 'pending'
+        : subscription
+            ? determineFreshness(subscription.expiresAt)
+            : 'unconfigured';
+    const serviceNames = options.serviceNames && options.serviceNames.length > 0
+        ? [...new Set(options.serviceNames)]
+        : Object.values(deps.serviceRegistry.getAll())
+            .filter((service) => service.authType === 'oauth' && (service.providerId ?? service.name) === options.providerId)
+            .map((service) => service.name);
+    const serviceInspections = await Promise.all(serviceNames.map(async (name) => ({
+        name,
+        inspection: await deps.serviceRegistry.inspect(name),
+    })));
+    const hasServiceConfig = serviceInspections.some(({ inspection }) => inspection?.config.authType === 'oauth');
+    const hasUsableServiceOauth = serviceInspections.some(({ inspection }) => Boolean(inspection?.hasPrimaryCredential));
+    const routes = [];
+    if ((options.apiKeyEnvVars?.length ?? 0) > 0 || secretKeys.length > 0) {
+        routes.push({
+            route: 'api-key',
+            label: 'Ambient API key',
+            configured: hasEnv || hasStoredDirectSecret,
+            usable: hasEnv || hasStoredDirectSecret,
+            freshness: hasEnv || hasStoredDirectSecret ? 'healthy' : 'unconfigured',
+            detail: hasEnv
+                ? 'Environment-backed API key is available.'
+                : hasStoredDirectSecret
+                    ? 'GoodVibes secret store contains a direct API key value.'
+                    : 'No direct API key is configured.',
+            ...(options.apiKeyEnvVars?.length ? { envVars: options.apiKeyEnvVars } : {}),
+            ...(secretKeys.length > 0 ? { secretKeys } : {}),
+            repairHints: [
+                ...(options.apiKeyEnvVars?.length
+                    ? [`Set ${options.apiKeyEnvVars.join(' or ')} or store one of those keys in /secrets.`]
+                    : ['Store the provider API key in /secrets or the process environment.']),
+            ],
+        });
+        routes.push({
+            route: 'secret-ref',
+            label: 'SecretRef-backed API key',
+            configured: hasSecretRef,
+            usable: hasSecretRef,
+            freshness: hasSecretRef ? 'healthy' : 'unconfigured',
+            detail: hasSecretRef
+                ? 'A GoodVibes SecretRef is configured for this provider.'
+                : 'No SecretRef-backed credential is configured.',
+            ...(secretKeys.length > 0 ? { secretKeys } : {}),
+            repairHints: [
+                'Use /secrets link <KEY> <secret-ref> to attach Bitwarden, Vaultwarden, BWS, or another supported SecretRef.',
+            ],
+        });
+    }
+    if (hasServiceConfig || serviceNames.length > 0) {
+        routes.push({
+            route: 'service-oauth',
+            label: 'Service OAuth',
+            configured: hasServiceConfig,
+            usable: hasUsableServiceOauth,
+            freshness: hasUsableServiceOauth ? 'healthy' : 'unconfigured',
+            detail: hasUsableServiceOauth
+                ? 'A service-owned OAuth credential is available for this provider.'
+                : 'Service OAuth metadata exists, but the credential path is incomplete.',
+            ...(serviceNames.length > 0 ? { serviceNames } : {}),
+            repairHints: ['Repair the provider service credential in /services or the settings surface.'],
+        });
+    }
+    if (hasSubscriptionRoute) {
+        routes.push({
+            route: 'subscription-oauth',
+            label: 'Subscription OAuth',
+            configured: subscription != null || pendingSubscription != null || builtinSubscriptions.has(subscriptionProviderId),
+            usable: subscriptionFreshness !== 'expired' && subscriptionFreshness !== 'unconfigured',
+            freshness: subscriptionFreshness,
+            detail: pendingSubscription
+                ? 'Subscription OAuth login is pending completion.'
+                : subscription
+                    ? 'A stored subscription OAuth session is available for this provider.'
+                    : 'A built-in subscription OAuth adapter is available, but no session is stored yet.',
+            providerId: subscriptionProviderId,
+            repairHints: [`Use /subscription login ${subscriptionProviderId} start or refresh the stored subscription session.`],
+        });
+    }
+    if (options.allowAnonymous) {
+        routes.push({
+            route: 'anonymous',
+            label: 'Anonymous / local access',
+            configured: Boolean(options.anonymousConfigured),
+            usable: Boolean(options.anonymousConfigured),
+            freshness: options.anonymousConfigured ? 'healthy' : 'unconfigured',
+            detail: options.anonymousDetail ?? 'This provider can be used without an API key.',
+        });
+    }
+    if (routes.length === 0) {
+        return [{
+                route: 'none',
+                label: 'No auth route declared',
+                configured: false,
+                usable: false,
+                freshness: 'unconfigured',
+                detail: 'The provider did not declare any runtime auth routes.',
+            }];
+    }
+    return routes;
+}

package/dist/_internal/platform/providers/runtime-snapshot.d.ts

@@ -0,0 +1,34 @@
+import type { ProviderRuntimeMetadata } from './interface.js';
+import type { ProviderRegistry } from './registry.js';
+export interface ProviderModelSnapshot {
+    readonly id: string;
+    readonly registryKey: string;
+    readonly displayName: string;
+    readonly selectable: boolean;
+    readonly contextWindow: number;
+    readonly tier?: string;
+    readonly pricing?: {
+        readonly inputPerMillionTokens: number;
+        readonly outputPerMillionTokens: number;
+        readonly currency: 'USD';
+    };
+}
+export interface ProviderRuntimeSnapshot {
+    readonly providerId: string;
+    readonly active: boolean;
+    readonly modelCount: number;
+    readonly runtime: ProviderRuntimeMetadata;
+    readonly models: readonly ProviderModelSnapshot[];
+}
+export interface ProviderUsageSnapshot {
+    readonly providerId: string;
+    readonly active: boolean;
+    readonly currentModelId?: string;
+    readonly pricingSource: 'catalog' | 'provider' | 'none';
+    readonly models: readonly ProviderModelSnapshot[];
+    readonly usage: NonNullable<ProviderRuntimeMetadata['usage']>;
+}
+export declare function listProviderRuntimeSnapshots(providerRegistry: Pick<ProviderRegistry, 'listProviders' | 'getRegistered' | 'getCurrentModel' | 'listModels' | 'getCostFromCatalog' | 'describeRuntime'>): Promise<readonly ProviderRuntimeSnapshot[]>;
+export declare function getProviderRuntimeSnapshot(providerRegistry: Pick<ProviderRegistry, 'getRegistered' | 'getCurrentModel' | 'listModels' | 'getCostFromCatalog' | 'describeRuntime'>, providerId: string): Promise<ProviderRuntimeSnapshot | null>;
+export declare function getProviderUsageSnapshot(providerRegistry: Pick<ProviderRegistry, 'getRegistered' | 'getCurrentModel' | 'listModels' | 'getCostFromCatalog' | 'describeRuntime'>, providerId: string): Promise<ProviderUsageSnapshot | null>;
+//# sourceMappingURL=runtime-snapshot.d.ts.map

package/dist/_internal/platform/providers/runtime-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/providers/runtime-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGvE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;QACvC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/D;AA8DD,wBAAsB,4BAA4B,CAChD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,GAAG,oBAAoB,GAAG,iBAAiB,CAAC,GACxJ,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAG7C;AAED,wBAAsB,0BAA0B,CAC9C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,iBAAiB,GAAG,YAAY,GAAG,oBAAoB,GAAG,iBAAiB,CAAC,EACvI,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAEzC;AAED,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,iBAAiB,GAAG,YAAY,GAAG,oBAAoB,GAAG,iBAAiB,CAAC,EACvI,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAiBvC"}

package/dist/_internal/platform/providers/runtime-snapshot.js

@@ -0,0 +1,79 @@
+function toModelSnapshot(model, providerRegistry) {
+    const cost = providerRegistry.getCostFromCatalog(model.id);
+    return {
+        id: model.id,
+        registryKey: model.registryKey,
+        displayName: model.displayName,
+        selectable: model.selectable,
+        contextWindow: model.contextWindow,
+        ...(model.tier ? { tier: model.tier } : {}),
+        ...(cost
+            ? {
+                pricing: {
+                    inputPerMillionTokens: cost.input,
+                    outputPerMillionTokens: cost.output,
+                    currency: 'USD',
+                },
+            }
+            : {}),
+    };
+}
+async function buildSnapshotForProvider(providerRegistry, providerId) {
+    let provider;
+    try {
+        provider = providerRegistry.getRegistered(providerId);
+    }
+    catch {
+        return null;
+    }
+    const runtime = provider.describeRuntime
+        ? await providerRegistry.describeRuntime(providerId)
+        : {
+            auth: { mode: 'none', configured: false, detail: 'Provider does not expose runtime metadata.' },
+            models: { models: provider.models },
+            usage: { streaming: true, toolCalling: true, parallelTools: false },
+        };
+    const resolvedRuntime = runtime ?? {
+        auth: { mode: 'none', configured: false, detail: 'Provider does not expose runtime metadata.' },
+        models: { models: provider.models },
+        usage: { streaming: true, toolCalling: true, parallelTools: false },
+    };
+    const currentModel = providerRegistry.getCurrentModel();
+    const models = providerRegistry
+        .listModels()
+        .filter((model) => model.provider === providerId)
+        .map((model) => toModelSnapshot(model, providerRegistry));
+    return {
+        providerId,
+        active: currentModel.provider === providerId,
+        modelCount: models.length,
+        runtime: resolvedRuntime,
+        models,
+    };
+}
+export async function listProviderRuntimeSnapshots(providerRegistry) {
+    const snapshots = await Promise.all(providerRegistry.listProviders().map((provider) => buildSnapshotForProvider(providerRegistry, provider.name)));
+    return snapshots.filter((snapshot) => snapshot != null);
+}
+export async function getProviderRuntimeSnapshot(providerRegistry, providerId) {
+    return buildSnapshotForProvider(providerRegistry, providerId);
+}
+export async function getProviderUsageSnapshot(providerRegistry, providerId) {
+    const snapshot = await buildSnapshotForProvider(providerRegistry, providerId);
+    if (!snapshot)
+        return null;
+    const currentModel = providerRegistry.getCurrentModel();
+    const usage = snapshot.runtime.usage ?? {
+        streaming: true,
+        toolCalling: true,
+        parallelTools: false,
+    };
+    return {
+        providerId,
+        active: snapshot.active,
+        ...(currentModel.provider === providerId ? { currentModelId: currentModel.id } : {}),
+        pricingSource: snapshot.models.some((model) => model.pricing) ? 'catalog' : (usage.cost?.source ?? 'none'),
+        models: snapshot.models,
+        usage,
+    };
+}

package/dist/_internal/platform/providers/synthetic.d.ts

@@ -0,0 +1,78 @@
+import type { LLMProvider, ChatRequest, ChatResponse } from './interface.js';
+import type { BenchmarkEntry } from '@pellux/goodvibes-sdk/platform/providers/model-benchmarks';
+import type { RuntimeEventBus } from '../runtime/events/index.js';
+export interface SyntheticBackend {
+    /** Provider name as registered in the provider registry. */
+    providerName: string;
+    /** Model ID as understood by the provider. */
+    modelId: string;
+    /**
+     * Compound registry key for this backend: `${providerName}:${modelId}`.
+     * Used for unambiguous routing and provider lookup.
+     */
+    registryKey?: string;
+    /** Context window in tokens (used for backend sort order). */
+    contextWindow?: number;
+    /** Maximum output tokens (used as tiebreaker in sort order). */
+    maxOutputTokens?: number;
+    /**
+     * Environment variable names that gate this backend.
+     * Empty array or undefined means no key required (always available).
+     */
+    envVars?: string[];
+}
+export type SyntheticTier = 'free' | 'paid' | 'subscription';
+/**
+ * Maps normalised synthetic model IDs to their ordered backend list.
+ * Type annotation used by registry.ts for backend resolution.
+ */
+export type SyntheticModelMap = Record<string, SyntheticBackend[]>;
+/**
+ * A canonical model offered by the SyntheticProvider.
+ * Groups backends by tier so failover never crosses tier boundaries.
+ */
+export interface CanonicalModel {
+    /** Canonical model ID exposed to callers (e.g. 'kimi-k2.5'). */
+    id: string;
+    /** Pricing tier — determines which backend pool is used for failover. */
+    tier: SyntheticTier;
+    /** Ordered list of backends to try within this tier. */
+    backends: SyntheticBackend[];
+    /** Total number of provider backends offering this model. */
+    backendCount: number;
+    /** Number of backends for which the user has configured API keys. */
+    keyedBackendCount: number;
+}
+type SyntheticCatalogAccessor = () => readonly CanonicalModel[];
+type BenchmarkLookup = (modelId: string) => BenchmarkEntry | undefined;
+/**
+ * Returns backend count metadata for a synthetic model ID.
+ * Used by the model picker to display provider availability.
+ *
+ * @returns Object with backendCount, keyedBackendCount, and tier, or null if not found.
+ */
+export declare function getSyntheticModelInfo(modelId: string, getCatalogModels: SyntheticCatalogAccessor): {
+    backendCount: number;
+    keyedBackendCount: number;
+    tier: SyntheticTier;
+} | null;
+export declare class SyntheticProvider implements LLMProvider {
+    readonly name = "synthetic";
+    private readonly getCatalogModels;
+    private readonly getBenchmarks;
+    private readonly runtimeBus;
+    /** Returns a live snapshot of canonical model IDs each time it is accessed. */
+    get models(): string[];
+    private cooldowns;
+    private activeBackend;
+    private readonly resolveProvider;
+    constructor(options: {
+        resolveProvider: (providerName: string) => LLMProvider;
+        getCatalogModels: SyntheticCatalogAccessor;
+        getBenchmarks: BenchmarkLookup;
+        runtimeBus?: RuntimeEventBus | null;
+    });
+    chat(params: ChatRequest): Promise<ChatResponse>;
+}
+export {};
+//# sourceMappingURL=synthetic.d.ts.map

package/dist/_internal/platform/providers/synthetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/providers/synthetic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAC;AAEhG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAkBD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,IAAI,EAAE,aAAa,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,KAAK,wBAAwB,GAAG,MAAM,SAAS,cAAc,EAAE,CAAC;AAChE,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,wBAAwB,GACzC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CASjF;AAoID,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,+EAA+E;IAC/E,IAAI,MAAM,IAAI,MAAM,EAAE,CAKrB;IAGD,OAAO,CAAC,SAAS,CAA+B;IAEhD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;gBAE5D,OAAO,EAAE;QACnB,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,WAAW,CAAC;QACvD,gBAAgB,EAAE,wBAAwB,CAAC;QAC3C,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;KACrC;IAOK,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CA8SvD"}