@happyvertical/smrt-inference 0.0.0-stage → 0.60.16

package/dist/svelte/types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Presentational types for the inference settings UI (#4754).
+ *
+ * Deliberately free of `@happyvertical/smrt-core`, the AI SDK and the
+ * `@smrt()` model, so the browser bundle stays a thin presentation layer.
+ * Field names match the rows `InferenceSettingsService` returns
+ * (`./server`), so a row is structurally assignable to its view with no
+ * mapping step.
+ *
+ * @module
+ */
+export declare const INFERENCE_SETTINGS_TIERS: readonly ["cheap", "good", "great", "best"];
+export type InferenceSettingsTier = (typeof INFERENCE_SETTINGS_TIERS)[number];
+export declare const INFERENCE_SETTINGS_MODES: readonly ["byo", "local", "hosted", "off"];
+export type InferenceSettingsMode = (typeof INFERENCE_SETTINGS_MODES)[number];
+export type InferenceSettingsLevelView = 'default' | 'config' | 'app' | 'tenant';
+export type InferenceSettingsScope = 'app' | 'tenant';
+/**
+ * A tier target as the panel reads and emits it: a model, an alias or a
+ * fusion. Never a key, never an endpoint (an endpoint belongs in an alias).
+ * `null` means "same as default".
+ */
+export interface InferenceTargetView {
+    kind?: string;
+    provider?: string;
+    model?: string;
+    alias?: string;
+    fusion?: string;
+    candidates?: unknown[];
+}
+/** The user's choices for the default view, plus whether a key is stored. */
+export interface InferenceDefaultsView {
+    mode?: InferenceSettingsMode;
+    provider?: string;
+    baseUrl?: string;
+    model?: string;
+    defaultTier?: InferenceSettingsTier;
+    /** Whether the host holds a key for {@link provider}. The key itself never comes back. */
+    keySet?: boolean;
+}
+/** What Save emits from the default view. Never contains a key. */
+export interface InferenceDefaultsChange {
+    mode: InferenceSettingsMode;
+    provider?: string;
+    baseUrl?: string;
+    model?: string;
+    defaultTier?: InferenceSettingsTier;
+}
+/** What the replace-key action emits. The host stores it through smrt-secrets. */
+export interface InferenceKeyChange {
+    provider: string;
+    key: string;
+    /** Set when the provider choice is a #4674 preset. */
+    preset?: string;
+    /**
+     * The base URL shown when the key was entered. The host binds the key to
+     * this endpoint's origin (`bindInferenceKey()`), not to saved choices.
+     */
+    baseUrl?: string;
+}
+/** One provider choice (`InferenceProviderOption` from `./server`). */
+export interface InferenceProviderView {
+    id: string;
+    label: string;
+    kind: 'preset' | 'provider';
+    baseUrl?: string;
+    requiresApiKey: boolean;
+    needsBaseUrl?: boolean;
+    local?: boolean;
+}
+/** Local discovery results (#4674). */
+export interface InferenceDiscoveryView {
+    service: string;
+    baseUrl: string;
+    models: string[];
+}
+/** What Test connection asks the host to probe. Never carries a key. */
+export interface InferenceConnectionRequest {
+    provider?: string;
+    preset?: string;
+    baseUrl?: string;
+    model?: string;
+}
+/** Key-free probe result (`InferenceConnectionResult`). */
+export interface InferenceTestResultView {
+    reachable: boolean;
+    skipped?: boolean;
+    status?: number;
+    durationMs?: number;
+    detail: string;
+}
+/** One tier row (`InferenceTierSettingsRow`). */
+export interface InferenceTierView {
+    tier: InferenceSettingsTier;
+    effectiveTarget?: InferenceTargetView | null;
+    effectiveLabel: string;
+    supplyingLevel?: InferenceSettingsLevelView;
+    appTarget?: InferenceTargetView | null;
+    tenantTarget?: InferenceTargetView | null;
+    /** What reverting the app scope produces. */
+    appRevertLabel?: string;
+    /** What reverting the tenant scope produces (`null`: not computed). */
+    inheritedLabel?: string | null;
+    tenantAllowList?: string[] | null;
+    tenantBlocked?: boolean;
+}
+/** `auto`'s default tier (`InferenceDefaultTierSetting`). */
+export interface InferenceDefaultTierView {
+    effectiveTier: InferenceSettingsTier;
+    supplyingLevel?: InferenceSettingsLevelView;
+    appTier?: InferenceSettingsTier | null;
+    tenantTier?: InferenceSettingsTier | null;
+    appRevertTier?: InferenceSettingsTier;
+    inheritedTier?: InferenceSettingsTier | null;
+    tenantAllowList?: string[] | null;
+    tenantBlocked?: boolean;
+}
+/** One candidate of an alias chain. `apiKeyEnv` names a variable; there is never a key. */
+export interface InferenceCandidateView {
+    provider?: string;
+    model?: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    preset?: string;
+    alias?: string;
+    params?: Record<string, unknown>;
+}
+/** One alias (`InferenceAliasSetting`). */
+export interface InferenceAliasView {
+    name: string;
+    source?: 'config' | 'app';
+    candidates: InferenceCandidateView[];
+    description?: string;
+    inConfig?: boolean;
+}
+/** One fusion (`InferenceFusionSetting`). */
+export interface InferenceFusionView {
+    name: string;
+    source: 'registry' | 'config' | 'app';
+    definition: Record<string, unknown>;
+    description?: string;
+    editable?: boolean;
+    /** Lower sources this definition replaces by name (#4800). */
+    shadows?: Array<'registry' | 'config'>;
+    /** Why the executor would refuse to run it (#4800); absent when it runs. */
+    issues?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/** Usage report (`reportAiUsage()`, #4751), structurally. */
+export interface InferenceUsageView {
+    by: string[];
+    costBasis?: string;
+    /** The report window, passed on to transcript links. */
+    since?: Date | string | null;
+    until?: Date | string | null;
+    buckets: Array<{
+        key: Record<string, string | null | undefined>;
+        calls: number;
+        totalTokens: number;
+        estimatedCost: number;
+        uncostedCalls?: number;
+        outcomes?: Record<string, number>;
+        /** Calls with a stored transcript (`usage({ transcripts: true })`, #4781). */
+        transcripts?: number;
+    }>;
+}
+export type InferenceUsageDimension = 'model' | 'tier' | 'prompt' | 'fusion' | 'template';
+/** The app's transcript setting values (#4781). */
+export interface InferenceTranscriptValuesView {
+    enabled?: boolean;
+    sample?: number;
+    maxBytes?: number;
+}
+/**
+ * The app's transcript setting (`getTranscriptSettings()`, #4781). App
+ * level only; tenants cannot override it. Never transcript content.
+ */
+export interface InferenceTranscriptSettingsView {
+    enabled: boolean;
+    sample: number;
+    maxBytes: number;
+    supplyingLevel?: 'default' | 'config' | 'app' | 'env';
+    appValue?: InferenceTranscriptValuesView | null;
+    appRevert?: {
+        enabled: boolean;
+        sample: number;
+        maxBytes: number;
+    };
+    /** `SMRT_INFERENCE_TRANSCRIPTS` forces `enabled` (`null`: unset). */
+    envEnabled?: boolean | null;
+    /** Retention sweep window in days; `null`: not pruned. Read-only. */
+    retentionDays?: number | null;
+    promptOverrides?: string[];
+}
+/** What saving the transcript setting emits. Always the app row; `null` reverts it. */
+export interface InferenceTranscriptSettingsChange {
+    settings: {
+        enabled: boolean;
+        sample: number;
+        maxBytes: number;
+    } | null;
+}
+/**
+ * Filters a Usage-tab row hands the host's transcript route (#4781): the
+ * `listAiTranscripts()` filters a bucket can name, plus the report window.
+ */
+export interface InferenceTranscriptLinkFilters {
+    promptKey?: string;
+    templateHash?: string;
+    outcome?: string;
+    /** ISO timestamps of the report window. */
+    since?: string;
+    until?: string;
+}
+export interface InferenceTierChange {
+    tier: InferenceSettingsTier;
+    scope: InferenceSettingsScope;
+    target: InferenceTargetView | null;
+}
+export interface InferenceDefaultTierChange {
+    scope: InferenceSettingsScope;
+    tier: InferenceSettingsTier | null;
+}
+export interface InferenceAliasChange {
+    name: string;
+    /** `null` removes the app definition. */
+    candidates: InferenceCandidateView[] | null;
+    description?: string;
+}
+export interface InferenceFusionChange {
+    name: string;
+    /** `null` removes the config entry. */
+    definition: Record<string, unknown> | null;
+}
+/** Human label for a supplying level. */
+export declare function inferenceLevelLabel(level: InferenceSettingsLevelView | undefined): string;
+/** Key-free label of a target. Mirrors `describeInferenceTarget()` in `./server`. */
+export declare function describeTargetView(target: InferenceTargetView | null | undefined): string;
+/** Key-free label of a candidate (`provider/model`, `preset:<id>/model`, `alias <name>`). */
+export declare function candidateViewLabel(candidate: InferenceCandidateView): string;
+/** Allow-list reference of a target. Mirrors `inferenceTargetRef()` in `./server`. */
+export declare function targetViewRef(target: InferenceTargetView): string;
+/**
+ * Whether a reference is on an allow-list (exact, trailing `*`, or `*`).
+ * Display only: the server enforces the list on every tenant write.
+ */
+export declare function isRefAllowed(ref: string, allowList: readonly string[] | null | undefined): boolean;
+/** What reverting a tier at `scope` produces (the prompts revert invariant). */
+export declare function tierRevertPreview(row: InferenceTierView, scope: InferenceSettingsScope): string;
+/** The tier `auto` returns to when the scope reverts. */
+export declare function defaultTierRevertPreview(view: InferenceDefaultTierView, scope: InferenceSettingsScope): InferenceSettingsTier;
+/**
+ * The transcript-route filters for one usage bucket (and, optionally, one
+ * outcome label): the prompt key and template hash when the report was
+ * grouped by them, and the report window.
+ */
+export declare function transcriptLinkFilters(view: Pick<InferenceUsageView, 'since' | 'until'>, key: Record<string, string | null | undefined>, outcome?: string): InferenceTranscriptLinkFilters;
+/** Usage columns to render: only the dimensions the report was grouped by. */
+export declare function usageColumns(view: InferenceUsageView): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

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

package/dist/svelte/types.js

@@ -0,0 +1,124 @@
+/**
+ * Presentational types for the inference settings UI (#4754).
+ *
+ * Deliberately free of `@happyvertical/smrt-core`, the AI SDK and the
+ * `@smrt()` model, so the browser bundle stays a thin presentation layer.
+ * Field names match the rows `InferenceSettingsService` returns
+ * (`./server`), so a row is structurally assignable to its view with no
+ * mapping step.
+ *
+ * @module
+ */
+export const INFERENCE_SETTINGS_TIERS = [
+    'cheap',
+    'good',
+    'great',
+    'best',
+];
+export const INFERENCE_SETTINGS_MODES = [
+    'byo',
+    'local',
+    'hosted',
+    'off',
+];
+/** Human label for a supplying level. */
+export function inferenceLevelLabel(level) {
+    switch (level) {
+        case 'tenant':
+            return 'Tenant override';
+        case 'app':
+            return 'App override';
+        case 'config':
+            return 'Config';
+        default:
+            return 'Default';
+    }
+}
+/** Key-free label of a target. Mirrors `describeInferenceTarget()` in `./server`. */
+export function describeTargetView(target) {
+    if (!target || Object.keys(target).length === 0) {
+        return 'Same as default (configured client)';
+    }
+    if (target.kind === 'fusion' || target.fusion) {
+        return `Fusion ${target.fusion ?? '?'}`;
+    }
+    if (target.alias)
+        return `Alias ${target.alias}`;
+    if (Array.isArray(target.candidates)) {
+        return `${target.candidates.length} inline candidate(s)`;
+    }
+    return `${target.provider ?? 'default'}/${target.model ?? 'default model'}`;
+}
+/** Key-free label of a candidate (`provider/model`, `preset:<id>/model`, `alias <name>`). */
+export function candidateViewLabel(candidate) {
+    if (candidate.alias)
+        return `alias ${candidate.alias}`;
+    const model = candidate.model ?? 'default';
+    if (candidate.preset)
+        return `preset:${candidate.preset}/${model}`;
+    return `${candidate.provider ?? 'default'}/${model}`;
+}
+/** Allow-list reference of a target. Mirrors `inferenceTargetRef()` in `./server`. */
+export function targetViewRef(target) {
+    if (target.kind === 'fusion' || target.fusion) {
+        return `fusion:${target.fusion ?? ''}`;
+    }
+    if (target.alias)
+        return `alias:${target.alias}`;
+    return `model:${target.provider ?? 'default'}/${target.model ?? 'default'}`;
+}
+/**
+ * Whether a reference is on an allow-list (exact, trailing `*`, or `*`).
+ * Display only: the server enforces the list on every tenant write.
+ */
+export function isRefAllowed(ref, allowList) {
+    return (allowList ?? []).some((pattern) => pattern === '*'
+        ? true
+        : pattern.endsWith('*')
+            ? ref.startsWith(pattern.slice(0, -1))
+            : ref === pattern);
+}
+/** What reverting a tier at `scope` produces (the prompts revert invariant). */
+export function tierRevertPreview(row, scope) {
+    if (scope === 'app')
+        return row.appRevertLabel ?? row.effectiveLabel;
+    return row.inheritedLabel ?? row.appRevertLabel ?? row.effectiveLabel;
+}
+/** The tier `auto` returns to when the scope reverts. */
+export function defaultTierRevertPreview(view, scope) {
+    if (scope === 'app')
+        return view.appRevertTier ?? view.effectiveTier;
+    return view.inheritedTier ?? view.appRevertTier ?? view.effectiveTier;
+}
+/**
+ * The transcript-route filters for one usage bucket (and, optionally, one
+ * outcome label): the prompt key and template hash when the report was
+ * grouped by them, and the report window.
+ */
+export function transcriptLinkFilters(view, key, outcome) {
+    const filters = {};
+    if (typeof key.prompt === 'string' && key.prompt) {
+        filters.promptKey = key.prompt;
+    }
+    if (typeof key.template === 'string' && key.template) {
+        filters.templateHash = key.template;
+    }
+    if (outcome)
+        filters.outcome = outcome;
+    const iso = (value) => value instanceof Date
+        ? value.toISOString()
+        : typeof value === 'string' && value
+            ? value
+            : undefined;
+    const since = iso(view.since);
+    const until = iso(view.until);
+    if (since)
+        filters.since = since;
+    if (until)
+        filters.until = until;
+    return filters;
+}
+/** Usage columns to render: only the dimensions the report was grouped by. */
+export function usageColumns(view) {
+    return view.by.filter((dimension) => dimension.length > 0);
+}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Public shapes of the chain executor (#4752). The config shapes
+ * (`InferenceCandidate`, `InferenceAlias`, `InferenceTarget`) live in core,
+ * which owns the names; this package owns the behavior.
+ */
+/**
+ * Why a candidate did not answer. Classified from the SDK error class, its
+ * code and the HTTP status through the cause chain, never from message text.
+ *
+ * - `quota`: billing or a rate limit that will not reset soon.
+ * - `credential`: missing, rejected or unauthorized key.
+ * - `missing-model`: the provider does not know the model.
+ * - `transient`: timeout, network, 5xx, or a short rate limit; retried once.
+ * - `refusal`: the provider's safety system or the model declined.
+ * - `missing-capability`: the candidate lacks a capability the request
+ *   needs (JSON mode, tools) and the caller permitted no fallback (#4758).
+ *   Detected before the call, so no model ran; core's typed capability
+ *   refusal classifies the same way.
+ */
+export declare const INFERENCE_FAILURE_CLASSES: readonly ["quota", "credential", "missing-model", "transient", "refusal", "missing-capability"];
+export type InferenceFailureClass = (typeof INFERENCE_FAILURE_CLASSES)[number];
+/**
+ * A substitution reason: the failure class that moved the call on, `partial`
+ * for a candidate that streamed text and then failed, or `unclassified` for
+ * the terminal entry of a call ended by an error that is not a routing
+ * failure (rethrown as the caller's own error).
+ */
+export type InferenceSubstitutionReason = InferenceFailureClass | 'partial' | 'unclassified';
+/**
+ * One step of a call's fallback trail, recorded in the `substitutions` usage
+ * tag (a JSON array). `from` and `to` are candidate labels
+ * (`provider/model`, `preset:<id>/model`, or `default` for the configured
+ * client); `to` is `null` when nothing took over.
+ */
+export interface InferenceSubstitution {
+    from: string;
+    to: string | null;
+    reason: InferenceSubstitutionReason;
+}
+/** One problem found in an `inference` config block. */
+export interface InferenceConfigIssue {
+    /** Dotted config path of the offender, e.g. `inference.aliases.frontier`. */
+    path: string;
+    code: 'alias-empty' | 'alias-unknown' | 'alias-cycle' | 'candidate-invalid' | 'candidate-key-without-endpoint' | 'preset-unknown' | 'fusion-invalid' | 'fusion-unknown' | 'fusion-nested' | 'fusion-prompt-unknown';
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,iGAO5B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GACnC,qBAAqB,GACrB,SAAS,GACT,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,2BAA2B,CAAC;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,aAAa,GACb,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,gCAAgC,GAChC,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,13 @@
+//#region src/types.ts
+var INFERENCE_FAILURE_CLASSES = [
+	"quota",
+	"credential",
+	"missing-model",
+	"transient",
+	"refusal",
+	"missing-capability"
+];
+//#endregion
+export { INFERENCE_FAILURE_CLASSES };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Public shapes of the chain executor (#4752). The config shapes\n * (`InferenceCandidate`, `InferenceAlias`, `InferenceTarget`) live in core,\n * which owns the names; this package owns the behavior.\n */\n\n/**\n * Why a candidate did not answer. Classified from the SDK error class, its\n * code and the HTTP status through the cause chain, never from message text.\n *\n * - `quota`: billing or a rate limit that will not reset soon.\n * - `credential`: missing, rejected or unauthorized key.\n * - `missing-model`: the provider does not know the model.\n * - `transient`: timeout, network, 5xx, or a short rate limit; retried once.\n * - `refusal`: the provider's safety system or the model declined.\n * - `missing-capability`: the candidate lacks a capability the request\n *   needs (JSON mode, tools) and the caller permitted no fallback (#4758).\n *   Detected before the call, so no model ran; core's typed capability\n *   refusal classifies the same way.\n */\nexport const INFERENCE_FAILURE_CLASSES = [\n  'quota',\n  'credential',\n  'missing-model',\n  'transient',\n  'refusal',\n  'missing-capability',\n] as const;\n\nexport type InferenceFailureClass = (typeof INFERENCE_FAILURE_CLASSES)[number];\n\n/**\n * A substitution reason: the failure class that moved the call on, `partial`\n * for a candidate that streamed text and then failed, or `unclassified` for\n * the terminal entry of a call ended by an error that is not a routing\n * failure (rethrown as the caller's own error).\n */\nexport type InferenceSubstitutionReason =\n  | InferenceFailureClass\n  | 'partial'\n  | 'unclassified';\n\n/**\n * One step of a call's fallback trail, recorded in the `substitutions` usage\n * tag (a JSON array). `from` and `to` are candidate labels\n * (`provider/model`, `preset:<id>/model`, or `default` for the configured\n * client); `to` is `null` when nothing took over.\n */\nexport interface InferenceSubstitution {\n  from: string;\n  to: string | null;\n  reason: InferenceSubstitutionReason;\n}\n\n/** One problem found in an `inference` config block. */\nexport interface InferenceConfigIssue {\n  /** Dotted config path of the offender, e.g. `inference.aliases.frontier`. */\n  path: string;\n  code:\n    | 'alias-empty'\n    | 'alias-unknown'\n    | 'alias-cycle'\n    | 'candidate-invalid'\n    | 'candidate-key-without-endpoint'\n    | 'preset-unknown'\n    | 'fusion-invalid'\n    | 'fusion-unknown'\n    | 'fusion-nested'\n    | 'fusion-prompt-unknown';\n  message: string;\n}\n"],"mappings":";AAoBO,IAAM,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;AACF"}

package/package.json

@@ -1,6 +1,108 @@
 {
   "name": "@happyvertical/smrt-inference",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.60.16",
+  "description": "Inference alias chains with classified failures, recorded fallback and ladder degradation, consumer-defined fusions, per-user and per-tenant bindings, the InferenceSettingsPanel, hosted provisioning and spend gate, and the smrt doctor --ai binding check, for SMRT inference tiers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "agents"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    },
+    "./resolver": {
+      "types": "./dist/resolver.d.ts",
+      "import": "./dist/resolver.js"
+    },
+    "./models": {
+      "types": "./dist/models.d.ts",
+      "import": "./dist/models.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json",
+    "./gate": {
+      "types": "./dist/gate.d.ts",
+      "import": "./dist/gate.js"
+    }
+  },
+  "dependencies": {
+    "@happyvertical/ai": "^0.111.8",
+    "@happyvertical/smrt-config": "0.60.16",
+    "@happyvertical/smrt-core": "0.60.16",
+    "@happyvertical/smrt-prompts": "0.60.16",
+    "@happyvertical/smrt-secrets": "0.60.16",
+    "@happyvertical/smrt-tenancy": "0.60.16",
+    "@happyvertical/smrt-users": "0.60.16",
+    "@happyvertical/sql": "^0.111.8"
+  },
+  "devDependencies": {
+    "@happyvertical/smrt-vitest": "0.60.16",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "@types/node": "24.13.6",
+    "jsdom": "^29.1.1",
+    "svelte": "^5.57.1",
+    "svelte-check": "^4.7.6",
+    "typescript": "6.0.3",
+    "vite": "8.1.6",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "svelte": "^5.57.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "smrt",
+    "ai",
+    "inference",
+    "fallback",
+    "routing",
+    "settings",
+    "svelte"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/inference"
+  },
+  "scripts": {
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json && node ../../scripts/prune-svelte-package-artifacts.js dist/svelte",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run optional.test.ts",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
 }