@stigmer/react 0.2.3 → 0.3.1

package/models/__tests__/harness.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from "vitest";
+import { Harness } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+import { toProtoHarness, fromProtoHarness, DEFAULT_HARNESS, HARNESS_LABELS, } from "../harness";
+describe("harness constants", () => {
+    it("defaults to native harness", () => {
+        expect(DEFAULT_HARNESS).toBe("native");
+    });
+    it("provides user-facing labels for both options", () => {
+        expect(HARNESS_LABELS.native).toBe("Stigmer");
+        expect(HARNESS_LABELS.cursor).toBe("Cursor");
+    });
+    it("covers every HarnessOption in HARNESS_LABELS", () => {
+        const options = ["native", "cursor"];
+        for (const opt of options) {
+            expect(HARNESS_LABELS[opt]).toBeDefined();
+            expect(typeof HARNESS_LABELS[opt]).toBe("string");
+        }
+    });
+});
+describe("toProtoHarness", () => {
+    it("maps native to Harness.NATIVE", () => {
+        expect(toProtoHarness("native")).toBe(Harness.NATIVE);
+    });
+    it("maps cursor to Harness.CURSOR", () => {
+        expect(toProtoHarness("cursor")).toBe(Harness.CURSOR);
+    });
+});
+describe("fromProtoHarness", () => {
+    it("maps Harness.NATIVE to native", () => {
+        expect(fromProtoHarness(Harness.NATIVE)).toBe("native");
+    });
+    it("maps Harness.CURSOR to cursor", () => {
+        expect(fromProtoHarness(Harness.CURSOR)).toBe("cursor");
+    });
+    it("maps Harness.UNSPECIFIED to native (safe default)", () => {
+        expect(fromProtoHarness(Harness.UNSPECIFIED)).toBe("native");
+    });
+    it("maps unknown numeric values to native (safe default)", () => {
+        expect(fromProtoHarness(999)).toBe("native");
+    });
+});
+describe("round-trip conversion", () => {
+    it("native survives toProto -> fromProto", () => {
+        expect(fromProtoHarness(toProtoHarness("native"))).toBe("native");
+    });
+    it("cursor survives toProto -> fromProto", () => {
+        expect(fromProtoHarness(toProtoHarness("cursor"))).toBe("cursor");
+    });
+});
+//# sourceMappingURL=harness.test.js.map

package/models/__tests__/harness.test.js.map

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

package/models/__tests__/useModelRegistry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useModelRegistry.test.d.ts.map

package/models/__tests__/useModelRegistry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelRegistry.test.d.ts","sourceRoot":"","sources":["../../../src/models/__tests__/useModelRegistry.test.tsx"],"names":[],"mappings":""}

