@useago/sdk 0.1.6 → 0.1.7

package/dist/vue/composables/useMessages.d.ts

@@ -0,0 +1,89 @@
+import type { AgoClient } from "../../client/AgoClient";
+import type { AgoMessage } from "../../client/types";
+export interface UseMessagesOptions {
+    client?: AgoClient;
+    conversationId?: string;
+}
+/**
+ * Composable to manage messages in a conversation.
+ *
+ * ```ts
+ * const { messages, sendMessage, isLoading } = useMessages();
+ * ```
+ */
+export declare function useMessages(options?: UseMessagesOptions): {
+    messages: import("vue").Ref<{
+        id: string;
+        conversationId: string;
+        content: string;
+        role: "user" | "assistant";
+        status: import("../..").MessageStatus;
+        agent?: {
+            id: string;
+            name: string;
+            displayName?: string | undefined;
+        } | undefined;
+        sources?: {
+            id: string;
+            title: string;
+            url?: string | undefined;
+        }[] | undefined;
+        toolCalls?: {
+            id: string;
+            type: import("../..").ToolCallType;
+            status: string;
+            toolName: string;
+            toolDisplayName?: string | undefined;
+            message?: string | undefined;
+            formSchema?: {
+                type: "object";
+                properties: Record<string, import("../..").FormField>;
+                required?: string[] | undefined;
+            } | undefined;
+            data?: Record<string, unknown> | undefined;
+            functionName?: string | undefined;
+            arguments?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        followUpReplies?: string[] | undefined;
+        createdAt: Date;
+    }[], AgoMessage[] | {
+        id: string;
+        conversationId: string;
+        content: string;
+        role: "user" | "assistant";
+        status: import("../..").MessageStatus;
+        agent?: {
+            id: string;
+            name: string;
+            displayName?: string | undefined;
+        } | undefined;
+        sources?: {
+            id: string;
+            title: string;
+            url?: string | undefined;
+        }[] | undefined;
+        toolCalls?: {
+            id: string;
+            type: import("../..").ToolCallType;
+            status: string;
+            toolName: string;
+            toolDisplayName?: string | undefined;
+            message?: string | undefined;
+            formSchema?: {
+                type: "object";
+                properties: Record<string, import("../..").FormField>;
+                required?: string[] | undefined;
+            } | undefined;
+            data?: Record<string, unknown> | undefined;
+            functionName?: string | undefined;
+            arguments?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        followUpReplies?: string[] | undefined;
+        createdAt: Date;
+    }[]>;
+    isLoading: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<Error | null, Error | null>;
+    conversationId: import("vue").Ref<string | undefined, string | undefined>;
+    sendMessage: (content: string, files?: File[]) => Promise<AgoMessage | null>;
+    clearMessages: () => void;
+};

package/dist/vue/index.d.ts

@@ -0,0 +1,10 @@
+export { AgoPlugin } from "./plugin";
+export type { AgoPluginOptions } from "./plugin";
+export { useAgo } from "./composables/useAgo";
+export { useChat } from "./composables/useChat";
+export { useMessages } from "./composables/useMessages";
+export { useConversation } from "./composables/useConversation";
+export { useAgoFunction, useAgoNavigation } from "./composables/useAgoFunction";
+export { useAgoEvents } from "./composables/useAgoEvents";
+export { AGO_CLIENT_KEY } from "./symbols";
+export type { AgoConfig, AgoMessage, Conversation, AgoAgent, AgoSource, ToolCallData, } from "../client/types";

package/dist/vue/plugin.d.ts

@@ -0,0 +1,16 @@
+import type { App } from "vue";
+import type { AgoConfig } from "../client/types";
+export interface AgoPluginOptions extends AgoConfig {
+}
+/**
+ * Vue plugin that provides an AgoClient to the entire app via inject/provide.
+ *
+ * ```ts
+ * import { AgoPlugin } from "@useago/sdk/vue";
+ *
+ * app.use(AgoPlugin, { baseUrl: "https://YOUR-DOMAIN.useago.com" });
+ * ```
+ */
+export declare const AgoPlugin: {
+    install(app: App, options: AgoPluginOptions): void;
+};

package/dist/vue/symbols.d.ts

@@ -0,0 +1,3 @@
+import type { InjectionKey } from "vue";
+import type { AgoClient } from "../client/AgoClient";
+export declare const AGO_CLIENT_KEY: InjectionKey<AgoClient>;

package/dist/vue.cjs

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const AgoClient = require("./AgoClient-BDO4avLq.cjs");
+const vue = require("vue");
+const AGO_CLIENT_KEY = Symbol("ago-client");
+const AgoPlugin = {
+  install(app, options) {
+    const client = new AgoClient.AgoClient(options);
+    app.provide(AGO_CLIENT_KEY, client);
+  }
+};
+function useAgo(config) {
+  if (config) {
+    return new AgoClient.AgoClient(config);
+  }
+  const client = vue.inject(AGO_CLIENT_KEY);
+  if (!client) {
+    throw new Error(
+      "useAgo(): no AgoClient found. Either pass config or install AgoPlugin."
+    );
+  }
+  return client;
+}
+function useMessages(options = {}) {
+  const client = options.client ?? useAgo();
+  const messages = vue.ref([]);
+  const conversationId = vue.ref(options.conversationId);
+  const isLoading = vue.ref(false);
+  const error = vue.ref(null);
+  const handleStart = (data) => {
+    if (!conversationId.value) {
+      conversationId.value = data.conversationId;
+    }
+  };
+  const handleChunk = (data) => {
+    const idx = messages.value.findIndex((m) => m.id === data.messageId);
+    if (idx >= 0) {
+      messages.value[idx] = {
+        ...messages.value[idx],
+        content: messages.value[idx].content + data.content
+      };
+    }
+  };
+  const handleComplete = (message) => {
+    const idx = messages.value.findIndex((m) => m.id === message.id);
+    if (idx >= 0) {
+      messages.value[idx] = message;
+    } else {
+      messages.value.push(message);
+    }
+    isLoading.value = false;
+  };
+  const handleError = (data) => {
+    error.value = new Error(data.error);
+    isLoading.value = false;
+  };
+  vue.onMounted(() => {
+    client.on("message:start", handleStart);
+    client.on("message:chunk", handleChunk);
+    client.on("message:complete", handleComplete);
+    client.on("message:error", handleError);
+  });
+  vue.onUnmounted(() => {
+    client.off("message:start", handleStart);
+    client.off("message:chunk", handleChunk);
+    client.off("message:complete", handleComplete);
+    client.off("message:error", handleError);
+  });
+  async function sendMessage(content, files) {
+    isLoading.value = true;
+    error.value = null;
+    const userMsg = {
+      id: `temp-${Date.now()}`,
+      conversationId: conversationId.value || "",
+      content,
+      role: "user",
+      status: "DONE",
+      createdAt: /* @__PURE__ */ new Date()
+    };
+    const assistantMsg = {
+      id: `temp-assistant-${Date.now()}`,
+      conversationId: conversationId.value || "",
+      content: "",
+      role: "assistant",
+      status: "IN_PROGRESS",
+      createdAt: /* @__PURE__ */ new Date()
+    };
+    messages.value.push(userMsg, assistantMsg);
+    try {
+      const response = await client.sendMessage(content, {
+        conversationId: conversationId.value,
+        files
+      });
+      if (response.conversationId && !conversationId.value) {
+        conversationId.value = response.conversationId;
+      }
+      messages.value = messages.value.filter((m) => !m.id.startsWith("temp-"));
+      const updatedUser = { ...userMsg, id: userMsg.id.replace("temp-", "user-"), conversationId: response.conversationId };
+      if (!messages.value.some((m) => m.id === response.id)) {
+        messages.value.push(updatedUser, response);
+      } else {
+        messages.value.push(updatedUser);
+      }
+      return response;
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to send");
+      isLoading.value = false;
+      messages.value = messages.value.filter((m) => !m.id.startsWith("temp-"));
+      return null;
+    }
+  }
+  function clearMessages() {
+    messages.value = [];
+    conversationId.value = void 0;
+    error.value = null;
+  }
+  return { messages, isLoading, error, conversationId, sendMessage, clearMessages };
+}
+function useConversation(options = {}) {
+  const client = options.client ?? useAgo();
+  const autoLoad = options.autoLoad ?? true;
+  const conversations = vue.ref([]);
+  const currentConversation = vue.ref(null);
+  const isLoading = vue.ref(false);
+  const error = vue.ref(null);
+  async function refreshConversations() {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      conversations.value = await client.getConversations();
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to load conversations");
+    } finally {
+      isLoading.value = false;
+    }
+  }
+  async function selectConversation(id) {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      currentConversation.value = await client.getConversation(id);
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to load conversation");
+    } finally {
+      isLoading.value = false;
+    }
+  }
+  function startNewConversation() {
+    currentConversation.value = null;
+  }
+  vue.onMounted(() => {
+    if (autoLoad) refreshConversations();
+  });
+  return {
+    conversations,
+    currentConversation,
+    isLoading,
+    error,
+    selectConversation,
+    startNewConversation,
+    refreshConversations
+  };
+}
+function useChat(options = {}) {
+  const msgResult = useMessages({
+    client: options.client,
+    conversationId: options.conversationId
+  });
+  const convResult = useConversation({
+    client: options.client,
+    autoLoad: options.autoLoad
+  });
+  const error = vue.computed(
+    () => msgResult.error.value || convResult.error.value
+  );
+  return {
+    // Messages
+    messages: msgResult.messages,
+    isLoading: msgResult.isLoading,
+    error,
+    sendMessage: msgResult.sendMessage,
+    clearMessages: msgResult.clearMessages,
+    conversationId: msgResult.conversationId,
+    // Conversations
+    conversations: convResult.conversations,
+    currentConversation: convResult.currentConversation,
+    isConversationsLoading: convResult.isLoading,
+    selectConversation: convResult.selectConversation,
+    startNewConversation: convResult.startNewConversation,
+    refreshConversations: convResult.refreshConversations
+  };
+}
+function useAgoFunction(name, options) {
+  const client = useAgo();
+  vue.onMounted(() => {
+    client.registerFunction(name, options.handler, {
+      description: options.description,
+      parameters: options.parameters
+    });
+  });
+  vue.onUnmounted(() => {
+    client.unregisterFunction(name);
+  });
+}
+function useAgoNavigation(navigate, routes) {
+  const client = useAgo();
+  vue.onMounted(() => {
+    client.registerNavigationFunction(navigate, routes);
+  });
+  vue.onUnmounted(() => {
+    client.unregisterFunction("navigateToPage");
+  });
+}
+function useAgoEvents(event, handler) {
+  const client = useAgo();
+  vue.onMounted(() => {
+    client.on(event, handler);
+  });
+  vue.onUnmounted(() => {
+    client.off(event, handler);
+  });
+}
+exports.AGO_CLIENT_KEY = AGO_CLIENT_KEY;
+exports.AgoPlugin = AgoPlugin;
+exports.useAgo = useAgo;
+exports.useAgoEvents = useAgoEvents;
+exports.useAgoFunction = useAgoFunction;
+exports.useAgoNavigation = useAgoNavigation;
+exports.useChat = useChat;
+exports.useConversation = useConversation;
+exports.useMessages = useMessages;
+//# sourceMappingURL=vue.cjs.map

