@rubicon-caliga/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { RubiconClient } from "@rubicon-caliga/agent-sdk";
+import { parseUsdcToAtomic } from "@rubicon-caliga/core";
+import { parseArgs, booleanFlag, stringFlag } from "./args.js";
+import { configPath, HOSTED_GATEWAY_URL, readConfig, writeConfig } from "./config.js";
+import { CliError, toCliError } from "./errors.js";
+import { articleJson, formatAtomic, humanArticle, humanNavigation, humanReceipt, printJson, printJsonEvent, } from "./format.js";
+import { selectPaymentEngine } from "./payments.js";
+import { listReceipts, loadReceipt, saveReceipt } from "./receipts.js";
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    const json = booleanFlag(parsed.flags, "json");
+    try {
+        const config = await readConfig();
+        const gatewayUrl = stringFlag(parsed.flags, "gateway-url") ??
+            process.env.RUBICON_GATEWAY_URL ??
+            config.gatewayUrl ??
+            HOSTED_GATEWAY_URL;
+        const apiKey = stringFlag(parsed.flags, "api-key") ?? process.env.RUBICON_AGENT_API_KEY ?? config.apiKey;
+        const payment = selectPaymentEngine({
+            requestedMode: stringFlag(parsed.flags, "payment-mode"),
+            gatewayUrl,
+            config,
+        });
+        const client = new RubiconClient({
+            baseUrl: gatewayUrl,
+            authorization: apiKey ? `Bearer ${apiKey}` : undefined,
+            paymentEngine: payment.engine,
+        });
+        await dispatch({ parsed, json, config, gatewayUrl, apiKey, paymentMode: payment.mode, client });
+    }
+    catch (error) {
+        const cliError = toCliError(error);
+        if (json) {
+            printJson({ success: false, error: { code: cliError.code, message: cliError.message } });
+        }
+        else {
+            process.stderr.write(`Error: ${cliError.message}\n`);
+        }
+        process.exitCode = cliError.exitCode;
+    }
+}
+async function dispatch(runtime) {
+    const [command, subcommand, ...rest] = runtime.parsed.positionals;
+    if (!command || command === "help" || booleanFlag(runtime.parsed.flags, "help")) {
+        showHelp(runtime.json);
+        return;
+    }
+    if (command === "repository") {
+        await repository(runtime);
+        return;
+    }
+    if (command === "search") {
+        await search(runtime, subcommand);
+        return;
+    }
+    if (command === "article" && subcommand === "show") {
+        await articleShow(runtime, rest[0]);
+        return;
+    }
+    if (command === "article" && subcommand === "navigation") {
+        await articleNavigation(runtime, rest[0]);
+        return;
+    }
+    if (command === "read") {
+        await readArticle(runtime, subcommand);
+        return;
+    }
+    if (command === "receipts" && subcommand === "list") {
+        await receiptsList(runtime);
+        return;
+    }
+    if (command === "receipts" && subcommand === "show") {
+        await receiptsShow(runtime, rest[0]);
+        return;
+    }
+    if (command === "config" && subcommand === "show") {
+        await configShow(runtime);
+        return;
+    }
+    if (command === "config" && subcommand === "set") {
+        await configSet(runtime, rest[0], rest[1]);
+        return;
+    }
+    throw new CliError("UNKNOWN_COMMAND", `Unknown command: ${runtime.parsed.positionals.join(" ")}`);
+}
+async function repository(runtime) {
+    const response = await runtime.client.getRepository();
+    if (runtime.json) {
+        printJson({ success: true, repository: response.repository, articles: response.articles.map(articleJson) });
+        return;
+    }
+    if (response.articles.length === 0) {
+        process.stdout.write("No public articles found.\n");
+        return;
+    }
+    process.stdout.write(response.articles
+        .map((article) => `${article.articleId} | ${article.title} | ${article.author} | ${article.totalWords} words`)
+        .join("\n") + "\n");
+}
+async function search(runtime, query) {
+    if (!query)
+        throw new CliError("MISSING_QUERY", "rubicon search requires a query.");
+    const response = await runtime.client.getRepository();
+    const matches = response.articles.filter((article) => matchesQuery(article, query));
+    if (runtime.json) {
+        printJson({ success: true, query, articles: matches.map(articleJson) });
+        return;
+    }
+    if (matches.length === 0) {
+        process.stdout.write("No matches.\n");
+        return;
+    }
+    process.stdout.write(matches.map((article) => `${article.articleId} | ${article.title} | ${article.author}`).join("\n") + "\n");
+}
+async function articleShow(runtime, articleId) {
+    const article = await findArticle(runtime, articleId);
+    if (runtime.json) {
+        printJson({ success: true, article: articleJson(article) });
+        return;
+    }
+    process.stdout.write(`${humanArticle(article)}\n`);
+}
+async function articleNavigation(runtime, articleId) {
+    if (!articleId)
+        throw new CliError("MISSING_ARTICLE_ID", "rubicon article navigation requires an article id.");
+    const goal = stringFlag(runtime.parsed.flags, "goal");
+    if (!goal)
+        throw new CliError("MISSING_GOAL", "rubicon article navigation requires --goal.");
+    const response = await runtime.client.getNavigation(articleId, goal);
+    if (runtime.json) {
+        printJson({ success: true, article: articleJson(response.article), navigation: response.navigation });
+        return;
+    }
+    process.stdout.write(`${humanArticle(response.article)}\n\n${humanNavigation(response.navigation)}\n`);
+}
+async function readArticle(runtime, articleId) {
+    if (!articleId)
+        throw new CliError("MISSING_ARTICLE_ID", "rubicon read requires an article id.");
+    const maxSpendAtomic = parseBudget(runtime.parsed);
+    const goal = stringFlag(runtime.parsed.flags, "goal");
+    const maxWordsFlag = stringFlag(runtime.parsed.flags, "max-words");
+    const maxWords = maxWordsFlag === undefined ? undefined : Number(maxWordsFlag);
+    if (maxWords !== undefined && (!Number.isInteger(maxWords) || maxWords < 1)) {
+        throw new CliError("INVALID_MAX_WORDS", "--max-words must be a positive integer.");
+    }
+    if (booleanFlag(runtime.parsed.flags, "dry-run")) {
+        await dryRun(runtime, articleId, maxSpendAtomic, goal, maxWords);
+        return;
+    }
+    let finalReceipt = undefined;
+    const stream = runtime.client.read({
+        articleId,
+        goal,
+        maxSpendAtomic,
+        maxWords,
+    });
+    for await (const event of stream) {
+        if (runtime.json) {
+            printJsonEvent("event", { event });
+            if (event.type === "article.completed") {
+                finalReceipt = event.receipt;
+            }
+            continue;
+        }
+        switch (event.type) {
+            case "seller.message":
+                process.stdout.write(`Seller: ${event.content}\n\n`);
+                break;
+            case "session.started":
+                process.stdout.write(`Session: ${event.session.sessionId}\n\n`);
+                break;
+            case "article.word":
+                process.stdout.write(`${event.word} `);
+                break;
+            case "article.error":
+                process.stderr.write(`\nError: ${event.message}\n`);
+                break;
+            case "article.completed":
+                finalReceipt = event.receipt;
+                process.stdout.write(`\n\n${humanReceipt(event.receipt)}\n`);
+                break;
+            case "article.usage":
+                break;
+        }
+    }
+    if (finalReceipt) {
+        const stored = await saveReceipt(finalReceipt);
+        if (runtime.json) {
+            printJson({ type: "receipt.saved", success: true, receiptId: stored.receiptId, savedAt: stored.savedAt, receipt: stored.receipt });
+        }
+    }
+}
+async function dryRun(runtime, articleId, maxSpendAtomic, goal, maxWords) {
+    const article = await findArticle(runtime, articleId);
+    if (runtime.json) {
+        printJson({
+            success: true,
+            dryRun: true,
+            gatewayUrl: runtime.gatewayUrl,
+            paymentMode: runtime.paymentMode,
+            budget: {
+                maxSpendAtomic,
+                maxSpendUsdc: formatAtomic(maxSpendAtomic),
+                maxWords,
+            },
+            goal,
+            article: articleJson(article),
+        });
+        return;
+    }
+    process.stdout.write([
+        "Dry run: no paid read started.",
+        `Gateway: ${runtime.gatewayUrl}`,
+        `Payment mode: ${runtime.paymentMode}`,
+        `Budget: ${formatAtomic(maxSpendAtomic)} USDC (${maxSpendAtomic} atomic)`,
+        maxWords ? `Max words: ${maxWords}` : undefined,
+        goal ? `Goal: ${goal}` : undefined,
+        "",
+        humanArticle(article),
+        "",
+    ]
+        .filter((line) => line !== undefined)
+        .join("\n"));
+}
+async function receiptsList(runtime) {
+    const receipts = await listReceipts();
+    if (runtime.json) {
+        printJson({ success: true, receipts });
+        return;
+    }
+    if (receipts.length === 0) {
+        process.stdout.write("No local receipts found.\n");
+        return;
+    }
+    process.stdout.write(receipts
+        .map((stored) => `${stored.receiptId} | ${stored.savedAt} | ${stored.receipt.articleId} | ${formatAtomic(stored.receipt.amountPaidAtomic)} USDC`)
+        .join("\n") + "\n");
+}
+async function receiptsShow(runtime, receiptId) {
+    if (!receiptId)
+        throw new CliError("MISSING_RECEIPT_ID", "rubicon receipts show requires a receipt id.");
+    const stored = await loadReceipt(receiptId);
+    if (runtime.json) {
+        printJson({ success: true, ...stored });
+        return;
+    }
+    process.stdout.write(`Receipt ID: ${stored.receiptId}\nSaved: ${stored.savedAt}\n${humanReceipt(stored.receipt)}\n`);
+}
+async function configShow(runtime) {
+    const shown = {
+        configPath: configPath(),
+        gatewayUrl: runtime.config.gatewayUrl,
+        apiKey: runtime.config.apiKey ? "set" : undefined,
+        paymentMode: runtime.config.paymentMode,
+        circleChain: runtime.config.circleChain,
+        agentWalletAddress: runtime.config.agentWalletAddress,
+        effective: {
+            gatewayUrl: runtime.gatewayUrl,
+            apiKey: runtime.apiKey ? "set" : undefined,
+            paymentMode: runtime.paymentMode,
+        },
+    };
+    if (runtime.json) {
+        printJson({ success: true, config: shown });
+        return;
+    }
+    process.stdout.write(`${JSON.stringify(shown, null, 2)}\n`);
+}
+async function configSet(runtime, key, value) {
+    if (!key || !value)
+        throw new CliError("MISSING_CONFIG_VALUE", "rubicon config set requires a key and value.");
+    const next = { ...runtime.config };
+    switch (key) {
+        case "gateway-url":
+            next.gatewayUrl = value;
+            break;
+        case "api-key":
+            next.apiKey = value;
+            break;
+        case "payment-mode":
+            if (value !== "static" && value !== "circle-cli") {
+                throw new CliError("INVALID_PAYMENT_MODE", "payment-mode must be static or circle-cli.");
+            }
+            next.paymentMode = value;
+            break;
+        case "circle-chain":
+            next.circleChain = value;
+            break;
+        case "agent-wallet-address":
+            if (!value.startsWith("0x"))
+                throw new CliError("INVALID_ADDRESS", "agent-wallet-address must start with 0x.");
+            next.agentWalletAddress = value;
+            break;
+        default:
+            throw new CliError("UNKNOWN_CONFIG_KEY", `Unknown config key: ${key}`);
+    }
+    await mkdir(dirname(configPath()), { recursive: true, mode: 0o700 });
+    await writeConfig(next);
+    if (runtime.json) {
+        printJson({ success: true, configPath: configPath(), key });
+        return;
+    }
+    process.stdout.write(`Updated ${key} in ${configPath()}\n`);
+}
+async function findArticle(runtime, articleId) {
+    if (!articleId)
+        throw new CliError("MISSING_ARTICLE_ID", "Article id is required.");
+    const repository = await runtime.client.getRepository();
+    const article = repository.articles.find((candidate) => candidate.articleId === articleId);
+    if (!article)
+        throw new CliError("ARTICLE_NOT_FOUND", `Article not found: ${articleId}`);
+    return article;
+}
+function parseBudget(parsed) {
+    const maxUsdc = stringFlag(parsed.flags, "max-usdc");
+    const maxAtomic = stringFlag(parsed.flags, "max-atomic");
+    if (!maxUsdc && !maxAtomic) {
+        throw new CliError("MISSING_BUDGET", "rubicon read requires --max-usdc or --max-atomic.");
+    }
+    if (maxUsdc && maxAtomic) {
+        throw new CliError("MULTIPLE_BUDGETS", "Use either --max-usdc or --max-atomic, not both.");
+    }
+    if (maxAtomic) {
+        if (!/^\d+$/.test(maxAtomic))
+            throw new CliError("INVALID_BUDGET", "--max-atomic must be an integer.");
+        return maxAtomic;
+    }
+    try {
+        return `${parseUsdcToAtomic(maxUsdc)}`;
+    }
+    catch {
+        throw new CliError("INVALID_BUDGET", "--max-usdc must be a decimal USDC amount.");
+    }
+}
+function matchesQuery(article, query) {
+    const haystack = [
+        article.articleId,
+        article.title,
+        article.author,
+        article.creatorUsername,
+        ...article.sections.map((section) => section.heading),
+        ...article.sections.map((section) => section.sectionId),
+    ]
+        .join(" ")
+        .toLowerCase();
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean)
+        .every((term) => haystack.includes(term));
+}
+function showHelp(json) {
+    const usage = [
+        "rubicon repository",
+        "rubicon search \"<query>\"",
+        "rubicon article show <article-id>",
+        "rubicon article navigation <article-id> --goal \"<goal>\"",
+        "rubicon read <article-id> --max-usdc 0.10 [--goal \"...\"] [--max-words 50] [--dry-run]",
+        "rubicon receipts list",
+        "rubicon receipts show <receipt-id>",
+        "rubicon config show",
+        "rubicon config set gateway-url <url>",
+        "rubicon config set api-key <key>",
+    ];
+    if (json) {
+        printJson({ success: true, usage });
+        return;
+    }
+    process.stdout.write(`${usage.join("\n")}\n`);
+}
+await main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/payments.d.ts

