@blocksdiy/react-common 1.47.0 → 1.49.0

package/dist/utils/message-run-ids.js

@@ -1,45 +1,77 @@
 /**
- * Which agent run (turn) produced each message of a conversation.
+ * Which agent run (turn) produced each message of a conversation, and when that run
+ * started.
  *
  * A row an app agent writes records the run that wrote it (`agentRunId`). On
  * `agent/connect` the server replays the transcript and then sends one AG-UI CUSTOM
  * event, `blocks.message_run_ids`, carrying `{ runIds: { [messageId]: runId } }` for
- * the replayed messages it can attribute (older messages have none). The run id
+ * the replayed messages it can attribute (older messages have none), plus
+ * `runStartedAt: { [runId]: epochMs }` for the runs it has a time for. The run id
  * rides in an event rather than on the messages because the AG-UI client validates
  * snapshot messages against a strict schema that drops unknown fields.
+ *
+ * A LIVE run is attributed here, from its own events: RUN_STARTED names the run and
+ * is its time, the messages it adds are its. The server records the same run id and
+ * its own clock, so a reload agrees with what the session showed.
  */
 export const MESSAGE_RUN_IDS_EVENT_NAME = "blocks.message_run_ids";
 export const EMPTY_MESSAGE_RUN_IDS = new Map();
+export const EMPTY_RUN_STARTED_AT = new Map();
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-/** The `{ messageId: runId }` payload of a run-ids CUSTOM event, or null for any other event. */
-export const readMessageRunIdsEvent = (event) => {
+/**
+ * One map of the run-ids CUSTOM event, keeping the entries whose value `isValue`; null for
+ * any other event, or when the event lacks that map (a server, or a thread, from before it).
+ */
+const readEventMap = (event, key, isValue) => {
     if (!isRecord(event) || event.name !== MESSAGE_RUN_IDS_EVENT_NAME || !isRecord(event.value)) {
         return null;
     }
-    const runIds = event.value.runIds;
-    if (!isRecord(runIds)) {
+    const entries = event.value[key];
+    if (!isRecord(entries)) {
         return null;
     }
     const out = {};
-    for (const [messageId, runId] of Object.entries(runIds)) {
-        if (messageId && typeof runId === "string" && runId) {
-            out[messageId] = runId;
+    for (const [entryKey, value] of Object.entries(entries)) {
+        if (entryKey && isValue(value)) {
+            out[entryKey] = value;
         }
     }
     return out;
 };
+/** The `{ messageId: runId }` payload of a run-ids CUSTOM event, or null for any other event. */
+export const readMessageRunIdsEvent = (event) => readEventMap(event, "runIds", (value) => typeof value === "string" && value !== "");
+/** The `{ runId: epochMs }` payload of a run-ids CUSTOM event, or null when it carries none. */
+export const readRunStartedAtEvent = (event) => readEventMap(event, "runStartedAt", (value) => typeof value === "number" && Number.isFinite(value));
 /** `previous` plus `incoming`; returns `previous` itself when nothing changes (no re-render). */
-export const mergeMessageRunIds = (previous, incoming) => {
+export const mergeEntries = (previous, incoming) => {
     let next = null;
-    for (const [messageId, runId] of Object.entries(incoming)) {
-        if (previous.get(messageId) === runId) {
+    for (const [key, value] of Object.entries(incoming)) {
+        if (previous.get(key) === value) {
             continue;
         }
         next ??= new Map(previous);
-        next.set(messageId, runId);
+        next.set(key, value);
     }
     return next ?? previous;
 };
+/**
+ * The messages a run that just started takes as its input — the unattributed ones after
+ * the last assistant message (the user's message, a tool's answer). Unattributed messages
+ * before that are older history and stay so. The server's `claim_run_input` rule.
+ */
+export const claimRunInput = (messages, known, runId) => {
+    const out = {};
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message.role === "assistant") {
+            break;
+        }
+        if (!known.has(message.id)) {
+            out[message.id] = runId;
+        }
+    }
+    return out;
+};
 /** Ids of the messages `runId` produced, in transcript order (empty when the run isn't in it). */
 export const messageIdsOfRun = (messages, runIds, runId) => {
     if (!runId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/react-common",
-  "version": "1.47.0",
+  "version": "1.49.0",
   "type": "module",
   "description": "React common",
   "keywords": [],
@@ -39,7 +39,7 @@
     "penpal": "^8.0.0",
     "react": "^19.2.8",
     "use-stick-to-bottom": "1.1.4",
-    "@blocksdiy/blocks-client-api": "1.25.0"
+    "@blocksdiy/blocks-client-api": "1.5.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.18",