agentstudio 0.3.1 → 0.3.2

package/services/sessionManager.d.ts

@@ -0,0 +1,176 @@
+import { Options } from '@anthropic-ai/claude-agent-sdk';
+import { ClaudeSession } from './claudeSession';
+/**
+ * 会话配置快照
+ * 用于检测会话配置是否发生变化
+ */
+export interface SessionConfigSnapshot {
+    model?: string;
+    claudeVersionId?: string;
+    permissionMode?: string;
+    mcpTools?: string[];
+    allowedTools?: string[];
+}
+/**
+ * Claude 会话管理器
+ * 负责管理所有 Claude 会话的生命周期
+ */
+export declare class SessionManager {
+    private sessions;
+    private agentSessions;
+    private tempSessions;
+    private sessionHeartbeats;
+    private sessionConfigs;
+    private cleanupInterval;
+    private readonly cleanupIntervalMs;
+    private readonly defaultIdleTimeoutMs;
+    private readonly heartbeatTimeoutMs;
+    constructor();
+    /**
+     * 根据 sessionId 获取会话
+     * @param sessionId Claude SDK 返回的 sessionId
+     */
+    getSession(sessionId: string): ClaudeSession | null;
+    /**
+     * 获取指定agent的最新活跃会话
+     * @param agentId Agent ID
+     */
+    getLatestSessionForAgent(agentId: string): ClaudeSession | null;
+    /**
+     * 检查Claude用户目录中是否存在会话历史
+     * @param sessionId 要查找的会话ID
+     * @param projectPath 项目路径
+     */
+    checkSessionExists(sessionId: string, projectPath?: string): boolean;
+    /**
+     * 将项目路径转换为Claude格式
+     * 复用sessions.ts中的逻辑
+     */
+    private convertProjectPathToClaudeFormat;
+    /**
+     * 创建新会话（还没有 sessionId）
+     * @param agentId Agent ID
+     * @param options Claude 查询选项
+     * @param resumeSessionId 可选的恢复会话ID
+     * @param claudeVersionId 可选的 Claude 版本ID
+     * @param modelId 可选的模型ID
+     * @param configSnapshot 可选的配置快照，用于后续检测配置变化
+     */
+    createNewSession(agentId: string, options: Options, resumeSessionId?: string, claudeVersionId?: string, modelId?: string, configSnapshot?: SessionConfigSnapshot): ClaudeSession;
+    /**
+     * 确认会话的真实 sessionId，更新索引
+     * @param session 会话实例
+     * @param sessionId Claude SDK 返回的真实 sessionId
+     * @param configSnapshot 可选的配置快照
+     */
+    confirmSessionId(session: ClaudeSession, sessionId: string, configSnapshot?: SessionConfigSnapshot): void;
+    /**
+     * 替换会话ID（用于resume时Claude SDK返回新的sessionId的情况）
+     * @param session 会话实例
+     * @param oldSessionId 原始的sessionId
+     * @param newSessionId Claude SDK返回的新sessionId
+     */
+    replaceSessionId(session: ClaudeSession, oldSessionId: string, newSessionId: string): void;
+    /**
+     * 更新会话心跳时间
+     * @param sessionId 会话ID
+     * @returns 是否成功更新
+     */
+    updateHeartbeat(sessionId: string): boolean;
+    /**
+     * 获取会话的最后心跳时间
+     * @param sessionId 会话ID
+     * @returns 最后心跳时间，如果不存在返回null
+     */
+    getLastHeartbeat(sessionId: string): number | null;
+    /**
+     * 检查会话是否心跳超时
+     * @param sessionId 会话ID
+     * @returns 是否超时
+     */
+    isHeartbeatTimedOut(sessionId: string): boolean;
+    /**
+     * 检查会话是否在 SessionManager 中存在
+     * @param sessionId 会话ID
+     * @returns 是否存在
+     */
+    hasActiveSession(sessionId: string): boolean;
+    /**
+     * 检查会话是否正在处理请求（用于并发控制）
+     * @param sessionId 会话ID
+     * @returns 是否正在处理，如果会话不存在返回 false
+     */
+    isSessionBusy(sessionId: string): boolean;
+    /**
+     * 移除指定会话
+     * @param sessionId Claude SDK 返回的 sessionId
+     */
+    removeSession(sessionId: string): Promise<boolean>;
+    /**
+     * 手动清理指定会话（提供给前端使用）
+     * @param sessionId 会话ID（可能是正式sessionId或临时tempKey）
+     * @returns 是否成功清理
+     */
+    manualCleanupSession(sessionId: string): Promise<boolean>;
+    /**
+     * 中断指定会话的当前请求
+     * @param sessionId 会话ID
+     * @returns 是否成功中断
+     */
+    interruptSession(sessionId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 清理空闲会话和心跳超时会话
+     */
+    private cleanupIdleSessions;
+    /**
+     * 获取活跃会话数量
+     */
+    getActiveSessionCount(): number;
+    /**
+     * 获取所有会话信息（用于调试和监控）
+     */
+    getSessionsInfo(): Array<{
+        sessionId: string;
+        agentId: string;
+        isActive: boolean;
+        lastActivity: number;
+        idleTimeMs: number;
+        lastHeartbeat: number | null;
+        heartbeatTimedOut: boolean;
+        status: 'confirmed' | 'pending';
+        projectPath: string | null;
+        claudeVersionId?: string;
+        modelId?: string;
+        sessionTitle?: string;
+    }>;
+    /**
+     * 清除所有会话（用户主动清理）
+     * @returns 清理的会话数量
+     */
+    clearAllSessions(): Promise<number>;
+    /**
+     * 比较两个配置快照是否相同
+     */
+    private compareConfigSnapshots;
+    /**
+     * 检查会话配置是否发生变化
+     * @param sessionId 会话ID
+     * @param newConfig 新的配置快照
+     * @returns 是否发生变化
+     */
+    hasConfigChanged(sessionId: string, newConfig: SessionConfigSnapshot): boolean;
+    /**
+     * 获取会话的配置快照
+     * @param sessionId 会话ID
+     */
+    getSessionConfig(sessionId: string): SessionConfigSnapshot | undefined;
+    /**
+     * 关闭所有会话并清理资源
+     */
+    shutdown(): Promise<void>;
+}
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=sessionManager.d.ts.map

package/services/sessionManager.d.ts.map

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