@copilotkit/react-core 1.51.5-next.0 → 1.51.5-next.1

package/dist/hooks/use-agent-nodename.js

@@ -1,56 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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-agent-nodename.ts
-var use_agent_nodename_exports = {};
-__export(use_agent_nodename_exports, {
-  useAgentNodeName: () => useAgentNodeName
-});
-module.exports = __toCommonJS(use_agent_nodename_exports);
-var import_react = require("react");
-var import_react2 = require("@copilotkitnext/react");
-function useAgentNodeName(agentName) {
-  const { agent } = (0, import_react2.useAgent)({ agentId: agentName });
-  const nodeNameRef = (0, import_react.useRef)("start");
-  (0, import_react.useEffect)(() => {
-    if (!agent)
-      return;
-    const subscriber = {
-      onStepStartedEvent: ({ event }) => {
-        nodeNameRef.current = event.stepName;
-      },
-      onRunStartedEvent: () => {
-        nodeNameRef.current = "start";
-      },
-      onRunFinishedEvent: () => {
-        nodeNameRef.current = "end";
-      }
-    };
-    const subscription = agent.subscribe(subscriber);
-    return () => {
-      subscription.unsubscribe();
-    };
-  }, [agent]);
-  return nodeNameRef.current;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  useAgentNodeName
-});
-//# sourceMappingURL=use-agent-nodename.js.map

package/dist/hooks/use-agent-nodename.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/hooks/use-agent-nodename.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { AgentSubscriber } from \"@ag-ui/client\";\nimport { useAgent } from \"@copilotkitnext/react\";\n\nexport function useAgentNodeName(agentName?: string) {\n  const { agent } = useAgent({ agentId: agentName });\n  const nodeNameRef = useRef<string>(\"start\");\n\n  useEffect(() => {\n    if (!agent) return;\n    const subscriber: AgentSubscriber = {\n      onStepStartedEvent: ({ event }) => {\n        nodeNameRef.current = event.stepName;\n      },\n      onRunStartedEvent: () => {\n        nodeNameRef.current = \"start\";\n      },\n      onRunFinishedEvent: () => {\n        nodeNameRef.current = \"end\";\n      },\n    };\n\n    const subscription = agent.subscribe(subscriber);\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [agent]);\n\n  return nodeNameRef.current;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAElC,IAAAA,gBAAyB;AAElB,SAAS,iBAAiB,WAAoB;AACnD,QAAM,EAAE,MAAM,QAAI,wBAAS,EAAE,SAAS,UAAU,CAAC;AACjD,QAAM,kBAAc,qBAAe,OAAO;AAE1C,8BAAU,MAAM;AACd,QAAI,CAAC;AAAO;AACZ,UAAM,aAA8B;AAAA,MAClC,oBAAoB,CAAC,EAAE,MAAM,MAAM;AACjC,oBAAY,UAAU,MAAM;AAAA,MAC9B;AAAA,MACA,mBAAmB,MAAM;AACvB,oBAAY,UAAU;AAAA,MACxB;AAAA,MACA,oBAAoB,MAAM;AACxB,oBAAY,UAAU;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,eAAe,MAAM,UAAU,UAAU;AAC/C,WAAO,MAAM;AACX,mBAAa,YAAY;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO,YAAY;AACrB;","names":["import_react"]}

package/dist/hooks/use-agent-nodename.mjs

@@ -1,8 +0,0 @@
-import {
-  useAgentNodeName
-} from "../chunk-I76HKHPJ.mjs";
-import "../chunk-SKC7AJIV.mjs";
-export {
-  useAgentNodeName
-};
-//# sourceMappingURL=use-agent-nodename.mjs.map

package/dist/hooks/use-agent-nodename.mjs.map

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

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

