@happyvertical/smrt-inference 0.0.0-stage → 0.60.16

package/dist/settings/preferences.d.ts

@@ -0,0 +1,137 @@
+/**
+ * User inference choices as the smrt-preferences kind `inference` (#4754):
+ * mode, provider, base URL, model and default tier, at the tenant default
+ * and per user. Never a key: the validator refuses credential-shaped members
+ * (keys go to smrt-secrets through the host).
+ *
+ * smrt-preferences is not a dependency: the kind is a plain definition the
+ * host registers with `registerPreferenceKind(inferencePreferenceKind)` (and
+ * the two permissions with smrt-users' `registerPermissionDefinitions`), and
+ * {@link createInferencePreferences} takes the store structurally.
+ */
+import { type InferenceTier } from '@happyvertical/smrt-core';
+import { type InferenceMode } from './targets.js';
+export declare const INFERENCE_PREFERENCE_KIND = "inference";
+/** Default surface id: one inference choice per tenant and user. */
+export declare const INFERENCE_PREFERENCE_SURFACE = "default";
+/** Authorizes changing the tenant's default inference choices. */
+export declare const CUSTOMIZE_INFERENCE_PERMISSION = "inference.customize";
+/** Authorizes a user to keep their own inference choices. */
+export declare const PERSONALIZE_INFERENCE_PERMISSION = "inference.personalize";
+/** For smrt-users' `registerPermissionDefinitions()`. */
+export declare const INFERENCE_PERMISSION_DEFINITIONS: readonly [{
+    readonly slug: "inference.customize";
+    readonly category: "inference";
+    readonly name: "Customize Inference";
+    readonly description: "Change the default inference mode, provider and model everyone in the tenant uses";
+}, {
+    readonly slug: "inference.personalize";
+    readonly category: "inference";
+    readonly name: "Personalize Inference";
+    readonly description: "Keep a personal inference mode, provider and model on top of the tenant default";
+}];
+/** The `inference` preference payload. Every member is optional. */
+export interface InferencePreferences {
+    mode?: InferenceMode;
+    provider?: string;
+    baseUrl?: string;
+    model?: string;
+    defaultTier?: InferenceTier;
+}
+/** Structural copy of smrt-preferences' issue shape. */
+export interface InferencePreferenceIssue {
+    path: string | null;
+    code: string;
+    message: string;
+}
+/**
+ * Validate an `inference` payload: unknown or invalid members are removed
+ * and reported, credential-shaped members refuse the whole payload.
+ */
+export declare function validateInferencePreferences(payload: unknown): {
+    ok: boolean;
+    canonical: InferencePreferences | null;
+    issues: InferencePreferenceIssue[];
+};
+/** The kind definition for smrt-preferences' `registerPreferenceKind()`. */
+export declare const inferencePreferenceKind: {
+    kind: string;
+    formatVersion: number;
+    permissions: {
+        tenant: string;
+        user: string;
+    };
+    validate(payload: unknown): {
+        ok: boolean;
+        canonical: InferencePreferences | null;
+        issues: InferencePreferenceIssue[];
+    };
+};
+type WriteResult = {
+    ok: true;
+    revision?: string | null;
+    [extra: string]: unknown;
+} | {
+    ok: false;
+    reason: string;
+    [extra: string]: unknown;
+};
+/** The slice of smrt-preferences' `PreferenceStore` this layer uses. */
+export interface InferencePreferenceStoreLike {
+    load(kind: string, surfaceId: string): Promise<{
+        tenant: {
+            payload: unknown;
+            revision: string | null;
+        };
+        user?: {
+            payload: unknown;
+            revision: string | null;
+        } | null;
+        issues: InferencePreferenceIssue[];
+        canCustomize: {
+            tenant: boolean;
+            user: boolean;
+        };
+    }>;
+    save(kind: string, surfaceId: string, input: {
+        scope: 'tenant' | 'user';
+        payload: unknown;
+        revision: string | null;
+    }): Promise<WriteResult>;
+    reset(kind: string, surfaceId: string, input: {
+        scope: 'tenant' | 'user';
+        revision?: string | null;
+    }): Promise<WriteResult>;
+}
+/** What a settings screen reads. */
+export interface InferencePreferenceRead {
+    /** Tenant default with the user's choices on top (member by member). */
+    choices: InferencePreferences;
+    tenant: InferencePreferences | null;
+    user: InferencePreferences | null;
+    revisions: {
+        tenant: string | null;
+        user: string | null;
+    };
+    issues: InferencePreferenceIssue[];
+    canCustomize: {
+        tenant: boolean;
+        user: boolean;
+    };
+}
+/** Read and write the `inference` preference over a preference store. */
+export declare function createInferencePreferences(store: InferencePreferenceStoreLike, surfaceId?: string): {
+    read(): Promise<InferencePreferenceRead>;
+    /** Save choices at a scope (default `user`); `revision` is the one the client loaded. */
+    write(choices: InferencePreferences, options: {
+        scope?: "tenant" | "user";
+        revision: string | null;
+    }): Promise<WriteResult>;
+    reset(options?: {
+        scope?: "tenant" | "user";
+        revision?: string | null;
+    }): Promise<WriteResult>;
+};
+export type InferencePreferencesApi = ReturnType<typeof createInferencePreferences>;
+export {};
+//# sourceMappingURL=preferences.d.ts.map

