@oai404iao/pi-codex-runtime 0.1.0-alpha.1 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ Alpha bootstrap candidate; initial npm publication is still pending.
 It has no Pi extension entry
 and does not automatically register tools or providers.
 
-Peer floor: Pi 0.84.2; tested against 0.84.2 and 0.85.1.
+Peer floor: Pi 0.85.1; tested against 0.85.1.
 
 Owns shared Codex authentication/headers, wire identity, settings/catalog,
 Responses replay contracts and the session-scoped composition broker.
@@ -12,7 +12,12 @@ Capability-specific HTTP clients, storage and transports live in other packages.
 
 Configuration paths remain
 `<agentDir>/extensions/pi-codex-minimal-tools/{config,models}.json`.
-This package ships the canonical schemas and default catalog.
+This package ships the canonical schemas and default catalog, including the
+`openai-codex/gpt-6-astra` Responses Lite profile. The global
+`config.json.imageGeneration:false` setting gates image capability derivation
+without replacing the selected model profile. Likewise,
+`config.json.webSocketEnabled:false` forces SSE and disables WebSocket prewarm
+without changing that profile.
 `./subagent-inline` supplies the existing SDK identity integration.
 `./internal/*` is implementation wiring, not a stable public API.
 

package/THIRD_PARTY_NOTICES.md

@@ -11,6 +11,13 @@ apply-patch compatibility evidence remains pinned to
 The unmodified provenance record preserves upstream source identifiers, not
 claims that every referenced source file is shipped in this package.
 
+The bundled `openai-codex/gpt-6-astra` profile is derived from Codex model and
+request metadata at
+`ddea03ad049142943bdbf13e937b1d67e8c1ba0c`, cross-checked against the
+MIT-licensed `@earendil-works/pi-ai@0.85.1` catalog. Exact source and tarball
+identifiers are recorded in
+`provenance/openai-codex-ddea03ad-astra.json`.
+
 Modified namespace-tool compatibility serialization is in
 `src/codex-reserved-tools.ts` and the capability-specific `src/reserved-tools/`
 assets. This is not a license or authorization to access

package/config.schema.json

@@ -27,23 +27,9 @@
       "description": "Automatically activate enabled package tools on supported models.",
       "default": true
     },