@@ -0,0 +1,13 @@
+import { type AgentPaymentEngine } from "@rubicon-caliga/agent-sdk";
+import { type RubiconCliConfig } from "./config.js";
+export type PaymentMode = "static" | "circle-cli";
+export interface PaymentSelection {
+    mode: PaymentMode;
+    engine: AgentPaymentEngine;
+}
+export declare function selectPaymentEngine(input: {
+    requestedMode?: string;
+    gatewayUrl: string;
+    config: RubiconCliConfig;
+}): PaymentSelection;
+//# sourceMappingURL=payments.d.ts.map

package/dist/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGxE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,gBAAgB,CAenB"}

package/dist/payments.js

@@ -0,0 +1,52 @@
+import { CircleCliGatewayPaymentEngine, StaticPaymentEngine, } from "@rubicon-caliga/agent-sdk";
+import { HOSTED_GATEWAY_URL } from "./config.js";
+import { CliError } from "./errors.js";
+export function selectPaymentEngine(input) {
+    const mode = normalizeMode(input.requestedMode ?? process.env.RUBICON_PAYMENT_MODE ?? input.config.paymentMode);
+    const selectedMode = mode ?? defaultPaymentMode(input.gatewayUrl);
+    if (selectedMode === "static") {
+        return { mode: selectedMode, engine: new StaticPaymentEngine() };
+    }
+    return {
+        mode: selectedMode,
+        engine: new CircleCliGatewayPaymentEngine({
+            agentWalletAddress: envAddress("CIRCLE_AGENT_WALLET_ADDRESS") ?? input.config.agentWalletAddress,
+            chain: process.env.CIRCLE_CLI_CHAIN ?? input.config.circleChain ?? "ARC-TESTNET",
+        }),
+    };
+}
+function normalizeMode(value) {
+    if (!value) {
+        if (process.env.CIRCLE_CLI_PAYMENT === "1")
+            return "circle-cli";
+        if (process.env.CIRCLE_AGENT_WALLET_ADDRESS)
+            return "circle-cli";
+        return undefined;
+    }
+    if (value === "static" || value === "circle-cli")
+        return value;
+    throw new CliError("INVALID_PAYMENT_MODE", "Payment mode must be static or circle-cli.");
+}
+function defaultPaymentMode(gatewayUrl) {
+    if (isLocalGateway(gatewayUrl))
+        return "static";
+    if (process.env.CIRCLE_CLI_PAYMENT === "1" || process.env.CIRCLE_AGENT_WALLET_ADDRESS)
+        return "circle-cli";
+    if (gatewayUrl === HOSTED_GATEWAY_URL)
+        return "circle-cli";
+    return "circle-cli";
+}
+function isLocalGateway(gatewayUrl) {
+    try {
+        const url = new URL(gatewayUrl);
+        return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1";
+    }
+    catch {
+        return false;
+    }
+}
+function envAddress(name) {
+    const value = process.env[name];
+    return value?.startsWith("0x") ? value : undefined;
+}
+//# sourceMappingURL=payments.js.map

