@a1hvdy/cc-openclaw 0.3.2

package/dist/src/session/session-manager.d.ts

@@ -0,0 +1,212 @@
+/**
+ * SessionManager — manages multiple PersistentClaudeSession instances
+ *
+ * Replaces the Express server layer. Pure class with no HTTP dependency.
+ * Can be used by Plugin tools, CLI, or any other consumer.
+ */
+interface PersistedSession {
+    name: string;
+    claudeSessionId: string;
+    cwd: string;
+    model?: string;
+    engine?: EngineType;
+    originalCreated: string;
+    lastResumed: string;
+    lastActivity: number;
+}
+import { type Logger } from '../logger.js';
+import { type SessionConfig, type SessionInfo, type SendResult, type PluginConfig, type EffortLevel, type EngineType, type AgentInfo, type SkillInfo, type RuleInfo, type StreamEvent, type ISession, type CouncilConfig, type CouncilSession, type CouncilReviewResult, type CouncilAcceptResult, type CouncilRejectResult, type InboxMessage, type UltraplanResult, type UltrareviewResult } from '../types.js';
+interface SendOptions {
+    effort?: EffortLevel;
+    plan?: boolean;
+    autoResume?: boolean;
+    timeout?: number;
+    onEvent?: (event: StreamEvent) => void;
+    onChunk?: (chunk: string) => void;
+}
+export declare class SessionManager {
+    private sessions;
+    private _pendingSessions;
+    private cleanupTimer;
+    private pluginConfig;
+    private persistedSessions;
+    private _debouncedSave;
+    private _proxyServer;
+    private _proxyPort;
+    private _activePids;
+    private _circuitBreaker;
+    private _inbox;
+    private logger;
+    constructor(config?: Partial<PluginConfig>, logger?: Logger);
+    startSession(config: Partial<SessionConfig> & {
+        name?: string;
+    }): Promise<SessionInfo>;
+    private _doStartSession;
+    sendMessage(name: string, message: string | unknown[], options?: SendOptions): Promise<SendResult>;
+    stopSession(name: string): Promise<void>;
+    listSessions(): SessionInfo[];
+    listPersistedSessions(): PersistedSession[];
+    getStatus(name: string): SessionInfo & {
+        stats: ReturnType<ISession['getStats']>;
+    };
+    grepSession(name: string, pattern: string, limit?: number): Promise<Array<{
+        time: string;
+        type: string;
+        content: string;
+    }>>;
+    compactSession(name: string, summary?: string): Promise<void>;
+    setEffort(name: string, level: EffortLevel): void;
+    /**
+     * Switch model for a session.
+     * Updates in-memory config only (takes effect on next restart/resume).
+     * For immediate effect, call restartWithConfig() explicitly.
+     */
+    setModel(name: string, model: string): void;
+    /**
+     * Switch model immediately by restarting the session with --resume.
+     * Conversation history is preserved via the claude session ID.
+     *
+     * Guards:
+     * - Rejects if session is currently processing a message (busy guard)
+     * - Validates model string against known aliases before restarting
+     * - Rolls back to old session if startSession fails
+     */
+    switchModel(name: string, model: string): Promise<SessionInfo>;
+    /**
+     * Update allowedTools or disallowedTools at runtime.
+     *
+     * The claude CLI does not support changing tool lists while running, so
+     * the only way to apply new constraints is to restart the process with
+     * the updated flags and --resume to replay conversation history.
+     *
+     * Guards:
+     * - Rejects if session is busy
+     * - Rolls back to old session if startSession fails
+     * - merge:true adds tools; removeTools removes specific tools from the list
+     */
+    updateTools(name: string, opts: {
+        allowedTools?: string[];
+        disallowedTools?: string[];
+        removeTools?: string[];
+        merge?: boolean;
+    }): Promise<SessionInfo>;
+    getCost(name: string): import("../types.js").CostBreakdown;
+    listAgents(cwd?: string): AgentInfo[];
+    createAgent(name: string, cwd?: string, description?: string, prompt?: string): string;
+    listSkills(cwd?: string): SkillInfo[];
+    createSkill(name: string, cwd?: string, opts?: {
+        description?: string;
+        prompt?: string;
+        trigger?: string;
+    }): string;
+    listRules(cwd?: string): RuleInfo[];
+    createRule(name: string, cwd?: string, opts?: {
+        description?: string;
+        content?: string;
+        paths?: string;
+        condition?: string;
+    }): string;
+    teamList(name: string): Promise<string>;
+    teamSend(name: string, teammate: string, message: string): Promise<SendResult>;
+    /**
+     * Returns an overview of all active sessions — analogous to a dashboard.
+     * Unlike claude_session_status (single session), this gives the aggregate
+     * view: how many sessions are running, which are busy, total uptime, etc.
+     */
+    health(): {
+        ok: boolean;
+        version: string;
+        sessions: number;
+        sessionNames: string[];
+        uptime: number;
+        details: Array<{
+            name: string;
+            ready: boolean;
+            busy: boolean;
+            paused: boolean;
+            turns: number;
+            costUsd: number;
+            contextPercent: number;
+            lastActivity: string | null;
+        }>;
+        circuitBreakers: Record<string, {
+            failures: number;
+            backoffUntil: string | null;
+        }>;
+    };
+    /** Return plugin version from package.json */
+    getVersion(): string;
+    /**
+     * Gracefully shut down the session manager.
+     *
+     * 1. Cancels the periodic TTL cleanup timer
+     * 2. Stops all ultrareview polling intervals
+     * 3. Sends SIGTERM to all active session child processes
+     * 4. Persists final session registry to disk
+     *
+     * After shutdown(), no new sessions can be started. Idempotent.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Read OpenClaw gateway config from ~/.openclaw/openclaw.json.
+     * Returns { url, key } or null if not configured.
+     */
+    private _readGatewayConfig;
+    /**
+     * Start a local proxy server (if not running) that converts Anthropic format
+     * to OpenAI format and forwards to the OpenClaw gateway.
+     * Returns the proxy port, or null if gateway is not available.
+     */
+    private _ensureProxyServer;
+    private _persistSession;
+    private static PID_FILE;
+    private _savePids;
+    /**
+     * Verify that a PID belongs to a known coding CLI before killing it.
+     * Prevents killing unrelated processes if the OS recycled the PID.
+     */
+    private _isKnownCliProcess;
+    private _cleanupOrphanedPids;
+    private _getSession;
+    private _toSessionInfo;
+    private _resolveModel;
+    private _listMdFiles;
+    private _createSession;
+    private councils;
+    private councilCleanupTimers;
+    councilStart(task: string, config: CouncilConfig): CouncilSession;
+    private _scheduleCouncilCleanup;
+    councilStatus(id: string): CouncilSession | undefined;
+    councilAbort(id: string): void;
+    councilInject(id: string, message: string): void;
+    councilReview(id: string): Promise<CouncilReviewResult>;
+    councilAccept(id: string): Promise<CouncilAcceptResult>;
+    councilReject(id: string, feedback: string): Promise<CouncilRejectResult>;
+    private get _sessionLookup();
+    sessionSendTo(from: string, to: string, message: string, summary?: string): Promise<{
+        delivered: boolean;
+        queued: boolean;
+    }>;
+    sessionInbox(name: string, unreadOnly?: boolean): InboxMessage[];
+    sessionDeliverInbox(name: string): Promise<number>;
+    private ultraplans;
+    ultraplanStart(task: string, opts?: {
+        model?: string;
+        cwd?: string;
+        timeout?: number;
+    }): UltraplanResult;
+    private _runUltraplan;
+    ultraplanStatus(id: string): UltraplanResult | undefined;
+    private ultrareviews;
+    private ultrareviewPollers;
+    ultrareviewStart(cwd: string, opts?: {
+        agentCount?: number;
+        maxDurationMinutes?: number;
+        model?: string;
+        focus?: string;
+    }): UltrareviewResult;
+    ultrareviewStatus(id: string): UltrareviewResult | undefined;
+    private _cleanupIdleSessions;
+}
+export {};
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/src/session/session-manager.d.ts.map

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