@methatech-cli/cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,71 @@
-# Temporary Holding Version
+# MethaTech CLI
 
-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.
+Chat with MethaTech models from your terminal. Black + lime, Node.js + npm only.
+
+## Install (local, not published yet)
+
+```sh
+npm install
+npm run build
+node dist/cli.js --help
+# or: npm link   (then `metatech` works globally)
+```
+
+Requires Node.js 20+.
+
+## Login
+
+```sh
+metatech login
+```
+
+1. The CLI prints the login URL (`https://console.methatech.eu.org/login`)
+   and tries to open it in your browser. Sign in and pick your account.
+2. Open the token page (`https://console.methatech.eu.org/panel/token`),
+   copy an API key, and paste it into the CLI (input is masked).
+3. The key is saved to `~/.config/metatech/credentials.json` (0600, dir 0700).
+
+The panel does not have a device-code/polling endpoint yet, so this phase
+uses manual key paste. A full browser login + polling flow is a separate
+panel follow-up. You can also use the env var instead:
+
+```sh
+export METATECH_API_KEY="sk-..."
+```
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `metatech` (no args) | Chat TUI with the default model |
+| `metatech chat [--model <id>]` | Chat TUI |
+| `metatech models` | Model list: FREE $0.00 section + paid prices in $/1M |
+| `metatech account` | Spending limit, used, balance (all $) |
+| `metatech keys` | How to manage API keys in the panel |
+| `metatech topup` | Open the top-up page |
+| `metatech logout` | Delete the saved key |
+
+Chat keys: `Enter` send · `↑↓` change model · `/models` list · `/model <id>`
+switch · `/clear` clear · `/help` help · `/exit` quit · `Ctrl+C` quit.
+
+## Prices
+
+All prices are in dollars. The model list is fetched live from the panel
+(`/api/available_model`, $ = ratio × 2). If the server cannot be reached,
+a compiled-in price table (2026-11-08) is used. The 10 FREE models are
+always listed first at $0.00 — they run on your free credits.
+
+## Config
+
+- `~/.config/metatech/credentials.json` — API key + last used model
+  (override dir with `METATECH_CONFIG_DIR`)
+- `METATECH_API_KEY` — env var takes precedence over the file
+- `METATECH_API_BASE` (default `https://api.methatech.eu.org`) and
+  `METATECH_CONSOLE_BASE` (default `https://console.methatech.eu.org`)
+  — override for local testing
+
+## Not built yet (later phases)
+
+- Agent coding mode (file tools, run commands, confirm before dangerous ones)
+- Full browser login + polling (needs a panel device-code endpoint)
+- npm publish (`@methatech-cli/cli`) — only when Reza says go

package/dist/api.js

