@copilotkit/runtime 1.80.0 → 1.82.0

package/dist/v2/runtime/intelligence-platform/experimental.d.mts

@@ -0,0 +1,27 @@
+
+import { LearningCandidate, LearningCandidateDetail, LearningCandidateRequest, LearningCandidateReview, LearningContainer, LearningContainerPage, LearningContainerRequest, LearningInsightEvidence, LearningRequestOptions, LearningRun } from "./learning-management.mjs";
+
+//#region src/v2/runtime/intelligence-platform/experimental.d.ts
+declare namespace experimental_d_exports {
+  export { ExperimentalLearningManagement, LearningCandidate, LearningCandidateDetail, LearningCandidateRequest, LearningCandidateReview, LearningContainer, LearningContainerPage, LearningContainerRequest, LearningInsightEvidence, LearningRequestOptions, LearningRun };
+}
+/** Server-side Learning management operations; call only after authorizing the application user. */
+interface ExperimentalLearningManagement {
+  listLearningContainers(options?: LearningRequestOptions & {
+    readonly cursor?: string;
+  }): Promise<LearningContainerPage>;
+  getLearningContainer(options: LearningContainerRequest): Promise<LearningContainer>;
+  listLearningRuns(options: LearningContainerRequest): Promise<LearningRun[]>;
+  startLearningRun(options: LearningContainerRequest): Promise<LearningRun>;
+  listLearningCandidates(options: LearningContainerRequest): Promise<LearningCandidate[]>;
+  getLearningCandidate(options: LearningCandidateRequest): Promise<LearningCandidateDetail>;
+  getLearningInsightEvidence(options: LearningContainerRequest & {
+    readonly insightId: string;
+  }): Promise<LearningInsightEvidence[]>;
+  reviewLearningCandidate(options: LearningCandidateRequest & {
+    readonly action: "approve" | "reject";
+  }): Promise<LearningCandidateReview>;
+}
+//#endregion
+export { ExperimentalLearningManagement, experimental_d_exports };
+//# sourceMappingURL=experimental.d.mts.map

package/dist/v2/runtime/intelligence-platform/experimental.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimental.d.mts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/experimental.ts"],"mappings":";;;;;;;;UAeiB,8BAAA;EACf,sBAAA,CACE,OAAA,GAAU,sBAAA;IAAA,SAAoC,MAAA;EAAA,IAC7C,OAAA,CAAQ,qBAAA;EACX,oBAAA,CACE,OAAA,EAAS,wBAAA,GACR,OAAA,CAAQ,iBAAA;EACX,gBAAA,CAAiB,OAAA,EAAS,wBAAA,GAA2B,OAAA,CAAQ,WAAA;EAC7D,gBAAA,CAAiB,OAAA,EAAS,wBAAA,GAA2B,OAAA,CAAQ,WAAA;EAC7D,sBAAA,CACE,OAAA,EAAS,wBAAA,GACR,OAAA,CAAQ,iBAAA;EACX,oBAAA,CACE,OAAA,EAAS,wBAAA,GACR,OAAA,CAAQ,uBAAA;EACX,0BAAA,CACE,OAAA,EAAS,wBAAA;IAAA,SAAsC,SAAA;EAAA,IAC9C,OAAA,CAAQ,uBAAA;EACX,uBAAA,CACE,OAAA,EAAS,wBAAA;IAAA,SACE,MAAA;EAAA,IAEV,OAAA,CAAQ,uBAAA;AAAA"}

package/dist/v2/runtime/intelligence-platform/index.d.cts

@@ -1,3 +1,4 @@
 
+import { experimental_d_exports } from "./experimental.cjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./learned-skills.cjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.cjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.cjs";

package/dist/v2/runtime/intelligence-platform/index.d.mts

@@ -1,3 +1,4 @@
 
+import { experimental_d_exports } from "./experimental.mjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./learned-skills.mjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.mjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.mjs";

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

@@ -0,0 +1,204 @@
+require("reflect-metadata");
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+let zod = require("zod");
+
+//#region src/v2/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/v2/runtime/intelligence-platform/learning-management.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.cjs","names":["z"],"sources":["../../../../src/v2/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/v2/runtime/intelligence-platform/learning-management.d.cts

@@ -0,0 +1,112 @@
+
+import { z } from "zod";
+
+//#region src/v2/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/v2/runtime/intelligence-platform/learning-management.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.d.cts","names":[],"sources":["../../../../src/v2/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/v2/runtime/intelligence-platform/learning-management.d.mts

@@ -0,0 +1,112 @@
+
+import { z } from "zod";
+
+//#region src/v2/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/v2/runtime/intelligence-platform/learning-management.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-management.d.mts","names":[],"sources":["../../../../src/v2/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"}