agent-termo 1.0.0 → 1.0.2

package/README.md

@@ -39,17 +39,11 @@ npm run dev
 
 ## Configuration
 
-1. Copy `.env.example` to `.env`:
-   ```bash
-   cp .env.example .env
-   ```
+On the first launch, Agent-Termo prompts you to enter your NVIDIA NIM API key. The input is hidden, and the key is saved in your user configuration at `~/.agent-termo/config.json` so you are not prompted again.
 
-2. Add your Nvidia NIM API key to `.env`:
-   ```
-   NIM_API_KEY=your_api_key_here
-   ```
+Get a free API key from [https://build.nvidia.com/](https://build.nvidia.com/).
 
-3. Get your free API key from [https://build.nvidia.com/](https://build.nvidia.com/)
+You can also provide `NIM_API_KEY` through your shell environment or a project `.env` file. Existing environment variables take precedence over the saved key.
 
 ## Usage
 
@@ -59,6 +53,31 @@ npm run dev
 agent-termo
 ```
 
+### The terminal UI
+
+Like Claude Code, the input box stays pinned to the bottom of the terminal while the conversation scrolls above it. The status line under the box shows the active model and project.
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Send |
+| `↑` / `↓` | Input history |
+| `Tab` | Complete a `/command` (matching commands show on the status line as you type) |
+| `←` `→`, `Ctrl+A` / `Ctrl+E`, `Ctrl+←` / `Ctrl+→` | Move by character, to line start/end, by word |
+| `Ctrl+W` / `Ctrl+U` / `Ctrl+K` | Delete word / to line start / to line end |
+| `Ctrl+C` | Clear the line; quit when the line is empty |
+
+Pasted text is kept on one line (newlines become spaces). Terminals smaller than 12 rows × 40 columns, and non-interactive input, fall back to a plain `>` prompt.
+
+### Choosing a model
+
+Agent-Termo works with any chat model on NVIDIA NIM.
+
+- `/model` opens a picker with the models your API key can use (fetched live from NIM; embedding and reranking models are hidden). Use `↑`/`↓`, type to filter, `Enter` to select, `Esc` to cancel. Type an `org/name` ID that isn't listed to use it as typed.
+- `/model <model-id>` switches directly, e.g. `/model meta/llama-3.3-70b-instruct`.
+- `agent-termo --model <model-id>` picks the model for one run.
+
+Your selection is saved in `~/.agent-termo/config.json` and used next time. Order of precedence: `--model` flag, then the saved `/model` choice, then `NIM_MODEL` from `.env`, then the built-in default. If the live list can't be fetched, a built-in list of suggestions is shown instead.
+
 ### Tell it what to build
 
 ```
@@ -79,9 +98,9 @@ agent-termo/
 ├── src/
 │   ├── cli.ts           # Commander entry point
 │   ├── main.ts          # Main application
-│   ├── ui/              # Terminal UI (blessed)
+│   ├── ui/              # Terminal UI (output rendering, pinned input box, model picker)
 │   ├── agents/          # 12 agent implementations
-│   ├── llm/             # OpenAI/NIM integration
+│   ├── llm/             # OpenAI/NIM integration, model catalogue
 │   ├── tools/           # File, bash, git tools
 │   └── memory/          # Memory system
 ├── .claude/agents/      # Agent prompts

package/dist/agents/index.d.ts

@@ -0,0 +1,5 @@
+import type { Agent } from '../types/index.js';
+export declare function loadAgentPrompt(agentName: string, agentDir: string): string | null;
+export declare function loadAllAgents(agentDir: string): Agent[];
+export declare function buildSystemPrompt(memory: string, timeline: string, _agentDir: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY/C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlF;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAevD;AAqCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY7F"}

package/dist/agents/index.js

@@ -0,0 +1,86 @@
+// =============================================================================
+// Agent Loader + System Prompt Builder
+// =============================================================================
+import { readdirSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+function parseAgentMeta(content) {
+    const descMatch = content.match(/^description:\s*(.+)$/m);
+    const toolsMatch = content.match(/^tools:\s*\[(.+)\]/m);
+    const toolsStr = toolsMatch?.[1] ?? '';
+    const tools = toolsStr
+        ? toolsStr.split(',').map((t) => t.trim().replace(/^["']|["']$/g, ''))
+        : ['file:read', 'file:write', 'file:edit', 'file:glob', 'grep', 'bash:execute', 'git:status', 'git:commit', 'git:push', 'git:log'];
+    return { description: descMatch?.[1]?.trim() ?? '', tools };
+}
+export function loadAgentPrompt(agentName, agentDir) {
+    const candidate = resolve(agentDir, 'agents', agentName + '.md');
+    try {
+        const content = readFileSync(candidate, 'utf-8');
+        const withoutFrontmatter = content.replace(/^---[\s\S]+?---\n/, '');
+        return withoutFrontmatter.trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function loadAllAgents(agentDir) {
+    const agentsDir = resolve(agentDir, 'agents');
+    try {
+        const files = readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+        const agents = files.map((file) => {
+            const agentId = file.replace(/\.md$/, '');
+            const content = readFileSync(resolve(agentsDir, file), 'utf-8');
+            const meta = parseAgentMeta(content);
+            const withoutFrontmatter = content.replace(/^---[\s\S]+?---\n/, '').trim();
+            return { name: agentId, description: meta.description, systemPrompt: withoutFrontmatter, tools: meta.tools };
+        });
+        return agents.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    catch {
+        return [];
+    }
+}
+// =============================================================================
+// Agent System Prompt Builder
+// =============================================================================
+const SYSTEM_BASE = `You are Agent-Termo, a helpful AI assistant in a terminal.
+
+RESPONSE RULES (follow these strictly):
+- Be concise and direct. 1-3 sentences for simple questions.
+- Never output verbose chain-of-thought or reasoning — just the answer.
+- For coding tasks: briefly explain what you did, show key code.
+- Never write "null" or placeholders in your response.
+- When using function calls, respond with the function only — no preamble.
+
+CONVERSATION MODE (default):
+Just chat. Say things like "I'm doing well!" or "2+2 is 4." — no tools needed.
+
+TOOL MODE (when asked to code/build/fix files):
+Use these functions (JSON tool_calls format):
+{"tool_calls":[{"id":"call_1","name":"function_name","arguments":{"key":"value"}}]}
+
+Available functions:
+- file:read(path) → read a file
+- file:write(path, content) → overwrite a file completely
+- file:edit(path, old_string, new_string) → edit a specific line section
+- file:glob(pattern) → list files matching a glob (e.g. "src/**/*.ts")
+- grep(pattern, path, glob?) → search for text in files
+- bash:execute(command) → run a shell command
+- git:status() / git:commit(message) / git:push() → version control
+
+When done, say "Done: <brief summary>."
+
+AVAILABLE FILES:
+- docs/MEMORY.md — project context
+- docs/TIMELINE.md — recent activity log`;
+export function buildSystemPrompt(memory, timeline, _agentDir) {
+    let prompt = SYSTEM_BASE;
+    if (memory) {
+        prompt += '\n\n## Project Memory\n' + memory;
+    }
+    if (timeline) {
+        prompt += '\n\n## Recent Timeline (last entries)\n' + timeline.slice(-1500);
+    }
+    return prompt;
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACrI,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,QAAgB;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACpE,OAAO,kBAAkB,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,MAAM,MAAM,GAAY,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/G,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCA6BqB,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB,EAAE,SAAiB;IACnF,IAAI,MAAM,GAAG,WAAW,CAAC;IAEzB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,yBAAyB,GAAG,MAAM,CAAC;IAC/C,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,yCAAyC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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":""}