@useago/sdk 0.1.7 → 0.2.1

package/dist/index.js

@@ -1,188 +1,278 @@
-import { A as AgoClient } from "./AgoClient-D-c91tx5.js";
-import { a, b, c, d, e, C, E, F, S, i, l } from "./AgoClient-D-c91tx5.js";
-import { c as c2 } from "./createMockClient-B1DcBiIK.js";
-import { copyToClipboard, getLocalStorage, getUserLocation, highlightElement, openUrl, scrollToElement, setLocalStorage, setTheme, showConfirmDialog, showNotification, showToast, submitForm, trackEvent } from "./functions-C-wLEc8b.js";
+import { a as ClientContextRegistry, c as AgoApiError, d as AgoNetworkError, f as AgoStreamError, i as isStreamNetworkError, l as AgoError, n as EventEmitter, o as FunctionRegistry, r as SSEHandler, s as logger, t as AgoClient, u as AgoFunctionError } from "./AgoClient-CNT-8sh_.js";
+import { t as createMockClient } from "./createMockClient-U0ae_AYy.js";
+import { a as highlightElement, c as setLocalStorage, d as showNotification, f as showToast, i as getUserLocation, l as setTheme, m as trackEvent, o as openUrl, p as submitForm, r as getLocalStorage, s as scrollToElement, t as copyToClipboard, u as showConfirmDialog } from "./functions-C9F1dnmh.js";
+//#region src/functions/defineFunction.ts
+/**
+* Create a reusable function definition.
+* Returns the same object — this is an identity function for discoverability and type-checking.
+*
+* ```ts
+* // Define once, reuse anywhere
+* export const lookupOrder = defineFunction({
+*   name: "lookupOrder",
+*   description: "Look up an order by ID",
+*   parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
+*   handler: async (args) => fetchOrder(args.id as string),
+* });
+*
+* // Register with client
+* client.registerFunction(lookupOrder);
+*
+* // Or use in React
+* useAgoFunction(lookupOrder.name, lookupOrder);
+* ```
+*/
 function defineFunction(definition) {
-  return definition;
+	return definition;
 }
+//#endregion
+//#region src/streaming/helpers.ts
+/**
+* Subscribe to complete messages with a simple callback. Returns an unsubscribe function.
+*
+* ```ts
+* const unsub = onMessage(client, (msg) => console.log(msg.content));
+* // later: unsub();
+* ```
+*/
 function onMessage(client, callback) {
-  client.on("message:complete", callback);
-  return () => client.off("message:complete", callback);
+	client.on("message:complete", callback);
+	return () => client.off("message:complete", callback);
 }
+/**
+* Subscribe to streaming text chunks.
+*
+* ```ts
+* onMessageChunk(client, ({ content }) => {
+*   outputEl.textContent += content;
+* });
+* ```
+*/
 function onMessageChunk(client, callback) {
-  client.on("message:chunk", callback);
-  return () => client.off("message:chunk", callback);
+	client.on("message:chunk", callback);
+	return () => client.off("message:chunk", callback);
 }
+/**
+* Subscribe to message start events.
+*/
 function onMessageStart(client, callback) {
-  client.on("message:start", callback);
-  return () => client.off("message:start", callback);
+	client.on("message:start", callback);
+	return () => client.off("message:start", callback);
 }
+/**
+* Subscribe to message errors.
+*/
 function onMessageError(client, callback) {
-  client.on("message:error", callback);
-  return () => client.off("message:error", callback);
+	client.on("message:error", callback);
+	return () => client.off("message:error", callback);
 }
+/**
+* Subscribe to tool call events.
+*/
 function onToolCall(client, callback) {
-  client.on("toolCall:received", callback);
-  return () => client.off("toolCall:received", callback);
+	client.on("toolCall:received", callback);
+	return () => client.off("toolCall:received", callback);
 }
+/**
+* Subscribe to client function invocations.
+*/
 function onFunctionInvoke(client, callback) {
-  client.on("function:invoke", callback);
-  return () => client.off("function:invoke", callback);
+	client.on("function:invoke", callback);
+	return () => client.off("function:invoke", callback);
 }
+/**
+* Send a message and iterate over chunks as an async generator.
+* Gives you full control over how you process the stream.
+*
+* ```ts
+* for await (const chunk of createMessageStream(client, "Hello!")) {
+*   console.log(chunk.type, chunk.data);
+* }
+* ```
+*/
 async function* createMessageStream(client, content, options) {
-  const queue = [];
-  let resolve = null;
-  let done = false;
-  const push = (event) => {
-    queue.push(event);
-    resolve == null ? void 0 : resolve();
-  };
-  const onStart = (data) => push({ type: "start", data });
-  const onChunk = (data) => push({ type: "chunk", data });
-  const onComplete = (data) => {
-    push({ type: "complete", data });
-    done = true;
-    resolve == null ? void 0 : resolve();
-  };
-  const onError = (data) => {
-    push({ type: "error", data });
-    done = true;
-    resolve == null ? void 0 : resolve();
-  };
-  const onTool = (data) => push({ type: "toolCall", data });
-  client.on("message:start", onStart);
-  client.on("message:chunk", onChunk);
-  client.on("message:complete", onComplete);
-  client.on("message:error", onError);
-  client.on("toolCall:received", onTool);
-  client.sendMessage(content, options).catch(() => {
-    done = true;
-    resolve == null ? void 0 : resolve();
-  });
-  try {
-    while (!done || queue.length > 0) {
-      if (queue.length > 0) {
-        yield queue.shift();
-      } else {
-        await new Promise((r) => {
-          resolve = r;
-        });
-        resolve = null;
-      }
-    }
-  } finally {
-    client.off("message:start", onStart);
-    client.off("message:chunk", onChunk);
-    client.off("message:complete", onComplete);
-    client.off("message:error", onError);
-    client.off("toolCall:received", onTool);
-  }
+	const queue = [];
+	let resolve = null;
+	let done = false;
+	const push = (event) => {
+		queue.push(event);
+		resolve?.();
+	};
+	const onStart = (data) => push({
+		type: "start",
+		data
+	});
+	const onChunk = (data) => push({
+		type: "chunk",
+		data
+	});
+	const onComplete = (data) => {
+		push({
+			type: "complete",
+			data
+		});
+		done = true;
+		resolve?.();
+	};
+	const onError = (data) => {
+		push({
+			type: "error",
+			data
+		});
+		done = true;
+		resolve?.();
+	};
+	const onTool = (data) => push({
+		type: "toolCall",
+		data
+	});
+	client.on("message:start", onStart);
+	client.on("message:chunk", onChunk);
+	client.on("message:complete", onComplete);
+	client.on("message:error", onError);
+	client.on("toolCall:received", onTool);
+	client.sendMessage(content, options).catch(() => {
+		done = true;
+		resolve?.();
+	});
+	try {
+		while (!done || queue.length > 0) if (queue.length > 0) yield queue.shift();
+		else {
+			await new Promise((r) => {
+				resolve = r;
+			});
+			resolve = null;
+		}
+	} finally {
+		client.off("message:start", onStart);
+		client.off("message:chunk", onChunk);
+		client.off("message:complete", onComplete);
+		client.off("message:error", onError);
+		client.off("toolCall:received", onTool);
+	}
 }
