openclaw-code-agent 4.1.0 → 4.1.2

package/openclaw.plugin.json

@@ -2,7 +2,26 @@
   "id": "openclaw-code-agent",
   "name": "OpenClaw Code Agent",
   "description": "Multi-session coding-agent orchestration from OpenClaw chat",
-  "version": "4.1.0",
+  "version": "4.1.2",
+  "contracts": {
+    "tools": [
+      "agent_launch",
+      "agent_sessions",
+      "agent_kill",
+      "agent_output",
+      "agent_respond",
+      "agent_request_plan_approval",
+      "agent_send_monitor_report",
+      "agent_stats",
+      "agent_merge",
+      "agent_pr",
+      "agent_worktree_cleanup",
+      "agent_worktree_status",
+      "goal_launch",
+      "goal_status",
+      "goal_stop"
+    ]
+  },
   "activation": {
     "onStartup": true,
     "onCommands": [
@@ -68,9 +87,11 @@
               "enum": [
                 "low",
                 "medium",
-                "high"
+                "high",
+                "xhigh",
+                "max"
               ],
-              "description": "Harness-specific reasoning effort. Currently used by Codex."
+              "description": "Harness-specific reasoning effort. Used by Codex and passed to Claude Code when configured."
             }
           }
         }
@@ -88,13 +109,15 @@
         "enum": [
           "low",
           "medium",
-          "high"
+          "high",
+          "xhigh",
+          "max"
         ],
         "description": "Deprecated legacy Codex reasoning effort. Use harnesses.codex.reasoningEffort instead."
       },
       "defaultWorkdir": {
         "type": "string",
-        "description": "Default working directory for new sessions"
+        "description": "Default working directory for new sessions. Because the default worktree strategy is 'delegate', this should normally be a git repository root unless defaultWorktreeStrategy is changed to 'off'."
       },
       "idleTimeoutMinutes": {
         "type": "number",
@@ -139,13 +162,13 @@
       },
       "planApproval": {
         "type": "string",
-        "default": "ask",
+        "default": "delegate",
         "enum": [
           "approve",
           "ask",
           "delegate"
         ],
-        "description": "Plan approval behavior. 'ask' (default): orchestrator always forwards plans to the user for approval. 'delegate': orchestrator autonomously decides whether to approve low-risk plans or escalate to the user. 'approve': orchestrator can auto-approve after verification."
+        "description": "Plan approval behavior. 'delegate' (default): orchestrator must review the full plan, then approve low-risk plans or escalate to the user. 'ask': always forwards plans to the user for approval. 'approve': orchestrator can auto-approve after verification."
       },
       "defaultHarness": {
         "type": "string",
@@ -155,9 +178,9 @@
       },
       "defaultWorktreeStrategy": {
         "type": "string",
-        "default": "off",
+        "default": "delegate",
         "enum": ["off", "manual", "ask", "delegate", "auto-merge", "auto-pr"],
-        "description": "Default worktree strategy for all new sessions when agent_launch omits worktree_strategy. 'off' (default) = no worktree. 'manual' = create worktree, no automatic action. 'ask' = push branch and notify the user with inline buttons (Merge locally / Create PR). 'delegate' = push branch and wake the orchestrator to decide autonomously. 'auto-merge' = auto-merge to base branch on completion. 'auto-pr' = auto-create or update a GitHub PR on completion."
+        "description": "Default worktree strategy for all new sessions when agent_launch omits worktree_strategy. 'delegate' (default) creates an isolated worktree and wakes the orchestrator to decide follow-through autonomously. 'off' = no worktree. 'manual' = create worktree, no automatic action. 'ask' = push branch and notify the user with inline buttons (Merge locally / Create PR). 'auto-merge' = auto-merge to base branch on completion. 'auto-pr' = auto-create or update a GitHub PR on completion."
       },
       "worktreeDir": {
         "type": "string",
@@ -186,7 +209,7 @@
     },
     "defaultWorkdir": {
       "label": "Default working directory",
-      "help": "Base directory used for new sessions when agent_launch does not provide a workdir.",
+      "help": "Base directory used for new sessions when agent_launch does not provide a workdir. With the default delegated worktree strategy, choose a git repository root; use the advanced worktree strategy setting to disable worktrees for non-git directories.",
       "placeholder": "/home/user/project"
     },
     "harnesses": {
@@ -216,12 +239,12 @@
     },
     "planApproval": {
       "label": "Plan approval policy",
-      "help": "Choose whether plans are always sent to the user with Approve/Revise/Reject buttons (`ask`, default), delegated to the orchestrator for full-plan review first, or auto-approved.",
+      "help": "Choose whether plans are delegated to the orchestrator for full-plan review first (`delegate`, default), always sent to the user with Approve/Revise/Reject buttons, or auto-approved.",
       "advanced": true
     },
     "defaultWorktreeStrategy": {
       "label": "Default worktree strategy",
-      "help": "Applies to all sessions that don't specify worktree_strategy explicitly. 'off' (default) disables worktrees globally. 'ask' creates a worktree and sends inline Merge locally / Create PR buttons on completion. 'delegate' wakes the orchestrator to decide autonomously. 'auto-merge' and 'auto-pr' are fully automated.",
+      "help": "Applies to all sessions that don't specify worktree_strategy explicitly. 'delegate' (default) creates a worktree and wakes the orchestrator to decide follow-through. 'off' disables worktrees globally. 'ask' sends inline Merge locally / Create PR buttons on completion. 'auto-merge' and 'auto-pr' are fully automated.",
       "advanced": true
     }
   },

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "openclaw-code-agent",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "type": "module",
   "packageManager": "pnpm@10.30.0",
   "main": "dist/index.js",
   "scripts": {
     "audit:prod": "pnpm audit --prod",
-    "build": "esbuild index.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/index.js --minify --external:openclaw --external:openclaw/plugin-sdk --external:openclaw/plugin-sdk/* --external:@anthropic-ai/claude-agent-sdk",
+    "build": "esbuild index.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/index.js --minify --external:@anthropic-ai/claude-agent-sdk",
     "check-plugin-security": "node scripts/check-plugin-security.mjs",
     "test": "node scripts/run-tests.mjs",
     "test:serial": "node scripts/run-tests.mjs",
@@ -29,8 +29,8 @@
       "minGatewayVersion": "2026.4.21"
     },
     "build": {
-      "openclawVersion": "2026.4.29",
-      "pluginSdkVersion": "2026.4.29"
+      "openclawVersion": "2026.5.4",
+      "pluginSdkVersion": "2026.5.4"
     }
   },
   "files": [
@@ -49,7 +49,7 @@
     "@types/node": "^25.5.2",
     "esbuild": "^0.28.0",
     "nanoid": "^5.1.7",
-    "openclaw": "2026.4.29",
+    "openclaw": "2026.5.4",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2"
   },
