assistant-cloud 0.1.42 → 0.2.0

package/dist/CloudMessagePersistence.js

@@ -1,4 +1,5 @@
 //#region src/CloudMessagePersistence.ts
+const CLOUD_MESSAGE_PAGE_SIZE = 200;
 /**
 * Shared persistence logic for cloud message storage.
 *
@@ -11,7 +12,7 @@
 * to get its remote ID before creating B.
 */
 var CloudMessagePersistence = class {
-	idMapping = {};
+	idMapping = /* @__PURE__ */ new Map();
 	getCloud;
 	constructor(cloud) {
 		this.getCloud = typeof cloud === "function" ? cloud : () => cloud;
@@ -27,20 +28,29 @@ var CloudMessagePersistence = class {
 	*/
 	async append(threadId, messageId, parentId, format, content) {
 		const cloud = this.getCloud();
-		const resolvedParentId = parentId ? await this.idMapping[parentId] ?? parentId : null;
-		const task = cloud.threads.messages.create(threadId, {
-			parent_id: resolvedParentId,
-			format,
-			content
-		}).then(({ message_id }) => {
-			this.idMapping[messageId] = message_id;
+		const existing = this.idMapping.get(messageId);
+		if (existing instanceof Promise) {
+			await existing;
+			return;
+		}
+		const task = (async () => {
+			const parentEntry = parentId ? this.idMapping.get(parentId) : void 0;
+			const resolvedParentId = parentId ? await parentEntry ?? parentId : null;
+			const { message_id } = await cloud.threads.messages.create(threadId, {
+				parent_id: resolvedParentId,
+				format,
+				content
+			});
 			return message_id;
-		}).catch((err) => {
-			if (this.idMapping[messageId] === task) delete this.idMapping[messageId];
+		})();
+		this.idMapping.set(messageId, task);
+		try {
+			const remoteId = await task;
+			if (this.idMapping.get(messageId) === task) this.idMapping.set(messageId, remoteId);
+		} catch (err) {
+			if (this.idMapping.get(messageId) === task) this.idMapping.delete(messageId);
 			throw err;
-		});
-		this.idMapping[messageId] = task;
-		return task.then(() => {});
+		}
 	}
 	/**
 	* Update an already-persisted message in the cloud.
@@ -58,20 +68,27 @@ var CloudMessagePersistence = class {
 	* Check if a message has been persisted (or is currently being persisted).
 	*/
 	isPersisted(messageId) {
-		return messageId in this.idMapping;
+		return this.idMapping.has(messageId);
 	}
 	/**
 	* Get the remote ID for a local message ID (resolved).
 	* Returns undefined if not persisted.
 	*/
 	async getRemoteId(messageId) {
-		const entry = this.idMapping[messageId];
+		const entry = this.idMapping.get(messageId);
 		if (!entry) return void 0;
 		return entry;
 	}
+	getResolvedRemoteId(messageId) {
+		const entry = this.idMapping.get(messageId);
+		return typeof entry === "string" ? entry : void 0;
+	}
 	/**
 	* Load messages from the cloud and populate the ID mapping.
 	*
+	* The list endpoint caps a response at 200 rows, so pages are followed by
+	* message ID cursor until a short page and concatenated in server order.
+	*
 	* The ID mapping is populated so that `isPersisted()` returns true for
 	* loaded messages, preventing re-persistence of already-stored messages.
 	*
@@ -80,15 +97,33 @@ var CloudMessagePersistence = class {
 	* @returns Array of cloud messages
 	*/
 	async load(threadId, format) {
-		const { messages } = await this.getCloud().threads.messages.list(threadId, format ? { format } : void 0);
-		for (const m of messages) this.idMapping[m.id] = m.id;
+		const cloud = this.getCloud();
+		const messages = [];
+		const seen = /* @__PURE__ */ new Set();
+		let after;
+		while (true) {
+			const page = await cloud.threads.messages.list(threadId, {
+				...format ? { format } : void 0,
+				limit: CLOUD_MESSAGE_PAGE_SIZE,
+				...after ? { after } : void 0
+			});
+			const last = page.messages.at(-1);
+			if (!last) break;
+			const fresh = page.messages.filter((m) => !seen.has(m.id));
+			if (fresh.length === 0) break;
+			for (const m of fresh) seen.add(m.id);
+			messages.push(...fresh);
+			if (page.messages.length < CLOUD_MESSAGE_PAGE_SIZE) break;
+			after = last.id;
+		}
+		for (const m of messages) this.idMapping.set(m.id, m.id);
 		return messages;
 	}
 	/**
 	* Reset the ID mapping (call when switching threads).
 	*/
 	reset() {
-		this.idMapping = {};
+		this.idMapping.clear();
 	}
 };
 //#endregion

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  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"}
+{"version":3,"file":"CloudMessagePersistence.js","names":[],"sources":["../src/CloudMessagePersistence.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { AssistantCloud } from \"./AssistantCloud\";\nimport type { CloudMessage } from \"./AssistantCloudThreadMessages\";\n\nconst CLOUD_MESSAGE_PAGE_SIZE = 200;\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 = new Map<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    const existing = this.idMapping.get(messageId);\n    if (existing instanceof Promise) {\n      await existing;\n      return;\n    }\n\n    const task = (async () => {\n      const parentEntry = parentId ? this.idMapping.get(parentId) : undefined;\n      const resolvedParentId = parentId\n        ? ((await parentEntry) ?? parentId)\n        : null;\n      const { message_id } = await cloud.threads.messages.create(threadId, {\n        parent_id: resolvedParentId,\n        format,\n        content,\n      });\n      return message_id;\n    })();\n\n    this.idMapping.set(messageId, task);\n    try {\n      const remoteId = await task;\n      if (this.idMapping.get(messageId) === task) {\n        this.idMapping.set(messageId, remoteId);\n      }\n    } catch (err) {\n      if (this.idMapping.get(messageId) === task) {\n        this.idMapping.delete(messageId);\n      }\n      throw err;\n    }\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 this.idMapping.has(messageId);\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.get(messageId);\n    if (!entry) return undefined;\n    return entry;\n  }\n\n  getResolvedRemoteId(messageId: string): string | undefined {\n    const entry = this.idMapping.get(messageId);\n    return typeof entry === \"string\" ? entry : undefined;\n  }\n\n  /**\n   * Load messages from the cloud and populate the ID mapping.\n   *\n   * The list endpoint caps a response at 200 rows, so pages are followed by\n   * message ID cursor until a short page and concatenated in server order.\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: CloudMessage[] = [];\n    const seen = new Set<string>();\n    let after: string | undefined;\n\n    while (true) {\n      const page = await cloud.threads.messages.list(threadId, {\n        ...(format ? { format } : undefined),\n        limit: CLOUD_MESSAGE_PAGE_SIZE,\n        ...(after ? { after } : undefined),\n      });\n      const last = page.messages.at(-1);\n      if (!last) break;\n\n      // A cursor the server cannot resolve drops the keyset filter and replays\n      // an earlier page, so already-seen rows end the walk instead of repeating.\n      const fresh = page.messages.filter((m) => !seen.has(m.id));\n      if (fresh.length === 0) break;\n      for (const m of fresh) seen.add(m.id);\n\n      messages.push(...fresh);\n      if (page.messages.length < CLOUD_MESSAGE_PAGE_SIZE) break;\n      after = last.id;\n    }\n\n    // Populate ID mapping so isPersisted() recognizes loaded messages\n    for (const m of messages) {\n      this.idMapping.set(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.clear();\n  }\n}\n"],"mappings":";AAIA,MAAM,0BAA0B;;;;;;;;;;;;AAahC,IAAa,0BAAb,MAAqC;CACnC,4BAAoB,IAAI,IAAsC;CAC9D;CAIA,YAAY,OAAgD;EAC1D,KAAK,WAAW,OAAO,UAAU,aAAa,cAAc;CAC9D;;;;;;;;;;CAWA,MAAM,OACJ,UACA,WACA,UACA,QACA,SACe;EACf,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,WAAW,KAAK,UAAU,IAAI,SAAS;EAC7C,IAAI,oBAAoB,SAAS;GAC/B,MAAM;GACN;EACF;EAEA,MAAM,QAAQ,YAAY;GACxB,MAAM,cAAc,WAAW,KAAK,UAAU,IAAI,QAAQ,IAAI,KAAA;GAC9D,MAAM,mBAAmB,WACnB,MAAM,eAAgB,WACxB;GACJ,MAAM,EAAE,eAAe,MAAM,MAAM,QAAQ,SAAS,OAAO,UAAU;IACnE,WAAW;IACX;IACA;GACF,CAAC;GACD,OAAO;EACT,EAAA,CAAG;EAEH,KAAK,UAAU,IAAI,WAAW,IAAI;EAClC,IAAI;GACF,MAAM,WAAW,MAAM;GACvB,IAAI,KAAK,UAAU,IAAI,SAAS,MAAM,MACpC,KAAK,UAAU,IAAI,WAAW,QAAQ;EAE1C,SAAS,KAAK;GACZ,IAAI,KAAK,UAAU,IAAI,SAAS,MAAM,MACpC,KAAK,UAAU,OAAO,SAAS;GAEjC,MAAM;EACR;CACF;;;;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,KAAK,UAAU,IAAI,SAAS;CACrC;;;;;CAMA,MAAM,YAAY,WAAgD;EAChE,MAAM,QAAQ,KAAK,UAAU,IAAI,SAAS;EAC1C,IAAI,CAAC,OAAO,OAAO,KAAA;EACnB,OAAO;CACT;CAEA,oBAAoB,WAAuC;EACzD,MAAM,QAAQ,KAAK,UAAU,IAAI,SAAS;EAC1C,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;CAC7C;;;;;;;;;;;;;;CAeA,MAAM,KAAK,UAAkB,QAAiB;EAC5C,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,WAA2B,CAAC;EAClC,MAAM,uBAAO,IAAI,IAAY;EAC7B,IAAI;EAEJ,OAAO,MAAM;GACX,MAAM,OAAO,MAAM,MAAM,QAAQ,SAAS,KAAK,UAAU;IACvD,GAAI,SAAS,EAAE,OAAO,IAAI,KAAA;IAC1B,OAAO;IACP,GAAI,QAAQ,EAAE,MAAM,IAAI,KAAA;GAC1B,CAAC;GACD,MAAM,OAAO,KAAK,SAAS,GAAG,EAAE;GAChC,IAAI,CAAC,MAAM;GAIX,MAAM,QAAQ,KAAK,SAAS,QAAQ,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;GACzD,IAAI,MAAM,WAAW,GAAG;GACxB,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE,EAAE;GAEpC,SAAS,KAAK,GAAG,KAAK;GACtB,IAAI,KAAK,SAAS,SAAS,yBAAyB;GACpD,QAAQ,KAAK;EACf;EAGA,KAAK,MAAM,KAAK,UACd,KAAK,UAAU,IAAI,EAAE,IAAI,EAAE,EAAE;EAE/B,OAAO;CACT;;;;CAKA,QAAQ;EACN,KAAK,UAAU,MAAM;CACvB;AACF"}

package/dist/cloudResponse.d.ts

@@ -6,11 +6,14 @@ declare class CloudResponseError extends Error {
 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 readCloudNumber: (value: unknown, field: string) => number;
+declare const readCloudNullableNumber: (value: unknown, field: string) => number | null;
+declare const readCloudEnum: <const T extends readonly string[]>(value: unknown, field: string, allowed: T) => T[number];
 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 };
+export { CloudResponseError, readCloudArray, readCloudBoolean, readCloudEnum, readCloudInteger, readCloudJSONObject, readCloudNullableNumber, readCloudNullableString, readCloudNumber, readCloudRecord, readCloudString, readCloudTimestamp };
 //# sourceMappingURL=cloudResponse.d.ts.map

package/dist/cloudResponse.d.ts.map

@@ -1 +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"}
+{"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,kBAAmB,gBAAgB;cAOnC,0BACX,gBACA;cAMW,sBAAuB,6BAClC,gBACA,eACA,SAAS,MACR;cAWU,0BACX,gBACA;cAMW,mBAAoB,gBAAgB;cAOpC,mBAAoB,gBAAgB;cAKpC,qBAAsB,gBAAgB,kBAAgB;cActD,sBACX,gBACA,kBACC"}

package/dist/cloudResponse.js

@@ -18,6 +18,19 @@ const readCloudString = (value, field) => {
 	if (typeof value !== "string") throw invalidCloudResponse(field, "a string");
 	return value;
 };
+const readCloudNumber = (value, field) => {
+	if (typeof value !== "number" || !Number.isFinite(value)) throw invalidCloudResponse(field, "a number");
+	return value;
+};
+const readCloudNullableNumber = (value, field) => {
+	if (value === null) return null;
+	return readCloudNumber(value, field);
+};
+const readCloudEnum = (value, field, allowed) => {
+	const text = readCloudString(value, field);
+	if (!allowed.includes(text)) throw invalidCloudResponse(field, `one of ${allowed.map((entry) => `"${entry}"`).join(", ")}`);
+	return text;
+};
 const readCloudNullableString = (value, field) => {
 	if (value === null) return null;
 	return readCloudString(value, field);
@@ -38,6 +51,6 @@ const readCloudTimestamp = (value, field) => {
 };
 const readCloudJSONObject = (value, field) => readCloudRecord(value, field);
 //#endregion
-export { CloudResponseError, readCloudArray, readCloudBoolean, readCloudInteger, readCloudJSONObject, readCloudNullableString, readCloudRecord, readCloudString, readCloudTimestamp };
+export { CloudResponseError, readCloudArray, readCloudBoolean, readCloudEnum, readCloudInteger, readCloudJSONObject, readCloudNullableNumber, readCloudNullableString, readCloudNumber, readCloudRecord, readCloudString, readCloudTimestamp };
 
 //# sourceMappingURL=cloudResponse.js.map

package/dist/cloudResponse.js.map

@@ -1 +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"}
+{"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 readCloudNumber = (value: unknown, field: string): number => {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\n    throw invalidCloudResponse(field, \"a number\");\n  }\n  return value;\n};\n\nexport const readCloudNullableNumber = (\n  value: unknown,\n  field: string,\n): number | null => {\n  if (value === null) return null;\n  return readCloudNumber(value, field);\n};\n\nexport const readCloudEnum = <const T extends readonly string[]>(\n  value: unknown,\n  field: string,\n  allowed: T,\n): T[number] => {\n  const text = readCloudString(value, field);\n  if (!allowed.includes(text)) {\n    throw invalidCloudResponse(\n      field,\n      `one of ${allowed.map((entry) => `\"${entry}\"`).join(\", \")}`,\n    );\n  }\n  return text;\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,mBAAmB,OAAgB,UAA0B;CACxE,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GACrD,MAAM,qBAAqB,OAAO,UAAU;CAE9C,OAAO;AACT;AAEA,MAAa,2BACX,OACA,UACkB;CAClB,IAAI,UAAU,MAAM,OAAO;CAC3B,OAAO,gBAAgB,OAAO,KAAK;AACrC;AAEA,MAAa,iBACX,OACA,OACA,YACc;CACd,MAAM,OAAO,gBAAgB,OAAO,KAAK;CACzC,IAAI,CAAC,QAAQ,SAAS,IAAI,GACxB,MAAM,qBACJ,OACA,UAAU,QAAQ,KAAK,UAAU,IAAI,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,GAC1D;CAEF,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

@@ -1,11 +1,15 @@
+import { readAnonymousRefreshToken } from "./AssistantCloudAuthStrategy.js";
 import { McpSamplingHandler, SamplingCallData, createSamplingCollector, wrapSamplingHandler } from "./instrumentMcpSampling.js";
-import { AssistantCloudRunReportToolCall, RunTelemetryToolCallInit, RunTelemetryUsage, RunTelemetryUsageInit, createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "./runTelemetry.js";
+import { AssistantCloudRunReportToolCall, RunReportInit, RunReportOutcome, RunReportStepInit, RunTelemetryToolCallInit, RunTelemetryUsage, RunTelemetryUsageInit, createRunReport, createRunTelemetryToolCall, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "./runTelemetry.js";
 import { AssistantCloudRunReport } from "./AssistantCloudRuns.js";
 import { AssistantCloudTelemetryConfig, CloudAPIError } from "./AssistantCloudAPI.js";
-import { CloudMessage } from "./AssistantCloudThreadMessages.js";
+import { AssistantCloudThreadMessageFeedbackBody, AssistantCloudThreadMessageFeedbackResponse, CloudMessage } from "./AssistantCloudThreadMessages.js";
+import { GeneratePresignedDownloadUrlResponse } from "./AssistantCloudFiles.js";
+import { AssistantCloudEvent, AssistantCloudEventKind, AssistantCloudEvents } from "./AssistantCloudEvents.js";
+import { AssistantCloudScoreBody, AssistantCloudScoreResponse, AssistantCloudScores } from "./AssistantCloudScores.js";
 import { AssistantCloud } from "./AssistantCloud.js";
 import { CloudMessagePersistence } from "./CloudMessagePersistence.js";
 import { MessageFormatAdapter, createFormattedPersistence } from "./FormattedCloudPersistence.js";
 import { CloudResponseError } from "./cloudResponse.js";
 import { generateThreadTitle } from "./generateThreadTitle.js";
-export { AssistantCloud, type AssistantCloudRunReport, type AssistantCloudRunReportToolCall, type AssistantCloudTelemetryConfig, CloudAPIError, type CloudMessage, CloudMessagePersistence, CloudResponseError, type McpSamplingHandler, type MessageFormatAdapter, type RunTelemetryToolCallInit, type RunTelemetryUsage, type RunTelemetryUsageInit, type SamplingCallData, createFormattedPersistence, createRunTelemetryToolCall, createSamplingCollector, generateThreadTitle, normalizeRunTelemetryUsage, truncateRunTelemetryText, wrapSamplingHandler };
+export { AssistantCloud, type AssistantCloudEvent, type AssistantCloudEventKind, AssistantCloudEvents, type AssistantCloudRunReport, type AssistantCloudRunReportToolCall, type AssistantCloudScoreBody, type AssistantCloudScoreResponse, AssistantCloudScores, type AssistantCloudTelemetryConfig, type AssistantCloudThreadMessageFeedbackBody, type AssistantCloudThreadMessageFeedbackResponse, CloudAPIError, type CloudMessage, CloudMessagePersistence, CloudResponseError, type GeneratePresignedDownloadUrlResponse, type McpSamplingHandler, type MessageFormatAdapter, type RunReportInit, type RunReportOutcome, type RunReportStepInit, type RunTelemetryToolCallInit, type RunTelemetryUsage, type RunTelemetryUsageInit, type SamplingCallData, createFormattedPersistence, createRunReport, createRunTelemetryToolCall, createSamplingCollector, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, generateThreadTitle, normalizeRunTelemetryUsage, readAnonymousRefreshToken, truncateRunTelemetryText, wrapSamplingHandler };

package/dist/index.js

@@ -1,9 +1,12 @@
 import { CloudResponseError } from "./cloudResponse.js";
+import { readAnonymousRefreshToken } from "./AssistantCloudAuthStrategy.js";
 import { CloudAPIError } from "./AssistantCloudAPI.js";
+import { AssistantCloudEvents } from "./AssistantCloudEvents.js";
+import { AssistantCloudScores } from "./AssistantCloudScores.js";
 import { AssistantCloud } from "./AssistantCloud.js";
 import { CloudMessagePersistence } from "./CloudMessagePersistence.js";
 import { createFormattedPersistence } from "./FormattedCloudPersistence.js";
 import { generateThreadTitle } from "./generateThreadTitle.js";
-import { createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "./runTelemetry.js";
+import { createRunReport, createRunTelemetryToolCall, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "./runTelemetry.js";
 import { createSamplingCollector, wrapSamplingHandler } from "./instrumentMcpSampling.js";
-export { AssistantCloud, CloudAPIError, CloudMessagePersistence, CloudResponseError, createFormattedPersistence, createRunTelemetryToolCall, createSamplingCollector, generateThreadTitle, normalizeRunTelemetryUsage, truncateRunTelemetryText, wrapSamplingHandler };
+export { AssistantCloud, AssistantCloudEvents, AssistantCloudScores, CloudAPIError, CloudMessagePersistence, CloudResponseError, createFormattedPersistence, createRunReport, createRunTelemetryToolCall, createSamplingCollector, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, generateThreadTitle, normalizeRunTelemetryUsage, readAnonymousRefreshToken, truncateRunTelemetryText, wrapSamplingHandler };

package/dist/runTelemetry.d.ts

@@ -1,4 +1,5 @@
 import { SamplingCallData } from "./instrumentMcpSampling.js";
+import { AssistantCloudRunReport } from "./AssistantCloudRuns.js";
 //#region src/runTelemetry.d.ts
 type AssistantCloudRunReportToolCall = {
   tool_name: string;
@@ -10,6 +11,28 @@ type AssistantCloudRunReportToolCall = {
   end_ms?: number;
   sampling_calls?: SamplingCallData[];
 };
+type RunReportOutcome = "aborted" | "disconnected" | "length" | "content_filter";
+/**
+ * Maps a finish event to the report status and outcome. `fallbackStatus`
+ * applies when the event carries neither a finish reason nor a failure flag.
+ */
+declare function deriveRunOutcome(input: {
+  finishReason?: string | undefined;
+  isAbort?: boolean | undefined;
+  isDisconnect?: boolean | undefined;
+  isError?: boolean | undefined;
+}, fallbackStatus?: "completed" | "incomplete"): {
+  status: "completed" | "incomplete" | "error";
+  outcome?: RunReportOutcome;
+};
+/**
+ * Reads the message and code the runs endpoint stores for a failed run. The
+ * code is the error's `code` when it has one, else its class name.
+ */
+declare function describeRunError(error: unknown): {
+  error?: string;
+  errorCode?: string;
+};
 /**
  * Clamps a string to the size the runs endpoint accepts for a single span
  * field.
@@ -33,22 +56,69 @@ type RunTelemetryToolCallInit = {
  * base64 image and audio payloads that would otherwise dominate the report.
  */
 declare function createRunTelemetryToolCall(init: RunTelemetryToolCallInit): AssistantCloudRunReportToolCall;
+/**
+ * Resolves the model ID a run reports, in the order an app can supply it: an
+ * explicit `modelId`, the `custom` bag, then the per-step `response.modelId`
+ * that a `messageMetadata` callback copies off the AI SDK's finish-step part.
+ * The AI SDK puts no model ID on a UI message part, so message metadata is the
+ * only channel one arrives on.
+ */
+declare function extractRunTelemetryModelId(metadata: Record<string, unknown> | undefined): string | undefined;
 type RunTelemetryUsage = {
-  inputTokens?: number;
-  outputTokens?: number;
-  reasoningTokens?: number;
-  cachedInputTokens?: number;
+  inputTokens?: number | undefined;
+  outputTokens?: number | undefined;
+  reasoningTokens?: number | undefined;
+  cachedInputTokens?: number | undefined;
 };
 type RunTelemetryUsageInit = RunTelemetryUsage & {
-  promptTokens?: number;
-  completionTokens?: number;
+  promptTokens?: number | undefined;
+  completionTokens?: number | undefined;
+  inputTokenDetails?: {
+    cacheReadTokens?: number;
+  };
+  outputTokenDetails?: {
+    reasoningTokens?: number;
+  };
+};
+type RunReportStepInit = {
+  usage?: RunTelemetryUsageInit | undefined;
+  toolCalls?: AssistantCloudRunReportToolCall[] | undefined;
+  startMs?: number | undefined;
+  endMs?: number | undefined;
+  finishReason?: string | undefined;
+};
+type RunReportInit = {
+  threadId: string;
+  status: AssistantCloudRunReport["status"];
+  outcome?: RunReportOutcome | undefined;
+  errorCode?: string | undefined;
+  error?: string | undefined;
+  messageId?: string | undefined;
+  traceId?: string | undefined;
+  modelId?: string | undefined;
+  provider?: string | undefined;
+  usage?: RunTelemetryUsageInit | undefined;
+  steps?: RunReportStepInit[] | undefined;
+  totalSteps?: number | undefined;
+  toolCalls?: AssistantCloudRunReportToolCall[] | undefined;
+  durationMs?: number | undefined;
+  firstTokenMs?: number | undefined;
+  outputText?: string | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  telemetry?: {
+    environment?: string | undefined;
+    release?: string | undefined;
+    tags?: readonly string[] | undefined;
+  };
 };
+declare function createRunReport(init: RunReportInit): AssistantCloudRunReport;
 /**
- * Resolves the token counts a provider reports under either the current or the
- * legacy prompt/completion names. Returns undefined when no count is present,
+ * Resolves the token counts a provider reports under any of the names the AI
+ * SDK has used: the current top-level ones, the legacy prompt/completion pair,
+ * and the v7 token detail objects. Returns undefined when no count is present,
  * so callers can tell an empty usage object from a zeroed one.
  */
 declare function normalizeRunTelemetryUsage(usage: RunTelemetryUsageInit): RunTelemetryUsage | undefined;
 //#endregion
-export { AssistantCloudRunReportToolCall, RunTelemetryToolCallInit, RunTelemetryUsage, RunTelemetryUsageInit, createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText };
+export { AssistantCloudRunReportToolCall, RunReportInit, RunReportOutcome, RunReportStepInit, RunTelemetryToolCallInit, RunTelemetryUsage, RunTelemetryUsageInit, createRunReport, createRunTelemetryToolCall, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, normalizeRunTelemetryUsage, truncateRunTelemetryText };
 //# sourceMappingURL=runTelemetry.d.ts.map

package/dist/runTelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runTelemetry.d.ts","names":[],"sources":["../src/runTelemetry.ts"],"mappings":";;KAMY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;;;;;;iBAOH,yBAAyB;KAwC7B;EACV;EACA;EACA;;;;;EAKA;EACA;EACA;;;;;;;iBAQc,2BACd,MAAM,2BACL;KAgBS;EACV;EACA;EACA;EACA;;KAGU,wBAAwB;EAClC;EACA;;;;;;;iBAQc,2BACd,OAAO,wBACN"}
+{"version":3,"file":"runTelemetry.d.ts","names":[],"sources":["../src/runTelemetry.ts"],"mappings":";;;KAOY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;;KAGP;;;;;iBAUI,iBACd;EACE;EACA;EACA;EACA;GAEF;EAEA;EACA,UAAU;;;;;;iBA+BI,iBAAiB;EAC/B;EACA;;;;;;iBA+Bc,yBAAyB;KAwC7B;EACV;EACA;EACA;;;;;EAKA;EACA;EACA;;;;;;;iBAQc,2BACd,MAAM,2BACL;;;;;;;;iBAuBa,2BACd,UAAU;KAmBA;EACV;EACA;EACA;EACA;;KAGU,wBAAwB;EAClC;EACA;EACA;IAAsB;;EACtB;IAAuB;;;KAGb;EACV,QAAQ;EACR,YAAY;EACZ;EACA;EACA;;KAGU;EACV;EACA,QAAQ;EACR,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR,QAAQ;EACR;EACA,YAAY;EACZ;EACA;EACA;EACA,WAAW;EACX;IACE;IACA;IACA;;;iBAuEY,gBAAgB,MAAM,gBAAgB;;;;;;;iBAiDtC,2BACd,OAAO,wBACN"}

package/dist/runTelemetry.js

@@ -2,6 +2,54 @@
 const MAX_TELEMETRY_TEXT_LENGTH = 5e4;
 const BASE64_PATTERN = /^[A-Za-z0-9+/]{100,}={0,2}$/;
 /**
+* Maps a finish event to the report status and outcome. `fallbackStatus`
+* applies when the event carries neither a finish reason nor a failure flag.
+*/
+function deriveRunOutcome(input, fallbackStatus = "completed") {
+	if (input.isError) return { status: "error" };
+	if (input.isAbort) return {
+		status: "incomplete",
+		outcome: "aborted"
+	};
+	if (input.isDisconnect) return {
+		status: "incomplete",
+		outcome: "disconnected"
+	};
+	switch (input.finishReason) {
+		case "length": return {
+			status: "incomplete",
+			outcome: "length"
+		};
+		case "content-filter":
+		case "content_filter": return {
+			status: "incomplete",
+			outcome: "content_filter"
+		};
+		case "cancelled": return {
+			status: "incomplete",
+			outcome: "aborted"
+		};
+		case "error": return { status: "error" };
+		default: return { status: input.finishReason === void 0 ? fallbackStatus : "completed" };
+	}
+}
+const MAX_RUN_ERROR_CODE_LENGTH = 64;
+const MAX_RUN_ERROR_LENGTH = 2048;
+/**
+* Reads the message and code the runs endpoint stores for a failed run. The
+* code is the error's `code` when it has one, else its class name.
+*/
+function describeRunError(error) {
+	if (error == null) return {};
+	const record = typeof error === "object" ? error : void 0;
+	const message = typeof error === "string" ? error : typeof record?.message === "string" ? record.message : void 0;
+	const code = typeof record?.code === "string" ? record.code : typeof record?.name === "string" && record.name !== "Error" ? record.name : void 0;
+	return {
+		...message ? { error: message.slice(0, MAX_RUN_ERROR_LENGTH) } : void 0,
+		...code ? { errorCode: code.slice(0, MAX_RUN_ERROR_CODE_LENGTH) } : void 0
+	};
+}
+/**
 * Clamps a string to the size the runs endpoint accepts for a single span
 * field.
 */
@@ -58,22 +106,120 @@ function createRunTelemetryToolCall(init) {
 	return call;
 }
 /**
-* Resolves the token counts a provider reports under either the current or the
-* legacy prompt/completion names. Returns undefined when no count is present,
+* Resolves the model ID a run reports, in the order an app can supply it: an
+* explicit `modelId`, the `custom` bag, then the per-step `response.modelId`
+* that a `messageMetadata` callback copies off the AI SDK's finish-step part.
+* The AI SDK puts no model ID on a UI message part, so message metadata is the
+* only channel one arrives on.
+*/
+function extractRunTelemetryModelId(metadata) {
+	if (!metadata) return void 0;
+	if (typeof metadata.modelId === "string") return metadata.modelId;
+	const custom = metadata.custom;
+	if (typeof custom?.modelId === "string") return custom.modelId;
+	const steps = metadata.steps;
+	if (!Array.isArray(steps)) return void 0;
+	for (const step of steps) {
+		if (!step || typeof step !== "object") continue;
+		const response = step.response;
+		if (!response || typeof response !== "object") continue;
+		const modelId = response.modelId;
+		if (typeof modelId === "string") return modelId;
+	}
+}
+function assignUsage(report, usage) {
+	if (!usage) return;
+	const normalized = normalizeRunTelemetryUsage(usage);
+	if (!normalized) return;
+	if (normalized.inputTokens !== void 0) report.input_tokens = normalized.inputTokens;
+	if (normalized.outputTokens !== void 0) report.output_tokens = normalized.outputTokens;
+	if (normalized.reasoningTokens !== void 0) report.reasoning_tokens = normalized.reasoningTokens;
+	if (normalized.cachedInputTokens !== void 0) report.cached_input_tokens = normalized.cachedInputTokens;
+}
+function createRunReportStep(init) {
+	const step = {};
+	const usage = init.usage ? normalizeRunTelemetryUsage(init.usage) : void 0;
+	if (usage?.inputTokens !== void 0) step.input_tokens = usage.inputTokens;
+	if (usage?.outputTokens !== void 0) step.output_tokens = usage.outputTokens;
+	if (usage?.reasoningTokens !== void 0) step.reasoning_tokens = usage.reasoningTokens;
+	if (usage?.cachedInputTokens !== void 0) step.cached_input_tokens = usage.cachedInputTokens;
+	if (init.toolCalls !== void 0) step.tool_calls = init.toolCalls;
+	if (init.startMs !== void 0) step.start_ms = init.startMs;
+	if (init.endMs !== void 0) step.end_ms = init.endMs;
+	if (init.finishReason !== void 0) step.finish_reason = init.finishReason.slice(0, 32);
+	return step;
+}
+function normalizeRunReportTags(tags) {
+	if (!tags) return void 0;
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const tag of tags) {
+		const normalized = tag.trim().slice(0, 64).trim();
+		if (!normalized || seen.has(normalized)) continue;
+		seen.add(normalized);
+		result.push(normalized);
+		if (result.length === 20) break;
+	}
+	return result.length > 0 ? result : void 0;
+}
+function normalizeRunReportMilliseconds(value) {
+	if (value === void 0 || !Number.isFinite(value)) return void 0;
+	return Math.max(0, Math.round(value));
+}
+function createRunReport(init) {
+	const report = {
+		thread_id: init.threadId,
+		status: init.status
+	};
+	const traceId = init.traceId?.toLowerCase();
+	if (traceId && /^[0-9a-f]{32}$/.test(traceId)) report.trace_id = traceId;
+	if (init.outcome !== void 0) report.outcome_type = init.outcome;
+	if (init.errorCode !== void 0) report.error_code = init.errorCode;
+	if (init.error !== void 0) report.error = init.error;
+	if (init.messageId !== void 0) report.message_id = init.messageId;
+	if (init.modelId !== void 0) report.model_id = init.modelId;
+	if (init.provider !== void 0) {
+		report.provider = init.provider;
+		report.provider_type = init.provider;
+	}
+	assignUsage(report, init.usage);
+	if (init.steps !== void 0) {
+		report.steps = init.steps.map(createRunReportStep);
+		report.total_steps = init.steps.length;
+	} else if (init.totalSteps !== void 0) report.total_steps = init.totalSteps;
+	if (init.toolCalls !== void 0) report.tool_calls = init.toolCalls;
+	const durationMs = normalizeRunReportMilliseconds(init.durationMs);
+	if (durationMs !== void 0) report.duration_ms = durationMs;
+	const firstTokenMs = normalizeRunReportMilliseconds(init.firstTokenMs);
+	if (firstTokenMs !== void 0) report.first_token_ms = firstTokenMs;
+	if (init.outputText !== void 0) report.output_text = truncateRunTelemetryText(init.outputText);
+	if (init.metadata !== void 0) report.metadata = init.metadata;
+	if (init.telemetry?.environment !== void 0) report.environment = init.telemetry.environment;
+	if (init.telemetry?.release !== void 0) report.release = init.telemetry.release;
+	const tags = normalizeRunReportTags(init.telemetry?.tags);
+	if (tags !== void 0) report.tags = tags;
+	return report;
+}
+/**
+* Resolves the token counts a provider reports under any of the names the AI
+* SDK has used: the current top-level ones, the legacy prompt/completion pair,
+* and the v7 token detail objects. Returns undefined when no count is present,
 * so callers can tell an empty usage object from a zeroed one.
 */
 function normalizeRunTelemetryUsage(usage) {
 	const inputTokens = usage.inputTokens ?? usage.promptTokens;
 	const outputTokens = usage.outputTokens ?? usage.completionTokens;
-	if (inputTokens == null && outputTokens == null && usage.reasoningTokens == null && usage.cachedInputTokens == null) return;
+	const reasoningTokens = usage.reasoningTokens ?? usage.outputTokenDetails?.reasoningTokens;
+	const cachedInputTokens = usage.cachedInputTokens ?? usage.inputTokenDetails?.cacheReadTokens;
+	if (inputTokens == null && outputTokens == null && reasoningTokens == null && cachedInputTokens == null) return;
 	return {
 		...inputTokens != null ? { inputTokens } : void 0,
 		...outputTokens != null ? { outputTokens } : void 0,
-		...usage.reasoningTokens != null ? { reasoningTokens: usage.reasoningTokens } : void 0,
-		...usage.cachedInputTokens != null ? { cachedInputTokens: usage.cachedInputTokens } : void 0
+		...reasoningTokens != null ? { reasoningTokens } : void 0,
+		...cachedInputTokens != null ? { cachedInputTokens } : void 0
 	};
 }
 //#endregion
-export { createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText };
+export { createRunReport, createRunTelemetryToolCall, deriveRunOutcome, describeRunError, extractRunTelemetryModelId, normalizeRunTelemetryUsage, truncateRunTelemetryText };
 
 //# sourceMappingURL=runTelemetry.js.map