assistant-cloud 0.2.1 → 0.2.3

package/dist/AssistantCloudScores.d.ts

@@ -1,27 +1,24 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-//#region src/AssistantCloudScores.d.ts
-type AssistantCloudScoreBody = {
-  name: string;
-  data_type: "numeric" | "categorical" | "boolean";
-  value?: number | boolean;
-  string_value?: string;
-  comment?: string;
-  thread_id?: string;
-  message_id?: string;
-  run_id?: string;
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+export type AssistantCloudScoreBody = {
+    name: string;
+    data_type: "numeric" | "categorical" | "boolean";
+    value?: number | boolean;
+    string_value?: string;
+    comment?: string;
+    thread_id?: string;
+    message_id?: string;
+    run_id?: string;
 };
-type AssistantCloudScoreResponse = {
-  score_id: string;
-  name: string;
-  data_type: "numeric" | "categorical" | "boolean";
-  value: number | null;
-  string_value: string | null;
+export type AssistantCloudScoreResponse = {
+    score_id: string;
+    name: string;
+    data_type: "numeric" | "categorical" | "boolean";
+    value: number | null;
+    string_value: string | null;
 };
-declare class AssistantCloudScores {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  create(body: AssistantCloudScoreBody): Promise<AssistantCloudScoreResponse>;
+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","sourceRoot":"","sources":["../src/AssistantCloudScores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAW7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAIvB,MAAM,CACjB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC;CAqBxC"}

package/dist/AssistantCloudThreadMessages.d.ts

@@ -1,50 +1,53 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
-import { ReadonlyJSONObject } from "assistant-stream/utils";
-//#region src/AssistantCloudThreadMessages.d.ts
-type CloudMessage = {
-  id: string;
-  parent_id: string | null;
-  height: number;
-  created_at: Date;
-  updated_at: Date;
-  format: "aui/v0" | string;
-  content: ReadonlyJSONObject;
+import type { ReadonlyJSONObject } from "assistant-stream/utils";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+export type CloudMessage = {
+    id: string;
+    parent_id: string | null;
+    height: number;
+    created_at: Date;
+    updated_at: Date;
+    format: "aui/v0" | string;
+    content: ReadonlyJSONObject;
+    external_id?: string | null | undefined;
 };
 type AssistantCloudThreadMessageListQuery = {
-  format?: string;
-  limit?: number;
-  after?: string;
+    format?: string;
+    limit?: number;
+    after?: string;
 };
 type AssistantCloudThreadMessageListResponse = {
-  messages: CloudMessage[];
+    messages: CloudMessage[];
 };
 type AssistantCloudThreadMessageCreateBody = {
-  parent_id: string | null;
-  format: "aui/v0" | string;
-  content: ReadonlyJSONObject;
+    parent_id: string | null;
+    format: "aui/v0" | string;
+    content: ReadonlyJSONObject;
+    external_id?: string | undefined;
+    parent_external_id?: string | undefined;
 };
 type AssistantCloudMessageCreateResponse = {
-  message_id: string;
+    message_id: string;
 };
 type AssistantCloudThreadMessageUpdateBody = {
-  content: ReadonlyJSONObject;
-};
-type AssistantCloudThreadMessageFeedbackBody = {
-  type: "positive" | "negative";
-};
-type AssistantCloudThreadMessageFeedbackResponse = {
-  feedback_id: string;
-  type: "positive" | "negative";
-};
-declare const decodeCloudMessage: (value: unknown, field: string) => CloudMessage;
-declare class AssistantCloudThreadMessages {
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  list(threadId: string, query?: AssistantCloudThreadMessageListQuery): Promise<AssistantCloudThreadMessageListResponse>;
-  create(threadId: string, body: AssistantCloudThreadMessageCreateBody): Promise<AssistantCloudMessageCreateResponse>;
-  update(threadId: string, messageId: string, body: AssistantCloudThreadMessageUpdateBody): Promise<void>;
-  feedback(threadId: string, messageId: string, body: AssistantCloudThreadMessageFeedbackBody): Promise<AssistantCloudThreadMessageFeedbackResponse>;
+    content: ReadonlyJSONObject;
+};
+export type AssistantCloudThreadMessageFeedbackBody = {
+    type: "positive" | "negative";
+    comment?: string;
+};
+export type AssistantCloudThreadMessageFeedbackResponse = {
+    feedback_id: string;
+    type: "positive" | "negative";
+    comment?: string | null;
+};
+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>;
+    create(threadId: string, body: AssistantCloudThreadMessageCreateBody): Promise<AssistantCloudMessageCreateResponse>;
+    update(threadId: string, messageId: string, body: AssistantCloudThreadMessageUpdateBody): Promise<void>;
+    feedback(threadId: string, messageId: string, body: AssistantCloudThreadMessageFeedbackBody): Promise<AssistantCloudThreadMessageFeedbackResponse>;
 }
-//#endregion
-export { AssistantCloudThreadMessageFeedbackBody, AssistantCloudThreadMessageFeedbackResponse, AssistantCloudThreadMessages, CloudMessage, decodeCloudMessage };
+export {};
 //# 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","sourceRoot":"","sources":["../src/AssistantCloudThreadMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAY7D,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,KAAK,oCAAoC,GAAG;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,uCAAuC,GAAG;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,CAAC;AAEF,KAAK,qCAAqC,GAAG;IAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,KAAK,mCAAmC,GAAG;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,qCAAqC,GAAG;IAC3C,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAIF,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,EACd,OAAO,MAAM,KACZ,YAeF,CAAC;AAEF,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAIvB,IAAI,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,oCAAoC,GAC3C,OAAO,CAAC,uCAAuC,CAAC;IAiBtC,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,qCAAqC,GAC1C,OAAO,CAAC,mCAAmC,CAAC;IA2BlC,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qCAAqC,GAC1C,OAAO,CAAC,IAAI,CAAC;IAOH,QAAQ,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,uCAAuC,GAC5C,OAAO,CAAC,2CAA2C,CAAC;CAwBxD"}

package/dist/AssistantCloudThreadMessages.js

@@ -10,7 +10,8 @@ const decodeCloudMessage = (value, field) => {
 		created_at: readCloudTimestamp(message.created_at, `${field}.created_at`),
 		updated_at: readCloudTimestamp(message.updated_at, `${field}.updated_at`),
 		format: readCloudString(message.format, `${field}.format`),
-		content: readCloudJSONObject(message.content, `${field}.content`)
+		content: readCloudJSONObject(message.content, `${field}.content`),
+		external_id: readCloudNullableString(message.external_id ?? null, `${field}.external_id`)
 	};
 };
 var AssistantCloudThreadMessages = class {
@@ -25,7 +26,13 @@ var AssistantCloudThreadMessages = class {
 	async create(threadId, body) {
 		const response = readCloudRecord(await this.cloud.makeRequest(`/threads/${encodeURIComponent(threadId)}/messages`, {
 			method: "POST",
-			body
+			body: {
+				parent_id: body.parent_id,
+				format: body.format,
+				content: body.content,
+				...body.external_id !== void 0 ? { external_id: body.external_id } : void 0,
+				...body.parent_external_id !== void 0 ? { parent_external_id: body.parent_external_id } : void 0
+			}
 		}), "thread message create response");
 		return { message_id: readCloudString(response.message_id, "message_id") };
 	}
@@ -36,13 +43,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  external_id?: string | null | undefined;\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  external_id?: string | undefined;\n  parent_external_id?: string | undefined;\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    external_id: readCloudNullableString(\n      message.external_id ?? null,\n      `${field}.external_id`,\n    ),\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        {\n          method: \"POST\",\n          body: {\n            parent_id: body.parent_id,\n            format: body.format,\n            content: body.content,\n            ...(body.external_id !== undefined\n              ? { external_id: body.external_id }\n              : undefined),\n            ...(body.parent_external_id !== undefined\n              ? { parent_external_id: body.parent_external_id }\n              : undefined),\n          },\n        },\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":";;AAkDA,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;EAChE,aAAa,wBACX,QAAQ,eAAe,MACvB,GAAG,MAAM,aACX;CACF;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;GACE,QAAQ;GACR,MAAM;IACJ,WAAW,KAAK;IAChB,QAAQ,KAAK;IACb,SAAS,KAAK;IACd,GAAI,KAAK,gBAAgB,KAAA,IACrB,EAAE,aAAa,KAAK,YAAY,IAChC,KAAA;IACJ,GAAI,KAAK,uBAAuB,KAAA,IAC5B,EAAE,oBAAoB,KAAK,mBAAmB,IAC9C,KAAA;GACN;EACF,CACF,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

@@ -1,60 +1,58 @@
-import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
+import type { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { AssistantCloudThreadMessages } from "./AssistantCloudThreadMessages.js";
-//#region src/AssistantCloudThreads.d.ts
 type AssistantCloudThreadsListQuery = {
-  is_archived?: boolean;
-  limit?: number;
-  after?: string;
-};
-type CloudThread = {
-  title: string;
-  last_message_at: Date;
-  metadata: unknown;
-  external_id: string | null;
-  id: string;
-  project_id: string;
-  created_at: Date;
-  updated_at: Date;
-  workspace_id: string;
-  is_archived: boolean;
+    is_archived?: boolean;
+    limit?: number;
+    after?: string;
+};
+export type CloudThread = {
+    title: string;
+    last_message_at: Date;
+    metadata: unknown;
+    external_id: string | null;
+    id: string;
+    project_id: string;
+    created_at: Date;
+    updated_at: Date;
+    workspace_id: string;
+    is_archived: boolean;
 };
 type AssistantCloudThreadsListResponse = {
-  threads: CloudThread[];
+    threads: CloudThread[];
 };
 type AssistantCloudThreadsCreateBody = {
-  title?: string | undefined;
-  last_message_at: Date;
-  metadata?: unknown | undefined;
-  external_id?: string | undefined;
+    title?: string | undefined;
+    last_message_at: Date;
+    metadata?: unknown | undefined;
+    external_id?: string | undefined;
 };
 type AssistantCloudThreadsCreateResponse = {
-  thread_id: string;
+    thread_id: string;
 };
 type AssistantCloudThreadsClaimBody = {
-  refresh_token: string;
+    refresh_token: string;
 };
 type AssistantCloudThreadsClaimResponse = {
-  moved: number;
+    moved: number;
 };
 type AssistantCloudThreadsUpdateBody = {
-  title?: string | undefined;
-  last_message_at?: Date | undefined;
-  metadata?: unknown | undefined;
-  is_archived?: boolean | undefined;
-};
-declare const decodeCloudThread: (value: unknown, field: string) => CloudThread;
-declare class AssistantCloudThreads {
-  readonly messages: AssistantCloudThreadMessages;
-  private cloud;
-  constructor(cloud: AssistantCloudAPI);
-  list(query?: AssistantCloudThreadsListQuery): Promise<AssistantCloudThreadsListResponse>;
-  get(threadId: string): Promise<CloudThread>;
-  create(body: AssistantCloudThreadsCreateBody): Promise<AssistantCloudThreadsCreateResponse>;
-  update(threadId: string, body: AssistantCloudThreadsUpdateBody): Promise<void>;
-  /** Moves every thread of the anonymous identity behind `refresh_token` into the caller's workspace. */
-  claim(body: AssistantCloudThreadsClaimBody): Promise<AssistantCloudThreadsClaimResponse>;
-  delete(threadId: string): Promise<void>;
+    title?: string | undefined;
+    last_message_at?: Date | undefined;
+    metadata?: unknown | undefined;
+    is_archived?: boolean | undefined;
+};
+export declare const decodeCloudThread: (value: unknown, field: string) => CloudThread;
+export declare class AssistantCloudThreads {
+    readonly messages: AssistantCloudThreadMessages;
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    list(query?: AssistantCloudThreadsListQuery): Promise<AssistantCloudThreadsListResponse>;
+    get(threadId: string): Promise<CloudThread>;
+    create(body: AssistantCloudThreadsCreateBody): Promise<AssistantCloudThreadsCreateResponse>;
+    update(threadId: string, body: AssistantCloudThreadsUpdateBody): Promise<void>;
+    /** Moves every thread of the anonymous identity behind `refresh_token` into the caller's workspace. */
+    claim(body: AssistantCloudThreadsClaimBody): Promise<AssistantCloudThreadsClaimResponse>;
+    delete(threadId: string): Promise<void>;
 }
-//#endregion
-export { AssistantCloudThreads, CloudThread, decodeCloudThread };
+export {};
 //# 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","sourceRoot":"","sources":["../src/AssistantCloudThreads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA4B;AAC7D,OAAO,EAAE,4BAA4B,EAAE,0CAAuC;AAW9E,KAAK,8BAA8B,GAAG;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,iCAAiC,GAAG;IACvC,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF,KAAK,+BAA+B,GAAG;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,eAAe,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,KAAK,mCAAmC,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,kCAAkC,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,+BAA+B,GAAG;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,OAAO,MAAM,KACZ,WAoBF,CAAC;AAEF,qBAAa,qBAAqB;IAChC,SAAgB,QAAQ,EAAE,4BAA4B,CAAC;IAEvD,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,EAAE,iBAAiB;IAKvB,IAAI,CACf,KAAK,CAAC,EAAE,8BAA8B,GACrC,OAAO,CAAC,iCAAiC,CAAC;IAkBhC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAS3C,MAAM,CACjB,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,mCAAmC,CAAC;IASlC,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,IAAI,CAAC;IAOhB,uGAAuG;IAC1F,KAAK,CAChB,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,kCAAkC,CAAC;IASjC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrD"}

package/dist/CloudEngagementReporter.d.ts

@@ -1,16 +1,16 @@
-import { AssistantCloudEvent } from "./AssistantCloudEvents.js";
-import { AssistantCloud } from "./AssistantCloud.js";
-//#region src/CloudEngagementReporter.d.ts
-type EngagementEventIds = Pick<AssistantCloudEvent, "thread_id" | "message_id" | "run_id">;
+import type { AssistantCloud } from "./AssistantCloud.js";
+import type { AssistantCloudEvent } from "./AssistantCloudEvents.js";
+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.
+ * already exist. Returning nothing declines the event: the thread is not one
+ * the integration knows, so there is nothing to attribute it to.
  */
-type EngagementIdResolver = (threadId: string, messageId: string | undefined, options: {
-  awaitThread: boolean;
-}) => EngagementEventIds | Promise<EngagementEventIds>;
+export type EngagementIdResolver = (threadId: string, messageId: string | undefined, options: {
+    awaitThread: boolean;
+}) => EngagementEventIds | undefined | Promise<EngagementEventIds | undefined>;
 /**
  * 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,
@@ -20,55 +20,53 @@ type EngagementIdResolver = (threadId: string, messageId: string | undefined, op
  * does not grow it without bound. Delivery goes through the cloud's event
  * buffer, so a disabled telemetry setting drops everything here as well.
  */
-declare class CloudEngagementReporter {
-  private readonly runStartedAt;
-  private readonly runEndedAt;
-  private readonly shownErrors;
-  private readonly shownSuggestions;
-  private readonly getCloud;
-  private readonly resolveIds;
-  constructor(cloud: AssistantCloud | (() => AssistantCloud), resolveIds?: EngagementIdResolver);
-  runStarted(threadId: string): void;
-  runEnded(threadId: string): void;
-  /** Reported once per started run, with the time the run had been going. */
-  runStopped(threadId: string): void;
-  /** Carries the time since the previous run of the thread ended, when known. */
-  messageSent(threadId: string, init: {
-    messageId?: string | undefined;
-    chars: number;
-    attachments: number;
-  }): void;
-  messageEdited(threadId: string, init: {
-    messageId: string;
-    chars: number;
-  }): void;
-  messageRegenerated(threadId: string, messageId?: string): void;
-  /** Reported once per run, so a retried render of the same error stays one event. */
-  errorShown(threadId: string, init: {
-    messageId?: string | undefined;
-    reason: string;
-  }): void;
-  /** Reported once per thread, with the number of suggestions on offer. */
-  suggestionsShown(threadId: string, count: number): void;
-  suggestionClicked(threadId: string): void;
-  attachmentAdded(threadId: string, init: {
-    messageId?: string | undefined;
-    contentType?: string | undefined;
-  }): void;
-  attachmentFailed(threadId: string, init: {
-    messageId?: string | undefined;
-    contentType?: string | undefined;
-  }): void;
-  voiceStarted(threadId: string): void;
-  speechStarted(threadId: string, messageId?: string): void;
-  branchSwitched(threadId: string, messageId?: string): void;
-  messageCopied(threadId: string, messageId?: string): void;
-  toolApproved(threadId: string, messageId: string, toolCallId: string, toolName: string): void;
-  toolRejected(threadId: string, messageId: string, toolCallId: string, toolName: string): void;
-  /** Reported only for a thread the cloud already knows. */
-  threadSwitched(threadId: string): void;
-  private track;
+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
-export { CloudEngagementReporter, EngagementEventIds, EngagementIdResolver };
 //# sourceMappingURL=CloudEngagementReporter.d.ts.map

package/dist/CloudEngagementReporter.d.ts.map

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

package/dist/CloudEngagementReporter.js

@@ -46,8 +46,10 @@ var CloudEngagementReporter = class {
 	runStopped(threadId) {
 		const startedAt = this.runStartedAt.get(threadId);
 		if (startedAt === void 0) return;
+		const stoppedAt = Date.now();
 		this.runStartedAt.delete(threadId);
-		this.track("run_stopped", threadId, void 0, { value: Math.max(0, Date.now() - startedAt) });
+		remember(this.runEndedAt, threadId, stoppedAt);
+		this.track("run_stopped", threadId, void 0, { value: Math.max(0, stoppedAt - startedAt) });
 	}
 	/** Carries the time since the previous run of the thread ended, when known. */
 	messageSent(threadId, init) {
@@ -117,6 +119,7 @@ var CloudEngagementReporter = class {
 	}
 	track(kind, threadId, messageId, init = {}, options = { awaitThread: false }) {
 		Promise.resolve().then(() => this.resolveIds(threadId, messageId, options)).then((ids) => {
+			if (!ids) return;
 			if (kind === "thread_switched" && !ids.thread_id) return;
 			this.getCloud().events.track({
 				kind,

package/dist/CloudEngagementReporter.js.map

@@ -1 +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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"}
+{"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. Returning nothing declines the event: the thread is not one\n * the integration knows, so there is nothing to attribute it to.\n */\nexport type EngagementIdResolver = (\n  threadId: string,\n  messageId: string | undefined,\n  options: { awaitThread: boolean },\n) => EngagementEventIds | undefined | Promise<EngagementEventIds | undefined>;\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    const stoppedAt = Date.now();\n    this.runStartedAt.delete(threadId);\n    // A stopped run is a run that ended, so the next send measures its idle\n    // time from here rather than from the last run allowed to finish.\n    remember(this.runEndedAt, threadId, stoppedAt);\n    this.track(\"run_stopped\", threadId, undefined, {\n      value: Math.max(0, stoppedAt - 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 (!ids) return;\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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"}