@within-7/minto 0.4.0 → 0.4.2

package/dist/tools.js

@@ -1,9 +1,7 @@
-import { cacheToolDescriptions } from "./Tool.js";
+import { cacheToolDescriptions, getToolDescriptionAsync } from "./Tool.js";
 import { TaskTool } from "./tools/TaskTool/TaskTool.js";
 import { ArchitectTool } from "./tools/ArchitectTool/ArchitectTool.js";
 import { BashTool } from "./tools/BashTool/BashTool.js";
-import { BashOutputTool } from "./tools/BashOutputTool/BashOutputTool.js";
-import { KillShellTool } from "./tools/KillShellTool/KillShellTool.js";
 import { AskExpertModelTool } from "./tools/AskExpertModelTool/AskExpertModelTool.js";
 import { AskUserQuestionTool } from "./tools/AskUserQuestionTool/AskUserQuestionTool.js";
 import { FileEditTool } from "./tools/FileEditTool/FileEditTool.js";
@@ -33,20 +31,32 @@ import { TaskStopTool } from "./tools/TaskStopTool/TaskStopTool.js";
 import { SlashCommandTool } from "./tools/SlashCommandTool/SlashCommandTool.js";
 import { ListMcpResourcesTool } from "./tools/ListMcpResourcesTool/ListMcpResourcesTool.js";
 import { ReadMcpResourceTool } from "./tools/ReadMcpResourceTool/ReadMcpResourceTool.js";
-import { getMCPTools } from "./services/mcpClient.js";
+import { MCPSearchTool } from "./tools/MCPSearchTool/MCPSearchTool.js";
+import { EnterWorktreeTool } from "./tools/EnterWorktreeTool/EnterWorktreeTool.js";
+import { TeamCreateTool } from "./tools/TeamCreateTool/TeamCreateTool.js";
+import { SendMessageTool } from "./tools/SendMessageTool/SendMessageTool.js";
+import { TeamDeleteTool } from "./tools/TeamDeleteTool/TeamDeleteTool.js";
+import {
+  getMCPTools,
+  isMCPToolActivated
+} from "./services/mcpClient.js";
+import { getModelContextLength } from "./utils/model.js";
 import { memoize } from "lodash-es";
