@aetherai/aether 0.0.7 → 0.0.9

package/dist/CLI/packages/core/src/services/chatRecordingService.js

@@ -1,289 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import {} from '../config/config.js';
-import path from 'node:path';
-import fs from 'node:fs';
-import { randomUUID } from 'node:crypto';
-import { createUserContent, createModelContent, } from '@google/genai';
-import * as jsonl from '../utils/jsonl-utils.js';
-import { getGitBranch } from '../utils/gitUtils.js';
-import { createDebugLogger } from '../utils/debugLogger.js';
-const debugLogger = createDebugLogger('CHAT_RECORDING');
-/**
- * Service for recording the current chat session to disk.
- *
- * This service provides comprehensive conversation recording that captures:
- * - All user and assistant messages
- * - Tool calls and their execution results
- * - Token usage statistics
- * - Assistant thoughts and reasoning
- *
- * **API Design:**
- * - `recordUserMessage()` - Records a user message (immediate write)
- * - `recordAssistantTurn()` - Records an assistant turn with all data (immediate write)
- * - `recordToolResult()` - Records tool results (immediate write)
- *
- * **Storage Format:** JSONL files with tree-structured records.
- * Each record has uuid/parentUuid fields enabling:
- * - Append-only writes (never rewrite the file)
- * - Linear history reconstruction
- * - Future checkpointing (branch from any historical point)
- *
- * File location: ~/.aether/tmp/<project_id>/chats/
- *
- * For session management (list, load, remove), use SessionService.
- */
-export class ChatRecordingService {
-    /** UUID of the last written record in the chain */
-    lastRecordUuid = null;
-    config;
-    constructor(config) {
-        this.config = config;
-        this.lastRecordUuid =
-            config.getResumedSessionData()?.lastCompletedUuid ?? null;
-    }
-    /**
-     * Returns the session ID.
-     * @returns The session ID.
-     */
-    getSessionId() {
-        return this.config.getSessionId();
-    }
-    /**
-     * Ensures the chats directory exists, creating it if it doesn't exist.
-     * @returns The path to the chats directory.
-     * @throws Error if the directory cannot be created.
-     */
-    ensureChatsDir() {
-        const projectDir = this.config.storage.getProjectDir();
-        const chatsDir = path.join(projectDir, 'chats');
-        try {
-            fs.mkdirSync(chatsDir, { recursive: true });
-        }
-        catch {
-            // Ignore errors - directory will be created if it doesn't exist
-        }
-        return chatsDir;
-    }
-    /**
-     * Ensures the conversation file exists, creating it if it doesn't exist.
-     * Uses atomic file creation to avoid race conditions.
-     * @returns The path to the conversation file.
-     * @throws Error if the file cannot be created or accessed.
-     */
-    ensureConversationFile() {
-        const chatsDir = this.ensureChatsDir();
-        const sessionId = this.getSessionId();
-        const safeFilename = `${sessionId}.jsonl`;
-        const conversationFile = path.join(chatsDir, safeFilename);
-        if (fs.existsSync(conversationFile)) {
-            return conversationFile;
-        }
-        try {
-            // Use 'wx' flag for exclusive creation - atomic operation that fails if file exists
-            // This avoids the TOCTOU race condition of existsSync + writeFileSync
-            fs.writeFileSync(conversationFile, '', { flag: 'wx', encoding: 'utf8' });
-        }
-        catch (error) {
-            const nodeError = error;
-            // EEXIST means file already exists, which is expected and fine
-            if (nodeError.code !== 'EEXIST') {
-                const message = error instanceof Error ? error.message : String(error);
-                throw new Error(`Failed to create conversation file at ${conversationFile}: ${message}`);
-            }
-        }
-        return conversationFile;
-    }
-    /**
-     * Creates base fields for a ChatRecord.
-     */
-    createBaseRecord(type) {
-        return {
-            uuid: randomUUID(),
-            parentUuid: this.lastRecordUuid,
-            sessionId: this.getSessionId(),
-            timestamp: new Date().toISOString(),
-            type,
-            cwd: this.config.getProjectRoot(),
-            version: this.config.getCliVersion() || 'unknown',
-            gitBranch: getGitBranch(this.config.getProjectRoot()),
-        };
-    }
-    /**
-     * Appends a record to the session file and updates lastRecordUuid.
-     */
-    appendRecord(record) {
-        try {
-            const conversationFile = this.ensureConversationFile();
-            jsonl.writeLineSync(conversationFile, record);
-            this.lastRecordUuid = record.uuid;
-        }
-        catch (error) {
-            debugLogger.error('Error appending record:', error);
-            throw error;
-        }
-    }
-    /**
-     * Records a user message.
-     * Writes immediately to disk.
-     *
-     * @param message The raw PartListUnion object as used with the API
-     */
-    recordUserMessage(message) {
-        try {
-            const record = {
-                ...this.createBaseRecord('user'),
-                message: createUserContent(message),
-            };
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving user message:', error);
-        }
-    }
-    /**
-     * Records an assistant turn with all available data.
-     * Writes immediately to disk.
-     *
-     * @param data.message The raw PartListUnion object from the model response
-     * @param data.model The model name
-     * @param data.tokens Token usage statistics
-     * @param data.contextWindowSize Context window size of the model
-     * @param data.toolCallsMetadata Enriched tool call info for UI recovery
-     */
-    recordAssistantTurn(data) {
-        try {
-            const record = {
-                ...this.createBaseRecord('assistant'),
-                model: data.model,
-            };
-            if (data.message !== undefined) {
-                record.message = createModelContent(data.message);
-            }
-            if (data.tokens) {
-                record.usageMetadata = data.tokens;
-            }
-            if (data.contextWindowSize !== undefined) {
-                record.contextWindowSize = data.contextWindowSize;
-            }
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving assistant turn:', error);
-        }
-    }
-    /**
-     * Records tool results (function responses) sent back to the model.
-     * Writes immediately to disk.
-     *
-     * @param message The raw PartListUnion object with functionResponse parts
-     * @param toolCallResult Optional tool call result info for UI recovery
-     */
-    recordToolResult(message, toolCallResult) {
-        try {
-            const record = {
-                ...this.createBaseRecord('tool_result'),
-                message: createUserContent(message),
-            };
-            if (toolCallResult) {
-                // special case for task executions - we don't want to record the tool calls
-                if (typeof toolCallResult.resultDisplay === 'object' &&
-                    toolCallResult.resultDisplay !== null &&
-                    'type' in toolCallResult.resultDisplay &&
-                    toolCallResult.resultDisplay.type === 'task_execution') {
-                    const taskResult = toolCallResult.resultDisplay;
-                    record.toolCallResult = {
-                        ...toolCallResult,
-                        resultDisplay: {
-                            ...taskResult,
-                            toolCalls: [],
-                        },
-                    };
-                }
-                else {
-                    record.toolCallResult = toolCallResult;
-                }
-            }
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving tool result:', error);
-        }
-    }
-    /**
-     * Records a slash command invocation as a system record. This keeps the model
-     * history clean while allowing resume to replay UI output for commands like
-     * /about.
-     */
-    recordSlashCommand(payload) {
-        try {
-            const record = {
-                ...this.createBaseRecord('system'),
-                type: 'system',
-                subtype: 'slash_command',
-                systemPayload: payload,
-            };
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving slash command record:', error);
-        }
-    }
-    /**
-     * Records a chat compression checkpoint as a system record. This keeps the UI
-     * history immutable while allowing resume/continue flows to reconstruct the
-     * compressed model-facing history from the stored snapshot.
-     */
-    recordChatCompression(payload) {
-        try {
-            const record = {
-                ...this.createBaseRecord('system'),
-                type: 'system',
-                subtype: 'chat_compression',
-                systemPayload: payload,
-            };
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving chat compression record:', error);
-        }
-    }
-    /**
-     * Records a UI telemetry event for replaying metrics on resume.
-     */
-    recordUiTelemetryEvent(uiEvent) {
-        try {
-            const record = {
-                ...this.createBaseRecord('system'),
-                type: 'system',
-                subtype: 'ui_telemetry',
-                systemPayload: { uiEvent },
-            };
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving ui telemetry record:', error);
-        }
-    }
-    /**
-     * Records @-command metadata as a system record for UI reconstruction.
-     */
-    recordAtCommand(payload) {
-        try {
-            const record = {
-                ...this.createBaseRecord('system'),
-                type: 'system',
-                subtype: 'at_command',
-                systemPayload: payload,
-            };
-            this.appendRecord(record);
-        }
-        catch (error) {
-            debugLogger.error('Error saving @-command record:', error);
-        }
-    }
-}
-//# sourceMappingURL=chatRecordingService.js.map

