@lingxiao-office/sdk 1.0.0

package/dist/core/session/SessionCleanup.js

@@ -0,0 +1,24 @@
+export class SessionCleanup {
+    release(session) {
+        session._roundCompleteUnsub?.();
+        session._completedUnsub?.();
+        session._disposeTeamCommunication?.();
+        session.pool?.destroy?.();
+    }
+    cleanupIdle(sessions, lastActivity, ttlMs, now = Date.now()) {
+        const released = [];
+        for (const [sessionId, session] of sessions) {
+            const lastSeen = lastActivity.get(sessionId) ?? now;
+            if (now - lastSeen < ttlMs) {
+                continue;
+            }
+            this.release(session);
+            sessions.delete(sessionId);
+            lastActivity.delete(sessionId);
+            released.push(sessionId);
+        }
+        return released;
+    }
+}
+export default SessionCleanup;
+//# sourceMappingURL=SessionCleanup.js.map

package/dist/core/session/SessionCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionCleanup.js","sourceRoot":"","sources":["../../../src/core/session/SessionCleanup.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,cAAc;IACzB,OAAO,CAAC,OAA2B;QACjC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAChC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;QAC5B,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAC5B,CAAC;IAED,WAAW,CACT,QAAwB,EACxB,YAAiC,EACjC,KAAa,EACb,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAEhB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;YACpD,IAAI,GAAG,GAAG,QAAQ,GAAG,KAAK,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,eAAe,cAAc,CAAC"}

package/dist/core/session/SessionFactory.d.ts

@@ -0,0 +1,14 @@
+export interface SessionFactoryDeps<TSession, TInput = string> {
+    createRuntime: (input: TInput) => TSession | Promise<TSession>;
+    persist?: (session: TSession) => void | Promise<void>;
+}
+export declare class SessionFactory<TSession extends {
+    sessionId: string;
+}, TInput = string> {
+    private readonly createRuntime;
+    private readonly persist?;
+    constructor(deps: SessionFactoryDeps<TSession, TInput>);
+    create(input: TInput): Promise<TSession>;
+}
+export default SessionFactory;
+//# sourceMappingURL=SessionFactory.d.ts.map

package/dist/core/session/SessionFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionFactory.d.ts","sourceRoot":"","sources":["../../../src/core/session/SessionFactory.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,qBAAa,cAAc,CAAC,QAAQ,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,GAAG,MAAM;IACjF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkD;IAChF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA8C;gBAE3D,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC;IAKhD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAK/C;AAED,eAAe,cAAc,CAAC"}

package/dist/core/session/SessionFactory.js

@@ -0,0 +1,15 @@
+export class SessionFactory {
+    createRuntime;
+    persist;
+    constructor(deps) {
+        this.createRuntime = deps.createRuntime;
+        this.persist = deps.persist;
+    }
+    async create(input) {
+        const session = await this.createRuntime(input);
+        await this.persist?.(session);
+        return session;
+    }
+}
+export default SessionFactory;
+//# sourceMappingURL=SessionFactory.js.map

package/dist/core/session/SessionFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionFactory.js","sourceRoot":"","sources":["../../../src/core/session/SessionFactory.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,cAAc;IACR,aAAa,CAAkD;IAC/D,OAAO,CAA+C;IAEvE,YAAY,IAA0C;QACpD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,eAAe,cAAc,CAAC"}

package/dist/core/session/SessionFork.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SessionFork — fork a session from any message point, creating a new branch.
+ *
+ * Creates a new session that inherits all messages up to (and including) a
+ * specified message, plus session metadata. The original session is unchanged.
+ */
+import type { DatabaseManager } from '../Database.js';
+export interface ForkSessionOptions {
+    /** The session to fork from */
+    sessionId: string;
+    /** The message ID (rowid in leader_conversation) to fork at — all messages up to and including this one are copied */
+    messageId: number;
+}
+export interface ForkSessionResult {
+    newSessionId: string;
+    parentSessionId: string;
+    messagesCopied: number;
+}
+/**
+ * Fork a session from a specific message point.
+ *
+ * Steps:
+ *  1. Validate source session and message exist
+ *  2. Generate new session ID
+ *  3. Copy session metadata (workspace, status, name prefix)
+ *  4. Copy all messages up to and including messageId
+ *  5. Store parentSessionId in session_state for traceability
+ *  6. Return fork result
+ */
+export declare function forkSession(db: DatabaseManager, options: ForkSessionOptions): ForkSessionResult;
+//# sourceMappingURL=SessionFork.d.ts.map

