@dexto/agent-management 1.6.17 → 1.6.19

package/dist/AgentFactory.cjs

@@ -126,7 +126,8 @@ const AgentFactory = {
     }
     return await (0, import_agent_creation.createDextoAgentFromConfig)({
       config: configToEnrich,
-      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false }
+      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false },
+      runtimeOverrides: options?.runtimeOverrides
     });
   }
 };

package/dist/AgentFactory.d.ts

@@ -24,7 +24,7 @@
  * @see https://docs.dexto.ai/api/sdk/agent-factory for full documentation
  */
 import type { AgentConfig } from '@dexto/agent-config';
-import type { DextoAgent } from '@dexto/core';
+import type { DextoAgent, DextoAgentConfigInput } from '@dexto/core';
 import { type InstallOptions } from './installation.js';
 import type { AgentMetadata } from './AgentManager.js';
 /**
@@ -44,6 +44,8 @@ export interface CreateAgentOptions {
     agentId?: string;
     /** Whether this is interactive CLI mode (affects logger defaults) */
     isInteractiveCli?: boolean;
+    /** Explicit runtime overrides applied outside the validated agent config */
+    runtimeOverrides?: Pick<DextoAgentConfigInput, 'usageScopeId'> | undefined;
 }
 /**
  * Static API for agent management operations

package/dist/AgentFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmB5F,CAAC"}
+{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB5F,CAAC"}

package/dist/AgentFactory.js

@@ -107,7 +107,8 @@ const AgentFactory = {
     }
     return await createDextoAgentFromConfig({
       config: configToEnrich,
-      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false }
+      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false },
+      runtimeOverrides: options?.runtimeOverrides
     });
   }
 };

package/dist/agent-creation.cjs

@@ -61,7 +61,7 @@ function applySubAgentToolConstraints(config) {
   return { ...config, tools: constrainedTools };
 }
 async function createDextoAgentFromConfig(options) {
-  const { configPath, enrichOptions, agentIdOverride, overrides } = options;
+  const { configPath, enrichOptions, agentIdOverride, overrides, runtimeOverrides } = options;
   const cleanedConfig = (0, import_agent_config.cleanNullValues)(options.config);
   const { image } = await loadImageForConfig({
     config: cleanedConfig,
@@ -86,6 +86,7 @@ async function createDextoAgentFromConfig(options) {
     (0, import_agent_config.toDextoAgentOptions)({
       config: validatedConfig,
       services,
+      ...runtimeOverrides ? { runtimeOverrides } : {},
       overrides: mergedOverrides
     })
   );

package/dist/agent-creation.d.ts

@@ -1,5 +1,5 @@
 import type { AgentConfig } from '@dexto/agent-config';
-import { DextoAgent, type InitializeServicesOptions } from '@dexto/core';
+import { DextoAgent, type DextoAgentConfigInput, type InitializeServicesOptions } from '@dexto/core';
 import { type EnrichAgentConfigOptions } from './config/index.js';
 type CreateDextoAgentFromConfigOptions = {
     config: AgentConfig;
@@ -9,6 +9,7 @@ type CreateDextoAgentFromConfigOptions = {
     imageNameOverride?: string | undefined;
     agentContext?: 'subagent' | undefined;
     overrides?: InitializeServicesOptions | undefined;
+    runtimeOverrides?: Pick<DextoAgentConfigInput, 'usageScopeId'> | undefined;
 };
 export declare function createDextoAgentFromConfig(options: CreateDextoAgentFromConfigOptions): Promise<DextoAgent>;
 export {};

package/dist/agent-creation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EAAE,UAAU,EAAU,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACrD,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAsCrB"}
+{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EACH,UAAU,EAEV,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClD,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAuCrB"}

package/dist/agent-creation.js

@@ -6,7 +6,10 @@ import {
   resolveServicesFromConfig,
   toDextoAgentOptions
 } from "@dexto/agent-config";
-import { DextoAgent, logger } from "@dexto/core";
+import {
+  DextoAgent,
+  logger
+} from "@dexto/core";
 import { enrichAgentConfig } from "./config/index.js";
 import { BUILTIN_TOOL_NAMES } from "@dexto/tools-builtins";
 async function loadImageForConfig(options) {
@@ -45,7 +48,7 @@ function applySubAgentToolConstraints(config) {
   return { ...config, tools: constrainedTools };
 }
 async function createDextoAgentFromConfig(options) {
-  const { configPath, enrichOptions, agentIdOverride, overrides } = options;
+  const { configPath, enrichOptions, agentIdOverride, overrides, runtimeOverrides } = options;
   const cleanedConfig = cleanNullValues(options.config);
   const { image } = await loadImageForConfig({
     config: cleanedConfig,
@@ -70,6 +73,7 @@ async function createDextoAgentFromConfig(options) {
     toDextoAgentOptions({
       config: validatedConfig,
       services,
+      ...runtimeOverrides ? { runtimeOverrides } : {},
       overrides: mergedOverrides
     })
   );

package/dist/plugins/discover-skills.d.ts

@@ -10,6 +10,9 @@
  * ~/.dexto/skills/
  * └── skill-name/
  *     ├── SKILL.md          (required - the skill prompt)
+ *     ├── handlers/         (optional - workflow helper files)
+ *     ├── scripts/          (optional - executable helpers)
+ *     ├── mcps/             (optional - MCP server config JSON files)
  *     └── references/       (optional - reference files)
  *
  * These skills are loaded as prompts directly, not as part of a plugin package.
@@ -26,6 +29,11 @@ export interface DiscoveredSkill {
     skillFile: string;
     /** Source location */
     source: 'user' | 'project';
