assistant-cloud 0.2.0 → 0.2.2

package/dist/AssistantCloudProjectThreads.d.ts

@@ -10,12 +10,11 @@ type AssistantCloudProjectThreadsListQuery = {
 type AssistantCloudProjectThreadsListResponse = {
   threads: CloudThread[];
 };
-declare class AssistantCloudProjectThreads {
+export declare class AssistantCloudProjectThreads {
   readonly messages: AssistantCloudProjectThreadMessages;
   private cloud;
   constructor(cloud: AssistantCloudAPI);
   list(query?: AssistantCloudProjectThreadsListQuery): Promise<AssistantCloudProjectThreadsListResponse>;
 }
 //#endregion
-export { AssistantCloudProjectThreads };
 //# sourceMappingURL=AssistantCloudProjectThreads.d.ts.map

package/dist/AssistantCloudProjectThreads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudProjectThreads.d.ts","names":[],"sources":["../src/AssistantCloudProjectThreads.ts"],"mappings":";;;;KAKK;EACH;EACA;EACA;;KAGG;EACH,SAAS;;cAGE;WACK,UAAU;UAElB;EAEI,YAAA,OAAO;EAKN,KACX,QAAQ,wCACP,QAAQ"}
+{"version":3,"file":"AssistantCloudProjectThreads.d.ts","names":[],"sources":["../src/AssistantCloudProjectThreads.ts"],"mappings":";;;;KAKK;EACH;EACA;EACA;;KAGG;EACH,SAAS;;qBAGE;WACK,UAAU;UAElB;EAEI,YAAA,OAAO;EAKN,KACX,QAAQ,wCACP,QAAQ"}

package/dist/AssistantCloudProjects.d.ts

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

package/dist/AssistantCloudProjects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloudProjects.d.ts","names":[],"sources":["../src/AssistantCloudProjects.ts"],"mappings":";;;cAGa;WACK,SAAS;EAEb,YAAA,OAAO"}
+{"version":3,"file":"AssistantCloudProjects.d.ts","names":[],"sources":["../src/AssistantCloudProjects.ts"],"mappings":";;;qBAGa;WACK,SAAS;EAEb,YAAA,OAAO"}

package/dist/AssistantCloudRuns.d.ts

@@ -7,7 +7,7 @@ type AssistantCloudRunsStreamBody = {
   assistant_id: "system/thread_title";
   messages: readonly unknown[];
 };
-type AssistantCloudRunReport = {
+export type AssistantCloudRunReport = {
   thread_id: string;
   status: "completed" | "incomplete" | "error";
   outcome_type?: "aborted" | "disconnected" | "length" | "content_filter";
@@ -42,13 +42,14 @@ type AssistantCloudRunReport = {
   output_text?: string;
   metadata?: Record<string, unknown>;
 };
-declare class AssistantCloudRuns {
+export declare class AssistantCloudRuns {
   private cloud;
   constructor(cloud: AssistantCloudAPI);
   __internal_getAssistantOptions(assistantId: string): {
     api: string;
     headers: () => Promise<{
       Accept: string;
+      "Aui-Sdk": string;
     }>;
     body: {
       assistant_id: string;
@@ -62,5 +63,4 @@ declare class AssistantCloudRuns {
   }>;
 }
 //#endregion
-export { AssistantCloudRunReport, AssistantCloudRuns };
 //# sourceMappingURL=AssistantCloudRuns.d.ts.map

package/dist/AssistantCloudRuns.d.ts.map

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

package/dist/AssistantCloudRuns.js

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

package/dist/AssistantCloudRuns.js.map

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

package/dist/AssistantCloudScores.d.ts

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

package/dist/AssistantCloudScores.d.ts.map

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

package/dist/AssistantCloudThreadMessages.d.ts

@@ -1,7 +1,7 @@
 import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { ReadonlyJSONObject } from "assistant-stream/utils";
 //#region src/AssistantCloudThreadMessages.d.ts
-type CloudMessage = {
+export type CloudMessage = {
   id: string;
   parent_id: string | null;
   height: number;
@@ -29,15 +29,17 @@ type AssistantCloudMessageCreateResponse = {
 type AssistantCloudThreadMessageUpdateBody = {
   content: ReadonlyJSONObject;
 };
-type AssistantCloudThreadMessageFeedbackBody = {
+export type AssistantCloudThreadMessageFeedbackBody = {
   type: "positive" | "negative";
+  comment?: string;
 };
-type AssistantCloudThreadMessageFeedbackResponse = {
+export type AssistantCloudThreadMessageFeedbackResponse = {
   feedback_id: string;
   type: "positive" | "negative";
+  comment?: string | null;
 };
-declare const decodeCloudMessage: (value: unknown, field: string) => CloudMessage;
-declare class AssistantCloudThreadMessages {
+export declare const decodeCloudMessage: (value: unknown, field: string) => CloudMessage;
+export declare class AssistantCloudThreadMessages {
   private cloud;
   constructor(cloud: AssistantCloudAPI);
   list(threadId: string, query?: AssistantCloudThreadMessageListQuery): Promise<AssistantCloudThreadMessageListResponse>;
@@ -46,5 +48,4 @@ declare class AssistantCloudThreadMessages {
   feedback(threadId: string, messageId: string, body: AssistantCloudThreadMessageFeedbackBody): Promise<AssistantCloudThreadMessageFeedbackResponse>;
 }
 //#endregion
-export { AssistantCloudThreadMessageFeedbackBody, AssistantCloudThreadMessageFeedbackResponse, AssistantCloudThreadMessages, CloudMessage, decodeCloudMessage };
 //# sourceMappingURL=AssistantCloudThreadMessages.d.ts.map

package/dist/AssistantCloudThreadMessages.d.ts.map

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

package/dist/AssistantCloudThreadMessages.js

@@ -36,13 +36,18 @@ var AssistantCloudThreadMessages = class {
 		});
 	}
 	async feedback(threadId, messageId, body) {
+		const comment = body.comment?.trim();
 		const response = readCloudRecord(await this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}/messages/${encodeURIComponent(messageId)}/feedback`, {
 			method: "POST",
-			body
+			body: {
+				type: body.type,
+				...comment ? { comment } : void 0
+			}
 		}), "thread message feedback response");
 		return {
 			feedback_id: readCloudString(response.feedback_id, "feedback_id"),
-			type: readCloudEnum(response.type, "type", MESSAGE_FEEDBACK_TYPES)
+			type: readCloudEnum(response.type, "type", MESSAGE_FEEDBACK_TYPES),
+			..."comment" in response ? { comment: readCloudNullableString(response.comment, "comment") } : void 0
 		};
 	}
 };

package/dist/AssistantCloudThreadMessages.js.map

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

package/dist/AssistantCloudThreads.d.ts

@@ -6,7 +6,7 @@ type AssistantCloudThreadsListQuery = {
   limit?: number;
   after?: string;
 };
-type CloudThread = {
+export type CloudThread = {
   title: string;
   last_message_at: Date;
   metadata: unknown;
@@ -42,8 +42,8 @@ type AssistantCloudThreadsUpdateBody = {
   metadata?: unknown | undefined;
   is_archived?: boolean | undefined;
 };
-declare const decodeCloudThread: (value: unknown, field: string) => CloudThread;
-declare class AssistantCloudThreads {
+export declare const decodeCloudThread: (value: unknown, field: string) => CloudThread;
+export declare class AssistantCloudThreads {
   readonly messages: AssistantCloudThreadMessages;
   private cloud;
   constructor(cloud: AssistantCloudAPI);
@@ -56,5 +56,4 @@ declare class AssistantCloudThreads {
   delete(threadId: string): Promise<void>;
 }
 //#endregion
-export { AssistantCloudThreads, CloudThread, decodeCloudThread };
 //# sourceMappingURL=AssistantCloudThreads.d.ts.map

package/dist/AssistantCloudThreads.d.ts.map

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

package/dist/CloudEngagementReporter.d.ts

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

package/dist/CloudEngagementReporter.d.ts.map

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

package/dist/CloudEngagementReporter.js

@@ -0,0 +1,132 @@
+//#region src/CloudEngagementReporter.ts
+const MAX_REMEMBERED_THREADS = 256;
+function remember(map, threadId, value) {
+	map.delete(threadId);
+	map.set(threadId, value);
+	if (map.size > MAX_REMEMBERED_THREADS) map.delete(map.keys().next().value);
+}
+function mark(set, threadId) {
+	set.delete(threadId);
+	set.add(threadId);
+	if (set.size > MAX_REMEMBERED_THREADS) set.delete(set.values().next().value);
+}
+const passThroughIds = (threadId, messageId) => ({
+	thread_id: threadId,
+	...messageId !== void 0 ? { message_id: messageId } : void 0
+});
+/**
+* Derives engagement events from what a chat integration observes and keeps
+* the per thread state the events need: a run's start for the stop duration,
+* a run's end for the time to the next message, one error and one suggestion
+* list per run or thread. A started run is kept until it ends or stops; the
+* rest is kept for the 256 most recently touched threads, so a long session
+* does not grow it without bound. Delivery goes through the cloud's event
+* buffer, so a disabled telemetry setting drops everything here as well.
+*/
+var CloudEngagementReporter = class {
+	runStartedAt = /* @__PURE__ */ new Map();
+	runEndedAt = /* @__PURE__ */ new Map();
+	shownErrors = /* @__PURE__ */ new Set();
+	shownSuggestions = /* @__PURE__ */ new Set();
+	getCloud;
+	resolveIds;
+	constructor(cloud, resolveIds = passThroughIds) {
+		this.getCloud = typeof cloud === "function" ? cloud : () => cloud;
+		this.resolveIds = resolveIds;
+	}
+	runStarted(threadId) {
+		this.runStartedAt.set(threadId, Date.now());
+		this.shownErrors.delete(threadId);
+	}
+	runEnded(threadId) {
+		this.runStartedAt.delete(threadId);
+		remember(this.runEndedAt, threadId, Date.now());
+	}
+	/** Reported once per started run, with the time the run had been going. */
+	runStopped(threadId) {
+		const startedAt = this.runStartedAt.get(threadId);
+		if (startedAt === void 0) return;
+		this.runStartedAt.delete(threadId);
+		this.track("run_stopped", threadId, void 0, { value: Math.max(0, Date.now() - startedAt) });
+	}
+	/** Carries the time since the previous run of the thread ended, when known. */
+	messageSent(threadId, init) {
+		const previousRunEndedAt = this.runEndedAt.get(threadId);
+		this.track("message_sent", threadId, init.messageId, {
+			props: {
+				chars: init.chars,
+				attachments: init.attachments
+			},
+			...previousRunEndedAt !== void 0 ? { value: Math.max(0, Date.now() - previousRunEndedAt) } : void 0
+		}, { awaitThread: true });
+	}
+	messageEdited(threadId, init) {
+		this.track("message_edited", threadId, init.messageId, { props: { chars: init.chars } });
+	}
+	messageRegenerated(threadId, messageId) {
+		this.track("message_regenerated", threadId, messageId);
+	}
+	/** Reported once per run, so a retried render of the same error stays one event. */
+	errorShown(threadId, init) {
+		if (this.shownErrors.has(threadId)) return;
+		mark(this.shownErrors, threadId);
+		this.track("error_shown", threadId, init.messageId, { props: { reason: init.reason } });
+	}
+	/** Reported once per thread, with the number of suggestions on offer. */
+	suggestionsShown(threadId, count) {
+		if (this.shownSuggestions.has(threadId)) return;
+		mark(this.shownSuggestions, threadId);
+		this.track("suggestions_shown", threadId, void 0, { value: count });
+	}
+	suggestionClicked(threadId) {
+		this.track("suggestion_clicked", threadId);
+	}
+	attachmentAdded(threadId, init) {
+		this.track("attachment_added", threadId, init.messageId, { ...init.contentType ? { props: { type: init.contentType } } : void 0 });
+	}
+	attachmentFailed(threadId, init) {
+		this.track("attachment_failed", threadId, init.messageId, { ...init.contentType ? { props: { type: init.contentType } } : void 0 });
+	}
+	voiceStarted(threadId) {
+		this.track("voice_started", threadId);
+	}
+	speechStarted(threadId, messageId) {
+		this.track("speech_started", threadId, messageId);
+	}
+	branchSwitched(threadId, messageId) {
+		this.track("branch_switched", threadId, messageId);
+	}
+	messageCopied(threadId, messageId) {
+		this.track("message_copied", threadId, messageId);
+	}
+	toolApproved(threadId, messageId, toolCallId, toolName) {
+		this.track("tool_approved", threadId, messageId, { props: {
+			toolCallId,
+			toolName
+		} });
+	}
+	toolRejected(threadId, messageId, toolCallId, toolName) {
+		this.track("tool_rejected", threadId, messageId, { props: {
+			toolCallId,
+			toolName
+		} });
+	}
+	/** Reported only for a thread the cloud already knows. */
+	threadSwitched(threadId) {
+		this.track("thread_switched", threadId);
+	}
+	track(kind, threadId, messageId, init = {}, options = { awaitThread: false }) {
+		Promise.resolve().then(() => this.resolveIds(threadId, messageId, options)).then((ids) => {
+			if (kind === "thread_switched" && !ids.thread_id) return;
+			this.getCloud().events.track({
+				kind,
+				...init,
+				...ids
+			});
+		}).catch(() => {});
+	}
+};
+//#endregion
+export { CloudEngagementReporter };
+
+//# sourceMappingURL=CloudEngagementReporter.js.map

package/dist/CloudEngagementReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudEngagementReporter.js","names":[],"sources":["../src/CloudEngagementReporter.ts"],"sourcesContent":["import type { AssistantCloud } from \"./AssistantCloud\";\nimport type {\n  AssistantCloudEvent,\n  AssistantCloudEventKind,\n} from \"./AssistantCloudEvents\";\n\nexport type EngagementEventIds = Pick<\n  AssistantCloudEvent,\n  \"thread_id\" | \"message_id\" | \"run_id\"\n>;\n\n/**\n * Turns the ids an integration knows (its own thread and message ids) into the\n * ids the cloud stores. A send is the one event that may create the remote\n * thread, so it asks for `awaitThread`; every other event reads the ids that\n * already exist.\n */\nexport type EngagementIdResolver = (\n  threadId: string,\n  messageId: string | undefined,\n  options: { awaitThread: boolean },\n) => EngagementEventIds | Promise<EngagementEventIds>;\n\ntype EngagementEventInit = Pick<AssistantCloudEvent, \"value\" | \"props\">;\n\nconst MAX_REMEMBERED_THREADS = 256;\n\nfunction remember<T>(map: Map<string, T>, threadId: string, value: T): void {\n  map.delete(threadId);\n  map.set(threadId, value);\n  if (map.size > MAX_REMEMBERED_THREADS) {\n    map.delete(map.keys().next().value!);\n  }\n}\n\nfunction mark(set: Set<string>, threadId: string): void {\n  set.delete(threadId);\n  set.add(threadId);\n  if (set.size > MAX_REMEMBERED_THREADS) {\n    set.delete(set.values().next().value!);\n  }\n}\n\nconst passThroughIds: EngagementIdResolver = (threadId, messageId) => ({\n  thread_id: threadId,\n  ...(messageId !== undefined ? { message_id: messageId } : undefined),\n});\n\n/**\n * Derives engagement events from what a chat integration observes and keeps\n * the per thread state the events need: a run's start for the stop duration,\n * a run's end for the time to the next message, one error and one suggestion\n * list per run or thread. A started run is kept until it ends or stops; the\n * rest is kept for the 256 most recently touched threads, so a long session\n * does not grow it without bound. Delivery goes through the cloud's event\n * buffer, so a disabled telemetry setting drops everything here as well.\n */\nexport class CloudEngagementReporter {\n  private readonly runStartedAt = new Map<string, number>();\n  private readonly runEndedAt = new Map<string, number>();\n  private readonly shownErrors = new Set<string>();\n  private readonly shownSuggestions = new Set<string>();\n\n  private readonly getCloud: () => AssistantCloud;\n  private readonly resolveIds: EngagementIdResolver;\n\n  constructor(\n    cloud: AssistantCloud | (() => AssistantCloud),\n    resolveIds: EngagementIdResolver = passThroughIds,\n  ) {\n    this.getCloud = typeof cloud === \"function\" ? cloud : () => cloud;\n    this.resolveIds = resolveIds;\n  }\n\n  public runStarted(threadId: string): void {\n    this.runStartedAt.set(threadId, Date.now());\n    this.shownErrors.delete(threadId);\n  }\n\n  public runEnded(threadId: string): void {\n    this.runStartedAt.delete(threadId);\n    remember(this.runEndedAt, threadId, Date.now());\n  }\n\n  /** Reported once per started run, with the time the run had been going. */\n  public runStopped(threadId: string): void {\n    const startedAt = this.runStartedAt.get(threadId);\n    if (startedAt === undefined) return;\n    this.runStartedAt.delete(threadId);\n    this.track(\"run_stopped\", threadId, undefined, {\n      value: Math.max(0, Date.now() - startedAt),\n    });\n  }\n\n  /** Carries the time since the previous run of the thread ended, when known. */\n  public messageSent(\n    threadId: string,\n    init: {\n      messageId?: string | undefined;\n      chars: number;\n      attachments: number;\n    },\n  ): void {\n    const previousRunEndedAt = this.runEndedAt.get(threadId);\n    this.track(\n      \"message_sent\",\n      threadId,\n      init.messageId,\n      {\n        props: { chars: init.chars, attachments: init.attachments },\n        ...(previousRunEndedAt !== undefined\n          ? { value: Math.max(0, Date.now() - previousRunEndedAt) }\n          : undefined),\n      },\n      { awaitThread: true },\n    );\n  }\n\n  public messageEdited(\n    threadId: string,\n    init: { messageId: string; chars: number },\n  ): void {\n    this.track(\"message_edited\", threadId, init.messageId, {\n      props: { chars: init.chars },\n    });\n  }\n\n  public messageRegenerated(threadId: string, messageId?: string): void {\n    this.track(\"message_regenerated\", threadId, messageId);\n  }\n\n  /** Reported once per run, so a retried render of the same error stays one event. */\n  public errorShown(\n    threadId: string,\n    init: { messageId?: string | undefined; reason: string },\n  ): void {\n    if (this.shownErrors.has(threadId)) return;\n    mark(this.shownErrors, threadId);\n    this.track(\"error_shown\", threadId, init.messageId, {\n      props: { reason: init.reason },\n    });\n  }\n\n  /** Reported once per thread, with the number of suggestions on offer. */\n  public suggestionsShown(threadId: string, count: number): void {\n    if (this.shownSuggestions.has(threadId)) return;\n    mark(this.shownSuggestions, threadId);\n    this.track(\"suggestions_shown\", threadId, undefined, { value: count });\n  }\n\n  public suggestionClicked(threadId: string): void {\n    this.track(\"suggestion_clicked\", threadId);\n  }\n\n  public attachmentAdded(\n    threadId: string,\n    init: { messageId?: string | undefined; contentType?: string | undefined },\n  ): void {\n    this.track(\"attachment_added\", threadId, init.messageId, {\n      ...(init.contentType ? { props: { type: init.contentType } } : undefined),\n    });\n  }\n\n  public attachmentFailed(\n    threadId: string,\n    init: { messageId?: string | undefined; contentType?: string | undefined },\n  ): void {\n    this.track(\"attachment_failed\", threadId, init.messageId, {\n      ...(init.contentType ? { props: { type: init.contentType } } : undefined),\n    });\n  }\n\n  public voiceStarted(threadId: string): void {\n    this.track(\"voice_started\", threadId);\n  }\n\n  public speechStarted(threadId: string, messageId?: string): void {\n    this.track(\"speech_started\", threadId, messageId);\n  }\n\n  public branchSwitched(threadId: string, messageId?: string): void {\n    this.track(\"branch_switched\", threadId, messageId);\n  }\n\n  public messageCopied(threadId: string, messageId?: string): void {\n    this.track(\"message_copied\", threadId, messageId);\n  }\n\n  public toolApproved(\n    threadId: string,\n    messageId: string,\n    toolCallId: string,\n    toolName: string,\n  ): void {\n    this.track(\"tool_approved\", threadId, messageId, {\n      props: { toolCallId, toolName },\n    });\n  }\n\n  public toolRejected(\n    threadId: string,\n    messageId: string,\n    toolCallId: string,\n    toolName: string,\n  ): void {\n    this.track(\"tool_rejected\", threadId, messageId, {\n      props: { toolCallId, toolName },\n    });\n  }\n\n  /** Reported only for a thread the cloud already knows. */\n  public threadSwitched(threadId: string): void {\n    this.track(\"thread_switched\", threadId);\n  }\n\n  private track(\n    kind: AssistantCloudEventKind,\n    threadId: string,\n    messageId?: string,\n    init: EngagementEventInit = {},\n    options: { awaitThread: boolean } = { awaitThread: false },\n  ): void {\n    void Promise.resolve()\n      .then(() => this.resolveIds(threadId, messageId, options))\n      .then((ids) => {\n        if (kind === \"thread_switched\" && !ids.thread_id) return;\n        this.getCloud().events.track({ kind, ...init, ...ids });\n      })\n      .catch(() => {});\n  }\n}\n"],"mappings":"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"}

package/dist/CloudMessagePersistence.d.ts

@@ -3,17 +3,11 @@ import { AssistantCloud } from "./AssistantCloud.js";
 import { ReadonlyJSONObject } from "assistant-stream/utils";
 //#region src/CloudMessagePersistence.d.ts
 /**
- * Shared persistence logic for cloud message storage.
- *
- * Handles ID mapping (local → remote) and parent_id chaining for both:
- * - AssistantCloudThreadHistoryAdapter (assistant-ui runtime)
- * - useCloudChat (standalone AI SDK hook)
- *
- * The promise-based ID resolution handles concurrent appends — if message B's
- * parent is message A, and A is still being created, we await A's promise
- * to get its remote ID before creating B.
+ * Appends, updates and loads cloud messages while mapping local ids to cloud
+ * ids and chaining parent_id. A parent that is still being created is awaited,
+ * so concurrent appends land under the right parent.
  */
-declare class CloudMessagePersistence {
+export declare class CloudMessagePersistence {
   private idMapping;
   private getCloud;
   constructor(cloud: AssistantCloud);
@@ -51,6 +45,8 @@ declare class CloudMessagePersistence {
    * The ID mapping is populated so that `isPersisted()` returns true for
    * loaded messages, preventing re-persistence of already-stored messages.
    *
+   * A loaded ID that an append already maps keeps the remote ID from that append, and falls back to the loaded ID if the append fails.
+   *
    * @param threadId - Remote thread ID
    * @param format - Optional format filter
    * @returns Array of cloud messages
@@ -58,9 +54,11 @@ declare class CloudMessagePersistence {
   load(threadId: string, format?: string): Promise<CloudMessage[]>;
   /**
    * Reset the ID mapping (call when switching threads).
+   *
+   * Pending `load()` and `append()` calls are not cancelled and still settle
+   * normally, but their results no longer populate the ID mapping.
    */
   reset(): void;
 }
 //#endregion
-export { CloudMessagePersistence };
 //# sourceMappingURL=CloudMessagePersistence.d.ts.map

package/dist/CloudMessagePersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudMessagePersistence.d.ts","names":[],"sources":["../src/CloudMessagePersistence.ts"],"mappings":";;;;;;;;;;;;;;;cAiBa;UACH;UACA;EAEI,YAAA,OAAO;EACP,YAAA,gBAAgB;;;;;;;;;;EActB,OACJ,kBACA,mBACA,yBACA,gBACA,SAAS,qBACR;;;;EAsCG,OACJ,kBACA,mBACA,iBACA,SAAS,qBACR;;;;EAeH,YAAY;;;;;EAQN,YAAY,oBAAoB;EAMtC,oBAAoB;;;;;;;;;;;;;;EAkBd,KAAK,kBAAkB,kBAAe,QAAA;;;;EAoC5C"}
+{"version":3,"file":"CloudMessagePersistence.d.ts","names":[],"sources":["../src/CloudMessagePersistence.ts"],"mappings":";;;;;;;;;qBAWa;UACH;UACA;EAEI,YAAA,OAAO;EACP,YAAA,gBAAgB;;;;;;;;;;EActB,OACJ,kBACA,mBACA,yBACA,gBACA,SAAS,qBACR;;;;EAsCG,OACJ,kBACA,mBACA,iBACA,SAAS,qBACR;;;;EAeH,YAAY;;;;;EAQN,YAAY,oBAAoB;EAMtC,oBAAoB;;;;;;;;;;;;;;;;EAoBd,KAAK,kBAAkB,kBAAe,QAAA;;;;;;;EAmD5C"}

package/dist/CloudMessagePersistence.js

@@ -1,15 +1,9 @@
 //#region src/CloudMessagePersistence.ts
 const CLOUD_MESSAGE_PAGE_SIZE = 200;
 /**
-* Shared persistence logic for cloud message storage.
-*
-* Handles ID mapping (local → remote) and parent_id chaining for both:
-* - AssistantCloudThreadHistoryAdapter (assistant-ui runtime)
-* - useCloudChat (standalone AI SDK hook)
-*
-* The promise-based ID resolution handles concurrent appends — if message B's
-* parent is message A, and A is still being created, we await A's promise
-* to get its remote ID before creating B.
+* Appends, updates and loads cloud messages while mapping local ids to cloud
+* ids and chaining parent_id. A parent that is still being created is awaited,
+* so concurrent appends land under the right parent.
 */
 var CloudMessagePersistence = class {
 	idMapping = /* @__PURE__ */ new Map();
@@ -92,11 +86,14 @@ var CloudMessagePersistence = class {
 	* The ID mapping is populated so that `isPersisted()` returns true for
 	* loaded messages, preventing re-persistence of already-stored messages.
 	*
+	* A loaded ID that an append already maps keeps the remote ID from that append, and falls back to the loaded ID if the append fails.
+	*
 	* @param threadId - Remote thread ID
 	* @param format - Optional format filter
 	* @returns Array of cloud messages
 	*/
 	async load(threadId, format) {
+		const idMapping = this.idMapping;
 		const cloud = this.getCloud();
 		const messages = [];
 		const seen = /* @__PURE__ */ new Set();
@@ -116,14 +113,24 @@ var CloudMessagePersistence = class {
 			if (page.messages.length < CLOUD_MESSAGE_PAGE_SIZE) break;
 			after = last.id;
 		}
-		for (const m of messages) this.idMapping.set(m.id, m.id);
+		if (this.idMapping === idMapping) for (const m of messages) {
+			const entry = idMapping.get(m.id);
+			if (entry === void 0) idMapping.set(m.id, m.id);
+			else if (entry instanceof Promise) entry.catch(() => {
+				const current = idMapping.get(m.id);
+				if (current === void 0 || current === entry) idMapping.set(m.id, m.id);
+			});
+		}
 		return messages;
 	}
 	/**
 	* Reset the ID mapping (call when switching threads).
+	*
+	* Pending `load()` and `append()` calls are not cancelled and still settle
+	* normally, but their results no longer populate the ID mapping.
 	*/
 	reset() {
-		this.idMapping.clear();
+		this.idMapping = /* @__PURE__ */ new Map();
 	}
 };
 //#endregion