@copilotkit/react-core 2.0.0-rc.1 → 2.0.0-rc.10

package/dist/context.cjs

@@ -5,9 +5,28 @@ let react = require("react");
 let _copilotkit_core = require("@copilotkit/core");
 
 //#region src/lib/react-core.ts
+/**
+* Wait for pending React state updates before the follow-up agent run.
+*
+* When a frontend tool handler calls setState(), React 18 batches the update
+* and schedules a commit via its internal scheduler (MessageChannel). The
+* useAgentContext hook registers context via useLayoutEffect, which runs
+* synchronously after React commits that batch.
+*
+* Awaiting a zero-delay timeout yields to the macrotask queue. React's
+* MessageChannel task runs first, committing the pending state and running
+* useLayoutEffect (which updates the context store). The follow-up runAgent
+* call then reads fresh context.
+*/
+function waitForReactCommit() {
+	return new Promise((resolve) => setTimeout(resolve, 0));
+}
 var CopilotKitCoreReact = class extends _copilotkit_core.CopilotKitCore {
 	constructor(config) {
-		super(config);
+		super({
+			...config,
+			ɵwaitForFrameworkUpdates: waitForReactCommit
+		});
 		this._renderToolCalls = [];
 		this._hookRenderToolCalls = /* @__PURE__ */ new Map();
 		this._cachedMergedRenderToolCalls = null;
@@ -81,22 +100,6 @@ var CopilotKitCoreReact = class extends _copilotkit_core.CopilotKitCore {
 	subscribe(subscriber) {
 		return super.subscribe(subscriber);
 	}
-	/**
-	* Wait for pending React state updates before the follow-up agent run.
-	*
-	* When a frontend tool handler calls setState(), React 18 batches the update
-	* and schedules a commit via its internal scheduler (MessageChannel). The
-	* useAgentContext hook registers context via useLayoutEffect, which runs
-	* synchronously after React commits that batch.
-	*
-	* Awaiting a zero-delay timeout yields to the macrotask queue. React's
-	* MessageChannel task runs first, committing the pending state and running
-	* useLayoutEffect (which updates the context store). The follow-up runAgent
-	* call then reads fresh context.
-	*/
-	async waitForPendingFrameworkUpdates() {
-		await new Promise((resolve) => setTimeout(resolve, 0));
-	}
 };
 
 //#endregion

package/dist/context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.cjs","names":["CopilotKitCore"],"sources":["../src/lib/react-core.ts","../src/context.ts"],"sourcesContent":["import React from \"react\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\nimport { CopilotKitCore } from \"@copilotkit/core\";\nimport type {\n  CopilotKitCoreConfig,\n  CopilotKitCoreSubscriber,\n  CopilotKitCoreSubscription,\n} from \"@copilotkit/core\";\n\nexport interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {\n  // Add any additional configuration properties specific to the React implementation\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n\n  // Add custom message renderers\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n}\n\nexport interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {\n  onRenderToolCallsChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    renderToolCalls: ReactToolCallRenderer<any>[];\n  }) => void | Promise<void>;\n  onInterruptElementChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    interruptElement: React.ReactElement | null;\n  }) => void | Promise<void>;\n}\n\nexport class CopilotKitCoreReact extends CopilotKitCore {\n  private _renderToolCalls: ReactToolCallRenderer<any>[] = [];\n  private _hookRenderToolCalls: Map<string, ReactToolCallRenderer<any>> =\n    new Map();\n  private _cachedMergedRenderToolCalls: ReactToolCallRenderer<any>[] | null =\n    null;\n  private _renderCustomMessages: ReactCustomMessageRenderer[] = [];\n  private _renderActivityMessages: ReactActivityMessageRenderer<any>[] = [];\n  private _interruptElement: React.ReactElement | null = null;\n\n  constructor(config: CopilotKitCoreReactConfig) {\n    super(config);\n    this._renderToolCalls = config.renderToolCalls ?? [];\n    this._renderCustomMessages = config.renderCustomMessages ?? [];\n    this._renderActivityMessages = config.renderActivityMessages ?? [];\n  }\n\n  get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]> {\n    return this._renderCustomMessages;\n  }\n\n  get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[] {\n    return this._renderActivityMessages;\n  }\n\n  get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[] {\n    if (this._hookRenderToolCalls.size === 0) {\n      return this._renderToolCalls;\n    }\n    if (this._cachedMergedRenderToolCalls) {\n      return this._cachedMergedRenderToolCalls;\n    }\n    // Merge: hook entries override prop entries with the same key\n    const merged = new Map<string, ReactToolCallRenderer<any>>();\n    for (const rc of this._renderToolCalls) {\n      merged.set(`${rc.agentId ?? \"\"}:${rc.name}`, rc);\n    }\n    for (const [key, rc] of this._hookRenderToolCalls) {\n      merged.set(key, rc);\n    }\n    this._cachedMergedRenderToolCalls = Array.from(merged.values());\n    return this._cachedMergedRenderToolCalls;\n  }\n\n  setRenderActivityMessages(\n    renderers: ReactActivityMessageRenderer<any>[],\n  ): void {\n    this._renderActivityMessages = renderers;\n  }\n\n  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void {\n    this._renderCustomMessages = renderers;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void {\n    const key = `${entry.agentId ?? \"\"}:${entry.name}`;\n    this._hookRenderToolCalls.set(key, entry);\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  removeHookRenderToolCall(name: string, agentId?: string): void {\n    const key = `${agentId ?? \"\"}:${name}`;\n    if (this._hookRenderToolCalls.delete(key)) {\n      this._cachedMergedRenderToolCalls = null;\n      this._notifyRenderToolCallsChanged();\n    }\n  }\n\n  private _notifyRenderToolCallsChanged(): void {\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      if (reactSubscriber.onRenderToolCallsChanged) {\n        reactSubscriber.onRenderToolCallsChanged({\n          copilotkit: this,\n          renderToolCalls: this.renderToolCalls,\n        });\n      }\n    }, \"Subscriber onRenderToolCallsChanged error:\");\n  }\n\n  get interruptElement(): React.ReactElement | null {\n    return this._interruptElement;\n  }\n\n  setInterruptElement(element: React.ReactElement | null): void {\n    this._interruptElement = element;\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      reactSubscriber.onInterruptElementChanged?.({\n        copilotkit: this,\n        interruptElement: this._interruptElement,\n      });\n    }, \"Subscriber onInterruptElementChanged error:\");\n  }\n\n  // Override to accept React-specific subscriber type\n  subscribe(\n    subscriber: CopilotKitCoreReactSubscriber,\n  ): CopilotKitCoreSubscription {\n    return super.subscribe(subscriber);\n  }\n\n  /**\n   * Wait for pending React state updates before the follow-up agent run.\n   *\n   * When a frontend tool handler calls setState(), React 18 batches the update\n   * and schedules a commit via its internal scheduler (MessageChannel). The\n   * useAgentContext hook registers context via useLayoutEffect, which runs\n   * synchronously after React commits that batch.\n   *\n   * Awaiting a zero-delay timeout yields to the macrotask queue. React's\n   * MessageChannel task runs first, committing the pending state and running\n   * useLayoutEffect (which updates the context store). The follow-up runAgent\n   * call then reads fresh context.\n   */\n  async waitForPendingFrameworkUpdates(): Promise<void> {\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n  }\n}\n","\"use client\";\n\nimport { createContext, useContext, useEffect, useReducer } from \"react\";\nimport { CopilotKitCoreReact } from \"./lib/react-core\";\nimport type { CopilotKitCoreReactConfig } from \"./lib/react-core\";\nimport type { LicenseContextValue } from \"@copilotkit/shared\";\n\n// Re-export so headless.ts (and consumers) reference the same type declaration.\nexport { CopilotKitCoreReact };\nexport type { CopilotKitCoreReactConfig };\n\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\n  /**\n   * Whether CopilotKit should automatically mount Intelligence indicators.\n   * Defaults to true when omitted for compatibility with custom providers.\n   */\n  showIntelligenceIndicator?: boolean;\n  /**\n   * Set of tool call IDs currently being executed.\n   * This is tracked at the provider level to ensure tool execution events\n   * are captured even before child components mount.\n   */\n  executingToolCallIds: ReadonlySet<string>;\n}\n\nexport const EMPTY_SET: ReadonlySet<string> = new Set();\n\nexport const CopilotKitContext = createContext<CopilotKitContextValue | null>(\n  null,\n);\n\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0);\n\n  if (!context) {\n    throw new Error(\"useCopilotKit must be used within CopilotKitProvider\");\n  }\n  useEffect(() => {\n    const subscription = context.copilotkit.subscribe({\n      onRuntimeConnectionStatusChanged: () => {\n        forceUpdate();\n      },\n      onHeadersChanged: () => {\n        forceUpdate();\n      },\n    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n\n// License context — shared between web and RN providers.\n// Default is permissive (all features allowed) — providers override via createLicenseContextValue.\n// Inlined here to avoid a runtime import from @copilotkit/shared, which pulls in\n// Node-only deps (jose) that break React Native's Metro bundler.\nexport const LicenseContext = createContext<LicenseContextValue>({\n  status: null,\n  license: null,\n  checkFeature: () => true,\n  getLimit: () => null,\n} as LicenseContextValue);\n\nexport const useLicenseContext = (): LicenseContextValue =>\n  useContext(LicenseContext);\n\n// Provider-level default agent id, published by `<CopilotKitProvider agentId>`.\n//\n// This is a context of its own rather than a `CopilotChatConfigurationProvider`\n// rendered at the root, because that provider also owns a thread: it resolves a\n// threadId (minting a UUID when none is given) and the top-most one owns the\n// imperative active-thread override. Rendering it around the whole application\n// would hand every `<CopilotChat>` the same inherited threadId, so two sibling\n// chats would share one transcript. A bare string context carries the agent\n// default and nothing else.\n//\n// It is the LAST fallback before `DEFAULT_AGENT_ID`, so an explicit `agentId`\n// argument, a `<CopilotChat agentId>`, and a `<CopilotChatConfigurationProvider\n// agentId>` all still win.\nexport const CopilotKitAgentIdContext = createContext<string | undefined>(\n  undefined,\n);\n\nexport const useDefaultAgentId = (): string | undefined =>\n  useContext(CopilotKitAgentIdContext);\n"],"mappings":";;;;;;;AAiCA,IAAa,sBAAb,cAAyCA,gCAAe;CAUtD,YAAY,QAAmC;AAC7C,QAAM,OAAO;0BAV0C,EAAE;8CAEzD,IAAI,KAAK;sCAET;+BAC4D,EAAE;iCACO,EAAE;2BAClB;AAIrD,OAAK,mBAAmB,OAAO,mBAAmB,EAAE;AACpD,OAAK,wBAAwB,OAAO,wBAAwB,EAAE;AAC9D,OAAK,0BAA0B,OAAO,0BAA0B,EAAE;;CAGpE,IAAI,uBAA+D;AACjE,SAAO,KAAK;;CAGd,IAAI,yBAAwE;AAC1E,SAAO,KAAK;;CAGd,IAAI,kBAA0D;AAC5D,MAAI,KAAK,qBAAqB,SAAS,EACrC,QAAO,KAAK;AAEd,MAAI,KAAK,6BACP,QAAO,KAAK;EAGd,MAAM,yBAAS,IAAI,KAAyC;AAC5D,OAAK,MAAM,MAAM,KAAK,iBACpB,QAAO,IAAI,GAAG,GAAG,WAAW,GAAG,GAAG,GAAG,QAAQ,GAAG;AAElD,OAAK,MAAM,CAAC,KAAK,OAAO,KAAK,qBAC3B,QAAO,IAAI,KAAK,GAAG;AAErB,OAAK,+BAA+B,MAAM,KAAK,OAAO,QAAQ,CAAC;AAC/D,SAAO,KAAK;;CAGd,0BACE,WACM;AACN,OAAK,0BAA0B;;CAGjC,wBAAwB,WAA+C;AACrE,OAAK,wBAAwB;;CAG/B,mBAAmB,iBAAqD;AACtE,OAAK,mBAAmB;AACxB,OAAK,+BAA+B;AACpC,OAAK,+BAA+B;;CAGtC,sBAAsB,OAAyC;EAC7D,MAAM,MAAM,GAAG,MAAM,WAAW,GAAG,GAAG,MAAM;AAC5C,OAAK,qBAAqB,IAAI,KAAK,MAAM;AACzC,OAAK,+BAA+B;AACpC,OAAK,+BAA+B;;CAGtC,yBAAyB,MAAc,SAAwB;EAC7D,MAAM,MAAM,GAAG,WAAW,GAAG,GAAG;AAChC,MAAI,KAAK,qBAAqB,OAAO,IAAI,EAAE;AACzC,QAAK,+BAA+B;AACpC,QAAK,+BAA+B;;;CAIxC,AAAQ,gCAAsC;AAC5C,EAAK,KAAK,mBAAmB,eAAe;GAC1C,MAAM,kBAAkB;AACxB,OAAI,gBAAgB,yBAClB,iBAAgB,yBAAyB;IACvC,YAAY;IACZ,iBAAiB,KAAK;IACvB,CAAC;KAEH,6CAA6C;;CAGlD,IAAI,mBAA8C;AAChD,SAAO,KAAK;;CAGd,oBAAoB,SAA0C;AAC5D,OAAK,oBAAoB;AACzB,EAAK,KAAK,mBAAmB,eAAe;AAE1C,GADwB,WACR,4BAA4B;IAC1C,YAAY;IACZ,kBAAkB,KAAK;IACxB,CAAC;KACD,8CAA8C;;CAInD,UACE,YAC4B;AAC5B,SAAO,MAAM,UAAU,WAAW;;;;;;;;;;;;;;;CAgBpC,MAAM,iCAAgD;AACpD,QAAM,IAAI,SAAe,YAAY,WAAW,SAAS,EAAE,CAAC;;;;;;AClIhE,MAAa,4BAAiC,IAAI,KAAK;AAEvD,MAAa,6CACX,KACD;AAED,MAAa,sBAA8C;CACzD,MAAM,gCAAqB,kBAAkB;CAC7C,MAAM,GAAG,sCAA2B,MAAc,IAAI,GAAG,EAAE;AAE3D,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,uDAAuD;AAEzE,4BAAgB;EACd,MAAM,eAAe,QAAQ,WAAW,UAAU;GAChD,wCAAwC;AACtC,iBAAa;;GAEf,wBAAwB;AACtB,iBAAa;;GAEhB,CAAC;AACF,eAAa;AACX,gBAAa,aAAa;;IAG3B,EAAE,CAAC;AAEN,QAAO;;AAOT,MAAa,0CAAoD;CAC/D,QAAQ;CACR,SAAS;CACT,oBAAoB;CACpB,gBAAgB;CACjB,CAAwB;AAEzB,MAAa,gDACA,eAAe;AAe5B,MAAa,oDACX,OACD;AAED,MAAa,gDACA,yBAAyB"}
+{"version":3,"file":"context.cjs","names":["CopilotKitCore"],"sources":["../src/lib/react-core.ts","../src/context.ts"],"sourcesContent":["import React from \"react\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\nimport { CopilotKitCore } from \"@copilotkit/core\";\nimport type {\n  CopilotKitCoreConfig,\n  CopilotKitCoreSubscriber,\n  CopilotKitCoreSubscription,\n} from \"@copilotkit/core\";\n\nexport interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {\n  // Add any additional configuration properties specific to the React implementation\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n\n  // Add custom message renderers\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n}\n\nexport interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {\n  onRenderToolCallsChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    renderToolCalls: ReactToolCallRenderer<any>[];\n  }) => void | Promise<void>;\n  onInterruptElementChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    interruptElement: React.ReactElement | null;\n  }) => void | Promise<void>;\n}\n\n/**\n * Wait for pending React state updates before the follow-up agent run.\n *\n * When a frontend tool handler calls setState(), React 18 batches the update\n * and schedules a commit via its internal scheduler (MessageChannel). The\n * useAgentContext hook registers context via useLayoutEffect, which runs\n * synchronously after React commits that batch.\n *\n * Awaiting a zero-delay timeout yields to the macrotask queue. React's\n * MessageChannel task runs first, committing the pending state and running\n * useLayoutEffect (which updates the context store). The follow-up runAgent\n * call then reads fresh context.\n */\nfunction waitForReactCommit() {\n  return new Promise<void>((resolve) => setTimeout(resolve, 0));\n}\n\nexport class CopilotKitCoreReact extends CopilotKitCore {\n  private _renderToolCalls: ReactToolCallRenderer<any>[] = [];\n  private _hookRenderToolCalls: Map<string, ReactToolCallRenderer<any>> =\n    new Map();\n  private _cachedMergedRenderToolCalls: ReactToolCallRenderer<any>[] | null =\n    null;\n  private _renderCustomMessages: ReactCustomMessageRenderer[] = [];\n  private _renderActivityMessages: ReactActivityMessageRenderer<any>[] = [];\n  private _interruptElement: React.ReactElement | null = null;\n\n  constructor(config: CopilotKitCoreReactConfig) {\n    super({\n      ...config,\n      ɵwaitForFrameworkUpdates: waitForReactCommit,\n    });\n    this._renderToolCalls = config.renderToolCalls ?? [];\n    this._renderCustomMessages = config.renderCustomMessages ?? [];\n    this._renderActivityMessages = config.renderActivityMessages ?? [];\n  }\n\n  get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]> {\n    return this._renderCustomMessages;\n  }\n\n  get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[] {\n    return this._renderActivityMessages;\n  }\n\n  get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[] {\n    if (this._hookRenderToolCalls.size === 0) {\n      return this._renderToolCalls;\n    }\n    if (this._cachedMergedRenderToolCalls) {\n      return this._cachedMergedRenderToolCalls;\n    }\n    // Merge: hook entries override prop entries with the same key\n    const merged = new Map<string, ReactToolCallRenderer<any>>();\n    for (const rc of this._renderToolCalls) {\n      merged.set(`${rc.agentId ?? \"\"}:${rc.name}`, rc);\n    }\n    for (const [key, rc] of this._hookRenderToolCalls) {\n      merged.set(key, rc);\n    }\n    this._cachedMergedRenderToolCalls = Array.from(merged.values());\n    return this._cachedMergedRenderToolCalls;\n  }\n\n  setRenderActivityMessages(\n    renderers: ReactActivityMessageRenderer<any>[],\n  ): void {\n    this._renderActivityMessages = renderers;\n  }\n\n  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void {\n    this._renderCustomMessages = renderers;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void {\n    const key = `${entry.agentId ?? \"\"}:${entry.name}`;\n    this._hookRenderToolCalls.set(key, entry);\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  removeHookRenderToolCall(name: string, agentId?: string): void {\n    const key = `${agentId ?? \"\"}:${name}`;\n    if (this._hookRenderToolCalls.delete(key)) {\n      this._cachedMergedRenderToolCalls = null;\n      this._notifyRenderToolCallsChanged();\n    }\n  }\n\n  private _notifyRenderToolCallsChanged(): void {\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      if (reactSubscriber.onRenderToolCallsChanged) {\n        reactSubscriber.onRenderToolCallsChanged({\n          copilotkit: this,\n          renderToolCalls: this.renderToolCalls,\n        });\n      }\n    }, \"Subscriber onRenderToolCallsChanged error:\");\n  }\n\n  get interruptElement(): React.ReactElement | null {\n    return this._interruptElement;\n  }\n\n  setInterruptElement(element: React.ReactElement | null): void {\n    this._interruptElement = element;\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      reactSubscriber.onInterruptElementChanged?.({\n        copilotkit: this,\n        interruptElement: this._interruptElement,\n      });\n    }, \"Subscriber onInterruptElementChanged error:\");\n  }\n\n  // Override to accept React-specific subscriber type\n  subscribe(\n    subscriber: CopilotKitCoreReactSubscriber,\n  ): CopilotKitCoreSubscription {\n    return super.subscribe(subscriber);\n  }\n}\n","\"use client\";\n\nimport { createContext, useContext, useEffect, useReducer } from \"react\";\nimport { CopilotKitCoreReact } from \"./lib/react-core\";\nimport type { CopilotKitCoreReactConfig } from \"./lib/react-core\";\nimport type { LicenseContextValue } from \"@copilotkit/shared\";\n\n// Re-export so headless.ts (and consumers) reference the same type declaration.\nexport { CopilotKitCoreReact };\nexport type { CopilotKitCoreReactConfig };\n\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\n  /**\n   * Whether CopilotKit should automatically mount Intelligence indicators.\n   * Defaults to true when omitted for compatibility with custom providers.\n   */\n  showIntelligenceIndicator?: boolean;\n  /**\n   * Set of tool call IDs currently being executed.\n   * This is tracked at the provider level to ensure tool execution events\n   * are captured even before child components mount.\n   */\n  executingToolCallIds: ReadonlySet<string>;\n}\n\nexport const EMPTY_SET: ReadonlySet<string> = new Set();\n\nexport const CopilotKitContext = createContext<CopilotKitContextValue | null>(\n  null,\n);\n\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0);\n\n  if (!context) {\n    throw new Error(\"useCopilotKit must be used within CopilotKitProvider\");\n  }\n  useEffect(() => {\n    const subscription = context.copilotkit.subscribe({\n      onRuntimeConnectionStatusChanged: () => {\n        forceUpdate();\n      },\n      onHeadersChanged: () => {\n        forceUpdate();\n      },\n    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n\n// License context — shared between web and RN providers.\n// Default is permissive (all features allowed) — providers override via createLicenseContextValue.\n// Inlined here to avoid a runtime import from @copilotkit/shared, which pulls in\n// Node-only deps (jose) that break React Native's Metro bundler.\nexport const LicenseContext = createContext<LicenseContextValue>({\n  status: null,\n  license: null,\n  checkFeature: () => true,\n  getLimit: () => null,\n} as LicenseContextValue);\n\nexport const useLicenseContext = (): LicenseContextValue =>\n  useContext(LicenseContext);\n\n// Provider-level default agent id, published by `<CopilotKitProvider agentId>`.\n//\n// This is a context of its own rather than a `CopilotChatConfigurationProvider`\n// rendered at the root, because that provider also owns a thread: it resolves a\n// threadId (minting a UUID when none is given) and the top-most one owns the\n// imperative active-thread override. Rendering it around the whole application\n// would hand every `<CopilotChat>` the same inherited threadId, so two sibling\n// chats would share one transcript. A bare string context carries the agent\n// default and nothing else.\n//\n// It is the LAST fallback before `DEFAULT_AGENT_ID`, so an explicit `agentId`\n// argument, a `<CopilotChat agentId>`, and a `<CopilotChatConfigurationProvider\n// agentId>` all still win.\nexport const CopilotKitAgentIdContext = createContext<string | undefined>(\n  undefined,\n);\n\nexport const useDefaultAgentId = (): string | undefined =>\n  useContext(CopilotKitAgentIdContext);\n"],"mappings":"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"}