package/dist/CLI/packages/core/src/services/chatRecordingService.js.map

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

package/dist/CLI/packages/core/src/services/cronScheduler.d.ts

@@ -1,63 +0,0 @@
-/**
- * In-session cron scheduler. Jobs live in memory and are gone when the
- * process exits. Ticks every second, fires callbacks when jobs are due.
- */
-export interface CronJob {
-    id: string;
-    cronExpr: string;
-    prompt: string;
-    recurring: boolean;
-    createdAt: number;
-    expiresAt: number;
-    lastFiredAt?: number;
-    jitterMs: number;
-}
-export declare class CronScheduler {
-    private jobs;
-    private timer;
-    private onFire;
-    /**
-     * Creates a new cron job. Returns the created job.
-     * Throws if the max job limit is reached.
-     */
-    create(cronExpr: string, prompt: string, recurring: boolean): CronJob;
-    /**
-     * Deletes a job by ID. Returns true if the job existed.
-     */
-    delete(id: string): boolean;
-    /**
-     * Returns all active jobs.
-     */
-    list(): CronJob[];
-    /**
-     * Returns the number of active jobs.
-     */
-    get size(): number;
-    /**
-     * Starts the scheduler tick. Calls `onFire` when a job is due.
-     * Only fires when called — does not auto-fire missed intervals.
-     */
-    start(onFire: (job: CronJob) => void): void;
-    /**
-     * Stops the scheduler. Does not clear jobs — they remain queryable.
-     */
-    stop(): void;
-    /**
-     * Returns true if the scheduler is running.
-     */
-    get running(): boolean;
-    /**
-     * Manual tick — checks all jobs against the current time and fires those
-     * that are due. Exported for testing.
-     */
-    tick(now?: Date): void;
-    /**
-     * Returns a human-readable summary of active jobs for display on session
-     * exit. Returns null if there are no active jobs.
-     */
-    getExitSummary(): string | null;
-    /**
-     * Clears all jobs and stops the scheduler.
-     */
-    destroy(): void;
-}

