@roackb2/heddle 0.0.6 → 0.0.8

package/dist/src/runtime/events.d.ts

@@ -0,0 +1,62 @@
+import type { ChatMessage, LlmProvider, LlmUsage } from '../llm/types.js';
+import type { RunResult, StopReason, TraceEvent } from '../types.js';
+export type AgentLoopStatus = 'finished';
+export type AgentLoopState = {
+    status: AgentLoopStatus;
+    goal: string;
+    model: string;
+    provider: LlmProvider;
+    workspaceRoot: string;
+    startedAt: string;
+    finishedAt: string;
+    outcome: StopReason;
+    summary: string;
+    usage?: LlmUsage;
+    transcript: ChatMessage[];
+    trace: TraceEvent[];
+};
+export type AgentLoopCheckpoint = {
+    version: 1;
+    createdAt: string;
+    state: AgentLoopState;
+};
+export type AgentLoopEvent = {
+    type: 'loop.started';
+    goal: string;
+    model: string;
+    provider: LlmProvider;
+    workspaceRoot: string;
+    timestamp: string;
+} | {
+    type: 'assistant.stream';
+    step: number;
+    text: string;
+    done: boolean;
+    timestamp: string;
+} | {
+    type: 'trace';
+    event: TraceEvent;
+    timestamp: string;
+} | {
+    type: 'loop.finished';
+    outcome: RunResult['outcome'];
+    summary: string;
+    usage: RunResult['usage'];
+    state: AgentLoopState;
+    timestamp: string;
+};
+export declare function createFinishedAgentLoopState(args: {
+    goal: string;
+    model: string;
+    provider: LlmProvider;
+    workspaceRoot: string;
+    startedAt: string;
+    finishedAt: string;
+    result: RunResult;
+}): AgentLoopState;
+export declare function createAgentLoopCheckpoint(state: AgentLoopState, options?: {
+    createdAt?: string;
+}): AgentLoopCheckpoint;
+export declare function getHistoryFromAgentLoopState(state: AgentLoopState): ChatMessage[];
+export declare function getHistoryFromAgentLoopCheckpoint(checkpoint: AgentLoopCheckpoint): ChatMessage[];
+//# sourceMappingURL=events.d.ts.map

package/dist/src/runtime/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/runtime/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;CACnB,GAAG,cAAc,CAejB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,mBAAmB,CAMrB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,EAAE,CAEjF;AAED,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAEhG"}

package/dist/src/runtime/events.js

@@ -0,0 +1,30 @@
+export function createFinishedAgentLoopState(args) {
+    return {
+        status: 'finished',
+        goal: args.goal,
+        model: args.model,
+        provider: args.provider,
+        workspaceRoot: args.workspaceRoot,
+        startedAt: args.startedAt,
+        finishedAt: args.finishedAt,
+        outcome: args.result.outcome,
+        summary: args.result.summary,
+        usage: args.result.usage,
+        transcript: args.result.transcript,
+        trace: args.result.trace,
+    };
+}
+export function createAgentLoopCheckpoint(state, options = {}) {
+    return {
+        version: 1,
+        createdAt: options.createdAt ?? new Date().toISOString(),
+        state,
+    };
+}
+export function getHistoryFromAgentLoopState(state) {
+    return state.transcript;
+}
+export function getHistoryFromAgentLoopCheckpoint(checkpoint) {
+    return getHistoryFromAgentLoopState(checkpoint.state);
+}
+//# sourceMappingURL=events.js.map

package/dist/src/runtime/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/runtime/events.ts"],"names":[],"mappings":"AAwDA,MAAM,UAAU,4BAA4B,CAAC,IAQ5C;IACC,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC5B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;QACxB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;QAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAqB,EACrB,UAAkC,EAAE;IAEpC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxD,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAqB;IAChE,OAAO,KAAK,CAAC,UAAU,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,UAA+B;IAC/E,OAAO,4BAA4B,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/runtime/heartbeat-store.d.ts

