@openclaw/codex 2026.7.1 → 2026.7.2-beta.2

package/npm-shrinkwrap.json

@@ -1,23 +1,25 @@
 {
   "name": "@openclaw/codex",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/codex",
-      "version": "2026.7.1",
+      "version": "2026.7.2-beta.2",
       "dependencies": {
-        "@openai/codex": "0.144.3",
+        "@openai/codex": "0.144.5",
+        "semver": "7.8.5",
+        "smol-toml": "1.7.0",
         "typebox": "1.3.3",
         "ws": "8.21.0",
         "zod": "4.4.3"
       }
     },
     "node_modules/@openai/codex": {
-      "version": "0.144.3",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3.tgz",
-      "integrity": "sha512-8Re3wp5CdYiM7nsF4StFa5js6IT11N7srhxfvwtol7ENHDht05C+HS4e1CTmYjqkhgsUzl2R1gB27iN2pdbVnA==",
+      "version": "0.144.5",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5.tgz",
+      "integrity": "sha512-jjB+K+OMv572mKhS+2QuLxWXDJNdpwbPenf+V+8bdq7wg4Scqt3cn6WEekD8wPqDVZqck0HSX17K9rD9kbDJQA==",
       "license": "Apache-2.0",
       "bin": {
         "codex": "bin/codex.js"
@@ -26,19 +28,19 @@
         "node": ">=16"
       },
       "optionalDependencies": {
-        "@openai/codex-darwin-arm64": "npm:@openai/codex@0.144.3-darwin-arm64",
-        "@openai/codex-darwin-x64": "npm:@openai/codex@0.144.3-darwin-x64",
-        "@openai/codex-linux-arm64": "npm:@openai/codex@0.144.3-linux-arm64",
-        "@openai/codex-linux-x64": "npm:@openai/codex@0.144.3-linux-x64",
-        "@openai/codex-win32-arm64": "npm:@openai/codex@0.144.3-win32-arm64",
-        "@openai/codex-win32-x64": "npm:@openai/codex@0.144.3-win32-x64"
+        "@openai/codex-darwin-arm64": "npm:@openai/codex@0.144.5-darwin-arm64",
+        "@openai/codex-darwin-x64": "npm:@openai/codex@0.144.5-darwin-x64",
+        "@openai/codex-linux-arm64": "npm:@openai/codex@0.144.5-linux-arm64",
+        "@openai/codex-linux-x64": "npm:@openai/codex@0.144.5-linux-x64",
+        "@openai/codex-win32-arm64": "npm:@openai/codex@0.144.5-win32-arm64",
+        "@openai/codex-win32-x64": "npm:@openai/codex@0.144.5-win32-x64"
       }
     },
     "node_modules/@openai/codex-darwin-arm64": {
       "name": "@openai/codex",
-      "version": "0.144.3-darwin-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-darwin-arm64.tgz",
-      "integrity": "sha512-v/yT1wqslBcwquUvUPZvAdYyiZcCBIUL+pE4ymHpbUMVduwDJBw1EjLroOhe9FkYFDHzWGyv7YEw7iIV4k+0dA==",
+      "version": "0.144.5-darwin-arm64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-darwin-arm64.tgz",
+      "integrity": "sha512-zcT6NfBCqLFt+BReNSETTZW6v6PdbH0dzNtm9j7l7mDGqwPbKZDGJdnpkBao2389I0ZacyIKgSZoI0vez1d4Dw==",
       "cpu": [
         "arm64"
       ],
@@ -53,9 +55,9 @@
     },
     "node_modules/@openai/codex-darwin-x64": {
       "name": "@openai/codex",
-      "version": "0.144.3-darwin-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-darwin-x64.tgz",
-      "integrity": "sha512-308U0s7AeRg3AlnxJtmJk03yRRriEplC6ceFoB3OpWh+przqt8/u6MKDVU3KHdjb+vasa0IpmDWv5VrFw3oJAw==",
+      "version": "0.144.5-darwin-x64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-darwin-x64.tgz",
+      "integrity": "sha512-//Mo0m1MwaoT6psu5xsmofXpKx4/0irIkeq10xJvk59+886EG355ibjA+ZmlRcKhE3bLjsKD7p81nTbAdRL/bw==",
       "cpu": [
         "x64"
       ],
@@ -70,9 +72,9 @@
     },
     "node_modules/@openai/codex-linux-arm64": {
       "name": "@openai/codex",
-      "version": "0.144.3-linux-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-linux-arm64.tgz",
-      "integrity": "sha512-mJgDUmoPMry9a7g6ywsMQ4uQko2K0uHLqzEITUJMXiNNbCRBQKS+PxDWBlSK0bF0v72uAhWRRRGvPXslwhIdyg==",
+      "version": "0.144.5-linux-arm64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-linux-arm64.tgz",
+      "integrity": "sha512-zAHggxVwR2TBxKmybXY7ZMiB0G8DMonY2YPdwNNjwXcf+LOIqNGgswwNCDMbP/HEe6r8j+R9ZX/yYoo8f+n/RQ==",
       "cpu": [
         "arm64"
       ],
@@ -87,9 +89,9 @@
     },
     "node_modules/@openai/codex-linux-x64": {
       "name": "@openai/codex",
-      "version": "0.144.3-linux-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-linux-x64.tgz",
-      "integrity": "sha512-xtDY5sWQPbYBj2lLWZJvc0jBre0XQ7ZmN4VbSEvazbQ2X7uHhm1D/0oZ7AI+SgC/VfZrUhvxRHd43/AmXSaAzA==",
+      "version": "0.144.5-linux-x64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-linux-x64.tgz",
+      "integrity": "sha512-FalLJlBQGFdK8Gc3kj9sa/ekNdgkHhUawLaKkvy5CtB18JaP2YxtTP/Pe1pD2iBiq8mMUliRnafpF6AdBdQMbg==",
       "cpu": [
         "x64"
       ],
@@ -104,9 +106,9 @@
     },
     "node_modules/@openai/codex-win32-arm64": {
       "name": "@openai/codex",
-      "version": "0.144.3-win32-arm64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-win32-arm64.tgz",
-      "integrity": "sha512-uvgBLuBX58GIq58CquhvhEmwLlH9Lc46rLmE5/CkEf1vQiCvWqVHxL28t7P9cmWGoeMuxsrIwqJgyzmRu6wZMQ==",
+      "version": "0.144.5-win32-arm64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-win32-arm64.tgz",
+      "integrity": "sha512-0Pj7iqjEOEvPQPO3kFfCy9vGX4BTu76ChFFZHr2eNNIfVc3FOENAv/X98u4L+iIUtDOK9DbqmfUudW3DPapshg==",
       "cpu": [
         "arm64"
       ],
@@ -121,9 +123,9 @@
     },
     "node_modules/@openai/codex-win32-x64": {
       "name": "@openai/codex",
-      "version": "0.144.3-win32-x64",
-      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.3-win32-x64.tgz",
-      "integrity": "sha512-0o8LpbZuBvqcAdIqMh96pECFTtfkgMT2sP/Q2IKYUOOlSudq3ulvdDW6zARq04HhbOxSsU9TBYDkdqtDs2YcYQ==",
+      "version": "0.144.5-win32-x64",
+      "resolved": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.5-win32-x64.tgz",
+      "integrity": "sha512-DnsSTlnnzleTxvLwIGnBitKInscxn2I7qASqosS8Fv+qysBygd+ZiBn/SQsRCgQ28PAlsNzmd3Gf3ZTecolAmg==",
       "cpu": [
         "x64"
       ],
@@ -136,6 +138,30 @@
         "node": ">=16"
       }
     },
