@ace-sdk/core 1.0.0

package/dist/cache/session-storage.js

@@ -0,0 +1,237 @@
+/**
+ * Session Storage - Persistent pattern pinning for context compaction
+ *
+ * Allows patterns retrieved during UserPromptSubmit hook to be "pinned" to a session
+ * and later recalled during PreCompact hook without redundant server calls.
+ *
+ * Storage: ~/.ace-cache/sessions.db (SQLite)
+ * TTL: 24 hours (survives cache expiry)
+ *
+ * @package @ace-sdk/core
+ */
+import Database from 'better-sqlite3';
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+export class SessionStorage {
+    db = null;
+    dbPath;
+    logger;
+    static SESSION_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+    constructor(config, logger) {
+        this.logger = logger;
+        // Session storage path: ~/.ace-cache/sessions.db (or custom cacheDir)
+        const cacheDir = config?.cacheDir || join(homedir(), '.ace-cache');
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        this.dbPath = join(cacheDir, 'sessions.db');
+    }
+    /**
+     * Initialize session storage database
+     */
+    async initialize() {
+        try {
+            this.db = new Database(this.dbPath);
+            // Create sessions table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS sessions (
+          session_id TEXT PRIMARY KEY,
+          query TEXT NOT NULL,
+          threshold REAL NOT NULL,
+          top_k INTEGER NOT NULL,
+          created_at INTEGER NOT NULL,
+          expires_at INTEGER NOT NULL
+        )
+      `);
+            // Create session_patterns table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS session_patterns (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          pattern_data TEXT NOT NULL,
+          FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE CASCADE
+        )
+      `);
+            // Create index for faster lookups
+            this.db.exec(`
+        CREATE INDEX IF NOT EXISTS idx_session_expires
+        ON sessions(expires_at)
+      `);
+            // Cleanup expired sessions on initialization
+            await this.cleanupExpiredSessions();
+            this.logger?.debug(`Session storage initialized: ${this.dbPath}`);
+        }
+        catch (error) {
+            this.logger?.error(`Failed to initialize session storage`, error);
+            throw error;
+        }
+    }
+    /**
+     * Pin patterns to a session
+     */
+    async pinSession(sessionId, query, patterns, threshold, topK) {
+        if (!this.db) {
+            throw new Error('Session storage not initialized');
+        }
+        const now = Date.now();
+        const expiresAt = now + SessionStorage.SESSION_TTL_MS;
+        try {
+            // Start transaction
+            const insertSession = this.db.prepare(`
+        INSERT OR REPLACE INTO sessions
+        (session_id, query, threshold, top_k, created_at, expires_at)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `);
+            const insertPattern = this.db.prepare(`
+        INSERT INTO session_patterns (session_id, pattern_data)
+        VALUES (?, ?)
+      `);
+            // Delete existing patterns for this session (if replacing)
+            this.db.prepare('DELETE FROM session_patterns WHERE session_id = ?').run(sessionId);
+            // Insert session metadata
+            insertSession.run(sessionId, query, threshold, topK, now, expiresAt);
+            // Insert patterns
+            for (const pattern of patterns) {
+                insertPattern.run(sessionId, JSON.stringify(pattern));
+            }
+            this.logger?.debug(`Pinned ${patterns.length} patterns to session: ${sessionId} (expires in 24h)`);
+        }
+        catch (error) {
+            this.logger?.error(`Failed to pin session ${sessionId}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Recall patterns for a session
+     */
+    async recallSession(sessionId) {
+        if (!this.db) {
+            throw new Error('Session storage not initialized');
+        }
+        try {
+            // Get session metadata
+            const session = this.db.prepare(`
+        SELECT * FROM sessions WHERE session_id = ?
+      `).get(sessionId);
+            if (!session) {
+                this.logger?.debug(`Session not found: ${sessionId}`);
+                return null;
+            }
+            // Check if expired
+            const now = Date.now();
+            if (now > session.expires_at) {
+                this.logger?.debug(`Session expired: ${sessionId}`);
+                // Cleanup expired session
+                this.db.prepare('DELETE FROM sessions WHERE session_id = ?').run(sessionId);
+                return null;
+            }
+            // Get patterns
+            const patternRows = this.db.prepare(`
+        SELECT pattern_data FROM session_patterns WHERE session_id = ?
+      `).all(sessionId);
+            const patterns = patternRows.map(row => JSON.parse(row.pattern_data));
+            this.logger?.debug(`Recalled ${patterns.length} patterns from session: ${sessionId} ` +
+                `(expires in ${Math.round((session.expires_at - now) / 1000 / 60 / 60)}h)`);
+            return {
+                similar_patterns: patterns,
+                count: patterns.length,
+                threshold: session.threshold,
+                top_k: session.top_k,
+                session_id: sessionId,
+                pinned_at: session.created_at,
+                expires_at: session.expires_at
+            };
+        }
+        catch (error) {
+            this.logger?.error(`Failed to recall session ${sessionId}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Delete a specific session
+     */
+    async deleteSession(sessionId) {
+        if (!this.db) {
+            throw new Error('Session storage not initialized');
+        }
+        try {
+            const result = this.db.prepare('DELETE FROM sessions WHERE session_id = ?').run(sessionId);
+            const deleted = result.changes > 0;
+            if (deleted) {
+                this.logger?.debug(`Deleted session: ${sessionId}`);
+            }
+            return deleted;
+        }
+        catch (error) {
+            this.logger?.error(`Failed to delete session ${sessionId}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Cleanup expired sessions (called on initialization and periodically)
+     */
+    async cleanupExpiredSessions() {
+        if (!this.db) {
+            throw new Error('Session storage not initialized');
+        }
+        try {
+            const now = Date.now();
+            const result = this.db.prepare('DELETE FROM sessions WHERE expires_at < ?').run(now);
+            const deletedCount = result.changes;
+            if (deletedCount > 0) {
+                this.logger?.debug(`Cleaned up ${deletedCount} expired session(s)`);
+            }
+            return deletedCount;
+        }
+        catch (error) {
+            this.logger?.error(`Failed to cleanup expired sessions`, error);
+            throw error;
+        }
+    }
+    /**
+     * List all active sessions
+     */
+    async listSessions() {
+        if (!this.db) {
+            throw new Error('Session storage not initialized');
+        }
+        try {
+            const now = Date.now();
+            const sessions = this.db.prepare(`
+        SELECT
+          s.session_id,
+          s.query,
+          s.created_at,
+          s.expires_at,
+          COUNT(sp.id) as pattern_count
+        FROM sessions s
+        LEFT JOIN session_patterns sp ON s.session_id = sp.session_id
+        WHERE s.expires_at > ?
+        GROUP BY s.session_id
+        ORDER BY s.created_at DESC
+      `).all(now);
+            return sessions.map(s => ({
+                sessionId: s.session_id,
+                query: s.query,
+                patternCount: s.pattern_count,
+                createdAt: s.created_at,
+                expiresAt: s.expires_at
+            }));
+        }
+        catch (error) {
+            this.logger?.error(`Failed to list sessions`, error);
+            throw error;
+        }
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+//# sourceMappingURL=session-storage.js.map

package/dist/cache/session-storage.js.map

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

package/dist/client/ace-client.d.ts

@@ -0,0 +1,199 @@
+/**
+ * ACE Server Client - HTTP REST API client with 3-tier cache
+ *
+ * Architecture:
+ * 1. RAM cache (fastest, lost on restart)
+ * 2. SQLite cache (fast, survives restart)
+ * 3. Remote server (slow, source of truth)
+ *
+ * @package @ace-sdk/core
+ */
+import { AceConfig, AceContext, ServerConfig } from '../types/config.js';
+import { StructuredPlaybook, PlaybookStats, DeltaOperation, PlaybookBullet, SearchResponseWithMetadata, PlaybookResponseWithMetadata, LearningResponse, BootstrapResponse } from '../types/pattern.js';
+import { LocalCacheService } from '../cache/local-cache.js';
+import { ILogger } from '../logger/index.js';
+/**
+ * Options for creating an ACE client
+ */
+export interface AceClientOptions {
+    /** Logger for output (optional - defaults to silent) */
+    logger?: ILogger;
+}
+export declare class AceClient {
+    private config;
+    private localCache;
+    private memoryCache?;
+    private logger;
+    private configCache;
+    private CONFIG_CACHE_TTL;
+    constructor(config: AceConfig | AceContext, options?: AceClientOptions);
+    /**
+     * Extract org_id from API token
+     * Format: ace_{base64_with_org_id}
+     */
+    private extractOrgId;
+    private request;
+    /**
+     * Save structured playbook to server
+     * Server endpoint: POST /patterns (saves individual bullets)
+     */
+    savePlaybook(playbook: StructuredPlaybook): Promise<void>;
+    /**
+     * Get structured playbook (3-tier cache: RAM → SQLite → Server)
+     * Endpoint: GET /playbook
+     */
+    getPlaybook(params?: {
+        forceRefresh?: boolean;
+        include_metadata?: boolean;
+    }): Promise<PlaybookResponseWithMetadata>;
+    /**
+     * Count total bullets across all playbook sections
+     */
+    private countBullets;
+    /**
+     * Compute embeddings for texts (with SQLite cache if available)
+     * Endpoint: POST /embeddings
+     */
+    computeEmbeddings(texts: string[]): Promise<number[][]>;
+    /**
+     * Semantic search for relevant patterns
+     * Endpoint: POST /patterns/search
+     */
+    searchPatterns(params: {
+        query: string;
+        section?: string;
+        threshold?: number;
+        top_k?: number;
+        include_metadata?: boolean;
+    }): Promise<SearchResponseWithMetadata>;
+    /**
+     * Get top patterns by helpful score
+     * Endpoint: GET /patterns/top
+     */
+    getTopPatterns(params: {
+        section?: string;
+        limit?: number;
+        min_helpful?: number;
+    }): Promise<PlaybookBullet[]>;
+    /**
+     * Get playbook analytics
+     * Endpoint: GET /analytics
+     */
+    getAnalytics(): Promise<PlaybookStats>;
+    /**
+     * Clear entire playbook
+     * Server endpoint: DELETE /patterns
+     */
+    clearPlaybook(): Promise<void>;
+    /**
+     * Apply delta operation (ADD/UPDATE/DELETE)
+     * Server endpoint: POST /delta
+     */
+    applyDelta(operation: DeltaOperation): Promise<void>;
+    /**
+     * Apply multiple delta operations in batch
+     */
+    applyDeltas(operations: DeltaOperation[]): Promise<void>;
+    /**
+     * Store execution trace for server-side analysis
+     * Server endpoint: POST /traces
+     */
+    storeExecutionTrace(trace: any): Promise<LearningResponse>;
+    /**
+     * Bootstrap playbook from extracted code blocks
+     * Server endpoint: POST /bootstrap
+     */
+    bootstrap(params: {
+        mode: string;
+        code_blocks: string[];
+        metadata: {
+            files_scanned?: number;
+            blocks_extracted?: number;
+            thoroughness?: string;
+            file_extensions?: string[];
+        };
+    }): Promise<BootstrapResponse>;
+    /**
+     * Initialize playbook from git repository (server-side)
+     * Server endpoint: POST /init
+     */
+    initializeFromRepo(params: {
+        repo_path: string;
+        commit_limit: number;
+        days_back: number;
+        merge_with_existing: boolean;
+    }): Promise<any>;
+    /**
+     * Get playbook status/statistics
+     * Server endpoint: GET /analytics
+     */
+    getStatus(): Promise<PlaybookStats>;
+    /**
+     * Invalidate caches (force refresh on next call)
+     */
+    invalidateCache(): void;
+    /**
+     * Get server configuration with caching (v3.6.0+)
+     * Server endpoint: GET /api/v1/config
+     */
+    getConfig(useCache?: boolean): Promise<ServerConfig>;
+    /**
+     * Verify API token and fetch organization info
+     * Server endpoint: GET /api/v1/config/verify
+     */
+    verifyToken(): Promise<{
+        org_id: string;
+        org_name: string;
+        projects: Array<{
+            project_id: string;
+            project_name: string;
+        }>;
+    }>;
+    /**
+     * Batch retrieve patterns by ID (v3.6.0+)
+     * Server endpoint: POST /patterns/batch
+     */
+    batchGetPatterns(patternIds: string[]): Promise<{
+        patterns: PlaybookBullet[];
+        found_count: number;
+        not_found: string[];
+    }>;
+    /**
+     * Summarize a recorded session
+     * Server endpoint: POST /api/v1/summarize
+     */
+    summarizeSession(sessionData: any): Promise<{
+        session_id: string;
+        summary: string;
+        key_events: Array<{
+            timestamp: string;
+            type: string;
+            description: string;
+        }>;
+        insights: string[];
+        duration_ms: number;
+        event_count: number;
+    }>;
+    /**
+     * Clear config cache
+     */
+    clearConfigCache(): void;
+    /**
+     * Get local cache instance
+     */
+    getLocalCache(): LocalCacheService | null;
+    /**
+     * Update server configuration (v3.6.0+)
+     * Server endpoint: PUT /api/v1/config?scope=project
+     */
+    updateConfig(settings: Record<string, any>, scope?: 'project'): Promise<ServerConfig>;
+    /**
+     * Reset server configuration to defaults (v3.9.0+)
+     * Server endpoint: POST /api/v1/config/reset?scope=project
+     */
+    resetConfig(scope?: 'project'): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=ace-client.d.ts.map

package/dist/client/ace-client.d.ts.map

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