Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
feat: add Codex subscription image provider
alextavares651cb5eff548
diff --git a/apps/daemon/src/api/server.ts b/apps/daemon/src/api/server.tsindex 1290dbc7..1df75a6d 100644--- a/apps/daemon/src/api/server.ts+++ b/apps/daemon/src/api/server.ts@@ -634,6 +634,7 @@ export async function buildServer(input: BuildServerInput) {creatorExecutors.push(createStickmanImageExecutor({configStore: creatorServicesConfigStore,ledger: creatorProviderRequestLedger,+ codexNative: { codexBin, codexHome, cwd: defaultCwd },...(creatorTesseractPath === undefined ? {} : { tesseractPath: creatorTesseractPath })}));}@@ -764,6 +765,7 @@ export async function buildServer(input: BuildServerInput) {}));creatorExecutors.push(createImageExecutor({configStore: creatorServicesConfigStore,+ codexNative: { codexBin, codexHome, cwd: defaultCwd },...(creatorFfmpegPath === undefined? {}: {@@ -784,7 +786,10 @@ export async function buildServer(input: BuildServerInput) {getYtDlpRuntime: getCreatorYtDlpRuntime}),model: createWechatArticleModel({ configStore: creatorServicesConfigStore }),- imageGenerator: createArticleImageGenerator({ configStore: creatorServicesConfigStore })+ imageGenerator: createArticleImageGenerator({+ configStore: creatorServicesConfigStore,+ codexNative: { codexBin, codexHome, cwd: defaultCwd }+ })}));}const creatorProjectCoverService = createCreatorProjectCoverService({diff --git a/apps/daemon/src/creator-services/config-store.ts b/apps/daemon/src/creator-services/config-store.tsindex bf8097e8..ede5e88c 100644--- a/apps/daemon/src/creator-services/config-store.ts+++ b/apps/daemon/src/creator-services/config-store.ts@@ -56,11 +56,12 @@ const llmConfigSchema = openAiCompatibleSchema.extend({source: value.source ?? inferLegacyTextModelSource(value)}));const imageConfigSchema = z.object({- provider: z.enum(['openai', 'jimeng', 'kling', 'gemini']),+ provider: z.enum(['openai', 'jimeng', 'kling', 'gemini', 'codex-native']),openai: openAiCompatibleSchema,jimeng: openAiCompatibleSchema,kling: klingAiSchema,- gemini: openAiCompatibleSchema+ gemini: openAiCompatibleSchema,+ codexNative: z.object({}).strict().default({})}).strict();const legacyImageConfigSchema = z.object({provider: z.literal('openai-compatible'),diff --git a/apps/daemon/src/creator/article/executor.ts b/apps/daemon/src/creator/article/executor.tsindex 588a0a06..dc8caa3a 100644--- a/apps/daemon/src/creator/article/executor.ts+++ b/apps/daemon/src/creator/article/executor.ts@@ -67,7 +67,7 @@ export function createWechatArticleExecutor(input: {}): Promise<WechatArticleImagePlanItem[]>;};imageGenerator?: {- generate(request: { prompt: string; signal: AbortSignal }): Promise<ArticleImageGenerationResult>;+ generate(request: { prompt: string; signal: AbortSignal; cwd?: string }): Promise<ArticleImageGenerationResult>;};}): CreatorExecutor {return {@@ -296,7 +296,8 @@ export function createWechatArticleExecutor(input: {'Landscape editorial illustration for a WeChat article, 3:2 composition.','Do not render titles, paragraphs, logos, watermarks, UI, or illegible decorative text.'].join('\n\n'),- signal: stage.signal+ signal: stage.signal,+ cwd: stage.workdir});const extension = extensionForMime(generated.mime);const fileName = `article-image-${String(index + 1).padStart(2, '0')}.${extension}`;diff --git a/apps/daemon/src/creator/article/image-generator.ts b/apps/daemon/src/creator/article/image-generator.tsindex 95836036..b743ae09 100644--- a/apps/daemon/src/creator/article/image-generator.ts+++ b/apps/daemon/src/creator/article/image-generator.ts@@ -3,7 +3,8 @@ import type { CreatorServicesConfigStore } from '../../creator-services/config-simport {generateImageContents,ImageGenerationProviderError,- type GeneratedImageContent+ type GeneratedImageContent,+ type CodexNativeImageRuntime} from '../../image-generation/provider.js';import { CreatorExecutorError } from '../executor.js';@@ -15,12 +16,14 @@ export type ArticleImageGenerationResult = GeneratedImageContent & {export function createArticleImageGenerator(input: {configStore: Pick<CreatorServicesConfigStore, 'read'>;generate?: typeof generateImageContents;+ codexNative?: CodexNativeImageRuntime;}) {const generate = input.generate ?? generateImageContents;return {async generate(request: {prompt: string;signal: AbortSignal;+ cwd?: string;}): Promise<ArticleImageGenerationResult> {const config = await input.configStore.read();const provider = config.image.provider;@@ -31,7 +34,12 @@ export function createArticleImageGenerator(input: {size: '1536x1024',quality: 'medium',count: 1- }, config, { signal: request.signal });+ }, config, {+ signal: request.signal,+ ...(input.codexNative === undefined+ ? {}+ : { codexNative: { ...input.codexNative, ...(request.cwd === undefined ? {} : { cwd: request.cwd }) } })+ });const image = result.contents[0];if (image === undefined) {throw new ImageGenerationProviderError('upstream_error', 'The image provider returned no image');diff --git a/apps/daemon/src/creator/image/executor.ts b/apps/daemon/src/creator/image/executor.tsindex 5a7da81b..d7043517 100644--- a/apps/daemon/src/creator/image/executor.ts+++ b/apps/daemon/src/creator/image/executor.ts@@ -12,7 +12,8 @@ import { join } from 'node:path';import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';import {generateImageContents,- ImageGenerationProviderError+ ImageGenerationProviderError,+ type CodexNativeImageRuntime} from '../../image-generation/provider.js';import type { CreatorExecutor, CreatorExecutorInput, CreatorExecutorOutput } from '../executor.js';import { CreatorExecutorError } from '../executor.js';@@ -55,6 +56,7 @@ type CoverImageNormalizer = (input: {export function createImageExecutor(input: {configStore: Pick<CreatorServicesConfigStore, 'read'>;generate?: GenerateImageContents;+ codexNative?: CodexNativeImageRuntime;normalizeCoverImage?: CoverImageNormalizer;}): CreatorExecutor {const generate = input.generate ?? generateImageContents;@@ -83,6 +85,12 @@ export function createImageExecutor(input: {if (!request.prompt) {throw new CreatorExecutorError('creator_stage_input_missing', 'Image prompt is required');}+ if (request.provider === 'codex-native' && request.count !== 1) {+ throw new CreatorExecutorError(+ 'unsupported_capability',+ 'Codex subscription image generation supports exactly one candidate per task'+ );+ }const outputKind = stage.job.templateId === 'image-generation'? 'generated_image'@@ -111,7 +119,10 @@ export function createImageExecutor(input: {content: referenceImage.content,mime: referenceImage.mime}- })+ }),+ ...(input.codexNative === undefined+ ? {}+ : { codexNative: { ...input.codexNative, cwd: stage.workdir } })}).then(async result => {@@ -423,7 +434,11 @@ function readProvider(value: unknown,fallback: CreatorServicesConfig['image']['provider']): ImageGenerationProvider {- return value === 'openai' || value === 'jimeng' || value === 'kling' || value === 'gemini'+ return value === 'openai'+ || value === 'jimeng'+ || value === 'kling'+ || value === 'gemini'+ || value === 'codex-native'? value: fallback;}diff --git a/apps/daemon/src/creator/presets/module-schemas.ts b/apps/daemon/src/creator/presets/module-schemas.tsindex b98021fb..601e7ecd 100644--- a/apps/daemon/src/creator/presets/module-schemas.ts+++ b/apps/daemon/src/creator/presets/module-schemas.ts@@ -183,7 +183,7 @@ function validateModuleRequirement(if (requirement.service !== 'image') {throw new Error(`${module}: requirement service must be image`);}- if (!['openai', 'jimeng', 'kling', 'gemini'].includes(requirement.provider)) {+ if (!['openai', 'jimeng', 'kling', 'gemini', 'codex-native'].includes(requirement.provider)) {throw new Error(`${module}: unsupported image provider ${requirement.provider}`);}if (requirement.model !== undefined) {diff --git a/apps/daemon/src/creator/presets/requirements.ts b/apps/daemon/src/creator/presets/requirements.tsindex 5de35c26..867a4675 100644--- a/apps/daemon/src/creator/presets/requirements.ts+++ b/apps/daemon/src/creator/presets/requirements.ts@@ -222,6 +222,7 @@ function hasImageCredentials(services: CreatorServicesConfig,provider: string): boolean {+ if (provider === 'codex-native') return true;if (provider === 'kling') {return services.image.kling.accessKey.trim() !== ''&& services.image.kling.secretKey.trim() !== '';diff --git a/apps/daemon/src/creator/stickman/image-executor.ts b/apps/daemon/src/creator/stickman/image-executor.tsindex aa037df3..a7de5d5c 100644--- a/apps/daemon/src/creator/stickman/image-executor.ts+++ b/apps/daemon/src/creator/stickman/image-executor.ts@@ -7,7 +7,8 @@ import sharp from 'sharp';import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';import {generateImageContents,- imageGenerationCapabilities+ imageGenerationCapabilities,+ type CodexNativeImageRuntime} from '../../image-generation/provider.js';import type { CreatorExecutor } from '../executor.js';import { CreatorExecutorError } from '../executor.js';@@ -34,6 +35,7 @@ export function createStickmanImageExecutor(input: {configStore: Pick<CreatorServicesConfigStore, 'read'>;ledger: CreatorProviderRequestLedger;generate?: typeof generateImageContents;+ codexNative?: CodexNativeImageRuntime;tesseractPath?: string;validateCandidate?: (path: string) => Promise<StickmanImageCandidateQuality>;}): CreatorExecutor {@@ -228,7 +230,7 @@ export function createStickmanImageExecutor(input: {const provider = config.image.provider;const quality = readQuality(stage.job.state.quality);assertReferenceImageSupport(provider, referenceImages.length);- const model = config.image[provider].model;+ const model = provider === 'codex-native' ? 'codex-native' : config.image[provider].model;if (promptPackArtifact.metadata.contract !== STICKMAN_IMAGE_PROMPT_CONTRACT|| promptPack.characterReferenceArtifactId !== characterReference.id@@ -303,7 +305,10 @@ export function createStickmanImageExecutor(input: {referenceImages: referenceImages.map(reference => ({content: reference.content,mime: reference.mime- }))+ })),+ ...(input.codexNative === undefined+ ? {}+ : { codexNative: { ...input.codexNative, cwd: stage.workdir } })});input.ledger.markSucceeded(ledger.id);} catch (error) {diff --git a/apps/daemon/src/creator/templates/cover-actions.ts b/apps/daemon/src/creator/templates/cover-actions.tsindex 90176b33..4edd0948 100644--- a/apps/daemon/src/creator/templates/cover-actions.ts+++ b/apps/daemon/src/creator/templates/cover-actions.ts@@ -247,6 +247,7 @@ function hasImageCredentials(config: Awaited<ReturnType<CreatorServicesConfigStore['read']>>,provider: ImageGenerationProvider): boolean {+ if (provider === 'codex-native') return true;if (provider === 'kling') {return config.image.kling.accessKey.trim().length > 0&& config.image.kling.secretKey.trim().length > 0;@@ -258,7 +259,11 @@ function readProvider(value: unknown,fallback: ImageGenerationProvider): ImageGenerationProvider {- return value === 'openai' || value === 'jimeng' || value === 'kling' || value === 'gemini'+ return value === 'openai'+ || value === 'jimeng'+ || value === 'kling'+ || value === 'gemini'+ || value === 'codex-native'? value: fallback;}diff --git a/apps/daemon/src/creator/templates/cover.ts b/apps/daemon/src/creator/templates/cover.tsindex 55fe0615..d2141c5f 100644--- a/apps/daemon/src/creator/templates/cover.ts+++ b/apps/daemon/src/creator/templates/cover.ts@@ -68,7 +68,7 @@ export function createCoverTemplate(): CreatorTemplateDefinition {ratio: z.enum(['16:9', '1:1', '9:16']).default('16:9'),candidateCount: z.number().int().min(1).max(4).default(2),quality: z.enum(['low', 'medium', 'high']).default('medium'),- provider: z.enum(['openai', 'jimeng', 'kling', 'gemini']).optional(),+ provider: z.enum(['openai', 'jimeng', 'kling', 'gemini', 'codex-native']).optional(),referenceImageArtifactId: z.string().nullable().default(null),currentStep: z.union([z.literal(0), z.literal(1), z.literal(2)]).default(0),furthestStep: z.union([z.literal(0), z.literal(1), z.literal(2)]).default(0),diff --git a/apps/daemon/src/creator/templates/image-generation.ts b/apps/daemon/src/creator/templates/image-generation.tsindex b8c2cdff..3d2c0911 100644--- a/apps/daemon/src/creator/templates/image-generation.ts+++ b/apps/daemon/src/creator/templates/image-generation.ts@@ -22,7 +22,7 @@ function createImageGenerationTemplateDefinition(renderer: 'image-generation',inputSchema: z.object({prompt: z.string().max(creatorPromptMaxLength).default(''),- provider: z.enum(['openai', 'jimeng', 'kling', 'gemini']).default('openai'),+ provider: z.enum(['openai', 'jimeng', 'kling', 'gemini', 'codex-native']).default('openai'),size: z.enum(['1024x1024', '1536x1024', '1024x1536']).default('1024x1024'),quality: z.enum(['low', 'medium', 'high']).default('medium'),candidateCount: z.number().int().min(1).max(4).default(2),diff --git a/apps/daemon/src/creator/templates/stickman-video-actions.ts b/apps/daemon/src/creator/templates/stickman-video-actions.tsindex 6c3e81db..4acb6e24 100644--- a/apps/daemon/src/creator/templates/stickman-video-actions.ts+++ b/apps/daemon/src/creator/templates/stickman-video-actions.ts@@ -427,7 +427,7 @@ export function createStickmanVideoWorkflow(input: {const provider = config.image.provider;return {provider,- model: config.image[provider].model,+ model: provider === 'codex-native' ? 'codex-native' : config.image[provider].model,quality: typeof job.state.quality === 'string' ? job.state.quality : 'medium'};}diff --git a/apps/daemon/src/image-generation/codex-native.ts b/apps/daemon/src/image-generation/codex-native.tsnew file mode 100644index 00000000..7eacdeaa--- /dev/null+++ b/apps/daemon/src/image-generation/codex-native.ts@@ -0,0 +1,484 @@+import type {+ ImageGenerationAsset,+ ImageGenerationQuality,+ ImageGenerationSize+} from '@opencreator/protocol';+import { readFile, readdir, realpath, stat } from 'node:fs/promises';+import { isAbsolute, join, relative, resolve } from 'node:path';+import {+ createCodexAppServerHost,+ type CodexAppServerHost,+ type CodexAppServerHostInput,+ type CodexAppServerResult,+ type CodexAppServerTurnInput+} from '../codex/app-server-host-2026-07-28.js';++const DEFAULT_TIMEOUT_MS = 180_000;+const MAX_IMAGE_BYTES = 30 * 1024 * 1024;++type ImageGenerationItem = {+ type: 'imageGeneration';+ status?: unknown;+ failure?: unknown;+ savedPath?: unknown;+};++type LocalArtifactMetadata = {+ mtimeMs: number;+ size: number;+};++type LocalArtifactSnapshot = Map<string, LocalArtifactMetadata>;++type LocalArtifactScanRoot = {+ path: string;+ boundary: string;+ recursive: boolean;+};++export type CodexNativeImageInput = {+ prompt: string;+ size: ImageGenerationSize;+ quality: ImageGenerationQuality;+ cwd: string;+ codexBin: string;+ codexHome: string;+ signal?: AbortSignal;+ timeoutMs?: number;+ createHost?: (input: CodexAppServerHostInput) => CodexAppServerHost;+};++export type CodexNativeImageResult = {+ content: Buffer;+ mime: ImageGenerationAsset['mime'];+ model: 'codex-native';+};++export class CodexNativeImageError extends Error {+ constructor(+ readonly code: 'config_missing' | 'upstream_error',+ message: string+ ) {+ super(message);+ this.name = 'CodexNativeImageError';+ }+}++export async function generateCodexNativeImage(+ input: CodexNativeImageInput+): Promise<CodexNativeImageResult> {+ await assertLocalConfiguration(input);+ if (input.signal?.aborted) {+ throw new CodexNativeImageError('upstream_error', 'Codex native image generation was canceled');+ }++ const createHost = input.createHost ?? createCodexAppServerHost;+ const host = createHost({+ codexBin: input.codexBin,+ codexHome: input.codexHome,+ cwd: input.cwd,+ profile: 'default'+ });+ let imageItem: ImageGenerationItem | undefined;+ let codexThreadId: string | undefined;+ try {+ await host.started;+ const artifactSnapshot = await snapshotLocalArtifacts(input);+ const generationStartedAt = Date.now();+ const process = host.run({+ cwd: input.cwd,+ sandbox: 'workspace-write',+ prompt: buildImagePrompt(input),+ developerInstructions: [+ 'Use the native image_generation tool for exactly one original image.',+ 'Do not call an external image API, use an API key, or return a remote URL.',+ 'The completed image must be saved as the imageGeneration savedPath artifact.'+ ].join(' '),+ timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS,+ inactivityTimeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS,+ onThreadStarted(threadId) {+ codexThreadId = threadId;+ },+ onNotification(notification) {+ const candidate = readCompletedImageItem(notification);+ if (candidate !== undefined) imageItem = candidate;+ }+ });+ const result = await awaitProcessResult(+ process,+ input.signal,+ input.timeoutMs ?? DEFAULT_TIMEOUT_MS+ );+ if (result.turnStatus !== 'completed') {+ throw new CodexNativeImageError(+ 'upstream_error',+ `Codex native image turn ended with status ${result.turnStatus}`+ );+ }+ return {+ ...(await readImageArtifact(+ imageItem,+ input,+ artifactSnapshot,+ generationStartedAt,+ codexThreadId+ )),+ model: 'codex-native'+ };+ } catch (error) {+ if (error instanceof CodexNativeImageError) throw error;+ throw new CodexNativeImageError(+ 'upstream_error',+ error instanceof Error ? error.message : 'Codex native image generation failed'+ );+ } finally {+ await host.close('codex-native-image-finished').catch(() => undefined);+ }+}++async function assertLocalConfiguration(input: CodexNativeImageInput): Promise<void> {+ if (!input.codexBin.trim() || !isAbsolute(input.cwd) || !isAbsolute(input.codexHome)) {+ throw new CodexNativeImageError(+ 'config_missing',+ 'Codex native image generation requires an executable, absolute workspace, and CODEX_HOME'+ );+ }+ const [workspace, codexHome] = await Promise.all([+ stat(input.cwd).catch(() => undefined),+ stat(input.codexHome).catch(() => undefined)+ ]);+ if (!workspace?.isDirectory() || !codexHome?.isDirectory()) {+ throw new CodexNativeImageError(+ 'config_missing',+ 'Codex native image generation requires an existing workspace and CODEX_HOME directory'+ );+ }+ if (isCodexExecutablePath(input.codexBin)) {+ const executablePath = isAbsolute(input.codexBin)+ ? input.codexBin+ : resolve(input.cwd, input.codexBin);+ const executable = await stat(executablePath).catch(() => undefined);+ if (!executable?.isFile()) {+ throw new CodexNativeImageError(+ 'config_missing',+ `Codex executable was not found at ${executablePath}`+ );+ }+ }+}++function isCodexExecutablePath(codexBin: string): boolean {+ return isAbsolute(codexBin) || /[\\/]/.test(codexBin);+}++function buildImagePrompt(input: Pick<CodexNativeImageInput, 'prompt' | 'size' | 'quality'>): string {+ return [+ 'Generate one original image for OpenCreator.',+ `Requested canvas: ${input.size}. Requested quality: ${input.quality}.`,+ `User image brief: ${input.prompt.trim()}`+ ].join('\n');+}++function readCompletedImageItem(+ notification: Record<string, unknown>+): ImageGenerationItem | undefined {+ if (notification.method !== 'item/completed') return undefined;+ const params = asRecord(notification.params);+ const item = asRecord(params?.item);+ if (item?.type !== 'imageGeneration') return undefined;+ return item as ImageGenerationItem;+}++async function readImageArtifact(+ item: ImageGenerationItem | undefined,+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>,+ artifactSnapshot: LocalArtifactSnapshot,+ generationStartedAt: number,+ codexThreadId: string | undefined+): Promise<Pick<CodexNativeImageResult, 'content' | 'mime'>> {+ const failure = asRecord(item?.failure);+ if (failure !== undefined) {+ throw new CodexNativeImageError(+ 'upstream_error',+ `Codex native image generation failed: ${stringField(failure, 'message') ?? 'unknown failure'}`+ );+ }+ if (item?.status === 'failed') {+ throw new CodexNativeImageError('upstream_error', 'Codex native image generation failed');+ }++ if (+ item !== undefined+ && Object.prototype.hasOwnProperty.call(item, 'savedPath')+ && item.savedPath !== undefined+ ) {+ if (typeof item.savedPath !== 'string' || !item.savedPath.trim() || !isAbsolute(item.savedPath)) {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex imageGeneration returned no valid absolute savedPath'+ );+ }+ return await readImageArtifactAtPath(item.savedPath, input);+ }++ const discovered = await discoverNewLocalArtifact(+ input,+ artifactSnapshot,+ generationStartedAt,+ codexThreadId+ );+ if (discovered === undefined) {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex completed without a new local image artifact'+ );+ }+ return discovered;+}++async function readImageArtifactAtPath(+ savedPath: string,+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>+): Promise<Pick<CodexNativeImageResult, 'content' | 'mime'>> {+ if (savedPath.startsWith('file:') || savedPath.includes('\0')) {+ throw new CodexNativeImageError('upstream_error', 'Codex image savedPath is not a local filesystem path');+ }++ const candidate = resolve(savedPath);+ const roots = await allowedRoots(input);+ let artifactPath: string;+ try {+ artifactPath = await realpath(candidate);+ const rootPaths = await Promise.all(roots.map(async root => (+ await realpath(root).catch(() => root)+ )));+ if (!rootPaths.some(root => isPathInside(root, artifactPath))) {+ throw new Error('outside allowed roots');+ }+ const metadata = await stat(artifactPath);+ if (!metadata.isFile() || metadata.size <= 0 || metadata.size > MAX_IMAGE_BYTES) {+ throw new Error('invalid image file size');+ }+ } catch {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex image artifact is missing or outside the allowed local roots'+ );+ }++ const content = await readFile(artifactPath);+ if (content.length > MAX_IMAGE_BYTES) {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex image artifact exceeds the local size limit'+ );+ }+ const mime = detectImageMime(content);+ if (mime === undefined) {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex image artifact has an unsupported or invalid image signature'+ );+ }+ return { content, mime };+}++async function snapshotLocalArtifacts(+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>+): Promise<LocalArtifactSnapshot> {+ const snapshot: LocalArtifactSnapshot = new Map();+ for (const path of await listLocalArtifactFiles(discoveryRoots(input))) {+ const metadata = await stat(path).catch(() => undefined);+ if (metadata?.isFile()) {+ snapshot.set(path, { mtimeMs: metadata.mtimeMs, size: metadata.size });+ }+ }+ return snapshot;+}++async function discoverNewLocalArtifact(+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>,+ snapshot: LocalArtifactSnapshot,+ generationStartedAt: number,+ codexThreadId: string | undefined+): Promise<Pick<CodexNativeImageResult, 'content' | 'mime'> | undefined> {+ const candidates: Array<Pick<CodexNativeImageResult, 'content' | 'mime'>> = [];+ for (const path of await listLocalArtifactFiles(discoveryRoots(input, codexThreadId))) {+ const metadata = await stat(path).catch(() => undefined);+ if (metadata === undefined || !metadata.isFile()) continue;+ const previous = snapshot.get(path);+ const isNewPath = previous === undefined;+ const isChangedPath = previous !== undefined+ && (previous.mtimeMs !== metadata.mtimeMs || previous.size !== metadata.size)+ && metadata.mtimeMs >= generationStartedAt;+ if (!isNewPath && !isChangedPath) continue;+ if (metadata.size <= 0 || metadata.size > MAX_IMAGE_BYTES) continue;+ try {+ const content = await readFile(path);+ if (content.length > MAX_IMAGE_BYTES) continue;+ const mime = detectImageMime(content);+ if (mime !== undefined) candidates.push({ content, mime });+ } catch {+ // The Codex process may still be closing the file; it is not usable yet.+ }+ }+ if (candidates.length > 1) {+ throw new CodexNativeImageError(+ 'upstream_error',+ 'Codex created multiple new local image artifacts; refusing to guess'+ );+ }+ return candidates[0];+}++async function allowedRoots(+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>+): Promise<string[]> {+ const workspaceRoot = resolve(input.cwd);+ const generatedRoot = resolve(join(input.codexHome, 'generated_images'));+ const codexHomeRoot = await realpath(input.codexHome).catch(() => undefined);+ const generatedRootReal = await realpath(generatedRoot).catch(() => generatedRoot);+ return [+ workspaceRoot,+ ...(codexHomeRoot !== undefined && isPathInside(codexHomeRoot, generatedRootReal)+ ? [generatedRootReal]+ : [])+ ];+}++function discoveryRoots(+ input: Pick<CodexNativeImageInput, 'cwd' | 'codexHome'>,+ codexThreadId?: string+): LocalArtifactScanRoot[] {+ const generatedRoot = resolve(join(input.codexHome, 'generated_images'));+ const codexHomeRoot = resolve(input.codexHome);+ if (codexThreadId !== undefined && /^[A-Za-z0-9_-]+$/.test(codexThreadId)) {+ return [+ {+ path: resolve(generatedRoot, codexThreadId),+ boundary: codexHomeRoot,+ recursive: true+ },+ { path: generatedRoot, boundary: codexHomeRoot, recursive: false }+ ];+ }+ return [{ path: generatedRoot, boundary: codexHomeRoot, recursive: true }];+}++async function listLocalArtifactFiles(roots: LocalArtifactScanRoot[]): Promise<string[]> {+ const files = new Set<string>();+ for (const scanRoot of roots) {+ const canonicalBoundary = await realpath(scanRoot.boundary).catch(() => undefined);+ const canonicalRoot = await realpath(scanRoot.path).catch(() => undefined);+ if (+ canonicalBoundary === undefined+ || canonicalRoot === undefined+ || !isPathInside(canonicalBoundary, canonicalRoot)+ ) continue;+ await walkLocalArtifactFiles(+ canonicalBoundary,+ canonicalRoot,+ files,+ scanRoot.recursive+ );+ }+ return [...files];+}++async function walkLocalArtifactFiles(+ root: string,+ directory: string,+ files: Set<string>,+ recursive: boolean+): Promise<void> {+ const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);+ for (const entry of entries) {+ const candidate = join(directory, entry.name);+ if (entry.isDirectory()) {+ if (!recursive) continue;+ await walkLocalArtifactFiles(root, candidate, files, recursive);+ continue;+ }+ if (!entry.isFile()) continue;+ const canonical = await realpath(candidate).catch(() => undefined);+ if (canonical !== undefined && isPathInside(root, canonical)) files.add(canonical);+ }+}++function isPathInside(root: string, candidate: string): boolean {+ const child = relative(root, candidate);+ return child === '' || (!child.startsWith('..') && !isAbsolute(child));+}++function detectImageMime(content: Buffer): ImageGenerationAsset['mime'] | undefined {+ if (content.subarray(0, 8).equals(Buffer.from([+ 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a+ ]))) {+ return 'image/png';+ }+ if (content.length >= 3 && content[0] === 0xff && content[1] === 0xd8 && content[2] === 0xff) {+ return 'image/jpeg';+ }+ if (+ content.length >= 12+ && content.subarray(0, 4).toString('ascii') === 'RIFF'+ && content.subarray(8, 12).toString('ascii') === 'WEBP'+ ) {+ return 'image/webp';+ }+ return undefined;+}++async function awaitProcessResult(+ process: { cancel(): void; result: Promise<CodexAppServerResult> },+ signal: AbortSignal | undefined,+ timeoutMs: number+): Promise<CodexAppServerResult> {+ const timeout = Math.max(1, timeoutMs);+ return await new Promise<CodexAppServerResult>((resolveResult, rejectResult) => {+ let settled = false;+ const timer = setTimeout(() => {+ process.cancel();+ finishReject(new CodexNativeImageError(+ 'upstream_error',+ `Codex native image generation timed out after ${timeout}ms`+ ));+ }, timeout);+ timer.unref?.();++ const abort = () => {+ process.cancel();+ finishReject(new CodexNativeImageError('upstream_error', 'Codex native image generation was canceled'));+ };+ const finishResolve = (value: CodexAppServerResult) => {+ if (settled) return;+ settled = true;+ clearTimeout(timer);+ signal?.removeEventListener('abort', abort);+ resolveResult(value);+ };+ const finishReject = (error: unknown) => {+ if (settled) return;+ settled = true;+ clearTimeout(timer);+ signal?.removeEventListener('abort', abort);+ rejectResult(error);+ };+ if (signal?.aborted) {+ abort();+ return;+ }+ signal?.addEventListener('abort', abort, { once: true });+ process.result.then(finishResolve, finishReject);+ });+}++function asRecord(value: unknown): Record<string, unknown> | undefined {+ return typeof value === 'object' && value !== null && !Array.isArray(value)+ ? value as Record<string, unknown>+ : undefined;+}++function stringField(value: Record<string, unknown>, key: string): string | undefined {+ return typeof value[key] === 'string' ? value[key] as string : undefined;+}diff --git a/apps/daemon/src/image-generation/provider.ts b/apps/daemon/src/image-generation/provider.tsindex b591af2b..14eb57d3 100644--- a/apps/daemon/src/image-generation/provider.ts+++ b/apps/daemon/src/image-generation/provider.ts@@ -3,6 +3,11 @@ import type {CreatorServicesConfig,ImageGenerationAsset} from '@opencreator/protocol';+import {+ CodexNativeImageError,+ generateCodexNativeImage,+ type CodexNativeImageInput+} from './codex-native.js';import { createKlingAuthorization } from '../creator-services/kling-auth.js';import {appendEndpointPath,@@ -22,6 +27,11 @@ export type GeneratedImageContent = {mime: ImageGenerationAsset['mime'];};+export type CodexNativeImageRuntime = Pick<+ CodexNativeImageInput,+ 'codexBin' | 'codexHome' | 'cwd' | 'createHost'+>;+export type ImageGenerationCapabilities = {supportsReferenceImage: boolean;maxReferenceImages: number;@@ -54,6 +64,7 @@ export async function generateImageContents(signal?: AbortSignal;referenceImage?: GeneratedImageContent;referenceImages?: GeneratedImageContent[];+ codexNative?: CodexNativeImageRuntime;} = {}): Promise<{ model: string; contents: GeneratedImageContent[] }> {const referenceImages = options.referenceImages@@ -76,6 +87,35 @@ export async function generateImageContents(: `The ${request.provider} image provider does not support reference images`);}+ if (request.provider === 'codex-native') {+ if (request.count !== 1) {+ throw new ImageGenerationProviderError(+ 'unsupported_capability',+ 'The codex-native image provider supports exactly one image per request'+ );+ }+ if (options.codexNative === undefined) {+ throw new ImageGenerationProviderError(+ 'config_missing',+ 'Configure the local Codex executable and CODEX_HOME before generating images'+ );+ }+ try {+ const generated = await generateCodexNativeImage({+ ...options.codexNative,+ prompt: request.prompt,+ size: request.size,+ quality: request.quality,+ signal: controller.signal+ });+ return { model: generated.model, contents: [generated] };+ } catch (error) {+ if (error instanceof CodexNativeImageError) {+ throw new ImageGenerationProviderError(error.code, error.message);+ }+ throw error;+ }+ }if (request.provider === 'gemini') {return await generateGeminiImages(request,diff --git a/apps/daemon/src/image-generation/service.ts b/apps/daemon/src/image-generation/service.tsindex f5039cef..398515c9 100644--- a/apps/daemon/src/image-generation/service.ts+++ b/apps/daemon/src/image-generation/service.ts@@ -12,12 +12,13 @@ import type { CreatorServicesConfigStore } from '../creator-services/config-storimport { isRecord } from '../creator-services/upstream-fetch.js';import {generateImageContents,- ImageGenerationProviderError+ ImageGenerationProviderError,+ type CodexNativeImageRuntime} from './provider.js';const MAX_PROMPT_LENGTH = 4_000;const SAFE_RESULT_ID = /^[A-Za-z0-9_-]{12,64}$/;-const imageProviders = ['openai', 'jimeng', 'kling', 'gemini'] as const;+const imageProviders = ['openai', 'jimeng', 'kling', 'gemini', 'codex-native'] as const;export type ImageGenerationService = {generate(request: CreateImageGenerationRequest): Promise<ImageGenerationResult>;@@ -49,6 +50,7 @@ export function createImageGenerationService(input: {dataDir: string;configStore: CreatorServicesConfigStore;fetchImpl?: typeof fetch;+ codexNative?: CodexNativeImageRuntime;now?: () => Date;createId?: () => string;}): ImageGenerationService {@@ -77,7 +79,10 @@ export function createImageGenerationService(input: {const config = await input.configStore.read();let generated: Awaited<ReturnType<typeof generateImageContents>>;try {- generated = await generateImageContents(request, config, { fetchImpl: input.fetchImpl });+ generated = await generateImageContents(request, config, {+ fetchImpl: input.fetchImpl,+ ...(input.codexNative === undefined ? {} : { codexNative: input.codexNative })+ });} catch (error) {throw mapProviderError(error);}diff --git a/apps/daemon/test/integration/codex-native-real-smoke.test.ts b/apps/daemon/test/integration/codex-native-real-smoke.test.tsnew file mode 100644index 00000000..bceae445--- /dev/null+++ b/apps/daemon/test/integration/codex-native-real-smoke.test.ts@@ -0,0 +1,31 @@+import { describe, expect, it } from 'vitest';+import { mkdtemp, rm } from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { resolveCodexHome } from '../../src/codex/home.js';+import { generateCodexNativeImage } from '../../src/image-generation/codex-native.js';++const runRealSmoke = process.env.OPENCREATOR_RUN_CODEX_NATIVE_SMOKE === '1';++(runRealSmoke ? describe : describe.skip)('Codex native real subscription smoke', () => {+ it('generates one local image through the authenticated Codex session', async () => {+ const cwd = await mkdtemp(join(tmpdir(), 'opencreator-codex-native-real-'));+ try {+ const result = await generateCodexNativeImage({+ prompt: 'An original orange cat sitting beside a sunny window, simple composition',+ size: '1024x1024',+ quality: 'low',+ cwd,+ codexBin: process.env.OPENCREATOR_CODEX_BIN ?? 'codex',+ codexHome: resolveCodexHome().path,+ timeoutMs: 240_000+ });++ expect(result.model).toBe('codex-native');+ expect(result.content.length).toBeGreaterThan(0);+ expect(['image/png', 'image/jpeg', 'image/webp']).toContain(result.mime);+ } finally {+ await rm(cwd, { recursive: true, force: true });+ }+ }, 300_000);+});diff --git a/apps/daemon/test/integration/image-generation-api.test.ts b/apps/daemon/test/integration/image-generation-api.test.tsindex 86121f91..fb63dfd9 100644--- a/apps/daemon/test/integration/image-generation-api.test.ts+++ b/apps/daemon/test/integration/image-generation-api.test.ts@@ -1,10 +1,15 @@import { createDefaultCreatorServicesConfig } from '@opencreator/protocol';import Fastify, { type FastifyInstance } from 'fastify';-import { mkdtemp, readdir, rm } from 'node:fs/promises';+import { mkdir, mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';import { tmpdir } from 'node:os';import { join } from 'node:path';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import { registerImageGenerationRoutes } from '../../src/api/routes.image-generation.js';+import type {+ CodexAppServerHost,+ CodexAppServerResult,+ CodexAppServerTurnInput+} from '../../src/codex/app-server-host-2026-07-28.js';import type { CreatorServicesConfigStore } from '../../src/creator-services/config-store.js';import { generateImageContents } from '../../src/image-generation/provider.js';import { createImageGenerationService } from '../../src/image-generation/service.js';@@ -77,6 +82,53 @@ describe('image generation API', () => {.toEqual(['0.png', 'result.json']);});+ it('generates and stores a Codex native image without using a remote fetcher', async () => {+ const config = createDefaultCreatorServicesConfig();+ config.image.provider = 'codex-native';+ const codexHome = join(dataDir, 'codex-home');+ const savedPath = join(codexHome, 'generated_images', 'native.png');+ const image = Buffer.concat([+ Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),+ Buffer.from('codex-native-image')+ ]);+ await mkdir(join(codexHome, 'generated_images'), { recursive: true });+ await writeFile(savedPath, image);+ const createHost = fakeNativeHost(savedPath);+ const fetchImpl = vi.fn() as typeof fetch;+ await registerImageGenerationRoutes(server, createImageGenerationService({+ dataDir,+ configStore: createConfigStore(config),+ fetchImpl,+ codexNative: {+ codexBin: 'codex',+ codexHome,+ cwd: dataDir,+ createHost+ },+ createId: () => 'codex_native_1234'+ }));++ const generated = await server.inject({+ method: 'POST',+ url: '/image-generation/results',+ payload: { prompt: 'An original orange cat', provider: 'codex-native', size: '1024x1024', quality: 'medium', count: 1 }+ });++ expect(generated.statusCode).toBe(201);+ expect(generated.json().result).toMatchObject({+ provider: 'codex-native',+ model: 'codex-native',+ images: [{ mime: 'image/png', size: image.length }]+ });+ expect(fetchImpl).not.toHaveBeenCalled();+ const content = await server.inject({+ method: 'GET',+ url: '/image-generation/results/codex_native_1234/content/0'+ });+ expect(content.statusCode).toBe(200);+ expect(content.rawPayload).toEqual(image);+ });+it('adds v1 to an OpenAI-compatible image provider path without a version', async () => {const config = createDefaultCreatorServicesConfig();config.image.openai.apiKey = 'sk-image-test';@@ -339,3 +391,41 @@ function createConfigStore(config: ReturnType<typeof createDefaultCreatorServicereset: vi.fn(async () => createDefaultCreatorServicesConfig())};}++function fakeNativeHost(savedPath: string) {+ return vi.fn((): CodexAppServerHost => ({+ pid: 123,+ started: Promise.resolve(123),+ run: vi.fn((input: CodexAppServerTurnInput) => ({+ cancel: vi.fn(),+ result: (async () => {+ await input.onNotification?.({+ method: 'item/completed',+ params: {+ item: {+ type: 'imageGeneration',+ status: 'completed',+ failure: null,+ savedPath+ }+ }+ });+ return nativeCompletedResult;+ })()+ })),+ isReusable: vi.fn(() => false),+ close: vi.fn(async () => undefined)+ }));+}++const nativeCompletedResult: CodexAppServerResult = {+ threadId: 'thread-1',+ turnId: 'turn-1',+ turnStatus: 'completed',+ stderr: '',+ terminationReason: 'completed',+ outputTruncation: {+ stderr: { truncated: false, droppedBytes: 0, droppedItems: 0 },+ frames: { truncated: false, droppedBytes: 0, droppedItems: 0 }+ }+};diff --git a/apps/daemon/test/unit/codex-native-image.test.ts b/apps/daemon/test/unit/codex-native-image.test.tsnew file mode 100644index 00000000..d66851f2--- /dev/null+++ b/apps/daemon/test/unit/codex-native-image.test.ts@@ -0,0 +1,406 @@+import { mkdir, mkdtemp, rm, truncate, writeFile } from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { afterEach, describe, expect, it, vi } from 'vitest';+import type {+ CodexAppServerHost,+ CodexAppServerHostInput,+ CodexAppServerResult,+ CodexAppServerTurnInput+} from '../../src/codex/app-server-host-2026-07-28.js';+import {+ CodexNativeImageError,+ generateCodexNativeImage+} from '../../src/image-generation/codex-native.js';++const png = Buffer.from([+ 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,+ 0x00, 0x00, 0x00, 0x00+]);++describe('Codex native image adapter', () => {+ afterEach(async () => {+ await Promise.all(testRoots.map(root => rm(root, { recursive: true, force: true })));+ testRoots = [];+ });++ it('runs the authenticated local app-server and imports its image artifact', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const savedPath = join(codexHome, 'generated_images', 'result.png');+ await mkdir(join(codexHome, 'generated_images'), { recursive: true });+ await writeFile(savedPath, png);+ const createHost = fakeHost({ savedPath });++ const result = await generateCodexNativeImage({+ prompt: 'an original orange cat',+ size: '1024x1024',+ quality: 'medium',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost+ });++ expect(result).toMatchObject({ content: png, mime: 'image/png', model: 'codex-native' });+ expect(createHost).toHaveBeenCalledWith(expect.objectContaining({+ codexBin: 'codex',+ codexHome,+ cwd: root,+ profile: 'default'+ }));+ expect(createHost.mock.calls[0]![0].builtInTools).toBeUndefined();+ const host = createHost.mock.results[0]!.value as CodexAppServerHost;+ expect(host.run).toHaveBeenCalledWith(expect.objectContaining({+ cwd: root,+ sandbox: 'workspace-write',+ prompt: expect.stringContaining('an original orange cat'),+ developerInstructions: expect.stringContaining('native image_generation')+ }));+ expect(host.close).toHaveBeenCalledTimes(1);+ });++ it('imports one new local artifact when Codex omits the structured savedPath notification', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const savedPath = join(codexHome, 'generated_images', 'thread-1', 'result.png');+ await mkdir(codexHome, { recursive: true });+ const createHost = fakeHost({+ emitImageItem: false,+ createArtifact: async () => {+ await mkdir(join(codexHome, 'generated_images', 'thread-1'), { recursive: true });+ await writeFile(savedPath, png);+ }+ });++ const result = await generateCodexNativeImage({+ prompt: 'an original orange cat',+ size: '1024x1024',+ quality: 'medium',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost+ });++ expect(result).toMatchObject({ content: png, mime: 'image/png', model: 'codex-native' });+ });++ it('imports one new artifact written directly under generated_images for older Codex layouts', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const savedPath = join(codexHome, 'generated_images', 'result.png');+ await mkdir(codexHome, { recursive: true });+ const createHost = fakeHost({+ emitImageItem: false,+ createArtifact: async () => {+ await mkdir(join(codexHome, 'generated_images'), { recursive: true });+ await writeFile(savedPath, png);+ }+ });++ const result = await generateCodexNativeImage({+ prompt: 'an original orange cat',+ size: '1024x1024',+ quality: 'medium',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost+ });++ expect(result).toMatchObject({ content: png, mime: 'image/png', model: 'codex-native' });+ });++ it('rejects ambiguous new local artifacts instead of guessing between them', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const generatedRoot = join(codexHome, 'generated_images', 'thread-1');+ await mkdir(codexHome, { recursive: true });+ const createHost = fakeHost({+ emitImageItem: false,+ createArtifact: async () => {+ await mkdir(generatedRoot, { recursive: true });+ await Promise.all([+ writeFile(join(generatedRoot, 'result-a.png'), png),+ writeFile(join(generatedRoot, 'result-b.png'), png)+ ]);+ }+ });++ await expect(generateCodexNativeImage({+ prompt: 'an original orange cat',+ size: '1024x1024',+ quality: 'medium',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost+ })).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('multiple')+ });+ });++ it('does not import an artifact created under another Codex thread', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const otherThreadRoot = join(codexHome, 'generated_images', 'thread-2');+ await mkdir(codexHome, { recursive: true });+ const createHost = fakeHost({+ emitImageItem: false,+ createArtifact: async () => {+ await mkdir(otherThreadRoot, { recursive: true });+ await writeFile(join(otherThreadRoot, 'result.png'), png);+ }+ });++ await expect(generateCodexNativeImage({+ prompt: 'an original orange cat',+ size: '1024x1024',+ quality: 'medium',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost+ })).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('new local image artifact')+ });+ });++ it('rejects an image artifact outside the workspace and Codex generated-images roots', async () => {+ const root = await tempRoot();+ const outside = join(root, 'outside.png');+ await mkdir(join(root, 'workspace'), { recursive: true });+ await mkdir(join(root, 'codex-home'), { recursive: true });+ await writeFile(outside, png);+ const createHost = fakeHost({ savedPath: outside });++ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: join(root, 'workspace'),+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ createHost+ })).rejects.toMatchObject({ code: 'upstream_error' });+ });++ it('rejects a missing or malformed savedPath instead of guessing an output', async () => {+ const root = await tempRoot();+ await mkdir(join(root, 'codex-home'), { recursive: true });+ for (const savedPath of [undefined, 'file:///C:/generated.png', join(root, 'missing.png')]) {+ const createHost = fakeHost({ savedPath });+ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ createHost+ })).rejects.toBeInstanceOf(CodexNativeImageError);+ }+ });++ it('rejects bytes that are not a supported image signature', async () => {+ const root = await tempRoot();+ const savedPath = join(root, 'invalid.png');+ await mkdir(join(root, 'codex-home'), { recursive: true });+ await writeFile(savedPath, Buffer.from('not an image'));++ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ createHost: fakeHost({ savedPath })+ })).rejects.toMatchObject({ code: 'upstream_error' });+ });++ it('rejects an artifact above the local size limit', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ const savedPath = join(root, 'oversized.png');+ await mkdir(codexHome, { recursive: true });+ await writeFile(savedPath, png);+ await truncate(savedPath, 30 * 1024 * 1024 + 1);++ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ createHost: fakeHost({ savedPath })+ })).rejects.toMatchObject({ code: 'upstream_error' });+ });++ it('turns a Codex image-generation failure into a local provider error', async () => {+ const root = await tempRoot();+ await mkdir(join(root, 'codex-home'), { recursive: true });+ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ createHost: fakeHost({ failure: { message: 'native tool failed' } })+ })).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('native tool failed')+ });+ });++ it('rejects a turn that the Codex host reports as failed', async () => {+ const root = await tempRoot();+ await mkdir(join(root, 'codex-home'), { recursive: true });+ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ createHost: fakeHost({ turnStatus: 'failed' })+ })).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('ended with status failed')+ });+ });++ it('cancels and closes the host when the local timeout is reached', async () => {+ const root = await tempRoot();+ await mkdir(join(root, 'codex-home'), { recursive: true });+ const createHost = fakeHost({ neverCompletes: true });+ await expect(generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome: join(root, 'codex-home'),+ timeoutMs: 5,+ createHost+ })).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('timed out')+ });+ const host = createHost.mock.results[0]!.value as CodexAppServerHost;+ const execution = (host.run as ReturnType<typeof vi.fn>).mock.results[0]!.value as {+ cancel: ReturnType<typeof vi.fn>;+ };+ expect(execution.cancel).toHaveBeenCalledTimes(1);+ expect(host.close).toHaveBeenCalledTimes(1);+ });++ it('cancels and closes the host when the caller aborts', async () => {+ const root = await tempRoot();+ const codexHome = join(root, 'codex-home');+ await mkdir(codexHome, { recursive: true });+ const controller = new AbortController();+ const createHost = fakeHost({ neverCompletes: true });+ const generation = generateCodexNativeImage({+ prompt: 'cat',+ size: '1024x1024',+ quality: 'low',+ cwd: root,+ codexBin: 'codex',+ codexHome,+ signal: controller.signal,+ createHost+ });+ await new Promise(resolve => setTimeout(resolve, 0));+ controller.abort();++ await expect(generation).rejects.toMatchObject({+ code: 'upstream_error',+ message: expect.stringContaining('canceled')+ });+ const host = createHost.mock.results[0]!.value as CodexAppServerHost;+ const execution = (host.run as ReturnType<typeof vi.fn>).mock.results[0]!.value as {+ cancel: ReturnType<typeof vi.fn>;+ };+ expect(execution.cancel).toHaveBeenCalledTimes(1);+ expect(host.close).toHaveBeenCalledTimes(1);+ });+});++let testRoots: string[] = [];++async function tempRoot(): Promise<string> {+ const root = await mkdtemp(join(tmpdir(), 'opencreator-codex-native-'));+ testRoots.push(root);+ return root;+}++function fakeHost(input: {+ savedPath?: string;+ threadId?: string;+ failure?: { message: string };+ neverCompletes?: boolean;+ emitImageItem?: boolean;+ turnStatus?: CodexAppServerResult['turnStatus'];+ createArtifact?: () => Promise<void>;+}) {+ let host!: CodexAppServerHost;+ const createHost = vi.fn((hostInput: CodexAppServerHostInput) => {+ const run = vi.fn((turnInput: CodexAppServerTurnInput) => {+ const cancel = vi.fn();+ const result = input.neverCompletes+ ? new Promise<CodexAppServerResult>(() => undefined)+ : (async () => {+ await turnInput.onThreadStarted?.(input.threadId ?? 'thread-1');+ await input.createArtifact?.();+ if (input.emitImageItem !== false) {+ await turnInput.onNotification?.({+ method: 'item/completed',+ params: {+ item: {+ type: 'imageGeneration',+ id: 'image-1',+ status: input.failure === undefined ? 'completed' : 'failed',+ result: '',+ failure: input.failure ?? null,+ ...(input.savedPath === undefined ? {} : { savedPath: input.savedPath })+ }+ }+ });+ }+ return {+ ...completedResult,+ turnStatus: input.turnStatus ?? completedResult.turnStatus+ };+ })();+ return { cancel, result };+ });+ host = {+ pid: 123,+ started: Promise.resolve(123),+ run,+ isReusable: vi.fn(() => false),+ close: vi.fn(async () => undefined)+ };+ void hostInput;+ return host;+ });+ return createHost;+}++const completedResult: CodexAppServerResult = {+ threadId: 'thread-1',+ turnId: 'turn-1',+ turnStatus: 'completed',+ stderr: '',+ terminationReason: 'completed',+ outputTruncation: {+ stderr: { truncated: false, droppedBytes: 0, droppedItems: 0 },+ frames: { truncated: false, droppedBytes: 0, droppedItems: 0 }+ }+};diff --git a/apps/daemon/test/unit/creator-image-executor.test.ts b/apps/daemon/test/unit/creator-image-executor.test.tsindex 79db344a..5ce433c1 100644--- a/apps/daemon/test/unit/creator-image-executor.test.ts+++ b/apps/daemon/test/unit/creator-image-executor.test.ts@@ -92,6 +92,49 @@ describe('creator image executor', () => {});+ it('runs exactly one candidate for codex-native', async () => {+ tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-codex-native-'));+ const config = createDefaultCreatorServicesConfig();+ const generate = vi.fn(async (request: { provider: ImageGenerationProvider }) => ({+ model: `${request.provider}-model`,+ contents: [{ content: png('image-codex-native'), mime: 'image/png' as const }]+ }));+ const executor = createImageExecutor({+ configStore: { read: async () => config },+ generate: generate as never+ });++ const result = await executor.run(stageInput({+ provider: 'codex-native',+ candidateCount: 1+ }));++ expect(generate).toHaveBeenCalledTimes(1);+ expect(generate).toHaveBeenCalledWith(+ expect.objectContaining({ provider: 'codex-native', count: 1 }),+ config,+ expect.objectContaining({ signal: expect.any(AbortSignal) })+ );+ expect(result.outputs).toHaveLength(1);+ });++ it('rejects multiple candidates for codex-native before starting a host', async () => {+ tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-codex-native-many-'));+ const generate = vi.fn();+ const executor = createImageExecutor({+ configStore: { read: async () => createDefaultCreatorServicesConfig() },+ generate: generate as never+ });++ await expect(executor.run(stageInput({+ provider: 'codex-native',+ candidateCount: 2+ }))).rejects.toMatchObject({+ code: 'unsupported_capability'+ });+ expect(generate).not.toHaveBeenCalled();+ });+it('keeps successful candidates when another candidate fails', async () => {tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-partial-'));let candidate = 0;diff --git a/apps/daemon/test/unit/creator-services-config-store.test.ts b/apps/daemon/test/unit/creator-services-config-store.test.tsindex 1d82434d..f1a8a0d9 100644--- a/apps/daemon/test/unit/creator-services-config-store.test.ts+++ b/apps/daemon/test/unit/creator-services-config-store.test.ts@@ -73,6 +73,33 @@ describe('CreatorServicesConfigStore', () => {});});+ it('persists Codex native image selection without an image API credential', async () => {+ let saved: string | null = null;+ const store = createCreatorServicesConfigStore({+ getPassword: vi.fn(async () => saved),+ setPassword: vi.fn(async value => { saved = value; }),+ deletePassword: vi.fn(async () => { saved = null; })+ });+ const config = createDefaultCreatorServicesConfig();+ config.image.provider = 'codex-native';++ await expect(store.write(config)).resolves.toEqual(config);+ await expect(store.read()).resolves.toEqual(config);++ const presented = presentCreatorServicesConfig(config);+ expect(presented.config.image.provider).toBe('codex-native');+ expect(presented.config.image.codexNative).toEqual({});+ expect(presented.configuredCredentials).not.toEqual(+ expect.arrayContaining([+ 'image.openai.apiKey',+ 'image.jimeng.apiKey',+ 'image.kling.accessKey',+ 'image.kling.secretKey',+ 'image.gemini.apiKey'+ ])+ );+ });+it('stores public settings in config.toml and credentials in credentials.json', async () => {root = mkdtempSync(join(tmpdir(), 'opencreator-creator-services-'));const configFile = join(root, 'config.toml');@@ -236,6 +263,22 @@ describe('CreatorServicesConfigStore', () => {});});+ it('adds the credential-free Codex image defaults when reading an older saved configuration', async () => {+ const legacy = structuredClone(createDefaultCreatorServicesConfig()) as unknown as {+ image: Record<string, unknown>;+ };+ delete legacy.image.codexNative;+ const store = createCreatorServicesConfigStore({+ getPassword: vi.fn(async () => JSON.stringify(legacy)),+ setPassword: vi.fn(async () => undefined),+ deletePassword: vi.fn(async () => undefined)+ });++ await expect(store.read()).resolves.toMatchObject({+ image: { codexNative: {} }+ });+ });+it('preserves older explicitly configured text models as custom', async () => {const legacy = createDefaultCreatorServicesConfig() as unknown as {llm: Record<string, unknown>;diff --git a/apps/daemon/test/unit/image-generation-codex-native.test.ts b/apps/daemon/test/unit/image-generation-codex-native.test.tsnew file mode 100644index 00000000..d8b0ab29--- /dev/null+++ b/apps/daemon/test/unit/image-generation-codex-native.test.ts@@ -0,0 +1,138 @@+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { afterEach, describe, expect, it, vi } from 'vitest';+import { createDefaultCreatorServicesConfig } from '@opencreator/protocol';+import type {+ CodexAppServerHost,+ CodexAppServerResult,+ CodexAppServerTurnInput+} from '../../src/codex/app-server-host-2026-07-28.js';+import { generateImageContents } from '../../src/image-generation/provider.js';++const png = Buffer.from([+ 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,+ 0x00, 0x00, 0x00, 0x00+]);++describe('codex-native provider dispatch', () => {+ let root = '';++ afterEach(async () => {+ if (root) await rm(root, { recursive: true, force: true });+ root = '';+ });++ it('uses the local Codex host and never calls the remote image fetcher', async () => {+ root = await mkdtemp(join(tmpdir(), 'opencreator-native-dispatch-'));+ const codexHome = join(root, 'codex-home');+ const savedPath = join(codexHome, 'generated_images', 'result.png');+ await mkdir(join(codexHome, 'generated_images'), { recursive: true });+ await writeFile(savedPath, png);+ const createHost = fakeHost(savedPath);+ const fetchImpl = vi.fn() as typeof fetch;+ const config = createDefaultCreatorServicesConfig();+ config.image.provider = 'codex-native';++ const result = await generateImageContents({+ prompt: 'an original orange cat',+ provider: 'codex-native',+ size: '1024x1024',+ quality: 'medium',+ count: 1+ }, config, {+ fetchImpl,+ codexNative: {+ codexBin: 'codex',+ codexHome,+ cwd: root,+ createHost+ }+ });++ expect(result).toMatchObject({ model: 'codex-native' });+ expect(result.contents[0]).toMatchObject({ content: png, mime: 'image/png' });+ expect(fetchImpl).not.toHaveBeenCalled();+ expect(createHost).toHaveBeenCalledTimes(1);+ });++ it('rejects native requests for more than one image without starting a host', async () => {+ const config = createDefaultCreatorServicesConfig();+ const createHost = vi.fn();+ config.image.provider = 'codex-native';++ await expect(generateImageContents({+ prompt: 'cat',+ provider: 'codex-native',+ size: '1024x1024',+ quality: 'low',+ count: 2+ }, config, {+ codexNative: {+ codexBin: 'codex',+ codexHome: 'C:\\codex-home',+ cwd: 'C:\\workspace',+ createHost+ }+ })).rejects.toMatchObject({+ code: 'unsupported_capability',+ message: expect.stringContaining('one image')+ });+ expect(createHost).not.toHaveBeenCalled();+ });++ it('reports missing native runtime settings as configuration error without API fallback', async () => {+ const config = createDefaultCreatorServicesConfig();+ config.image.provider = 'codex-native';+ const fetchImpl = vi.fn() as typeof fetch;++ await expect(generateImageContents({+ prompt: 'cat',+ provider: 'codex-native',+ size: '1024x1024',+ quality: 'low',+ count: 1+ }, config, { fetchImpl })).rejects.toMatchObject({+ code: 'config_missing'+ });+ expect(fetchImpl).not.toHaveBeenCalled();+ });+});++function fakeHost(savedPath: string) {+ return vi.fn((): CodexAppServerHost => ({+ pid: 123,+ started: Promise.resolve(123),+ run: vi.fn((input: CodexAppServerTurnInput) => ({+ cancel: vi.fn(),+ result: (async () => {+ await input.onNotification?.({+ method: 'item/completed',+ params: {+ item: {+ type: 'imageGeneration',+ status: 'completed',+ failure: null,+ savedPath+ }+ }+ });+ return completedResult;+ })()+ })),+ isReusable: vi.fn(() => false),+ close: vi.fn(async () => undefined)+ }));+}++const completedResult: CodexAppServerResult = {+ threadId: 'thread-1',+ turnId: 'turn-1',+ turnStatus: 'completed',+ stderr: '',+ terminationReason: 'completed',+ outputTruncation: {+ stderr: { truncated: false, droppedBytes: 0, droppedItems: 0 },+ frames: { truncated: false, droppedBytes: 0, droppedItems: 0 }+ }+};diff --git a/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx b/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsxindex b1bdb09d..e1445f8e 100644--- a/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx+++ b/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx@@ -51,7 +51,8 @@ const providers: Array<{ value: ImageGenerationProvider; zh: string; en: string{ value: 'openai', zh: 'GPT Image', en: 'GPT Image' },{ value: 'jimeng', zh: '即梦', en: 'Jimeng' },{ value: 'kling', zh: '可灵', en: 'Kling' },- { value: 'gemini', zh: 'Gemini', en: 'Gemini' }+ { value: 'gemini', zh: 'Gemini', en: 'Gemini' },+ { value: 'codex-native', zh: 'Codex (订阅)', en: 'Codex (subscription)' }];const samplePromptZh = '一间通透的现代创意工作室,清晨自然光从落地窗照入,桌面有相机、手稿和绿植,真实摄影质感,构图干净,细节丰富';@@ -217,7 +218,9 @@ export default function ImageGenerationWorkspace(props: {function updateProvider(value: ImageGenerationProvider) {setProvider(value);- session?.updateDraft({ provider: value });+ const nextCount = value === 'codex-native' ? 1 : count;+ if (nextCount !== count) setCount(nextCount);+ session?.updateDraft({ provider: value, candidateCount: nextCount });setError('');}@@ -234,6 +237,7 @@ export default function ImageGenerationWorkspace(props: {}function updateCount(value: number) {+ if (provider === 'codex-native' && value !== 1) return;setCount(value);session?.updateDraft({ candidateCount: value });setError('');@@ -487,6 +491,14 @@ export default function ImageGenerationWorkspace(props: {</button>))}</div>+ {provider === 'codex-native' ? (+ <p className="creator-services-inline-note">+ {l(+ 'Codex 订阅模式使用本机已登录的 Codex 生成图像,不调用付费图像 API;每次任务生成 1 张。',+ 'Codex subscription mode uses the signed-in local Codex session, never a paid image API, and generates one image per task.'+ )}+ </p>+ ) : null}</div><div className="media-generation-control"><span>{l('画幅', 'Format')}</span>@@ -513,7 +525,7 @@ export default function ImageGenerationWorkspace(props: {<div className="media-generation-control"><span>{l('生成数量', 'Number of images')}</span><div className="creator-tool-segmented" role="radiogroup" aria-label={l('生成数量', 'Number of images')}>- {[1, 2, 4].map(value => (+ {(provider === 'codex-native' ? [1] : [1, 2, 4]).map(value => (<button type="button" role="radio" aria-checked={count === value} aria-selected={count === value} key={value} onClick={() => updateCount(value)}>{value} {l('张', value === 1 ? 'image' : 'images')}</button>@@ -707,7 +719,7 @@ function readArtifactString(}function readProvider(value: CreatorJson | undefined): ImageGenerationProvider {- return value === 'jimeng' || value === 'kling' || value === 'gemini'+ return value === 'jimeng' || value === 'kling' || value === 'gemini' || value === 'codex-native'? value: 'openai';}diff --git a/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx b/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsxindex 5b41b7f1..3b0f692b 100644--- a/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx+++ b/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx@@ -374,7 +374,8 @@ function createVideoConfig() {openai: { baseUrl: '', apiKey: '', model: '' },jimeng: { baseUrl: '', apiKey: '', model: '' },kling: { baseUrl: '', accessKey: '', secretKey: '', model: '' },- gemini: { baseUrl: '', apiKey: '', model: '' }+ gemini: { baseUrl: '', apiKey: '', model: '' },+ codexNative: {}},video: {provider: 'seedance' as const,diff --git a/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx b/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsxindex 424e61c5..209895ec 100644--- a/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx+++ b/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx@@ -385,6 +385,29 @@ describe('CreatorServicesSettingsView', () => {expect(screen.getByLabelText('默认模型')).toHaveValue('veo-3.1-generate-preview');});+ it('exposes Codex subscription images without API credential controls', async () => {+ const user = userEvent.setup();+ render(+ <CreatorServicesSettingsView+ connected+ service={createService()}+ modelService={createModelService()}+ />+ );+ await screen.findByRole('tabpanel');++ await user.click(screen.getByRole('tab', { name: '图像生成' }));+ await user.click(screen.getByRole('combobox', { name: '服务商' }));+ await user.click(screen.getByRole('option', { name: 'Codex (assinatura)' }));++ expect(screen.getByText(+ '无需 API Key。运行时会通过已登录的 Codex 订阅生成图像,不会调用付费图像 API。'+ )).toBeInTheDocument();+ expect(screen.queryByLabelText('API Key')).not.toBeInTheDocument();+ expect(screen.queryByLabelText('Base URL')).not.toBeInTheDocument();+ expect(screen.queryByLabelText('模型')).not.toBeInTheDocument();+ });+it('keeps non-model services available when the model provider cannot be read', async () => {const modelService = createModelService();vi.mocked(modelService.getCodexProvider).mockRejectedValue(diff --git a/apps/web/src/features/settings/CreatorServicesSettingsView.tsx b/apps/web/src/features/settings/CreatorServicesSettingsView.tsxindex 1c45fb60..0e5c7d99 100644--- a/apps/web/src/features/settings/CreatorServicesSettingsView.tsx+++ b/apps/web/src/features/settings/CreatorServicesSettingsView.tsx@@ -907,7 +907,7 @@ function ImageSettings(props: SettingsGroupProps) {return (<SettingsFieldsettitle={l('图像生成', 'Image generation')}- description={l('配置 GPT Image、即梦、可灵或 Gemini 图像服务。', 'Configure GPT Image, Jimeng, Kling, or Gemini image generation.')}+ description={l('配置 GPT Image、即梦、可灵、Gemini 或本地 Codex 订阅图像生成。', 'Configure GPT Image, Jimeng, Kling, Gemini, or local Codex subscription image generation.')}><SelectFieldid="image-provider"@@ -917,11 +917,13 @@ function ImageSettings(props: SettingsGroupProps) {['openai', 'GPT Image'],['jimeng', l('即梦', 'Jimeng')],['kling', l('可灵', 'Kling')],- ['gemini', 'Gemini']+ ['gemini', 'Gemini'],+ ['codex-native', l('Codex (assinatura)', 'Codex (subscription)')]]}onChange={value => props.update(config => {const nextProvider = value as CreatorServicesConfig['image']['provider'];config.image.provider = nextProvider;+ if (nextProvider === 'codex-native') return;const preset = creatorProviderOfKind('image', nextProvider);const target = config.image[nextProvider];if (preset?.defaultBaseUrl !== undefined && !target.baseUrl) target.baseUrl = preset.defaultBaseUrl;@@ -932,6 +934,14 @@ function ImageSettings(props: SettingsGroupProps) {{provider === 'jimeng' ? <OpenAiFields id="image-jimeng" credential="image.jimeng.apiKey" configuredCredentials={props.configuredCredentials} value={props.config.image.jimeng} modelPlaceholder="doubao-seedream-4-0-250828" modelSuggestions={creatorProviderOfKind('image', 'jimeng')?.models.map(model => model.id)} baseUrlPlaceholder="https://ark.cn-beijing.volces.com/api/v3" onChange={value => props.update(config => { config.image.jimeng = value; })} /> : null}{provider === 'kling' ? <KlingFields id="image-kling" accessKeyCredential="image.kling.accessKey" secretKeyCredential="image.kling.secretKey" configuredCredentials={props.configuredCredentials} value={props.config.image.kling} modelPlaceholder="kling-v2-1" modelSuggestions={creatorProviderOfKind('image', 'kling')?.models.map(model => model.id)} onChange={value => props.update(config => { config.image.kling = value; })} /> : null}{provider === 'gemini' ? <OpenAiFields id="image-gemini" credential="image.gemini.apiKey" configuredCredentials={props.configuredCredentials} value={props.config.image.gemini} modelPlaceholder="gemini-2.5-flash-image" modelSuggestions={creatorProviderOfKind('image', 'gemini')?.models.map(model => model.id)} baseUrlPlaceholder="https://generativelanguage.googleapis.com/v1beta" onChange={value => props.update(config => { config.image.gemini = value; })} /> : null}+ {provider === 'codex-native' ? (+ <p className="creator-services-inline-note">+ {l(+ '无需 API Key。运行时会通过已登录的 Codex 订阅生成图像,不会调用付费图像 API。',+ 'No API key required. The local Runtime uses the signed-in Codex subscription and never calls a paid image API.'+ )}+ </p>+ ) : null}</SettingsFieldset>);}diff --git a/docs/specs/2026-09-19-codex-native-image-provider-design.md b/docs/specs/2026-09-19-codex-native-image-provider-design.mdnew file mode 100644index 00000000..64a3f597--- /dev/null+++ b/docs/specs/2026-09-19-codex-native-image-provider-design.md@@ -0,0 +1,51 @@+# Codex Native Image Provider — Design++> Status: approved for implementation (2026-09-19)+> Scope: experimental local image generation through the authenticated Codex subscription++## Goal++Add a `codex-native` image provider to OpenCreator. It must ask the locally installed Codex CLI/app-server to use its native image-generation capability and import the resulting local artifact into the existing OpenCreator image pipeline.++The provider is explicitly subscription-only. It must not call the OpenAI Images API, any other paid image API, or silently fall back to one.++## Evidence and existing seams++- The user's authenticated Codex CLI generated a PNG and saved it under the Codex generated-images directory without an API key.+- OpenCreator already has a structured Codex app-server host and generated protocol types for an `imageGeneration` item with `savedPath` and `failure` fields. The installed Codex build also demonstrated a compatibility gap: it created the subscription artifact locally but did not expose a matching structured notification to the host callback.+- The existing app-server argv builder disables `image_generation` when its built-in-tool isolation list is supplied. The native provider therefore must use the existing host without that isolation list.++## Architecture++1. Extend the shared image-provider union and provider catalog with `codex-native`.+2. Add a local provider configuration with no credential fields. Runtime-only options are supplied by the daemon: Codex executable, `CODEX_HOME`, workspace directory, and bounded timeout.+3. Implement a small adapter around `createCodexAppServerHost`:+ - start one authenticated app-server host;+ - start a thread and one turn with the requested prompt;+ - instruct the turn to generate exactly one image with the native image tool;+ - prefer `item/completed` and select the `imageGeneration` item;+ - when the installed Codex build omits that notification, snapshot `CODEX_HOME/generated_images` before the turn, scope discovery to the Codex thread directory when available, and import exactly one new valid image artifact created by that turn;+ - require a valid local `savedPath` or an unambiguous new local artifact, then copy the artifact into the normal image result pipeline;+ - close the host and clean up in `finally`.+4. Allow only artifacts inside the request workspace or `CODEX_HOME/generated_images`, with PNG/JPEG/WebP signatures and a bounded file size. Reject file URIs, paths, malformed notifications, missing artifacts, failures, timeouts, and non-zero host exits as local provider errors.+5. Integrate the adapter before remote providers in the existing provider dispatcher. The `codex-native` branch must contain no `fetch`/API-key fallback path.+6. Expose the provider in the shared settings/catalog UI with a clear subscription/local label and no API-key input. Reference-image editing and multi-count generation remain unsupported in this MVP.++## Failure and safety contract++- Missing/invalid Codex executable or home: local configuration/unavailable error.+- Missing/ambiguous local artifact, explicit image-generation failure, timeout, malformed path, invalid image signature, or oversized artifact: local generation error.+- Never log `CODEX_HOME` credentials, tokens, environment contents, or the generated image bytes.+- Never pass `--dangerously-bypass-approvals-and-sandbox`.+- Never invoke a remote image endpoint from the native provider.++## MVP and non-goals++MVP supports one text-to-image request and the existing OpenCreator image result/storage flow. It does not add reference-image editing, multi-image batches, image-to-video, Stickman-specific prompt orchestration, Desktop-only UI, or a new Codex protocol generator. Those can be added after the adapter is stable against the checked-in protocol bindings.++## Acceptance evidence++- Protocol/config/catalog tests prove `codex-native` has no credentials and is selectable.+- Adapter tests use a fake app-server host and cover success, missing/malformed `savedPath`, invalid image bytes, explicit failure, timeout/cancellation, non-zero host failure, and the absence of a paid fallback.+- Existing image-generation and Creator image-executor tests remain green.+- One real smoke test uses the authenticated local Codex session to generate one image and verifies the imported artifact; no API key or paid image endpoint is configured.diff --git a/packages/protocol/src/creator-provider-catalog.test.ts b/packages/protocol/src/creator-provider-catalog.test.tsindex b2387b9a..f8bd8259 100644--- a/packages/protocol/src/creator-provider-catalog.test.ts+++ b/packages/protocol/src/creator-provider-catalog.test.ts@@ -32,7 +32,19 @@ describe('creator provider catalog', () => {});it('marks only implemented providers as supported', () => {- expect(creatorProviderCatalog.every(entry => entry.status === 'supported')).toBe(true);+ expect(creatorProviderCatalog+ .filter(entry => entry.id !== 'codex-native')+ .every(entry => entry.status === 'supported')).toBe(true);expect(creatorProviderCatalogById.image.gemini?.status).toBe('supported');});++ it('describes Codex native image generation as credential-free and experimental', () => {+ expect(creatorProviderCatalogById.image['codex-native']).toMatchObject({+ label: 'Codex (assinatura)',+ protocol: 'local',+ credentials: [],+ capabilities: ['text-to-image'],+ status: 'experimental'+ });+ });});diff --git a/packages/protocol/src/creator-provider-catalog.ts b/packages/protocol/src/creator-provider-catalog.tsindex 17ccd862..900055b3 100644--- a/packages/protocol/src/creator-provider-catalog.ts+++ b/packages/protocol/src/creator-provider-catalog.ts@@ -1,6 +1,6 @@export type CreatorProviderKind = 'llm' | 'image' | 'video' | 'tts' | 'transcription';-export type CreatorProviderProtocol = 'openai-compatible' | 'gemini' | 'kling' | 'custom';-export type CreatorProviderStatus = 'supported' | 'planned';+export type CreatorProviderProtocol = 'openai-compatible' | 'gemini' | 'kling' | 'custom' | 'local';+export type CreatorProviderStatus = 'supported' | 'experimental' | 'planned';export type CreatorProviderCredential = 'apiKey' | 'accessKey' | 'secretKey' | 'region';export type CreatorProviderModel = {@@ -33,6 +33,7 @@ export const creatorProviderCatalog = [entry({ id: 'jimeng', kind: 'image', label: '即梦 / Seedream', protocol: 'openai-compatible', defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3', models: [{ id: 'doubao-seedream-4-0-250828', label: 'Seedream 4.0', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-image'], status: 'supported' }),entry({ id: 'kling', kind: 'image', label: '可灵 / Kling', protocol: 'kling', defaultBaseUrl: 'https://api-beijing.klingai.com', models: [{ id: 'kling-v2-1', label: 'Kling v2.1', recommended: true }], credentials: ['accessKey', 'secretKey'], capabilities: ['text-to-image'], status: 'supported' }),entry({ id: 'gemini', kind: 'image', label: 'Nano Banana / Gemini', protocol: 'gemini', defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta', models: [{ id: 'gemini-2.5-flash-image', label: 'Nano Banana', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-image', 'reference-image'], status: 'supported' }),+ entry({ id: 'codex-native', kind: 'image', label: 'Codex (assinatura)', protocol: 'local', models: [], credentials: [], capabilities: ['text-to-image'], status: 'experimental' }),entry({ id: 'seedance', kind: 'video', label: 'Seedance', protocol: 'openai-compatible', defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3', models: [{ id: 'doubao-seedance-2-5-260628', label: 'Seedance 2.5', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),entry({ id: 'kling-video', kind: 'video', label: '可灵 / Kling', protocol: 'kling', defaultBaseUrl: 'https://api-beijing.klingai.com', models: [{ id: 'kling-v2-1-master', label: 'Kling v2.1 Master', recommended: true }], credentials: ['accessKey', 'secretKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),entry({ id: 'veo', kind: 'video', label: 'Veo', protocol: 'gemini', defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta', models: [{ id: 'veo-3.1-generate-preview', label: 'Veo 3.1', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),diff --git a/packages/protocol/src/creator-services.ts b/packages/protocol/src/creator-services.tsindex 7a2d1ef9..2439ad4b 100644--- a/packages/protocol/src/creator-services.ts+++ b/packages/protocol/src/creator-services.ts@@ -86,11 +86,12 @@ export type CreatorServicesConfig = {aliyun: CreatorTtsProviderConfig;};image: {- provider: 'openai' | 'jimeng' | 'kling' | 'gemini';+ provider: 'openai' | 'jimeng' | 'kling' | 'gemini' | 'codex-native';openai: OpenAiCompatibleConfig;jimeng: OpenAiCompatibleConfig;kling: KlingAiConfig;gemini: OpenAiCompatibleConfig;+ codexNative: Record<never, never>;};video: {provider: 'seedance' | 'kling' | 'veo';@@ -212,7 +213,8 @@ export function createDefaultCreatorServicesConfig(): CreatorServicesConfig {baseUrl: 'https://generativelanguage.googleapis.com/v1beta',apiKey: '',model: 'gemini-2.5-flash-image'- }+ },+ codexNative: {}},video: {provider: 'seedance',diff --git a/packages/protocol/src/media-generation.ts b/packages/protocol/src/media-generation.tsindex 780cbf17..2e586a6f 100644--- a/packages/protocol/src/media-generation.ts+++ b/packages/protocol/src/media-generation.ts@@ -1,7 +1,7 @@export const imageGenerationSizes = ['1024x1024', '1536x1024', '1024x1536'] as const;export type ImageGenerationSize = typeof imageGenerationSizes[number];export type ImageGenerationQuality = 'low' | 'medium' | 'high';-export type ImageGenerationProvider = 'openai' | 'jimeng' | 'kling' | 'gemini';+export type ImageGenerationProvider = 'openai' | 'jimeng' | 'kling' | 'gemini' | 'codex-native';export const coverStyleIds = ['personal-growth',