+    /**
+     * Reserved for future discovery metadata.
+     * Skill-bundled MCP config is resolved lazily from the skill directory when the prompt is loaded.
+     */
+    warnings?: string[] | undefined;
 }
 /**
  * Discovers standalone skills from standard locations.

package/dist/plugins/discover-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../src/plugins/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAkEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAW9C"}
+{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../src/plugins/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAkEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAW9C"}

package/dist/plugins/load-plugin.cjs

@@ -33,7 +33,7 @@ __export(load_plugin_exports, {
 module.exports = __toCommonJS(load_plugin_exports);
 var path = __toESM(require("path"), 1);
 var import_fs = require("fs");
-var import_schemas = require("./schemas.js");
+var import_mcp_config = require("./mcp-config.js");
 function loadClaudeCodePlugin(plugin) {
   const warnings = [];
   const commands = [];
@@ -82,12 +82,13 @@ function loadClaudeCodePlugin(plugin) {
     } catch {
     }
   }
-  const mcpConfig = loadMcpConfig(pluginPath, pluginName, warnings);
+  const mcpResult = (0, import_mcp_config.loadMcpConfigFromDirectory)(pluginPath, pluginName);
+  warnings.push(...mcpResult.warnings);
   checkUnsupportedFeatures(pluginPath, pluginName, warnings);
   return {
     manifest: plugin.manifest,
     commands,
-    mcpConfig,
+    mcpConfig: mcpResult.mcpConfig,
     warnings
   };
 }
@@ -111,61 +112,6 @@ function readFileSafe(filePath) {
     return null;
   }
 }
-function loadMcpConfig(pluginPath, pluginName, warnings) {
-  const mcpPath = path.join(pluginPath, ".mcp.json");
-  if (!(0, import_fs.existsSync)(mcpPath)) {
-    return void 0;
-  }
-  try {
-    const content = (0, import_fs.readFileSync)(mcpPath, "utf-8");
-    const parsed = JSON.parse(content);
-    if (!parsed.mcpServers && typeof parsed === "object" && parsed !== null) {
-      const hasServerConfig = Object.values(parsed).some(
-        (val) => typeof val === "object" && val !== null && ("type" in val || "command" in val || "url" in val)
-      );
-      if (hasServerConfig) {
-        const normalized = {};
-        for (const [serverName, serverConfig] of Object.entries(parsed)) {
-          if (typeof serverConfig === "object" && serverConfig !== null && !Array.isArray(serverConfig)) {
-            const config = serverConfig;
-            if ("type" in config) {
-              normalized[serverName] = config;
-            } else if ("command" in config) {
-              normalized[serverName] = {
-                type: "stdio",
-                ...config
-              };
-            } else if ("url" in config) {
-              const url = String(config.url || "");
-              const inferredType = url.includes("/sse") ? "sse" : "http";
-              normalized[serverName] = {
-                type: inferredType,
-                ...config
-              };
-            } else {
-              normalized[serverName] = config;
-            }
-          }
-        }
-        return { mcpServers: normalized };
-      }
-    }
-    const result = import_schemas.PluginMCPConfigSchema.safeParse(parsed);
-    if (!result.success) {
-      const issues = result.error.issues.map((i) => i.message).join(", ");
-      warnings.push(`[${pluginName}] Invalid .mcp.json: ${issues}`);
-      return void 0;
-    }
-    return result.data;
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      warnings.push(`[${pluginName}] Failed to parse .mcp.json: invalid JSON`);
-    } else {
-      warnings.push(`[${pluginName}] Failed to load .mcp.json: ${String(error)}`);
-    }
-    return void 0;
-  }
-}
 function checkUnsupportedFeatures(pluginPath, pluginName, warnings) {
   const hooksPath = path.join(pluginPath, "hooks", "hooks.json");
   if ((0, import_fs.existsSync)(hooksPath)) {

package/dist/plugins/load-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/load-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAkC,MAAM,YAAY,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAqE3E"}
+{"version":3,"file":"load-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/load-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAGhF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAsE3E"}

package/dist/plugins/load-plugin.js

@@ -1,6 +1,6 @@
 import * as path from "path";
 import { existsSync, readdirSync, readFileSync } from "fs";
-import { PluginMCPConfigSchema } from "./schemas.js";
+import { loadMcpConfigFromDirectory } from "./mcp-config.js";
 function loadClaudeCodePlugin(plugin) {
   const warnings = [];
   const commands = [];
@@ -49,12 +49,13 @@ function loadClaudeCodePlugin(plugin) {
     } catch {
     }
   }
-  const mcpConfig = loadMcpConfig(pluginPath, pluginName, warnings);
+  const mcpResult = loadMcpConfigFromDirectory(pluginPath, pluginName);
+  warnings.push(...mcpResult.warnings);
   checkUnsupportedFeatures(pluginPath, pluginName, warnings);
   return {
     manifest: plugin.manifest,
     commands,
-    mcpConfig,
+    mcpConfig: mcpResult.mcpConfig,
     warnings
   };
 }
@@ -78,61 +79,6 @@ function readFileSafe(filePath) {
     return null;
   }
 }
-function loadMcpConfig(pluginPath, pluginName, warnings) {
-  const mcpPath = path.join(pluginPath, ".mcp.json");
-  if (!existsSync(mcpPath)) {
-    return void 0;
-  }
-  try {
-    const content = readFileSync(mcpPath, "utf-8");
-    const parsed = JSON.parse(content);
-    if (!parsed.mcpServers && typeof parsed === "object" && parsed !== null) {
-      const hasServerConfig = Object.values(parsed).some(
-        (val) => typeof val === "object" && val !== null && ("type" in val || "command" in val || "url" in val)
-      );
-      if (hasServerConfig) {
-        const normalized = {};
-        for (const [serverName, serverConfig] of Object.entries(parsed)) {
-          if (typeof serverConfig === "object" && serverConfig !== null && !Array.isArray(serverConfig)) {
-            const config = serverConfig;
-            if ("type" in config) {
-              normalized[serverName] = config;
-            } else if ("command" in config) {
-              normalized[serverName] = {
-                type: "stdio",
-                ...config
-              };
-            } else if ("url" in config) {
-              const url = String(config.url || "");
-              const inferredType = url.includes("/sse") ? "sse" : "http";
-              normalized[serverName] = {
-                type: inferredType,
-                ...config
-              };
-            } else {
-              normalized[serverName] = config;
-            }
-          }
-        }
-        return { mcpServers: normalized };
-      }
-    }
-    const result = PluginMCPConfigSchema.safeParse(parsed);
-    if (!result.success) {
-      const issues = result.error.issues.map((i) => i.message).join(", ");
-      warnings.push(`[${pluginName}] Invalid .mcp.json: ${issues}`);
-      return void 0;
-    }
-    return result.data;
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      warnings.push(`[${pluginName}] Failed to parse .mcp.json: invalid JSON`);
-    } else {
-      warnings.push(`[${pluginName}] Failed to load .mcp.json: ${String(error)}`);
-    }
-    return void 0;
-  }
-}
 function checkUnsupportedFeatures(pluginPath, pluginName, warnings) {
   const hooksPath = path.join(pluginPath, "hooks", "hooks.json");
   if (existsSync(hooksPath)) {

package/dist/plugins/mcp-config.cjs

@@ -0,0 +1,35 @@
+"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 mcp_config_exports = {};
+__export(mcp_config_exports, {
+  loadMcpConfigFromDirectory: () => loadMcpConfigFromDirectory
+});
+module.exports = __toCommonJS(mcp_config_exports);
+var import_core = require("@dexto/core");
+function loadMcpConfigFromDirectory(directoryPath, ownerName, options = {}) {
+  const result = (0, import_core.loadBundledMcpConfigFromDirectory)(directoryPath, ownerName, options);
+  return {
+    ...result.mcpServers ? { mcpConfig: { mcpServers: result.mcpServers } } : {},
+    warnings: result.warnings
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadMcpConfigFromDirectory
+});

package/dist/plugins/mcp-config.d.ts

@@ -0,0 +1,10 @@
+import type { PluginMCPConfig } from './types.js';
+export interface LoadMcpConfigOptions {
+    scanNestedMcps?: boolean | undefined;
+}
+export interface LoadMcpConfigResult {
+    mcpConfig?: PluginMCPConfig | undefined;
+    warnings: string[];
+}
+export declare function loadMcpConfigFromDirectory(directoryPath: string, ownerName: string, options?: LoadMcpConfigOptions): LoadMcpConfigResult;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/plugins/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/plugins/mcp-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACjC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAChC,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CACtC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACnC,mBAAmB,CASrB"}

package/dist/plugins/mcp-config.js

@@ -0,0 +1,11 @@
+import { loadBundledMcpConfigFromDirectory } from "@dexto/core";
+function loadMcpConfigFromDirectory(directoryPath, ownerName, options = {}) {
+  const result = loadBundledMcpConfigFromDirectory(directoryPath, ownerName, options);
+  return {
+    ...result.mcpServers ? { mcpConfig: { mcpServers: result.mcpServers } } : {},
+    warnings: result.warnings
+  };
+}
+export {
+  loadMcpConfigFromDirectory
+};

package/dist/tool-factories/creator-tools/factory.cjs

@@ -60,6 +60,10 @@ const SkillListInputSchema = import_zod.z.object({
   projectPath: import_zod.z.string().optional(),
   query: import_zod.z.string().optional().describe("Optional search term to filter skills by name or path")
 }).strict();
+const SkillRefreshInputSchema = import_zod.z.object({
+  id: import_zod.z.string().min(1).describe("Skill id to refresh in the running agent session."),
+  scope: import_zod.z.enum(["global", "workspace"]).optional()
+}).strict();
 const SkillSearchInputSchema = import_zod.z.object({
   query: import_zod.z.string().optional().describe("Optional search term to filter skills by name or description"),
   limit: import_zod.z.number().int().min(1).max(200).optional().describe(
@@ -71,6 +75,7 @@ const ToolCatalogInputSchema = import_zod.z.object({
   limit: import_zod.z.number().int().min(1).max(500).optional().describe("Maximum number of tools to return (defaults to all)."),
   includeDescriptions: import_zod.z.boolean().optional().describe("Include tool descriptions (defaults to true).")
 }).strict();
+const SKILL_RESOURCE_DIRECTORIES = ["handlers", "scripts", "mcps", "references"];
 function normalizeSkillQuery(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
 }
@@ -91,10 +96,30 @@ function resolveWorkspaceBasePath(context) {
 function resolveWorkspaceSkillDirs(context) {
   const base = resolveWorkspaceBasePath(context);
   return {
-    primary: import_node_path.default.join(base, ".agents", "skills"),
+    primary: import_node_path.default.join(base, "skills"),
+    secondary: import_node_path.default.join(base, ".agents", "skills"),
     legacy: import_node_path.default.join(base, ".dexto", "skills")
   };
 }
+function findRegisteredSkillFile(skillId, context) {
+  const prompts = context.agent?.getEffectiveConfig().prompts;
+  if (!Array.isArray(prompts)) {
+    return void 0;
+  }
+  for (const prompt of prompts) {
+    if (!prompt || typeof prompt !== "object" || prompt.type !== "file") {
+      continue;
+    }
+    const filePath = typeof prompt.file === "string" ? prompt.file : void 0;
+    if (!filePath || import_node_path.default.basename(filePath) !== "SKILL.md") {
+      continue;
+    }
+    if (import_node_path.default.basename(import_node_path.default.dirname(filePath)) === skillId) {
+      return filePath;
+    }
+  }
+  return void 0;
+}
 function resolveSkillBaseDirectory(scope, context) {
   if (scope === "global") {
     return { baseDir: (0, import_path.getDextoGlobalPath)("skills"), scope: "global" };
@@ -111,18 +136,48 @@ async function resolveSkillUpdateDirectory(input, context) {
   if (input.scope === "global") {
     return resolveSkillBaseDirectory("global", context);
   }
-  const { primary, legacy } = resolveWorkspaceSkillDirs(context);
+  const { primary, secondary, legacy } = resolveWorkspaceSkillDirs(context);
   const skillId = input.id.trim();
   const primaryFile = import_node_path.default.join(primary, skillId, "SKILL.md");
   if (await pathExists(primaryFile)) {
     return { baseDir: primary, scope: "workspace" };
   }
+  const secondaryFile = import_node_path.default.join(secondary, skillId, "SKILL.md");
+  if (await pathExists(secondaryFile)) {
+    return { baseDir: secondary, scope: "workspace" };
+  }
   const legacyFile = import_node_path.default.join(legacy, skillId, "SKILL.md");
   if (await pathExists(legacyFile)) {
     return { baseDir: legacy, scope: "workspace" };
   }
   return { baseDir: primary, scope: "workspace" };
 }
+async function resolveExistingSkillLocation(input, context) {
+  if (input.scope !== "global") {
+    const registeredSkillFile = findRegisteredSkillFile(input.id.trim(), context);
+    if (registeredSkillFile) {
+      const skillDir2 = import_node_path.default.dirname(registeredSkillFile);
+      const baseDir2 = import_node_path.default.dirname(skillDir2);
+      ensurePathWithinBase(baseDir2, skillDir2, "skill_refresh");
+      return {
+        baseDir: baseDir2,
+        scope: "workspace",
+        skillDir: skillDir2,
+        skillFile: registeredSkillFile
+      };
+    }
+  }
+  const { baseDir, scope } = await resolveSkillUpdateDirectory(input, context);
+  const skillDir = import_node_path.default.join(baseDir, input.id.trim());
+  ensurePathWithinBase(baseDir, skillDir, "skill_refresh");
+  const skillFile = import_node_path.default.join(skillDir, "SKILL.md");
+  return {
+    baseDir,
+    scope,
+    skillDir,
+    skillFile
+  };
+}
 function ensurePathWithinBase(baseDir, targetDir, toolId) {
   const resolvedBase = import_node_path.default.resolve(baseDir);
   const resolvedTarget = import_node_path.default.resolve(targetDir);
@@ -158,6 +213,7 @@ function formatFrontmatterList(key, values) {
 function buildSkillMarkdownFromParts(options) {
   const id = options.id.trim();
   const title = titleizeSkillId(id) || id;
+  const body = normalizeSkillBody(options.content);
   const lines = ["---"];
   lines.push(formatFrontmatterLine("name", id));
   lines.push(formatFrontmatterLine("description", options.description.trim()));
@@ -167,9 +223,18 @@ function buildSkillMarkdownFromParts(options) {
   if (options.allowedTools && options.allowedTools.length > 0) {
     lines.push(formatFrontmatterList("allowed-tools", options.allowedTools));
   }
-  lines.push("---", "", `# ${title}`, "", options.content.trim());
+  lines.push("---", "", `# ${title}`);
+  if (body.length > 0) {
+    lines.push("", body);
+  }
   return lines.join("\n").replace(/\n{3,}/g, "\n\n");
 }
+function normalizeSkillBody(content) {
+  const trimmed = content.trim();
+  const withoutFrontmatter = trimmed.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "").trimStart();
+  const withoutLeadingH1 = withoutFrontmatter.replace(/^#\s+[^\n]+(?:\n+|$)/, "").trimStart();
+  return withoutLeadingH1.trim();
+}
 function buildSkillMarkdown(input) {
   return buildSkillMarkdownFromParts({
     id: input.id,
@@ -216,6 +281,29 @@ async function refreshAgentPrompts(context, skillFile) {
   await agent.refreshPrompts(nextPrompts);
   return true;
 }
+function buildSkillBundleNotes(bundledMcpServers) {
+  const notes = [
+    "Creating or editing files under mcps/ only defines bundled MCP config. It does not implement or verify the target MCP server.",
+    "After editing SKILL.md or bundled MCP files with non-creator tools, run skill_refresh so the current session sees the latest skill content and MCP metadata."
+  ];
+  if (bundledMcpServers.length > 0) {
+    notes.push(
+      "Bundled MCP config is present. Only describe the skill as shipping a real MCP when the config points at a bundled runnable server or a verified external command/package."
+    );
+  }
+  return notes;
+}
+function inspectSkillBundle(skillDir, skillId) {
+  const bundledMcpResult = (0, import_core.loadBundledMcpConfigFromDirectory)(skillDir, skillId, {
+    scanNestedMcps: true
+  });
+  const bundledMcpServers = Object.keys(bundledMcpResult.mcpServers ?? {});
+  return {
+    bundledMcpServers,
+    bundledMcpWarnings: bundledMcpResult.warnings,
+    notes: buildSkillBundleNotes(bundledMcpServers)
+  };
+}
 const creatorToolsFactory = {
   configSchema: import_schemas.CreatorToolsConfigSchema,
   metadata: {
@@ -227,7 +315,7 @@ const creatorToolsFactory = {
     const enabledTools = config.enabledTools ?? import_schemas.CREATOR_TOOL_NAMES;
     const skillCreateTool = (0, import_core.defineTool)({
       id: "skill_create",
-      description: "Create a standalone SKILL.md file and register it with the running agent. Provide id, description, content, and optional toolkits/allowedTools.",
+      description: "Create a standalone SKILL.md file, scaffold bundled resource directories, and register it with the running agent. This scaffolds mcps/ but does not implement or verify an MCP server.",
       inputSchema: SkillCreateInputSchema,
       execute: async (input, context) => {
         const resolvedInput = resolveSkillCreateInput(input);
@@ -250,8 +338,14 @@ const creatorToolsFactory = {
         const markdown = buildSkillMarkdown(resolvedInput);
         await import_node_fs.promises.mkdir(skillDir, { recursive: true });
         await import_node_fs.promises.writeFile(skillFile, markdown, "utf-8");
+        await Promise.all(
+          SKILL_RESOURCE_DIRECTORIES.map(
+            (directory) => import_node_fs.promises.mkdir(import_node_path.default.join(skillDir, directory), { recursive: true })
+          )
+        );
         const refreshed = await refreshAgentPrompts(context, skillFile);
         const displayName = titleizeSkillId(skillId) || skillId;
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
         return {
           created: true,
           id: skillId,
@@ -259,7 +353,11 @@ const creatorToolsFactory = {
           description: resolvedInput.description.trim(),
           scope,
           path: skillFile,
-          promptsRefreshed: refreshed
+          resourceDirectories: SKILL_RESOURCE_DIRECTORIES.map(
+            (directory) => import_node_path.default.join(skillDir, directory)
+          ),
+          promptsRefreshed: refreshed,
+          ...bundleDetails
         };
       }
     });
@@ -273,10 +371,10 @@ const creatorToolsFactory = {
           context: "skill_update",
           hint: "Use kebab-case skill ids (e.g., release-notes)"
         });
-        const { baseDir, scope } = await resolveSkillUpdateDirectory(input, context);
-        const skillDir = import_node_path.default.join(baseDir, skillId);
-        ensurePathWithinBase(baseDir, skillDir, "skill_update");
-        const skillFile = import_node_path.default.join(skillDir, "SKILL.md");
+        const { scope, skillDir, skillFile } = await resolveExistingSkillLocation(
+          input,
+          context
+        );
         const exists = await pathExists(skillFile);
         if (!exists) {
           throw import_core.ToolError.validationFailed(
@@ -303,13 +401,53 @@ const creatorToolsFactory = {
         });
         await import_node_fs.promises.writeFile(skillFile, markdown, "utf-8");
         const refreshed = await refreshAgentPrompts(context, skillFile);
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
         return {
           updated: true,
           id: skillId,
           description,
           scope,
           path: skillFile,
-          promptsRefreshed: refreshed
+          promptsRefreshed: refreshed,
+          ...bundleDetails
+        };
+      }
+    });
+    const skillRefreshTool = (0, import_core.defineTool)({
+      id: "skill_refresh",
+      description: "Refresh one standalone skill bundle in the current session after editing SKILL.md, mcps/, scripts/, or references/. Rebuilds prompt metadata so bundled MCP servers can be discovered without restarting.",
+      inputSchema: SkillRefreshInputSchema,
+      execute: async (input, context) => {
+        const skillId = input.id.trim();
+        (0, import_core.assertValidPromptName)(skillId, {
+          context: "skill_refresh",
+          hint: "Use kebab-case skill ids (e.g., release-notes)"
+        });
+        if (!context.agent) {
+          throw import_core.ToolError.configInvalid(
+            "skill_refresh requires ToolExecutionContext.agent"
+          );
+        }
+        const { scope, skillDir, skillFile } = await resolveExistingSkillLocation(
+          input,
+          context
+        );
+        const exists = await pathExists(skillFile);
+        if (!exists) {
+          throw import_core.ToolError.validationFailed(
+            "skill_refresh",
+            `Skill not found at ${skillFile}`
+          );
+        }
+        const refreshed = await refreshAgentPrompts(context, skillFile);
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
+        return {
+          refreshed: true,
+          id: skillId,
+          scope,
+          path: skillFile,
+          promptsRefreshed: refreshed,
+          ...bundleDetails
         };
       }
     });
@@ -421,6 +559,7 @@ const creatorToolsFactory = {
     const toolCreators = {
       skill_create: () => skillCreateTool,
       skill_update: () => skillUpdateTool,
+      skill_refresh: () => skillRefreshTool,
       skill_search: () => skillSearchTool,
       skill_list: () => skillListTool,
       tool_catalog: () => toolCatalogTool

package/dist/tool-factories/creator-tools/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/creator-tools/factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAWvD,OAAO,EAIH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAkWtB,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,kBAAkB,CA6P/D,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/creator-tools/factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvD,OAAO,EAIH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAqetB,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,kBAAkB,CAqT/D,CAAC"}

package/dist/tool-factories/creator-tools/factory.js

@@ -4,7 +4,8 @@ import { parse as yamlParse } from "yaml";
 import {
   ToolError,
   defineTool,
-  assertValidPromptName
+  assertValidPromptName,
+  loadBundledMcpConfigFromDirectory
 } from "@dexto/core";
 import { discoverStandaloneSkills, getSkillSearchPaths } from "../../plugins/discover-skills.js";
 import {
@@ -34,6 +35,10 @@ const SkillListInputSchema = z.object({
   projectPath: z.string().optional(),
   query: z.string().optional().describe("Optional search term to filter skills by name or path")
 }).strict();
+const SkillRefreshInputSchema = z.object({
+  id: z.string().min(1).describe("Skill id to refresh in the running agent session."),
+  scope: z.enum(["global", "workspace"]).optional()
+}).strict();
 const SkillSearchInputSchema = z.object({
   query: z.string().optional().describe("Optional search term to filter skills by name or description"),
   limit: z.number().int().min(1).max(200).optional().describe(
@@ -45,6 +50,7 @@ const ToolCatalogInputSchema = z.object({
   limit: z.number().int().min(1).max(500).optional().describe("Maximum number of tools to return (defaults to all)."),
   includeDescriptions: z.boolean().optional().describe("Include tool descriptions (defaults to true).")
 }).strict();
+const SKILL_RESOURCE_DIRECTORIES = ["handlers", "scripts", "mcps", "references"];
 function normalizeSkillQuery(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
 }
@@ -65,10 +71,30 @@ function resolveWorkspaceBasePath(context) {
 function resolveWorkspaceSkillDirs(context) {
   const base = resolveWorkspaceBasePath(context);
   return {
-    primary: path.join(base, ".agents", "skills"),
+    primary: path.join(base, "skills"),
+    secondary: path.join(base, ".agents", "skills"),
     legacy: path.join(base, ".dexto", "skills")
   };
 }
+function findRegisteredSkillFile(skillId, context) {
+  const prompts = context.agent?.getEffectiveConfig().prompts;
+  if (!Array.isArray(prompts)) {
+    return void 0;
+  }
+  for (const prompt of prompts) {
+    if (!prompt || typeof prompt !== "object" || prompt.type !== "file") {
+      continue;
+    }
+    const filePath = typeof prompt.file === "string" ? prompt.file : void 0;
+    if (!filePath || path.basename(filePath) !== "SKILL.md") {
+      continue;
+    }
+    if (path.basename(path.dirname(filePath)) === skillId) {
+      return filePath;
+    }
+  }
+  return void 0;
+}
 function resolveSkillBaseDirectory(scope, context) {
   if (scope === "global") {
     return { baseDir: getDextoGlobalPath("skills"), scope: "global" };
@@ -85,18 +111,48 @@ async function resolveSkillUpdateDirectory(input, context) {
   if (input.scope === "global") {
     return resolveSkillBaseDirectory("global", context);
   }
-  const { primary, legacy } = resolveWorkspaceSkillDirs(context);
+  const { primary, secondary, legacy } = resolveWorkspaceSkillDirs(context);
   const skillId = input.id.trim();
   const primaryFile = path.join(primary, skillId, "SKILL.md");
   if (await pathExists(primaryFile)) {
     return { baseDir: primary, scope: "workspace" };
   }
+  const secondaryFile = path.join(secondary, skillId, "SKILL.md");
+  if (await pathExists(secondaryFile)) {
+    return { baseDir: secondary, scope: "workspace" };
+  }
   const legacyFile = path.join(legacy, skillId, "SKILL.md");
   if (await pathExists(legacyFile)) {
     return { baseDir: legacy, scope: "workspace" };
   }
   return { baseDir: primary, scope: "workspace" };
 }
+async function resolveExistingSkillLocation(input, context) {
+  if (input.scope !== "global") {
+    const registeredSkillFile = findRegisteredSkillFile(input.id.trim(), context);
+    if (registeredSkillFile) {
+      const skillDir2 = path.dirname(registeredSkillFile);
+      const baseDir2 = path.dirname(skillDir2);
+      ensurePathWithinBase(baseDir2, skillDir2, "skill_refresh");
+      return {
+        baseDir: baseDir2,
+        scope: "workspace",
+        skillDir: skillDir2,
+        skillFile: registeredSkillFile
+      };
+    }
+  }
+  const { baseDir, scope } = await resolveSkillUpdateDirectory(input, context);
+  const skillDir = path.join(baseDir, input.id.trim());
+  ensurePathWithinBase(baseDir, skillDir, "skill_refresh");
+  const skillFile = path.join(skillDir, "SKILL.md");
+  return {
+    baseDir,
+    scope,
+    skillDir,
+    skillFile
+  };
+}
 function ensurePathWithinBase(baseDir, targetDir, toolId) {
   const resolvedBase = path.resolve(baseDir);
   const resolvedTarget = path.resolve(targetDir);
@@ -132,6 +188,7 @@ function formatFrontmatterList(key, values) {
 function buildSkillMarkdownFromParts(options) {
   const id = options.id.trim();
   const title = titleizeSkillId(id) || id;
+  const body = normalizeSkillBody(options.content);
   const lines = ["---"];
   lines.push(formatFrontmatterLine("name", id));
   lines.push(formatFrontmatterLine("description", options.description.trim()));
@@ -141,9 +198,18 @@ function buildSkillMarkdownFromParts(options) {
   if (options.allowedTools && options.allowedTools.length > 0) {
     lines.push(formatFrontmatterList("allowed-tools", options.allowedTools));
   }
-  lines.push("---", "", `# ${title}`, "", options.content.trim());
+  lines.push("---", "", `# ${title}`);
+  if (body.length > 0) {
+    lines.push("", body);
+  }
   return lines.join("\n").replace(/\n{3,}/g, "\n\n");
 }
+function normalizeSkillBody(content) {
+  const trimmed = content.trim();
+  const withoutFrontmatter = trimmed.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "").trimStart();
+  const withoutLeadingH1 = withoutFrontmatter.replace(/^#\s+[^\n]+(?:\n+|$)/, "").trimStart();
+  return withoutLeadingH1.trim();
+}
 function buildSkillMarkdown(input) {
   return buildSkillMarkdownFromParts({
     id: input.id,
@@ -190,6 +256,29 @@ async function refreshAgentPrompts(context, skillFile) {
   await agent.refreshPrompts(nextPrompts);
   return true;
 }
+function buildSkillBundleNotes(bundledMcpServers) {
+  const notes = [
+    "Creating or editing files under mcps/ only defines bundled MCP config. It does not implement or verify the target MCP server.",
+    "After editing SKILL.md or bundled MCP files with non-creator tools, run skill_refresh so the current session sees the latest skill content and MCP metadata."
+  ];
+  if (bundledMcpServers.length > 0) {
+    notes.push(
+      "Bundled MCP config is present. Only describe the skill as shipping a real MCP when the config points at a bundled runnable server or a verified external command/package."
+    );
+  }
+  return notes;
+}
+function inspectSkillBundle(skillDir, skillId) {
+  const bundledMcpResult = loadBundledMcpConfigFromDirectory(skillDir, skillId, {
+    scanNestedMcps: true
+  });
+  const bundledMcpServers = Object.keys(bundledMcpResult.mcpServers ?? {});
+  return {
+    bundledMcpServers,
+    bundledMcpWarnings: bundledMcpResult.warnings,
+    notes: buildSkillBundleNotes(bundledMcpServers)
+  };
+}
 const creatorToolsFactory = {
   configSchema: CreatorToolsConfigSchema,
   metadata: {
@@ -201,7 +290,7 @@ const creatorToolsFactory = {
     const enabledTools = config.enabledTools ?? CREATOR_TOOL_NAMES;
     const skillCreateTool = defineTool({
       id: "skill_create",
-      description: "Create a standalone SKILL.md file and register it with the running agent. Provide id, description, content, and optional toolkits/allowedTools.",
+      description: "Create a standalone SKILL.md file, scaffold bundled resource directories, and register it with the running agent. This scaffolds mcps/ but does not implement or verify an MCP server.",
       inputSchema: SkillCreateInputSchema,
       execute: async (input, context) => {
         const resolvedInput = resolveSkillCreateInput(input);
@@ -224,8 +313,14 @@ const creatorToolsFactory = {
         const markdown = buildSkillMarkdown(resolvedInput);
         await fs.mkdir(skillDir, { recursive: true });
         await fs.writeFile(skillFile, markdown, "utf-8");
+        await Promise.all(
+          SKILL_RESOURCE_DIRECTORIES.map(
+            (directory) => fs.mkdir(path.join(skillDir, directory), { recursive: true })
+          )
+        );
         const refreshed = await refreshAgentPrompts(context, skillFile);
         const displayName = titleizeSkillId(skillId) || skillId;
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
         return {
           created: true,
           id: skillId,
@@ -233,7 +328,11 @@ const creatorToolsFactory = {
           description: resolvedInput.description.trim(),
           scope,
           path: skillFile,
-          promptsRefreshed: refreshed
+          resourceDirectories: SKILL_RESOURCE_DIRECTORIES.map(
+            (directory) => path.join(skillDir, directory)
+          ),
+          promptsRefreshed: refreshed,
+          ...bundleDetails
         };
       }
     });
@@ -247,10 +346,10 @@ const creatorToolsFactory = {
           context: "skill_update",
           hint: "Use kebab-case skill ids (e.g., release-notes)"
         });
-        const { baseDir, scope } = await resolveSkillUpdateDirectory(input, context);
-        const skillDir = path.join(baseDir, skillId);
-        ensurePathWithinBase(baseDir, skillDir, "skill_update");
-        const skillFile = path.join(skillDir, "SKILL.md");
+        const { scope, skillDir, skillFile } = await resolveExistingSkillLocation(
+          input,
+          context
+        );
         const exists = await pathExists(skillFile);
         if (!exists) {
           throw ToolError.validationFailed(
@@ -277,13 +376,53 @@ const creatorToolsFactory = {
         });
         await fs.writeFile(skillFile, markdown, "utf-8");
         const refreshed = await refreshAgentPrompts(context, skillFile);
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
         return {
           updated: true,
           id: skillId,
           description,
           scope,
           path: skillFile,
-          promptsRefreshed: refreshed
+          promptsRefreshed: refreshed,
+          ...bundleDetails
+        };
+      }
+    });
+    const skillRefreshTool = defineTool({
+      id: "skill_refresh",
+      description: "Refresh one standalone skill bundle in the current session after editing SKILL.md, mcps/, scripts/, or references/. Rebuilds prompt metadata so bundled MCP servers can be discovered without restarting.",
+      inputSchema: SkillRefreshInputSchema,
+      execute: async (input, context) => {
+        const skillId = input.id.trim();
+        assertValidPromptName(skillId, {
+          context: "skill_refresh",
+          hint: "Use kebab-case skill ids (e.g., release-notes)"
+        });
+        if (!context.agent) {
+          throw ToolError.configInvalid(
+            "skill_refresh requires ToolExecutionContext.agent"
+          );
+        }
+        const { scope, skillDir, skillFile } = await resolveExistingSkillLocation(
+          input,
+          context
+        );
+        const exists = await pathExists(skillFile);
+        if (!exists) {
+          throw ToolError.validationFailed(
+            "skill_refresh",
+            `Skill not found at ${skillFile}`
+          );
+        }
+        const refreshed = await refreshAgentPrompts(context, skillFile);
+        const bundleDetails = inspectSkillBundle(skillDir, skillId);
+        return {
+          refreshed: true,
+          id: skillId,
+          scope,
+          path: skillFile,
+          promptsRefreshed: refreshed,
+          ...bundleDetails
         };
       }
     });
@@ -395,6 +534,7 @@ const creatorToolsFactory = {
     const toolCreators = {
       skill_create: () => skillCreateTool,
       skill_update: () => skillUpdateTool,
+      skill_refresh: () => skillRefreshTool,
       skill_search: () => skillSearchTool,
       skill_list: () => skillListTool,
       tool_catalog: () => toolCatalogTool

package/dist/tool-factories/creator-tools/schemas.cjs

@@ -26,6 +26,7 @@ var import_zod = require("zod");
 const CREATOR_TOOL_NAMES = [
   "skill_create",
   "skill_update",
+  "skill_refresh",
   "skill_search",
   "skill_list",
   "tool_catalog"

package/dist/tool-factories/creator-tools/schemas.d.ts

@@ -1,15 +1,15 @@
 import { z } from 'zod';
-export declare const CREATOR_TOOL_NAMES: readonly ["skill_create", "skill_update", "skill_search", "skill_list", "tool_catalog"];
+export declare const CREATOR_TOOL_NAMES: readonly ["skill_create", "skill_update", "skill_refresh", "skill_search", "skill_list", "tool_catalog"];
 export type CreatorToolName = (typeof CREATOR_TOOL_NAMES)[number];
 export declare const CreatorToolsConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"creator-tools">;
-    enabledTools: z.ZodOptional<z.ZodArray<z.ZodEnum<["skill_create", "skill_update", "skill_search", "skill_list", "tool_catalog"]>, "many">>;
+    enabledTools: z.ZodOptional<z.ZodArray<z.ZodEnum<["skill_create", "skill_update", "skill_refresh", "skill_search", "skill_list", "tool_catalog"]>, "many">>;
 }, "strict", z.ZodTypeAny, {
     type: "creator-tools";
-    enabledTools?: ("skill_create" | "skill_update" | "skill_search" | "skill_list" | "tool_catalog")[] | undefined;
+    enabledTools?: ("skill_create" | "skill_update" | "skill_refresh" | "skill_search" | "skill_list" | "tool_catalog")[] | undefined;
 }, {
     type: "creator-tools";
-    enabledTools?: ("skill_create" | "skill_update" | "skill_search" | "skill_list" | "tool_catalog")[] | undefined;
+    enabledTools?: ("skill_create" | "skill_update" | "skill_refresh" | "skill_search" | "skill_list" | "tool_catalog")[] | undefined;
 }>;
 export type CreatorToolsConfig = z.output<typeof CreatorToolsConfigSchema>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/tool-factories/creator-tools/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/creator-tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,yFAMrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;EAQxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/creator-tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,0GAOrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;EAQxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/tool-factories/creator-tools/schemas.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 const CREATOR_TOOL_NAMES = [
   "skill_create",
   "skill_update",
+  "skill_refresh",
   "skill_search",
   "skill_list",
   "tool_catalog"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.6.17",
+  "version": "1.6.19",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -14,12 +14,12 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "yaml": "^2.7.1",
+    "yaml": "^2.8.3",
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.17",
-    "@dexto/core": "1.6.17",
-    "@dexto/orchestration": "1.6.17",
-    "@dexto/tools-builtins": "1.6.17"
+    "@dexto/agent-config": "1.6.19",
+    "@dexto/core": "1.6.19",
+    "@dexto/orchestration": "1.6.19",
+    "@dexto/tools-builtins": "1.6.19"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"