@copilotkit/shared 1.79.2-canary.1792172552 → 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/event-transforms/open-generative-ui-middleware.cjs +7 -6
- package/dist/event-transforms/open-generative-ui-middleware.cjs.map +1 -1
- package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +1 -1
- package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +1 -1
- package/dist/event-transforms/open-generative-ui-middleware.mjs +7 -6
- package/dist/event-transforms/open-generative-ui-middleware.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 +3 -4
- package/src/constants/index.ts +7 -0
- package/src/event-transforms/open-generative-ui-middleware.ts +19 -10
- 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",
|
|
@@ -57,11 +57,10 @@
|
|
|
57
57
|
},
|
|
58
58
|
"dependencies": {
|
|
59
59
|
"@ag-ui/a2ui-middleware": "0.0.10",
|
|
60
|
-
"@ag-ui/client": "1.0.
|
|
60
|
+
"@ag-ui/client": "1.0.2",
|
|
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",
|
|
@@ -71,7 +70,7 @@
|
|
|
71
70
|
"zod-to-json-schema": "^3.23.5"
|
|
72
71
|
},
|
|
73
72
|
"devDependencies": {
|
|
74
|
-
"@ag-ui/core": "1.0.
|
|
73
|
+
"@ag-ui/core": "1.0.2",
|
|
75
74
|
"@types/clarinet": "^0.12.3",
|
|
76
75
|
"@types/uuid": "^10.0.0",
|
|
77
76
|
"@valibot/to-json-schema": "^1.5.0",
|
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";
|
|
@@ -251,16 +251,23 @@ export class ArgsParser {
|
|
|
251
251
|
}
|
|
252
252
|
}
|
|
253
253
|
|
|
254
|
+
/**
|
|
255
|
+
* Extract EventWithState type from Middleware.runNextWithState return type
|
|
256
|
+
*/
|
|
257
|
+
type ExtractObservableType<T> = T extends Observable<infer U> ? U : never;
|
|
258
|
+
type RunNextWithStateReturn = ReturnType<Middleware["runNextWithState"]>;
|
|
259
|
+
type EventWithState = ExtractObservableType<RunNextWithStateReturn>;
|
|
260
|
+
|
|
254
261
|
export class OpenGenerativeUIMiddleware extends Middleware {
|
|
255
262
|
run(input: RunAgentInput, next: AbstractAgent): Observable<BaseEvent> {
|
|
256
|
-
|
|
257
|
-
// messages and state on every event for a consumer that never looks.
|
|
258
|
-
return this.processStream(this.runNext(input, next));
|
|
263
|
+
return this.processStream(this.runNextWithState(input, next));
|
|
259
264
|
}
|
|
260
265
|
|
|
261
|
-
private processStream(
|
|
266
|
+
private processStream(
|
|
267
|
+
source: Observable<EventWithState>,
|
|
268
|
+
): Observable<BaseEvent> {
|
|
262
269
|
return new Observable<BaseEvent>((subscriber) => {
|
|
263
|
-
let heldRunFinished:
|
|
270
|
+
let heldRunFinished: EventWithState | null = null;
|
|
264
271
|
// Track active generateSandboxedUi tool call IDs → their streaming parser
|
|
265
272
|
const activeParsers = new Map<string, ArgsParser>();
|
|
266
273
|
// Hold genui tool call events until the first activity event is emitted
|
|
@@ -280,14 +287,16 @@ export class OpenGenerativeUIMiddleware extends Middleware {
|
|
|
280
287
|
};
|
|
281
288
|
|
|
282
289
|
const subscription = source.subscribe({
|
|
283
|
-
next: (
|
|
290
|
+
next: (eventWithState) => {
|
|
291
|
+
const event = eventWithState.event;
|
|
292
|
+
|
|
284
293
|
if (heldRunFinished) {
|
|
285
|
-
subscriber.next(heldRunFinished);
|
|
294
|
+
subscriber.next(heldRunFinished.event);
|
|
286
295
|
heldRunFinished = null;
|
|
287
296
|
}
|
|
288
297
|
|
|
289
298
|
if (event.type === EventType.RUN_FINISHED) {
|
|
290
|
-
heldRunFinished =
|
|
299
|
+
heldRunFinished = eventWithState;
|
|
291
300
|
return;
|
|
292
301
|
}
|
|
293
302
|
|
|
@@ -357,7 +366,7 @@ export class OpenGenerativeUIMiddleware extends Middleware {
|
|
|
357
366
|
heldToolCallEvents.clear();
|
|
358
367
|
|
|
359
368
|
if (heldRunFinished) {
|
|
360
|
-
subscriber.next(heldRunFinished);
|
|
369
|
+
subscriber.next(heldRunFinished.event);
|
|
361
370
|
heldRunFinished = null;
|
|
362
371
|
}
|
|
363
372
|
subscriber.error(err);
|
|
@@ -369,7 +378,7 @@ export class OpenGenerativeUIMiddleware extends Middleware {
|
|
|
369
378
|
});
|
|
370
379
|
|
|
371
380
|
if (heldRunFinished) {
|
|
372
|
-
subscriber.next(heldRunFinished);
|
|
381
|
+
subscriber.next(heldRunFinished.event);
|
|
373
382
|
heldRunFinished = null;
|
|
374
383
|
}
|
|
375
384
|
activeParsers.clear();
|
|
@@ -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
|