package/dist/settings/preferences.d.ts.map

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

package/dist/settings/resolver.d.ts

@@ -0,0 +1,41 @@
+/**
+ * An `InferenceResolver` that applies the stored app and tenant bindings
+ * (#4754) at call time: config < app row < allowed tenant row. A tier with
+ * no stored binding defers to `base` (another resolver, e.g. #4756's
+ * per-user one) or to core's built-in config resolution, so an empty table
+ * changes nothing.
+ *
+ * Aliases defined only in app rows are not visible to the executor (it reads
+ * the process config), so a stored binding to such an alias is returned as
+ * the alias's inline candidate chain, expanded recursively; aliases that the
+ * config defines stay references.
+ *
+ * Fusions defined in app rows reach the executor through `lookupFusion()`
+ * (#4800, core's `InferenceExecutionContext.lookupFusion`): read from the
+ * app scope only (a tenant never defines a fusion), validated against
+ * config + app rows including every seat's prompt key (an invalid row throws
+ * `InferenceConfigError`, never runs), with app-only seat aliases inlined
+ * the same way. An app row shadows a config fusion of the same name.
+ */
+import { type InferenceResolver, type SmrtClassOptions } from '@happyvertical/smrt-core';
+import { InferenceOverrideCollection } from '../models/InferenceOverrideCollection.js';
+import type { InferenceTenantTargetPolicy } from './override-service.js';
+/** Options for {@link createInferenceOverrideResolver}. */
+export interface InferenceOverrideResolverOptions {
+    /** Database options for the override collection (list bounds are stripped). */
+    db?: SmrtClassOptions;
+    /** An existing collection instead of `db`. */
+    overrides?: InferenceOverrideCollection;
+    /** Resolver to defer to for tiers with no stored binding. */
+    base?: InferenceResolver;
+    /** The code half of the tenant allow-list (same hook as the settings service). */
+    tenantTargetPolicy?: InferenceTenantTargetPolicy;
+    /**
+     * How long a tenant's layers are reused, ms. Default 30 000. Any write in
+     * this process invalidates immediately; other processes see it after TTL.
+     */
+    ttlMs?: number;
+}
+/** See the module doc. */
+export declare function createInferenceOverrideResolver(options?: InferenceOverrideResolverOptions): InferenceResolver;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/settings/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/settings/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIL,KAAK,iBAAiB,EAKtB,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAUvF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAGzE,2DAA2D;AAC3D,MAAM,WAAW,gCAAgC;IAC/C,+EAA+E;IAC/E,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,2BAA2B,CAAC;IACjD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkED,0BAA0B;AAC1B,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,iBAAiB,CA0HnB"}

package/dist/settings/settings-service.d.ts

