@dexto/core 1.5.5 → 1.5.7

package/dist/tools/internal-tools/constants.js

@@ -4,7 +4,8 @@ const INTERNAL_TOOL_NAMES = [
   "ask_user",
   "delegate_to_url",
   "list_resources",
-  "get_resource"
+  "get_resource",
+  "invoke_skill"
 ];
 export {
   INTERNAL_TOOL_NAMES

package/dist/tools/internal-tools/implementations/invoke-skill-tool.cjs

@@ -0,0 +1,140 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var invoke_skill_tool_exports = {};
+__export(invoke_skill_tool_exports, {
+  createInvokeSkillTool: () => createInvokeSkillTool
+});
+module.exports = __toCommonJS(invoke_skill_tool_exports);
+var import_zod = require("zod");
+var import_utils = require("../../../prompts/utils.js");
+const InvokeSkillInputSchema = import_zod.z.object({
+  skill: import_zod.z.string().min(1, "Skill name is required").describe(
+    'The name of the skill to invoke (e.g., "plugin-name:skill-name" or "skill-name")'
+  ),
+  args: import_zod.z.record(import_zod.z.string()).optional().describe("Optional arguments to pass to the skill"),
+  taskContext: import_zod.z.string().optional().describe(
+    "Context about what task this skill should accomplish. Recommended for forked skills to provide context since they run in isolation without conversation history."
+  )
+}).strict();
+function createInvokeSkillTool(services) {
+  return {
+    id: "invoke_skill",
+    description: buildToolDescription(),
+    inputSchema: InvokeSkillInputSchema,
+    execute: async (input, context) => {
+      const { skill, args, taskContext } = input;
+      const promptManager = services.promptManager;
+      if (!promptManager) {
+        return {
+          error: "PromptManager not available. This is a configuration error."
+        };
+      }
+      const autoInvocable = await promptManager.listAutoInvocablePrompts();
+      let skillKey;
+      for (const key of Object.keys(autoInvocable)) {
+        const info = autoInvocable[key];
+        if (!info) continue;
+        if (key === skill || info.displayName === skill || info.commandName === skill || info.name === skill) {
+          skillKey = key;
+          break;
+        }
+      }
+      if (!skillKey) {
+        return {
+          error: `Skill '${skill}' not found or not available for model invocation. Use a skill from the available list.`,
+          availableSkills: Object.keys(autoInvocable)
+        };
+      }
+      const promptDef = await promptManager.getPromptDefinition(skillKey);
+      const promptResult = await promptManager.getPrompt(skillKey, args);
+      const flattened = (0, import_utils.flattenPromptResult)(promptResult);
+      const content = flattened.text;
+      if (promptDef?.context === "fork") {
+        const taskForker = services.taskForker;
+        if (!taskForker) {
+          return {
+            error: `Skill '${skill}' requires fork execution (context: fork), but agent spawning is not available. Configure agent-spawner custom tool to enable forked skills.`,
+            skill: skillKey
+          };
+        }
+        let instructions;
+        if (taskContext) {
+          instructions = `## Task Context
+${taskContext}
+
+## Skill Instructions
+${content}`;
+        } else {
+          instructions = content;
+        }
+        const forkOptions = {
+          task: `Skill: ${skill}`,
+          instructions,
+          // Fork skills auto-approve by default since they run in isolation
+          autoApprove: true
+        };
+        if (promptDef.agent) {
+          forkOptions.agentId = promptDef.agent;
+        }
+        if (context?.toolCallId) {
+          forkOptions.toolCallId = context.toolCallId;
+        }
+        if (context?.sessionId) {
+          forkOptions.sessionId = context.sessionId;
+        }
+        const result = await taskForker.fork(forkOptions);
+        if (result.success) {
+          return result.response ?? "Task completed successfully.";
+        } else {
+          return `Error: ${result.error ?? "Unknown error during forked execution"}`;
+        }
+      }
+      return {
+        skill: skillKey,
+        content,
+        instructions: "Follow the instructions in the skill content above to complete the task."
+      };
+    }
+  };
+}
+function buildToolDescription() {
+  return `Invoke a skill to load and execute specialized instructions for a task. Skills are predefined prompts that guide how to handle specific scenarios.
+
+When to use:
+- When you recognize a task that matches an available skill
+- When you need specialized guidance for a complex operation
+- When the user references a skill by name
+
+Parameters:
+- skill: The name of the skill to invoke
+- args: Optional arguments to pass to the skill (e.g., for $ARGUMENTS substitution)
+- taskContext: Context about what you're trying to accomplish (important for forked skills that run in isolation)
+
+Execution modes:
+- **Inline skills**: Return instructions for you to follow in the current conversation
+- **Fork skills**: Automatically execute in an isolated subagent and return the result (no additional tool calls needed)
+
+Fork skills run in complete isolation without access to conversation history. They're useful for tasks that should run independently.
+
+Available skills are listed in your system prompt. Use the skill name exactly as shown.`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createInvokeSkillTool
+});

