balchemy 0.1.0

package/dist/index.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * create-balchemy-agent CLI entry point.
+ *
+ * On launch:
+ *   - If ~/.balchemy/agent.json exists → offer to resume or start fresh
+ *   - If no cached agent → run wizard
+ *
+ * Sub-commands:
+ *   (no args)       Resume cached agent or run wizard
+ *   init / --init   Force run wizard (ignore cache)
+ *   start [config]  Start from agent.config.yaml
+ *   docker [outDir] Generate Docker files
+ */
+import * as path from "path";
+import * as readline from "readline";
+import { loadAgent, clearAgent } from "./agent-store.js";
+const [, , cmd, ...args] = process.argv;
+const T = "\x1b[38;2;0;172;176m";
+const G = "\x1b[38;2;186;115;6m";
+const W = "\x1b[1;37m";
+const D = "\x1b[38;5;245m";
+const R = "\x1b[0m";
+function ask(rl, question, defaultVal = "") {
+    return new Promise((resolve) => {
+        const hint = defaultVal ? ` ${D}[${defaultVal}]${R}` : "";
+        rl.question(`  ${question}${hint}: `, (answer) => {
+            resolve(answer.trim() || defaultVal);
+        });
+    });
+}
+async function main() {
+    switch (cmd) {
+        case "--init":
+        case "init": {
+            // Force wizard — ignore cache
+            const { runWizard } = await import("./wizard.js");
+            await runWizard(process.cwd());
+            break;
+        }
+        case "start": {
+            const configPath = args[0] ?? path.join(process.cwd(), "agent.config.yaml");
+            const resolvedPath = path.resolve(configPath);
+            const dotenv = await import("dotenv");
+            const envPath = path.join(path.dirname(resolvedPath), ".env");
+            const fs = await import("fs");
+            if (fs.existsSync(envPath)) {
+                dotenv.config({ path: envPath });
+            }
+            else {
+                dotenv.config();
+            }
+            const { loadConfig } = await import("./config-loader.js");
+            const config = loadConfig(resolvedPath);
+            const publicId = config.mcpEndpoint.split("/").filter(Boolean).pop() ?? "unknown";
+            const { startTui } = await import("./tui/start.js");
+            await startTui({
+                mcpEndpoint: config.mcpEndpoint,
+                apiKey: config.apiKey,
+                llmProvider: config.llmProvider,
+                llmApiKey: config.llmApiKey,
+                llmModel: config.llmModel,
+                llmBaseUrl: config.llmBaseUrl,
+                maxDailyLlmCost: config.maxDailyLlmCost,
+                llmTimeoutMs: config.llmTimeoutMs,
+                publicId,
+                strategy: "custom",
+                shadowMode: false,
+            });
+            break;
+        }
+        case "docker": {
+            const outDir = args[0] ?? process.cwd();
+            const { generateDocker } = await import("./docker-gen.js");
+            await generateDocker(outDir);
+            process.stdout.write(`Docker files written to ${outDir}\n`);
+            break;
+        }
+        case undefined: {
+            // Default: check for cached agent
+            const cached = loadAgent();
+            if (cached) {
+                // Show cached agent info and ask what to do
+                const { renderLogo } = await import("./terminal-logo.js");
+                process.stdout.write(renderLogo(20));
+                process.stdout.write(`\n  ${G}B${T}alchemy ${W}Agent${R}\n\n`);
+                process.stdout.write(`  ${D}Cached agent found:${R}\n`);
+                process.stdout.write(`  ${T}Agent:${R}    ${cached.publicId}\n`);
+                process.stdout.write(`  ${T}Endpoint:${R} ${cached.mcpEndpoint}\n`);
+                process.stdout.write(`  ${T}Model:${R}    ${cached.llmModel ?? "default"}\n`);
+                process.stdout.write(`  ${T}Strategy:${R} ${cached.strategy}\n`);
+                process.stdout.write(`  ${T}Mode:${R}     ${cached.shadowMode ? "Shadow" : "LIVE"}\n`);
+                process.stdout.write(`  ${D}Saved:${R}    ${cached.createdAt}\n\n`);
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const choice = await ask(rl, `${W}Resume this agent?${R} (y/n/new)`, "y");
+                rl.close();
+                if (choice === "y" || choice === "yes") {
+                    // Resume — go straight to TUI
+                    const { startTui } = await import("./tui/start.js");
+                    await startTui({
+                        mcpEndpoint: cached.mcpEndpoint,
+                        apiKey: cached.apiKey,
+                        llmProvider: cached.llmProvider,
+                        llmApiKey: cached.llmApiKey,
+                        llmModel: cached.llmModel,
+                        llmBaseUrl: cached.llmBaseUrl,
+                        maxDailyLlmCost: cached.maxDailyLlmCost,
+                        publicId: cached.publicId,
+                        strategy: cached.strategy,
+                        shadowMode: cached.shadowMode,
+                    });
+                }
+                else if (choice === "new" || choice === "n") {
+                    // New agent — clear cache and run wizard
+                    if (choice === "new")
+                        clearAgent();
+                    const { runWizard } = await import("./wizard.js");
+                    await runWizard(process.cwd());
+                }
+            }
+            else {
+                // No cached agent — run wizard
+                const { runWizard } = await import("./wizard.js");
+                await runWizard(process.cwd());
+            }
+            break;
+        }
+        default: {
+            process.stdout.write(`${T}Balchemy Agent CLI${R}\n\n` +
+                "Usage:\n" +
+                "  npx create-balchemy-agent         Resume agent or setup wizard\n" +
+                "  npx create-balchemy-agent init     Force new setup wizard\n" +
+                "  balchemy-agent start [config]      Start from config file\n" +
+                "  balchemy-agent docker [outDir]     Generate Docker files\n\n");
+            break;
+        }
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# 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/openai-oauth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OpenAI OAuth 2.0 + PKCE authentication for ChatGPT Plus/Pro subscriptions.
+ *
+ * Uses the same flow as the official Codex CLI:
+ *   1. Generate PKCE code_verifier + code_challenge
+ *   2. Start localhost callback server
+ *   3. Open browser → user logs in with ChatGPT account
+ *   4. Exchange auth code for access_token + refresh_token
+ *   5. Auto-refresh before expiry
+ *
+ * Reference: https://developers.openai.com/codex/auth
+ */
+export interface OAuthTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    accountId?: string;
+}
+/**
+ * Run the full OAuth PKCE flow. Opens browser, waits for callback, returns tokens.
+ * Rejects after timeoutMs (default 120s).
+ */
+export declare function loginWithOpenAI(timeoutMs?: number): Promise<OAuthTokens>;
+/**
+ * Refresh an expired access token using the refresh token.
+ */
+export declare function refreshAccessToken(refreshToken: string): Promise<OAuthTokens>;
+//# sourceMappingURL=openai-oauth.d.ts.map

package/dist/openai-oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-oauth.d.ts","sourceRoot":"","sources":["../src/openai-oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,SAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAwFzE;AAkDD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6BnF"}

package/dist/openai-oauth.js

@@ -0,0 +1,215 @@
+/**
+ * OpenAI OAuth 2.0 + PKCE authentication for ChatGPT Plus/Pro subscriptions.
+ *
+ * Uses the same flow as the official Codex CLI:
+ *   1. Generate PKCE code_verifier + code_challenge
+ *   2. Start localhost callback server
+ *   3. Open browser → user logs in with ChatGPT account
+ *   4. Exchange auth code for access_token + refresh_token
+ *   5. Auto-refresh before expiry
+ *
+ * Reference: https://developers.openai.com/codex/auth
+ */
+import * as http from "http";
+import * as crypto from "crypto";
+import { exec } from "child_process";
+// ── Constants ─────────────────────────────────────────────────────────────────
+const CLIENT_ID = "app_EMoamEEZ73f0CkXaXp7hrann";
+const AUTH_URL = "https://auth.openai.com/oauth/authorize";
+const TOKEN_URL = "https://auth.openai.com/oauth/token";
+const CALLBACK_PORT = 1455;
+const REDIRECT_URI = `http://localhost:${CALLBACK_PORT}/auth/callback`;
+const SCOPES = "openid profile email offline_access";
+// ── PKCE Helpers ──────────────────────────────────────────────────────────────
+function generateCodeVerifier() {
+    return crypto.randomBytes(32).toString("base64url");
+}
+function generateCodeChallenge(verifier) {
+    return crypto.createHash("sha256").update(verifier).digest("base64url");
+}
+function generateState() {
+    return crypto.randomBytes(16).toString("hex");
+}
+// ── Browser ───────────────────────────────────────────────────────────────────
+function openBrowser(url) {
+    const cmd = process.platform === "darwin"
+        ? `open "${url}"`
+        : process.platform === "win32"
+            ? `start "${url}"`
+            : `xdg-open "${url}"`;
+    exec(cmd, () => { });
+}
+// ── OAuth Flow ────────────────────────────────────────────────────────────────
+/**
+ * Run the full OAuth PKCE flow. Opens browser, waits for callback, returns tokens.
+ * Rejects after timeoutMs (default 120s).
+ */
+export function loginWithOpenAI(timeoutMs = 120_000) {
+    return new Promise((resolve, reject) => {
+        const codeVerifier = generateCodeVerifier();
+        const codeChallenge = generateCodeChallenge(codeVerifier);
+        const state = generateState();
+        let server = null;
+        let timer = null;
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            if (server)
+                server.close();
+        };
+        timer = setTimeout(() => {
+            cleanup();
+            reject(new Error("OAuth login timed out (120s). Try again."));
+        }, timeoutMs);
+        server = http.createServer(async (req, res) => {
+            const url = new URL(req.url ?? "/", `http://localhost:${CALLBACK_PORT}`);
+            if (url.pathname !== "/auth/callback") {
+                res.writeHead(404);
+                res.end("Not found");
+                return;
+            }
+            const code = url.searchParams.get("code");
+            const returnedState = url.searchParams.get("state");
+            const error = url.searchParams.get("error");
+            if (error) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(errorPage(error));
+                cleanup();
+                reject(new Error(`OAuth error: ${error}`));
+                return;
+            }
+            if (!code || returnedState !== state) {
+                res.writeHead(400, { "Content-Type": "text/html" });
+                res.end(errorPage("Invalid callback — state mismatch or missing code."));
+                cleanup();
+                reject(new Error("OAuth state mismatch"));
+                return;
+            }
+            // Exchange code for tokens
+            try {
+                const tokens = await exchangeCode(code, codeVerifier);
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(successPage());
+                cleanup();
+                resolve(tokens);
+            }
+            catch (err) {
+                res.writeHead(500, { "Content-Type": "text/html" });
+                res.end(errorPage(err instanceof Error ? err.message : "Token exchange failed"));
+                cleanup();
+                reject(err);
+            }
+        });
+        server.listen(CALLBACK_PORT, () => {
+            // Build auth URL
+            const params = new URLSearchParams({
+                client_id: CLIENT_ID,
+                redirect_uri: REDIRECT_URI,
+                response_type: "code",
+                scope: SCOPES,
+                state,
+                code_challenge: codeChallenge,
+                code_challenge_method: "S256",
+            });
+            const authUrl = `${AUTH_URL}?${params.toString()}`;
+            openBrowser(authUrl);
+        });
+        server.on("error", (err) => {
+            cleanup();
+            if (err.code === "EADDRINUSE") {
+                reject(new Error(`Port ${CALLBACK_PORT} is in use. Close other apps and try again.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+// ── Token Exchange ────────────────────────────────────────────────────────────
+async function exchangeCode(code, codeVerifier) {
+    const body = new URLSearchParams({
+        grant_type: "authorization_code",
+        client_id: CLIENT_ID,
+        code,
+        redirect_uri: REDIRECT_URI,
+        code_verifier: codeVerifier,
+    });
+    const res = await fetch(TOKEN_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: body.toString(),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Token exchange failed: ${res.status} ${text}`);
+    }
+    const data = (await res.json());
+    // Extract accountId from access token (JWT payload)
+    let accountId;
+    try {
+        const payload = JSON.parse(Buffer.from(data.access_token.split(".")[1], "base64").toString());
+        accountId = payload.sub ?? payload.account_id;
+    }
+    catch {
+        // non-critical
+    }
+    return {
+        accessToken: data.access_token,
+        refreshToken: data.refresh_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+        accountId,
+    };
+}
+/**
+ * Refresh an expired access token using the refresh token.
+ */
+export async function refreshAccessToken(refreshToken) {
+    const body = new URLSearchParams({
+        grant_type: "refresh_token",
+        client_id: CLIENT_ID,
+        refresh_token: refreshToken,
+    });
+    const res = await fetch(TOKEN_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: body.toString(),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Token refresh failed: ${res.status} ${text}`);
+    }
+    const data = (await res.json());
+    return {
+        accessToken: data.access_token,
+        refreshToken: data.refresh_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    };
+}
+// ── HTML Pages ────────────────────────────────────────────────────────────────
+/**
+ * Escape HTML special characters to prevent XSS when interpolating
+ * untrusted strings (e.g. OAuth error parameters) into HTML responses.
+ */
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function successPage() {
+    return `<!DOCTYPE html><html><body style="font-family:system-ui;display:flex;justify-content:center;align-items:center;height:100vh;background:#0a0a0a;color:#00acb0">
+    <div style="text-align:center">
+      <h1>Logged in</h1>
+      <p style="color:#888">You can close this tab and return to the terminal.</p>
+    </div></body></html>`;
+}
+function errorPage(msg) {
+    return `<!DOCTYPE html><html><body style="font-family:system-ui;display:flex;justify-content:center;align-items:center;height:100vh;background:#0a0a0a;color:#e55">
+    <div style="text-align:center">
+      <h1>Login failed</h1>
+      <p style="color:#888">${escapeHtml(msg)}</p>
+    </div></body></html>`;
+}
+//# sourceMappingURL=openai-oauth.js.map

package/dist/openai-oauth.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Starts the AgentLoop from a config file path.
+ * Handles process signals (SIGINT, SIGTERM) for graceful shutdown.
+ */
+export declare function runAgent(configPath: string): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhE"}

package/dist/runner.js

@@ -0,0 +1,63 @@
+/**
+ * Starts the AgentLoop from a config file path.
+ * Handles process signals (SIGINT, SIGTERM) for graceful shutdown.
+ */
+import * as dotenv from 'dotenv';
+import * as path from 'path';
+import * as fs from 'fs';
+import { AgentLoop } from '@balchemyai/agent-sdk';
+import { loadConfig } from './config-loader.js';
+function loadDotEnv(configPath) {
+    // Look for .env relative to the config file directory
+    const envPath = path.join(path.dirname(configPath), '.env');
+    if (fs.existsSync(envPath)) {
+        dotenv.config({ path: envPath });
+    }
+    else {
+        // Fall back to cwd
+        dotenv.config();
+    }
+}
+export async function runAgent(configPath) {
+    const resolvedPath = path.resolve(configPath);
+    // Load .env before parsing config (config may reference env vars)
+    loadDotEnv(resolvedPath);
+    process.stdout.write(`Starting Balchemy agent from: ${resolvedPath}\n`);
+    const config = loadConfig(resolvedPath);
+    const loop = new AgentLoop({
+        ...config,
+        onStatusChange: (status) => {
+            process.stdout.write(`[agent] status=${status.status} events=${status.eventsReceived} ` +
+                `decisions=${status.decisionsExecuted} trades=${status.tradesExecuted} ` +
+                `llmCost=$${status.llmCostToday.toFixed(4)}/${status.maxDailyLlmCost}\n`);
+        },
+        onDecision: (decision) => {
+            process.stdout.write(`[agent] decision action=${decision.action}` +
+                (decision.token ? ` token=${decision.token}` : '') +
+                (decision.amount ? ` amount=${decision.amount}` : '') +
+                (decision.confidence !== undefined ? ` confidence=${decision.confidence}` : '') +
+                '\n');
+        },
+        onError: (err) => {
+            process.stderr.write(`[agent] error: ${err.message}\n`);
+        },
+    });
+    // Graceful shutdown
+    let stopping = false;
+    const shutdown = async () => {
+        if (stopping)
+            return;
+        stopping = true;
+        process.stdout.write('\n[agent] Shutting down...\n');
+        await loop.stop();
+        process.stdout.write('[agent] Stopped.\n');
+        process.exit(0);
+    };
+    process.on('SIGINT', () => { void shutdown(); });
+    process.on('SIGTERM', () => { void shutdown(); });
+    await loop.start();
+    process.stdout.write('[agent] Running. Press Ctrl+C to stop.\n');
+    // Keep process alive
+    await new Promise(() => { });
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,SAAS,UAAU,CAAC,UAAkB;IACpC,sDAAsD;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,mBAAmB;QACnB,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9C,kEAAkE;IAClE,UAAU,CAAC,YAAY,CAAC,CAAC;IAEzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,YAAY,IAAI,CAAC,CAAC;IAExE,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAExC,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC;QACzB,GAAG,MAAM;QACT,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,cAAc,GAAG;gBAClE,aAAa,MAAM,CAAC,iBAAiB,WAAW,MAAM,CAAC,cAAc,GAAG;gBACxE,YAAY,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,eAAe,IAAI,CACzE,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,QAAQ,CAAC,MAAM,EAAE;gBAC5C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC,CAAC;IAEH,oBAAoB;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAEjE,qBAAqB;IACrB,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAAsC,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/terminal-logo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Terminal image rendering for BCrow logo.
+ *
+ * Terminal emulators do not share one universal "render this SVG" API, so we
+ * ship a bundled PNG and use native image protocols when the terminal supports
+ * them. Everyone else gets the ANSI art fallback.
+ */
+/**
+ * Render the BCrow logo. Uses native terminal image protocol when available,
+ * falls back to ANSI block art.
+ *
+ * @param widthCols — terminal columns to use for the image (default 20)
+ */
+export declare function renderLogo(widthCols?: number): string;
+//# sourceMappingURL=terminal-logo.d.ts.map

package/dist/terminal-logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-logo.d.ts","sourceRoot":"","sources":["../src/terminal-logo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+FH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,SAAK,GAAG,MAAM,CAsBjD"}

package/dist/terminal-logo.js

@@ -0,0 +1,121 @@
+/**
+ * Terminal image rendering for BCrow logo.
+ *
+ * Terminal emulators do not share one universal "render this SVG" API, so we
+ * ship a bundled PNG and use native image protocols when the terminal supports
+ * them. Everyone else gets the ANSI art fallback.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+const __filename_esm = fileURLToPath(import.meta.url);
+const __dirname_esm = path.dirname(__filename_esm);
+// ── Brand colors ──────────────────────────────────────────────────────────────
+const T = "\x1b[38;2;0;172;176m"; // teal
+const DT = "\x1b[38;2;0;120;124m"; // dark teal
+const G = "\x1b[38;2;186;115;6m"; // gold
+const R = "\x1b[0m"; // reset
+// ── ANSI fallback logo ────────────────────────────────────────────────────────
+// Per-letter gradient colors matching the Balchemy brand logo
+// Generated via figlet -f small, then colorized per-letter
+const C1 = "\x1b[38;2;0;172;176m"; // B — teal
+const C2 = "\x1b[38;2;0;152;160m"; // A — teal-blue
+const C3 = "\x1b[38;2;180;100;140m"; // L — rose
+const C4 = "\x1b[38;2;186;155;6m"; // C — gold
+const C5 = "\x1b[38;2;0;160;170m"; // H — teal
+const C6 = "\x1b[38;2;80;130;200m"; // E — blue
+const C7 = "\x1b[38;2;170;90;150m"; // M — magenta
+const C8 = "\x1b[38;2;90;140;190m"; // Y — slate blue
+const D = "\x1b[38;5;245m"; // dim gray
+const ANSI_LOGO = [
+    ``,
+    `  ${C1} ___ ${R}${C2}   _   ${R}${C3} _    ${R}${C4}  ___ ${R}${C5} _  _ ${R}${C6} ___ ${R}${C7} __  __ ${R}${C8}__   __${R}`,
+    `  ${C1}| _ )${R}${C2}  /_\\  ${R}${C3}| |   ${R}${C4} / __|${R}${C5}| || |${R}${C6}| __|${R}${C7}|  \\/  |${R}${C8}\\ \\ / /${R}`,
+    `  ${C1}| _ \\${R}${C2} / _ \\ ${R}${C3}| |__ ${R}${C4}| (__ ${R}${C5}| __ |${R}${C6}| _| ${R}${C7}| |\\/| |${R}${C8} \\ V / ${R}`,
+    `  ${C1}|___/${R}${C2}/_/ \\_\\${R}${C3}|____|${R}${C4} \\___|${R}${C5}|_||_|${R}${C6}|___|${R}${C7}|_|  |_|${R}${C8}  |_|  ${R}`,
+    `  ${D}${"─".repeat(52)}${R}`,
+    ``,
+].join("\n");
+function detectProtocol() {
+    const term = process.env.TERM_PROGRAM ?? "";
+    const termInfo = process.env.TERM ?? "";
+    // iTerm2 inline image protocol
+    if (term === "iTerm.app" ||
+        term === "WezTerm" ||
+        process.env.WEZTERM_EXECUTABLE) {
+        return "iterm2";
+    }
+    // Kitty graphics protocol
+    if (process.env.KITTY_WINDOW_ID || termInfo.includes("kitty")) {
+        return "kitty";
+    }
+    return "none";
+}
+// ── iTerm2 inline image rendering ─────────────────────────────────────────────
+function renderIterm2(image, widthCols) {
+    return `\x1b]1337;File=size=${image.byteSize};inline=1;width=${widthCols};preserveAspectRatio=1:${image.base64}\x07`;
+}
+// ── Kitty graphics protocol rendering ─────────────────────────────────────────
+function renderKitty(image, widthCols) {
+    const chunks = [];
+    const chunkSize = 4096;
+    for (let i = 0; i < image.base64.length; i += chunkSize) {
+        const chunk = image.base64.slice(i, i + chunkSize);
+        const isLast = i + chunkSize >= image.base64.length;
+        if (i === 0) {
+            chunks.push(`\x1b_Gq=2,f=100,a=T,c=${widthCols},m=${isLast ? 0 : 1};${chunk}\x1b\\`);
+        }
+        else {
+            chunks.push(`\x1b_Gm=${isLast ? 0 : 1};${chunk}\x1b\\`);
+        }
+    }
+    return chunks.join("");
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Render the BCrow logo. Uses native terminal image protocol when available,
+ * falls back to ANSI block art.
+ *
+ * @param widthCols — terminal columns to use for the image (default 20)
+ */
+export function renderLogo(widthCols = 20) {
+    const protocol = detectProtocol();
+    if (protocol === "none") {
+        return ANSI_LOGO;
+    }
+    // Try to load the bundled image
+    const image = loadBundledImage();
+    if (!image) {
+        return ANSI_LOGO;
+    }
+    if (protocol === "iterm2") {
+        return "\n" + renderIterm2(image, widthCols) + "\n";
+    }
+    if (protocol === "kitty") {
+        return "\n" + renderKitty(image, widthCols) + "\n";
+    }
+    return ANSI_LOGO;
+}
+function loadBundledImage() {
+    const candidates = [
+        path.join(__dirname_esm, "..", "assets", "bcrow.png"),
+        path.join(__dirname_esm, "assets", "bcrow.png"),
+        path.join(process.cwd(), "create-balchemy-agent", "assets", "bcrow.png"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (fs.existsSync(candidate)) {
+                const buf = fs.readFileSync(candidate);
+                return {
+                    base64: buf.toString("base64"),
+                    byteSize: buf.byteLength,
+                };
+            }
+        }
+        catch {
+            // continue
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=terminal-logo.js.map

package/dist/terminal-logo.js.map

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