assistant-cloud 0.1.41 → 0.1.42

package/README.md

@@ -9,16 +9,16 @@ Server- and client-side SDK for [Assistant Cloud](https://cloud.assistant-ui.com
 ## Installation
 
 ```bash
-npm install @assistant-ui/react @assistant-ui/react-ai-sdk assistant-cloud
+npm install @assistant-ui/react @assistant-ui/ai-sdk assistant-cloud
 ```
 
 ## Usage
 
-Pass an `AssistantCloud` instance to your runtime hook (typically `useChatRuntime` from `@assistant-ui/react-ai-sdk`):
+Pass an `AssistantCloud` instance to your runtime hook (typically `useChatRuntime` from `@assistant-ui/ai-sdk`):
 
 ```tsx
 import { AssistantCloud, AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 
 const cloud = new AssistantCloud({
   baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,

package/dist/AssistantCloud.js

@@ -21,8 +21,8 @@ var AssistantCloud = class {
 		this.files = new AssistantCloudFiles(api);
 		const t = config.telemetry;
 		this.telemetry = t === false ? { enabled: false } : t === true || t === void 0 ? { enabled: true } : {
-			enabled: t.enabled !== false,
-			...t
+			...t,
+			enabled: t.enabled !== false
 		};
 	}
 };

package/dist/AssistantCloud.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloud.js","names":[],"sources":["../src/AssistantCloud.ts"],"sourcesContent":["import {\n  AssistantCloudAPI,\n  type AssistantCloudConfig,\n  type AssistantCloudTelemetryConfig,\n} from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudProjects } from \"./AssistantCloudProjects\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\nimport { AssistantCloudFiles } from \"./AssistantCloudFiles\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly projects;\n  public readonly auth;\n  public readonly runs;\n  public readonly files;\n  public readonly telemetry: AssistantCloudTelemetryConfig;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.threads = new AssistantCloudThreads(api);\n    this.projects = new AssistantCloudProjects(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n    this.files = new AssistantCloudFiles(api);\n\n    const t = config.telemetry;\n    this.telemetry =\n      t === false\n        ? { enabled: false }\n        : t === true || t === undefined\n          ? { enabled: true }\n          : { enabled: t.enabled !== false, ...t };\n  }\n}\n"],"mappings":";;;;;;;AAWA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAA8B;EACxC,MAAM,MAAM,IAAI,kBAAkB,MAAM;EACxC,KAAK,UAAU,IAAI,sBAAsB,GAAG;EAC5C,KAAK,WAAW,IAAI,uBAAuB,GAAG;EAC9C,KAAK,OAAO,EACV,QAAQ,IAAI,yBAAyB,GAAG,EAC1C;EACA,KAAK,OAAO,IAAI,mBAAmB,GAAG;EACtC,KAAK,QAAQ,IAAI,oBAAoB,GAAG;EAExC,MAAM,IAAI,OAAO;EACjB,KAAK,YACH,MAAM,QACF,EAAE,SAAS,MAAM,IACjB,MAAM,QAAQ,MAAM,KAAA,IAClB,EAAE,SAAS,KAAK,IAChB;GAAE,SAAS,EAAE,YAAY;GAAO,GAAG;EAAE;CAC/C;AACF"}
+{"version":3,"file":"AssistantCloud.js","names":[],"sources":["../src/AssistantCloud.ts"],"sourcesContent":["import {\n  AssistantCloudAPI,\n  type AssistantCloudConfig,\n  type AssistantCloudTelemetryConfig,\n} from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudProjects } from \"./AssistantCloudProjects\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\nimport { AssistantCloudFiles } from \"./AssistantCloudFiles\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly projects;\n  public readonly auth;\n  public readonly runs;\n  public readonly files;\n  public readonly telemetry: AssistantCloudTelemetryConfig;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.threads = new AssistantCloudThreads(api);\n    this.projects = new AssistantCloudProjects(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n    this.files = new AssistantCloudFiles(api);\n\n    const t = config.telemetry;\n    this.telemetry =\n      t === false\n        ? { enabled: false }\n        : t === true || t === undefined\n          ? { enabled: true }\n          : { ...t, enabled: t.enabled !== false };\n  }\n}\n"],"mappings":";;;;;;;AAWA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAA8B;EACxC,MAAM,MAAM,IAAI,kBAAkB,MAAM;EACxC,KAAK,UAAU,IAAI,sBAAsB,GAAG;EAC5C,KAAK,WAAW,IAAI,uBAAuB,GAAG;EAC9C,KAAK,OAAO,EACV,QAAQ,IAAI,yBAAyB,GAAG,EAC1C;EACA,KAAK,OAAO,IAAI,mBAAmB,GAAG;EACtC,KAAK,QAAQ,IAAI,oBAAoB,GAAG;EAExC,MAAM,IAAI,OAAO;EACjB,KAAK,YACH,MAAM,QACF,EAAE,SAAS,MAAM,IACjB,MAAM,QAAQ,MAAM,KAAA,IAClB,EAAE,SAAS,KAAK,IAChB;GAAE,GAAG;GAAG,SAAS,EAAE,YAAY;EAAM;CAC/C;AACF"}

package/dist/AssistantCloudAPI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAPI.d.ts","names":[],"sources":["../src/AssistantCloudAPI.ts"],"mappings":";;;KAQY;EACV;;;;;;EAMA,gBACE,QAAQ,4BACL;;KAGK;EAEN;EACA,iBAAiB;;EAGjB;EACA;EACA;EACA;;EAGA;EACA;;;;;;;;;;;;;EAcJ,sBAAsB;;cAGX,sBAAsB;WACjB;EAEJ,YAAA,iBAAiB;;KAO1B;EACH;EACA,UAAU;EACV,QAAQ;EACR;;cAQW;EACJ,OAAO;EACP;EAEK,YAAA,QAAQ;EAuBP,kBAAc;EAId,eACX,kBACA,UAAS,qBAAuB,QAAA;EAmDrB,YAAY,kBAAkB,UAAS,qBAAuB"}
+{"version":3,"file":"AssistantCloudAPI.d.ts","names":[],"sources":["../src/AssistantCloudAPI.ts"],"mappings":";;;KAQY;EACV;;;;;;EAMA,gBACE,QAAQ,4BACL;;KAGK;EAEN;EACA,iBAAiB;;EAGjB;EACA;EACA;EACA;;EAGA;EACA;;;;;;;;;;;;;EAcJ,sBAAsB;;cAGX,sBAAsB;WACjB;EAEJ,YAAA,iBAAiB;;KAO1B;EACH;EACA,UAAU;EACV,QAAQ;EACR;;cAQW;EACJ,OAAO;EACP;EAEK,YAAA,QAAQ;EAuBP,kBAAc;EAId,eACX,kBACA,UAAS,qBAAuB,QAAA;EAoDrB,YAAY,kBAAkB,UAAS,qBAAuB"}

package/dist/AssistantCloudAPI.js

@@ -54,12 +54,12 @@ var AssistantCloudAPI = class {
 		this._auth.readAuthHeaders(response.headers);
 		if (!response.ok) {
 			const text = await response.text();
+			let message;
 			try {
-				throw new CloudAPIError(JSON.parse(text).message, response.status);
-			} catch (error) {
-				if (error instanceof CloudAPIError) throw error;
-				throw new CloudAPIError(`Request failed with status ${response.status}, ${text}`, response.status);
-			}
+				const body = JSON.parse(text);
+				if (typeof body?.message === "string" && body.message.length > 0) message = body.message;
+			} catch {}
+			throw new CloudAPIError(message ?? `Request failed with status ${response.status}, ${text}`, response.status);
 		}
 		return response;
 	}

package/dist/AssistantCloudAPI.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudAPI.js","names":[],"sources":["../src/AssistantCloudAPI.ts"],"sourcesContent":["import {\n  type AssistantCloudAuthStrategy,\n  AssistantCloudJWTAuthStrategy,\n  AssistantCloudAPIKeyAuthStrategy,\n  AssistantCloudAnonymousAuthStrategy,\n} from \"./AssistantCloudAuthStrategy\";\nimport type { AssistantCloudRunReport } from \"./AssistantCloudRuns\";\n\nexport type AssistantCloudTelemetryConfig = {\n  enabled?: boolean;\n  /**\n   * Called before each telemetry report is sent.\n   * Return a modified report to enrich it (e.g. add `model_id`),\n   * or return `null` to skip the report.\n   */\n  beforeReport?: (\n    report: AssistantCloudRunReport,\n  ) => AssistantCloudRunReport | null;\n};\n\nexport type AssistantCloudConfig = (\n  | {\n      baseUrl: string;\n      authToken: () => Promise<string | null>;\n    }\n  | {\n      baseUrl?: string;\n      apiKey: string;\n      userId: string;\n      workspaceId: string;\n    }\n  | {\n      baseUrl: string;\n      anonymous: true;\n    }\n) & {\n  /**\n   * Client-side run telemetry reporting. Default: `true`.\n   *\n   * When enabled, the SDK automatically reports run metadata (status, step\n   * count, tool calls, and token usage) to Assistant Cloud after each\n   * assistant message is saved. No message content is sent.\n   *\n   * - `true` / `undefined` — enabled with defaults\n   * - `false` — disabled\n   * - `{ beforeReport }` — enabled with a hook to enrich or filter reports\n   */\n  telemetry?: boolean | AssistantCloudTelemetryConfig;\n};\n\nexport class CloudAPIError extends Error {\n  public readonly status: number;\n\n  constructor(message: string, status: number) {\n    super(message);\n    this.status = status;\n    this.name = \"CloudAPIError\";\n  }\n}\n\ntype MakeRequestOptions = {\n  method?: \"POST\" | \"PUT\" | \"DELETE\" | undefined;\n  headers?: Record<string, string> | undefined;\n  query?: Record<string, string | number | boolean> | undefined;\n  body?: object | undefined;\n};\n\nconst normalizeBaseUrl = (baseUrl: string) => {\n  if (!baseUrl || !baseUrl.endsWith(\"/\")) return baseUrl;\n  return baseUrl.slice(0, -1);\n};\n\nexport class AssistantCloudAPI {\n  public _auth: AssistantCloudAuthStrategy;\n  public _baseUrl;\n\n  constructor(config: AssistantCloudConfig) {\n    if (\"authToken\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudJWTAuthStrategy(config.authToken);\n    } else if (\"apiKey\" in config) {\n      this._baseUrl = normalizeBaseUrl(\n        config.baseUrl ?? \"https://backend.assistant-api.com\",\n      );\n      this._auth = new AssistantCloudAPIKeyAuthStrategy(\n        config.apiKey,\n        config.userId,\n        config.workspaceId,\n      );\n    } else if (\"anonymous\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudAnonymousAuthStrategy(this._baseUrl);\n    } else {\n      throw new Error(\n        \"Invalid configuration: Must provide authToken, apiKey, or anonymous configuration\",\n      );\n    }\n  }\n\n  public async initializeAuth() {\n    return !!(await this._auth.getAuthHeaders());\n  }\n\n  public async makeRawRequest(\n    endpoint: string,\n    options: MakeRequestOptions = {},\n  ) {\n    const authHeaders = await this._auth.getAuthHeaders();\n    if (!authHeaders) throw new Error(\"Authorization failed\");\n\n    const headers = {\n      ...authHeaders,\n      ...options.headers,\n      \"Content-Type\": \"application/json\",\n    };\n\n    const queryParams = new URLSearchParams();\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value === false) continue;\n        if (value === true) {\n          queryParams.set(key, \"true\");\n        } else {\n          queryParams.set(key, value.toString());\n        }\n      }\n    }\n\n    const url = new URL(`${this._baseUrl}/v1${endpoint}`);\n    url.search = queryParams.toString();\n\n    const response = await fetch(url, {\n      method: options.method ?? \"GET\",\n      headers,\n      body: options.body ? JSON.stringify(options.body) : null,\n    });\n\n    this._auth.readAuthHeaders(response.headers);\n\n    if (!response.ok) {\n      const text = await response.text();\n      try {\n        const body = JSON.parse(text);\n        throw new CloudAPIError(body.message, response.status);\n      } catch (error) {\n        if (error instanceof CloudAPIError) throw error;\n        throw new CloudAPIError(\n          `Request failed with status ${response.status}, ${text}`,\n          response.status,\n        );\n      }\n    }\n\n    return response;\n  }\n\n  public async makeRequest(endpoint: string, options: MakeRequestOptions = {}) {\n    const response = await this.makeRawRequest(endpoint, options);\n    if (\n      response.status === 204 ||\n      response.headers.get(\"content-length\") === \"0\"\n    )\n      return undefined;\n\n    const text = await response.text();\n    if (text.trim() === \"\") return undefined;\n\n    return JSON.parse(text);\n  }\n}\n"],"mappings":";;AAkDA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CAEA,YAAY,SAAiB,QAAgB;EAC3C,MAAM,OAAO;EACb,KAAK,SAAS;EACd,KAAK,OAAO;CACd;AACF;AASA,MAAM,oBAAoB,YAAoB;CAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC/C,OAAO,QAAQ,MAAM,GAAG,EAAE;AAC5B;AAEA,IAAa,oBAAb,MAA+B;CAC7B;CACA;CAEA,YAAY,QAA8B;EACxC,IAAI,eAAe,QAAQ;GACzB,KAAK,WAAW,iBAAiB,OAAO,OAAO;GAC/C,KAAK,QAAQ,IAAI,8BAA8B,OAAO,SAAS;EACjE,OAAO,IAAI,YAAY,QAAQ;GAC7B,KAAK,WAAW,iBACd,OAAO,WAAW,mCACpB;GACA,KAAK,QAAQ,IAAI,iCACf,OAAO,QACP,OAAO,QACP,OAAO,WACT;EACF,OAAO,IAAI,eAAe,QAAQ;GAChC,KAAK,WAAW,iBAAiB,OAAO,OAAO;GAC/C,KAAK,QAAQ,IAAI,oCAAoC,KAAK,QAAQ;EACpE,OACE,MAAM,IAAI,MACR,mFACF;CAEJ;CAEA,MAAa,iBAAiB;EAC5B,OAAO,CAAC,CAAE,MAAM,KAAK,MAAM,eAAe;CAC5C;CAEA,MAAa,eACX,UACA,UAA8B,CAAC,GAC/B;EACA,MAAM,cAAc,MAAM,KAAK,MAAM,eAAe;EACpD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,sBAAsB;EAExD,MAAM,UAAU;GACd,GAAG;GACH,GAAG,QAAQ;GACX,gBAAgB;EAClB;EAEA,MAAM,cAAc,IAAI,gBAAgB;EACxC,IAAI,QAAQ,OACV,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,KAAK,GAAG;GACxD,IAAI,UAAU,OAAO;GACrB,IAAI,UAAU,MACZ,YAAY,IAAI,KAAK,MAAM;QAE3B,YAAY,IAAI,KAAK,MAAM,SAAS,CAAC;EAEzC;EAGF,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,SAAS,KAAK,UAAU;EACpD,IAAI,SAAS,YAAY,SAAS;EAElC,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ,QAAQ,UAAU;GAC1B;GACA,MAAM,QAAQ,OAAO,KAAK,UAAU,QAAQ,IAAI,IAAI;EACtD,CAAC;EAED,KAAK,MAAM,gBAAgB,SAAS,OAAO;EAE3C,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,KAAK;GACjC,IAAI;IAEF,MAAM,IAAI,cADG,KAAK,MAAM,IACA,CAAA,CAAK,SAAS,SAAS,MAAM;GACvD,SAAS,OAAO;IACd,IAAI,iBAAiB,eAAe,MAAM;IAC1C,MAAM,IAAI,cACR,8BAA8B,SAAS,OAAO,IAAI,QAClD,SAAS,MACX;GACF;EACF;EAEA,OAAO;CACT;CAEA,MAAa,YAAY,UAAkB,UAA8B,CAAC,GAAG;EAC3E,MAAM,WAAW,MAAM,KAAK,eAAe,UAAU,OAAO;EAC5D,IACE,SAAS,WAAW,OACpB,SAAS,QAAQ,IAAI,gBAAgB,MAAM,KAE3C,OAAO,KAAA;EAET,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,KAAA;EAE/B,OAAO,KAAK,MAAM,IAAI;CACxB;AACF"}
+{"version":3,"file":"AssistantCloudAPI.js","names":[],"sources":["../src/AssistantCloudAPI.ts"],"sourcesContent":["import {\n  type AssistantCloudAuthStrategy,\n  AssistantCloudJWTAuthStrategy,\n  AssistantCloudAPIKeyAuthStrategy,\n  AssistantCloudAnonymousAuthStrategy,\n} from \"./AssistantCloudAuthStrategy\";\nimport type { AssistantCloudRunReport } from \"./AssistantCloudRuns\";\n\nexport type AssistantCloudTelemetryConfig = {\n  enabled?: boolean;\n  /**\n   * Called before each telemetry report is sent.\n   * Return a modified report to enrich it (e.g. add `model_id`),\n   * or return `null` to skip the report.\n   */\n  beforeReport?: (\n    report: AssistantCloudRunReport,\n  ) => AssistantCloudRunReport | null;\n};\n\nexport type AssistantCloudConfig = (\n  | {\n      baseUrl: string;\n      authToken: () => Promise<string | null>;\n    }\n  | {\n      baseUrl?: string;\n      apiKey: string;\n      userId: string;\n      workspaceId: string;\n    }\n  | {\n      baseUrl: string;\n      anonymous: true;\n    }\n) & {\n  /**\n   * Client-side run telemetry reporting. Default: `true`.\n   *\n   * When enabled, the SDK automatically reports run metadata (status, step\n   * count, tool calls, and token usage) to Assistant Cloud after each\n   * assistant message is saved. No message content is sent.\n   *\n   * - `true` / `undefined` — enabled with defaults\n   * - `false` — disabled\n   * - `{ beforeReport }` — enabled with a hook to enrich or filter reports\n   */\n  telemetry?: boolean | AssistantCloudTelemetryConfig;\n};\n\nexport class CloudAPIError extends Error {\n  public readonly status: number;\n\n  constructor(message: string, status: number) {\n    super(message);\n    this.status = status;\n    this.name = \"CloudAPIError\";\n  }\n}\n\ntype MakeRequestOptions = {\n  method?: \"POST\" | \"PUT\" | \"DELETE\" | undefined;\n  headers?: Record<string, string> | undefined;\n  query?: Record<string, string | number | boolean> | undefined;\n  body?: object | undefined;\n};\n\nconst normalizeBaseUrl = (baseUrl: string) => {\n  if (!baseUrl || !baseUrl.endsWith(\"/\")) return baseUrl;\n  return baseUrl.slice(0, -1);\n};\n\nexport class AssistantCloudAPI {\n  public _auth: AssistantCloudAuthStrategy;\n  public _baseUrl;\n\n  constructor(config: AssistantCloudConfig) {\n    if (\"authToken\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudJWTAuthStrategy(config.authToken);\n    } else if (\"apiKey\" in config) {\n      this._baseUrl = normalizeBaseUrl(\n        config.baseUrl ?? \"https://backend.assistant-api.com\",\n      );\n      this._auth = new AssistantCloudAPIKeyAuthStrategy(\n        config.apiKey,\n        config.userId,\n        config.workspaceId,\n      );\n    } else if (\"anonymous\" in config) {\n      this._baseUrl = normalizeBaseUrl(config.baseUrl);\n      this._auth = new AssistantCloudAnonymousAuthStrategy(this._baseUrl);\n    } else {\n      throw new Error(\n        \"Invalid configuration: Must provide authToken, apiKey, or anonymous configuration\",\n      );\n    }\n  }\n\n  public async initializeAuth() {\n    return !!(await this._auth.getAuthHeaders());\n  }\n\n  public async makeRawRequest(\n    endpoint: string,\n    options: MakeRequestOptions = {},\n  ) {\n    const authHeaders = await this._auth.getAuthHeaders();\n    if (!authHeaders) throw new Error(\"Authorization failed\");\n\n    const headers = {\n      ...authHeaders,\n      ...options.headers,\n      \"Content-Type\": \"application/json\",\n    };\n\n    const queryParams = new URLSearchParams();\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value === false) continue;\n        if (value === true) {\n          queryParams.set(key, \"true\");\n        } else {\n          queryParams.set(key, value.toString());\n        }\n      }\n    }\n\n    const url = new URL(`${this._baseUrl}/v1${endpoint}`);\n    url.search = queryParams.toString();\n\n    const response = await fetch(url, {\n      method: options.method ?? \"GET\",\n      headers,\n      body: options.body ? JSON.stringify(options.body) : null,\n    });\n\n    this._auth.readAuthHeaders(response.headers);\n\n    if (!response.ok) {\n      const text = await response.text();\n      let message: string | undefined;\n      try {\n        const body = JSON.parse(text);\n        if (typeof body?.message === \"string\" && body.message.length > 0) {\n          message = body.message;\n        }\n      } catch {}\n      throw new CloudAPIError(\n        message ?? `Request failed with status ${response.status}, ${text}`,\n        response.status,\n      );\n    }\n\n    return response;\n  }\n\n  public async makeRequest(endpoint: string, options: MakeRequestOptions = {}) {\n    const response = await this.makeRawRequest(endpoint, options);\n    if (\n      response.status === 204 ||\n      response.headers.get(\"content-length\") === \"0\"\n    )\n      return undefined;\n\n    const text = await response.text();\n    if (text.trim() === \"\") return undefined;\n\n    return JSON.parse(text);\n  }\n}\n"],"mappings":";;AAkDA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CAEA,YAAY,SAAiB,QAAgB;EAC3C,MAAM,OAAO;EACb,KAAK,SAAS;EACd,KAAK,OAAO;CACd;AACF;AASA,MAAM,oBAAoB,YAAoB;CAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC/C,OAAO,QAAQ,MAAM,GAAG,EAAE;AAC5B;AAEA,IAAa,oBAAb,MAA+B;CAC7B;CACA;CAEA,YAAY,QAA8B;EACxC,IAAI,eAAe,QAAQ;GACzB,KAAK,WAAW,iBAAiB,OAAO,OAAO;GAC/C,KAAK,QAAQ,IAAI,8BAA8B,OAAO,SAAS;EACjE,OAAO,IAAI,YAAY,QAAQ;GAC7B,KAAK,WAAW,iBACd,OAAO,WAAW,mCACpB;GACA,KAAK,QAAQ,IAAI,iCACf,OAAO,QACP,OAAO,QACP,OAAO,WACT;EACF,OAAO,IAAI,eAAe,QAAQ;GAChC,KAAK,WAAW,iBAAiB,OAAO,OAAO;GAC/C,KAAK,QAAQ,IAAI,oCAAoC,KAAK,QAAQ;EACpE,OACE,MAAM,IAAI,MACR,mFACF;CAEJ;CAEA,MAAa,iBAAiB;EAC5B,OAAO,CAAC,CAAE,MAAM,KAAK,MAAM,eAAe;CAC5C;CAEA,MAAa,eACX,UACA,UAA8B,CAAC,GAC/B;EACA,MAAM,cAAc,MAAM,KAAK,MAAM,eAAe;EACpD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,sBAAsB;EAExD,MAAM,UAAU;GACd,GAAG;GACH,GAAG,QAAQ;GACX,gBAAgB;EAClB;EAEA,MAAM,cAAc,IAAI,gBAAgB;EACxC,IAAI,QAAQ,OACV,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,KAAK,GAAG;GACxD,IAAI,UAAU,OAAO;GACrB,IAAI,UAAU,MACZ,YAAY,IAAI,KAAK,MAAM;QAE3B,YAAY,IAAI,KAAK,MAAM,SAAS,CAAC;EAEzC;EAGF,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,SAAS,KAAK,UAAU;EACpD,IAAI,SAAS,YAAY,SAAS;EAElC,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ,QAAQ,UAAU;GAC1B;GACA,MAAM,QAAQ,OAAO,KAAK,UAAU,QAAQ,IAAI,IAAI;EACtD,CAAC;EAED,KAAK,MAAM,gBAAgB,SAAS,OAAO;EAE3C,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,KAAK;GACjC,IAAI;GACJ,IAAI;IACF,MAAM,OAAO,KAAK,MAAM,IAAI;IAC5B,IAAI,OAAO,MAAM,YAAY,YAAY,KAAK,QAAQ,SAAS,GAC7D,UAAU,KAAK;GAEnB,QAAQ,CAAC;GACT,MAAM,IAAI,cACR,WAAW,8BAA8B,SAAS,OAAO,IAAI,QAC7D,SAAS,MACX;EACF;EAEA,OAAO;CACT;CAEA,MAAa,YAAY,UAAkB,UAA8B,CAAC,GAAG;EAC3E,MAAM,WAAW,MAAM,KAAK,eAAe,UAAU,OAAO;EAC5D,IACE,SAAS,WAAW,OACpB,SAAS,QAAQ,IAAI,gBAAgB,MAAM,KAE3C,OAAO,KAAA;EAET,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,KAAA;EAE/B,OAAO,KAAK,MAAM,IAAI;CACxB;AACF"}

package/dist/AssistantCloudRuns.d.ts

@@ -1,4 +1,4 @@
-import { SamplingCallData } from "./instrumentMcpSampling.js";
+import { AssistantCloudRunReportToolCall } from "./runTelemetry.js";
 import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { AssistantStream } from "assistant-stream";
 //#region src/AssistantCloudRuns.d.ts
@@ -7,27 +7,17 @@ type AssistantCloudRunsStreamBody = {
   assistant_id: "system/thread_title";
   messages: readonly unknown[];
 };
-type ReportToolCall = {
-  tool_name: string;
-  tool_call_id: string;
-  tool_args?: string;
-  tool_result?: string;
-  tool_source?: "mcp" | "frontend" | "backend";
-  start_ms?: number;
-  end_ms?: number;
-  sampling_calls?: SamplingCallData[];
-};
 type AssistantCloudRunReport = {
   thread_id: string;
   status: "completed" | "incomplete" | "error";
   total_steps?: number;
-  tool_calls?: ReportToolCall[];
+  tool_calls?: AssistantCloudRunReportToolCall[];
   steps?: {
     input_tokens?: number;
     output_tokens?: number;
     reasoning_tokens?: number;
     cached_input_tokens?: number;
-    tool_calls?: ReportToolCall[];
+    tool_calls?: AssistantCloudRunReportToolCall[];
     start_ms?: number;
     end_ms?: number;
   }[];

package/dist/AssistantCloudRuns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudRuns.d.ts","names":[],"sources":["../src/AssistantCloudRuns.ts"],"mappings":";;;;KASK;EACH;EACA;EACA;;KAGG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;;KAMP;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,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"}

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 { SamplingCallData } from \"./instrumentMcpSampling\";\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\ntype ReportToolCall = {\n  tool_name: string;\n  tool_call_id: string;\n  tool_args?: string;\n  tool_result?: string;\n  tool_source?: \"mcp\" | \"frontend\" | \"backend\";\n  start_ms?: number;\n  end_ms?: number;\n  sampling_calls?: SamplingCallData[];\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?: ReportToolCall[];\n  steps?: {\n    input_tokens?: number;\n    output_tokens?: number;\n    reasoning_tokens?: number;\n    cached_input_tokens?: number;\n    tool_calls?: ReportToolCall[];\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":";;;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;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/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"}

package/dist/generateThreadTitle.d.ts

@@ -0,0 +1,15 @@
+import { AssistantCloud } from "./AssistantCloud.js";
+//#region src/generateThreadTitle.d.ts
+declare function generateThreadTitle(cloud: AssistantCloud, options: {
+  threadId: string;
+  messages: readonly {
+    role: string;
+    content: readonly {
+      type: "text";
+      text: string;
+    }[];
+  }[];
+}): Promise<string | null>;
+//#endregion
+export { generateThreadTitle };
+//# sourceMappingURL=generateThreadTitle.d.ts.map

package/dist/generateThreadTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateThreadTitle.d.ts","names":[],"sources":["../src/generateThreadTitle.ts"],"mappings":";;iBAEsB,oBACpB,OAAO,gBACP;EACE;EACA;IACE;IACA;MAAoB;MAAc;;;IAGrC"}

package/dist/generateThreadTitle.js

@@ -0,0 +1,25 @@
+//#region src/generateThreadTitle.ts
+async function generateThreadTitle(cloud, options) {
+	const stream = await cloud.runs.stream({
+		thread_id: options.threadId,
+		assistant_id: "system/thread_title",
+		messages: options.messages
+	});
+	let title = "";
+	const reader = stream.getReader();
+	try {
+		while (true) {
+			const { done, value: chunk } = await reader.read();
+			if (done) break;
+			if (chunk.type === "text-delta") title += chunk.textDelta;
+		}
+	} finally {
+		reader.releaseLock();
+	}
+	if (title) await cloud.threads.update(options.threadId, { title });
+	return title || null;
+}
+//#endregion
+export { generateThreadTitle };
+
+//# sourceMappingURL=generateThreadTitle.js.map

package/dist/generateThreadTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateThreadTitle.js","names":[],"sources":["../src/generateThreadTitle.ts"],"sourcesContent":["import type { AssistantCloud } from \"./AssistantCloud\";\n\nexport async function generateThreadTitle(\n  cloud: AssistantCloud,\n  options: {\n    threadId: string;\n    messages: readonly {\n      role: string;\n      content: readonly { type: \"text\"; text: string }[];\n    }[];\n  },\n): Promise<string | null> {\n  const stream = await cloud.runs.stream({\n    thread_id: options.threadId,\n    assistant_id: \"system/thread_title\",\n    messages: options.messages,\n  });\n\n  let title = \"\";\n  const reader = stream.getReader();\n  try {\n    while (true) {\n      const { done, value: chunk } = await reader.read();\n      if (done) break;\n      if (chunk.type === \"text-delta\") {\n        title += chunk.textDelta;\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  if (title) {\n    await cloud.threads.update(options.threadId, { title });\n  }\n\n  return title || null;\n}\n"],"mappings":";AAEA,eAAsB,oBACpB,OACA,SAOwB;CACxB,MAAM,SAAS,MAAM,MAAM,KAAK,OAAO;EACrC,WAAW,QAAQ;EACnB,cAAc;EACd,UAAU,QAAQ;CACpB,CAAC;CAED,IAAI,QAAQ;CACZ,MAAM,SAAS,OAAO,UAAU;CAChC,IAAI;EACF,OAAO,MAAM;GACX,MAAM,EAAE,MAAM,OAAO,UAAU,MAAM,OAAO,KAAK;GACjD,IAAI,MAAM;GACV,IAAI,MAAM,SAAS,cACjB,SAAS,MAAM;EAEnB;CACF,UAAU;EACR,OAAO,YAAY;CACrB;CAEA,IAAI,OACF,MAAM,MAAM,QAAQ,OAAO,QAAQ,UAAU,EAAE,MAAM,CAAC;CAGxD,OAAO,SAAS;AAClB"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { McpSamplingHandler, SamplingCallData, createSamplingCollector, wrapSamplingHandler } from "./instrumentMcpSampling.js";
+import { AssistantCloudRunReportToolCall, RunTelemetryToolCallInit, RunTelemetryUsage, RunTelemetryUsageInit, createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "./runTelemetry.js";
 import { AssistantCloudRunReport } from "./AssistantCloudRuns.js";
 import { AssistantCloudTelemetryConfig, CloudAPIError } from "./AssistantCloudAPI.js";
 import { CloudMessage } from "./AssistantCloudThreadMessages.js";
@@ -6,4 +7,5 @@ import { AssistantCloud } from "./AssistantCloud.js";
 import { CloudMessagePersistence } from "./CloudMessagePersistence.js";
 import { MessageFormatAdapter, createFormattedPersistence } from "./FormattedCloudPersistence.js";
 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 };
+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 };

package/dist/index.js

@@ -3,5 +3,7 @@ import { CloudAPIError } from "./AssistantCloudAPI.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 { createSamplingCollector, wrapSamplingHandler } from "./instrumentMcpSampling.js";
-export { AssistantCloud, CloudAPIError, CloudMessagePersistence, CloudResponseError, createFormattedPersistence, createSamplingCollector, wrapSamplingHandler };
+export { AssistantCloud, CloudAPIError, CloudMessagePersistence, CloudResponseError, createFormattedPersistence, createRunTelemetryToolCall, createSamplingCollector, generateThreadTitle, normalizeRunTelemetryUsage, truncateRunTelemetryText, wrapSamplingHandler };

package/dist/runTelemetry.d.ts

@@ -0,0 +1,54 @@
+import { SamplingCallData } from "./instrumentMcpSampling.js";
+//#region src/runTelemetry.d.ts
+type AssistantCloudRunReportToolCall = {
+  tool_name: string;
+  tool_call_id: string;
+  tool_args?: string;
+  tool_result?: string;
+  tool_source?: "mcp" | "frontend" | "backend";
+  start_ms?: number;
+  end_ms?: number;
+  sampling_calls?: SamplingCallData[];
+};
+/**
+ * Clamps a string to the size the runs endpoint accepts for a single span
+ * field.
+ */
+declare function truncateRunTelemetryText(value: string): string;
+type RunTelemetryToolCallInit = {
+  toolName: string;
+  toolCallId: string;
+  args?: unknown;
+  /**
+   * Pre-serialized arguments, used in place of serializing `args`. Values over
+   * the span size are clamped before they are included in the report.
+   */
+  argsText?: string | undefined;
+  result?: unknown;
+  toolSource?: "mcp" | "frontend" | "backend" | undefined;
+};
+/**
+ * Serializes one tool call into the shape the runs endpoint accepts. An `mcp`
+ * source has its result summarized, because MCP content blocks carry inline
+ * base64 image and audio payloads that would otherwise dominate the report.
+ */
+declare function createRunTelemetryToolCall(init: RunTelemetryToolCallInit): AssistantCloudRunReportToolCall;
+type RunTelemetryUsage = {
+  inputTokens?: number;
+  outputTokens?: number;
+  reasoningTokens?: number;
+  cachedInputTokens?: number;
+};
+type RunTelemetryUsageInit = RunTelemetryUsage & {
+  promptTokens?: number;
+  completionTokens?: number;
+};
+/**
+ * Resolves the token counts a provider reports under either the current or the
+ * legacy prompt/completion names. 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 };
+//# sourceMappingURL=runTelemetry.d.ts.map

package/dist/runTelemetry.d.ts.map

@@ -0,0 +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"}

package/dist/runTelemetry.js

@@ -0,0 +1,79 @@
+//#region src/runTelemetry.ts
+const MAX_TELEMETRY_TEXT_LENGTH = 5e4;
+const BASE64_PATTERN = /^[A-Za-z0-9+/]{100,}={0,2}$/;
+/**
+* Clamps a string to the size the runs endpoint accepts for a single span
+* field.
+*/
+function truncateRunTelemetryText(value) {
+	if (value.length <= MAX_TELEMETRY_TEXT_LENGTH) return value;
+	return value.slice(0, MAX_TELEMETRY_TEXT_LENGTH);
+}
+function safeStringify(value) {
+	if (value == null) return void 0;
+	try {
+		return truncateRunTelemetryText(JSON.stringify(value));
+	} catch {
+		return;
+	}
+}
+function summarizeMcpResult(value) {
+	if (value == null) return void 0;
+	try {
+		const parsed = typeof value === "string" ? JSON.parse(value) : value;
+		if (Array.isArray(parsed)) {
+			const summarized = parsed.map((item) => {
+				if (item && typeof item === "object" && item.type) {
+					if ((item.type === "image" || item.type === "audio") && typeof item.data === "string" && BASE64_PATTERN.test(item.data.slice(0, 200))) {
+						const sizeKB = (item.data.length * 3 / 4 / 1024).toFixed(1);
+						return {
+							...item,
+							data: `[${item.type}: ${sizeKB}KB]`
+						};
+					}
+				}
+				return item;
+			});
+			return truncateRunTelemetryText(JSON.stringify(summarized));
+		}
+	} catch {}
+	return safeStringify(value);
+}
+/**
+* Serializes one tool call into the shape the runs endpoint accepts. An `mcp`
+* source has its result summarized, because MCP content blocks carry inline
+* base64 image and audio payloads that would otherwise dominate the report.
+*/
+function createRunTelemetryToolCall(init) {
+	const { toolName, toolCallId, args, argsText, result, toolSource } = init;
+	const call = {
+		tool_name: toolName,
+		tool_call_id: toolCallId
+	};
+	const toolArgs = argsText != null ? truncateRunTelemetryText(argsText) : safeStringify(args);
+	if (toolArgs !== void 0) call.tool_args = toolArgs;
+	const toolResult = toolSource === "mcp" ? summarizeMcpResult(result) : safeStringify(result);
+	if (toolResult !== void 0) call.tool_result = toolResult;
+	if (toolSource) call.tool_source = toolSource;
+	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,
+* 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;
+	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
+	};
+}
+//#endregion
+export { createRunTelemetryToolCall, normalizeRunTelemetryUsage, truncateRunTelemetryText };
+
+//# sourceMappingURL=runTelemetry.js.map

package/dist/runTelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTelemetry.js","names":[],"sources":["../src/runTelemetry.ts"],"sourcesContent":["import type { SamplingCallData } from \"./instrumentMcpSampling\";\n\nconst MAX_TELEMETRY_TEXT_LENGTH = 50_000;\n\nconst BASE64_PATTERN = /^[A-Za-z0-9+/]{100,}={0,2}$/;\n\nexport type AssistantCloudRunReportToolCall = {\n  tool_name: string;\n  tool_call_id: string;\n  tool_args?: string;\n  tool_result?: string;\n  tool_source?: \"mcp\" | \"frontend\" | \"backend\";\n  start_ms?: number;\n  end_ms?: number;\n  sampling_calls?: SamplingCallData[];\n};\n\n/**\n * Clamps a string to the size the runs endpoint accepts for a single span\n * field.\n */\nexport function truncateRunTelemetryText(value: string): string {\n  if (value.length <= MAX_TELEMETRY_TEXT_LENGTH) return value;\n  return value.slice(0, MAX_TELEMETRY_TEXT_LENGTH);\n}\n\nfunction safeStringify(value: unknown): string | undefined {\n  if (value == null) return undefined;\n  try {\n    return truncateRunTelemetryText(JSON.stringify(value));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction summarizeMcpResult(value: unknown): string | undefined {\n  if (value == null) return undefined;\n  try {\n    const parsed = typeof value === \"string\" ? JSON.parse(value) : value;\n    if (Array.isArray(parsed)) {\n      const summarized = parsed.map((item) => {\n        if (item && typeof item === \"object\" && item.type) {\n          if (\n            (item.type === \"image\" || item.type === \"audio\") &&\n            typeof item.data === \"string\" &&\n            BASE64_PATTERN.test(item.data.slice(0, 200))\n          ) {\n            const sizeKB = ((item.data.length * 3) / 4 / 1024).toFixed(1);\n            return { ...item, data: `[${item.type}: ${sizeKB}KB]` };\n          }\n        }\n        return item;\n      });\n      return truncateRunTelemetryText(JSON.stringify(summarized));\n    }\n  } catch {\n    // not JSON array, fall through\n  }\n  return safeStringify(value);\n}\n\nexport type RunTelemetryToolCallInit = {\n  toolName: string;\n  toolCallId: string;\n  args?: unknown;\n  /**\n   * Pre-serialized arguments, used in place of serializing `args`. Values over\n   * the span size are clamped before they are included in the report.\n   */\n  argsText?: string | undefined;\n  result?: unknown;\n  toolSource?: \"mcp\" | \"frontend\" | \"backend\" | undefined;\n};\n\n/**\n * Serializes one tool call into the shape the runs endpoint accepts. An `mcp`\n * source has its result summarized, because MCP content blocks carry inline\n * base64 image and audio payloads that would otherwise dominate the report.\n */\nexport function createRunTelemetryToolCall(\n  init: RunTelemetryToolCallInit,\n): AssistantCloudRunReportToolCall {\n  const { toolName, toolCallId, args, argsText, result, toolSource } = init;\n  const call: AssistantCloudRunReportToolCall = {\n    tool_name: toolName,\n    tool_call_id: toolCallId,\n  };\n  const toolArgs =\n    argsText != null ? truncateRunTelemetryText(argsText) : safeStringify(args);\n  if (toolArgs !== undefined) call.tool_args = toolArgs;\n  const toolResult =\n    toolSource === \"mcp\" ? summarizeMcpResult(result) : safeStringify(result);\n  if (toolResult !== undefined) call.tool_result = toolResult;\n  if (toolSource) call.tool_source = toolSource;\n  return call;\n}\n\nexport type RunTelemetryUsage = {\n  inputTokens?: number;\n  outputTokens?: number;\n  reasoningTokens?: number;\n  cachedInputTokens?: number;\n};\n\nexport type RunTelemetryUsageInit = RunTelemetryUsage & {\n  promptTokens?: number;\n  completionTokens?: number;\n};\n\n/**\n * Resolves the token counts a provider reports under either the current or the\n * legacy prompt/completion names. Returns undefined when no count is present,\n * so callers can tell an empty usage object from a zeroed one.\n */\nexport function normalizeRunTelemetryUsage(\n  usage: RunTelemetryUsageInit,\n): RunTelemetryUsage | undefined {\n  const inputTokens = usage.inputTokens ?? usage.promptTokens;\n  const outputTokens = usage.outputTokens ?? usage.completionTokens;\n\n  if (\n    inputTokens == null &&\n    outputTokens == null &&\n    usage.reasoningTokens == null &&\n    usage.cachedInputTokens == null\n  ) {\n    return undefined;\n  }\n\n  return {\n    ...(inputTokens != null ? { inputTokens } : undefined),\n    ...(outputTokens != null ? { outputTokens } : undefined),\n    ...(usage.reasoningTokens != null\n      ? { reasoningTokens: usage.reasoningTokens }\n      : undefined),\n    ...(usage.cachedInputTokens != null\n      ? { cachedInputTokens: usage.cachedInputTokens }\n      : undefined),\n  };\n}\n"],"mappings":";AAEA,MAAM,4BAA4B;AAElC,MAAM,iBAAiB;;;;;AAiBvB,SAAgB,yBAAyB,OAAuB;CAC9D,IAAI,MAAM,UAAU,2BAA2B,OAAO;CACtD,OAAO,MAAM,MAAM,GAAG,yBAAyB;AACjD;AAEA,SAAS,cAAc,OAAoC;CACzD,IAAI,SAAS,MAAM,OAAO,KAAA;CAC1B,IAAI;EACF,OAAO,yBAAyB,KAAK,UAAU,KAAK,CAAC;CACvD,QAAQ;EACN;CACF;AACF;AAEA,SAAS,mBAAmB,OAAoC;CAC9D,IAAI,SAAS,MAAM,OAAO,KAAA;CAC1B,IAAI;EACF,MAAM,SAAS,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;EAC/D,IAAI,MAAM,QAAQ,MAAM,GAAG;GACzB,MAAM,aAAa,OAAO,KAAK,SAAS;IACtC,IAAI,QAAQ,OAAO,SAAS,YAAY,KAAK,MAExC;UAAA,KAAK,SAAS,WAAW,KAAK,SAAS,YACxC,OAAO,KAAK,SAAS,YACrB,eAAe,KAAK,KAAK,KAAK,MAAM,GAAG,GAAG,CAAC,GAC3C;MACA,MAAM,UAAW,KAAK,KAAK,SAAS,IAAK,IAAI,KAAA,CAAM,QAAQ,CAAC;MAC5D,OAAO;OAAE,GAAG;OAAM,MAAM,IAAI,KAAK,KAAK,IAAI,OAAO;MAAK;KACxD;;IAEF,OAAO;GACT,CAAC;GACD,OAAO,yBAAyB,KAAK,UAAU,UAAU,CAAC;EAC5D;CACF,QAAQ,CAER;CACA,OAAO,cAAc,KAAK;AAC5B;;;;;;AAoBA,SAAgB,2BACd,MACiC;CACjC,MAAM,EAAE,UAAU,YAAY,MAAM,UAAU,QAAQ,eAAe;CACrE,MAAM,OAAwC;EAC5C,WAAW;EACX,cAAc;CAChB;CACA,MAAM,WACJ,YAAY,OAAO,yBAAyB,QAAQ,IAAI,cAAc,IAAI;CAC5E,IAAI,aAAa,KAAA,GAAW,KAAK,YAAY;CAC7C,MAAM,aACJ,eAAe,QAAQ,mBAAmB,MAAM,IAAI,cAAc,MAAM;CAC1E,IAAI,eAAe,KAAA,GAAW,KAAK,cAAc;CACjD,IAAI,YAAY,KAAK,cAAc;CACnC,OAAO;AACT;;;;;;AAmBA,SAAgB,2BACd,OAC+B;CAC/B,MAAM,cAAc,MAAM,eAAe,MAAM;CAC/C,MAAM,eAAe,MAAM,gBAAgB,MAAM;CAEjD,IACE,eAAe,QACf,gBAAgB,QAChB,MAAM,mBAAmB,QACzB,MAAM,qBAAqB,MAE3B;CAGF,OAAO;EACL,GAAI,eAAe,OAAO,EAAE,YAAY,IAAI,KAAA;EAC5C,GAAI,gBAAgB,OAAO,EAAE,aAAa,IAAI,KAAA;EAC9C,GAAI,MAAM,mBAAmB,OACzB,EAAE,iBAAiB,MAAM,gBAAgB,IACzC,KAAA;EACJ,GAAI,MAAM,qBAAqB,OAC3B,EAAE,mBAAmB,MAAM,kBAAkB,IAC7C,KAAA;CACN;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-cloud",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "Cloud integration for assistant-ui",
   "keywords": [
     "assistant",
@@ -27,12 +27,12 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.38"
+    "assistant-stream": "^0.3.40"
   },
   "devDependencies": {
+    "@assistant-ui/x-buildutils": "0.0.24",
     "@types/node": "^26.2.0",
-    "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.23"
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public",

package/src/AssistantCloud.ts

@@ -33,6 +33,6 @@ export class AssistantCloud {
         ? { enabled: false }
         : t === true || t === undefined
           ? { enabled: true }
-          : { enabled: t.enabled !== false, ...t };
+          : { ...t, enabled: t.enabled !== false };
   }
 }

package/src/AssistantCloudAPI.ts

@@ -139,16 +139,17 @@ export class AssistantCloudAPI {
 
     if (!response.ok) {
       const text = await response.text();
+      let message: string | undefined;
       try {
         const body = JSON.parse(text);
-        throw new CloudAPIError(body.message, response.status);
-      } catch (error) {
-        if (error instanceof CloudAPIError) throw error;
-        throw new CloudAPIError(
-          `Request failed with status ${response.status}, ${text}`,
-          response.status,
-        );
-      }
+        if (typeof body?.message === "string" && body.message.length > 0) {
+          message = body.message;
+        }
+      } catch {}
+      throw new CloudAPIError(
+        message ?? `Request failed with status ${response.status}, ${text}`,
+        response.status,
+      );
     }
 
     return response;

package/src/AssistantCloudRuns.ts

@@ -1,5 +1,5 @@
 import type { AssistantCloudAPI } from "./AssistantCloudAPI";
-import type { SamplingCallData } from "./instrumentMcpSampling";
+import type { AssistantCloudRunReportToolCall } from "./runTelemetry";
 import { AssistantStream, PlainTextDecoder } from "assistant-stream";
 import {
   CloudResponseError,
@@ -13,17 +13,6 @@ type AssistantCloudRunsStreamBody = {
   messages: readonly unknown[]; // TODO type
 };
 
-type ReportToolCall = {
-  tool_name: string;
-  tool_call_id: string;
-  tool_args?: string;
-  tool_result?: string;
-  tool_source?: "mcp" | "frontend" | "backend";
-  start_ms?: number;
-  end_ms?: number;
-  sampling_calls?: SamplingCallData[];
-};
-
 // NOTE: Keep this payload shape aligned with the strict runtime validator in
 // assistant-cloud: apps/aui-cloud-api/src/endpoints/runs/create.ts
 // (createRunSchema). New telemetry fields must be added in both repos together.
@@ -31,13 +20,13 @@ export type AssistantCloudRunReport = {
   thread_id: string;
   status: "completed" | "incomplete" | "error";
   total_steps?: number;
-  tool_calls?: ReportToolCall[];
+  tool_calls?: AssistantCloudRunReportToolCall[];
   steps?: {
     input_tokens?: number;
     output_tokens?: number;
     reasoning_tokens?: number;
     cached_input_tokens?: number;
-    tool_calls?: ReportToolCall[];
+    tool_calls?: AssistantCloudRunReportToolCall[];
     start_ms?: number;
     end_ms?: number;
   }[];

package/src/generateThreadTitle.test.ts

@@ -0,0 +1,71 @@
+import { describe, expect, it, vi } from "vitest";
+import type { AssistantCloud } from "./AssistantCloud";
+import { generateThreadTitle } from "./generateThreadTitle";
+
+const titleStream = (...chunks: { type: string; textDelta?: string }[]) =>
+  new ReadableStream({
+    start(controller) {
+      for (const chunk of chunks) controller.enqueue(chunk);
+      controller.close();
+    },
+  });
+
+const createCloud = (stream: ReadableStream<unknown>) => {
+  const update = vi.fn().mockResolvedValue(undefined);
+  const run = vi.fn().mockResolvedValue(stream);
+  const cloud = {
+    threads: { update },
+    runs: { stream: run },
+  } as unknown as AssistantCloud;
+  return { cloud, update, run };
+};
+
+describe("generateThreadTitle", () => {
+  it("accumulates text deltas and updates the thread title", async () => {
+    const { cloud, run, update } = createCloud(
+      titleStream(
+        { type: "text-delta", textDelta: "Weather " },
+        { type: "text-delta", textDelta: "chat" },
+      ),
+    );
+
+    await expect(
+      generateThreadTitle(cloud, {
+        threadId: "thread-1",
+        messages: [
+          {
+            role: "user",
+            content: [{ type: "text", text: "What is the weather today?" }],
+          },
+        ],
+      }),
+    ).resolves.toBe("Weather chat");
+
+    expect(run).toHaveBeenCalledExactlyOnceWith({
+      thread_id: "thread-1",
+      assistant_id: "system/thread_title",
+      messages: [
+        {
+          role: "user",
+          content: [{ type: "text", text: "What is the weather today?" }],
+        },
+      ],
+    });
+    expect(update).toHaveBeenCalledExactlyOnceWith("thread-1", {
+      title: "Weather chat",
+    });
+  });
+
+  it("returns null without updating when the stream has no text", async () => {
+    const { cloud, update } = createCloud(titleStream());
+
+    await expect(
+      generateThreadTitle(cloud, {
+        threadId: "thread-1",
+        messages: [],
+      }),
+    ).resolves.toBeNull();
+
+    expect(update).not.toHaveBeenCalled();
+  });
+});

package/src/generateThreadTitle.ts

@@ -0,0 +1,38 @@
+import type { AssistantCloud } from "./AssistantCloud";
+
+export async function generateThreadTitle(
+  cloud: AssistantCloud,
+  options: {
+    threadId: string;
+    messages: readonly {
+      role: string;
+      content: readonly { type: "text"; text: string }[];
+    }[];
+  },
+): Promise<string | null> {
+  const stream = await cloud.runs.stream({
+    thread_id: options.threadId,
+    assistant_id: "system/thread_title",
+    messages: options.messages,
+  });
+
+  let title = "";
+  const reader = stream.getReader();
+  try {
+    while (true) {
+      const { done, value: chunk } = await reader.read();
+      if (done) break;
+      if (chunk.type === "text-delta") {
+        title += chunk.textDelta;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+
+  if (title) {
+    await cloud.threads.update(options.threadId, { title });
+  }
+
+  return title || null;
+}

package/src/index.ts

@@ -2,7 +2,17 @@ export type { CloudMessage } from "./AssistantCloudThreadMessages";
 export type { AssistantCloudTelemetryConfig } from "./AssistantCloudAPI";
 export { CloudAPIError } from "./AssistantCloudAPI";
 export { CloudResponseError } from "./cloudResponse";
+export { generateThreadTitle } from "./generateThreadTitle";
 export type { AssistantCloudRunReport } from "./AssistantCloudRuns";
+export {
+  createRunTelemetryToolCall,
+  normalizeRunTelemetryUsage,
+  truncateRunTelemetryText,
+  type AssistantCloudRunReportToolCall,
+  type RunTelemetryToolCallInit,
+  type RunTelemetryUsage,
+  type RunTelemetryUsageInit,
+} from "./runTelemetry";
 export { AssistantCloud } from "./AssistantCloud";
 export { CloudMessagePersistence } from "./CloudMessagePersistence";
 export {

package/src/runTelemetry.test.ts

@@ -0,0 +1,130 @@
+import { describe, expect, it } from "vitest";
+import {
+  createRunTelemetryToolCall,
+  normalizeRunTelemetryUsage,
+  truncateRunTelemetryText,
+} from "./runTelemetry";
+
+const MAX = 50_000;
+
+describe("truncateRunTelemetryText", () => {
+  it("passes text at or under the cap through unchanged", () => {
+    expect(truncateRunTelemetryText("hello")).toBe("hello");
+    const exact = "a".repeat(MAX);
+    expect(truncateRunTelemetryText(exact)).toBe(exact);
+  });
+
+  it("clamps text over the cap", () => {
+    expect(truncateRunTelemetryText("a".repeat(MAX + 1))).toHaveLength(MAX);
+  });
+});
+
+describe("createRunTelemetryToolCall", () => {
+  it("serializes args and omits tool_source when the caller gives none", () => {
+    expect(
+      createRunTelemetryToolCall({
+        toolName: "calculator",
+        toolCallId: "call-1",
+        args: { a: 1 },
+        result: { sum: 1 },
+      }),
+    ).toEqual({
+      tool_name: "calculator",
+      tool_call_id: "call-1",
+      tool_args: '{"a":1}',
+      tool_result: '{"sum":1}',
+    });
+  });
+
+  it("clamps serialized args and results", () => {
+    const call = createRunTelemetryToolCall({
+      toolName: "t",
+      toolCallId: "call-1",
+      args: { blob: "a".repeat(MAX) },
+      result: { blob: "a".repeat(MAX) },
+    });
+    expect(call.tool_args).toHaveLength(MAX);
+    expect(call.tool_result).toHaveLength(MAX);
+  });
+
+  it("clamps pre-serialized argsText to the cap", () => {
+    const argsText = "a".repeat(MAX + 10);
+    const call = createRunTelemetryToolCall({
+      toolName: "t",
+      toolCallId: "call-1",
+      argsText,
+      args: { ignored: true },
+    });
+    expect(call.tool_args).toBe(argsText.slice(0, MAX));
+  });
+
+  it("omits fields whose value cannot be serialized", () => {
+    const circular: Record<string, unknown> = {};
+    circular.self = circular;
+    expect(
+      createRunTelemetryToolCall({
+        toolName: "t",
+        toolCallId: "call-1",
+        args: circular,
+        result: undefined,
+      }),
+    ).toEqual({ tool_name: "t", tool_call_id: "call-1" });
+  });
+
+  it("summarizes base64 image and audio blocks in an mcp result", () => {
+    const call = createRunTelemetryToolCall({
+      toolName: "t",
+      toolCallId: "call-1",
+      toolSource: "mcp",
+      result: [
+        { type: "text", text: "keep me" },
+        { type: "image", data: "A".repeat(4096) },
+      ],
+    });
+    expect(call.tool_source).toBe("mcp");
+    expect(call.tool_result).toContain("keep me");
+    expect(call.tool_result).toContain("[image: 3.0KB]");
+    expect(call.tool_result).not.toContain("A".repeat(200));
+  });
+
+  it("leaves a non-mcp result unsummarized", () => {
+    const result = [{ type: "image", data: "A".repeat(4096) }];
+    const call = createRunTelemetryToolCall({
+      toolName: "t",
+      toolCallId: "call-1",
+      toolSource: "frontend",
+      result,
+    });
+    expect(call.tool_source).toBe("frontend");
+    expect(call.tool_result).toBe(JSON.stringify(result));
+  });
+});
+
+describe("normalizeRunTelemetryUsage", () => {
+  it("prefers the current names over the legacy ones", () => {
+    expect(
+      normalizeRunTelemetryUsage({
+        inputTokens: 1,
+        outputTokens: 2,
+        promptTokens: 90,
+        completionTokens: 90,
+      }),
+    ).toEqual({ inputTokens: 1, outputTokens: 2 });
+  });
+
+  it("falls back to the legacy prompt and completion names", () => {
+    expect(
+      normalizeRunTelemetryUsage({ promptTokens: 3, completionTokens: 4 }),
+    ).toEqual({ inputTokens: 3, outputTokens: 4 });
+  });
+
+  it("keeps a zero count and omits an absent one", () => {
+    expect(
+      normalizeRunTelemetryUsage({ inputTokens: 0, cachedInputTokens: 5 }),
+    ).toEqual({ inputTokens: 0, cachedInputTokens: 5 });
+  });
+
+  it("returns undefined when no count is present", () => {
+    expect(normalizeRunTelemetryUsage({})).toBeUndefined();
+  });
+});

package/src/runTelemetry.ts

@@ -0,0 +1,140 @@
+import type { SamplingCallData } from "./instrumentMcpSampling";
+
+const MAX_TELEMETRY_TEXT_LENGTH = 50_000;
+
+const BASE64_PATTERN = /^[A-Za-z0-9+/]{100,}={0,2}$/;
+
+export type AssistantCloudRunReportToolCall = {
+  tool_name: string;
+  tool_call_id: string;
+  tool_args?: string;
+  tool_result?: string;
+  tool_source?: "mcp" | "frontend" | "backend";
+  start_ms?: number;
+  end_ms?: number;
+  sampling_calls?: SamplingCallData[];
+};
+
+/**
+ * Clamps a string to the size the runs endpoint accepts for a single span
+ * field.
+ */
+export function truncateRunTelemetryText(value: string): string {
+  if (value.length <= MAX_TELEMETRY_TEXT_LENGTH) return value;
+  return value.slice(0, MAX_TELEMETRY_TEXT_LENGTH);
+}
+
+function safeStringify(value: unknown): string | undefined {
+  if (value == null) return undefined;
+  try {
+    return truncateRunTelemetryText(JSON.stringify(value));
+  } catch {
+    return undefined;
+  }
+}
+
+function summarizeMcpResult(value: unknown): string | undefined {
+  if (value == null) return undefined;
+  try {
+    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    if (Array.isArray(parsed)) {
+      const summarized = parsed.map((item) => {
+        if (item && typeof item === "object" && item.type) {
+          if (
+            (item.type === "image" || item.type === "audio") &&
+            typeof item.data === "string" &&
+            BASE64_PATTERN.test(item.data.slice(0, 200))
+          ) {
+            const sizeKB = ((item.data.length * 3) / 4 / 1024).toFixed(1);
+            return { ...item, data: `[${item.type}: ${sizeKB}KB]` };
+          }
+        }
+        return item;
+      });
+      return truncateRunTelemetryText(JSON.stringify(summarized));
+    }
+  } catch {
+    // not JSON array, fall through
+  }
+  return safeStringify(value);
+}
+
+export type RunTelemetryToolCallInit = {
+  toolName: string;
+  toolCallId: string;
+  args?: unknown;
+  /**
+   * Pre-serialized arguments, used in place of serializing `args`. Values over
+   * the span size are clamped before they are included in the report.
+   */
+  argsText?: string | undefined;
+  result?: unknown;
+  toolSource?: "mcp" | "frontend" | "backend" | undefined;
+};
+
+/**
+ * Serializes one tool call into the shape the runs endpoint accepts. An `mcp`
+ * source has its result summarized, because MCP content blocks carry inline
+ * base64 image and audio payloads that would otherwise dominate the report.
+ */
+export function createRunTelemetryToolCall(
+  init: RunTelemetryToolCallInit,
+): AssistantCloudRunReportToolCall {
+  const { toolName, toolCallId, args, argsText, result, toolSource } = init;
+  const call: AssistantCloudRunReportToolCall = {
+    tool_name: toolName,
+    tool_call_id: toolCallId,
+  };
+  const toolArgs =
+    argsText != null ? truncateRunTelemetryText(argsText) : safeStringify(args);
+  if (toolArgs !== undefined) call.tool_args = toolArgs;
+  const toolResult =
+    toolSource === "mcp" ? summarizeMcpResult(result) : safeStringify(result);
+  if (toolResult !== undefined) call.tool_result = toolResult;
+  if (toolSource) call.tool_source = toolSource;
+  return call;
+}
+
+export type RunTelemetryUsage = {
+  inputTokens?: number;
+  outputTokens?: number;
+  reasoningTokens?: number;
+  cachedInputTokens?: number;
+};
+
+export type RunTelemetryUsageInit = RunTelemetryUsage & {
+  promptTokens?: number;
+  completionTokens?: number;
+};
+
+/**
+ * Resolves the token counts a provider reports under either the current or the
+ * legacy prompt/completion names. Returns undefined when no count is present,
+ * so callers can tell an empty usage object from a zeroed one.
+ */
+export function normalizeRunTelemetryUsage(
+  usage: RunTelemetryUsageInit,
+): RunTelemetryUsage | undefined {
+  const inputTokens = usage.inputTokens ?? usage.promptTokens;
+  const outputTokens = usage.outputTokens ?? usage.completionTokens;
+
+  if (
+    inputTokens == null &&
+    outputTokens == null &&
+    usage.reasoningTokens == null &&
+    usage.cachedInputTokens == null
+  ) {
+    return undefined;
+  }
+
+  return {
+    ...(inputTokens != null ? { inputTokens } : undefined),
+    ...(outputTokens != null ? { outputTokens } : undefined),
+    ...(usage.reasoningTokens != null
+      ? { reasoningTokens: usage.reasoningTokens }
+      : undefined),
+    ...(usage.cachedInputTokens != null
+      ? { cachedInputTokens: usage.cachedInputTokens }
+      : undefined),
+  };
+}

package/src/tests/AssistantCloud.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, it } from "vitest";
+import { AssistantCloud } from "../AssistantCloud";
+import type { AssistantCloudTelemetryConfig } from "../AssistantCloudAPI";
+
+const createCloud = (
+  telemetry?: ConstructorParameters<typeof AssistantCloud>[0]["telemetry"],
+) =>
+  new AssistantCloud({
+    apiKey: "test-key",
+    userId: "user-id",
+    workspaceId: "workspace-id",
+    ...(telemetry !== undefined ? { telemetry } : {}),
+  });
+
+describe("AssistantCloud telemetry config", () => {
+  it("defaults to enabled", () => {
+    expect(createCloud().telemetry.enabled).toBe(true);
+    expect(createCloud(true).telemetry.enabled).toBe(true);
+  });
+
+  it("disables when configured off", () => {
+    expect(createCloud(false).telemetry.enabled).toBe(false);
+    expect(createCloud({ enabled: false }).telemetry.enabled).toBe(false);
+  });
+
+  it("stays enabled when the config object carries an undefined enabled", () => {
+    const beforeReport: NonNullable<
+      AssistantCloudTelemetryConfig["beforeReport"]
+    > = (report) => report;
+    // JS consumers (and TS apps without exactOptionalPropertyTypes) can pass
+    // an explicitly-undefined enabled, e.g. { enabled: cfg.enabled }.
+    const telemetry = createCloud({
+      enabled: undefined,
+      beforeReport,
+    } as unknown as AssistantCloudTelemetryConfig).telemetry;
+    expect(telemetry.enabled).toBe(true);
+    expect(telemetry.beforeReport).toBe(beforeReport);
+  });
+});

package/src/tests/AssistantCloudAPI.test.ts

@@ -169,6 +169,31 @@ describe("AssistantCloudAPI", () => {
     expect(error.status).toBe(400);
   });
 
+  it("falls back to the response text when the JSON error body has no message", async () => {
+    const fetchMock = vi.fn().mockResolvedValue({
+      ok: false,
+      status: 429,
+      headers: new Headers(),
+      text: vi
+        .fn()
+        .mockResolvedValue(JSON.stringify({ error: "rate limited" })),
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const api = new AssistantCloudAPI({
+      apiKey: "test-key",
+      userId: "u-1",
+      workspaceId: "w-1",
+    });
+
+    const error = await api.makeRawRequest("/threads").catch((e) => e);
+    expect(error).toBeInstanceOf(CloudAPIError);
+    expect(error.message).toBe(
+      'Request failed with status 429, {"error":"rate limited"}',
+    );
+    expect(error.status).toBe(429);
+  });
+
   it("throws generic error with status for non-JSON error responses", async () => {
     const fetchMock = vi.fn().mockResolvedValue({
       ok: false,