openclaw-code-agent 2.3.1 → 3.1.0

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "openclaw-code-agent",
   "name": "OpenClaw Code Agent",
-  "description": "Orchestrate coding agent sessions from OpenClaw",
-  "version": "2.3.1",
+  "description": "Multi-session coding-agent orchestration from OpenClaw chat",
+  "version": "3.1.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -20,8 +20,7 @@
             "allowedModels": [
               "gpt-5.4"
             ],
-            "reasoningEffort": "medium",
-            "approvalPolicy": "on-request"
+            "reasoningEffort": "medium"
           },
           "claude-code": {
             "defaultModel": "sonnet",
@@ -54,14 +53,6 @@
                 "high"
               ],
               "description": "Harness-specific reasoning effort. Currently used by Codex."
-            },
-            "approvalPolicy": {
-              "type": "string",
-              "enum": [
-                "never",
-                "on-request"
-              ],
-              "description": "Harness-specific approval policy. Currently used by Codex."
             }
           }
         }
@@ -104,7 +95,7 @@
       },
       "fallbackChannel": {
         "type": "string",
-        "description": "Fallback notification channel (e.g. 'telegram|123456789')"
+        "description": "Fallback notification channel. Prefer a fully routable value such as 'telegram|123456789' or 'telegram|my-bot|123456789'; a bare provider like 'telegram' is only a weak fallback."
       },
       "permissionMode": {
         "type": "string",
@@ -112,19 +103,9 @@
         "enum": [
           "default",
           "plan",
-          "acceptEdits",
           "bypassPermissions"
         ],
-        "description": "Default plugin permission/orchestration mode for coding agent sessions"
-      },
-      "codexApprovalPolicy": {
-        "type": "string",
-        "default": "on-request",
-        "enum": [
-          "never",
-          "on-request"
-        ],
-        "description": "Codex-only SDK/CLI approval policy. Defaults to 'on-request'. Set to 'never' to keep Codex from requesting approval for privileged actions. Distinct from plugin permissionMode / plan orchestration."
+        "description": "Default plugin orchestration mode for coding-agent sessions. This controls OpenClaw plan/default/bypass behavior and is separate from the fixed Codex execution policy."
       },
       "agentChannels": {
         "type": "object",
@@ -140,19 +121,29 @@
       },
       "planApproval": {
         "type": "string",
-        "default": "delegate",
+        "default": "ask",
         "enum": [
           "approve",
           "ask",
           "delegate"
         ],
-        "description": "Plan approval behavior. 'delegate' (default): orchestrator autonomously decides whether to approve low-risk plans or escalate to the user. 'approve': orchestrator can auto-approve after verification. 'ask': orchestrator always forwards plans to the user for approval."
+        "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."
       },
       "defaultHarness": {
         "type": "string",
         "default": "claude-code",
         "description": "Default agent harness when agent_launch omits the harness parameter."
       },
