@copilotkit/vue 1.57.1

package/README.md

@@ -0,0 +1,396 @@
+# @copilotkit/vue
+
+Vue 3 bindings for CopilotKit2: providers, composables, and chat rendering primitives for integrating AI agents into Vue applications.
+
+## Documentation Location
+
+Vue-specific documentation does not belong in the shared `docs/` V2 reference unless the repository adds a dedicated Vue docs section there.
+
+- Keep package usage and API guidance in this README.
+- Keep parity policy, architectural translation decisions, strict test-port rules, and the living React-to-Vue matrix in [PARITY.md](./PARITY.md).
+- Put public-facing Vue API and component documentation in Vue Storybook under `examples/v2/vue/storybook`.
+
+## Parity Delivery Checklist
+
+The parity checklist and strict translatability rules are maintained in [PARITY.md](./PARITY.md). Use it as the source of truth for parity completion and for deciding when tests must mirror React literally.
+
+## Parity Workflow
+
+Follow [PARITY.md](./PARITY.md) for parity workflow. If a feature is not clearly near-100% translatable, discuss the API/test divergence before introducing a Vue-specific translation. Update the matrix in the same change when behavior or tests change.
+
+## Installation
+
+```bash
+pnpm add @copilotkit/vue @copilotkit/core
+```
+
+Import package styles once in your app entry:
+
+```ts
+import "@copilotkit/vue/styles.css";
+```
+
+`styles.css` is generated from `src/styles/globals.css` via Tailwind (`pnpm -C packages/vue build:css`).
+The Vue package styles are self-contained and do not require importing `@copilotkit/react/styles.css`.
+
+## Basic Usage
+
+```vue
+<script setup lang="ts">
+import { CopilotKitProvider } from "@copilotkit/vue";
+</script>
+
+<template>
+  <CopilotKitProvider runtime-url="/api/copilotkit">
+    <slot />
+  </CopilotKitProvider>
+</template>
+```
+
+## Provider Parity: `selfManagedAgents`, `onError`, and `a2ui`
+
+`CopilotKitProvider` supports React-parity provider controls for local agent registration and runtime error handling.
+
+```vue
+<script setup lang="ts">
+import { CopilotKitProvider } from "@copilotkit/vue";
+import type { CopilotKitCoreErrorCode } from "@copilotkit/core";
+
+function onProviderError(event: {
+  error: Error;
+  code: CopilotKitCoreErrorCode;
+  context: Record<string, any>;
+}) {
+  console.error(
+    "CopilotKit provider error",
+    event.code,
+    event.context,
+    event.error,
+  );
+}
+</script>
+
+<template>
+  <CopilotKitProvider
+    runtime-url="/api/copilotkit"
+    :self-managed-agents="{}"
+    :on-error="onProviderError"
+    :a2ui="{ theme: { mode: 'light' } }"
+  >
+    <slot />
+  </CopilotKitProvider>
+</template>
+```
+
+Notes:
+
+- `selfManagedAgents` is merged with `agents__unsafe_dev_only`, with `selfManagedAgents` taking precedence for duplicate IDs.
+- `onError` receives provider-scope core errors and is independent from chat-level `CopilotChat.onError`.
+- `a2ui.theme` customizes the built-in `a2ui-surface` fallback renderer when the runtime reports `a2uiEnabled: true`.
+
+### Provider `debug` logging
+
+`CopilotKitProvider` accepts a `debug` prop that mirrors the React `debug` surface. It toggles client-side debug logging on the underlying core and is kept in sync at runtime as the prop changes.
+
+Supported values match React parity:
+
+- `true` / `false` — enables or disables event + lifecycle logging (verbose payloads stay off).
+- `{ events?: boolean; lifecycle?: boolean; verbose?: boolean }` — granular control; `verbose` opts into full event payloads.
+
+```vue
+<script setup lang="ts">
+import { CopilotKitProvider, type DebugConfig } from "@copilotkit/vue";
+
+const debug: DebugConfig = { events: true, lifecycle: true, verbose: false };
+</script>
+
+<template>
+  <CopilotKitProvider runtime-url="/api/copilotkit" :debug="debug">
+    <slot />
+  </CopilotKitProvider>
+</template>
+```
+
+Prop updates are forwarded to the stable `CopilotKitCoreVue` instance via `setDebug(...)`, so changing `debug` at runtime does not recreate the provider or the core instance.
+
+## Chat Error Parity: `CopilotChat.onError`
+
+`CopilotChat` also exposes an `onError` callback with React-parity filtering semantics.
+It only forwards errors for the resolved chat agent (or global errors without an `agentId`).
+
+```vue
+<script setup lang="ts">
+import { CopilotChat } from "@copilotkit/vue";
+
+function onChatError(event: {
+  error: Error;
+  code: string;
+  context: Record<string, any>;
+}) {
+  console.error("CopilotChat error", event.code, event.context, event.error);
+}
+</script>
+
+<template>
+  <CopilotChat agent-id="default" :on-error="onChatError" />
+</template>
+```
+
+Notes:
+
+- Provider `onError` and chat `onError` are independent subscriptions and can both fire for the same matching error.
+- Chat `onError` ignores errors scoped to other `agentId` values.
+
+## Chat Rendering (Slot-Based)
+
+`@copilotkit/vue` uses Vue named/scoped slots for message, activity, and tool rendering:
+
+- `CopilotChatMessageView`
+- `CopilotChatToolCallsView`
+- `CopilotChatInput`
+
+```vue
+<template>
+  <CopilotChatMessageView :messages="messages" :is-running="isRunning">
+    <template #message-before="{ message, runId, messageIndexInRun }">
+      <MessageMeta
+        :id="message.id"
+        :run-id="runId"
+        :index-in-run="messageIndexInRun"
+      />
+    </template>
+
+    <template #assistant-message="{ message }">
+      <AssistantBubble :content="message.content" />
+    </template>
+
+    <template #activity-mcp-apps="{ content }">
+      <MyMcpActivity :content="content" />
+    </template>
+
+    <template #tool-call-search_docs="{ args, status, result }">
+      <SearchDocsToolCall :args="args" :status="status" :result="result" />
+    </template>
+
+    <template #tool-call="{ name, args, status }">
+      <GenericToolCall :name="name" :args="args" :status="status" />
+    </template>
+  </CopilotChatMessageView>
+</template>
+```
+
+Supported message-level slots:
+
+- `message-before`
+- `assistant-message`
+- `user-message`
+- `reasoning-message`
+- `activity-<activityType>` (dynamic)
+- `activity-message` (fallback)
+- `message-after`
+- `cursor`
+
+Supported tool-level slots:
+
+- `tool-call-<toolName>` (dynamic)
+- `tool-call` (fallback)
+
+## Programmatic Custom Message Registration
+
+Slots remain the primary Vue customization path for chat/message rendering. When you need reusable shared renderers with provider-managed ordering or agent scoping, `CopilotKitProvider` also accepts `render-custom-messages` as a secondary API.
+
+```vue
+<script setup lang="ts">
+import { CopilotKitProvider, CopilotChat } from "@copilotkit/vue";
+import { defineComponent } from "vue";
+
+const AuditBadge = defineComponent({
+  props: {
+    message: { type: Object, required: true },
+    position: { type: String, required: true },
+  },
+  template: `
+    <div
+      v-if="position === 'after' && message.role === 'assistant'"
+      :data-testid="'audit-' + message.id"
+    >
+      Audited
+    </div>
+  `,
+});
+
+const renderCustomMessages = [
+  { render: AuditBadge },
+  { agentId: "sales-agent", render: AuditBadge },
+];
+</script>
+
+<template>
+  <CopilotKitProvider
+    runtime-url="/api/copilotkit"
+    :render-custom-messages="renderCustomMessages"
+  >
+    <CopilotChat agent-id="sales-agent" />
+  </CopilotKitProvider>
+</template>
+```
+
+Use:
+
+- `#message-before` / `#message-after` for local template-level customization in a specific chat or message view
+- provider `render-custom-messages` for reusable renderer registration, ordered evaluation, and agent-scoped overrides
+
+## Reasoning Messages
+
+`CopilotChatMessageView` supports reasoning messages via the `reasoning-message` slot, with a default `CopilotChatReasoningMessage` fallback.
+
+Default reasoning behavior mirrors React semantics:
+
+- Shows `Thinking…` while the reasoning message is the latest streaming message.
+- Switches to `Thought for ...` when reasoning finishes.
+- Auto-opens while streaming and auto-collapses on completion.
+- Hides the chat-level cursor when the latest message is reasoning.
+
+## Current Scope
+
+- **Providers**: `CopilotKitProvider`, `CopilotChatConfigurationProvider`
+- **Composables**: `useCopilotKit`, `useCopilotChatConfiguration`, `useAgent`, `useAgentContext`, `useFrontendTool`, `useRenderTool`, `useDefaultRenderTool`, `useComponent`, `useHumanInTheLoop`, `useSuggestions`, `useConfigureSuggestions`, `useThreads`, `useInterrupt`
+- **Components**: `CopilotChat`, `CopilotKitInspector`, `CopilotChatAssistantMessage`, `CopilotChatUserMessage`, `CopilotChatReasoningMessage`, `CopilotChatMessageView`, `CopilotChatSuggestionPill`, `CopilotChatSuggestionView`, `CopilotChatInput`, `CopilotChatToggleButton`, `CopilotModalHeader`, `CopilotChatView`, `CopilotChatToolCallsView`, `CopilotSidebarView`, `CopilotPopupView`, `CopilotSidebar`, `CopilotPopup`, `MCPAppsActivityRenderer`, `A2UISurfaceActivityRenderer`
+- **Markdown Renderer**: `CopilotChatAssistantMessage` uses `streamdown-vue` (with KaTeX support)
+- **Core**: `CopilotKitCoreVue`
+
+## Threads
+
+```vue
+<script setup lang="ts">
+import { useThreads } from "@copilotkit/vue";
+
+const {
+  threads,
+  isLoading,
+  hasMoreThreads,
+  isFetchingMoreThreads,
+  fetchMoreThreads,
+  renameThread,
+  deleteThread,
+} = useThreads({
+  agentId: "agent-1",
+  includeArchived: false,
+  limit: 20,
+});
+
+function loadMoreThreads() {
+  if (hasMoreThreads.value && !isFetchingMoreThreads.value) {
+    fetchMoreThreads();
+  }
+}
+</script>
+
+<template>
+  <div v-if="isLoading">Loading…</div>
+  <ul v-else>
+    <li v-for="thread in threads" :key="thread.id">
+      {{ thread.name ?? "Untitled" }}
+      <button @click="renameThread(thread.id, 'Renamed')">Rename</button>
+      <button @click="deleteThread(thread.id)">Delete</button>
+    </li>
+  </ul>
+  <button
+    v-if="hasMoreThreads"
+    :disabled="isFetchingMoreThreads"
+    @click="loadMoreThreads"
+  >
+    {{ isFetchingMoreThreads ? "Loading..." : "Load more" }}
+  </button>
+</template>
+```
+
+`useThreads` is a headless composable for Intelligence-platform thread lists scoped to the runtime-authenticated user and provided `agentId`. It supports optional `includeArchived` and `limit` inputs, subscribes to realtime metadata updates when the runtime exposes a websocket URL, and returns reactive refs for `threads`, `isLoading`, `error`, `hasMoreThreads`, and `isFetchingMoreThreads`, plus `fetchMoreThreads()`.
+
+### `useInterrupt`
+
+`useInterrupt` handles agent `on_interrupt` events without requiring Vue users to write render functions or TSX.
+
+For in-chat usage, combine the composable with the `#interrupt` slot on `CopilotChat`:
+
+```vue
+<script setup lang="ts">
+import { useInterrupt } from "@copilotkit/vue";
+
+useInterrupt({
+  handler: async ({ event }) => ({ label: String(event.value) }),
+});
+</script>
+
+<template>
+  <CopilotChat>
+    <template #interrupt="{ event, result, resolve }">
+      <button @click="resolve({ approved: true, value: event.value })">
+        {{ result?.label ?? event.value }}
+      </button>
+    </template>
+  </CopilotChat>
+</template>
+```
+
+For manual placement, use `renderInChat: false` and consume the returned refs:
+
+```ts
+const { interrupt, result, hasInterrupt, resolveInterrupt } = useInterrupt({
+  renderInChat: false,
+});
+```
+
+## Icon Foundation (Internal)
+
+- Chat/UI components should import icons from `src/components/icons/index.ts`.
+- Do not import from `lucide-vue-next` directly in Vue package components.
+- This adapter is internal and intentionally not exported from the package root.
+
+## Text Input
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+import {
+  CopilotChatConfigurationProvider,
+  CopilotChatInput,
+} from "@copilotkit/vue";
+
+const input = ref("");
+
+function onSubmitMessage(value: string) {
+  console.log("submit:", value);
+}
+</script>
+
+<template>
+  <CopilotChatConfigurationProvider thread-id="thread-1" agent-id="default">
+    <CopilotChatInput
+      v-model="input"
+      :tools-menu="[
+        { label: 'Insert template', action: () => console.log('template') },
+      ]"
+      @submit-message="onSubmitMessage"
+      @add-file="() => {}"
+      @start-transcribe="() => {}"
+      @cancel-transcribe="() => {}"
+      @finish-transcribe="() => {}"
+    />
+  </CopilotChatConfigurationProvider>
+</template>
+```
+
+Key parity props:
+
+- `mode`: `"input" | "transcribe" | "processing"`
+- `toolsMenu`: nested menu items + separators (`"-"`)
+- `positioning`: `"static" | "absolute"`
+- `keyboardHeight`: number (mobile keyboard offset)
+- `showDisclaimer`: explicit override, otherwise defaults by positioning
+
+Key slots:
+
+- `text-area`, `send-button`, `add-menu-button`
+- `start-transcribe-button`, `cancel-transcribe-button`, `finish-transcribe-button`
+- `audio-recorder`, `disclaimer`, `layout`

package/dist/components/copilot-provider/CopilotKit.vue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * V1 compatibility wrapper for CopilotKitProvider.
+ *
+ * Accepts the same props as CopilotKitProvider plus legacy v1 props
+ * (publicApiKey, publicLicenseKey) and delegates to the v2 provider.
+ */
+import type { CopilotKitProps } from "./types";
+declare var __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<CopilotKitProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CopilotKitProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=CopilotKit.vue.d.ts.map

package/dist/components/copilot-provider/CopilotKit.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotKit.vue.d.ts","sourceRoot":"","sources":["../../../src/components/copilot-provider/CopilotKit.vue"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA4B/C,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAoB/C,QAAA,MAAM,eAAe,0SAMnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAQ1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/copilot-provider/index.d.ts

@@ -0,0 +1,3 @@
+export { default as CopilotKit } from "./CopilotKit.vue";
+export type { CopilotKitProps } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/copilot-provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/copilot-provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/components/copilot-provider/types.d.ts

@@ -0,0 +1,22 @@
+import type { CopilotKitProviderProps } from "../../v2/providers/CopilotKitProvider.types";
+/**
+ * V1 CopilotKit component props.
+ *
+ * Extends the v2 CopilotKitProviderProps with legacy v1-specific fields.
+ */
+export interface CopilotKitProps extends CopilotKitProviderProps {
+    /**
+     * Your Copilot Cloud API key.
+     * @deprecated Use publicLicenseKey with the v2 CopilotKitProvider instead.
+     */
+    publicApiKey?: string;
+    /**
+     * Your public license key for accessing premium CopilotKit features.
+     */
+    publicLicenseKey?: string;
+    /**
+     * The endpoint for the Copilot Runtime instance.
+     */
+    runtimeUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/copilot-provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/copilot-provider/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAE3F;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+export { useCopilotAction } from "./use-copilot-action";
+export type { FrontendAction, CatchAllFrontendAction, } from "./use-copilot-action";
+export { useFrontendTool } from "./use-frontend-tool";
+export type { UseFrontendToolArgs } from "./use-frontend-tool";
+export { useCopilotReadable } from "./use-copilot-readable";
+export type { UseCopilotReadableOptions } from "./use-copilot-readable";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/use-copilot-action.d.ts

@@ -0,0 +1,27 @@
+/**
+ * V1 compatibility wrapper for useCopilotAction.
+ *
+ * Accepts the legacy Parameter[] action format and routes to the appropriate
+ * v2 composable (useFrontendTool, useHumanInTheLoop, or useRenderTool).
+ */
+import type { WatchSource } from "vue";
+import type { Parameter, MappedParameterTypes } from "@copilotkit/shared";
+import type { VueFrontendTool } from "../v2/types";
+export interface FrontendAction<T extends Parameter[] | [] = []> {
+    name: string;
+    description?: string;
+    parameters?: T;
+    handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;
+    followUp?: boolean;
+    available?: "disabled" | "enabled" | "remote" | "frontend";
+    render?: VueFrontendTool<MappedParameterTypes<T>>["render"];
+    renderAndWaitForResponse?: VueFrontendTool<MappedParameterTypes<T>>["render"];
+    renderAndWait?: VueFrontendTool<MappedParameterTypes<T>>["render"];
+    agentId?: string;
+}
+export interface CatchAllFrontendAction {
+    name: "*";
+    render: (props: unknown) => unknown;
+}
+export declare function useCopilotAction<const T extends Parameter[] | [] = []>(action: FrontendAction<T> | CatchAllFrontendAction, deps?: WatchSource<unknown>[]): void;
+//# sourceMappingURL=use-copilot-action.d.ts.map

package/dist/hooks/use-copilot-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copilot-action.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copilot-action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK1E,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAiBtE,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC3D,MAAM,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5D,wBAAwB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9E,aAAa,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,EACpE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,sBAAsB,EAClD,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,GAC5B,IAAI,CAqHN"}

package/dist/hooks/use-copilot-readable.d.ts

@@ -0,0 +1,20 @@
+/**
+ * V1 compatibility wrapper for useCopilotReadable.
+ *
+ * Provides app-state and other information to the Copilot context.
+ * Delegates directly to the v2 CopilotKitCoreVue instance.
+ */
+import { type Ref } from "vue";
+import type { WatchSource } from "vue";
+export interface UseCopilotReadableOptions {
+    /** The description of the information to be added to the Copilot context. */
+    description: string;
+    /** The value to be added to the Copilot context. Object values are automatically stringified. */
+    value: unknown;
+    /** Whether the context is available to the Copilot. */
+    available?: "enabled" | "disabled";
+    /** Custom conversion function to serialize the value to a string. */
+    convert?: (description: string, value: unknown) => string;
+}
+export declare function useCopilotReadable(options: UseCopilotReadableOptions, deps?: WatchSource<unknown>[]): Ref<string | undefined>;
+//# sourceMappingURL=use-copilot-readable.d.ts.map

package/dist/hooks/use-copilot-readable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copilot-readable.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copilot-readable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAc,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAGvC,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACnC,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC3D;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,EAClC,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,GAC5B,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAkDzB"}

package/dist/hooks/use-frontend-tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * V1 compatibility wrapper for useFrontendTool.
+ *
+ * Accepts the legacy Parameter[] format and converts to Zod via getZodParameters,
+ * then delegates to the v2 composable.
+ */
+import type { WatchSource } from "vue";
+import { type Parameter, type MappedParameterTypes } from "@copilotkit/shared";
+import type { VueFrontendTool } from "../v2/types";
+export interface UseFrontendToolArgs<T extends Parameter[] | [] = []> {
+    name: string;
+    description?: string;
+    parameters?: T;
+    handler?: (args: MappedParameterTypes<T>) => unknown | Promise<unknown>;
+    followUp?: boolean;
+    available?: "disabled" | "enabled";
+    render?: VueFrontendTool<MappedParameterTypes<T>>["render"];
+    agentId?: string;
+}
+export declare function useFrontendTool<const T extends Parameter[] = []>(tool: UseFrontendToolArgs<T>, deps?: WatchSource<unknown>[]): void;
+//# sourceMappingURL=use-frontend-tool.d.ts.map

package/dist/hooks/use-frontend-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-frontend-tool.d.ts","sourceRoot":"","sources":["../../src/hooks/use-frontend-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,oBAAoB,EAG1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,EAC9D,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC5B,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,QA8C9B"}

package/dist/index.cjs

@@ -0,0 +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-BRL1Rpl-.cjs"),a=require("vue"),C=require("@copilotkit/shared");function m(n){return typeof n!="function"?n:(o=>{const r=typeof o.result=="string"?{...o,result:C.parseJson(o.result,o.result)}:o;return n(r)})}function _(n,o){const r="parameters"in n?C.getZodParameters(n.parameters):void 0;if(n.name==="*"){e.useRenderTool({name:"*",render:m(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:r,render:m(l),agentId:t.agentId},o);return}if(t.available==="frontend"||t.available==="disabled"){t.render&&r?e.useRenderTool({name:t.name,parameters:r,render:m(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:r,handler:c,followUp:t.followUp,render:m(t.render),available:s,agentId:t.agentId},o)}function b(n,o){const{name:r,description:t,parameters:c,handler:s,followUp:l,available:f,render:u,agentId:d}=n,p=C.getZodParameters(c),g=s?i=>Promise.resolve(s(i)):void 0,v=typeof u=="function"?(i=>{const h=typeof i.result=="string"?{...i,result:C.parseJson(i.result,i.result)}:i;return u(h)}):u;e.useFrontendTool({name:r,description:t,parameters:p,handler:g,followUp:l,render:v,available:f===void 0?void 0:f!=="disabled",agentId:d},o)}function I(n,o){const{copilotkit:r}=e.useCopilotKit(),t=a.ref(void 0),c=o??[];return a.watch([()=>n.description,()=>n.value,()=>n.convert,()=>n.available,...c],(s,l,f)=>{const u=r.value;if(!u)return;const{description:d,value:p,convert:g,available:v}=n;let i;try{i=g?g(d,p):JSON.stringify(p)}catch(h){console.warn(`[CopilotKit] useCopilotReadable: failed to serialize value for "${d}":`,h),i=String(p)}v!=="disabled"&&(t.value=u.addContext({description:d,value:i}),f(()=>{t.value&&u.removeContext(t.value)}))},{immediate:!0}),t}const R=a.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]},onError:{type:Function},a2ui:{},inspectorDefaultAnchor:{},debug:{type:[Boolean,Object]}},setup(n){const o=n;return(r,t)=>(a.openBlock(),a.createBlock(e._sfc_main$15,a.normalizeProps(a.guardReactiveProps(o)),{default:a.withCtx(()=>[a.renderSlot(r.$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.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;Object.defineProperty(exports,"createLicenseContextValue",{enumerable:!0,get:()=>C.createLicenseContextValue});exports.CopilotKit=R;exports.useCopilotAction=_;exports.useCopilotReadable=I;exports.useFrontendTool=b;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

@@ -0,0 +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 { 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\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    },\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 {\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\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    },\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.d.cts

@@ -0,0 +1,10 @@
+export * from "./v2";
+export { useCopilotAction } from "./hooks";
+export type { FrontendAction, CatchAllFrontendAction } from "./hooks";
+export { useFrontendTool } from "./hooks";
+export type { UseFrontendToolArgs } from "./hooks";
+export { useCopilotReadable } from "./hooks";
+export type { UseCopilotReadableOptions } from "./hooks";
+export { CopilotKit } from "./components/copilot-provider";
+export type { CopilotKitProps } from "./components/copilot-provider";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+export * from "./v2";
+export { useCopilotAction } from "./hooks";
+export type { FrontendAction, CatchAllFrontendAction } from "./hooks";
+export { useFrontendTool } from "./hooks";
+export type { UseFrontendToolArgs } from "./hooks";
+export { useCopilotReadable } from "./hooks";
+export type { UseCopilotReadableOptions } from "./hooks";
+export { CopilotKit } from "./components/copilot-provider";
+export type { CopilotKitProps } from "./components/copilot-provider";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./v2";
+export { useCopilotAction } from "./hooks";
+export type { FrontendAction, CatchAllFrontendAction } from "./hooks";
+export { useFrontendTool } from "./hooks";
+export type { UseFrontendToolArgs } from "./hooks";
+export { useCopilotReadable } from "./hooks";
+export type { UseCopilotReadableOptions } from "./hooks";
+export { CopilotKit } from "./components/copilot-provider";
+export type { CopilotKitProps } from "./components/copilot-provider";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}