@copilotkitnext/react 1.52.2-next.2 → 1.52.2-next.4

package/dist/lib/react-core.cjs

@@ -22,6 +22,12 @@ var CopilotKitCoreReact = class extends _copilotkitnext_core.CopilotKitCore {
 	get renderToolCalls() {
 		return this._renderToolCalls;
 	}
+	setRenderActivityMessages(renderers) {
+		this._renderActivityMessages = renderers;
+	}
+	setRenderCustomMessages(renderers) {
+		this._renderCustomMessages = renderers;
+	}
 	setRenderToolCalls(renderToolCalls) {
 		this._renderToolCalls = renderToolCalls;
 		this.notifySubscribers((subscriber) => {

package/dist/lib/react-core.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-core.cjs","names":["CopilotKitCore"],"sources":["../../src/lib/react-core.ts"],"sourcesContent":["import React from \"react\";\nimport { ReactActivityMessageRenderer, ReactToolCallRenderer } from \"@/types\";\nimport { ReactCustomMessageRenderer } from \"@/types/react-custom-message-renderer\";\nimport {\n  CopilotKitCore,\n  type CopilotKitCoreConfig,\n  type CopilotKitCoreSubscriber,\n  type CopilotKitCoreSubscription,\n} from \"@copilotkitnext/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 _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    return this._renderToolCalls;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n\n    // Notify React-specific subscribers\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"],"mappings":";;;;AA8BA,IAAa,sBAAb,cAAyCA,oCAAe;CACtD,AAAQ,mBAAiD,EAAE;CAC3D,AAAQ,wBAAsD,EAAE;CAChE,AAAQ,0BAA+D,EAAE;CACzE,AAAQ,oBAA+C;CAEvD,YAAY,QAAmC;AAC7C,QAAM,OAAO;AACb,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,SAAO,KAAK;;CAGd,mBAAmB,iBAAqD;AACtE,OAAK,mBAAmB;AAGxB,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"}
+{"version":3,"file":"react-core.cjs","names":["CopilotKitCore"],"sources":["../../src/lib/react-core.ts"],"sourcesContent":["import React from \"react\";\nimport { ReactActivityMessageRenderer, ReactToolCallRenderer } from \"@/types\";\nimport { ReactCustomMessageRenderer } from \"@/types/react-custom-message-renderer\";\nimport {\n  CopilotKitCore,\n  type CopilotKitCoreConfig,\n  type CopilotKitCoreSubscriber,\n  type CopilotKitCoreSubscription,\n} from \"@copilotkitnext/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 _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    return this._renderToolCalls;\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\n    // Notify React-specific subscribers\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"],"mappings":";;;;AA8BA,IAAa,sBAAb,cAAyCA,oCAAe;CACtD,AAAQ,mBAAiD,EAAE;CAC3D,AAAQ,wBAAsD,EAAE;CAChE,AAAQ,0BAA+D,EAAE;CACzE,AAAQ,oBAA+C;CAEvD,YAAY,QAAmC;AAC7C,QAAM,OAAO;AACb,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,SAAO,KAAK;;CAGd,0BACE,WACM;AACN,OAAK,0BAA0B;;CAGjC,wBAAwB,WAA+C;AACrE,OAAK,wBAAwB;;CAG/B,mBAAmB,iBAAqD;AACtE,OAAK,mBAAmB;AAGxB,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"}

package/dist/lib/react-core.d.cts

@@ -30,6 +30,8 @@ declare class CopilotKitCoreReact extends CopilotKitCore {
   get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]>;
   get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[];
   get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[];
+  setRenderActivityMessages(renderers: ReactActivityMessageRenderer<any>[]): void;
+  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void;
   setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void;
   get interruptElement(): React.ReactElement | null;
   setInterruptElement(element: React.ReactElement | null): void;

package/dist/lib/react-core.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"react-core.d.cts","names":[],"sources":["../../src/lib/react-core.ts"],"mappings":";;;;;;;;UAUiB,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,cAGF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAOhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAIhC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAAA,IAehC,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA"}
+{"version":3,"file":"react-core.d.cts","names":[],"sources":["../../src/lib/react-core.ts"],"mappings":";;;;;;;;UAUiB,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,cAGF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAOhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAIhC,yBAAA,CACE,SAAA,EAAW,4BAAA;EAKb,uBAAA,CAAwB,SAAA,EAAW,0BAAA;EAInC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAAA,IAehC,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA"}

package/dist/lib/react-core.d.mts

@@ -30,6 +30,8 @@ declare class CopilotKitCoreReact extends CopilotKitCore {
   get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]>;
   get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[];
   get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[];
+  setRenderActivityMessages(renderers: ReactActivityMessageRenderer<any>[]): void;
+  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void;
   setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void;
   get interruptElement(): React.ReactElement | null;
   setInterruptElement(element: React.ReactElement | null): void;

package/dist/lib/react-core.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react-core.d.mts","names":[],"sources":["../../src/lib/react-core.ts"],"mappings":";;;;;;;;UAUiB,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,cAGF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAOhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAIhC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAAA,IAehC,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA"}
+{"version":3,"file":"react-core.d.mts","names":[],"sources":["../../src/lib/react-core.ts"],"mappings":";;;;;;;;UAUiB,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,cAGF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAOhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAIhC,yBAAA,CACE,SAAA,EAAW,4BAAA;EAKb,uBAAA,CAAwB,SAAA,EAAW,0BAAA;EAInC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAAA,IAehC,gBAAA,CAAA,GAAoB,KAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,KAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;AAAA"}

package/dist/lib/react-core.mjs

@@ -21,6 +21,12 @@ var CopilotKitCoreReact = class extends CopilotKitCore {
 	get renderToolCalls() {
 		return this._renderToolCalls;
 	}
+	setRenderActivityMessages(renderers) {
+		this._renderActivityMessages = renderers;
+	}
+	setRenderCustomMessages(renderers) {
+		this._renderCustomMessages = renderers;
+	}
 	setRenderToolCalls(renderToolCalls) {
 		this._renderToolCalls = renderToolCalls;
 		this.notifySubscribers((subscriber) => {

package/dist/lib/react-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-core.mjs","names":[],"sources":["../../src/lib/react-core.ts"],"sourcesContent":["import React from \"react\";\nimport { ReactActivityMessageRenderer, ReactToolCallRenderer } from \"@/types\";\nimport { ReactCustomMessageRenderer } from \"@/types/react-custom-message-renderer\";\nimport {\n  CopilotKitCore,\n  type CopilotKitCoreConfig,\n  type CopilotKitCoreSubscriber,\n  type CopilotKitCoreSubscription,\n} from \"@copilotkitnext/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 _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    return this._renderToolCalls;\n  }\n\n  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void {\n    this._renderToolCalls = renderToolCalls;\n\n    // Notify React-specific subscribers\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"],"mappings":";;;AA8BA,IAAa,sBAAb,cAAyC,eAAe;CACtD,AAAQ,mBAAiD,EAAE;CAC3D,AAAQ,wBAAsD,EAAE;CAChE,AAAQ,0BAA+D,EAAE;CACzE,AAAQ,oBAA+C;CAEvD,YAAY,QAAmC;AAC7C,QAAM,OAAO;AACb,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,SAAO,KAAK;;CAGd,mBAAmB,iBAAqD;AACtE,OAAK,mBAAmB;AAGxB,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"}
+{"version":3,"file":"react-core.mjs","names":[],"sources":["../../src/lib/react-core.ts"],"sourcesContent":["import React from \"react\";\nimport { ReactActivityMessageRenderer, ReactToolCallRenderer } from \"@/types\";\nimport { ReactCustomMessageRenderer } from \"@/types/react-custom-message-renderer\";\nimport {\n  CopilotKitCore,\n  type CopilotKitCoreConfig,\n  type CopilotKitCoreSubscriber,\n  type CopilotKitCoreSubscription,\n} from \"@copilotkitnext/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 _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    return this._renderToolCalls;\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\n    // Notify React-specific subscribers\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"],"mappings":";;;AA8BA,IAAa,sBAAb,cAAyC,eAAe;CACtD,AAAQ,mBAAiD,EAAE;CAC3D,AAAQ,wBAAsD,EAAE;CAChE,AAAQ,0BAA+D,EAAE;CACzE,AAAQ,oBAA+C;CAEvD,YAAY,QAAmC;AAC7C,QAAM,OAAO;AACb,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,SAAO,KAAK;;CAGd,0BACE,WACM;AACN,OAAK,0BAA0B;;CAGjC,wBAAwB,WAA+C;AACrE,OAAK,wBAAwB;;CAG/B,mBAAmB,iBAAqD;AACtE,OAAK,mBAAmB;AAGxB,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"}

package/dist/providers/CopilotKitProvider.cjs

@@ -24,7 +24,7 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	}, [value, warningMessage]);
 	return value;
 }
