@copilotkit/runtime 1.80.0 → 1.82.0

package/dist/v2/runtime/index.d.cts

@@ -1,11 +1,12 @@
 
+import { experimental_d_exports } from "./intelligence-platform/experimental.cjs";
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.cjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, ThreadAlreadyRunningError, supportsLocalThreadEndpoints } from "./runner/agent-runner.cjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.cjs";
 import "./intelligence-platform/index.cjs";
 import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeMemoryConfig, CopilotRuntimeOptions, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, MemoryAccess, MemoryConsumer, MemoryGrant, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./core/runtime.cjs";
 import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput } from "./core/learning.cjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.cjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.cjs";
 import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.cjs";
 import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.cjs";
 import { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents } from "./runner/index.cjs";
@@ -17,6 +18,9 @@ import { CopilotCorsConfig } from "./core/fetch-cors.cjs";
 import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.cjs";
 import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.cjs";
 import "./endpoints/index.cjs";
+import { GenerativeUIMiddleware } from "./generative-ui/generative-ui-middleware.cjs";
+import { GenerativeUISurfaceWriter, createSurfaceWriter } from "./generative-ui/surface-writer.cjs";
+import "./generative-ui/index.cjs";
 import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./core/fetch-handler.cjs";
 import { MCPClient, MCPTransport } from "@ai-sdk/mcp";
 

package/dist/v2/runtime/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;KA2DY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgEY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}

package/dist/v2/runtime/index.d.mts

@@ -1,11 +1,12 @@
 
+import { experimental_d_exports } from "./intelligence-platform/experimental.mjs";
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.mjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, ThreadAlreadyRunningError, supportsLocalThreadEndpoints } from "./runner/agent-runner.mjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.mjs";
 import "./intelligence-platform/index.mjs";
 import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeMemoryConfig, CopilotRuntimeOptions, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, MemoryAccess, MemoryConsumer, MemoryGrant, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./core/runtime.mjs";
 import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput } from "./core/learning.mjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.mjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.mjs";
 import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.mjs";
 import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.mjs";
 import { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents } from "./runner/index.mjs";
@@ -17,6 +18,9 @@ import { CopilotCorsConfig } from "./core/fetch-cors.mjs";
 import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.mjs";
 import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.mjs";
 import "./endpoints/index.mjs";
+import { GenerativeUIMiddleware } from "./generative-ui/generative-ui-middleware.mjs";
+import { GenerativeUISurfaceWriter, createSurfaceWriter } from "./generative-ui/surface-writer.mjs";
+import "./generative-ui/index.mjs";
 import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./core/fetch-handler.mjs";
 import { MCPClient, MCPTransport } from "@ai-sdk/mcp";
 

package/dist/v2/runtime/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;KA2DY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgEY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}

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`);
@@ -1132,6 +1215,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);