@copilotkitnext/react 1.54.1-next.5 → 1.54.1

package/dist/hooks/use-threads.cjs

@@ -13,17 +13,17 @@ function useThreadStoreSelector(store, selector) {
 /**
 * 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.
+* On mount the hook fetches the thread list for the runtime-authenticated user
+* and the given `agentId`. 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.
+* @param input - Agent identifier and optional list controls.
 * @returns Thread list state and stable mutation callbacks.
 *
 * @example
@@ -32,7 +32,6 @@ function useThreadStoreSelector(store, selector) {
 *
 * function ThreadList() {
 *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
-*     userId: "user-1",
 *     agentId: "agent-1",
 *   });
 *
@@ -52,12 +51,14 @@ function useThreadStoreSelector(store, selector) {
 * }
 * ```
 */
-function useThreads({ userId, agentId }) {
+function useThreads({ agentId, includeArchived, limit }) {
 	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 hasNextPage = useThreadStoreSelector(store, _copilotkitnext_core.ɵselectHasNextPage);
+	const isFetchingNextPage = useThreadStoreSelector(store, _copilotkitnext_core.ɵselectIsFetchingNextPage);
 	const headersKey = (0, react.useMemo)(() => {
 		return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
 	}, [copilotkit.headers]);
@@ -78,8 +79,9 @@ function useThreads({ userId, agentId }) {
 			runtimeUrl: copilotkit.runtimeUrl,
 			headers: { ...copilotkit.headers },
 			wsUrl: copilotkit.intelligence?.wsUrl,
-			userId,
-			agentId
+			agentId,
+			includeArchived,
+			limit
 		} : null;
 		store.setContext(context);
 	}, [
@@ -87,17 +89,24 @@ function useThreads({ userId, agentId }) {
 		copilotkit.runtimeUrl,
 		headersKey,
 		copilotkit.intelligence?.wsUrl,
-		userId,
 		agentId,
-		copilotkit.headers
+		copilotkit.headers,
+		includeArchived,
+		limit
 	]);
+	const renameThread = (0, react.useCallback)((threadId, name) => store.renameThread(threadId, name), [store]);
+	const archiveThread = (0, react.useCallback)((threadId) => store.archiveThread(threadId), [store]);
+	const deleteThread = (0, react.useCallback)((threadId) => store.deleteThread(threadId), [store]);
 	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])
+		hasNextPage,
+		isFetchingNextPage,
+		fetchNextPage: (0, react.useCallback)(() => store.fetchNextPage(), [store]),
+		renameThread,
+		archiveThread,
+		deleteThread
 	};
 }
 

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

