arc402-cli 0.7.3 → 0.7.5

package/dist/tui/index.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchTUI = launchTUI;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const App_1 = require("./App");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require("../../package.json");
+const CONFIG_PATH = path_1.default.join(os_1.default.homedir(), ".arc402", "config.json");
+async function loadConfig() {
+    if (!fs_1.default.existsSync(CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+async function getBalance(rpcUrl, address) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ethersLib = require("ethers");
+        const provider = new ethersLib.ethers.JsonRpcProvider(rpcUrl);
+        const bal = await Promise.race([
+            provider.getBalance(address),
+            new Promise((_, r) => setTimeout(() => r(new Error("timeout")), 2000)),
+        ]);
+        return `${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function launchTUI() {
+    const config = await loadConfig();
+    let walletDisplay;
+    if (config.walletContractAddress) {
+        const w = config.walletContractAddress;
+        walletDisplay = `${w.slice(0, 6)}...${w.slice(-4)}`;
+    }
+    let balance;
+    if (config.rpcUrl && config.walletContractAddress) {
+        balance = await getBalance(config.rpcUrl, config.walletContractAddress);
+    }
+    const { waitUntilExit } = (0, ink_1.render)((0, jsx_runtime_1.jsx)(App_1.App, { version: pkg.version, network: config.network, wallet: walletDisplay, balance: balance }));
+    await waitUntilExit();
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":";;;;;AA+CA,8BAwBC;;AAtED,6BAA6B;AAC7B,+BAA4B;AAC5B,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AAEpB,8DAA8D;AAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEjE,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAQtE,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAW,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,MAAc,EACd,OAAe;IAEf,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC7B,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;YAC5B,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1B,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAChD;SACF,CAAC,CAAC;QACH,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,IAAI,aAAiC,CAAC;IACtC,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,CAAC;QACvC,aAAa,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,OAA2B,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAClD,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,YAAM,EAC9B,uBAAC,SAAG,IACF,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,OAAO,EAAE,MAAM,CAAC,OAAO,EACvB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,OAAO,GAChB,CACH,CAAC;IAEF,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/tui/useChat.d.ts

@@ -0,0 +1,11 @@
+interface UseChatResult {
+    send: (message: string, onLine: (line: string) => void) => Promise<void>;
+    isSending: boolean;
+}
+/**
+ * Sends messages to the OpenClaw gateway and streams responses
+ * line-by-line into the viewport buffer via onLine callback.
+ */
+export declare function useChat(): UseChatResult;
+export {};
+//# sourceMappingURL=useChat.d.ts.map

package/dist/tui/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/tui/useChat.ts"],"names":[],"mappings":"AAIA,UAAU,aAAa;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAyFvC"}

package/dist/tui/useChat.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChat = useChat;
+const react_1 = require("react");
+const chalk_1 = __importDefault(require("chalk"));
+const colors_1 = require("../ui/colors");
+/**
+ * Sends messages to the OpenClaw gateway and streams responses
+ * line-by-line into the viewport buffer via onLine callback.
+ */
+function useChat() {
+    const [isSending, setIsSending] = (0, react_1.useState)(false);
+    const send = (0, react_1.useCallback)(async (message, onLine) => {
+        setIsSending(true);
+        const trimmed = message.trim().slice(0, 10000);
+        // Show thinking placeholder
+        onLine(chalk_1.default.dim(" ◈ ") + chalk_1.default.dim("thinking..."));
+        let res;
+        try {
+            res = await fetch("http://localhost:19000/api/agent", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ message: trimmed, session: "arc402-tui" }),
+                signal: AbortSignal.timeout(30000),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const isDown = msg.includes("ECONNREFUSED") ||
+                msg.includes("fetch failed") ||
+                msg.includes("ENOTFOUND") ||
+                msg.includes("UND_ERR_SOCKET");
+            if (isDown) {
+                onLine(" " +
+                    chalk_1.default.yellow("⚠") +
+                    " " +
+                    chalk_1.default.dim("OpenClaw gateway not running. Start with: ") +
+                    chalk_1.default.white("openclaw gateway start"));
+            }
+            else {
+                onLine(` ${colors_1.c.failure} ${chalk_1.default.red(msg)}`);
+            }
+            setIsSending(false);
+            return;
+        }
+        if (!res.body) {
+            onLine(chalk_1.default.dim(" ◈ ") + chalk_1.default.white("(empty response)"));
+            setIsSending(false);
+            return;
+        }
+        const flushLine = (line) => {
+            // Unwrap SSE data lines
+            if (line.startsWith("data: ")) {
+                line = line.slice(6);
+                if (line === "[DONE]")
+                    return;
+                try {
+                    const j = JSON.parse(line);
+                    line = j.text ?? j.content ?? j.delta?.text ?? line;
+                }
+                catch {
+                    /* use raw */
+                }
+            }
+            if (line.trim()) {
+                onLine(chalk_1.default.dim(" ◈ ") + chalk_1.default.white(line));
+            }
+        };
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines)
+                flushLine(line);
+        }
+        if (buffer.trim())
+            flushLine(buffer);
+        setIsSending(false);
+    }, []);
+    return { send, isSending };
+}
+//# sourceMappingURL=useChat.js.map

package/dist/tui/useChat.js.map

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

package/dist/tui/useCommand.d.ts

@@ -0,0 +1,17 @@
+interface UseCommandResult {
+    execute: (input: string, onLine: (line: string) => void) => Promise<void>;
+    isRunning: boolean;
+}
+/**
+ * Dispatches parsed commands to the commander program.
+ *
+ * NON-INTERACTIVE commands: captures stdout/stderr by monkey-patching
+ * process.stdout.write and routes output to the viewport.
+ *
+ * INTERACTIVE commands (WalletConnect, prompts): spawns a child process
+ * running `arc402 <command>` with inherited stdin so that QR codes render
+ * and prompts accept input. Output is captured line-by-line into the viewport.
+ */
+export declare function useCommand(): UseCommandResult;
+export {};
+//# sourceMappingURL=useCommand.d.ts.map

package/dist/tui/useCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommand.d.ts","sourceRoot":"","sources":["../../src/tui/useCommand.ts"],"names":[],"mappings":"AAyCA,UAAU,gBAAgB;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAmB7C"}

package/dist/tui/useCommand.js

@@ -0,0 +1,219 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCommand = useCommand;
+const react_1 = require("react");
+const program_1 = require("../program");
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const colors_1 = require("../ui/colors");
+/**
+ * Commands that use interactive prompts or WalletConnect QR flows.
+ * These MUST run in a child process so they can own stdin/stdout directly,
+ * because Ink holds stdin in raw mode for its own input handling.
+ */
+const INTERACTIVE_COMMANDS = new Set([
+    "wallet deploy",
+    "wallet set-guardian",
+    "wallet unfreeze",
+    "wallet authorize-machine-key",
+    "wallet revoke-machine-key",
+    "wallet set-passkey",
+    "wallet set-interceptor",
+    "wallet set-velocity-limit",
+    "wallet upgrade-registry",
+    "wallet execute-registry-upgrade",
+    "wallet cancel-registry-upgrade",
+    "wallet register-policy",
+    "wallet whitelist-contract",
+    "wallet governance setup",
+    "wallet policy set-limit",
+    "wallet policy set-daily-limit",
+    "wallet policy set",
+    "wallet import",
+    "config init",
+]);
+function isInteractiveCommand(input) {
+    const normalized = input.trim();
+    for (const cmd of INTERACTIVE_COMMANDS) {
+        if (normalized === cmd || normalized.startsWith(cmd + " "))
+            return true;
+    }
+    return false;
+}
+/**
+ * Dispatches parsed commands to the commander program.
+ *
+ * NON-INTERACTIVE commands: captures stdout/stderr by monkey-patching
+ * process.stdout.write and routes output to the viewport.
+ *
+ * INTERACTIVE commands (WalletConnect, prompts): spawns a child process
+ * running `arc402 <command>` with inherited stdin so that QR codes render
+ * and prompts accept input. Output is captured line-by-line into the viewport.
+ */
+function useCommand() {
+    const [isRunning, setIsRunning] = (0, react_1.useState)(false);
+    const execute = (0, react_1.useCallback)(async (input, onLine) => {
+        setIsRunning(true);
+        if (isInteractiveCommand(input)) {
+            await executeInteractive(input, onLine);
+        }
+        else {
+            await executeInProcess(input, onLine);
+        }
+        setIsRunning(false);
+    }, []);
+    return { execute, isRunning };
+}
+/**
+ * Run an interactive command as a child process with inherited stdin.
+ * Ink is temporarily suspended so the child can own the terminal.
+ */
+async function executeInteractive(input, onLine) {
+    const tokens = parseTokens(input);
+    onLine(chalk_1.default.dim("  ◈ Launching interactive session..."));
+    onLine("");
+    return new Promise((resolve) => {
+        // Spawn arc402 as a child process with full terminal access.
+        // Use stdio: 'inherit' so the child owns stdin/stdout/stderr directly.
+        // This means its output goes straight to the terminal (not captured in viewport)
+        // but that's correct — the child needs raw terminal access for QR codes, prompts, etc.
+        const child = (0, child_process_1.spawn)(process.execPath, [process.argv[1], ...tokens], {
+            stdio: "inherit",
+            env: { ...process.env, ARC402_NO_TUI: "1" }, // prevent child from launching its own TUI
+            cwd: process.cwd(),
+        });
+        child.on("close", (code) => {
+            onLine("");
+            if (code === 0) {
+                onLine(` ${colors_1.c.success} ${chalk_1.default.dim("Command completed")}`);
+            }
+            else {
+                onLine(` ${colors_1.c.failure} ${chalk_1.default.red(`Command exited with code ${code}`)}`);
+            }
+            resolve();
+        });
+        child.on("error", (err) => {
+            onLine(` ${colors_1.c.failure} ${chalk_1.default.red(`Failed to spawn: ${err.message}`)}`);
+            resolve();
+        });
+    });
+}
+/**
+ * Run a non-interactive command in-process with captured output.
+ */
+async function executeInProcess(input, onLine) {
+    // Capture stdout/stderr
+    const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    let captureBuffer = "";
+    const flushBuffer = () => {
+        if (!captureBuffer)
+            return;
+        const lines = captureBuffer.split("\n");
+        captureBuffer = lines.pop() ?? "";
+        for (const line of lines) {
+            onLine(line);
+        }
+    };
+    const capturedWrite = (chunk, encodingOrCb, cb) => {
+        const str = typeof chunk === "string"
+            ? chunk
+            : Buffer.from(chunk).toString("utf8");
+        captureBuffer += str;
+        flushBuffer();
+        const callback = typeof encodingOrCb === "function" ? encodingOrCb : cb;
+        if (callback)
+            callback();
+        return true;
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    process.stdout.write = capturedWrite;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    process.stderr.write = capturedWrite;
+    try {
+        const tokens = parseTokens(input);
+        const prog = (0, program_1.createProgram)();
+        prog.exitOverride();
+        prog.configureOutput({
+            writeOut: (str) => process.stdout.write(str),
+            writeErr: (str) => process.stderr.write(str),
+        });
+        await prog.parseAsync(["node", "arc402", ...tokens]);
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "commander.helpDisplayed" ||
+            e.code === "commander.version" ||
+            e.code === "commander.executeSubCommandAsync") {
+            // already written or normal exit — no-op
+        }
+        else if (e.code === "commander.unknownCommand") {
+            const tokens = parseTokens(input);
+            onLine(` ${colors_1.c.failure} ${chalk_1.default.red(`Unknown command: ${chalk_1.default.white(tokens[0])}`)} `);
+            onLine(chalk_1.default.dim("  Type 'help' for available commands"));
+        }
+        else if (e.code?.startsWith("commander.")) {
+            onLine(` ${colors_1.c.failure} ${chalk_1.default.red(e.message ?? String(err))}`);
+        }
+        else {
+            onLine(` ${colors_1.c.failure} ${chalk_1.default.red(e.message ?? String(err))}`);
+        }
+    }
+    finally {
+        // Flush remaining buffer
+        if (captureBuffer.trim()) {
+            onLine(captureBuffer);
+            captureBuffer = "";
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        process.stdout.write = originalStdoutWrite;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        process.stderr.write = originalStderrWrite;
+    }
+}
+// Shell-style tokenizer
+function parseTokens(input) {
+    const tokens = [];
+    let current = "";
+    let inQuote = false;
+    let quoteChar = "";
+    let escape = false;
+    for (const ch of input) {
+        if (escape) {
+            current += ch;
+            escape = false;
+            continue;
+        }
+        if (inQuote) {
+            if (quoteChar === '"' && ch === "\\") {
+                escape = true;
+            }
+            else if (ch === quoteChar) {
+                inQuote = false;
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"' || ch === "'") {
+            inQuote = true;
+            quoteChar = ch;
+        }
+        else if (ch === " ") {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        tokens.push(current);
+    return tokens;
+}
+//# sourceMappingURL=useCommand.js.map

package/dist/tui/useCommand.js.map

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

package/dist/tui/useScroll.d.ts

@@ -0,0 +1,17 @@
+interface UseScrollResult {
+    scrollOffset: number;
+    setScrollOffset: (offset: number) => void;
+    viewportHeight: number;
+    isAutoScroll: boolean;
+    scrollUp: (lines?: number) => void;
+    scrollDown: (lines?: number) => void;
+    snapToBottom: () => void;
+}
+/**
+ * Manages scroll state for the Viewport.
+ * scrollOffset=0 means auto-scroll (pinned to bottom).
+ * Positive scrollOffset means scrolled up by that many lines.
+ */
+export declare function useScroll(viewportHeight: number): UseScrollResult;
+export {};
+//# sourceMappingURL=useScroll.d.ts.map

package/dist/tui/useScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScroll.d.ts","sourceRoot":"","sources":["../../src/tui/useScroll.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,CA8CjE"}

package/dist/tui/useScroll.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useScroll = useScroll;
+const react_1 = require("react");
+const ink_1 = require("ink");
+/**
+ * Manages scroll state for the Viewport.
+ * scrollOffset=0 means auto-scroll (pinned to bottom).
+ * Positive scrollOffset means scrolled up by that many lines.
+ */
+function useScroll(viewportHeight) {
+    const [scrollOffset, setScrollOffsetState] = (0, react_1.useState)(0);
+    const isAutoScroll = scrollOffset === 0;
+    const setScrollOffset = (0, react_1.useCallback)((offset) => {
+        setScrollOffsetState(Math.max(0, offset));
+    }, []);
+    const scrollUp = (0, react_1.useCallback)((lines) => {
+        const step = lines ?? viewportHeight;
+        setScrollOffsetState((prev) => prev + step);
+    }, [viewportHeight]);
+    const scrollDown = (0, react_1.useCallback)((lines) => {
+        const step = lines ?? viewportHeight;
+        setScrollOffsetState((prev) => Math.max(0, prev - step));
+    }, [viewportHeight]);
+    const snapToBottom = (0, react_1.useCallback)(() => {
+        setScrollOffsetState(0);
+    }, []);
+    (0, ink_1.useInput)((_input, key) => {
+        if (key.pageUp) {
+            scrollUp(viewportHeight);
+        }
+        else if (key.pageDown) {
+            scrollDown(viewportHeight);
+        }
+    });
+    return {
+        scrollOffset,
+        setScrollOffset,
+        viewportHeight,
+        isAutoScroll,
+        scrollUp,
+        scrollDown,
+        snapToBottom,
+    };
+}
+//# sourceMappingURL=useScroll.js.map

package/dist/tui/useScroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScroll.js","sourceRoot":"","sources":["../../src/tui/useScroll.ts"],"names":[],"mappings":";;AAkBA,8BA8CC;AAhED,iCAA8C;AAC9C,6BAA+B;AAY/B;;;;GAIG;AACH,SAAgB,SAAS,CAAC,cAAsB;IAC9C,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC;IAExC,MAAM,eAAe,GAAG,IAAA,mBAAW,EAAC,CAAC,MAAc,EAAE,EAAE;QACrD,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,IAAI,GAAG,KAAK,IAAI,cAAc,CAAC;QACrC,oBAAoB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC,EACD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAA,mBAAW,EAC5B,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,IAAI,GAAG,KAAK,IAAI,cAAc,CAAC;QACrC,oBAAoB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC,EACD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,YAAY,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACpC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAA,cAAQ,EAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxB,UAAU,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,YAAY;QACZ,eAAe;QACf,cAAc;QACd,YAAY;QACZ,QAAQ;QACR,UAAU;QACV,YAAY;KACb,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arc402-cli",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "ARC-402 CLI for discovery, negotiation payloads, hire/remediation/dispute workflows, and network reads",
   "bin": {
     "arc402": "./dist/index.js"
@@ -14,6 +14,7 @@
     "@arc402/sdk": "^0.3.1",
     "@coinbase/wallet-sdk": "^4.3.7",
     "@types/better-sqlite3": "^7.6.13",
+    "@types/react": "^18.3.28",
     "@walletconnect/keyvaluestorage": "^1.1.1",
     "@walletconnect/sign-client": "^2.17.4",
     "better-sqlite3": "^12.8.0",
@@ -21,10 +22,13 @@
     "cli-table3": "^0.6.3",
     "commander": "^12.1.0",
     "ethers": "^6.13.4",
+    "ink": "^3.2.0",
+    "ink-text-input": "^4.0.3",
     "jose": "^6.2.1",
     "ora": "^8.1.1",
     "prompts": "^2.4.2",
     "qrcode-terminal": "^0.12.0",
+    "react": "^18.3.1",
     "smol-toml": "^1.6.0",
     "tweetnacl": "^1.0.3",
     "yaml": "^2.8.2"

package/src/index.ts

@@ -27,6 +27,18 @@ function checkUpgrade(): void {
 
 const printMode = process.argv.includes("--print");
 
+// Detect if a subcommand was provided (any arg after the binary that doesn't start with -)
+const knownSubcommands = (() => {
+  try {
+    const prog = createProgram();
+    return new Set(prog.commands.map((cmd) => cmd.name()));
+  } catch {
+    return new Set<string>();
+  }
+})();
+const argv = process.argv.slice(2).filter((a) => a !== "--print");
+const hasSubcommand = argv.some((a) => !a.startsWith("-") && knownSubcommands.has(a));
+
 if (printMode) {
   // --print mode: skip REPL entirely, suppress ANSI/spinners, run command, exit.
   // Used by OpenClaw agents running arc402 commands via ACP.
@@ -40,8 +52,16 @@ if (printMode) {
     console.error(e instanceof Error ? e.message : String(e));
     process.exit(1);
   });
+} else if (process.stdout.isTTY && !hasSubcommand && process.argv.length <= 2 && !process.env.ARC402_NO_TUI) {
+  // TTY with no subcommand — launch Ink TUI (unless spawned by TUI as a child process)
+  checkUpgrade();
+  void import("./tui/index").then(({ launchTUI }) => launchTUI()).catch((e: unknown) => {
+    console.error("TUI failed to start:", e instanceof Error ? e.message : String(e));
+    // Fallback to REPL
+    void startREPL();
+  });
 } else if (process.argv.length <= 2) {
-  // No subcommand — enter interactive REPL
+  // No subcommand, not TTY — enter basic REPL fallback
   checkUpgrade();
   void startREPL();
 } else {