+//#endregion
+//#region src/auto/createAgo.ts
+/**
+* Auto-detect AGO configuration from the DOM environment.
+*
+* Checks (in order of priority):
+* 1. `window.AGO` global object (widget config)
+* 2. `<meta>` tags: `<meta name="ago-api-key" content="...">`
+* 3. `data-ago-*` attributes on `<body>` or `<script data-ago-api-key="...">`
+* 4. Explicit overrides passed as argument
+*
+* Returns null if no API key can be found.
+*/
 function autoDetectConfig(overrides) {
-  let baseUrl;
-  let widgetId;
-  let defaultAgentId;
-  let userEmail;
-  let userJwt;
-  let debug;
-  if (typeof window !== "undefined" && window.AGO) {
-    const ago = window.AGO;
-    baseUrl = ago.basepath;
-    widgetId = ago.widgetId;
-    defaultAgentId = ago.defaultAgent;
-    userEmail = ago.email;
-    userJwt = ago.jwt;
-  }
-  if (typeof document !== "undefined") {
-    const getMeta = (name) => {
-      var _a;
-      return ((_a = document.querySelector(`meta[name="${name}"]`)) == null ? void 0 : _a.getAttribute("content")) || void 0;
-    };
-    baseUrl = baseUrl || getMeta("ago-base-url");
-    widgetId = widgetId || getMeta("ago-widget-id");
-    defaultAgentId = defaultAgentId || getMeta("ago-agent-id");
-    userEmail = userEmail || getMeta("ago-user-email");
-  }
-  if (typeof document !== "undefined") {
-    const sources = [
-      document.body,
-      ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))
-    ].filter(Boolean);
-    for (const el of sources) {
-      if (!el) continue;
-      baseUrl = baseUrl || el.getAttribute("data-ago-base-url") || void 0;
-      widgetId = widgetId || el.getAttribute("data-ago-widget-id") || void 0;
-      defaultAgentId = defaultAgentId || el.getAttribute("data-ago-agent-id") || void 0;
-      userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
-    }
-  }
-  baseUrl = (overrides == null ? void 0 : overrides.baseUrl) || baseUrl;
-  widgetId = (overrides == null ? void 0 : overrides.widgetId) || widgetId;
-  defaultAgentId = (overrides == null ? void 0 : overrides.defaultAgentId) || defaultAgentId;
-  userEmail = (overrides == null ? void 0 : overrides.userEmail) || userEmail;
-  userJwt = (overrides == null ? void 0 : overrides.userJwt) || userJwt;
-  debug = (overrides == null ? void 0 : overrides.debug) ?? debug;
-  if (!baseUrl) {
-    return null;
-  }
-  return {
-    baseUrl,
-    widgetId,
-    defaultAgentId,
-    userEmail,
-    userJwt,
-    debug
-  };
+	let baseUrl;
+	let widgetId;
+	let agent;
+	let permission;
+	let userEmail;
+	let userJwt;
+	if (typeof window !== "undefined" && window.AGO) {
+		const ago = window.AGO;
+		baseUrl = ago.basepath;
+		widgetId = ago.widgetId;
+		agent = ago.agent || ago.defaultAgent;
+		permission = ago.permission;
+		userEmail = ago.email;
+		userJwt = ago.jwt;
+	}
+	if (typeof document !== "undefined") {
+		const getMeta = (name) => document.querySelector(`meta[name="${name}"]`)?.getAttribute("content") || void 0;
+		baseUrl = baseUrl || getMeta("ago-base-url");
+		widgetId = widgetId || getMeta("ago-widget-id");
+		agent = agent || getMeta("ago-agent") || getMeta("ago-agent-id");
+		permission = permission || getMeta("ago-permission");
+		userEmail = userEmail || getMeta("ago-user-email");
+	}
+	if (typeof document !== "undefined") {
+		const sources = [document.body, ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);
+		for (const el of sources) {
+			if (!el) continue;
+			baseUrl = baseUrl || el.getAttribute("data-ago-base-url") || void 0;
+			widgetId = widgetId || el.getAttribute("data-ago-widget-id") || void 0;
+			agent = agent || el.getAttribute("data-ago-agent") || el.getAttribute("data-ago-agent-id") || void 0;
+			permission = permission || el.getAttribute("data-ago-permission") || void 0;
+			userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
+		}
+	}
+	baseUrl = overrides?.baseUrl || baseUrl;
+	widgetId = overrides?.widgetId || widgetId;
+	agent = overrides?.agent || overrides?.defaultAgentId || agent;
+	permission = overrides?.permission || permission;
+	userEmail = overrides?.userEmail || userEmail;
+	userJwt = overrides?.userJwt || userJwt;
+	const debug = overrides?.debug;
+	if (!baseUrl) return null;
+	return {
+		baseUrl,
+		widgetId,
+		agent,
+		permission,
+		userEmail,
+		userJwt,
+		debug
+	};
 }
