openclaw-code-agent 4.0.1 → 4.1.1

package/openclaw.plugin.json

@@ -2,8 +2,28 @@
   "id": "openclaw-code-agent",
   "name": "OpenClaw Code Agent",
   "description": "Multi-session coding-agent orchestration from OpenClaw chat",
-  "version": "4.0.1",
+  "version": "4.1.1",
+  "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": [
       "agent",
       "agent_kill",
@@ -67,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."
             }
           }
         }
@@ -87,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",
@@ -138,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",
@@ -154,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",
@@ -185,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": {
@@ -215,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.0.1",
+  "version": "4.1.1",
   "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.25",
-      "pluginSdkVersion": "2026.4.25"
+      "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.25",
+    "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": [
@@ -105,7 +106,10 @@
       "protobufjs@>=7 <7.5.5": "7.5.5",
       "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"
+      "fast-xml-parser@>=5.0.0 <5.7.0": ">=5.7.0",
+      "@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

@@ -77,6 +77,8 @@ Treat these wake fields as authoritative state when present:
 
 Use those deterministic fields instead of inferring behavior from transcript fragments.
 
+When OpenClaw exposes managed TaskFlow state for a session, treat it as a high-level progress mirror of the plugin session. The plugin session state, `agent_sessions`, `agent_output`, and `agent_worktree_status` remain the authoritative operational surfaces for follow-up decisions.
+
 Approval/execution meanings:
 
 - `approved_then_implemented`: normal approved execution