desic-okx-agent 0.1.9 → 0.2.0

package/README.md

@@ -60,7 +60,7 @@ desic-okx setup --targets codex --yes --skip-network-check
 
 Non-interactive setup exits with an error when the network check fails. Use `--skip-network-check` only when connectivity will be configured later.
 
-Restart the selected client after setup. The MCP server starts the local Runtime automatically when it is first used.
+Restart the selected client after setup. The MCP server starts the local Runtime automatically when it is first used. Run `desic-okx doctor` at any time to verify the package, client configuration, Skills, network, Runtime, SQLite, public market data, and configured accounts.
 
 ## Ask an AI to install it
 
@@ -71,7 +71,7 @@ Install Desic OKX Agent for me. Check that Node.js is at least 22.12, then run:
 npm install --global desic-okx-agent
 desic-okx setup --targets codex --yes
 
-Verify the installation with `desic-okx status` and `desic-okx tools`. Do not ask for or configure any OKX API credentials. Confirm that public market tools are ready to use.
+Verify the installation with `desic-okx doctor`. Do not ask for or configure any OKX API credentials. Confirm that public market tools are ready to use.
 ```
 
 For development from source:
@@ -101,10 +101,15 @@ Useful Runtime commands:
 
 ```bash
 desic-okx status
+desic-okx status --json
+desic-okx doctor
 desic-okx tools
+desic-okx tool market_get_decision_snapshot
 desic-okx stop
 ```
 
+`status` shows the Runtime version, uptime, redacted proxy route, public/business/private WebSocket state, subscriptions and data ages, accounts, and database size. `doctor` performs active network, SQLite, market-data, account, MCP-client, Skill, and package checks. Both support machine-readable JSON.
+
 ## Connect Codex
 
 The recommended option is `desic-okx setup`, which also installs all Skills. To register only the local stdio MCP server manually:
@@ -169,6 +174,14 @@ Included skills:
 
 Restart the client if a newly installed skill does not appear.
 
+Setup synchronizes bundled Skills on every run. Identical Skills are left untouched. Changed copies are backed up before the bundled version is installed. They can also be inspected or synchronized explicitly:
+
+```bash
+desic-okx skills status
+desic-okx skills sync
+desic-okx skills sync --targets codex --dry-run
+```
+
 ## Configure an OKX account
 
 Public tools work without credentials. Account and trading tools use a named account alias and never accept credentials as tool arguments.
@@ -178,9 +191,15 @@ Add and verify an account interactively:
 ```bash
 desic-okx account add --name demo --environment demo
 desic-okx account verify --name demo
+desic-okx account verify --all
 desic-okx account list
+desic-okx account set-default demo
+desic-okx account rename demo demo-primary
+desic-okx account edit demo-primary
 ```
 
+`account add` and `account edit` verify the credentials with OKX before writing the configuration file. Editing credentials remains interactive so secrets are not passed as command-line arguments.
+
 The credential prompts hide input. Credentials are stored in the system configuration directory in `config.json`; Unix permissions are set to `0600`. The active path is shown by:
 
 ```bash
@@ -199,6 +218,29 @@ OKX_ENVIRONMENT=demo|live
 
 The three credential values must be provided together. Whether an account can trade is determined by the permissions assigned to its API key in OKX.
 
+## Tool help
+
+The MCP schemas are available to AI clients. Humans can inspect the same schema, account requirement, and a runnable example from the CLI:
+
+```bash
+desic-okx tool news_search
+desic-okx tool trade_place_order --json
+```
+
+Remote News and Smart Money tools require a configured **live OKX account**. Read-only API permission is sufficient. Local News event and history tools can use previously persisted data where available. This requirement is included in the MCP tool descriptions and relevant Skills.
+
+## Update
+
+Check or install the latest npm release:
+
+```bash
+desic-okx update --check
+desic-okx update
+desic-okx update --yes
+```
+
+The updater checks the official npm registry, stops the Runtime, waits for the native SQLite module to be released, and then performs the global npm update. It synchronizes Skills for detected installations and runs Doctor afterward. When a newer CLI or MCP adapter encounters an older running Runtime, it automatically replaces it before handling requests.
+
 ## Proxy
 
 REST and every public, business, and private WebSocket connection use the same proxy resolution order:
@@ -256,7 +298,7 @@ Use an OKX Demo account first. Trading software can lose money, and the project
 
 ## Experimental intelligence
 
