@useago/sdk 0.1.7 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/dist/AgoClient-CNT-8sh_.js +905 -0
  2. package/dist/AgoClient-CNT-8sh_.js.map +1 -0
  3. package/dist/AgoClient-D0l1GTRs.cjs +976 -0
  4. package/dist/AgoClient-D0l1GTRs.cjs.map +1 -0
  5. package/dist/angular.cjs +138 -100
  6. package/dist/angular.cjs.map +1 -1
  7. package/dist/angular.d.ts +1 -0
  8. package/dist/angular.js +139 -103
  9. package/dist/angular.js.map +1 -1
  10. package/dist/client/types.d.ts +5 -1
  11. package/dist/createMockClient-Ci_N2tH8.cjs +104 -0
  12. package/dist/createMockClient-Ci_N2tH8.cjs.map +1 -0
  13. package/dist/createMockClient-U0ae_AYy.js +99 -0
  14. package/dist/createMockClient-U0ae_AYy.js.map +1 -0
  15. package/dist/functions--c6lx3ic.cjs +480 -0
  16. package/dist/functions--c6lx3ic.cjs.map +1 -0
  17. package/dist/functions-C9F1dnmh.js +398 -0
  18. package/dist/functions-C9F1dnmh.js.map +1 -0
  19. package/dist/helpers.cjs +14 -16
  20. package/dist/helpers.d.ts +1 -0
  21. package/dist/helpers.js +2 -17
  22. package/dist/index.cjs +281 -153
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.js +256 -166
  25. package/dist/index.js.map +1 -1
  26. package/dist/react/components/ChatWidget.d.ts +2 -0
  27. package/dist/react/components/Markdown.d.ts +12 -0
  28. package/dist/react/components/Message.d.ts +2 -0
  29. package/dist/react/components/index.d.ts +2 -0
  30. package/dist/react/index.d.ts +2 -0
  31. package/dist/react.cjs +22099 -10333
  32. package/dist/react.cjs.map +1 -1
  33. package/dist/react.d.ts +1 -0
  34. package/dist/react.js +22099 -10349
  35. package/dist/react.js.map +1 -1
  36. package/dist/rolldown-runtime-BqCkTl7Q.cjs +50 -0
  37. package/dist/rolldown-runtime-CNZpIYwj.js +33 -0
  38. package/dist/vue.cjs +287 -208
  39. package/dist/vue.cjs.map +1 -1
  40. package/dist/vue.d.ts +1 -0
  41. package/dist/vue.js +287 -218
  42. package/dist/vue.js.map +1 -1
  43. package/dist/widget.cjs +0 -2
  44. package/dist/widget.d.ts +1 -0
  45. package/dist/widget.js +0 -2
  46. package/package.json +8 -6
  47. package/dist/AgoClient-BDO4avLq.cjs +0 -1036
  48. package/dist/AgoClient-BDO4avLq.cjs.map +0 -1
  49. package/dist/AgoClient-D-c91tx5.js +0 -1037
  50. package/dist/AgoClient-D-c91tx5.js.map +0 -1
  51. package/dist/createMockClient-B1DcBiIK.js +0 -94
  52. package/dist/createMockClient-B1DcBiIK.js.map +0 -1
  53. package/dist/createMockClient-BqNSJUu4.cjs +0 -93
  54. package/dist/createMockClient-BqNSJUu4.cjs.map +0 -1
  55. package/dist/functions-B0Z0rNQW.cjs +0 -306
  56. package/dist/functions-B0Z0rNQW.cjs.map +0 -1
  57. package/dist/functions-C-wLEc8b.js +0 -306
  58. package/dist/functions-C-wLEc8b.js.map +0 -1
  59. package/dist/helpers.cjs.map +0 -1
  60. package/dist/helpers.js.map +0 -1
  61. package/dist/widget.cjs.map +0 -1
  62. package/dist/widget.js.map +0 -1
