@copilotkitnext/react 1.54.0-next.9 → 1.54.1-next.0

package/dist/hooks/index.cjs

@@ -11,3 +11,4 @@ const require_use_agent_context = require('./use-agent-context.cjs');
 const require_use_suggestions = require('./use-suggestions.cjs');
 const require_use_configure_suggestions = require('./use-configure-suggestions.cjs');
 const require_use_interrupt = require('./use-interrupt.cjs');
+const require_use_threads = require('./use-threads.cjs');

package/dist/hooks/index.d.cts

@@ -10,4 +10,5 @@ import { UseAgentUpdate, useAgent } from "./use-agent.cjs";
 import { AgentContextInput, JsonSerializable, useAgentContext } from "./use-agent-context.cjs";
 import { useSuggestions } from "./use-suggestions.cjs";
 import { useConfigureSuggestions } from "./use-configure-suggestions.cjs";
-import { UseInterruptConfig, useInterrupt } from "./use-interrupt.cjs";
+import { UseInterruptConfig, useInterrupt } from "./use-interrupt.cjs";
+import { Thread, UseThreadsInput, UseThreadsResult, useThreads } from "./use-threads.cjs";

package/dist/hooks/index.d.mts

@@ -10,4 +10,5 @@ import { UseAgentUpdate, useAgent } from "./use-agent.mjs";
 import { AgentContextInput, JsonSerializable, useAgentContext } from "./use-agent-context.mjs";
 import { useSuggestions } from "./use-suggestions.mjs";
 import { useConfigureSuggestions } from "./use-configure-suggestions.mjs";
-import { UseInterruptConfig, useInterrupt } from "./use-interrupt.mjs";
+import { UseInterruptConfig, useInterrupt } from "./use-interrupt.mjs";
+import { Thread, UseThreadsInput, UseThreadsResult, useThreads } from "./use-threads.mjs";

package/dist/hooks/index.mjs

@@ -11,5 +11,6 @@ import { useAgentContext } from "./use-agent-context.mjs";
 import { useSuggestions } from "./use-suggestions.mjs";
 import { useConfigureSuggestions } from "./use-configure-suggestions.mjs";
 import { useInterrupt } from "./use-interrupt.mjs";
+import { useThreads } from "./use-threads.mjs";
 
 export {  };

package/dist/hooks/use-agent.cjs

@@ -39,7 +39,8 @@ function useAgent({ agentId, updates } = {}) {
 			const provisional = new _copilotkitnext_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
 				agentId,
-				transport: copilotkit.runtimeTransport
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
 			});
 			provisional.headers = { ...copilotkit.headers };
 			provisionalAgentCache.current.set(agentId, provisional);
@@ -49,7 +50,8 @@ function useAgent({ agentId, updates } = {}) {
 			const provisional = new _copilotkitnext_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
 				agentId,
-				transport: copilotkit.runtimeTransport
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
 			});
 			provisional.headers = { ...copilotkit.headers };
 			return provisional;

