@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
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inspector-learning.mjs","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.mjs","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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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@copilotkit/shared",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.80.0",
|
|
4
4
|
"private": false,
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -61,7 +61,6 @@
|
|
|
61
61
|
"@copilotkit/license-verifier": "~0.5.0",
|
|
62
62
|
"@segment/analytics-node": "^2.1.2",
|
|
63
63
|
"@standard-schema/spec": "^1.0.0",
|
|
64
|
-
"chalk": "4.1.2",
|
|
65
64
|
"clarinet": "^0.12.4",
|
|
66
65
|
"graphql": "^16.8.1",
|
|
67
66
|
"partial-json": "^0.1.7",
|
package/src/constants/index.ts
CHANGED
|
@@ -6,5 +6,12 @@ export const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER =
|
|
|
6
6
|
|
|
7
7
|
export const DEFAULT_AGENT_ID = "default";
|
|
8
8
|
|
|
9
|
+
/**
|
|
10
|
+
* `RUN_ERROR` code the runtime sends when a run is rejected because the
|
|
11
|
+
* thread already has one in flight. CopilotKit core reports it as
|
|
12
|
+
* `agent_thread_locked`.
|
|
13
|
+
*/
|
|
14
|
+
export const THREAD_ALREADY_RUNNING_ERROR_CODE = "THREAD_ALREADY_RUNNING";
|
|
15
|
+
|
|
9
16
|
/** Phoenix channel event name used for all AG-UI events. */
|
|
10
17
|
export const AG_UI_CHANNEL_EVENT = "ag-ui";
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
//
|
|
3
3
|
// Posts events to a CopilotKit-controlled telemetry-sink endpoint, which
|
|
4
4
|
// fans out to Scarf, Reo, and any future destinations. Replaces the direct
|
|
5
|
-
// per-vendor calls (
|
|
6
|
-
// SDK releases and so that downstream services we don't want
|
|
7
|
-
// OSS readers (e.g. the email-enrichment service backing Reo) stay
|
|
5
|
+
// per-vendor calls (formerly a Scarf-specific client) so that vendor changes
|
|
6
|
+
// don't require SDK releases and so that downstream services we don't want
|
|
7
|
+
// exposed to OSS readers (e.g. the email-enrichment service backing Reo) stay
|
|
8
8
|
// private.
|
|
9
9
|
//
|
|
10
10
|
// Two attribution modes:
|
package/src/telemetry/utils.ts
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import chalk from "chalk";
|
|
2
|
-
|
|
3
1
|
export function flattenObject(
|
|
4
2
|
obj: Record<string, any>,
|
|
5
3
|
parentKey = "",
|
|
@@ -15,29 +13,3 @@ export function flattenObject(
|
|
|
15
13
|
}
|
|
16
14
|
return res;
|
|
17
15
|
}
|
|
18
|
-
|
|
19
|
-
export function printSecurityNotice(advisory: {
|
|
20
|
-
advisory: string | null;
|
|
21
|
-
message: string;
|
|
22
|
-
severity: "low" | "medium" | "high" | "none";
|
|
23
|
-
}) {
|
|
24
|
-
const severityColor =
|
|
25
|
-
{
|
|
26
|
-
low: chalk.blue,
|
|
27
|
-
medium: chalk.yellow,
|
|
28
|
-
high: chalk.red,
|
|
29
|
-
}[advisory.severity.toLowerCase()] || chalk.white;
|
|
30
|
-
|
|
31
|
-
console.log();
|
|
32
|
-
console.log(
|
|
33
|
-
`━━━━━━━━━━━━━━━━━━ ${chalk.bold(`CopilotKit`)} ━━━━━━━━━━━━━━━━━━`,
|
|
34
|
-
);
|
|
35
|
-
console.log();
|
|
36
|
-
console.log(
|
|
37
|
-
`${chalk.bold(`Severity: ${severityColor(advisory.severity.toUpperCase())}`)}`,
|
|
38
|
-
);
|
|
39
|
-
console.log();
|
|
40
|
-
console.log(`${chalk.bold(advisory.message)}`);
|
|
41
|
-
console.log();
|
|
42
|
-
console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
|
|
43
|
-
}
|
|
@@ -35,6 +35,59 @@ const emptySnapshot = () => ({
|
|
|
35
35
|
},
|
|
36
36
|
});
|
|
37
37
|
|
|
38
|
+
/** One available Trajectory citation, with fields overridden per case. */
|
|
39
|
+
const trajectoryEntry = (overrides: Record<string, unknown>) => ({
|
|
40
|
+
status: "available",
|
|
41
|
+
trajectoryId: "trajectory-1",
|
|
42
|
+
eventCount: 1,
|
|
43
|
+
url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
|
|
44
|
+
...overrides,
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
/** Builds a configured snapshot whose Insight and Skill source cite Trajectories. */
|
|
48
|
+
const snapshotWithTrajectoryEvidence = (trajectoryEvidence: unknown[]) => {
|
|
49
|
+
const insight = {
|
|
50
|
+
id: "insight-1",
|
|
51
|
+
statement: "Users switch the theme first.",
|
|
52
|
+
impact: "Default to dark mode.",
|
|
53
|
+
totalThreadCount: 0,
|
|
54
|
+
evidenceTruncated: false,
|
|
55
|
+
evidence: [],
|
|
56
|
+
totalTrajectoryCount: trajectoryEvidence.length,
|
|
57
|
+
trajectoryEvidence,
|
|
58
|
+
};
|
|
59
|
+
return {
|
|
60
|
+
...emptySnapshot(),
|
|
61
|
+
configuration: {
|
|
62
|
+
state: "configured",
|
|
63
|
+
container: { id: "support", name: "Support" },
|
|
64
|
+
},
|
|
65
|
+
skillsPage: {
|
|
66
|
+
page: 1,
|
|
67
|
+
pageSize: 3,
|
|
68
|
+
total: 1,
|
|
69
|
+
totalPages: 1,
|
|
70
|
+
items: [
|
|
71
|
+
{
|
|
72
|
+
id: "skill-1",
|
|
73
|
+
name: "dark-mode",
|
|
74
|
+
description: "Offer dark mode.",
|
|
75
|
+
revision: 1,
|
|
76
|
+
skillMd: "# Dark mode",
|
|
77
|
+
sourceInsight: { ...insight, id: "source-1" },
|
|
78
|
+
},
|
|
79
|
+
],
|
|
80
|
+
},
|
|
81
|
+
insightsPage: {
|
|
82
|
+
page: 1,
|
|
83
|
+
pageSize: 4,
|
|
84
|
+
total: 1,
|
|
85
|
+
totalPages: 1,
|
|
86
|
+
items: [insight],
|
|
87
|
+
},
|
|
88
|
+
};
|
|
89
|
+
};
|
|
90
|
+
|
|
38
91
|
describe("Inspector Learning wire validation", () => {
|
|
39
92
|
it("accepts and copies a bounded V1 snapshot", () => {
|
|
40
93
|
const source = emptySnapshot();
|
|
@@ -197,6 +250,105 @@ describe("Inspector Learning wire validation", () => {
|
|
|
197
250
|
expect(parseInspectorLearningSnapshotV1(snapshot)).toBeUndefined();
|
|
198
251
|
});
|
|
199
252
|
|
|
253
|
+
it("copies Trajectory evidence next to the Thread evidence", () => {
|
|
254
|
+
const snapshot = snapshotWithTrajectoryEvidence([
|
|
255
|
+
{
|
|
256
|
+
status: "available",
|
|
257
|
+
trajectoryId: "0190a3b4-0000-7000-8000-000000000001",
|
|
258
|
+
eventCount: 2,
|
|
259
|
+
url: "https://app.copilotkit.ai/o/acme/support/trajectories/0190a3b4-0000-7000-8000-000000000001?event=901",
|
|
260
|
+
},
|
|
261
|
+
{ status: "unavailable" },
|
|
262
|
+
]);
|
|
263
|
+
|
|
264
|
+
const parsed = parseInspectorLearningSnapshotV1(snapshot);
|
|
265
|
+
|
|
266
|
+
expect(parsed?.insightsPage.items[0]).toEqual(
|
|
267
|
+
snapshot.insightsPage.items[0],
|
|
268
|
+
);
|
|
269
|
+
expect(
|
|
270
|
+
parseInspectorLearningSnapshotV1(
|
|
271
|
+
snapshotWithTrajectoryEvidence([
|
|
272
|
+
{
|
|
273
|
+
status: "available",
|
|
274
|
+
trajectoryId: "trajectory-1",
|
|
275
|
+
eventCount: 1,
|
|
276
|
+
url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
|
|
277
|
+
addedLater: "ignored",
|
|
278
|
+
},
|
|
279
|
+
]),
|
|
280
|
+
)?.insightsPage.items[0]?.trajectoryEvidence,
|
|
281
|
+
).toEqual([
|
|
282
|
+
{
|
|
283
|
+
status: "available",
|
|
284
|
+
trajectoryId: "trajectory-1",
|
|
285
|
+
eventCount: 1,
|
|
286
|
+
url: "https://app.copilotkit.ai/o/acme/support/trajectories/trajectory-1",
|
|
287
|
+
},
|
|
288
|
+
]);
|
|
289
|
+
expect(parsed?.skillsPage.items[0]?.sourceInsight).toEqual(
|
|
290
|
+
snapshot.skillsPage.items[0]?.sourceInsight,
|
|
291
|
+
);
|
|
292
|
+
});
|
|
293
|
+
|
|
294
|
+
it("accepts Insights from producers that omit Trajectory evidence", () => {
|
|
295
|
+
const snapshot = snapshotWithTrajectoryEvidence([]);
|
|
296
|
+
const [insight] = snapshot.insightsPage.items;
|
|
297
|
+
delete (insight as { totalTrajectoryCount?: number }).totalTrajectoryCount;
|
|
298
|
+
delete (insight as { trajectoryEvidence?: unknown }).trajectoryEvidence;
|
|
299
|
+
|
|
300
|
+
const parsed = parseInspectorLearningSnapshotV1(snapshot);
|
|
301
|
+
|
|
302
|
+
expect(parsed?.insightsPage.items[0]).toEqual(insight);
|
|
303
|
+
expect(parsed?.insightsPage.items[0]).not.toHaveProperty(
|
|
304
|
+
"trajectoryEvidence",
|
|
305
|
+
);
|
|
306
|
+
});
|
|
307
|
+
|
|
308
|
+
it("keeps either Trajectory field when the producer sends only one", () => {
|
|
309
|
+
const evidence = [trajectoryEntry({}), { status: "unavailable" }];
|
|
310
|
+
const countOnly = snapshotWithTrajectoryEvidence(evidence);
|
|
311
|
+
delete (countOnly.insightsPage.items[0] as { trajectoryEvidence?: unknown })
|
|
312
|
+
.trajectoryEvidence;
|
|
313
|
+
const evidenceOnly = snapshotWithTrajectoryEvidence(evidence);
|
|
314
|
+
delete (
|
|
315
|
+
evidenceOnly.insightsPage.items[0] as { totalTrajectoryCount?: number }
|
|
316
|
+
).totalTrajectoryCount;
|
|
317
|
+
|
|
318
|
+
const parsedCountOnly = parseInspectorLearningSnapshotV1(countOnly);
|
|
319
|
+
const parsedEvidenceOnly = parseInspectorLearningSnapshotV1(evidenceOnly);
|
|
320
|
+
|
|
321
|
+
expect(parsedCountOnly?.insightsPage.items[0]).toEqual(
|
|
322
|
+
countOnly.insightsPage.items[0],
|
|
323
|
+
);
|
|
324
|
+
expect(parsedEvidenceOnly?.insightsPage.items[0]).toEqual(
|
|
325
|
+
evidenceOnly.insightsPage.items[0],
|
|
326
|
+
);
|
|
327
|
+
});
|
|
328
|
+
|
|
329
|
+
it("rejects Trajectory evidence with foreign links or unknown fields", () => {
|
|
330
|
+
for (const invalid of [
|
|
331
|
+
trajectoryEntry({
|
|
332
|
+
url: "https://attacker.example/o/acme/support/trajectories/t",
|
|
333
|
+
}),
|
|
334
|
+
trajectoryEntry({ url: "javascript:alert(1)" }),
|
|
335
|
+
trajectoryEntry({ eventCount: -1 }),
|
|
336
|
+
trajectoryEntry({ trajectoryId: "" }),
|
|
337
|
+
{ status: "unavailable", trajectoryId: "former-id" },
|
|
338
|
+
{ status: "pending" },
|
|
339
|
+
]) {
|
|
340
|
+
expect(
|
|
341
|
+
parseInspectorLearningSnapshotV1(
|
|
342
|
+
snapshotWithTrajectoryEvidence([invalid]),
|
|
343
|
+
),
|
|
344
|
+
).toBeUndefined();
|
|
345
|
+
}
|
|
346
|
+
const tooMany = snapshotWithTrajectoryEvidence(
|
|
347
|
+
Array.from({ length: 101 }, () => ({ status: "unavailable" })),
|
|
348
|
+
);
|
|
349
|
+
expect(parseInspectorLearningSnapshotV1(tooMany)).toBeUndefined();
|
|
350
|
+
});
|
|
351
|
+
|
|
200
352
|
it("accepts only the browser-owned scope and pagination fields", () => {
|
|
201
353
|
expect(
|
|
202
354
|
parseInspectorLearningRequestV1({
|
|
@@ -17,6 +17,16 @@ export type InspectorLearningEvidence =
|
|
|
17
17
|
}
|
|
18
18
|
| { readonly status: "unavailable" };
|
|
19
19
|
|
|
20
|
+
/** A cited Trajectory, linked into the Intelligence web app. */
|
|
21
|
+
export type InspectorLearningTrajectoryEvidence =
|
|
22
|
+
| {
|
|
23
|
+
readonly status: "available";
|
|
24
|
+
readonly trajectoryId: string;
|
|
25
|
+
readonly eventCount: number;
|
|
26
|
+
readonly url: string;
|
|
27
|
+
}
|
|
28
|
+
| { readonly status: "unavailable" };
|
|
29
|
+
|
|
20
30
|
export interface InspectorLearningInsight {
|
|
21
31
|
readonly id: string;
|
|
22
32
|
readonly statement: string;
|
|
@@ -24,6 +34,10 @@ export interface InspectorLearningInsight {
|
|
|
24
34
|
readonly totalThreadCount: number;
|
|
25
35
|
readonly evidenceTruncated: boolean;
|
|
26
36
|
readonly evidence: readonly InspectorLearningEvidence[];
|
|
37
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
38
|
+
readonly totalTrajectoryCount?: number;
|
|
39
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
40
|
+
readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];
|
|
27
41
|
}
|
|
28
42
|
|
|
29
43
|
export interface InspectorLearningSkill {
|
|
@@ -177,7 +191,37 @@ function parseEvidence(value: unknown): InspectorLearningEvidence | undefined {
|
|
|
177
191
|
};
|
|
178
192
|
}
|
|
179
193
|
|
|
180
|
-
function
|
|
194
|
+
function parseTrajectoryEvidence(
|
|
195
|
+
value: unknown,
|
|
196
|
+
webAppOrigin: string,
|
|
197
|
+
): InspectorLearningTrajectoryEvidence | undefined {
|
|
198
|
+
if (record(value) && value.status === "unavailable") {
|
|
199
|
+
return Object.keys(value).length === 1
|
|
200
|
+
? { status: "unavailable" }
|
|
201
|
+
: undefined;
|
|
202
|
+
}
|
|
203
|
+
if (
|
|
204
|
+
!record(value) ||
|
|
205
|
+
value.status !== "available" ||
|
|
206
|
+
!string(value.trajectoryId, 128) ||
|
|
207
|
+
!integer(value.eventCount)
|
|
208
|
+
) {
|
|
209
|
+
return undefined;
|
|
210
|
+
}
|
|
211
|
+
const url = parseInspectorLearningUrl(value.url, webAppOrigin);
|
|
212
|
+
if (!url) return undefined;
|
|
213
|
+
return {
|
|
214
|
+
status: "available",
|
|
215
|
+
trajectoryId: value.trajectoryId,
|
|
216
|
+
eventCount: value.eventCount,
|
|
217
|
+
url,
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
function parseInsight(
|
|
222
|
+
value: unknown,
|
|
223
|
+
webAppOrigin: string,
|
|
224
|
+
): InspectorLearningInsight | undefined {
|
|
181
225
|
if (
|
|
182
226
|
!record(value) ||
|
|
183
227
|
!string(value.id, 128) ||
|
|
@@ -192,7 +236,7 @@ function parseInsight(value: unknown): InspectorLearningInsight | undefined {
|
|
|
192
236
|
}
|
|
193
237
|
const evidence = value.evidence.map(parseEvidence);
|
|
194
238
|
if (evidence.some((item) => item === undefined)) return undefined;
|
|
195
|
-
|
|
239
|
+
const insight: InspectorLearningInsight = {
|
|
196
240
|
id: value.id,
|
|
197
241
|
statement: value.statement,
|
|
198
242
|
impact: value.impact,
|
|
@@ -200,9 +244,38 @@ function parseInsight(value: unknown): InspectorLearningInsight | undefined {
|
|
|
200
244
|
evidenceTruncated: value.evidenceTruncated,
|
|
201
245
|
evidence: evidence as InspectorLearningEvidence[],
|
|
202
246
|
};
|
|
247
|
+
// Each Trajectory field is optional on its own; a malformed one rejects
|
|
248
|
+
// the Insight, an absent one leaves the Thread-only shape untouched.
|
|
249
|
+
let totalTrajectoryCount: number | undefined;
|
|
250
|
+
if (value.totalTrajectoryCount !== undefined) {
|
|
251
|
+
if (!integer(value.totalTrajectoryCount)) return undefined;
|
|
252
|
+
totalTrajectoryCount = value.totalTrajectoryCount;
|
|
253
|
+
}
|
|
254
|
+
let trajectoryEvidence: InspectorLearningTrajectoryEvidence[] | undefined;
|
|
255
|
+
if (value.trajectoryEvidence !== undefined) {
|
|
256
|
+
if (
|
|
257
|
+
!Array.isArray(value.trajectoryEvidence) ||
|
|
258
|
+
value.trajectoryEvidence.length > 100
|
|
259
|
+
) {
|
|
260
|
+
return undefined;
|
|
261
|
+
}
|
|
262
|
+
const parsed = value.trajectoryEvidence.map((item) =>
|
|
263
|
+
parseTrajectoryEvidence(item, webAppOrigin),
|
|
264
|
+
);
|
|
265
|
+
if (parsed.some((item) => item === undefined)) return undefined;
|
|
266
|
+
trajectoryEvidence = parsed as InspectorLearningTrajectoryEvidence[];
|
|
267
|
+
}
|
|
268
|
+
return {
|
|
269
|
+
...insight,
|
|
270
|
+
...(totalTrajectoryCount === undefined ? {} : { totalTrajectoryCount }),
|
|
271
|
+
...(trajectoryEvidence === undefined ? {} : { trajectoryEvidence }),
|
|
272
|
+
};
|
|
203
273
|
}
|
|
204
274
|
|
|
205
|
-
function parseSkill(
|
|
275
|
+
function parseSkill(
|
|
276
|
+
value: unknown,
|
|
277
|
+
webAppOrigin: string,
|
|
278
|
+
): InspectorLearningSkill | undefined {
|
|
206
279
|
if (
|
|
207
280
|
!record(value) ||
|
|
208
281
|
!string(value.id, 128) ||
|
|
@@ -215,7 +288,9 @@ function parseSkill(value: unknown): InspectorLearningSkill | undefined {
|
|
|
215
288
|
return undefined;
|
|
216
289
|
}
|
|
217
290
|
const sourceInsight =
|
|
218
|
-
value.sourceInsight === null
|
|
291
|
+
value.sourceInsight === null
|
|
292
|
+
? null
|
|
293
|
+
: parseInsight(value.sourceInsight, webAppOrigin);
|
|
219
294
|
if (sourceInsight === undefined) return undefined;
|
|
220
295
|
return {
|
|
221
296
|
id: value.id,
|
|
@@ -329,9 +404,19 @@ export function parseInspectorLearningSnapshotV1(
|
|
|
329
404
|
) {
|
|
330
405
|
return undefined;
|
|
331
406
|
}
|
|
407
|
+
const originUrl = parseInspectorLearningUrl(
|
|
408
|
+
value.webAppOrigin,
|
|
409
|
+
value.webAppOrigin,
|
|
410
|
+
);
|
|
411
|
+
if (!originUrl || new URL(originUrl).pathname !== "/") return undefined;
|
|
412
|
+
const webAppOrigin = new URL(originUrl).origin;
|
|
332
413
|
const configuration = parseConfiguration(value.configuration);
|
|
333
|
-
const skillsPage = parsePage(value.skillsPage, 3,
|
|
334
|
-
|
|
414
|
+
const skillsPage = parsePage(value.skillsPage, 3, (item) =>
|
|
415
|
+
parseSkill(item, webAppOrigin),
|
|
416
|
+
);
|
|
417
|
+
const insightsPage = parsePage(value.insightsPage, 4, (item) =>
|
|
418
|
+
parseInsight(item, webAppOrigin),
|
|
419
|
+
);
|
|
335
420
|
if (!configuration || !skillsPage || !insightsPage) return undefined;
|
|
336
421
|
let latest: InspectorLearningSnapshotV1["run"]["latest"] = null;
|
|
337
422
|
if (value.run.latest !== null) {
|
|
@@ -352,12 +437,6 @@ export function parseInspectorLearningSnapshotV1(
|
|
|
352
437
|
};
|
|
353
438
|
}
|
|
354
439
|
if (!record(value.links)) return undefined;
|
|
355
|
-
const originUrl = parseInspectorLearningUrl(
|
|
356
|
-
value.webAppOrigin,
|
|
357
|
-
value.webAppOrigin,
|
|
358
|
-
);
|
|
359
|
-
if (!originUrl || new URL(originUrl).pathname !== "/") return undefined;
|
|
360
|
-
const webAppOrigin = new URL(originUrl).origin;
|
|
361
440
|
const learning = parseInspectorLearningUrl(
|
|
362
441
|
value.links.learning,
|
|
363
442
|
webAppOrigin,
|
package/tsdown.config.ts
CHANGED
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
import * as packageJson from "../../package.json";
|
|
2
|
-
|
|
3
|
-
const SCARF_BASE_URL = `https://copilotkit.gateway.scarf.sh/${packageJson.version}`;
|
|
4
|
-
|
|
5
|
-
class ScarfClient {
|
|
6
|
-
constructor() {}
|
|
7
|
-
|
|
8
|
-
async logEvent(properties: Record<string, any>): Promise<void> {
|
|
9
|
-
try {
|
|
10
|
-
const controller = new AbortController();
|
|
11
|
-
const timeoutId = setTimeout(() => controller.abort(), 3000);
|
|
12
|
-
|
|
13
|
-
const queryParams = new URLSearchParams();
|
|
14
|
-
|
|
15
|
-
Object.entries(properties).forEach(([key, value]) => {
|
|
16
|
-
if (value !== null && value !== undefined) {
|
|
17
|
-
queryParams.append(key, String(value));
|
|
18
|
-
}
|
|
19
|
-
});
|
|
20
|
-
|
|
21
|
-
const url = `${SCARF_BASE_URL}?${queryParams.toString()}`;
|
|
22
|
-
|
|
23
|
-
const response = await fetch(url, {
|
|
24
|
-
method: "GET",
|
|
25
|
-
signal: controller.signal,
|
|
26
|
-
});
|
|
27
|
-
|
|
28
|
-
clearTimeout(timeoutId);
|
|
29
|
-
|
|
30
|
-
if (!response.ok) {
|
|
31
|
-
throw new Error(`HTTP error! status: ${response.status}`);
|
|
32
|
-
}
|
|
33
|
-
} catch {
|
|
34
|
-
// Silently fail - telemetry should not break the application
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
export default new ScarfClient();
|
|
File without changes
|