@copilotkit/shared 2.0.0-rc.2 → 2.0.0-rc.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -14
- package/dist/a2ui-envelope.cjs +2 -2
- package/dist/a2ui-envelope.cjs.map +1 -1
- package/dist/a2ui-envelope.d.cts +1 -1
- package/dist/a2ui-envelope.d.cts.map +1 -1
- package/dist/a2ui-envelope.d.mts +1 -1
- package/dist/a2ui-envelope.d.mts.map +1 -1
- package/dist/a2ui-envelope.mjs +2 -2
- package/dist/a2ui-envelope.mjs.map +1 -1
- package/dist/a2ui-prompts.cjs +21 -62
- package/dist/a2ui-prompts.cjs.map +1 -1
- package/dist/a2ui-prompts.d.cts +8 -1
- package/dist/a2ui-prompts.d.cts.map +1 -1
- package/dist/a2ui-prompts.d.mts +8 -1
- package/dist/a2ui-prompts.d.mts.map +1 -1
- package/dist/a2ui-prompts.mjs +22 -62
- package/dist/a2ui-prompts.mjs.map +1 -1
- package/dist/attachments/types.d.cts +1 -3
- package/dist/attachments/types.d.cts.map +1 -1
- package/dist/attachments/types.d.mts +1 -3
- package/dist/attachments/types.d.mts.map +1 -1
- package/dist/finalize-events.cjs +16 -0
- package/dist/finalize-events.cjs.map +1 -1
- package/dist/finalize-events.d.cts.map +1 -1
- package/dist/finalize-events.d.mts.map +1 -1
- package/dist/finalize-events.mjs +16 -0
- package/dist/finalize-events.mjs.map +1 -1
- package/dist/generative-ui/basic-functions.cjs +1 -1
- package/dist/generative-ui/basic-functions.cjs.map +1 -1
- package/dist/generative-ui/basic-functions.mjs +1 -1
- package/dist/generative-ui/basic-functions.mjs.map +1 -1
- package/dist/generative-ui/child-refs.cjs +3 -3
- package/dist/generative-ui/child-refs.cjs.map +1 -1
- package/dist/generative-ui/child-refs.d.cts.map +1 -1
- package/dist/generative-ui/child-refs.d.mts.map +1 -1
- package/dist/generative-ui/child-refs.mjs +3 -3
- package/dist/generative-ui/child-refs.mjs.map +1 -1
- package/dist/generative-ui/compact-schema.cjs +187 -0
- package/dist/generative-ui/compact-schema.cjs.map +1 -0
- package/dist/generative-ui/compact-schema.d.cts +55 -0
- package/dist/generative-ui/compact-schema.d.cts.map +1 -0
- package/dist/generative-ui/compact-schema.d.mts +55 -0
- package/dist/generative-ui/compact-schema.d.mts.map +1 -0
- package/dist/generative-ui/compact-schema.mjs +185 -0
- package/dist/generative-ui/compact-schema.mjs.map +1 -0
- package/dist/generative-ui/prompt-spec.cjs +225 -0
- package/dist/generative-ui/prompt-spec.cjs.map +1 -0
- package/dist/generative-ui/prompt-spec.d.cts +94 -0
- package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
- package/dist/generative-ui/prompt-spec.d.mts +94 -0
- package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
- package/dist/generative-ui/prompt-spec.mjs +220 -0
- package/dist/generative-ui/prompt-spec.mjs.map +1 -0
- package/dist/generative-ui/prompt.cjs +10 -36
- package/dist/generative-ui/prompt.cjs.map +1 -1
- package/dist/generative-ui/prompt.d.cts +2 -1
- package/dist/generative-ui/prompt.d.cts.map +1 -1
- package/dist/generative-ui/prompt.d.mts +2 -1
- package/dist/generative-ui/prompt.d.mts.map +1 -1
- package/dist/generative-ui/prompt.mjs +12 -38
- package/dist/generative-ui/prompt.mjs.map +1 -1
- package/dist/generative-ui/render-ui-args.cjs +1 -0
- package/dist/generative-ui/render-ui-args.cjs.map +1 -1
- package/dist/generative-ui/render-ui-args.d.cts.map +1 -1
- package/dist/generative-ui/render-ui-args.d.mts.map +1 -1
- package/dist/generative-ui/render-ui-args.mjs +1 -0
- package/dist/generative-ui/render-ui-args.mjs.map +1 -1
- package/dist/generative-ui/schema-render.cjs +242 -0
- package/dist/generative-ui/schema-render.cjs.map +1 -0
- package/dist/generative-ui/schema-render.d.cts +44 -0
- package/dist/generative-ui/schema-render.d.cts.map +1 -0
- package/dist/generative-ui/schema-render.d.mts +44 -0
- package/dist/generative-ui/schema-render.d.mts.map +1 -0
- package/dist/generative-ui/schema-render.mjs +239 -0
- package/dist/generative-ui/schema-render.mjs.map +1 -0
- package/dist/generative-ui/types.cjs +2 -2
- package/dist/generative-ui/types.cjs.map +1 -1
- package/dist/generative-ui/types.d.cts +7 -7
- package/dist/generative-ui/types.d.cts.map +1 -1
- package/dist/generative-ui/types.d.mts +7 -7
- package/dist/generative-ui/types.d.mts.map +1 -1
- package/dist/generative-ui/types.mjs +2 -2
- package/dist/generative-ui/types.mjs.map +1 -1
- package/dist/generative-ui/validate-operation.cjs +2 -2
- package/dist/generative-ui/validate-operation.cjs.map +1 -1
- package/dist/generative-ui/validate-operation.mjs +2 -2
- package/dist/generative-ui/validate-operation.mjs.map +1 -1
- package/dist/index.cjs +18 -15
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +11 -10
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +11 -10
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +10 -8
- package/dist/index.mjs.map +1 -1
- package/dist/index.umd.js +864 -450
- package/dist/index.umd.js.map +1 -1
- package/dist/package.cjs +1 -1
- package/dist/package.mjs +1 -1
- package/dist/standard-schema.cjs +20 -7
- package/dist/standard-schema.cjs.map +1 -1
- package/dist/standard-schema.d.cts +15 -16
- package/dist/standard-schema.d.cts.map +1 -1
- package/dist/standard-schema.d.mts +15 -16
- package/dist/standard-schema.d.mts.map +1 -1
- package/dist/standard-schema.mjs +20 -8
- package/dist/standard-schema.mjs.map +1 -1
- package/dist/telemetry/lambda-client.cjs +1 -1
- package/dist/telemetry/lambda-client.cjs.map +1 -1
- package/dist/telemetry/lambda-client.d.cts.map +1 -1
- package/dist/telemetry/lambda-client.d.mts.map +1 -1
- package/dist/telemetry/lambda-client.mjs +1 -1
- package/dist/telemetry/lambda-client.mjs.map +1 -1
- package/dist/telemetry/telemetry-disabled.cjs +3 -6
- package/dist/telemetry/telemetry-disabled.cjs.map +1 -1
- package/dist/telemetry/telemetry-disabled.d.cts +0 -5
- package/dist/telemetry/telemetry-disabled.d.cts.map +1 -1
- package/dist/telemetry/telemetry-disabled.d.mts +0 -5
- package/dist/telemetry/telemetry-disabled.d.mts.map +1 -1
- package/dist/telemetry/telemetry-disabled.mjs +4 -6
- package/dist/telemetry/telemetry-disabled.mjs.map +1 -1
- package/dist/types/message.d.cts +1 -18
- package/dist/types/message.d.cts.map +1 -1
- package/dist/types/message.d.mts +1 -18
- package/dist/types/message.d.mts.map +1 -1
- package/dist/utils/errors.cjs +5 -42
- package/dist/utils/errors.cjs.map +1 -1
- package/dist/utils/errors.d.cts +16 -34
- package/dist/utils/errors.d.cts.map +1 -1
- package/dist/utils/errors.d.mts +16 -34
- package/dist/utils/errors.d.mts.map +1 -1
- package/dist/utils/errors.mjs +6 -41
- package/dist/utils/errors.mjs.map +1 -1
- package/dist/utils/index.cjs +1 -2
- package/dist/utils/index.cjs.map +1 -1
- package/dist/utils/index.d.cts +5 -6
- package/dist/utils/index.d.cts.map +1 -1
- package/dist/utils/index.d.mts +5 -6
- package/dist/utils/index.d.mts.map +1 -1
- package/dist/utils/index.mjs +5 -6
- package/dist/utils/index.mjs.map +1 -1
- package/dist/utils/inspector-visibility.cjs +25 -3
- package/dist/utils/inspector-visibility.cjs.map +1 -1
- package/dist/utils/inspector-visibility.d.cts +26 -3
- package/dist/utils/inspector-visibility.d.cts.map +1 -1
- package/dist/utils/inspector-visibility.d.mts +26 -3
- package/dist/utils/inspector-visibility.d.mts.map +1 -1
- package/dist/utils/inspector-visibility.mjs +25 -4
- package/dist/utils/inspector-visibility.mjs.map +1 -1
- package/dist/utils/json-schema.cjs +4 -79
- package/dist/utils/json-schema.cjs.map +1 -1
- package/dist/utils/json-schema.d.cts +1 -4
- package/dist/utils/json-schema.d.cts.map +1 -1
- package/dist/utils/json-schema.d.mts +1 -4
- package/dist/utils/json-schema.d.mts.map +1 -1
- package/dist/utils/json-schema.mjs +5 -78
- package/dist/utils/json-schema.mjs.map +1 -1
- package/dist/utils/process-env.cjs +14 -0
- package/dist/utils/process-env.cjs.map +1 -0
- package/dist/utils/process-env.d.cts +10 -0
- package/dist/utils/process-env.d.cts.map +1 -0
- package/dist/utils/process-env.d.mts +10 -0
- package/dist/utils/process-env.d.mts.map +1 -0
- package/dist/utils/process-env.mjs +13 -0
- package/dist/utils/process-env.mjs.map +1 -0
- package/dist/utils/random-id.cjs +13 -26
- package/dist/utils/random-id.cjs.map +1 -1
- package/dist/utils/random-id.d.cts +6 -3
- package/dist/utils/random-id.d.cts.map +1 -1
- package/dist/utils/random-id.d.mts +6 -3
- package/dist/utils/random-id.d.mts.map +1 -1
- package/dist/utils/random-id.mjs +14 -25
- package/dist/utils/random-id.mjs.map +1 -1
- package/package.json +8 -32
- package/scripts/verify-cjs-exports.cjs +1 -1
- package/src/__tests__/a2ui-envelope.test.ts +18 -13
- package/src/__tests__/a2ui-prompts.test.ts +47 -14
- package/src/__tests__/fixtures/prompt-goldens.json +354 -0
- package/src/__tests__/prompt-spec.test.ts +191 -0
- package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
- package/src/__tests__/schema-render.test.ts +245 -0
- package/src/__tests__/standard-schema.test.ts +61 -101
- package/src/a2ui-envelope.ts +7 -6
- package/src/a2ui-prompts.ts +47 -96
- package/src/attachments/types.ts +1 -3
- package/src/finalize-events.ts +16 -0
- package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
- package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
- package/src/generative-ui/basic-functions.ts +1 -1
- package/src/generative-ui/child-refs.ts +5 -4
- package/src/generative-ui/compact-schema.ts +277 -0
- package/src/generative-ui/index.ts +3 -0
- package/src/generative-ui/prompt-spec.ts +335 -0
- package/src/generative-ui/prompt.ts +25 -75
- package/src/generative-ui/render-ui-args.ts +3 -0
- package/src/generative-ui/schema-render.ts +377 -0
- package/src/generative-ui/types.ts +10 -7
- package/src/generative-ui/validate-operation.ts +2 -2
- package/src/index.ts +3 -16
- package/src/standard-schema.ts +24 -27
- package/src/telemetry/lambda-client.ts +8 -3
- package/src/telemetry/model-host.test.ts +2 -5
- package/src/telemetry/telemetry-disabled.ts +7 -12
- package/src/types/message.ts +1 -19
- package/src/utils/__tests__/errors.test.ts +44 -0
- package/src/utils/__tests__/json-schema.test.ts +3 -479
- package/src/utils/__tests__/process-env.test.ts +22 -0
- package/src/utils/__tests__/random-id.test.ts +37 -0
- package/src/utils/errors.ts +28 -85
- package/src/utils/index.ts +1 -2
- package/src/utils/inspector-visibility.test.ts +26 -0
- package/src/utils/inspector-visibility.ts +35 -3
- package/src/utils/json-schema.ts +5 -152
- package/src/utils/process-env.ts +14 -0
- package/src/utils/random-id.ts +17 -37
- package/tsconfig.json +3 -1
- package/tsdown.config.ts +2 -19
- package/dist/event-transforms/index.cjs +0 -15
- package/dist/event-transforms/index.d.cts +0 -4
- package/dist/event-transforms/index.d.mts +0 -4
- package/dist/event-transforms/index.mjs +0 -5
- package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
- package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
- package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
- package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
- package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
- package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
- package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
- package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
- package/dist/event-transforms/recorded-events.cjs +0 -59
- package/dist/event-transforms/recorded-events.cjs.map +0 -1
- package/dist/event-transforms/recorded-events.d.cts +0 -23
- package/dist/event-transforms/recorded-events.d.cts.map +0 -1
- package/dist/event-transforms/recorded-events.d.mts +0 -23
- package/dist/event-transforms/recorded-events.d.mts.map +0 -1
- package/dist/event-transforms/recorded-events.mjs +0 -58
- package/dist/event-transforms/recorded-events.mjs.map +0 -1
- package/dist/telemetry/events.d.cts +0 -72
- package/dist/telemetry/events.d.cts.map +0 -1
- package/dist/telemetry/events.d.mts +0 -72
- package/dist/telemetry/events.d.mts.map +0 -1
- package/dist/telemetry/index.cjs +0 -18
- package/dist/telemetry/index.d.cts +0 -5
- package/dist/telemetry/index.d.mts +0 -5
- package/dist/telemetry/index.mjs +0 -6
- package/dist/telemetry/telemetry-client.cjs +0 -165
- package/dist/telemetry/telemetry-client.cjs.map +0 -1
- package/dist/telemetry/telemetry-client.d.cts +0 -87
- package/dist/telemetry/telemetry-client.d.cts.map +0 -1
- package/dist/telemetry/telemetry-client.d.mts +0 -87
- package/dist/telemetry/telemetry-client.d.mts.map +0 -1
- package/dist/telemetry/telemetry-client.mjs +0 -164
- package/dist/telemetry/telemetry-client.mjs.map +0 -1
- package/dist/telemetry/utils.cjs +0 -14
- package/dist/telemetry/utils.cjs.map +0 -1
- package/dist/telemetry/utils.mjs +0 -13
- package/dist/telemetry/utils.mjs.map +0 -1
- package/dist/utils/conditions.cjs +0 -32
- package/dist/utils/conditions.cjs.map +0 -1
- package/dist/utils/conditions.d.cts +0 -31
- package/dist/utils/conditions.d.cts.map +0 -1
- package/dist/utils/conditions.d.mts +0 -31
- package/dist/utils/conditions.d.mts.map +0 -1
- package/dist/utils/conditions.mjs +0 -31
- package/dist/utils/conditions.mjs.map +0 -1
- package/dist/utils/console-styling.cjs +0 -91
- package/dist/utils/console-styling.cjs.map +0 -1
- package/dist/utils/console-styling.d.cts +0 -65
- package/dist/utils/console-styling.d.cts.map +0 -1
- package/dist/utils/console-styling.d.mts +0 -65
- package/dist/utils/console-styling.d.mts.map +0 -1
- package/dist/utils/console-styling.mjs +0 -85
- package/dist/utils/console-styling.mjs.map +0 -1
- package/src/__tests__/zod-regression.test.ts +0 -319
- package/src/event-transforms/index.ts +0 -5
- package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
- package/src/event-transforms/recorded-events.test.ts +0 -166
- package/src/event-transforms/recorded-events.ts +0 -74
- package/src/telemetry/events.ts +0 -68
- package/src/telemetry/index.ts +0 -9
- package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
- package/src/telemetry/telemetry-client.test.ts +0 -798
- package/src/telemetry/telemetry-client.ts +0 -328
- package/src/telemetry/utils.ts +0 -15
- package/src/utils/__tests__/conditions.test.ts +0 -161
- package/src/utils/conditions.ts +0 -116
- package/src/utils/console-styling.ts +0 -126
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"events.d.mts","names":[],"sources":["../../src/telemetry/events.ts"],"mappings":";;;KAEY,eAAA;EACV,8BAAA,EAAgC,0BAAA;EAChC,qCAAA;IACE,0BAAA;IACA,WAAA;IACA,wBAAA;IACA,sBAAA;IACA,gBAAA;EAAA;EAEF,4CAAA;IAAgD,YAAA;EAAA;EAChD,0CAAA,EAA4C,0BAAA;EAC5C,4CAAA;IACE,YAAA;IACA,KAAA;EAAA;EANA;;;;;EAaF,qCAAA,EAAuC,yBAAA,EARrC;EAUF,uCAAA;IAA2C,SAAA;EAAA;AAAA;;;;AAS7C;;;UAAiB,yBAAA;EAIX;EAFJ,MAAA;EAKyC;EAHzC,IAAA;AAAA;AAAA,UAGe,0BAAA;EACf,aAAA;EACA,aAAA;EACA,YAAA;EACA,eAAA;EACA,YAAA;EACA,wBAAA;EACA,sBAAA;EACA,gBAAA;AAAA;AAAA,UAGe,0BAAA;EAA0B;;;;;;;;;EAUzC,YAAA,GAAe,cAAA;EACf,QAAA;EACA,KAAA;EACA,aAAA;EACA,gBAAA;EACA,YAAA;AAAA"}
|
package/dist/telemetry/index.cjs
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
const require_telemetry_disabled = require('./telemetry-disabled.cjs');
|
|
3
|
-
const require_sampling = require('./sampling.cjs');
|
|
4
|
-
const require_lambda_client = require('./lambda-client.cjs');
|
|
5
|
-
const require_telemetry_client = require('./telemetry-client.cjs');
|
|
6
|
-
|
|
7
|
-
exports.TELEMETRY_EMITTER_V1 = require_sampling.TELEMETRY_EMITTER_V1;
|
|
8
|
-
exports.TELEMETRY_EMITTER_V2 = require_sampling.TELEMETRY_EMITTER_V2;
|
|
9
|
-
exports.TELEMETRY_SURFACE_V1 = require_sampling.TELEMETRY_SURFACE_V1;
|
|
10
|
-
exports.TELEMETRY_SURFACE_V2 = require_sampling.TELEMETRY_SURFACE_V2;
|
|
11
|
-
exports.TelemetryClient = require_telemetry_client.TelemetryClient;
|
|
12
|
-
exports.UNSAMPLED_RATE = require_sampling.UNSAMPLED_RATE;
|
|
13
|
-
exports.computeSamplingMeta = require_sampling.computeSamplingMeta;
|
|
14
|
-
exports.firstNonBlankTelemetryId = require_lambda_client.firstNonBlankTelemetryId;
|
|
15
|
-
exports.isTelemetryDisabled = require_telemetry_disabled.isTelemetryDisabled;
|
|
16
|
-
exports.lambdaClient = require_lambda_client.lambdaClient;
|
|
17
|
-
exports.parseAndWarnTelemetryId = require_lambda_client.parseAndWarnTelemetryId;
|
|
18
|
-
exports.parseTelemetryIdFromLicense = require_lambda_client.parseTelemetryIdFromLicense;
|
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.cjs";
|
|
2
|
-
import { SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, TelemetryEmitter, TelemetrySurface, TelemetryTransport, UNSAMPLED_RATE, computeSamplingMeta } from "./sampling.cjs";
|
|
3
|
-
import { LambdaSendOptions, firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.cjs";
|
|
4
|
-
import { TelemetryCapture, TelemetryClient, TelemetryIdentity } from "./telemetry-client.cjs";
|
|
5
|
-
export { type LambdaSendOptions, SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, TelemetryCapture, TelemetryClient, TelemetryEmitter, TelemetryIdentity, TelemetrySurface, TelemetryTransport, UNSAMPLED_RATE, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };
|
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
|
|
2
|
-
import { SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, TelemetryEmitter, TelemetrySurface, TelemetryTransport, UNSAMPLED_RATE, computeSamplingMeta } from "./sampling.mjs";
|
|
3
|
-
import { LambdaSendOptions, firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.mjs";
|
|
4
|
-
import { TelemetryCapture, TelemetryClient, TelemetryIdentity } from "./telemetry-client.mjs";
|
|
5
|
-
export { type LambdaSendOptions, SamplingMeta, TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, TelemetryCapture, TelemetryClient, TelemetryEmitter, TelemetryIdentity, TelemetrySurface, TelemetryTransport, UNSAMPLED_RATE, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };
|
package/dist/telemetry/index.mjs
DELETED
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
|
|
2
|
-
import { TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, UNSAMPLED_RATE, computeSamplingMeta } from "./sampling.mjs";
|
|
3
|
-
import { firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense } from "./lambda-client.mjs";
|
|
4
|
-
import { TelemetryClient } from "./telemetry-client.mjs";
|
|
5
|
-
|
|
6
|
-
export { TELEMETRY_EMITTER_V1, TELEMETRY_EMITTER_V2, TELEMETRY_SURFACE_V1, TELEMETRY_SURFACE_V2, TelemetryClient, UNSAMPLED_RATE, computeSamplingMeta, firstNonBlankTelemetryId, isTelemetryDisabled, lambdaClient, parseAndWarnTelemetryId, parseTelemetryIdFromLicense };
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
|
|
2
|
-
const require_telemetry_disabled = require('./telemetry-disabled.cjs');
|
|
3
|
-
const require_sampling = require('./sampling.cjs');
|
|
4
|
-
const require_lambda_client = require('./lambda-client.cjs');
|
|
5
|
-
const require_utils = require('./utils.cjs');
|
|
6
|
-
let uuid = require("uuid");
|
|
7
|
-
let _segment_analytics_node = require("@segment/analytics-node");
|
|
8
|
-
|
|
9
|
-
//#region src/telemetry/telemetry-client.ts
|
|
10
|
-
var TelemetryClient = class {
|
|
11
|
-
constructor({ packageName, packageVersion, telemetryDisabled, telemetryBaseUrl, sampleRate }) {
|
|
12
|
-
this.globalProperties = {};
|
|
13
|
-
this.cloudConfiguration = null;
|
|
14
|
-
this.licenseToken = null;
|
|
15
|
-
this.telemetryId = null;
|
|
16
|
-
this.licenseTelemetryId = null;
|
|
17
|
-
this.telemetryDisabled = false;
|
|
18
|
-
this.segmentSampleRate = .05;
|
|
19
|
-
this.anonymousId = `anon_${(0, uuid.v4)()}`;
|
|
20
|
-
this.packageName = packageName;
|
|
21
|
-
this.packageVersion = packageVersion;
|
|
22
|
-
this.telemetryDisabled = telemetryDisabled || require_telemetry_disabled.isTelemetryDisabled();
|
|
23
|
-
if (this.telemetryDisabled) return;
|
|
24
|
-
this.setSampleRate(sampleRate);
|
|
25
|
-
this.segment = new _segment_analytics_node.Analytics({ writeKey: process.env.COPILOTKIT_SEGMENT_WRITE_KEY || "n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja" });
|
|
26
|
-
this.setGlobalProperties({
|
|
27
|
-
"copilotkit.package.name": packageName,
|
|
28
|
-
"copilotkit.package.version": packageVersion
|
|
29
|
-
});
|
|
30
|
-
}
|
|
31
|
-
shouldSendToSegment() {
|
|
32
|
-
return Math.random() < this.segmentSampleRate;
|
|
33
|
-
}
|
|
34
|
-
async capture(event, properties) {
|
|
35
|
-
return this.captureWithIdentity(event, properties, {
|
|
36
|
-
telemetryId: this.telemetryId,
|
|
37
|
-
licenseToken: this.licenseToken,
|
|
38
|
-
licenseTelemetryId: this.licenseTelemetryId
|
|
39
|
-
});
|
|
40
|
-
}
|
|
41
|
-
async captureWithIdentity(event, properties, identity) {
|
|
42
|
-
if (this.telemetryDisabled || require_telemetry_disabled.isTelemetryDisabled()) return;
|
|
43
|
-
const sendToSegment = Boolean(identity.licenseTelemetryId) || this.shouldSendToSegment();
|
|
44
|
-
const lambdaSamplingMeta = require_sampling.computeSamplingMeta({
|
|
45
|
-
telemetryId: identity.licenseTelemetryId,
|
|
46
|
-
sampleRate: require_sampling.UNSAMPLED_RATE
|
|
47
|
-
});
|
|
48
|
-
const segmentSamplingMeta = require_sampling.computeSamplingMeta({
|
|
49
|
-
telemetryId: identity.licenseTelemetryId,
|
|
50
|
-
sampleRate: this.segmentSampleRate
|
|
51
|
-
});
|
|
52
|
-
const eventMeta = {
|
|
53
|
-
telemetry_emitter: require_sampling.TELEMETRY_EMITTER_V1,
|
|
54
|
-
telemetry_surface: require_sampling.TELEMETRY_SURFACE_V1,
|
|
55
|
-
telemetry_event_id: (0, uuid.v4)()
|
|
56
|
-
};
|
|
57
|
-
const flattenedProperties = require_utils.flattenObject(properties);
|
|
58
|
-
const propertiesWithGlobal = {
|
|
59
|
-
...this.globalProperties,
|
|
60
|
-
...eventMeta,
|
|
61
|
-
...segmentSamplingMeta,
|
|
62
|
-
telemetry_transport: "segment",
|
|
63
|
-
...flattenedProperties
|
|
64
|
-
};
|
|
65
|
-
const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal).sort().reduce((obj, key) => {
|
|
66
|
-
obj[key] = propertiesWithGlobal[key];
|
|
67
|
-
return obj;
|
|
68
|
-
}, {});
|
|
69
|
-
await require_lambda_client.lambdaClient.send({
|
|
70
|
-
event,
|
|
71
|
-
properties: flattenedProperties,
|
|
72
|
-
globalProperties: {
|
|
73
|
-
...this.globalProperties,
|
|
74
|
-
...eventMeta,
|
|
75
|
-
...lambdaSamplingMeta,
|
|
76
|
-
telemetry_transport: "lambda"
|
|
77
|
-
},
|
|
78
|
-
packageName: this.packageName,
|
|
79
|
-
packageVersion: this.packageVersion,
|
|
80
|
-
telemetryId: identity.telemetryId ?? void 0,
|
|
81
|
-
licenseToken: identity.licenseToken ?? void 0
|
|
82
|
-
});
|
|
83
|
-
if (this.segment && sendToSegment) this.segment.track({
|
|
84
|
-
anonymousId: this.anonymousId,
|
|
85
|
-
event,
|
|
86
|
-
properties: { ...orderedPropertiesWithGlobal }
|
|
87
|
-
});
|
|
88
|
-
}
|
|
89
|
-
setGlobalProperties(properties) {
|
|
90
|
-
const flattenedProperties = require_utils.flattenObject(properties);
|
|
91
|
-
this.globalProperties = {
|
|
92
|
-
...this.globalProperties,
|
|
93
|
-
...flattenedProperties
|
|
94
|
-
};
|
|
95
|
-
}
|
|
96
|
-
setCloudConfiguration(properties) {
|
|
97
|
-
this.cloudConfiguration = properties;
|
|
98
|
-
this.setGlobalProperties({ cloud: {
|
|
99
|
-
publicApiKey: properties.publicApiKey,
|
|
100
|
-
baseUrl: properties.baseUrl
|
|
101
|
-
} });
|
|
102
|
-
}
|
|
103
|
-
/**
|
|
104
|
-
* Atomically configure standalone, legacy, or anonymous telemetry identity.
|
|
105
|
-
*
|
|
106
|
-
* A standalone id takes transport precedence over a supplied legacy license
|
|
107
|
-
* token, but only a license-derived id grants sampling authority. Neither
|
|
108
|
-
* value is added to event properties.
|
|
109
|
-
*
|
|
110
|
-
* @param identity - One standalone id, one legacy license token, or neither.
|
|
111
|
-
*/
|
|
112
|
-
setTelemetryIdentity(identity) {
|
|
113
|
-
const resolvedIdentity = this.resolveTelemetryIdentity(identity);
|
|
114
|
-
this.telemetryId = resolvedIdentity.telemetryId;
|
|
115
|
-
this.licenseToken = resolvedIdentity.licenseToken;
|
|
116
|
-
this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;
|
|
117
|
-
}
|
|
118
|
-
/**
|
|
119
|
-
* Configure legacy license-derived telemetry identity.
|
|
120
|
-
*
|
|
121
|
-
* @param licenseToken - License token whose telemetry claim identifies sends.
|
|
122
|
-
*/
|
|
123
|
-
setLicenseToken(licenseToken) {
|
|
124
|
-
this.setTelemetryIdentity({ licenseToken });
|
|
125
|
-
}
|
|
126
|
-
/**
|
|
127
|
-
* Create an immutable capture scope for one runtime.
|
|
128
|
-
*
|
|
129
|
-
* The scope shares this client's sinks, process-wide opt-out, global
|
|
130
|
-
* properties, and Segment sampling rate, but snapshots transport identity and
|
|
131
|
-
* license-derived sampling authority. Constructing another runtime cannot
|
|
132
|
-
* rewrite an existing scope.
|
|
133
|
-
*
|
|
134
|
-
* @param identity - The runtime's construction-time telemetry identity.
|
|
135
|
-
* @returns A capture-only client bound to that identity.
|
|
136
|
-
*/
|
|
137
|
-
createScope(identity) {
|
|
138
|
-
const resolvedIdentity = this.resolveTelemetryIdentity(identity);
|
|
139
|
-
return { capture: (event, properties) => this.captureWithIdentity(event, properties, resolvedIdentity) };
|
|
140
|
-
}
|
|
141
|
-
resolveTelemetryIdentity(identity) {
|
|
142
|
-
const telemetryId = require_lambda_client.firstNonBlankTelemetryId(identity.telemetryId);
|
|
143
|
-
if (telemetryId !== void 0) return {
|
|
144
|
-
telemetryId,
|
|
145
|
-
licenseToken: null,
|
|
146
|
-
licenseTelemetryId: null
|
|
147
|
-
};
|
|
148
|
-
return {
|
|
149
|
-
telemetryId: null,
|
|
150
|
-
licenseToken: identity.licenseToken ?? null,
|
|
151
|
-
licenseTelemetryId: identity.licenseToken ? require_lambda_client.parseAndWarnTelemetryId(identity.licenseToken) : null
|
|
152
|
-
};
|
|
153
|
-
}
|
|
154
|
-
setSampleRate(sampleRate) {
|
|
155
|
-
let _sampleRate;
|
|
156
|
-
_sampleRate = sampleRate ?? .05;
|
|
157
|
-
if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);
|
|
158
|
-
if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) throw new Error("Sample rate must be between 0 and 1");
|
|
159
|
-
this.segmentSampleRate = _sampleRate;
|
|
160
|
-
}
|
|
161
|
-
};
|
|
162
|
-
|
|
163
|
-
//#endregion
|
|
164
|
-
exports.TelemetryClient = TelemetryClient;
|
|
165
|
-
//# sourceMappingURL=telemetry-client.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"telemetry-client.cjs","names":["isTelemetryDisabled","Analytics","computeSamplingMeta","UNSAMPLED_RATE","TELEMETRY_EMITTER_V1","TELEMETRY_SURFACE_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 {\n computeSamplingMeta,\n TELEMETRY_EMITTER_V1,\n TELEMETRY_SURFACE_V1,\n UNSAMPLED_RATE,\n} 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 the\n // Segment gate.\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 on the Segment wire\n // only. The lambda sink is ours and takes every event; Segment is\n // billed per event, so the anonymous population stays capped there.\n // Identified events (those whose license token yielded a telemetry_id)\n // bypass the gate on both wires.\n private segmentSampleRate: 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 // Anonymous sampling rate for the Segment wire. Named without the\n // prefix for backward compatibility; the lambda sink ignores it.\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 shouldSendToSegment() {\n const randomNumber = Math.random();\n return randomNumber < this.segmentSampleRate;\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()) {\n return;\n }\n\n // The two wires are gated separately. The lambda sink takes every\n // event: it is CopilotKit-owned, so anonymous volume costs nothing\n // per event there and a real count beats one extrapolated from 5% of\n // the population. Segment is billed per event, so it keeps the gate —\n // callers without license-derived sampling authority are dropped from\n // that copy at segmentSampleRate. Legacy license tokens with a\n // telemetry_id send on both wires: the volume is bounded by\n // paying-customer count and full fidelity per identified customer is\n // worth the marginal cost.\n const sendToSegment =\n Boolean(identity.licenseTelemetryId) || this.shouldSendToSegment();\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 // One call per wire, because the two wires were gated differently and\n // a shared block would overweight the lambda copy by 1/sampleRate.\n const lambdaSamplingMeta = computeSamplingMeta({\n telemetryId: identity.licenseTelemetryId,\n sampleRate: UNSAMPLED_RATE,\n });\n const segmentSamplingMeta = computeSamplingMeta({\n telemetryId: identity.licenseTelemetryId,\n sampleRate: this.segmentSampleRate,\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 telemetry_emitter: TELEMETRY_EMITTER_V1,\n telemetry_surface: TELEMETRY_SURFACE_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 ...segmentSamplingMeta,\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 ...lambdaSamplingMeta,\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 && sendToSegment) {\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 Segment sampling rate, 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 Segment 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.segmentSampleRate = _sampleRate;\n // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n // sampleWeight) is computed per capture() in ./sampling, once per\n // wire. Only license-authorized events get effectiveSampleRate=1 on\n // the Segment copy; standalone transport identity stays in the\n // sampled population there. The lambda copy is always unsampled.\n }\n}\n"],"mappings":"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"}
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.cjs";
|
|
2
|
-
import { AnalyticsEvents } from "./events.cjs";
|
|
3
|
-
import { Analytics } from "@segment/analytics-node";
|
|
4
|
-
|
|
5
|
-
//#region src/telemetry/telemetry-client.d.ts
|
|
6
|
-
/** Transport identity and sampling authority resolved for one runtime. */
|
|
7
|
-
interface TelemetryIdentity {
|
|
8
|
-
telemetryId?: string;
|
|
9
|
-
licenseToken?: string;
|
|
10
|
-
}
|
|
11
|
-
/** Capture-only telemetry client bound to one runtime identity. */
|
|
12
|
-
interface TelemetryCapture {
|
|
13
|
-
capture<K extends keyof AnalyticsEvents>(event: K, properties: AnalyticsEvents[K]): Promise<void>;
|
|
14
|
-
}
|
|
15
|
-
declare class TelemetryClient {
|
|
16
|
-
segment: Analytics | undefined;
|
|
17
|
-
globalProperties: Record<string, any>;
|
|
18
|
-
cloudConfiguration: {
|
|
19
|
-
publicApiKey: string;
|
|
20
|
-
baseUrl: string;
|
|
21
|
-
} | null;
|
|
22
|
-
private licenseToken;
|
|
23
|
-
private telemetryId;
|
|
24
|
-
private licenseTelemetryId;
|
|
25
|
-
packageName: string;
|
|
26
|
-
packageVersion: string;
|
|
27
|
-
private telemetryDisabled;
|
|
28
|
-
private segmentSampleRate;
|
|
29
|
-
private anonymousId;
|
|
30
|
-
constructor({
|
|
31
|
-
packageName,
|
|
32
|
-
packageVersion,
|
|
33
|
-
telemetryDisabled,
|
|
34
|
-
telemetryBaseUrl,
|
|
35
|
-
sampleRate
|
|
36
|
-
}: {
|
|
37
|
-
packageName: string;
|
|
38
|
-
packageVersion: string;
|
|
39
|
-
telemetryDisabled?: boolean;
|
|
40
|
-
telemetryBaseUrl?: string;
|
|
41
|
-
sampleRate?: number;
|
|
42
|
-
});
|
|
43
|
-
private shouldSendToSegment;
|
|
44
|
-
capture<K extends keyof AnalyticsEvents>(event: K, properties: AnalyticsEvents[K]): Promise<void>;
|
|
45
|
-
private captureWithIdentity;
|
|
46
|
-
setGlobalProperties(properties: Record<string, any>): void;
|
|
47
|
-
setCloudConfiguration(properties: {
|
|
48
|
-
publicApiKey: string;
|
|
49
|
-
baseUrl: string;
|
|
50
|
-
}): void;
|
|
51
|
-
/**
|
|
52
|
-
* Atomically configure standalone, legacy, or anonymous telemetry identity.
|
|
53
|
-
*
|
|
54
|
-
* A standalone id takes transport precedence over a supplied legacy license
|
|
55
|
-
* token, but only a license-derived id grants sampling authority. Neither
|
|
56
|
-
* value is added to event properties.
|
|
57
|
-
*
|
|
58
|
-
* @param identity - One standalone id, one legacy license token, or neither.
|
|
59
|
-
*/
|
|
60
|
-
setTelemetryIdentity(identity: {
|
|
61
|
-
telemetryId?: string;
|
|
62
|
-
licenseToken?: string;
|
|
63
|
-
}): void;
|
|
64
|
-
/**
|
|
65
|
-
* Configure legacy license-derived telemetry identity.
|
|
66
|
-
*
|
|
67
|
-
* @param licenseToken - License token whose telemetry claim identifies sends.
|
|
68
|
-
*/
|
|
69
|
-
setLicenseToken(licenseToken: string): void;
|
|
70
|
-
/**
|
|
71
|
-
* Create an immutable capture scope for one runtime.
|
|
72
|
-
*
|
|
73
|
-
* The scope shares this client's sinks, process-wide opt-out, global
|
|
74
|
-
* properties, and Segment sampling rate, but snapshots transport identity and
|
|
75
|
-
* license-derived sampling authority. Constructing another runtime cannot
|
|
76
|
-
* rewrite an existing scope.
|
|
77
|
-
*
|
|
78
|
-
* @param identity - The runtime's construction-time telemetry identity.
|
|
79
|
-
* @returns A capture-only client bound to that identity.
|
|
80
|
-
*/
|
|
81
|
-
createScope(identity: TelemetryIdentity): TelemetryCapture;
|
|
82
|
-
private resolveTelemetryIdentity;
|
|
83
|
-
private setSampleRate;
|
|
84
|
-
}
|
|
85
|
-
//#endregion
|
|
86
|
-
export { TelemetryCapture, TelemetryClient, TelemetryIdentity };
|
|
87
|
-
//# sourceMappingURL=telemetry-client.d.cts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"telemetry-client.d.cts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;UAoBiB,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,QAIA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAMA,iBAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IAGA,UAAA;EAAA;EAAA,QA2BM,mBAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA0Fd,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA3G5C;;;;;;;;;EA+Hd,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAxMoB;;;;;EAqNtB,eAAA,CAAgB,YAAA;EAvMhB;;;;;;;;;;;EAsNA,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
|
|
2
|
-
import { AnalyticsEvents } from "./events.mjs";
|
|
3
|
-
import { Analytics } from "@segment/analytics-node";
|
|
4
|
-
|
|
5
|
-
//#region src/telemetry/telemetry-client.d.ts
|
|
6
|
-
/** Transport identity and sampling authority resolved for one runtime. */
|
|
7
|
-
interface TelemetryIdentity {
|
|
8
|
-
telemetryId?: string;
|
|
9
|
-
licenseToken?: string;
|
|
10
|
-
}
|
|
11
|
-
/** Capture-only telemetry client bound to one runtime identity. */
|
|
12
|
-
interface TelemetryCapture {
|
|
13
|
-
capture<K extends keyof AnalyticsEvents>(event: K, properties: AnalyticsEvents[K]): Promise<void>;
|
|
14
|
-
}
|
|
15
|
-
declare class TelemetryClient {
|
|
16
|
-
segment: Analytics | undefined;
|
|
17
|
-
globalProperties: Record<string, any>;
|
|
18
|
-
cloudConfiguration: {
|
|
19
|
-
publicApiKey: string;
|
|
20
|
-
baseUrl: string;
|
|
21
|
-
} | null;
|
|
22
|
-
private licenseToken;
|
|
23
|
-
private telemetryId;
|
|
24
|
-
private licenseTelemetryId;
|
|
25
|
-
packageName: string;
|
|
26
|
-
packageVersion: string;
|
|
27
|
-
private telemetryDisabled;
|
|
28
|
-
private segmentSampleRate;
|
|
29
|
-
private anonymousId;
|
|
30
|
-
constructor({
|
|
31
|
-
packageName,
|
|
32
|
-
packageVersion,
|
|
33
|
-
telemetryDisabled,
|
|
34
|
-
telemetryBaseUrl,
|
|
35
|
-
sampleRate
|
|
36
|
-
}: {
|
|
37
|
-
packageName: string;
|
|
38
|
-
packageVersion: string;
|
|
39
|
-
telemetryDisabled?: boolean;
|
|
40
|
-
telemetryBaseUrl?: string;
|
|
41
|
-
sampleRate?: number;
|
|
42
|
-
});
|
|
43
|
-
private shouldSendToSegment;
|
|
44
|
-
capture<K extends keyof AnalyticsEvents>(event: K, properties: AnalyticsEvents[K]): Promise<void>;
|
|
45
|
-
private captureWithIdentity;
|
|
46
|
-
setGlobalProperties(properties: Record<string, any>): void;
|
|
47
|
-
setCloudConfiguration(properties: {
|
|
48
|
-
publicApiKey: string;
|
|
49
|
-
baseUrl: string;
|
|
50
|
-
}): void;
|
|
51
|
-
/**
|
|
52
|
-
* Atomically configure standalone, legacy, or anonymous telemetry identity.
|
|
53
|
-
*
|
|
54
|
-
* A standalone id takes transport precedence over a supplied legacy license
|
|
55
|
-
* token, but only a license-derived id grants sampling authority. Neither
|
|
56
|
-
* value is added to event properties.
|
|
57
|
-
*
|
|
58
|
-
* @param identity - One standalone id, one legacy license token, or neither.
|
|
59
|
-
*/
|
|
60
|
-
setTelemetryIdentity(identity: {
|
|
61
|
-
telemetryId?: string;
|
|
62
|
-
licenseToken?: string;
|
|
63
|
-
}): void;
|
|
64
|
-
/**
|
|
65
|
-
* Configure legacy license-derived telemetry identity.
|
|
66
|
-
*
|
|
67
|
-
* @param licenseToken - License token whose telemetry claim identifies sends.
|
|
68
|
-
*/
|
|
69
|
-
setLicenseToken(licenseToken: string): void;
|
|
70
|
-
/**
|
|
71
|
-
* Create an immutable capture scope for one runtime.
|
|
72
|
-
*
|
|
73
|
-
* The scope shares this client's sinks, process-wide opt-out, global
|
|
74
|
-
* properties, and Segment sampling rate, but snapshots transport identity and
|
|
75
|
-
* license-derived sampling authority. Constructing another runtime cannot
|
|
76
|
-
* rewrite an existing scope.
|
|
77
|
-
*
|
|
78
|
-
* @param identity - The runtime's construction-time telemetry identity.
|
|
79
|
-
* @returns A capture-only client bound to that identity.
|
|
80
|
-
*/
|
|
81
|
-
createScope(identity: TelemetryIdentity): TelemetryCapture;
|
|
82
|
-
private resolveTelemetryIdentity;
|
|
83
|
-
private setSampleRate;
|
|
84
|
-
}
|
|
85
|
-
//#endregion
|
|
86
|
-
export { TelemetryCapture, TelemetryClient, TelemetryIdentity };
|
|
87
|
-
//# sourceMappingURL=telemetry-client.d.mts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"telemetry-client.d.mts","names":[],"sources":["../../src/telemetry/telemetry-client.ts"],"mappings":";;;;;;UAoBiB,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,QAIA,kBAAA;EACR,WAAA;EACA,cAAA;EAAA,QACQ,iBAAA;EAAA,QAMA,iBAAA;EAAA,QACA,WAAA;;IAGN,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IACA;EAAA;IAEA,WAAA;IACA,cAAA;IACA,iBAAA;IACA,gBAAA;IAGA,UAAA;EAAA;EAAA,QA2BM,mBAAA;EAKF,OAAA,iBAAwB,eAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,UAAA,EAAY,eAAA,CAAgB,CAAA,IAC3B,OAAA;EAAA,QAQW,mBAAA;EA0Fd,mBAAA,CAAoB,UAAA,EAAY,MAAA;EAQhC,qBAAA,CAAsB,UAAA;IAAc,YAAA;IAAsB,OAAA;EAAA;EA3G5C;;;;;;;;;EA+Hd,oBAAA,CAAqB,QAAA;IACnB,WAAA;IACA,YAAA;EAAA;EAxMoB;;;;;EAqNtB,eAAA,CAAgB,YAAA;EAvMhB;;;;;;;;;;;EAsNA,WAAA,CAAY,QAAA,EAAU,iBAAA,GAAoB,gBAAA;EAAA,QAWlC,wBAAA;EAAA,QAqBA,aAAA;AAAA"}
|
|
@@ -1,164 +0,0 @@
|
|
|
1
|
-
import { isTelemetryDisabled } from "./telemetry-disabled.mjs";
|
|
2
|
-
import { TELEMETRY_EMITTER_V1, TELEMETRY_SURFACE_V1, UNSAMPLED_RATE, computeSamplingMeta } from "./sampling.mjs";
|
|
3
|
-
import { firstNonBlankTelemetryId, lambdaClient, parseAndWarnTelemetryId } from "./lambda-client.mjs";
|
|
4
|
-
import { flattenObject } from "./utils.mjs";
|
|
5
|
-
import { v4 } from "uuid";
|
|
6
|
-
import { Analytics } from "@segment/analytics-node";
|
|
7
|
-
|
|
8
|
-
//#region src/telemetry/telemetry-client.ts
|
|
9
|
-
var TelemetryClient = class {
|
|
10
|
-
constructor({ packageName, packageVersion, telemetryDisabled, telemetryBaseUrl, sampleRate }) {
|
|
11
|
-
this.globalProperties = {};
|
|
12
|
-
this.cloudConfiguration = null;
|
|
13
|
-
this.licenseToken = null;
|
|
14
|
-
this.telemetryId = null;
|
|
15
|
-
this.licenseTelemetryId = null;
|
|
16
|
-
this.telemetryDisabled = false;
|
|
17
|
-
this.segmentSampleRate = .05;
|
|
18
|
-
this.anonymousId = `anon_${v4()}`;
|
|
19
|
-
this.packageName = packageName;
|
|
20
|
-
this.packageVersion = packageVersion;
|
|
21
|
-
this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();
|
|
22
|
-
if (this.telemetryDisabled) return;
|
|
23
|
-
this.setSampleRate(sampleRate);
|
|
24
|
-
this.segment = new Analytics({ writeKey: process.env.COPILOTKIT_SEGMENT_WRITE_KEY || "n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja" });
|
|
25
|
-
this.setGlobalProperties({
|
|
26
|
-
"copilotkit.package.name": packageName,
|
|
27
|
-
"copilotkit.package.version": packageVersion
|
|
28
|
-
});
|
|
29
|
-
}
|
|
30
|
-
shouldSendToSegment() {
|
|
31
|
-
return Math.random() < this.segmentSampleRate;
|
|
32
|
-
}
|
|
33
|
-
async capture(event, properties) {
|
|
34
|
-
return this.captureWithIdentity(event, properties, {
|
|
35
|
-
telemetryId: this.telemetryId,
|
|
36
|
-
licenseToken: this.licenseToken,
|
|
37
|
-
licenseTelemetryId: this.licenseTelemetryId
|
|
38
|
-
});
|
|
39
|
-
}
|
|
40
|
-
async captureWithIdentity(event, properties, identity) {
|
|
41
|
-
if (this.telemetryDisabled || isTelemetryDisabled()) return;
|
|
42
|
-
const sendToSegment = Boolean(identity.licenseTelemetryId) || this.shouldSendToSegment();
|
|
43
|
-
const lambdaSamplingMeta = computeSamplingMeta({
|
|
44
|
-
telemetryId: identity.licenseTelemetryId,
|
|
45
|
-
sampleRate: UNSAMPLED_RATE
|
|
46
|
-
});
|
|
47
|
-
const segmentSamplingMeta = computeSamplingMeta({
|
|
48
|
-
telemetryId: identity.licenseTelemetryId,
|
|
49
|
-
sampleRate: this.segmentSampleRate
|
|
50
|
-
});
|
|
51
|
-
const eventMeta = {
|
|
52
|
-
telemetry_emitter: TELEMETRY_EMITTER_V1,
|
|
53
|
-
telemetry_surface: TELEMETRY_SURFACE_V1,
|
|
54
|
-
telemetry_event_id: v4()
|
|
55
|
-
};
|
|
56
|
-
const flattenedProperties = flattenObject(properties);
|
|
57
|
-
const propertiesWithGlobal = {
|
|
58
|
-
...this.globalProperties,
|
|
59
|
-
...eventMeta,
|
|
60
|
-
...segmentSamplingMeta,
|
|
61
|
-
telemetry_transport: "segment",
|
|
62
|
-
...flattenedProperties
|
|
63
|
-
};
|
|
64
|
-
const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal).sort().reduce((obj, key) => {
|
|
65
|
-
obj[key] = propertiesWithGlobal[key];
|
|
66
|
-
return obj;
|
|
67
|
-
}, {});
|
|
68
|
-
await lambdaClient.send({
|
|
69
|
-
event,
|
|
70
|
-
properties: flattenedProperties,
|
|
71
|
-
globalProperties: {
|
|
72
|
-
...this.globalProperties,
|
|
73
|
-
...eventMeta,
|
|
74
|
-
...lambdaSamplingMeta,
|
|
75
|
-
telemetry_transport: "lambda"
|
|
76
|
-
},
|
|
77
|
-
packageName: this.packageName,
|
|
78
|
-
packageVersion: this.packageVersion,
|
|
79
|
-
telemetryId: identity.telemetryId ?? void 0,
|
|
80
|
-
licenseToken: identity.licenseToken ?? void 0
|
|
81
|
-
});
|
|
82
|
-
if (this.segment && sendToSegment) this.segment.track({
|
|
83
|
-
anonymousId: this.anonymousId,
|
|
84
|
-
event,
|
|
85
|
-
properties: { ...orderedPropertiesWithGlobal }
|
|
86
|
-
});
|
|
87
|
-
}
|
|
88
|
-
setGlobalProperties(properties) {
|
|
89
|
-
const flattenedProperties = flattenObject(properties);
|
|
90
|
-
this.globalProperties = {
|
|
91
|
-
...this.globalProperties,
|
|
92
|
-
...flattenedProperties
|
|
93
|
-
};
|
|
94
|
-
}
|
|
95
|
-
setCloudConfiguration(properties) {
|
|
96
|
-
this.cloudConfiguration = properties;
|
|
97
|
-
this.setGlobalProperties({ cloud: {
|
|
98
|
-
publicApiKey: properties.publicApiKey,
|
|
99
|
-
baseUrl: properties.baseUrl
|
|
100
|
-
} });
|
|
101
|
-
}
|
|
102
|
-
/**
|
|
103
|
-
* Atomically configure standalone, legacy, or anonymous telemetry identity.
|
|
104
|
-
*
|
|
105
|
-
* A standalone id takes transport precedence over a supplied legacy license
|
|
106
|
-
* token, but only a license-derived id grants sampling authority. Neither
|
|
107
|
-
* value is added to event properties.
|
|
108
|
-
*
|
|
109
|
-
* @param identity - One standalone id, one legacy license token, or neither.
|
|
110
|
-
*/
|
|
111
|
-
setTelemetryIdentity(identity) {
|
|
112
|
-
const resolvedIdentity = this.resolveTelemetryIdentity(identity);
|
|
113
|
-
this.telemetryId = resolvedIdentity.telemetryId;
|
|
114
|
-
this.licenseToken = resolvedIdentity.licenseToken;
|
|
115
|
-
this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;
|
|
116
|
-
}
|
|
117
|
-
/**
|
|
118
|
-
* Configure legacy license-derived telemetry identity.
|
|
119
|
-
*
|
|
120
|
-
* @param licenseToken - License token whose telemetry claim identifies sends.
|
|
121
|
-
*/
|
|
122
|
-
setLicenseToken(licenseToken) {
|
|
123
|
-
this.setTelemetryIdentity({ licenseToken });
|
|
124
|
-
}
|
|
125
|
-
/**
|
|
126
|
-
* Create an immutable capture scope for one runtime.
|
|
127
|
-
*
|
|
128
|
-
* The scope shares this client's sinks, process-wide opt-out, global
|
|
129
|
-
* properties, and Segment sampling rate, but snapshots transport identity and
|
|
130
|
-
* license-derived sampling authority. Constructing another runtime cannot
|
|
131
|
-
* rewrite an existing scope.
|
|
132
|
-
*
|
|
133
|
-
* @param identity - The runtime's construction-time telemetry identity.
|
|
134
|
-
* @returns A capture-only client bound to that identity.
|
|
135
|
-
*/
|
|
136
|
-
createScope(identity) {
|
|
137
|
-
const resolvedIdentity = this.resolveTelemetryIdentity(identity);
|
|
138
|
-
return { capture: (event, properties) => this.captureWithIdentity(event, properties, resolvedIdentity) };
|
|
139
|
-
}
|
|
140
|
-
resolveTelemetryIdentity(identity) {
|
|
141
|
-
const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);
|
|
142
|
-
if (telemetryId !== void 0) return {
|
|
143
|
-
telemetryId,
|
|
144
|
-
licenseToken: null,
|
|
145
|
-
licenseTelemetryId: null
|
|
146
|
-
};
|
|
147
|
-
return {
|
|
148
|
-
telemetryId: null,
|
|
149
|
-
licenseToken: identity.licenseToken ?? null,
|
|
150
|
-
licenseTelemetryId: identity.licenseToken ? parseAndWarnTelemetryId(identity.licenseToken) : null
|
|
151
|
-
};
|
|
152
|
-
}
|
|
153
|
-
setSampleRate(sampleRate) {
|
|
154
|
-
let _sampleRate;
|
|
155
|
-
_sampleRate = sampleRate ?? .05;
|
|
156
|
-
if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);
|
|
157
|
-
if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) throw new Error("Sample rate must be between 0 and 1");
|
|
158
|
-
this.segmentSampleRate = _sampleRate;
|
|
159
|
-
}
|
|
160
|
-
};
|
|
161
|
-
|
|
162
|
-
//#endregion
|
|
163
|
-
export { TelemetryClient };
|
|
164
|
-
//# sourceMappingURL=telemetry-client.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
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 {\n computeSamplingMeta,\n TELEMETRY_EMITTER_V1,\n TELEMETRY_SURFACE_V1,\n UNSAMPLED_RATE,\n} 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 the\n // Segment gate.\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 on the Segment wire\n // only. The lambda sink is ours and takes every event; Segment is\n // billed per event, so the anonymous population stays capped there.\n // Identified events (those whose license token yielded a telemetry_id)\n // bypass the gate on both wires.\n private segmentSampleRate: 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 // Anonymous sampling rate for the Segment wire. Named without the\n // prefix for backward compatibility; the lambda sink ignores it.\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 shouldSendToSegment() {\n const randomNumber = Math.random();\n return randomNumber < this.segmentSampleRate;\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()) {\n return;\n }\n\n // The two wires are gated separately. The lambda sink takes every\n // event: it is CopilotKit-owned, so anonymous volume costs nothing\n // per event there and a real count beats one extrapolated from 5% of\n // the population. Segment is billed per event, so it keeps the gate —\n // callers without license-derived sampling authority are dropped from\n // that copy at segmentSampleRate. Legacy license tokens with a\n // telemetry_id send on both wires: the volume is bounded by\n // paying-customer count and full fidelity per identified customer is\n // worth the marginal cost.\n const sendToSegment =\n Boolean(identity.licenseTelemetryId) || this.shouldSendToSegment();\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 // One call per wire, because the two wires were gated differently and\n // a shared block would overweight the lambda copy by 1/sampleRate.\n const lambdaSamplingMeta = computeSamplingMeta({\n telemetryId: identity.licenseTelemetryId,\n sampleRate: UNSAMPLED_RATE,\n });\n const segmentSamplingMeta = computeSamplingMeta({\n telemetryId: identity.licenseTelemetryId,\n sampleRate: this.segmentSampleRate,\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 telemetry_emitter: TELEMETRY_EMITTER_V1,\n telemetry_surface: TELEMETRY_SURFACE_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 ...segmentSamplingMeta,\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 ...lambdaSamplingMeta,\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 && sendToSegment) {\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 Segment sampling rate, 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 Segment 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.segmentSampleRate = _sampleRate;\n // Per-event sampling metadata (sampleRate/sampleRateAdjustmentFactor/\n // sampleWeight) is computed per capture() in ./sampling, once per\n // wire. Only license-authorized events get effectiveSampleRate=1 on\n // the Segment copy; standalone transport identity stays in the\n // sampled population there. The lambda copy is always unsampled.\n }\n}\n"],"mappings":"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"}
|
package/dist/telemetry/utils.cjs
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
//#region src/telemetry/utils.ts
|
|
3
|
-
function flattenObject(obj, parentKey = "", res = {}) {
|
|
4
|
-
for (let key in obj) {
|
|
5
|
-
const propName = parentKey ? `${parentKey}.${key}` : key;
|
|
6
|
-
if (typeof obj[key] === "object" && obj[key] !== null) flattenObject(obj[key], propName, res);
|
|
7
|
-
else res[propName] = obj[key];
|
|
8
|
-
}
|
|
9
|
-
return res;
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
//#endregion
|
|
13
|
-
exports.flattenObject = flattenObject;
|
|
14
|
-
//# sourceMappingURL=utils.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/telemetry/utils.ts"],"sourcesContent":["export function flattenObject(\n obj: Record<string, any>,\n parentKey = \"\",\n res: Record<string, any> = {},\n): Record<string, any> {\n for (let key in obj) {\n const propName = parentKey ? `${parentKey}.${key}` : key;\n if (typeof obj[key] === \"object\" && obj[key] !== null) {\n flattenObject(obj[key], propName, res);\n } else {\n res[propName] = obj[key];\n }\n }\n return res;\n}\n"],"mappings":";;AAAA,SAAgB,cACd,KACA,YAAY,IACZ,MAA2B,EAAE,EACR;AACrB,MAAK,IAAI,OAAO,KAAK;EACnB,MAAM,WAAW,YAAY,GAAG,UAAU,GAAG,QAAQ;AACrD,MAAI,OAAO,IAAI,SAAS,YAAY,IAAI,SAAS,KAC/C,eAAc,IAAI,MAAM,UAAU,IAAI;MAEtC,KAAI,YAAY,IAAI;;AAGxB,QAAO"}
|