@copilotkit/vue 1.67.0 → 1.68.0

package/dist/v2/components/chat/CopilotChat.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotChat.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/components/chat/CopilotChat.vue"],"names":[],"mappings":"AAkzBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,6BAA6B,EAC7B,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,SAAS,CAAC;AAcjB,KAAK,WAAW,GAAG;IACjB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,OAAO,CAAC;IACnE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,KAAK,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC;IAC9D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,OAAO,CAAC;IACtD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC;IAC3E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,OAAO,CAAC;IACzE,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAElC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CACtD,CAAC;AA2yBF,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;6EAQnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CopilotChat.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/components/chat/CopilotChat.vue"],"names":[],"mappings":"AA+zBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,6BAA6B,EAC7B,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,SAAS,CAAC;AAcjB,KAAK,WAAW,GAAG;IACjB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,OAAO,CAAC;IACnE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,KAAK,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC;IAC9D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,OAAO,CAAC;IACtD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC;IAC3E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,OAAO,CAAC;IACzE,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAElC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CACtD,CAAC;AAwzBF,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;6EAQnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/v2/components/chat/CopilotChatMessageView.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotChatMessageView.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/components/chat/CopilotChatMessageView.vue"],"names":[],"mappings":"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"}
+{"version":3,"file":"CopilotChatMessageView.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/components/chat/CopilotChatMessageView.vue"],"names":[],"mappings":"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"}

package/dist/v2/hooks/use-agent.d.ts

@@ -5,9 +5,7 @@ export declare enum UseAgentUpdate {
     OnStateChanged = "OnStateChanged",
     OnRunStatusChanged = "OnRunStatusChanged"
 }