package/dist/CLI/packages/core/src/services/cronScheduler.js

@@ -1,233 +0,0 @@
-/**
- * In-session cron scheduler. Jobs live in memory and are gone when the
- * process exits. Ticks every second, fires callbacks when jobs are due.
- */
-import { matches, nextFireTime } from '../utils/cronParser.js';
-import { humanReadableCron } from '../utils/cronDisplay.js';
-const MAX_JOBS = 50;
-const THREE_DAYS_MS = 3 * 24 * 60 * 60 * 1000;
-// Recurring: up to 10% of period, capped at 15 minutes.
-const MAX_RECURRING_JITTER_MS = 15 * 60 * 1000;
-// One-shot: up to 90s early for jobs landing on :00 or :30.
-const MAX_ONESHOT_JITTER_MS = 90 * 1000;
-/**
- * Deterministic hash from a string ID, returned as a positive integer.
- */
-function hashId(id) {
-    let hash = 0;
-    for (let i = 0; i < id.length; i++) {
-        hash = (hash * 31 + id.charCodeAt(i)) | 0;
-    }
-    return Math.abs(hash);
-}
-/**
- * Derives a deterministic jitter offset from a job ID and its cron period.
- * Recurring jobs: up to 10% of period, capped at 15 minutes (added after fire time).
- * One-shot jobs landing on :00 or :30: up to 90s early (subtracted before fire time).
- * Other one-shot jobs: 0 jitter.
- */
-function computeJitter(id, cronExpr, recurring) {
-    const hash = hashId(id);
-    if (recurring) {
-        // Estimate period by computing two consecutive fire times
-        const now = new Date();
-        try {
-            const first = nextFireTime(cronExpr, now);
-            const second = nextFireTime(cronExpr, first);
-            const periodMs = second.getTime() - first.getTime();
-            const tenPercent = periodMs * 0.1;
-            const maxJitter = Math.min(tenPercent, MAX_RECURRING_JITTER_MS);
-            return hash % Math.max(1, Math.floor(maxJitter));
-        }
-        catch {
-            return 0;
-        }
-    }
-    // One-shot: apply up to 90s early jitter only when minute is :00 or :30
-    try {
-        const fields = cronExpr.trim().split(/\s+/);
-        const minuteField = fields[0] ?? '';
-        const minuteVal = parseInt(minuteField, 10);
-        if (!isNaN(minuteVal) && (minuteVal === 0 || minuteVal === 30)) {
-            // Negative jitter = fire early
-            return -(hash % MAX_ONESHOT_JITTER_MS);
-        }
-    }
-    catch {
-        // fall through
-    }
-    return 0;
-}
-function generateId() {
-    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
-    let id = '';
-    for (let i = 0; i < 8; i++) {
-        id += chars[Math.floor(Math.random() * chars.length)];
-    }
-    return id;
-}
-export class CronScheduler {
-    jobs = new Map();
-    timer = null;
-    onFire = null;
-    /**
-     * Creates a new cron job. Returns the created job.
-     * Throws if the max job limit is reached.
-     */
-    create(cronExpr, prompt, recurring) {
-        if (this.jobs.size >= MAX_JOBS) {
-            throw new Error(`Maximum number of cron jobs (${MAX_JOBS}) reached. Delete some jobs first.`);
-        }
-        const id = generateId();
-        const now = Date.now();
-        const jitterMs = computeJitter(id, cronExpr, recurring);
-        const job = {
-            id,
-            cronExpr,
-            prompt,
-            recurring,
-            createdAt: now,
-            expiresAt: recurring ? now + THREE_DAYS_MS : Infinity,
-            jitterMs,
-        };
-        this.jobs.set(id, job);
-        return job;
-    }
-    /**
-     * Deletes a job by ID. Returns true if the job existed.
-     */
-    delete(id) {
-        return this.jobs.delete(id);
-    }
-    /**
-     * Returns all active jobs.
-     */
-    list() {
-        return [...this.jobs.values()];
-    }
-    /**
-     * Returns the number of active jobs.
-     */
-    get size() {
-        return this.jobs.size;
-    }
-    /**
-     * Starts the scheduler tick. Calls `onFire` when a job is due.
-     * Only fires when called — does not auto-fire missed intervals.
-     */
-    start(onFire) {
-        this.onFire = onFire;
-        if (this.timer)
-            return; // already running
-        this.timer = setInterval(() => {
-            this.tick();
-        }, 1000);
-    }
-    /**
-     * Stops the scheduler. Does not clear jobs — they remain queryable.
-     */
-    stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        this.onFire = null;
-    }
-    /**
-     * Returns true if the scheduler is running.
-     */
-    get running() {
-        return this.timer !== null;
-    }
-    /**
-     * Manual tick — checks all jobs against the current time and fires those
-     * that are due. Exported for testing.
-     */
-    tick(now) {
-        const currentDate = now ?? new Date();
-        const currentMs = currentDate.getTime();
-        for (const job of this.jobs.values()) {
-            // Check expiry
-            if (currentMs >= job.expiresAt) {
-                this.jobs.delete(job.id);
-                continue;
-            }
-            // Find the cron minute whose jittered fire time we might be in.
-            // For positive jitter (recurring) the fire time is *after* the matching
-            // minute, so we look backwards.  For negative jitter (one-shot :00/:30)
-            // the fire time is *before* the matching minute, so we look at the
-            // current minute.
-            //
-            // We scan a window of minutes around `now` equal to the absolute jitter
-            // so that a +6 min jitter on an hourly job still finds the :00 match.
-            const absJitter = Math.abs(job.jitterMs);
-            const windowMinutes = Math.ceil(absJitter / 60_000);
-            // Build the candidate minute-start at the beginning of the current minute
-            const nowMinuteStart = new Date(currentDate);
-            nowMinuteStart.setSeconds(0, 0);
-            const nowMinuteMs = nowMinuteStart.getTime();
-            let matchedMinuteMs = null;
-            // Scan from (now - windowMinutes) to (now) for positive jitter,
-            // or (now) to (now + windowMinutes) for negative jitter.
-            // In practice we scan both directions to keep the code simple.
-            for (let offset = -windowMinutes; offset <= windowMinutes; offset++) {
-                const candidateMs = nowMinuteMs + offset * 60_000;
-                const candidateDate = new Date(candidateMs);
-                if (!matches(job.cronExpr, candidateDate))
-                    continue;
-                const fireTimeMs = candidateMs + job.jitterMs;
-                if (currentMs >= fireTimeMs) {
-                    // This candidate's jittered fire time has passed — it's a match.
-                    // Pick the latest matching minute to avoid re-triggering old ones.
-                    if (matchedMinuteMs === null || candidateMs > matchedMinuteMs) {
-                        matchedMinuteMs = candidateMs;
-                    }
-                }
-            }
-            if (matchedMinuteMs === null) {
-                continue; // No matching minute whose jittered time has arrived
-            }
-            // Prevent double-firing: compare against the cron minute we last fired for
-            if (job.lastFiredAt !== undefined &&
-                job.lastFiredAt === matchedMinuteMs) {
-                continue; // Already fired for this cron minute
-            }
-            // Fire! Record the matched cron minute (not wall-clock time) so the
-            // double-fire guard works when jitter pushes the fire into a later minute.
-            job.lastFiredAt = matchedMinuteMs;
-            if (!job.recurring) {
-                this.jobs.delete(job.id);
-            }
-            if (this.onFire) {
-                this.onFire(job);
-            }
-        }
-    }
-    /**
-     * Returns a human-readable summary of active jobs for display on session
-     * exit. Returns null if there are no active jobs.
-     */
-    getExitSummary() {
-        if (this.jobs.size === 0)
-            return null;
-        const count = this.jobs.size;
-        const lines = [
-            `Session ending. ${count} active loop${count === 1 ? '' : 's'} cancelled:`,
-        ];
-        for (const job of this.jobs.values()) {
-            const schedule = humanReadableCron(job.cronExpr);
-            // Truncate long prompts
-            const prompt = job.prompt.length > 60 ? job.prompt.slice(0, 57) + '...' : job.prompt;
-            lines.push(`  - [${job.id}] ${schedule}: ${prompt}`);
-        }
-        return lines.join('\n');
-    }
-    /**
-     * Clears all jobs and stops the scheduler.
-     */
-    destroy() {
-        this.stop();
-        this.jobs.clear();
-    }
-}
-//# sourceMappingURL=cronScheduler.js.map