-const ANT_ONLY_TOOLS = [
-  MemoryReadTool,
-  MemoryWriteTool
-];
+const ANT_ONLY_TOOLS = [MemoryReadTool, MemoryWriteTool];
+function getToolSearchMode() {
+  const envVal = (process.env.MINTO_ENABLE_TOOL_SEARCH || process.env.ENABLE_TOOL_SEARCH || "auto").toLowerCase();
+  if (envVal === "always" || envVal === "1" || envVal === "true")
+    return "always";
+  if (envVal === "never" || envVal === "0" || envVal === "false") return "never";
+  return "auto";
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
 const getAllTools = () => {
   return [
-    TaskTool,
-    AskExpertModelTool,
-    AskUserQuestionTool,
+    // Static description tools (high cache hit rate)
     BashTool,
-    BashOutputTool,
-    KillShellTool,
     GlobTool,
     GrepTool,
     LSTool,
@@ -57,25 +67,35 @@ const getAllTools = () => {
     NotebookReadTool,
     NotebookEditTool,
     ThinkTool,
-    // Claude Code compatible task management tools
+    AskUserQuestionTool,
+    AskExpertModelTool,
+    // Task management tools
     TaskCreateTool,
     TaskUpdateTool,
     TaskGetTool,
     TaskListTool,
-    // Legacy TodoWrite (kept for backward compatibility, may be deprecated)
     TodoWriteTool,
     WebSearchTool,
     URLFetcherTool,
-    // Phase 4: Code intelligence and plan mode tools
+    // Plan mode and utility tools
     LspTool,
     EnterPlanModeTool,
     ExitPlanModeTool,
     TaskOutputTool,
     TaskStopTool,
     SlashCommandTool,
-    // Phase 3: MCP Resource tools
+    // MCP Resource tools
     ListMcpResourcesTool,
     ReadMcpResourceTool,
+    MCPSearchTool,
+    // Worktree isolation
+    EnterWorktreeTool,
+    // Agent Teams tools (conditionally enabled via isEnabled())
+    TeamCreateTool,
+    SendMessageTool,
+    TeamDeleteTool,
+    // Dynamic description tools last (description changes per-request, breaks cache after this point)
+    TaskTool,
     ...ANT_ONLY_TOOLS
   ];
 };
@@ -91,14 +111,74 @@ async function getBuiltInTools(enableArchitect, options) {
   }
   return enabledTools;
 }
+async function shouldDeferMCPTools(mcpTools) {
+  const mode = getToolSearchMode();
+  if (mode === "never") return false;
+  if (mode === "always") return mcpTools.length > 0;
+  if (mcpTools.length === 0) return false;
+  const contextLength = getModelContextLength("main");
+  const threshold = contextLength * 0.1;
+  let totalTokens = 0;
+  for (const tool of mcpTools) {
+    const desc = await getToolDescriptionAsync(tool);
+    totalTokens += estimateTokens(desc);
+    totalTokens += estimateTokens(tool.name);
+    if (tool.inputJSONSchema) {
+      totalTokens += estimateTokens(JSON.stringify(tool.inputJSONSchema));
+    }
+  }
+  return totalTokens > threshold;
+}
+async function partitionMCPTools(mcpTools) {
+  const { getDeferredMCPTools: getDeferred } = await import("./services/mcpClient.js");
+  const activeTools = [];
+  let deferredCount = 0;
+  for (const tool of mcpTools) {
+    if (isMCPToolActivated(tool.name)) {
+      activeTools.push(tool);
+    } else {
+      const desc = await getToolDescriptionAsync(tool);
+      const parts = tool.name.split("__");
+      const serverName = parts.length >= 2 ? parts[1] : "unknown";
+      const deferred = getDeferred();
+      if (!deferred.has(tool.name)) {
+        deferred.set(tool.name, {
+          name: tool.name,
+          description: desc,
+          serverName
+        });
+      }
+      deferredCount++;
+    }
+  }
+  return { activeTools, deferredCount };
+}
 const getTools = memoize(
   async (enableArchitect) => {
-    const tools = [...getAllTools(), ...await getMCPTools()];
+    const { isSimpleMode } = await import("./utils/simpleMode.js");
+    const mcpTools = isSimpleMode() ? [] : await getMCPTools();
+    const shouldDefer = await shouldDeferMCPTools(mcpTools);
+    let effectiveMCPTools;
+    if (shouldDefer) {
+      const { activeTools } = await partitionMCPTools(mcpTools);
+      effectiveMCPTools = activeTools;
+    } else {
+      effectiveMCPTools = mcpTools;
+    }
+    const tools = [...getAllTools(), ...effectiveMCPTools];
     if (enableArchitect) {
       tools.push(ArchitectTool);
     }
-    const isEnabled = await Promise.all(tools.map((tool) => tool.isEnabled()));
-    const enabledTools = tools.filter((_, i) => isEnabled[i]);
+    const seen = /* @__PURE__ */ new Set();
+    const uniqueTools = tools.filter((tool) => {
+      if (seen.has(tool.name)) return false;
+      seen.add(tool.name);
+      return true;
+    });
+    const isEnabled = await Promise.all(
+      uniqueTools.map((tool) => tool.isEnabled())
+    );
+    const enabledTools = uniqueTools.filter((_, i) => isEnabled[i]);
     await cacheToolDescriptions(enabledTools);
     return enabledTools;
   }

package/dist/tools.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/tools.ts"],
-  "sourcesContent": ["import { Tool, cacheToolDescriptions } from './Tool'\nimport { TaskTool } from './tools/TaskTool/TaskTool'\nimport { ArchitectTool } from './tools/ArchitectTool/ArchitectTool'\nimport { BashTool } from './tools/BashTool/BashTool'\nimport { BashOutputTool } from './tools/BashOutputTool/BashOutputTool'\nimport { KillShellTool } from './tools/KillShellTool/KillShellTool'\nimport { AskExpertModelTool } from './tools/AskExpertModelTool/AskExpertModelTool'\nimport { AskUserQuestionTool } from './tools/AskUserQuestionTool/AskUserQuestionTool'\nimport { FileEditTool } from './tools/FileEditTool/FileEditTool'\nimport { FileReadTool } from './tools/FileReadTool/FileReadTool'\nimport { FileWriteTool } from './tools/FileWriteTool/FileWriteTool'\nimport { GlobTool } from './tools/GlobTool/GlobTool'\nimport { GrepTool } from './tools/GrepTool/GrepTool'\nimport { LSTool } from './tools/LSTool/LSTool'\nimport { MemoryReadTool } from './tools/MemoryReadTool/MemoryReadTool'\nimport { MemoryWriteTool } from './tools/MemoryWriteTool/MemoryWriteTool'\nimport { MultiEditTool } from './tools/MultiEditTool/MultiEditTool'\nimport { NotebookEditTool } from './tools/NotebookEditTool/NotebookEditTool'\nimport { NotebookReadTool } from './tools/NotebookReadTool/NotebookReadTool'\nimport { ThinkTool } from './tools/ThinkTool/ThinkTool'\nimport { TodoWriteTool } from './tools/TodoWriteTool/TodoWriteTool'\n// Claude Code compatible task management tools\nimport { TaskCreateTool } from './tools/TaskCreateTool/TaskCreateTool'\nimport { TaskUpdateTool } from './tools/TaskUpdateTool/TaskUpdateTool'\nimport { TaskGetTool } from './tools/TaskGetTool/TaskGetTool'\nimport { TaskListTool } from './tools/TaskListTool/TaskListTool'\nimport { WebSearchTool } from './tools/WebSearchTool/WebSearchTool'\nimport { URLFetcherTool } from './tools/URLFetcherTool/URLFetcherTool'\n// Phase 4: New tools for Claude Code CLI compatibility\nimport { LspTool } from './tools/LspTool/LspTool'\nimport { EnterPlanModeTool } from './tools/PlanModeTool/EnterPlanModeTool'\nimport { ExitPlanModeTool } from './tools/PlanModeTool/ExitPlanModeTool'\nimport { TaskOutputTool } from './tools/TaskOutputTool/TaskOutputTool'\nimport { TaskStopTool } from './tools/TaskStopTool/TaskStopTool'\nimport { SlashCommandTool } from './tools/SlashCommandTool/SlashCommandTool'\n// Phase 3: MCP Resource tools\nimport { ListMcpResourcesTool } from './tools/ListMcpResourcesTool/ListMcpResourcesTool'\nimport { ReadMcpResourceTool } from './tools/ReadMcpResourceTool/ReadMcpResourceTool'\nimport { getMCPTools } from './services/mcpClient'\nimport { memoize } from 'lodash-es'\n\nconst ANT_ONLY_TOOLS = [\n  MemoryReadTool,\n  MemoryWriteTool,\n]\n\n// Function to avoid circular dependencies that break bun\nexport const getAllTools = (): Tool[] => {\n  return [\n    TaskTool,\n    AskExpertModelTool,\n    AskUserQuestionTool,\n    BashTool,\n    BashOutputTool,\n    KillShellTool,\n    GlobTool,\n    GrepTool,\n    LSTool,\n    FileReadTool,\n    FileEditTool,\n    MultiEditTool,\n    FileWriteTool,\n    NotebookReadTool,\n    NotebookEditTool,\n    ThinkTool,\n    // Claude Code compatible task management tools\n    TaskCreateTool,\n    TaskUpdateTool,\n    TaskGetTool,\n    TaskListTool,\n    // Legacy TodoWrite (kept for backward compatibility, may be deprecated)\n    TodoWriteTool,\n    WebSearchTool,\n    URLFetcherTool,\n    // Phase 4: Code intelligence and plan mode tools\n    LspTool,\n    EnterPlanModeTool,\n    ExitPlanModeTool,\n    TaskOutputTool,\n    TaskStopTool,\n    SlashCommandTool,\n    // Phase 3: MCP Resource tools\n    ListMcpResourcesTool,\n    ReadMcpResourceTool,\n    ...ANT_ONLY_TOOLS,\n  ]\n}\n\n/**\n * Get built-in tools only (no MCP tools, no network I/O).\n * Returns in <100ms - suitable for instant REPL startup.\n */\nexport async function getBuiltInTools(\n  enableArchitect?: boolean,\n  options?: { skipDescriptionCache?: boolean },\n): Promise<Tool[]> {\n  const tools = [...getAllTools()]\n  if (enableArchitect) {\n    tools.push(ArchitectTool)\n  }\n  const isEnabled = await Promise.all(tools.map(t => t.isEnabled()))\n  const enabledTools = tools.filter((_, i) => isEnabled[i])\n  if (!options?.skipDescriptionCache) {\n    await cacheToolDescriptions(enabledTools)\n  }\n  return enabledTools\n}\n\nexport const getTools = memoize(\n  async (enableArchitect?: boolean): Promise<Tool[]> => {\n    const tools = [...getAllTools(), ...(await getMCPTools())]\n\n    // Only include Architect tool if enabled via config or CLI flag\n    if (enableArchitect) {\n      tools.push(ArchitectTool)\n    }\n\n    const isEnabled = await Promise.all(tools.map(tool => tool.isEnabled()))\n    const enabledTools = tools.filter((_, i) => isEnabled[i])\n\n    // Cache tool descriptions for synchronous access in adapters\n    await cacheToolDescriptions(enabledTools)\n\n    return enabledTools\n  },\n)\n\nexport const getReadOnlyTools = memoize(async (): Promise<Tool[]> => {\n  const tools = getAllTools().filter(tool => tool.isReadOnly())\n  const isEnabled = await Promise.all(tools.map(tool => tool.isEnabled()))\n  return tools.filter((_, index) => isEnabled[index])\n})\n\n/**\n * Invalidate the tools cache to force refresh\n * This should be called when:\n * - MCP servers are connected/disconnected\n * - Tool configuration changes\n * - Plugin tools are added/removed\n */\nexport function invalidateToolsCache(): void {\n  getTools.cache.clear?.()\n  getReadOnlyTools.cache.clear?.()\n}\n\n/**\n * Reload tools with fresh data\n * Convenience function that invalidates cache and returns new tools\n */\nexport async function reloadTools(enableArchitect?: boolean): Promise<Tool[]> {\n  invalidateToolsCache()\n  return getTools(enableArchitect)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Tool, cacheToolDescriptions, getToolDescriptionAsync } from './Tool'\nimport { TaskTool } from './tools/TaskTool/TaskTool'\nimport { ArchitectTool } from './tools/ArchitectTool/ArchitectTool'\nimport { BashTool } from './tools/BashTool/BashTool'\n// BashOutputTool and KillShellTool removed \u2014 unified into TaskOutputTool and TaskStopTool (CC v2.0.62)\nimport { AskExpertModelTool } from './tools/AskExpertModelTool/AskExpertModelTool'\nimport { AskUserQuestionTool } from './tools/AskUserQuestionTool/AskUserQuestionTool'\nimport { FileEditTool } from './tools/FileEditTool/FileEditTool'\nimport { FileReadTool } from './tools/FileReadTool/FileReadTool'\nimport { FileWriteTool } from './tools/FileWriteTool/FileWriteTool'\nimport { GlobTool } from './tools/GlobTool/GlobTool'\nimport { GrepTool } from './tools/GrepTool/GrepTool'\nimport { LSTool } from './tools/LSTool/LSTool'\nimport { MemoryReadTool } from './tools/MemoryReadTool/MemoryReadTool'\nimport { MemoryWriteTool } from './tools/MemoryWriteTool/MemoryWriteTool'\nimport { MultiEditTool } from './tools/MultiEditTool/MultiEditTool'\nimport { NotebookEditTool } from './tools/NotebookEditTool/NotebookEditTool'\nimport { NotebookReadTool } from './tools/NotebookReadTool/NotebookReadTool'\nimport { ThinkTool } from './tools/ThinkTool/ThinkTool'\nimport { TodoWriteTool } from './tools/TodoWriteTool/TodoWriteTool'\n// Claude Code compatible task management tools\nimport { TaskCreateTool } from './tools/TaskCreateTool/TaskCreateTool'\nimport { TaskUpdateTool } from './tools/TaskUpdateTool/TaskUpdateTool'\nimport { TaskGetTool } from './tools/TaskGetTool/TaskGetTool'\nimport { TaskListTool } from './tools/TaskListTool/TaskListTool'\nimport { WebSearchTool } from './tools/WebSearchTool/WebSearchTool'\nimport { URLFetcherTool } from './tools/URLFetcherTool/URLFetcherTool'\n// Phase 4: New tools for Claude Code CLI compatibility\nimport { LspTool } from './tools/LspTool/LspTool'\nimport { EnterPlanModeTool } from './tools/PlanModeTool/EnterPlanModeTool'\nimport { ExitPlanModeTool } from './tools/PlanModeTool/ExitPlanModeTool'\nimport { TaskOutputTool } from './tools/TaskOutputTool/TaskOutputTool'\nimport { TaskStopTool } from './tools/TaskStopTool/TaskStopTool'\nimport { SlashCommandTool } from './tools/SlashCommandTool/SlashCommandTool'\n// Phase 3: MCP Resource tools\nimport { ListMcpResourcesTool } from './tools/ListMcpResourcesTool/ListMcpResourcesTool'\nimport { ReadMcpResourceTool } from './tools/ReadMcpResourceTool/ReadMcpResourceTool'\n// Tool Search (CC-aligned: ToolSearch, was MCPSearch)\nimport { MCPSearchTool } from './tools/MCPSearchTool/MCPSearchTool'\n// Worktree isolation\nimport { EnterWorktreeTool } from './tools/EnterWorktreeTool/EnterWorktreeTool'\n// Agent Teams tools\nimport { TeamCreateTool } from './tools/TeamCreateTool/TeamCreateTool'\nimport { SendMessageTool } from './tools/SendMessageTool/SendMessageTool'\nimport { TeamDeleteTool } from './tools/TeamDeleteTool/TeamDeleteTool'\nimport {\n  getMCPTools,\n  getDeferredMCPTools,\n  isMCPToolActivated,\n} from './services/mcpClient'\nimport { getModelContextLength } from './utils/model'\nimport { memoize } from 'lodash-es'\n\nconst ANT_ONLY_TOOLS = [MemoryReadTool, MemoryWriteTool]\n\n/**\n * Get the ENABLE_TOOL_SEARCH mode: \"auto\" | \"always\" | \"never\"\n */\nfunction getToolSearchMode(): 'auto' | 'always' | 'never' {\n  const envVal = (\n    process.env.MINTO_ENABLE_TOOL_SEARCH ||\n    process.env.ENABLE_TOOL_SEARCH ||\n    'auto'\n  ).toLowerCase()\n  if (envVal === 'always' || envVal === '1' || envVal === 'true')\n    return 'always'\n  if (envVal === 'never' || envVal === '0' || envVal === 'false') return 'never'\n  return 'auto'\n}\n\n/**\n * Estimate token count from a string (rough: chars / 4).\n */\nfunction estimateTokens(text: string): number {\n  return Math.ceil(text.length / 4)\n}\n\n// Function to avoid circular dependencies that break bun\nexport const getAllTools = (): Tool[] => {\n  // Tool ordering optimized for prompt caching:\n  // Static descriptions first (stable cache prefix), dynamic descriptions last\n  return [\n    // Static description tools (high cache hit rate)\n    BashTool,\n    GlobTool,\n    GrepTool,\n    LSTool,\n    FileReadTool,\n    FileEditTool,\n    MultiEditTool,\n    FileWriteTool,\n    NotebookReadTool,\n    NotebookEditTool,\n    ThinkTool,\n    AskUserQuestionTool,\n    AskExpertModelTool,\n    // Task management tools\n    TaskCreateTool,\n    TaskUpdateTool,\n    TaskGetTool,\n    TaskListTool,\n    TodoWriteTool,\n    WebSearchTool,\n    URLFetcherTool,\n    // Plan mode and utility tools\n    LspTool,\n    EnterPlanModeTool,\n    ExitPlanModeTool,\n    TaskOutputTool,\n    TaskStopTool,\n    SlashCommandTool,\n    // MCP Resource tools\n    ListMcpResourcesTool,\n    ReadMcpResourceTool,\n    MCPSearchTool,\n    // Worktree isolation\n    EnterWorktreeTool,\n    // Agent Teams tools (conditionally enabled via isEnabled())\n    TeamCreateTool,\n    SendMessageTool,\n    TeamDeleteTool,\n    // Dynamic description tools last (description changes per-request, breaks cache after this point)\n    TaskTool,\n    ...ANT_ONLY_TOOLS,\n  ]\n}\n\n/**\n * Get built-in tools only (no MCP tools, no network I/O).\n * Returns in <100ms - suitable for instant REPL startup.\n */\nexport async function getBuiltInTools(\n  enableArchitect?: boolean,\n  options?: { skipDescriptionCache?: boolean },\n): Promise<Tool[]> {\n  const tools = [...getAllTools()]\n  if (enableArchitect) {\n    tools.push(ArchitectTool)\n  }\n  const isEnabled = await Promise.all(tools.map(t => t.isEnabled()))\n  const enabledTools = tools.filter((_, i) => isEnabled[i])\n  if (!options?.skipDescriptionCache) {\n    await cacheToolDescriptions(enabledTools)\n  }\n  return enabledTools\n}\n\n/**\n * Determine whether MCP tools should use deferred/search mode.\n * In deferred mode, only ToolSearch + already-activated tools are included.\n * The rest are stored in the deferred registry for on-demand activation.\n */\nasync function shouldDeferMCPTools(mcpTools: Tool[]): Promise<boolean> {\n  const mode = getToolSearchMode()\n  if (mode === 'never') return false\n  if (mode === 'always') return mcpTools.length > 0\n\n  // \"auto\" mode: defer if MCP descriptions exceed 10% of context\n  if (mcpTools.length === 0) return false\n\n  const contextLength = getModelContextLength('main')\n  const threshold = contextLength * 0.1\n\n  // Estimate total MCP tool description token count\n  let totalTokens = 0\n  for (const tool of mcpTools) {\n    const desc = await getToolDescriptionAsync(tool)\n    totalTokens += estimateTokens(desc)\n    // Also account for the tool name and schema overhead\n    totalTokens += estimateTokens(tool.name)\n    if (tool.inputJSONSchema) {\n      totalTokens += estimateTokens(JSON.stringify(tool.inputJSONSchema))\n    }\n  }\n\n  return totalTokens > threshold\n}\n\n/**\n * Split MCP tools into active and deferred sets.\n * Active tools: already activated via ToolSearch.\n * Deferred tools: stored in the deferred registry with minimal metadata.\n */\nasync function partitionMCPTools(\n  mcpTools: Tool[],\n): Promise<{ activeTools: Tool[]; deferredCount: number }> {\n  const { getDeferredMCPTools: getDeferred } = await import(\n    './services/mcpClient'\n  )\n  const activeTools: Tool[] = []\n  let deferredCount = 0\n\n  for (const tool of mcpTools) {\n    if (isMCPToolActivated(tool.name)) {\n      activeTools.push(tool)\n    } else {\n      // Store in deferred registry\n      const desc = await getToolDescriptionAsync(tool)\n      // Extract server name from full tool name: mcp__serverName__toolName\n      const parts = tool.name.split('__')\n      const serverName = parts.length >= 2 ? parts[1] : 'unknown'\n\n      const deferred = getDeferred()\n      if (!deferred.has(tool.name)) {\n        deferred.set(tool.name, {\n          name: tool.name,\n          description: desc,\n          serverName,\n        })\n      }\n      deferredCount++\n    }\n  }\n\n  return { activeTools, deferredCount }\n}\n\nexport const getTools = memoize(\n  async (enableArchitect?: boolean): Promise<Tool[]> => {\n    // Skip MCP tools entirely in simple mode for faster startup\n    const { isSimpleMode } = await import('./utils/simpleMode')\n    const mcpTools = isSimpleMode() ? [] : await getMCPTools()\n    const shouldDefer = await shouldDeferMCPTools(mcpTools)\n\n    let effectiveMCPTools: Tool[]\n    if (shouldDefer) {\n      const { activeTools } = await partitionMCPTools(mcpTools)\n      effectiveMCPTools = activeTools\n    } else {\n      effectiveMCPTools = mcpTools\n    }\n\n    const tools = [...getAllTools(), ...effectiveMCPTools]\n\n    // Only include Architect tool if enabled via config or CLI flag\n    if (enableArchitect) {\n      tools.push(ArchitectTool)\n    }\n\n    // Deduplicate by tool name (built-in tools take priority over MCP duplicates)\n    const seen = new Set<string>()\n    const uniqueTools = tools.filter(tool => {\n      if (seen.has(tool.name)) return false\n      seen.add(tool.name)\n      return true\n    })\n\n    const isEnabled = await Promise.all(\n      uniqueTools.map(tool => tool.isEnabled()),\n    )\n    const enabledTools = uniqueTools.filter((_, i) => isEnabled[i])\n\n    // Cache tool descriptions for synchronous access in adapters\n    await cacheToolDescriptions(enabledTools)\n\n    return enabledTools\n  },\n)\n\nexport const getReadOnlyTools = memoize(async (): Promise<Tool[]> => {\n  const tools = getAllTools().filter(tool => tool.isReadOnly())\n  const isEnabled = await Promise.all(tools.map(tool => tool.isEnabled()))\n  return tools.filter((_, index) => isEnabled[index])\n})\n\n/**\n * Invalidate the tools cache to force refresh\n * This should be called when:\n * - MCP servers are connected/disconnected\n * - Tool configuration changes\n * - Plugin tools are added/removed\n * - MCP tools are activated via ToolSearch\n */\nexport function invalidateToolsCache(): void {\n  getTools.cache.clear?.()\n  getReadOnlyTools.cache.clear?.()\n}\n\n/**\n * Reload tools with fresh data\n * Convenience function that invalidates cache and returns new tools\n */\nexport async function reloadTools(enableArchitect?: boolean): Promise<Tool[]> {\n  invalidateToolsCache()\n  return getTools(enableArchitect)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/PermissionMode.js

@@ -1,5 +1,7 @@
 const PERMISSION_LEVELS = {
   plan: 0,
+  delegate: 0,
+  // Restricted like plan
   default: 1,
   acceptEdits: 2,
   dontAsk: 3,
@@ -33,9 +35,9 @@ const MODE_CONFIGS = {
     label: "ACCEPT EDITS",
     icon: "\u2705",
     color: "green",
-    description: "Auto-approve edit operations",
+    description: "Auto-approve file edits within working directory; other tools still follow normal permission flow",
     inlineIcon: "\u23F5\u23F5",
-    inlineLabel: "accept edits on",
+    inlineLabel: "auto-accept edits on",
     inlineColor: "green",
     compactLabel: "edits",
     allowedTools: ["*"],
@@ -50,7 +52,7 @@ const MODE_CONFIGS = {
     label: "DONT ASK",
     icon: "\u{1F92B}",
     color: "cyan",
-    description: "Trust agent - no permission prompts",
+    description: "Auto-deny tools not in permissions.allow; safe/read-only tools still allowed",
     inlineIcon: "\u23F5\u23F5",
     inlineLabel: "don't ask on",
     inlineColor: "cyan",
@@ -88,6 +90,31 @@ const MODE_CONFIGS = {
       bypassValidation: false
     }
   },
+  delegate: {
+    name: "delegate",
+    label: "DELEGATE",
+    icon: "\u{1F465}",
+    color: "magenta",
+    description: "Delegate mode - team/task tools only",
+    inlineIcon: "\u{1F465}",
+    inlineLabel: "delegate mode on",
+    inlineColor: "magenta",
+    compactLabel: "delegate",
+    allowedTools: [
+      "TeamCreate",
+      "TeamDelete",
+      "SendMessage",
+      "TaskCreate",
+      "TaskGet",
+      "TaskUpdate",
+      "TaskList"
+    ],
+    restrictions: {
+      readOnly: false,
+      requireConfirmation: true,
+      bypassValidation: false
+    }
+  },
   bypassPermissions: {
     name: "bypassPermissions",
     label: "BYPASS PERMISSIONS",
@@ -106,18 +133,20 @@ const MODE_CONFIGS = {
     }
   }
 };
-function getNextPermissionMode(currentMode, isBypassAvailable = true) {
+function getNextPermissionMode(currentMode, isBypassAvailable = false) {
   switch (currentMode) {
     case "default":
       return "acceptEdits";
     case "acceptEdits":
-      return "dontAsk";
-    case "dontAsk":
       return "plan";
     case "plan":
       return isBypassAvailable ? "bypassPermissions" : "default";
     case "bypassPermissions":
       return "default";
+    // System-managed modes: cycle back to default
+    case "dontAsk":
+    case "delegate":
+      return "default";
     default:
       return "default";
   }

package/dist/types/PermissionMode.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/types/PermissionMode.ts"],
-  "sourcesContent": ["// Permission mode types retained for compatibility with earlier agent implementations\n// Extended for Claude Code specification compliance\nexport type PermissionMode =\n  | 'default' // Normal permission checking\n  | 'acceptEdits' // Auto-approve file edit operations\n  | 'dontAsk' // Trust agent, no permission prompts (Claude Code spec)\n  | 'plan' // Read-only research and planning mode\n  | 'bypassPermissions' // All permissions bypassed (dangerous)\n\n// Permission level hierarchy for validation\n// Lower number = more restrictive\nexport const PERMISSION_LEVELS: Record<PermissionMode, number> = {\n  plan: 0,\n  default: 1,\n  acceptEdits: 2,\n  dontAsk: 3,\n  bypassPermissions: 4,\n}\n\n/**\n * Validate that agent permission mode does not exceed session permission level\n * Returns the effective permission mode (capped at session level)\n */\nexport function validateAgentPermission(\n  agentMode: PermissionMode,\n  sessionMode: PermissionMode,\n): PermissionMode {\n  const agentLevel = PERMISSION_LEVELS[agentMode] ?? 1\n  const sessionLevel = PERMISSION_LEVELS[sessionMode] ?? 1\n  return agentLevel <= sessionLevel ? agentMode : sessionMode\n}\n\nexport interface PermissionContext {\n  mode: PermissionMode\n  allowedTools: string[]\n  allowedPaths: string[]\n  restrictions: {\n    readOnly: boolean\n    requireConfirmation: boolean\n    bypassValidation: boolean\n  }\n  metadata: {\n    activatedAt?: string\n    previousMode?: PermissionMode\n    transitionCount: number\n  }\n}\n\nexport interface ModeConfig {\n  name: PermissionMode\n  label: string\n  icon: string\n  color: string\n  description: string\n  /** Claude Code-style inline icon for footer display (e.g. '\u23F5\u23F5', '\u23F8') */\n  inlineIcon: string\n  /** Claude Code-style short label for footer display (e.g. 'accept edits on') */\n  inlineLabel: string\n  /** Terminal color name for the inline footer indicator */\n  inlineColor: string\n  /** Short compact label for persistent right-side badge (e.g. 'edits', 'plan') */\n  compactLabel: string\n  allowedTools: string[]\n  restrictions: {\n    readOnly: boolean\n    requireConfirmation: boolean\n    bypassValidation: boolean\n  }\n}\n\n// Mode configuration preserved for Claude Code parity\nexport const MODE_CONFIGS: Record<PermissionMode, ModeConfig> = {\n  default: {\n    name: 'default',\n    label: 'DEFAULT',\n    icon: '\uD83D\uDD12',\n    color: 'blue',\n    description: 'Standard permission checking',\n    inlineIcon: '',\n    inlineLabel: '',\n    inlineColor: '',\n    compactLabel: '',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: true,\n      bypassValidation: false,\n    },\n  },\n  acceptEdits: {\n    name: 'acceptEdits',\n    label: 'ACCEPT EDITS',\n    icon: '\u2705',\n    color: 'green',\n    description: 'Auto-approve edit operations',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: 'accept edits on',\n    inlineColor: 'green',\n    compactLabel: 'edits',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: false,\n    },\n  },\n  dontAsk: {\n    name: 'dontAsk',\n    label: 'DONT ASK',\n    icon: '\uD83E\uDD2B',\n    color: 'cyan',\n    description: 'Trust agent - no permission prompts',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: \"don't ask on\",\n    inlineColor: 'cyan',\n    compactLabel: 'auto',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: false,\n    },\n  },\n  plan: {\n    name: 'plan',\n    label: 'PLAN MODE',\n    icon: '\uD83D\uDCDD',\n    color: 'yellow',\n    description: 'Research and planning - read-only tools only',\n    inlineIcon: '\u23F8',\n    inlineLabel: 'plan mode on',\n    inlineColor: 'yellow',\n    compactLabel: 'plan',\n    allowedTools: [\n      'Read',\n      'Grep',\n      'Glob',\n      'LS',\n      'WebSearch',\n      'WebFetch',\n      'NotebookRead',\n      'exit_plan_mode',\n    ],\n    restrictions: {\n      readOnly: true,\n      requireConfirmation: true,\n      bypassValidation: false,\n    },\n  },\n  bypassPermissions: {\n    name: 'bypassPermissions',\n    label: 'BYPASS PERMISSIONS',\n    icon: '\uD83D\uDD13',\n    color: 'red',\n    description: 'All permissions bypassed',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: 'bypass permissions on',\n    inlineColor: 'red',\n    compactLabel: 'bypass',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: true,\n    },\n  },\n}\n\n// Mode cycling function preserved from the Claude Code workflow\nexport function getNextPermissionMode(\n  currentMode: PermissionMode,\n  isBypassAvailable: boolean = true,\n): PermissionMode {\n  switch (currentMode) {\n    case 'default':\n      return 'acceptEdits'\n    case 'acceptEdits':\n      return 'dontAsk'\n    case 'dontAsk':\n      return 'plan'\n    case 'plan':\n      return isBypassAvailable ? 'bypassPermissions' : 'default'\n    case 'bypassPermissions':\n      return 'default'\n    default:\n      return 'default'\n  }\n}\n"],
-  "mappings": "AAWO,MAAM,oBAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,SAAS;AAAA,EACT,mBAAmB;AACrB;AAMO,SAAS,wBACd,WACA,aACgB;AAChB,QAAM,aAAa,kBAAkB,SAAS,KAAK;AACnD,QAAM,eAAe,kBAAkB,WAAW,KAAK;AACvD,SAAO,cAAc,eAAe,YAAY;AAClD;AAyCO,MAAM,eAAmD;AAAA,EAC9D,SAAS;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AACF;AAGO,SAAS,sBACd,aACA,oBAA6B,MACb;AAChB,UAAQ,aAAa;AAAA,IACnB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,oBAAoB,sBAAsB;AAAA,IACnD,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;",
+  "sourcesContent": ["// Permission mode types retained for compatibility with earlier agent implementations\n// Extended for Claude Code specification compliance\nexport type PermissionMode =\n  | 'default' // Normal permission checking \u2014 prompts for each tool\n  | 'acceptEdits' // Auto-approve file edits within working directory; Bash still asks\n  | 'dontAsk' // Auto-deny tools not in permissions.allow; safe tools still allowed\n  | 'plan' // Read-only research and planning mode\n  | 'delegate' // Team/task tools only (Minto Shift+Tab delegate mode)\n  | 'bypassPermissions' // All permissions bypassed (dangerous)\n\n// Permission level hierarchy for validation\n// Lower number = more restrictive\nexport const PERMISSION_LEVELS: Record<PermissionMode, number> = {\n  plan: 0,\n  delegate: 0, // Restricted like plan\n  default: 1,\n  acceptEdits: 2,\n  dontAsk: 3,\n  bypassPermissions: 4,\n}\n\n/**\n * Validate that agent permission mode does not exceed session permission level\n * Returns the effective permission mode (capped at session level)\n */\nexport function validateAgentPermission(\n  agentMode: PermissionMode,\n  sessionMode: PermissionMode,\n): PermissionMode {\n  const agentLevel = PERMISSION_LEVELS[agentMode] ?? 1\n  const sessionLevel = PERMISSION_LEVELS[sessionMode] ?? 1\n  return agentLevel <= sessionLevel ? agentMode : sessionMode\n}\n\nexport interface PermissionContext {\n  mode: PermissionMode\n  allowedTools: string[]\n  allowedPaths: string[]\n  restrictions: {\n    readOnly: boolean\n    requireConfirmation: boolean\n    bypassValidation: boolean\n  }\n  metadata: {\n    activatedAt?: string\n    previousMode?: PermissionMode\n    transitionCount: number\n  }\n}\n\nexport interface ModeConfig {\n  name: PermissionMode\n  label: string\n  icon: string\n  color: string\n  description: string\n  /** Claude Code-style inline icon for footer display (e.g. '\u23F5\u23F5', '\u23F8') */\n  inlineIcon: string\n  /** Claude Code-style short label for footer display (e.g. 'accept edits on') */\n  inlineLabel: string\n  /** Terminal color name for the inline footer indicator */\n  inlineColor: string\n  /** Short compact label for persistent right-side badge (e.g. 'edits', 'plan') */\n  compactLabel: string\n  allowedTools: string[]\n  restrictions: {\n    readOnly: boolean\n    requireConfirmation: boolean\n    bypassValidation: boolean\n  }\n}\n\n// Mode configuration preserved for Claude Code parity\nexport const MODE_CONFIGS: Record<PermissionMode, ModeConfig> = {\n  default: {\n    name: 'default',\n    label: 'DEFAULT',\n    icon: '\uD83D\uDD12',\n    color: 'blue',\n    description: 'Standard permission checking',\n    inlineIcon: '',\n    inlineLabel: '',\n    inlineColor: '',\n    compactLabel: '',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: true,\n      bypassValidation: false,\n    },\n  },\n  acceptEdits: {\n    name: 'acceptEdits',\n    label: 'ACCEPT EDITS',\n    icon: '\u2705',\n    color: 'green',\n    description:\n      'Auto-approve file edits within working directory; other tools still follow normal permission flow',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: 'auto-accept edits on',\n    inlineColor: 'green',\n    compactLabel: 'edits',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: false,\n    },\n  },\n  dontAsk: {\n    name: 'dontAsk',\n    label: 'DONT ASK',\n    icon: '\uD83E\uDD2B',\n    color: 'cyan',\n    description:\n      'Auto-deny tools not in permissions.allow; safe/read-only tools still allowed',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: \"don't ask on\",\n    inlineColor: 'cyan',\n    compactLabel: 'auto',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: false,\n    },\n  },\n  plan: {\n    name: 'plan',\n    label: 'PLAN MODE',\n    icon: '\uD83D\uDCDD',\n    color: 'yellow',\n    description: 'Research and planning - read-only tools only',\n    inlineIcon: '\u23F8',\n    inlineLabel: 'plan mode on',\n    inlineColor: 'yellow',\n    compactLabel: 'plan',\n    allowedTools: [\n      'Read',\n      'Grep',\n      'Glob',\n      'LS',\n      'WebSearch',\n      'WebFetch',\n      'NotebookRead',\n      'exit_plan_mode',\n    ],\n    restrictions: {\n      readOnly: true,\n      requireConfirmation: true,\n      bypassValidation: false,\n    },\n  },\n  delegate: {\n    name: 'delegate',\n    label: 'DELEGATE',\n    icon: '\uD83D\uDC65',\n    color: 'magenta',\n    description: 'Delegate mode - team/task tools only',\n    inlineIcon: '\uD83D\uDC65',\n    inlineLabel: 'delegate mode on',\n    inlineColor: 'magenta',\n    compactLabel: 'delegate',\n    allowedTools: [\n      'TeamCreate',\n      'TeamDelete',\n      'SendMessage',\n      'TaskCreate',\n      'TaskGet',\n      'TaskUpdate',\n      'TaskList',\n    ],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: true,\n      bypassValidation: false,\n    },\n  },\n  bypassPermissions: {\n    name: 'bypassPermissions',\n    label: 'BYPASS PERMISSIONS',\n    icon: '\uD83D\uDD13',\n    color: 'red',\n    description: 'All permissions bypassed',\n    inlineIcon: '\u23F5\u23F5',\n    inlineLabel: 'bypass permissions on',\n    inlineColor: 'red',\n    compactLabel: 'bypass',\n    allowedTools: ['*'],\n    restrictions: {\n      readOnly: false,\n      requireConfirmation: false,\n      bypassValidation: true,\n    },\n  },\n}\n\n/**\n * User-facing Shift+Tab cycle for permission modes.\n *\n * Only modes safe for interactive use are included:\n *   default \u2192 acceptEdits \u2192 plan \u2192 [bypassPermissions] \u2192 default\n *\n * Excluded from manual cycling (system-managed only):\n * - `dontAsk`: Designed for CI/CD \u2014 auto-denies tools not in permissions.allow.\n *              Switching to this interactively would break the AI's ability to work.\n *              Activate via CLI flag or programmatic setMode().\n * - `delegate`: Only meaningful when a team is active \u2014 restricts to coordination\n *              tools only. Without an active team, the AI becomes completely inoperable.\n *              Activate programmatically when spawning team workflows.\n */\nexport function getNextPermissionMode(\n  currentMode: PermissionMode,\n  isBypassAvailable: boolean = false,\n): PermissionMode {\n  switch (currentMode) {\n    case 'default':\n      return 'acceptEdits'\n    case 'acceptEdits':\n      return 'plan'\n    case 'plan':\n      return isBypassAvailable ? 'bypassPermissions' : 'default'\n    case 'bypassPermissions':\n      return 'default'\n    // System-managed modes: cycle back to default\n    case 'dontAsk':\n    case 'delegate':\n      return 'default'\n    default:\n      return 'default'\n  }\n}\n"],
+  "mappings": "AAYO,MAAM,oBAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,UAAU;AAAA;AAAA,EACV,SAAS;AAAA,EACT,aAAa;AAAA,EACb,SAAS;AAAA,EACT,mBAAmB;AACrB;AAMO,SAAS,wBACd,WACA,aACgB;AAChB,QAAM,aAAa,kBAAkB,SAAS,KAAK;AACnD,QAAM,eAAe,kBAAkB,WAAW,KAAK;AACvD,SAAO,cAAc,eAAe,YAAY;AAClD;AAyCO,MAAM,eAAmD;AAAA,EAC9D,SAAS;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc,CAAC,GAAG;AAAA,IAClB,cAAc;AAAA,MACZ,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,IACpB;AAAA,EACF;AACF;AAgBO,SAAS,sBACd,aACA,oBAA6B,OACb;AAChB,UAAQ,aAAa;AAAA,IACnB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,oBAAoB,sBAAsB;AAAA,IACnD,KAAK;AACH,aAAO;AAAA;AAAA,IAET,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;",
   "names": []
 }

package/dist/types/hooks.js

@@ -16,6 +16,8 @@ var HookEvent = /* @__PURE__ */ ((HookEvent2) => {
   HookEvent2["ConfigChange"] = "ConfigChange";
   HookEvent2["TaskCompleted"] = "TaskCompleted";
   HookEvent2["TeammateIdle"] = "TeammateIdle";
+  HookEvent2["WorktreeCreate"] = "WorktreeCreate";
+  HookEvent2["WorktreeRemove"] = "WorktreeRemove";
   return HookEvent2;
 })(HookEvent || {});
 const HookDefinitionSchema = z.object({

package/dist/types/hooks.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/types/hooks.ts"],
-  "sourcesContent": ["/**\n * Hooks System Type Definitions\n */\n\nimport { z } from 'zod'\n\n/**\n * Hook lifecycle events\n * Full Claude Code CLI compatible set\n */\nexport enum HookEvent {\n  // Tool lifecycle\n  PreToolUse = 'PreToolUse',\n  PostToolUse = 'PostToolUse',\n  PostToolUseFailure = 'PostToolUseFailure',\n\n  // Permission events\n  PermissionRequest = 'PermissionRequest',\n\n  // User interaction\n  UserPromptSubmit = 'UserPromptSubmit',\n\n  // Session lifecycle\n  SessionStart = 'SessionStart',\n  SessionEnd = 'SessionEnd',\n\n  // Execution control\n  Stop = 'Stop',\n\n  // Subagent lifecycle\n  SubagentStart = 'SubagentStart',\n  SubagentStop = 'SubagentStop',\n\n  // Notifications\n  Notification = 'Notification',\n\n  // Context management\n  PreCompact = 'PreCompact',\n  PostCompact = 'PostCompact',\n\n  // Configuration\n  ConfigChange = 'ConfigChange',\n\n  // Task lifecycle\n  TaskCompleted = 'TaskCompleted',\n\n  // Team collaboration\n  TeammateIdle = 'TeammateIdle',\n}\n\n/**\n * Hook execution types\n */\nexport type HookType = 'command' | 'prompt' | 'agent'\n\n/**\n * Hook matcher configuration\n */\nexport interface HookMatcher {\n  /** Pattern to match tool names (regex supported). Use \"*\" or \"\" to match all. */\n  matcher?: string\n\n  /** Pattern to match tool input fields (regex values). CC community compatible. */\n  toolInput?: Record<string, string>\n\n  /** Array of hooks to execute when matcher matches */\n  hooks: HookDefinition[]\n}\n\n/**\n * Individual hook definition\n */\nexport interface HookDefinition {\n  /** Hook execution type */\n  type: HookType\n\n  /** Bash command to execute (for type=\"command\") */\n  command?: string\n\n  /** Prompt to send to LLM (for type=\"prompt\" or type=\"agent\") */\n  prompt?: string\n\n  /** Optional timeout in seconds (default: 30 for command, 30 for prompt, 60 for agent) */\n  timeout?: number\n\n  /** Optional description of what this hook does */\n  description?: string\n\n  /** Run hook asynchronously (fire-and-forget, result via systemMessage next turn) */\n  async?: boolean\n\n  /** Only execute once per session */\n  once?: boolean\n}\n\n/**\n * hooks.json file schema\n */\nexport interface HooksConfig {\n  /** Optional description for plugin hooks */\n  description?: string\n\n  /** Hook configurations by event type */\n  hooks: Partial<Record<HookEvent, HookMatcher[]>>\n}\n\n/**\n * Hook execution input (passed to hook as JSON stdin)\n */\nexport interface HookInput {\n  /** Session identifier */\n  session_id: string\n\n  /** Path to conversation transcript */\n  transcript_path: string\n\n  /** Current working directory */\n  cwd: string\n\n  /** Permission mode (default, plan, acceptEdits, bypassPermissions) */\n  permission_mode: string\n\n  /** Hook event name */\n  hook_event_name: HookEvent\n\n  /** Event-specific additional fields */\n  [key: string]: any\n}\n\n/**\n * PreToolUse hook input\n */\nexport interface PreToolUseInput extends HookInput {\n  hook_event_name: HookEvent.PreToolUse\n  tool_name: string\n  tool_input: Record<string, unknown>\n}\n\n/**\n * PostToolUse hook input\n */\nexport interface PostToolUseInput extends HookInput {\n  hook_event_name: HookEvent.PostToolUse\n  tool_name: string\n  tool_input: Record<string, unknown>\n  tool_output: Record<string, unknown>\n}\n\n/**\n * PostToolUseFailure hook input (new)\n */\nexport interface PostToolUseFailureInput extends HookInput {\n  hook_event_name: HookEvent.PostToolUseFailure\n  tool_name: string\n  tool_input: Record<string, unknown>\n  error: string\n  error_type?: string\n}\n\n/**\n * PermissionRequest hook input (new)\n */\nexport interface PermissionRequestInput extends HookInput {\n  hook_event_name: HookEvent.PermissionRequest\n  tool_name: string\n  tool_input: Record<string, unknown>\n  permission_type: 'read' | 'write' | 'execute' | 'network' | 'other'\n  description?: string\n}\n\n/**\n * UserPromptSubmit hook input\n */\nexport interface UserPromptSubmitInput extends HookInput {\n  hook_event_name: HookEvent.UserPromptSubmit\n  user_prompt: string\n}\n\n/**\n * SessionStart hook input\n */\nexport interface SessionStartInput extends HookInput {\n  hook_event_name: HookEvent.SessionStart\n  source: 'startup' | 'resume' | 'clear' | 'compact'\n}\n\n/**\n * SessionEnd hook input\n */\nexport interface SessionEndInput extends HookInput {\n  hook_event_name: HookEvent.SessionEnd\n  reason: 'clear' | 'logout' | 'prompt_input_exit' | 'other'\n}\n\n/**\n * Stop hook input\n */\nexport interface StopInput extends HookInput {\n  hook_event_name: HookEvent.Stop\n  stop_hook_active: boolean\n}\n\n/**\n * SubagentStart hook input (new)\n */\nexport interface SubagentStartInput extends HookInput {\n  hook_event_name: HookEvent.SubagentStart\n  agent_type: string\n  agent_description?: string\n  run_in_background?: boolean\n}\n\n/**\n * SubagentStop hook input\n */\nexport interface SubagentStopInput extends HookInput {\n  hook_event_name: HookEvent.SubagentStop\n  agent_type: string\n  agent_id?: string\n  stop_hook_active: boolean\n}\n\n/**\n * Notification hook input\n */\nexport interface NotificationInput extends HookInput {\n  hook_event_name: HookEvent.Notification\n  message: string\n}\n\n/**\n * PreCompact hook input\n */\nexport interface PreCompactInput extends HookInput {\n  hook_event_name: HookEvent.PreCompact\n  trigger: 'manual' | 'auto'\n  custom_instructions: string\n}\n\n/**\n * PostCompact hook input\n */\nexport interface PostCompactInput extends HookInput {\n  hook_event_name: HookEvent.PostCompact\n  trigger: 'manual' | 'auto'\n  summary: string\n  compression_ratio: number\n  original_tokens: number\n  compressed_tokens: number\n}\n\n/**\n * ConfigChange hook input\n */\nexport interface ConfigChangeInput extends HookInput {\n  hook_event_name: HookEvent.ConfigChange\n  source: 'settings' | 'project' | 'global' | 'env' | 'cli'\n  file_path?: string\n}\n\n/**\n * TaskCompleted hook input\n */\nexport interface TaskCompletedInput extends HookInput {\n  hook_event_name: HookEvent.TaskCompleted\n  task_id: string\n  subject: string\n  description?: string\n}\n\n/**\n * TeammateIdle hook input\n */\nexport interface TeammateIdleInput extends HookInput {\n  hook_event_name: HookEvent.TeammateIdle\n  teammate_name: string\n  team_name: string\n}\n\n/**\n * Hook execution output (from hook stdout as JSON)\n */\nexport interface HookOutput {\n  /** Whether Claude should continue after hook execution */\n  continue?: boolean\n\n  /** Message shown when continue is false */\n  stopReason?: string\n\n  /** Hide stdout from transcript mode */\n  suppressOutput?: boolean\n\n  /** Optional warning message shown to user */\n  systemMessage?: string\n\n  /** Hook-specific output fields */\n  hookSpecificOutput?: HookSpecificOutput\n\n  /** Deprecated: Use hookSpecificOutput.permissionDecision instead */\n  decision?: 'approve' | 'block'\n\n  /** Deprecated: Use hookSpecificOutput.permissionDecisionReason instead */\n  reason?: string\n}\n\n/**\n * Hook-specific output for different events\n */\nexport type HookSpecificOutput =\n  | PreToolUseOutput\n  | PostToolUseOutput\n  | UserPromptSubmitOutput\n  | SessionStartOutput\n\n/**\n * PreToolUse hook-specific output\n */\nexport interface PreToolUseOutput {\n  hookEventName: HookEvent.PreToolUse\n\n  /** Permission decision: allow (bypass), deny (block), ask (prompt user) */\n  permissionDecision: 'allow' | 'deny' | 'ask'\n\n  /** Reason shown to user (allow/ask) or Claude (deny) */\n  permissionDecisionReason?: string\n\n  /** Modified tool input parameters */\n  updatedInput?: Record<string, unknown>\n}\n\n/**\n * PostToolUse hook-specific output\n */\nexport interface PostToolUseOutput {\n  hookEventName: HookEvent.PostToolUse\n\n  /** Additional context for Claude to consider */\n  additionalContext?: string\n}\n\n/**\n * UserPromptSubmit hook-specific output\n */\nexport interface UserPromptSubmitOutput {\n  hookEventName: HookEvent.UserPromptSubmit\n\n  /** Additional context to add to conversation */\n  additionalContext?: string\n}\n\n/**\n * SessionStart hook-specific output\n */\nexport interface SessionStartOutput {\n  hookEventName: HookEvent.SessionStart\n\n  /** Additional context to load at session start */\n  additionalContext?: string\n}\n\n/**\n * Hook execution result (internal)\n */\nexport interface HookExecutionResult {\n  /** Whether hook execution succeeded */\n  success: boolean\n\n  /** Exit code from hook command */\n  exitCode: number\n\n  /** Standard output */\n  stdout: string\n\n  /** Standard error */\n  stderr: string\n\n  /** Parsed JSON output (if valid) */\n  output?: HookOutput\n\n  /** Error if execution failed */\n  error?: Error\n\n  /** Execution time in milliseconds */\n  executionTime: number\n}\n\n/**\n * Zod schema for hooks.json validation\n */\nexport const HookDefinitionSchema = z.object({\n  type: z.enum(['command', 'prompt', 'agent']),\n  command: z.string().optional(),\n  prompt: z.string().optional(),\n  timeout: z.number().optional(),\n  description: z.string().optional(),\n  async: z.boolean().optional(),\n  once: z.boolean().optional(),\n})\n\nexport const HookMatcherSchema = z.object({\n  matcher: z.string().optional(),\n  toolInput: z.record(z.string()).optional(),\n  hooks: z.array(HookDefinitionSchema),\n})\n\nexport const HooksConfigSchema = z.object({\n  description: z.string().optional(),\n  hooks: z\n    .record(z.nativeEnum(HookEvent), z.array(HookMatcherSchema))\n    .optional(),\n})\n\n/**\n * Hook execution context (passed to executor)\n */\nexport interface HookExecutionContext {\n  /** Hook definition to execute */\n  hook: HookDefinition\n\n  /** Hook input data */\n  input: HookInput\n\n  /** Environment variables to pass to hook */\n  env?: Record<string, string>\n\n  /** Abort signal for cancellation */\n  abortSignal?: AbortSignal\n}\n\n/**\n * Hook decision result (processed from hook output)\n */\nexport interface HookDecision {\n  /** Allow the action */\n  allow: boolean\n\n  /** Block the action */\n  block: boolean\n\n  /** Ask user for confirmation */\n  ask: boolean\n\n  /** Reason for decision */\n  reason?: string\n\n  /** Message to show to user */\n  systemMessage?: string\n\n  /** Stop execution entirely */\n  stop: boolean\n\n  /** Stop reason */\n  stopReason?: string\n\n  /** Additional context to inject */\n  additionalContext?: string\n\n  /** Modified tool input (for PreToolUse) */\n  updatedInput?: Record<string, unknown>\n}\n\n/**\n * Loaded hook (runtime representation)\n */\nexport interface LoadedHook {\n  /** Hook name/identifier */\n  name: string\n\n  /** File path to hook definition */\n  filePath: string\n\n  /** Hook configuration */\n  config: HookDefinition\n\n  /** Source plugin name */\n  pluginName: string\n\n  /** Hook event this hook responds to */\n  event: HookEvent\n\n  /** Matcher pattern (if applicable) */\n  matcher?: string\n}\n"],
-  "mappings": "AAIA,SAAS,SAAS;AAMX,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,wBAAqB;AAGrB,EAAAA,WAAA,uBAAoB;AAGpB,EAAAA,WAAA,sBAAmB;AAGnB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAGb,EAAAA,WAAA,UAAO;AAGP,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,iBAAc;AAGd,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,kBAAe;AArCL,SAAAA;AAAA,GAAA;AA2XL,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,KAAK,CAAC,WAAW,UAAU,OAAO,CAAC;AAAA,EAC3C,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC5B,MAAM,EAAE,QAAQ,EAAE,SAAS;AAC7B,CAAC;AAEM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACzC,OAAO,EAAE,MAAM,oBAAoB;AACrC,CAAC;AAEM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EACJ,OAAO,EAAE,WAAW,SAAS,GAAG,EAAE,MAAM,iBAAiB,CAAC,EAC1D,SAAS;AACd,CAAC;",
+  "sourcesContent": ["/**\n * Hooks System Type Definitions\n */\n\nimport { z } from 'zod'\n\n/**\n * Hook lifecycle events\n * Full Claude Code CLI compatible set\n */\nexport enum HookEvent {\n  // Tool lifecycle\n  PreToolUse = 'PreToolUse',\n  PostToolUse = 'PostToolUse',\n  PostToolUseFailure = 'PostToolUseFailure',\n\n  // Permission events\n  PermissionRequest = 'PermissionRequest',\n\n  // User interaction\n  UserPromptSubmit = 'UserPromptSubmit',\n\n  // Session lifecycle\n  SessionStart = 'SessionStart',\n  SessionEnd = 'SessionEnd',\n\n  // Execution control\n  Stop = 'Stop',\n\n  // Subagent lifecycle\n  SubagentStart = 'SubagentStart',\n  SubagentStop = 'SubagentStop',\n\n  // Notifications\n  Notification = 'Notification',\n\n  // Context management\n  PreCompact = 'PreCompact',\n  PostCompact = 'PostCompact',\n\n  // Configuration\n  ConfigChange = 'ConfigChange',\n\n  // Task lifecycle\n  TaskCompleted = 'TaskCompleted',\n\n  // Team collaboration\n  TeammateIdle = 'TeammateIdle',\n\n  // Worktree lifecycle\n  WorktreeCreate = 'WorktreeCreate',\n  WorktreeRemove = 'WorktreeRemove',\n}\n\n/**\n * Hook execution types\n */\nexport type HookType = 'command' | 'prompt' | 'agent'\n\n/**\n * Hook matcher configuration\n */\nexport interface HookMatcher {\n  /** Pattern to match tool names (regex supported). Use \"*\" or \"\" to match all. */\n  matcher?: string\n\n  /** Pattern to match tool input fields (regex values). CC community compatible. */\n  toolInput?: Record<string, string>\n\n  /** Array of hooks to execute when matcher matches */\n  hooks: HookDefinition[]\n}\n\n/**\n * Individual hook definition\n */\nexport interface HookDefinition {\n  /** Hook execution type */\n  type: HookType\n\n  /** Bash command to execute (for type=\"command\") */\n  command?: string\n\n  /** Prompt to send to LLM (for type=\"prompt\" or type=\"agent\") */\n  prompt?: string\n\n  /** Optional timeout in seconds (default: 30 for command, 30 for prompt, 60 for agent) */\n  timeout?: number\n\n  /** Optional description of what this hook does */\n  description?: string\n\n  /** Run hook asynchronously (fire-and-forget, result via systemMessage next turn) */\n  async?: boolean\n\n  /** Only execute once per session */\n  once?: boolean\n}\n\n/**\n * hooks.json file schema\n */\nexport interface HooksConfig {\n  /** Optional description for plugin hooks */\n  description?: string\n\n  /** Hook configurations by event type */\n  hooks: Partial<Record<HookEvent, HookMatcher[]>>\n}\n\n/**\n * Hook execution input (passed to hook as JSON stdin)\n */\nexport interface HookInput {\n  /** Session identifier */\n  session_id: string\n\n  /** Path to conversation transcript */\n  transcript_path: string\n\n  /** Current working directory */\n  cwd: string\n\n  /** Permission mode (default, plan, acceptEdits, bypassPermissions) */\n  permission_mode: string\n\n  /** Hook event name */\n  hook_event_name: HookEvent\n\n  /** Event-specific additional fields */\n  [key: string]: any\n}\n\n/**\n * PreToolUse hook input\n */\nexport interface PreToolUseInput extends HookInput {\n  hook_event_name: HookEvent.PreToolUse\n  tool_name: string\n  tool_input: Record<string, unknown>\n}\n\n/**\n * PostToolUse hook input\n */\nexport interface PostToolUseInput extends HookInput {\n  hook_event_name: HookEvent.PostToolUse\n  tool_name: string\n  tool_input: Record<string, unknown>\n  tool_output: Record<string, unknown>\n}\n\n/**\n * PostToolUseFailure hook input (new)\n */\nexport interface PostToolUseFailureInput extends HookInput {\n  hook_event_name: HookEvent.PostToolUseFailure\n  tool_name: string\n  tool_input: Record<string, unknown>\n  error: string\n  error_type?: string\n}\n\n/**\n * PermissionRequest hook input (new)\n */\nexport interface PermissionRequestInput extends HookInput {\n  hook_event_name: HookEvent.PermissionRequest\n  tool_name: string\n  tool_input: Record<string, unknown>\n  permission_type: 'read' | 'write' | 'execute' | 'network' | 'other'\n  description?: string\n}\n\n/**\n * UserPromptSubmit hook input\n */\nexport interface UserPromptSubmitInput extends HookInput {\n  hook_event_name: HookEvent.UserPromptSubmit\n  user_prompt: string\n}\n\n/**\n * SessionStart hook input\n */\nexport interface SessionStartInput extends HookInput {\n  hook_event_name: HookEvent.SessionStart\n  source: 'startup' | 'resume' | 'clear' | 'compact'\n}\n\n/**\n * SessionEnd hook input\n */\nexport interface SessionEndInput extends HookInput {\n  hook_event_name: HookEvent.SessionEnd\n  reason: 'clear' | 'logout' | 'prompt_input_exit' | 'other'\n}\n\n/**\n * Stop hook input\n */\nexport interface StopInput extends HookInput {\n  hook_event_name: HookEvent.Stop\n  stop_hook_active: boolean\n}\n\n/**\n * SubagentStart hook input (new)\n */\nexport interface SubagentStartInput extends HookInput {\n  hook_event_name: HookEvent.SubagentStart\n  agent_type: string\n  agent_description?: string\n  run_in_background?: boolean\n}\n\n/**\n * SubagentStop hook input\n */\nexport interface SubagentStopInput extends HookInput {\n  hook_event_name: HookEvent.SubagentStop\n  agent_type: string\n  agent_id?: string\n  stop_hook_active: boolean\n}\n\n/**\n * Notification hook input\n */\nexport interface NotificationInput extends HookInput {\n  hook_event_name: HookEvent.Notification\n  message: string\n}\n\n/**\n * PreCompact hook input\n */\nexport interface PreCompactInput extends HookInput {\n  hook_event_name: HookEvent.PreCompact\n  trigger: 'manual' | 'auto'\n  custom_instructions: string\n}\n\n/**\n * PostCompact hook input\n */\nexport interface PostCompactInput extends HookInput {\n  hook_event_name: HookEvent.PostCompact\n  trigger: 'manual' | 'auto'\n  summary: string\n  compression_ratio: number\n  original_tokens: number\n  compressed_tokens: number\n}\n\n/**\n * ConfigChange hook input\n */\nexport interface ConfigChangeInput extends HookInput {\n  hook_event_name: HookEvent.ConfigChange\n  source: 'settings' | 'project' | 'global' | 'env' | 'cli'\n  file_path?: string\n}\n\n/**\n * TaskCompleted hook input\n */\nexport interface TaskCompletedInput extends HookInput {\n  hook_event_name: HookEvent.TaskCompleted\n  task_id: string\n  subject: string\n  description?: string\n}\n\n/**\n * TeammateIdle hook input\n */\nexport interface TeammateIdleInput extends HookInput {\n  hook_event_name: HookEvent.TeammateIdle\n  teammate_name: string\n  team_name: string\n}\n\n/**\n * WorktreeCreate hook input\n */\nexport interface WorktreeCreateInput extends HookInput {\n  hook_event_name: HookEvent.WorktreeCreate\n  worktree_path: string\n  agent_id: string\n  agent_type: string\n}\n\n/**\n * WorktreeRemove hook input\n */\nexport interface WorktreeRemoveInput extends HookInput {\n  hook_event_name: HookEvent.WorktreeRemove\n  worktree_path: string\n  agent_id: string\n  agent_type: string\n  success: boolean\n}\n\n/**\n * Hook execution output (from hook stdout as JSON)\n */\nexport interface HookOutput {\n  /** Whether Claude should continue after hook execution */\n  continue?: boolean\n\n  /** Message shown when continue is false */\n  stopReason?: string\n\n  /** Hide stdout from transcript mode */\n  suppressOutput?: boolean\n\n  /** Optional warning message shown to user */\n  systemMessage?: string\n\n  /** Hook-specific output fields */\n  hookSpecificOutput?: HookSpecificOutput\n\n  /** Deprecated: Use hookSpecificOutput.permissionDecision instead */\n  decision?: 'approve' | 'block'\n\n  /** Deprecated: Use hookSpecificOutput.permissionDecisionReason instead */\n  reason?: string\n}\n\n/**\n * Hook-specific output for different events\n */\nexport type HookSpecificOutput =\n  | PreToolUseOutput\n  | PostToolUseOutput\n  | UserPromptSubmitOutput\n  | SessionStartOutput\n\n/**\n * PreToolUse hook-specific output\n */\nexport interface PreToolUseOutput {\n  hookEventName: HookEvent.PreToolUse\n\n  /** Permission decision: allow (bypass), deny (block), ask (prompt user) */\n  permissionDecision: 'allow' | 'deny' | 'ask'\n\n  /** Reason shown to user (allow/ask) or Claude (deny) */\n  permissionDecisionReason?: string\n\n  /** Modified tool input parameters */\n  updatedInput?: Record<string, unknown>\n}\n\n/**\n * PostToolUse hook-specific output\n */\nexport interface PostToolUseOutput {\n  hookEventName: HookEvent.PostToolUse\n\n  /** Additional context for Claude to consider */\n  additionalContext?: string\n}\n\n/**\n * UserPromptSubmit hook-specific output\n */\nexport interface UserPromptSubmitOutput {\n  hookEventName: HookEvent.UserPromptSubmit\n\n  /** Additional context to add to conversation */\n  additionalContext?: string\n}\n\n/**\n * SessionStart hook-specific output\n */\nexport interface SessionStartOutput {\n  hookEventName: HookEvent.SessionStart\n\n  /** Additional context to load at session start */\n  additionalContext?: string\n}\n\n/**\n * Hook execution result (internal)\n */\nexport interface HookExecutionResult {\n  /** Whether hook execution succeeded */\n  success: boolean\n\n  /** Exit code from hook command */\n  exitCode: number\n\n  /** Standard output */\n  stdout: string\n\n  /** Standard error */\n  stderr: string\n\n  /** Parsed JSON output (if valid) */\n  output?: HookOutput\n\n  /** Error if execution failed */\n  error?: Error\n\n  /** Execution time in milliseconds */\n  executionTime: number\n}\n\n/**\n * Zod schema for hooks.json validation\n */\nexport const HookDefinitionSchema = z.object({\n  type: z.enum(['command', 'prompt', 'agent']),\n  command: z.string().optional(),\n  prompt: z.string().optional(),\n  timeout: z.number().optional(),\n  description: z.string().optional(),\n  async: z.boolean().optional(),\n  once: z.boolean().optional(),\n})\n\nexport const HookMatcherSchema = z.object({\n  matcher: z.string().optional(),\n  toolInput: z.record(z.string()).optional(),\n  hooks: z.array(HookDefinitionSchema),\n})\n\nexport const HooksConfigSchema = z.object({\n  description: z.string().optional(),\n  hooks: z\n    .record(z.nativeEnum(HookEvent), z.array(HookMatcherSchema))\n    .optional(),\n})\n\n/**\n * Hook execution context (passed to executor)\n */\nexport interface HookExecutionContext {\n  /** Hook definition to execute */\n  hook: HookDefinition\n\n  /** Hook input data */\n  input: HookInput\n\n  /** Environment variables to pass to hook */\n  env?: Record<string, string>\n\n  /** Abort signal for cancellation */\n  abortSignal?: AbortSignal\n}\n\n/**\n * Hook decision result (processed from hook output)\n */\nexport interface HookDecision {\n  /** Allow the action */\n  allow: boolean\n\n  /** Block the action */\n  block: boolean\n\n  /** Ask user for confirmation */\n  ask: boolean\n\n  /** Reason for decision */\n  reason?: string\n\n  /** Message to show to user */\n  systemMessage?: string\n\n  /** Stop execution entirely */\n  stop: boolean\n\n  /** Stop reason */\n  stopReason?: string\n\n  /** Additional context to inject */\n  additionalContext?: string\n\n  /** Modified tool input (for PreToolUse) */\n  updatedInput?: Record<string, unknown>\n}\n\n/**\n * Loaded hook (runtime representation)\n * Used by both plugin-loaded hooks and settings.json hooks.\n */\nexport interface LoadedHook {\n  /** Hook name/identifier */\n  name: string\n\n  /** File path to hook definition */\n  filePath: string\n\n  /** Hook configuration (extends HookDefinition with event routing fields) */\n  config: HookDefinition & {\n    /** Hook event this config responds to */\n    event: HookEvent\n    /** Matcher pattern for tool name matching */\n    matcher?: string\n    /** Whether the hook blocks execution until complete */\n    blocking?: boolean\n    /** Tool input field patterns for matching (CC spec) */\n    toolInput?: Record<string, string>\n  }\n\n  /** Source plugin name */\n  pluginName: string\n\n  /** Hook event this hook responds to (root-level for easier access) */\n  event: HookEvent\n\n  /** Matcher pattern (root-level for easier access) */\n  matcher?: string\n}\n"],
+  "mappings": "AAIA,SAAS,SAAS;AAMX,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,wBAAqB;AAGrB,EAAAA,WAAA,uBAAoB;AAGpB,EAAAA,WAAA,sBAAmB;AAGnB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAGb,EAAAA,WAAA,UAAO;AAGP,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,iBAAc;AAGd,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,oBAAiB;AAzCP,SAAAA;AAAA,GAAA;AAoZL,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,KAAK,CAAC,WAAW,UAAU,OAAO,CAAC;AAAA,EAC3C,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC5B,MAAM,EAAE,QAAQ,EAAE,SAAS;AAC7B,CAAC;AAEM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACzC,OAAO,EAAE,MAAM,oBAAoB;AACrC,CAAC;AAEM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EACJ,OAAO,EAAE,WAAW,SAAS,GAAG,EAAE,MAAM,iBAAiB,CAAC,EAC1D,SAAS;AACd,CAAC;",
   "names": ["HookEvent"]
 }

package/dist/types/plugin.js

@@ -53,6 +53,7 @@ const PluginManifestSchema = z.object({
   // Plugin-specific configuration schema
   configSchema: z.record(z.any()).optional()
 });
+import { HookEvent as HookEvent2 } from "./hooks.js";
 class PluginError extends Error {
   constructor(message, code, pluginName, details) {
     super(message);
@@ -76,6 +77,7 @@ var PluginErrorCode = /* @__PURE__ */ ((PluginErrorCode2) => {
 })(PluginErrorCode || {});
 export {
   AuthorSchema,
+  HookEvent2 as HookEvent,
   MCPServerConfigSchema,
   PluginError,
   PluginErrorCode,

package/dist/types/plugin.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/types/plugin.ts"],
-  "sourcesContent": ["/**\n * Plugin System Type Definitions\n */\n\nimport { z } from 'zod'\n\n/**\n * Author information (can be string or object)\n */\nexport const AuthorSchema = z.union([\n  z.string(),\n  z.object({\n    name: z.string(),\n    email: z.string().email().optional(),\n    url: z.string().url().optional(),\n  }),\n])\n\n/**\n * MCP Server Configuration Schema\n * Compatible with Claude Code CLI's .mcp.json format\n */\nexport const MCPServerConfigSchema = z.object({\n  // Command-based (stdio) servers\n  command: z.string().optional(),\n  args: z.array(z.string()).optional().default([]),\n  env: z.record(z.string()).optional().default({}),\n  timeout: z.number().optional(),\n\n  // Transport type: stdio (default), http (Streamable HTTP), sse (legacy SSE)\n  type: z.enum(['stdio', 'http', 'sse']).optional().default('stdio'),\n  url: z.string().optional(),\n  headers: z.record(z.string()).optional(),\n})\n\nexport type MCPServerConfig = z.infer<typeof MCPServerConfigSchema>\n\n/**\n * Plugin Manifest Schema (plugin.json)\n * This is the source of truth for plugin metadata\n */\nexport const PluginManifestSchema = z.object({\n  // Required fields\n  name: z\n    .string()\n    .min(1)\n    .regex(\n      /^[a-z0-9-]+$/,\n      'Plugin name must be lowercase alphanumeric with hyphens',\n    ),\n  version: z.string().min(1), // Supports semver and commit hashes (for CC sync)\n  description: z.string().min(1),\n\n  // Optional metadata\n  displayName: z.string().optional(),\n  author: AuthorSchema.optional(),\n  homepage: z.string().url().optional(),\n  repository: z.string().url().optional(),\n  license: z.string().optional(),\n\n  // Plugin components (relative paths from plugin root)\n  agents: z.array(z.string()).optional().default([]),\n  commands: z.array(z.string()).optional().default([]),\n  skills: z.array(z.string()).optional().default([]),\n  hooks: z.array(z.string()).optional().default([]),\n\n  // MCP servers support both:\n  // - Array of file paths: [\"mcp-servers/server1.json\"]\n  // - Object with inline configs: { \"server1\": { command: \"...\" } }\n  mcpServers: z\n    .union([z.array(z.string()), z.record(MCPServerConfigSchema)])\n    .optional()\n    .default([]),\n\n  // Dependencies\n  dependencies: z.record(z.string()).optional().default({}),\n\n  // Minto/Claude Code version requirements\n  engines: z\n    .object({\n      minto: z.string().optional(),\n      'claude-code': z.string().optional(),\n      node: z.string().optional(),\n    })\n    .optional(),\n\n  // Plugin-specific configuration schema\n  configSchema: z.record(z.any()).optional(),\n})\n\nexport type PluginManifest = z.infer<typeof PluginManifestSchema>\n\n/**\n * Loaded Plugin (runtime representation)\n */\nexport interface LoadedPlugin {\n  name: string\n  manifest: PluginManifest\n  location: string // Absolute path to plugin directory\n  source: PluginSource\n  agents: LoadedAgent[]\n  commands: LoadedCommand[]\n  skills: LoadedSkill[]\n  hooks: LoadedHook[]\n  mcpServers: LoadedMCPServer[]\n  lspServers: LoadedLSPServer[]\n  enabled: boolean\n  config?: Record<string, any>\n  /** Plugin agent settings (CC format: { defaultAgent, maxTurns, ... }) */\n  settings?: Record<string, any> | null\n}\n\n/**\n * Plugin source types\n */\nexport type PluginSource =\n  | { type: 'local'; path: string }\n  | { type: 'git'; repo: string; ref?: string }\n  | { type: 'npm'; package: string; version?: string }\n  | { type: 'marketplace'; marketplace: string; name: string }\n  | { type: 'claude-code'; marketplace: string; name: string }\n\n/**\n * Agent component (from plugin)\n */\nexport interface LoadedAgent {\n  name: string\n  filePath: string\n  config: {\n    name: string\n    description: string\n    tools?: string | string[]\n    model?: string\n    content: string\n  }\n  pluginName: string\n}\n\n/**\n * Command component (from plugin)\n */\nexport interface LoadedCommand {\n  name: string\n  filePath: string\n  config: {\n    name: string\n    description?: string\n    aliases?: string[]\n    enabled?: boolean\n    hidden?: boolean\n    progressMessage?: string\n    argNames?: string[]\n    'allowed-tools'?: string[]\n    content: string\n  }\n  pluginName: string\n}\n\n/**\n * Skill hook definition (inline in SKILL.md frontmatter)\n */\nexport interface SkillHookDefinition {\n  event: HookEvent\n  matcher?: string\n  type?: 'command' | 'prompt' | 'agent'\n  command?: string\n  prompt?: string\n  timeout?: number\n}\n\n/**\n * Skill configuration (Claude Code specification compliant)\n */\nexport interface SkillConfig {\n  // Identity\n  name: string\n  description: string\n  argumentHint?: string // Hint for expected arguments\n\n  // Invocation control (Claude Code spec)\n  disableModelInvocation?: boolean // If true, model cannot auto-invoke (user-only)\n  userInvocable?: boolean // If true, user can invoke via /command (default: true)\n\n  // Execution configuration\n  allowedTools?: string[] // Tools the skill can use\n  model?: 'sonnet' | 'opus' | 'haiku' | 'inherit' // Model to use\n\n  // Fork context (Claude Code spec)\n  context?: 'fork' // Execute in isolated context\n  agent?: string // Agent type to use for fork execution\n\n  // Lifecycle hooks (Claude Code spec)\n  hooks?: SkillHookDefinition[]\n\n  // Metadata (Claude Code spec standard fields)\n  license?: string\n  compatibility?: string | Record<string, string>\n  metadata?: Record<string, unknown>\n\n  // Content\n  content: string\n}\n\n/**\n * Skill component (from plugin or standalone)\n */\nexport interface LoadedSkill {\n  name: string\n  filePath: string\n  config: SkillConfig\n  pluginName: string // 'standalone' for standalone skills\n  source: 'plugin' | 'user' | 'project' // Where the skill was loaded from\n}\n\n/**\n * Hook component (from plugin)\n */\nexport interface LoadedHook {\n  name: string\n  filePath: string\n  config: {\n    event: HookEvent\n    matcher?: string\n    type: 'command' | 'prompt' | 'agent'\n    command?: string\n    prompt?: string\n    blocking?: boolean\n    timeout?: number\n    async?: boolean\n    once?: boolean\n    /** Tool input field patterns for matching (CC spec) */\n    toolInput?: Record<string, string>\n  }\n  pluginName: string\n  event: HookEvent // Also store event at root level for easier access\n  matcher?: string // Also store matcher at root level\n}\n\n/**\n * Hook lifecycle events\n */\nexport type HookEvent =\n  | 'PreToolUse'\n  | 'PostToolUse'\n  | 'PostToolUseFailure'\n  | 'PermissionRequest'\n  | 'UserPromptSubmit'\n  | 'SessionStart'\n  | 'SessionEnd'\n  | 'Stop'\n  | 'SubagentStart'\n  | 'SubagentStop'\n  | 'Notification'\n  | 'PreCompact'\n  | 'PostCompact'\n  | 'ConfigChange'\n  | 'TaskCompleted'\n  | 'TeammateIdle'\n\n/**\n * MCP Server component (from plugin)\n */\nexport interface LoadedMCPServer {\n  name: string\n  filePath: string\n  config: {\n    command: string\n    args?: string[]\n    env?: Record<string, string>\n    timeout?: number\n  }\n  pluginName: string\n}\n\n/**\n * LSP Server component (from plugin)\n * Claude Code CLI compatible: plugins can define language servers\n * via .lsp.json or inline lspServers in plugin.json manifest.\n */\nexport interface LoadedLSPServer {\n  name: string\n  filePath: string\n  config: {\n    command: string\n    args?: string[]\n    env?: Record<string, string>\n    /** File patterns this LSP server handles (e.g. [\"*.py\", \"*.pyi\"]) */\n    filePatterns?: string[]\n    /** Language identifiers (e.g. [\"python\", \"typescript\"]) */\n    languages?: string[]\n    /** Initialization options for the LSP server */\n    initializationOptions?: Record<string, unknown>\n  }\n  pluginName: string\n}\n\n/**\n * Plugin installation options\n */\nexport interface PluginInstallOptions {\n  source: PluginSource\n  global?: boolean // Install globally vs project-level\n  enable?: boolean // Auto-enable after install\n  config?: Record<string, any> // Plugin-specific config\n}\n\n/**\n * Plugin marketplace configuration\n */\nexport interface PluginMarketplace {\n  name: string\n  source: PluginSource\n  plugins: PluginManifest[]\n}\n\n/**\n * Plugin error types\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public code: PluginErrorCode,\n    public pluginName?: string,\n    public details?: any,\n  ) {\n    super(message)\n    this.name = 'PluginError'\n  }\n}\n\nexport enum PluginErrorCode {\n  MANIFEST_INVALID = 'MANIFEST_INVALID',\n  MANIFEST_NOT_FOUND = 'MANIFEST_NOT_FOUND',\n  VERSION_MISMATCH = 'VERSION_MISMATCH',\n  DEPENDENCY_MISSING = 'DEPENDENCY_MISSING',\n  COMPONENT_NOT_FOUND = 'COMPONENT_NOT_FOUND',\n  COMPONENT_INVALID = 'COMPONENT_INVALID',\n  ALREADY_INSTALLED = 'ALREADY_INSTALLED',\n  NOT_INSTALLED = 'NOT_INSTALLED',\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n}\n\n// ============================================================================\n// Session Plugin Types (Claude Code CLI Compatible)\n// ============================================================================\n\n/**\n * A loaded plugin in the current session\n * Compatible with Claude Code CLI session plugins\n */\nexport interface SessionPlugin {\n  /** Plugin name from manifest */\n  name: string\n  /** Root directory of the plugin */\n  rootDir: string\n  /** Path to the manifest file */\n  manifestPath: string\n  /** Raw manifest data */\n  manifest: unknown\n  /** Directories containing custom commands */\n  commandsDirs: string[]\n  /** Directories containing skills */\n  skillsDirs: string[]\n  /** Directories containing agents */\n  agentsDirs: string[]\n  /** Paths to hooks configuration files */\n  hooksFiles: string[]\n  /** Directories containing output styles */\n  outputStylesDirs: string[]\n  /** Paths to MCP server configuration files */\n  mcpConfigFiles: string[]\n  /** Paths to LSP server configuration files (Claude Code CLI specific) */\n  lspConfigFiles: string[]\n}\n\n/**\n * Plugin scope - where the plugin is installed/activated\n */\nexport type PluginScope = 'user' | 'project' | 'local'\n\n/**\n * Installed skill plugin record\n */\nexport interface InstalledSkillPlugin {\n  plugin: string\n  marketplace: string\n  scope: PluginScope\n  kind?: 'skill-pack' | 'plugin-pack'\n  isEnabled?: boolean\n  projectPath?: string\n  installedAt: string\n  pluginRoot?: string\n  skills: string[]\n  commands: string[]\n  sourceMarketplacePath: string\n}\n"],
-  "mappings": "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",
-  "names": ["PluginErrorCode"]
+  "sourcesContent": ["/**\n * Plugin System Type Definitions\n */\n\nimport { z } from 'zod'\nimport { HookEvent, type LoadedHook } from './hooks'\n\n/**\n * Author information (can be string or object)\n */\nexport const AuthorSchema = z.union([\n  z.string(),\n  z.object({\n    name: z.string(),\n    email: z.string().email().optional(),\n    url: z.string().url().optional(),\n  }),\n])\n\n/**\n * MCP Server Configuration Schema\n * Compatible with Claude Code CLI's .mcp.json format\n */\nexport const MCPServerConfigSchema = z.object({\n  // Command-based (stdio) servers\n  command: z.string().optional(),\n  args: z.array(z.string()).optional().default([]),\n  env: z.record(z.string()).optional().default({}),\n  timeout: z.number().optional(),\n\n  // Transport type: stdio (default), http (Streamable HTTP), sse (legacy SSE)\n  type: z.enum(['stdio', 'http', 'sse']).optional().default('stdio'),\n  url: z.string().optional(),\n  headers: z.record(z.string()).optional(),\n})\n\nexport type MCPServerConfig = z.infer<typeof MCPServerConfigSchema>\n\n/**\n * Plugin Manifest Schema (plugin.json)\n * This is the source of truth for plugin metadata\n */\nexport const PluginManifestSchema = z.object({\n  // Required fields\n  name: z\n    .string()\n    .min(1)\n    .regex(\n      /^[a-z0-9-]+$/,\n      'Plugin name must be lowercase alphanumeric with hyphens',\n    ),\n  version: z.string().min(1), // Supports semver and commit hashes (for CC sync)\n  description: z.string().min(1),\n\n  // Optional metadata\n  displayName: z.string().optional(),\n  author: AuthorSchema.optional(),\n  homepage: z.string().url().optional(),\n  repository: z.string().url().optional(),\n  license: z.string().optional(),\n\n  // Plugin components (relative paths from plugin root)\n  agents: z.array(z.string()).optional().default([]),\n  commands: z.array(z.string()).optional().default([]),\n  skills: z.array(z.string()).optional().default([]),\n  hooks: z.array(z.string()).optional().default([]),\n\n  // MCP servers support both:\n  // - Array of file paths: [\"mcp-servers/server1.json\"]\n  // - Object with inline configs: { \"server1\": { command: \"...\" } }\n  mcpServers: z\n    .union([z.array(z.string()), z.record(MCPServerConfigSchema)])\n    .optional()\n    .default([]),\n\n  // Dependencies\n  dependencies: z.record(z.string()).optional().default({}),\n\n  // Minto/Claude Code version requirements\n  engines: z\n    .object({\n      minto: z.string().optional(),\n      'claude-code': z.string().optional(),\n      node: z.string().optional(),\n    })\n    .optional(),\n\n  // Plugin-specific configuration schema\n  configSchema: z.record(z.any()).optional(),\n})\n\nexport type PluginManifest = z.infer<typeof PluginManifestSchema>\n\n// Re-export from hooks.ts to avoid duplicate definitions\n// HookEvent is an enum (value), LoadedHook is an interface (type-only)\nexport { HookEvent } from './hooks'\nexport type { LoadedHook } from './hooks'\n\n/**\n * Loaded Plugin (runtime representation)\n */\nexport interface LoadedPlugin {\n  name: string\n  manifest: PluginManifest\n  location: string // Absolute path to plugin directory\n  source: PluginSource\n  agents: LoadedAgent[]\n  commands: LoadedCommand[]\n  skills: LoadedSkill[]\n  hooks: LoadedHook[]\n  mcpServers: LoadedMCPServer[]\n  lspServers: LoadedLSPServer[]\n  enabled: boolean\n  config?: Record<string, any>\n  /** Plugin agent settings (CC format: { defaultAgent, maxTurns, ... }) */\n  settings?: Record<string, any> | null\n}\n\n/**\n * Plugin source types\n */\nexport type PluginSource =\n  | { type: 'local'; path: string }\n  | { type: 'git'; repo: string; ref?: string }\n  | { type: 'npm'; package: string; version?: string }\n  | { type: 'marketplace'; marketplace: string; name: string }\n  | { type: 'claude-code'; marketplace: string; name: string }\n\n/**\n * Agent component (from plugin)\n */\nexport interface LoadedAgent {\n  name: string\n  filePath: string\n  config: {\n    name: string\n    description: string\n    tools?: string | string[]\n    model?: string\n    content: string\n  }\n  pluginName: string\n}\n\n/**\n * Command component (from plugin)\n */\nexport interface LoadedCommand {\n  name: string\n  filePath: string\n  config: {\n    name: string\n    description?: string\n    aliases?: string[]\n    enabled?: boolean\n    hidden?: boolean\n    progressMessage?: string\n    argNames?: string[]\n    'allowed-tools'?: string[]\n    content: string\n  }\n  pluginName: string\n}\n\n/**\n * Skill hook definition (inline in SKILL.md frontmatter)\n */\nexport interface SkillHookDefinition {\n  event: HookEvent\n  matcher?: string\n  type?: 'command' | 'prompt' | 'agent'\n  command?: string\n  prompt?: string\n  timeout?: number\n}\n\n/**\n * Skill configuration (Claude Code specification compliant)\n */\nexport interface SkillConfig {\n  // Identity\n  name: string\n  description: string\n  argumentHint?: string // Hint for expected arguments\n\n  // Invocation control (Claude Code spec)\n  disableModelInvocation?: boolean // If true, model cannot auto-invoke (user-only)\n  userInvocable?: boolean // If true, user can invoke via /command (default: true)\n\n  // Execution configuration\n  allowedTools?: string[] // Tools the skill can use\n  model?: 'sonnet' | 'opus' | 'haiku' | 'inherit' // Model to use\n\n  // Fork context (Claude Code spec)\n  context?: 'fork' // Execute in isolated context\n  agent?: string // Agent type to use for fork execution\n\n  // Lifecycle hooks (Claude Code spec)\n  hooks?: SkillHookDefinition[]\n\n  // Metadata (Claude Code spec standard fields)\n  license?: string\n  compatibility?: string | Record<string, string>\n  metadata?: Record<string, unknown>\n\n  // Content\n  content: string\n}\n\n/**\n * Skill component (from plugin or standalone)\n */\nexport interface LoadedSkill {\n  name: string\n  filePath: string\n  config: SkillConfig\n  pluginName: string // 'standalone' for standalone skills\n  source: 'plugin' | 'user' | 'project' // Where the skill was loaded from\n}\n\n/**\n * MCP Server component (from plugin)\n */\nexport interface LoadedMCPServer {\n  name: string\n  filePath: string\n  config: {\n    command: string\n    args?: string[]\n    env?: Record<string, string>\n    timeout?: number\n  }\n  pluginName: string\n}\n\n/**\n * LSP Server component (from plugin)\n * Claude Code CLI compatible: plugins can define language servers\n * via .lsp.json or inline lspServers in plugin.json manifest.\n */\nexport interface LoadedLSPServer {\n  name: string\n  filePath: string\n  config: {\n    command: string\n    args?: string[]\n    env?: Record<string, string>\n    /** File patterns this LSP server handles (e.g. [\"*.py\", \"*.pyi\"]) */\n    filePatterns?: string[]\n    /** Language identifiers (e.g. [\"python\", \"typescript\"]) */\n    languages?: string[]\n    /** Initialization options for the LSP server */\n    initializationOptions?: Record<string, unknown>\n  }\n  pluginName: string\n}\n\n/**\n * Plugin installation options\n */\nexport interface PluginInstallOptions {\n  source: PluginSource\n  global?: boolean // Install globally vs project-level\n  enable?: boolean // Auto-enable after install\n  config?: Record<string, any> // Plugin-specific config\n}\n\n/**\n * Plugin marketplace configuration\n */\nexport interface PluginMarketplace {\n  name: string\n  source: PluginSource\n  plugins: PluginManifest[]\n}\n\n/**\n * Plugin error types\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public code: PluginErrorCode,\n    public pluginName?: string,\n    public details?: any,\n  ) {\n    super(message)\n    this.name = 'PluginError'\n  }\n}\n\nexport enum PluginErrorCode {\n  MANIFEST_INVALID = 'MANIFEST_INVALID',\n  MANIFEST_NOT_FOUND = 'MANIFEST_NOT_FOUND',\n  VERSION_MISMATCH = 'VERSION_MISMATCH',\n  DEPENDENCY_MISSING = 'DEPENDENCY_MISSING',\n  COMPONENT_NOT_FOUND = 'COMPONENT_NOT_FOUND',\n  COMPONENT_INVALID = 'COMPONENT_INVALID',\n  ALREADY_INSTALLED = 'ALREADY_INSTALLED',\n  NOT_INSTALLED = 'NOT_INSTALLED',\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n}\n\n// ============================================================================\n// Session Plugin Types (Claude Code CLI Compatible)\n// ============================================================================\n\n/**\n * A loaded plugin in the current session\n * Compatible with Claude Code CLI session plugins\n */\nexport interface SessionPlugin {\n  /** Plugin name from manifest */\n  name: string\n  /** Root directory of the plugin */\n  rootDir: string\n  /** Path to the manifest file */\n  manifestPath: string\n  /** Raw manifest data */\n  manifest: unknown\n  /** Directories containing custom commands */\n  commandsDirs: string[]\n  /** Directories containing skills */\n  skillsDirs: string[]\n  /** Directories containing agents */\n  agentsDirs: string[]\n  /** Paths to hooks configuration files */\n  hooksFiles: string[]\n  /** Directories containing output styles */\n  outputStylesDirs: string[]\n  /** Paths to MCP server configuration files */\n  mcpConfigFiles: string[]\n  /** Paths to LSP server configuration files (Claude Code CLI specific) */\n  lspConfigFiles: string[]\n}\n\n/**\n * Plugin scope - where the plugin is installed/activated\n */\nexport type PluginScope = 'user' | 'project' | 'local'\n\n/**\n * Installed skill plugin record\n */\nexport interface InstalledSkillPlugin {\n  plugin: string\n  marketplace: string\n  scope: PluginScope\n  kind?: 'skill-pack' | 'plugin-pack'\n  isEnabled?: boolean\n  projectPath?: string\n  installedAt: string\n  pluginRoot?: string\n  skills: string[]\n  commands: string[]\n  sourceMarketplacePath: string\n}\n"],
+  "mappings": "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",
+  "names": ["HookEvent", "PluginErrorCode"]
 }

package/dist/utils/CircuitBreaker.js

@@ -61,15 +61,21 @@ class CircuitBreaker {
     if (!timeout) {
       return this.execute(operation);
     }
-    return Promise.race([
-      this.execute(operation),
-      new Promise(
-        (_, reject) => setTimeout(
-          () => reject(new Error(`Operation timeout after ${timeout}ms`)),
-          timeout
-        )
-      )
-    ]);
+    let timeoutId;
+    try {
+      const result = await Promise.race([
+        this.execute(operation),
+        new Promise((_, reject) => {
+          timeoutId = setTimeout(
+            () => reject(new Error(`Operation timeout after ${timeout}ms`)),
+            timeout
+          );
+        })
+      ]);
+      return result;
+    } finally {
+      if (timeoutId !== void 0) clearTimeout(timeoutId);
+    }
   }
   /**
    * Get current circuit state