attocode 0.2.3 → 0.2.5

package/dist/src/integrations/persistence/session-repository.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Session Repository
+ *
+ * Session CRUD operations, entries, checkpoints, cost tracking,
+ * session hierarchy, pending plans, remembered permissions, migration,
+ * and session manifest export.
+ *
+ * Extracted from sqlite-store.ts as part of Phase 3c restructuring.
+ */
+import type { Message, ToolCall } from '../../types.js';
+import type { SessionEntry } from './session-store.js';
+import type { PendingPlan } from '../tasks/pending-plan.js';
+import type { SessionMetadata, SessionManifest, UsageLog, SessionType, SQLiteStoreDeps } from './sqlite-store.js';
+/**
+ * Create a new session.
+ */
+export declare function createSession(deps: SQLiteStoreDeps, name?: string): string;
+/**
+ * Append an entry to the current session.
+ */
+export declare function appendEntry(deps: SQLiteStoreDeps, entry: Omit<SessionEntry, 'timestamp'>): void;
+/**
+ * Append a message to the current session.
+ */
+export declare function appendMessage(deps: SQLiteStoreDeps, message: Message): void;
+/**
+ * Append a tool call to the current session.
+ */
+export declare function appendToolCall(deps: SQLiteStoreDeps, toolCall: ToolCall): void;
+/**
+ * Append a tool result to the current session.
+ */
+export declare function appendToolResult(deps: SQLiteStoreDeps, callId: string, result: unknown): void;
+/**
+ * Append a compaction summary.
+ */
+export declare function appendCompaction(deps: SQLiteStoreDeps, summary: string, compactedCount: number): void;
+/**
+ * Load a session by ID.
+ */
+export declare function loadSession(deps: SQLiteStoreDeps, sessionId: string): SessionEntry[];
+/**
+ * Reconstruct messages from session entries.
+ */
+export declare function loadSessionMessages(deps: SQLiteStoreDeps, sessionId: string): Message[];
+/**
+ * Delete a session.
+ */
+export declare function deleteSession(deps: SQLiteStoreDeps, sessionId: string): void;
+/**
+ * List all sessions.
+ */
+export declare function listSessions(deps: SQLiteStoreDeps): SessionMetadata[];
+/**
+ * Get the most recent session.
+ */
+export declare function getRecentSession(deps: SQLiteStoreDeps): SessionMetadata | null;
+/**
+ * Get session metadata by ID.
+ */
+export declare function getSessionMetadata(deps: SQLiteStoreDeps, sessionId: string): SessionMetadata | undefined;
+/**
+ * Update session metadata.
+ */
+export declare function updateSessionMetadata(deps: SQLiteStoreDeps, sessionId: string, updates: Partial<Pick<SessionMetadata, 'name' | 'summary' | 'tokenCount'>>): void;
+/**
+ * Save a checkpoint for state restoration.
+ */
+export declare function saveCheckpoint(deps: SQLiteStoreDeps, state: Record<string, unknown>, description?: string): string;
+/**
+ * Load the latest checkpoint for a session.
+ */
+export declare function loadLatestCheckpoint(deps: SQLiteStoreDeps, sessionId: string): {
+    id: string;
+    state: Record<string, unknown>;
+    createdAt: string;
+    description?: string;
+} | null;
+/**
+ * Query entries with SQL (advanced usage).
+ */
+export declare function query<T = unknown>(deps: SQLiteStoreDeps, sql: string, params?: unknown[]): T[];
+/**
+ * Get database statistics.
+ */
+export declare function getStats(deps: SQLiteStoreDeps): {
+    sessionCount: number;
+    entryCount: number;
+    toolCallCount: number;
+    checkpointCount: number;
+    dbSizeBytes: number;
+};
+/**
+ * Log API usage for cost tracking.
+ * Inserts a usage log entry and updates session totals atomically.
+ */
+export declare function logUsage(deps: SQLiteStoreDeps, usage: UsageLog): void;
+/**
+ * Get aggregated usage for a session.
+ */
+export declare function getSessionUsage(deps: SQLiteStoreDeps, sessionId: string): {
+    promptTokens: number;
+    completionTokens: number;
+    costUsd: number;
+};
+/**
+ * Create a child session linked to a parent.
+ */
+export declare function createChildSession(deps: SQLiteStoreDeps, parentId: string, name?: string, type?: SessionType): string;
+/**
+ * Get all direct child sessions of a parent.
+ */
+export declare function getChildSessions(deps: SQLiteStoreDeps, parentId: string): SessionMetadata[];
+/**
+ * Get the full session tree starting from a root session.
+ * Uses a recursive CTE to traverse the hierarchy.
+ */
+export declare function getSessionTree(deps: SQLiteStoreDeps, rootId: string): SessionMetadata[];
+/**
+ * Save a pending plan to the database.
+ */
+export declare function savePendingPlan(deps: SQLiteStoreDeps, plan: PendingPlan, sessionId?: string): void;
+/**
+ * Get the pending plan for a session.
+ * Returns the most recent pending plan, or null if none.
+ */
+export declare function getPendingPlan(deps: SQLiteStoreDeps, sessionId?: string): PendingPlan | null;
+/**
+ * Update the status of a pending plan.
+ */
+export declare function updatePlanStatus(deps: SQLiteStoreDeps, planId: string, status: 'approved' | 'rejected' | 'partially_approved'): void;
+/**
+ * Delete a pending plan.
+ */
+export declare function deletePendingPlan(deps: SQLiteStoreDeps, planId: string): void;
+/**
+ * Remember a permission decision.
+ */
+export declare function rememberPermission(deps: SQLiteStoreDeps, toolName: string, decision: 'always' | 'never', pattern?: string): void;
+/**
+ * Get a remembered permission decision.
+ */
+export declare function getRememberedPermission(deps: SQLiteStoreDeps, toolName: string, pattern?: string): {
+    decision: 'always' | 'never';
+    pattern?: string;
+} | undefined;
+/**
+ * List all remembered permission decisions.
+ */
+export declare function listRememberedPermissions(deps: SQLiteStoreDeps): Array<{
+    toolName: string;
+    pattern?: string;
+    decision: 'always' | 'never';
+    createdAt: string;
+}>;
+/**
+ * Remove a remembered permission decision.
+ */
+export declare function forgetPermission(deps: SQLiteStoreDeps, toolName: string, pattern?: string): void;
+/**
+ * Clear all remembered permissions for a tool or all tools.
+ */
+export declare function clearRememberedPermissions(deps: SQLiteStoreDeps, toolName?: string): void;
+/**
+ * Callbacks for manifest export.
+ * These are provided by the SQLiteStore class to bridge to goal/worker repositories.
+ */
+export interface ManifestCallbacks {
+    listGoals(sessionId?: string): Array<{
+        id: string;
+        goalText: string;
+        status: string;
+        priority: number;
+        progressCurrent: number;
+        progressTotal?: number;
+        completedAt?: string;
+    }>;
+    listJunctures(sessionId?: string, limit?: number): Array<{
+        type: string;
+        description: string;
+        outcome?: string;
+        createdAt: string;
+    }>;
+    listWorkerResults(sessionId?: string): Array<{
+        id: string;
+        taskDescription: string;
+        status: string;
+        summary?: string;
+        modelUsed?: string;
+    }>;
+}
+/**
+ * Export a complete session manifest for handoff.
+ * Contains all information needed for another agent/human to pick up the work.
+ */
+export declare function exportSessionManifest(deps: SQLiteStoreDeps, callbacks: ManifestCallbacks, sessionId?: string): SessionManifest | undefined;
+/**
+ * Export session as human-readable markdown.
+ */
+export declare function exportSessionMarkdown(deps: SQLiteStoreDeps, callbacks: ManifestCallbacks, sessionId?: string): string;
+/**
+ * Migrate sessions from JSONL format to SQLite.
+ */
+export declare function migrateFromJSONL(deps: SQLiteStoreDeps, jsonlDir: string): Promise<{
+    migrated: number;
+    failed: number;
+}>;
+/**
+ * Prune old sessions if over limit.
+ */
+export declare function pruneOldSessions(deps: SQLiteStoreDeps): void;
+//# sourceMappingURL=session-repository.d.ts.map

package/dist/src/integrations/persistence/session-repository.d.ts.map

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