@copilotkit/shared 1.70.1 → 1.70.2

package/dist/index.umd.js

@@ -1,8 +1,8 @@
 (function(global, factory) {
-  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('graphql'), require('zod'), require('uuid'), require('partial-json'), require('@segment/analytics-node'), require('chalk'), require('@ag-ui/client')) :
-  typeof define === 'function' && define.amd ? define(['exports', 'graphql', 'zod', 'uuid', 'partial-json', '@segment/analytics-node', 'chalk', '@ag-ui/client'], factory) :
-  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitShared = {}), global.GraphQL,global.Zod,global.UUID,global.PartialJSON,global.SegmentAnalyticsNode,global.chalk,global.AgUIClient));
-})(this, function(exports, graphql, zod, uuid, partial_json, _segment_analytics_node, chalk, _ag_ui_client) {
+  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('graphql'), require('zod'), require('uuid'), require('partial-json'), require('@ag-ui/client')) :
+  typeof define === 'function' && define.amd ? define(['exports', 'graphql', 'zod', 'uuid', 'partial-json', '@ag-ui/client'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitShared = {}), global.GraphQL,global.Zod,global.UUID,global.PartialJSON,global.AgUIClient));
+})(this, function(exports, graphql, zod, uuid, partial_json, _ag_ui_client) {
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 //#region \0rolldown/runtime.js
 	var __create = Object.create;
@@ -941,6 +941,186 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 		};
 	}
 
