@copilotkit/runtime 1.72.0 → 1.73.0

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, StandardSchemaV1 } from "@copilotkit/shared";
+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";
@@ -73,6 +74,26 @@ interface MCPClientProvider {
  * @returns LanguageModel instance
  */
 declare function resolveModel(spec: ModelSpecifier, apiKey?: string): LanguageModel;
+/**
+ * Which vendor a model specifier will actually reach, as a closed vocabulary.
+ *
+ * `resolveModel` above is the only place this runtime builds a provider, so it
+ * is the only place that knows the endpoint. Once built, the endpoint is gone:
+ * an AI SDK model reports `provider: "openai.responses"` whether it points at
+ * api.openai.com, Azure, OpenRouter or a laptop, and its base URL survives
+ * only inside a closure that the public `LanguageModelV3` type does not
+ * expose. Azure's own migration guide tells customers to use that same OpenAI
+ * client, so the case we are blindest to is the common one.
+ *
+ * A caller who hands us an already-built LanguageModel gets `unknown`. Nobody
+ * can recover the host from it, and saying so is more useful than guessing
+ * `openai` from a provider label that means only "speaks the OpenAI wire".
+ *
+ * The branches below mirror `resolveModel`'s switch and must change with it.
+ * `model-host-class.test.ts` walks every provider that switch accepts and
+ * fails if one lands here as `unknown`.
+ */
+declare function classifyModelSpec(spec: ModelSpecifier): ModelHostClass;
 /**
  * Thrown by `AgentFactoryContext.interrupt()` on a fresh (non-resume) run to
  * pause the factory. Caught in `runFactory` and translated into a RUN_FINISHED
@@ -98,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"). */
@@ -167,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).
@@ -185,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>;
@@ -203,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>>;
 }
@@ -210,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>>;
 }
@@ -221,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
    */
@@ -235,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;
   /**
@@ -342,6 +374,21 @@ 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.
+   *
+   * Computed once, from the configured model, because that is what holds for
+   * the agent's lifetime. A per-request `forwardedProps.model` override
+   * (handled further down in `run`) can point somewhere else for one run and
+   * is not reflected here — overrides are rare and the field describes the
+   * agent, not the call.
+   *
+   * Factory-mode configs own their own LLM call, so there is no model for us
+   * to classify.
+   */
+  readonly modelHostClass: ModelHostClass;
   constructor(config: BuiltInAgentConfiguration);
   /**
    * Check if a property can be overridden by forwardedProps
@@ -362,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, 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,8 +1,9 @@
 
+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, StandardSchemaV1 } from "@copilotkit/shared";
+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";
@@ -74,6 +75,26 @@ interface MCPClientProvider {
  * @returns LanguageModel instance
  */
 declare function resolveModel(spec: ModelSpecifier, apiKey?: string): LanguageModel;
+/**
+ * Which vendor a model specifier will actually reach, as a closed vocabulary.
+ *
+ * `resolveModel` above is the only place this runtime builds a provider, so it
+ * is the only place that knows the endpoint. Once built, the endpoint is gone:
+ * an AI SDK model reports `provider: "openai.responses"` whether it points at
+ * api.openai.com, Azure, OpenRouter or a laptop, and its base URL survives
+ * only inside a closure that the public `LanguageModelV3` type does not
+ * expose. Azure's own migration guide tells customers to use that same OpenAI
+ * client, so the case we are blindest to is the common one.
+ *
+ * A caller who hands us an already-built LanguageModel gets `unknown`. Nobody
+ * can recover the host from it, and saying so is more useful than guessing
+ * `openai` from a provider label that means only "speaks the OpenAI wire".
+ *
+ * The branches below mirror `resolveModel`'s switch and must change with it.
+ * `model-host-class.test.ts` walks every provider that switch accepts and
+ * fails if one lands here as `unknown`.
+ */
+declare function classifyModelSpec(spec: ModelSpecifier): ModelHostClass;
 /**
  * Thrown by `AgentFactoryContext.interrupt()` on a fresh (non-resume) run to
  * pause the factory. Caught in `runFactory` and translated into a RUN_FINISHED
@@ -99,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"). */
@@ -168,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).
@@ -186,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>;
@@ -204,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>>;
 }