@@ -1 +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"}
+{"version":3,"file":"use-threads.cjs","names":["useCopilotKit","ɵselectThreads","ɵselectThreadsIsLoading","ɵselectThreadsError","ɵselectHasNextPage","ɵselectIsFetchingNextPage"],"sources":["../../src/hooks/use-threads.tsx"],"sourcesContent":["import { useCopilotKit } from \"@/providers/CopilotKitProvider\";\nimport {\n  ɵcreateThreadStore,\n  ɵselectThreads,\n  ɵselectThreadsError,\n  ɵselectThreadsIsLoading,\n  ɵselectHasNextPage,\n  ɵselectIsFetchingNextPage,\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 * Thread operations are scoped to the runtime-authenticated user and the\n * provided agent on the Intelligence platform.\n */\nexport interface UseThreadsInput {\n  /** The ID of the agent whose threads to list and manage. */\n  agentId: string;\n  /** When `true`, archived threads are included in the list. Defaults to `false`. */\n  includeArchived?: boolean;\n  /** Maximum number of threads to fetch per page. When set, enables cursor-based pagination. */\n  limit?: number;\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   * Threads for the current user/agent pair, sorted by most recently\n   * updated first. Updated in realtime when the platform pushes metadata\n   * events. Includes archived threads only when `includeArchived` is set.\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   * `true` when there are more threads available to fetch via\n   * {@link fetchNextPage}. Only meaningful when `limit` is set.\n   */\n  hasNextPage: boolean;\n  /**\n   * `true` while a subsequent page of threads is being fetched.\n   */\n  isFetchingNextPage: boolean;\n  /**\n   * Fetch the next page of threads. No-op when {@link hasNextPage} is\n   * `false` or a page fetch is already in progress.\n   */\n  fetchNextPage: () => void;\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 runtime-authenticated user\n * and the given `agentId`. When the Intelligence platform exposes a WebSocket\n * URL, it also opens a realtime subscription so the `threads` array stays\n * current without polling — thread creates, renames, archives, and deletes\n * from any client 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 - Agent identifier and optional list controls.\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 *     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  agentId,\n  includeArchived,\n  limit,\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 hasNextPage = useThreadStoreSelector(store, ɵselectHasNextPage);\n  const isFetchingNextPage = useThreadStoreSelector(\n    store,\n    ɵselectIsFetchingNextPage,\n  );\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          agentId,\n          includeArchived,\n          limit,\n        }\n      : null;\n\n    store.setContext(context);\n  }, [\n    store,\n    copilotkit.runtimeUrl,\n    headersKey,\n    copilotkit.intelligence?.wsUrl,\n    agentId,\n    copilotkit.headers,\n    includeArchived,\n    limit,\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  const fetchNextPage = useCallback(() => store.fetchNextPage(), [store]);\n\n  return {\n    threads,\n    isLoading,\n    error,\n    hasNextPage,\n    isFetchingNextPage,\n    fetchNextPage,\n    renameThread,\n    archiveThread,\n    deleteThread,\n  };\n}\n"],"mappings":";;;;;;AAqGA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CH,SAAgB,WAAW,EACzB,SACA,iBACA,SACoC;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,cAAc,uBAAuB,OAAOC,wCAAmB;CACrE,MAAM,qBAAqB,uBACzB,OACAC,+CACD;CACD,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;GACA;GACD,GACD;AAEJ,QAAM,WAAW,QAAQ;IACxB;EACD;EACA,WAAW;EACX;EACA,WAAW,cAAc;EACzB;EACA,WAAW;EACX;EACA;EACD,CAAC;CAEF,MAAM,uCACH,UAAkB,SAAiB,MAAM,aAAa,UAAU,KAAK,EACtE,CAAC,MAAM,CACR;CAED,MAAM,wCACH,aAAqB,MAAM,cAAc,SAAS,EACnD,CAAC,MAAM,CACR;CAED,MAAM,uCACH,aAAqB,MAAM,aAAa,SAAS,EAClD,CAAC,MAAM,CACR;AAID,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,4CARsC,MAAM,eAAe,EAAE,CAAC,MAAM,CAAC;EASrE;EACA;EACA;EACD"}

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

@@ -11,14 +11,16 @@ 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.
+ * Thread operations are scoped to the runtime-authenticated user and the
+ * provided agent 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;
+  /** When `true`, archived threads are included in the list. Defaults to `false`. */
+  includeArchived?: boolean;
+  /** Maximum number of threads to fetch per page. When set, enables cursor-based pagination. */
+  limit?: number;
 }
 /**
  * Return value of the {@link useThreads} hook.
@@ -29,9 +31,9 @@ interface UseThreadsInput {
  */
 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 for the current user/agent pair, sorted by most recently
+   * updated first. Updated in realtime when the platform pushes metadata
+   * events. Includes archived threads only when `includeArchived` is set.
    */
   threads: Thread[];
   /**
@@ -45,6 +47,20 @@ interface UseThreadsResult {
    * successful fetch.
    */
   error: Error | null;
