@albalink/agent 1.0.0

package/dist/tui/ModelSelector.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ModelSelector — interactive model picker overlay for ALBA.
+ */
+import { useState, useCallback, useEffect, useMemo } from "react";
+import { Box, Text, useInput } from "ink";
+import TextInput from "ink-text-input";
+import { ALBA_COLORS, T } from "./theme.js";
+import { modelRegistry } from "../models/ModelRegistry.js";
+const STATIC_FALLBACK = [
+    { id: "anthropic/claude-sonnet-4-5", provider: "Anthropic" },
+    { id: "openai/gpt-4o", provider: "OpenAI" },
+    { id: "openai/gpt-4o-mini", provider: "OpenAI" },
+    { id: "google/gemini-flash-1.5", provider: "Google" },
+    { id: "meta-llama/llama-3-8b-instruct:free", provider: "Meta" },
+    { id: "deepseek/deepseek-chat", provider: "DeepSeek" },
+];
+function getAvailableModels() {
+    try {
+        const registryModels = modelRegistry.search("");
+        if (registryModels && registryModels.length > 0) {
+            return registryModels.map(m => ({
+                id: m.model.id,
+                provider: m.tier.charAt(0).toUpperCase() + m.tier.slice(1),
+            }));
+        }
+    }
+    catch { /* fall through to static */ }
+    return STATIC_FALLBACK;
+}
+export function ModelSelector({ currentModelId, onSelect, onCancel, initialQuery = "", }) {
+    const [query, setQuery] = useState(initialQuery);
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const availableModels = useMemo(() => getAvailableModels(), []);
+    const filtered = useMemo(() => {
+        const q = query.toLowerCase().trim();
+        if (!q)
+            return availableModels;
+        return availableModels.filter(m => `${m.id} ${m.provider}`.toLowerCase().includes(q));
+    }, [query, availableModels]);
+    useEffect(() => {
+        setSelectedIndex((prev) => Math.min(prev, Math.max(0, filtered.length - 1)));
+    }, [filtered.length]);
+    useEffect(() => {
+        const idx = availableModels.findIndex(m => m.id === currentModelId);
+        if (idx >= 0)
+            setSelectedIndex(idx);
+    }, [currentModelId]);
+    const handleSubmit = useCallback(() => {
+        const selected = filtered[selectedIndex];
+        if (selected)
+            onSelect(selected.id);
+    }, [filtered, selectedIndex, onSelect]);
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return) {
+            handleSubmit();
+            return;
+        }
+        if (key.upArrow) {
+            setSelectedIndex(prev => (prev <= 0 ? filtered.length - 1 : prev - 1));
+            return;
+        }
+        if (key.downArrow) {
+            setSelectedIndex(prev => (prev >= filtered.length - 1 ? 0 : prev + 1));
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setQuery(prev => prev.slice(0, -1));
+            return;
+        }
+        if (!key.ctrl && !key.meta && input) {
+            setQuery(prev => prev + input);
+            return;
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Box, { borderStyle: "round", borderColor: ALBA_COLORS.accent, marginY: 1, paddingX: 1, children: _jsx(Text, { color: ALBA_COLORS.accent, bold: true, children: "Select Model" }) }), _jsxs(Box, { paddingX: 2, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: "  Search: " }), _jsx(TextInput, { value: query, onChange: setQuery, onSubmit: handleSubmit, placeholder: "type to filter..." })] }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: ALBA_COLORS.dim, children: "  Up/Down navigate \u00B7 Enter select \u00B7 Esc cancel" }) }), _jsx(Box, { flexDirection: "column", paddingX: 2, marginTop: 1, children: filtered.length === 0 ? (_jsxs(Text, { color: ALBA_COLORS.warn, children: ["  No models match \"", query, "\""] })) : (filtered.map((item, idx) => {
+                    const isSelected = idx === selectedIndex;
+                    const isCurrent = item.id === currentModelId;
+                    const checkMark = isCurrent ? T.success(" (current)") : "";
+                    return (_jsxs(Text, { color: isSelected ? ALBA_COLORS.accent : undefined, children: [_jsx(Text, { color: ALBA_COLORS.accent, children: isSelected ? ">" : " " }), " ", _jsx(Text, { color: isSelected ? ALBA_COLORS.accent : ALBA_COLORS.header, bold: isSelected, children: item.id }), _jsxs(Text, { color: ALBA_COLORS.muted, children: [" [", item.provider, "]"] }), checkMark] }, item.id));
+                })) })] }));
+}
+//# sourceMappingURL=ModelSelector.js.map

