@copilotkit/shared 1.70.1 → 1.70.3

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.70.1";
+var version = "1.70.3";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.70.1";
+var version = "1.70.3";
 
 //#endregion
 export { version };

package/dist/telemetry/index.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_telemetry_disabled = require('./telemetry-disabled.cjs');
+const require_sampling = require('./sampling.cjs');
+const require_lambda_client = require('./lambda-client.cjs');
+const require_telemetry_client = require('./telemetry-client.cjs');
+
+exports.TELEMETRY_EMITTER_V1 = require_sampling.TELEMETRY_EMITTER_V1;
+exports.TELEMETRY_EMITTER_V2 = require_sampling.TELEMETRY_EMITTER_V2;
+exports.TelemetryClient = require_telemetry_client.TelemetryClient;
+exports.computeSamplingMeta = require_sampling.computeSamplingMeta;
+exports.firstNonBlankTelemetryId = require_lambda_client.firstNonBlankTelemetryId;
+exports.isTelemetryDisabled = require_telemetry_disabled.isTelemetryDisabled;
+exports.lambdaClient = require_lambda_client.lambdaClient;
+exports.parseAndWarnTelemetryId = require_lambda_client.parseAndWarnTelemetryId;
+exports.parseTelemetryIdFromLicense = require_lambda_client.parseTelemetryIdFromLicense;

package/dist/telemetry/index.d.cts