package/models/__tests__/useModelRegistry.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect } from "vitest";
+import { renderHook } from "@testing-library/react";
+import { useModelRegistry } from "../useModelRegistry";
+import { MODEL_REGISTRY, DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PROVIDERS, modelKey, } from "../registry";
+describe("useModelRegistry", () => {
+    describe("unified mode (no harness)", () => {
+        it("excludes DISABLED_PROVIDERS from models", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            for (const model of result.current.models) {
+                expect(DISABLED_PROVIDERS.has(model.provider)).toBe(false);
+            }
+        });
+        it("includes models from both native and cursor harnesses", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const harnesses = new Set(result.current.models.map((m) => m.harness));
+            expect(harnesses.has("native")).toBe(true);
+            expect(harnesses.has("cursor")).toBe(true);
+        });
+        it("includes all non-disabled models from MODEL_REGISTRY", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const expected = MODEL_REGISTRY.filter((m) => !DISABLED_PROVIDERS.has(m.provider));
+            expect(result.current.models).toHaveLength(expected.length);
+        });
+        it("resolves defaultModel to DEFAULT_MODEL_ID", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            expect(result.current.defaultModel.modelId).toBe(DEFAULT_MODEL_ID);
+        });
+        it("groups models by provider in byProvider map", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            for (const [provider, models] of result.current.byProvider) {
+                for (const m of models) {
+                    expect(m.provider).toBe(provider);
+                }
+            }
+        });
+        it("returns providers matching byProvider keys in order", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const fromMap = Array.from(result.current.byProvider.keys());
+            expect(result.current.providers).toEqual(fromMap);
+        });
+        it("looks up enabled models by getModel", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const model = result.current.getModel(DEFAULT_MODEL_ID);
+            expect(model).toBeDefined();
+            expect(model.modelId).toBe(DEFAULT_MODEL_ID);
+        });
+        it("returns undefined for disabled provider models via getModel", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const disabledModel = MODEL_REGISTRY.find((m) => DISABLED_PROVIDERS.has(m.provider));
+            if (disabledModel) {
+                expect(result.current.getModel(disabledModel.modelId)).toBeUndefined();
+            }
+        });
+        it("returns undefined for unknown model IDs via getModel", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            expect(result.current.getModel("nonexistent-model")).toBeUndefined();
+        });
+        it("returns featured models subset", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            expect(result.current.featured.length).toBeGreaterThan(0);
+            for (const model of result.current.featured) {
+                expect(model.featured).toBe(true);
+            }
+        });
+        it("featured models are a subset of all models", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const allKeys = new Set(result.current.models.map((m) => modelKey(m.harness, m.modelId)));
+            for (const model of result.current.featured) {
+                expect(allKeys.has(modelKey(model.harness, model.modelId))).toBe(true);
+            }
+        });
+        it("resolves models by compound key via getByKey", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const key = modelKey("native", DEFAULT_MODEL_ID);
+            const model = result.current.getByKey(key);
+            expect(model).toBeDefined();
+            expect(model.modelId).toBe(DEFAULT_MODEL_ID);
+            expect(model.harness).toBe("native");
+        });
+        it("resolves cursor models by compound key via getByKey", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            const key = modelKey("cursor", DEFAULT_CURSOR_MODEL_ID);
+            const model = result.current.getByKey(key);
+            expect(model).toBeDefined();
+            expect(model.modelId).toBe(DEFAULT_CURSOR_MODEL_ID);
+            expect(model.harness).toBe("cursor");
+        });
+        it("returns undefined for unknown compound keys via getByKey", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            expect(result.current.getByKey("native/nonexistent")).toBeUndefined();
+        });
+    });
+    describe("native harness (explicit)", () => {
+        it("shows only native-harness models", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "native" }));
+            for (const model of result.current.models) {
+                expect(model.harness).toBe("native");
+            }
+        });
+        it("excludes cursor-harness models", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "native" }));
+            const cursorModels = result.current.models.filter((m) => m.harness === "cursor");
+            expect(cursorModels).toHaveLength(0);
+        });
+        it("resolves defaultModel to DEFAULT_MODEL_ID", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "native" }));
+            expect(result.current.defaultModel.modelId).toBe(DEFAULT_MODEL_ID);
+        });
+    });
+    describe("cursor harness", () => {
+        it("shows only cursor-harness models", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            for (const model of result.current.models) {
+                expect(model.harness).toBe("cursor");
+            }
+        });
+        it("includes cursor-harness models from multiple providers", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            const providers = new Set(result.current.models.map((m) => m.provider));
+            expect(providers.size).toBeGreaterThan(1);
+        });
+        it("includes all cursor-harness models from MODEL_REGISTRY", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            const cursorModels = MODEL_REGISTRY.filter((m) => m.harness === "cursor");
+            expect(result.current.models).toHaveLength(cursorModels.length);
+        });
+        it("resolves defaultModel to DEFAULT_CURSOR_MODEL_ID", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            expect(result.current.defaultModel.modelId).toBe(DEFAULT_CURSOR_MODEL_ID);
+        });
+        it("looks up cursor models via getModel", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            expect(result.current.getModel(DEFAULT_CURSOR_MODEL_ID)).toBeDefined();
+        });
+        it("cannot look up native-only models via getModel", () => {
+            const { result } = renderHook(() => useModelRegistry({ harness: "cursor" }));
+            expect(result.current.getModel(DEFAULT_MODEL_ID)).toBeUndefined();
+        });
+    });
+    describe("defaultModel fallback", () => {
+        it("falls back to the first enabled model when default ID is missing", () => {
+            const { result } = renderHook(() => useModelRegistry());
+            expect(result.current.defaultModel).toBeDefined();
+            expect(result.current.models).toContain(result.current.defaultModel);
+        });
+    });
+});
+//# sourceMappingURL=useModelRegistry.test.js.map