package/dist/core/session/SessionFork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionFork.d.ts","sourceRoot":"","sources":["../../../src/core/session/SessionFork.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sHAAsH;IACtH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAgF/F"}

package/dist/core/session/SessionFork.js

@@ -0,0 +1,78 @@
+/**
+ * SessionFork — fork a session from any message point, creating a new branch.
+ *
+ * Creates a new session that inherits all messages up to (and including) a
+ * specified message, plus session metadata. The original session is unchanged.
+ */
+import { randomUUID } from 'crypto';
+import { SESSION_KEYS } from '../SessionStateKeys.js';
+/**
+ * Generate a unique session ID that doesn't collide with existing ones.
+ */
+function generateForkSessionId(db) {
+    let id;
+    let attempts = 0;
+    do {
+        id = randomUUID().substring(0, 16);
+        attempts++;
+        if (attempts > 10) {
+            id = randomUUID();
+            break;
+        }
+    } while (db.getSession(id) !== null);
+    return id;
+}
+/**
+ * Fork a session from a specific message point.
+ *
+ * Steps:
+ *  1. Validate source session and message exist
+ *  2. Generate new session ID
+ *  3. Copy session metadata (workspace, status, name prefix)
+ *  4. Copy all messages up to and including messageId
+ *  5. Store parentSessionId in session_state for traceability
+ *  6. Return fork result
+ */
+export function forkSession(db, options) {
+    const { sessionId, messageId } = options;
+    // 1. Validate source session exists
+    const sourceSession = db.getSession(sessionId);
+    if (!sourceSession) {
+        throw new Error(`Source session not found: ${sessionId}`);
+    }
+    // 2. Validate message exists and belongs to the session
+    const conn = db.getDb();
+    const targetMsg = conn.prepare('SELECT id, timestamp FROM leader_conversation WHERE session_id = ? AND id = ?').get(sessionId, messageId);
+    if (!targetMsg) {
+        throw new Error(`Message ${messageId} not found in session ${sessionId}`);
+    }
+    // 3. Generate new session ID
+    const newSessionId = generateForkSessionId(db);
+    // 4. Copy session metadata
+    const now = Date.now() / 1000;
+    conn.prepare('INSERT INTO sessions (id, created_at, workspace, user_request, status, name) VALUES (?, ?, ?, ?, ?, ?)').run(newSessionId, now, sourceSession.workspace, typeof sourceSession.user_request === 'string'
+        ? sourceSession.user_request
+        : JSON.stringify(sourceSession.user_request), 'active', sourceSession.name ? `Fork: ${sourceSession.name}` : null);
+    // 5. Copy all messages up to and including messageId (by rowid order)
+    const messages = conn.prepare(`SELECT role, content, tool_calls, tool_call_id, thinking_blocks, timestamp
+     FROM leader_conversation
+     WHERE session_id = ? AND id <= ?
+     ORDER BY id`).all(sessionId, messageId);
+    for (const msg of messages) {
+        conn.prepare(`INSERT INTO leader_conversation
+       (session_id, role, content, tool_calls, tool_call_id, thinking_blocks, timestamp)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`).run(newSessionId, msg.role, msg.content, msg.tool_calls, msg.tool_call_id, msg.thinking_blocks, msg.timestamp);
+    }
+    // 6. Store parentSessionId for traceability
+    db.setSessionState(newSessionId, SESSION_KEYS.FORK_PARENT_SESSION_ID, {
+        parentSessionId: sessionId,
+        forkedAtMessageId: messageId,
+        forkedAt: Date.now(),
+    });
+    return {
+        newSessionId,
+        parentSessionId: sessionId,
+        messagesCopied: messages.length,
+    };
+}
+//# sourceMappingURL=SessionFork.js.map

package/dist/core/session/SessionFork.js.map

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

