@copilotkit/vue 1.72.1-canary.sp-longthread-perf → 1.73.1

package/PARITY.md

@@ -119,13 +119,27 @@ For render bridges, the mirror strategy is deterministic slot translation at cha
 5. Keep slot payloads stable and parity-tested against React behavior, not component internals.
 6. Keep public Vue interaction APIs idiomatic: use emits for component-level UI interactions such as `@submit-message`, `@input-change`, `@select-suggestion`, `@edit-message`, `@switch-to-branch`, `@thumbs-up`, `@thumbs-down`, `@read-aloud`, and `@regenerate`.
 7. Keep slot payload actions imperative: use slot payload callbacks such as `onCopy`, `onEdit`, `goPrev`, `goNext`, and `onSubmitMessage` for slotted control surfaces.
-8. Only keep public callback props for true command-style flows that must be awaited by the child. Current exception: `CopilotChatView.onFinishTranscribeWithAudio`.
+8. Only keep public callback props for true command-style flows that must be awaited by the child. Current command exception: `CopilotChatView.onFinishTranscribeWithAudio`. Event-shaped `onX` props may also mirror an existing `defineEmits` event when a component must reactively gate its default controls; scoped-slot commands remain always-available local handlers and never infer listener presence through Vue instance internals.
 9. If a programmatic renderer registration path is used, prefer Vue SFC/components over handwritten `h(...)` render functions when either can express the same behavior.
 10. Keep slots as the primary public customization mechanism. Component-based registered renderers are acceptable for programmatic registration, but they do not replace the slot-first model.
 11. `renderCustomMessages` is an approved secondary provider API in Vue because ordered multi-renderer registration and agent-scoped precedence cannot be expressed honestly through a single slot function alone.
 
 This is a constraint for future parity work: new React render-hook behavior should be mirrored by extending slot contracts, not by re-introducing provider render props in Vue.
 