package/dist/tools/internal-tools/implementations/invoke-skill-tool.d.ts

@@ -0,0 +1,24 @@
+import type { InternalTool } from '../../types.js';
+import type { InternalToolsServices } from '../registry.js';
+/**
+ * Internal tool for invoking skills/prompts during agent execution.
+ *
+ * This tool allows the LLM to load and execute skills that are registered
+ * with the PromptManager. Skills are prompts that can be auto-invoked by
+ * the model (not disabled via `disableModelInvocation`).
+ *
+ * Execution modes:
+ * - **inline** (default): Skill content is returned for the LLM to follow in the current session
+ * - **fork**: Skill is executed in an isolated subagent with no conversation history access
+ *
+ * Usage:
+ * - The LLM sees available skills in its system prompt
+ * - When a skill is relevant, the LLM calls this tool with the skill name
+ * - For inline skills: content is returned for the LLM to follow
+ * - For forked skills: execution happens in isolation and result is returned
+ *
+ * Note: Takes services object (not individual deps) to support late-binding of taskForker.
+ * The taskForker may be set after tool creation when agent-spawner custom tool is registered.
+ */
+export declare function createInvokeSkillTool(services: InternalToolsServices): InternalTool;
+//# sourceMappingURL=invoke-skill-tool.d.ts.map

package/dist/tools/internal-tools/implementations/invoke-skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-skill-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/internal-tools/implementations/invoke-skill-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAuB5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,YAAY,CAqHnF"}

package/dist/tools/internal-tools/implementations/invoke-skill-tool.js

