lattice-orchestrator 0.7.0

package/dist/services/notification-service.js

@@ -0,0 +1,184 @@
+import { createLogger } from './infrastructure/logger.js';
+import { ConfigService } from './infrastructure/config-service.js';
+import { WebPushService } from './web-push-service.js';
+/**
+ * Service for sending push notifications via ntfy.sh
+ */
+export class NotificationService {
+    logger;
+    configService;
+    machineId = null;
+    webPushService;
+    constructor() {
+        this.logger = createLogger('NotificationService');
+        this.configService = ConfigService.getInstance();
+        this.webPushService = WebPushService.getInstance();
+    }
+    /**
+     * Get machine ID from config
+     */
+    getMachineId() {
+        if (!this.machineId) {
+            try {
+                const config = this.configService.getConfig();
+                this.machineId = config.machine_id;
+            }
+            catch (error) {
+                this.logger.error('Failed to get machine ID from config', error);
+                this.machineId = 'unknown';
+            }
+        }
+        return this.machineId;
+    }
+    /**
+     * Check if notifications are enabled
+     */
+    async isEnabled() {
+        const config = this.configService.getConfig();
+        return config.interface.notifications?.enabled ?? false;
+    }
+    /**
+     * Get the ntfy URL from preferences
+     */
+    async getNtfyUrl() {
+        const config = this.configService.getConfig();
+        return config.interface.notifications?.ntfyUrl || 'https://ntfy.sh';
+    }
+    /**
+     * Send a notification for a permission request
+     */
+    async sendPermissionNotification(request, sessionId, summary) {
+        if (!(await this.isEnabled())) {
+            this.logger.debug('Notifications disabled, skipping permission notification');
+            return;
+        }
+        try {
+            const machineId = this.getMachineId();
+            const topic = `claudia-${machineId}`;
+            const ntfyUrl = await this.getNtfyUrl();
+            const notification = {
+                title: 'Claudia Permission Request',
+                message: summary
+                    ? `${summary} - ${request.toolName}`
+                    : `${request.toolName} tool: ${JSON.stringify(request.toolInput).substring(0, 100)}...`,
+                priority: 'default',
+                tags: ['claudia-permission'],
+                sessionId: sessionId || 'unknown',
+                streamingId: request.streamingId,
+                permissionRequestId: request.id
+            };
+            // Send via ntfy
+            await this.sendNotification(ntfyUrl, topic, notification);
+            // Also broadcast via native web push (best-effort)
+            try {
+                await this.webPushService.initialize();
+                if (this.webPushService.getEnabled()) {
+                    await this.webPushService.broadcast({
+                        title: notification.title,
+                        message: notification.message,
+                        tag: notification.tags[0],
+                        data: {
+                            sessionId: notification.sessionId,
+                            streamingId: notification.streamingId,
+                            permissionRequestId: notification.permissionRequestId,
+                            type: 'permission',
+                        },
+                    });
+                }
+            }
+            catch (err) {
+                this.logger.debug('Web push broadcast failed (non-fatal)', { error: err?.message });
+            }
+            this.logger.info('Permission notification sent', {
+                requestId: request.id,
+                toolName: request.toolName,
+                topic
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to send permission notification', error, {
+                requestId: request.id
+            });
+        }
+    }
+    /**
+     * Send a notification when a conversation ends
+     */
+    async sendConversationEndNotification(streamingId, sessionId, summary) {
+        if (!(await this.isEnabled())) {
+            this.logger.debug('Notifications disabled, skipping conversation end notification');
+            return;
+        }
+        try {
+            const machineId = this.getMachineId();
+            const topic = `claudia-${machineId}`;
+            const ntfyUrl = await this.getNtfyUrl();
+            const notification = {
+                title: 'Task Finished',
+                message: summary || 'Task completed',
+                priority: 'default',
+                tags: ['claudia-complete'],
+                sessionId,
+                streamingId
+            };
+            // Send via ntfy
+            await this.sendNotification(ntfyUrl, topic, notification);
+            // Also broadcast via native web push (best-effort)
+            try {
+                await this.webPushService.initialize();
+                if (this.webPushService.getEnabled()) {
+                    await this.webPushService.broadcast({
+                        title: notification.title,
+                        message: notification.message,
+                        tag: notification.tags[0],
+                        data: {
+                            sessionId: notification.sessionId,
+                            streamingId: notification.streamingId,
+                            type: 'conversation-end',
+                        },
+                    });
+                }
+            }
+            catch (err) {
+                this.logger.debug('Web push broadcast failed (non-fatal)', { error: err?.message });
+            }
+            this.logger.info('Conversation end notification sent', {
+                sessionId,
+                streamingId,
+                topic
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to send conversation end notification', error, {
+                sessionId,
+                streamingId
+            });
+        }
+    }
+    /**
+     * Send a notification to ntfy
+     */
+    async sendNotification(ntfyUrl, topic, notification) {
+        const url = `${ntfyUrl}/${topic}`;
+        const headers = {
+            'Title': notification.title,
+            'Priority': notification.priority,
+            'Tags': notification.tags.join(',')
+        };
+        // Add custom headers for CUI metadata
+        headers['X-CUI-SessionId'] = notification.sessionId;
+        headers['X-CUI-StreamingId'] = notification.streamingId;
+        if (notification.permissionRequestId) {
+            headers['X-CUI-PermissionRequestId'] = notification.permissionRequestId;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: notification.message
+        });
+        if (!response.ok) {
+            throw new Error(`Ntfy returned ${response.status}: ${await response.text()}`);
+        }
+    }
+}
+//# sourceMappingURL=notification-service.js.map

