@agntk/cli 0.1.0

package/dist/environment.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Public API for @agntk/cli.
+ * Re-exports key types and utilities for programmatic CLI usage.
+ */
+export { getVersion } from './version.js';
+export { parseArgs } from './args.js';
+export type { ParsedArgs } from './args.js';
+export { resolveConfig, detectApiKey, loadConfigFile } from './config.js';
+export type { ResolvedCLIConfig } from './config.js';
+export { detectEnvironment, formatEnvironmentPrompt } from './environment.js';
+export type { EnvironmentContext } from './environment.js';
+export { runOneShot, readStdin } from './runner.js';
+export type { RunResult, RunOptions } from './runner.js';
+export { runRepl } from './repl.js';
+export type { ReplOptions, ReplResult } from './repl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Public API for @agntk/cli.
+ * Re-exports key types and utilities for programmatic CLI usage.
+ */
+export { getVersion } from './version.js';
+export { parseArgs } from './args.js';
+export { resolveConfig, detectApiKey, loadConfigFile } from './config.js';
+export { detectEnvironment, formatEnvironmentPrompt } from './environment.js';
+export { runOneShot, readStdin } from './runner.js';
+export { runRepl } from './repl.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Initializes .agntk/ directory with template memory files.
+ *
+ * Usage: npx agntk --init
+ */
+/**
+ * Create .agntk/ directory with template files.
+ * Skips files that already exist.
+ */
+export declare function initMemoryDirectory(workspace: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoDH;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B1E"}

package/dist/init.js

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Initializes .agntk/ directory with template memory files.
+ *
+ * Usage: npx agntk --init
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const DIR_NAME = '.agntk';
+const TEMPLATES = {
+    'project.md': `# Project Context
+
+<!-- Describe your project here. This file is always loaded into the agent's context. -->
+
+## Overview
+
+<!-- What does this project do? -->
+
+## Tech Stack
+
+<!-- Languages, frameworks, key dependencies -->
+
+## Conventions
+
+<!-- Coding style, naming conventions, patterns to follow -->
+`,
+    'memory.md': `# Memory
+
+<!-- Agent-curated facts. The agent updates this file automatically when you use "remember". -->
+
+## World Facts
+
+## Decisions
+
+## Entity Knowledge
+
+## Preferences & Patterns
+`,
+    'context.md': `# Current Context
+
+<!-- The agent rewrites this file each session to summarize the current working state. -->
+
+No context yet. Start a session with \`agntk --memory\` to populate this file.
+`,
+    'decisions.md': `# Decision Log
+
+<!-- Append-only log of key decisions. The agent adds entries automatically. -->
+`,
+};
+/**
+ * Create .agntk/ directory with template files.
+ * Skips files that already exist.
+ */
+export async function initMemoryDirectory(workspace) {
+    const dir = resolve(workspace, DIR_NAME);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+        console.log(`Created ${DIR_NAME}/`);
+    }
+    else {
+        console.log(`${DIR_NAME}/ already exists`);
+    }
+    let created = 0;
+    let skipped = 0;
+    for (const [filename, content] of Object.entries(TEMPLATES)) {
+        const filePath = join(dir, filename);
+        if (existsSync(filePath)) {
+            skipped++;
+        }
+        else {
+            await writeFile(filePath, content, 'utf-8');
+            created++;
+            console.log(`  Created ${DIR_NAME}/${filename}`);
+        }
+    }
+    if (skipped > 0) {
+        console.log(`  Skipped ${skipped} existing file(s)`);
+    }
+    console.log(`\nDone! Run \`agntk --memory "your prompt"\` to use persistent memory.`);
+}
+//# 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;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,MAAM,SAAS,GAA2B;IACxC,YAAY,EAAE;;;;;;;;;;;;;;;CAef;IAEC,WAAW,EAAE;;;;;;;;;;;CAWd;IAEC,YAAY,EAAE;;;;;CAKf;IAEC,cAAc,EAAE;;;CAGjB;CACA,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,GAAG,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;AACxF,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Interactive REPL mode for agntk.
+ * Provides a readline-based conversational loop with the agent.
+ *
+ * Usage: npx agntk -i [--memory] [--role coder]
+ */
+import type { ResolvedCLIConfig } from './config.js';
+import type { EnvironmentContext } from './environment.js';
+export interface ReplOptions {
+    /** Resolved CLI config */
+    config: ResolvedCLIConfig;
+    /** Environment context */
+    environment: EnvironmentContext;
+    /** Input stream (for testing). Default: process.stdin */
+    input?: NodeJS.ReadableStream;
+    /** Output stream (for testing). Default: process.stdout */
+    output?: NodeJS.WritableStream;
+}
+export interface ReplResult {
+    /** Total number of exchanges in the session */
+    exchanges: number;
+    /** Whether the session ended normally */
+    success: boolean;
+    /** Error if session crashed */
+    error?: string;
+}
+/**
+ * Run the interactive REPL.
+ */
+export declare function runRepl(options: ReplOptions): Promise<ReplResult>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAQ3D,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,0BAA0B;IAC1B,WAAW,EAAE,kBAAkB,CAAC;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4DD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqLvE"}

