@atmorouter/helper 0.2.0 → 0.2.2

package/README.md

@@ -5,14 +5,14 @@ Configure coding agents for AtmoRouter, get IDE setup instructions, discover mod
 Requires Node.js 22 or newer. The public npm package uses the `yaml` runtime dependency to safely parse and preserve YAML configuration. No npm account or repository access is required.
 
 ```sh
-npx @atmorouter/helper@0.2.0 --help
-npx @atmorouter/helper@0.2.0 targets
-npx @atmorouter/helper@0.2.0 models --search claude
-npx @atmorouter/helper@0.2.0 configure --target opencode --model YOUR_MODEL_ID
-npx @atmorouter/helper@0.2.0 configure --target claude --model YOUR_MODEL_ID --write
+npx @atmorouter/helper@0.2.2 --help
+npx @atmorouter/helper@0.2.2 targets
+npx @atmorouter/helper@0.2.2 models --search claude
+npx @atmorouter/helper@0.2.2 configure --target opencode --model YOUR_MODEL_ID
+npx @atmorouter/helper@0.2.2 configure --target claude --model YOUR_MODEL_ID --write
 ```
 
-The same version is available as `https://atmorouter.dev/downloads/atmorouter-helper-0.2.0.tgz`, with a `.sha256` checksum alongside it. Run it with `npx https://atmorouter.dev/downloads/atmorouter-helper-0.2.0.tgz --help`.
+The same version is available as `https://atmorouter.dev/downloads/atmorouter-helper-0.2.2.tgz`, with a `.sha256` checksum alongside it. Run it with `npx https://atmorouter.dev/downloads/atmorouter-helper-0.2.2.tgz --help`.
 
 With no command, the interactive wizard searches live text models and previews the selected setup. `configure` is preview-only unless `--write` is supplied. Non-interactive file writes additionally require `--yes`. Tests use temporary `--config-dir` folders, never real agent settings.
 
@@ -42,10 +42,10 @@ The helper never saves or prints your API key. Set `ATMOROUTER_API_KEY` privatel
 
 ```sh
 export ANTHROPIC_AUTH_TOKEN="$ATMOROUTER_API_KEY"
-npx @atmorouter/helper@0.2.0 check-key
+npx @atmorouter/helper@0.2.2 check-key
 ```
 
-`GET /v1/models` is public and **cannot validate a key**. The optional explicit key check sends an empty JSON body to `/v1/chat/completions`. Only HTTP 400 with `model is required` proves the gateway accepted the credential before rejecting the body. No model is selected, no inference is forwarded, and nothing is billed. The check consumes a rate-limit slot. HTTP 401 rejects the key; 429 and all other responses are inconclusive. Requests have a 15-second timeout and refuse redirects. No custom upstream origin can receive your key.
+`GET /v1/models` is public and **cannot validate a key**. The optional explicit key check sends an empty JSON body to `/v1/chat/completions`. Only HTTP 400 with `model is required` proves the gateway accepted the credential before rejecting the body. No model is selected, no inference is forwarded, and nothing is billed. The check consumes a rate-limit slot. HTTP 401 rejects the key; 429 and all other responses are inconclusive. The key-check request has a 15-second timeout and refuse redirects. Catalog discovery has a 30-second timeout. No custom upstream origin can receive your key.
 
 ## Codex local bridge
 
@@ -53,13 +53,13 @@ The public gateway implements Chat Completions and Anthropic Messages, not `/v1/
 
 ```sh
 # Prints instructions only; does not start a server or write Codex settings.
-npx @atmorouter/helper@0.2.0 configure --target codex --model YOUR_MODEL_ID
+npx @atmorouter/helper@0.2.2 configure --target codex --model YOUR_MODEL_ID
 
 # Starts a temporary local bridge and launches your installed Codex CLI.
-npx @atmorouter/helper@0.2.0 codex --model YOUR_MODEL_ID
+npx @atmorouter/helper@0.2.2 codex --model YOUR_MODEL_ID
 
 # Or run the bridge separately and follow its printed client instructions.
-npx @atmorouter/helper@0.2.0 bridge --port 43187
+npx @atmorouter/helper@0.2.2 bridge --port 43187
 ```
 
 Set `ATMOROUTER_API_KEY` in the process environment before starting the bridge. It listens on loopback only, authenticates local requests, and forwards inference to the official AtmoRouter endpoint. The launcher preserves Codex's permission defaults. It does not weaken approvals or sandbox settings.

package/bin/atmorouter-helper.mjs

@@ -5,9 +5,14 @@ import {readFile} from 'node:fs/promises';
 import fs from 'node:fs';
 import path from 'node:path';
 import {spawn} from 'node:child_process';
+import {setDefaultResultOrder} from 'node:dns';
 import {models,modelId,checkKey,planConfiguration,writeConfiguration,environment,INTEGRATIONS,guidedConfiguration} from '../lib/helper.mjs';
 import {startResponsesBridge} from '../lib/bridge.mjs';
 
+// Prefer IPv4 when both families are advertised; IPv6-only DNS still works.
+// This affects this CLI process only, including the bridge's outbound requests.
+setDefaultResultOrder('ipv4first');
+
 const HELP=`AtmoRouter helper
 Node.js 22+.
 
@@ -137,7 +142,7 @@ async function main(){
 }
 main().catch(error=>{
   let message=String(error?.message || 'Operation failed.');
-  if(error?.code?.startsWith('ERR_PARSE_ARGS'))message='Unknown or unsupported command options. Do not pass API keys as arguments. Run --help.';
+  if(typeof error?.code==='string'&&error.code.startsWith('ERR_PARSE_ARGS'))message='Unknown or unsupported command options. Do not pass API keys as arguments. Run --help.';
   else if(error instanceof SyntaxError)message='Unexpected catalog JSON. Try again later.';
   else if(error instanceof TypeError || error?.name==='TimeoutError')message='Network operation failed. Check connectivity and retry.';
   if(process.env.ATMOROUTER_API_KEY)message=message.split(process.env.ATMOROUTER_API_KEY).join('[redacted]');

package/lib/helper.mjs

@@ -12,11 +12,11 @@ export function modelId(value) {
   return value;
 }
 export async function models(fetcher = fetch) {
-  const response = await fetcher(ORIGIN+'/v1/models', {redirect:'error',signal:AbortSignal.timeout(15000)});
+  const response = await fetcher(ORIGIN+'/v1/models', {redirect:'error',signal:AbortSignal.timeout(30000)});
   if (!response.ok) throw Error('Catalog request failed: HTTP '+response.status);
   const body = await response.json();
   if (!Array.isArray(body.data)) throw Error('Unexpected catalog response.');
-  return body.data.filter(m => typeof m.id === 'string' && (!m.modality || ['text','chat','multimodal'].includes(m.modality.toLowerCase()))).map(m => ({...m,id:modelId(m.id)}));
+  return body.data.filter(m => typeof m.id === 'string' && (!m.modality || (typeof m.modality==='string' && m.modality.toLowerCase().split(/[,\s+/]+/).some(part=>['text','chat','multimodal'].includes(part))))).map(m => ({...m,id:modelId(m.id)}));
 }
 export async function checkKey(key, fetcher = fetch) {
   if (typeof key!=='string' || key.length!==51 || !/^ar-[a-f0-9]{48}$/.test(key)) throw Error('Set ATMOROUTER_API_KEY to your full ar- key. Do not pass secrets as command arguments.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atmorouter/helper",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Configure AtmoRouter coding agents, guide IDE setup, and run a local Codex bridge",
   "homepage": "https://atmorouter.dev/docs/helper",
   "keywords": [