+      "defaultWorktreeStrategy": {
+        "type": "string",
+        "default": "off",
+        "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."
+      },
+      "worktreeDir": {
+        "type": "string",
+        "description": "Base directory for agent worktrees. Defaults to <repoRoot>/.worktrees when unset. Overridden by OPENCLAW_WORKTREE_DIR env var."
+      },
       "allowedModels": {
         "type": "array",
         "items": {
@@ -165,7 +156,7 @@
   "uiHints": {
     "fallbackChannel": {
       "label": "Fallback notification channel",
-      "help": "Default channel used when no workspace-specific agentChannels entry matches the session workdir.",
+      "help": "Default channel used when no workspace-specific agentChannels entry matches the session workdir. Prefer a fully routable channel string; bare providers are only weak fallbacks.",
       "placeholder": "telegram|my-bot|123456789",
       "sensitive": true
     },
@@ -181,7 +172,7 @@
     },
     "harnesses": {
       "label": "Harness configuration",
-      "help": "Per-harness defaults and model restrictions. Default: {\"codex\":{\"defaultModel\":\"gpt-5.4\",\"allowedModels\":[\"gpt-5.4\"],\"reasoningEffort\":\"medium\",\"approvalPolicy\":\"on-request\"},\"claude-code\":{\"defaultModel\":\"sonnet\",\"allowedModels\":[\"sonnet\",\"opus\"]}}."
+      "help": "Per-harness defaults and model restrictions. Default: {\"codex\":{\"defaultModel\":\"gpt-5.4\",\"allowedModels\":[\"gpt-5.4\"],\"reasoningEffort\":\"medium\"},\"claude-code\":{\"defaultModel\":\"sonnet\",\"allowedModels\":[\"sonnet\",\"opus\"]}}."
     },
     "defaultModel": {
       "label": "Legacy default model",
@@ -203,15 +194,15 @@
     },
     "permissionMode": {
       "label": "Default permission mode",
-      "help": "Default plugin orchestration mode used when new coding-agent sessions are launched. This is separate from the Codex SDK approval policy."
-    },
-    "codexApprovalPolicy": {
-      "label": "Codex approval policy",
-      "help": "Deprecated. Use harnesses.codex.approvalPolicy instead."
+      "help": "Default plugin orchestration mode used when new coding-agent sessions are launched. Use this for plan/default/bypass behavior; Codex execution stays fixed to 'never'."
     },
     "planApproval": {
       "label": "Plan approval policy",
-      "help": "Choose whether plans are auto-approved, always escalated, or delegated to the orchestrator."
+      "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."
+    },
+    "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."
     }
   },
   "skills": [

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "openclaw-code-agent",
-  "version": "2.3.1",
+  "version": "3.1.0",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
-    "build": "esbuild index.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/index.js --minify --external:openclaw --external:openclaw/plugin-sdk --external:@anthropic-ai/claude-agent-sdk --external:@openai/codex-sdk",
-    "test": "find tests -type f -name '*.test.ts' -exec node --import tsx --test {} +",
-    "typecheck": "tsc --noEmit"
+    "build": "esbuild index.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/index.js --minify --external:openclaw --external:openclaw/plugin-sdk --external:@anthropic-ai/claude-agent-sdk",
+    "test": "node scripts/run-tests.mjs",
+    "test:serial": "node scripts/run-tests.mjs",
+    "test:file": "node scripts/run-tests.mjs",
+    "smoke:backend": "node scripts/run-tests.mjs tests/codex-harness.test.ts tests/plan-mode-e2e.test.ts tests/session-restore-service.test.ts",
+    "smoke:backend-parity": "node scripts/run-tests.mjs tests/backend-contract-smoke.test.ts tests/codex-harness.test.ts tests/harness-registry.test.ts",
+    "smoke:codex-worktrees": "node scripts/run-tests.mjs tests/codex-harness.test.ts tests/session-bootstrap.test.ts tests/session-restore-service.test.ts",
+    "smoke:codex-live": "OPENCLAW_RUN_LIVE_CODEX_SMOKE=1 node scripts/run-tests.mjs tests/live-codex-app-server-smoke.test.ts",
+    "smoke:codex-release": "OPENCLAW_RUN_LIVE_CODEX_RELEASE_SMOKE=1 node scripts/run-tests.mjs tests/live-codex-app-server-smoke.test.ts",
+    "typecheck": "tsc --noEmit",
+    "verify": "pnpm typecheck && pnpm build && pnpm test"
   },
   "openclaw": {
     "extensions": [
@@ -22,16 +30,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.37",
-    "@openai/codex-sdk": "^0.107.0"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.81"
   },
   "devDependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "@types/node": "^25.3.3",
-    "esbuild": "^0.27.3",
-    "nanoid": "^3.3.7",
+    "@types/node": "^25.5.0",
+    "esbuild": "^0.27.4",
+    "nanoid": "^5.1.7",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.2"
+    "typescript": "^6.0.2"
   },
   "keywords": [
     "openclaw",
@@ -62,5 +69,18 @@
   "publishConfig": {
     "access": "public"
   },
-  "description": "An OpenClaw plugin that orchestrates coding agent sessions as managed background processes. Launch, monitor, and control coding agents (Claude Code, Codex, and more) directly from your AI gateway."
+  "description": "An OpenClaw plugin that orchestrates coding agent sessions as managed background processes. Launch, monitor, and control coding agents (Claude Code, Codex, and more) directly from your AI gateway.",
+  "peerDependencies": {
+    "openclaw": ">=2026.3.22"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "koffi",
+      "protobufjs",
+      "sharp",
+      "@img/sharp-linux-x64",
+      "@img/sharp-linux-arm64"
+    ]
+  }
 }