@@ -0,0 +1,20 @@
+import type { AgentHeartbeatResult, RunAgentHeartbeatOptions } from './heartbeat.js';
+import type { AgentLoopCheckpoint } from './events.js';
+export type HeartbeatCheckpointStore = {
+    load: () => Promise<AgentLoopCheckpoint | undefined>;
+    save: (checkpoint: AgentLoopCheckpoint) => Promise<void>;
+};
+export type FileHeartbeatCheckpointStoreOptions = {
+    path: string;
+};
+export type RunStoredHeartbeatOptions = Omit<RunAgentHeartbeatOptions, 'checkpoint'> & {
+    store: HeartbeatCheckpointStore;
+};
+export type StoredHeartbeatResult = AgentHeartbeatResult & {
+    loadedCheckpoint: boolean;
+    nextDelayMs?: number;
+};
+export declare function createFileHeartbeatCheckpointStore(options: FileHeartbeatCheckpointStoreOptions): HeartbeatCheckpointStore;
+export declare function runStoredHeartbeat(options: RunStoredHeartbeatOptions): Promise<StoredHeartbeatResult>;
+export declare function suggestNextHeartbeatDelayMs(decision: AgentHeartbeatResult['decision']): number | undefined;
+//# sourceMappingURL=heartbeat-store.d.ts.map

package/dist/src/runtime/heartbeat-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/heartbeat-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACrD,IAAI,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,GAAG;IACrF,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,mCAAmC,GAAG,wBAAwB,CAczH;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAa3G;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAU1G"}

package/dist/src/runtime/heartbeat-store.js

@@ -0,0 +1,42 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { runAgentHeartbeat } from './heartbeat.js';
+export function createFileHeartbeatCheckpointStore(options) {
+    return {
+        async load() {
+            if (!existsSync(options.path)) {
+                return undefined;
+            }
+            return JSON.parse(readFileSync(options.path, 'utf8'));
+        },
+        async save(checkpoint) {
+            mkdirSync(dirname(options.path), { recursive: true });
+            writeFileSync(options.path, JSON.stringify(checkpoint, null, 2));
+        },
+    };
+}
+export async function runStoredHeartbeat(options) {
+    const checkpoint = await options.store.load();
+    const result = await runAgentHeartbeat({
+        ...options,
+        checkpoint,
+    });
+    await options.store.save(result.checkpoint);
+    return {
+        ...result,
+        loadedCheckpoint: Boolean(checkpoint),
+        nextDelayMs: suggestNextHeartbeatDelayMs(result.decision),
+    };
+}
+export function suggestNextHeartbeatDelayMs(decision) {
+    switch (decision) {
+        case 'continue':
+            return 60_000;
+        case 'pause':
+            return 15 * 60_000;
+        case 'complete':
+        case 'escalate':
+            return undefined;
+    }
+}
+//# sourceMappingURL=heartbeat-store.js.map

package/dist/src/runtime/heartbeat-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-store.js","sourceRoot":"","sources":["../../../src/runtime/heartbeat-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAsBnD,MAAM,UAAU,kCAAkC,CAAC,OAA4C;IAC7F,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAwB,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,GAAG,OAAO;QACV,UAAU;KACX,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE5C,OAAO;QACL,GAAG,MAAM;QACT,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC;QACrC,WAAW,EAAE,2BAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAA0C;IACpF,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,MAAM,CAAC;QACrB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/src/runtime/heartbeat.d.ts

@@ -0,0 +1,39 @@
+import type { Logger } from 'pino';
+import type { ChatMessage, LlmAdapter } from '../llm/types.js';
+import type { ToolCall, ToolDefinition } from '../types.js';
+import type { AgentLoopCheckpoint, AgentLoopEvent, AgentLoopState } from './events.js';
+export type HeartbeatDecision = 'continue' | 'pause' | 'complete' | 'escalate';
+export type RunAgentHeartbeatOptions = {
+    task: string;
+    checkpoint?: AgentLoopState | AgentLoopCheckpoint;
+    model?: string;
+    apiKey?: string;
+    maxSteps?: number;
+    workspaceRoot?: string;
+    stateDir?: string;
+    memoryDir?: string;
+    searchIgnoreDirs?: string[];
+    systemContext?: string;
+    history?: ChatMessage[];
+    llm?: LlmAdapter;
+    tools?: ToolDefinition[];
+    extraTools?: ToolDefinition[];
+    includeDefaultTools?: boolean;
+    includePlanTool?: boolean;
+    logger?: Logger;
+    onEvent?: (event: AgentLoopEvent) => void;
+    approveToolCall?: (call: ToolCall, tool: ToolDefinition) => Promise<{
+        approved: boolean;
+        reason?: string;
+    }>;
+    shouldStop?: () => boolean;
+    abortSignal?: AbortSignal;
+};
+export type AgentHeartbeatResult = {
+    decision: HeartbeatDecision;
+    summary: string;
+    checkpoint: AgentLoopCheckpoint;
+    state: AgentLoopState;
+};
+export declare function runAgentHeartbeat(options: RunAgentHeartbeatOptions): Promise<AgentHeartbeatResult>;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/runtime/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../src/runtime/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIvF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5G,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+BxG"}

