@copilotkit/runtime 1.80.0 → 1.82.0

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

@@ -1,4 +1,5 @@
 
+import { ExperimentalLearningManagement } from "./experimental.cjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsSnapshotResult } from "./learned-skills.cjs";
 import { GetLearningContainerId, GetTrajectoryLearningContainerIds } from "../core/learning.cjs";
 import { TrajectoryConnectionGrant } from "./trajectories.cjs";
@@ -26,6 +27,15 @@ interface RuntimeMemoryGrant {
  * }
  * ```
  */
+declare class PlatformRequestError extends Error {
+  /** The HTTP status code returned by the platform (e.g. 404, 409, 500). */
+  readonly status: number;
+  /** Whether retrying may succeed without changing client configuration. */
+  readonly retryable?: boolean;
+  /** Stable backend error code, when supplied by a validated error envelope. */
+  readonly code?: string;
+  constructor(message: string, /** The HTTP status code returned by the platform (e.g. 404, 409, 500). */status: number, /** Whether retrying may succeed without changing client configuration. */retryable?: boolean, /** Stable backend error code, when supplied by a validated error envelope. */code?: string);
+}
 /** Payload passed to `onThreadDeleted` listeners. */
 interface ThreadDeletedPayload {
   threadId: string;
@@ -110,6 +120,10 @@ interface CopilotKitIntelligenceConfig {
  * {@link CopilotKitIntelligence.getThreadMessages} for that.
  */
 interface ThreadSummary {
+  /** Existing Learning membership for single-container Threads; null for zero or multiple memberships. */
+  learningContainerId?: string | null;
+  /** Existing Learning memberships. Absent on older platform responses; do not infer a new assignment from absence. */
+  learningContainerIds?: string[];
   /** Platform-assigned unique identifier. */
   id: string;
   /** Human-readable display name, or `null` if the thread has not been named. */
@@ -373,6 +387,11 @@ interface AcquireThreadLockRequest {
   learningContainerId?: string;
   /** Internal managed-Channel delivery context for shared Thread access. */
   channelDeliveryId?: string;
+  /**
+   * The user request this run belongs to. Follow-up runs and resumes of one
+   * request send the same ID, so the platform counts the request once.
+   */
+  requestId?: string;
   /** Custom Redis key prefix for the lock (default: "thread"). */
   lockKeyPrefix?: string;
   /** Lock TTL in seconds. When set, the lock auto-expires after this duration. */
@@ -449,6 +468,10 @@ interface ThreadLockInfo {
  */
 declare class CopilotKitIntelligence {
   #private;
+  /** Experimental server-side APIs; their contracts may change before release. */
+  readonly experimental: {
+    readonly learning: ExperimentalLearningManagement;
+  };
   constructor(config: CopilotKitIntelligenceConfig);
   /**
    * Register a listener invoked whenever a thread is created.
@@ -831,5 +854,5 @@ declare class CopilotKitIntelligence {
   }): Promise<ConnectThreadResponse>;
 }
 //#endregion
-export { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest };
+export { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest };
 //# sourceMappingURL=client.d.cts.map

package/dist/v2/runtime/intelligence-platform/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 
+import { ExperimentalLearningManagement } from "./experimental.mjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsSnapshotResult } from "./learned-skills.mjs";
 import { GetLearningContainerId, GetTrajectoryLearningContainerIds } from "../core/learning.mjs";
 import { TrajectoryConnectionGrant } from "./trajectories.mjs";
@@ -26,6 +27,15 @@ interface RuntimeMemoryGrant {
  * }
  * ```
  */