@@ -0,0 +1,117 @@
+import "../../../chunk-PTJYTZNU.js";
+import { z } from "zod";
+import { flattenPromptResult } from "../../../prompts/utils.js";
+const InvokeSkillInputSchema = z.object({
+  skill: z.string().min(1, "Skill name is required").describe(
+    'The name of the skill to invoke (e.g., "plugin-name:skill-name" or "skill-name")'
+  ),
+  args: z.record(z.string()).optional().describe("Optional arguments to pass to the skill"),
+  taskContext: z.string().optional().describe(
+    "Context about what task this skill should accomplish. Recommended for forked skills to provide context since they run in isolation without conversation history."
+  )
+}).strict();
+function createInvokeSkillTool(services) {
+  return {
+    id: "invoke_skill",
+    description: buildToolDescription(),
+    inputSchema: InvokeSkillInputSchema,
+    execute: async (input, context) => {
+      const { skill, args, taskContext } = input;
+      const promptManager = services.promptManager;
+      if (!promptManager) {
+        return {
+          error: "PromptManager not available. This is a configuration error."
+        };
+      }
+      const autoInvocable = await promptManager.listAutoInvocablePrompts();
+      let skillKey;
+      for (const key of Object.keys(autoInvocable)) {
+        const info = autoInvocable[key];
+        if (!info) continue;
+        if (key === skill || info.displayName === skill || info.commandName === skill || info.name === skill) {
+          skillKey = key;
+          break;
+        }
+      }
+      if (!skillKey) {
+        return {
+          error: `Skill '${skill}' not found or not available for model invocation. Use a skill from the available list.`,
+          availableSkills: Object.keys(autoInvocable)
+        };
+      }
+      const promptDef = await promptManager.getPromptDefinition(skillKey);
+      const promptResult = await promptManager.getPrompt(skillKey, args);
+      const flattened = flattenPromptResult(promptResult);
+      const content = flattened.text;
+      if (promptDef?.context === "fork") {
+        const taskForker = services.taskForker;
+        if (!taskForker) {
+          return {
+            error: `Skill '${skill}' requires fork execution (context: fork), but agent spawning is not available. Configure agent-spawner custom tool to enable forked skills.`,
+            skill: skillKey
+          };
+        }
+        let instructions;
+        if (taskContext) {
+          instructions = `## Task Context
+${taskContext}
+
+## Skill Instructions
+${content}`;
+        } else {
+          instructions = content;
+        }
+        const forkOptions = {
+          task: `Skill: ${skill}`,
+          instructions,
+          // Fork skills auto-approve by default since they run in isolation
+          autoApprove: true
+        };
+        if (promptDef.agent) {
+          forkOptions.agentId = promptDef.agent;
+        }
+        if (context?.toolCallId) {
+          forkOptions.toolCallId = context.toolCallId;
+        }
+        if (context?.sessionId) {
+          forkOptions.sessionId = context.sessionId;
+        }
+        const result = await taskForker.fork(forkOptions);
+        if (result.success) {
+          return result.response ?? "Task completed successfully.";
+        } else {
+          return `Error: ${result.error ?? "Unknown error during forked execution"}`;
+        }
+      }
+      return {
+        skill: skillKey,
+        content,
+        instructions: "Follow the instructions in the skill content above to complete the task."
+      };
+    }
+  };
+}
+function buildToolDescription() {
+  return `Invoke a skill to load and execute specialized instructions for a task. Skills are predefined prompts that guide how to handle specific scenarios.
+
+When to use:
+- When you recognize a task that matches an available skill
+- When you need specialized guidance for a complex operation
+- When the user references a skill by name
+
+Parameters:
+- skill: The name of the skill to invoke
+- args: Optional arguments to pass to the skill (e.g., for $ARGUMENTS substitution)
+- taskContext: Context about what you're trying to accomplish (important for forked skills that run in isolation)
+
+Execution modes:
+- **Inline skills**: Return instructions for you to follow in the current conversation
+- **Fork skills**: Automatically execute in an isolated subagent and return the result (no additional tool calls needed)
+
+Fork skills run in complete isolation without access to conversation history. They're useful for tasks that should run independently.
+
+Available skills are listed in your system prompt. Use the skill name exactly as shown.`;
+}
+export {
+  createInvokeSkillTool
+};

package/dist/tools/internal-tools/provider.cjs