package/dist/index.cjs CHANGED
@@ -1,187 +1,315 @@
1
- "use strict";
2
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
- const AgoClient = require("./AgoClient-BDO4avLq.cjs");
4
- const createMockClient = require("./createMockClient-BqNSJUu4.cjs");
5
- const helpers = require("./functions-B0Z0rNQW.cjs");
2
+ const require_AgoClient = require("./AgoClient-D0l1GTRs.cjs");
3
+ const require_createMockClient = require("./createMockClient-Ci_N2tH8.cjs");
4
+ const require_functions = require("./functions--c6lx3ic.cjs");
5
+ //#region src/functions/defineFunction.ts
6
+ /**
7
+ * Create a reusable function definition.
8
+ * Returns the same object — this is an identity function for discoverability and type-checking.
9
+ *
10
+ * ```ts
11
+ * // Define once, reuse anywhere
12
+ * export const lookupOrder = defineFunction({
13
+ * name: "lookupOrder",
14
+ * description: "Look up an order by ID",
15
+ * parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
16
+ * handler: async (args) => fetchOrder(args.id as string),
17
+ * });
18
+ *
19
+ * // Register with client
20
+ * client.registerFunction(lookupOrder);
21
+ *
22
+ * // Or use in React
23
+ * useAgoFunction(lookupOrder.name, lookupOrder);
24
+ * ```
25
+ */
6
26
  function defineFunction(definition) {
7
- return definition;
27
+ return definition;
8
28
  }
29
+ //#endregion
30
+ //#region src/streaming/helpers.ts
31
+ /**
32
+ * Subscribe to complete messages with a simple callback. Returns an unsubscribe function.
33
+ *
34
+ * ```ts
35
+ * const unsub = onMessage(client, (msg) => console.log(msg.content));
36
+ * // later: unsub();
37
+ * ```
38
+ */
9
39
  function onMessage(client, callback) {
10
- client.on("message:complete", callback);
11
- return () => client.off("message:complete", callback);
40
+ client.on("message:complete", callback);
41
+ return () => client.off("message:complete", callback);
12
42
  }
43
+ /**
44
+ * Subscribe to streaming text chunks.
45
+ *
46
+ * ```ts
47
+ * onMessageChunk(client, ({ content }) => {
48
+ * outputEl.textContent += content;
49
+ * });
50
+ * ```
51
+ */
13
52
  function onMessageChunk(client, callback) {
14
- client.on("message:chunk", callback);
15
- return () => client.off("message:chunk", callback);
53
+ client.on("message:chunk", callback);
54
+ return () => client.off("message:chunk", callback);
16
55
  }
56
+ /**
57
+ * Subscribe to message start events.
58
+ */
17
59
  function onMessageStart(client, callback) {
18
- client.on("message:start", callback);
19
- return () => client.off("message:start", callback);
60
+ client.on("message:start", callback);
61
+ return () => client.off("message:start", callback);
20
62
  }
63
+ /**
64
+ * Subscribe to message errors.
65
+ */
21
66
  function onMessageError(client, callback) {
22
- client.on("message:error", callback);
23
- return () => client.off("message:error", callback);
67
+ client.on("message:error", callback);
68
+ return () => client.off("message:error", callback);
24
69
  }
70
+ /**
71
+ * Subscribe to tool call events.
72
+ */
25
73
  function onToolCall(client, callback) {
26
- client.on("toolCall:received", callback);
27
- return () => client.off("toolCall:received", callback);
74
+ client.on("toolCall:received", callback);
75
+ return () => client.off("toolCall:received", callback);
28
76
  }
77
+ /**
78
+ * Subscribe to client function invocations.
79
+ */
29
80
  function onFunctionInvoke(client, callback) {
30
- client.on("function:invoke", callback);
31
- return () => client.off("function:invoke", callback);
81
+ client.on("function:invoke", callback);
82
+ return () => client.off("function:invoke", callback);
32
83
  }