+/**
+* Create an AgoClient with zero configuration.
+* Auto-detects config from window.AGO, meta tags, and data-ago-* attributes.
+*
+* ```html
+* <!-- In your HTML -->
+* <meta name="ago-base-url" content="https://YOUR-DOMAIN.useago.com">
+*
+* <!-- Or on a script tag -->
+* <script src="app.js" data-ago-base-url="https://YOUR-DOMAIN.useago.com"><\/script>
+* ```
+*
+* ```ts
+* import { createAgo } from "@useago/sdk";
+*
+* // Zero config — picks up from DOM
+* const client = createAgo();
+*
+* // Or with partial overrides
+* const client = createAgo({ debug: true });
+* ```
+*
+* Throws if no base URL can be detected.
+*/
 function createAgo(overrides) {
-  const config = autoDetectConfig(overrides);
-  if (!config) {
-    throw new Error(
-      'createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.'
-    );
-  }
-  return new AgoClient(config);
+	const config = autoDetectConfig(overrides);
+	if (!config) throw new Error("createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name=\"ago-base-url\">, or pass { baseUrl } explicitly.");
+	return new AgoClient(config);
 }
+//#endregion
+//#region src/helpers/factory.ts
+/**
+* Attach a handler to a pre-built function definition.
+*
+* Pre-built helpers (`showToast`, `trackEvent`, ...) ship with a no-op or
+* console-logging default handler. Use `withHandler` to wire them up to
+* your actual implementation without mutating the original definition.
+*
+* ```ts
+* import { showToast, withHandler } from "@useago/sdk";
+*
+* client.register(
+*   withHandler(showToast, (args) => {
+*     myToast(args.message as string);
+*     return { shown: true };
+*   })
+* );
+* ```
+*/
 function withHandler(definition, handler) {
-  return { ...definition, handler };
+	return {
+		...definition,
+		handler
+	};
 }
