@ai-matrx/chat 0.5.6 → 0.5.8

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ai-matrx/chat
 
+## 0.5.8 — attach from outside React
+
+- `attachResourceToConversation(store, conversationId, resource)` — THE attach path without a hook
+  (`useAttachResource` is it bound to the app store); `attachRenderedArtifact(store, conversationId,
+  args)` — the same for a rendered page, for a canvas "Attach to chat ▸" entry or any host port.
+- Consumer action: none required; a canvas host may wire `attachRenderedArtifact` into
+  `CanvasOutputPorts.attachOptions`.
+
+## 0.5.7 — a registry/list disagreement no longer crashes the page
+
+- The context-items load-time drift check logs a loud console error instead of throwing; the
+  unregistered type renders through the generic fallback body. A jest test fails on any disagreement.
+
 ## 0.5.6 — 0.5.5 threw at load
 
 - `CONTEXT_ITEM_BLOCK_TYPES` lists `rendered_artifact`: 0.5.5 registered the def without it, so the

package/dist/agents/components/context-items/registry.d.ts

@@ -17,6 +17,7 @@ import type { ComponentType } from "react";
 import { hasContextItemDef } from "./context-item-block-types.js";
 import type { ContextItemBodyProps, ContextItemTitleProps, ContextItemTypeDef } from "./types.js";
 export declare const CONTEXT_ITEM_TYPE_DEFS: ContextItemTypeDef[];
+export declare function findContextItemRegistryDrift(): string[];
 export { hasContextItemDef };
 /** Resolve the registered def for a block type, or a graceful fallback. */
 export declare function resolveContextItemDef(blockType: string): ContextItemTypeDef;

package/dist/agents/components/context-items/registry.js

@@ -339,14 +339,17 @@ const FALLBACK_DEF = {
   editable: false,
   Body: GenericBody
 };