+    "node_modules/semver": {
+      "version": "7.8.5",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/smol-toml": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.7.0.tgz",
+      "integrity": "sha512-aqVvWoyO21L23mb+drl4RmMXbf6N7FdHjAhTRA9ZBL7apWBgfWC16KjrASI+1p9GAroljyMHj6fK67i0UiTNvQ==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/cyyynthia"
+      }
+    },
     "node_modules/typebox": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/typebox/-/typebox-1.3.3.tgz",

package/openclaw.plugin.json

@@ -1,28 +1,36 @@
 {
   "id": "codex",
   "name": "Codex",
-  "description": "OpenClaw Codex app-server harness and model provider plugin with a Codex-managed GPT catalog.",
-  "providers": ["codex"],
+  "description": "Codex app-server harness and native session catalog.",
   "contracts": {
     "mediaUnderstandingProviders": ["codex"],
     "migrationProviders": ["codex"],
-    "tools": ["codex_threads"],
+    "tools": [
+      "codex_threads",
+      "codex_endpoint_probe",
+      "codex_sessions_list",
+      "codex_session_read",
+      "codex_session_send",
+      "codex_session_interrupt"
+    ],
     "webSearchProviders": ["codex"]
   },
   "mediaUnderstandingProviderMetadata": {
     "codex": {
       "capabilities": ["image"],
       "defaultModels": {
-        "image": "gpt-5.5"
+        "image": "gpt-5.6-sol"
       }
     }
   },
-  "providerCatalogEntry": "./provider-discovery.ts",
-  "syntheticAuthRefs": ["codex"],
-  "nonSecretAuthMarkers": ["codex-app-server"],
   "activation": {
     "onStartup": false,
-    "onAgentHarnesses": ["codex"]
+    "onAgentHarnesses": ["codex"],
+    "onCommands": ["codex"],
+    "onConfigPaths": [
+      "plugins.entries.codex.config.sessionCatalog.enabled",
+      "plugins.entries.codex.config.supervision.enabled"
+    ]
   },
   "commandAliases": [
     {
@@ -45,6 +53,13 @@
         "items": { "type": "string" },
         "default": []
       },
+      "sessionCatalog": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean", "default": true }
+        }
+      },
       "discovery": {
         "type": "object",
         "additionalProperties": false,
@@ -74,6 +89,38 @@
             "minimum": 1,
             "default": 60000
           },
