toolcapsule 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ToolCapsule contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# ToolCapsule
+
+> Heavy MCP tools don't belong in your prompt. Put them in a ToolCapsule.
+
+**ToolCapsule** turns heavy MCP servers into lightweight, lazy-loaded, file-first **Agent Skills** with patch-and-retry workflows.
+
+It is not a replacement for MCP or Skills. It is the missing workflow layer between them:
+
+```text
+Heavy MCP server
+→ compact Agent Skill
+→ local args/content files
+→ auditable tool runs
+→ patch-and-retry recovery
+```
+
+## Why ToolCapsule
+
+MCP is becoming the standard way to connect agents to tools. Skills are becoming the standard way to package agent workflows.
+
+But large MCP servers can be expensive in agent contexts:
+
+- long tool descriptions and schemas may be visible every turn;
+- many turns do not need a real tool call;
+- document/workflow tools often carry large Markdown or JSON payloads;
+- failed tool calls force the model to regenerate the whole call.
+
+ToolCapsule keeps the MCP server as the source of truth, but exposes it through a lightweight Skill and local artifacts.
+
+## What is a ToolCapsule?
+
+A ToolCapsule is a file-first tool call package:
+
+```text
+capsule = MCP tool + args.json + payload files + run metadata + retry history
+```
+
+Instead of making the model hold everything in the prompt, ToolCapsule stores heavy payloads and run state on disk.
+
+## Quick start
+
+```bash
+npm i -g toolcapsule
+
+toolcapsule init feishu --url https://mcp.example.com/mcp/xxx
+toolcapsule tools feishu --brief
+toolcapsule describe feishu create-doc --brief
+toolcapsule call feishu create-doc @args.json --save-run
+toolcapsule retry runs/2026-06-06T10-00-00-000Z
+```
+
+Short alias:
+
+```bash
+tcap tools feishu --brief
+tcap call feishu create-doc @args.json --save-run
+```
+
+## What it generates
+
+```text
+.github/skills/feishu-mcp/
+  SKILL.md                  # lightweight Agent Skill entrypoint
+  toolcapsule.config.json   # MCP transport/profile config
+  scripts/README.md
+  runs/                     # auditable tool call records
+```
+
+This lets your agent discover the Skill instead of carrying the full MCP schema in every turn.
+
+## Native MCP vs ToolCapsule
+
+| Concern | Native MCP | ToolCapsule |
+|---|---|---|
+| Tool schemas | Often visible every turn | Loaded on demand |
+| Agent workflow | Direct tool call | Skill-guided workflow |
+| Large payloads | Generated inside tool calls | Stored as files |
+| Failed calls | Regenerate full tool call | Patch local file and retry |
+| Auditability | Host dependent | Run directory with request/response/error |
+| Best for | Small, high-frequency tools | Heavy SaaS/document/workflow MCPs |
+
+## Patch-and-retry
+
+When a large MCP call fails, do not ask the model to rewrite the whole tool call.
+
+```bash
+# 1. Call with a local args file
+toolcapsule call feishu create-doc @args.json --save-run
+
+# 2. Patch args.json or content.md
+
+# 3. Retry deterministically
+toolcapsule retry runs/2026-06-06T10-00-00-000Z
+```
+
+This is especially useful for MCP tools that create documents, tickets, pages, dashboards, reports, or batch operations.
+
+## Benchmark result
+
+In a Feishu MCP benchmark:
+
+- **88.4% fewer input tokens**;
+- **87.6% fewer total tokens**;
+- planning success rate stayed at **100%**.
+
+Results vary by MCP server, model, and host.
+
+## CLI
+
+```text
+toolcapsule init <name> --url <remote-mcp-url>
+toolcapsule init <name> --command <stdio-command> --arg <arg>
+toolcapsule tools <profile> --brief
+toolcapsule describe <profile> <tool> --brief
+toolcapsule call <profile> <tool> @args.json --save-run
+toolcapsule retry <run-dir>
+toolcapsule summarize <profile>
+toolcapsule benchmark <profile>
+```
+
+`tcap` is an equivalent short alias for `toolcapsule`.
+
+## Who is it for?
+
+ToolCapsule is useful when your MCP server is:
+
+- schema-heavy;
+- document/workflow oriented;
+- occasionally used rather than called every turn;
+- carrying large payloads;
+- hard to retry after failures.
+
+Examples: Feishu/Lark, Notion, Jira, Linear, Confluence, Google Docs, GitHub management tools, internal SaaS MCPs.
+
+## Project status
+
+Early alpha. APIs may change before v1.0.
+
+## Documentation
+
+- [Concept](docs/concept.md)
+- [Architecture](docs/architecture.md)
+- [Patch and retry](docs/patch-and-retry.md)
+- [Benchmark methodology](docs/benchmark-methodology.md)
+- [Release checklist](docs/release-checklist.md)
+- [Roadmap](ROADMAP.md)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,420 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFile as readFile3 } from "fs/promises";
+import { join as join4 } from "path";
+import { cac } from "cac";
+import pc from "picocolors";
+
+// src/mcp/client.ts
+import { spawn } from "child_process";
+import { once } from "events";
+var McpClient = class {
+  child;
+  nextId = 1;
+  buffer = "";
+  pending = /* @__PURE__ */ new Map();
+  timeoutMs;
+  constructor(profile, opts = {}) {
+    this.timeoutMs = opts.timeoutMs ?? Number(process.env.TOOLCAPSULE_TIMEOUT_MS || "45000");
+    if (profile.transport.type === "remote") {
+      this.child = spawn("npx", ["-y", "mcp-remote", profile.transport.url], {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+    } else {
+      this.child = spawn(profile.transport.command, profile.transport.args ?? [], {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+    }
+    this.child.stdout.setEncoding("utf8");
+    this.child.stdout.on("data", (chunk) => this.onStdout(chunk));
+    this.child.stderr.on("data", (chunk) => process.stderr.write(chunk));
+    this.child.on("exit", (code, signal) => {
+      const error = new Error(`MCP process exited early (code=${code}, signal=${signal})`);
+      for (const waiter of this.pending.values()) waiter.reject(error);
+      this.pending.clear();
+    });
+  }
+  onStdout(chunk) {
+    this.buffer += chunk;
+    let newlineIndex;
+    while ((newlineIndex = this.buffer.indexOf("\n")) >= 0) {
+      const line = this.buffer.slice(0, newlineIndex).trim();
+      this.buffer = this.buffer.slice(newlineIndex + 1);
+      if (!line) continue;
+      let message;
+      try {
+        message = JSON.parse(line);
+      } catch {
+        process.stderr.write(`${line}
+`);
+        continue;
+      }
+      if (typeof message.id === "number") {
+        const waiter = this.pending.get(message.id);
+        if (waiter) {
+          this.pending.delete(message.id);
+          waiter.resolve(message);
+        }
+      }
+    }
+  }
+  async init() {
+    await this.request("initialize", {
+      protocolVersion: "2025-03-26",
+      capabilities: {},
+      clientInfo: { name: "toolcapsule", version: "0.1.0" }
+    });
+    this.notify("notifications/initialized", {});
+  }
+  async request(method, params) {
+    const id = this.nextId++;
+    const responsePromise = new Promise((resolve2, reject) => {
+      this.pending.set(id, { resolve: resolve2, reject });
+    });
+    this.child.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", id, method, params })}
+`);
+    const response = await this.withTimeout(responsePromise, method);
+    if (response.error) throw new Error(`${method} failed: ${JSON.stringify(response.error, null, 2)}`);
+    return response.result;
+  }
+  notify(method, params) {
+    this.child.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", method, params })}
+`);
+  }
+  async listTools() {
+    return await this.request("tools/list", {});
+  }
+  async callTool(name, args) {
+    return await this.request("tools/call", { name, arguments: args });
+  }
+  async close() {
+    if (!this.child.killed) this.child.kill();
+    if (this.child.exitCode === null) await Promise.race([once(this.child, "exit"), new Promise((resolve2) => setTimeout(resolve2, 500))]);
+  }
+  async withTimeout(promise, label) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`${label} timed out after ${this.timeoutMs}ms`)), this.timeoutMs);
+    });
+    try {
+      return await Promise.race([promise, timeout]);
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  }
+};
+
+// src/profile.ts
+import { existsSync } from "fs";
+import { join } from "path";
+import { z } from "zod";
+
+// src/utils/fs.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+async function readJson(path) {
+  return JSON.parse(await readFile(path, "utf8"));
+}
+async function writeJson(path, value) {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, `${JSON.stringify(value, null, 2)}
+`);
+}
+
+// src/profile.ts
+var profileSchema = z.object({
+  name: z.string().min(1),
+  transport: z.union([
+    z.object({ type: z.literal("remote"), url: z.string().url() }),
+    z.object({ type: z.literal("stdio"), command: z.string().min(1), args: z.array(z.string()).optional() })
+  ]),
+  skill: z.object({
+    name: z.string().optional(),
+    description: z.string().optional()
+  }).optional(),
+  shortcuts: z.record(
+    z.object({
+      tool: z.string(),
+      description: z.string().optional(),
+      args: z.record(z.enum(["string", "file", "json", "boolean", "number"])).optional()
+    })
+  ).optional()
+});
+async function loadProfile(profilePathOrName) {
+  const candidates = [
+    profilePathOrName,
+    `${profilePathOrName}.json`,
+    join(".toolcapsule", "profiles", `${profilePathOrName}.json`),
+    join(".github", "skills", `${profilePathOrName}-mcp`, "toolcapsule.config.json")
+  ];
+  const found = candidates.find((path) => existsSync(path));
+  if (!found) throw new Error(`Profile not found: ${profilePathOrName}`);
+  return profileSchema.parse(await readJson(found));
+}
+
+// src/schema/brief.ts
+function toolTitle(tool) {
+  return tool.annotations?.title || tool.description?.split(/\n/)[0]?.slice(0, 100) || tool.name;
+}
+function briefTool(tool) {
+  const schema = tool.inputSchema;
+  const required = Array.isArray(schema?.required) ? schema.required : [];
+  const properties = schema?.properties && typeof schema.properties === "object" ? Object.keys(schema.properties) : [];
+  const flags = [
+    tool.annotations?.readOnlyHint ? "read-only" : void 0,
+    tool.annotations?.destructiveHint ? "destructive" : void 0
+  ].filter(Boolean);
+  return `- ${tool.name}: ${toolTitle(tool)}${flags.length ? ` [${flags.join(", ")}]` : ""}${required.length ? ` required=${required.join("|")}` : ""}${properties.length ? ` args=${properties.slice(0, 12).join("|")}` : ""}`;
+}
+function briefTools(tools) {
+  return tools.map(briefTool).join("\n");
+}
+
+// src/schema/summarize.ts
+function summarizeTool(tool) {
+  const schema = tool.inputSchema;
+  const properties = schema?.properties && typeof schema.properties === "object" ? schema.properties : {};
+  return {
+    name: tool.name,
+    title: tool.annotations?.title,
+    description: tool.description?.split(/\n\n/)[0]?.slice(0, 500),
+    annotations: tool.annotations,
+    required: Array.isArray(schema?.required) ? schema.required : [],
+    arguments: Object.fromEntries(
+      Object.entries(properties).map(([key, value]) => [
+        key,
+        { type: value?.type, enum: value?.enum, description: value?.description?.slice?.(0, 160) }
+      ])
+    )
+  };
+}
+function summarizeTools(tools) {
+  return tools.map(summarizeTool);
+}
+
+// src/skill/generator.ts
+import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname2, join as join2 } from "path";
+import Handlebars from "handlebars";
+var skillTemplate = `---
+name: {{skillName}}
+description: '{{description}}'
+argument-hint: 'MCP task, tool name, or args file to run'
+---
+
+# {{title}}
+
+This skill wraps an MCP server as a lightweight, lazy-loaded, file-first workflow.
+
+## Why use this skill
+
+- Keep full MCP tool schemas out of the model context until needed.
+- Use brief tool summaries for everyday work.
+- Store large payloads in local files such as \`args.json\` or \`content.md\`.
+- Patch local artifacts and retry failed calls deterministically.
+
+## Commands
+
+\`\`\`bash
+toolcapsule tools {{profileName}} --brief
+toolcapsule describe {{profileName}} <tool>
+toolcapsule call {{profileName}} <tool> @args.json
+toolcapsule retry <run-dir>
+\`\`\`
+
+## Workflow
+
+1. Use \`tools --brief\` to find the likely tool.
+2. Use \`describe <tool>\` only when the brief schema is insufficient.
+3. Put complex arguments in a local JSON file.
+4. Call with \`@args.json\` and save the run.
+5. On failure, patch the local file and run \`retry\`.
+
+## Safety
+
+- Do not fabricate IDs, URLs, user IDs, or opaque tokens.
+- Prefer local files for large payloads.
+- Do not print secrets.
+- Review destructive tools before calling.
+`;
+async function generateSkill(profile, opts = {}) {
+  const skillName = profile.skill?.name || `${profile.name}-mcp`;
+  const outputDir = opts.outputDir || join2(".github", "skills", skillName);
+  await mkdir2(join2(outputDir, "scripts"), { recursive: true });
+  await mkdir2(join2(outputDir, "runs"), { recursive: true });
+  const template = Handlebars.compile(skillTemplate);
+  const description = profile.skill?.description || `Use when operating tools from the ${profile.name} MCP server. Lazy-load schemas, call tools through local files, and retry failed calls by patching artifacts.`;
+  const markdown = template({
+    skillName,
+    profileName: profile.name,
+    title: `${profile.name} MCP Skill`,
+    description: description.replace(/'/g, "''")
+  });
+  await writeFile2(join2(outputDir, "SKILL.md"), markdown);
+  await writeJson(join2(outputDir, "toolcapsule.config.json"), profile);
+  await writeFile2(
+    join2(outputDir, "scripts", "README.md"),
+    `# Scripts
+
+This skill uses the project-level \`toolcapsule\` CLI.
+`
+  );
+  return outputDir;
+}
+async function writeProfile(path, profile) {
+  await mkdir2(dirname2(path), { recursive: true });
+  await writeJson(path, profile);
+}
+
+// src/runs/recorder.ts
+import { mkdir as mkdir3, readFile as readFile2, writeFile as writeFile3 } from "fs/promises";
+import { join as join3 } from "path";
+function createRunId() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+}
+async function saveRun(baseDir, record) {
+  const dir = join3(baseDir, record.id);
+  await mkdir3(dir, { recursive: true });
+  await writeJson(join3(dir, "run.json"), record);
+  await writeJson(join3(dir, "request.json"), record.request);
+  if (record.response !== void 0) await writeJson(join3(dir, "response.json"), record.response);
+  if (record.error) await writeFile3(join3(dir, "error.txt"), record.error);
+  await writeFile3(join3(dir, "command.txt"), `${record.command}
+`);
+  return dir;
+}
+async function loadRun(runDir) {
+  return JSON.parse(await readFile2(join3(runDir, "run.json"), "utf8"));
+}
+
+// src/utils/tokens.ts
+function roughTokens(value) {
+  const text = typeof value === "string" ? value : JSON.stringify(value);
+  return Math.ceil(text.length / 4);
+}
+function percentReduction(before, after) {
+  return before === 0 ? 0 : (before - after) / before * 100;
+}
+
+// src/cli.ts
+var cli = cac("toolcapsule");
+async function withClient(profile, fn) {
+  const client = new McpClient(profile);
+  try {
+    await client.init();
+    return await fn(client);
+  } finally {
+    await client.close();
+  }
+}
+function readArgsPath(raw) {
+  return raw.startsWith("@") ? raw.slice(1) : raw;
+}
+cli.command("init <name>", "Create a profile and generated Agent Skill for an MCP server").option("--url <url>", "Remote MCP URL").option("--command <command>", "stdio MCP command").option("--arg <arg>", "stdio MCP argument, repeatable", { type: [String] }).option("--output <dir>", "Skill output directory").action(async (name, options) => {
+  if (!options.url && !options.command) throw new Error("Provide --url for remote MCP or --command for stdio MCP");
+  const profile = options.url ? { name, transport: { type: "remote", url: options.url } } : { name, transport: { type: "stdio", command: options.command, args: options.arg ?? [] } };
+  await writeProfile(join4(".toolcapsule", "profiles", `${name}.json`), profile);
+  const out = await generateSkill(profile, options.output ? { outputDir: options.output } : {});
+  console.log(pc.green(`Created profile and skill at ${out}`));
+});
+cli.command("tools <profile>", "List MCP tools").option("--brief", "Print compact tool summaries").option("--names", "Print tool names only").option("--json", "Print raw JSON").action(async (profileName, options) => {
+  const profile = await loadProfile(profileName);
+  const result = await withClient(profile, (client) => client.listTools());
+  if (options.json) console.log(JSON.stringify(result, null, 2));
+  else if (options.names) console.log(result.tools.map((tool) => tool.name).join("\n"));
+  else console.log(briefTools(result.tools));
+});
+cli.command("describe <profile> <tool>", "Describe one MCP tool").option("--brief", "Print summarized schema instead of raw schema").action(async (profileName, toolName, options) => {
+  const profile = await loadProfile(profileName);
+  const result = await withClient(profile, (client) => client.listTools());
+  const tool = result.tools.find((item) => item.name === toolName);
+  if (!tool) throw new Error(`Tool not found: ${toolName}`);
+  console.log(JSON.stringify(options.brief ? summarizeTool(tool) : tool, null, 2));
+});
+cli.command("call <profile> <tool> <args>", "Call an MCP tool with JSON args or @args.json").option("--save-run", "Save request, response, and command under runs/").action(async (profileName, toolName, argsRaw, options) => {
+  const argsPath = readArgsPath(argsRaw);
+  const toolArgs = argsRaw.startsWith("@") ? await readJson(argsPath) : JSON.parse(argsRaw);
+  const profile = await loadProfile(profileName);
+  const request = { name: toolName, arguments: toolArgs };
+  const command = `toolcapsule call ${profileName} ${toolName} ${argsRaw}`;
+  const runId = createRunId();
+  try {
+    const response = await withClient(profile, (client) => client.callTool(toolName, toolArgs));
+    console.log(JSON.stringify(response, null, 2));
+    if (options.saveRun) {
+      const dir = await saveRun("runs", {
+        id: runId,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        profile: profileName,
+        tool: toolName,
+        argsFile: argsPath,
+        status: "success",
+        command,
+        request,
+        response
+      });
+      console.error(pc.green(`Saved run: ${dir}`));
+    }
+  } catch (error) {
+    if (options.saveRun) {
+      const dir = await saveRun("runs", {
+        id: runId,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        profile: profileName,
+        tool: toolName,
+        argsFile: argsPath,
+        status: "error",
+        command,
+        request,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      console.error(pc.yellow(`Saved failed run: ${dir}`));
+    }
+    throw error;
+  }
+});
+cli.command("retry <runDir>", "Retry a saved run, re-reading the args file").action(async (runDir) => {
+  const run = await loadRun(runDir);
+  const toolArgs = await readJson(run.argsFile);
+  const profile = await loadProfile(run.profile);
+  const response = await withClient(profile, (client) => client.callTool(run.tool, toolArgs));
+  console.log(JSON.stringify(response, null, 2));
+});
+cli.command("summarize <profile>", "Summarize all tools into compact JSON").action(async (profileName) => {
+  const profile = await loadProfile(profileName);
+  const result = await withClient(profile, (client) => client.listTools());
+  console.log(JSON.stringify(summarizeTools(result.tools), null, 2));
+});
+cli.command("benchmark <profile>", "Estimate schema savings for a profile").action(async (profileName) => {
+  const profile = await loadProfile(profileName);
+  const result = await withClient(profile, (client) => client.listTools());
+  const nativeTokens = roughTokens(result);
+  const brief = summarizeTools(result.tools);
+  const briefTokens = roughTokens(brief);
+  console.log(
+    JSON.stringify(
+      {
+        profile: profileName,
+        tools: result.tools.length,
+        nativeToolsRoughTokens: nativeTokens,
+        summarizedToolsRoughTokens: briefTokens,
+        estimatedReductionPct: Number(percentReduction(nativeTokens, briefTokens).toFixed(2))
+      },
+      null,
+      2
+    )
+  );
+});
+cli.command("render-readme", "Print website hero copy snippets").action(async () => {
+  console.log(await readFile3(new URL("../docs/hero-copy.md", import.meta.url), "utf8"));
+});
+cli.help();
+cli.version("0.1.0-alpha.0");
+try {
+  cli.parse();
+} catch (error) {
+  console.error(pc.red(error instanceof Error ? error.message : String(error)));
+  process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/mcp/client.ts","../src/profile.ts","../src/utils/fs.ts","../src/schema/brief.ts","../src/schema/summarize.ts","../src/skill/generator.ts","../src/runs/recorder.ts","../src/utils/tokens.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { cac } from \"cac\";\nimport pc from \"picocolors\";\nimport type { ProfileConfig } from \"./types.js\";\nimport { McpClient } from \"./mcp/client.js\";\nimport { loadProfile } from \"./profile.js\";\nimport { briefTools } from \"./schema/brief.js\";\nimport { summarizeTool, summarizeTools } from \"./schema/summarize.js\";\nimport { generateSkill, writeProfile } from \"./skill/generator.js\";\nimport { createRunId, loadRun, saveRun } from \"./runs/recorder.js\";\nimport { readJson } from \"./utils/fs.js\";\nimport { percentReduction, roughTokens } from \"./utils/tokens.js\";\n\nconst cli = cac(\"toolcapsule\");\n\nasync function withClient<T>(profile: ProfileConfig, fn: (client: McpClient) => Promise<T>): Promise<T> {\n  const client = new McpClient(profile);\n  try {\n    await client.init();\n    return await fn(client);\n  } finally {\n    await client.close();\n  }\n}\n\nfunction readArgsPath(raw: string): string {\n  return raw.startsWith(\"@\") ? raw.slice(1) : raw;\n}\n\ncli\n  .command(\"init <name>\", \"Create a profile and generated Agent Skill for an MCP server\")\n  .option(\"--url <url>\", \"Remote MCP URL\")\n  .option(\"--command <command>\", \"stdio MCP command\")\n  .option(\"--arg <arg>\", \"stdio MCP argument, repeatable\", { type: [String] })\n  .option(\"--output <dir>\", \"Skill output directory\")\n  .action(async (name: string, options: { url?: string; command?: string; arg?: string[]; output?: string }) => {\n    if (!options.url && !options.command) throw new Error(\"Provide --url for remote MCP or --command for stdio MCP\");\n    const profile: ProfileConfig = options.url\n      ? { name, transport: { type: \"remote\", url: options.url } }\n      : { name, transport: { type: \"stdio\", command: options.command!, args: options.arg ?? [] } };\n    await writeProfile(join(\".toolcapsule\", \"profiles\", `${name}.json`), profile);\n    const out = await generateSkill(profile, options.output ? { outputDir: options.output } : {});\n    console.log(pc.green(`Created profile and skill at ${out}`));\n  });\n\ncli\n  .command(\"tools <profile>\", \"List MCP tools\")\n  .option(\"--brief\", \"Print compact tool summaries\")\n  .option(\"--names\", \"Print tool names only\")\n  .option(\"--json\", \"Print raw JSON\")\n  .action(async (profileName: string, options: { brief?: boolean; names?: boolean; json?: boolean }) => {\n    const profile = await loadProfile(profileName);\n    const result = await withClient(profile, (client) => client.listTools());\n    if (options.json) console.log(JSON.stringify(result, null, 2));\n    else if (options.names) console.log(result.tools.map((tool) => tool.name).join(\"\\n\"));\n    else console.log(briefTools(result.tools));\n  });\n\ncli\n  .command(\"describe <profile> <tool>\", \"Describe one MCP tool\")\n  .option(\"--brief\", \"Print summarized schema instead of raw schema\")\n  .action(async (profileName: string, toolName: string, options: { brief?: boolean }) => {\n    const profile = await loadProfile(profileName);\n    const result = await withClient(profile, (client) => client.listTools());\n    const tool = result.tools.find((item) => item.name === toolName);\n    if (!tool) throw new Error(`Tool not found: ${toolName}`);\n    console.log(JSON.stringify(options.brief ? summarizeTool(tool) : tool, null, 2));\n  });\n\ncli\n  .command(\"call <profile> <tool> <args>\", \"Call an MCP tool with JSON args or @args.json\")\n  .option(\"--save-run\", \"Save request, response, and command under runs/\")\n  .action(async (profileName: string, toolName: string, argsRaw: string, options: { saveRun?: boolean }) => {\n    const argsPath = readArgsPath(argsRaw);\n    const toolArgs = argsRaw.startsWith(\"@\") ? await readJson(argsPath) : JSON.parse(argsRaw);\n    const profile = await loadProfile(profileName);\n    const request = { name: toolName, arguments: toolArgs };\n    const command = `toolcapsule call ${profileName} ${toolName} ${argsRaw}`;\n    const runId = createRunId();\n    try {\n      const response = await withClient(profile, (client) => client.callTool(toolName, toolArgs));\n      console.log(JSON.stringify(response, null, 2));\n      if (options.saveRun) {\n        const dir = await saveRun(\"runs\", {\n          id: runId,\n          createdAt: new Date().toISOString(),\n          profile: profileName,\n          tool: toolName,\n          argsFile: argsPath,\n          status: \"success\",\n          command,\n          request,\n          response,\n        });\n        console.error(pc.green(`Saved run: ${dir}`));\n      }\n    } catch (error) {\n      if (options.saveRun) {\n        const dir = await saveRun(\"runs\", {\n          id: runId,\n          createdAt: new Date().toISOString(),\n          profile: profileName,\n          tool: toolName,\n          argsFile: argsPath,\n          status: \"error\",\n          command,\n          request,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        console.error(pc.yellow(`Saved failed run: ${dir}`));\n      }\n      throw error;\n    }\n  });\n\ncli.command(\"retry <runDir>\", \"Retry a saved run, re-reading the args file\").action(async (runDir: string) => {\n  const run = await loadRun(runDir);\n  const toolArgs = await readJson(run.argsFile);\n  const profile = await loadProfile(run.profile);\n  const response = await withClient(profile, (client) => client.callTool(run.tool, toolArgs));\n  console.log(JSON.stringify(response, null, 2));\n});\n\ncli.command(\"summarize <profile>\", \"Summarize all tools into compact JSON\").action(async (profileName: string) => {\n  const profile = await loadProfile(profileName);\n  const result = await withClient(profile, (client) => client.listTools());\n  console.log(JSON.stringify(summarizeTools(result.tools), null, 2));\n});\n\ncli.command(\"benchmark <profile>\", \"Estimate schema savings for a profile\").action(async (profileName: string) => {\n  const profile = await loadProfile(profileName);\n  const result = await withClient(profile, (client) => client.listTools());\n  const nativeTokens = roughTokens(result);\n  const brief = summarizeTools(result.tools);\n  const briefTokens = roughTokens(brief);\n  console.log(\n    JSON.stringify(\n      {\n        profile: profileName,\n        tools: result.tools.length,\n        nativeToolsRoughTokens: nativeTokens,\n        summarizedToolsRoughTokens: briefTokens,\n        estimatedReductionPct: Number(percentReduction(nativeTokens, briefTokens).toFixed(2)),\n      },\n      null,\n      2,\n    ),\n  );\n});\n\ncli.command(\"render-readme\", \"Print website hero copy snippets\").action(async () => {\n  console.log(await readFile(new URL(\"../docs/hero-copy.md\", import.meta.url), \"utf8\"));\n});\n\ncli.help();\ncli.version(\"0.1.0-alpha.0\");\n\ntry {\n  cli.parse();\n} catch (error) {\n  console.error(pc.red(error instanceof Error ? error.message : String(error)));\n  process.exit(1);\n}\n","import { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { once } from \"node:events\";\nimport type { JsonRpcMessage, ProfileConfig, ToolsListResult } from \"../types.js\";\n\nexport type McpClientOptions = {\n  timeoutMs?: number;\n};\n\nexport class McpClient {\n  private child: ChildProcessWithoutNullStreams;\n  private nextId = 1;\n  private buffer = \"\";\n  private pending = new Map<\n    number,\n    { resolve: (value: JsonRpcMessage) => void; reject: (error: Error) => void }\n  >();\n  private timeoutMs: number;\n\n  constructor(profile: ProfileConfig, opts: McpClientOptions = {}) {\n    this.timeoutMs = opts.timeoutMs ?? Number(process.env.TOOLCAPSULE_TIMEOUT_MS || \"45000\");\n    if (profile.transport.type === \"remote\") {\n      this.child = spawn(\"npx\", [\"-y\", \"mcp-remote\", profile.transport.url], {\n        stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      });\n    } else {\n      this.child = spawn(profile.transport.command, profile.transport.args ?? [], {\n        stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      });\n    }\n    this.child.stdout.setEncoding(\"utf8\");\n    this.child.stdout.on(\"data\", (chunk: string) => this.onStdout(chunk));\n    this.child.stderr.on(\"data\", (chunk: Buffer) => process.stderr.write(chunk));\n    this.child.on(\"exit\", (code, signal) => {\n      const error = new Error(`MCP process exited early (code=${code}, signal=${signal})`);\n      for (const waiter of this.pending.values()) waiter.reject(error);\n      this.pending.clear();\n    });\n  }\n\n  private onStdout(chunk: string): void {\n    this.buffer += chunk;\n    let newlineIndex: number;\n    while ((newlineIndex = this.buffer.indexOf(\"\\n\")) >= 0) {\n      const line = this.buffer.slice(0, newlineIndex).trim();\n      this.buffer = this.buffer.slice(newlineIndex + 1);\n      if (!line) continue;\n      let message: JsonRpcMessage;\n      try {\n        message = JSON.parse(line) as JsonRpcMessage;\n      } catch {\n        process.stderr.write(`${line}\\n`);\n        continue;\n      }\n      if (typeof message.id === \"number\") {\n        const waiter = this.pending.get(message.id);\n        if (waiter) {\n          this.pending.delete(message.id);\n          waiter.resolve(message);\n        }\n      }\n    }\n  }\n\n  async init(): Promise<void> {\n    await this.request(\"initialize\", {\n      protocolVersion: \"2025-03-26\",\n      capabilities: {},\n      clientInfo: { name: \"toolcapsule\", version: \"0.1.0\" },\n    });\n    this.notify(\"notifications/initialized\", {});\n  }\n\n  async request(method: string, params?: unknown): Promise<unknown> {\n    const id = this.nextId++;\n    const responsePromise = new Promise<JsonRpcMessage>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject });\n    });\n    this.child.stdin.write(`${JSON.stringify({ jsonrpc: \"2.0\", id, method, params })}\\n`);\n    const response = await this.withTimeout(responsePromise, method);\n    if (response.error) throw new Error(`${method} failed: ${JSON.stringify(response.error, null, 2)}`);\n    return response.result;\n  }\n\n  notify(method: string, params?: unknown): void {\n    this.child.stdin.write(`${JSON.stringify({ jsonrpc: \"2.0\", method, params })}\\n`);\n  }\n\n  async listTools(): Promise<ToolsListResult> {\n    return (await this.request(\"tools/list\", {})) as ToolsListResult;\n  }\n\n  async callTool(name: string, args: unknown): Promise<unknown> {\n    return await this.request(\"tools/call\", { name, arguments: args });\n  }\n\n  async close(): Promise<void> {\n    if (!this.child.killed) this.child.kill();\n    if (this.child.exitCode === null) await Promise.race([once(this.child, \"exit\"), new Promise((resolve) => setTimeout(resolve, 500))]);\n  }\n\n  private async withTimeout<T>(promise: Promise<T>, label: string): Promise<T> {\n    let timer: NodeJS.Timeout | undefined;\n    const timeout = new Promise<never>((_, reject) => {\n      timer = setTimeout(() => reject(new Error(`${label} timed out after ${this.timeoutMs}ms`)), this.timeoutMs);\n    });\n    try {\n      return await Promise.race([promise, timeout]);\n    } finally {\n      if (timer) clearTimeout(timer);\n    }\n  }\n}\n","import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { z } from \"zod\";\nimport type { ProfileConfig } from \"./types.js\";\nimport { readJson } from \"./utils/fs.js\";\n\nconst profileSchema = z.object({\n  name: z.string().min(1),\n  transport: z.union([\n    z.object({ type: z.literal(\"remote\"), url: z.string().url() }),\n    z.object({ type: z.literal(\"stdio\"), command: z.string().min(1), args: z.array(z.string()).optional() }),\n  ]),\n  skill: z\n    .object({\n      name: z.string().optional(),\n      description: z.string().optional(),\n    })\n    .optional(),\n  shortcuts: z\n    .record(\n      z.object({\n        tool: z.string(),\n        description: z.string().optional(),\n        args: z.record(z.enum([\"string\", \"file\", \"json\", \"boolean\", \"number\"])).optional(),\n      }),\n    )\n    .optional(),\n});\n\nexport async function loadProfile(profilePathOrName: string): Promise<ProfileConfig> {\n  const candidates = [\n    profilePathOrName,\n    `${profilePathOrName}.json`,\n    join(\".toolcapsule\", \"profiles\", `${profilePathOrName}.json`),\n    join(\".github\", \"skills\", `${profilePathOrName}-mcp`, \"toolcapsule.config.json\"),\n  ];\n  const found = candidates.find((path) => existsSync(path));\n  if (!found) throw new Error(`Profile not found: ${profilePathOrName}`);\n  return profileSchema.parse(await readJson(found)) as ProfileConfig;\n}\n","import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\n\nexport async function readJson<T>(path: string): Promise<T> {\n  return JSON.parse(await readFile(path, \"utf8\")) as T;\n}\n\nexport async function writeJson(path: string, value: unknown): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, `${JSON.stringify(value, null, 2)}\\n`);\n}\n\nexport async function writeText(path: string, value: string): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, value);\n}\n\nexport function abs(path: string): string {\n  return resolve(process.cwd(), path);\n}\n","import type { McpTool } from \"../types.js\";\n\nexport function toolTitle(tool: McpTool): string {\n  return tool.annotations?.title || tool.description?.split(/\\n/)[0]?.slice(0, 100) || tool.name;\n}\n\nexport function briefTool(tool: McpTool): string {\n  const schema = tool.inputSchema as any;\n  const required = Array.isArray(schema?.required) ? schema.required : [];\n  const properties = schema?.properties && typeof schema.properties === \"object\" ? Object.keys(schema.properties) : [];\n  const flags = [\n    tool.annotations?.readOnlyHint ? \"read-only\" : undefined,\n    tool.annotations?.destructiveHint ? \"destructive\" : undefined,\n  ].filter(Boolean);\n  return `- ${tool.name}: ${toolTitle(tool)}${flags.length ? ` [${flags.join(\", \")}]` : \"\"}${required.length ? ` required=${required.join(\"|\")}` : \"\"}${properties.length ? ` args=${properties.slice(0, 12).join(\"|\")}` : \"\"}`;\n}\n\nexport function briefTools(tools: McpTool[]): string {\n  return tools.map(briefTool).join(\"\\n\");\n}\n","import type { McpTool } from \"../types.js\";\n\nexport function summarizeTool(tool: McpTool): unknown {\n  const schema = tool.inputSchema as any;\n  const properties = schema?.properties && typeof schema.properties === \"object\" ? schema.properties : {};\n  return {\n    name: tool.name,\n    title: tool.annotations?.title,\n    description: tool.description?.split(/\\n\\n/)[0]?.slice(0, 500),\n    annotations: tool.annotations,\n    required: Array.isArray(schema?.required) ? schema.required : [],\n    arguments: Object.fromEntries(\n      Object.entries(properties).map(([key, value]: [string, any]) => [\n        key,\n        { type: value?.type, enum: value?.enum, description: value?.description?.slice?.(0, 160) },\n      ]),\n    ),\n  };\n}\n\nexport function summarizeTools(tools: McpTool[]): unknown[] {\n  return tools.map(summarizeTool);\n}\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport Handlebars from \"handlebars\";\nimport type { ProfileConfig } from \"../types.js\";\nimport { writeJson } from \"../utils/fs.js\";\n\nconst skillTemplate = `---\nname: {{skillName}}\ndescription: '{{description}}'\nargument-hint: 'MCP task, tool name, or args file to run'\n---\n\n# {{title}}\n\nThis skill wraps an MCP server as a lightweight, lazy-loaded, file-first workflow.\n\n## Why use this skill\n\n- Keep full MCP tool schemas out of the model context until needed.\n- Use brief tool summaries for everyday work.\n- Store large payloads in local files such as \\`args.json\\` or \\`content.md\\`.\n- Patch local artifacts and retry failed calls deterministically.\n\n## Commands\n\n\\`\\`\\`bash\ntoolcapsule tools {{profileName}} --brief\ntoolcapsule describe {{profileName}} <tool>\ntoolcapsule call {{profileName}} <tool> @args.json\ntoolcapsule retry <run-dir>\n\\`\\`\\`\n\n## Workflow\n\n1. Use \\`tools --brief\\` to find the likely tool.\n2. Use \\`describe <tool>\\` only when the brief schema is insufficient.\n3. Put complex arguments in a local JSON file.\n4. Call with \\`@args.json\\` and save the run.\n5. On failure, patch the local file and run \\`retry\\`.\n\n## Safety\n\n- Do not fabricate IDs, URLs, user IDs, or opaque tokens.\n- Prefer local files for large payloads.\n- Do not print secrets.\n- Review destructive tools before calling.\n`;\n\nexport type GenerateSkillOptions = {\n  outputDir?: string;\n};\n\nexport async function generateSkill(profile: ProfileConfig, opts: GenerateSkillOptions = {}): Promise<string> {\n  const skillName = profile.skill?.name || `${profile.name}-mcp`;\n  const outputDir = opts.outputDir || join(\".github\", \"skills\", skillName);\n  await mkdir(join(outputDir, \"scripts\"), { recursive: true });\n  await mkdir(join(outputDir, \"runs\"), { recursive: true });\n\n  const template = Handlebars.compile(skillTemplate);\n  const description =\n    profile.skill?.description ||\n    `Use when operating tools from the ${profile.name} MCP server. Lazy-load schemas, call tools through local files, and retry failed calls by patching artifacts.`;\n  const markdown = template({\n    skillName,\n    profileName: profile.name,\n    title: `${profile.name} MCP Skill`,\n    description: description.replace(/'/g, \"''\"),\n  });\n  await writeFile(join(outputDir, \"SKILL.md\"), markdown);\n  await writeJson(join(outputDir, \"toolcapsule.config.json\"), profile);\n  await writeFile(\n    join(outputDir, \"scripts\", \"README.md\"),\n    `# Scripts\\n\\nThis skill uses the project-level \\`toolcapsule\\` CLI.\\n`,\n  );\n  return outputDir;\n}\n\nexport async function writeProfile(path: string, profile: ProfileConfig): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeJson(path, profile);\n}\n","import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { RunRecord } from \"../types.js\";\nimport { writeJson } from \"../utils/fs.js\";\n\nexport function createRunId(): string {\n  return new Date().toISOString().replace(/[:.]/g, \"-\");\n}\n\nexport async function saveRun(baseDir: string, record: RunRecord): Promise<string> {\n  const dir = join(baseDir, record.id);\n  await mkdir(dir, { recursive: true });\n  await writeJson(join(dir, \"run.json\"), record);\n  await writeJson(join(dir, \"request.json\"), record.request);\n  if (record.response !== undefined) await writeJson(join(dir, \"response.json\"), record.response);\n  if (record.error) await writeFile(join(dir, \"error.txt\"), record.error);\n  await writeFile(join(dir, \"command.txt\"), `${record.command}\\n`);\n  return dir;\n}\n\nexport async function loadRun(runDir: string): Promise<RunRecord> {\n  return JSON.parse(await readFile(join(runDir, \"run.json\"), \"utf8\")) as RunRecord;\n}\n","export function roughTokens(value: unknown): number {\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  return Math.ceil(text.length / 4);\n}\n\nexport function percentReduction(before: number, after: number): number {\n  return before === 0 ? 0 : ((before - after) / before) * 100;\n}\n"],"mappings":"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","names":["readFile","join","resolve","mkdir","writeFile","dirname","join","join","mkdir","writeFile","dirname","mkdir","readFile","writeFile","join","join","mkdir","writeFile","readFile","join","readFile"]}

package/docs/architecture.md

@@ -0,0 +1,18 @@
+# Architecture
+
+```mermaid
+flowchart TD
+  A[Remote or stdio MCP server] --> B[toolcapsule CLI]
+  B --> C[Tool cache and brief schema]
+  B --> D[Generated SKILL.md]
+  B --> E[Run artifacts]
+  E --> F[Patch and retry]
+```
+
+## Components
+
+- `McpClient`: speaks JSON-RPC over stdio, using `mcp-remote` for remote endpoints.
+- `Profile`: stores transport and shortcut configuration.
+- `Skill generator`: writes `SKILL.md` and profile config.
+- `Run recorder`: stores request, response, command, and error files.
+- `Schema helpers`: produce compact tool summaries.

package/docs/benchmark-methodology.md

@@ -0,0 +1,25 @@
+# Benchmark methodology
+
+A useful benchmark compares two modes with the same model, same prompts, and same scenarios.
+
+## Native MCP mode
+
+Every model call includes the complete MCP tool definitions.
+
+## Skill mode
+
+Every model call includes only compact Skill instructions and shortcut schemas.
+
+## Metrics
+
+- input tokens per turn;
+- total input tokens;
+- output tokens;
+- latency;
+- success rate;
+- repeated schema reads;
+- retry count.
+
+## Interpretation
+
+The benchmark estimates context savings. It does not automatically prove real tool-call success unless live tool execution is enabled.

package/docs/concept.md

@@ -0,0 +1,19 @@
+# Concept
+
+**ToolCapsule** is a lazy workflow layer for heavy MCP tools.
+
+MCP connects agents to tools. Skills package repeatable agent workflows. ToolCapsule sits between them: it keeps MCP as the source of truth, but turns schema-heavy tools into compact, file-first Agent Skills.
+
+## The idea
+
+```text
+MCP tool schema → compact Skill guidance → local capsule files → auditable run → patch and retry
+```
+
+## Principles
+
+1. Brief by default, full MCP schema on demand.
+2. Large tool payloads live in local files.
+3. Every call can be recorded as a ToolCapsule run.
+4. Failed calls should be patchable and retryable.
+5. MCP remains the capability layer; Skill becomes the agent-facing workflow layer.

package/docs/hero-copy.md

@@ -0,0 +1,13 @@
+# Hero copy
+
+Heavy MCP tools don't belong in your prompt.
+
+Put them in a ToolCapsule.
+
+ToolCapsule turns schema-heavy MCP servers into lightweight, lazy-loaded Agent Skills with file-first calls and patch-and-retry recovery.
+
+- Save context.
+- Generate Skills.
+- Store big payloads as files.
+- Patch failed calls.
+- Retry deterministically.

package/docs/patch-and-retry.md

@@ -0,0 +1,21 @@
+# Patch and retry
+
+Native MCP failures often require the model to regenerate a full tool call. For large payloads, that is expensive and error-prone.
+
+`toolcapsule` recommends file-first calls:
+
+```bash
+toolcapsule call feishu create-doc @args.json --save-run
+```
+
+If the call fails:
+
+1. inspect `runs/<id>/error.txt`;
+2. patch `args.json` or the referenced Markdown file;
+3. retry:
+
+```bash
+toolcapsule retry runs/<id>
+```
+
+This makes failures reproducible and local.

package/docs/release-checklist.md

@@ -0,0 +1,15 @@
+# Release checklist
+
+Before publishing v0.1.0:
+
+- [ ] Create the GitHub repository.
+- [ ] Replace any remaining placeholder links.
+- [ ] Confirm the npm package name `toolcapsule` is available, or choose a scoped package.
+- [ ] Connect the repository to Vercel.
+- [ ] Point `toolcapsule.studio` to Vercel.
+- [ ] Enable GitHub Discussions.
+- [ ] Add `NPM_TOKEN` or configure npm trusted publishing.
+- [ ] Review the security model for local command execution.
+- [ ] Run `pnpm run ci`.
+- [ ] Run CLI smoke tests with a mock MCP server.
+- [ ] Tag `v0.1.0-alpha.0` or publish manually with `pnpm publish --access public`.

package/examples/feishu/README.md

@@ -0,0 +1,9 @@
+# Feishu example
+
+```bash
+toolcapsule init feishu --url https://mcp.feishu.cn/mcp/your-endpoint
+tcap tools feishu --brief
+tcap call feishu create-doc @examples/feishu/args.create-doc.json --save-run
+```
+
+Use a test folder or wiki space for live writes.

package/examples/feishu/args.create-doc.json

@@ -0,0 +1,4 @@
+{
+  "title": "ToolCapsule test document",
+  "markdown": "## Hello\n\nThis document was generated from a local args file."
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "toolcapsule",
+  "version": "0.1.0-alpha.0",
+  "description": "File-first, patchable Agent Skills for heavy MCP tools.",
+  "type": "module",
+  "bin": {
+    "toolcapsule": "./dist/cli.js",
+    "tcap": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "docs",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "ci": "tsc --noEmit && eslint . && vitest run && tsup",
+    "smoke": "node dist/cli.js --help"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent-skills",
+    "skills",
+    "skill",
+    "tool-calling",
+    "function-calling",
+    "ai-agents",
+    "llm-tools",
+    "context-engineering",
+    "cli",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RainSunMe/toolcapsule.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RainSunMe/toolcapsule/issues"
+  },
+  "homepage": "https://toolcapsule.studio",
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@9.15.9",
+  "dependencies": {
+    "cac": "^6.7.14",
+    "execa": "^9.6.0",
+    "handlebars": "^4.7.8",
+    "picocolors": "^1.1.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/node": "^22.10.7",
+    "eslint": "^9.18.0",
+    "prettier": "^3.4.2",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0",
+    "vercel": "^54.9.1",
+    "vitest": "^2.1.8"
+  }
+}