package/dist/tui/REPL.d.ts

@@ -0,0 +1,24 @@
+/**
+ * REPL — scrolling message history + bottom input box.
+ * Renders assistant text, tool calls, tool results, and user messages.
+ */
+import React from "react";
+export type MessageRole = "user" | "assistant" | "tool" | "system" | "notify";
+export interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    content: string;
+    toolName?: string;
+    isError?: boolean;
+    ts: number;
+}
+export interface REPLProps {
+    messages: ChatMessage[];
+    streamingText: string;
+    toolRunning: string | null;
+    onSubmit(input: string): void;
+    onAbort?(): void;
+    disabled: boolean;
+}
+export declare function REPL({ messages, streamingText, toolRunning, onSubmit, onAbort, disabled }: REPLProps): React.JSX.Element;
+//# sourceMappingURL=REPL.d.ts.map

package/dist/tui/REPL.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * REPL — scrolling message history + bottom input box.
+ * Renders assistant text, tool calls, tool results, and user messages.
+ */
+import { useState, useCallback } from "react";
+import { Box, Text, useStdout, useInput } from "ink";
+import TextInput from "ink-text-input";
+import { ALBA_COLORS } from "./theme.js";
+const MAX_VISIBLE = 40;
+function MessageLine({ msg }) {
+    const time = new Date(msg.ts).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+    if (msg.role === "user") {
+        return (_jsxs(Box, { flexDirection: "row", gap: 1, marginTop: 1, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: time }), _jsx(Text, { color: ALBA_COLORS.accent, bold: true, children: "you  " }), _jsx(Text, { wrap: "wrap", children: msg.content })] }));
+    }
+    if (msg.role === "assistant") {
+        return (_jsxs(Box, { flexDirection: "row", gap: 1, marginTop: 1, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: time }), _jsx(Text, { color: ALBA_COLORS.header, bold: true, children: "\uD83E\uDEBC   " }), _jsx(Text, { wrap: "wrap", children: msg.content })] }));
+    }
+    if (msg.role === "tool") {
+        const icon = msg.isError ? "✗" : "✓";
+        const col = msg.isError ? ALBA_COLORS.error : ALBA_COLORS.success;
+        const isLong = msg.content.length > 120;
+        return (_jsxs(Box, { flexDirection: "column", marginY: 0, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: time }), _jsxs(Text, { color: col, children: [icon, " ", msg.toolName ?? "tool"] }), isLong && _jsxs(Text, { color: ALBA_COLORS.dim, children: [" (", msg.content.length, " chars)"] })] }), !isLong && (_jsx(Box, { marginLeft: 6, children: _jsx(Text, { color: ALBA_COLORS.muted, wrap: "wrap", children: msg.content }) }))] }));
+    }
+    if (msg.role === "notify") {
+        return (_jsx(Box, { borderStyle: "round", borderColor: ALBA_COLORS.accent, marginY: 1, paddingX: 1, children: _jsx(Text, { wrap: "wrap", children: msg.content }) }));
+    }
+    // system messages — dimmed
+    return (_jsx(Box, { flexDirection: "row", gap: 1, children: _jsx(Text, { color: ALBA_COLORS.dim, wrap: "wrap", children: msg.content }) }));
+}
+export function REPL({ messages, streamingText, toolRunning, onSubmit, onAbort, disabled }) {
+    const [input, setInput] = useState("");
+    const { stdout } = useStdout();
+    const termWidth = stdout?.columns ?? 80;
+    const handleSubmit = useCallback((val) => {
+        const trimmed = val.trim();
+        if (!trimmed || disabled)
+            return;
+        setInput("");
+        onSubmit(trimmed);
+    }, [onSubmit, disabled]);
+    // #25: Escape key aborts in-flight stream
+    useInput((_input, key) => {
+        if (key.escape && disabled && onAbort) {
+            onAbort();
+        }
+    });
+    const visible = messages.slice(-MAX_VISIBLE);
+    return (_jsxs(Box, { flexDirection: "column", width: termWidth, children: [_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [visible.map(m => _jsx(MessageLine, { msg: m }, m.id)), streamingText && (_jsxs(Box, { flexDirection: "row", gap: 1, marginTop: 1, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: "   " }), _jsx(Text, { color: ALBA_COLORS.header, bold: true, children: "\uD83E\uDEBC   " }), _jsx(Text, { wrap: "wrap", children: streamingText })] })), toolRunning && (_jsx(Box, { flexDirection: "row", gap: 1, marginTop: 1, children: _jsxs(Text, { color: ALBA_COLORS.warn, children: ["\u2699  running ", toolRunning, "\u2026"] }) }))] }), _jsxs(Box, { borderStyle: "round", borderColor: disabled ? ALBA_COLORS.dim : ALBA_COLORS.accent, paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: ALBA_COLORS.accent, children: "\u203A " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: handleSubmit, placeholder: disabled ? "thinking…" : "message or /command" })] })] }));
+}
+//# sourceMappingURL=REPL.js.map

