@copilotkit/runtime 1.80.0 → 1.82.0

package/dist/v2/runtime/intelligence-platform/learning-management.mjs

@@ -0,0 +1,194 @@
+import "reflect-metadata";
+import { z } from "zod";
+
+//#region src/v2/runtime/intelligence-platform/learning-management.ts
+/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */
+const learningContainerIdSchema = z.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+const learningContainerSchema = z.object({
+	id: learningContainerIdSchema,
+	name: z.string().min(1),
+	projectId: z.number().int().positive(),
+	promptContext: z.string().nullable(),
+	createdAt: z.string().datetime({ offset: true }),
+	updatedAt: z.string().datetime({ offset: true })
+});
+const learningContainerPageSchema = z.object({
+	containers: z.array(learningContainerSchema).max(500),
+	nextCursor: z.string().min(1).nullable()
+});
+/** Validates a stable identifier before constructing a request path. */
+function learningContainerPath(containerId) {
+	return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;
+}
+/** Reads a bounded JSON response while the request's signal governs stream cancellation. */
+async function readLearningJson(response, limit = 16 * 1024 * 1024, signal) {
+	if (!response.body) throw new Error("Missing Learning response body");
+	const reader = response.body.getReader();
+	const abort = () => {
+		reader.cancel(signal?.reason).catch(() => void 0);
+	};
+	signal?.addEventListener("abort", abort, { once: true });
+	if (signal?.aborted) abort();
+	const decoder = new TextDecoder();
+	let text = "";
+	let bytes = 0;
+	try {
+		while (true) {
+			signal?.throwIfAborted();
+			const next = await reader.read();
+			signal?.throwIfAborted();
+			if (next.done) break;
+			bytes += next.value.byteLength;
+			if (bytes > limit) {
+				await reader.cancel();
+				throw new Error("Learning response exceeds its size limit");
+			}
+			text += decoder.decode(next.value, { stream: true });
+		}
+		return JSON.parse(text + decoder.decode());
+	} finally {
+		signal?.removeEventListener("abort", abort);
+		reader.releaseLock();
+	}
+}
+const learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);
+const learningUuidSchema = z.string().uuid();
+const learningDateTimeSchema = z.string().datetime({ offset: true });
+/** One immutable file in a proposed Skill candidate bundle. */
+const learningSkillBundleFileSchema = z.object({
+	content: z.string(),
+	path: z.string().min(1).refine((path) => !path.startsWith("/") && !path.split("/").some((segment) => segment === ".."), "Bundle paths must be relative and may not traverse parent directories."),
+	sha256: learningSha256Schema
+});
+/** Complete Skill files attached to one review candidate. */
+const learningSkillBundleSchema = z.object({
+	files: z.array(learningSkillBundleFileSchema).min(1),
+	schemaVersion: z.literal(1)
+}).superRefine(({ files }, context) => {
+	const paths = /* @__PURE__ */ new Set();
+	for (const file of files) {
+		if (paths.has(file.path)) context.addIssue({
+			code: "custom",
+			message: `Duplicate bundle path: ${file.path}`,
+			path: ["files"]
+		});
+		paths.add(file.path);
+	}
+	if (!paths.has("SKILL.md")) context.addIssue({
+		code: "custom",
+		message: "A Skill bundle must contain SKILL.md.",
+		path: ["files"]
+	});
+});
+/** Review state and summary returned for one proposed Skill change. */
+const learningCandidateSchema = z.object({
+	bundleSha256: learningSha256Schema,
+	createdAt: learningDateTimeSchema,
+	description: z.string().min(1),
+	id: learningUuidSchema,
+	operation: z.enum([
+		"add",
+		"update",
+		"remove"
+	]),
+	publishedRegistryRevision: z.number().int().positive().nullable(),
+	publishedSkillId: learningUuidSchema.nullable(),
+	reason: z.string().min(1),
+	registryBaseRevision: z.number().int().nonnegative(),
+	reviewedAt: learningDateTimeSchema.nullable(),
+	runId: learningUuidSchema,
+	status: z.enum([
+		"pending_review",
+		"approved",
+		"rejected"
+	]),
+	subjectSha256: learningSha256Schema,
+	targetSkillId: learningUuidSchema.nullable(),
+	targetSkillRevision: z.number().int().positive().nullable(),
+	title: z.string().min(1)
+});
+/** Full proposed Skill change, including evidence and every bundle file. */
+const learningCandidateDetailSchema = learningCandidateSchema.extend({
+	bundle: learningSkillBundleSchema,
+	supportingInsights: z.array(z.object({
+		alias: z.string().min(1),
+		id: learningUuidSchema,
+		impact: z.string().min(1),
+		statement: z.string().min(1)
+	}))
+});
+/** Result returned after a human or agent reviews a Skill candidate. */
+const learningCandidateReviewSchema = z.object({
+	candidateId: learningUuidSchema,
+	operation: z.enum([
+		"add",
+		"update",
+		"remove"
+	]),
+	publishedRegistryRevision: z.number().int().positive().nullable(),
+	publishedSkillId: learningUuidSchema.nullable(),
+	status: z.enum(["approved", "rejected"])
+});
+const learningRunSchema = z.object({
+	id: z.string().uuid(),
+	learningContainerId: learningContainerIdSchema,
+	projectId: z.number().int().positive(),
+	status: z.enum([
+		"queued",
+		"freezing",
+		"batching",
+		"reducing",
+		"finalizing",
+		"succeeded",
+		"failed"
+	]),
+	triggerSource: z.enum(["automatic", "manual"]),
+	attemptCount: z.number().int().nonnegative(),
+	candidateCount: z.number().int().nonnegative().nullable(),
+	insightCount: z.number().int().nonnegative().nullable(),
+	evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),
+	createdAt: learningDateTimeSchema,
+	updatedAt: learningDateTimeSchema,
+	startedAt: learningDateTimeSchema.nullable(),
+	completedAt: learningDateTimeSchema.nullable(),
+	failureCode: z.string().nullable(),
+	kubernetesJobName: z.string().nullable()
+});
+const unavailableSchema = z.enum(["snapshot-missing", "snapshot-unreadable"]).nullable();
+const learningInsightEvidenceSchema = z.union([z.object({
+	cited: z.array(z.object({
+		id: z.string(),
+		content: z.string(),
+		role: z.enum([
+			"assistant",
+			"tool",
+			"user"
+		])
+	})),
+	messageCount: z.number().int().nonnegative(),
+	threadId: z.string(),
+	threadName: z.string().nullable(),
+	threadPresent: z.boolean(),
+	unavailable: unavailableSchema
+}), z.object({
+	kind: z.literal("trajectory"),
+	trajectoryId: z.string().uuid(),
+	trajectoryPresent: z.boolean(),
+	eventCount: z.number().int().nonnegative(),
+	events: z.array(z.object({
+		seq: z.number().int().nonnegative(),
+		name: z.string(),
+		offsetMs: z.number(),
+		value: z.unknown(),
+		eventId: z.string().nullable()
+	})),
+	unavailable: unavailableSchema
+})]);
+/** Validates object IDs independently from container IDs; neither may alter the path. */
+function learningObjectId(id) {
+	return z.string().uuid().parse(id);
+}
+
+//#endregion
+export { learningCandidateDetailSchema, learningCandidateReviewSchema, learningCandidateSchema, learningContainerPageSchema, learningContainerPath, learningContainerSchema, learningInsightEvidenceSchema, learningObjectId, learningRunSchema, readLearningJson };
+//# sourceMappingURL=learning-management.mjs.map

