@ai-matrx/records 0.97.5 → 0.97.6

package/dist/react/index.d.cts

@@ -12388,9 +12388,35 @@ interface ScopePage {
     total: number;
     next_offset: number | null;
 }
-/** A System Context item (`context.system_context_item`), as `custom.context_system_items` answers it. */
-interface SystemContextItem {
-    [key: string]: unknown;
+/** What a System Context item is: a curated fact, an ambient fact of the moment, or a dataset. */
+type SystemContextItemClass = "curated" | "ambient" | "dataset" | (string & {});
+/**
+ * A System Context item (`custom.context_system_items`), as a `ContextField` of the
+ * `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, plus its class.
+ */
+interface SystemContextField extends ContextField {
+    item_class: SystemContextItemClass | null;
+}
+/** One column of a table template. */
+interface TableTemplateField {
+    field_name: string;
+    display_name: string;
+    data_type: string;
+    field_order: number;
+    is_required: boolean;
+}
+/**
+ * A table template (a `custom.template` of kind `table`) a scope's dataset field may lock its
+ * table's columns to: the organization's own or a platform one, as `custom.table_templates` answers it.
+ */
+interface TableTemplate {
+    id: Uuid;
+    organization_id: Uuid | null;
+    name: string;
+    description: string;
+    version: number;
+    is_platform: boolean;
+    fields: TableTemplateField[];
 }
 /** One scope template of the gallery, as `custom.context_templates` answers it. */
 interface ScopeTemplate {
@@ -12491,7 +12517,9 @@ interface ScopeDoors {
     /** Of these scope ids, the ones that are ARCHIVED scopes of this type. */
     archivedScopesOfType(organizationId: Uuid, scopeTypeId: Uuid, wanted: ReadonlySet<Uuid>): Promise<RecordsResult<ArchivedScope[]>>;
     /** The System Context items (not scopes: the platform's own ambient context). */
-    systemItems(): Promise<RecordsResult<SystemContextItem[]>>;
+    systemItems(): Promise<RecordsResult<SystemContextField[]>>;
+    /** The table templates an organization's scope dataset fields may use (its own and the platform's). */
+    tableTemplates(organizationId: Uuid): Promise<RecordsResult<TableTemplate[]>>;
     /** The scope templates of the gallery. */
     templates(): Promise<RecordsResult<ScopeTemplate[]>>;
     /** A new scope type in `organizationId`. */

package/dist/react/index.d.ts

@@ -12388,9 +12388,35 @@ interface ScopePage {
     total: number;
     next_offset: number | null;
 }
-/** A System Context item (`context.system_context_item`), as `custom.context_system_items` answers it. */
-interface SystemContextItem {
-    [key: string]: unknown;
+/** What a System Context item is: a curated fact, an ambient fact of the moment, or a dataset. */
+type SystemContextItemClass = "curated" | "ambient" | "dataset" | (string & {});
+/**
+ * A System Context item (`custom.context_system_items`), as a `ContextField` of the
+ * `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, plus its class.
+ */
+interface SystemContextField extends ContextField {
+    item_class: SystemContextItemClass | null;
+}
+/** One column of a table template. */
+interface TableTemplateField {
+    field_name: string;
+    display_name: string;
+    data_type: string;
+    field_order: number;
+    is_required: boolean;
+}
+/**
+ * A table template (a `custom.template` of kind `table`) a scope's dataset field may lock its
+ * table's columns to: the organization's own or a platform one, as `custom.table_templates` answers it.
+ */
+interface TableTemplate {
+    id: Uuid;
+    organization_id: Uuid | null;
+    name: string;
+    description: string;
+    version: number;
+    is_platform: boolean;
+    fields: TableTemplateField[];
 }
 /** One scope template of the gallery, as `custom.context_templates` answers it. */
 interface ScopeTemplate {
@@ -12491,7 +12517,9 @@ interface ScopeDoors {
     /** Of these scope ids, the ones that are ARCHIVED scopes of this type. */
     archivedScopesOfType(organizationId: Uuid, scopeTypeId: Uuid, wanted: ReadonlySet<Uuid>): Promise<RecordsResult<ArchivedScope[]>>;
     /** The System Context items (not scopes: the platform's own ambient context). */
-    systemItems(): Promise<RecordsResult<SystemContextItem[]>>;
+    systemItems(): Promise<RecordsResult<SystemContextField[]>>;
+    /** The table templates an organization's scope dataset fields may use (its own and the platform's). */
+    tableTemplates(organizationId: Uuid): Promise<RecordsResult<TableTemplate[]>>;
     /** The scope templates of the gallery. */
     templates(): Promise<RecordsResult<ScopeTemplate[]>>;
     /** A new scope type in `organizationId`. */

package/dist/react/index.js

@@ -564,6 +564,9 @@ function rememberedOpCount() {
   return defaultOpLedger.size;
 }
 
+// src/scopes/types.ts
+var SYSTEM_CONTEXT_TYPE_ID = "__system__";
+
 // src/scopes/codec.ts
 var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
 var strOrNull = (v) => typeof v === "string" ? v : null;
@@ -735,6 +738,51 @@ var SENSITIVITY_TO_DOOR = {
   confidential: "restricted",
   restricted: "privileged"
 };
+var SENSITIVITY_FROM_DOOR = {
+  public: "public",
+  internal: "internal",
+  restricted: "confidential",
+  privileged: "restricted"
+};
+function systemContextFieldFromStore(row, index) {
+  const key = str(row.key);
+  const kind = str(row.value_type, "string");
+  return {
+    id: str(row.id),
+    scope_type_id: SYSTEM_CONTEXT_TYPE_ID,
+    organization_id: "",
+    key,
+    label: str(row.display_name, key),
+    description: str(row.description),
+    kind: KINDS.has(kind) ? kind : "string",
+    type: "system",
+    multi: kind === "array",
+    format: null,
+    config: {},
+    relation_target: null,
+    sort: typeof row.sort_order === "number" ? row.sort_order : index,
+    context_policy: "include",
+    // The system table keeps the old sensitivity words (`restricted`/`privileged`), like the write doors.
+    sensitivity: SENSITIVITY_FROM_DOOR[str(row.sensitivity)] ?? "public",
+    source: "system",
+    status: "active",
+    status_note: null,
+    category: null,
+    tags: [],
+    max_items: 0,
+    custom_component: null,
+    reference_source: null,
+    allowed_scope_type_ids: null,
+    allowed_reference_types: null,
+    review_interval_days: null,
+    depends_on: [],
+    version: 0,
+    created_by: null,
+    created_at: "",
+    updated_at: "",
+    item_class: strOrNull(row.item_class)
+  };
+}
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function referencesOf(row) {
   const v = row.value;
@@ -1069,7 +1117,11 @@ function createScopeDoors(call) {
     },
     async systemItems() {
       const res = await call("context_system_items", {}, "scopes.systemItems");
-      return res.ok ? { ok: true, data: res.data ?? [] } : res;
+      return res.ok ? { ok: true, data: (res.data ?? []).map(systemContextFieldFromStore) } : res;
+    },
+    async tableTemplates(organizationId) {
+      const res = await call("table_templates", { p_org_id: organizationId }, "scopes.tableTemplates");
+      return res.ok ? { ok: true, data: Array.isArray(res.data) ? res.data : [] } : res;
     },
     async templates() {
       const res = await call("context_templates", {}, "scopes.templates");