84
+ /**
85
+ * Send a message and iterate over chunks as an async generator.
86
+ * Gives you full control over how you process the stream.
87
+ *
88
+ * ```ts
89
+ * for await (const chunk of createMessageStream(client, "Hello!")) {
90
+ * console.log(chunk.type, chunk.data);
91
+ * }
92
+ * ```
93
+ */
33
94
  async function* createMessageStream(client, content, options) {
34
- const queue = [];
35
- let resolve = null;
36
- let done = false;
37
- const push = (event) => {
38
- queue.push(event);
39
- resolve == null ? void 0 : resolve();
40
- };
41
- const onStart = (data) => push({ type: "start", data });
42
- const onChunk = (data) => push({ type: "chunk", data });
43
- const onComplete = (data) => {
44
- push({ type: "complete", data });
45
- done = true;
46
- resolve == null ? void 0 : resolve();
47
- };
48
- const onError = (data) => {
49
- push({ type: "error", data });
50
- done = true;
51
- resolve == null ? void 0 : resolve();
52
- };
53
- const onTool = (data) => push({ type: "toolCall", data });
54
- client.on("message:start", onStart);
55
- client.on("message:chunk", onChunk);
56
- client.on("message:complete", onComplete);
57
- client.on("message:error", onError);
58
- client.on("toolCall:received", onTool);
59
- client.sendMessage(content, options).catch(() => {
60
- done = true;
61
- resolve == null ? void 0 : resolve();
62
- });
63
- try {
64
- while (!done || queue.length > 0) {
65
- if (queue.length > 0) {
66
- yield queue.shift();
67
- } else {
68
- await new Promise((r) => {
69
- resolve = r;
70
- });
71
- resolve = null;
72
- }
73
- }
74
- } finally {
75
- client.off("message:start", onStart);
76
- client.off("message:chunk", onChunk);
77
- client.off("message:complete", onComplete);
78
- client.off("message:error", onError);
79
- client.off("toolCall:received", onTool);
80
- }
95
+ const queue = [];
96
+ let resolve = null;
97
+ let done = false;
98
+ const push = (event) => {
99
+ queue.push(event);
100
+ resolve?.();
101
+ };
102
+ const onStart = (data) => push({
103
+ type: "start",
104
+ data
105
+ });
106
+ const onChunk = (data) => push({
107
+ type: "chunk",
108
+ data
109
+ });
110
+ const onComplete = (data) => {
111
+ push({
112
+ type: "complete",
113
+ data
114
+ });
115
+ done = true;
116
+ resolve?.();
117
+ };
118
+ const onError = (data) => {
119
+ push({
120
+ type: "error",
121
+ data
122
+ });
123
+ done = true;
124
+ resolve?.();
125
+ };
126
+ const onTool = (data) => push({
127
+ type: "toolCall",
128
+ data
129
+ });
130
+ client.on("message:start", onStart);
131
+ client.on("message:chunk", onChunk);
132
+ client.on("message:complete", onComplete);
133
+ client.on("message:error", onError);
134
+ client.on("toolCall:received", onTool);
135
+ client.sendMessage(content, options).catch(() => {
136
+ done = true;
137
+ resolve?.();
138
+ });
139
+ try {
140
+ while (!done || queue.length > 0) if (queue.length > 0) yield queue.shift();
141
+ else {
142
+ await new Promise((r) => {
143
+ resolve = r;
144
+ });
145
+ resolve = null;
146
+ }
147
+ } finally {
148
+ client.off("message:start", onStart);
149
+ client.off("message:chunk", onChunk);
150
+ client.off("message:complete", onComplete);
151
+ client.off("message:error", onError);
152
+ client.off("toolCall:received", onTool);
153
+ }
81
154
  }
