@autonoelle/wsg-active 0.1.0

package/README.md

@@ -0,0 +1,169 @@
+# AutoNoelle WSG Active CLI
+
+面向脚本和 AI Agent 的账号查询、用户配置、Store、会话与任务控制 CLI。公开舰船、装备、地图、路线和掉落查询请使用相邻的 `autonoelle-wsg-gamedata-cli`。
+
+完整的 ID 映射、配置字段、自然语言示例、安全写入和恢复流程见 [`../AI_AGENT_GUIDE.md`](../AI_AGENT_GUIDE.md)。
+
+## 安装与检查
+
+需要 Node.js 18 或更高版本。
+
+```bash
+npm install
+npm run check
+npm run build
+npm test
+node dist/index.js --help
+```
+
+## 连接与认证
+
+| 全局选项 | 环境变量 | 默认值 |
+| --- | --- | --- |
+| `--query-url <url>` | `AUTO_NOELLE_QUERY_URL` | `https://query.auto.noelle.cool/UserConfig` |
+| `--active-url <url>` | `AUTO_NOELLE_ACTIVE_URL` | `https://api.auto.noelle.cool` |
+| `--data-url <url>` | `AUTO_NOELLE_DATA_URL` | `https://data.auto.noelle.cool/GameData` |
+| `--scope <scope>` | `AUTO_NOELLE_SCOPE` | `CN` |
+| `--k <key>` | `AUTO_NOELLE_USER_KEY` | 无 |
+| `--timeout <ms>` | `AUTO_NOELLE_TIMEOUT_MS` | `15000` |
+
+后端登录响应的历史字段 `accessToken` 实际包含确定性的 AutoNoelle user key，而不是游戏内部 access token。CLI 输出会将它脱敏。
+
+```bash
+autonoelle-wsg-active auth login \
+  --username <用户名> \
+  --password <密码> \
+  --servername <服务器名>
+```
+
+也可以只设置运行时环境变量 `AUTO_NOELLE_USERNAME`、`AUTO_NOELLE_PASSWORD`、`AUTO_NOELLE_SERVERNAME`；当 `--k`/`AUTO_NOELLE_USER_KEY` 缺失时，后续命令会在当前进程内自动登录并复用 user key，不写入文件、不打印完整凭证。
+
+## 账号查询
+
+```bash
+autonoelle-wsg-active account summary
+autonoelle-wsg-active account resources
+autonoelle-wsg-active account teams --all
+autonoelle-wsg-active account equips --first 20 --fields id
+autonoelle-wsg-active account tasks --first 20
+autonoelle-wsg-active account maps --first 20
+autonoelle-wsg-active account expeditions --all
+autonoelle-wsg-active account dock
+autonoelle-wsg-active account battle
+```
+
+账号舰船查询会按 CID 关联公开 GameData，并返回图鉴名称、舰种、国籍、改造状态、实例 ID、婚姻状态和占用状态：
+
+```bash
+autonoelle-wsg-active account ships --ship-type BB --level-min 100 --locked --all
+autonoelle-wsg-active account ships --title 胡德 --first 20
+autonoelle-wsg-active account ships --unmarried --available --fields instanceId,cid,title,level,status
+```
+
+原始快照仍可通过 `snapshot active-info` 分部读取。除非确实需要大型原始对象，不要运行 `snapshot active-info full`。
+
+## 配置发现与安全写入
+
+```bash
+autonoelle-wsg-active config types
+autonoelle-wsg-active config schema
+autonoelle-wsg-active config schema --type MissionBattleConfig
+autonoelle-wsg-active config schema --type ids
+```
+
+读取配置：
+
+```bash
+autonoelle-wsg-active config get --type MissionBattleConfig
+```
+
+写入默认为深度合并：保留输入未提供的对象字段，数组整体替换，并移除只读 `description`。先 dry-run，再使用返回的 `currentHash` 做并发保护：
+
+```bash
+autonoelle-wsg-active config set \
+  --type MissionBattleConfig \
+  --file proposed.json \
+  --dry-run
+
+autonoelle-wsg-active config set \
+  --type MissionBattleConfig \
+  --file proposed.json \
+  --expect-current-hash <sha256>
+```
+
+CLI 会写前读取、校验、写后回读并比较。后端可能吞掉持久化异常并返回成功，因此回验不可省略。失败或不一致时，CLI 会尝试恢复写前值并报告恢复结果。
+
+## Store、过滤器与地图
+
+Store 类型：`ShipPipe`、`ShipReadyPipe`、`TeamPipe`、`BattleMapConfig`。
+
+```bash
+autonoelle-wsg-active store ShipPipe list
+autonoelle-wsg-active store ShipPipe get --id <uuid>
+autonoelle-wsg-active store ShipPipe preview --id <uuid> --first 20
+autonoelle-wsg-active store ShipPipe preview --file pipe.json --all
+autonoelle-wsg-active store ShipPipe set --file pipe.json --dry-run
+
+autonoelle-wsg-active store TeamPipe set --file team.json --dry-run
+autonoelle-wsg-active store BattleMapConfig validate --file map.json
+autonoelle-wsg-active store BattleMapConfig set --file map.json --dry-run
+```
+
+安全删除会先检查 TeamPipe、GlobalDecomposeConfig 和 MissionBattleConfig 引用，删除后确认对象不存在；`--force` 仅供玩家明确批准并具备恢复方案时使用。
+
+```bash
+autonoelle-wsg-active store TeamPipe remove --id <uuid> --dry-run
+autonoelle-wsg-active store TeamPipe remove --id <uuid> --expect-current-hash <sha256>
+```
+
+## 会话与任务
+
+```bash
+autonoelle-wsg-active session info
+autonoelle-wsg-active session reconnect
+autonoelle-wsg-active session disconnect
+autonoelle-wsg-active session unlock
+autonoelle-wsg-active session autologin --state true
+
+autonoelle-wsg-active mission list
+autonoelle-wsg-active mission validate --type MissionBattleConfig
+autonoelle-wsg-active mission validate --type MissionBattleConfig --file proposed.json
+autonoelle-wsg-active mission enable --type MissionBattleConfig --dry-run
+autonoelle-wsg-active mission enable --type MissionBattleConfig
+autonoelle-wsg-active mission disable --type MissionBattleConfig
+```
+
+`mission enable` 会先验证在线状态、完整任务配置、账号队伍、地图配置、TeamPipe、ShipPipe、ShipReadyPipe、候选舰船、容量和资源，再设置并回读状态。`mission disable` 也会回读确认。
+
+## 输出
+
+帮助文本为普通文本；业务命令 stdout 只输出 JSON：
+
+```json
+{ "ok": true, "data": {} }
+```
+
+```json
+{
+  "ok": false,
+  "error": {
+    "code": "MISSION_PREFLIGHT_FAILED",
+    "category": "validation",
+    "message": "MissionBattleConfig is not safe to start.",
+    "details": {},
+    "suggestion": "Resolve every preflight error before enabling the mission.",
+    "retryable": false
+  }
+}
+```
+
+成功退出码为 `0`，错误退出码非 `0`。密码、user key、access token 和常见认证字段会递归脱敏。
+
+## 安全与限制
+
+- 不执行拆船、删装备、付费资源消耗、账号安全修改等不可逆操作。
+- `ShipReadyPipe.useUsedEquip=true` 会从其他非队伍舰船拆装备，必须得到明确批准。
+- `BattleMission.autoDecompose=true` 在船舱满时可能触发拆解链路。
+- 当前持久化 ShipPipe 没有实例 ID 和婚姻字段；`account ships` 可以按这些条件查询，但不能伪装成可保存条件。
+- 精确 `hpRate` 预览需要复现舰船、技能和装备属性聚合，当前会明确拒绝而不是给出不可靠结果。
+- 专用任务 preflight 当前覆盖 `MissionBattleConfig`。

