@ai-matrx/chat 0.3.11 → 0.3.19

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/prompt-preview/PromptPreviewContent.js

@@ -5,7 +5,6 @@ import { toast as copyToast } from "../../host/notify.js";
 import { useEffect, useState } from "react";
 import { Loader2, Copy, RefreshCw, AlertTriangle } from "lucide-react";
 import { Button } from "@ai-matrx/design-system/controls";
-import { toast } from "../../host/notify.js";
 import { useAppStore } from "../../store/hooks.js";
 import { requestPromptPreview } from "./service.js";
 import { ErrorAlchemyMenu } from "../../host/ui-slots.js";
@@ -43,8 +42,7 @@ function PromptPreviewContent({
     };
   }, [conversationId, store, nonce]);
   const copy = async (label, text) => {
-    if (!await copyText(text)) return;
-    toast.success(`${label} copied`);
+    if (!await copyText(text, `${label} copied`)) return;
   };
   return /* @__PURE__ */ jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-3 bg-textured p-4", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [

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/active-requests/active-requests.selectors.d.ts

@@ -122,6 +122,20 @@ export declare const NON_ANSWER_BLOCK_TYPES: Set<string>;
  * chunk text. `editedText` wins, mirroring the selectors.
  */
 export declare function deriveAnswerText(request: Pick<ActiveRequest, "renderBlockOrder" | "renderBlocks" | "editedText">): string;
+/**
+ * The answer text FOR DATA CAPTURE (JSON extraction). Identical to
+ * {@link deriveAnswerText} except where a JSON wrapper holding kinds was split
+ * for display (A7: kinds + a residual that has the kinds REMOVED): those
+ * blocks are replaced by the bytes they were cut from. Without this, a
+ * structured answer whose arrays hold `{"__kind": …}` items was captured with
+ * those arrays EMPTY — an Applet's `sources` saved as `[]` (2026-10-07).
+ * A split whose blocks are no longer all present (a rewind) falls back to the
+ * blocks themselves.
+ */
+export declare function deriveAnswerDataText(request: Pick<ActiveRequest, "renderBlockOrder" | "renderBlocks" | "editedText">, wrapperSplits: ReadonlyArray<{
+    blockIds: string[];
+    source: string;
+}>): string;
 /**
  * Lossless document projection of an answer for string destinations that
  * intentionally accept Content IR. Plain-answer consumers keep using

package/dist/agents/redux/execution-system/active-requests/active-requests.selectors.js

@@ -47,6 +47,35 @@ function deriveAnswerText(request) {
   const answer = order.map((id) => blocks[id]).filter((b) => b && !NON_ANSWER_BLOCK_TYPES.has(b.type)).map((b) => b?.content ?? "").filter(Boolean).join("\n");
   return stripThinkingStreaming(answer).visible;
 }
+function deriveAnswerDataText(request, wrapperSplits) {
+  if (wrapperSplits.length === 0) return deriveAnswerText(request);
+  const { renderBlockOrder: order, renderBlocks: blocks, editedText } = request;
+  if (editedText !== null && editedText !== void 0) return editedText;
+  if (!order || !blocks || order.length === 0) return "";
+  const present = new Set(order);
+  const splitOf = /* @__PURE__ */ new Map();
+  for (const split of wrapperSplits) {
+    if (split.blockIds.length === 0) continue;
+    if (!split.blockIds.every((id) => present.has(id))) continue;
+    for (const id of split.blockIds) splitOf.set(id, split);
+  }
+  const emitted = /* @__PURE__ */ new Set();
+  const parts = [];
+  for (const id of order) {
+    const split = splitOf.get(id);
+    if (split) {
+      if (!emitted.has(split)) {
+        emitted.add(split);
+        parts.push(split.source);
+      }
+      continue;
+    }
+    const block = blocks[id];
+    if (!block || NON_ANSWER_BLOCK_TYPES.has(block.type)) continue;
+    if (block.content) parts.push(block.content);
+  }
+  return stripThinkingStreaming(parts.join("\n")).visible;
+}
 function hasKindMarker(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && typeof value.__kind === "string";
 }
@@ -1169,6 +1198,7 @@ export {
   NON_ANSWER_BLOCK_TYPES,
   blockCarriesDataNotText,
   blockHasSomethingToRender,
+  deriveAnswerDataText,
   deriveAnswerDocumentText,
   deriveAnswerText,
   deriveDecisionResultText,

package/dist/agents/redux/execution-system/client-capabilities/desktop-native.provider.js

@@ -1,11 +1,20 @@
 import { getLiveDesktopInstance } from "./desktop-presence.js";
 import { registerClientCapability } from "./registry.js";
+import { isChatHostConfigured, onChatHostConfigured } from "../../../../host/configure.js";
 function toSysPlatform(platform) {
   return platform === "windows" ? "win32" : platform;
 }
 const PRESENCE_BUDGET_MS = 150;
 if (typeof window !== "undefined") {
-  setTimeout(() => void getLiveDesktopInstance(), 0);
+  const warm = () => setTimeout(() => void getLiveDesktopInstance(), 0);
+  if (isChatHostConfigured()) {
+    warm();
+  } else {
+    const stop = onChatHostConfigured(() => {
+      stop();
+      warm();
+    });
+  }
 }
 registerClientCapability({
   name: "desktop-native",

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>;