155
+ //#endregion
156
+ //#region src/auto/createAgo.ts
157
+ /**
158
+ * Auto-detect AGO configuration from the DOM environment.
159
+ *
160
+ * Checks (in order of priority):
161
+ * 1. `window.AGO` global object (widget config)
162
+ * 2. `<meta>` tags: `<meta name="ago-api-key" content="...">`
163
+ * 3. `data-ago-*` attributes on `<body>` or `<script data-ago-api-key="...">`
164
+ * 4. Explicit overrides passed as argument
165
+ *
166
+ * Returns null if no API key can be found.
167
+ */
82
168
  function autoDetectConfig(overrides) {
83
- let baseUrl;
84
- let widgetId;
85
- let defaultAgentId;
86
- let userEmail;
87
- let userJwt;
88
- let debug;
89
- if (typeof window !== "undefined" && window.AGO) {
90
- const ago = window.AGO;
91
- baseUrl = ago.basepath;
92
- widgetId = ago.widgetId;
93
- defaultAgentId = ago.defaultAgent;
94
- userEmail = ago.email;
95
- userJwt = ago.jwt;
96
- }
97
- if (typeof document !== "undefined") {
98
- const getMeta = (name) => {
99
- var _a;
100
- return ((_a = document.querySelector(`meta[name="${name}"]`)) == null ? void 0 : _a.getAttribute("content")) || void 0;
101
- };
102
- baseUrl = baseUrl || getMeta("ago-base-url");
103
- widgetId = widgetId || getMeta("ago-widget-id");
104
- defaultAgentId = defaultAgentId || getMeta("ago-agent-id");
105
- userEmail = userEmail || getMeta("ago-user-email");
106
- }
107
- if (typeof document !== "undefined") {
108
- const sources = [
109
- document.body,
110
- ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))
111
- ].filter(Boolean);
112
- for (const el of sources) {
113
- if (!el) continue;
114
- baseUrl = baseUrl || el.getAttribute("data-ago-base-url") || void 0;
115
- widgetId = widgetId || el.getAttribute("data-ago-widget-id") || void 0;
116
- defaultAgentId = defaultAgentId || el.getAttribute("data-ago-agent-id") || void 0;
117
- userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
118
- }
119
- }
120
- baseUrl = (overrides == null ? void 0 : overrides.baseUrl) || baseUrl;
121
- widgetId = (overrides == null ? void 0 : overrides.widgetId) || widgetId;
122
- defaultAgentId = (overrides == null ? void 0 : overrides.defaultAgentId) || defaultAgentId;
123
- userEmail = (overrides == null ? void 0 : overrides.userEmail) || userEmail;
124
- userJwt = (overrides == null ? void 0 : overrides.userJwt) || userJwt;
125
- debug = (overrides == null ? void 0 : overrides.debug) ?? debug;
126
- if (!baseUrl) {
127
- return null;
128
- }
129
- return {
130
- baseUrl,
131
- widgetId,
132
- defaultAgentId,
133
- userEmail,
134
- userJwt,
135
- debug
136
- };
169
+ let baseUrl;
170
+ let widgetId;
171
+ let agent;
172
+ let permission;
173
+ let userEmail;
174
+ let userJwt;
175
+ if (typeof window !== "undefined" && window.AGO) {
176
+ const ago = window.AGO;
177
+ baseUrl = ago.basepath;
178
+ widgetId = ago.widgetId;
179
+ agent = ago.agent || ago.defaultAgent;
180
+ permission = ago.permission;
181
+ userEmail = ago.email;
182
+ userJwt = ago.jwt;
183
+ }
184
+ if (typeof document !== "undefined") {
185
+ const getMeta = (name) => document.querySelector(`meta[name="${name}"]`)?.getAttribute("content") || void 0;
186
+ baseUrl = baseUrl || getMeta("ago-base-url");
187
+ widgetId = widgetId || getMeta("ago-widget-id");
188
+ agent = agent || getMeta("ago-agent") || getMeta("ago-agent-id");
189
+ permission = permission || getMeta("ago-permission");
190
+ userEmail = userEmail || getMeta("ago-user-email");
191
+ }
192
+ if (typeof document !== "undefined") {
193
+ const sources = [document.body, ...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);
194
+ for (const el of sources) {
195
+ if (!el) continue;
196
+ baseUrl = baseUrl || el.getAttribute("data-ago-base-url") || void 0;
197
+ widgetId = widgetId || el.getAttribute("data-ago-widget-id") || void 0;
198
+ agent = agent || el.getAttribute("data-ago-agent") || el.getAttribute("data-ago-agent-id") || void 0;
199
+ permission = permission || el.getAttribute("data-ago-permission") || void 0;
200
+ userEmail = userEmail || el.getAttribute("data-ago-user-email") || void 0;
201
+ }
202
+ }
203
+ baseUrl = overrides?.baseUrl || baseUrl;
204
+ widgetId = overrides?.widgetId || widgetId;
205
+ agent = overrides?.agent || overrides?.defaultAgentId || agent;
206
+ permission = overrides?.permission || permission;
207
+ userEmail = overrides?.userEmail || userEmail;
208
+ userJwt = overrides?.userJwt || userJwt;
209
+ const debug = overrides?.debug;
210
+ if (!baseUrl) return null;
211
+ return {
212
+ baseUrl,
213
+ widgetId,
214
+ agent,
215
+ permission,
216
+ userEmail,
217
+ userJwt,
218
+ debug
219
+ };
137
220
  }