+### Interaction callback and capability map
+
+Vue components expose optional callback props when the component must reactively decide whether a built-in control is available. Scoped slots receive stable command functions plus explicit capability flags, so slot consumers never need to infer availability from function presence.
+
+| Vue surface                                                 | Callback and capability contract                                                                                                                                           | Intentional Vue shape                                                                            |
+| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| `CopilotChatView`                                           | Optional `onStop`, `onAddFile`, and transcription callbacks determine `canStop`, `canAddFile`, and `canTranscribe` for `#input` and `#welcome-screen`.                     | Event-shaped callback props mirror emitted interactions only to support reactive control gating. |
+| `CopilotChatInput`                                          | Optional action callbacks gate the corresponding default controls.                                                                                                         | The component emits interactions while callback presence describes availability.                 |
+| `CopilotPopupView` / `CopilotSidebarView`                   | Optional callbacks are forwarded only when the corresponding action is available.                                                                                          | Wrapper layers must not turn an absent callback into a truthy no-op capability.                  |
+| `CopilotChatUserMessage`                                    | Optional edit and branch-switch callbacks gate controls; branch slot commands expose `canGoPrev` and `canGoNext`.                                                          | `#branch-navigation` receives stable commands even when navigation is unavailable.               |
+| `CopilotChatAssistantMessage`                               | Optional feedback, read-aloud, and regenerate callbacks gate toolbar actions.                                                                                              | Toolbar slots stay slot-first while callback props provide reactive availability.                |
+| `CopilotSidebarWelcomeScreen` / `CopilotPopupWelcomeScreen` | `#input` receives stable commands plus `canStop`, `canAddFile`, and `canTranscribe`, forwarded from the parent view or derived from optional callbacks when used directly. | Wrapper commands may be stable no-ops, so capability flags are the source of truth.              |
+| `LicenseWarningBanner`                                      | Optional `onDismiss` controls whether the dismiss button is rendered.                                                                                                      | A callback prop is used because listener introspection is not reactive or public Vue API.        |
+
 ## Architectural decision: Render hooks -> Composable state + slots
 
 Vue also diverges intentionally from React for render-oriented hooks that mix behavior with a render callback.

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("@copilotkit/core"),A=require("@ag-ui/client"),e=require("./use-render-activity-message-DXJDZGkW.cjs"),i=require("vue"),C=require("@copilotkit/shared");function g(n){return typeof n!="function"?n:(o=>{const a=typeof o.result=="string"?{...o,result:C.parseJson(o.result,o.result)}:o;return n(a)})}function b(n,o){const a="parameters"in n?C.getZodParameters(n.parameters):void 0;if(n.name==="*"){e.useRenderTool({name:"*",render:g(n.render),..."agentId"in n?{agentId:n.agentId}:{}},o);return}const t=n;if("renderAndWaitForResponse"in t||"renderAndWait"in t){const l=t.render??t.renderAndWaitForResponse??t.renderAndWait;if(!l){console.warn(`[CopilotKit] useCopilotAction: HITL action '${t.name}' has no render function. Skipping.`);return}e.useHumanInTheLoop({name:t.name,description:t.description,parameters:a,render:g(l),agentId:t.agentId},o);return}if(t.available==="frontend"||t.available==="disabled"){t.render&&a?e.useRenderTool({name:t.name,parameters:a,render:g(t.render),agentId:t.agentId},o):console.warn(`[CopilotKit] useCopilotAction: action '${t.name}' with available="${t.available}" requires both 'render' and 'parameters'. Skipping registration.`);return}const c=t.handler?l=>Promise.resolve(t.handler(l)):void 0;let s;t.available==="remote"?s=!1:t.available!==void 0&&(s=!0),e.useFrontendTool({name:t.name,description:t.description,parameters:a,handler:c,followUp:t.followUp,render:g(t.render),available:s,agentId:t.agentId,get webmcp(){return t.webmcp}},o)}function _(n,o){const{name:a,description:t,parameters:c,handler:s,followUp:l,available:m,render:u,agentId:d}=n,p=C.getZodParameters(c),f=s?r=>Promise.resolve(s(r)):void 0,v=typeof u=="function"?r=>{const h=typeof r.result=="string"?{...r,result:C.parseJson(r.result,r.result)}:r;return u(h)}:u;e.useFrontendTool({name:a,description:t,parameters:p,handler:f,followUp:l,render:v,available:m===void 0?void 0:m!=="disabled",agentId:d,get webmcp(){return n.webmcp}},o)}function I(n,o){const{copilotkit:a}=e.useCopilotKit(),t=i.ref(void 0),c=o??[];return i.watch([()=>n.description,()=>n.value,()=>n.convert,()=>n.available,...c],(s,l,m)=>{const u=a.value;if(!u)return;const{description:d,value:p,convert:f,available:v}=n;let r;try{r=f?f(d,p):JSON.stringify(p)}catch(h){console.warn(`[CopilotKit] useCopilotReadable: failed to serialize value for "${d}":`,h),r=String(p)}v!=="disabled"&&(t.value=u.addContext({description:d,value:r}),m(()=>{t.value&&u.removeContext(t.value)}))},{immediate:!0}),t}const T=i.defineComponent({__name:"CopilotKit",props:{publicApiKey:{},publicLicenseKey:{},runtimeUrl:{},headers:{type:[Object,Function]},credentials:{},defaultThrottleMs:{},licenseToken:{},properties:{},useSingleEndpoint:{type:Boolean},agents__unsafe_dev_only:{},selfManagedAgents:{},renderToolCalls:{},renderActivityMessages:{},renderCustomMessages:{},frontendTools:{},humanInTheLoop:{},openGenerativeUI:{},showDevConsole:{type:[Boolean,String]},enableInspector:{type:Boolean},onError:{type:Function},a2ui:{},debug:{type:[Boolean,Object]}},setup(n){const o=n;return(a,t)=>(i.openBlock(),i.createBlock(e._sfc_main$15,i.normalizeProps(i.guardReactiveProps(o)),{default:i.withCtx(()=>[i.renderSlot(a.$slots,"default")]),_:3},16))}});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.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:()=>C.createLicenseContextValue});exports.CopilotKit=T;exports.useCopilotAction=b;exports.useCopilotReadable=I;exports.useFrontendTool=_;Object.keys(y).forEach(n=>{n!=="default"&&!Object.prototype.hasOwnProperty.call(exports,n)&&Object.defineProperty(exports,n,{enumerable:!0,get:()=>y[n]})});Object.keys(A).forEach(n=>{n!=="default"&&!Object.prototype.hasOwnProperty.call(exports,n)&&Object.defineProperty(exports,n,{enumerable:!0,get:()=>A[n]})});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("@copilotkit/core"),A=require("@ag-ui/client"),e=require("./use-render-activity-message-6LwUTCNm.cjs"),i=require("vue"),C=require("@copilotkit/shared");function f(n){return typeof n!="function"?n:(o=>{const a=typeof o.result=="string"?{...o,result:C.parseJson(o.result,o.result)}:o;return n(a)})}function b(n,o){const a="parameters"in n?C.getZodParameters(n.parameters):void 0;if(n.name==="*"){e.useRenderTool({name:"*",render:f(n.render),..."agentId"in n?{agentId:n.agentId}:{}},o);return}const t=n;if("renderAndWaitForResponse"in t||"renderAndWait"in t){const l=t.render??t.renderAndWaitForResponse??t.renderAndWait;if(!l){console.warn(`[CopilotKit] useCopilotAction: HITL action '${t.name}' has no render function. Skipping.`);return}e.useHumanInTheLoop({name:t.name,description:t.description,parameters:a,render:f(l),agentId:t.agentId},o);return}if(t.available==="frontend"||t.available==="disabled"){t.render&&a?e.useRenderTool({name:t.name,parameters:a,render:f(t.render),agentId:t.agentId},o):console.warn(`[CopilotKit] useCopilotAction: action '${t.name}' with available="${t.available}" requires both 'render' and 'parameters'. Skipping registration.`);return}const c=t.handler?l=>Promise.resolve(t.handler(l)):void 0;let s;t.available==="remote"?s=!1:t.available!==void 0&&(s=!0),e.useFrontendTool({name:t.name,description:t.description,parameters:a,handler:c,followUp:t.followUp,render:f(t.render),available:s,agentId:t.agentId,get webmcp(){return t.webmcp}},o)}function _(n,o){const{name:a,description:t,parameters:c,handler:s,followUp:l,available:m,render:u,agentId:d}=n,p=C.getZodParameters(c),g=s?r=>Promise.resolve(s(r)):void 0,v=typeof u=="function"?r=>{const h=typeof r.result=="string"?{...r,result:C.parseJson(r.result,r.result)}:r;return u(h)}:u;e.useFrontendTool({name:a,description:t,parameters:p,handler:g,followUp:l,render:v,available:m===void 0?void 0:m!=="disabled",agentId:d,get webmcp(){return n.webmcp}},o)}function I(n,o){const{copilotkit:a}=e.useCopilotKit(),t=i.ref(void 0),c=o??[];return i.watch([()=>n.description,()=>n.value,()=>n.convert,()=>n.available,...c],(s,l,m)=>{const u=a.value;if(!u)return;const{description:d,value:p,convert:g,available:v}=n;let r;try{r=g?g(d,p):JSON.stringify(p)}catch(h){console.warn(`[CopilotKit] useCopilotReadable: failed to serialize value for "${d}":`,h),r=String(p)}v!=="disabled"&&(t.value=u.addContext({description:d,value:r}),m(()=>{t.value&&u.removeContext(t.value)}))},{immediate:!0}),t}const T=i.defineComponent({__name:"CopilotKit",props:{publicApiKey:{},publicLicenseKey:{},runtimeUrl:{},headers:{type:[Object,Function]},credentials:{},messageFilter:{type:Function},defaultThrottleMs:{},licenseToken:{},properties:{},useSingleEndpoint:{type:Boolean},agents__unsafe_dev_only:{},selfManagedAgents:{},renderToolCalls:{},renderActivityMessages:{},renderCustomMessages:{},frontendTools:{},humanInTheLoop:{},openGenerativeUI:{},showDevConsole:{type:[Boolean,String]},enableInspector:{type:Boolean},onError:{type:Function},a2ui:{},debug:{type:[Boolean,Object]}},setup(n){const o=n;return(a,t)=>(i.openBlock(),i.createBlock(e._sfc_main$15,i.normalizeProps(i.guardReactiveProps(o)),{default:i.withCtx(()=>[i.renderSlot(a.$slots,"default")]),_:3},16))}});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.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:()=>C.createLicenseContextValue});exports.CopilotKit=T;exports.useCopilotAction=b;exports.useCopilotReadable=I;exports.useFrontendTool=_;Object.keys(y).forEach(n=>{n!=="default"&&!Object.prototype.hasOwnProperty.call(exports,n)&&Object.defineProperty(exports,n,{enumerable:!0,get:()=>y[n]})});Object.keys(A).forEach(n=>{n!=="default"&&!Object.prototype.hasOwnProperty.call(exports,n)&&Object.defineProperty(exports,n,{enumerable:!0,get:()=>A[n]})});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/hooks/use-copilot-action.ts","../src/hooks/use-frontend-tool.ts","../src/hooks/use-copilot-readable.ts","../src/components/copilot-provider/CopilotKit.vue"],"sourcesContent":["/**\n * V1 compatibility wrapper for useCopilotAction.\n *\n * Accepts the legacy Parameter[] action format and routes to the appropriate\n * v2 composable (useFrontendTool, useHumanInTheLoop, or useRenderTool).\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport type { Parameter, MappedParameterTypes } from \"@copilotkit/shared\";\nimport { getZodParameters, parseJson } from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport { useHumanInTheLoop as useHumanInTheLoopV2 } from \"../v2/hooks/use-human-in-the-loop\";\nimport { useRenderTool as useRenderToolV2 } from \"../v2/hooks/use-render-tool\";\nimport type { VueFrontendTool, VueHumanInTheLoop } from \"../v2/types\";\n\n// Wraps a v1 render function so a JSON-string `result` is parsed before being\n// passed through. Mirrors the v1 React behavior. If render is a Component\n// (object) rather than a function, returns it unchanged — Components receive\n// props through Vue's prop system and the user is responsible for parsing.\nfunction wrapRenderWithJsonResult<R>(render: R): R {\n  if (typeof render !== \"function\") return render;\n  return ((props: { result?: unknown }) => {\n    const next =\n      typeof props.result === \"string\"\n        ? { ...props, result: parseJson(props.result, props.result) }\n        : props;\n    return (render as (p: unknown) => unknown)(next);\n  }) as R;\n}\n\nexport interface FrontendAction<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\" | \"remote\" | \"frontend\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWaitForResponse?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWait?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this action to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport interface CatchAllFrontendAction {\n  name: \"*\";\n  render: (props: unknown) => unknown;\n}\n\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  deps?: WatchSource<unknown>[],\n): void {\n  const zodParameters =\n    \"parameters\" in action\n      ? getZodParameters(action.parameters as T)\n      : undefined;\n\n  // Catch-all render action\n  if (action.name === \"*\") {\n    useRenderToolV2(\n      {\n        name: \"*\",\n        render: wrapRenderWithJsonResult(\n          (action as CatchAllFrontendAction).render,\n        ),\n        ...(\"agentId\" in action\n          ? { agentId: (action as FrontendAction<T>).agentId }\n          : {}),\n      },\n      deps,\n    );\n    return;\n  }\n\n  const typedAction = action as FrontendAction<T>;\n\n  // Human-in-the-loop: has renderAndWaitForResponse or renderAndWait\n  if (\n    \"renderAndWaitForResponse\" in typedAction ||\n    \"renderAndWait\" in typedAction\n  ) {\n    const render =\n      typedAction.render ??\n      typedAction.renderAndWaitForResponse ??\n      typedAction.renderAndWait;\n\n    if (!render) {\n      console.warn(\n        `[CopilotKit] useCopilotAction: HITL action '${typedAction.name}' ` +\n          `has no render function. Skipping.`,\n      );\n      return;\n    }\n\n    useHumanInTheLoopV2<MappedParameterTypes<T>>(\n      {\n        name: typedAction.name,\n        description: typedAction.description,\n        parameters: zodParameters,\n        render: wrapRenderWithJsonResult(render) as VueHumanInTheLoop<\n          MappedParameterTypes<T>\n        >[\"render\"],\n        agentId: typedAction.agentId,\n      },\n      deps,\n    );\n    return;\n  }\n\n  // Render-only: available is \"frontend\" or \"disabled\" (no handler invoked remotely)\n  if (\n    typedAction.available === \"frontend\" ||\n    typedAction.available === \"disabled\"\n  ) {\n    if (typedAction.render && zodParameters) {\n      useRenderToolV2(\n        {\n          name: typedAction.name,\n          parameters: zodParameters,\n          render: wrapRenderWithJsonResult(\n            typedAction.render as (props: unknown) => unknown,\n          ),\n          agentId: typedAction.agentId,\n        },\n        deps,\n      );\n    } else {\n      console.warn(\n        `[CopilotKit] useCopilotAction: action '${typedAction.name}' ` +\n          `with available=\"${typedAction.available}\" requires both ` +\n          `'render' and 'parameters'. Skipping registration.`,\n      );\n    }\n    return;\n  }\n\n  // Default: frontend tool with handler\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = typedAction.handler\n    ? (args: MappedParameterTypes<T>) =>\n        Promise.resolve(typedAction.handler!(args))\n    : undefined;\n\n  // Convert v1 available (string enum) to v2 available (boolean)\n  // At this point, \"frontend\" and \"disabled\" have been handled above,\n  // so remaining values are \"enabled\", \"remote\", or undefined.\n  // \"remote\" means server-only: register the tool but mark it as not\n  // available on the frontend (matches React's ActionInputAvailability.Remote).\n  let normalizedAvailable: boolean | undefined;\n  if (typedAction.available === \"remote\") {\n    normalizedAvailable = false;\n  } else if (typedAction.available !== undefined) {\n    normalizedAvailable = true;\n  }\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name: typedAction.name,\n      description: typedAction.description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp: typedAction.followUp,\n      render: wrapRenderWithJsonResult(typedAction.render),\n      available: normalizedAvailable,\n      agentId: typedAction.agentId,\n      // Read webmcp at watch time: the action object may expose it as a getter\n      // over reactive state, and capturing the initial value here would\n      // re-register a stale configuration.\n      get webmcp() {\n        return typedAction.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useFrontendTool.\n *\n * Accepts the legacy Parameter[] format and converts to Zod via getZodParameters,\n * then delegates to the v2 composable.\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport {\n  type Parameter,\n  type MappedParameterTypes,\n  getZodParameters,\n  parseJson,\n} from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport type { VueFrontendTool } from \"../v2/types\";\n\nexport interface UseFrontendToolArgs<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this tool to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  deps?: WatchSource<unknown>[],\n) {\n  const {\n    name,\n    description,\n    parameters,\n    handler,\n    followUp,\n    available,\n    render,\n    agentId,\n  } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = handler\n    ? (args: MappedParameterTypes<T>) => Promise.resolve(handler(args))\n    : undefined;\n\n  // Wrap render to parse JSON-string results before passing them to the\n  // user's render function — matches the v1 React behavior. If render is a\n  // Component rather than a function, leave it unchanged.\n  const normalizedRender =\n    typeof render === \"function\"\n      ? (props: { result?: unknown }) => {\n          const renderProps =\n            typeof props.result === \"string\"\n              ? { ...props, result: parseJson(props.result, props.result) }\n              : props;\n          return (render as (p: unknown) => unknown)(renderProps);\n        }\n      : render;\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name,\n      description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp,\n      render: normalizedRender,\n      available: available === undefined ? undefined : available !== \"disabled\",\n      agentId,\n      // Read webmcp at watch time: the v1 args may expose it as a getter over\n      // reactive state, and capturing the initial value here would re-register\n      // a stale configuration.\n      get webmcp() {\n        return tool.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useCopilotReadable.\n *\n * Provides app-state and other information to the Copilot context.\n * Delegates directly to the v2 CopilotKitCoreVue instance.\n */\nimport { watch, ref, type Ref } from \"vue\";\nimport type { WatchSource } from \"vue\";\nimport { useCopilotKit } from \"../v2/providers/useCopilotKit\";\n\nexport interface UseCopilotReadableOptions {\n  /** The description of the information to be added to the Copilot context. */\n  description: string;\n  /** The value to be added to the Copilot context. Object values are automatically stringified. */\n  value: unknown;\n  /** Whether the context is available to the Copilot. */\n  available?: \"enabled\" | \"disabled\";\n  /** Custom conversion function to serialize the value to a string. */\n  convert?: (description: string, value: unknown) => string;\n}\n\nexport function useCopilotReadable(\n  options: UseCopilotReadableOptions,\n  deps?: WatchSource<unknown>[],\n): Ref<string | undefined> {\n  const { copilotkit } = useCopilotKit();\n  const ctxIdRef = ref<string | undefined>(undefined);\n\n  const extraDeps = deps ?? [];\n\n  watch(\n    [\n      () => options.description,\n      () => options.value,\n      () => options.convert,\n      () => options.available,\n      ...extraDeps,\n    ],\n    (_newValues, _old, onCleanup) => {\n      const core = copilotkit.value;\n      if (!core) return;\n\n      const { description, value, convert, available } = options;\n\n      let serializedValue: string;\n      try {\n        serializedValue = convert\n          ? convert(description, value)\n          : JSON.stringify(value);\n      } catch (err) {\n        console.warn(\n          `[CopilotKit] useCopilotReadable: failed to serialize ` +\n            `value for \"${description}\":`,\n          err,\n        );\n        serializedValue = String(value);\n      }\n\n      if (available === \"disabled\") return;\n\n      ctxIdRef.value = core.addContext({\n        description,\n        value: serializedValue,\n      });\n\n      onCleanup(() => {\n        if (!ctxIdRef.value) return;\n        core.removeContext(ctxIdRef.value);\n      });\n    },\n    { immediate: true },\n  );\n\n  return ctxIdRef;\n}\n","<script setup lang=\"ts\">\n/**\n * V1 compatibility wrapper for CopilotKitProvider.\n *\n * Accepts the same props as CopilotKitProvider plus legacy v1 props\n * (publicApiKey, publicLicenseKey) and delegates to the v2 provider.\n */\nimport type { CopilotKitProps } from \"./types\";\nimport CopilotKitProvider from \"../../v2/providers/CopilotKitProvider.vue\";\n\nconst props = defineProps<CopilotKitProps>();\n</script>\n\n<template>\n  <CopilotKitProvider v-bind=\"props\">\n    <slot />\n  </CopilotKitProvider>\n</template>\n"],"names":["wrapRenderWithJsonResult","render","props","next","parseJson","useCopilotAction","action","deps","zodParameters","getZodParameters","useRenderToolV2","typedAction","useHumanInTheLoopV2","normalizedHandler","args","normalizedAvailable","useFrontendToolV2","useFrontendTool","tool","name","description","parameters","handler","followUp","available","agentId","normalizedRender","renderProps","useCopilotReadable","options","copilotkit","useCopilotKit","ctxIdRef","ref","extraDeps","watch","_newValues","_old","onCleanup","core","value","convert","serializedValue","err","__props","_openBlock","_createBlock","CopilotKitProvider","_renderSlot","_ctx"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/hooks/use-copilot-action.ts","../src/hooks/use-frontend-tool.ts","../src/hooks/use-copilot-readable.ts","../src/components/copilot-provider/CopilotKit.vue"],"sourcesContent":["/**\n * V1 compatibility wrapper for useCopilotAction.\n *\n * Accepts the legacy Parameter[] action format and routes to the appropriate\n * v2 composable (useFrontendTool, useHumanInTheLoop, or useRenderTool).\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport type { Parameter, MappedParameterTypes } from \"@copilotkit/shared\";\nimport { getZodParameters, parseJson } from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport { useHumanInTheLoop as useHumanInTheLoopV2 } from \"../v2/hooks/use-human-in-the-loop\";\nimport { useRenderTool as useRenderToolV2 } from \"../v2/hooks/use-render-tool\";\nimport type { VueFrontendTool, VueHumanInTheLoop } from \"../v2/types\";\n\n// Wraps a v1 render function so a JSON-string `result` is parsed before being\n// passed through. Mirrors the v1 React behavior. If render is a Component\n// (object) rather than a function, returns it unchanged — Components receive\n// props through Vue's prop system and the user is responsible for parsing.\nfunction wrapRenderWithJsonResult<R>(render: R): R {\n  if (typeof render !== \"function\") return render;\n  return ((props: { result?: unknown }) => {\n    const next =\n      typeof props.result === \"string\"\n        ? { ...props, result: parseJson(props.result, props.result) }\n        : props;\n    return (render as (p: unknown) => unknown)(next);\n  }) as R;\n}\n\nexport interface FrontendAction<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\" | \"remote\" | \"frontend\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWaitForResponse?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWait?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this action to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport interface CatchAllFrontendAction {\n  name: \"*\";\n  render: (props: unknown) => unknown;\n}\n\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  deps?: WatchSource<unknown>[],\n): void {\n  const zodParameters =\n    \"parameters\" in action\n      ? getZodParameters(action.parameters as T)\n      : undefined;\n\n  // Catch-all render action\n  if (action.name === \"*\") {\n    useRenderToolV2(\n      {\n        name: \"*\",\n        render: wrapRenderWithJsonResult(\n          (action as CatchAllFrontendAction).render,\n        ),\n        ...(\"agentId\" in action\n          ? { agentId: (action as FrontendAction<T>).agentId }\n          : {}),\n      },\n      deps,\n    );\n    return;\n  }\n\n  const typedAction = action as FrontendAction<T>;\n\n  // Human-in-the-loop: has renderAndWaitForResponse or renderAndWait\n  if (\n    \"renderAndWaitForResponse\" in typedAction ||\n    \"renderAndWait\" in typedAction\n  ) {\n    const render =\n      typedAction.render ??\n      typedAction.renderAndWaitForResponse ??\n      typedAction.renderAndWait;\n\n    if (!render) {\n      console.warn(\n        `[CopilotKit] useCopilotAction: HITL action '${typedAction.name}' ` +\n          `has no render function. Skipping.`,\n      );\n      return;\n    }\n\n    useHumanInTheLoopV2<MappedParameterTypes<T>>(\n      {\n        name: typedAction.name,\n        description: typedAction.description,\n        parameters: zodParameters,\n        render: wrapRenderWithJsonResult(render) as VueHumanInTheLoop<\n          MappedParameterTypes<T>\n        >[\"render\"],\n        agentId: typedAction.agentId,\n      },\n      deps,\n    );\n    return;\n  }\n\n  // Render-only: available is \"frontend\" or \"disabled\" (no handler invoked remotely)\n  if (\n    typedAction.available === \"frontend\" ||\n    typedAction.available === \"disabled\"\n  ) {\n    if (typedAction.render && zodParameters) {\n      useRenderToolV2(\n        {\n          name: typedAction.name,\n          parameters: zodParameters,\n          render: wrapRenderWithJsonResult(\n            typedAction.render as (props: unknown) => unknown,\n          ),\n          agentId: typedAction.agentId,\n        },\n        deps,\n      );\n    } else {\n      console.warn(\n        `[CopilotKit] useCopilotAction: action '${typedAction.name}' ` +\n          `with available=\"${typedAction.available}\" requires both ` +\n          `'render' and 'parameters'. Skipping registration.`,\n      );\n    }\n    return;\n  }\n\n  // Default: frontend tool with handler\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = typedAction.handler\n    ? (args: MappedParameterTypes<T>) =>\n        Promise.resolve(typedAction.handler!(args))\n    : undefined;\n\n  // Convert v1 available (string enum) to v2 available (boolean)\n  // At this point, \"frontend\" and \"disabled\" have been handled above,\n  // so remaining values are \"enabled\", \"remote\", or undefined.\n  // \"remote\" means server-only: register the tool but mark it as not\n  // available on the frontend (matches React's ActionInputAvailability.Remote).\n  let normalizedAvailable: boolean | undefined;\n  if (typedAction.available === \"remote\") {\n    normalizedAvailable = false;\n  } else if (typedAction.available !== undefined) {\n    normalizedAvailable = true;\n  }\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name: typedAction.name,\n      description: typedAction.description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp: typedAction.followUp,\n      render: wrapRenderWithJsonResult(typedAction.render),\n      available: normalizedAvailable,\n      agentId: typedAction.agentId,\n      // Read webmcp at watch time: the action object may expose it as a getter\n      // over reactive state, and capturing the initial value here would\n      // re-register a stale configuration.\n      get webmcp() {\n        return typedAction.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useFrontendTool.\n *\n * Accepts the legacy Parameter[] format and converts to Zod via getZodParameters,\n * then delegates to the v2 composable.\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport {\n  type Parameter,\n  type MappedParameterTypes,\n  getZodParameters,\n  parseJson,\n} from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport type { VueFrontendTool } from \"../v2/types\";\n\nexport interface UseFrontendToolArgs<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this tool to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  deps?: WatchSource<unknown>[],\n) {\n  const {\n    name,\n    description,\n    parameters,\n    handler,\n    followUp,\n    available,\n    render,\n    agentId,\n  } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = handler\n    ? (args: MappedParameterTypes<T>) => Promise.resolve(handler(args))\n    : undefined;\n\n  // Wrap render to parse JSON-string results before passing them to the\n  // user's render function — matches the v1 React behavior. If render is a\n  // Component rather than a function, leave it unchanged.\n  const normalizedRender =\n    typeof render === \"function\"\n      ? (props: { result?: unknown }) => {\n          const renderProps =\n            typeof props.result === \"string\"\n              ? { ...props, result: parseJson(props.result, props.result) }\n              : props;\n          return (render as (p: unknown) => unknown)(renderProps);\n        }\n      : render;\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name,\n      description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp,\n      render: normalizedRender,\n      available: available === undefined ? undefined : available !== \"disabled\",\n      agentId,\n      // Read webmcp at watch time: the v1 args may expose it as a getter over\n      // reactive state, and capturing the initial value here would re-register\n      // a stale configuration.\n      get webmcp() {\n        return tool.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useCopilotReadable.\n *\n * Provides app-state and other information to the Copilot context.\n * Delegates directly to the v2 CopilotKitCoreVue instance.\n */\nimport { watch, ref, type Ref } from \"vue\";\nimport type { WatchSource } from \"vue\";\nimport { useCopilotKit } from \"../v2/providers/useCopilotKit\";\n\nexport interface UseCopilotReadableOptions {\n  /** The description of the information to be added to the Copilot context. */\n  description: string;\n  /** The value to be added to the Copilot context. Object values are automatically stringified. */\n  value: unknown;\n  /** Whether the context is available to the Copilot. */\n  available?: \"enabled\" | \"disabled\";\n  /** Custom conversion function to serialize the value to a string. */\n  convert?: (description: string, value: unknown) => string;\n}\n\nexport function useCopilotReadable(\n  options: UseCopilotReadableOptions,\n  deps?: WatchSource<unknown>[],\n): Ref<string | undefined> {\n  const { copilotkit } = useCopilotKit();\n  const ctxIdRef = ref<string | undefined>(undefined);\n\n  const extraDeps = deps ?? [];\n\n  watch(\n    [\n      () => options.description,\n      () => options.value,\n      () => options.convert,\n      () => options.available,\n      ...extraDeps,\n    ],\n    (_newValues, _old, onCleanup) => {\n      const core = copilotkit.value;\n      if (!core) return;\n\n      const { description, value, convert, available } = options;\n\n      let serializedValue: string;\n      try {\n        serializedValue = convert\n          ? convert(description, value)\n          : JSON.stringify(value);\n      } catch (err) {\n        console.warn(\n          `[CopilotKit] useCopilotReadable: failed to serialize ` +\n            `value for \"${description}\":`,\n          err,\n        );\n        serializedValue = String(value);\n      }\n\n      if (available === \"disabled\") return;\n\n      ctxIdRef.value = core.addContext({\n        description,\n        value: serializedValue,\n      });\n\n      onCleanup(() => {\n        if (!ctxIdRef.value) return;\n        core.removeContext(ctxIdRef.value);\n      });\n    },\n    { immediate: true },\n  );\n\n  return ctxIdRef;\n}\n","<script setup lang=\"ts\">\n/**\n * V1 compatibility wrapper for CopilotKitProvider.\n *\n * Accepts the same props as CopilotKitProvider plus legacy v1 props\n * (publicApiKey, publicLicenseKey) and delegates to the v2 provider.\n */\nimport type { CopilotKitProps } from \"./types\";\nimport CopilotKitProvider from \"../../v2/providers/CopilotKitProvider.vue\";\n\nconst props = defineProps<CopilotKitProps>();\n</script>\n\n<template>\n  <CopilotKitProvider v-bind=\"props\">\n    <slot />\n  </CopilotKitProvider>\n</template>\n"],"names":["wrapRenderWithJsonResult","render","props","next","parseJson","useCopilotAction","action","deps","zodParameters","getZodParameters","useRenderToolV2","typedAction","useHumanInTheLoopV2","normalizedHandler","args","normalizedAvailable","useFrontendToolV2","useFrontendTool","tool","name","description","parameters","handler","followUp","available","agentId","normalizedRender","renderProps","useCopilotReadable","options","copilotkit","useCopilotKit","ctxIdRef","ref","extraDeps","watch","_newValues","_old","onCleanup","core","value","convert","serializedValue","err","__props","_openBlock","_createBlock","CopilotKitProvider","_renderSlot","_ctx"],"mappings":"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"}