package/dist/v2/runtime/intelligence-platform/learning-management.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.mjs","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/learning-management.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */\nexport const learningContainerIdSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nexport const learningContainerSchema = z.object({\n  id: learningContainerIdSchema,\n  name: z.string().min(1),\n  projectId: z.number().int().positive(),\n  promptContext: z.string().nullable(),\n  createdAt: z.string().datetime({ offset: true }),\n  updatedAt: z.string().datetime({ offset: true }),\n});\nexport const learningContainerPageSchema = z.object({\n  containers: z.array(learningContainerSchema).max(500),\n  nextCursor: z.string().min(1).nullable(),\n});\n/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */\nexport interface LearningContainer {\n  id: string;\n  name: string;\n  projectId: number;\n  promptContext: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\nexport interface LearningContainerPage {\n  containers: LearningContainer[];\n  nextCursor: string | null;\n}\nexport interface LearningRequestOptions {\n  readonly signal?: AbortSignal;\n}\nexport interface LearningContainerRequest extends LearningRequestOptions {\n  readonly containerId: string;\n}\n\n/** Validates a stable identifier before constructing a request path. */\nexport function learningContainerPath(containerId: string): string {\n  return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;\n}\n\n/** Reads a bounded JSON response while the request's signal governs stream cancellation. */\nexport async function readLearningJson(\n  response: Response,\n  limit = 16 * 1024 * 1024,\n  signal?: AbortSignal,\n): Promise<unknown> {\n  if (!response.body) throw new Error(\"Missing Learning response body\");\n  const reader = response.body.getReader();\n  const abort = () => {\n    void reader.cancel(signal?.reason).catch(() => undefined);\n  };\n  signal?.addEventListener(\"abort\", abort, { once: true });\n  if (signal?.aborted) abort();\n  const decoder = new TextDecoder();\n  let text = \"\";\n  let bytes = 0;\n  try {\n    while (true) {\n      signal?.throwIfAborted();\n      const next = await reader.read();\n      signal?.throwIfAborted();\n      if (next.done) break;\n      bytes += next.value.byteLength;\n      if (bytes > limit) {\n        await reader.cancel();\n        throw new Error(\"Learning response exceeds its size limit\");\n      }\n      text += decoder.decode(next.value, { stream: true });\n    }\n    return JSON.parse(text + decoder.decode());\n  } finally {\n    signal?.removeEventListener(\"abort\", abort);\n    reader.releaseLock();\n  }\n}\n\nconst learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\nconst learningUuidSchema = z.string().uuid();\nconst learningDateTimeSchema = z.string().datetime({ offset: true });\n\n/** One immutable file in a proposed Skill candidate bundle. */\nexport const learningSkillBundleFileSchema = z.object({\n  content: z.string(),\n  path: z\n    .string()\n    .min(1)\n    .refine(\n      (path) =>\n        !path.startsWith(\"/\") &&\n        !path.split(\"/\").some((segment) => segment === \"..\"),\n      \"Bundle paths must be relative and may not traverse parent directories.\",\n    ),\n  sha256: learningSha256Schema,\n});\n\n/** Complete Skill files attached to one review candidate. */\nexport const learningSkillBundleSchema = z\n  .object({\n    files: z.array(learningSkillBundleFileSchema).min(1),\n    schemaVersion: z.literal(1),\n  })\n\n  .superRefine(({ files }, context) => {\n    const paths = new Set<string>();\n    for (const file of files) {\n      if (paths.has(file.path)) {\n        context.addIssue({\n          code: \"custom\",\n          message: `Duplicate bundle path: ${file.path}`,\n          path: [\"files\"],\n        });\n      }\n      paths.add(file.path);\n    }\n    if (!paths.has(\"SKILL.md\")) {\n      context.addIssue({\n        code: \"custom\",\n        message: \"A Skill bundle must contain SKILL.md.\",\n        path: [\"files\"],\n      });\n    }\n  });\n\n/** Review state and summary returned for one proposed Skill change. */\nexport const learningCandidateSchema = z.object({\n  bundleSha256: learningSha256Schema,\n  createdAt: learningDateTimeSchema,\n  description: z.string().min(1),\n  id: learningUuidSchema,\n  operation: z.enum([\"add\", \"update\", \"remove\"]),\n  publishedRegistryRevision: z.number().int().positive().nullable(),\n  publishedSkillId: learningUuidSchema.nullable(),\n  reason: z.string().min(1),\n  registryBaseRevision: z.number().int().nonnegative(),\n  reviewedAt: learningDateTimeSchema.nullable(),\n  runId: learningUuidSchema,\n  status: z.enum([\"pending_review\", \"approved\", \"rejected\"]),\n  subjectSha256: learningSha256Schema,\n  targetSkillId: learningUuidSchema.nullable(),\n  targetSkillRevision: z.number().int().positive().nullable(),\n  title: z.string().min(1),\n});\n\n/** Full proposed Skill change, including evidence and every bundle file. */\nexport const learningCandidateDetailSchema = learningCandidateSchema.extend({\n  bundle: learningSkillBundleSchema,\n  supportingInsights: z.array(\n    z.object({\n      alias: z.string().min(1),\n      id: learningUuidSchema,\n      impact: z.string().min(1),\n      statement: z.string().min(1),\n    }),\n  ),\n});\n\n/** Result returned after a human or agent reviews a Skill candidate. */\nexport const learningCandidateReviewSchema = z.object({\n  candidateId: learningUuidSchema,\n  operation: z.enum([\"add\", \"update\", \"remove\"]),\n  publishedRegistryRevision: z.number().int().positive().nullable(),\n  publishedSkillId: learningUuidSchema.nullable(),\n  status: z.enum([\"approved\", \"rejected\"]),\n});\n\nexport interface LearningCandidate {\n  id: string;\n  bundleSha256: string;\n  createdAt: string;\n  description: string;\n  operation: \"add\" | \"update\" | \"remove\";\n  publishedRegistryRevision: number | null;\n  publishedSkillId: string | null;\n  reason: string;\n  registryBaseRevision: number;\n  reviewedAt: string | null;\n  runId: string;\n  status: \"pending_review\" | \"approved\" | \"rejected\";\n  subjectSha256: string;\n  targetSkillId: string | null;\n  targetSkillRevision: number | null;\n  title: string;\n}\nexport interface LearningCandidateDetail extends LearningCandidate {\n  bundle: {\n    schemaVersion: 1;\n    files: Array<{ path: string; content: string; sha256: string }>;\n  };\n  supportingInsights: Array<{\n    alias: string;\n    id: string;\n    impact: string;\n    statement: string;\n  }>;\n}\nexport interface LearningCandidateReview {\n  candidateId: string;\n  operation: \"add\" | \"update\" | \"remove\";\n  publishedRegistryRevision: number | null;\n  publishedSkillId: string | null;\n  status: \"approved\" | \"rejected\";\n}\nexport interface LearningCandidateRequest extends LearningContainerRequest {\n  readonly candidateId: string;\n}\n\nexport const learningRunSchema = z.object({\n  id: z.string().uuid(),\n  learningContainerId: learningContainerIdSchema,\n  projectId: z.number().int().positive(),\n  status: z.enum([\n    \"queued\",\n    \"freezing\",\n    \"batching\",\n    \"reducing\",\n    \"finalizing\",\n    \"succeeded\",\n    \"failed\",\n  ]),\n  triggerSource: z.enum([\"automatic\", \"manual\"]),\n  attemptCount: z.number().int().nonnegative(),\n  candidateCount: z.number().int().nonnegative().nullable(),\n  insightCount: z.number().int().nonnegative().nullable(),\n  evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),\n  createdAt: learningDateTimeSchema,\n  updatedAt: learningDateTimeSchema,\n  startedAt: learningDateTimeSchema.nullable(),\n  completedAt: learningDateTimeSchema.nullable(),\n  failureCode: z.string().nullable(),\n  kubernetesJobName: z.string().nullable(),\n});\nexport interface LearningRun {\n  id: string;\n  learningContainerId: string;\n  projectId: number;\n  status:\n    | \"queued\"\n    | \"freezing\"\n    | \"batching\"\n    | \"reducing\"\n    | \"finalizing\"\n    | \"succeeded\"\n    | \"failed\";\n  triggerSource: \"automatic\" | \"manual\";\n  attemptCount: number;\n  candidateCount: number | null;\n  insightCount: number | null;\n  evidenceThreadCount?: number | null;\n  createdAt: string;\n  updatedAt: string;\n  startedAt: string | null;\n  completedAt: string | null;\n  failureCode: string | null;\n  kubernetesJobName: string | null;\n}\nconst unavailableSchema = z\n  .enum([\"snapshot-missing\", \"snapshot-unreadable\"])\n  .nullable();\nexport const learningInsightEvidenceSchema = z.union([\n  z.object({\n    cited: z.array(\n      z.object({\n        id: z.string(),\n        content: z.string(),\n        role: z.enum([\"assistant\", \"tool\", \"user\"]),\n      }),\n    ),\n    messageCount: z.number().int().nonnegative(),\n    threadId: z.string(),\n    threadName: z.string().nullable(),\n    threadPresent: z.boolean(),\n    unavailable: unavailableSchema,\n  }),\n  z.object({\n    kind: z.literal(\"trajectory\"),\n    trajectoryId: z.string().uuid(),\n    trajectoryPresent: z.boolean(),\n    eventCount: z.number().int().nonnegative(),\n    events: z.array(\n      z.object({\n        seq: z.number().int().nonnegative(),\n        name: z.string(),\n        offsetMs: z.number(),\n        value: z.unknown(),\n        eventId: z.string().nullable(),\n      }),\n    ),\n    unavailable: unavailableSchema,\n  }),\n]);\nexport type LearningInsightEvidence =\n  | {\n      cited: Array<{\n        id: string;\n        content: string;\n        role: \"assistant\" | \"tool\" | \"user\";\n      }>;\n      messageCount: number;\n      threadId: string;\n      threadName: string | null;\n      threadPresent: boolean;\n      unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n    }\n  | {\n      kind: \"trajectory\";\n      trajectoryId: string;\n      trajectoryPresent: boolean;\n      eventCount: number;\n      events: Array<{\n        seq: number;\n        name: string;\n        offsetMs: number;\n        value?: unknown;\n        eventId: string | null;\n      }>;\n      unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n    };\n\n/** Validates object IDs independently from container IDs; neither may alter the path. */\nexport function learningObjectId(id: string): string {\n  return z.string().uuid().parse(id);\n}\n"],"mappings":"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"}

package/dist/v2/runtime/telemetry/telemetry-client.cjs

@@ -59,7 +59,7 @@ var TelemetryClient = class {
 		});
 	}
 	async captureWithIdentity(event, properties, identity) {
-		if (this.telemetryDisabled) return;
+		if (this.telemetryDisabled || isTelemetryDisabled()) return;
 		if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;
 		await _copilotkit_shared.lambdaClient.send({
 			event,

package/dist/v2/runtime/telemetry/telemetry-client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.cjs","names":["lambdaClient","TELEMETRY_EMITTER_V2","TELEMETRY_SURFACE_V2","RUNTIME_PACKAGE_NAME","RUNTIME_PACKAGE_VERSION"],"sources":["../../../../src/v2/runtime/telemetry/telemetry-client.ts"],"sourcesContent":["import type { AnalyticsEvents } from \"./events\";\nimport {\n  lambdaClient,\n  parseAndWarnTelemetryId,\n  computeSamplingMeta,\n  TELEMETRY_EMITTER_V2,\n  TELEMETRY_SURFACE_V2,\n} from \"@copilotkit/shared\";\nimport {\n  RUNTIME_PACKAGE_NAME,\n  RUNTIME_PACKAGE_VERSION,\n} from \"../core/package-info\";\nimport { firstNonBlankTelemetryId } from \"./telemetry-identity\";\n\n/** Transport identity and sampling authority resolved for one runtime. */\nexport interface TelemetryIdentity {\n  telemetryId?: string;\n  licenseToken?: string;\n}\n\n/** Capture-only telemetry client bound to one runtime identity. */\nexport interface TelemetryCapture {\n  capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void>;\n}\n\ninterface ResolvedTelemetryIdentity {\n  telemetryId: string | null;\n  licenseToken: string | null;\n  licenseTelemetryId: string | null;\n}\n\nexport function isTelemetryDisabled(): boolean {\n  return (\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"true\" ||\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"1\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===\n      \"true\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === \"1\"\n  );\n}\n\nexport class TelemetryClient {\n  private telemetryDisabled: boolean = false;\n  // Opt-down for anonymous events, defaulting to 1: the sink is ours, so a\n  // real count beats one extrapolated from a fraction of the population.\n  // It stays configurable because it is the cross-SDK lever for reducing or\n  // stopping anonymous volume — the Go, Python, Ruby, and .NET runtimes all\n  // expose it, and the cross-language conformance suite drives it to 0 to\n  // assert silence. Identified callers bypass it.\n  private sampleRate: number = 1;\n  // EIP / Intelligence license token (Ed25519-signed JWT). Kept separate\n  // from standalone identity so the transport receives only the selected\n  // identity source.\n  private licenseToken: string | null = null;\n  // Standalone identity sent as a transport claim. It does not make an\n  // event identified.\n  private telemetryId: string | null = null;\n  // License-derived identity. This client sends every event either way;\n  // the id is what sets telemetry_identified on the sampling block, which\n  // is how the two populations stay separable downstream.\n  private licenseTelemetryId: string | null = null;\n  // Properties merged into every event this client sends.\n  //\n  // For facts about the caller that are true for the whole process rather than\n  // for one event: which product is embedding the runtime, for instance. A\n  // distribution built on top of this can then be told apart in the existing\n  // events instead of sending its own, which is the difference between one\n  // extra field and a second pipeline nobody asked for.\n  //\n  // Sent as `global_properties`, a field of its own, so these stay separable\n  // from an event's own properties all the way to the sink.\n  //\n  // Do not reuse a key an event already sets: the fanout spreads this bag last\n  // for `oss.runtime.*`, so a collision resolves in favour of the global and\n  // does so silently. Names here should describe the caller, not the call.\n  private globalProperties: Record<string, unknown> = {};\n\n  constructor({\n    telemetryDisabled,\n    sampleRate,\n  }: {\n    telemetryDisabled?: boolean;\n    sampleRate?: number;\n  } = {}) {\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n    this.setSampleRate(sampleRate);\n  }\n\n  private shouldSendEvent() {\n    if (this.sampleRate >= 1) return true;\n    return Math.random() < this.sampleRate;\n  }\n\n  /**\n   * Add properties carried by every subsequent event.\n   *\n   * Merged rather than replaced, so two callers setting different fields do not\n   * erase each other. Set once at runtime construction in practice; nothing\n   * here is per-request.\n   */\n  setGlobalProperties(properties: Record<string, unknown>) {\n    this.globalProperties = { ...this.globalProperties, ...properties };\n  }\n\n  /** Atomically replace the process-wide telemetry identity. */\n  setTelemetryIdentity(identity: TelemetryIdentity): void {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    this.telemetryId = resolvedIdentity.telemetryId;\n    this.licenseToken = resolvedIdentity.licenseToken;\n    this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;\n  }\n\n  /** @deprecated Prefer {@link setTelemetryIdentity}. */\n  setLicenseToken(licenseToken: string): void {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /** Create an immutable capture scope for one Runtime instance. */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    return {\n      capture: <K extends keyof AnalyticsEvents>(\n        event: K,\n        properties: AnalyticsEvents[K],\n      ) => this.captureWithIdentity(event, properties, resolvedIdentity),\n    };\n  }\n\n  async capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void> {\n    return this.captureWithIdentity(event, properties, {\n      telemetryId: this.telemetryId,\n      licenseToken: this.licenseToken,\n      licenseTelemetryId: this.licenseTelemetryId,\n    });\n  }\n\n  private async captureWithIdentity<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n    identity: ResolvedTelemetryIdentity,\n  ): Promise<void> {\n    if (this.telemetryDisabled) return;\n    // Nothing is gated at the default rate of 1. A caller who dialled it\n    // down means it, and identified callers are exempt either way.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;\n\n    await lambdaClient.send({\n      event,\n      properties: properties as Record<string, unknown>,\n      // Its own field on the wire rather than folded into `properties`, which\n      // is what the sink expects: for `oss.runtime.*` the fanout treats\n      // `global_properties` as the SDK's pass-through bag and spreads it into\n      // the analytics event, and v1's client sends package name and version the\n      // same way. Folding it in would work and would put a process-level fact\n      // in the per-event slot, where nothing downstream expects to find one.\n      // Sampling metadata rides in the same slot, as it does in v1. It\n      // reads 1/1 unless a caller dialled the rate down, and is stamped\n      // either way: a consumer summing sampleWeight across emitters must\n      // not find the field missing on a quarter of the rows, which is the\n      // state that made ~24% of runtime volume unweightable (OSS-1017).\n      globalProperties: {\n        ...this.globalProperties,\n        ...computeSamplingMeta({\n          telemetryId: identity.licenseTelemetryId,\n          sampleRate: this.sampleRate,\n        }),\n        telemetry_emitter: TELEMETRY_EMITTER_V2,\n        // Constant here: a v1 request never reaches this client. The v1\n        // entrypoint hands its own capture scope to the V2 runtime it\n        // builds, so v1 traffic is emitted by the v1 client and stamped\n        // v1 there — which is also what keeps it on the Segment wire.\n        telemetry_surface: TELEMETRY_SURFACE_V2,\n        // This client has one transport, so the marker is constant here. It\n        // is stamped anyway so the property means the same thing on every\n        // event whichever client produced it (OSS-1019).\n        telemetry_transport: \"lambda\",\n      },\n      packageName: RUNTIME_PACKAGE_NAME,\n      packageVersion: RUNTIME_PACKAGE_VERSION,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n  }\n\n  private resolveTelemetryIdentity(\n    identity: TelemetryIdentity,\n  ): ResolvedTelemetryIdentity {\n    const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);\n    if (telemetryId !== undefined) {\n      return {\n        telemetryId,\n        licenseToken: null,\n        licenseTelemetryId: null,\n      };\n    }\n\n    return {\n      telemetryId: null,\n      licenseToken: identity.licenseToken ?? null,\n      licenseTelemetryId: identity.licenseToken\n        ? parseAndWarnTelemetryId(identity.licenseToken)\n        : null,\n    };\n  }\n\n  private setSampleRate(sampleRate: number | undefined) {\n    let _sampleRate: number;\n\n    _sampleRate = sampleRate ?? 1;\n\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);\n    }\n\n    // Number.isNaN guards against parseFloat(\"nonsense\") slipping past the\n    // range check (all NaN comparisons are false), which would silently\n    // drop every anonymous event with no signal.\n    if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) {\n      throw new Error(\"Sample rate must be between 0 and 1\");\n    }\n\n    this.sampleRate = _sampleRate;\n  }\n}\n\nconst telemetry = new TelemetryClient();\nexport default telemetry;\n"],"mappings":";;;;;;AAkCA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB;;AAIzE,IAAa,kBAAb,MAA6B;CAoC3B,YAAY,EACV,mBACA,eAIE,EAAE,EAAE;2BAzC6B;oBAOR;sBAIS;qBAGD;4BAIO;0BAeQ,EAAE;AASpD,OAAK,oBAAoB,qBAAqB,qBAAqB;AACnE,OAAK,cAAc,WAAW;;CAGhC,AAAQ,kBAAkB;AACxB,MAAI,KAAK,cAAc,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,GAAG,KAAK;;;;;;;;;CAU9B,oBAAoB,YAAqC;AACvD,OAAK,mBAAmB;GAAE,GAAG,KAAK;GAAkB,GAAG;GAAY;;;CAIrE,qBAAqB,UAAmC;EACtD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,OAAK,cAAc,iBAAiB;AACpC,OAAK,eAAe,iBAAiB;AACrC,OAAK,qBAAqB,iBAAiB;;;CAI7C,gBAAgB,cAA4B;AAC1C,OAAK,qBAAqB,EAAE,cAAc,CAAC;;;CAI7C,YAAY,UAA+C;EACzD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,SAAO,EACL,UACE,OACA,eACG,KAAK,oBAAoB,OAAO,YAAY,iBAAiB,EACnE;;CAGH,MAAM,QACJ,OACA,YACe;AACf,SAAO,KAAK,oBAAoB,OAAO,YAAY;GACjD,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,oBAAoB,KAAK;GAC1B,CAAC;;CAGJ,MAAc,oBACZ,OACA,YACA,UACe;AACf,MAAI,KAAK,kBAAmB;AAG5B,MAAI,CAAC,SAAS,sBAAsB,CAAC,KAAK,iBAAiB,CAAE;AAE7D,QAAMA,gCAAa,KAAK;GACtB;GACY;GAYZ,kBAAkB;IAChB,GAAG,KAAK;IACR,+CAAuB;KACrB,aAAa,SAAS;KACtB,YAAY,KAAK;KAClB,CAAC;IACF,mBAAmBC;IAKnB,mBAAmBC;IAInB,qBAAqB;IACtB;GACD,aAAaC;GACb,gBAAgBC;GAChB,aAAa,SAAS,eAAe;GACrC,cAAc,SAAS,gBAAgB;GACxC,CAAC;;CAGJ,AAAQ,yBACN,UAC2B;EAC3B,MAAM,+DAAuC,SAAS,YAAY;AAClE,MAAI,gBAAgB,OAClB,QAAO;GACL;GACA,cAAc;GACd,oBAAoB;GACrB;AAGH,SAAO;GACL,aAAa;GACb,cAAc,SAAS,gBAAgB;GACvC,oBAAoB,SAAS,+DACD,SAAS,aAAa,GAC9C;GACL;;CAGH,AAAQ,cAAc,YAAgC;EACpD,IAAI;AAEJ,gBAAc,cAAc;AAE5B,MAAI,QAAQ,IAAI,iCACd,eAAc,WAAW,QAAQ,IAAI,iCAAiC;AAMxE,MAAI,OAAO,MAAM,YAAY,IAAI,cAAc,KAAK,cAAc,EAChE,OAAM,IAAI,MAAM,sCAAsC;AAGxD,OAAK,aAAa;;;AAItB,MAAM,YAAY,IAAI,iBAAiB"}
+{"version":3,"file":"telemetry-client.cjs","names":["lambdaClient","TELEMETRY_EMITTER_V2","TELEMETRY_SURFACE_V2","RUNTIME_PACKAGE_NAME","RUNTIME_PACKAGE_VERSION"],"sources":["../../../../src/v2/runtime/telemetry/telemetry-client.ts"],"sourcesContent":["import type { AnalyticsEvents } from \"./events\";\nimport {\n  lambdaClient,\n  parseAndWarnTelemetryId,\n  computeSamplingMeta,\n  TELEMETRY_EMITTER_V2,\n  TELEMETRY_SURFACE_V2,\n} from \"@copilotkit/shared\";\nimport {\n  RUNTIME_PACKAGE_NAME,\n  RUNTIME_PACKAGE_VERSION,\n} from \"../core/package-info\";\nimport { firstNonBlankTelemetryId } from \"./telemetry-identity\";\n\n/** Transport identity and sampling authority resolved for one runtime. */\nexport interface TelemetryIdentity {\n  telemetryId?: string;\n  licenseToken?: string;\n}\n\n/** Capture-only telemetry client bound to one runtime identity. */\nexport interface TelemetryCapture {\n  capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void>;\n}\n\ninterface ResolvedTelemetryIdentity {\n  telemetryId: string | null;\n  licenseToken: string | null;\n  licenseTelemetryId: string | null;\n}\n\nexport function isTelemetryDisabled(): boolean {\n  return (\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"true\" ||\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"1\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===\n      \"true\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === \"1\"\n  );\n}\n\nexport class TelemetryClient {\n  private telemetryDisabled: boolean = false;\n  // Opt-down for anonymous events, defaulting to 1: the sink is ours, so a\n  // real count beats one extrapolated from a fraction of the population.\n  // It stays configurable because it is the cross-SDK lever for reducing or\n  // stopping anonymous volume — the Go, Python, Ruby, and .NET runtimes all\n  // expose it, and the cross-language conformance suite drives it to 0 to\n  // assert silence. Identified callers bypass it.\n  private sampleRate: number = 1;\n  // EIP / Intelligence license token (Ed25519-signed JWT). Kept separate\n  // from standalone identity so the transport receives only the selected\n  // identity source.\n  private licenseToken: string | null = null;\n  // Standalone identity sent as a transport claim. It does not make an\n  // event identified.\n  private telemetryId: string | null = null;\n  // License-derived identity. This client sends every event either way;\n  // the id is what sets telemetry_identified on the sampling block, which\n  // is how the two populations stay separable downstream.\n  private licenseTelemetryId: string | null = null;\n  // Properties merged into every event this client sends.\n  //\n  // For facts about the caller that are true for the whole process rather than\n  // for one event: which product is embedding the runtime, for instance. A\n  // distribution built on top of this can then be told apart in the existing\n  // events instead of sending its own, which is the difference between one\n  // extra field and a second pipeline nobody asked for.\n  //\n  // Sent as `global_properties`, a field of its own, so these stay separable\n  // from an event's own properties all the way to the sink.\n  //\n  // Do not reuse a key an event already sets: the fanout spreads this bag last\n  // for `oss.runtime.*`, so a collision resolves in favour of the global and\n  // does so silently. Names here should describe the caller, not the call.\n  private globalProperties: Record<string, unknown> = {};\n\n  constructor({\n    telemetryDisabled,\n    sampleRate,\n  }: {\n    telemetryDisabled?: boolean;\n    sampleRate?: number;\n  } = {}) {\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n    this.setSampleRate(sampleRate);\n  }\n\n  private shouldSendEvent() {\n    if (this.sampleRate >= 1) return true;\n    return Math.random() < this.sampleRate;\n  }\n\n  /**\n   * Add properties carried by every subsequent event.\n   *\n   * Merged rather than replaced, so two callers setting different fields do not\n   * erase each other. Set once at runtime construction in practice; nothing\n   * here is per-request.\n   */\n  setGlobalProperties(properties: Record<string, unknown>) {\n    this.globalProperties = { ...this.globalProperties, ...properties };\n  }\n\n  /** Atomically replace the process-wide telemetry identity. */\n  setTelemetryIdentity(identity: TelemetryIdentity): void {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    this.telemetryId = resolvedIdentity.telemetryId;\n    this.licenseToken = resolvedIdentity.licenseToken;\n    this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;\n  }\n\n  /** @deprecated Prefer {@link setTelemetryIdentity}. */\n  setLicenseToken(licenseToken: string): void {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /** Create an immutable capture scope for one Runtime instance. */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    return {\n      capture: <K extends keyof AnalyticsEvents>(\n        event: K,\n        properties: AnalyticsEvents[K],\n      ) => this.captureWithIdentity(event, properties, resolvedIdentity),\n    };\n  }\n\n  async capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void> {\n    return this.captureWithIdentity(event, properties, {\n      telemetryId: this.telemetryId,\n      licenseToken: this.licenseToken,\n      licenseTelemetryId: this.licenseTelemetryId,\n    });\n  }\n\n  private async captureWithIdentity<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n    identity: ResolvedTelemetryIdentity,\n  ): Promise<void> {\n    // Re-read the environment: an opt-out set after import (for example a\n    // dotenv call below the imports) must still stop events.\n    if (this.telemetryDisabled || isTelemetryDisabled()) return;\n    // Nothing is gated at the default rate of 1. A caller who dialled it\n    // down means it, and identified callers are exempt either way.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;\n\n    await lambdaClient.send({\n      event,\n      properties: properties as Record<string, unknown>,\n      // Its own field on the wire rather than folded into `properties`, which\n      // is what the sink expects: for `oss.runtime.*` the fanout treats\n      // `global_properties` as the SDK's pass-through bag and spreads it into\n      // the analytics event, and v1's client sends package name and version the\n      // same way. Folding it in would work and would put a process-level fact\n      // in the per-event slot, where nothing downstream expects to find one.\n      // Sampling metadata rides in the same slot, as it does in v1. It\n      // reads 1/1 unless a caller dialled the rate down, and is stamped\n      // either way: a consumer summing sampleWeight across emitters must\n      // not find the field missing on a quarter of the rows, which is the\n      // state that made ~24% of runtime volume unweightable (OSS-1017).\n      globalProperties: {\n        ...this.globalProperties,\n        ...computeSamplingMeta({\n          telemetryId: identity.licenseTelemetryId,\n          sampleRate: this.sampleRate,\n        }),\n        telemetry_emitter: TELEMETRY_EMITTER_V2,\n        // Constant here: a v1 request never reaches this client. The v1\n        // entrypoint hands its own capture scope to the V2 runtime it\n        // builds, so v1 traffic is emitted by the v1 client and stamped\n        // v1 there — which is also what keeps it on the Segment wire.\n        telemetry_surface: TELEMETRY_SURFACE_V2,\n        // This client has one transport, so the marker is constant here. It\n        // is stamped anyway so the property means the same thing on every\n        // event whichever client produced it (OSS-1019).\n        telemetry_transport: \"lambda\",\n      },\n      packageName: RUNTIME_PACKAGE_NAME,\n      packageVersion: RUNTIME_PACKAGE_VERSION,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n  }\n\n  private resolveTelemetryIdentity(\n    identity: TelemetryIdentity,\n  ): ResolvedTelemetryIdentity {\n    const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);\n    if (telemetryId !== undefined) {\n      return {\n        telemetryId,\n        licenseToken: null,\n        licenseTelemetryId: null,\n      };\n    }\n\n    return {\n      telemetryId: null,\n      licenseToken: identity.licenseToken ?? null,\n      licenseTelemetryId: identity.licenseToken\n        ? parseAndWarnTelemetryId(identity.licenseToken)\n        : null,\n    };\n  }\n\n  private setSampleRate(sampleRate: number | undefined) {\n    let _sampleRate: number;\n\n    _sampleRate = sampleRate ?? 1;\n\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);\n    }\n\n    // Number.isNaN guards against parseFloat(\"nonsense\") slipping past the\n    // range check (all NaN comparisons are false), which would silently\n    // drop every anonymous event with no signal.\n    if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) {\n      throw new Error(\"Sample rate must be between 0 and 1\");\n    }\n\n    this.sampleRate = _sampleRate;\n  }\n}\n\nconst telemetry = new TelemetryClient();\nexport default telemetry;\n"],"mappings":";;;;;;AAkCA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB;;AAIzE,IAAa,kBAAb,MAA6B;CAoC3B,YAAY,EACV,mBACA,eAIE,EAAE,EAAE;2BAzC6B;oBAOR;sBAIS;qBAGD;4BAIO;0BAeQ,EAAE;AASpD,OAAK,oBAAoB,qBAAqB,qBAAqB;AACnE,OAAK,cAAc,WAAW;;CAGhC,AAAQ,kBAAkB;AACxB,MAAI,KAAK,cAAc,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,GAAG,KAAK;;;;;;;;;CAU9B,oBAAoB,YAAqC;AACvD,OAAK,mBAAmB;GAAE,GAAG,KAAK;GAAkB,GAAG;GAAY;;;CAIrE,qBAAqB,UAAmC;EACtD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,OAAK,cAAc,iBAAiB;AACpC,OAAK,eAAe,iBAAiB;AACrC,OAAK,qBAAqB,iBAAiB;;;CAI7C,gBAAgB,cAA4B;AAC1C,OAAK,qBAAqB,EAAE,cAAc,CAAC;;;CAI7C,YAAY,UAA+C;EACzD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,SAAO,EACL,UACE,OACA,eACG,KAAK,oBAAoB,OAAO,YAAY,iBAAiB,EACnE;;CAGH,MAAM,QACJ,OACA,YACe;AACf,SAAO,KAAK,oBAAoB,OAAO,YAAY;GACjD,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,oBAAoB,KAAK;GAC1B,CAAC;;CAGJ,MAAc,oBACZ,OACA,YACA,UACe;AAGf,MAAI,KAAK,qBAAqB,qBAAqB,CAAE;AAGrD,MAAI,CAAC,SAAS,sBAAsB,CAAC,KAAK,iBAAiB,CAAE;AAE7D,QAAMA,gCAAa,KAAK;GACtB;GACY;GAYZ,kBAAkB;IAChB,GAAG,KAAK;IACR,+CAAuB;KACrB,aAAa,SAAS;KACtB,YAAY,KAAK;KAClB,CAAC;IACF,mBAAmBC;IAKnB,mBAAmBC;IAInB,qBAAqB;IACtB;GACD,aAAaC;GACb,gBAAgBC;GAChB,aAAa,SAAS,eAAe;GACrC,cAAc,SAAS,gBAAgB;GACxC,CAAC;;CAGJ,AAAQ,yBACN,UAC2B;EAC3B,MAAM,+DAAuC,SAAS,YAAY;AAClE,MAAI,gBAAgB,OAClB,QAAO;GACL;GACA,cAAc;GACd,oBAAoB;GACrB;AAGH,SAAO;GACL,aAAa;GACb,cAAc,SAAS,gBAAgB;GACvC,oBAAoB,SAAS,+DACD,SAAS,aAAa,GAC9C;GACL;;CAGH,AAAQ,cAAc,YAAgC;EACpD,IAAI;AAEJ,gBAAc,cAAc;AAE5B,MAAI,QAAQ,IAAI,iCACd,eAAc,WAAW,QAAQ,IAAI,iCAAiC;AAMxE,MAAI,OAAO,MAAM,YAAY,IAAI,cAAc,KAAK,cAAc,EAChE,OAAM,IAAI,MAAM,sCAAsC;AAGxD,OAAK,aAAa;;;AAItB,MAAM,YAAY,IAAI,iBAAiB"}

package/dist/v2/runtime/telemetry/telemetry-client.mjs

@@ -59,7 +59,7 @@ var TelemetryClient = class {
 		});
 	}
 	async captureWithIdentity(event, properties, identity) {
-		if (this.telemetryDisabled) return;
+		if (this.telemetryDisabled || isTelemetryDisabled()) return;
 		if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;
 		await lambdaClient.send({
 			event,

package/dist/v2/runtime/telemetry/telemetry-client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.mjs","names":[],"sources":["../../../../src/v2/runtime/telemetry/telemetry-client.ts"],"sourcesContent":["import type { AnalyticsEvents } from \"./events\";\nimport {\n  lambdaClient,\n  parseAndWarnTelemetryId,\n  computeSamplingMeta,\n  TELEMETRY_EMITTER_V2,\n  TELEMETRY_SURFACE_V2,\n} from \"@copilotkit/shared\";\nimport {\n  RUNTIME_PACKAGE_NAME,\n  RUNTIME_PACKAGE_VERSION,\n} from \"../core/package-info\";\nimport { firstNonBlankTelemetryId } from \"./telemetry-identity\";\n\n/** Transport identity and sampling authority resolved for one runtime. */\nexport interface TelemetryIdentity {\n  telemetryId?: string;\n  licenseToken?: string;\n}\n\n/** Capture-only telemetry client bound to one runtime identity. */\nexport interface TelemetryCapture {\n  capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void>;\n}\n\ninterface ResolvedTelemetryIdentity {\n  telemetryId: string | null;\n  licenseToken: string | null;\n  licenseTelemetryId: string | null;\n}\n\nexport function isTelemetryDisabled(): boolean {\n  return (\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"true\" ||\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"1\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===\n      \"true\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === \"1\"\n  );\n}\n\nexport class TelemetryClient {\n  private telemetryDisabled: boolean = false;\n  // Opt-down for anonymous events, defaulting to 1: the sink is ours, so a\n  // real count beats one extrapolated from a fraction of the population.\n  // It stays configurable because it is the cross-SDK lever for reducing or\n  // stopping anonymous volume — the Go, Python, Ruby, and .NET runtimes all\n  // expose it, and the cross-language conformance suite drives it to 0 to\n  // assert silence. Identified callers bypass it.\n  private sampleRate: number = 1;\n  // EIP / Intelligence license token (Ed25519-signed JWT). Kept separate\n  // from standalone identity so the transport receives only the selected\n  // identity source.\n  private licenseToken: string | null = null;\n  // Standalone identity sent as a transport claim. It does not make an\n  // event identified.\n  private telemetryId: string | null = null;\n  // License-derived identity. This client sends every event either way;\n  // the id is what sets telemetry_identified on the sampling block, which\n  // is how the two populations stay separable downstream.\n  private licenseTelemetryId: string | null = null;\n  // Properties merged into every event this client sends.\n  //\n  // For facts about the caller that are true for the whole process rather than\n  // for one event: which product is embedding the runtime, for instance. A\n  // distribution built on top of this can then be told apart in the existing\n  // events instead of sending its own, which is the difference between one\n  // extra field and a second pipeline nobody asked for.\n  //\n  // Sent as `global_properties`, a field of its own, so these stay separable\n  // from an event's own properties all the way to the sink.\n  //\n  // Do not reuse a key an event already sets: the fanout spreads this bag last\n  // for `oss.runtime.*`, so a collision resolves in favour of the global and\n  // does so silently. Names here should describe the caller, not the call.\n  private globalProperties: Record<string, unknown> = {};\n\n  constructor({\n    telemetryDisabled,\n    sampleRate,\n  }: {\n    telemetryDisabled?: boolean;\n    sampleRate?: number;\n  } = {}) {\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n    this.setSampleRate(sampleRate);\n  }\n\n  private shouldSendEvent() {\n    if (this.sampleRate >= 1) return true;\n    return Math.random() < this.sampleRate;\n  }\n\n  /**\n   * Add properties carried by every subsequent event.\n   *\n   * Merged rather than replaced, so two callers setting different fields do not\n   * erase each other. Set once at runtime construction in practice; nothing\n   * here is per-request.\n   */\n  setGlobalProperties(properties: Record<string, unknown>) {\n    this.globalProperties = { ...this.globalProperties, ...properties };\n  }\n\n  /** Atomically replace the process-wide telemetry identity. */\n  setTelemetryIdentity(identity: TelemetryIdentity): void {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    this.telemetryId = resolvedIdentity.telemetryId;\n    this.licenseToken = resolvedIdentity.licenseToken;\n    this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;\n  }\n\n  /** @deprecated Prefer {@link setTelemetryIdentity}. */\n  setLicenseToken(licenseToken: string): void {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /** Create an immutable capture scope for one Runtime instance. */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    return {\n      capture: <K extends keyof AnalyticsEvents>(\n        event: K,\n        properties: AnalyticsEvents[K],\n      ) => this.captureWithIdentity(event, properties, resolvedIdentity),\n    };\n  }\n\n  async capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void> {\n    return this.captureWithIdentity(event, properties, {\n      telemetryId: this.telemetryId,\n      licenseToken: this.licenseToken,\n      licenseTelemetryId: this.licenseTelemetryId,\n    });\n  }\n\n  private async captureWithIdentity<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n    identity: ResolvedTelemetryIdentity,\n  ): Promise<void> {\n    if (this.telemetryDisabled) return;\n    // Nothing is gated at the default rate of 1. A caller who dialled it\n    // down means it, and identified callers are exempt either way.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;\n\n    await lambdaClient.send({\n      event,\n      properties: properties as Record<string, unknown>,\n      // Its own field on the wire rather than folded into `properties`, which\n      // is what the sink expects: for `oss.runtime.*` the fanout treats\n      // `global_properties` as the SDK's pass-through bag and spreads it into\n      // the analytics event, and v1's client sends package name and version the\n      // same way. Folding it in would work and would put a process-level fact\n      // in the per-event slot, where nothing downstream expects to find one.\n      // Sampling metadata rides in the same slot, as it does in v1. It\n      // reads 1/1 unless a caller dialled the rate down, and is stamped\n      // either way: a consumer summing sampleWeight across emitters must\n      // not find the field missing on a quarter of the rows, which is the\n      // state that made ~24% of runtime volume unweightable (OSS-1017).\n      globalProperties: {\n        ...this.globalProperties,\n        ...computeSamplingMeta({\n          telemetryId: identity.licenseTelemetryId,\n          sampleRate: this.sampleRate,\n        }),\n        telemetry_emitter: TELEMETRY_EMITTER_V2,\n        // Constant here: a v1 request never reaches this client. The v1\n        // entrypoint hands its own capture scope to the V2 runtime it\n        // builds, so v1 traffic is emitted by the v1 client and stamped\n        // v1 there — which is also what keeps it on the Segment wire.\n        telemetry_surface: TELEMETRY_SURFACE_V2,\n        // This client has one transport, so the marker is constant here. It\n        // is stamped anyway so the property means the same thing on every\n        // event whichever client produced it (OSS-1019).\n        telemetry_transport: \"lambda\",\n      },\n      packageName: RUNTIME_PACKAGE_NAME,\n      packageVersion: RUNTIME_PACKAGE_VERSION,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n  }\n\n  private resolveTelemetryIdentity(\n    identity: TelemetryIdentity,\n  ): ResolvedTelemetryIdentity {\n    const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);\n    if (telemetryId !== undefined) {\n      return {\n        telemetryId,\n        licenseToken: null,\n        licenseTelemetryId: null,\n      };\n    }\n\n    return {\n      telemetryId: null,\n      licenseToken: identity.licenseToken ?? null,\n      licenseTelemetryId: identity.licenseToken\n        ? parseAndWarnTelemetryId(identity.licenseToken)\n        : null,\n    };\n  }\n\n  private setSampleRate(sampleRate: number | undefined) {\n    let _sampleRate: number;\n\n    _sampleRate = sampleRate ?? 1;\n\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);\n    }\n\n    // Number.isNaN guards against parseFloat(\"nonsense\") slipping past the\n    // range check (all NaN comparisons are false), which would silently\n    // drop every anonymous event with no signal.\n    if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) {\n      throw new Error(\"Sample rate must be between 0 and 1\");\n    }\n\n    this.sampleRate = _sampleRate;\n  }\n}\n\nconst telemetry = new TelemetryClient();\nexport default telemetry;\n"],"mappings":";;;;;;AAkCA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB;;AAIzE,IAAa,kBAAb,MAA6B;CAoC3B,YAAY,EACV,mBACA,eAIE,EAAE,EAAE;2BAzC6B;oBAOR;sBAIS;qBAGD;4BAIO;0BAeQ,EAAE;AASpD,OAAK,oBAAoB,qBAAqB,qBAAqB;AACnE,OAAK,cAAc,WAAW;;CAGhC,AAAQ,kBAAkB;AACxB,MAAI,KAAK,cAAc,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,GAAG,KAAK;;;;;;;;;CAU9B,oBAAoB,YAAqC;AACvD,OAAK,mBAAmB;GAAE,GAAG,KAAK;GAAkB,GAAG;GAAY;;;CAIrE,qBAAqB,UAAmC;EACtD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,OAAK,cAAc,iBAAiB;AACpC,OAAK,eAAe,iBAAiB;AACrC,OAAK,qBAAqB,iBAAiB;;;CAI7C,gBAAgB,cAA4B;AAC1C,OAAK,qBAAqB,EAAE,cAAc,CAAC;;;CAI7C,YAAY,UAA+C;EACzD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,SAAO,EACL,UACE,OACA,eACG,KAAK,oBAAoB,OAAO,YAAY,iBAAiB,EACnE;;CAGH,MAAM,QACJ,OACA,YACe;AACf,SAAO,KAAK,oBAAoB,OAAO,YAAY;GACjD,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,oBAAoB,KAAK;GAC1B,CAAC;;CAGJ,MAAc,oBACZ,OACA,YACA,UACe;AACf,MAAI,KAAK,kBAAmB;AAG5B,MAAI,CAAC,SAAS,sBAAsB,CAAC,KAAK,iBAAiB,CAAE;AAE7D,QAAM,aAAa,KAAK;GACtB;GACY;GAYZ,kBAAkB;IAChB,GAAG,KAAK;IACR,GAAG,oBAAoB;KACrB,aAAa,SAAS;KACtB,YAAY,KAAK;KAClB,CAAC;IACF,mBAAmB;IAKnB,mBAAmB;IAInB,qBAAqB;IACtB;GACD,aAAa;GACb,gBAAgB;GAChB,aAAa,SAAS,eAAe;GACrC,cAAc,SAAS,gBAAgB;GACxC,CAAC;;CAGJ,AAAQ,yBACN,UAC2B;EAC3B,MAAM,cAAc,yBAAyB,SAAS,YAAY;AAClE,MAAI,gBAAgB,OAClB,QAAO;GACL;GACA,cAAc;GACd,oBAAoB;GACrB;AAGH,SAAO;GACL,aAAa;GACb,cAAc,SAAS,gBAAgB;GACvC,oBAAoB,SAAS,eACzB,wBAAwB,SAAS,aAAa,GAC9C;GACL;;CAGH,AAAQ,cAAc,YAAgC;EACpD,IAAI;AAEJ,gBAAc,cAAc;AAE5B,MAAI,QAAQ,IAAI,iCACd,eAAc,WAAW,QAAQ,IAAI,iCAAiC;AAMxE,MAAI,OAAO,MAAM,YAAY,IAAI,cAAc,KAAK,cAAc,EAChE,OAAM,IAAI,MAAM,sCAAsC;AAGxD,OAAK,aAAa;;;AAItB,MAAM,YAAY,IAAI,iBAAiB"}
+{"version":3,"file":"telemetry-client.mjs","names":[],"sources":["../../../../src/v2/runtime/telemetry/telemetry-client.ts"],"sourcesContent":["import type { AnalyticsEvents } from \"./events\";\nimport {\n  lambdaClient,\n  parseAndWarnTelemetryId,\n  computeSamplingMeta,\n  TELEMETRY_EMITTER_V2,\n  TELEMETRY_SURFACE_V2,\n} from \"@copilotkit/shared\";\nimport {\n  RUNTIME_PACKAGE_NAME,\n  RUNTIME_PACKAGE_VERSION,\n} from \"../core/package-info\";\nimport { firstNonBlankTelemetryId } from \"./telemetry-identity\";\n\n/** Transport identity and sampling authority resolved for one runtime. */\nexport interface TelemetryIdentity {\n  telemetryId?: string;\n  licenseToken?: string;\n}\n\n/** Capture-only telemetry client bound to one runtime identity. */\nexport interface TelemetryCapture {\n  capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void>;\n}\n\ninterface ResolvedTelemetryIdentity {\n  telemetryId: string | null;\n  licenseToken: string | null;\n  licenseTelemetryId: string | null;\n}\n\nexport function isTelemetryDisabled(): boolean {\n  return (\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"true\" ||\n    (process.env as Record<string, string | undefined>)\n      .COPILOTKIT_TELEMETRY_DISABLED === \"1\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK ===\n      \"true\" ||\n    (process.env as Record<string, string | undefined>).DO_NOT_TRACK === \"1\"\n  );\n}\n\nexport class TelemetryClient {\n  private telemetryDisabled: boolean = false;\n  // Opt-down for anonymous events, defaulting to 1: the sink is ours, so a\n  // real count beats one extrapolated from a fraction of the population.\n  // It stays configurable because it is the cross-SDK lever for reducing or\n  // stopping anonymous volume — the Go, Python, Ruby, and .NET runtimes all\n  // expose it, and the cross-language conformance suite drives it to 0 to\n  // assert silence. Identified callers bypass it.\n  private sampleRate: number = 1;\n  // EIP / Intelligence license token (Ed25519-signed JWT). Kept separate\n  // from standalone identity so the transport receives only the selected\n  // identity source.\n  private licenseToken: string | null = null;\n  // Standalone identity sent as a transport claim. It does not make an\n  // event identified.\n  private telemetryId: string | null = null;\n  // License-derived identity. This client sends every event either way;\n  // the id is what sets telemetry_identified on the sampling block, which\n  // is how the two populations stay separable downstream.\n  private licenseTelemetryId: string | null = null;\n  // Properties merged into every event this client sends.\n  //\n  // For facts about the caller that are true for the whole process rather than\n  // for one event: which product is embedding the runtime, for instance. A\n  // distribution built on top of this can then be told apart in the existing\n  // events instead of sending its own, which is the difference between one\n  // extra field and a second pipeline nobody asked for.\n  //\n  // Sent as `global_properties`, a field of its own, so these stay separable\n  // from an event's own properties all the way to the sink.\n  //\n  // Do not reuse a key an event already sets: the fanout spreads this bag last\n  // for `oss.runtime.*`, so a collision resolves in favour of the global and\n  // does so silently. Names here should describe the caller, not the call.\n  private globalProperties: Record<string, unknown> = {};\n\n  constructor({\n    telemetryDisabled,\n    sampleRate,\n  }: {\n    telemetryDisabled?: boolean;\n    sampleRate?: number;\n  } = {}) {\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n    this.setSampleRate(sampleRate);\n  }\n\n  private shouldSendEvent() {\n    if (this.sampleRate >= 1) return true;\n    return Math.random() < this.sampleRate;\n  }\n\n  /**\n   * Add properties carried by every subsequent event.\n   *\n   * Merged rather than replaced, so two callers setting different fields do not\n   * erase each other. Set once at runtime construction in practice; nothing\n   * here is per-request.\n   */\n  setGlobalProperties(properties: Record<string, unknown>) {\n    this.globalProperties = { ...this.globalProperties, ...properties };\n  }\n\n  /** Atomically replace the process-wide telemetry identity. */\n  setTelemetryIdentity(identity: TelemetryIdentity): void {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    this.telemetryId = resolvedIdentity.telemetryId;\n    this.licenseToken = resolvedIdentity.licenseToken;\n    this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;\n  }\n\n  /** @deprecated Prefer {@link setTelemetryIdentity}. */\n  setLicenseToken(licenseToken: string): void {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /** Create an immutable capture scope for one Runtime instance. */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n    return {\n      capture: <K extends keyof AnalyticsEvents>(\n        event: K,\n        properties: AnalyticsEvents[K],\n      ) => this.captureWithIdentity(event, properties, resolvedIdentity),\n    };\n  }\n\n  async capture<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n  ): Promise<void> {\n    return this.captureWithIdentity(event, properties, {\n      telemetryId: this.telemetryId,\n      licenseToken: this.licenseToken,\n      licenseTelemetryId: this.licenseTelemetryId,\n    });\n  }\n\n  private async captureWithIdentity<K extends keyof AnalyticsEvents>(\n    event: K,\n    properties: AnalyticsEvents[K],\n    identity: ResolvedTelemetryIdentity,\n  ): Promise<void> {\n    // Re-read the environment: an opt-out set after import (for example a\n    // dotenv call below the imports) must still stop events.\n    if (this.telemetryDisabled || isTelemetryDisabled()) return;\n    // Nothing is gated at the default rate of 1. A caller who dialled it\n    // down means it, and identified callers are exempt either way.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;\n\n    await lambdaClient.send({\n      event,\n      properties: properties as Record<string, unknown>,\n      // Its own field on the wire rather than folded into `properties`, which\n      // is what the sink expects: for `oss.runtime.*` the fanout treats\n      // `global_properties` as the SDK's pass-through bag and spreads it into\n      // the analytics event, and v1's client sends package name and version the\n      // same way. Folding it in would work and would put a process-level fact\n      // in the per-event slot, where nothing downstream expects to find one.\n      // Sampling metadata rides in the same slot, as it does in v1. It\n      // reads 1/1 unless a caller dialled the rate down, and is stamped\n      // either way: a consumer summing sampleWeight across emitters must\n      // not find the field missing on a quarter of the rows, which is the\n      // state that made ~24% of runtime volume unweightable (OSS-1017).\n      globalProperties: {\n        ...this.globalProperties,\n        ...computeSamplingMeta({\n          telemetryId: identity.licenseTelemetryId,\n          sampleRate: this.sampleRate,\n        }),\n        telemetry_emitter: TELEMETRY_EMITTER_V2,\n        // Constant here: a v1 request never reaches this client. The v1\n        // entrypoint hands its own capture scope to the V2 runtime it\n        // builds, so v1 traffic is emitted by the v1 client and stamped\n        // v1 there — which is also what keeps it on the Segment wire.\n        telemetry_surface: TELEMETRY_SURFACE_V2,\n        // This client has one transport, so the marker is constant here. It\n        // is stamped anyway so the property means the same thing on every\n        // event whichever client produced it (OSS-1019).\n        telemetry_transport: \"lambda\",\n      },\n      packageName: RUNTIME_PACKAGE_NAME,\n      packageVersion: RUNTIME_PACKAGE_VERSION,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n  }\n\n  private resolveTelemetryIdentity(\n    identity: TelemetryIdentity,\n  ): ResolvedTelemetryIdentity {\n    const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);\n    if (telemetryId !== undefined) {\n      return {\n        telemetryId,\n        licenseToken: null,\n        licenseTelemetryId: null,\n      };\n    }\n\n    return {\n      telemetryId: null,\n      licenseToken: identity.licenseToken ?? null,\n      licenseTelemetryId: identity.licenseToken\n        ? parseAndWarnTelemetryId(identity.licenseToken)\n        : null,\n    };\n  }\n\n  private setSampleRate(sampleRate: number | undefined) {\n    let _sampleRate: number;\n\n    _sampleRate = sampleRate ?? 1;\n\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);\n    }\n\n    // Number.isNaN guards against parseFloat(\"nonsense\") slipping past the\n    // range check (all NaN comparisons are false), which would silently\n    // drop every anonymous event with no signal.\n    if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) {\n      throw new Error(\"Sample rate must be between 0 and 1\");\n    }\n\n    this.sampleRate = _sampleRate;\n  }\n}\n\nconst telemetry = new TelemetryClient();\nexport default telemetry;\n"],"mappings":";;;;;;AAkCA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB;;AAIzE,IAAa,kBAAb,MAA6B;CAoC3B,YAAY,EACV,mBACA,eAIE,EAAE,EAAE;2BAzC6B;oBAOR;sBAIS;qBAGD;4BAIO;0BAeQ,EAAE;AASpD,OAAK,oBAAoB,qBAAqB,qBAAqB;AACnE,OAAK,cAAc,WAAW;;CAGhC,AAAQ,kBAAkB;AACxB,MAAI,KAAK,cAAc,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,GAAG,KAAK;;;;;;;;;CAU9B,oBAAoB,YAAqC;AACvD,OAAK,mBAAmB;GAAE,GAAG,KAAK;GAAkB,GAAG;GAAY;;;CAIrE,qBAAqB,UAAmC;EACtD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,OAAK,cAAc,iBAAiB;AACpC,OAAK,eAAe,iBAAiB;AACrC,OAAK,qBAAqB,iBAAiB;;;CAI7C,gBAAgB,cAA4B;AAC1C,OAAK,qBAAqB,EAAE,cAAc,CAAC;;;CAI7C,YAAY,UAA+C;EACzD,MAAM,mBAAmB,KAAK,yBAAyB,SAAS;AAChE,SAAO,EACL,UACE,OACA,eACG,KAAK,oBAAoB,OAAO,YAAY,iBAAiB,EACnE;;CAGH,MAAM,QACJ,OACA,YACe;AACf,SAAO,KAAK,oBAAoB,OAAO,YAAY;GACjD,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,oBAAoB,KAAK;GAC1B,CAAC;;CAGJ,MAAc,oBACZ,OACA,YACA,UACe;AAGf,MAAI,KAAK,qBAAqB,qBAAqB,CAAE;AAGrD,MAAI,CAAC,SAAS,sBAAsB,CAAC,KAAK,iBAAiB,CAAE;AAE7D,QAAM,aAAa,KAAK;GACtB;GACY;GAYZ,kBAAkB;IAChB,GAAG,KAAK;IACR,GAAG,oBAAoB;KACrB,aAAa,SAAS;KACtB,YAAY,KAAK;KAClB,CAAC;IACF,mBAAmB;IAKnB,mBAAmB;IAInB,qBAAqB;IACtB;GACD,aAAa;GACb,gBAAgB;GAChB,aAAa,SAAS,eAAe;GACrC,cAAc,SAAS,gBAAgB;GACxC,CAAC;;CAGJ,AAAQ,yBACN,UAC2B;EAC3B,MAAM,cAAc,yBAAyB,SAAS,YAAY;AAClE,MAAI,gBAAgB,OAClB,QAAO;GACL;GACA,cAAc;GACd,oBAAoB;GACrB;AAGH,SAAO;GACL,aAAa;GACb,cAAc,SAAS,gBAAgB;GACvC,oBAAoB,SAAS,eACzB,wBAAwB,SAAS,aAAa,GAC9C;GACL;;CAGH,AAAQ,cAAc,YAAgC;EACpD,IAAI;AAEJ,gBAAc,cAAc;AAE5B,MAAI,QAAQ,IAAI,iCACd,eAAc,WAAW,QAAQ,IAAI,iCAAiC;AAMxE,MAAI,OAAO,MAAM,YAAY,IAAI,cAAc,KAAK,cAAc,EAChE,OAAM,IAAI,MAAM,sCAAsC;AAGxD,OAAK,aAAa;;;AAItB,MAAM,YAAY,IAAI,iBAAiB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/runtime",
-  "version": "1.80.0",
+  "version": "1.82.0",
   "private": false,
   "keywords": [
     "ai",
@@ -109,9 +109,9 @@
     "ws": "^8.18.0",
     "zod": "^3.25.18",
     "yauzl": "2.10.0",
-    "@copilotkit/channels-core": "^0.11.1",
     "@copilotkit/channels-intelligence": "^0.11.1",
-    "@copilotkit/shared": "1.80.0"
+    "@copilotkit/shared": "1.82.0",
+    "@copilotkit/channels-core": "^0.11.1"
   },
   "devDependencies": {
     "@copilotkit/aimock": "latest",
@@ -136,8 +136,8 @@
     "valibot": "^1.2.0",
     "vitest": "^3.2.4",
     "@types/yauzl": "2.10.3",
-    "tsconfig": "1.4.12",
-    "@copilotkit/channels": "0.11.1"
+    "@copilotkit/channels": "0.11.1",
+    "tsconfig": "1.4.12"
   },
   "peerDependencies": {
     "@anthropic-ai/sdk": ">=0.57.0",
@@ -203,7 +203,7 @@
     "generate-graphql-schema": "node -e \"const fs=require('fs');fs.rmSync('__snapshots__',{recursive:true,force:true})\" && ts-node --transpile-only ./scripts/generate-gql-schema.ts",
     "link:global": "pnpm link --global",
     "unlink:global": "pnpm unlink --global",
-    "check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist && tsx ../../scripts/validate-optional-peer-entries.ts . && tsx ../../scripts/validate-module-scope-create-require.ts . && tsc --noEmit -p type-fixtures/express4/tsconfig.json && tsc --noEmit -p type-fixtures/express5/tsconfig.json",
+    "check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist && tsx ../../scripts/validate-optional-peer-entries.ts . && tsx ../../scripts/validate-module-scope-create-require.ts . && tsc --noEmit -p type-fixtures/express4/tsconfig.json && tsc --noEmit -p type-fixtures/express5/tsconfig.json && tsc --noEmit -p type-fixtures/learning-management/tsconfig.json",
     "publint": "publint .",
     "attw": "attw --pack . --profile node16"
   }

package/dist/v2/runtime/endpoints/express-fetch-bridge.cjs

@@ -1,82 +0,0 @@
-require("reflect-metadata");
-const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_node_fetch_handler = require('./node-fetch-handler.cjs');
-let _copilotkit_shared = require("@copilotkit/shared");
-let _remix_run_node_fetch_server = require("@remix-run/node-fetch-server");
-
-//#region src/v2/runtime/endpoints/express-fetch-bridge.ts
-const METHODS_WITHOUT_BODY = new Set([
-	"GET",
-	"HEAD",
-	"OPTIONS"
-]);
-/**
-* Creates a Node HTTP handler from a fetch handler, with Express body-parser
-* compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.
-*
-* When the body stream hasn't been consumed, delegates to the generic
-* `createCopilotNodeHandler`. Only intercepts when Express middleware has
-* pre-parsed the body.
-*/
-function createExpressNodeHandler(handler) {
-	const nodeHandler = require_node_fetch_handler.createCopilotNodeHandler(handler);
-	return async (req, res) => {
-		const method = (req.method ?? "GET").toUpperCase();
-		if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) return nodeHandler(req, res);
-		try {
-			await (0, _remix_run_node_fetch_server.sendResponse)(res, await handler(buildPreParsedRequest(req, res)));
-		} catch (err) {
-			_copilotkit_shared.logger.error({ err }, "Error in Express fetch bridge (pre-parsed path)");
-			if (!res.headersSent) {
-				res.statusCode = 500;
-				res.end("Internal Server Error");
-			}
-		}
-	};
-}
-/**
-* Build a Fetch Request from a Node IncomingMessage whose body stream has
-* already been consumed by an Express body parser.
-*/
-function buildPreParsedRequest(req, res) {
-	const expressReq = req;
-	const method = (req.method ?? "GET").toUpperCase();
-	const url = `${req.protocol || "http"}://${req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? ""}`;
-	const headers = new Headers();
-	for (const [key, value] of Object.entries(req.headers)) {
-		if (value === void 0) continue;
-		if (Array.isArray(value)) for (const v of value) headers.append(key, v);
-		else headers.set(key, value);
-	}
-	const controller = new AbortController();
-	res.on("close", () => {
-		if (!res.writableFinished) controller.abort();
-	});
-	const init = {
-		method,
-		headers,
-		signal: controller.signal
-	};
-	const { body, contentType } = synthesizeBody(expressReq.body);
-	if (contentType) headers.set("content-type", contentType);
-	headers.delete("content-length");
-	if (body !== void 0) init.body = body;
-	return new Request(url, init);
-}
-function hasPreParsedBody(req) {
-	if (req.body === void 0 || req.body === null) return false;
-	return Boolean(req.readableEnded);
-}
-function synthesizeBody(body) {
-	if (Buffer.isBuffer(body) || body instanceof Uint8Array) return { body };
-	if (typeof body === "string") return { body };
-	if (typeof body === "object" && body !== null) return {
-		body: JSON.stringify(body),
-		contentType: "application/json"
-	};
-	return {};
-}
-
-//#endregion
-exports.createExpressNodeHandler = createExpressNodeHandler;
-//# sourceMappingURL=express-fetch-bridge.cjs.map

package/dist/v2/runtime/endpoints/express-fetch-bridge.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"express-fetch-bridge.cjs","names":["createCopilotNodeHandler"],"sources":["../../../../src/v2/runtime/endpoints/express-fetch-bridge.ts"],"sourcesContent":["/**\n * Express-aware Node ↔ Fetch bridge.\n *\n * When Express body-parsing middleware (e.g. `express.json()`) runs before the\n * CopilotKit router, the Node request stream is already consumed and `req.body`\n * holds the parsed content. The generic `createCopilotNodeHandler` (which uses\n * `@remix-run/node-fetch-server`) would hang because it tries to read from the\n * exhausted stream.\n *\n * This module detects the pre-parsed case and re-serialises `req.body` into the\n * Fetch `Request`, falling back to the generic `createCopilotNodeHandler` when the\n * stream is still available.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { sendResponse } from \"@remix-run/node-fetch-server\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nconst METHODS_WITHOUT_BODY = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\nexport type ExpressNodeHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\n/**\n * Creates a Node HTTP handler from a fetch handler, with Express body-parser\n * compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.\n *\n * When the body stream hasn't been consumed, delegates to the generic\n * `createCopilotNodeHandler`. Only intercepts when Express middleware has\n * pre-parsed the body.\n */\nexport function createExpressNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): ExpressNodeHandler {\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    const method = (req.method ?? \"GET\").toUpperCase();\n\n    // Fast path: if no body parser consumed the stream, use the generic handler.\n    if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) {\n      return nodeHandler(req, res);\n    }\n\n    // Slow path: body was consumed by Express middleware — rebuild the Request.\n    try {\n      const fetchReq = buildPreParsedRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Express fetch bridge (pre-parsed path)\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by an Express body parser.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n): Request {\n  const expressReq = req as IncomingMessage & { body?: unknown };\n  const method = (req.method ?? \"GET\").toUpperCase();\n\n  const protocol = (req as any).protocol || \"http\";\n  const host = req.headers.host ?? \"localhost\";\n  const url = `${protocol}://${host}${(req as any).originalUrl ?? req.url ?? \"\"}`;\n\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n\n  // Wire an AbortSignal so client disconnects propagate to the fetch handler\n  const controller = new AbortController();\n  res.on(\"close\", () => {\n    if (!res.writableFinished) controller.abort();\n  });\n\n  const init: RequestInit & { duplex?: \"half\" } = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(expressReq.body);\n  if (contentType) {\n    headers.set(\"content-type\", contentType);\n  }\n  headers.delete(\"content-length\");\n  if (body !== undefined) {\n    init.body = body;\n  }\n\n  return new Request(url, init);\n}\n\nfunction hasPreParsedBody(req: IncomingMessage & { body?: unknown }): boolean {\n  if (req.body === undefined || req.body === null) return false;\n\n  // Only `readableEnded` means \"a parser drained this stream to its end\".\n  // `req.complete` and the private `_readableState.ended` are set by the HTTP\n  // parser once the socket has all the bytes, whether or not anything read them.\n  //\n  // That distinction matters because `req.body` being set does not prove a parser\n  // ran: body-parser 1.x (Express 4) assigns `req.body = req.body || {}` before\n  // its own content-type checks, so a request it declines to parse — multipart\n  // upload, text/plain — reaches us with `req.body === {}` and a full, unread\n  // stream. Treating that as pre-parsed rebuilt the request from `{}` and\n  // dropped the real payload.\n  return Boolean(req.readableEnded);\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    // Buffer/Uint8Array<ArrayBufferLike> are valid fetch bodies at runtime,\n    // but the DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return { body: body as BodyInit };\n  }\n  if (typeof body === \"string\") {\n    return { body };\n  }\n  if (typeof body === \"object\" && body !== null) {\n    return { body: JSON.stringify(body), contentType: \"application/json\" };\n  }\n  return {};\n}\n"],"mappings":";;;;;;;AAoBA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;;;;;;;;;AAehE,SAAgB,yBACd,SACoB;CACpB,MAAM,cAAcA,oDAAyB,QAAQ;AAErD,QAAO,OAAO,KAAsB,QAAwB;EAC1D,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAGlD,MAAI,qBAAqB,IAAI,OAAO,IAAI,CAAC,iBAAiB,IAAI,CAC5D,QAAO,YAAY,KAAK,IAAI;AAI9B,MAAI;AAGF,wDAAmB,KADF,MAAM,QADN,sBAAsB,KAAK,IAAI,CACR,CACP;WAC1B,KAAc;AACrB,6BAAO,MAAM,EAAE,KAAK,EAAE,kDAAkD;AACxE,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;;;;AAUxC,SAAS,sBACP,KACA,KACS;CACT,MAAM,aAAa;CACnB,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAIlD,MAAM,MAAM,GAFM,IAAY,YAAY,OAElB,KADX,IAAI,QAAQ,QAAQ,cACI,IAAY,eAAe,IAAI,OAAO;CAE3E,MAAM,UAAU,IAAI,SAAS;AAC7B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,QAAQ,EAAE;AACtD,MAAI,UAAU,OAAW;AACzB,MAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,KAAK,MAAO,SAAQ,OAAO,KAAK,EAAE;MAE7C,SAAQ,IAAI,KAAK,MAAM;;CAK3B,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAA0C;EAC9C;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,WAAW,KAAK;AAC7D,KAAI,YACF,SAAQ,IAAI,gBAAgB,YAAY;AAE1C,SAAQ,OAAO,iBAAiB;AAChC,KAAI,SAAS,OACX,MAAK,OAAO;AAGd,QAAO,IAAI,QAAQ,KAAK,KAAK;;AAG/B,SAAS,iBAAiB,KAAoD;AAC5E,KAAI,IAAI,SAAS,UAAa,IAAI,SAAS,KAAM,QAAO;AAYxD,QAAO,QAAQ,IAAI,cAAc;;AAGnC,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAG3C,QAAO,EAAQ,MAAkB;AAEnC,KAAI,OAAO,SAAS,SAClB,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;EAAE,MAAM,KAAK,UAAU,KAAK;EAAE,aAAa;EAAoB;AAExE,QAAO,EAAE"}