-const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, publicApiKey, publicLicenseKey, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, showDevConsole = false, useSingleEndpoint = false }) => {
+const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, publicApiKey, publicLicenseKey, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, showDevConsole = false, useSingleEndpoint = false, onError }) => {
 	const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 	(0, react.useEffect)(() => {
 		if (typeof window === "undefined") return;
@@ -129,26 +129,20 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		frontendToolsList,
 		processedHumanInTheLoopTools
 	]);
-	const copilotkit = (0, react.useMemo)(() => {
-		return new require_react_core.CopilotKitCoreReact({
-			runtimeUrl: chatApiEndpoint,
-			runtimeTransport: useSingleEndpoint ? "single" : "rest",
-			headers: mergedHeaders,
-			credentials,
-			properties,
-			agents__unsafe_dev_only: mergedAgents,
-			tools: allTools,
-			renderToolCalls: allRenderToolCalls,
-			renderActivityMessages: allActivityRenderers,
-			renderCustomMessages: renderCustomMessagesList
-		});
-	}, [
-		allTools,
-		allRenderToolCalls,
-		allActivityRenderers,
-		renderCustomMessagesList,
-		useSingleEndpoint
-	]);
+	const copilotkitRef = (0, react.useRef)(null);
+	if (copilotkitRef.current === null) copilotkitRef.current = new require_react_core.CopilotKitCoreReact({
+		runtimeUrl: chatApiEndpoint,
+		runtimeTransport: useSingleEndpoint ? "single" : "rest",
+		headers: mergedHeaders,
+		credentials,
+		properties,
+		agents__unsafe_dev_only: mergedAgents,
+		tools: allTools,
+		renderToolCalls: allRenderToolCalls,
+		renderActivityMessages: allActivityRenderers,
+		renderCustomMessages: renderCustomMessagesList
+	});
+	const copilotkit = copilotkitRef.current;
 	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 	(0, react.useEffect)(() => {
 		const subscription = copilotkit.subscribe({ onRenderToolCallsChanged: () => {
@@ -182,6 +176,23 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 			subscription.unsubscribe();
 		};
 	}, [copilotkit]);
+	const onErrorRef = (0, react.useRef)(onError);
+	(0, react.useEffect)(() => {
+		onErrorRef.current = onError;
+	}, [onError]);
+	(0, react.useEffect)(() => {
+		if (!onErrorRef.current) return;
+		const subscription = copilotkit.subscribe({ onError: (event) => {
+			onErrorRef.current?.({
+				error: event.error,
+				code: event.code,
+				context: event.context
+			});
+		} });
+		return () => {
+			subscription.unsubscribe();
+		};
+	}, [copilotkit]);
 	(0, react.useEffect)(() => {
 		copilotkit.setRuntimeUrl(chatApiEndpoint);
 		copilotkit.setRuntimeTransport(useSingleEndpoint ? "single" : "rest");
@@ -190,6 +201,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		copilotkit.setProperties(properties);
 		copilotkit.setAgents__unsafe_dev_only(mergedAgents);
 	}, [
+		copilotkit,
 		chatApiEndpoint,
 		mergedHeaders,
 		credentials,
@@ -197,11 +209,32 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		mergedAgents,
 		useSingleEndpoint
 	]);
+	const didMountRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setTools(allTools);
+	}, [copilotkit, allTools]);
+	(0, react.useEffect)(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderToolCalls(allRenderToolCalls);
+	}, [copilotkit, allRenderToolCalls]);
+	(0, react.useEffect)(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderActivityMessages(allActivityRenderers);
+	}, [copilotkit, allActivityRenderers]);
+	(0, react.useEffect)(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderCustomMessages(renderCustomMessagesList);
+	}, [copilotkit, renderCustomMessagesList]);
+	(0, react.useEffect)(() => {
+		didMountRef.current = true;
+	}, []);
+	const contextValue = (0, react.useMemo)(() => ({
+		copilotkit,
+		executingToolCallIds
+	}), [copilotkit, executingToolCallIds]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CopilotKitContext.Provider, {
-		value: {
-			copilotkit,
-			executingToolCallIds
-		},
+		value: contextValue,
 		children: [children, shouldRenderInspector ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_CopilotKitInspector.CopilotKitInspector, { core: copilotkit }) : null]
 	});
 };