package/dist/services/notification-service.js.map

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

package/dist/services/pending-question-service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Question definition from AskUserQuestion tool
+ */
+export interface QuestionDefinition {
+    question: string;
+    header?: string;
+    options: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect?: boolean;
+}
+/**
+ * A pending question waiting for user response
+ */
+export interface PendingQuestion {
+    id: string;
+    sessionId: string;
+    streamingId: string;
+    toolUseId: string;
+    questions: QuestionDefinition[];
+    createdAt: string;
+    status: 'pending' | 'answered' | 'expired';
+    answers?: Record<string, string>;
+    answeredAt?: string;
+    resumedStreamingId?: string;
+}
+/**
+ * Service to persist AskUserQuestion requests across browser disconnects and server restarts.
+ *
+ * Flow:
+ * 1. Claude calls AskUserQuestion → we detect tool_use and save here
+ * 2. TUI times out (~6 sec) → session ends
+ * 3. User returns (even after browser close) → we show pending question
+ * 4. User answers → we --resume the session with the answer as context
+ */
+export declare class PendingQuestionService {
+    private static instance;
+    private logger;
+    private dbPath;
+    private configDir;
+    private isInitialized;
+    private db;
+    private insertStmt;
+    private getByIdStmt;
+    private getBySessionStmt;
+    private getByStreamingIdStmt;
+    private getPendingStmt;
+    private markAnsweredStmt;
+    private markExpiredStmt;
+    private setResumedStreamingIdStmt;
+    private deleteStmt;
+    constructor(customConfigDir?: string);
+    static getInstance(): PendingQuestionService;
+    static resetInstance(): void;
+    private initializePaths;
+    initialize(): Promise<void>;
+    private prepareStatements;
+    /**
+     * Save a new pending question
+     */
+    addQuestion(id: string, sessionId: string, streamingId: string, toolUseId: string, questions: QuestionDefinition[]): PendingQuestion;
+    /**
+     * Get a question by ID
+     */
+    getQuestion(id: string): PendingQuestion | null;
+    /**
+     * Get all questions for a session (any status)
+     */
+    getQuestionsBySession(sessionId: string): PendingQuestion[];
+    /**
+     * Get pending questions for a streaming ID
+     */
+    getPendingByStreamingId(streamingId: string): PendingQuestion[];
+    /**
+     * Get all pending questions (across all sessions)
+     */
+    getAllPending(): PendingQuestion[];
+    /**
+     * Mark a question as answered
+     */
+    markAnswered(id: string, answers: Record<string, string>): boolean;
+    /**
+     * Mark a question as expired (e.g., session was manually closed)
+     */
+    markExpired(id: string): boolean;
+    /**
+     * Set the streaming ID of the resumed session
+     */
+    setResumedStreamingId(id: string, streamingId: string): boolean;
+    /**
+     * Delete a question
+     */
+    delete(id: string): boolean;
+    private rowToQuestion;
+}
+//# sourceMappingURL=pending-question-service.d.ts.map

