dexto 1.6.17 → 1.6.18

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":"AACA,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAezE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,KAAK,mBAAmB,GAAG,SAAS,GAAG,UAAU,CAAC;AAClD,KAAK,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC1D,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,4BAA4B;IACzC,SAAS,EAAE,uBAAuB,CAAC;IACnC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IACzD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC3D,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,WAAW,CAAA;KAAE,CAAC;CACpE;AAED,MAAM,WAAW,4BAA4B;IACzC,SAAS,EAAE,uBAAuB,CAAC;IACnC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,2BAA2B;IACxC,SAAS,EAAE,uBAAuB,CAAC;IACnC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAA;KAAE,CAAC;IAC7E,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,UAAU,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,2BAA2B;IACxC,SAAS,EAAE,uBAAuB,CAAC;IACnC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,KAAK,CAAC;QACV,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,uBAAuB,GAAG;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AA4lCF,wBAAsB,uBAAuB,CACzC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAgClC;AAED,wBAAsB,4BAA4B,CAC9C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,EACrC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,4BAA4B,CAAC,CA8GvC;AAED,wBAAsB,4BAA4B,CAC9C,YAAY,EAAE,MAAM,EACpB,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,4BAA4B,CAAC,CAgBvC;AAED,wBAAsB,wBAAwB,CAC1C,YAAY,EAAE,MAAM,EACpB,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAqCtC;AAED,wBAAsB,mCAAmC,CACrD,eAAe,EAAE,MAAM,EACvB,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAmDtC;AAkGD,wBAAsB,sBAAsB,CACxC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,qBAAqB,CAAC,CA8ChC;AA4ED,wBAAsB,iBAAiB,CAAC,aAAa,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa5F;AAED,wBAAsB,sBAAsB,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,GAAE,uBAA4B,EACrC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,wBAAwB,CAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,uBAAuB,CACzC,aAAa,GAAE,MAAsB,GACtC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,0BAA0B,GAAG,IAAI,CAmGjF"}
+{"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/index-main.js

@@ -351,7 +351,10 @@ 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();
     // Register graceful shutdown
     const shutdown = async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dexto",
-  "version": "1.6.17",
+  "version": "1.6.18",
   "type": "module",
   "bin": {
     "dexto": "./dist/index.js"
@@ -34,17 +34,17 @@
     "ws": "^8.18.1",
     "yaml": "^2.7.1",
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.17",
-    "@dexto/agent-management": "1.6.17",
-    "@dexto/analytics": "1.6.17",
-    "@dexto/client-sdk": "1.6.17",
-    "@dexto/core": "1.6.17",
-    "@dexto/image-local": "1.6.17",
-    "@dexto/image-logger-agent": "1.6.17",
-    "@dexto/registry": "1.6.17",
-    "@dexto/server": "1.6.17",
-    "@dexto/storage": "1.6.17",
-    "@dexto/tui": "1.6.17"
+    "@dexto/agent-config": "1.6.18",
+    "@dexto/agent-management": "1.6.18",
+    "@dexto/analytics": "1.6.18",
+    "@dexto/client-sdk": "1.6.18",
+    "@dexto/core": "1.6.18",
+    "@dexto/image-local": "1.6.18",
+    "@dexto/image-logger-agent": "1.6.18",
+    "@dexto/registry": "1.6.18",
+    "@dexto/server": "1.6.18",
+    "@dexto/storage": "1.6.18",
+    "@dexto/tui": "1.6.18"
   },
   "devDependencies": {
     "@types/ws": "^8.5.11",