package/dist/core/session/SessionInitialization.d.ts

@@ -0,0 +1,23 @@
+import type { DatabaseManager } from '../Database.js';
+type LoggerLike = {
+    warn?: (msg: string, ...args: unknown[]) => void;
+};
+export declare function generateUniqueSessionId(sessions: Map<string, unknown>, db: DatabaseManager): string;
+export declare function ensureSessionDirectories(sessionId: string, workspace: string): void;
+export declare function createInitializationGate<T>(input: {
+    sessionId: string;
+    timeoutMs: number;
+    initializingSessions: Map<string, Promise<T>>;
+    logger?: LoggerLike;
+}): {
+    promise: Promise<T>;
+    resolve: (state: T) => void;
+    reject: (err: unknown) => void;
+};
+export declare function shouldAutoExtractMemory(autoExtractSoulOnComplete: boolean, memoryConfig: {
+    enabled?: boolean;
+    auto_memory_enabled?: boolean;
+}): boolean;
+export declare function buildLeaderSkillDigest(workspacePath: string): string;
+export {};
+//# sourceMappingURL=SessionInitialization.d.ts.map

package/dist/core/session/SessionInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionInitialization.d.ts","sourceRoot":"","sources":["../../../src/core/session/SessionInitialization.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,EAAE,EAAE,eAAe,GAClB,MAAM,CAYR;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOnF;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG;IACF,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAChC,CAqBA;AAED,wBAAgB,uBAAuB,CACrC,yBAAyB,EAAE,OAAO,EAClC,YAAY,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAET;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGpE"}

package/dist/core/session/SessionInitialization.js

@@ -0,0 +1,55 @@
+import { randomUUID } from 'crypto';
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+import { Workspace } from '../Workspace.js';
+import { buildSkillDigest, collectAvailableSkills, resolveDisabledSkillNames, } from '../SkillCatalog.js';
+export function generateUniqueSessionId(sessions, db) {
+    let sessionId;
+    let attempts = 0;
+    do {
+        sessionId = randomUUID().substring(0, 16);
+        attempts++;
+        if (attempts > 10) {
+            sessionId = randomUUID();
+            break;
+        }
+    } while (sessions.has(sessionId) || db.getSession(sessionId) !== undefined);
+    return sessionId;
+}
+export function ensureSessionDirectories(sessionId, workspace) {
+    const scratchpadDir = Workspace.getScratchpadDir(sessionId, workspace);
+    const contextDir = Workspace.getContextDir(sessionId, workspace);
+    const agentsDir = join(Workspace.getSessionArtifactPaths(sessionId, workspace).sessionDir, 'agents');
+    mkdirSync(scratchpadDir, { recursive: true });
+    mkdirSync(contextDir, { recursive: true });
+    mkdirSync(agentsDir, { recursive: true });
+}
+export function createInitializationGate(input) {
+    let resolve;
+    let reject;
+    let settled = false;
+    const promise = new Promise((res, rej) => {
+        resolve = (state) => { settled = true; res(state); };
+        reject = (err) => { settled = true; rej(err); };
+    });
+    promise.catch(() => { });
+    const timer = setTimeout(() => {
+        if (!settled) {
+            settled = true;
+            reject(new Error(`Session ${input.sessionId} initialization timed out after ${input.timeoutMs}ms`));
+            input.initializingSessions.delete(input.sessionId);
+            input.logger?.warn?.(`[SessionManager] 会话 ${input.sessionId} 初始化超时(${input.timeoutMs}ms)，已从 initializingSessions 移除`);
+        }
+    }, input.timeoutMs);
+    if (timer.unref)
+        timer.unref();
+    return { promise, resolve, reject };
+}
+export function shouldAutoExtractMemory(autoExtractSoulOnComplete, memoryConfig) {
+    return autoExtractSoulOnComplete && memoryConfig.enabled !== false && memoryConfig.auto_memory_enabled !== false;
+}
+export function buildLeaderSkillDigest(workspacePath) {
+    const disabledNames = resolveDisabledSkillNames();
+    return buildSkillDigest(collectAvailableSkills(workspacePath, { disabledNames }));
+}
+//# sourceMappingURL=SessionInitialization.js.map