@@ -211,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>>;
 }
@@ -222,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
    */
@@ -236,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;
   /**
@@ -343,6 +375,21 @@ 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.
+   *
+   * Computed once, from the configured model, because that is what holds for
+   * the agent's lifetime. A per-request `forwardedProps.model` override
+   * (handled further down in `run`) can point somewhere else for one run and
+   * is not reflected here — overrides are rare and the field describes the
+   * agent, not the call.
+   *
+   * Factory-mode configs own their own LLM call, so there is no model for us
+   * to classify.
+   */
+  readonly modelHostClass: ModelHostClass;
   constructor(config: BuiltInAgentConfiguration);
   /**
    * Check if a property can be overridden by forwardedProps
@@ -363,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, 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,8 +3,10 @@ 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 { randomUUID, safeParseToolArgs, schemaToJsonSchema } from "@copilotkit/shared";
+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";
@@ -58,6 +60,38 @@ function resolveModel(spec, apiKey) {
 	}
 }
 /**
+* Which vendor a model specifier will actually reach, as a closed vocabulary.
+*
+* `resolveModel` above is the only place this runtime builds a provider, so it
+* is the only place that knows the endpoint. Once built, the endpoint is gone:
+* an AI SDK model reports `provider: "openai.responses"` whether it points at
+* api.openai.com, Azure, OpenRouter or a laptop, and its base URL survives
+* only inside a closure that the public `LanguageModelV3` type does not
+* expose. Azure's own migration guide tells customers to use that same OpenAI
+* client, so the case we are blindest to is the common one.
+*
+* A caller who hands us an already-built LanguageModel gets `unknown`. Nobody
+* can recover the host from it, and saying so is more useful than guessing
+* `openai` from a provider label that means only "speaks the OpenAI wire".
+*
+* The branches below mirror `resolveModel`'s switch and must change with it.
+* `model-host-class.test.ts` walks every provider that switch accepts and
+* fails if one lands here as `unknown`.
+*/
+function classifyModelSpec(spec) {
+	if (typeof spec !== "string") return "unknown";
+	switch (spec.replace("/", ":").trim().split(":")[0]?.toLowerCase()) {
+		case "openai": return classifyModelHost(process.env.OPENAI_BASE_URL, "openai");
+		case "anthropic": return classifyModelHost(process.env.ANTHROPIC_BASE_URL, "anthropic");
+		case "google":
+		case "gemini":
+		case "google-gemini": return classifyModelHost(process.env.GOOGLE_GENERATIVE_AI_BASE_URL, "google");
+		case "minimax": return classifyModelHost(process.env.MINIMAX_BASE_URL || "https://api.minimax.io/v1", "minimax");
+		case "vertex": return "vertex";
+		default: return "unknown";
+	}
+}
+/**
 * 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.
@@ -387,6 +421,8 @@ 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);
 	}
 	/**
 	* Check if a property can be overridden by forwardedProps
@@ -550,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({
@@ -583,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
@@ -594,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) {
@@ -601,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
@@ -892,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(() => {});
 			};
 		});
@@ -935,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 = [];
@@ -953,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;
@@ -1006,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;
 	}
@@ -1034,5 +1107,5 @@ var BasicAgent = class extends BuiltInAgent {
 };
 
 //#endregion
-export { BasicAgent, BuiltInAgent, InterruptSignal, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
+export { BasicAgent, BuiltInAgent, InterruptSignal, classifyModelSpec, convertJsonSchemaToZodSchema$1 as convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel };
 //# sourceMappingURL=index.mjs.map