npm - @cadenya/widgets - Versions diffs - 1.1.0 → 1.2.0 - Mend

@cadenya/widgets 1.1.0 → 1.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 (15) hide show

package/dist/client.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ export interface ClientOptions {
      * Defaults to 60000; a non-finite or <= 0 value disables the deadline.
      */
     timeout?: number;
-    /** Headers sent with every request. */
+    /** Additional request headers. Browsers supply their own User-Agent by default. */
     defaultHeaders?: Record<string, string>;
     /** Custom fetch implementation. */
     fetch?: typeof fetch;

package/dist/client.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,~~uCAAuC~~;~~IACvC~~,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,OAAO,GAAE,aAAkB;CAuBxC"}
1	+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,OAAO,GAAE,aAAkB;CAuBxC"}

package/dist/client.js CHANGED Viewed

@@ -18,7 +18,7 @@ export class CadenyaWidgets {
             authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
             maxRetries: options.maxRetries ?? 0,
             timeout: options.timeout,
-            defaultHeaders: { 'User-Agent': 'cadenyawidgets-typescript/1.1.0 (api 1.0)', ...options.defaultHeaders },
+            defaultHeaders: { ...nodeUserAgent('cadenyawidgets-typescript/1.1.1 (api 1.0)'), ...options.defaultHeaders },
             fetch: options.fetch,
             logger: options.logger,
             logLevel: options.logLevel,
@@ -28,6 +28,13 @@ export class CadenyaWidgets {
         this.conversations = new Conversations(this._client);
     }
 }
+// Browser-authored User-Agent headers require CORS permission. Only Node-compatible
+// runtimes receive the SDK default; browsers and workers use their native header.
+function nodeUserAgent(value) {
+    const nodeVersion = globalThis
+        .process?.versions?.node;
+    return nodeVersion ? { 'User-Agent': value } : {};
+}
 function readEnv(name) {
     const env = globalThis
         .process?.env;

package/dist/client.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AA0B7D,MAAM,OAAO,cAAc;IAChB,MAAM,CAAS;IACf,aAAa,CAAgB;IAErB,OAAO,CAAa;IAErC,YAAY,UAAyB,EAAE;QACrC,sEAAsE;QACtE,+CAA+C;QAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC;YAC5B,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC,IAAI,EAAE;YAC5F,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;YACzD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,EAAE,~~YAAY~~,~~EAAE~~,2CAA2C,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE;~~YACxG~~,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,EAAI;SACf,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAI,UAAyE;SACnF,OAAO,EAAE,GAAG,CAAC;IAChB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,sEAAsE;AACtE,SAAS,aAAa,CACpB,KAAa,EACb,QAA4B,EAC5B,GAAuB;IAEvB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,sFAAsF,CAC/F,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAClC,CAAC","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient } from './core/http.js';\nimport type { Logger, LogLevel } from './core/http.js';\nimport { Config } from './resources/config.js';\nimport { Conversations } from './resources/conversations.js';\n\nexport interface ClientOptions {\n /** API key. Defaults to the CADENYAWIDGETS_API_KEY environment variable. /\n apiKey?: string;\n /* Override the API base URL. Defaults to . /\n baseURL?: string;\n /* Max automatic retries for retryable failures. Defaults to 0. /\n maxRetries?: number;\n /\n Deadline for ordinary (non-streaming) requests in milliseconds; override\n * per request with `options.timeout`. Streams bound only response-header\n * acquisition — body lifetime stays under the caller's AbortSignal.\n * Defaults to 60000; a non-finite or <= 0 value disables the deadline.\n /\n timeout?: number;\n /* ~~Headers~~ ~~sent~~ ~~with~~ ~~every~~ ~~request~~. /\n defaultHeaders?: Record<string, string>;\n /* Custom fetch implementation. /\n fetch?: typeof fetch;\n /* Destination for SDK logs. Defaults to `console`. /\n logger?: Logger;\n /* 'debug' \| 'warn' (default) \| 'off'. Never logs headers or bodies. */\n logLevel?: LogLevel;\n}\n\nexport class CadenyaWidgets {\n readonly config: Config;\n readonly conversations: Conversations;\n\n private readonly _client: HttpClient;\n\n constructor(options: ClientOptions = {}) {\n // Presence is not validity: empty strings from options or environment\n // are configuration mistakes, not credentials.\n const apiKey = resolveOption('apiKey', options.apiKey, readEnv('CADENYAWIDGETS_API_KEY'));\n if (!apiKey) {\n throw new Error(\n \"Missing API key. Pass it with `new CadenyaWidgets({ apiKey })` or set the CADENYAWIDGETS_API_KEY environment variable.\",\n );\n }\n this._client = new HttpClient({\n baseURL: resolveOption('baseURL', options.baseURL, readEnv('CADENYAWIDGETS_BASE_URL')) ?? '',\n authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),\n maxRetries: options.maxRetries ?? 0,\n timeout: options.timeout,\n defaultHeaders: { '~~User-Agent': '~~cadenyawidgets-typescript/1.1.0 (api 1.0)', ...options.defaultHeaders },\n fetch: options.fetch,\n logger: options.logger,\n logLevel: options.logLevel,\n defaults: { },\n });\n this.config = new Config(this._client);\n this.conversations = new Conversations(this._client);\n }\n}\n\nfunction readEnv(name: string): string \| undefined {\n const env = (globalThis as { process?: { env?: Record<string, string \| undefined> } })\n .process?.env;\n return env?.[name];\n}\n\n// Presence is not validity: an explicitly provided option must be usable —\n// a blank value is a configuration mistake and never silently falls back to\n// the environment or a default. Only an OMITTED option reads the env.\nfunction resolveOption(\n label: string,\n explicit: string \| undefined,\n env: string \| undefined,\n): string \| undefined {\n if (explicit !== undefined) {\n const value = explicit.trim();\n if (!value) {\n throw new Error(\n `${label} must not be blank when provided explicitly; omit it to use the environment instead.`,\n );\n }\n return value;\n }\n return env?.trim() \|\| undefined;\n}\n"]}
1	+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AA0B7D,MAAM,OAAO,cAAc;IAChB,MAAM,CAAS;IACf,aAAa,CAAgB;IAErB,OAAO,CAAa;IAErC,YAAY,UAAyB,EAAE;QACrC,sEAAsE;QACtE,+CAA+C;QAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC;YAC5B,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC,IAAI,EAAE;YAC5F,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;YACzD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,EAAE,GAAG,aAAa,CAAC,2CAA2C,CAAC,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE;YAC5G,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,EAAI;SACf,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAED,oFAAoF;AACpF,kFAAkF;AAClF,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,WAAW,GAAI,UAA6D;SAC/E,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC;IAC3B,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAI,UAAyE;SACnF,OAAO,EAAE,GAAG,CAAC;IAChB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,sEAAsE;AACtE,SAAS,aAAa,CACpB,KAAa,EACb,QAA4B,EAC5B,GAAuB;IAEvB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,sFAAsF,CAC/F,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAClC,CAAC","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient } from './core/http.js';\nimport type { Logger, LogLevel } from './core/http.js';\nimport { Config } from './resources/config.js';\nimport { Conversations } from './resources/conversations.js';\n\nexport interface ClientOptions {\n /** API key. Defaults to the CADENYAWIDGETS_API_KEY environment variable. /\n apiKey?: string;\n /* Override the API base URL. Defaults to . /\n baseURL?: string;\n /* Max automatic retries for retryable failures. Defaults to 0. /\n maxRetries?: number;\n /\n Deadline for ordinary (non-streaming) requests in milliseconds; override\n * per request with `options.timeout`. Streams bound only response-header\n * acquisition — body lifetime stays under the caller's AbortSignal.\n * Defaults to 60000; a non-finite or <= 0 value disables the deadline.\n /\n timeout?: number;\n /* Additional request headers. Browsers supply their own User-Agent by default. /\n defaultHeaders?: Record<string, string>;\n /* Custom fetch implementation. /\n fetch?: typeof fetch;\n /* Destination for SDK logs. Defaults to `console`. /\n logger?: Logger;\n /* 'debug' \| 'warn' (default) \| 'off'. Never logs headers or bodies. */\n logLevel?: LogLevel;\n}\n\nexport class CadenyaWidgets {\n readonly config: Config;\n readonly conversations: Conversations;\n\n private readonly _client: HttpClient;\n\n constructor(options: ClientOptions = {}) {\n // Presence is not validity: empty strings from options or environment\n // are configuration mistakes, not credentials.\n const apiKey = resolveOption('apiKey', options.apiKey, readEnv('CADENYAWIDGETS_API_KEY'));\n if (!apiKey) {\n throw new Error(\n \"Missing API key. Pass it with `new CadenyaWidgets({ apiKey })` or set the CADENYAWIDGETS_API_KEY environment variable.\",\n );\n }\n this._client = new HttpClient({\n baseURL: resolveOption('baseURL', options.baseURL, readEnv('CADENYAWIDGETS_BASE_URL')) ?? '',\n authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),\n maxRetries: options.maxRetries ?? 0,\n timeout: options.timeout,\n defaultHeaders: { ...nodeUserAgent('cadenyawidgets-typescript/1.1.1 (api 1.0)'), ...options.defaultHeaders },\n fetch: options.fetch,\n logger: options.logger,\n logLevel: options.logLevel,\n defaults: { },\n });\n this.config = new Config(this._client);\n this.conversations = new Conversations(this._client);\n }\n}\n\n// Browser-authored User-Agent headers require CORS permission. Only Node-compatible\n// runtimes receive the SDK default; browsers and workers use their native header.\nfunction nodeUserAgent(value: string): Record<string, string> {\n const nodeVersion = (globalThis as { process?: { versions?: { node?: string } } })\n .process?.versions?.node;\n return nodeVersion ? { 'User-Agent': value } : {};\n}\n\nfunction readEnv(name: string): string \| undefined {\n const env = (globalThis as { process?: { env?: Record<string, string \| undefined> } })\n .process?.env;\n return env?.[name];\n}\n\n// Presence is not validity: an explicitly provided option must be usable —\n// a blank value is a configuration mistake and never silently falls back to\n// the environment or a default. Only an OMITTED option reads the env.\nfunction resolveOption(\n label: string,\n explicit: string \| undefined,\n env: string \| undefined,\n): string \| undefined {\n if (explicit !== undefined) {\n const value = explicit.trim();\n if (!value) {\n throw new Error(\n `${label} must not be blank when provided explicitly; omit it to use the environment instead.`,\n );\n }\n return value;\n }\n return env?.trim() \|\| undefined;\n}\n"]}

package/dist/core/http.d.ts CHANGED Viewed

@@ -26,7 +26,12 @@ export interface RequestOptions {
     lastEventId?: string;
 }
 export type QueryPrimitive = string | number | boolean;
-export type QueryValue = QueryPrimitive | QueryPrimitive[] | undefined | null;
+/**
+ * Query objects are flattened to dot-delimited paths. `object` is used here
+ * deliberately so generated named interfaces (which do not declare an index
+ * signature) remain assignable as query parameter values.
+ */
+export type QueryValue = QueryPrimitive | readonly QueryPrimitive[] | object | undefined | null;
 export interface RequestSpec {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;

package/dist/core/http.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,cAAc,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;~~AAE9E~~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~~CAWjB~~"}
1	+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"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"}

package/dist/core/http.js CHANGED Viewed

@@ -473,17 +473,44 @@ export class HttpClient {
     }
     buildURL(path, query) {
         const url = new URL(this.baseURL + path);
+        const ancestors = new Set();
         for (const [key, value] of Object.entries(query ?? {})) {
-            if (value === undefined || value === null)
-                continue;
-            // Arrays serialize as repeated params: ?state=a&state=b
-            for (const item of Array.isArray(value) ? value : [value]) {
-                url.searchParams.append(key, String(item));
-            }
+            appendQueryValue(url.searchParams, key, value, ancestors);
         }
         return url.toString();
     }
 }
+/**
+ * Flatten nested query objects to dot-delimited paths. Arrays retain the
+ * existing repeated-parameter behavior at whichever path they occur:
+ * `{ filters: { state: ['a', 'b'] } }` becomes
+ * `?filters.state=a&filters.state=b`.
+ */
+function appendQueryValue(searchParams, key, value, ancestors) {
+    if (value === undefined || value === null)
+        return;
+    if (typeof value !== 'object') {
+        searchParams.append(key, String(value));
+        return;
+    }
+    if (ancestors.has(value)) {
+        throw new APIRequestError('query parameters contain a circular reference', undefined);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                appendQueryValue(searchParams, key, item, ancestors);
+            return;
+        }
+        for (const [childKey, childValue] of Object.entries(value)) {
+            appendQueryValue(searchParams, `${key}.${childKey}`, childValue, ancestors);
+        }
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
 /** Retry counts must be bounded non-negative integers; anything else (NaN,
  * Infinity, negatives, fractions) is treated as the nearest sane value. */
 function normalizeRetries(value) {

package/dist/core/http.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Minimal, dependency-less HTTP core built on global fetch (Node 18+,\n * browsers, Deno, Bun). Handles auth, query serialization, retries with\n * backoff, timeouts, and error mapping.\n /\n\nimport {\n APIConnectionError,\n APIError,\n APIRequestError,\n APIResponseError,\n APITimeoutError,\n APIUserAbortError,\n ErrorStatus,\n} from './error.js';\n\nexport interface RequestOptions {\n /\n Auto-reconnect for SSE streams (default true): a mid-stream transport\n * drop resumes from the last received event id, like EventSource. Clean\n * stream end, close(), and abort never reconnect. Set false to surface\n * drops as APIConnectionError instead.\n /\n reconnect?: boolean;\n headers?: Record<string, string>;\n signal?: AbortSignal;\n maxRetries?: number;\n /\n Per-request deadline in milliseconds (overrides the client default).\n * Non-finite or <= 0 disables the deadline for this request.\n /\n timeout?: number;\n /\n For streaming (SSE) requests: resume after the event with this id by\n * sending it as the Last-Event-ID request header.\n /\n lastEventId?: string;\n}\n\nexport type QueryPrimitive = string \| number \| boolean;\nexport type QueryValue = QueryPrimitive \| QueryPrimitive[] \| undefined \| null;\n\nexport interface RequestSpec {\n method: 'GET' \| 'POST' \| 'PUT' \| 'PATCH' \| 'DELETE';\n path: string;\n query?: Record<string, QueryValue>;\n body?: unknown;\n stream?: boolean;\n /* The operation declares no response body (void): 204/empty succeed. /\n void?: boolean;\n}\n\nexport type LogLevel = 'debug' \| 'warn' \| 'off';\n\n/* Minimal logger surface; `console` satisfies it. /\nexport interface Logger {\n debug(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n}\n\nexport interface HttpClientOptions {\n baseURL: string;\n authHeader: () => Record<string, string>;\n maxRetries?: number;\n /* Deadline for ordinary (non-streaming) requests in ms. Default 60000. /\n timeout?: number;\n defaultHeaders?: Record<string, string>;\n fetch?: typeof fetch;\n /* Client-level default values for prominent params (e.g. a tenant/scope id). /\n defaults?: Record<string, string \| undefined>;\n /* Destination for SDK logs. Defaults to `console`. /\n logger?: Logger;\n /\n 'debug' logs every request/response line (method, path, status,\n * duration — never headers or bodies); 'warn' (default) logs only\n * retries; 'off' silences the SDK entirely.\n /\n logLevel?: LogLevel;\n}\n\nconst RETRYABLE_STATUS = new Set([408, 409, 429, 500, 502, 503, 504]);\n\nconst DEFAULT_TIMEOUT_MS = 60_000;\n\n/\n Encode one path segment, rejecting empty/whitespace values at the boundary\n * — an empty segment would silently rewrite the route (/parents//children).\n /\nexport function pathSegment(name: string, value: string \| undefined): string {\n if (value === undefined \|\| String(value).trim() === '') {\n throw new Error(`Missing required path parameter '${name}'.`);\n }\n return encodeURIComponent(value);\n}\n\n/\n Snapshot list params at call time so pagination cannot observe later\n * caller mutations (array-valued filters are copied too). Auto-iteration\n * must never combine pages from different result sets.\n /\nexport function snapshotParams<T>(params: T): T {\n if (params === undefined \|\| params === null \|\| typeof params !== 'object') return params;\n const copy: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n copy[key] = Array.isArray(value) ? value.slice() : value;\n }\n return copy as T;\n}\n\n/\n Automatic retries apply only to idempotent methods. A POST/PATCH that\n * succeeds server-side but loses its response would be executed twice if\n * retried; callers can opt a specific mutation in via options.maxRetries.\n /\nconst IDEMPOTENT_METHODS = new Set(['GET', 'HEAD', 'PUT', 'DELETE']);\n\n/\n Settle when the promise settles OR the signal aborts — a custom fetch (or\n * body reader) that ignores AbortSignal must not be able to hold a deadlined\n * request open forever. The orphaned promise's eventual rejection is\n * swallowed; its resolution is discarded.\n /\nfunction raceAbort<T>(promise: Promise<T>, signal: AbortSignal \| undefined): Promise<T> {\n if (!signal) return promise;\n return new Promise<T>((resolve, reject) => {\n const onAbort = () => {\n promise.catch(() => {});\n reject(new APIUserAbortError());\n };\n if (signal.aborted) {\n onAbort();\n return;\n }\n signal.addEventListener('abort', onAbort, { once: true });\n promise.then(\n (value) => {\n signal.removeEventListener('abort', onAbort);\n resolve(value);\n },\n (err) => {\n signal.removeEventListener('abort', onAbort);\n reject(err);\n },\n );\n });\n}\n\n/\n Deadline cleanup for streaming responses, handed from rawRequest to the\n * Stream that owns the body. The forwarding listener must survive until the\n * stream terminates (a caller abort has to unblock a pending read on a\n * silent socket), so the Stream — not rawRequest — releases it.\n /\nconst streamCleanups = new WeakMap<Response, () => void>();\n\n/* Claim (and remove) the cleanup registered for a streaming response. /\nexport function takeStreamCleanup(response: Response): (() => void) \| undefined {\n const cleanup = streamCleanups.get(response);\n streamCleanups.delete(response);\n return cleanup;\n}\n\n/* Merged caller-signal + deadline state for one request. /\ninterface Deadline {\n signal: AbortSignal \| undefined;\n /* Stop the timer (body may keep streaming under the caller's signal). /\n settle(): void;\n /\n Detach the abort-forwarding listener from the caller's signal. Call\n * only when the request (including any stream body) is finished — a\n * reused long-lived signal must not accumulate one listener per\n * completed call.\n /\n release(): void;\n timedOut(): boolean;\n ms: number;\n}\n\n/\n A lazily-parsing promise for one API call. Awaiting it (or `.then`) yields\n * the decoded value exactly like a plain promise; `withResponse()` yields the\n * decoded value together with the raw `Response` (status, headers); and\n * `asResponse()` yields the raw `Response` WITHOUT consuming the body, so\n * the caller owns reading it.\n /\nexport class APIPromise<T> implements Promise<T> {\n private parsed: Promise<T> \| undefined;\n private observedRaw = false;\n\n constructor(\n private readonly responsePromise: Promise<Response>,\n private readonly parseFn: (response: Response) => Promise<T>,\n private readonly onRawAccess: () => void,\n ) {\n // A dropped return value must still reach terminal cleanup: the request\n // has already been sent, so unless raw access claims the body FIRST\n // (synchronously, before any await), parsing starts on the next\n // microtask — consuming the body and settling the deadline timer even\n // when the caller never observes the promise. Rejections on this\n // internal branch are swallowed; a caller who later awaits still gets\n // them from the memoized parse.\n queueMicrotask(() => {\n if (!this.observedRaw) this.parse().catch(() => {});\n });\n }\n\n /\n The raw `Response` after status checking and retries; the body is NOT\n * consumed. Reading the body (and its timing) becomes the caller's\n * responsibility — the request deadline stops at header acquisition.\n /\n asResponse(): Promise<Response> {\n // Must be called synchronously after the request (before any await):\n // it claims body ownership away from the auto-parse safety net. Mixing\n // a LATE asResponse() with parsed access yields a response whose body\n // was already consumed by parsing — status/headers stay usable.\n this.observedRaw = true;\n return this.responsePromise.then((response) => {\n this.onRawAccess();\n return response;\n });\n }\n\n /* The decoded value together with the `Response` its body came from. /\n async withResponse(): Promise<{ data: T; response: Response }> {\n const response = await this.responsePromise;\n const data = await this.parse();\n return { data, response };\n }\n\n private parse(): Promise<T> {\n this.parsed ??= this.responsePromise.then(this.parseFn);\n return this.parsed;\n }\n\n then<TResult1 = T, TResult2 = never>(\n onfulfilled?: ((value: T) => TResult1 \| PromiseLike<TResult1>) \| null,\n onrejected?: ((reason: unknown) => TResult2 \| PromiseLike<TResult2>) \| null,\n ): Promise<TResult1 \| TResult2> {\n return this.parse().then(onfulfilled, onrejected);\n }\n\n catch<TResult = never>(\n onrejected?: ((reason: unknown) => TResult \| PromiseLike<TResult>) \| null,\n ): Promise<T \| TResult> {\n return this.parse().catch(onrejected);\n }\n\n finally(onfinally?: (() => void) \| null): Promise<T> {\n return this.parse().finally(onfinally);\n }\n\n readonly [Symbol.toStringTag] = 'APIPromise';\n}\n\nexport class HttpClient {\n private readonly baseURL: string;\n private readonly authHeader: () => Record<string, string>;\n private readonly maxRetries: number;\n private readonly timeout: number;\n private readonly defaultHeaders: Record<string, string>;\n private readonly fetchFn: typeof fetch;\n private readonly logger: Logger;\n private readonly logLevel: LogLevel;\n\n /* Method + path + status only — headers and bodies are never logged. /\n private logDebug(...args: unknown[]): void {\n if (this.logLevel === 'debug') this.logger.debug('[sdk]', ...args);\n }\n\n private logWarn(...args: unknown[]): void {\n if (this.logLevel !== 'off') this.logger.warn('[sdk]', ...args);\n }\n readonly defaults: Record<string, string \| undefined>;\n\n constructor(options: HttpClientOptions) {\n this.defaults = options.defaults ?? {};\n this.logger = options.logger ?? console;\n this.logLevel = options.logLevel ?? 'warn';\n // Validate the STRUCTURE once: operation paths are appended to this\n // value, so a query/fragment/userinfo would silently swallow the\n // request path. Absolute http(s) with a host is required; a path\n // prefix is supported and kept.\n // A literal delimiter parses as an EMPTY search/hash and slips past\n // the checks below; reject the characters outright.\n if (options.baseURL.includes('?') \|\| options.baseURL.includes('#')) {\n throw new Error(\n `baseURL '${options.baseURL}' must not carry userinfo, query, or fragment`,\n );\n }\n let parsed: URL;\n try {\n parsed = new URL(options.baseURL);\n } catch (err) {\n throw new Error(`baseURL '${options.baseURL}' is not an absolute URL`, { cause: err });\n }\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n throw new Error(`baseURL '${options.baseURL}' must use http or https`);\n }\n if (parsed.hostname === '') {\n throw new Error(`baseURL '${options.baseURL}' has no host`);\n }\n if (parsed.username !== '' \|\| parsed.password !== '' \|\| parsed.search !== '' \|\| parsed.hash !== '') {\n throw new Error(\n `baseURL '${options.baseURL}' must not carry userinfo, query, or fragment`,\n );\n }\n this.baseURL = (parsed.origin + parsed.pathname).replace(/\\/+$/, '');\n this.authHeader = options.authHeader;\n this.maxRetries = options.maxRetries ?? 0;\n this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;\n this.defaultHeaders = options.defaultHeaders ?? {};\n this.fetchFn = options.fetch ?? fetch;\n }\n\n /\n The APIPromise pipeline for JSON and void operations. The spec thunk\n * runs inside the async context so synchronous setup failures (e.g. a\n * missing client-default param) surface as rejections, exactly like the\n * plain-promise path. The deadline spans fetch through decode; raw-access\n * consumers release it at header acquisition and own body timing.\n /\n requestAPI<T>(makeSpec: () => RequestSpec, options: RequestOptions = {}): APIPromise<T> {\n const deadline = this.deadline(options);\n let spec: RequestSpec;\n const responsePromise = (async () => {\n try {\n spec = makeSpec();\n return await this.rawRequest(spec, { ...options, signal: deadline.signal });\n } catch (err) {\n deadline.settle();\n deadline.release();\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n }\n })();\n const parseFn = async (response: Response): Promise<T> => {\n try {\n if (spec.void) {\n void response.body?.cancel().catch(() => {});\n return undefined as T;\n }\n if (response.status === 204) {\n throw new APIResponseError(204, 'HTTP 204 where a JSON response was expected');\n }\n const text = await raceAbort(response.text(), deadline.signal);\n if (text.trim() === '' \|\| text.trim() === 'null') {\n throw new APIResponseError(\n response.status,\n `HTTP ${response.status} with an empty or null body where a JSON response was expected`,\n );\n }\n try {\n return JSON.parse(text) as T;\n } catch (err) {\n throw new APIResponseError(response.status, 'response body is not valid JSON', err);\n }\n } catch (err) {\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n } finally {\n deadline.settle();\n deadline.release();\n }\n };\n return new APIPromise<T>(responsePromise, parseFn, () => {\n deadline.settle();\n deadline.release();\n });\n }\n\n async request<T>(spec: RequestSpec, options: RequestOptions = {}): Promise<T> {\n // Ordinary JSON calls keep the deadline through body consumption and\n // decoding — a response that stalls mid-body still times out.\n const deadline = this.deadline(options);\n try {\n const response = await this.rawRequest(spec, { ...options, signal: deadline.signal });\n // Branch on the GENERATED expectation, not the HTTP status: a void\n // method accepts 204/empty, but an output-bearing method requires a\n // JSON document — empty/null would fabricate a resource outside the\n // declared contract, and malformed JSON must be a stable SDK error.\n if (spec.void) {\n void response.body?.cancel().catch(() => {});\n return undefined as T;\n }\n if (response.status === 204) {\n throw new APIResponseError(204, 'HTTP 204 where a JSON response was expected');\n }\n const text = await raceAbort(response.text(), deadline.signal);\n if (text.trim() === '' \|\| text.trim() === 'null') {\n throw new APIResponseError(\n response.status,\n `HTTP ${response.status} with an empty or null body where a JSON response was expected`,\n );\n }\n try {\n return JSON.parse(text) as T;\n } catch (err) {\n throw new APIResponseError(response.status, 'response body is not valid JSON', err);\n }\n } catch (err) {\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n } finally {\n deadline.settle();\n deadline.release();\n }\n }\n\n async rawRequest(spec: RequestSpec, options: RequestOptions = {}): Promise<Response> {\n const url = this.buildURL(spec.path, spec.query);\n\n // One Headers instance; `set` is case-insensitive, so later layers\n // OVERRIDE earlier ones regardless of spelling (object spread would keep\n // both `Authorization` and `authorization` and fetch would join the two\n // values into one corrupt header). Precedence: generated defaults →\n // client defaults → auth → per-request → Last-Event-ID (the semantic\n // option is the single source of resume state).\n const headers = new Headers();\n headers.set('Accept', spec.stream ? 'text/event-stream' : 'application/json');\n if (spec.body !== undefined) headers.set('Content-Type', 'application/json');\n for (const [key, value] of Object.entries(this.defaultHeaders)) headers.set(key, value);\n for (const [key, value] of Object.entries(this.authHeader())) headers.set(key, value);\n for (const [key, value] of Object.entries(options.headers ?? {})) headers.set(key, value);\n if (options.lastEventId !== undefined) {\n headers.set('Last-Event-ID', options.lastEventId);\n }\n\n // Serialize ONCE, before the transport/retry loop: a circular object or\n // BigInt is a caller bug, not a network failure — it must surface as a\n // stable request-construction error and never be retried.\n let bodyText: string \| undefined;\n if (spec.body !== undefined) {\n try {\n bodyText = JSON.stringify(spec.body);\n } catch (err) {\n throw new APIRequestError('request body is not JSON-serializable', err);\n }\n if (bodyText === undefined) {\n throw new APIRequestError('request body serialized to undefined', undefined);\n }\n }\n\n // Streams bound only connection/response-header acquisition; the body's\n // lifetime stays under the caller's AbortSignal.\n const streamDeadline = spec.stream ? this.deadline(options) : undefined;\n const signal = streamDeadline ? streamDeadline.signal : options.signal;\n\n // An explicit per-request maxRetries opts in even for mutations.\n const maxRetries = normalizeRetries(\n options.maxRetries !== undefined\n ? options.maxRetries\n : IDEMPOTENT_METHODS.has(spec.method)\n ? this.maxRetries\n : 0,\n );\n\n const startedAt = Date.now();\n for (let attempt = 0; ; attempt++) {\n this.logDebug(`-> ${spec.method} ${spec.path}`, attempt > 0 ? `(attempt ${attempt + 1})` : '');\n let response: Response;\n try {\n response = await raceAbort(\n this.fetchFn(url, {\n method: spec.method,\n headers,\n body: bodyText,\n signal: signal ?? null,\n }),\n signal,\n );\n } catch (err) {\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) {\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIUserAbortError();\n }\n if (attempt < maxRetries) {\n this.logWarn(`retrying ${spec.method} ${spec.path} after connection error (attempt ${attempt + 1}/${maxRetries + 1})`);\n await sleep(backoffMs(attempt, undefined), signal);\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) throw new APIUserAbortError();\n continue;\n }\n // Terminal connection failure: the deadline timer must not outlive\n // the reported error (an orphaned timer holds the process open).\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIConnectionError(err);\n }\n\n if (response.ok) {\n this.logDebug(`<- ${response.status} ${spec.method} ${spec.path} (${Date.now() - startedAt}ms)`);\n // Response headers acquired: the stream body is now unbounded. The\n // forwarding listener stays attached (caller abort must reach the\n // body); the Stream releases it at its terminal state.\n if (streamDeadline) {\n streamDeadline.settle();\n streamCleanups.set(response, () => streamDeadline.release());\n }\n return response;\n }\n\n if (RETRYABLE_STATUS.has(response.status) && attempt < maxRetries) {\n this.logWarn(`retrying ${spec.method} ${spec.path} after HTTP ${response.status} (attempt ${attempt + 1}/${maxRetries + 1})`);\n // Release the discarded response so its connection can be reused.\n void response.body?.cancel().catch(() => {});\n await sleep(backoffMs(attempt, response.headers.get('retry-after')), signal);\n // A stream deadline that fired during backoff is a timeout, not a\n // user abort — rawRequest has no outer mapper to reclassify it.\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) throw new APIUserAbortError();\n continue;\n }\n\n let body: ErrorStatus \| undefined;\n try {\n body = (await response.json()) as ErrorStatus;\n } catch {\n body = undefined;\n }\n // The deadline stays active while consuming a non-2xx error body; if\n // it expired there, report the timeout rather than a truncated\n // APIError.\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIError(response.status, body);\n }\n }\n\n /\n Merge the caller's signal with the configured deadline. The caller's\n * abort always forwards; the timer marks timedOut so the thrown error can\n * be classified as APITimeoutError rather than APIUserAbortError.\n /\n private deadline(options: RequestOptions): Deadline {\n const ms = options.timeout ?? this.timeout;\n if (!Number.isFinite(ms) \|\| ms <= 0) {\n return { signal: options.signal, settle() {}, release() {}, timedOut: () => false, ms };\n }\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, ms);\n const forward = () => controller.abort();\n if (options.signal?.aborted) {\n controller.abort();\n } else {\n options.signal?.addEventListener('abort', forward, { once: true });\n }\n let settled = false;\n let released = false;\n return {\n signal: controller.signal,\n settle() {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n },\n release() {\n if (released) return;\n released = true;\n options.signal?.removeEventListener('abort', forward);\n },\n timedOut: () => timedOut,\n ms,\n };\n }\n\n private buildURL(path: string, query?: Record<string, QueryValue>): string {\n const url = new URL(this.baseURL + path);\n for (const [key, value] of Object.entries(query ?? {})) {\n if (value === undefined \|\| value === null) continue;\n // Arrays serialize as repeated params: ?state=a&state=b\n for (const item of Array.isArray(value) ? value : [value]) {\n url.searchParams.append(key, String(item));\n }\n }\n return url.toString();\n }\n}\n\n/* Retry counts must be bounded non-negative integers; anything else (NaN,\n * Infinity, negatives, fractions) is treated as the nearest sane value. /\nfunction normalizeRetries(value: number): number {\n if (!Number.isFinite(value) \|\| value <= 0) return 0;\n return Math.min(Math.floor(value), 10);\n}\n\nfunction backoffMs(attempt: number, retryAfter: string \| null \| undefined): number {\n if (retryAfter) {\n // Retry-After is either delta-seconds or an HTTP-date. A parsed zero is\n // a real answer (retry immediately), not a fall-through to backoff.\n const seconds = Number(retryAfter);\n if (Number.isFinite(seconds) && seconds >= 0) return Math.min(seconds 1000, 60_000);\n const date = Date.parse(retryAfter);\n if (Number.isFinite(date)) {\n return Math.min(Math.max(date - Date.now(), 0), 60_000);\n }\n }\n const base = 500 * 2 ** Math.min(attempt, 4);\n return Math.min(base + Math.random() * base, 8000);\n}\n\n/** Sleep that wakes early when the signal aborts (caller re-checks it). */\nfunction sleep(ms: number, signal?: AbortSignal \| null): Promise<void> {\n return new Promise((resolve) => {\n if (signal?.aborted) return resolve();\n const timer = setTimeout(() => {\n signal?.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n resolve();\n };\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n"]}
1	+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Minimal, dependency-less HTTP core built on global fetch (Node 18+,\n * browsers, Deno, Bun). Handles auth, query serialization, retries with\n * backoff, timeouts, and error mapping.\n /\n\nimport {\n APIConnectionError,\n APIError,\n APIRequestError,\n APIResponseError,\n APITimeoutError,\n APIUserAbortError,\n ErrorStatus,\n} from './error.js';\n\nexport interface RequestOptions {\n /\n Auto-reconnect for SSE streams (default true): a mid-stream transport\n * drop resumes from the last received event id, like EventSource. Clean\n * stream end, close(), and abort never reconnect. Set false to surface\n * drops as APIConnectionError instead.\n /\n reconnect?: boolean;\n headers?: Record<string, string>;\n signal?: AbortSignal;\n maxRetries?: number;\n /\n Per-request deadline in milliseconds (overrides the client default).\n * Non-finite or <= 0 disables the deadline for this request.\n /\n timeout?: number;\n /\n For streaming (SSE) requests: resume after the event with this id by\n * sending it as the Last-Event-ID request header.\n /\n lastEventId?: string;\n}\n\nexport type QueryPrimitive = string \| number \| boolean;\n/\n Query objects are flattened to dot-delimited paths. `object` is used here\n * deliberately so generated named interfaces (which do not declare an index\n * signature) remain assignable as query parameter values.\n /\nexport type QueryValue = QueryPrimitive \| readonly QueryPrimitive[] \| object \| undefined \| null;\n\nexport interface RequestSpec {\n method: 'GET' \| 'POST' \| 'PUT' \| 'PATCH' \| 'DELETE';\n path: string;\n query?: Record<string, QueryValue>;\n body?: unknown;\n stream?: boolean;\n /* The operation declares no response body (void): 204/empty succeed. /\n void?: boolean;\n}\n\nexport type LogLevel = 'debug' \| 'warn' \| 'off';\n\n/* Minimal logger surface; `console` satisfies it. /\nexport interface Logger {\n debug(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n}\n\nexport interface HttpClientOptions {\n baseURL: string;\n authHeader: () => Record<string, string>;\n maxRetries?: number;\n /* Deadline for ordinary (non-streaming) requests in ms. Default 60000. /\n timeout?: number;\n defaultHeaders?: Record<string, string>;\n fetch?: typeof fetch;\n /* Client-level default values for prominent params (e.g. a tenant/scope id). /\n defaults?: Record<string, string \| undefined>;\n /* Destination for SDK logs. Defaults to `console`. /\n logger?: Logger;\n /\n 'debug' logs every request/response line (method, path, status,\n * duration — never headers or bodies); 'warn' (default) logs only\n * retries; 'off' silences the SDK entirely.\n /\n logLevel?: LogLevel;\n}\n\nconst RETRYABLE_STATUS = new Set([408, 409, 429, 500, 502, 503, 504]);\n\nconst DEFAULT_TIMEOUT_MS = 60_000;\n\n/\n Encode one path segment, rejecting empty/whitespace values at the boundary\n * — an empty segment would silently rewrite the route (/parents//children).\n /\nexport function pathSegment(name: string, value: string \| undefined): string {\n if (value === undefined \|\| String(value).trim() === '') {\n throw new Error(`Missing required path parameter '${name}'.`);\n }\n return encodeURIComponent(value);\n}\n\n/\n Snapshot list params at call time so pagination cannot observe later\n * caller mutations (array-valued filters are copied too). Auto-iteration\n * must never combine pages from different result sets.\n /\nexport function snapshotParams<T>(params: T): T {\n if (params === undefined \|\| params === null \|\| typeof params !== 'object') return params;\n const copy: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(params as Record<string, unknown>)) {\n copy[key] = Array.isArray(value) ? value.slice() : value;\n }\n return copy as T;\n}\n\n/\n Automatic retries apply only to idempotent methods. A POST/PATCH that\n * succeeds server-side but loses its response would be executed twice if\n * retried; callers can opt a specific mutation in via options.maxRetries.\n /\nconst IDEMPOTENT_METHODS = new Set(['GET', 'HEAD', 'PUT', 'DELETE']);\n\n/\n Settle when the promise settles OR the signal aborts — a custom fetch (or\n * body reader) that ignores AbortSignal must not be able to hold a deadlined\n * request open forever. The orphaned promise's eventual rejection is\n * swallowed; its resolution is discarded.\n /\nfunction raceAbort<T>(promise: Promise<T>, signal: AbortSignal \| undefined): Promise<T> {\n if (!signal) return promise;\n return new Promise<T>((resolve, reject) => {\n const onAbort = () => {\n promise.catch(() => {});\n reject(new APIUserAbortError());\n };\n if (signal.aborted) {\n onAbort();\n return;\n }\n signal.addEventListener('abort', onAbort, { once: true });\n promise.then(\n (value) => {\n signal.removeEventListener('abort', onAbort);\n resolve(value);\n },\n (err) => {\n signal.removeEventListener('abort', onAbort);\n reject(err);\n },\n );\n });\n}\n\n/\n Deadline cleanup for streaming responses, handed from rawRequest to the\n * Stream that owns the body. The forwarding listener must survive until the\n * stream terminates (a caller abort has to unblock a pending read on a\n * silent socket), so the Stream — not rawRequest — releases it.\n /\nconst streamCleanups = new WeakMap<Response, () => void>();\n\n/* Claim (and remove) the cleanup registered for a streaming response. /\nexport function takeStreamCleanup(response: Response): (() => void) \| undefined {\n const cleanup = streamCleanups.get(response);\n streamCleanups.delete(response);\n return cleanup;\n}\n\n/* Merged caller-signal + deadline state for one request. /\ninterface Deadline {\n signal: AbortSignal \| undefined;\n /* Stop the timer (body may keep streaming under the caller's signal). /\n settle(): void;\n /\n Detach the abort-forwarding listener from the caller's signal. Call\n * only when the request (including any stream body) is finished — a\n * reused long-lived signal must not accumulate one listener per\n * completed call.\n /\n release(): void;\n timedOut(): boolean;\n ms: number;\n}\n\n/\n A lazily-parsing promise for one API call. Awaiting it (or `.then`) yields\n * the decoded value exactly like a plain promise; `withResponse()` yields the\n * decoded value together with the raw `Response` (status, headers); and\n * `asResponse()` yields the raw `Response` WITHOUT consuming the body, so\n * the caller owns reading it.\n /\nexport class APIPromise<T> implements Promise<T> {\n private parsed: Promise<T> \| undefined;\n private observedRaw = false;\n\n constructor(\n private readonly responsePromise: Promise<Response>,\n private readonly parseFn: (response: Response) => Promise<T>,\n private readonly onRawAccess: () => void,\n ) {\n // A dropped return value must still reach terminal cleanup: the request\n // has already been sent, so unless raw access claims the body FIRST\n // (synchronously, before any await), parsing starts on the next\n // microtask — consuming the body and settling the deadline timer even\n // when the caller never observes the promise. Rejections on this\n // internal branch are swallowed; a caller who later awaits still gets\n // them from the memoized parse.\n queueMicrotask(() => {\n if (!this.observedRaw) this.parse().catch(() => {});\n });\n }\n\n /\n The raw `Response` after status checking and retries; the body is NOT\n * consumed. Reading the body (and its timing) becomes the caller's\n * responsibility — the request deadline stops at header acquisition.\n /\n asResponse(): Promise<Response> {\n // Must be called synchronously after the request (before any await):\n // it claims body ownership away from the auto-parse safety net. Mixing\n // a LATE asResponse() with parsed access yields a response whose body\n // was already consumed by parsing — status/headers stay usable.\n this.observedRaw = true;\n return this.responsePromise.then((response) => {\n this.onRawAccess();\n return response;\n });\n }\n\n /* The decoded value together with the `Response` its body came from. /\n async withResponse(): Promise<{ data: T; response: Response }> {\n const response = await this.responsePromise;\n const data = await this.parse();\n return { data, response };\n }\n\n private parse(): Promise<T> {\n this.parsed ??= this.responsePromise.then(this.parseFn);\n return this.parsed;\n }\n\n then<TResult1 = T, TResult2 = never>(\n onfulfilled?: ((value: T) => TResult1 \| PromiseLike<TResult1>) \| null,\n onrejected?: ((reason: unknown) => TResult2 \| PromiseLike<TResult2>) \| null,\n ): Promise<TResult1 \| TResult2> {\n return this.parse().then(onfulfilled, onrejected);\n }\n\n catch<TResult = never>(\n onrejected?: ((reason: unknown) => TResult \| PromiseLike<TResult>) \| null,\n ): Promise<T \| TResult> {\n return this.parse().catch(onrejected);\n }\n\n finally(onfinally?: (() => void) \| null): Promise<T> {\n return this.parse().finally(onfinally);\n }\n\n readonly [Symbol.toStringTag] = 'APIPromise';\n}\n\nexport class HttpClient {\n private readonly baseURL: string;\n private readonly authHeader: () => Record<string, string>;\n private readonly maxRetries: number;\n private readonly timeout: number;\n private readonly defaultHeaders: Record<string, string>;\n private readonly fetchFn: typeof fetch;\n private readonly logger: Logger;\n private readonly logLevel: LogLevel;\n\n /* Method + path + status only — headers and bodies are never logged. /\n private logDebug(...args: unknown[]): void {\n if (this.logLevel === 'debug') this.logger.debug('[sdk]', ...args);\n }\n\n private logWarn(...args: unknown[]): void {\n if (this.logLevel !== 'off') this.logger.warn('[sdk]', ...args);\n }\n readonly defaults: Record<string, string \| undefined>;\n\n constructor(options: HttpClientOptions) {\n this.defaults = options.defaults ?? {};\n this.logger = options.logger ?? console;\n this.logLevel = options.logLevel ?? 'warn';\n // Validate the STRUCTURE once: operation paths are appended to this\n // value, so a query/fragment/userinfo would silently swallow the\n // request path. Absolute http(s) with a host is required; a path\n // prefix is supported and kept.\n // A literal delimiter parses as an EMPTY search/hash and slips past\n // the checks below; reject the characters outright.\n if (options.baseURL.includes('?') \|\| options.baseURL.includes('#')) {\n throw new Error(\n `baseURL '${options.baseURL}' must not carry userinfo, query, or fragment`,\n );\n }\n let parsed: URL;\n try {\n parsed = new URL(options.baseURL);\n } catch (err) {\n throw new Error(`baseURL '${options.baseURL}' is not an absolute URL`, { cause: err });\n }\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n throw new Error(`baseURL '${options.baseURL}' must use http or https`);\n }\n if (parsed.hostname === '') {\n throw new Error(`baseURL '${options.baseURL}' has no host`);\n }\n if (parsed.username !== '' \|\| parsed.password !== '' \|\| parsed.search !== '' \|\| parsed.hash !== '') {\n throw new Error(\n `baseURL '${options.baseURL}' must not carry userinfo, query, or fragment`,\n );\n }\n this.baseURL = (parsed.origin + parsed.pathname).replace(/\\/+$/, '');\n this.authHeader = options.authHeader;\n this.maxRetries = options.maxRetries ?? 0;\n this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;\n this.defaultHeaders = options.defaultHeaders ?? {};\n this.fetchFn = options.fetch ?? fetch;\n }\n\n /\n The APIPromise pipeline for JSON and void operations. The spec thunk\n * runs inside the async context so synchronous setup failures (e.g. a\n * missing client-default param) surface as rejections, exactly like the\n * plain-promise path. The deadline spans fetch through decode; raw-access\n * consumers release it at header acquisition and own body timing.\n /\n requestAPI<T>(makeSpec: () => RequestSpec, options: RequestOptions = {}): APIPromise<T> {\n const deadline = this.deadline(options);\n let spec: RequestSpec;\n const responsePromise = (async () => {\n try {\n spec = makeSpec();\n return await this.rawRequest(spec, { ...options, signal: deadline.signal });\n } catch (err) {\n deadline.settle();\n deadline.release();\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n }\n })();\n const parseFn = async (response: Response): Promise<T> => {\n try {\n if (spec.void) {\n void response.body?.cancel().catch(() => {});\n return undefined as T;\n }\n if (response.status === 204) {\n throw new APIResponseError(204, 'HTTP 204 where a JSON response was expected');\n }\n const text = await raceAbort(response.text(), deadline.signal);\n if (text.trim() === '' \|\| text.trim() === 'null') {\n throw new APIResponseError(\n response.status,\n `HTTP ${response.status} with an empty or null body where a JSON response was expected`,\n );\n }\n try {\n return JSON.parse(text) as T;\n } catch (err) {\n throw new APIResponseError(response.status, 'response body is not valid JSON', err);\n }\n } catch (err) {\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n } finally {\n deadline.settle();\n deadline.release();\n }\n };\n return new APIPromise<T>(responsePromise, parseFn, () => {\n deadline.settle();\n deadline.release();\n });\n }\n\n async request<T>(spec: RequestSpec, options: RequestOptions = {}): Promise<T> {\n // Ordinary JSON calls keep the deadline through body consumption and\n // decoding — a response that stalls mid-body still times out.\n const deadline = this.deadline(options);\n try {\n const response = await this.rawRequest(spec, { ...options, signal: deadline.signal });\n // Branch on the GENERATED expectation, not the HTTP status: a void\n // method accepts 204/empty, but an output-bearing method requires a\n // JSON document — empty/null would fabricate a resource outside the\n // declared contract, and malformed JSON must be a stable SDK error.\n if (spec.void) {\n void response.body?.cancel().catch(() => {});\n return undefined as T;\n }\n if (response.status === 204) {\n throw new APIResponseError(204, 'HTTP 204 where a JSON response was expected');\n }\n const text = await raceAbort(response.text(), deadline.signal);\n if (text.trim() === '' \|\| text.trim() === 'null') {\n throw new APIResponseError(\n response.status,\n `HTTP ${response.status} with an empty or null body where a JSON response was expected`,\n );\n }\n try {\n return JSON.parse(text) as T;\n } catch (err) {\n throw new APIResponseError(response.status, 'response body is not valid JSON', err);\n }\n } catch (err) {\n if (deadline.timedOut()) throw new APITimeoutError(deadline.ms);\n throw err;\n } finally {\n deadline.settle();\n deadline.release();\n }\n }\n\n async rawRequest(spec: RequestSpec, options: RequestOptions = {}): Promise<Response> {\n const url = this.buildURL(spec.path, spec.query);\n\n // One Headers instance; `set` is case-insensitive, so later layers\n // OVERRIDE earlier ones regardless of spelling (object spread would keep\n // both `Authorization` and `authorization` and fetch would join the two\n // values into one corrupt header). Precedence: generated defaults →\n // client defaults → auth → per-request → Last-Event-ID (the semantic\n // option is the single source of resume state).\n const headers = new Headers();\n headers.set('Accept', spec.stream ? 'text/event-stream' : 'application/json');\n if (spec.body !== undefined) headers.set('Content-Type', 'application/json');\n for (const [key, value] of Object.entries(this.defaultHeaders)) headers.set(key, value);\n for (const [key, value] of Object.entries(this.authHeader())) headers.set(key, value);\n for (const [key, value] of Object.entries(options.headers ?? {})) headers.set(key, value);\n if (options.lastEventId !== undefined) {\n headers.set('Last-Event-ID', options.lastEventId);\n }\n\n // Serialize ONCE, before the transport/retry loop: a circular object or\n // BigInt is a caller bug, not a network failure — it must surface as a\n // stable request-construction error and never be retried.\n let bodyText: string \| undefined;\n if (spec.body !== undefined) {\n try {\n bodyText = JSON.stringify(spec.body);\n } catch (err) {\n throw new APIRequestError('request body is not JSON-serializable', err);\n }\n if (bodyText === undefined) {\n throw new APIRequestError('request body serialized to undefined', undefined);\n }\n }\n\n // Streams bound only connection/response-header acquisition; the body's\n // lifetime stays under the caller's AbortSignal.\n const streamDeadline = spec.stream ? this.deadline(options) : undefined;\n const signal = streamDeadline ? streamDeadline.signal : options.signal;\n\n // An explicit per-request maxRetries opts in even for mutations.\n const maxRetries = normalizeRetries(\n options.maxRetries !== undefined\n ? options.maxRetries\n : IDEMPOTENT_METHODS.has(spec.method)\n ? this.maxRetries\n : 0,\n );\n\n const startedAt = Date.now();\n for (let attempt = 0; ; attempt++) {\n this.logDebug(`-> ${spec.method} ${spec.path}`, attempt > 0 ? `(attempt ${attempt + 1})` : '');\n let response: Response;\n try {\n response = await raceAbort(\n this.fetchFn(url, {\n method: spec.method,\n headers,\n body: bodyText,\n signal: signal ?? null,\n }),\n signal,\n );\n } catch (err) {\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) {\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIUserAbortError();\n }\n if (attempt < maxRetries) {\n this.logWarn(`retrying ${spec.method} ${spec.path} after connection error (attempt ${attempt + 1}/${maxRetries + 1})`);\n await sleep(backoffMs(attempt, undefined), signal);\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) throw new APIUserAbortError();\n continue;\n }\n // Terminal connection failure: the deadline timer must not outlive\n // the reported error (an orphaned timer holds the process open).\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIConnectionError(err);\n }\n\n if (response.ok) {\n this.logDebug(`<- ${response.status} ${spec.method} ${spec.path} (${Date.now() - startedAt}ms)`);\n // Response headers acquired: the stream body is now unbounded. The\n // forwarding listener stays attached (caller abort must reach the\n // body); the Stream releases it at its terminal state.\n if (streamDeadline) {\n streamDeadline.settle();\n streamCleanups.set(response, () => streamDeadline.release());\n }\n return response;\n }\n\n if (RETRYABLE_STATUS.has(response.status) && attempt < maxRetries) {\n this.logWarn(`retrying ${spec.method} ${spec.path} after HTTP ${response.status} (attempt ${attempt + 1}/${maxRetries + 1})`);\n // Release the discarded response so its connection can be reused.\n void response.body?.cancel().catch(() => {});\n await sleep(backoffMs(attempt, response.headers.get('retry-after')), signal);\n // A stream deadline that fired during backoff is a timeout, not a\n // user abort — rawRequest has no outer mapper to reclassify it.\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n if (signal?.aborted) throw new APIUserAbortError();\n continue;\n }\n\n let body: ErrorStatus \| undefined;\n try {\n body = (await response.json()) as ErrorStatus;\n } catch {\n body = undefined;\n }\n // The deadline stays active while consuming a non-2xx error body; if\n // it expired there, report the timeout rather than a truncated\n // APIError.\n if (streamDeadline?.timedOut()) {\n streamDeadline.settle();\n streamDeadline.release();\n throw new APITimeoutError(streamDeadline.ms);\n }\n streamDeadline?.settle();\n streamDeadline?.release();\n throw new APIError(response.status, body);\n }\n }\n\n /\n Merge the caller's signal with the configured deadline. The caller's\n * abort always forwards; the timer marks timedOut so the thrown error can\n * be classified as APITimeoutError rather than APIUserAbortError.\n /\n private deadline(options: RequestOptions): Deadline {\n const ms = options.timeout ?? this.timeout;\n if (!Number.isFinite(ms) \|\| ms <= 0) {\n return { signal: options.signal, settle() {}, release() {}, timedOut: () => false, ms };\n }\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, ms);\n const forward = () => controller.abort();\n if (options.signal?.aborted) {\n controller.abort();\n } else {\n options.signal?.addEventListener('abort', forward, { once: true });\n }\n let settled = false;\n let released = false;\n return {\n signal: controller.signal,\n settle() {\n if (settled) return;\n settled = true;\n clearTimeout(timer);\n },\n release() {\n if (released) return;\n released = true;\n options.signal?.removeEventListener('abort', forward);\n },\n timedOut: () => timedOut,\n ms,\n };\n }\n\n private buildURL(path: string, query?: Record<string, QueryValue>): string {\n const url = new URL(this.baseURL + path);\n const ancestors = new Set<object>();\n for (const [key, value] of Object.entries(query ?? {})) {\n appendQueryValue(url.searchParams, key, value, ancestors);\n }\n return url.toString();\n }\n}\n\n/\n Flatten nested query objects to dot-delimited paths. Arrays retain the\n * existing repeated-parameter behavior at whichever path they occur:\n * `{ filters: { state: ['a', 'b'] } }` becomes\n * `?filters.state=a&filters.state=b`.\n /\nfunction appendQueryValue(\n searchParams: URLSearchParams,\n key: string,\n value: unknown,\n ancestors: Set<object>,\n): void {\n if (value === undefined \|\| value === null) return;\n\n if (typeof value !== 'object') {\n searchParams.append(key, String(value));\n return;\n }\n\n if (ancestors.has(value)) {\n throw new APIRequestError('query parameters contain a circular reference', undefined);\n }\n ancestors.add(value);\n try {\n if (Array.isArray(value)) {\n for (const item of value) appendQueryValue(searchParams, key, item, ancestors);\n return;\n }\n\n for (const [childKey, childValue] of Object.entries(value)) {\n appendQueryValue(searchParams, `${key}.${childKey}`, childValue, ancestors);\n }\n } finally {\n ancestors.delete(value);\n }\n}\n\n/* Retry counts must be bounded non-negative integers; anything else (NaN,\n * Infinity, negatives, fractions) is treated as the nearest sane value. /\nfunction normalizeRetries(value: number): number {\n if (!Number.isFinite(value) \|\| value <= 0) return 0;\n return Math.min(Math.floor(value), 10);\n}\n\nfunction backoffMs(attempt: number, retryAfter: string \| null \| undefined): number {\n if (retryAfter) {\n // Retry-After is either delta-seconds or an HTTP-date. A parsed zero is\n // a real answer (retry immediately), not a fall-through to backoff.\n const seconds = Number(retryAfter);\n if (Number.isFinite(seconds) && seconds >= 0) return Math.min(seconds 1000, 60_000);\n const date = Date.parse(retryAfter);\n if (Number.isFinite(date)) {\n return Math.min(Math.max(date - Date.now(), 0), 60_000);\n }\n }\n const base = 500 * 2 ** Math.min(attempt, 4);\n return Math.min(base + Math.random() * base, 8000);\n}\n\n/** Sleep that wakes early when the signal aborts (caller re-checks it). */\nfunction sleep(ms: number, signal?: AbortSignal \| null): Promise<void> {\n return new Promise((resolve) => {\n if (signal?.aborted) return resolve();\n const timer = setTimeout(() => {\n signal?.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n resolve();\n };\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n"]}

package/dist/types.d.ts CHANGED Viewed

@@ -214,7 +214,7 @@ export interface WidgetErrorEvent {
  *  strings. Tool arguments cross this boundary only when an enabled tool set
  *  overlay explicitly opts the matching tool in.
  */
-export type WidgetEvent = WidgetEvent_UserMessage | WidgetEvent_AssistantMessage | WidgetEvent_ToolApprovalRequested | WidgetEvent_ToolApproved | WidgetEvent_ToolDenied | WidgetEvent_ToolCalled | WidgetEvent_ToolResult | WidgetEvent_ToolError | WidgetEvent_Error | WidgetEvent_Cancelled | WidgetEvent_TimedOut | WidgetEvent_Finalized;
+export type WidgetEvent = WidgetEvent_UserMessage | WidgetEvent_AssistantMessage | WidgetEvent_ToolApprovalRequested | WidgetEvent_ToolApproved | WidgetEvent_ToolDenied | WidgetEvent_ToolCalled | WidgetEvent_ToolResult | WidgetEvent_ToolError | WidgetEvent_Error | WidgetEvent_Cancelled | WidgetEvent_TimedOut | WidgetEvent_Finalized | WidgetEvent_Heartbeat | WidgetEvent_StateChanged;
 /**
  * WidgetFinalizedEvent: the conversation's agent produced its structured
  *  output and the objective reached its terminal state. Only agents with an
@@ -229,6 +229,23 @@ export interface WidgetFinalizedEvent {
      */
     output?: Record<string, unknown>;
 }
+/**
+ * WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,
+ *  absent from history, and never a reconnect checkpoint or state transition.
+ */
+export interface WidgetHeartbeatEvent {
+}
+export type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+export type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+/**
+ * WidgetObjectiveStateChangedEvent mirrors a durable objective transition.
+ *  Internal status messages are intentionally omitted. Pending/running maps
+ *  to a responding conversation, waiting to open, and terminal states to closed.
+ */
+export interface WidgetObjectiveStateChangedEvent {
+    fromState: WidgetObjectiveStateChangedEventFromState;
+    toState: WidgetObjectiveStateChangedEventToState;
+}
 /**
  * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.
  */
@@ -327,8 +344,9 @@ export interface WidgetEvent_UserMessage {
     type: 'userMessage';
     userMessage: WidgetUserMessageEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -341,8 +359,9 @@ export interface WidgetEvent_AssistantMessage {
     type: 'assistantMessage';
     assistantMessage: WidgetAssistantMessageEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -355,8 +374,9 @@ export interface WidgetEvent_ToolApprovalRequested {
     type: 'toolApprovalRequested';
     toolApprovalRequested: WidgetToolApprovalRequestedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -369,8 +389,9 @@ export interface WidgetEvent_ToolApproved {
     type: 'toolApproved';
     toolApproved: WidgetToolApprovedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -383,8 +404,9 @@ export interface WidgetEvent_ToolDenied {
     type: 'toolDenied';
     toolDenied: WidgetToolDeniedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -397,8 +419,9 @@ export interface WidgetEvent_ToolCalled {
     type: 'toolCalled';
     toolCalled: WidgetToolCalledEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -411,8 +434,9 @@ export interface WidgetEvent_ToolResult {
     type: 'toolResult';
     toolResult: WidgetToolResultEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -425,8 +449,9 @@ export interface WidgetEvent_ToolError {
     type: 'toolError';
     toolError: WidgetToolErrorEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -439,8 +464,9 @@ export interface WidgetEvent_Error {
     type: 'error';
     error: WidgetErrorEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -453,8 +479,9 @@ export interface WidgetEvent_Cancelled {
     type: 'cancelled';
     cancelled: WidgetCancelledEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -467,8 +494,9 @@ export interface WidgetEvent_TimedOut {
     type: 'timedOut';
     timedOut: WidgetTimedOutEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -481,8 +509,39 @@ export interface WidgetEvent_Finalized {
     type: 'finalized';
     finalized: WidgetFinalizedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
+     */
+    id: string;
+    /**
+     * The conversation this event belongs to.
+     */
+    conversationId: string;
+    createdAt: string;
+}
+export interface WidgetEvent_Heartbeat {
+    type: 'heartbeat';
+    heartbeat: WidgetHeartbeatEvent;
+    /**
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
+     */
+    id: string;
+    /**
+     * The conversation this event belongs to.
+     */
+    conversationId: string;
+    createdAt: string;
+}
+export interface WidgetEvent_StateChanged {
+    type: 'stateChanged';
+    stateChanged: WidgetObjectiveStateChangedEvent;
+    /**
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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~~AAE1B~~;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,sBAAsB,CAAC;IACpC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,kBAAkB,CAAC;IACzB,gBAAgB,EAAE,2BAA2B,CAAC;IAC9C~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,qBAAqB,EAAE,gCAAgC,CAAC;IACxD~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,uBAAuB,CAAC;IACtC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,qBAAqB,CAAC;IAClC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,qBAAqB,CAAC;IAClC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,qBAAqB,CAAC;IAClC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,oBAAoB,CAAC;IAChC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,gBAAgB,CAAC;IACxB~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,oBAAoB,CAAC;IAChC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,oBAAoB,CAAC;IAChC~~;;;OAGG~~;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\n/*\n Approve tool call request. Responds to a toolApprovalRequested event.\n /\nexport interface ApproveToolCallRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The tool call awaiting a decision, from the toolApprovalRequested event.\n /\n toolCallId?: string;\n}\n\n/\n Continue conversation request.\n /\nexport interface ContinueConversationRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The visitor's next message.\n /\n message: string;\n}\n\n/\n Create conversation request. The session, tenant, subject, secrets, labels,\n * and pinned parameters all come from the presenting token's session — the\n * browser asserts nothing.\n /\nexport interface CreateConversationRequest {\n /\n The visitor's opening message.\n /\n message: string;\n}\n\n/\n Deny tool call request. Responds to a toolApprovalRequested event.\n /\nexport interface DenyToolCallRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The tool call awaiting a decision, from the toolApprovalRequested event.\n /\n toolCallId?: string;\n}\n\n/\n Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.\n /\nexport interface GoogleProtobufAny {\n /\n The type of the serialized message.\n /\n '@type'?: string;\n}\n\n/\n Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.\n /\nexport type GoogleProtobufValue = unknown;\n\n/\n List conversation events response. Ordered oldest first.\n /\nexport interface ListConversationEventsResponse {\n items?: Array<WidgetEvent>;\n pagination?: Page;\n}\n\n/\n List conversations response. Ordered by last activity, newest first.\n /\nexport interface ListConversationsResponse {\n items?: Array<WidgetConversation>;\n pagination?: Page;\n}\n\n/\n Page carries pagination data for list responses. A deliberate local\n * duplicate of the api module's Page — this package imports nothing from\n * cadenya.api.v1 (see the workspace README).\n /\nexport interface Page {\n /\n Cursor for the next page. Empty when there are no further results.\n /\n nextCursor?: string;\n /\n Total number of items matching the request.\n /\n total?: number;\n}\n\n/\n Set tool call content request. Lets the embedding page supply the result\n * of a bare tool call (one whose tool set has no execution adapter) — the\n * widget-session flavor of the reverse-harness pattern, where client-side\n * logic executes the tool and reports the result back. The result then\n * reaches the conversation as a toolResult event.\n /\nexport interface SetToolCallContentRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The bare tool call to supply content for.\n /\n toolCallId?: string;\n /\n The tool call's result content.\n /\n content: string;\n}\n\n/\n The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n /\nexport interface Status {\n /\n The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].\n /\n code?: number;\n /\n A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.\n /\n message?: string;\n /\n A list of messages that carry the error details. There is a common set of message types for APIs to use.\n /\n details?: Array<GoogleProtobufAny>;\n}\n\n/\n Submit conversation feedback request — the visitor's rating of a\n * conversation, mirroring internal objective feedback in slimmed form. Flows\n * into the same feedback machinery that scores agent variations.\n /\nexport interface SubmitConversationFeedbackRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n A score between -1.0 and 1.0. -1.0 is the worst, 0.0 neutral, 1.0 the\n * best — a thumbs-down/up UI maps to -1.0/1.0.\n /\n score: number;\n /\n Optional comment explaining the feedback.\n /\n comment?: string;\n}\n\n/\n WidgetAssistantMessageEvent is a message from the agent. Content may\n * arrive incrementally: later events for the same turn replace earlier\n * partial content.\n /\nexport interface WidgetAssistantMessageEvent {\n content: string;\n}\n\n/\n WidgetCancelledEvent: the conversation was cancelled. Terminal.\n /\nexport interface WidgetCancelledEvent {\n}\n\n/\n WidgetConfig is the widget's presentation configuration, served to the\n * browser before any session exists. Contains nothing sensitive: the widget\n * is identified by the hostname, and the edge has already enforced the\n * origin allowlist by the time this is served.\n /\nexport interface WidgetConfig {\n /\n Display name shown in the widget header.\n /\n displayName: string;\n}\n\nexport type WidgetConversationState = 'STATE_UNSPECIFIED' \| 'STATE_RESPONDING' \| 'STATE_OPEN' \| 'STATE_CLOSED';\n\n/\n WidgetConversation is one conversation between the session's visitor and\n * the widget's agent. Conversations are scoped by the presenting token to the\n * VISITOR: a session with a subject sees that subject's conversations on this\n * widget; a session without one sees only the conversations it created\n * itself. A conversation id from outside that scope is indistinguishable from\n * one that does not exist. Tenant is a management-side grouping only — it is\n * never a read scope on this surface.\n /\nexport interface WidgetConversation {\n id: string;\n state: WidgetConversationState;\n /\n Server-derived display title (e.g. from the opening message).\n /\n title?: string;\n createdAt: string;\n /\n When the conversation last saw a message or event.\n /\n lastActiveAt?: string;\n}\n\n/\n WidgetErrorEvent reports a visitor-safe conversation error. The message is\n * sanitized; internal error detail never reaches the widget.\n /\nexport interface WidgetErrorEvent {\n message: string;\n}\n\n/\n WidgetEvent is the visitor-facing event vocabulary. It MIRRORS the internal\n * conversation event variants — same granularity, same discriminator names —\n * with slimmed messages holding exactly what a widget UI needs. Internal\n * events map to these through an explicit, exhaustive server-side projection;\n * internal-only types (context compaction, memory reads, sub-agent\n * bookkeeping) have no widget variant and are dropped. Nothing here carries\n * tool configuration, server identities, operator details, or internal error\n * strings. Tool arguments cross this boundary only when an enabled tool set\n * overlay explicitly opts the matching tool in.\n /\nexport type WidgetEvent =\n \| WidgetEvent_UserMessage\n \| WidgetEvent_AssistantMessage\n \| WidgetEvent_ToolApprovalRequested\n \| WidgetEvent_ToolApproved\n \| WidgetEvent_ToolDenied\n \| WidgetEvent_ToolCalled\n \| WidgetEvent_ToolResult\n \| WidgetEvent_ToolError\n \| WidgetEvent_Error\n \| WidgetEvent_Cancelled\n \| WidgetEvent_TimedOut\n \| WidgetEvent_Finalized;\n\n/\n WidgetFinalizedEvent: the conversation's agent produced its structured\n * output and the objective reached its terminal state. Only agents with an\n * output definition finalize — such an agent ends the conversation after one\n * turn, so a widget bound to one should treat this as the answer, not a\n * message to keep chatting past.\n /\nexport interface WidgetFinalizedEvent {\n /\n The structured output the agent produced, matching the shape of the\n * agent's output definition schema.\n /\n output?: Record<string, unknown>;\n}\n\n/\n WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.\n /\nexport interface WidgetTimedOutEvent {\n}\n\n/\n WidgetToolApprovalRequestedEvent asks the visitor to approve or deny a\n * tool call before it runs. The tool reference lets the embedding UI render\n * a custom approval experience per tool; the visitor responds via the\n * approve/deny endpoints.\n /\nexport interface WidgetToolApprovalRequestedEvent {\n /\n The tool call awaiting a decision; pass it to the approve/deny endpoint.\n /\n toolCallId: string;\n tool: WidgetToolReference;\n}\n\n/\n WidgetToolApprovedEvent records that the pending tool call was approved.\n /\nexport interface WidgetToolApprovedEvent {\n toolCallId: string;\n}\n\n/\n WidgetToolCalledEvent reports that the agent invoked a tool.\n /\nexport interface WidgetToolCalledEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n /\n The final arguments sent to the tool, after parameter actions were\n * applied. Present only when an enabled matching tool set overlay opts the\n * tool into exposing arguments in widget sessions. Arguments are omitted\n * by default because they may contain sensitive customer data.\n /\n arguments?: Record<string, unknown>;\n}\n\n/\n WidgetToolDeniedEvent records that the pending tool call was denied.\n /\nexport interface WidgetToolDeniedEvent {\n toolCallId: string;\n}\n\n/\n WidgetToolErrorEvent reports that a tool call failed. Internal error\n * detail never reaches the widget.\n /\nexport interface WidgetToolErrorEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n}\n\n/\n WidgetToolReference identifies the tool involved in a tool event — enough\n * for the embedding UI to label the activity and to register custom\n * renderers keyed by the tool's id or the customer's own external id.\n * Deliberately omitted: tool configuration, adapter details, and any server\n * identity.\n /\nexport interface WidgetToolReference {\n /\n Cadenya's canonical tool id.\n /\n id: string;\n /\n The tool's external id in the customer's namespace, when set.\n /\n externalId?: string;\n /\n The tool's name as the workspace configured it (e.g. \"FetchOrderDetails\").\n /\n name: string;\n}\n\n/\n WidgetToolResultEvent reports that a tool call finished. Result content is\n * omitted by default and included only for tools the workspace has opted in\n * to sharing content with widget sessions.\n /\nexport interface WidgetToolResultEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n /\n The tool's result, present only for tools opted in to sharing content\n * with widget sessions (a per-tool setting; default off). Arbitrary JSON\n * the embedding UI may render — chart data, cards, structured results.\n /\n content?: GoogleProtobufValue;\n}\n\n/\n WidgetUserMessageEvent is a message from the visitor.\n /\nexport interface WidgetUserMessageEvent {\n content: string;\n}\n\nexport interface WidgetEvent_UserMessage {\n type: 'userMessage';\n userMessage: WidgetUserMessageEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_AssistantMessage {\n type: 'assistantMessage';\n assistantMessage: WidgetAssistantMessageEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApprovalRequested {\n type: 'toolApprovalRequested';\n toolApprovalRequested: WidgetToolApprovalRequestedEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApproved {\n type: 'toolApproved';\n toolApproved: WidgetToolApprovedEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolDenied {\n type: 'toolDenied';\n toolDenied: WidgetToolDeniedEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolCalled {\n type: 'toolCalled';\n toolCalled: WidgetToolCalledEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolResult {\n type: 'toolResult';\n toolResult: WidgetToolResultEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolError {\n type: 'toolError';\n toolError: WidgetToolErrorEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Error {\n type: 'error';\n error: WidgetErrorEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Cancelled {\n type: 'cancelled';\n cancelled: WidgetCancelledEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_TimedOut {\n type: 'timedOut';\n timedOut: WidgetTimedOutEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Finalized {\n type: 'finalized';\n finalized: WidgetFinalizedEvent;\n /\n Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n * `Last-Event-ID` on reconnect to resume without duplication.\n /\n id: string;\n /\n The conversation this event belongs to.\n */\n conversationId: string;\n createdAt: string;\n}\n\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\n/*\n Approve tool call request. Responds to a toolApprovalRequested event.\n /\nexport interface ApproveToolCallRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The tool call awaiting a decision, from the toolApprovalRequested event.\n /\n toolCallId?: string;\n}\n\n/\n Continue conversation request.\n /\nexport interface ContinueConversationRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The visitor's next message.\n /\n message: string;\n}\n\n/\n Create conversation request. The session, tenant, subject, secrets, labels,\n * and pinned parameters all come from the presenting token's session — the\n * browser asserts nothing.\n /\nexport interface CreateConversationRequest {\n /\n The visitor's opening message.\n /\n message: string;\n}\n\n/\n Deny tool call request. Responds to a toolApprovalRequested event.\n /\nexport interface DenyToolCallRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The tool call awaiting a decision, from the toolApprovalRequested event.\n /\n toolCallId?: string;\n}\n\n/\n Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.\n /\nexport interface GoogleProtobufAny {\n /\n The type of the serialized message.\n /\n '@type'?: string;\n}\n\n/\n Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.\n /\nexport type GoogleProtobufValue = unknown;\n\n/\n List conversation events response. Ordered oldest first.\n /\nexport interface ListConversationEventsResponse {\n items?: Array<WidgetEvent>;\n pagination?: Page;\n}\n\n/\n List conversations response. Ordered by last activity, newest first.\n /\nexport interface ListConversationsResponse {\n items?: Array<WidgetConversation>;\n pagination?: Page;\n}\n\n/\n Page carries pagination data for list responses. A deliberate local\n * duplicate of the api module's Page — this package imports nothing from\n * cadenya.api.v1 (see the workspace README).\n /\nexport interface Page {\n /\n Cursor for the next page. Empty when there are no further results.\n /\n nextCursor?: string;\n /\n Total number of items matching the request.\n /\n total?: number;\n}\n\n/\n Set tool call content request. Lets the embedding page supply the result\n * of a bare tool call (one whose tool set has no execution adapter) — the\n * widget-session flavor of the reverse-harness pattern, where client-side\n * logic executes the tool and reports the result back. The result then\n * reaches the conversation as a toolResult event.\n /\nexport interface SetToolCallContentRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n The bare tool call to supply content for.\n /\n toolCallId?: string;\n /\n The tool call's result content.\n /\n content: string;\n}\n\n/\n The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n /\nexport interface Status {\n /\n The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].\n /\n code?: number;\n /\n A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.\n /\n message?: string;\n /\n A list of messages that carry the error details. There is a common set of message types for APIs to use.\n /\n details?: Array<GoogleProtobufAny>;\n}\n\n/\n Submit conversation feedback request — the visitor's rating of a\n * conversation, mirroring internal objective feedback in slimmed form. Flows\n * into the same feedback machinery that scores agent variations.\n /\nexport interface SubmitConversationFeedbackRequest {\n /\n Conversation ID.\n /\n id?: string;\n /\n A score between -1.0 and 1.0. -1.0 is the worst, 0.0 neutral, 1.0 the\n * best — a thumbs-down/up UI maps to -1.0/1.0.\n /\n score: number;\n /\n Optional comment explaining the feedback.\n /\n comment?: string;\n}\n\n/\n WidgetAssistantMessageEvent is a message from the agent. Content may\n * arrive incrementally: later events for the same turn replace earlier\n * partial content.\n /\nexport interface WidgetAssistantMessageEvent {\n content: string;\n}\n\n/\n WidgetCancelledEvent: the conversation was cancelled. Terminal.\n /\nexport interface WidgetCancelledEvent {\n}\n\n/\n WidgetConfig is the widget's presentation configuration, served to the\n * browser before any session exists. Contains nothing sensitive: the widget\n * is identified by the hostname, and the edge has already enforced the\n * origin allowlist by the time this is served.\n /\nexport interface WidgetConfig {\n /\n Display name shown in the widget header.\n /\n displayName: string;\n}\n\nexport type WidgetConversationState = 'STATE_UNSPECIFIED' \| 'STATE_RESPONDING' \| 'STATE_OPEN' \| 'STATE_CLOSED';\n\n/\n WidgetConversation is one conversation between the session's visitor and\n * the widget's agent. Conversations are scoped by the presenting token to the\n * VISITOR: a session with a subject sees that subject's conversations on this\n * widget; a session without one sees only the conversations it created\n * itself. A conversation id from outside that scope is indistinguishable from\n * one that does not exist. Tenant is a management-side grouping only — it is\n * never a read scope on this surface.\n /\nexport interface WidgetConversation {\n id: string;\n state: WidgetConversationState;\n /\n Server-derived display title (e.g. from the opening message).\n /\n title?: string;\n createdAt: string;\n /\n When the conversation last saw a message or event.\n /\n lastActiveAt?: string;\n}\n\n/\n WidgetErrorEvent reports a visitor-safe conversation error. The message is\n * sanitized; internal error detail never reaches the widget.\n /\nexport interface WidgetErrorEvent {\n message: string;\n}\n\n/\n WidgetEvent is the visitor-facing event vocabulary. It MIRRORS the internal\n * conversation event variants — same granularity, same discriminator names —\n * with slimmed messages holding exactly what a widget UI needs. Internal\n * events map to these through an explicit, exhaustive server-side projection;\n * internal-only types (context compaction, memory reads, sub-agent\n * bookkeeping) have no widget variant and are dropped. Nothing here carries\n * tool configuration, server identities, operator details, or internal error\n * strings. Tool arguments cross this boundary only when an enabled tool set\n * overlay explicitly opts the matching tool in.\n /\nexport type WidgetEvent =\n \| WidgetEvent_UserMessage\n \| WidgetEvent_AssistantMessage\n \| WidgetEvent_ToolApprovalRequested\n \| WidgetEvent_ToolApproved\n \| WidgetEvent_ToolDenied\n \| WidgetEvent_ToolCalled\n \| WidgetEvent_ToolResult\n \| WidgetEvent_ToolError\n \| WidgetEvent_Error\n \| WidgetEvent_Cancelled\n \| WidgetEvent_TimedOut\n \| WidgetEvent_Finalized\n \| WidgetEvent_Heartbeat\n \| WidgetEvent_StateChanged;\n\n/\n WidgetFinalizedEvent: the conversation's agent produced its structured\n * output and the objective reached its terminal state. Only agents with an\n * output definition finalize — such an agent ends the conversation after one\n * turn, so a widget bound to one should treat this as the answer, not a\n * message to keep chatting past.\n /\nexport interface WidgetFinalizedEvent {\n /\n The structured output the agent produced, matching the shape of the\n * agent's output definition schema.\n /\n output?: Record<string, unknown>;\n}\n\n/\n WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,\n * absent from history, and never a reconnect checkpoint or state transition.\n /\nexport interface WidgetHeartbeatEvent {\n}\n\nexport type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' \| 'WIDGET_OBJECTIVE_STATE_PENDING' \| 'WIDGET_OBJECTIVE_STATE_RUNNING' \| 'WIDGET_OBJECTIVE_STATE_WAITING' \| 'WIDGET_OBJECTIVE_STATE_FAILED' \| 'WIDGET_OBJECTIVE_STATE_CANCELLED' \| 'WIDGET_OBJECTIVE_STATE_FINALIZED' \| 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';\n\nexport type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' \| 'WIDGET_OBJECTIVE_STATE_PENDING' \| 'WIDGET_OBJECTIVE_STATE_RUNNING' \| 'WIDGET_OBJECTIVE_STATE_WAITING' \| 'WIDGET_OBJECTIVE_STATE_FAILED' \| 'WIDGET_OBJECTIVE_STATE_CANCELLED' \| 'WIDGET_OBJECTIVE_STATE_FINALIZED' \| 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';\n\n/\n WidgetObjectiveStateChangedEvent mirrors a durable objective transition.\n * Internal status messages are intentionally omitted. Pending/running maps\n * to a responding conversation, waiting to open, and terminal states to closed.\n /\nexport interface WidgetObjectiveStateChangedEvent {\n fromState: WidgetObjectiveStateChangedEventFromState;\n toState: WidgetObjectiveStateChangedEventToState;\n}\n\n/\n WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.\n /\nexport interface WidgetTimedOutEvent {\n}\n\n/\n WidgetToolApprovalRequestedEvent asks the visitor to approve or deny a\n * tool call before it runs. The tool reference lets the embedding UI render\n * a custom approval experience per tool; the visitor responds via the\n * approve/deny endpoints.\n /\nexport interface WidgetToolApprovalRequestedEvent {\n /\n The tool call awaiting a decision; pass it to the approve/deny endpoint.\n /\n toolCallId: string;\n tool: WidgetToolReference;\n}\n\n/\n WidgetToolApprovedEvent records that the pending tool call was approved.\n /\nexport interface WidgetToolApprovedEvent {\n toolCallId: string;\n}\n\n/\n WidgetToolCalledEvent reports that the agent invoked a tool.\n /\nexport interface WidgetToolCalledEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n /\n The final arguments sent to the tool, after parameter actions were\n * applied. Present only when an enabled matching tool set overlay opts the\n * tool into exposing arguments in widget sessions. Arguments are omitted\n * by default because they may contain sensitive customer data.\n /\n arguments?: Record<string, unknown>;\n}\n\n/\n WidgetToolDeniedEvent records that the pending tool call was denied.\n /\nexport interface WidgetToolDeniedEvent {\n toolCallId: string;\n}\n\n/\n WidgetToolErrorEvent reports that a tool call failed. Internal error\n * detail never reaches the widget.\n /\nexport interface WidgetToolErrorEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n}\n\n/\n WidgetToolReference identifies the tool involved in a tool event — enough\n * for the embedding UI to label the activity and to register custom\n * renderers keyed by the tool's id or the customer's own external id.\n * Deliberately omitted: tool configuration, adapter details, and any server\n * identity.\n /\nexport interface WidgetToolReference {\n /\n Cadenya's canonical tool id.\n /\n id: string;\n /\n The tool's external id in the customer's namespace, when set.\n /\n externalId?: string;\n /\n The tool's name as the workspace configured it (e.g. \"FetchOrderDetails\").\n /\n name: string;\n}\n\n/\n WidgetToolResultEvent reports that a tool call finished. Result content is\n * omitted by default and included only for tools the workspace has opted in\n * to sharing content with widget sessions.\n /\nexport interface WidgetToolResultEvent {\n toolCallId: string;\n tool: WidgetToolReference;\n /\n The tool's result, present only for tools opted in to sharing content\n * with widget sessions (a per-tool setting; default off). Arbitrary JSON\n * the embedding UI may render — chart data, cards, structured results.\n /\n content?: GoogleProtobufValue;\n}\n\n/\n WidgetUserMessageEvent is a message from the visitor.\n /\nexport interface WidgetUserMessageEvent {\n content: string;\n}\n\nexport interface WidgetEvent_UserMessage {\n type: 'userMessage';\n userMessage: WidgetUserMessageEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_AssistantMessage {\n type: 'assistantMessage';\n assistantMessage: WidgetAssistantMessageEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApprovalRequested {\n type: 'toolApprovalRequested';\n toolApprovalRequested: WidgetToolApprovalRequestedEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApproved {\n type: 'toolApproved';\n toolApproved: WidgetToolApprovedEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolDenied {\n type: 'toolDenied';\n toolDenied: WidgetToolDeniedEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolCalled {\n type: 'toolCalled';\n toolCalled: WidgetToolCalledEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolResult {\n type: 'toolResult';\n toolResult: WidgetToolResultEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_ToolError {\n type: 'toolError';\n toolError: WidgetToolErrorEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Error {\n type: 'error';\n error: WidgetErrorEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Cancelled {\n type: 'cancelled';\n cancelled: WidgetCancelledEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_TimedOut {\n type: 'timedOut';\n timedOut: WidgetTimedOutEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Finalized {\n type: 'finalized';\n finalized: WidgetFinalizedEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_Heartbeat {\n type: 'heartbeat';\n heartbeat: WidgetHeartbeatEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n /\n conversationId: string;\n createdAt: string;\n}\n\nexport interface WidgetEvent_StateChanged {\n type: 'stateChanged';\n stateChanged: WidgetObjectiveStateChangedEvent;\n /\n Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n * as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n * Transient heartbeats carry hb_ IDs in this payload only.\n /\n id: string;\n /\n The conversation this event belongs to.\n */\n conversationId: string;\n createdAt: string;\n}\n\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cadenya/widgets",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "The official TypeScript SDK for the CadenyaWidgets API",
   "license": "Apache-2.0",
   "type": "module",
@@ -13,12 +13,21 @@
     }
   },
   "sideEffects": false,
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "https://github.com/cadenya/widgets-sdk" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cadenya/widgets-sdk"
+  },
   "engines": {
     "node": ">=18"
   },
-  "files": ["dist", "src", "api.md"],
+  "files": [
+    "dist",
+    "src",
+    "api.md"
+  ],
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit"

package/src/client.ts CHANGED Viewed

@@ -19,7 +19,7 @@ export interface ClientOptions {
    * Defaults to 60000; a non-finite or <= 0 value disables the deadline.
    */
   timeout?: number;
-  /** Headers sent with every request. */
+  /** Additional request headers. Browsers supply their own User-Agent by default. */
   defaultHeaders?: Record<string, string>;
   /** Custom fetch implementation. */
   fetch?: typeof fetch;
@@ -49,7 +49,7 @@ export class CadenyaWidgets {
       authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
       maxRetries: options.maxRetries ?? 0,
       timeout: options.timeout,
-      defaultHeaders: { 'User-Agent': 'cadenyawidgets-typescript/1.1.0 (api 1.0)', ...options.defaultHeaders },
+      defaultHeaders: { ...nodeUserAgent('cadenyawidgets-typescript/1.1.1 (api 1.0)'), ...options.defaultHeaders },
       fetch: options.fetch,
       logger: options.logger,
       logLevel: options.logLevel,
@@ -60,6 +60,14 @@ export class CadenyaWidgets {
   }
 }
+// Browser-authored User-Agent headers require CORS permission. Only Node-compatible
+// runtimes receive the SDK default; browsers and workers use their native header.
+function nodeUserAgent(value: string): Record<string, string> {
+  const nodeVersion = (globalThis as { process?: { versions?: { node?: string } } })
+    .process?.versions?.node;
+  return nodeVersion ? { 'User-Agent': value } : {};
+}
 function readEnv(name: string): string | undefined {
   const env = (globalThis as { process?: { env?: Record<string, string | undefined> } })
     .process?.env;

package/src/core/http.ts CHANGED Viewed

@@ -38,7 +38,12 @@ export interface RequestOptions {
 }
 export type QueryPrimitive = string | number | boolean;
-export type QueryValue = QueryPrimitive | QueryPrimitive[] | undefined | null;
+/**
+ * Query objects are flattened to dot-delimited paths. `object` is used here
+ * deliberately so generated named interfaces (which do not declare an index
+ * signature) remain assignable as query parameter values.
+ */
+export type QueryValue = QueryPrimitive | readonly QueryPrimitive[] | object | undefined | null;
 export interface RequestSpec {
   method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -589,17 +594,51 @@ export class HttpClient {
   private buildURL(path: string, query?: Record<string, QueryValue>): string {
     const url = new URL(this.baseURL + path);
+    const ancestors = new Set<object>();
     for (const [key, value] of Object.entries(query ?? {})) {
-      if (value === undefined || value === null) continue;
-      // Arrays serialize as repeated params: ?state=a&state=b
-      for (const item of Array.isArray(value) ? value : [value]) {
-        url.searchParams.append(key, String(item));
-      }
+      appendQueryValue(url.searchParams, key, value, ancestors);
     }
     return url.toString();
   }
 }
+/**
+ * Flatten nested query objects to dot-delimited paths. Arrays retain the
+ * existing repeated-parameter behavior at whichever path they occur:
+ * `{ filters: { state: ['a', 'b'] } }` becomes
+ * `?filters.state=a&filters.state=b`.
+ */
+function appendQueryValue(
+  searchParams: URLSearchParams,
+  key: string,
+  value: unknown,
+  ancestors: Set<object>,
+): void {
+  if (value === undefined || value === null) return;
+  if (typeof value !== 'object') {
+    searchParams.append(key, String(value));
+    return;
+  }
+  if (ancestors.has(value)) {
+    throw new APIRequestError('query parameters contain a circular reference', undefined);
+  }
+  ancestors.add(value);
+  try {
+    if (Array.isArray(value)) {
+      for (const item of value) appendQueryValue(searchParams, key, item, ancestors);
+      return;
+    }
+    for (const [childKey, childValue] of Object.entries(value)) {
+      appendQueryValue(searchParams, `${key}.${childKey}`, childValue, ancestors);
+    }
+  } finally {
+    ancestors.delete(value);
+  }
+}
 /** Retry counts must be bounded non-negative integers; anything else (NaN,
  * Infinity, negatives, fractions) is treated as the nearest sane value. */
 function normalizeRetries(value: number): number {

package/src/types.ts CHANGED Viewed

@@ -246,7 +246,9 @@ export type WidgetEvent =
   | WidgetEvent_Error
   | WidgetEvent_Cancelled
   | WidgetEvent_TimedOut
-  | WidgetEvent_Finalized;
+  | WidgetEvent_Finalized
+  | WidgetEvent_Heartbeat
+  | WidgetEvent_StateChanged;
 /**
  * WidgetFinalizedEvent: the conversation's agent produced its structured
@@ -263,6 +265,27 @@ export interface WidgetFinalizedEvent {
   output?: Record<string, unknown>;
 }
+/**
+ * WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,
+ *  absent from history, and never a reconnect checkpoint or state transition.
+ */
+export interface WidgetHeartbeatEvent {
+}
+export type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+export type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+/**
+ * WidgetObjectiveStateChangedEvent mirrors a durable objective transition.
+ *  Internal status messages are intentionally omitted. Pending/running maps
+ *  to a responding conversation, waiting to open, and terminal states to closed.
+ */
+export interface WidgetObjectiveStateChangedEvent {
+  fromState: WidgetObjectiveStateChangedEventFromState;
+  toState: WidgetObjectiveStateChangedEventToState;
+}
 /**
  * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.
  */
@@ -370,8 +393,9 @@ export interface WidgetEvent_UserMessage {
   type: 'userMessage';
   userMessage: WidgetUserMessageEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -385,8 +409,9 @@ export interface WidgetEvent_AssistantMessage {
   type: 'assistantMessage';
   assistantMessage: WidgetAssistantMessageEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -400,8 +425,9 @@ export interface WidgetEvent_ToolApprovalRequested {
   type: 'toolApprovalRequested';
   toolApprovalRequested: WidgetToolApprovalRequestedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -415,8 +441,9 @@ export interface WidgetEvent_ToolApproved {
   type: 'toolApproved';
   toolApproved: WidgetToolApprovedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -430,8 +457,9 @@ export interface WidgetEvent_ToolDenied {
   type: 'toolDenied';
   toolDenied: WidgetToolDeniedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -445,8 +473,9 @@ export interface WidgetEvent_ToolCalled {
   type: 'toolCalled';
   toolCalled: WidgetToolCalledEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -460,8 +489,9 @@ export interface WidgetEvent_ToolResult {
   type: 'toolResult';
   toolResult: WidgetToolResultEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -475,8 +505,9 @@ export interface WidgetEvent_ToolError {
   type: 'toolError';
   toolError: WidgetToolErrorEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -490,8 +521,9 @@ export interface WidgetEvent_Error {
   type: 'error';
   error: WidgetErrorEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -505,8 +537,9 @@ export interface WidgetEvent_Cancelled {
   type: 'cancelled';
   cancelled: WidgetCancelledEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -520,8 +553,9 @@ export interface WidgetEvent_TimedOut {
   type: 'timedOut';
   timedOut: WidgetTimedOutEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -535,8 +569,41 @@ export interface WidgetEvent_Finalized {
   type: 'finalized';
   finalized: WidgetFinalizedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
+   */
+  id: string;
+  /**
+   * The conversation this event belongs to.
+   */
+  conversationId: string;
+  createdAt: string;
+}
+export interface WidgetEvent_Heartbeat {
+  type: 'heartbeat';
+  heartbeat: WidgetHeartbeatEvent;
+  /**
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
+   */
+  id: string;
+  /**
+   * The conversation this event belongs to.
+   */
+  conversationId: string;
+  createdAt: string;
+}
+export interface WidgetEvent_StateChanged {
+  type: 'stateChanged';
+  stateChanged: WidgetObjectiveStateChangedEvent;
+  /**
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**