package/dist/providers/CopilotKitProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotKitProvider.cjs","names":["MCPAppsActivityType","MCPAppsActivityContentSchema","MCPAppsActivityRenderer","z","CopilotKitCoreReact","CopilotKitInspector"],"sources":["../../src/providers/CopilotKitProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { AbstractAgent } from \"@ag-ui/client\";\nimport type { FrontendTool } from \"@copilotkitnext/core\";\nimport type React from \"react\";\nimport {\n  createContext,\n  useContext,\n  type ReactNode,\n  useMemo,\n  useEffect,\n  useReducer,\n  useRef,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport { CopilotKitInspector } from \"../components/CopilotKitInspector\";\nimport {\n  MCPAppsActivityContentSchema,\n  MCPAppsActivityRenderer,\n  MCPAppsActivityType,\n} from \"../components/MCPAppsActivityRenderer\";\nimport { CopilotKitCoreReact } from \"../lib/react-core\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactFrontendTool } from \"../types/frontend-tool\";\nimport type { ReactHumanInTheLoop } from \"../types/human-in-the-loop\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\n\nconst HEADER_NAME = \"X-CopilotCloud-Public-Api-Key\";\nconst COPILOT_CLOUD_CHAT_URL = \"https://api.cloud.copilotkit.ai/copilotkit/v1\";\n\n// Define the context value interface - idiomatic React naming\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\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\n// Empty set for default context value\nconst EMPTY_SET: ReadonlySet<string> = new Set();\n\n// Create the CopilotKit context\nconst CopilotKitContext = createContext<CopilotKitContextValue>({\n  copilotkit: null!,\n  executingToolCallIds: EMPTY_SET,\n});\n\n// Provider props interface\nexport interface CopilotKitProviderProps {\n  children: ReactNode;\n  runtimeUrl?: string;\n  headers?: Record<string, string>;\n  /**\n   * Credentials mode for fetch requests (e.g., \"include\" for HTTP-only cookies in cross-origin requests).\n   */\n  credentials?: RequestCredentials;\n  /**\n   * The Copilot Cloud public API key.\n   */\n  publicApiKey?: string;\n  /**\n   * Alias for `publicApiKey`\n   **/\n  publicLicenseKey?: string;\n  properties?: Record<string, unknown>;\n  useSingleEndpoint?: boolean;\n  agents__unsafe_dev_only?: Record<string, AbstractAgent>;\n  selfManagedAgents?: Record<string, AbstractAgent>;\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n  frontendTools?: ReactFrontendTool[];\n  humanInTheLoop?: ReactHumanInTheLoop[];\n  showDevConsole?: boolean | \"auto\";\n}\n\n// Small helper to normalize array props to a stable reference and warn\nfunction useStableArrayProp<T>(\n  prop: T[] | undefined,\n  warningMessage?: string,\n  isMeaningfulChange?: (initial: T[], next: T[]) => boolean,\n): T[] {\n  const empty = useMemo<T[]>(() => [], []);\n  const value = prop ?? empty;\n  const initial = useRef(value);\n\n  useEffect(() => {\n    if (\n      warningMessage &&\n      value !== initial.current &&\n      (isMeaningfulChange ? isMeaningfulChange(initial.current, value) : true)\n    ) {\n      console.error(warningMessage);\n    }\n  }, [value, warningMessage]);\n\n  return value;\n}\n\n// Provider component\nexport const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({\n  children,\n  runtimeUrl,\n  headers = {},\n  credentials,\n  publicApiKey,\n  publicLicenseKey,\n  properties = {},\n  agents__unsafe_dev_only: agents = {},\n  selfManagedAgents = {},\n  renderToolCalls,\n  renderActivityMessages,\n  renderCustomMessages,\n  frontendTools,\n  humanInTheLoop,\n  showDevConsole = false,\n  useSingleEndpoint = false,\n}) => {\n  const [shouldRenderInspector, setShouldRenderInspector] = useState(false);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    if (showDevConsole === true) {\n      // Explicitly show the inspector\n      setShouldRenderInspector(true);\n    } else if (showDevConsole === \"auto\") {\n      // Show on localhost or 127.0.0.1 only\n      const localhostHosts = new Set([\"localhost\", \"127.0.0.1\"]);\n      if (localhostHosts.has(window.location.hostname)) {\n        setShouldRenderInspector(true);\n      } else {\n        setShouldRenderInspector(false);\n      }\n    } else {\n      // showDevConsole is false or undefined (default false)\n      setShouldRenderInspector(false);\n    }\n  }, [showDevConsole]);\n\n  // Normalize array props to stable references with clear dev warnings\n  const renderToolCallsList = useStableArrayProp<ReactToolCallRenderer<any>>(\n    renderToolCalls,\n    \"renderToolCalls must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n    (initial, next) => {\n      // Only warn if the shape (names+agentId) changed. Allow identity changes\n      // to support updated closures from parents (e.g., Storybook state).\n      const key = (rc?: ReactToolCallRenderer<unknown>) =>\n        `${rc?.agentId ?? \"\"}:${rc?.name ?? \"\"}`;\n      const setFrom = (arr: ReactToolCallRenderer<unknown>[]) =>\n        new Set(arr.map(key));\n      const a = setFrom(initial);\n      const b = setFrom(next);\n      if (a.size !== b.size) return true;\n      for (const k of a) if (!b.has(k)) return true;\n      return false;\n    },\n  );\n\n  const renderCustomMessagesList =\n    useStableArrayProp<ReactCustomMessageRenderer>(\n      renderCustomMessages,\n      \"renderCustomMessages must be a stable array.\",\n    );\n\n  const renderActivityMessagesList = useStableArrayProp<\n    ReactActivityMessageRenderer<any>\n  >(renderActivityMessages, \"renderActivityMessages must be a stable array.\");\n\n  // Built-in activity renderers that are always included\n  const builtInActivityRenderers = useMemo<ReactActivityMessageRenderer<any>[]>(\n    () => [\n      {\n        activityType: MCPAppsActivityType,\n        content: MCPAppsActivityContentSchema,\n        render: MCPAppsActivityRenderer,\n      },\n    ],\n    [],\n  );\n\n  // Combine user-provided activity renderers with built-in ones\n  // User-provided renderers take precedence (come first) so they can override built-ins\n  const allActivityRenderers = useMemo(() => {\n    return [...renderActivityMessagesList, ...builtInActivityRenderers];\n  }, [renderActivityMessagesList, builtInActivityRenderers]);\n\n  const resolvedPublicKey = publicApiKey ?? publicLicenseKey;\n  const mergedAgents = useMemo(\n    () => ({ ...agents, ...selfManagedAgents }),\n    [agents, selfManagedAgents],\n  );\n  const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;\n\n  // Merge a provided publicApiKey into headers (without overwriting an explicit header).\n  const mergedHeaders = useMemo(() => {\n    if (!resolvedPublicKey) return headers;\n    if (headers[HEADER_NAME]) return headers;\n    return {\n      ...headers,\n      [HEADER_NAME]: resolvedPublicKey,\n    };\n  }, [headers, resolvedPublicKey]);\n\n  if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {\n    const message =\n      \"Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'\";\n    if (process.env.NODE_ENV === \"production\") {\n      throw new Error(message);\n    } else {\n      // In dev/test we warn but allow to facilitate local agents and unit tests.\n      console.warn(message);\n    }\n  }\n\n  const chatApiEndpoint =\n    runtimeUrl ?? (resolvedPublicKey ? COPILOT_CLOUD_CHAT_URL : undefined);\n\n  const frontendToolsList = useStableArrayProp<ReactFrontendTool>(\n    frontendTools,\n    \"frontendTools must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n  );\n  const humanInTheLoopList = useStableArrayProp<ReactHumanInTheLoop>(\n    humanInTheLoop,\n    \"humanInTheLoop must be a stable array. If you want to dynamically add or remove human-in-the-loop tools, use `useHumanInTheLoop` instead.\",\n  );\n\n  // Note: warnings for array identity changes are handled by useStableArrayProp\n\n  // Process humanInTheLoop tools to create handlers and add render components\n  const processedHumanInTheLoopTools = useMemo(() => {\n    const processedTools: FrontendTool[] = [];\n    const processedRenderToolCalls: ReactToolCallRenderer<unknown>[] = [];\n\n    humanInTheLoopList.forEach((tool) => {\n      // Create a promise-based handler for each human-in-the-loop tool\n      const frontendTool: FrontendTool = {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.parameters,\n        followUp: tool.followUp,\n        ...(tool.agentId && { agentId: tool.agentId }),\n        handler: async () => {\n          // This handler will be replaced by the hook when it runs\n          // For provider-level tools, we create a basic handler that waits for user interaction\n          return new Promise((resolve) => {\n            // The actual implementation will be handled by the render component\n            // This is a placeholder that the hook will override\n            console.warn(\n              `Human-in-the-loop tool '${tool.name}' called but no interactive handler is set up.`,\n            );\n            resolve(undefined);\n          });\n        },\n      };\n      processedTools.push(frontendTool);\n\n      // Add the render component to renderToolCalls\n      if (tool.render) {\n        processedRenderToolCalls.push({\n          name: tool.name,\n          args: tool.parameters!,\n          render: tool.render,\n          ...(tool.agentId && { agentId: tool.agentId }),\n        } as ReactToolCallRenderer<unknown>);\n      }\n    });\n\n    return { tools: processedTools, renderToolCalls: processedRenderToolCalls };\n  }, [humanInTheLoopList]);\n\n  // Combine all tools for CopilotKitCore\n  const allTools = useMemo(() => {\n    const tools: FrontendTool[] = [];\n\n    // Add frontend tools\n    tools.push(...frontendToolsList);\n\n    // Add processed human-in-the-loop tools\n    tools.push(...processedHumanInTheLoopTools.tools);\n\n    return tools;\n  }, [frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Combine all render tool calls\n  const allRenderToolCalls = useMemo(() => {\n    const combined: ReactToolCallRenderer<unknown>[] = [...renderToolCallsList];\n\n    // Add render components from frontend tools\n    frontendToolsList.forEach((tool) => {\n      if (tool.render) {\n        // For wildcard tools without parameters, default to z.any()\n        const args =\n          tool.parameters || (tool.name === \"*\" ? z.any() : undefined);\n        if (args) {\n          combined.push({\n            name: tool.name,\n            args: args,\n            render: tool.render,\n          } as ReactToolCallRenderer<unknown>);\n        }\n      }\n    });\n\n    // Add render components from human-in-the-loop tools\n    combined.push(...processedHumanInTheLoopTools.renderToolCalls);\n\n    return combined;\n  }, [renderToolCallsList, frontendToolsList, processedHumanInTheLoopTools]);\n\n  const copilotkit = useMemo(() => {\n    const copilotkit = new CopilotKitCoreReact({\n      runtimeUrl: chatApiEndpoint,\n      runtimeTransport: useSingleEndpoint ? \"single\" : \"rest\",\n      headers: mergedHeaders,\n      credentials,\n      properties,\n      agents__unsafe_dev_only: mergedAgents,\n      tools: allTools,\n      renderToolCalls: allRenderToolCalls,\n      renderActivityMessages: allActivityRenderers,\n      renderCustomMessages: renderCustomMessagesList,\n    });\n\n    return copilotkit;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    allTools,\n    allRenderToolCalls,\n    allActivityRenderers,\n    renderCustomMessagesList,\n    useSingleEndpoint,\n  ]);\n\n  // Subscribe to render tool calls changes to force re-renders\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onRenderToolCallsChanged: () => {\n        forceUpdate();\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // Track executing tool call IDs at the provider level.\n  // This is critical for HITL reconnection: when connecting to a thread with\n  // pending tool calls, the onToolExecutionStart event fires before child components\n  // (like CopilotChatToolCallsView) mount. By tracking at the provider level,\n  // we ensure the executing state is captured and available when children mount.\n  const [executingToolCallIds, setExecutingToolCallIds] = useState<\n    ReadonlySet<string>\n  >(() => new Set());\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onToolExecutionStart: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.add(toolCallId);\n          return next;\n        });\n      },\n      onToolExecutionEnd: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (!prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.delete(toolCallId);\n          return next;\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  useEffect(() => {\n    copilotkit.setRuntimeUrl(chatApiEndpoint);\n    copilotkit.setRuntimeTransport(useSingleEndpoint ? \"single\" : \"rest\");\n    copilotkit.setHeaders(mergedHeaders);\n    copilotkit.setCredentials(credentials);\n    copilotkit.setProperties(properties);\n    copilotkit.setAgents__unsafe_dev_only(mergedAgents);\n  }, [\n    chatApiEndpoint,\n    mergedHeaders,\n    credentials,\n    properties,\n    mergedAgents,\n    useSingleEndpoint,\n  ]);\n\n  return (\n    <CopilotKitContext.Provider\n      value={{\n        copilotkit,\n        executingToolCallIds,\n      }}\n    >\n      {children}\n      {shouldRenderInspector ? <CopilotKitInspector core={copilotkit} /> : null}\n    </CopilotKitContext.Provider>\n  );\n};\n\n// Hook to use the CopilotKit instance - returns the full context value\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x) => 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    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n"],"mappings":"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"}
+{"version":3,"file":"CopilotKitProvider.cjs","names":["MCPAppsActivityType","MCPAppsActivityContentSchema","MCPAppsActivityRenderer","z","CopilotKitCoreReact","CopilotKitInspector"],"sources":["../../src/providers/CopilotKitProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { AbstractAgent } from \"@ag-ui/client\";\nimport type { FrontendTool } from \"@copilotkitnext/core\";\nimport type React from \"react\";\nimport {\n  createContext,\n  useContext,\n  type ReactNode,\n  useMemo,\n  useEffect,\n  useReducer,\n  useRef,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport { CopilotKitInspector } from \"../components/CopilotKitInspector\";\nimport type { CopilotKitCoreErrorCode } from \"@copilotkitnext/core\";\nimport {\n  MCPAppsActivityContentSchema,\n  MCPAppsActivityRenderer,\n  MCPAppsActivityType,\n} from \"../components/MCPAppsActivityRenderer\";\nimport { CopilotKitCoreReact } from \"../lib/react-core\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactFrontendTool } from \"../types/frontend-tool\";\nimport type { ReactHumanInTheLoop } from \"../types/human-in-the-loop\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\n\nconst HEADER_NAME = \"X-CopilotCloud-Public-Api-Key\";\nconst COPILOT_CLOUD_CHAT_URL = \"https://api.cloud.copilotkit.ai/copilotkit/v1\";\n\n// Define the context value interface - idiomatic React naming\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\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\n// Empty set for default context value\nconst EMPTY_SET: ReadonlySet<string> = new Set();\n\n// Create the CopilotKit context\nconst CopilotKitContext = createContext<CopilotKitContextValue>({\n  copilotkit: null!,\n  executingToolCallIds: EMPTY_SET,\n});\n\n// Provider props interface\nexport interface CopilotKitProviderProps {\n  children: ReactNode;\n  runtimeUrl?: string;\n  headers?: Record<string, string>;\n  /**\n   * Credentials mode for fetch requests (e.g., \"include\" for HTTP-only cookies in cross-origin requests).\n   */\n  credentials?: RequestCredentials;\n  /**\n   * The Copilot Cloud public API key.\n   */\n  publicApiKey?: string;\n  /**\n   * Alias for `publicApiKey`\n   **/\n  publicLicenseKey?: string;\n  properties?: Record<string, unknown>;\n  useSingleEndpoint?: boolean;\n  agents__unsafe_dev_only?: Record<string, AbstractAgent>;\n  selfManagedAgents?: Record<string, AbstractAgent>;\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n  frontendTools?: ReactFrontendTool[];\n  humanInTheLoop?: ReactHumanInTheLoop[];\n  showDevConsole?: boolean | \"auto\";\n  /**\n   * Error handler called when CopilotKit encounters an error.\n   * Fires for all error types (runtime connection failures, agent errors, tool errors).\n   */\n  onError?: (event: {\n    error: Error;\n    code: CopilotKitCoreErrorCode;\n    context: Record<string, any>;\n  }) => void | Promise<void>;\n}\n\n// Small helper to normalize array props to a stable reference and warn\nfunction useStableArrayProp<T>(\n  prop: T[] | undefined,\n  warningMessage?: string,\n  isMeaningfulChange?: (initial: T[], next: T[]) => boolean,\n): T[] {\n  const empty = useMemo<T[]>(() => [], []);\n  const value = prop ?? empty;\n  const initial = useRef(value);\n\n  useEffect(() => {\n    if (\n      warningMessage &&\n      value !== initial.current &&\n      (isMeaningfulChange ? isMeaningfulChange(initial.current, value) : true)\n    ) {\n      console.error(warningMessage);\n    }\n  }, [value, warningMessage]);\n\n  return value;\n}\n\n// Provider component\nexport const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({\n  children,\n  runtimeUrl,\n  headers = {},\n  credentials,\n  publicApiKey,\n  publicLicenseKey,\n  properties = {},\n  agents__unsafe_dev_only: agents = {},\n  selfManagedAgents = {},\n  renderToolCalls,\n  renderActivityMessages,\n  renderCustomMessages,\n  frontendTools,\n  humanInTheLoop,\n  showDevConsole = false,\n  useSingleEndpoint = false,\n  onError,\n}) => {\n  const [shouldRenderInspector, setShouldRenderInspector] = useState(false);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    if (showDevConsole === true) {\n      // Explicitly show the inspector\n      setShouldRenderInspector(true);\n    } else if (showDevConsole === \"auto\") {\n      // Show on localhost or 127.0.0.1 only\n      const localhostHosts = new Set([\"localhost\", \"127.0.0.1\"]);\n      if (localhostHosts.has(window.location.hostname)) {\n        setShouldRenderInspector(true);\n      } else {\n        setShouldRenderInspector(false);\n      }\n    } else {\n      // showDevConsole is false or undefined (default false)\n      setShouldRenderInspector(false);\n    }\n  }, [showDevConsole]);\n\n  // Normalize array props to stable references with clear dev warnings\n  const renderToolCallsList = useStableArrayProp<ReactToolCallRenderer<any>>(\n    renderToolCalls,\n    \"renderToolCalls must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n    (initial, next) => {\n      // Only warn if the shape (names+agentId) changed. Allow identity changes\n      // to support updated closures from parents (e.g., Storybook state).\n      const key = (rc?: ReactToolCallRenderer<unknown>) =>\n        `${rc?.agentId ?? \"\"}:${rc?.name ?? \"\"}`;\n      const setFrom = (arr: ReactToolCallRenderer<unknown>[]) =>\n        new Set(arr.map(key));\n      const a = setFrom(initial);\n      const b = setFrom(next);\n      if (a.size !== b.size) return true;\n      for (const k of a) if (!b.has(k)) return true;\n      return false;\n    },\n  );\n\n  const renderCustomMessagesList =\n    useStableArrayProp<ReactCustomMessageRenderer>(\n      renderCustomMessages,\n      \"renderCustomMessages must be a stable array.\",\n    );\n\n  const renderActivityMessagesList = useStableArrayProp<\n    ReactActivityMessageRenderer<any>\n  >(renderActivityMessages, \"renderActivityMessages must be a stable array.\");\n\n  // Built-in activity renderers that are always included\n  const builtInActivityRenderers = useMemo<ReactActivityMessageRenderer<any>[]>(\n    () => [\n      {\n        activityType: MCPAppsActivityType,\n        content: MCPAppsActivityContentSchema,\n        render: MCPAppsActivityRenderer,\n      },\n    ],\n    [],\n  );\n\n  // Combine user-provided activity renderers with built-in ones\n  // User-provided renderers take precedence (come first) so they can override built-ins\n  const allActivityRenderers = useMemo(() => {\n    return [...renderActivityMessagesList, ...builtInActivityRenderers];\n  }, [renderActivityMessagesList, builtInActivityRenderers]);\n\n  const resolvedPublicKey = publicApiKey ?? publicLicenseKey;\n  const mergedAgents = useMemo(\n    () => ({ ...agents, ...selfManagedAgents }),\n    [agents, selfManagedAgents],\n  );\n  const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;\n\n  // Merge a provided publicApiKey into headers (without overwriting an explicit header).\n  const mergedHeaders = useMemo(() => {\n    if (!resolvedPublicKey) return headers;\n    if (headers[HEADER_NAME]) return headers;\n    return {\n      ...headers,\n      [HEADER_NAME]: resolvedPublicKey,\n    };\n  }, [headers, resolvedPublicKey]);\n\n  if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {\n    const message =\n      \"Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'\";\n    if (process.env.NODE_ENV === \"production\") {\n      throw new Error(message);\n    } else {\n      // In dev/test we warn but allow to facilitate local agents and unit tests.\n      console.warn(message);\n    }\n  }\n\n  const chatApiEndpoint =\n    runtimeUrl ?? (resolvedPublicKey ? COPILOT_CLOUD_CHAT_URL : undefined);\n\n  const frontendToolsList = useStableArrayProp<ReactFrontendTool>(\n    frontendTools,\n    \"frontendTools must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n  );\n  const humanInTheLoopList = useStableArrayProp<ReactHumanInTheLoop>(\n    humanInTheLoop,\n    \"humanInTheLoop must be a stable array. If you want to dynamically add or remove human-in-the-loop tools, use `useHumanInTheLoop` instead.\",\n  );\n\n  // Note: warnings for array identity changes are handled by useStableArrayProp\n\n  // Process humanInTheLoop tools to create handlers and add render components\n  const processedHumanInTheLoopTools = useMemo(() => {\n    const processedTools: FrontendTool[] = [];\n    const processedRenderToolCalls: ReactToolCallRenderer<unknown>[] = [];\n\n    humanInTheLoopList.forEach((tool) => {\n      // Create a promise-based handler for each human-in-the-loop tool\n      const frontendTool: FrontendTool = {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.parameters,\n        followUp: tool.followUp,\n        ...(tool.agentId && { agentId: tool.agentId }),\n        handler: async () => {\n          // This handler will be replaced by the hook when it runs\n          // For provider-level tools, we create a basic handler that waits for user interaction\n          return new Promise((resolve) => {\n            // The actual implementation will be handled by the render component\n            // This is a placeholder that the hook will override\n            console.warn(\n              `Human-in-the-loop tool '${tool.name}' called but no interactive handler is set up.`,\n            );\n            resolve(undefined);\n          });\n        },\n      };\n      processedTools.push(frontendTool);\n\n      // Add the render component to renderToolCalls\n      if (tool.render) {\n        processedRenderToolCalls.push({\n          name: tool.name,\n          args: tool.parameters!,\n          render: tool.render,\n          ...(tool.agentId && { agentId: tool.agentId }),\n        } as ReactToolCallRenderer<unknown>);\n      }\n    });\n\n    return { tools: processedTools, renderToolCalls: processedRenderToolCalls };\n  }, [humanInTheLoopList]);\n\n  // Combine all tools for CopilotKitCore\n  const allTools = useMemo(() => {\n    const tools: FrontendTool[] = [];\n\n    // Add frontend tools\n    tools.push(...frontendToolsList);\n\n    // Add processed human-in-the-loop tools\n    tools.push(...processedHumanInTheLoopTools.tools);\n\n    return tools;\n  }, [frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Combine all render tool calls\n  const allRenderToolCalls = useMemo(() => {\n    const combined: ReactToolCallRenderer<unknown>[] = [...renderToolCallsList];\n\n    // Add render components from frontend tools\n    frontendToolsList.forEach((tool) => {\n      if (tool.render) {\n        // For wildcard tools without parameters, default to z.any()\n        const args =\n          tool.parameters || (tool.name === \"*\" ? z.any() : undefined);\n        if (args) {\n          combined.push({\n            name: tool.name,\n            args: args,\n            render: tool.render,\n          } as ReactToolCallRenderer<unknown>);\n        }\n      }\n    });\n\n    // Add render components from human-in-the-loop tools\n    combined.push(...processedHumanInTheLoopTools.renderToolCalls);\n\n    return combined;\n  }, [renderToolCallsList, frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Stable instance: created once for the provider lifetime.\n  // Updates are applied via setter effects below rather than recreating the instance.\n  const copilotkitRef = useRef<CopilotKitCoreReact | null>(null);\n  if (copilotkitRef.current === null) {\n    copilotkitRef.current = new CopilotKitCoreReact({\n      runtimeUrl: chatApiEndpoint,\n      runtimeTransport: useSingleEndpoint ? \"single\" : \"rest\",\n      headers: mergedHeaders,\n      credentials,\n      properties,\n      agents__unsafe_dev_only: mergedAgents,\n      tools: allTools,\n      renderToolCalls: allRenderToolCalls,\n      renderActivityMessages: allActivityRenderers,\n      renderCustomMessages: renderCustomMessagesList,\n    });\n  }\n  const copilotkit = copilotkitRef.current;\n\n  // Subscribe to render tool calls changes to force re-renders\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onRenderToolCallsChanged: () => {\n        forceUpdate();\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // Track executing tool call IDs at the provider level.\n  // This is critical for HITL reconnection: when connecting to a thread with\n  // pending tool calls, the onToolExecutionStart event fires before child components\n  // (like CopilotChatToolCallsView) mount. By tracking at the provider level,\n  // we ensure the executing state is captured and available when children mount.\n  const [executingToolCallIds, setExecutingToolCallIds] = useState<\n    ReadonlySet<string>\n  >(() => new Set());\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onToolExecutionStart: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.add(toolCallId);\n          return next;\n        });\n      },\n      onToolExecutionEnd: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (!prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.delete(toolCallId);\n          return next;\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // onError subscription — forward core errors to user callback\n  const onErrorRef = useRef(onError);\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n\n  useEffect(() => {\n    if (!onErrorRef.current) return;\n\n    const subscription = copilotkit.subscribe({\n      onError: (event) => {\n        onErrorRef.current?.({\n          error: event.error,\n          code: event.code,\n          context: event.context,\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  useEffect(() => {\n    copilotkit.setRuntimeUrl(chatApiEndpoint);\n    copilotkit.setRuntimeTransport(useSingleEndpoint ? \"single\" : \"rest\");\n    copilotkit.setHeaders(mergedHeaders);\n    copilotkit.setCredentials(credentials);\n    copilotkit.setProperties(properties);\n    copilotkit.setAgents__unsafe_dev_only(mergedAgents);\n  }, [\n    copilotkit,\n    chatApiEndpoint,\n    mergedHeaders,\n    credentials,\n    properties,\n    mergedAgents,\n    useSingleEndpoint,\n  ]);\n\n  // Sync render/tool arrays to the stable instance via setters.\n  // On mount, the constructor already receives the correct initial values,\n  // so we skip the first invocation. This is critical because child hooks\n  // (e.g., useFrontendTool, useHumanInTheLoop) register tools dynamically\n  // via addTool()/setRenderToolCalls() in their own effects, which fire\n  // BEFORE parent effects (React fires effects bottom-up). If the parent\n  // setter effects ran on mount, they would overwrite the children's tools.\n  const didMountRef = useRef(false);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setTools(allTools);\n  }, [copilotkit, allTools]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderToolCalls(allRenderToolCalls);\n  }, [copilotkit, allRenderToolCalls]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderActivityMessages(allActivityRenderers);\n  }, [copilotkit, allActivityRenderers]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderCustomMessages(renderCustomMessagesList);\n  }, [copilotkit, renderCustomMessagesList]);\n\n  // Mark mount complete — must be declared AFTER the setter effects\n  // so it runs last in the effect queue on the initial mount cycle.\n  useEffect(() => {\n    didMountRef.current = true;\n  }, []);\n\n  const contextValue = useMemo<CopilotKitContextValue>(\n    () => ({ copilotkit, executingToolCallIds }),\n    [copilotkit, executingToolCallIds],\n  );\n\n  return (\n    <CopilotKitContext.Provider value={contextValue}>\n      {children}\n      {shouldRenderInspector ? <CopilotKitInspector core={copilotkit} /> : null}\n    </CopilotKitContext.Provider>\n  );\n};\n\n// Hook to use the CopilotKit instance - returns the full context value\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x) => 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    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n"],"mappings":"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"}