package/dist/core/session/SessionInitialization.js.map

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

package/dist/core/session/SessionStateSync.d.ts

@@ -0,0 +1,14 @@
+export interface SessionStateStore {
+    getSessionState?: (sessionId: string, key: string) => unknown;
+    setSessionState?: (sessionId: string, key: string, value: unknown) => void;
+    updateSessionState?: (sessionId: string, key: string, updater: (current: unknown) => unknown) => void;
+}
+export declare class SessionStateSync {
+    private readonly store;
+    constructor(store: SessionStateStore);
+    load<T>(sessionId: string, key: string, fallback: T): T;
+    save(sessionId: string, key: string, value: unknown): void;
+    update<T>(sessionId: string, key: string, updater: (current: T | null | undefined) => T): void;
+}
+export default SessionStateSync;
+//# sourceMappingURL=SessionStateSync.d.ts.map

package/dist/core/session/SessionStateSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStateSync.d.ts","sourceRoot":"","sources":["../../../src/core/session/SessionStateSync.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9D,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3E,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAAK,IAAI,CAAC;CACvG;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAE9B,KAAK,EAAE,iBAAiB;IAIpC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAKvD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1D,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,KAAK,CAAC,GAAG,IAAI;CAQ/F;AAED,eAAe,gBAAgB,CAAC"}

package/dist/core/session/SessionStateSync.js

@@ -0,0 +1,23 @@
+export class SessionStateSync {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    load(sessionId, key, fallback) {
+        const value = this.store.getSessionState?.(sessionId, key);
+        return (value ?? fallback);
+    }
+    save(sessionId, key, value) {
+        this.store.setSessionState?.(sessionId, key, value);
+    }
+    update(sessionId, key, updater) {
+        if (this.store.updateSessionState) {
+            this.store.updateSessionState(sessionId, key, (current) => updater(current));
+            return;
+        }
+        const next = updater(this.store.getSessionState?.(sessionId, key));
+        this.save(sessionId, key, next);
+    }
+}
+export default SessionStateSync;
+//# sourceMappingURL=SessionStateSync.js.map

package/dist/core/session/SessionStateSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStateSync.js","sourceRoot":"","sources":["../../../src/core/session/SessionStateSync.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,gBAAgB;IACV,KAAK,CAAoB;IAE1C,YAAY,KAAwB;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,CAAI,SAAiB,EAAE,GAAW,EAAE,QAAW;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAM,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;QACjD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAI,SAAiB,EAAE,GAAW,EAAE,OAA6C;QACrF,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAA+B,CAAC,CAAC,CAAC;YACrG,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,GAAG,CAAyB,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;CACF;AAED,eAAe,gBAAgB,CAAC"}

package/dist/core/session/TurnCoordinator.d.ts

@@ -0,0 +1,3 @@
+export { TurnCoordinator } from '../TurnCoordinator.js';
+export type { InteractionTurnState } from '../TurnCoordinator.js';
+//# sourceMappingURL=TurnCoordinator.d.ts.map

package/dist/core/session/TurnCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnCoordinator.d.ts","sourceRoot":"","sources":["../../../src/core/session/TurnCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/session/TurnCoordinator.js

@@ -0,0 +1,2 @@
+export { TurnCoordinator } from '../TurnCoordinator.js';
+//# sourceMappingURL=TurnCoordinator.js.map

