@ai-matrx/associations 0.10.6 → 0.11.0

package/dist/react/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType } from 'react';
-import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DobuYuwz.cjs';
-export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryEntity, a1 as PrimaryEntityProvider, a2 as TagPickerIcon, a3 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a4 as UseAssociationEntitySelectAdapterArgs, a5 as UseAssociationsArgs, a6 as UseAssociationsReturn, a7 as UseContainerLinksArgs, a8 as UseContainerLinksReturn, a9 as attachedKey, aa as buildCommentTree, ab as useAssociationEntitySelectAdapter, ac as useAssociations, ad as useContainerLinks, ae as useContainerLinksAdapter, af as useEntityRelationships, ag as usePrimaryEntity } from '../CommentThread-DobuYuwz.cjs';
+import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-ZWiJVDpI.cjs';
+export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-ZWiJVDpI.cjs';
 
 interface AssociationsUiPorts {
     notifier?: AssociationsNotifier;

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType } from 'react';
-import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DobuYuwz.js';
-export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryEntity, a1 as PrimaryEntityProvider, a2 as TagPickerIcon, a3 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a4 as UseAssociationEntitySelectAdapterArgs, a5 as UseAssociationsArgs, a6 as UseAssociationsReturn, a7 as UseContainerLinksArgs, a8 as UseContainerLinksReturn, a9 as attachedKey, aa as buildCommentTree, ab as useAssociationEntitySelectAdapter, ac as useAssociations, ad as useContainerLinks, ae as useContainerLinksAdapter, af as useEntityRelationships, ag as usePrimaryEntity } from '../CommentThread-DobuYuwz.js';
+import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-ZWiJVDpI.js';
+export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-ZWiJVDpI.js';
 
 interface AssociationsUiPorts {
     notifier?: AssociationsNotifier;

package/dist/react/index.js

@@ -1193,6 +1193,73 @@ import {
   useRef as useRef3,
   useState
 } from "react";
+
+// src/edges.ts
+var ASSOCIATION_TARGET_TYPES = [
+  "organization",
+  //         an org — the top-level container resources attach into
+  "scope",
+  "scope_type",
+  "project",
+  "task",
+  "context_item",
+  "thread",
+  "war_room",
+  "category",
+  "conversation",
+  //         a chat conversation a working_document is attached to
+  "fc_set",
+  //               a flashcard set (card→set membership)
+  "fc_card",
+  //              a flashcard (card→card hierarchy, quiz→card)
+  "study_media",
+  //          a study-media artifact (summary/mind_map) — converter lineage target
+  "assessment",
+  //           a quiz / practice test — a converter lineage target + origin (assessment→artifact 'source')
+  "note",
+  //                 a note — the origin a converted study artifact links back to (artifact→note 'source' lineage, P4)
+  "file",
+  //                 a file (card→file media + source lineage)
+  "quiz_session",
+  //         a quiz a card is used in
+  "agent",
+  //                an orchestrator agent — the container an Orchestra's member agents attach into (role 'member'); an 'orchestra' self-edge marks the orchestrator
+  "agent_term_list",
+  //      a term list — durable file attachments target its vocabulary resource
+  "research_tag",
+  //         a research tag a source is filed under (rs_source_tag M2M collapsed into associations)
+  "skill",
+  //                a skill — projects link to it (skill→project, role 'member'); code_files attach as resources (code_file→skill, role 'resource')
+  "surface",
+  //              a UI surface — agents bind here (agent→surface); context menu reads via agent.menu_surface
+  "plan_entity",
+  //          a Content Planning source/media citation — plan_node role edges (about/cites/embeds) target it
+  "plan_node",
+  //            a planned page — research topics/tags attach here and follow realization into web_page
+  "web_site",
+  //             a web.site — parties attach onto a site's roster (party→web_site role 'writes_for')
+  "seo_topic",
+  //            a taxonomy topic — plan_node/plan_entity tag into it (role 'topic')
+  "seo_keyword",
+  //          a keyword — plan_node attaches secondaries (role 'secondary_keyword'; the primary is an FK, never an edge)
+  "web_page",
+  //             a canonical page — the page workspace attaches notes/tasks/files/keywords onto it (keyword edges: role 'primary'|'supporting')
+  "web_screenshot",
+  //       a page capture — per-image attachments on the page workspace
+  "party",
+  //                a CRM person/company (crm.party) — the record page attaches tasks/files/notes onto it
+  "crm_outreach_list",
+  //    a CRM outreach list (a worked send/dial queue) — parties and resources attach into it
+  "crm_deal",
+  //             a CRM deal (crm.deal) — people on it (role 'deal_contact'), tasks/files attach onto it
+  "rulebook"
+  //             a Masterwork Rulebook — its Scout interviews attach here (conversation→rulebook, role 'interview')
+];
+function isAssociationTargetType(value) {
+  return typeof value === "string" && ASSOCIATION_TARGET_TYPES.includes(value);
+}
+
+// src/react/hooks/useContainerLinks.ts
 function metadataRecord(metadata) {
   if (metadata === null || typeof metadata !== "object" || Array.isArray(metadata)) {
     return metadata == null ? {} : null;
@@ -1201,6 +1268,7 @@ function metadataRecord(metadata) {
 }
 function useContainerLinks(args) {
   const { containerType, containerId, orgId } = args;
+  const outgoing = args.direction === "outgoing";
   const store = useAssociationsStore();
   const {
     edges,
@@ -1211,7 +1279,7 @@ function useContainerLinks(args) {
     type: containerType,
     id: containerId
   });
-  const conversationKey = containerType === "conversation" && containerId ? `conversation:${containerId}` : null;
+  const conversationKey = !outgoing && containerType === "conversation" && containerId ? `conversation:${containerId}` : null;
   const activeConversationKey = useRef3(conversationKey);
   const conversationGeneration = useRef3(0);
   const [conversationResult, setConversationResult] = useState(null);
@@ -1267,9 +1335,9 @@ function useContainerLinks(args) {
   }, [loadConversationFiles]);
   const conversationFiles = conversationResult?.key === conversationKey ? conversationResult.files : [];
   const conversationFileError = conversationResult?.key === conversationKey ? conversationResult.error : null;
-  const conversationFileStatus = containerType !== "conversation" ? "idle" : conversationResult?.key !== conversationKey ? "loading" : conversationResult.loading ? "loading" : conversationFileError ? "error" : "ready";
+  const conversationFileStatus = outgoing || containerType !== "conversation" ? "idle" : conversationResult?.key !== conversationKey ? "loading" : conversationResult.loading ? "loading" : conversationFileError ? "error" : "ready";
   const incomingGeneric = edges.filter(
-    (edge) => edge.direction === "incoming" && !(containerType === "conversation" && edge.otherType === "file")
+    (edge) => outgoing ? edge.direction === "outgoing" : edge.direction === "incoming" && !(containerType === "conversation" && edge.otherType === "file")
   ).map((edge) => ({
     edgeId: edge.id,
     resourceId: edge.otherId,
@@ -1278,7 +1346,29 @@ function useContainerLinks(args) {
     label: edge.label ?? null,
     metadata: edge.metadata ?? {}
   }));
-  const incoming = containerType === "conversation" ? [...incomingGeneric, ...conversationFiles] : incomingGeneric;
+  const incoming = !outgoing && containerType === "conversation" ? [...incomingGeneric, ...conversationFiles] : incomingGeneric;
+  const endpoints = (token, resourceId) => {
+    if (!containerId) return { error: "Missing container id" };
+    if (outgoing) {
+      if (!isAssociationTargetType(token)) {
+        return {
+          error: `A ${token.replace(/_/g, " ")} cannot be filed under: it is not a container type.`
+        };
+      }
+      return {
+        sourceType: containerType,
+        sourceId: containerId,
+        targetType: token,
+        targetId: resourceId
+      };
+    }
+    return {
+      sourceType: token,
+      sourceId: resourceId,
+      targetType: containerType,
+      targetId: containerId
+    };
+  };
   const linksFor = (token) => incoming.filter((link) => link.token === token);
   const countFor = (token) => incoming.reduce((n, link) => link.token === token ? n + 1 : n, 0);
   const attachedIdsFor = (token) => {
@@ -1289,39 +1379,36 @@ function useContainerLinks(args) {
     return set;
   };
   const attach = async (token, resourceId, label, metadata, options) => {
-    if (!containerId) return { ok: false, error: "Missing container id" };
+    const ends = endpoints(token, resourceId);
+    if ("error" in ends) return { ok: false, error: ends.error };
     const result = await store.add({
-      sourceType: token,
-      sourceId: resourceId,
-      targetType: containerType,
-      targetId: containerId,
+      ...ends,
       ...orgId != null ? { orgId } : {},
       ...label !== void 0 ? { label } : {},
       ...metadata !== void 0 ? { metadata } : {},
       ...options?.role !== void 0 ? { role: options.role } : {},
       ...options?.replaceMetadata !== void 0 ? { replaceMetadata: options.replaceMetadata } : {}
     });
-    if (result.ok && containerType === "conversation" && token === "file") {
+    if (result.ok && !outgoing && containerType === "conversation" && token === "file") {
       await loadConversationFiles();
     }
     return result;
   };
   const detach = async (token, resourceId, role) => {
-    if (!containerId) return { ok: false, error: "Missing container id" };
+    const ends = endpoints(token, resourceId);
+    if ("error" in ends) return { ok: false, error: ends.error };
     const result = await store.remove({
-      sourceType: token,
-      sourceId: resourceId,
-      targetType: containerType,
-      targetId: containerId,
+      ...ends,
       ...role !== void 0 ? { role } : {}
     });
-    if (result.ok && containerType === "conversation" && token === "file") {
+    if (result.ok && !outgoing && containerType === "conversation" && token === "file") {
       await loadConversationFiles();
     }
     return result;
   };
   const setPinned = async (token, resourceId, pinned, role) => {
-    if (!containerId) return { ok: false, error: "Missing container id" };
+    const ends = endpoints(token, resourceId);
+    if ("error" in ends) return { ok: false, error: ends.error };
     const exactRole = role ?? null;
     const link = incoming.find(
       (candidate) => candidate.token === token && candidate.resourceId === resourceId && candidate.role === exactRole
@@ -1335,10 +1422,7 @@ function useContainerLinks(args) {
       };
     }
     return store.add({
-      sourceType: token,
-      sourceId: resourceId,
-      targetType: containerType,
-      targetId: containerId,
+      ...ends,
       ...orgId != null ? { orgId } : {},
       ...link.label != null ? { label: link.label } : {},
       ...role !== void 0 ? { role } : {},
@@ -1348,10 +1432,10 @@ function useContainerLinks(args) {
   const reload = async () => {
     await Promise.all([
       reloadGeneric(),
-      containerType === "conversation" ? loadConversationFiles() : Promise.resolve()
+      !outgoing && containerType === "conversation" ? loadConversationFiles() : Promise.resolve()
     ]);
   };
-  const status = !containerId ? genericStatus : conversationFileStatus === "error" ? "error" : containerType === "conversation" && (conversationFileStatus === "idle" || conversationFileStatus === "loading") ? "loading" : genericStatus;
+  const status = !containerId ? genericStatus : conversationFileStatus === "error" ? "error" : !outgoing && containerType === "conversation" && (conversationFileStatus === "idle" || conversationFileStatus === "loading") ? "loading" : genericStatus;
   const error = conversationFileError ?? genericError;
   return {
     status,
@@ -1366,6 +1450,21 @@ function useContainerLinks(args) {
     setPinned
   };
 }
+function containerLinksArgs(container) {
+  if (container?.direction === "outgoing") {
+    return {
+      containerType: container.type,
+      containerId: container.id,
+      orgId: container.orgId ?? null,
+      direction: "outgoing"
+    };
+  }
+  return {
+    containerType: container?.type ?? "organization",
+    containerId: container?.id ?? null,
+    orgId: container?.orgId ?? null
+  };
+}
 
 // src/react/hooks/useEntityTitles.ts
 import { useEffect as useEffect3, useState as useState2 } from "react";
@@ -2206,7 +2305,7 @@ function AssociationPicker(props) {
   const Override = pickerOverrides?.[props.token];
   if (Override) return /* @__PURE__ */ jsx6(Override, { ...props });
   const title = `Add ${info.labelPlural}`;
-  const subtitle = props.containerLabel ? `Attach to ${props.containerLabel}` : "Click an item to attach or detach it";
+  const subtitle = props.filing ? `File ${props.containerLabel ?? "this"} under a ${info.label.toLowerCase()}` : props.containerLabel ? `Attach to ${props.containerLabel}` : "Click an item to attach or detach it";
   if (!props.open) return null;
   return /* @__PURE__ */ jsx6(
     AssociationWindow,
@@ -2823,8 +2922,9 @@ function AttachedItemsSheet(props) {
   const Icon = info.Icon ?? DefaultEntityIcon;
   const title = info.labelPlural;
   const containerName = props.container?.label ?? props.containerLabel;
+  const filing = props.container?.direction === "outgoing";
   const subtitle = props.container ? /* @__PURE__ */ jsxs7("span", { className: "inline-flex min-w-0 max-w-full items-center gap-1", children: [
-    "Attached to",
+    filing ? "What this is filed under:" : "Attached to",
     /* @__PURE__ */ jsx9(
       DoorRef,
       {
@@ -3100,11 +3200,7 @@ function AssociationCard({
     attach,
     detach,
     setPinned
-  } = useContainerLinks({
-    containerType: container?.type ?? "organization",
-    containerId: container?.id ?? null,
-    orgId: container?.orgId ?? null
-  });
+  } = useContainerLinks(containerLinksArgs(container));
   if (!container) {
     store.errorSink({
       code: "association_card_no_container",
@@ -3115,7 +3211,8 @@ function AssociationCard({
   }
   const count = countFor(token);
   const loading = status === "loading" || status === "idle";
-  const canAttach = info.canListCandidates;
+  const filing = container.direction === "outgoing";
+  const canAttach = info.canListCandidates && (!filing || isAssociationTargetType(token));
   const canDrillIn = count > 0;
   return /* @__PURE__ */ jsxs8(Fragment3, { children: [
     /* @__PURE__ */ jsxs8(
@@ -3163,7 +3260,7 @@ function AssociationCard({
                   /* @__PURE__ */ jsx10("span", { className: "block text-[11px] text-muted-foreground tabular-nums", children: loading ? /* @__PURE__ */ jsxs8("span", { className: "inline-flex items-center gap-1", children: [
                     /* @__PURE__ */ jsx10(SpinnerIcon, { className: "h-3 w-3 animate-spin" }),
                     "Loading\u2026"
-                  ] }) : `${count} attached` })
+                  ] }) : `${count} ${container.direction === "outgoing" ? "filed under" : "attached"}` })
                 ] })
               ]
             }
@@ -3209,6 +3306,7 @@ function AssociationCard({
         token,
         ...container.label !== void 0 ? { containerLabel: container.label } : {},
         orgId: container.orgId ?? null,
+        ...filing ? { filing: true } : {},
         attachedIds: attachedIdsFor(token),
         onAttach: (resourceId, title) => attach(token, resourceId, title),
         onDetach: (resourceId) => detach(token, resourceId)
@@ -3226,9 +3324,11 @@ function AssociationCardGrid({
   className
 }) {
   const store = useAssociationsStore();
+  const primary = usePrimaryEntity();
   const excluded = new Set(excludeTokens ?? []);
+  const filing = primary?.direction === "outgoing";
   const list = (tokens ?? store.registry.curatedTokens()).filter(
-    (token) => !excluded.has(token)
+    (token) => !excluded.has(token) && (!filing || isAssociationTargetType(token))
   );
   return /* @__PURE__ */ jsx11("div", { className: cn7("space-y-5", className), children: CONTENT_ROLES.map((role) => {
     const inRole = list.filter(
@@ -3262,11 +3362,7 @@ function metadataIsPinned2(metadata) {
 }
 function useContainerLinksAdapter(container, tokens) {
   const store = useAssociationsStore();
-  const links = useContainerLinks({
-    containerType: container?.type ?? "organization",
-    containerId: container?.id ?? null,
-    orgId: container?.orgId ?? null
-  });
+  const links = useContainerLinks(containerLinksArgs(container));
   const rows = container ? (tokens ?? store.registry.curatedTokens()).flatMap(
     (token) => links.linksFor(token).map((l) => ({
       key: l.edgeId,
@@ -5320,6 +5416,7 @@ export {
   UnresolvedRef,
   attachedKey,
   buildCommentTree,
+  containerLinksArgs,
   getContentRoleMeta,
   lazyPickerOverride,
   lazyWindowShell,