package/dist/index.mjs

@@ -1,32 +1,32 @@
 export * from "@copilotkit/core";
 export * from "@ag-ui/client";
-import { aa as f, a3 as b, a2 as v, a0 as y, u as I } from "./use-render-activity-message-Ciee03Rx.js";
-import { A as k, _ as W, a as J, C as j, b as E, c as q, d as N, e as Q, f as Z, g as X, h as Y, i as ee, j as ae, k as te, l as oe, m as ne, n as re, o as se, p as ie, q as le, r as de, s as ue, t as pe, v as ce, w as Ce, x as me, y as ge, z as fe, B as ve, G as he, L as Ae, M as be, D as ye, E as Ie, O as Re, F as Se, H as we, I as Te, J as xe, U as Ue, K as Pe, N as Me, P as Ke, Q as _e, R as ze, S as Be, T as Oe, V as Ve, W as Le, X as He, Y as De, Z as Fe, $ as Ge, a1 as $e, a4 as ke, a5 as We, a6 as Je, a7 as je, a8 as Ee, a9 as qe, ab as Ne, ac as Qe, ad as Ze, ae as Xe } from "./use-render-activity-message-Ciee03Rx.js";
+import { aa as f, a3 as b, a2 as v, a0 as y, u as I } from "./use-render-activity-message-Di_L8HCv.js";
+import { A as k, _ as W, a as J, C as j, b as E, c as q, d as N, e as Q, f as Z, g as X, h as Y, i as ee, j as te, k as ae, l as oe, m as ne, n as re, o as se, p as ie, q as le, r as de, s as ue, t as pe, v as ce, w as Ce, x as me, y as ge, z as fe, B as ve, G as he, L as Ae, M as be, D as ye, E as Ie, O as Re, F as Se, H as we, I as Te, J as xe, U as Ue, K as Pe, N as Me, P as Ke, Q as _e, R as ze, S as Be, T as Oe, V as Ve, W as Fe, X as Le, Y as He, Z as De, $ as Ge, a1 as $e, a4 as ke, a5 as We, a6 as Je, a7 as je, a8 as Ee, a9 as qe, ab as Ne, ac as Qe, ad as Ze, ae as Xe } from "./use-render-activity-message-Di_L8HCv.js";
 import { ref as R, watch as S, defineComponent as w, openBlock as T, createBlock as x, normalizeProps as U, guardReactiveProps as P, withCtx as M, renderSlot as K } from "vue";
 import { getZodParameters as h, parseJson as A } from "@copilotkit/shared";