+          "liveTestTimeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 60000
+          },
+          "toolCallTimeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 60000
+          },
+          "healthCheckEnabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "healthCheckIntervalMinutes": {
+            "type": "number",
+            "enum": [30, 60, 120, 240],
+            "default": 60
+          },
+          "pluginCacheMode": {
+            "type": "string",
+            "enum": ["shared", "independent"],
+            "default": "independent"
+          },
+          "strictReadiness": {
+            "type": "boolean",
+            "default": false
+          },
+          "autoRepair": {
+            "type": "boolean",
+            "default": false
+          },
           "marketplaceSource": {
             "type": "string"
           },
@@ -120,7 +167,7 @@
                 },
                 "marketplaceName": {
                   "type": "string",
-                  "enum": ["openai-curated"]
+                  "enum": ["openai-curated", "workspace-directory"]
                 },
                 "pluginName": {
                   "type": "string"
@@ -133,6 +180,46 @@
           }
         }
       },
+      "supervision": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean", "default": false },
+          "endpoints": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "id": { "type": "string" },
+                    "label": { "type": "string" },
+                    "transport": { "const": "stdio-proxy" },
+                    "command": { "type": "string" },
+                    "args": { "type": "array", "items": { "type": "string" } },
+                    "cwd": { "type": "string" }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["transport", "url"],
+                  "properties": {
+                    "id": { "type": "string" },
+                    "label": { "type": "string" },
+                    "transport": { "const": "websocket" },
+                    "url": { "type": "string" },
+                    "authTokenEnv": { "type": "string" }
+                  }
+                }
+              ]
+            }
+          },
+          "allowRawTranscripts": { "type": "boolean", "default": false },
+          "allowWriteControls": { "type": "boolean", "default": false }
+        }
+      },
       "appServer": {
         "type": "object",
         "additionalProperties": false,
@@ -143,7 +230,7 @@
           },
           "transport": {
             "type": "string",
-            "enum": ["stdio", "websocket"],
+            "enum": ["stdio", "websocket", "unix"],
             "default": "stdio"
           },
           "homeScope": {
@@ -178,6 +265,10 @@
             "type": "boolean",
             "default": false
           },
