ai-zero-token 1.0.5 → 1.0.7

package/dist/server/app.js

@@ -77,6 +77,17 @@ const settingsUpdateSchema = z.object({
 const profileActionSchema = z.object({
   profileId: z.string().min(1)
 });
+const profileImportSchema = z.object({
+  profile: z.unknown()
+});
+const profileExportSchema = z.object({
+  profileId: z.string().min(1).optional(),
+  profileIds: z.array(z.string().min(1)).optional(),
+  all: z.boolean().optional()
+});
+const codexApplySchema = z.object({
+  profileId: z.string().min(1)
+});
 const imageGenerationsBodySchema = z.object({
   prompt: z.string().min(1),
   model: z.string().optional(),
@@ -90,6 +101,29 @@ const imageGenerationsBodySchema = z.object({
   response_format: z.enum(["b64_json", "url"]).optional(),
   user: z.string().optional()
 }).passthrough();
+const imageReferenceSchema = z.union([
+  z.string().min(1),
+  z.object({
+    image_url: z.string().min(1).optional(),
+    file_id: z.string().min(1).optional()
+  }).passthrough()
+]);
+const imageEditsBodySchema = z.object({
+  prompt: z.string().min(1),
+  images: z.array(imageReferenceSchema).min(1).max(16).optional(),
+  image: z.union([imageReferenceSchema, z.array(imageReferenceSchema).min(1).max(16)]).optional(),
+  mask: imageReferenceSchema.optional(),
+  model: z.string().optional(),
+  n: z.number().int().positive().optional(),
+  quality: z.enum(["low", "medium", "high", "auto"]).optional(),
+  size: z.string().min(1).optional(),
+  background: z.enum(["transparent", "opaque", "auto"]).optional(),
+  output_format: z.enum(["png", "webp", "jpeg"]).optional(),
+  output_compression: z.number().int().min(0).max(100).optional(),
+  moderation: z.enum(["auto", "low"]).optional(),
+  response_format: z.enum(["b64_json", "url"]).optional(),
+  user: z.string().optional()
+}).passthrough();
 const chatCompletionExcludedKeys = /* @__PURE__ */ new Set([
   "messages",
   "n",
@@ -197,6 +231,46 @@ function summarizeImageRequestForLog(body) {
     user: body.user ?? void 0
   };
 }
+function getImageEditReferences(data) {
+  if (Array.isArray(data.images)) {
+    return data.images;
+  }
+  if (Array.isArray(data.image)) {
+    return data.image;
+  }
+  if (data.image) {
+    return [data.image];
+  }
+  return [];
+}
+function normalizeJsonImageReference(reference) {
+  if (typeof reference === "string") {
+    return {
+      imageUrl: normalizeJsonImageUrl(reference)
+    };
+  }
+  return {
+    imageUrl: reference.image_url ? normalizeJsonImageUrl(reference.image_url) : void 0,
+    fileId: reference.file_id
+  };
+}
+function normalizeJsonImageUrl(value) {
+  const trimmed = value.trim();
+  if (/^https?:\/\//i.test(trimmed) || /^data:image\//i.test(trimmed)) {
+    return trimmed;
+  }
+  if (/^[A-Za-z0-9+/=_-]+$/.test(trimmed) && trimmed.length > 80) {
+    return `data:image/png;base64,${trimmed}`;
+  }
+  return trimmed;
+}
+function summarizeImageEditRequestForLog(body) {
+  return {
+    ...summarizeImageRequestForLog(body),
+    imageCount: getImageEditReferences(body).length,
+    hasMask: Boolean(body.mask)
+  };
+}
 function buildResponseApiBody(result, includeRaw) {
   const responseBody = {
     object: "response",
@@ -258,6 +332,30 @@ function validateImageRequest(data) {
   }
   return null;
 }
+function validateImageEditRequest(data) {
+  const generationValidationError = validateImageRequest(data);
+  if (generationValidationError) {
+    return generationValidationError;
+  }
+  if (data.mask) {
+    return "\u5F53\u524D\u7F51\u5173\u7684 JSON \u7248 images.edits \u6682\u4E0D\u652F\u6301 mask\uFF1B\u8BF7\u5148\u4F7F\u7528\u53C2\u8003\u56FE\u7F16\u8F91\u3002";
+  }
+  const references = getImageEditReferences(data);
+  if (references.length === 0) {
+    return "images.edits \u8BF7\u6C42\u7F3A\u5C11 images \u6216 image\u3002";
+  }
+  const normalized = references.map((reference) => normalizeJsonImageReference(reference));
+  if (normalized.some((reference) => reference.fileId)) {
+    return "\u5F53\u524D\u7F51\u5173\u7684 JSON \u7248 images.edits \u6682\u4E0D\u652F\u6301 file_id\uFF0C\u8BF7\u4F7F\u7528 image_url URL \u6216 base64 data URL\u3002";
+  }
+  if (normalized.some((reference) => !reference.imageUrl)) {
+    return "images.edits \u7684\u6BCF\u4E2A\u56FE\u7247\u5F15\u7528\u90FD\u9700\u8981\u63D0\u4F9B image_url\u3002";
+  }
+  if (normalized.some((reference) => reference.imageUrl && !/^https?:\/\//i.test(reference.imageUrl) && !/^data:image\//i.test(reference.imageUrl))) {
+    return "images.edits \u7684 image_url \u9700\u8981\u662F http(s) URL\u3001data:image/...;base64,...\uFF0C\u6216\u88F8 base64 \u5B57\u7B26\u4E32\u3002";
+  }
+  return null;
+}
 function maskSecret(value) {
   if (value.length <= 12) {
     return value;
@@ -344,14 +442,15 @@ function createApp(params) {
     };
   });
   async function buildAdminConfig(request) {
-    const [status, models, modelCatalog, versionStatus, settings, profile, profiles] = await Promise.all([
+    const [status, models, modelCatalog, versionStatus, settings, profile, profiles, codexStatus] = await Promise.all([
       ctx.authService.getStatus(),
       ctx.modelService.listModels(),
       ctx.modelService.getCatalog(),
       ctx.versionService.getVersionStatus(),
       ctx.configService.getSettings(),
       ctx.authService.getActiveProfile(),
-      ctx.authService.listProfiles()
+      ctx.authService.listProfiles(),
+      ctx.authService.getCodexStatus()
     ]);
     const origin = resolveOrigin(request);
     return {
@@ -362,6 +461,7 @@ function createApp(params) {
       versionStatus,
       profile: serializeProfile(profile),
       profiles: profiles.map((item) => serializeManagedProfile(item)),
+      codex: codexStatus,
       adminUrl: `${origin}/`,
       baseUrl: `${origin}/v1`,
       supportedEndpoints: [
@@ -384,6 +484,11 @@ function createApp(params) {
           method: "POST",
           path: "/v1/images/generations",
           description: "OpenAI images.generations \u517C\u5BB9\u63A5\u53E3\u3002"
+        },
+        {
+          method: "POST",
+          path: "/v1/images/edits",
+          description: "OpenAI images.edits JSON \u517C\u5BB9\u63A5\u53E3\u3002"
         }
       ]
     };
@@ -467,6 +572,65 @@ function createApp(params) {
     await ctx.authService.removeProfile(parsed.data.profileId);
     return buildAdminConfig(request);
   });
+  app.post("/_gateway/admin/profiles/import", async (request, reply) => {
+    const parsed = profileImportSchema.safeParse(request.body);
+    if (!parsed.success) {
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+        }
+      };
+    }
+    const importedProfiles = await ctx.authService.importProfiles(parsed.data.profile);
+    await ctx.authService.syncActiveProfileQuota("openai-codex", {
+      suppressErrors: true
+    });
+    return {
+      ...await buildAdminConfig(request),
+      importedProfileCount: importedProfiles.length
+    };
+  });
+  app.get("/_gateway/admin/profiles/import-template", async () => ({
+    profile: ctx.authService.getProfileImportTemplate()
+  }));
+  app.post("/_gateway/admin/profiles/export", async (request, reply) => {
+    const parsed = profileExportSchema.safeParse(request.body ?? {});
+    if (!parsed.success) {
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+        }
+      };
+    }
+    if (parsed.data.all || parsed.data.profileIds) {
+      return {
+        profile: await ctx.authService.exportProfiles(parsed.data.profileIds)
+      };
+    }
+    return {
+      profile: await ctx.authService.exportProfile(parsed.data.profileId)
+    };
+  });
+  app.post("/_gateway/admin/codex/apply", async (request, reply) => {
+    const parsed = codexApplySchema.safeParse(request.body);
+    if (!parsed.success) {
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+        }
+      };
+    }
+    return {
+      codex: await ctx.authService.applyProfileToCodex(parsed.data.profileId),
+      config: await buildAdminConfig(request)
+    };
+  });
   app.put("/_gateway/admin/settings", async (request, reply) => {
     const parsed = settingsUpdateSchema.safeParse(request.body);
     if (!parsed.success) {
@@ -682,6 +846,96 @@ function createApp(params) {
     });
     return response;
   });
+  app.post("/v1/images/edits", async (request, reply) => {
+    const contentType = request.headers["content-type"] ?? "";
+    if (!String(contentType).toLowerCase().includes("application/json")) {
+      reply.code(415);
+      return {
+        error: {
+          type: "unsupported_media_type",
+          message: "\u5F53\u524D\u7F51\u5173\u4EC5\u652F\u6301 JSON \u7248 images.edits\uFF1B\u8BF7\u4F7F\u7528 application/json\uFF0C\u5E76\u901A\u8FC7 images[].image_url \u4F20 URL \u6216 base64 data URL\u3002"
+        }
+      };
+    }
+    const parsed = imageEditsBodySchema.safeParse(request.body);
+    if (!parsed.success) {
+      console.error("[gateway:image:edit] validation failure", {
+        method: request.method,
+        url: request.url,
+        issue: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+      });
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+        }
+      };
+    }
+    const validationError = validateImageEditRequest(parsed.data);
+    if (validationError) {
+      console.error("[gateway:image:edit] validation failure", {
+        method: request.method,
+        url: request.url,
+        summary: summarizeImageEditRequestForLog(parsed.data),
+        issue: validationError
+      });
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: validationError
+        }
+      };
+    }
+    if (typeof parsed.data.n === "number" && parsed.data.n > 1) {
+      console.error("[gateway:image:edit] not supported", {
+        method: request.method,
+        url: request.url,
+        summary: summarizeImageEditRequestForLog(parsed.data),
+        issue: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.edits \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
+      });
+      reply.code(501);
+      return {
+        error: {
+          type: "not_supported",
+          message: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.edits \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
+        }
+      };
+    }
+    const imageReferences = getImageEditReferences(parsed.data).map((reference) => normalizeJsonImageReference(reference)).map((reference) => ({
+      imageUrl: reference.imageUrl ?? ""
+    }));
+    const requestSummary = summarizeImageEditRequestForLog(parsed.data);
+    console.info("[gateway:image:edit] request accepted", {
+      method: request.method,
+      url: request.url,
+      summary: requestSummary
+    });
+    const response = await ctx.imageService.generate({
+      prompt: parsed.data.prompt,
+      inputImages: imageReferences,
+      model: parsed.data.model,
+      n: parsed.data.n,
+      size: parsed.data.size,
+      quality: parsed.data.quality,
+      background: parsed.data.background,
+      outputFormat: parsed.data.output_format,
+      outputCompression: parsed.data.output_compression,
+      moderation: parsed.data.moderation
+    });
+    console.info("[gateway:image:edit] response ready", {
+      method: request.method,
+      url: request.url,
+      summary: requestSummary,
+      created: response.created,
+      imageCount: response.data.length,
+      output_format: response.output_format,
+      quality: response.quality,
+      size: response.size
+    });
+    return response;
+  });
   return app;
 }
 export {

package/docs/API_USAGE.md

@@ -91,6 +91,25 @@ curl http://127.0.0.1:8787/v1/images/generations \
   }'
 ```
 
+JSON image edit with a reference image URL or base64 data URL:
+
+```bash
+curl http://127.0.0.1:8787/v1/images/edits \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-image-2",
+    "prompt": "Use this reference image and make it look like a clean product advertisement.",
+    "images": [
+      {
+        "image_url": "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64"
+      }
+    ],
+    "size": "1024x1024",
+    "quality": "low",
+    "response_format": "b64_json"
+  }'
+```
+
 ## JavaScript SDK Example
 
 ```ts
@@ -117,4 +136,3 @@ console.log(response.choices[0]?.message?.content);
 - A model appearing in `/v1/models` means the local Codex cache lists it. Final availability still depends on the active account.
 - `stream=true` is not supported yet.
 - The default listener is `0.0.0.0:8787`, so local-network clients can call the gateway by using the machine IP.
-

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-zero-token",
-  "version": "1.0.5",
-  "description": "Local-first OpenAI-compatible AI CLI and gateway with Codex OAuth, multi-account management, and gpt-image-2 image generation.",
+  "version": "1.0.7",
+  "description": "Local-first OpenAI-compatible AI CLI and gateway with Codex OAuth, multi-account management, and gpt-image-2 image generation/editing.",
   "license": "MIT",
   "type": "module",
   "repository": {