assistant-cloud 0.1.43 → 0.2.1

package/dist/AssistantCloudEvents.js

@@ -0,0 +1,119 @@
+//#region src/AssistantCloudEvents.ts
+const FLUSH_SIZE = 20;
+const MAX_BATCH_SIZE = 50;
+const FLUSH_DELAY_MS = 2e3;
+var AssistantCloudEvents = class {
+	buffer = [];
+	timer;
+	flushing;
+	cloud;
+	isEnabled;
+	listening = false;
+	constructor(cloud, isEnabled) {
+		this.cloud = cloud;
+		this.isEnabled = isEnabled;
+	}
+	track(event) {
+		if (!this.isEnabled()) return;
+		this.listen();
+		this.buffer.push(normalizeEvent(event));
+		if (this.buffer.length >= FLUSH_SIZE) {
+			this.flush();
+			return;
+		}
+		this.scheduleFlush();
+	}
+	listen() {
+		if (this.listening || typeof window === "undefined" || typeof document === "undefined") return;
+		this.listening = true;
+		window.addEventListener("pagehide", this.flush);
+		document.addEventListener("visibilitychange", this.onVisibilityChange);
+	}
+	unlisten() {
+		if (!this.listening) return;
+		this.listening = false;
+		window.removeEventListener("pagehide", this.flush);
+		document.removeEventListener("visibilitychange", this.onVisibilityChange);
+	}
+	dispose() {
+		this.unlisten();
+		this.clearFlushTimer();
+		this.flush();
+	}
+	onVisibilityChange = () => {
+		if (document.visibilityState === "hidden") this.flush();
+	};
+	flush = async () => {
+		if (!this.isEnabled()) {
+			this.buffer = [];
+			this.clearFlushTimer();
+			this.unlisten();
+			return;
+		}
+		if (this.flushing) return this.flushing;
+		this.clearFlushTimer();
+		const task = this.flushPending();
+		this.flushing = task;
+		task.then(() => {
+			if (this.flushing !== task) return;
+			this.flushing = void 0;
+			if (this.buffer.length === 0) {
+				this.clearFlushTimer();
+				this.unlisten();
+			} else this.flush();
+		});
+		return task;
+	};
+	async flushPending() {
+		while (this.buffer.length > 0) {
+			if (!this.isEnabled()) {
+				this.buffer = [];
+				return;
+			}
+			const events = this.buffer.splice(0, MAX_BATCH_SIZE);
+			try {
+				await this.cloud.makeRequest("/events", {
+					method: "POST",
+					body: { events },
+					keepalive: true
+				});
+			} catch {}
+		}
+	}
+	scheduleFlush() {
+		if (this.timer !== void 0) return;
+		this.timer = setTimeout(() => {
+			this.timer = void 0;
+			this.flush();
+		}, FLUSH_DELAY_MS);
+	}
+	clearFlushTimer() {
+		if (this.timer === void 0) return;
+		clearTimeout(this.timer);
+		this.timer = void 0;
+	}
+};
+const normalizeEvent = (event) => {
+	const props = normalizeProps(event.props);
+	return {
+		kind: event.kind,
+		...normalizeId(event.thread_id) ? { thread_id: event.thread_id } : {},
+		...normalizeId(event.message_id) ? { message_id: event.message_id } : {},
+		...normalizeId(event.run_id) ? { run_id: event.run_id } : {},
+		...isNonNegativeInteger(event.value) ? { value: event.value } : {},
+		...props ? { props } : {}
+	};
+};
+const normalizeId = (value) => value && value.length <= 48 ? value : void 0;
+const isNonNegativeInteger = (value) => value !== void 0 && Number.isInteger(value) && value >= 0;
+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;
+	const value = Object.fromEntries(entries);
+	return new TextEncoder().encode(JSON.stringify(value)).byteLength <= 1024 ? value : void 0;
+};
+//#endregion
+export { AssistantCloudEvents };
+
+//# sourceMappingURL=AssistantCloudEvents.js.map

package/dist/AssistantCloudEvents.js.map

@@ -0,0 +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":";AA6BA,MAAM,aAAa;AACnB,MAAM,iBAAiB;AACvB,MAAM,iBAAiB;AAEvB,IAAa,uBAAb,MAAkC;CAChC,SAAwC,CAAC;CACzC;CACA;CAEA;CACA;CAEA,YAAoB;CAEpB,YAAY,OAA0B,WAA0B;EAC9D,KAAK,QAAQ;EACb,KAAK,YAAY;CACnB;CAEA,MAAa,OAAkC;EAC7C,IAAI,CAAC,KAAK,UAAU,GAAG;EAEvB,KAAK,OAAO;EACZ,KAAK,OAAO,KAAK,eAAe,KAAK,CAAC;EACtC,IAAI,KAAK,OAAO,UAAU,YAAY;GACpC,KAAU,MAAM;GAChB;EACF;EAEA,KAAK,cAAc;CACrB;CAEA,SAAuB;EACrB,IACE,KAAK,aACL,OAAO,WAAW,eAClB,OAAO,aAAa,aAEpB;EAEF,KAAK,YAAY;EACjB,OAAO,iBAAiB,YAAY,KAAK,KAAK;EAC9C,SAAS,iBAAiB,oBAAoB,KAAK,kBAAkB;CACvE;CAEA,WAAyB;EACvB,IAAI,CAAC,KAAK,WAAW;EACrB,KAAK,YAAY;EACjB,OAAO,oBAAoB,YAAY,KAAK,KAAK;EACjD,SAAS,oBAAoB,oBAAoB,KAAK,kBAAkB;CAC1E;CAEA,UAAuB;EACrB,KAAK,SAAS;EACd,KAAK,gBAAgB;EACrB,KAAU,MAAM;CAClB;CAEA,2BAAmC;EACjC,IAAI,SAAS,oBAAoB,UAC/B,KAAU,MAAM;CAEpB;CAEA,QAAgB,YAA2B;EACzC,IAAI,CAAC,KAAK,UAAU,GAAG;GACrB,KAAK,SAAS,CAAC;GACf,KAAK,gBAAgB;GACrB,KAAK,SAAS;GACd;EACF;EACA,IAAI,KAAK,UAAU,OAAO,KAAK;EAE/B,KAAK,gBAAgB;EACrB,MAAM,OAAO,KAAK,aAAa;EAC/B,KAAK,WAAW;EAChB,KAAU,WAAW;GACnB,IAAI,KAAK,aAAa,MAAM;GAC5B,KAAK,WAAW,KAAA;GAChB,IAAI,KAAK,OAAO,WAAW,GAAG;IAC5B,KAAK,gBAAgB;IACrB,KAAK,SAAS;GAChB,OACE,KAAU,MAAM;EAEpB,CAAC;EACD,OAAO;CACT;CAEA,MAAc,eAA8B;EAC1C,OAAO,KAAK,OAAO,SAAS,GAAG;GAC7B,IAAI,CAAC,KAAK,UAAU,GAAG;IACrB,KAAK,SAAS,CAAC;IACf;GACF;GAEA,MAAM,SAAS,KAAK,OAAO,OAAO,GAAG,cAAc;GACnD,IAAI;IACF,MAAM,KAAK,MAAM,YAAY,WAAW;KACtC,QAAQ;KACR,MAAM,EAAE,OAAO;KACf,WAAW;IACb,CAAC;GACH,QAAQ,CAAC;EACX;CACF;CAEA,gBAAwB;EACtB,IAAI,KAAK,UAAU,KAAA,GAAW;EAC9B,KAAK,QAAQ,iBAAiB;GAC5B,KAAK,QAAQ,KAAA;GACb,KAAU,MAAM;EAClB,GAAG,cAAc;CACnB;CAEA,kBAA0B;EACxB,IAAI,KAAK,UAAU,KAAA,GAAW;EAC9B,aAAa,KAAK,KAAK;EACvB,KAAK,QAAQ,KAAA;CACf;AACF;AAEA,MAAM,kBAAkB,UAAoD;CAC1E,MAAM,QAAQ,eAAe,MAAM,KAAK;CACxC,OAAO;EACL,MAAM,MAAM;EACZ,GAAI,YAAY,MAAM,SAAS,IAAI,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;EACrE,GAAI,YAAY,MAAM,UAAU,IAAI,EAAE,YAAY,MAAM,WAAW,IAAI,CAAC;EACxE,GAAI,YAAY,MAAM,MAAM,IAAI,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;EAC5D,GAAI,qBAAqB,MAAM,KAAK,IAAI,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAClE,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC3B;AACF;AAEA,MAAM,eAAe,UACnB,SAAS,MAAM,UAAU,KAAK,QAAQ,KAAA;AAExC,MAAM,wBAAwB,UAC5B,UAAU,KAAA,KAAa,OAAO,UAAU,KAAK,KAAK,SAAS;AAE7D,MAAM,kBACJ,UACiC;CACjC,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,MAAM,UAAU,OAAO,QAAQ,KAAK;CACpC,IACE,QAAQ,MACL,GAAG,WACD,OAAO,UAAU,YAAY,MAAM,SAAS,OAC5C,OAAO,UAAU,YAChB,OAAO,UAAU,YACjB,OAAO,UAAU,SACvB,GAEA;CAEF,MAAM,QAAQ,OAAO,YAAY,OAAO;CACxC,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,UAAU,KAAK,CAAC,CAAC,CAAC,cAAc,OACjE,QACA,KAAA;AACN"}

