@oai404iao/pi-codex-minimal-tools 1.3.0

package/LICENSE

@@ -0,0 +1,28 @@
+Licensing for pi-codex-minimal-tools
+
+Except for the third-party materials identified in THIRD_PARTY_NOTICES.md,
+the project-authored portions of this package are available under the
+following MIT License:
+
+Copyright (c) 2026 oai404iao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Third-party materials remain under their respective terms. See
+THIRD_PARTY_NOTICES.md and the license texts under LICENSES/.

package/LICENSES/Apache-2.0.txt

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright 2025 OpenAI
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/LICENSES/OpenAI-Codex-NOTICE.txt

@@ -0,0 +1,6 @@
+OpenAI Codex
+Copyright 2025 OpenAI
+
+This project includes code derived from [Ratatui](https://github.com/ratatui/ratatui), licensed under the MIT license.
+Copyright (c) 2016-2022 Florian Dehau
+Copyright (c) 2023-2025 The Ratatui Developers

package/README.md

@@ -0,0 +1,410 @@
+# @oai404iao/pi-codex-minimal-tools
+
+Codex-specific Responses support for Pi, driven by an exact per-model JSON
+catalog instead of model-name heuristics.
+
+Compatibility: Pi 0.84.2 or newer; tested against 0.84.2.
+
+> npm identity: `@oai404iao/pi-codex-minimal-tools`. Version `1.3.0` is
+> prepared for a one-time manually authenticated npm bootstrap from a reviewed
+> public `main` commit.
+
+> **Compatibility boundary:** Responses Lite uses an internal Codex request
+> shape. This package pins and tests a compatibility serialization for exact
+> configured model profiles, but it is not an OpenAI-supported public API
+> contract and may stop working if that internal protocol changes.
+
+The extension adds:
+
+- Responses SSE, WebSocket, cached continuation, WebSocket retry, upgrade-only
+  SSE fallback, and WebSocket prewarm.
+- Standard Responses and the internal Codex Responses Lite envelope.
+- Codex freeform `apply_patch`, including streaming preview and exact replay.
+- Hosted Responses web search or standalone Codex `web.run`.
+- Hosted Responses image generation or standalone Codex `image_gen.imagegen`.
+- Codex remote compaction v2 and legacy `/responses/compact`.
+- Per-model Fast service tiers.
+- User overrides and user-added provider/model profiles.
+
+Unknown models are not guessed. They keep Pi's native provider implementation
+and do not receive package tools.
+
+## Install
+
+After `1.3.0` is available on npm:
+
+```bash
+pi install npm:@oai404iao/pi-codex-minimal-tools@1.3.0
+```
+
+Before the initial bootstrap, or when testing unreleased source:
+
+```bash
+pi install /absolute/path/to/pi-codex-minimal-tools
+```
+
+Restart Pi or run `/reload`.
+
+## Commands
+
+| Command | Action |
+| --- | --- |
+| `/codex-minimal-tools` | Show the active model profile and effective capabilities. |
+| `/codex-minimal-tools:doctor` | Show config/catalog diagnostics. |
+| `/fast [on\|off\|status]` | Toggle the active profile's Fast service tier. |
+| `/image-gen <prompt> [@reference.png]` | Run background image generation or editing. |
+
+## Two Configuration Files
+
+There are two separate model-related files:
+
+1. Pi's agent `models.json` defines providers and actual models: API type,
+   base URL, authentication, headers, modalities, context window, and cost.
+2. This extension's `models.json` defines Codex behavior for an exact
+   `provider/model` ID: Responses mode, reasoning summary, transport, tools,
+   compaction, and Fast.
+
+Typical paths:
+
+```text
+<PI_CODING_AGENT_DIR>/models.json
+<PI_CODING_AGENT_DIR>/extensions/pi-codex-minimal-tools/models.json
+<PI_CODING_AGENT_DIR>/extensions/pi-codex-minimal-tools/config.json
+```
+
+Without `PI_CODING_AGENT_DIR`, Pi normally uses `~/.config/pi/agent` or
+`~/.pi/agent`, depending on the installation.
+
+### Extension Global Config
+
+`config.json` now contains only package-wide preferences:
+
+```json
+{
+  "$schema": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/config.schema.json",
+  "enabled": true,
+  "glyphStyle": "unicode",
+  "autoEnable": true,
+  "fastMode": false,
+  "imageOutputDir": ".pi/openai-codex-images",
+  "imageModel": "gpt-image-2",
+  "directImageApiFallback": false,
+  "viewImageWorkspaceOnly": false,
+  "deferApplyPatchRendering": false
+}
+```
+
+| Setting | Meaning |
+| --- | --- |
+| `enabled` | Enable all package behavior. |
+| `glyphStyle` | Use `unicode` or `ascii` UI glyphs. |
+| `autoEnable` | Add supported package tools automatically. |
+| `fastMode` | Global user toggle; only profiles with `fast` are affected. |
+| `imageOutputDir` | Generated-image output directory. Relative paths resolve from the workspace root. |
+| `imageModel` | Image model used by standalone/hosted image requests and direct fallback. |
+| `directImageApiFallback` | Permit the separate `OPENAI_API_KEY` Images API fallback. |
+| `viewImageWorkspaceOnly` | Restrict `view_image` to the workspace. |
+| `deferApplyPatchRendering` | Use Pi's fallback renderer instead of the streaming patch preview. |
+
+The older model-level keys remain readable for one migration version, but are
+deprecated. See [Legacy migration](#legacy-migration).
+
+### Per-Model Catalog
+
+Create:
+
+```text
+<PI_CODING_AGENT_DIR>/extensions/pi-codex-minimal-tools/models.json
+```
+
+Example overriding a bundled model and adding a custom provider/model:
+
+```json
+{
+  "$schema": "https://unpkg.com/@oai404iao/pi-codex-minimal-tools@1/models.schema.json",
+  "version": 1,
+  "models": [
+    {
+      "id": "openai/gpt-5.5",
+      "responses": {
+        "reasoningSummary": "none",
+        "transport": "sse",
+        "websocketPrewarm": false
+      },
+      "tools": {
+        "webSearch": false
+      }
+    },
+    {
+      "id": "my-provider/my-codex-model",
+      "extends": "openai/gpt-5.5",
+      "responses": {
+        "endpoint": "openai",
+        "transport": "websocket-cached"
+      },
+      "tools": {
+        "imageGeneration": false
+      }
+    }
+  ]
+}
+```
+
+Resolution rules:
+
+- IDs are exact, case-insensitive `provider/model` matches.
+- A user entry with the same ID deep-overrides the bundled entry.
+- `extends` can inherit from a bundled or user profile.
+- Objects merge recursively; arrays replace the inherited array.
+- Duplicate IDs, malformed JSON, missing parents, cycles, and unknown fields
+  are reported by `/codex-minimal-tools:doctor`.
+- Each effective profile has a stable hash. WebSocket continuation, sticky
+  fallback, and native-compaction replay are isolated by that hash.
+
+Full field documentation is in
+[`reference/model-catalog.md`](https://github.com/oai404iao/omp/blob/main/pi-extensions/pi-codex-minimal-tools/reference/model-catalog.md), and editor
+validation is provided by [`models.schema.json`](models.schema.json).
+
+## Custom Provider Example
+
+The custom model must exist in Pi's agent `models.json`. For provider-shim
+features, its Pi `api` must be `openai-responses` or
+`openai-codex-responses`:
+
+```json
+{
+  "providers": {
+    "my-provider": {
+      "baseUrl": "https://api.example.com/v1",
+      "apiKey": "$MY_PROVIDER_API_KEY",
+      "api": "openai-responses",
+      "models": [
+        {
+          "id": "my-codex-model",
+          "name": "My Codex Model",
+          "reasoning": true,
+          "input": ["text", "image"],
+          "contextWindow": 272000,
+          "maxTokens": 16384,
+          "cost": {
+            "input": 0,
+            "output": 0,
+            "cacheRead": 0,
+            "cacheWrite": 0
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+The extension dynamically attaches only its stream handler to a selected
+custom provider. It does not replace the provider's URL, authentication,
+headers, or model definitions.
+
+If a profile requests the provider shim but the Pi model uses another API
+type, wire-only features are disabled:
+
+- hosted web/image tools;
+- custom/freeform `apply_patch`;
+- native Responses compaction;
+- Fast service tiers.
+
+Standalone web/image tools and function `apply_patch` can still be used when
+the profile enables them.
+
+## Model Profile Fields
+
+```json
+{
+  "id": "provider/model",
+  "extends": "provider/parent-model",
+  "enabled": true,
+  "responses": {
+    "providerShim": true,
+    "endpoint": "auto",
+    "mode": "standard",
+    "reasoningSummary": "auto",
+    "systemPromptPlacement": "instructions",
+    "transport": "auto",
+    "websocketPrewarm": true
+  },
+  "tools": {
+    "parallelCalls": true,
+    "applyPatch": "custom",
+    "webSearch": {
+      "implementation": "hosted",
+      "contentTypes": ["text", "image"]
+    },
+    "imageGeneration": "standalone",
+    "viewImage": false
+  },
+  "compaction": "responses",
+  "fast": {
+    "serviceTier": "priority",
+    "costMultiplier": 2
+  }
+}
+```
+
+Important constraints:
+
+- `responses.reasoningSummary` accepts `"auto"`, `"concise"`, `"detailed"`,
+  or `"none"`. `"none"` omits `reasoning.summary`; when absent, Standard
+  defaults to `"auto"` and Lite defaults to `"none"`.
+- `responses.mode:"lite"` always uses a developer message, namespace tools in
+  `additional_tools`, `parallel_tool_calls:false`,
+  `reasoning.context:"all_turns"`, and strips input-image `detail`.
+- Lite cannot use hosted `web_search` or hosted `image_generation`; choose
+  `standalone` instead.
+- `tools.applyPatch:"custom"` uses the Codex freeform grammar and requires the
+  provider shim. `"function"` works as a normal Pi tool.
+- `responses.endpoint:"openai"` uses API-key endpoint/auth semantics.
+  `"codex"` uses ChatGPT/Codex endpoint/auth semantics. `"auto"` infers from
+  the provider.
+- `compaction:"responses"` uses `compaction_trigger` through the selected
+  SSE/WebSocket transport. `"responses-compact"` uses the legacy unary
+  endpoint. `"pi"` keeps Pi summaries.
+
+## Built-In Profiles
+
+The bundled catalog is based on local Codex commit
+`eb9dceba1a2e658142a456c5898836774835616b` from August 12, 2026.
+
+| Models | Responses | Web | Image | Patch | Compaction |
+| --- | --- | --- | --- | --- | --- |
+| `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna` | Lite, auto WS/SSE | standalone text+image | standalone | custom | responses |
+| `gpt-5.5`, `gpt-5.4` | Standard, auto WS/SSE | hosted text+image | standalone | custom | responses |
+| `gpt-5.4-mini`, `codex-auto-review` | Standard, auto WS/SSE | hosted text+image | standalone | custom | responses |
+| `gpt-5.2` | Standard, auto WS/SSE | hosted text | standalone | custom | responses |
+| legacy GPT-5/Codex entries | inherited Standard profile | profile-specific | standalone | custom | responses |
+| `gpt-4.1` | Standard SSE | off | hosted | off | Pi |
+| `o4-mini` | Standard SSE | off | off | off | Pi |
+
+Equivalent `openai/...` and `openai-codex/...` IDs are included; the latter
+switch only the endpoint/auth shape to `codex`.
+
+These entries are defaults, not claims that every proxy with the same model
+slug supports the protocol. Override or disable a profile for the endpoint
+actually in use.
+
+## Web Search
+
+`tools.webSearch` supports two implementations:
+
+- `hosted`: rewrites the Pi placeholder to Responses
+  `{"type":"web_search"}` and preserves progress, sources, results, and
+  citation replay. Standard Responses only.
+- `standalone`: exposes `web.run` as a client-executed namespace tool and calls
+  the provider's `alpha/search` endpoint. It supports search/image queries,
+  open/click/find, PDF screenshots, finance, weather, sports, and time.
+
+Standalone search sends a bounded recent visible conversation tail, resolved
+Pi authentication, direct-caller/live-web settings, the active turn metadata,
+and the model's 10,000-token truncation budget. Search rows stay compact by
+default and show deduplicated source hosts; expand the tool row to inspect the
+raw result text.
+
+## Image Generation
+
+`tools.imageGeneration` supports:
+
+- `hosted`: Responses `image_generation`.
+- `standalone`: `image_gen.imagegen`, backed by the provider's
+  `images/generations` and `images/edits` endpoints.
+
+Standalone input follows current Codex:
+
+- required `prompt`;
+- up to five `referenced_image_paths`; or
+- `num_last_images_to_include` from 1 through 5.
+
+Generated PNGs are saved under `imageOutputDir`, mirrored to `latest.png`, and
+returned to the model before the saved-path text. `/image-gen` selects any
+loaded image-capable model with an enabled catalog profile.
+
+## WebSocket And Compaction
+
+`transport` values:
+
+- `sse`: HTTP streaming only.
+- `websocket`: reusable WebSocket; exact logical prefixes opportunistically use
+  `previous_response_id` input deltas.
+- `websocket-cached`: compatibility alias with the same safe continuation
+  behavior.
+- `auto`: retry transient WebSocket failures, but use sticky per-session SSE
+  fallback only when the WebSocket upgrade is rejected with HTTP 426. Model,
+  request, output-limit, context-limit, and post-upgrade connection errors do
+  not change transports.
+
+Prewarm is scheduled once per session startup (including resume/fork), in the
+background without delaying session initialization. If the first WebSocket
+request starts while prewarm is pending, it consumes that one startup handle
+before sending. Prewarm sends a best-effort `response.create` with
+`generate:false` containing only the startup system/tool/request
+envelope—never conversation history or the pending user message. The first real
+request appends its full conversation input, and later turns continue from real
+response IDs. A failed or timed-out prewarm is not retried on every user
+message. Continuation reuse always requires the new request to extend the
+previous logical request exactly.
+
+Native compaction stores opaque encrypted state in the Pi session. New
+checkpoints replay only to the same provider, model, API, and effective
+profile hash. Switching any of those falls back to Pi's retained local
+context. Treat session files containing native compaction as sensitive data.
+
+## Apply Patch
+
+When `apply_patch` activates, the extension temporarily hides Pi's `edit` and
+`write` tools and restores their prior positions after switching away.
+
+The executor supports Codex `@@ class/function` contexts, ordered update
+chunks, `*** Move to:`, `*** End of File`, fuzzy matching, CRLF preservation,
+and atomic verification before writes. See
+[`reference/apply-patch-behavior.md`](https://github.com/oai404iao/omp/blob/main/pi-extensions/pi-codex-minimal-tools/reference/apply-patch-behavior.md).
+
+## Legacy Migration
+
+These `config.json` keys are deprecated but still projected into an in-memory
+model override for compatibility:
+
+| Old key | New model-profile field |
+| --- | --- |
+| `nativeProviderTools` | `responses.providerShim` plus hosted/standalone tool selection |
+| `openaiTransport` | `responses.transport` |
+| `openaiWebSocketPrewarm` | `responses.websocketPrewarm` |
+| `compactionMode` | `compaction` |
+| `requestProfile.responsesMode` | `responses.mode` |
+| `requestProfile.reasoningSummary` | `responses.reasoningSummary` |
+| `requestProfile.systemPromptPlacement` | `responses.systemPromptPlacement` |
+| `requestProfile.patchTransport` | `tools.applyPatch` |
+| `apiKeyMode` | `responses.endpoint` |
+| `imageGeneration` | `tools.imageGeneration` |
+| `webSearchEnabled` | `tools.webSearch` |
+| `viewImage` | `tools.viewImage` |
+| `applyPatchEnabled` | `tools.applyPatch` |
+| `additionalModelIds` | one exact user catalog entry per model |
+
+Move these values to extension `models.json`; legacy projection is intended
+only as a transition path.
+
+## Protocol Reference
+
+[`reference/`](https://github.com/oai404iao/omp/tree/main/pi-extensions/pi-codex-minimal-tools/reference) documents the Codex snapshot, Responses
+Standard/Lite envelopes, namespace tools, WebSocket continuation, custom-tool
+streaming/replay, standalone web/image endpoints, compaction, and apply-patch
+protocol.
+
+## License and publication status
+
+Project-authored portions are MIT-licensed, copyright 2026 oai404iao.
+Third-party material retains its own terms; see
+[LICENSE](LICENSE) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+The Codex namespace-tool source attribution is recorded in
+`provenance/openai-codex-eb9dceba-reserved-tools.json`. The `1.3.0` source
+revision is intentionally staged for its one-time manual npm bootstrap and
+excluded from guarded GitHub Actions release artifacts until trusted publishing
+is configured. Responses Lite remains an internal Codex compatibility path,
+not an OpenAI-supported public API contract.