package/dist/hooks/use-agent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent.cjs","names":["DEFAULT_AGENT_ID","useCopilotKit","CopilotKitCoreRuntimeConnectionStatus","ProxiedCopilotRuntimeAgent"],"sources":["../../src/hooks/use-agent.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport { useMemo, useEffect, useReducer, useRef } from \"react\";\nimport { DEFAULT_AGENT_ID } from \"@copilotkitnext/shared\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport {\n  ProxiedCopilotRuntimeAgent,\n  CopilotKitCoreRuntimeConnectionStatus,\n} from \"@copilotkitnext/core\";\n\nexport enum UseAgentUpdate {\n  OnMessagesChanged = \"OnMessagesChanged\",\n  OnStateChanged = \"OnStateChanged\",\n  OnRunStatusChanged = \"OnRunStatusChanged\",\n}\n\nconst ALL_UPDATES: UseAgentUpdate[] = [\n  UseAgentUpdate.OnMessagesChanged,\n  UseAgentUpdate.OnStateChanged,\n  UseAgentUpdate.OnRunStatusChanged,\n];\n\nexport interface UseAgentProps {\n  agentId?: string;\n  updates?: UseAgentUpdate[];\n}\n\nexport function useAgent({ agentId, updates }: UseAgentProps = {}) {\n  agentId ??= DEFAULT_AGENT_ID;\n\n  const { copilotkit } = useCopilotKit();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  const updateFlags = useMemo(\n    () => updates ?? ALL_UPDATES,\n    [JSON.stringify(updates)],\n  );\n\n  // Cache provisional agents to avoid creating new references on every render\n  // while the runtime is still connecting. A new reference would cascade into\n  // CopilotChat's connectAgent effect, causing unnecessary HTTP calls.\n  const provisionalAgentCache = useRef<Map<string, ProxiedCopilotRuntimeAgent>>(\n    new Map(),\n  );\n\n  const agent: AbstractAgent = useMemo(() => {\n    const existing = copilotkit.getAgent(agentId);\n    if (existing) {\n      // Real agent found — clear any cached provisional for this ID\n      provisionalAgentCache.current.delete(agentId);\n      return existing;\n    }\n\n    const isRuntimeConfigured = copilotkit.runtimeUrl !== undefined;\n    const status = copilotkit.runtimeConnectionStatus;\n\n    // While runtime is not yet synced, return a provisional runtime agent\n    if (\n      isRuntimeConfigured &&\n      (status === CopilotKitCoreRuntimeConnectionStatus.Disconnected ||\n        status === CopilotKitCoreRuntimeConnectionStatus.Connecting)\n    ) {\n      // Return cached provisional if available (keeps reference stable)\n      const cached = provisionalAgentCache.current.get(agentId);\n      if (cached) {\n        // Update headers on the cached agent in case they changed\n        cached.headers = { ...copilotkit.headers };\n        return cached;\n      }\n\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n      });\n      // Apply current headers so runs/connects inherit them\n      provisional.headers = { ...copilotkit.headers };\n      provisionalAgentCache.current.set(agentId, provisional);\n      return provisional;\n    }\n\n    // Runtime is in Error state — return a provisional agent instead of throwing.\n    // The error has already been emitted through the subscriber system\n    // (RUNTIME_INFO_FETCH_FAILED). Throwing here would crash the React tree;\n    // returning a provisional agent lets onError handlers fire while keeping\n    // the app alive.\n    if (\n      isRuntimeConfigured &&\n      status === CopilotKitCoreRuntimeConnectionStatus.Error\n    ) {\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n      });\n      provisional.headers = { ...copilotkit.headers };\n      return provisional;\n    }\n\n    // No runtime configured and agent doesn't exist — this is a configuration error.\n    const knownAgents = Object.keys(copilotkit.agents ?? {});\n    const runtimePart = isRuntimeConfigured\n      ? `runtimeUrl=${copilotkit.runtimeUrl}`\n      : \"no runtimeUrl\";\n    throw new Error(\n      `useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` +\n        (knownAgents.length\n          ? `Known agents: [${knownAgents.join(\", \")}]`\n          : \"No agents registered.\") +\n        \" Verify your runtime /info and/or agents__unsafe_dev_only.\",\n    );\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    agentId,\n    copilotkit.agents,\n    copilotkit.runtimeConnectionStatus,\n    copilotkit.runtimeUrl,\n    copilotkit.runtimeTransport,\n    JSON.stringify(copilotkit.headers),\n  ]);\n\n  useEffect(() => {\n    if (updateFlags.length === 0) {\n      return;\n    }\n\n    const handlers: Parameters<AbstractAgent[\"subscribe\"]>[0] = {};\n\n    if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {\n      // Content stripping for immutableContent renderers is handled by CopilotKitCoreReact\n      handlers.onMessagesChanged = () => {\n        forceUpdate();\n      };\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) {\n      handlers.onStateChanged = forceUpdate;\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {\n      handlers.onRunInitialized = forceUpdate;\n      handlers.onRunFinalized = forceUpdate;\n      handlers.onRunFailed = forceUpdate;\n    }\n\n    const subscription = agent.subscribe(handlers);\n    return () => subscription.unsubscribe();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [agent, forceUpdate, JSON.stringify(updateFlags)]);\n\n  return {\n    agent,\n  };\n}\n"],"mappings":";;;;;;;AASA,IAAY,0DAAL;AACL;AACA;AACA;;;AAGF,MAAM,cAAgC;CACpC,eAAe;CACf,eAAe;CACf,eAAe;CAChB;AAOD,SAAgB,SAAS,EAAE,SAAS,YAA2B,EAAE,EAAE;AACjE,aAAYA;CAEZ,MAAM,EAAE,eAAeC,0CAAe;CACtC,MAAM,GAAG,sCAA2B,MAAM,IAAI,GAAG,EAAE;CAEnD,MAAM,uCACE,WAAW,aACjB,CAAC,KAAK,UAAU,QAAQ,CAAC,CAC1B;CAKD,MAAM,0DACJ,IAAI,KAAK,CACV;CAED,MAAM,iCAAqC;EACzC,MAAM,WAAW,WAAW,SAAS,QAAQ;AAC7C,MAAI,UAAU;AAEZ,yBAAsB,QAAQ,OAAO,QAAQ;AAC7C,UAAO;;EAGT,MAAM,sBAAsB,WAAW,eAAe;EACtD,MAAM,SAAS,WAAW;AAG1B,MACE,wBACC,WAAWC,2DAAsC,gBAChD,WAAWA,2DAAsC,aACnD;GAEA,MAAM,SAAS,sBAAsB,QAAQ,IAAI,QAAQ;AACzD,OAAI,QAAQ;AAEV,WAAO,UAAU,EAAE,GAAG,WAAW,SAAS;AAC1C,WAAO;;GAGT,MAAM,cAAc,IAAIC,gDAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACvB,CAAC;AAEF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,yBAAsB,QAAQ,IAAI,SAAS,YAAY;AACvD,UAAO;;AAQT,MACE,uBACA,WAAWD,2DAAsC,OACjD;GACA,MAAM,cAAc,IAAIC,gDAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACvB,CAAC;AACF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,UAAO;;EAIT,MAAM,cAAc,OAAO,KAAK,WAAW,UAAU,EAAE,CAAC;EACxD,MAAM,cAAc,sBAChB,cAAc,WAAW,eACzB;AACJ,QAAM,IAAI,MACR,oBAAoB,QAAQ,kCAAkC,YAAY,QACvE,YAAY,SACT,kBAAkB,YAAY,KAAK,KAAK,CAAC,KACzC,2BACJ,6DACH;IAEA;EACD;EACA,WAAW;EACX,WAAW;EACX,WAAW;EACX,WAAW;EACX,KAAK,UAAU,WAAW,QAAQ;EACnC,CAAC;AAEF,4BAAgB;AACd,MAAI,YAAY,WAAW,EACzB;EAGF,MAAM,WAAsD,EAAE;AAE9D,MAAI,YAAY,SAAS,eAAe,kBAAkB,CAExD,UAAS,0BAA0B;AACjC,gBAAa;;AAIjB,MAAI,YAAY,SAAS,eAAe,eAAe,CACrD,UAAS,iBAAiB;AAG5B,MAAI,YAAY,SAAS,eAAe,mBAAmB,EAAE;AAC3D,YAAS,mBAAmB;AAC5B,YAAS,iBAAiB;AAC1B,YAAS,cAAc;;EAGzB,MAAM,eAAe,MAAM,UAAU,SAAS;AAC9C,eAAa,aAAa,aAAa;IAEtC;EAAC;EAAO;EAAa,KAAK,UAAU,YAAY;EAAC,CAAC;AAErD,QAAO,EACL,OACD"}
+{"version":3,"file":"use-agent.cjs","names":["DEFAULT_AGENT_ID","useCopilotKit","CopilotKitCoreRuntimeConnectionStatus","ProxiedCopilotRuntimeAgent"],"sources":["../../src/hooks/use-agent.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport { useMemo, useEffect, useReducer, useRef } from \"react\";\nimport { DEFAULT_AGENT_ID } from \"@copilotkitnext/shared\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport {\n  ProxiedCopilotRuntimeAgent,\n  CopilotKitCoreRuntimeConnectionStatus,\n} from \"@copilotkitnext/core\";\n\nexport enum UseAgentUpdate {\n  OnMessagesChanged = \"OnMessagesChanged\",\n  OnStateChanged = \"OnStateChanged\",\n  OnRunStatusChanged = \"OnRunStatusChanged\",\n}\n\nconst ALL_UPDATES: UseAgentUpdate[] = [\n  UseAgentUpdate.OnMessagesChanged,\n  UseAgentUpdate.OnStateChanged,\n  UseAgentUpdate.OnRunStatusChanged,\n];\n\nexport interface UseAgentProps {\n  agentId?: string;\n  updates?: UseAgentUpdate[];\n}\n\nexport function useAgent({ agentId, updates }: UseAgentProps = {}) {\n  agentId ??= DEFAULT_AGENT_ID;\n\n  const { copilotkit } = useCopilotKit();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  const updateFlags = useMemo(\n    () => updates ?? ALL_UPDATES,\n    [JSON.stringify(updates)],\n  );\n\n  // Cache provisional agents to avoid creating new references on every render\n  // while the runtime is still connecting. A new reference would cascade into\n  // CopilotChat's connectAgent effect, causing unnecessary HTTP calls.\n  const provisionalAgentCache = useRef<Map<string, ProxiedCopilotRuntimeAgent>>(\n    new Map(),\n  );\n\n  const agent: AbstractAgent = useMemo(() => {\n    const existing = copilotkit.getAgent(agentId);\n    if (existing) {\n      // Real agent found — clear any cached provisional for this ID\n      provisionalAgentCache.current.delete(agentId);\n      return existing;\n    }\n\n    const isRuntimeConfigured = copilotkit.runtimeUrl !== undefined;\n    const status = copilotkit.runtimeConnectionStatus;\n\n    // While runtime is not yet synced, return a provisional runtime agent\n    if (\n      isRuntimeConfigured &&\n      (status === CopilotKitCoreRuntimeConnectionStatus.Disconnected ||\n        status === CopilotKitCoreRuntimeConnectionStatus.Connecting)\n    ) {\n      // Return cached provisional if available (keeps reference stable)\n      const cached = provisionalAgentCache.current.get(agentId);\n      if (cached) {\n        // Update headers on the cached agent in case they changed\n        cached.headers = { ...copilotkit.headers };\n        return cached;\n      }\n\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n        runtimeMode: \"pending\",\n      });\n      // Apply current headers so runs/connects inherit them\n      provisional.headers = { ...copilotkit.headers };\n      provisionalAgentCache.current.set(agentId, provisional);\n      return provisional;\n    }\n\n    // Runtime is in Error state — return a provisional agent instead of throwing.\n    // The error has already been emitted through the subscriber system\n    // (RUNTIME_INFO_FETCH_FAILED). Throwing here would crash the React tree;\n    // returning a provisional agent lets onError handlers fire while keeping\n    // the app alive.\n    if (\n      isRuntimeConfigured &&\n      status === CopilotKitCoreRuntimeConnectionStatus.Error\n    ) {\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n        runtimeMode: \"pending\",\n      });\n      provisional.headers = { ...copilotkit.headers };\n      return provisional;\n    }\n\n    // No runtime configured and agent doesn't exist — this is a configuration error.\n    const knownAgents = Object.keys(copilotkit.agents ?? {});\n    const runtimePart = isRuntimeConfigured\n      ? `runtimeUrl=${copilotkit.runtimeUrl}`\n      : \"no runtimeUrl\";\n    throw new Error(\n      `useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` +\n        (knownAgents.length\n          ? `Known agents: [${knownAgents.join(\", \")}]`\n          : \"No agents registered.\") +\n        \" Verify your runtime /info and/or agents__unsafe_dev_only.\",\n    );\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    agentId,\n    copilotkit.agents,\n    copilotkit.runtimeConnectionStatus,\n    copilotkit.runtimeUrl,\n    copilotkit.runtimeTransport,\n    JSON.stringify(copilotkit.headers),\n  ]);\n\n  useEffect(() => {\n    if (updateFlags.length === 0) {\n      return;\n    }\n\n    const handlers: Parameters<AbstractAgent[\"subscribe\"]>[0] = {};\n\n    if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {\n      // Content stripping for immutableContent renderers is handled by CopilotKitCoreReact\n      handlers.onMessagesChanged = () => {\n        forceUpdate();\n      };\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) {\n      handlers.onStateChanged = forceUpdate;\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {\n      handlers.onRunInitialized = forceUpdate;\n      handlers.onRunFinalized = forceUpdate;\n      handlers.onRunFailed = forceUpdate;\n    }\n\n    const subscription = agent.subscribe(handlers);\n    return () => subscription.unsubscribe();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [agent, forceUpdate, JSON.stringify(updateFlags)]);\n\n  return {\n    agent,\n  };\n}\n"],"mappings":";;;;;;;AASA,IAAY,0DAAL;AACL;AACA;AACA;;;AAGF,MAAM,cAAgC;CACpC,eAAe;CACf,eAAe;CACf,eAAe;CAChB;AAOD,SAAgB,SAAS,EAAE,SAAS,YAA2B,EAAE,EAAE;AACjE,aAAYA;CAEZ,MAAM,EAAE,eAAeC,0CAAe;CACtC,MAAM,GAAG,sCAA2B,MAAM,IAAI,GAAG,EAAE;CAEnD,MAAM,uCACE,WAAW,aACjB,CAAC,KAAK,UAAU,QAAQ,CAAC,CAC1B;CAKD,MAAM,0DACJ,IAAI,KAAK,CACV;CAED,MAAM,iCAAqC;EACzC,MAAM,WAAW,WAAW,SAAS,QAAQ;AAC7C,MAAI,UAAU;AAEZ,yBAAsB,QAAQ,OAAO,QAAQ;AAC7C,UAAO;;EAGT,MAAM,sBAAsB,WAAW,eAAe;EACtD,MAAM,SAAS,WAAW;AAG1B,MACE,wBACC,WAAWC,2DAAsC,gBAChD,WAAWA,2DAAsC,aACnD;GAEA,MAAM,SAAS,sBAAsB,QAAQ,IAAI,QAAQ;AACzD,OAAI,QAAQ;AAEV,WAAO,UAAU,EAAE,GAAG,WAAW,SAAS;AAC1C,WAAO;;GAGT,MAAM,cAAc,IAAIC,gDAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACtB,aAAa;IACd,CAAC;AAEF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,yBAAsB,QAAQ,IAAI,SAAS,YAAY;AACvD,UAAO;;AAQT,MACE,uBACA,WAAWD,2DAAsC,OACjD;GACA,MAAM,cAAc,IAAIC,gDAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACtB,aAAa;IACd,CAAC;AACF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,UAAO;;EAIT,MAAM,cAAc,OAAO,KAAK,WAAW,UAAU,EAAE,CAAC;EACxD,MAAM,cAAc,sBAChB,cAAc,WAAW,eACzB;AACJ,QAAM,IAAI,MACR,oBAAoB,QAAQ,kCAAkC,YAAY,QACvE,YAAY,SACT,kBAAkB,YAAY,KAAK,KAAK,CAAC,KACzC,2BACJ,6DACH;IAEA;EACD;EACA,WAAW;EACX,WAAW;EACX,WAAW;EACX,WAAW;EACX,KAAK,UAAU,WAAW,QAAQ;EACnC,CAAC;AAEF,4BAAgB;AACd,MAAI,YAAY,WAAW,EACzB;EAGF,MAAM,WAAsD,EAAE;AAE9D,MAAI,YAAY,SAAS,eAAe,kBAAkB,CAExD,UAAS,0BAA0B;AACjC,gBAAa;;AAIjB,MAAI,YAAY,SAAS,eAAe,eAAe,CACrD,UAAS,iBAAiB;AAG5B,MAAI,YAAY,SAAS,eAAe,mBAAmB,EAAE;AAC3D,YAAS,mBAAmB;AAC5B,YAAS,iBAAiB;AAC1B,YAAS,cAAc;;EAGzB,MAAM,eAAe,MAAM,UAAU,SAAS;AAC9C,eAAa,aAAa,aAAa;IAEtC;EAAC;EAAO;EAAa,KAAK,UAAU,YAAY;EAAC,CAAC;AAErD,QAAO,EACL,OACD"}

