@copilotkit/runtime 1.61.1 → 1.62.0

package/dist/agent/index.d.mts.map

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

package/dist/agent/index.mjs

@@ -41,6 +41,18 @@ function resolveModel(spec, apiKey) {
 	}
 }
 /**
+* Thrown by `AgentFactoryContext.interrupt()` on a fresh (non-resume) run to
+* pause the factory. Caught in `runFactory` and translated into a RUN_FINISHED
+* event carrying `outcome:{type:"interrupt",interrupts}`. Not a real error.
+*/
+var InterruptSignal = class extends Error {
+	constructor(interrupts) {
+		super("CopilotKit interrupt: run paused awaiting human input");
+		this.interrupts = interrupts;
+		this.name = "InterruptSignal";
+	}
+};
+/**
 * Define a tool for use with BuiltInAgent
 * @param name - The name of the tool
 * @param description - Description of what the tool does
@@ -53,7 +65,10 @@ function defineTool(config) {
 		name: config.name,
 		description: config.description,
 		parameters: config.parameters,
-		execute: config.execute
+		execute: config.execute,
+		interrupt: config.interrupt,
+		interruptReason: config.interruptReason,
+		interruptMessage: config.interruptMessage
 	};
 }
 /**
@@ -269,6 +284,19 @@ function isJsonSchema(obj) {
 		"array"
 	].includes(schema.type);
 }
+/**
+* Type-only pass-through for handing a Zod schema to the AI SDK's `tool()`.
+* The raw Zod schema is returned unchanged at runtime — the SDK's `asSchema()`
+* converts and validates it internally exactly as before.
+*
+* The Zod type is erased through `unknown` deliberately: letting tsc relate
+* Zod schema types to the AI SDK's `FlexibleSchema` union (conditional types
+* spanning zod v3/v4) makes type instantiation explode (TS2589 / compiler
+* OOM) under this package's `moduleResolution: node`.
+*/
+function toLanguageModelSchema(schema) {
+	return schema;
+}
 function convertToolsToVercelAITools(tools) {
 	const result = {};
 	for (const tool$1 of tools) {
@@ -276,7 +304,7 @@ function convertToolsToVercelAITools(tools) {
 		const zodSchema = convertJsonSchemaToZodSchema$1(tool$1.parameters, true);
 		result[tool$1.name] = tool({
 			description: tool$1.description,
-			inputSchema: zodSchema
+			inputSchema: toLanguageModelSchema(zodSchema)
 		});
 	}
 	return result;
@@ -335,16 +363,19 @@ var BuiltInAgent = class BuiltInAgent extends AbstractAgent {
 				supported: true,
 				clientProvided: true
 			},
-			transport: { streaming: true }
+			transport: { streaming: true },
+			humanInTheLoop: { interrupts: true }
 		};
-		if (!this.config.capabilities) return inferred;
+		const capabilities = isFactoryConfig(this.config) ? void 0 : this.config.capabilities;
+		if (!capabilities) return inferred;
 		return {
 			...inferred,
-			...this.config.capabilities
+			...capabilities
 		};
 	}
 	run(input) {
 		if (isFactoryConfig(this.config)) return this.runFactory(input, this.config);
+		const config = this.config;
 		if (this.abortController) throw new Error("Agent is already running. Call abortRun() first or create a new instance.");
 		this.abortController = new AbortController();
 		const abortController = this.abortController;
@@ -355,14 +386,14 @@ var BuiltInAgent = class BuiltInAgent extends AbstractAgent {
 				runId: input.runId
 			};
 			subscriber.next(startEvent);
-			const model = resolveModel(this.config.model, this.config.apiKey);
+			const model = resolveModel(config.model, config.apiKey);
 			let systemPrompt = void 0;
-			const hasPrompt = !!this.config.prompt;
+			const hasPrompt = !!config.prompt;
 			const hasContext = input.context && input.context.length > 0;
 			const hasState = input.state !== void 0 && input.state !== null && !(typeof input.state === "object" && Object.keys(input.state).length === 0);
 			if (hasPrompt || hasContext || hasState) {
 				const parts = [];
-				if (hasPrompt) parts.push(this.config.prompt);
+				if (hasPrompt) parts.push(config.prompt);
 				if (hasContext) {
 					parts.push("\n## Context from the application\n");
 					for (const ctx of input.context) parts.push(`${ctx.description}:\n${ctx.value}\n`);
@@ -374,16 +405,46 @@ This is state from the application that you can edit by calling AGUISendStateSna
 				systemPrompt = parts.join("");
 			}
 			const messages = convertMessagesToVercelAISDKMessages(input.messages, {
-				forwardSystemMessages: this.config.forwardSystemMessages,
-				forwardDeveloperMessages: this.config.forwardDeveloperMessages
+				forwardSystemMessages: config.forwardSystemMessages,
+				forwardDeveloperMessages: config.forwardDeveloperMessages
 			});
 			if (systemPrompt) messages.unshift({
 				role: "system",
 				content: systemPrompt
 			});
+			const resumeEntries = input.resume ?? [];
+			if (resumeEntries.length > 0) {
+				const toolNameById = /* @__PURE__ */ new Map();
+				for (const m of input.messages) {
+					if (m.role !== "assistant") continue;
+					for (const tc of m.toolCalls ?? []) if (tc.id && tc.function?.name) toolNameById.set(tc.id, tc.function.name);
+				}
+				const alreadyAnswered = /* @__PURE__ */ new Set();
+				for (const m of messages) {
+					if (m.role !== "tool" || !Array.isArray(m.content)) continue;
+					for (const part of m.content) if (part && typeof part === "object" && "toolCallId" in part) alreadyAnswered.add(part.toolCallId);
+				}
+				for (const entry of resumeEntries) {
+					if (alreadyAnswered.has(entry.interruptId)) continue;
+					const value = entry.status === "cancelled" ? { status: "cancelled" } : entry.payload ?? { status: "resolved" };
+					const toolResultMessage = {
+						role: "tool",
+						content: [{
+							type: "tool-result",
+							toolCallId: entry.interruptId,
+							toolName: toolNameById.get(entry.interruptId) ?? "",
+							output: {
+								type: "json",
+								value
+							}
+						}]
+					};
+					messages.push(toolResultMessage);
+				}
+			}
 			let allTools = convertToolsToVercelAITools(input.tools);
-			if (this.config.tools && this.config.tools.length > 0) {
-				const configTools = convertToolDefinitionsToVercelAITools(this.config.tools);
+			if (config.tools && config.tools.length > 0) {
+				const configTools = convertToolDefinitionsToVercelAITools(config.tools);
 				allTools = {
 					...allTools,
 					...configTools
@@ -393,23 +454,23 @@ This is state from the application that you can edit by calling AGUISendStateSna
 				model,
 				messages,
 				tools: allTools,
-				toolChoice: this.config.toolChoice,
-				stopWhen: this.config.maxSteps ? stepCountIs(this.config.maxSteps) : void 0,
-				maxOutputTokens: this.config.maxOutputTokens,
-				temperature: this.config.temperature,
-				topP: this.config.topP,
-				topK: this.config.topK,
-				presencePenalty: this.config.presencePenalty,
-				frequencyPenalty: this.config.frequencyPenalty,
-				stopSequences: this.config.stopSequences,
-				seed: this.config.seed,
-				providerOptions: this.config.providerOptions,
-				maxRetries: this.config.maxRetries
+				toolChoice: config.toolChoice,
+				stopWhen: config.maxSteps ? stepCountIs(config.maxSteps) : void 0,
+				maxOutputTokens: config.maxOutputTokens,
+				temperature: config.temperature,
+				topP: config.topP,
+				topK: config.topK,
+				presencePenalty: config.presencePenalty,
+				frequencyPenalty: config.frequencyPenalty,
+				stopSequences: config.stopSequences,
+				seed: config.seed,
+				providerOptions: config.providerOptions,
+				maxRetries: config.maxRetries
 			};
 			if (input.forwardedProps && typeof input.forwardedProps === "object") {
 				const props = input.forwardedProps;
 				if (props.model !== void 0 && this.canOverride("model")) {
-					if (typeof props.model === "string" || typeof props.model === "object") streamTextParams.model = resolveModel(props.model, this.config.apiKey);
+					if (typeof props.model === "string" || typeof props.model === "object") streamTextParams.model = resolveModel(props.model, config.apiKey);
 				}
 				if (props.toolChoice !== void 0 && this.canOverride("toolChoice")) {
 					const toolChoice = props.toolChoice;
@@ -455,7 +516,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						...streamTextParams.tools,
 						AGUISendStateSnapshot: tool({
 							description: "Replace the entire application state with a new snapshot",
-							inputSchema: z.object({ snapshot: z.any().describe("The complete new state object") }),
+							inputSchema: toLanguageModelSchema(z.object({ snapshot: z.any().describe("The complete new state object") })),
 							execute: async ({ snapshot }) => {
 								return {
 									success: true,
@@ -465,7 +526,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						}),
 						AGUISendStateDelta: tool({
 							description: "Apply incremental updates to application state using JSON Patch operations",
-							inputSchema: z.object({ delta: z.array(z.object({
+							inputSchema: toLanguageModelSchema(z.object({ delta: z.array(z.object({
 								op: z.enum([
 									"add",
 									"replace",
@@ -473,7 +534,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 								]).describe("The operation to perform"),
 								path: z.string().describe("JSON Pointer path (e.g., '/foo/bar')"),
 								value: z.any().optional().describe("The value to set. Required for 'add' and 'replace' operations, ignored for 'remove'.")
-							})).describe("Array of JSON Patch operations") }),
+							})).describe("Array of JSON Patch operations") })),
 							execute: async ({ delta }) => {
 								return {
 									success: true,
@@ -482,14 +543,14 @@ This is state from the application that you can edit by calling AGUISendStateSna
 							}
 						})
 					};
-					if (this.config.mcpClients && this.config.mcpClients.length > 0) for (const client of this.config.mcpClients) {
+					if (config.mcpClients && config.mcpClients.length > 0) for (const client of config.mcpClients) {
 						const mcpTools = await client.tools();
 						streamTextParams.tools = {
 							...streamTextParams.tools,
 							...mcpTools
 						};
 					}
-					const allMcpServers = [...this.config.mcpServers ?? []];
+					const allMcpServers = [...config.mcpServers ?? []];
 					if (allMcpServers.length > 0) for (const serverConfig of allMcpServers) {
 						let transport;
 						if (serverConfig.type === "http") transport = new StreamableHTTPClientTransport(new URL(serverConfig.url), serverConfig.options);
@@ -518,6 +579,12 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						...streamTextParams,
 						abortSignal: abortController.signal
 					});
+					const interruptToolNames = new Set((isFactoryConfig(this.config) ? [] : this.config.tools ?? []).filter((t) => t.interrupt).map((t) => t.name));
+					const interruptToolMeta = new Map((isFactoryConfig(this.config) ? [] : this.config.tools ?? []).filter((t) => t.interrupt).map((t) => [t.name, {
+						reason: t.interruptReason ?? "tool_call",
+						message: t.interruptMessage
+					}]));
+					const pendingInterrupts = [];
 					const toolCallStates = /* @__PURE__ */ new Map();
 					const ensureToolCallState = (toolCallId) => {
 						let state = toolCallStates.get(toolCallId);
@@ -659,11 +726,25 @@ This is state from the application that you can edit by calling AGUISendStateSna
 									};
 									subscriber.next(endEvent);
 								}
+								if (state.toolName && interruptToolNames.has(state.toolName)) {
+									const meta = interruptToolMeta.get(state.toolName);
+									pendingInterrupts.push({
+										id: toolCallId,
+										toolCallId,
+										reason: meta?.reason ?? "tool_call",
+										...meta?.message ? { message: meta.message } : {}
+									});
+								}
 								break;
 							}
 							case "tool-result": {
-								const toolResult = "output" in part ? part.output : "result" in part ? part.result : null;
-								const toolName = "toolName" in part ? part.toolName : "";
+								const toolName = "toolName" in part && part.toolName || toolCallStates.get(part.toolCallId)?.toolName || "";
+								if (toolName && interruptToolNames.has(toolName)) {
+									toolCallStates.delete(part.toolCallId);
+									break;
+								}
+								const legacyPart = part;
+								const toolResult = "output" in part ? part.output : "result" in legacyPart ? legacyPart.result : null;
 								toolCallStates.delete(part.toolCallId);
 								if (toolName === "AGUISendStateSnapshot" && toolResult && typeof toolResult === "object") {
 									const snapshot = toolResult.snapshot;
@@ -704,7 +785,11 @@ This is state from the application that you can edit by calling AGUISendStateSna
 								const finishedEvent = {
 									type: EventType.RUN_FINISHED,
 									threadId: input.threadId,
-									runId: input.runId
+									runId: input.runId,
+									...pendingInterrupts.length > 0 ? { outcome: {
+										type: "interrupt",
+										interrupts: pendingInterrupts
+									} } : {}
 								};
 								subscriber.next(finishedEvent);
 								terminalEventEmitted = true;
@@ -713,7 +798,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 							}
 							case "error": {
 								if (abortController.signal.aborted) break;
-								const err = part.error ?? part.message ?? part.cause;
+								const err = part.error ?? ("message" in part ? part.message : void 0) ?? ("cause" in part ? part.cause : void 0);
 								const runErrorEvent = {
 									type: EventType.RUN_ERROR,
 									message: err instanceof Error ? err.message : typeof err === "string" ? err : `AI SDK stream error: ${JSON.stringify(part)}`,
@@ -734,7 +819,11 @@ This is state from the application that you can edit by calling AGUISendStateSna
 							const finishedEvent = {
 								type: EventType.RUN_FINISHED,
 								threadId: input.threadId,
-								runId: input.runId
+								runId: input.runId,
+								...pendingInterrupts.length > 0 ? { outcome: {
+									type: "interrupt",
+									interrupts: pendingInterrupts
+								} } : {}
 							};
 							subscriber.next(finishedEvent);
 						}
@@ -779,17 +868,40 @@ This is state from the application that you can edit by calling AGUISendStateSna
 			const ctx = {
 				input,
 				abortController: controller,
-				abortSignal: controller.signal
+				abortSignal: controller.signal,
+				interrupt: async (interrupts) => {
+					const resume = input.resume ?? [];
+					const ids = new Set(interrupts.map((i) => i.id));
+					const matching = resume.filter((r) => ids.has(r.interruptId));
+					if (interrupts.length > 0 && matching.length === interrupts.length) return matching;
+					throw new InterruptSignal(interrupts);
+				}
+			};
+			const answeredToolCallIds = new Set(input.messages.filter((m) => m.role === "tool").map((m) => m.toolCallId).filter((id) => typeof id === "string"));
+			const resumeToolMessages = (input.resume ?? []).filter((entry) => !answeredToolCallIds.has(entry.interruptId)).map((entry) => ({
+				id: randomUUID(),
+				role: "tool",
+				toolCallId: entry.interruptId,
+				content: JSON.stringify(entry.status === "cancelled" ? { status: "cancelled" } : entry.payload ?? { status: "resolved" })
+			}));
+			const factoryInput = resumeToolMessages.length > 0 && config.type !== "custom" ? {
+				...input,
+				messages: [...input.messages, ...resumeToolMessages]
+			} : input;
+			const factoryCtx = {
+				...ctx,
+				input: factoryInput
 			};
 			(async () => {
 				try {
 					let events;
+					const pendingInterrupts = [];
 					switch (config.type) {
 						case "aisdk":
-							events = convertAISDKStream((await config.factory(ctx)).fullStream, controller.signal);
+							events = convertAISDKStream((await config.factory(factoryCtx)).fullStream, controller.signal, pendingInterrupts);
 							break;
 						case "tanstack":
-							events = convertTanStackStream(await config.factory(ctx), controller.signal);
+							events = convertTanStackStream(await config.factory(factoryCtx), controller.signal, pendingInterrupts);
 							break;
 						case "custom":
 							events = await config.factory(ctx);
@@ -800,6 +912,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						}
 					}
 					for await (const event of events) subscriber.next(event);
+					if (pendingInterrupts.length > 0 && !controller.signal.aborted) throw new InterruptSignal(pendingInterrupts);
 					if (!controller.signal.aborted) {
 						const finishedEvent = {
 							type: EventType.RUN_FINISHED,
@@ -810,7 +923,19 @@ This is state from the application that you can edit by calling AGUISendStateSna
 					}
 					subscriber.complete();
 				} catch (error) {
-					if (controller.signal.aborted) subscriber.complete();
+					if (error instanceof InterruptSignal) {
+						const finishedEvent = {
+							type: EventType.RUN_FINISHED,
+							threadId: input.threadId,
+							runId: input.runId,
+							outcome: {
+								type: "interrupt",
+								interrupts: error.interrupts
+							}
+						};
+						subscriber.next(finishedEvent);
+						subscriber.complete();
+					} else if (controller.signal.aborted) subscriber.complete();
 					else {
 						const runErrorEvent = {
 							type: EventType.RUN_ERROR,
@@ -850,5 +975,5 @@ var BasicAgent = class extends BuiltInAgent {
 };
 
 //#endregion
-export { BasicAgent, BuiltInAgent, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
+export { BasicAgent, BuiltInAgent, InterruptSignal, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
 //# sourceMappingURL=index.mjs.map