package/dist/core/session/TurnCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnCoordinator.js","sourceRoot":"","sources":["../../../src/core/session/TurnCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/terminalRestore.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 终端状态还原 — 单一事实源。
+ *
+ * 背景（bug）：TUI 启用了 mouse tracking（DECSET ?1000/?1002/?1006）与 bracketed
+ * paste（?2004），还隐藏了光标（?25l）。这些 DEC 私有模式是「进程级终端状态」，
+ * 进程退出时若不显式还原，宿主终端会残留在 mouse-tracking/raw 状态——表现为用户
+ * 鼠标移动/点击在 shell 里打出 `^[[<65;70;25M` 这类 SGR 鼠标上报序列（截图症状）。
+ *
+ * 原实现只在 React useEffect cleanup（正常 unmount）里还原，异常退出路径
+ * （uncaughtException / unhandledRejection / SIGINT 强退 / gracefulShutdown 强退）
+ * 完全不还原，于是 crash 一次就把用户终端搞坏。
+ *
+ * 本模块把还原序列收敛为单一函数，挂到所有退出路径，best-effort、幂等、绝不抛错。
+ */
+/** DEC 私有模式还原序列（与 useRawTerminalInput 启用序列严格对称）：
+ *  - ?2004l 关闭 bracketed paste
+ *  - ?1002l 关闭按钮+拖拽 mouse tracking
+ *  - ?1000l 关闭基础 mouse tracking
+ *  - ?1006l 关闭 SGR 扩展鼠标坐标编码
+ *  - ?25h   恢复光标显示（TUI 启动时 ?25l 隐藏过）
+ */
+declare const TERMINAL_RESTORE_SEQUENCE = "\u001B[?2004l\u001B[?1002l\u001B[?1000l\u001B[?1006l\u001B[?25h";
+/**
+ * 还原宿主终端状态（关闭 mouse tracking / bracketed paste，显示光标）。
+ *
+ * - 幂等：多次调用只在首次真正写入（exit handler / finally / 信号 / crash 可能重复触发）；
+ *   传 force=true 可绕过幂等闸（用于显式重新进入 TUI 前的清场）。
+ * - best-effort：非 TTY 或写入异常一律静默吞掉，绝不影响退出流程。
+ */
+export declare function restoreTerminalState(options?: {
+    force?: boolean;
+}): void;
+/** 重置幂等闸——重新进入 TUI 渲染前调用，使下次退出能再次还原。 */
+export declare function resetTerminalRestoreLatch(): void;
+export { TERMINAL_RESTORE_SEQUENCE };
+//# sourceMappingURL=terminalRestore.d.ts.map

package/dist/core/terminalRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalRestore.d.ts","sourceRoot":"","sources":["../../src/core/terminalRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,QAAA,MAAM,yBAAyB,oEAC+B,CAAC;AAI/D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAYxE;AAED,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/core/terminalRestore.js

@@ -0,0 +1,52 @@
+/**
+ * 终端状态还原 — 单一事实源。
+ *
+ * 背景（bug）：TUI 启用了 mouse tracking（DECSET ?1000/?1002/?1006）与 bracketed
+ * paste（?2004），还隐藏了光标（?25l）。这些 DEC 私有模式是「进程级终端状态」，
+ * 进程退出时若不显式还原，宿主终端会残留在 mouse-tracking/raw 状态——表现为用户
+ * 鼠标移动/点击在 shell 里打出 `^[[<65;70;25M` 这类 SGR 鼠标上报序列（截图症状）。
+ *
+ * 原实现只在 React useEffect cleanup（正常 unmount）里还原，异常退出路径
+ * （uncaughtException / unhandledRejection / SIGINT 强退 / gracefulShutdown 强退）
+ * 完全不还原，于是 crash 一次就把用户终端搞坏。
+ *
+ * 本模块把还原序列收敛为单一函数，挂到所有退出路径，best-effort、幂等、绝不抛错。
+ */
+const ESC = '\x1b[';
+/** DEC 私有模式还原序列（与 useRawTerminalInput 启用序列严格对称）：
+ *  - ?2004l 关闭 bracketed paste
+ *  - ?1002l 关闭按钮+拖拽 mouse tracking
+ *  - ?1000l 关闭基础 mouse tracking
+ *  - ?1006l 关闭 SGR 扩展鼠标坐标编码
+ *  - ?25h   恢复光标显示（TUI 启动时 ?25l 隐藏过）
+ */
+const TERMINAL_RESTORE_SEQUENCE = `${ESC}?2004l${ESC}?1002l${ESC}?1000l${ESC}?1006l${ESC}?25h`;
+let restoredOnce = false;
+/**
+ * 还原宿主终端状态（关闭 mouse tracking / bracketed paste，显示光标）。
+ *
+ * - 幂等：多次调用只在首次真正写入（exit handler / finally / 信号 / crash 可能重复触发）；
+ *   传 force=true 可绕过幂等闸（用于显式重新进入 TUI 前的清场）。
+ * - best-effort：非 TTY 或写入异常一律静默吞掉，绝不影响退出流程。
+ */
+export function restoreTerminalState(options) {
+    if (restoredOnce && !options?.force)
+        return;
+    restoredOnce = true;
+    try {
+        const stdout = process.stdout;
+        // 仅对真实 TTY 写还原序列；管道/重定向场景写控制序列会污染输出。
+        if (stdout && stdout.isTTY) {
+            stdout.write(TERMINAL_RESTORE_SEQUENCE);
+        }
+    }
+    catch {
+        // 还原是 best-effort：退出路径里任何异常都不能阻塞进程退出。
+    }
+}
+/** 重置幂等闸——重新进入 TUI 渲染前调用，使下次退出能再次还原。 */
+export function resetTerminalRestoreLatch() {
+    restoredOnce = false;
+}
+export { TERMINAL_RESTORE_SEQUENCE };
+//# sourceMappingURL=terminalRestore.js.map

