assistant-cloud 0.1.43 → 0.2.1

package/dist/ai-sdk/index.js

@@ -0,0 +1,147 @@
+import { createRunTelemetryToolCall, extractRunTelemetryModelId, normalizeRunTelemetryUsage, truncateRunTelemetryText } from "../runTelemetry.js";
+//#region src/ai-sdk/index.ts
+/** The stored form of an AI SDK message: the message without its id. */
+const aiSDKV6FormatAdapter = {
+	format: "ai-sdk/v6",
+	encode: ({ message: { id: _id, ...message } }) => message,
+	decode: (stored) => ({
+		parentId: stored.parent_id,
+		message: {
+			id: stored.id,
+			...stored.content
+		}
+	}),
+	getId: (message) => message.id
+};
+function isRecord(value) {
+	return value !== null && typeof value === "object";
+}
+function isPart(value) {
+	return isRecord(value) && typeof value.type === "string";
+}
+/**
+* The AI SDK's own tool part rules, kept here so the entry loads without the
+* `ai` runtime: a static tool part is `tool-<name>`, a dynamic one is
+* `dynamic-tool` with its name in `toolName`.
+*/
+function toolCallOf(part) {
+	if (typeof part.toolCallId !== "string") return void 0;
+	const isStatic = part.type.startsWith("tool-");
+	if (!isStatic && part.type !== "dynamic-tool") return void 0;
+	const toolName = isStatic ? part.type.slice(5) : typeof part.toolName === "string" ? part.toolName : void 0;
+	if (!toolName) return void 0;
+	return createRunTelemetryToolCall({
+		toolName,
+		toolCallId: part.toolCallId,
+		args: part.input ?? part.args,
+		result: part.output ?? part.result,
+		toolSource: isStatic ? "frontend" : "mcp"
+	});
+}
+function attachSamplingCalls(toolCalls, metadata) {
+	const samplingCalls = isRecord(metadata?.samplingCalls) ? metadata.samplingCalls : void 0;
+	if (!samplingCalls) return;
+	for (const toolCall of toolCalls) {
+		const calls = samplingCalls[toolCall.tool_call_id];
+		if (Array.isArray(calls) && calls.length > 0) toolCall.sampling_calls = calls;
+	}
+}
+function stepUsages(metadata) {
+	const steps = metadata?.steps;
+	if (!Array.isArray(steps)) return [];
+	return steps.map((step) => isRecord(step) && isRecord(step.usage) ? step.usage : void 0);
+}
+function sumUsage(usages) {
+	const total = {};
+	for (const usage of usages) {
+		if (usage.inputTokens != null) total.inputTokens = (total.inputTokens ?? 0) + usage.inputTokens;
+		if (usage.outputTokens != null) total.outputTokens = (total.outputTokens ?? 0) + usage.outputTokens;
+		if (usage.reasoningTokens != null) total.reasoningTokens = (total.reasoningTokens ?? 0) + usage.reasoningTokens;
+		if (usage.cachedInputTokens != null) total.cachedInputTokens = (total.cachedInputTokens ?? 0) + usage.cachedInputTokens;
+	}
+	return total;
+}
+/**
+* The usage a message reports: `metadata.usage` when the integration copied
+* the run total there, else the sum over `metadata.steps[].usage`.
+*/
+function messageUsage(metadata) {
+	const total = isRecord(metadata?.usage) ? normalizeRunTelemetryUsage(metadata.usage) : void 0;
+	if (total) return total;
+	const perStep = stepUsages(metadata).flatMap((usage) => {
+		const normalized = usage ? normalizeRunTelemetryUsage(usage) : void 0;
+		return normalized ? [normalized] : [];
+	});
+	return perStep.length > 0 ? sumUsage(perStep) : void 0;
+}
+/**
+* Reads the run report fields out of the assistant messages of one run. A run
+* the AI SDK streamed as one message is one element; a run the cloud stored as
+* several assistant rows is aggregated, step by step, in order. Returns null
+* when no assistant message is present. Status reads completed when the run
+* produced text or tool calls, as a live finish with reason `tool-calls` does;
+* an integration that observed the finish event overrides it.
+*/
+function extractAISDKRunTelemetry(messages) {
+	const textParts = [];
+	const toolCalls = [];
+	const steps = [];
+	const usages = [];
+	let assistant;
+	for (const message of messages) {
+		if (message.role !== "assistant") continue;
+		assistant = message;
+		const metadata = isRecord(message.metadata) ? message.metadata : void 0;
+		const usagePerStep = stepUsages(metadata);
+		const messageToolCalls = [];
+		let step;
+		let stepIndex = -1;
+		for (const part of message.parts) {
+			if (!isPart(part)) continue;
+			if (part.type === "step-start") {
+				stepIndex += 1;
+				const usage = usagePerStep[stepIndex];
+				step = usage ? { usage } : {};
+				steps.push(step);
+				continue;
+			}
+			if (part.type === "text" && typeof part.text === "string" && part.text) {
+				textParts.push(part.text);
+				continue;
+			}
+			const toolCall = toolCallOf(part);
+			if (!toolCall) continue;
+			toolCalls.push(toolCall);
+			messageToolCalls.push(toolCall);
+			if (step) {
+				step.toolCalls = [...step.toolCalls ?? [], toolCall];
+				step.finishReason = "tool-calls";
+			}
+		}
+		attachSamplingCalls(messageToolCalls, metadata);
+		const usage = messageUsage(metadata);
+		if (usage) usages.push(usage);
+	}
+	if (!assistant) return null;
+	const metadata = isRecord(assistant.metadata) ? assistant.metadata : void 0;
+	const usage = usages.length > 0 ? sumUsage(usages) : void 0;
+	const modelId = extractRunTelemetryModelId(metadata);
+	const completed = textParts.length > 0 || toolCalls.length > 0;
+	return {
+		...assistant.id !== void 0 ? { assistantMessageId: assistant.id } : void 0,
+		status: completed ? "completed" : "incomplete",
+		...toolCalls.length > 0 ? { toolCalls } : void 0,
+		...steps.length > 0 ? {
+			steps,
+			totalSteps: steps.length
+		} : void 0,
+		...textParts.length > 0 ? { outputText: truncateRunTelemetryText(textParts.join("")) } : void 0,
+		...usage ? { usage } : void 0,
+		...modelId ? { modelId } : void 0,
+		...metadata ? { metadata } : void 0
+	};
+}
+//#endregion
+export { aiSDKV6FormatAdapter, extractAISDKRunTelemetry };
+
+//# sourceMappingURL=index.js.map

