assistant-cloud 0.1.35 → 0.1.37

package/dist/CloudMessagePersistence.d.ts

@@ -14,9 +14,10 @@ import { ReadonlyJSONObject } from "assistant-stream/utils";
  * to get its remote ID before creating B.
  */
 declare class CloudMessagePersistence {
-  private cloud;
   private idMapping;
+  private getCloud;
   constructor(cloud: AssistantCloud);
+  constructor(getCloud: () => AssistantCloud);
   /**
    * Persist a message to the cloud.
    *

package/dist/CloudMessagePersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudMessagePersistence.d.ts","names":[],"sources":["../src/CloudMessagePersistence.ts"],"mappings":";;;;;;;;;;;;;;;cAca;UAGS;UAFZ;cAEY,OAAO;;;;;;;;;;EAWrB,OACJ,kBACA,mBACA,yBACA,gBACA,SAAS,qBACR;;;;EAgCG,OACJ,kBACA,mBACA,iBACA,SAAS,qBACR;;;;EASH,YAAY;;;;;EAQN,YAAY,oBAAoB;;;;;;;;;;;EAgBhC,KAAK,kBAAkB,kBAAe,QAhBN;;;;EA+BtC"}
+{"version":3,"file":"CloudMessagePersistence.d.ts","names":[],"sources":["../src/CloudMessagePersistence.ts"],"mappings":";;;;;;;;;;;;;;;cAca;UACH;UACA;EAEI,YAAA,OAAO;EACP,YAAA,gBAAgB;;;;;;;;;;EActB,OACJ,kBACA,mBACA,yBACA,gBACA,SAAS,qBACR;;;;EAiCG,OACJ,kBACA,mBACA,iBACA,SAAS,qBACR;;;;EAeH,YAAY;;;;;EAQN,YAAY,oBAAoB;;;;;;;;;;;EAgBhC,KAAK,kBAAkB,kBAAe,QAhBN;;;;EAgCtC"}

package/dist/CloudMessagePersistence.js

@@ -11,10 +11,10 @@
 * to get its remote ID before creating B.
 */
 var CloudMessagePersistence = class {
-	cloud;
 	idMapping = {};
+	getCloud;
 	constructor(cloud) {
-		this.cloud = cloud;
+		this.getCloud = typeof cloud === "function" ? cloud : () => cloud;
 	}
 	/**
 	* Persist a message to the cloud.
@@ -26,8 +26,9 @@ var CloudMessagePersistence = class {
 	* @param content - Message content (format-specific)
 	*/
 	async append(threadId, messageId, parentId, format, content) {
+		const cloud = this.getCloud();
 		const resolvedParentId = parentId ? await this.idMapping[parentId] ?? parentId : null;
-		const task = this.cloud.threads.messages.create(threadId, {
+		const task = cloud.threads.messages.create(threadId, {
 			parent_id: resolvedParentId,
 			format,
 			content
@@ -45,9 +46,13 @@ var CloudMessagePersistence = class {
 	* Update an already-persisted message in the cloud.
 	*/
 	async update(threadId, messageId, _format, content) {
+		const cloud = this.getCloud();
 		const remoteId = await this.getRemoteId(messageId);
-		if (!remoteId) return;
-		await this.cloud.threads.messages.update(threadId, remoteId, { content });
+		if (!remoteId) {
+			console.warn(`Skipping update for message ${messageId}: no remote id is mapped.`);
+			return;
+		}
+		await cloud.threads.messages.update(threadId, remoteId, { content });
 	}
 	/**
 	* Check if a message has been persisted (or is currently being persisted).
@@ -75,7 +80,7 @@ var CloudMessagePersistence = class {
 	* @returns Array of cloud messages
 	*/
 	async load(threadId, format) {
-		const { messages } = await this.cloud.threads.messages.list(threadId, format ? { format } : void 0);
+		const { messages } = await this.getCloud().threads.messages.list(threadId, format ? { format } : void 0);
 		for (const m of messages) this.idMapping[m.id] = m.id;
 		return messages;
 	}

package/dist/CloudMessagePersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"CloudMessagePersistence.js","names":[],"sources":["../src/CloudMessagePersistence.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { AssistantCloud } from \"./AssistantCloud\";\n\n/**\n * Shared persistence logic for cloud message storage.\n *\n * Handles ID mapping (local → remote) and parent_id chaining for both:\n * - AssistantCloudThreadHistoryAdapter (assistant-ui runtime)\n * - useCloudChat (standalone AI SDK hook)\n *\n * The promise-based ID resolution handles concurrent appends — if message B's\n * parent is message A, and A is still being created, we await A's promise\n * to get its remote ID before creating B.\n */\nexport class CloudMessagePersistence {\n  private idMapping: Record<string, string | Promise<string>> = {};\n\n  constructor(private cloud: AssistantCloud) {}\n\n  /**\n   * Persist a message to the cloud.\n   *\n   * @param threadId - Remote thread ID\n   * @param messageId - Local message ID (used for tracking)\n   * @param parentId - Local parent message ID (or null for first message)\n   * @param format - Message format (e.g., \"aui/v0\", \"ai-sdk/v6\")\n   * @param content - Message content (format-specific)\n   */\n  async append(\n    threadId: string,\n    messageId: string,\n    parentId: string | null,\n    format: string,\n    content: ReadonlyJSONObject,\n  ): Promise<void> {\n    // Resolve parent's remote ID if it exists (may be a promise if concurrent)\n    const resolvedParentId = parentId\n      ? ((await this.idMapping[parentId]) ?? parentId)\n      : null;\n\n    const task = this.cloud.threads.messages\n      .create(threadId, {\n        parent_id: resolvedParentId,\n        format,\n        content,\n      })\n      .then(({ message_id }) => {\n        this.idMapping[messageId] = message_id;\n        return message_id;\n      })\n      .catch((err) => {\n        // Only delete if we're still the active task (avoids clobbering a retry)\n        if (this.idMapping[messageId] === task) {\n          delete this.idMapping[messageId];\n        }\n        throw err;\n      });\n\n    // Store the promise immediately so concurrent appends can await it\n    this.idMapping[messageId] = task;\n    return task.then(() => {});\n  }\n\n  /**\n   * Update an already-persisted message in the cloud.\n   */\n  async update(\n    threadId: string,\n    messageId: string,\n    _format: string,\n    content: ReadonlyJSONObject,\n  ): Promise<void> {\n    const remoteId = await this.getRemoteId(messageId);\n    if (!remoteId) return; // not persisted yet, skip\n    await this.cloud.threads.messages.update(threadId, remoteId, { content });\n  }\n\n  /**\n   * Check if a message has been persisted (or is currently being persisted).\n   */\n  isPersisted(messageId: string): boolean {\n    return messageId in this.idMapping;\n  }\n\n  /**\n   * Get the remote ID for a local message ID (resolved).\n   * Returns undefined if not persisted.\n   */\n  async getRemoteId(messageId: string): Promise<string | undefined> {\n    const entry = this.idMapping[messageId];\n    if (!entry) return undefined;\n    return entry;\n  }\n\n  /**\n   * Load messages from the cloud and populate the ID mapping.\n   *\n   * The ID mapping is populated so that `isPersisted()` returns true for\n   * loaded messages, preventing re-persistence of already-stored messages.\n   *\n   * @param threadId - Remote thread ID\n   * @param format - Optional format filter\n   * @returns Array of cloud messages\n   */\n  async load(threadId: string, format?: string) {\n    const { messages } = await this.cloud.threads.messages.list(\n      threadId,\n      format ? { format } : undefined,\n    );\n    // Populate ID mapping so isPersisted() recognizes loaded messages\n    for (const m of messages) {\n      this.idMapping[m.id] = m.id;\n    }\n    return messages;\n  }\n\n  /**\n   * Reset the ID mapping (call when switching threads).\n   */\n  reset() {\n    this.idMapping = {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAa,0BAAb,MAAqC;CAGf;CAFpB,YAA8D,CAAC;CAE/D,YAAY,OAA+B;EAAvB,KAAA,QAAA;CAAwB;;;;;;;;;;CAW5C,MAAM,OACJ,UACA,WACA,UACA,QACA,SACe;EAEf,MAAM,mBAAmB,WACnB,MAAM,KAAK,UAAU,aAAc,WACrC;EAEJ,MAAM,OAAO,KAAK,MAAM,QAAQ,SAC7B,OAAO,UAAU;GAChB,WAAW;GACX;GACA;EACF,CAAC,CAAC,CACD,MAAM,EAAE,iBAAiB;GACxB,KAAK,UAAU,aAAa;GAC5B,OAAO;EACT,CAAC,CAAC,CACD,OAAO,QAAQ;GAEd,IAAI,KAAK,UAAU,eAAe,MAChC,OAAO,KAAK,UAAU;GAExB,MAAM;EACR,CAAC;EAGH,KAAK,UAAU,aAAa;EAC5B,OAAO,KAAK,WAAW,CAAC,CAAC;CAC3B;;;;CAKA,MAAM,OACJ,UACA,WACA,SACA,SACe;EACf,MAAM,WAAW,MAAM,KAAK,YAAY,SAAS;EACjD,IAAI,CAAC,UAAU;EACf,MAAM,KAAK,MAAM,QAAQ,SAAS,OAAO,UAAU,UAAU,EAAE,QAAQ,CAAC;CAC1E;;;;CAKA,YAAY,WAA4B;EACtC,OAAO,aAAa,KAAK;CAC3B;;;;;CAMA,MAAM,YAAY,WAAgD;EAChE,MAAM,QAAQ,KAAK,UAAU;EAC7B,IAAI,CAAC,OAAO,OAAO,KAAA;EACnB,OAAO;CACT;;;;;;;;;;;CAYA,MAAM,KAAK,UAAkB,QAAiB;EAC5C,MAAM,EAAE,aAAa,MAAM,KAAK,MAAM,QAAQ,SAAS,KACrD,UACA,SAAS,EAAE,OAAO,IAAI,KAAA,CACxB;EAEA,KAAK,MAAM,KAAK,UACd,KAAK,UAAU,EAAE,MAAM,EAAE;EAE3B,OAAO;CACT;;;;CAKA,QAAQ;EACN,KAAK,YAAY,CAAC;CACpB;AACF"}
+{"version":3,"file":"CloudMessagePersistence.js","names":[],"sources":["../src/CloudMessagePersistence.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { AssistantCloud } from \"./AssistantCloud\";\n\n/**\n * Shared persistence logic for cloud message storage.\n *\n * Handles ID mapping (local → remote) and parent_id chaining for both:\n * - AssistantCloudThreadHistoryAdapter (assistant-ui runtime)\n * - useCloudChat (standalone AI SDK hook)\n *\n * The promise-based ID resolution handles concurrent appends — if message B's\n * parent is message A, and A is still being created, we await A's promise\n * to get its remote ID before creating B.\n */\nexport class CloudMessagePersistence {\n  private idMapping: Record<string, string | Promise<string>> = {};\n  private getCloud: () => AssistantCloud;\n\n  constructor(cloud: AssistantCloud);\n  constructor(getCloud: () => AssistantCloud);\n  constructor(cloud: AssistantCloud | (() => AssistantCloud)) {\n    this.getCloud = typeof cloud === \"function\" ? cloud : () => cloud;\n  }\n\n  /**\n   * Persist a message to the cloud.\n   *\n   * @param threadId - Remote thread ID\n   * @param messageId - Local message ID (used for tracking)\n   * @param parentId - Local parent message ID (or null for first message)\n   * @param format - Message format (e.g., \"aui/v0\", \"ai-sdk/v6\")\n   * @param content - Message content (format-specific)\n   */\n  async append(\n    threadId: string,\n    messageId: string,\n    parentId: string | null,\n    format: string,\n    content: ReadonlyJSONObject,\n  ): Promise<void> {\n    const cloud = this.getCloud();\n    // Resolve parent's remote ID if it exists (may be a promise if concurrent)\n    const resolvedParentId = parentId\n      ? ((await this.idMapping[parentId]) ?? parentId)\n      : null;\n\n    const task = cloud.threads.messages\n      .create(threadId, {\n        parent_id: resolvedParentId,\n        format,\n        content,\n      })\n      .then(({ message_id }) => {\n        this.idMapping[messageId] = message_id;\n        return message_id;\n      })\n      .catch((err) => {\n        // Only delete if we're still the active task (avoids clobbering a retry)\n        if (this.idMapping[messageId] === task) {\n          delete this.idMapping[messageId];\n        }\n        throw err;\n      });\n\n    // Store the promise immediately so concurrent appends can await it\n    this.idMapping[messageId] = task;\n    return task.then(() => {});\n  }\n\n  /**\n   * Update an already-persisted message in the cloud.\n   */\n  async update(\n    threadId: string,\n    messageId: string,\n    _format: string,\n    content: ReadonlyJSONObject,\n  ): Promise<void> {\n    const cloud = this.getCloud();\n    const remoteId = await this.getRemoteId(messageId);\n    if (!remoteId) {\n      console.warn(\n        `Skipping update for message ${messageId}: no remote id is mapped.`,\n      );\n      return;\n    }\n    await cloud.threads.messages.update(threadId, remoteId, { content });\n  }\n\n  /**\n   * Check if a message has been persisted (or is currently being persisted).\n   */\n  isPersisted(messageId: string): boolean {\n    return messageId in this.idMapping;\n  }\n\n  /**\n   * Get the remote ID for a local message ID (resolved).\n   * Returns undefined if not persisted.\n   */\n  async getRemoteId(messageId: string): Promise<string | undefined> {\n    const entry = this.idMapping[messageId];\n    if (!entry) return undefined;\n    return entry;\n  }\n\n  /**\n   * Load messages from the cloud and populate the ID mapping.\n   *\n   * The ID mapping is populated so that `isPersisted()` returns true for\n   * loaded messages, preventing re-persistence of already-stored messages.\n   *\n   * @param threadId - Remote thread ID\n   * @param format - Optional format filter\n   * @returns Array of cloud messages\n   */\n  async load(threadId: string, format?: string) {\n    const cloud = this.getCloud();\n    const { messages } = await cloud.threads.messages.list(\n      threadId,\n      format ? { format } : undefined,\n    );\n    // Populate ID mapping so isPersisted() recognizes loaded messages\n    for (const m of messages) {\n      this.idMapping[m.id] = m.id;\n    }\n    return messages;\n  }\n\n  /**\n   * Reset the ID mapping (call when switching threads).\n   */\n  reset() {\n    this.idMapping = {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAa,0BAAb,MAAqC;CACnC,YAA8D,CAAC;CAC/D;CAIA,YAAY,OAAgD;EAC1D,KAAK,WAAW,OAAO,UAAU,aAAa,cAAc;CAC9D;;;;;;;;;;CAWA,MAAM,OACJ,UACA,WACA,UACA,QACA,SACe;EACf,MAAM,QAAQ,KAAK,SAAS;EAE5B,MAAM,mBAAmB,WACnB,MAAM,KAAK,UAAU,aAAc,WACrC;EAEJ,MAAM,OAAO,MAAM,QAAQ,SACxB,OAAO,UAAU;GAChB,WAAW;GACX;GACA;EACF,CAAC,CAAC,CACD,MAAM,EAAE,iBAAiB;GACxB,KAAK,UAAU,aAAa;GAC5B,OAAO;EACT,CAAC,CAAC,CACD,OAAO,QAAQ;GAEd,IAAI,KAAK,UAAU,eAAe,MAChC,OAAO,KAAK,UAAU;GAExB,MAAM;EACR,CAAC;EAGH,KAAK,UAAU,aAAa;EAC5B,OAAO,KAAK,WAAW,CAAC,CAAC;CAC3B;;;;CAKA,MAAM,OACJ,UACA,WACA,SACA,SACe;EACf,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,WAAW,MAAM,KAAK,YAAY,SAAS;EACjD,IAAI,CAAC,UAAU;GACb,QAAQ,KACN,+BAA+B,UAAU,0BAC3C;GACA;EACF;EACA,MAAM,MAAM,QAAQ,SAAS,OAAO,UAAU,UAAU,EAAE,QAAQ,CAAC;CACrE;;;;CAKA,YAAY,WAA4B;EACtC,OAAO,aAAa,KAAK;CAC3B;;;;;CAMA,MAAM,YAAY,WAAgD;EAChE,MAAM,QAAQ,KAAK,UAAU;EAC7B,IAAI,CAAC,OAAO,OAAO,KAAA;EACnB,OAAO;CACT;;;;;;;;;;;CAYA,MAAM,KAAK,UAAkB,QAAiB;EAE5C,MAAM,EAAE,aAAa,MADP,KAAK,SACY,CAAC,CAAC,QAAQ,SAAS,KAChD,UACA,SAAS,EAAE,OAAO,IAAI,KAAA,CACxB;EAEA,KAAK,MAAM,KAAK,UACd,KAAK,UAAU,EAAE,MAAM,EAAE;EAE3B,OAAO;CACT;;;;CAKA,QAAQ;EACN,KAAK,YAAY,CAAC;CACpB;AACF"}

package/dist/FormattedCloudPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormattedCloudPersistence.d.ts","names":[],"sources":["../src/FormattedCloudPersistence.ts"],"mappings":";;;;;;;KAOY,qBAAqB,UAAU;EACzC;EACA,OAAO;IAAQ;IAAyB,SAAS;MAAa;EAC9D,OAAO;IACL;IACA;IACA;IACA,SAAS;;IACL;IAAyB,SAAS;;EACxC,MAAM,SAAS;;;;;;;;;;;;cAaJ,6BAA8B,UAAU,gBACnD;EACE,SACE,kBACA,mBACA,yBACA,gBACA,SAAS,uBACN;EACL,OAAO,kBAAkB,oBAAoB;EAC7C,cAAc;EACd,UACE,kBACA,mBACA,gBACA,SAAS,uBACN;GAEP,SAAS,qBAAqB,UAAU;6BAGtB;IACR;IAAyB,SAAS;QACzC;8BAamB;IACR;IAAyB,SAAS;KAAU,sBAEnD;8BAUsB"}
+{"version":3,"file":"FormattedCloudPersistence.d.ts","names":[],"sources":["../src/FormattedCloudPersistence.ts"],"mappings":";;;;;;;KAOY,qBAAqB,UAAU;EACzC;EACA,OAAO;IAAQ;IAAyB,SAAS;MAAa;EAC9D,OAAO;IACL;IACA;IACA;IACA,SAAS;;IACL;IAAyB,SAAS;;EACxC,MAAM,SAAS;;;;;;;;;;;;cAaJ,6BAA8B,UAAU,gBACnD;EACE,SACE,kBACA,mBACA,yBACA,gBACA,SAAS,uBACN;EACL,OAAO,kBAAkB,oBAAoB;EAC7C,cAAc;EACd,UACE,kBACA,mBACA,gBACA,SAAS,uBACN;GAEP,SAAS,qBAAqB,UAAU;EAG5B,SAAA,kBAAM;IACR;IAAyB,SAAS;QACzC;EAaa,UAAA,kBAAM;IACR;IAAyB,SAAS;KAAU,sBAEnD;EAUgB,OAAA,qBAAM;;MA/Db;;;;EA+ES,cAAA"}

package/dist/cloudResponse.d.ts

@@ -0,0 +1,16 @@
+import { ReadonlyJSONObject } from "assistant-stream/utils";
+//#region src/cloudResponse.d.ts
+declare class CloudResponseError extends Error {
+  constructor(message: string);
+}
+declare const readCloudRecord: (value: unknown, field: string) => Record<string, unknown>;
+declare const readCloudArray: (value: unknown, field: string) => unknown[];
+declare const readCloudString: (value: unknown, field: string) => string;
+declare const readCloudNullableString: (value: unknown, field: string) => string | null;
+declare const readCloudBoolean: (value: unknown, field: string) => boolean;
+declare const readCloudInteger: (value: unknown, field: string) => number;
+declare const readCloudTimestamp: (value: unknown, field: string) => Date;
+declare const readCloudJSONObject: (value: unknown, field: string) => ReadonlyJSONObject;
+//#endregion
+export { CloudResponseError, readCloudArray, readCloudBoolean, readCloudInteger, readCloudJSONObject, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp };
+//# sourceMappingURL=cloudResponse.d.ts.map

package/dist/cloudResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudResponse.d.ts","names":[],"sources":["../src/cloudResponse.ts"],"mappings":";;cAEa,2BAA2B;EAC1B,YAAA;;cAWD,kBACX,gBACA,kBACC;cAOU,iBAAkB,gBAAgB;cAKlC,kBAAmB,gBAAgB;cAKnC,0BACX,gBACA;cAMW,mBAAoB,gBAAgB;cAOpC,mBAAoB,gBAAgB;cAKpC,qBAAsB,gBAAgB,kBAAgB;cActD,sBACX,gBACA,kBACC"}

package/dist/cloudResponse.js

@@ -0,0 +1,43 @@
+//#region src/cloudResponse.ts
+var CloudResponseError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CloudResponseError";
+	}
+};
+const invalidCloudResponse = (field, expected) => new CloudResponseError(`Invalid Assistant Cloud response for "${field}": expected ${expected}`);
+const readCloudRecord = (value, field) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw invalidCloudResponse(field, "an object");
+	return value;
+};
+const readCloudArray = (value, field) => {
+	if (!Array.isArray(value)) throw invalidCloudResponse(field, "an array");
+	return value;
+};
+const readCloudString = (value, field) => {
+	if (typeof value !== "string") throw invalidCloudResponse(field, "a string");
+	return value;
+};
+const readCloudNullableString = (value, field) => {
+	if (value === null) return null;
+	return readCloudString(value, field);
+};
+const readCloudBoolean = (value, field) => {
+	if (typeof value !== "boolean") throw invalidCloudResponse(field, "a boolean");
+	return value;
+};
+const readCloudInteger = (value, field) => {
+	if (!Number.isInteger(value)) throw invalidCloudResponse(field, "an integer");
+	return value;
+};
+const readCloudTimestamp = (value, field) => {
+	if (typeof value !== "string") throw invalidCloudResponse(field, "a canonical ISO timestamp");
+	const date = new Date(value);
+	if (Number.isNaN(date.getTime()) || date.toISOString() !== value) throw invalidCloudResponse(field, "a canonical ISO timestamp");
+	return date;
+};
+const readCloudJSONObject = (value, field) => readCloudRecord(value, field);
+//#endregion
+export { CloudResponseError, readCloudArray, readCloudBoolean, readCloudInteger, readCloudJSONObject, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp };
+
+//# sourceMappingURL=cloudResponse.js.map

package/dist/cloudResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudResponse.js","names":[],"sources":["../src/cloudResponse.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\n\nexport class CloudResponseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CloudResponseError\";\n  }\n}\n\nconst invalidCloudResponse = (field: string, expected: string) =>\n  new CloudResponseError(\n    `Invalid Assistant Cloud response for \"${field}\": expected ${expected}`,\n  );\n\nexport const readCloudRecord = (\n  value: unknown,\n  field: string,\n): Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw invalidCloudResponse(field, \"an object\");\n  }\n  return value as Record<string, unknown>;\n};\n\nexport const readCloudArray = (value: unknown, field: string): unknown[] => {\n  if (!Array.isArray(value)) throw invalidCloudResponse(field, \"an array\");\n  return value;\n};\n\nexport const readCloudString = (value: unknown, field: string): string => {\n  if (typeof value !== \"string\") throw invalidCloudResponse(field, \"a string\");\n  return value;\n};\n\nexport const readCloudNullableString = (\n  value: unknown,\n  field: string,\n): string | null => {\n  if (value === null) return null;\n  return readCloudString(value, field);\n};\n\nexport const readCloudBoolean = (value: unknown, field: string): boolean => {\n  if (typeof value !== \"boolean\") {\n    throw invalidCloudResponse(field, \"a boolean\");\n  }\n  return value;\n};\n\nexport const readCloudInteger = (value: unknown, field: string): number => {\n  if (!Number.isInteger(value)) throw invalidCloudResponse(field, \"an integer\");\n  return value as number;\n};\n\nexport const readCloudTimestamp = (value: unknown, field: string): Date => {\n  if (typeof value !== \"string\") {\n    throw invalidCloudResponse(field, \"a canonical ISO timestamp\");\n  }\n\n  const date = new Date(value);\n  // The round trip pins the backend DTO's Date#toISOString() wire contract.\n  if (Number.isNaN(date.getTime()) || date.toISOString() !== value) {\n    throw invalidCloudResponse(field, \"a canonical ISO timestamp\");\n  }\n\n  return date;\n};\n\nexport const readCloudJSONObject = (\n  value: unknown,\n  field: string,\n): ReadonlyJSONObject => readCloudRecord(value, field) as ReadonlyJSONObject;\n"],"mappings":";AAEA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,MAAM,wBAAwB,OAAe,aAC3C,IAAI,mBACF,yCAAyC,MAAM,cAAc,UAC/D;AAEF,MAAa,mBACX,OACA,UAC4B;CAC5B,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,MAAM,qBAAqB,OAAO,WAAW;CAE/C,OAAO;AACT;AAEA,MAAa,kBAAkB,OAAgB,UAA6B;CAC1E,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,MAAM,qBAAqB,OAAO,UAAU;CACvE,OAAO;AACT;AAEA,MAAa,mBAAmB,OAAgB,UAA0B;CACxE,IAAI,OAAO,UAAU,UAAU,MAAM,qBAAqB,OAAO,UAAU;CAC3E,OAAO;AACT;AAEA,MAAa,2BACX,OACA,UACkB;CAClB,IAAI,UAAU,MAAM,OAAO;CAC3B,OAAO,gBAAgB,OAAO,KAAK;AACrC;AAEA,MAAa,oBAAoB,OAAgB,UAA2B;CAC1E,IAAI,OAAO,UAAU,WACnB,MAAM,qBAAqB,OAAO,WAAW;CAE/C,OAAO;AACT;AAEA,MAAa,oBAAoB,OAAgB,UAA0B;CACzE,IAAI,CAAC,OAAO,UAAU,KAAK,GAAG,MAAM,qBAAqB,OAAO,YAAY;CAC5E,OAAO;AACT;AAEA,MAAa,sBAAsB,OAAgB,UAAwB;CACzE,IAAI,OAAO,UAAU,UACnB,MAAM,qBAAqB,OAAO,2BAA2B;CAG/D,MAAM,OAAO,IAAI,KAAK,KAAK;CAE3B,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,YAAY,MAAM,OACzD,MAAM,qBAAqB,OAAO,2BAA2B;CAG/D,OAAO;AACT;AAEA,MAAa,uBACX,OACA,UACuB,gBAAgB,OAAO,KAAK"}

package/dist/index.d.ts

@@ -5,4 +5,5 @@ import { CloudMessage } from "./AssistantCloudThreadMessages.js";
 import { AssistantCloud } from "./AssistantCloud.js";
 import { CloudMessagePersistence } from "./CloudMessagePersistence.js";
 import { MessageFormatAdapter, createFormattedPersistence } from "./FormattedCloudPersistence.js";
-export { AssistantCloud, type AssistantCloudRunReport, type AssistantCloudTelemetryConfig, CloudAPIError, type CloudMessage, CloudMessagePersistence, type McpSamplingHandler, type MessageFormatAdapter, type SamplingCallData, createFormattedPersistence, createSamplingCollector, wrapSamplingHandler };
+import { CloudResponseError } from "./cloudResponse.js";
+export { AssistantCloud, type AssistantCloudRunReport, type AssistantCloudTelemetryConfig, CloudAPIError, type CloudMessage, CloudMessagePersistence, CloudResponseError, type McpSamplingHandler, type MessageFormatAdapter, type SamplingCallData, createFormattedPersistence, createSamplingCollector, wrapSamplingHandler };

package/dist/index.js

@@ -1,6 +1,7 @@
 import { CloudAPIError } from "./AssistantCloudAPI.js";
+import { CloudResponseError } from "./cloudResponse.js";
 import { AssistantCloud } from "./AssistantCloud.js";
 import { CloudMessagePersistence } from "./CloudMessagePersistence.js";
 import { createFormattedPersistence } from "./FormattedCloudPersistence.js";
 import { createSamplingCollector, wrapSamplingHandler } from "./instrumentMcpSampling.js";
-export { AssistantCloud, CloudAPIError, CloudMessagePersistence, createFormattedPersistence, createSamplingCollector, wrapSamplingHandler };
+export { AssistantCloud, CloudAPIError, CloudMessagePersistence, CloudResponseError, createFormattedPersistence, createSamplingCollector, wrapSamplingHandler };

package/dist/instrumentMcpSampling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentMcpSampling.d.ts","names":[],"sources":["../src/instrumentMcpSampling.ts"],"mappings":";;;;;;;;KAQY;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU,sBACV,SAAS,uBACN,QAAQ;KAED;EACV;EACA;IACE;IACA;MAAqB;QAAU;;;IAC/B;KACC;;;KAIO;EACV;EACA;EACA;IACE;IACA;IACA;IACA;IACA;IACA;;GAED;;;;;;;;;;;;;;;;;;;;iBAqBa,oBACd,SAAS,oBACT,iBAAiB,MAAM,4BACtB;;;;;;;;;;;;;iBA6Ca;kBAGI;kBAAA"}
+{"version":3,"file":"instrumentMcpSampling.d.ts","names":[],"sources":["../src/instrumentMcpSampling.ts"],"mappings":";;;;;;;;KAQY;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU,sBACV,SAAS,uBACN,QAAQ;KAED;EACV;EACA;IACE;IACA;MAAqB;QAAU;;;IAC/B;KACC;;;KAIO;EACV;EACA;EACA;IACE;IACA;IACA;IACA;IACA;IACA;;GAED;;;;;;;;;;;;;;;;;;;;iBAqBa,oBACd,SAAS,oBACT,iBAAiB,MAAM,4BACtB;;;;;;;;;;;;;iBA6Ca;EAGI,UAAA,MAAA;kBAAA"}

package/dist/tests/setup.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/tests/setup.js

@@ -1,9 +1,7 @@
 import { vi } from "vitest";
 //#region src/tests/setup.ts
-const OriginalDate = globalThis.Date;
-const fixedDate = new OriginalDate("2023-01-01");
-globalThis.Date = vi.fn(() => fixedDate);
-globalThis.Date.now = vi.fn(() => fixedDate.getTime());
+vi.useFakeTimers({ toFake: ["Date"] });
+vi.setSystemTime(/* @__PURE__ */ new Date("2023-01-01T00:00:00.000Z"));
 //#endregion
 
 //# sourceMappingURL=setup.js.map

package/dist/tests/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","names":[],"sources":["../../src/tests/setup.ts"],"sourcesContent":["// This file contains setup code for tests\nimport { vi } from \"vitest\";\n\n// Set up globalThis mocks if needed\n// Using a fixed date to avoid recursive calls\nconst OriginalDate = globalThis.Date;\nconst fixedDate = new OriginalDate(\"2023-01-01\");\nglobalThis.Date = vi.fn(() => fixedDate) as any;\nglobalThis.Date.now = vi.fn(() => fixedDate.getTime());\n\n// Add any other globalThis setup needed for tests\n"],"mappings":";;AAKA,MAAM,eAAe,WAAW;AAChC,MAAM,YAAY,IAAI,aAAa,YAAY;AAC/C,WAAW,OAAO,GAAG,SAAS,SAAS;AACvC,WAAW,KAAK,MAAM,GAAG,SAAS,UAAU,QAAQ,CAAC"}
+{"version":3,"file":"setup.js","names":[],"sources":["../../src/tests/setup.ts"],"sourcesContent":["import { vi } from \"vitest\";\n\nvi.useFakeTimers({ toFake: [\"Date\"] });\nvi.setSystemTime(new Date(\"2023-01-01T00:00:00.000Z\"));\n"],"mappings":";;AAEA,GAAG,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AACrC,GAAG,8BAAc,IAAI,KAAK,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-cloud",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "description": "Cloud integration for assistant-ui",
   "keywords": [
     "assistant",
@@ -27,12 +27,12 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.26"
+    "assistant-stream": "^0.3.28"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
     "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.18"
+    "@assistant-ui/x-buildutils": "0.0.20"
   },
   "publishConfig": {
     "access": "public",

package/src/AssistantCloud.ts

@@ -4,12 +4,14 @@ import {
   type AssistantCloudTelemetryConfig,
 } from "./AssistantCloudAPI";
 import { AssistantCloudAuthTokens } from "./AssistantCloudAuthTokens";
+import { AssistantCloudProjects } from "./AssistantCloudProjects";
 import { AssistantCloudRuns } from "./AssistantCloudRuns";
 import { AssistantCloudThreads } from "./AssistantCloudThreads";
 import { AssistantCloudFiles } from "./AssistantCloudFiles";
 
 export class AssistantCloud {
   public readonly threads;
+  public readonly projects;
   public readonly auth;
   public readonly runs;
   public readonly files;
@@ -18,6 +20,7 @@ export class AssistantCloud {
   constructor(config: AssistantCloudConfig) {
     const api = new AssistantCloudAPI(config);
     this.threads = new AssistantCloudThreads(api);
+    this.projects = new AssistantCloudProjects(api);
     this.auth = {
       tokens: new AssistantCloudAuthTokens(api),
     };

package/src/AssistantCloudAPI.ts

@@ -49,11 +49,11 @@ export type AssistantCloudConfig = (
 };
 
 export class CloudAPIError extends Error {
-  constructor(
-    message: string,
-    public readonly status: number,
-  ) {
+  public readonly status: number;
+
+  constructor(message: string, status: number) {
     super(message);
+    this.status = status;
     this.name = "CloudAPIError";
   }
 }
@@ -65,26 +65,31 @@ type MakeRequestOptions = {
   body?: object | undefined;
 };
 
+const normalizeBaseUrl = (baseUrl: string) => {
+  if (!baseUrl || !baseUrl.endsWith("/")) return baseUrl;
+  return baseUrl.slice(0, -1);
+};
+
 export class AssistantCloudAPI {
   public _auth: AssistantCloudAuthStrategy;
   public _baseUrl;
 
   constructor(config: AssistantCloudConfig) {
     if ("authToken" in config) {
-      this._baseUrl = config.baseUrl;
+      this._baseUrl = normalizeBaseUrl(config.baseUrl);
       this._auth = new AssistantCloudJWTAuthStrategy(config.authToken);
     } else if ("apiKey" in config) {
-      this._baseUrl = (
-        config.baseUrl ?? "https://backend.assistant-api.com"
-      ).replace(/\/$/, "");
+      this._baseUrl = normalizeBaseUrl(
+        config.baseUrl ?? "https://backend.assistant-api.com",
+      );
       this._auth = new AssistantCloudAPIKeyAuthStrategy(
         config.apiKey,
         config.userId,
         config.workspaceId,
       );
     } else if ("anonymous" in config) {
-      this._baseUrl = config.baseUrl;
-      this._auth = new AssistantCloudAnonymousAuthStrategy(config.baseUrl);
+      this._baseUrl = normalizeBaseUrl(config.baseUrl);
+      this._auth = new AssistantCloudAnonymousAuthStrategy(this._baseUrl);
     } else {
       throw new Error(
         "Invalid configuration: Must provide authToken, apiKey, or anonymous configuration",

package/src/AssistantCloudAuthStrategy.ts

@@ -39,6 +39,7 @@ export class AssistantCloudJWTAuthStrategy implements AssistantCloudAuthStrategy
 
   private cachedToken: string | null = null;
   private tokenExpiry: number | null = null;
+  private tokenRequest: Promise<Record<string, string> | false> | null = null;
   #authTokenCallback: () => Promise<string | null>;
 
   constructor(authTokenCallback: () => Promise<string | null>) {
@@ -57,14 +58,28 @@ export class AssistantCloudJWTAuthStrategy implements AssistantCloudAuthStrategy
       return { Authorization: `Bearer ${this.cachedToken}` };
     }
 
-    // Fetch a new token via the callback
-    const newToken = await this.#authTokenCallback();
-    if (!newToken) return false;
+    if (!this.tokenRequest) {
+      this.tokenRequest = this.fetchAuthHeaders();
+    }
+
+    const tokenRequest = this.tokenRequest;
+    try {
+      return await tokenRequest;
+    } finally {
+      if (this.tokenRequest === tokenRequest) {
+        this.tokenRequest = null;
+      }
+    }
+  }
+
+  private async fetchAuthHeaders(): Promise<Record<string, string> | false> {
+    const token = await this.#authTokenCallback();
+    if (!token) return false;
 
-    this.cachedToken = newToken;
-    this.tokenExpiry = getJwtExpiry(newToken);
+    this.cachedToken = token;
+    this.tokenExpiry = getJwtExpiry(token);
 
-    return { Authorization: `Bearer ${newToken}` };
+    return { Authorization: `Bearer ${token}` };
   }
 
   public readAuthHeaders(headers: Headers) {

package/src/AssistantCloudAuthTokens.ts

@@ -5,7 +5,11 @@ type AssistantCloudAuthTokensCreateResponse = {
 };
 
 export class AssistantCloudAuthTokens {
-  constructor(private cloud: AssistantCloudAPI) {}
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+  }
 
   public async create(): Promise<AssistantCloudAuthTokensCreateResponse> {
     return this.cloud.makeRequest("/auth/tokens", { method: "POST" });

package/src/AssistantCloudFiles.ts

@@ -23,7 +23,11 @@ type GeneratePresignedUploadUrlResponse = {
 };
 
 export class AssistantCloudFiles {
-  constructor(private cloud: AssistantCloudAPI) {}
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+  }
 
   public async pdfToImages(
     body: PdfToImagesRequestBody,

package/src/AssistantCloudProjectThreadMessages.ts

@@ -0,0 +1,44 @@
+import type { AssistantCloudAPI } from "./AssistantCloudAPI";
+import {
+  decodeCloudMessage,
+  type CloudMessage,
+} from "./AssistantCloudThreadMessages";
+import { readCloudArray, readCloudRecord } from "./cloudResponse";
+
+type AssistantCloudProjectThreadMessageListQuery = {
+  format?: string;
+  limit?: number;
+  after?: string;
+};
+
+type AssistantCloudProjectThreadMessageListResponse = {
+  messages: CloudMessage[];
+};
+
+export class AssistantCloudProjectThreadMessages {
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+  }
+
+  public async list(
+    threadId: string,
+    query?: AssistantCloudProjectThreadMessageListQuery,
+  ): Promise<AssistantCloudProjectThreadMessageListResponse> {
+    const response = readCloudRecord(
+      await this.cloud.makeRequest(
+        `/projects/threads/${encodeURIComponent(threadId)}/messages`,
+        { query },
+      ),
+      "project thread message list response",
+    );
+    const messages = readCloudArray(response.messages, "messages");
+
+    return {
+      messages: messages.map((message, index) =>
+        decodeCloudMessage(message, `messages[${index}]`),
+      ),
+    };
+  }
+}

package/src/AssistantCloudProjectThreads.ts

@@ -0,0 +1,50 @@
+import type { AssistantCloudAPI } from "./AssistantCloudAPI";
+import { AssistantCloudProjectThreadMessages } from "./AssistantCloudProjectThreadMessages";
+import { decodeCloudThread, type CloudThread } from "./AssistantCloudThreads";
+import { readCloudArray, readCloudRecord } from "./cloudResponse";
+
+type AssistantCloudProjectThreadsListQuery = {
+  is_archived?: boolean;
+  limit?: number;
+  after?: string;
+};
+
+type AssistantCloudProjectThreadsListResponse = {
+  threads: CloudThread[];
+};
+
+export class AssistantCloudProjectThreads {
+  public readonly messages: AssistantCloudProjectThreadMessages;
+
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+    this.messages = new AssistantCloudProjectThreadMessages(cloud);
+  }
+
+  public async list(
+    query?: AssistantCloudProjectThreadsListQuery,
+  ): Promise<AssistantCloudProjectThreadsListResponse> {
+    const response = readCloudRecord(
+      await this.cloud.makeRequest("/projects/threads", {
+        query: {
+          ...query,
+          // The shared query serializer drops `false`; the wire accepts the
+          // string form, so the archive filter survives explicitly.
+          ...(query?.is_archived !== undefined
+            ? { is_archived: String(query.is_archived) }
+            : {}),
+        },
+      }),
+      "project thread list response",
+    );
+    const threads = readCloudArray(response.threads, "threads");
+
+    return {
+      threads: threads.map((thread, index) =>
+        decodeCloudThread(thread, `threads[${index}]`),
+      ),
+    };
+  }
+}

package/src/AssistantCloudProjects.ts

@@ -0,0 +1,10 @@
+import type { AssistantCloudAPI } from "./AssistantCloudAPI";
+import { AssistantCloudProjectThreads } from "./AssistantCloudProjectThreads";
+
+export class AssistantCloudProjects {
+  public readonly threads: AssistantCloudProjectThreads;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.threads = new AssistantCloudProjectThreads(cloud);
+  }
+}

package/src/AssistantCloudRuns.ts

@@ -48,7 +48,11 @@ export type AssistantCloudRunReport = {
 };
 
 export class AssistantCloudRuns {
-  constructor(private cloud: AssistantCloudAPI) {}
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+  }
 
   public __internal_getAssistantOptions(assistantId: string) {
     return {

package/src/AssistantCloudThreadMessages.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from "vitest";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI";
+import { AssistantCloudThreadMessages } from "./AssistantCloudThreadMessages";
+
+const createCloudThreadMessages = () => {
+  const makeRequest = vi.fn();
+  const api = { makeRequest } as unknown as AssistantCloudAPI;
+  return {
+    messages: new AssistantCloudThreadMessages(api),
+    makeRequest,
+  };
+};
+
+describe("AssistantCloudThreadMessages responses", () => {
+  it("decodes canonical message responses without changing content", async () => {
+    const { messages, makeRequest } = createCloudThreadMessages();
+    makeRequest.mockResolvedValue({
+      messages: [
+        {
+          id: "message-1",
+          parent_id: null,
+          height: 0,
+          created_at: "2026-07-16T13:00:00.000Z",
+          updated_at: "2026-07-16T13:05:00.987Z",
+          format: "aui/v0",
+          content: { created_at: "leave-this-string-untouched" },
+        },
+      ],
+    });
+
+    const result = await messages.list("thread-1");
+    const message = result.messages[0]!;
+
+    expect(message.created_at).toBeInstanceOf(Date);
+    expect(message.updated_at).toBeInstanceOf(Date);
+    expect(message.updated_at.toISOString()).toBe("2026-07-16T13:05:00.987Z");
+    expect(message.content).toEqual({
+      created_at: "leave-this-string-untouched",
+    });
+  });
+});

package/src/AssistantCloudThreadMessages.ts

@@ -1,5 +1,14 @@
 import type { ReadonlyJSONObject } from "assistant-stream/utils";
 import type { AssistantCloudAPI } from "./AssistantCloudAPI";
+import {
+  readCloudArray,
+  readCloudInteger,
+  readCloudJSONObject,
+  readCloudNullableString,
+  readCloudRecord,
+  readCloudString,
+  readCloudTimestamp,
+} from "./cloudResponse";
 
 export type CloudMessage = {
   id: string;
@@ -33,17 +42,47 @@ type AssistantCloudThreadMessageUpdateBody = {
   content: ReadonlyJSONObject;
 };
 
+export const decodeCloudMessage = (
+  value: unknown,
+  field: string,
+): CloudMessage => {
+  const message = readCloudRecord(value, field);
+  return {
+    id: readCloudString(message.id, `${field}.id`),
+    parent_id: readCloudNullableString(message.parent_id, `${field}.parent_id`),
+    height: readCloudInteger(message.height, `${field}.height`),
+    created_at: readCloudTimestamp(message.created_at, `${field}.created_at`),
+    updated_at: readCloudTimestamp(message.updated_at, `${field}.updated_at`),
+    format: readCloudString(message.format, `${field}.format`),
+    content: readCloudJSONObject(message.content, `${field}.content`),
+  };
+};
+
 export class AssistantCloudThreadMessages {
-  constructor(private cloud: AssistantCloudAPI) {}
+  private cloud: AssistantCloudAPI;
+
+  constructor(cloud: AssistantCloudAPI) {
+    this.cloud = cloud;
+  }
 
   public async list(
     threadId: string,
     query?: AssistantCloudThreadMessageListQuery,
   ): Promise<AssistantCloudThreadMessageListResponse> {
-    return this.cloud.makeRequest(
-      `/threads/${encodeURIComponent(threadId)}/messages`,
-      { query },
+    const response = readCloudRecord(
+      await this.cloud.makeRequest(
+        `/threads/${encodeURIComponent(threadId)}/messages`,
+        { query },
+      ),
+      "thread message list response",
     );
+    const messages = readCloudArray(response.messages, "messages");
+
+    return {
+      messages: messages.map((message, index) =>
+        decodeCloudMessage(message, `messages[${index}]`),
+      ),
+    };
   }
 
   public async create(