@openclaw/codex 2026.9.3 → 2026.9.5

package/dist/web-search-contract-api.js

@@ -1,4 +1,4 @@
-import { t as createCodexWebSearchProviderBase } from "./web-search-provider.shared-BrZmlqyR.js";
+import { t as createCodexWebSearchProviderBase } from "./.setup/web-search-provider.shared-BrZmlqyR.mjs";
 //#region extensions/codex/web-search-contract-api.ts
 function createCodexWebSearchProvider() {
 	return {

package/openclaw.plugin.json

@@ -1,5 +1,15 @@
 {
   "id": "codex",
+  "categories": [
+    "agent-runtimes"
+  ],
+  "providers": [
+    "codex"
+  ],
+  "syntheticAuthRefs": [
+    "codex"
+  ],
+  "providerCatalogEntry": "./dist/provider-discovery.js",
   "backupResources": [
     {
       "disposition": "regenerable",
@@ -20,7 +30,9 @@
   "doctorContract": {
     "configRepair": true,
     "stateMigrations": [
-      { "id": "codex-app-server-sidecars-to-plugin-state" },
+      {
+        "id": "codex-app-server-sidecars-to-plugin-state"
+      },
       {
         "id": "codex-app-server-orphaned-session-bindings",
         "doctorOnly": true,
@@ -33,10 +45,23 @@
     {
       "id": "codex",
       "label": "Codex",
-      "providerIds": ["codex", "codex-cli", "openai-codex"],
-      "runtimeIds": ["codex", "codex-cli"],
-      "cliSessionKeys": ["codex-cli"],
-      "authProfilePrefixes": ["codex:", "codex-cli:", "openai-codex:"]
+      "providerIds": [
+        "codex",
+        "codex-cli",
+        "openai-codex"
+      ],
+      "runtimeIds": [
+        "codex",
+        "codex-cli"
+      ],
+      "cliSessionKeys": [
+        "codex-cli"
+      ],
+      "authProfilePrefixes": [
+        "codex:",
+        "codex-cli:",
+        "openai-codex:"
+      ]
     }
   ],
   "name": "Codex",
@@ -49,8 +74,12 @@
     }
   ],
   "contracts": {
-    "mediaUnderstandingProviders": ["codex"],
-    "migrationProviders": ["codex"],
+    "mediaUnderstandingProviders": [
+      "codex"
+    ],
+    "migrationProviders": [
+      "codex"
+    ],
     "tools": [
       "codex_threads",
       "codex_plugins",
@@ -60,20 +89,28 @@
       "codex_session_send",
       "codex_session_interrupt"
     ],
-    "webSearchProviders": ["codex"]
+    "webSearchProviders": [
+      "codex"
+    ]
   },
   "mediaUnderstandingProviderMetadata": {
     "codex": {
-      "capabilities": ["image"],
+      "capabilities": [
+        "image"
+      ],
       "defaultModels": {
-        "image": "gpt-5.6-sol"
+        "image": "gpt-6-astra"
       }
     }
   },
   "activation": {
     "onStartup": false,
-    "onAgentHarnesses": ["codex"],
-    "onCommands": ["codex"],
+    "onAgentHarnesses": [
+      "codex"
+    ],
+    "onCommands": [
+      "codex"
+    ],
     "onConfigPaths": [
       "plugins.entries.codex.config.appServer.transport",
       "plugins.entries.codex.config.sessionCatalog.enabled",
@@ -102,37 +139,111 @@
       ]
     }
   },
+  "configGroups": [
+    {
+      "id": "dynamic-tools",
+      "title": "Dynamic tools",
+      "order": 10,
+      "properties": [
+        "codexDynamicToolsLoading",
+        "codexDynamicToolsExclude"
+      ]
+    },
+    {
+      "id": "native-sessions",
+      "title": "Native sessions",
+      "order": 20,
+      "properties": [
+        "sessionCatalog",
+        "supervision"
+      ]
+    },
+    {
+      "id": "model-discovery",
+      "title": "Model discovery",
+      "order": 30,
+      "properties": [
+        "discovery"
+      ]
+    },
+    {
+      "id": "computer-use",
+      "title": "Computer use",
+      "order": 40,
+      "properties": [
+        "computerUse"
+      ]
+    },
+    {
+      "id": "native-plugins",
+      "title": "Native plugins",
+      "order": 50,
+      "properties": [
+        "codexPlugins"
+      ]
+    },
+    {
+      "id": "app-server-connection",
+      "title": "App Server connection",
+      "order": 60,
+      "properties": [
+        "appServer"
+      ]
+    }
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
       "codexDynamicToolsLoading": {
         "type": "string",
-        "enum": ["searchable", "direct"],
+        "enum": [
+          "searchable",
+          "direct"
+        ],
         "default": "searchable"
       },
       "codexDynamicToolsExclude": {
         "type": "array",
-        "items": { "type": "string" },
+        "items": {
+          "type": "string"
+        },
         "default": []
       },
       "sessionCatalog": {
         "type": "object",
         "additionalProperties": false,
         "properties": {
-          "enabled": { "type": "boolean", "default": true },
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
           "homes": {
             "type": "array",
             "items": {
               "anyOf": [
-                { "type": "string", "minLength": 1, "pattern": "\\S" },
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "pattern": "\\S"
+                },
                 {
                   "type": "object",
                   "additionalProperties": false,
-                  "required": ["path"],
+                  "required": [
+                    "path"
+                  ],
                   "properties": {
-                    "path": { "type": "string", "minLength": 1, "pattern": "\\S" },
-                    "label": { "type": "string", "minLength": 1, "pattern": "\\S" }
+                    "path": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S"
+                    },
+                    "label": {
+                      "type": "string",
+                      "minLength": 1,
+                      "pattern": "\\S"
+                    }
                   }
                 }
               ]
@@ -144,7 +255,9 @@
         "type": "object",
         "additionalProperties": false,
         "properties": {
-          "enabled": { "type": "boolean" },
+          "enabled": {
+            "type": "boolean"
+          },
           "timeoutMs": {
             "type": "number",
             "minimum": 1,
@@ -185,12 +298,20 @@
           },
           "healthCheckIntervalMinutes": {
             "type": "number",
-            "enum": [30, 60, 120, 240],
+            "enum": [
+              30,
+              60,
+              120,
+              240
+            ],
             "default": 60
           },
           "pluginCacheMode": {
             "type": "string",
-            "enum": ["shared", "independent"],
+            "enum": [
+              "shared",
+              "independent"
+            ],
             "default": "independent"
           },
           "strictReadiness": {
@@ -233,7 +354,17 @@
             "default": false
           },
           "allow_destructive_actions": {
-            "oneOf": [{ "type": "boolean" }, { "const": "auto" }, { "const": "ask" }],
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "const": "auto"
+              },
+              {
+                "const": "ask"
+              }
+            ],
             "default": true
           },
           "plugins": {
@@ -253,7 +384,17 @@
                   "type": "string"
                 },
                 "allow_destructive_actions": {
-                  "oneOf": [{ "type": "boolean" }, { "const": "auto" }, { "const": "ask" }]
+                  "oneOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "const": "auto"
+                    },
+                    {
+                      "const": "ask"
+                    }
+                  ]
                 }
               }
             }
@@ -264,7 +405,10 @@
         "type": "object",
         "additionalProperties": false,
         "properties": {
-          "enabled": { "type": "boolean", "default": false },
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
           "endpoints": {
             "type": "array",
             "items": {
@@ -273,31 +417,65 @@
                   "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" }
+                    "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"],
+                  "required": [
+                    "transport",
+                    "url"
+                  ],
                   "properties": {
-                    "id": { "type": "string" },
-                    "label": { "type": "string" },
-                    "transport": { "const": "websocket" },
-                    "url": { "type": "string" },
-                    "authTokenEnv": { "type": "string" }
+                    "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 }
+          "allowRawTranscripts": {
+            "type": "boolean",
+            "default": false
+          },
+          "allowWriteControls": {
+            "type": "boolean",
+            "default": false
+          }
         }
       },
       "appServer": {
@@ -306,36 +484,66 @@
         "properties": {
           "mode": {
             "type": "string",
-            "enum": ["yolo", "guardian"]
+            "enum": [
+              "yolo",
+              "guardian"
+            ]
           },
           "transport": {
             "type": "string",
-            "enum": ["stdio", "websocket", "unix"],
+            "enum": [
+              "stdio",
+              "websocket",
+              "unix"
+            ],
             "default": "stdio"
           },
           "homeScope": {
             "type": "string",
-            "enum": ["agent", "user"]
+            "enum": [
+              "agent",
+              "user"
+            ]
+          },
+          "command": {
+            "type": "string"
           },
-          "command": { "type": "string" },
           "args": {
             "oneOf": [
               {
                 "type": "array",
-                "items": { "type": "string" }
+                "items": {
+                  "type": "string"
+                }
               },
-              { "type": "string" }
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "url": {
+            "type": "string"
+          },
+          "authToken": {
+            "type": [
+              "string",
+              "object"
             ]
           },
-          "url": { "type": "string" },
-          "authToken": { "type": ["string", "object"] },
           "headers": {
             "type": "object",
-            "additionalProperties": { "type": ["string", "object"] }
+            "additionalProperties": {
+              "type": [
+                "string",
+                "object"
+              ]
+            }
           },
           "clearEnv": {
             "type": "array",
-            "items": { "type": "string" }
+            "items": {
+              "type": "string"
+            }
           },
           "remoteWorkspaceRoot": {
             "type": "string"
@@ -355,17 +563,59 @@
           },
           "approvalPolicy": {
             "type": "string",
-            "enum": ["never", "on-request", "on-failure", "untrusted"]
+            "enum": [
+              "never",
+              "on-request",
+              "on-failure",
+              "untrusted"
+            ]
           },
           "sandbox": {
             "type": "string",
-            "enum": ["read-only", "workspace-write", "danger-full-access"]
+            "enum": [
+              "read-only",
+              "workspace-write",
+              "danger-full-access"
+            ]
           },
           "approvalsReviewer": {
             "type": "string",
-            "enum": ["user", "auto_review", "guardian_subagent"]
+            "enum": [
+              "user",
+              "auto_review",
+              "guardian_subagent"
+            ]
+          },
+          "serviceTier": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "cyberFailover": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "auto",
+                  "off"
+                ],
+                "default": "auto"
+              },
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "default": "gpt-daybreak-blue-latest"
+              },
+              "cooloffMs": {
+                "type": "number",
+                "minimum": 1,
+                "default": 600000
+              }
+            }
           },
-          "serviceTier": { "type": ["string", "null"] },
           "networkProxy": {
             "type": "object",
             "additionalProperties": false,
@@ -374,37 +624,67 @@
                 "type": "boolean",
                 "default": false
               },
-              "profileName": { "type": "string" },
+              "profileName": {
+                "type": "string"
+              },
               "baseProfile": {
                 "type": "string",
-                "enum": ["read-only", "workspace"]
+                "enum": [
+                  "read-only",
+                  "workspace"
+                ]
               },
               "mode": {
                 "type": "string",
-                "enum": ["limited", "full"]
+                "enum": [
+                  "limited",
+                  "full"
+                ]
               },
               "domains": {
                 "type": "object",
                 "additionalProperties": {
                   "type": "string",
-                  "enum": ["allow", "deny"]
+                  "enum": [
+                    "allow",
+                    "deny"
+                  ]
                 }
               },
               "unixSockets": {
                 "type": "object",
                 "additionalProperties": {
                   "type": "string",
-                  "enum": ["allow", "none"]
+                  "enum": [
+                    "allow",
+                    "none"
+                  ]
                 }
               },
-              "proxyUrl": { "type": "string" },
-              "socksUrl": { "type": "string" },
-              "enableSocks5": { "type": "boolean" },
-              "enableSocks5Udp": { "type": "boolean" },
-              "allowUpstreamProxy": { "type": "boolean" },
-              "allowLocalBinding": { "type": "boolean" },
-              "dangerouslyAllowNonLoopbackProxy": { "type": "boolean" },
-              "dangerouslyAllowAllUnixSockets": { "type": "boolean" }
+              "proxyUrl": {
+                "type": "string"
+              },
+              "socksUrl": {
+                "type": "string"
+              },
+              "enableSocks5": {
+                "type": "boolean"
+              },
+              "enableSocks5Udp": {
+                "type": "boolean"
+              },
+              "allowUpstreamProxy": {
+                "type": "boolean"
+              },
+              "allowLocalBinding": {
+                "type": "boolean"
+              },
+              "dangerouslyAllowNonLoopbackProxy": {
+                "type": "boolean"
+              },
+              "dangerouslyAllowAllUnixSockets": {
+                "type": "boolean"
+              }
             }
           },
           "defaultWorkspaceDir": {
@@ -427,8 +707,14 @@
   "configContracts": {
     "secretInputs": {
       "paths": [
-        { "path": "appServer.authToken", "expected": "string" },
-        { "path": "appServer.headers.*", "expected": "string" }
+        {
+          "path": "appServer.authToken",
+          "expected": "string"
+        },
+        {
+          "path": "appServer.headers.*",
+          "expected": "string"
+        }
       ]
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/codex",
-  "version": "2026.9.3",
+  "version": "2026.9.5",
   "description": "OpenClaw Codex app-server harness and native session supervision plugin.",
   "repository": {
     "type": "git",
@@ -8,12 +8,12 @@
   },
   "type": "module",
   "dependencies": {
-    "@openai/codex": "0.153.4",
+    "@openai/codex": "0.154.0",
     "semver": "7.8.5",
     "smol-toml": "1.8.0",
-    "typebox": "1.3.18",
+    "typebox": "1.3.30",
     "ws": "8.21.3",
-    "zod": "4.4.3"
+    "zod": "4.5.4"
   },
   "devDependencies": {
     "@openclaw/plugin-sdk": "workspace:*"
@@ -23,6 +23,7 @@
       "./index.ts"
     ],
     "install": {
+      "clawhubSpec": "clawhub:@openclaw/codex",
       "npmSpec": "@openclaw/codex",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.5.1-beta.1",
@@ -36,10 +37,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.9.3"
+      "pluginApi": ">=2026.9.5"
     },
     "build": {
-      "openclawVersion": "2026.9.3"
+      "openclawVersion": "2026.9.5"
     },
     "release": {
       "publishToClawHub": true,
@@ -56,10 +57,12 @@
   "files": [
     "dist/**",
     "openclaw.plugin.json",
-    "README.md"
+    "README.md",
+    "assets/icon.png",
+    "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.9.3"
+    "openclaw": ">=2026.9.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {