@copilotkit/react-core 1.51.3-next.6 → 1.51.3-next.7

package/dist/hooks/index.mjs

@@ -1,7 +1,13 @@
 import "../chunk-A6NKSGH3.mjs";
+import {
+  useLangGraphInterrupt
+} from "../chunk-4RRMC7L2.mjs";
 import {
   useMakeCopilotDocumentReadable
 } from "../chunk-7IBF6RBW.mjs";
+import {
+  useCopilotReadable
+} from "../chunk-Z6JV2LRY.mjs";
 import {
   useCopilotRuntimeClient
 } from "../chunk-6ESSSQ7Q.mjs";
@@ -9,8 +15,8 @@ import {
   useDefaultTool
 } from "../chunk-BUSWSDYO.mjs";
 import {
-  useLangGraphInterrupt
-} from "../chunk-4RRMC7L2.mjs";
+  useCoAgent
+} from "../chunk-ZYTXB6HH.mjs";
 import {
   useCopilotAdditionalInstructions
 } from "../chunk-ABWT4DRT.mjs";
@@ -31,39 +37,35 @@ import {
 } from "../chunk-7DTB7S5V.mjs";
 import {
   useCopilotChatHeadless_c
-} from "../chunk-MF2ZSLBV.mjs";
+} from "../chunk-XZFIJ7XF.mjs";
 import {
   useCopilotChatSuggestions
 } from "../chunk-XDFVCQD3.mjs";
 import {
   useCopilotChat
-} from "../chunk-3G4VFRVV.mjs";
+} from "../chunk-NXHQDCZF.mjs";
 import {
   useCopilotChatInternal
-} from "../chunk-HBMPXNW2.mjs";
-import {
-  useLangGraphInterruptRender
-} from "../chunk-VV56AVPB.mjs";
+} from "../chunk-LO4RRITI.mjs";
 import {
   useLazyToolRenderer
 } from "../chunk-ZVF5Q6IH.mjs";
 import {
-  useCopilotReadable
-} from "../chunk-Z6JV2LRY.mjs";
+  useLangGraphInterruptRender
+} from "../chunk-VV56AVPB.mjs";
+import "../chunk-I76HKHPJ.mjs";
 import {
   useCoAgentStateRender
-} from "../chunk-YTQHRJUA.mjs";
-import {
-  useCoAgent
-} from "../chunk-ZYTXB6HH.mjs";
-import "../chunk-I76HKHPJ.mjs";
+} from "../chunk-VKNLTZJE.mjs";
 import "../chunk-6PUNP7CD.mjs";
 import "../chunk-O7ARI5CV.mjs";
-import "../chunk-3X3I7OJV.mjs";
+import "../chunk-BKMJ4LC7.mjs";
 import "../chunk-NB2FKV2V.mjs";
 import "../chunk-LMHB2D4J.mjs";
+import "../chunk-77IVITG3.mjs";
+import "../chunk-C3YJYDK4.mjs";
 import "../chunk-EFL5OBKN.mjs";
-import "../chunk-FDOMAPJY.mjs";
+import "../chunk-QD7EID4N.mjs";
 import "../chunk-AFNWX62Q.mjs";
 import "../chunk-DMLQZG75.mjs";
 import "../chunk-SKC7AJIV.mjs";

package/dist/hooks/use-coagent-state-render-bridge.helpers.d.ts

