ai-zero-token 1.0.2 → 1.0.3

package/dist/server/app.js

@@ -298,7 +298,11 @@ function normalizeError(error) {
   return error instanceof Error ? error : new Error(String(error));
 }
 function getErrorStatusCode(error) {
-  const message = normalizeError(error).message;
+  const normalized = normalizeError(error);
+  if (typeof normalized.statusCode === "number") {
+    return normalized.statusCode;
+  }
+  const message = normalized.message;
   if (message.includes("\u7F3A\u5C11") || message.includes("\u683C\u5F0F\u9519\u8BEF") || message.includes("\u672A\u5185\u7F6E\u6A21\u578B") || message.includes("\u4E0D\u652F\u6301") || message.includes("\u6CA1\u6709\u63D0\u4F9B")) {
     return 400;
   }
@@ -335,9 +339,11 @@ function createApp(params) {
     };
   });
   async function buildAdminConfig(request) {
-    const [status, models, settings, profile, profiles] = await Promise.all([
+    const [status, models, modelCatalog, versionStatus, settings, profile, profiles] = await Promise.all([
       ctx.authService.getStatus(),
       ctx.modelService.listModels(),
+      ctx.modelService.getCatalog(),
+      ctx.versionService.getVersionStatus(),
       ctx.configService.getSettings(),
       ctx.authService.getActiveProfile(),
       ctx.authService.listProfiles()
@@ -347,6 +353,8 @@ function createApp(params) {
       status,
       settings,
       models,
+      modelCatalog,
+      versionStatus,
       profile: serializeProfile(profile),
       profiles: profiles.map((item) => serializeManagedProfile(item)),
       adminUrl: `${origin}/`,
@@ -386,11 +394,33 @@ function createApp(params) {
   app.get("/_gateway/health", async () => ({ ok: true }));
   app.get("/_gateway/status", async () => ctx.authService.getStatus());
   app.get("/_gateway/models", async () => ({
-    data: await ctx.modelService.listModels()
+    data: await ctx.modelService.listModels(),
+    catalog: await ctx.modelService.getCatalog()
   }));
+  app.post("/_gateway/models/refresh", async () => {
+    const result = await ctx.modelService.refreshModels();
+    return {
+      data: result.models,
+      catalog: result.catalog
+    };
+  });
+  app.post("/_gateway/admin/runtime-refresh", async (request) => {
+    await Promise.all([
+      ctx.authService.syncActiveProfileQuota("openai-codex", {
+        suppressErrors: true
+      }),
+      ctx.versionService.getVersionStatus({
+        force: true
+      })
+    ]);
+    return buildAdminConfig(request);
+  });
   app.get("/_gateway/admin/config", async (request) => buildAdminConfig(request));
   app.post("/_gateway/admin/login", async (request) => {
     await ctx.authService.login("openai-codex");
+    await ctx.authService.syncActiveProfileQuota("openai-codex", {
+      suppressErrors: true
+    });
     return buildAdminConfig(request);
   });
   app.post("/_gateway/admin/logout", async (request) => {
@@ -409,6 +439,13 @@ function createApp(params) {
       };
     }
     await ctx.authService.activateProfile(parsed.data.profileId);
+    await ctx.authService.syncActiveProfileQuota("openai-codex", {
+      suppressErrors: true
+    });
+    return buildAdminConfig(request);
+  });
+  app.post("/_gateway/admin/profiles/sync-quota", async (request) => {
+    await ctx.authService.syncActiveProfileQuota("openai-codex");
     return buildAdminConfig(request);
   });
   app.post("/_gateway/admin/profiles/remove", async (request, reply) => {

package/docs/API_USAGE.md

@@ -0,0 +1,120 @@
+# AI Zero Token API Usage
+
+This guide is for Vibe Coding tools, OpenAI-compatible SDKs, local frontends, and scripts that need to call AI Zero Token through HTTP.
+
+## Base URL
+
+Start the local gateway:
+
+```bash
+azt start
+```
+
+Default API base URL:
+
+```text
+http://127.0.0.1:8787/v1
+```
+
+For another device on the same network, replace `127.0.0.1` with the gateway machine IP.
+
+## Auth
+
+The local gateway does not require an API key by default.
+
+Most OpenAI-compatible clients still require a non-empty key value. Use a placeholder:
+
+```text
+local
+```
+
+## Vibe Coding Settings
+
+Use these values in an OpenAI-compatible provider setup:
+
+```text
+API Base URL: http://127.0.0.1:8787/v1
+API Key: local
+Text model: gpt-5.4
+Image model: gpt-image-2
+```
+
+Use `GET /v1/models` to see the models available through the current local Codex cache.
+
+## Models
+
+```bash
+curl http://127.0.0.1:8787/v1/models
+```
+
+Refresh the local Codex model list:
+
+```bash
+azt models --refresh
+```
+
+## Responses API
+
+```bash
+curl http://127.0.0.1:8787/v1/responses \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-5.4",
+    "input": "Reply with OK only."
+  }'
+```
+
+## Chat Completions API
+
+```bash
+curl http://127.0.0.1:8787/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-5.4",
+    "messages": [
+      { "role": "user", "content": "Reply with OK only." }
+    ]
+  }'
+```
+
+## Images API
+
+```bash
+curl http://127.0.0.1:8787/v1/images/generations \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-image-2",
+    "prompt": "A clean product poster on a white desk with a laptop and glass cup.",
+    "size": "1024x1024",
+    "quality": "low",
+    "response_format": "b64_json"
+  }'
+```
+
+## JavaScript SDK Example
+
+```ts
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  apiKey: "local",
+  baseURL: "http://127.0.0.1:8787/v1",
+});
+
+const response = await client.chat.completions.create({
+  model: "gpt-5.4",
+  messages: [
+    { role: "user", content: "Reply with OK only." },
+  ],
+});
+
+console.log(response.choices[0]?.message?.content);
+```
+
+## Notes
+
+- Login first through the management page or `azt login`.
+- 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,6 +1,6 @@
 {
   "name": "ai-zero-token",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Local-first OpenAI-compatible AI CLI and gateway with Codex OAuth, multi-account management, and gpt-image-2 image generation.",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,8 @@
   },
   "files": [
     "dist",
+    "CHANGELOG.md",
+    "docs/API_USAGE.md",
     "README.md",
     "package.json"
   ]