@ai-matrx/chat 0.3.15 → 0.3.20

package/dist/agents/model-registry/parse.js

@@ -1,246 +1 @@
-import { captureError } from "../../host/diagnostics.js";
-import {
-  DEFAULT_CAPABILITIES,
-  isContentType,
-  isFeatureKey,
-  isInteractionMode
-} from "@ai-matrx/agents/models";
-const CANONICAL_CAPABILITY_KEYS = /* @__PURE__ */ new Set([
-  "input",
-  "output",
-  "features",
-  "interaction",
-  "multilingual",
-  "image_reference_roles"
-]);
-const reportedUnknowns = /* @__PURE__ */ new Set();
-function reportUnknownCapabilityValue(field, value, context) {
-  try {
-    const modelId = context?.modelId ?? "unknown";
-    const key = `${modelId}|${field}|${JSON.stringify(value)}`;
-    if (reportedUnknowns.has(key)) return;
-    reportedUnknowns.add(key);
-    const message = `Unknown capabilities.${field} value ${JSON.stringify(value)} on model ${modelId}${context?.modelName ? ` (${context.modelName})` : ""} \u2014 not in the FE vocabulary (features/ai-models/capabilities/types.ts); value ignored until the vocabulary is extended.`;
-    console.warn(`[parseCapabilities] ${message}`);
-    captureError({
-      source: "data-shape",
-      relation: "ai.model_definition.capabilities",
-      message,
-      details: JSON.stringify({ field, value, modelId, modelName: context?.modelName })?.slice(0, 500)
-    });
-  } catch {
-  }
-}
-function collect(field, raw, guard, context) {
-  if (!Array.isArray(raw)) return [];
-  const out = [];
-  for (const value of raw) {
-    if (guard(value)) {
-      if (!out.includes(value)) out.push(value);
-    } else {
-      reportUnknownCapabilityValue(field, value, context);
-    }
-  }
-  return out;
-}
-function parseCapabilities(raw, context) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return { ...DEFAULT_CAPABILITIES };
-  }
-  const obj = raw;
-  for (const key of Object.keys(obj)) {
-    if (!CANONICAL_CAPABILITY_KEYS.has(key)) {
-      reportUnknownCapabilityValue(key, obj[key], context);
-    }
-  }
-  const input = collect("input", obj.input, isContentType, context);
-  const output = collect("output", obj.output, isContentType, context);
-  const features = collect("features", obj.features, isFeatureKey, context);
-  let interaction;
-  if (isInteractionMode(obj.interaction)) {
-    interaction = obj.interaction;
-  } else {
-    if (obj.interaction !== void 0) {
-      reportUnknownCapabilityValue("interaction", obj.interaction, context);
-    }
-    interaction = "turn";
-  }
-  let multilingual = false;
-  if (typeof obj.multilingual === "boolean") {
-    multilingual = obj.multilingual;
-  } else if (obj.multilingual !== void 0) {
-    reportUnknownCapabilityValue("multilingual", obj.multilingual, context);
-  }
-  return {
-    input: input.length > 0 ? input : ["text"],
-    output: output.length > 0 ? output : ["text"],
-    features,
-    interaction,
-    multilingual
-  };
-}
-function requireCanonicalCapabilities(raw, context) {
-  const location = context?.modelId ? `ai.model_definition.${context.modelId}.capabilities` : "ai.model_definition.capabilities";
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    throw new Error(`Invalid ${location}: expected a canonical capabilities object.`);
-  }
-  const value = raw;
-  for (const key of Object.keys(value)) {
-    if (!CANONICAL_CAPABILITY_KEYS.has(key)) {
-      throw new Error(`Invalid ${location}.${key}: unknown canonical capability key.`);
-    }
-  }
-  const requireMembers = (field, guard) => {
-    const members = value[field];
-    if (!Array.isArray(members)) {
-      throw new Error(`Invalid ${location}.${field}: expected an array.`);
-    }
-    const canonical = [];
-    for (const member of members) {
-      if (!guard(member)) {
-        throw new Error(
-          `Invalid ${location}.${field}: unknown capability value ${JSON.stringify(member)}.`
-        );
-      }
-      if (!canonical.includes(member)) canonical.push(member);
-    }
-    return canonical;
-  };
-  const input = requireMembers("input", isContentType);
-  const output = requireMembers("output", isContentType);
-  const features = requireMembers("features", isFeatureKey);
-  if (!isInteractionMode(value.interaction)) {
-    throw new Error(`Invalid ${location}.interaction: unknown interaction mode.`);
-  }
-  if (value.multilingual !== void 0 && typeof value.multilingual !== "boolean") {
-    throw new Error(`Invalid ${location}.multilingual: expected a boolean.`);
-  }
-  return {
-    input: input.length > 0 ? input : ["text"],
-    output: output.length > 0 ? output : ["text"],
-    features,
-    interaction: value.interaction,
-    multilingual: value.multilingual ?? false
-  };
-}
-function toAuditRecord(caps) {
-  return {
-    text_input: caps.input.includes("text"),
-    text_output: caps.output.includes("text"),
-    image_input: caps.input.includes("image"),
-    image_output: caps.output.includes("image"),
-    audio_input: caps.input.includes("audio"),
-    audio_output: caps.output.includes("audio"),
-    video_input: caps.input.includes("video"),
-    document_input: caps.input.includes("document"),
-    // vision is set explicitly OR implied by image input.
-    vision: caps.features.includes("vision") || caps.input.includes("image"),
-    code_execution: caps.features.includes("code_execution"),
-    function_calling: caps.features.includes("function_calling"),
-    streaming: caps.features.includes("streaming"),
-    web_search: caps.features.includes("web_search"),
-    json_mode: caps.features.includes("json_mode"),
-    structured_output: caps.features.includes("structured_output"),
-    system_prompt: caps.features.includes("system_prompt"),
-    multi_turn: caps.features.includes("multi_turn"),
-    embeddings: caps.features.includes("embeddings"),
-    fine_tuning: caps.features.includes("fine_tuning"),
-    batch_api: caps.features.includes("batch_api")
-  };
-}
-const AUDIT_FLAG_LOCATION = {
-  text_input: { array: "input", value: "text" },
-  image_input: { array: "input", value: "image" },
-  audio_input: { array: "input", value: "audio" },
-  video_input: { array: "input", value: "video" },
-  document_input: { array: "input", value: "document" },
-  text_output: { array: "output", value: "text" },
-  image_output: { array: "output", value: "image" },
-  audio_output: { array: "output", value: "audio" },
-  // NOTE: `vision` maps to the `vision` FEATURE only. The read projection
-  // (`toAuditRecord`) also implies vision from image input, so toggling
-  // vision OFF while image input stays on will still project true — that
-  // asymmetry is inherent to the flat view, not a data loss.
-  vision: { array: "features", value: "vision" },
-  code_execution: { array: "features", value: "code_execution" },
-  function_calling: { array: "features", value: "function_calling" },
-  streaming: { array: "features", value: "streaming" },
-  web_search: { array: "features", value: "web_search" },
-  json_mode: { array: "features", value: "json_mode" },
-  structured_output: { array: "features", value: "structured_output" },
-  system_prompt: { array: "features", value: "system_prompt" },
-  multi_turn: { array: "features", value: "multi_turn" },
-  embeddings: { array: "features", value: "embeddings" },
-  fine_tuning: { array: "features", value: "fine_tuning" },
-  batch_api: { array: "features", value: "batch_api" }
-};
-function mergeAuditRecordIntoCapabilities(raw, edited, context) {
-  const base = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? { ...raw } : { input: ["text"], output: ["text"], features: [], interaction: "turn" };
-  for (const key of ["input", "output", "features"]) {
-    base[key] = Array.isArray(base[key]) ? [...base[key]] : [];
-  }
-  const baseline = toAuditRecord(parseCapabilities(raw, context));
-  for (const flag of Object.keys(AUDIT_FLAG_LOCATION)) {
-    const desired = edited[flag];
-    if (desired === void 0 || desired === baseline[flag]) continue;
-    const { array, value } = AUDIT_FLAG_LOCATION[flag];
-    const members = base[array];
-    if (desired) {
-      if (!members.includes(value)) members.push(value);
-    } else {
-      const idx = members.indexOf(value);
-      if (idx !== -1) members.splice(idx, 1);
-    }
-  }
-  return base;
-}
-import {
-  CONTENT_TYPES,
-  FEATURE_KEYS,
-  INTERACTION_MODES,
-  DEFAULT_CAPABILITIES as DEFAULT_CAPABILITIES2
-} from "@ai-matrx/agents/models";
-function findNonCanonicalCapabilityValues(raw) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return [
-      "capabilities must be the canonical { input, output, features, interaction, multilingual } object"
-    ];
-  }
-  const obj = raw;
-  const problems = [];
-  for (const key of Object.keys(obj)) {
-    if (!CANONICAL_CAPABILITY_KEYS.has(key)) problems.push(`unknown key "${key}"`);
-  }
-  const scan = (field, guard) => {
-    const value = obj[field];
-    if (value === void 0) return;
-    if (!Array.isArray(value)) {
-      problems.push(`${field} must be an array of strings`);
-      return;
-    }
-    for (const member of value) {
-      if (!guard(member)) problems.push(`${field} value ${JSON.stringify(member)}`);
-    }
-  };
-  scan("input", isContentType);
-  scan("output", isContentType);
-  scan("features", isFeatureKey);
-  if (obj.interaction !== void 0 && !isInteractionMode(obj.interaction)) {
-    problems.push(`interaction ${JSON.stringify(obj.interaction)}`);
-  }
-  if (obj.multilingual !== void 0 && typeof obj.multilingual !== "boolean") {
-    problems.push("multilingual must be a boolean");
-  }
-  return problems;
-}
-export {
-  CONTENT_TYPES,
-  DEFAULT_CAPABILITIES2 as DEFAULT_CAPABILITIES,
-  FEATURE_KEYS,
-  INTERACTION_MODES,
-  findNonCanonicalCapabilityValues,
-  mergeAuditRecordIntoCapabilities,
-  parseCapabilities,
-  requireCanonicalCapabilities,
-  toAuditRecord
-};
+export * from "@ai-matrx/agents/models";