package/dist/AssistantCloudFiles.d.ts

@@ -17,13 +17,24 @@ type GeneratePresignedUploadUrlResponse = {
   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: {
+    key: string;
+  } | {
+    url: string;
+  }): Promise<GeneratePresignedDownloadUrlResponse>;
 }
 //#endregion
-export { AssistantCloudFiles };
+export { AssistantCloudFiles, GeneratePresignedDownloadUrlResponse };
 //# 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;;cAGW;UACH;EAEI,YAAA,OAAO;EAIN,YACX,MAAM,yBACL,QAAQ;EAyBE,2BACX,MAAM,wCACL,QAAQ"}
+{"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"}

package/dist/AssistantCloudFiles.js

@@ -25,7 +25,19 @@ var AssistantCloudFiles = class {
 			success: readCloudBoolean(response.success, "presigned upload response.success"),
 			signedUrl: readCloudString(response.signedUrl, "presigned upload response.signedUrl"),
 			expiresAt: readCloudString(response.expiresAt, "presigned upload response.expiresAt"),
-			publicUrl: readCloudString(response.publicUrl, "presigned upload response.publicUrl")
+			publicUrl: readCloudString(response.publicUrl, "presigned upload response.publicUrl"),
+			..."key" in response ? { key: readCloudString(response.key, "presigned upload response.key") } : {}
+		};
+	}
+	async generatePresignedDownloadUrl(body) {
+		const response = readCloudRecord(await this.cloud.makeRequest("/files/attachments/generate-presigned-download-url", {
+			method: "POST",
+			body
+		}), "presigned download response");
+		return {
+			signedUrl: readCloudString(response.signedUrl, "presigned download response.signedUrl"),
+			expiresAt: readCloudString(response.expiresAt, "presigned download response.expiresAt"),
+			key: readCloudString(response.key, "presigned download response.key")
 		};
 	}
 };

package/dist/AssistantCloudFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudFiles.js","names":[],"sources":["../src/AssistantCloudFiles.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport {\n  readCloudArray,\n  readCloudBoolean,\n  readCloudRecord,\n  readCloudString,\n} from \"./cloudResponse\";\n\ntype PdfToImagesRequestBody = {\n  file_blob?: string | undefined;\n  file_url?: string | undefined;\n};\n\ntype PdfToImagesResponse = {\n  success: boolean;\n  urls: string[];\n  message: string;\n};\n\ntype GeneratePresignedUploadUrlRequestBody = {\n  filename: string;\n};\n\ntype GeneratePresignedUploadUrlResponse = {\n  success: boolean;\n  signedUrl: string;\n  expiresAt: string;\n  publicUrl: string;\n};\n\nexport class AssistantCloudFiles {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public async pdfToImages(\n    body: PdfToImagesRequestBody,\n  ): Promise<PdfToImagesResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/files/pdf-to-images\", {\n        method: \"POST\",\n        body,\n      }),\n      \"PDF conversion response\",\n    );\n\n    return {\n      success: readCloudBoolean(\n        response.success,\n        \"PDF conversion response.success\",\n      ),\n      urls: readCloudArray(response.urls, \"PDF conversion response.urls\").map(\n        (url, index) =>\n          readCloudString(url, `PDF conversion response.urls[${index}]`),\n      ),\n      message: readCloudString(\n        response.message,\n        \"PDF conversion response.message\",\n      ),\n    };\n  }\n\n  public async generatePresignedUploadUrl(\n    body: GeneratePresignedUploadUrlRequestBody,\n  ): Promise<GeneratePresignedUploadUrlResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        \"/files/attachments/generate-presigned-upload-url\",\n        {\n          method: \"POST\",\n          body,\n        },\n      ),\n      \"presigned upload response\",\n    );\n\n    return {\n      success: readCloudBoolean(\n        response.success,\n        \"presigned upload response.success\",\n      ),\n      signedUrl: readCloudString(\n        response.signedUrl,\n        \"presigned upload response.signedUrl\",\n      ),\n      expiresAt: readCloudString(\n        response.expiresAt,\n        \"presigned upload response.expiresAt\",\n      ),\n      publicUrl: readCloudString(\n        response.publicUrl,\n        \"presigned upload response.publicUrl\",\n      ),\n    };\n  }\n}\n"],"mappings":";;AA8BA,IAAa,sBAAb,MAAiC;CAC/B;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,MAAa,YACX,MAC8B;EAC9B,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,wBAAwB;GACnD,QAAQ;GACR;EACF,CAAC,GACD,yBACF;EAEA,OAAO;GACL,SAAS,iBACP,SAAS,SACT,iCACF;GACA,MAAM,eAAe,SAAS,MAAM,8BAA8B,CAAC,CAAC,KACjE,KAAK,UACJ,gBAAgB,KAAK,gCAAgC,MAAM,EAAE,CACjE;GACA,SAAS,gBACP,SAAS,SACT,iCACF;EACF;CACF;CAEA,MAAa,2BACX,MAC6C;EAC7C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,oDACA;GACE,QAAQ;GACR;EACF,CACF,GACA,2BACF;EAEA,OAAO;GACL,SAAS,iBACP,SAAS,SACT,mCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;EACF;CACF;AACF"}
+{"version":3,"file":"AssistantCloudFiles.js","names":[],"sources":["../src/AssistantCloudFiles.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport {\n  readCloudArray,\n  readCloudBoolean,\n  readCloudRecord,\n  readCloudString,\n} from \"./cloudResponse\";\n\ntype PdfToImagesRequestBody = {\n  file_blob?: string | undefined;\n  file_url?: string | undefined;\n};\n\ntype PdfToImagesResponse = {\n  success: boolean;\n  urls: string[];\n  message: string;\n};\n\ntype GeneratePresignedUploadUrlRequestBody = {\n  filename: string;\n};\n\ntype GeneratePresignedUploadUrlResponse = {\n  success: boolean;\n  signedUrl: string;\n  expiresAt: string;\n  publicUrl: string;\n  key?: string;\n};\n\nexport type GeneratePresignedDownloadUrlResponse = {\n  signedUrl: string;\n  expiresAt: string;\n  key: string;\n};\n\nexport class AssistantCloudFiles {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public async pdfToImages(\n    body: PdfToImagesRequestBody,\n  ): Promise<PdfToImagesResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/files/pdf-to-images\", {\n        method: \"POST\",\n        body,\n      }),\n      \"PDF conversion response\",\n    );\n\n    return {\n      success: readCloudBoolean(\n        response.success,\n        \"PDF conversion response.success\",\n      ),\n      urls: readCloudArray(response.urls, \"PDF conversion response.urls\").map(\n        (url, index) =>\n          readCloudString(url, `PDF conversion response.urls[${index}]`),\n      ),\n      message: readCloudString(\n        response.message,\n        \"PDF conversion response.message\",\n      ),\n    };\n  }\n\n  public async generatePresignedUploadUrl(\n    body: GeneratePresignedUploadUrlRequestBody,\n  ): Promise<GeneratePresignedUploadUrlResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        \"/files/attachments/generate-presigned-upload-url\",\n        {\n          method: \"POST\",\n          body,\n        },\n      ),\n      \"presigned upload response\",\n    );\n\n    return {\n      success: readCloudBoolean(\n        response.success,\n        \"presigned upload response.success\",\n      ),\n      signedUrl: readCloudString(\n        response.signedUrl,\n        \"presigned upload response.signedUrl\",\n      ),\n      expiresAt: readCloudString(\n        response.expiresAt,\n        \"presigned upload response.expiresAt\",\n      ),\n      publicUrl: readCloudString(\n        response.publicUrl,\n        \"presigned upload response.publicUrl\",\n      ),\n      ...(\"key\" in response\n        ? {\n            key: readCloudString(response.key, \"presigned upload response.key\"),\n          }\n        : {}),\n    };\n  }\n\n  public async generatePresignedDownloadUrl(\n    body: { key: string } | { url: string },\n  ): Promise<GeneratePresignedDownloadUrlResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        \"/files/attachments/generate-presigned-download-url\",\n        {\n          method: \"POST\",\n          body,\n        },\n      ),\n      \"presigned download response\",\n    );\n\n    return {\n      signedUrl: readCloudString(\n        response.signedUrl,\n        \"presigned download response.signedUrl\",\n      ),\n      expiresAt: readCloudString(\n        response.expiresAt,\n        \"presigned download response.expiresAt\",\n      ),\n      key: readCloudString(response.key, \"presigned download response.key\"),\n    };\n  }\n}\n"],"mappings":";;AAqCA,IAAa,sBAAb,MAAiC;CAC/B;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,MAAa,YACX,MAC8B;EAC9B,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,wBAAwB;GACnD,QAAQ;GACR;EACF,CAAC,GACD,yBACF;EAEA,OAAO;GACL,SAAS,iBACP,SAAS,SACT,iCACF;GACA,MAAM,eAAe,SAAS,MAAM,8BAA8B,CAAC,CAAC,KACjE,KAAK,UACJ,gBAAgB,KAAK,gCAAgC,MAAM,EAAE,CACjE;GACA,SAAS,gBACP,SAAS,SACT,iCACF;EACF;CACF;CAEA,MAAa,2BACX,MAC6C;EAC7C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,oDACA;GACE,QAAQ;GACR;EACF,CACF,GACA,2BACF;EAEA,OAAO;GACL,SAAS,iBACP,SAAS,SACT,mCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;GACA,WAAW,gBACT,SAAS,WACT,qCACF;GACA,GAAI,SAAS,WACT,EACE,KAAK,gBAAgB,SAAS,KAAK,+BAA+B,EACpE,IACA,CAAC;EACP;CACF;CAEA,MAAa,6BACX,MAC+C;EAC/C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,sDACA;GACE,QAAQ;GACR;EACF,CACF,GACA,6BACF;EAEA,OAAO;GACL,WAAW,gBACT,SAAS,WACT,uCACF;GACA,WAAW,gBACT,SAAS,WACT,uCACF;GACA,KAAK,gBAAgB,SAAS,KAAK,iCAAiC;EACtE;CACF;AACF"}

