@copilotkit/runtime 1.72.1-canary.sp-longthread-perf → 1.73.1

package/dist/agent/index.d.cts

@@ -1,10 +1,11 @@
 
+import { BuiltInAgentLearnedSkills, BuiltInAgentLearnedSkillsOptions } from "./learned-skills.cjs";
 import { convertAISDKStream } from "./converters/aisdk.cjs";
 import { TanStackChatMessage, TanStackInputResult, convertInputToTanStackAI, convertTanStackStream } from "./converters/tanstack.cjs";
-import { LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
-import { Observable } from "rxjs";
 import { InferSchemaOutput, ModelHostClass, StandardSchemaV1 } from "@copilotkit/shared";
 import { AbstractAgent, BaseEvent, Interrupt, Message, ResumeEntry, RunAgentInput } from "@ag-ui/client";
+import { Observable } from "rxjs";
+import { LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
 import { AgentCapabilities } from "@ag-ui/core";
 import { z } from "zod";
 import { StreamableHTTPClientTransportOptions } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
@@ -118,9 +119,8 @@ interface ToolDefinition<TParameters extends StandardSchemaV1 = StandardSchemaV1
    * When true, calling this tool pauses the run and emits a standard AG-UI
    * interrupt (RUN_FINISHED outcome:interrupt) keyed by the tool call's id.
    * The human response (resume payload) is injected as this tool call's result
-   * on the resume run. Interrupt tools must NOT define `execute`, and require
-   * the default `maxSteps: 1` — with `maxSteps > 1` the AI SDK's agentic loop
-   * would try to continue past the unexecuted tool call instead of pausing.
+   * on the resume run. Interrupt tools must NOT define `execute`. The AI SDK
+   * pauses when a tool call has no result, even with a multi-step limit.
    */
   interrupt?: boolean;
   /** Optional categorical reason surfaced on the Interrupt (default: "tool_call"). */
@@ -187,6 +187,8 @@ declare function convertToolDefinitionsToVercelAITools(tools: ToolDefinition[]):
  * Context passed to the user-supplied factory function in factory mode.
  */
 interface AgentFactoryContext {
+  /** Verified catalog and AI SDK tools for this run; empty when disabled or no skills exist. */
+  learnedSkills: BuiltInAgentLearnedSkills;
   input: RunAgentInput;
   /**
    * Prefer `abortSignal` for most use cases (AI SDK, fetch, custom backends).
@@ -205,12 +207,16 @@ interface AgentFactoryContext {
    */
   interrupt: (interrupts: Interrupt[]) => Promise<ResumeEntry[]>;
 }
+/** Public name that avoids the runtime's request-scoped AgentFactoryContext. */
+type BuiltInAgentFactoryContext = AgentFactoryContext;
 /**
  * Factory config for AI SDK backend.
  * The factory must return an object with a `fullStream` async iterable
  * (compatible with the result of `streamText()` — only `fullStream` is consumed).
  */
 interface BuiltInAgentAISDKFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "aisdk";
   factory: (ctx: AgentFactoryContext) => {
     fullStream: AsyncIterable<unknown>;
@@ -223,6 +229,8 @@ interface BuiltInAgentAISDKFactoryConfig {
  * The factory must return an async iterable of TanStack AI stream chunks.
  */
 interface BuiltInAgentTanStackFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "tanstack";
   factory: (ctx: AgentFactoryContext) => AsyncIterable<unknown> | Promise<AsyncIterable<unknown>>;
 }
@@ -230,6 +238,8 @@ interface BuiltInAgentTanStackFactoryConfig {
  * Factory config for a custom backend that directly yields AG-UI events.
  */
 interface BuiltInAgentCustomFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "custom";
   factory: (ctx: AgentFactoryContext) => AsyncIterable<BaseEvent> | Promise<AsyncIterable<BaseEvent>>;
 }
@@ -241,6 +251,8 @@ type BuiltInAgentFactoryConfig = BuiltInAgentAISDKFactoryConfig | BuiltInAgentTa
  * Classic config — BuiltInAgent handles streamText, tools, MCP, state tools, prompt building.
  */
 interface BuiltInAgentClassicConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   /**
    * The model to use
    */
@@ -255,7 +267,7 @@ interface BuiltInAgentClassicConfig {
    */
   apiKey?: string;
   /**
-   * Maximum number of steps/iterations for tool calling (default: 1)
+   * Maximum number of steps/iterations for tool calling (default: 1, or 10 when learned skills are available)
    */
   maxSteps?: number;
   /**
@@ -362,6 +374,7 @@ type BuiltInAgentConfiguration = BuiltInAgentClassicConfig | BuiltInAgentFactory
 declare class BuiltInAgent extends AbstractAgent {
   private config;
   private abortController?;
+  private skillRegistry?;
   /**
    * Which vendor this agent's configured model reaches. Read by the SSE layer
    * onto `agent_execution_stream_*` telemetry.
@@ -396,5 +409,5 @@ declare class BasicAgent extends BuiltInAgent {
 /** @deprecated Use BuiltInAgentClassicConfig instead */
 type BasicAgentConfiguration = BuiltInAgentClassicConfig;
 //#endregion
-export { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, classifyModelSpec, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
+export { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentFactoryContext, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, classifyModelSpec, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
 //# sourceMappingURL=index.d.cts.map

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

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

package/dist/agent/index.d.mts

@@ -1,12 +1,13 @@
 
+import { BuiltInAgentLearnedSkills, BuiltInAgentLearnedSkillsOptions } from "./learned-skills.mjs";
 import { convertAISDKStream } from "./converters/aisdk.mjs";
 import { TanStackChatMessage, TanStackInputResult, convertInputToTanStackAI, convertTanStackStream } from "./converters/tanstack.mjs";
 import "./converters/index.mjs";
 import { InferSchemaOutput, ModelHostClass, StandardSchemaV1 } from "@copilotkit/shared";
 import { Observable } from "rxjs";
 import { AbstractAgent, BaseEvent, Interrupt, Message, ResumeEntry, RunAgentInput } from "@ag-ui/client";
-import { z } from "zod";
 import { LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
+import { z } from "zod";
 import { StreamableHTTPClientTransportOptions } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { AgentCapabilities } from "@ag-ui/core";
 
@@ -119,9 +120,8 @@ interface ToolDefinition<TParameters extends StandardSchemaV1 = StandardSchemaV1
    * When true, calling this tool pauses the run and emits a standard AG-UI
    * interrupt (RUN_FINISHED outcome:interrupt) keyed by the tool call's id.
    * The human response (resume payload) is injected as this tool call's result
-   * on the resume run. Interrupt tools must NOT define `execute`, and require
-   * the default `maxSteps: 1` — with `maxSteps > 1` the AI SDK's agentic loop
-   * would try to continue past the unexecuted tool call instead of pausing.
+   * on the resume run. Interrupt tools must NOT define `execute`. The AI SDK
+   * pauses when a tool call has no result, even with a multi-step limit.
    */
   interrupt?: boolean;
   /** Optional categorical reason surfaced on the Interrupt (default: "tool_call"). */
@@ -188,6 +188,8 @@ declare function convertToolDefinitionsToVercelAITools(tools: ToolDefinition[]):
  * Context passed to the user-supplied factory function in factory mode.
  */
 interface AgentFactoryContext {
+  /** Verified catalog and AI SDK tools for this run; empty when disabled or no skills exist. */
+  learnedSkills: BuiltInAgentLearnedSkills;
   input: RunAgentInput;
   /**
    * Prefer `abortSignal` for most use cases (AI SDK, fetch, custom backends).
@@ -206,12 +208,16 @@ interface AgentFactoryContext {
    */
   interrupt: (interrupts: Interrupt[]) => Promise<ResumeEntry[]>;
 }
+/** Public name that avoids the runtime's request-scoped AgentFactoryContext. */
+type BuiltInAgentFactoryContext = AgentFactoryContext;
 /**
  * Factory config for AI SDK backend.
  * The factory must return an object with a `fullStream` async iterable
  * (compatible with the result of `streamText()` — only `fullStream` is consumed).
  */
 interface BuiltInAgentAISDKFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "aisdk";
   factory: (ctx: AgentFactoryContext) => {
     fullStream: AsyncIterable<unknown>;
@@ -224,6 +230,8 @@ interface BuiltInAgentAISDKFactoryConfig {
  * The factory must return an async iterable of TanStack AI stream chunks.
  */
 interface BuiltInAgentTanStackFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "tanstack";
   factory: (ctx: AgentFactoryContext) => AsyncIterable<unknown> | Promise<AsyncIterable<unknown>>;
 }
@@ -231,6 +239,8 @@ interface BuiltInAgentTanStackFactoryConfig {
  * Factory config for a custom backend that directly yields AG-UI events.
  */
 interface BuiltInAgentCustomFactoryConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   type: "custom";
   factory: (ctx: AgentFactoryContext) => AsyncIterable<BaseEvent> | Promise<AsyncIterable<BaseEvent>>;
 }
@@ -242,6 +252,8 @@ type BuiltInAgentFactoryConfig = BuiltInAgentAISDKFactoryConfig | BuiltInAgentTa
  * Classic config — BuiltInAgent handles streamText, tools, MCP, state tools, prompt building.
  */
 interface BuiltInAgentClassicConfig {
+  /** Opt in to automatic snapshot acquisition before each run, including resumes. */
+  learnedSkills?: BuiltInAgentLearnedSkillsOptions;
   /**
    * The model to use
    */
@@ -256,7 +268,7 @@ interface BuiltInAgentClassicConfig {
    */
   apiKey?: string;
   /**
-   * Maximum number of steps/iterations for tool calling (default: 1)
+   * Maximum number of steps/iterations for tool calling (default: 1, or 10 when learned skills are available)
    */
   maxSteps?: number;
   /**
@@ -363,6 +375,7 @@ type BuiltInAgentConfiguration = BuiltInAgentClassicConfig | BuiltInAgentFactory
 declare class BuiltInAgent extends AbstractAgent {
   private config;
   private abortController?;
+  private skillRegistry?;
   /**
    * Which vendor this agent's configured model reaches. Read by the SSE layer
    * onto `agent_execution_stream_*` telemetry.
@@ -397,5 +410,5 @@ declare class BasicAgent extends BuiltInAgent {
 /** @deprecated Use BuiltInAgentClassicConfig instead */
 type BasicAgentConfiguration = BuiltInAgentClassicConfig;
 //#endregion
-export { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, classifyModelSpec, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
+export { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentFactoryContext, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, classifyModelSpec, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
 //# sourceMappingURL=index.d.mts.map

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

@@ -3,18 +3,20 @@ import { createStateEventNormalizer } from "./state-delta.mjs";
 import { collectStandardRunFinishedDetails, getNonEmptyString, isRecord } from "./converters/usage.mjs";
 import { convertAISDKStream, getAISDKRunFinishedDetails } from "./converters/aisdk.mjs";
 import { convertInputToTanStackAI, convertTanStackStream } from "./converters/tanstack.mjs";
+import { SkillRegistry } from "../v2/runtime/intelligence-platform/skill-registry/registry.mjs";
+import { assertNoSkillToolConflicts, prepareLearnedSkills } from "./learned-skills.mjs";
 import { createOpenAI } from "@ai-sdk/openai";
 import { classifyModelHost, randomUUID, safeParseToolArgs, schemaToJsonSchema } from "@copilotkit/shared";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { Observable } from "rxjs";
 import { AbstractAgent, EventType } from "@ag-ui/client";
-import { z } from "zod";
 import { RENDER_A2UI_TOOL } from "@ag-ui/a2ui-middleware";
 import { Validator } from "@cfworker/json-schema";
 import { jsonSchema, stepCountIs, streamText, tool } from "ai";
 import { createMCPClient } from "@ai-sdk/mcp";
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { createVertex } from "@ai-sdk/google-vertex";
+import { z } from "zod";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 
 //#region src/agent/index.ts
@@ -419,6 +421,7 @@ var BuiltInAgent = class BuiltInAgent extends AbstractAgent {
 	constructor(config) {
 		super();
 		this.config = config;
+		this.skillRegistry = config.learnedSkills === void 0 ? void 0 : new SkillRegistry(config.learnedSkills);
 		this.modelHostClass = isFactoryConfig(config) ? "unknown" : classifyModelSpec(config.model);
 	}
 	/**
@@ -583,6 +586,15 @@ This is state from the application that you can edit by calling AGUISendStateSna
 					subscriber.next(reasoningEnd);
 				};
 				try {
+					const learnedSkills = await prepareLearnedSkills(this.skillRegistry, abortController.signal);
+					abortController.signal.throwIfAborted();
+					if (learnedSkills.catalog) {
+						messages.unshift({
+							role: "system",
+							content: learnedSkills.catalog
+						});
+						if (config.maxSteps === void 0) streamTextParams.stopWhen = stepCountIs(10);
+					}
 					streamTextParams.tools = {
 						...streamTextParams.tools,
 						AGUISendStateSnapshot: tool({
@@ -616,6 +628,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 					};
 					if (config.mcpClients && config.mcpClients.length > 0) for (const client of config.mcpClients) {
 						const mcpTools = await client.tools();
+						abortController.signal.throwIfAborted();
 						streamTextParams.tools = {
 							...streamTextParams.tools,
 							...mcpTools
@@ -627,6 +640,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						if (serverConfig.type === "http") transport = new StreamableHTTPClientTransport(new URL(serverConfig.url), serverConfig.options);
 						else if (serverConfig.type === "sse") {
 							const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+							abortController.signal.throwIfAborted();
 							transport = new SSEClientTransport(new URL(serverConfig.url), serverConfig.headers ? { requestInit: { headers: serverConfig.headers } } : void 0);
 						}
 						if (transport) {
@@ -634,21 +648,36 @@ This is state from the application that you can edit by calling AGUISendStateSna
 							try {
 								mcpClient = await createMCPClient({ transport });
 							} catch (err) {
+								abortController.signal.throwIfAborted();
 								console.error(`[CopilotKit] MCP server ${serverConfig.url} failed to connect — skipping it for this run:`, err);
 								continue;
 							}
+							if (abortController.signal.aborted) {
+								await mcpClient.close();
+								abortController.signal.throwIfAborted();
+							}
 							mcpClients.push(mcpClient);
 							try {
 								const mcpTools = await mcpClient.tools();
+								abortController.signal.throwIfAborted();
 								streamTextParams.tools = {
 									...streamTextParams.tools,
 									...mcpTools
 								};
 							} catch (err) {
+								abortController.signal.throwIfAborted();
 								console.error(`[CopilotKit] MCP server ${serverConfig.url} tools() failed — skipping its tools for this run:`, err);
 							}
 						}
 					}
+					if (this.skillRegistry) {
+						assertNoSkillToolConflicts(streamTextParams.tools ?? {});
+						streamTextParams.tools = {
+							...streamTextParams.tools,
+							...learnedSkills.tools
+						};
+					}
+					abortController.signal.throwIfAborted();
 					const response = streamText({
 						...streamTextParams,
 						abortSignal: abortController.signal
@@ -925,11 +954,13 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						subscriber.error(error);
 					}
 				} finally {
-					this.abortController = void 0;
+					if (this.abortController === abortController) this.abortController = void 0;
 					await Promise.all(mcpClients.map((client) => client.close()));
 				}
 			})();
 			return () => {
+				abortController.abort();
+				if (this.abortController === abortController) this.abortController = void 0;
 				Promise.all(mcpClients.map((client) => client.close())).catch(() => {});
 			};
 		});
@@ -968,13 +999,16 @@ This is state from the application that you can edit by calling AGUISendStateSna
 				...input,
 				messages: [...input.messages, ...resumeToolMessages]
 			} : input;
-			const factoryCtx = {
-				...ctx,
-				input: factoryInput
-			};
 			(async () => {
 				const runFinishedDetails = {};
 				try {
+					const learnedSkills = await prepareLearnedSkills(this.skillRegistry, controller.signal);
+					controller.signal.throwIfAborted();
+					const factoryCtx = {
+						...ctx,
+						input: factoryInput,
+						learnedSkills
+					};
 					let events;
 					let customRunFinishedEvent;
 					const pendingInterrupts = [];
@@ -986,7 +1020,7 @@ This is state from the application that you can edit by calling AGUISendStateSna
 							events = convertTanStackStream(await config.factory(factoryCtx), controller.signal, pendingInterrupts, input.state, runFinishedDetails);
 							break;
 						case "custom":
-							events = await config.factory(ctx);
+							events = await config.factory(factoryCtx);
 							break;
 						default: {
 							const _exhaustive = config;
@@ -1039,16 +1073,22 @@ This is state from the application that you can edit by calling AGUISendStateSna
 						subscriber.error(error);
 					}
 				} finally {
-					this.abortController = void 0;
+					if (this.abortController === controller) this.abortController = void 0;
 				}
 			})();
 			return () => {
 				controller.abort();
+				if (this.abortController === controller) this.abortController = void 0;
 			};
 		});
 	}
 	clone() {
-		const cloned = new BuiltInAgent(this.config);
+		const cloned = new BuiltInAgent({
+			...this.config,
+			learnedSkills: void 0
+		});
+		cloned.config = this.config;
+		cloned.skillRegistry = this.skillRegistry;
 		cloned.middlewares = [...this.middlewares];
 		return cloned;
 	}