-export {
-  a as AgoApiError,
-  AgoClient,
-  b as AgoError,
-  c as AgoFunctionError,
-  d as AgoNetworkError,
-  e as AgoStreamError,
-  C as ClientContextRegistry,
-  E as EventEmitter,
-  F as FunctionRegistry,
-  S as SSEHandler,
-  autoDetectConfig,
-  copyToClipboard,
-  createAgo,
-  createMessageStream,
-  c2 as createMockClient,
-  defineFunction,
-  getLocalStorage,
-  getUserLocation,
-  highlightElement,
-  i as isStreamNetworkError,
-  l as logger,
-  onFunctionInvoke,
-  onMessage,
-  onMessageChunk,
-  onMessageError,
-  onMessageStart,
-  onToolCall,
-  openUrl,
-  scrollToElement,
-  setLocalStorage,
-  setTheme,
-  showConfirmDialog,
-  showNotification,
-  showToast,
-  submitForm,
-  trackEvent,
-  withHandler
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { AgoApiError, AgoClient, AgoError, AgoFunctionError, AgoNetworkError, AgoStreamError, ClientContextRegistry, EventEmitter, FunctionRegistry, SSEHandler, autoDetectConfig, copyToClipboard, createAgo, createMessageStream, createMockClient, defineFunction, getLocalStorage, getUserLocation, highlightElement, isStreamNetworkError, logger, onFunctionInvoke, onMessage, onMessageChunk, onMessageError, onMessageStart, onToolCall, openUrl, scrollToElement, setLocalStorage, setTheme, showConfirmDialog, showNotification, showToast, submitForm, trackEvent, withHandler };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/functions/defineFunction.ts","../src/streaming/helpers.ts","../src/auto/createAgo.ts","../src/helpers/factory.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"./types\";\n\n/**\n * Create a reusable function definition.\n * Returns the same object — this is an identity function for discoverability and type-checking.\n *\n * ```ts\n * // Define once, reuse anywhere\n * export const lookupOrder = defineFunction({\n *   name: \"lookupOrder\",\n *   description: \"Look up an order by ID\",\n *   parameters: { type: \"object\", properties: { id: { type: \"string\" } }, required: [\"id\"] },\n *   handler: async (args) => fetchOrder(args.id as string),\n * });\n *\n * // Register with client\n * client.registerFunction(lookupOrder);\n *\n * // Or use in React\n * useAgoFunction(lookupOrder.name, lookupOrder);\n * ```\n */\nexport function defineFunction(\n  definition: ClientFunctionDefinition\n): ClientFunctionDefinition {\n  return definition;\n}\n","import type { AgoClient } from \"../client/AgoClient\";\nimport type {\n  AgoMessage,\n  AgoClientEvents,\n  ToolCallData,\n  ClientFunctionInvocation,\n} from \"../client/types\";\n\n/**\n * Subscribe to complete messages with a simple callback. Returns an unsubscribe function.\n *\n * ```ts\n * const unsub = onMessage(client, (msg) => console.log(msg.content));\n * // later: unsub();\n * ```\n */\nexport function onMessage(\n  client: AgoClient,\n  callback: (message: AgoMessage) => void\n): () => void {\n  client.on(\"message:complete\", callback);\n  return () => client.off(\"message:complete\", callback);\n}\n\n/**\n * Subscribe to streaming text chunks.\n *\n * ```ts\n * onMessageChunk(client, ({ content }) => {\n *   outputEl.textContent += content;\n * });\n * ```\n */\nexport function onMessageChunk(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:chunk\"]) => void\n): () => void {\n  client.on(\"message:chunk\", callback);\n  return () => client.off(\"message:chunk\", callback);\n}\n\n/**\n * Subscribe to message start events.\n */\nexport function onMessageStart(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:start\"]) => void\n): () => void {\n  client.on(\"message:start\", callback);\n  return () => client.off(\"message:start\", callback);\n}\n\n/**\n * Subscribe to message errors.\n */\nexport function onMessageError(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:error\"]) => void\n): () => void {\n  client.on(\"message:error\", callback);\n  return () => client.off(\"message:error\", callback);\n}\n\n/**\n * Subscribe to tool call events.\n */\nexport function onToolCall(\n  client: AgoClient,\n  callback: (toolCall: ToolCallData) => void\n): () => void {\n  client.on(\"toolCall:received\", callback);\n  return () => client.off(\"toolCall:received\", callback);\n}\n\n/**\n * Subscribe to client function invocations.\n */\nexport function onFunctionInvoke(\n  client: AgoClient,\n  callback: (data: ClientFunctionInvocation) => void\n): () => void {\n  client.on(\"function:invoke\", callback);\n  return () => client.off(\"function:invoke\", callback);\n}\n\n/**\n * Send a message and iterate over chunks as an async generator.\n * Gives you full control over how you process the stream.\n *\n * ```ts\n * for await (const chunk of createMessageStream(client, \"Hello!\")) {\n *   console.log(chunk.type, chunk.data);\n * }\n * ```\n */\nexport async function* createMessageStream(\n  client: AgoClient,\n  content: string,\n  options?: { conversationId?: string; agentId?: string; files?: File[] }\n): AsyncGenerator<\n  | { type: \"start\"; data: AgoClientEvents[\"message:start\"] }\n  | { type: \"chunk\"; data: AgoClientEvents[\"message:chunk\"] }\n  | { type: \"complete\"; data: AgoMessage }\n  | { type: \"error\"; data: AgoClientEvents[\"message:error\"] }\n  | { type: \"toolCall\"; data: ToolCallData }\n> {\n  type StreamEvent =\n    | { type: \"start\"; data: AgoClientEvents[\"message:start\"] }\n    | { type: \"chunk\"; data: AgoClientEvents[\"message:chunk\"] }\n    | { type: \"complete\"; data: AgoMessage }\n    | { type: \"error\"; data: AgoClientEvents[\"message:error\"] }\n    | { type: \"toolCall\"; data: ToolCallData };\n\n  const queue: StreamEvent[] = [];\n  let resolve: (() => void) | null = null;\n  let done = false;\n\n  const push = (event: StreamEvent) => {\n    queue.push(event);\n    resolve?.();\n  };\n\n  const onStart = (data: AgoClientEvents[\"message:start\"]) => push({ type: \"start\", data });\n  const onChunk = (data: AgoClientEvents[\"message:chunk\"]) => push({ type: \"chunk\", data });\n  const onComplete = (data: AgoMessage) => {\n    push({ type: \"complete\", data });\n    done = true;\n    resolve?.();\n  };\n  const onError = (data: AgoClientEvents[\"message:error\"]) => {\n    push({ type: \"error\", data });\n    done = true;\n    resolve?.();\n  };\n  const onTool = (data: ToolCallData) => push({ type: \"toolCall\", data });\n\n  client.on(\"message:start\", onStart);\n  client.on(\"message:chunk\", onChunk);\n  client.on(\"message:complete\", onComplete);\n  client.on(\"message:error\", onError);\n  client.on(\"toolCall:received\", onTool);\n\n  // Fire the request (don't await — we'll consume events via the generator)\n  client.sendMessage(content, options).catch(() => {\n    done = true;\n    resolve?.();\n  });\n\n  try {\n    while (!done || queue.length > 0) {\n      if (queue.length > 0) {\n        yield queue.shift()!;\n      } else {\n        await new Promise<void>((r) => { resolve = r; });\n        resolve = null;\n      }\n    }\n  } finally {\n    client.off(\"message:start\", onStart);\n    client.off(\"message:chunk\", onChunk);\n    client.off(\"message:complete\", onComplete);\n    client.off(\"message:error\", onError);\n    client.off(\"toolCall:received\", onTool);\n  }\n}\n","import { AgoClient } from \"../client/AgoClient\";\nimport type { AgoConfig } from \"../client/types\";\n\n/**\n * Auto-detect AGO configuration from the DOM environment.\n *\n * Checks (in order of priority):\n * 1. `window.AGO` global object (widget config)\n * 2. `<meta>` tags: `<meta name=\"ago-api-key\" content=\"...\">`\n * 3. `data-ago-*` attributes on `<body>` or `<script data-ago-api-key=\"...\">`\n * 4. Explicit overrides passed as argument\n *\n * Returns null if no API key can be found.\n */\nexport function autoDetectConfig(\n  overrides?: Partial<AgoConfig>\n): AgoConfig | null {\n  let baseUrl: string | undefined;\n  let widgetId: string | undefined;\n  let defaultAgentId: string | undefined;\n  let userEmail: string | undefined;\n  let userJwt: string | undefined;\n  let debug: boolean | undefined;\n\n  // 1. window.AGO (widget config format)\n  if (typeof window !== \"undefined\" && (window as unknown as Record<string, unknown>).AGO) {\n    const ago = (window as unknown as Record<string, unknown>).AGO as Record<string, unknown>;\n    baseUrl = ago.basepath as string | undefined;\n    widgetId = ago.widgetId as string | undefined;\n    defaultAgentId = ago.defaultAgent as string | undefined;\n    userEmail = ago.email as string | undefined;\n    userJwt = ago.jwt as string | undefined;\n  }\n\n  // 2. Meta tags\n  if (typeof document !== \"undefined\") {\n    const getMeta = (name: string) =>\n      document.querySelector(`meta[name=\"${name}\"]`)?.getAttribute(\"content\") || undefined;\n\n    baseUrl = baseUrl || getMeta(\"ago-base-url\");\n    widgetId = widgetId || getMeta(\"ago-widget-id\");\n    defaultAgentId = defaultAgentId || getMeta(\"ago-agent-id\");\n    userEmail = userEmail || getMeta(\"ago-user-email\");\n  }\n\n  // 3. data-ago-* attributes on body or script tags\n  if (typeof document !== \"undefined\") {\n    const sources = [\n      document.body,\n      ...Array.from(document.querySelectorAll(\"script[data-ago-base-url]\")),\n    ].filter(Boolean);\n\n    for (const el of sources) {\n      if (!el) continue;\n      baseUrl = baseUrl || el.getAttribute(\"data-ago-base-url\") || undefined;\n      widgetId = widgetId || el.getAttribute(\"data-ago-widget-id\") || undefined;\n      defaultAgentId = defaultAgentId || el.getAttribute(\"data-ago-agent-id\") || undefined;\n      userEmail = userEmail || el.getAttribute(\"data-ago-user-email\") || undefined;\n    }\n  }\n\n  // 4. Apply overrides\n  baseUrl = overrides?.baseUrl || baseUrl;\n  widgetId = overrides?.widgetId || widgetId;\n  defaultAgentId = overrides?.defaultAgentId || defaultAgentId;\n  userEmail = overrides?.userEmail || userEmail;\n  userJwt = overrides?.userJwt || userJwt;\n  debug = overrides?.debug ?? debug;\n\n  if (!baseUrl) {\n    return null;\n  }\n\n  return {\n    baseUrl,\n    widgetId,\n    defaultAgentId,\n    userEmail,\n    userJwt,\n    debug,\n  };\n}\n\n/**\n * Create an AgoClient with zero configuration.\n * Auto-detects config from window.AGO, meta tags, and data-ago-* attributes.\n *\n * ```html\n * <!-- In your HTML -->\n * <meta name=\"ago-base-url\" content=\"https://YOUR-DOMAIN.useago.com\">\n *\n * <!-- Or on a script tag -->\n * <script src=\"app.js\" data-ago-base-url=\"https://YOUR-DOMAIN.useago.com\"></script>\n * ```\n *\n * ```ts\n * import { createAgo } from \"@useago/sdk\";\n *\n * // Zero config — picks up from DOM\n * const client = createAgo();\n *\n * // Or with partial overrides\n * const client = createAgo({ debug: true });\n * ```\n *\n * Throws if no base URL can be detected.\n */\nexport function createAgo(overrides?: Partial<AgoConfig>): AgoClient {\n  const config = autoDetectConfig(overrides);\n\n  if (!config) {\n    throw new Error(\n      \"createAgo(): could not detect AGO configuration. \" +\n        \"Set window.AGO, add <meta name=\\\"ago-base-url\\\">, or pass { baseUrl } explicitly.\"\n    );\n  }\n\n  return new AgoClient(config);\n}\n","import type {\n  ClientFunctionDefinition,\n  ClientFunctionHandler,\n} from \"../functions/types\";\n\n/**\n * Attach a handler to a pre-built function definition.\n *\n * Pre-built helpers (`showToast`, `trackEvent`, ...) ship with a no-op or\n * console-logging default handler. Use `withHandler` to wire them up to\n * your actual implementation without mutating the original definition.\n *\n * ```ts\n * import { showToast, withHandler } from \"@useago/sdk\";\n *\n * client.register(\n *   withHandler(showToast, (args) => {\n *     myToast(args.message as string);\n *     return { shown: true };\n *   })\n * );\n * ```\n */\nexport function withHandler<T extends ClientFunctionDefinition>(\n  definition: T,\n  handler: ClientFunctionHandler\n): T {\n  return { ...definition, handler };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/functions/defineFunction.ts","../src/streaming/helpers.ts","../src/auto/createAgo.ts","../src/helpers/factory.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"./types\";\n\n/**\n * Create a reusable function definition.\n * Returns the same object — this is an identity function for discoverability and type-checking.\n *\n * ```ts\n * // Define once, reuse anywhere\n * export const lookupOrder = defineFunction({\n *   name: \"lookupOrder\",\n *   description: \"Look up an order by ID\",\n *   parameters: { type: \"object\", properties: { id: { type: \"string\" } }, required: [\"id\"] },\n *   handler: async (args) => fetchOrder(args.id as string),\n * });\n *\n * // Register with client\n * client.registerFunction(lookupOrder);\n *\n * // Or use in React\n * useAgoFunction(lookupOrder.name, lookupOrder);\n * ```\n */\nexport function defineFunction(\n  definition: ClientFunctionDefinition\n): ClientFunctionDefinition {\n  return definition;\n}\n","import type { AgoClient } from \"../client/AgoClient\";\nimport type {\n  AgoMessage,\n  AgoClientEvents,\n  ToolCallData,\n  ClientFunctionInvocation,\n} from \"../client/types\";\n\n/**\n * Subscribe to complete messages with a simple callback. Returns an unsubscribe function.\n *\n * ```ts\n * const unsub = onMessage(client, (msg) => console.log(msg.content));\n * // later: unsub();\n * ```\n */\nexport function onMessage(\n  client: AgoClient,\n  callback: (message: AgoMessage) => void\n): () => void {\n  client.on(\"message:complete\", callback);\n  return () => client.off(\"message:complete\", callback);\n}\n\n/**\n * Subscribe to streaming text chunks.\n *\n * ```ts\n * onMessageChunk(client, ({ content }) => {\n *   outputEl.textContent += content;\n * });\n * ```\n */\nexport function onMessageChunk(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:chunk\"]) => void\n): () => void {\n  client.on(\"message:chunk\", callback);\n  return () => client.off(\"message:chunk\", callback);\n}\n\n/**\n * Subscribe to message start events.\n */\nexport function onMessageStart(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:start\"]) => void\n): () => void {\n  client.on(\"message:start\", callback);\n  return () => client.off(\"message:start\", callback);\n}\n\n/**\n * Subscribe to message errors.\n */\nexport function onMessageError(\n  client: AgoClient,\n  callback: (data: AgoClientEvents[\"message:error\"]) => void\n): () => void {\n  client.on(\"message:error\", callback);\n  return () => client.off(\"message:error\", callback);\n}\n\n/**\n * Subscribe to tool call events.\n */\nexport function onToolCall(\n  client: AgoClient,\n  callback: (toolCall: ToolCallData) => void\n): () => void {\n  client.on(\"toolCall:received\", callback);\n  return () => client.off(\"toolCall:received\", callback);\n}\n\n/**\n * Subscribe to client function invocations.\n */\nexport function onFunctionInvoke(\n  client: AgoClient,\n  callback: (data: ClientFunctionInvocation) => void\n): () => void {\n  client.on(\"function:invoke\", callback);\n  return () => client.off(\"function:invoke\", callback);\n}\n\n/**\n * Send a message and iterate over chunks as an async generator.\n * Gives you full control over how you process the stream.\n *\n * ```ts\n * for await (const chunk of createMessageStream(client, \"Hello!\")) {\n *   console.log(chunk.type, chunk.data);\n * }\n * ```\n */\nexport async function* createMessageStream(\n  client: AgoClient,\n  content: string,\n  options?: { conversationId?: string; agentId?: string; files?: File[] }\n): AsyncGenerator<\n  | { type: \"start\"; data: AgoClientEvents[\"message:start\"] }\n  | { type: \"chunk\"; data: AgoClientEvents[\"message:chunk\"] }\n  | { type: \"complete\"; data: AgoMessage }\n  | { type: \"error\"; data: AgoClientEvents[\"message:error\"] }\n  | { type: \"toolCall\"; data: ToolCallData }\n> {\n  type StreamEvent =\n    | { type: \"start\"; data: AgoClientEvents[\"message:start\"] }\n    | { type: \"chunk\"; data: AgoClientEvents[\"message:chunk\"] }\n    | { type: \"complete\"; data: AgoMessage }\n    | { type: \"error\"; data: AgoClientEvents[\"message:error\"] }\n    | { type: \"toolCall\"; data: ToolCallData };\n\n  const queue: StreamEvent[] = [];\n  let resolve: (() => void) | null = null;\n  let done = false;\n\n  const push = (event: StreamEvent) => {\n    queue.push(event);\n    resolve?.();\n  };\n\n  const onStart = (data: AgoClientEvents[\"message:start\"]) => push({ type: \"start\", data });\n  const onChunk = (data: AgoClientEvents[\"message:chunk\"]) => push({ type: \"chunk\", data });\n  const onComplete = (data: AgoMessage) => {\n    push({ type: \"complete\", data });\n    done = true;\n    resolve?.();\n  };\n  const onError = (data: AgoClientEvents[\"message:error\"]) => {\n    push({ type: \"error\", data });\n    done = true;\n    resolve?.();\n  };\n  const onTool = (data: ToolCallData) => push({ type: \"toolCall\", data });\n\n  client.on(\"message:start\", onStart);\n  client.on(\"message:chunk\", onChunk);\n  client.on(\"message:complete\", onComplete);\n  client.on(\"message:error\", onError);\n  client.on(\"toolCall:received\", onTool);\n\n  // Fire the request (don't await — we'll consume events via the generator)\n  client.sendMessage(content, options).catch(() => {\n    done = true;\n    resolve?.();\n  });\n\n  try {\n    while (!done || queue.length > 0) {\n      if (queue.length > 0) {\n        yield queue.shift()!;\n      } else {\n        await new Promise<void>((r) => { resolve = r; });\n        resolve = null;\n      }\n    }\n  } finally {\n    client.off(\"message:start\", onStart);\n    client.off(\"message:chunk\", onChunk);\n    client.off(\"message:complete\", onComplete);\n    client.off(\"message:error\", onError);\n    client.off(\"toolCall:received\", onTool);\n  }\n}\n","import { AgoClient } from \"../client/AgoClient\";\nimport type { AgoConfig } from \"../client/types\";\n\n/**\n * Auto-detect AGO configuration from the DOM environment.\n *\n * Checks (in order of priority):\n * 1. `window.AGO` global object (widget config)\n * 2. `<meta>` tags: `<meta name=\"ago-api-key\" content=\"...\">`\n * 3. `data-ago-*` attributes on `<body>` or `<script data-ago-api-key=\"...\">`\n * 4. Explicit overrides passed as argument\n *\n * Returns null if no API key can be found.\n */\nexport function autoDetectConfig(\n  overrides?: Partial<AgoConfig>\n): AgoConfig | null {\n  let baseUrl: string | undefined;\n  let widgetId: string | undefined;\n  let agent: string | undefined;\n  let permission: string | undefined;\n  let userEmail: string | undefined;\n  let userJwt: string | undefined;\n\n  // 1. window.AGO (widget config format)\n  if (typeof window !== \"undefined\" && (window as unknown as Record<string, unknown>).AGO) {\n    const ago = (window as unknown as Record<string, unknown>).AGO as Record<string, unknown>;\n    baseUrl = ago.basepath as string | undefined;\n    widgetId = ago.widgetId as string | undefined;\n    agent = (ago.agent as string | undefined) || (ago.defaultAgent as string | undefined);\n    permission = ago.permission as string | undefined;\n    userEmail = ago.email as string | undefined;\n    userJwt = ago.jwt as string | undefined;\n  }\n\n  // 2. Meta tags\n  if (typeof document !== \"undefined\") {\n    const getMeta = (name: string) =>\n      document.querySelector(`meta[name=\"${name}\"]`)?.getAttribute(\"content\") || undefined;\n\n    baseUrl = baseUrl || getMeta(\"ago-base-url\");\n    widgetId = widgetId || getMeta(\"ago-widget-id\");\n    agent = agent || getMeta(\"ago-agent\") || getMeta(\"ago-agent-id\");\n    permission = permission || getMeta(\"ago-permission\");\n    userEmail = userEmail || getMeta(\"ago-user-email\");\n  }\n\n  // 3. data-ago-* attributes on body or script tags\n  if (typeof document !== \"undefined\") {\n    const sources = [\n      document.body,\n      ...Array.from(document.querySelectorAll(\"script[data-ago-base-url]\")),\n    ].filter(Boolean);\n\n    for (const el of sources) {\n      if (!el) continue;\n      baseUrl = baseUrl || el.getAttribute(\"data-ago-base-url\") || undefined;\n      widgetId = widgetId || el.getAttribute(\"data-ago-widget-id\") || undefined;\n      agent = agent || el.getAttribute(\"data-ago-agent\") || el.getAttribute(\"data-ago-agent-id\") || undefined;\n      permission = permission || el.getAttribute(\"data-ago-permission\") || undefined;\n      userEmail = userEmail || el.getAttribute(\"data-ago-user-email\") || undefined;\n    }\n  }\n\n  // 4. Apply overrides\n  baseUrl = overrides?.baseUrl || baseUrl;\n  widgetId = overrides?.widgetId || widgetId;\n  agent = overrides?.agent || overrides?.defaultAgentId || agent;\n  permission = overrides?.permission || permission;\n  userEmail = overrides?.userEmail || userEmail;\n  userJwt = overrides?.userJwt || userJwt;\n  const debug = overrides?.debug;\n\n  if (!baseUrl) {\n    return null;\n  }\n\n  return {\n    baseUrl,\n    widgetId,\n    agent,\n    permission,\n    userEmail,\n    userJwt,\n    debug,\n  };\n}\n\n/**\n * Create an AgoClient with zero configuration.\n * Auto-detects config from window.AGO, meta tags, and data-ago-* attributes.\n *\n * ```html\n * <!-- In your HTML -->\n * <meta name=\"ago-base-url\" content=\"https://YOUR-DOMAIN.useago.com\">\n *\n * <!-- Or on a script tag -->\n * <script src=\"app.js\" data-ago-base-url=\"https://YOUR-DOMAIN.useago.com\"></script>\n * ```\n *\n * ```ts\n * import { createAgo } from \"@useago/sdk\";\n *\n * // Zero config — picks up from DOM\n * const client = createAgo();\n *\n * // Or with partial overrides\n * const client = createAgo({ debug: true });\n * ```\n *\n * Throws if no base URL can be detected.\n */\nexport function createAgo(overrides?: Partial<AgoConfig>): AgoClient {\n  const config = autoDetectConfig(overrides);\n\n  if (!config) {\n    throw new Error(\n      \"createAgo(): could not detect AGO configuration. \" +\n        \"Set window.AGO, add <meta name=\\\"ago-base-url\\\">, or pass { baseUrl } explicitly.\"\n    );\n  }\n\n  return new AgoClient(config);\n}\n","import type {\n  ClientFunctionDefinition,\n  ClientFunctionHandler,\n} from \"../functions/types\";\n\n/**\n * Attach a handler to a pre-built function definition.\n *\n * Pre-built helpers (`showToast`, `trackEvent`, ...) ship with a no-op or\n * console-logging default handler. Use `withHandler` to wire them up to\n * your actual implementation without mutating the original definition.\n *\n * ```ts\n * import { showToast, withHandler } from \"@useago/sdk\";\n *\n * client.register(\n *   withHandler(showToast, (args) => {\n *     myToast(args.message as string);\n *     return { shown: true };\n *   })\n * );\n * ```\n */\nexport function withHandler<T extends ClientFunctionDefinition>(\n  definition: T,\n  handler: ClientFunctionHandler\n): T {\n  return { ...definition, handler };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,eACd,YAC0B;AAC1B,QAAO;;;;;;;;;;;;ACTT,SAAgB,UACd,QACA,UACY;AACZ,QAAO,GAAG,oBAAoB,SAAS;AACvC,cAAa,OAAO,IAAI,oBAAoB,SAAS;;;;;;;;;;;AAYvD,SAAgB,eACd,QACA,UACY;AACZ,QAAO,GAAG,iBAAiB,SAAS;AACpC,cAAa,OAAO,IAAI,iBAAiB,SAAS;;;;;AAMpD,SAAgB,eACd,QACA,UACY;AACZ,QAAO,GAAG,iBAAiB,SAAS;AACpC,cAAa,OAAO,IAAI,iBAAiB,SAAS;;;;;AAMpD,SAAgB,eACd,QACA,UACY;AACZ,QAAO,GAAG,iBAAiB,SAAS;AACpC,cAAa,OAAO,IAAI,iBAAiB,SAAS;;;;;AAMpD,SAAgB,WACd,QACA,UACY;AACZ,QAAO,GAAG,qBAAqB,SAAS;AACxC,cAAa,OAAO,IAAI,qBAAqB,SAAS;;;;;AAMxD,SAAgB,iBACd,QACA,UACY;AACZ,QAAO,GAAG,mBAAmB,SAAS;AACtC,cAAa,OAAO,IAAI,mBAAmB,SAAS;;;;;;;;;;;;AAatD,gBAAuB,oBACrB,QACA,SACA,SAOA;CAQA,MAAM,QAAuB,EAAE;CAC/B,IAAI,UAA+B;CACnC,IAAI,OAAO;CAEX,MAAM,QAAQ,UAAuB;AACnC,QAAM,KAAK,MAAM;AACjB,aAAW;;CAGb,MAAM,WAAW,SAA2C,KAAK;EAAE,MAAM;EAAS;EAAM,CAAC;CACzF,MAAM,WAAW,SAA2C,KAAK;EAAE,MAAM;EAAS;EAAM,CAAC;CACzF,MAAM,cAAc,SAAqB;AACvC,OAAK;GAAE,MAAM;GAAY;GAAM,CAAC;AAChC,SAAO;AACP,aAAW;;CAEb,MAAM,WAAW,SAA2C;AAC1D,OAAK;GAAE,MAAM;GAAS;GAAM,CAAC;AAC7B,SAAO;AACP,aAAW;;CAEb,MAAM,UAAU,SAAuB,KAAK;EAAE,MAAM;EAAY;EAAM,CAAC;AAEvE,QAAO,GAAG,iBAAiB,QAAQ;AACnC,QAAO,GAAG,iBAAiB,QAAQ;AACnC,QAAO,GAAG,oBAAoB,WAAW;AACzC,QAAO,GAAG,iBAAiB,QAAQ;AACnC,QAAO,GAAG,qBAAqB,OAAO;AAGtC,QAAO,YAAY,SAAS,QAAQ,CAAC,YAAY;AAC/C,SAAO;AACP,aAAW;GACX;AAEF,KAAI;AACF,SAAO,CAAC,QAAQ,MAAM,SAAS,EAC7B,KAAI,MAAM,SAAS,EACjB,OAAM,MAAM,OAAO;OACd;AACL,SAAM,IAAI,SAAe,MAAM;AAAE,cAAU;KAAK;AAChD,aAAU;;WAGN;AACR,SAAO,IAAI,iBAAiB,QAAQ;AACpC,SAAO,IAAI,iBAAiB,QAAQ;AACpC,SAAO,IAAI,oBAAoB,WAAW;AAC1C,SAAO,IAAI,iBAAiB,QAAQ;AACpC,SAAO,IAAI,qBAAqB,OAAO;;;;;;;;;;;;;;;;ACpJ3C,SAAgB,iBACd,WACkB;CAClB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AAGJ,KAAI,OAAO,WAAW,eAAgB,OAA8C,KAAK;EACvF,MAAM,MAAO,OAA8C;AAC3D,YAAU,IAAI;AACd,aAAW,IAAI;AACf,UAAS,IAAI,SAAiC,IAAI;AAClD,eAAa,IAAI;AACjB,cAAY,IAAI;AAChB,YAAU,IAAI;;AAIhB,KAAI,OAAO,aAAa,aAAa;EACnC,MAAM,WAAW,SACf,SAAS,cAAc,cAAc,KAAK,IAAI,EAAE,aAAa,UAAU,IAAI,KAAA;AAE7E,YAAU,WAAW,QAAQ,eAAe;AAC5C,aAAW,YAAY,QAAQ,gBAAgB;AAC/C,UAAQ,SAAS,QAAQ,YAAY,IAAI,QAAQ,eAAe;AAChE,eAAa,cAAc,QAAQ,iBAAiB;AACpD,cAAY,aAAa,QAAQ,iBAAiB;;AAIpD,KAAI,OAAO,aAAa,aAAa;EACnC,MAAM,UAAU,CACd,SAAS,MACT,GAAG,MAAM,KAAK,SAAS,iBAAiB,4BAA4B,CAAC,CACtE,CAAC,OAAO,QAAQ;AAEjB,OAAK,MAAM,MAAM,SAAS;AACxB,OAAI,CAAC,GAAI;AACT,aAAU,WAAW,GAAG,aAAa,oBAAoB,IAAI,KAAA;AAC7D,cAAW,YAAY,GAAG,aAAa,qBAAqB,IAAI,KAAA;AAChE,WAAQ,SAAS,GAAG,aAAa,iBAAiB,IAAI,GAAG,aAAa,oBAAoB,IAAI,KAAA;AAC9F,gBAAa,cAAc,GAAG,aAAa,sBAAsB,IAAI,KAAA;AACrE,eAAY,aAAa,GAAG,aAAa,sBAAsB,IAAI,KAAA;;;AAKvE,WAAU,WAAW,WAAW;AAChC,YAAW,WAAW,YAAY;AAClC,SAAQ,WAAW,SAAS,WAAW,kBAAkB;AACzD,cAAa,WAAW,cAAc;AACtC,aAAY,WAAW,aAAa;AACpC,WAAU,WAAW,WAAW;CAChC,MAAM,QAAQ,WAAW;AAEzB,KAAI,CAAC,QACH,QAAO;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACD;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,SAAgB,UAAU,WAA2C;CACnE,MAAM,SAAS,iBAAiB,UAAU;AAE1C,KAAI,CAAC,OACH,OAAM,IAAI,MACR,qIAED;AAGH,QAAO,IAAI,UAAU,OAAO;;;;;;;;;;;;;;;;;;;;;;ACnG9B,SAAgB,YACd,YACA,SACG;AACH,QAAO;EAAE,GAAG;EAAY;EAAS"}

