@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.0

package/dist/runtime/intelligence-platform/learned-skills.mjs

@@ -0,0 +1,92 @@
+//#region src/runtime/intelligence-platform/learned-skills.ts
+const messages = {
+	INVALID_CONFIG: "Invalid learned-skills request configuration.",
+	AUTHENTICATION_FAILED: "Learned-skills authentication failed.",
+	AUTHORIZATION_FAILED: "Learned-skills access was denied.",
+	ENTITLEMENT_REQUIRED: "Learned-skills delivery requires an entitlement.",
+	DELIVERY_DISABLED: "Learned-skills delivery is disabled.",
+	CONTAINER_NOT_FOUND: "The learning container was not found.",
+	REVISION_NOT_FOUND: "The learned-skills revision was not found.",
+	REVISION_REVOKED: "The learned-skills revision was revoked.",
+	NETWORK_ERROR: "The learned-skills request failed during transport.",
+	TIMEOUT: "The learned-skills request timed out.",
+	INVALID_SNAPSHOT: "The learned-skills response metadata is invalid.",
+	UNSUPPORTED_SERVER: "The server returned an unsupported learned-skills response."
+};
+/** Safe message and stable code; server response bodies are never retained. */
+var LearnedSkillsError = class extends Error {
+	constructor(code, retryable, cause) {
+		super(messages[code]);
+		this.code = code;
+		this.retryable = retryable;
+		this.name = "LearnedSkillsError";
+		Object.defineProperty(this, "cause", {
+			value: cause,
+			configurable: true
+		});
+	}
+};
+/** @internal */
+function learnedSkillsResponseError(body) {
+	if (typeof body === "object" && body !== null && "error" in body) {
+		const error = body.error;
+		if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && Object.prototype.hasOwnProperty.call(messages, error.code) && "message" in error && typeof error.message === "string" && "category" in error && typeof error.category === "string" && "retryable" in error && typeof error.retryable === "boolean") return new LearnedSkillsError(error.code, error.retryable);
+	}
+	return new LearnedSkillsError("UNSUPPORTED_SERVER", false);
+}
+/** Validate the entire envelope before exposing any individual result. */
+function parseLearnedSkillsBatch(body, requests) {
+	const invalid = () => {
+		if (body && typeof body === "object" && "containers" in body && Array.isArray(body.containers)) {
+			const denial = body.containers.find((entry) => entry && requests.some((request) => request.containerId === entry.containerId) && entry.status === "error" && [
+				"AUTHENTICATION_FAILED",
+				"AUTHORIZATION_FAILED",
+				"ENTITLEMENT_REQUIRED",
+				"DELIVERY_DISABLED",
+				"CONTAINER_NOT_FOUND",
+				"REVISION_NOT_FOUND",
+				"REVISION_REVOKED"
+			].includes(entry.error?.code));
+			if (denial) return new LearnedSkillsError(denial.error.code, false);
+		}
+		return new LearnedSkillsError("INVALID_SNAPSHOT", false);
+	};
+	if (!body || typeof body !== "object" || !("containers" in body) || !Array.isArray(body.containers) || body.containers.length !== requests.length) throw invalid();
+	return body.containers.map((entry, index) => {
+		const request = requests[index];
+		if (!entry || typeof entry !== "object" || entry.containerId !== request.containerId) throw invalid();
+		if (entry.status === "error") {
+			if (!entry.error || typeof entry.error !== "object" || !Object.prototype.hasOwnProperty.call(messages, entry.error.code) || typeof entry.error.retryable !== "boolean") throw invalid();
+			return {
+				containerId: entry.containerId,
+				status: "error",
+				error: new LearnedSkillsError(entry.error.code, entry.error.retryable)
+			};
+		}
+		if (typeof entry.revision !== "string" || !entry.revision.trim() || typeof entry.etag !== "string" || !/^"[a-f0-9]{64}"$/.test(entry.etag) || request.revision !== void 0 && entry.revision !== request.revision) throw invalid();
+		if (entry.status === "unchanged") {
+			if (request.ifNoneMatch !== entry.etag || "bytesBase64" in entry || "contentType" in entry) throw invalid();
+			return {
+				containerId: entry.containerId,
+				status: "unchanged",
+				revision: entry.revision,
+				etag: entry.etag
+			};
+		}
+		if (entry.status !== "snapshot" || entry.contentType !== "application/zip" || typeof entry.bytesBase64 !== "string" || !entry.bytesBase64.length || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(entry.bytesBase64)) throw invalid();
+		const bytes = Buffer.from(entry.bytesBase64, "base64");
+		if (bytes.toString("base64") !== entry.bytesBase64) throw invalid();
+		return {
+			containerId: entry.containerId,
+			status: "snapshot",
+			revision: entry.revision,
+			etag: entry.etag,
+			contentType: entry.contentType,
+			bytes: new Uint8Array(bytes)
+		};
+	});
+}
+
+//#endregion
+export { LearnedSkillsError, learnedSkillsResponseError, parseLearnedSkillsBatch };
+//# sourceMappingURL=learned-skills.mjs.map

