@thematica/prism-tui 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# Prism terminal app
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Prism researches an investment theme and shows four ranked lists with source quotes.
+This package runs the terminal interface against Prism's cloud API. This release targets
+macOS and requires Node 22 or newer.
+
+Install from npm:
+
+```sh
+npm install -g @thematica/prism-tui
+prism login
+prism whoami
+prism start
+```
+
+`prism whoami` shows your Thematica wallet balance and Prism spending limits.
+Check the balance and limits before starting a research run.
+It does not yet show your sign-in email. Check the email on your Thematica profile
+before approving a terminal sign-in. `prism logout` revokes this computer's
+credential; sign out separately in the browser before using another account.
+A non-tester needs purchased credit;
+an invited Prism tester can use the daily free allowance first. Prism shows
+the run's measured cost when it finishes. This package does not yet display
+the separate free and purchased funding amounts.
+If your balance or spending-limit room is exhausted before a waiting job starts,
+Prism pauses your research queue. Add credit or change the limit, then run
+`prism resume` to start it again. A top-up alone does not resume jobs.
+
+The Prism and Thematica browser sign-in services are live. Access to research
+still requires a Prism invitation while paid credit purchases are being built.
+
+`prism login` opens Thematica in your browser. Sign in, confirm the code shown in your
+terminal, and return to the terminal. The app receives its own Prism credential and saves
+it in a private file on this computer. You do not paste your profile API key. If the browser
+does not open, copy the displayed sign-in link into your browser.
+
+`prism logout` revokes the terminal credential at Prism and removes its local copy.
+The credential also expires after seven days.

package/dist/packages/prism-tui/src/account.d.ts

@@ -0,0 +1,4 @@
+import type { AccountView } from "../../../src/cli/app/api.js";
+/** Account details after browser sign-in and in `prism whoami`. Only V2's live summary is a balance. */
+export declare function accountText(view: AccountView, thematicaOrigin: string): string;
+//# sourceMappingURL=account.d.ts.map

package/dist/packages/prism-tui/src/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../../src/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAU/D,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAc9E"}

package/dist/packages/prism-tui/src/account.js

@@ -0,0 +1,25 @@
+const dollars = (value) => {
+    const negative = value.startsWith("-");
+    const raw = negative ? value.slice(1) : value;
+    const [whole, fractional = ""] = raw.split(".");
+    const centsOrMore = fractional.replace(/0+$/, "").padEnd(2, "0");
+    return `${negative ? "-" : ""}$${whole}.${centsOrMore}`;
+};
+/** Account details after browser sign-in and in `prism whoami`. Only V2's live summary is a balance. */
+export function accountText(view, thematicaOrigin) {
+    const wallet = view.wallet;
+    if (wallet === undefined)
+        return `Prism account: ${view.account.name}`;
+    const period = { day: "day", week: "week", month: "month" }[wallet.limits.period];
+    const limit = (value) => value === null ? "No limit" : dollars(value);
+    return [
+        "Signed in to Prism",
+        `Thematica wallet balance: ${dollars(wallet.balance_usd)}`,
+        `Prism usage in ${wallet.prism_usage_month}: ${dollars(wallet.prism_usage_this_month_usd)}`,
+        ...(view.wallet_settlement_pending ? ["A finished Prism run is still being posted to your wallet."] : []),
+        ...(view.queue?.status === "paused" ? ["Research queue paused. Add credit or change your spending limit, then run prism resume."] : []),
+        `Spending limits per ${period}: Prism ${limit(wallet.limits.prism_usd)} · Overall ${limit(wallet.limits.overall_usd)}`,
+        `Manage Prism settings: ${thematicaOrigin}/profile?product=prism`,
+    ].join("\n");
+}
+//# sourceMappingURL=account.js.map

package/dist/packages/prism-tui/src/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/account.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,eAAuB;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,kBAAkB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrF,OAAO;QACL,oBAAoB;QACpB,6BAA6B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QAC1D,kBAAkB,MAAM,CAAC,iBAAiB,KAAK,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAC,EAAE;QAC3F,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,yFAAyF,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvI,uBAAuB,MAAM,WAAW,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QACtH,0BAA0B,eAAe,wBAAwB;KAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/packages/prism-tui/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/packages/prism-tui/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../src/cli.ts"],"names":[],"mappings":""}