package/dist/react/components/ChatWidget.d.ts

@@ -17,6 +17,8 @@ export interface ChatWidgetProps {
     height?: string | number;
     /** URL of a logo to display in the header */
     logoUrl?: string;
+    /** Show the agent name above assistant messages. Defaults to `true`. */
+    showAgentName?: boolean;
     /** Additional CSS class */
     className?: string;
     /** Callback when a message is sent */

package/dist/react/components/Markdown.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export interface MarkdownProps {
+    /** Raw markdown string to render. */
+    content: string;
+}
+/**
+ * Renders markdown content with GitHub-flavored markdown support
+ * (tables, task lists, strikethrough, autolinks) and inline-styled
+ * element renderers. Used by {@link Message} but exported so consumers
+ * building a custom chat UI can render assistant content the same way.
+ */
+export declare const Markdown: React.FC<MarkdownProps>;

package/dist/react/components/Message.d.ts

@@ -3,5 +3,7 @@ import type { AgoMessage } from "../../client/types";
 export interface MessageProps {
     message: AgoMessage;
     className?: string;
+    /** Show the agent name above assistant messages. Defaults to `true`. */
+    showAgentName?: boolean;
 }
 export declare const Message: React.FC<MessageProps>;

package/dist/react/components/index.d.ts

@@ -2,5 +2,7 @@ export { ChatWidget } from "./ChatWidget";
 export type { ChatWidgetProps } from "./ChatWidget";
 export { Message } from "./Message";
 export type { MessageProps } from "./Message";
+export { Markdown } from "./Markdown";
+export type { MarkdownProps } from "./Markdown";
 export { ChatInput } from "./ChatInput";
 export type { ChatInputProps } from "./ChatInput";

package/dist/react/index.d.ts

@@ -4,6 +4,8 @@ export { ChatWidget } from "./components/ChatWidget";
 export type { ChatWidgetProps } from "./components/ChatWidget";
 export { Message } from "./components/Message";
 export type { MessageProps } from "./components/Message";
+export { Markdown } from "./components/Markdown";
+export type { MarkdownProps } from "./components/Markdown";
 export { ChatInput } from "./components/ChatInput";
 export type { ChatInputProps } from "./components/ChatInput";
 export { useAgo } from "./hooks/useAgo";