package/dist/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.cjs","sources":["../src/vue/symbols.ts","../src/vue/plugin.ts","../src/vue/composables/useAgo.ts","../src/vue/composables/useMessages.ts","../src/vue/composables/useConversation.ts","../src/vue/composables/useChat.ts","../src/vue/composables/useAgoFunction.ts","../src/vue/composables/useAgoEvents.ts"],"sourcesContent":["import type { InjectionKey } from \"vue\";\nimport type { AgoClient } from \"../client/AgoClient\";\n\nexport const AGO_CLIENT_KEY: InjectionKey<AgoClient> = Symbol(\"ago-client\");\n","import type { App } from \"vue\";\nimport { AgoClient } from \"../client/AgoClient\";\nimport type { AgoConfig } from \"../client/types\";\nimport { AGO_CLIENT_KEY } from \"./symbols\";\n\nexport interface AgoPluginOptions extends AgoConfig {}\n\n/**\n * Vue plugin that provides an AgoClient to the entire app via inject/provide.\n *\n * ```ts\n * import { AgoPlugin } from \"@useago/sdk/vue\";\n *\n * app.use(AgoPlugin, { baseUrl: \"https://YOUR-DOMAIN.useago.com\" });\n * ```\n */\nexport const AgoPlugin = {\n  install(app: App, options: AgoPluginOptions) {\n    const client = new AgoClient(options);\n    app.provide(AGO_CLIENT_KEY, client);\n  },\n};\n","import { inject } from \"vue\";\nimport { AgoClient } from \"../../client/AgoClient\";\nimport type { AgoConfig } from \"../../client/types\";\nimport { AGO_CLIENT_KEY } from \"../symbols\";\n\n/**\n * Get or create an AgoClient.\n *\n * - Without args: returns the client from `AgoPlugin` (throws if none).\n * - With config: creates a new client instance.\n *\n * ```ts\n * // From plugin\n * const client = useAgo();\n *\n * // Standalone\n * const client = useAgo({ baseUrl: \"https://YOUR-DOMAIN.useago.com\" });\n * ```\n */\nexport function useAgo(config?: AgoConfig): AgoClient {\n  if (config) {\n    return new AgoClient(config);\n  }\n\n  const client = inject(AGO_CLIENT_KEY);\n  if (!client) {\n    throw new Error(\n      \"useAgo(): no AgoClient found. Either pass config or install AgoPlugin.\"\n    );\n  }\n  return client;\n}\n","import { ref, onMounted, onUnmounted } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport type { AgoMessage } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\nexport interface UseMessagesOptions {\n  client?: AgoClient;\n  conversationId?: string;\n}\n\n/**\n * Composable to manage messages in a conversation.\n *\n * ```ts\n * const { messages, sendMessage, isLoading } = useMessages();\n * ```\n */\nexport function useMessages(options: UseMessagesOptions = {}) {\n  const client = options.client ?? useAgo();\n\n  const messages = ref<AgoMessage[]>([]);\n  const conversationId = ref<string | undefined>(options.conversationId);\n  const isLoading = ref(false);\n  const error = ref<Error | null>(null);\n\n  const handleStart = (data: { conversationId: string; messageId: string }) => {\n    if (!conversationId.value) {\n      conversationId.value = data.conversationId;\n    }\n  };\n\n  const handleChunk = (data: { content: string; messageId: string }) => {\n    const idx = messages.value.findIndex((m: AgoMessage) => m.id === data.messageId);\n    if (idx >= 0) {\n      messages.value[idx] = {\n        ...messages.value[idx],\n        content: messages.value[idx].content + data.content,\n      };\n    }\n  };\n\n  const handleComplete = (message: AgoMessage) => {\n    const idx = messages.value.findIndex((m: AgoMessage) => m.id === message.id);\n    if (idx >= 0) {\n      messages.value[idx] = message;\n    } else {\n      messages.value.push(message);\n    }\n    isLoading.value = false;\n  };\n\n  const handleError = (data: { error: string }) => {\n    error.value = new Error(data.error);\n    isLoading.value = false;\n  };\n\n  onMounted(() => {\n    client.on(\"message:start\", handleStart);\n    client.on(\"message:chunk\", handleChunk);\n    client.on(\"message:complete\", handleComplete);\n    client.on(\"message:error\", handleError);\n  });\n\n  onUnmounted(() => {\n    client.off(\"message:start\", handleStart);\n    client.off(\"message:chunk\", handleChunk);\n    client.off(\"message:complete\", handleComplete);\n    client.off(\"message:error\", handleError);\n  });\n\n  async function sendMessage(content: string, files?: File[]): Promise<AgoMessage | null> {\n    isLoading.value = true;\n    error.value = null;\n\n    // Optimistic user message\n    const userMsg: AgoMessage = {\n      id: `temp-${Date.now()}`,\n      conversationId: conversationId.value || \"\",\n      content,\n      role: \"user\",\n      status: \"DONE\",\n      createdAt: new Date(),\n    };\n    const assistantMsg: AgoMessage = {\n      id: `temp-assistant-${Date.now()}`,\n      conversationId: conversationId.value || \"\",\n      content: \"\",\n      role: \"assistant\",\n      status: \"IN_PROGRESS\",\n      createdAt: new Date(),\n    };\n    messages.value.push(userMsg, assistantMsg);\n\n    try {\n      const response = await client.sendMessage(content, {\n        conversationId: conversationId.value,\n        files,\n      });\n      if (response.conversationId && !conversationId.value) {\n        conversationId.value = response.conversationId;\n      }\n      // Replace temp messages\n      messages.value = messages.value.filter((m: AgoMessage) => !m.id.startsWith(\"temp-\"));\n      const updatedUser = { ...userMsg, id: userMsg.id.replace(\"temp-\", \"user-\"), conversationId: response.conversationId };\n      if (!messages.value.some((m: AgoMessage) => m.id === response.id)) {\n        messages.value.push(updatedUser, response);\n      } else {\n        messages.value.push(updatedUser);\n      }\n      return response;\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to send\");\n      isLoading.value = false;\n      messages.value = messages.value.filter((m: AgoMessage) => !m.id.startsWith(\"temp-\"));\n      return null;\n    }\n  }\n\n  function clearMessages() {\n    messages.value = [];\n    conversationId.value = undefined;\n    error.value = null;\n  }\n\n  return { messages, isLoading, error, conversationId, sendMessage, clearMessages };\n}\n","import { ref, onMounted } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport type { Conversation } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\nexport interface UseConversationOptions {\n  client?: AgoClient;\n  autoLoad?: boolean;\n}\n\n/**\n * Composable to manage conversations.\n *\n * ```ts\n * const { conversations, selectConversation } = useConversation();\n * ```\n */\nexport function useConversation(options: UseConversationOptions = {}) {\n  const client = options.client ?? useAgo();\n  const autoLoad = options.autoLoad ?? true;\n\n  const conversations = ref<Conversation[]>([]);\n  const currentConversation = ref<Conversation | null>(null);\n  const isLoading = ref(false);\n  const error = ref<Error | null>(null);\n\n  async function refreshConversations() {\n    isLoading.value = true;\n    error.value = null;\n    try {\n      conversations.value = await client.getConversations();\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to load conversations\");\n    } finally {\n      isLoading.value = false;\n    }\n  }\n\n  async function selectConversation(id: string) {\n    isLoading.value = true;\n    error.value = null;\n    try {\n      currentConversation.value = await client.getConversation(id);\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to load conversation\");\n    } finally {\n      isLoading.value = false;\n    }\n  }\n\n  function startNewConversation() {\n    currentConversation.value = null;\n  }\n\n  onMounted(() => {\n    if (autoLoad) refreshConversations();\n  });\n\n  return {\n    conversations,\n    currentConversation,\n    isLoading,\n    error,\n    selectConversation,\n    startNewConversation,\n    refreshConversations,\n  };\n}\n","import { computed } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport { useMessages } from \"./useMessages\";\nimport { useConversation } from \"./useConversation\";\n\nexport interface UseChatOptions {\n  client?: AgoClient;\n  conversationId?: string;\n  autoLoad?: boolean;\n}\n\n/**\n * All-in-one composable combining messages + conversations.\n *\n * ```ts\n * const { messages, sendMessage, conversations, selectConversation } = useChat();\n * ```\n */\nexport function useChat(options: UseChatOptions = {}) {\n  const msgResult = useMessages({\n    client: options.client,\n    conversationId: options.conversationId,\n  });\n\n  const convResult = useConversation({\n    client: options.client,\n    autoLoad: options.autoLoad,\n  });\n\n  const error = computed(\n    () => msgResult.error.value || convResult.error.value\n  );\n\n  return {\n    // Messages\n    messages: msgResult.messages,\n    isLoading: msgResult.isLoading,\n    error,\n    sendMessage: msgResult.sendMessage,\n    clearMessages: msgResult.clearMessages,\n    conversationId: msgResult.conversationId,\n    // Conversations\n    conversations: convResult.conversations,\n    currentConversation: convResult.currentConversation,\n    isConversationsLoading: convResult.isLoading,\n    selectConversation: convResult.selectConversation,\n    startNewConversation: convResult.startNewConversation,\n    refreshConversations: convResult.refreshConversations,\n  };\n}\n","import { onMounted, onUnmounted } from \"vue\";\nimport type { ClientFunctionHandler, ClientFunctionSchema } from \"../../functions/types\";\nimport { useAgo } from \"./useAgo\";\n\n/**\n * Register a client-side function with auto-cleanup on unmount.\n *\n * ```ts\n * useAgoFunction(\"showToast\", {\n *   description: \"Show a toast\",\n *   parameters: { type: \"object\", properties: { message: { type: \"string\" } } },\n *   handler: async (args) => { toast(args.message); return { shown: true }; },\n * });\n * ```\n */\nexport function useAgoFunction(\n  name: string,\n  options: {\n    description: string;\n    parameters: ClientFunctionSchema[\"parameters\"];\n    handler: ClientFunctionHandler;\n  }\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.registerFunction(name, options.handler, {\n      description: options.description,\n      parameters: options.parameters,\n    });\n  });\n\n  onUnmounted(() => {\n    client.unregisterFunction(name);\n  });\n}\n\nexport interface AgoRoute {\n  name: string;\n  path: string;\n  description: string;\n}\n\n/**\n * Register navigation routes with auto-cleanup on unmount.\n * Works with vue-router's `useRouter().push`.\n *\n * ```ts\n * const router = useRouter();\n * useAgoNavigation((path) => router.push(path), [\n *   { name: \"dashboard\", path: \"/dashboard\", description: \"Main dashboard\" },\n * ]);\n * ```\n */\nexport function useAgoNavigation(\n  navigate: (path: string) => void,\n  routes: AgoRoute[]\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.registerNavigationFunction(navigate, routes);\n  });\n\n  onUnmounted(() => {\n    client.unregisterFunction(\"navigateToPage\");\n  });\n}\n","import { onMounted, onUnmounted } from \"vue\";\nimport type { AgoClientEvents, AgoEventName } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\n/**\n * Subscribe to AGO client events with auto-cleanup on unmount.\n *\n * ```ts\n * useAgoEvents(\"message:complete\", (msg) => {\n *   console.log(\"Got message:\", msg.content);\n * });\n * ```\n */\nexport function useAgoEvents<K extends AgoEventName>(\n  event: K,\n  handler: (data: AgoClientEvents[K]) => void\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.on(event, handler);\n  });\n\n  onUnmounted(() => {\n    client.off(event, handler);\n  });\n}\n"],"names":["AgoClient","inject","ref","onMounted","onUnmounted","computed"],"mappings":"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"}