package/dist/context.d.cts

@@ -1,91 +1,45 @@
 import * as react from "react";
-import React$1 from "react";
-import { LicenseContextValue, StandardSchemaV1 } from "@copilotkit/shared";
-import { CopilotKitCore, CopilotKitCoreConfig, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, ToolCallStatus } from "@copilotkit/core";
-import { ActivityMessage, Message } from "@ag-ui/core";
-import { AbstractAgent } from "@ag-ui/client";
+import React from "react";
+import { ActivityMessageRenderProps, ActivityMessageRendererDef, CopilotKitCore, CopilotKitCoreConfig, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, CustomMessageRenderProps, CustomMessageRendererDef, ToolCallRenderProps, ToolCallRendererDef } from "@copilotkit/core";
+import { LicenseContextValue } from "@copilotkit/shared";
 
 //#region src/types/react-tool-call-renderer.d.ts
-interface ReactToolCallRenderer<T = unknown> {
-  name: string;
-  /**
-   * Schema describing the tool arguments. Optional — renderers registered for
-   * tools without parameters (e.g. HITL confirm dialogs) have no schema.
-   */
-  args?: StandardSchemaV1<any, T>;
-  /**
-   * Optional agent ID to constrain this tool renderer to a specific agent.
-   * If specified, this renderer will only be used for the specified agent.
-   */
-  agentId?: string;
-  /**
-   * Whether calls this renderer draws join the chat's tool-call groups (see
-   * `toolCallDisplay` on `CopilotChatMessageView`). CopilotKit's built-in card
-   * sets it; a renderer that leaves it unset always shows its calls on their
-   * own, since the chat can't tell what it draws (it may even draw nothing).
-   */
-  group?: boolean;
-  render: React.ComponentType<{
-    name: string;
-    toolCallId: string;
-    args: Partial<T>;
-    status: ToolCallStatus.InProgress;
-    result: undefined;
-  } | {
-    name: string;
-    toolCallId: string;
-    args: T;
-    status: ToolCallStatus.Executing;
-    result: undefined;
-  } | {
-    name: string;
-    toolCallId: string;
-    args: T;
-    status: ToolCallStatus.Complete;
-    result: string;
-  }>;
-}
+/**
+ * A tool call renderer for React: a React component that draws one tool call
+ * in the chat. The component receives {@link ToolCallRenderProps}.
+ *
+ * Pass a list of these to `renderToolCalls` on `CopilotKitProvider`, or build
+ * one with `defineToolCallRenderer`.
+ *
+ * @typeParam T - The shape of the tool arguments.
+ */
+type ReactToolCallRenderer<T = unknown> = ToolCallRendererDef<T, React.ComponentType<ToolCallRenderProps<T>>>;
 //#endregion
 //#region src/types/react-activity-message-renderer.d.ts