@@ -0,0 +1,355 @@
+import { type AiUsageReport, type AiUsageReportDimension, type InferenceAlias, type InferenceCandidate, type InferenceConfig, type InferenceTarget, type InferenceTier, type InferenceTranscriptsConfig, type RetentionPolicy, type SmrtClassOptions } from '@happyvertical/smrt-core';
+import { InferenceOverrideCollection, type InferenceOverrideScopeType } from '../models/InferenceOverrideCollection.js';
+import { type InferenceDoctorReport } from '../node.js';
+import type { InferenceConfigIssue } from '../types.js';
+import { type InferenceKeyRecord } from './keys.js';
+import { type InferenceSettingsConfig } from './layers.js';
+import { type InferenceOverrideAuthorizer, type InferenceTenantTargetPolicy } from './override-service.js';
+import { DEFAULT_TIER_BINDING, type InferenceTranscriptSettingsValue, TRANSCRIPTS_BINDING } from './targets.js';
+/** Which level supplied an effective value. */
+export type InferenceSettingsLevel = 'default' | 'config' | 'app' | 'tenant';
+/** One tier, rendered for a settings screen. */
+export interface InferenceTierSettingsRow {
+    binding: `tier:${InferenceTier}`;
+    tier: InferenceTier;
+    /** What the tier resolves to for the requested tenant; `null` is the configured client. */
+    effectiveTarget: InferenceTarget | null;
+    effectiveLabel: string;
+    supplyingLevel: InferenceSettingsLevel;
+    /** The `inference` config's binding (code default + config files + env). */
+    configTarget: InferenceTarget | null;
+    /** The app row's raw value, `null` when none. */
+    appTarget: InferenceTarget | null;
+    /**
+     * The tenant row's raw value, `null` when none or no tenant was requested.
+     * Present even when {@link tenantBlocked}: the screen shows why it is not
+     * in effect.
+     */
+    tenantTarget: InferenceTarget | null;
+    /** What reverting the **app** scope produces: the config binding. */
+    appRevertTarget: InferenceTarget | null;
+    appRevertLabel: string;
+    /**
+     * What reverting the **tenant** scope produces: config plus the app row.
+     * `null` label when no tenant was requested (nothing computed it).
+     */
+    inheritedTarget: InferenceTarget | null;
+    inheritedLabel: string | null;
+    /** The tenant allow-list on the app row (`null`: tenants may bind nothing). */
+    tenantAllowList: string[] | null;
+    /** A tenant row exists but the allow-list or policy refuses it now. */
+    tenantBlocked: boolean;
+}
+/** `auto`'s default tier, rendered for a settings screen. */
+export interface InferenceDefaultTierSetting {
+    binding: typeof DEFAULT_TIER_BINDING;
+    effectiveTier: InferenceTier;
+    supplyingLevel: InferenceSettingsLevel;
+    configTier: InferenceTier | null;
+    appTier: InferenceTier | null;
+    tenantTier: InferenceTier | null;
+    /** What reverting the app scope produces (config, else `good`). */
+    appRevertTier: InferenceTier;
+    /** What reverting the tenant scope produces; `null` when no tenant was requested. */
+    inheritedTier: InferenceTier | null;
+    tenantAllowList: string[] | null;
+    tenantBlocked: boolean;
+}
+/** One alias for the alias editor. */
+export interface InferenceAliasSetting {
+    name: string;
+    /** Where the effective definition comes from (an app row replaces config whole). */
+    source: 'config' | 'app';
+    candidates: InferenceCandidate[];
+    description?: string;
+    /** True when config also defines it (reverting the app row restores that). */
+    inConfig: boolean;
+}
+/** One fusion for the fusion list (#4753 owns their meaning). */
+export interface InferenceFusionSetting {
+    name: string;
+    source: 'registry' | 'config' | 'app';
+    /** The definition as JSON-safe data. */
+    definition: Record<string, unknown>;
+    description?: string;
+    /** Config entries (app rows) can be edited as JSON; registry fusions are code. */
+    editable: boolean;
+    /**
+     * Lower sources this definition replaces by name (#4800): an app row
+     * shadows config and the registry, config shadows the registry, exactly
+     * as the executor picks. Absent when nothing is shadowed.
+     */
+    shadows?: Array<'registry' | 'config'>;
+    /**
+     * Why the executor would refuse to run this definition (structure,
+     * aliases, unregistered seat prompt keys), checked as the executor
+     * checks it (#4800). Absent when it would run.
+     */
+    issues?: InferenceConfigIssue[];
+}
+/**
+ * The app's transcript setting (#4781), for the panel's Advanced section.
+ * App level only: tenants cannot override it, so it is the same for every
+ * tenant. Never carries transcript content.
+ */
+export interface InferenceTranscriptSettings {
+    binding: typeof TRANSCRIPTS_BINDING;
+    /** Effective values: config < app row < `SMRT_INFERENCE_TRANSCRIPTS`. */
+    enabled: boolean;
+    sample: number;
+    maxBytes: number;
+    /** Which level supplied `enabled`. */
+    supplyingLevel: 'default' | 'config' | 'app' | 'env';
+    /** The app row's stored value (`null`: none). */
+    appValue: InferenceTranscriptSettingsValue | null;
+    /** What reverting the app row produces (config and env only). */
+    appRevert: {
+        enabled: boolean;
+        sample: number;
+        maxBytes: number;
+    };
+    /** `SMRT_INFERENCE_TRANSCRIPTS` forces `enabled` to this (`null`: unset). */
+    envEnabled: boolean | null;
+    /**
+     * Days transcripts are kept by the retention sweep
+     * (`retention.aiTranscripts.maxAgeDays`); `null` when the sweep skips
+     * them. Read-only here: the sweep runs with its caller's policy.
+     */
+    retentionDays: number | null;
+    /** Prompt keys with their own sample rate in config (read-only). */
+    promptOverrides: string[];
+}
+/** One provider choice for the default view. */
+export interface InferenceProviderOption {
+    id: string;
+    label: string;
+    /** `preset` (#4674 endpoint presets) or `provider` (the AI SDK list). */
+    kind: 'preset' | 'provider';
+    baseUrl?: string;
+    requiresApiKey: boolean;
+    /** Needs a base URL before a key can be bound (gateways). */
+    needsBaseUrl?: boolean;
+    /** A loopback server (local discovery applies). */
+    local?: boolean;
+}
+/** What Test connection probes. Never carries a key: the host supplies the stored record. */
+export interface InferenceConnectionInput {
+    provider?: string;
+    preset?: string;
+    baseUrl?: string;
+    model?: string;
+}
+/** Key-free result of a test. */
+export interface InferenceConnectionResult {
+    reachable: boolean;
+    skipped?: boolean;
+    status?: number;
+    durationMs: number;
+    detail: string;
+    /** Whether a stored key was sent (only ever to its bound origin). */
+    keySent: boolean;
+}
+/** A fusion the host's registry knows (soft dependency on #4753's `defineFusion`). */
+export interface RegisteredFusionLike {
+    key: string;
+    description?: string;
+    [member: string]: unknown;
+}
+/** Options for {@link InferenceSettingsService.create}. */
+export interface InferenceSettingsServiceOptions {
+    /** Host authorizer. Omit for a read-only (load-function) service: writes fail closed. */
+    authorize?: InferenceOverrideAuthorizer;
+    /** The code half of the tenant allow-list (#4667 caps hosted tiers here). */
+    tenantTargetPolicy?: InferenceTenantTargetPolicy;
+    /** The config layer. Default core's merged `getInferenceConfig()`. */
+    config?: () => InferenceConfig | undefined;
+    /**
+     * Registered fusions. Default: #4753's process registry (`defineFusion()`).
+     */
+    registryFusions?: () => Iterable<RegisteredFusionLike>;
+    /**
+     * The transcript config with an app layer (#4781). Default core's
+     * `getInferenceTranscriptsConfig()` (config < app < env).
+     */
+    transcriptsConfig?: (app: InferenceTranscriptsConfig | null) => InferenceTranscriptsConfig | undefined;
+    /** The retention policy the sweep runs with. Default core `config().retention`. */
+    retention?: () => RetentionPolicy | undefined;
+}
+/** Thrown when a write would leave the layered config invalid. Nothing is written. */
+export declare class InferenceSettingsConfigError extends Error {
+    readonly issues: InferenceConfigIssue[];
+    readonly status = 400;
+    constructor(issues: InferenceConfigIssue[]);
+}
+/** Thrown when removing an alias or fusion that something still names. Nothing is written. */
+export declare class InferenceBindingInUseError extends Error {
+    readonly binding: string;
+    /** App-scope and config referrers. */
+    readonly referrers: string[];
+    /** How many tenant rows name it (never which tenants). */
+    readonly tenantReferences: number;
+    readonly status = 409;
+    constructor(binding: string, 
+    /** App-scope and config referrers. */
+    referrers: string[], 
+    /** How many tenant rows name it (never which tenants). */
+    tenantReferences: number);
+}
+/** Usage tab dimensions (`usage()`). */
+export type InferenceUsageReportDimension = Extract<AiUsageReportDimension, 'model' | 'tier' | 'prompt' | 'fusion' | 'template'>;
+/**
+ * Read and write side of an inference settings screen. See the module doc.
+ */
+export declare class InferenceSettingsService {
+    private readonly overrides;
+    private readonly options;
+    private readonly writes;
+    private readonly readConfig;
+    constructor(overrides: InferenceOverrideCollection, options?: InferenceSettingsServiceOptions);
+    /** Build a service over the given database options (list bounds stripped). */
+    static create(options?: SmrtClassOptions, serviceOptions?: InferenceSettingsServiceOptions): Promise<InferenceSettingsService>;
+    private loadLayers;
+    /**
+     * The effective config for a tenant: config < app rows < allowed tenant
+     * rows. What the override resolver binds and the doctor checks.
+     * Server-side only: config layers may carry literal keys, so never send
+     * this to a browser (the row methods strip them).
+     */
+    getEffectiveConfig(options?: {
+        tenantId?: string | null;
+    }): Promise<InferenceSettingsConfig | undefined>;
+    /**
+     * One row per tier (`cheap`, `good`, `great`, `best`): the effective
+     * target, each scope's raw override, and both revert previews.
+     */
+    listInferenceSettings(options?: {
+        tenantId?: string | null;
+    }): Promise<InferenceTierSettingsRow[]>;
+    /** `auto`'s default tier with the same per-scope shape. */
+    getDefaultTierSetting(options?: {
+        tenantId?: string | null;
+    }): Promise<InferenceDefaultTierSetting>;
+    /** Every alias: config entries, replaced whole by app rows. Sorted by name. */
+    listInferenceAliases(): Promise<InferenceAliasSetting[]>;
+    /**
+     * Fusions from the host's registry (code, read-only), the config's
+     * `inference.fusions`, and app rows (editable JSON). A later source
+     * shadows an earlier one by name, the executor's precedence (#4800): app
+     * row, then config, then registry. Each entry carries the issues that
+     * would make the executor refuse it, so the list shows what would run.
+     */
+    listInferenceFusions(): Promise<InferenceFusionSetting[]>;
+    /**
+     * Bind (or, with `null`, revert) one tier at one scope. Tenant writes must
+     * pass the allow-list; every write goes through the authorizer.
+     */
+    setTierOverride(request: {
+        tier: InferenceTier;
+        scopeType: InferenceOverrideScopeType;
+        scopeId: string;
+        target: InferenceTarget | null;
+    }): Promise<void>;
+    /** Set (or revert) `auto`'s default tier at one scope. */
+    setDefaultTierOverride(request: {
+        scopeType: InferenceOverrideScopeType;
+        scopeId: string;
+        tier: InferenceTier | null;
+    }): Promise<void>;
+    /** Set (or remove) the tenant allow-list of a tier or of the default tier. */
+    setTenantAllowList(request: {
+        binding: `tier:${InferenceTier}` | typeof DEFAULT_TIER_BINDING;
+        allowList: string[] | null;
+    }): Promise<void>;
+    /** Define (or, with `null`, remove) an app-level alias. */
+    setAlias(request: {
+        name: string;
+        alias: InferenceAlias | null;
+    }): Promise<void>;
+    /** Store (or, with `null`, remove) an app-level fusion config entry (#4753 shape). */
+    setFusion(request: {
+        name: string;
+        definition: Record<string, unknown> | null;
+    }): Promise<void>;
+    /**
+     * Refuse removing an app alias or fusion that a stored binding (any
+     * scope, any tenant) or the config still names, unless config or the
+     * registry keeps defining it. Otherwise the removal would leave dangling
+     * references that fail at call time.
+     */
+    private assertNotReferenced;
+    /**
+     * Refuse a write that adds a config issue (unknown alias, cycle, key
+     * without endpoint, unknown preset) to the layered config it lands in.
+     * Issues that already existed do not block unrelated writes.
+     */
+    private assertConfigStaysValid;
+    /**
+     * Test connection for the default view: probe the endpoint's cheapest
+     * list call (`./node`'s `probeInferenceCandidate`, 3 s). The stored key
+     * record (from the host's `SecretService`) is sent only when the probe URL
+     * is on the key's bound origin; no environment key is read.
+     */
+    testConnection(input: InferenceConnectionInput, options?: {
+        key?: InferenceKeyRecord | null;
+        fetch?: typeof fetch;
+        timeoutMs?: number;
+    }): Promise<InferenceConnectionResult>;
+    /**
+     * Per-candidate test for the alias editor. A candidate already in the
+     * effective config (config file or an app row) reads its key from
+     * `apiKeyEnv` (or its provider's variable) exactly as the doctor does,
+     * sent only to its own endpoint; any other candidate (an unsaved edit) is
+     * probed with no key at all.
+     */
+    testCandidate(candidate: InferenceCandidate, options?: {
+        env?: Record<string, string | undefined>;
+        fetch?: typeof fetch;
+        timeoutMs?: number;
+    }): Promise<InferenceConnectionResult>;
+    private isConfiguredCandidate;
+    /** `smrt doctor --ai` over the effective config for a tenant. */
+    doctor(options?: {
+        tenantId?: string | null;
+        probe?: boolean;
+        env?: Record<string, string | undefined>;
+        fetch?: typeof fetch;
+    }): Promise<InferenceDoctorReport>;
+    /**
+     * The app's transcript setting (#4781): effective values, the stored app
+     * row, its revert preview, the env override and the retention window.
+     * The same for every tenant (no tenant override).
+     */
+    getTranscriptSettings(): Promise<InferenceTranscriptSettings>;
+    /**
+     * Store (or, with `null`, remove) the app's transcript setting. Always
+     * the app row: there is no tenant scope. Goes through the authorizer
+     * (request `{ binding: 'transcripts', scopeType: 'app' }`); on success the
+     * value is installed as core's app settings layer in this process.
+     */
+    setTranscriptSettings(request: {
+        settings: InferenceTranscriptSettingsValue | null;
+    }): Promise<void>;
+    /**
+     * The Usage tab: `reportAiUsage()` (#4751) grouped by model, tier, prompt
+     * key, fusion and/or template hash. Pass `by: ['model']` where tier and
+     * prompt tags do not exist yet; NULL dimensions are their own bucket,
+     * never dropped. `transcripts: true` adds per-bucket transcript counts
+     * (#4781; ids only, never content).
+     */
+    usage(options?: {
+        by?: InferenceUsageReportDimension[];
+        since?: Date;
+        until?: Date;
+        tenantId?: string | null;
+        transcripts?: boolean;
+    }): Promise<AiUsageReport>;
+    /** Local discovery for the model field (#4674's loopback probe). */
+    discoverModels(): Promise<Array<{
+        service: string;
+        baseUrl: string;
+        models: string[];
+    }>>;
+    /** Provider choices: #4674 presets, then the AI SDK provider list. */
+    listProviderOptions(): InferenceProviderOption[];
+}
+//# sourceMappingURL=settings-service.d.ts.map

package/dist/settings/settings-service.d.ts.map

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