dexto 1.6.17 → 1.6.19

package/dist/api/server-hono.d.ts

@@ -23,8 +23,8 @@ export type HonoInitializationResult = {
     ensureAgentAvailable: () => void;
     getActiveAgentId: () => string | undefined;
 };
-export declare function initializeHonoApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentId?: string, configFilePath?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<HonoInitializationResult>;
-export declare function startHonoApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentId?: string, configFilePath?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<{
+export declare function initializeHonoApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentId?: string, configFilePath?: string, workspaceRoot?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<HonoInitializationResult>;
+export declare function startHonoApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentId?: string, configFilePath?: string, workspaceRoot?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<{
     server: ReturnType<typeof createNodeServer>['server'];
     webhookSubscriber?: NonNullable<ReturnType<typeof createNodeServer>['webhookSubscriber']>;
 }>;

package/dist/api/server-hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-hono.d.ts","sourceRoot":"","sources":["../../src/api/server-hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAC;AAY9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AA+FvB,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1F,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C,CAAC;AAGF,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAmXnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC;IACP,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAC7F,CAAC,CAiCD"}
+{"version":3,"file":"server-hono.d.ts","sourceRoot":"","sources":["../../src/api/server-hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAC;AAY9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AAmGvB,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1F,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C,CAAC;AAGF,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA4XnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC;IACP,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAC7F,CAAC,CAkCD"}

package/dist/api/server-hono.js

@@ -5,6 +5,7 @@ import { applyUserPreferences } from '../config/cli-overrides.js';
 import { createFileSessionLoggerFactory } from '../utils/session-logger-factory.js';
 import { createDextoApp, createNodeServer, createMcpTransport as createServerMcpTransport, createMcpHttpHandlers, initializeMcpServer as initializeServerMcpServer, createManualApprovalHandler, WebhookEventSubscriber, A2ASseEventSubscriber, ApprovalCoordinator, } from '@dexto/server';
 import { registerGracefulShutdown } from '../utils/graceful-shutdown.js';
+import { applyWorkspaceToAgent } from '../utils/workspace.js';
 const DEFAULT_AGENT_VERSION = '1.0.0';
 const sessionLoggerFactory = createFileSessionLoggerFactory();
 /**
@@ -25,7 +26,7 @@ async function listAgents() {
  * Applies user preferences (preferences.yml) to ALL agents, not just the default.
  * See feature-plans/auto-update.md section 8.11 - Three-Layer LLM Resolution.
  */
-async function createAgentFromId(agentId) {
+async function createAgentFromId(agentId, workspaceRoot) {
     try {
         // Use registry to resolve agent path (auto-installs if not present)
         const registry = getAgentRegistry();
@@ -53,7 +54,10 @@ async function createAgentFromId(agentId) {
         return await createDextoAgentFromConfig({
             config,
             configPath: agentPath,
-            enrichOptions: { logLevel: 'info' },
+            enrichOptions: {
+                logLevel: 'info',
+                ...(workspaceRoot ? { workspaceRoot } : {}),
+            },
             overrides: { sessionLoggerFactory },
         });
     }
@@ -72,7 +76,7 @@ function resolveBaseUrl(port) {
     return process.env.DEXTO_BASE_URL ?? `http://localhost:${port}`;
 }
 //TODO (migration): consider moving this to the server package
-export async function initializeHonoApi(agent, agentCardOverride, listenPort, agentId, configFilePath, webRoot, webUIConfig) {
+export async function initializeHonoApi(agent, agentCardOverride, listenPort, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig) {
     // Declare before registering shutdown hook to avoid TDZ on signals
     let activeAgent = agent;
     let activeAgentId = agentId || 'coding-agent';
@@ -160,6 +164,9 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
         await wireServicesToAgent(newAgent);
         logger.info(`Starting new agent: ${agentId}`);
         await newAgent.start();
+        if (workspaceRoot) {
+            await applyWorkspaceToAgent(newAgent, workspaceRoot);
+        }
         // Update agent card for A2A and MCP routes
         agentCardData = createAgentCard({
             defaultName: agentId,
@@ -195,7 +202,7 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             // 2. Create new agent from registry (will initialize fresh telemetry in createAgentServices)
             const registry = getAgentRegistry();
             newAgentConfigPath = await registry.resolveAgent(agentId, true);
-            newAgent = await createAgentFromId(agentId);
+            newAgent = await createAgentFromId(agentId, workspaceRoot);
             // 3. Use common switch logic (register subscribers, start agent, stop previous)
             return await performAgentSwitch(newAgent, agentId, newAgentConfigPath, bridge);
         }
@@ -247,7 +254,10 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             newAgent = await createDextoAgentFromConfig({
                 config,
                 configPath: filePath,
-                enrichOptions: { logLevel: 'info' },
+                enrichOptions: {
+                    logLevel: 'info',
+                    ...(workspaceRoot ? { workspaceRoot } : {}),
+                },
                 overrides: { sessionLoggerFactory },
             });
             // 4. Use enriched agentId (derived from config or filename during enrichment)
@@ -351,6 +361,9 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
     // Start the initial agent now that approval handler is set and subscribers are wired
     logger.info('Starting initial agent...');
     await activeAgent.start();
+    if (workspaceRoot) {
+        await applyWorkspaceToAgent(activeAgent, workspaceRoot);
+    }
     // Initialize MCP server after agent has started
     if (mcpTransport) {
         try {
@@ -376,8 +389,8 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
         getActiveAgentId: () => activeAgentId,
     };
 }
-export async function startHonoApiServer(agent, port = 3000, agentCardOverride, agentId, configFilePath, webRoot, webUIConfig) {
-    const { server, webhookSubscriber } = await initializeHonoApi(agent, agentCardOverride, port, agentId, configFilePath, webRoot, webUIConfig);
+export async function startHonoApiServer(agent, port = 3000, agentCardOverride, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig) {
+    const { server, webhookSubscriber } = await initializeHonoApi(agent, agentCardOverride, port, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig);
     server.listen(port, '0.0.0.0', () => {
         const networkInterfaces = os.networkInterfaces();
         let localIp = 'localhost';

package/dist/cli/commands/init.d.ts

@@ -34,6 +34,14 @@ export interface WorkspaceSkillScaffoldResult {
         path: string;
         status: ScaffoldEntryStatus;
     };
+    resourceDirectories: Array<{
+        path: string;
+        status: ScaffoldEntryStatus;
+    }>;
+    extraFiles: Array<{
+        path: string;
+        status: ScaffoldEntryStatus;
+    }>;
 }
 export interface WorkspacePrimaryAgentResult {
     workspace: WorkspaceScaffoldResult;

package/dist/cli/commands/init.d.ts.map

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

package/dist/cli/commands/init.js

@@ -14,6 +14,9 @@ import { confirmOrExit, multiselectOrExit, selectOrExit, textOrExit, } from '../
 import { ensureImageImporterConfigured } from '../utils/image-importer.js';
 const AGENTS_FILENAME = 'AGENTS.md';
 const WORKSPACE_DIRECTORIES = ['agents', 'skills'];
+const SKILL_RESOURCE_DIRECTORIES = ['handlers', 'scripts', 'mcps', 'references'];
+const STARTER_SKILL_ID = 'create-skill';
+const STARTER_SKILL_IDS = [STARTER_SKILL_ID];
 const DEFAULT_AGENT_PROVIDER = 'openai';
 const DEFAULT_AGENT_MODEL = 'gpt-5.3-codex';
 const DEFAULT_AGENTS_MD = `<!-- dexto-workspace -->
@@ -24,7 +27,8 @@ This workspace can define project-specific agents and skills.
 
 ## Structure
 - Put custom agents and subagents in \`agents/\`
-- Put custom skills in \`skills/<skill-id>/SKILL.md\`
+- Put custom skills in \`skills/<skill-id>/\`
+- Each skill bundle should keep \`SKILL.md\` plus optional \`handlers/\`, \`scripts/\`, \`mcps/\`, and \`references/\`
 - Use \`.dexto/\` only for Dexto-managed state and installed assets
 
 ## Defaults
@@ -831,14 +835,22 @@ description: "TODO: Describe when to use this skill."
 ## Purpose
 Describe what this skill helps the agent accomplish.
 
-## Inputs
+## When To Use
 - The task or context that should trigger this skill
 - Relevant files, paths, or constraints
 
-## Steps
-1. Review the relevant context.
-2. Apply the workflow for this skill.
-3. Return a concise result with any important follow-up actions.
+## Workflow
+1. Review the relevant context and only open bundled files that are actually needed.
+2. Use \`references/\` for background knowledge, schemas, or examples.
+3. Use \`scripts/\` for deterministic helper code and \`handlers/\` for reusable workflow logic.
+4. Use \`mcps/\` for any MCP server configs this skill needs to carry with it.
+5. Return a concise result with any important follow-up actions.
+
+## Bundled Resources
+- \`handlers/\`: Reusable workflow helpers or code snippets this skill can point to
+- \`scripts/\`: Executable helpers for deterministic or repetitive tasks
+- \`mcps/\`: MCP server config JSON files associated with this skill
+- \`references/\`: Docs, schemas, examples, or domain notes to load on demand
 
 ## Output Format
 - Summary of what was found or changed
@@ -846,6 +858,215 @@ Describe what this skill helps the agent accomplish.
 - Follow-up actions, if any
 `;
 }
+function buildCreateSkillStarterTemplate() {
+    return `---
+name: "${STARTER_SKILL_ID}"
+description: "Create or update Dexto skill bundles with SKILL.md, handlers, scripts, mcps, and references."
+toolkits: ["creator-tools"]
+allowed-tools: ["skill_create", "skill_update", "skill_refresh", "skill_search", "skill_list", "tool_catalog"]
+---
+
+# Create Skill
+
+Create or update standalone Dexto skill bundles. Treat \`skills/<id>/\` as the canonical workspace location unless the user explicitly asks for a global skill.
+
+## Core Flow
+1. Search for overlap first with \`skill_list\` and \`skill_search\`.
+2. Propose a kebab-case id, one-sentence description, scope, and the minimum tool access the skill needs.
+3. Create or update the skill bundle.
+4. Keep \`SKILL.md\` focused on trigger conditions, workflow, and when to open bundled files.
+5. Add bundled files only when they materially improve the workflow:
+   - \`references/\` for larger docs, copied external material, schemas, examples, or policies
+   - \`scripts/\` for deterministic helpers
+   - \`handlers/\` for reusable workflow logic or structured helper code
+   - \`mcps/\` for MCP configs the skill should carry with it
+   - When a skill needs a real bundled MCP server, prefer the SDK-based stdio pattern in \`references/mcp-server-pattern.md\`
+6. Prefer extending existing skills or references over duplicating content.
+7. If you edit \`SKILL.md\` or bundled files with non-creator tools, run \`skill_refresh\` before relying on the skill in the current session.
+8. Creating \`mcps/*.json\` only creates bundled MCP config. Do not say you created a real MCP server unless the config points at a bundled runnable implementation or a verified external command/package.
+
+## Authoring Rules
+- Default to workspace scope.
+- Default to no extra toolkits and no \`allowed-tools\` unless the skill needs them.
+- Keep most actionable instructions in \`SKILL.md\` so the agent can act without opening extra files.
+- Use \`references/\` sparingly for larger copied docs, external references, schemas, examples, or policies.
+- Keep references one level deep from \`SKILL.md\` and link them explicitly.
+- Reuse language and conventions from nearby skills when possible.
+- If you add MCP config files or update bundled resources outside creator tools, run \`skill_refresh\` so the current session reloads the skill metadata before invoking it.
+- For real bundled MCPs, prefer the official \`@modelcontextprotocol/sdk\` server APIs with \`StdioServerTransport\`. Avoid hand-rolled Content-Length framing unless the user explicitly asks for low-level protocol code.
+
+## SKILL.md Structure
+- \`# <Title>\`
+- \`## Purpose\`
+- \`## When To Use\`
+- \`## Workflow\`
+- \`## Bundled Resources\`
+- \`## Output Format\`
+
+## Resource Guide
+Read \`references/skill-anatomy.md\` when you need the bundle layout or packaging checklist.
+Read \`references/mcp-server-pattern.md\` when the skill needs a bundled MCP server implementation.
+`;
+}
+function buildCreateSkillStarterReference() {
+    return `# Skill Anatomy
+
+## Canonical Layout
+\`\`\`
+skills/<skill-id>/
+├── SKILL.md
+├── handlers/
+├── scripts/
+├── mcps/
+└── references/
+\`\`\`
+
+## What Goes Where
+- \`SKILL.md\`: The trigger, workflow, and navigation entrypoint.
+- \`handlers/\`: Reusable helper code or structured workflow fragments the skill can reference.
+- \`scripts/\`: Deterministic helpers the agent can run instead of rewriting logic.
+- \`mcps/\`: JSON config fragments for MCP servers used by the skill. This is config only, not proof that the MCP implementation exists.
+- \`references/\`: Supporting material the agent should open only when needed, especially larger copied docs, schemas, external references, or long examples.
+
+## Creation Checklist
+1. Search existing skills first to avoid duplicates.
+2. Pick a kebab-case id and concise description.
+3. Keep actionable workflow in \`SKILL.md\`; move only larger reference material into \`references/\`.
+4. Add scripts or handlers only when they remove repeated work or improve reliability.
+5. Add MCP configs only when the skill truly depends on them.
+6. Reference bundled files from \`SKILL.md\` using relative paths.
+
+## MCP Notes
+- Store standalone skill MCP configs as JSON files in \`mcps/\`.
+- Each file may define one or more servers using the same shape as \`.mcp.json\`.
+- Skill MCP configs are bundled metadata. They do not by themselves implement or verify an MCP server.
+- If you claim the skill ships a real MCP, the config must point to a bundled runnable server or a verified external package/command.
+- Run \`skill_refresh\` after editing bundled files so the running session reloads the latest skill content and MCP metadata.
+`;
+}
+function buildCreateSkillMcpReference() {
+    return `# MCP Server Pattern
+
+Use this pattern when a skill needs to bundle a real MCP server in \`scripts/\`.
+
+## Preferred Approach
+- Use the official \`@modelcontextprotocol/sdk\` server APIs.
+- Use \`StdioServerTransport\` for bundled local servers.
+- Keep the MCP config in \`mcps/*.json\` simple and skill-relative.
+- Prefer \`.mjs\` for bundled MCP server scripts to avoid CommonJS/ESM ambiguity.
+
+## Avoid
+- Do not hand-roll MCP framing with manual \`Content-Length\` parsing unless the user explicitly asks for low-level protocol code.
+- Do not claim the MCP works just because the script exists or passes \`node --check\`.
+- Do not stop at writing \`mcps/*.json\` if the user asked for a real MCP implementation.
+
+## Minimal Server Template
+\`\`\`js
+#!/usr/bin/env node
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const server = new Server(
+    {
+        name: 'my-skill-server',
+        version: '1.0.0',
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
+    }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'my_tool',
+            description: 'Describe what the tool does.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    value: {
+                        type: 'string',
+                    },
+                },
+                required: ['value'],
+            },
+        },
+    ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name !== 'my_tool') {
+        throw new Error(\`Unknown tool: \${request.params.name}\`);
+    }
+
+    const value =
+        typeof request.params.arguments?.value === 'string' ? request.params.arguments.value : '';
+
+    return {
+        content: [
+            {
+                type: 'text',
+                text: \`Handled: \${value}\`,
+            },
+        ],
+        structuredContent: {
+            value,
+        },
+    };
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+\`\`\`
+
+## Matching MCP Config
+\`\`\`json
+{
+  "mcpServers": {
+    "my_server": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["scripts/my-skill-server.mjs"]
+    }
+  }
+}
+\`\`\`
+
+## Verification Sequence
+1. Create or update \`SKILL.md\`, \`scripts/\`, and \`mcps/\`.
+2. Run \`skill_refresh\` after non-creator file edits.
+3. Invoke the skill in the current session.
+4. Confirm the bundled MCP connects and the new MCP tool appears.
+5. Call the MCP tool once with a simple input and confirm the result.
+
+If step 3 or 4 fails, the skill is not done yet.
+`;
+}
+function buildSkillExtraFiles(skillId) {
+    if (skillId === STARTER_SKILL_ID) {
+        return [
+            {
+                relativePath: path.join('references', 'skill-anatomy.md'),
+                content: buildCreateSkillStarterReference(),
+            },
+            {
+                relativePath: path.join('references', 'mcp-server-pattern.md'),
+                content: buildCreateSkillMcpReference(),
+            },
+        ];
+    }
+    return [];
+}
+function buildSkillTemplateForId(skillId) {
+    if (skillId === STARTER_SKILL_ID) {
+        return buildCreateSkillStarterTemplate();
+    }
+    return buildSkillTemplate(skillId);
+}
 async function loadWorkspaceProjectRegistry(workspaceRoot) {
     const existingPath = await findSharedProjectRegistryPath(workspaceRoot);
     if (!existingPath) {
@@ -985,14 +1206,29 @@ export async function createWorkspaceSkillScaffold(skillIdInput, workspaceRoot =
     const workspace = await createWorkspaceScaffold(workspaceRoot);
     const skillDirPath = path.join(workspace.root, 'skills', skillId);
     const skillFilePath = path.join(skillDirPath, 'SKILL.md');
+    const resourceDirectories = [];
+    const extraFiles = [];
     await ensureDirectory(skillDirPath);
-    const skillFileStatus = await ensureFile(skillFilePath, buildSkillTemplate(skillId));
+    const skillFileStatus = await ensureFile(skillFilePath, buildSkillTemplateForId(skillId));
+    for (const directory of SKILL_RESOURCE_DIRECTORIES) {
+        const resourcePath = path.join(skillDirPath, directory);
+        const status = await ensureDirectory(resourcePath);
+        resourceDirectories.push({ path: resourcePath, status });
+    }
+    for (const file of buildSkillExtraFiles(skillId)) {
+        const filePath = path.join(skillDirPath, file.relativePath);
+        await ensureDirectory(path.dirname(filePath));
+        const status = await ensureFile(filePath, file.content);
+        extraFiles.push({ path: filePath, status });
+    }
     return {
         workspace,
         skillFile: {
             path: skillFilePath,
             status: skillFileStatus,
         },
+        resourceDirectories,
+        extraFiles,
     };
 }
 export async function setWorkspacePrimaryAgent(agentIdInput, workspaceRoot = process.cwd()) {
@@ -1088,6 +1324,16 @@ function formatSkillPaths(result) {
     if (result.skillFile.status === 'created') {
         createdPaths.push(path.relative(result.workspace.root, result.skillFile.path));
     }
+    for (const directory of result.resourceDirectories) {
+        if (directory.status === 'created') {
+            createdPaths.push(path.relative(result.workspace.root, directory.path));
+        }
+    }
+    for (const file of result.extraFiles) {
+        if (file.status === 'created') {
+            createdPaths.push(path.relative(result.workspace.root, file.path));
+        }
+    }
     return createdPaths;
 }
 async function listWorkspaceSkillIds(workspaceRoot) {
@@ -1234,7 +1480,12 @@ async function resolvePrimaryAgentSelection(agentIdInput, workspaceRoot) {
 export async function handleInitCommand(workspaceRoot = process.cwd()) {
     p.intro(chalk.inverse('Dexto Init'));
     const result = await createWorkspaceScaffold(workspaceRoot);
-    const createdPaths = formatCreatedPaths(result);
+    const starterSkills = await Promise.all(STARTER_SKILL_IDS.map((skillId) => createWorkspaceSkillScaffold(skillId, workspaceRoot)));
+    const workspacePaths = formatCreatedPaths(result);
+    const createdPaths = [
+        ...workspacePaths,
+        ...starterSkills.flatMap((skill) => formatSkillPaths(skill).filter((item) => !workspacePaths.includes(item))),
+    ];
     if (createdPaths.length === 0) {
         p.outro(chalk.green('Workspace already initialized.'));
         return;

package/dist/cli/modes/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsBpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwKxE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAuBpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgLxE"}

package/dist/cli/modes/cli.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import { logger } from '@dexto/core';
 import { safeExit, ExitSignal } from '../../analytics/wrapper.js';
+import { applyWorkspaceToAgent } from '../../utils/workspace.js';
 async function getMostRecentSessionId(agent) {
     const sessionIds = await agent.listSessions();
     if (sessionIds.length === 0) {
@@ -18,7 +19,7 @@ async function getMostRecentSessionId(agent) {
     return mostRecentId;
 }
 export async function runCliMode(context) {
-    const { agent, opts, validatedConfig, resolvedPath, initialPrompt, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, validatedConfig, resolvedPath, initialPrompt, getVersionCheckResult, } = context;
     const needsHandler = validatedConfig.permissions.mode === 'manual' || validatedConfig.elicitation.enabled;
     if (needsHandler) {
         const { createCLIApprovalHandler } = await import('../approval/index.js');
@@ -26,8 +27,9 @@ export async function runCliMode(context) {
         agent.setApprovalHandler(handler);
         logger.debug('CLI approval handler configured for Ink CLI');
     }
-    await agent.start();
     try {
+        await agent.start();
+        await applyWorkspaceToAgent(agent, workspaceRoot);
         const llmConfig = agent.getCurrentLLMConfig();
         const { requiresApiKey } = await import('@dexto/core');
         if (requiresApiKey(llmConfig.provider) && !llmConfig.apiKey?.trim()) {

package/dist/cli/modes/context.d.ts

@@ -11,6 +11,7 @@ export interface MainModeOptions {
 export interface MainModeContext {
     agent: DextoAgent;
     opts: MainModeOptions;
+    workspaceRoot: string;
     validatedConfig: ValidatedAgentConfig;
     resolvedPath: string;
     derivedAgentId: string;

package/dist/cli/modes/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,oBAAoB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qBAAqB,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,oBAAoB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qBAAqB,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/dist/cli/modes/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C3E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD3E"}

package/dist/cli/modes/server.js

@@ -1,6 +1,6 @@
 import { getPort } from '../../utils/port-utils.js';
 export async function runServerMode(context) {
-    const { agent, opts, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
     const { startHonoApiServer } = await import('../../api/server-hono.js');
     const agentCard = agent.config.agentCard ?? {};
     const defaultPort = (() => {
@@ -20,7 +20,7 @@ export async function runServerMode(context) {
     const apiPort = getPort(process.env.PORT, defaultPort, 'PORT');
     const apiUrl = process.env.DEXTO_URL ?? `http://localhost:${apiPort}`;
     console.log('🌐 Starting server (REST APIs + SSE)...');
-    await startHonoApiServer(agent, apiPort, agentCard, derivedAgentId, resolvedPath);
+    await startHonoApiServer(agent, apiPort, agentCard, derivedAgentId, resolvedPath, workspaceRoot);
     console.log(`✅ Server running at ${apiUrl}`);
     console.log('Available endpoints:');
     console.log('  POST /api/message - Send async message');

package/dist/cli/modes/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/web.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmExE"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/web.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqExE"}

package/dist/cli/modes/web.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import { getPort } from '../../utils/port-utils.js';
 export async function runWebMode(context) {
-    const { agent, opts, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
     const [{ resolveWebRoot }, { startHonoApiServer }, { getWebUIAnalyticsConfig }] = await Promise.all([
         import('../../web.js'),
         import('../../api/server-hono.js'),
@@ -30,7 +30,7 @@ export async function runWebMode(context) {
         console.info('For development: Run "pnpm dev" for hot reload');
     }
     const webUIConfig = webRoot ? { analytics: await getWebUIAnalyticsConfig() } : undefined;
-    await startHonoApiServer(agent, port, agent.config.agentCard || {}, derivedAgentId, resolvedPath, webRoot, webUIConfig);
+    await startHonoApiServer(agent, port, agent.config.agentCard || {}, derivedAgentId, resolvedPath, workspaceRoot, webRoot, webUIConfig);
     console.log(chalk.green(`✅ Server running at ${serverUrl}`));
     const webUpdateInfo = await getVersionCheckResult();
     if (webUpdateInfo) {

package/dist/index-main.js

@@ -351,8 +351,12 @@ async function bootstrapAgentFromGlobalOpts(options) {
     };
     const validatedConfig = AgentConfigSchema.parse(enrichedConfig);
     const services = await resolveServicesFromConfig(validatedConfig, image);
-    const agent = new DextoAgent(toDextoAgentOptions({ config: validatedConfig, services }));
+    const agent = new DextoAgent(toDextoAgentOptions({
+        config: validatedConfig,
+        services,
+    }));
     await agent.start();
+    await (await import('./utils/workspace.js')).applyWorkspaceToAgent(agent, workspaceRoot);
     // Register graceful shutdown
     const shutdown = async () => {
         try {
@@ -414,6 +418,7 @@ program
         logger.debug('WARNING: .env file not found; copy .env.example and set your API keys.');
     }
     const opts = program.opts();
+    const workspaceRoot = findDextoProjectRoot(process.cwd()) ?? process.cwd();
     // Set dev mode early to use local repo agents instead of ~/.dexto
     if (opts.dev) {
         process.env.DEXTO_DEV_MODE = 'true';
@@ -719,7 +724,6 @@ program
         // Enrichment adds filesystem paths to storage (schema has in-memory defaults)
         // Interactive CLI mode: only log to file (console would interfere with chat UI)
         const isInteractiveCli = opts.mode === 'cli';
-        const workspaceRoot = findDextoProjectRoot(process.cwd()) ?? process.cwd();
         const enrichedConfig = enrichAgentConfig(configWithImageDefaults, resolvedPath, {
             isInteractiveCli,
             logLevel: 'info', // CLI uses info-level logging for visibility
@@ -823,6 +827,7 @@ program
         // - other modes: start immediately (no approval support)
         if (opts.mode !== 'web' && opts.mode !== 'server' && opts.mode !== 'cli') {
             await agent.start();
+            await (await import('./utils/workspace.js')).applyWorkspaceToAgent(agent, workspaceRoot);
         }
         // Derive a concise agent ID for display purposes (used by API/UI)
         // Prefer agentCard.name, otherwise extract from filename
@@ -848,6 +853,7 @@ program
     await dispatchMainMode({
         agent,
         opts: mainModeOpts,
+        workspaceRoot,
         validatedConfig,
         resolvedPath,
         derivedAgentId,

package/dist/utils/workspace.d.ts

@@ -0,0 +1,9 @@
+import type { DextoAgent } from '@dexto/core';
+type WorkspaceAwareAgent = Pick<DextoAgent, 'getWorkspace' | 'setWorkspace'>;
+/**
+ * Keep the runtime workspace in sync with the host-resolved project root so
+ * prompt contributors and downstream services don't fall back to process.cwd().
+ */
+export declare function applyWorkspaceToAgent(agent: WorkspaceAwareAgent, workspaceRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/utils/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/utils/workspace.js

@@ -0,0 +1,17 @@
+/**
+ * Keep the runtime workspace in sync with the host-resolved project root so
+ * prompt contributors and downstream services don't fall back to process.cwd().
+ */
+export async function applyWorkspaceToAgent(agent, workspaceRoot) {
+    const normalizedWorkspaceRoot = workspaceRoot.trim();
+    if (!normalizedWorkspaceRoot) {
+        return;
+    }
+    const currentWorkspace = await agent.getWorkspace();
+    if (currentWorkspace?.path === normalizedWorkspaceRoot) {
+        return;
+    }
+    await agent.setWorkspace({
+        path: normalizedWorkspaceRoot,
+    });
+}