@happyvertical/smrt-inference 0.0.0-stage → 0.60.15

package/dist/svelte/types.js

@@ -0,0 +1,96 @@
+/**
+ * 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;
+}
+/** 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.15",
+  "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.6",
+    "@happyvertical/smrt-config": "0.60.15",
+    "@happyvertical/smrt-core": "0.60.15",
+    "@happyvertical/smrt-prompts": "0.60.15",
+    "@happyvertical/smrt-secrets": "0.60.15",
+    "@happyvertical/smrt-tenancy": "0.60.15",
+    "@happyvertical/smrt-users": "0.60.15",
+    "@happyvertical/sql": "^0.111.6"
+  },
+  "devDependencies": {
+    "@happyvertical/smrt-vitest": "0.60.15",
+    "@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 ."
+  }
 }