@@ -0,0 +1,92 @@
+declare enum RenderStatus {
+    InProgress = "inProgress",
+    Complete = "complete"
+}
+declare enum ClaimAction {
+    Create = "create",
+    Override = "override",
+    Existing = "existing",
+    Block = "block"
+}
+interface StateRenderContext {
+    agentId: string;
+    stateRenderId: string;
+    messageId: string;
+    runId: string;
+    messageIndex?: number;
+}
+interface Claim {
+    stateRenderId: string;
+    runId?: string;
+    stateSnapshot?: any;
+    locked?: boolean;
+    messageIndex?: number;
+}
+type ClaimsByMessageId = Record<string, Claim>;
+interface ClaimResolution {
+    canRender: boolean;
+    action: ClaimAction;
+    nextClaim?: Claim;
+    lockOthers?: boolean;
+    updateRunId?: string;
+}
+interface SnapshotCaches {
+    byStateRenderAndRun: Record<string, any>;
+    byMessageId: Record<string, any>;
+}
+interface SnapshotSelectionInput {
+    messageId: string;
+    messageName?: string;
+    allowLiveState?: boolean;
+    skipLatestCache?: boolean;
+    stateRenderId?: string;
+    effectiveRunId: string;
+    stateSnapshotProp?: any;
+    agentState?: any;
+    agentMessages?: Array<{
+        id: string;
+        role?: string;
+    }>;
+    existingClaim?: Claim;
+    caches: SnapshotCaches;
+}
+interface SnapshotSelectionResult {
+    snapshot?: any;
+    hasSnapshotKeys: boolean;
+    cachedSnapshot?: any;
+    allowEmptySnapshot?: boolean;
+    snapshotForClaim?: any;
+}
+declare function areStatesEquals(a: any, b: any): boolean;
+declare function isPlaceholderMessageId(messageId: string | undefined): boolean;
+declare function isPlaceholderMessageName(messageName: string | undefined): messageName is "coagent-state-render";
+declare function readCachedMessageEntry(entry: any): {
+    snapshot?: any;
+    runId?: string;
+};
+declare function getEffectiveRunId({ existingClaimRunId, cachedMessageRunId, runId, }: {
+    existingClaimRunId?: string;
+    cachedMessageRunId?: string;
+    runId?: string;
+}): string;
+/**
+ * Resolve whether a message can claim a render slot.
+ * This is a pure decision function; the caller applies claim mutations.
+ */
+declare function resolveClaim({ claims, context, stateSnapshot, }: {
+    claims: ClaimsByMessageId;
+    context: StateRenderContext;
+    stateSnapshot?: any;
+}): ClaimResolution;
+/**
+ * Select the best snapshot to render for this message.
+ * Priority order is:
+ * 1) explicit message snapshot
+ * 2) live agent state (latest assistant only)
+ * 3) cached snapshot for message
+ * 4) cached snapshot for stateRenderId+runId
+ * 5) last cached snapshot for stateRenderId
+ */
+declare function selectSnapshot({ messageId, messageName, allowLiveState, skipLatestCache, stateRenderId, effectiveRunId, stateSnapshotProp, agentState, agentMessages, existingClaim, caches, }: SnapshotSelectionInput): SnapshotSelectionResult;
+
+export { Claim, ClaimAction, ClaimResolution, ClaimsByMessageId, RenderStatus, SnapshotCaches, SnapshotSelectionInput, SnapshotSelectionResult, StateRenderContext, areStatesEquals, getEffectiveRunId, isPlaceholderMessageId, isPlaceholderMessageName, readCachedMessageEntry, resolveClaim, selectSnapshot };

package/dist/hooks/use-coagent-state-render-bridge.helpers.js