package/models/__tests__/useModelRegistry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelRegistry.test.js","sourceRoot":"","sources":["../../../src/models/__tests__/useModelRegistry.test.tsx"],"names":[],"mappings":"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"}

package/models/harness.d.ts

@@ -0,0 +1,21 @@
+import { Harness } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+/**
+ * String literal alias for the proto {@link Harness} enum.
+ *
+ * Used on component props and hook options so platform builders
+ * do not need to import proto enums to use the SDK.
+ */
+export type HarnessOption = "native" | "cursor";
+/** User-facing labels for each harness option. */
+export declare const HARNESS_LABELS: Readonly<Record<HarnessOption, string>>;
+/** Platform default — resolves to the native engine. */
+export declare const DEFAULT_HARNESS: HarnessOption;
+/** Convert a {@link HarnessOption} string to the proto {@link Harness} enum. */
+export declare function toProtoHarness(h: HarnessOption): Harness;
+/**
+ * Convert a proto {@link Harness} enum to a {@link HarnessOption} string.
+ *
+ * `UNSPECIFIED` and any unknown values map to `"native"`.
+ */
+export declare function fromProtoHarness(h: Harness): HarnessOption;
+//# sourceMappingURL=harness.d.ts.map

package/models/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/models/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uDAAuD,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,kDAAkD;AAClD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAGlE,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,eAAe,EAAE,aAAwB,CAAC;AAEvD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAS1D"}

package/models/harness.js

@@ -0,0 +1,34 @@
+import { Harness } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+/** User-facing labels for each harness option. */
+export const HARNESS_LABELS = {
+    native: "Stigmer",
+    cursor: "Cursor",
+};
+/** Platform default — resolves to the native engine. */
+export const DEFAULT_HARNESS = "native";
+/** Convert a {@link HarnessOption} string to the proto {@link Harness} enum. */
+export function toProtoHarness(h) {
+    switch (h) {
+        case "cursor":
+            return Harness.CURSOR;
+        case "native":
+        default:
+            return Harness.NATIVE;
+    }
+}
+/**
+ * Convert a proto {@link Harness} enum to a {@link HarnessOption} string.
+ *
+ * `UNSPECIFIED` and any unknown values map to `"native"`.
+ */
+export function fromProtoHarness(h) {
+    switch (h) {
+        case Harness.CURSOR:
+            return "cursor";
+        case Harness.NATIVE:
+        case Harness.UNSPECIFIED:
+        default:
+            return "native";
+    }
+}
+//# sourceMappingURL=harness.js.map

package/models/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/models/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uDAAuD,CAAC;AAUhF,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAA4C;IACrE,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAkB,QAAQ,CAAC;AAEvD,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,CAAgB;IAC7C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,OAAO,CAAC,MAAM;YACjB,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO,CAAC,MAAM,CAAC;QACpB,KAAK,OAAO,CAAC,WAAW,CAAC;QACzB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/models/index.d.ts

@@ -1,7 +1,12 @@
-export { MODEL_REGISTRY, DEFAULT_MODEL_ID, DISABLED_PROVIDERS } from "./registry";
+export { MODEL_REGISTRY, DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PROVIDERS, modelKey, parseModelKey } from "./registry";
+export type { ParsedModelKey } from "./registry";
 export type { ModelInfo, Provider, CostTier } from "./registry";
 export { useModelRegistry } from "./useModelRegistry";
-export type { UseModelRegistryReturn } from "./useModelRegistry";
+export type { UseModelRegistryReturn, UseModelRegistryOptions } from "./useModelRegistry";
 export { ModelSelector } from "./ModelSelector";
 export type { ModelSelectorProps } from "./ModelSelector";
+export { HarnessSelector } from "./HarnessSelector";
+export type { HarnessSelectorProps } from "./HarnessSelector";
+export { DEFAULT_HARNESS, HARNESS_LABELS, toProtoHarness, fromProtoHarness } from "./harness";
+export type { HarnessOption } from "./harness";
 //# sourceMappingURL=index.d.ts.map

package/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpI,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/models/index.js

