@stigmer/react 3.2.3 → 3.4.0

package/pricing-governance/pricing-format.js

@@ -0,0 +1,50 @@
+import { PricingRateField } from "@stigmer/protos/ai/stigmer/billing/v1/pricing_override_pb";
+// ---------------------------------------------------------------------------
+// Shared money/label helpers for the platform-operator pricing surfaces
+// (PricingGovernanceConsole and the panels it grew out of). Internal —
+// not exported from the billing barrel.
+//
+// The UI works in dollars-per-million tokens; the protos store integer
+// micro-USD. Registry prices carry at most 4 decimal places, so the
+// round-trip through Math.round is exact.
+// ---------------------------------------------------------------------------
+// BigInt literals (0n) require an ES2020 target, which not every consuming
+// app's tsconfig guarantees — the constructor form is target-agnostic.
+export const ZERO = BigInt(0);
+/** Human labels for {@link PricingRateField} values. */
+export const RATE_FIELD_LABELS = {
+    [PricingRateField.input]: "Input",
+    [PricingRateField.output]: "Output",
+    [PricingRateField.cache_write]: "Cache write",
+    [PricingRateField.cache_read]: "Cache read",
+    [PricingRateField.cursor_token_rate]: "Cursor token rate",
+};
+/** Micro-USD per million tokens → "$X.XX/M" (raw provider rate). */
+export function formatRate(microsPerMillion) {
+    const dollars = Number(microsPerMillion) / 1_000_000;
+    return `$${dollars.toFixed(dollars < 1 ? 4 : 2)}/M`;
+}
+/** Basis points → signed percentage, e.g. 530n → "+5.30%". */
+export function formatDeltaBp(deltaBp) {
+    const pct = Number(deltaBp) / 100;
+    return `${pct > 0 ? "+" : ""}${pct.toFixed(2)}%`;
+}
+/** Micro-USD → editable dollar string, trailing zeros trimmed ("0.075"). */
+export function microsToDollarString(micros) {
+    if (micros === ZERO)
+        return "0";
+    const dollars = Number(micros) / 1_000_000;
+    // Trim trailing zeros without losing sub-cent precision (e.g. 0.075).
+    return String(parseFloat(dollars.toFixed(6)));
+}
+/** Parse a dollar input; returns null for anything that is not a finite, non-negative number. */
+export function dollarsToMicros(value) {
+    const trimmed = value.trim();
+    if (trimmed === "")
+        return null;
+    const parsed = Number(trimmed);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return null;
+    return BigInt(Math.round(parsed * 1_000_000));
+}
+//# sourceMappingURL=pricing-format.js.map

package/pricing-governance/pricing-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-format.js","sourceRoot":"","sources":["../../src/pricing-governance/pricing-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAE7F,8EAA8E;AAC9E,wEAAwE;AACxE,uEAAuE;AACvE,wCAAwC;AACxC,EAAE;AACF,uEAAuE;AACvE,oEAAoE;AACpE,0CAA0C;AAC1C,8EAA8E;AAE9E,2EAA2E;AAC3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAE9B,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,OAAO;IACjC,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ;IACnC,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,aAAa;IAC7C,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,YAAY;IAC3C,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,mBAAmB;CAC1D,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,gBAAwB;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACrD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;IAClC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C,sEAAsE;IACtE,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/pricing-governance/useDecidePricingOverride.d.ts