package/dist/AssistantCloudRuns.d.ts

@@ -10,6 +10,16 @@ type AssistantCloudRunsStreamBody = {
 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?: {
@@ -20,6 +30,7 @@ type AssistantCloudRunReport = {
     tool_calls?: AssistantCloudRunReportToolCall[];
     start_ms?: number;
     end_ms?: number;
+    finish_reason?: string;
   }[];
   input_tokens?: number;
   output_tokens?: number;
@@ -38,6 +49,7 @@ declare class AssistantCloudRuns {
     api: string;
     headers: () => Promise<{
       Accept: string;
+      "Aui-Sdk": string;
     }>;
     body: {
       assistant_id: string;

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,aAAa;EACb;IACE;IACA;IACA;IACA;IACA,aAAa;IACb;IACA;;EAEF;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;;cAGA;UACH;EAEI,YAAA,OAAO;EAIZ,+BAA+B;;;;;;;;;;;EAmBzB,OACX,MAAM,+BACL,QAAQ;EAkCE,OACX,MAAM,0BACL;IAAU"}
+{"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"}

package/dist/AssistantCloudRuns.js

@@ -14,7 +14,8 @@ var AssistantCloudRuns = class {
 				if (!headers) throw new Error("Authorization failed");
 				return {
 					...headers,
-					Accept: "text/plain"
+					Accept: "text/plain",
+					"Aui-Sdk": this.cloud.sdkHeader()
 				};
 			},
 			body: {

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/aui-cloud-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  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  }[];\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        };\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":";;;AA2CA,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;IACV;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?: \"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"}

package/dist/AssistantCloudScores.d.ts

@@ -0,0 +1,27 @@
+import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+//#region src/AssistantCloudScores.d.ts
+type AssistantCloudScoreBody = {
+  name: string;
+  data_type: "numeric" | "categorical" | "boolean";
+  value?: number | boolean;
+  string_value?: string;
+  comment?: string;
+  thread_id?: string;
+  message_id?: string;
+  run_id?: string;
+};
+type AssistantCloudScoreResponse = {
+  score_id: string;
+  name: string;
+  data_type: "numeric" | "categorical" | "boolean";
+  value: number | null;
+  string_value: string | null;
+};
+declare class AssistantCloudScores {
+  private cloud;
+  constructor(cloud: AssistantCloudAPI);
+  create(body: AssistantCloudScoreBody): Promise<AssistantCloudScoreResponse>;
+}
+//#endregion
+export { AssistantCloudScoreBody, AssistantCloudScoreResponse, AssistantCloudScores };
+//# sourceMappingURL=AssistantCloudScores.d.ts.map

package/dist/AssistantCloudScores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantCloudScores.d.ts","names":[],"sources":["../src/AssistantCloudScores.ts"],"mappings":";;KAWY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;;cAGW;UACH;EAEI,YAAA,OAAO;EAIN,OACX,MAAM,0BACL,QAAQ"}

package/dist/AssistantCloudScores.js

@@ -0,0 +1,30 @@
+import { readCloudEnum, readCloudNullableNumber, readCloudNullableString, readCloudRecord, readCloudString } from "./cloudResponse.js";
+//#region src/AssistantCloudScores.ts
+const SCORE_DATA_TYPES = [
+	"numeric",
+	"categorical",
+	"boolean"
+];
+var AssistantCloudScores = class {
+	cloud;
+	constructor(cloud) {
+		this.cloud = cloud;
+	}
+	async create(body) {
+		const response = readCloudRecord(await this.cloud.makeRequest("/scores", {
+			method: "POST",
+			body
+		}), "score response");
+		return {
+			score_id: readCloudString(response.score_id, "score response.score_id"),
+			name: readCloudString(response.name, "score response.name"),
+			data_type: readCloudEnum(response.data_type, "score response.data_type", SCORE_DATA_TYPES),
+			value: readCloudNullableNumber(response.value, "score response.value"),
+			string_value: readCloudNullableString(response.string_value, "score response.string_value")
+		};
+	}
+};
+//#endregion
+export { AssistantCloudScores };
+
+//# sourceMappingURL=AssistantCloudScores.js.map

package/dist/AssistantCloudScores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantCloudScores.js","names":[],"sources":["../src/AssistantCloudScores.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport {\n  readCloudEnum,\n  readCloudNullableNumber,\n  readCloudNullableString,\n  readCloudRecord,\n  readCloudString,\n} from \"./cloudResponse\";\n\nconst SCORE_DATA_TYPES = [\"numeric\", \"categorical\", \"boolean\"] as const;\n\nexport type AssistantCloudScoreBody = {\n  name: string;\n  data_type: \"numeric\" | \"categorical\" | \"boolean\";\n  value?: number | boolean;\n  string_value?: string;\n  comment?: string;\n  thread_id?: string;\n  message_id?: string;\n  run_id?: string;\n};\n\nexport type AssistantCloudScoreResponse = {\n  score_id: string;\n  name: string;\n  data_type: \"numeric\" | \"categorical\" | \"boolean\";\n  value: number | null;\n  string_value: string | null;\n};\n\nexport class AssistantCloudScores {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public async create(\n    body: AssistantCloudScoreBody,\n  ): Promise<AssistantCloudScoreResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/scores\", { method: \"POST\", body }),\n      \"score response\",\n    );\n\n    return {\n      score_id: readCloudString(response.score_id, \"score response.score_id\"),\n      name: readCloudString(response.name, \"score response.name\"),\n      data_type: readCloudEnum(\n        response.data_type,\n        \"score response.data_type\",\n        SCORE_DATA_TYPES,\n      ),\n      value: readCloudNullableNumber(response.value, \"score response.value\"),\n      string_value: readCloudNullableString(\n        response.string_value,\n        \"score response.string_value\",\n      ),\n    };\n  }\n}\n"],"mappings":";;AASA,MAAM,mBAAmB;CAAC;CAAW;CAAe;AAAS;AAqB7D,IAAa,uBAAb,MAAkC;CAChC;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,MAAa,OACX,MACsC;EACtC,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,WAAW;GAAE,QAAQ;GAAQ;EAAK,CAAC,GAChE,gBACF;EAEA,OAAO;GACL,UAAU,gBAAgB,SAAS,UAAU,yBAAyB;GACtE,MAAM,gBAAgB,SAAS,MAAM,qBAAqB;GAC1D,WAAW,cACT,SAAS,WACT,4BACA,gBACF;GACA,OAAO,wBAAwB,SAAS,OAAO,sBAAsB;GACrE,cAAc,wBACZ,SAAS,cACT,6BACF;EACF;CACF;AACF"}