package/dist/tui/StatusBar.d.ts

@@ -0,0 +1,14 @@
+/**
+ * StatusBar — single line at the top of the TUI showing live agent state.
+ */
+import React from "react";
+export interface StatusBarProps {
+    model: string;
+    chain: string;
+    effectLevel: string;
+    toolRunning: string | null;
+    connected: boolean;
+    statusLine?: string | null;
+}
+export declare function StatusBar({ model, chain, effectLevel, toolRunning, connected, statusLine, }: StatusBarProps): React.JSX.Element;
+//# sourceMappingURL=StatusBar.d.ts.map

package/dist/tui/StatusBar.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { ALBA_COLORS } from "./theme.js";
+export function StatusBar({ model, chain, effectLevel, toolRunning, connected, statusLine, }) {
+    const chainShort = chain.slice(0, 8);
+    const modelShort = model.split("/").pop()?.slice(0, 18) ?? model.slice(0, 18);
+    const effectIcon = { eco: "🌿", normal: "⚡", turbo: "🚀", max: "🌊" }[effectLevel] ?? "⚡";
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Text, { color: ALBA_COLORS.dim, children: "".padEnd(80, "─") }), _jsxs(Box, { paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: ALBA_COLORS.accent, bold: true, children: "ALBA" }), _jsx(Text, { color: ALBA_COLORS.muted, children: modelShort })] }), _jsx(Box, { children: toolRunning
+                            ? _jsxs(Text, { color: ALBA_COLORS.warn, children: ["\u2699 ", toolRunning] })
+                            : statusLine
+                                ? _jsx(Text, { color: ALBA_COLORS.muted, children: statusLine.slice(0, 80) })
+                                : _jsx(Text, { color: ALBA_COLORS.muted, children: connected ? "ready" : "connecting…" }) }), _jsxs(Box, { gap: 2, children: [_jsx(Text, { color: ALBA_COLORS.muted, children: chainShort }), _jsxs(Text, { color: ALBA_COLORS.header, children: [effectIcon, " ", effectLevel] })] })] })] }));
+}
+//# sourceMappingURL=StatusBar.js.map

package/dist/tui/theme.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ALBA colour theme — maps semantic names to chalk/ANSI colours.
+ * Exported as a ThemeContext-compatible object so it can be passed into
+ * extension command handlers via ctx.ui.theme.
+ */
+import type { ThemeContext } from "../api/ExtensionAPI.js";
+export declare const ALBA_COLORS: {
+    readonly accent: "#00e5ff";
+    readonly success: "#69ff94";
+    readonly error: "#ff5370";
+    readonly warn: "#ffcb6b";
+    readonly muted: "#546e7a";
+    readonly header: "#c792ea";
+    readonly dim: "#37474f";
+};
+export type AlbaColor = keyof typeof ALBA_COLORS;
+export declare function makeTheme(): ThemeContext;
+/** Convenience — themed prefix for agent output lines */
+export declare const theme: ThemeContext;
+export declare const T: {
+    accent: (s: string) => string;
+    success: (s: string) => string;
+    error: (s: string) => string;
+    warn: (s: string) => string;
+    muted: (s: string) => string;
+    header: (s: string) => string;
+    dim: (s: string) => string;
+    bold: (s: string) => string;
+};
+//# sourceMappingURL=theme.d.ts.map