package/dist/v2/runtime/endpoints/express-fetch-bridge.mjs

@@ -1,81 +0,0 @@
-import "reflect-metadata";
-import { createCopilotNodeHandler } from "./node-fetch-handler.mjs";
-import { logger } from "@copilotkit/shared";
-import { sendResponse } from "@remix-run/node-fetch-server";
-
-//#region src/v2/runtime/endpoints/express-fetch-bridge.ts
-const METHODS_WITHOUT_BODY = new Set([
-	"GET",
-	"HEAD",
-	"OPTIONS"
-]);
-/**
-* Creates a Node HTTP handler from a fetch handler, with Express body-parser
-* compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.
-*
-* When the body stream hasn't been consumed, delegates to the generic
-* `createCopilotNodeHandler`. Only intercepts when Express middleware has
-* pre-parsed the body.
-*/
-function createExpressNodeHandler(handler) {
-	const nodeHandler = createCopilotNodeHandler(handler);
-	return async (req, res) => {
-		const method = (req.method ?? "GET").toUpperCase();
-		if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) return nodeHandler(req, res);
-		try {
-			await sendResponse(res, await handler(buildPreParsedRequest(req, res)));
-		} catch (err) {
-			logger.error({ err }, "Error in Express fetch bridge (pre-parsed path)");
-			if (!res.headersSent) {
-				res.statusCode = 500;
-				res.end("Internal Server Error");
-			}
-		}
-	};
-}
-/**
-* Build a Fetch Request from a Node IncomingMessage whose body stream has
-* already been consumed by an Express body parser.
-*/
-function buildPreParsedRequest(req, res) {
-	const expressReq = req;
-	const method = (req.method ?? "GET").toUpperCase();
-	const url = `${req.protocol || "http"}://${req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? ""}`;
-	const headers = new Headers();
-	for (const [key, value] of Object.entries(req.headers)) {
-		if (value === void 0) continue;
-		if (Array.isArray(value)) for (const v of value) headers.append(key, v);
-		else headers.set(key, value);
-	}
-	const controller = new AbortController();
-	res.on("close", () => {
-		if (!res.writableFinished) controller.abort();
-	});
-	const init = {
-		method,
-		headers,
-		signal: controller.signal
-	};
-	const { body, contentType } = synthesizeBody(expressReq.body);
-	if (contentType) headers.set("content-type", contentType);
-	headers.delete("content-length");
-	if (body !== void 0) init.body = body;
-	return new Request(url, init);
-}
-function hasPreParsedBody(req) {
-	if (req.body === void 0 || req.body === null) return false;
-	return Boolean(req.readableEnded);
-}
-function synthesizeBody(body) {
-	if (Buffer.isBuffer(body) || body instanceof Uint8Array) return { body };
-	if (typeof body === "string") return { body };
-	if (typeof body === "object" && body !== null) return {
-		body: JSON.stringify(body),
-		contentType: "application/json"
-	};
-	return {};
-}
-
-//#endregion
-export { createExpressNodeHandler };
-//# sourceMappingURL=express-fetch-bridge.mjs.map