package/dist/src/runtime/heartbeat.js

@@ -0,0 +1,72 @@
+import { runAgentLoop } from './agent-loop.js';
+import { createAgentLoopCheckpoint } from './events.js';
+const DEFAULT_HEARTBEAT_MAX_STEPS = 80;
+export async function runAgentHeartbeat(options) {
+    const result = await runAgentLoop({
+        goal: buildHeartbeatGoal(options.task),
+        model: options.model,
+        apiKey: options.apiKey,
+        maxSteps: options.maxSteps ?? DEFAULT_HEARTBEAT_MAX_STEPS,
+        workspaceRoot: options.workspaceRoot,
+        stateDir: options.stateDir,
+        memoryDir: options.memoryDir,
+        searchIgnoreDirs: options.searchIgnoreDirs,
+        systemContext: appendHeartbeatSystemContext(options.systemContext),
+        history: options.history,
+        resumeFrom: options.checkpoint,
+        llm: options.llm,
+        tools: options.tools,
+        extraTools: options.extraTools,
+        includeDefaultTools: options.includeDefaultTools,
+        includePlanTool: options.includePlanTool,
+        logger: options.logger,
+        onEvent: options.onEvent,
+        approveToolCall: options.approveToolCall,
+        shouldStop: options.shouldStop,
+        abortSignal: options.abortSignal,
+    });
+    return {
+        decision: inferHeartbeatDecision(result.summary, result.outcome),
+        summary: result.summary,
+        checkpoint: createAgentLoopCheckpoint(result.state),
+        state: result.state,
+    };
+}
+function buildHeartbeatGoal(task) {
+    return [
+        'Heartbeat wake cycle.',
+        '',
+        'Durable task:',
+        task,
+        '',
+        'Work autonomously on the task if there is useful, safe progress to make now.',
+        'Do not wait for a chat message.',
+        'If blocked, risky, or user input is required, escalate clearly instead of guessing.',
+        '',
+        'End your response with exactly one decision line:',
+        'HEARTBEAT_DECISION: continue | pause | complete | escalate',
+    ].join('\n');
+}
+function appendHeartbeatSystemContext(systemContext) {
+    const heartbeatContext = [
+        '## Heartbeat Mode',
+        '',
+        'This run was started by an autonomous heartbeat, not by a live chat message.',
+        'Operate within the available tools and approval policy.',
+        'Make bounded useful progress, update durable memory when appropriate, and stop cleanly.',
+        'Escalate only when human input, credentials, policy approval, or risky judgment is required.',
+        'The required final decision line is: HEARTBEAT_DECISION: continue | pause | complete | escalate',
+    ].join('\n');
+    return systemContext ? `${systemContext}\n\n${heartbeatContext}` : heartbeatContext;
+}
+function inferHeartbeatDecision(summary, outcome) {
+    const match = summary.match(/HEARTBEAT_DECISION:\s*(continue|pause|complete|escalate)\b/i);
+    if (match) {
+        return match[1].toLowerCase();
+    }
+    if (outcome === 'done') {
+        return 'pause';
+    }
+    return 'escalate';
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/src/runtime/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../src/runtime/heartbeat.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAmCvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAiC;IACvE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,2BAA2B;QACzD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,aAAa,EAAE,4BAA4B,CAAC,OAAO,CAAC,aAAa,CAAC;QAClE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;QAChE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,yBAAyB,CAAC,MAAM,CAAC,KAAK,CAAC;QACnD,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO;QACL,uBAAuB;QACvB,EAAE;QACF,eAAe;QACf,IAAI;QACJ,EAAE;QACF,8EAA8E;QAC9E,iCAAiC;QACjC,qFAAqF;QACrF,EAAE;QACF,mDAAmD;QACnD,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,4BAA4B,CAAC,aAAiC;IACrE,MAAM,gBAAgB,GAAG;QACvB,mBAAmB;QACnB,EAAE;QACF,8EAA8E;QAC9E,yDAAyD;QACzD,yFAAyF;QACzF,8FAA8F;QAC9F,iGAAiG;KAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,gBAAgB,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACtF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,OAAe;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC3F,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAuB,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAMA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAAC,MAAM,CAoC3E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,6BAAiB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAMA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAAC,MAAM,CAoC3E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,6BAA4C,CAAC"}

package/dist/src/utils/logger.js

@@ -39,12 +39,12 @@ export function createLogger(options = {}) {
         });
     }
     if (streams.length === 0) {
-        return pino({ level }, pino.destination('/dev/null'));
+        return pino({ level, enabled: false });
     }
     return pino({ level }, pino.multistream(streams));
 }
 /**
  * Default logger instance.
  */