package/dist/ai-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/ai-sdk/index.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\nimport type { MessageFormatAdapter } from \"../FormattedCloudPersistence\";\nimport type { SamplingCallData } from \"../instrumentMcpSampling\";\nimport {\n  type AssistantCloudRunReportToolCall,\n  createRunTelemetryToolCall,\n  extractRunTelemetryModelId,\n  normalizeRunTelemetryUsage,\n  type RunMessageTelemetry,\n  type RunReportStepInit,\n  type RunTelemetryUsage,\n  type RunTelemetryUsageInit,\n  truncateRunTelemetryText,\n} from \"../runTelemetry\";\n\nexport type AISDKStorageFormat = Omit<UIMessage, \"id\">;\n\n/** The stored form of an AI SDK message: the message without its id. */\nexport const aiSDKV6FormatAdapter: MessageFormatAdapter<\n  UIMessage,\n  AISDKStorageFormat\n> = {\n  format: \"ai-sdk/v6\",\n  encode: ({ message: { id: _id, ...message } }) => message,\n  decode: (stored) => ({\n    parentId: stored.parent_id,\n    message: { id: stored.id, ...stored.content } as UIMessage,\n  }),\n  getId: (message) => message.id,\n};\n\n/**\n * A message as an AI SDK integration holds it, or as the cloud stored it under\n * the ai-sdk/v6 format, which drops the id. Parts are typed by their `type`\n * alone, so this shape and the telemetry read from it need nothing from `ai`.\n */\nexport type AISDKMessageLike = {\n  id?: string | undefined;\n  role: string;\n  parts: readonly { type: string; [key: string]: unknown }[];\n  metadata?: unknown;\n};\n\ntype Part = Record<string, unknown> & { type: string };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\";\n}\n\nfunction isPart(value: unknown): value is Part {\n  return isRecord(value) && typeof value.type === \"string\";\n}\n\n/**\n * The AI SDK's own tool part rules, kept here so the entry loads without the\n * `ai` runtime: a static tool part is `tool-<name>`, a dynamic one is\n * `dynamic-tool` with its name in `toolName`.\n */\nfunction toolCallOf(part: Part): AssistantCloudRunReportToolCall | undefined {\n  if (typeof part.toolCallId !== \"string\") return undefined;\n  const isStatic = part.type.startsWith(\"tool-\");\n  if (!isStatic && part.type !== \"dynamic-tool\") return undefined;\n  const toolName = isStatic\n    ? part.type.slice(\"tool-\".length)\n    : typeof part.toolName === \"string\"\n      ? part.toolName\n      : undefined;\n  if (!toolName) return undefined;\n  return createRunTelemetryToolCall({\n    toolName,\n    toolCallId: part.toolCallId,\n    args: part.input ?? part.args,\n    result: part.output ?? part.result,\n    toolSource: isStatic ? \"frontend\" : \"mcp\",\n  });\n}\n\nfunction attachSamplingCalls(\n  toolCalls: readonly AssistantCloudRunReportToolCall[],\n  metadata: Record<string, unknown> | undefined,\n): void {\n  const samplingCalls = isRecord(metadata?.samplingCalls)\n    ? (metadata.samplingCalls as Record<string, SamplingCallData[]>)\n    : undefined;\n  if (!samplingCalls) return;\n  for (const toolCall of toolCalls) {\n    const calls = samplingCalls[toolCall.tool_call_id];\n    if (Array.isArray(calls) && calls.length > 0) {\n      toolCall.sampling_calls = calls;\n    }\n  }\n}\n\nfunction stepUsages(\n  metadata: Record<string, unknown> | undefined,\n): (RunTelemetryUsageInit | undefined)[] {\n  const steps = metadata?.steps;\n  if (!Array.isArray(steps)) return [];\n  return steps.map((step) =>\n    isRecord(step) && isRecord(step.usage)\n      ? (step.usage as RunTelemetryUsageInit)\n      : undefined,\n  );\n}\n\nfunction sumUsage(usages: readonly RunTelemetryUsage[]): RunTelemetryUsage {\n  const total: RunTelemetryUsage = {};\n  for (const usage of usages) {\n    if (usage.inputTokens != null) {\n      total.inputTokens = (total.inputTokens ?? 0) + usage.inputTokens;\n    }\n    if (usage.outputTokens != null) {\n      total.outputTokens = (total.outputTokens ?? 0) + usage.outputTokens;\n    }\n    if (usage.reasoningTokens != null) {\n      total.reasoningTokens =\n        (total.reasoningTokens ?? 0) + usage.reasoningTokens;\n    }\n    if (usage.cachedInputTokens != null) {\n      total.cachedInputTokens =\n        (total.cachedInputTokens ?? 0) + usage.cachedInputTokens;\n    }\n  }\n  return total;\n}\n\n/**\n * The usage a message reports: `metadata.usage` when the integration copied\n * the run total there, else the sum over `metadata.steps[].usage`.\n */\nfunction messageUsage(\n  metadata: Record<string, unknown> | undefined,\n): RunTelemetryUsage | undefined {\n  const total = isRecord(metadata?.usage)\n    ? normalizeRunTelemetryUsage(metadata.usage as RunTelemetryUsageInit)\n    : undefined;\n  if (total) return total;\n  const perStep = stepUsages(metadata).flatMap((usage) => {\n    const normalized = usage ? normalizeRunTelemetryUsage(usage) : undefined;\n    return normalized ? [normalized] : [];\n  });\n  return perStep.length > 0 ? sumUsage(perStep) : undefined;\n}\n\n/**\n * Reads the run report fields out of the assistant messages of one run. A run\n * the AI SDK streamed as one message is one element; a run the cloud stored as\n * several assistant rows is aggregated, step by step, in order. Returns null\n * when no assistant message is present. Status reads completed when the run\n * produced text or tool calls, as a live finish with reason `tool-calls` does;\n * an integration that observed the finish event overrides it.\n */\nexport function extractAISDKRunTelemetry(\n  messages: readonly AISDKMessageLike[],\n): RunMessageTelemetry | null {\n  const textParts: string[] = [];\n  const toolCalls: AssistantCloudRunReportToolCall[] = [];\n  const steps: RunReportStepInit[] = [];\n  const usages: RunTelemetryUsage[] = [];\n  let assistant: AISDKMessageLike | undefined;\n\n  for (const message of messages) {\n    if (message.role !== \"assistant\") continue;\n    assistant = message;\n    const metadata = isRecord(message.metadata) ? message.metadata : undefined;\n    const usagePerStep = stepUsages(metadata);\n    const messageToolCalls: AssistantCloudRunReportToolCall[] = [];\n    let step: RunReportStepInit | undefined;\n    let stepIndex = -1;\n\n    for (const part of message.parts) {\n      if (!isPart(part)) continue;\n      if (part.type === \"step-start\") {\n        stepIndex += 1;\n        const usage = usagePerStep[stepIndex];\n        step = usage ? { usage } : {};\n        steps.push(step);\n        continue;\n      }\n      if (part.type === \"text\" && typeof part.text === \"string\" && part.text) {\n        textParts.push(part.text);\n        continue;\n      }\n      const toolCall = toolCallOf(part);\n      if (!toolCall) continue;\n      toolCalls.push(toolCall);\n      messageToolCalls.push(toolCall);\n      if (step) {\n        step.toolCalls = [...(step.toolCalls ?? []), toolCall];\n        step.finishReason = \"tool-calls\";\n      }\n    }\n\n    attachSamplingCalls(messageToolCalls, metadata);\n    const usage = messageUsage(metadata);\n    if (usage) usages.push(usage);\n  }\n\n  if (!assistant) return null;\n\n  const metadata = isRecord(assistant.metadata)\n    ? assistant.metadata\n    : undefined;\n\n  const usage = usages.length > 0 ? sumUsage(usages) : undefined;\n  const modelId = extractRunTelemetryModelId(metadata);\n  const completed = textParts.length > 0 || toolCalls.length > 0;\n  return {\n    ...(assistant.id !== undefined\n      ? { assistantMessageId: assistant.id }\n      : undefined),\n    status: completed ? \"completed\" : \"incomplete\",\n    ...(toolCalls.length > 0 ? { toolCalls } : undefined),\n    ...(steps.length > 0 ? { steps, totalSteps: steps.length } : undefined),\n    ...(textParts.length > 0\n      ? { outputText: truncateRunTelemetryText(textParts.join(\"\")) }\n      : undefined),\n    ...(usage ? { usage } : undefined),\n    ...(modelId ? { modelId } : undefined),\n    ...(metadata ? { metadata } : undefined),\n  };\n}\n"],"mappings":"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"}