@@ -1,4 +1,6 @@
-export { MODEL_REGISTRY, DEFAULT_MODEL_ID, DISABLED_PROVIDERS } from "./registry";
+export { MODEL_REGISTRY, DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PROVIDERS, modelKey, parseModelKey } from "./registry";
 export { useModelRegistry } from "./useModelRegistry";
 export { ModelSelector } from "./ModelSelector";
+export { HarnessSelector } from "./HarnessSelector";
+export { DEFAULT_HARNESS, HARNESS_LABELS, toProtoHarness, fromProtoHarness } from "./harness";
 //# sourceMappingURL=index.js.map

package/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpI,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/models/registry.d.ts

@@ -1,14 +1,13 @@
 /**
  * Model registry — UI-relevant metadata for all platform-supported LLM models.
  *
- * Ported from the Python source of truth at
- * backend/libs/python/graphton/src/graphton/core/model_registry.py.
+ * Reads from the unified JSON registry at backend/libs/model-registry.json,
+ * which is the single source of truth for model IDs, display names, pricing,
+ * and cost tiers across all harnesses and runtimes.
  *
- * This is a static, hardcoded list. A future backend RPC will replace it
- * with a dynamic query; when that happens consumers will only need to
- * swap from the static constant to a fetched result — the shape stays
- * the same.
+ * Update it with: @update-model-registry
  */
+import type { HarnessOption } from "./harness";
 /**
  * Pricing bracket for a model.
  *
@@ -19,10 +18,11 @@
 export type CostTier = "economy" | "standard" | "premium";
 /**
  * LLM provider identifier. Each provider maps to a distinct inference
- * backend. The {@link MODEL_REGISTRY} groups models by provider for
- * display in {@link ModelSelector}.
+ * backend (or intermediary, in the case of Cursor-served third-party
+ * models). The {@link MODEL_REGISTRY} uses this for grouping in the
+ * "Show All" expanded view.
  */
-export type Provider = "anthropic" | "openai" | "ollama";
+export type Provider = "anthropic" | "openai" | "google" | "xai" | "cursor" | "moonshot" | "ollama";
 /**
  * Providers whose models should be hidden from the UI.
  *
@@ -49,19 +49,59 @@ export interface ModelInfo {
     readonly modelId: string;
     /** LLM provider that serves this model. */
     readonly provider: Provider;
-    /** Human-readable name shown in the {@link ModelSelector} dropdown. */
+    /** Human-readable name shown in the model picker. */
     readonly displayName: string;
     /** Pricing bracket used for cost-tier indicators in the UI. */
     readonly costTier: CostTier;
+    /** Which execution engine serves this model. */
+    readonly harness: HarnessOption;
+    /**
+     * When `true`, appears in the curated default list (the short view
+     * before "Show All Models" is expanded or search is used).
+     */
+    readonly featured: boolean;
 }
 /**
- * Static catalog of all platform-supported LLM models.
+ * Per-model cost entry for programmatic access to pricing data.
+ * Re-exported for consumers that need dollar-level pricing beyond the
+ * coarse `CostTier` label.
+ */
+export interface ModelCostEntry {
+    readonly modelId: string;
+    readonly inputPricePerMillion: number;
+    readonly outputPricePerMillion: number;
+    readonly cacheWritePricePerMillion: number;
+    readonly cacheReadPricePerMillion: number;
+}
+/**
+ * Build a compound key that uniquely identifies a model across harnesses.
+ *
+ * The same underlying model name (e.g. `claude-4.6-sonnet`) can exist in
+ * both native and cursor harnesses. The compound key disambiguates.
+ */
+export declare function modelKey(harness: HarnessOption, modelId: string): string;
+/** Parsed result of a compound `harness/modelId` key. */
+export interface ParsedModelKey {
+    /** Harness portion of the compound key. */
+    harness: HarnessOption;
+    /** Model ID portion of the compound key. */
+    modelId: string;
+}
+/**
+ * Parse a compound key back into its `(harness, modelId)` parts.
+ * Returns `undefined` for malformed keys.
+ */
+export declare function parseModelKey(key: string): ParsedModelKey | undefined;
+/**
+ * Static catalog of all platform-supported LLM models, loaded from the
+ * unified JSON registry.
  *
- * Each entry carries the metadata needed for model selection UI.
  * {@link useModelRegistry} filters out disabled providers and provides
  * lookup helpers on top of this list.
  */
 export declare const MODEL_REGISTRY: readonly ModelInfo[];