package/dist/activeRestClient.d.ts

@@ -0,0 +1,30 @@
+/** REST client for Active Manager endpoints. Uses native fetch. */
+import { CliError } from './errors.js';
+export interface ActiveRestOptions {
+    activeUrl: string;
+    k: string;
+    scope: string;
+    timeoutMs?: number;
+}
+export interface ActiveBaseOptions {
+    activeUrl: string;
+    scope: string;
+    timeoutMs?: number;
+}
+export declare class ActiveRestError extends CliError {
+    readonly httpCode?: number | undefined;
+    readonly body?: unknown | undefined;
+    constructor(code: string, message: string, httpCode?: number | undefined, body?: unknown | undefined, options?: {
+        category?: 'authentication' | 'authorization' | 'network' | 'timeout' | 'server' | 'rest';
+        suggestion?: string;
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/** Execute a REST call against the Active Manager. */
+export declare function activeCall<T = unknown>(options: ActiveRestOptions, action: string, body?: Record<string, unknown>): Promise<T>;
+/** Execute a POST call against the Active API. */
+export declare function activePost<T = unknown>(options: ActiveBaseOptions, path: string, body?: Record<string, unknown>, k?: string): Promise<T>;
+/** Validate required options and return parsed options. */
+export declare function buildActiveOptions(): ActiveRestOptions;
+//# sourceMappingURL=activeRestClient.d.ts.map

package/dist/activeRestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeRestClient.d.ts","sourceRoot":"","sources":["../src/activeRestClient.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAgB,SAAQ,QAAQ;aAIzB,QAAQ,CAAC,EAAE,MAAM;aACjB,IAAI,CAAC,EAAE,OAAO;gBAH9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,IAAI,CAAC,EAAE,OAAO,YAAA,EAC9B,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAcT;AAED,sDAAsD;AACtD,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,kDAAkD;AAClD,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,CAAC,CAAC,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,CAAC,CA8DZ;AA+FD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,iBAAiB,CAWtD"}

package/dist/activeRestClient.js

@@ -0,0 +1,130 @@
+/** REST client for Active Manager endpoints. Uses native fetch. */
+import { CliError } from './errors.js';
+export class ActiveRestError extends CliError {
+    httpCode;
+    body;
+    constructor(code, message, httpCode, body, options = {}) {
+        super(code, message, {
+            category: options.category ?? 'rest',
+            details: {
+                ...(httpCode === undefined ? {} : { httpCode }),
+                ...(body === undefined ? {} : { response: body }),
+            },
+            suggestion: options.suggestion,
+            retryable: options.retryable,
+            cause: options.cause,
+        });
+        this.httpCode = httpCode;
+        this.body = body;
+        this.name = 'ActiveRestError';
+    }
+}
+/** Execute a REST call against the Active Manager. */
+export async function activeCall(options, action, body) {
+    return activePost(options, `/User/${action}`, body, options.k);
+}
+/** Execute a POST call against the Active API. */
+export async function activePost(options, path, body, k) {
+    const { activeUrl, scope } = options;
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    const headers = {
+        'content-type': 'application/json',
+        scope,
+    };
+    if (k) {
+        headers.k = k;
+    }
+    let res;
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        res = await fetch(`${activeUrl}${normalizedPath}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body ?? {}),
+            signal: controller.signal,
+        });
+    }
+    catch (cause) {
+        if (cause.name === 'AbortError') {
+            throw new ActiveRestError('ACTIVE_TIMEOUT', `Active API request timed out after ${timeoutMs} ms.`, undefined, undefined, { category: 'timeout', retryable: true, cause });
+        }
+        throw new ActiveRestError('ACTIVE_NETWORK_ERROR', `HTTP 请求失败: ${cause.message}`, undefined, undefined, { category: 'network', retryable: true, cause });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    const responseBody = await parseResponse(res);
+    if (!res.ok) {
+        throw classifyHttpError(normalizedPath, res.status, responseBody);
+    }
+    if (isResponseEnvelope(responseBody)) {
+        if (responseBody.code !== 0) {
+            throw new ActiveRestError('ACTIVE_API_ERROR', responseBody.message || 'Active API returned an error.', res.status, responseBody, { category: 'rest' });
+        }
+        return responseBody.data;
+    }
+    return responseBody;
+}
+function isResponseEnvelope(value) {
+    return typeof value === 'object'
+        && value !== null
+        && typeof value.code === 'number';
+}
+async function parseResponse(response) {
+    const bodyText = await response.text().catch(() => '');
+    if (!bodyText) {
+        return null;
+    }
+    try {
+        return JSON.parse(bodyText);
+    }
+    catch (cause) {
+        throw new ActiveRestError('ACTIVE_INVALID_JSON', 'Active API response is not valid JSON.', response.status, undefined, { category: 'rest', cause });
+    }
+}
+function classifyHttpError(path, status, body) {
+    const message = isResponseEnvelope(body) && body.message
+        ? body.message
+        : `Active API returned HTTP ${status}.`;
+    if (status === 401) {
+        return new ActiveRestError('AUTHENTICATION_FAILED', 'AutoNoelle credential is missing, invalid, or expired.', status, body, {
+            category: 'authentication',
+            suggestion: 'Provide AUTO_NOELLE_USER_KEY/--k, or login using runtime username, password, and server variables.',
+        });
+    }
+    if (status === 403) {
+        return new ActiveRestError('AUTHORIZATION_DENIED', 'The credential is not allowed to perform this operation.', status, body, { category: 'authorization' });
+    }
+    if (status === 503) {
+        return new ActiveRestError('ACTIVE_UNAVAILABLE', 'No healthy Active worker is currently available.', status, body, { category: 'server', retryable: true });
+    }
+    if (path.toLowerCase() === '/auth/login') {
+        const serverMissing = message.includes('LOGIN_SERVER_NOT_FOUND') || message.includes('找不到服务器');
+        const credentialsInvalid = message.includes('LOGIN_CREDENTIALS_INVALID');
+        return new ActiveRestError(serverMissing ? 'SERVER_NOT_FOUND' : credentialsInvalid ? 'INVALID_CREDENTIALS' : 'LOGIN_FAILED', serverMissing
+            ? 'The requested game server is not supported by the backend.'
+            : credentialsInvalid
+                ? 'The username or password was rejected.'
+                : 'Login failed. Verify the server name, account, password, and service availability.', status, body, {
+            category: serverMissing ? 'rest' : 'authentication',
+            suggestion: serverMissing
+                ? 'Use an exact server name supported by the backend.'
+                : 'Retry with runtime credentials; do not persist credentials in files.',
+        });
+    }
+    return new ActiveRestError(status >= 500 ? 'ACTIVE_SERVER_ERROR' : 'ACTIVE_HTTP_ERROR', message, status, body, { category: status >= 500 ? 'server' : 'rest', retryable: status >= 500 });
+}
+/** Validate required options and return parsed options. */
+export function buildActiveOptions() {
+    const activeUrl = process.env.AUTO_NOELLE_ACTIVE_URL || 'https://api.auto.noelle.cool';
+    const k = process.env.AUTO_NOELLE_USER_KEY;
+    const scope = process.env.AUTO_NOELLE_SCOPE || 'CN';
+    const timeoutMs = Number(process.env.AUTO_NOELLE_TIMEOUT_MS ?? 15_000);
+    if (!k) {
+        throw new Error('缺少 k (userKey)，请通过 --k 参数或 AUTO_NOELLE_USER_KEY 环境变量设置');
+    }
+    return { activeUrl, k, scope, timeoutMs };
+}
+//# sourceMappingURL=activeRestClient.js.map

package/dist/activeRestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeRestClient.js","sourceRoot":"","sources":["../src/activeRestClient.ts"],"names":[],"mappings":"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"}

package/dist/args.d.ts

@@ -0,0 +1,33 @@
+import { type ActiveBaseOptions, type ActiveRestOptions } from './activeRestClient.js';
+import type { GraphQlOptions } from './graphqlClient.js';
+export interface GlobalOptions {
+    queryUrl: string;
+    activeUrl: string;
+    dataUrl: string;
+    k: string;
+    scope: string;
+    timeoutMs: number;
+    username?: string;
+    password?: string;
+    servername?: string;
+}
+export interface GameDataOptions {
+    dataUrl: string;
+    scope: string;
+    timeoutMs?: number;
+}
+export declare function resolveGlobalOptions(cli: {
+    queryUrl?: string;
+    activeUrl?: string;
+    dataUrl?: string;
+    k?: string;
+    scope?: string;
+    timeout?: string;
+}): GlobalOptions;
+export declare function toGameDataOpts(g: GlobalOptions): GameDataOptions;
+export declare function toGqlOpts(g: GlobalOptions): Promise<GraphQlOptions>;
+export declare function toActiveOpts(g: GlobalOptions): Promise<ActiveRestOptions>;
+export declare function toActiveBaseOpts(g: GlobalOptions): ActiveBaseOptions;
+/** Resolve a user key without persisting credentials or printing the login result. */
+export declare function resolveUserKey(g: GlobalOptions): Promise<string>;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,aAAa,CAqBhB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,eAAe,CAEhE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAEzE;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAEpE;AAID,sFAAsF;AACtF,wBAAsB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCtE"}

package/dist/args.js

@@ -0,0 +1,83 @@
+import { activePost } from './activeRestClient.js';
+import { CliError } from './errors.js';
+export function resolveGlobalOptions(cli) {
+    const scope = (cli.scope ?? process.env.AUTO_NOELLE_SCOPE ?? 'CN').toUpperCase();
+    if (scope !== 'CN' && scope !== 'JP') {
+        throw new CliError('INVALID_SCOPE', `Invalid scope: ${scope}`, {
+            category: 'usage',
+            field: 'scope',
+            details: { current: scope, expected: ['CN', 'JP'] },
+            suggestion: 'Use --scope CN or --scope JP.',
+        });
+    }
+    return {
+        queryUrl: cli.queryUrl ?? process.env.AUTO_NOELLE_QUERY_URL ?? 'https://query.auto.noelle.cool/UserConfig',
+        activeUrl: cli.activeUrl ?? process.env.AUTO_NOELLE_ACTIVE_URL ?? 'https://api.auto.noelle.cool',
+        dataUrl: cli.dataUrl ?? process.env.AUTO_NOELLE_DATA_URL ?? 'https://data.auto.noelle.cool/GameData',
+        k: cli.k ?? process.env.AUTO_NOELLE_USER_KEY ?? '',
+        scope,
+        timeoutMs: resolveTimeout(cli.timeout ?? process.env.AUTO_NOELLE_TIMEOUT_MS),
+        username: process.env.AUTO_NOELLE_USERNAME,
+        password: process.env.AUTO_NOELLE_PASSWORD,
+        servername: process.env.AUTO_NOELLE_SERVERNAME,
+    };
+}
+export function toGameDataOpts(g) {
+    return { dataUrl: g.dataUrl, scope: g.scope, timeoutMs: g.timeoutMs };
+}
+export async function toGqlOpts(g) {
+    return { queryUrl: g.queryUrl, k: await resolveUserKey(g), scope: g.scope, timeoutMs: g.timeoutMs };
+}
+export async function toActiveOpts(g) {
+    return { activeUrl: g.activeUrl, k: await resolveUserKey(g), scope: g.scope, timeoutMs: g.timeoutMs };
+}
+export function toActiveBaseOpts(g) {
+    return { activeUrl: g.activeUrl, scope: g.scope, timeoutMs: g.timeoutMs };
+}
+let cachedRuntimeUserKey;
+/** Resolve a user key without persisting credentials or printing the login result. */
+export async function resolveUserKey(g) {
+    if (g.k) {
+        return g.k;
+    }
+    if (cachedRuntimeUserKey) {
+        return cachedRuntimeUserKey;
+    }
+    if (!g.username || !g.password || !g.servername) {
+        throw new CliError('CREDENTIAL_REQUIRED', 'Missing AutoNoelle user key and runtime login credentials.', {
+            category: 'authentication',
+            details: {
+                expected: [
+                    'AUTO_NOELLE_USER_KEY or --k',
+                    'AUTO_NOELLE_USERNAME + AUTO_NOELLE_PASSWORD + AUTO_NOELLE_SERVERNAME',
+                ],
+            },
+            suggestion: 'Pass credentials only through command arguments or environment variables.',
+        });
+    }
+    const response = await activePost(toActiveBaseOpts(g), '/Auth/Login', { username: g.username, password: g.password, servername: g.servername });
+    const userKey = response.accessToken ?? response.userKey;
+    if (typeof userKey !== 'string' || !userKey) {
+        throw new CliError('LOGIN_CREDENTIAL_MISSING', 'Login succeeded but did not return a usable AutoNoelle user key.', {
+            category: 'authentication',
+            suggestion: 'Check backend compatibility and retry login.',
+        });
+    }
+    cachedRuntimeUserKey = userKey;
+    return userKey;
+}
+function resolveTimeout(value) {
+    if (value === undefined) {
+        return 15_000;
+    }
+    const timeoutMs = Number(value);
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new CliError('INVALID_TIMEOUT', `Invalid timeout: ${value}`, {
+            category: 'usage',
+            field: 'timeout',
+            details: { current: value, expected: 'positive integer milliseconds' },
+        });
+    }
+    return timeoutMs;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/commands/account.d.ts

@@ -0,0 +1,23 @@
+import { type ActiveRestOptions } from '../activeRestClient.js';
+import type { GameDataOptions } from '../args.js';
+export interface OwnedShipOptions {
+    id?: number;
+    cid?: number;
+    title?: string;
+    titleContains?: string;
+    shipTypes?: string[];
+    countries?: string[];
+    levelMin?: number;
+    levelMax?: number;
+    locked?: boolean;
+    married?: boolean;
+    evolved?: boolean;
+    available?: boolean;
+    offset?: number;
+    first?: number;
+    all?: boolean;
+    fields?: string[];
+}
+export declare function summary(opts: ActiveRestOptions): Promise<unknown>;
+export declare function ownedShips(activeOpts: ActiveRestOptions, gameDataOpts: GameDataOptions, options?: OwnedShipOptions): Promise<unknown>;
+//# sourceMappingURL=account.d.ts.map

package/dist/commands/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/commands/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAoBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CvE;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,eAAe,EAC7B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA2BlB"}