package/dist/AssistantCloudThreadMessages.d.ts

@@ -12,6 +12,8 @@ type CloudMessage = {
 };
 type AssistantCloudThreadMessageListQuery = {
   format?: string;
+  limit?: number;
+  after?: string;
 };
 type AssistantCloudThreadMessageListResponse = {
   messages: CloudMessage[];
@@ -27,6 +29,13 @@ type AssistantCloudMessageCreateResponse = {
 type AssistantCloudThreadMessageUpdateBody = {
   content: ReadonlyJSONObject;
 };
+type AssistantCloudThreadMessageFeedbackBody = {
+  type: "positive" | "negative";
+};
+type AssistantCloudThreadMessageFeedbackResponse = {
+  feedback_id: string;
+  type: "positive" | "negative";
+};
 declare const decodeCloudMessage: (value: unknown, field: string) => CloudMessage;
 declare class AssistantCloudThreadMessages {
   private cloud;
@@ -34,7 +43,8 @@ declare class AssistantCloudThreadMessages {
   list(threadId: string, query?: AssistantCloudThreadMessageListQuery): Promise<AssistantCloudThreadMessageListResponse>;
   create(threadId: string, body: AssistantCloudThreadMessageCreateBody): Promise<AssistantCloudMessageCreateResponse>;
   update(threadId: string, messageId: string, body: AssistantCloudThreadMessageUpdateBody): Promise<void>;
+  feedback(threadId: string, messageId: string, body: AssistantCloudThreadMessageFeedbackBody): Promise<AssistantCloudThreadMessageFeedbackResponse>;
 }
 //#endregion
-export { AssistantCloudThreadMessages, CloudMessage, decodeCloudMessage };
+export { AssistantCloudThreadMessageFeedbackBody, AssistantCloudThreadMessageFeedbackResponse, AssistantCloudThreadMessages, CloudMessage, decodeCloudMessage };
 //# sourceMappingURL=AssistantCloudThreadMessages.d.ts.map

package/dist/AssistantCloudThreadMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudThreadMessages.d.ts","names":[],"sources":["../src/AssistantCloudThreadMessages.ts"],"mappings":";;;KAYY;EACV;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA,SAAS;;KAGN;EACH;;KAGG;EACH,UAAU;;KAGP;EACH;EACA;EACA,SAAS;;KAGN;EACH;;KAGG;EACH,SAAS;;cAGE,qBACX,gBACA,kBACC;cAaU;UACH;EAEI,YAAA,OAAO;EAIN,KACX,kBACA,QAAQ,uCACP,QAAQ;EAiBE,OACX,kBACA,MAAM,wCACL,QAAQ;EAcE,OACX,kBACA,mBACA,MAAM,wCACL"}
+{"version":3,"file":"AssistantCloudThreadMessages.d.ts","names":[],"sources":["../src/AssistantCloudThreadMessages.ts"],"mappings":";;;KAaY;EACV;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA,SAAS;;KAGN;EACH;EACA;EACA;;KAGG;EACH,UAAU;;KAGP;EACH;EACA;EACA,SAAS;;KAGN;EACH;;KAGG;EACH,SAAS;;KAKC;EACV;;KAGU;EACV;EACA;;cAGW,qBACX,gBACA,kBACC;cAaU;UACH;EAEI,YAAA,OAAO;EAIN,KACX,kBACA,QAAQ,uCACP,QAAQ;EAiBE,OACX,kBACA,MAAM,wCACL,QAAQ;EAcE,OACX,kBACA,mBACA,MAAM,wCACL;EAOU,SACX,kBACA,mBACA,MAAM,0CACL,QAAQ"}

package/dist/AssistantCloudThreadMessages.js

@@ -1,5 +1,6 @@
-import { readCloudArray, readCloudInteger, readCloudJSONObject, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp } from "./cloudResponse.js";
+import { readCloudArray, readCloudEnum, readCloudInteger, readCloudJSONObject, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp } from "./cloudResponse.js";
 //#region src/AssistantCloudThreadMessages.ts
+const MESSAGE_FEEDBACK_TYPES = ["positive", "negative"];
 const decodeCloudMessage = (value, field) => {
 	const message = readCloudRecord(value, field);
 	return {
@@ -34,6 +35,16 @@ var AssistantCloudThreadMessages = class {
 			body
 		});
 	}
+	async feedback(threadId, messageId, body) {
+		const response = readCloudRecord(await this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}/messages/${encodeURIComponent(messageId)}/feedback`, {
+			method: "POST",
+			body
+		}), "thread message feedback response");
+		return {
+			feedback_id: readCloudString(response.feedback_id, "feedback_id"),
+			type: readCloudEnum(response.type, "type", MESSAGE_FEEDBACK_TYPES)
+		};
+	}
 };
 //#endregion
 export { AssistantCloudThreadMessages, decodeCloudMessage };

package/dist/AssistantCloudThreadMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudThreadMessages.js","names":[],"sources":["../src/AssistantCloudThreadMessages.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport {\n  readCloudArray,\n  readCloudInteger,\n  readCloudJSONObject,\n  readCloudNullableString,\n  readCloudRecord,\n  readCloudString,\n  readCloudTimestamp,\n} from \"./cloudResponse\";\n\nexport type CloudMessage = {\n  id: string;\n  parent_id: string | null;\n  height: number;\n  created_at: Date;\n  updated_at: Date;\n  format: \"aui/v0\" | string;\n  content: ReadonlyJSONObject;\n};\n\ntype AssistantCloudThreadMessageListQuery = {\n  format?: string;\n};\n\ntype AssistantCloudThreadMessageListResponse = {\n  messages: CloudMessage[];\n};\n\ntype AssistantCloudThreadMessageCreateBody = {\n  parent_id: string | null;\n  format: \"aui/v0\" | string;\n  content: ReadonlyJSONObject;\n};\n\ntype AssistantCloudMessageCreateResponse = {\n  message_id: string;\n};\n\ntype AssistantCloudThreadMessageUpdateBody = {\n  content: ReadonlyJSONObject;\n};\n\nexport const decodeCloudMessage = (\n  value: unknown,\n  field: string,\n): CloudMessage => {\n  const message = readCloudRecord(value, field);\n  return {\n    id: readCloudString(message.id, `${field}.id`),\n    parent_id: readCloudNullableString(message.parent_id, `${field}.parent_id`),\n    height: readCloudInteger(message.height, `${field}.height`),\n    created_at: readCloudTimestamp(message.created_at, `${field}.created_at`),\n    updated_at: readCloudTimestamp(message.updated_at, `${field}.updated_at`),\n    format: readCloudString(message.format, `${field}.format`),\n    content: readCloudJSONObject(message.content, `${field}.content`),\n  };\n};\n\nexport class AssistantCloudThreadMessages {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public async list(\n    threadId: string,\n    query?: AssistantCloudThreadMessageListQuery,\n  ): Promise<AssistantCloudThreadMessageListResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        `/threads/${encodeURIComponent(threadId)}/messages`,\n        { query },\n      ),\n      \"thread message list response\",\n    );\n    const messages = readCloudArray(response.messages, \"messages\");\n\n    return {\n      messages: messages.map((message, index) =>\n        decodeCloudMessage(message, `messages[${index}]`),\n      ),\n    };\n  }\n\n  public async create(\n    threadId: string,\n    body: AssistantCloudThreadMessageCreateBody,\n  ): Promise<AssistantCloudMessageCreateResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        `/threads/${encodeURIComponent(threadId)}/messages`,\n        { method: \"POST\", body },\n      ),\n      \"thread message create response\",\n    );\n\n    return {\n      message_id: readCloudString(response.message_id, \"message_id\"),\n    };\n  }\n\n  public async update(\n    threadId: string,\n    messageId: string,\n    body: AssistantCloudThreadMessageUpdateBody,\n  ): Promise<void> {\n    return this.cloud.makeRequest(\n      `/threads/${encodeURIComponent(threadId)}/messages/${encodeURIComponent(messageId)}`,\n      { method: \"PUT\", body },\n    );\n  }\n}\n"],"mappings":";;AA4CA,MAAa,sBACX,OACA,UACiB;CACjB,MAAM,UAAU,gBAAgB,OAAO,KAAK;CAC5C,OAAO;EACL,IAAI,gBAAgB,QAAQ,IAAI,GAAG,MAAM,IAAI;EAC7C,WAAW,wBAAwB,QAAQ,WAAW,GAAG,MAAM,WAAW;EAC1E,QAAQ,iBAAiB,QAAQ,QAAQ,GAAG,MAAM,QAAQ;EAC1D,YAAY,mBAAmB,QAAQ,YAAY,GAAG,MAAM,YAAY;EACxE,YAAY,mBAAmB,QAAQ,YAAY,GAAG,MAAM,YAAY;EACxE,QAAQ,gBAAgB,QAAQ,QAAQ,GAAG,MAAM,QAAQ;EACzD,SAAS,oBAAoB,QAAQ,SAAS,GAAG,MAAM,SAAS;CAClE;AACF;AAEA,IAAa,+BAAb,MAA0C;CACxC;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,MAAa,KACX,UACA,OACkD;EAClD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,YAAY,mBAAmB,QAAQ,EAAE,YACzC,EAAE,MAAM,CACV,GACA,8BACF;EAGA,OAAO,EACL,UAHe,eAAe,SAAS,UAAU,UAGhC,CAAC,CAAC,KAAK,SAAS,UAC/B,mBAAmB,SAAS,YAAY,MAAM,EAAE,CAClD,EACF;CACF;CAEA,MAAa,OACX,UACA,MAC8C;EAC9C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,YAAY,mBAAmB,QAAQ,EAAE,YACzC;GAAE,QAAQ;GAAQ;EAAK,CACzB,GACA,gCACF;EAEA,OAAO,EACL,YAAY,gBAAgB,SAAS,YAAY,YAAY,EAC/D;CACF;CAEA,MAAa,OACX,UACA,WACA,MACe;EACf,OAAO,KAAK,MAAM,YAChB,YAAY,mBAAmB,QAAQ,EAAE,YAAY,mBAAmB,SAAS,KACjF;GAAE,QAAQ;GAAO;EAAK,CACxB;CACF;AACF"}
+{"version":3,"file":"AssistantCloudThreadMessages.js","names":[],"sources":["../src/AssistantCloudThreadMessages.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport {\n  readCloudArray,\n  readCloudEnum,\n  readCloudInteger,\n  readCloudJSONObject,\n  readCloudNullableString,\n  readCloudRecord,\n  readCloudString,\n  readCloudTimestamp,\n} from \"./cloudResponse\";\n\nexport type CloudMessage = {\n  id: string;\n  parent_id: string | null;\n  height: number;\n  created_at: Date;\n  updated_at: Date;\n  format: \"aui/v0\" | string;\n  content: ReadonlyJSONObject;\n};\n\ntype AssistantCloudThreadMessageListQuery = {\n  format?: string;\n  limit?: number;\n  after?: string;\n};\n\ntype AssistantCloudThreadMessageListResponse = {\n  messages: CloudMessage[];\n};\n\ntype AssistantCloudThreadMessageCreateBody = {\n  parent_id: string | null;\n  format: \"aui/v0\" | string;\n  content: ReadonlyJSONObject;\n};\n\ntype AssistantCloudMessageCreateResponse = {\n  message_id: string;\n};\n\ntype AssistantCloudThreadMessageUpdateBody = {\n  content: ReadonlyJSONObject;\n};\n\nconst MESSAGE_FEEDBACK_TYPES = [\"positive\", \"negative\"] as const;\n\nexport type AssistantCloudThreadMessageFeedbackBody = {\n  type: \"positive\" | \"negative\";\n};\n\nexport type AssistantCloudThreadMessageFeedbackResponse = {\n  feedback_id: string;\n  type: \"positive\" | \"negative\";\n};\n\nexport const decodeCloudMessage = (\n  value: unknown,\n  field: string,\n): CloudMessage => {\n  const message = readCloudRecord(value, field);\n  return {\n    id: readCloudString(message.id, `${field}.id`),\n    parent_id: readCloudNullableString(message.parent_id, `${field}.parent_id`),\n    height: readCloudInteger(message.height, `${field}.height`),\n    created_at: readCloudTimestamp(message.created_at, `${field}.created_at`),\n    updated_at: readCloudTimestamp(message.updated_at, `${field}.updated_at`),\n    format: readCloudString(message.format, `${field}.format`),\n    content: readCloudJSONObject(message.content, `${field}.content`),\n  };\n};\n\nexport class AssistantCloudThreadMessages {\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n  }\n\n  public async list(\n    threadId: string,\n    query?: AssistantCloudThreadMessageListQuery,\n  ): Promise<AssistantCloudThreadMessageListResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        `/threads/${encodeURIComponent(threadId)}/messages`,\n        { query },\n      ),\n      \"thread message list response\",\n    );\n    const messages = readCloudArray(response.messages, \"messages\");\n\n    return {\n      messages: messages.map((message, index) =>\n        decodeCloudMessage(message, `messages[${index}]`),\n      ),\n    };\n  }\n\n  public async create(\n    threadId: string,\n    body: AssistantCloudThreadMessageCreateBody,\n  ): Promise<AssistantCloudMessageCreateResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        `/threads/${encodeURIComponent(threadId)}/messages`,\n        { method: \"POST\", body },\n      ),\n      \"thread message create response\",\n    );\n\n    return {\n      message_id: readCloudString(response.message_id, \"message_id\"),\n    };\n  }\n\n  public async update(\n    threadId: string,\n    messageId: string,\n    body: AssistantCloudThreadMessageUpdateBody,\n  ): Promise<void> {\n    return this.cloud.makeRequest(\n      `/threads/${encodeURIComponent(threadId)}/messages/${encodeURIComponent(messageId)}`,\n      { method: \"PUT\", body },\n    );\n  }\n\n  public async feedback(\n    threadId: string,\n    messageId: string,\n    body: AssistantCloudThreadMessageFeedbackBody,\n  ): Promise<AssistantCloudThreadMessageFeedbackResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\n        `/threads/${encodeURIComponent(threadId)}/messages/${encodeURIComponent(messageId)}/feedback`,\n        { method: \"POST\", body },\n      ),\n      \"thread message feedback response\",\n    );\n\n    return {\n      feedback_id: readCloudString(response.feedback_id, \"feedback_id\"),\n      type: readCloudEnum(response.type, \"type\", MESSAGE_FEEDBACK_TYPES),\n    };\n  }\n}\n"],"mappings":";;AA+CA,MAAM,yBAAyB,CAAC,YAAY,UAAU;AAWtD,MAAa,sBACX,OACA,UACiB;CACjB,MAAM,UAAU,gBAAgB,OAAO,KAAK;CAC5C,OAAO;EACL,IAAI,gBAAgB,QAAQ,IAAI,GAAG,MAAM,IAAI;EAC7C,WAAW,wBAAwB,QAAQ,WAAW,GAAG,MAAM,WAAW;EAC1E,QAAQ,iBAAiB,QAAQ,QAAQ,GAAG,MAAM,QAAQ;EAC1D,YAAY,mBAAmB,QAAQ,YAAY,GAAG,MAAM,YAAY;EACxE,YAAY,mBAAmB,QAAQ,YAAY,GAAG,MAAM,YAAY;EACxE,QAAQ,gBAAgB,QAAQ,QAAQ,GAAG,MAAM,QAAQ;EACzD,SAAS,oBAAoB,QAAQ,SAAS,GAAG,MAAM,SAAS;CAClE;AACF;AAEA,IAAa,+BAAb,MAA0C;CACxC;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;CACf;CAEA,MAAa,KACX,UACA,OACkD;EAClD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,YAAY,mBAAmB,QAAQ,EAAE,YACzC,EAAE,MAAM,CACV,GACA,8BACF;EAGA,OAAO,EACL,UAHe,eAAe,SAAS,UAAU,UAGhC,CAAC,CAAC,KAAK,SAAS,UAC/B,mBAAmB,SAAS,YAAY,MAAM,EAAE,CAClD,EACF;CACF;CAEA,MAAa,OACX,UACA,MAC8C;EAC9C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,YAAY,mBAAmB,QAAQ,EAAE,YACzC;GAAE,QAAQ;GAAQ;EAAK,CACzB,GACA,gCACF;EAEA,OAAO,EACL,YAAY,gBAAgB,SAAS,YAAY,YAAY,EAC/D;CACF;CAEA,MAAa,OACX,UACA,WACA,MACe;EACf,OAAO,KAAK,MAAM,YAChB,YAAY,mBAAmB,QAAQ,EAAE,YAAY,mBAAmB,SAAS,KACjF;GAAE,QAAQ;GAAO;EAAK,CACxB;CACF;CAEA,MAAa,SACX,UACA,WACA,MACsD;EACtD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YACf,YAAY,mBAAmB,QAAQ,EAAE,YAAY,mBAAmB,SAAS,EAAE,YACnF;GAAE,QAAQ;GAAQ;EAAK,CACzB,GACA,kCACF;EAEA,OAAO;GACL,aAAa,gBAAgB,SAAS,aAAa,aAAa;GAChE,MAAM,cAAc,SAAS,MAAM,QAAQ,sBAAsB;EACnE;CACF;AACF"}

package/dist/AssistantCloudThreads.d.ts

@@ -30,6 +30,12 @@ type AssistantCloudThreadsCreateBody = {
 type AssistantCloudThreadsCreateResponse = {
   thread_id: string;
 };
+type AssistantCloudThreadsClaimBody = {
+  refresh_token: string;
+};
+type AssistantCloudThreadsClaimResponse = {
+  moved: number;
+};
 type AssistantCloudThreadsUpdateBody = {
   title?: string | undefined;
   last_message_at?: Date | undefined;
@@ -45,6 +51,8 @@ declare class AssistantCloudThreads {
   get(threadId: string): Promise<CloudThread>;
   create(body: AssistantCloudThreadsCreateBody): Promise<AssistantCloudThreadsCreateResponse>;
   update(threadId: string, body: AssistantCloudThreadsUpdateBody): Promise<void>;
+  /** Moves every thread of the anonymous identity behind `refresh_token` into the caller's workspace. */
+  claim(body: AssistantCloudThreadsClaimBody): Promise<AssistantCloudThreadsClaimResponse>;
   delete(threadId: string): Promise<void>;
 }
 //#endregion

package/dist/AssistantCloudThreads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudThreads.d.ts","names":[],"sources":["../src/AssistantCloudThreads.ts"],"mappings":";;;KAWK;EACH;EACA;EACA;;KAGU;EACV;EACA,iBAAiB;EACjB;EACA;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA;;KAGG;EACH,SAAS;;KAGN;EACH;EACA,iBAAiB;EACjB;EACA;;KAGG;EACH;;KAGG;EACH;EACA,kBAAkB;EAClB;EACA;;cAGW,oBACX,gBACA,kBACC;cAsBU;WACK,UAAU;UAElB;EAEI,YAAA,OAAO;EAKN,KACX,QAAQ,iCACP,QAAQ;EAkBE,IAAI,mBAAmB,QAAQ;EAS/B,OACX,MAAM,kCACL,QAAQ;EASE,OACX,kBACA,MAAM,kCACL;EAOU,OAAO,mBAAmB"}
+{"version":3,"file":"AssistantCloudThreads.d.ts","names":[],"sources":["../src/AssistantCloudThreads.ts"],"mappings":";;;KAYK;EACH;EACA;EACA;;KAGU;EACV;EACA,iBAAiB;EACjB;EACA;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA;;KAGG;EACH,SAAS;;KAGN;EACH;EACA,iBAAiB;EACjB;EACA;;KAGG;EACH;;KAGG;EACH;;KAGG;EACH;;KAGG;EACH;EACA,kBAAkB;EAClB;EACA;;cAGW,oBACX,gBACA,kBACC;cAsBU;WACK,UAAU;UAElB;EAEI,YAAA,OAAO;EAKN,KACX,QAAQ,iCACP,QAAQ;EAkBE,IAAI,mBAAmB,QAAQ;EAS/B,OACX,MAAM,kCACL,QAAQ;EASE,OACX,kBACA,MAAM,kCACL;;EAQU,MACX,MAAM,iCACL,QAAQ;EASE,OAAO,mBAAmB"}

package/dist/AssistantCloudThreads.js

@@ -1,4 +1,4 @@
-import { readCloudArray, readCloudBoolean, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp } from "./cloudResponse.js";
+import { readCloudArray, readCloudBoolean, readCloudInteger, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp } from "./cloudResponse.js";
 import { AssistantCloudThreadMessages } from "./AssistantCloudThreadMessages.js";
 //#region src/AssistantCloudThreads.ts
 const decodeCloudThread = (value, field) => {
@@ -48,6 +48,14 @@ var AssistantCloudThreads = class {
 			body
 		});
 	}
+	/** Moves every thread of the anonymous identity behind `refresh_token` into the caller's workspace. */
+	async claim(body) {
+		const response = readCloudRecord(await this.cloud.makeRequest("/threads/claim", {
+			method: "POST",
+			body
+		}), "thread claim response");
+		return { moved: readCloudInteger(response.moved, "moved") };
+	}
 	async delete(threadId) {
 		return this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`, { method: "DELETE" });
 	}

package/dist/AssistantCloudThreads.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudThreads.js","names":[],"sources":["../src/AssistantCloudThreads.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport { AssistantCloudThreadMessages } from \"./AssistantCloudThreadMessages\";\nimport {\n  readCloudArray,\n  readCloudBoolean,\n  readCloudNullableString,\n  readCloudRecord,\n  readCloudString,\n  readCloudTimestamp,\n} from \"./cloudResponse\";\n\ntype AssistantCloudThreadsListQuery = {\n  is_archived?: boolean;\n  limit?: number;\n  after?: string;\n};\n\nexport type CloudThread = {\n  title: string;\n  last_message_at: Date;\n  metadata: unknown;\n  external_id: string | null;\n  id: string;\n  project_id: string;\n  created_at: Date;\n  updated_at: Date;\n  workspace_id: string;\n  is_archived: boolean;\n};\n\ntype AssistantCloudThreadsListResponse = {\n  threads: CloudThread[];\n};\n\ntype AssistantCloudThreadsCreateBody = {\n  title?: string | undefined;\n  last_message_at: Date;\n  metadata?: unknown | undefined;\n  external_id?: string | undefined;\n};\n\ntype AssistantCloudThreadsCreateResponse = {\n  thread_id: string;\n};\n\ntype AssistantCloudThreadsUpdateBody = {\n  title?: string | undefined;\n  last_message_at?: Date | undefined;\n  metadata?: unknown | undefined;\n  is_archived?: boolean | undefined;\n};\n\nexport const decodeCloudThread = (\n  value: unknown,\n  field: string,\n): CloudThread => {\n  const thread = readCloudRecord(value, field);\n  return {\n    title: readCloudNullableString(thread.title, `${field}.title`) ?? \"\",\n    last_message_at: readCloudTimestamp(\n      thread.last_message_at,\n      `${field}.last_message_at`,\n    ),\n    metadata: thread.metadata,\n    external_id: readCloudNullableString(\n      thread.external_id,\n      `${field}.external_id`,\n    ),\n    id: readCloudString(thread.id, `${field}.id`),\n    project_id: readCloudString(thread.project_id, `${field}.project_id`),\n    created_at: readCloudTimestamp(thread.created_at, `${field}.created_at`),\n    updated_at: readCloudTimestamp(thread.updated_at, `${field}.updated_at`),\n    workspace_id: readCloudString(thread.workspace_id, `${field}.workspace_id`),\n    is_archived: readCloudBoolean(thread.is_archived, `${field}.is_archived`),\n  };\n};\n\nexport class AssistantCloudThreads {\n  public readonly messages: AssistantCloudThreadMessages;\n\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n    this.messages = new AssistantCloudThreadMessages(cloud);\n  }\n\n  public async list(\n    query?: AssistantCloudThreadsListQuery,\n  ): Promise<AssistantCloudThreadsListResponse> {\n    const requestQuery =\n      query?.is_archived === undefined\n        ? query\n        : { ...query, is_archived: String(query.is_archived) };\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/threads\", { query: requestQuery }),\n      \"thread list response\",\n    );\n    const threads = readCloudArray(response.threads, \"threads\");\n\n    return {\n      threads: threads.map((thread, index) =>\n        decodeCloudThread(thread, `threads[${index}]`),\n      ),\n    };\n  }\n\n  public async get(threadId: string): Promise<CloudThread> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`),\n      \"thread response\",\n    );\n\n    return decodeCloudThread(response.thread, \"thread\");\n  }\n\n  public async create(\n    body: AssistantCloudThreadsCreateBody,\n  ): Promise<AssistantCloudThreadsCreateResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/threads\", { method: \"POST\", body }),\n      \"thread create response\",\n    );\n\n    return { thread_id: readCloudString(response.thread_id, \"thread_id\") };\n  }\n\n  public async update(\n    threadId: string,\n    body: AssistantCloudThreadsUpdateBody,\n  ): Promise<void> {\n    return this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`, {\n      method: \"PUT\",\n      body,\n    });\n  }\n\n  public async delete(threadId: string): Promise<void> {\n    return this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`, {\n      method: \"DELETE\",\n    });\n  }\n}\n"],"mappings":";;;AAoDA,MAAa,qBACX,OACA,UACgB;CAChB,MAAM,SAAS,gBAAgB,OAAO,KAAK;CAC3C,OAAO;EACL,OAAO,wBAAwB,OAAO,OAAO,GAAG,MAAM,OAAO,KAAK;EAClE,iBAAiB,mBACf,OAAO,iBACP,GAAG,MAAM,iBACX;EACA,UAAU,OAAO;EACjB,aAAa,wBACX,OAAO,aACP,GAAG,MAAM,aACX;EACA,IAAI,gBAAgB,OAAO,IAAI,GAAG,MAAM,IAAI;EAC5C,YAAY,gBAAgB,OAAO,YAAY,GAAG,MAAM,YAAY;EACpE,YAAY,mBAAmB,OAAO,YAAY,GAAG,MAAM,YAAY;EACvE,YAAY,mBAAmB,OAAO,YAAY,GAAG,MAAM,YAAY;EACvE,cAAc,gBAAgB,OAAO,cAAc,GAAG,MAAM,cAAc;EAC1E,aAAa,iBAAiB,OAAO,aAAa,GAAG,MAAM,aAAa;CAC1E;AACF;AAEA,IAAa,wBAAb,MAAmC;CACjC;CAEA;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;EACb,KAAK,WAAW,IAAI,6BAA6B,KAAK;CACxD;CAEA,MAAa,KACX,OAC4C;EAC5C,MAAM,eACJ,OAAO,gBAAgB,KAAA,IACnB,QACA;GAAE,GAAG;GAAO,aAAa,OAAO,MAAM,WAAW;EAAE;EACzD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY,EAAE,OAAO,aAAa,CAAC,GAChE,sBACF;EAGA,OAAO,EACL,SAHc,eAAe,SAAS,SAAS,SAGhC,CAAC,CAAC,KAAK,QAAQ,UAC5B,kBAAkB,QAAQ,WAAW,MAAM,EAAE,CAC/C,EACF;CACF;CAEA,MAAa,IAAI,UAAwC;EACvD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,GAAG,GACvE,iBACF;EAEA,OAAO,kBAAkB,SAAS,QAAQ,QAAQ;CACpD;CAEA,MAAa,OACX,MAC8C;EAC9C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY;GAAE,QAAQ;GAAQ;EAAK,CAAC,GACjE,wBACF;EAEA,OAAO,EAAE,WAAW,gBAAgB,SAAS,WAAW,WAAW,EAAE;CACvE;CAEA,MAAa,OACX,UACA,MACe;EACf,OAAO,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,KAAK;GACxE,QAAQ;GACR;EACF,CAAC;CACH;CAEA,MAAa,OAAO,UAAiC;EACnD,OAAO,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,KAAK,EACxE,QAAQ,SACV,CAAC;CACH;AACF"}
+{"version":3,"file":"AssistantCloudThreads.js","names":[],"sources":["../src/AssistantCloudThreads.ts"],"sourcesContent":["import type { AssistantCloudAPI } from \"./AssistantCloudAPI\";\nimport { AssistantCloudThreadMessages } from \"./AssistantCloudThreadMessages\";\nimport {\n  readCloudArray,\n  readCloudBoolean,\n  readCloudInteger,\n  readCloudNullableString,\n  readCloudRecord,\n  readCloudString,\n  readCloudTimestamp,\n} from \"./cloudResponse\";\n\ntype AssistantCloudThreadsListQuery = {\n  is_archived?: boolean;\n  limit?: number;\n  after?: string;\n};\n\nexport type CloudThread = {\n  title: string;\n  last_message_at: Date;\n  metadata: unknown;\n  external_id: string | null;\n  id: string;\n  project_id: string;\n  created_at: Date;\n  updated_at: Date;\n  workspace_id: string;\n  is_archived: boolean;\n};\n\ntype AssistantCloudThreadsListResponse = {\n  threads: CloudThread[];\n};\n\ntype AssistantCloudThreadsCreateBody = {\n  title?: string | undefined;\n  last_message_at: Date;\n  metadata?: unknown | undefined;\n  external_id?: string | undefined;\n};\n\ntype AssistantCloudThreadsCreateResponse = {\n  thread_id: string;\n};\n\ntype AssistantCloudThreadsClaimBody = {\n  refresh_token: string;\n};\n\ntype AssistantCloudThreadsClaimResponse = {\n  moved: number;\n};\n\ntype AssistantCloudThreadsUpdateBody = {\n  title?: string | undefined;\n  last_message_at?: Date | undefined;\n  metadata?: unknown | undefined;\n  is_archived?: boolean | undefined;\n};\n\nexport const decodeCloudThread = (\n  value: unknown,\n  field: string,\n): CloudThread => {\n  const thread = readCloudRecord(value, field);\n  return {\n    title: readCloudNullableString(thread.title, `${field}.title`) ?? \"\",\n    last_message_at: readCloudTimestamp(\n      thread.last_message_at,\n      `${field}.last_message_at`,\n    ),\n    metadata: thread.metadata,\n    external_id: readCloudNullableString(\n      thread.external_id,\n      `${field}.external_id`,\n    ),\n    id: readCloudString(thread.id, `${field}.id`),\n    project_id: readCloudString(thread.project_id, `${field}.project_id`),\n    created_at: readCloudTimestamp(thread.created_at, `${field}.created_at`),\n    updated_at: readCloudTimestamp(thread.updated_at, `${field}.updated_at`),\n    workspace_id: readCloudString(thread.workspace_id, `${field}.workspace_id`),\n    is_archived: readCloudBoolean(thread.is_archived, `${field}.is_archived`),\n  };\n};\n\nexport class AssistantCloudThreads {\n  public readonly messages: AssistantCloudThreadMessages;\n\n  private cloud: AssistantCloudAPI;\n\n  constructor(cloud: AssistantCloudAPI) {\n    this.cloud = cloud;\n    this.messages = new AssistantCloudThreadMessages(cloud);\n  }\n\n  public async list(\n    query?: AssistantCloudThreadsListQuery,\n  ): Promise<AssistantCloudThreadsListResponse> {\n    const requestQuery =\n      query?.is_archived === undefined\n        ? query\n        : { ...query, is_archived: String(query.is_archived) };\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/threads\", { query: requestQuery }),\n      \"thread list response\",\n    );\n    const threads = readCloudArray(response.threads, \"threads\");\n\n    return {\n      threads: threads.map((thread, index) =>\n        decodeCloudThread(thread, `threads[${index}]`),\n      ),\n    };\n  }\n\n  public async get(threadId: string): Promise<CloudThread> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`),\n      \"thread response\",\n    );\n\n    return decodeCloudThread(response.thread, \"thread\");\n  }\n\n  public async create(\n    body: AssistantCloudThreadsCreateBody,\n  ): Promise<AssistantCloudThreadsCreateResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/threads\", { method: \"POST\", body }),\n      \"thread create response\",\n    );\n\n    return { thread_id: readCloudString(response.thread_id, \"thread_id\") };\n  }\n\n  public async update(\n    threadId: string,\n    body: AssistantCloudThreadsUpdateBody,\n  ): Promise<void> {\n    return this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`, {\n      method: \"PUT\",\n      body,\n    });\n  }\n\n  /** Moves every thread of the anonymous identity behind `refresh_token` into the caller's workspace. */\n  public async claim(\n    body: AssistantCloudThreadsClaimBody,\n  ): Promise<AssistantCloudThreadsClaimResponse> {\n    const response = readCloudRecord(\n      await this.cloud.makeRequest(\"/threads/claim\", { method: \"POST\", body }),\n      \"thread claim response\",\n    );\n\n    return { moved: readCloudInteger(response.moved, \"moved\") };\n  }\n\n  public async delete(threadId: string): Promise<void> {\n    return this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}`, {\n      method: \"DELETE\",\n    });\n  }\n}\n"],"mappings":";;;AA6DA,MAAa,qBACX,OACA,UACgB;CAChB,MAAM,SAAS,gBAAgB,OAAO,KAAK;CAC3C,OAAO;EACL,OAAO,wBAAwB,OAAO,OAAO,GAAG,MAAM,OAAO,KAAK;EAClE,iBAAiB,mBACf,OAAO,iBACP,GAAG,MAAM,iBACX;EACA,UAAU,OAAO;EACjB,aAAa,wBACX,OAAO,aACP,GAAG,MAAM,aACX;EACA,IAAI,gBAAgB,OAAO,IAAI,GAAG,MAAM,IAAI;EAC5C,YAAY,gBAAgB,OAAO,YAAY,GAAG,MAAM,YAAY;EACpE,YAAY,mBAAmB,OAAO,YAAY,GAAG,MAAM,YAAY;EACvE,YAAY,mBAAmB,OAAO,YAAY,GAAG,MAAM,YAAY;EACvE,cAAc,gBAAgB,OAAO,cAAc,GAAG,MAAM,cAAc;EAC1E,aAAa,iBAAiB,OAAO,aAAa,GAAG,MAAM,aAAa;CAC1E;AACF;AAEA,IAAa,wBAAb,MAAmC;CACjC;CAEA;CAEA,YAAY,OAA0B;EACpC,KAAK,QAAQ;EACb,KAAK,WAAW,IAAI,6BAA6B,KAAK;CACxD;CAEA,MAAa,KACX,OAC4C;EAC5C,MAAM,eACJ,OAAO,gBAAgB,KAAA,IACnB,QACA;GAAE,GAAG;GAAO,aAAa,OAAO,MAAM,WAAW;EAAE;EACzD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY,EAAE,OAAO,aAAa,CAAC,GAChE,sBACF;EAGA,OAAO,EACL,SAHc,eAAe,SAAS,SAAS,SAGhC,CAAC,CAAC,KAAK,QAAQ,UAC5B,kBAAkB,QAAQ,WAAW,MAAM,EAAE,CAC/C,EACF;CACF;CAEA,MAAa,IAAI,UAAwC;EACvD,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,GAAG,GACvE,iBACF;EAEA,OAAO,kBAAkB,SAAS,QAAQ,QAAQ;CACpD;CAEA,MAAa,OACX,MAC8C;EAC9C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,YAAY;GAAE,QAAQ;GAAQ;EAAK,CAAC,GACjE,wBACF;EAEA,OAAO,EAAE,WAAW,gBAAgB,SAAS,WAAW,WAAW,EAAE;CACvE;CAEA,MAAa,OACX,UACA,MACe;EACf,OAAO,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,KAAK;GACxE,QAAQ;GACR;EACF,CAAC;CACH;;CAGA,MAAa,MACX,MAC6C;EAC7C,MAAM,WAAW,gBACf,MAAM,KAAK,MAAM,YAAY,kBAAkB;GAAE,QAAQ;GAAQ;EAAK,CAAC,GACvE,uBACF;EAEA,OAAO,EAAE,OAAO,iBAAiB,SAAS,OAAO,OAAO,EAAE;CAC5D;CAEA,MAAa,OAAO,UAAiC;EACnD,OAAO,KAAK,MAAM,YAAY,YAAY,mBAAmB,QAAQ,KAAK,EACxE,QAAQ,SACV,CAAC;CACH;AACF"}

