min-agent 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "min-agent",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Minimal AI coding agent with tool use, MCP, and skills support",
   "license": "MIT",

package/dist/agent.d.ts

@@ -1,23 +0,0 @@
-import { type ModelMessage, type LanguageModelUsage } from "ai";
-/** Build user message content, optionally with images */
-export declare function buildUserContent(message: string, imagePaths?: string[]): Promise<any>;
-/** Single-shot: send one message, get response, exit */
-export declare function runAgent(message: string, modelId?: string, imagePaths?: string[]): Promise<void>;
-/** Interactive multi-turn chat session */
-export declare function runChat(modelId?: string, resumeSessionId?: string): Promise<void>;
-/** When set, `runOnce` does not write to TTY; use for HTTP / programmatic callers. */
-export interface RunOnceCallbacks {
-    onAssistantDisplayDelta?: (delta: string) => void;
-    onThinkingDelta?: (delta: string) => void;
-    onToolCall?: (toolName: string, input: unknown) => void;
-    onToolResult?: (toolName: string, output: unknown) => void;
-    onCompaction?: (line: string) => void;
-    onStreamError?: (message: string) => void;
-    onRunFinish?: (info: {
-        stepCount: number;
-        usage: LanguageModelUsage | undefined;
-        hasError: boolean;
-        aborted: boolean;
-    }) => void;
-}
-export declare function runOnce(messages: ModelMessage[], instructions: string[], modelId?: string, abortSignal?: AbortSignal, callbacks?: RunOnceCallbacks): Promise<void>;

package/dist/assistant-stream.d.ts

@@ -1,23 +0,0 @@
-/**
- * Split "thinking" fragments (inline XML-style blocks some models leak into text)
- * from displayable assistant text. Thinking is emitted to stderr; display goes to Markdown.
- */
-/**
- * Incremental filter: feed raw model text deltas; get display text (for stdout / history)
- * and thinking text (for stderr). Handles tags split across chunks.
- */
-export declare class ThinkingBodySplitter {
-    private buf;
-    feed(chunk: string): {
-        display: string;
-        thinking: string;
-    };
-    /** End of stream: flush remainder; incomplete thinking block → stderr only. */
-    flush(): {
-        display: string;
-        thinking: string;
-    };
-    private drain;
-}
-/** Final strip for assistant message (complete tags only). */
-export declare function stripThinkingFromAssistantText(text: string): string;

package/dist/cli.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/compaction.d.ts

@@ -1,14 +0,0 @@
-import { type ModelMessage, type LanguageModel } from "ai";
-export interface CompactionConfig {
-    maxTokens?: number;
-    keepRecentTurns?: number;
-}
-/** Rough token estimation */
-export declare function estimateTokens(messages: ModelMessage[]): number;
-/** Check if compaction is needed */
-export declare function needsCompaction(messages: ModelMessage[], config?: CompactionConfig): boolean;
-/** Compact messages by summarizing older history */
-export declare function compactMessages(messages: ModelMessage[], model: LanguageModel, config?: CompactionConfig): Promise<{
-    messages: ModelMessage[];
-    compacted: boolean;
-}>;

package/dist/config.d.ts

@@ -1,17 +0,0 @@
-export interface ProviderConfig {
-    type?: "openai-compatible" | "openai" | "ollama";
-    baseURL: string;
-    apiKey: string;
-    defaultModel?: string;
-}
-export interface AppConfig {
-    provider?: ProviderConfig;
-    instructions?: string[];
-}
-export declare function getConfigDir(): string;
-export declare function getRulesFile(): string;
-export declare function loadConfig(): AppConfig;
-export declare function saveConfig(config: AppConfig): void;
-export declare function isConfigured(): boolean;
-export declare function fetchModels(baseURL: string, apiKey: string): Promise<string[]>;
-export declare function runSetup(): Promise<void>;

package/dist/confirm.d.ts

@@ -1,6 +0,0 @@
-export declare function setAutoApprove(value: boolean): void;
-export declare function isAutoApprove(): boolean;
-/** Ask user for confirmation. Returns true if approved. */
-export declare function confirm(message: string): Promise<boolean>;
-/** Check if a shell command is potentially dangerous */
-export declare function isDangerousCommand(command: string): boolean;

package/dist/instructions.d.ts

@@ -1 +0,0 @@
-export declare function loadInstructions(): Promise<string[]>;

package/dist/markdown.d.ts

@@ -1,15 +0,0 @@
-/**
- * Lightweight streaming markdown renderer for terminal.
- * Tracks state across text deltas to apply ANSI formatting.
- */
-export declare class MarkdownRenderer {
-    private buffer;
-    private inCodeBlock;
-    private codeLang;
-    /** Process a text delta and return formatted output */
-    write(text: string): string;
-    /** Flush remaining buffer */
-    flush(): string;
-    private formatInline;
-    private formatLine;
-}

package/dist/mcp.d.ts

@@ -1,61 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
-import { type Tool } from "ai";
-export interface McpServerConfig {
-    /** Local stdio server: command + args. Ignored when `url` is set. */
-    command?: string[];
-    /** Remote MCP endpoint (http/https). When set, connects via HTTP transport instead of stdio. */
-    url?: string;
-    /**
-     * Remote transport mode.
-     * - `streamable-http`: MCP Streamable HTTP (default for new remote servers)
-     * - `sse`: legacy HTTP + SSE transport
-     * - `auto`: try streamable-http first, then fall back to sse
-     */
-    remoteTransport?: "streamable-http" | "sse" | "auto";
-    /** Shorthand: sets `Authorization: Bearer <token>` if not already present in `headers`. */
-    token?: string;
-    /** Extra HTTP headers for remote transports. */
-    headers?: Record<string, string>;
-    environment?: Record<string, string>;
-    enabled?: boolean;
-    timeout?: number;
-}
-export interface McpConfig {
-    mcpServers: Record<string, McpServerConfig>;
-}
-type McpClientTransport = StdioClientTransport | StreamableHTTPClientTransport | SSEClientTransport;
-interface ConnectedServer {
-    client: Client;
-    transport: McpClientTransport;
-    tools: Array<{
-        name: string;
-        description?: string;
-        inputSchema: any;
-    }>;
-}
-export interface McpCheckResult {
-    name: string;
-    enabled: boolean;
-    ok: boolean;
-    toolCount: number;
-    error?: string;
-}
-export declare function loadMcpConfig(): McpConfig;
-export declare function saveMcpConfig(config: McpConfig): void;
-export declare function isRemoteMcpConfig(config: McpServerConfig): boolean;
-/** One-line summary for CLI / logs (no secrets). */
-export declare function formatMcpServerBinding(config: McpServerConfig): string;
-export declare function connectMcpServer(name: string, config: McpServerConfig): Promise<ConnectedServer | null>;
-export declare function checkMcpServer(name: string, config: McpServerConfig): Promise<McpCheckResult>;
-export declare function checkAllMcpServers(): Promise<McpCheckResult[]>;
-export declare function initMcp(): Promise<void>;
-export declare function shutdownMcp(): Promise<void>;
-export declare function getMcpTools(): Record<string, Tool>;
-export declare function getMcpStatus(): Record<string, {
-    connected: boolean;
-    tools: string[];
-}>;
-export {};

package/dist/memory.d.ts

@@ -1,31 +0,0 @@
-import { type Tool } from "ai";
-/**
- * Memory system for min-agent.
- *
- * Memories are stored as a JSON array in ~/.min-agent/memory.json.
- * Each memory has a content string, tags, and timestamp.
- *
- * The agent can:
- * - memory_save: Save a new memory (user preference, project context, learned fact)
- * - memory_search: Search memories by keyword
- * - memory_list: List all memories
- * - memory_delete: Delete a memory by index
- *
- * Memories are automatically injected into the system prompt so the agent
- * "remembers" things across sessions.
- */
-export interface Memory {
-    content: string;
-    tags: string[];
-    created: string;
-}
-export declare function loadMemories(): Memory[];
-export declare function addMemory(content: string, tags?: string[]): Memory;
-export declare function deleteMemory(index: number): boolean;
-export declare function searchMemories(query: string): Array<Memory & {
-    index: number;
-}>;
-/** Build a system prompt section from stored memories */
-export declare function getMemorySystemPrompt(): string;
-/** Create the memory tools for the agent */
-export declare function getMemoryTools(): Record<string, Tool>;

package/dist/output.d.ts

@@ -1,6 +0,0 @@
-import type { LanguageModelUsage } from "ai";
-export declare function printHeader(modelId?: string): void;
-export declare function printDivider(): void;
-export declare function printToolCall(name: string, input: unknown): void;
-export declare function printToolResult(name: string, result: unknown): void;
-export declare function printDone(steps: number, usage: LanguageModelUsage): void;

package/dist/plugins.d.ts

@@ -1,2 +0,0 @@
-import { type Tool } from "ai";
-export declare function loadPluginTools(): Promise<Record<string, Tool>>;

package/dist/provider.d.ts

@@ -1,2 +0,0 @@
-import type { LanguageModel } from "ai";
-export declare function resolveModel(modelId?: string): LanguageModel;

package/dist/serve.d.ts

@@ -1,9 +0,0 @@
-/**
- * HTTP API server: exposes chat / models / health for programmatic use.
- * Run: min-agent serve [--host 127.0.0.1] [--port 8787]
- */
-export interface ServeOptions {
-    host?: string;
-    port?: number;
-}
-export declare function runServe(opts?: ServeOptions): Promise<void>;

package/dist/sessions.d.ts

@@ -1,17 +0,0 @@
-import type { ModelMessage } from "ai";
-export interface SessionMeta {
-    id: string;
-    title: string;
-    created: string;
-    updated: string;
-    messageCount: number;
-}
-interface SessionData {
-    meta: SessionMeta;
-    messages: ModelMessage[];
-}
-export declare function saveSession(messages: ModelMessage[], existingId?: string): string;
-export declare function loadSession(id: string): SessionData | null;
-export declare function listSessions(): SessionMeta[];
-export declare function deleteSession(id: string): boolean;
-export {};

package/dist/skills.d.ts

@@ -1,12 +0,0 @@
-import { type Tool } from "ai";
-export interface SkillInfo {
-    name: string;
-    description: string;
-    location: string;
-    content: string;
-}
-export declare function discoverSkills(): void;
-export declare function getSkills(): SkillInfo[];
-export declare function getSkill(name: string): SkillInfo | undefined;
-export declare function getSkillsTool(): Tool;
-export declare function getSkillsSystemPrompt(): string;

package/dist/tool-output.d.ts

@@ -1,31 +0,0 @@
-/** Default limits (aligned with common agent tooling practice). */
-export declare const TOOL_OUTPUT_MAX_LINES = 2000;
-export declare const TOOL_OUTPUT_MAX_BYTES: number;
-export type TruncateDirection = "head" | "tail";
-export interface TruncateToolOutputOptions {
-    maxLines?: number;
-    maxBytes?: number;
-    direction?: TruncateDirection;
-}
-export interface TruncateToolOutputResult {
-    content: string;
-    truncated: boolean;
-    outputPath?: string;
-}
-/** Write full text to ~/.min-agent/tool-output/ and return absolute path. */
-export declare function writeFullToolOutput(fullText: string): string;
-/** Keep end of text within line/byte limits (good for shell logs). */
-export declare function tailPreview(text: string, maxLines: number, maxBytes: number): {
-    text: string;
-    cut: boolean;
-};
-/** Keep start of text within line/byte limits (good for files / HTTP bodies). */
-export declare function headPreview(text: string, maxLines: number, maxBytes: number): {
-    text: string;
-    cut: boolean;
-};
-/**
- * If text exceeds limits, write full text to disk and return a preview + path hint.
- * Otherwise returns the original string.
- */
-export declare function truncateToolOutput(text: string, options?: TruncateToolOutputOptions): TruncateToolOutputResult;

package/dist/tools/bash.d.ts

@@ -1,6 +0,0 @@
-type BashInput = {
-    command: string;
-    timeout?: number;
-};
-export declare const bashTool: import("ai").Tool<BashInput, string>;
-export {};

package/dist/tools/edit.d.ts

@@ -1,7 +0,0 @@
-type EditInput = {
-    filePath: string;
-    oldText: string;
-    newText: string;
-};
-export declare const editTool: import("ai").Tool<EditInput, string>;
-export {};

package/dist/tools/glob.d.ts

@@ -1,6 +0,0 @@
-type GlobInput = {
-    pattern: string;
-    cwd?: string;
-};
-export declare const globTool: import("ai").Tool<GlobInput, string>;
-export {};

package/dist/tools/grep.d.ts

@@ -1,7 +0,0 @@
-type GrepInput = {
-    pattern: string;
-    path?: string;
-    include?: string;
-};
-export declare const grepTool: import("ai").Tool<GrepInput, string>;
-export {};

package/dist/tools/index.d.ts

@@ -1,37 +0,0 @@
-export declare function createTools(): {
-    bash: import("ai").Tool<{
-        command: string;
-        timeout?: number;
-    }, string>;
-    read: import("ai").Tool<{
-        filePath: string;
-        startLine?: number;
-        endLine?: number;
-    }, string>;
-    write: import("ai").Tool<{
-        filePath: string;
-        content: string;
-    }, string>;
-    edit: import("ai").Tool<{
-        filePath: string;
-        oldText: string;
-        newText: string;
-    }, string>;
-    glob: import("ai").Tool<{
-        pattern: string;
-        cwd?: string;
-    }, string>;
-    grep: import("ai").Tool<{
-        pattern: string;
-        path?: string;
-        include?: string;
-    }, string>;
-    web_search: import("ai").Tool<{
-        query: string;
-        categories?: string;
-    }, string>;
-    web_fetch: import("ai").Tool<{
-        url: string;
-        method?: string;
-    }, string>;
-};

package/dist/tools/read.d.ts

@@ -1,7 +0,0 @@
-type ReadInput = {
-    filePath: string;
-    startLine?: number;
-    endLine?: number;
-};
-export declare const readTool: import("ai").Tool<ReadInput, string>;
-export {};

package/dist/tools/web_fetch.d.ts

@@ -1,6 +0,0 @@
-type WebFetchInput = {
-    url: string;
-    method?: string;
-};
-export declare const webFetchTool: import("ai").Tool<WebFetchInput, string>;
-export {};

package/dist/tools/web_search.d.ts

@@ -1,6 +0,0 @@
-type WebSearchInput = {
-    query: string;
-    categories?: string;
-};
-export declare const webSearchTool: import("ai").Tool<WebSearchInput, string>;
-export {};

package/dist/tools/write.d.ts

@@ -1,6 +0,0 @@
-type WriteInput = {
-    filePath: string;
-    content: string;
-};
-export declare const writeTool: import("ai").Tool<WriteInput, string>;
-export {};