@@ -87,7 +87,8 @@
     "openclaw": ">=2026.4.21"
   },
   "overrides": {
-    "basic-ftp": "5.3.0"
+    "basic-ftp": "5.3.0",
+    "ip-address@<10.1.1": "10.1.1"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
@@ -106,7 +107,9 @@
       "brace-expansion@>=4.0.0 <5.0.5": ">=5.0.5",
       "path-to-regexp@>=8.0.0 <8.4.0": ">=8.4.0",
       "fast-xml-parser@>=5.0.0 <5.7.0": ">=5.7.0",
-      "@anthropic-ai/sdk@<0.91.1": "0.91.1"
+      "@anthropic-ai/sdk@<0.91.1": "0.91.1",
+      "@anthropic-ai/vertex-sdk>google-auth-library": "10.6.2",
+      "ip-address@<10.1.1": "10.1.1"
     }
   }
 }

package/skills/code-agent-orchestration/SKILL.md

@@ -25,7 +25,7 @@ Use `openclaw-code-agent` to run Claude Code or Codex sessions as background cod
 - Set `workdir` to the target repo.
 - Use `permission_mode: "plan"` when the user wants a real review gate before implementation.
 - Use `permission_mode: "bypassPermissions"` only for autonomous execution.
-- `defaultWorktreeStrategy` now defaults to `off`. Opt into a worktree strategy explicitly when you want branch isolation.
+- `defaultWorktreeStrategy` defaults to `delegate`, so new sessions normally use branch isolation and orchestrator-led follow-through. Use `worktree_strategy: "off"` only when the task must run in the main checkout or outside a git repo.
 - In `plan` mode, the plan belongs in normal session output. Do not ask the coding agent to write plan docs or transcript artifacts unless the user explicitly asked for a file.
 
 Example:
@@ -126,7 +126,9 @@ Use `permission_mode: "plan"` whenever the user wants a real planning checkpoint
 
 - Approval belongs to the user.
 - The plugin sends the canonical Approve / Revise / Reject prompt directly to the user.
+- Telegram and Discord buttons use the shared direct-message presentation path; if buttons are missing, plain-text `Approve`, `Revise`, or `Reject` in the same thread drives the same decision path.
 - If the user requests changes, wait for the revised plan from that same session; the revised submission becomes the latest actionable review version automatically.
+- If the user rejects the plan or the session is killed, treat older plan prompts as stale and verify state with `agent_sessions` before acting.
 - Wait for the user's answer, then forward it with `agent_respond(...)`.
 - Do not send a duplicate approval recap or second approval prompt.