+          "loopDetectionPreToolUseRelay": {
+            "type": "boolean",
+            "default": true
+          },
           "requestTimeoutMs": {
             "type": "number",
             "minimum": 1,
@@ -273,6 +364,14 @@
     }
   },
   "uiHints": {
+    "sessionCatalog": {
+      "label": "Native Session Discovery",
+      "help": "Controls whether Codex sessions from this Gateway and paired nodes appear in the sidebar. Disabling also removes this host's paired-node catalog commands without disabling the Codex provider or harness. Node-list failures usually indicate a Gateway pairing-store or node-registry problem; verify Settings > Devices or run openclaw nodes list. Changes require a Gateway restart."
+    },
+    "sessionCatalog.enabled": {
+      "label": "Discover Codex Sessions",
+      "help": "List native Codex sessions in the sidebar from this Gateway and eligible paired nodes."
+    },
     "codexDynamicToolsLoading": {
       "label": "Dynamic Tools Loading",
       "help": "Use searchable to defer OpenClaw dynamic tools behind Codex tool search, or direct to expose them in the initial context.",
@@ -316,6 +415,41 @@
       "help": "Maximum time to wait for Codex app-server to finish loading marketplaces during Computer Use install.",
       "advanced": true
     },
+    "computerUse.liveTestTimeoutMs": {
+      "label": "Live Test Timeout",
+      "help": "Maximum time for the Computer Use list_apps readiness probe before status and startup treat the live test as failed.",
+      "advanced": true
+    },
+    "computerUse.toolCallTimeoutMs": {
+      "label": "Tool Call Timeout",
+      "help": "Maximum expected time for real Computer Use tool calls such as list_apps before OpenClaw treats the child runtime as stale.",
+      "advanced": true
+    },
+    "computerUse.healthCheckEnabled": {
+      "label": "Periodic Health Checks",
+      "help": "When true, run periodic Computer Use live probes on the configured cadence.",
+      "advanced": true
+    },
+    "computerUse.healthCheckIntervalMinutes": {
+      "label": "Health Check Interval",
+      "help": "Cadence for periodic Computer Use health checks when health checks are enabled.",
+      "advanced": true
+    },
+    "computerUse.pluginCacheMode": {
+      "label": "Plugin Cache Mode",
+      "help": "The default independent mode leaves each Codex home unmanaged. Choose shared to opt in to a refreshed Codex-discoverable cache copy.",
+      "advanced": true
+    },
+    "computerUse.strictReadiness": {
+      "label": "Strict Readiness",
+      "help": "When true, a failed Computer Use live probe stops Codex-mode startup. The default false value preserves existing enabled setups by continuing with a warning.",
+      "advanced": true
+    },
+    "computerUse.autoRepair": {
+      "label": "Auto Repair",
+      "help": "When true, failed Computer Use live tests repair stale scoped Computer Use MCP children before retrying once.",
+      "advanced": true
+    },
     "computerUse.marketplaceSource": {
       "label": "Marketplace Source",
       "help": "Optional Codex marketplace source to add before installing Computer Use.",
@@ -348,7 +482,7 @@
     },
     "codexPlugins.enabled": {
       "label": "Enable Native Plugins",
-      "help": "Expose explicit migrated Codex plugin entries to Codex harness turns.",
+      "help": "Expose explicit Codex plugin entries to Codex harness turns.",
       "advanced": true
     },
     "codexPlugins.allow_all_plugins": {
@@ -362,8 +496,32 @@
       "advanced": true
     },
     "codexPlugins.plugins": {
-      "label": "Migrated Plugin Entries",
-      "help": "Explicit migration-authored plugin entries. The wildcard key * is not supported.",
+      "label": "Plugin Entries",
+      "help": "Explicit plugin entries. The wildcard key * is not supported.",
+      "advanced": true
+    },
+    "supervision": {
+      "label": "Codex Supervision",
+      "help": "Configure the separate user-home App Server connection used by the native session catalog and optional supervision tools.",
+      "advanced": true
+    },
+    "supervision.enabled": {
+      "label": "Enable Codex Supervision",
+      "help": "Enable agent-facing Codex supervision tools. The operator session catalog remains available whenever the plugin is active."
+    },
+    "supervision.endpoints": {
+      "label": "Legacy Supervisor Endpoints",
+      "help": "Advanced compatibility endpoints for migrated Codex Supervisor agent tools.",
+      "advanced": true
+    },
+    "supervision.allowRawTranscripts": {
+      "label": "Allow Raw Transcript Tools",
+      "help": "Allow supervision agent tools, including turn-inclusive codex_threads reads, to expose full transcripts and transcript previews.",
+      "advanced": true
+    },
+    "supervision.allowWriteControls": {
+      "label": "Allow Write Control Tools",
+      "help": "Allow supervision agent tools to control turns and let codex_threads fork, rename, archive, or unarchive native threads.",
       "advanced": true
     },
     "appServer": {
@@ -378,7 +536,7 @@
     },
     "appServer.transport": {
       "label": "Transport",
-      "help": "Use stdio to spawn Codex locally, or websocket to connect to an already-running app-server.",
+      "help": "Use stdio to spawn Codex locally, unix for the shared local control socket, or websocket for a remote app-server.",
       "advanced": true
     },
     "appServer.homeScope": {
@@ -428,6 +586,11 @@
       "help": "Expose Codex's code-mode-only tool surface. OpenClaw dynamic tools remain available through Codex nested tool calls.",
       "advanced": true
     },
+    "appServer.loopDetectionPreToolUseRelay": {
+      "label": "Loop Detection Pre-tool Relay",
+      "help": "Install the Codex PreToolUse subprocess used only for OpenClaw loop detection and its no-policy marker. Disable to reduce per-tool process fan-out; before-tool and trusted policy relays remain enforced.",
+      "advanced": true
+    },
     "appServer.requestTimeoutMs": {
       "label": "Request Timeout",
       "help": "Maximum time to wait for Codex app-server control-plane requests.",

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@openclaw/codex",
-  "version": "2026.7.1",
-  "description": "OpenClaw Codex app-server harness and model provider plugin with a Codex-managed GPT catalog.",
+  "version": "2026.7.2-beta.2",
+  "description": "OpenClaw Codex app-server harness and native session supervision plugin.",
   "repository": {
     "type": "git",
     "url": "https://github.com/openclaw/openclaw"
   },
   "type": "module",
   "dependencies": {
-    "@openai/codex": "0.144.3",
+    "@openai/codex": "0.144.5",
+    "semver": "7.8.5",
+    "smol-toml": "1.7.0",
     "typebox": "1.3.3",
     "ws": "8.21.0",
     "zod": "4.4.3"
@@ -34,10 +36,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.7.1"
+      "pluginApi": ">=2026.7.2-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.1"
+      "openclawVersion": "2026.7.2-beta.2"
     },
     "release": {
       "publishToClawHub": true,
@@ -58,7 +60,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.1"
+    "openclaw": ">=2026.7.2-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {