@ai-matrx/chat 0.3.33 → 0.4.2

package/dist/agents/hooks/useModelControls.d.ts

@@ -2,7 +2,7 @@
  * Hook to parse and normalize model controls from dynamic API data
  * Keeps snake_case naming for compatibility with Python backend
  */
-import type { ModelClassControls } from "../../host/model-class.js";
+import type { ModelClassControls } from "../identity/model-catalog.js";
 import type { AIModelRecord } from "../redux/model-registry.js";
 export interface ControlDefinition {
     type: "number" | "integer" | "boolean" | "string" | "enum" | "array" | "string_array" | "object_array";
@@ -160,89 +160,11 @@ export declare function useModelControls(models: AIModelRecord[], selectedModelI
     error: string;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: null;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: string;
 };
 /**
@@ -265,89 +187,11 @@ export declare function resolveModelControls(models: AIModelRecord[], selectedMo
     error: string;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: null;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: string;
 };
 /**

package/dist/agents/identity/model-catalog.d.ts

@@ -0,0 +1,37 @@
+import { type ModelCatalog, type ModelClassConfig, type ModelRecord, type ModelRecords, type ModelRecordsState } from "@ai-matrx/agents/models";
+export declare function getModelCatalog(): ModelCatalog;
+export declare const getModelRecords: () => ModelRecords;
+/** The records state now. A host with no database bound yet (a unit test) reads empty. */
+export declare function readModelRecords(): ModelRecordsState;
+/** Subscribe to a slice of the records. `select` must return a stable value for unchanged state. */
+export declare function useModelRecords<T>(select: (state: ModelRecordsState) => T): T;
+/** One model's record (options or full); reads the full record when `full` and it is missing. */
+export declare function useModelRecord(modelId: string | null | undefined, options?: {
+    full?: boolean;
+}): ModelRecord | undefined;
+/** A model's display label; loads the options list (then the identity) when it is unknown. */
+export declare function useModelLabel(modelId: string | null | undefined): string | undefined;
+/** "Qwen3.8 27B · Matrx Lightning" when the model has several classes; loads the class index once. */
+export declare function useModelLabelWithClass(modelId: string | null | undefined, offeringId: string | null | undefined): string | undefined;
+/** Loads every model's classes once (no-op after the first success). */
+export declare function useModelClassLabels(): void;
+/**
+ * The resolved controls for the CLASS a model runs on. With a pin it loads that class's controls;
+ * without one it answers `undefined` and callers keep the model's own (preferred-class) controls.
+ * `{ pending: true }` while it loads, `{ failed: true }` when the pin is refused — never another
+ * class's controls.
+ */
+export type ModelClassControls = undefined | {
+    pending: true;
+    failed?: false;
+    config?: undefined;
+} | {
+    pending?: false;
+    failed: true;
+    config?: undefined;
+} | {
+    pending?: false;
+    failed?: false;
+    config: ModelClassConfig;
+};
+export declare function useModelClassControls(modelId: string | null | undefined, offeringId: string | null | undefined): ModelClassControls;

package/dist/agents/identity/model-catalog.js

@@ -0,0 +1,105 @@
+"use client";
+import { useEffect } from "react";
+import {
+  classConfigKey,
+  createModelCatalog,
+  EMPTY_MODEL_RECORDS,
+  selectModelById,
+  selectModelLabelById,
+  selectModelLabelWithClass
+} from "@ai-matrx/agents/models";
+import { useModelRecordsSelector } from "@ai-matrx/agents/models/react";
+import { supabase } from "../../host/db.js";
+import { captureError } from "../../host/diagnostics.js";
+import { isSignedOutVisitor } from "../../host/identity.js";
+import { chatHostHasDatabase } from "../../host/configure.js";
+const KEY = /* @__PURE__ */ Symbol.for("ai-matrx.chat.model-catalog");
+function getModelCatalog() {
+  const g = globalThis;
+  if (g[KEY]) return g[KEY];
+  const catalog = createModelCatalog({
+    // supabase-js satisfies the catalog's structural client as-is.
+    client: supabase,
+    // A host with no database has no catalog to read (host/source): nobody is signed in.
+    isSignedIn: async () => chatHostHasDatabase() && !await isSignedOutVisitor(),
+    errorSink: (event) => {
+      captureError({
+        source: "supabase-postgrest",
+        schema: "ai",
+        code: event.code,
+        message: event.message,
+        ...event.context ? { details: JSON.stringify(event.context) } : {}
+      });
+    }
+  });
+  g[KEY] = catalog;
+  return catalog;
+}
+const getModelRecords = () => getModelCatalog().records;
+function readModelRecords() {
+  try {
+    return getModelRecords().getState();
+  } catch {
+    return EMPTY_MODEL_RECORDS;
+  }
+}
+function useModelRecords(select) {
+  return useModelRecordsSelector(getModelRecords(), select);
+}
+function useModelRecord(modelId, options) {
+  const record = useModelRecords((s) => selectModelById(s, modelId));
+  const full = options?.full === true;
+  const fetchType = record?._fetchType;
+  useEffect(() => {
+    if (!modelId) return;
+    if (full && fetchType !== "full") void getModelRecords().loadModel(modelId);
+    else if (!fetchType) void getModelRecords().loadOptions();
+  }, [modelId, full, fetchType]);
+  return record;
+}
+function useModelLabel(modelId) {
+  const label = useModelRecords((s) => selectModelLabelById(s, modelId));
+  useEffect(() => {
+    if (!modelId || label) return;
+    const records = getModelRecords();
+    void records.loadOptions().then(() => {
+      if (!selectModelLabelById(records.getState(), modelId)) void records.loadIdentity(modelId);
+    });
+  }, [modelId, label]);
+  return label;
+}
+function useModelLabelWithClass(modelId, offeringId) {
+  useModelLabel(modelId);
+  useEffect(() => {
+    if (chatHostHasDatabase()) void getModelRecords().loadClasses();
+  }, []);
+  return useModelRecords((s) => selectModelLabelWithClass(s, modelId, offeringId));
+}
+function useModelClassLabels() {
+  useEffect(() => {
+    if (chatHostHasDatabase()) void getModelRecords().loadClasses();
+  }, []);
+}
+function useModelClassControls(modelId, offeringId) {
+  const key = modelId && offeringId ? classConfigKey(modelId, offeringId) : null;
+  const config = useModelRecords((s) => key ? s.classConfigByOffering[key] : void 0);
+  const status = useModelRecords((s) => key ? s.classConfigStatusByOffering[key] : void 0);
+  useEffect(() => {
+    if (modelId && offeringId) void getModelRecords().loadClassConfig(modelId, offeringId);
+  }, [modelId, offeringId]);
+  if (!modelId || !offeringId) return void 0;
+  if (config) return { config };
+  if (status === "failed") return { failed: true };
+  return { pending: true };
+}
+export {
+  getModelCatalog,
+  getModelRecords,
+  readModelRecords,
+  useModelClassControls,
+  useModelClassLabels,
+  useModelLabel,
+  useModelLabelWithClass,
+  useModelRecord,
+  useModelRecords
+};