agent-ide 0.1.0

package/dist/application/services/session-manager.service.js

@@ -0,0 +1,318 @@
+/**
+ * 會話管理服務
+ *
+ * 負責管理用戶會話的生命週期，包括：
+ * - 會話建立、查詢、更新
+ * - 會話狀態管理
+ * - 過期會話清理機制
+ * - 操作歷史追蹤
+ * - 並發會話隔離
+ * - 會話事件發布
+ */
+import { randomUUID } from 'crypto';
+import { BaseError } from '../../shared/errors/base-error.js';
+import { SessionState as SessionStateClass } from '../state/session-state.js';
+/**
+ * 會話管理相關錯誤
+ */
+export class SessionManagerError extends BaseError {
+    constructor(message, details, cause) {
+        super('SESSION_MANAGER_ERROR', message, details, cause);
+    }
+}
+/**
+ * 會話不存在錯誤
+ */
+export class SessionNotFoundError extends SessionManagerError {
+    constructor(sessionId) {
+        super(`Session not found: ${sessionId}`, { sessionId });
+    }
+}
+/**
+ * 會話管理服務實作
+ */
+export class SessionManager {
+    stateManager;
+    eventBus;
+    cleanupInterval;
+    sessionTimeoutMs = 2 * 60 * 60 * 1000; // 2 小時
+    constructor(stateManager, eventBus) {
+        this.stateManager = stateManager;
+        this.eventBus = eventBus;
+        // 設定定期清理任務，每 30 分鐘執行一次
+        this.cleanupInterval = setInterval(() => this.cleanup().catch(console.error), 30 * 60 * 1000);
+        // 在測試環境中註冊到全域清理器
+        if (process.env.NODE_ENV === 'test') {
+            if (typeof global !== 'undefined') {
+                if (!global.__test_session_managers) {
+                    global.__test_session_managers = [];
+                }
+                global.__test_session_managers.push(this);
+            }
+        }
+    }
+    /**
+     * 建立新會話
+     */
+    async createSession(userId) {
+        try {
+            const sessionId = randomUUID();
+            const now = new Date();
+            // 在狀態管理器中建立會話
+            const sessionState = this.stateManager.createSession(sessionId, userId);
+            // 建立 Session 物件
+            const session = {
+                id: sessionId,
+                userId,
+                startTime: now,
+                lastActivity: now,
+                state: this.convertToSessionState(sessionState),
+                metadata: {}
+            };
+            // 發送會話建立事件
+            await this.emitSessionEvent('session-created', sessionId, session);
+            return session;
+        }
+        catch (error) {
+            throw new SessionManagerError('Failed to create session', { userId }, error);
+        }
+    }
+    /**
+     * 獲取會話
+     */
+    async getSession(sessionId) {
+        try {
+            const sessionState = this.stateManager.getSession(sessionId);
+            if (!sessionState) {
+                return null;
+            }
+            // 更新最後存取時間
+            const updatedSessionState = sessionState.updateLastAccess();
+            this.stateManager.updateSession(sessionId, () => updatedSessionState);
+            return this.convertToSession(sessionId, updatedSessionState);
+        }
+        catch (error) {
+            throw new SessionManagerError('Failed to get session', { sessionId }, error);
+        }
+    }
+    /**
+     * 更新會話狀態
+     */
+    async updateSession(sessionId, updates) {
+        try {
+            const existingSession = this.stateManager.getSession(sessionId);
+            if (!existingSession) {
+                throw new SessionNotFoundError(sessionId);
+            }
+            // 更新會話狀態
+            const updatedSessionState = this.stateManager.updateSession(sessionId, (currentState) => this.applyUpdates(currentState, updates));
+            // 發送會話更新事件
+            const session = this.convertToSession(sessionId, updatedSessionState);
+            await this.emitSessionEvent('session-updated', sessionId, session);
+        }
+        catch (error) {
+            if (error instanceof SessionNotFoundError) {
+                throw error;
+            }
+            throw new SessionManagerError('Failed to update session', { sessionId, updates }, error);
+        }
+    }
+    /**
+     * 清理過期會話
+     */
+    async cleanup() {
+        try {
+            const activeSessions = this.stateManager.listActiveSessions();
+            const expiredSessionIds = [];
+            for (const sessionState of activeSessions) {
+                const isExpired = this.isSessionExpired(sessionState);
+                const isInactiveForTooLong = this.isInactiveForTooLong(sessionState);
+                const isExpiredStatus = this.convertToSessionState(sessionState).status === 'expired';
+                if (isExpired || isInactiveForTooLong || isExpiredStatus) {
+                    expiredSessionIds.push(sessionState.sessionId);
+                }
+            }
+            // 移除過期會話
+            for (const sessionId of expiredSessionIds) {
+                this.stateManager.removeSession(sessionId);
+                await this.emitSessionEvent('session-expired', sessionId);
+            }
+            // 清理狀態管理器中的過期會話
+            this.stateManager.cleanupExpiredSessions();
+        }
+        catch (error) {
+            throw new SessionManagerError('Failed to cleanup sessions', {}, error);
+        }
+    }
+    /**
+     * 獲取操作歷史
+     */
+    async getHistory(sessionId) {
+        try {
+            const sessionState = this.stateManager.getSession(sessionId);
+            if (!sessionState) {
+                throw new SessionNotFoundError(sessionId);
+            }
+            // 轉換操作記錄格式
+            return sessionState.operationHistory.map(record => ({
+                id: record.id,
+                operationType: record.type,
+                timestamp: record.timestamp,
+                parameters: (record.metadata.parameters || record.metadata),
+                result: record.metadata.result,
+                error: record.metadata.error,
+                duration: record.metadata.duration
+            }));
+        }
+        catch (error) {
+            if (error instanceof SessionNotFoundError) {
+                throw error;
+            }
+            throw new SessionManagerError('Failed to get session history', { sessionId }, error);
+        }
+    }
+    /**
+     * 銷毀服務，清理資源
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        // 在測試環境中從全域清理器移除
+        if (process.env.NODE_ENV === 'test') {
+            if (typeof global !== 'undefined' && global.__test_session_managers) {
+                const managers = global.__test_session_managers;
+                const index = managers.indexOf(this);
+                if (index !== -1) {
+                    managers.splice(index, 1);
+                }
+            }
+        }
+    }
+    /**
+     * 應用會話狀態更新
+     */
+    applyUpdates(currentState, updates) {
+        let updatedState = currentState;
+        // 更新狀態
+        if (updates.status !== undefined) {
+            if (updates.status === 'active') {
+                updatedState = updatedState.activate();
+            }
+            else if (updates.status === 'inactive') {
+                updatedState = updatedState.deactivate();
+            }
+        }
+        // 更新上下文
+        if (updates.context !== undefined) {
+            updatedState = updatedState.updateContext(updates.context);
+        }
+        // 更新操作歷史
+        if (updates.operationHistory !== undefined) {
+            // 清空現有歷史並添加新歷史
+            updatedState = updatedState.clearHistory();
+            const operationRecords = updates.operationHistory.map(op => ({
+                id: op.id,
+                type: op.operationType,
+                timestamp: op.timestamp,
+                description: `${op.operationType} operation`,
+                metadata: {
+                    parameters: op.parameters,
+                    result: op.result,
+                    error: op.error,
+                    duration: op.duration
+                }
+            }));
+            updatedState = updatedState.addOperations(operationRecords);
+        }
+        // 其他欄位的更新（如 updatedAt）
+        if (updates.updatedAt !== undefined) {
+            // 通過克隆來更新 updatedAt
+            const data = updatedState.toJSON();
+            data.lastAccessedAt = updates.updatedAt;
+            updatedState = SessionStateClass.fromJSON(data);
+        }
+        return updatedState;
+    }
+    /**
+     * 轉換 SessionStateClass 為 SessionState 介面
+     */
+    convertToSessionState(sessionState) {
+        const status = sessionState.isExpired()
+            ? 'expired'
+            : sessionState.isActive
+                ? 'active'
+                : 'inactive';
+        return {
+            id: sessionState.sessionId,
+            userId: sessionState.userId,
+            status,
+            context: sessionState.context,
+            operationHistory: sessionState.operationHistory.map(record => ({
+                id: record.id,
+                operationType: record.type,
+                timestamp: record.timestamp,
+                parameters: (record.metadata.parameters || record.metadata),
+                result: record.metadata.result,
+                error: record.metadata.error,
+                duration: record.metadata.duration
+            })),
+            createdAt: sessionState.createdAt,
+            updatedAt: sessionState.lastAccessedAt
+        };
+    }
+    /**
+     * 轉換 SessionStateClass 為 Session 物件
+     */
+    convertToSession(sessionId, sessionState) {
+        return {
+            id: sessionId,
+            userId: sessionState.userId,
+            startTime: sessionState.createdAt,
+            lastActivity: sessionState.lastAccessedAt,
+            state: this.convertToSessionState(sessionState),
+            metadata: {}
+        };
+    }
+    /**
+     * 檢查會話是否已過期
+     */
+    isSessionExpired(sessionState) {
+        return sessionState.isExpired();
+    }
+    /**
+     * 檢查會話是否非活躍時間過長
+     */
+    isInactiveForTooLong(sessionState) {
+        if (sessionState.isActive) {
+            return false;
+        }
+        const now = Date.now();
+        const lastAccess = sessionState.lastAccessedAt.getTime();
+        return (now - lastAccess) > this.sessionTimeoutMs;
+    }
+    /**
+     * 發送會話事件
+     */
+    async emitSessionEvent(eventType, sessionId, session) {
+        try {
+            await this.eventBus.emit({
+                type: eventType,
+                timestamp: new Date(),
+                priority: 1,
+                payload: {
+                    sessionId,
+                    session
+                }
+            });
+        }
+        catch (error) {
+            // 事件發送失敗不應該影響主要功能
+            // 測試環境中靜默處理
+            if (process.env.NODE_ENV !== 'test') {
+                console.warn(`Failed to emit session event: ${eventType}`, error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=session-manager.service.js.map

package/dist/application/services/session-manager.service.js.map

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

package/dist/application/services/workflow-engine.service.d.ts

@@ -0,0 +1,76 @@
+/**
+ * WorkflowEngine 服務實作
+ * 提供工作流程執行、暫停、恢復、回滾等功能
+ */
+import { BaseError } from '../../shared/errors/base-error.js';
+import { EventBus } from '../events/event-bus.js';
+import { ErrorHandlerService } from './error-handler.service.js';
+import { StateManager } from '../state/state-manager.js';
+import { WorkflowStatus, type IWorkflowEngine, type Workflow, type WorkflowResult } from '../types.js';
+/**
+ * 工作流程執行錯誤
+ */
+export declare class WorkflowError extends BaseError {
+    constructor(message: string, details?: Record<string, any>, cause?: Error);
+}
+/**
+ * 工作流程引擎服務
+ */
+export declare class WorkflowEngineService implements IWorkflowEngine {
+    private readonly eventBus;
+    private readonly errorHandler;
+    private readonly stateManager;
+    private readonly activeWorkflows;
+    private readonly executionPromises;
+    private readonly workflowRegistry;
+    constructor(eventBus: EventBus, errorHandler: ErrorHandlerService, stateManager: StateManager);
+    /**
+     * 執行工作流程
+     */
+    execute<T>(workflow: Workflow<T>): Promise<WorkflowResult<T>>;
+    /**
+     * 暫停工作流程
+     */
+    pause(workflowId: string): Promise<void>;
+    /**
+     * 恢復工作流程
+     */
+    resume<T>(workflowId: string): Promise<WorkflowResult<T>>;
+    /**
+     * 回滾工作流程
+     */
+    rollback(workflowId: string, stepId?: string): Promise<void>;
+    /**
+     * 取得工作流程狀態
+     */
+    getStatus(workflowId: string): Promise<WorkflowStatus>;
+    /**
+     * 執行工作流程的核心邏輯
+     */
+    private executeWorkflow;
+    /**
+     * 繼續執行暫停的工作流程
+     */
+    private continueExecution;
+    /**
+     * 執行單個步驟
+     */
+    private executeStep;
+    /**
+     * 執行回滾
+     */
+    private performRollback;
+    /**
+     * 發布工作流程事件
+     */
+    private publishWorkflowEvent;
+    /**
+     * 驗證工作流程定義
+     */
+    private validateWorkflow;
+    /**
+     * 驗證工作流程步驟
+     */
+    private validateStep;
+}
+//# sourceMappingURL=workflow-engine.service.d.ts.map

package/dist/application/services/workflow-engine.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-engine.service.d.ts","sourceRoot":"","sources":["../../../src/application/services/workflow-engine.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,QAAQ,EAEb,KAAK,cAAc,EAIpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK;CAG1E;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwB;gBAGvD,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,YAAY;IAU5B;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAqCnE;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9C;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAqB/D;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BlE;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU5D;;OAEG;YACW,eAAe;IA4I7B;;OAEG;YACW,iBAAiB;IAkB/B;;OAEG;YACW,WAAW;IAyCzB;;OAEG;YACW,eAAe;IAoC7B;;OAEG;YACW,oBAAoB;IAyBlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAyBrB"}