@@ -1,100 +0,0 @@
-import * as React from 'react';
-import { ReactCustomMessageRendererPosition } from '@copilotkitnext/react';
-
-/**
- * Bridge hook that connects agent state renders to chat messages.
- *
- * ## Purpose
- * This hook finds matching state render configurations (registered via useCoAgentStateRender)
- * and returns UI to render in chat.
- * It ensures each state render appears bound to a specific message, preventing duplicates while
- * allowing re-binding when the underlying state changes significantly.
- *
- * ## Message-ID-Based Claiming System
- *
- * ### The Problem
- * Multiple bridge component instances render simultaneously (one per message). Without coordination,
- * they would all try to render the same state render, causing duplicates.
- *
- * ### The Solution: Message-ID Claims with State Comparison
- * Each state render is "claimed" by exactly one **message ID** (not runId):
- *
- * **Claim Structure**: `claimsRef.current[messageId] = { stateRenderId, runId, stateSnapshot, locked }`
- *
- * **Primary binding is by messageId because**:
- * - runId is not always available immediately (starts as "pending")
- * - messageId is the stable identifier throughout the message lifecycle
- * - Claims persist across component remounts via context ref
- *
- * ### Claiming Logic Flow
- *
- * 1. **Message already has a claim**:
- *    - Check if the claim matches the current stateRenderId
- *    - If yes → render (this message owns this render)
- *    - Update runId if it was "pending" and now available
- *
- * 2. **State render claimed by another message**:
- *    - Compare state snapshots (ignoring constant keys: messages, tools, copilotkit)
- *    - If states are identical → block rendering (duplicate)
- *    - **If states are different → allow claiming** (new data, new message)
- *    - This handles cases where the same render type shows different states in different messages
- *
- * 3. **Unclaimed state render**:
- *    - Only allow claiming if runId is "pending" (initial render)
- *    - If runId is real but no claim exists → block (edge case protection)
- *    - Create new claim: `claimsRef.current[messageId] = { stateRenderId, runId }`
- *
- * ### State Snapshot Locking
- *
- * Once a state snapshot is captured and locked for a message:
- * - The UI always renders with the locked snapshot (not live agent.state)
- * - Prevents UI from appearing "wiped" during state transitions
- * - Locked when: stateSnapshot prop is available (from message persistence)
- * - Unlocked state: can still update from live agent.state
- *
- * ### Synchronous Claiming (Ref-based)
- *
- * Claims are stored in a context-level ref (not React state):
- * - Multiple bridges render in the same tick
- * - State updates are async - would allow duplicates before update completes
- * - Ref provides immediate, synchronous claim checking
- * - Survives component remounts (stored in context, not component)
- *
- * ## Flow Example
- *
- * ```
- * Time 1: Message A renders, runId=undefined, state={progress: 50%}
- *   → effectiveRunId = "pending"
- *   → Claims: claimsRef["msgA"] = { stateRenderId: "tasks", runId: "pending", stateSnapshot: {progress: 50%} }
- *   → Renders UI with 50% progress
- *
- * Time 2: Message B renders, runId=undefined, same state
- *   → Checks: "tasks" already claimed by msgA with same state
- *   → Returns null (blocked - duplicate)
- *
- * Time 3: Real runId appears (e.g., "run-123")
- *   → Updates claim: claimsRef["msgA"].runId = "run-123"
- *   → Message A continues rendering
- *
- * Time 4: Agent processes more, state={progress: 100%}
- *   → Message A: locked to 50% (stateSnapshot locked)
- *   → Message C renders with state={progress: 100%}
- *   → Checks: "tasks" claimed by msgA but state is DIFFERENT (50% vs 100%)
- *   → Allows new claim: claimsRef["msgC"] = { stateRenderId: "tasks", runId: "run-123", stateSnapshot: {progress: 100%} }
- *   → Both messages render independently with their own snapshots
- * ```
- */
-interface CoAgentStateRenderBridgeProps {
-    message: any;
-    position: ReactCustomMessageRendererPosition;
-    runId: string;
-    messageIndex: number;
-    messageIndexInRun: number;
-    numberOfMessagesInRun: number;
-    agentId: string;
-    stateSnapshot: any;
-}
-declare function useCoagentStateRenderBridge(agentId: string, props: CoAgentStateRenderBridgeProps): string | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | null | undefined;
-declare function CoAgentStateRenderBridge(props: CoAgentStateRenderBridgeProps): string | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | null | undefined;
-
-export { CoAgentStateRenderBridge, CoAgentStateRenderBridgeProps, useCoagentStateRenderBridge };

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

@@ -1,92 +0,0 @@
-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

@@ -1,237 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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 (\n    JSON.stringify(aWithoutConstantKeys) ===\n    JSON.stringify(bWithoutConstantKeys)\n  );\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): {\n  snapshot?: any;\n  runId?: string;\n} {\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 ||\n          isPlaceholderMessageId(claimedMessageId),\n      };\n    }\n\n    if (\n      runId &&\n      renderClaimedByOtherMessage.runId &&\n      runId !== renderClaimedByOtherMessage.runId\n    ) {\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\n      ? caches.byStateRenderAndRun[`${stateRenderId}::latest`]\n      : undefined;\n  const messageIndex = agentMessages\n    ? agentMessages.findIndex((msg) => msg.id === messageId)\n    : -1;\n  const messageRole =\n    messageIndex >= 0 && agentMessages\n      ? agentMessages[messageIndex]?.role\n      : 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) ||\n      !lastAssistantId ||\n      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 =\n    readCachedMessageEntry(messageCacheEntry).snapshot;\n  const cacheKey =\n    stateRenderId !== undefined\n      ? `${stateRenderId}::${effectiveRunId}`\n      : undefined;\n  let cachedSnapshot = cachedMessageSnapshot ?? caches.byMessageId[messageId];\n  if (\n    cachedSnapshot === undefined &&\n    cacheKey &&\n    caches.byStateRenderAndRun[cacheKey] !== undefined\n  ) {\n    cachedSnapshot = caches.byStateRenderAndRun[cacheKey];\n  }\n  if (\n    cachedSnapshot === undefined &&\n    stateRenderId &&\n    previousUserMessageId &&\n    caches.byStateRenderAndRun[\n      `${stateRenderId}::pending:${previousUserMessageId}`\n    ] !== undefined\n  ) {\n    cachedSnapshot =\n      caches.byStateRenderAndRun[\n        `${stateRenderId}::pending:${previousUserMessageId}`\n      ];\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 {\n    snapshot,\n    hasSnapshotKeys,\n    cachedSnapshot,\n    allowEmptySnapshot,\n    snapshotForClaim,\n  };\n}\n"],"mappings":"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","names":["RenderStatus","ClaimAction"]}

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

@@ -1,24 +0,0 @@
-import {
-  ClaimAction,
-  RenderStatus,
-  areStatesEquals,
-  getEffectiveRunId,
-  isPlaceholderMessageId,
-  isPlaceholderMessageName,
-  readCachedMessageEntry,
-  resolveClaim,
-  selectSnapshot
-} from "../chunk-7GIBHX6X.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

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