@@ -0,0 +1,146 @@
+import { apiBase } from "./config.js";
+export class ApiError extends Error {
+    status;
+    code;
+    constructor(status, message, code = "") {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+function friendlyError(status, bodyText) {
+    let message = bodyText.slice(0, 300);
+    let code = "";
+    try {
+        const j = JSON.parse(bodyText);
+        if (j.error?.message)
+            message = j.error.message;
+        else if (typeof j.message === "string")
+            message = j.message;
+        if (j.error?.code)
+            code = j.error.code;
+    }
+    catch {
+        // keep raw text
+    }
+    if (status === 401)
+        return new ApiError(401, "API key tidak valid. Jalankan: metatech login", code);
+    if (status === 402) {
+        return new ApiError(402, "Saldo dan free credits habis. Top up dulu: metatech topup", code);
+    }
+    if (status === 429)
+        return new ApiError(429, `Terlalu banyak request / model sibuk (${message})`, code);
+    return new ApiError(status, `API error ${status}: ${message}`, code);
+}
+export async function listModels(apiKey) {
+    const res = await fetch(`${apiBase()}/v1/models`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw friendlyError(res.status, await res.text());
+    const json = (await res.json());
+    return (json.data ?? []).map((m) => ({ id: m.id ?? "", ownedBy: m.owned_by ?? "" }));
+}
+export async function getSubscription(apiKey) {
+    const res = await fetch(`${apiBase()}/v1/dashboard/billing/subscription`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw friendlyError(res.status, await res.text());
+    const j = (await res.json());
+    return {
+        hasPaymentMethod: j.has_payment_method ?? false,
+        softLimitUsd: j.soft_limit_usd ?? 0,
+        hardLimitUsd: j.hard_limit_usd ?? 0,
+        systemHardLimitUsd: j.system_hard_limit_usd ?? 0,
+        accessUntil: j.access_until ?? 0,
+    };
+}
+/**
+ * Total usage as reported by the billing endpoint. The panel reports this
+ * in cents (used_quota / 5000): divide by 100 to get dollars.
+ * Verified against the live panel: used_quota 191,137 -> total_usage 38.2274.
+ */
+export async function getTotalUsageCents(apiKey) {
+    const res = await fetch(`${apiBase()}/v1/dashboard/billing/usage`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw friendlyError(res.status, await res.text());
+    const j = (await res.json());
+    return typeof j.total_usage === "number" ? j.total_usage : 0;
+}
+/**
+ * Stream one chat completion. The panel reports usage in the final SSE
+ * chunk when stream_options.include_usage is set (verified live 2026-11-08).
+ */
+export async function streamChat(apiKey, model, messages, handlers, maxTokens = 1024) {
+    const res = await fetch(`${apiBase()}/v1/chat/completions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            max_tokens: maxTokens,
+            stream: true,
+            stream_options: { include_usage: true },
+        }),
+        signal: AbortSignal.timeout(120000),
+    });
+    if (!res.ok)
+        throw friendlyError(res.status, await res.text());
+    if (!res.body)
+        throw new ApiError(0, "Tidak ada body stream dari server");
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let usage = null;
+    const handleLine = (line) => {
+        if (!line.startsWith("data:"))
+            return;
+        const payload = line.slice(5).trim();
+        if (payload === "[DONE]")
+            return;
+        try {
+            const chunk = JSON.parse(payload);
+            const delta = chunk.choices?.[0]?.delta?.content;
+            if (typeof delta === "string" && delta.length > 0)
+                handlers.onDelta(delta);
+            if (chunk.usage && typeof chunk.usage.prompt_tokens === "number") {
+                usage = {
+                    promptTokens: chunk.usage.prompt_tokens,
+                    completionTokens: chunk.usage.completion_tokens ?? 0,
+                    totalTokens: chunk.usage.total_tokens ?? 0,
+                };
+                handlers.onUsage(usage);
+            }
+        }
+        catch {
+            // A split JSON line is reassembled by the buffer below; ignore the rest.
+        }
+    };
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        let idx = buffer.indexOf("\n\n");
+        while (idx !== -1) {
+            const event = buffer.slice(0, idx);
+            buffer = buffer.slice(idx + 2);
+            for (const line of event.split("\n"))
+                handleLine(line.trim());
+            idx = buffer.indexOf("\n\n");
+        }
+    }
+    // Flush any trailing partial event.
+    for (const line of buffer.split("\n"))
+        handleLine(line.trim());
+    return { usage };
+}

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from "./commands.js";
+main();

package/dist/commands.js

@@ -0,0 +1,233 @@
+import { spawn } from "node:child_process";
+import { render } from "ink";
+import React from "react";
+import { Command } from "commander";
+import { readCredentials, writeCredentials, deleteCredentials, resolveApiKey, resolveDefaultModel, LOGIN_URL, TOKEN_PAGE_URL, TOPUP_URL, } from "./config.js";
+import { fetchCatalog, DEFAULT_MODEL, FALLBACK_MODEL } from "./models.js";
+import { getSubscription, getTotalUsageCents, listModels, ApiError } from "./api.js";
+import ChatApp from "./ui/ChatApp.js";
+import ModelsScreen from "./ui/ModelsScreen.js";
+import AccountScreen from "./ui/AccountScreen.js";
+function tryOpenUrl(url) {
+    const opener = process.platform === "darwin"
+        ? "open"
+        : process.env.TERMUX_VERSION || process.env.PREFIX?.includes("com.termux")
+            ? "termux-open-url"
+            : "xdg-open";
+    try {
+        const child = spawn(opener, [url], { stdio: "ignore", detached: true });
+        child.unref();
+    }
+    catch {
+        // Opening the browser is best-effort; the URL is always printed.
+    }
+}
+function askHidden(question) {
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        const stdin = process.stdin;
+        // Raw mode disables tty echo, so the pasted key never appears on screen.
+        stdin.setRawMode(true);
+        stdin.resume();
+        let value = "";
+        const onData = (chunk) => {
+            const s = chunk.toString("utf-8");
+            for (const ch of s) {
+                if (ch === "\r" || ch === "\n") {
+                    stdin.setRawMode(false);
+                    stdin.removeListener("data", onData);
+                    stdin.pause();
+                    process.stdout.write("\n");
+                    resolve(value.trim());
+                    return;
+                }
+                if (ch === "\u0003") {
+                    stdin.setRawMode(false);
+                    process.stdout.write("\n");
+                    process.exit(130);
+                }
+                if (ch === "\u007f") {
+                    value = value.slice(0, -1);
+                    process.stdout.write("\b \b");
+                }
+                else if (ch >= " ") {
+                    value += ch;
+                    process.stdout.write("*");
+                }
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+async function cmdLogin() {
+    console.log("MethaTech login");
+    console.log("");
+    console.log("1. Buka URL ini di browser dan pilih akun Google / GitHub:");
+    console.log(`   ${LOGIN_URL}`);
+    tryOpenUrl(LOGIN_URL);
+    console.log("");
+    console.log("2. Setelah login, buka halaman token dan salin API key kamu:");
+    console.log(`   ${TOKEN_PAGE_URL}`);
+    console.log("");
+    console.log("Catatan: panel belum punya endpoint device-code/polling, jadi");
+    console.log("untuk fase ini key ditempel manual. Alur login browser + polling");
+    console.log("penuh jadi follow-up panel terpisah.");
+    console.log("");
+    const existing = readCredentials();
+    if (existing)
+        console.log("Sudah ada key tersimpan — menempel key baru akan menggantinya.");
+    const key = await askHidden("Tempel API key: ");
+    if (!key) {
+        console.log("Key kosong, dibatalkan.");
+        return;
+    }
+    // Validate the key once before saving.
+    try {
+        await listModels(key);
+    }
+    catch (e) {
+        const message = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
+        console.log(`Key tidak bisa dipakai: ${message}`);
+        return;
+    }
+    writeCredentials({ apiKey: key, defaultModel: existing?.defaultModel ?? DEFAULT_MODEL, savedAt: new Date().toISOString() });
+    console.log("Login berhasil. Key tersimpan di ~/.config/metatech/credentials.json (0600).");
+}
+function requireKey() {
+    const key = resolveApiKey();
+    if (!key) {
+        console.log("Belum login. Jalankan: metatech login");
+        console.log("atau set env METATECH_API_KEY.");
+        process.exit(1);
+    }
+    return key;
+}
+async function balanceOf(apiKey) {
+    try {
+        const [sub, cents] = await Promise.all([getSubscription(apiKey), getTotalUsageCents(apiKey)]);
+        return Math.max(0, sub.hardLimitUsd - cents / 100);
+    }
+    catch {
+        return null;
+    }
+}
+async function cmdChat(modelOpt) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log("metatech chat butuh terminal interaktif.");
+        process.exit(1);
+    }
+    const apiKey = requireKey();
+    const savedModel = resolveDefaultModel();
+    const requested = modelOpt ?? savedModel ?? DEFAULT_MODEL;
+    const catalog = await fetchCatalog();
+    const known = catalog.entries.some((e) => e.id === requested);
+    // Retired/unknown ids are coerced to the fallback instead of erroring
+    // (Freebuff lesson, incident #1801).
+    const model = known ? requested : FALLBACK_MODEL;
+    if (!known)
+        console.log(`Model ${requested} tidak dikenal, memakai ${FALLBACK_MODEL}.`);
+    const balance = await balanceOf(apiKey);
+    const app = render(React.createElement(ChatApp, { apiKey, initialModel: model, catalog, balanceUsd: balance }));
+    await app.waitUntilExit();
+}
+async function cmdModels() {
+    const apiKey = resolveApiKey();
+    const catalog = await fetchCatalog();
+    let selected = null;
+    if (apiKey) {
+        try {
+            const models = await listModels(apiKey);
+            if (models.length > 0)
+                selected = resolveDefaultModel() ?? DEFAULT_MODEL;
+        }
+        catch {
+            // Key invalid: the list still renders from the public catalog.
+        }
+    }
+    else {
+        selected = resolveDefaultModel() ?? DEFAULT_MODEL;
+    }
+    void selected;
+    const app = render(React.createElement(ModelsScreen, { catalog, selectedModel: selected }));
+    await app.waitUntilExit();
+}
+async function cmdAccount() {
+    const apiKey = requireKey();
+    const keySource = process.env.METATECH_API_KEY ? "env" : "file";
+    let subscription = null;
+    let usedUsd = null;
+    try {
+        subscription = await getSubscription(apiKey);
+        const cents = await getTotalUsageCents(apiKey);
+        usedUsd = cents / 100;
+    }
+    catch (e) {
+        const message = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
+        console.log(`Tidak bisa membaca akun: ${message}`);
+        process.exit(1);
+    }
+    const app = render(React.createElement(AccountScreen, { subscription, usedUsd, keySource }));
+    await app.waitUntilExit();
+}
+function cmdKeys() {
+    const has = readCredentials() !== null || !!process.env.METATECH_API_KEY;
+    console.log("MethaTech API keys");
+    console.log("");
+    console.log(`Key tersimpan di CLI ini: ${has ? "ada" : "tidak ada"}`);
+    console.log("Kelola dan buat key baru di panel:");
+    console.log(`  ${TOKEN_PAGE_URL}`);
+    console.log("Lalu jalankan: metatech login");
+}
+function cmdTopup() {
+    console.log("Top up MethaTech lewat:");
+    console.log(`  ${TOPUP_URL}`);
+    tryOpenUrl(TOPUP_URL);
+}
+function cmdLogout() {
+    if (deleteCredentials())
+        console.log("Logout berhasil. Key tersimpan dihapus.");
+    else
+        console.log("Tidak ada key tersimpan.");
+}
+export function main() {
+    const program = new Command();
+    program
+        .name("metatech")
+        .description("MethaTech CLI — chat with MethaTech models from your terminal")
+        .version("0.1.0");
+    program
+        .command("login")
+        .description("Login lewat browser, lalu tempel API key dari panel")
+        .action(() => void cmdLogin());
+    program
+        .command("chat")
+        .description("Chat TUI dengan model MethaTech")
+        .option("--model <id>", "model yang dipakai")
+        .action((opts) => void cmdChat(opts.model));
+    program
+        .command("models")
+        .description("Daftar model + harga")
+        .action(() => void cmdModels());
+    program
+        .command("account")
+        .description("Lihat akun dan saldo")
+        .action(() => void cmdAccount());
+    program
+        .command("keys")
+        .description("Lihat cara mengelola API key")
+        .action(() => cmdKeys());
+    program
+        .command("topup")
+        .description("Buka halaman top up")
+        .action(() => cmdTopup());
+    program
+        .command("logout")
+        .description("Hapus key tersimpan")
+        .action(() => cmdLogout());
+    // No command = chat with the default model (Freebuff behaviour).
+    if (process.argv.length <= 2) {
+        void cmdChat();
+        return;
+    }
+    program.parse(process.argv);
+}

package/dist/config.js

@@ -0,0 +1,79 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+// Config dir: ~/.config/metatech (override with METATECH_CONFIG_DIR).
+// Follows the Freebuff pattern: credentials.json, dir 0700, file 0600.
+export function configDir() {
+    const override = process.env.METATECH_CONFIG_DIR;
+    if (override)
+        return override;
+    return path.join(os.homedir(), ".config", "metatech");
+}
+export function credentialsPath() {
+    return path.join(configDir(), "credentials.json");
+}
+export function readCredentials() {
+    try {
+        const raw = fs.readFileSync(credentialsPath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.apiKey === "string" && parsed.apiKey.length > 0) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCredentials(creds) {
+    const dir = configDir();
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    try {
+        fs.chmodSync(dir, 0o700);
+    }
+    catch {
+        // best effort; some filesystems ignore chmod
+    }
+    const file = credentialsPath();
+    fs.writeFileSync(file, JSON.stringify(creds, null, 2) + "\n", { mode: 0o600 });
+    try {
+        fs.chmodSync(file, 0o600);
+    }
+    catch {
+        // best effort
+    }
+}
+export function deleteCredentials() {
+    try {
+        fs.unlinkSync(credentialsPath());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolution order: env var first, then the saved credentials file. */
+export function resolveApiKey() {
+    const env = process.env.METATECH_API_KEY;
+    if (env && env.trim().length > 0)
+        return env.trim();
+    return readCredentials()?.apiKey ?? null;
+}
+export function resolveDefaultModel() {
+    return readCredentials()?.defaultModel ?? null;
+}
+export function saveDefaultModel(model) {
+    const creds = readCredentials();
+    if (!creds)
+        return;
+    writeCredentials({ ...creds, defaultModel: model });
+}
+export function apiBase() {
+    return (process.env.METATECH_API_BASE ?? "https://api.methatech.eu.org").replace(/\/$/, "");
+}
+export function consoleBase() {
+    return (process.env.METATECH_CONSOLE_BASE ?? "https://console.methatech.eu.org").replace(/\/$/, "");
+}
+export const LOGIN_URL = "https://console.methatech.eu.org/login";
+export const TOKEN_PAGE_URL = "https://console.methatech.eu.org/panel/token";
+export const TOPUP_URL = "https://pay.methatech.eu.org";

package/dist/cost.js

@@ -0,0 +1,14 @@
+/** Dollar cost of one answer at the model's per-1M-token rates. */
+export function costOf(usage, price) {
+    if (!price)
+        return null;
+    return (usage.promptTokens / 1_000_000) * price.input + (usage.completionTokens / 1_000_000) * price.output;
+}
+export function formatUsd(value) {
+    return `$${value.toFixed(4)}`;
+}
+export function formatUsageLine(usage, price) {
+    const cost = costOf(usage, price);
+    const costText = cost === null ? "cost —" : formatUsd(cost);
+    return `${usage.promptTokens} in / ${usage.completionTokens} out · ${costText}`;
+}

package/dist/models.js

@@ -0,0 +1,103 @@
+import { consoleBase } from "./config.js";
+// The 10 FREE models. Same set as the panel's free allowlist.
+export const FREE_MODEL_IDS = [
+    "deepseek-v4-flash",
+    "glm-5.3-flash",
+    "gpt-6-luna",
+    "gemini-3.8-flash",
+    "gpt-6-astra",
+    "gemini-3.1-pro",
+    "qwen3.8-flash",
+    "qwen3.7-max",
+    "kimi-k2.7-code",
+    "deepseek-v4.1-flash",
+];
+export const DEFAULT_MODEL = "glm-5.3-flash";
+export const FALLBACK_MODEL = "deepseek-v4-flash";
+// Compiled-in fallback, taken from the live /api/available_model on
+// 2026-11-08. Live price = ratio * 2 ($1 = 500,000 quota). The CLI prefers
+// the live fetch; this table is only used when the server cannot be reached.
+export const COMPILED_PRICES = {
+    "claude-opus-4-6-thinking": { input: 8.35, output: 41.6 },
+    "claude-sonnet-4-6": { input: 5.0, output: 25.0 },
+    "command-a-03-2025": { input: 4.2, output: 16.65 },
+    "command-r-08-2024": { input: 0.25, output: 1.0 },
+    "command-r-plus-08-2024": { input: 4.2, output: 16.65 },
+    "command-r7b-12-2024": { input: 0.065, output: 0.25 },
+    "deepseek-v4-flash": { input: 0.5, output: 2.0 },
+    "deepseek-v4-pro": { input: 2.2, output: 6.6 },
+    "deepseek-v4.1-flash": { input: 0.5, output: 2.0 },
+    "gemini-3.1-pro": { input: 3.35, output: 20.0 },
+    "gemini-3.8-flash": { input: 2.5, output: 12.5 },
+    "gemini-4-argon": { input: 6.7, output: 33.3 },
+    "glm-5.2": { input: 2.35, output: 7.35 },
+    "glm-5.3": { input: 2.35, output: 7.35 },
+    "glm-5.3-flash": { input: 0.25, output: 0.85 },
+    "gpt-6-astra": { input: 17.0, output: 83.2 },
+    "gpt-6-luna": { input: 0.17, output: 0.85 },
+    "gpt-6.1-sol": { input: 3.35, output: 16.65 },
+    "gpt-6.1-terra": { input: 1.7, output: 8.35 },
+    "gpt-oss-120b-medium": { input: 0.25, output: 1.0 },
+    "grok-4.7": { input: 3.35, output: 10.0 },
+    "kimi-k3.1-pro": { input: 3.35, output: 16.65 },
+    "methatech/uncensored": { input: 0.2, output: 0.6 },
+    "qwen3.6-plus": { input: 0.85, output: 5.0 },
+    "qwen3.7-max": { input: 4.2, output: 12.5 },
+    "qwen3.7-plus": { input: 0.7, output: 2.7 },
+    "qwen3.8-flash": { input: 0.25, output: 0.8 },
+};
+function buildCatalog(prices) {
+    const ids = new Set([...Object.keys(prices), ...FREE_MODEL_IDS]);
+    const entries = [...ids].map((id) => ({
+        id,
+        ownedBy: "",
+        price: prices[id] ?? null,
+        free: FREE_MODEL_IDS.includes(id),
+    }));
+    // FREE first, then cheapest input price first (Freebuff pattern).
+    entries.sort((a, b) => {
+        if (a.free !== b.free)
+            return a.free ? -1 : 1;
+        const pa = a.price?.input ?? Number.POSITIVE_INFINITY;
+        const pb = b.price?.input ?? Number.POSITIVE_INFINITY;
+        return pa - pb;
+    });
+    return { entries, live: false };
+}
+/** Fetch the live price table from the console. Falls back to the compiled table. */
+export async function fetchCatalog() {
+    try {
+        const res = await fetch(`${consoleBase()}/api/available_model`, {
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!res.ok)
+            return buildCatalog(COMPILED_PRICES);
+        const json = (await res.json());
+        const data = json.data ?? {};
+        const prices = {};
+        const ownedBy = {};
+        for (const [id, m] of Object.entries(data)) {
+            if (typeof m.price?.input === "number" && typeof m.price?.output === "number") {
+                prices[id] = { input: m.price.input * 2, output: m.price.output * 2 };
+            }
+            if (typeof m.owned_by === "string")
+                ownedBy[id] = m.owned_by;
+        }
+        if (Object.keys(prices).length === 0)
+            return buildCatalog(COMPILED_PRICES);
+        const catalog = buildCatalog(prices);
+        catalog.live = true;
+        for (const e of catalog.entries)
+            e.ownedBy = ownedBy[e.id] ?? "";
+        return catalog;
+    }
+    catch {
+        return buildCatalog(COMPILED_PRICES);
+    }
+}
+export function priceFor(catalog, modelId) {
+    return catalog.entries.find((e) => e.id === modelId)?.price ?? COMPILED_PRICES[modelId] ?? null;
+}
+export function isFreeModel(modelId) {
+    return FREE_MODEL_IDS.includes(modelId);
+}

package/dist/theme.js

@@ -0,0 +1,11 @@
+// MethaTech identity tokens. EXACT values, do not change.
+// Source of truth: panel theme (black glassmorphism + neon lime).
+export const theme = {
+    background: "#050807",
+    secondary: "#0A100D",
+    accent: "#A3FF45",
+    accentSecondary: "#78E62E",
+    text: "#F5F7F5",
+    muted: "#A1AAA4",
+    dim: "#69746D",
+};

package/dist/ui/AccountScreen.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput } from "ink";
+import { theme } from "../theme.js";
+import { formatUsd } from "../cost.js";
+import { TOPUP_URL, LOGIN_URL } from "../config.js";
+/**
+ * Account screen. Shows only what the Bearer API can prove:
+ * spending limit + used + derived balance. Email and free-credit balance
+ * are NOT available through any Bearer endpoint, so they are not invented
+ * here — the panel link is shown instead.
+ */
+export default function AccountScreen({ subscription, usedUsd, keySource }) {
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (input === "q" || key.escape || (key.ctrl && input === "c"))
+            exit();
+    });
+    const limit = subscription?.hardLimitUsd ?? null;
+    const balance = limit !== null && usedUsd !== null ? Math.max(0, limit - usedUsd) : null;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, bold: true, children: "MethaTech" }), _jsx(Text, { color: theme.muted, children: " \u00B7 account" })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "Signed in " }), _jsx(Text, { color: theme.text, bold: true, children: "yes" }), _jsxs(Text, { color: theme.dim, children: [" (key dari ", keySource === "env" ? "METATECH_API_KEY" : "file tersimpan", ")"] })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "Spending limit " }), _jsx(Text, { color: theme.text, bold: true, children: limit === null ? "—" : formatUsd(limit) })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "Used " }), _jsx(Text, { color: theme.text, bold: true, children: usedUsd === null ? "—" : formatUsd(usedUsd) })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "Balance " }), _jsx(Text, { color: theme.accent, bold: true, children: balance === null ? "—" : formatUsd(balance) })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "Top up " }), _jsx(Text, { color: theme.accent, children: TOPUP_URL })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.dim, children: "Email dan free credits tidak tersedia lewat API key." }), _jsxs(Text, { color: theme.dim, children: ["Lihat detail lengkap di panel: ", LOGIN_URL] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: "q keluar \u00B7 metatech topup untuk isi saldo \u00B7 metatech logout untuk keluar" }) })] }));
+}

package/dist/ui/ChatApp.js

@@ -0,0 +1,185 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useRef } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import { theme } from "../theme.js";
+import { streamChat, ApiError } from "../api.js";
+import { priceFor, isFreeModel, DEFAULT_MODEL, FALLBACK_MODEL } from "../models.js";
+import { formatUsageLine, formatUsd } from "../cost.js";
+import { saveDefaultModel } from "../config.js";
+const HELP_LINES = [
+    "/models — lihat daftar model",
+    "/model <id> — ganti model",
+    "/clear — bersihkan layar chat",
+    "/help — bantuan ini",
+    "/exit — keluar",
+    "↑↓ ganti model · Enter kirim · Ctrl+C keluar",
+];
+export default function ChatApp({ apiKey, initialModel, catalog, balanceUsd }) {
+    const { exit } = useApp();
+    const [model, setModel] = useState(initialModel);
+    const [messages, setMessages] = useState([]);
+    const [input, setInput] = useState("");
+    const [sending, setSending] = useState(false);
+    const [lastUsage, setLastUsage] = useState(null);
+    const [error, setError] = useState(null);
+    const sendingRef = useRef(false);
+    const modelRef = useRef(model);
+    modelRef.current = model;
+    const modelIds = catalog.entries.map((e) => e.id);
+    const price = priceFor(catalog, model);
+    const free = isFreeModel(model);
+    const cycleModel = (dir) => {
+        const idx = modelIds.indexOf(modelRef.current);
+        const next = modelIds[(idx + dir + modelIds.length) % modelIds.length] ?? DEFAULT_MODEL;
+        modelRef.current = next;
+        setModel(next);
+        saveDefaultModel(next);
+    };
+    const setModelById = (id) => {
+        if (!modelIds.includes(id)) {
+            // Retired/unknown ids are coerced to the fallback instead of erroring
+            // (Freebuff lesson, incident #1801).
+            setMessages((m) => [
+                ...m,
+                { role: "assistant", content: `Model ${id} tidak dikenal, dialihkan ke ${FALLBACK_MODEL}.`, kind: "system" },
+            ]);
+            modelRef.current = FALLBACK_MODEL;
+            setModel(FALLBACK_MODEL);
+            return false;
+        }
+        modelRef.current = id;
+        setModel(id);
+        saveDefaultModel(id);
+        return true;
+    };
+    const send = async (text) => {
+        if (sendingRef.current)
+            return;
+        sendingRef.current = true;
+        setSending(true);
+        setError(null);
+        const history = [...messages.filter((m) => m.kind === "chat"), { role: "user", content: text }];
+        setMessages((m) => [...m, { role: "user", content: text, kind: "chat" }]);
+        // Placeholder assistant message, filled by the stream.
+        setMessages((m) => [...m, { role: "assistant", content: "", kind: "chat" }]);
+        const currentModel = modelRef.current;
+        try {
+            const { usage } = await streamChat(apiKey, currentModel, history, {
+                onDelta: (delta) => {
+                    setMessages((m) => {
+                        const copy = [...m];
+                        const last = copy[copy.length - 1];
+                        if (last && last.role === "assistant") {
+                            copy[copy.length - 1] = { ...last, content: last.content + delta };
+                        }
+                        return copy;
+                    });
+                },
+                onUsage: (u) => setLastUsage({ usage: u, model: currentModel }),
+            });
+            if (!usage) {
+                setLastUsage((prev) => prev);
+            }
+        }
+        catch (e) {
+            const message = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
+            setError(message);
+            setMessages((m) => {
+                const copy = [...m];
+                const last = copy[copy.length - 1];
+                if (last && last.role === "assistant" && last.content === "")
+                    copy.pop();
+                return copy;
+            });
+        }
+        finally {
+            sendingRef.current = false;
+            setSending(false);
+        }
+    };
+    const handleSlash = (raw) => {
+        const [cmd, ...rest] = raw.slice(1).split(/\s+/);
+        const arg = rest.join(" ").trim();
+        switch (cmd) {
+            case "exit":
+            case "quit":
+                exit();
+                break;
+            case "clear":
+                setMessages([]);
+                setLastUsage(null);
+                break;
+            case "help":
+                setMessages((m) => [...m, { role: "assistant", content: HELP_LINES.join("\n"), kind: "system" }]);
+                break;
+            case "models": {
+                const freeList = catalog.entries.filter((e) => e.free).map((e) => e.id);
+                const paidList = catalog.entries
+                    .filter((e) => !e.free && e.price)
+                    .map((e) => `${e.id}  $${e.price.input.toFixed(2)}/$${e.price.output.toFixed(2)}`);
+                setMessages((m) => [
+                    ...m,
+                    {
+                        role: "assistant",
+                        content: "FREE $0.00\n" +
+                            freeList.join("\n") +
+                            "\n\nPAID ($ per 1M in/out)\n" +
+                            paidList.join("\n"),
+                        kind: "system",
+                    },
+                ]);
+                break;
+            }
+            case "model":
+                if (arg)
+                    setModelById(arg);
+                else
+                    setMessages((m) => [...m, { role: "assistant", content: `Model aktif: ${modelRef.current}`, kind: "system" }]);
+                break;
+            default:
+                setMessages((m) => [
+                    ...m,
+                    { role: "assistant", content: `Perintah tidak dikenal: /${cmd}. Ketik /help.`, kind: "system" },
+                ]);
+        }
+    };
+    useInput((inputKey, key) => {
+        if (key.ctrl && inputKey === "c") {
+            exit();
+            return;
+        }
+        if (sendingRef.current)
+            return;
+        if (key.return) {
+            const text = input.trim();
+            if (!text)
+                return;
+            setInput("");
+            if (text.startsWith("/"))
+                handleSlash(text);
+            else
+                void send(text);
+            return;
+        }
+        if (key.upArrow) {
+            cycleModel(-1);
+            return;
+        }
+        if (key.downArrow) {
+            cycleModel(1);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setInput((v) => v.slice(0, -1));
+            return;
+        }
+        if (key.escape) {
+            setInput("");
+            return;
+        }
+        if (inputKey && !key.ctrl && !key.meta) {
+            setInput((v) => v + inputKey);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, bold: true, children: "MethaTech" }), _jsx(Text, { color: theme.muted, children: " \u00B7 " }), _jsx(Text, { color: theme.text, bold: true, children: model }), _jsx(Text, { color: theme.muted, children: " \u00B7 " }), free ? (_jsx(Text, { color: theme.accent, bold: true, children: "FREE $0.00" })) : price ? (_jsxs(Text, { color: theme.accent, children: ["$", price.input.toFixed(2), " / $", price.output.toFixed(2), " per 1M"] })) : (_jsx(Text, { color: theme.muted, children: "harga \u2014" })), _jsx(Text, { color: theme.muted, children: " \u00B7 " }), _jsxs(Text, { color: balanceUsd === null ? theme.dim : theme.text, children: ["Balance ", balanceUsd === null ? "—" : formatUsd(balanceUsd)] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [messages.length === 0 && (_jsx(Text, { color: theme.dim, children: "Ketik pesan lalu Enter. /help untuk perintah. \u2191\u2193 ganti model." })), messages.map((m, i) => (_jsx(Box, { marginBottom: 1, flexDirection: "column", children: m.kind === "system" ? (_jsx(Text, { color: theme.dim, children: m.content })) : m.role === "user" ? (_jsxs(Text, { children: [_jsxs(Text, { color: "#7DD3FC", bold: true, children: ["You:", " "] }), _jsx(Text, { color: theme.text, children: m.content })] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.accent, bold: true, children: "Muse:" }), _jsx(Text, { color: theme.text, children: m.content || (sending && i === messages.length - 1 ? "…" : "") })] })) }, i)))] }), lastUsage && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: formatUsageLine(lastUsage.usage, priceFor(catalog, lastUsage.model)) }) })), error && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "#FF6B6B", children: error }) })), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: theme.accent, bold: true, children: ["\u276F", " "] }), _jsx(Text, { color: theme.text, children: input }), !sending && (_jsx(Text, { color: theme.accent, bold: true, children: "\u258B" })), sending && _jsx(Text, { color: theme.dim, children: " mengirim\u2026" })] }), _jsx(Box, { children: _jsx(Text, { color: theme.dim, children: "\u2191\u2193 ganti model \u00B7 /models daftar \u00B7 /help bantuan \u00B7 Ctrl+C keluar" }) })] }));
+}

package/dist/ui/ModelsScreen.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput } from "ink";
+import { theme } from "../theme.js";
+/** Static model list. Any key (or q) exits. */
+export default function ModelsScreen({ catalog, selectedModel }) {
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (input === "q" || key.escape || (key.ctrl && input === "c"))
+            exit();
+    });
+    const free = catalog.entries.filter((e) => e.free);
+    const paid = catalog.entries.filter((e) => !e.free);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, bold: true, children: "MethaTech" }), _jsx(Text, { color: theme.muted, children: " \u00B7 models" }), _jsxs(Text, { color: theme.dim, children: [" ", catalog.live ? "(live)" : "(offline, harga tersimpan)"] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.text, bold: true, children: ["FREE models", " ", _jsx(Text, { color: theme.accent, bold: true, children: "$0.00" })] }), free.map((e) => (_jsxs(Text, { color: e.id === selectedModel ? theme.accent : theme.text, children: [e.id === selectedModel ? "▸ " : "  ", e.id] }, e.id)))] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.text, bold: true, children: "PAID models ($ per 1M in / out)" }), paid.map((e) => (_jsxs(Text, { color: e.id === selectedModel ? theme.accent : theme.text, children: [e.id === selectedModel ? "▸ " : "  ", e.id, e.price ? `  ·  $${e.price.input.toFixed(2)} / $${e.price.output.toFixed(2)}` : "  ·  harga —", e.ownedBy ? `  ·  ${e.ownedBy}` : ""] }, e.id)))] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.dim, children: [catalog.entries.length, " models \u00B7 \u25B8 = model aktif \u00B7 q keluar \u00B7 metatech chat --model <id> untuk chat"] }) })] }));
+}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@methatech-cli/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "MethaTech CLI \u2014 chat with MethaTech models from your terminal",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "metatech": "./dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node ./dist/cli.js"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "ink": "^6.8.0",
+    "react": "^19.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.0.0",
+    "typescript": "^5.9.0"
+  }
+}