@@ -0,0 +1,46 @@
+import type { ModelPricingOverride } from "@stigmer/protos/ai/stigmer/billing/v1/pricing_override_pb";
+/** Input for {@link useDecidePricingOverride}. */
+export interface DecidePricingOverrideInput {
+    /** The PENDING_SIGNOFF override to decide. */
+    readonly overrideId: string;
+    /**
+     * `true` approves (the override becomes ACTIVE and supersedes any
+     * current ACTIVE override on the same pricing key); `false` rejects.
+     */
+    readonly approve: boolean;
+    /** Optional note recorded on the decision for the audit trail. */
+    readonly decisionNote?: string;
+}
+/** Return value of {@link useDecidePricingOverride}. */
+export interface UseDecidePricingOverrideReturn {
+    /**
+     * Decide a pending pricing override. Returns the decided override with
+     * the operator's identity stamped.
+     */
+    readonly decide: (input: DecidePricingOverrideInput) => Promise<ModelPricingOverride>;
+    /** `true` while a decision is being recorded. */
+    readonly isSubmitting: boolean;
+    /** Error from the last failed attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook for deciding PENDING_SIGNOFF pricing overrides from the
+ * pricing feedback loop.
+ *
+ * Wraps `billing.decideModelPricingOverride` with loading and error
+ * state. On approval the platform recomposes the effective registry
+ * immediately, so the parent should refetch its governance view after a
+ * successful decision.
+ *
+ * @example
+ * ```tsx
+ * const { decide, isSubmitting } = useDecidePricingOverride();
+ *
+ * await decide({ overrideId, approve: true, decisionNote: "Verified vs ledger" });
+ * refetchGovernance();
+ * ```
+ */
+export declare function useDecidePricingOverride(): UseDecidePricingOverrideReturn;
+//# sourceMappingURL=useDecidePricingOverride.d.ts.map

package/pricing-governance/useDecidePricingOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDecidePricingOverride.d.ts","sourceRoot":"","sources":["../../src/pricing-governance/useDecidePricingOverride.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAItG,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtF,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,IAAI,8BAA8B,CAyBzE"}

package/pricing-governance/useDecidePricingOverride.js

@@ -0,0 +1,44 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook for deciding PENDING_SIGNOFF pricing overrides from the
+ * pricing feedback loop.
+ *
+ * Wraps `billing.decideModelPricingOverride` with loading and error
+ * state. On approval the platform recomposes the effective registry
+ * immediately, so the parent should refetch its governance view after a
+ * successful decision.
+ *
+ * @example
+ * ```tsx
+ * const { decide, isSubmitting } = useDecidePricingOverride();
+ *
+ * await decide({ overrideId, approve: true, decisionNote: "Verified vs ledger" });
+ * refetchGovernance();
+ * ```
+ */
+export function useDecidePricingOverride() {
+    const stigmer = useStigmer();
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const decide = useCallback(async (input) => {
+        setIsSubmitting(true);
+        setError(null);
+        try {
+            return await stigmer.billing.decideModelPricingOverride(input);
+        }
+        catch (e) {
+            const err = toError(e);
+            setError(err);
+            throw err;
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    }, [stigmer.billing]);
+    const clearError = useCallback(() => setError(null), []);
+    return { decide, isSubmitting, error, clearError };
+}
+//# sourceMappingURL=useDecidePricingOverride.js.map

package/pricing-governance/useDecidePricingOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDecidePricingOverride.js","sourceRoot":"","sources":["../../src/pricing-governance/useDecidePricingOverride.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AA8BjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAiC,EAAiC,EAAE;QACzE,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,OAAO,CAAC,CAClB,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/pricing-governance/useModelGovernanceView.d.ts

@@ -0,0 +1,103 @@
+import { type ModelPricingBaseline } from "@stigmer/protos/ai/stigmer/billing/v1/model_pricing_baseline_pb";
+import type { ModelPricingGovernanceEntry } from "@stigmer/protos/ai/stigmer/billing/v1/io_pb";
+import type { ModelPricingOverride } from "@stigmer/protos/ai/stigmer/billing/v1/pricing_override_pb";
+/**
+ * One model in the unified governance view: the ACTIVE catalog baseline
+ * joined with its effective-registry governance state and its
+ * append-only revision history.
+ */
+export interface ModelGovernanceRow {
+    /** Stable identity: `modelId|provider|harness` (the catalog key). */
+    readonly key: string;
+    /** The ACTIVE baseline revision (catalog fields + list rates). */
+    readonly baseline: ModelPricingBaseline;
+    /**
+     * The base-variant governance entry (baseline vs effective rates,
+     * active overrides, ledger reconcilability), or `null` when the
+     * governance view has no entry for this key — the row then renders
+     * baseline rates with no governance state.
+     */
+    readonly governance: ModelPricingGovernanceEntry | null;
+    /** Governance entries for this model's named pricing variants. */
+    readonly variantGovernance: readonly ModelPricingGovernanceEntry[];
+    /** SUPERSEDED / RETIRED revisions, newest first as served. */
+    readonly history: readonly ModelPricingBaseline[];
+}
+/**
+ * Where the operator is in the console: browsing the model list,
+ * creating a new catalog entry, or focused on one model (viewing,
+ * editing, or retiring it).
+ */
+export type GovernanceFlow = {
+    readonly phase: "list";
+} | {
+    readonly phase: "create";
+} | {
+    readonly phase: "detail";
+    readonly modelKey: string;
+    readonly mode: "view" | "edit" | "retire";
+};
+/** Return value of {@link useModelGovernanceView}. */
+export interface UseModelGovernanceViewReturn {
+    /** Unified model rows, filtered by {@link modelQuery}, sorted by display name. */
+    readonly models: readonly ModelGovernanceRow[];
+    /** PENDING_SIGNOFF overrides, filtered by {@link signOffQuery}, oldest first as served. */
+    readonly pendingOverrides: readonly ModelPricingOverride[];
+    /** Unfiltered pending-override count (for the Sign-Offs tab badge). */
+    readonly pendingCount: number;
+    /** Current search text over the model list. */
+    readonly modelQuery: string;
+    /** Set the model-list search text. */
+    readonly setModelQuery: (query: string) => void;
+    /** Current search text over the sign-off queue. */
+    readonly signOffQuery: string;
+    /** Set the sign-off search text. */
+    readonly setSignOffQuery: (query: string) => void;
+    /** Current console flow state. */
+    readonly flow: GovernanceFlow;
+    /** The focused model when {@link flow} is in the detail phase, else `null`. */
+    readonly selected: ModelGovernanceRow | null;
+    /** Focus one model (read-only detail). */
+    readonly openDetail: (modelKey: string) => void;
+    /** Open the add-model editor. */
+    readonly openCreate: () => void;
+    /** Switch the focused model into the edit form. */
+    readonly openEdit: () => void;
+    /** Switch the focused model into the retire confirmation. */
+    readonly openRetire: () => void;
+    /** Leave edit/retire back to the read-only detail. */
+    readonly backToDetail: () => void;
+    /** Return to the model list. */
+    readonly backToList: () => void;
+    /** `true` while either underlying fetch is in its initial load. */
+    readonly isLoading: boolean;
+    /** First error from the underlying fetches, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Re-fetch both the catalog and the governance view. */
+    readonly refetch: () => void;
+}
+/**
+ * Behavior hook backing the pricing-governance console: joins the model
+ * registry baseline catalog ({@link useModelPricingBaselines}, with
+ * history) and the governance view ({@link usePricingGovernance}) into
+ * one row per catalog key, and owns the console's search and
+ * list/create/detail flow state.
+ *
+ * The two RPCs describe the same models from different angles — the
+ * catalog is what operators author, governance is what the pricing
+ * feedback loop composed on top — so the console renders them as one
+ * surface instead of two parallel tables. Per-variant governance
+ * entries fold into their model's row rather than appearing as
+ * top-level rows.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`; rates are raw provider prices (pre-markup).
+ *
+ * @example
+ * ```tsx
+ * const view = useModelGovernanceView();
+ * return view.models.map((row) => <ModelRow key={row.key} row={row} />);
+ * ```
+ */
+export declare function useModelGovernanceView(): UseModelGovernanceViewReturn;
+//# sourceMappingURL=useModelGovernanceView.d.ts.map

package/pricing-governance/useModelGovernanceView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelGovernanceView.d.ts","sourceRoot":"","sources":["../../src/pricing-governance/useModelGovernanceView.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAItG;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACxD,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACnE,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC3C,CAAC;AAEN,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAiBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAkKrE"}

package/pricing-governance/useModelGovernanceView.js

@@ -0,0 +1,144 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { ModelPricingBaselineStatus, } from "@stigmer/protos/ai/stigmer/billing/v1/model_pricing_baseline_pb";
+import { useModelPricingBaselines } from "./useModelPricingBaselines.js";
+import { usePricingGovernance } from "./usePricingGovernance.js";
+/** The catalog identity key shared by both data sources. */
+function modelKey(entry) {
+    return `${entry.modelId}|${entry.provider}|${entry.harness}`;
+}
+function matchesQuery(query, ...fields) {
+    const q = query.trim().toLowerCase();
+    if (q === "")
+        return true;
+    return fields.some((field) => field.toLowerCase().includes(q));
+}
+/**
+ * Behavior hook backing the pricing-governance console: joins the model
+ * registry baseline catalog ({@link useModelPricingBaselines}, with
+ * history) and the governance view ({@link usePricingGovernance}) into
+ * one row per catalog key, and owns the console's search and
+ * list/create/detail flow state.
+ *
+ * The two RPCs describe the same models from different angles — the
+ * catalog is what operators author, governance is what the pricing
+ * feedback loop composed on top — so the console renders them as one
+ * surface instead of two parallel tables. Per-variant governance
+ * entries fold into their model's row rather than appearing as
+ * top-level rows.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`; rates are raw provider prices (pre-markup).
+ *
+ * @example
+ * ```tsx
+ * const view = useModelGovernanceView();
+ * return view.models.map((row) => <ModelRow key={row.key} row={row} />);
+ * ```
+ */
+export function useModelGovernanceView() {
+    // History is always fetched so opening a detail view never triggers a
+    // second round-trip; the catalog is small (dozens of models) and this
+    // is an operator-only surface.
+    const baselinesFetch = useModelPricingBaselines({ includeHistory: true });
+    const governanceFetch = usePricingGovernance();
+    const [modelQuery, setModelQuery] = useState("");
+    const [signOffQuery, setSignOffQuery] = useState("");
+    const [flow, setFlow] = useState({ phase: "list" });
+    const rows = useMemo(() => {
+        const baselines = baselinesFetch.baselines ?? [];
+        const entries = governanceFetch.governance?.entries ?? [];
+        const baseByKey = new Map();
+        const variantsByKey = new Map();
+        for (const entry of entries) {
+            const key = modelKey(entry);
+            if (entry.variant === "") {
+                baseByKey.set(key, entry);
+            }
+            else {
+                variantsByKey.set(key, [...(variantsByKey.get(key) ?? []), entry]);
+            }
+        }
+        const historyByKey = new Map();
+        for (const baseline of baselines) {
+            if (baseline.status === ModelPricingBaselineStatus.pricing_baseline_active)
+                continue;
+            const key = modelKey(baseline);
+            historyByKey.set(key, [...(historyByKey.get(key) ?? []), baseline]);
+        }
+        return baselines
+            .filter((b) => b.status === ModelPricingBaselineStatus.pricing_baseline_active)
+            .map((baseline) => {
+            const key = modelKey(baseline);
+            return {
+                key,
+                baseline,
+                governance: baseByKey.get(key) ?? null,
+                variantGovernance: variantsByKey.get(key) ?? [],
+                history: historyByKey.get(key) ?? [],
+            };
+        })
+            .sort((a, b) => (a.baseline.displayName || a.baseline.modelId).localeCompare(b.baseline.displayName || b.baseline.modelId));
+    }, [baselinesFetch.baselines, governanceFetch.governance]);
+    const models = useMemo(() => rows.filter((row) => matchesQuery(modelQuery, row.baseline.modelId, row.baseline.displayName, row.baseline.provider, row.baseline.harness)), [rows, modelQuery]);
+    const allPending = useMemo(() => governanceFetch.governance?.pendingOverrides ?? [], [governanceFetch.governance]);
+    const pendingOverrides = useMemo(() => allPending.filter((override) => matchesQuery(signOffQuery, override.modelId, override.variant)), [allPending, signOffQuery]);
+    // Resolve the focused row fresh each render so a refetch (e.g. after an
+    // edit) is reflected in the open detail; a retired model resolves to
+    // null and the console falls back to the list.
+    const selected = useMemo(() => {
+        if (flow.phase !== "detail")
+            return null;
+        return rows.find((row) => row.key === flow.modelKey) ?? null;
+    }, [flow, rows]);
+    const openDetail = useCallback((key) => setFlow({ phase: "detail", modelKey: key, mode: "view" }), []);
+    const openCreate = useCallback(() => setFlow({ phase: "create" }), []);
+    const openEdit = useCallback(() => setFlow((f) => f.phase === "detail" ? { ...f, mode: "edit" } : f), []);
+    const openRetire = useCallback(() => setFlow((f) => f.phase === "detail" ? { ...f, mode: "retire" } : f), []);
+    const backToDetail = useCallback(() => setFlow((f) => f.phase === "detail" ? { ...f, mode: "view" } : f), []);
+    const backToList = useCallback(() => setFlow({ phase: "list" }), []);
+    const refetch = useCallback(() => {
+        baselinesFetch.refetch();
+        governanceFetch.refetch();
+    }, [baselinesFetch.refetch, governanceFetch.refetch]);
+    const isLoading = baselinesFetch.isLoading || governanceFetch.isLoading;
+    const error = baselinesFetch.error ?? governanceFetch.error;
+    return useMemo(() => ({
+        models,
+        pendingOverrides,
+        pendingCount: allPending.length,
+        modelQuery,
+        setModelQuery,
+        signOffQuery,
+        setSignOffQuery,
+        flow,
+        selected,
+        openDetail,
+        openCreate,
+        openEdit,
+        openRetire,
+        backToDetail,
+        backToList,
+        isLoading,
+        error,
+        refetch,
+    }), [
+        models,
+        pendingOverrides,
+        allPending.length,
+        modelQuery,
+        signOffQuery,
+        flow,
+        selected,
+        openDetail,
+        openCreate,
+        openEdit,
+        openRetire,
+        backToDetail,
+        backToList,
+        isLoading,
+        error,
+        refetch,
+    ]);
+}
+//# sourceMappingURL=useModelGovernanceView.js.map

package/pricing-governance/useModelGovernanceView.js.map

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

package/pricing-governance/useModelPricingBaselines.d.ts

@@ -0,0 +1,40 @@
+import type { ModelPricingBaseline } from "@stigmer/protos/ai/stigmer/billing/v1/model_pricing_baseline_pb";
+/** Options for {@link useModelPricingBaselines}. */
+export interface UseModelPricingBaselinesOptions {
+    /**
+     * When `true`, includes SUPERSEDED and RETIRED revisions (the full
+     * append-only audit history). Default: ACTIVE entries only.
+     */
+    readonly includeHistory?: boolean;
+    /** Pass `false` to skip fetching (stable no-op). */
+    readonly enabled?: boolean;
+}
+/** Return value of {@link useModelPricingBaselines}. */
+export interface UseModelPricingBaselinesReturn {
+    /** The catalog entries, or `null` before the first successful fetch. */
+    readonly baselines: readonly ModelPricingBaseline[] | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the model registry baseline catalog: the
+ * operator-governed catalog entries and list prices that (composed with
+ * any ledger-derived overrides) form the effective registry.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`, and the rates are raw provider prices
+ * (pre-markup) — never render them as customer prices.
+ *
+ * @example
+ * ```tsx
+ * const { baselines, isLoading, refetch } = useModelPricingBaselines();
+ * ```
+ */
+export declare function useModelPricingBaselines(options?: UseModelPricingBaselinesOptions): UseModelPricingBaselinesReturn;
+//# sourceMappingURL=useModelPricingBaselines.d.ts.map

package/pricing-governance/useModelPricingBaselines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelPricingBaselines.d.ts","sourceRoot":"","sources":["../../src/pricing-governance/useModelPricingBaselines.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACrB,MAAM,iEAAiE,CAAC;AAIzE,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAAC;IAC3D,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,+BAA+B,GACxC,8BAA8B,CAmBhC"}

package/pricing-governance/useModelPricingBaselines.js

@@ -0,0 +1,32 @@
+"use client";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that fetches the model registry baseline catalog: the
+ * operator-governed catalog entries and list prices that (composed with
+ * any ledger-derived overrides) form the effective registry.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`, and the rates are raw provider prices
+ * (pre-markup) — never render them as customer prices.
+ *
+ * @example
+ * ```tsx
+ * const { baselines, isLoading, refetch } = useModelPricingBaselines();
+ * ```
+ */
+export function useModelPricingBaselines(options) {
+    const stigmer = useStigmer();
+    const enabled = options?.enabled ?? true;
+    const includeHistory = options?.includeHistory ?? false;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(enabled
+        ? async () => {
+            const response = await stigmer.billing.listModelPricingBaselines({
+                includeHistory,
+            });
+            return response.baselines;
+        }
+        : null, [enabled, includeHistory, stigmer], null);
+    return { baselines: data, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useModelPricingBaselines.js.map

package/pricing-governance/useModelPricingBaselines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelPricingBaselines.js","sourceRoot":"","sources":["../../src/pricing-governance/useModelPricingBaselines.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA2BnD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAyC;IAEzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;IAExD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAChE,OAAO;QACL,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC;gBAC/D,cAAc;aACf,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,SAAS,CAAC;QAC5B,CAAC;QACH,CAAC,CAAC,IAAI,EACR,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAClC,IAA8C,CAC/C,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtE,CAAC"}

package/pricing-governance/usePricingGovernance.d.ts

@@ -0,0 +1,39 @@
+import type { ModelPricingGovernanceResponse } from "@stigmer/protos/ai/stigmer/billing/v1/io_pb";
+/** Return value of {@link usePricingGovernance}. */
+export interface UsePricingGovernanceReturn {
+    /** The governance view, or `null` before the first successful fetch. */
+    readonly governance: ModelPricingGovernanceResponse | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the platform pricing governance view: every
+ * model's baseline vs effective rates, the ACTIVE pricing overrides
+ * composed into them (with full ledger provenance), and the
+ * PENDING_SIGNOFF proposals awaiting an operator decision.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`, and the rates are raw provider prices
+ * (pre-markup) — never render them as customer prices.
+ *
+ * Pass `enabled: false` to skip fetching (stable no-op) — e.g. while the
+ * caller's operator capability is still resolving.
+ *
+ * @example
+ * ```tsx
+ * const { governance, isLoading, refetch } = usePricingGovernance();
+ *
+ * if (isLoading) return <Skeleton />;
+ * return <PricingGovernancePanel />;
+ * ```
+ */
+export declare function usePricingGovernance(options?: {
+    readonly enabled?: boolean;
+}): UsePricingGovernanceReturn;
+//# sourceMappingURL=usePricingGovernance.d.ts.map

package/pricing-governance/usePricingGovernance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePricingGovernance.d.ts","sourceRoot":"","sources":["../../src/pricing-governance/usePricingGovernance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,8BAA8B,EAC/B,MAAM,6CAA6C,CAAC;AAIrD,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC3D,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,0BAA0B,CAW5B"}

package/pricing-governance/usePricingGovernance.js

@@ -0,0 +1,31 @@
+"use client";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that fetches the platform pricing governance view: every
+ * model's baseline vs effective rates, the ACTIVE pricing overrides
+ * composed into them (with full ledger provenance), and the
+ * PENDING_SIGNOFF proposals awaiting an operator decision.
+ *
+ * Platform-operator surface: the caller needs `can_manage_model_pricing`
+ * on `platform:stigmer`, and the rates are raw provider prices
+ * (pre-markup) — never render them as customer prices.
+ *
+ * Pass `enabled: false` to skip fetching (stable no-op) — e.g. while the
+ * caller's operator capability is still resolving.
+ *
+ * @example
+ * ```tsx
+ * const { governance, isLoading, refetch } = usePricingGovernance();
+ *
+ * if (isLoading) return <Skeleton />;
+ * return <PricingGovernancePanel />;
+ * ```
+ */
+export function usePricingGovernance(options) {
+    const stigmer = useStigmer();
+    const enabled = options?.enabled ?? true;
+    const { data: governance, isLoading, isRefetching, error, refetch } = useFetch(enabled ? () => stigmer.billing.getModelPricingGovernance() : null, [enabled, stigmer], null);
+    return { governance, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=usePricingGovernance.js.map

package/pricing-governance/usePricingGovernance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePricingGovernance.js","sourceRoot":"","sources":["../../src/pricing-governance/usePricingGovernance.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAgBnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwC;IAExC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IAEzC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC5E,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC,IAAI,EAClE,CAAC,OAAO,EAAE,OAAO,CAAC,EAClB,IAA6C,CAC9C,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/pricing-governance/useRetireModelPricingBaseline.d.ts

@@ -0,0 +1,31 @@
+import type { ModelPricingBaseline } from "@stigmer/protos/ai/stigmer/billing/v1/model_pricing_baseline_pb";
+/** Input for {@link useRetireModelPricingBaseline}. */
+export interface RetireModelPricingBaselineInput {
+    readonly modelId: string;
+    readonly provider: string;
+    readonly harness: string;
+    /** Optional operator note recorded on the retirement. */
+    readonly revisionNote?: string;
+}
+/** Return value of {@link useRetireModelPricingBaseline}. */
+export interface UseRetireModelPricingBaselineReturn {
+    /** Retire a model from the catalog. Returns the RETIRED document. */
+    readonly retire: (input: RetireModelPricingBaselineInput) => Promise<ModelPricingBaseline>;
+    /** `true` while a retirement is being recorded. */
+    readonly isSubmitting: boolean;
+    /** Error from the last failed attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook for retiring models from the registry catalog.
+ *
+ * Wraps `billing.retireModelPricingBaseline` with loading and error
+ * state. Retirement removes the model from every price surface on the
+ * next composition pass; the document is kept for audit and the key can
+ * be revived by a subsequent upsert. The parent should refetch its
+ * catalog view after a successful retirement.
+ */
+export declare function useRetireModelPricingBaseline(): UseRetireModelPricingBaselineReturn;
+//# sourceMappingURL=useRetireModelPricingBaseline.d.ts.map

package/pricing-governance/useRetireModelPricingBaseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRetireModelPricingBaseline.d.ts","sourceRoot":"","sources":["../../src/pricing-governance/useRetireModelPricingBaseline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACrB,MAAM,iEAAiE,CAAC;AAIzE,uDAAuD;AACvD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,6DAA6D;AAC7D,MAAM,WAAW,mCAAmC;IAClD,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,IAAI,mCAAmC,CAyBnF"}