ray-finance 0.4.1 → 0.4.2

package/dist/ai/agent.d.ts

@@ -7,4 +7,8 @@ export type ProgressCallback = (event: {
     toolCount: number;
     elapsedMs: number;
 }) => void;
-export declare function handleMessage(db: Database.Database, userMessage: string, onProgress?: ProgressCallback): Promise<string>;
+/** Thrown by handleMessage when the caller aborts via AbortSignal */
+export declare class AbortedError extends Error {
+    constructor();
+}
+export declare function handleMessage(db: Database.Database, userMessage: string, onProgress?: ProgressCallback, signal?: AbortSignal): Promise<string>;

package/dist/ai/agent.js

@@ -26,7 +26,14 @@ export const TOOL_LABELS = {
     save_memory: "Remembering that",
     update_context: "Updating your profile",
 };
-export async function handleMessage(db, userMessage, onProgress) {
+/** Thrown by handleMessage when the caller aborts via AbortSignal */
+export class AbortedError extends Error {
+    constructor() {
+        super("aborted");
+        this.name = "AbortedError";
+    }
+}
+export async function handleMessage(db, userMessage, onProgress, signal) {
     // Save incoming message
     saveMessage(db, "user", userMessage);
     // Load conversation context, truncated to fit token budget
@@ -55,7 +62,12 @@ export async function handleMessage(db, userMessage, onProgress) {
     const useThinking = config.thinkingBudget > 0
         && provider.supportsThinking
         && supportsThinking(config.model);
+    const throwIfAborted = () => {
+        if (signal?.aborted)
+            throw new AbortedError();
+    };
     try {
+        throwIfAborted();
         // Initial API call
         let response = await provider.sendMessage({
             model: config.model,
@@ -66,11 +78,13 @@ export async function handleMessage(db, userMessage, onProgress) {
             thinking: useThinking
                 ? { type: "enabled", budget_tokens: config.thinkingBudget }
                 : undefined,
+            signal,
         });
         // Agentic tool loop
         const startTime = Date.now();
         let toolCount = 0;
         while (response.stopReason === "tool_use" && toolCount < MAX_TOOL_STEPS) {
+            throwIfAborted();
             messages.push({ role: "assistant", content: response.content });
             const toolResults = [];
             for (const block of response.content) {
@@ -97,6 +111,7 @@ export async function handleMessage(db, userMessage, onProgress) {
                 toolCount,
                 elapsedMs: Date.now() - startTime,
             });
+            throwIfAborted();
             response = await provider.sendMessage({
                 model: config.model,
                 maxTokens: useThinking ? 16000 : 4096,
@@ -106,6 +121,7 @@ export async function handleMessage(db, userMessage, onProgress) {
                 thinking: useThinking
                     ? { type: "enabled", budget_tokens: config.thinkingBudget }
                     : undefined,
+                signal,
             });
         }
         // Extract text response, restore PII for display
@@ -116,6 +132,9 @@ export async function handleMessage(db, userMessage, onProgress) {
         return responseText || "I looked into that but couldn't formulate a response. Could you try rephrasing?";
     }
     catch (error) {
+        if (error instanceof AbortedError || error?.name === "AbortError" || signal?.aborted) {
+            throw new AbortedError();
+        }
         if (error.status === 403) {
             if (useManaged()) {
                 return "Your API key was rejected. This usually means your subscription is inactive. Run `ray billing` to check your payment status, or `ray setup` to reconfigure.";

package/dist/ai/provider.d.ts

@@ -50,6 +50,7 @@ export interface SendMessageParams {
         type: "enabled";
         budget_tokens: number;
     };
+    signal?: AbortSignal;
 }
 export interface Provider {
     name: string;

package/dist/ai/providers/anthropic.js

@@ -17,7 +17,9 @@ export function createAnthropicProvider(opts) {
             if (params.thinking) {
                 apiParams.thinking = params.thinking;
             }
-            const response = await client.messages.create(apiParams);
+            const response = await client.messages.create(apiParams, {
+                signal: params.signal,
+            });
             // Filter thinking blocks and normalize content
             const content = [];
             for (const block of response.content) {

package/dist/ai/providers/openai-compat.js

@@ -19,7 +19,7 @@ export function createOpenAICompatibleProvider(opts) {
                     max_tokens: params.maxTokens,
                     messages,
                     tools: tools.length > 0 ? tools : undefined,
-                });
+                }, { signal: params.signal });
             }
             catch (e) {
                 if (e.status === 400 && e.message?.includes("max_tokens")) {
@@ -28,7 +28,7 @@ export function createOpenAICompatibleProvider(opts) {
                         max_completion_tokens: params.maxTokens,
                         messages,
                         tools: tools.length > 0 ? tools : undefined,
-                    });
+                    }, { signal: params.signal });
                 }
                 else {
                     throw e;

package/dist/cli/chat.d.ts

@@ -1 +1,5 @@
+/**
+ * Pre-mount orchestration: banner, briefing, account check + optional runLink,
+ * then hand off to the Ink-rendered ChatApp.
+ */
 export declare function startChat(): Promise<void>;

package/dist/cli/chat.js

@@ -1,307 +1,16 @@
 import chalk from "chalk";
 import { config } from "../config.js";
-import { banner, formatResponse, formatDuration, formatError } from "./format.js";
-/** Raw-mode line reader that renders content below the cursor while waiting for input */
-function rawReadLine(prompt, belowLines) {
-    return new Promise((resolve) => {
-        let buf = "";
-        let cursor = 0; // cursor position within buf
-        const out = process.stdout;
-        const promptLen = stripAnsi(prompt).length;
-        const cols = () => process.stdout.columns || 80;
-        // Rows occupied by prompt+text of the given length (accounting for wrap)
-        const calcRows = (len) => {
-            const total = promptLen + len;
-            return Math.max(1, Math.ceil(Math.max(1, total) / cols()));
-        };
-        // (row, col) of the position at offset `len` from the start of the prompt
-        const calcPos = (len) => {
-            const w = cols();
-            const abs = promptLen + len;
-            return { row: Math.floor(abs / w), col: abs % w };
-        };
-        let renderedRows = 1; // rows the prompt+buf occupy on screen
-        let curRow = 0; // current cursor row offset within the prompt area
-        // Full re-render: assumes cursor is at (curRow, *) within the prompt area. Moves
-        // to the top of the prompt, clears to end of screen, rewrites prompt+buf and
-        // belowLines, then positions cursor at `cursor` within buf.
-        const render = () => {
-            if (curRow > 0)
-                out.write(`\x1b[${curRow}A`);
-            out.write("\r");
-            // Clear from here to end of screen — drops all old wrapped rows AND belowLines
-            out.write("\x1b[J");
-            out.write(prompt + buf);
-            const endPos = calcPos(buf.length);
-            let fromRow = endPos.row;
-            let fromCol = endPos.col;
-            if (belowLines.length > 0) {
-                out.write("\n" + belowLines.join("\n"));
-                out.write(`\x1b[${belowLines.length}A`);
-                out.write("\r");
-                fromCol = 0;
-            }
-            const tgt = calcPos(cursor);
-            if (fromRow > tgt.row)
-                out.write(`\x1b[${fromRow - tgt.row}A`);
-            else if (tgt.row > fromRow)
-                out.write(`\x1b[${tgt.row - fromRow}B`);
-            if (tgt.col !== fromCol) {
-                out.write("\r");
-                if (tgt.col > 0)
-                    out.write(`\x1b[${tgt.col}C`);
-            }
-            renderedRows = calcRows(buf.length);
-            curRow = tgt.row;
-        };
-        // Find the start of the previous word boundary
-        const wordLeft = () => {
-            let p = cursor;
-            while (p > 0 && buf[p - 1] === " ")
-                p--; // skip trailing spaces
-            while (p > 0 && buf[p - 1] !== " ")
-                p--; // skip word chars
-            return p;
-        };
-        // Find the end of the next word boundary
-        const wordRight = () => {
-            let p = cursor;
-            while (p < buf.length && buf[p] !== " ")
-                p++; // skip word chars
-            while (p < buf.length && buf[p] === " ")
-                p++; // skip trailing spaces
-            return p;
-        };
-        // Initial render
-        render();
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding("utf8");
-        const cleanup = () => {
-            process.stdin.setRawMode(false);
-            process.stdin.removeListener("data", onData);
-            process.stdin.pause();
-        };
-        const onData = (chunk) => {
-            for (let i = 0; i < chunk.length; i++) {
-                const code = chunk.charCodeAt(i);
-                // Ctrl+C / Ctrl+D
-                if (code === 3 || code === 4) {
-                    cleanup();
-                    out.write("\n");
-                    resolve({ input: "\x03", rows: renderedRows });
-                    return;
-                }
-                // Ctrl+A — beginning of line
-                if (code === 1) {
-                    if (cursor > 0) {
-                        cursor = 0;
-                        render();
-                    }
-                    continue;
-                }
-                // Ctrl+E — end of line
-                if (code === 5) {
-                    if (cursor < buf.length) {
-                        cursor = buf.length;
-                        render();
-                    }
-                    continue;
-                }
-                // Ctrl+K — delete from cursor to end of line
-                if (code === 11) {
-                    if (cursor < buf.length) {
-                        buf = buf.slice(0, cursor);
-                        render();
-                    }
-                    continue;
-                }
-                // Ctrl+U — delete from cursor to beginning of line
-                if (code === 21) {
-                    if (cursor > 0) {
-                        buf = buf.slice(cursor);
-                        cursor = 0;
-                        render();
-                    }
-                    continue;
-                }
-                // Ctrl+W — delete word backward
-                if (code === 23) {
-                    if (cursor > 0) {
-                        const target = wordLeft();
-                        buf = buf.slice(0, target) + buf.slice(cursor);
-                        cursor = target;
-                        render();
-                    }
-                    continue;
-                }
-                // Enter
-                if (code === 13) {
-                    cleanup();
-                    // Move cursor to end of buf
-                    const end = calcPos(buf.length);
-                    if (end.row > curRow)
-                        out.write(`\x1b[${end.row - curRow}B`);
-                    else if (curRow > end.row)
-                        out.write(`\x1b[${curRow - end.row}A`);
-                    out.write("\r");
-                    if (end.col > 0)
-                        out.write(`\x1b[${end.col}C`);
-                    // Move past the below-content lines, then newline
-                    for (let j = 0; j < belowLines.length; j++)
-                        out.write("\x1b[1B");
-                    out.write("\n");
-                    resolve({ input: buf, rows: renderedRows });
-                    return;
-                }
-                // Backspace
-                if (code === 127 || code === 8) {
-                    if (cursor > 0) {
-                        buf = buf.slice(0, cursor - 1) + buf.slice(cursor);
-                        cursor--;
-                        render();
-                    }
-                    continue;
-                }
-                // Escape sequences (arrow keys, Option+key, etc.)
-                if (code === 27) {
-                    // Option+Backspace — ESC followed by DEL (0x7f)
-                    if (i + 1 < chunk.length && chunk.charCodeAt(i + 1) === 127) {
-                        i++; // consume the DEL
-                        if (cursor > 0) {
-                            const target = wordLeft();
-                            buf = buf.slice(0, target) + buf.slice(cursor);
-                            cursor = target;
-                            render();
-                        }
-                        continue;
-                    }
-                    // Option+b / Option+f — ESC followed by 'b' or 'f'
-                    if (i + 1 < chunk.length && chunk[i + 1] === "b") {
-                        i++;
-                        const target = wordLeft();
-                        if (target < cursor) {
-                            cursor = target;
-                            render();
-                        }
-                        continue;
-                    }
-                    if (i + 1 < chunk.length && chunk[i + 1] === "f") {
-                        i++;
-                        const target = wordRight();
-                        if (target > cursor) {
-                            cursor = target;
-                            render();
-                        }
-                        continue;
-                    }
-                    if (i + 1 < chunk.length && chunk[i + 1] === "[") {
-                        i += 2; // skip past ESC [
-                        // Collect any intermediate bytes (modifiers like "1;3")
-                        let seq = "";
-                        while (i < chunk.length && chunk.charCodeAt(i) < 64) {
-                            seq += chunk[i];
-                            i++;
-                        }
-                        if (i < chunk.length) {
-                            const final = chunk[i];
-                            // Modifier keys: ;3 = Option, ;5 = Ctrl, ;9 = Cmd (Kitty protocol)
-                            const isWordMod = seq === "1;3" || seq === "1;5" || seq === "1;9";
-                            if (final === "D") {
-                                if (isWordMod) {
-                                    const target = wordLeft();
-                                    if (target < cursor) {
-                                        cursor = target;
-                                        render();
-                                    }
-                                }
-                                else if (cursor > 0) {
-                                    cursor--;
-                                    render();
-                                }
-                            }
-                            else if (final === "C") {
-                                if (isWordMod) {
-                                    const target = wordRight();
-                                    if (target > cursor) {
-                                        cursor = target;
-                                        render();
-                                    }
-                                }
-                                else if (cursor < buf.length) {
-                                    cursor++;
-                                    render();
-                                }
-                            }
-                            else if (final === "H") {
-                                if (cursor > 0) {
-                                    cursor = 0;
-                                    render();
-                                }
-                            }
-                            else if (final === "F") {
-                                if (cursor < buf.length) {
-                                    cursor = buf.length;
-                                    render();
-                                }
-                            }
-                            else if (final === "u") {
-                                // Kitty keyboard protocol: ESC [ codepoint ; modifier u
-                                const parts = seq.split(";");
-                                const codepoint = parseInt(parts[0], 10);
-                                const mod = parts.length > 1 ? parseInt(parts[1], 10) : 1;
-                                const hasCmd = (mod - 1) & 8; // super/cmd bit
-                                const hasCtrl = (mod - 1) & 4; // ctrl bit
-                                if (codepoint === 127 && (hasCmd || hasCtrl)) {
-                                    // Cmd+Backspace / Ctrl+Backspace — delete to line start
-                                    if (cursor > 0) {
-                                        buf = buf.slice(cursor);
-                                        cursor = 0;
-                                        render();
-                                    }
-                                }
-                            }
-                            // Ignore other sequences (up/down, etc.)
-                        }
-                    }
-                    continue;
-                }
-                // Printable characters
-                if (code >= 32) {
-                    buf = buf.slice(0, cursor) + chunk[i] + buf.slice(cursor);
-                    cursor++;
-                    render();
-                }
-            }
-        };
-        process.stdin.on("data", onData);
-    });
-}
-/** Strip ANSI escape codes to get visible length */
-function stripAnsi(str) {
-    return str.replace(/\x1b\[[0-9;]*m/g, "");
-}
-const THINKING_PHRASES = [
-    "Thinking...",
-    "Crunching numbers...",
-    "Reviewing your accounts...",
-    "Analyzing...",
-    "Looking into that...",
-    "Pulling up your data...",
-    "Checking the numbers...",
-    "On it...",
-];
-function getThinkingText() {
-    return THINKING_PHRASES[Math.floor(Math.random() * THINKING_PHRASES.length)];
-}
+import { banner } from "./format.js";
+/**
+ * Pre-mount orchestration: banner, briefing, account check + optional runLink,
+ * then hand off to the Ink-rendered ChatApp.
+ */
 export async function startChat() {
-    const ora = (await import("ora")).default;
     const { getDb } = await import("../db/connection.js");
-    const { handleMessage, TOOL_LABELS } = await import("../ai/agent.js");
     const { isContextEmpty } = await import("../ai/context.js");
     const { cliBriefing } = await import("../ai/insights.js");
     const db = getDb();
-    // Show logo + briefing
+    // Banner + briefing (plain stdout — becomes scrollback above the Ink region)
     console.log("");
     console.log(banner());
     console.log("");
@@ -327,143 +36,18 @@ export async function startChat() {
         console.log(chalk.yellow("No accounts linked yet. Let's connect one first.\n"));
         const { runLink } = await import("./commands.js");
         await runLink();
-        // Re-check after linking
         const recheck = db.prepare("SELECT COUNT(*) as count FROM accounts").get();
         if (recheck.count === 0) {
             console.log(chalk.red("\nNo accounts linked. Run 'ray link' when you're ready.\n"));
             return;
         }
     }
-    // Auto-trigger onboarding for new users
+    // Fire onboarding if context is empty
+    let onboardingPrompt;
     if (isContextEmpty()) {
         console.log(chalk.yellowBright("Welcome! Let me review your accounts and help set up your financial profile.\n"));
-        const spinner = ora({ text: "Reviewing your accounts...", color: "yellow", discardStdin: false }).start();
-        try {
-            const response = await handleMessage(db, "I just connected my financial accounts. Help me set up my financial profile.");
-            spinner.stop();
-            console.log(`\n${response}\n`);
-        }
-        catch (err) {
-            spinner.stop();
-            console.error(formatError(err, "Onboarding error"));
-        }
-    }
-    // Background re-sync for recently linked accounts (Plaid backfill can take hours)
-    let bgSyncTimer = null;
-    const oldestAccount = db.prepare(`SELECT MIN(created_at) as ts FROM institutions`).get();
-    if (oldestAccount?.ts) {
-        const ageMs = Date.now() - new Date(oldestAccount.ts + "Z").getTime();
-        if (ageMs < 6 * 60 * 60 * 1000) { // linked within last 6 hours
-            const { runDailySync } = await import("../daily-sync.js");
-            bgSyncTimer = setInterval(async () => {
-                // Silence all output during background sync
-                const origWrite = process.stdout.write;
-                const origErr = process.stderr.write;
-                process.stdout.write = () => true;
-                process.stderr.write = () => true;
-                try {
-                    await runDailySync(db);
-                }
-                catch { }
-                process.stdout.write = origWrite;
-                process.stderr.write = origErr;
-            }, 15 * 60 * 1000); // every 15 minutes
-            bgSyncTimer.unref(); // don't prevent process exit
-        }
-    }
-    const shutdown = () => {
-        if (bgSyncTimer)
-            clearInterval(bgSyncTimer);
-        console.log(chalk.dim("\nGoodbye!"));
-        process.exit(0);
-    };
-    const hints = [
-        "try: how am i doing this month?",
-        "try: where's my money going?",
-        "try: what bills are coming up?",
-        "try: help me save more",
-        "try: am i on track for my goals?",
-        "try: any unusual spending lately?",
-        "try: what should i focus on?",
-        "try: compare this month to last month",
-        "try: set a budget for dining out",
-        "try: how much did i spend on groceries?",
-    ];
-    let hintIdx = Math.floor(Math.random() * hints.length);
-    const getFooterText = () => {
-        const lastSync = db.prepare(`SELECT MAX(updated_at) as ts FROM accounts`).get();
-        let syncStr = "";
-        if (lastSync.ts) {
-            const diffMs = Date.now() - new Date(lastSync.ts + "Z").getTime();
-            const mins = Math.floor(diffMs / 60000);
-            if (mins < 1)
-                syncStr = "synced just now";
-            else if (mins < 60)
-                syncStr = `synced ${mins}m ago`;
-            else if (mins < 1440)
-                syncStr = `synced ${Math.floor(mins / 60)}h ago`;
-            else
-                syncStr = `synced ${Math.floor(mins / 1440)}d ago`;
-        }
-        const parts = ["ray"];
-        if (syncStr)
-            parts.push(syncStr);
-        parts.push(hints[hintIdx]);
-        parts.push("ctrl+c to exit");
-        hintIdx = (hintIdx + 1) % hints.length;
-        return parts.join("  ·  ");
-    };
-    while (true) {
-        const cols = process.stdout.columns || 80;
-        const rule = chalk.dim("─".repeat(cols));
-        const footerText = chalk.dim(`  ${getFooterText()}`);
-        // Ensure room below for top rule + prompt + bottom rule + footer (3 lines below start)
-        process.stdout.write("\n\n\n");
-        process.stdout.write("\x1b[3A\r");
-        // Print top rule, then prompt with bottom rule + footer rendered below
-        console.log(rule);
-        const { input, rows: promptRows } = await rawReadLine(chalk.dim("❯ "), [rule, footerText]);
-        const trimmed = input.trim();
-        if (!trimmed) {
-            // Clear the prompt frame (prompt + bottom rule + footer); leave top rule
-            process.stdout.write(`\x1b[${promptRows + 2}A\r`);
-            for (let i = 0; i < promptRows + 3; i++)
-                process.stdout.write("\x1b[2K\x1b[1B");
-            process.stdout.write(`\x1b[${promptRows + 3}A\r`);
-            continue;
-        }
-        // Replace prompt frame (top rule + prompt + bottom rule + footer) with gray-bg user message
-        const frameRows = promptRows + 3;
-        process.stdout.write(`\x1b[${frameRows}A\r`);
-        for (let i = 0; i < frameRows; i++)
-            process.stdout.write("\x1b[2K\x1b[1B");
-        process.stdout.write(`\x1b[${frameRows}A\r`);
-        // Print user message with gray background, padded to full width
-        const msgText = `❯ ${trimmed}`;
-        const pad = Math.max(0, cols - msgText.length);
-        console.log(chalk.bgGray.white(msgText + " ".repeat(pad)));
-        if (trimmed === "\x03" || trimmed === "/quit" || trimmed === "/exit" || trimmed === "/q") {
-            shutdown();
-            break;
-        }
-        const spinner = ora({ text: getThinkingText(), color: "cyan", discardStdin: false }).start();
-        const onProgress = ({ phase, toolName, toolCount, elapsedMs }) => {
-            if (phase === "tool" && toolName) {
-                const label = TOOL_LABELS[toolName] || toolName;
-                spinner.text = `${label}... ${chalk.dim(`(${toolCount} ${toolCount === 1 ? "tool" : "tools"}, ${formatDuration(elapsedMs)})`)}`;
-            }
-            else if (phase === "responding" && toolCount > 0) {
-                spinner.text = `Composing response... ${chalk.dim(`(${toolCount} tools, ${formatDuration(elapsedMs)})`)}`;
-            }
-        };
-        try {
-            const response = await handleMessage(db, trimmed, onProgress);
-            spinner.stop();
-            console.log(`\n${formatResponse(response)}\n`);
-        }
-        catch (err) {
-            spinner.stop();
-            console.error(formatError(err));
-        }
+        onboardingPrompt = "I just connected my financial accounts. Help me set up my financial profile.";
     }
+    const { runChatApp } = await import("./ink/mount.js");
+    await runChatApp({ db, onboardingPrompt });
 }

package/dist/cli/commands.js

@@ -481,7 +481,7 @@ export function showRecap(period = "last_month") {
     // Income this period
     const income = db.prepare(`SELECT COALESCE(SUM(ABS(amount)), 0) as total FROM transactions
      WHERE amount < 0 AND date BETWEEN ? AND ? AND pending = 0
-     AND category NOT IN ('TRANSFER_IN')`).get(start, end);
+     AND category NOT IN ('TRANSFER_IN', 'LOAN_PAYMENTS', 'LOAN_PAYMENTS_CAR_PAYMENT', 'LOAN_PAYMENTS_PERSONAL_LOAN_PAYMENT')`).get(start, end);
     const totalSpent = spending.total || 0;
     const txnCount = spending.count || 0;
     if (txnCount === 0) {

package/dist/cli/ink/ChatApp.d.ts

@@ -0,0 +1,8 @@
+import type Database from "libsql";
+interface Props {
+    db: Database.Database;
+    /** Auto-kick-off message to send silently on mount (onboarding). */
+    onboardingPrompt?: string;
+}
+export declare function ChatApp({ db, onboardingPrompt }: Props): import("react/jsx-runtime").JSX.Element;
+export {};