+//#endregion
+//#region src/utils/inspector-learning.ts
+	const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+	const string = (value, maximum) => typeof value === "string" && value.trim().length > 0 && value.length <= maximum;
+	const integer = (value, minimum = 0) => typeof value === "number" && Number.isSafeInteger(value) && value >= minimum;
+	const date = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
+	/**
+	* Accepts only the configured Intelligence web-app origin.
+	*
+	* Learning links are server-authored actions. Treating every HTTPS origin as
+	* trusted would let a misconfigured or compromised upstream turn Inspector
+	* copy into a navigation primitive for an arbitrary site.
+	*/
+	function parseInspectorLearningUrl(value, trustedOrigin) {
+		if (typeof value !== "string" || value.length > 4e3 || typeof trustedOrigin !== "string" || trustedOrigin.length > 2e3) return;
+		try {
+			const parsed = new URL(value);
+			const configured = new URL(trustedOrigin);
+			const loopback = [
+				"localhost",
+				"127.0.0.1",
+				"[::1]"
+			].includes(configured.hostname);
+			if (parsed.username || parsed.password || configured.username || configured.password || configured.pathname !== "/" || configured.search || configured.hash || configured.protocol !== "https:" && !(configured.protocol === "http:" && loopback) || parsed.origin !== configured.origin) return;
+			return parsed.toString();
+		} catch (_unused) {
+			return;
+		}
+	}
+	function parseEvidence(value) {
+		if (record(value) && value.status === "unavailable") return Object.keys(value).length === 1 ? { status: "unavailable" } : void 0;
+		if (!record(value) || value.status !== "available" || !string(value.threadId, 128) || !date(value.updatedAt)) return;
+		if (value.threadName !== null && !(typeof value.threadName === "string" && value.threadName.length <= 4e3)) return;
+		if (!Array.isArray(value.messageIds) || value.messageIds.length > 200 || !value.messageIds.every((id) => string(id, 128))) return;
+		return {
+			status: "available",
+			threadId: value.threadId,
+			threadName: value.threadName,
+			messageIds: [...value.messageIds],
+			updatedAt: value.updatedAt
+		};
+	}
+	function parseInsight(value) {
+		if (!record(value) || !string(value.id, 128) || !string(value.statement, 4e3) || !string(value.impact, 4e3) || !integer(value.totalThreadCount) || typeof value.evidenceTruncated !== "boolean" || !Array.isArray(value.evidence) || value.evidence.length > 100) return;
+		const evidence = value.evidence.map(parseEvidence);
+		if (evidence.some((item) => item === void 0)) return void 0;
+		return {
+			id: value.id,
+			statement: value.statement,
+			impact: value.impact,
+			totalThreadCount: value.totalThreadCount,
+			evidenceTruncated: value.evidenceTruncated,
+			evidence
+		};
+	}
+	function parseSkill(value) {
+		if (!record(value) || !string(value.id, 128) || !string(value.name, 128) || !string(value.description, 4e3) || !integer(value.revision, 1) || typeof value.skillMd !== "string" || value.skillMd.length > 131072) return;
+		const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight);
+		if (sourceInsight === void 0) return void 0;
+		return {
+			id: value.id,
+			name: value.name,
+			description: value.description,
+			revision: value.revision,
+			skillMd: value.skillMd,
+			sourceInsight
+		};
+	}
+	function parsePage(value, pageSize, parseItem) {
+		if (!record(value) || !integer(value.page, 1) || value.pageSize !== pageSize || !integer(value.total) || !integer(value.totalPages) || !Array.isArray(value.items) || value.items.length > pageSize) return;
+		const items = value.items.map(parseItem);
+		if (items.some((item) => item === void 0)) return void 0;
+		if (value.total === 0) {
+			if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) return;
+		} else {
+			const totalPages = Math.ceil(value.total / pageSize);
+			const expectedItems = Math.min(pageSize, value.total - (value.page - 1) * pageSize);
+			if (value.totalPages !== totalPages || value.page > totalPages || items.length !== expectedItems) return;
+		}
+		return {
+			page: value.page,
+			pageSize,
+			total: value.total,
+			totalPages: value.totalPages,
+			items
+		};
+	}
+	function parseConfiguration(value) {
+		if (!record(value)) return void 0;
+		if (value.state === "not_configured" || value.state === "selection_required") return { state: value.state };
+		if (value.state === "invalid" && (value.reason === "container" || value.reason === "instrumentation")) return {
+			state: value.state,
+			reason: value.reason
+		};
+		if (value.state === "configured" && record(value.container) && string(value.container.id, 128) && string(value.container.name, 128)) return {
+			state: "configured",
+			container: {
+				id: value.container.id,
+				name: value.container.name
+			}
+		};
+	}
+	const runStatuses = new Set([
+		"queued",
+		"freezing",
+		"batching",
+		"reducing",
+		"finalizing",
+		"succeeded",
+		"failed"
+	]);
+	/** Validates and copies an untrusted Learning snapshot at each process boundary. */
+	function parseInspectorLearningSnapshotV1(value) {
+		if (!record(value) || value.schemaVersion !== 1 || !string(value.projectKey, 128) || !string(value.snapshotVersion, 128) || !integer(value.pendingThreadCount) || !integer(value.pendingCandidateCount) || !record(value.run) || typeof value.run.hasActiveRun !== "boolean" || typeof value.run.hasEverSucceeded !== "boolean") return;
+		const configuration = parseConfiguration(value.configuration);
+		const skillsPage = parsePage(value.skillsPage, 3, parseSkill);
+		const insightsPage = parsePage(value.insightsPage, 4, parseInsight);
+		if (!configuration || !skillsPage || !insightsPage) return void 0;
+		let latest = null;
+		if (value.run.latest !== null) {
+			const latestRun = value.run.latest;
+			if (!record(latestRun)) return;
+			const { status, completedAt } = latestRun;
+			if (typeof status !== "string" || !runStatuses.has(status) || completedAt !== null && !date(completedAt)) return void 0;
+			latest = {
+				status,
+				completedAt
+			};
+		}
+		if (!record(value.links)) return void 0;
+		const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
+		if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
+		const webAppOrigin = new URL(originUrl).origin;
+		const learning = parseInspectorLearningUrl(value.links.learning, webAppOrigin);
+		const candidates = value.links.candidates === null ? null : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);
+		const runs = value.links.runs === null ? null : parseInspectorLearningUrl(value.links.runs, webAppOrigin);
+		if (!learning || candidates === void 0 || runs === void 0 || value.pendingThreadCount > 0 && runs === null || value.pendingCandidateCount > 0 && candidates === null) return void 0;
+		return {
+			schemaVersion: 1,
+			projectKey: value.projectKey,
+			snapshotVersion: value.snapshotVersion,
+			webAppOrigin,
+			configuration,
+			pendingThreadCount: value.pendingThreadCount,
+			run: {
+				hasActiveRun: value.run.hasActiveRun,
+				hasEverSucceeded: value.run.hasEverSucceeded,
+				latest
+			},
+			pendingCandidateCount: value.pendingCandidateCount,
+			skillsPage,
+			insightsPage,
+			links: {
+				learning,
+				candidates,
+				runs
+			}
+		};
+	}
+	/** Normalizes the browser-owned request without accepting container scope. */
+	function parseInspectorLearningRequestV1(value) {
+		if (!record(value)) return void 0;
+		if (Object.keys(value).some((key) => ![
+			"agentId",
+			"skillsPage",
+			"insightsPage"
+		].includes(key))) return;
+		const agentId = value.agentId;
+		const skillsPage = value.skillsPage;
+		const insightsPage = value.insightsPage;
+		if (agentId !== void 0 && !string(agentId, 128)) return void 0;
+		if (skillsPage !== void 0 && !integer(skillsPage, 1)) return void 0;
+		if (insightsPage !== void 0 && !integer(insightsPage, 1)) return void 0;
+		return {
+			...agentId === void 0 ? {} : { agentId },
+			...skillsPage === void 0 ? {} : { skillsPage },
+			...insightsPage === void 0 ? {} : { insightsPage }
+		};
+	}
+
 //#endregion
 //#region src/utils/inspector-visibility.ts
 /**
@@ -1134,14 +1314,43 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 	const AG_UI_CHANNEL_EVENT = "ag-ui";
 
 //#endregion
-//#region src/telemetry/utils.ts
-	function flattenObject(obj, parentKey = "", res = {}) {
-		for (let key in obj) {
-			const propName = parentKey ? `${parentKey}.${key}` : key;
-			if (typeof obj[key] === "object" && obj[key] !== null) flattenObject(obj[key], propName, res);
-			else res[propName] = obj[key];
-		}
-		return res;
+//#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
+//#region src/telemetry/sampling.ts
+/** Identifies which client emitted an event. */
+	const TELEMETRY_EMITTER_V1 = "v1-shared";
+	const TELEMETRY_EMITTER_V2 = "v2-runtime";
+	/**
+	* Compute the sampling block for one captured event.
+	*
+	* `telemetryId` is the caller's parsed license telemetry_id, or null when
+	* anonymous — it decides the branch, and is deliberately not returned:
+	* only the non-PII shape below travels on the event.
+	*/
+	function computeSamplingMeta({ telemetryId, sampleRate }) {
+		const identified = Boolean(telemetryId);
+		const effectiveSampleRate = identified ? 1 : sampleRate;
+		return {
+			sampleRate: effectiveSampleRate,
+			sampleRateAdjustmentFactor: 1 - effectiveSampleRate,
+			sampleWeight: 1 / effectiveSampleRate,
+			telemetry_identified: identified
+		};
 	}
 
 //#endregion