package/dist/providers/CopilotKitProvider.d.cts

@@ -7,6 +7,7 @@ import "../types/index.cjs";
 import { CopilotKitCoreReact } from "../lib/react-core.cjs";
 import { AbstractAgent } from "@ag-ui/client";
 import React, { ReactNode } from "react";
+import { CopilotKitCoreErrorCode } from "@copilotkitnext/core";
 
 //#region src/providers/CopilotKitProvider.d.ts
 interface CopilotKitContextValue {
@@ -44,6 +45,15 @@ interface CopilotKitProviderProps {
   frontendTools?: ReactFrontendTool[];
   humanInTheLoop?: ReactHumanInTheLoop[];
   showDevConsole?: boolean | "auto";
+  /**
+   * Error handler called when CopilotKit encounters an error.
+   * Fires for all error types (runtime connection failures, agent errors, tool errors).
+   */
+  onError?: (event: {
+    error: Error;
+    code: CopilotKitCoreErrorCode;
+    context: Record<string, any>;
+  }) => void | Promise<void>;
 }
 declare const CopilotKitProvider: React.FC<CopilotKitProviderProps>;
 declare const useCopilotKit: () => CopilotKitContextValue;

package/dist/providers/CopilotKitProvider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotKitProvider.d.cts","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"mappings":";;;;;;;;;;;UAmCiB,sBAAA;EACf,UAAA,EAAY,mBAAA;;AADd;;;;EAOE,oBAAA,EAAsB,WAAA;AAAA;AAAA,UAaP,uBAAA;EACf,QAAA,EAAU,SAAA;EACV,UAAA;EACA,OAAA,GAAU,MAAA;EAHK;;;EAOf,WAAA,GAAc,kBAAA;EAJJ;;;EAQV,YAAA;EAO0B;;;EAH1B,gBAAA;EACA,UAAA,GAAa,MAAA;EACb,iBAAA;EACA,uBAAA,GAA0B,MAAA,SAAe,aAAA;EACzC,iBAAA,GAAoB,MAAA,SAAe,aAAA;EACnC,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EACzB,oBAAA,GAAuB,0BAAA;EACvB,aAAA,GAAgB,iBAAA;EAChB,cAAA,GAAiB,mBAAA;EACjB,cAAA;AAAA;AAAA,cA2BW,kBAAA,EAAoB,KAAA,CAAM,EAAA,CAAG,uBAAA;AAAA,cA2T7B,aAAA,QAAoB,sBAAA"}
+{"version":3,"file":"CopilotKitProvider.d.cts","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"mappings":";;;;;;;;;;;;UAoCiB,sBAAA;EACf,UAAA,EAAY,mBAAA;;AADd;;;;EAOE,oBAAA,EAAsB,WAAA;AAAA;AAAA,UAaP,uBAAA;EACf,QAAA,EAAU,SAAA;EACV,UAAA;EACA,OAAA,GAAU,MAAA;EAHK;;;EAOf,WAAA,GAAc,kBAAA;EAJJ;;;EAQV,YAAA;EAO0B;;;EAH1B,gBAAA;EACA,UAAA,GAAa,MAAA;EACb,iBAAA;EACA,uBAAA,GAA0B,MAAA,SAAe,aAAA;EACzC,iBAAA,GAAoB,MAAA,SAAe,aAAA;EACnC,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EACzB,oBAAA,GAAuB,0BAAA;EACvB,aAAA,GAAgB,iBAAA;EAChB,cAAA,GAAiB,mBAAA;EACjB,cAAA;EAxBA;;;;EA6BA,OAAA,IAAW,KAAA;IACT,KAAA,EAAO,KAAA;IACP,IAAA,EAAM,uBAAA;IACN,OAAA,EAAS,MAAA;EAAA,aACE,OAAA;AAAA;AAAA,cA2BF,kBAAA,EAAoB,KAAA,CAAM,EAAA,CAAG,uBAAA;AAAA,cAmX7B,aAAA,QAAoB,sBAAA"}

package/dist/providers/CopilotKitProvider.d.mts

@@ -7,6 +7,7 @@ import "../types/index.mjs";
 import { CopilotKitCoreReact } from "../lib/react-core.mjs";
 import { AbstractAgent } from "@ag-ui/client";
 import React, { ReactNode } from "react";
+import { CopilotKitCoreErrorCode } from "@copilotkitnext/core";
 
 //#region src/providers/CopilotKitProvider.d.ts
 interface CopilotKitContextValue {
@@ -44,6 +45,15 @@ interface CopilotKitProviderProps {
   frontendTools?: ReactFrontendTool[];
   humanInTheLoop?: ReactHumanInTheLoop[];
   showDevConsole?: boolean | "auto";
+  /**
+   * Error handler called when CopilotKit encounters an error.
+   * Fires for all error types (runtime connection failures, agent errors, tool errors).
+   */
+  onError?: (event: {
+    error: Error;
+    code: CopilotKitCoreErrorCode;
+    context: Record<string, any>;
+  }) => void | Promise<void>;
 }
 declare const CopilotKitProvider: React.FC<CopilotKitProviderProps>;
 declare const useCopilotKit: () => CopilotKitContextValue;

package/dist/providers/CopilotKitProvider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotKitProvider.d.mts","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"mappings":";;;;;;;;;;;UAmCiB,sBAAA;EACf,UAAA,EAAY,mBAAA;;AADd;;;;EAOE,oBAAA,EAAsB,WAAA;AAAA;AAAA,UAaP,uBAAA;EACf,QAAA,EAAU,SAAA;EACV,UAAA;EACA,OAAA,GAAU,MAAA;EAHK;;;EAOf,WAAA,GAAc,kBAAA;EAJJ;;;EAQV,YAAA;EAO0B;;;EAH1B,gBAAA;EACA,UAAA,GAAa,MAAA;EACb,iBAAA;EACA,uBAAA,GAA0B,MAAA,SAAe,aAAA;EACzC,iBAAA,GAAoB,MAAA,SAAe,aAAA;EACnC,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EACzB,oBAAA,GAAuB,0BAAA;EACvB,aAAA,GAAgB,iBAAA;EAChB,cAAA,GAAiB,mBAAA;EACjB,cAAA;AAAA;AAAA,cA2BW,kBAAA,EAAoB,KAAA,CAAM,EAAA,CAAG,uBAAA;AAAA,cA2T7B,aAAA,QAAoB,sBAAA"}
+{"version":3,"file":"CopilotKitProvider.d.mts","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"mappings":";;;;;;;;;;;;UAoCiB,sBAAA;EACf,UAAA,EAAY,mBAAA;;AADd;;;;EAOE,oBAAA,EAAsB,WAAA;AAAA;AAAA,UAaP,uBAAA;EACf,QAAA,EAAU,SAAA;EACV,UAAA;EACA,OAAA,GAAU,MAAA;EAHK;;;EAOf,WAAA,GAAc,kBAAA;EAJJ;;;EAQV,YAAA;EAO0B;;;EAH1B,gBAAA;EACA,UAAA,GAAa,MAAA;EACb,iBAAA;EACA,uBAAA,GAA0B,MAAA,SAAe,aAAA;EACzC,iBAAA,GAAoB,MAAA,SAAe,aAAA;EACnC,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EACzB,oBAAA,GAAuB,0BAAA;EACvB,aAAA,GAAgB,iBAAA;EAChB,cAAA,GAAiB,mBAAA;EACjB,cAAA;EAxBA;;;;EA6BA,OAAA,IAAW,KAAA;IACT,KAAA,EAAO,KAAA;IACP,IAAA,EAAM,uBAAA;IACN,OAAA,EAAS,MAAA;EAAA,aACE,OAAA;AAAA;AAAA,cA2BF,kBAAA,EAAoB,KAAA,CAAM,EAAA,CAAG,uBAAA;AAAA,cAmX7B,aAAA,QAAoB,sBAAA"}

package/dist/providers/CopilotKitProvider.mjs

@@ -23,7 +23,7 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	}, [value, warningMessage]);
 	return value;
 }