package/dist/v2/runtime/endpoints/express-fetch-bridge.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"express-fetch-bridge.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express-fetch-bridge.ts"],"sourcesContent":["/**\n * Express-aware Node ↔ Fetch bridge.\n *\n * When Express body-parsing middleware (e.g. `express.json()`) runs before the\n * CopilotKit router, the Node request stream is already consumed and `req.body`\n * holds the parsed content. The generic `createCopilotNodeHandler` (which uses\n * `@remix-run/node-fetch-server`) would hang because it tries to read from the\n * exhausted stream.\n *\n * This module detects the pre-parsed case and re-serialises `req.body` into the\n * Fetch `Request`, falling back to the generic `createCopilotNodeHandler` when the\n * stream is still available.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { sendResponse } from \"@remix-run/node-fetch-server\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nconst METHODS_WITHOUT_BODY = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\nexport type ExpressNodeHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\n/**\n * Creates a Node HTTP handler from a fetch handler, with Express body-parser\n * compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.\n *\n * When the body stream hasn't been consumed, delegates to the generic\n * `createCopilotNodeHandler`. Only intercepts when Express middleware has\n * pre-parsed the body.\n */\nexport function createExpressNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): ExpressNodeHandler {\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    const method = (req.method ?? \"GET\").toUpperCase();\n\n    // Fast path: if no body parser consumed the stream, use the generic handler.\n    if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) {\n      return nodeHandler(req, res);\n    }\n\n    // Slow path: body was consumed by Express middleware — rebuild the Request.\n    try {\n      const fetchReq = buildPreParsedRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Express fetch bridge (pre-parsed path)\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by an Express body parser.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n): Request {\n  const expressReq = req as IncomingMessage & { body?: unknown };\n  const method = (req.method ?? \"GET\").toUpperCase();\n\n  const protocol = (req as any).protocol || \"http\";\n  const host = req.headers.host ?? \"localhost\";\n  const url = `${protocol}://${host}${(req as any).originalUrl ?? req.url ?? \"\"}`;\n\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n\n  // Wire an AbortSignal so client disconnects propagate to the fetch handler\n  const controller = new AbortController();\n  res.on(\"close\", () => {\n    if (!res.writableFinished) controller.abort();\n  });\n\n  const init: RequestInit & { duplex?: \"half\" } = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(expressReq.body);\n  if (contentType) {\n    headers.set(\"content-type\", contentType);\n  }\n  headers.delete(\"content-length\");\n  if (body !== undefined) {\n    init.body = body;\n  }\n\n  return new Request(url, init);\n}\n\nfunction hasPreParsedBody(req: IncomingMessage & { body?: unknown }): boolean {\n  if (req.body === undefined || req.body === null) return false;\n\n  // Only `readableEnded` means \"a parser drained this stream to its end\".\n  // `req.complete` and the private `_readableState.ended` are set by the HTTP\n  // parser once the socket has all the bytes, whether or not anything read them.\n  //\n  // That distinction matters because `req.body` being set does not prove a parser\n  // ran: body-parser 1.x (Express 4) assigns `req.body = req.body || {}` before\n  // its own content-type checks, so a request it declines to parse — multipart\n  // upload, text/plain — reaches us with `req.body === {}` and a full, unread\n  // stream. Treating that as pre-parsed rebuilt the request from `{}` and\n  // dropped the real payload.\n  return Boolean(req.readableEnded);\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    // Buffer/Uint8Array<ArrayBufferLike> are valid fetch bodies at runtime,\n    // but the DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return { body: body as BodyInit };\n  }\n  if (typeof body === \"string\") {\n    return { body };\n  }\n  if (typeof body === \"object\" && body !== null) {\n    return { body: JSON.stringify(body), contentType: \"application/json\" };\n  }\n  return {};\n}\n"],"mappings":";;;;;;AAoBA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;;;;;;;;;AAehE,SAAgB,yBACd,SACoB;CACpB,MAAM,cAAc,yBAAyB,QAAQ;AAErD,QAAO,OAAO,KAAsB,QAAwB;EAC1D,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAGlD,MAAI,qBAAqB,IAAI,OAAO,IAAI,CAAC,iBAAiB,IAAI,CAC5D,QAAO,YAAY,KAAK,IAAI;AAI9B,MAAI;AAGF,SAAM,aAAa,KADF,MAAM,QADN,sBAAsB,KAAK,IAAI,CACR,CACP;WAC1B,KAAc;AACrB,UAAO,MAAM,EAAE,KAAK,EAAE,kDAAkD;AACxE,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;;;;AAUxC,SAAS,sBACP,KACA,KACS;CACT,MAAM,aAAa;CACnB,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAIlD,MAAM,MAAM,GAFM,IAAY,YAAY,OAElB,KADX,IAAI,QAAQ,QAAQ,cACI,IAAY,eAAe,IAAI,OAAO;CAE3E,MAAM,UAAU,IAAI,SAAS;AAC7B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,QAAQ,EAAE;AACtD,MAAI,UAAU,OAAW;AACzB,MAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,KAAK,MAAO,SAAQ,OAAO,KAAK,EAAE;MAE7C,SAAQ,IAAI,KAAK,MAAM;;CAK3B,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAA0C;EAC9C;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,WAAW,KAAK;AAC7D,KAAI,YACF,SAAQ,IAAI,gBAAgB,YAAY;AAE1C,SAAQ,OAAO,iBAAiB;AAChC,KAAI,SAAS,OACX,MAAK,OAAO;AAGd,QAAO,IAAI,QAAQ,KAAK,KAAK;;AAG/B,SAAS,iBAAiB,KAAoD;AAC5E,KAAI,IAAI,SAAS,UAAa,IAAI,SAAS,KAAM,QAAO;AAYxD,QAAO,QAAQ,IAAI,cAAc;;AAGnC,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAG3C,QAAO,EAAQ,MAAkB;AAEnC,KAAI,OAAO,SAAS,SAClB,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;EAAE,MAAM,KAAK,UAAU,KAAK;EAAE,aAAa;EAAoB;AAExE,QAAO,EAAE"}