-{
+function findContextItemRegistryDrift() {
   const listed = new Set(CONTEXT_ITEM_BLOCK_TYPES);
-  const drift = [
+  return [
     ...[...BY_BLOCK_TYPE.keys()].filter((t) => !listed.has(t)),
     ...CONTEXT_ITEM_BLOCK_TYPES.filter((t) => !BY_BLOCK_TYPE.has(t))
   ];
+}
+{
+  const drift = findContextItemRegistryDrift();
   if (drift.length > 0) {
-    throw new Error(
+    console.error(
       `context-items registry and CONTEXT_ITEM_BLOCK_TYPES disagree: ${drift.join(", ")}`
     );
   }
@@ -371,6 +374,7 @@ function resolveContextItemTitle(blockType) {
 }
 export {
   CONTEXT_ITEM_TYPE_DEFS,
+  findContextItemRegistryDrift,
   hasContextItemDef,
   resolveContextItemBody,
   resolveContextItemDef,

package/dist/agents/components/inputs/resources/attach-resource.d.ts

@@ -1,3 +1,23 @@
+/**
+ * attach-resource — the single mapping from a picked `Resource` to how it gets
+ * attached to a conversation, shared by every surface that attaches resources
+ * (SmartAgentResourcePickerButton, the RunControlsMenu Attach tab, …).
+ *
+ * TWO attach shapes, by kind:
+ *  - A stored FILE → a DURABLE `platform.associations` edge to the conversation
+ *    (`file → conversation`). The file ID means its complete existing family,
+ *    including processed documents and Knowledge. This PERSISTS across turns and reloads; the
+ *    backend reads the conversation's edges at call time and injects the context.
+ *    The chip renders from the edge list (see `AttachedDocumentChips`), NOT the
+ *    ephemeral `instanceResources` slice.
+ *  - Before the conversation row exists, the same stored FILE identity is held
+ *    as a `processed_document` instance resource and emitted in request.context.
+ *    It is never downgraded to a provider-native PDF block.
+ *  - Everything else (media bytes, notes, tasks, webpages, …) → the per-turn
+ *    `instanceResources` block. A document with no durable file identity still
+ *    rides content[] as binary media.
+ */
+import type { Dispatch } from "@reduxjs/toolkit";
 import type { ChatRootState } from "../../../../store/root-state.js";
 import type { Resource } from "../../../resources/types.js";
 import type { ResourceBlockType } from "../../../types/instance.types.js";
@@ -24,7 +44,17 @@ export declare function findIdenticalResourceId(state: ChatRootState, conversati
  * the per-turn binary/instanceResources path unchanged. Closing the hosting
  * popover is the CALLER's job.
  */
+/** The store handles a non-React caller passes to the attach functions. */
+export interface AttachStore {
+    dispatch: Dispatch;
+    getState: () => unknown;
+}
 export declare function useAttachResource(conversationId: string): (resource: Resource) => Promise<boolean>;
+/**
+ * THE attach path, callable outside React (a canvas menu entry, a host port).
+ * `useAttachResource` is this bound to the app store.
+ */
+export declare function attachResourceToConversation(store: AttachStore, conversationId: string, resource: Resource): Promise<boolean>;
 /**
  * Inverse of `useAttachResource` for files toggled in the live picker.
  * Owned media can have both a durable authorization edge and a per-turn media

package/dist/agents/components/inputs/resources/attach-resource.js

@@ -183,7 +183,15 @@ async function attachConversationFileEdge(conversationId, sourceId, fileId, labe
 function useAttachResource(conversationId) {
   const dispatch = useAppDispatch();
   const store = useAppStore();
-  return async (resource) => {
+  return (resource) => attachResourceToConversation(
+    { dispatch, getState: store.getState },
+    conversationId,
+    resource
+  );
+}
+async function attachResourceToConversation(store, conversationId, resource) {
+  const dispatch = store.dispatch;
+  {
     const getState = () => store.getState();
     const baseBlockType = resourceTypeToBlockType(resource.type);
     const blockType = refineBlockType(baseBlockType, resource.data);
@@ -298,7 +306,7 @@ function useAttachResource(conversationId) {
       resourcePreviewLabel
     );
     return true;
-  };
+  }
 }
 function useDetachResource(conversationId) {
   const dispatch = useAppDispatch();
@@ -342,6 +350,7 @@ function useDetachResource(conversationId) {
   };
 }
 export {
+  attachResourceToConversation,
   findIdenticalResourceId,
   resourceLabel,
   resourceTypeToBlockType,

package/dist/agents/components/inputs/resources/useAttachRenderedArtifact.d.ts

@@ -1,5 +1,6 @@
 import type { RenderedArtifactRepresentation } from "../../../types/instance.types.js";
 import { type RenderedArtifactSource } from "../../../utils/renderedArtifactContext.js";
+import { type AttachStore } from "./attach-resource.js";
 /** What a host capture port returns: a stored cloud image, or a local PNG to upload. */
 export type RenderedCaptureResult = {
     kind: "stored";
@@ -18,3 +19,8 @@ export interface AttachRenderedArtifactArgs {
     capture?: () => Promise<RenderedCaptureResult>;
 }
 export declare function useAttachRenderedArtifact(conversationId: string | null | undefined): (args: AttachRenderedArtifactArgs) => Promise<boolean>;
+/**
+ * The same attach outside React (a canvas "Attach to chat ▸" entry). Without
+ * `uploadFiles`, a capture must answer a STORED image (the server engine).
+ */
+export declare function attachRenderedArtifact(store: AttachStore, conversationId: string | null | undefined, { source, representation, capture }: AttachRenderedArtifactArgs, uploadFiles?: (files: File[]) => Promise<void>): Promise<boolean>;

package/dist/agents/components/inputs/resources/useAttachRenderedArtifact.js

@@ -11,7 +11,7 @@ import { generateResourceId } from "../../../redux/execution-system/utils/ids.js
 import {
   RENDERED_ARTIFACT_BLOCK_TYPE
 } from "../../../utils/renderedArtifactContext.js";
-import { useAttachResource } from "./attach-resource.js";
+import { attachResourceToConversation } from "./attach-resource.js";
 import { useUploadAgentResources } from "./usePasteImageResource.js";
 function screenshotName(title) {
   const base = title.trim().replace(/[^\w\s.-]+/g, "").trim().slice(0, 60) || "page";
@@ -20,88 +20,98 @@ function screenshotName(title) {
 function useAttachRenderedArtifact(conversationId) {
   const dispatch = useAppDispatch();
   const store = useAppStore();
-  const attachResource = useAttachResource(conversationId ?? "");
   const uploadResources = useUploadAgentResources(conversationId ?? "", {
     uploadRoot: "attachments",
     uploadPath: "screenshots"
   });
-  return async ({ source, representation, capture }) => {
-    if (!conversationId) {
-      toast.error("Open a chat to attach this to.");
+  return (args) => attachRenderedArtifact(
+    { dispatch, getState: store.getState },
+    conversationId,
+    args,
+    uploadResources
+  );
+}
+async function attachRenderedArtifact(store, conversationId, { source, representation, capture }, uploadFiles) {
+  const { dispatch } = store;
+  if (!conversationId) {
+    toast.error("Open a chat to attach this to.");
+    return false;
+  }
+  if (representation !== "screenshot") {
+    const resourceId = generateResourceId();
+    dispatch(
+      addResource({
+        conversationId,
+        blockType: RENDERED_ARTIFACT_BLOCK_TYPE,
+        resourceId,
+        source,
+        options: { representation }
+      })
+    );
+    dispatch(
+      setResourcePreview({
+        conversationId,
+        resourceId,
+        preview: `${source.title || "Page"} \xB7 ${representation === "code" ? "Code" : "Text"}`
+      })
+    );
+    return true;
+  }
+  if (!capture) {
+    toast.error("This item can't be captured as an image.");
+    return false;
+  }
+  const name = screenshotName(source.title);
+  const placeholderId = generateResourceId();
+  dispatch(
+    addResource({
+      conversationId,
+      blockType: "image",
+      resourceId: placeholderId,
+      source: { filename: name, mime_type: "image/png" }
+    })
+  );
+  try {
+    const result = await capture();
+    const state = store.getState();
+    if (state.instanceResources.byConversationId[conversationId]?.[placeholderId] === void 0) {
       return false;
     }
-    if (representation !== "screenshot") {
-      const resourceId = generateResourceId();
-      dispatch(
-        addResource({
-          conversationId,
-          blockType: RENDERED_ARTIFACT_BLOCK_TYPE,
-          resourceId,
-          source,
-          options: { representation }
-        })
-      );
-      dispatch(
-        setResourcePreview({
-          conversationId,
-          resourceId,
-          preview: `${source.title || "Page"} \xB7 ${representation === "code" ? "Code" : "Text"}`
-        })
-      );
+    if (result.kind === "file") {
+      if (!uploadFiles) throw new Error("This capture needs an upload, which is not available here");
+      dispatch(removeResource({ conversationId, resourceId: placeholderId }));
+      await uploadFiles([result.file]);
       return true;
     }
-    if (!capture) {
-      toast.error("This item can't be captured as an image.");
-      return false;
-    }
-    const name = screenshotName(source.title);
-    const placeholderId = generateResourceId();
+    const attached = await attachResourceToConversation(store, conversationId, {
+      type: "file",
+      data: {
+        id: result.fileId,
+        filename: name,
+        url: result.url ?? void 0,
+        type: "image/png",
+        mime_type: "image/png",
+        details: { filename: name }
+      }
+    });
+    if (!attached) throw new Error("The screenshot could not be attached");
+    dispatch(removeResource({ conversationId, resourceId: placeholderId }));
+    return true;
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : "Capture failed";
     dispatch(
-      addResource({
+      setResourceStatus({
         conversationId,
-        blockType: "image",
         resourceId: placeholderId,
-        source: { filename: name, mime_type: "image/png" }
+        status: "error",
+        errorMessage: reason
       })
     );
-    try {
-      const result = await capture();
-      const stillAttached = store.getState().instanceResources.byConversationId[conversationId]?.[placeholderId] !== void 0;
-      if (!stillAttached) return false;
-      if (result.kind === "file") {
-        dispatch(removeResource({ conversationId, resourceId: placeholderId }));
-        await uploadResources([result.file]);
-        return true;
-      }
-      const attached = await attachResource({
-        type: "file",
-        data: {
-          id: result.fileId,
-          filename: name,
-          url: result.url ?? void 0,
-          type: "image/png",
-          mime_type: "image/png",
-          details: { filename: name }
-        }
-      });
-      if (!attached) throw new Error("The screenshot could not be attached");
-      dispatch(removeResource({ conversationId, resourceId: placeholderId }));
-      return true;
-    } catch (err) {
-      const reason = err instanceof Error ? err.message : "Capture failed";
-      dispatch(
-        setResourceStatus({
-          conversationId,
-          resourceId: placeholderId,
-          status: "error",
-          errorMessage: reason
-        })
-      );
-      toast.error(`Couldn't capture the page: ${reason}`);
-      return false;
-    }
-  };
+    toast.error(`Couldn't capture the page: ${reason}`);
+    return false;
+  }
 }
 export {
+  attachRenderedArtifact,
   useAttachRenderedArtifact
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -166,25 +166,25 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
-    "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/media": "latest",
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/rich-content": "latest",
+    "@ai-matrx/records": "latest",
     "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/design-system": "latest"
+    "@ai-matrx/rich-content": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",