package/dist/CloudEngagementReporter.d.ts

@@ -0,0 +1,74 @@
+import { AssistantCloudEvent } from "./AssistantCloudEvents.js";
+import { AssistantCloud } from "./AssistantCloud.js";
+//#region src/CloudEngagementReporter.d.ts
+type EngagementEventIds = Pick<AssistantCloudEvent, "thread_id" | "message_id" | "run_id">;
+/**
+ * Turns the ids an integration knows (its own thread and message ids) into the
+ * ids the cloud stores. A send is the one event that may create the remote
+ * thread, so it asks for `awaitThread`; every other event reads the ids that
+ * already exist.
+ */
+type EngagementIdResolver = (threadId: string, messageId: string | undefined, options: {
+  awaitThread: boolean;
+}) => EngagementEventIds | Promise<EngagementEventIds>;
+/**
+ * Derives engagement events from what a chat integration observes and keeps
+ * the per thread state the events need: a run's start for the stop duration,
+ * a run's end for the time to the next message, one error and one suggestion
+ * list per run or thread. A started run is kept until it ends or stops; the
+ * rest is kept for the 256 most recently touched threads, so a long session
+ * does not grow it without bound. Delivery goes through the cloud's event
+ * buffer, so a disabled telemetry setting drops everything here as well.
+ */
+declare class CloudEngagementReporter {
+  private readonly runStartedAt;
+  private readonly runEndedAt;
+  private readonly shownErrors;
+  private readonly shownSuggestions;
+  private readonly getCloud;
+  private readonly resolveIds;
+  constructor(cloud: AssistantCloud | (() => AssistantCloud), resolveIds?: EngagementIdResolver);
+  runStarted(threadId: string): void;
+  runEnded(threadId: string): void;
+  /** Reported once per started run, with the time the run had been going. */
+  runStopped(threadId: string): void;
+  /** Carries the time since the previous run of the thread ended, when known. */
+  messageSent(threadId: string, init: {
+    messageId?: string | undefined;
+    chars: number;
+    attachments: number;
+  }): void;
+  messageEdited(threadId: string, init: {
+    messageId: string;
+    chars: number;
+  }): void;
+  messageRegenerated(threadId: string, messageId?: string): void;
+  /** Reported once per run, so a retried render of the same error stays one event. */
+  errorShown(threadId: string, init: {
+    messageId?: string | undefined;
+    reason: string;
+  }): void;
+  /** Reported once per thread, with the number of suggestions on offer. */
+  suggestionsShown(threadId: string, count: number): void;
+  suggestionClicked(threadId: string): void;
+  attachmentAdded(threadId: string, init: {
+    messageId?: string | undefined;
+    contentType?: string | undefined;
+  }): void;
+  attachmentFailed(threadId: string, init: {
+    messageId?: string | undefined;
+    contentType?: string | undefined;
+  }): void;
+  voiceStarted(threadId: string): void;
+  speechStarted(threadId: string, messageId?: string): void;
+  branchSwitched(threadId: string, messageId?: string): void;
+  messageCopied(threadId: string, messageId?: string): void;
+  toolApproved(threadId: string, messageId: string, toolCallId: string, toolName: string): void;
+  toolRejected(threadId: string, messageId: string, toolCallId: string, toolName: string): void;
+  /** Reported only for a thread the cloud already knows. */
+  threadSwitched(threadId: string): void;
+  private track;
+}
+//#endregion
+export { CloudEngagementReporter, EngagementEventIds, EngagementIdResolver };
+//# sourceMappingURL=CloudEngagementReporter.d.ts.map