package/dist/hooks/use-agent.mjs

@@ -38,7 +38,8 @@ function useAgent({ agentId, updates } = {}) {
 			const provisional = new ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
 				agentId,
-				transport: copilotkit.runtimeTransport
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
 			});
 			provisional.headers = { ...copilotkit.headers };
 			provisionalAgentCache.current.set(agentId, provisional);
@@ -48,7 +49,8 @@ function useAgent({ agentId, updates } = {}) {
 			const provisional = new ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
 				agentId,
-				transport: copilotkit.runtimeTransport
+				transport: copilotkit.runtimeTransport,
+				runtimeMode: "pending"
 			});
 			provisional.headers = { ...copilotkit.headers };
 			return provisional;

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

@@ -1 +1 @@
-{"version":3,"file":"use-agent.mjs","names":[],"sources":["../../src/hooks/use-agent.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport { useMemo, useEffect, useReducer, useRef } from \"react\";\nimport { DEFAULT_AGENT_ID } from \"@copilotkitnext/shared\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport {\n  ProxiedCopilotRuntimeAgent,\n  CopilotKitCoreRuntimeConnectionStatus,\n} from \"@copilotkitnext/core\";\n\nexport enum UseAgentUpdate {\n  OnMessagesChanged = \"OnMessagesChanged\",\n  OnStateChanged = \"OnStateChanged\",\n  OnRunStatusChanged = \"OnRunStatusChanged\",\n}\n\nconst ALL_UPDATES: UseAgentUpdate[] = [\n  UseAgentUpdate.OnMessagesChanged,\n  UseAgentUpdate.OnStateChanged,\n  UseAgentUpdate.OnRunStatusChanged,\n];\n\nexport interface UseAgentProps {\n  agentId?: string;\n  updates?: UseAgentUpdate[];\n}\n\nexport function useAgent({ agentId, updates }: UseAgentProps = {}) {\n  agentId ??= DEFAULT_AGENT_ID;\n\n  const { copilotkit } = useCopilotKit();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  const updateFlags = useMemo(\n    () => updates ?? ALL_UPDATES,\n    [JSON.stringify(updates)],\n  );\n\n  // Cache provisional agents to avoid creating new references on every render\n  // while the runtime is still connecting. A new reference would cascade into\n  // CopilotChat's connectAgent effect, causing unnecessary HTTP calls.\n  const provisionalAgentCache = useRef<Map<string, ProxiedCopilotRuntimeAgent>>(\n    new Map(),\n  );\n\n  const agent: AbstractAgent = useMemo(() => {\n    const existing = copilotkit.getAgent(agentId);\n    if (existing) {\n      // Real agent found — clear any cached provisional for this ID\n      provisionalAgentCache.current.delete(agentId);\n      return existing;\n    }\n\n    const isRuntimeConfigured = copilotkit.runtimeUrl !== undefined;\n    const status = copilotkit.runtimeConnectionStatus;\n\n    // While runtime is not yet synced, return a provisional runtime agent\n    if (\n      isRuntimeConfigured &&\n      (status === CopilotKitCoreRuntimeConnectionStatus.Disconnected ||\n        status === CopilotKitCoreRuntimeConnectionStatus.Connecting)\n    ) {\n      // Return cached provisional if available (keeps reference stable)\n      const cached = provisionalAgentCache.current.get(agentId);\n      if (cached) {\n        // Update headers on the cached agent in case they changed\n        cached.headers = { ...copilotkit.headers };\n        return cached;\n      }\n\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n      });\n      // Apply current headers so runs/connects inherit them\n      provisional.headers = { ...copilotkit.headers };\n      provisionalAgentCache.current.set(agentId, provisional);\n      return provisional;\n    }\n\n    // Runtime is in Error state — return a provisional agent instead of throwing.\n    // The error has already been emitted through the subscriber system\n    // (RUNTIME_INFO_FETCH_FAILED). Throwing here would crash the React tree;\n    // returning a provisional agent lets onError handlers fire while keeping\n    // the app alive.\n    if (\n      isRuntimeConfigured &&\n      status === CopilotKitCoreRuntimeConnectionStatus.Error\n    ) {\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n      });\n      provisional.headers = { ...copilotkit.headers };\n      return provisional;\n    }\n\n    // No runtime configured and agent doesn't exist — this is a configuration error.\n    const knownAgents = Object.keys(copilotkit.agents ?? {});\n    const runtimePart = isRuntimeConfigured\n      ? `runtimeUrl=${copilotkit.runtimeUrl}`\n      : \"no runtimeUrl\";\n    throw new Error(\n      `useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` +\n        (knownAgents.length\n          ? `Known agents: [${knownAgents.join(\", \")}]`\n          : \"No agents registered.\") +\n        \" Verify your runtime /info and/or agents__unsafe_dev_only.\",\n    );\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    agentId,\n    copilotkit.agents,\n    copilotkit.runtimeConnectionStatus,\n    copilotkit.runtimeUrl,\n    copilotkit.runtimeTransport,\n    JSON.stringify(copilotkit.headers),\n  ]);\n\n  useEffect(() => {\n    if (updateFlags.length === 0) {\n      return;\n    }\n\n    const handlers: Parameters<AbstractAgent[\"subscribe\"]>[0] = {};\n\n    if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {\n      // Content stripping for immutableContent renderers is handled by CopilotKitCoreReact\n      handlers.onMessagesChanged = () => {\n        forceUpdate();\n      };\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) {\n      handlers.onStateChanged = forceUpdate;\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {\n      handlers.onRunInitialized = forceUpdate;\n      handlers.onRunFinalized = forceUpdate;\n      handlers.onRunFailed = forceUpdate;\n    }\n\n    const subscription = agent.subscribe(handlers);\n    return () => subscription.unsubscribe();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [agent, forceUpdate, JSON.stringify(updateFlags)]);\n\n  return {\n    agent,\n  };\n}\n"],"mappings":";;;;;;AASA,IAAY,0DAAL;AACL;AACA;AACA;;;AAGF,MAAM,cAAgC;CACpC,eAAe;CACf,eAAe;CACf,eAAe;CAChB;AAOD,SAAgB,SAAS,EAAE,SAAS,YAA2B,EAAE,EAAE;AACjE,aAAY;CAEZ,MAAM,EAAE,eAAe,eAAe;CACtC,MAAM,GAAG,eAAe,YAAY,MAAM,IAAI,GAAG,EAAE;CAEnD,MAAM,cAAc,cACZ,WAAW,aACjB,CAAC,KAAK,UAAU,QAAQ,CAAC,CAC1B;CAKD,MAAM,wBAAwB,uBAC5B,IAAI,KAAK,CACV;CAED,MAAM,QAAuB,cAAc;EACzC,MAAM,WAAW,WAAW,SAAS,QAAQ;AAC7C,MAAI,UAAU;AAEZ,yBAAsB,QAAQ,OAAO,QAAQ;AAC7C,UAAO;;EAGT,MAAM,sBAAsB,WAAW,eAAe;EACtD,MAAM,SAAS,WAAW;AAG1B,MACE,wBACC,WAAW,sCAAsC,gBAChD,WAAW,sCAAsC,aACnD;GAEA,MAAM,SAAS,sBAAsB,QAAQ,IAAI,QAAQ;AACzD,OAAI,QAAQ;AAEV,WAAO,UAAU,EAAE,GAAG,WAAW,SAAS;AAC1C,WAAO;;GAGT,MAAM,cAAc,IAAI,2BAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACvB,CAAC;AAEF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,yBAAsB,QAAQ,IAAI,SAAS,YAAY;AACvD,UAAO;;AAQT,MACE,uBACA,WAAW,sCAAsC,OACjD;GACA,MAAM,cAAc,IAAI,2BAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACvB,CAAC;AACF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,UAAO;;EAIT,MAAM,cAAc,OAAO,KAAK,WAAW,UAAU,EAAE,CAAC;EACxD,MAAM,cAAc,sBAChB,cAAc,WAAW,eACzB;AACJ,QAAM,IAAI,MACR,oBAAoB,QAAQ,kCAAkC,YAAY,QACvE,YAAY,SACT,kBAAkB,YAAY,KAAK,KAAK,CAAC,KACzC,2BACJ,6DACH;IAEA;EACD;EACA,WAAW;EACX,WAAW;EACX,WAAW;EACX,WAAW;EACX,KAAK,UAAU,WAAW,QAAQ;EACnC,CAAC;AAEF,iBAAgB;AACd,MAAI,YAAY,WAAW,EACzB;EAGF,MAAM,WAAsD,EAAE;AAE9D,MAAI,YAAY,SAAS,eAAe,kBAAkB,CAExD,UAAS,0BAA0B;AACjC,gBAAa;;AAIjB,MAAI,YAAY,SAAS,eAAe,eAAe,CACrD,UAAS,iBAAiB;AAG5B,MAAI,YAAY,SAAS,eAAe,mBAAmB,EAAE;AAC3D,YAAS,mBAAmB;AAC5B,YAAS,iBAAiB;AAC1B,YAAS,cAAc;;EAGzB,MAAM,eAAe,MAAM,UAAU,SAAS;AAC9C,eAAa,aAAa,aAAa;IAEtC;EAAC;EAAO;EAAa,KAAK,UAAU,YAAY;EAAC,CAAC;AAErD,QAAO,EACL,OACD"}
+{"version":3,"file":"use-agent.mjs","names":[],"sources":["../../src/hooks/use-agent.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport { useMemo, useEffect, useReducer, useRef } from \"react\";\nimport { DEFAULT_AGENT_ID } from \"@copilotkitnext/shared\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport {\n  ProxiedCopilotRuntimeAgent,\n  CopilotKitCoreRuntimeConnectionStatus,\n} from \"@copilotkitnext/core\";\n\nexport enum UseAgentUpdate {\n  OnMessagesChanged = \"OnMessagesChanged\",\n  OnStateChanged = \"OnStateChanged\",\n  OnRunStatusChanged = \"OnRunStatusChanged\",\n}\n\nconst ALL_UPDATES: UseAgentUpdate[] = [\n  UseAgentUpdate.OnMessagesChanged,\n  UseAgentUpdate.OnStateChanged,\n  UseAgentUpdate.OnRunStatusChanged,\n];\n\nexport interface UseAgentProps {\n  agentId?: string;\n  updates?: UseAgentUpdate[];\n}\n\nexport function useAgent({ agentId, updates }: UseAgentProps = {}) {\n  agentId ??= DEFAULT_AGENT_ID;\n\n  const { copilotkit } = useCopilotKit();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  const updateFlags = useMemo(\n    () => updates ?? ALL_UPDATES,\n    [JSON.stringify(updates)],\n  );\n\n  // Cache provisional agents to avoid creating new references on every render\n  // while the runtime is still connecting. A new reference would cascade into\n  // CopilotChat's connectAgent effect, causing unnecessary HTTP calls.\n  const provisionalAgentCache = useRef<Map<string, ProxiedCopilotRuntimeAgent>>(\n    new Map(),\n  );\n\n  const agent: AbstractAgent = useMemo(() => {\n    const existing = copilotkit.getAgent(agentId);\n    if (existing) {\n      // Real agent found — clear any cached provisional for this ID\n      provisionalAgentCache.current.delete(agentId);\n      return existing;\n    }\n\n    const isRuntimeConfigured = copilotkit.runtimeUrl !== undefined;\n    const status = copilotkit.runtimeConnectionStatus;\n\n    // While runtime is not yet synced, return a provisional runtime agent\n    if (\n      isRuntimeConfigured &&\n      (status === CopilotKitCoreRuntimeConnectionStatus.Disconnected ||\n        status === CopilotKitCoreRuntimeConnectionStatus.Connecting)\n    ) {\n      // Return cached provisional if available (keeps reference stable)\n      const cached = provisionalAgentCache.current.get(agentId);\n      if (cached) {\n        // Update headers on the cached agent in case they changed\n        cached.headers = { ...copilotkit.headers };\n        return cached;\n      }\n\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n        runtimeMode: \"pending\",\n      });\n      // Apply current headers so runs/connects inherit them\n      provisional.headers = { ...copilotkit.headers };\n      provisionalAgentCache.current.set(agentId, provisional);\n      return provisional;\n    }\n\n    // Runtime is in Error state — return a provisional agent instead of throwing.\n    // The error has already been emitted through the subscriber system\n    // (RUNTIME_INFO_FETCH_FAILED). Throwing here would crash the React tree;\n    // returning a provisional agent lets onError handlers fire while keeping\n    // the app alive.\n    if (\n      isRuntimeConfigured &&\n      status === CopilotKitCoreRuntimeConnectionStatus.Error\n    ) {\n      const provisional = new ProxiedCopilotRuntimeAgent({\n        runtimeUrl: copilotkit.runtimeUrl,\n        agentId,\n        transport: copilotkit.runtimeTransport,\n        runtimeMode: \"pending\",\n      });\n      provisional.headers = { ...copilotkit.headers };\n      return provisional;\n    }\n\n    // No runtime configured and agent doesn't exist — this is a configuration error.\n    const knownAgents = Object.keys(copilotkit.agents ?? {});\n    const runtimePart = isRuntimeConfigured\n      ? `runtimeUrl=${copilotkit.runtimeUrl}`\n      : \"no runtimeUrl\";\n    throw new Error(\n      `useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` +\n        (knownAgents.length\n          ? `Known agents: [${knownAgents.join(\", \")}]`\n          : \"No agents registered.\") +\n        \" Verify your runtime /info and/or agents__unsafe_dev_only.\",\n    );\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    agentId,\n    copilotkit.agents,\n    copilotkit.runtimeConnectionStatus,\n    copilotkit.runtimeUrl,\n    copilotkit.runtimeTransport,\n    JSON.stringify(copilotkit.headers),\n  ]);\n\n  useEffect(() => {\n    if (updateFlags.length === 0) {\n      return;\n    }\n\n    const handlers: Parameters<AbstractAgent[\"subscribe\"]>[0] = {};\n\n    if (updateFlags.includes(UseAgentUpdate.OnMessagesChanged)) {\n      // Content stripping for immutableContent renderers is handled by CopilotKitCoreReact\n      handlers.onMessagesChanged = () => {\n        forceUpdate();\n      };\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnStateChanged)) {\n      handlers.onStateChanged = forceUpdate;\n    }\n\n    if (updateFlags.includes(UseAgentUpdate.OnRunStatusChanged)) {\n      handlers.onRunInitialized = forceUpdate;\n      handlers.onRunFinalized = forceUpdate;\n      handlers.onRunFailed = forceUpdate;\n    }\n\n    const subscription = agent.subscribe(handlers);\n    return () => subscription.unsubscribe();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [agent, forceUpdate, JSON.stringify(updateFlags)]);\n\n  return {\n    agent,\n  };\n}\n"],"mappings":";;;;;;AASA,IAAY,0DAAL;AACL;AACA;AACA;;;AAGF,MAAM,cAAgC;CACpC,eAAe;CACf,eAAe;CACf,eAAe;CAChB;AAOD,SAAgB,SAAS,EAAE,SAAS,YAA2B,EAAE,EAAE;AACjE,aAAY;CAEZ,MAAM,EAAE,eAAe,eAAe;CACtC,MAAM,GAAG,eAAe,YAAY,MAAM,IAAI,GAAG,EAAE;CAEnD,MAAM,cAAc,cACZ,WAAW,aACjB,CAAC,KAAK,UAAU,QAAQ,CAAC,CAC1B;CAKD,MAAM,wBAAwB,uBAC5B,IAAI,KAAK,CACV;CAED,MAAM,QAAuB,cAAc;EACzC,MAAM,WAAW,WAAW,SAAS,QAAQ;AAC7C,MAAI,UAAU;AAEZ,yBAAsB,QAAQ,OAAO,QAAQ;AAC7C,UAAO;;EAGT,MAAM,sBAAsB,WAAW,eAAe;EACtD,MAAM,SAAS,WAAW;AAG1B,MACE,wBACC,WAAW,sCAAsC,gBAChD,WAAW,sCAAsC,aACnD;GAEA,MAAM,SAAS,sBAAsB,QAAQ,IAAI,QAAQ;AACzD,OAAI,QAAQ;AAEV,WAAO,UAAU,EAAE,GAAG,WAAW,SAAS;AAC1C,WAAO;;GAGT,MAAM,cAAc,IAAI,2BAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACtB,aAAa;IACd,CAAC;AAEF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,yBAAsB,QAAQ,IAAI,SAAS,YAAY;AACvD,UAAO;;AAQT,MACE,uBACA,WAAW,sCAAsC,OACjD;GACA,MAAM,cAAc,IAAI,2BAA2B;IACjD,YAAY,WAAW;IACvB;IACA,WAAW,WAAW;IACtB,aAAa;IACd,CAAC;AACF,eAAY,UAAU,EAAE,GAAG,WAAW,SAAS;AAC/C,UAAO;;EAIT,MAAM,cAAc,OAAO,KAAK,WAAW,UAAU,EAAE,CAAC;EACxD,MAAM,cAAc,sBAChB,cAAc,WAAW,eACzB;AACJ,QAAM,IAAI,MACR,oBAAoB,QAAQ,kCAAkC,YAAY,QACvE,YAAY,SACT,kBAAkB,YAAY,KAAK,KAAK,CAAC,KACzC,2BACJ,6DACH;IAEA;EACD;EACA,WAAW;EACX,WAAW;EACX,WAAW;EACX,WAAW;EACX,KAAK,UAAU,WAAW,QAAQ;EACnC,CAAC;AAEF,iBAAgB;AACd,MAAI,YAAY,WAAW,EACzB;EAGF,MAAM,WAAsD,EAAE;AAE9D,MAAI,YAAY,SAAS,eAAe,kBAAkB,CAExD,UAAS,0BAA0B;AACjC,gBAAa;;AAIjB,MAAI,YAAY,SAAS,eAAe,eAAe,CACrD,UAAS,iBAAiB;AAG5B,MAAI,YAAY,SAAS,eAAe,mBAAmB,EAAE;AAC3D,YAAS,mBAAmB;AAC5B,YAAS,iBAAiB;AAC1B,YAAS,cAAc;;EAGzB,MAAM,eAAe,MAAM,UAAU,SAAS;AAC9C,eAAa,aAAa,aAAa;IAEtC;EAAC;EAAO;EAAa,KAAK,UAAU,YAAY;EAAC,CAAC;AAErD,QAAO,EACL,OACD"}