-import { createLicenseContextValue as ea } from "@copilotkit/shared";
-function c(a) {
-  return typeof a != "function" ? a : ((t) => {
-    const o = typeof t.result == "string" ? { ...t, result: A(t.result, t.result) } : t;
-    return a(o);
+import { createLicenseContextValue as et } from "@copilotkit/shared";
+function c(t) {
+  return typeof t != "function" ? t : ((a) => {
+    const o = typeof a.result == "string" ? { ...a, result: A(a.result, a.result) } : a;
+    return t(o);
   });
 }
-function O(a, t) {
-  const o = "parameters" in a ? h(a.parameters) : void 0;
-  if (a.name === "*") {
+function O(t, a) {
+  const o = "parameters" in t ? h(t.parameters) : void 0;
+  if (t.name === "*") {
     f(
       {
         name: "*",
         render: c(
-          a.render
+          t.render
         ),
-        ..."agentId" in a ? { agentId: a.agentId } : {}
+        ..."agentId" in t ? { agentId: t.agentId } : {}
       },
-      t
+      a
     );
     return;
   }
-  const e = a;
+  const e = t;
   if ("renderAndWaitForResponse" in e || "renderAndWait" in e) {
     const s = e.render ?? e.renderAndWaitForResponse ?? e.renderAndWait;
     if (!s) {
@@ -43,7 +43,7 @@ function O(a, t) {
         render: c(s),
         agentId: e.agentId
       },
-      t
+      a
     );
     return;
   }
@@ -57,7 +57,7 @@ function O(a, t) {
         ),
         agentId: e.agentId
       },
-      t
+      a
     ) : console.warn(
       `[CopilotKit] useCopilotAction: action '${e.name}' with available="${e.available}" requires both 'render' and 'parameters'. Skipping registration.`
     );
@@ -82,10 +82,10 @@ function O(a, t) {
         return e.webmcp;
       }
     },
-    t
+    a
   );
 }
-function V(a, t) {
+function V(t, a) {
   const {
     name: o,
     description: e,
@@ -95,7 +95,7 @@ function V(a, t) {
     available: p,
     render: i,
     agentId: l
-  } = a, d = h(u);
+  } = t, d = h(u);
   v(
     {
       name: o,
@@ -113,26 +113,26 @@ function V(a, t) {
       // reactive state, and capturing the initial value here would re-register
       // a stale configuration.
       get webmcp() {
-        return a.webmcp;
+        return t.webmcp;
       }
     },
-    t
+    a
   );
 }
-function L(a, t) {
+function F(t, a) {
   const { copilotkit: o } = y(), e = R(void 0);
   return S(
     [
-      () => a.description,
-      () => a.value,
-      () => a.convert,
-      () => a.available,
-      ...t ?? []
+      () => t.description,
+      () => t.value,
+      () => t.convert,
+      () => t.available,
+      ...a ?? []
     ],
     (r, s, p) => {
       const i = o.value;
       if (!i) return;
-      const { description: l, value: d, convert: C, available: g } = a;
+      const { description: l, value: d, convert: C, available: g } = t;
       let n;
       try {
         n = C ? C(l, d) : JSON.stringify(d);
@@ -152,7 +152,7 @@ function L(a, t) {
     { immediate: !0 }
   ), e;
 }
-const H = /* @__PURE__ */ w({
+const L = /* @__PURE__ */ w({
   __name: "CopilotKit",
   props: {
     publicApiKey: {},
@@ -160,6 +160,7 @@ const H = /* @__PURE__ */ w({
     runtimeUrl: {},
     headers: { type: [Object, Function] },
     credentials: {},
+    messageFilter: { type: Function },
     defaultThrottleMs: {},
     licenseToken: {},
     properties: {},
@@ -178,9 +179,9 @@ const H = /* @__PURE__ */ w({
     a2ui: {},
     debug: { type: [Boolean, Object] }
   },
-  setup(a) {
-    const t = a;
-    return (o, e) => (T(), x(I, U(P(t)), {
+  setup(t) {
+    const a = t;
+    return (o, e) => (T(), x(I, U(P(a)), {
       default: M(() => [
         K(o.$slots, "default")
       ]),
@@ -201,8 +202,8 @@ export {
   X as CopilotChatDefaultLabels,
   Y as CopilotChatInput,
   ee as CopilotChatMessageView,
-  ae as CopilotChatReasoningMessage,
-  te as CopilotChatSuggestionPill,
+  te as CopilotChatReasoningMessage,
+  ae as CopilotChatSuggestionPill,
   oe as CopilotChatSuggestionView,
   ne as CopilotChatToggleButton,
   re as CopilotChatToggleButtonCloseIcon,
@@ -210,7 +211,7 @@ export {
   ie as CopilotChatToolCallsView,
   le as CopilotChatUserMessage,
   de as CopilotChatView,
-  H as CopilotKit,
+  L as CopilotKit,
   ue as CopilotKitCoreVue,
   pe as CopilotKitInspector,
   I as CopilotKitProvider,
@@ -233,21 +234,21 @@ export {
   Ue as UseAgentUpdate,
   Pe as createA2UIMessageRenderer,
   Me as createDefaultLicenseRef,
-  ea as createLicenseContextValue,
+  et as createLicenseContextValue,
   Ke as defineToolCallRenderer,
   _e as extractCompleteStyles,
   ze as getOperationSurfaceId,
   Be as processPartialHtml,
   Oe as useAgent,
   Ve as useAgentContext,
-  Le as useAttachments,
-  He as useCapabilities,
-  De as useComponent,
-  Fe as useConfigureSuggestions,
+  Fe as useAttachments,
+  Le as useCapabilities,
+  He as useComponent,
+  De as useConfigureSuggestions,
   O as useCopilotAction,
   Ge as useCopilotChatConfiguration,
   y as useCopilotKit,
-  L as useCopilotReadable,
+  F as useCopilotReadable,
   $e as useDefaultRenderTool,
   V as useFrontendTool,
   b as useHumanInTheLoop,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/hooks/use-copilot-action.ts","../src/hooks/use-frontend-tool.ts","../src/hooks/use-copilot-readable.ts","../src/components/copilot-provider/CopilotKit.vue"],"sourcesContent":["/**\n * V1 compatibility wrapper for useCopilotAction.\n *\n * Accepts the legacy Parameter[] action format and routes to the appropriate\n * v2 composable (useFrontendTool, useHumanInTheLoop, or useRenderTool).\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport type { Parameter, MappedParameterTypes } from \"@copilotkit/shared\";\nimport { getZodParameters, parseJson } from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport { useHumanInTheLoop as useHumanInTheLoopV2 } from \"../v2/hooks/use-human-in-the-loop\";\nimport { useRenderTool as useRenderToolV2 } from \"../v2/hooks/use-render-tool\";\nimport type { VueFrontendTool, VueHumanInTheLoop } from \"../v2/types\";\n\n// Wraps a v1 render function so a JSON-string `result` is parsed before being\n// passed through. Mirrors the v1 React behavior. If render is a Component\n// (object) rather than a function, returns it unchanged — Components receive\n// props through Vue's prop system and the user is responsible for parsing.\nfunction wrapRenderWithJsonResult<R>(render: R): R {\n  if (typeof render !== \"function\") return render;\n  return ((props: { result?: unknown }) => {\n    const next =\n      typeof props.result === \"string\"\n        ? { ...props, result: parseJson(props.result, props.result) }\n        : props;\n    return (render as (p: unknown) => unknown)(next);\n  }) as R;\n}\n\nexport interface FrontendAction<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\" | \"remote\" | \"frontend\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWaitForResponse?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWait?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this action to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport interface CatchAllFrontendAction {\n  name: \"*\";\n  render: (props: unknown) => unknown;\n}\n\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  deps?: WatchSource<unknown>[],\n): void {\n  const zodParameters =\n    \"parameters\" in action\n      ? getZodParameters(action.parameters as T)\n      : undefined;\n\n  // Catch-all render action\n  if (action.name === \"*\") {\n    useRenderToolV2(\n      {\n        name: \"*\",\n        render: wrapRenderWithJsonResult(\n          (action as CatchAllFrontendAction).render,\n        ),\n        ...(\"agentId\" in action\n          ? { agentId: (action as FrontendAction<T>).agentId }\n          : {}),\n      },\n      deps,\n    );\n    return;\n  }\n\n  const typedAction = action as FrontendAction<T>;\n\n  // Human-in-the-loop: has renderAndWaitForResponse or renderAndWait\n  if (\n    \"renderAndWaitForResponse\" in typedAction ||\n    \"renderAndWait\" in typedAction\n  ) {\n    const render =\n      typedAction.render ??\n      typedAction.renderAndWaitForResponse ??\n      typedAction.renderAndWait;\n\n    if (!render) {\n      console.warn(\n        `[CopilotKit] useCopilotAction: HITL action '${typedAction.name}' ` +\n          `has no render function. Skipping.`,\n      );\n      return;\n    }\n\n    useHumanInTheLoopV2<MappedParameterTypes<T>>(\n      {\n        name: typedAction.name,\n        description: typedAction.description,\n        parameters: zodParameters,\n        render: wrapRenderWithJsonResult(render) as VueHumanInTheLoop<\n          MappedParameterTypes<T>\n        >[\"render\"],\n        agentId: typedAction.agentId,\n      },\n      deps,\n    );\n    return;\n  }\n\n  // Render-only: available is \"frontend\" or \"disabled\" (no handler invoked remotely)\n  if (\n    typedAction.available === \"frontend\" ||\n    typedAction.available === \"disabled\"\n  ) {\n    if (typedAction.render && zodParameters) {\n      useRenderToolV2(\n        {\n          name: typedAction.name,\n          parameters: zodParameters,\n          render: wrapRenderWithJsonResult(\n            typedAction.render as (props: unknown) => unknown,\n          ),\n          agentId: typedAction.agentId,\n        },\n        deps,\n      );\n    } else {\n      console.warn(\n        `[CopilotKit] useCopilotAction: action '${typedAction.name}' ` +\n          `with available=\"${typedAction.available}\" requires both ` +\n          `'render' and 'parameters'. Skipping registration.`,\n      );\n    }\n    return;\n  }\n\n  // Default: frontend tool with handler\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = typedAction.handler\n    ? (args: MappedParameterTypes<T>) =>\n        Promise.resolve(typedAction.handler!(args))\n    : undefined;\n\n  // Convert v1 available (string enum) to v2 available (boolean)\n  // At this point, \"frontend\" and \"disabled\" have been handled above,\n  // so remaining values are \"enabled\", \"remote\", or undefined.\n  // \"remote\" means server-only: register the tool but mark it as not\n  // available on the frontend (matches React's ActionInputAvailability.Remote).\n  let normalizedAvailable: boolean | undefined;\n  if (typedAction.available === \"remote\") {\n    normalizedAvailable = false;\n  } else if (typedAction.available !== undefined) {\n    normalizedAvailable = true;\n  }\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name: typedAction.name,\n      description: typedAction.description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp: typedAction.followUp,\n      render: wrapRenderWithJsonResult(typedAction.render),\n      available: normalizedAvailable,\n      agentId: typedAction.agentId,\n      // Read webmcp at watch time: the action object may expose it as a getter\n      // over reactive state, and capturing the initial value here would\n      // re-register a stale configuration.\n      get webmcp() {\n        return typedAction.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useFrontendTool.\n *\n * Accepts the legacy Parameter[] format and converts to Zod via getZodParameters,\n * then delegates to the v2 composable.\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport {\n  type Parameter,\n  type MappedParameterTypes,\n  getZodParameters,\n  parseJson,\n} from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport type { VueFrontendTool } from \"../v2/types\";\n\nexport interface UseFrontendToolArgs<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this tool to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  deps?: WatchSource<unknown>[],\n) {\n  const {\n    name,\n    description,\n    parameters,\n    handler,\n    followUp,\n    available,\n    render,\n    agentId,\n  } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = handler\n    ? (args: MappedParameterTypes<T>) => Promise.resolve(handler(args))\n    : undefined;\n\n  // Wrap render to parse JSON-string results before passing them to the\n  // user's render function — matches the v1 React behavior. If render is a\n  // Component rather than a function, leave it unchanged.\n  const normalizedRender =\n    typeof render === \"function\"\n      ? (props: { result?: unknown }) => {\n          const renderProps =\n            typeof props.result === \"string\"\n              ? { ...props, result: parseJson(props.result, props.result) }\n              : props;\n          return (render as (p: unknown) => unknown)(renderProps);\n        }\n      : render;\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name,\n      description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp,\n      render: normalizedRender,\n      available: available === undefined ? undefined : available !== \"disabled\",\n      agentId,\n      // Read webmcp at watch time: the v1 args may expose it as a getter over\n      // reactive state, and capturing the initial value here would re-register\n      // a stale configuration.\n      get webmcp() {\n        return tool.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useCopilotReadable.\n *\n * Provides app-state and other information to the Copilot context.\n * Delegates directly to the v2 CopilotKitCoreVue instance.\n */\nimport { watch, ref, type Ref } from \"vue\";\nimport type { WatchSource } from \"vue\";\nimport { useCopilotKit } from \"../v2/providers/useCopilotKit\";\n\nexport interface UseCopilotReadableOptions {\n  /** The description of the information to be added to the Copilot context. */\n  description: string;\n  /** The value to be added to the Copilot context. Object values are automatically stringified. */\n  value: unknown;\n  /** Whether the context is available to the Copilot. */\n  available?: \"enabled\" | \"disabled\";\n  /** Custom conversion function to serialize the value to a string. */\n  convert?: (description: string, value: unknown) => string;\n}\n\nexport function useCopilotReadable(\n  options: UseCopilotReadableOptions,\n  deps?: WatchSource<unknown>[],\n): Ref<string | undefined> {\n  const { copilotkit } = useCopilotKit();\n  const ctxIdRef = ref<string | undefined>(undefined);\n\n  const extraDeps = deps ?? [];\n\n  watch(\n    [\n      () => options.description,\n      () => options.value,\n      () => options.convert,\n      () => options.available,\n      ...extraDeps,\n    ],\n    (_newValues, _old, onCleanup) => {\n      const core = copilotkit.value;\n      if (!core) return;\n\n      const { description, value, convert, available } = options;\n\n      let serializedValue: string;\n      try {\n        serializedValue = convert\n          ? convert(description, value)\n          : JSON.stringify(value);\n      } catch (err) {\n        console.warn(\n          `[CopilotKit] useCopilotReadable: failed to serialize ` +\n            `value for \"${description}\":`,\n          err,\n        );\n        serializedValue = String(value);\n      }\n\n      if (available === \"disabled\") return;\n\n      ctxIdRef.value = core.addContext({\n        description,\n        value: serializedValue,\n      });\n\n      onCleanup(() => {\n        if (!ctxIdRef.value) return;\n        core.removeContext(ctxIdRef.value);\n      });\n    },\n    { immediate: true },\n  );\n\n  return ctxIdRef;\n}\n","<script setup lang=\"ts\">\n/**\n * V1 compatibility wrapper for CopilotKitProvider.\n *\n * Accepts the same props as CopilotKitProvider plus legacy v1 props\n * (publicApiKey, publicLicenseKey) and delegates to the v2 provider.\n */\nimport type { CopilotKitProps } from \"./types\";\nimport CopilotKitProvider from \"../../v2/providers/CopilotKitProvider.vue\";\n\nconst props = defineProps<CopilotKitProps>();\n</script>\n\n<template>\n  <CopilotKitProvider v-bind=\"props\">\n    <slot />\n  </CopilotKitProvider>\n</template>\n"],"names":["wrapRenderWithJsonResult","render","props","next","parseJson","useCopilotAction","action","deps","zodParameters","getZodParameters","useRenderToolV2","typedAction","useHumanInTheLoopV2","normalizedHandler","args","normalizedAvailable","useFrontendToolV2","useFrontendTool","tool","name","description","parameters","handler","followUp","available","agentId","renderProps","useCopilotReadable","options","copilotkit","useCopilotKit","ctxIdRef","ref","watch","_newValues","_old","onCleanup","core","value","convert","serializedValue","err","__props","_openBlock","_createBlock","CopilotKitProvider","_renderSlot","_ctx"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/hooks/use-copilot-action.ts","../src/hooks/use-frontend-tool.ts","../src/hooks/use-copilot-readable.ts","../src/components/copilot-provider/CopilotKit.vue"],"sourcesContent":["/**\n * V1 compatibility wrapper for useCopilotAction.\n *\n * Accepts the legacy Parameter[] action format and routes to the appropriate\n * v2 composable (useFrontendTool, useHumanInTheLoop, or useRenderTool).\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport type { Parameter, MappedParameterTypes } from \"@copilotkit/shared\";\nimport { getZodParameters, parseJson } from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport { useHumanInTheLoop as useHumanInTheLoopV2 } from \"../v2/hooks/use-human-in-the-loop\";\nimport { useRenderTool as useRenderToolV2 } from \"../v2/hooks/use-render-tool\";\nimport type { VueFrontendTool, VueHumanInTheLoop } from \"../v2/types\";\n\n// Wraps a v1 render function so a JSON-string `result` is parsed before being\n// passed through. Mirrors the v1 React behavior. If render is a Component\n// (object) rather than a function, returns it unchanged — Components receive\n// props through Vue's prop system and the user is responsible for parsing.\nfunction wrapRenderWithJsonResult<R>(render: R): R {\n  if (typeof render !== \"function\") return render;\n  return ((props: { result?: unknown }) => {\n    const next =\n      typeof props.result === \"string\"\n        ? { ...props, result: parseJson(props.result, props.result) }\n        : props;\n    return (render as (p: unknown) => unknown)(next);\n  }) as R;\n}\n\nexport interface FrontendAction<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\" | \"remote\" | \"frontend\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWaitForResponse?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  renderAndWait?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this action to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport interface CatchAllFrontendAction {\n  name: \"*\";\n  render: (props: unknown) => unknown;\n}\n\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  deps?: WatchSource<unknown>[],\n): void {\n  const zodParameters =\n    \"parameters\" in action\n      ? getZodParameters(action.parameters as T)\n      : undefined;\n\n  // Catch-all render action\n  if (action.name === \"*\") {\n    useRenderToolV2(\n      {\n        name: \"*\",\n        render: wrapRenderWithJsonResult(\n          (action as CatchAllFrontendAction).render,\n        ),\n        ...(\"agentId\" in action\n          ? { agentId: (action as FrontendAction<T>).agentId }\n          : {}),\n      },\n      deps,\n    );\n    return;\n  }\n\n  const typedAction = action as FrontendAction<T>;\n\n  // Human-in-the-loop: has renderAndWaitForResponse or renderAndWait\n  if (\n    \"renderAndWaitForResponse\" in typedAction ||\n    \"renderAndWait\" in typedAction\n  ) {\n    const render =\n      typedAction.render ??\n      typedAction.renderAndWaitForResponse ??\n      typedAction.renderAndWait;\n\n    if (!render) {\n      console.warn(\n        `[CopilotKit] useCopilotAction: HITL action '${typedAction.name}' ` +\n          `has no render function. Skipping.`,\n      );\n      return;\n    }\n\n    useHumanInTheLoopV2<MappedParameterTypes<T>>(\n      {\n        name: typedAction.name,\n        description: typedAction.description,\n        parameters: zodParameters,\n        render: wrapRenderWithJsonResult(render) as VueHumanInTheLoop<\n          MappedParameterTypes<T>\n        >[\"render\"],\n        agentId: typedAction.agentId,\n      },\n      deps,\n    );\n    return;\n  }\n\n  // Render-only: available is \"frontend\" or \"disabled\" (no handler invoked remotely)\n  if (\n    typedAction.available === \"frontend\" ||\n    typedAction.available === \"disabled\"\n  ) {\n    if (typedAction.render && zodParameters) {\n      useRenderToolV2(\n        {\n          name: typedAction.name,\n          parameters: zodParameters,\n          render: wrapRenderWithJsonResult(\n            typedAction.render as (props: unknown) => unknown,\n          ),\n          agentId: typedAction.agentId,\n        },\n        deps,\n      );\n    } else {\n      console.warn(\n        `[CopilotKit] useCopilotAction: action '${typedAction.name}' ` +\n          `with available=\"${typedAction.available}\" requires both ` +\n          `'render' and 'parameters'. Skipping registration.`,\n      );\n    }\n    return;\n  }\n\n  // Default: frontend tool with handler\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = typedAction.handler\n    ? (args: MappedParameterTypes<T>) =>\n        Promise.resolve(typedAction.handler!(args))\n    : undefined;\n\n  // Convert v1 available (string enum) to v2 available (boolean)\n  // At this point, \"frontend\" and \"disabled\" have been handled above,\n  // so remaining values are \"enabled\", \"remote\", or undefined.\n  // \"remote\" means server-only: register the tool but mark it as not\n  // available on the frontend (matches React's ActionInputAvailability.Remote).\n  let normalizedAvailable: boolean | undefined;\n  if (typedAction.available === \"remote\") {\n    normalizedAvailable = false;\n  } else if (typedAction.available !== undefined) {\n    normalizedAvailable = true;\n  }\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name: typedAction.name,\n      description: typedAction.description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp: typedAction.followUp,\n      render: wrapRenderWithJsonResult(typedAction.render),\n      available: normalizedAvailable,\n      agentId: typedAction.agentId,\n      // Read webmcp at watch time: the action object may expose it as a getter\n      // over reactive state, and capturing the initial value here would\n      // re-register a stale configuration.\n      get webmcp() {\n        return typedAction.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useFrontendTool.\n *\n * Accepts the legacy Parameter[] format and converts to Zod via getZodParameters,\n * then delegates to the v2 composable.\n */\nimport type { WatchSource } from \"vue\";\nimport type { WebMCPToolConfig } from \"@copilotkit/core\";\nimport {\n  type Parameter,\n  type MappedParameterTypes,\n  getZodParameters,\n  parseJson,\n} from \"@copilotkit/shared\";\nimport { useFrontendTool as useFrontendToolV2 } from \"../v2/hooks/use-frontend-tool\";\nimport type { VueFrontendTool } from \"../v2/types\";\n\nexport interface UseFrontendToolArgs<T extends Parameter[] | [] = []> {\n  name: string;\n  description?: string;\n  parameters?: T;\n  handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;\n  followUp?: boolean;\n  available?: \"disabled\" | \"enabled\";\n  render?: VueFrontendTool<MappedParameterTypes<T>>[\"render\"];\n  agentId?: string;\n  /**\n   * Also expose this tool to browser agents through the WebMCP API\n   * (`document.modelContext`). `true` uses default annotations;\n   * `{ annotations }` provides WebMCP annotations.\n   */\n  webmcp?: boolean | WebMCPToolConfig;\n}\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  deps?: WatchSource<unknown>[],\n) {\n  const {\n    name,\n    description,\n    parameters,\n    handler,\n    followUp,\n    available,\n    render,\n    agentId,\n  } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  // Wrap the v1 handler (single-arg) to match v2's (args, context) => Promise<unknown> signature\n  const normalizedHandler = handler\n    ? (args: MappedParameterTypes<T>) => Promise.resolve(handler(args))\n    : undefined;\n\n  // Wrap render to parse JSON-string results before passing them to the\n  // user's render function — matches the v1 React behavior. If render is a\n  // Component rather than a function, leave it unchanged.\n  const normalizedRender =\n    typeof render === \"function\"\n      ? (props: { result?: unknown }) => {\n          const renderProps =\n            typeof props.result === \"string\"\n              ? { ...props, result: parseJson(props.result, props.result) }\n              : props;\n          return (render as (p: unknown) => unknown)(renderProps);\n        }\n      : render;\n\n  useFrontendToolV2<MappedParameterTypes<T>>(\n    {\n      name,\n      description,\n      parameters: zodParameters,\n      handler: normalizedHandler,\n      followUp,\n      render: normalizedRender,\n      available: available === undefined ? undefined : available !== \"disabled\",\n      agentId,\n      // Read webmcp at watch time: the v1 args may expose it as a getter over\n      // reactive state, and capturing the initial value here would re-register\n      // a stale configuration.\n      get webmcp() {\n        return tool.webmcp;\n      },\n    },\n    deps,\n  );\n}\n","/**\n * V1 compatibility wrapper for useCopilotReadable.\n *\n * Provides app-state and other information to the Copilot context.\n * Delegates directly to the v2 CopilotKitCoreVue instance.\n */\nimport { watch, ref, type Ref } from \"vue\";\nimport type { WatchSource } from \"vue\";\nimport { useCopilotKit } from \"../v2/providers/useCopilotKit\";\n\nexport interface UseCopilotReadableOptions {\n  /** The description of the information to be added to the Copilot context. */\n  description: string;\n  /** The value to be added to the Copilot context. Object values are automatically stringified. */\n  value: unknown;\n  /** Whether the context is available to the Copilot. */\n  available?: \"enabled\" | \"disabled\";\n  /** Custom conversion function to serialize the value to a string. */\n  convert?: (description: string, value: unknown) => string;\n}\n\nexport function useCopilotReadable(\n  options: UseCopilotReadableOptions,\n  deps?: WatchSource<unknown>[],\n): Ref<string | undefined> {\n  const { copilotkit } = useCopilotKit();\n  const ctxIdRef = ref<string | undefined>(undefined);\n\n  const extraDeps = deps ?? [];\n\n  watch(\n    [\n      () => options.description,\n      () => options.value,\n      () => options.convert,\n      () => options.available,\n      ...extraDeps,\n    ],\n    (_newValues, _old, onCleanup) => {\n      const core = copilotkit.value;\n      if (!core) return;\n\n      const { description, value, convert, available } = options;\n\n      let serializedValue: string;\n      try {\n        serializedValue = convert\n          ? convert(description, value)\n          : JSON.stringify(value);\n      } catch (err) {\n        console.warn(\n          `[CopilotKit] useCopilotReadable: failed to serialize ` +\n            `value for \"${description}\":`,\n          err,\n        );\n        serializedValue = String(value);\n      }\n\n      if (available === \"disabled\") return;\n\n      ctxIdRef.value = core.addContext({\n        description,\n        value: serializedValue,\n      });\n\n      onCleanup(() => {\n        if (!ctxIdRef.value) return;\n        core.removeContext(ctxIdRef.value);\n      });\n    },\n    { immediate: true },\n  );\n\n  return ctxIdRef;\n}\n","<script setup lang=\"ts\">\n/**\n * V1 compatibility wrapper for CopilotKitProvider.\n *\n * Accepts the same props as CopilotKitProvider plus legacy v1 props\n * (publicApiKey, publicLicenseKey) and delegates to the v2 provider.\n */\nimport type { CopilotKitProps } from \"./types\";\nimport CopilotKitProvider from \"../../v2/providers/CopilotKitProvider.vue\";\n\nconst props = defineProps<CopilotKitProps>();\n</script>\n\n<template>\n  <CopilotKitProvider v-bind=\"props\">\n    <slot />\n  </CopilotKitProvider>\n</template>\n"],"names":["wrapRenderWithJsonResult","render","props","next","parseJson","useCopilotAction","action","deps","zodParameters","getZodParameters","useRenderToolV2","typedAction","useHumanInTheLoopV2","normalizedHandler","args","normalizedAvailable","useFrontendToolV2","useFrontendTool","tool","name","description","parameters","handler","followUp","available","agentId","renderProps","useCopilotReadable","options","copilotkit","useCopilotKit","ctxIdRef","ref","watch","_newValues","_old","onCleanup","core","value","convert","serializedValue","err","__props","_openBlock","_createBlock","CopilotKitProvider","_renderSlot","_ctx"],"mappings":"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"}