@copilotkit/runtime 2.0.0-rc.3 → 2.0.0-rc.31

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.
Files changed (192) hide show
  1. package/README.md +19 -1
  2. package/dist/agent/converters/aisdk.cjs +0 -1
  3. package/dist/agent/converters/aisdk.cjs.map +1 -1
  4. package/dist/agent/converters/tanstack.cjs +1 -2
  5. package/dist/agent/converters/tanstack.cjs.map +1 -1
  6. package/dist/agent/converters/tanstack.mjs +1 -1
  7. package/dist/agent/converters/tanstack.mjs.map +1 -1
  8. package/dist/agent/index.cjs +9 -19
  9. package/dist/agent/index.cjs.map +1 -1
  10. package/dist/agent/index.d.cts +1 -9
  11. package/dist/agent/index.d.cts.map +1 -1
  12. package/dist/agent/index.d.mts +1 -9
  13. package/dist/agent/index.d.mts.map +1 -1
  14. package/dist/agent/index.mjs +10 -18
  15. package/dist/agent/index.mjs.map +1 -1
  16. package/dist/agent/learned-skills.cjs +0 -1
  17. package/dist/agent/learned-skills.cjs.map +1 -1
  18. package/dist/agent/state-delta.cjs +0 -1
  19. package/dist/agent/state-delta.cjs.map +1 -1
  20. package/dist/agent/url-download.cjs +0 -1
  21. package/dist/agent/url-download.cjs.map +1 -1
  22. package/dist/index.cjs +20 -10
  23. package/dist/index.d.cts +6 -3
  24. package/dist/index.d.mts +6 -3
  25. package/dist/index.mjs +5 -2
  26. package/dist/node.cjs +1 -2
  27. package/dist/node.d.cts +2 -2
  28. package/dist/node.d.mts +2 -2
  29. package/dist/node.mjs +2 -2
  30. package/dist/runtime/core/channel-manager.cjs +0 -1
  31. package/dist/runtime/core/channel-manager.cjs.map +1 -1
  32. package/dist/runtime/core/debug-event-bus.cjs +0 -1
  33. package/dist/runtime/core/debug-event-bus.cjs.map +1 -1
  34. package/dist/runtime/core/fetch-handler.cjs +3 -4
  35. package/dist/runtime/core/fetch-handler.cjs.map +1 -1
  36. package/dist/runtime/core/fetch-handler.mjs.map +1 -1
  37. package/dist/runtime/core/logger.cjs +85 -13
  38. package/dist/runtime/core/logger.cjs.map +1 -1
  39. package/dist/runtime/core/logger.d.cts +21 -8
  40. package/dist/runtime/core/logger.d.cts.map +1 -1
  41. package/dist/runtime/core/logger.d.mts +21 -8
  42. package/dist/runtime/core/logger.d.mts.map +1 -1
  43. package/dist/runtime/core/logger.mjs +85 -10
  44. package/dist/runtime/core/logger.mjs.map +1 -1
  45. package/dist/runtime/core/middleware-sse-parser.cjs +0 -1
  46. package/dist/runtime/core/middleware-sse-parser.cjs.map +1 -1
  47. package/dist/runtime/core/middleware.cjs +0 -1
  48. package/dist/runtime/core/middleware.cjs.map +1 -1
  49. package/dist/runtime/core/package-info.cjs +1 -1
  50. package/dist/runtime/core/package-info.mjs +1 -1
  51. package/dist/runtime/core/runtime.cjs +0 -1
  52. package/dist/runtime/core/runtime.cjs.map +1 -1
  53. package/dist/runtime/core/runtime.d.mts +1 -1
  54. package/dist/runtime/endpoints/auto-start-channels.cjs +0 -1
  55. package/dist/runtime/endpoints/auto-start-channels.cjs.map +1 -1
  56. package/dist/runtime/endpoints/node-fetch-handler.cjs +0 -4
  57. package/dist/runtime/endpoints/node-fetch-handler.cjs.map +1 -1
  58. package/dist/runtime/endpoints/node-fetch-handler.d.cts +1 -3
  59. package/dist/runtime/endpoints/node-fetch-handler.d.cts.map +1 -1
  60. package/dist/runtime/endpoints/node-fetch-handler.d.mts +1 -3
  61. package/dist/runtime/endpoints/node-fetch-handler.d.mts.map +1 -1
  62. package/dist/runtime/endpoints/node-fetch-handler.mjs +1 -3
  63. package/dist/runtime/endpoints/node-fetch-handler.mjs.map +1 -1
  64. package/dist/runtime/event-transforms/index.d.cts +4 -0
  65. package/dist/runtime/event-transforms/index.d.mts +4 -0
  66. package/dist/runtime/event-transforms/index.mjs +5 -0
  67. package/dist/runtime/event-transforms/open-generative-ui-middleware.cjs +277 -0
  68. package/dist/runtime/event-transforms/open-generative-ui-middleware.cjs.map +1 -0
  69. package/dist/runtime/event-transforms/open-generative-ui-middleware.d.cts +61 -0
  70. package/dist/runtime/event-transforms/open-generative-ui-middleware.d.cts.map +1 -0
  71. package/dist/runtime/event-transforms/open-generative-ui-middleware.d.mts +61 -0
  72. package/dist/runtime/event-transforms/open-generative-ui-middleware.d.mts.map +1 -0
  73. package/dist/runtime/event-transforms/open-generative-ui-middleware.mjs +276 -0
  74. package/dist/runtime/event-transforms/open-generative-ui-middleware.mjs.map +1 -0
  75. package/dist/runtime/event-transforms/recorded-events.cjs +58 -0
  76. package/dist/runtime/event-transforms/recorded-events.cjs.map +1 -0
  77. package/dist/runtime/event-transforms/recorded-events.d.cts +23 -0
  78. package/dist/runtime/event-transforms/recorded-events.d.cts.map +1 -0
  79. package/dist/runtime/event-transforms/recorded-events.d.mts +23 -0
  80. package/dist/runtime/event-transforms/recorded-events.d.mts.map +1 -0
  81. package/dist/runtime/event-transforms/recorded-events.mjs +58 -0
  82. package/dist/runtime/event-transforms/recorded-events.mjs.map +1 -0
  83. package/dist/runtime/event-transforms/streaming-json-scanner.cjs +289 -0
  84. package/dist/runtime/event-transforms/streaming-json-scanner.cjs.map +1 -0
  85. package/dist/runtime/event-transforms/streaming-json-scanner.mjs +288 -0
  86. package/dist/runtime/event-transforms/streaming-json-scanner.mjs.map +1 -0
  87. package/dist/runtime/generative-ui/generative-ui-middleware.cjs +0 -1
  88. package/dist/runtime/generative-ui/generative-ui-middleware.cjs.map +1 -1
  89. package/dist/runtime/generative-ui/surface-writer.cjs +4 -5
  90. package/dist/runtime/generative-ui/surface-writer.cjs.map +1 -1
  91. package/dist/runtime/generative-ui/surface-writer.d.cts.map +1 -1
  92. package/dist/runtime/generative-ui/surface-writer.d.mts.map +1 -1
  93. package/dist/runtime/generative-ui/surface-writer.mjs +5 -5
  94. package/dist/runtime/generative-ui/surface-writer.mjs.map +1 -1
  95. package/dist/runtime/handlers/handle-connect.cjs.map +1 -1
  96. package/dist/runtime/handlers/handle-connect.mjs.map +1 -1
  97. package/dist/runtime/handlers/handle-inspector-learning.cjs +2 -3
  98. package/dist/runtime/handlers/handle-inspector-learning.cjs.map +1 -1
  99. package/dist/runtime/handlers/handle-inspector-metadata.cjs +2 -3
  100. package/dist/runtime/handlers/handle-inspector-metadata.cjs.map +1 -1
  101. package/dist/runtime/handlers/handle-run.cjs +3 -4
  102. package/dist/runtime/handlers/handle-run.cjs.map +1 -1
  103. package/dist/runtime/handlers/handle-run.mjs.map +1 -1
  104. package/dist/runtime/handlers/handle-stop.cjs +3 -4
  105. package/dist/runtime/handlers/handle-stop.cjs.map +1 -1
  106. package/dist/runtime/handlers/handle-suggest.cjs +0 -1
  107. package/dist/runtime/handlers/handle-suggest.cjs.map +1 -1
  108. package/dist/runtime/handlers/handle-transcribe.cjs +0 -1
  109. package/dist/runtime/handlers/handle-transcribe.cjs.map +1 -1
  110. package/dist/runtime/handlers/intelligence/annotate.cjs +2 -3
  111. package/dist/runtime/handlers/intelligence/annotate.cjs.map +1 -1
  112. package/dist/runtime/handlers/intelligence/memories.cjs +7 -8
  113. package/dist/runtime/handlers/intelligence/memories.cjs.map +1 -1
  114. package/dist/runtime/handlers/intelligence/run.cjs +0 -1
  115. package/dist/runtime/handlers/intelligence/run.cjs.map +1 -1
  116. package/dist/runtime/handlers/intelligence/run.mjs.map +1 -1
  117. package/dist/runtime/handlers/intelligence/thread-names.cjs +0 -1
  118. package/dist/runtime/handlers/intelligence/thread-names.cjs.map +1 -1
  119. package/dist/runtime/handlers/intelligence/threads.cjs +6 -7
  120. package/dist/runtime/handlers/intelligence/threads.cjs.map +1 -1
  121. package/dist/runtime/handlers/intelligence/threads.mjs.map +1 -1
  122. package/dist/runtime/handlers/shared/agent-utils.cjs +9 -9
  123. package/dist/runtime/handlers/shared/agent-utils.cjs.map +1 -1
  124. package/dist/runtime/handlers/shared/agent-utils.mjs +2 -1
  125. package/dist/runtime/handlers/shared/agent-utils.mjs.map +1 -1
  126. package/dist/runtime/handlers/shared/cloud-telemetry.cjs +0 -1
  127. package/dist/runtime/handlers/shared/cloud-telemetry.cjs.map +1 -1
  128. package/dist/runtime/handlers/shared/resolve-intelligence-user.cjs +1 -1
  129. package/dist/runtime/handlers/shared/resolve-intelligence-user.cjs.map +1 -1
  130. package/dist/runtime/handlers/shared/resolve-intelligence-user.mjs +1 -1
  131. package/dist/runtime/handlers/shared/resolve-intelligence-user.mjs.map +1 -1
  132. package/dist/runtime/handlers/shared/sse-response.cjs +72 -64
  133. package/dist/runtime/handlers/shared/sse-response.cjs.map +1 -1
  134. package/dist/runtime/handlers/shared/sse-response.mjs +72 -63
  135. package/dist/runtime/handlers/shared/sse-response.mjs.map +1 -1
  136. package/dist/runtime/handlers/sse/run.cjs.map +1 -1
  137. package/dist/runtime/handlers/sse/run.mjs.map +1 -1
  138. package/dist/runtime/index.d.cts +4 -9
  139. package/dist/runtime/index.d.mts +4 -9
  140. package/dist/runtime/intelligence-platform/client.cjs +0 -1
  141. package/dist/runtime/intelligence-platform/client.cjs.map +1 -1
  142. package/dist/runtime/intelligence-platform/learning-management.cjs +7 -8
  143. package/dist/runtime/intelligence-platform/learning-management.cjs.map +1 -1
  144. package/dist/runtime/intelligence-platform/learning-management.mjs +7 -7
  145. package/dist/runtime/intelligence-platform/learning-management.mjs.map +1 -1
  146. package/dist/runtime/intelligence-platform/skill-registry/archive.cjs +104 -110
  147. package/dist/runtime/intelligence-platform/skill-registry/archive.cjs.map +1 -1
  148. package/dist/runtime/intelligence-platform/skill-registry/archive.d.cts +8 -2
  149. package/dist/runtime/intelligence-platform/skill-registry/archive.d.cts.map +1 -1
  150. package/dist/runtime/intelligence-platform/skill-registry/archive.d.mts +8 -2
  151. package/dist/runtime/intelligence-platform/skill-registry/archive.d.mts.map +1 -1
  152. package/dist/runtime/intelligence-platform/skill-registry/archive.mjs +104 -109
  153. package/dist/runtime/intelligence-platform/skill-registry/archive.mjs.map +1 -1
  154. package/dist/runtime/intelligence-platform/skill-registry/config.cjs +0 -1
  155. package/dist/runtime/intelligence-platform/skill-registry/config.cjs.map +1 -1
  156. package/dist/runtime/intelligence-platform/skill-registry/registry.cjs +22 -19
  157. package/dist/runtime/intelligence-platform/skill-registry/registry.cjs.map +1 -1
  158. package/dist/runtime/intelligence-platform/skill-registry/registry.d.cts.map +1 -1
  159. package/dist/runtime/intelligence-platform/skill-registry/registry.d.mts.map +1 -1
  160. package/dist/runtime/intelligence-platform/skill-registry/registry.mjs +22 -19
  161. package/dist/runtime/intelligence-platform/skill-registry/registry.mjs.map +1 -1
  162. package/dist/runtime/intelligence-platform/thread-lock-heartbeat.cjs +0 -1
  163. package/dist/runtime/intelligence-platform/thread-lock-heartbeat.cjs.map +1 -1
  164. package/dist/runtime/intelligence-platform/trajectories.cjs +2 -3
  165. package/dist/runtime/intelligence-platform/trajectories.cjs.map +1 -1
  166. package/dist/runtime/intelligence-platform/trajectories.mjs +2 -2
  167. package/dist/runtime/intelligence-platform/trajectories.mjs.map +1 -1
  168. package/dist/runtime/node.d.cts +1 -1
  169. package/dist/runtime/node.d.mts +1 -1
  170. package/dist/runtime/runner/agent-runner.cjs +0 -1
  171. package/dist/runtime/runner/agent-runner.cjs.map +1 -1
  172. package/dist/runtime/runner/in-memory.cjs +0 -1
  173. package/dist/runtime/runner/in-memory.cjs.map +1 -1
  174. package/dist/runtime/runner/intelligence.cjs +0 -1
  175. package/dist/runtime/runner/intelligence.cjs.map +1 -1
  176. package/dist/runtime/telemetry/disclosure.cjs +0 -1
  177. package/dist/runtime/telemetry/disclosure.cjs.map +1 -1
  178. package/dist/runtime/telemetry/disclosure.mjs.map +1 -1
  179. package/dist/runtime/telemetry/instance-created.cjs +7 -9
  180. package/dist/runtime/telemetry/instance-created.cjs.map +1 -1
  181. package/dist/runtime/telemetry/instance-created.mjs +7 -9
  182. package/dist/runtime/telemetry/instance-created.mjs.map +1 -1
  183. package/dist/runtime/telemetry/telemetry-client.cjs +0 -5
  184. package/dist/runtime/telemetry/telemetry-client.cjs.map +1 -1
  185. package/dist/runtime/telemetry/telemetry-client.mjs +0 -4
  186. package/dist/runtime/telemetry/telemetry-client.mjs.map +1 -1
  187. package/dist/runtime/telemetry/telemetry-identity.cjs +0 -1
  188. package/dist/runtime/telemetry/telemetry-identity.cjs.map +1 -1
  189. package/package.json +11 -19
  190. package/dist/_virtual/_rolldown/runtime.cjs +0 -29
  191. package/dist/runtime/index.d.cts.map +0 -1
  192. package/dist/runtime/index.d.mts.map +0 -1
