miii-cli 0.1.0

package/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git -C /Users/akshay/Desktop/essentials/akshay-workspace/miii-cli status)",
+      "Bash(npm install *)",
+      "Bash(npx tsc *)",
+      "Bash(node --input-type=module)",
+      "Bash(chmod +x dist/index.js)",
+      "Bash(node dist/index.js --help)",
+      "Bash(node dist/index.js)",
+      "Bash(chmod +x install.sh)",
+      "Bash(npm whoami *)",
+      "Bash(npm run *)",
+      "Bash(npm publish *)",
+      "Bash(npm pkg *)"
+    ]
+  }
+}

package/Makefile

@@ -0,0 +1,13 @@
+.PHONY: dev build install clean
+
+dev:
+	tsx src/index.ts
+
+build:
+	tsc
+
+install: build
+	npm link
+
+clean:
+	rm -rf dist

package/README.md

@@ -0,0 +1,182 @@
+# miii
+
+```
+╭─ MIII - CLI ───────────────────────────────────────────╮
+│  Claude Code-level terminal workflows, local models.   │
+╰────────────────────────────────────────────────────────╯
+```
+
+A fast, local AI coding assistant that runs entirely on your machine.
+No cloud. No API keys. Just you, your terminal, and whatever model you pull.
+
+---
+
+## Install
+
+```bash
+npm install -g miii-cli
+```
+
+Or run from source:
+
+```bash
+git clone https://github.com/maruakshay/miii-cli
+cd miii-cli
+npm install
+npm run build
+npm link
+```
+
+---
+
+## Quick start
+
+```bash
+miii                        # start with default session
+miii --model codellama      # use a specific model
+miii --session myproject    # start in a named session
+miii -s work -m llama3.2    # short flags
+```
+
+On startup, miii opens the model picker — pick a model and start coding.
+
+---
+
+## Commands
+
+Type `/` to open the command palette and browse everything.
+
+| Command | What it does |
+|---|---|
+| `/models` | Open model picker — switch or pull Ollama models |
+| `/clear` | Clear current session's chat history |
+| `/sessions` | List all saved sessions |
+| `/session <name>` | Switch to (or create) a named session |
+| `/list` | List all loaded skills |
+| `/exit` | Exit miii |
+
+Skills loaded from `~/.config/miii/skills/` appear in the palette too.
+
+---
+
+## File context with `@`
+
+Type `@` anywhere in your message to fuzzy-find project files and inject their content into the LLM context.
+
+```
+❯ review the auth logic in @src/auth/middleware.ts
+```
+
+The file content is injected automatically — the model sees the full source.
+
+Filtered automatically: `node_modules`, `dist`, `.git`, lock files, binaries, images.
+
+---
+
+## Sessions
+
+Every conversation is saved. Sessions persist between launches.
+
+```bash
+miii                          # continues "default" session
+miii --session feature-auth   # continues or creates "feature-auth"
+```
+
+Mid-conversation:
+
+```
+/session feature-auth    switch sessions
+/sessions                see all sessions with message counts
+/clear                   wipe current session history
+```
+
+Sessions stored at `~/.config/miii/sessions/`.
+
+---
+
+## Tools
+
+miii has built-in file and shell tools the model can use automatically:
+
+| Tool | What it does |
+|---|---|
+| `read_file` | Read any file |
+| `list_files` | List directory contents |
+| `edit_file` | Create or overwrite a file |
+| `delete_file` | Delete a file |
+| `run_command` | Run a shell command in cwd |
+
+The model calls these via `<tool_call>` tags, miii executes them and feeds results back automatically — up to 6 hops deep.
+
+---
+
+## Skills
+
+Skills are custom commands you can invoke with `/`.
+
+Create `~/.config/miii/skills/review.md`:
+
+```markdown
+---
+name: review
+description: review current changes for bugs and improvements
+---
+
+Review the code I'm about to share. Look for bugs, edge cases, and improvements.
+Be direct and specific. No markdown.
+```
+
+Then use it:
+
+```
+/review
+```
+
+Skills can also be TypeScript files with an `execute` function for programmatic behavior.
+
+---
+
+## Configuration
+
+miii looks for config in:
+1. `.miii.json` in the current directory
+2. `~/.config/miii/config.json`
+
+```json
+{
+  "model": "llama3.2",
+  "provider": "ollama",
+  "baseUrl": "http://localhost:11434"
+}
+```
+
+For OpenAI-compatible APIs:
+
+```json
+{
+  "model": "gpt-4o",
+  "provider": "openai",
+  "baseUrl": "https://api.openai.com/v1"
+}
+```
+
+Works with any OpenAI-compatible server: LM Studio, vLLM, Groq, Together, etc.
+
+---
+
+## Requirements
+
+- Node.js 18+
+- [Ollama](https://ollama.com) (or any OpenAI-compatible API)
+
+---
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `enter` | Send message |
+| `ctrl+c` | Abort streaming |
+| `ctrl+c` x2 | Exit |
+| `esc` | Close overlay / abort |
+| `↑ ↓` | Navigate command palette or file picker |

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function loadConfig(): Config;

package/dist/config.js

@@ -0,0 +1,24 @@
+import { readFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const defaults = {
+    model: 'llama3.2',
+    provider: 'ollama',
+    baseUrl: 'http://localhost:11434',
+};
+export function loadConfig() {
+    const candidates = [
+        join(process.cwd(), '.miii.json'),
+        join(homedir(), '.config', 'miii', 'config.json'),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            try {
+                return { ...defaults, ...JSON.parse(readFileSync(p, 'utf-8')) };
+            }
+            catch { }
+        }
+    }
+    return { ...defaults };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,MAAM,QAAQ,GAAW;IACvB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,wBAAwB;CAClC,CAAA;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC;QACjC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC;KAClD,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;YACjE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAA;AACxB,CAAC"}

package/dist/files/ops.d.ts

@@ -0,0 +1,11 @@
+export declare function readFile(p: string): string;
+export declare function writeFile(p: string, content: string): void;
+export declare function deleteFile(p: string): void;
+export interface FileEntry {
+    name: string;
+    path: string;
+    rel: string;
+    type: 'file' | 'dir';
+    size?: number;
+}
+export declare function listFiles(dir: string, recursive?: boolean, cwd?: string): FileEntry[];

package/dist/files/ops.js

@@ -0,0 +1,66 @@
+import { readFileSync, writeFileSync, unlinkSync, mkdirSync, readdirSync, statSync, existsSync, } from 'fs';
+import { join, dirname, relative, extname } from 'path';
+const SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'build', '.git', '.next', '.nuxt', '.svelte-kit',
+    'out', '__pycache__', '.cache', 'coverage', '.nyc_output', 'vendor',
+    'target', '.turbo', '.vercel', 'generated', '.gradle', '.expo',
+    'bin', 'obj', '.idea', '.vscode', 'tmp', 'temp', 'logs',
+]);
+const SKIP_EXTS = new Set([
+    '.map', '.lock',
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico', '.bmp', '.tiff',
+    '.mp4', '.mp3', '.wav', '.ogg', '.pdf',
+    '.zip', '.tar', '.gz', '.rar', '.7z',
+    '.exe', '.dll', '.so', '.dylib', '.wasm', '.class', '.pyc',
+    '.ttf', '.woff', '.woff2', '.eot',
+]);
+const SKIP_NAMES = new Set([
+    'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', 'Cargo.lock',
+    'poetry.lock', 'Gemfile.lock', 'composer.lock',
+    '.DS_Store', 'Thumbs.db', '.env.local', 'LICENSE', 'LICENSE.md',
+]);
+export function readFile(p) {
+    if (!existsSync(p))
+        return '';
+    return readFileSync(p, 'utf-8');
+}
+export function writeFile(p, content) {
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, content, 'utf-8');
+}
+export function deleteFile(p) {
+    unlinkSync(p);
+}
+export function listFiles(dir, recursive = false, cwd = process.cwd()) {
+    if (!existsSync(dir))
+        return [];
+    const entries = [];
+    for (const name of readdirSync(dir)) {
+        if (name.startsWith('.'))
+            continue;
+        if (SKIP_NAMES.has(name))
+            continue;
+        if (SKIP_DIRS.has(name))
+            continue;
+        const ext = extname(name);
+        if (SKIP_EXTS.has(ext))
+            continue;
+        if (name.endsWith('.d.ts') || name.endsWith('.js.map'))
+            continue;
+        let stat;
+        try {
+            stat = statSync(join(dir, name));
+        }
+        catch {
+            continue;
+        }
+        const full = join(dir, name);
+        const type = stat.isDirectory() ? 'dir' : 'file';
+        entries.push({ name, path: full, rel: relative(cwd, full), type, size: stat.isFile() ? stat.size : undefined });
+        if (recursive && type === 'dir') {
+            entries.push(...listFiles(full, true, cwd));
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=ops.js.map

package/dist/files/ops.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+declare function main(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+"use strict";
+// Minimal entry — heavy imports lazy-loaded
+async function main() {
+    const { lazyInit } = await import('./init.js');
+    await lazyInit();
+}
+main().catch(err => {
+    process.stderr.write(`fatal: ${err.message}\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":";;AACA,4CAA4C;AAC5C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,QAAQ,EAAE,CAAA;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,IAAI,CAAC,CAAA;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function lazyInit(): Promise<void>;

package/dist/init.js

@@ -0,0 +1,32 @@
+import { render } from 'ink';
+import React from 'react';
+import minimist from 'minimist';
+import { loadConfig } from './config.js';
+import { SkillLoader } from './skills/loader.js';
+import { InputBar } from './tui/InputBar.js';
+import { welcome } from './tui/printer.js';
+export async function lazyInit() {
+    const argv = minimist(process.argv.slice(2), {
+        string: ['model', 'url', 'provider', 'session'],
+        alias: { m: 'model', u: 'url', p: 'provider', s: 'session' },
+    });
+    const config = loadConfig();
+    if (argv.model)
+        config.model = argv.model;
+    if (argv.url)
+        config.baseUrl = argv.url;
+    if (argv.provider)
+        config.provider = argv.provider;
+    const skills = new SkillLoader();
+    await skills.loadAll();
+    // Print welcome banner to scrollback BEFORE Ink starts
+    welcome(config.provider, config.model, process.cwd());
+    // Move cursor to last terminal row so Ink renders at absolute bottom
+    process.stdout.write(`\x1b[${process.stdout.rows ?? 24};1H`);
+    // Ink renders ONLY the input bar (small footprint at bottom)
+    // patchConsole: true (default) ensures console.log output appears above Ink
+    const sessionName = argv.session || 'default';
+    const { waitUntilExit } = render(React.createElement(InputBar, { config, skills, cwd: process.cwd(), session: sessionName }), { exitOnCtrlC: false });
+    await waitUntilExit();
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;QAC/C,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE;KAC7D,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACzC,IAAI,IAAI,CAAC,GAAG;QAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAA;IACvC,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAkC,CAAA;IAE5E,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAA;IAChC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IAEtB,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAErD,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAA;IAE5D,6DAA6D;IAC7D,4EAA4E;IAC5E,MAAM,WAAW,GAAI,IAAI,CAAC,OAAkB,IAAI,SAAS,CAAA;IAEzD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAC9B,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAC3F,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAA;IAED,MAAM,aAAa,EAAE,CAAA;AACvB,CAAC"}

package/dist/llm/ollama.d.ts

@@ -0,0 +1,9 @@
+export interface OllamaModel {
+    name: string;
+    size: number;
+    modified_at: string;
+    digest?: string;
+}
+export declare function listModels(baseUrl: string): Promise<OllamaModel[]>;
+export declare function pullModel(baseUrl: string, name: string, onProgress: (status: string, pct: number | undefined) => void, signal?: AbortSignal): Promise<void>;
+export declare function fmtSize(bytes: number): string;

package/dist/llm/ollama.js

@@ -0,0 +1,51 @@
+export async function listModels(baseUrl) {
+    const res = await fetch(`${baseUrl}/api/tags`);
+    if (!res.ok)
+        throw new Error(`Ollama ${res.status}: ${await res.text()}`);
+    const data = (await res.json());
+    return data.models ?? [];
+}
+export async function pullModel(baseUrl, name, onProgress, signal) {
+    const res = await fetch(`${baseUrl}/api/pull`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name, stream: true }),
+        signal,
+    });
+    if (!res.ok)
+        throw new Error(`pull failed: ${res.status} ${await res.text()}`);
+    const reader = res.body.getReader();
+    const dec = new TextDecoder();
+    let buf = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            const lines = buf.split('\n');
+            buf = lines.pop() ?? '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const obj = JSON.parse(line);
+                    const pct = obj.total ? Math.round(((obj.completed ?? 0) / obj.total) * 100) : undefined;
+                    onProgress(obj.status ?? '', pct);
+                }
+                catch { }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export function fmtSize(bytes) {
+    if (bytes >= 1e9)
+        return `${(bytes / 1e9).toFixed(1)}GB`;
+    if (bytes >= 1e6)
+        return `${(bytes / 1e6).toFixed(0)}MB`;
+    return `${(bytes / 1e3).toFixed(0)}KB`;
+}
+//# sourceMappingURL=ollama.js.map

package/dist/llm/ollama.js.map

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

package/dist/llm/stream.d.ts

@@ -0,0 +1,12 @@
+import type { ChatMessage } from '../types.js';
+export interface StreamConfig {
+    provider: 'ollama' | 'openai-compat';
+    model: string;
+    baseUrl: string;
+    messages: ChatMessage[];
+    signal?: AbortSignal;
+    onToken: (token: string) => void;
+    onDone: (fullText: string) => void | Promise<void>;
+    onError: (err: Error) => void;
+}
+export declare function stream(cfg: StreamConfig): Promise<void>;

package/dist/llm/stream.js

@@ -0,0 +1,129 @@
+export async function stream(cfg) {
+    if (cfg.provider === 'openai-compat') {
+        return streamOpenAI(cfg);
+    }
+    return streamOllama(cfg);
+}
+async function streamOllama(cfg) {
+    const { model, messages, baseUrl, signal, onToken, onDone, onError } = cfg;
+    let res;
+    try {
+        res = await fetch(`${baseUrl}/api/chat`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ model, messages, stream: true }),
+            signal,
+        });
+    }
+    catch (err) {
+        onError(toError(err));
+        return;
+    }
+    if (!res.ok) {
+        onError(new Error(`Ollama ${res.status}: ${await res.text()}`));
+        return;
+    }
+    const reader = res.body.getReader();
+    const dec = new TextDecoder();
+    let full = '';
+    let buf = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            const lines = buf.split('\n');
+            buf = lines.pop() ?? '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const obj = JSON.parse(line);
+                    const tok = obj?.message?.content ?? '';
+                    if (tok) {
+                        onToken(tok);
+                        full += tok;
+                    }
+                    if (obj?.done) {
+                        await onDone(full);
+                        return;
+                    }
+                }
+                catch { }
+            }
+        }
+        await onDone(full);
+    }
+    catch (err) {
+        if (err?.name !== 'AbortError')
+            onError(toError(err));
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+async function streamOpenAI(cfg) {
+    const { model, messages, baseUrl, signal, onToken, onDone, onError } = cfg;
+    let res;
+    try {
+        res = await fetch(`${baseUrl}/v1/chat/completions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Authorization: 'Bearer local' },
+            body: JSON.stringify({ model, messages, stream: true }),
+            signal,
+        });
+    }
+    catch (err) {
+        onError(toError(err));
+        return;
+    }
+    if (!res.ok) {
+        onError(new Error(`LLM ${res.status}: ${await res.text()}`));
+        return;
+    }
+    const reader = res.body.getReader();
+    const dec = new TextDecoder();
+    let full = '';
+    let buf = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            const lines = buf.split('\n');
+            buf = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.replace(/^data:\s*/, '').trim();
+                if (!trimmed || trimmed === '[DONE]')
+                    continue;
+                try {
+                    const obj = JSON.parse(trimmed);
+                    const tok = obj?.choices?.[0]?.delta?.content ?? '';
+                    if (tok) {
+                        onToken(tok);
+                        full += tok;
+                    }
+                    if (obj?.choices?.[0]?.finish_reason) {
+                        await onDone(full);
+                        return;
+                    }
+                }
+                catch { }
+            }
+        }
+        await onDone(full);
+    }
+    catch (err) {
+        if (err?.name !== 'AbortError')
+            onError(toError(err));
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function toError(e) {
+    return e instanceof Error ? e : new Error(String(e));
+}
+//# sourceMappingURL=stream.js.map

package/dist/llm/stream.js.map

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

package/dist/parser/stream-parser.d.ts

@@ -0,0 +1,17 @@
+export interface ParsedText {
+    type: 'text';
+    content: string;
+}
+export interface ParsedTool {
+    type: 'tool_call';
+    content: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+export type ParsedItem = ParsedText | ParsedTool;
+export declare class StreamParser {
+    private buf;
+    private inTool;
+    feed(token: string): ParsedItem[];
+    flush(): ParsedItem[];
+}