assistant-cloud 0.2.1 → 0.2.3

package/README.md

@@ -9,7 +9,7 @@ Server- and client-side SDK for [Assistant Cloud](https://cloud.assistant-ui.com
 ## Installation
 
 ```bash
-npm install @assistant-ui/react @assistant-ui/ai-sdk assistant-cloud
+npm install @assistant-ui/react @assistant-ui/ai-sdk ai assistant-cloud
 ```
 
 ## Usage
@@ -37,7 +37,7 @@ The pieces every client integration needs live in the package, so a runtime bind
 
 Every API request carries `Aui-Sdk` with the client's own version and the identities integrations pass to `registerSdk` (the anonymous token bootstrap requests do not), so the cloud can tell which packages talk to a project.
 
-- `CloudRunReporter` sends run reports: nothing while telemetry is off, the cloud's environment, release and tags on every report, the `beforeReport` hook applied last, and a failed send that never surfaces. A report given a key is sent once per key, so the key has to name one run; without a key every call reports.
+- `CloudRunReporter` sends run reports: nothing while telemetry is off, the cloud's environment, release and tags on every report, the `beforeReport` hook applied last, and a failed send that never surfaces. Keyed reports are deduplicated while in flight and after an attempt, while rate limiting releases the key for a later attempt; without a key every call reports.
 - `CloudEngagementReporter` derives engagement events (`message_sent`, `run_stopped`, `error_shown`, `suggestions_shown` and the rest) from what a chat integration observes and keeps the per thread state they need, such as a run's start for the stop duration. An id resolver turns the integration's own thread and message ids into the ids the cloud stores.
 - `assistant-cloud/ai-sdk` holds the AI SDK specifics: `aiSDKV6FormatAdapter`, the stored form of a `UIMessage`, and `extractAISDKRunTelemetry`, which reads the run report fields out of one run's assistant messages. The entry types its messages with `ai` and needs no runtime from it.
 
@@ -59,12 +59,14 @@ if (run) {
 
 ## Server telemetry
 
-Send AI SDK 7 GenAI spans to Assistant Cloud from a Next.js `instrumentation.ts` file. The `assistant-cloud/telemetry` entry needs the OpenTelemetry packages installed next to it:
+Send AI SDK 7 GenAI spans to Assistant Cloud from a Next.js app. The AI SDK emits spans through `@ai-sdk/otel`, and the `assistant-cloud/telemetry` entry needs the OpenTelemetry packages installed next to it:
 
 ```sh
-npm i @vercel/otel @opentelemetry/api @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http
+npm i @vercel/otel @ai-sdk/otel @opentelemetry/api @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http
 ```
 
+Register the span processor in `instrumentation.ts` so it starts once per server process:
+
 ```ts
 import { registerOTel } from "@vercel/otel";
 import {
@@ -87,16 +89,30 @@ export function register() {
 }
 ```
 
-Pass the active server trace ID to the browser with `messageMetadata` in the route that calls `streamText`:
+In the route that calls `streamText`, enable the OpenTelemetry integration and pass the active trace ID to the browser with `messageMetadata`:
 
 ```ts
+import { OpenTelemetry } from "@ai-sdk/otel";
+import { openai } from "@ai-sdk/openai";
+import { convertToModelMessages, streamText } from "ai";
 import { withAssistantCloudTraceMetadata } from "assistant-cloud/telemetry";
 
-return result.toUIMessageStreamResponse({
-  messageMetadata: withAssistantCloudTraceMetadata(),
-});
+export async function POST(request: Request) {
+  const { messages } = await request.json();
+  const result = streamText({
+    model: openai("gpt-6-luna"),
+    messages: await convertToModelMessages(messages),
+    telemetry: { integrations: [new OpenTelemetry()] },
+  });
+
+  return result.toUIMessageStreamResponse({
+    messageMetadata: withAssistantCloudTraceMetadata(),
+  });
+}
 ```
 
+[Traces](https://www.assistant-ui.com/docs/cloud/traces) covers the exporter options, the span filter, and how Assistant Cloud merges a trace with the browser's run report.
+
 ## Authentication
 
 | Mode             | Required fields                                         | Use case                              |

package/dist/AssistantCloud.d.ts

@@ -1,26 +1,23 @@
-import { AssistantCloudRuns } from "./AssistantCloudRuns.js";
-import { AssistantCloudConfig, AssistantCloudTelemetryConfig, SdkIdentity } from "./AssistantCloudAPI.js";
+import { type AssistantCloudConfig, type SdkIdentity, type AssistantCloudTelemetryConfig } from "./AssistantCloudAPI.js";
 import { AssistantCloudAuthTokens } from "./AssistantCloudAuthTokens.js";
-import { AssistantCloudThreads } from "./AssistantCloudThreads.js";
 import { AssistantCloudProjects } from "./AssistantCloudProjects.js";
+import { AssistantCloudRuns } from "./AssistantCloudRuns.js";
+import { AssistantCloudThreads } from "./AssistantCloudThreads.js";
 import { AssistantCloudFiles } from "./AssistantCloudFiles.js";
 import { AssistantCloudEvents } from "./AssistantCloudEvents.js";
 import { AssistantCloudScores } from "./AssistantCloudScores.js";
-//#region src/AssistantCloud.d.ts
-declare class AssistantCloud {
-  readonly threads: AssistantCloudThreads;
-  readonly projects: AssistantCloudProjects;
-  readonly auth: {
-    tokens: AssistantCloudAuthTokens;
-  };
-  readonly runs: AssistantCloudRuns;
-  readonly files: AssistantCloudFiles;
-  readonly events: AssistantCloudEvents;
-  readonly scores: AssistantCloudScores;
-  readonly telemetry: AssistantCloudTelemetryConfig;
-  readonly registerSdk: (sdk: SdkIdentity) => void;
-  constructor(config: AssistantCloudConfig);
+export declare class AssistantCloud {
+    readonly threads: AssistantCloudThreads;
+    readonly projects: AssistantCloudProjects;
+    readonly auth: {
+        tokens: AssistantCloudAuthTokens;
+    };
+    readonly runs: AssistantCloudRuns;
+    readonly files: AssistantCloudFiles;
+    readonly events: AssistantCloudEvents;
+    readonly scores: AssistantCloudScores;
+    readonly telemetry: AssistantCloudTelemetryConfig;
+    readonly registerSdk: (sdk: SdkIdentity) => void;
+    constructor(config: AssistantCloudConfig);
 }
-//#endregion
-export { AssistantCloud };
 //# sourceMappingURL=AssistantCloud.d.ts.map

package/dist/AssistantCloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloud.d.ts","names":[],"sources":["../src/AssistantCloud.ts"],"mappings":";;;;;;;;;cAca;WACK,SAAO;WACP,UAAQ;WACR;;;WACA,MAAI;WACJ,OAAK;WACL,QAAM;WACN,QAAM;WACN,WAAW;WACX,cAAc,KAAK;EAEvB,YAAA,QAAQ"}
+{"version":3,"file":"AssistantCloud.d.ts","sourceRoot":"","sources":["../src/AssistantCloud.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,6BAA6B,EACnC,+BAA4B;AAC7B,OAAO,EAAE,wBAAwB,EAAE,sCAAmC;AACtE,OAAO,EAAE,sBAAsB,EAAE,oCAAiC;AAClE,OAAO,EAAE,kBAAkB,EAAE,gCAA6B;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mCAAgC;AAChE,OAAO,EAAE,mBAAmB,EAAE,iCAA8B;AAC5D,OAAO,EACL,oBAAoB,EAErB,kCAA+B;AAChC,OAAO,EAAE,oBAAoB,EAAE,kCAA+B;AAE9D,qBAAa,cAAc;IACzB,SAAgB,OAAO,wBAAC;IACxB,SAAgB,QAAQ,yBAAC;IACzB,SAAgB,IAAI;;MAAC;IACrB,SAAgB,IAAI,qBAAC;IACrB,SAAgB,KAAK,sBAAC;IACtB,SAAgB,MAAM,uBAAC;IACvB,SAAgB,MAAM,uBAAC;IACvB,SAAgB,SAAS,EAAE,6BAA6B,CAAC;IACzD,SAAgB,WAAW,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;gBAE5C,MAAM,EAAE,oBAAoB;CAuCzC"}

package/dist/AssistantCloud.js

@@ -4,7 +4,7 @@ import { AssistantCloudThreads } from "./AssistantCloudThreads.js";
 import { AssistantCloudProjects } from "./AssistantCloudProjects.js";
 import { AssistantCloudRuns } from "./AssistantCloudRuns.js";
 import { AssistantCloudFiles } from "./AssistantCloudFiles.js";
-import { AssistantCloudEvents } from "./AssistantCloudEvents.js";
+import { AssistantCloudEvents, clearPendingAssistantCloudEvents } from "./AssistantCloudEvents.js";
 import { AssistantCloudScores } from "./AssistantCloudScores.js";
 //#region src/AssistantCloud.ts
 var AssistantCloud = class {
@@ -21,10 +21,15 @@ var AssistantCloud = class {
 		const api = new AssistantCloudAPI(config);
 		this.registerSdk = api.registerSdk;
 		const t = config.telemetry;
-		this.telemetry = t === false ? { enabled: false } : t === true || t === void 0 ? { enabled: true } : {
+		const telemetry = t === false ? { enabled: false } : t === true || t === void 0 ? { enabled: true } : {
 			...t,
 			enabled: t.enabled !== false
 		};
+		this.telemetry = new Proxy(telemetry, { set: (target, property, value) => {
+			const updated = Reflect.set(target, property, value);
+			if ((property === "enabled" || property === "events") && (target.enabled === false || target.events === false)) clearPendingAssistantCloudEvents(this.events);
+			return updated;
+		} });
 		this.threads = new AssistantCloudThreads(api);
 		this.projects = new AssistantCloudProjects(api);
 		this.auth = { tokens: new AssistantCloudAuthTokens(api) };

package/dist/AssistantCloud.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloud.js","names":[],"sources":["../src/AssistantCloud.ts"],"sourcesContent":["import {\n  AssistantCloudAPI,\n  type AssistantCloudConfig,\n  type SdkIdentity,\n  type AssistantCloudTelemetryConfig,\n} from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudProjects } from \"./AssistantCloudProjects\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\nimport { AssistantCloudFiles } from \"./AssistantCloudFiles\";\nimport { AssistantCloudEvents } from \"./AssistantCloudEvents\";\nimport { AssistantCloudScores } from \"./AssistantCloudScores\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly projects;\n  public readonly auth;\n  public readonly runs;\n  public readonly files;\n  public readonly events;\n  public readonly scores;\n  public readonly telemetry: AssistantCloudTelemetryConfig;\n  public readonly registerSdk: (sdk: SdkIdentity) => void;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.registerSdk = api.registerSdk;\n    const t = config.telemetry;\n    this.telemetry =\n      t === false\n        ? { enabled: false }\n        : t === true || t === undefined\n          ? { enabled: true }\n          : {\n              ...t,\n              enabled: t.enabled !== false,\n            };\n\n    this.threads = new AssistantCloudThreads(api);\n    this.projects = new AssistantCloudProjects(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n    this.files = new AssistantCloudFiles(api);\n    this.events = new AssistantCloudEvents(\n      api,\n      () => this.telemetry.enabled !== false && this.telemetry.events !== false,\n    );\n    this.scores = new AssistantCloudScores(api);\n  }\n}\n"],"mappings":";;;;;;;;;AAcA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAA8B;EACxC,MAAM,MAAM,IAAI,kBAAkB,MAAM;EACxC,KAAK,cAAc,IAAI;EACvB,MAAM,IAAI,OAAO;EACjB,KAAK,YACH,MAAM,QACF,EAAE,SAAS,MAAM,IACjB,MAAM,QAAQ,MAAM,KAAA,IAClB,EAAE,SAAS,KAAK,IAChB;GACE,GAAG;GACH,SAAS,EAAE,YAAY;EACzB;EAER,KAAK,UAAU,IAAI,sBAAsB,GAAG;EAC5C,KAAK,WAAW,IAAI,uBAAuB,GAAG;EAC9C,KAAK,OAAO,EACV,QAAQ,IAAI,yBAAyB,GAAG,EAC1C;EACA,KAAK,OAAO,IAAI,mBAAmB,GAAG;EACtC,KAAK,QAAQ,IAAI,oBAAoB,GAAG;EACxC,KAAK,SAAS,IAAI,qBAChB,WACM,KAAK,UAAU,YAAY,SAAS,KAAK,UAAU,WAAW,KACtE;EACA,KAAK,SAAS,IAAI,qBAAqB,GAAG;CAC5C;AACF"}
+{"version":3,"file":"AssistantCloud.js","names":[],"sources":["../src/AssistantCloud.ts"],"sourcesContent":["import {\n  AssistantCloudAPI,\n  type AssistantCloudConfig,\n  type SdkIdentity,\n  type AssistantCloudTelemetryConfig,\n} from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudProjects } from \"./AssistantCloudProjects\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\nimport { AssistantCloudFiles } from \"./AssistantCloudFiles\";\nimport {\n  AssistantCloudEvents,\n  clearPendingAssistantCloudEvents,\n} from \"./AssistantCloudEvents\";\nimport { AssistantCloudScores } from \"./AssistantCloudScores\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly projects;\n  public readonly auth;\n  public readonly runs;\n  public readonly files;\n  public readonly events;\n  public readonly scores;\n  public readonly telemetry: AssistantCloudTelemetryConfig;\n  public readonly registerSdk: (sdk: SdkIdentity) => void;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.registerSdk = api.registerSdk;\n    const t = config.telemetry;\n    const telemetry =\n      t === false\n        ? { enabled: false }\n        : t === true || t === undefined\n          ? { enabled: true }\n          : {\n              ...t,\n              enabled: t.enabled !== false,\n            };\n    this.telemetry = new Proxy(telemetry, {\n      set: (target, property, value) => {\n        const updated = Reflect.set(target, property, value);\n        if (\n          (property === \"enabled\" || property === \"events\") &&\n          (target.enabled === false || target.events === false)\n        ) {\n          clearPendingAssistantCloudEvents(this.events);\n        }\n        return updated;\n      },\n    });\n\n    this.threads = new AssistantCloudThreads(api);\n    this.projects = new AssistantCloudProjects(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n    this.files = new AssistantCloudFiles(api);\n    this.events = new AssistantCloudEvents(\n      api,\n      () => this.telemetry.enabled !== false && this.telemetry.events !== false,\n    );\n    this.scores = new AssistantCloudScores(api);\n  }\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAA8B;EACxC,MAAM,MAAM,IAAI,kBAAkB,MAAM;EACxC,KAAK,cAAc,IAAI;EACvB,MAAM,IAAI,OAAO;EACjB,MAAM,YACJ,MAAM,QACF,EAAE,SAAS,MAAM,IACjB,MAAM,QAAQ,MAAM,KAAA,IAClB,EAAE,SAAS,KAAK,IAChB;GACE,GAAG;GACH,SAAS,EAAE,YAAY;EACzB;EACR,KAAK,YAAY,IAAI,MAAM,WAAW,EACpC,MAAM,QAAQ,UAAU,UAAU;GAChC,MAAM,UAAU,QAAQ,IAAI,QAAQ,UAAU,KAAK;GACnD,KACG,aAAa,aAAa,aAAa,cACvC,OAAO,YAAY,SAAS,OAAO,WAAW,QAE/C,iCAAiC,KAAK,MAAM;GAE9C,OAAO;EACT,EACF,CAAC;EAED,KAAK,UAAU,IAAI,sBAAsB,GAAG;EAC5C,KAAK,WAAW,IAAI,uBAAuB,GAAG;EAC9C,KAAK,OAAO,EACV,QAAQ,IAAI,yBAAyB,GAAG,EAC1C;EACA,KAAK,OAAO,IAAI,mBAAmB,GAAG;EACtC,KAAK,QAAQ,IAAI,oBAAoB,GAAG;EACxC,KAAK,SAAS,IAAI,qBAChB,WACM,KAAK,UAAU,YAAY,SAAS,KAAK,UAAU,WAAW,KACtE;EACA,KAAK,SAAS,IAAI,qBAAqB,GAAG;CAC5C;AACF"}

package/dist/AssistantCloudAPI.d.ts

@@ -1,83 +1,85 @@
-import { AssistantCloudAuthStrategy } from "./AssistantCloudAuthStrategy.js";
-import { AssistantCloudRunReport } from "./AssistantCloudRuns.js";
-//#region src/AssistantCloudAPI.d.ts
-type SdkIdentity = {
-  name: string;
-  version: string;
+import { type AssistantCloudAuthStrategy } from "./AssistantCloudAuthStrategy.js";
+import type { AssistantCloudRunReport } from "./AssistantCloudRuns.js";
+export type SdkIdentity = {
+    name: string;
+    version: string;
 };
-type AssistantCloudTelemetryConfig = {
-  /**
-   * Enables Assistant Cloud telemetry. Defaults to `true`. Set to `false` to
-   * disable both run reports and engagement events.
-   */
-  enabled?: boolean;
-  /**
-   * Enables Assistant Cloud engagement events. Defaults to `true` when
-   * telemetry is enabled. Set to `false` to keep run reports while disabling
-   * engagement events.
-   */
-  events?: boolean;
-  release?: string;
-  environment?: string;
-  tags?: string[];
-  /**
-   * Called before each telemetry report is sent.
-   * Return a modified report to enrich it (e.g. add `model_id`),
-   * or return `null` to skip the report.
-   */
-  beforeReport?: (report: AssistantCloudRunReport) => AssistantCloudRunReport | null;
+export type AssistantCloudTelemetryConfig = {
+    /**
+     * Enables Assistant Cloud telemetry. Defaults to `true`. Set to `false` to
+     * disable both run reports and engagement events.
+     */
+    enabled?: boolean;
+    /**
+     * Enables Assistant Cloud engagement events. Defaults to `true` when
+     * telemetry is enabled. Set to `false` to keep run reports while disabling
+     * engagement events.
+     */
+    events?: boolean;
+    /**
+     * Stores the messages of runtimes whose backend keeps the transcript (LangGraph, LangChain, Google ADK, custom external stores), so the dashboard can show them. Defaults to `true` when telemetry is enabled. Set to `false` to keep run reports and events without storing those messages.
+     */
+    messages?: boolean;
+    release?: string;
+    environment?: string;
+    tags?: string[];
+    /**
+     * Called before each telemetry report is sent.
+     * Return a modified report to enrich it (e.g. add `model_id`),
+     * or return `null` to skip the report.
+     */
+    beforeReport?: (report: AssistantCloudRunReport) => AssistantCloudRunReport | null;
 };
-type AssistantCloudConfig = ({
-  baseUrl: string;
-  authToken: () => Promise<string | null>;
+export type AssistantCloudConfig = ({
+    baseUrl: string;
+    authToken: () => Promise<string | null>;
 } | {
-  baseUrl?: string;
-  apiKey: string;
-  userId: string;
-  workspaceId: string;
+    baseUrl?: string;
+    apiKey: string;
+    userId: string;
+    workspaceId: string;
 } | {
-  baseUrl: string;
-  anonymous: true;
+    baseUrl: string;
+    anonymous: true;
 }) & {
-  /**
-   * Client-side run telemetry reporting. Default: `true`.
-   *
-   * When enabled, the SDK automatically reports run metadata (status, step
-   * count, tool calls, and token usage) to Assistant Cloud after each
-   * assistant message is saved. Reports can also include assistant output,
-   * tool arguments and results, errors, and metadata, which may contain
-   * sensitive content. Use `beforeReport` to redact or drop reports, or
-   * `telemetry: false` to disable reporting.
-   *
-   * - `true` / `undefined` — enabled with defaults
-   * - `false` — disabled
-   * - `{ beforeReport }` — enabled with a hook to enrich or filter reports
-   */
-  telemetry?: boolean | AssistantCloudTelemetryConfig;
+    /**
+     * Client-side run telemetry reporting. Default: `true`.
+     *
+     * When enabled, the SDK automatically reports run metadata (status, step
+     * count, tool calls, and token usage) to Assistant Cloud after each
+     * assistant message is saved. Reports can also include assistant output,
+     * tool arguments and results, errors, and metadata, which may contain
+     * sensitive content. Use `beforeReport` to redact or drop reports, or
+     * `telemetry: false` to disable reporting.
+     *
+     * - `true` / `undefined` — enabled with defaults
+     * - `false` — disabled
+     * - `{ beforeReport }` — enabled with a hook to enrich or filter reports
+     */
+    telemetry?: boolean | AssistantCloudTelemetryConfig;
 };
-declare class CloudAPIError extends Error {
-  readonly status: number;
-  readonly code?: string;
-  readonly details?: Record<string, unknown>;
-  constructor(message: string, status: number, code?: string, details?: Record<string, unknown>);
+export declare class CloudAPIError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, status: number, code?: string, details?: Record<string, unknown>);
 }
 type MakeRequestOptions = {
-  method?: "POST" | "PUT" | "DELETE" | undefined;
-  headers?: Record<string, string> | undefined;
-  query?: Record<string, string | number | boolean> | undefined;
-  body?: object | undefined;
-  keepalive?: boolean | undefined;
+    method?: "POST" | "PUT" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    query?: Record<string, string | number | boolean> | undefined;
+    body?: object | undefined;
+    keepalive?: boolean | undefined;
 };
-declare class AssistantCloudAPI {
-  _auth: AssistantCloudAuthStrategy;
-  _baseUrl: string;
-  readonly registerSdk: (sdk: SdkIdentity) => void;
-  readonly sdkHeader: () => string;
-  constructor(config: AssistantCloudConfig);
-  initializeAuth(): Promise<boolean>;
-  makeRawRequest(endpoint: string, options?: MakeRequestOptions): Promise<Response>;
-  makeRequest(endpoint: string, options?: MakeRequestOptions): Promise<any>;
+export declare class AssistantCloudAPI {
+    _auth: AssistantCloudAuthStrategy;
+    _baseUrl: string;
+    readonly registerSdk: (sdk: SdkIdentity) => void;
+    readonly sdkHeader: () => string;
+    constructor(config: AssistantCloudConfig);
+    initializeAuth(): Promise<boolean>;
+    makeRawRequest(endpoint: string, options?: MakeRequestOptions): Promise<Response>;
+    makeRequest(endpoint: string, options?: MakeRequestOptions): Promise<any>;
 }
-//#endregion
-export { AssistantCloudAPI, AssistantCloudConfig, AssistantCloudTelemetryConfig, CloudAPIError, SdkIdentity };
+export {};
 //# sourceMappingURL=AssistantCloudAPI.d.ts.map

package/dist/AssistantCloudAPI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAPI.d.ts","names":[],"sources":["../src/AssistantCloudAPI.ts"],"mappings":";;;KAUY;EACV;EACA;;KAGU;;;;;EAKV;;;;;;EAMA;EACA;EACA;EACA;;;;;;EAMA,gBACE,QAAQ,4BACL;;KAGK;EAEN;EACA,iBAAiB;;EAGjB;EACA;EACA;EACA;;EAGA;EACA;;;;;;;;;;;;;;;;EAiBJ,sBAAsB;;cAGX,sBAAsB;WACjB;WACA;WACA,UAAU;EAGxB,YAAA,iBACA,gBACA,eACA,UAAU;;KAUT;EACH;EACA,UAAU;EACV,QAAQ;EACR;EACA;;cAKW;EACJ,OAAO;EACP;WACS,cAAc,KAAK;WACnB;EAEJ,YAAA,QAAQ;EAuCP,kBAAc;EAId,eACX,kBACA,UAAS,qBAAuB,QAAA;EAkErB,YAAY,kBAAkB,UAAS,qBAAuB"}
+{"version":3,"file":"AssistantCloudAPI.d.ts","sourceRoot":"","sources":["../src/AssistantCloudAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAKhC,wCAAqC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,gCAA6B;AAGpE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,uBAAuB,KAC5B,uBAAuB,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAC/B;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC,GACD;IACE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB,CACJ,GAAG;IACF;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,6BAA6B,CAAC;CACrD,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQpC;AAED,KAAK,kBAAkB,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAIF,qBAAa,iBAAiB;IACrB,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,SAAC;IAChB,SAAgB,WAAW,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACxD,SAAgB,SAAS,EAAE,MAAM,MAAM,CAAC;gBAE5B,MAAM,EAAE,oBAAoB;IAuC3B,cAAc;IAId,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB;IAkErB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAa5E"}

package/dist/AssistantCloudAPI.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAPI.js","names":[],"sources":["../src/AssistantCloudAPI.ts"],"sourcesContent":["import {\n  type AssistantCloudAuthStrategy,\n  AssistantCloudJWTAuthStrategy,\n  AssistantCloudAPIKeyAuthStrategy,\n  AssistantCloudAnonymousAuthStrategy,\n  normalizeBaseUrl,\n} from \"./AssistantCloudAuthStrategy\";\nimport type { AssistantCloudRunReport } from \"./AssistantCloudRuns\";\nimport { ASSISTANT_CLOUD_VERSION } from \"./version\";\n\nexport type SdkIdentity = {\n  name: string;\n  version: string;\n};\n\nexport type AssistantCloudTelemetryConfig = {\n  /**\n   * Enables Assistant Cloud telemetry. Defaults to `true`. Set to `false` to\n   * disable both run reports and engagement events.\n   */\n  enabled?: boolean;\n  /**\n   * Enables Assistant Cloud engagement events. Defaults to `true` when\n   * telemetry is enabled. Set to `false` to keep run reports while disabling\n   * engagement events.\n   */\n  events?: boolean;\n  release?: string;\n  environment?: string;\n  tags?: string[];\n  /**\n   * Called before each telemetry report is sent.\n   * Return a modified report to enrich it (e.g. add `model_id`),\n   * or return `null` to skip the report.\n   */\n  beforeReport?: (\n    report: AssistantCloudRunReport,\n  ) => AssistantCloudRunReport | null;\n};\n\nexport type AssistantCloudConfig = (\n  | {\n      baseUrl: string;\n      authToken: () => Promise<string | null>;\n    }\n  | {\n      baseUrl?: string;\n      apiKey: string;\n      userId: string;\n      workspaceId: string;\n    }\n  | {\n      baseUrl: string;\n      anonymous: true;\n    }\n) & {\n  /**\n   * Client-side run telemetry reporting. Default: `true`.\n   *\n   * When enabled, the SDK automatically reports run metadata (status, step\n   * count, tool calls, and token usage) to Assistant Cloud after each\n   * assistant message is saved. Reports can also include assistant output,\n   * tool arguments and results, errors, and metadata, which may contain\n   * sensitive content. Use `beforeReport` to redact or drop reports, or\n   * `telemetry: false` to disable reporting.\n   *\n   * - `true` / `undefined` — enabled with defaults\n   * - `false` — disabled\n   * - `{ beforeReport }` — enabled with a hook to enrich or filter reports\n   */\n  telemetry?: boolean | AssistantCloudTelemetryConfig;\n};\n\nexport class CloudAPIError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: Record<string, unknown>,\n  ) {\n    super(message);\n    this.status = status;\n    if (code !== undefined) this.code = code;\n    if (details !== undefined) this.details = details;\n    this.name = \"CloudAPIError\";\n  }\n}\n\ntype MakeRequestOptions = {\n  method?: \"POST\" | \"PUT\" | \"DELETE\" | undefined;\n  headers?: Record<string, string> | undefined;\n  query?: Record<string, string | number | boolean> | undefined;\n  body?: object | undefined;\n  keepalive?: boolean | undefined;\n};\n\nconst HEADER_TOKEN = /^[\\x21-\\x7e]+$/;\n\nexport class AssistantCloudAPI {\n  public _auth: AssistantCloudAuthStrategy;\n  public _baseUrl;\n  public readonly registerSdk: (sdk: SdkIdentity) => void;\n  public readonly sdkHeader: () => string;\n\n  constructor(config: AssistantCloudConfig) {\n    const sdks = new Map<string, SdkIdentity>();\n    this.registerSdk = (sdk) => {\n      const name = sdk.name.trim();\n      const version = sdk.version.trim();\n      if (!HEADER_TOKEN.test(name) || !HEADER_TOKEN.test(version)) return;\n      sdks.set(`${name}/${version}`, { name, version });\n    };\n    this.sdkHeader = () =>\n      [\n        `assistant-cloud/${ASSISTANT_CLOUD_VERSION}`,\n        ...Array.from(\n          sdks.values(),\n          ({ name, version }) => `${name}/${version}`,\n        ),\n      ].join(\" \");\n\n    if (\"authToken\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudJWTAuthStrategy(config.authToken);\n    } else if (\"apiKey\" in config) {\n      this._baseUrl = normalizeBaseUrl(\n        config.baseUrl ?? \"https://backend.assistant-api.com\",\n      );\n      this._auth = new AssistantCloudAPIKeyAuthStrategy(\n        config.apiKey,\n        config.userId,\n        config.workspaceId,\n      );\n    } else if (\"anonymous\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudAnonymousAuthStrategy(this._baseUrl);\n    } else {\n      throw new Error(\n        \"Invalid configuration: Must provide authToken, apiKey, or anonymous configuration\",\n      );\n    }\n  }\n\n  public async initializeAuth() {\n    return !!(await this._auth.getAuthHeaders());\n  }\n\n  public async makeRawRequest(\n    endpoint: string,\n    options: MakeRequestOptions = {},\n  ) {\n    const authHeaders = await this._auth.getAuthHeaders();\n    if (!authHeaders) throw new Error(\"Authorization failed\");\n\n    const headers = {\n      ...authHeaders,\n      ...options.headers,\n      \"Content-Type\": \"application/json\",\n      \"Aui-Sdk\": this.sdkHeader(),\n    };\n\n    const queryParams = new URLSearchParams();\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value === false) continue;\n        if (value === true) {\n          queryParams.set(key, \"true\");\n        } else {\n          queryParams.set(key, value.toString());\n        }\n      }\n    }\n\n    const url = new URL(`${this._baseUrl}/v1${endpoint}`);\n    url.search = queryParams.toString();\n\n    const response = await fetch(url, {\n      method: options.method ?? \"GET\",\n      headers,\n      body: options.body ? JSON.stringify(options.body) : null,\n      ...(options.keepalive ? { keepalive: true } : {}),\n    });\n\n    this._auth.readAuthHeaders(response.headers);\n\n    if (!response.ok) {\n      const text = await response.text();\n      let message: string | undefined;\n      let code: string | undefined;\n      let details: Record<string, unknown> | undefined;\n      try {\n        const body = JSON.parse(text) as unknown;\n        if (typeof body === \"object\" && body !== null && !Array.isArray(body)) {\n          const record = body as Record<string, unknown>;\n          if (typeof record.message === \"string\" && record.message.length > 0) {\n            message = record.message;\n          }\n          if (typeof record.error === \"string\") {\n            code = record.error;\n            details = { ...record };\n            delete details.error;\n          }\n        }\n      } catch {}\n      throw new CloudAPIError(\n        message ?? `Request failed with status ${response.status}, ${text}`,\n        response.status,\n        code,\n        details,\n      );\n    }\n\n    return response;\n  }\n\n  public async makeRequest(endpoint: string, options: MakeRequestOptions = {}) {\n    const response = await this.makeRawRequest(endpoint, options);\n    if (\n      response.status === 204 ||\n      response.headers.get(\"content-length\") === \"0\"\n    )\n      return undefined;\n\n    const text = await response.text();\n    if (text.trim() === \"\") return undefined;\n\n    return JSON.parse(text);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"AssistantCloudAPI.js","names":[],"sources":["../src/AssistantCloudAPI.ts"],"sourcesContent":["import {\n  type AssistantCloudAuthStrategy,\n  AssistantCloudJWTAuthStrategy,\n  AssistantCloudAPIKeyAuthStrategy,\n  AssistantCloudAnonymousAuthStrategy,\n  normalizeBaseUrl,\n} from \"./AssistantCloudAuthStrategy\";\nimport type { AssistantCloudRunReport } from \"./AssistantCloudRuns\";\nimport { ASSISTANT_CLOUD_VERSION } from \"./version\";\n\nexport type SdkIdentity = {\n  name: string;\n  version: string;\n};\n\nexport type AssistantCloudTelemetryConfig = {\n  /**\n   * Enables Assistant Cloud telemetry. Defaults to `true`. Set to `false` to\n   * disable both run reports and engagement events.\n   */\n  enabled?: boolean;\n  /**\n   * Enables Assistant Cloud engagement events. Defaults to `true` when\n   * telemetry is enabled. Set to `false` to keep run reports while disabling\n   * engagement events.\n   */\n  events?: boolean;\n  /**\n   * Stores the messages of runtimes whose backend keeps the transcript (LangGraph, LangChain, Google ADK, custom external stores), so the dashboard can show them. Defaults to `true` when telemetry is enabled. Set to `false` to keep run reports and events without storing those messages.\n   */\n  messages?: boolean;\n  release?: string;\n  environment?: string;\n  tags?: string[];\n  /**\n   * Called before each telemetry report is sent.\n   * Return a modified report to enrich it (e.g. add `model_id`),\n   * or return `null` to skip the report.\n   */\n  beforeReport?: (\n    report: AssistantCloudRunReport,\n  ) => AssistantCloudRunReport | null;\n};\n\nexport type AssistantCloudConfig = (\n  | {\n      baseUrl: string;\n      authToken: () => Promise<string | null>;\n    }\n  | {\n      baseUrl?: string;\n      apiKey: string;\n      userId: string;\n      workspaceId: string;\n    }\n  | {\n      baseUrl: string;\n      anonymous: true;\n    }\n) & {\n  /**\n   * Client-side run telemetry reporting. Default: `true`.\n   *\n   * When enabled, the SDK automatically reports run metadata (status, step\n   * count, tool calls, and token usage) to Assistant Cloud after each\n   * assistant message is saved. Reports can also include assistant output,\n   * tool arguments and results, errors, and metadata, which may contain\n   * sensitive content. Use `beforeReport` to redact or drop reports, or\n   * `telemetry: false` to disable reporting.\n   *\n   * - `true` / `undefined` — enabled with defaults\n   * - `false` — disabled\n   * - `{ beforeReport }` — enabled with a hook to enrich or filter reports\n   */\n  telemetry?: boolean | AssistantCloudTelemetryConfig;\n};\n\nexport class CloudAPIError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: Record<string, unknown>,\n  ) {\n    super(message);\n    this.status = status;\n    if (code !== undefined) this.code = code;\n    if (details !== undefined) this.details = details;\n    this.name = \"CloudAPIError\";\n  }\n}\n\ntype MakeRequestOptions = {\n  method?: \"POST\" | \"PUT\" | \"DELETE\" | undefined;\n  headers?: Record<string, string> | undefined;\n  query?: Record<string, string | number | boolean> | undefined;\n  body?: object | undefined;\n  keepalive?: boolean | undefined;\n};\n\nconst HEADER_TOKEN = /^[\\x21-\\x7e]+$/;\n\nexport class AssistantCloudAPI {\n  public _auth: AssistantCloudAuthStrategy;\n  public _baseUrl;\n  public readonly registerSdk: (sdk: SdkIdentity) => void;\n  public readonly sdkHeader: () => string;\n\n  constructor(config: AssistantCloudConfig) {\n    const sdks = new Map<string, SdkIdentity>();\n    this.registerSdk = (sdk) => {\n      const name = sdk.name.trim();\n      const version = sdk.version.trim();\n      if (!HEADER_TOKEN.test(name) || !HEADER_TOKEN.test(version)) return;\n      sdks.set(`${name}/${version}`, { name, version });\n    };\n    this.sdkHeader = () =>\n      [\n        `assistant-cloud/${ASSISTANT_CLOUD_VERSION}`,\n        ...Array.from(\n          sdks.values(),\n          ({ name, version }) => `${name}/${version}`,\n        ),\n      ].join(\" \");\n\n    if (\"authToken\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudJWTAuthStrategy(config.authToken);\n    } else if (\"apiKey\" in config) {\n      this._baseUrl = normalizeBaseUrl(\n        config.baseUrl ?? \"https://backend.assistant-api.com\",\n      );\n      this._auth = new AssistantCloudAPIKeyAuthStrategy(\n        config.apiKey,\n        config.userId,\n        config.workspaceId,\n      );\n    } else if (\"anonymous\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudAnonymousAuthStrategy(this._baseUrl);\n    } else {\n      throw new Error(\n        \"Invalid configuration: Must provide authToken, apiKey, or anonymous configuration\",\n      );\n    }\n  }\n\n  public async initializeAuth() {\n    return !!(await this._auth.getAuthHeaders());\n  }\n\n  public async makeRawRequest(\n    endpoint: string,\n    options: MakeRequestOptions = {},\n  ) {\n    const authHeaders = await this._auth.getAuthHeaders();\n    if (!authHeaders) throw new Error(\"Authorization failed\");\n\n    const headers = {\n      ...authHeaders,\n      ...options.headers,\n      \"Content-Type\": \"application/json\",\n      \"Aui-Sdk\": this.sdkHeader(),\n    };\n\n    const queryParams = new URLSearchParams();\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value === false) continue;\n        if (value === true) {\n          queryParams.set(key, \"true\");\n        } else {\n          queryParams.set(key, value.toString());\n        }\n      }\n    }\n\n    const url = new URL(`${this._baseUrl}/v1${endpoint}`);\n    url.search = queryParams.toString();\n\n    const response = await fetch(url, {\n      method: options.method ?? \"GET\",\n      headers,\n      body: options.body ? JSON.stringify(options.body) : null,\n      ...(options.keepalive ? { keepalive: true } : {}),\n    });\n\n    this._auth.readAuthHeaders(response.headers);\n\n    if (!response.ok) {\n      const text = await response.text();\n      let message: string | undefined;\n      let code: string | undefined;\n      let details: Record<string, unknown> | undefined;\n      try {\n        const body = JSON.parse(text) as unknown;\n        if (typeof body === \"object\" && body !== null && !Array.isArray(body)) {\n          const record = body as Record<string, unknown>;\n          if (typeof record.message === \"string\" && record.message.length > 0) {\n            message = record.message;\n          }\n          if (typeof record.error === \"string\") {\n            code = record.error;\n            details = { ...record };\n            delete details.error;\n          }\n        }\n      } catch {}\n      throw new CloudAPIError(\n        message ?? `Request failed with status ${response.status}, ${text}`,\n        response.status,\n        code,\n        details,\n      );\n    }\n\n    return response;\n  }\n\n  public async makeRequest(endpoint: string, options: MakeRequestOptions = {}) {\n    const response = await this.makeRawRequest(endpoint, options);\n    if (\n      response.status === 204 ||\n      response.headers.get(\"content-length\") === \"0\"\n    )\n      return undefined;\n\n    const text = await response.text();\n    if (text.trim() === \"\") return undefined;\n\n    return JSON.parse(text);\n  }\n}\n"],"mappings":"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"}

package/dist/AssistantCloudAuthStrategy.d.ts

@@ -1,38 +1,35 @@
-//#region src/AssistantCloudAuthStrategy.d.ts
-type AssistantCloudAuthStrategy = {
-  readonly strategy: "anon" | "jwt" | "api-key";
-  getAuthHeaders(): Promise<Record<string, string> | false>;
-  readAuthHeaders(headers: Headers): void;
+export type AssistantCloudAuthStrategy = {
+    readonly strategy: "anon" | "jwt" | "api-key";
+    getAuthHeaders(): Promise<Record<string, string> | false>;
+    readAuthHeaders(headers: Headers): void;
 };
-declare class AssistantCloudJWTAuthStrategy implements AssistantCloudAuthStrategy {
-  #private;
-  readonly strategy = "jwt";
-  private cachedToken;
-  private tokenExpiry;
-  private tokenRequest;
-  constructor(authTokenCallback: () => Promise<string | null>);
-  getAuthHeaders(): Promise<Record<string, string> | false>;
-  private fetchAuthHeaders;
-  readAuthHeaders(headers: Headers): void;
+export declare class AssistantCloudJWTAuthStrategy implements AssistantCloudAuthStrategy {
+    #private;
+    readonly strategy = "jwt";
+    private cachedToken;
+    private tokenExpiry;
+    private tokenRequest;
+    constructor(authTokenCallback: () => Promise<string | null>);
+    getAuthHeaders(): Promise<Record<string, string> | false>;
+    private fetchAuthHeaders;
+    readAuthHeaders(headers: Headers): void;
 }
-declare class AssistantCloudAPIKeyAuthStrategy implements AssistantCloudAuthStrategy {
-  #private;
-  readonly strategy = "api-key";
-  constructor(apiKey: string, userId: string, workspaceId: string);
-  getAuthHeaders(): Promise<Record<string, string>>;
-  readAuthHeaders(): void;
+export declare class AssistantCloudAPIKeyAuthStrategy implements AssistantCloudAuthStrategy {
+    #private;
+    readonly strategy = "api-key";
+    constructor(apiKey: string, userId: string, workspaceId: string);
+    getAuthHeaders(): Promise<Record<string, string>>;
+    readAuthHeaders(): void;
 }
-declare const normalizeBaseUrl: (baseUrl: string) => string;
+export declare const normalizeBaseUrl: (baseUrl: string) => string;
 /** The refresh token of the anonymous identity this browser holds for `baseUrl`, or null when it has none. */
-declare const readAnonymousRefreshToken: (baseUrl: string) => string | null;
-declare class AssistantCloudAnonymousAuthStrategy implements AssistantCloudAuthStrategy {
-  readonly strategy = "anon";
-  private baseUrl;
-  private jwtStrategy;
-  constructor(baseUrl: string);
-  getAuthHeaders(): Promise<Record<string, string> | false>;
-  readAuthHeaders(headers: Headers): void;
+export declare const readAnonymousRefreshToken: (baseUrl: string) => string | null;
+export declare class AssistantCloudAnonymousAuthStrategy implements AssistantCloudAuthStrategy {
+    readonly strategy = "anon";
+    private baseUrl;
+    private jwtStrategy;
+    constructor(baseUrl: string);
+    getAuthHeaders(): Promise<Record<string, string> | false>;
+    readAuthHeaders(headers: Headers): void;
 }
-//#endregion
-export { AssistantCloudAPIKeyAuthStrategy, AssistantCloudAnonymousAuthStrategy, AssistantCloudAuthStrategy, AssistantCloudJWTAuthStrategy, normalizeBaseUrl, readAnonymousRefreshToken };
 //# sourceMappingURL=AssistantCloudAuthStrategy.d.ts.map

package/dist/AssistantCloudAuthStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAuthStrategy.d.ts","names":[],"sources":["../src/AssistantCloudAuthStrategy.ts"],"mappings":";KAkCY;WACD;EACT,kBAAkB,QAAQ;EAC1B,gBAAgB,SAAS;;cAmFd,yCAAyC;;WACpC;UAER;UACA;UACA;EAGI,YAAA,yBAAyB;EAIxB,kBAAkB,QAAQ;UA0BzB;EAWP,gBAAgB,SAAS;;cAerB,4CAA4C;;WACvC;EAMJ,YAAA,gBAAgB,gBAAgB;EAM/B,kBAAkB,QAAQ;EAQhC;;cAuDI,mBAAoB;;cAMpB,4BAA6B;cAwE7B,+CAA+C;WAC1C;UAER;UACA;EAEI,YAAA;EAwFC,kBAAkB,QAAQ;EAIhC,gBAAgB,SAAS"}
+{"version":3,"file":"AssistantCloudAuthStrategy.d.ts","sourceRoot":"","sources":["../src/AssistantCloudAuthStrategy.ts"],"names":[],"mappings":"AAkCA,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC9C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC,CAAC;AAkFF,qBAAa,6BAA8B,YAAW,0BAA0B;;IAC9E,SAAgB,QAAQ,SAAS;IAEjC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAAwD;gBAGhE,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;YA0BxD,gBAAgB;IAWvB,eAAe,CAAC,OAAO,EAAE,OAAO;CAaxC;AAED,qBAAa,gCAAiC,YAAW,0BAA0B;;IACjF,SAAgB,QAAQ,aAAa;gBAMzB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMlD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAQvD,eAAe;CAGvB;AAoDD,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MAGlD,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,IAKpE,CAAC;AAmEF,qBAAa,mCAAoC,YAAW,0BAA0B;IACpF,SAAgB,QAAQ,UAAU;IAElC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgC;gBAEvC,OAAO,EAAE,MAAM;IAwFd,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAI/D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAG/C"}

package/dist/AssistantCloudAuthTokens.d.ts

@@ -1,13 +1,11 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-//#region src/AssistantCloudAuthTokens.d.ts
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 type AssistantCloudAuthTokensCreateResponse = {
-  token: string;
+    token: string;
 };
-declare class AssistantCloudAuthTokens {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  create(): Promise<AssistantCloudAuthTokensCreateResponse>;
+export declare class AssistantCloudAuthTokens {
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    create(): Promise<AssistantCloudAuthTokensCreateResponse>;
 }
-//#endregion
-export { AssistantCloudAuthTokens };
+export {};
 //# sourceMappingURL=AssistantCloudAuthTokens.d.ts.map

package/dist/AssistantCloudAuthTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAuthTokens.d.ts","names":[],"sources":["../src/AssistantCloudAuthTokens.ts"],"mappings":";;KAGK;EACH;;cAGW;UACH;EAEI,YAAA,OAAO;EAIN,UAAU,QAAQ"}
+{"version":3,"file":"AssistantCloudAuthTokens.d.ts","sourceRoot":"","sources":["../src/AssistantCloudAuthTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAG7D,KAAK,sCAAsC,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAIvB,MAAM,IAAI,OAAO,CAAC,sCAAsC,CAAC;CAQvE"}

package/dist/AssistantCloudEvents.d.ts

@@ -1,32 +1,38 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-//#region src/AssistantCloudEvents.d.ts
-type AssistantCloudEventKind = "message_sent" | "message_edited" | "run_stopped" | "message_regenerated" | "message_copied" | "branch_switched" | "suggestions_shown" | "suggestion_clicked" | "attachment_added" | "attachment_failed" | "thread_switched" | "tool_approved" | "tool_rejected" | "speech_started" | "voice_started" | "error_shown";
-type AssistantCloudEvent = {
-  kind: AssistantCloudEventKind;
-  thread_id?: string | undefined;
-  message_id?: string | undefined;
-  run_id?: string | undefined;
-  value?: number | undefined;
-  props?: Readonly<Record<string, string | number | boolean>> | undefined;
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+export type AssistantCloudEventKind = "message_sent" | "message_edited" | "run_stopped" | "message_regenerated" | "message_copied" | "branch_switched" | "suggestions_shown" | "suggestion_clicked" | "attachment_added" | "attachment_failed" | "thread_switched" | "tool_approved" | "tool_rejected" | "speech_started" | "voice_started" | "error_shown";
+export type AssistantCloudEvent = {
+    kind: AssistantCloudEventKind;
+    thread_id?: string | undefined;
+    message_id?: string | undefined;
+    run_id?: string | undefined;
+    value?: number | undefined;
+    props?: Readonly<Record<string, string | number | boolean>> | undefined;
 };
-declare class AssistantCloudEvents {
-  private buffer;
-  private timer;
-  private flushing;
-  private readonly cloud;
-  private readonly isEnabled;
-  private listening;
-  constructor(cloud: AssistantCloudAPI, isEnabled: () => boolean);
-  track(event: AssistantCloudEvent): void;
-  private listen;
-  private unlisten;
-  dispose(): void;
-  private onVisibilityChange;
-  private flush;
-  private flushPending;
-  private scheduleFlush;
-  private clearFlushTimer;
+export declare const clearPendingAssistantCloudEvents: (events: AssistantCloudEvents) => void;
+export declare class AssistantCloudEvents {
+    private buffer;
+    private timer;
+    private flushing;
+    private retryTimer;
+    private resolveRetryDelay;
+    private bestEffortRequested;
+    private generation;
+    private readonly cloud;
+    private readonly isEnabled;
+    private listening;
+    constructor(cloud: AssistantCloudAPI, isEnabled: () => boolean);
+    track(event: AssistantCloudEvent): void;
+    private listen;
+    private unlisten;
+    dispose(): void;
+    private clearPending;
+    private onVisibilityChange;
+    private flushBestEffort;
+    private flush;
+    private flushPending;
+    private waitForRetry;
+    private interruptRetryDelay;
+    private scheduleFlush;
+    private clearFlushTimer;
 }
-//#endregion
-export { AssistantCloudEvent, AssistantCloudEventKind, AssistantCloudEvents };
 //# sourceMappingURL=AssistantCloudEvents.d.ts.map

package/dist/AssistantCloudEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudEvents.d.ts","names":[],"sources":["../src/AssistantCloudEvents.ts"],"mappings":";;KAEY;KAkBA;EACV,MAAM;EACN;EACA;EACA;EACA;EACA,QAAQ,SAAS;;cAON;UACH;UACA;UACA;mBAES;mBACA;UAET;EAEI,YAAA,OAAO,mBAAmB;EAK/B,MAAM,OAAO;UAaZ;UAaA;EAOD;UAMC;UAMA;UAyBM;UAkBN;UAQA"}
+{"version":3,"file":"AssistantCloudEvents.d.ts","sourceRoot":"","sources":["../src/AssistantCloudEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAE7D,MAAM,MAAM,uBAAuB,GAC/B,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE,CAAC;AAQF,eAAO,MAAM,gCAAgC,GAC3C,QAAQ,oBAAoB,KAC3B,IAEF,CAAC;AAEF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C,OAAO,CAAC,SAAS,CAAS;gBAEd,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO;IAMvD,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAa9C,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,QAAQ;IAOT,OAAO,IAAI,IAAI;IAMtB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,kBAAkB,CAIxB;IAEF,OAAO,CAAC,eAAe,CAMrB;IAEF,OAAO,CAAC,KAAK,CAsBX;YAEY,YAAY;IAkC1B,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;CAKxB"}