package/dist/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAyB,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASvC,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChH,MAAM,YAAY,GAAG,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAElE,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,mBAAmB,EAAE,EAAE,CAAC;IACnE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,IAAI,6BAA6B,CAAC;YACxC,kBAAkB,EAAE,UAAU,CAAC,6BAA6B,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,kBAAkB;YAChG,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,aAAa;SACjF,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG;YAAE,OAAO,YAAY,CAAC;QAChE,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B;YAAE,OAAO,YAAY,CAAC;QACjE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,4CAA4C,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,IAAI,cAAc,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B;QAAE,OAAO,YAAY,CAAC;IAC3G,IAAI,UAAU,KAAK,kBAAkB;QAAE,OAAO,YAAY,CAAC;IAC3D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,KAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC"}

package/dist/receipts.d.ts

@@ -0,0 +1,12 @@
+import type { ReadReceipt } from "@rubicon-caliga/agent-sdk";
+export interface StoredReceipt {
+    receiptId: string;
+    savedAt: string;
+    receipt: ReadReceipt;
+}
+export declare function receiptsDir(): string;
+export declare function receiptId(receipt: ReadReceipt): string;
+export declare function saveReceipt(receipt: ReadReceipt): Promise<StoredReceipt>;
+export declare function listReceipts(): Promise<StoredReceipt[]>;
+export declare function loadReceipt(id: string): Promise<StoredReceipt>;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEtD;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAW9E;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAS7D;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAUpE"}