package/dist/tui/theme.js

@@ -0,0 +1,41 @@
+/**
+ * ALBA colour theme — maps semantic names to chalk/ANSI colours.
+ * Exported as a ThemeContext-compatible object so it can be passed into
+ * extension command handlers via ctx.ui.theme.
+ */
+import chalk from "chalk";
+export const ALBA_COLORS = {
+    accent: "#00e5ff", // cyan-aqua — alba signature
+    success: "#69ff94", // soft green
+    error: "#ff5370", // coral red
+    warn: "#ffcb6b", // amber
+    muted: "#546e7a", // slate grey
+    header: "#c792ea", // soft purple
+    dim: "#37474f", // dark slate
+};
+export function makeTheme() {
+    return {
+        fg(color, text) {
+            const hex = ALBA_COLORS[color] ?? color;
+            try {
+                return chalk.hex(hex)(text);
+            }
+            catch {
+                return text;
+            }
+        },
+    };
+}
+/** Convenience — themed prefix for agent output lines */
+export const theme = makeTheme();
+export const T = {
+    accent: (s) => chalk.hex(ALBA_COLORS.accent)(s),
+    success: (s) => chalk.hex(ALBA_COLORS.success)(s),
+    error: (s) => chalk.hex(ALBA_COLORS.error)(s),
+    warn: (s) => chalk.hex(ALBA_COLORS.warn)(s),
+    muted: (s) => chalk.hex(ALBA_COLORS.muted)(s),
+    header: (s) => chalk.hex(ALBA_COLORS.header)(s),
+    dim: (s) => chalk.hex(ALBA_COLORS.dim)(s),
+    bold: (s) => chalk.bold(s),
+};
+//# sourceMappingURL=theme.js.map

package/dist/util/safeLog.d.ts

@@ -0,0 +1,3 @@
+export declare function wireNotify(fn: (msg: string) => void): void;
+export declare function safeLog(...args: unknown[]): void;
+//# sourceMappingURL=safeLog.d.ts.map

package/dist/util/safeLog.js

@@ -0,0 +1,21 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const ALBA_HOME = process.env.ALBA_HOME ?? join(homedir(), ".alba");
+const DEBUG_LOG = join(ALBA_HOME, "debug.log");
+let _notifyFn = null;
+export function wireNotify(fn) { _notifyFn = fn; }
+export function safeLog(...args) {
+    const msg = args.map(a => (typeof a === "string" ? a : String(a))).join(" ");
+    if (_notifyFn) {
+        _notifyFn(msg);
+    }
+    else {
+        try {
+            mkdirSync(ALBA_HOME, { recursive: true });
+            appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] ${msg}\n`);
+        }
+        catch { /* non-fatal */ }
+    }
+}
+//# sourceMappingURL=safeLog.js.map

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@albalink/agent",
+  "version": "1.0.0",
+  "description": "ALBA — standalone AI agent engine. Runs locally, extensible, zero cloud dependency.",
+  "author": "ALBA",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "albacli": "bin/albacli",
+    "alba-mcp": "bin/alba-mcp",
+    "albalink": "bin/albacli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0",
+    "chalk": "^5.3.0",
+    "dotenv": "^16.4.5",
+    "ink": "^5.0.1",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.3.1",
+    "tsx": "^4.15.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.41",
+    "@types/react": "^18.3.29",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "local",
+    "assistant",
+    "terminal",
+    "cli",
+    "alba",
+    "swarm",
+    "extensible"
+  ],
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "!dist/**/*.map",
+    "!dist/**/*.test.*"
+  ]
+}