package/dist/services/pending-question-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-question-service.d.ts","sourceRoot":"","sources":["../../src/services/pending-question-service.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAeD;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,EAAE,CAAqB;IAG/B,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,yBAAyB,CAAsB;IACvD,OAAO,CAAC,UAAU,CAAsB;gBAE5B,eAAe,CAAC,EAAE,MAAM;IAKpC,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,OAAO,CAAC,eAAe;IAejB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCjC,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,WAAW,CACT,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,kBAAkB,EAAE,GAC9B,eAAe;IAyBlB;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAK/C;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAK3D;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE;IAK/D;;OAEG;IACH,aAAa,IAAI,eAAe,EAAE;IAKlC;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAclE;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAK/D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK3B,OAAO,CAAC,aAAa;CActB"}

package/dist/services/pending-question-service.js

@@ -0,0 +1,223 @@
+import fs from 'fs';
+import path from 'path';
+import Database from 'better-sqlite3';
+import { CONFIG_DIR, CONFIG_DIR_NAME } from '../utils/constants.js';
+import { createLogger } from './infrastructure/logger.js';
+/**
+ * Service to persist AskUserQuestion requests across browser disconnects and server restarts.
+ *
+ * Flow:
+ * 1. Claude calls AskUserQuestion → we detect tool_use and save here
+ * 2. TUI times out (~6 sec) → session ends
+ * 3. User returns (even after browser close) → we show pending question
+ * 4. User answers → we --resume the session with the answer as context
+ */
+export class PendingQuestionService {
+    static instance;
+    logger;
+    dbPath;
+    configDir;
+    isInitialized = false;
+    db;
+    // Prepared statements
+    insertStmt;
+    getByIdStmt;
+    getBySessionStmt;
+    getByStreamingIdStmt;
+    getPendingStmt;
+    markAnsweredStmt;
+    markExpiredStmt;
+    setResumedStreamingIdStmt;
+    deleteStmt;
+    constructor(customConfigDir) {
+        this.logger = createLogger('PendingQuestionService');
+        this.initializePaths(customConfigDir);
+    }
+    static getInstance() {
+        if (!PendingQuestionService.instance) {
+            PendingQuestionService.instance = new PendingQuestionService();
+        }
+        return PendingQuestionService.instance;
+    }
+    static resetInstance() {
+        PendingQuestionService.instance = null;
+    }
+    initializePaths(customConfigDir) {
+        if (customConfigDir) {
+            if (customConfigDir === ':memory:') {
+                this.configDir = ':memory:';
+                this.dbPath = ':memory:';
+                return;
+            }
+            this.configDir = path.join(customConfigDir, CONFIG_DIR_NAME);
+        }
+        else {
+            this.configDir = CONFIG_DIR;
+        }
+        // Use same DB as session-info for simplicity
+        this.dbPath = path.join(this.configDir, 'session-info.db');
+    }
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        try {
+            if (this.dbPath !== ':memory:' && !fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            this.db = new Database(this.dbPath);
+            this.db.pragma('journal_mode = WAL');
+            this.db.pragma('busy_timeout = 10000');
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS pending_questions (
+          id TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL,
+          streaming_id TEXT NOT NULL,
+          tool_use_id TEXT NOT NULL,
+          questions TEXT NOT NULL,
+          created_at TEXT NOT NULL,
+          status TEXT NOT NULL DEFAULT 'pending',
+          answers TEXT,
+          answered_at TEXT,
+          resumed_streaming_id TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_pending_questions_session ON pending_questions(session_id);
+        CREATE INDEX IF NOT EXISTS idx_pending_questions_status ON pending_questions(status);
+      `);
+            this.prepareStatements();
+            this.isInitialized = true;
+            this.logger.info('PendingQuestionService initialized');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize pending questions database', error);
+            throw error;
+        }
+    }
+    prepareStatements() {
+        this.insertStmt = this.db.prepare(`
+      INSERT INTO pending_questions (
+        id, session_id, streaming_id, tool_use_id, questions, created_at, status
+      ) VALUES (
+        @id, @session_id, @streaming_id, @tool_use_id, @questions, @created_at, @status
+      )
+    `);
+        this.getByIdStmt = this.db.prepare('SELECT * FROM pending_questions WHERE id = ?');
+        this.getBySessionStmt = this.db.prepare('SELECT * FROM pending_questions WHERE session_id = ?');
+        this.getByStreamingIdStmt = this.db.prepare('SELECT * FROM pending_questions WHERE streaming_id = ? AND status = ?');
+        this.getPendingStmt = this.db.prepare("SELECT * FROM pending_questions WHERE status = 'pending' ORDER BY created_at DESC");
+        this.markAnsweredStmt = this.db.prepare(`
+      UPDATE pending_questions
+      SET status = 'answered', answers = @answers, answered_at = @answered_at
+      WHERE id = @id
+    `);
+        this.markExpiredStmt = this.db.prepare("UPDATE pending_questions SET status = 'expired' WHERE id = ?");
+        this.setResumedStreamingIdStmt = this.db.prepare(`
+      UPDATE pending_questions SET resumed_streaming_id = ? WHERE id = ?
+    `);
+        this.deleteStmt = this.db.prepare('DELETE FROM pending_questions WHERE id = ?');
+    }
+    /**
+     * Save a new pending question
+     */
+    addQuestion(id, sessionId, streamingId, toolUseId, questions) {
+        const question = {
+            id,
+            sessionId,
+            streamingId,
+            toolUseId,
+            questions,
+            createdAt: new Date().toISOString(),
+            status: 'pending'
+        };
+        this.insertStmt.run({
+            id: question.id,
+            session_id: question.sessionId,
+            streaming_id: question.streamingId,
+            tool_use_id: question.toolUseId,
+            questions: JSON.stringify(question.questions),
+            created_at: question.createdAt,
+            status: question.status
+        });
+        this.logger.info('Pending question saved', { id, sessionId, questionCount: questions.length });
+        return question;
+    }
+    /**
+     * Get a question by ID
+     */
+    getQuestion(id) {
+        const row = this.getByIdStmt.get(id);
+        return row ? this.rowToQuestion(row) : null;
+    }
+    /**
+     * Get all questions for a session (any status)
+     */
+    getQuestionsBySession(sessionId) {
+        const rows = this.getBySessionStmt.all(sessionId);
+        return rows.map(row => this.rowToQuestion(row));
+    }
+    /**
+     * Get pending questions for a streaming ID
+     */
+    getPendingByStreamingId(streamingId) {
+        const rows = this.getByStreamingIdStmt.all(streamingId, 'pending');
+        return rows.map(row => this.rowToQuestion(row));
+    }
+    /**
+     * Get all pending questions (across all sessions)
+     */
+    getAllPending() {
+        const rows = this.getPendingStmt.all();
+        return rows.map(row => this.rowToQuestion(row));
+    }
+    /**
+     * Mark a question as answered
+     */
+    markAnswered(id, answers) {
+        const result = this.markAnsweredStmt.run({
+            id,
+            answers: JSON.stringify(answers),
+            answered_at: new Date().toISOString()
+        });
+        if (result.changes > 0) {
+            this.logger.info('Question marked as answered', { id, answers });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Mark a question as expired (e.g., session was manually closed)
+     */
+    markExpired(id) {
+        const result = this.markExpiredStmt.run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Set the streaming ID of the resumed session
+     */
+    setResumedStreamingId(id, streamingId) {
+        const result = this.setResumedStreamingIdStmt.run(streamingId, id);
+        return result.changes > 0;
+    }
+    /**
+     * Delete a question
+     */
+    delete(id) {
+        const result = this.deleteStmt.run(id);
+        return result.changes > 0;
+    }
+    rowToQuestion(row) {
+        return {
+            id: row.id,
+            sessionId: row.session_id,
+            streamingId: row.streaming_id,
+            toolUseId: row.tool_use_id,
+            questions: JSON.parse(row.questions),
+            createdAt: row.created_at,
+            status: row.status,
+            answers: row.answers ? JSON.parse(row.answers) : undefined,
+            answeredAt: row.answered_at ?? undefined,
+            resumedStreamingId: row.resumed_streaming_id ?? undefined
+        };
+    }
+}
+//# sourceMappingURL=pending-question-service.js.map

package/dist/services/pending-question-service.js.map

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

package/dist/services/permission-event-log.d.ts

@@ -0,0 +1,136 @@
+/**
+ * PermissionEventLog - Structured event logging for permission flow observability.
+ *
+ * This provides a clear, queryable log of all permission system decisions:
+ * - Permission requests from MCP server
+ * - Pattern matching decisions (allowed/denied)
+ * - Pattern suggestions (LLM vs heuristic)
+ * - Allowlist modifications
+ *
+ * The log is designed for:
+ * 1. Debugging: "Why was this tool auto-approved?" / "What pattern matched?"
+ * 2. Monitoring: "How many permissions are being requested?"
+ * 3. Pattern analysis: "What patterns would reduce permission prompts?"
+ */
+export type PermissionEventType = 'request' | 'auto_approved' | 'pending' | 'approved' | 'denied' | 'pattern_suggest' | 'allowlist_add';
+export type PatternSource = 'global' | 'session';
+export type SuggestionSource = 'llm' | 'heuristic';
+export interface PermissionEvent {
+    id: number;
+    timestamp: number;
+    eventType: PermissionEventType;
+    toolName: string;
+    toolInput?: Record<string, unknown>;
+    streamingId?: string;
+    sessionId?: string;
+    permissionRequestId?: string;
+    matchedPattern?: string;
+    patternSource?: PatternSource;
+    suggestedPatterns?: string[];
+    suggestionSource?: SuggestionSource;
+    addedPattern?: string;
+    allowlistScope?: 'session' | 'global';
+    decision?: 'approve' | 'deny';
+    denyReason?: string;
+    durationMs?: number;
+}
+export declare class PermissionEventLog {
+    private logger;
+    private events;
+    private eventId;
+    private maxEvents;
+    constructor();
+    /**
+     * Log a permission request from MCP server
+     */
+    request(params: {
+        toolName: string;
+        toolInput?: Record<string, unknown>;
+        streamingId?: string;
+        permissionRequestId: string;
+    }): void;
+    /**
+     * Log auto-approval by pattern match
+     */
+    autoApproved(params: {
+        toolName: string;
+        toolInput?: Record<string, unknown>;
+        streamingId?: string;
+        matchedPattern: string;
+        patternSource: PatternSource;
+    }): void;
+    /**
+     * Log pattern suggestions
+     */
+    patternSuggest(params: {
+        toolName: string;
+        toolInput?: Record<string, unknown>;
+        suggestedPatterns: string[];
+        suggestionSource: SuggestionSource;
+        durationMs?: number;
+    }): void;
+    /**
+     * Log user decision
+     */
+    decision(params: {
+        permissionRequestId: string;
+        toolName: string;
+        decision: 'approve' | 'deny';
+        denyReason?: string;
+        streamingId?: string;
+    }): void;
+    /**
+     * Log pattern added to allowlist
+     */
+    allowlistAdd(params: {
+        pattern: string;
+        scope: 'session' | 'global';
+        streamingId?: string;
+    }): void;
+    private addEvent;
+    /**
+     * Get all events (most recent first)
+     */
+    getAll(limit?: number): PermissionEvent[];
+    /**
+     * Get events for a specific streaming session
+     */
+    getForSession(streamingId: string, limit?: number): PermissionEvent[];
+    /**
+     * Get events for a specific tool
+     */
+    getForTool(toolName: string, limit?: number): PermissionEvent[];
+    /**
+     * Get auto-approved events (useful for understanding pattern coverage)
+     */
+    getAutoApproved(limit?: number): PermissionEvent[];
+    /**
+     * Get pending/denied events (useful for identifying missing patterns)
+     */
+    getManualDecisions(limit?: number): PermissionEvent[];
+    /**
+     * Get pattern match statistics
+     */
+    getPatternStats(): {
+        totalRequests: number;
+        autoApproved: number;
+        manualApproved: number;
+        denied: number;
+        patternHitRate: number;
+        topMatchedPatterns: Array<{
+            pattern: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Get a human-readable timeline
+     */
+    getTimeline(limit?: number): string[];
+    /**
+     * Clear all events (for testing)
+     */
+    clear(): void;
+}
+export declare function getPermissionEventLog(): PermissionEventLog;
+export declare function resetPermissionEventLog(): void;
+//# sourceMappingURL=permission-event-log.d.ts.map

package/dist/services/permission-event-log.d.ts.map

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