@oai404iao/pi-codex-minimal-tools 1.3.0

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,97 @@
+# Third-party notices
+
+## OpenAI Codex
+
+This package includes and analyzes material from
+[OpenAI Codex](https://github.com/openai/codex) at revision
+[`eb9dceba1a2e658142a456c5898836774835616b`](https://github.com/openai/codex/commit/eb9dceba1a2e658142a456c5898836774835616b).
+
+### Exact upstream snapshot
+
+`src/providers/codex-apply-patch.lark` is an exact copy of:
+
+```text
+codex-rs/core/src/tools/handlers/apply_patch.lark
+```
+
+at the revision above. OpenAI Codex distributes that file under the Apache
+License 2.0. The license and upstream NOTICE are included in:
+
+- `LICENSES/Apache-2.0.txt`
+- `LICENSES/OpenAI-Codex-NOTICE.txt`
+
+### Modified compatibility implementation
+
+`src/patch/parser.ts` and `src/patch/apply.ts` are substantially modified
+TypeScript adaptations of the Codex apply-patch parsing and matching behavior
+analyzed at revision
+[`03bb3b12367397e14a8facc2e018d645ff4d8e83`](https://github.com/openai/codex/commit/03bb3b12367397e14a8facc2e018d645ff4d8e83).
+The primary upstream paths were:
+
+```text
+codex-rs/apply-patch/src/parser.rs
+codex-rs/apply-patch/src/streaming_parser.rs
+codex-rs/apply-patch/src/seek_sequence.rs
+codex-rs/apply-patch/src/lib.rs
+codex-rs/core/src/tools/handlers/apply_patch.rs
+codex-rs/core/src/tools/handlers/apply_patch_spec.rs
+```
+
+The local files were rewritten for TypeScript and Pi, including virtual-state
+preflight, symlink and overwrite checks, mutation serialization, rollback,
+CRLF preservation, and renderer preview integration. They carry prominent
+source and modification notices and remain subject to the included
+Apache-2.0 terms for the adapted material.
+
+### Derived analysis
+
+The repository's `reference/` directory contains protocol analysis based on
+both Codex revisions above. It is development documentation and is excluded
+from the npm tarball.
+
+### Modified namespace-tool compatibility serialization
+
+`src/codex-reserved-tools.ts` is a modified TypeScript compatibility
+serialization of the Codex namespace-tool construction at the pinned revision
+above. It preserves the local `web.run` and `image_gen.imagegen` declaration
+shapes used by this package's internal Responses Lite path; it is not an exact
+copy of one upstream file or an OpenAI-supported public API contract.
+
+The two local function descriptions are byte-for-byte matches for:
+
+```text
+codex-rs/ext/web-search/web_run_description.md
+codex-rs/ext/image-generation/imagegen_description.md
+```
+
+The local `web.run` parameters are a compatibility serialization derived from
+the web-search schema generator and `SearchCommands` input types in:
+
+```text
+codex-rs/ext/web-search/src/tool.rs
+codex-rs/ext/web-search/src/schema.rs
+codex-rs/codex-api/src/search.rs
+```
+
+The local `image_gen.imagegen` parameters are a compatibility serialization
+derived from `ImagegenArgs` and its namespace-tool construction in:
+
+```text
+codex-rs/ext/image-generation/src/lib.rs
+codex-rs/ext/image-generation/src/tool.rs
+```
+
+`codex-rs/tools/src/responses_api.rs`,
+`codex-rs/tools/src/tool_spec.rs`, and `codex-rs/core/src/client.rs` establish
+the namespace serialization and Responses Lite tool placement. The immutable
+upstream blob IDs, SHA-256 checksums, source URLs, and local canonical-JSON
+fingerprints are recorded in
+`provenance/openai-codex-eb9dceba-reserved-tools.json`.
+
+The Apache-2.0 license and upstream NOTICE above apply to the derived material.
+This source-attribution record resolves the earlier captured-metadata
+classification at the engineering level; it is not legal advice. This `1.3.0`
+source revision is approved only for a one-time manual npm bootstrap from a
+reviewed public `main` commit. It is intentionally excluded from guarded
+GitHub Actions release artifacts until the npm trusted publisher is configured
+and a separate reviewed activation changes its release track to `publishable`.

package/config.schema.json

@@ -0,0 +1,174 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/config.schema.json",
+  "title": "@oai404iao/pi-codex-minimal-tools configuration",
+  "description": "Configuration for the @oai404iao/pi-codex-minimal-tools Pi extension.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema URL used by editors for validation and completion.",
+      "default": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/config.schema.json"
+    },
+    "enabled": {
+      "type": "boolean",
+      "description": "Enable this package's tools, provider shim, compaction hooks, and commands.",
+      "default": true
+    },
+    "glyphStyle": {
+      "type": "string",
+      "description": "Glyph style used by the extension UI.",
+      "enum": ["unicode", "ascii"],
+      "default": "unicode"
+    },
+    "autoEnable": {
+      "type": "boolean",
+      "description": "Automatically activate enabled package tools on supported models.",
+      "default": true
+    },
+    "nativeProviderTools": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model hosted tool behavior to extension models.json.",
+      "deprecated": true,
+      "default": true
+    },
+    "openaiTransport": {
+      "type": "string",
+      "description": "Deprecated compatibility override. Move per-model Responses transport to extension models.json.",
+      "deprecated": true,
+      "enum": ["sse", "websocket", "websocket-cached", "auto"],
+      "default": "sse"
+    },
+    "openaiWebSocketPrewarm": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model one-shot session-startup WebSocket prewarm behavior to extension models.json.",
+      "deprecated": true,
+      "default": true
+    },
+    "fastMode": {
+      "type": "boolean",
+      "description": "Global user toggle for the Fast service tier declared by the active model profile.",
+      "default": false
+    },
+    "compactionMode": {
+      "type": "string",
+      "description": "Deprecated compatibility override. Move per-model compaction behavior to extension models.json.",
+      "deprecated": true,
+      "enum": ["pi", "responses", "responses-compact"],
+      "default": "pi"
+    },
+    "requestProfile": {
+      "type": "object",
+      "description": "Deprecated compatibility override. Move Responses mode, reasoning summary, prompt placement, patch transport, and tool capabilities to extension models.json.",
+      "deprecated": true,
+      "default": {},
+      "additionalProperties": false,
+      "properties": {
+        "responsesMode": {
+          "type": "string",
+          "description": "Responses protocol mode. Lite requires an endpoint that implements the Codex Responses Lite contract.",
+          "enum": ["standard", "lite"],
+          "default": "standard"
+        },
+        "reasoningSummary": {
+          "type": "string",
+          "description": "Deprecated compatibility override for the reasoning summary mode. Move this to responses.reasoningSummary in the per-model catalog.",
+          "enum": ["auto", "concise", "detailed", "none"],
+          "default": "auto"
+        },
+        "systemPromptPlacement": {
+          "type": "string",
+          "description": "Where Standard Responses places Pi's system prompt. Responses Lite always uses a developer message.",
+          "enum": ["instructions", "developer"],
+          "default": "instructions"
+        },
+        "patchTransport": {
+          "type": "string",
+          "description": "Transport for apply_patch: a JSON function tool or the Codex freeform custom tool.",
+          "enum": ["function", "custom"],
+          "default": "function"
+        },
+        "supportsHostedTools": {
+          "type": "boolean",
+          "description": "Enable hosted-tool activation and request rewriting. Responses Lite always disables hosted tools.",
+          "default": true
+        },
+        "supportsParallelTools": {
+          "type": "boolean",
+          "description": "Enable parallel tool calls in provider requests. Responses Lite always disables parallel tools.",
+          "default": true
+        }
+      }
+    },
+    "apiKeyMode": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move the endpoint/auth shape to responses.endpoint in extension models.json.",
+      "deprecated": true,
+      "default": false
+    },
+    "imageGeneration": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model image-generation support to extension models.json.",
+      "deprecated": true,
+      "default": true
+    },
+    "webSearchEnabled": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model web-search support to extension models.json.",
+      "deprecated": true,
+      "default": false
+    },
+    "imageOutputDir": {
+      "type": "string",
+      "description": "Directory for generated images. Relative paths resolve against the workspace root.",
+      "minLength": 1,
+      "pattern": "\\S",
+      "default": ".pi/openai-codex-images"
+    },
+    "imageModel": {
+      "type": "string",
+      "description": "Image model used by standalone generation, hosted image tool rewriting, and direct fallback.",
+      "enum": ["gpt-image-2", "gpt-image-1.5", "gpt-image-1"],
+      "default": "gpt-image-2"
+    },
+    "directImageApiFallback": {
+      "type": "boolean",
+      "description": "Allow direct OpenAI Images API generation when native Codex generation is unavailable.",
+      "default": false
+    },
+    "viewImage": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model view_image support to extension models.json.",
+      "deprecated": true,
+      "default": false
+    },
+    "viewImageWorkspaceOnly": {
+      "type": "boolean",
+      "description": "Reject view_image paths outside the active workspace.",
+      "default": false
+    },
+    "applyPatchEnabled": {
+      "type": "boolean",
+      "description": "Deprecated compatibility override. Move per-model apply_patch support to extension models.json.",
+      "deprecated": true,
+      "default": true
+    },
+    "additionalModelIds": {
+      "type": "array",
+      "description": "Deprecated compatibility allowlist. Add exact per-model entries to extension models.json instead.",
+      "deprecated": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[^\\s/]+/\\S+$"
+      },
+      "uniqueItems": true,
+      "default": []
+    },
+    "deferApplyPatchRendering": {
+      "type": "boolean",
+      "description": "Use Pi's fallback tool renderer instead of the built-in streaming filesystem preview.",
+      "default": false
+    }
+  }
+}

