@ai-matrx/agents 0.11.3 → 0.12.0

package/dist/content-transfer/index.cjs

@@ -20,10 +20,72 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // content-transfer/index.ts
 var content_transfer_exports = {};
 __export(content_transfer_exports, {
-  createMatrxContentTransferAdapter: () => createMatrxContentTransferAdapter
+  createMatrxContentTransferAdapter: () => createMatrxContentTransferAdapter,
+  createMatrxTransferActions: () => createMatrxTransferActions,
+  createMatrxTransferPorts: () => createMatrxTransferPorts
 });
 module.exports = __toCommonJS(content_transfer_exports);
+
+// content-transfer/destinations.ts
 var import_content_transfer = require("@ai-matrx/kit/content-transfer");
+var DESTINATIONS = [
+  { key: "notes", label: "Save to Notes", hint: "Choose a note or create one", group: "save" },
+  { key: "scratch", label: "Save to Scratch", hint: "Capture a new note immediately", group: "save" },
+  { key: "document", label: "Create a document", hint: "A native Matrx document", group: "save" },
+  { key: "workbook", label: "Create a workbook", hint: "Selected columns and rows in Matrx Sheets", group: "save" },
+  { key: "task", label: "Create a task", hint: "Review the title and content before saving", group: "save" },
+  { key: "attach", label: "Save and attach to a task or project", hint: "Save a note, then choose where it belongs", group: "save" },
+  { key: "code", label: "Save to Code", hint: "Choose a file and language", group: "save" },
+  { key: "chat", label: "Open in a new chat", hint: "Attach this content and write your request", group: "chat" },
+  { key: "assistant", label: "Open an assistant window", hint: "Keep this page open while you work", group: "chat" },
+  { key: "tools", label: "Use with connected tools", hint: "Open an assistant and choose tools or MCPs", group: "chat" }
+];
+function createMatrxTransferActions(ports) {
+  return DESTINATIONS.flatMap(({ key, ...presentation }) => {
+    const port = ports[key];
+    if (!port) return [];
+    const supports = (snapshot, draft) => key !== "workbook" || (draft?.payload ?? snapshot.payload).kind === "rows";
+    return [{
+      id: `matrx:${key}`,
+      ...presentation,
+      prepared: true,
+      supports,
+      async run({ snapshot, draft, signal }) {
+        signal.throwIfAborted();
+        if (draft.snapshotId !== snapshot.id || draft.sourceId !== snapshot.sourceId || draft.sourceRevision !== snapshot.revision)
+          throw new Error("The prepared content does not belong to this source revision. Refresh Alchemy before continuing.");
+        if (!supports(snapshot, draft))
+          throw new Error(`${presentation.label} is unavailable for this prepared content.`);
+        const current = draft;
+        const payload = current.payload;
+        const columns = payload.kind === "rows" ? payload.columns.filter((column) => column.visible && column.exportable !== false && column.classification !== "secret" && column.classification !== "credential") : [];
+        const table = payload.kind === "rows" ? {
+          name: snapshot.label,
+          headers: columns.map((column) => column.label),
+          rows: payload.rows.map((row) => columns.map((column) => {
+            const value = (0, import_content_transfer.readTransferCell)(row, column);
+            return value == null ? "" : typeof value === "object" ? JSON.stringify(value) : String(value);
+          }))
+        } : void 0;
+        const content = {
+          label: snapshot.label,
+          snapshot,
+          draft: current,
+          payload,
+          markdown: (0, import_content_transfer.serialize)(current, "markdown").plainText,
+          plainText: (0, import_content_transfer.serialize)(current, "plain").plainText,
+          signal,
+          ...table ? { table } : {}
+        };
+        signal.throwIfAborted();
+        return port(content);
+      }
+    }];
+  });
+}
+
+// content-transfer/index.ts
+var import_content_transfer2 = require("@ai-matrx/kit/content-transfer");
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS = {
@@ -107,6 +169,8 @@ var MANDATE_KEYS = {
   crm__save_contact: "crm.save_contact",
   data__page_guidance: "data.page_guidance",
   dictionary__workspace_guide: "dictionary.workspace_guide",
+  distillation__timeline_distiller: "distillation.timeline_distiller",
+  distillation__timeline_unfolder: "distillation.timeline_unfolder",
   education__admin_guidance: "education.admin_guidance",
   education__analytics_narrate: "education.analytics_narrate",
   education__audio_study_guidance: "education.audio_study_guidance",
@@ -222,12 +286,15 @@ var MANDATE_KEYS = {
   masterwork__approach_selector: "masterwork.approach_selector",
   masterwork__audition_judge: "masterwork.audition_judge",
   masterwork__bad_draft: "masterwork.bad_draft",
+  masterwork__case_oracle: "masterwork.case_oracle",
   masterwork__checkup_auditor: "masterwork.checkup_auditor",
   masterwork__coherence_partner: "masterwork.coherence_partner",
   masterwork__conductor: "masterwork.conductor",
   masterwork__corpus_cleaner: "masterwork.corpus_cleaner",
   masterwork__corpus_synthesizer: "masterwork.corpus_synthesizer",
+  masterwork__counterparty: "masterwork.counterparty",
   masterwork__draft_triage: "masterwork.draft_triage",
+  masterwork__elicitation_judge: "masterwork.elicitation_judge",
   masterwork__exception_hunter: "masterwork.exception_hunter",
   masterwork__exemplar_distiller: "masterwork.exemplar_distiller",
   masterwork__faithfulness_judge: "masterwork.faithfulness_judge",
@@ -249,6 +316,7 @@ var MANDATE_KEYS = {
   masterwork__transcript_distiller: "masterwork.transcript_distiller",
   masterwork__transcript_shortlister: "masterwork.transcript_shortlister",
   masterwork__understudy: "masterwork.understudy",
+  masterwork__unfolding_judge: "masterwork.unfolding_judge",
   media__youtube_analyzer: "media.youtube_analyzer",
   meet__live_intelligence: "meet.live_intelligence",
   meet__live_notes: "meet.live_notes",
@@ -1036,6 +1104,113 @@ async function rejoinRuntimeOperation(transport, requestId, options = {}) {
   return toRunHandle(response, options);
 }
 
+// content-transfer/destination-ports.ts
+var success = (message, target) => ({ status: "success", delivered: "action", mimeTypes: [], message, ...target ? { target } : {} });
+var active = (bindings, content, expected) => {
+  content.signal.throwIfAborted();
+  const identity = bindings.getIdentity();
+  if (!identity.userId || !identity.organizationId) throw new Error("Sign in and select an organization to use Matrx destinations.");
+  if (expected && (identity.userId !== expected.userId || identity.organizationId !== expected.organizationId)) throw new Error("Your account or organization changed while this action was being prepared.");
+  return identity;
+};
+var receipt = (bindings, content, identity, target, message) => {
+  try {
+    active(bindings, content, identity);
+    return success(message, target);
+  } catch {
+    return { status: "error", code: "saved-before-context-change", retryable: false, target, message: `${target.label} was saved. Your account or organization changed before it could be opened.` };
+  }
+};
+var failed = (kind, content, result) => ({
+  status: "error",
+  code: `${kind}-save-failed`,
+  retryable: false,
+  message: result.error ?? `${kind === "document" ? "Document" : "Workbook"} could not be saved.`,
+  ...result.id ? { target: { kind, id: result.id, label: content.label, ...result.href ? { href: result.href } : {} } } : {}
+});
+function createMatrxTransferPorts(bindings) {
+  const attached = /* @__PURE__ */ new Map();
+  const saveNote = async (content, folder, identity) => {
+    const saved = await bindings.saveNote(content, folder);
+    return saved;
+  };
+  return {
+    notes: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openNotes(content);
+      active(bindings, content, identity);
+      return success("Notes editor opened. Choose where to save this content.");
+    },
+    scratch: async (content) => {
+      const identity = active(bindings, content);
+      const target = await saveNote(content, "Scratch", identity);
+      return receipt(bindings, content, identity, target, "Saved to Scratch.");
+    },
+    document: async (content) => {
+      const identity = active(bindings, content);
+      const result = await bindings.saveDocument(content);
+      if (!result.ok || !result.id || !result.href) return failed("document", content, result);
+      return receipt(bindings, content, identity, { kind: "document", id: result.id, label: content.label, href: result.href }, "Saved as a Matrx document.");
+    },
+    workbook: async (content) => {
+      const identity = active(bindings, content);
+      if (!content.table) throw new Error("A workbook requires tabular content.");
+      const result = await bindings.saveWorkbook(content);
+      if (!result.ok || !result.id || !result.href) return failed("workbook", content, result);
+      return receipt(bindings, content, identity, { kind: "workbook", id: result.id, label: content.label, href: result.href }, "Saved as a Matrx workbook.");
+    },
+    task: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openTask(content);
+      active(bindings, content, identity);
+      return success("Task editor opened with this content. Review and save the task.");
+    },
+    attach: async (content) => {
+      const identity = active(bindings, content);
+      const key = JSON.stringify([identity.userId, identity.organizationId, content.draft.sourceId, content.draft.sourceRevision, content.draft.revision, content.label, content.markdown]);
+      let pending = attached.get(key);
+      if (!pending) {
+        pending = bindings.saveNote(content, "Alchemy");
+        attached.set(key, pending);
+        pending.catch(() => attached.delete(key));
+      }
+      const target = await pending;
+      try {
+        active(bindings, content, identity);
+        await bindings.openAttachment(target);
+        active(bindings, content, identity);
+        return success("Note saved. Choose a task or project in the attachment window to finish attaching it.", target);
+      } catch {
+        return { status: "error", code: "note-saved-chooser-not-opened", retryable: false, target, message: "Note saved, but the attachment window did not open. Reopen this note to attach it; do not save another copy." };
+      }
+    },
+    code: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openCode(content);
+      active(bindings, content, identity);
+      return success("Code editor opened. Choose the file name and language before saving.");
+    },
+    chat: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openChat(content, "chat", identity);
+      active(bindings, content, identity);
+      return success("New chat opened with this content attached. Write your request when ready.");
+    },
+    assistant: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openChat(content, "assistant", identity);
+      active(bindings, content, identity);
+      return success("Assistant window opened with this content attached. Nothing has been sent yet.");
+    },
+    tools: async (content) => {
+      const identity = active(bindings, content);
+      await bindings.openChat(content, "tools", identity);
+      active(bindings, content, identity);
+      return success("Assistant opened with this content attached. Choose Tools in Chat Options to use your connected MCPs.");
+    }
+  };
+}
+
 // content-transfer/index.ts
 var SupersededRunError = class extends Error {
   constructor() {
@@ -1090,8 +1265,8 @@ function responseMessageId(metadata) {
   return typeof value === "string" && value.length > 0 ? value : null;
 }
 function draftFromAssistant(source, text, identity) {
-  const edited = (0, import_content_transfer.editDraft)(source, { kind: "markdown", text });
-  const reducedBy = (0, import_content_transfer.serialize)(source, "markdown").plainText.length - text.length;
+  const edited = (0, import_content_transfer2.editDraft)(source, { kind: "markdown", text });
+  const reducedBy = (0, import_content_transfer2.serialize)(source, "markdown").plainText.length - text.length;
   return deepFreeze({
     ...edited,
     manuallyEdited: source.manuallyEdited,
@@ -1308,7 +1483,7 @@ function createMatrxContentTransferAdapter(options) {
           executionId: null,
           status: "starting"
         });
-        const preparedContent = (0, import_content_transfer.serialize)(input.draft, "markdown").plainText;
+        const preparedContent = (0, import_content_transfer2.serialize)(input.draft, "markdown").plainText;
         let identity = null;
         try {
           const handle = await startMandateRun(