@oai404iao/pi-codex-imagegen 0.1.0-alpha.1 → 0.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 Alpha bootstrap candidate; initial npm publication is still pending.
 
-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.
 
 `/image-gen` jobs are cancelled when the session is replaced or closed.
 Late authentication/results cannot notify the replacement session or initiate
@@ -11,6 +11,9 @@ rolled back; cancellation is not a guarantee of avoiding provider charges.
 
 Installs `image_generation`, background image commands, image persistence and
 presentation. Depends only on `pi-codex-runtime`, not core, web-search or the bundle.
+When global `config.json.imageGeneration` is `false`, none of those generation
+surfaces are registered. The gate also blocks late/manual standalone and direct
+fallback execution before authentication or network I/O.
 Catalog-supported standalone profiles call Images generation/edit endpoints with
 Pi authentication. Hosted profiles need core unless the existing
 `directImageApiFallback` option was explicitly enabled.

package/index.ts

@@ -0,0 +1,2 @@
+export { default } from "./src/index.js";
+export * from "./src/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oai404iao/pi-codex-imagegen",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0",
   "private": false,
   "description": "Unpublished pi-codex-imagegen workspace for the staged Codex split",
   "type": "module",
@@ -24,13 +24,13 @@
   },
   "pi": {
     "extensions": [
-      "./src/index.ts"
+      "./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",
+    "@earendil-works/pi-ai": ">=0.85.1",
+    "@earendil-works/pi-coding-agent": ">=0.85.1",
+    "@earendil-works/pi-tui": ">=0.85.1",
     "typebox": "*"
   },
   "peerDependenciesMeta": {
@@ -45,7 +45,7 @@
     }
   },
   "dependencies": {
-    "@oai404iao/pi-codex-runtime": "0.1.0-alpha.1"
+    "@oai404iao/pi-codex-runtime": "0.1.0"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": "0.85.1",
@@ -66,6 +66,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "files": [
+    "index.ts",
     "src/",
     "LICENSE",
     "LICENSES/",
@@ -76,5 +77,5 @@
   "engines": {
     "node": ">=22.19.0"
   },
-  "gitHead": "32ba01f3c08b7fd63d09e9b2373cf081c4525533"
+  "gitHead": "88cb6f56447d88b71232cd764ca5b29251341d23"
 }

package/src/index.ts

@@ -11,6 +11,8 @@ import { createImageDisplay } from "./tools/image-generation/display.js";
 export default function codexImagegen(pi: ExtensionAPI): void {
 	const broker = ensureCodexServices(pi);
 	if (!broker.claim("package:imagegen")) return;
+	const settings = loadSettings();
+	if (!settings.enabled || !settings.imageGeneration) return;
 	const display = createImageDisplay(pi);
 	broker.addPresentation("image_generation", {
 		clear: display.clear,
@@ -29,5 +31,5 @@ export default function codexImagegen(pi: ExtensionAPI): void {
 			hasProviderRuntime: () => broker.coreEnabled,
 		}) as never);
 	});
-	if (loadSettings().enabled) registerBackgroundImageGenerationCommand(pi);
+	registerBackgroundImageGenerationCommand(pi);
 }

package/src/tools/image-generation.ts

@@ -51,6 +51,7 @@ async function urlToBase64(url: string, signal?: AbortSignal): Promise<string> {
 }
 
 export async function directImageGeneration(input: ImageGenerationInput, cwd: string, settings: CodexMinimalToolsSettings, signal?: AbortSignal) {
+	if (!settings.imageGeneration) throw new Error("Image generation is disabled by the global imageGeneration setting.");
 	if (!settings.directImageApiFallback) throw new Error("Direct Images API fallback is disabled. Use native openai or openai-codex handling, or enable directImageApiFallback.");
 	const apiKey = process.env.OPENAI_API_KEY;
 	if (!apiKey) throw new Error("OPENAI_API_KEY is required for direct image_generation fallback.");
@@ -174,6 +175,7 @@ export async function standaloneImageGeneration(
 	const model = ctx.model;
 	if (!model || !ctx.modelRegistry) throw new Error("No active model is available for standalone image generation.");
 	if (!settings.enabled) throw new Error("pi-codex-minimal-tools is disabled.");
+	if (!settings.imageGeneration) throw new Error("Image generation is disabled by the global setting or current model profile.");
 	if (!input.prompt?.trim()) throw new Error("A prompt is required for standalone image generation.");
 	if (input.num_last_images_to_include !== undefined && input.referenced_image_paths?.length) {
 		throw new Error("Provide only one of referenced_image_paths or num_last_images_to_include.");
@@ -264,6 +266,9 @@ export function createImageGenerationToolDefinition(options: {
 			const resolvedSettings = "modelProfile" in settings
 				? settings as ResolvedCodexModelSettings
 				: loadModelSettings(ctx.model, cwd, settings);
+			if (!resolvedSettings.imageGeneration) {
+				throw new Error("Image generation is disabled by the global setting or current model profile.");
+			}
 			if (resolvedSettings.imageGenerationImplementation === "standalone") {
 				const sessionId = ctx.sessionManager?.getSessionId?.();
 				return standaloneImageGeneration(params, ctx, resolvedSettings, signal, {