@autotask/atools-tool 0.1.4 → 0.1.6

package/README.md

@@ -68,10 +68,14 @@ atools-tool-install --help
 - macOS: launchd user agent (`~/Library/LaunchAgents`)
 - Windows: Task Scheduler user task (ONLOGON + start now)
 
+By default, installer enables proxy model rewrite:
+
+- force outbound model to `gpt-5.3-codex` (for codex-only upstream compatibility)
+
 ## Proxy Command
 
 ```bash
-atools-tool serve --port 18888 --upstream https://sub2api.atools.live
+atools-tool serve --port 18888 --upstream https://sub2api.atools.live --force-model gpt-5.3-codex
 ```
 
 ## Repo Install

package/bin/cli.mjs

@@ -8,6 +8,7 @@ function parseArgs(argv) {
     openclawHome: undefined,
     port: undefined,
     upstream: undefined,
+    forceModel: undefined,
     maxReqBytes: undefined,
     logFile: undefined,
     retryMax: undefined,
@@ -25,6 +26,7 @@ function parseArgs(argv) {
     if (a === '--port') out.port = Number(next());
     else if (a === '--openclaw-home') out.openclawHome = next();
     else if (a === '--upstream') out.upstream = next();
+    else if (a === '--force-model') out.forceModel = next();
     else if (a === '--max-req-bytes') out.maxReqBytes = Number(next());
     else if (a === '--log-file') out.logFile = next();
     else if (a === '--retry-max') out.retryMax = Number(next());
@@ -50,6 +52,7 @@ Options:
   --openclaw-home <path> OpenClaw home dir (default: ~/.openclaw)
   --port <number>          Listen port (default: 18888)
   --upstream <url>         Upstream base URL (default: https://sub2api.atools.live)
+  --force-model <id>       Force outbound model id (e.g. gpt-5.3-codex)
   --max-req-bytes <number> Compact requests larger than this threshold (default: 68000)
   --log-file <path>        Log file (default: /tmp/openclaw/atools-compat-proxy.log)
   --retry-max <number>     Retry attempts on 5xx for /responses (default: 6)

package/lib/config-openclaw.mjs

@@ -16,6 +16,7 @@ const PROXY_HOST = '127.0.0.1';
 const PROXY_PORT = 18888;
 const PROXY_BASE_URL = `http://${PROXY_HOST}:${PROXY_PORT}/v1`;
 const PROXY_UPSTREAM = 'https://sub2api.atools.live';
+const PROXY_FORCE_MODEL = 'gpt-5.3-codex';
 const PROXY_LOG_FILE = path.join(os.tmpdir(), 'openclaw', 'atools-compat-proxy.log');
 const PROXY_SERVICE = 'openclaw-atools-proxy.service';
 
@@ -266,6 +267,7 @@ function configureLinuxProxyService() {
   const original = fs.readFileSync(servicePath, 'utf8');
   let next = original;
   next = upsertEnvLine(next, 'SUB2API_UPSTREAM', PROXY_UPSTREAM);
+  next = upsertEnvLine(next, 'SUB2API_COMPAT_FORCE_MODEL', PROXY_FORCE_MODEL);
   next = upsertEnvLine(next, 'SUB2API_COMPAT_DROP_TOOLS_ON_COMPACT', '0');
   next = upsertEnvLine(next, 'SUB2API_COMPAT_PORT', String(PROXY_PORT));
   next = upsertEnvLine(next, 'SUB2API_COMPAT_LOG', PROXY_LOG_FILE);
@@ -315,7 +317,8 @@ function startDetachedProxy() {
         stdio: 'ignore',
         env: {
           ...process.env,
-          SUB2API_UPSTREAM: PROXY_UPSTREAM
+          SUB2API_UPSTREAM: PROXY_UPSTREAM,
+          SUB2API_COMPAT_FORCE_MODEL: PROXY_FORCE_MODEL
         }
       }
     );

package/lib/install.mjs

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 
 const DEFAULT_PROVIDER = 'sub2api';
 const DEFAULT_MODEL = 'gpt-5.3-codex';
+const DEFAULT_FORCE_MODEL = 'gpt-5.3-codex';
 const DEFAULT_PORT = 18888;
 const DEFAULT_UPSTREAM = 'https://sub2api.atools.live';
 const DEFAULT_LOG_FILE = path.join(os.tmpdir(), 'openclaw', 'atools-compat-proxy.log');
@@ -50,7 +51,7 @@ function defaultServiceId(name = DEFAULT_SERVICE_NAME) {
   return String(name || DEFAULT_SERVICE_NAME).replace(/\.service$/i, '');
 }
 
-function buildProxyServeArgs({ port, upstream, maxReqBytes, logFile }) {
+function buildProxyServeArgs({ port, upstream, forceModel, maxReqBytes, logFile }) {
   const args = [
     'serve',
     '--port',
@@ -62,6 +63,9 @@ function buildProxyServeArgs({ port, upstream, maxReqBytes, logFile }) {
     '--max-req-bytes',
     String(maxReqBytes)
   ];
+  if (forceModel) {
+    args.push('--force-model', String(forceModel));
+  }
   return args;
 }
 
@@ -85,6 +89,7 @@ function parseArgs(argv) {
     openclawHome: process.env.OPENCLAW_HOME || path.join(os.homedir(), '.openclaw'),
     provider: DEFAULT_PROVIDER,
     model: DEFAULT_MODEL,
+    forceModel: DEFAULT_FORCE_MODEL,
     port: DEFAULT_PORT,
     upstream: DEFAULT_UPSTREAM,
     maxReqBytes: 68000,
@@ -102,6 +107,7 @@ function parseArgs(argv) {
     if (a === '--openclaw-home') out.openclawHome = next();
     else if (a === '--provider') out.provider = next();
     else if (a === '--model') out.model = next();
+    else if (a === '--force-model') out.forceModel = next();
     else if (a === '--port') out.port = Number(next());
     else if (a === '--upstream') out.upstream = next();
     else if (a === '--max-req-bytes') out.maxReqBytes = Number(next());
@@ -249,9 +255,10 @@ function patchOpenclawConfig(openclawHome, provider, model, port, dryRun) {
 
 function patchAgentModels(openclawHome, provider, model, port, apiKey, dryRun) {
   const modelsPath = path.join(openclawHome, 'agents/main/agent/models.json');
-  const models = readJsonIfExists(modelsPath);
-  if (!models) {
-    throw new Error(`missing agent models config: ${modelsPath}`);
+  const models = readJsonIfExists(modelsPath) || { providers: {} };
+  const creatingNewModelsFile = !fs.existsSync(modelsPath);
+  if (creatingNewModelsFile) {
+    info(`agent models config not found, will create: ${modelsPath}`);
   }
 
   const baseUrl = `http://127.0.0.1:${port}/v1`;
@@ -293,6 +300,7 @@ function patchAgentModels(openclawHome, provider, model, port, apiKey, dryRun) {
     info(`dry-run: would patch ${modelsPath}`);
     return;
   }
+  ensureDir(path.dirname(modelsPath));
   const bak = backup(modelsPath);
   if (bak) info(`backup created: ${bak}`);
   writeJson(modelsPath, models);
@@ -478,6 +486,7 @@ Options:
   --openclaw-home <path>   Default: ~/.openclaw
   --provider <name>        Default: sub2api
   --model <id>             Default: gpt-5.3-codex
+  --force-model <id>       Default: gpt-5.3-codex (proxy rewrites outbound model)
   --port <number>          Default: 18888
   --upstream <url>         Default: https://sub2api.atools.live
   --max-req-bytes <number> Default: 68000
@@ -504,6 +513,7 @@ export async function runInstall(rawArgs = process.argv.slice(2)) {
   const serveArgs = buildProxyServeArgs({
     port: args.port,
     upstream: args.upstream,
+    forceModel: args.forceModel,
     maxReqBytes: args.maxReqBytes,
     logFile: args.logFile
   });
@@ -511,6 +521,7 @@ export async function runInstall(rawArgs = process.argv.slice(2)) {
   info(`openclawHome=${args.openclawHome}`);
   info(`platform=${process.platform}`);
   info(`provider/model=${args.provider}/${args.model}`);
+  info(`proxy forceModel=${args.forceModel || '(disabled)'}`);
   info(`proxy=http://127.0.0.1:${args.port}/v1 -> ${args.upstream}`);
 
   patchOpenclawConfig(args.openclawHome, args.provider, args.model, args.port, args.dryRun);

package/lib/proxy-server.mjs

@@ -9,6 +9,7 @@ const DEFAULT_USER_AGENT = 'codex_cli_rs/0.101.0 (Ubuntu 24.4.0; x86_64) Windows
 const DEFAULT_MAX_REQ_BYTES = 68000;
 const DEFAULT_DROP_TOOLS_ON_COMPACT = false;
 const DEFAULT_STRIP_PREVIOUS_RESPONSE_ID = false;
+const DEFAULT_FORCE_MODEL = '';
 
 function ensureParentDir(filePath) {
   const dir = path.dirname(filePath);
@@ -54,13 +55,19 @@ function normalizeContent(content) {
   return [toInputText('')];
 }
 
-function normalizeResponsesPayload(payload, { stripPreviousResponseId = DEFAULT_STRIP_PREVIOUS_RESPONSE_ID } = {}) {
+function normalizeResponsesPayload(payload, {
+  stripPreviousResponseId = DEFAULT_STRIP_PREVIOUS_RESPONSE_ID,
+  forceModel = DEFAULT_FORCE_MODEL
+} = {}) {
   if (!payload || typeof payload !== 'object') return payload;
   const out = { ...payload };
 
   if (stripPreviousResponseId && 'previous_response_id' in out) {
     delete out.previous_response_id;
   }
+  if (forceModel) {
+    out.model = forceModel;
+  }
 
   if (typeof out.input === 'string') {
     out.input = [{ role: 'user', content: normalizeContent(out.input) }];
@@ -166,6 +173,7 @@ export async function createProxyServer(options = {}) {
     ?? ['1', 'true', 'yes', 'on'].includes(String(process.env.SUB2API_COMPAT_DROP_TOOLS_ON_COMPACT || '').toLowerCase());
   const stripPreviousResponseId = options.stripPreviousResponseId
     ?? ['1', 'true', 'yes', 'on'].includes(String(process.env.SUB2API_COMPAT_STRIP_PREVIOUS_RESPONSE_ID || '').toLowerCase());
+  const forceModel = String(options.forceModel ?? process.env.SUB2API_COMPAT_FORCE_MODEL ?? '').trim();
 
   const server = http.createServer(async (req, res) => {
     const startAt = Date.now();
@@ -189,7 +197,12 @@ export async function createProxyServer(options = {}) {
       if (isResponsesPath && rawBody.length > 0) {
         try {
           const parsed = JSON.parse(rawBody.toString('utf8'));
-          const normalized = normalizeResponsesPayload(parsed, { stripPreviousResponseId });
+          const inputModel = typeof parsed.model === 'string' ? parsed.model : '';
+          const normalized = normalizeResponsesPayload(parsed, {
+            stripPreviousResponseId,
+            forceModel
+          });
+          const outputModel = typeof normalized.model === 'string' ? normalized.model : '';
           body = Buffer.from(JSON.stringify(normalized));
           if (body.length > maxReqBytes) {
             const compacted = compactResponsesPayload(normalized, { dropToolsOnCompact });
@@ -214,6 +227,13 @@ export async function createProxyServer(options = {}) {
               minimalBody = minimalBuf;
             }
           }
+          if (forceModel && inputModel && inputModel !== outputModel) {
+            appendLog(logFile, {
+              method: req.method,
+              path: url.pathname,
+              modelRewrite: { from: inputModel, to: outputModel }
+            });
+          }
         } catch {
           // Keep original body if parse fails.
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autotask/atools-tool",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ATools CLI for OpenClaw proxy compatibility and interactive model configuration",
   "type": "module",
   "license": "MIT",