-const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, publicApiKey, publicLicenseKey, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, showDevConsole = false, useSingleEndpoint = false }) => {
+const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, publicApiKey, publicLicenseKey, properties = {}, agents__unsafe_dev_only: agents = {}, selfManagedAgents = {}, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, showDevConsole = false, useSingleEndpoint = false, onError }) => {
 	const [shouldRenderInspector, setShouldRenderInspector] = useState(false);
 	useEffect(() => {
 		if (typeof window === "undefined") return;
@@ -128,26 +128,20 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		frontendToolsList,
 		processedHumanInTheLoopTools
 	]);
-	const copilotkit = useMemo(() => {
-		return new CopilotKitCoreReact({
-			runtimeUrl: chatApiEndpoint,
-			runtimeTransport: useSingleEndpoint ? "single" : "rest",
-			headers: mergedHeaders,
-			credentials,
-			properties,
-			agents__unsafe_dev_only: mergedAgents,
-			tools: allTools,
-			renderToolCalls: allRenderToolCalls,
-			renderActivityMessages: allActivityRenderers,
-			renderCustomMessages: renderCustomMessagesList
-		});
-	}, [
-		allTools,
-		allRenderToolCalls,
-		allActivityRenderers,
-		renderCustomMessagesList,
-		useSingleEndpoint
-	]);
+	const copilotkitRef = useRef(null);
+	if (copilotkitRef.current === null) copilotkitRef.current = new CopilotKitCoreReact({
+		runtimeUrl: chatApiEndpoint,
+		runtimeTransport: useSingleEndpoint ? "single" : "rest",
+		headers: mergedHeaders,
+		credentials,
+		properties,
+		agents__unsafe_dev_only: mergedAgents,
+		tools: allTools,
+		renderToolCalls: allRenderToolCalls,
+		renderActivityMessages: allActivityRenderers,
+		renderCustomMessages: renderCustomMessagesList
+	});
+	const copilotkit = copilotkitRef.current;
 	const [, forceUpdate] = useReducer((x) => x + 1, 0);
 	useEffect(() => {
 		const subscription = copilotkit.subscribe({ onRenderToolCallsChanged: () => {
@@ -181,6 +175,23 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 			subscription.unsubscribe();
 		};
 	}, [copilotkit]);
+	const onErrorRef = useRef(onError);
+	useEffect(() => {
+		onErrorRef.current = onError;
+	}, [onError]);
+	useEffect(() => {
+		if (!onErrorRef.current) return;
+		const subscription = copilotkit.subscribe({ onError: (event) => {
+			onErrorRef.current?.({
+				error: event.error,
+				code: event.code,
+				context: event.context
+			});
+		} });
+		return () => {
+			subscription.unsubscribe();
+		};
+	}, [copilotkit]);
 	useEffect(() => {
 		copilotkit.setRuntimeUrl(chatApiEndpoint);
 		copilotkit.setRuntimeTransport(useSingleEndpoint ? "single" : "rest");
@@ -189,6 +200,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		copilotkit.setProperties(properties);
 		copilotkit.setAgents__unsafe_dev_only(mergedAgents);
 	}, [
+		copilotkit,
 		chatApiEndpoint,
 		mergedHeaders,
 		credentials,
@@ -196,11 +208,32 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers = {}, credentials, p
 		mergedAgents,
 		useSingleEndpoint
 	]);
+	const didMountRef = useRef(false);
+	useEffect(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setTools(allTools);
+	}, [copilotkit, allTools]);
+	useEffect(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderToolCalls(allRenderToolCalls);
+	}, [copilotkit, allRenderToolCalls]);
+	useEffect(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderActivityMessages(allActivityRenderers);
+	}, [copilotkit, allActivityRenderers]);
+	useEffect(() => {
+		if (!didMountRef.current) return;
+		copilotkit.setRenderCustomMessages(renderCustomMessagesList);
+	}, [copilotkit, renderCustomMessagesList]);
+	useEffect(() => {
+		didMountRef.current = true;
+	}, []);
+	const contextValue = useMemo(() => ({
+		copilotkit,
+		executingToolCallIds
+	}), [copilotkit, executingToolCallIds]);
 	return /* @__PURE__ */ jsxs(CopilotKitContext.Provider, {
-		value: {
-			copilotkit,
-			executingToolCallIds
-		},
+		value: contextValue,
 		children: [children, shouldRenderInspector ? /* @__PURE__ */ jsx(CopilotKitInspector, { core: copilotkit }) : null]
 	});
 };