@@ -1232,188 +1441,6 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 	}
 	const lambdaClient = { send };
 
-//#endregion
-//#region src/telemetry/sampling.ts
-/** Identifies which client emitted an event. */
-	const TELEMETRY_EMITTER_V1 = "v1-shared";
-	const TELEMETRY_EMITTER_V2 = "v2-runtime";
-	/**
-	* Compute the sampling block for one captured event.
-	*
-	* `telemetryId` is the caller's parsed license telemetry_id, or null when
-	* anonymous — it decides the branch, and is deliberately not returned:
-	* only the non-PII shape below travels on the event.
-	*/
-	function computeSamplingMeta({ telemetryId, sampleRate }) {
-		const identified = Boolean(telemetryId);
-		const effectiveSampleRate = identified ? 1 : sampleRate;
-		return {
-			sampleRate: effectiveSampleRate,
-			sampleRateAdjustmentFactor: 1 - effectiveSampleRate,
-			sampleWeight: 1 / effectiveSampleRate,
-			telemetry_identified: identified
-		};
-	}
-
-//#endregion
-//#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 = {};
-			this.cloudConfiguration = null;
-			this.licenseToken = null;
-			this.telemetryId = null;
-			this.licenseTelemetryId = null;
-			this.telemetryDisabled = false;
-			this.sampleRate = .05;
-			this.anonymousId = `anon_${(0, uuid.v4)()}`;
-			this.packageName = packageName;
-			this.packageVersion = packageVersion;
-			this.telemetryDisabled = telemetryDisabled || isTelemetryDisabled();
-			if (this.telemetryDisabled) return;
-			this.setSampleRate(sampleRate);
-			this.segment = new _segment_analytics_node.Analytics({ writeKey: process.env.COPILOTKIT_SEGMENT_WRITE_KEY || "n7XAZtQCGS2v1vvBy3LgBCv2h3Y8whja" });
-			this.setGlobalProperties({
-				"copilotkit.package.name": packageName,
-				"copilotkit.package.version": packageVersion
-			});
-		}
-		shouldSendEvent() {
-			return Math.random() < this.sampleRate;
-		}
-		async capture(event, properties) {
-			return this.captureWithIdentity(event, properties, {
-				telemetryId: this.telemetryId,
-				licenseToken: this.licenseToken,
-				licenseTelemetryId: this.licenseTelemetryId
-			});
-		}
-		async captureWithIdentity(event, properties, identity) {
-			var _identity$telemetryId, _identity$licenseToke;
-			if (this.telemetryDisabled) return;
-			if (!identity.licenseTelemetryId && !this.shouldSendEvent()) return;
-			const eventMeta = {
-				...computeSamplingMeta({
-					telemetryId: identity.licenseTelemetryId,
-					sampleRate: this.sampleRate
-				}),
-				telemetry_emitter: TELEMETRY_EMITTER_V1,
-				telemetry_event_id: (0, uuid.v4)()
-			};
-			const flattenedProperties = flattenObject(properties);
-			const propertiesWithGlobal = {
-				...this.globalProperties,
-				...eventMeta,
-				telemetry_transport: "segment",
-				...flattenedProperties
-			};
-			const orderedPropertiesWithGlobal = Object.keys(propertiesWithGlobal).sort().reduce((obj, key) => {
-				obj[key] = propertiesWithGlobal[key];
-				return obj;
-			}, {});
-			await lambdaClient.send({
-				event,
-				properties: flattenedProperties,
-				globalProperties: {
-					...this.globalProperties,
-					...eventMeta,
-					telemetry_transport: "lambda"
-				},
-				packageName: this.packageName,
-				packageVersion: this.packageVersion,
-				telemetryId: (_identity$telemetryId = identity.telemetryId) !== null && _identity$telemetryId !== void 0 ? _identity$telemetryId : void 0,
-				licenseToken: (_identity$licenseToke = identity.licenseToken) !== null && _identity$licenseToke !== void 0 ? _identity$licenseToke : void 0
-			});
-			if (this.segment) this.segment.track({
-				anonymousId: this.anonymousId,
-				event,
-				properties: { ...orderedPropertiesWithGlobal }
-			});
-		}
-		setGlobalProperties(properties) {
-			const flattenedProperties = flattenObject(properties);
-			this.globalProperties = {
-				...this.globalProperties,
-				...flattenedProperties
-			};
-		}
-		setCloudConfiguration(properties) {
-			this.cloudConfiguration = properties;
-			this.setGlobalProperties({ cloud: {
-				publicApiKey: properties.publicApiKey,
-				baseUrl: properties.baseUrl
-			} });
-		}
-		/**
-		* Atomically configure standalone, legacy, or anonymous telemetry identity.
-		*
-		* A standalone id takes transport precedence over a supplied legacy license
-		* token, but only a license-derived id grants sampling authority. Neither
-		* value is added to event properties.
-		*
-		* @param identity - One standalone id, one legacy license token, or neither.
-		*/
-		setTelemetryIdentity(identity) {
-			const resolvedIdentity = this.resolveTelemetryIdentity(identity);
-			this.telemetryId = resolvedIdentity.telemetryId;
-			this.licenseToken = resolvedIdentity.licenseToken;
-			this.licenseTelemetryId = resolvedIdentity.licenseTelemetryId;
-		}
-		/**
-		* Configure legacy license-derived telemetry identity.
-		*
-		* @param licenseToken - License token whose telemetry claim identifies sends.
-		*/
-		setLicenseToken(licenseToken) {
-			this.setTelemetryIdentity({ licenseToken });
-		}
-		/**
-		* Create an immutable capture scope for one runtime.
-		*
-		* The scope shares this client's sinks, process-wide opt-out, global
-		* properties, and sampling settings, but snapshots transport identity and
-		* license-derived sampling authority. Constructing another runtime cannot
-		* rewrite an existing scope.
-		*
-		* @param identity - The runtime's construction-time telemetry identity.
-		* @returns A capture-only client bound to that identity.
-		*/
-		createScope(identity) {
-			const resolvedIdentity = this.resolveTelemetryIdentity(identity);
-			return { capture: (event, properties) => this.captureWithIdentity(event, properties, resolvedIdentity) };
-		}
-		resolveTelemetryIdentity(identity) {
-			var _identity$licenseToke2;
-			const telemetryId = firstNonBlankTelemetryId(identity.telemetryId);
-			if (telemetryId !== void 0) return {
-				telemetryId,
-				licenseToken: null,
-				licenseTelemetryId: null
-			};
-			return {
-				telemetryId: null,
-				licenseToken: (_identity$licenseToke2 = identity.licenseToken) !== null && _identity$licenseToke2 !== void 0 ? _identity$licenseToke2 : null,
-				licenseTelemetryId: identity.licenseToken ? parseAndWarnTelemetryId(identity.licenseToken) : null
-			};
-		}
-		setSampleRate(sampleRate) {
-			let _sampleRate;
-			_sampleRate = sampleRate !== null && sampleRate !== void 0 ? sampleRate : .05;
-			if (process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE) _sampleRate = parseFloat(process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE);
-			if (Number.isNaN(_sampleRate) || _sampleRate < 0 || _sampleRate > 1) throw new Error("Sample rate must be between 0 and 1");
-			this.sampleRate = _sampleRate;
-		}
-	};
-
 //#endregion
 //#region src/debug.ts
 /** The all-off config used when debug is falsy. */
