apiario 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# 🐝 apiario — CLI Harness
+
+An `npx`-installable CLI tool that wraps [pi.dev](https://pi.dev) (v0.74.0),
+pre-configured to use Apiário's API (`api.apiario.dev`) as the LLM provider.
+Launches directly into pi's TUI interactive mode.
+
+## Usage
+
+```bash
+# Run directly (requires Node >= 20.6.0)
+npx apiario
+
+# Or with an explicit API key
+APIARIO_API_KEY=sk-... npx apiario
+```
+
+On first run, the tool will guide you through setting up your API key.
+
+## Quick start
+
+1. **Get an API key** at [platform.apiario.dev/auth](https://platform.apiario.dev/auth)
+2. **Run** `npx apiario`
+3. Paste your `sk-...` key when prompted
+4. Start chatting in the TUI
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `APIARIO_API_KEY` | No | API key. Falls back to `~/.config/apiario/settings.json` if not set |
+
+## Config file location
+
+All configuration is stored under `~/.config/apiario/`:
+
+- `settings.json` — API key
+- `models.json` — Cached model list (24 h TTL)
+
+## Development
+
+```bash
+# Install dependencies
+cd harness && npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run locally
+node dist/cli.js
+```
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,28 @@
+import type { ApiarioConfig } from "./types.js";
+/**
+ * Resolve the API key in order of priority:
+ * 1. `APIARIO_API_KEY` environment variable
+ * 2. `~/.config/apiario/settings.json`
+ *
+ * Returns the key if found, or `null` if neither source has one.
+ */
+export declare function resolveApiKey(): string | null;
+/**
+ * Validate an API key by hitting GET /v1/models.
+ * Returns `true` if the endpoint responds with a non-4xx status.
+ */
+export declare function validateApiKey(apiKey: string): Promise<boolean>;
+/**
+ * Run the interactive setup wizard.
+ *
+ * 1. Prints welcome box
+ * 2. Prompts for API key (hidden input)
+ * 3. Validates the key against GET /v1/models
+ * 4. On success: saves config, prints MOTD, returns config
+ * 5. On failure: retries up to `maxRetries` times
+ *
+ * @param maxRetries Maximum number of validation attempts (default 3).
+ * @returns The validated ApiarioConfig, or `null` if the user gave up.
+ */
+export declare function runSetupWizard(maxRetries?: number): Promise<ApiarioConfig | null>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAYhD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAc7C;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAgGD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,UAAU,SAAI,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6C/B"}

package/dist/auth.js

@@ -0,0 +1,180 @@
+import { createInterface } from "readline";
+import { loadConfig, saveConfig, SETTINGS_PATH } from "./config.js";
+import { API_BASE_URL, apiClientHeaders } from "./client.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MOTD = "Apiário - de dev pra dev";
+// ---------------------------------------------------------------------------
+// Key resolution (env var > config file > wizard)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the API key in order of priority:
+ * 1. `APIARIO_API_KEY` environment variable
+ * 2. `~/.config/apiario/settings.json`
+ *
+ * Returns the key if found, or `null` if neither source has one.
+ */
+export function resolveApiKey() {
+    // 1. Environment variable
+    const envKey = process.env.APIARIO_API_KEY;
+    if (typeof envKey === "string" && envKey.trim().length > 0) {
+        return envKey.trim();
+    }
+    // 2. Config file
+    const config = loadConfig();
+    if (config && config.apiKey.trim().length > 0) {
+        return config.apiKey.trim();
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Key validation
+// ---------------------------------------------------------------------------
+/**
+ * Validate an API key by hitting GET /v1/models.
+ * Returns `true` if the endpoint responds with a non-4xx status.
+ */
+export async function validateApiKey(apiKey) {
+    try {
+        const res = await fetch(`${API_BASE_URL}/models`, {
+            headers: {
+                ...apiClientHeaders(),
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "application/json",
+            },
+        });
+        // Any non-4xx response means the key is accepted
+        return res.status < 400;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Setup wizard
+// ---------------------------------------------------------------------------
+/**
+ * Prompt the user for a single line of input, optionally hiding what they type.
+ * Returns the trimmed input.
+ */
+function promptInput(question, hidden = false) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true,
+        });
+        if (hidden) {
+            // Raw mode: read characters one by one, echo '*' instead of the actual char
+            const stdin = process.stdin;
+            const stdout = process.stdout;
+            stdin.setRawMode?.(true);
+            stdin.resume();
+            let input = "";
+            stdout.write(question);
+            const onData = (chunk) => {
+                const char = chunk.toString();
+                if (char === "\r" || char === "\n") {
+                    stdin.setRawMode?.(false);
+                    stdin.pause();
+                    stdin.removeListener("data", onData);
+                    stdout.write("\n");
+                    rl.close();
+                    resolve(input);
+                    return;
+                }
+                if (char === "\u0003") {
+                    // Ctrl+C
+                    stdin.setRawMode?.(false);
+                    stdin.pause();
+                    stdin.removeListener("data", onData);
+                    stdout.write("\n");
+                    rl.close();
+                    process.exit(1);
+                }
+                // Backspace
+                if (char === "\u007f") {
+                    if (input.length > 0) {
+                        input = input.slice(0, -1);
+                        stdout.write("\b \b");
+                    }
+                    return;
+                }
+                input += char;
+                stdout.write("*");
+            };
+            stdin.on("data", onData);
+        }
+        else {
+            rl.question(question, (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        }
+    });
+}
+/**
+ * Print the welcome box from DESIGN.md.
+ */
+function printWizardBox() {
+    const border = "╔══════════════════════════════════════════════╗";
+    const bottom = "╚══════════════════════════════════════════════╝";
+    const pad = (line) => `║  ${line.padEnd(44)}║`;
+    console.log(`\n${border}`);
+    console.log(pad("🐝 Apiário Dev — CLI Harness"));
+    console.log(pad(""));
+    console.log(pad("Bem-vindo! Primeiro uso detectado."));
+    console.log(pad("Acesse https://platform.apiario.dev/auth,"));
+    console.log(pad("crie uma chave de API em API Keys,"));
+    console.log(pad("e cole o token (sk-...) abaixo."));
+    console.log(pad(""));
+    console.log(pad("🔑  Chave de API: ********************"));
+    console.log(`${bottom}\n`);
+}
+/**
+ * Run the interactive setup wizard.
+ *
+ * 1. Prints welcome box
+ * 2. Prompts for API key (hidden input)
+ * 3. Validates the key against GET /v1/models
+ * 4. On success: saves config, prints MOTD, returns config
+ * 5. On failure: retries up to `maxRetries` times
+ *
+ * @param maxRetries Maximum number of validation attempts (default 3).
+ * @returns The validated ApiarioConfig, or `null` if the user gave up.
+ */
+export async function runSetupWizard(maxRetries = 3) {
+    printWizardBox();
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        const apiKey = await promptInput("🔑  Chave de API: ", true);
+        if (!apiKey || apiKey.length === 0) {
+            console.log("  ❌  Nenhuma chave informada. Tente novamente.");
+            continue;
+        }
+        if (!apiKey.startsWith("sk-")) {
+            console.log("  ❌  Chave inválida. A chave deve começar com 'sk-'.");
+            if (attempt < maxRetries) {
+                console.log("     Tente novamente.\n");
+            }
+            continue;
+        }
+        console.log("  ⏳  Validando chave...");
+        const valid = await validateApiKey(apiKey);
+        if (valid) {
+            const config = { apiKey };
+            saveConfig(config);
+            console.log(`  ✅  Chave salva em ${SETTINGS_PATH}`);
+            console.log(`\n  🐝  ${MOTD}\n`);
+            return config;
+        }
+        console.log("  ❌  Chave rejeitada pela API. Verifique se o token está correto.");
+        if (attempt < maxRetries) {
+            console.log("     Tente novamente.\n");
+        }
+    }
+    console.log("\n  ❌  Número máximo de tentativas excedido.");
+    console.log("     Execute 'npx apiario' novamente quando tiver uma chave válida.\n");
+    return null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { AuthStorage, ModelRegistry, InteractiveMode, runPrintMode, createAgentSessionRuntime, createAgentSessionFromServices, createAgentSessionServices, SessionManager, } from "@earendil-works/pi-coding-agent";
+import { resolveApiKey, runSetupWizard } from "./auth.js";
+import { resolveModels, mapToProviderModelConfigs, sortModelsByPriority } from "./provider.js";
+import { API_BASE_URL, apiClientHeaders } from "./client.js";
+import { homedir } from "os";
+import { join } from "path";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const AGENT_DIR = join(homedir(), ".config", "apiario");
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    // ── 1. Resolve API key ──────────────────────────────────────────────
+    let apiKey = resolveApiKey();
+    if (!apiKey) {
+        const config = await runSetupWizard();
+        if (!config) {
+            console.error("\n  ❌  Nenhuma chave de API configurada. Execute novamente quando tiver uma chave válida.");
+            process.exit(1);
+        }
+        apiKey = config.apiKey;
+    }
+    // ── 2. Fetch & cache models ────────────────────────────────────────
+    let models;
+    try {
+        const rawCards = await resolveModels(apiKey);
+        const mapped = mapToProviderModelConfigs(rawCards);
+        models = sortModelsByPriority(mapped);
+        console.error(`  📦  ${models.length} modelos disponíveis via Apiário Dev\n`);
+    }
+    catch (err) {
+        console.error("  ❌  Erro ao buscar modelos da API. Verifique sua conexão e chave de API.\n");
+        process.exit(2);
+    }
+    // ── 3. Set up pi.dev infrastructure with our provider ──────────────
+    const authStorage = AuthStorage.create();
+    // Store the API key in auth storage so pi can resolve it
+    authStorage.setRuntimeApiKey("apiario", apiKey);
+    const modelRegistry = ModelRegistry.inMemory(authStorage);
+    modelRegistry.registerProvider("apiario", {
+        name: "Apiário Dev",
+        baseUrl: API_BASE_URL,
+        apiKey,
+        api: "openai-completions",
+        authHeader: true,
+        headers: apiClientHeaders(),
+        models,
+    });
+    // ── 4. Create runtime ──────────────────────────────────────────────
+    const createRuntime = async ({ cwd, agentDir, sessionManager, sessionStartEvent, }) => {
+        const services = await createAgentSessionServices({
+            cwd,
+            agentDir,
+            authStorage,
+            modelRegistry,
+        });
+        // Get the first model from our registered provider
+        const firstModel = modelRegistry.getAll().find((m) => m.provider === "apiario");
+        const sessionResult = await createAgentSessionFromServices({
+            services,
+            sessionManager,
+            sessionStartEvent,
+            model: firstModel,
+        });
+        return {
+            ...sessionResult,
+            services,
+            diagnostics: services.diagnostics,
+        };
+    };
+    const cwd = process.cwd();
+    const sessionManager = await SessionManager.create(cwd);
+    const runtime = await createAgentSessionRuntime(createRuntime, {
+        cwd,
+        agentDir: AGENT_DIR,
+        sessionManager,
+    });
+    // ── 5. Detect TTY and launch mode ──────────────────────────────────
+    const isTTY = process.stdout.isTTY && !process.env.PIPESTART;
+    if (isTTY) {
+        const interactiveMode = new InteractiveMode(runtime);
+        await interactiveMode.init();
+        await interactiveMode.run();
+    }
+    else {
+        // Non-TTY (pipe): read from stdin and run print mode
+        const stdin = await readStdin();
+        const prompt = stdin.trim() || "Explain what this project does in one sentence.";
+        console.error("\n  🐝  Apiário Dev — modo não-interativo");
+        console.error("  Execute 'npx apiario' sem pipe para entrar no modo interativo (TUI).\n");
+        await runPrintMode(runtime, {
+            mode: "text",
+            initialMessage: prompt,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readStdin() {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY) {
+            resolve("");
+            return;
+        }
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    });
+}
+// ---------------------------------------------------------------------------
+// Run
+// ---------------------------------------------------------------------------
+main().catch((err) => {
+    console.error("\n  ❌  Erro inesperado:", err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,7 @@
+export declare const API_BASE_URL = "https://api.apiario.dev/v1";
+/**
+ * Returns headers that identify the client making the request.
+ * Every outbound API call to api.apiario.dev should include these.
+ */
+export declare function apiClientHeaders(): Record<string, string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAMzD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzD"}

package/dist/client.js

@@ -0,0 +1,27 @@
+import { createRequire } from "module";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+// ---------------------------------------------------------------------------
+// Version (read from package.json at runtime to stay in sync)
+// ---------------------------------------------------------------------------
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const { version } = require(resolve(__dirname, "..", "package.json"));
+// ---------------------------------------------------------------------------
+// API base URL
+// ---------------------------------------------------------------------------
+export const API_BASE_URL = "https://api.apiario.dev/v1";
+// ---------------------------------------------------------------------------
+// Client identification headers
+// ---------------------------------------------------------------------------
+/**
+ * Returns headers that identify the client making the request.
+ * Every outbound API call to api.apiario.dev should include these.
+ */
+export function apiClientHeaders() {
+    return {
+        "x-client": "apiario-harness",
+        "x-client-version": version,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;AAEtE,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,UAAU,EAAE,iBAAiB;QAC7B,kBAAkB,EAAE,OAAO;KAC5B,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+import type { ApiarioConfig, ModelsCache } from "./types.js";
+/** XDG-style config directory: ~/.config/apiario */
+export declare const CONFIG_DIR: string;
+/** Path to the settings JSON file. */
+export declare const SETTINGS_PATH: string;
+/** Path to the cached models JSON file. */
+export declare const MODELS_CACHE_PATH: string;
+/** Ensure the config directory exists (mode 0700). */
+export declare function ensureConfigDir(): void;
+/** Load ApiarioConfig from settings.json. Returns null if file doesn't exist or is unparseable. */
+export declare function loadConfig(): ApiarioConfig | null;
+/** Persist ApiarioConfig to settings.json (pretty-printed). */
+export declare function saveConfig(config: ApiarioConfig): void;
+/** Read cached models. Returns null if the file doesn't exist or is invalid. */
+export declare function readModelsCache(): ModelsCache | null;
+/** Write models to the cache file with the current timestamp. */
+export declare function writeModelsCache(models: ModelsCache["models"], fetchedAt?: number): void;
+/** Check whether a cached models payload is still valid (24 h TTL). */
+export declare function isCacheValid(cache: ModelsCache): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM7D,oDAAoD;AACpD,eAAO,MAAM,UAAU,QAAwC,CAAC;AAEhE,sCAAsC;AACtC,eAAO,MAAM,aAAa,QAAoC,CAAC;AAE/D,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,QAAkC,CAAC;AAMjE,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAMD,mGAAmG;AACnG,wBAAgB,UAAU,IAAI,aAAa,GAAG,IAAI,CAYjD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAGtD;AAMD,gFAAgF;AAChF,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAQpD;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAON;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAGxD"}

package/dist/config.js

@@ -0,0 +1,75 @@
+import { homedir } from "os";
+import { join } from "path";
+import { mkdirSync, existsSync, readFileSync, writeFileSync } from "fs";
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+/** XDG-style config directory: ~/.config/apiario */
+export const CONFIG_DIR = join(homedir(), ".config", "apiario");
+/** Path to the settings JSON file. */
+export const SETTINGS_PATH = join(CONFIG_DIR, "settings.json");
+/** Path to the cached models JSON file. */
+export const MODELS_CACHE_PATH = join(CONFIG_DIR, "models.json");
+// ---------------------------------------------------------------------------
+// Directory helpers
+// ---------------------------------------------------------------------------
+/** Ensure the config directory exists (mode 0700). */
+export function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+// ---------------------------------------------------------------------------
+// Config I/O
+// ---------------------------------------------------------------------------
+/** Load ApiarioConfig from settings.json. Returns null if file doesn't exist or is unparseable. */
+export function loadConfig() {
+    try {
+        if (!existsSync(SETTINGS_PATH))
+            return null;
+        const raw = readFileSync(SETTINGS_PATH, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.apiKey === "string" && parsed.apiKey.length > 0) {
+            return { apiKey: parsed.apiKey };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Persist ApiarioConfig to settings.json (pretty-printed). */
+export function saveConfig(config) {
+    ensureConfigDir();
+    writeFileSync(SETTINGS_PATH, JSON.stringify(config, null, 2), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Models cache I/O
+// ---------------------------------------------------------------------------
+/** Read cached models. Returns null if the file doesn't exist or is invalid. */
+export function readModelsCache() {
+    try {
+        if (!existsSync(MODELS_CACHE_PATH))
+            return null;
+        const raw = readFileSync(MODELS_CACHE_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Write models to the cache file with the current timestamp. */
+export function writeModelsCache(models, fetchedAt) {
+    ensureConfigDir();
+    const payload = {
+        fetchedAt: fetchedAt ?? Date.now(),
+        models,
+    };
+    writeFileSync(MODELS_CACHE_PATH, JSON.stringify(payload, null, 2), "utf-8");
+}
+/** Check whether a cached models payload is still valid (24 h TTL). */
+export function isCacheValid(cache) {
+    const TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+    return Date.now() - cache.fetchedAt < TTL_MS;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,30 @@
+import type { ModelCard } from "./types.js";
+import type { ProviderModelConfig } from "@earendil-works/pi-coding-agent";
+/**
+ * Fetch available models from GET /v1/models.
+ * Returns the raw model cards or throws on error.
+ */
+export declare function fetchModels(apiKey: string): Promise<ModelCard[]>;
+/**
+ * Get the model list — tries the live API first, falls back to cache.
+ * If cache is expired but API is unreachable, uses expired cache with a warning.
+ */
+export declare function resolveModels(apiKey: string): Promise<ModelCard[]>;
+/**
+ * Map Apiário ModelCard[] into pi.dev ProviderModelConfig[].
+ */
+export declare function mapToProviderModelConfigs(cards: ModelCard[]): ProviderModelConfig[];
+/**
+ * Sort models by provider priority, then alphabetically by ID within
+ * each group.
+ */
+export declare function sortModelsByPriority(configs: ProviderModelConfig[]): ProviderModelConfig[];
+/**
+ * Register the "apiario" provider in pi.dev with resolved models.
+ *
+ * @param registerFn - The `pi.registerProvider` function from the SDK.
+ * @param apiKey     - The resolved API key (literal string).
+ * @param models     - The sorted, mapped provider model configs.
+ */
+export declare function registerApiarioProvider(registerFn: (name: string, config: Record<string, unknown>) => void, apiKey: string, models: ProviderModelConfig[]): void;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAM3E;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAwBtB;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAuBtB;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAAE,GACjB,mBAAmB,EAAE,CAwBvB;AAaD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,EAAE,CAYvB;AAMD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACnE,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,EAAE,GAC5B,IAAI,CASN"}

package/dist/provider.js

@@ -0,0 +1,130 @@
+import { readModelsCache, writeModelsCache, isCacheValid, } from "./config.js";
+import { API_BASE_URL, apiClientHeaders } from "./client.js";
+// ---------------------------------------------------------------------------
+// Model fetching
+// ---------------------------------------------------------------------------
+/**
+ * Fetch available models from GET /v1/models.
+ * Returns the raw model cards or throws on error.
+ */
+export async function fetchModels(apiKey) {
+    const res = await fetch(`${API_BASE_URL}/models`, {
+        headers: {
+            ...apiClientHeaders(),
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Falha ao buscar modelos: HTTP ${res.status} ${res.statusText}`);
+    }
+    const body = await res.json();
+    const data = body.data ?? body;
+    if (!Array.isArray(data)) {
+        throw new Error("Resposta de /v1/models não contém um array 'data'");
+    }
+    return data;
+}
+// ---------------------------------------------------------------------------
+// Caching
+// ---------------------------------------------------------------------------
+/**
+ * Get the model list — tries the live API first, falls back to cache.
+ * If cache is expired but API is unreachable, uses expired cache with a warning.
+ */
+export async function resolveModels(apiKey) {
+    // Try live API first
+    try {
+        const models = await fetchModels(apiKey);
+        writeModelsCache(models);
+        return models;
+    }
+    catch (fetchErr) {
+        // Fall back to cache (even if expired)
+        const cached = readModelsCache();
+        if (cached && cached.models.length > 0) {
+            if (!isCacheValid(cached)) {
+                console.warn("  ⚠️  API indisponível. Usando lista de modelos em cache (desde " +
+                    new Date(cached.fetchedAt).toLocaleString("pt-BR") +
+                    ").");
+            }
+            return cached.models;
+        }
+        // No cache available — rethrow the original error
+        throw fetchErr;
+    }
+}
+// ---------------------------------------------------------------------------
+// Model mapping
+// ---------------------------------------------------------------------------
+/**
+ * Map Apiário ModelCard[] into pi.dev ProviderModelConfig[].
+ */
+export function mapToProviderModelConfigs(cards) {
+    return cards.map((card) => {
+        const inputTypes = card.capabilities.includes("vision")
+            ? ["text", "image"]
+            : ["text"];
+        return {
+            id: card.id,
+            name: card.name,
+            api: "openai-completions",
+            reasoning: card.capabilities.includes("reasoning"),
+            input: inputTypes,
+            cost: {
+                input: parseFloat(card.input_price_brl_per_1m) || 0,
+                output: parseFloat(card.output_price_brl_per_1m) || 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+            },
+            contextWindow: card.context_window,
+            maxTokens: Math.min(card.context_window, 128000),
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Model sorting
+// ---------------------------------------------------------------------------
+/** Priority groups for model providers. Lower number = higher priority. */
+const PROVIDER_PRIORITY = {
+    DeepSeek: 0,
+    OpenAI: 1,
+    Anthropic: 2,
+};
+/**
+ * Sort models by provider priority, then alphabetically by ID within
+ * each group.
+ */
+export function sortModelsByPriority(configs) {
+    return [...configs].sort((a, b) => {
+        // Extract provider name from model ID (format: "provider/model-name")
+        const providerA = a.id.split("/")[0] ?? "";
+        const providerB = b.id.split("/")[0] ?? "";
+        const priA = PROVIDER_PRIORITY[providerA] ?? 99;
+        const priB = PROVIDER_PRIORITY[providerB] ?? 99;
+        if (priA !== priB)
+            return priA - priB;
+        return a.id.localeCompare(b.id);
+    });
+}
+// ---------------------------------------------------------------------------
+// Provider registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the "apiario" provider in pi.dev with resolved models.
+ *
+ * @param registerFn - The `pi.registerProvider` function from the SDK.
+ * @param apiKey     - The resolved API key (literal string).
+ * @param models     - The sorted, mapped provider model configs.
+ */
+export function registerApiarioProvider(registerFn, apiKey, models) {
+    registerFn("apiario", {
+        name: "Apiário Dev",
+        baseUrl: API_BASE_URL,
+        apiKey,
+        api: "openai-completions",
+        authHeader: true,
+        models,
+    });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Types for the Apiário Dev CLI Harness.
+ *
+ * Mirrors the /v1/models response shape and pi.dev Model shape
+ * as described in DESIGN.md (Model card mapping).
+ */
+/** Stored configuration for the harness. */
+export interface ApiarioConfig {
+    /** The user's API key (sk-...). */
+    apiKey: string;
+}
+/** A single model card as returned by GET /v1/models. */
+export interface ModelCard {
+    id: string;
+    name: string;
+    provider: string;
+    capabilities: string[];
+    context_window: number;
+    input_price_brl_per_1m: string;
+    output_price_brl_per_1m: string;
+    created: number;
+}
+/** Top-level response from GET /v1/models. */
+export interface ModelListResponse {
+    object: string;
+    data: ModelCard[];
+}
+/** Cached models payload with timestamp for TTL checks. */
+export interface ModelsCache {
+    fetchedAt: number;
+    models: ModelCard[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for the Apiário Dev CLI Harness.
+ *
+ * Mirrors the /v1/models response shape and pi.dev Model shape
+ * as described in DESIGN.md (Model card mapping).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "apiario",
+  "version": "0.1.0",
+  "description": "CLI Harness — pi.dev TUI wrapper for Apiário Dev API",
+  "type": "module",
+  "bin": {
+    "apiario": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@earendil-works/pi-coding-agent": "0.74.0",
+    "@earendil-works/pi-ai": "0.74.0",
+    "typebox": "1.1.38"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "files": ["dist"]
+}