@@ -0,0 +1,231 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/use-coagent-state-render-bridge.helpers.ts
+var use_coagent_state_render_bridge_helpers_exports = {};
+__export(use_coagent_state_render_bridge_helpers_exports, {
+  ClaimAction: () => ClaimAction,
+  RenderStatus: () => RenderStatus,
+  areStatesEquals: () => areStatesEquals,
+  getEffectiveRunId: () => getEffectiveRunId,
+  isPlaceholderMessageId: () => isPlaceholderMessageId,
+  isPlaceholderMessageName: () => isPlaceholderMessageName,
+  readCachedMessageEntry: () => readCachedMessageEntry,
+  resolveClaim: () => resolveClaim,
+  selectSnapshot: () => selectSnapshot
+});
+module.exports = __toCommonJS(use_coagent_state_render_bridge_helpers_exports);
+var import_shared = require("@copilotkit/shared");
+var RenderStatus = /* @__PURE__ */ ((RenderStatus2) => {
+  RenderStatus2["InProgress"] = "inProgress";
+  RenderStatus2["Complete"] = "complete";
+  return RenderStatus2;
+})(RenderStatus || {});
+var ClaimAction = /* @__PURE__ */ ((ClaimAction2) => {
+  ClaimAction2["Create"] = "create";
+  ClaimAction2["Override"] = "override";
+  ClaimAction2["Existing"] = "existing";
+  ClaimAction2["Block"] = "block";
+  return ClaimAction2;
+})(ClaimAction || {});
+function getStateWithoutConstantKeys(state) {
+  if (!state)
+    return {};
+  const _a = state, { messages, tools, copilotkit } = _a, stateWithoutConstantKeys = __objRest(_a, ["messages", "tools", "copilotkit"]);
+  return stateWithoutConstantKeys;
+}
+function areStatesEquals(a, b) {
+  if (a && !b || !a && b)
+    return false;
+  const _a = a, { messages, tools, copilotkit } = _a, aWithoutConstantKeys = __objRest(_a, ["messages", "tools", "copilotkit"]);
+  const _b = b, {
+    messages: bMessages,
+    tools: bTools,
+    copilotkit: bCopilotkit
+  } = _b, bWithoutConstantKeys = __objRest(_b, [
+    "messages",
+    "tools",
+    "copilotkit"
+  ]);
+  return JSON.stringify(aWithoutConstantKeys) === JSON.stringify(bWithoutConstantKeys);
+}
+function isPlaceholderMessageId(messageId) {
+  return !!messageId && messageId.startsWith("coagent-state-render-");
+}
+function isPlaceholderMessageName(messageName) {
+  return messageName === "coagent-state-render";
+}
+function readCachedMessageEntry(entry) {
+  if (!entry || typeof entry !== "object") {
+    return { snapshot: entry, runId: void 0 };
+  }
+  const snapshot = "snapshot" in entry ? entry.snapshot : entry;
+  const runId = "runId" in entry ? entry.runId : void 0;
+  return { snapshot, runId };
+}
+function getEffectiveRunId({
+  existingClaimRunId,
+  cachedMessageRunId,
+  runId
+}) {
+  return existingClaimRunId || cachedMessageRunId || runId || "pending";
+}
+function resolveClaim({
+  claims,
+  context,
+  stateSnapshot
+}) {
+  const { messageId, stateRenderId, runId, messageIndex } = context;
+  const existing = claims[messageId];
+  if (existing) {
+    const canRender = existing.stateRenderId === stateRenderId;
+    const shouldUpdateRunId = canRender && runId && (!existing.runId || existing.runId === "pending");
+    return {
+      canRender,
+      action: canRender ? "existing" /* Existing */ : "block" /* Block */,
+      updateRunId: shouldUpdateRunId ? runId : void 0
+    };
+  }
+  const normalizedRunId = runId != null ? runId : "pending";
+  const renderClaimedByOtherMessageEntry = Object.entries(claims).find(
+    ([, claim]) => {
+      var _a;
+      return claim.stateRenderId === stateRenderId && ((_a = claim.runId) != null ? _a : "pending") === normalizedRunId && (0, import_shared.dataToUUID)(getStateWithoutConstantKeys(claim.stateSnapshot)) === (0, import_shared.dataToUUID)(getStateWithoutConstantKeys(stateSnapshot));
+    }
+  );
+  const renderClaimedByOtherMessage = renderClaimedByOtherMessageEntry == null ? void 0 : renderClaimedByOtherMessageEntry[1];
+  const claimedMessageId = renderClaimedByOtherMessageEntry == null ? void 0 : renderClaimedByOtherMessageEntry[0];
+  if (renderClaimedByOtherMessage) {
+    if (messageIndex !== void 0 && renderClaimedByOtherMessage.messageIndex !== void 0 && messageIndex > renderClaimedByOtherMessage.messageIndex) {
+      return {
+        canRender: true,
+        action: "override" /* Override */,
+        nextClaim: { stateRenderId, runId, messageIndex },
+        lockOthers: runId === renderClaimedByOtherMessage.runId || isPlaceholderMessageId(claimedMessageId)
+      };
+    }
+    if (runId && renderClaimedByOtherMessage.runId && runId !== renderClaimedByOtherMessage.runId) {
+      return {
+        canRender: true,
+        action: "override" /* Override */,
+        nextClaim: { stateRenderId, runId, messageIndex },
+        lockOthers: isPlaceholderMessageId(claimedMessageId)
+      };
+    }
+    if (isPlaceholderMessageId(claimedMessageId)) {
+      return {
+        canRender: true,
+        action: "override" /* Override */,
+        nextClaim: { stateRenderId, runId, messageIndex },
+        lockOthers: true
+      };
+    }
+    if (stateSnapshot && renderClaimedByOtherMessage.stateSnapshot && !areStatesEquals(renderClaimedByOtherMessage.stateSnapshot, stateSnapshot)) {
+      return {
+        canRender: true,
+        action: "override" /* Override */,
+        nextClaim: { stateRenderId, runId }
+      };
+    }
+    return { canRender: false, action: "block" /* Block */ };
+  }
+  if (!runId) {
+    return { canRender: false, action: "block" /* Block */ };
+  }
+  return {
+    canRender: true,
+    action: "create" /* Create */,
+    nextClaim: { stateRenderId, runId, messageIndex }
+  };
+}
+function selectSnapshot({
+  messageId,
+  messageName,
+  allowLiveState,
+  skipLatestCache,
+  stateRenderId,
+  effectiveRunId,
+  stateSnapshotProp,
+  agentState,
+  agentMessages,
+  existingClaim,
+  caches
+}) {
+  var _a, _b, _c, _d, _e, _f;
+  const lastAssistantId = agentMessages ? (_a = [...agentMessages].reverse().find((msg) => msg.role === "assistant")) == null ? void 0 : _a.id : void 0;
+  const latestSnapshot = stateRenderId !== void 0 ? caches.byStateRenderAndRun[`${stateRenderId}::latest`] : void 0;
+  const messageIndex = agentMessages ? agentMessages.findIndex((msg) => msg.id === messageId) : -1;
+  const messageRole = messageIndex >= 0 && agentMessages ? (_b = agentMessages[messageIndex]) == null ? void 0 : _b.role : void 0;
+  let previousUserMessageId;
+  if (messageIndex > 0 && agentMessages) {
+    for (let i = messageIndex - 1; i >= 0; i -= 1) {
+      if (((_c = agentMessages[i]) == null ? void 0 : _c.role) === "user") {
+        previousUserMessageId = (_d = agentMessages[i]) == null ? void 0 : _d.id;
+        break;
+      }
+    }
+  }
+  const liveStateIsStale = stateSnapshotProp === void 0 && latestSnapshot !== void 0 && agentState !== void 0 && areStatesEquals(latestSnapshot, agentState);
+  const shouldUseLiveState = (Boolean(allowLiveState) || !lastAssistantId || messageId === lastAssistantId) && !liveStateIsStale;
+  const snapshot = stateSnapshotProp ? (0, import_shared.parseJson)(stateSnapshotProp, stateSnapshotProp) : shouldUseLiveState ? agentState : void 0;
+  const hasSnapshotKeys = !!(snapshot && Object.keys(snapshot).length > 0);
+  const allowEmptySnapshot = snapshot !== void 0 && !hasSnapshotKeys && (stateSnapshotProp !== void 0 || shouldUseLiveState);
+  const messageCacheEntry = caches.byMessageId[messageId];
+  const cachedMessageSnapshot = readCachedMessageEntry(messageCacheEntry).snapshot;
+  const cacheKey = stateRenderId !== void 0 ? `${stateRenderId}::${effectiveRunId}` : void 0;
+  let cachedSnapshot = cachedMessageSnapshot != null ? cachedMessageSnapshot : caches.byMessageId[messageId];
+  if (cachedSnapshot === void 0 && cacheKey && caches.byStateRenderAndRun[cacheKey] !== void 0) {
+    cachedSnapshot = caches.byStateRenderAndRun[cacheKey];
+  }
+  if (cachedSnapshot === void 0 && stateRenderId && previousUserMessageId && caches.byStateRenderAndRun[`${stateRenderId}::pending:${previousUserMessageId}`] !== void 0) {
+    cachedSnapshot = caches.byStateRenderAndRun[`${stateRenderId}::pending:${previousUserMessageId}`];
+  }
+  if (cachedSnapshot === void 0 && !skipLatestCache && stateRenderId && messageRole !== "assistant" && (stateSnapshotProp !== void 0 || agentState && Object.keys(agentState).length > 0)) {
+    cachedSnapshot = caches.byStateRenderAndRun[`${stateRenderId}::latest`];
+  }
+  const snapshotForClaim = (existingClaim == null ? void 0 : existingClaim.locked) ? (_e = existingClaim.stateSnapshot) != null ? _e : cachedSnapshot : hasSnapshotKeys ? snapshot : (_f = existingClaim == null ? void 0 : existingClaim.stateSnapshot) != null ? _f : cachedSnapshot;
+  return { snapshot, hasSnapshotKeys, cachedSnapshot, allowEmptySnapshot, snapshotForClaim };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ClaimAction,
+  RenderStatus,
+  areStatesEquals,
+  getEffectiveRunId,
+  isPlaceholderMessageId,
+  isPlaceholderMessageName,
+  readCachedMessageEntry,
+  resolveClaim,
+  selectSnapshot
+});
+//# sourceMappingURL=use-coagent-state-render-bridge.helpers.js.map