@@ -1791,7 +1818,7 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 
 //#endregion
 //#region package.json
-	var version = "1.70.1";
+	var version = "1.70.2";
 
 //#endregion
 //#region src/a2ui-prompts.ts
@@ -1939,7 +1966,7 @@ Use the SAME surfaceId as the main surface. Match action names to button action
 		const hasUsableSelfHostedLegacyFallback = readyEntitlement && !readyEntitlement.active && readyEntitlement.source === "selfHostedDeploymentLicense" && (status === "valid" || status === "expiring");
 		const featureAuthority = readyEntitlement && !hasUsableSelfHostedLegacyFallback ? readyEntitlement : null;
 		const activeEntitlement = (featureAuthority === null || featureAuthority === void 0 ? void 0 : featureAuthority.active) ? featureAuthority : null;
-		const resolvedStatus = activeEntitlement ? "valid" : (readyEntitlement === null || readyEntitlement === void 0 ? void 0 : readyEntitlement.source) === "managedOrgSubscription" ? "none" : featureAuthority ? status !== null && status !== void 0 ? status : "none" : status !== null && status !== void 0 ? status : null;
+		const resolvedStatus = activeEntitlement ? "valid" : (readyEntitlement === null || readyEntitlement === void 0 ? void 0 : readyEntitlement.source) === "managedOrgSubscription" || (readyEntitlement === null || readyEntitlement === void 0 ? void 0 : readyEntitlement.source) === "awsMarketplaceDeploymentLicense" ? "none" : featureAuthority ? status !== null && status !== void 0 ? status : "none" : status !== null && status !== void 0 ? status : null;
 		const featuresEnabled = resolvedStatus !== "expired" && resolvedStatus !== "invalid";
 		return {
 			status: resolvedStatus,
@@ -1988,7 +2015,6 @@ exports.ResolvedCopilotKitError = ResolvedCopilotKitError;
 exports.Severity = Severity;
 exports.TELEMETRY_EMITTER_V1 = TELEMETRY_EMITTER_V1;
 exports.TELEMETRY_EMITTER_V2 = TELEMETRY_EMITTER_V2;
-exports.TelemetryClient = TelemetryClient;
 exports.TranscriptionErrorCode = TranscriptionErrorCode;
 exports.TranscriptionErrors = TranscriptionErrors;
 exports.UpgradeRequiredError = UpgradeRequiredError;
@@ -2021,6 +2047,9 @@ exports.logStyled = logStyled;
 exports.logger = logger;
 exports.matchesAcceptFilter = matchesAcceptFilter;
 exports.parseAndWarnTelemetryId = parseAndWarnTelemetryId;
+exports.parseInspectorLearningRequestV1 = parseInspectorLearningRequestV1;
+exports.parseInspectorLearningSnapshotV1 = parseInspectorLearningSnapshotV1;
+exports.parseInspectorLearningUrl = parseInspectorLearningUrl;
 exports.parseInspectorMetadataV1 = parseInspectorMetadataV1;
 exports.parseJson = parseJson;
 exports.parseTelemetryIdFromLicense = parseTelemetryIdFromLicense;