@@ -55,6 +55,21 @@ class InternalToolsProvider {
   setAgent(agent) {
     this.agent = agent;
   }
+  /**
+   * Set prompt manager after construction (avoids circular dependency)
+   * Must be called before initialize() if invoke_skill tool is enabled
+   */
+  setPromptManager(promptManager) {
+    this.services.promptManager = promptManager;
+  }
+  /**
+   * Set task forker for context:fork skill execution (late-binding)
+   * Called by agent-spawner custom tool provider after RuntimeService is created.
+   * This enables invoke_skill to fork execution to an isolated subagent.
+   */
+  setTaskForker(taskForker) {
+    this.services.taskForker = taskForker;
+  }
   /**
    * Initialize the internal tools provider by registering all available internal tools
    * and custom tools from the registry

package/dist/tools/internal-tools/provider.d.ts

@@ -2,6 +2,7 @@ import { ToolSet, InternalTool } from '../types.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 import type { DextoAgent } from '../../agent/DextoAgent.js';
 import { InternalToolsServices } from './registry.js';
+import type { PromptManager } from '../../prompts/prompt-manager.js';
 import type { InternalToolsConfig, CustomToolsConfig } from '../schemas.js';
 /**
  * Provider for built-in internal tools and custom tool providers
@@ -31,6 +32,17 @@ export declare class InternalToolsProvider {
      * Must be called before initialize() if custom tools need agent access
      */
     setAgent(agent: DextoAgent): void;
+    /**
+     * Set prompt manager after construction (avoids circular dependency)
+     * Must be called before initialize() if invoke_skill tool is enabled
+     */
+    setPromptManager(promptManager: PromptManager): void;
+    /**
+     * Set task forker for context:fork skill execution (late-binding)
+     * Called by agent-spawner custom tool provider after RuntimeService is created.
+     * This enables invoke_skill to fork execution to an isolated subagent.
+     */
+    setTaskForker(taskForker: import('./registry.js').TaskForker): void;
     /**
      * Initialize the internal tools provider by registering all available internal tools
      * and custom tools from the registry

package/dist/tools/internal-tools/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAA0C,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK5E;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAa;gBAGvB,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,mBAAmB,YAAK,EAChC,iBAAiB,EAAE,iBAAiB,YAAK,EACzC,MAAM,EAAE,YAAY;IAYxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgD7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgE3B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACG,WAAW,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IA0CnB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAc3B;;OAEG;IACH,cAAc,IAAI,OAAO;IAczB;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG/B"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAA0C,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK5E;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAa;gBAGvB,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,mBAAmB,YAAK,EAChC,iBAAiB,EAAE,iBAAiB,YAAK,EACzC,MAAM,EAAE,YAAY;IAYxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIjC;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAIpD;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,eAAe,EAAE,UAAU,GAAG,IAAI;IAInE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgD7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgE3B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACG,WAAW,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IA0CnB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAc3B;;OAEG;IACH,cAAc,IAAI,OAAO;IAczB;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG/B"}

package/dist/tools/internal-tools/provider.js

@@ -33,6 +33,21 @@ class InternalToolsProvider {
   setAgent(agent) {
     this.agent = agent;
   }
+  /**
+   * Set prompt manager after construction (avoids circular dependency)
+   * Must be called before initialize() if invoke_skill tool is enabled
+   */
+  setPromptManager(promptManager) {
+    this.services.promptManager = promptManager;
+  }
+  /**
+   * Set task forker for context:fork skill execution (late-binding)
+   * Called by agent-spawner custom tool provider after RuntimeService is created.
+   * This enables invoke_skill to fork execution to an isolated subagent.
+   */
+  setTaskForker(taskForker) {
+    this.services.taskForker = taskForker;
+  }
   /**
    * Initialize the internal tools provider by registering all available internal tools
    * and custom tools from the registry

package/dist/tools/internal-tools/registry.cjs

@@ -27,6 +27,7 @@ var import_ask_user_tool = require("./implementations/ask-user-tool.js");
 var import_delegate_to_url_tool = require("./implementations/delegate-to-url-tool.js");
 var import_list_resources_tool = require("./implementations/list-resources-tool.js");
 var import_get_resource_tool = require("./implementations/get-resource-tool.js");
+var import_invoke_skill_tool = require("./implementations/invoke-skill-tool.js");
 const INTERNAL_TOOL_REGISTRY = {
   search_history: {
     factory: (services) => (0, import_search_history_tool.createSearchHistoryTool)(services.searchService),
@@ -53,6 +54,11 @@ const INTERNAL_TOOL_REGISTRY = {
     factory: (services) => (0, import_get_resource_tool.createGetResourceTool)(services.resourceManager),
     requiredServices: ["resourceManager"],
     description: "Access a stored resource to get URLs or metadata"
+  },
+  invoke_skill: {
+    factory: (services) => (0, import_invoke_skill_tool.createInvokeSkillTool)(services),
+    requiredServices: ["promptManager"],
+    description: "Invoke a skill to load specialized instructions for a task"
   }
 };
 function getInternalToolInfo(toolName) {

package/dist/tools/internal-tools/registry.d.ts

@@ -2,6 +2,7 @@ import { InternalTool } from '../types.js';
 import { SearchService } from '../../search/index.js';
 import { ApprovalManager } from '../../approval/manager.js';
 import { ResourceManager } from '../../resources/manager.js';
+import type { PromptManager } from '../../prompts/prompt-manager.js';
 import type { KnownInternalTool } from './constants.js';
 /**
  * Agent features that tools can depend on.
@@ -22,6 +23,36 @@ import type { KnownInternalTool } from './constants.js';
  * Tools can require multiple features - all must be enabled or startup fails with a clear error.
  */
 export type AgentFeature = 'elicitation';
+/**
+ * Interface for forking skill execution to an isolated subagent.
+ * Implemented by RuntimeService in @dexto/agent-management.
+ */
+export interface TaskForker {
+    /**
+     * Execute a task in an isolated subagent context.
+     * The subagent has no access to the parent's conversation history.
+     *
+     * @param options.task - Short description for UI/logs
+     * @param options.instructions - Full instructions for the subagent
+     * @param options.agentId - Optional agent ID from registry to use for execution
+     * @param options.autoApprove - Auto-approve tool calls (default: true for fork skills)
+     * @param options.toolCallId - Optional tool call ID for progress events
+     * @param options.sessionId - Optional session ID for progress events
+     * @returns Result with success status and response/error
+     */
+    fork(options: {
+        task: string;
+        instructions: string;
+        agentId?: string;
+        autoApprove?: boolean;
+        toolCallId?: string;
+        sessionId?: string;
+    }): Promise<{
+        success: boolean;
+        response?: string;
+        error?: string;
+    }>;
+}
 /**
  * Services available to internal tools
  * Add new services here as needed for internal tools
@@ -30,6 +61,9 @@ export interface InternalToolsServices {
     searchService?: SearchService;
     approvalManager?: ApprovalManager;
     resourceManager?: ResourceManager;
+    promptManager?: PromptManager;
+    /** Optional forker for executing skills in isolated context (context: fork) */
+    taskForker?: TaskForker;
 }
 /**
  * Internal tool factory function type

package/dist/tools/internal-tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC;AAED;;GAEG;AACH,KAAK,mBAAmB,GAAG,CAAC,QAAQ,EAAE,qBAAqB,KAAK,YAAY,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,EAAE,SAAS,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAC;IAC3D,gBAAgB,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CA8BvF,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,CAE1F"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAOrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,OAAO,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACN;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED;;GAEG;AACH,KAAK,mBAAmB,GAAG,CAAC,QAAQ,EAAE,qBAAqB,KAAK,YAAY,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,EAAE,SAAS,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAC;IAC3D,gBAAgB,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAmCvF,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,CAE1F"}

package/dist/tools/internal-tools/registry.js

@@ -4,6 +4,7 @@ import { createAskUserTool } from "./implementations/ask-user-tool.js";
 import { createDelegateToUrlTool } from "./implementations/delegate-to-url-tool.js";
 import { createListResourcesTool } from "./implementations/list-resources-tool.js";
 import { createGetResourceTool } from "./implementations/get-resource-tool.js";
+import { createInvokeSkillTool } from "./implementations/invoke-skill-tool.js";
 const INTERNAL_TOOL_REGISTRY = {
   search_history: {
     factory: (services) => createSearchHistoryTool(services.searchService),
@@ -30,6 +31,11 @@ const INTERNAL_TOOL_REGISTRY = {
     factory: (services) => createGetResourceTool(services.resourceManager),
     requiredServices: ["resourceManager"],
     description: "Access a stored resource to get URLs or metadata"
+  },
+  invoke_skill: {
+    factory: (services) => createInvokeSkillTool(services),
+    requiredServices: ["promptManager"],
+    description: "Invoke a skill to load specialized instructions for a task"
   }
 };
 function getInternalToolInfo(toolName) {

package/dist/tools/schemas.cjs

@@ -68,7 +68,7 @@ const ToolConfirmationConfigSchema = import_zod.z.object({
     "Tool confirmation mode: manual (interactive), auto-approve (all tools), auto-deny (no tools)"
   ),
   timeout: import_zod.z.number().int().positive().optional().describe(
-    "Timeout for tool confirmation requests in milliseconds (optional - no timeout if not specified)"
+    "Timeout for tool confirmation requests in milliseconds. If not set, waits indefinitely."
   ),
   allowedToolsStorage: import_zod.z.enum(ALLOWED_TOOLS_STORAGE_TYPES).default(DEFAULT_ALLOWED_TOOLS_STORAGE).describe(
     "Storage type for remembered tool approvals: memory (session-only) or storage (persistent)"
@@ -82,7 +82,7 @@ const ElicitationConfigSchema = import_zod.z.object({
     "Enable elicitation support (ask_user tool and MCP server elicitations). When disabled, elicitation requests will be rejected."
   ),
   timeout: import_zod.z.number().int().positive().optional().describe(
-    "Timeout for elicitation requests in milliseconds (optional - no timeout if not specified)"
+    "Timeout for elicitation requests in milliseconds. If not set, waits indefinitely."
   )
 }).strict().describe(
   "Elicitation configuration for user input requests. Independent from tool confirmation mode, allowing auto-approve for tools while still supporting elicitation."

package/dist/tools/schemas.d.ts

@@ -5,7 +5,7 @@ export declare const ALLOWED_TOOLS_STORAGE_TYPES: readonly ["memory", "storage"]
 export type AllowedToolsStorageType = (typeof ALLOWED_TOOLS_STORAGE_TYPES)[number];
 export declare const DEFAULT_TOOL_CONFIRMATION_MODE: ToolConfirmationMode;
 export declare const DEFAULT_ALLOWED_TOOLS_STORAGE: AllowedToolsStorageType;
-export declare const InternalToolsSchema: z.ZodDefault<z.ZodArray<z.ZodEnum<["search_history", "ask_user", "delegate_to_url", "list_resources", "get_resource"]>, "many">>;
+export declare const InternalToolsSchema: z.ZodDefault<z.ZodArray<z.ZodEnum<["search_history", "ask_user", "delegate_to_url", "list_resources", "get_resource", "invoke_skill"]>, "many">>;
 export type InternalToolsConfig = z.output<typeof InternalToolsSchema>;
 /**
  * Custom tool configuration schema.

package/dist/tools/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB,kDAAmD,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B,gCAAiC,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,eAAO,MAAM,8BAA8B,EAAE,oBAAqC,CAAC;AACnF,eAAO,MAAM,6BAA6B,EAAE,uBAAmC,CAAC;AAIhF,eAAO,MAAM,mBAAmB,kIAK3B,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAkBvE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,8CAA4C,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;gCAKgD,CAAC;AAE9F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gFAKzB,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;0CAGqB,CAAC;AAG9D,eAAO,MAAM,kBAAkB;;;;;;;;;GAiB2B,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BoB,CAAC;AAE9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAG5F,eAAO,MAAM,uBAAuB;;;;;;;;;EAoB/B,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGlF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAShB,CAAC;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;GAEgB,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB,kDAAmD,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B,gCAAiC,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,eAAO,MAAM,8BAA8B,EAAE,oBAAqC,CAAC;AACnF,eAAO,MAAM,6BAA6B,EAAE,uBAAmC,CAAC;AAIhF,eAAO,MAAM,mBAAmB,kJAK3B,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAkBvE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,8CAA4C,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;gCAKgD,CAAC;AAE9F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gFAKzB,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;0CAGqB,CAAC;AAG9D,eAAO,MAAM,kBAAkB;;;;;;;;;GAiB2B,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BoB,CAAC;AAE9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAG5F,eAAO,MAAM,uBAAuB;;;;;;;;;EAoB/B,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGlF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAShB,CAAC;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;GAEgB,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/tools/schemas.js

@@ -33,7 +33,7 @@ const ToolConfirmationConfigSchema = z.object({
     "Tool confirmation mode: manual (interactive), auto-approve (all tools), auto-deny (no tools)"
   ),
   timeout: z.number().int().positive().optional().describe(
-    "Timeout for tool confirmation requests in milliseconds (optional - no timeout if not specified)"
+    "Timeout for tool confirmation requests in milliseconds. If not set, waits indefinitely."
   ),
   allowedToolsStorage: z.enum(ALLOWED_TOOLS_STORAGE_TYPES).default(DEFAULT_ALLOWED_TOOLS_STORAGE).describe(
     "Storage type for remembered tool approvals: memory (session-only) or storage (persistent)"
@@ -47,7 +47,7 @@ const ElicitationConfigSchema = z.object({
     "Enable elicitation support (ask_user tool and MCP server elicitations). When disabled, elicitation requests will be rejected."
   ),
   timeout: z.number().int().positive().optional().describe(
-    "Timeout for elicitation requests in milliseconds (optional - no timeout if not specified)"
+    "Timeout for elicitation requests in milliseconds. If not set, waits indefinitely."
   )
 }).strict().describe(
   "Elicitation configuration for user input requests. Independent from tool confirmation mode, allowing auto-approve for tools while still supporting elicitation."