package/dist/hooks/use-threads.cjs

@@ -0,0 +1,106 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_CopilotKitProvider = require('../providers/CopilotKitProvider.cjs');
+let react = require("react");
+let _copilotkitnext_core = require("@copilotkitnext/core");
+
+//#region src/hooks/use-threads.tsx
+function useThreadStoreSelector(store, selector) {
+	return (0, react.useSyncExternalStore)((0, react.useCallback)((onStoreChange) => {
+		const subscription = store.select(selector).subscribe(onStoreChange);
+		return () => subscription.unsubscribe();
+	}, [store, selector]), () => selector(store.getState()));
+}
+/**
+* React hook for listing and managing Intelligence platform threads.
+*
+* On mount the hook fetches the thread list for the given `userId`/`agentId`
+* pair. When the Intelligence platform exposes a WebSocket URL, it also opens
+* a realtime subscription so the `threads` array stays current without
+* polling — thread creates, renames, archives, and deletes from any client
+* are reflected immediately.
+*
+* Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
+* promises that resolve once the platform confirms the operation and reject
+* with an `Error` on failure.
+*
+* @param input - User and agent identifiers that scope the thread list.
+* @returns Thread list state and stable mutation callbacks.
+*
+* @example
+* ```tsx
+* import { useThreads } from "@copilotkitnext/react";
+*
+* function ThreadList() {
+*   const { threads, isLoading, renameThread, deleteThread } = useThreads({
+*     userId: "user-1",
+*     agentId: "agent-1",
+*   });
+*
+*   if (isLoading) return <p>Loading…</p>;
+*
+*   return (
+*     <ul>
+*       {threads.map((t) => (
+*         <li key={t.id}>
+*           {t.name ?? "Untitled"}
+*           <button onClick={() => renameThread(t.id, "New name")}>Rename</button>
+*           <button onClick={() => deleteThread(t.id)}>Delete</button>
+*         </li>
+*       ))}
+*     </ul>
+*   );
+* }
+* ```
+*/
+function useThreads({ userId, agentId }) {
+	const { copilotkit } = require_CopilotKitProvider.useCopilotKit();
+	const [store] = (0, react.useState)(() => (0, _copilotkitnext_core.ɵcreateThreadStore)({ fetch: globalThis.fetch }));
+	const threads = useThreadStoreSelector(store, _copilotkitnext_core.ɵselectThreads);
+	const storeIsLoading = useThreadStoreSelector(store, _copilotkitnext_core.ɵselectThreadsIsLoading);
+	const storeError = useThreadStoreSelector(store, _copilotkitnext_core.ɵselectThreadsError);
+	const headersKey = (0, react.useMemo)(() => {
+		return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
+	}, [copilotkit.headers]);
+	const runtimeError = (0, react.useMemo)(() => {
+		if (copilotkit.runtimeUrl) return null;
+		return /* @__PURE__ */ new Error("Runtime URL is not configured");
+	}, [copilotkit.runtimeUrl]);
+	const isLoading = runtimeError ? false : storeIsLoading;
+	const error = runtimeError ?? storeError;
+	(0, react.useEffect)(() => {
+		store.start();
+		return () => {
+			store.stop();
+		};
+	}, [store]);
+	(0, react.useEffect)(() => {
+		const context = copilotkit.runtimeUrl ? {
+			runtimeUrl: copilotkit.runtimeUrl,
+			headers: { ...copilotkit.headers },
+			wsUrl: copilotkit.intelligence?.wsUrl,
+			userId,
+			agentId
+		} : null;
+		store.setContext(context);
+	}, [
+		store,
+		copilotkit.runtimeUrl,
+		headersKey,
+		copilotkit.intelligence?.wsUrl,
+		userId,
+		agentId,
+		copilotkit.headers
+	]);
+	return {
+		threads,
+		isLoading,
+		error,
+		renameThread: (0, react.useCallback)((threadId, name) => store.renameThread(threadId, name), [store]),
+		archiveThread: (0, react.useCallback)((threadId) => store.archiveThread(threadId), [store]),
+		deleteThread: (0, react.useCallback)((threadId) => store.deleteThread(threadId), [store])
+	};
+}
+
+//#endregion
+exports.useThreads = useThreads;
+//# sourceMappingURL=use-threads.cjs.map