package/dist/runtime/intelligence-platform/learned-skills.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"learned-skills.mjs","names":[],"sources":["../../../src/runtime/intelligence-platform/learned-skills.ts"],"sourcesContent":["/** Stable failure codes shared by learned-skill delivery and its consumers. */\nexport type LearnedSkillsErrorCode =\n  | \"INVALID_CONFIG\"\n  | \"AUTHENTICATION_FAILED\"\n  | \"AUTHORIZATION_FAILED\"\n  | \"ENTITLEMENT_REQUIRED\"\n  | \"DELIVERY_DISABLED\"\n  | \"CONTAINER_NOT_FOUND\"\n  | \"REVISION_NOT_FOUND\"\n  | \"REVISION_REVOKED\"\n  | \"NETWORK_ERROR\"\n  | \"TIMEOUT\"\n  | \"INVALID_SNAPSHOT\"\n  | \"UNSUPPORTED_SERVER\";\n\nconst messages: Record<LearnedSkillsErrorCode, string> = {\n  INVALID_CONFIG: \"Invalid learned-skills request configuration.\",\n  AUTHENTICATION_FAILED: \"Learned-skills authentication failed.\",\n  AUTHORIZATION_FAILED: \"Learned-skills access was denied.\",\n  ENTITLEMENT_REQUIRED: \"Learned-skills delivery requires an entitlement.\",\n  DELIVERY_DISABLED: \"Learned-skills delivery is disabled.\",\n  CONTAINER_NOT_FOUND: \"The learning container was not found.\",\n  REVISION_NOT_FOUND: \"The learned-skills revision was not found.\",\n  REVISION_REVOKED: \"The learned-skills revision was revoked.\",\n  NETWORK_ERROR: \"The learned-skills request failed during transport.\",\n  TIMEOUT: \"The learned-skills request timed out.\",\n  INVALID_SNAPSHOT: \"The learned-skills response metadata is invalid.\",\n  UNSUPPORTED_SERVER:\n    \"The server returned an unsupported learned-skills response.\",\n};\n\n/** Safe message and stable code; server response bodies are never retained. */\nexport class LearnedSkillsError extends Error {\n  readonly cause?: unknown;\n\n  constructor(\n    public readonly code: LearnedSkillsErrorCode,\n    public readonly retryable: boolean,\n    cause?: unknown,\n  ) {\n    super(messages[code]);\n    this.name = \"LearnedSkillsError\";\n    // Preserve the original exception for explicit diagnostics without including\n    // it in ordinary JSON serialization of this safe error envelope.\n    Object.defineProperty(this, \"cause\", { value: cause, configurable: true });\n  }\n}\n\nexport interface GetLearnedSkillsSnapshotRequest {\n  containerId: string;\n  /** Opaque exact revision. Omit to request the latest authorized revision. */\n  revision?: string;\n  /** ETag from a previous snapshot. The client owns no cache. */\n  ifNoneMatch?: string;\n  /** Caller-owned cancellation or deadline, including AbortSignal.timeout(). */\n  signal?: AbortSignal;\n}\n\nexport type LearnedSkillsSnapshotResult =\n  | {\n      status: \"snapshot\";\n      /** Raw ZIP bytes. The client does not parse or extract the archive. */\n      bytes: Uint8Array;\n      revision: string;\n      etag: string;\n      contentType: string;\n    }\n  | { status: \"unchanged\"; revision: string; etag: string };\n\n/** @internal */\nexport function learnedSkillsResponseError(body: unknown): LearnedSkillsError {\n  if (typeof body === \"object\" && body !== null && \"error\" in body) {\n    const error = body.error;\n    if (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      typeof error.code === \"string\" &&\n      Object.prototype.hasOwnProperty.call(messages, error.code) &&\n      \"message\" in error &&\n      typeof error.message === \"string\" &&\n      \"category\" in error &&\n      typeof error.category === \"string\" &&\n      \"retryable\" in error &&\n      typeof error.retryable === \"boolean\"\n    ) {\n      return new LearnedSkillsError(\n        error.code as LearnedSkillsErrorCode,\n        error.retryable,\n      );\n    }\n  }\n  return new LearnedSkillsError(\"UNSUPPORTED_SERVER\", false);\n}\n\nexport interface GetLearnedSkillsSnapshotsRequest {\n  containers: readonly Omit<GetLearnedSkillsSnapshotRequest, \"signal\">[];\n  signal?: AbortSignal;\n}\nexport type LearnedSkillsBatchResult = { containerId: string } & (\n  | LearnedSkillsSnapshotResult\n  | { status: \"error\"; error: LearnedSkillsError }\n);\n\n/** Validate the entire envelope before exposing any individual result. */\nexport function parseLearnedSkillsBatch(\n  body: unknown,\n  requests: GetLearnedSkillsSnapshotsRequest[\"containers\"],\n): LearnedSkillsBatchResult[] {\n  const invalid = () => {\n    if (\n      body &&\n      typeof body === \"object\" &&\n      \"containers\" in body &&\n      Array.isArray(body.containers)\n    ) {\n      const denial = body.containers.find(\n        (entry) =>\n          entry &&\n          requests.some(\n            (request) => request.containerId === entry.containerId,\n          ) &&\n          entry.status === \"error\" &&\n          [\n            \"AUTHENTICATION_FAILED\",\n            \"AUTHORIZATION_FAILED\",\n            \"ENTITLEMENT_REQUIRED\",\n            \"DELIVERY_DISABLED\",\n            \"CONTAINER_NOT_FOUND\",\n            \"REVISION_NOT_FOUND\",\n            \"REVISION_REVOKED\",\n          ].includes(entry.error?.code),\n      );\n      if (denial) return new LearnedSkillsError(denial.error.code, false);\n    }\n    return new LearnedSkillsError(\"INVALID_SNAPSHOT\", false);\n  };\n  if (\n    !body ||\n    typeof body !== \"object\" ||\n    !(\"containers\" in body) ||\n    !Array.isArray(body.containers) ||\n    body.containers.length !== requests.length\n  )\n    throw invalid();\n  return body.containers.map((entry, index) => {\n    const request = requests[index];\n    if (\n      !entry ||\n      typeof entry !== \"object\" ||\n      entry.containerId !== request.containerId\n    )\n      throw invalid();\n    if (entry.status === \"error\") {\n      if (\n        !entry.error ||\n        typeof entry.error !== \"object\" ||\n        !Object.prototype.hasOwnProperty.call(messages, entry.error.code) ||\n        typeof entry.error.retryable !== \"boolean\"\n      )\n        throw invalid();\n      return {\n        containerId: entry.containerId,\n        status: \"error\",\n        error: new LearnedSkillsError(entry.error.code, entry.error.retryable),\n      };\n    }\n    if (\n      typeof entry.revision !== \"string\" ||\n      !entry.revision.trim() ||\n      typeof entry.etag !== \"string\" ||\n      !/^\"[a-f0-9]{64}\"$/.test(entry.etag) ||\n      (request.revision !== undefined && entry.revision !== request.revision)\n    )\n      throw invalid();\n    if (entry.status === \"unchanged\") {\n      if (\n        request.ifNoneMatch !== entry.etag ||\n        \"bytesBase64\" in entry ||\n        \"contentType\" in entry\n      )\n        throw invalid();\n      return {\n        containerId: entry.containerId,\n        status: \"unchanged\",\n        revision: entry.revision,\n        etag: entry.etag,\n      };\n    }\n    if (\n      entry.status !== \"snapshot\" ||\n      entry.contentType !== \"application/zip\" ||\n      typeof entry.bytesBase64 !== \"string\" ||\n      !entry.bytesBase64.length ||\n      !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(\n        entry.bytesBase64,\n      )\n    )\n      throw invalid();\n    const bytes = Buffer.from(entry.bytesBase64, \"base64\");\n    if (bytes.toString(\"base64\") !== entry.bytesBase64) throw invalid();\n    return {\n      containerId: entry.containerId,\n      status: \"snapshot\",\n      revision: entry.revision,\n      etag: entry.etag,\n      contentType: entry.contentType,\n      bytes: new Uint8Array(bytes),\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/runtime/intelligence-platform/learning-management.cjs

@@ -0,0 +1,203 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let zod = require("zod");
+
+//#region src/runtime/intelligence-platform/learning-management.ts
+/** Wire contracts for the project-key Learning API; keep aligned with Intelligence. */
+const learningContainerIdSchema = zod.z.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+const learningContainerSchema = zod.z.object({
+	id: learningContainerIdSchema,
+	name: zod.z.string().min(1),
+	projectId: zod.z.number().int().positive(),
+	promptContext: zod.z.string().nullable(),
+	createdAt: zod.z.string().datetime({ offset: true }),
+	updatedAt: zod.z.string().datetime({ offset: true })
+});
+const learningContainerPageSchema = zod.z.object({
+	containers: zod.z.array(learningContainerSchema).max(500),
+	nextCursor: zod.z.string().min(1).nullable()
+});
+/** Validates a stable identifier before constructing a request path. */
+function learningContainerPath(containerId) {
+	return `/api/v1/learning/containers/${encodeURIComponent(learningContainerIdSchema.parse(containerId))}`;
+}
+/** Reads a bounded JSON response while the request's signal governs stream cancellation. */
+async function readLearningJson(response, limit = 16 * 1024 * 1024, signal) {
+	if (!response.body) throw new Error("Missing Learning response body");
+	const reader = response.body.getReader();
+	const abort = () => {
+		reader.cancel(signal?.reason).catch(() => void 0);
+	};
+	signal?.addEventListener("abort", abort, { once: true });
+	if (signal?.aborted) abort();
+	const decoder = new TextDecoder();
+	let text = "";
+	let bytes = 0;
+	try {
+		while (true) {
+			signal?.throwIfAborted();
+			const next = await reader.read();
+			signal?.throwIfAborted();
+			if (next.done) break;
+			bytes += next.value.byteLength;
+			if (bytes > limit) {
+				await reader.cancel();
+				throw new Error("Learning response exceeds its size limit");
+			}
+			text += decoder.decode(next.value, { stream: true });
+		}
+		return JSON.parse(text + decoder.decode());
+	} finally {
+		signal?.removeEventListener("abort", abort);
+		reader.releaseLock();
+	}
+}
+const learningSha256Schema = zod.z.string().regex(/^[a-f0-9]{64}$/u);
+const learningUuidSchema = zod.z.string().uuid();
+const learningDateTimeSchema = zod.z.string().datetime({ offset: true });
+/** One immutable file in a proposed Skill candidate bundle. */
+const learningSkillBundleFileSchema = zod.z.object({
+	content: zod.z.string(),
+	path: zod.z.string().min(1).refine((path) => !path.startsWith("/") && !path.split("/").some((segment) => segment === ".."), "Bundle paths must be relative and may not traverse parent directories."),
+	sha256: learningSha256Schema
+});
+/** Complete Skill files attached to one review candidate. */
+const learningSkillBundleSchema = zod.z.object({
+	files: zod.z.array(learningSkillBundleFileSchema).min(1),
+	schemaVersion: zod.z.literal(1)
+}).superRefine(({ files }, context) => {
+	const paths = /* @__PURE__ */ new Set();
+	for (const file of files) {
+		if (paths.has(file.path)) context.addIssue({
+			code: "custom",
+			message: `Duplicate bundle path: ${file.path}`,
+			path: ["files"]
+		});
+		paths.add(file.path);
+	}
+	if (!paths.has("SKILL.md")) context.addIssue({
+		code: "custom",
+		message: "A Skill bundle must contain SKILL.md.",
+		path: ["files"]
+	});
+});
+/** Review state and summary returned for one proposed Skill change. */
+const learningCandidateSchema = zod.z.object({
+	bundleSha256: learningSha256Schema,
+	createdAt: learningDateTimeSchema,
+	description: zod.z.string().min(1),
+	id: learningUuidSchema,
+	operation: zod.z.enum([
+		"add",
+		"update",
+		"remove"
+	]),
+	publishedRegistryRevision: zod.z.number().int().positive().nullable(),
+	publishedSkillId: learningUuidSchema.nullable(),
+	reason: zod.z.string().min(1),
+	registryBaseRevision: zod.z.number().int().nonnegative(),
+	reviewedAt: learningDateTimeSchema.nullable(),
+	runId: learningUuidSchema,
+	status: zod.z.enum([
+		"pending_review",
+		"approved",
+		"rejected"
+	]),
+	subjectSha256: learningSha256Schema,
+	targetSkillId: learningUuidSchema.nullable(),
+	targetSkillRevision: zod.z.number().int().positive().nullable(),
+	title: zod.z.string().min(1)
+});
+/** Full proposed Skill change, including evidence and every bundle file. */
+const learningCandidateDetailSchema = learningCandidateSchema.extend({
+	bundle: learningSkillBundleSchema,
+	supportingInsights: zod.z.array(zod.z.object({
+		alias: zod.z.string().min(1),
+		id: learningUuidSchema,
+		impact: zod.z.string().min(1),
+		statement: zod.z.string().min(1)
+	}))
+});
+/** Result returned after a human or agent reviews a Skill candidate. */
+const learningCandidateReviewSchema = zod.z.object({
+	candidateId: learningUuidSchema,
+	operation: zod.z.enum([
+		"add",
+		"update",
+		"remove"
+	]),
+	publishedRegistryRevision: zod.z.number().int().positive().nullable(),
+	publishedSkillId: learningUuidSchema.nullable(),
+	status: zod.z.enum(["approved", "rejected"])
+});
+const learningRunSchema = zod.z.object({
+	id: zod.z.string().uuid(),
+	learningContainerId: learningContainerIdSchema,
+	projectId: zod.z.number().int().positive(),
+	status: zod.z.enum([
+		"queued",
+		"freezing",
+		"batching",
+		"reducing",
+		"finalizing",
+		"succeeded",
+		"failed"
+	]),
+	triggerSource: zod.z.enum(["automatic", "manual"]),
+	attemptCount: zod.z.number().int().nonnegative(),
+	candidateCount: zod.z.number().int().nonnegative().nullable(),
+	insightCount: zod.z.number().int().nonnegative().nullable(),
+	evidenceThreadCount: zod.z.number().int().nonnegative().nullable().optional(),
+	createdAt: learningDateTimeSchema,
+	updatedAt: learningDateTimeSchema,
+	startedAt: learningDateTimeSchema.nullable(),
+	completedAt: learningDateTimeSchema.nullable(),
+	failureCode: zod.z.string().nullable(),
+	kubernetesJobName: zod.z.string().nullable()
+});
+const unavailableSchema = zod.z.enum(["snapshot-missing", "snapshot-unreadable"]).nullable();
+const learningInsightEvidenceSchema = zod.z.union([zod.z.object({
+	cited: zod.z.array(zod.z.object({
+		id: zod.z.string(),
+		content: zod.z.string(),
+		role: zod.z.enum([
+			"assistant",
+			"tool",
+			"user"
+		])
+	})),
+	messageCount: zod.z.number().int().nonnegative(),
+	threadId: zod.z.string(),
+	threadName: zod.z.string().nullable(),
+	threadPresent: zod.z.boolean(),
+	unavailable: unavailableSchema
+}), zod.z.object({
+	kind: zod.z.literal("trajectory"),
+	trajectoryId: zod.z.string().uuid(),
+	trajectoryPresent: zod.z.boolean(),
+	eventCount: zod.z.number().int().nonnegative(),
+	events: zod.z.array(zod.z.object({
+		seq: zod.z.number().int().nonnegative(),
+		name: zod.z.string(),
+		offsetMs: zod.z.number(),
+		value: zod.z.unknown(),
+		eventId: zod.z.string().nullable()
+	})),
+	unavailable: unavailableSchema
+})]);
+/** Validates object IDs independently from container IDs; neither may alter the path. */
+function learningObjectId(id) {
+	return zod.z.string().uuid().parse(id);
+}
+
+//#endregion
+exports.learningCandidateDetailSchema = learningCandidateDetailSchema;
+exports.learningCandidateReviewSchema = learningCandidateReviewSchema;
+exports.learningCandidateSchema = learningCandidateSchema;
+exports.learningContainerPageSchema = learningContainerPageSchema;
+exports.learningContainerPath = learningContainerPath;
+exports.learningContainerSchema = learningContainerSchema;
+exports.learningInsightEvidenceSchema = learningInsightEvidenceSchema;
+exports.learningObjectId = learningObjectId;
+exports.learningRunSchema = learningRunSchema;
+exports.readLearningJson = readLearningJson;
+//# sourceMappingURL=learning-management.cjs.map

package/dist/runtime/intelligence-platform/learning-management.cjs.map

@@ -0,0 +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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"}

package/dist/runtime/intelligence-platform/learning-management.d.cts

@@ -0,0 +1,111 @@
+import { z } from "zod";
+
+//#region src/runtime/intelligence-platform/learning-management.d.ts
+/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */
+interface LearningContainer {
+  id: string;
+  name: string;
+  projectId: number;
+  promptContext: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+interface LearningContainerPage {
+  containers: LearningContainer[];
+  nextCursor: string | null;
+}
+interface LearningRequestOptions {
+  readonly signal?: AbortSignal;
+}
+interface LearningContainerRequest extends LearningRequestOptions {
+  readonly containerId: string;
+}
+interface LearningCandidate {
+  id: string;
+  bundleSha256: string;
+  createdAt: string;
+  description: string;
+  operation: "add" | "update" | "remove";
+  publishedRegistryRevision: number | null;
+  publishedSkillId: string | null;
+  reason: string;
+  registryBaseRevision: number;
+  reviewedAt: string | null;
+  runId: string;
+  status: "pending_review" | "approved" | "rejected";
+  subjectSha256: string;
+  targetSkillId: string | null;
+  targetSkillRevision: number | null;
+  title: string;
+}
+interface LearningCandidateDetail extends LearningCandidate {
+  bundle: {
+    schemaVersion: 1;
+    files: Array<{
+      path: string;
+      content: string;
+      sha256: string;
+    }>;
+  };
+  supportingInsights: Array<{
+    alias: string;
+    id: string;
+    impact: string;
+    statement: string;
+  }>;
+}
+interface LearningCandidateReview {
+  candidateId: string;
+  operation: "add" | "update" | "remove";
+  publishedRegistryRevision: number | null;
+  publishedSkillId: string | null;
+  status: "approved" | "rejected";
+}
+interface LearningCandidateRequest extends LearningContainerRequest {
+  readonly candidateId: string;
+}
+interface LearningRun {
+  id: string;
+  learningContainerId: string;
+  projectId: number;
+  status: "queued" | "freezing" | "batching" | "reducing" | "finalizing" | "succeeded" | "failed";
+  triggerSource: "automatic" | "manual";
+  attemptCount: number;
+  candidateCount: number | null;
+  insightCount: number | null;
+  evidenceThreadCount?: number | null;
+  createdAt: string;
+  updatedAt: string;
+  startedAt: string | null;
+  completedAt: string | null;
+  failureCode: string | null;
+  kubernetesJobName: string | null;
+}
+type LearningInsightEvidence = {
+  cited: Array<{
+    id: string;
+    content: string;
+    role: "assistant" | "tool" | "user";
+  }>;
+  messageCount: number;
+  threadId: string;
+  threadName: string | null;
+  threadPresent: boolean;
+  unavailable: "snapshot-missing" | "snapshot-unreadable" | null;
+} | {
+  kind: "trajectory";
+  trajectoryId: string;
+  trajectoryPresent: boolean;
+  eventCount: number;
+  events: Array<{
+    seq: number;
+    name: string;
+    offsetMs: number;
+    value?: unknown;
+    eventId: string | null;
+  }>;
+  unavailable: "snapshot-missing" | "snapshot-unreadable" | null;
+};
+//#endregion
+export { LearningCandidate, LearningCandidateDetail, LearningCandidateRequest, LearningCandidateReview, LearningContainer, LearningContainerPage, LearningContainerRequest, LearningInsightEvidence, LearningRequestOptions, LearningRun };
+//# sourceMappingURL=learning-management.d.cts.map

package/dist/runtime/intelligence-platform/learning-management.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.d.cts","names":[],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"mappings":";;;;UAqBiB,iBAAA;EACf,EAAA;EACA,IAAA;EACA,SAAA;EACA,aAAA;EACA,SAAA;EACA,SAAA;AAAA;AAAA,UAEe,qBAAA;EACf,UAAA,EAAY,iBAAA;EACZ,UAAA;AAAA;AAAA,UAEe,sBAAA;EAAA,SACN,MAAA,GAAS,WAAA;AAAA;AAAA,UAEH,wBAAA,SAAiC,sBAAA;EAAA,SACvC,WAAA;AAAA;AAAA,UAqIM,iBAAA;EACf,EAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,SAAA;EACA,yBAAA;EACA,gBAAA;EACA,MAAA;EACA,oBAAA;EACA,UAAA;EACA,KAAA;EACA,MAAA;EACA,aAAA;EACA,aAAA;EACA,mBAAA;EACA,KAAA;AAAA;AAAA,UAEe,uBAAA,SAAgC,iBAAA;EAC/C,MAAA;IACE,aAAA;IACA,KAAA,EAAO,KAAA;MAAQ,IAAA;MAAc,OAAA;MAAiB,MAAA;IAAA;EAAA;EAEhD,kBAAA,EAAoB,KAAA;IAClB,KAAA;IACA,EAAA;IACA,MAAA;IACA,SAAA;EAAA;AAAA;AAAA,UAGa,uBAAA;EACf,WAAA;EACA,SAAA;EACA,yBAAA;EACA,gBAAA;EACA,MAAA;AAAA;AAAA,UAEe,wBAAA,SAAiC,wBAAA;EAAA,SACvC,WAAA;AAAA;AAAA,UA4BM,WAAA;EACf,EAAA;EACA,mBAAA;EACA,SAAA;EACA,MAAA;EAQA,aAAA;EACA,YAAA;EACA,cAAA;EACA,YAAA;EACA,mBAAA;EACA,SAAA;EACA,SAAA;EACA,SAAA;EACA,WAAA;EACA,WAAA;EACA,iBAAA;AAAA;AAAA,KAqCU,uBAAA;EAEN,KAAA,EAAO,KAAA;IACL,EAAA;IACA,OAAA;IACA,IAAA;EAAA;EAEF,YAAA;EACA,QAAA;EACA,UAAA;EACA,aAAA;EACA,WAAA;AAAA;EAGA,IAAA;EACA,YAAA;EACA,iBAAA;EACA,UAAA;EACA,MAAA,EAAQ,KAAA;IACN,GAAA;IACA,IAAA;IACA,QAAA;IACA,KAAA;IACA,OAAA;EAAA;EAEF,WAAA;AAAA"}

package/dist/runtime/intelligence-platform/learning-management.d.mts

@@ -0,0 +1,111 @@
+import { z } from "zod";
+
+//#region src/runtime/intelligence-platform/learning-management.d.ts
+/** Explicit wire types preserve required/null fields in declarations emitted with strictNullChecks disabled. */
+interface LearningContainer {
+  id: string;
+  name: string;
+  projectId: number;
+  promptContext: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+interface LearningContainerPage {
+  containers: LearningContainer[];
+  nextCursor: string | null;
+}
+interface LearningRequestOptions {
+  readonly signal?: AbortSignal;
+}
+interface LearningContainerRequest extends LearningRequestOptions {
+  readonly containerId: string;
+}
+interface LearningCandidate {
+  id: string;
+  bundleSha256: string;
+  createdAt: string;
+  description: string;
+  operation: "add" | "update" | "remove";
+  publishedRegistryRevision: number | null;
+  publishedSkillId: string | null;
+  reason: string;
+  registryBaseRevision: number;
+  reviewedAt: string | null;
+  runId: string;
+  status: "pending_review" | "approved" | "rejected";
+  subjectSha256: string;
+  targetSkillId: string | null;
+  targetSkillRevision: number | null;
+  title: string;
+}
+interface LearningCandidateDetail extends LearningCandidate {
+  bundle: {
+    schemaVersion: 1;
+    files: Array<{
+      path: string;
+      content: string;
+      sha256: string;
+    }>;
+  };
+  supportingInsights: Array<{
+    alias: string;
+    id: string;
+    impact: string;
+    statement: string;
+  }>;
+}
+interface LearningCandidateReview {
+  candidateId: string;
+  operation: "add" | "update" | "remove";
+  publishedRegistryRevision: number | null;
+  publishedSkillId: string | null;
+  status: "approved" | "rejected";
+}
+interface LearningCandidateRequest extends LearningContainerRequest {
+  readonly candidateId: string;
+}
+interface LearningRun {
+  id: string;
+  learningContainerId: string;
+  projectId: number;
+  status: "queued" | "freezing" | "batching" | "reducing" | "finalizing" | "succeeded" | "failed";
+  triggerSource: "automatic" | "manual";
+  attemptCount: number;
+  candidateCount: number | null;
+  insightCount: number | null;
+  evidenceThreadCount?: number | null;
+  createdAt: string;
+  updatedAt: string;
+  startedAt: string | null;
+  completedAt: string | null;
+  failureCode: string | null;
+  kubernetesJobName: string | null;
+}
+type LearningInsightEvidence = {
+  cited: Array<{
+    id: string;
+    content: string;
+    role: "assistant" | "tool" | "user";
+  }>;
+  messageCount: number;
+  threadId: string;
+  threadName: string | null;
+  threadPresent: boolean;
+  unavailable: "snapshot-missing" | "snapshot-unreadable" | null;
+} | {
+  kind: "trajectory";
+  trajectoryId: string;
+  trajectoryPresent: boolean;
+  eventCount: number;
+  events: Array<{
+    seq: number;
+    name: string;
+    offsetMs: number;
+    value?: unknown;
+    eventId: string | null;
+  }>;
+  unavailable: "snapshot-missing" | "snapshot-unreadable" | null;
+};
+//#endregion
+export { LearningCandidate, LearningCandidateDetail, LearningCandidateRequest, LearningCandidateReview, LearningContainer, LearningContainerPage, LearningContainerRequest, LearningInsightEvidence, LearningRequestOptions, LearningRun };
+//# sourceMappingURL=learning-management.d.mts.map

package/dist/runtime/intelligence-platform/learning-management.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.d.mts","names":[],"sources":["../../../src/runtime/intelligence-platform/learning-management.ts"],"mappings":";;;;UAqBiB,iBAAA;EACf,EAAA;EACA,IAAA;EACA,SAAA;EACA,aAAA;EACA,SAAA;EACA,SAAA;AAAA;AAAA,UAEe,qBAAA;EACf,UAAA,EAAY,iBAAA;EACZ,UAAA;AAAA;AAAA,UAEe,sBAAA;EAAA,SACN,MAAA,GAAS,WAAA;AAAA;AAAA,UAEH,wBAAA,SAAiC,sBAAA;EAAA,SACvC,WAAA;AAAA;AAAA,UAqIM,iBAAA;EACf,EAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,SAAA;EACA,yBAAA;EACA,gBAAA;EACA,MAAA;EACA,oBAAA;EACA,UAAA;EACA,KAAA;EACA,MAAA;EACA,aAAA;EACA,aAAA;EACA,mBAAA;EACA,KAAA;AAAA;AAAA,UAEe,uBAAA,SAAgC,iBAAA;EAC/C,MAAA;IACE,aAAA;IACA,KAAA,EAAO,KAAA;MAAQ,IAAA;MAAc,OAAA;MAAiB,MAAA;IAAA;EAAA;EAEhD,kBAAA,EAAoB,KAAA;IAClB,KAAA;IACA,EAAA;IACA,MAAA;IACA,SAAA;EAAA;AAAA;AAAA,UAGa,uBAAA;EACf,WAAA;EACA,SAAA;EACA,yBAAA;EACA,gBAAA;EACA,MAAA;AAAA;AAAA,UAEe,wBAAA,SAAiC,wBAAA;EAAA,SACvC,WAAA;AAAA;AAAA,UA4BM,WAAA;EACf,EAAA;EACA,mBAAA;EACA,SAAA;EACA,MAAA;EAQA,aAAA;EACA,YAAA;EACA,cAAA;EACA,YAAA;EACA,mBAAA;EACA,SAAA;EACA,SAAA;EACA,SAAA;EACA,WAAA;EACA,WAAA;EACA,iBAAA;AAAA;AAAA,KAqCU,uBAAA;EAEN,KAAA,EAAO,KAAA;IACL,EAAA;IACA,OAAA;IACA,IAAA;EAAA;EAEF,YAAA;EACA,QAAA;EACA,UAAA;EACA,aAAA;EACA,WAAA;AAAA;EAGA,IAAA;EACA,YAAA;EACA,iBAAA;EACA,UAAA;EACA,MAAA,EAAQ,KAAA;IACN,GAAA;IACA,IAAA;IACA,QAAA;IACA,KAAA;IACA,OAAA;EAAA;EAEF,WAAA;AAAA"}