package/dist/providers/CopilotKitProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotKitProvider.mjs","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { AbstractAgent } from \"@ag-ui/client\";\nimport type { FrontendTool } from \"@copilotkitnext/core\";\nimport type React from \"react\";\nimport {\n  createContext,\n  useContext,\n  type ReactNode,\n  useMemo,\n  useEffect,\n  useReducer,\n  useRef,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport { CopilotKitInspector } from \"../components/CopilotKitInspector\";\nimport {\n  MCPAppsActivityContentSchema,\n  MCPAppsActivityRenderer,\n  MCPAppsActivityType,\n} from \"../components/MCPAppsActivityRenderer\";\nimport { CopilotKitCoreReact } from \"../lib/react-core\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactFrontendTool } from \"../types/frontend-tool\";\nimport type { ReactHumanInTheLoop } from \"../types/human-in-the-loop\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\n\nconst HEADER_NAME = \"X-CopilotCloud-Public-Api-Key\";\nconst COPILOT_CLOUD_CHAT_URL = \"https://api.cloud.copilotkit.ai/copilotkit/v1\";\n\n// Define the context value interface - idiomatic React naming\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\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\n// Empty set for default context value\nconst EMPTY_SET: ReadonlySet<string> = new Set();\n\n// Create the CopilotKit context\nconst CopilotKitContext = createContext<CopilotKitContextValue>({\n  copilotkit: null!,\n  executingToolCallIds: EMPTY_SET,\n});\n\n// Provider props interface\nexport interface CopilotKitProviderProps {\n  children: ReactNode;\n  runtimeUrl?: string;\n  headers?: Record<string, string>;\n  /**\n   * Credentials mode for fetch requests (e.g., \"include\" for HTTP-only cookies in cross-origin requests).\n   */\n  credentials?: RequestCredentials;\n  /**\n   * The Copilot Cloud public API key.\n   */\n  publicApiKey?: string;\n  /**\n   * Alias for `publicApiKey`\n   **/\n  publicLicenseKey?: string;\n  properties?: Record<string, unknown>;\n  useSingleEndpoint?: boolean;\n  agents__unsafe_dev_only?: Record<string, AbstractAgent>;\n  selfManagedAgents?: Record<string, AbstractAgent>;\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n  frontendTools?: ReactFrontendTool[];\n  humanInTheLoop?: ReactHumanInTheLoop[];\n  showDevConsole?: boolean | \"auto\";\n}\n\n// Small helper to normalize array props to a stable reference and warn\nfunction useStableArrayProp<T>(\n  prop: T[] | undefined,\n  warningMessage?: string,\n  isMeaningfulChange?: (initial: T[], next: T[]) => boolean,\n): T[] {\n  const empty = useMemo<T[]>(() => [], []);\n  const value = prop ?? empty;\n  const initial = useRef(value);\n\n  useEffect(() => {\n    if (\n      warningMessage &&\n      value !== initial.current &&\n      (isMeaningfulChange ? isMeaningfulChange(initial.current, value) : true)\n    ) {\n      console.error(warningMessage);\n    }\n  }, [value, warningMessage]);\n\n  return value;\n}\n\n// Provider component\nexport const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({\n  children,\n  runtimeUrl,\n  headers = {},\n  credentials,\n  publicApiKey,\n  publicLicenseKey,\n  properties = {},\n  agents__unsafe_dev_only: agents = {},\n  selfManagedAgents = {},\n  renderToolCalls,\n  renderActivityMessages,\n  renderCustomMessages,\n  frontendTools,\n  humanInTheLoop,\n  showDevConsole = false,\n  useSingleEndpoint = false,\n}) => {\n  const [shouldRenderInspector, setShouldRenderInspector] = useState(false);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    if (showDevConsole === true) {\n      // Explicitly show the inspector\n      setShouldRenderInspector(true);\n    } else if (showDevConsole === \"auto\") {\n      // Show on localhost or 127.0.0.1 only\n      const localhostHosts = new Set([\"localhost\", \"127.0.0.1\"]);\n      if (localhostHosts.has(window.location.hostname)) {\n        setShouldRenderInspector(true);\n      } else {\n        setShouldRenderInspector(false);\n      }\n    } else {\n      // showDevConsole is false or undefined (default false)\n      setShouldRenderInspector(false);\n    }\n  }, [showDevConsole]);\n\n  // Normalize array props to stable references with clear dev warnings\n  const renderToolCallsList = useStableArrayProp<ReactToolCallRenderer<any>>(\n    renderToolCalls,\n    \"renderToolCalls must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n    (initial, next) => {\n      // Only warn if the shape (names+agentId) changed. Allow identity changes\n      // to support updated closures from parents (e.g., Storybook state).\n      const key = (rc?: ReactToolCallRenderer<unknown>) =>\n        `${rc?.agentId ?? \"\"}:${rc?.name ?? \"\"}`;\n      const setFrom = (arr: ReactToolCallRenderer<unknown>[]) =>\n        new Set(arr.map(key));\n      const a = setFrom(initial);\n      const b = setFrom(next);\n      if (a.size !== b.size) return true;\n      for (const k of a) if (!b.has(k)) return true;\n      return false;\n    },\n  );\n\n  const renderCustomMessagesList =\n    useStableArrayProp<ReactCustomMessageRenderer>(\n      renderCustomMessages,\n      \"renderCustomMessages must be a stable array.\",\n    );\n\n  const renderActivityMessagesList = useStableArrayProp<\n    ReactActivityMessageRenderer<any>\n  >(renderActivityMessages, \"renderActivityMessages must be a stable array.\");\n\n  // Built-in activity renderers that are always included\n  const builtInActivityRenderers = useMemo<ReactActivityMessageRenderer<any>[]>(\n    () => [\n      {\n        activityType: MCPAppsActivityType,\n        content: MCPAppsActivityContentSchema,\n        render: MCPAppsActivityRenderer,\n      },\n    ],\n    [],\n  );\n\n  // Combine user-provided activity renderers with built-in ones\n  // User-provided renderers take precedence (come first) so they can override built-ins\n  const allActivityRenderers = useMemo(() => {\n    return [...renderActivityMessagesList, ...builtInActivityRenderers];\n  }, [renderActivityMessagesList, builtInActivityRenderers]);\n\n  const resolvedPublicKey = publicApiKey ?? publicLicenseKey;\n  const mergedAgents = useMemo(\n    () => ({ ...agents, ...selfManagedAgents }),\n    [agents, selfManagedAgents],\n  );\n  const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;\n\n  // Merge a provided publicApiKey into headers (without overwriting an explicit header).\n  const mergedHeaders = useMemo(() => {\n    if (!resolvedPublicKey) return headers;\n    if (headers[HEADER_NAME]) return headers;\n    return {\n      ...headers,\n      [HEADER_NAME]: resolvedPublicKey,\n    };\n  }, [headers, resolvedPublicKey]);\n\n  if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {\n    const message =\n      \"Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'\";\n    if (process.env.NODE_ENV === \"production\") {\n      throw new Error(message);\n    } else {\n      // In dev/test we warn but allow to facilitate local agents and unit tests.\n      console.warn(message);\n    }\n  }\n\n  const chatApiEndpoint =\n    runtimeUrl ?? (resolvedPublicKey ? COPILOT_CLOUD_CHAT_URL : undefined);\n\n  const frontendToolsList = useStableArrayProp<ReactFrontendTool>(\n    frontendTools,\n    \"frontendTools must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n  );\n  const humanInTheLoopList = useStableArrayProp<ReactHumanInTheLoop>(\n    humanInTheLoop,\n    \"humanInTheLoop must be a stable array. If you want to dynamically add or remove human-in-the-loop tools, use `useHumanInTheLoop` instead.\",\n  );\n\n  // Note: warnings for array identity changes are handled by useStableArrayProp\n\n  // Process humanInTheLoop tools to create handlers and add render components\n  const processedHumanInTheLoopTools = useMemo(() => {\n    const processedTools: FrontendTool[] = [];\n    const processedRenderToolCalls: ReactToolCallRenderer<unknown>[] = [];\n\n    humanInTheLoopList.forEach((tool) => {\n      // Create a promise-based handler for each human-in-the-loop tool\n      const frontendTool: FrontendTool = {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.parameters,\n        followUp: tool.followUp,\n        ...(tool.agentId && { agentId: tool.agentId }),\n        handler: async () => {\n          // This handler will be replaced by the hook when it runs\n          // For provider-level tools, we create a basic handler that waits for user interaction\n          return new Promise((resolve) => {\n            // The actual implementation will be handled by the render component\n            // This is a placeholder that the hook will override\n            console.warn(\n              `Human-in-the-loop tool '${tool.name}' called but no interactive handler is set up.`,\n            );\n            resolve(undefined);\n          });\n        },\n      };\n      processedTools.push(frontendTool);\n\n      // Add the render component to renderToolCalls\n      if (tool.render) {\n        processedRenderToolCalls.push({\n          name: tool.name,\n          args: tool.parameters!,\n          render: tool.render,\n          ...(tool.agentId && { agentId: tool.agentId }),\n        } as ReactToolCallRenderer<unknown>);\n      }\n    });\n\n    return { tools: processedTools, renderToolCalls: processedRenderToolCalls };\n  }, [humanInTheLoopList]);\n\n  // Combine all tools for CopilotKitCore\n  const allTools = useMemo(() => {\n    const tools: FrontendTool[] = [];\n\n    // Add frontend tools\n    tools.push(...frontendToolsList);\n\n    // Add processed human-in-the-loop tools\n    tools.push(...processedHumanInTheLoopTools.tools);\n\n    return tools;\n  }, [frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Combine all render tool calls\n  const allRenderToolCalls = useMemo(() => {\n    const combined: ReactToolCallRenderer<unknown>[] = [...renderToolCallsList];\n\n    // Add render components from frontend tools\n    frontendToolsList.forEach((tool) => {\n      if (tool.render) {\n        // For wildcard tools without parameters, default to z.any()\n        const args =\n          tool.parameters || (tool.name === \"*\" ? z.any() : undefined);\n        if (args) {\n          combined.push({\n            name: tool.name,\n            args: args,\n            render: tool.render,\n          } as ReactToolCallRenderer<unknown>);\n        }\n      }\n    });\n\n    // Add render components from human-in-the-loop tools\n    combined.push(...processedHumanInTheLoopTools.renderToolCalls);\n\n    return combined;\n  }, [renderToolCallsList, frontendToolsList, processedHumanInTheLoopTools]);\n\n  const copilotkit = useMemo(() => {\n    const copilotkit = new CopilotKitCoreReact({\n      runtimeUrl: chatApiEndpoint,\n      runtimeTransport: useSingleEndpoint ? \"single\" : \"rest\",\n      headers: mergedHeaders,\n      credentials,\n      properties,\n      agents__unsafe_dev_only: mergedAgents,\n      tools: allTools,\n      renderToolCalls: allRenderToolCalls,\n      renderActivityMessages: allActivityRenderers,\n      renderCustomMessages: renderCustomMessagesList,\n    });\n\n    return copilotkit;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    allTools,\n    allRenderToolCalls,\n    allActivityRenderers,\n    renderCustomMessagesList,\n    useSingleEndpoint,\n  ]);\n\n  // Subscribe to render tool calls changes to force re-renders\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onRenderToolCallsChanged: () => {\n        forceUpdate();\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // Track executing tool call IDs at the provider level.\n  // This is critical for HITL reconnection: when connecting to a thread with\n  // pending tool calls, the onToolExecutionStart event fires before child components\n  // (like CopilotChatToolCallsView) mount. By tracking at the provider level,\n  // we ensure the executing state is captured and available when children mount.\n  const [executingToolCallIds, setExecutingToolCallIds] = useState<\n    ReadonlySet<string>\n  >(() => new Set());\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onToolExecutionStart: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.add(toolCallId);\n          return next;\n        });\n      },\n      onToolExecutionEnd: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (!prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.delete(toolCallId);\n          return next;\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  useEffect(() => {\n    copilotkit.setRuntimeUrl(chatApiEndpoint);\n    copilotkit.setRuntimeTransport(useSingleEndpoint ? \"single\" : \"rest\");\n    copilotkit.setHeaders(mergedHeaders);\n    copilotkit.setCredentials(credentials);\n    copilotkit.setProperties(properties);\n    copilotkit.setAgents__unsafe_dev_only(mergedAgents);\n  }, [\n    chatApiEndpoint,\n    mergedHeaders,\n    credentials,\n    properties,\n    mergedAgents,\n    useSingleEndpoint,\n  ]);\n\n  return (\n    <CopilotKitContext.Provider\n      value={{\n        copilotkit,\n        executingToolCallIds,\n      }}\n    >\n      {children}\n      {shouldRenderInspector ? <CopilotKitInspector core={copilotkit} /> : null}\n    </CopilotKitContext.Provider>\n  );\n};\n\n// Hook to use the CopilotKit instance - returns the full context value\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x) => 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    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n"],"mappings":"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"}
+{"version":3,"file":"CopilotKitProvider.mjs","names":[],"sources":["../../src/providers/CopilotKitProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { AbstractAgent } from \"@ag-ui/client\";\nimport type { FrontendTool } from \"@copilotkitnext/core\";\nimport type React from \"react\";\nimport {\n  createContext,\n  useContext,\n  type ReactNode,\n  useMemo,\n  useEffect,\n  useReducer,\n  useRef,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport { CopilotKitInspector } from \"../components/CopilotKitInspector\";\nimport type { CopilotKitCoreErrorCode } from \"@copilotkitnext/core\";\nimport {\n  MCPAppsActivityContentSchema,\n  MCPAppsActivityRenderer,\n  MCPAppsActivityType,\n} from \"../components/MCPAppsActivityRenderer\";\nimport { CopilotKitCoreReact } from \"../lib/react-core\";\nimport type {\n  ReactActivityMessageRenderer,\n  ReactToolCallRenderer,\n} from \"../types\";\nimport type { ReactFrontendTool } from \"../types/frontend-tool\";\nimport type { ReactHumanInTheLoop } from \"../types/human-in-the-loop\";\nimport type { ReactCustomMessageRenderer } from \"../types/react-custom-message-renderer\";\n\nconst HEADER_NAME = \"X-CopilotCloud-Public-Api-Key\";\nconst COPILOT_CLOUD_CHAT_URL = \"https://api.cloud.copilotkit.ai/copilotkit/v1\";\n\n// Define the context value interface - idiomatic React naming\nexport interface CopilotKitContextValue {\n  copilotkit: CopilotKitCoreReact;\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\n// Empty set for default context value\nconst EMPTY_SET: ReadonlySet<string> = new Set();\n\n// Create the CopilotKit context\nconst CopilotKitContext = createContext<CopilotKitContextValue>({\n  copilotkit: null!,\n  executingToolCallIds: EMPTY_SET,\n});\n\n// Provider props interface\nexport interface CopilotKitProviderProps {\n  children: ReactNode;\n  runtimeUrl?: string;\n  headers?: Record<string, string>;\n  /**\n   * Credentials mode for fetch requests (e.g., \"include\" for HTTP-only cookies in cross-origin requests).\n   */\n  credentials?: RequestCredentials;\n  /**\n   * The Copilot Cloud public API key.\n   */\n  publicApiKey?: string;\n  /**\n   * Alias for `publicApiKey`\n   **/\n  publicLicenseKey?: string;\n  properties?: Record<string, unknown>;\n  useSingleEndpoint?: boolean;\n  agents__unsafe_dev_only?: Record<string, AbstractAgent>;\n  selfManagedAgents?: Record<string, AbstractAgent>;\n  renderToolCalls?: ReactToolCallRenderer<any>[];\n  renderActivityMessages?: ReactActivityMessageRenderer<any>[];\n  renderCustomMessages?: ReactCustomMessageRenderer[];\n  frontendTools?: ReactFrontendTool[];\n  humanInTheLoop?: ReactHumanInTheLoop[];\n  showDevConsole?: boolean | \"auto\";\n  /**\n   * Error handler called when CopilotKit encounters an error.\n   * Fires for all error types (runtime connection failures, agent errors, tool errors).\n   */\n  onError?: (event: {\n    error: Error;\n    code: CopilotKitCoreErrorCode;\n    context: Record<string, any>;\n  }) => void | Promise<void>;\n}\n\n// Small helper to normalize array props to a stable reference and warn\nfunction useStableArrayProp<T>(\n  prop: T[] | undefined,\n  warningMessage?: string,\n  isMeaningfulChange?: (initial: T[], next: T[]) => boolean,\n): T[] {\n  const empty = useMemo<T[]>(() => [], []);\n  const value = prop ?? empty;\n  const initial = useRef(value);\n\n  useEffect(() => {\n    if (\n      warningMessage &&\n      value !== initial.current &&\n      (isMeaningfulChange ? isMeaningfulChange(initial.current, value) : true)\n    ) {\n      console.error(warningMessage);\n    }\n  }, [value, warningMessage]);\n\n  return value;\n}\n\n// Provider component\nexport const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({\n  children,\n  runtimeUrl,\n  headers = {},\n  credentials,\n  publicApiKey,\n  publicLicenseKey,\n  properties = {},\n  agents__unsafe_dev_only: agents = {},\n  selfManagedAgents = {},\n  renderToolCalls,\n  renderActivityMessages,\n  renderCustomMessages,\n  frontendTools,\n  humanInTheLoop,\n  showDevConsole = false,\n  useSingleEndpoint = false,\n  onError,\n}) => {\n  const [shouldRenderInspector, setShouldRenderInspector] = useState(false);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    if (showDevConsole === true) {\n      // Explicitly show the inspector\n      setShouldRenderInspector(true);\n    } else if (showDevConsole === \"auto\") {\n      // Show on localhost or 127.0.0.1 only\n      const localhostHosts = new Set([\"localhost\", \"127.0.0.1\"]);\n      if (localhostHosts.has(window.location.hostname)) {\n        setShouldRenderInspector(true);\n      } else {\n        setShouldRenderInspector(false);\n      }\n    } else {\n      // showDevConsole is false or undefined (default false)\n      setShouldRenderInspector(false);\n    }\n  }, [showDevConsole]);\n\n  // Normalize array props to stable references with clear dev warnings\n  const renderToolCallsList = useStableArrayProp<ReactToolCallRenderer<any>>(\n    renderToolCalls,\n    \"renderToolCalls must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n    (initial, next) => {\n      // Only warn if the shape (names+agentId) changed. Allow identity changes\n      // to support updated closures from parents (e.g., Storybook state).\n      const key = (rc?: ReactToolCallRenderer<unknown>) =>\n        `${rc?.agentId ?? \"\"}:${rc?.name ?? \"\"}`;\n      const setFrom = (arr: ReactToolCallRenderer<unknown>[]) =>\n        new Set(arr.map(key));\n      const a = setFrom(initial);\n      const b = setFrom(next);\n      if (a.size !== b.size) return true;\n      for (const k of a) if (!b.has(k)) return true;\n      return false;\n    },\n  );\n\n  const renderCustomMessagesList =\n    useStableArrayProp<ReactCustomMessageRenderer>(\n      renderCustomMessages,\n      \"renderCustomMessages must be a stable array.\",\n    );\n\n  const renderActivityMessagesList = useStableArrayProp<\n    ReactActivityMessageRenderer<any>\n  >(renderActivityMessages, \"renderActivityMessages must be a stable array.\");\n\n  // Built-in activity renderers that are always included\n  const builtInActivityRenderers = useMemo<ReactActivityMessageRenderer<any>[]>(\n    () => [\n      {\n        activityType: MCPAppsActivityType,\n        content: MCPAppsActivityContentSchema,\n        render: MCPAppsActivityRenderer,\n      },\n    ],\n    [],\n  );\n\n  // Combine user-provided activity renderers with built-in ones\n  // User-provided renderers take precedence (come first) so they can override built-ins\n  const allActivityRenderers = useMemo(() => {\n    return [...renderActivityMessagesList, ...builtInActivityRenderers];\n  }, [renderActivityMessagesList, builtInActivityRenderers]);\n\n  const resolvedPublicKey = publicApiKey ?? publicLicenseKey;\n  const mergedAgents = useMemo(\n    () => ({ ...agents, ...selfManagedAgents }),\n    [agents, selfManagedAgents],\n  );\n  const hasLocalAgents = mergedAgents && Object.keys(mergedAgents).length > 0;\n\n  // Merge a provided publicApiKey into headers (without overwriting an explicit header).\n  const mergedHeaders = useMemo(() => {\n    if (!resolvedPublicKey) return headers;\n    if (headers[HEADER_NAME]) return headers;\n    return {\n      ...headers,\n      [HEADER_NAME]: resolvedPublicKey,\n    };\n  }, [headers, resolvedPublicKey]);\n\n  if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {\n    const message =\n      \"Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'\";\n    if (process.env.NODE_ENV === \"production\") {\n      throw new Error(message);\n    } else {\n      // In dev/test we warn but allow to facilitate local agents and unit tests.\n      console.warn(message);\n    }\n  }\n\n  const chatApiEndpoint =\n    runtimeUrl ?? (resolvedPublicKey ? COPILOT_CLOUD_CHAT_URL : undefined);\n\n  const frontendToolsList = useStableArrayProp<ReactFrontendTool>(\n    frontendTools,\n    \"frontendTools must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead.\",\n  );\n  const humanInTheLoopList = useStableArrayProp<ReactHumanInTheLoop>(\n    humanInTheLoop,\n    \"humanInTheLoop must be a stable array. If you want to dynamically add or remove human-in-the-loop tools, use `useHumanInTheLoop` instead.\",\n  );\n\n  // Note: warnings for array identity changes are handled by useStableArrayProp\n\n  // Process humanInTheLoop tools to create handlers and add render components\n  const processedHumanInTheLoopTools = useMemo(() => {\n    const processedTools: FrontendTool[] = [];\n    const processedRenderToolCalls: ReactToolCallRenderer<unknown>[] = [];\n\n    humanInTheLoopList.forEach((tool) => {\n      // Create a promise-based handler for each human-in-the-loop tool\n      const frontendTool: FrontendTool = {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.parameters,\n        followUp: tool.followUp,\n        ...(tool.agentId && { agentId: tool.agentId }),\n        handler: async () => {\n          // This handler will be replaced by the hook when it runs\n          // For provider-level tools, we create a basic handler that waits for user interaction\n          return new Promise((resolve) => {\n            // The actual implementation will be handled by the render component\n            // This is a placeholder that the hook will override\n            console.warn(\n              `Human-in-the-loop tool '${tool.name}' called but no interactive handler is set up.`,\n            );\n            resolve(undefined);\n          });\n        },\n      };\n      processedTools.push(frontendTool);\n\n      // Add the render component to renderToolCalls\n      if (tool.render) {\n        processedRenderToolCalls.push({\n          name: tool.name,\n          args: tool.parameters!,\n          render: tool.render,\n          ...(tool.agentId && { agentId: tool.agentId }),\n        } as ReactToolCallRenderer<unknown>);\n      }\n    });\n\n    return { tools: processedTools, renderToolCalls: processedRenderToolCalls };\n  }, [humanInTheLoopList]);\n\n  // Combine all tools for CopilotKitCore\n  const allTools = useMemo(() => {\n    const tools: FrontendTool[] = [];\n\n    // Add frontend tools\n    tools.push(...frontendToolsList);\n\n    // Add processed human-in-the-loop tools\n    tools.push(...processedHumanInTheLoopTools.tools);\n\n    return tools;\n  }, [frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Combine all render tool calls\n  const allRenderToolCalls = useMemo(() => {\n    const combined: ReactToolCallRenderer<unknown>[] = [...renderToolCallsList];\n\n    // Add render components from frontend tools\n    frontendToolsList.forEach((tool) => {\n      if (tool.render) {\n        // For wildcard tools without parameters, default to z.any()\n        const args =\n          tool.parameters || (tool.name === \"*\" ? z.any() : undefined);\n        if (args) {\n          combined.push({\n            name: tool.name,\n            args: args,\n            render: tool.render,\n          } as ReactToolCallRenderer<unknown>);\n        }\n      }\n    });\n\n    // Add render components from human-in-the-loop tools\n    combined.push(...processedHumanInTheLoopTools.renderToolCalls);\n\n    return combined;\n  }, [renderToolCallsList, frontendToolsList, processedHumanInTheLoopTools]);\n\n  // Stable instance: created once for the provider lifetime.\n  // Updates are applied via setter effects below rather than recreating the instance.\n  const copilotkitRef = useRef<CopilotKitCoreReact | null>(null);\n  if (copilotkitRef.current === null) {\n    copilotkitRef.current = new CopilotKitCoreReact({\n      runtimeUrl: chatApiEndpoint,\n      runtimeTransport: useSingleEndpoint ? \"single\" : \"rest\",\n      headers: mergedHeaders,\n      credentials,\n      properties,\n      agents__unsafe_dev_only: mergedAgents,\n      tools: allTools,\n      renderToolCalls: allRenderToolCalls,\n      renderActivityMessages: allActivityRenderers,\n      renderCustomMessages: renderCustomMessagesList,\n    });\n  }\n  const copilotkit = copilotkitRef.current;\n\n  // Subscribe to render tool calls changes to force re-renders\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onRenderToolCallsChanged: () => {\n        forceUpdate();\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // Track executing tool call IDs at the provider level.\n  // This is critical for HITL reconnection: when connecting to a thread with\n  // pending tool calls, the onToolExecutionStart event fires before child components\n  // (like CopilotChatToolCallsView) mount. By tracking at the provider level,\n  // we ensure the executing state is captured and available when children mount.\n  const [executingToolCallIds, setExecutingToolCallIds] = useState<\n    ReadonlySet<string>\n  >(() => new Set());\n\n  useEffect(() => {\n    const subscription = copilotkit.subscribe({\n      onToolExecutionStart: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.add(toolCallId);\n          return next;\n        });\n      },\n      onToolExecutionEnd: ({ toolCallId }) => {\n        setExecutingToolCallIds((prev) => {\n          if (!prev.has(toolCallId)) return prev;\n          const next = new Set(prev);\n          next.delete(toolCallId);\n          return next;\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  // onError subscription — forward core errors to user callback\n  const onErrorRef = useRef(onError);\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n\n  useEffect(() => {\n    if (!onErrorRef.current) return;\n\n    const subscription = copilotkit.subscribe({\n      onError: (event) => {\n        onErrorRef.current?.({\n          error: event.error,\n          code: event.code,\n          context: event.context,\n        });\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit]);\n\n  useEffect(() => {\n    copilotkit.setRuntimeUrl(chatApiEndpoint);\n    copilotkit.setRuntimeTransport(useSingleEndpoint ? \"single\" : \"rest\");\n    copilotkit.setHeaders(mergedHeaders);\n    copilotkit.setCredentials(credentials);\n    copilotkit.setProperties(properties);\n    copilotkit.setAgents__unsafe_dev_only(mergedAgents);\n  }, [\n    copilotkit,\n    chatApiEndpoint,\n    mergedHeaders,\n    credentials,\n    properties,\n    mergedAgents,\n    useSingleEndpoint,\n  ]);\n\n  // Sync render/tool arrays to the stable instance via setters.\n  // On mount, the constructor already receives the correct initial values,\n  // so we skip the first invocation. This is critical because child hooks\n  // (e.g., useFrontendTool, useHumanInTheLoop) register tools dynamically\n  // via addTool()/setRenderToolCalls() in their own effects, which fire\n  // BEFORE parent effects (React fires effects bottom-up). If the parent\n  // setter effects ran on mount, they would overwrite the children's tools.\n  const didMountRef = useRef(false);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setTools(allTools);\n  }, [copilotkit, allTools]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderToolCalls(allRenderToolCalls);\n  }, [copilotkit, allRenderToolCalls]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderActivityMessages(allActivityRenderers);\n  }, [copilotkit, allActivityRenderers]);\n\n  useEffect(() => {\n    if (!didMountRef.current) return;\n    copilotkit.setRenderCustomMessages(renderCustomMessagesList);\n  }, [copilotkit, renderCustomMessagesList]);\n\n  // Mark mount complete — must be declared AFTER the setter effects\n  // so it runs last in the effect queue on the initial mount cycle.\n  useEffect(() => {\n    didMountRef.current = true;\n  }, []);\n\n  const contextValue = useMemo<CopilotKitContextValue>(\n    () => ({ copilotkit, executingToolCallIds }),\n    [copilotkit, executingToolCallIds],\n  );\n\n  return (\n    <CopilotKitContext.Provider value={contextValue}>\n      {children}\n      {shouldRenderInspector ? <CopilotKitInspector core={copilotkit} /> : null}\n    </CopilotKitContext.Provider>\n  );\n};\n\n// Hook to use the CopilotKit instance - returns the full context value\nexport const useCopilotKit = (): CopilotKitContextValue => {\n  const context = useContext(CopilotKitContext);\n  const [, forceUpdate] = useReducer((x) => 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    });\n    return () => {\n      subscription.unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return context;\n};\n"],"mappings":"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"}