package/dist/hooks/use-coagent-state-render-bridge.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-coagent-state-render-bridge.helpers.ts"],"sourcesContent":["import { dataToUUID, parseJson } from \"@copilotkit/shared\";\n\nexport enum RenderStatus {\n  InProgress = \"inProgress\",\n  Complete = \"complete\",\n}\n\nexport enum ClaimAction {\n  Create = \"create\",\n  Override = \"override\",\n  Existing = \"existing\",\n  Block = \"block\",\n}\n\nexport interface StateRenderContext {\n  agentId: string;\n  stateRenderId: string;\n  messageId: string;\n  runId: string;\n  messageIndex?: number;\n}\n\nexport interface Claim {\n  stateRenderId: string;\n  runId?: string;\n  stateSnapshot?: any;\n  locked?: boolean;\n  messageIndex?: number;\n}\n\nexport type ClaimsByMessageId = Record<string, Claim>;\n\nexport interface ClaimResolution {\n  canRender: boolean;\n  action: ClaimAction;\n  nextClaim?: Claim;\n  lockOthers?: boolean;\n  updateRunId?: string;\n}\n\nexport interface SnapshotCaches {\n  byStateRenderAndRun: Record<string, any>;\n  byMessageId: Record<string, any>;\n}\n\nexport interface SnapshotSelectionInput {\n  messageId: string;\n  messageName?: string;\n  allowLiveState?: boolean;\n  skipLatestCache?: boolean;\n  stateRenderId?: string;\n  effectiveRunId: string;\n  stateSnapshotProp?: any;\n  agentState?: any;\n  agentMessages?: Array<{ id: string; role?: string }>;\n  existingClaim?: Claim;\n  caches: SnapshotCaches;\n}\n\nexport interface SnapshotSelectionResult {\n  snapshot?: any;\n  hasSnapshotKeys: boolean;\n  cachedSnapshot?: any;\n  allowEmptySnapshot?: boolean;\n  snapshotForClaim?: any;\n}\n\nfunction getStateWithoutConstantKeys(state: any) {\n  if (!state) return {};\n  const { messages, tools, copilotkit, ...stateWithoutConstantKeys } = state;\n  return stateWithoutConstantKeys;\n}\n\n// Function that compares states, without the constant keys\nexport function areStatesEquals(a: any, b: any) {\n  if ((a && !b) || (!a && b)) return false;\n  const { messages, tools, copilotkit, ...aWithoutConstantKeys } = a;\n  const {\n    messages: bMessages,\n    tools: bTools,\n    copilotkit: bCopilotkit,\n    ...bWithoutConstantKeys\n  } = b;\n\n  return JSON.stringify(aWithoutConstantKeys) === JSON.stringify(bWithoutConstantKeys);\n}\n\nexport function isPlaceholderMessageId(messageId: string | undefined) {\n  return !!messageId && messageId.startsWith(\"coagent-state-render-\");\n}\n\nexport function isPlaceholderMessageName(messageName: string | undefined) {\n  return messageName === \"coagent-state-render\";\n}\n\nexport function readCachedMessageEntry(entry: any): { snapshot?: any; runId?: string } {\n  if (!entry || typeof entry !== \"object\") {\n    return { snapshot: entry, runId: undefined };\n  }\n  const snapshot = \"snapshot\" in entry ? entry.snapshot : entry;\n  const runId = \"runId\" in entry ? entry.runId : undefined;\n  return { snapshot, runId };\n}\n\nexport function getEffectiveRunId({\n  existingClaimRunId,\n  cachedMessageRunId,\n  runId,\n}: {\n  existingClaimRunId?: string;\n  cachedMessageRunId?: string;\n  runId?: string;\n}) {\n  return existingClaimRunId || cachedMessageRunId || runId || \"pending\";\n}\n\n/**\n * Resolve whether a message can claim a render slot.\n * This is a pure decision function; the caller applies claim mutations.\n */\nexport function resolveClaim({\n  claims,\n  context,\n  stateSnapshot,\n}: {\n  claims: ClaimsByMessageId;\n  context: StateRenderContext;\n  stateSnapshot?: any;\n}): ClaimResolution {\n  const { messageId, stateRenderId, runId, messageIndex } = context;\n  const existing = claims[messageId];\n\n  if (existing) {\n    const canRender = existing.stateRenderId === stateRenderId;\n    const shouldUpdateRunId =\n      canRender && runId && (!existing.runId || existing.runId === \"pending\");\n    return {\n      canRender,\n      action: canRender ? ClaimAction.Existing : ClaimAction.Block,\n      updateRunId: shouldUpdateRunId ? runId : undefined,\n    };\n  }\n\n  const normalizedRunId = runId ?? \"pending\";\n  const renderClaimedByOtherMessageEntry = Object.entries(claims).find(\n    ([, claim]) =>\n      claim.stateRenderId === stateRenderId &&\n      (claim.runId ?? \"pending\") === normalizedRunId &&\n      dataToUUID(getStateWithoutConstantKeys(claim.stateSnapshot)) ===\n        dataToUUID(getStateWithoutConstantKeys(stateSnapshot)),\n  );\n\n  const renderClaimedByOtherMessage = renderClaimedByOtherMessageEntry?.[1];\n  const claimedMessageId = renderClaimedByOtherMessageEntry?.[0];\n\n  if (renderClaimedByOtherMessage) {\n    if (\n      messageIndex !== undefined &&\n      renderClaimedByOtherMessage.messageIndex !== undefined &&\n      messageIndex > renderClaimedByOtherMessage.messageIndex\n    ) {\n      return {\n        canRender: true,\n        action: ClaimAction.Override,\n        nextClaim: { stateRenderId, runId, messageIndex },\n        lockOthers:\n          runId === renderClaimedByOtherMessage.runId || isPlaceholderMessageId(claimedMessageId),\n      };\n    }\n\n    if (runId && renderClaimedByOtherMessage.runId && runId !== renderClaimedByOtherMessage.runId) {\n      return {\n        canRender: true,\n        action: ClaimAction.Override,\n        nextClaim: { stateRenderId, runId, messageIndex },\n        lockOthers: isPlaceholderMessageId(claimedMessageId),\n      };\n    }\n\n    if (isPlaceholderMessageId(claimedMessageId)) {\n      return {\n        canRender: true,\n        action: ClaimAction.Override,\n        nextClaim: { stateRenderId, runId, messageIndex },\n        lockOthers: true,\n      };\n    }\n\n    if (\n      stateSnapshot &&\n      renderClaimedByOtherMessage.stateSnapshot &&\n      !areStatesEquals(renderClaimedByOtherMessage.stateSnapshot, stateSnapshot)\n    ) {\n      return {\n        canRender: true,\n        action: ClaimAction.Override,\n        nextClaim: { stateRenderId, runId },\n      };\n    }\n\n    return { canRender: false, action: ClaimAction.Block };\n  }\n\n  if (!runId) {\n    return { canRender: false, action: ClaimAction.Block };\n  }\n\n  return {\n    canRender: true,\n    action: ClaimAction.Create,\n    nextClaim: { stateRenderId, runId, messageIndex },\n  };\n}\n\n/**\n * Select the best snapshot to render for this message.\n * Priority order is:\n * 1) explicit message snapshot\n * 2) live agent state (latest assistant only)\n * 3) cached snapshot for message\n * 4) cached snapshot for stateRenderId+runId\n * 5) last cached snapshot for stateRenderId\n */\nexport function selectSnapshot({\n  messageId,\n  messageName,\n  allowLiveState,\n  skipLatestCache,\n  stateRenderId,\n  effectiveRunId,\n  stateSnapshotProp,\n  agentState,\n  agentMessages,\n  existingClaim,\n  caches,\n}: SnapshotSelectionInput): SnapshotSelectionResult {\n  const lastAssistantId = agentMessages\n    ? [...agentMessages].reverse().find((msg) => msg.role === \"assistant\")?.id\n    : undefined;\n  const latestSnapshot =\n    stateRenderId !== undefined ? caches.byStateRenderAndRun[`${stateRenderId}::latest`] : undefined;\n  const messageIndex = agentMessages\n    ? agentMessages.findIndex((msg) => msg.id === messageId)\n    : -1;\n  const messageRole =\n    messageIndex >= 0 && agentMessages ? agentMessages[messageIndex]?.role : undefined;\n  let previousUserMessageId: string | undefined;\n  if (messageIndex > 0 && agentMessages) {\n    for (let i = messageIndex - 1; i >= 0; i -= 1) {\n      if (agentMessages[i]?.role === \"user\") {\n        previousUserMessageId = agentMessages[i]?.id;\n        break;\n      }\n    }\n  }\n  const liveStateIsStale =\n    stateSnapshotProp === undefined &&\n    latestSnapshot !== undefined &&\n    agentState !== undefined &&\n    areStatesEquals(latestSnapshot, agentState);\n  const shouldUseLiveState =\n    (Boolean(allowLiveState) || !lastAssistantId || messageId === lastAssistantId) &&\n    !liveStateIsStale;\n  const snapshot = stateSnapshotProp\n    ? parseJson(stateSnapshotProp, stateSnapshotProp)\n    : shouldUseLiveState\n      ? agentState\n      : undefined;\n  const hasSnapshotKeys = !!(snapshot && Object.keys(snapshot).length > 0);\n  const allowEmptySnapshot =\n    snapshot !== undefined &&\n    !hasSnapshotKeys &&\n    (stateSnapshotProp !== undefined || shouldUseLiveState);\n\n  const messageCacheEntry = caches.byMessageId[messageId];\n  const cachedMessageSnapshot = readCachedMessageEntry(messageCacheEntry).snapshot;\n  const cacheKey =\n    stateRenderId !== undefined ? `${stateRenderId}::${effectiveRunId}` : undefined;\n  let cachedSnapshot = cachedMessageSnapshot ?? caches.byMessageId[messageId];\n  if (cachedSnapshot === undefined && cacheKey && caches.byStateRenderAndRun[cacheKey] !== undefined) {\n    cachedSnapshot = caches.byStateRenderAndRun[cacheKey];\n  }\n  if (\n    cachedSnapshot === undefined &&\n    stateRenderId &&\n    previousUserMessageId &&\n    caches.byStateRenderAndRun[`${stateRenderId}::pending:${previousUserMessageId}`] !==\n      undefined\n  ) {\n    cachedSnapshot =\n      caches.byStateRenderAndRun[`${stateRenderId}::pending:${previousUserMessageId}`];\n  }\n  if (\n    cachedSnapshot === undefined &&\n    !skipLatestCache &&\n    stateRenderId &&\n    messageRole !== \"assistant\" &&\n    (stateSnapshotProp !== undefined ||\n      (agentState && Object.keys(agentState).length > 0))\n  ) {\n    cachedSnapshot = caches.byStateRenderAndRun[`${stateRenderId}::latest`];\n  }\n\n  const snapshotForClaim = existingClaim?.locked\n    ? existingClaim.stateSnapshot ?? cachedSnapshot\n    : hasSnapshotKeys\n      ? snapshot\n      : existingClaim?.stateSnapshot ?? cachedSnapshot;\n\n  return { snapshot, hasSnapshotKeys, cachedSnapshot, allowEmptySnapshot, snapshotForClaim };\n}\n"],"mappings":"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","names":["RenderStatus","ClaimAction"]}

package/dist/hooks/use-coagent-state-render-bridge.helpers.mjs

@@ -0,0 +1,24 @@
+import {
+  ClaimAction,
+  RenderStatus,
+  areStatesEquals,
+  getEffectiveRunId,
+  isPlaceholderMessageId,
+  isPlaceholderMessageName,
+  readCachedMessageEntry,
+  resolveClaim,
+  selectSnapshot
+} from "../chunk-C3YJYDK4.mjs";
+import "../chunk-SKC7AJIV.mjs";
+export {
+  ClaimAction,
+  RenderStatus,
+  areStatesEquals,
+  getEffectiveRunId,
+  isPlaceholderMessageId,
+  isPlaceholderMessageName,
+  readCachedMessageEntry,
+  resolveClaim,
+  selectSnapshot
+};
+//# sourceMappingURL=use-coagent-state-render-bridge.helpers.mjs.map

package/dist/hooks/use-coagent-state-render-bridge.helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}