package/models.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/models.schema.json",
+  "title": "@oai404iao/pi-codex-minimal-tools model catalog overrides",
+  "description": "Per-model Codex protocol and tool capability profiles. User entries override bundled entries by exact provider/model id.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "models"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema URL used by editors for validation and completion.",
+      "default": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/models.schema.json"
+    },
+    "version": {
+      "const": 1,
+      "description": "Model catalog format version.",
+      "default": 1
+    },
+    "models": {
+      "type": "array",
+      "description": "Exact per-model profiles. Duplicate ids in one user file are rejected.",
+      "items": {
+        "$ref": "#/$defs/model"
+      },
+      "default": []
+    }
+  },
+  "$defs": {
+    "modelId": {
+      "type": "string",
+      "pattern": "^[^\\s/]+/\\S+$"
+    },
+    "model": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id"],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/modelId",
+          "description": "Exact provider/model id, for example openai/gpt-5.5."
+        },
+        "extends": {
+          "$ref": "#/$defs/modelId",
+          "description": "Optional parent profile. The parent is deep-merged first; arrays are replaced."
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether this profile can activate extension behavior."
+        },
+        "responses": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "providerShim": {
+              "type": "boolean",
+              "description": "Use this extension's Codex Responses serializer/parser. The Pi model must use api openai-responses or openai-codex-responses."
+            },
+            "endpoint": {
+              "enum": ["auto", "openai", "codex"],
+              "description": "Endpoint and authentication shape."
+            },
+            "mode": {
+              "enum": ["standard", "lite"],
+              "description": "Standard Responses or the internal Codex Responses Lite envelope."
+            },
+            "reasoningSummary": {
+              "enum": ["auto", "concise", "detailed", "none"],
+              "description": "Reasoning summary mode. none omits reasoning.summary; absent defaults to auto in Standard mode and none in Lite mode."
+            },
+            "systemPromptPlacement": {
+              "enum": ["instructions", "developer"],
+              "description": "Standard-mode prompt placement. Lite always uses a developer message."
+            },
+            "transport": {
+              "enum": ["sse", "websocket", "websocket-cached", "auto"],
+              "description": "Responses transport and continuation strategy."
+            },
+            "websocketPrewarm": {
+              "type": "boolean",
+              "description": "At session startup, schedule one best-effort generate:false prewarm request containing only the stable system/tool envelope."
+            }
+          }
+        },
+        "tools": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "parallelCalls": {
+              "type": "boolean",
+              "description": "Whether the request permits parallel tool calls. Lite always forces false."
+            },
+            "applyPatch": {
+              "description": "Disable apply_patch, expose a JSON function tool, or use the Codex freeform custom tool.",
+              "enum": [false, "function", "custom"],
+              "enumDescriptions": [
+                "Do not expose an apply_patch tool.",
+                "Expose apply_patch as a regular JSON function tool.",
+                "Expose apply_patch as the Codex freeform custom tool."
+              ]
+            },
+            "webSearch": {
+              "description": "Disable web search or choose hosted Responses search versus standalone Codex web.run.",
+              "if": {
+                "type": "boolean"
+              },
+              "then": {
+                "const": false
+              },
+              "else": {
+                "type": "object"
+              },
+              "defaultSnippets": [
+                {
+                  "label": "Disable web search",
+                  "description": "Do not expose web search for this model.",
+                  "body": false
+                },
+                {
+                  "label": "Hosted web search",
+                  "description": "Use the server-executed Responses web_search tool.",
+                  "body": {
+                    "implementation": "hosted"
+                  }
+                },
+                {
+                  "label": "Standalone web search",
+                  "description": "Expose web.run and call the Codex alpha/search endpoint.",
+                  "body": {
+                    "implementation": "standalone"
+                  }
+                }
+              ],
+              "additionalProperties": false,
+              "required": ["implementation"],
+              "properties": {
+                "implementation": {
+                  "enum": ["hosted", "standalone"],
+                  "enumDescriptions": [
+                    "Use the server-executed Responses web_search tool.",
+                    "Expose web.run and call the Codex alpha/search endpoint."
+                  ]
+                },
+                "contentTypes": {
+                  "type": "array",
+                  "description": "Search modalities advertised or accepted by this model.",
+                  "minItems": 1,
+                  "items": {
+                    "enum": ["text", "image"]
+                  },
+                  "uniqueItems": true
+                }
+              }
+            },
+            "imageGeneration": {
+              "description": "Disable image generation, use hosted Responses image_generation, or use standalone Codex Images endpoints.",
+              "enum": [false, "hosted", "standalone"],
+              "enumDescriptions": [
+                "Do not expose an image-generation tool.",
+                "Use the hosted Responses image_generation tool.",
+                "Expose image_gen.imagegen and call the standalone Codex Images endpoints."
+              ]
+            },
+            "viewImage": {
+              "type": "boolean",
+              "description": "Expose the local view_image tool when the Pi model accepts image input."
+            }
+          }
+        },
+        "compaction": {
+          "enum": ["pi", "responses", "responses-compact"],
+          "description": "Pi summary compaction, Codex remote compaction v2, or the legacy /responses/compact endpoint."
+        },
+        "fast": {
+          "description": "Disable Fast mode for this model or configure its service tier and optional usage-cost multiplier.",
+          "if": {
+            "type": "boolean"
+          },
+          "then": {
+            "const": false
+          },
+          "else": {
+            "type": "object"
+          },
+          "defaultSnippets": [
+            {
+              "label": "Disable Fast mode",
+              "description": "Do not enable a Fast service tier for this model.",
+              "body": false
+            },
+            {
+              "label": "Configure Fast mode",
+              "description": "Configure the Responses service tier used by the global Fast toggle.",
+              "body": {
+                "serviceTier": "priority"
+              }
+            }
+          ],
+          "additionalProperties": false,
+          "required": ["serviceTier"],
+          "properties": {
+            "serviceTier": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Responses service_tier value sent when the global Fast toggle is enabled."
+            },
+            "costMultiplier": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Optional multiplier applied to Pi's reported request cost for this tier."
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@oai404iao/pi-codex-minimal-tools",
+  "version": "1.3.0",
+  "description": "Model-profiled Codex Responses tools for Pi: WebSocket, Lite, web search, images, compaction, and apply_patch",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oai404iao/omp.git",
+    "directory": "pi-extensions/pi-codex-minimal-tools"
+  },
+  "homepage": "https://github.com/oai404iao/omp/tree/main/pi-extensions/pi-codex-minimal-tools#readme",
+  "bugs": {
+    "url": "https://github.com/oai404iao/omp/issues"
+  },
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent",
+    "codex",
+    "openai",
+    "image-generation",
+    "web-search",
+    "apply-patch"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.84.2",
+    "@earendil-works/pi-coding-agent": ">=0.84.2",
+    "@earendil-works/pi-tui": ">=0.84.2",
+    "typebox": "*"
+  },
+  "dependencies": {
+    "https-proxy-agent": "^9.1.0",
+    "socks-proxy-agent": "^10.1.0",
+    "undici": "^8.10.0",
+    "ws": "^8.21.1"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "^0.84.2",
+    "@earendil-works/pi-coding-agent": "^0.84.2",
+    "@earendil-works/pi-tui": "^0.84.2",
+    "@types/node": "^26.2.0",
+    "tsx": "^4.20.6",
+    "typebox": "^1.1.24",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsx --test tests/**/*.test.ts",
+    "check": "npm run typecheck && npm test"
+  },
+  "files": [
+    "src/",
+    "provenance/",
+    "README.md",
+    "LICENSE",
+    "LICENSES/",
+    "THIRD_PARTY_NOTICES.md",
+    "config.schema.json",
+    "models.schema.json",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
+  "gitHead": "596d799c6f7db3508b6d46bb05cdca6ea9e3b716"
+}