@copilotkit/runtime 1.80.0 → 1.81.0

package/dist/v2/runtime/intelligence-platform/client.cjs

@@ -2,6 +2,7 @@ require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_learning = require('../core/learning.cjs');
 const require_learned_skills = require('./learned-skills.cjs');
+const require_learning_management = require('./learning-management.cjs');
 const require_trajectories = require('./trajectories.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 let zod = require("zod");
@@ -144,10 +145,11 @@ const CONFLICT = new Set([409]);
 * ```
 */
 var PlatformRequestError = class extends Error {
-	constructor(message, status, retryable) {
+	constructor(message, status, retryable, code) {
 		super(message);
 		this.status = status;
 		this.retryable = retryable;
+		this.code = code;
 		this.name = "PlatformRequestError";
 	}
 };
@@ -240,6 +242,16 @@ var CopilotKitIntelligence = class {
 	#threadUpdatedListeners = /* @__PURE__ */ new Set();
 	#threadDeletedListeners = /* @__PURE__ */ new Set();
 	constructor(config) {
+		this.experimental = { learning: {
+			listLearningContainers: this.#listLearningContainers.bind(this),
+			getLearningContainer: this.#getLearningContainer.bind(this),
+			listLearningRuns: this.#listLearningRuns.bind(this),
+			startLearningRun: this.#startLearningRun.bind(this),
+			listLearningCandidates: this.#listLearningCandidates.bind(this),
+			getLearningCandidate: this.#getLearningCandidate.bind(this),
+			getLearningInsightEvidence: this.#getLearningInsightEvidence.bind(this),
+			reviewLearningCandidate: this.#reviewLearningCandidate.bind(this)
+		} };
 		if (config.getLearningContainerId !== void 0 && typeof config.getLearningContainerId !== "function") throw new Error("CopilotKitIntelligence `getLearningContainerId` must be a callback");
 		assertConfiguredApiKey(config.apiKey);
 		if (config.getTrajectoryLearningContainerIds !== void 0 && typeof config.getTrajectoryLearningContainerIds !== "function") throw new Error("CopilotKitIntelligence `getTrajectoryLearningContainerIds` must be a callback");
@@ -554,6 +566,77 @@ var CopilotKitIntelligence = class {
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
 		}
 	}
+	/** Lists a bounded page of Learning spaces owned by this server's project key. */
+	async #listLearningContainers(options = {}) {
+		const query = options.cursor === void 0 ? "" : `?cursor=${encodeURIComponent(zod.z.string().min(1).max(128).parse(options.cursor))}`;
+		return this.#learningRequest("GET", `/api/v1/learning/containers${query}`, require_learning_management.learningContainerPageSchema, options.signal);
+	}
+	/** Reads one Learning space; this does not assign or move any conversations. */
+	async #getLearningContainer(options) {
+		return (await this.#learningRequest("GET", require_learning_management.learningContainerPath(options.containerId), zod.z.object({ container: require_learning_management.learningContainerSchema }), options.signal)).container;
+	}
+	/** Reads the latest 100 Learning runs; queue admission is not completion. */
+	async #listLearningRuns(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/runs`, zod.z.object({ runs: zod.z.array(require_learning_management.learningRunSchema).max(100) }), options.signal)).runs;
+	}
+	/** Starts or recovers a manual run for all eligible evidence in this space. Never retries automatically. */
+	async #startLearningRun(options) {
+		return (await this.#learningRequest("POST", `${require_learning_management.learningContainerPath(options.containerId)}/runs`, zod.z.object({ run: require_learning_management.learningRunSchema }), options.signal)).run;
+	}
+	/** Reads the latest 500 proposed Skill changes, including completed reviews. */
+	async #listLearningCandidates(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/candidates`, zod.z.object({ candidates: zod.z.array(require_learning_management.learningCandidateSchema).max(500) }), options.signal)).candidates;
+	}
+	/** Reads proposed files and supporting Insights for an explicit review decision. */
+	async #getLearningCandidate(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/candidates/${require_learning_management.learningObjectId(options.candidateId)}`, zod.z.object({ candidate: require_learning_management.learningCandidateDetailSchema }), options.signal)).candidate;
+	}
+	/** Reads scoped source evidence, including unavailable-source reasons. */
+	async #getLearningInsightEvidence(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/insights/${require_learning_management.learningObjectId(options.insightId)}/evidence`, zod.z.object({ evidence: zod.z.array(require_learning_management.learningInsightEvidenceSchema) }), options.signal)).evidence;
+	}
+	/** Publishes or rejects a proposal. The application must authorize its reviewer before calling. */
+	async #reviewLearningCandidate(options) {
+		const action = zod.z.enum(["approve", "reject"]).parse(options.action);
+		return (await this.#learningRequest("POST", `${require_learning_management.learningContainerPath(options.containerId)}/candidates/${require_learning_management.learningObjectId(options.candidateId)}/${action}`, zod.z.object({ review: require_learning_management.learningCandidateReviewSchema }), options.signal)).review;
+	}
+	/** Uses server credentials, bounded JSON, and a deadline without retrying mutations. */
+	async #learningRequest(method, path, schema, signal) {
+		signal?.throwIfAborted();
+		const controller = new AbortController();
+		const abort = () => controller.abort(signal?.reason);
+		signal?.addEventListener("abort", abort, { once: true });
+		const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Learning request timed out")), 3e4);
+		try {
+			const response = await fetch(`${this.#apiUrl}${path}`, {
+				method,
+				headers: {
+					Authorization: `Bearer ${this.#apiKey}`,
+					"Content-Type": "application/json"
+				},
+				...method === "POST" ? { body: "{}" } : {},
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				const body = await require_learning_management.readLearningJson(response, 64 * 1024, controller.signal).catch(() => void 0);
+				controller.signal.throwIfAborted();
+				const error = zod.z.object({ error: zod.z.object({
+					code: zod.z.string().regex(/^[A-Z][A-Z0-9_]{0,99}$/),
+					retryable: zod.z.boolean()
+				}) }).safeParse(body);
+				throw new PlatformRequestError(`Learning request failed (${response.status}).`, response.status, error.success ? error.data.error.retryable : response.status === 429 || response.status >= 500, error.success ? error.data.error.code : void 0);
+			}
+			try {
+				return schema.parse(await require_learning_management.readLearningJson(response, void 0, controller.signal));
+			} catch {
+				if (controller.signal.aborted) throw controller.signal.reason;
+				throw new PlatformRequestError("Invalid Learning response.", 502, true);
+			}
+		} finally {
+			clearTimeout(timeout);
+			signal?.removeEventListener("abort", abort);
+		}
+	}
 	/** Fetches one credential-scoped, bounded Learning projection for Inspector. */
 	async getInspectorLearning(request) {
 		const url = new URL(`${this.#apiUrl}/api/inspector/learning`);