sudocode 1.1.20 → 1.1.22

package/node_modules/@sudocode-ai/local-server/dist/services/execution-logs-store.d.ts

@@ -1,312 +0,0 @@
-/**
- * ExecutionLogsStore Service
- *
- * Manages persistence of raw execution logs to the database.
- * Provides CRUD operations for execution_logs table.
- *
- * Supports two log formats:
- * - ACP (CoalescedSessionUpdate): Modern format stored in raw_logs column
- * - Legacy (NormalizedEntry): Legacy format stored in normalized_entry column
- *
- * @module services/execution-logs-store
- */
-import type Database from "better-sqlite3";
-import type { NormalizedEntry } from "agent-execution-engine/agents";
-import type { CoalescedSessionUpdate } from "../execution/output/coalesced-types.js";
-/**
- * Log format type for detection
- */
-export type LogFormat = "acp" | "normalized_entry" | "empty";
-/**
- * Metadata for execution logs (without the full logs text)
- */
-export interface LogMetadata {
-    execution_id: string;
-    byte_size: number;
-    line_count: number;
-    created_at: string;
-    updated_at: string;
-}
-/**
- * Statistics about all execution logs
- */
-export interface LogStats {
-    totalExecutions: number;
-    totalBytes: number;
-    totalLines: number;
-    avgLinesPerExecution: number;
-    avgBytesPerExecution: number;
-}
-/**
- * ExecutionLogsStore - Database service for execution logs
- *
- * Provides methods to store and retrieve raw agent output logs in NDJSON format.
- * All logs are stored as newline-delimited JSON strings for efficient append operations.
- *
- * @example
- * ```typescript
- * const store = new ExecutionLogsStore(db);
- * store.initializeLogs('exec-123');
- * store.appendRawLog('exec-123', '{"type":"assistant","message":{...}}');
- * const logs = store.getRawLogs('exec-123');
- * ```
- */
-export declare class ExecutionLogsStore {
-    private db;
-    constructor(db: Database.Database);
-    /**
-     * Initialize empty log entry for a new execution
-     *
-     * Creates a new row in execution_logs with empty raw_logs.
-     * Uses INSERT OR IGNORE so calling multiple times is safe.
-     *
-     * @param executionId - Unique execution identifier
-     *
-     * @example
-     * ```typescript
-     * store.initializeLogs('exec-123');
-     * ```
-     */
-    initializeLogs(executionId: string): void;
-    /**
-     * Append a single log line to an execution
-     *
-     * Appends the line with a newline character and updates metadata.
-     * Uses prepared statement for performance.
-     *
-     * @param executionId - Unique execution identifier
-     * @param line - Raw log line (NDJSON format, no trailing newline)
-     *
-     * @example
-     * ```typescript
-     * store.appendRawLog('exec-123', '{"type":"assistant","message":{...}}');
-     * ```
-     */
-    appendRawLog(executionId: string, line: string): void;
-    /**
-     * Append multiple log lines in a single transaction
-     *
-     * More efficient than calling appendRawLog multiple times.
-     * Uses transaction for atomicity - all lines added or none.
-     *
-     * @param executionId - Unique execution identifier
-     * @param lines - Array of raw log lines
-     *
-     * @example
-     * ```typescript
-     * store.appendRawLogs('exec-123', [
-     *   '{"type":"assistant",...}',
-     *   '{"type":"tool_result",...}'
-     * ]);
-     * ```
-     */
-    appendRawLogs(executionId: string, lines: string[]): void;
-    /**
-     * Retrieve all raw logs for an execution
-     *
-     * Returns logs as an array of individual log lines (NDJSON).
-     * Empty lines are filtered out.
-     *
-     * @param executionId - Unique execution identifier
-     * @returns Array of log lines, or empty array if execution not found
-     *
-     * @example
-     * ```typescript
-     * const logs = store.getRawLogs('exec-123');
-     * logs.forEach(line => {
-     *   const message = JSON.parse(line);
-     *   console.log(message.type);
-     * });
-     * ```
-     */
-    getRawLogs(executionId: string): string[];
-    /**
-     * Get metadata for an execution without fetching full logs
-     *
-     * Useful for displaying log size/count without loading entire log content.
-     *
-     * @param executionId - Unique execution identifier
-     * @returns Metadata object or null if execution not found
-     *
-     * @example
-     * ```typescript
-     * const metadata = store.getLogMetadata('exec-123');
-     * if (metadata) {
-     *   console.log(`${metadata.line_count} lines, ${metadata.byte_size} bytes`);
-     * }
-     * ```
-     */
-    getLogMetadata(executionId: string): LogMetadata | null;
-    /**
-     * Delete logs for an execution
-     *
-     * Removes the entire log entry from the database.
-     * Foreign key constraint ensures execution must exist.
-     *
-     * @param executionId - Unique execution identifier
-     *
-     * @example
-     * ```typescript
-     * store.deleteLogs('exec-123');
-     * ```
-     */
-    deleteLogs(executionId: string): void;
-    /**
-     * Prune old execution logs based on age
-     *
-     * Deletes logs for completed/failed/cancelled executions older than threshold.
-     * Only removes logs where the execution has reached a terminal state.
-     *
-     * @param olderThanMs - Age threshold in milliseconds
-     * @returns Number of log entries deleted
-     *
-     * @example
-     * ```typescript
-     * // Delete logs older than 30 days
-     * const deleted = store.pruneOldLogs(30 * 24 * 60 * 60 * 1000);
-     * console.log(`Pruned ${deleted} old execution logs`);
-     * ```
-     */
-    pruneOldLogs(olderThanMs: number): number;
-    /**
-     * Get aggregate statistics about all execution logs
-     *
-     * Provides overview of total storage usage and averages.
-     *
-     * @returns Statistics object with totals and averages
-     *
-     * @example
-     * ```typescript
-     * const stats = store.getStats();
-     * console.log(`Total storage: ${stats.totalBytes} bytes`);
-     * console.log(`Average: ${stats.avgLinesPerExecution} lines/execution`);
-     * ```
-     */
-    getStats(): LogStats;
-    /**
-     * Append a normalized entry to execution logs
-     *
-     * Stores a NormalizedEntry object from agent-execution-engine as JSON.
-     * The entry is stored in the normalized_entry column alongside raw logs.
-     *
-     * @param executionId - Unique execution identifier
-     * @param entry - Normalized entry object from agent-execution-engine
-     *
-     * @example
-     * ```typescript
-     * const entry: NormalizedEntry = {
-     *   index: 0,
-     *   type: { kind: 'assistant_message' },
-     *   content: 'Hello world',
-     *   timestamp: new Date(),
-     * };
-     * store.appendNormalizedEntry('exec-123', entry);
-     * ```
-     */
-    appendNormalizedEntry(executionId: string, entry: NormalizedEntry): void;
-    /**
-     * Get all normalized entries for an execution
-     *
-     * Retrieves and deserializes all normalized entries for an execution.
-     * Entries are returned in the order they were stored.
-     *
-     * @param executionId - Unique execution identifier
-     * @returns Array of normalized entries, or empty array if none found
-     *
-     * @example
-     * ```typescript
-     * const entries = store.getNormalizedEntries('exec-123');
-     * entries.forEach(entry => {
-     *   console.log(entry.type.kind, entry.content);
-     * });
-     * ```
-     */
-    getNormalizedEntries(executionId: string): NormalizedEntry[];
-    /**
-     * Check if execution has normalized entries
-     *
-     * Useful for determining which log format to use during migration period.
-     *
-     * @param executionId - Unique execution identifier
-     * @returns true if execution has at least one normalized entry
-     *
-     * @example
-     * ```typescript
-     * if (store.hasNormalizedEntries('exec-123')) {
-     *   const entries = store.getNormalizedEntries('exec-123');
-     * } else {
-     *   const logs = store.getRawLogs('exec-123');
-     * }
-     * ```
-     */
-    hasNormalizedEntries(executionId: string): boolean;
-    /**
-     * Get entry count by kind for an execution
-     *
-     * Analyzes normalized entries and returns statistics about entry types.
-     * Useful for analytics, debugging, and monitoring.
-     *
-     * @param executionId - Unique execution identifier
-     * @returns Object mapping entry kinds to their counts
-     *
-     * @example
-     * ```typescript
-     * const stats = store.getEntryStats('exec-123');
-     * console.log(stats);
-     * // { assistant_message: 5, tool_use: 3, error: 1 }
-     * ```
-     */
-    getEntryStats(executionId: string): Record<string, number>;
-    /**
-     * Detect the log format for an execution
-     *
-     * Checks which column has data and inspects the first line to determine format:
-     * - 'acp': raw_logs contains CoalescedSessionUpdate (has 'sessionUpdate' key)
-     * - 'normalized_entry': normalized_entry column has NormalizedEntry (has 'type.kind')
-     * - 'empty': No logs found
-     *
-     * @param executionId - Unique execution identifier
-     * @returns The detected log format
-     *
-     * @example
-     * ```typescript
-     * const format = store.detectLogFormat('exec-123');
-     * if (format === 'acp') {
-     *   const logs = store.getCoalescedLogs('exec-123');
-     * }
-     * ```
-     */
-    detectLogFormat(executionId: string): LogFormat;
-    /**
-     * Get logs as CoalescedSessionUpdate array (unified format)
-     *
-     * Automatically detects the storage format and converts to CoalescedSessionUpdate.
-     * - For ACP logs: Deserializes directly from raw_logs
-     * - For legacy logs: Converts NormalizedEntry to CoalescedSessionUpdate
-     *
-     * @param executionId - Unique execution identifier
-     * @returns Array of CoalescedSessionUpdate events
-     *
-     * @example
-     * ```typescript
-     * const logs = store.getCoalescedLogs('exec-123');
-     * logs.forEach(event => {
-     *   console.log(event.sessionUpdate, event);
-     * });
-     * ```
-     */
-    getCoalescedLogs(executionId: string): CoalescedSessionUpdate[];
-    /**
-     * Get ACP logs directly from raw_logs column
-     *
-     * @private
-     */
-    private getAcpLogs;
-    /**
-     * Convert legacy NormalizedEntry logs to CoalescedSessionUpdate
-     *
-     * @private
-     */
-    private convertLegacyLogs;
-}
-//# sourceMappingURL=execution-logs-store.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/services/execution-logs-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execution-logs-store.d.ts","sourceRoot":"","sources":["../../src/services/execution-logs-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAOrF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAerD;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAUzD;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAezC;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUvD;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOrC;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAmBzC;;;;;;;;;;;;;OAaG;IACH,QAAQ,IAAI,QAAQ;IA8BpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IA4BxE;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE;IAiC5D;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAalD;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgB1D;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAkD/C;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAgB/D;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAqBlB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAa1B"}