@kodelyth/codex 2026.5.40

package/doctor-contract-api.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/doctor-contract-api.js";
+import * as module from "../../../dist/extensions/codex/doctor-contract-api.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/harness.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/harness.js";
+import * as module from "../../../dist/extensions/codex/harness.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/index.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/index.js";
+import defaultModule from "../../../dist/extensions/codex/index.js";
+let defaultExport = defaultModule;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/klaw.plugin.json

@@ -0,0 +1,435 @@
+{
+  "id": "codex",
+  "name": "Codex",
+  "description": "Codex app-server harness and Codex-managed GPT model catalog.",
+  "providers": [
+    "codex"
+  ],
+  "contracts": {
+    "mediaUnderstandingProviders": [
+      "codex"
+    ],
+    "migrationProviders": [
+      "codex"
+    ]
+  },
+  "mediaUnderstandingProviderMetadata": {
+    "codex": {
+      "capabilities": [
+        "image"
+      ],
+      "defaultModels": {
+        "image": "gpt-5.5"
+      }
+    }
+  },
+  "providerCatalogEntry": "./provider-discovery.ts",
+  "syntheticAuthRefs": [
+    "codex"
+  ],
+  "nonSecretAuthMarkers": [
+    "codex-app-server"
+  ],
+  "activation": {
+    "onStartup": false,
+    "onAgentHarnesses": [
+      "codex"
+    ]
+  },
+  "commandAliases": [
+    {
+      "name": "codex",
+      "kind": "runtime-slash",
+      "cliCommand": "plugins"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "codexDynamicToolsLoading": {
+        "type": "string",
+        "enum": [
+          "searchable",
+          "direct"
+        ],
+        "default": "searchable"
+      },
+      "codexDynamicToolsExclude": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "default": []
+      },
+      "discovery": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "timeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 2500
+          }
+        }
+      },
+      "computerUse": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "autoInstall": {
+            "type": "boolean",
+            "default": false
+          },
+          "marketplaceDiscoveryTimeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 60000
+          },
+          "marketplaceSource": {
+            "type": "string"
+          },
+          "marketplacePath": {
+            "type": "string"
+          },
+          "marketplaceName": {
+            "type": "string"
+          },
+          "pluginName": {
+            "type": "string",
+            "default": "computer-use"
+          },
+          "mcpServerName": {
+            "type": "string",
+            "default": "computer-use"
+          }
+        }
+      },
+      "codexPlugins": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "allow_destructive_actions": {
+            "type": "boolean",
+            "default": true
+          },
+          "plugins": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "marketplaceName": {
+                  "type": "string",
+                  "enum": [
+                    "openai-curated"
+                  ]
+                },
+                "pluginName": {
+                  "type": "string"
+                },
+                "allow_destructive_actions": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      },
+      "appServer": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "yolo",
+              "guardian"
+            ],
+            "default": "yolo"
+          },
+          "transport": {
+            "type": "string",
+            "enum": [
+              "stdio",
+              "websocket"
+            ],
+            "default": "stdio"
+          },
+          "command": {
+            "type": "string"
+          },
+          "args": {
+            "oneOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "url": {
+            "type": "string"
+          },
+          "authToken": {
+            "type": "string"
+          },
+          "headers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "clearEnv": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "codeModeOnly": {
+            "type": "boolean",
+            "default": false
+          },
+          "requestTimeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 60000
+          },
+          "turnCompletionIdleTimeoutMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 60000
+          },
+          "approvalPolicy": {
+            "type": "string",
+            "enum": [
+              "never",
+              "on-request",
+              "on-failure",
+              "untrusted"
+            ]
+          },
+          "sandbox": {
+            "type": "string",
+            "enum": [
+              "read-only",
+              "workspace-write",
+              "danger-full-access"
+            ]
+          },
+          "approvalsReviewer": {
+            "type": "string",
+            "enum": [
+              "user",
+              "auto_review",
+              "guardian_subagent"
+            ]
+          },
+          "serviceTier": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "defaultWorkspaceDir": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "codexDynamicToolsLoading": {
+      "label": "Dynamic Tools Loading",
+      "help": "Use searchable to defer Klaw dynamic tools behind Codex tool search, or direct to expose them in the initial context.",
+      "advanced": true
+    },
+    "codexDynamicToolsExclude": {
+      "label": "Dynamic Tool Excludes",
+      "help": "Additional Klaw dynamic tool names to omit from Codex app-server turns.",
+      "advanced": true
+    },
+    "discovery": {
+      "label": "Model Discovery",
+      "help": "Plugin-owned controls for discovering Codex app-server models."
+    },
+    "discovery.enabled": {
+      "label": "Enable Discovery",
+      "help": "When false, Klaw keeps the Codex harness available but uses the bundled fallback model list."
+    },
+    "discovery.timeoutMs": {
+      "label": "Discovery Timeout",
+      "help": "Maximum time to wait for Codex app-server model discovery before falling back to the bundled model list.",
+      "advanced": true
+    },
+    "computerUse": {
+      "label": "Computer Use",
+      "help": "Controls Codex app-server setup for the Computer Use plugin.",
+      "advanced": true
+    },
+    "computerUse.enabled": {
+      "label": "Enable Computer Use",
+      "help": "When true, Codex-mode turns require the configured Computer Use MCP server to be available.",
+      "advanced": true
+    },
+    "computerUse.autoInstall": {
+      "label": "Auto Install",
+      "help": "Install the configured Computer Use plugin when Codex-mode turns start.",
+      "advanced": true
+    },
+    "computerUse.marketplaceDiscoveryTimeoutMs": {
+      "label": "Marketplace Discovery Timeout",
+      "help": "Maximum time to wait for Codex app-server to finish loading marketplaces during Computer Use install.",
+      "advanced": true
+    },
+    "computerUse.marketplaceSource": {
+      "label": "Marketplace Source",
+      "help": "Optional Codex marketplace source to add before installing Computer Use.",
+      "advanced": true
+    },
+    "computerUse.marketplacePath": {
+      "label": "Marketplace Path",
+      "help": "Optional local Codex marketplace file path containing the Computer Use plugin.",
+      "advanced": true
+    },
+    "computerUse.marketplaceName": {
+      "label": "Marketplace Name",
+      "help": "Optional registered Codex marketplace name containing the Computer Use plugin.",
+      "advanced": true
+    },
+    "computerUse.pluginName": {
+      "label": "Plugin Name",
+      "help": "Codex marketplace plugin name for Computer Use.",
+      "advanced": true
+    },
+    "computerUse.mcpServerName": {
+      "label": "MCP Server Name",
+      "help": "MCP server name exposed by the Computer Use plugin.",
+      "advanced": true
+    },
+    "codexPlugins": {
+      "label": "Native Codex Plugins",
+      "help": "Controls native Codex plugin availability for Codex harness turns.",
+      "advanced": true
+    },
+    "codexPlugins.enabled": {
+      "label": "Enable Native Plugins",
+      "help": "Expose explicit migrated Codex plugin entries to Codex harness turns.",
+      "advanced": true
+    },
+    "codexPlugins.allow_destructive_actions": {
+      "label": "Allow Destructive Plugin Actions",
+      "help": "Default policy for plugin app write or destructive action elicitations. Defaults to true.",
+      "advanced": true
+    },
+    "codexPlugins.plugins": {
+      "label": "Migrated Plugin Entries",
+      "help": "Explicit migration-authored plugin entries. The wildcard key * is not supported.",
+      "advanced": true
+    },
+    "appServer": {
+      "label": "App Server",
+      "help": "Runtime controls for connecting to Codex app-server.",
+      "advanced": true
+    },
+    "appServer.mode": {
+      "label": "Execution Mode",
+      "help": "Use yolo for unchained local execution or guardian for Codex guardian-reviewed approvals.",
+      "advanced": true
+    },
+    "appServer.transport": {
+      "label": "Transport",
+      "help": "Use stdio to spawn Codex locally, or websocket to connect to an already-running app-server.",
+      "advanced": true
+    },
+    "appServer.command": {
+      "label": "Command",
+      "help": "Executable used for stdio transport. Leave unset to use Klaw's managed Codex binary.",
+      "advanced": true
+    },
+    "appServer.args": {
+      "label": "Arguments",
+      "help": "Arguments used for stdio transport. Defaults to app-server --listen stdio://.",
+      "advanced": true
+    },
+    "appServer.url": {
+      "label": "WebSocket URL",
+      "help": "Codex app-server WebSocket URL when transport is websocket.",
+      "advanced": true
+    },
+    "appServer.authToken": {
+      "label": "Auth Token",
+      "help": "Bearer token sent to the WebSocket app-server.",
+      "sensitive": true,
+      "advanced": true
+    },
+    "appServer.headers": {
+      "label": "Headers",
+      "help": "Additional headers sent to the WebSocket app-server.",
+      "advanced": true
+    },
+    "appServer.clearEnv": {
+      "label": "Clear Environment",
+      "help": "Environment variable names removed from the spawned stdio app-server process after overrides are applied.",
+      "advanced": true
+    },
+    "appServer.codeModeOnly": {
+      "label": "Code Mode Only",
+      "help": "Expose Codex's code-mode-only tool surface. Klaw dynamic tools remain available through Codex nested tool calls.",
+      "advanced": true
+    },
+    "appServer.requestTimeoutMs": {
+      "label": "Request Timeout",
+      "help": "Maximum time to wait for Codex app-server control-plane requests.",
+      "advanced": true
+    },
+    "appServer.turnCompletionIdleTimeoutMs": {
+      "label": "Turn Completion Idle Timeout",
+      "help": "Maximum quiet time after Codex accepts a turn or after a turn-scoped app-server request before Klaw interrupts the turn while waiting for turn/completed.",
+      "advanced": true
+    },
+    "appServer.approvalPolicy": {
+      "label": "Approval Policy",
+      "help": "Codex native approval policy sent to thread start, resume, and turns.",
+      "advanced": true
+    },
+    "appServer.sandbox": {
+      "label": "Sandbox",
+      "help": "Codex native sandbox mode sent to thread start and resume.",
+      "advanced": true
+    },
+    "appServer.approvalsReviewer": {
+      "label": "Approvals Reviewer",
+      "help": "Use user approvals or Codex auto_review for native app-server approvals. guardian_subagent remains accepted for compatibility.",
+      "advanced": true
+    },
+    "appServer.serviceTier": {
+      "label": "Service Tier",
+      "help": "Optional Codex app-server service tier. Use priority, flex, or null. Legacy fast is accepted as priority.",
+      "advanced": true
+    },
+    "appServer.defaultWorkspaceDir": {
+      "label": "Default Workspace",
+      "help": "Workspace used by /codex bind when --cwd is omitted.",
+      "advanced": true
+    }
+  }
+}

