assistant-cloud 0.2.1 → 0.2.3

package/dist/AssistantCloudEvents.js

@@ -2,23 +2,33 @@
 const FLUSH_SIZE = 20;
 const MAX_BATCH_SIZE = 50;
 const FLUSH_DELAY_MS = 2e3;
+const RETRY_DELAYS_MS = [250, 1e3];
+const pendingClearers = /* @__PURE__ */ new WeakMap();
+const clearPendingAssistantCloudEvents = (events) => {
+	pendingClearers.get(events)?.();
+};
 var AssistantCloudEvents = class {
 	buffer = [];
 	timer;
 	flushing;
+	retryTimer;
+	resolveRetryDelay;
+	bestEffortRequested = false;
+	generation = 0;
 	cloud;
 	isEnabled;
 	listening = false;
 	constructor(cloud, isEnabled) {
 		this.cloud = cloud;
 		this.isEnabled = isEnabled;
+		pendingClearers.set(this, () => this.clearPending());
 	}
 	track(event) {
 		if (!this.isEnabled()) return;
 		this.listen();
 		this.buffer.push(normalizeEvent(event));
 		if (this.buffer.length >= FLUSH_SIZE) {
-			this.flush();
+			this.flush(true);
 			return;
 		}
 		this.scheduleFlush();
@@ -26,65 +36,104 @@ var AssistantCloudEvents = class {
 	listen() {
 		if (this.listening || typeof window === "undefined" || typeof document === "undefined") return;
 		this.listening = true;
-		window.addEventListener("pagehide", this.flush);
+		window.addEventListener("pagehide", this.flushBestEffort);
 		document.addEventListener("visibilitychange", this.onVisibilityChange);
 	}
 	unlisten() {
 		if (!this.listening) return;
 		this.listening = false;
-		window.removeEventListener("pagehide", this.flush);
+		window.removeEventListener("pagehide", this.flushBestEffort);
 		document.removeEventListener("visibilitychange", this.onVisibilityChange);
 	}
 	dispose() {
 		this.unlisten();
 		this.clearFlushTimer();
-		this.flush();
+		this.flushBestEffort();
+	}
+	clearPending() {
+		this.generation++;
+		this.buffer = [];
+		this.clearFlushTimer();
+		this.interruptRetryDelay();
+		this.unlisten();
 	}
 	onVisibilityChange = () => {
-		if (document.visibilityState === "hidden") this.flush();
+		if (document.visibilityState === "hidden") this.flushBestEffort();
+	};
+	flushBestEffort = () => {
+		if (this.flushing) {
+			this.bestEffortRequested = true;
+			this.interruptRetryDelay();
+		}
+		return this.flush(false);
 	};
-	flush = async () => {
+	flush = async (retryFailures) => {
 		if (!this.isEnabled()) {
-			this.buffer = [];
-			this.clearFlushTimer();
-			this.unlisten();
+			this.clearPending();
 			return;
 		}
 		if (this.flushing) return this.flushing;
 		this.clearFlushTimer();
-		const task = this.flushPending();
+		const task = this.flushPending(retryFailures);
 		this.flushing = task;
 		task.then(() => {
 			if (this.flushing !== task) return;
 			this.flushing = void 0;
+			this.bestEffortRequested = false;
 			if (this.buffer.length === 0) {
 				this.clearFlushTimer();
 				this.unlisten();
-			} else this.flush();
+			} else this.flush(true);
 		});
 		return task;
 	};
-	async flushPending() {
+	async flushPending(retryFailures) {
 		while (this.buffer.length > 0) {
 			if (!this.isEnabled()) {
 				this.buffer = [];
 				return;
 			}
 			const events = this.buffer.splice(0, MAX_BATCH_SIZE);
-			try {
+			const generation = this.generation;
+			for (let attempt = 0;; attempt++) try {
 				await this.cloud.makeRequest("/events", {
 					method: "POST",
 					body: { events },
 					keepalive: true
 				});
-			} catch {}
+				if (generation !== this.generation) return;
+				break;
+			} catch {
+				if (generation !== this.generation) return;
+				const delay = retryFailures && !this.bestEffortRequested ? RETRY_DELAYS_MS[attempt] : void 0;
+				if (delay === void 0) break;
+				await this.waitForRetry(delay);
+				if (generation !== this.generation) return;
+				if (!this.isEnabled()) return this.clearPending();
+				if (this.bestEffortRequested) break;
+			}
 		}
 	}
+	waitForRetry(delay) {
+		return new Promise((resolve) => {
+			const finish = () => {
+				this.retryTimer = void 0;
+				this.resolveRetryDelay = void 0;
+				resolve();
+			};
+			this.resolveRetryDelay = finish;
+			this.retryTimer = setTimeout(finish, delay);
+		});
+	}
+	interruptRetryDelay() {
+		if (this.retryTimer !== void 0) clearTimeout(this.retryTimer);
+		this.resolveRetryDelay?.();
+	}
 	scheduleFlush() {
 		if (this.timer !== void 0) return;
 		this.timer = setTimeout(() => {
 			this.timer = void 0;
-			this.flush();
+			this.flush(true);
 		}, FLUSH_DELAY_MS);
 	}
 	clearFlushTimer() {
@@ -109,11 +158,11 @@ const isNonNegativeInteger = (value) => value !== void 0 && Number.isInteger(val
 const normalizeProps = (props) => {
 	if (!props) return void 0;
 	const entries = Object.entries(props);
-	if (entries.some(([, value]) => typeof value === "string" && value.length > 256 || typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean")) return;
+	if (entries.some(([, value]) => typeof value === "string" && value.length > 256 || typeof value === "number" && !Number.isFinite(value) || typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean")) return;
 	const value = Object.fromEntries(entries);
 	return new TextEncoder().encode(JSON.stringify(value)).byteLength <= 1024 ? value : void 0;
 };
 //#endregion
-export { AssistantCloudEvents };
+export { AssistantCloudEvents, clearPendingAssistantCloudEvents };
 
 //# sourceMappingURL=AssistantCloudEvents.js.map

package/dist/AssistantCloudEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudEvents.js","names":[],"sources":["../src/AssistantCloudEvents.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\n\nexport type AssistantCloudEventKind =\n  | \"message_sent\"\n  | \"message_edited\"\n  | \"run_stopped\"\n  | \"message_regenerated\"\n  | \"message_copied\"\n  | \"branch_switched\"\n  | \"suggestions_shown\"\n  | \"suggestion_clicked\"\n  | \"attachment_added\"\n  | \"attachment_failed\"\n  | \"thread_switched\"\n  | \"tool_approved\"\n  | \"tool_rejected\"\n  | \"speech_started\"\n  | \"voice_started\"\n  | \"error_shown\";\n\nexport type AssistantCloudEvent = {\n  kind: AssistantCloudEventKind;\n  thread_id?: string | undefined;\n  message_id?: string | undefined;\n  run_id?: string | undefined;\n  value?: number | undefined;\n  props?: Readonly<Record<string, string | number | boolean>> | undefined;\n};\n\nconst FLUSH_SIZE = 20;\nconst MAX_BATCH_SIZE = 50;\nconst FLUSH_DELAY_MS = 2_000;\n\nexport class AssistantCloudEvents {\n  private buffer: AssistantCloudEvent[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private flushing: Promise<void> | undefined;\n\n  private readonly cloud: AssistantCloudAPI;\n  private readonly isEnabled: () => boolean;\n\n  private listening = false;\n\n  constructor(cloud: AssistantCloudAPI, isEnabled: () => boolean) {\n    this.cloud = cloud;\n    this.isEnabled = isEnabled;\n  }\n\n  public track(event: AssistantCloudEvent): void {\n    if (!this.isEnabled()) return;\n\n    this.listen();\n    this.buffer.push(normalizeEvent(event));\n    if (this.buffer.length >= FLUSH_SIZE) {\n      void this.flush();\n      return;\n    }\n\n    this.scheduleFlush();\n  }\n\n  private listen(): void {\n    if (\n      this.listening ||\n      typeof window === \"undefined\" ||\n      typeof document === \"undefined\"\n    ) {\n      return;\n    }\n    this.listening = true;\n    window.addEventListener(\"pagehide\", this.flush);\n    document.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n  }\n\n  private unlisten(): void {\n    if (!this.listening) return;\n    this.listening = false;\n    window.removeEventListener(\"pagehide\", this.flush);\n    document.removeEventListener(\"visibilitychange\", this.onVisibilityChange);\n  }\n\n  public dispose(): void {\n    this.unlisten();\n    this.clearFlushTimer();\n    void this.flush();\n  }\n\n  private onVisibilityChange = () => {\n    if (document.visibilityState === \"hidden\") {\n      void this.flush();\n    }\n  };\n\n  private flush = async (): Promise<void> => {\n    if (!this.isEnabled()) {\n      this.buffer = [];\n      this.clearFlushTimer();\n      this.unlisten();\n      return;\n    }\n    if (this.flushing) return this.flushing;\n\n    this.clearFlushTimer();\n    const task = this.flushPending();\n    this.flushing = task;\n    void task.then(() => {\n      if (this.flushing !== task) return;\n      this.flushing = undefined;\n      if (this.buffer.length === 0) {\n        this.clearFlushTimer();\n        this.unlisten();\n      } else {\n        void this.flush();\n      }\n    });\n    return task;\n  };\n\n  private async flushPending(): Promise<void> {\n    while (this.buffer.length > 0) {\n      if (!this.isEnabled()) {\n        this.buffer = [];\n        return;\n      }\n\n      const events = this.buffer.splice(0, MAX_BATCH_SIZE);\n      try {\n        await this.cloud.makeRequest(\"/events\", {\n          method: \"POST\",\n          body: { events },\n          keepalive: true,\n        });\n      } catch {}\n    }\n  }\n\n  private scheduleFlush() {\n    if (this.timer !== undefined) return;\n    this.timer = setTimeout(() => {\n      this.timer = undefined;\n      void this.flush();\n    }, FLUSH_DELAY_MS);\n  }\n\n  private clearFlushTimer() {\n    if (this.timer === undefined) return;\n    clearTimeout(this.timer);\n    this.timer = undefined;\n  }\n}\n\nconst normalizeEvent = (event: AssistantCloudEvent): AssistantCloudEvent => {\n  const props = normalizeProps(event.props);\n  return {\n    kind: event.kind,\n    ...(normalizeId(event.thread_id) ? { thread_id: event.thread_id } : {}),\n    ...(normalizeId(event.message_id) ? { message_id: event.message_id } : {}),\n    ...(normalizeId(event.run_id) ? { run_id: event.run_id } : {}),\n    ...(isNonNegativeInteger(event.value) ? { value: event.value } : {}),\n    ...(props ? { props } : {}),\n  };\n};\n\nconst normalizeId = (value: string | undefined): string | undefined =>\n  value && value.length <= 48 ? value : undefined;\n\nconst isNonNegativeInteger = (value: number | undefined): value is number =>\n  value !== undefined && Number.isInteger(value) && value >= 0;\n\nconst normalizeProps = (\n  props: AssistantCloudEvent[\"props\"],\n): AssistantCloudEvent[\"props\"] => {\n  if (!props) return undefined;\n  const entries = Object.entries(props);\n  if (\n    entries.some(\n      ([, value]) =>\n        (typeof value === \"string\" && value.length > 256) ||\n        (typeof value !== \"string\" &&\n          typeof value !== \"number\" &&\n          typeof value !== \"boolean\"),\n    )\n  ) {\n    return undefined;\n  }\n  const value = Object.fromEntries(entries);\n  return new TextEncoder().encode(JSON.stringify(value)).byteLength <= 1024\n    ? value\n    : undefined;\n};\n"],"mappings":"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"}
+{"version":3,"file":"AssistantCloudEvents.js","names":[],"sources":["../src/AssistantCloudEvents.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\n\nexport type AssistantCloudEventKind =\n  | \"message_sent\"\n  | \"message_edited\"\n  | \"run_stopped\"\n  | \"message_regenerated\"\n  | \"message_copied\"\n  | \"branch_switched\"\n  | \"suggestions_shown\"\n  | \"suggestion_clicked\"\n  | \"attachment_added\"\n  | \"attachment_failed\"\n  | \"thread_switched\"\n  | \"tool_approved\"\n  | \"tool_rejected\"\n  | \"speech_started\"\n  | \"voice_started\"\n  | \"error_shown\";\n\nexport type AssistantCloudEvent = {\n  kind: AssistantCloudEventKind;\n  thread_id?: string | undefined;\n  message_id?: string | undefined;\n  run_id?: string | undefined;\n  value?: number | undefined;\n  props?: Readonly<Record<string, string | number | boolean>> | undefined;\n};\n\nconst FLUSH_SIZE = 20;\nconst MAX_BATCH_SIZE = 50;\nconst FLUSH_DELAY_MS = 2_000;\nconst RETRY_DELAYS_MS = [250, 1_000] as const;\nconst pendingClearers = new WeakMap<AssistantCloudEvents, () => void>();\n\nexport const clearPendingAssistantCloudEvents = (\n  events: AssistantCloudEvents,\n): void => {\n  pendingClearers.get(events)?.();\n};\n\nexport class AssistantCloudEvents {\n  private buffer: AssistantCloudEvent[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private flushing: Promise<void> | undefined;\n  private retryTimer: ReturnType<typeof setTimeout> | undefined;\n  private resolveRetryDelay: (() => void) | undefined;\n  private bestEffortRequested = false;\n  private generation = 0;\n\n  private readonly cloud: AssistantCloudAPI;\n  private readonly isEnabled: () => boolean;\n\n  private listening = false;\n\n  constructor(cloud: AssistantCloudAPI, isEnabled: () => boolean) {\n    this.cloud = cloud;\n    this.isEnabled = isEnabled;\n    pendingClearers.set(this, () => this.clearPending());\n  }\n\n  public track(event: AssistantCloudEvent): void {\n    if (!this.isEnabled()) return;\n\n    this.listen();\n    this.buffer.push(normalizeEvent(event));\n    if (this.buffer.length >= FLUSH_SIZE) {\n      void this.flush(true);\n      return;\n    }\n\n    this.scheduleFlush();\n  }\n\n  private listen(): void {\n    if (\n      this.listening ||\n      typeof window === \"undefined\" ||\n      typeof document === \"undefined\"\n    ) {\n      return;\n    }\n    this.listening = true;\n    window.addEventListener(\"pagehide\", this.flushBestEffort);\n    document.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n  }\n\n  private unlisten(): void {\n    if (!this.listening) return;\n    this.listening = false;\n    window.removeEventListener(\"pagehide\", this.flushBestEffort);\n    document.removeEventListener(\"visibilitychange\", this.onVisibilityChange);\n  }\n\n  public dispose(): void {\n    this.unlisten();\n    this.clearFlushTimer();\n    void this.flushBestEffort();\n  }\n\n  private clearPending(): void {\n    this.generation++;\n    this.buffer = [];\n    this.clearFlushTimer();\n    this.interruptRetryDelay();\n    this.unlisten();\n  }\n\n  private onVisibilityChange = () => {\n    if (document.visibilityState === \"hidden\") {\n      void this.flushBestEffort();\n    }\n  };\n\n  private flushBestEffort = () => {\n    if (this.flushing) {\n      this.bestEffortRequested = true;\n      this.interruptRetryDelay();\n    }\n    return this.flush(false);\n  };\n\n  private flush = async (retryFailures: boolean): Promise<void> => {\n    if (!this.isEnabled()) {\n      this.clearPending();\n      return;\n    }\n    if (this.flushing) return this.flushing;\n\n    this.clearFlushTimer();\n    const task = this.flushPending(retryFailures);\n    this.flushing = task;\n    void task.then(() => {\n      if (this.flushing !== task) return;\n      this.flushing = undefined;\n      this.bestEffortRequested = false;\n      if (this.buffer.length === 0) {\n        this.clearFlushTimer();\n        this.unlisten();\n      } else {\n        void this.flush(true);\n      }\n    });\n    return task;\n  };\n\n  private async flushPending(retryFailures: boolean): Promise<void> {\n    while (this.buffer.length > 0) {\n      if (!this.isEnabled()) {\n        this.buffer = [];\n        return;\n      }\n\n      const events = this.buffer.splice(0, MAX_BATCH_SIZE);\n      const generation = this.generation;\n      for (let attempt = 0; ; attempt++) {\n        try {\n          await this.cloud.makeRequest(\"/events\", {\n            method: \"POST\",\n            body: { events },\n            keepalive: true,\n          });\n          if (generation !== this.generation) return;\n          break;\n        } catch {\n          if (generation !== this.generation) return;\n          const delay =\n            retryFailures && !this.bestEffortRequested\n              ? RETRY_DELAYS_MS[attempt]\n              : undefined;\n          if (delay === undefined) break;\n          await this.waitForRetry(delay);\n          if (generation !== this.generation) return;\n          if (!this.isEnabled()) return this.clearPending();\n          if (this.bestEffortRequested) break;\n        }\n      }\n    }\n  }\n\n  private waitForRetry(delay: number): Promise<void> {\n    return new Promise((resolve) => {\n      const finish = () => {\n        this.retryTimer = undefined;\n        this.resolveRetryDelay = undefined;\n        resolve();\n      };\n      this.resolveRetryDelay = finish;\n      this.retryTimer = setTimeout(finish, delay);\n    });\n  }\n\n  private interruptRetryDelay(): void {\n    if (this.retryTimer !== undefined) clearTimeout(this.retryTimer);\n    this.resolveRetryDelay?.();\n  }\n\n  private scheduleFlush() {\n    if (this.timer !== undefined) return;\n    this.timer = setTimeout(() => {\n      this.timer = undefined;\n      void this.flush(true);\n    }, FLUSH_DELAY_MS);\n  }\n\n  private clearFlushTimer() {\n    if (this.timer === undefined) return;\n    clearTimeout(this.timer);\n    this.timer = undefined;\n  }\n}\n\nconst normalizeEvent = (event: AssistantCloudEvent): AssistantCloudEvent => {\n  const props = normalizeProps(event.props);\n  return {\n    kind: event.kind,\n    ...(normalizeId(event.thread_id) ? { thread_id: event.thread_id } : {}),\n    ...(normalizeId(event.message_id) ? { message_id: event.message_id } : {}),\n    ...(normalizeId(event.run_id) ? { run_id: event.run_id } : {}),\n    ...(isNonNegativeInteger(event.value) ? { value: event.value } : {}),\n    ...(props ? { props } : {}),\n  };\n};\n\nconst normalizeId = (value: string | undefined): string | undefined =>\n  value && value.length <= 48 ? value : undefined;\n\nconst isNonNegativeInteger = (value: number | undefined): value is number =>\n  value !== undefined && Number.isInteger(value) && value >= 0;\n\nconst normalizeProps = (\n  props: AssistantCloudEvent[\"props\"],\n): AssistantCloudEvent[\"props\"] => {\n  if (!props) return undefined;\n  const entries = Object.entries(props);\n  if (\n    entries.some(\n      ([, value]) =>\n        (typeof value === \"string\" && value.length > 256) ||\n        (typeof value === \"number\" && !Number.isFinite(value)) ||\n        (typeof value !== \"string\" &&\n          typeof value !== \"number\" &&\n          typeof value !== \"boolean\"),\n    )\n  ) {\n    return undefined;\n  }\n  const value = Object.fromEntries(entries);\n  return new TextEncoder().encode(JSON.stringify(value)).byteLength <= 1024\n    ? value\n    : undefined;\n};\n"],"mappings":"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"}

package/dist/AssistantCloudFiles.d.ts

@@ -1,40 +1,38 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-//#region src/AssistantCloudFiles.d.ts
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 type PdfToImagesRequestBody = {
-  file_blob?: string | undefined;
-  file_url?: string | undefined;
+    file_blob?: string | undefined;
+    file_url?: string | undefined;
 };
 type PdfToImagesResponse = {
-  success: boolean;
-  urls: string[];
-  message: string;
+    success: boolean;
+    urls: string[];
+    message: string;
 };
 type GeneratePresignedUploadUrlRequestBody = {
-  filename: string;
+    filename: string;
 };
 type GeneratePresignedUploadUrlResponse = {
-  success: boolean;
-  signedUrl: string;
-  expiresAt: string;
-  publicUrl: string;
-  key?: string;
+    success: boolean;
+    signedUrl: string;
+    expiresAt: string;
+    publicUrl: string;
+    key?: string;
 };
-type GeneratePresignedDownloadUrlResponse = {
-  signedUrl: string;
-  expiresAt: string;
-  key: string;
-};
-declare class AssistantCloudFiles {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  pdfToImages(body: PdfToImagesRequestBody): Promise<PdfToImagesResponse>;
-  generatePresignedUploadUrl(body: GeneratePresignedUploadUrlRequestBody): Promise<GeneratePresignedUploadUrlResponse>;
-  generatePresignedDownloadUrl(body: {
+export type GeneratePresignedDownloadUrlResponse = {
+    signedUrl: string;
+    expiresAt: string;
     key: string;
-  } | {
-    url: string;
-  }): Promise<GeneratePresignedDownloadUrlResponse>;
+};
+export declare class AssistantCloudFiles {
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    pdfToImages(body: PdfToImagesRequestBody): Promise<PdfToImagesResponse>;
+    generatePresignedUploadUrl(body: GeneratePresignedUploadUrlRequestBody): Promise<GeneratePresignedUploadUrlResponse>;
+    generatePresignedDownloadUrl(body: {
+        key: string;
+    } | {
+        url: string;
+    }): Promise<GeneratePresignedDownloadUrlResponse>;
 }
-//#endregion
-export { AssistantCloudFiles, GeneratePresignedDownloadUrlResponse };
+export {};
 //# sourceMappingURL=AssistantCloudFiles.d.ts.map

package/dist/AssistantCloudFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudFiles.d.ts","names":[],"sources":["../src/AssistantCloudFiles.ts"],"mappings":";;KAQK;EACH;EACA;;KAGG;EACH;EACA;EACA;;KAGG;EACH;;KAGG;EACH;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;;cAGW;UACH;EAEI,YAAA,OAAO;EAIN,YACX,MAAM,yBACL,QAAQ;EAyBE,2BACX,MAAM,wCACL,QAAQ;EAqCE,6BACX;IAAQ;;IAAkB;MACzB,QAAQ"}
+{"version":3,"file":"AssistantCloudFiles.d.ts","sourceRoot":"","sources":["../src/AssistantCloudFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAQ7D,KAAK,sBAAsB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,qCAAqC,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,kCAAkC,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAIvB,WAAW,CACtB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAyBlB,0BAA0B,CACrC,IAAI,EAAE,qCAAqC,GAC1C,OAAO,CAAC,kCAAkC,CAAC;IAqCjC,4BAA4B,CACvC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,oCAAoC,CAAC;CAwBjD"}

package/dist/AssistantCloudProjectThreadMessages.d.ts

@@ -1,19 +1,17 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-import { CloudMessage } from "./AssistantCloudThreadMessages.js";
-//#region src/AssistantCloudProjectThreadMessages.d.ts
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import { type CloudMessage } from "./AssistantCloudThreadMessages.js";
 type AssistantCloudProjectThreadMessageListQuery = {
-  format?: string;
-  limit?: number;
-  after?: string;
+    format?: string;
+    limit?: number;
+    after?: string;
 };
 type AssistantCloudProjectThreadMessageListResponse = {
-  messages: CloudMessage[];
+    messages: CloudMessage[];
 };
-declare class AssistantCloudProjectThreadMessages {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  list(threadId: string, query?: AssistantCloudProjectThreadMessageListQuery): Promise<AssistantCloudProjectThreadMessageListResponse>;
+export declare class AssistantCloudProjectThreadMessages {
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    list(threadId: string, query?: AssistantCloudProjectThreadMessageListQuery): Promise<AssistantCloudProjectThreadMessageListResponse>;
 }
-//#endregion
-export { AssistantCloudProjectThreadMessages };
+export {};
 //# sourceMappingURL=AssistantCloudProjectThreadMessages.d.ts.map

package/dist/AssistantCloudProjectThreadMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudProjectThreadMessages.d.ts","names":[],"sources":["../src/AssistantCloudProjectThreadMessages.ts"],"mappings":";;;KAOK;EACH;EACA;EACA;;KAGG;EACH,UAAU;;cAGC;UACH;EAEI,YAAA,OAAO;EAIN,KACX,kBACA,QAAQ,8CACP,QAAQ"}
+{"version":3,"file":"AssistantCloudProjectThreadMessages.d.ts","sourceRoot":"","sources":["../src/AssistantCloudProjectThreadMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAC7D,OAAO,EAEL,KAAK,YAAY,EAClB,0CAAuC;AAGxC,KAAK,2CAA2C,GAAG;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,8CAA8C,GAAG;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,CAAC;AAEF,qBAAa,mCAAmC;IAC9C,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAIvB,IAAI,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,2CAA2C,GAClD,OAAO,CAAC,8CAA8C,CAAC;CAgB3D"}

package/dist/AssistantCloudProjectThreads.d.ts

@@ -1,21 +1,19 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { AssistantCloudProjectThreadMessages } from "./AssistantCloudProjectThreadMessages.js";
-import { CloudThread } from "./AssistantCloudThreads.js";
-//#region src/AssistantCloudProjectThreads.d.ts
+import { type CloudThread } from "./AssistantCloudThreads.js";
 type AssistantCloudProjectThreadsListQuery = {
-  is_archived?: boolean;
-  limit?: number;
-  after?: string;
+    is_archived?: boolean;
+    limit?: number;
+    after?: string;
 };
 type AssistantCloudProjectThreadsListResponse = {
-  threads: CloudThread[];
+    threads: CloudThread[];
 };
-declare class AssistantCloudProjectThreads {
-  readonly messages: AssistantCloudProjectThreadMessages;
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  list(query?: AssistantCloudProjectThreadsListQuery): Promise<AssistantCloudProjectThreadsListResponse>;
+export declare class AssistantCloudProjectThreads {
+    readonly messages: AssistantCloudProjectThreadMessages;
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    list(query?: AssistantCloudProjectThreadsListQuery): Promise<AssistantCloudProjectThreadsListResponse>;
 }
-//#endregion
-export { AssistantCloudProjectThreads };
+export {};
 //# sourceMappingURL=AssistantCloudProjectThreads.d.ts.map

package/dist/AssistantCloudProjectThreads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudProjectThreads.d.ts","names":[],"sources":["../src/AssistantCloudProjectThreads.ts"],"mappings":";;;;KAKK;EACH;EACA;EACA;;KAGG;EACH,SAAS;;cAGE;WACK,UAAU;UAElB;EAEI,YAAA,OAAO;EAKN,KACX,QAAQ,wCACP,QAAQ"}
+{"version":3,"file":"AssistantCloudProjectThreads.d.ts","sourceRoot":"","sources":["../src/AssistantCloudProjectThreads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAC7D,OAAO,EAAE,mCAAmC,EAAE,iDAA8C;AAC5F,OAAO,EAAqB,KAAK,WAAW,EAAE,mCAAgC;AAG9E,KAAK,qCAAqC,GAAG;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,wCAAwC,GAAG;IAC9C,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF,qBAAa,4BAA4B;IACvC,SAAgB,QAAQ,EAAE,mCAAmC,CAAC;IAE9D,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAKvB,IAAI,CACf,KAAK,CAAC,EAAE,qCAAqC,GAC5C,OAAO,CAAC,wCAAwC,CAAC;CAsBrD"}

package/dist/AssistantCloudProjects.d.ts

@@ -1,10 +1,7 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { AssistantCloudProjectThreads } from "./AssistantCloudProjectThreads.js";
-//#region src/AssistantCloudProjects.d.ts
-declare class AssistantCloudProjects {
-  readonly threads: AssistantCloudProjectThreads;
-  constructor(cloud: AssistantCloudAPI);
+export declare class AssistantCloudProjects {
+    readonly threads: AssistantCloudProjectThreads;
+    constructor(cloud: AssistantCloudAPI);
 }
-//#endregion
-export { AssistantCloudProjects };
 //# sourceMappingURL=AssistantCloudProjects.d.ts.map

package/dist/AssistantCloudProjects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudProjects.d.ts","names":[],"sources":["../src/AssistantCloudProjects.ts"],"mappings":";;;cAGa;WACK,SAAS;EAEb,YAAA,OAAO"}
+{"version":3,"file":"AssistantCloudProjects.d.ts","sourceRoot":"","sources":["../src/AssistantCloudProjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAC7D,OAAO,EAAE,4BAA4B,EAAE,0CAAuC;AAE9E,qBAAa,sBAAsB;IACjC,SAAgB,OAAO,EAAE,4BAA4B,CAAC;gBAE1C,KAAK,EAAE,iBAAiB;CAGrC"}

package/dist/AssistantCloudRuns.d.ts

@@ -1,67 +1,78 @@
-import { AssistantCloudRunReportToolCall } from "./runTelemetry.js";
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import type { AssistantCloudRunReportToolCall } from "./runTelemetry.js";
 import { AssistantStream } from "assistant-stream";
-//#region src/AssistantCloudRuns.d.ts
 type AssistantCloudRunsStreamBody = {
-  thread_id: string;
-  assistant_id: "system/thread_title";
-  messages: readonly unknown[];
+    thread_id: string;
+    assistant_id: "system/thread_title";
+    messages: readonly unknown[];
 };
-type AssistantCloudRunReport = {
-  thread_id: string;
-  status: "completed" | "incomplete" | "error";
-  outcome_type?: "aborted" | "disconnected" | "length" | "content_filter";
-  message_id?: string;
-  first_token_ms?: number;
-  release?: string;
-  environment?: string;
-  tags?: string[];
-  provider?: string;
-  trace_id?: string;
-  error_code?: string;
-  error?: string;
-  total_steps?: number;
-  tool_calls?: AssistantCloudRunReportToolCall[];
-  steps?: {
+export type AssistantCloudRunReport = {
+    thread_id: string;
+    status: "completed" | "incomplete" | "error";
+    outcome_type?: "rate_limited" | "validation_failed" | "provider_error" | "server_error" | "budget_denied" | "persistence_error" | "aborted" | "timeout" | "disconnected" | "length" | "content_filter";
+    message_id?: string;
+    first_token_ms?: number;
+    release?: string;
+    environment?: string;
+    tags?: string[];
+    provider?: string;
+    trace_id?: string;
+    root_span_id?: string;
+    error_code?: string;
+    error?: string;
+    total_steps?: number;
+    tool_calls?: AssistantCloudRunReportToolCall[];
+    steps?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        reasoning_tokens?: number;
+        cached_input_tokens?: number;
+        tool_calls?: AssistantCloudRunReportToolCall[];
+        start_ms?: number;
+        end_ms?: number;
+        finish_reason?: string;
+        input?: string;
+    }[];
     input_tokens?: number;
     output_tokens?: number;
     reasoning_tokens?: number;
     cached_input_tokens?: number;
-    tool_calls?: AssistantCloudRunReportToolCall[];
-    start_ms?: number;
-    end_ms?: number;
-    finish_reason?: string;
-  }[];
-  input_tokens?: number;
-  output_tokens?: number;
-  reasoning_tokens?: number;
-  cached_input_tokens?: number;
-  model_id?: string;
-  provider_type?: string;
-  duration_ms?: number;
-  output_text?: string;
-  metadata?: Record<string, unknown>;
+    cost_usd?: number;
+    cost_details?: {
+        input?: number;
+        input_cached_tokens?: number;
+        output?: number;
+        total?: number;
+    };
+    model_id?: string;
+    provider_type?: string;
+    duration_ms?: number;
+    output_text?: string;
+    attributes?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
 };
-declare class AssistantCloudRuns {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  __internal_getAssistantOptions(assistantId: string): {
-    api: string;
-    headers: () => Promise<{
-      Accept: string;
-      "Aui-Sdk": string;
-    }>;
-    body: {
-      assistant_id: string;
-      response_format: string;
-      thread_id: string;
+export declare class AssistantCloudRuns {
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    __internal_getAssistantOptions(assistantId: string): {
+        api: string;
+        protocol: "ui-message-stream";
+        headers: () => Promise<{
+            Accept: string;
+            "Aui-Sdk": string;
+        }>;
+        body: (options?: {
+            threadId?: string;
+        }) => Promise<{
+            assistant_id: string;
+            response_format: string;
+            thread_id: string;
+        }>;
     };
-  };
-  stream(body: AssistantCloudRunsStreamBody): Promise<AssistantStream>;
-  report(body: AssistantCloudRunReport): Promise<{
-    run_id: string;
-  }>;
+    stream(body: AssistantCloudRunsStreamBody): Promise<AssistantStream>;
+    report(body: AssistantCloudRunReport): Promise<{
+        run_id: string;
+    }>;
 }
-//#endregion
-export { AssistantCloudRunReport, AssistantCloudRuns };
+export {};
 //# sourceMappingURL=AssistantCloudRuns.d.ts.map

package/dist/AssistantCloudRuns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudRuns.d.ts","names":[],"sources":["../src/AssistantCloudRuns.ts"],"mappings":";;;;KASK;EACH;EACA;EACA;;KAMU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;EACb;IACE;IACA;IACA;IACA;IACA,aAAa;IACb;IACA;IACA;;EAEF;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;;cAGA;UACH;EAEI,YAAA,OAAO;EAIZ,+BAA+B;;;;;;;;;;;;EAoBzB,OACX,MAAM,+BACL,QAAQ;EAkCE,OACX,MAAM,0BACL;IAAU"}
+{"version":3,"file":"AssistantCloudRuns.d.ts","sourceRoot":"","sources":["../src/AssistantCloudRuns.ts"],"names":[],"mappings":"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"}

package/dist/AssistantCloudRuns.js

@@ -9,6 +9,7 @@ var AssistantCloudRuns = class {
 	__internal_getAssistantOptions(assistantId) {
 		return {
 			api: `${this.cloud._baseUrl}/v1/runs/stream`,
+			protocol: "ui-message-stream",
 			headers: async () => {
 				const headers = await this.cloud._auth.getAuthHeaders();
 				if (!headers) throw new Error("Authorization failed");
@@ -18,10 +19,14 @@ var AssistantCloudRuns = class {
 					"Aui-Sdk": this.cloud.sdkHeader()
 				};
 			},
-			body: {
-				assistant_id: assistantId,
-				response_format: "vercel-ai-data-stream/v1",
-				thread_id: "unstable_todo"
+			body: async (options) => {
+				const threadId = options?.threadId;
+				if (threadId === void 0) throw new Error("Assistant Cloud runs need a thread; the thread list adapter has not assigned a remote id to this thread yet.");
+				return {
+					assistant_id: assistantId,
+					response_format: "vercel-ai-data-stream/v1",
+					thread_id: threadId
+				};
 			}
 		};
 	}

package/dist/AssistantCloudRuns.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudRuns.js","names":[],"sources":["../src/AssistantCloudRuns.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport type { AssistantCloudRunReportToolCall } from \"./runTelemetry\";\nimport { AssistantStream, PlainTextDecoder } from \"assistant-stream\";\nimport {\n  CloudResponseError,\n  readCloudRecord,\n  readCloudString,\n} from \"./cloudResponse\";\n\ntype AssistantCloudRunsStreamBody = {\n  thread_id: string;\n  assistant_id: \"system/thread_title\";\n  messages: readonly unknown[]; // TODO type\n};\n\n// NOTE: Keep this payload shape aligned with the strict runtime validator in\n// assistant-cloud: apps/api/src/endpoints/runs/create.ts\n// (createRunSchema). New telemetry fields must be added in both repos together.\nexport type AssistantCloudRunReport = {\n  thread_id: string;\n  status: \"completed\" | \"incomplete\" | \"error\";\n  outcome_type?: \"aborted\" | \"disconnected\" | \"length\" | \"content_filter\";\n  message_id?: string;\n  first_token_ms?: number;\n  release?: string;\n  environment?: string;\n  tags?: string[];\n  provider?: string;\n  trace_id?: string;\n  error_code?: string;\n  error?: string;\n  total_steps?: number;\n  tool_calls?: AssistantCloudRunReportToolCall[];\n  steps?: {\n    input_tokens?: number;\n    output_tokens?: number;\n    reasoning_tokens?: number;\n    cached_input_tokens?: number;\n    tool_calls?: AssistantCloudRunReportToolCall[];\n    start_ms?: number;\n    end_ms?: number;\n    finish_reason?: string;\n  }[];\n  input_tokens?: number;\n  output_tokens?: number;\n  reasoning_tokens?: number;\n  cached_input_tokens?: number;\n  model_id?: string;\n  provider_type?: string;\n  duration_ms?: number;\n  output_text?: string;\n  metadata?: Record<string, unknown>;\n};\n\nexport class AssistantCloudRuns {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public __internal_getAssistantOptions(assistantId: string) {\n    return {\n      api: `${this.cloud._baseUrl}/v1/runs/stream`,\n      headers: async () => {\n        const headers = await this.cloud._auth.getAuthHeaders();\n        if (!headers) throw new Error(\"Authorization failed\");\n        return {\n          ...headers,\n          Accept: \"text/plain\",\n          \"Aui-Sdk\": this.cloud.sdkHeader(),\n        };\n      },\n      body: {\n        assistant_id: assistantId,\n        response_format: \"vercel-ai-data-stream/v1\",\n        thread_id: \"unstable_todo\",\n      },\n    };\n  }\n\n  public async stream(\n    body: AssistantCloudRunsStreamBody,\n  ): Promise<AssistantStream> {\n    const response = await this.cloud.makeRawRequest(\"/runs/stream\", {\n      method: \"POST\",\n      headers: {\n        Accept: \"text/plain\",\n      },\n      body,\n    });\n\n    if (!response.body) {\n      throw new CloudResponseError(\n        'Invalid Assistant Cloud response for \"run stream\": expected a response body',\n      );\n    }\n\n    const receivedContentType = response.headers.get(\"content-type\");\n    const contentType = receivedContentType\n      ?.split(\";\", 1)[0]\n      ?.trim()\n      .toLowerCase();\n    if (contentType !== \"text/plain\") {\n      await response.body.cancel().catch(() => undefined);\n      throw new CloudResponseError(\n        `Invalid Assistant Cloud response for \"run stream\": expected a \"text/plain\" content type, received ${\n          receivedContentType\n            ? `\"${receivedContentType}\"`\n            : \"no Content-Type header\"\n        }`,\n      );\n    }\n\n    return AssistantStream.fromResponse(response, new PlainTextDecoder());\n  }\n\n  public async report(\n    body: AssistantCloudRunReport,\n  ): Promise<{ run_id: string }> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/runs\", { method: \"POST\", body }),\n      \"run report response\",\n    );\n\n    return { run_id: readCloudString(response.run_id, \"run_id\") };\n  }\n}\n"],"mappings":";;;AAsDA,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,+BAAsC,aAAqB;EACzD,OAAO;GACL,KAAK,GAAG,KAAK,MAAM,SAAS;GAC5B,SAAS,YAAY;IACnB,MAAM,UAAU,MAAM,KAAK,MAAM,MAAM,eAAe;IACtD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,sBAAsB;IACpD,OAAO;KACL,GAAG;KACH,QAAQ;KACR,WAAW,KAAK,MAAM,UAAU;IAClC;GACF;GACA,MAAM;IACJ,cAAc;IACd,iBAAiB;IACjB,WAAW;GACb;EACF;CACF;CAEA,MAAa,OACX,MAC0B;EAC1B,MAAM,WAAW,MAAM,KAAK,MAAM,eAAe,gBAAgB;GAC/D,QAAQ;GACR,SAAS,EACP,QAAQ,aACV;GACA;EACF,CAAC;EAED,IAAI,CAAC,SAAS,MACZ,MAAM,IAAI,mBACR,+EACF;EAGF,MAAM,sBAAsB,SAAS,QAAQ,IAAI,cAAc;EAK/D,IAJoB,qBAChB,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,EAChB,KAAK,CAAC,CACP,YAAY,MACK,cAAc;GAChC,MAAM,SAAS,KAAK,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;GAClD,MAAM,IAAI,mBACR,qGACE,sBACI,IAAI,oBAAoB,KACxB,0BAER;EACF;EAEA,OAAO,gBAAgB,aAAa,UAAU,IAAI,iBAAiB,CAAC;CACtE;CAEA,MAAa,OACX,MAC6B;EAC7B,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,SAAS;GAAE,QAAQ;GAAQ;EAAK,CAAC,GAC9D,qBACF;EAEA,OAAO,EAAE,QAAQ,gBAAgB,SAAS,QAAQ,QAAQ,EAAE;CAC9D;AACF"}
+{"version":3,"file":"AssistantCloudRuns.js","names":[],"sources":["../src/AssistantCloudRuns.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport type { AssistantCloudRunReportToolCall } from \"./runTelemetry\";\nimport { AssistantStream, PlainTextDecoder } from \"assistant-stream\";\nimport {\n  CloudResponseError,\n  readCloudRecord,\n  readCloudString,\n} from \"./cloudResponse\";\n\ntype AssistantCloudRunsStreamBody = {\n  thread_id: string;\n  assistant_id: \"system/thread_title\";\n  messages: readonly unknown[]; // TODO type\n};\n\n// NOTE: Keep this payload shape aligned with the strict runtime validator in\n// assistant-cloud: apps/api/src/endpoints/runs/create.ts\n// (createRunSchema). New telemetry fields must be added in both repos together.\nexport type AssistantCloudRunReport = {\n  thread_id: string;\n  status: \"completed\" | \"incomplete\" | \"error\";\n  outcome_type?:\n    | \"rate_limited\"\n    | \"validation_failed\"\n    | \"provider_error\"\n    | \"server_error\"\n    | \"budget_denied\"\n    | \"persistence_error\"\n    | \"aborted\"\n    | \"timeout\"\n    | \"disconnected\"\n    | \"length\"\n    | \"content_filter\";\n  message_id?: string;\n  first_token_ms?: number;\n  release?: string;\n  environment?: string;\n  tags?: string[];\n  provider?: string;\n  trace_id?: string;\n  root_span_id?: string;\n  error_code?: string;\n  error?: string;\n  total_steps?: number;\n  tool_calls?: AssistantCloudRunReportToolCall[];\n  steps?: {\n    input_tokens?: number;\n    output_tokens?: number;\n    reasoning_tokens?: number;\n    cached_input_tokens?: number;\n    tool_calls?: AssistantCloudRunReportToolCall[];\n    start_ms?: number;\n    end_ms?: number;\n    finish_reason?: string;\n    input?: string;\n  }[];\n  input_tokens?: number;\n  output_tokens?: number;\n  reasoning_tokens?: number;\n  cached_input_tokens?: number;\n  cost_usd?: number;\n  cost_details?: {\n    input?: number;\n    input_cached_tokens?: number;\n    output?: number;\n    total?: number;\n  };\n  model_id?: string;\n  provider_type?: string;\n  duration_ms?: number;\n  output_text?: string;\n  attributes?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n};\n\nexport class AssistantCloudRuns {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public __internal_getAssistantOptions(assistantId: string) {\n    return {\n      api: `${this.cloud._baseUrl}/v1/runs/stream`,\n      protocol: \"ui-message-stream\" as const,\n      headers: async () => {\n        const headers = await this.cloud._auth.getAuthHeaders();\n        if (!headers) throw new Error(\"Authorization failed\");\n        return {\n          ...headers,\n          Accept: \"text/plain\",\n          \"Aui-Sdk\": this.cloud.sdkHeader(),\n        };\n      },\n      body: async (options?: { threadId?: string }) => {\n        const threadId = options?.threadId;\n        if (threadId === undefined) {\n          throw new Error(\n            \"Assistant Cloud runs need a thread; the thread list adapter has not assigned a remote id to this thread yet.\",\n          );\n        }\n        return {\n          assistant_id: assistantId,\n          response_format: \"vercel-ai-data-stream/v1\",\n          thread_id: threadId,\n        };\n      },\n    };\n  }\n\n  public async stream(\n    body: AssistantCloudRunsStreamBody,\n  ): Promise<AssistantStream> {\n    const response = await this.cloud.makeRawRequest(\"/runs/stream\", {\n      method: \"POST\",\n      headers: {\n        Accept: \"text/plain\",\n      },\n      body,\n    });\n\n    if (!response.body) {\n      throw new CloudResponseError(\n        'Invalid Assistant Cloud response for \"run stream\": expected a response body',\n      );\n    }\n\n    const receivedContentType = response.headers.get(\"content-type\");\n    const contentType = receivedContentType\n      ?.split(\";\", 1)[0]\n      ?.trim()\n      .toLowerCase();\n    if (contentType !== \"text/plain\") {\n      await response.body.cancel().catch(() => undefined);\n      throw new CloudResponseError(\n        `Invalid Assistant Cloud response for \"run stream\": expected a \"text/plain\" content type, received ${\n          receivedContentType\n            ? `\"${receivedContentType}\"`\n            : \"no Content-Type header\"\n        }`,\n      );\n    }\n\n    return AssistantStream.fromResponse(response, new PlainTextDecoder());\n  }\n\n  public async report(\n    body: AssistantCloudRunReport,\n  ): Promise<{ run_id: string }> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/runs\", { method: \"POST\", body }),\n      \"run report response\",\n    );\n\n    return { run_id: readCloudString(response.run_id, \"run_id\") };\n  }\n}\n"],"mappings":";;;AA2EA,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,+BAAsC,aAAqB;EACzD,OAAO;GACL,KAAK,GAAG,KAAK,MAAM,SAAS;GAC5B,UAAU;GACV,SAAS,YAAY;IACnB,MAAM,UAAU,MAAM,KAAK,MAAM,MAAM,eAAe;IACtD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,sBAAsB;IACpD,OAAO;KACL,GAAG;KACH,QAAQ;KACR,WAAW,KAAK,MAAM,UAAU;IAClC;GACF;GACA,MAAM,OAAO,YAAoC;IAC/C,MAAM,WAAW,SAAS;IAC1B,IAAI,aAAa,KAAA,GACf,MAAM,IAAI,MACR,8GACF;IAEF,OAAO;KACL,cAAc;KACd,iBAAiB;KACjB,WAAW;IACb;GACF;EACF;CACF;CAEA,MAAa,OACX,MAC0B;EAC1B,MAAM,WAAW,MAAM,KAAK,MAAM,eAAe,gBAAgB;GAC/D,QAAQ;GACR,SAAS,EACP,QAAQ,aACV;GACA;EACF,CAAC;EAED,IAAI,CAAC,SAAS,MACZ,MAAM,IAAI,mBACR,+EACF;EAGF,MAAM,sBAAsB,SAAS,QAAQ,IAAI,cAAc;EAK/D,IAJoB,qBAChB,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,EAChB,KAAK,CAAC,CACP,YAAY,MACK,cAAc;GAChC,MAAM,SAAS,KAAK,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;GAClD,MAAM,IAAI,mBACR,qGACE,sBACI,IAAI,oBAAoB,KACxB,0BAER;EACF;EAEA,OAAO,gBAAgB,aAAa,UAAU,IAAI,iBAAiB,CAAC;CACtE;CAEA,MAAa,OACX,MAC6B;EAC7B,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,SAAS;GAAE,QAAQ;GAAQ;EAAK,CAAC,GAC9D,qBACF;EAEA,OAAO,EAAE,QAAQ,gBAAgB,SAAS,QAAQ,QAAQ,EAAE;CAC9D;AACF"}