221
+ /**
222
+ * Create an AgoClient with zero configuration.
223
+ * Auto-detects config from window.AGO, meta tags, and data-ago-* attributes.
224
+ *
225
+ * ```html
226
+ * <!-- In your HTML -->
227
+ * <meta name="ago-base-url" content="https://YOUR-DOMAIN.useago.com">
228
+ *
229
+ * <!-- Or on a script tag -->
230
+ * <script src="app.js" data-ago-base-url="https://YOUR-DOMAIN.useago.com"><\/script>
231
+ * ```
232
+ *
233
+ * ```ts
234
+ * import { createAgo } from "@useago/sdk";
235
+ *
236
+ * // Zero config — picks up from DOM
237
+ * const client = createAgo();
238
+ *
239
+ * // Or with partial overrides
240
+ * const client = createAgo({ debug: true });
241
+ * ```
242
+ *
243
+ * Throws if no base URL can be detected.
244
+ */
138
245
  function createAgo(overrides) {
139
- const config = autoDetectConfig(overrides);
140
- if (!config) {
141
- throw new Error(
142
- 'createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.'
143
- );
144
- }
145
- return new AgoClient.AgoClient(config);
246
+ const config = autoDetectConfig(overrides);
247
+ if (!config) throw new Error("createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name=\"ago-base-url\">, or pass { baseUrl } explicitly.");
248
+ return new require_AgoClient.AgoClient(config);
146
249
  }
250
+ //#endregion
251
+ //#region src/helpers/factory.ts
252
+ /**
253
+ * Attach a handler to a pre-built function definition.
254
+ *
255
+ * Pre-built helpers (`showToast`, `trackEvent`, ...) ship with a no-op or
256
+ * console-logging default handler. Use `withHandler` to wire them up to
257
+ * your actual implementation without mutating the original definition.
258
+ *
259
+ * ```ts
260
+ * import { showToast, withHandler } from "@useago/sdk";
261
+ *
262
+ * client.register(
263
+ * withHandler(showToast, (args) => {
264
+ * myToast(args.message as string);
265
+ * return { shown: true };
266
+ * })
267
+ * );
268
+ * ```
269
+ */
147
270
  function withHandler(definition, handler) {
148
- return { ...definition, handler };
271
+ return {
272
+ ...definition,
273
+ handler
274
+ };
149
275
  }