+  /**
+   * `true` when there are more threads available to fetch via
+   * {@link fetchNextPage}. Only meaningful when `limit` is set.
+   */
+  hasNextPage: boolean;
+  /**
+   * `true` while a subsequent page of threads is being fetched.
+   */
+  isFetchingNextPage: boolean;
+  /**
+   * Fetch the next page of threads. No-op when {@link hasNextPage} is
+   * `false` or a page fetch is already in progress.
+   */
+  fetchNextPage: () => void;
   /**
    * Rename a thread on the platform.
    * Resolves when the server confirms the update; rejects on failure.
@@ -66,17 +82,17 @@ interface UseThreadsResult {
 /**
  * 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.
+ * On mount the hook fetches the thread list for the runtime-authenticated user
+ * and the given `agentId`. 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.
+ * @param input - Agent identifier and optional list controls.
  * @returns Thread list state and stable mutation callbacks.
  *
  * @example
@@ -85,7 +101,6 @@ interface UseThreadsResult {
  *
  * function ThreadList() {
  *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
- *     userId: "user-1",
  *     agentId: "agent-1",
  *   });
  *
@@ -106,8 +121,9 @@ interface UseThreadsResult {
  * ```
  */
 declare function useThreads({
-  userId,
-  agentId
+  agentId,
+  includeArchived,
+  limit
 }: UseThreadsInput): UseThreadsResult;
 //#endregion
 export { Thread, UseThreadsInput, UseThreadsResult, useThreads };

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

@@ -1 +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"}
+{"version":3,"file":"use-threads.d.cts","names":[],"sources":["../../src/hooks/use-threads.tsx"],"mappings":";;;;;AA0BA;;;;UAAiB,MAAA,SAAe,OAAA;;;;;;;UAQf,eAAA;EAMV;EAJL,OAAA;EAc+B;EAZ/B,eAAA;EAkBS;EAhBT,KAAA;AAAA;;;;;;;;UAUe,gBAAA;EAiBR;;;;;EAXP,OAAA,EAAS,MAAA;EA8BwB;;;;EAzBjC,SAAA;EAqCA;;;;;EA/BA,KAAA,EAAO,KAAA;EA2FiB;;;;EAtFxB,WAAA;EA0FC;;;EAtFD,kBAAA;EAmFA;;;;EA9EA,aAAA;EAgFA;;;;EA3EA,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;;;;;;EAMlD,aAAA,GAAgB,QAAA,aAAqB,OAAA;;;;;;EAMrC,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4DtB,UAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA"}

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

@@ -11,14 +11,16 @@ 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.
+ * Thread operations are scoped to the runtime-authenticated user and the
+ * provided agent 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;
+  /** When `true`, archived threads are included in the list. Defaults to `false`. */
+  includeArchived?: boolean;
+  /** Maximum number of threads to fetch per page. When set, enables cursor-based pagination. */
+  limit?: number;
 }
 /**
  * Return value of the {@link useThreads} hook.
@@ -29,9 +31,9 @@ interface UseThreadsInput {
  */
 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 for the current user/agent pair, sorted by most recently
+   * updated first. Updated in realtime when the platform pushes metadata
+   * events. Includes archived threads only when `includeArchived` is set.
    */
   threads: Thread[];
   /**
@@ -45,6 +47,20 @@ interface UseThreadsResult {
    * successful fetch.
    */
   error: Error | null;
+  /**
+   * `true` when there are more threads available to fetch via
+   * {@link fetchNextPage}. Only meaningful when `limit` is set.
+   */
+  hasNextPage: boolean;
+  /**
+   * `true` while a subsequent page of threads is being fetched.
+   */
+  isFetchingNextPage: boolean;
+  /**
+   * Fetch the next page of threads. No-op when {@link hasNextPage} is
+   * `false` or a page fetch is already in progress.
+   */
+  fetchNextPage: () => void;
   /**
    * Rename a thread on the platform.
    * Resolves when the server confirms the update; rejects on failure.
@@ -66,17 +82,17 @@ interface UseThreadsResult {
 /**
  * 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.
+ * On mount the hook fetches the thread list for the runtime-authenticated user
+ * and the given `agentId`. 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.
+ * @param input - Agent identifier and optional list controls.
  * @returns Thread list state and stable mutation callbacks.
  *
  * @example
@@ -85,7 +101,6 @@ interface UseThreadsResult {
  *
  * function ThreadList() {
  *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
- *     userId: "user-1",
  *     agentId: "agent-1",
  *   });
  *
@@ -106,8 +121,9 @@ interface UseThreadsResult {
  * ```
  */
 declare function useThreads({
-  userId,
-  agentId
+  agentId,
+  includeArchived,
+  limit
 }: UseThreadsInput): UseThreadsResult;
 //#endregion
 export { Thread, UseThreadsInput, UseThreadsResult, useThreads };

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