package/dist/vue.d.ts

@@ -0,0 +1 @@
+export * from './vue/index'

package/dist/vue.js

@@ -0,0 +1,232 @@
+import { A as AgoClient } from "./AgoClient-D-c91tx5.js";
+import { inject, ref, onMounted, onUnmounted, computed } from "vue";
+const AGO_CLIENT_KEY = Symbol("ago-client");
+const AgoPlugin = {
+  install(app, options) {
+    const client = new AgoClient(options);
+    app.provide(AGO_CLIENT_KEY, client);
+  }
+};
+function useAgo(config) {
+  if (config) {
+    return new AgoClient(config);
+  }
+  const client = inject(AGO_CLIENT_KEY);
+  if (!client) {
+    throw new Error(
+      "useAgo(): no AgoClient found. Either pass config or install AgoPlugin."
+    );
+  }
+  return client;
+}
+function useMessages(options = {}) {
+  const client = options.client ?? useAgo();
+  const messages = ref([]);
+  const conversationId = ref(options.conversationId);
+  const isLoading = ref(false);
+  const error = ref(null);
+  const handleStart = (data) => {
+    if (!conversationId.value) {
+      conversationId.value = data.conversationId;
+    }
+  };
+  const handleChunk = (data) => {
+    const idx = messages.value.findIndex((m) => m.id === data.messageId);
+    if (idx >= 0) {
+      messages.value[idx] = {
+        ...messages.value[idx],
+        content: messages.value[idx].content + data.content
+      };
+    }
+  };
+  const handleComplete = (message) => {
+    const idx = messages.value.findIndex((m) => m.id === message.id);
+    if (idx >= 0) {
+      messages.value[idx] = message;
+    } else {
+      messages.value.push(message);
+    }
+    isLoading.value = false;
+  };
+  const handleError = (data) => {
+    error.value = new Error(data.error);
+    isLoading.value = false;
+  };
+  onMounted(() => {
+    client.on("message:start", handleStart);
+    client.on("message:chunk", handleChunk);
+    client.on("message:complete", handleComplete);
+    client.on("message:error", handleError);
+  });
+  onUnmounted(() => {
+    client.off("message:start", handleStart);
+    client.off("message:chunk", handleChunk);
+    client.off("message:complete", handleComplete);
+    client.off("message:error", handleError);
+  });
+  async function sendMessage(content, files) {
+    isLoading.value = true;
+    error.value = null;
+    const userMsg = {
+      id: `temp-${Date.now()}`,
+      conversationId: conversationId.value || "",
+      content,
+      role: "user",
+      status: "DONE",
+      createdAt: /* @__PURE__ */ new Date()
+    };
+    const assistantMsg = {
+      id: `temp-assistant-${Date.now()}`,
+      conversationId: conversationId.value || "",
+      content: "",
+      role: "assistant",
+      status: "IN_PROGRESS",
+      createdAt: /* @__PURE__ */ new Date()
+    };
+    messages.value.push(userMsg, assistantMsg);
+    try {
+      const response = await client.sendMessage(content, {
+        conversationId: conversationId.value,
+        files
+      });
+      if (response.conversationId && !conversationId.value) {
+        conversationId.value = response.conversationId;
+      }
+      messages.value = messages.value.filter((m) => !m.id.startsWith("temp-"));
+      const updatedUser = { ...userMsg, id: userMsg.id.replace("temp-", "user-"), conversationId: response.conversationId };
+      if (!messages.value.some((m) => m.id === response.id)) {
+        messages.value.push(updatedUser, response);
+      } else {
+        messages.value.push(updatedUser);
+      }
+      return response;
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to send");
+      isLoading.value = false;
+      messages.value = messages.value.filter((m) => !m.id.startsWith("temp-"));
+      return null;
+    }
+  }
+  function clearMessages() {
+    messages.value = [];
+    conversationId.value = void 0;
+    error.value = null;
+  }
+  return { messages, isLoading, error, conversationId, sendMessage, clearMessages };
+}
+function useConversation(options = {}) {
+  const client = options.client ?? useAgo();
+  const autoLoad = options.autoLoad ?? true;
+  const conversations = ref([]);
+  const currentConversation = ref(null);
+  const isLoading = ref(false);
+  const error = ref(null);
+  async function refreshConversations() {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      conversations.value = await client.getConversations();
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to load conversations");
+    } finally {
+      isLoading.value = false;
+    }
+  }
+  async function selectConversation(id) {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      currentConversation.value = await client.getConversation(id);
+    } catch (err) {
+      error.value = err instanceof Error ? err : new Error("Failed to load conversation");
+    } finally {
+      isLoading.value = false;
+    }
+  }
+  function startNewConversation() {
+    currentConversation.value = null;
+  }
+  onMounted(() => {
+    if (autoLoad) refreshConversations();
+  });
+  return {
+    conversations,
+    currentConversation,
+    isLoading,
+    error,
+    selectConversation,
+    startNewConversation,
+    refreshConversations
+  };
+}
+function useChat(options = {}) {
+  const msgResult = useMessages({
+    client: options.client,
+    conversationId: options.conversationId
+  });
+  const convResult = useConversation({
+    client: options.client,
+    autoLoad: options.autoLoad
+  });
+  const error = computed(
+    () => msgResult.error.value || convResult.error.value
+  );
+  return {
+    // Messages
+    messages: msgResult.messages,
+    isLoading: msgResult.isLoading,
+    error,
+    sendMessage: msgResult.sendMessage,
+    clearMessages: msgResult.clearMessages,
+    conversationId: msgResult.conversationId,
+    // Conversations
+    conversations: convResult.conversations,
+    currentConversation: convResult.currentConversation,
+    isConversationsLoading: convResult.isLoading,
+    selectConversation: convResult.selectConversation,
+    startNewConversation: convResult.startNewConversation,
+    refreshConversations: convResult.refreshConversations
+  };
+}
+function useAgoFunction(name, options) {
+  const client = useAgo();
+  onMounted(() => {
+    client.registerFunction(name, options.handler, {
+      description: options.description,
+      parameters: options.parameters
+    });
+  });
+  onUnmounted(() => {
+    client.unregisterFunction(name);
+  });
+}
+function useAgoNavigation(navigate, routes) {
+  const client = useAgo();
+  onMounted(() => {
+    client.registerNavigationFunction(navigate, routes);
+  });
+  onUnmounted(() => {
+    client.unregisterFunction("navigateToPage");
+  });
+}
+function useAgoEvents(event, handler) {
+  const client = useAgo();
+  onMounted(() => {
+    client.on(event, handler);
+  });
+  onUnmounted(() => {
+    client.off(event, handler);
+  });
+}
+export {
+  AGO_CLIENT_KEY,
+  AgoPlugin,
+  useAgo,
+  useAgoEvents,
+  useAgoFunction,
+  useAgoNavigation,
+  useChat,
+  useConversation,
+  useMessages
+};
+//# sourceMappingURL=vue.js.map