@@ -1,4 +1,3 @@
1
- const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
2
1
  let zod = require("zod");
3
2
 
4
3
  //#region src/runtime/intelligence-platform/learning-management.ts
@@ -9,8 +8,8 @@ const learningContainerSchema = zod.z.object({
9
8
  name: zod.z.string().min(1),
10
9
  projectId: zod.z.number().int().positive(),
11
10
  promptContext: zod.z.string().nullable(),
12
- createdAt: zod.z.string().datetime({ offset: true }),
13
- updatedAt: zod.z.string().datetime({ offset: true })
11
+ createdAt: zod.z.iso.datetime({ offset: true }),
12
+ updatedAt: zod.z.iso.datetime({ offset: true })
14
13
  });
15
14
  const learningContainerPageSchema = zod.z.object({
16
15
  containers: zod.z.array(learningContainerSchema).max(500),
@@ -52,8 +51,8 @@ async function readLearningJson(response, limit = 16 * 1024 * 1024, signal) {
52
51
  }
53
52
  }
54
53
  const learningSha256Schema = zod.z.string().regex(/^[a-f0-9]{64}$/u);
55
- const learningUuidSchema = zod.z.string().uuid();
56
- const learningDateTimeSchema = zod.z.string().datetime({ offset: true });
54
+ const learningUuidSchema = zod.z.guid();
55
+ const learningDateTimeSchema = zod.z.iso.datetime({ offset: true });
57
56
  /** One immutable file in a proposed Skill candidate bundle. */
58
57
  const learningSkillBundleFileSchema = zod.z.object({
59
58
  content: zod.z.string(),
@@ -130,7 +129,7 @@ const learningCandidateReviewSchema = zod.z.object({
130
129
  status: zod.z.enum(["approved", "rejected"])
131
130
  });
132
131
  const learningRunSchema = zod.z.object({
133
- id: zod.z.string().uuid(),
132
+ id: zod.z.guid(),
134
133
  learningContainerId: learningContainerIdSchema,
135
134
  projectId: zod.z.number().int().positive(),
136
135
  status: zod.z.enum([
@@ -172,7 +171,7 @@ const learningInsightEvidenceSchema = zod.z.union([zod.z.object({
172
171
  unavailable: unavailableSchema
173
172
  }), zod.z.object({
174
173
  kind: zod.z.literal("trajectory"),
175
- trajectoryId: zod.z.string().uuid(),
174
+ trajectoryId: zod.z.guid(),
176
175
  trajectoryPresent: zod.z.boolean(),
177
176
  eventCount: zod.z.number().int().nonnegative(),
178
177
  events: zod.z.array(zod.z.object({
@@ -186,7 +185,7 @@ const learningInsightEvidenceSchema = zod.z.union([zod.z.object({
186
185
  })]);
187
186
  /** Validates object IDs independently from container IDs; neither may alter the path. */
188
187
  function learningObjectId(id) {
189
- return zod.z.string().uuid().parse(id);
188
+ return zod.z.guid().parse(id);
190
189
  }
191
190
 
192
191
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"learning-management.cjs","names":["z"],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */\nexport const learningContainerIdSchema = z\n .string()\n .min(1)\n .max(64)\n .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nexport const learningContainerSchema = z.object({\n id: learningContainerIdSchema,\n name: z.string().min(1),\n projectId: z.number().int().positive(),\n promptContext: z.string().nullable(),\n createdAt: z.string().datetime({ offset: true }),\n updatedAt: z.string().datetime({ offset: true }),\n});\nexport const learningContainerPageSchema = z.object({\n containers: z.array(learningContainerSchema).max(500),\n nextCursor: z.string().min(1).nullable(),\n});\n/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */\nexport interface LearningContainer {\n id: string;\n name: string;\n projectId: number;\n promptContext: string | null;\n createdAt: string;\n updatedAt: string;\n}\nexport interface LearningContainerPage {\n containers: LearningContainer[];\n nextCursor: string | null;\n}\nexport interface LearningRequestOptions {\n readonly signal?: AbortSignal;\n}\nexport interface LearningContainerRequest extends LearningRequestOptions {\n readonly containerId: string;\n}\n\n/** Validates a stable identifier before constructing a request path. */\nexport function learningContainerPath(containerId: string): string {\n return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;\n}\n\n/** Reads a bounded JSON response while the request's signal governs stream cancellation. */\nexport async function readLearningJson(\n response: Response,\n limit = 16 * 1024 * 1024,\n signal?: AbortSignal,\n): Promise<unknown> {\n if (!response.body) throw new Error(\"Missing Learning response body\");\n const reader = response.body.getReader();\n const abort = () => {\n void reader.cancel(signal?.reason).catch(() => undefined);\n };\n signal?.addEventListener(\"abort\", abort, { once: true });\n if (signal?.aborted) abort();\n const decoder = new TextDecoder();\n let text = \"\";\n let bytes = 0;\n try {\n while (true) {\n signal?.throwIfAborted();\n const next = await reader.read();\n signal?.throwIfAborted();\n if (next.done) break;\n bytes += next.value.byteLength;\n if (bytes > limit) {\n await reader.cancel();\n throw new Error(\"Learning response exceeds its size limit\");\n }\n text += decoder.decode(next.value, { stream: true });\n }\n return JSON.parse(text + decoder.decode());\n } finally {\n signal?.removeEventListener(\"abort\", abort);\n reader.releaseLock();\n }\n}\n\nconst learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\nconst learningUuidSchema = z.string().uuid();\nconst learningDateTimeSchema = z.string().datetime({ offset: true });\n\n/** One immutable file in a proposed Skill candidate bundle. */\nexport const learningSkillBundleFileSchema = z.object({\n content: z.string(),\n path: z\n .string()\n .min(1)\n .refine(\n (path) =>\n !path.startsWith(\"/\") &&\n !path.split(\"/\").some((segment) => segment === \"..\"),\n \"Bundle paths must be relative and may not traverse parent directories.\",\n ),\n sha256: learningSha256Schema,\n});\n\n/** Complete Skill files attached to one review candidate. */\nexport const learningSkillBundleSchema = z\n .object({\n files: z.array(learningSkillBundleFileSchema).min(1),\n schemaVersion: z.literal(1),\n })\n\n .superRefine(({ files }, context) => {\n const paths = new Set<string>();\n for (const file of files) {\n if (paths.has(file.path)) {\n context.addIssue({\n code: \"custom\",\n message: `Duplicate bundle path: ${file.path}`,\n path: [\"files\"],\n });\n }\n paths.add(file.path);\n }\n if (!paths.has(\"SKILL.md\")) {\n context.addIssue({\n code: \"custom\",\n message: \"A Skill bundle must contain SKILL.md.\",\n path: [\"files\"],\n });\n }\n });\n\n/** Review state and summary returned for one proposed Skill change. */\nexport const learningCandidateSchema = z.object({\n bundleSha256: learningSha256Schema,\n createdAt: learningDateTimeSchema,\n description: z.string().min(1),\n id: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n reason: z.string().min(1),\n registryBaseRevision: z.number().int().nonnegative(),\n reviewedAt: learningDateTimeSchema.nullable(),\n runId: learningUuidSchema,\n status: z.enum([\"pending_review\", \"approved\", \"rejected\"]),\n subjectSha256: learningSha256Schema,\n targetSkillId: learningUuidSchema.nullable(),\n targetSkillRevision: z.number().int().positive().nullable(),\n title: z.string().min(1),\n});\n\n/** Full proposed Skill change, including evidence and every bundle file. */\nexport const learningCandidateDetailSchema = learningCandidateSchema.extend({\n bundle: learningSkillBundleSchema,\n supportingInsights: z.array(\n z.object({\n alias: z.string().min(1),\n id: learningUuidSchema,\n impact: z.string().min(1),\n statement: z.string().min(1),\n }),\n ),\n});\n\n/** Result returned after a human or agent reviews a Skill candidate. */\nexport const learningCandidateReviewSchema = z.object({\n candidateId: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n status: z.enum([\"approved\", \"rejected\"]),\n});\n\nexport interface LearningCandidate {\n id: string;\n bundleSha256: string;\n createdAt: string;\n description: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n reason: string;\n registryBaseRevision: number;\n reviewedAt: string | null;\n runId: string;\n status: \"pending_review\" | \"approved\" | \"rejected\";\n subjectSha256: string;\n targetSkillId: string | null;\n targetSkillRevision: number | null;\n title: string;\n}\nexport interface LearningCandidateDetail extends LearningCandidate {\n bundle: {\n schemaVersion: 1;\n files: Array<{ path: string; content: string; sha256: string }>;\n };\n supportingInsights: Array<{\n alias: string;\n id: string;\n impact: string;\n statement: string;\n }>;\n}\nexport interface LearningCandidateReview {\n candidateId: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n status: \"approved\" | \"rejected\";\n}\nexport interface LearningCandidateRequest extends LearningContainerRequest {\n readonly candidateId: string;\n}\n\nexport const learningRunSchema = z.object({\n id: z.string().uuid(),\n learningContainerId: learningContainerIdSchema,\n projectId: z.number().int().positive(),\n status: z.enum([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n ]),\n triggerSource: z.enum([\"automatic\", \"manual\"]),\n attemptCount: z.number().int().nonnegative(),\n candidateCount: z.number().int().nonnegative().nullable(),\n insightCount: z.number().int().nonnegative().nullable(),\n evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),\n createdAt: learningDateTimeSchema,\n updatedAt: learningDateTimeSchema,\n startedAt: learningDateTimeSchema.nullable(),\n completedAt: learningDateTimeSchema.nullable(),\n failureCode: z.string().nullable(),\n kubernetesJobName: z.string().nullable(),\n});\nexport interface LearningRun {\n id: string;\n learningContainerId: string;\n projectId: number;\n status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n triggerSource: \"automatic\" | \"manual\";\n attemptCount: number;\n candidateCount: number | null;\n insightCount: number | null;\n evidenceThreadCount?: number | null;\n createdAt: string;\n updatedAt: string;\n startedAt: string | null;\n completedAt: string | null;\n failureCode: string | null;\n kubernetesJobName: string | null;\n}\nconst unavailableSchema = z\n .enum([\"snapshot-missing\", \"snapshot-unreadable\"])\n .nullable();\nexport const learningInsightEvidenceSchema = z.union([\n z.object({\n cited: z.array(\n z.object({\n id: z.string(),\n content: z.string(),\n role: z.enum([\"assistant\", \"tool\", \"user\"]),\n }),\n ),\n messageCount: z.number().int().nonnegative(),\n threadId: z.string(),\n threadName: z.string().nullable(),\n threadPresent: z.boolean(),\n unavailable: unavailableSchema,\n }),\n z.object({\n kind: z.literal(\"trajectory\"),\n trajectoryId: z.string().uuid(),\n trajectoryPresent: z.boolean(),\n eventCount: z.number().int().nonnegative(),\n events: z.array(\n z.object({\n seq: z.number().int().nonnegative(),\n name: z.string(),\n offsetMs: z.number(),\n value: z.unknown(),\n eventId: z.string().nullable(),\n }),\n ),\n unavailable: unavailableSchema,\n }),\n]);\nexport type LearningInsightEvidence =\n | {\n cited: Array<{\n id: string;\n content: string;\n role: \"assistant\" | \"tool\" | \"user\";\n }>;\n messageCount: number;\n threadId: string;\n threadName: string | null;\n threadPresent: boolean;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n }\n | {\n kind: \"trajectory\";\n trajectoryId: string;\n trajectoryPresent: boolean;\n eventCount: number;\n events: Array<{\n seq: number;\n name: string;\n offsetMs: number;\n value?: unknown;\n eventId: string | null;\n }>;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n };\n\n/** Validates object IDs independently from container IDs; neither may alter the path. */\nexport function learningObjectId(id: string): string {\n return z.string().uuid().parse(id);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"learning-management.cjs","names":["z"],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */\nexport const learningContainerIdSchema = z\n .string()\n .min(1)\n .max(64)\n .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nexport const learningContainerSchema = z.object({\n id: learningContainerIdSchema,\n name: z.string().min(1),\n projectId: z.number().int().positive(),\n promptContext: z.string().nullable(),\n createdAt: z.iso.datetime({ offset: true }),\n updatedAt: z.iso.datetime({ offset: true }),\n});\nexport const learningContainerPageSchema = z.object({\n containers: z.array(learningContainerSchema).max(500),\n nextCursor: z.string().min(1).nullable(),\n});\n/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */\nexport interface LearningContainer {\n id: string;\n name: string;\n projectId: number;\n promptContext: string | null;\n createdAt: string;\n updatedAt: string;\n}\nexport interface LearningContainerPage {\n containers: LearningContainer[];\n nextCursor: string | null;\n}\nexport interface LearningRequestOptions {\n readonly signal?: AbortSignal;\n}\nexport interface LearningContainerRequest extends LearningRequestOptions {\n readonly containerId: string;\n}\n\n/** Validates a stable identifier before constructing a request path. */\nexport function learningContainerPath(containerId: string): string {\n return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;\n}\n\n/** Reads a bounded JSON response while the request's signal governs stream cancellation. */\nexport async function readLearningJson(\n response: Response,\n limit = 16 * 1024 * 1024,\n signal?: AbortSignal,\n): Promise<unknown> {\n if (!response.body) throw new Error(\"Missing Learning response body\");\n const reader = response.body.getReader();\n const abort = () => {\n void reader.cancel(signal?.reason).catch(() => undefined);\n };\n signal?.addEventListener(\"abort\", abort, { once: true });\n if (signal?.aborted) abort();\n const decoder = new TextDecoder();\n let text = \"\";\n let bytes = 0;\n try {\n while (true) {\n signal?.throwIfAborted();\n const next = await reader.read();\n signal?.throwIfAborted();\n if (next.done) break;\n bytes += next.value.byteLength;\n if (bytes > limit) {\n await reader.cancel();\n throw new Error(\"Learning response exceeds its size limit\");\n }\n text += decoder.decode(next.value, { stream: true });\n }\n return JSON.parse(text + decoder.decode());\n } finally {\n signal?.removeEventListener(\"abort\", abort);\n reader.releaseLock();\n }\n}\n\nconst learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\nconst learningUuidSchema = z.guid();\nconst learningDateTimeSchema = z.iso.datetime({ offset: true });\n\n/** One immutable file in a proposed Skill candidate bundle. */\nexport const learningSkillBundleFileSchema = z.object({\n content: z.string(),\n path: z\n .string()\n .min(1)\n .refine(\n (path) =>\n !path.startsWith(\"/\") &&\n !path.split(\"/\").some((segment) => segment === \"..\"),\n \"Bundle paths must be relative and may not traverse parent directories.\",\n ),\n sha256: learningSha256Schema,\n});\n\n/** Complete Skill files attached to one review candidate. */\nexport const learningSkillBundleSchema = z\n .object({\n files: z.array(learningSkillBundleFileSchema).min(1),\n schemaVersion: z.literal(1),\n })\n\n .superRefine(({ files }, context) => {\n const paths = new Set<string>();\n for (const file of files) {\n if (paths.has(file.path)) {\n context.addIssue({\n code: \"custom\",\n message: `Duplicate bundle path: ${file.path}`,\n path: [\"files\"],\n });\n }\n paths.add(file.path);\n }\n if (!paths.has(\"SKILL.md\")) {\n context.addIssue({\n code: \"custom\",\n message: \"A Skill bundle must contain SKILL.md.\",\n path: [\"files\"],\n });\n }\n });\n\n/** Review state and summary returned for one proposed Skill change. */\nexport const learningCandidateSchema = z.object({\n bundleSha256: learningSha256Schema,\n createdAt: learningDateTimeSchema,\n description: z.string().min(1),\n id: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n reason: z.string().min(1),\n registryBaseRevision: z.number().int().nonnegative(),\n reviewedAt: learningDateTimeSchema.nullable(),\n runId: learningUuidSchema,\n status: z.enum([\"pending_review\", \"approved\", \"rejected\"]),\n subjectSha256: learningSha256Schema,\n targetSkillId: learningUuidSchema.nullable(),\n targetSkillRevision: z.number().int().positive().nullable(),\n title: z.string().min(1),\n});\n\n/** Full proposed Skill change, including evidence and every bundle file. */\nexport const learningCandidateDetailSchema = learningCandidateSchema.extend({\n bundle: learningSkillBundleSchema,\n supportingInsights: z.array(\n z.object({\n alias: z.string().min(1),\n id: learningUuidSchema,\n impact: z.string().min(1),\n statement: z.string().min(1),\n }),\n ),\n});\n\n/** Result returned after a human or agent reviews a Skill candidate. */\nexport const learningCandidateReviewSchema = z.object({\n candidateId: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n status: z.enum([\"approved\", \"rejected\"]),\n});\n\nexport interface LearningCandidate {\n id: string;\n bundleSha256: string;\n createdAt: string;\n description: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n reason: string;\n registryBaseRevision: number;\n reviewedAt: string | null;\n runId: string;\n status: \"pending_review\" | \"approved\" | \"rejected\";\n subjectSha256: string;\n targetSkillId: string | null;\n targetSkillRevision: number | null;\n title: string;\n}\nexport interface LearningCandidateDetail extends LearningCandidate {\n bundle: {\n schemaVersion: 1;\n files: Array<{ path: string; content: string; sha256: string }>;\n };\n supportingInsights: Array<{\n alias: string;\n id: string;\n impact: string;\n statement: string;\n }>;\n}\nexport interface LearningCandidateReview {\n candidateId: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n status: \"approved\" | \"rejected\";\n}\nexport interface LearningCandidateRequest extends LearningContainerRequest {\n readonly candidateId: string;\n}\n\nexport const learningRunSchema = z.object({\n id: z.guid(),\n learningContainerId: learningContainerIdSchema,\n projectId: z.number().int().positive(),\n status: z.enum([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n ]),\n triggerSource: z.enum([\"automatic\", \"manual\"]),\n attemptCount: z.number().int().nonnegative(),\n candidateCount: z.number().int().nonnegative().nullable(),\n insightCount: z.number().int().nonnegative().nullable(),\n evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),\n createdAt: learningDateTimeSchema,\n updatedAt: learningDateTimeSchema,\n startedAt: learningDateTimeSchema.nullable(),\n completedAt: learningDateTimeSchema.nullable(),\n failureCode: z.string().nullable(),\n kubernetesJobName: z.string().nullable(),\n});\nexport interface LearningRun {\n id: string;\n learningContainerId: string;\n projectId: number;\n status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n triggerSource: \"automatic\" | \"manual\";\n attemptCount: number;\n candidateCount: number | null;\n insightCount: number | null;\n evidenceThreadCount?: number | null;\n createdAt: string;\n updatedAt: string;\n startedAt: string | null;\n completedAt: string | null;\n failureCode: string | null;\n kubernetesJobName: string | null;\n}\nconst unavailableSchema = z\n .enum([\"snapshot-missing\", \"snapshot-unreadable\"])\n .nullable();\nexport const learningInsightEvidenceSchema = z.union([\n z.object({\n cited: z.array(\n z.object({\n id: z.string(),\n content: z.string(),\n role: z.enum([\"assistant\", \"tool\", \"user\"]),\n }),\n ),\n messageCount: z.number().int().nonnegative(),\n threadId: z.string(),\n threadName: z.string().nullable(),\n threadPresent: z.boolean(),\n unavailable: unavailableSchema,\n }),\n z.object({\n kind: z.literal(\"trajectory\"),\n trajectoryId: z.guid(),\n trajectoryPresent: z.boolean(),\n eventCount: z.number().int().nonnegative(),\n events: z.array(\n z.object({\n seq: z.number().int().nonnegative(),\n name: z.string(),\n offsetMs: z.number(),\n value: z.unknown(),\n eventId: z.string().nullable(),\n }),\n ),\n unavailable: unavailableSchema,\n }),\n]);\nexport type LearningInsightEvidence =\n | {\n cited: Array<{\n id: string;\n content: string;\n role: \"assistant\" | \"tool\" | \"user\";\n }>;\n messageCount: number;\n threadId: string;\n threadName: string | null;\n threadPresent: boolean;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n }\n | {\n kind: \"trajectory\";\n trajectoryId: string;\n trajectoryPresent: boolean;\n eventCount: number;\n events: Array<{\n seq: number;\n name: string;\n offsetMs: number;\n value?: unknown;\n eventId: string | null;\n }>;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n };\n\n/** Validates object IDs independently from container IDs; neither may alter the path. */\nexport function learningObjectId(id: string): string {\n return z.guid().parse(id);\n}\n"],"mappings":";;;;AAGA,MAAa,4BAA4BA,MACtC,QAAQ,CACR,IAAI,EAAE,CACN,IAAI,GAAG,CACP,MAAM,6BAA6B;AACtC,MAAa,0BAA0BA,MAAE,OAAO;CAC9C,IAAI;CACJ,MAAMA,MAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,WAAWA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CACtC,eAAeA,MAAE,QAAQ,CAAC,UAAU;CACpC,WAAWA,MAAE,IAAI,SAAS,EAAE,QAAQ,MAAM,CAAC;CAC3C,WAAWA,MAAE,IAAI,SAAS,EAAE,QAAQ,MAAM,CAAC;CAC5C,CAAC;AACF,MAAa,8BAA8BA,MAAE,OAAO;CAClD,YAAYA,MAAE,MAAM,wBAAwB,CAAC,IAAI,IAAI;CACrD,YAAYA,MAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACzC,CAAC;;AAsBF,SAAgB,sBAAsB,aAA6B;AACjE,QAAO,+BAA+B,mBAAmB,0BAA0B,MAAM,YAAY,CAAC;;;AAIxG,eAAsB,iBACpB,UACA,QAAQ,KAAK,OAAO,MACpB,QACkB;AAClB,KAAI,CAAC,SAAS,KAAM,OAAM,IAAI,MAAM,iCAAiC;CACrE,MAAM,SAAS,SAAS,KAAK,WAAW;CACxC,MAAM,cAAc;AAClB,EAAK,OAAO,OAAO,QAAQ,OAAO,CAAC,YAAY,OAAU;;AAE3D,SAAQ,iBAAiB,SAAS,OAAO,EAAE,MAAM,MAAM,CAAC;AACxD,KAAI,QAAQ,QAAS,QAAO;CAC5B,MAAM,UAAU,IAAI,aAAa;CACjC,IAAI,OAAO;CACX,IAAI,QAAQ;AACZ,KAAI;AACF,SAAO,MAAM;AACX,WAAQ,gBAAgB;GACxB,MAAM,OAAO,MAAM,OAAO,MAAM;AAChC,WAAQ,gBAAgB;AACxB,OAAI,KAAK,KAAM;AACf,YAAS,KAAK,MAAM;AACpB,OAAI,QAAQ,OAAO;AACjB,UAAM,OAAO,QAAQ;AACrB,UAAM,IAAI,MAAM,2CAA2C;;AAE7D,WAAQ,QAAQ,OAAO,KAAK,OAAO,EAAE,QAAQ,MAAM,CAAC;;AAEtD,SAAO,KAAK,MAAM,OAAO,QAAQ,QAAQ,CAAC;WAClC;AACR,UAAQ,oBAAoB,SAAS,MAAM;AAC3C,SAAO,aAAa;;;AAIxB,MAAM,uBAAuBA,MAAE,QAAQ,CAAC,MAAM,kBAAkB;AAChE,MAAM,qBAAqBA,MAAE,MAAM;AACnC,MAAM,yBAAyBA,MAAE,IAAI,SAAS,EAAE,QAAQ,MAAM,CAAC;;AAG/D,MAAa,gCAAgCA,MAAE,OAAO;CACpD,SAASA,MAAE,QAAQ;CACnB,MAAMA,MACH,QAAQ,CACR,IAAI,EAAE,CACN,QACE,SACC,CAAC,KAAK,WAAW,IAAI,IACrB,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,YAAY,YAAY,KAAK,EACtD,yEACD;CACH,QAAQ;CACT,CAAC;;AAGF,MAAa,4BAA4BA,MACtC,OAAO;CACN,OAAOA,MAAE,MAAM,8BAA8B,CAAC,IAAI,EAAE;CACpD,eAAeA,MAAE,QAAQ,EAAE;CAC5B,CAAC,CAED,aAAa,EAAE,SAAS,YAAY;CACnC,MAAM,wBAAQ,IAAI,KAAa;AAC/B,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,MAAM,IAAI,KAAK,KAAK,CACtB,SAAQ,SAAS;GACf,MAAM;GACN,SAAS,0BAA0B,KAAK;GACxC,MAAM,CAAC,QAAQ;GAChB,CAAC;AAEJ,QAAM,IAAI,KAAK,KAAK;;AAEtB,KAAI,CAAC,MAAM,IAAI,WAAW,CACxB,SAAQ,SAAS;EACf,MAAM;EACN,SAAS;EACT,MAAM,CAAC,QAAQ;EAChB,CAAC;EAEJ;;AAGJ,MAAa,0BAA0BA,MAAE,OAAO;CAC9C,cAAc;CACd,WAAW;CACX,aAAaA,MAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,IAAI;CACJ,WAAWA,MAAE,KAAK;EAAC;EAAO;EAAU;EAAS,CAAC;CAC9C,2BAA2BA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CACjE,kBAAkB,mBAAmB,UAAU;CAC/C,QAAQA,MAAE,QAAQ,CAAC,IAAI,EAAE;CACzB,sBAAsBA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CACpD,YAAY,uBAAuB,UAAU;CAC7C,OAAO;CACP,QAAQA,MAAE,KAAK;EAAC;EAAkB;EAAY;EAAW,CAAC;CAC1D,eAAe;CACf,eAAe,mBAAmB,UAAU;CAC5C,qBAAqBA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CAC3D,OAAOA,MAAE,QAAQ,CAAC,IAAI,EAAE;CACzB,CAAC;;AAGF,MAAa,gCAAgC,wBAAwB,OAAO;CAC1E,QAAQ;CACR,oBAAoBA,MAAE,MACpBA,MAAE,OAAO;EACP,OAAOA,MAAE,QAAQ,CAAC,IAAI,EAAE;EACxB,IAAI;EACJ,QAAQA,MAAE,QAAQ,CAAC,IAAI,EAAE;EACzB,WAAWA,MAAE,QAAQ,CAAC,IAAI,EAAE;EAC7B,CAAC,CACH;CACF,CAAC;;AAGF,MAAa,gCAAgCA,MAAE,OAAO;CACpD,aAAa;CACb,WAAWA,MAAE,KAAK;EAAC;EAAO;EAAU;EAAS,CAAC;CAC9C,2BAA2BA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CACjE,kBAAkB,mBAAmB,UAAU;CAC/C,QAAQA,MAAE,KAAK,CAAC,YAAY,WAAW,CAAC;CACzC,CAAC;AA2CF,MAAa,oBAAoBA,MAAE,OAAO;CACxC,IAAIA,MAAE,MAAM;CACZ,qBAAqB;CACrB,WAAWA,MAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CACtC,QAAQA,MAAE,KAAK;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CACF,eAAeA,MAAE,KAAK,CAAC,aAAa,SAAS,CAAC;CAC9C,cAAcA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CAC5C,gBAAgBA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU;CACzD,cAAcA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU;CACvD,qBAAqBA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,UAAU;CACzE,WAAW;CACX,WAAW;CACX,WAAW,uBAAuB,UAAU;CAC5C,aAAa,uBAAuB,UAAU;CAC9C,aAAaA,MAAE,QAAQ,CAAC,UAAU;CAClC,mBAAmBA,MAAE,QAAQ,CAAC,UAAU;CACzC,CAAC;AAyBF,MAAM,oBAAoBA,MACvB,KAAK,CAAC,oBAAoB,sBAAsB,CAAC,CACjD,UAAU;AACb,MAAa,gCAAgCA,MAAE,MAAM,CACnDA,MAAE,OAAO;CACP,OAAOA,MAAE,MACPA,MAAE,OAAO;EACP,IAAIA,MAAE,QAAQ;EACd,SAASA,MAAE,QAAQ;EACnB,MAAMA,MAAE,KAAK;GAAC;GAAa;GAAQ;GAAO,CAAC;EAC5C,CAAC,CACH;CACD,cAAcA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CAC5C,UAAUA,MAAE,QAAQ;CACpB,YAAYA,MAAE,QAAQ,CAAC,UAAU;CACjC,eAAeA,MAAE,SAAS;CAC1B,aAAa;CACd,CAAC,EACFA,MAAE,OAAO;CACP,MAAMA,MAAE,QAAQ,aAAa;CAC7B,cAAcA,MAAE,MAAM;CACtB,mBAAmBA,MAAE,SAAS;CAC9B,YAAYA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CAC1C,QAAQA,MAAE,MACRA,MAAE,OAAO;EACP,KAAKA,MAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;EACnC,MAAMA,MAAE,QAAQ;EAChB,UAAUA,MAAE,QAAQ;EACpB,OAAOA,MAAE,SAAS;EAClB,SAASA,MAAE,QAAQ,CAAC,UAAU;EAC/B,CAAC,CACH;CACD,aAAa;CACd,CAAC,CACH,CAAC;;AA8BF,SAAgB,iBAAiB,IAAoB;AACnD,QAAOA,MAAE,MAAM,CAAC,MAAM,GAAG"}
@@ -8,8 +8,8 @@ const learningContainerSchema = z.object({
8
8
  name: z.string().min(1),
9
9
  projectId: z.number().int().positive(),
10
10
  promptContext: z.string().nullable(),
11
- createdAt: z.string().datetime({ offset: true }),
12
- updatedAt: z.string().datetime({ offset: true })
11
+ createdAt: z.iso.datetime({ offset: true }),
12
+ updatedAt: z.iso.datetime({ offset: true })
13
13
  });
14
14
  const learningContainerPageSchema = z.object({
15
15
  containers: z.array(learningContainerSchema).max(500),
@@ -51,8 +51,8 @@ async function readLearningJson(response, limit = 16 * 1024 * 1024, signal) {
51
51
  }
52
52
  }
53
53
  const learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);
54
- const learningUuidSchema = z.string().uuid();
55
- const learningDateTimeSchema = z.string().datetime({ offset: true });
54
+ const learningUuidSchema = z.guid();
55
+ const learningDateTimeSchema = z.iso.datetime({ offset: true });
56
56
  /** One immutable file in a proposed Skill candidate bundle. */
57
57
  const learningSkillBundleFileSchema = z.object({
58
58
  content: z.string(),
@@ -129,7 +129,7 @@ const learningCandidateReviewSchema = z.object({
129
129
  status: z.enum(["approved", "rejected"])
130
130
  });
131
131
  const learningRunSchema = z.object({
132
- id: z.string().uuid(),
132
+ id: z.guid(),
133
133
  learningContainerId: learningContainerIdSchema,
134
134
  projectId: z.number().int().positive(),
135
135
  status: z.enum([
@@ -171,7 +171,7 @@ const learningInsightEvidenceSchema = z.union([z.object({
171
171
  unavailable: unavailableSchema
172
172
  }), z.object({
173
173
  kind: z.literal("trajectory"),
174
- trajectoryId: z.string().uuid(),
174
+ trajectoryId: z.guid(),
175
175
  trajectoryPresent: z.boolean(),
176
176
  eventCount: z.number().int().nonnegative(),
177
177
  events: z.array(z.object({
@@ -185,7 +185,7 @@ const learningInsightEvidenceSchema = z.union([z.object({
185
185
  })]);
186
186
  /** Validates object IDs independently from container IDs; neither may alter the path. */
187
187
  function learningObjectId(id) {
188
- return z.string().uuid().parse(id);
188
+ return z.guid().parse(id);
189
189
  }
190
190
 
191
191
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"learning-management.mjs","names":[],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */\nexport const learningContainerIdSchema = z\n .string()\n .min(1)\n .max(64)\n .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nexport const learningContainerSchema = z.object({\n id: learningContainerIdSchema,\n name: z.string().min(1),\n projectId: z.number().int().positive(),\n promptContext: z.string().nullable(),\n createdAt: z.string().datetime({ offset: true }),\n updatedAt: z.string().datetime({ offset: true }),\n});\nexport const learningContainerPageSchema = z.object({\n containers: z.array(learningContainerSchema).max(500),\n nextCursor: z.string().min(1).nullable(),\n});\n/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */\nexport interface LearningContainer {\n id: string;\n name: string;\n projectId: number;\n promptContext: string | null;\n createdAt: string;\n updatedAt: string;\n}\nexport interface LearningContainerPage {\n containers: LearningContainer[];\n nextCursor: string | null;\n}\nexport interface LearningRequestOptions {\n readonly signal?: AbortSignal;\n}\nexport interface LearningContainerRequest extends LearningRequestOptions {\n readonly containerId: string;\n}\n\n/** Validates a stable identifier before constructing a request path. */\nexport function learningContainerPath(containerId: string): string {\n return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;\n}\n\n/** Reads a bounded JSON response while the request's signal governs stream cancellation. */\nexport async function readLearningJson(\n response: Response,\n limit = 16 * 1024 * 1024,\n signal?: AbortSignal,\n): Promise<unknown> {\n if (!response.body) throw new Error(\"Missing Learning response body\");\n const reader = response.body.getReader();\n const abort = () => {\n void reader.cancel(signal?.reason).catch(() => undefined);\n };\n signal?.addEventListener(\"abort\", abort, { once: true });\n if (signal?.aborted) abort();\n const decoder = new TextDecoder();\n let text = \"\";\n let bytes = 0;\n try {\n while (true) {\n signal?.throwIfAborted();\n const next = await reader.read();\n signal?.throwIfAborted();\n if (next.done) break;\n bytes += next.value.byteLength;\n if (bytes > limit) {\n await reader.cancel();\n throw new Error(\"Learning response exceeds its size limit\");\n }\n text += decoder.decode(next.value, { stream: true });\n }\n return JSON.parse(text + decoder.decode());\n } finally {\n signal?.removeEventListener(\"abort\", abort);\n reader.releaseLock();\n }\n}\n\nconst learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\nconst learningUuidSchema = z.string().uuid();\nconst learningDateTimeSchema = z.string().datetime({ offset: true });\n\n/** One immutable file in a proposed Skill candidate bundle. */\nexport const learningSkillBundleFileSchema = z.object({\n content: z.string(),\n path: z\n .string()\n .min(1)\n .refine(\n (path) =>\n !path.startsWith(\"/\") &&\n !path.split(\"/\").some((segment) => segment === \"..\"),\n \"Bundle paths must be relative and may not traverse parent directories.\",\n ),\n sha256: learningSha256Schema,\n});\n\n/** Complete Skill files attached to one review candidate. */\nexport const learningSkillBundleSchema = z\n .object({\n files: z.array(learningSkillBundleFileSchema).min(1),\n schemaVersion: z.literal(1),\n })\n\n .superRefine(({ files }, context) => {\n const paths = new Set<string>();\n for (const file of files) {\n if (paths.has(file.path)) {\n context.addIssue({\n code: \"custom\",\n message: `Duplicate bundle path: ${file.path}`,\n path: [\"files\"],\n });\n }\n paths.add(file.path);\n }\n if (!paths.has(\"SKILL.md\")) {\n context.addIssue({\n code: \"custom\",\n message: \"A Skill bundle must contain SKILL.md.\",\n path: [\"files\"],\n });\n }\n });\n\n/** Review state and summary returned for one proposed Skill change. */\nexport const learningCandidateSchema = z.object({\n bundleSha256: learningSha256Schema,\n createdAt: learningDateTimeSchema,\n description: z.string().min(1),\n id: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n reason: z.string().min(1),\n registryBaseRevision: z.number().int().nonnegative(),\n reviewedAt: learningDateTimeSchema.nullable(),\n runId: learningUuidSchema,\n status: z.enum([\"pending_review\", \"approved\", \"rejected\"]),\n subjectSha256: learningSha256Schema,\n targetSkillId: learningUuidSchema.nullable(),\n targetSkillRevision: z.number().int().positive().nullable(),\n title: z.string().min(1),\n});\n\n/** Full proposed Skill change, including evidence and every bundle file. */\nexport const learningCandidateDetailSchema = learningCandidateSchema.extend({\n bundle: learningSkillBundleSchema,\n supportingInsights: z.array(\n z.object({\n alias: z.string().min(1),\n id: learningUuidSchema,\n impact: z.string().min(1),\n statement: z.string().min(1),\n }),\n ),\n});\n\n/** Result returned after a human or agent reviews a Skill candidate. */\nexport const learningCandidateReviewSchema = z.object({\n candidateId: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n status: z.enum([\"approved\", \"rejected\"]),\n});\n\nexport interface LearningCandidate {\n id: string;\n bundleSha256: string;\n createdAt: string;\n description: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n reason: string;\n registryBaseRevision: number;\n reviewedAt: string | null;\n runId: string;\n status: \"pending_review\" | \"approved\" | \"rejected\";\n subjectSha256: string;\n targetSkillId: string | null;\n targetSkillRevision: number | null;\n title: string;\n}\nexport interface LearningCandidateDetail extends LearningCandidate {\n bundle: {\n schemaVersion: 1;\n files: Array<{ path: string; content: string; sha256: string }>;\n };\n supportingInsights: Array<{\n alias: string;\n id: string;\n impact: string;\n statement: string;\n }>;\n}\nexport interface LearningCandidateReview {\n candidateId: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n status: \"approved\" | \"rejected\";\n}\nexport interface LearningCandidateRequest extends LearningContainerRequest {\n readonly candidateId: string;\n}\n\nexport const learningRunSchema = z.object({\n id: z.string().uuid(),\n learningContainerId: learningContainerIdSchema,\n projectId: z.number().int().positive(),\n status: z.enum([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n ]),\n triggerSource: z.enum([\"automatic\", \"manual\"]),\n attemptCount: z.number().int().nonnegative(),\n candidateCount: z.number().int().nonnegative().nullable(),\n insightCount: z.number().int().nonnegative().nullable(),\n evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),\n createdAt: learningDateTimeSchema,\n updatedAt: learningDateTimeSchema,\n startedAt: learningDateTimeSchema.nullable(),\n completedAt: learningDateTimeSchema.nullable(),\n failureCode: z.string().nullable(),\n kubernetesJobName: z.string().nullable(),\n});\nexport interface LearningRun {\n id: string;\n learningContainerId: string;\n projectId: number;\n status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n triggerSource: \"automatic\" | \"manual\";\n attemptCount: number;\n candidateCount: number | null;\n insightCount: number | null;\n evidenceThreadCount?: number | null;\n createdAt: string;\n updatedAt: string;\n startedAt: string | null;\n completedAt: string | null;\n failureCode: string | null;\n kubernetesJobName: string | null;\n}\nconst unavailableSchema = z\n .enum([\"snapshot-missing\", \"snapshot-unreadable\"])\n .nullable();\nexport const learningInsightEvidenceSchema = z.union([\n z.object({\n cited: z.array(\n z.object({\n id: z.string(),\n content: z.string(),\n role: z.enum([\"assistant\", \"tool\", \"user\"]),\n }),\n ),\n messageCount: z.number().int().nonnegative(),\n threadId: z.string(),\n threadName: z.string().nullable(),\n threadPresent: z.boolean(),\n unavailable: unavailableSchema,\n }),\n z.object({\n kind: z.literal(\"trajectory\"),\n trajectoryId: z.string().uuid(),\n trajectoryPresent: z.boolean(),\n eventCount: z.number().int().nonnegative(),\n events: z.array(\n z.object({\n seq: z.number().int().nonnegative(),\n name: z.string(),\n offsetMs: z.number(),\n value: z.unknown(),\n eventId: z.string().nullable(),\n }),\n ),\n unavailable: unavailableSchema,\n }),\n]);\nexport type LearningInsightEvidence =\n | {\n cited: Array<{\n id: string;\n content: string;\n role: \"assistant\" | \"tool\" | \"user\";\n }>;\n messageCount: number;\n threadId: string;\n threadName: string | null;\n threadPresent: boolean;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n }\n | {\n kind: \"trajectory\";\n trajectoryId: string;\n trajectoryPresent: boolean;\n eventCount: number;\n events: Array<{\n seq: number;\n name: string;\n offsetMs: number;\n value?: unknown;\n eventId: string | null;\n }>;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n };\n\n/** Validates object IDs independently from container IDs; neither may alter the path. */\nexport function learningObjectId(id: string): string {\n return z.string().uuid().parse(id);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"learning-management.mjs","names":[],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */\nexport const learningContainerIdSchema = z\n .string()\n .min(1)\n .max(64)\n .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nexport const learningContainerSchema = z.object({\n id: learningContainerIdSchema,\n name: z.string().min(1),\n projectId: z.number().int().positive(),\n promptContext: z.string().nullable(),\n createdAt: z.iso.datetime({ offset: true }),\n updatedAt: z.iso.datetime({ offset: true }),\n});\nexport const learningContainerPageSchema = z.object({\n containers: z.array(learningContainerSchema).max(500),\n nextCursor: z.string().min(1).nullable(),\n});\n/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */\nexport interface LearningContainer {\n id: string;\n name: string;\n projectId: number;\n promptContext: string | null;\n createdAt: string;\n updatedAt: string;\n}\nexport interface LearningContainerPage {\n containers: LearningContainer[];\n nextCursor: string | null;\n}\nexport interface LearningRequestOptions {\n readonly signal?: AbortSignal;\n}\nexport interface LearningContainerRequest extends LearningRequestOptions {\n readonly containerId: string;\n}\n\n/** Validates a stable identifier before constructing a request path. */\nexport function learningContainerPath(containerId: string): string {\n return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;\n}\n\n/** Reads a bounded JSON response while the request's signal governs stream cancellation. */\nexport async function readLearningJson(\n response: Response,\n limit = 16 * 1024 * 1024,\n signal?: AbortSignal,\n): Promise<unknown> {\n if (!response.body) throw new Error(\"Missing Learning response body\");\n const reader = response.body.getReader();\n const abort = () => {\n void reader.cancel(signal?.reason).catch(() => undefined);\n };\n signal?.addEventListener(\"abort\", abort, { once: true });\n if (signal?.aborted) abort();\n const decoder = new TextDecoder();\n let text = \"\";\n let bytes = 0;\n try {\n while (true) {\n signal?.throwIfAborted();\n const next = await reader.read();\n signal?.throwIfAborted();\n if (next.done) break;\n bytes += next.value.byteLength;\n if (bytes > limit) {\n await reader.cancel();\n throw new Error(\"Learning response exceeds its size limit\");\n }\n text += decoder.decode(next.value, { stream: true });\n }\n return JSON.parse(text + decoder.decode());\n } finally {\n signal?.removeEventListener(\"abort\", abort);\n reader.releaseLock();\n }\n}\n\nconst learningSha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\nconst learningUuidSchema = z.guid();\nconst learningDateTimeSchema = z.iso.datetime({ offset: true });\n\n/** One immutable file in a proposed Skill candidate bundle. */\nexport const learningSkillBundleFileSchema = z.object({\n content: z.string(),\n path: z\n .string()\n .min(1)\n .refine(\n (path) =>\n !path.startsWith(\"/\") &&\n !path.split(\"/\").some((segment) => segment === \"..\"),\n \"Bundle paths must be relative and may not traverse parent directories.\",\n ),\n sha256: learningSha256Schema,\n});\n\n/** Complete Skill files attached to one review candidate. */\nexport const learningSkillBundleSchema = z\n .object({\n files: z.array(learningSkillBundleFileSchema).min(1),\n schemaVersion: z.literal(1),\n })\n\n .superRefine(({ files }, context) => {\n const paths = new Set<string>();\n for (const file of files) {\n if (paths.has(file.path)) {\n context.addIssue({\n code: \"custom\",\n message: `Duplicate bundle path: ${file.path}`,\n path: [\"files\"],\n });\n }\n paths.add(file.path);\n }\n if (!paths.has(\"SKILL.md\")) {\n context.addIssue({\n code: \"custom\",\n message: \"A Skill bundle must contain SKILL.md.\",\n path: [\"files\"],\n });\n }\n });\n\n/** Review state and summary returned for one proposed Skill change. */\nexport const learningCandidateSchema = z.object({\n bundleSha256: learningSha256Schema,\n createdAt: learningDateTimeSchema,\n description: z.string().min(1),\n id: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n reason: z.string().min(1),\n registryBaseRevision: z.number().int().nonnegative(),\n reviewedAt: learningDateTimeSchema.nullable(),\n runId: learningUuidSchema,\n status: z.enum([\"pending_review\", \"approved\", \"rejected\"]),\n subjectSha256: learningSha256Schema,\n targetSkillId: learningUuidSchema.nullable(),\n targetSkillRevision: z.number().int().positive().nullable(),\n title: z.string().min(1),\n});\n\n/** Full proposed Skill change, including evidence and every bundle file. */\nexport const learningCandidateDetailSchema = learningCandidateSchema.extend({\n bundle: learningSkillBundleSchema,\n supportingInsights: z.array(\n z.object({\n alias: z.string().min(1),\n id: learningUuidSchema,\n impact: z.string().min(1),\n statement: z.string().min(1),\n }),\n ),\n});\n\n/** Result returned after a human or agent reviews a Skill candidate. */\nexport const learningCandidateReviewSchema = z.object({\n candidateId: learningUuidSchema,\n operation: z.enum([\"add\", \"update\", \"remove\"]),\n publishedRegistryRevision: z.number().int().positive().nullable(),\n publishedSkillId: learningUuidSchema.nullable(),\n status: z.enum([\"approved\", \"rejected\"]),\n});\n\nexport interface LearningCandidate {\n id: string;\n bundleSha256: string;\n createdAt: string;\n description: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n reason: string;\n registryBaseRevision: number;\n reviewedAt: string | null;\n runId: string;\n status: \"pending_review\" | \"approved\" | \"rejected\";\n subjectSha256: string;\n targetSkillId: string | null;\n targetSkillRevision: number | null;\n title: string;\n}\nexport interface LearningCandidateDetail extends LearningCandidate {\n bundle: {\n schemaVersion: 1;\n files: Array<{ path: string; content: string; sha256: string }>;\n };\n supportingInsights: Array<{\n alias: string;\n id: string;\n impact: string;\n statement: string;\n }>;\n}\nexport interface LearningCandidateReview {\n candidateId: string;\n operation: \"add\" | \"update\" | \"remove\";\n publishedRegistryRevision: number | null;\n publishedSkillId: string | null;\n status: \"approved\" | \"rejected\";\n}\nexport interface LearningCandidateRequest extends LearningContainerRequest {\n readonly candidateId: string;\n}\n\nexport const learningRunSchema = z.object({\n id: z.guid(),\n learningContainerId: learningContainerIdSchema,\n projectId: z.number().int().positive(),\n status: z.enum([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n ]),\n triggerSource: z.enum([\"automatic\", \"manual\"]),\n attemptCount: z.number().int().nonnegative(),\n candidateCount: z.number().int().nonnegative().nullable(),\n insightCount: z.number().int().nonnegative().nullable(),\n evidenceThreadCount: z.number().int().nonnegative().nullable().optional(),\n createdAt: learningDateTimeSchema,\n updatedAt: learningDateTimeSchema,\n startedAt: learningDateTimeSchema.nullable(),\n completedAt: learningDateTimeSchema.nullable(),\n failureCode: z.string().nullable(),\n kubernetesJobName: z.string().nullable(),\n});\nexport interface LearningRun {\n id: string;\n learningContainerId: string;\n projectId: number;\n status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n triggerSource: \"automatic\" | \"manual\";\n attemptCount: number;\n candidateCount: number | null;\n insightCount: number | null;\n evidenceThreadCount?: number | null;\n createdAt: string;\n updatedAt: string;\n startedAt: string | null;\n completedAt: string | null;\n failureCode: string | null;\n kubernetesJobName: string | null;\n}\nconst unavailableSchema = z\n .enum([\"snapshot-missing\", \"snapshot-unreadable\"])\n .nullable();\nexport const learningInsightEvidenceSchema = z.union([\n z.object({\n cited: z.array(\n z.object({\n id: z.string(),\n content: z.string(),\n role: z.enum([\"assistant\", \"tool\", \"user\"]),\n }),\n ),\n messageCount: z.number().int().nonnegative(),\n threadId: z.string(),\n threadName: z.string().nullable(),\n threadPresent: z.boolean(),\n unavailable: unavailableSchema,\n }),\n z.object({\n kind: z.literal(\"trajectory\"),\n trajectoryId: z.guid(),\n trajectoryPresent: z.boolean(),\n eventCount: z.number().int().nonnegative(),\n events: z.array(\n z.object({\n seq: z.number().int().nonnegative(),\n name: z.string(),\n offsetMs: z.number(),\n value: z.unknown(),\n eventId: z.string().nullable(),\n }),\n ),\n unavailable: unavailableSchema,\n }),\n]);\nexport type LearningInsightEvidence =\n | {\n cited: Array<{\n id: string;\n content: string;\n role: \"assistant\" | \"tool\" | \"user\";\n }>;\n messageCount: number;\n threadId: string;\n threadName: string | null;\n threadPresent: boolean;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n }\n | {\n kind: \"trajectory\";\n trajectoryId: string;\n trajectoryPresent: boolean;\n eventCount: number;\n events: Array<{\n seq: number;\n name: string;\n offsetMs: number;\n value?: unknown;\n eventId: string | null;\n }>;\n unavailable: \"snapshot-missing\" | \"snapshot-unreadable\" | null;\n };\n\n/** Validates object IDs independently from container IDs; neither may alter the path. */\nexport function learningObjectId(id: string): string {\n return z.guid().parse(id);\n}\n"],"mappings":"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"}
@@ -1,126 +1,120 @@
1
- const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
2
1
  const require_errors = require('./errors.cjs');
3
- let yauzl = require("yauzl");
2
+ let fflate = require("fflate");
4
3
 
5
4
  //#region src/runtime/intelligence-platform/skill-registry/archive.ts
6
5
  /** Internal corruption bounds, including manifest and directory entries. */
7
6
  const MAX_ARCHIVE_ENTRIES = 1e3;
8
7
  const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;
8
+ const LOCAL_HEADER_SIGNATURE = 67324752;
9
+ const CENTRAL_HEADER_SIGNATURE = 33639248;
10
+ const END_OF_CENTRAL_DIRECTORY_SIGNATURE = 101010256;
11
+ const LOCAL_HEADER_SIZE = 30;
12
+ const CENTRAL_HEADER_SIZE = 46;
13
+ const END_OF_CENTRAL_DIRECTORY_SIZE = 22;
14
+ const INFLATE_CHUNK_BYTES = 16 * 1024;
9
15
  function safeRelativePath(path) {
10
16
  return path.length > 0 && !/[\\\x00-\x1f\x7f]/.test(path) && !/^[a-z]:/i.test(path) && path.split("/").every((part) => part !== "" && part !== "." && part !== "..");
11
17
  }
12
- /** Decode only the listed ZIP namespace. No filesystem is involved. */
13
- function readArchive(bytes, signal) {
14
- return new Promise((resolve, reject) => {
15
- let archive;
16
- let stream;
17
- let settled = false;
18
- const finish = (error) => {
19
- if (settled) return;
20
- settled = true;
21
- signal?.removeEventListener("abort", abort);
22
- stream?.destroy();
23
- archive?.close();
24
- if (error !== void 0) reject(error);
25
- else resolve(files);
26
- };
27
- const abort = () => finish(signal?.reason ?? require_errors.invalidSnapshot());
18
+ function equalBytes(left, right) {
19
+ return left.length === right.length && left.every((byte, index) => byte === right[index]);
20
+ }
21
+ /** Inflate raw DEFLATE data, failing as soon as it decodes past `size` bytes. */
22
+ function inflate(data, size) {
23
+ const out = new Uint8Array(size);
24
+ let written = 0;
25
+ const inflater = new fflate.Inflate((chunk) => {
26
+ if (written + chunk.length > size) throw require_errors.invalidSnapshot();
27
+ out.set(chunk, written);
28
+ written += chunk.length;
29
+ });
30
+ let offset = 0;
31
+ do {
32
+ const end = Math.min(offset + INFLATE_CHUNK_BYTES, data.length);
33
+ inflater.push(data.subarray(offset, end), end === data.length);
34
+ offset = end;
35
+ } while (offset < data.length);
36
+ if (written !== size) throw require_errors.invalidSnapshot();
37
+ return out;
38
+ }
39
+ /** Find the end-of-central-directory record; its comment must end the file. */
40
+ function findEndOfCentralDirectory(bytes, view) {
41
+ const last = bytes.length - END_OF_CENTRAL_DIRECTORY_SIZE;
42
+ for (let offset = last; offset >= Math.max(0, last - 65535); offset--) {
43
+ if (view.getUint32(offset, true) !== END_OF_CENTRAL_DIRECTORY_SIGNATURE) continue;
44
+ if (view.getUint16(offset + 20, true) !== last - offset) throw require_errors.invalidSnapshot();
45
+ return offset;
46
+ }
47
+ throw require_errors.invalidSnapshot();
48
+ }
49
+ /**
50
+ * Decode only the listed ZIP namespace. No filesystem is involved.
51
+ *
52
+ * Parses the central directory directly and inflates with fflate, so it runs
53
+ * on Node and on edge runtimes alike. ZIP64, multi-disk, and encrypted
54
+ * archives are rejected: snapshots stay far below the ZIP64 limits.
55
+ */
56
+ async function readArchive(bytes, signal) {
57
+ const throwIfAborted = () => {
58
+ if (signal?.aborted) throw signal.reason ?? require_errors.invalidSnapshot();
59
+ };
60
+ throwIfAborted();
61
+ try {
62
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.length);
63
+ const end = findEndOfCentralDirectory(bytes, view);
64
+ if (view.getUint16(end + 4, true) !== 0) throw require_errors.invalidSnapshot();
65
+ const entryCount = view.getUint16(end + 10, true);
66
+ if (entryCount > MAX_ARCHIVE_ENTRIES) throw require_errors.invalidSnapshot();
28
67
  const files = /* @__PURE__ */ new Map();
29
68
  const names = /* @__PURE__ */ new Set();
30
69
  let decodedBytes = 0;
31
- signal?.addEventListener("abort", abort, { once: true });
32
- if (signal?.aborted) {
33
- abort();
34
- return;
70
+ let header = view.getUint32(end + 16, true);
71
+ for (let index = 0; index < entryCount; index++) {
72
+ throwIfAborted();
73
+ if (header + CENTRAL_HEADER_SIZE > bytes.length || view.getUint32(header, true) !== CENTRAL_HEADER_SIGNATURE) throw require_errors.invalidSnapshot();
74
+ const generalPurposeBitFlag = view.getUint16(header + 8, true);
75
+ const compressionMethod = view.getUint16(header + 10, true);
76
+ const compressedSize = view.getUint32(header + 20, true);
77
+ const uncompressedSize = view.getUint32(header + 24, true);
78
+ const nameLength = view.getUint16(header + 28, true);
79
+ const extraLength = view.getUint16(header + 30, true);
80
+ const commentLength = view.getUint16(header + 32, true);
81
+ const externalFileAttributes = view.getUint32(header + 38, true);
82
+ const local = view.getUint32(header + 42, true);
83
+ const nameStart = header + CENTRAL_HEADER_SIZE;
84
+ header = nameStart + nameLength + extraLength + commentLength;
85
+ if (header > bytes.length) throw require_errors.invalidSnapshot();
86
+ const rawName = bytes.subarray(nameStart, nameStart + nameLength);
87
+ const name = new TextDecoder("utf-8", {
88
+ fatal: true,
89
+ ignoreBOM: true
90
+ }).decode(rawName);
91
+ const directory = name.endsWith("/");
92
+ if (!safeRelativePath(directory ? name.slice(0, -1) : name) || names.has(name)) throw require_errors.invalidSnapshot();
93
+ names.add(name);
94
+ const fileType = externalFileAttributes >>> 16 & 61440;
95
+ if (fileType !== 0 && fileType !== (directory ? 16384 : 32768)) throw require_errors.invalidSnapshot();
96
+ if (generalPurposeBitFlag & 65 || ![0, 8].includes(compressionMethod)) throw require_errors.invalidSnapshot();
97
+ if (compressionMethod === 0 && compressedSize !== uncompressedSize) throw require_errors.invalidSnapshot();
98
+ decodedBytes += uncompressedSize;
99
+ if (decodedBytes > MAX_SNAPSHOT_BYTES || directory && uncompressedSize !== 0) throw require_errors.invalidSnapshot();
100
+ if (local + LOCAL_HEADER_SIZE > bytes.length || view.getUint32(local, true) !== LOCAL_HEADER_SIGNATURE) throw require_errors.invalidSnapshot();
101
+ if (view.getUint16(local + 6, true) !== generalPurposeBitFlag || view.getUint16(local + 8, true) !== compressionMethod) throw require_errors.invalidSnapshot();
102
+ const localNameLength = view.getUint16(local + 26, true);
103
+ const localExtraLength = view.getUint16(local + 28, true);
104
+ const localNameStart = local + LOCAL_HEADER_SIZE;
105
+ const dataStart = localNameStart + localNameLength + localExtraLength;
106
+ if (dataStart + compressedSize > bytes.length || !equalBytes(bytes.subarray(localNameStart, localNameStart + localNameLength), rawName)) throw require_errors.invalidSnapshot();
107
+ if (!(generalPurposeBitFlag & 8) && (view.getUint32(local + 18, true) !== compressedSize || view.getUint32(local + 22, true) !== uncompressedSize)) throw require_errors.invalidSnapshot();
108
+ if (directory) continue;
109
+ const data = bytes.subarray(dataStart, dataStart + compressedSize);
110
+ files.set(name, compressionMethod === 0 ? data.slice() : inflate(data, uncompressedSize));
35
111
  }
36
- (0, yauzl.fromBuffer)(bytes, {
37
- lazyEntries: true,
38
- decodeStrings: false,
39
- validateEntrySizes: true,
40
- autoClose: false
41
- }, (error, zip) => {
42
- if (error) {
43
- finish(require_errors.invalidSnapshot(error));
44
- return;
45
- }
46
- archive = zip;
47
- if (settled) {
48
- zip.close();
49
- return;
50
- }
51
- zip.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
52
- zip.on("end", () => finish());
53
- if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
54
- finish(require_errors.invalidSnapshot());
55
- return;
56
- }
57
- zip.on("entry", (entry) => {
58
- try {
59
- const rawName = entry.fileName;
60
- if (!Buffer.isBuffer(rawName)) throw require_errors.invalidSnapshot();
61
- const name = new TextDecoder("utf-8", {
62
- fatal: true,
63
- ignoreBOM: true
64
- }).decode(rawName);
65
- const directory = name.endsWith("/");
66
- if (!safeRelativePath(directory ? name.slice(0, -1) : name) || names.has(name)) throw require_errors.invalidSnapshot();
67
- names.add(name);
68
- const fileType = entry.externalFileAttributes >>> 16 & 61440;
69
- if (fileType !== 0 && fileType !== (directory ? 16384 : 32768)) throw require_errors.invalidSnapshot();
70
- if (entry.isEncrypted() || ![0, 8].includes(entry.compressionMethod)) throw require_errors.invalidSnapshot();
71
- if (!Number.isSafeInteger(entry.uncompressedSize) || entry.uncompressedSize < 0) throw require_errors.invalidSnapshot();
72
- decodedBytes += entry.uncompressedSize;
73
- if (decodedBytes > MAX_SNAPSHOT_BYTES || directory && entry.uncompressedSize !== 0) throw require_errors.invalidSnapshot();
74
- const local = entry.relativeOffsetOfLocalHeader;
75
- if (local < 0 || local + 30 > bytes.length || bytes.readUInt32LE(local) !== 67324752) throw require_errors.invalidSnapshot();
76
- if (bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag || bytes.readUInt16LE(local + 8) !== entry.compressionMethod) throw require_errors.invalidSnapshot();
77
- const localNameLength = bytes.readUInt16LE(local + 26);
78
- const localExtraLength = bytes.readUInt16LE(local + 28);
79
- if (local + 30 + localNameLength + localExtraLength + entry.compressedSize > bytes.length || !bytes.subarray(local + 30, local + 30 + localNameLength).equals(rawName)) throw require_errors.invalidSnapshot();
80
- if (!(entry.generalPurposeBitFlag & 8) && (bytes.readUInt32LE(local + 18) !== entry.compressedSize || bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)) throw require_errors.invalidSnapshot();
81
- if (directory) {
82
- zip.readEntry();
83
- return;
84
- }
85
- zip.openReadStream(entry, (readError, readStream) => {
86
- if (readError) {
87
- finish(require_errors.invalidSnapshot(readError));
88
- return;
89
- }
90
- stream = readStream;
91
- if (settled) {
92
- readStream.destroy();
93
- return;
94
- }
95
- const chunks = [];
96
- let size = 0;
97
- readStream.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
98
- readStream.on("data", (chunk) => {
99
- size += chunk.length;
100
- if (size > entry.uncompressedSize || size > MAX_SNAPSHOT_BYTES) {
101
- finish(require_errors.invalidSnapshot());
102
- return;
103
- }
104
- chunks.push(chunk);
105
- });
106
- readStream.on("end", () => {
107
- if (settled) return;
108
- if (size !== entry.uncompressedSize) {
109
- finish(require_errors.invalidSnapshot());
110
- return;
111
- }
112
- files.set(name, Buffer.concat(chunks, size));
113
- stream = void 0;
114
- zip.readEntry();
115
- });
116
- });
117
- } catch (cause) {
118
- finish(require_errors.invalidSnapshot(cause));
119
- }
120
- });
121
- zip.readEntry();
122
- });
123
- });
112
+ throwIfAborted();
113
+ return files;
114
+ } catch (cause) {
115
+ throwIfAborted();
116
+ throw require_errors.invalidSnapshot(cause);
117
+ }
124
118
  }
125
119
 
126
120
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"archive.cjs","names":["invalidSnapshot"],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"sourcesContent":["import { fromBuffer } from \"yauzl\";\nimport type { Entry, ZipFile } from \"yauzl\";\nimport type { Readable } from \"node:stream\";\nimport { invalidSnapshot } from \"./errors\";\n\n/** Internal corruption bounds, including manifest and directory entries. */\nexport const MAX_ARCHIVE_ENTRIES = 1_000;\nexport const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;\n\nexport function safeRelativePath(path: string): boolean {\n return (\n path.length > 0 &&\n // Reject control bytes in archive paths, including NUL and DEL.\n // eslint-disable-next-line no-control-regex\n !/[\\\\\\x00-\\x1f\\x7f]/.test(path) &&\n !/^[a-z]:/i.test(path) &&\n path\n .split(\"/\")\n .every((part) => part !== \"\" && part !== \".\" && part !== \"..\")\n );\n}\n\n/** Decode only the listed ZIP namespace. No filesystem is involved. */\nexport function readArchive(\n bytes: Buffer,\n signal?: AbortSignal,\n): Promise<Map<string, Buffer>> {\n return new Promise((resolve, reject) => {\n let archive: ZipFile | undefined;\n let stream: Readable | undefined;\n let settled = false;\n const finish = (error?: unknown) => {\n if (settled) return;\n settled = true;\n signal?.removeEventListener(\"abort\", abort);\n stream?.destroy();\n archive?.close();\n if (error !== undefined) reject(error);\n else resolve(files);\n };\n const abort = () => finish(signal?.reason ?? invalidSnapshot());\n const files = new Map<string, Buffer>();\n const names = new Set<string>();\n let decodedBytes = 0;\n signal?.addEventListener(\"abort\", abort, { once: true });\n if (signal?.aborted) {\n abort();\n return;\n }\n fromBuffer(\n bytes,\n {\n lazyEntries: true,\n decodeStrings: false,\n validateEntrySizes: true,\n autoClose: false,\n },\n (error, zip) => {\n if (error) {\n finish(invalidSnapshot(error));\n return;\n }\n archive = zip;\n if (settled) {\n zip.close();\n return;\n }\n zip.on(\"error\", (cause: unknown) => finish(invalidSnapshot(cause)));\n zip.on(\"end\", () => finish());\n if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {\n finish(invalidSnapshot());\n return;\n }\n zip.on(\"entry\", (entry: Entry) => {\n try {\n // decodeStrings:false preserves raw UTF-8 names instead of normalizing\n // backslashes or consulting alternate Unicode-path extra fields.\n const rawName: unknown = entry.fileName;\n if (!Buffer.isBuffer(rawName)) throw invalidSnapshot();\n const name = new TextDecoder(\"utf-8\", {\n fatal: true,\n ignoreBOM: true,\n }).decode(rawName);\n const directory = name.endsWith(\"/\");\n if (\n !safeRelativePath(directory ? name.slice(0, -1) : name) ||\n names.has(name)\n )\n throw invalidSnapshot();\n names.add(name);\n const fileType = (entry.externalFileAttributes >>> 16) & 0o170000;\n if (\n fileType !== 0 &&\n fileType !== (directory ? 0o040000 : 0o100000)\n )\n throw invalidSnapshot();\n if (\n entry.isEncrypted() ||\n ![0, 8].includes(entry.compressionMethod)\n )\n throw invalidSnapshot();\n if (\n !Number.isSafeInteger(entry.uncompressedSize) ||\n entry.uncompressedSize < 0\n )\n throw invalidSnapshot();\n decodedBytes += entry.uncompressedSize;\n if (\n decodedBytes > MAX_SNAPSHOT_BYTES ||\n (directory && entry.uncompressedSize !== 0)\n )\n throw invalidSnapshot();\n // Require the central directory and the local entry to name the same\n // bytes. ZIP data descriptors may leave local sizes unset.\n const local = entry.relativeOffsetOfLocalHeader;\n if (\n local < 0 ||\n local + 30 > bytes.length ||\n bytes.readUInt32LE(local) !== 0x04034b50\n )\n throw invalidSnapshot();\n if (\n bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag ||\n bytes.readUInt16LE(local + 8) !== entry.compressionMethod\n )\n throw invalidSnapshot();\n const localNameLength = bytes.readUInt16LE(local + 26);\n const localExtraLength = bytes.readUInt16LE(local + 28);\n const dataStart = local + 30 + localNameLength + localExtraLength;\n if (\n dataStart + entry.compressedSize > bytes.length ||\n !bytes\n .subarray(local + 30, local + 30 + localNameLength)\n .equals(rawName)\n )\n throw invalidSnapshot();\n if (\n !(entry.generalPurposeBitFlag & 8) &&\n (bytes.readUInt32LE(local + 18) !== entry.compressedSize ||\n bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)\n )\n throw invalidSnapshot();\n if (directory) {\n zip.readEntry();\n return;\n }\n zip.openReadStream(entry, (readError, readStream) => {\n if (readError) {\n finish(invalidSnapshot(readError));\n return;\n }\n stream = readStream;\n if (settled) {\n readStream.destroy();\n return;\n }\n const chunks: Buffer[] = [];\n let size = 0;\n readStream.on(\"error\", (cause: unknown) =>\n finish(invalidSnapshot(cause)),\n );\n readStream.on(\"data\", (chunk: Buffer) => {\n size += chunk.length;\n if (\n size > entry.uncompressedSize ||\n size > MAX_SNAPSHOT_BYTES\n ) {\n finish(invalidSnapshot());\n return;\n }\n chunks.push(chunk);\n });\n readStream.on(\"end\", () => {\n if (settled) return;\n if (size !== entry.uncompressedSize) {\n finish(invalidSnapshot());\n return;\n }\n files.set(name, Buffer.concat(chunks, size));\n stream = undefined;\n zip.readEntry();\n });\n });\n } catch (cause) {\n finish(invalidSnapshot(cause));\n }\n });\n zip.readEntry();\n },\n );\n });\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"archive.cjs","names":["Inflate","invalidSnapshot"],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"sourcesContent":["import { Inflate } from \"fflate\";\nimport { invalidSnapshot } from \"./errors\";\n\n/** Internal corruption bounds, including manifest and directory entries. */\nexport const MAX_ARCHIVE_ENTRIES = 1_000;\nexport const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;\n\nconst LOCAL_HEADER_SIGNATURE = 0x04034b50;\nconst CENTRAL_HEADER_SIGNATURE = 0x02014b50;\nconst END_OF_CENTRAL_DIRECTORY_SIGNATURE = 0x06054b50;\nconst LOCAL_HEADER_SIZE = 30;\nconst CENTRAL_HEADER_SIZE = 46;\nconst END_OF_CENTRAL_DIRECTORY_SIZE = 22;\n// DEFLATE expands at most ~1032:1, so one pushed chunk decodes to ~16 MiB at\n// most before the size check below can stop a bomb.\nconst INFLATE_CHUNK_BYTES = 16 * 1024;\n\nexport function safeRelativePath(path: string): boolean {\n return (\n path.length > 0 &&\n // Reject control bytes in archive paths, including NUL and DEL.\n // eslint-disable-next-line no-control-regex\n !/[\\\\\\x00-\\x1f\\x7f]/.test(path) &&\n !/^[a-z]:/i.test(path) &&\n path\n .split(\"/\")\n .every((part) => part !== \"\" && part !== \".\" && part !== \"..\")\n );\n}\n\nfunction equalBytes(left: Uint8Array, right: Uint8Array): boolean {\n return (\n left.length === right.length &&\n left.every((byte, index) => byte === right[index])\n );\n}\n\n/** Inflate raw DEFLATE data, failing as soon as it decodes past `size` bytes. */\nfunction inflate(data: Uint8Array, size: number): Uint8Array {\n const out = new Uint8Array(size);\n let written = 0;\n const inflater = new Inflate((chunk) => {\n if (written + chunk.length > size) throw invalidSnapshot();\n out.set(chunk, written);\n written += chunk.length;\n });\n let offset = 0;\n do {\n const end = Math.min(offset + INFLATE_CHUNK_BYTES, data.length);\n inflater.push(data.subarray(offset, end), end === data.length);\n offset = end;\n } while (offset < data.length);\n if (written !== size) throw invalidSnapshot();\n return out;\n}\n\n/** Find the end-of-central-directory record; its comment must end the file. */\nfunction findEndOfCentralDirectory(bytes: Uint8Array, view: DataView): number {\n const last = bytes.length - END_OF_CENTRAL_DIRECTORY_SIZE;\n for (let offset = last; offset >= Math.max(0, last - 0xffff); offset--) {\n if (view.getUint32(offset, true) !== END_OF_CENTRAL_DIRECTORY_SIGNATURE)\n continue;\n if (view.getUint16(offset + 20, true) !== last - offset)\n throw invalidSnapshot();\n return offset;\n }\n throw invalidSnapshot();\n}\n\n/**\n * Decode only the listed ZIP namespace. No filesystem is involved.\n *\n * Parses the central directory directly and inflates with fflate, so it runs\n * on Node and on edge runtimes alike. ZIP64, multi-disk, and encrypted\n * archives are rejected: snapshots stay far below the ZIP64 limits.\n */\nexport async function readArchive(\n bytes: Uint8Array,\n signal?: AbortSignal,\n): Promise<Map<string, Uint8Array>> {\n const throwIfAborted = () => {\n if (signal?.aborted) throw signal.reason ?? invalidSnapshot();\n };\n throwIfAborted();\n try {\n const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.length);\n const end = findEndOfCentralDirectory(bytes, view);\n if (view.getUint16(end + 4, true) !== 0) throw invalidSnapshot();\n const entryCount = view.getUint16(end + 10, true);\n if (entryCount > MAX_ARCHIVE_ENTRIES) throw invalidSnapshot();\n\n const files = new Map<string, Uint8Array>();\n const names = new Set<string>();\n let decodedBytes = 0;\n let header = view.getUint32(end + 16, true);\n for (let index = 0; index < entryCount; index++) {\n throwIfAborted();\n if (\n header + CENTRAL_HEADER_SIZE > bytes.length ||\n view.getUint32(header, true) !== CENTRAL_HEADER_SIGNATURE\n )\n throw invalidSnapshot();\n const generalPurposeBitFlag = view.getUint16(header + 8, true);\n const compressionMethod = view.getUint16(header + 10, true);\n const compressedSize = view.getUint32(header + 20, true);\n const uncompressedSize = view.getUint32(header + 24, true);\n const nameLength = view.getUint16(header + 28, true);\n const extraLength = view.getUint16(header + 30, true);\n const commentLength = view.getUint16(header + 32, true);\n const externalFileAttributes = view.getUint32(header + 38, true);\n const local = view.getUint32(header + 42, true);\n const nameStart = header + CENTRAL_HEADER_SIZE;\n header = nameStart + nameLength + extraLength + commentLength;\n if (header > bytes.length) throw invalidSnapshot();\n\n // Decode the raw UTF-8 name ourselves instead of normalizing backslashes\n // or consulting alternate Unicode-path extra fields.\n const rawName = bytes.subarray(nameStart, nameStart + nameLength);\n const name = new TextDecoder(\"utf-8\", {\n fatal: true,\n ignoreBOM: true,\n }).decode(rawName);\n const directory = name.endsWith(\"/\");\n if (\n !safeRelativePath(directory ? name.slice(0, -1) : name) ||\n names.has(name)\n )\n throw invalidSnapshot();\n names.add(name);\n const fileType = (externalFileAttributes >>> 16) & 0o170000;\n if (fileType !== 0 && fileType !== (directory ? 0o040000 : 0o100000))\n throw invalidSnapshot();\n // Bit 0 is traditional encryption, bit 6 strong encryption.\n if (generalPurposeBitFlag & 0x41 || ![0, 8].includes(compressionMethod))\n throw invalidSnapshot();\n if (compressionMethod === 0 && compressedSize !== uncompressedSize)\n throw invalidSnapshot();\n decodedBytes += uncompressedSize;\n if (\n decodedBytes > MAX_SNAPSHOT_BYTES ||\n (directory && uncompressedSize !== 0)\n )\n throw invalidSnapshot();\n // Require the central directory and the local entry to name the same\n // bytes. ZIP data descriptors may leave local sizes unset.\n if (\n local + LOCAL_HEADER_SIZE > bytes.length ||\n view.getUint32(local, true) !== LOCAL_HEADER_SIGNATURE\n )\n throw invalidSnapshot();\n if (\n view.getUint16(local + 6, true) !== generalPurposeBitFlag ||\n view.getUint16(local + 8, true) !== compressionMethod\n )\n throw invalidSnapshot();\n const localNameLength = view.getUint16(local + 26, true);\n const localExtraLength = view.getUint16(local + 28, true);\n const localNameStart = local + LOCAL_HEADER_SIZE;\n const dataStart = localNameStart + localNameLength + localExtraLength;\n if (\n dataStart + compressedSize > bytes.length ||\n !equalBytes(\n bytes.subarray(localNameStart, localNameStart + localNameLength),\n rawName,\n )\n )\n throw invalidSnapshot();\n if (\n !(generalPurposeBitFlag & 8) &&\n (view.getUint32(local + 18, true) !== compressedSize ||\n view.getUint32(local + 22, true) !== uncompressedSize)\n )\n throw invalidSnapshot();\n if (directory) continue;\n\n const data = bytes.subarray(dataStart, dataStart + compressedSize);\n files.set(\n name,\n compressionMethod === 0\n ? data.slice()\n : inflate(data, uncompressedSize),\n );\n }\n throwIfAborted();\n return files;\n } catch (cause) {\n throwIfAborted();\n throw invalidSnapshot(cause);\n }\n}\n"],"mappings":"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"}
@@ -3,8 +3,14 @@
3
3
  declare const MAX_ARCHIVE_ENTRIES = 1000;
4
4
  declare const MAX_SNAPSHOT_BYTES: number;
5
5
  declare function safeRelativePath(path: string): boolean;
6
- /** Decode only the listed ZIP namespace. No filesystem is involved. */
7
- declare function readArchive(bytes: Buffer, signal?: AbortSignal): Promise<Map<string, Buffer>>;
6
+ /**
7
+ * Decode only the listed ZIP namespace. No filesystem is involved.
8
+ *
9
+ * Parses the central directory directly and inflates with fflate, so it runs
10
+ * on Node and on edge runtimes alike. ZIP64, multi-disk, and encrypted
11
+ * archives are rejected: snapshots stay far below the ZIP64 limits.
12
+ */
13
+ declare function readArchive(bytes: Uint8Array, signal?: AbortSignal): Promise<Map<string, Uint8Array>>;
8
14
  //#endregion
9
15
  export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath };
10
16
  //# sourceMappingURL=archive.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"archive.d.cts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;cAMa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAEG,gBAAA,CAAiB,IAAA;;iBAcjB,WAAA,CACd,KAAA,EAAO,MAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,MAAA"}
1
+ {"version":3,"file":"archive.d.cts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;cAIa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAYG,gBAAA,CAAiB,IAAA;;;AAZjC;;;;;iBAuEsB,WAAA,CACpB,KAAA,EAAO,UAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,UAAA"}
@@ -3,8 +3,14 @@
3
3
  declare const MAX_ARCHIVE_ENTRIES = 1000;
4
4
  declare const MAX_SNAPSHOT_BYTES: number;
5
5
  declare function safeRelativePath(path: string): boolean;
6
- /** Decode only the listed ZIP namespace. No filesystem is involved. */
7
- declare function readArchive(bytes: Buffer, signal?: AbortSignal): Promise<Map<string, Buffer>>;
6
+ /**
7
+ * Decode only the listed ZIP namespace. No filesystem is involved.
8
+ *
9
+ * Parses the central directory directly and inflates with fflate, so it runs
10
+ * on Node and on edge runtimes alike. ZIP64, multi-disk, and encrypted
11
+ * archives are rejected: snapshots stay far below the ZIP64 limits.
12
+ */
13
+ declare function readArchive(bytes: Uint8Array, signal?: AbortSignal): Promise<Map<string, Uint8Array>>;
8
14
  //#endregion
9
15
  export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath };
10
16
  //# sourceMappingURL=archive.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"archive.d.mts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;cAMa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAEG,gBAAA,CAAiB,IAAA;;iBAcjB,WAAA,CACd,KAAA,EAAO,MAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,MAAA"}
1
+ {"version":3,"file":"archive.d.mts","names":[],"sources":["../../../../src/runtime/intelligence-platform/skill-registry/archive.ts"],"mappings":";;cAIa,mBAAA;AAAA,cACA,kBAAA;AAAA,iBAYG,gBAAA,CAAiB,IAAA;;;AAZjC;;;;;iBAuEsB,WAAA,CACpB,KAAA,EAAO,UAAA,EACP,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,GAAA,SAAY,UAAA"}