Image Context Runtime v0.2.0

Image Context Runtime v0.2.0

v0.2.0 lets multiple Codex tasks using the same fixed configuration share one authenticated loopback Broker and one durable Runtime worker. It keeps Provider concurrency, idempotency, output reservations, and restart reconciliation under a single owner instead of treating another task's live Job as interrupted.

Highlights

• authenticated IPv4-loopback Broker with bounded unauthenticated time, per-client in-flight work, response buffering, and stdio backpressure
• race-safe concurrent Broker autostart and owner-checked descriptor cleanup
• conservative shutdown recovery: a forced interruption after Provider dispatch becomes needs_review and is never automatically repeated
• cursor-based bounded Job history
• dry-run-first terminal Job compaction with retired idempotency tombstones
• conservative server/discover response without claiming full MCP 2026-07-28 conformance
• updated doctor, architecture, security, privacy, troubleshooting, claims, and validation documentation

Install

git clone --depth 1 --branch v0.2.0 https://github.com/shixinnt/codex-image-context-runtime.git
cd codex-image-context-runtime
codex plugin marketplace add .
codex plugin add codex-image-context-runtime@codex-image-context-runtime
npm run configure -- --workspace "C:\path\to\your\project" --provider mock

Upgrade from v0.1.1

Stop active image jobs, update the clone, then refresh the plugin cache:

git fetch --tags
git checkout v0.2.0
codex plugin remove codex-image-context-runtime@codex-image-context-runtime
codex plugin add codex-image-context-runtime@codex-image-context-runtime

External configuration and Runtime data are preserved by reinstalling the plugin. Restart Codex after the update.

Validation and boundaries

The offline release gates passed on Windows, Ubuntu, and macOS with Node.js 22, plus Ubuntu with Node.js 24. Isolated fresh-install and v0.1.1-to-v0.2.0 upgrade checks passed. See docs/validation-v0.2.0.md for the receipt.

The Broker is same-user local coordination, not a sandbox against another process running as the same operating-system user. Automated retention policy, secure erasure, full MCP 2026-07-28 conformance, and Tasks interoperability are not claimed in v0.2.0. No live Provider calls were used for release validation.

v0.1.1 - Diagnostics and cross-platform validation

v0.1.1

This maintenance release makes the experimental public baseline easier to install, diagnose, and support without weakening its bounded MCP boundary.

Highlights

• Adds a privacy-safe npm run doctor command that reports configuration and lock state without printing paths, credentials, prompts, or media.
• Accepts explicit relative workspace paths in the configuration helper.
• Adds privacy, terms, support, troubleshooting, code-of-conduct, Issue, and pull-request guidance.
• Adds richer Codex plugin metadata and the project branding introduced after v0.1.0.
• Expands offline CI to Node.js 22 on Windows, Ubuntu, and macOS, plus Node.js 24 on Ubuntu.

Install

git clone --depth 1 --branch v0.1.1 https://github.com/shixinnt/codex-image-context-runtime.git
cd codex-image-context-runtime
codex plugin marketplace add .
codex plugin add codex-image-context-runtime@codex-image-context-runtime
npm run configure -- --workspace "path-to-your-project" --provider mock
npm run doctor

Verification

• Plugin tests: 34 / 34 passed.
• Repository tests: 18 / 18 passed.
• Synthetic payload proxy and privacy gates: PASS.
• Official plugin and skill validators: PASS.
• Tag CI: Windows, Ubuntu, and macOS on Node.js 22 plus Ubuntu on Node.js 24: PASS.
• Attached archive was built from the signed-off tag tree, privacy-scanned after extraction, and is accompanied by a SHA-256 checksum.

See the validation receipt and changelog.

Boundary

This plugin does not patch Codex native image tools, repair an already-damaged task, guarantee that Codex never slows down, or keep data local when the optional remote OpenAI provider is enabled. Its bounded behavior applies when Codex uses the plugin MCP tools and bundled skill.

v0.1.0 - Image Context Runtime for Codex

Image-only public baseline

• Codex plugin with a bundled local stdio MCP server and durable image-job runtime.
• Text-to-image and image-inspection jobs with bounded text-only MCP results, relative refs, hashes, handoffs, and Job IDs.
• Idempotent submission, restart reconciliation, conservative ambiguous-dispatch recovery, output reservations, and one active worker per Runtime directory.
• Offline deterministic mock Provider by default; optional official OpenAI API Provider.
• Apache-2.0 license, public privacy gates, secret scanning, and Windows/Linux Node.js 22 CI.

Validation

• Plugin runtime and hardening tests: 31/31.
• Repository, benchmark, packaging, and privacy tests: 15/15.
• Fresh public clone, local marketplace install, mock configuration, plugin validator, and skill validator: pass.
• Synthetic 20 × 1 MiB serialized MCP-result proxy: 99.903323% fewer bytes for reference-only results than naive inline-image results.

The synthetic result is not a Codex token, latency, memory, responsiveness, or native-image benchmark.

Install

Clone the repository, then from its root:

codex plugin marketplace add .
codex plugin add codex-image-context-runtime@codex-image-context-runtime
node plugins/codex-image-context-runtime/scripts/configure.mjs --workspace "C:\path\to\your\project" --provider mock

Important boundaries

v0.1 is image-only. It does not patch or intercept Codex built-in image features. The bounded boundary applies only when Codex uses this plugin's MCP tools. Use distinct Runtime directories for simultaneous Codex tasks.