-interface ReactActivityMessageRenderer<TActivityContent> {
-  /**
-   * Activity type to match when rendering. Use "*" as a wildcard renderer.
-   */
-  activityType: string;
-  /**
-   * Optional agent ID to scope the renderer to a particular agent.
-   */
-  agentId?: string;
-  /**
-   * Schema describing the activity content payload.
-   */
-  content: StandardSchemaV1<any, TActivityContent>;
-  /**
-   * React component invoked to render the activity message.
-   */
-  render: React.ComponentType<{
-    activityType: string;
-    content: TActivityContent;
-    message: ActivityMessage;
-    agent: AbstractAgent | undefined;
-  }>;
-}
+/**
+ * An activity message renderer for React: a React component that draws
+ * activity messages of one `activityType` (or `"*"` for any type). The
+ * component receives {@link ActivityMessageRenderProps}.
+ *
+ * @typeParam TActivityContent - The shape of the activity content.
+ */
+type ReactActivityMessageRenderer<TActivityContent> = ActivityMessageRendererDef<TActivityContent, React.ComponentType<ActivityMessageRenderProps<TActivityContent>>>;
 //#endregion
 //#region src/types/react-custom-message-renderer.d.ts
-type ReactCustomMessageRendererPosition = "before" | "after";
-interface ReactCustomMessageRenderer {
-  agentId?: string;
-  render: React.ComponentType<{
-    message: Message;
-    position: ReactCustomMessageRendererPosition;
-    runId: string;
-    messageIndex: number;
-    messageIndexInRun: number;
-    numberOfMessagesInRun: number;
-    agentId: string;
-    stateSnapshot: any;
-  }> | null;
-}
+/**
+ * Props a React custom message renderer receives: the same as
+ * {@link CustomMessageRenderProps}, with `stateSnapshot` typed `any` so a
+ * component can read the agent state without a cast.
+ */
+type ReactCustomMessageRenderProps = Omit<CustomMessageRenderProps, "stateSnapshot"> & {
+  stateSnapshot: any;
+};
+/**
+ * A custom message renderer for React: a component that draws before or
+ * after each chat message. Return `null` from the component to draw nothing
+ * for a message. A `null` render is skipped.
+ */
+type ReactCustomMessageRenderer = CustomMessageRendererDef<React.ComponentType<ReactCustomMessageRenderProps> | null>;
 //#endregion
 //#region src/lib/react-core.d.ts
 interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {
@@ -100,7 +54,7 @@ interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {
   }) => void | Promise<void>;
   onInterruptElementChanged?: (event: {
     copilotkit: CopilotKitCore;
-    interruptElement: React$1.ReactElement | null;
+    interruptElement: React.ReactElement | null;
   }) => void | Promise<void>;
 }
 declare class CopilotKitCoreReact extends CopilotKitCore {
@@ -120,23 +74,9 @@ declare class CopilotKitCoreReact extends CopilotKitCore {
   addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void;
   removeHookRenderToolCall(name: string, agentId?: string): void;
   private _notifyRenderToolCallsChanged;
-  get interruptElement(): React$1.ReactElement | null;
-  setInterruptElement(element: React$1.ReactElement | null): void;
+  get interruptElement(): React.ReactElement | null;
+  setInterruptElement(element: React.ReactElement | null): void;
   subscribe(subscriber: CopilotKitCoreReactSubscriber): CopilotKitCoreSubscription;
-  /**
-   * Wait for pending React state updates before the follow-up agent run.
-   *
-   * When a frontend tool handler calls setState(), React 18 batches the update
-   * and schedules a commit via its internal scheduler (MessageChannel). The
-   * useAgentContext hook registers context via useLayoutEffect, which runs
-   * synchronously after React commits that batch.
-   *
-   * Awaiting a zero-delay timeout yields to the macrotask queue. React's
-   * MessageChannel task runs first, committing the pending state and running
-   * useLayoutEffect (which updates the context store). The follow-up runAgent
-   * call then reads fresh context.
-   */
-  waitForPendingFrameworkUpdates(): Promise<void>;
 }
 //#endregion
 //#region src/context.d.ts

package/dist/context.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.cts","names":[],"sources":["../src/types/react-tool-call-renderer.ts","../src/types/react-activity-message-renderer.ts","../src/types/react-custom-message-renderer.ts","../src/lib/react-core.ts","../src/context.ts"],"mappings":"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"}
+{"version":3,"file":"context.d.cts","names":[],"sources":["../src/types/react-tool-call-renderer.ts","../src/types/react-activity-message-renderer.ts","../src/types/react-custom-message-renderer.ts","../src/lib/react-core.ts","../src/context.ts"],"mappings":";;;;;;;;;;AAeA;;;;;KAAY,qBAAA,gBAAqC,mBAAA,CAC/C,CAAA,EACA,KAAA,CAAM,aAAA,CAAc,mBAAA,CAAoB,CAAA;;;;;;;AAF1C;;;KCFY,4BAAA,qBACV,0BAAA,CACE,gBAAA,EACA,KAAA,CAAM,aAAA,CAAc,0BAAA,CAA2B,gBAAA;;;;;ADDnD;;;KEAK,6BAAA,GAAgC,IAAA,CACnC,wBAAA;EAGA,aAAA;AAAA;;;;;;KAQU,0BAAA,GACV,wBAAA,CAAyB,KAAA,CAAM,aAAA,CAAc,6BAAA;;;UCf9B,yBAAA,SAAkC,oBAAA;EAEjD,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EAGzB,oBAAA,GAAuB,0BAAA;AAAA;AAAA,UAGR,6BAAA,SAAsC,wBAAA;EACrD,wBAAA,IAA4B,KAAA;IAC1B,UAAA,EAAY,cAAA;IACZ,eAAA,EAAiB,qBAAA;EAAA,aACN,OAAA;EACb,yBAAA,IAA6B,KAAA;IAC3B,UAAA,EAAY,cAAA;IACZ,gBAAA,EAAkB,KAAA,CAAM,YAAA;EAAA,aACb,OAAA;AAAA;AAAA,cAoBF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,oBAAA;EAAA,QAEA,4BAAA;EAAA,QAEA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAUhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAmBhC,yBAAA,CACE,SAAA,EAAW,4BAAA;EAKb,uBAAA,CAAwB,SAAA,EAAW,0BAAA;EAInC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAMpC,qBAAA,CAAsB,KAAA,EAAO,qBAAA;EAO7B,wBAAA,CAAyB,IAAA,UAAc,OAAA;EAAA,QAQ/B,6BAAA;EAAA,IAYJ,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA;;;UCnJY,sBAAA;EACf,UAAA,EAAY,mBAAA;EJGmB;;;;EIE/B,yBAAA;EJAA;;;;;EIMA,oBAAA,EAAsB,WAAA;AAAA;AAAA,cAGX,SAAA,EAAW,WAAA;AAAA,cAEX,iBAAA,EAAiB,KAAA,CAAA,OAAA,CAAA,sBAAA;AAAA,cAIjB,aAAA,QAAoB,sBAAA;AAAA,cA6BpB,cAAA,EAAc,KAAA,CAAA,OAAA,CAAA,mBAAA;AAAA,cAOd,iBAAA,QAAwB,mBAAA;AAAA,cAgBxB,wBAAA,EAEZ,KAAA,CAFoC,OAAA;AAAA,cAIxB,iBAAA"}

package/dist/context.d.mts

@@ -1,91 +1,45 @@
 import * as react from "react";
-import React$1 from "react";
-import { CopilotKitCore, CopilotKitCoreConfig, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, ToolCallStatus } from "@copilotkit/core";
-import { LicenseContextValue, StandardSchemaV1 } from "@copilotkit/shared";
-import { ActivityMessage, Message } from "@ag-ui/core";
-import { AbstractAgent } from "@ag-ui/client";
+import React from "react";
+import { ActivityMessageRenderProps, ActivityMessageRendererDef, CopilotKitCore, CopilotKitCoreConfig, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, CustomMessageRenderProps, CustomMessageRendererDef, ToolCallRenderProps, ToolCallRendererDef } from "@copilotkit/core";
+import { LicenseContextValue } from "@copilotkit/shared";
 
 //#region src/types/react-tool-call-renderer.d.ts
-interface ReactToolCallRenderer<T = unknown> {
-  name: string;
-  /**
-   * Schema describing the tool arguments. Optional — renderers registered for
-   * tools without parameters (e.g. HITL confirm dialogs) have no schema.
-   */
-  args?: StandardSchemaV1<any, T>;
-  /**
-   * Optional agent ID to constrain this tool renderer to a specific agent.
-   * If specified, this renderer will only be used for the specified agent.
-   */
-  agentId?: string;
-  /**
-   * Whether calls this renderer draws join the chat's tool-call groups (see
-   * `toolCallDisplay` on `CopilotChatMessageView`). CopilotKit's built-in card
-   * sets it; a renderer that leaves it unset always shows its calls on their
-   * own, since the chat can't tell what it draws (it may even draw nothing).
-   */
-  group?: boolean;
-  render: React.ComponentType<{
-    name: string;
-    toolCallId: string;
-    args: Partial<T>;
-    status: ToolCallStatus.InProgress;
-    result: undefined;
-  } | {
-    name: string;
-    toolCallId: string;
-    args: T;
-    status: ToolCallStatus.Executing;
-    result: undefined;
-  } | {
-    name: string;
-    toolCallId: string;
-    args: T;
-    status: ToolCallStatus.Complete;
-    result: string;
-  }>;
-}
+/**
+ * A tool call renderer for React: a React component that draws one tool call
+ * in the chat. The component receives {@link ToolCallRenderProps}.
+ *
+ * Pass a list of these to `renderToolCalls` on `CopilotKitProvider`, or build
+ * one with `defineToolCallRenderer`.
+ *
+ * @typeParam T - The shape of the tool arguments.
+ */
+type ReactToolCallRenderer<T = unknown> = ToolCallRendererDef<T, React.ComponentType<ToolCallRenderProps<T>>>;
 //#endregion
 //#region src/types/react-activity-message-renderer.d.ts
-interface ReactActivityMessageRenderer<TActivityContent> {
-  /**
-   * Activity type to match when rendering. Use "*" as a wildcard renderer.
-   */
-  activityType: string;
-  /**
-   * Optional agent ID to scope the renderer to a particular agent.
-   */
-  agentId?: string;
-  /**
-   * Schema describing the activity content payload.
-   */
-  content: StandardSchemaV1<any, TActivityContent>;
-  /**
-   * React component invoked to render the activity message.
-   */
-  render: React.ComponentType<{
-    activityType: string;
-    content: TActivityContent;
-    message: ActivityMessage;
-    agent: AbstractAgent | undefined;
-  }>;
-}
+/**
+ * An activity message renderer for React: a React component that draws
+ * activity messages of one `activityType` (or `"*"` for any type). The
+ * component receives {@link ActivityMessageRenderProps}.
+ *
+ * @typeParam TActivityContent - The shape of the activity content.
+ */
+type ReactActivityMessageRenderer<TActivityContent> = ActivityMessageRendererDef<TActivityContent, React.ComponentType<ActivityMessageRenderProps<TActivityContent>>>;
 //#endregion
 //#region src/types/react-custom-message-renderer.d.ts
-type ReactCustomMessageRendererPosition = "before" | "after";
-interface ReactCustomMessageRenderer {
-  agentId?: string;
-  render: React.ComponentType<{
-    message: Message;
-    position: ReactCustomMessageRendererPosition;
-    runId: string;
-    messageIndex: number;
-    messageIndexInRun: number;
-    numberOfMessagesInRun: number;
-    agentId: string;
-    stateSnapshot: any;
-  }> | null;
-}
+/**
+ * Props a React custom message renderer receives: the same as
+ * {@link CustomMessageRenderProps}, with `stateSnapshot` typed `any` so a
+ * component can read the agent state without a cast.
+ */
+type ReactCustomMessageRenderProps = Omit<CustomMessageRenderProps, "stateSnapshot"> & {
+  stateSnapshot: any;
+};
+/**
+ * A custom message renderer for React: a component that draws before or
+ * after each chat message. Return `null` from the component to draw nothing
+ * for a message. A `null` render is skipped.
+ */
+type ReactCustomMessageRenderer = CustomMessageRendererDef<React.ComponentType<ReactCustomMessageRenderProps> | null>;
 //#endregion
 //#region src/lib/react-core.d.ts
 interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {
@@ -100,7 +54,7 @@ interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {
   }) => void | Promise<void>;
   onInterruptElementChanged?: (event: {
     copilotkit: CopilotKitCore;
-    interruptElement: React$1.ReactElement | null;
+    interruptElement: React.ReactElement | null;
   }) => void | Promise<void>;
 }
 declare class CopilotKitCoreReact extends CopilotKitCore {
@@ -120,23 +74,9 @@ declare class CopilotKitCoreReact extends CopilotKitCore {
   addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void;
   removeHookRenderToolCall(name: string, agentId?: string): void;
   private _notifyRenderToolCallsChanged;
-  get interruptElement(): React$1.ReactElement | null;
-  setInterruptElement(element: React$1.ReactElement | null): void;
+  get interruptElement(): React.ReactElement | null;
+  setInterruptElement(element: React.ReactElement | null): void;
   subscribe(subscriber: CopilotKitCoreReactSubscriber): CopilotKitCoreSubscription;
-  /**
-   * Wait for pending React state updates before the follow-up agent run.
-   *
-   * When a frontend tool handler calls setState(), React 18 batches the update
-   * and schedules a commit via its internal scheduler (MessageChannel). The
-   * useAgentContext hook registers context via useLayoutEffect, which runs
-   * synchronously after React commits that batch.
-   *
-   * Awaiting a zero-delay timeout yields to the macrotask queue. React's
-   * MessageChannel task runs first, committing the pending state and running
-   * useLayoutEffect (which updates the context store). The follow-up runAgent
-   * call then reads fresh context.
-   */
-  waitForPendingFrameworkUpdates(): Promise<void>;
 }
 //#endregion
 //#region src/context.d.ts

package/dist/context.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.mts","names":[],"sources":["../src/types/react-tool-call-renderer.ts","../src/types/react-activity-message-renderer.ts","../src/types/react-custom-message-renderer.ts","../src/lib/react-core.ts","../src/context.ts"],"mappings":"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"}
+{"version":3,"file":"context.d.mts","names":[],"sources":["../src/types/react-tool-call-renderer.ts","../src/types/react-activity-message-renderer.ts","../src/types/react-custom-message-renderer.ts","../src/lib/react-core.ts","../src/context.ts"],"mappings":";;;;;;;;;;AAeA;;;;;KAAY,qBAAA,gBAAqC,mBAAA,CAC/C,CAAA,EACA,KAAA,CAAM,aAAA,CAAc,mBAAA,CAAoB,CAAA;;;;;;;AAF1C;;;KCFY,4BAAA,qBACV,0BAAA,CACE,gBAAA,EACA,KAAA,CAAM,aAAA,CAAc,0BAAA,CAA2B,gBAAA;;;;;ADDnD;;;KEAK,6BAAA,GAAgC,IAAA,CACnC,wBAAA;EAGA,aAAA;AAAA;;;;;;KAQU,0BAAA,GACV,wBAAA,CAAyB,KAAA,CAAM,aAAA,CAAc,6BAAA;;;UCf9B,yBAAA,SAAkC,oBAAA;EAEjD,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EAGzB,oBAAA,GAAuB,0BAAA;AAAA;AAAA,UAGR,6BAAA,SAAsC,wBAAA;EACrD,wBAAA,IAA4B,KAAA;IAC1B,UAAA,EAAY,cAAA;IACZ,eAAA,EAAiB,qBAAA;EAAA,aACN,OAAA;EACb,yBAAA,IAA6B,KAAA;IAC3B,UAAA,EAAY,cAAA;IACZ,gBAAA,EAAkB,KAAA,CAAM,YAAA;EAAA,aACb,OAAA;AAAA;AAAA,cAoBF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,oBAAA;EAAA,QAEA,4BAAA;EAAA,QAEA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAUhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAmBhC,yBAAA,CACE,SAAA,EAAW,4BAAA;EAKb,uBAAA,CAAwB,SAAA,EAAW,0BAAA;EAInC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAMpC,qBAAA,CAAsB,KAAA,EAAO,qBAAA;EAO7B,wBAAA,CAAyB,IAAA,UAAc,OAAA;EAAA,QAQ/B,6BAAA;EAAA,IAYJ,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA;;;UCnJY,sBAAA;EACf,UAAA,EAAY,mBAAA;EJGmB;;;;EIE/B,yBAAA;EJAA;;;;;EIMA,oBAAA,EAAsB,WAAA;AAAA;AAAA,cAGX,SAAA,EAAW,WAAA;AAAA,cAEX,iBAAA,EAAiB,KAAA,CAAA,OAAA,CAAA,sBAAA;AAAA,cAIjB,aAAA,QAAoB,sBAAA;AAAA,cA6BpB,cAAA,EAAc,KAAA,CAAA,OAAA,CAAA,mBAAA;AAAA,cAOd,iBAAA,QAAwB,mBAAA;AAAA,cAgBxB,wBAAA,EAEZ,KAAA,CAFoC,OAAA;AAAA,cAIxB,iBAAA"}

package/dist/context.mjs

@@ -4,9 +4,28 @@ import { createContext, useContext, useEffect, useReducer } from "react";
 import { CopilotKitCore } from "@copilotkit/core";
 
 //#region src/lib/react-core.ts
+/**
+* Wait for pending React state updates before the follow-up agent run.
+*
+* When a frontend tool handler calls setState(), React 18 batches the update
+* and schedules a commit via its internal scheduler (MessageChannel). The
+* useAgentContext hook registers context via useLayoutEffect, which runs
+* synchronously after React commits that batch.
+*
+* Awaiting a zero-delay timeout yields to the macrotask queue. React's
+* MessageChannel task runs first, committing the pending state and running
+* useLayoutEffect (which updates the context store). The follow-up runAgent
+* call then reads fresh context.
+*/
+function waitForReactCommit() {
+	return new Promise((resolve) => setTimeout(resolve, 0));
+}
 var CopilotKitCoreReact = class extends CopilotKitCore {
 	constructor(config) {
-		super(config);
+		super({
+			...config,
+			ɵwaitForFrameworkUpdates: waitForReactCommit
+		});
 		this._renderToolCalls = [];
 		this._hookRenderToolCalls = /* @__PURE__ */ new Map();
 		this._cachedMergedRenderToolCalls = null;
@@ -80,22 +99,6 @@ var CopilotKitCoreReact = class extends CopilotKitCore {
 	subscribe(subscriber) {
 		return super.subscribe(subscriber);
 	}
-	/**
-	* Wait for pending React state updates before the follow-up agent run.
-	*
-	* When a frontend tool handler calls setState(), React 18 batches the update
-	* and schedules a commit via its internal scheduler (MessageChannel). The
-	* useAgentContext hook registers context via useLayoutEffect, which runs
-	* synchronously after React commits that batch.
-	*
-	* Awaiting a zero-delay timeout yields to the macrotask queue. React's
-	* MessageChannel task runs first, committing the pending state and running
-	* useLayoutEffect (which updates the context store). The follow-up runAgent
-	* call then reads fresh context.
-	*/
-	async waitForPendingFrameworkUpdates() {
-		await new Promise((resolve) => setTimeout(resolve, 0));
-	}
 };
 
 //#endregion

package/dist/context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.mjs","names":[],"sources":["../src/lib/react-core.ts","../src/context.ts"],"sourcesContent":["import React from \"react\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\nimport { CopilotKitCore } from \"@copilotkit/core\";\nimport type {\n  CopilotKitCoreConfig,\n  CopilotKitCoreSubscriber,\n  CopilotKitCoreSubscription,\n} from \"@copilotkit/core\";\n\nexport interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {\n  // Add any additional configuration properties specific to the React implementation\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n\n  // Add custom message renderers\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n}\n\nexport interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {\n  onRenderToolCallsChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    renderToolCalls: ReactToolCallRenderer<any>[];\n  }) => void | Promise<void>;\n  onInterruptElementChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    interruptElement: React.ReactElement | null;\n  }) => void | Promise<void>;\n}\n\nexport class CopilotKitCoreReact extends CopilotKitCore {\n  private _renderToolCalls: ReactToolCallRenderer<any>[] = [];\n  private _hookRenderToolCalls: Map<string, ReactToolCallRenderer<any>> =\n    new Map();\n  private _cachedMergedRenderToolCalls: ReactToolCallRenderer<any>[] | null =\n    null;\n  private _renderCustomMessages: ReactCustomMessageRenderer[] = [];\n  private _renderActivityMessages: ReactActivityMessageRenderer<any>[] = [];\n  private _interruptElement: React.ReactElement | null = null;\n\n  constructor(config: CopilotKitCoreReactConfig) {\n    super(config);\n    this._renderToolCalls = config.renderToolCalls ?? [];\n    this._renderCustomMessages = config.renderCustomMessages ?? [];\n    this._renderActivityMessages = config.renderActivityMessages ?? [];\n  }\n\n  get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]> {\n    return this._renderCustomMessages;\n  }\n\n  get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[] {\n    return this._renderActivityMessages;\n  }\n\n  get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[] {\n    if (this._hookRenderToolCalls.size === 0) {\n      return this._renderToolCalls;\n    }\n    if (this._cachedMergedRenderToolCalls) {\n      return this._cachedMergedRenderToolCalls;\n    }\n    // Merge: hook entries override prop entries with the same key\n    const merged = new Map<string, ReactToolCallRenderer<any>>();\n    for (const rc of this._renderToolCalls) {\n      merged.set(`${rc.agentId ?? \"\"}:${rc.name}`, rc);\n    }\n    for (const [key, rc] of this._hookRenderToolCalls) {\n      merged.set(key, rc);\n    }\n    this._cachedMergedRenderToolCalls = Array.from(merged.values());\n    return this._cachedMergedRenderToolCalls;\n  }\n\n  setRenderActivityMessages(\n    renderers: ReactActivityMessageRenderer<any>[],\n  ): void {\n    this._renderActivityMessages = renderers;\n  }\n\n  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void {\n    this._renderCustomMessages = renderers;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void {\n    const key = `${entry.agentId ?? \"\"}:${entry.name}`;\n    this._hookRenderToolCalls.set(key, entry);\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  removeHookRenderToolCall(name: string, agentId?: string): void {\n    const key = `${agentId ?? \"\"}:${name}`;\n    if (this._hookRenderToolCalls.delete(key)) {\n      this._cachedMergedRenderToolCalls = null;\n      this._notifyRenderToolCallsChanged();\n    }\n  }\n\n  private _notifyRenderToolCallsChanged(): void {\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      if (reactSubscriber.onRenderToolCallsChanged) {\n        reactSubscriber.onRenderToolCallsChanged({\n          copilotkit: this,\n          renderToolCalls: this.renderToolCalls,\n        });\n      }\n    }, \"Subscriber onRenderToolCallsChanged error:\");\n  }\n\n  get interruptElement(): React.ReactElement | null {\n    return this._interruptElement;\n  }\n\n  setInterruptElement(element: React.ReactElement | null): void {\n    this._interruptElement = element;\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      reactSubscriber.onInterruptElementChanged?.({\n        copilotkit: this,\n        interruptElement: this._interruptElement,\n      });\n    }, \"Subscriber onInterruptElementChanged error:\");\n  }\n\n  // Override to accept React-specific subscriber type\n  subscribe(\n    subscriber: CopilotKitCoreReactSubscriber,\n  ): CopilotKitCoreSubscription {\n    return super.subscribe(subscriber);\n  }\n\n  /**\n   * Wait for pending React state updates before the follow-up agent run.\n   *\n   * When a frontend tool handler calls setState(), React 18 batches the update\n   * and schedules a commit via its internal scheduler (MessageChannel). The\n   * useAgentContext hook registers context via useLayoutEffect, which runs\n   * synchronously after React commits that batch.\n   *\n   * Awaiting a zero-delay timeout yields to the macrotask queue. React's\n   * MessageChannel task runs first, committing the pending state and running\n   * useLayoutEffect (which updates the context store). The follow-up runAgent\n   * call then reads fresh context.\n   */\n  async waitForPendingFrameworkUpdates(): Promise<void> {\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n  }\n}\n","\"use client\";\n\nimport { createContext, useContext, useEffect, useReducer } from \"react\";\nimport { CopilotKitCoreReact } from \"./lib/react-core\";\nimport type { CopilotKitCoreReactConfig } from \"./lib/react-core\";\nimport type { LicenseContextValue } from \"@copilotkit/shared\";\n\n// Re-export so headless.ts (and consumers) reference the same type declaration.\nexport { CopilotKitCoreReact };\nexport type { CopilotKitCoreReactConfig };\n\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\n  /**\n   * Whether CopilotKit should automatically mount Intelligence indicators.\n   * Defaults to true when omitted for compatibility with custom providers.\n   */\n  showIntelligenceIndicator?: boolean;\n  /**\n   * Set of tool call IDs currently being executed.\n   * This is tracked at the provider level to ensure tool execution events\n   * are captured even before child components mount.\n   */\n  executingToolCallIds: ReadonlySet<string>;\n}\n\nexport const EMPTY_SET: ReadonlySet<string> = new Set();\n\nexport const CopilotKitContext = createContext<CopilotKitContextValue | null>(\n  null,\n);\n\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0);\n\n  if (!context) {\n    throw new Error(\"useCopilotKit must be used within CopilotKitProvider\");\n  }\n  useEffect(() => {\n    const subscription = context.copilotkit.subscribe({\n      onRuntimeConnectionStatusChanged: () => {\n        forceUpdate();\n      },\n      onHeadersChanged: () => {\n        forceUpdate();\n      },\n    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n\n// License context — shared between web and RN providers.\n// Default is permissive (all features allowed) — providers override via createLicenseContextValue.\n// Inlined here to avoid a runtime import from @copilotkit/shared, which pulls in\n// Node-only deps (jose) that break React Native's Metro bundler.\nexport const LicenseContext = createContext<LicenseContextValue>({\n  status: null,\n  license: null,\n  checkFeature: () => true,\n  getLimit: () => null,\n} as LicenseContextValue);\n\nexport const useLicenseContext = (): LicenseContextValue =>\n  useContext(LicenseContext);\n\n// Provider-level default agent id, published by `<CopilotKitProvider agentId>`.\n//\n// This is a context of its own rather than a `CopilotChatConfigurationProvider`\n// rendered at the root, because that provider also owns a thread: it resolves a\n// threadId (minting a UUID when none is given) and the top-most one owns the\n// imperative active-thread override. Rendering it around the whole application\n// would hand every `<CopilotChat>` the same inherited threadId, so two sibling\n// chats would share one transcript. A bare string context carries the agent\n// default and nothing else.\n//\n// It is the LAST fallback before `DEFAULT_AGENT_ID`, so an explicit `agentId`\n// argument, a `<CopilotChat agentId>`, and a `<CopilotChatConfigurationProvider\n// agentId>` all still win.\nexport const CopilotKitAgentIdContext = createContext<string | undefined>(\n  undefined,\n);\n\nexport const useDefaultAgentId = (): string | undefined =>\n  useContext(CopilotKitAgentIdContext);\n"],"mappings":"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"}
+{"version":3,"file":"context.mjs","names":[],"sources":["../src/lib/react-core.ts","../src/context.ts"],"sourcesContent":["import React from \"react\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\nimport { CopilotKitCore } from \"@copilotkit/core\";\nimport type {\n  CopilotKitCoreConfig,\n  CopilotKitCoreSubscriber,\n  CopilotKitCoreSubscription,\n} from \"@copilotkit/core\";\n\nexport interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {\n  // Add any additional configuration properties specific to the React implementation\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n\n  // Add custom message renderers\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n}\n\nexport interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {\n  onRenderToolCallsChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    renderToolCalls: ReactToolCallRenderer<any>[];\n  }) => void | Promise<void>;\n  onInterruptElementChanged?: (event: {\n    copilotkit: CopilotKitCore;\n    interruptElement: React.ReactElement | null;\n  }) => void | Promise<void>;\n}\n\n/**\n * Wait for pending React state updates before the follow-up agent run.\n *\n * When a frontend tool handler calls setState(), React 18 batches the update\n * and schedules a commit via its internal scheduler (MessageChannel). The\n * useAgentContext hook registers context via useLayoutEffect, which runs\n * synchronously after React commits that batch.\n *\n * Awaiting a zero-delay timeout yields to the macrotask queue. React's\n * MessageChannel task runs first, committing the pending state and running\n * useLayoutEffect (which updates the context store). The follow-up runAgent\n * call then reads fresh context.\n */\nfunction waitForReactCommit() {\n  return new Promise<void>((resolve) => setTimeout(resolve, 0));\n}\n\nexport class CopilotKitCoreReact extends CopilotKitCore {\n  private _renderToolCalls: ReactToolCallRenderer<any>[] = [];\n  private _hookRenderToolCalls: Map<string, ReactToolCallRenderer<any>> =\n    new Map();\n  private _cachedMergedRenderToolCalls: ReactToolCallRenderer<any>[] | null =\n    null;\n  private _renderCustomMessages: ReactCustomMessageRenderer[] = [];\n  private _renderActivityMessages: ReactActivityMessageRenderer<any>[] = [];\n  private _interruptElement: React.ReactElement | null = null;\n\n  constructor(config: CopilotKitCoreReactConfig) {\n    super({\n      ...config,\n      ɵwaitForFrameworkUpdates: waitForReactCommit,\n    });\n    this._renderToolCalls = config.renderToolCalls ?? [];\n    this._renderCustomMessages = config.renderCustomMessages ?? [];\n    this._renderActivityMessages = config.renderActivityMessages ?? [];\n  }\n\n  get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]> {\n    return this._renderCustomMessages;\n  }\n\n  get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[] {\n    return this._renderActivityMessages;\n  }\n\n  get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[] {\n    if (this._hookRenderToolCalls.size === 0) {\n      return this._renderToolCalls;\n    }\n    if (this._cachedMergedRenderToolCalls) {\n      return this._cachedMergedRenderToolCalls;\n    }\n    // Merge: hook entries override prop entries with the same key\n    const merged = new Map<string, ReactToolCallRenderer<any>>();\n    for (const rc of this._renderToolCalls) {\n      merged.set(`${rc.agentId ?? \"\"}:${rc.name}`, rc);\n    }\n    for (const [key, rc] of this._hookRenderToolCalls) {\n      merged.set(key, rc);\n    }\n    this._cachedMergedRenderToolCalls = Array.from(merged.values());\n    return this._cachedMergedRenderToolCalls;\n  }\n\n  setRenderActivityMessages(\n    renderers: ReactActivityMessageRenderer<any>[],\n  ): void {\n    this._renderActivityMessages = renderers;\n  }\n\n  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void {\n    this._renderCustomMessages = renderers;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void {\n    const key = `${entry.agentId ?? \"\"}:${entry.name}`;\n    this._hookRenderToolCalls.set(key, entry);\n    this._cachedMergedRenderToolCalls = null;\n    this._notifyRenderToolCallsChanged();\n  }\n\n  removeHookRenderToolCall(name: string, agentId?: string): void {\n    const key = `${agentId ?? \"\"}:${name}`;\n    if (this._hookRenderToolCalls.delete(key)) {\n      this._cachedMergedRenderToolCalls = null;\n      this._notifyRenderToolCallsChanged();\n    }\n  }\n\n  private _notifyRenderToolCallsChanged(): void {\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      if (reactSubscriber.onRenderToolCallsChanged) {\n        reactSubscriber.onRenderToolCallsChanged({\n          copilotkit: this,\n          renderToolCalls: this.renderToolCalls,\n        });\n      }\n    }, \"Subscriber onRenderToolCallsChanged error:\");\n  }\n\n  get interruptElement(): React.ReactElement | null {\n    return this._interruptElement;\n  }\n\n  setInterruptElement(element: React.ReactElement | null): void {\n    this._interruptElement = element;\n    void this.notifySubscribers((subscriber) => {\n      const reactSubscriber = subscriber as CopilotKitCoreReactSubscriber;\n      reactSubscriber.onInterruptElementChanged?.({\n        copilotkit: this,\n        interruptElement: this._interruptElement,\n      });\n    }, \"Subscriber onInterruptElementChanged error:\");\n  }\n\n  // Override to accept React-specific subscriber type\n  subscribe(\n    subscriber: CopilotKitCoreReactSubscriber,\n  ): CopilotKitCoreSubscription {\n    return super.subscribe(subscriber);\n  }\n}\n","\"use client\";\n\nimport { createContext, useContext, useEffect, useReducer } from \"react\";\nimport { CopilotKitCoreReact } from \"./lib/react-core\";\nimport type { CopilotKitCoreReactConfig } from \"./lib/react-core\";\nimport type { LicenseContextValue } from \"@copilotkit/shared\";\n\n// Re-export so headless.ts (and consumers) reference the same type declaration.\nexport { CopilotKitCoreReact };\nexport type { CopilotKitCoreReactConfig };\n\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\n  /**\n   * Whether CopilotKit should automatically mount Intelligence indicators.\n   * Defaults to true when omitted for compatibility with custom providers.\n   */\n  showIntelligenceIndicator?: boolean;\n  /**\n   * Set of tool call IDs currently being executed.\n   * This is tracked at the provider level to ensure tool execution events\n   * are captured even before child components mount.\n   */\n  executingToolCallIds: ReadonlySet<string>;\n}\n\nexport const EMPTY_SET: ReadonlySet<string> = new Set();\n\nexport const CopilotKitContext = createContext<CopilotKitContextValue | null>(\n  null,\n);\n\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0);\n\n  if (!context) {\n    throw new Error(\"useCopilotKit must be used within CopilotKitProvider\");\n  }\n  useEffect(() => {\n    const subscription = context.copilotkit.subscribe({\n      onRuntimeConnectionStatusChanged: () => {\n        forceUpdate();\n      },\n      onHeadersChanged: () => {\n        forceUpdate();\n      },\n    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n\n// License context — shared between web and RN providers.\n// Default is permissive (all features allowed) — providers override via createLicenseContextValue.\n// Inlined here to avoid a runtime import from @copilotkit/shared, which pulls in\n// Node-only deps (jose) that break React Native's Metro bundler.\nexport const LicenseContext = createContext<LicenseContextValue>({\n  status: null,\n  license: null,\n  checkFeature: () => true,\n  getLimit: () => null,\n} as LicenseContextValue);\n\nexport const useLicenseContext = (): LicenseContextValue =>\n  useContext(LicenseContext);\n\n// Provider-level default agent id, published by `<CopilotKitProvider agentId>`.\n//\n// This is a context of its own rather than a `CopilotChatConfigurationProvider`\n// rendered at the root, because that provider also owns a thread: it resolves a\n// threadId (minting a UUID when none is given) and the top-most one owns the\n// imperative active-thread override. Rendering it around the whole application\n// would hand every `<CopilotChat>` the same inherited threadId, so two sibling\n// chats would share one transcript. A bare string context carries the agent\n// default and nothing else.\n//\n// It is the LAST fallback before `DEFAULT_AGENT_ID`, so an explicit `agentId`\n// argument, a `<CopilotChat agentId>`, and a `<CopilotChatConfigurationProvider\n// agentId>` all still win.\nexport const CopilotKitAgentIdContext = createContext<string | undefined>(\n  undefined,\n);\n\nexport const useDefaultAgentId = (): string | undefined =>\n  useContext(CopilotKitAgentIdContext);\n"],"mappings":"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"}