notsleep 1.0.0

package/dist/agent.d.ts

@@ -0,0 +1,162 @@
+import { AgentConfig, Message, RunStats, ToolDefinition } from './types';
+import { Logger } from './logger';
+import { DashboardServer } from './dashboard';
+/**
+ * Make an arbitrary slice of the message history a VALID conversation:
+ *   - every `tool` message has a matching preceding `assistant` tool_call
+ *   - every `assistant` tool_call has all of its `tool` results present
+ *   - no leading `tool` message (which would be an orphaned result)
+ *
+ * Runs to a fixed point because removing a dangling assistant can orphan a
+ * tool result, and removing an orphaned tool result can leave an assistant
+ * with fewer results. Used by the context-truncation fallback.
+ */
+export declare function sanitizeMessageWindow(window: Message[]): Message[];
+export declare class Agent {
+    private config;
+    private provider;
+    private logger;
+    private checkpoint;
+    private tools;
+    private messages;
+    private stats;
+    private taskDescription;
+    private progress;
+    private running;
+    private taskComplete;
+    private completionSummary;
+    private paused;
+    /** Shared task queue - tools can push to this, agent reads from it */
+    private taskQueue;
+    private currentTaskId;
+    /**
+     * The value of stats.totalIterations when the CURRENT task started. Used to
+     * enforce maxIterationsPerTask: if a task runs longer than the per-task
+     * budget without calling task_complete, the agent auto-advances to the next
+     * queued task so an open-ended task can't starve the queue forever.
+     */
+    private currentTaskStartIteration;
+    /** Optional dashboard for web UI */
+    private dashboard;
+    /**
+     * Exact prompt-token count reported by the provider on the last chat call.
+     * This is the real API measurement of the context size at that moment —
+     * NOT a chars/4 guess. 0 until the first response arrives.
+     */
+    private lastPromptTokens;
+    /**
+     * How many messages had been sent when lastPromptTokens was measured.
+     * Messages appended after this index (the assistant reply + tool results)
+     * haven't been counted by the API yet, so only that small tail is estimated.
+     */
+    private lastPromptMessageCount;
+    /**
+     * Real completion-token count from the last chat call (API-reported).
+     */
+    private lastCompletionTokens;
+    /**
+     * Number of CONSECUTIVE failed iterations. Reset to 0 after any success.
+     * The agent stops only when this hits the limit — meaning it's genuinely
+     * stuck — rather than on a lifetime error total, which would kill a healthy
+     * long run that has merely accumulated transient errors over hours/days.
+     */
+    private consecutiveErrors;
+    private static readonly MAX_CONSECUTIVE_ERRORS;
+    constructor(config: AgentConfig, logger: Logger);
+    /**
+     * Register a custom tool.
+     */
+    addTool(tool: ToolDefinition): void;
+    /**
+     * Attach a dashboard server for web UI.
+     */
+    setDashboard(dashboard: DashboardServer): void;
+    private handleDashboardCommand;
+    /** Push current state to dashboard */
+    private broadcastState;
+    /**
+     * Run the agent on a task. This is the main entry point.
+     *
+     * SINGLE MODE (default):
+     *   Runs until task_complete, maxIterations, or unrecoverable error.
+     *
+     * CONTINUOUS MODE (config.continuous = true):
+     *   After task_complete, picks next task from queue. If queue is empty,
+     *   asks the LLM to generate follow-up tasks. Only stops when:
+     *   - STOP file is detected (config.stopFile)
+     *   - Ctrl+C / SIGINT
+     *   - maxIterations reached
+     *   - Agent explicitly decides there is nothing left to do
+     */
+    run(taskDescription: string, resumeFromCheckpoint?: boolean): Promise<{
+        success: boolean;
+        summary: string;
+        stats: RunStats;
+    }>;
+    private initializeMessages;
+    private getModelName;
+    /**
+     * Auto-commit the changes produced by a completed task. LOCAL ONLY — this
+     * never pushes to a remote. Stages all changes and commits with a message
+     * derived from the task summary. If there is nothing to commit (e.g. the
+     * task made no file changes), it silently does nothing.
+     */
+    private autoCommitTask;
+    /** Run a git command via execFile (argv array, no shell). Resolves stdout. */
+    private runGitQuiet;
+    /**
+     * Check if the agent should stop (STOP file, SIGINT already handled).
+     */
+    private shouldStop;
+    /**
+     * Mark the current task as complete in the queue.
+     */
+    private markCurrentTaskComplete;
+    /**
+     * Get the next task to work on. Checks queue first, then asks LLM to generate tasks.
+     */
+    private getNextTask;
+    /**
+     * Process an LLM response: display content, execute tool calls.
+     */
+    private processResponse;
+    /**
+     * Approximate token count for a slice of messages.
+     *
+     * Uses chars/4 for content plus ~4 tokens per-message overhead (role,
+     * delimiters, name field, etc. — the real overhead varies by provider
+     * but 4 is a reasonable average). This is a FALLBACK; whenever the API
+     * has reported a real prompt_tokens count we prefer that.
+     */
+    private approxTokens;
+    /**
+     * Best available measure of the CURRENT context size in tokens.
+     *
+     * Prefers the real number the API reported (lastPromptTokens) and only
+     * estimates the small tail of messages appended since that measurement.
+     * Before the first API response, falls back to a chars/4 estimate.
+     *
+     * IMPORTANT: The tail typically contains the assistant reply (whose real
+     * token count is `lastCompletionTokens`) PLUS tool-result messages. We
+     * use the real completion count for the assistant message and only
+     * estimate the tool-result messages, avoiding double-counting.
+     */
+    private currentContextTokens;
+    /**
+     * Manage context window size. When the conversation gets too long,
+     * ask the LLM to summarize progress so we can compress the history.
+     */
+    private manageContext;
+    /** Delegate to the standalone exported function. */
+    private sanitizeMessageWindow;
+    /**
+     * Save current state as a checkpoint.
+     */
+    private saveCheckpoint;
+    /**
+     * Build a final summary of everything accomplished.
+     */
+    private buildFinalSummary;
+    private sleep;
+}
+//# 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":"AAkBA,OAAO,EAAE,WAAW,EAA2B,OAAO,EAAc,QAAQ,EAAE,cAAc,EAAyB,MAAM,SAAS,CAAC;AAErI,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAKhE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAyClE;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAU;IAExB,sEAAsE;IACtE,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,aAAa,CAAgB;IAErC;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB,CAAK;IAEtC,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAAgC;IAEjD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB,CAAK;IAEnC;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAAK;IAEjC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAM;gBAExC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAkC/C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAInC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAc9C,OAAO,CAAC,sBAAsB;IAkD9B,sCAAsC;IACtC,OAAO,CAAC,cAAc;IAyCtB;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAC1E,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,QAAQ,CAAC;KACjB,CAAC;IAmSF,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,YAAY;IAKpB;;;;;OAKG;YACW,cAAc;IA+B5B,8EAA8E;IAC9E,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;YACW,WAAW;IAiFzB;;OAEG;YACW,eAAe;IA6G7B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;;OAGG;YACW,aAAa;IAsH3B,oDAAoD;IACpD,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,KAAK;CAGd"}