package/dist/core/terminalRestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalRestore.js","sourceRoot":"","sources":["../../src/core/terminalRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,yBAAyB,GAC7B,GAAG,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,IAAI,YAAY,IAAI,CAAC,OAAO,EAAE,KAAK;QAAE,OAAO;IAC5C,YAAY,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,qCAAqC;QACrC,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,yBAAyB;IACvC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/core/transport/LocalTransport.d.ts

@@ -0,0 +1,11 @@
+import type { Transport, TransportEnvelope } from './Transport.js';
+export declare class LocalTransport implements Transport {
+    readonly type: "local";
+    private handler;
+    send(envelope: TransportEnvelope): void;
+    onMessage(handler: (envelope: TransportEnvelope) => void): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isAlive(): boolean;
+}
+//# sourceMappingURL=LocalTransport.d.ts.map

package/dist/core/transport/LocalTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalTransport.d.ts","sourceRoot":"","sources":["../../../src/core/transport/LocalTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,OAAO,CAAwD;IAEvE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvC,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;IAIzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,IAAI,OAAO;CAGnB"}

package/dist/core/transport/LocalTransport.js

@@ -0,0 +1,20 @@
+export class LocalTransport {
+    type = 'local';
+    handler = null;
+    send(envelope) {
+        this.handler?.(envelope);
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    async connect() {
+        // Local transport is always available.
+    }
+    async disconnect() {
+        // Local transport has no resources to release.
+    }
+    isAlive() {
+        return true;
+    }
+}
+//# sourceMappingURL=LocalTransport.js.map

package/dist/core/transport/LocalTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalTransport.js","sourceRoot":"","sources":["../../../src/core/transport/LocalTransport.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,OAAgB,CAAC;IACzB,OAAO,GAAmD,IAAI,CAAC;IAEvE,IAAI,CAAC,QAA2B;QAC9B,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,OAA8C;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,uCAAuC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,+CAA+C;IACjD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/transport/RemoteWorkerRegistry.d.ts

@@ -0,0 +1,25 @@
+export interface RemoteWorkerDescriptor {
+    id: string;
+    endpoint: string;
+    capabilities: string[];
+    maxConcurrency: number;
+    currentLoad: number;
+    region?: string;
+    lastHeartbeat: number;
+}
+export interface RemoteWorkerRequirements {
+    tools?: string[];
+    preferLocal?: boolean;
+}
+export declare class RemoteWorkerRegistry {
+    private readonly workers;
+    register(descriptor: RemoteWorkerDescriptor): void;
+    deregister(workerId: string): void;
+    findWorker(requirements: RemoteWorkerRequirements): RemoteWorkerDescriptor | null;
+    getAliveWorkers(maxAge?: number): RemoteWorkerDescriptor[];
+    markHeartbeat(workerId: string): void;
+    markAssigned(workerId: string): RemoteWorkerDescriptor | null;
+    markReleased(workerId: string): RemoteWorkerDescriptor | null;
+    pruneStale(maxAge: number): string[];
+}
+//# sourceMappingURL=RemoteWorkerRegistry.d.ts.map

package/dist/core/transport/RemoteWorkerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteWorkerRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/transport/RemoteWorkerRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,QAAQ,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAUlD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,UAAU,CAAC,YAAY,EAAE,wBAAwB,GAAG,sBAAsB,GAAG,IAAI;IAsBjF,eAAe,CAAC,MAAM,SAAS,GAAG,sBAAsB,EAAE;IAO1D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAO7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAO7D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;CAWrC"}

package/dist/core/transport/RemoteWorkerRegistry.js

@@ -0,0 +1,77 @@
+export class RemoteWorkerRegistry {
+    workers = new Map();
+    register(descriptor) {
+        this.workers.set(descriptor.id, {
+            ...descriptor,
+            capabilities: [...descriptor.capabilities],
+            currentLoad: Math.max(0, descriptor.currentLoad),
+            maxConcurrency: Math.max(1, descriptor.maxConcurrency),
+            lastHeartbeat: descriptor.lastHeartbeat || Date.now(),
+        });
+    }
+    deregister(workerId) {
+        this.workers.delete(workerId);
+    }
+    findWorker(requirements) {
+        if (requirements.preferLocal)
+            return null;
+        const required = new Set(requirements.tools ?? []);
+        const candidates = this.getAliveWorkers()
+            .filter((worker) => worker.currentLoad < worker.maxConcurrency)
+            .filter((worker) => {
+            if (required.size === 0)
+                return true;
+            const caps = new Set(worker.capabilities);
+            for (const tool of required) {
+                if (!caps.has(tool))
+                    return false;
+            }
+            return true;
+        })
+            .sort((a, b) => {
+            const loadA = a.currentLoad / a.maxConcurrency;
+            const loadB = b.currentLoad / b.maxConcurrency;
+            if (loadA !== loadB)
+                return loadA - loadB;
+            return b.lastHeartbeat - a.lastHeartbeat;
+        });
+        return candidates[0] ?? null;
+    }
+    getAliveWorkers(maxAge = 60_000) {
+        const cutoff = Date.now() - maxAge;
+        return Array.from(this.workers.values())
+            .filter((worker) => worker.lastHeartbeat >= cutoff)
+            .map((worker) => ({ ...worker, capabilities: [...worker.capabilities] }));
+    }
+    markHeartbeat(workerId) {
+        const worker = this.workers.get(workerId);
+        if (worker)
+            worker.lastHeartbeat = Date.now();
+    }
+    markAssigned(workerId) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return null;
+        worker.currentLoad = Math.min(worker.maxConcurrency, worker.currentLoad + 1);
+        return { ...worker, capabilities: [...worker.capabilities] };
+    }
+    markReleased(workerId) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return null;
+        worker.currentLoad = Math.max(0, worker.currentLoad - 1);
+        return { ...worker, capabilities: [...worker.capabilities] };
+    }
+    pruneStale(maxAge) {
+        const cutoff = Date.now() - maxAge;
+        const pruned = [];
+        for (const [id, worker] of this.workers.entries()) {
+            if (worker.lastHeartbeat < cutoff) {
+                this.workers.delete(id);
+                pruned.push(id);
+            }
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=RemoteWorkerRegistry.js.map

package/dist/core/transport/RemoteWorkerRegistry.js.map

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

package/dist/core/transport/Transport.d.ts

@@ -0,0 +1,18 @@
+export interface TransportEnvelope {
+    version: 1;
+    type: 'task_dispatch' | 'task_complete' | 'task_failed' | 'heartbeat' | 'bus_message' | 'worker_register' | 'worker_deregister' | 'ack';
+    id: string;
+    traceId?: string;
+    timestamp: number;
+    payload: unknown;
+}
+export interface Transport {
+    readonly type: 'local' | 'websocket';
+    send(envelope: TransportEnvelope): void;
+    onMessage(handler: (envelope: TransportEnvelope) => void): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isAlive(): boolean;
+}
+export declare function createEnvelope(type: TransportEnvelope['type'], payload: unknown): TransportEnvelope;
+//# sourceMappingURL=Transport.d.ts.map

package/dist/core/transport/Transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.d.ts","sourceRoot":"","sources":["../../../src/core/transport/Transport.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EACA,eAAe,GACf,eAAe,GACf,aAAa,GACb,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,mBAAmB,GACnB,KAAK,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAanG"}