@@ -1 +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"}
+{"version":3,"file":"use-threads.d.mts","names":[],"sources":["../../src/hooks/use-threads.tsx"],"mappings":";;;;;AA0BA;;;;UAAiB,MAAA,SAAe,OAAA;;;;;;;UAQf,eAAA;EAMV;EAJL,OAAA;EAc+B;EAZ/B,eAAA;EAkBS;EAhBT,KAAA;AAAA;;;;;;;;UAUe,gBAAA;EAiBR;;;;;EAXP,OAAA,EAAS,MAAA;EA8BwB;;;;EAzBjC,SAAA;EAqCA;;;;;EA/BA,KAAA,EAAO,KAAA;EA2FiB;;;;EAtFxB,WAAA;EA0FC;;;EAtFD,kBAAA;EAmFA;;;;EA9EA,aAAA;EAgFA;;;;EA3EA,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;;;;;;EAMlD,aAAA,GAAgB,QAAA,aAAqB,OAAA;;;;;;EAMrC,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4DtB,UAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA"}

package/dist/hooks/use-threads.mjs

@@ -1,6 +1,6 @@
 import { useCopilotKit } from "../providers/CopilotKitProvider.mjs";
 import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
-import { ɵcreateThreadStore, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkitnext/core";
+import { ɵcreateThreadStore, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkitnext/core";
 
 //#region src/hooks/use-threads.tsx
 function useThreadStoreSelector(store, selector) {
@@ -12,17 +12,17 @@ function useThreadStoreSelector(store, selector) {
 /**
 * 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.
+* On mount the hook fetches the thread list for the runtime-authenticated user
+* and the given `agentId`. 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.
+* @param input - Agent identifier and optional list controls.
 * @returns Thread list state and stable mutation callbacks.
 *
 * @example
@@ -31,7 +31,6 @@ function useThreadStoreSelector(store, selector) {
 *
 * function ThreadList() {
 *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
-*     userId: "user-1",
 *     agentId: "agent-1",
 *   });
 *
@@ -51,12 +50,14 @@ function useThreadStoreSelector(store, selector) {
 * }
 * ```
 */
-function useThreads({ userId, agentId }) {
+function useThreads({ agentId, includeArchived, limit }) {
 	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 hasNextPage = useThreadStoreSelector(store, ɵselectHasNextPage);
+	const isFetchingNextPage = useThreadStoreSelector(store, ɵselectIsFetchingNextPage);
 	const headersKey = useMemo(() => {
 		return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
 	}, [copilotkit.headers]);
@@ -77,8 +78,9 @@ function useThreads({ userId, agentId }) {
 			runtimeUrl: copilotkit.runtimeUrl,
 			headers: { ...copilotkit.headers },
 			wsUrl: copilotkit.intelligence?.wsUrl,
-			userId,
-			agentId
+			agentId,
+			includeArchived,
+			limit
 		} : null;
 		store.setContext(context);
 	}, [
@@ -86,17 +88,24 @@ function useThreads({ userId, agentId }) {
 		copilotkit.runtimeUrl,
 		headersKey,
 		copilotkit.intelligence?.wsUrl,
-		userId,
 		agentId,
-		copilotkit.headers
+		copilotkit.headers,
+		includeArchived,
+		limit
 	]);
+	const renameThread = useCallback((threadId, name) => store.renameThread(threadId, name), [store]);
+	const archiveThread = useCallback((threadId) => store.archiveThread(threadId), [store]);
+	const deleteThread = useCallback((threadId) => store.deleteThread(threadId), [store]);
 	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])
+		hasNextPage,
+		isFetchingNextPage,
+		fetchNextPage: useCallback(() => store.fetchNextPage(), [store]),
+		renameThread,
+		archiveThread,
+		deleteThread
 	};
 }
 

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

@@ -1 +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"}
+{"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  ɵselectHasNextPage,\n  ɵselectIsFetchingNextPage,\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 * Thread operations are scoped to the runtime-authenticated user and the\n * provided agent on the Intelligence platform.\n */\nexport interface UseThreadsInput {\n  /** The ID of the agent whose threads to list and manage. */\n  agentId: string;\n  /** When `true`, archived threads are included in the list. Defaults to `false`. */\n  includeArchived?: boolean;\n  /** Maximum number of threads to fetch per page. When set, enables cursor-based pagination. */\n  limit?: number;\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   * Threads for the current user/agent pair, sorted by most recently\n   * updated first. Updated in realtime when the platform pushes metadata\n   * events. Includes archived threads only when `includeArchived` is set.\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   * `true` when there are more threads available to fetch via\n   * {@link fetchNextPage}. Only meaningful when `limit` is set.\n   */\n  hasNextPage: boolean;\n  /**\n   * `true` while a subsequent page of threads is being fetched.\n   */\n  isFetchingNextPage: boolean;\n  /**\n   * Fetch the next page of threads. No-op when {@link hasNextPage} is\n   * `false` or a page fetch is already in progress.\n   */\n  fetchNextPage: () => void;\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 runtime-authenticated user\n * and the given `agentId`. When the Intelligence platform exposes a WebSocket\n * URL, it also opens a realtime subscription so the `threads` array stays\n * current without polling — thread creates, renames, archives, and deletes\n * from any client 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 - Agent identifier and optional list controls.\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 *     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  agentId,\n  includeArchived,\n  limit,\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 hasNextPage = useThreadStoreSelector(store, ɵselectHasNextPage);\n  const isFetchingNextPage = useThreadStoreSelector(\n    store,\n    ɵselectIsFetchingNextPage,\n  );\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          agentId,\n          includeArchived,\n          limit,\n        }\n      : null;\n\n    store.setContext(context);\n  }, [\n    store,\n    copilotkit.runtimeUrl,\n    headersKey,\n    copilotkit.intelligence?.wsUrl,\n    agentId,\n    copilotkit.headers,\n    includeArchived,\n    limit,\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  const fetchNextPage = useCallback(() => store.fetchNextPage(), [store]);\n\n  return {\n    threads,\n    isLoading,\n    error,\n    hasNextPage,\n    isFetchingNextPage,\n    fetchNextPage,\n    renameThread,\n    archiveThread,\n    deleteThread,\n  };\n}\n"],"mappings":";;;;;AAqGA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CH,SAAgB,WAAW,EACzB,SACA,iBACA,SACoC;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,cAAc,uBAAuB,OAAO,mBAAmB;CACrE,MAAM,qBAAqB,uBACzB,OACA,0BACD;CACD,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;GACA;GACD,GACD;AAEJ,QAAM,WAAW,QAAQ;IACxB;EACD;EACA,WAAW;EACX;EACA,WAAW,cAAc;EACzB;EACA,WAAW;EACX;EACA;EACD,CAAC;CAEF,MAAM,eAAe,aAClB,UAAkB,SAAiB,MAAM,aAAa,UAAU,KAAK,EACtE,CAAC,MAAM,CACR;CAED,MAAM,gBAAgB,aACnB,aAAqB,MAAM,cAAc,SAAS,EACnD,CAAC,MAAM,CACR;CAED,MAAM,eAAe,aAClB,aAAqB,MAAM,aAAa,SAAS,EAClD,CAAC,MAAM,CACR;AAID,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,eARoB,kBAAkB,MAAM,eAAe,EAAE,CAAC,MAAM,CAAC;EASrE;EACA;EACA;EACD"}