-export const logger = createLogger();
+export const logger = pino({ level: 'silent', enabled: false });
 //# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,UAAU,MAAM,aAAa,CAAC;AASrC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC7E,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU,CAAC;oBACjB,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,cAAc;iBACvB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;gBACvB,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,IAAI;aACZ,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,UAAU,MAAM,aAAa,CAAC;AASrC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC7E,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU,CAAC;oBACjB,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,cAAc;iBACvB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;gBACvB,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,IAAI;aACZ,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roackb2/heddle",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "An open-source terminal coding agent runtime and CLI with OpenAI and Anthropic support",
   "author": "Jay / Fienna Liang <roackb2@gmail.com>",
   "license": "MIT",
@@ -26,12 +26,17 @@
   "types": "dist/src/index.d.ts",
   "files": [
     "dist",
+    "!dist/src/__tests__",
+    "!dist/src/**/*.test.*",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
+    "clean": "node scripts/clean-dist.mjs",
+    "build": "yarn clean && tsc -p tsconfig.build.json",
     "dev": "tsx --no-cache examples/repo-investigator.ts",
+    "example:programmatic": "tsx --no-cache examples/programmatic-loop.ts",
+    "example:heartbeat": "tsx --no-cache examples/heartbeat.ts",
     "chat": "tsx --no-cache examples/conversation.tsx",
     "chat:light": "OPENAI_MODEL=gpt-5.1-codex-mini tsx --no-cache examples/conversation.tsx",
     "repo-investigator:dev": "OPENAI_API_KEY=\"$PERSONAL_OPENAI_API_KEY\" tsx --no-cache examples/repo-investigator.ts",
@@ -45,9 +50,20 @@
   "keywords": [
     "agent",
     "coding-agent",
+    "agentic-coding",
+    "agent-runtime",
+    "agent-framework",
+    "ai-agent",
     "terminal-agent",
     "cli-agent",
+    "llm-agent",
     "ai-cli",
+    "autonomous-agent",
+    "heartbeat",
+    "long-running-agent",
+    "persistent-memory",
+    "agent-memory",
+    "knowledge-persistence",
     "developer-tools",
     "workspace-agent",
     "repository-tools",

package/dist/src/__tests__/chat-activity-format.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=chat-activity-format.test.d.ts.map

package/dist/src/__tests__/chat-activity-format.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-activity-format.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/chat-activity-format.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/chat-activity-format.test.js

@@ -1,41 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { summarizeToolCall, toLiveEvent } from '../cli/chat/utils/format.js';
-describe('chat activity formatting', () => {
-    it('includes read_file paths in tool call summaries', () => {
-        expect(summarizeToolCall('read_file', { path: 'docs/framework-vision.md' })).toBe('read_file (docs/framework-vision.md)');
-    });
-    it('includes list_files paths in tool call summaries', () => {
-        expect(summarizeToolCall('list_files', { path: 'src/cli/chat' })).toBe('list_files (src/cli/chat)');
-    });
-    it('includes search_files query and path in tool call summaries', () => {
-        expect(summarizeToolCall('search_files', { query: 'trace-1775195542429', path: '.heddle/traces' })).toBe('search_files ("trace-1775195542429" in .heddle/traces)');
-    });
-    it('includes read paths in live activity events', () => {
-        const event = {
-            type: 'tool.call',
-            call: { id: 'call-1', tool: 'read_file', input: { path: 'README.md' } },
-            step: 1,
-            timestamp: '2024-01-01T00:00:00Z',
-        };
-        expect(toLiveEvent(event)).toBe('running read_file (README.md)');
-    });
-    it('includes list paths in approval activity events', () => {
-        const event = {
-            type: 'tool.approval_requested',
-            call: { id: 'call-2', tool: 'list_files', input: { path: 'src' } },
-            step: 2,
-            timestamp: '2024-01-01T00:00:01Z',
-        };
-        expect(toLiveEvent(event)).toBe('approval needed for list_files (src)');
-    });
-    it('includes search query details in live activity events', () => {
-        const event = {
-            type: 'tool.call',
-            call: { id: 'call-3', tool: 'search_files', input: { query: 'trace', path: '.heddle/traces' } },
-            step: 3,
-            timestamp: '2024-01-01T00:00:02Z',
-        };
-        expect(toLiveEvent(event)).toBe('running search_files ("trace" in .heddle/traces)');
-    });
-});
-//# sourceMappingURL=chat-activity-format.test.js.map

package/dist/src/__tests__/chat-activity-format.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-activity-format.test.js","sourceRoot":"","sources":["../../../src/__tests__/chat-activity-format.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG7E,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC,CAAC,IAAI,CAC/E,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,iBAAiB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CACpE,2BAA2B,CAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CACtG,wDAAwD,CACzD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YACvE,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,sBAAsB;SAClC,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAClE,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,sBAAsB;SAClC,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE;YAC/F,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,sBAAsB;SAClC,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/__tests__/chat-compaction.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=chat-compaction.test.d.ts.map

package/dist/src/__tests__/chat-compaction.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-compaction.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/chat-compaction.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/chat-compaction.test.js

@@ -1,63 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { compactChatHistory, isCompactedHistorySummary } from '../cli/chat/state/compaction.js';
-import { buildConversationMessages } from '../cli/chat/utils/format.js';
-describe('chat history compaction', () => {
-    it('compacts older transcript messages into a summary and keeps recent messages', () => {
-        const history = Array.from({ length: 50 }).flatMap((_, index) => [
-            { role: 'user', content: `User prompt ${index}: ${'u'.repeat(4000)}` },
-            { role: 'assistant', content: `Assistant reply ${index}: ${'a'.repeat(4000)}` },
-        ]);
-        const compacted = compactChatHistory({
-            history,
-            model: 'gpt-4.1',
-        });
-        expect(isCompactedHistorySummary(compacted.history[0])).toBe(true);
-        expect(compacted.history.length).toBeLessThan(history.length);
-        expect(compacted.history.at(-1)).toEqual(history.at(-1));
-        expect(compacted.history.at(-2)).toEqual(history.at(-2));
-        expect(compacted.context.estimatedHistoryTokens).toBeLessThan(80_000);
-        expect(compacted.context.compactedMessages).toBeGreaterThan(0);
-        const visibleMessages = buildConversationMessages(compacted.history);
-        expect(visibleMessages[0]?.text).toContain('Earlier conversation history was compacted');
-    });
-    it('can force a single manual compaction pass even before the auto threshold is exceeded', () => {
-        const history = Array.from({ length: 6 }).flatMap((_, index) => [
-            { role: 'user', content: `User prompt ${index}: ${'u'.repeat(60)}` },
-            { role: 'assistant', content: `Assistant reply ${index}: ${'a'.repeat(60)}` },
-        ]);
-        const autoCompacted = compactChatHistory({
-            history,
-            model: 'gpt-5.1',
-        });
-        const manuallyCompacted = compactChatHistory({
-            history,
-            model: 'gpt-5.1',
-            force: true,
-        });
-        expect(autoCompacted.history).toEqual(history);
-        expect(isCompactedHistorySummary(manuallyCompacted.history[0])).toBe(true);
-        expect(manuallyCompacted.history.length).toBeLessThan(history.length);
-        expect(manuallyCompacted.context.compactedMessages).toBeGreaterThan(0);
-    });
-    it('can re-compact an already compacted short session when forced manually', () => {
-        const history = [
-            {
-                role: 'system',
-                content: 'Heddle compacted earlier conversation history.\n\nMore recent archived turns:\nAssistant: Earlier summary.',
-            },
-            { role: 'system', content: 'Host reminder: use the evidence you already gathered.' },
-            { role: 'tool', toolCallId: 'tool-1', content: '{"ok":true,"output":"git diff --stat HEAD"}' },
-            { role: 'user', content: 'can you try again' },
-            { role: 'user', content: 'try again' },
-        ];
-        const compacted = compactChatHistory({
-            history,
-            model: 'gpt-5.1',
-            force: true,
-        });
-        expect(compacted.history.length).toBeLessThan(history.length);
-        expect(isCompactedHistorySummary(compacted.history[0])).toBe(true);
-        expect(compacted.context.compactedMessages).toBeGreaterThan(0);
-    });
-});
-//# sourceMappingURL=chat-compaction.test.js.map

package/dist/src/__tests__/chat-compaction.test.js.map

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

package/dist/src/__tests__/chat-format.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=chat-format.test.d.ts.map

package/dist/src/__tests__/chat-format.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-format.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/chat-format.test.ts"],"names":[],"mappings":""}