@ai-matrx/messaging 0.8.0 → 0.10.0

package/dist/react.cjs

@@ -95,6 +95,7 @@ __export(react_exports, {
   resolveActor: () => resolveActor,
   splitText: () => splitText,
   summarizeText: () => summarizeText,
+  unreadCutoff: () => unreadCutoff,
   useComposer: () => useComposer,
   useConversation: () => useConversation,
   useConversations: () => useConversations,
@@ -354,6 +355,12 @@ ${JSON.stringify(references, null, 2)}
 }
 
 // src/core/ai.ts
+function unreadCutoff(messages, unreadCount) {
+  if (unreadCount <= 0) return null;
+  const index = messages.length - unreadCount - 1;
+  if (index < 0) return null;
+  return messages[index]?.createdAt ?? null;
+}
 function nameOf(participants, senderId) {
   return participants.find((p) => p.userId === senderId)?.displayName ?? senderId;
 }
@@ -374,22 +381,23 @@ function buildTranscript(messages, participants, limit, since) {
 }
 function createMessagingAi(options) {
   const limit = options.maxTranscriptMessages ?? 200;
-  function agentFor(capability) {
-    const agentId = options.agents[capability];
-    if (typeof agentId !== "string" || agentId.length === 0) {
+  function identityFor(capability) {
+    const identity = options.agents[capability];
+    if (identity === void 0 || identity.agentId.length === 0) {
       throw new MessagingError(
         "misconfigured",
         `Messaging AI capability "${capability}" has no agent configured`,
-        `Pass agents={{ ${capability}: "<agent-id>" }} to <MessagingProvider>. Agent definitions live in the database, never in this package \u2014 the id is the only part a host injects. Until then the UI hides this action rather than offering a button that cannot work.`
+        `Pass agents={{ ${capability}: { agentId: "<agent-id>" } }} to <MessagingProvider>. Agent definitions live in the database, never in this package \u2014 the identity is the only part a host injects. Until then the UI hides this action rather than offering a button that cannot work.`
       );
     }
-    return agentId;
+    return identity;
   }
-  async function run(capability, variables, userInput, signal) {
-    const agentId = agentFor(capability);
+  async function run(capability, variables, userInput, signal, onText) {
+    const identity = identityFor(capability);
+    const overrides = identity.configOverrides;
     const completed = await (0, import_matrx.runAgentToCompletion)(
       options.transport,
-      agentId,
+      identity.agentId,
       {
         ...(0, import_matrx.newEphemeralConversationStart)(),
         organization_id: options.organizationId,
@@ -398,9 +406,15 @@ function createMessagingAi(options) {
         initiation: "user",
         // THE USER-INPUT LAW: structured content is NEVER here.
         ...userInput !== null ? { user_input: userInput } : {},
+        // The settings half of the injected identity, verbatim. An absent one
+        // is OMITTED rather than sent as null: the agent's own settings stand.
+        ...overrides != null ? { config_overrides: overrides } : {},
         variables
       },
-      signal !== void 0 ? { signal } : {}
+      {
+        ...signal !== void 0 ? { signal } : {},
+        ...onText !== void 0 ? { onChunk: onText } : {}
+      }
     );
     return {
       capability,
@@ -433,27 +447,26 @@ function createMessagingAi(options) {
       ...args.since != null ? { unread_since: args.since } : {}
     };
   }
+  function configured(capability) {
+    const identity = options.agents[capability];
+    return identity !== void 0 && identity.agentId.length > 0;
+  }
   return {
     available: () => ["catchUp", "summarize", "actionItems", "draftReply"].filter(
-      (capability) => {
-        const id = options.agents[capability];
-        return typeof id === "string" && id.length > 0;
-      }
+      configured
     ),
-    isAvailable(capability) {
-      const id = options.agents[capability];
-      return typeof id === "string" && id.length > 0;
-    },
-    catchMeUp: (args) => run("catchUp", variablesFor(args), null, args.signal),
-    summarize: (args) => run("summarize", variablesFor(args), null, args.signal),
-    extractActionItems: (args) => run("actionItems", variablesFor(args), null, args.signal),
+    isAvailable: configured,
+    catchMeUp: (args) => run("catchUp", variablesFor(args), null, args.signal, args.onText),
+    summarize: (args) => run("summarize", variablesFor(args), null, args.signal, args.onText),
+    extractActionItems: (args) => run("actionItems", variablesFor(args), null, args.signal, args.onText),
     draftReply: (args) => run(
       "draftReply",
       variablesFor(args),
       // The ONE genuine human utterance in this module: what the user asked
       // the drafter for. Everything else rode `variables`.
       args.instruction !== void 0 && args.instruction.trim().length > 0 ? args.instruction.trim() : null,
-      args.signal
+      args.signal,
+      args.onText
     )
   };
 }
@@ -1479,12 +1492,13 @@ function requireOrg(organizationId, operation) {
   return organizationId;
 }
 function createMessagingRepository(options) {
-  const { client, identity } = options;
+  const { identity } = options;
   const org = requireOrg(identity.organizationId, "createMessagingRepository");
   const userCache = createReadCache({
     ttlMs: options.userTtlMs ?? 5 * 6e4,
     ...options.now !== void 0 ? { now: options.now } : {}
   });
+  const client = options.client;
   const db = () => client.schema(MESSAGING_SCHEMA);
   const rpcDb = () => client.schema(MESSAGING_RPC_SCHEMA);
   async function withSessionRetry(operation, run) {
@@ -1812,7 +1826,14 @@ function MessagingProvider(props) {
   const ready = client != null && typeof userId === "string" && userId.length > 0 && typeof organizationId === "string" && organizationId.length > 0;
   const hostProvidesRealtime = (0, import_react2.useIsRealtimeProviderMounted)();
   if (hostProvidesRealtime) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MessagingRuntime, { ...props });
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.RealtimeProvider, { client: ready ? client : null, actorId: userId ?? void 0, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MessagingRuntime, { ...props }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_react2.RealtimeProvider,
+    {
+      client: ready ? client : null,
+      actorId: userId ?? void 0,
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MessagingRuntime, { ...props })
+    }
+  );
 }
 function MessagingRuntime(props) {
   const { client, userId, organizationId, children } = props;
@@ -1841,6 +1862,10 @@ function MessagingRuntime(props) {
       (diagnosticRef.current ?? defaultDiagnostics)(event);
     };
     const repository = createMessagingRepository({
+      // THE ONE NARROWING, and it lives INSIDE the package. The prop is shallow
+      // so a host's fully-typed client is assignable at all (see
+      // supabase-shape.ts); everything below this line works against the rich
+      // contract, which `supabase-shape.test.ts` proves a real client honors.
       client,
       identity,
       ...props.resolveSession !== void 0 ? { resolveSession: props.resolveSession } : {}
@@ -1883,14 +1908,16 @@ function MessagingRuntime(props) {
   }, [engine]);
   const transport = props.transport;
   const agents = props.agents;
+  const maxTranscriptMessages = props.maxTranscriptMessages;
   const ai = (0, import_react.useMemo)(() => {
     if (transport === void 0 || agents === void 0 || !ready) return null;
     return createMessagingAi({
       transport,
       organizationId,
-      agents
+      agents,
+      ...maxTranscriptMessages !== void 0 ? { maxTranscriptMessages } : {}
     });
-  }, [transport, agents, ready, organizationId]);
+  }, [transport, agents, ready, organizationId, maxTranscriptMessages]);
   const renderers = props.actionRenderers;
   const rendererMap = (0, import_react.useMemo)(() => {
     const map = /* @__PURE__ */ new Map();
@@ -2218,6 +2245,10 @@ function useMessagingAi(conversationId) {
   const host = useMessagingHost();
   const conversation = useConversation(conversationId);
   const [isRunning, setRunning] = (0, import_react3.useState)(false);
+  const [partialText, setPartialText] = (0, import_react3.useState)("");
+  const [activeCapability, setActiveCapability] = (0, import_react3.useState)(
+    null
+  );
   const [result, setResult] = (0, import_react3.useState)(null);
   const [error, setError] = (0, import_react3.useState)(null);
   const abortRef = (0, import_react3.useRef)(null);
@@ -2231,11 +2262,15 @@ function useMessagingAi(conversationId) {
   return {
     available: ai?.available() ?? [],
     isRunning,
+    partialText,
+    activeCapability,
     result,
     error,
     clear: () => {
       setResult(null);
       setError(null);
+      setPartialText("");
+      setActiveCapability(null);
     },
     run: (capability, args = {}) => {
       if (ai === null || conversationId === null) return;
@@ -2244,22 +2279,32 @@ function useMessagingAi(conversationId) {
       abortRef.current = controller;
       setRunning(true);
       setError(null);
+      setResult(null);
+      setPartialText("");
+      setActiveCapability(capability);
       const base = {
         conversationId,
         messages: conversation.messages,
         participants: conversation.participants,
-        signal: controller.signal
+        signal: controller.signal,
+        // Live progress. Aborted runs stop painting immediately — a cancelled
+        // answer must not keep growing on screen.
+        onText: (text) => {
+          if (!controller.signal.aborted) setPartialText(text);
+        }
       };
       const call = () => {
         switch (capability) {
-          case "catchUp": {
-            const summary = conversation.summary;
-            const self = summary?.participants.find(
-              (participant) => participant.userId === host?.identity.userId
-            );
-            void self;
-            return ai.catchMeUp({ ...base, since: null });
-          }
+          case "catchUp":
+            return ai.catchMeUp({
+              ...base,
+              // "What did I miss" is about the UNREAD tail. Sending the whole
+              // window made this capability a second Summarize.
+              since: unreadCutoff(
+                conversation.messages,
+                conversation.summary?.unreadCount ?? 0
+              )
+            });
           case "summarize":
             return ai.summarize(base);
           case "actionItems":
@@ -2782,7 +2827,16 @@ function ConversationView(props) {
       },
       capability
     )) }) : null,
-    ai.isRunning ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "mx-msg__ai-output", "aria-busy": "true", children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "mx-msg__skeleton", style: { display: "block", height: 11, width: "72%" } }) }) : ai.error !== null ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "mx-msg__ai-output", style: { color: "var(--mx-msg-danger)" }, children: ai.error }) : ai.result !== null ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { className: "mx-msg__ai-output", children: [
+    ai.isRunning ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "mx-msg__ai-output", "aria-busy": "true", "aria-live": "polite", children: ai.partialText.length > 0 ? ai.partialText : /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "mx-msg__ai-output-label", children: ai.activeCapability !== null ? `${AI_LABELS[ai.activeCapability]}\u2026` : "Working\u2026" }),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+        "span",
+        {
+          className: "mx-msg__skeleton",
+          style: { display: "block", height: 11, width: "72%" }
+        }
+      )
+    ] }) }) : ai.error !== null ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "mx-msg__ai-output", style: { color: "var(--mx-msg-danger)" }, children: ai.error }) : ai.result !== null ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { className: "mx-msg__ai-output", children: [
       ai.result.text,
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         "button",