@adhdev/daemon-core 0.7.45 → 0.8.0

package/dist/cli-adapters/provider-cli-adapter.d.ts

@@ -67,6 +67,18 @@ export interface CliScriptInput {
     messages: CliChatMessage[];
     partialResponse: string;
 }
+export interface CliTraceEntry {
+    id: number;
+    at: number;
+    type: string;
+    status: CliSessionStatus['status'];
+    isWaitingForResponse: boolean;
+    activeModal: {
+        message: string;
+        buttons: string[];
+    } | null;
+    payload: Record<string, any>;
+}
 export interface CliProviderModule {
     type: string;
     name: string;
@@ -139,6 +151,10 @@ export declare class ProviderCliAdapter implements CliAdapter {
     private ptyOutputBuffer;
     private ptyOutputFlushTimer;
     private pendingTerminalQueryTail;
+    private lastOutputAt;
+    private lastNonEmptyOutputAt;
+    private lastScreenChangeAt;
+    private lastScreenSnapshot;
     private serverConn;
     private logBuffer;
     private lastApprovalResolvedAt;
@@ -155,6 +171,7 @@ export declare class ProviderCliAdapter implements CliAdapter {
     private submitRetryTimer;
     private submitRetryUsed;
     private submitRetryPromptSnippet;
+    private idleFinishCandidate;
     private resizeSuppressUntil;
     private statusHistory;
     private cliScripts;
@@ -167,11 +184,24 @@ export declare class ProviderCliAdapter implements CliAdapter {
     /** Max accumulated buffer size (last 50KB) */
     private static readonly MAX_ACCUMULATED_BUFFER;
     private currentTurnScope;
+    private traceEntries;
+    private traceSeq;
+    private traceSessionId;
+    private static readonly MAX_TRACE_ENTRIES;
+    private readonly providerResolutionMeta;
+    private static readonly IDLE_FINISH_CONFIRM_MS;
     private syncMessageViews;
     private normalizeParsedMessages;
     private sliceFromOffset;
     private buildParseInput;
     private setStatus;
+    private clearIdleFinishCandidate;
+    private armIdleFinishCandidate;
+    private summarizeTraceText;
+    private summarizeTraceMessages;
+    private buildTraceParseSnapshot;
+    private recordTrace;
+    private resetTraceSession;
     private readonly timeouts;
     private readonly approvalKeys;
     private readonly sendDelayMs;
@@ -190,6 +220,7 @@ export declare class ProviderCliAdapter implements CliAdapter {
     private scheduleSettle;
     private armApprovalExitTimeout;
     private looksLikeVisibleIdlePrompt;
+    private waitForInteractivePrompt;
     private evaluateSettled;
     private finishResponse;
     private commitCurrentTranscript;
@@ -212,6 +243,7 @@ export declare class ProviderCliAdapter implements CliAdapter {
     sendMessage(text: string): Promise<void>;
     getPartialResponse(): string;
     getRuntimeMetadata(): PtyRuntimeMetadata | null;
+    updateRuntimeMeta(meta: Record<string, unknown>, replace?: boolean): void;
     cancel(): void;
     saveAndStop(): Promise<void>;
     private waitForStopped;
@@ -224,5 +256,7 @@ export declare class ProviderCliAdapter implements CliAdapter {
     resolveModal(buttonIndex: number): void;
     resize(cols: number, rows: number): void;
     getDebugState(): Record<string, any>;
+    getTraceState(limit?: number): Record<string, any>;
+    getProviderResolutionMeta(): Record<string, any>;
     private respondToTerminalQueries;
 }

package/dist/cli-adapters/pty-transport.d.ts

@@ -30,6 +30,7 @@ export interface PtyRuntimeTransport {
     kill(): void;
     clearBuffer?(): void;
     detach?(): void;
+    updateMeta?(meta: Record<string, unknown>, replace?: boolean): void;
     getMetadata?(): PtyRuntimeMetadata | null;
     onData(callback: (data: string) => void): void;
     onExit(callback: (info: {

package/dist/cli-adapters/session-host-transport.d.ts

@@ -3,6 +3,7 @@ import type { PtyRuntimeTransport, PtySpawnOptions, PtyTransportFactory } from '
 interface SessionHostPtyTransportFactoryOptions {
     endpoint?: SessionHostEndpoint;
     appName?: string;
+    ensureReady?: () => Promise<void>;
     clientId: string;
     runtimeId: string;
     providerType: string;

package/dist/commands/cli-manager.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ProviderInstanceManager } from '../providers/provider-instance-manager.js';
 import { ProviderLoader } from '../providers/provider-loader.js';
+import type { ProviderResumeCapability } from '../providers/contracts.js';
 import type { CliAdapter } from '../cli-adapter-types.js';
 import type { PtyTransportFactory } from '../cli-adapters/pty-transport.js';
 import type { SessionRegistry } from '../sessions/registry.js';
@@ -14,7 +15,7 @@ export interface CliManagerDeps {
     getServerConn(): any | null;
     /** P2P — PTY output transmit */
     getP2p(): {
-        broadcastPtyOutput(key: string, data: string): void;
+        broadcastSessionOutput(key: string, data: string): void;
     } | null;
     /** StatusReporter callback */
     onStatusChange(): void;
@@ -34,6 +35,7 @@ export interface CliTransportFactoryParams {
     providerType: string;
     workspace: string;
     cliArgs?: string[];
+    providerSessionId?: string;
     attachExisting?: boolean;
 }
 export interface HostedCliRuntimeDescriptor {
@@ -46,7 +48,9 @@ export interface HostedCliRuntimeDescriptor {
     cliType: string;
     workspace: string;
     cliArgs?: string[];
+    providerSessionId?: string;
 }
+export declare function supportsExplicitSessionResume(resume?: ProviderResumeCapability): boolean;
 export declare class DaemonCliManager {
     readonly adapters: Map<string, CliAdapter>;
     private deps;
@@ -60,7 +64,12 @@ export declare class DaemonCliManager {
     private createAdapter;
     private startCliExitMonitor;
     private registerCliInstance;
-    startSession(cliType: string, workingDir: string, cliArgs?: string[], initialModel?: string): Promise<void>;
+    startSession(cliType: string, workingDir: string, cliArgs?: string[], initialModel?: string, options?: {
+        resumeSessionId?: string;
+    }): Promise<{
+        runtimeSessionId: string;
+        providerSessionId?: string;
+    }>;
     stopSession(key: string): Promise<void>;
     stopSessionWithMode(key: string, mode: 'hard' | 'save'): Promise<void>;
     shutdownAll(): void;

package/dist/config/chat-history.d.ts

@@ -13,10 +13,21 @@ interface HistoryMessage {
     receivedAt: number;
     role: 'user' | 'assistant' | 'system';
     content: string;
+    kind?: string;
+    senderName?: string;
     agent: string;
     instanceId?: string;
+    historySessionId?: string;
     sessionTitle?: string;
 }
+export interface SavedHistorySessionSummary {
+    historySessionId: string;
+    sessionTitle?: string;
+    messageCount: number;
+    firstMessageAt: number;
+    lastMessageAt: number;
+    preview?: string;
+}
 export declare class ChatHistoryWriter {
     /** Last seen message count per agent (deduplication) */
     private lastSeenCounts;
@@ -35,7 +46,19 @@ export declare class ChatHistoryWriter {
         role: string;
         content: string;
         receivedAt?: number;
-    }>, sessionTitle?: string, instanceId?: string): void;
+        kind?: string;
+        senderName?: string;
+        historyDedupKey?: string;
+    }>, sessionTitle?: string, instanceId?: string, historySessionId?: string): void;
+    appendSystemMarker(agentType: string, content: string, options?: {
+        sessionTitle?: string;
+        instanceId?: string;
+        historySessionId?: string;
+        dedupKey?: string;
+        receivedAt?: number;
+        senderName?: string;
+    }): void;
+    promoteHistorySession(agentType: string, previousHistorySessionId: string, nextHistorySessionId: string): void;
     /** Called when agent session is explicitly changed */
     onSessionChange(agentType: string): void;
     /** Delete history files older than 30 days */
@@ -50,8 +73,15 @@ export declare class ChatHistoryWriter {
  * When instanceId is specified, reads only that instance file.
  * Offset/limit-based paging.
  */
-export declare function readChatHistory(agentType: string, offset?: number, limit?: number, instanceId?: string): {
+export declare function readChatHistory(agentType: string, offset?: number, limit?: number, historySessionId?: string): {
     messages: HistoryMessage[];
     hasMore: boolean;
 };
+export declare function listSavedHistorySessions(agentType: string, options?: {
+    offset?: number;
+    limit?: number;
+}): {
+    sessions: SavedHistorySessionSummary[];
+    hasMore: boolean;
+};
 export {};

package/dist/config/config.d.ts

@@ -5,8 +5,10 @@
  */
 import type { WorkspaceEntry } from './workspaces.js';
 import type { RecentActivityEntry } from './recent-activity.js';
+import type { SavedProviderSessionEntry } from './saved-sessions.js';
 export type { WorkspaceEntry } from './workspaces.js';
 export type { RecentActivityEntry } from './recent-activity.js';
+export type { SavedProviderSessionEntry } from './saved-sessions.js';
 export interface ADHDevConfig {
     serverUrl: string;
     selectedIde: string | null;
@@ -23,6 +25,8 @@ export interface ADHDevConfig {
     defaultWorkspaceId?: string | null;
     /** Unified recent activity across IDE / CLI / ACP launch flows */
     recentActivity?: RecentActivityEntry[];
+    /** Persistent resume-capable provider sessions keyed by providerSessionId */
+    savedProviderSessions?: SavedProviderSessionEntry[];
     /** Last seen timestamps for live sessions, keyed by sessionId */
     sessionReads?: Record<string, number>;
     /** Last seen completion marker for live sessions, keyed by sessionId */
@@ -38,7 +42,7 @@ export interface ADHDevConfig {
      * Server-side D1 `machines.id` — the row ID assigned when daemon registers via
      * `POST /cli/complete`. Used as fallback for machine lookup on re-auth.
      *
-     * @deprecated Legacy bridge field — will be removed after 2026-04-06.
+     * @deprecated Legacy bridge field — will be removed after 2026-05-01.
      * Modern auth flow uses `machineSecret` (adm_) to identify machines.
      */
     registeredMachineId?: string;

package/dist/config/recent-activity.d.ts

@@ -3,7 +3,7 @@
  *
  * Unlike live session state, this is launch oriented:
  * - one normalized row shape for IDE / CLI / ACP
- * - deduped by kind + providerType + workspace
+ * - deduped by provider session when available, else by kind + providerType + workspace
  * - used only for quick-launch shortcuts
  */
 import type { ADHDevConfig } from './config.js';
@@ -12,12 +12,14 @@ export interface RecentActivityEntry {
     kind: 'ide' | 'cli' | 'acp';
     providerType: string;
     providerName: string;
+    providerSessionId?: string;
     workspace?: string | null;
     currentModel?: string;
     title?: string;
     lastUsedAt: number;
 }
 export declare function buildRecentActivityKey(entry: Pick<RecentActivityEntry, 'kind' | 'providerType' | 'workspace'>): string;
+export declare function buildRecentActivityKeyForEntry(entry: Pick<RecentActivityEntry, 'kind' | 'providerType' | 'workspace' | 'providerSessionId'>): string;
 export declare function appendRecentActivity(config: ADHDevConfig, entry: Omit<RecentActivityEntry, 'id' | 'lastUsedAt'> & {
     lastUsedAt?: number;
 }): ADHDevConfig;

package/dist/config/saved-sessions.d.ts

@@ -0,0 +1,22 @@
+import type { ADHDevConfig } from './config.js';
+export interface SavedProviderSessionEntry {
+    id: string;
+    kind: 'cli' | 'acp';
+    providerType: string;
+    providerName: string;
+    providerSessionId: string;
+    workspace?: string | null;
+    currentModel?: string;
+    title?: string;
+    createdAt: number;
+    lastUsedAt: number;
+}
+export declare function buildSavedProviderSessionKey(providerSessionId: string): string;
+export declare function upsertSavedProviderSession(config: ADHDevConfig, entry: Omit<SavedProviderSessionEntry, 'id' | 'createdAt' | 'lastUsedAt'> & {
+    createdAt?: number;
+    lastUsedAt?: number;
+}): ADHDevConfig;
+export declare function getSavedProviderSessions(config: ADHDevConfig, filters?: {
+    providerType?: string;
+    kind?: SavedProviderSessionEntry['kind'];
+}): SavedProviderSessionEntry[];

package/dist/daemon/dev-auto-implement.d.ts

@@ -7,6 +7,21 @@
  */
 import type * as http from 'http';
 import type { DevServerContext, ProviderCategory } from './dev-server-types.js';
+type CliExerciseVerification = {
+    request?: Record<string, any>;
+    mustContainAny?: string[];
+    mustNotContainAny?: string[];
+    mustMatchAny?: string[];
+    mustNotMatchAny?: string[];
+    lastAssistantMustContainAny?: string[];
+    lastAssistantMustNotContainAny?: string[];
+    lastAssistantMustMatchAny?: string[];
+    lastAssistantMustNotMatchAny?: string[];
+    inspectFields?: string[];
+    description?: string;
+    fixtureName?: string;
+    fixtureNames?: string[];
+};
 export declare function getDefaultAutoImplReference(ctx: DevServerContext, category: string, type: string): string;
 export declare function resolveAutoImplReference(ctx: DevServerContext, category: string, requestedReference: string | undefined, targetType: string): string | null;
 export declare function getLatestScriptVersionDir(scriptsDir: string): string | null;
@@ -16,11 +31,12 @@ export declare function resolveAutoImplWritableProviderDir(ctx: DevServerContext
 };
 export declare function loadAutoImplReferenceScripts(ctx: DevServerContext, referenceType: string | null): Record<string, string>;
 export declare function handleAutoImplement(ctx: DevServerContext, type: string, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
-export declare function buildAutoImplPrompt(ctx: DevServerContext, type: string, provider: any, providerDir: string, functions: string[], domContext: any, referenceScripts: Record<string, string>, userComment?: string, referenceType?: string | null): string;
-export declare function buildCliAutoImplPrompt(ctx: DevServerContext, type: string, provider: any, providerDir: string, functions: string[], referenceScripts: Record<string, string>, userComment?: string, referenceType?: string | null): string;
+export declare function buildAutoImplPrompt(ctx: DevServerContext, type: string, provider: any, providerDir: string, functions: string[], domContext: any, referenceScripts: Record<string, string>, userComment?: string, referenceType?: string | null, verification?: CliExerciseVerification): string;
+export declare function buildCliAutoImplPrompt(ctx: DevServerContext, type: string, provider: any, providerDir: string, functions: string[], referenceScripts: Record<string, string>, userComment?: string, referenceType?: string | null, verification?: CliExerciseVerification): string;
 export declare function handleAutoImplSSE(ctx: DevServerContext, type: string, req: http.IncomingMessage, res: http.ServerResponse): void;
 export declare function handleAutoImplCancel(ctx: DevServerContext, _type: string, _req: http.IncomingMessage, res: http.ServerResponse): void;
 export declare function sendAutoImplSSE(ctx: DevServerContext, msg: {
     event: string;
     data: any;
 }): void;
+export {};

package/dist/daemon/dev-cli-debug.d.ts

@@ -6,6 +6,77 @@
  */
 import type * as http from 'http';
 import type { DevServerContext } from './dev-server-types.js';
+type CliExerciseRequest = {
+    type?: string;
+    text?: string;
+    instanceId?: string;
+    workingDir?: string;
+    args?: string[];
+    autoLaunch?: boolean;
+    freshSession?: boolean;
+    autoResolveApprovals?: boolean;
+    approvalButtonIndex?: number;
+    timeoutMs?: number;
+    readyTimeoutMs?: number;
+    idleSettledMs?: number;
+    traceLimit?: number;
+    stopWhenDone?: boolean;
+};
+export type CliFixtureAssertions = {
+    mustContainAny?: string[];
+    mustNotContainAny?: string[];
+    mustMatchAny?: string[];
+    mustNotMatchAny?: string[];
+    lastAssistantMustContainAny?: string[];
+    lastAssistantMustNotContainAny?: string[];
+    lastAssistantMustMatchAny?: string[];
+    lastAssistantMustNotMatchAny?: string[];
+    statusesSeen?: string[];
+    requireNotTimedOut?: boolean;
+};
+type CliExerciseFixture = {
+    version: 1;
+    kind: 'cli-exercise-fixture';
+    name: string;
+    type: string;
+    createdAt: string;
+    providerDir: string | null;
+    providerResolution: Record<string, any> | null;
+    request: CliExerciseRequest;
+    result: Record<string, any>;
+    assertions: CliFixtureAssertions;
+    notes?: string;
+};
+export declare function validateCliFixtureResult(result: any, assertions: CliFixtureAssertions): string[];
+export declare function runCliExerciseInternal(ctx: DevServerContext, body: CliExerciseRequest): Promise<Record<string, any>>;
+export declare function runCliAutoImplVerification(ctx: DevServerContext, type: string, verification?: {
+    request?: Record<string, any>;
+    mustContainAny?: string[];
+    mustNotContainAny?: string[];
+    mustMatchAny?: string[];
+    mustNotMatchAny?: string[];
+    lastAssistantMustContainAny?: string[];
+    lastAssistantMustNotContainAny?: string[];
+    lastAssistantMustMatchAny?: string[];
+    lastAssistantMustNotMatchAny?: string[];
+    fixtureName?: string;
+    fixtureNames?: string[];
+}): Promise<{
+    mode: 'fixture_replay' | 'fixture_replay_suite' | 'exercise';
+    pass: boolean;
+    failures: string[];
+    result: Record<string, any>;
+    assertions: CliFixtureAssertions;
+    fixture?: CliExerciseFixture;
+    results?: Array<{
+        fixtureName: string;
+        pass: boolean;
+        failures: string[];
+        result: Record<string, any>;
+        assertions: CliFixtureAssertions;
+        fixture: CliExerciseFixture;
+    }>;
+}>;
 /** GET /api/cli/status — list all running CLI/ACP instances with state */
 export declare function handleCliStatus(ctx: DevServerContext, _req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
 /** POST /api/cli/launch — launch a CLI agent { type, workingDir?, args? } */
@@ -18,7 +89,18 @@ export declare function handleCliStop(ctx: DevServerContext, req: http.IncomingM
 export declare function handleCliSSE(ctx: DevServerContext, cliSSEClients: http.ServerResponse[], _req: http.IncomingMessage, res: http.ServerResponse): void;
 /** GET /api/cli/debug/:type — full internal debug state of a CLI adapter */
 export declare function handleCliDebug(ctx: DevServerContext, type: string, _req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/** GET /api/cli/trace/:type — recent CLI trace timeline plus current debug snapshot */
+export declare function handleCliTrace(ctx: DevServerContext, type: string, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/** POST /api/cli/exercise — autonomously run a CLI repro and wait for final settled trace */
+export declare function handleCliExercise(ctx: DevServerContext, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/** POST /api/cli/fixture/capture — run exact exercise once and persist it as a reusable fixture */
+export declare function handleCliFixtureCapture(ctx: DevServerContext, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/** GET /api/cli/fixtures/:type — list saved exercise fixtures for a provider */
+export declare function handleCliFixtureList(ctx: DevServerContext, type: string, _req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/** POST /api/cli/fixture/replay — rerun a saved exact exercise and validate against saved assertions */
+export declare function handleCliFixtureReplay(ctx: DevServerContext, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
 /** POST /api/cli/resolve — resolve an approval modal { type, buttonIndex } */
 export declare function handleCliResolve(ctx: DevServerContext, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
 /** POST /api/cli/raw — send raw keystrokes to PTY { type, keys } */
 export declare function handleCliRaw(ctx: DevServerContext, req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+export {};

package/dist/daemon/dev-server.d.ts

@@ -119,6 +119,10 @@ export declare class DevServer implements DevServerContext {
     private handleCliLaunch;
     /** POST /api/cli/send — send message to a running CLI { type, text } */
     private handleCliSend;
+    /** POST /api/cli/exercise — launch/send/approve/wait helper for provider-fix loops */
+    private handleCliExercise;
+    private handleCliFixtureCapture;
+    private handleCliFixtureReplay;
     /** POST /api/cli/stop — stop a running CLI { type } */
     private handleCliStop;
     /** GET /api/cli/events — SSE stream of CLI status events */
@@ -126,6 +130,9 @@ export declare class DevServer implements DevServerContext {
     sendCliSSE(data: any): void;
     /** GET /api/cli/debug/:type — full internal debug state of a CLI adapter */
     private handleCliDebug;
+    /** GET /api/cli/trace/:type — recent CLI trace timeline plus current debug snapshot */
+    private handleCliTrace;
+    private handleCliFixtureList;
     /** POST /api/cli/resolve — resolve an approval modal { type, buttonIndex } */
     private handleCliResolve;
     /** POST /api/cli/raw — send raw keystrokes to PTY { type, keys } */

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export { loadConfig, saveConfig, resetConfig, isSetupComplete, markSetupComplete
 export { getWorkspaceState } from './config/workspaces.js';
 export { appendRecentActivity, getRecentActivity } from './config/recent-activity.js';
 export type { RecentActivityEntry } from './config/recent-activity.js';
+export { getSavedProviderSessions, upsertSavedProviderSession } from './config/saved-sessions.js';
+export type { SavedProviderSessionEntry } from './config/saved-sessions.js';
 export { detectIDEs } from './detection/ide-detector.js';
 export type { IDEInfo } from './detection/ide-detector.js';
 export { detectCLIs } from './detection/cli-detector.js';