package/dist/CLI/packages/core/src/services/cronScheduler.js.map

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

package/dist/CLI/packages/core/src/services/fileDiscoveryService.d.ts

@@ -1,46 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-export interface FilterFilesOptions {
-    respectGitIgnore?: boolean;
-    respectAetherIgnore?: boolean;
-    respectQwenIgnore?: boolean;
-}
-export interface FilterReport {
-    filteredPaths: string[];
-    gitIgnoredCount: number;
-    aetherIgnoredCount: number;
-}
-export declare class FileDiscoveryService {
-    private gitIgnoreFilter;
-    private aetherIgnoreFilter;
-    private projectRoot;
-    constructor(projectRoot: string);
-    /**
-     * Filters a list of file paths based on git ignore rules
-     */
-    filterFiles(filePaths: string[], options?: FilterFilesOptions): string[];
-    /**
-     * Filters a list of file paths based on git ignore rules and returns a report
-     * with counts of ignored files.
-     */
-    filterFilesWithReport(filePaths: string[], opts?: FilterFilesOptions): FilterReport;
-    /**
-     * Checks if a single file should be git-ignored
-     */
-    shouldGitIgnoreFile(filePath: string): boolean;
-    /**
-     * Checks if a single file should be aether-ignored
-     */
-    shouldAetherIgnoreFile(filePath: string): boolean;
-    /**
-     * Unified method to check if a file should be ignored based on filtering options
-     */
-    shouldIgnoreFile(filePath: string, options?: FilterFilesOptions): boolean;
-    /**
-     * Returns loaded patterns from .aetherignore
-     */
-    getAetherIgnorePatterns(): string[];
-}