-export interface UseAgentProps {
-    agentId?: MaybeRefOrGetter<string | undefined>;
-    threadId?: MaybeRefOrGetter<string | undefined>;
+interface UseAgentPropsBase {
     updates?: UseAgentUpdate[];
     /**
      * Throttle interval (in milliseconds) for re-renders triggered by
@@ -33,8 +31,70 @@ export interface UseAgentProps {
      */
     throttleMs?: MaybeRefOrGetter<number | undefined>;
 }
-export declare const globalThreadCloneMap: WeakMap<AbstractAgent, Map<string, AbstractAgent>>;
-export declare function getThreadClone(registryAgent: AbstractAgent | undefined | null, threadId: string | undefined | null): AbstractAgent | undefined;
+/**
+ * Thread-scoped variant. `agentId`, `runtimeAgentId` and `threadId` are a matched
+ * set: together they give this hook a private proxied agent — registered under the
+ * local `agentId`, routing outbound to `runtimeAgentId` — that is safe to pin a
+ * thread onto. Mirrors React's `UseAgentThreadScopedProps`.
+ */
+interface UseAgentThreadScopedProps {
+    /**
+     * The *local* registry id to register this hook's proxied agent under. Required
+     * here: the usual fallbacks (chat configuration, then `DEFAULT_AGENT_ID`) name
+     * agents that already exist, and registering over one of those throws.
+     */
+    agentId: MaybeRefOrGetter<string>;
+    /**
+     * The runtime agent to route outbound requests to while this hook exposes a
+     * distinct local `agentId`. Registers a proxied agent via
+     * `CopilotKitCore.registerProxiedAgent`, so several frontend agents (e.g. one
+     * per open thread) can mount against one runtime agent.
+     *
+     * REQUIRES `threadId` — a private agent with no thread to scope behaves like
+     * the shared one, minus a registration and a local id to keep unique.
+     */
+    runtimeAgentId: MaybeRefOrGetter<string>;
+    /**
+     * Thread to scope the agent's run to. Written onto the underlying agent, so
+     * `/agent/run`, `/agent/connect` and `/agent/stop` address this thread.
+     *
+     * REQUIRES `runtimeAgentId` — an agent resolved by `agentId` alone is shared,
+     * so a per-hook thread written onto it would clobber every other holder.
+     */
+    threadId: MaybeRefOrGetter<string>;
+}
+/**
+ * Default variant: no thread scoping. Binds to the shared agent registered under
+ * `agentId` and takes its thread from the surrounding chat configuration, gated
+ * on `hasExplicitThreadId`. Mirrors React's `UseAgentUnscopedProps`.
+ *
+ * `threadId` and `runtimeAgentId` are typed `undefined` rather than omitted so
+ * that supplying either alone matches *neither* branch — that is the type-level
+ * enforcement of the all-or-nothing rule.
+ */
+interface UseAgentUnscopedProps {
+    /**
+     * Agent to bind to. Resolution precedence: this property, then the surrounding
+     * chat configuration's agentId, then the global default.
+     */
+    agentId?: MaybeRefOrGetter<string | undefined>;
+    /** Requires `runtimeAgentId`. See {@link UseAgentThreadScopedProps.threadId}. */
+    threadId?: undefined;
+    /** Requires `threadId`. See {@link UseAgentThreadScopedProps.runtimeAgentId}. */
+    runtimeAgentId?: undefined;
+}
+/**
+ * Props for {@link useAgent}. Two valid shapes, nothing in between:
+ *
+ * - **Bind to an agent** — `useAgent()`, `useAgent({ agentId })`. The shared
+ *   registry instance; the thread comes from the chat configuration.
+ * - **Bind a private agent to a thread** —
+ *   `useAgent({ agentId, runtimeAgentId, threadId })`. All three required.
+ *
+ * So `{ agentId, threadId }`, `{ agentId, runtimeAgentId }` and
+ * `{ runtimeAgentId, threadId }` are all compile errors, matching React.
+ */
+export type UseAgentProps = UseAgentPropsBase & (UseAgentThreadScopedProps | UseAgentUnscopedProps);
 /**
  * Resolves and subscribes to a CopilotKit agent for the current Vue scope.
  *
@@ -50,4 +110,5 @@ export declare function getThreadClone(registryAgent: AbstractAgent | undefined
 export declare function useAgent(props?: UseAgentProps): {
     agent: import("vue").ShallowRef<AbstractAgent | null, AbstractAgent | null>;
 };
+export {};
 //# sourceMappingURL=use-agent.d.ts.map

package/dist/v2/hooks/use-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/use-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAYnD,oBAAY,cAAc;IACxB,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;CAC1C;AAQD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAwBD,eAAO,MAAM,oBAAoB,oDAG9B,CAAC;AAEJ,wBAAgB,cAAc,CAC5B,aAAa,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,EAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAClC,aAAa,GAAG,SAAS,CAG3B;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,aAAkB;;EA0NjD"}
+{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/use-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAYnD,oBAAY,cAAc;IACxB,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;CAC1C;AAQD,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,UAAU,yBAAyB;IACjC;;;;OAIG;IACH,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC;;;;;;;;OAQG;IACH,cAAc,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,UAAU,qBAAqB;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iFAAiF;IACjF,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CAAC,yBAAyB,GAAG,qBAAqB,CAAC,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,aAAkB;;EAmVjD"}

package/dist/v2/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@copilotkit/core"),i=require("@ag-ui/client"),e=require("../use-render-activity-message-CNbp9Fob.cjs"),n=require("@copilotkit/shared");exports.A2UIActivityContentSchema=e.A2UIActivityContentSchema;exports.A2UISurfaceActivityRenderer=e._sfc_main;exports.A2UISurfaceActivityType=e.A2UISurfaceActivityType;exports.CopilotChat=e.CopilotChat;exports.CopilotChatAssistantMessage=e._sfc_main$1;exports.CopilotChatAttachmentQueue=e._sfc_main$2;exports.CopilotChatAttachmentRenderer=e._sfc_main$3;exports.CopilotChatAudioRecorder=e._sfc_main$4;exports.CopilotChatConfigurationProvider=e._sfc_main$5;exports.CopilotChatDefaultLabels=e.CopilotChatDefaultLabels;exports.CopilotChatInput=e._sfc_main$6;exports.CopilotChatMessageView=e._sfc_main$7;exports.CopilotChatReasoningMessage=e._sfc_main$8;exports.CopilotChatSuggestionPill=e._sfc_main$9;exports.CopilotChatSuggestionView=e._sfc_main$10;exports.CopilotChatToggleButton=e.CopilotChatToggleButton;exports.CopilotChatToggleButtonCloseIcon=e.CopilotChatToggleButtonCloseIcon;exports.CopilotChatToggleButtonOpenIcon=e.CopilotChatToggleButtonOpenIcon;exports.CopilotChatToolCallsView=e._sfc_main$11;exports.CopilotChatUserMessage=e._sfc_main$12;exports.CopilotChatView=e._sfc_main$13;exports.CopilotKitCoreVue=e.CopilotKitCoreVue;exports.CopilotKitInspector=e._sfc_main$14;exports.CopilotKitProvider=e._sfc_main$15;exports.CopilotModalHeader=e.CopilotModalHeader;exports.CopilotPopup=e._sfc_main$16;exports.CopilotPopupView=e.CopilotPopupView;exports.CopilotSidebar=e._sfc_main$17;exports.CopilotSidebarView=e.CopilotSidebarView;exports.CopilotThreadsDrawer=e._sfc_main$18;exports.GenerateSandboxedUiArgsSchema=e.GenerateSandboxedUiArgsSchema;exports.LicenseContextKey=e.LicenseContextKey;exports.MCPAppsActivityContentSchema=e.MCPAppsActivityContentSchema;exports.MCPAppsActivityRenderer=e.MCPAppsActivityRenderer;exports.MCPAppsActivityType=e.MCPAppsActivityType;exports.OpenGenerativeUIActivityRenderer=e.OpenGenerativeUIActivityRenderer;exports.OpenGenerativeUIActivityType=e.OpenGenerativeUIActivityType;exports.OpenGenerativeUIContentSchema=e.OpenGenerativeUIContentSchema;exports.OpenGenerativeUIRenderer=e.OpenGenerativeUIRenderer;exports.OpenGenerativeUIToolRenderer=e.OpenGenerativeUIToolRenderer;exports.UseAgentUpdate=e.UseAgentUpdate;exports.createA2UIMessageRenderer=e.createA2UIMessageRenderer;exports.createDefaultLicenseRef=e.createDefaultLicenseRef;exports.defineToolCallRenderer=e.defineToolCallRenderer;exports.extractCompleteStyles=e.extractCompleteStyles;exports.getOperationSurfaceId=e.getOperationSurfaceId;exports.processPartialHtml=e.processPartialHtml;exports.useAgent=e.useAgent;exports.useAgentContext=e.useAgentContext;exports.useAttachments=e.useAttachments;exports.useCapabilities=e.useCapabilities;exports.useComponent=e.useComponent;exports.useConfigureSuggestions=e.useConfigureSuggestions;exports.useCopilotChatConfiguration=e.useCopilotChatConfiguration;exports.useCopilotKit=e.useCopilotKit;exports.useDefaultRenderTool=e.useDefaultRenderTool;exports.useFrontendTool=e.useFrontendTool;exports.useHumanInTheLoop=e.useHumanInTheLoop;exports.useInterrupt=e.useInterrupt;exports.useKatexStyles=e.useKatexStyles;exports.useKeyboardHeight=e.useKeyboardHeight;exports.useLicenseContext=e.useLicenseContext;exports.useRenderActivityMessage=e.useRenderActivityMessage;exports.useRenderCustomMessages=e.useRenderCustomMessages;exports.useRenderTool=e.useRenderTool;exports.useSandboxFunctions=e.useSandboxFunctions;exports.useSuggestions=e.useSuggestions;exports.useThreads=e.useThreads;exports.vueBasicCatalog=e.vueBasicCatalog;Object.defineProperty(exports,"createLicenseContextValue",{enumerable:!0,get:()=>n.createLicenseContextValue});Object.keys(o).forEach(t=>{t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:()=>o[t]})});Object.keys(i).forEach(t=>{t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:()=>i[t]})});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@copilotkit/core"),i=require("@ag-ui/client"),e=require("../use-render-activity-message-bkrPa-92.cjs"),n=require("@copilotkit/shared");exports.A2UIActivityContentSchema=e.A2UIActivityContentSchema;exports.A2UISurfaceActivityRenderer=e._sfc_main;exports.A2UISurfaceActivityType=e.A2UISurfaceActivityType;exports.CopilotChat=e.CopilotChat;exports.CopilotChatAssistantMessage=e._sfc_main$1;exports.CopilotChatAttachmentQueue=e._sfc_main$2;exports.CopilotChatAttachmentRenderer=e._sfc_main$3;exports.CopilotChatAudioRecorder=e._sfc_main$4;exports.CopilotChatConfigurationProvider=e._sfc_main$5;exports.CopilotChatDefaultLabels=e.CopilotChatDefaultLabels;exports.CopilotChatInput=e._sfc_main$6;exports.CopilotChatMessageView=e._sfc_main$7;exports.CopilotChatReasoningMessage=e._sfc_main$8;exports.CopilotChatSuggestionPill=e._sfc_main$9;exports.CopilotChatSuggestionView=e._sfc_main$10;exports.CopilotChatToggleButton=e.CopilotChatToggleButton;exports.CopilotChatToggleButtonCloseIcon=e.CopilotChatToggleButtonCloseIcon;exports.CopilotChatToggleButtonOpenIcon=e.CopilotChatToggleButtonOpenIcon;exports.CopilotChatToolCallsView=e._sfc_main$11;exports.CopilotChatUserMessage=e._sfc_main$12;exports.CopilotChatView=e._sfc_main$13;exports.CopilotKitCoreVue=e.CopilotKitCoreVue;exports.CopilotKitInspector=e._sfc_main$14;exports.CopilotKitProvider=e._sfc_main$15;exports.CopilotModalHeader=e.CopilotModalHeader;exports.CopilotPopup=e._sfc_main$16;exports.CopilotPopupView=e.CopilotPopupView;exports.CopilotSidebar=e._sfc_main$17;exports.CopilotSidebarView=e.CopilotSidebarView;exports.CopilotThreadsDrawer=e._sfc_main$18;exports.GenerateSandboxedUiArgsSchema=e.GenerateSandboxedUiArgsSchema;exports.LicenseContextKey=e.LicenseContextKey;exports.MCPAppsActivityContentSchema=e.MCPAppsActivityContentSchema;exports.MCPAppsActivityRenderer=e.MCPAppsActivityRenderer;exports.MCPAppsActivityType=e.MCPAppsActivityType;exports.OpenGenerativeUIActivityRenderer=e.OpenGenerativeUIActivityRenderer;exports.OpenGenerativeUIActivityType=e.OpenGenerativeUIActivityType;exports.OpenGenerativeUIContentSchema=e.OpenGenerativeUIContentSchema;exports.OpenGenerativeUIRenderer=e.OpenGenerativeUIRenderer;exports.OpenGenerativeUIToolRenderer=e.OpenGenerativeUIToolRenderer;exports.UseAgentUpdate=e.UseAgentUpdate;exports.createA2UIMessageRenderer=e.createA2UIMessageRenderer;exports.createDefaultLicenseRef=e.createDefaultLicenseRef;exports.defineToolCallRenderer=e.defineToolCallRenderer;exports.extractCompleteStyles=e.extractCompleteStyles;exports.getOperationSurfaceId=e.getOperationSurfaceId;exports.processPartialHtml=e.processPartialHtml;exports.useAgent=e.useAgent;exports.useAgentContext=e.useAgentContext;exports.useAttachments=e.useAttachments;exports.useCapabilities=e.useCapabilities;exports.useComponent=e.useComponent;exports.useConfigureSuggestions=e.useConfigureSuggestions;exports.useCopilotChatConfiguration=e.useCopilotChatConfiguration;exports.useCopilotKit=e.useCopilotKit;exports.useDefaultRenderTool=e.useDefaultRenderTool;exports.useFrontendTool=e.useFrontendTool;exports.useHumanInTheLoop=e.useHumanInTheLoop;exports.useInterrupt=e.useInterrupt;exports.useKatexStyles=e.useKatexStyles;exports.useKeyboardHeight=e.useKeyboardHeight;exports.useLicenseContext=e.useLicenseContext;exports.useRenderActivityMessage=e.useRenderActivityMessage;exports.useRenderCustomMessages=e.useRenderCustomMessages;exports.useRenderTool=e.useRenderTool;exports.useSandboxFunctions=e.useSandboxFunctions;exports.useSuggestions=e.useSuggestions;exports.useThreads=e.useThreads;exports.vueBasicCatalog=e.vueBasicCatalog;Object.defineProperty(exports,"createLicenseContextValue",{enumerable:!0,get:()=>n.createLicenseContextValue});Object.keys(o).forEach(t=>{t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:()=>o[t]})});Object.keys(i).forEach(t=>{t!=="default"&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:()=>i[t]})});
 //# sourceMappingURL=index.cjs.map

package/dist/v2/index.mjs

@@ -1,6 +1,6 @@
 export * from "@copilotkit/core";
 export * from "@ag-ui/client";
-import { A as o, _ as i, a as n, C, b as r, c as p, d as l, e as u, f as c, g, h as d, i as h, j as A, k as v, l as S, m, n as y, o as I, p as f, q as R, r as T, s as U, t as x, u as M, v as P, w as b, x as V, y as w, z as K, B as O, G, L, M as B, D, E as H, O as F, F as Q, H as j, I as k, J as q, U as z, K as E, N as J, P as N, Q as W, R as X, S as Y, T as Z, V as _, W as $, X as ee, Y as ae, Z as te, $ as se, a0 as oe, a1 as ie, a2 as ne, a3 as Ce, a4 as re, a5 as pe, a6 as le, a7 as ue, a8 as ce, a9 as ge, aa as de, ab as he, ac as Ae, ad as ve, ae as Se } from "../use-render-activity-message-CaArNmtw.js";
+import { A as o, _ as i, a as n, C, b as r, c as p, d as l, e as u, f as c, g, h as d, i as h, j as A, k as v, l as S, m, n as y, o as I, p as f, q as R, r as T, s as U, t as x, u as M, v as P, w as b, x as V, y as w, z as K, B as O, G, L, M as B, D, E as H, O as F, F as Q, H as j, I as k, J as q, U as z, K as E, N as J, P as N, Q as W, R as X, S as Y, T as Z, V as _, W as $, X as ee, Y as ae, Z as te, $ as se, a0 as oe, a1 as ie, a2 as ne, a3 as Ce, a4 as re, a5 as pe, a6 as le, a7 as ue, a8 as ce, a9 as ge, aa as de, ab as he, ac as Ae, ad as ve, ae as Se } from "../use-render-activity-message-DljRBrXN.js";
 import { createLicenseContextValue as ye } from "@copilotkit/shared";
 export {
   o as A2UIActivityContentSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/vue",
-  "version": "1.67.0",
+  "version": "1.68.0",
   "private": false,
   "description": "Vue 3 components and composables for CopilotKit",
   "keywords": [
@@ -70,10 +70,10 @@
     "streamdown-vue": "^1.0.29",
     "zod": "^3.25.75",
     "zod-to-json-schema": "^3.24.5",
-    "@copilotkit/core": "1.67.0",
-    "@copilotkit/web-components": "1.67.0",
-    "@copilotkit/shared": "1.67.0",
-    "@copilotkit/web-inspector": "1.67.0"
+    "@copilotkit/core": "1.68.0",
+    "@copilotkit/shared": "1.68.0",
+    "@copilotkit/web-components": "1.68.0",
+    "@copilotkit/web-inspector": "1.68.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/src/v2/components/chat/CopilotChat.vue

@@ -141,9 +141,12 @@ const isConnecting = computed(
 const stableLabels = useShallowStableRef(computed(() => props.labels));
 const resolvedLabels = computed(() => stableLabels.value);
 
+// `useAgent` takes no threadId: it pins one only from a surrounding chat
+// configuration, and this call sits outside the provider rendered in this
+// component's template, so it would never see the thread being rendered. The
+// thread is assigned in the connect watcher below, mirroring React's CopilotChat.
 const { agent } = useAgent({
   agentId: resolvedAgentId,
-  threadId: resolvedThreadId,
   throttleMs: computed(() => props.throttleMs),
 });
 const { suggestions: autoSuggestions } = useSuggestions({
@@ -312,6 +315,16 @@ watch(
     if (!currentAgent) {
       return;
     }
+
+    // Pin the thread this chat renders onto its agent, before anything issues a
+    // request. `CopilotKitCore.connectAgent` reads `agent.threadId` synchronously
+    // to decide whether this is a fresh restore, so a later assignment would let
+    // /connect address the previous thread. Assigning inside this callback — as
+    // React does — makes the ordering unconditional instead of depending on
+    // watcher scheduling. Non-explicit threads skip /connect below, but the first
+    // runAgent still has to ship the thread the UI is rendering.
+    currentAgent.threadId = threadId;
+
     // When the caller hasn't picked a specific thread, resolvedThreadId is
     // a UUID minted locally. The backend has never seen it, so /connect
     // would always 404 — skip the call. A real thread is only created

package/src/v2/components/chat/CopilotChatMessageView.vue

@@ -14,7 +14,6 @@ import type {
   InterruptRenderProps,
   VueCustomMessageRendererProps,
 } from "../../types";
-import { getThreadClone } from "../../hooks/use-agent";
 import { useCopilotKit } from "../../providers/useCopilotKit";
 import { useCopilotChatConfiguration } from "../../providers/useCopilotChatConfiguration";
 import CopilotChatAssistantMessage from "./CopilotChatAssistantMessage.vue";
@@ -105,9 +104,9 @@ const resolvedAgentId = computed(
   () => config.value?.agentId ?? DEFAULT_AGENT_ID,
 );
 const resolvedThreadAgent = computed(() => {
-  const agentId = resolvedAgentId.value;
-  const registryAgent = copilotkit.value.getAgent(agentId);
-  return getThreadClone(registryAgent, config.value?.threadId) ?? registryAgent;
+  // Read the registry so this recomputes when agents are added or replaced.
+  void copilotkit.value.agents;
+  return copilotkit.value.getAgent(resolvedAgentId.value);
 });
 
 watch(
@@ -117,9 +116,8 @@ watch(
     () => copilotkit.value,
     () => copilotkit.value.runtimeConnectionStatus,
   ],
-  ([_agentId, threadId], _prev, onCleanup) => {
-    const registryAgent = copilotkit.value.getAgent(resolvedAgentId.value);
-    const agent = getThreadClone(registryAgent, threadId) ?? registryAgent;
+  (_values, _prev, onCleanup) => {
+    const agent = resolvedThreadAgent.value;
     if (!agent) return;
 
     const sub = agent.subscribe({

package/src/v2/components/chat/__tests__/CopilotChat.clearOnFresh.test.ts

@@ -7,7 +7,6 @@ import { useCopilotChatConfiguration } from "../../../providers/useCopilotChatCo
 import { useCopilotKit } from "../../../providers/useCopilotKit";
 import { StateCapturingAgent } from "../../../__tests__/utils/agents";
 import CopilotChat from "../CopilotChat.vue";
-import { getThreadClone } from "../../../hooks/use-agent";
 
 // Proves the clear-on-fresh watch introduced in CopilotChat.vue:
 //   - does NOT clear messages on initial mount
@@ -17,6 +16,9 @@ import { getThreadClone } from "../../../hooks/use-agent";
 describe("CopilotChat clear-on-fresh", () => {
   it("does not clear messages on initial mount", async () => {
     const agent = new StateCapturingAgent();
+    // Spy before mount: attaching afterwards can never observe a mount-time
+    // clear, which is exactly what this test exists to rule out.
+    const setMessagesSpy = vi.spyOn(agent, "setMessages");
 
     let core:
       | ReturnType<typeof useCopilotKit>["copilotkit"]["value"]
@@ -49,15 +51,9 @@ describe("CopilotChat clear-on-fresh", () => {
     await flushPromises();
     await nextTick();
 
-    const registryAgent = core?.getAgent("default");
-    const resolvedAgent = getThreadClone(registryAgent, "seed");
+    const resolvedAgent = core?.getAgent("default");
     expect(resolvedAgent).toBeDefined();
-
-    // Attach the spy only after mount has settled so the clone's own
-    // construction-time `setMessages([])` reset (in `cloneForThread`,
-    // unrelated to the clear-on-fresh watch) isn't mistaken for a clear.
-    const setMessagesSpy = vi.spyOn(resolvedAgent!, "setMessages");
-    await nextTick();
+    expect(setMessagesSpy).not.toHaveBeenCalled();
 
     expect(setMessagesSpy).not.toHaveBeenCalled();
   });
@@ -110,7 +106,7 @@ describe("CopilotChat clear-on-fresh", () => {
     await nextTick();
 
     const registryAgent = core?.getAgent("default");
-    const seedAgent = getThreadClone(registryAgent, "seed");
+    const seedAgent = registryAgent;
     expect(seedAgent).toBeDefined();
     expect(currentThreadId).toBe("seed");
 
@@ -122,19 +118,15 @@ describe("CopilotChat clear-on-fresh", () => {
     expect(currentThreadId).toBeDefined();
     expect(currentThreadId).not.toBe("seed");
     const newAgentThreadId = currentThreadId!;
-    const newAgent = getThreadClone(registryAgent, newAgentThreadId);
+    const newAgent = registryAgent;
     expect(newAgent).toBeDefined();
-    expect(newAgent).not.toBe(seedAgent);
 
-    // Primary, behavioral assertion: the new agent ends with no messages
-    // after the fresh switch (this alone doesn't distinguish the watch from
-    // clone construction, since `cloneForThread` also resets to `[]`).
+    // The agent ends with no messages after the fresh switch. With one shared
+    // instance the clear-on-fresh watch is the only thing that can empty it.
     expect(newAgent!.messages).toEqual([]);
 
-    // Move to a third, unrelated non-explicit thread so `newAgent` is no
-    // longer the active agent, then dirty it directly (bypassing
-    // `cloneForThread`'s construction reset entirely, since the clone
-    // already exists in the cache).
+    // Move to a third, unrelated non-explicit thread, then dirty the agent
+    // directly so the next transition has something real to clear.
     expect(setActiveThreadId).toBeDefined();
     setActiveThreadId!("elsewhere", { explicit: false });
     await flushPromises();
@@ -144,12 +136,9 @@ describe("CopilotChat clear-on-fresh", () => {
     newAgent!.setMessages([{ id: "m1", role: "user", content: "hi" } as never]);
     expect(newAgent!.messages.length).toBe(1);
 
-    // Switch back to `newAgent`'s thread id, non-explicitly. Because the
-    // clone already exists in the cache, `getOrCreateThreadClone` returns it
-    // without reconstructing it — so any `setMessages([])` observed here
-    // must come from the clear-on-fresh watch, not from clone construction.
-    // This fails (messages stay dirty) if the watch's
-    // `currentAgent.setMessages([])` call is removed.
+    // Switch back non-explicitly. Any `setMessages([])` observed here must come
+    // from the clear-on-fresh watch; this fails (messages stay dirty) if the
+    // watch's `currentAgent.setMessages([])` call is removed.
     setActiveThreadId!(newAgentThreadId, { explicit: false });
     await flushPromises();
     await nextTick();

package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.ts

@@ -4,7 +4,6 @@ import { h } from "vue";
 import CopilotChat from "../CopilotChat.vue";
 import { renderWithCopilotKit } from "../../../__tests__/utils/mount";
 import { StateCapturingAgent } from "../../../__tests__/utils/agents";
-import { getThreadClone } from "../../../hooks/use-agent";
 
 describe("CopilotChat.slots.e2e", () => {
   it("supports full chat-view override with callback payload", async () => {
@@ -133,7 +132,7 @@ describe("CopilotChat.slots.e2e", () => {
     await flushPromises();
 
     const registryAgent = getCore().getAgent("custom-agent");
-    const resolvedAgent = getThreadClone(registryAgent, "explicit-thread");
+    const resolvedAgent = registryAgent;
     expect(defaultAgent.messages).toHaveLength(0);
     expect(resolvedAgent?.threadId).toBe("explicit-thread");
     expect(resolvedAgent?.messages.some((m) => m.role === "user")).toBe(true);

package/src/v2/components/chat/__tests__/CopilotChat.test.ts

@@ -9,7 +9,6 @@ import { useCopilotKit } from "../../../providers/useCopilotKit";
 import { CopilotKitCoreVue } from "../../../lib/vue-core";
 import CopilotChat from "../CopilotChat.vue";
 import CopilotChatView from "../CopilotChatView.vue";
-import { getThreadClone } from "../../../hooks/use-agent";
 
 function mountChat(
   props: Record<string, unknown> = {},
@@ -178,7 +177,7 @@ describe("CopilotChat", () => {
     await flushPromises();
 
     const registryAgent = core?.getAgent("custom-agent");
-    const resolvedAgent = getThreadClone(registryAgent, "explicit-thread");
+    const resolvedAgent = registryAgent;
     expect(resolvedAgent?.threadId).toBe("explicit-thread");
     expect(resolvedAgent?.messages.some((m) => m.role === "user")).toBe(true);
     expect(defaultAgent.messages).toHaveLength(0);
@@ -230,7 +229,7 @@ describe("CopilotChat", () => {
     await flushPromises();
 
     const registryAgent = core?.getAgent("default");
-    const resolvedAgent = getThreadClone(registryAgent, "stop-thread");
+    const resolvedAgent = registryAgent;
     const abortRun = vi.fn();
     if (registryAgent) {
       registryAgent.abortRun = abortRun;

package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.ts

@@ -14,7 +14,6 @@ import { IntelligenceAgent } from "@copilotkit/core";
 import CopilotChat from "../CopilotChat.vue";
 import CopilotKitProvider from "../../../providers/CopilotKitProvider.vue";
 import CopilotChatConfigurationProvider from "../../../providers/CopilotChatConfigurationProvider.vue";
-import { getThreadClone } from "../../../hooks/use-agent";
 import { useCopilotKit } from "../../../providers/useCopilotKit";
 import { createA2UIMessageRenderer } from "../../../components/A2UIMessageRenderer";
 import {
@@ -315,7 +314,7 @@ describe("CopilotChat activity message rendering", () => {
     expect(screen.getByTestId("copilotkit-probe").textContent).toBe("true");
   });
 
-  it("passes the per-thread clone (not the registry agent) to activity message renderers", async () => {
+  it("passes the registry agent to activity message renderers", async () => {
     const agent = new MockStepwiseAgent();
     const agentId = "action-agent";
     agent.agentId = agentId;
@@ -367,10 +366,11 @@ describe("CopilotChat activity message rendering", () => {
       expect(screen.getByTestId("action-button")).toBeDefined();
     });
 
-    const clone = getThreadClone(agent, threadId);
-    expect(clone).toBeDefined();
-    expect(toRaw(capturedAgent.value!)).toBe(clone);
-    expect(toRaw(capturedAgent.value!)).not.toBe(agent);
+    // Thread cloning is gone: renderers get the registry agent, with the
+    // thread pinned onto it rather than split across per-thread copies.
+    expect(capturedAgent.value).toBeDefined();
+    expect(toRaw(capturedAgent.value!)).toBe(agent);
+    expect(toRaw(capturedAgent.value!).threadId).toBe(threadId);
   });
 
   it("restores a completed A2UI surface after reconnect from an event-native baseline", async () => {

package/src/v2/components/chat/__tests__/MCPAppsUiMessage.e2e.test.ts

@@ -53,6 +53,20 @@ class MockMCPProxyAgent extends AbstractAgent {
     await flushVueUpdates();
   }
 
+  // Records what the renderer sent. This instrumentation also exists in the
+  // `clone()` override below, which is where it used to live exclusively — back
+  // when `useAgent` handed components a per-thread clone. Thread cloning is gone,
+  // so the class records for itself; `clone()` is left intact because
+  // `CopilotKitCore`'s SuggestionEngine still clones agents.
+  addMessage(message: Parameters<AbstractAgent["addMessage"]>[0]) {
+    this.addMessageCalls.push({
+      id: message.id,
+      role: message.role,
+      content: message.content,
+    });
+    return super.addMessage(message);
+  }
+
   clone(): MockMCPProxyAgent {
     const cloned = new MockMCPProxyAgent();
     cloned.agentId = this.agentId;

package/src/v2/hooks/__tests__/use-agent-thread-pinning.test.ts

@@ -0,0 +1,179 @@
+import { defineComponent, ref, shallowRef, toRaw } from "vue";
+import { render, cleanup } from "@testing-library/vue";
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { AbstractAgent } from "@ag-ui/client";
+import type { BaseEvent } from "@ag-ui/client";
+import { CopilotKitCoreRuntimeConnectionStatus } from "@copilotkit/core";
+import { Observable } from "rxjs";
+import { useCopilotKit } from "../../providers/useCopilotKit";
+import { useCopilotChatConfiguration } from "../../providers/useCopilotChatConfiguration";
+import { useAgent } from "../use-agent";
+
+vi.mock("../../providers/useCopilotKit", () => ({
+  useCopilotKit: vi.fn(),
+}));
+vi.mock("../../providers/useCopilotChatConfiguration", () => ({
+  useCopilotChatConfiguration: vi.fn(),
+}));
+
+const mockUseCopilotKit = useCopilotKit as ReturnType<typeof vi.fn>;
+const mockUseChatConfig = useCopilotChatConfiguration as ReturnType<
+  typeof vi.fn
+>;
+
+class SimpleAgent extends AbstractAgent {
+  run(): Observable<BaseEvent> {
+    return new Observable();
+  }
+}
+
+/**
+ * Replaces `use-agent-thread-isolation.test.ts`, which pinned the per-thread
+ * *cloning* `useAgent` used to do. Cloning is gone; the hook mirrors React:
+ * one shared instance per agentId with the chat configuration's thread pinned
+ * onto it (gated on `hasExplicitThreadId`), or — with the all-or-nothing
+ * `{ agentId, runtimeAgentId, threadId }` set — a private proxied agent.
+ *
+ * The invariant under test: never a copy, and a caller-chosen thread lands on
+ * the agent while an auto-minted placeholder does not.
+ */
+describe("useAgent agent resolution", () => {
+  let registryAgent: SimpleAgent;
+  let copilotkitRef: ReturnType<typeof shallowRef>;
+
+  beforeEach(() => {
+    registryAgent = new SimpleAgent();
+    registryAgent.agentId = "my-agent";
+    // `shallowRef`, matching production (`CopilotKitProvider.vue` provides
+    // `shallowRef<CopilotKitCoreVue>`). A deep `ref` would hand the hook
+    // reactive proxies of the core and of every agent, so the identity
+    // assertions below would compare proxies rather than the real instances.
+    copilotkitRef = shallowRef({
+      getAgent: vi.fn((id: string) =>
+        id === "my-agent" ? registryAgent : undefined,
+      ),
+      runtimeUrl: "http://localhost:3000/api/copilotkit",
+      runtimeConnectionStatus: CopilotKitCoreRuntimeConnectionStatus.Connected,
+      runtimeTransport: "rest",
+      headers: {},
+      agents: { "my-agent": registryAgent },
+      defaultThrottleMs: undefined,
+      subscribeToAgentWithOptions: vi.fn(() => ({ unsubscribe: vi.fn() })),
+    });
+    mockUseCopilotKit.mockReturnValue({
+      copilotkit: copilotkitRef,
+      executingToolCallIds: ref(new Set()),
+    });
+    mockUseChatConfig.mockReturnValue(ref(null));
+  });
+
+  afterEach(() => {
+    cleanup();
+    vi.restoreAllMocks();
+  });
+
+  const mountProbe = () => {
+    let captured: AbstractAgent | null = null;
+    const Probe = defineComponent({
+      setup() {
+        captured = useAgent({ agentId: "my-agent" }).agent.value;
+        return () => null;
+      },
+    });
+    render(Probe);
+    return () => captured;
+  };
+
+  it("returns the registry instance itself, never a copy", () => {
+    const captured = mountProbe();
+    expect(toRaw(captured()!)).toBe(registryAgent);
+  });
+
+  it("returns the same instance to two hooks sharing an agentId", () => {
+    let first: AbstractAgent | null = null;
+    let second: AbstractAgent | null = null;
+    const Probe = defineComponent({
+      setup() {
+        first = useAgent({ agentId: "my-agent" }).agent.value;
+        second = useAgent({ agentId: "my-agent" }).agent.value;
+        return () => null;
+      },
+    });
+
+    render(Probe);
+
+    // Cloning used to make these two different objects keyed by thread.
+    expect(toRaw(first!)).toBe(toRaw(second!));
+    expect(toRaw(first!)).toBe(registryAgent);
+  });
+
+  it("pins the chat configuration's thread when the caller chose it", () => {
+    mockUseChatConfig.mockReturnValue(
+      ref({
+        agentId: "my-agent",
+        threadId: "chosen-thread",
+        hasExplicitThreadId: true,
+      }),
+    );
+
+    mountProbe();
+
+    expect(registryAgent.threadId).toBe("chosen-thread");
+  });
+
+  it("leaves the agent's own thread alone for a non-explicit placeholder", () => {
+    // A ThreadsProvider-minted UUID is as meaningless to the backend as the
+    // agent's own, so it must not overwrite it.
+    const ownThreadId = registryAgent.threadId;
+    mockUseChatConfig.mockReturnValue(
+      ref({
+        agentId: "my-agent",
+        threadId: "placeholder-thread",
+        hasExplicitThreadId: false,
+      }),
+    );
+
+    mountProbe();
+
+    expect(registryAgent.threadId).toBe(ownThreadId);
+    expect(registryAgent.threadId).not.toBe("placeholder-thread");
+  });
+
+  describe("all-or-nothing thread scoping (mirrors React)", () => {
+    const expectSetupThrow = (setup: () => void, message: RegExp) => {
+      const Probe = defineComponent({
+        setup() {
+          setup();
+          return () => null;
+        },
+      });
+      const spy = vi.spyOn(console, "warn").mockImplementation(() => {});
+      try {
+        expect(() => render(Probe)).toThrow(message);
+      } finally {
+        spy.mockRestore();
+      }
+    };
+
+    it("throws when threadId is passed without runtimeAgentId", () => {
+      expectSetupThrow(() => {
+        // @ts-expect-error threadId requires runtimeAgentId
+        useAgent({ agentId: "my-agent", threadId: "t1" });
+      }, /`threadId` requires `runtimeAgentId`/);
+    });
+
+    it("throws when runtimeAgentId is passed without threadId", () => {
+      expectSetupThrow(() => {
+        // @ts-expect-error runtimeAgentId requires threadId
+        useAgent({ agentId: "chat-1", runtimeAgentId: "my-agent" });
+      }, /`runtimeAgentId` requires `threadId`/);
+    });
+
+    it("throws when runtimeAgentId is passed without an explicit agentId", () => {
+      expectSetupThrow(() => {
+        // @ts-expect-error runtimeAgentId requires an explicit agentId
+        useAgent({ runtimeAgentId: "my-agent", threadId: "t1" });
+      }, /requires an explicit `agentId`/);
+    });
+  });
+});