package/dist/agents/redux/agent-definition/selectors.d.ts

@@ -9328,18 +9328,18 @@ export declare const selectAgentSkillConfig: ((state: {
     conversationAttachments: import("../../connectors/attachments.slice.js").AttachmentsSliceState;
     modelRegistry: import("../../model-registry/modelRegistrySlice.js").ModelRegistryState;
     chatHost: import("../../../store/chat-host.slice.js").ChatHostState;
-} & import("../../../store/root-state.js").ChatHostReadSlices, id: string) => import("../../../ui/skills-types.js").SkillConfig) & {
+} & import("../../../store/root-state.js").ChatHostReadSlices, id: string) => import("@ai-matrx/agents/skills").SkillConfig) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;
 } & {
-    resultFunc: (resultFuncArgs_0: AgentDefinitionRecord | undefined) => import("../../../ui/skills-types.js").SkillConfig;
-    memoizedResultFunc: ((resultFuncArgs_0: AgentDefinitionRecord | undefined) => import("../../../ui/skills-types.js").SkillConfig) & {
+    resultFunc: (resultFuncArgs_0: AgentDefinitionRecord | undefined) => import("@ai-matrx/agents/skills").SkillConfig;
+    memoizedResultFunc: ((resultFuncArgs_0: AgentDefinitionRecord | undefined) => import("@ai-matrx/agents/skills").SkillConfig) & {
         clearCache: () => void;
         resultsCount: () => number;
         resetResultsCount: () => void;
     };
-    lastResult: () => import("../../../ui/skills-types.js").SkillConfig;
+    lastResult: () => import("@ai-matrx/agents/skills").SkillConfig;
     dependencies: [((state: {
         voiceAgent: import("../../../voice-agent/types.js").VoiceAgentState;
         agentDefinition: import("../../types/agent-definition.types.js").AgentDefinitionSliceState;
@@ -14241,7 +14241,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
     output_quality?: number | undefined;
     seconds?: number | undefined;
     duration?: number | undefined;
-} | import("../../types/json-schema.js").OutputSchema | import("../../../ui/skills-types.js").SkillConfig | {
+} | import("../../types/json-schema.js").OutputSchema | import("@ai-matrx/agents/skills").SkillConfig | {
     tools?: boolean | undefined;
     image_urls?: boolean | undefined;
     file_urls?: boolean | undefined;
@@ -14502,7 +14502,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
         output_quality?: number | undefined;
         seconds?: number | undefined;
         duration?: number | undefined;
-    } | import("../../types/json-schema.js").OutputSchema | import("../../../ui/skills-types.js").SkillConfig | {
+    } | import("../../types/json-schema.js").OutputSchema | import("@ai-matrx/agents/skills").SkillConfig | {
         tools?: boolean | undefined;
         image_urls?: boolean | undefined;
         file_urls?: boolean | undefined;
@@ -14759,7 +14759,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
         output_quality?: number | undefined;
         seconds?: number | undefined;
         duration?: number | undefined;
-    } | import("../../types/json-schema.js").OutputSchema | import("../../../ui/skills-types.js").SkillConfig | {
+    } | import("../../types/json-schema.js").OutputSchema | import("@ai-matrx/agents/skills").SkillConfig | {
         tools?: boolean | undefined;
         image_urls?: boolean | undefined;
         file_urls?: boolean | undefined;
@@ -15020,7 +15020,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
         output_quality?: number | undefined;
         seconds?: number | undefined;
         duration?: number | undefined;
-    } | import("../../types/json-schema.js").OutputSchema | import("../../../ui/skills-types.js").SkillConfig | {
+    } | import("../../types/json-schema.js").OutputSchema | import("@ai-matrx/agents/skills").SkillConfig | {
         tools?: boolean | undefined;
         image_urls?: boolean | undefined;
         file_urls?: boolean | undefined;

package/dist/agents/redux/execution-system/instance-working-document/cx-working-document.service.d.ts

@@ -1,7 +1,10 @@
 /**
- * cx-working-document.service — Supabase access for `workbench.working_documents`
- * (the canonical working-document entity) + its M2M links to conversations via
- * `platform.associations`.
+ * cx-working-document.service — Supabase access for chat working documents and
+ * scratchpads, stored in THE content store (`content.document`, document types
+ * `working_document` / `scratch`) + their M2M links to conversations via
+ * `platform.associations` (source type `document`). The retired table moved
+ * here on 2026-10-07 (cleanup C5c) with its ids, owners, organizations, times
+ * and version history.
  *
  * The chat-conversation analog of Scribe's `studio_documents`, generalised to a
  * first-class, versioned, owner-scoped entity. A working document is a piece of
@@ -17,7 +20,7 @@
  * committed. So an enabled-but-untouched document leaves zero records.
  *
  * RELATIONSHIPS: chat↔doc links are `platform.associations` edges
- * (`working_document` source → `conversation` target), reached ONLY through the
+ * (`document` source → `conversation` target), reached ONLY through the
  * canonical `associationsService`. The per-link opt-in flag + the doc kind live
  * on the edge `metadata` (`{enabled, doc_kind}`). The bespoke
  * `cx_conversation_documents` junction is retired.
@@ -34,11 +37,12 @@
  */
 import { type ResourceAccess } from "../../../../ui/access-core.js";
 export type WorkingDocumentKind = "working" | "scratch";
+/** A `content.document` row as this service selects it (body = the text). */
 export interface CxWorkingDocumentRow {
     id: string;
-    kind: string;
+    document_type_id: string;
     title: string;
-    content: string;
+    body: string;
     version: number;
     metadata?: {
         origin_conversation_id?: string | null;
@@ -63,6 +67,10 @@ export interface CxWorkingDocument {
     updatedAt: string;
 }
 export declare function rowToCxWorkingDocument(row: CxWorkingDocumentRow): CxWorkingDocument;
+/** The entity token of every working document and scratchpad: a content-store document. */
+export declare const WORKING_DOCUMENT_ENTITY = "document";
+/** The `platform.categories` ids of the two document types, read once. */
+export declare function workingDocumentTypeIds(): Promise<Record<WorkingDocumentKind, string>>;
 /**
  * The caller's access to a document via the canonical view-vs-edit gate
  * (`get_resource_access` — same model RLS enforces). Never throws; failures
@@ -148,7 +156,7 @@ export interface MaterializeArgs {
     content: string;
 }
 /**
- * Create (or resolve, idempotently) the durable `workbench.working_documents`
+ * Create (or resolve, idempotently) the durable `content.document`
  * row for a reserved id, writing the first content + title. The owner
  * (`created_by`) is stamped by the DB trigger from `auth.uid()`. Returns the row
  * (with its `version`).
@@ -199,11 +207,9 @@ export declare function setConversationDocumentEnabled(documentId: string, conve
 export declare function listConversationDocuments(conversationId: string): Promise<ConversationDocumentLink[]>;
 /** Every conversation a document is attached to (for the "linked in N chats" UI). */
 export declare function listDocumentConversations(documentId: string): Promise<string[]>;
-/** The entity token the working document registers under. */
-export declare const WORKING_DOCUMENT_TOKEN = "working_document";
 export interface WorkingDocumentVersion {
     version: number;
-    /** DB operation that produced this version (INSERT / UPDATE / DELETE). */
+    /** What changed in this version: content / lifecycle / governance. */
     operation: string;
     /** Who made the edit — the agent (service actor) or the user. Null when unknown. */
     actorId: string | null;
@@ -213,11 +219,7 @@ export interface WorkingDocumentVersion {
 }
 /** List a working document's durable versions, newest first. */
 export declare function listWorkingDocumentVersions(documentId: string, limit?: number): Promise<WorkingDocumentVersion[]>;
-/** The full text content captured at a given version (from the row snapshot). */
+/** The text of one version (null when the version carries no body). */
 export declare function getWorkingDocumentVersionContent(documentId: string, version: number): Promise<string | null>;
-/**
- * Restore a working document to a prior version (content columns only — never
- * identity/ownership). Returns the NEW version number (restore itself captures a
- * fresh version, so history is preserved). Editor access required.
- */
+/** Restore a past version as a NEW version; returns the new version number. */
 export declare function restoreWorkingDocumentVersion(documentId: string, version: number): Promise<number>;