package/media-understanding-provider.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/media-understanding-provider.js";
+import * as module from "../../../dist/extensions/codex/media-understanding-provider.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kodelyth/codex",
+  "version": "2026.5.40",
+  "description": "Klaw Codex harness and model provider plugin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kodelyth/klaw"
+  },
+  "type": "module",
+  "dependencies": {
+    "@earendil-works/pi-coding-agent": "0.75.1",
+    "@openai/codex": "0.130.0",
+    "ajv": "8.20.0",
+    "ws": "8.20.1",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@kodelyth/plugin-sdk": "1.0.1"
+  },
+  "klaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "npmSpec": "@kodelyth/codex",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.5.1-beta.1"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.40"
+    },
+    "build": {
+      "klawVersion": "2026.5.40"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}

package/prompt-overlay.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/prompt-overlay.js";
+import * as module from "../../../dist/extensions/codex/prompt-overlay.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/provider-catalog.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/provider-catalog.js";
+import * as module from "../../../dist/extensions/codex/provider-catalog.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/provider-discovery.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/provider-discovery.js";
+import defaultModule from "../../../dist/extensions/codex/provider-discovery.js";
+let defaultExport = defaultModule;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/provider.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/provider.js";
+import * as module from "../../../dist/extensions/codex/provider.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };

package/test-api.js

@@ -0,0 +1,7 @@
+export * from "../../../dist/extensions/codex/test-api.js";
+import * as module from "../../../dist/extensions/codex/test-api.js";
+let defaultExport = "default" in module ? module.default : module;
+for (let index = 0; index < 4 && defaultExport && typeof defaultExport === "object" && "default" in defaultExport; index += 1) {
+  defaultExport = defaultExport.default;
+}
+export { defaultExport as default };