package/dist/cloudResponse.d.ts

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

package/dist/cloudResponse.d.ts.map

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

package/dist/cloudResponse.js

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

package/dist/cloudResponse.js.map

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

package/dist/generateThreadTitle.js

@@ -16,6 +16,7 @@ async function generateThreadTitle(cloud, options) {
 	} finally {
 		reader.releaseLock();
 	}
+	title = title.trim();
 	if (title) await cloud.threads.update(options.threadId, { title });
 	return title || null;
 }

package/dist/generateThreadTitle.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/instrumentMcpSampling.d.ts.map

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

package/dist/instrumentMcpSampling.js

@@ -1,4 +1,9 @@
 //#region src/instrumentMcpSampling.ts
+const reportSamplingError = (error) => {
+	try {
+		console.error("[assistant-cloud] onSamplingCall callback threw an error", error);
+	} catch {}
+};
 /**
 * Wraps an MCP sampling handler to intercept and measure sampling calls.
 *
@@ -27,14 +32,19 @@ function wrapSamplingHandler(handler, onSamplingCall) {
 		const outputTokens = response.usage?.outputTokens ?? response.usage?.completionTokens;
 		const reasoningTokens = response.usage?.reasoningTokens;
 		const cachedInputTokens = response.usage?.cachedInputTokens;
-		onSamplingCall({
+		const data = {
 			...modelId ? { model_id: modelId } : void 0,
 			...inputTokens != null ? { input_tokens: inputTokens } : void 0,
 			...outputTokens != null ? { output_tokens: outputTokens } : void 0,
 			...reasoningTokens != null ? { reasoning_tokens: reasoningTokens } : void 0,
 			...cachedInputTokens != null ? { cached_input_tokens: cachedInputTokens } : void 0,
 			duration_ms: durationMs
-		});
+		};
+		try {
+			Promise.resolve(onSamplingCall(data)).catch(reportSamplingError);
+		} catch (error) {
+			reportSamplingError(error);
+		}
 		return response;
 	};
 }

package/dist/instrumentMcpSampling.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentMcpSampling.js","names":[],"sources":["../src/instrumentMcpSampling.ts"],"sourcesContent":["/**\n * MCP sampling instrumentation utility.\n *\n * Wraps an MCP client's sampling handler to capture nested LLM calls\n * (sampling/createMessage requests) made during tool execution.\n * The captured data can be reported as child generation spans.\n */\n\nexport type SamplingCallData = {\n  model_id?: string;\n  input_tokens?: number;\n  output_tokens?: number;\n  reasoning_tokens?: number;\n  cached_input_tokens?: number;\n  duration_ms?: number;\n};\n\nexport type McpSamplingHandler = (\n  request: McpSamplingRequest,\n) => Promise<McpSamplingResponse>;\n\nexport type McpSamplingRequest = {\n  method: \"sampling/createMessage\";\n  params: {\n    messages: unknown[];\n    modelPreferences?: { hints?: { name?: string }[] };\n    maxTokens?: number;\n    [key: string]: unknown;\n  };\n};\n\nexport type McpSamplingResponse = {\n  model?: string;\n  content: unknown;\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    promptTokens?: number;\n    completionTokens?: number;\n    reasoningTokens?: number;\n    cachedInputTokens?: number;\n  };\n  [key: string]: unknown;\n};\n\n/**\n * Wraps an MCP sampling handler to intercept and measure sampling calls.\n *\n * @param handler - The original sampling handler from the MCP client\n * @param onSamplingCall - Callback invoked with metrics for each sampling call\n * @returns A wrapped handler that transparently captures sampling metrics\n *\n * @example\n * ```ts\n * const samplingCalls: SamplingCallData[] = [];\n * const wrapped = wrapSamplingHandler(\n *   originalHandler,\n *   (data) => samplingCalls.push(data),\n * );\n * // Use `wrapped` as the MCP client's sampling handler\n * // After tool execution, `samplingCalls` contains metrics for all nested LLM calls\n * ```\n */\nexport function wrapSamplingHandler(\n  handler: McpSamplingHandler,\n  onSamplingCall: (data: SamplingCallData) => void,\n): McpSamplingHandler {\n  return async (request) => {\n    const startTime = Date.now();\n    const response = await handler(request);\n    const durationMs = Date.now() - startTime;\n\n    const modelId =\n      response.model ?? request.params.modelPreferences?.hints?.[0]?.name;\n\n    const inputTokens =\n      response.usage?.inputTokens ?? response.usage?.promptTokens;\n    const outputTokens =\n      response.usage?.outputTokens ?? response.usage?.completionTokens;\n    const reasoningTokens = response.usage?.reasoningTokens;\n    const cachedInputTokens = response.usage?.cachedInputTokens;\n\n    onSamplingCall({\n      ...(modelId ? { model_id: modelId } : undefined),\n      ...(inputTokens != null ? { input_tokens: inputTokens } : undefined),\n      ...(outputTokens != null ? { output_tokens: outputTokens } : undefined),\n      ...(reasoningTokens != null\n        ? { reasoning_tokens: reasoningTokens }\n        : undefined),\n      ...(cachedInputTokens != null\n        ? { cached_input_tokens: cachedInputTokens }\n        : undefined),\n      duration_ms: durationMs,\n    });\n\n    return response;\n  };\n}\n\n/**\n * Creates a collector that accumulates sampling call data during tool execution.\n * Use with `wrapSamplingHandler` to capture all sampling calls for a tool invocation.\n *\n * @example\n * ```ts\n * const collector = createSamplingCollector();\n * const wrappedHandler = wrapSamplingHandler(handler, collector.collect);\n * // ... execute MCP tool ...\n * const calls = collector.getCalls(); // SamplingCallData[]\n * ```\n */\nexport function createSamplingCollector() {\n  const calls: SamplingCallData[] = [];\n  return {\n    collect: (data: SamplingCallData) => calls.push(data),\n    getCalls: () => [...calls],\n    reset: () => {\n      calls.length = 0;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,oBACd,SACA,gBACoB;CACpB,OAAO,OAAO,YAAY;EACxB,MAAM,YAAY,KAAK,IAAI;EAC3B,MAAM,WAAW,MAAM,QAAQ,OAAO;EACtC,MAAM,aAAa,KAAK,IAAI,IAAI;EAEhC,MAAM,UACJ,SAAS,SAAS,QAAQ,OAAO,kBAAkB,QAAQ,EAAE,EAAE;EAEjE,MAAM,cACJ,SAAS,OAAO,eAAe,SAAS,OAAO;EACjD,MAAM,eACJ,SAAS,OAAO,gBAAgB,SAAS,OAAO;EAClD,MAAM,kBAAkB,SAAS,OAAO;EACxC,MAAM,oBAAoB,SAAS,OAAO;EAE1C,eAAe;GACb,GAAI,UAAU,EAAE,UAAU,QAAQ,IAAI,KAAA;GACtC,GAAI,eAAe,OAAO,EAAE,cAAc,YAAY,IAAI,KAAA;GAC1D,GAAI,gBAAgB,OAAO,EAAE,eAAe,aAAa,IAAI,KAAA;GAC7D,GAAI,mBAAmB,OACnB,EAAE,kBAAkB,gBAAgB,IACpC,KAAA;GACJ,GAAI,qBAAqB,OACrB,EAAE,qBAAqB,kBAAkB,IACzC,KAAA;GACJ,aAAa;EACf,CAAC;EAED,OAAO;CACT;AACF;;;;;;;;;;;;;AAcA,SAAgB,0BAA0B;CACxC,MAAM,QAA4B,CAAC;CACnC,OAAO;EACL,UAAU,SAA2B,MAAM,KAAK,IAAI;EACpD,gBAAgB,CAAC,GAAG,KAAK;EACzB,aAAa;GACX,MAAM,SAAS;EACjB;CACF;AACF"}
+{"version":3,"file":"instrumentMcpSampling.js","names":[],"sources":["../src/instrumentMcpSampling.ts"],"sourcesContent":["/**\n * MCP sampling instrumentation utility.\n *\n * Wraps an MCP client's sampling handler to capture nested LLM calls\n * (sampling/createMessage requests) made during tool execution.\n * The captured data can be reported as child generation spans.\n */\n\nexport type SamplingCallData = {\n  model_id?: string;\n  input_tokens?: number;\n  output_tokens?: number;\n  reasoning_tokens?: number;\n  cached_input_tokens?: number;\n  duration_ms?: number;\n};\n\nexport type McpSamplingHandler = (\n  request: McpSamplingRequest,\n) => Promise<McpSamplingResponse>;\n\nexport type McpSamplingRequest = {\n  method: \"sampling/createMessage\";\n  params: {\n    messages: unknown[];\n    modelPreferences?: { hints?: { name?: string }[] };\n    maxTokens?: number;\n    [key: string]: unknown;\n  };\n};\n\nexport type McpSamplingResponse = {\n  model?: string;\n  content: unknown;\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    promptTokens?: number;\n    completionTokens?: number;\n    reasoningTokens?: number;\n    cachedInputTokens?: number;\n  };\n  [key: string]: unknown;\n};\n\nconst reportSamplingError = (error: unknown): void => {\n  try {\n    console.error(\n      \"[assistant-cloud] onSamplingCall callback threw an error\",\n      error,\n    );\n  } catch {}\n};\n\n/**\n * Wraps an MCP sampling handler to intercept and measure sampling calls.\n *\n * @param handler - The original sampling handler from the MCP client\n * @param onSamplingCall - Callback invoked with metrics for each sampling call\n * @returns A wrapped handler that transparently captures sampling metrics\n *\n * @example\n * ```ts\n * const samplingCalls: SamplingCallData[] = [];\n * const wrapped = wrapSamplingHandler(\n *   originalHandler,\n *   (data) => samplingCalls.push(data),\n * );\n * // Use `wrapped` as the MCP client's sampling handler\n * // After tool execution, `samplingCalls` contains metrics for all nested LLM calls\n * ```\n */\nexport function wrapSamplingHandler(\n  handler: McpSamplingHandler,\n  onSamplingCall: (data: SamplingCallData) => void,\n): McpSamplingHandler {\n  return async (request) => {\n    const startTime = Date.now();\n    const response = await handler(request);\n    const durationMs = Date.now() - startTime;\n\n    const modelId =\n      response.model ?? request.params.modelPreferences?.hints?.[0]?.name;\n\n    const inputTokens =\n      response.usage?.inputTokens ?? response.usage?.promptTokens;\n    const outputTokens =\n      response.usage?.outputTokens ?? response.usage?.completionTokens;\n    const reasoningTokens = response.usage?.reasoningTokens;\n    const cachedInputTokens = response.usage?.cachedInputTokens;\n\n    const data: SamplingCallData = {\n      ...(modelId ? { model_id: modelId } : undefined),\n      ...(inputTokens != null ? { input_tokens: inputTokens } : undefined),\n      ...(outputTokens != null ? { output_tokens: outputTokens } : undefined),\n      ...(reasoningTokens != null\n        ? { reasoning_tokens: reasoningTokens }\n        : undefined),\n      ...(cachedInputTokens != null\n        ? { cached_input_tokens: cachedInputTokens }\n        : undefined),\n      duration_ms: durationMs,\n    };\n    try {\n      void Promise.resolve(onSamplingCall(data)).catch(reportSamplingError);\n    } catch (error) {\n      reportSamplingError(error);\n    }\n\n    return response;\n  };\n}\n\n/**\n * Creates a collector that accumulates sampling call data during tool execution.\n * Use with `wrapSamplingHandler` to capture all sampling calls for a tool invocation.\n *\n * @example\n * ```ts\n * const collector = createSamplingCollector();\n * const wrappedHandler = wrapSamplingHandler(handler, collector.collect);\n * // ... execute MCP tool ...\n * const calls = collector.getCalls(); // SamplingCallData[]\n * ```\n */\nexport function createSamplingCollector() {\n  const calls: SamplingCallData[] = [];\n  return {\n    collect: (data: SamplingCallData) => calls.push(data),\n    getCalls: () => [...calls],\n    reset: () => {\n      calls.length = 0;\n    },\n  };\n}\n"],"mappings":";AA6CA,MAAM,uBAAuB,UAAyB;CACpD,IAAI;EACF,QAAQ,MACN,4DACA,KACF;CACF,QAAQ,CAAC;AACX;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,oBACd,SACA,gBACoB;CACpB,OAAO,OAAO,YAAY;EACxB,MAAM,YAAY,KAAK,IAAI;EAC3B,MAAM,WAAW,MAAM,QAAQ,OAAO;EACtC,MAAM,aAAa,KAAK,IAAI,IAAI;EAEhC,MAAM,UACJ,SAAS,SAAS,QAAQ,OAAO,kBAAkB,QAAQ,EAAE,EAAE;EAEjE,MAAM,cACJ,SAAS,OAAO,eAAe,SAAS,OAAO;EACjD,MAAM,eACJ,SAAS,OAAO,gBAAgB,SAAS,OAAO;EAClD,MAAM,kBAAkB,SAAS,OAAO;EACxC,MAAM,oBAAoB,SAAS,OAAO;EAE1C,MAAM,OAAyB;GAC7B,GAAI,UAAU,EAAE,UAAU,QAAQ,IAAI,KAAA;GACtC,GAAI,eAAe,OAAO,EAAE,cAAc,YAAY,IAAI,KAAA;GAC1D,GAAI,gBAAgB,OAAO,EAAE,eAAe,aAAa,IAAI,KAAA;GAC7D,GAAI,mBAAmB,OACnB,EAAE,kBAAkB,gBAAgB,IACpC,KAAA;GACJ,GAAI,qBAAqB,OACrB,EAAE,qBAAqB,kBAAkB,IACzC,KAAA;GACJ,aAAa;EACf;EACA,IAAI;GACF,QAAa,QAAQ,eAAe,IAAI,CAAC,CAAC,CAAC,MAAM,mBAAmB;EACtE,SAAS,OAAO;GACd,oBAAoB,KAAK;EAC3B;EAEA,OAAO;CACT;AACF;;;;;;;;;;;;;AAcA,SAAgB,0BAA0B;CACxC,MAAM,QAA4B,CAAC;CACnC,OAAO;EACL,UAAU,SAA2B,MAAM,KAAK,IAAI;EACpD,gBAAgB,CAAC,GAAG,KAAK;EACzB,aAAa;GACX,MAAM,SAAS;EACjB;CACF;AACF"}

package/dist/runTelemetry.d.ts

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

package/dist/runTelemetry.d.ts.map

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