n8n-nodes-claude-code-cli 1.5.0 → 1.6.0

package/dist/index.js

@@ -174003,6 +174003,142 @@ var modelDescription = [
   }
 ];
 
+// nodes/ClaudeCode/descriptions/agentsDescription.ts
+var agentsDescription = [
+  {
+    displayName: "Subagents",
+    name: "agents",
+    type: "fixedCollection",
+    typeOptions: {
+      multipleValues: true,
+      multipleValueButtonText: "Add Subagent"
+    },
+    default: { agentsList: [] },
+    displayOptions: {
+      show: {
+        operation: ["executePrompt", "executeWithContext"]
+      }
+    },
+    options: [
+      {
+        name: "agentsList",
+        displayName: "Agents",
+        values: [
+          {
+            displayName: "Agent Name",
+            name: "name",
+            type: "string",
+            default: "",
+            required: true,
+            placeholder: "code-reviewer",
+            description: "Unique identifier for this agent. Lowercase letters, numbers, and hyphens only (3-50 chars)."
+          },
+          {
+            displayName: "Description",
+            name: "description",
+            type: "string",
+            typeOptions: { rows: 2 },
+            default: "",
+            required: true,
+            placeholder: "Expert code reviewer. Use proactively when code changes are made.",
+            description: "When Claude should delegate to this agent."
+          },
+          {
+            displayName: "System Prompt",
+            name: "prompt",
+            type: "string",
+            typeOptions: { rows: 5 },
+            default: "",
+            required: true,
+            placeholder: "You are a senior code reviewer. Focus on...",
+            description: "System prompt governing this agent's behavior."
+          },
+          {
+            displayName: "Model",
+            name: "model",
+            type: "options",
+            options: [
+              {
+                name: "Inherit (Parent Model)",
+                value: "inherit"
+              },
+              { name: "Sonnet", value: "sonnet" },
+              { name: "Opus", value: "opus" },
+              { name: "Haiku", value: "haiku" }
+            ],
+            default: "inherit",
+            description: "Model to use for this agent."
+          },
+          {
+            displayName: "Allowed Tools",
+            name: "tools",
+            type: "string",
+            default: "",
+            placeholder: "Read, Grep, Glob, Bash(git:*)",
+            description: "Tools this agent can use (comma-separated). Leave empty to inherit all tools."
+          },
+          {
+            displayName: "Disallowed Tools",
+            name: "disallowedTools",
+            type: "string",
+            default: "",
+            placeholder: "Write, Edit, Bash(rm:*)",
+            description: "Tools this agent cannot use (comma-separated). Takes precedence over allowed tools."
+          },
+          {
+            displayName: "Permission Mode",
+            name: "permissionMode",
+            type: "options",
+            options: [
+              { name: "Default", value: "" },
+              { name: "Accept Edits", value: "acceptEdits" },
+              { name: "Plan (Read-Only)", value: "plan" },
+              { name: "Don't Ask", value: "dontAsk" },
+              {
+                name: "Bypass Permissions",
+                value: "bypassPermissions"
+              },
+              { name: "Delegate", value: "delegate" }
+            ],
+            default: "",
+            description: "Permission mode for this agent. Leave empty to use default."
+          },
+          {
+            displayName: "Max Turns",
+            name: "maxTurns",
+            type: "number",
+            default: 0,
+            description: "Maximum agentic turns before stopping. 0 = unlimited."
+          },
+          {
+            displayName: "Memory",
+            name: "memory",
+            type: "options",
+            options: [
+              { name: "None", value: "" },
+              {
+                name: "User (Cross-Project)",
+                value: "user"
+              },
+              {
+                name: "Project (Shareable)",
+                value: "project"
+              },
+              {
+                name: "Local (Not Committed)",
+                value: "local"
+              }
+            ],
+            default: "",
+            description: "Memory persistence mode for this agent."
+          }
+        ]
+      }
+    ],
+    description: "Define custom subagents that Claude can delegate to during execution. Useful for specialized workflows (reviewer, debugger, architect...)."
+  }
+];
+
 // nodes/ClaudeCode/descriptions/optionsDescription.ts
 var optionsDescription = [
   {
@@ -174057,6 +174193,74 @@ var optionsDescription = [
         placeholder: "You are a helpful code reviewer...",
         description: "Additional system prompt to append to Claude Code default system prompt"
       },
+      {
+        displayName: "System Prompt File",
+        name: "systemPromptFile",
+        type: "string",
+        default: "",
+        placeholder: "/path/to/system-prompt.txt",
+        description: "Path to a file containing additional system prompt text to append to Claude Code default system prompt. Use this instead of inline System Prompt for long or reusable prompts."
+      },
+      {
+        displayName: "Verbose",
+        name: "verbose",
+        type: "boolean",
+        default: false,
+        description: "Enable verbose logging. Automatically enabled when Output Format is Stream JSON. Useful for debugging in JSON or Text output modes."
+      },
+      {
+        displayName: "Max Budget (USD)",
+        name: "maxBudgetUsd",
+        type: "number",
+        default: 0,
+        description: "Maximum dollar amount to spend before stopping execution. 0 means unlimited. Critical for controlling costs in automated workflows."
+      },
+      {
+        displayName: "JSON Schema",
+        name: "jsonSchema",
+        type: "string",
+        typeOptions: {
+          rows: 4
+        },
+        default: "",
+        placeholder: '{"type":"object","properties":{"summary":{"type":"string"}}}',
+        description: "JSON schema for validated structured output. Claude will return JSON matching this schema. Must be a valid JSON schema string."
+      },
+      {
+        displayName: "Fallback Model",
+        name: "fallbackModel",
+        type: "string",
+        default: "",
+        placeholder: "claude-sonnet-4-20250514",
+        description: "Fallback model to use when the primary model is overloaded or unavailable. Improves resilience in production workflows."
+      },
+      {
+        displayName: "Extended Context (1M Tokens)",
+        name: "extendedContext",
+        type: "boolean",
+        default: true,
+        description: "Enable 1M token context window for analyzing very large codebases in a single pass. Only supported by Claude Opus 4.6, Sonnet 4.6, Sonnet 4.5, and Sonnet 4. Has no effect on other models."
+      },
+      {
+        displayName: "Worktree Isolation",
+        name: "worktreeEnabled",
+        type: "boolean",
+        default: false,
+        description: "Run Claude Code in an isolated git worktree. Each execution works on a separate copy of the repository, preventing conflicts with the main workspace. The worktree is automatically cleaned up if no changes are made."
+      },
+      {
+        displayName: "Worktree Name",
+        name: "worktreeName",
+        type: "string",
+        default: "",
+        placeholder: "feature-auth",
+        description: "Optional name for the worktree. If empty, Claude Code auto-generates a unique name. The worktree is created at <repo>/.claude/worktrees/<name>/.",
+        displayOptions: {
+          show: {
+            worktreeEnabled: [true]
+          }
+        }
+      },
       {
         displayName: "Additional Arguments",
         name: "additionalArgs",
@@ -174110,6 +174314,28 @@ function buildCommand(options, credentials) {
   if (options.systemPrompt) {
     args.push("--append-system-prompt", options.systemPrompt);
   }
+  if (options.systemPromptFile) {
+    args.push("--append-system-prompt-file", options.systemPromptFile);
+  }
+  if (options.verbose && options.outputFormat !== "stream-json") {
+    args.push("--verbose");
+  }
+  if (options.maxBudgetUsd && options.maxBudgetUsd > 0) {
+    args.push("--max-budget-usd", String(options.maxBudgetUsd));
+  }
+  if (options.jsonSchema) {
+    args.push("--json-schema", options.jsonSchema);
+  }
+  if (options.fallbackModel) {
+    args.push("--fallback-model", options.fallbackModel);
+  }
+  if (options.worktree !== void 0) {
+    if (options.worktree) {
+      args.push("--worktree", options.worktree);
+    } else {
+      args.push("--worktree");
+    }
+  }
   if (options.contextFiles && options.contextFiles.length > 0) {
     const uniqueDirs = /* @__PURE__ */ new Set();
     options.contextFiles.forEach((file) => {
@@ -174122,9 +174348,15 @@ function buildCommand(options, credentials) {
       args.push("--add-dir", dir);
     });
   }
+  if (options.agents && Object.keys(options.agents).length > 0) {
+    args.push("--agents", JSON.stringify(options.agents));
+  }
   if (options.additionalArgs && options.additionalArgs.length > 0) {
     args.push(...options.additionalArgs);
   }
+  if (options.extendedContext === false) {
+    env.CLAUDE_CODE_DISABLE_1M_CONTEXT = "1";
+  }
   if ("envVars" in credentials && credentials.envVars) {
     const envVarsString = credentials.envVars;
     if (envVarsString && envVarsString !== "{}") {
@@ -174325,6 +174557,38 @@ function buildExecutionOptions(context, itemIndex, operation) {
     "default"
   );
   const permissionMode = permissionModeRaw && permissionModeRaw !== "default" ? permissionModeRaw : void 0;
+  const agentsData = context.getNodeParameter("agents", itemIndex, {
+    agentsList: []
+  });
+  let agents;
+  if (agentsData.agentsList && agentsData.agentsList.length > 0) {
+    agents = {};
+    for (const agent of agentsData.agentsList) {
+      const def = {
+        description: agent.description,
+        prompt: agent.prompt
+      };
+      if (agent.tools) {
+        def.tools = agent.tools.split(",").map((t) => t.trim()).filter(Boolean);
+      }
+      if (agent.disallowedTools) {
+        def.disallowedTools = agent.disallowedTools.split(",").map((t) => t.trim()).filter(Boolean);
+      }
+      if (agent.model && agent.model !== "inherit") {
+        def.model = agent.model;
+      }
+      if (agent.permissionMode) {
+        def.permissionMode = agent.permissionMode;
+      }
+      if (agent.maxTurns && agent.maxTurns > 0) {
+        def.maxTurns = agent.maxTurns;
+      }
+      if (agent.memory) {
+        def.memory = agent.memory;
+      }
+      agents[agent.name] = def;
+    }
+  }
   return {
     prompt,
     workingDirectory: options.workingDirectory,
@@ -174337,7 +174601,15 @@ function buildExecutionOptions(context, itemIndex, operation) {
     contextFiles,
     additionalArgs: additionalArgs.length > 0 ? additionalArgs : void 0,
     timeout: options.timeout || 300,
-    systemPrompt: options.systemPrompt || void 0
+    systemPrompt: options.systemPrompt || void 0,
+    systemPromptFile: options.systemPromptFile || void 0,
+    verbose: options.verbose || void 0,
+    maxBudgetUsd: options.maxBudgetUsd || void 0,
+    jsonSchema: options.jsonSchema || void 0,
+    fallbackModel: options.fallbackModel || void 0,
+    agents,
+    extendedContext: options.extendedContext !== false,
+    worktree: options.worktreeEnabled ? options.worktreeName || "" : void 0
   };
 }
 
@@ -174949,6 +175221,12 @@ function buildEphemeralPodSpec(credentials, options, podName) {
   const claudeArgs = buildClaudeArgs(options);
   const envVars = buildEnvVars(credentials);
   const limits = buildResourceLimits(credentials);
+  if (options.extendedContext === false) {
+    envVars.push({
+      name: "CLAUDE_CODE_DISABLE_1M_CONTEXT",
+      value: "1"
+    });
+  }
   const credentialPrefix = buildCredentialInjectionPrefix(credentials);
   const container = credentialPrefix ? {
     name: "claude-code",
@@ -175081,6 +175359,9 @@ function buildClaudeArgs(options) {
       args.push("--add-dir", dir);
     });
   }
+  if (options.agents && Object.keys(options.agents).length > 0) {
+    args.push("--agents", JSON.stringify(options.agents));
+  }
   if (options.additionalArgs && options.additionalArgs.length > 0) {
     args.push(...options.additionalArgs);
   }
@@ -175377,10 +175658,11 @@ var K8sPersistentExecutor = class {
         const claudePath = this.credentials.claudePath || "claude";
         const claudeArgs = buildClaudeArgs(options);
         const workDir = options.workingDirectory || this.credentials.defaultWorkingDir || "/workspace";
+        const envPrefix = options.extendedContext === false ? "export CLAUDE_CODE_DISABLE_1M_CONTEXT=1 && " : "";
         const command = [
           "sh",
           "-c",
-          `cd ${workDir} && ${claudePath} ${claudeArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ")}`
+          `${envPrefix}cd ${workDir} && ${claudePath} ${claudeArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ")}`
         ];
         return this.execInPod(clients, namespace, command).then(
           ({ stdout, stderr, exitCode }) => {
@@ -175525,6 +175807,8 @@ var ClaudeCode = class {
       ...toolPermissionsDescription,
       // Model selection
       ...modelDescription,
+      // Custom subagents
+      ...agentsDescription,
       // Additional options
       ...optionsDescription
     ]