@@ -0,0 +1,5 @@
+import { isTelemetryDisabled } from "./telemetry-disabled.cjs";
+import { SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TelemetryEmitter, TelemetryTransport, computeSamplingMeta } from "./sampling.cjs";
+import { LambdaSendOptions, firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.cjs";
+import { TelemetryCapture, TelemetryClient, TelemetryIdentity } from "./telemetry-client.cjs";
+export { type LambdaSendOptions, SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TelemetryCapture, TelemetryClient, TelemetryEmitter, TelemetryIdentity, TelemetryTransport, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };

package/dist/telemetry/index.d.mts

@@ -1,3 +1,5 @@
-import { TelemetryCapture, TelemetryClient, TelemetryIdentity, isTelemetryDisabled } from "./telemetry-client.mjs";
+import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
 import { SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TelemetryEmitter, TelemetryTransport, computeSamplingMeta } from "./sampling.mjs";
-import { LambdaSendOptions, firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.mjs";
+import { LambdaSendOptions, firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.mjs";
+import { TelemetryCapture, TelemetryClient, TelemetryIdentity } from "./telemetry-client.mjs";
+export { type LambdaSendOptions, SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TelemetryCapture, TelemetryClient, TelemetryEmitter, TelemetryIdentity, TelemetryTransport, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };

package/dist/telemetry/index.mjs

@@ -0,0 +1,6 @@
+import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
+import { TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, computeSamplingMeta } from "./sampling.mjs";
+import { firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.mjs";
+import { TelemetryClient } from "./telemetry-client.mjs";
+
+export { TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TelemetryClient, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };

package/dist/telemetry/telemetry-client.cjs

@@ -1,20 +1,12 @@
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_utils = require('./utils.cjs');
-const require_lambda_client = require('./lambda-client.cjs');
+const require_telemetry_disabled = require('./telemetry-disabled.cjs');
 const require_sampling = require('./sampling.cjs');
+const require_lambda_client = require('./lambda-client.cjs');
+const require_utils = require('./utils.cjs');
 let uuid = require("uuid");
 let _segment_analytics_node = require("@segment/analytics-node");
 
 //#region src/telemetry/telemetry-client.ts
-/**
-* Checks if telemetry is disabled via environment variables.
-* Users can opt out by setting:
-* - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
-* - DO_NOT_TRACK=true or DO_NOT_TRACK=1
-*/
-function isTelemetryDisabled() {
-	return process.env.COPILOTKIT_TELEMETRY_DISABLED === "true" || process.env.COPILOTKIT_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "true" || process.env.DO_NOT_TRACK === "1";
-}
 var TelemetryClient = class {
 	constructor({ packageName, packageVersion, telemetryDisabled, telemetryBaseUrl, sampleRate }) {
 		this.globalProperties = {};
@@ -27,7 +19,7 @@ var TelemetryClient = class {
 		this.anonymousId = `anon_${(0, uuid.v4)()}`;
 		this.packageName = packageName;
 		this.packageVersion = packageVersion;
-		this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();
+		this.telemetryDisabled = telemetryDisabled || require_telemetry_disabled.isTelemetryDisabled();
 		if (this.telemetryDisabled) return;
 		this.setSampleRate(sampleRate);
 		this.segment = new _segment_analytics_node.Analytics({ writeKey: process.env.COPILOTKIT_SEGMENT_WRITE_KEY || "n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja" });
@@ -163,5 +155,4 @@ var TelemetryClient = class {
 
 //#endregion
 exports.TelemetryClient = TelemetryClient;
-exports.isTelemetryDisabled = isTelemetryDisabled;
 //# sourceMappingURL=telemetry-client.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.cjs","names":["Analytics","computeSamplingMeta","TELEMETRY_EMITTER_V1","flattenObject","lambdaClient","firstNonBlankTelemetryId","parseAndWarnTelemetryId"],"sources":["../../src/telemetry/telemetry-client.ts"],"sourcesContent":["import { Analytics } from \"@segment/analytics-node\";\nimport type { AnalyticsEvents } from \"./events\";\nimport { flattenObject } from \"./utils\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport {\n  firstNonBlankTelemetryId,\n  lambdaClient,\n  parseAndWarnTelemetryId,\n} from \"./lambda-client\";\nimport { computeSamplingMeta, TELEMETRY_EMITTER_V1 } from \"./sampling\";\n\n/**\n * Checks if telemetry is disabled via environment variables.\n * Users can opt out by setting:\n * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1\n * - DO_NOT_TRACK=true or DO_NOT_TRACK=1\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\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 class TelemetryClient {\n  segment: Analytics | undefined;\n  globalProperties: Record<string, any> = {};\n  cloudConfiguration: { publicApiKey: string; baseUrl: string } | null = null;\n  // EIP / Intelligence license token (Ed25519-signed JWT). The lambda\n  // client decodes its payload to extract telemetry_id. Customer API\n  // keys are NOT used here — they flow only into Segment.\n  private licenseToken: string | null = null;\n  // Standalone analytics identity. This stays separate from the effective\n  // identity so legacy callers continue sending only their license token to\n  // the Lambda transport.\n  private telemetryId: string | null = null;\n  // License-derived identity used only as sampling authority. A standalone\n  // telemetry id remains a transport claim and does not bypass sampleRate.\n  private licenseTelemetryId: string | null = null;\n  packageName: string;\n  packageVersion: string;\n  private telemetryDisabled: boolean = false;\n  // Client-side sampling rate for anonymous events. Identified events\n  // (those whose license token yielded a telemetry_id) bypass the gate\n  // entirely. Applied uniformly to both the lambda sink and Segment —\n  // one dice roll per capture, both sinks see the same decision.\n  private sampleRate: number = 0.05;\n  private anonymousId = `anon_${uuidv4()}`;\n\n  constructor({\n    packageName,\n    packageVersion,\n    telemetryDisabled,\n    telemetryBaseUrl,\n    sampleRate,\n  }: {\n    packageName: string;\n    packageVersion: string;\n    telemetryDisabled?: boolean;\n    telemetryBaseUrl?: string;\n    sampleRate?: number;\n  }) {\n    this.packageName = packageName;\n    this.packageVersion = packageVersion;\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n\n    if (this.telemetryDisabled) {\n      return;\n    }\n\n    this.setSampleRate(sampleRate);\n\n    // eslint-disable-next-line\n    const writeKey =\n      process.env.COPILOTKIT_SEGMENT_WRITE_KEY ||\n      \"n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja\";\n\n    this.segment = new Analytics({\n      writeKey,\n    });\n\n    this.setGlobalProperties({\n      \"copilotkit.package.name\": packageName,\n      \"copilotkit.package.version\": packageVersion,\n    });\n  }\n\n  private shouldSendEvent() {\n    const randomNumber = Math.random();\n    return randomNumber < this.sampleRate;\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) {\n      return;\n    }\n\n    // Callers without license-derived sampling authority are gated by\n    // sampleRate. Legacy license tokens with telemetry_id always send —\n    // the volume is bounded by paying-customer count and full fidelity\n    // per identified customer is worth the marginal cost.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) {\n      return;\n    }\n\n    // Sampling metadata is computed in ./sampling so this client and the\n    // v2 runtime client can't drift apart again — see the note there.\n    const samplingMeta = computeSamplingMeta({\n      telemetryId: identity.licenseTelemetryId,\n      sampleRate: this.sampleRate,\n    });\n\n    // Everything below travels identically on both copies of this event.\n    // The event id is what makes the dual-write dedupable downstream:\n    // one capture() produces one id, stamped on the lambda copy and the\n    // Segment copy alike, so consumers no longer have to infer the\n    // duplication from $lib or from which fields happen to be present\n    // (OSS-1019).\n    const eventMeta = {\n      ...samplingMeta,\n      telemetry_emitter: TELEMETRY_EMITTER_V1,\n      telemetry_event_id: uuidv4(),\n    };\n\n    const flattenedProperties = flattenObject(properties);\n    const propertiesWithGlobal: Record<string, any> = {\n      ...this.globalProperties,\n      ...eventMeta,\n      telemetry_transport: \"segment\",\n      ...flattenedProperties,\n    };\n    const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal)\n      .sort()\n      .reduce(\n        (obj, key) => {\n          obj[key] = propertiesWithGlobal[key];\n          return obj;\n        },\n        {} as Record<string, any>,\n      );\n\n    await lambdaClient.send({\n      event,\n      properties: flattenedProperties,\n      globalProperties: {\n        ...this.globalProperties,\n        ...eventMeta,\n        telemetry_transport: \"lambda\",\n      },\n      packageName: this.packageName,\n      packageVersion: this.packageVersion,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n\n    if (this.segment) {\n      this.segment.track({\n        anonymousId: this.anonymousId,\n        event,\n        properties: { ...orderedPropertiesWithGlobal },\n      });\n    }\n  }\n\n  setGlobalProperties(properties: Record<string, any>) {\n    const flattenedProperties = flattenObject(properties);\n    this.globalProperties = {\n      ...this.globalProperties,\n      ...flattenedProperties,\n    };\n  }\n\n  setCloudConfiguration(properties: { publicApiKey: string; baseUrl: string }) {\n    this.cloudConfiguration = properties;\n\n    this.setGlobalProperties({\n      cloud: {\n        publicApiKey: properties.publicApiKey,\n        baseUrl: properties.baseUrl,\n      },\n    });\n  }\n\n  /**\n   * Atomically configure standalone, legacy, or anonymous telemetry identity.\n   *\n   * A standalone id takes transport precedence over a supplied legacy license\n   * token, but only a license-derived id grants sampling authority. Neither\n   * value is added to event properties.\n   *\n   * @param identity - One standalone id, one legacy license token, or neither.\n   */\n  setTelemetryIdentity(identity: {\n    telemetryId?: string;\n    licenseToken?: string;\n  }): 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  /**\n   * Configure legacy license-derived telemetry identity.\n   *\n   * @param licenseToken - License token whose telemetry claim identifies sends.\n   */\n  setLicenseToken(licenseToken: string) {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /**\n   * Create an immutable capture scope for one runtime.\n   *\n   * The scope shares this client's sinks, process-wide opt-out, global\n   * properties, and sampling settings, but snapshots transport identity and\n   * license-derived sampling authority. Constructing another runtime cannot\n   * rewrite an existing scope.\n   *\n   * @param identity - The runtime's construction-time telemetry identity.\n   * @returns A capture-only client bound to that identity.\n   */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n\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  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 ?? 0.05;\n\n    // eslint-disable-next-line\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      // eslint-disable-next-line\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 — especially important\n    // since the default is now 0.05, making env-var overrides more common.\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    // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n    // sampleWeight) is computed per capture() in ./sampling. Only license-\n    // authorized events get effectiveSampleRate=1; standalone transport\n    // identity stays in the sampled population.\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"telemetry-client.cjs","names":["isTelemetryDisabled","Analytics","computeSamplingMeta","TELEMETRY_EMITTER_V1","flattenObject","lambdaClient","firstNonBlankTelemetryId","parseAndWarnTelemetryId"],"sources":["../../src/telemetry/telemetry-client.ts"],"sourcesContent":["import { Analytics } from \"@segment/analytics-node\";\nimport type { AnalyticsEvents } from \"./events\";\nimport { flattenObject } from \"./utils\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport {\n  firstNonBlankTelemetryId,\n  lambdaClient,\n  parseAndWarnTelemetryId,\n} from \"./lambda-client\";\nimport { computeSamplingMeta, TELEMETRY_EMITTER_V1 } from \"./sampling\";\nimport { isTelemetryDisabled } from \"./telemetry-disabled\";\n\nexport { isTelemetryDisabled };\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 class TelemetryClient {\n  segment: Analytics | undefined;\n  globalProperties: Record<string, any> = {};\n  cloudConfiguration: { publicApiKey: string; baseUrl: string } | null = null;\n  // EIP / Intelligence license token (Ed25519-signed JWT). The lambda\n  // client decodes its payload to extract telemetry_id. Customer API\n  // keys are NOT used here — they flow only into Segment.\n  private licenseToken: string | null = null;\n  // Standalone analytics identity. This stays separate from the effective\n  // identity so legacy callers continue sending only their license token to\n  // the Lambda transport.\n  private telemetryId: string | null = null;\n  // License-derived identity used only as sampling authority. A standalone\n  // telemetry id remains a transport claim and does not bypass sampleRate.\n  private licenseTelemetryId: string | null = null;\n  packageName: string;\n  packageVersion: string;\n  private telemetryDisabled: boolean = false;\n  // Client-side sampling rate for anonymous events. Identified events\n  // (those whose license token yielded a telemetry_id) bypass the gate\n  // entirely. Applied uniformly to both the lambda sink and Segment —\n  // one dice roll per capture, both sinks see the same decision.\n  private sampleRate: number = 0.05;\n  private anonymousId = `anon_${uuidv4()}`;\n\n  constructor({\n    packageName,\n    packageVersion,\n    telemetryDisabled,\n    telemetryBaseUrl,\n    sampleRate,\n  }: {\n    packageName: string;\n    packageVersion: string;\n    telemetryDisabled?: boolean;\n    telemetryBaseUrl?: string;\n    sampleRate?: number;\n  }) {\n    this.packageName = packageName;\n    this.packageVersion = packageVersion;\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n\n    if (this.telemetryDisabled) {\n      return;\n    }\n\n    this.setSampleRate(sampleRate);\n\n    // eslint-disable-next-line\n    const writeKey =\n      process.env.COPILOTKIT_SEGMENT_WRITE_KEY ||\n      \"n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja\";\n\n    this.segment = new Analytics({\n      writeKey,\n    });\n\n    this.setGlobalProperties({\n      \"copilotkit.package.name\": packageName,\n      \"copilotkit.package.version\": packageVersion,\n    });\n  }\n\n  private shouldSendEvent() {\n    const randomNumber = Math.random();\n    return randomNumber < this.sampleRate;\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) {\n      return;\n    }\n\n    // Callers without license-derived sampling authority are gated by\n    // sampleRate. Legacy license tokens with telemetry_id always send —\n    // the volume is bounded by paying-customer count and full fidelity\n    // per identified customer is worth the marginal cost.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) {\n      return;\n    }\n\n    // Sampling metadata is computed in ./sampling so this client and the\n    // v2 runtime client can't drift apart again — see the note there.\n    const samplingMeta = computeSamplingMeta({\n      telemetryId: identity.licenseTelemetryId,\n      sampleRate: this.sampleRate,\n    });\n\n    // Everything below travels identically on both copies of this event.\n    // The event id is what makes the dual-write dedupable downstream:\n    // one capture() produces one id, stamped on the lambda copy and the\n    // Segment copy alike, so consumers no longer have to infer the\n    // duplication from $lib or from which fields happen to be present\n    // (OSS-1019).\n    const eventMeta = {\n      ...samplingMeta,\n      telemetry_emitter: TELEMETRY_EMITTER_V1,\n      telemetry_event_id: uuidv4(),\n    };\n\n    const flattenedProperties = flattenObject(properties);\n    const propertiesWithGlobal: Record<string, any> = {\n      ...this.globalProperties,\n      ...eventMeta,\n      telemetry_transport: \"segment\",\n      ...flattenedProperties,\n    };\n    const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal)\n      .sort()\n      .reduce(\n        (obj, key) => {\n          obj[key] = propertiesWithGlobal[key];\n          return obj;\n        },\n        {} as Record<string, any>,\n      );\n\n    await lambdaClient.send({\n      event,\n      properties: flattenedProperties,\n      globalProperties: {\n        ...this.globalProperties,\n        ...eventMeta,\n        telemetry_transport: \"lambda\",\n      },\n      packageName: this.packageName,\n      packageVersion: this.packageVersion,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n\n    if (this.segment) {\n      this.segment.track({\n        anonymousId: this.anonymousId,\n        event,\n        properties: { ...orderedPropertiesWithGlobal },\n      });\n    }\n  }\n\n  setGlobalProperties(properties: Record<string, any>) {\n    const flattenedProperties = flattenObject(properties);\n    this.globalProperties = {\n      ...this.globalProperties,\n      ...flattenedProperties,\n    };\n  }\n\n  setCloudConfiguration(properties: { publicApiKey: string; baseUrl: string }) {\n    this.cloudConfiguration = properties;\n\n    this.setGlobalProperties({\n      cloud: {\n        publicApiKey: properties.publicApiKey,\n        baseUrl: properties.baseUrl,\n      },\n    });\n  }\n\n  /**\n   * Atomically configure standalone, legacy, or anonymous telemetry identity.\n   *\n   * A standalone id takes transport precedence over a supplied legacy license\n   * token, but only a license-derived id grants sampling authority. Neither\n   * value is added to event properties.\n   *\n   * @param identity - One standalone id, one legacy license token, or neither.\n   */\n  setTelemetryIdentity(identity: {\n    telemetryId?: string;\n    licenseToken?: string;\n  }): 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  /**\n   * Configure legacy license-derived telemetry identity.\n   *\n   * @param licenseToken - License token whose telemetry claim identifies sends.\n   */\n  setLicenseToken(licenseToken: string) {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /**\n   * Create an immutable capture scope for one runtime.\n   *\n   * The scope shares this client's sinks, process-wide opt-out, global\n   * properties, and sampling settings, but snapshots transport identity and\n   * license-derived sampling authority. Constructing another runtime cannot\n   * rewrite an existing scope.\n   *\n   * @param identity - The runtime's construction-time telemetry identity.\n   * @returns A capture-only client bound to that identity.\n   */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n\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  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 ?? 0.05;\n\n    // eslint-disable-next-line\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      // eslint-disable-next-line\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 — especially important\n    // since the default is now 0.05, making env-var overrides more common.\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    // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n    // sampleWeight) is computed per capture() in ./sampling. Only license-\n    // authorized events get effectiveSampleRate=1; standalone transport\n    // identity stays in the sampled population.\n  }\n}\n"],"mappings":"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"}

package/dist/telemetry/telemetry-client.d.cts

@@ -1,14 +1,8 @@
+import { isTelemetryDisabled } from "./telemetry-disabled.cjs";
 import { AnalyticsEvents } from "./events.cjs";
 import { Analytics } from "@segment/analytics-node";
 
 //#region src/telemetry/telemetry-client.d.ts
-/**
- * Checks if telemetry is disabled via environment variables.
- * Users can opt out by setting:
- * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
- * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
- */
-declare function isTelemetryDisabled(): boolean;
 /** Transport identity and sampling authority resolved for one runtime. */
 interface TelemetryIdentity {
   telemetryId?: string;
@@ -89,5 +83,5 @@ declare class TelemetryClient {
   private setSampleRate;
 }
 //#endregion
-export { TelemetryCapture, TelemetryClient, TelemetryIdentity, isTelemetryDisabled };
+export { TelemetryCapture, TelemetryClient, TelemetryIdentity };
 //# sourceMappingURL=telemetry-client.d.cts.map

package/dist/telemetry/telemetry-client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.d.cts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;AAiBA;;;;iBAAgB,mBAAA,CAAA;AAahB;AAAA,UAAiB,iBAAA;EACf,WAAA;EACA,YAAA;AAAA;AAIF;AAAA,UAAiB,gBAAA;EACf,OAAA,iBAAwB,eAAA,EACtB,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;AAAA;AAAA,cASQ,eAAA;EACX,OAAA,EAAS,SAAA;EACT,gBAAA,EAAkB,MAAA;EAClB,kBAAA;IAAsB,YAAA;IAAsB,OAAA;EAAA;EAAA,QAIpC,YAAA;EAAA,QAIA,WAAA;EAAA,QAGA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAKA,UAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA,UAAA;EAAA;EAAA,QA2BM,eAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA4Ed,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA7F5B;;;;;;;;;EAiH9B,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAtL0C;;;;;EAmM5C,eAAA,CAAgB,YAAA;EArLR;;;;;;;;;;;EAoMR,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}
+{"version":3,"file":"telemetry-client.d.cts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;UAeiB,iBAAA;EACf,WAAA;EACA,YAAA;AAAA;;UAIe,gBAAA;EACf,OAAA,iBAAwB,eAAA,EACtB,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;AAAA;AAAA,cASQ,eAAA;EACX,OAAA,EAAS,SAAA;EACT,gBAAA,EAAkB,MAAA;EAClB,kBAAA;IAAsB,YAAA;IAAsB,OAAA;EAAA;EAAA,QAIpC,YAAA;EAAA,QAIA,WAAA;EAAA,QAGA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAKA,UAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA,UAAA;EAAA;EAAA,QA2BM,eAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA4Ed,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA7F5C;;;;;;;;;EAiHd,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAtLoB;;;;;EAmMtB,eAAA,CAAgB,YAAA;EAtLhB;;;;;;;;;;;EAqMA,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}

package/dist/telemetry/telemetry-client.d.mts

@@ -1,14 +1,8 @@
+import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
 import { AnalyticsEvents } from "./events.mjs";
 import { Analytics } from "@segment/analytics-node";
 
 //#region src/telemetry/telemetry-client.d.ts
-/**
- * Checks if telemetry is disabled via environment variables.
- * Users can opt out by setting:
- * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
- * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
- */
-declare function isTelemetryDisabled(): boolean;
 /** Transport identity and sampling authority resolved for one runtime. */
 interface TelemetryIdentity {
   telemetryId?: string;
@@ -89,5 +83,5 @@ declare class TelemetryClient {
   private setSampleRate;
 }
 //#endregion
-export { TelemetryCapture, TelemetryClient, TelemetryIdentity, isTelemetryDisabled };
+export { TelemetryCapture, TelemetryClient, TelemetryIdentity };
 //# sourceMappingURL=telemetry-client.d.mts.map

package/dist/telemetry/telemetry-client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.d.mts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;AAiBA;;;;iBAAgB,mBAAA,CAAA;AAahB;AAAA,UAAiB,iBAAA;EACf,WAAA;EACA,YAAA;AAAA;AAIF;AAAA,UAAiB,gBAAA;EACf,OAAA,iBAAwB,eAAA,EACtB,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;AAAA;AAAA,cASQ,eAAA;EACX,OAAA,EAAS,SAAA;EACT,gBAAA,EAAkB,MAAA;EAClB,kBAAA;IAAsB,YAAA;IAAsB,OAAA;EAAA;EAAA,QAIpC,YAAA;EAAA,QAIA,WAAA;EAAA,QAGA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAKA,UAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA,UAAA;EAAA;EAAA,QA2BM,eAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA4Ed,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA7F5B;;;;;;;;;EAiH9B,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAtL0C;;;;;EAmM5C,eAAA,CAAgB,YAAA;EArLR;;;;;;;;;;;EAoMR,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}
+{"version":3,"file":"telemetry-client.d.mts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;UAeiB,iBAAA;EACf,WAAA;EACA,YAAA;AAAA;;UAIe,gBAAA;EACf,OAAA,iBAAwB,eAAA,EACtB,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;AAAA;AAAA,cASQ,eAAA;EACX,OAAA,EAAS,SAAA;EACT,gBAAA,EAAkB,MAAA;EAClB,kBAAA;IAAsB,YAAA;IAAsB,OAAA;EAAA;EAAA,QAIpC,YAAA;EAAA,QAIA,WAAA;EAAA,QAGA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAKA,UAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA,UAAA;EAAA;EAAA,QA2BM,eAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA4Ed,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA7F5C;;;;;;;;;EAiHd,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAtLoB;;;;;EAmMtB,eAAA,CAAgB,YAAA;EAtLhB;;;;;;;;;;;EAqMA,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}

package/dist/telemetry/telemetry-client.mjs

@@ -1,19 +1,11 @@
-import { flattenObject } from "./utils.mjs";
-import { firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId } from "./lambda-client.mjs";
+import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
 import { TELEMETRY_EMITTER_V1, computeSamplingMeta } from "./sampling.mjs";
+import { firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId } from "./lambda-client.mjs";
+import { flattenObject } from "./utils.mjs";
 import { v4 } from "uuid";
 import { Analytics } from "@segment/analytics-node";
 
 //#region src/telemetry/telemetry-client.ts
-/**
-* Checks if telemetry is disabled via environment variables.
-* Users can opt out by setting:
-* - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
-* - DO_NOT_TRACK=true or DO_NOT_TRACK=1
-*/
-function isTelemetryDisabled() {
-	return process.env.COPILOTKIT_TELEMETRY_DISABLED === "true" || process.env.COPILOTKIT_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "true" || process.env.DO_NOT_TRACK === "1";
-}
 var TelemetryClient = class {
 	constructor({ packageName, packageVersion, telemetryDisabled, telemetryBaseUrl, sampleRate }) {
 		this.globalProperties = {};
@@ -161,5 +153,5 @@ var TelemetryClient = class {
 };
 
 //#endregion
-export { TelemetryClient, isTelemetryDisabled };
+export { TelemetryClient };
 //# sourceMappingURL=telemetry-client.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry-client.mjs","names":["uuidv4"],"sources":["../../src/telemetry/telemetry-client.ts"],"sourcesContent":["import { Analytics } from \"@segment/analytics-node\";\nimport type { AnalyticsEvents } from \"./events\";\nimport { flattenObject } from \"./utils\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport {\n  firstNonBlankTelemetryId,\n  lambdaClient,\n  parseAndWarnTelemetryId,\n} from \"./lambda-client\";\nimport { computeSamplingMeta, TELEMETRY_EMITTER_V1 } from \"./sampling\";\n\n/**\n * Checks if telemetry is disabled via environment variables.\n * Users can opt out by setting:\n * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1\n * - DO_NOT_TRACK=true or DO_NOT_TRACK=1\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\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 class TelemetryClient {\n  segment: Analytics | undefined;\n  globalProperties: Record<string, any> = {};\n  cloudConfiguration: { publicApiKey: string; baseUrl: string } | null = null;\n  // EIP / Intelligence license token (Ed25519-signed JWT). The lambda\n  // client decodes its payload to extract telemetry_id. Customer API\n  // keys are NOT used here — they flow only into Segment.\n  private licenseToken: string | null = null;\n  // Standalone analytics identity. This stays separate from the effective\n  // identity so legacy callers continue sending only their license token to\n  // the Lambda transport.\n  private telemetryId: string | null = null;\n  // License-derived identity used only as sampling authority. A standalone\n  // telemetry id remains a transport claim and does not bypass sampleRate.\n  private licenseTelemetryId: string | null = null;\n  packageName: string;\n  packageVersion: string;\n  private telemetryDisabled: boolean = false;\n  // Client-side sampling rate for anonymous events. Identified events\n  // (those whose license token yielded a telemetry_id) bypass the gate\n  // entirely. Applied uniformly to both the lambda sink and Segment —\n  // one dice roll per capture, both sinks see the same decision.\n  private sampleRate: number = 0.05;\n  private anonymousId = `anon_${uuidv4()}`;\n\n  constructor({\n    packageName,\n    packageVersion,\n    telemetryDisabled,\n    telemetryBaseUrl,\n    sampleRate,\n  }: {\n    packageName: string;\n    packageVersion: string;\n    telemetryDisabled?: boolean;\n    telemetryBaseUrl?: string;\n    sampleRate?: number;\n  }) {\n    this.packageName = packageName;\n    this.packageVersion = packageVersion;\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n\n    if (this.telemetryDisabled) {\n      return;\n    }\n\n    this.setSampleRate(sampleRate);\n\n    // eslint-disable-next-line\n    const writeKey =\n      process.env.COPILOTKIT_SEGMENT_WRITE_KEY ||\n      \"n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja\";\n\n    this.segment = new Analytics({\n      writeKey,\n    });\n\n    this.setGlobalProperties({\n      \"copilotkit.package.name\": packageName,\n      \"copilotkit.package.version\": packageVersion,\n    });\n  }\n\n  private shouldSendEvent() {\n    const randomNumber = Math.random();\n    return randomNumber < this.sampleRate;\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) {\n      return;\n    }\n\n    // Callers without license-derived sampling authority are gated by\n    // sampleRate. Legacy license tokens with telemetry_id always send —\n    // the volume is bounded by paying-customer count and full fidelity\n    // per identified customer is worth the marginal cost.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) {\n      return;\n    }\n\n    // Sampling metadata is computed in ./sampling so this client and the\n    // v2 runtime client can't drift apart again — see the note there.\n    const samplingMeta = computeSamplingMeta({\n      telemetryId: identity.licenseTelemetryId,\n      sampleRate: this.sampleRate,\n    });\n\n    // Everything below travels identically on both copies of this event.\n    // The event id is what makes the dual-write dedupable downstream:\n    // one capture() produces one id, stamped on the lambda copy and the\n    // Segment copy alike, so consumers no longer have to infer the\n    // duplication from $lib or from which fields happen to be present\n    // (OSS-1019).\n    const eventMeta = {\n      ...samplingMeta,\n      telemetry_emitter: TELEMETRY_EMITTER_V1,\n      telemetry_event_id: uuidv4(),\n    };\n\n    const flattenedProperties = flattenObject(properties);\n    const propertiesWithGlobal: Record<string, any> = {\n      ...this.globalProperties,\n      ...eventMeta,\n      telemetry_transport: \"segment\",\n      ...flattenedProperties,\n    };\n    const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal)\n      .sort()\n      .reduce(\n        (obj, key) => {\n          obj[key] = propertiesWithGlobal[key];\n          return obj;\n        },\n        {} as Record<string, any>,\n      );\n\n    await lambdaClient.send({\n      event,\n      properties: flattenedProperties,\n      globalProperties: {\n        ...this.globalProperties,\n        ...eventMeta,\n        telemetry_transport: \"lambda\",\n      },\n      packageName: this.packageName,\n      packageVersion: this.packageVersion,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n\n    if (this.segment) {\n      this.segment.track({\n        anonymousId: this.anonymousId,\n        event,\n        properties: { ...orderedPropertiesWithGlobal },\n      });\n    }\n  }\n\n  setGlobalProperties(properties: Record<string, any>) {\n    const flattenedProperties = flattenObject(properties);\n    this.globalProperties = {\n      ...this.globalProperties,\n      ...flattenedProperties,\n    };\n  }\n\n  setCloudConfiguration(properties: { publicApiKey: string; baseUrl: string }) {\n    this.cloudConfiguration = properties;\n\n    this.setGlobalProperties({\n      cloud: {\n        publicApiKey: properties.publicApiKey,\n        baseUrl: properties.baseUrl,\n      },\n    });\n  }\n\n  /**\n   * Atomically configure standalone, legacy, or anonymous telemetry identity.\n   *\n   * A standalone id takes transport precedence over a supplied legacy license\n   * token, but only a license-derived id grants sampling authority. Neither\n   * value is added to event properties.\n   *\n   * @param identity - One standalone id, one legacy license token, or neither.\n   */\n  setTelemetryIdentity(identity: {\n    telemetryId?: string;\n    licenseToken?: string;\n  }): 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  /**\n   * Configure legacy license-derived telemetry identity.\n   *\n   * @param licenseToken - License token whose telemetry claim identifies sends.\n   */\n  setLicenseToken(licenseToken: string) {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /**\n   * Create an immutable capture scope for one runtime.\n   *\n   * The scope shares this client's sinks, process-wide opt-out, global\n   * properties, and sampling settings, but snapshots transport identity and\n   * license-derived sampling authority. Constructing another runtime cannot\n   * rewrite an existing scope.\n   *\n   * @param identity - The runtime's construction-time telemetry identity.\n   * @returns A capture-only client bound to that identity.\n   */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n\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  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 ?? 0.05;\n\n    // eslint-disable-next-line\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      // eslint-disable-next-line\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 — especially important\n    // since the default is now 0.05, making env-var overrides more common.\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    // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n    // sampleWeight) is computed per capture() in ./sampling. Only license-\n    // authorized events get effectiveSampleRate=1; standalone transport\n    // identity stays in the sampled population.\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"telemetry-client.mjs","names":["uuidv4"],"sources":["../../src/telemetry/telemetry-client.ts"],"sourcesContent":["import { Analytics } from \"@segment/analytics-node\";\nimport type { AnalyticsEvents } from \"./events\";\nimport { flattenObject } from \"./utils\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport {\n  firstNonBlankTelemetryId,\n  lambdaClient,\n  parseAndWarnTelemetryId,\n} from \"./lambda-client\";\nimport { computeSamplingMeta, TELEMETRY_EMITTER_V1 } from \"./sampling\";\nimport { isTelemetryDisabled } from \"./telemetry-disabled\";\n\nexport { isTelemetryDisabled };\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 class TelemetryClient {\n  segment: Analytics | undefined;\n  globalProperties: Record<string, any> = {};\n  cloudConfiguration: { publicApiKey: string; baseUrl: string } | null = null;\n  // EIP / Intelligence license token (Ed25519-signed JWT). The lambda\n  // client decodes its payload to extract telemetry_id. Customer API\n  // keys are NOT used here — they flow only into Segment.\n  private licenseToken: string | null = null;\n  // Standalone analytics identity. This stays separate from the effective\n  // identity so legacy callers continue sending only their license token to\n  // the Lambda transport.\n  private telemetryId: string | null = null;\n  // License-derived identity used only as sampling authority. A standalone\n  // telemetry id remains a transport claim and does not bypass sampleRate.\n  private licenseTelemetryId: string | null = null;\n  packageName: string;\n  packageVersion: string;\n  private telemetryDisabled: boolean = false;\n  // Client-side sampling rate for anonymous events. Identified events\n  // (those whose license token yielded a telemetry_id) bypass the gate\n  // entirely. Applied uniformly to both the lambda sink and Segment —\n  // one dice roll per capture, both sinks see the same decision.\n  private sampleRate: number = 0.05;\n  private anonymousId = `anon_${uuidv4()}`;\n\n  constructor({\n    packageName,\n    packageVersion,\n    telemetryDisabled,\n    telemetryBaseUrl,\n    sampleRate,\n  }: {\n    packageName: string;\n    packageVersion: string;\n    telemetryDisabled?: boolean;\n    telemetryBaseUrl?: string;\n    sampleRate?: number;\n  }) {\n    this.packageName = packageName;\n    this.packageVersion = packageVersion;\n    this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();\n\n    if (this.telemetryDisabled) {\n      return;\n    }\n\n    this.setSampleRate(sampleRate);\n\n    // eslint-disable-next-line\n    const writeKey =\n      process.env.COPILOTKIT_SEGMENT_WRITE_KEY ||\n      \"n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja\";\n\n    this.segment = new Analytics({\n      writeKey,\n    });\n\n    this.setGlobalProperties({\n      \"copilotkit.package.name\": packageName,\n      \"copilotkit.package.version\": packageVersion,\n    });\n  }\n\n  private shouldSendEvent() {\n    const randomNumber = Math.random();\n    return randomNumber < this.sampleRate;\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) {\n      return;\n    }\n\n    // Callers without license-derived sampling authority are gated by\n    // sampleRate. Legacy license tokens with telemetry_id always send —\n    // the volume is bounded by paying-customer count and full fidelity\n    // per identified customer is worth the marginal cost.\n    if (!identity.licenseTelemetryId && !this.shouldSendEvent()) {\n      return;\n    }\n\n    // Sampling metadata is computed in ./sampling so this client and the\n    // v2 runtime client can't drift apart again — see the note there.\n    const samplingMeta = computeSamplingMeta({\n      telemetryId: identity.licenseTelemetryId,\n      sampleRate: this.sampleRate,\n    });\n\n    // Everything below travels identically on both copies of this event.\n    // The event id is what makes the dual-write dedupable downstream:\n    // one capture() produces one id, stamped on the lambda copy and the\n    // Segment copy alike, so consumers no longer have to infer the\n    // duplication from $lib or from which fields happen to be present\n    // (OSS-1019).\n    const eventMeta = {\n      ...samplingMeta,\n      telemetry_emitter: TELEMETRY_EMITTER_V1,\n      telemetry_event_id: uuidv4(),\n    };\n\n    const flattenedProperties = flattenObject(properties);\n    const propertiesWithGlobal: Record<string, any> = {\n      ...this.globalProperties,\n      ...eventMeta,\n      telemetry_transport: \"segment\",\n      ...flattenedProperties,\n    };\n    const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal)\n      .sort()\n      .reduce(\n        (obj, key) => {\n          obj[key] = propertiesWithGlobal[key];\n          return obj;\n        },\n        {} as Record<string, any>,\n      );\n\n    await lambdaClient.send({\n      event,\n      properties: flattenedProperties,\n      globalProperties: {\n        ...this.globalProperties,\n        ...eventMeta,\n        telemetry_transport: \"lambda\",\n      },\n      packageName: this.packageName,\n      packageVersion: this.packageVersion,\n      telemetryId: identity.telemetryId ?? undefined,\n      licenseToken: identity.licenseToken ?? undefined,\n    });\n\n    if (this.segment) {\n      this.segment.track({\n        anonymousId: this.anonymousId,\n        event,\n        properties: { ...orderedPropertiesWithGlobal },\n      });\n    }\n  }\n\n  setGlobalProperties(properties: Record<string, any>) {\n    const flattenedProperties = flattenObject(properties);\n    this.globalProperties = {\n      ...this.globalProperties,\n      ...flattenedProperties,\n    };\n  }\n\n  setCloudConfiguration(properties: { publicApiKey: string; baseUrl: string }) {\n    this.cloudConfiguration = properties;\n\n    this.setGlobalProperties({\n      cloud: {\n        publicApiKey: properties.publicApiKey,\n        baseUrl: properties.baseUrl,\n      },\n    });\n  }\n\n  /**\n   * Atomically configure standalone, legacy, or anonymous telemetry identity.\n   *\n   * A standalone id takes transport precedence over a supplied legacy license\n   * token, but only a license-derived id grants sampling authority. Neither\n   * value is added to event properties.\n   *\n   * @param identity - One standalone id, one legacy license token, or neither.\n   */\n  setTelemetryIdentity(identity: {\n    telemetryId?: string;\n    licenseToken?: string;\n  }): 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  /**\n   * Configure legacy license-derived telemetry identity.\n   *\n   * @param licenseToken - License token whose telemetry claim identifies sends.\n   */\n  setLicenseToken(licenseToken: string) {\n    this.setTelemetryIdentity({ licenseToken });\n  }\n\n  /**\n   * Create an immutable capture scope for one runtime.\n   *\n   * The scope shares this client's sinks, process-wide opt-out, global\n   * properties, and sampling settings, but snapshots transport identity and\n   * license-derived sampling authority. Constructing another runtime cannot\n   * rewrite an existing scope.\n   *\n   * @param identity - The runtime's construction-time telemetry identity.\n   * @returns A capture-only client bound to that identity.\n   */\n  createScope(identity: TelemetryIdentity): TelemetryCapture {\n    const resolvedIdentity = this.resolveTelemetryIdentity(identity);\n\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  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 ?? 0.05;\n\n    // eslint-disable-next-line\n    if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) {\n      // eslint-disable-next-line\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 — especially important\n    // since the default is now 0.05, making env-var overrides more common.\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    // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n    // sampleWeight) is computed per capture() in ./sampling. Only license-\n    // authorized events get effectiveSampleRate=1; standalone transport\n    // identity stays in the sampled population.\n  }\n}\n"],"mappings":"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"}

package/dist/telemetry/telemetry-disabled.cjs

@@ -0,0 +1,20 @@
+
+//#region src/telemetry/telemetry-disabled.ts
+/**
+* Checks if telemetry is disabled via environment variables.
+* Users can opt out by setting:
+* - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
+* - DO_NOT_TRACK=true or DO_NOT_TRACK=1
+*
+* Lives in its own module so that the browser-facing root entry can
+* re-export it without pulling in `telemetry-client.ts`, whose
+* `@segment/analytics-node` import drags Node built-ins into browser
+* bundler module graphs. See the note in `../index.ts`.
+*/
+function isTelemetryDisabled() {
+	return process.env.COPILOTKIT_TELEMETRY_DISABLED === "true" || process.env.COPILOTKIT_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "true" || process.env.DO_NOT_TRACK === "1";
+}
+
+//#endregion
+exports.isTelemetryDisabled = isTelemetryDisabled;
+//# sourceMappingURL=telemetry-disabled.cjs.map

package/dist/telemetry/telemetry-disabled.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-disabled.cjs","names":[],"sources":["../../src/telemetry/telemetry-disabled.ts"],"sourcesContent":["/**\n * Checks if telemetry is disabled via environment variables.\n * Users can opt out by setting:\n * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1\n * - DO_NOT_TRACK=true or DO_NOT_TRACK=1\n *\n * Lives in its own module so that the browser-facing root entry can\n * re-export it without pulling in `telemetry-client.ts`, whose\n * `@segment/analytics-node` import drags Node built-ins into browser\n * bundler module graphs. See the note in `../index.ts`.\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"],"mappings":";;;;;;;;;;;;;AAWA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB"}

package/dist/telemetry/telemetry-disabled.d.cts

@@ -0,0 +1,16 @@
+//#region src/telemetry/telemetry-disabled.d.ts
+/**
+ * Checks if telemetry is disabled via environment variables.
+ * Users can opt out by setting:
+ * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
+ * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
+ *
+ * Lives in its own module so that the browser-facing root entry can
+ * re-export it without pulling in `telemetry-client.ts`, whose
+ * `@segment/analytics-node` import drags Node built-ins into browser
+ * bundler module graphs. See the note in `../index.ts`.
+ */
+declare function isTelemetryDisabled(): boolean;
+//#endregion
+export { isTelemetryDisabled };
+//# sourceMappingURL=telemetry-disabled.d.cts.map

package/dist/telemetry/telemetry-disabled.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-disabled.d.cts","names":[],"sources":["../../src/telemetry/telemetry-disabled.ts"],"mappings":";;AAWA;;;;;;;;;;iBAAgB,mBAAA,CAAA"}

package/dist/telemetry/telemetry-disabled.d.mts

@@ -0,0 +1,16 @@
+//#region src/telemetry/telemetry-disabled.d.ts
+/**
+ * Checks if telemetry is disabled via environment variables.
+ * Users can opt out by setting:
+ * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
+ * - DO_NOT_TRACK=true or DO_NOT_TRACK=1
+ *
+ * Lives in its own module so that the browser-facing root entry can
+ * re-export it without pulling in `telemetry-client.ts`, whose
+ * `@segment/analytics-node` import drags Node built-ins into browser
+ * bundler module graphs. See the note in `../index.ts`.
+ */
+declare function isTelemetryDisabled(): boolean;
+//#endregion
+export { isTelemetryDisabled };
+//# sourceMappingURL=telemetry-disabled.d.mts.map

package/dist/telemetry/telemetry-disabled.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-disabled.d.mts","names":[],"sources":["../../src/telemetry/telemetry-disabled.ts"],"mappings":";;AAWA;;;;;;;;;;iBAAgB,mBAAA,CAAA"}

package/dist/telemetry/telemetry-disabled.mjs

@@ -0,0 +1,19 @@
+//#region src/telemetry/telemetry-disabled.ts
+/**
+* Checks if telemetry is disabled via environment variables.
+* Users can opt out by setting:
+* - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1
+* - DO_NOT_TRACK=true or DO_NOT_TRACK=1
+*
+* Lives in its own module so that the browser-facing root entry can
+* re-export it without pulling in `telemetry-client.ts`, whose
+* `@segment/analytics-node` import drags Node built-ins into browser
+* bundler module graphs. See the note in `../index.ts`.
+*/
+function isTelemetryDisabled() {
+	return process.env.COPILOTKIT_TELEMETRY_DISABLED === "true" || process.env.COPILOTKIT_TELEMETRY_DISABLED === "1" || process.env.DO_NOT_TRACK === "true" || process.env.DO_NOT_TRACK === "1";
+}
+
+//#endregion
+export { isTelemetryDisabled };
+//# sourceMappingURL=telemetry-disabled.mjs.map

package/dist/telemetry/telemetry-disabled.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-disabled.mjs","names":[],"sources":["../../src/telemetry/telemetry-disabled.ts"],"sourcesContent":["/**\n * Checks if telemetry is disabled via environment variables.\n * Users can opt out by setting:\n * - COPILOTKIT_TELEMETRY_DISABLED=true or COPILOTKIT_TELEMETRY_DISABLED=1\n * - DO_NOT_TRACK=true or DO_NOT_TRACK=1\n *\n * Lives in its own module so that the browser-facing root entry can\n * re-export it without pulling in `telemetry-client.ts`, whose\n * `@segment/analytics-node` import drags Node built-ins into browser\n * bundler module graphs. See the note in `../index.ts`.\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"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,sBAA+B;AAC7C,QACG,QAAQ,IACN,kCAAkC,UACpC,QAAQ,IACN,kCAAkC,OACpC,QAAQ,IAA2C,iBAClD,UACD,QAAQ,IAA2C,iBAAiB"}

package/dist/utils/index.cjs

@@ -5,6 +5,7 @@ const require_console_styling = require('./console-styling.cjs');
 const require_errors = require('./errors.cjs');
 const require_json_schema = require('./json-schema.cjs');
 const require_inspector_metadata = require('./inspector-metadata.cjs');
+const require_inspector_learning = require('./inspector-learning.cjs');
 const require_inspector_visibility = require('./inspector-visibility.cjs');
 const require_types = require('./types.cjs');
 const require_random_id = require('./random-id.cjs');

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["PartialJSON"],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./inspector-visibility\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}
+{"version":3,"file":"index.cjs","names":["PartialJSON"],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./inspector-learning\";\nexport * from \"./inspector-visibility\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}

package/dist/utils/index.d.cts

@@ -4,8 +4,9 @@ import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled,
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.cjs";
 import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.cjs";
 import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.cjs";
+import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.cjs";
 import { InspectorVisibilityOptions, shouldEnableInspector } from "./inspector-visibility.cjs";
-import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo } from "./types.cjs";
+import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo } from "./types.cjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.cjs";
 import { readBody } from "./requests.cjs";
 

package/dist/utils/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;;AAmBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;;;AAoBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}

package/dist/utils/index.d.mts

@@ -4,8 +4,9 @@ import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled,
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.mjs";
 import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.mjs";
 import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.mjs";
+import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.mjs";
 import { InspectorVisibilityOptions, shouldEnableInspector } from "./inspector-visibility.mjs";
-import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo } from "./types.mjs";
+import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo } from "./types.mjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.mjs";
 import { readBody } from "./requests.mjs";
 

package/dist/utils/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;;AAmBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;;;AAoBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}

package/dist/utils/index.mjs

@@ -4,6 +4,7 @@ import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled,
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.mjs";
 import { actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.mjs";
 import { parseInspectorMetadataV1 } from "./inspector-metadata.mjs";
+import { parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.mjs";
 import { shouldEnableInspector } from "./inspector-visibility.mjs";
 import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE } from "./types.mjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.mjs";

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./inspector-visibility\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAAS,YAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./inspector-learning\";\nexport * from \"./inspector-visibility\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAAS,YAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}