@happyvertical/smrt-inference 0.0.0-stage → 0.60.16

package/dist/manifest.json

@@ -0,0 +1,453 @@
+{
+  "version": "1.0.0",
+  "timestamp": 0,
+  "packageName": "@happyvertical/smrt-inference",
+  "packageVersion": "0.60.16",
+  "objects": {
+    "@happyvertical/smrt-inference:InferenceOverride": {
+      "name": "inferenceoverride",
+      "className": "InferenceOverride",
+      "qualifiedName": "@happyvertical/smrt-inference:InferenceOverride",
+      "collection": "inferenceoverrides",
+      "filePath": "/home/runner/work/smrt/smrt/packages/inference/src/models/InferenceOverride.ts",
+      "packageName": "@happyvertical/smrt-inference",
+      "fields": {
+        "binding": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "tenantId": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "sqlType": "UUID",
+            "nullable": true
+          }
+        },
+        "target": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "tenantAllowList": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        }
+      },
+      "methods": {
+        "getValue": {
+          "name": "getValue",
+          "async": false,
+          "parameters": [],
+          "returnType": "unknown",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getTenantAllowList": {
+          "name": "getTenantAllowList",
+          "async": false,
+          "parameters": [],
+          "returnType": "string[] | null",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_inference_overrides",
+        "conflictColumns": [
+          "binding",
+          "context"
+        ],
+        "api": false,
+        "cli": false,
+        "mcp": false,
+        "indexes": [
+          {
+            "name": "idx_smrt_inference_overrides_tenant",
+            "columns": [
+              "tenantId",
+              "binding"
+            ]
+          }
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "InferenceOverride",
+      "collectionExportName": "InferenceOverrideCollection",
+      "validationRules": [
+        {
+          "field": "binding",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "_smrt_inference_overrides",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_inference_overrides\" (\n  \"_sync_origin_device_id\" TEXT,\n  \"_sync_revision\" INTEGER,\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"binding\" TEXT NOT NULL DEFAULT '',\n  \"tenant_id\" UUID,\n  \"target\" TEXT,\n  \"tenant_allow_list\" TEXT\n);",
+        "columns": {
+          "_sync_origin_device_id": {
+            "type": "TEXT"
+          },
+          "_sync_revision": {
+            "type": "INTEGER"
+          },
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "binding": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "notNull": false,
+            "unique": false
+          },
+          "target": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "tenant_allow_list": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_inference_overrides_binding_context_idx",
+            "columns": [
+              "binding",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "_smrt_inference_overrides_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "idx_smrt_inference_overrides_tenant",
+            "columns": [
+              "tenant_id",
+              "binding"
+            ]
+          },
+          {
+            "name": "_smrt_inference_overrides_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
+          }
+        ],
+        "version": "4868b81b"
+      },
+      "importPath": "@happyvertical/smrt-inference/models"
+    },
+    "@happyvertical/smrt-inference:InferenceOverrideCollection": {
+      "name": "inferenceoverridecollection",
+      "className": "InferenceOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-inference:InferenceOverrideCollection",
+      "collection": "inferenceoverrides",
+      "description": "Reads and unauthorized writes of _smrt_inference_overrides.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/inference/src/models/InferenceOverrideCollection.ts",
+      "packageName": "@happyvertical/smrt-inference",
+      "fields": {},
+      "methods": {
+        "getScopeMap": {
+          "name": "getScopeMap",
+          "async": true,
+          "parameters": [
+            {
+              "name": "scopeType",
+              "type": "InferenceOverrideScopeType",
+              "optional": false,
+              "resolvedType": "'app' | 'tenant'"
+            },
+            {
+              "name": "scopeId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<Map<string, InferenceOverride>>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "findByScope": {
+          "name": "findByScope",
+          "async": true,
+          "parameters": [
+            {
+              "name": "binding",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "scopeType",
+              "type": "InferenceOverrideScopeType",
+              "optional": false,
+              "resolvedType": "'app' | 'tenant'"
+            },
+            {
+              "name": "scopeId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<InferenceOverride | null>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setOverride": {
+          "name": "setOverride",
+          "async": true,
+          "parameters": [
+            {
+              "name": "binding",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "scopeType",
+              "type": "InferenceOverrideScopeType",
+              "optional": false,
+              "resolvedType": "'app' | 'tenant'"
+            },
+            {
+              "name": "scopeId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "change",
+              "type": "object",
+              "optional": false,
+              "memberTypes": [
+                "unknown",
+                "string[] | null"
+              ]
+            }
+          ],
+          "returnType": "Promise<InferenceOverride | null>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "removeOverride": {
+          "name": "removeOverride",
+          "async": true,
+          "parameters": [
+            {
+              "name": "binding",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "scopeType",
+              "type": "InferenceOverrideScopeType",
+              "optional": false,
+              "resolvedType": "'app' | 'tenant'"
+            },
+            {
+              "name": "scopeId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<boolean>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_inference_overrides",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "InferenceOverride",
+      "exportName": "InferenceOverrideCollection",
+      "collectionExportName": "InferenceOverrideCollectionCollection",
+      "collectionOf": "@happyvertical/smrt-inference:InferenceOverride",
+      "inheritedExposure": [
+        "api",
+        "mcp",
+        "cli"
+      ],
+      "schema": {
+        "tableName": "_smrt_inference_overrides",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_inference_overrides\" (\n  \"_sync_origin_device_id\" TEXT,\n  \"_sync_revision\" INTEGER,\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"binding\" TEXT NOT NULL DEFAULT '',\n  \"tenant_id\" UUID,\n  \"target\" TEXT,\n  \"tenant_allow_list\" TEXT\n);",
+        "columns": {
+          "_sync_origin_device_id": {
+            "type": "TEXT"
+          },
+          "_sync_revision": {
+            "type": "INTEGER"
+          },
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "binding": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "notNull": false,
+            "unique": false
+          },
+          "target": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "tenant_allow_list": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_inference_overrides_binding_context_idx",
+            "columns": [
+              "binding",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "_smrt_inference_overrides_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "idx_smrt_inference_overrides_tenant",
+            "columns": [
+              "tenant_id",
+              "binding"
+            ]
+          },
+          {
+            "name": "_smrt_inference_overrides_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
+          }
+        ],
+        "version": "4868b81b"
+      },
+      "importPath": "@happyvertical/smrt-inference/models"
+    }
+  },
+  "moduleType": "smrt",
+  "smrtDependencies": [
+    "@happyvertical/smrt-core",
+    "@happyvertical/smrt-prompts",
+    "@happyvertical/smrt-secrets",
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-users"
+  ],
+  "browser": {
+    "status": "server-only",
+    "issues": [
+      "#3617",
+      "#3624",
+      "#3626",
+      "#3627"
+    ],
+    "via": [
+      "@happyvertical/smrt-profiles",
+      "@happyvertical/smrt-secrets",
+      "@happyvertical/smrt-tenancy",
+      "@happyvertical/smrt-users"
+    ]
+  },
+  "stampsConstructors": true
+}

package/dist/models/InferenceOverride.d.ts

@@ -0,0 +1,38 @@
+import { SmrtObject, type SmrtObjectOptions, type SmrtSaveOptions } from '@happyvertical/smrt-core';
+/** `context` (and `scopeId`) of the app-wide row. */
+export declare const APP_INFERENCE_SCOPE_ID = "__app__";
+export interface InferenceOverrideOptions extends SmrtObjectOptions {
+    binding?: string;
+    tenantId?: string | null;
+    target?: string | null;
+    tenantAllowList?: string | null;
+}
+export declare class InferenceOverride extends SmrtObject {
+    binding: string;
+    tenantId: string | null;
+    /**
+     * JSON of the bound value; `null` inherits the lower layer. Tier rows hold
+     * a tier target, `default-tier` holds `{ tier }`, alias rows an alias, and
+     * fusion rows a fusion config entry.
+     */
+    target: string | null;
+    /**
+     * App rows of `tier:*` and `default-tier` only: JSON array of the target
+     * references a tenant may bind (`model:openai/*`, `alias:local`,
+     * `fusion:review-pair`, `tier:good`, `*`). No list allows nothing. This is
+     * the stored half of the tenant allow-list; the service's
+     * `tenantTargetPolicy` hook is the code half (#4667 caps the maximum
+     * hosted tier there).
+     */
+    tenantAllowList: string | null;
+    constructor(options?: InferenceOverrideOptions);
+    /** The parsed, validated stored value (`null` inherits). */
+    getValue(): unknown;
+    /** The parsed allow-list (`null` when the row carries none). */
+    getTenantAllowList(): string[] | null;
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+    private normalizedValue;
+    private validateOverride;
+}
+//# sourceMappingURL=InferenceOverride.d.ts.map

package/dist/models/InferenceOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceOverride.d.ts","sourceRoot":"","sources":["../../src/models/InferenceOverride.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAalC,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAoBD,qBAaa,iBAAkB,SAAQ,UAAU;IAE/C,OAAO,EAAE,MAAM,CAAM;IAKrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;OAIG;IAEH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B;;;;;;;OAOG;IAEH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAE1B,OAAO,GAAE,wBAA6B;IAUlD,4DAA4D;IAC5D,QAAQ,IAAI,OAAO;IAInB,gEAAgE;IAChE,kBAAkB,IAAI,MAAM,EAAE,GAAG,IAAI;IAOtB,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,gBAAgB;CAwDzB"}

package/dist/models/InferenceOverrideCollection.d.ts

@@ -0,0 +1,35 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { APP_INFERENCE_SCOPE_ID, InferenceOverride } from './InferenceOverride.js';
+/** `app` (the `__app__` row) or one tenant. */
+export type InferenceOverrideScopeType = 'app' | 'tenant';
+/**
+ * Reads and unauthorized writes of `_smrt_inference_overrides`. Hosts write
+ * through `InferenceOverrideService` (authorizer-gated, fails closed); call
+ * {@link setOverride} / {@link removeOverride} directly only after your own
+ * authorization decision.
+ */
+export declare class InferenceOverrideCollection extends SmrtCollection<InferenceOverride> {
+    static readonly _itemClass: typeof InferenceOverride;
+    /**
+     * Every row of one scope, keyed by binding id: one bounded read. An
+     * enumeration read: build the collection without list bounds (the
+     * settings service does) so a host-wide `maxListLimit` cannot drop a row.
+     */
+    getScopeMap(scopeType: InferenceOverrideScopeType, scopeId: string): Promise<Map<string, InferenceOverride>>;
+    /** The row for one binding at one scope. */
+    findByScope(binding: string, scopeType: InferenceOverrideScopeType, scopeId: string): Promise<InferenceOverride | null>;
+    /**
+     * Set the stored value (and, for app rows, optionally the tenant
+     * allow-list) of one binding at one scope, creating the row when needed.
+     * `undefined` leaves a column untouched; `null` clears it. A row left with
+     * neither a value nor an allow-list is deleted.
+     */
+    setOverride(binding: string, scopeType: InferenceOverrideScopeType, scopeId: string, change: {
+        target?: unknown;
+        tenantAllowList?: string[] | null;
+    }): Promise<InferenceOverride | null>;
+    /** Delete the row for one binding at one scope, if any. */
+    removeOverride(binding: string, scopeType: InferenceOverrideScopeType, scopeId: string): Promise<boolean>;
+}
+export { APP_INFERENCE_SCOPE_ID };
+//# sourceMappingURL=InferenceOverrideCollection.d.ts.map

package/dist/models/InferenceOverrideCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceOverrideCollection.d.ts","sourceRoot":"","sources":["../../src/models/InferenceOverrideCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;;OAIG;IACG,WAAW,CACf,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAQ1C,4CAA4C;IACtC,WAAW,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMpC;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,GAC9D,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAmCpC,2DAA2D;IACrD,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;CAMpB;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @happyvertical/smrt-inference/models — the `_smrt_inference_overrides`
+ * model (#4754). Generated consumer registration imports it from here; apps
+ * write through `InferenceSettingsService` / `InferenceOverrideService` in
+ * `./server`, never through the collection directly unless they made their
+ * own authorization decision.
+ */
+import './__smrt-register__.js';
+export { APP_INFERENCE_SCOPE_ID, InferenceOverride, type InferenceOverrideOptions, } from './models/InferenceOverride.js';
+export { InferenceOverrideCollection, type InferenceOverrideScopeType, } from './models/InferenceOverrideCollection.js';
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC"}

package/dist/models.js

@@ -0,0 +1,2 @@
+import { n as APP_INFERENCE_SCOPE_ID, r as InferenceOverride, t as InferenceOverrideCollection } from "./chunks/InferenceOverrideCollection-Dat4TrK5.js";
+export { APP_INFERENCE_SCOPE_ID, InferenceOverride, InferenceOverrideCollection };

package/dist/node.d.ts

@@ -0,0 +1,110 @@
+import { type InferenceCandidate, type InferenceCapabilities, type InferenceCapabilityEvidence, type InferenceConfig } from '@happyvertical/smrt-core';
+import type { InferenceConfigIssue } from './types.js';
+export type InferenceDoctorStatus = 'ok' | 'warn' | 'error';
+/** Result of one reachability probe. */
+export interface InferenceProbeResult {
+    /** True when the endpoint answered and accepted the credential. */
+    reachable: boolean;
+    /** True when no cheap probe is known for the provider. */
+    skipped?: boolean;
+    /** HTTP status, when one came back. */
+    status?: number;
+    durationMs: number;
+    /** Short, key-free explanation. */
+    detail: string;
+    /**
+     * What the model listing says about the candidate's model (#4758), when
+     * the endpoint answered and listed it with capability fields.
+     */
+    capabilities?: InferenceCapabilityEvidence;
+}
+/** One candidate of a binding. */
+export interface InferenceDoctorCandidate {
+    label: string;
+    status: InferenceDoctorStatus;
+    problems: string[];
+    probe?: InferenceProbeResult;
+    /** With `probe`: the candidate's capabilities and their source (#4758). */
+    capabilities?: InferenceCapabilities;
+}
+/** One tier or alias binding. */
+export interface InferenceDoctorBinding {
+    /** `tier:<name>` or `alias:<name>`. */
+    binding: string;
+    /** Key-free description of the target. */
+    target: string;
+    status: InferenceDoctorStatus;
+    problems: string[];
+    candidates: InferenceDoctorCandidate[];
+}
+/** The doctor's answer. `ok` is false when any binding cannot resolve. */
+export interface InferenceDoctorReport {
+    ok: boolean;
+    /** False when no `inference` block is configured (every tier uses the configured client). */
+    configured: boolean;
+    bindings: InferenceDoctorBinding[];
+    issues: InferenceConfigIssue[];
+}
+/** Options for {@link checkInferenceBindings} and the probe. */
+export interface CheckInferenceBindingsOptions {
+    /** Config to check. Default: core's merged `getInferenceConfig()`. */
+    config?: InferenceConfig;
+    /** Environment for key presence. Default `process.env`. */
+    env?: Record<string, string | undefined>;
+    /** Call each candidate's list endpoint. Default false (offline). */
+    probe?: boolean;
+    /** Probe timeout per candidate, ms. Default 3000. */
+    timeoutMs?: number;
+    /** Fetch implementation for probes. Default global `fetch`. */
+    fetch?: typeof fetch;
+    /** Recognized provider names. Default the AI SDK's provider list. */
+    providers?: readonly string[];
+    /**
+     * The SDK `getCapabilities()` answer for a candidate (the `provider`
+     * layer, #4758), when the host can supply one. Default: none; the doctor
+     * builds no SDK clients.
+     */
+    sdkCapabilities?: (candidate: InferenceCandidate) => unknown | Promise<unknown>;
+}
+/**
+ * Capability evidence for `model` from a list endpoint's body (#4758):
+ * OpenAI-compatible `data[]` entries (OpenRouter `context_length`,
+ * `supported_parameters`, `architecture.input_modalities`; LM Studio
+ * `max_context_length`; llama.cpp `meta.n_ctx_train`) and Gemini
+ * `models[].inputTokenLimit`. Unknown shapes give nothing.
+ */
+export declare function inferenceCapabilitiesFromModelListing(body: unknown, model: string | undefined): InferenceCapabilityEvidence | undefined;
+/**
+ * A candidate's capabilities from every layer the doctor can see (#4758):
+ * the host's SDK answer (when given), the preset table, the probe's
+ * evidence, the model heuristic, then assumed.
+ */
+export declare function inferenceCandidateCapabilities(candidate: InferenceCandidate, options?: {
+    probe?: InferenceCapabilityEvidence;
+    sdkCapabilities?: CheckInferenceBindingsOptions['sdkCapabilities'];
+}): Promise<InferenceCapabilities>;
+/**
+ * The URL {@link probeInferenceCandidate} would call for a candidate, or
+ * `undefined` when no cheap probe is known. Key-free; the settings key rule
+ * (#4754) binds a key to this URL's origin.
+ */
+export declare function inferenceProbeUrl(candidate: InferenceCandidate): string | undefined;
+/**
+ * Probe one candidate's cheapest list endpoint (`/models`, Ollama
+ * `/api/tags`) with a short timeout. The key goes only to the candidate's
+ * own endpoint and never appears in the result.
+ */
+export declare function probeInferenceCandidate(candidate: InferenceCandidate, options?: Pick<CheckInferenceBindingsOptions, 'env' | 'timeoutMs' | 'fetch'>): Promise<InferenceProbeResult>;
+/**
+ * Walk every tier and alias binding; see the module comment. Never throws on
+ * a bad config: problems come back in the report, and `ok` is false when any
+ * binding cannot resolve.
+ */
+export declare function checkInferenceBindings(options?: CheckInferenceBindingsOptions): Promise<InferenceDoctorReport>;
+/** One line describing capabilities, e.g. `json no, tools yes, … (preset)`. */
+export declare function formatInferenceCapabilities(capabilities: InferenceCapabilities): string;
+/** The lines `smrt doctor --ai` prints for a report. */
+export declare function formatInferenceDoctorReport(report: InferenceDoctorReport): string[];
+export * from './hosted.js';
+export type { InferenceConfigIssue } from './types.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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