-    "nativeProviderTools": {
+    "webSocketEnabled": {
       "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,
+      "description": "Global Responses WebSocket master switch. false forces SSE and disables WebSocket prewarm for every model profile.",
       "default": true
     },
     "fastMode": {
@@ -51,74 +37,11 @@
       "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,
+      "description": "Global image-generation master switch. false disables image tools, commands, presentation, hosted injection, standalone endpoints, and direct fallback without changing other model-profile behavior.",
       "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.",
@@ -137,34 +60,11 @@
       "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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oai404iao/pi-codex-runtime",
-  "version": "0.1.0-alpha.1",
+  "version": "0.2.0",
   "private": false,
   "description": "Unpublished pi-codex-runtime workspace for the staged Codex split",
   "type": "module",
@@ -23,8 +23,8 @@
     "./subagent-inline": "./src/subagent-inline.ts"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": ">=0.84.2",
-    "@earendil-works/pi-coding-agent": ">=0.84.2"
+    "@earendil-works/pi-ai": ">=0.85.1",
+    "@earendil-works/pi-coding-agent": ">=0.85.1"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-ai": {
@@ -64,5 +64,5 @@
   "engines": {
     "node": ">=22.19.0"
   },
-  "gitHead": "32ba01f3c08b7fd63d09e9b2373cf081c4525533"
+  "gitHead": "61f1d82471fff63e3e9d5c0276b5e069c9fc8f1f"
 }

package/provenance/openai-codex-ddea03ad-astra.json

@@ -0,0 +1,54 @@
+{
+  "schemaVersion": 1,
+  "upstream": {
+    "repository": "https://github.com/openai/codex",
+    "revision": "ddea03ad049142943bdbf13e937b1d67e8c1ba0c",
+    "commitUrl": "https://github.com/openai/codex/commit/ddea03ad049142943bdbf13e937b1d67e8c1ba0c",
+    "license": "Apache-2.0"
+  },
+  "files": {
+    "LICENSE": {
+      "role": "upstream Apache-2.0 license",
+      "gitBlobSha": "4606e72e042564097e8780d66c1d4dcb611869bd",
+      "sha256": "d17f227e4df5da1600391338865ce0f3055211760a36688f816941d58232d8dc",
+      "rawUrl": "https://raw.githubusercontent.com/openai/codex/ddea03ad049142943bdbf13e937b1d67e8c1ba0c/LICENSE"
+    },
+    "NOTICE": {
+      "role": "upstream NOTICE",
+      "gitBlobSha": "2805899d56d0332d175cfc613c67d45d6f006db7",
+      "sha256": "9d71575ecfd9a843fc1677b0efb08053c6ba9fd686a0de1a6f5382fd3c220915",
+      "rawUrl": "https://raw.githubusercontent.com/openai/codex/ddea03ad049142943bdbf13e937b1d67e8c1ba0c/NOTICE"
+    },
+    "codex-rs/models-manager/models.json": {
+      "role": "GPT-6 Astra capabilities and defaults",
+      "gitBlobSha": "1b5ce2c515986f84147abe5f4fb6e9b0deab0470",
+      "sha256": "897614e513a591b362f76c34e4b4d31af5809a2b52f8c0ab57f2990c5bf4ab3d",
+      "rawUrl": "https://raw.githubusercontent.com/openai/codex/ddea03ad049142943bdbf13e937b1d67e8c1ba0c/codex-rs/models-manager/models.json"
+    },
+    "codex-rs/models-manager/src/model_info.rs": {
+      "role": "model metadata representation and context-window limits",
+      "gitBlobSha": "ca1006993137d66de19137ff136f7ac8d36f9da3",
+      "sha256": "919883a4a15f6f3cace2ec78388aa7f9f8e042f74f553877843552ed55bf15bf",
+      "rawUrl": "https://raw.githubusercontent.com/openai/codex/ddea03ad049142943bdbf13e937b1d67e8c1ba0c/codex-rs/models-manager/src/model_info.rs"
+    },
+    "codex-rs/core/src/client.rs": {
+      "role": "Responses Lite and WebSocket request behavior",
+      "gitBlobSha": "8d2db30d7bb942cd030cb8d511eaafba8cbe46dd",
+      "sha256": "6a9b3d5d60293ca694e1642c905b574c2c12da490cff1c165e485f35a81f6edb",
+      "rawUrl": "https://raw.githubusercontent.com/openai/codex/ddea03ad049142943bdbf13e937b1d67e8c1ba0c/codex-rs/core/src/client.rs"
+    }
+  },
+  "catalogReference": {
+    "package": "@earendil-works/pi-ai",
+    "version": "0.85.1",
+    "license": "MIT",
+    "repository": "https://github.com/earendil-works/pi",
+    "tarballIntegrity": "sha512-+VgVIJDkDO2efYJKEEqvPTH4zmnIaXdAppGbO+vKFA9qy5PdhFiAenuFAkU+oiCSfOC4dMHDyrjdQeL4ZoC5CQ==",
+    "path": "dist/providers/data/openai-codex.json",
+    "sha256": "a10bfcfd34db6bcb98d8ee46175e154cab30530a137dbf31ac1434020ed3ffdd"
+  },
+  "localImplementations": [
+    "pi-codex-runtime/src/model-catalog/default-models.json",
+    "pi-codex-minimal-tools/src/model-catalog/default-models.json"
+  ]
+}

package/src/capabilities.ts

@@ -66,7 +66,9 @@ export function computeToolCapabilities(model: ModelLike | undefined, settings:
 	const providerShimActive = modelSettings.providerShimActive;
 
 	return {
-		image_generation: imageGeneration === "hosted" && providerShimActive && imageInput
+		image_generation: !settings.imageGeneration
+			? { enabled: false, reason: "image generation disabled by global setting" }
+			: imageGeneration === "hosted" && providerShimActive && imageInput
 			? { enabled: true, reason: "model profile enables hosted image_generation" }
 			: imageGeneration === "standalone" && imageInput
 				? { enabled: true, reason: "model profile enables standalone image generation" }

package/src/model-catalog/catalog.ts

@@ -490,7 +490,6 @@ function legacySettingsRecord(settings: CodexMinimalToolsSettings): JsonRecord {
 		"compactionMode",
 		"requestProfile",
 		"apiKeyMode",
-		"imageGeneration",
 		"webSearchEnabled",
 		"viewImage",
 		"applyPatchEnabled",
@@ -523,7 +522,6 @@ function legacyProfilePatch(
 		"compactionMode",
 		"requestProfile",
 		"apiKeyMode",
-		"imageGeneration",
 		"webSearchEnabled",
 		"viewImage",
 		"applyPatchEnabled",
@@ -569,9 +567,6 @@ function legacyProfilePatch(
 			webSearch: settings.webSearchEnabled && hostedTools && oldExtendedToolModel
 				? { implementation: "hosted", contentTypes: [...contentTypes] }
 				: false,
-			imageGeneration: settings.imageGeneration && hostedTools
-				? "hosted"
-				: false,
 			viewImage: settings.viewImage,
 		},
 		compaction: settings.compactionMode,

package/src/model-catalog/default-models.json

@@ -150,6 +150,14 @@
         "endpoint": "codex"
       }
     },
+    {
+      "id": "openai-codex/gpt-6-astra",
+      "extends": "openai/gpt-5.6-sol",
+      "responses": {
+        "endpoint": "codex",
+        "reasoningSummary": "none"
+      }
+    },
     {
       "id": "openai-codex/gpt-5.6-terra",
       "extends": "openai/gpt-5.6-terra",

package/src/model-catalog/runtime.ts

@@ -70,7 +70,9 @@ export function loadModelSettings(
 	const configuredWebSearchImplementation = effective.tools.webSearch
 		? effective.tools.webSearch.implementation
 		: undefined;
-	const configuredImageGenerationImplementation = effective.tools.imageGeneration || undefined;
+	const configuredImageGenerationImplementation = baseSettings.imageGeneration
+		? effective.tools.imageGeneration || undefined
+		: undefined;
 	const webSearchImplementation = !packageEnabled
 		|| (configuredWebSearchImplementation === "hosted" && !providerShimActive)
 		? undefined
@@ -94,8 +96,12 @@ export function loadModelSettings(
 		...baseSettings,
 		providerShimActive,
 		nativeProviderTools: providerShimActive && usesProviderToolRewrite,
-		openaiTransport: effective.responses.transport,
-		openaiWebSocketPrewarm: effective.responses.websocketPrewarm,
+		openaiTransport: baseSettings.webSocketEnabled
+			? effective.responses.transport
+			: "sse",
+		openaiWebSocketPrewarm:
+			baseSettings.webSocketEnabled
+			&& effective.responses.websocketPrewarm,
 		compactionMode: providerShimActive ? effective.compaction : "pi",
 		requestProfile,
 		apiKeyMode: endpointUsesApiKey(effective.responses.endpoint, model),

package/src/settings.ts

@@ -6,50 +6,59 @@ import type { CodexRequestProfileOverride } from "./codex-request-profile.js";
 export const PACKAGE_NAME = "pi-codex-minimal-tools";
 export const CONFIG_FILE_NAME = "config.json";
 
-export interface CodexMinimalToolsSettings {
+export interface CodexGlobalSettings {
 	enabled: boolean;
 	glyphStyle: "unicode" | "ascii";
 	autoEnable: boolean;
+	webSocketEnabled: boolean;
+	fastMode: boolean;
+	imageGeneration: boolean;
+	imageOutputDir: string;
+	imageModel: "gpt-image-2" | "gpt-image-1.5" | "gpt-image-1";
+	directImageApiFallback: boolean;
+	viewImageWorkspaceOnly: boolean;
+	deferApplyPatchRendering: boolean;
+}
+
+export interface CodexMinimalToolsSettings extends CodexGlobalSettings {
 	nativeProviderTools: boolean;
 	openaiTransport: "sse" | "websocket" | "websocket-cached" | "auto";
 	openaiWebSocketPrewarm: boolean;
-	fastMode: boolean;
 	compactionMode: "pi" | "responses" | "responses-compact";
 	requestProfile: CodexRequestProfileOverride;
 	apiKeyMode: boolean;
-	imageGeneration: boolean;
 	webSearchEnabled: boolean;
-	imageOutputDir: string;
-	imageModel: "gpt-image-2" | "gpt-image-1.5" | "gpt-image-1";
-	directImageApiFallback: boolean;
 	viewImage: boolean;
-	viewImageWorkspaceOnly: boolean;
 	applyPatchEnabled: boolean;
 	additionalModelIds: string[];
-	deferApplyPatchRendering: boolean;
 }
 
-export const DEFAULT_SETTINGS: CodexMinimalToolsSettings = {
+export const DEFAULT_GLOBAL_SETTINGS: Readonly<CodexGlobalSettings> = {
 	enabled: true,
 	glyphStyle: "unicode",
 	autoEnable: true,
+	webSocketEnabled: true,
+	fastMode: false,
+	imageGeneration: true,
+	imageOutputDir: ".pi/openai-codex-images",
+	imageModel: "gpt-image-2",
+	directImageApiFallback: false,
+	viewImageWorkspaceOnly: false,
+	deferApplyPatchRendering: false,
+};
+
+export const DEFAULT_SETTINGS: CodexMinimalToolsSettings = {
+	...DEFAULT_GLOBAL_SETTINGS,
 	nativeProviderTools: true,
 	openaiTransport: "sse",
 	openaiWebSocketPrewarm: true,
-	fastMode: false,
 	compactionMode: "pi",
 	requestProfile: {},
 	apiKeyMode: false,
-	imageGeneration: true,
 	webSearchEnabled: false,
-	imageOutputDir: ".pi/openai-codex-images",
-	imageModel: "gpt-image-2",
-	directImageApiFallback: false,
 	viewImage: false,
-	viewImageWorkspaceOnly: false,
 	applyPatchEnabled: true,
 	additionalModelIds: [],
-	deferApplyPatchRendering: false,
 };
 
 type SettingsRecord = Record<string, unknown>;
@@ -188,6 +197,7 @@ export function loadSettings(_cwd?: string): CodexMinimalToolsSettings {
 		enabled: boolSetting(raw, "enabled"),
 		glyphStyle: glyphStyleSetting(raw),
 		autoEnable: boolSetting(raw, "autoEnable"),
+		webSocketEnabled: boolSetting(raw, "webSocketEnabled"),
 		nativeProviderTools: boolSetting(raw, "nativeProviderTools"),
 		openaiTransport: openaiTransportSetting(raw),
 		openaiWebSocketPrewarm: boolSetting(raw, "openaiWebSocketPrewarm"),