package/dist/repl.js

@@ -0,0 +1,213 @@
+/**
+ * @fileoverview Interactive REPL mode for agntk.
+ * Provides a readline-based conversational loop with the agent.
+ *
+ * Usage: npx agntk -i [--memory] [--role coder]
+ */
+import { createInterface } from 'node:readline';
+import { createAgent } from '@agntk/core';
+import { formatEnvironmentPrompt } from './environment.js';
+import { getVersion } from './version.js';
+// ============================================================================
+// REPL Commands
+// ============================================================================
+const REPL_COMMANDS = {
+    '/help': {
+        description: 'Show available commands',
+        handler: (ctx) => {
+            ctx.output.write('\nAvailable commands:\n');
+            for (const [cmd, { description }] of Object.entries(REPL_COMMANDS)) {
+                ctx.output.write(`  ${cmd.padEnd(12)} ${description}\n`);
+            }
+            ctx.output.write('\n');
+        },
+    },
+    '/clear': {
+        description: 'Clear conversation history',
+        handler: (ctx) => {
+            ctx.history = [];
+            ctx.output.write('Conversation cleared.\n');
+        },
+    },
+    '/role': {
+        description: 'Show current agent role',
+        handler: (ctx) => {
+            ctx.output.write(`Current role: ${ctx.config.role}\n`);
+        },
+    },
+    '/env': {
+        description: 'Show detected environment',
+        handler: (ctx) => {
+            ctx.output.write(formatEnvironmentPrompt(ctx.environment) + '\n');
+        },
+    },
+    '/exit': {
+        description: 'Exit the REPL',
+        handler: (ctx) => {
+            ctx.shouldExit = true;
+        },
+    },
+};
+// ============================================================================
+// Interactive REPL
+// ============================================================================
+/**
+ * Run the interactive REPL.
+ */
+export async function runRepl(options) {
+    const { config, environment } = options;
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    // Validate API key
+    if (!config.apiKey) {
+        output.write('Error: No API key found. Set OPENROUTER_API_KEY or OPENAI_API_KEY.\n');
+        return { exchanges: 0, success: false, error: 'No API key' };
+    }
+    // Build agent options
+    const envPrompt = formatEnvironmentPrompt(environment);
+    const agentOptions = {
+        role: config.role,
+        maxSteps: config.maxSteps,
+        toolPreset: config.toolPreset,
+        workspaceRoot: config.workspace,
+        enableMemory: config.memory,
+    };
+    if (config.model && config.provider) {
+        agentOptions.modelProvider = config.provider;
+        agentOptions.modelName = config.model;
+    }
+    // Create agent
+    const agent = createAgent(agentOptions);
+    // Print welcome banner
+    const version = getVersion();
+    output.write(`\nagntk v${version} — interactive mode\n`);
+    output.write(`Role: ${config.role} | Model: ${config.model ?? 'default'} | Memory: ${config.memory ? 'on' : 'off'}\n`);
+    output.write(`Type /help for commands, /exit or Ctrl+C to quit.\n\n`);
+    // Create readline interface
+    const rl = createInterface({
+        input: input,
+        output: output,
+        prompt: '> ',
+        terminal: true,
+    });
+    const ctx = {
+        config,
+        environment,
+        history: [],
+        output,
+        shouldExit: false,
+    };
+    let exchanges = 0;
+    return new Promise((resolve) => {
+        rl.prompt();
+        rl.on('line', async (line) => {
+            const trimmed = line.trim();
+            // Empty line
+            if (!trimmed) {
+                rl.prompt();
+                return;
+            }
+            // Check for REPL commands
+            const cmdKey = trimmed.split(' ')[0].toLowerCase();
+            if (REPL_COMMANDS[cmdKey]) {
+                REPL_COMMANDS[cmdKey].handler(ctx);
+                if (ctx.shouldExit) {
+                    rl.close();
+                    return;
+                }
+                rl.prompt();
+                return;
+            }
+            // Send to agent
+            ctx.history.push({ role: 'user', content: trimmed });
+            const maxHistoryPairs = 10; // keep last 10 user/assistant pairs
+            const recentHistory = ctx.history.length > maxHistoryPairs * 2
+                ? ctx.history.slice(-maxHistoryPairs * 2)
+                : ctx.history;
+            const historyLines = recentHistory.map((h) => h.role === 'user' ? `[User]: ${h.content}` : `[Assistant]: ${h.content}`);
+            const contextPrompt = [
+                '<conversation_history>',
+                ...historyLines.slice(0, -1), // all but current user message
+                '</conversation_history>',
+                '',
+                recentHistory[recentHistory.length - 1].content, // current user message as the actual prompt
+            ].join('\n');
+            try {
+                output.write('\n');
+                // Stream output progressively (show tool calls + results + text)
+                const streamResult = await agent.stream({ prompt: contextPrompt });
+                let afterToolResult = false;
+                for await (const chunk of streamResult.fullStream) {
+                    if (chunk.type === 'tool-call') {
+                        const toolChunk = chunk;
+                        const argsStr = toolChunk.input ? JSON.stringify(toolChunk.input) : '';
+                        output.write(`\n⚡ ${toolChunk.toolName}(${argsStr})\n`);
+                        afterToolResult = false;
+                    }
+                    else if (chunk.type === 'tool-result') {
+                        const resultChunk = chunk;
+                        const raw = typeof resultChunk.output === 'string'
+                            ? resultChunk.output
+                            : JSON.stringify(resultChunk.output);
+                        let displayOutput = raw;
+                        try {
+                            const parsed = JSON.parse(raw);
+                            if (parsed && typeof parsed.output === 'string') {
+                                displayOutput = parsed.output;
+                            }
+                        }
+                        catch {
+                            // Use raw output as-is
+                        }
+                        const maxLen = 2000;
+                        if (displayOutput.length > maxLen) {
+                            displayOutput = displayOutput.slice(0, maxLen) + `\n... (${displayOutput.length} chars total)`;
+                        }
+                        output.write(`${displayOutput}\n`);
+                        afterToolResult = true;
+                    }
+                    else if (chunk.type === 'text-delta') {
+                        const textChunk = chunk;
+                        if (afterToolResult) {
+                            output.write('\n');
+                            afterToolResult = false;
+                        }
+                        output.write(textChunk.text);
+                    }
+                }
+                const responseText = (await streamResult.text) ?? '';
+                if (responseText && !responseText.endsWith('\n')) {
+                    output.write('\n');
+                }
+                ctx.history.push({ role: 'assistant', content: responseText });
+                exchanges++;
+                if (config.verbose) {
+                    const totalUsage = await streamResult.totalUsage;
+                    const steps = await streamResult.steps;
+                    if (totalUsage) {
+                        const usage = totalUsage;
+                        output.write(`\n[${usage.inputTokens ?? 0} in / ${usage.outputTokens ?? 0} out | ${steps?.length ?? 0} step(s)]\n`);
+                    }
+                }
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                output.write(`\nError: ${msg}\n`);
+            }
+            output.write('\n');
+            rl.prompt();
+        });
+        rl.on('close', () => {
+            output.write('\nGoodbye!\n');
+            resolve({
+                exchanges,
+                success: true,
+            });
+        });
+        rl.on('SIGINT', () => {
+            output.write('\n');
+            rl.close();
+        });
+    });
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview One-shot execution runner for agntk CLI.
+ * Takes a resolved config + prompt, creates an agent, and streams output progressively to stdout.
+ *
+ * This is the "happy path": npx agntk "organize this folder by date"
+ */
+import type { ResolvedCLIConfig } from './config.js';
+import type { EnvironmentContext } from './environment.js';
+export interface RunResult {
+    /** Final text output from the agent */
+    text: string;
+    /** Number of tool steps executed */
+    steps: number;
+    /** Whether the run completed successfully */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+export interface RunOptions {
+    /** Resolved CLI config */
+    config: ResolvedCLIConfig;
+    /** Environment context (for system prompt injection) */
+    environment: EnvironmentContext;
+    /** Where to write streaming output. Default: process.stdout */
+    output?: NodeJS.WritableStream;
+    /** Where to write status messages. Default: process.stderr */
+    statusOutput?: NodeJS.WritableStream;
+}
+/**
+ * Run the agent in one-shot mode.
+ * Creates an agent, sends the prompt, streams output to stdout.
+ */
+export declare function runOneShot(prompt: string, options: RunOptions): Promise<RunResult>;
+/**
+ * Read piped stdin (e.g., `cat file.log | agntk "explain this"`)
+ */
+export declare function readStdin(timeoutMs?: number): Promise<string | null>;
+//# 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;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO3D,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,wDAAwD;IACxD,WAAW,EAAE,kBAAkB,CAAC;IAChC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CACtC;AAgCD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CA8JpB;AAMD;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgC/E"}