-News and Smart Money use upstream interfaces that may change without notice. Compatibility failures return `CAPABILITY_UNAVAILABLE`, or locally persisted history when available. A failure in these modules does not disable market, account, or trading tools.
+Remote News and Smart Money use upstream interfaces that may change without notice and require a configured live OKX account; read-only API permission is sufficient. Compatibility failures return `CAPABILITY_UNAVAILABLE`, or locally persisted history when available. A failure in these modules does not disable market, account, or trading tools.
 
 ## Development
 
@@ -284,7 +326,7 @@ Normal tests never submit orders.
 
 ## Status
 
-This repository is currently pre-release software at version `0.1.9`. Unit, packaging, Skill, and MCP transport checks are automated. Real OKX Demo trading should be validated in the target network environment before a `1.0.0` release.
+This repository is currently pre-release software at version `0.2.0`. Unit, packaging, Skill, and MCP transport checks are automated. Real OKX Demo trading should be validated in the target network environment before a `1.0.0` release.
 
 ## License
 

package/dist/account/private-websocket.d.ts

@@ -7,6 +7,7 @@ export declare class PrivateAccountWebSockets {
     constructor(config: RuntimeConfig, store: AccountStore);
     start(): void;
     stop(): void;
+    status(): Array<Record<string, unknown>>;
     private connect;
     private reconnect;
     private message;

package/dist/account/private-websocket.js

@@ -8,7 +8,9 @@ export class PrivateAccountWebSockets {
     agent;
     constructor(config, store) {
         this.store = store;
-        this.connections = Object.entries(config.accounts).map(([name, account]) => ({ account: { name, ...account }, stopping: false, attempt: 0 }));
+        this.connections = Object.entries(config.accounts).map(([name, account]) => ({
+            account: { name, ...account }, stopping: false, attempt: 0, authenticated: false
+        }));
         const proxyUrl = resolveProxy(config.proxy.url).url;
         this.agent = proxyUrl ? new HttpsProxyAgent(proxyUrl) : undefined;
     }
@@ -26,6 +28,18 @@ export class PrivateAccountWebSockets {
             connection.socket?.close();
         }
     }
+    status() {
+        const states = ["connecting", "open", "closing", "closed"];
+        return this.connections.map((connection) => ({
+            account: connection.account.name,
+            environment: connection.account.environment,
+            state: connection.socket ? states[connection.socket.readyState] ?? "unknown" : "not-started",
+            authenticated: connection.authenticated,
+            reconnectAttempt: connection.attempt,
+            lastMessageAt: connection.lastMessageAt ?? null,
+            lastError: connection.lastError ?? null
+        }));
+    }
     connect(connection) {
         if (connection.stopping)
             return;
@@ -34,10 +48,14 @@ export class PrivateAccountWebSockets {
             : "wss://ws.okx.com:8443/ws/v5/private";
         const socket = new WebSocket(url, this.agent ? { agent: this.agent } : undefined);
         connection.socket = socket;
+        connection.authenticated = false;
         socket.on("open", () => socket.send(JSON.stringify({ op: "login", args: [loginArgs(connection.account)] })));
         socket.on("message", (buffer) => this.message(connection, buffer.toString()));
         socket.on("close", () => this.reconnect(connection));
-        socket.on("error", () => socket.close());
+        socket.on("error", (error) => {
+            connection.lastError = error.message;
+            socket.close();
+        });
     }
     reconnect(connection) {
         if (connection.stopping || connection.reconnect)
@@ -55,6 +73,7 @@ export class PrivateAccountWebSockets {
     message(connection, text) {
         if (text === "pong")
             return;
+        connection.lastMessageAt = Date.now();
         let message;
         try {
             message = JSON.parse(text);
@@ -64,6 +83,8 @@ export class PrivateAccountWebSockets {
         }
         if (message.event === "login" && message.code === "0") {
             connection.attempt = 0;
+            connection.authenticated = true;
+            connection.lastError = undefined;
             connection.socket?.send(JSON.stringify({
                 op: "subscribe",
                 args: [
@@ -80,6 +101,10 @@ export class PrivateAccountWebSockets {
             connection.heartbeat.unref();
             return;
         }
+        if (message.event === "login" && message.code !== "0") {
+            connection.authenticated = false;
+            connection.lastError = String(message.msg ?? `Login failed with code ${String(message.code ?? "unknown")}`);
+        }
         const arg = message.arg;
         const data = Array.isArray(message.data) ? message.data : [];
         if (!arg?.channel || !data.length)

package/dist/account/private-websocket.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,14 @@
+export type DoctorStatus = "pass" | "warn" | "fail";
+export interface DoctorCheck {
+    name: string;
+    status: DoctorStatus;
+    details: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    version: string;
+    checkedAt: number;
+    checks: DoctorCheck[];
+}
+export declare function runDoctor(): Promise<DoctorReport>;
+export declare function formatDoctor(reportValue: DoctorReport): string;

package/dist/cli/doctor.js

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import { AccountService } from "../account/service.js";
+import { loadConfig } from "../config/loader.js";
+import { CONFIG_PATH } from "../config/paths.js";
+import { OkxClient } from "../core/okx-client.js";
+import { PACKAGE_VERSION } from "../core/version.js";
+import { checkOkxConnectivity, OKX_REST_BASE_URL } from "../network/connectivity.js";
+import { displayProxy, resolveProxy } from "../network/proxy.js";
+import { RuntimeClient } from "../runtime/client.js";
+import { inspectSetupTargets, syncSkills } from "../setup/installer.js";
+import { checkForUpdate } from "../update/service.js";
+export async function runDoctor() {
+    const checks = [];
+    let config;
+    try {
+        config = loadConfig();
+        const permission = configPermission();
+        checks.push({ name: "Configuration", status: permission.secure ? "pass" : "warn", details: permission.details });
+    }
+    catch (error) {
+        checks.push({ name: "Configuration", status: "fail", details: errorMessage(error) });
+        return report(checks);
+    }
+    try {
+        const update = await checkForUpdate(undefined, config.proxy.url);
+        checks.push({
+            name: "Package",
+            status: update.updateAvailable ? "warn" : "pass",
+            details: update.updateAvailable ? `${update.current} installed; ${update.latest} available` : `${update.current} is current`
+        });
+    }
+    catch (error) {
+        checks.push({ name: "Package", status: "warn", details: `Could not check npm: ${errorMessage(error)}` });
+    }
+    const clients = inspectSetupTargets();
+    const configured = clients.filter((item) => item.mcpConfigured === true);
+    checks.push({
+        name: "MCP clients",
+        status: configured.length ? "pass" : "warn",
+        details: configured.length ? configured.map((item) => item.target).join(", ") : "No supported client configuration was detected"
+    });
+    const installedSkillTargets = clients.filter((item) => item.skillsInstalled !== null && item.skillsInstalled > 0)
+        .map((item) => item.target).filter((target) => target === "codex" || target === "claude-code");
+    if (installedSkillTargets.length) {
+        const skills = syncSkills(installedSkillTargets, { dryRun: true });
+        const pending = skills.reduce((total, item) => total + item.installed + item.updated, 0);
+        checks.push({
+            name: "Skills",
+            status: pending ? "warn" : "pass",
+            details: pending ? `${pending} bundled Skills need synchronization` : `${skills.reduce((sum, item) => sum + item.unchanged, 0)} bundled Skills are current`
+        });
+    }
+    else {
+        checks.push({ name: "Skills", status: "warn", details: "No Codex or Claude Code Skills were detected" });
+    }
+    const proxy = resolveProxy(config.proxy.url);
+    const network = await checkOkxConnectivity(proxy.url);
+    checks.push({
+        name: "OKX network",
+        status: network.ok ? "pass" : "fail",
+        details: network.ok
+            ? `${displayProxy(proxy)}; REST ${network.rest.latencyMs}ms, WebSocket ${network.websocket.latencyMs}ms`
+            : `${displayProxy(proxy)}; REST ${network.rest.error ?? "failed"}; WebSocket ${network.websocket.error ?? "failed"}`
+    });
+    if (network.ok) {
+        try {
+            const runtime = await RuntimeClient.connect();
+            const health = await runtime.health();
+            const diagnostics = await runtime.diagnostics();
+            checks.push({ name: "Runtime", status: health.version === PACKAGE_VERSION ? "pass" : "warn", details: `version ${String(health.version)}, PID ${String(health.pid)}, uptime ${formatDuration(Number(health.uptimeMs))}` });
+            const integrity = String(diagnostics.database?.integrity ?? "unknown");
+            checks.push({ name: "SQLite", status: integrity === "ok" ? "pass" : "fail", details: `integrity ${integrity}` });
+            const ticker = await runtime.call("market_get_ticker", { instId: "BTC-USDT-SWAP" });
+            checks.push({ name: "Market data", status: "pass", details: `BTC-USDT-SWAP last ${String(ticker.data?.last ?? "received")}, age ${String(ticker.meta?.ageMs ?? "unknown")}ms` });
+        }
+        catch (error) {
+            checks.push({ name: "Runtime", status: "fail", details: errorMessage(error) });
+        }
+    }
+    const accounts = Object.keys(config.accounts);
+    if (!accounts.length) {
+        checks.push({ name: "Accounts", status: "warn", details: "No account configured; public market tools remain available" });
+    }
+    else if (network.ok) {
+        const client = new OkxClient(OKX_REST_BASE_URL, proxy.url);
+        const service = new AccountService(config, client);
+        for (const name of accounts) {
+            try {
+                const verified = await service.verify(name);
+                checks.push({ name: `Account ${name}`, status: "pass", details: `${config.accounts[name]?.environment}; permissions ${String(verified.data.perm ?? "reported by OKX")}` });
+            }
+            catch (error) {
+                checks.push({ name: `Account ${name}`, status: "fail", details: errorMessage(error) });
+            }
+        }
+    }
+    return report(checks);
+}
+export function formatDoctor(reportValue) {
+    const width = Math.max(...reportValue.checks.map((check) => check.name.length), 6);
+    const lines = ["Desic OKX Doctor", ""];
+    for (const check of reportValue.checks) {
+        lines.push(`${check.status.toUpperCase().padEnd(4)}  ${check.name.padEnd(width)}  ${check.details}`);
+    }
+    lines.push("", reportValue.ok ? "Ready" : "Action required");
+    return lines.join("\n");
+}
+function configPermission() {
+    if (!fs.existsSync(CONFIG_PATH))
+        return { secure: true, details: "defaults in use; no config file created" };
+    if (process.platform === "win32")
+        return { secure: true, details: CONFIG_PATH };
+    const mode = fs.statSync(CONFIG_PATH).mode & 0o777;
+    return mode & 0o077
+        ? { secure: false, details: `${CONFIG_PATH}; permissions should be 0600` }
+        : { secure: true, details: `${CONFIG_PATH}; permissions 0600` };
+}
+function report(checks) {
+    return { ok: checks.every((check) => check.status !== "fail"), version: PACKAGE_VERSION, checkedAt: Date.now(), checks };
+}
+function formatDuration(ms) {
+    if (!Number.isFinite(ms))
+        return "unknown";
+    if (ms < 60_000)
+        return `${Math.round(ms / 1_000)}s`;
+    if (ms < 3_600_000)
+        return `${Math.round(ms / 60_000)}m`;
+    return `${(ms / 3_600_000).toFixed(1)}h`;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+import * as prompts from "@clack/prompts";
 import { accountSummaries, loadConfig, loadStoredConfig, saveConfig } from "../config/loader.js";
 import { CONFIG_PATH } from "../config/paths.js";
 import { OkxClient } from "../core/okx-client.js";
@@ -10,9 +11,13 @@ import { displayProxy, resolveProxy } from "../network/proxy.js";
 import { AccountService } from "../account/service.js";
 import { runMcpServer } from "../mcp/server.js";
 import { RuntimeClient } from "../runtime/client.js";
-import { ask, askSecret } from "./prompts.js";
-import { SetupCancelledError, parseSetupTargets, SETUP_TARGETS, setupSucceeded, setupSummary, setupTargets } from "../setup/installer.js";
+import { ask, askConfirm, askSecret } from "./prompts.js";
+import { SetupCancelledError, inspectSetupTargets, parseSetupTargets, SETUP_TARGETS, setupSucceeded, setupSummary, setupTargets, syncSkills } from "../setup/installer.js";
 import { runSetupWizard } from "../setup/wizard.js";
+import { runDoctor, formatDoctor } from "./doctor.js";
+import { formatRuntimeStatus, formatToolHelp } from "./render.js";
+import { getToolHelp } from "../tools/help.js";
+import { checkForUpdate, installLatestVersion, OFFICIAL_NPM_REGISTRY, runInstalledCommand } from "../update/service.js";
 const program = new Command()
     .name("desic-okx")
     .description("Independent Desic runtime, MCP server, CLI, and skills for OKX")
@@ -38,9 +43,26 @@ program.command("stop")
 });
 program.command("status")
     .description("Show local runtime status")
-    .action(async () => {
+    .option("--json", "Print machine-readable JSON")
+    .action(async (options) => {
     const client = await RuntimeClient.connect({ start: false });
-    print(await client.health());
+    const health = await client.health();
+    if (options.json || !process.stdout.isTTY)
+        print(health);
+    else
+        process.stdout.write(`${formatRuntimeStatus(health)}\n`);
+});
+program.command("doctor")
+    .description("Diagnose installation, network, Runtime, Skills, and accounts")
+    .option("--json", "Print machine-readable JSON")
+    .action(async (options) => {
+    const report = await runDoctor();
+    if (options.json || !process.stdout.isTTY)
+        print(report);
+    else
+        process.stdout.write(`${formatDoctor(report)}\n`);
+    if (!report.ok)
+        process.exitCode = 1;
 });
 program.command("mcp")
     .description("Run the stdio MCP adapter")
@@ -91,6 +113,61 @@ program.command("tools")
     const client = await RuntimeClient.connect();
     print(await client.tools());
 });
+program.command("tool")
+    .description("Show one tool's requirements, schema, and example")
+    .argument("<name>", "tool name")
+    .option("--json", "Print machine-readable JSON")
+    .action((name, options) => {
+    const help = getToolHelp(name);
+    if (!help)
+        throw new Error(`Unknown tool '${name}'`);
+    if (options.json || !process.stdout.isTTY)
+        print(help);
+    else
+        process.stdout.write(`${formatToolHelp(help)}\n`);
+});
+const skills = program.command("skills").description("Inspect and synchronize bundled Skills");
+skills.command("status")
+    .description("Show pending Skill installations and updates")
+    .option("--targets <targets>", "codex,claude-code; defaults to detected installations")
+    .action((options) => print(syncSkills(resolveSkillTargets(options.targets), { dryRun: true })));
+skills.command("sync")
+    .description("Install or update bundled Skills, backing up changed copies")
+    .option("--targets <targets>", "codex,claude-code; defaults to detected installations")
+    .option("--dry-run", "Show changes without writing")
+    .action((options) => print(syncSkills(resolveSkillTargets(options.targets), { dryRun: options.dryRun })));
+program.command("update")
+    .description("Check for and install the latest npm release safely")
+    .option("--check", "Only check for a newer version")
+    .option("--yes", "Install without confirmation")
+    .option("--registry <url>", "npm registry", OFFICIAL_NPM_REGISTRY)
+    .action(async (options) => {
+    const info = await checkForUpdate(options.registry, loadStoredConfig().proxy.url);
+    if (options.check || !info.updateAvailable) {
+        print(info);
+        return;
+    }
+    let approved = options.yes === true;
+    if (!approved && process.stdin.isTTY) {
+        const answer = await prompts.confirm({ message: `Update ${info.current} to ${info.latest}?` });
+        if (prompts.isCancel(answer) || answer === false)
+            throw new SetupCancelledError();
+        approved = true;
+    }
+    if (!approved)
+        throw new Error("Use --yes to update in a non-interactive terminal");
+    const exitCode = await installLatestVersion(info);
+    if (exitCode !== 0)
+        throw new Error(`npm exited with code ${exitCode}`);
+    process.stdout.write(`Updated to ${info.latest}. Synchronizing installed Skills...\n`);
+    const skillExit = await runInstalledCommand(["skills", "sync"]);
+    if (skillExit !== 0)
+        process.stderr.write("The package was updated, but Skill synchronization needs attention.\n");
+    process.stdout.write("Verifying the updated installation...\n");
+    const doctorExit = await runInstalledCommand(["doctor"]);
+    if (doctorExit !== 0)
+        process.stderr.write("The package was updated, but Doctor reported an issue.\n");
+});
 program.command("config-path")
     .description("Print the active configuration path")
     .action(() => {
@@ -112,11 +189,13 @@ account.command("add")
     if (!apiKey || !secretKey || !passphrase)
         throw new Error("All three credential fields are required");
     const config = loadStoredConfig();
-    config.accounts[name] = { environment: environmentValue, apiKey, secretKey, passphrase };
-    config.defaultAccount ??= name;
-    saveConfig(config);
+    const candidate = structuredClone(config);
+    candidate.accounts[name] = { environment: environmentValue, apiKey, secretKey, passphrase };
+    candidate.defaultAccount ??= name;
+    const verified = await verifyAccount(candidate, name);
+    saveConfig(candidate);
     await stopForReload();
-    print({ saved: true, name, environment: environmentValue, configPath: CONFIG_PATH });
+    print({ saved: true, name, environment: environmentValue, permissions: verified.data, configPath: CONFIG_PATH });
 });
 account.command("list")
     .description("List configured account aliases")
@@ -124,11 +203,87 @@ account.command("list")
 account.command("verify")
     .description("Verify one account and show OKX-reported permissions")
     .option("--name <name>", "account alias")
+    .option("--all", "Verify all configured accounts")
     .action(async (options) => {
     const config = loadConfig();
     const client = new OkxClient(OKX_REST_BASE_URL, resolveProxy(config.proxy.url).url);
     const service = new AccountService(config, client);
-    print(await service.verify(options.name));
+    if (options.all) {
+        const results = await Promise.all(Object.keys(config.accounts).map(async (name) => {
+            try {
+                return { name, ok: true, result: await service.verify(name) };
+            }
+            catch (error) {
+                return { name, ok: false, error: publicError(error) };
+            }
+        }));
+        print(results);
+        if (results.some((result) => !result.ok))
+            process.exitCode = 1;
+    }
+    else {
+        print(await service.verify(options.name));
+    }
+});
+account.command("set-default")
+    .description("Set the default account alias")
+    .argument("<name>", "account alias")
+    .action(async (name) => {
+    const config = loadStoredConfig();
+    if (!config.accounts[name])
+        throw new Error(`Account '${name}' was not found`);
+    config.defaultAccount = name;
+    saveConfig(config);
+    await stopForReload();
+    print({ saved: true, defaultAccount: name });
+});
+account.command("rename")
+    .description("Rename an account alias")
+    .argument("<oldName>", "current account alias")
+    .argument("<newName>", "new account alias")
+    .action(async (oldName, newName) => {
+    const config = loadStoredConfig();
+    if (!config.accounts[oldName])
+        throw new Error(`Account '${oldName}' was not found`);
+    if (config.accounts[newName])
+        throw new Error(`Account '${newName}' already exists`);
+    config.accounts[newName] = config.accounts[oldName];
+    delete config.accounts[oldName];
+    if (config.defaultAccount === oldName)
+        config.defaultAccount = newName;
+    saveConfig(config);
+    await stopForReload();
+    print({ renamed: true, from: oldName, to: newName, default: config.defaultAccount === newName });
+});
+account.command("edit")
+    .description("Edit an account environment or replace its credentials")
+    .argument("<name>", "account alias")
+    .option("--environment <environment>", "demo or live")
+    .option("--replace-credentials", "Prompt for replacement credentials")
+    .action(async (name, options) => {
+    const config = loadStoredConfig();
+    const current = config.accounts[name];
+    if (!current)
+        throw new Error(`Account '${name}' was not found`);
+    const environment = options.environment?.trim() || await ask("Environment (demo/live)", current.environment);
+    if (environment !== "demo" && environment !== "live")
+        throw new Error("Environment must be demo or live");
+    const normalizedEnvironment = environment;
+    const replace = options.replaceCredentials ?? await askConfirm("Replace API credentials", false);
+    const updated = { ...current, environment: normalizedEnvironment };
+    if (replace) {
+        updated.apiKey = await askSecret("API Key");
+        updated.secretKey = await askSecret("Secret Key");
+        updated.passphrase = await askSecret("Passphrase");
+        if (!updated.apiKey || !updated.secretKey || !updated.passphrase)
+            throw new Error("All three credential fields are required");
+    }
+    const candidate = structuredClone(config);
+    candidate.accounts[name] = updated;
+    const verified = await verifyAccount(candidate, name);
+    saveConfig(candidate);
+    await stopForReload();
+    print({ saved: true, name, environment, permissions: verified.data });
 });
 account.command("remove")
     .description("Remove one account")
@@ -160,6 +315,27 @@ async function stopForReload() {
     }
     catch { }
 }
+async function verifyAccount(config, name) {
+    const client = new OkxClient(OKX_REST_BASE_URL, resolveProxy(config.proxy.url).url);
+    return new AccountService(config, client).verify(name);
+}
+function parseSkillTargets(value) {
+    const targets = value.split(",").map((item) => item.trim()).filter(Boolean);
+    const invalid = targets.filter((target) => target !== "codex" && target !== "claude-code");
+    if (invalid.length)
+        throw new Error(`Unsupported Skill target: ${invalid.join(", ")}`);
+    return [...new Set(targets)];
+}
+function resolveSkillTargets(value) {
+    if (value)
+        return parseSkillTargets(value);
+    const detected = inspectSetupTargets()
+        .filter((item) => (item.target === "codex" || item.target === "claude-code") && item.skillsInstalled !== null && item.skillsInstalled > 0)
+        .map((item) => item.target);
+    if (!detected.length)
+        throw new Error("No installed Codex or Claude Code Skills were detected; pass --targets to install them");
+    return detected;
+}
 function print(value) {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 }