package/dist/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sources":["../src/vue/symbols.ts","../src/vue/plugin.ts","../src/vue/composables/useAgo.ts","../src/vue/composables/useMessages.ts","../src/vue/composables/useConversation.ts","../src/vue/composables/useChat.ts","../src/vue/composables/useAgoFunction.ts","../src/vue/composables/useAgoEvents.ts"],"sourcesContent":["import type { InjectionKey } from \"vue\";\nimport type { AgoClient } from \"../client/AgoClient\";\n\nexport const AGO_CLIENT_KEY: InjectionKey<AgoClient> = Symbol(\"ago-client\");\n","import type { App } from \"vue\";\nimport { AgoClient } from \"../client/AgoClient\";\nimport type { AgoConfig } from \"../client/types\";\nimport { AGO_CLIENT_KEY } from \"./symbols\";\n\nexport interface AgoPluginOptions extends AgoConfig {}\n\n/**\n * Vue plugin that provides an AgoClient to the entire app via inject/provide.\n *\n * ```ts\n * import { AgoPlugin } from \"@useago/sdk/vue\";\n *\n * app.use(AgoPlugin, { baseUrl: \"https://YOUR-DOMAIN.useago.com\" });\n * ```\n */\nexport const AgoPlugin = {\n  install(app: App, options: AgoPluginOptions) {\n    const client = new AgoClient(options);\n    app.provide(AGO_CLIENT_KEY, client);\n  },\n};\n","import { inject } from \"vue\";\nimport { AgoClient } from \"../../client/AgoClient\";\nimport type { AgoConfig } from \"../../client/types\";\nimport { AGO_CLIENT_KEY } from \"../symbols\";\n\n/**\n * Get or create an AgoClient.\n *\n * - Without args: returns the client from `AgoPlugin` (throws if none).\n * - With config: creates a new client instance.\n *\n * ```ts\n * // From plugin\n * const client = useAgo();\n *\n * // Standalone\n * const client = useAgo({ baseUrl: \"https://YOUR-DOMAIN.useago.com\" });\n * ```\n */\nexport function useAgo(config?: AgoConfig): AgoClient {\n  if (config) {\n    return new AgoClient(config);\n  }\n\n  const client = inject(AGO_CLIENT_KEY);\n  if (!client) {\n    throw new Error(\n      \"useAgo(): no AgoClient found. Either pass config or install AgoPlugin.\"\n    );\n  }\n  return client;\n}\n","import { ref, onMounted, onUnmounted } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport type { AgoMessage } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\nexport interface UseMessagesOptions {\n  client?: AgoClient;\n  conversationId?: string;\n}\n\n/**\n * Composable to manage messages in a conversation.\n *\n * ```ts\n * const { messages, sendMessage, isLoading } = useMessages();\n * ```\n */\nexport function useMessages(options: UseMessagesOptions = {}) {\n  const client = options.client ?? useAgo();\n\n  const messages = ref<AgoMessage[]>([]);\n  const conversationId = ref<string | undefined>(options.conversationId);\n  const isLoading = ref(false);\n  const error = ref<Error | null>(null);\n\n  const handleStart = (data: { conversationId: string; messageId: string }) => {\n    if (!conversationId.value) {\n      conversationId.value = data.conversationId;\n    }\n  };\n\n  const handleChunk = (data: { content: string; messageId: string }) => {\n    const idx = messages.value.findIndex((m: AgoMessage) => m.id === data.messageId);\n    if (idx >= 0) {\n      messages.value[idx] = {\n        ...messages.value[idx],\n        content: messages.value[idx].content + data.content,\n      };\n    }\n  };\n\n  const handleComplete = (message: AgoMessage) => {\n    const idx = messages.value.findIndex((m: AgoMessage) => m.id === message.id);\n    if (idx >= 0) {\n      messages.value[idx] = message;\n    } else {\n      messages.value.push(message);\n    }\n    isLoading.value = false;\n  };\n\n  const handleError = (data: { error: string }) => {\n    error.value = new Error(data.error);\n    isLoading.value = false;\n  };\n\n  onMounted(() => {\n    client.on(\"message:start\", handleStart);\n    client.on(\"message:chunk\", handleChunk);\n    client.on(\"message:complete\", handleComplete);\n    client.on(\"message:error\", handleError);\n  });\n\n  onUnmounted(() => {\n    client.off(\"message:start\", handleStart);\n    client.off(\"message:chunk\", handleChunk);\n    client.off(\"message:complete\", handleComplete);\n    client.off(\"message:error\", handleError);\n  });\n\n  async function sendMessage(content: string, files?: File[]): Promise<AgoMessage | null> {\n    isLoading.value = true;\n    error.value = null;\n\n    // Optimistic user message\n    const userMsg: AgoMessage = {\n      id: `temp-${Date.now()}`,\n      conversationId: conversationId.value || \"\",\n      content,\n      role: \"user\",\n      status: \"DONE\",\n      createdAt: new Date(),\n    };\n    const assistantMsg: AgoMessage = {\n      id: `temp-assistant-${Date.now()}`,\n      conversationId: conversationId.value || \"\",\n      content: \"\",\n      role: \"assistant\",\n      status: \"IN_PROGRESS\",\n      createdAt: new Date(),\n    };\n    messages.value.push(userMsg, assistantMsg);\n\n    try {\n      const response = await client.sendMessage(content, {\n        conversationId: conversationId.value,\n        files,\n      });\n      if (response.conversationId && !conversationId.value) {\n        conversationId.value = response.conversationId;\n      }\n      // Replace temp messages\n      messages.value = messages.value.filter((m: AgoMessage) => !m.id.startsWith(\"temp-\"));\n      const updatedUser = { ...userMsg, id: userMsg.id.replace(\"temp-\", \"user-\"), conversationId: response.conversationId };\n      if (!messages.value.some((m: AgoMessage) => m.id === response.id)) {\n        messages.value.push(updatedUser, response);\n      } else {\n        messages.value.push(updatedUser);\n      }\n      return response;\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to send\");\n      isLoading.value = false;\n      messages.value = messages.value.filter((m: AgoMessage) => !m.id.startsWith(\"temp-\"));\n      return null;\n    }\n  }\n\n  function clearMessages() {\n    messages.value = [];\n    conversationId.value = undefined;\n    error.value = null;\n  }\n\n  return { messages, isLoading, error, conversationId, sendMessage, clearMessages };\n}\n","import { ref, onMounted } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport type { Conversation } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\nexport interface UseConversationOptions {\n  client?: AgoClient;\n  autoLoad?: boolean;\n}\n\n/**\n * Composable to manage conversations.\n *\n * ```ts\n * const { conversations, selectConversation } = useConversation();\n * ```\n */\nexport function useConversation(options: UseConversationOptions = {}) {\n  const client = options.client ?? useAgo();\n  const autoLoad = options.autoLoad ?? true;\n\n  const conversations = ref<Conversation[]>([]);\n  const currentConversation = ref<Conversation | null>(null);\n  const isLoading = ref(false);\n  const error = ref<Error | null>(null);\n\n  async function refreshConversations() {\n    isLoading.value = true;\n    error.value = null;\n    try {\n      conversations.value = await client.getConversations();\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to load conversations\");\n    } finally {\n      isLoading.value = false;\n    }\n  }\n\n  async function selectConversation(id: string) {\n    isLoading.value = true;\n    error.value = null;\n    try {\n      currentConversation.value = await client.getConversation(id);\n    } catch (err) {\n      error.value = err instanceof Error ? err : new Error(\"Failed to load conversation\");\n    } finally {\n      isLoading.value = false;\n    }\n  }\n\n  function startNewConversation() {\n    currentConversation.value = null;\n  }\n\n  onMounted(() => {\n    if (autoLoad) refreshConversations();\n  });\n\n  return {\n    conversations,\n    currentConversation,\n    isLoading,\n    error,\n    selectConversation,\n    startNewConversation,\n    refreshConversations,\n  };\n}\n","import { computed } from \"vue\";\nimport type { AgoClient } from \"../../client/AgoClient\";\nimport { useMessages } from \"./useMessages\";\nimport { useConversation } from \"./useConversation\";\n\nexport interface UseChatOptions {\n  client?: AgoClient;\n  conversationId?: string;\n  autoLoad?: boolean;\n}\n\n/**\n * All-in-one composable combining messages + conversations.\n *\n * ```ts\n * const { messages, sendMessage, conversations, selectConversation } = useChat();\n * ```\n */\nexport function useChat(options: UseChatOptions = {}) {\n  const msgResult = useMessages({\n    client: options.client,\n    conversationId: options.conversationId,\n  });\n\n  const convResult = useConversation({\n    client: options.client,\n    autoLoad: options.autoLoad,\n  });\n\n  const error = computed(\n    () => msgResult.error.value || convResult.error.value\n  );\n\n  return {\n    // Messages\n    messages: msgResult.messages,\n    isLoading: msgResult.isLoading,\n    error,\n    sendMessage: msgResult.sendMessage,\n    clearMessages: msgResult.clearMessages,\n    conversationId: msgResult.conversationId,\n    // Conversations\n    conversations: convResult.conversations,\n    currentConversation: convResult.currentConversation,\n    isConversationsLoading: convResult.isLoading,\n    selectConversation: convResult.selectConversation,\n    startNewConversation: convResult.startNewConversation,\n    refreshConversations: convResult.refreshConversations,\n  };\n}\n","import { onMounted, onUnmounted } from \"vue\";\nimport type { ClientFunctionHandler, ClientFunctionSchema } from \"../../functions/types\";\nimport { useAgo } from \"./useAgo\";\n\n/**\n * Register a client-side function with auto-cleanup on unmount.\n *\n * ```ts\n * useAgoFunction(\"showToast\", {\n *   description: \"Show a toast\",\n *   parameters: { type: \"object\", properties: { message: { type: \"string\" } } },\n *   handler: async (args) => { toast(args.message); return { shown: true }; },\n * });\n * ```\n */\nexport function useAgoFunction(\n  name: string,\n  options: {\n    description: string;\n    parameters: ClientFunctionSchema[\"parameters\"];\n    handler: ClientFunctionHandler;\n  }\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.registerFunction(name, options.handler, {\n      description: options.description,\n      parameters: options.parameters,\n    });\n  });\n\n  onUnmounted(() => {\n    client.unregisterFunction(name);\n  });\n}\n\nexport interface AgoRoute {\n  name: string;\n  path: string;\n  description: string;\n}\n\n/**\n * Register navigation routes with auto-cleanup on unmount.\n * Works with vue-router's `useRouter().push`.\n *\n * ```ts\n * const router = useRouter();\n * useAgoNavigation((path) => router.push(path), [\n *   { name: \"dashboard\", path: \"/dashboard\", description: \"Main dashboard\" },\n * ]);\n * ```\n */\nexport function useAgoNavigation(\n  navigate: (path: string) => void,\n  routes: AgoRoute[]\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.registerNavigationFunction(navigate, routes);\n  });\n\n  onUnmounted(() => {\n    client.unregisterFunction(\"navigateToPage\");\n  });\n}\n","import { onMounted, onUnmounted } from \"vue\";\nimport type { AgoClientEvents, AgoEventName } from \"../../client/types\";\nimport { useAgo } from \"./useAgo\";\n\n/**\n * Subscribe to AGO client events with auto-cleanup on unmount.\n *\n * ```ts\n * useAgoEvents(\"message:complete\", (msg) => {\n *   console.log(\"Got message:\", msg.content);\n * });\n * ```\n */\nexport function useAgoEvents<K extends AgoEventName>(\n  event: K,\n  handler: (data: AgoClientEvents[K]) => void\n): void {\n  const client = useAgo();\n\n  onMounted(() => {\n    client.on(event, handler);\n  });\n\n  onUnmounted(() => {\n    client.off(event, handler);\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/widget/types.d.ts

@@ -34,6 +34,7 @@ export interface AgoWidgetConfig {
     jwt?: string;
     authToken?: string;
     permission?: string;
+    metadata?: Record<string, unknown>;
 }
 declare global {
     interface Window {