150
- exports.AgoApiError = AgoClient.AgoApiError;
151
- exports.AgoClient = AgoClient.AgoClient;
152
- exports.AgoError = AgoClient.AgoError;
153
- exports.AgoFunctionError = AgoClient.AgoFunctionError;
154
- exports.AgoNetworkError = AgoClient.AgoNetworkError;
155
- exports.AgoStreamError = AgoClient.AgoStreamError;
156
- exports.ClientContextRegistry = AgoClient.ClientContextRegistry;
157
- exports.EventEmitter = AgoClient.EventEmitter;
158
- exports.FunctionRegistry = AgoClient.FunctionRegistry;
159
- exports.SSEHandler = AgoClient.SSEHandler;
160
- exports.isStreamNetworkError = AgoClient.isStreamNetworkError;
161
- exports.logger = AgoClient.logger;
162
- exports.createMockClient = createMockClient.createMockClient;
163
- exports.copyToClipboard = helpers.copyToClipboard;
164
- exports.getLocalStorage = helpers.getLocalStorage;
165
- exports.getUserLocation = helpers.getUserLocation;
166
- exports.highlightElement = helpers.highlightElement;
167
- exports.openUrl = helpers.openUrl;
168
- exports.scrollToElement = helpers.scrollToElement;
169
- exports.setLocalStorage = helpers.setLocalStorage;
170
- exports.setTheme = helpers.setTheme;
171
- exports.showConfirmDialog = helpers.showConfirmDialog;
172
- exports.showNotification = helpers.showNotification;
173
- exports.showToast = helpers.showToast;
174
- exports.submitForm = helpers.submitForm;
175
- exports.trackEvent = helpers.trackEvent;
276
+ //#endregion
277
+ exports.AgoApiError = require_AgoClient.AgoApiError;
278
+ exports.AgoClient = require_AgoClient.AgoClient;
279
+ exports.AgoError = require_AgoClient.AgoError;
280
+ exports.AgoFunctionError = require_AgoClient.AgoFunctionError;
281
+ exports.AgoNetworkError = require_AgoClient.AgoNetworkError;
282
+ exports.AgoStreamError = require_AgoClient.AgoStreamError;
283
+ exports.ClientContextRegistry = require_AgoClient.ClientContextRegistry;
284
+ exports.EventEmitter = require_AgoClient.EventEmitter;
285
+ exports.FunctionRegistry = require_AgoClient.FunctionRegistry;
286
+ exports.SSEHandler = require_AgoClient.SSEHandler;
176
287
  exports.autoDetectConfig = autoDetectConfig;
288
+ exports.copyToClipboard = require_functions.copyToClipboard;
177
289
  exports.createAgo = createAgo;
178
290
  exports.createMessageStream = createMessageStream;
291
+ exports.createMockClient = require_createMockClient.createMockClient;
179
292
  exports.defineFunction = defineFunction;
293
+ exports.getLocalStorage = require_functions.getLocalStorage;
294
+ exports.getUserLocation = require_functions.getUserLocation;
295
+ exports.highlightElement = require_functions.highlightElement;
296
+ exports.isStreamNetworkError = require_AgoClient.isStreamNetworkError;
297
+ exports.logger = require_AgoClient.logger;
180
298
  exports.onFunctionInvoke = onFunctionInvoke;
181
299
  exports.onMessage = onMessage;
182
300
  exports.onMessageChunk = onMessageChunk;
183
301
  exports.onMessageError = onMessageError;
184
302
  exports.onMessageStart = onMessageStart;
185
303
  exports.onToolCall = onToolCall;
304
+ exports.openUrl = require_functions.openUrl;
305
+ exports.scrollToElement = require_functions.scrollToElement;
306
+ exports.setLocalStorage = require_functions.setLocalStorage;
307
+ exports.setTheme = require_functions.setTheme;
308
+ exports.showConfirmDialog = require_functions.showConfirmDialog;
309
+ exports.showNotification = require_functions.showNotification;
310
+ exports.showToast = require_functions.showToast;
311
+ exports.submitForm = require_functions.submitForm;
312
+ exports.trackEvent = require_functions.trackEvent;
186
313
  exports.withHandler = withHandler;
187
- //# sourceMappingURL=index.cjs.map
314
+
315
+ //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","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":["AgoClient"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","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":"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"}