@copilotkit/shared 1.79.1 → 1.80.0
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/dist/constants/index.cjs +7 -0
- package/dist/constants/index.cjs.map +1 -1
- package/dist/constants/index.d.cts +7 -1
- package/dist/constants/index.d.cts.map +1 -1
- package/dist/constants/index.d.mts +7 -1
- package/dist/constants/index.d.mts.map +1 -1
- package/dist/constants/index.mjs +7 -1
- package/dist/constants/index.mjs.map +1 -1
- package/dist/index.cjs +1 -0
- package/dist/index.d.cts +3 -3
- package/dist/index.d.mts +3 -3
- package/dist/index.mjs +2 -2
- package/dist/index.umd.js +46 -10
- package/dist/index.umd.js.map +1 -1
- package/dist/package.cjs +1 -1
- package/dist/package.mjs +1 -1
- package/dist/telemetry/lambda-client.cjs.map +1 -1
- package/dist/telemetry/lambda-client.mjs.map +1 -1
- package/dist/telemetry/utils.cjs +0 -2
- package/dist/telemetry/utils.cjs.map +1 -1
- package/dist/telemetry/utils.mjs +0 -2
- package/dist/telemetry/utils.mjs.map +1 -1
- package/dist/utils/index.d.cts +1 -1
- package/dist/utils/index.d.mts +1 -1
- package/dist/utils/inspector-learning.cjs +38 -9
- package/dist/utils/inspector-learning.cjs.map +1 -1
- package/dist/utils/inspector-learning.d.cts +14 -1
- package/dist/utils/inspector-learning.d.cts.map +1 -1
- package/dist/utils/inspector-learning.d.mts +14 -1
- package/dist/utils/inspector-learning.d.mts.map +1 -1
- package/dist/utils/inspector-learning.mjs +38 -9
- package/dist/utils/inspector-learning.mjs.map +1 -1
- package/package.json +1 -2
- package/src/constants/index.ts +7 -0
- package/src/telemetry/lambda-client.ts +3 -3
- package/src/telemetry/utils.ts +0 -28
- package/src/utils/inspector-learning.test.ts +152 -0
- package/src/utils/inspector-learning.ts +91 -12
- package/tsdown.config.ts +0 -1
- package/src/telemetry/scarf-client.ts +0 -39
- package/src/telemetry/security-check.ts +0 -0
package/dist/package.cjs
CHANGED
package/dist/package.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lambda-client.cjs","names":[],"sources":["../../src/telemetry/lambda-client.ts"],"sourcesContent":["// Telemetry sink client.\n//\n// Posts events to a CopilotKit-controlled telemetry-sink endpoint, which\n// fans out to Scarf, Reo, and any future destinations. Replaces the direct\n// per-vendor calls (
|
|
1
|
+
{"version":3,"file":"lambda-client.cjs","names":[],"sources":["../../src/telemetry/lambda-client.ts"],"sourcesContent":["// Telemetry sink client.\n//\n// Posts events to a CopilotKit-controlled telemetry-sink endpoint, which\n// fans out to Scarf, Reo, and any future destinations. Replaces the direct\n// per-vendor calls (formerly a Scarf-specific client) so that vendor changes\n// don't require SDK releases and so that downstream services we don't want\n// exposed to OSS readers (e.g. the email-enrichment service backing Reo) stay\n// private.\n//\n// Two attribution modes:\n// - Identified: a standalone telemetry id or a CopilotKit license token is\n// configured. Standalone identity takes precedence. License tokens are\n// JWTs (header.payload.sig) whose payload carries `telemetry_id`; the SDK\n// base64url-decodes the payload — without verifying the Ed25519 signature,\n// which is the license-verifier's job. The resolved identity is emitted\n// only via `X-CopilotKit-Telemetry-Id`.\n// - Anonymous: no license token, or a malformed/non-JWT one. No\n// telemetry-id header; events still flow, attribution is best-effort\n// from request-level signals (IP, UA).\n//\n// Note: CopilotCloud customer API keys (`ck_<env>_<id>.<secret>`) are\n// unrelated to telemetry attribution. They flow into Segment / PostHog\n// via the v1 shared TelemetryClient and never reach this code path.\n//\n// Best-effort: every error is swallowed. Telemetry must not break the\n// host application.\n\nconst TELEMETRY_SINK_URL =\n (typeof process !== \"undefined\" && process.env?.COPILOTKIT_TELEMETRY_URL) ||\n \"https://telemetry.copilotkit.ai/ingest\";\n\nconst FETCH_TIMEOUT_MS = 3000;\nconst TELEMETRY_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;\n\nexport interface LambdaSendOptions {\n event: string;\n properties?: Record<string, unknown>;\n globalProperties?: Record<string, unknown>;\n packageName?: string;\n packageVersion?: string;\n /** Standalone analytics identity, resolved before any legacy license claim. */\n telemetryId?: string;\n // The CopilotKit license token (Ed25519-signed JWT), when one is\n // configured on the runtime. The sender base64url-decodes the payload\n // segment to extract `telemetry_id`; missing or malformed tokens\n // produce an anonymous send.\n licenseToken?: string;\n}\n\n/**\n * Return the first telemetry identity accepted by the ingest service.\n *\n * Empty and whitespace-only values are unconfigured placeholders and must not\n * suppress a later identity source. Leading and trailing HTTP spaces and tabs\n * are removed before validation. The ingest service accepts 1 to 128 ASCII\n * letters, digits, underscores, and hyphens.\n *\n * @internal\n */\nexport function firstNonBlankTelemetryId(\n ...candidates: ReadonlyArray<string | undefined>\n): string | undefined {\n for (const candidate of candidates) {\n if (candidate === undefined) {\n continue;\n }\n\n const normalized = candidate.replace(/^[\\t ]+|[\\t ]+$/g, \"\");\n if (TELEMETRY_ID_PATTERN.test(normalized)) {\n return normalized;\n }\n }\n\n return undefined;\n}\n\n// These fields aren't used by the telemetry service, so we strip them\n// at the wire boundary rather than rely on every caller to omit them.\n// Both the snake_case and camelCase variants are listed because callers\n// upstream use different conventions.\nconst STRIPPED_KEYS = new Set([\"cloud.public_api_key\", \"cloud.publicApiKey\"]);\n\nfunction stripCloudKeys(\n obj: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n if (!obj) return {};\n const out: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(obj)) {\n if (!STRIPPED_KEYS.has(k)) out[k] = v;\n }\n return out;\n}\n\n// Pull telemetry_id out of a CopilotKit license token without verifying\n// the signature. The token shape is a standard JWT\n// (`<header>.<payload>.<sig>`) with base64url-encoded segments; the\n// payload is UTF-8 JSON with a telemetry_id accepted by the ingest service.\n//\n// Verification (Ed25519, key rotation, expiry) is the license-verifier\n// package's job. For telemetry attribution we only need the claimed id —\n// the trust model is claim-only on the Lambda side anyway.\n//\n// Exported so TelemetryClient setters can detect unparseable tokens at\n// configuration time and surface a single warning, instead of silently\n// emitting anonymous events on every capture.\nexport function parseTelemetryIdFromLicense(token?: string): string | null {\n if (!token) return null;\n const parts = token.split(\".\");\n if (parts.length !== 3) return null;\n try {\n const payload = parts[1];\n if (!/^[A-Za-z0-9_-]+$/.test(payload) || payload.length % 4 === 1) {\n return null;\n }\n\n let b64 = payload.replace(/-/g, \"+\").replace(/_/g, \"/\");\n const padding = (4 - (b64.length % 4)) % 4;\n b64 += \"=\".repeat(padding);\n const json =\n typeof Buffer !== \"undefined\"\n ? Buffer.from(b64, \"base64\").toString(\"utf8\")\n : new TextDecoder().decode(\n Uint8Array.from(atob(b64), (character) => character.charCodeAt(0)),\n );\n const decoded = JSON.parse(json) as { telemetry_id?: unknown };\n const telemetryId =\n typeof decoded.telemetry_id === \"string\"\n ? decoded.telemetry_id\n : undefined;\n return firstNonBlankTelemetryId(telemetryId) ?? null;\n } catch {\n return null;\n }\n}\n\n// Parse the telemetry_id from a license token AND emit the rollout smoke\n// signal if the parse returned null. Returning the parsed id lets callers\n// cache it in one step (avoiding a second parseTelemetryIdFromLicense\n// pass) while keeping the warn text in lockstep between v1 (shared) and\n// v2 (runtime) TelemetryClient.setLicenseToken.\nexport function parseAndWarnTelemetryId(licenseToken: string): string | null {\n const telemetryId = parseTelemetryIdFromLicense(licenseToken);\n if (!telemetryId) {\n console.warn(\n \"[CopilotKit] License token did not yield a telemetry_id; telemetry events will be sent anonymously.\",\n );\n }\n return telemetryId;\n}\n\nexport async function send(opts: LambdaSendOptions): Promise<void> {\n try {\n const body = JSON.stringify({\n event: opts.event,\n properties: stripCloudKeys(opts.properties),\n global_properties: stripCloudKeys(opts.globalProperties),\n package: {\n name: opts.packageName,\n version: opts.packageVersion,\n },\n ts: Math.floor(Date.now() / 1000),\n });\n\n const telemetryId =\n firstNonBlankTelemetryId(opts.telemetryId) ??\n parseTelemetryIdFromLicense(opts.licenseToken);\n const headers: Record<string, string> = {\n \"Content-Type\": \"application/json\",\n \"User-Agent\": opts.packageName\n ? `CopilotKit-Runtime/${opts.packageVersion ?? \"unknown\"} (${opts.packageName})`\n : \"CopilotKit-Runtime\",\n };\n if (telemetryId) {\n headers[\"X-CopilotKit-Telemetry-Id\"] = telemetryId;\n }\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n try {\n await fetch(TELEMETRY_SINK_URL, {\n method: \"POST\",\n headers,\n body,\n signal: controller.signal,\n });\n } finally {\n clearTimeout(timeoutId);\n }\n } catch {\n // Silent failure — telemetry must not break the application.\n }\n}\n\nexport const lambdaClient = { send };\n"],"mappings":";;AA2BA,MAAM,qBACH,OAAO,YAAY,eAAe,QAAQ,KAAK,4BAChD;AAEF,MAAM,mBAAmB;AACzB,MAAM,uBAAuB;;;;;;;;;;;AA2B7B,SAAgB,yBACd,GAAG,YACiB;AACpB,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,cAAc,OAChB;EAGF,MAAM,aAAa,UAAU,QAAQ,oBAAoB,GAAG;AAC5D,MAAI,qBAAqB,KAAK,WAAW,CACvC,QAAO;;;AAWb,MAAM,gBAAgB,IAAI,IAAI,CAAC,wBAAwB,qBAAqB,CAAC;AAE7E,SAAS,eACP,KACyB;AACzB,KAAI,CAAC,IAAK,QAAO,EAAE;CACnB,MAAM,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,CACtC,KAAI,CAAC,cAAc,IAAI,EAAE,CAAE,KAAI,KAAK;AAEtC,QAAO;;AAeT,SAAgB,4BAA4B,OAA+B;AACzE,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,KAAI;EACF,MAAM,UAAU,MAAM;AACtB,MAAI,CAAC,mBAAmB,KAAK,QAAQ,IAAI,QAAQ,SAAS,MAAM,EAC9D,QAAO;EAGT,IAAI,MAAM,QAAQ,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI;EACvD,MAAM,WAAW,IAAK,IAAI,SAAS,KAAM;AACzC,SAAO,IAAI,OAAO,QAAQ;EAC1B,MAAM,OACJ,OAAO,WAAW,cACd,OAAO,KAAK,KAAK,SAAS,CAAC,SAAS,OAAO,GAC3C,IAAI,aAAa,CAAC,OAChB,WAAW,KAAK,KAAK,IAAI,GAAG,cAAc,UAAU,WAAW,EAAE,CAAC,CACnE;EACP,MAAM,UAAU,KAAK,MAAM,KAAK;AAKhC,SAAO,yBAHL,OAAO,QAAQ,iBAAiB,WAC5B,QAAQ,eACR,OACsC,IAAI;SAC1C;AACN,SAAO;;;AASX,SAAgB,wBAAwB,cAAqC;CAC3E,MAAM,cAAc,4BAA4B,aAAa;AAC7D,KAAI,CAAC,YACH,SAAQ,KACN,sGACD;AAEH,QAAO;;AAGT,eAAsB,KAAK,MAAwC;AACjE,KAAI;EACF,MAAM,OAAO,KAAK,UAAU;GAC1B,OAAO,KAAK;GACZ,YAAY,eAAe,KAAK,WAAW;GAC3C,mBAAmB,eAAe,KAAK,iBAAiB;GACxD,SAAS;IACP,MAAM,KAAK;IACX,SAAS,KAAK;IACf;GACD,IAAI,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;GAClC,CAAC;EAEF,MAAM,cACJ,yBAAyB,KAAK,YAAY,IAC1C,4BAA4B,KAAK,aAAa;EAChD,MAAM,UAAkC;GACtC,gBAAgB;GAChB,cAAc,KAAK,cACf,sBAAsB,KAAK,kBAAkB,UAAU,IAAI,KAAK,YAAY,KAC5E;GACL;AACD,MAAI,YACF,SAAQ,+BAA+B;EAGzC,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,iBAAiB;AACxE,MAAI;AACF,SAAM,MAAM,oBAAoB;IAC9B,QAAQ;IACR;IACA;IACA,QAAQ,WAAW;IACpB,CAAC;YACM;AACR,gBAAa,UAAU;;SAEnB;;AAKV,MAAa,eAAe,EAAE,MAAM"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lambda-client.mjs","names":[],"sources":["../../src/telemetry/lambda-client.ts"],"sourcesContent":["// Telemetry sink client.\n//\n// Posts events to a CopilotKit-controlled telemetry-sink endpoint, which\n// fans out to Scarf, Reo, and any future destinations. Replaces the direct\n// per-vendor calls (
|
|
1
|
+
{"version":3,"file":"lambda-client.mjs","names":[],"sources":["../../src/telemetry/lambda-client.ts"],"sourcesContent":["// Telemetry sink client.\n//\n// Posts events to a CopilotKit-controlled telemetry-sink endpoint, which\n// fans out to Scarf, Reo, and any future destinations. Replaces the direct\n// per-vendor calls (formerly a Scarf-specific client) so that vendor changes\n// don't require SDK releases and so that downstream services we don't want\n// exposed to OSS readers (e.g. the email-enrichment service backing Reo) stay\n// private.\n//\n// Two attribution modes:\n// - Identified: a standalone telemetry id or a CopilotKit license token is\n// configured. Standalone identity takes precedence. License tokens are\n// JWTs (header.payload.sig) whose payload carries `telemetry_id`; the SDK\n// base64url-decodes the payload — without verifying the Ed25519 signature,\n// which is the license-verifier's job. The resolved identity is emitted\n// only via `X-CopilotKit-Telemetry-Id`.\n// - Anonymous: no license token, or a malformed/non-JWT one. No\n// telemetry-id header; events still flow, attribution is best-effort\n// from request-level signals (IP, UA).\n//\n// Note: CopilotCloud customer API keys (`ck_<env>_<id>.<secret>`) are\n// unrelated to telemetry attribution. They flow into Segment / PostHog\n// via the v1 shared TelemetryClient and never reach this code path.\n//\n// Best-effort: every error is swallowed. Telemetry must not break the\n// host application.\n\nconst TELEMETRY_SINK_URL =\n (typeof process !== \"undefined\" && process.env?.COPILOTKIT_TELEMETRY_URL) ||\n \"https://telemetry.copilotkit.ai/ingest\";\n\nconst FETCH_TIMEOUT_MS = 3000;\nconst TELEMETRY_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;\n\nexport interface LambdaSendOptions {\n event: string;\n properties?: Record<string, unknown>;\n globalProperties?: Record<string, unknown>;\n packageName?: string;\n packageVersion?: string;\n /** Standalone analytics identity, resolved before any legacy license claim. */\n telemetryId?: string;\n // The CopilotKit license token (Ed25519-signed JWT), when one is\n // configured on the runtime. The sender base64url-decodes the payload\n // segment to extract `telemetry_id`; missing or malformed tokens\n // produce an anonymous send.\n licenseToken?: string;\n}\n\n/**\n * Return the first telemetry identity accepted by the ingest service.\n *\n * Empty and whitespace-only values are unconfigured placeholders and must not\n * suppress a later identity source. Leading and trailing HTTP spaces and tabs\n * are removed before validation. The ingest service accepts 1 to 128 ASCII\n * letters, digits, underscores, and hyphens.\n *\n * @internal\n */\nexport function firstNonBlankTelemetryId(\n ...candidates: ReadonlyArray<string | undefined>\n): string | undefined {\n for (const candidate of candidates) {\n if (candidate === undefined) {\n continue;\n }\n\n const normalized = candidate.replace(/^[\\t ]+|[\\t ]+$/g, \"\");\n if (TELEMETRY_ID_PATTERN.test(normalized)) {\n return normalized;\n }\n }\n\n return undefined;\n}\n\n// These fields aren't used by the telemetry service, so we strip them\n// at the wire boundary rather than rely on every caller to omit them.\n// Both the snake_case and camelCase variants are listed because callers\n// upstream use different conventions.\nconst STRIPPED_KEYS = new Set([\"cloud.public_api_key\", \"cloud.publicApiKey\"]);\n\nfunction stripCloudKeys(\n obj: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n if (!obj) return {};\n const out: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(obj)) {\n if (!STRIPPED_KEYS.has(k)) out[k] = v;\n }\n return out;\n}\n\n// Pull telemetry_id out of a CopilotKit license token without verifying\n// the signature. The token shape is a standard JWT\n// (`<header>.<payload>.<sig>`) with base64url-encoded segments; the\n// payload is UTF-8 JSON with a telemetry_id accepted by the ingest service.\n//\n// Verification (Ed25519, key rotation, expiry) is the license-verifier\n// package's job. For telemetry attribution we only need the claimed id —\n// the trust model is claim-only on the Lambda side anyway.\n//\n// Exported so TelemetryClient setters can detect unparseable tokens at\n// configuration time and surface a single warning, instead of silently\n// emitting anonymous events on every capture.\nexport function parseTelemetryIdFromLicense(token?: string): string | null {\n if (!token) return null;\n const parts = token.split(\".\");\n if (parts.length !== 3) return null;\n try {\n const payload = parts[1];\n if (!/^[A-Za-z0-9_-]+$/.test(payload) || payload.length % 4 === 1) {\n return null;\n }\n\n let b64 = payload.replace(/-/g, \"+\").replace(/_/g, \"/\");\n const padding = (4 - (b64.length % 4)) % 4;\n b64 += \"=\".repeat(padding);\n const json =\n typeof Buffer !== \"undefined\"\n ? Buffer.from(b64, \"base64\").toString(\"utf8\")\n : new TextDecoder().decode(\n Uint8Array.from(atob(b64), (character) => character.charCodeAt(0)),\n );\n const decoded = JSON.parse(json) as { telemetry_id?: unknown };\n const telemetryId =\n typeof decoded.telemetry_id === \"string\"\n ? decoded.telemetry_id\n : undefined;\n return firstNonBlankTelemetryId(telemetryId) ?? null;\n } catch {\n return null;\n }\n}\n\n// Parse the telemetry_id from a license token AND emit the rollout smoke\n// signal if the parse returned null. Returning the parsed id lets callers\n// cache it in one step (avoiding a second parseTelemetryIdFromLicense\n// pass) while keeping the warn text in lockstep between v1 (shared) and\n// v2 (runtime) TelemetryClient.setLicenseToken.\nexport function parseAndWarnTelemetryId(licenseToken: string): string | null {\n const telemetryId = parseTelemetryIdFromLicense(licenseToken);\n if (!telemetryId) {\n console.warn(\n \"[CopilotKit] License token did not yield a telemetry_id; telemetry events will be sent anonymously.\",\n );\n }\n return telemetryId;\n}\n\nexport async function send(opts: LambdaSendOptions): Promise<void> {\n try {\n const body = JSON.stringify({\n event: opts.event,\n properties: stripCloudKeys(opts.properties),\n global_properties: stripCloudKeys(opts.globalProperties),\n package: {\n name: opts.packageName,\n version: opts.packageVersion,\n },\n ts: Math.floor(Date.now() / 1000),\n });\n\n const telemetryId =\n firstNonBlankTelemetryId(opts.telemetryId) ??\n parseTelemetryIdFromLicense(opts.licenseToken);\n const headers: Record<string, string> = {\n \"Content-Type\": \"application/json\",\n \"User-Agent\": opts.packageName\n ? `CopilotKit-Runtime/${opts.packageVersion ?? \"unknown\"} (${opts.packageName})`\n : \"CopilotKit-Runtime\",\n };\n if (telemetryId) {\n headers[\"X-CopilotKit-Telemetry-Id\"] = telemetryId;\n }\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n try {\n await fetch(TELEMETRY_SINK_URL, {\n method: \"POST\",\n headers,\n body,\n signal: controller.signal,\n });\n } finally {\n clearTimeout(timeoutId);\n }\n } catch {\n // Silent failure — telemetry must not break the application.\n }\n}\n\nexport const lambdaClient = { send };\n"],"mappings":";AA2BA,MAAM,qBACH,OAAO,YAAY,eAAe,QAAQ,KAAK,4BAChD;AAEF,MAAM,mBAAmB;AACzB,MAAM,uBAAuB;;;;;;;;;;;AA2B7B,SAAgB,yBACd,GAAG,YACiB;AACpB,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,cAAc,OAChB;EAGF,MAAM,aAAa,UAAU,QAAQ,oBAAoB,GAAG;AAC5D,MAAI,qBAAqB,KAAK,WAAW,CACvC,QAAO;;;AAWb,MAAM,gBAAgB,IAAI,IAAI,CAAC,wBAAwB,qBAAqB,CAAC;AAE7E,SAAS,eACP,KACyB;AACzB,KAAI,CAAC,IAAK,QAAO,EAAE;CACnB,MAAM,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,CACtC,KAAI,CAAC,cAAc,IAAI,EAAE,CAAE,KAAI,KAAK;AAEtC,QAAO;;AAeT,SAAgB,4BAA4B,OAA+B;AACzE,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,KAAI;EACF,MAAM,UAAU,MAAM;AACtB,MAAI,CAAC,mBAAmB,KAAK,QAAQ,IAAI,QAAQ,SAAS,MAAM,EAC9D,QAAO;EAGT,IAAI,MAAM,QAAQ,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI;EACvD,MAAM,WAAW,IAAK,IAAI,SAAS,KAAM;AACzC,SAAO,IAAI,OAAO,QAAQ;EAC1B,MAAM,OACJ,OAAO,WAAW,cACd,OAAO,KAAK,KAAK,SAAS,CAAC,SAAS,OAAO,GAC3C,IAAI,aAAa,CAAC,OAChB,WAAW,KAAK,KAAK,IAAI,GAAG,cAAc,UAAU,WAAW,EAAE,CAAC,CACnE;EACP,MAAM,UAAU,KAAK,MAAM,KAAK;AAKhC,SAAO,yBAHL,OAAO,QAAQ,iBAAiB,WAC5B,QAAQ,eACR,OACsC,IAAI;SAC1C;AACN,SAAO;;;AASX,SAAgB,wBAAwB,cAAqC;CAC3E,MAAM,cAAc,4BAA4B,aAAa;AAC7D,KAAI,CAAC,YACH,SAAQ,KACN,sGACD;AAEH,QAAO;;AAGT,eAAsB,KAAK,MAAwC;AACjE,KAAI;EACF,MAAM,OAAO,KAAK,UAAU;GAC1B,OAAO,KAAK;GACZ,YAAY,eAAe,KAAK,WAAW;GAC3C,mBAAmB,eAAe,KAAK,iBAAiB;GACxD,SAAS;IACP,MAAM,KAAK;IACX,SAAS,KAAK;IACf;GACD,IAAI,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;GAClC,CAAC;EAEF,MAAM,cACJ,yBAAyB,KAAK,YAAY,IAC1C,4BAA4B,KAAK,aAAa;EAChD,MAAM,UAAkC;GACtC,gBAAgB;GAChB,cAAc,KAAK,cACf,sBAAsB,KAAK,kBAAkB,UAAU,IAAI,KAAK,YAAY,KAC5E;GACL;AACD,MAAI,YACF,SAAQ,+BAA+B;EAGzC,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,iBAAiB;AACxE,MAAI;AACF,SAAM,MAAM,oBAAoB;IAC9B,QAAQ;IACR;IACA;IACA,QAAQ,WAAW;IACpB,CAAC;YACM;AACR,gBAAa,UAAU;;SAEnB;;AAKV,MAAa,eAAe,EAAE,MAAM"}
|
package/dist/telemetry/utils.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/telemetry/utils.ts"],"sourcesContent":["
|
|
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"}
|
package/dist/telemetry/utils.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/telemetry/utils.ts"],"sourcesContent":["
|
|
1
|
+
{"version":3,"file":"utils.mjs","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"}
|
package/dist/utils/index.d.cts
CHANGED
|
@@ -4,7 +4,7 @@ import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled,
|
|
|
4
4
|
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";
|
|
5
5
|
import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.cjs";
|
|
6
6
|
import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.cjs";
|
|
7
|
-
import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.cjs";
|
|
7
|
+
import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.cjs";
|
|
8
8
|
import { InspectorVisibilityOptions, shouldEnableInspector } from "./inspector-visibility.cjs";
|
|
9
9
|
import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo } from "./types.cjs";
|
|
10
10
|
import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.cjs";
|
package/dist/utils/index.d.mts
CHANGED
|
@@ -4,7 +4,7 @@ import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled,
|
|
|
4
4
|
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";
|
|
5
5
|
import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.mjs";
|
|
6
6
|
import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.mjs";
|
|
7
|
-
import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.mjs";
|
|
7
|
+
import { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl } from "./inspector-learning.mjs";
|
|
8
8
|
import { InspectorVisibilityOptions, shouldEnableInspector } from "./inspector-visibility.mjs";
|
|
9
9
|
import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeEntitlementResponse, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, SingleRouteRuntimeInfo, ThreadEndpointRuntimeInfo } from "./types.mjs";
|
|
10
10
|
import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.mjs";
|
|
@@ -40,11 +40,23 @@ function parseEvidence(value) {
|
|
|
40
40
|
updatedAt: value.updatedAt
|
|
41
41
|
};
|
|
42
42
|
}
|
|
43
|
-
function
|
|
43
|
+
function parseTrajectoryEvidence(value, webAppOrigin) {
|
|
44
|
+
if (record(value) && value.status === "unavailable") return Object.keys(value).length === 1 ? { status: "unavailable" } : void 0;
|
|
45
|
+
if (!record(value) || value.status !== "available" || !string(value.trajectoryId, 128) || !integer(value.eventCount)) return;
|
|
46
|
+
const url = parseInspectorLearningUrl(value.url, webAppOrigin);
|
|
47
|
+
if (!url) return void 0;
|
|
48
|
+
return {
|
|
49
|
+
status: "available",
|
|
50
|
+
trajectoryId: value.trajectoryId,
|
|
51
|
+
eventCount: value.eventCount,
|
|
52
|
+
url
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
function parseInsight(value, webAppOrigin) {
|
|
44
56
|
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;
|
|
45
57
|
const evidence = value.evidence.map(parseEvidence);
|
|
46
58
|
if (evidence.some((item) => item === void 0)) return void 0;
|
|
47
|
-
|
|
59
|
+
const insight = {
|
|
48
60
|
id: value.id,
|
|
49
61
|
statement: value.statement,
|
|
50
62
|
impact: value.impact,
|
|
@@ -52,10 +64,27 @@ function parseInsight(value) {
|
|
|
52
64
|
evidenceTruncated: value.evidenceTruncated,
|
|
53
65
|
evidence
|
|
54
66
|
};
|
|
67
|
+
let totalTrajectoryCount;
|
|
68
|
+
if (value.totalTrajectoryCount !== void 0) {
|
|
69
|
+
if (!integer(value.totalTrajectoryCount)) return void 0;
|
|
70
|
+
totalTrajectoryCount = value.totalTrajectoryCount;
|
|
71
|
+
}
|
|
72
|
+
let trajectoryEvidence;
|
|
73
|
+
if (value.trajectoryEvidence !== void 0) {
|
|
74
|
+
if (!Array.isArray(value.trajectoryEvidence) || value.trajectoryEvidence.length > 100) return;
|
|
75
|
+
const parsed = value.trajectoryEvidence.map((item) => parseTrajectoryEvidence(item, webAppOrigin));
|
|
76
|
+
if (parsed.some((item) => item === void 0)) return void 0;
|
|
77
|
+
trajectoryEvidence = parsed;
|
|
78
|
+
}
|
|
79
|
+
return {
|
|
80
|
+
...insight,
|
|
81
|
+
...totalTrajectoryCount === void 0 ? {} : { totalTrajectoryCount },
|
|
82
|
+
...trajectoryEvidence === void 0 ? {} : { trajectoryEvidence }
|
|
83
|
+
};
|
|
55
84
|
}
|
|
56
|
-
function parseSkill(value) {
|
|
85
|
+
function parseSkill(value, webAppOrigin) {
|
|
57
86
|
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;
|
|
58
|
-
const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight);
|
|
87
|
+
const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight, webAppOrigin);
|
|
59
88
|
if (sourceInsight === void 0) return void 0;
|
|
60
89
|
return {
|
|
61
90
|
id: value.id,
|
|
@@ -112,9 +141,12 @@ const runStatuses = new Set([
|
|
|
112
141
|
/** Validates and copies an untrusted Learning snapshot at each process boundary. */
|
|
113
142
|
function parseInspectorLearningSnapshotV1(value) {
|
|
114
143
|
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;
|
|
144
|
+
const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
|
|
145
|
+
if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
|
|
146
|
+
const webAppOrigin = new URL(originUrl).origin;
|
|
115
147
|
const configuration = parseConfiguration(value.configuration);
|
|
116
|
-
const skillsPage = parsePage(value.skillsPage, 3, parseSkill);
|
|
117
|
-
const insightsPage = parsePage(value.insightsPage, 4, parseInsight);
|
|
148
|
+
const skillsPage = parsePage(value.skillsPage, 3, (item) => parseSkill(item, webAppOrigin));
|
|
149
|
+
const insightsPage = parsePage(value.insightsPage, 4, (item) => parseInsight(item, webAppOrigin));
|
|
118
150
|
if (!configuration || !skillsPage || !insightsPage) return void 0;
|
|
119
151
|
let latest = null;
|
|
120
152
|
if (value.run.latest !== null) {
|
|
@@ -128,9 +160,6 @@ function parseInspectorLearningSnapshotV1(value) {
|
|
|
128
160
|
};
|
|
129
161
|
}
|
|
130
162
|
if (!record(value.links)) return void 0;
|
|
131
|
-
const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
|
|
132
|
-
if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
|
|
133
|
-
const webAppOrigin = new URL(originUrl).origin;
|
|
134
163
|
const learning = parseInspectorLearningUrl(value.links.learning, webAppOrigin);
|
|
135
164
|
const candidates = value.links.candidates === null ? null : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);
|
|
136
165
|
const runs = value.links.runs === null ? null : parseInspectorLearningUrl(value.links.runs, webAppOrigin);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inspector-learning.cjs","names":[],"sources":["../../src/utils/inspector-learning.ts"],"sourcesContent":["/** A bounded page in the Inspector Learning snapshot. */\nexport interface InspectorLearningPage<T> {\n readonly page: number;\n readonly pageSize: number;\n readonly total: number;\n readonly totalPages: number;\n readonly items: readonly T[];\n}\n\nexport type InspectorLearningEvidence =\n | {\n readonly status: \"available\";\n readonly threadId: string;\n readonly threadName: string | null;\n readonly messageIds: readonly string[];\n readonly updatedAt: string;\n }\n | { readonly status: \"unavailable\" };\n\nexport interface InspectorLearningInsight {\n readonly id: string;\n readonly statement: string;\n readonly impact: string;\n readonly totalThreadCount: number;\n readonly evidenceTruncated: boolean;\n readonly evidence: readonly InspectorLearningEvidence[];\n}\n\nexport interface InspectorLearningSkill {\n readonly id: string;\n readonly name: string;\n readonly description: string;\n readonly revision: number;\n readonly skillMd: string;\n readonly sourceInsight: InspectorLearningInsight | null;\n}\n\nexport interface InspectorLearningSnapshotV1 {\n readonly schemaVersion: 1;\n readonly projectKey: string;\n readonly snapshotVersion: string;\n readonly webAppOrigin: string;\n readonly configuration:\n | { readonly state: \"not_configured\" }\n | {\n readonly state: \"invalid\";\n readonly reason: \"container\" | \"instrumentation\";\n }\n | {\n readonly state: \"configured\";\n readonly container: { readonly id: string; readonly name: string };\n }\n | { readonly state: \"selection_required\" };\n readonly pendingThreadCount: number;\n readonly run: {\n readonly hasActiveRun: boolean;\n readonly hasEverSucceeded: boolean;\n readonly latest: {\n readonly completedAt: string | null;\n readonly status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n } | null;\n };\n readonly pendingCandidateCount: number;\n readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;\n readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;\n readonly links: {\n readonly learning: string;\n readonly candidates: string | null;\n readonly runs: string | null;\n };\n}\n\nexport interface InspectorLearningRequestV1 {\n readonly agentId?: string;\n readonly skillsPage?: number;\n readonly insightsPage?: number;\n}\n\ntype RecordValue = Record<string, unknown>;\n\nconst record = (value: unknown): value is RecordValue =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst string = (value: unknown, maximum: number): value is string =>\n typeof value === \"string\" &&\n value.trim().length > 0 &&\n value.length <= maximum;\nconst integer = (value: unknown, minimum = 0): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value >= minimum;\nconst date = (value: unknown): value is string =>\n typeof value === \"string\" && !Number.isNaN(Date.parse(value));\n\n/**\n * Accepts only the configured Intelligence web-app origin.\n *\n * Learning links are server-authored actions. Treating every HTTPS origin as\n * trusted would let a misconfigured or compromised upstream turn Inspector\n * copy into a navigation primitive for an arbitrary site.\n */\nexport function parseInspectorLearningUrl(\n value: unknown,\n trustedOrigin: unknown,\n): string | undefined {\n if (\n typeof value !== \"string\" ||\n value.length > 4_000 ||\n typeof trustedOrigin !== \"string\" ||\n trustedOrigin.length > 2_000\n ) {\n return undefined;\n }\n try {\n const parsed = new URL(value);\n const configured = new URL(trustedOrigin);\n const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(\n configured.hostname,\n );\n if (\n parsed.username ||\n parsed.password ||\n configured.username ||\n configured.password ||\n configured.pathname !== \"/\" ||\n configured.search ||\n configured.hash ||\n (configured.protocol !== \"https:\" &&\n !(configured.protocol === \"http:\" && loopback)) ||\n parsed.origin !== configured.origin\n ) {\n return undefined;\n }\n return parsed.toString();\n } catch {\n return undefined;\n }\n}\n\nfunction parseEvidence(value: unknown): InspectorLearningEvidence | undefined {\n if (record(value) && value.status === \"unavailable\") {\n return Object.keys(value).length === 1\n ? { status: \"unavailable\" }\n : undefined;\n }\n if (\n !record(value) ||\n value.status !== \"available\" ||\n !string(value.threadId, 128) ||\n !date(value.updatedAt)\n ) {\n return undefined;\n }\n if (\n value.threadName !== null &&\n !(typeof value.threadName === \"string\" && value.threadName.length <= 4_000)\n ) {\n return undefined;\n }\n if (\n !Array.isArray(value.messageIds) ||\n value.messageIds.length > 200 ||\n !value.messageIds.every((id) => string(id, 128))\n ) {\n return undefined;\n }\n return {\n status: \"available\",\n threadId: value.threadId,\n threadName: value.threadName,\n messageIds: [...value.messageIds],\n updatedAt: value.updatedAt,\n };\n}\n\nfunction parseInsight(value: unknown): InspectorLearningInsight | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.statement, 4_000) ||\n !string(value.impact, 4_000) ||\n !integer(value.totalThreadCount) ||\n typeof value.evidenceTruncated !== \"boolean\" ||\n !Array.isArray(value.evidence) ||\n value.evidence.length > 100\n ) {\n return undefined;\n }\n const evidence = value.evidence.map(parseEvidence);\n if (evidence.some((item) => item === undefined)) return undefined;\n return {\n id: value.id,\n statement: value.statement,\n impact: value.impact,\n totalThreadCount: value.totalThreadCount,\n evidenceTruncated: value.evidenceTruncated,\n evidence: evidence as InspectorLearningEvidence[],\n };\n}\n\nfunction parseSkill(value: unknown): InspectorLearningSkill | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.name, 128) ||\n !string(value.description, 4_000) ||\n !integer(value.revision, 1) ||\n typeof value.skillMd !== \"string\" ||\n value.skillMd.length > 131_072\n ) {\n return undefined;\n }\n const sourceInsight =\n value.sourceInsight === null ? null : parseInsight(value.sourceInsight);\n if (sourceInsight === undefined) return undefined;\n return {\n id: value.id,\n name: value.name,\n description: value.description,\n revision: value.revision,\n skillMd: value.skillMd,\n sourceInsight,\n };\n}\n\nfunction parsePage<T>(\n value: unknown,\n pageSize: 3 | 4,\n parseItem: (item: unknown) => T | undefined,\n): InspectorLearningPage<T> | undefined {\n if (\n !record(value) ||\n !integer(value.page, 1) ||\n value.pageSize !== pageSize ||\n !integer(value.total) ||\n !integer(value.totalPages) ||\n !Array.isArray(value.items) ||\n value.items.length > pageSize\n ) {\n return undefined;\n }\n const items = value.items.map(parseItem);\n if (items.some((item) => item === undefined)) return undefined;\n if (value.total === 0) {\n if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) {\n return undefined;\n }\n } else {\n const totalPages = Math.ceil(value.total / pageSize);\n const expectedItems = Math.min(\n pageSize,\n value.total - (value.page - 1) * pageSize,\n );\n if (\n value.totalPages !== totalPages ||\n value.page > totalPages ||\n items.length !== expectedItems\n ) {\n return undefined;\n }\n }\n return {\n page: value.page,\n pageSize,\n total: value.total,\n totalPages: value.totalPages,\n items: items as T[],\n };\n}\n\nfunction parseConfiguration(\n value: unknown,\n): InspectorLearningSnapshotV1[\"configuration\"] | undefined {\n if (!record(value)) return undefined;\n if (\n value.state === \"not_configured\" ||\n value.state === \"selection_required\"\n ) {\n return { state: value.state };\n }\n if (\n value.state === \"invalid\" &&\n (value.reason === \"container\" || value.reason === \"instrumentation\")\n ) {\n return { state: value.state, reason: value.reason };\n }\n if (\n value.state === \"configured\" &&\n record(value.container) &&\n string(value.container.id, 128) &&\n string(value.container.name, 128)\n ) {\n return {\n state: \"configured\",\n container: { id: value.container.id, name: value.container.name },\n };\n }\n return undefined;\n}\n\nconst runStatuses = new Set([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n]);\n\n/** Validates and copies an untrusted Learning snapshot at each process boundary. */\nexport function parseInspectorLearningSnapshotV1(\n value: unknown,\n): InspectorLearningSnapshotV1 | undefined {\n if (\n !record(value) ||\n value.schemaVersion !== 1 ||\n !string(value.projectKey, 128) ||\n !string(value.snapshotVersion, 128) ||\n !integer(value.pendingThreadCount) ||\n !integer(value.pendingCandidateCount) ||\n !record(value.run) ||\n typeof value.run.hasActiveRun !== \"boolean\" ||\n typeof value.run.hasEverSucceeded !== \"boolean\"\n ) {\n return undefined;\n }\n const configuration = parseConfiguration(value.configuration);\n const skillsPage = parsePage(value.skillsPage, 3, parseSkill);\n const insightsPage = parsePage(value.insightsPage, 4, parseInsight);\n if (!configuration || !skillsPage || !insightsPage) return undefined;\n let latest: InspectorLearningSnapshotV1[\"run\"][\"latest\"] = null;\n if (value.run.latest !== null) {\n const latestRun = value.run.latest;\n if (!record(latestRun)) {\n return undefined;\n }\n const { status, completedAt } = latestRun;\n if (\n typeof status !== \"string\" ||\n !runStatuses.has(status) ||\n (completedAt !== null && !date(completedAt))\n )\n return undefined;\n latest = {\n status: status as NonNullable<typeof latest>[\"status\"],\n completedAt: completedAt as NonNullable<typeof latest>[\"completedAt\"],\n };\n }\n if (!record(value.links)) return undefined;\n const originUrl = parseInspectorLearningUrl(\n value.webAppOrigin,\n value.webAppOrigin,\n );\n if (!originUrl || new URL(originUrl).pathname !== \"/\") return undefined;\n const webAppOrigin = new URL(originUrl).origin;\n const learning = parseInspectorLearningUrl(\n value.links.learning,\n webAppOrigin,\n );\n const candidates =\n value.links.candidates === null\n ? null\n : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);\n const runs =\n value.links.runs === null\n ? null\n : parseInspectorLearningUrl(value.links.runs, webAppOrigin);\n if (\n !learning ||\n candidates === undefined ||\n runs === undefined ||\n (value.pendingThreadCount > 0 && runs === null) ||\n (value.pendingCandidateCount > 0 && candidates === null)\n )\n return undefined;\n return {\n schemaVersion: 1,\n projectKey: value.projectKey,\n snapshotVersion: value.snapshotVersion,\n webAppOrigin,\n configuration,\n pendingThreadCount: value.pendingThreadCount,\n run: {\n hasActiveRun: value.run.hasActiveRun,\n hasEverSucceeded: value.run.hasEverSucceeded,\n latest,\n },\n pendingCandidateCount: value.pendingCandidateCount,\n skillsPage,\n insightsPage,\n links: { learning, candidates, runs },\n };\n}\n\n/** Normalizes the browser-owned request without accepting container scope. */\nexport function parseInspectorLearningRequestV1(\n value: unknown,\n): InspectorLearningRequestV1 | undefined {\n if (!record(value)) return undefined;\n if (\n Object.keys(value).some(\n (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n )\n ) {\n return undefined;\n }\n const agentId = value.agentId;\n const skillsPage = value.skillsPage;\n const insightsPage = value.insightsPage;\n if (agentId !== undefined && !string(agentId, 128)) return undefined;\n if (skillsPage !== undefined && !integer(skillsPage, 1)) return undefined;\n if (insightsPage !== undefined && !integer(insightsPage, 1)) return undefined;\n return {\n ...(agentId === undefined ? {} : { agentId }),\n ...(skillsPage === undefined ? {} : { skillsPage }),\n ...(insightsPage === undefined ? {} : { insightsPage }),\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"inspector-learning.cjs","names":[],"sources":["../../src/utils/inspector-learning.ts"],"sourcesContent":["/** A bounded page in the Inspector Learning snapshot. */\nexport interface InspectorLearningPage<T> {\n readonly page: number;\n readonly pageSize: number;\n readonly total: number;\n readonly totalPages: number;\n readonly items: readonly T[];\n}\n\nexport type InspectorLearningEvidence =\n | {\n readonly status: \"available\";\n readonly threadId: string;\n readonly threadName: string | null;\n readonly messageIds: readonly string[];\n readonly updatedAt: string;\n }\n | { readonly status: \"unavailable\" };\n\n/** A cited Trajectory, linked into the Intelligence web app. */\nexport type InspectorLearningTrajectoryEvidence =\n | {\n readonly status: \"available\";\n readonly trajectoryId: string;\n readonly eventCount: number;\n readonly url: string;\n }\n | { readonly status: \"unavailable\" };\n\nexport interface InspectorLearningInsight {\n readonly id: string;\n readonly statement: string;\n readonly impact: string;\n readonly totalThreadCount: number;\n readonly evidenceTruncated: boolean;\n readonly evidence: readonly InspectorLearningEvidence[];\n /** Absent when Intelligence predates Trajectory evidence. */\n readonly totalTrajectoryCount?: number;\n /** Absent when Intelligence predates Trajectory evidence. */\n readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];\n}\n\nexport interface InspectorLearningSkill {\n readonly id: string;\n readonly name: string;\n readonly description: string;\n readonly revision: number;\n readonly skillMd: string;\n readonly sourceInsight: InspectorLearningInsight | null;\n}\n\nexport interface InspectorLearningSnapshotV1 {\n readonly schemaVersion: 1;\n readonly projectKey: string;\n readonly snapshotVersion: string;\n readonly webAppOrigin: string;\n readonly configuration:\n | { readonly state: \"not_configured\" }\n | {\n readonly state: \"invalid\";\n readonly reason: \"container\" | \"instrumentation\";\n }\n | {\n readonly state: \"configured\";\n readonly container: { readonly id: string; readonly name: string };\n }\n | { readonly state: \"selection_required\" };\n readonly pendingThreadCount: number;\n readonly run: {\n readonly hasActiveRun: boolean;\n readonly hasEverSucceeded: boolean;\n readonly latest: {\n readonly completedAt: string | null;\n readonly status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n } | null;\n };\n readonly pendingCandidateCount: number;\n readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;\n readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;\n readonly links: {\n readonly learning: string;\n readonly candidates: string | null;\n readonly runs: string | null;\n };\n}\n\nexport interface InspectorLearningRequestV1 {\n readonly agentId?: string;\n readonly skillsPage?: number;\n readonly insightsPage?: number;\n}\n\ntype RecordValue = Record<string, unknown>;\n\nconst record = (value: unknown): value is RecordValue =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst string = (value: unknown, maximum: number): value is string =>\n typeof value === \"string\" &&\n value.trim().length > 0 &&\n value.length <= maximum;\nconst integer = (value: unknown, minimum = 0): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value >= minimum;\nconst date = (value: unknown): value is string =>\n typeof value === \"string\" && !Number.isNaN(Date.parse(value));\n\n/**\n * Accepts only the configured Intelligence web-app origin.\n *\n * Learning links are server-authored actions. Treating every HTTPS origin as\n * trusted would let a misconfigured or compromised upstream turn Inspector\n * copy into a navigation primitive for an arbitrary site.\n */\nexport function parseInspectorLearningUrl(\n value: unknown,\n trustedOrigin: unknown,\n): string | undefined {\n if (\n typeof value !== \"string\" ||\n value.length > 4_000 ||\n typeof trustedOrigin !== \"string\" ||\n trustedOrigin.length > 2_000\n ) {\n return undefined;\n }\n try {\n const parsed = new URL(value);\n const configured = new URL(trustedOrigin);\n const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(\n configured.hostname,\n );\n if (\n parsed.username ||\n parsed.password ||\n configured.username ||\n configured.password ||\n configured.pathname !== \"/\" ||\n configured.search ||\n configured.hash ||\n (configured.protocol !== \"https:\" &&\n !(configured.protocol === \"http:\" && loopback)) ||\n parsed.origin !== configured.origin\n ) {\n return undefined;\n }\n return parsed.toString();\n } catch {\n return undefined;\n }\n}\n\nfunction parseEvidence(value: unknown): InspectorLearningEvidence | undefined {\n if (record(value) && value.status === \"unavailable\") {\n return Object.keys(value).length === 1\n ? { status: \"unavailable\" }\n : undefined;\n }\n if (\n !record(value) ||\n value.status !== \"available\" ||\n !string(value.threadId, 128) ||\n !date(value.updatedAt)\n ) {\n return undefined;\n }\n if (\n value.threadName !== null &&\n !(typeof value.threadName === \"string\" && value.threadName.length <= 4_000)\n ) {\n return undefined;\n }\n if (\n !Array.isArray(value.messageIds) ||\n value.messageIds.length > 200 ||\n !value.messageIds.every((id) => string(id, 128))\n ) {\n return undefined;\n }\n return {\n status: \"available\",\n threadId: value.threadId,\n threadName: value.threadName,\n messageIds: [...value.messageIds],\n updatedAt: value.updatedAt,\n };\n}\n\nfunction parseTrajectoryEvidence(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningTrajectoryEvidence | undefined {\n if (record(value) && value.status === \"unavailable\") {\n return Object.keys(value).length === 1\n ? { status: \"unavailable\" }\n : undefined;\n }\n if (\n !record(value) ||\n value.status !== \"available\" ||\n !string(value.trajectoryId, 128) ||\n !integer(value.eventCount)\n ) {\n return undefined;\n }\n const url = parseInspectorLearningUrl(value.url, webAppOrigin);\n if (!url) return undefined;\n return {\n status: \"available\",\n trajectoryId: value.trajectoryId,\n eventCount: value.eventCount,\n url,\n };\n}\n\nfunction parseInsight(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningInsight | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.statement, 4_000) ||\n !string(value.impact, 4_000) ||\n !integer(value.totalThreadCount) ||\n typeof value.evidenceTruncated !== \"boolean\" ||\n !Array.isArray(value.evidence) ||\n value.evidence.length > 100\n ) {\n return undefined;\n }\n const evidence = value.evidence.map(parseEvidence);\n if (evidence.some((item) => item === undefined)) return undefined;\n const insight: InspectorLearningInsight = {\n id: value.id,\n statement: value.statement,\n impact: value.impact,\n totalThreadCount: value.totalThreadCount,\n evidenceTruncated: value.evidenceTruncated,\n evidence: evidence as InspectorLearningEvidence[],\n };\n // Each Trajectory field is optional on its own; a malformed one rejects\n // the Insight, an absent one leaves the Thread-only shape untouched.\n let totalTrajectoryCount: number | undefined;\n if (value.totalTrajectoryCount !== undefined) {\n if (!integer(value.totalTrajectoryCount)) return undefined;\n totalTrajectoryCount = value.totalTrajectoryCount;\n }\n let trajectoryEvidence: InspectorLearningTrajectoryEvidence[] | undefined;\n if (value.trajectoryEvidence !== undefined) {\n if (\n !Array.isArray(value.trajectoryEvidence) ||\n value.trajectoryEvidence.length > 100\n ) {\n return undefined;\n }\n const parsed = value.trajectoryEvidence.map((item) =>\n parseTrajectoryEvidence(item, webAppOrigin),\n );\n if (parsed.some((item) => item === undefined)) return undefined;\n trajectoryEvidence = parsed as InspectorLearningTrajectoryEvidence[];\n }\n return {\n ...insight,\n ...(totalTrajectoryCount === undefined ? {} : { totalTrajectoryCount }),\n ...(trajectoryEvidence === undefined ? {} : { trajectoryEvidence }),\n };\n}\n\nfunction parseSkill(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningSkill | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.name, 128) ||\n !string(value.description, 4_000) ||\n !integer(value.revision, 1) ||\n typeof value.skillMd !== \"string\" ||\n value.skillMd.length > 131_072\n ) {\n return undefined;\n }\n const sourceInsight =\n value.sourceInsight === null\n ? null\n : parseInsight(value.sourceInsight, webAppOrigin);\n if (sourceInsight === undefined) return undefined;\n return {\n id: value.id,\n name: value.name,\n description: value.description,\n revision: value.revision,\n skillMd: value.skillMd,\n sourceInsight,\n };\n}\n\nfunction parsePage<T>(\n value: unknown,\n pageSize: 3 | 4,\n parseItem: (item: unknown) => T | undefined,\n): InspectorLearningPage<T> | undefined {\n if (\n !record(value) ||\n !integer(value.page, 1) ||\n value.pageSize !== pageSize ||\n !integer(value.total) ||\n !integer(value.totalPages) ||\n !Array.isArray(value.items) ||\n value.items.length > pageSize\n ) {\n return undefined;\n }\n const items = value.items.map(parseItem);\n if (items.some((item) => item === undefined)) return undefined;\n if (value.total === 0) {\n if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) {\n return undefined;\n }\n } else {\n const totalPages = Math.ceil(value.total / pageSize);\n const expectedItems = Math.min(\n pageSize,\n value.total - (value.page - 1) * pageSize,\n );\n if (\n value.totalPages !== totalPages ||\n value.page > totalPages ||\n items.length !== expectedItems\n ) {\n return undefined;\n }\n }\n return {\n page: value.page,\n pageSize,\n total: value.total,\n totalPages: value.totalPages,\n items: items as T[],\n };\n}\n\nfunction parseConfiguration(\n value: unknown,\n): InspectorLearningSnapshotV1[\"configuration\"] | undefined {\n if (!record(value)) return undefined;\n if (\n value.state === \"not_configured\" ||\n value.state === \"selection_required\"\n ) {\n return { state: value.state };\n }\n if (\n value.state === \"invalid\" &&\n (value.reason === \"container\" || value.reason === \"instrumentation\")\n ) {\n return { state: value.state, reason: value.reason };\n }\n if (\n value.state === \"configured\" &&\n record(value.container) &&\n string(value.container.id, 128) &&\n string(value.container.name, 128)\n ) {\n return {\n state: \"configured\",\n container: { id: value.container.id, name: value.container.name },\n };\n }\n return undefined;\n}\n\nconst runStatuses = new Set([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n]);\n\n/** Validates and copies an untrusted Learning snapshot at each process boundary. */\nexport function parseInspectorLearningSnapshotV1(\n value: unknown,\n): InspectorLearningSnapshotV1 | undefined {\n if (\n !record(value) ||\n value.schemaVersion !== 1 ||\n !string(value.projectKey, 128) ||\n !string(value.snapshotVersion, 128) ||\n !integer(value.pendingThreadCount) ||\n !integer(value.pendingCandidateCount) ||\n !record(value.run) ||\n typeof value.run.hasActiveRun !== \"boolean\" ||\n typeof value.run.hasEverSucceeded !== \"boolean\"\n ) {\n return undefined;\n }\n const originUrl = parseInspectorLearningUrl(\n value.webAppOrigin,\n value.webAppOrigin,\n );\n if (!originUrl || new URL(originUrl).pathname !== \"/\") return undefined;\n const webAppOrigin = new URL(originUrl).origin;\n const configuration = parseConfiguration(value.configuration);\n const skillsPage = parsePage(value.skillsPage, 3, (item) =>\n parseSkill(item, webAppOrigin),\n );\n const insightsPage = parsePage(value.insightsPage, 4, (item) =>\n parseInsight(item, webAppOrigin),\n );\n if (!configuration || !skillsPage || !insightsPage) return undefined;\n let latest: InspectorLearningSnapshotV1[\"run\"][\"latest\"] = null;\n if (value.run.latest !== null) {\n const latestRun = value.run.latest;\n if (!record(latestRun)) {\n return undefined;\n }\n const { status, completedAt } = latestRun;\n if (\n typeof status !== \"string\" ||\n !runStatuses.has(status) ||\n (completedAt !== null && !date(completedAt))\n )\n return undefined;\n latest = {\n status: status as NonNullable<typeof latest>[\"status\"],\n completedAt: completedAt as NonNullable<typeof latest>[\"completedAt\"],\n };\n }\n if (!record(value.links)) return undefined;\n const learning = parseInspectorLearningUrl(\n value.links.learning,\n webAppOrigin,\n );\n const candidates =\n value.links.candidates === null\n ? null\n : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);\n const runs =\n value.links.runs === null\n ? null\n : parseInspectorLearningUrl(value.links.runs, webAppOrigin);\n if (\n !learning ||\n candidates === undefined ||\n runs === undefined ||\n (value.pendingThreadCount > 0 && runs === null) ||\n (value.pendingCandidateCount > 0 && candidates === null)\n )\n return undefined;\n return {\n schemaVersion: 1,\n projectKey: value.projectKey,\n snapshotVersion: value.snapshotVersion,\n webAppOrigin,\n configuration,\n pendingThreadCount: value.pendingThreadCount,\n run: {\n hasActiveRun: value.run.hasActiveRun,\n hasEverSucceeded: value.run.hasEverSucceeded,\n latest,\n },\n pendingCandidateCount: value.pendingCandidateCount,\n skillsPage,\n insightsPage,\n links: { learning, candidates, runs },\n };\n}\n\n/** Normalizes the browser-owned request without accepting container scope. */\nexport function parseInspectorLearningRequestV1(\n value: unknown,\n): InspectorLearningRequestV1 | undefined {\n if (!record(value)) return undefined;\n if (\n Object.keys(value).some(\n (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n )\n ) {\n return undefined;\n }\n const agentId = value.agentId;\n const skillsPage = value.skillsPage;\n const insightsPage = value.insightsPage;\n if (agentId !== undefined && !string(agentId, 128)) return undefined;\n if (skillsPage !== undefined && !integer(skillsPage, 1)) return undefined;\n if (insightsPage !== undefined && !integer(insightsPage, 1)) return undefined;\n return {\n ...(agentId === undefined ? {} : { agentId }),\n ...(skillsPage === undefined ? {} : { skillsPage }),\n ...(insightsPage === undefined ? {} : { insightsPage }),\n };\n}\n"],"mappings":"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"}
|
|
@@ -16,6 +16,15 @@ type InspectorLearningEvidence = {
|
|
|
16
16
|
} | {
|
|
17
17
|
readonly status: "unavailable";
|
|
18
18
|
};
|
|
19
|
+
/** A cited Trajectory, linked into the Intelligence web app. */
|
|
20
|
+
type InspectorLearningTrajectoryEvidence = {
|
|
21
|
+
readonly status: "available";
|
|
22
|
+
readonly trajectoryId: string;
|
|
23
|
+
readonly eventCount: number;
|
|
24
|
+
readonly url: string;
|
|
25
|
+
} | {
|
|
26
|
+
readonly status: "unavailable";
|
|
27
|
+
};
|
|
19
28
|
interface InspectorLearningInsight {
|
|
20
29
|
readonly id: string;
|
|
21
30
|
readonly statement: string;
|
|
@@ -23,6 +32,10 @@ interface InspectorLearningInsight {
|
|
|
23
32
|
readonly totalThreadCount: number;
|
|
24
33
|
readonly evidenceTruncated: boolean;
|
|
25
34
|
readonly evidence: readonly InspectorLearningEvidence[];
|
|
35
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
36
|
+
readonly totalTrajectoryCount?: number;
|
|
37
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
38
|
+
readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];
|
|
26
39
|
}
|
|
27
40
|
interface InspectorLearningSkill {
|
|
28
41
|
readonly id: string;
|
|
@@ -87,5 +100,5 @@ declare function parseInspectorLearningSnapshotV1(value: unknown): InspectorLear
|
|
|
87
100
|
/** Normalizes the browser-owned request without accepting container scope. */
|
|
88
101
|
declare function parseInspectorLearningRequestV1(value: unknown): InspectorLearningRequestV1 | undefined;
|
|
89
102
|
//#endregion
|
|
90
|
-
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
103
|
+
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
91
104
|
//# sourceMappingURL=inspector-learning.d.cts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inspector-learning.d.cts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UACiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;AAAA;AAAA,
|
|
1
|
+
{"version":3,"file":"inspector-learning.d.cts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UACiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;;KAGH,mCAAA;EAAA,SAEG,MAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,GAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;EAVf;EAAA,SAYJ,oBAAA;EAVU;EAAA,SAYV,kBAAA,YAA8B,mCAAA;AAAA;AAAA,UAGxB,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,SACA,aAAA,EAAe,wBAAA;AAAA;AAAA,UAGT,2BAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;EAAA,SACA,aAAA;IAAA,SACM,KAAA;EAAA;IAAA,SAEA,KAAA;IAAA,SACA,MAAA;EAAA;IAAA,SAGA,KAAA;IAAA,SACA,SAAA;MAAA,SAAsB,EAAA;MAAA,SAAqB,IAAA;IAAA;EAAA;IAAA,SAE3C,KAAA;EAAA;EAAA,SACN,kBAAA;EAAA,SACA,GAAA;IAAA,SACE,YAAA;IAAA,SACA,gBAAA;IAAA,SACA,MAAA;MAAA,SACE,WAAA;MAAA,SACA,MAAA;IAAA;EAAA;EAAA,SAUJ,qBAAA;EAAA,SACA,UAAA,EAAY,qBAAA,CAAsB,sBAAA;EAAA,SAClC,YAAA,EAAc,qBAAA,CAAsB,wBAAA;EAAA,SACpC,KAAA;IAAA,SACE,QAAA;IAAA,SACA,UAAA;IAAA,SACA,IAAA;EAAA;AAAA;AAAA,UAII,0BAAA;EAAA,SACN,OAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;AAAA;;;;;;;;iBAuBK,yBAAA,CACd,KAAA,WACA,aAAA;;iBA6Qc,gCAAA,CACd,KAAA,YACC,2BAAA;;iBAuFa,+BAAA,CACd,KAAA,YACC,0BAAA"}
|
|
@@ -16,6 +16,15 @@ type InspectorLearningEvidence = {
|
|
|
16
16
|
} | {
|
|
17
17
|
readonly status: "unavailable";
|
|
18
18
|
};
|
|
19
|
+
/** A cited Trajectory, linked into the Intelligence web app. */
|
|
20
|
+
type InspectorLearningTrajectoryEvidence = {
|
|
21
|
+
readonly status: "available";
|
|
22
|
+
readonly trajectoryId: string;
|
|
23
|
+
readonly eventCount: number;
|
|
24
|
+
readonly url: string;
|
|
25
|
+
} | {
|
|
26
|
+
readonly status: "unavailable";
|
|
27
|
+
};
|
|
19
28
|
interface InspectorLearningInsight {
|
|
20
29
|
readonly id: string;
|
|
21
30
|
readonly statement: string;
|
|
@@ -23,6 +32,10 @@ interface InspectorLearningInsight {
|
|
|
23
32
|
readonly totalThreadCount: number;
|
|
24
33
|
readonly evidenceTruncated: boolean;
|
|
25
34
|
readonly evidence: readonly InspectorLearningEvidence[];
|
|
35
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
36
|
+
readonly totalTrajectoryCount?: number;
|
|
37
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
38
|
+
readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];
|
|
26
39
|
}
|
|
27
40
|
interface InspectorLearningSkill {
|
|
28
41
|
readonly id: string;
|
|
@@ -87,5 +100,5 @@ declare function parseInspectorLearningSnapshotV1(value: unknown): InspectorLear
|
|
|
87
100
|
/** Normalizes the browser-owned request without accepting container scope. */
|
|
88
101
|
declare function parseInspectorLearningRequestV1(value: unknown): InspectorLearningRequestV1 | undefined;
|
|
89
102
|
//#endregion
|
|
90
|
-
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
103
|
+
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
91
104
|
//# sourceMappingURL=inspector-learning.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inspector-learning.d.mts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UACiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;AAAA;AAAA,
|
|
1
|
+
{"version":3,"file":"inspector-learning.d.mts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UACiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;;KAGH,mCAAA;EAAA,SAEG,MAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,GAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;EAVf;EAAA,SAYJ,oBAAA;EAVU;EAAA,SAYV,kBAAA,YAA8B,mCAAA;AAAA;AAAA,UAGxB,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,SACA,aAAA,EAAe,wBAAA;AAAA;AAAA,UAGT,2BAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;EAAA,SACA,aAAA;IAAA,SACM,KAAA;EAAA;IAAA,SAEA,KAAA;IAAA,SACA,MAAA;EAAA;IAAA,SAGA,KAAA;IAAA,SACA,SAAA;MAAA,SAAsB,EAAA;MAAA,SAAqB,IAAA;IAAA;EAAA;IAAA,SAE3C,KAAA;EAAA;EAAA,SACN,kBAAA;EAAA,SACA,GAAA;IAAA,SACE,YAAA;IAAA,SACA,gBAAA;IAAA,SACA,MAAA;MAAA,SACE,WAAA;MAAA,SACA,MAAA;IAAA;EAAA;EAAA,SAUJ,qBAAA;EAAA,SACA,UAAA,EAAY,qBAAA,CAAsB,sBAAA;EAAA,SAClC,YAAA,EAAc,qBAAA,CAAsB,wBAAA;EAAA,SACpC,KAAA;IAAA,SACE,QAAA;IAAA,SACA,UAAA;IAAA,SACA,IAAA;EAAA;AAAA;AAAA,UAII,0BAAA;EAAA,SACN,OAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;AAAA;;;;;;;;iBAuBK,yBAAA,CACd,KAAA,WACA,aAAA;;iBA6Qc,gCAAA,CACd,KAAA,YACC,2BAAA;;iBAuFa,+BAAA,CACd,KAAA,YACC,0BAAA"}
|
|
@@ -39,11 +39,23 @@ function parseEvidence(value) {
|
|
|
39
39
|
updatedAt: value.updatedAt
|
|
40
40
|
};
|
|
41
41
|
}
|
|
42
|
-
function
|
|
42
|
+
function parseTrajectoryEvidence(value, webAppOrigin) {
|
|
43
|
+
if (record(value) && value.status === "unavailable") return Object.keys(value).length === 1 ? { status: "unavailable" } : void 0;
|
|
44
|
+
if (!record(value) || value.status !== "available" || !string(value.trajectoryId, 128) || !integer(value.eventCount)) return;
|
|
45
|
+
const url = parseInspectorLearningUrl(value.url, webAppOrigin);
|
|
46
|
+
if (!url) return void 0;
|
|
47
|
+
return {
|
|
48
|
+
status: "available",
|
|
49
|
+
trajectoryId: value.trajectoryId,
|
|
50
|
+
eventCount: value.eventCount,
|
|
51
|
+
url
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
function parseInsight(value, webAppOrigin) {
|
|
43
55
|
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;
|
|
44
56
|
const evidence = value.evidence.map(parseEvidence);
|
|
45
57
|
if (evidence.some((item) => item === void 0)) return void 0;
|
|
46
|
-
|
|
58
|
+
const insight = {
|
|
47
59
|
id: value.id,
|
|
48
60
|
statement: value.statement,
|
|
49
61
|
impact: value.impact,
|
|
@@ -51,10 +63,27 @@ function parseInsight(value) {
|
|
|
51
63
|
evidenceTruncated: value.evidenceTruncated,
|
|
52
64
|
evidence
|
|
53
65
|
};
|
|
66
|
+
let totalTrajectoryCount;
|
|
67
|
+
if (value.totalTrajectoryCount !== void 0) {
|
|
68
|
+
if (!integer(value.totalTrajectoryCount)) return void 0;
|
|
69
|
+
totalTrajectoryCount = value.totalTrajectoryCount;
|
|
70
|
+
}
|
|
71
|
+
let trajectoryEvidence;
|
|
72
|
+
if (value.trajectoryEvidence !== void 0) {
|
|
73
|
+
if (!Array.isArray(value.trajectoryEvidence) || value.trajectoryEvidence.length > 100) return;
|
|
74
|
+
const parsed = value.trajectoryEvidence.map((item) => parseTrajectoryEvidence(item, webAppOrigin));
|
|
75
|
+
if (parsed.some((item) => item === void 0)) return void 0;
|
|
76
|
+
trajectoryEvidence = parsed;
|
|
77
|
+
}
|
|
78
|
+
return {
|
|
79
|
+
...insight,
|
|
80
|
+
...totalTrajectoryCount === void 0 ? {} : { totalTrajectoryCount },
|
|
81
|
+
...trajectoryEvidence === void 0 ? {} : { trajectoryEvidence }
|
|
82
|
+
};
|
|
54
83
|
}
|
|
55
|
-
function parseSkill(value) {
|
|
84
|
+
function parseSkill(value, webAppOrigin) {
|
|
56
85
|
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;
|
|
57
|
-
const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight);
|
|
86
|
+
const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight, webAppOrigin);
|
|
58
87
|
if (sourceInsight === void 0) return void 0;
|
|
59
88
|
return {
|
|
60
89
|
id: value.id,
|
|
@@ -111,9 +140,12 @@ const runStatuses = new Set([
|
|
|
111
140
|
/** Validates and copies an untrusted Learning snapshot at each process boundary. */
|
|
112
141
|
function parseInspectorLearningSnapshotV1(value) {
|
|
113
142
|
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;
|
|
143
|
+
const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
|
|
144
|
+
if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
|
|
145
|
+
const webAppOrigin = new URL(originUrl).origin;
|
|
114
146
|
const configuration = parseConfiguration(value.configuration);
|
|
115
|
-
const skillsPage = parsePage(value.skillsPage, 3, parseSkill);
|
|
116
|
-
const insightsPage = parsePage(value.insightsPage, 4, parseInsight);
|
|
147
|
+
const skillsPage = parsePage(value.skillsPage, 3, (item) => parseSkill(item, webAppOrigin));
|
|
148
|
+
const insightsPage = parsePage(value.insightsPage, 4, (item) => parseInsight(item, webAppOrigin));
|
|
117
149
|
if (!configuration || !skillsPage || !insightsPage) return void 0;
|
|
118
150
|
let latest = null;
|
|
119
151
|
if (value.run.latest !== null) {
|
|
@@ -127,9 +159,6 @@ function parseInspectorLearningSnapshotV1(value) {
|
|
|
127
159
|
};
|
|
128
160
|
}
|
|
129
161
|
if (!record(value.links)) return void 0;
|
|
130
|
-
const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
|
|
131
|
-
if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
|
|
132
|
-
const webAppOrigin = new URL(originUrl).origin;
|
|
133
162
|
const learning = parseInspectorLearningUrl(value.links.learning, webAppOrigin);
|
|
134
163
|
const candidates = value.links.candidates === null ? null : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);
|
|
135
164
|
const runs = value.links.runs === null ? null : parseInspectorLearningUrl(value.links.runs, webAppOrigin);
|