@happyvertical/smrt-inference 0.0.0-stage → 0.60.15

package/dist/svelte/components/InferenceTierRow.svelte

@@ -0,0 +1,199 @@
+<script lang="ts">
+/**
+ * One rung of the tier ladder: "same as default", a model, an alias or a
+ * fusion. In the tenant scope, targets the allow-list does not open are
+ * disabled (display only; the server enforces the list on every write).
+ */
+import { untrack } from 'svelte';
+import type {
+  InferenceAliasView,
+  InferenceFusionView,
+  InferenceProviderView,
+  InferenceSettingsScope,
+  InferenceTargetView,
+  InferenceTierChange,
+  InferenceTierView,
+} from '../types.js';
+import {
+  inferenceLevelLabel,
+  isRefAllowed,
+  targetViewRef,
+  tierRevertPreview,
+} from '../types.js';
+
+interface InferenceTierRowProps {
+  row: InferenceTierView;
+  scope: InferenceSettingsScope;
+  providers: InferenceProviderView[];
+  aliases: InferenceAliasView[];
+  fusions: InferenceFusionView[];
+  busy: boolean;
+  onSaveTier?: (change: InferenceTierChange) => void;
+}
+
+const {
+  row,
+  scope,
+  providers,
+  aliases,
+  fusions,
+  busy,
+  onSaveTier,
+}: InferenceTierRowProps = $props();
+
+type Kind = 'default' | 'model' | 'alias' | 'fusion';
+
+function kindOf(target: InferenceTargetView | null | undefined): Kind {
+  if (!target || Object.keys(target).length === 0) return 'default';
+  if (target.kind === 'fusion' || target.fusion) return 'fusion';
+  if (target.alias) return 'alias';
+  return 'model';
+}
+
+const own = untrack(
+  () => (scope === 'app' ? row.appTarget : row.tenantTarget) ?? null,
+);
+let kind = $state<Kind>(kindOf(own));
+let provider = $state(own?.provider ?? '');
+let model = $state(own?.model ?? '');
+let alias = $state(own?.alias ?? '');
+let fusion = $state(own?.fusion ?? '');
+
+const restricted = $derived(scope === 'tenant');
+const allowed = (target: InferenceTargetView) =>
+  !restricted || isRefAllowed(targetViewRef(target), row.tenantAllowList);
+const modelAllowed = $derived(
+  !restricted ||
+    (row.tenantAllowList ?? []).some(
+      (pattern) => pattern === '*' || pattern.startsWith('model:'),
+    ),
+);
+const aliasAllowed = $derived(
+  aliases.some((entry) => allowed({ alias: entry.name })),
+);
+const fusionAllowed = $derived(
+  fusions.some((entry) => allowed({ kind: 'fusion', fusion: entry.name })),
+);
+
+function target(): InferenceTargetView | null {
+  if (kind === 'model') {
+    return provider
+      ? { provider, model: model.trim() }
+      : { model: model.trim() };
+  }
+  if (kind === 'alias') return { alias };
+  if (kind === 'fusion') return { kind: 'fusion', fusion };
+  return null;
+}
+
+function submit(event: SubmitEvent): void {
+  event.preventDefault();
+  onSaveTier?.({ tier: row.tier, scope, target: target() });
+}
+</script>
+
+<form class="itr" onsubmit={submit} data-testid={`inference-tier-${row.tier}`}>
+  <div class="itr-head">
+    <strong class="itr-tier">{row.tier}</strong>
+    <span class="itr-effective">{row.effectiveLabel}</span>
+    <span class="itr-level">{inferenceLevelLabel(row.supplyingLevel)}</span>
+  </div>
+  {#if restricted && row.tenantBlocked}
+    <p class="itr-note" role="note">
+      This tenant binding is no longer on the allow-list and is not in effect.
+    </p>
+  {/if}
+  <div class="itr-controls">
+    <label>
+      <span class="itr-label">Target for {row.tier}</span>
+      <select name="kind" bind:value={kind} disabled={busy}>
+        <option value="default">Same as default</option>
+        <option value="model" disabled={!modelAllowed}>Model</option>
+        <option value="alias" disabled={!aliasAllowed}>Alias</option>
+        <option value="fusion" disabled={!fusionAllowed}>Fusion</option>
+      </select>
+    </label>
+    {#if kind === 'model'}
+      <label>
+        <span class="itr-label">Provider</span>
+        <select name="provider" bind:value={provider} disabled={busy}>
+          <option value="">Configured provider</option>
+          {#each providers.filter((option) => option.kind === 'provider') as option (option.id)}
+            <option value={option.id}>{option.label}</option>
+          {/each}
+        </select>
+      </label>
+      <label>
+        <span class="itr-label">Model</span>
+        <input name="model" bind:value={model} required disabled={busy} />
+      </label>
+    {:else if kind === 'alias'}
+      <label>
+        <span class="itr-label">Alias</span>
+        <select name="alias" bind:value={alias} required disabled={busy}>
+          <option value="" disabled>Choose an alias</option>
+          {#each aliases as entry (entry.name)}
+            <option value={entry.name} disabled={!allowed({ alias: entry.name })}>{entry.name}</option>
+          {/each}
+        </select>
+      </label>
+    {:else if kind === 'fusion'}
+      <label>
+        <span class="itr-label">Fusion</span>
+        <select name="fusion" bind:value={fusion} required disabled={busy}>
+          <option value="" disabled>Choose a fusion</option>
+          {#each fusions as entry (entry.name)}
+            <option value={entry.name} disabled={!allowed({ kind: 'fusion', fusion: entry.name })}>
+              {entry.name}
+            </option>
+          {/each}
+        </select>
+      </label>
+    {/if}
+    <button type="submit" disabled={busy || !onSaveTier}>Save</button>
+  </div>
+  <p class="itr-hint">"Same as default" reverts to: {tierRevertPreview(row, scope)}</p>
+</form>
+
+<style>
+@layer smrt.reset, smrt.structure, smrt.theme;
+@layer smrt.theme {
+  .itr {
+    display: flex;
+    flex-direction: column;
+    gap: 0.375rem;
+    padding: 0.5rem 0;
+    border-bottom: var(--smrt-hairline);
+  }
+  .itr-head {
+    display: flex;
+    gap: 0.75rem;
+    align-items: baseline;
+    flex-wrap: wrap;
+  }
+  .itr-tier {
+    text-transform: capitalize;
+    min-width: 4rem;
+  }
+  .itr-level,
+  .itr-hint,
+  .itr-note,
+  .itr-label {
+    font-size: 0.8125rem;
+    color: var(--smrt-color-on-surface-variant);
+  }
+  .itr-hint,
+  .itr-note {
+    margin: 0;
+  }
+  .itr-label {
+    display: block;
+  }
+  .itr-controls {
+    display: flex;
+    gap: 0.5rem;
+    align-items: flex-end;
+    flex-wrap: wrap;
+  }
+}
+</style>

package/dist/svelte/components/InferenceTierRow.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { InferenceAliasView, InferenceFusionView, InferenceProviderView, InferenceSettingsScope, InferenceTierChange, InferenceTierView } from '../types.js';
+interface InferenceTierRowProps {
+    row: InferenceTierView;
+    scope: InferenceSettingsScope;
+    providers: InferenceProviderView[];
+    aliases: InferenceAliasView[];
+    fusions: InferenceFusionView[];
+    busy: boolean;
+    onSaveTier?: (change: InferenceTierChange) => void;
+}
+declare const InferenceTierRow: import("svelte").Component<InferenceTierRowProps, {}, "">;
+type InferenceTierRow = ReturnType<typeof InferenceTierRow>;
+export default InferenceTierRow;
+//# sourceMappingURL=InferenceTierRow.svelte.d.ts.map

package/dist/svelte/components/InferenceTierRow.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceTierRow.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/InferenceTierRow.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EAEtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AASrB,UAAU,qBAAqB;IAC7B,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACpD;AAyID,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/svelte/components/InferenceUsageTable.svelte

@@ -0,0 +1,127 @@
+<script lang="ts">
+/**
+ * The Usage tab: `reportAiUsage()` buckets (#4751) by model, tier and/or
+ * prompt key. Renders only the dimensions the report was grouped by, so it
+ * works with the model dimension alone.
+ */
+import type { InferenceUsageDimension, InferenceUsageView } from '../types.js';
+import { usageColumns } from '../types.js';
+
+interface InferenceUsageTableProps {
+  usage: InferenceUsageView | null;
+  busy: boolean;
+  onUsageGroupBy?: (by: InferenceUsageDimension[]) => void;
+}
+
+const { usage, busy, onUsageGroupBy }: InferenceUsageTableProps = $props();
+
+const DIMENSIONS: Array<{ id: InferenceUsageDimension; label: string }> = [
+  { id: 'model', label: 'Model' },
+  { id: 'tier', label: 'Tier' },
+  { id: 'prompt', label: 'Prompt key' },
+];
+
+const columns = $derived(usage ? usageColumns(usage) : []);
+
+function regroup(event: Event): void {
+  const form = (event.currentTarget as HTMLInputElement).form;
+  if (!form || !onUsageGroupBy) return;
+  const by = new FormData(form)
+    .getAll('by')
+    .map(String) as InferenceUsageDimension[];
+  onUsageGroupBy(by.length > 0 ? by : ['model']);
+}
+
+function outcomes(value: Record<string, number> | undefined): string {
+  const entries = Object.entries(value ?? {});
+  return entries.length > 0
+    ? entries.map(([label, count]) => `${label} ${count}`).join(', ')
+    : '–';
+}
+</script>
+
+<div class="iut" data-testid="inference-usage">
+  {#if onUsageGroupBy}
+    <form class="iut-group">
+      <span class="iut-label">Group by</span>
+      {#each DIMENSIONS as dimension (dimension.id)}
+        <label>
+          <input
+            type="checkbox"
+            name="by"
+            value={dimension.id}
+            checked={columns.includes(dimension.id)}
+            disabled={busy}
+            onchange={regroup}
+          />
+          {dimension.label}
+        </label>
+      {/each}
+    </form>
+  {/if}
+  {#if !usage || usage.buckets.length === 0}
+    <p class="iut-label">No usage recorded yet.</p>
+  {:else}
+    <table class="iut-table">
+      <thead>
+        <tr>
+          {#each columns as column (column)}
+            <th scope="col">{DIMENSIONS.find((entry) => entry.id === column)?.label ?? column}</th>
+          {/each}
+          <th scope="col">Calls</th>
+          <th scope="col">Tokens</th>
+          <th scope="col">Est. cost</th>
+          <th scope="col">Outcomes</th>
+        </tr>
+      </thead>
+      <tbody>
+        {#each usage.buckets as bucket, index (index)}
+          <tr>
+            {#each columns as column (column)}
+              <td>{bucket.key[column] ?? '(unattributed)'}</td>
+            {/each}
+            <td>{bucket.calls}</td>
+            <td>{bucket.totalTokens}</td>
+            <td>
+              ${bucket.estimatedCost.toFixed(4)}
+              {#if bucket.uncostedCalls}<span class="iut-label">({bucket.uncostedCalls} uncosted)</span>{/if}
+            </td>
+            <td>{outcomes(bucket.outcomes)}</td>
+          </tr>
+        {/each}
+      </tbody>
+    </table>
+    {#if usage.costBasis}<p class="iut-label">{usage.costBasis}</p>{/if}
+  {/if}
+</div>
+
+<style>
+@layer smrt.reset, smrt.structure, smrt.theme;
+@layer smrt.theme {
+  .iut {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+  .iut-group {
+    display: flex;
+    gap: 0.75rem;
+    align-items: center;
+  }
+  .iut-table {
+    border-collapse: collapse;
+    font-size: 0.875rem;
+  }
+  .iut-table th,
+  .iut-table td {
+    text-align: left;
+    padding: 0.25rem 0.75rem 0.25rem 0;
+    border-bottom: var(--smrt-hairline);
+  }
+  .iut-label {
+    margin: 0;
+    font-size: 0.8125rem;
+    color: var(--smrt-color-on-surface-variant);
+  }
+}
+</style>

package/dist/svelte/components/InferenceUsageTable.svelte.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The Usage tab: `reportAiUsage()` buckets (#4751) by model, tier and/or
+ * prompt key. Renders only the dimensions the report was grouped by, so it
+ * works with the model dimension alone.
+ */
+import type { InferenceUsageDimension, InferenceUsageView } from '../types.js';
+interface InferenceUsageTableProps {
+    usage: InferenceUsageView | null;
+    busy: boolean;
+    onUsageGroupBy?: (by: InferenceUsageDimension[]) => void;
+}
+declare const InferenceUsageTable: import("svelte").Component<InferenceUsageTableProps, {}, "">;
+type InferenceUsageTable = ReturnType<typeof InferenceUsageTable>;
+export default InferenceUsageTable;
+//# sourceMappingURL=InferenceUsageTable.svelte.d.ts.map

package/dist/svelte/components/InferenceUsageTable.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferenceUsageTable.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/InferenceUsageTable.svelte.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI/E,UAAU,wBAAwB;IAChC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,uBAAuB,EAAE,KAAK,IAAI,CAAC;CAC1D;AAsFD,QAAA,MAAM,mBAAmB,8DAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @happyvertical/smrt-inference/svelte
+ *
+ * Optional Svelte 5 UI for inference settings (#4754). Presentational only:
+ * the panel takes rows and callbacks, does no fetching, and makes no
+ * authorization decision. Hosts render it from a server load that used
+ * `InferenceSettingsService` (`./server`) and wire saves to their own
+ * permission-checked actions. The root entry stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentProps } from 'svelte';
+import InferenceSettingsPanel from './components/InferenceSettingsPanel.svelte';
+export { InferenceSettingsPanel };
+export type InferenceSettingsPanelProps = ComponentProps<typeof InferenceSettingsPanel>;
+export { candidateViewLabel, defaultTierRevertPreview, describeTargetView, INFERENCE_SETTINGS_MODES, INFERENCE_SETTINGS_TIERS, type InferenceAliasChange, type InferenceAliasView, type InferenceCandidateView, type InferenceConnectionRequest, type InferenceDefaultsChange, type InferenceDefaultsView, type InferenceDefaultTierChange, type InferenceDefaultTierView, type InferenceDiscoveryView, type InferenceFusionChange, type InferenceFusionView, type InferenceKeyChange, type InferenceProviderView, type InferenceSettingsLevelView, type InferenceSettingsMode, type InferenceSettingsScope, type InferenceSettingsTier, type InferenceTargetView, type InferenceTestResultView, type InferenceTierChange, type InferenceTierView, type InferenceUsageDimension, type InferenceUsageView, inferenceLevelLabel, isRefAllowed, targetViewRef, tierRevertPreview, usageColumns, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,sBAAsB,MAAM,4CAA4C,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACtD,OAAO,sBAAsB,CAC9B,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,14 @@
+/**
+ * @happyvertical/smrt-inference/svelte
+ *
+ * Optional Svelte 5 UI for inference settings (#4754). Presentational only:
+ * the panel takes rows and callbacks, does no fetching, and makes no
+ * authorization decision. Hosts render it from a server load that used
+ * `InferenceSettingsService` (`./server`) and wire saves to their own
+ * permission-checked actions. The root entry stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import InferenceSettingsPanel from './components/InferenceSettingsPanel.svelte';
+export { InferenceSettingsPanel };
+export { candidateViewLabel, defaultTierRevertPreview, describeTargetView, INFERENCE_SETTINGS_MODES, INFERENCE_SETTINGS_TIERS, inferenceLevelLabel, isRefAllowed, targetViewRef, tierRevertPreview, usageColumns, } from './types.js';

package/dist/svelte/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * 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;
+}
+/** Usage report (`reportAiUsage()`, #4751), structurally. */
+export interface InferenceUsageView {
+    by: string[];
+    costBasis?: string;
+    buckets: Array<{
+        key: Record<string, string | null | undefined>;
+        calls: number;
+        totalTokens: number;
+        estimatedCost: number;
+        uncostedCalls?: number;
+        outcomes?: Record<string, number>;
+    }>;
+}
+export type InferenceUsageDimension = 'model' | 'tier' | 'prompt';
+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;
+/** 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":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wBAAwB,6CAK3B,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,wBAAwB,4CAK3B,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,QAAQ,GACR,KAAK,GACL,QAAQ,CAAC;AACb,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,qBAAqB,CAAC;IACrC,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC1C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;QAC/C,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,UAAU,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,0BAA0B,GAAG,SAAS,GAC5C,MAAM,CAWR;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC7C,MAAM,CAYR;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,sBAAsB,GAAG,MAAM,CAK5E;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAMjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,OAAO,CAQT;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAGR;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,sBAAsB,GAC5B,qBAAqB,CAGvB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAE/D"}