+declare class PlatformRequestError extends Error {
+  /** The HTTP status code returned by the platform (e.g. 404, 409, 500). */
+  readonly status: number;
+  /** Whether retrying may succeed without changing client configuration. */
+  readonly retryable?: boolean;
+  /** Stable backend error code, when supplied by a validated error envelope. */
+  readonly code?: string;
+  constructor(message: string, /** The HTTP status code returned by the platform (e.g. 404, 409, 500). */status: number, /** Whether retrying may succeed without changing client configuration. */retryable?: boolean, /** Stable backend error code, when supplied by a validated error envelope. */code?: string);
+}
 /** Payload passed to `onThreadDeleted` listeners. */
 interface ThreadDeletedPayload {
   threadId: string;
@@ -110,6 +120,10 @@ interface CopilotKitIntelligenceConfig {
  * {@link CopilotKitIntelligence.getThreadMessages} for that.
  */
 interface ThreadSummary {
+  /** Existing Learning membership for single-container Threads; null for zero or multiple memberships. */
+  learningContainerId?: string | null;
+  /** Existing Learning memberships. Absent on older platform responses; do not infer a new assignment from absence. */
+  learningContainerIds?: string[];
   /** Platform-assigned unique identifier. */
   id: string;
   /** Human-readable display name, or `null` if the thread has not been named. */
@@ -373,6 +387,11 @@ interface AcquireThreadLockRequest {
   learningContainerId?: string;
   /** Internal managed-Channel delivery context for shared Thread access. */
   channelDeliveryId?: string;
+  /**
+   * The user request this run belongs to. Follow-up runs and resumes of one
+   * request send the same ID, so the platform counts the request once.
+   */
+  requestId?: string;
   /** Custom Redis key prefix for the lock (default: "thread"). */
   lockKeyPrefix?: string;
   /** Lock TTL in seconds. When set, the lock auto-expires after this duration. */
@@ -449,6 +468,10 @@ interface ThreadLockInfo {
  */
 declare class CopilotKitIntelligence {
   #private;
+  /** Experimental server-side APIs; their contracts may change before release. */
+  readonly experimental: {
+    readonly learning: ExperimentalLearningManagement;
+  };
   constructor(config: CopilotKitIntelligenceConfig);
   /**
    * Register a listener invoked whenever a thread is created.
@@ -831,5 +854,5 @@ declare class CopilotKitIntelligence {
   }): Promise<ConnectThreadResponse>;
 }
 //#endregion
-export { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest };
+export { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest };
 //# sourceMappingURL=client.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../../../../src/v2/runtime/intelligence-platform/client.ts"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 import "reflect-metadata";
 import { resolveTrajectoryLearningContainerIds } from "../core/learning.mjs";
 import { LearnedSkillsError, learnedSkillsResponseError, parseLearnedSkillsBatch } from "./learned-skills.mjs";
+import { learningCandidateDetailSchema, learningCandidateReviewSchema, learningCandidateSchema, learningContainerPageSchema, learningContainerPath, learningContainerSchema, learningInsightEvidenceSchema, learningObjectId, learningRunSchema, readLearningJson } from "./learning-management.mjs";
 import { TrajectoryConnectionError, parseTrajectoryConnectionGrant, trajectoryResponseError } from "./trajectories.mjs";
 import { logger, parseInspectorLearningSnapshotV1, parseInspectorMetadataV1 } from "@copilotkit/shared";
 import { z } from "zod";
@@ -143,10 +144,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";
 	}
 };
@@ -239,6 +241,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");
@@ -553,6 +565,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(z.string().min(1).max(128).parse(options.cursor))}`;
+		return this.#learningRequest("GET", `/api/v1/learning/containers${query}`, learningContainerPageSchema, options.signal);
+	}
+	/** Reads one Learning space; this does not assign or move any conversations. */
+	async #getLearningContainer(options) {
+		return (await this.#learningRequest("GET", learningContainerPath(options.containerId), z.object({ container: learningContainerSchema }), options.signal)).container;
+	}
+	/** Reads the latest 100 Learning runs; queue admission is not completion. */
+	async #listLearningRuns(options) {
+		return (await this.#learningRequest("GET", `${learningContainerPath(options.containerId)}/runs`, z.object({ runs: z.array(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", `${learningContainerPath(options.containerId)}/runs`, z.object({ run: learningRunSchema }), options.signal)).run;
+	}
+	/** Reads the latest 500 proposed Skill changes, including completed reviews. */
+	async #listLearningCandidates(options) {
+		return (await this.#learningRequest("GET", `${learningContainerPath(options.containerId)}/candidates`, z.object({ candidates: z.array(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", `${learningContainerPath(options.containerId)}/candidates/${learningObjectId(options.candidateId)}`, z.object({ candidate: learningCandidateDetailSchema }), options.signal)).candidate;
+	}
+	/** Reads scoped source evidence, including unavailable-source reasons. */
+	async #getLearningInsightEvidence(options) {
+		return (await this.#learningRequest("GET", `${learningContainerPath(options.containerId)}/insights/${learningObjectId(options.insightId)}/evidence`, z.object({ evidence: z.array(learningInsightEvidenceSchema) }), options.signal)).evidence;
+	}
+	/** Publishes or rejects a proposal. The application must authorize its reviewer before calling. */
+	async #reviewLearningCandidate(options) {
+		const action = z.enum(["approve", "reject"]).parse(options.action);
+		return (await this.#learningRequest("POST", `${learningContainerPath(options.containerId)}/candidates/${learningObjectId(options.candidateId)}/${action}`, z.object({ review: 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 readLearningJson(response, 64 * 1024, controller.signal).catch(() => void 0);
+				controller.signal.throwIfAborted();
+				const error = z.object({ error: z.object({
+					code: z.string().regex(/^[A-Z][A-Z0-9_]{0,99}$/),
+					retryable: 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 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`);
@@ -1131,6 +1214,7 @@ var CopilotKitIntelligence = class {
 			agentId: params.agentId,
 			...params.supportsBackendThreadId === void 0 ? {} : { supportsBackendThreadId: params.supportsBackendThreadId },
 			...params.learningContainerId !== void 0 ? { learningContainerId: params.learningContainerId } : {},
+			...params.requestId !== void 0 ? { requestId: params.requestId } : {},
 			...params.lockKeyPrefix !== void 0 ? { lockKeyPrefix: params.lockKeyPrefix } : {},
 			...params.ttlSeconds !== void 0 ? { ttlSeconds: params.ttlSeconds } : {}
 		}, params.channelDeliveryId ? { "X-Cpki-Channel-Delivery-Id": params.channelDeliveryId } : void 0);