package/dist/receipts.js

@@ -0,0 +1,43 @@
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CliError } from "./errors.js";
+export function receiptsDir() {
+    return join(homedir(), ".rubicon", "receipts");
+}
+export function receiptId(receipt) {
+    return `${receipt.sessionId}-${receipt.articleId}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+export async function saveReceipt(receipt) {
+    const stored = {
+        receiptId: receiptId(receipt),
+        savedAt: new Date().toISOString(),
+        receipt,
+    };
+    await mkdir(receiptsDir(), { recursive: true, mode: 0o700 });
+    await writeFile(join(receiptsDir(), `${stored.receiptId}.json`), `${JSON.stringify(stored, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    return stored;
+}
+export async function listReceipts() {
+    await mkdir(receiptsDir(), { recursive: true, mode: 0o700 });
+    const names = await readdir(receiptsDir());
+    const receipts = await Promise.all(names
+        .filter((name) => name.endsWith(".json"))
+        .map(async (name) => JSON.parse(await readFile(join(receiptsDir(), name), "utf8"))));
+    return receipts.sort((left, right) => right.savedAt.localeCompare(left.savedAt));
+}
+export async function loadReceipt(id) {
+    const safeId = id.replace(/[^a-zA-Z0-9._-]/g, "_");
+    try {
+        return JSON.parse(await readFile(join(receiptsDir(), `${safeId}.json`), "utf8"));
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+            throw new CliError("RECEIPT_NOT_FOUND", `Receipt not found: ${id}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=receipts.js.map

package/dist/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAoB;IAC5C,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB;IACpD,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,OAAO;KACR,CAAC;IACF,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,SAAS,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACvG,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,KAAK;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SACxC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC,CACvG,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC;IACpG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9F,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@rubicon-caliga/cli",
+  "version": "0.1.0",
+  "description": "Terminal-native Rubicon CLI for buyer agents consuming pay-per-word articles.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "rubicon": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/michaelzoub/rubicon.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@rubicon-caliga/agent-sdk": "0.1.2",
+    "@rubicon-caliga/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/args.ts

@@ -0,0 +1,52 @@
+import { CliError } from "./errors.js";
+
+export interface ParsedArgs {
+  positionals: string[];
+  flags: Record<string, string | boolean>;
+}
+
+export function parseArgs(argv: string[]): ParsedArgs {
+  const positionals: string[] = [];
+  const flags: Record<string, string | boolean> = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index]!;
+    if (token === "--") continue;
+    if (!token.startsWith("--")) {
+      positionals.push(token);
+      continue;
+    }
+
+    const withoutPrefix = token.slice(2);
+    const [rawName, inlineValue] = withoutPrefix.split("=", 2);
+    const name = rawName;
+    if (!name) {
+      throw new CliError("INVALID_ARGUMENT", `Invalid flag: ${token}`);
+    }
+
+    if (inlineValue !== undefined) {
+      flags[name] = inlineValue;
+      continue;
+    }
+
+    const next = argv[index + 1];
+    if (next !== undefined && !next.startsWith("--")) {
+      flags[name] = next;
+      index += 1;
+    } else {
+      flags[name] = true;
+    }
+  }
+
+  return { positionals, flags };
+}
+
+export function stringFlag(flags: Record<string, string | boolean>, name: string): string | undefined {
+  const value = flags[name];
+  if (value === undefined || typeof value === "boolean") return undefined;
+  return value;
+}
+
+export function booleanFlag(flags: Record<string, string | boolean>, name: string): boolean {
+  return flags[name] === true;
+}