package/dist/hooks/use-threads.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-threads.cjs","names":["useCopilotKit","ɵselectThreads","ɵselectThreadsIsLoading","ɵselectThreadsError"],"sources":["../../src/hooks/use-threads.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport {\n  ɵcreateThreadStore,\n  ɵselectThreads,\n  ɵselectThreadsError,\n  ɵselectThreadsIsLoading,\n  type ɵThread as CoreThread,\n  type ɵThreadRuntimeContext,\n  type ɵThreadStore,\n} from \"@copilotkitnext/core\";\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\n\n/**\n * A conversation thread managed by the Intelligence platform.\n *\n * Each thread has a unique `id`, an optional human-readable `name`, and\n * timestamp fields tracking creation and update times.\n */\nexport interface Thread extends CoreThread {}\n\n/**\n * Configuration for the {@link useThreads} hook.\n *\n * Both fields are required — they scope the thread list and all mutations\n * to a specific user/agent pair on the Intelligence platform.\n */\nexport interface UseThreadsInput {\n  /** The ID of the current user. Thread queries and mutations are scoped to this user. */\n  userId: string;\n  /** The ID of the agent whose threads to list and manage. */\n  agentId: string;\n}\n\n/**\n * Return value of the {@link useThreads} hook.\n *\n * The `threads` array is kept in sync with the platform via a realtime\n * WebSocket subscription (when available) and is sorted most-recently-updated\n * first. Mutations reject with an `Error` if the platform request fails.\n */\nexport interface UseThreadsResult {\n  /**\n   * All non-archived threads for the current user/agent pair, sorted by\n   * most recently updated first. Updated in realtime when the platform\n   * pushes metadata events.\n   */\n  threads: Thread[];\n  /**\n   * `true` while the initial thread list is being fetched from the platform.\n   * Subsequent realtime updates do not re-enter the loading state.\n   */\n  isLoading: boolean;\n  /**\n   * The most recent error from fetching threads or executing a mutation,\n   * or `null` when there is no error. Reset to `null` on the next\n   * successful fetch.\n   */\n  error: Error | null;\n  /**\n   * Rename a thread on the platform.\n   * Resolves when the server confirms the update; rejects on failure.\n   */\n  renameThread: (threadId: string, name: string) => Promise<void>;\n  /**\n   * Archive a thread on the platform.\n   * Archived threads are excluded from subsequent list results.\n   * Resolves when the server confirms the update; rejects on failure.\n   */\n  archiveThread: (threadId: string) => Promise<void>;\n  /**\n   * Permanently delete a thread from the platform.\n   * This is irreversible. Resolves when the server confirms deletion;\n   * rejects on failure.\n   */\n  deleteThread: (threadId: string) => Promise<void>;\n}\n\nfunction useThreadStoreSelector<T>(\n  store: ɵThreadStore,\n  selector: (state: ReturnType<ɵThreadStore[\"getState\"]>) => T,\n): T {\n  return useSyncExternalStore(\n    useCallback(\n      (onStoreChange) => {\n        const subscription = store.select(selector).subscribe(onStoreChange);\n        return () => subscription.unsubscribe();\n      },\n      [store, selector],\n    ),\n    () => selector(store.getState()),\n  );\n}\n\n/**\n * React hook for listing and managing Intelligence platform threads.\n *\n * On mount the hook fetches the thread list for the given `userId`/`agentId`\n * pair. When the Intelligence platform exposes a WebSocket URL, it also opens\n * a realtime subscription so the `threads` array stays current without\n * polling — thread creates, renames, archives, and deletes from any client\n * are reflected immediately.\n *\n * Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return\n * promises that resolve once the platform confirms the operation and reject\n * with an `Error` on failure.\n *\n * @param input - User and agent identifiers that scope the thread list.\n * @returns Thread list state and stable mutation callbacks.\n *\n * @example\n * ```tsx\n * import { useThreads } from \"@copilotkitnext/react\";\n *\n * function ThreadList() {\n *   const { threads, isLoading, renameThread, deleteThread } = useThreads({\n *     userId: \"user-1\",\n *     agentId: \"agent-1\",\n *   });\n *\n *   if (isLoading) return <p>Loading…</p>;\n *\n *   return (\n *     <ul>\n *       {threads.map((t) => (\n *         <li key={t.id}>\n *           {t.name ?? \"Untitled\"}\n *           <button onClick={() => renameThread(t.id, \"New name\")}>Rename</button>\n *           <button onClick={() => deleteThread(t.id)}>Delete</button>\n *         </li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useThreads({\n  userId,\n  agentId,\n}: UseThreadsInput): UseThreadsResult {\n  const { copilotkit } = useCopilotKit();\n\n  const [store] = useState(() =>\n    ɵcreateThreadStore({\n      fetch: globalThis.fetch,\n    }),\n  );\n\n  const threads = useThreadStoreSelector(store, ɵselectThreads);\n  const storeIsLoading = useThreadStoreSelector(store, ɵselectThreadsIsLoading);\n  const storeError = useThreadStoreSelector(store, ɵselectThreadsError);\n  const headersKey = useMemo(() => {\n    return JSON.stringify(\n      Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) =>\n        left.localeCompare(right),\n      ),\n    );\n  }, [copilotkit.headers]);\n  const runtimeError = useMemo(() => {\n    if (copilotkit.runtimeUrl) {\n      return null;\n    }\n\n    return new Error(\"Runtime URL is not configured\");\n  }, [copilotkit.runtimeUrl]);\n  const isLoading = runtimeError ? false : storeIsLoading;\n  const error = runtimeError ?? storeError;\n\n  useEffect(() => {\n    store.start();\n    return () => {\n      store.stop();\n    };\n  }, [store]);\n\n  useEffect(() => {\n    const context: ɵThreadRuntimeContext | null = copilotkit.runtimeUrl\n      ? {\n          runtimeUrl: copilotkit.runtimeUrl,\n          headers: { ...copilotkit.headers },\n          wsUrl: copilotkit.intelligence?.wsUrl,\n          userId,\n          agentId,\n        }\n      : null;\n\n    store.setContext(context);\n  }, [\n    store,\n    copilotkit.runtimeUrl,\n    headersKey,\n    copilotkit.intelligence?.wsUrl,\n    userId,\n    agentId,\n    copilotkit.headers,\n  ]);\n\n  const renameThread = useCallback(\n    (threadId: string, name: string) => store.renameThread(threadId, name),\n    [store],\n  );\n\n  const archiveThread = useCallback(\n    (threadId: string) => store.archiveThread(threadId),\n    [store],\n  );\n\n  const deleteThread = useCallback(\n    (threadId: string) => store.deleteThread(threadId),\n    [store],\n  );\n\n  return {\n    threads,\n    isLoading,\n    error,\n    renameThread,\n    archiveThread,\n    deleteThread,\n  };\n}\n"],"mappings":";;;;;;AAmFA,SAAS,uBACP,OACA,UACG;AACH,gEAEK,kBAAkB;EACjB,MAAM,eAAe,MAAM,OAAO,SAAS,CAAC,UAAU,cAAc;AACpE,eAAa,aAAa,aAAa;IAEzC,CAAC,OAAO,SAAS,CAClB,QACK,SAAS,MAAM,UAAU,CAAC,CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CH,SAAgB,WAAW,EACzB,QACA,WACoC;CACpC,MAAM,EAAE,eAAeA,0CAAe;CAEtC,MAAM,CAAC,gFACc,EACjB,OAAO,WAAW,OACnB,CAAC,CACH;CAED,MAAM,UAAU,uBAAuB,OAAOC,oCAAe;CAC7D,MAAM,iBAAiB,uBAAuB,OAAOC,6CAAwB;CAC7E,MAAM,aAAa,uBAAuB,OAAOC,yCAAoB;CACrE,MAAM,sCAA2B;AAC/B,SAAO,KAAK,UACV,OAAO,QAAQ,WAAW,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WACtD,KAAK,cAAc,MAAM,CAC1B,CACF;IACA,CAAC,WAAW,QAAQ,CAAC;CACxB,MAAM,wCAA6B;AACjC,MAAI,WAAW,WACb,QAAO;AAGT,yBAAO,IAAI,MAAM,gCAAgC;IAChD,CAAC,WAAW,WAAW,CAAC;CAC3B,MAAM,YAAY,eAAe,QAAQ;CACzC,MAAM,QAAQ,gBAAgB;AAE9B,4BAAgB;AACd,QAAM,OAAO;AACb,eAAa;AACX,SAAM,MAAM;;IAEb,CAAC,MAAM,CAAC;AAEX,4BAAgB;EACd,MAAM,UAAwC,WAAW,aACrD;GACE,YAAY,WAAW;GACvB,SAAS,EAAE,GAAG,WAAW,SAAS;GAClC,OAAO,WAAW,cAAc;GAChC;GACA;GACD,GACD;AAEJ,QAAM,WAAW,QAAQ;IACxB;EACD;EACA,WAAW;EACX;EACA,WAAW,cAAc;EACzB;EACA;EACA,WAAW;EACZ,CAAC;AAiBF,QAAO;EACL;EACA;EACA;EACA,sCAlBC,UAAkB,SAAiB,MAAM,aAAa,UAAU,KAAK,EACtE,CAAC,MAAM,CACR;EAiBC,uCAdC,aAAqB,MAAM,cAAc,SAAS,EACnD,CAAC,MAAM,CACR;EAaC,sCAVC,aAAqB,MAAM,aAAa,SAAS,EAClD,CAAC,MAAM,CACR;EASA"}