-/** Model ID used when no user preference is set. */
+/** Model ID used when no user preference is set (native harness). */
 export declare const DEFAULT_MODEL_ID = "claude-sonnet-4.5";
+/** Model ID used when the Cursor harness is selected and no user preference is set. */
+export declare const DEFAULT_CURSOR_MODEL_ID = "default";
 //# sourceMappingURL=registry.d.ts.map

package/models/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,QAAQ,CAGnD,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAkCrC,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,sBAAsB,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,QAAQ,CAEnD,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAMrE;AAmCD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAW1C,CAAC;AAEN,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,YAAY,CAAC"}

package/models/registry.js

@@ -1,14 +1,13 @@
 /**
  * Model registry — UI-relevant metadata for all platform-supported LLM models.
  *
- * Ported from the Python source of truth at
- * backend/libs/python/graphton/src/graphton/core/model_registry.py.
+ * Reads from the unified JSON registry at backend/libs/model-registry.json,
+ * which is the single source of truth for model IDs, display names, pricing,
+ * and cost tiers across all harnesses and runtimes.
  *
- * This is a static, hardcoded list. A future backend RPC will replace it
- * with a dynamic query; when that happens consumers will only need to
- * swap from the static constant to a fetched result — the shape stays
- * the same.
+ * Update it with: @update-model-registry
  */
+import registryData from "../../data/model-registry.json";
 /**
  * Providers whose models should be hidden from the UI.
  *
@@ -19,46 +18,58 @@
  * To re-enable a provider, simply remove it from this set.
  */
 export const DISABLED_PROVIDERS = new Set([
-    "openai",
     "ollama",
 ]);
 /**
- * Static catalog of all platform-supported LLM models.
+ * Build a compound key that uniquely identifies a model across harnesses.
+ *
+ * The same underlying model name (e.g. `claude-4.6-sonnet`) can exist in
+ * both native and cursor harnesses. The compound key disambiguates.
+ */
+export function modelKey(harness, modelId) {
+    return `${harness}/${modelId}`;
+}
+/**
+ * Parse a compound key back into its `(harness, modelId)` parts.
+ * Returns `undefined` for malformed keys.
+ */
+export function parseModelKey(key) {
+    const idx = key.indexOf("/");
+    if (idx < 1)
+        return undefined;
+    const harness = key.slice(0, idx);
+    if (harness !== "native" && harness !== "cursor")
+        return undefined;
+    return { harness, modelId: key.slice(idx + 1) };
+}
+const VALID_COST_TIERS = new Set(["economy", "standard", "premium"]);
+const VALID_HARNESSES = new Set(["native", "cursor"]);
+function isModelEntry(entry) {
+    return (typeof entry.id === "string" &&
+        typeof entry.displayName === "string" &&
+        typeof entry.provider === "string" &&
+        typeof entry.harness === "string" && VALID_HARNESSES.has(entry.harness) &&
+        typeof entry.costTier === "string" && VALID_COST_TIERS.has(entry.costTier));
+}
+/**
+ * Static catalog of all platform-supported LLM models, loaded from the
+ * unified JSON registry.
  *
- * Each entry carries the metadata needed for model selection UI.
  * {@link useModelRegistry} filters out disabled providers and provides
  * lookup helpers on top of this list.
  */