package/dist/CloudEngagementReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudEngagementReporter.d.ts","names":[],"sources":["../src/CloudEngagementReporter.ts"],"mappings":";;;KAMY,qBAAqB,KAC/B;;;;;;;KAUU,wBACV,kBACA,+BACA;EAAW;MACR,qBAAqB,QAAQ;;;;;;;;;;cAoCrB;mBACM;mBACA;mBACA;mBACA;mBAEA;mBACA;EAGf,YAAA,OAAO,wBAAwB,iBAC/B,aAAY;EAMP,WAAW;EAKX,SAAS;;EAMT,WAAW;;EAUX,YACL,kBACA;IACE;IACA;IACA;;EAkBG,cACL,kBACA;IAAQ;IAAmB;;EAOtB,mBAAmB,kBAAkB;;EAKrC,WACL,kBACA;IAAQ;IAAgC;;;EAUnC,iBAAiB,kBAAkB;EAMnC,kBAAkB;EAIlB,gBACL,kBACA;IAAQ;IAAgC;;EAOnC,iBACL,kBACA;IAAQ;IAAgC;;EAOnC,aAAa;EAIb,cAAc,kBAAkB;EAIhC,eAAe,kBAAkB;EAIjC,cAAc,kBAAkB;EAIhC,aACL,kBACA,mBACA,oBACA;EAOK,aACL,kBACA,mBACA,oBACA;;EAQK,eAAe;UAId"}