package/dist/hooks/use-threads.d.cts

@@ -0,0 +1,114 @@
+import { ɵThread } from "@copilotkitnext/core";
+
+//#region src/hooks/use-threads.d.ts
+/**
+ * A conversation thread managed by the Intelligence platform.
+ *
+ * Each thread has a unique `id`, an optional human-readable `name`, and
+ * timestamp fields tracking creation and update times.
+ */
+interface Thread extends ɵThread {}
+/**
+ * Configuration for the {@link useThreads} hook.
+ *
+ * Both fields are required — they scope the thread list and all mutations
+ * to a specific user/agent pair on the Intelligence platform.
+ */
+interface UseThreadsInput {
+  /** The ID of the current user. Thread queries and mutations are scoped to this user. */
+  userId: string;
+  /** The ID of the agent whose threads to list and manage. */
+  agentId: string;
+}
+/**
+ * Return value of the {@link useThreads} hook.
+ *
+ * The `threads` array is kept in sync with the platform via a realtime
+ * WebSocket subscription (when available) and is sorted most-recently-updated
+ * first. Mutations reject with an `Error` if the platform request fails.
+ */
+interface UseThreadsResult {
+  /**
+   * All non-archived threads for the current user/agent pair, sorted by
+   * most recently updated first. Updated in realtime when the platform
+   * pushes metadata events.
+   */
+  threads: Thread[];
+  /**
+   * `true` while the initial thread list is being fetched from the platform.
+   * Subsequent realtime updates do not re-enter the loading state.
+   */
+  isLoading: boolean;
+  /**
+   * The most recent error from fetching threads or executing a mutation,
+   * or `null` when there is no error. Reset to `null` on the next
+   * successful fetch.
+   */
+  error: Error | null;
+  /**
+   * Rename a thread on the platform.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  renameThread: (threadId: string, name: string) => Promise<void>;
+  /**
+   * Archive a thread on the platform.
+   * Archived threads are excluded from subsequent list results.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  archiveThread: (threadId: string) => Promise<void>;
+  /**
+   * Permanently delete a thread from the platform.
+   * This is irreversible. Resolves when the server confirms deletion;
+   * rejects on failure.
+   */
+  deleteThread: (threadId: string) => Promise<void>;
+}
+/**
+ * React hook for listing and managing Intelligence platform threads.
+ *
+ * On mount the hook fetches the thread list for the given `userId`/`agentId`
+ * pair. When the Intelligence platform exposes a WebSocket URL, it also opens
+ * a realtime subscription so the `threads` array stays current without
+ * polling — thread creates, renames, archives, and deletes from any client
+ * are reflected immediately.
+ *
+ * Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
+ * promises that resolve once the platform confirms the operation and reject
+ * with an `Error` on failure.
+ *
+ * @param input - User and agent identifiers that scope the thread list.
+ * @returns Thread list state and stable mutation callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { useThreads } from "@copilotkitnext/react";
+ *
+ * function ThreadList() {
+ *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
+ *     userId: "user-1",
+ *     agentId: "agent-1",
+ *   });
+ *
+ *   if (isLoading) return <p>Loading…</p>;
+ *
+ *   return (
+ *     <ul>
+ *       {threads.map((t) => (
+ *         <li key={t.id}>
+ *           {t.name ?? "Untitled"}
+ *           <button onClick={() => renameThread(t.id, "New name")}>Rename</button>
+ *           <button onClick={() => deleteThread(t.id)}>Delete</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+declare function useThreads({
+  userId,
+  agentId
+}: UseThreadsInput): UseThreadsResult;
+//#endregion
+export { Thread, UseThreadsInput, UseThreadsResult, useThreads };
+//# sourceMappingURL=use-threads.d.cts.map

package/dist/hooks/use-threads.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-threads.d.cts","names":[],"sources":["../../src/hooks/use-threads.tsx"],"mappings":";;;;;AAwBA;;;;UAAiB,MAAA,SAAe,OAAA;;;;;AAsBhC;;UAdiB,eAAA;EAoBN;EAlBT,MAAA;EAkCkD;EAhClD,OAAA;AAAA;;;;;;;;UAUe,gBAAA;EAsBA;;;;;EAhBf,OAAA,EAAS,MAAA;EA4BT;;;;EAvBA,SAAA;EAoFc;;;;;EA9Ed,KAAA,EAAO,KAAA;EAiFY;;;;EA5EnB,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;EA2ElD;;;;;EArEA,aAAA,GAAgB,QAAA,aAAqB,OAAA;;;;;;EAMrC,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DtB,UAAA,CAAA;EACd,MAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA"}

package/dist/hooks/use-threads.d.mts

@@ -0,0 +1,114 @@
+import { ɵThread } from "@copilotkitnext/core";
+
+//#region src/hooks/use-threads.d.ts
+/**
+ * A conversation thread managed by the Intelligence platform.
+ *
+ * Each thread has a unique `id`, an optional human-readable `name`, and
+ * timestamp fields tracking creation and update times.
+ */
+interface Thread extends ɵThread {}
+/**
+ * Configuration for the {@link useThreads} hook.
+ *
+ * Both fields are required — they scope the thread list and all mutations
+ * to a specific user/agent pair on the Intelligence platform.
+ */
+interface UseThreadsInput {
+  /** The ID of the current user. Thread queries and mutations are scoped to this user. */
+  userId: string;
+  /** The ID of the agent whose threads to list and manage. */
+  agentId: string;
+}
+/**
+ * Return value of the {@link useThreads} hook.
+ *
+ * The `threads` array is kept in sync with the platform via a realtime
+ * WebSocket subscription (when available) and is sorted most-recently-updated
+ * first. Mutations reject with an `Error` if the platform request fails.
+ */
+interface UseThreadsResult {
+  /**
+   * All non-archived threads for the current user/agent pair, sorted by
+   * most recently updated first. Updated in realtime when the platform
+   * pushes metadata events.
+   */
+  threads: Thread[];
+  /**
+   * `true` while the initial thread list is being fetched from the platform.
+   * Subsequent realtime updates do not re-enter the loading state.
+   */
+  isLoading: boolean;
+  /**
+   * The most recent error from fetching threads or executing a mutation,
+   * or `null` when there is no error. Reset to `null` on the next
+   * successful fetch.
+   */
+  error: Error | null;
+  /**
+   * Rename a thread on the platform.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  renameThread: (threadId: string, name: string) => Promise<void>;
+  /**
+   * Archive a thread on the platform.
+   * Archived threads are excluded from subsequent list results.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  archiveThread: (threadId: string) => Promise<void>;
+  /**
+   * Permanently delete a thread from the platform.
+   * This is irreversible. Resolves when the server confirms deletion;
+   * rejects on failure.
+   */
+  deleteThread: (threadId: string) => Promise<void>;
+}
+/**
+ * React hook for listing and managing Intelligence platform threads.
+ *
+ * On mount the hook fetches the thread list for the given `userId`/`agentId`
+ * pair. When the Intelligence platform exposes a WebSocket URL, it also opens
+ * a realtime subscription so the `threads` array stays current without
+ * polling — thread creates, renames, archives, and deletes from any client
+ * are reflected immediately.
+ *
+ * Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
+ * promises that resolve once the platform confirms the operation and reject
+ * with an `Error` on failure.
+ *
+ * @param input - User and agent identifiers that scope the thread list.
+ * @returns Thread list state and stable mutation callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { useThreads } from "@copilotkitnext/react";
+ *
+ * function ThreadList() {
+ *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
+ *     userId: "user-1",
+ *     agentId: "agent-1",
+ *   });
+ *
+ *   if (isLoading) return <p>Loading…</p>;
+ *
+ *   return (
+ *     <ul>
+ *       {threads.map((t) => (
+ *         <li key={t.id}>
+ *           {t.name ?? "Untitled"}
+ *           <button onClick={() => renameThread(t.id, "New name")}>Rename</button>
+ *           <button onClick={() => deleteThread(t.id)}>Delete</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+declare function useThreads({
+  userId,
+  agentId
+}: UseThreadsInput): UseThreadsResult;
+//#endregion
+export { Thread, UseThreadsInput, UseThreadsResult, useThreads };
+//# sourceMappingURL=use-threads.d.mts.map

package/dist/hooks/use-threads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-threads.d.mts","names":[],"sources":["../../src/hooks/use-threads.tsx"],"mappings":";;;;;AAwBA;;;;UAAiB,MAAA,SAAe,OAAA;;;;;AAsBhC;;UAdiB,eAAA;EAoBN;EAlBT,MAAA;EAkCkD;EAhClD,OAAA;AAAA;;;;;;;;UAUe,gBAAA;EAsBA;;;;;EAhBf,OAAA,EAAS,MAAA;EA4BT;;;;EAvBA,SAAA;EAoFc;;;;;EA9Ed,KAAA,EAAO,KAAA;EAiFY;;;;EA5EnB,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;EA2ElD;;;;;EArEA,aAAA,GAAgB,QAAA,aAAqB,OAAA;;;;;;EAMrC,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DtB,UAAA,CAAA;EACd,MAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA"}

package/dist/hooks/use-threads.mjs

@@ -0,0 +1,105 @@
+import { useCopilotKit } from "../providers/CopilotKitProvider.mjs";
+import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
+import { ɵcreateThreadStore, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkitnext/core";
+
+//#region src/hooks/use-threads.tsx
+function useThreadStoreSelector(store, selector) {
+	return useSyncExternalStore(useCallback((onStoreChange) => {
+		const subscription = store.select(selector).subscribe(onStoreChange);
+		return () => subscription.unsubscribe();
+	}, [store, selector]), () => selector(store.getState()));
+}
+/**
+* React hook for listing and managing Intelligence platform threads.
+*
+* On mount the hook fetches the thread list for the given `userId`/`agentId`
+* pair. When the Intelligence platform exposes a WebSocket URL, it also opens
+* a realtime subscription so the `threads` array stays current without
+* polling — thread creates, renames, archives, and deletes from any client
+* are reflected immediately.
+*
+* Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
+* promises that resolve once the platform confirms the operation and reject
+* with an `Error` on failure.
+*
+* @param input - User and agent identifiers that scope the thread list.
+* @returns Thread list state and stable mutation callbacks.
+*
+* @example
+* ```tsx
+* import { useThreads } from "@copilotkitnext/react";
+*
+* function ThreadList() {
+*   const { threads, isLoading, renameThread, deleteThread } = useThreads({
+*     userId: "user-1",
+*     agentId: "agent-1",
+*   });
+*
+*   if (isLoading) return <p>Loading…</p>;
+*
+*   return (
+*     <ul>
+*       {threads.map((t) => (
+*         <li key={t.id}>
+*           {t.name ?? "Untitled"}
+*           <button onClick={() => renameThread(t.id, "New name")}>Rename</button>
+*           <button onClick={() => deleteThread(t.id)}>Delete</button>
+*         </li>
+*       ))}
+*     </ul>
+*   );
+* }
+* ```
+*/
+function useThreads({ userId, agentId }) {
+	const { copilotkit } = useCopilotKit();
+	const [store] = useState(() => ɵcreateThreadStore({ fetch: globalThis.fetch }));
+	const threads = useThreadStoreSelector(store, ɵselectThreads);
+	const storeIsLoading = useThreadStoreSelector(store, ɵselectThreadsIsLoading);
+	const storeError = useThreadStoreSelector(store, ɵselectThreadsError);
+	const headersKey = useMemo(() => {
+		return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
+	}, [copilotkit.headers]);
+	const runtimeError = useMemo(() => {
+		if (copilotkit.runtimeUrl) return null;
+		return /* @__PURE__ */ new Error("Runtime URL is not configured");
+	}, [copilotkit.runtimeUrl]);
+	const isLoading = runtimeError ? false : storeIsLoading;
+	const error = runtimeError ?? storeError;
+	useEffect(() => {
+		store.start();
+		return () => {
+			store.stop();
+		};
+	}, [store]);
+	useEffect(() => {
+		const context = copilotkit.runtimeUrl ? {
+			runtimeUrl: copilotkit.runtimeUrl,
+			headers: { ...copilotkit.headers },
+			wsUrl: copilotkit.intelligence?.wsUrl,
+			userId,
+			agentId
+		} : null;
+		store.setContext(context);
+	}, [
+		store,
+		copilotkit.runtimeUrl,
+		headersKey,
+		copilotkit.intelligence?.wsUrl,
+		userId,
+		agentId,
+		copilotkit.headers
+	]);
+	return {
+		threads,
+		isLoading,
+		error,
+		renameThread: useCallback((threadId, name) => store.renameThread(threadId, name), [store]),
+		archiveThread: useCallback((threadId) => store.archiveThread(threadId), [store]),
+		deleteThread: useCallback((threadId) => store.deleteThread(threadId), [store])
+	};
+}
+
+//#endregion
+export { useThreads };
+//# sourceMappingURL=use-threads.mjs.map