package/dist/packages/prism-tui/src/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { loadCredential, removeCredential, saveCredential, credentialsPath } from "./credentials.js";
+import { AUTH_BASE_URL, deviceLogin, PRISM_API_URL } from "./device-login.js";
+import { accountText } from "./account.js";
+import { httpApi } from "../../../src/cli/app/api.js";
+import { runApp } from "../../../src/cli/app/run-app.js";
+function openBrowser(url) {
+    return new Promise((resolve, reject) => {
+        const command = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : null;
+        if (command === null) {
+            resolve();
+            return;
+        }
+        const child = spawn(command, [url], { stdio: "ignore", detached: true });
+        child.once("error", reject);
+        child.once("spawn", () => { child.unref(); resolve(); });
+    });
+}
+function usage() {
+    console.log("Prism terminal app\n  prism login   Open browser sign-in\n  prism start   Research a theme\n  prism whoami  Check this computer's Prism account\n  prism resume  Resume your paused research queue\n  prism logout  Remove this computer's credential");
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    if (command === "login") {
+        if (rest.length)
+            throw new Error("prism login takes no options");
+        console.log("Starting Prism sign-in…");
+        const key = await deviceLogin({
+            authBaseUrl: AUTH_BASE_URL,
+            show: (code, url) => console.log(`Confirm code ${code} in your browser:\n${url}\nWaiting for approval…`),
+            open: openBrowser,
+        });
+        const api = httpApi(PRISM_API_URL, key);
+        // A wallet read may fail while the new credential is valid. Verify the key on a
+        // Prism-only route before saving it, then treat wallet details as optional display.
+        try {
+            await api.runs(1);
+        }
+        catch {
+            throw new Error("Prism did not accept the new credential. Run prism login again.");
+        }
+        const previous = await loadCredential();
+        await saveCredential({ version: 1, api_url: PRISM_API_URL, key });
+        if (previous !== null && previous.key !== key) {
+            const revoked = await fetch(`${previous.api_url}/v1/cli/session`, { method: "DELETE", headers: { authorization: `Bearer ${previous.key}` } }).catch(() => null);
+            if (revoked === null || (revoked.status !== 204 && revoked.status !== 401))
+                console.error("The previous terminal credential could not be revoked; it will expire within seven days.");
+        }
+        try {
+            console.log(accountText(await api.account(), AUTH_BASE_URL));
+        }
+        catch {
+            console.log("Signed in to Prism. Thematica wallet details are temporarily unavailable; run prism whoami later.");
+        }
+        console.log("Run prism start to research a theme.");
+        return;
+    }
+    if (command === "logout") {
+        if (rest.length)
+            throw new Error("prism logout takes no options");
+        const credential = await loadCredential();
+        if (credential !== null) {
+            let response;
+            try {
+                response = await fetch(`${credential.api_url}/v1/cli/session`, { method: "DELETE", headers: { authorization: `Bearer ${credential.key}` } });
+            }
+            catch {
+                throw new Error("Cannot reach Prism to revoke this computer's credential. Try again while online.");
+            }
+            if (response.status !== 204 && response.status !== 401)
+                throw new Error(`Prism could not revoke this computer's credential (${response.status}).`);
+        }
+        await removeCredential();
+        console.log("Signed out. This computer's credential is revoked.");
+        return;
+    }
+    if (command === "whoami") {
+        if (rest.length)
+            throw new Error("prism whoami takes no options");
+        const credential = await loadCredential();
+        if (credential === null)
+            throw new Error("You are not signed in. Run prism login.");
+        const view = await httpApi(credential.api_url, credential.key).account();
+        console.log(accountText(view, AUTH_BASE_URL));
+        return;
+    }
+    if (command === "resume") {
+        if (rest.length)
+            throw new Error("prism resume takes no options");
+        const credential = await loadCredential();
+        if (credential === null)
+            throw new Error("You are not signed in. Run prism login.");
+        const result = await httpApi(credential.api_url, credential.key).resumeQueue();
+        console.log(result.resumed ? "Your Prism research queue is active again." : "Your Prism research queue is already active.");
+        return;
+    }
+    if (command === "start") {
+        if (rest.length)
+            throw new Error("prism start takes no options in the installed app");
+        if (!process.stdin.isTTY)
+            throw new Error("prism start needs a terminal to type in");
+        const credential = await loadCredential();
+        if (credential === null)
+            throw new Error("You are not signed in. Run prism login.");
+        await runApp({ url: credential.api_url, key: credential.key, place: "cloud", settingsFile: credentialsPath() });
+        return;
+    }
+    usage();
+    if (command && command !== "help" && command !== "--help")
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    console.error(`prism: ${error.message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/packages/prism-tui/src/cli.js.map

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

package/dist/packages/prism-tui/src/credentials.d.ts

@@ -0,0 +1,11 @@
+export interface Credential {
+    readonly version: 1;
+    readonly api_url: string;
+    readonly key: string;
+}
+export declare function credentialsPath(): string;
+/** Replace atomically; a failed write never erases a working login. */
+export declare function saveCredential(credential: Credential, path?: string): Promise<void>;
+export declare function loadCredential(path?: string): Promise<Credential | null>;
+export declare function removeCredential(path?: string): Promise<void>;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/packages/prism-tui/src/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../../src/credentials.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAEnG,wBAAgB,eAAe,IAAI,MAAM,CAExC;AASD,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpG;AAED,wBAAsB,cAAc,CAAC,IAAI,SAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAczF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E"}

package/dist/packages/prism-tui/src/credentials.js

@@ -0,0 +1,53 @@
+import { randomUUID } from "node:crypto";
+import { chmod, lstat, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function credentialsPath() {
+    return join(homedir(), ".config", "thematica-prism", "credentials.json");
+}
+async function privateDirectory(path) {
+    const directory = dirname(path);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const info = await lstat(directory);
+    if (!info.isDirectory() || info.isSymbolicLink() || (info.mode & 0o077) !== 0)
+        throw new Error("Prism's credential directory must be private (mode 0700).");
+}
+/** Replace atomically; a failed write never erases a working login. */
+export async function saveCredential(credential, path = credentialsPath()) {
+    await privateDirectory(path);
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(credential)}\n`, { mode: 0o600, flag: "wx" });
+        await chmod(temporary, 0o600);
+        await rename(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+export async function loadCredential(path = credentialsPath()) {
+    let info;
+    try {
+        info = await lstat(path);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    if (!info.isFile() || (info.mode & 0o077) !== 0)
+        throw new Error("Prism's credential file must be private (mode 0600).");
+    const value = JSON.parse(await readFile(path, "utf8"));
+    if (typeof value !== "object" || value === null || value.version !== 1 ||
+        typeof value.api_url !== "string" || typeof value.key !== "string" ||
+        !/^prism_[A-Za-z0-9_-]{43}$/.test(value.key))
+        throw new Error("Prism's saved credential is invalid. Run prism login again.");
+    const url = new URL(value.api_url);
+    if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash || url.pathname !== "/")
+        throw new Error("Prism's saved API address is invalid. Run prism login again.");
+    return value;
+}
+export async function removeCredential(path = credentialsPath()) {
+    await rm(path, { force: true });
+}
+//# sourceMappingURL=credentials.js.map

package/dist/packages/prism-tui/src/credentials.js.map

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

package/dist/packages/prism-tui/src/device-login.d.ts

@@ -0,0 +1,14 @@
+export declare const AUTH_BASE_URL = "https://sim.thematica.ai";
+export declare const PRISM_API_URL = "https://prism-jfczigc2sa-ul.a.run.app";
+export interface DeviceLoginOptions {
+    authBaseUrl?: string;
+    apiBaseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    sleep?: (milliseconds: number) => Promise<void>;
+    now?: () => number;
+    show: (code: string, url: string) => void;
+    open: (url: string) => Promise<void>;
+}
+/** RFC 8628 style device flow. The browser approves a code; the CLI alone receives the credential. */
+export declare function deviceLogin(options: DeviceLoginOptions): Promise<string>;
+//# sourceMappingURL=device-login.d.ts.map

package/dist/packages/prism-tui/src/device-login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-login.d.ts","sourceRoot":"","sources":["../../../../src/device-login.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,6BAA6B,CAAC;AACxD,eAAO,MAAM,aAAa,0CAA0C,CAAC;AAWrE,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAiCD,sGAAsG;AACtG,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC9E"}

package/dist/packages/prism-tui/src/device-login.js

@@ -0,0 +1,78 @@
+import { createHash, randomBytes } from "node:crypto";
+export const AUTH_BASE_URL = "https://sim.thematica.ai";
+export const PRISM_API_URL = "https://prism-jfczigc2sa-ul.a.run.app";
+function validBase(raw) {
+    const url = new URL(raw);
+    if (url.username || url.password || url.search || url.hash || url.pathname !== "/" || (url.protocol !== "https:" && !(url.protocol === "http:" && ["localhost", "127.0.0.1"].includes(url.hostname)))) {
+        throw new Error("The sign-in service must be an HTTPS origin (or localhost for development).");
+    }
+    return url;
+}
+function parseStart(value, base) {
+    if (typeof value !== "object" || value === null)
+        throw new Error("The sign-in service returned an invalid response.");
+    const v = value;
+    if (typeof v.device_code !== "string" || !/^[A-Za-z0-9_-]{43}$/.test(v.device_code) || typeof v.user_code !== "string" || !/^[A-HJ-NP-Z2-9]{5}-[A-HJ-NP-Z2-9]{5}$/.test(v.user_code) ||
+        typeof v.verification_uri !== "string" || typeof v.verification_uri_complete !== "string" ||
+        !Number.isInteger(v.expires_in) || (v.expires_in ?? 0) < 60 || (v.expires_in ?? 0) > 900 ||
+        !Number.isInteger(v.interval) || (v.interval ?? 0) < 1 || (v.interval ?? 0) > 30) {
+        throw new Error("The sign-in service returned an invalid device challenge.");
+    }
+    for (const link of [v.verification_uri, v.verification_uri_complete]) {
+        const url = new URL(link);
+        if (url.origin !== base.origin || url.pathname !== "/prism/device" || url.username || url.password || url.hash)
+            throw new Error("The sign-in link points outside Thematica.");
+    }
+    if (new URL(v.verification_uri).search !== "" || new URL(v.verification_uri_complete).searchParams.get("code") !== v.user_code)
+        throw new Error("The sign-in link has an invalid code.");
+    return v;
+}
+async function json(response) {
+    const value = await response.json().catch(() => null);
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error("The sign-in service returned invalid JSON.");
+    return value;
+}
+/** RFC 8628 style device flow. The browser approves a code; the CLI alone receives the credential. */
+export async function deviceLogin(options) {
+    const authBase = validBase(options.authBaseUrl ?? AUTH_BASE_URL);
+    const apiBase = validBase(options.apiBaseUrl ?? PRISM_API_URL);
+    const request = options.fetch ?? globalThis.fetch;
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const now = options.now ?? Date.now;
+    const key = `prism_${randomBytes(32).toString("base64url")}`;
+    const started = await request(new URL("/v1/device/start", apiBase), {
+        method: "POST",
+        headers: { "content-type": "application/json", "cache-control": "no-store" },
+        body: JSON.stringify({ key_hash: createHash("sha256").update(key).digest("hex"), key_prefix: key.slice(0, 12) }),
+    });
+    if (!started.ok)
+        throw new Error(`Sign-in could not start (${started.status}).`);
+    const challenge = parseStart(await json(started), authBase);
+    const deadline = now() + challenge.expires_in * 1000;
+    options.show(challenge.user_code, challenge.verification_uri_complete);
+    await options.open(challenge.verification_uri_complete).catch(() => { });
+    let interval = challenge.interval * 1000;
+    while (now() + interval < deadline) {
+        await sleep(interval);
+        const response = await request(new URL("/v1/device/token", apiBase), {
+            method: "POST",
+            headers: { "content-type": "application/json", "cache-control": "no-store" },
+            body: JSON.stringify({ device_code: challenge.device_code }),
+        });
+        const body = await json(response);
+        if (response.ok && body.status === "authorized")
+            return key;
+        switch (body.error) {
+            case "authorization_pending": continue;
+            case "slow_down":
+                interval += 5000;
+                continue;
+            case "access_denied": throw new Error("Sign-in was denied in the browser.");
+            case "expired_token": throw new Error("The sign-in code expired. Run prism login again.");
+            default: throw new Error(`Sign-in could not finish (${response.status}).`);
+        }
+    }
+    throw new Error("The sign-in code expired. Run prism login again.");
+}
+//# sourceMappingURL=device-login.js.map

package/dist/packages/prism-tui/src/device-login.js.map

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

package/dist/src/cli/answer.d.ts

@@ -0,0 +1,219 @@
+import { type AmountToShow, rateNote, usdShort } from "../market/amounts.js";
+/** How many months old a fact sheet may be and still count (src/facts/fresh.ts), for the words readers see. */
+export { SHEET_MONTHS } from "../facts/fresh.js";
+/** How amounts are written (src/market/amounts.ts), for the app and the command. */
+export { rateNote, usdShort };
+/**
+ * The answer a finished run returns (GET /v1/runs/{id}), as the prism command and the terminal app
+ * read it, and the words both show for it. src/find/run.ts writes it.
+ */
+/** A quote and where it comes from; `period` is when its figure was true, as the sheet writes it ("fiscal 2026"; since 2026-10-21). */
+export interface Quote {
+    text: string | null;
+    form: string | null;
+    accession: string | null;
+    item: string | null;
+    filed_at: string | null;
+    period?: string | null;
+    url: string | null;
+}
+/**
+ * The Federal Reserve's rate an amount in another currency was turned into US dollars at (since
+ * 2026-10-23): the amount's currency, US dollars per one unit of it, the rate's day and its source.
+ */
+export interface Fx {
+    currency: string;
+    rate: number;
+    date: string;
+    source: string;
+}
+export interface Row {
+    ticker: string;
+    name: string;
+    market_value?: {
+        usd: number;
+        as_of: string;
+        source: string;
+    } | null;
+    no_market_value: boolean;
+    direction?: string;
+    tier?: string;
+    influence?: string | null;
+    /** The checker's one-line reason. */
+    reason?: string | null;
+    /**
+     * `text` as the filings give it; `amount_usd` and `fx`, its dollars at the Federal Reserve's rate when
+     * it is in another currency (since 2026-10-23); `currency`, `multiplier` and `display`, its currency,
+     * what its number counts in and how lists show it (later on 2026-10-23; an older answer has none).
+     */
+    revenue_from_theme: {
+        text: string;
+        usd?: number;
+        amount_usd?: number | null;
+        fx?: Fx | null;
+        currency?: string | null;
+        multiplier?: number | null;
+        display?: string;
+        period?: string | null;
+        quote?: Quote | null;
+    } | null;
+    no_figure_in_annual_report: boolean;
+    /** The filings give a figure, but it gave way to the purity step's estimate, shown instead (since 2026-10-23). */
+    figure_gave_way?: boolean;
+    /** Prism's estimate of the revenue from the theme, when the filings give no figure, or the one they give gave way (since 2026-10-20). */
+    revenue_estimate_usd?: number | null;
+    no_filings_to_quote: boolean;
+    /** The fact-sheet quotes behind the call. */
+    evidence?: Quote[];
+}
+export type Bands = Record<string, Row[]>;
+export interface Answer {
+    /** `theme.description`: the run's description, the idea's text after its title, null when it has none (since 2026-10-24; an older answer has no such field). */
+    run_id: string;
+    took_seconds: number;
+    theme: {
+        title: string;
+        description?: string | null;
+    };
+    partial: boolean;
+    partial_reason?: string;
+    /** The day the run asks about: its sheets are from the 13 months before it, and its estimates are of it (since 2026-10-21). */
+    as_of?: string;
+    /** `from_theme`: the theme's size words that set the market-cap range, when the caller set none (since 2026-10-21). */
+    filters: {
+        min_market_value_usd: number | null;
+        max_market_value_usd: number | null;
+        exclude_etfs: boolean;
+        exclude_adrs: boolean;
+        from_theme?: string;
+    };
+    reports: {
+        purest: Bands;
+        biggest: Bands;
+        influential: Bands;
+    };
+    hurt: Bands;
+    checked: {
+        candidates: number;
+        after_filters: number;
+        checked: number;
+        exposed: number;
+    };
+    cost: {
+        usd: number;
+        llm_calls: number;
+    };
+    versions: Record<string, string>;
+}
+export type ListKey = "purest" | "biggest" | "influential" | "hurt";
+/**
+ * The four lists in the order they are shown: the command's headings, the app's tab labels, what each
+ * list means in plain words, shown under the app's tabs (Ben, 2026-10-20: "not everybody has the
+ * context that I have"), worded from the checker's and the ranking steps' own definitions, and each
+ * list's bands.
+ */
+export declare const REPORTS: ReadonlyArray<{
+    key: ListKey;
+    title: string;
+    label: string;
+    description: string;
+    bands: ReadonlyArray<readonly [string, string]>;
+}>;
+export declare const bandsOf: (a: Answer, key: ListKey) => Bands;
+/** What a run is doing, in the words both show while it runs. */
+export declare const STEPS: Record<string, string>;
+/** Pasted text keeps the line breaks and indents of where it came from; one line reads better, so runs of spaces become one. */
+export declare const oneLine: (s: string) => string;
+/**
+ * A quoted amount in dollars or its own currency, or null when the text is not an amount, or when its
+ * number is not written plainly (since 2026-10-23): a decimal comma ("€1,5 billion"), commas that are
+ * not thousands ("1,271,1") and thousands split by spaces ("€3 085 million") are left as written,
+ * never read as another number.
+ */
+export declare function amountValue(text: string): number | null;
+/**
+ * A quoted amount written short from its text alone, as answers and fact sheets from before the API
+ * said each amount's currency (2026-10-23) are shown: "US$19,196 million" reads "US$19.2B" (it read
+ * "$19.2B" until Ben's ruling of 2026-10-23), "¥13,069,012 thousand" keeps its "¥", since the text
+ * alone does not say whose. The same number, rounded; other text is left as it is. A figure of
+ * several amounts shows each one, "C$2.9B + C$562M", so it matches the sum the most-money list ranks by.
+ */
+export declare function shortAmount(text: string): string;
+/**
+ * An amount from its text, as before the API said its currency (Ben, 2026-10-22): as written, short;
+ * or, when Prism turned it into US dollars at the Federal Reserve's rate, the dollars first and the
+ * original in brackets, "US$1.2B (R$6.5B)". A word such as "over" stays with both. The rate is named
+ * once, after the figure's period (rateNote). The fact itself is never changed: its number stays with
+ * its quote. An older answer carries no currency of its own, but a rate names one: its originals are
+ * read in that currency, so a shared "¥" shows as "CNY" and "MXN 8,554,356 thousand" as "MXN 8.6B".
+ */
+export declare function withUsd(text: string, usd: number | null | undefined, fx: Fx | null | undefined): string;
+/** The rate an amount was converted at, when it was: its dollars and its rate both came with it. */
+export declare const convertedAt: (usd: number | null | undefined, fx: Fx | null | undefined) => Fx | null;
+/**
+ * One amount as Prism's API gives it (Ben, 2026-10-23: "Use the standard format: US$303.2B in lists,
+ * US$303,154 million beside the quote, ISO codes where a currency symbol is shared"): its text as the
+ * sheet writes it; its dollars and rate when converted; `currency`, which the API settles from the
+ * report and the quote, null when it is not clear, absent from an older Prism; `display`, how lists
+ * show it; and `scaleConfirmed` false when the fact's scale is not confirmed.
+ */
+export interface ApiAmount {
+    text: string;
+    usd?: number | null;
+    fx?: Fx | null;
+    currency?: string | null;
+    display?: string | null;
+    scaleConfirmed?: boolean;
+}
+/** The amount ready to show, with the currency the API settled: the app has neither the report nor, for a figure, every quote. */
+export declare function toShow(a: ApiAmount): AmountToShow;
+/** An amount in lists and sentences: the API's `display`, "US$2.6B (R$14.2B)", "PEN 10.9B"; from its text, as before, when the API did not say its currency. */
+export declare function amountText(a: ApiAmount): string;
+/**
+ * An amount inside a name's brackets, so brackets never nest: "US$54.8B, or R$300.0B", a note after a
+ * comma, "¥700 million, currency not stated".
+ */
+export declare function bracketedAmount(a: ApiAmount): string;
+/**
+ * An amount beside its quote, with when it was true: "US$303,154 million in fiscal 2026", "R$14,153.8
+ * million in 2025 (about US$2.6B at the Federal Reserve's rate of 2025-12-31)". From an older Prism, as
+ * the lists show it, with the rate after the period.
+ */
+export declare function amountBesideQuote(a: ApiAmount, period: string | null | undefined): string;
+/** An amount's size, to sort by: its dollars when converted, else its number as read (as written, for an older Prism); null when it is no amount. */
+export declare function amountSize(a: ApiAmount): number | null;
+/** ", at the Federal Reserve's rate of 2025-12-31" to end a figure with, or "". */
+export declare const rateClause: (fxs: ReadonlyArray<Fx | null | undefined>) => string;
+/**
+ * When a figure was true, as its sheet writes it, in words that follow the figure (Ben, 2026-10-21:
+ * "show the year next to each figure"): "2025" reads "in 2025", "Fiscal 2026" "in fiscal 2026", "year
+ * ended March 31, 2026" "in the year ended March 31, 2026", a day "as of December 31, 2025". A period
+ * with its own preposition keeps it (2026-10-24: the light pass's "During 2023, 2024 and 2025" read
+ * "in During 2023, 2024 and 2025"), and "fiscal Year 2025" reads "fiscal year 2025". Empty when the
+ * sheet gives no period.
+ */
+export declare function periodPhrase(period: string | null | undefined, preposition?: "in" | "for"): string;
+/** A run's filters in words: "market cap US$2.0B to US$10B, from "mid-cap" in the theme · no ETFs". */
+export declare function filtersText(f: Answer["filters"]): string;
+/** A most-money figure as an amount from the API: its text, dollars, rate, currency and display. */
+export declare const figureAmount: (f: NonNullable<Row["revenue_from_theme"]>) => ApiAmount;
+/**
+ * A most-money figure as a list shows it, with when it was true (Ben, 2026-10-21) and its currency
+ * (2026-10-23): "US$18.9B in fiscal 2025", or Prism's estimate. In another currency, its dollars
+ * first: "US$1.2B (R$6.5B) in 2025, at the Federal Reserve's rate of 2025-12-31".
+ */
+export declare function listFigure(row: Row): string;
+/** US dollars rounded, for Prism's own reports and logs: "$49B", "$4.0B", "$500M". */
+export declare const money: (usd: number) => string;
+/** US dollars rounded as readers see a market cap, an estimate or a filter, with the currency (Ben, 2026-10-23): "US$49B", "US$4.0B", "US$500M". */
+export declare const usdMoney: (usd: number) => string;
+export declare const duration: (s: number) => string;
+/** One line on a running run: its step, how far the step is, the time so far and the cost so far. */
+export declare function progressLine(progress: {
+    step?: string;
+    done?: number;
+    of?: number;
+} | undefined, seconds: number, usd: number): string;
+/** SEC names come in capitals ("CAMECO CORP"); print them in normal case, keeping short codes. */
+export declare function displayName(name: string): string;
+//# sourceMappingURL=answer.d.ts.map