-export const MODEL_REGISTRY = [
-    // ── Anthropic — Generation 4.6 ────────────────────────────────────
-    { modelId: "claude-opus-4.6", provider: "anthropic", displayName: "Claude Opus 4.6", costTier: "premium" },
-    { modelId: "claude-sonnet-4.6", provider: "anthropic", displayName: "Claude Sonnet 4.6", costTier: "standard" },
-    // ── Anthropic — Generation 4.5 ────────────────────────────────────
-    { modelId: "claude-opus-4.5", provider: "anthropic", displayName: "Claude Opus 4.5", costTier: "premium" },
-    { modelId: "claude-sonnet-4.5", provider: "anthropic", displayName: "Claude Sonnet 4.5", costTier: "standard" },
-    // ── Anthropic — Generation 4 ──────────────────────────────────────
-    { modelId: "claude-opus-4", provider: "anthropic", displayName: "Claude Opus 4", costTier: "premium" },
-    { modelId: "claude-haiku-4.5", provider: "anthropic", displayName: "Claude Haiku 4.5", costTier: "economy" },
-    // ── Anthropic — Generation 3.5 ────────────────────────────────────
-    { modelId: "claude-sonnet-3.5", provider: "anthropic", displayName: "Claude Sonnet 3.5", costTier: "standard" },
-    { modelId: "claude-haiku-3.5", provider: "anthropic", displayName: "Claude Haiku 3.5", costTier: "economy" },
-    // ── OpenAI ────────────────────────────────────────────────────────
-    { modelId: "gpt-4", provider: "openai", displayName: "GPT-4", costTier: "premium" },
-    { modelId: "gpt-4-turbo", provider: "openai", displayName: "GPT-4 Turbo", costTier: "standard" },
-    { modelId: "gpt-4o", provider: "openai", displayName: "GPT-4o", costTier: "standard" },
-    { modelId: "gpt-4o-mini", provider: "openai", displayName: "GPT-4o Mini", costTier: "economy" },
-    { modelId: "gpt-3.5-turbo", provider: "openai", displayName: "GPT-3.5 Turbo", costTier: "economy" },
-    { modelId: "o1", provider: "openai", displayName: "o1", costTier: "premium" },
-    { modelId: "o1-mini", provider: "openai", displayName: "o1 Mini", costTier: "standard" },
-    // ── Ollama (local, no cost) ───────────────────────────────────────
-    { modelId: "qwen2.5-coder:7b", provider: "ollama", displayName: "Qwen 2.5 Coder 7B", costTier: "economy" },
-    { modelId: "qwen2.5-coder:14b", provider: "ollama", displayName: "Qwen 2.5 Coder 14B", costTier: "economy" },
-    { modelId: "codellama:7b", provider: "ollama", displayName: "Code Llama 7B", costTier: "economy" },
-    { modelId: "codellama:13b", provider: "ollama", displayName: "Code Llama 13B", costTier: "economy" },
-    { modelId: "deepseek-coder-v2:16b", provider: "ollama", displayName: "DeepSeek Coder V2 16B", costTier: "economy" },
-    { modelId: "llama3.2:3b", provider: "ollama", displayName: "Llama 3.2 3B", costTier: "economy" },
-    { modelId: "mistral:7b", provider: "ollama", displayName: "Mistral 7B", costTier: "economy" },
-];
-/** Model ID used when no user preference is set. */
+export const MODEL_REGISTRY = registryData.models
+    .filter(isModelEntry)
+    .map((m) => ({
+    modelId: m.id,
+    provider: m.provider,
+    displayName: m.displayName,
+    costTier: m.costTier,
+    harness: m.harness,
+    featured: m.featured ?? false,
+}));
+/** Model ID used when no user preference is set (native harness). */
 export const DEFAULT_MODEL_ID = "claude-sonnet-4.5";
+/** Model ID used when the Cursor harness is selected and no user preference is set. */
+export const DEFAULT_CURSOR_MODEL_ID = "default";
 //# sourceMappingURL=registry.js.map

package/models/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,YAAY,MAAM,gCAAgC,CAAC;AA0B1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B,IAAI,GAAG,CAAC;IAC/D,QAAQ;CACT,CAAC,CAAC;AA4CH;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAsB,EAAE,OAAe;IAC9D,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;AACjC,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAsBD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AACrE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtD,SAAS,YAAY,CAAC,KAAwB;IAC5C,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;QACvE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,YAAY,CAAC,MACd;KACE,MAAM,CAAC,YAAY,CAAC;KACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,QAAoB;IAChC,WAAW,EAAE,CAAC,CAAC,WAAW;IAC1B,QAAQ,EAAE,CAAC,CAAC,QAAoB;IAChC,OAAO,EAAE,CAAC,CAAC,OAAwB;IACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;CAC9B,CAAC,CAAC,CAAC;AAEN,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEpD,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC"}