package/dist/hooks/use-threads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-threads.mjs","names":[],"sources":["../../src/hooks/use-threads.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport {\n  ɵcreateThreadStore,\n  ɵselectThreads,\n  ɵselectThreadsError,\n  ɵselectThreadsIsLoading,\n  type ɵThread as CoreThread,\n  type ɵThreadRuntimeContext,\n  type ɵThreadStore,\n} from \"@copilotkitnext/core\";\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\n\n/**\n * A conversation thread managed by the Intelligence platform.\n *\n * Each thread has a unique `id`, an optional human-readable `name`, and\n * timestamp fields tracking creation and update times.\n */\nexport interface Thread extends CoreThread {}\n\n/**\n * Configuration for the {@link useThreads} hook.\n *\n * Both fields are required — they scope the thread list and all mutations\n * to a specific user/agent pair on the Intelligence platform.\n */\nexport interface UseThreadsInput {\n  /** The ID of the current user. Thread queries and mutations are scoped to this user. */\n  userId: string;\n  /** The ID of the agent whose threads to list and manage. */\n  agentId: string;\n}\n\n/**\n * Return value of the {@link useThreads} hook.\n *\n * The `threads` array is kept in sync with the platform via a realtime\n * WebSocket subscription (when available) and is sorted most-recently-updated\n * first. Mutations reject with an `Error` if the platform request fails.\n */\nexport interface UseThreadsResult {\n  /**\n   * All non-archived threads for the current user/agent pair, sorted by\n   * most recently updated first. Updated in realtime when the platform\n   * pushes metadata events.\n   */\n  threads: Thread[];\n  /**\n   * `true` while the initial thread list is being fetched from the platform.\n   * Subsequent realtime updates do not re-enter the loading state.\n   */\n  isLoading: boolean;\n  /**\n   * The most recent error from fetching threads or executing a mutation,\n   * or `null` when there is no error. Reset to `null` on the next\n   * successful fetch.\n   */\n  error: Error | null;\n  /**\n   * Rename a thread on the platform.\n   * Resolves when the server confirms the update; rejects on failure.\n   */\n  renameThread: (threadId: string, name: string) => Promise<void>;\n  /**\n   * Archive a thread on the platform.\n   * Archived threads are excluded from subsequent list results.\n   * Resolves when the server confirms the update; rejects on failure.\n   */\n  archiveThread: (threadId: string) => Promise<void>;\n  /**\n   * Permanently delete a thread from the platform.\n   * This is irreversible. Resolves when the server confirms deletion;\n   * rejects on failure.\n   */\n  deleteThread: (threadId: string) => Promise<void>;\n}\n\nfunction useThreadStoreSelector<T>(\n  store: ɵThreadStore,\n  selector: (state: ReturnType<ɵThreadStore[\"getState\"]>) => T,\n): T {\n  return useSyncExternalStore(\n    useCallback(\n      (onStoreChange) => {\n        const subscription = store.select(selector).subscribe(onStoreChange);\n        return () => subscription.unsubscribe();\n      },\n      [store, selector],\n    ),\n    () => selector(store.getState()),\n  );\n}\n\n/**\n * React hook for listing and managing Intelligence platform threads.\n *\n * On mount the hook fetches the thread list for the given `userId`/`agentId`\n * pair. When the Intelligence platform exposes a WebSocket URL, it also opens\n * a realtime subscription so the `threads` array stays current without\n * polling — thread creates, renames, archives, and deletes from any client\n * are reflected immediately.\n *\n * Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return\n * promises that resolve once the platform confirms the operation and reject\n * with an `Error` on failure.\n *\n * @param input - User and agent identifiers that scope the thread list.\n * @returns Thread list state and stable mutation callbacks.\n *\n * @example\n * ```tsx\n * import { useThreads } from \"@copilotkitnext/react\";\n *\n * function ThreadList() {\n *   const { threads, isLoading, renameThread, deleteThread } = useThreads({\n *     userId: \"user-1\",\n *     agentId: \"agent-1\",\n *   });\n *\n *   if (isLoading) return <p>Loading…</p>;\n *\n *   return (\n *     <ul>\n *       {threads.map((t) => (\n *         <li key={t.id}>\n *           {t.name ?? \"Untitled\"}\n *           <button onClick={() => renameThread(t.id, \"New name\")}>Rename</button>\n *           <button onClick={() => deleteThread(t.id)}>Delete</button>\n *         </li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useThreads({\n  userId,\n  agentId,\n}: UseThreadsInput): UseThreadsResult {\n  const { copilotkit } = useCopilotKit();\n\n  const [store] = useState(() =>\n    ɵcreateThreadStore({\n      fetch: globalThis.fetch,\n    }),\n  );\n\n  const threads = useThreadStoreSelector(store, ɵselectThreads);\n  const storeIsLoading = useThreadStoreSelector(store, ɵselectThreadsIsLoading);\n  const storeError = useThreadStoreSelector(store, ɵselectThreadsError);\n  const headersKey = useMemo(() => {\n    return JSON.stringify(\n      Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) =>\n        left.localeCompare(right),\n      ),\n    );\n  }, [copilotkit.headers]);\n  const runtimeError = useMemo(() => {\n    if (copilotkit.runtimeUrl) {\n      return null;\n    }\n\n    return new Error(\"Runtime URL is not configured\");\n  }, [copilotkit.runtimeUrl]);\n  const isLoading = runtimeError ? false : storeIsLoading;\n  const error = runtimeError ?? storeError;\n\n  useEffect(() => {\n    store.start();\n    return () => {\n      store.stop();\n    };\n  }, [store]);\n\n  useEffect(() => {\n    const context: ɵThreadRuntimeContext | null = copilotkit.runtimeUrl\n      ? {\n          runtimeUrl: copilotkit.runtimeUrl,\n          headers: { ...copilotkit.headers },\n          wsUrl: copilotkit.intelligence?.wsUrl,\n          userId,\n          agentId,\n        }\n      : null;\n\n    store.setContext(context);\n  }, [\n    store,\n    copilotkit.runtimeUrl,\n    headersKey,\n    copilotkit.intelligence?.wsUrl,\n    userId,\n    agentId,\n    copilotkit.headers,\n  ]);\n\n  const renameThread = useCallback(\n    (threadId: string, name: string) => store.renameThread(threadId, name),\n    [store],\n  );\n\n  const archiveThread = useCallback(\n    (threadId: string) => store.archiveThread(threadId),\n    [store],\n  );\n\n  const deleteThread = useCallback(\n    (threadId: string) => store.deleteThread(threadId),\n    [store],\n  );\n\n  return {\n    threads,\n    isLoading,\n    error,\n    renameThread,\n    archiveThread,\n    deleteThread,\n  };\n}\n"],"mappings":";;;;;AAmFA,SAAS,uBACP,OACA,UACG;AACH,QAAO,qBACL,aACG,kBAAkB;EACjB,MAAM,eAAe,MAAM,OAAO,SAAS,CAAC,UAAU,cAAc;AACpE,eAAa,aAAa,aAAa;IAEzC,CAAC,OAAO,SAAS,CAClB,QACK,SAAS,MAAM,UAAU,CAAC,CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CH,SAAgB,WAAW,EACzB,QACA,WACoC;CACpC,MAAM,EAAE,eAAe,eAAe;CAEtC,MAAM,CAAC,SAAS,eACd,mBAAmB,EACjB,OAAO,WAAW,OACnB,CAAC,CACH;CAED,MAAM,UAAU,uBAAuB,OAAO,eAAe;CAC7D,MAAM,iBAAiB,uBAAuB,OAAO,wBAAwB;CAC7E,MAAM,aAAa,uBAAuB,OAAO,oBAAoB;CACrE,MAAM,aAAa,cAAc;AAC/B,SAAO,KAAK,UACV,OAAO,QAAQ,WAAW,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WACtD,KAAK,cAAc,MAAM,CAC1B,CACF;IACA,CAAC,WAAW,QAAQ,CAAC;CACxB,MAAM,eAAe,cAAc;AACjC,MAAI,WAAW,WACb,QAAO;AAGT,yBAAO,IAAI,MAAM,gCAAgC;IAChD,CAAC,WAAW,WAAW,CAAC;CAC3B,MAAM,YAAY,eAAe,QAAQ;CACzC,MAAM,QAAQ,gBAAgB;AAE9B,iBAAgB;AACd,QAAM,OAAO;AACb,eAAa;AACX,SAAM,MAAM;;IAEb,CAAC,MAAM,CAAC;AAEX,iBAAgB;EACd,MAAM,UAAwC,WAAW,aACrD;GACE,YAAY,WAAW;GACvB,SAAS,EAAE,GAAG,WAAW,SAAS;GAClC,OAAO,WAAW,cAAc;GAChC;GACA;GACD,GACD;AAEJ,QAAM,WAAW,QAAQ;IACxB;EACD;EACA,WAAW;EACX;EACA,WAAW,cAAc;EACzB;EACA;EACA,WAAW;EACZ,CAAC;AAiBF,QAAO;EACL;EACA;EACA;EACA,cAnBmB,aAClB,UAAkB,SAAiB,MAAM,aAAa,UAAU,KAAK,EACtE,CAAC,MAAM,CACR;EAiBC,eAfoB,aACnB,aAAqB,MAAM,cAAc,SAAS,EACnD,CAAC,MAAM,CACR;EAaC,cAXmB,aAClB,aAAqB,MAAM,aAAa,SAAS,EAClD,CAAC,MAAM,CACR;EASA"}

package/dist/index.cjs

@@ -24,6 +24,7 @@ const require_use_agent_context = require('./hooks/use-agent-context.cjs');
 const require_use_suggestions = require('./hooks/use-suggestions.cjs');
 const require_use_configure_suggestions = require('./hooks/use-configure-suggestions.cjs');
 const require_use_interrupt = require('./hooks/use-interrupt.cjs');
+const require_use_threads = require('./hooks/use-threads.cjs');
 require('./hooks/index.cjs');
 const require_CopilotChatToolCallsView = require('./components/chat/CopilotChatToolCallsView.cjs');
 const require_CopilotChatAssistantMessage = require('./components/chat/CopilotChatAssistantMessage.cjs');
@@ -110,6 +111,7 @@ exports.useRenderCustomMessages = require_use_render_custom_messages.useRenderCu
 exports.useRenderTool = require_use_render_tool.useRenderTool;
 exports.useRenderToolCall = require_use_render_tool_call.useRenderToolCall;
 exports.useSuggestions = require_use_suggestions.useSuggestions;
+exports.useThreads = require_use_threads.useThreads;
 var _ag_ui_client = require("@ag-ui/client");
 Object.keys(_ag_ui_client).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {