llm-agent-cli 2.0.0

package/dist/agent.d.ts

@@ -0,0 +1,112 @@
+import { type PermissionMode } from "./tools/index.js";
+import type { AuditLogger } from "./audit.js";
+import type { ContextState, UsageRecord } from "./context.js";
+export interface ToolCallFunction {
+    name: string;
+    arguments: string;
+}
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: ToolCallFunction;
+}
+export interface Message {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface ToolStartEvent {
+    toolName: string;
+    argsPreview: string;
+    index: number;
+    total: number;
+}
+export interface ToolEndEvent {
+    toolName: string;
+    index: number;
+    total: number;
+    truncated: boolean;
+    resultPreview: string;
+}
+export interface AgentRunCallbacks {
+    onToken?: (token: string) => void | Promise<void>;
+    onRetry?: (attempt: number, delayMs: number, reason: string) => void | Promise<void>;
+    onToolStart?: (event: ToolStartEvent) => void | Promise<void>;
+    onToolEnd?: (event: ToolEndEvent) => void | Promise<void>;
+}
+export interface AgentRunOptions {
+    signal?: AbortSignal;
+    callbacks?: AgentRunCallbacks;
+}
+export interface AgentRunResult {
+    response: string;
+    usage?: UsageRecord;
+    model: string;
+    finishReason: string;
+    toolCalls: number;
+}
+export interface AgentOptions {
+    workspaceRoot?: string;
+    permissionMode?: PermissionMode;
+    maxReadBytes?: number;
+    maxToolResultChars?: number;
+    maxCommandOutputChars?: number;
+    shellTimeoutMs?: number;
+    systemContext?: string;
+    auditLogger?: AuditLogger;
+    /** Context window size used for pre-flight token estimation. Default 200 000. */
+    contextWindowTokens?: number;
+    /** Persistent memory injected into the system prompt (global + project MEMORY.md). */
+    memory?: string;
+}
+export interface AgentStateSnapshot {
+    history: Message[];
+    lastUserInput: string | null;
+    verboseTools: boolean;
+    cwd: string;
+    contextState: ContextState;
+}
+export declare class TurnCancelledError extends Error {
+    constructor(message?: string);
+}
+export declare function checkRouterHealth(): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+export declare class Agent {
+    private history;
+    private lastUserInput;
+    private verboseTools;
+    private readonly auditLogger?;
+    private readonly baseSystemPrompt;
+    private memory;
+    private readonly contextWindowTokens;
+    constructor(options?: AgentOptions);
+    /**
+     * Hot-update the persistent memory injected into the system prompt.
+     * Safe to call mid-session — patches history[0] in place so the model sees
+     * the new memory on the very next turn.
+     */
+    updateMemory(memory: string): void;
+    getLastUserInput(): string | null;
+    getPermissionMode(): PermissionMode;
+    getWorkspaceRoot(): string;
+    isVerboseTools(): boolean;
+    setVerboseTools(enabled: boolean): void;
+    reset(): void;
+    undoLastTurn(): string | null;
+    exportState(contextState: ContextState): AgentStateSnapshot;
+    importState(state: AgentStateSnapshot): void;
+    run(userInput: string, options?: AgentRunOptions): Promise<AgentRunResult>;
+    compactHistory(signal?: AbortSignal): Promise<string>;
+    /**
+     * Find the history index of the start of the Nth-from-last complete exchange
+     * (where an exchange begins with a user message).  Returns 1 if there are
+     * fewer than keepTurns user messages — meaning nothing should be compacted.
+     */
+    private _findKeepBoundary;
+    listModels(signal?: AbortSignal): Promise<Array<Record<string, unknown>>>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

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