sensorium-mcp 2.17.28 → 3.0.0

package/dist/services/thread-health.service.js.map

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

package/dist/services/thread-lifecycle.service.d.ts

@@ -0,0 +1,52 @@
+import type { Database } from "../data/memory/schema.js";
+import type { IThreadRepository, ISessionRepository } from "../data/interfaces.js";
+export declare enum ThreadState {
+    Active = "active",
+    Dormant = "dormant",
+    Exited = "exited",
+    Archived = "archived",
+    Expired = "expired"
+}
+type ThreadRecord = NonNullable<ReturnType<IThreadRepository["getThread"]>>;
+type RegisterThreadInput = Parameters<IThreadRepository["registerThread"]>[1] & {
+    chatId?: string;
+    aliases?: string[];
+    telegramTopicId?: number | null;
+};
+type ActivateThreadInput = Partial<Pick<ThreadRecord, "client" | "keepAlive" | "lastActiveAt" | "telegramTopicId" | "workingDirectory">>;
+type TouchThreadInput = Partial<Pick<ThreadRecord, "lastActiveAt" | "telegramTopicId">>;
+type RemapTopicInput = {
+    threadId: number;
+    chatId: string;
+    topicName: string;
+    telegramTopicId: number;
+    aliases?: string[];
+};
+export interface ThreadLifecycleTelegramGateway {
+    sendMessage(chatId: string, text: string, parseMode?: string, threadId?: number): Promise<unknown>;
+}
+export interface ThreadLifecycleLogger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+export declare class ThreadLifecycleService {
+    private readonly threadRepository;
+    private readonly sessionRepository;
+    private readonly telegramGateway;
+    private readonly logger;
+    constructor(threadRepository: IThreadRepository, sessionRepository: ISessionRepository, telegramGateway: ThreadLifecycleTelegramGateway, logger: ThreadLifecycleLogger);
+    registerThread(db: Database, entry: RegisterThreadInput): ThreadRecord;
+    activateThread(db: Database, threadId: number, updates?: ActivateThreadInput): ThreadRecord;
+    touchThread(db: Database, threadId: number, updates?: TouchThreadInput): ThreadRecord;
+    markExited(db: Database, threadId: number): ThreadRecord;
+    archiveThread(db: Database, threadId: number): ThreadRecord;
+    remapTopic(db: Database, input: RemapTopicInput): ThreadRecord;
+    getThreadState(db: Database, threadId: number): ThreadState | null;
+    private requireThread;
+    private assertTransition;
+    private syncTopicMappings;
+    private toLifecycleState;
+    private toPersistedState;
+}
+export {};
+//# sourceMappingURL=thread-lifecycle.service.d.ts.map

package/dist/services/thread-lifecycle.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-lifecycle.service.d.ts","sourceRoot":"","sources":["../../src/services/thread-lifecycle.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAG5E,KAAK,mBAAmB,GAAG,UAAU,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,KAAK,mBAAmB,GAAG,OAAO,CAChC,IAAI,CACF,YAAY,EACZ,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CACjF,CACF,CAAC;AAEF,KAAK,gBAAgB,GAAG,OAAO,CAC7B,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,iBAAiB,CAAC,CACvD,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpG;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAyBD,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,gBAAgB,EAAE,iBAAiB,EACnC,iBAAiB,EAAE,kBAAkB,EACrC,eAAe,EAAE,8BAA8B,EAC/C,MAAM,EAAE,qBAAqB;IAGhD,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,GAAG,YAAY;IAmBtE,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY;IAe/F,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,YAAY;IAezF,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAkBxD,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAe3D,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,YAAY;IA6B9D,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAKlE,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/services/thread-lifecycle.service.js

@@ -0,0 +1,174 @@
+import { unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export var ThreadState;
+(function (ThreadState) {
+    ThreadState["Active"] = "active";
+    ThreadState["Dormant"] = "dormant";
+    ThreadState["Exited"] = "exited";
+    ThreadState["Archived"] = "archived";
+    ThreadState["Expired"] = "expired";
+})(ThreadState || (ThreadState = {}));
+const VALID_TRANSITIONS = {
+    [ThreadState.Active]: new Set([ThreadState.Active, ThreadState.Dormant, ThreadState.Exited, ThreadState.Archived, ThreadState.Expired]),
+    [ThreadState.Dormant]: new Set([ThreadState.Active, ThreadState.Archived, ThreadState.Expired]),
+    [ThreadState.Exited]: new Set([ThreadState.Active, ThreadState.Archived, ThreadState.Expired]),
+    [ThreadState.Archived]: new Set(),
+    [ThreadState.Expired]: new Set([ThreadState.Archived]),
+};
+function cleanupThreadFiles(threadId) {
+    const base = join(homedir(), ".remote-copilot-mcp");
+    for (const filePath of [
+        join(base, "heartbeats", `${threadId}.json`),
+        join(base, "schedules", `${threadId}.json`),
+        join(base, "threads", `${threadId}.jsonl`),
+    ]) {
+        try {
+            unlinkSync(filePath);
+        }
+        catch {
+            // Missing files are expected for some thread lifecycles.
+        }
+    }
+}
+export class ThreadLifecycleService {
+    threadRepository;
+    sessionRepository;
+    telegramGateway;
+    logger;
+    constructor(threadRepository, sessionRepository, telegramGateway, logger) {
+        this.threadRepository = threadRepository;
+        this.sessionRepository = sessionRepository;
+        this.telegramGateway = telegramGateway;
+        this.logger = logger;
+    }
+    registerThread(db, entry) {
+        const current = this.threadRepository.getThread(db, entry.threadId);
+        this.assertTransition(current?.status, ThreadState.Active, "registerThread");
+        this.threadRepository.registerThread(db, entry);
+        if (entry.telegramTopicId !== undefined) {
+            this.threadRepository.updateThread(db, entry.threadId, { telegramTopicId: entry.telegramTopicId });
+        }
+        this.syncTopicMappings(entry.chatId, entry.name, entry.threadId, entry.aliases);
+        const updated = this.threadRepository.getThread(db, entry.threadId);
+        if (!updated) {
+            throw new Error(`registerThread: failed to load thread ${entry.threadId} after registration`);
+        }
+        this.logger.info(`[thread-lifecycle] registerThread -> active (${entry.threadId})`);
+        return updated;
+    }
+    activateThread(db, threadId, updates = {}) {
+        const current = this.requireThread(db, threadId, "activateThread");
+        this.assertTransition(current.status, ThreadState.Active, "activateThread");
+        this.threadRepository.updateThread(db, threadId, {
+            ...updates,
+            status: ThreadState.Active,
+            lastActiveAt: updates.lastActiveAt ?? new Date().toISOString(),
+        });
+        const updated = this.requireThread(db, threadId, "activateThread");
+        this.logger.info(`[thread-lifecycle] activateThread -> active (${threadId})`);
+        return updated;
+    }
+    touchThread(db, threadId, updates = {}) {
+        const current = this.requireThread(db, threadId, "touchThread");
+        this.assertTransition(current.status, ThreadState.Active, "touchThread");
+        this.threadRepository.updateThread(db, threadId, {
+            ...updates,
+            status: ThreadState.Active,
+            lastActiveAt: updates.lastActiveAt ?? new Date().toISOString(),
+        });
+        const updated = this.requireThread(db, threadId, "touchThread");
+        this.logger.info(`[thread-lifecycle] touchThread -> active (${threadId})`);
+        return updated;
+    }
+    markExited(db, threadId) {
+        const current = this.requireThread(db, threadId, "markExited");
+        const nextState = current.type === "worker" && !current.keepAlive
+            ? ThreadState.Exited
+            : ThreadState.Active;
+        this.assertTransition(current.status, nextState, "markExited");
+        this.threadRepository.updateThread(db, threadId, {
+            status: this.toPersistedState(nextState),
+            lastActiveAt: new Date().toISOString(),
+        });
+        const updated = this.requireThread(db, threadId, "markExited");
+        cleanupThreadFiles(threadId);
+        this.logger.info(`[thread-lifecycle] markExited -> ${nextState} (${threadId})`);
+        return updated;
+    }
+    archiveThread(db, threadId) {
+        const current = this.requireThread(db, threadId, "archiveThread");
+        this.assertTransition(current.status, ThreadState.Archived, "archiveThread");
+        this.threadRepository.updateThread(db, threadId, {
+            status: ThreadState.Archived,
+            keepAlive: false,
+        });
+        const updated = this.requireThread(db, threadId, "archiveThread");
+        cleanupThreadFiles(threadId);
+        this.logger.info(`[thread-lifecycle] archiveThread -> archived (${threadId})`);
+        return updated;
+    }
+    remapTopic(db, input) {
+        const current = this.requireThread(db, input.threadId, "remapTopic");
+        this.assertTransition(current.status, ThreadState.Active, "remapTopic");
+        this.threadRepository.updateThread(db, input.threadId, {
+            status: ThreadState.Active,
+            telegramTopicId: input.telegramTopicId,
+            lastActiveAt: new Date().toISOString(),
+        });
+        this.syncTopicMappings(input.chatId, input.topicName, input.threadId, input.aliases);
+        if (input.telegramTopicId !== input.threadId) {
+            void this.telegramGateway.sendMessage(input.chatId, "Thread remapped. Continuing in the replacement topic.", undefined, input.telegramTopicId).catch(() => {
+                this.logger.warn(`[thread-lifecycle] remapTopic notification failed for logical thread ${input.threadId}`);
+            });
+        }
+        const updated = this.requireThread(db, input.threadId, "remapTopic");
+        this.logger.info(`[thread-lifecycle] remapTopic -> active (${input.threadId} -> ${input.telegramTopicId})`);
+        return updated;
+    }
+    getThreadState(db, threadId) {
+        const thread = this.threadRepository.getThread(db, threadId);
+        return thread ? this.toLifecycleState(thread.status) : null;
+    }
+    requireThread(db, threadId, action) {
+        const thread = this.threadRepository.getThread(db, threadId);
+        if (!thread) {
+            throw new Error(`${action}: thread ${threadId} is not registered`);
+        }
+        return thread;
+    }
+    assertTransition(current, next, action) {
+        if (current === undefined) {
+            if (next !== ThreadState.Active) {
+                throw new Error(`${action}: unregistered threads can only transition to active`);
+            }
+            return;
+        }
+        const allowed = VALID_TRANSITIONS[this.toLifecycleState(current)];
+        if (!allowed.has(next)) {
+            throw new Error(`${action}: invalid transition ${current} -> ${next}`);
+        }
+    }
+    syncTopicMappings(chatId, name, threadId, aliases) {
+        if (!chatId)
+            return;
+        this.sessionRepository.setSession(chatId, name, threadId);
+        this.sessionRepository.registerTopicRegistry(chatId, name, threadId);
+        for (const alias of aliases ?? []) {
+            if (!alias || alias === name)
+                continue;
+            this.sessionRepository.setSession(chatId, alias, threadId);
+            this.sessionRepository.registerTopicRegistry(chatId, alias, threadId);
+        }
+    }
+    toLifecycleState(state) {
+        return state;
+    }
+    toPersistedState(state) {
+        if (state === ThreadState.Dormant) {
+            throw new Error("dormant is defined in the lifecycle model but is not yet persisted in thread_registry");
+        }
+        return state;
+    }
+}
+//# sourceMappingURL=thread-lifecycle.service.js.map

package/dist/services/thread-lifecycle.service.js.map

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

package/dist/services/topic.service.d.ts

@@ -0,0 +1,25 @@
+import type { Database } from "../data/memory/schema.js";
+import type { ThreadLifecycleService } from "./thread-lifecycle.service.js";
+type TopicTelegram = {
+    createForumTopic(chatId: string, name: string): Promise<{
+        message_thread_id: number;
+    }>;
+    sendMessage(chatId: string, text: string, parseMode?: string, threadId?: number): Promise<unknown>;
+};
+export declare function createManagedTopic(telegram: TopicTelegram, chatId: string, topicName: string, aliases?: string[]): Promise<number>;
+export declare function resolveExistingTopic(chatId: string, names: string[]): number | undefined;
+export declare function probeOrRemapTopic(opts: {
+    telegram: TopicTelegram;
+    chatId: string;
+    logicalThreadId: number;
+    topicName: string;
+    db: Database;
+    threadLifecycle: ThreadLifecycleService;
+    aliases?: string[];
+    probeText: string;
+}): Promise<{
+    remapped: boolean;
+}>;
+export declare function deleteTelegramTopicByBotApi(token: string, chatId: string, topicId: number): Promise<void>;
+export {};
+//# sourceMappingURL=topic.service.d.ts.map

package/dist/services/topic.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.service.d.ts","sourceRoot":"","sources":["../../src/services/topic.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAI5E,KAAK,aAAa,GAAG;IACnB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpG,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAM,EAAO,GACrB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAYxF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,EAAE,sBAAsB,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBjC;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/services/topic.service.js

@@ -0,0 +1,65 @@
+import { persistSession, lookupSession, lookupTopicRegistry, registerTopic } from "../sessions.js";
+import { errorMessage } from "../utils.js";
+import { log } from "../logger.js";
+export async function createManagedTopic(telegram, chatId, topicName, aliases = []) {
+    const topic = await telegram.createForumTopic(chatId, topicName);
+    persistSession(chatId, topicName, topic.message_thread_id);
+    registerTopic(chatId, topicName, topic.message_thread_id);
+    for (const alias of aliases) {
+        if (alias && alias !== topicName)
+            persistSession(chatId, alias, topic.message_thread_id);
+    }
+    return topic.message_thread_id;
+}
+export function resolveExistingTopic(chatId, names) {
+    for (const name of names) {
+        if (!name)
+            continue;
+        const registryId = lookupTopicRegistry(chatId, name);
+        if (registryId !== undefined) {
+            persistSession(chatId, name, registryId);
+            return registryId;
+        }
+        const sessionId = lookupSession(chatId, name);
+        if (sessionId !== undefined)
+            return sessionId;
+    }
+    return undefined;
+}
+export async function probeOrRemapTopic(opts) {
+    const { telegram, chatId, logicalThreadId, topicName, db, threadLifecycle, aliases = [], probeText } = opts;
+    try {
+        await telegram.sendMessage(chatId, probeText, undefined, logicalThreadId);
+        return { remapped: false };
+    }
+    catch (err) {
+        const msg = errorMessage(err);
+        if (!/thread not found|topic.*(closed|deleted|not found)/i.test(msg))
+            return { remapped: false };
+        log.warn(`[topic] Thread ${logicalThreadId} topic is dead (${msg}) - creating replacement.`);
+        const newTopicId = await createManagedTopic(telegram, chatId, topicName, aliases);
+        threadLifecycle.remapTopic(db, {
+            threadId: logicalThreadId,
+            chatId,
+            topicName,
+            telegramTopicId: newTopicId,
+            aliases,
+        });
+        registerTopic(chatId, topicName, logicalThreadId);
+        log.info(`[topic] Remapped thread ${logicalThreadId} -> topic ${newTopicId}`);
+        return { remapped: true };
+    }
+}
+export async function deleteTelegramTopicByBotApi(token, chatId, topicId) {
+    const res = await fetch(`https://api.telegram.org/bot${token}/deleteForumTopic`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ chat_id: chatId, message_thread_id: topicId }),
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`deleteForumTopic failed: HTTP ${res.status} ${res.statusText} — ${body}`);
+    }
+}
+//# sourceMappingURL=topic.service.js.map

package/dist/services/topic.service.js.map

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

package/dist/services/worker-cleanup.service.d.ts

@@ -0,0 +1,8 @@
+import type { ThreadLifecycleService } from "./thread-lifecycle.service.js";
+export declare function cleanupExpiredWorkers(db: ReturnType<typeof import("../memory.js").initMemoryDb>, telegram: {
+    deleteForumTopic(chatId: string, threadId: number): Promise<void>;
+}, chatId: string, threadLifecycle: ThreadLifecycleService, ttlMs?: number): Promise<{
+    cleaned: number;
+    errors: string[];
+}>;
+//# sourceMappingURL=worker-cleanup.service.d.ts.map

package/dist/services/worker-cleanup.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-cleanup.service.d.ts","sourceRoot":"","sources":["../../src/services/worker-cleanup.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAK5E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,cAAc,cAAc,EAAE,YAAY,CAAC,EAC1D,QAAQ,EAAE;IAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAC/E,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,sBAAsB,EACvC,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqChD"}

package/dist/services/worker-cleanup.service.js

@@ -0,0 +1,82 @@
+import { archiveNotesForThread } from "../data/memory/semantic.js";
+import { getExplicitTelegramTopicId } from "../data/memory/thread-registry.js";
+import { synthesizeGhostMemory } from "../memory.js";
+import { errorMessage } from "../utils.js";
+import { spawnedThreads } from "./process.service.js";
+import { log } from "../logger.js";
+const DEFAULT_WORKER_TTL_MS = 60 * 60 * 1000;
+export async function cleanupExpiredWorkers(db, telegram, chatId, threadLifecycle, ttlMs = DEFAULT_WORKER_TTL_MS) {
+    const result = { cleaned: 0, errors: [] };
+    const now = Date.now();
+    for (const thread of spawnedThreads.filter((t) => t.threadType === "worker" && now - t.createdAt > ttlMs)) {
+        try {
+            await cleanupSingleWorker(thread, db, telegram, chatId, threadLifecycle);
+            result.cleaned++;
+        }
+        catch (err) {
+            result.errors.push(`Thread ${thread.threadId}: ${errorMessage(err)}`);
+        }
+    }
+    try {
+        const cutoff = new Date(now - ttlMs).toISOString();
+        const staleRows = db.prepare(`SELECT thread_id FROM thread_registry
+       WHERE type = 'worker' AND status IN ('active', 'exited') AND COALESCE(last_active_at, created_at) < ?`).all(cutoff);
+        for (const row of staleRows) {
+            if (spawnedThreads.some((t) => t.threadId === row.thread_id))
+                continue;
+            try {
+                try {
+                    const topicId = getExplicitTelegramTopicId(db, row.thread_id);
+                    if (topicId != null)
+                        await telegram.deleteForumTopic(chatId, topicId);
+                }
+                catch { }
+                threadLifecycle.archiveThread(db, row.thread_id);
+                try {
+                    archiveNotesForThread(db, row.thread_id);
+                }
+                catch { }
+                result.cleaned++;
+            }
+            catch (err) {
+                const msg = `Thread ${row.thread_id}: ${errorMessage(err)}`;
+                result.errors.push(msg);
+                log.warn(`[worker-cleanup] Failed to archive stale DB worker: ${msg}`);
+            }
+        }
+    }
+    catch (err) {
+        log.warn(`[worker-cleanup] Failed to query stale DB workers: ${errorMessage(err)}`);
+    }
+    return result;
+}
+async function cleanupSingleWorker(thread, db, telegram, chatId, threadLifecycle) {
+    if (thread.memorySourceThreadId !== undefined) {
+        try {
+            await synthesizeGhostMemory(db, thread.threadId, thread.memorySourceThreadId, thread.name);
+        }
+        catch { }
+    }
+    try {
+        process.kill(thread.pid, "SIGTERM");
+    }
+    catch { }
+    try {
+        const topicId = getExplicitTelegramTopicId(db, thread.threadId);
+        if (topicId != null)
+            await telegram.deleteForumTopic(chatId, topicId);
+    }
+    catch { }
+    try {
+        threadLifecycle.archiveThread(db, thread.threadId);
+    }
+    catch { }
+    try {
+        archiveNotesForThread(db, thread.threadId);
+    }
+    catch { }
+    const idx = spawnedThreads.indexOf(thread);
+    if (idx !== -1)
+        spawnedThreads.splice(idx, 1);
+}
+//# sourceMappingURL=worker-cleanup.service.js.map

package/dist/services/worker-cleanup.service.js.map

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

package/dist/sessions.d.ts

@@ -3,10 +3,23 @@
  * and tracks active MCP transport sessions per thread.
  */
 import type { Database } from "better-sqlite3";
+import type { ISessionRepository } from "./data/interfaces.js";
+export declare class SessionRepository implements ISessionRepository {
+    getSession(chatId: string, name: string): number | undefined;
+    setSession(chatId: string, name: string, threadId: number): void;
+    deleteSession(chatId: string, name: string): void;
+    lookupTopicRegistry(chatId: string, name: string): number | undefined;
+    registerTopicRegistry(chatId: string, name: string, threadId: number): void;
+}
+export declare const sessionRepository: SessionRepository;
 export declare function lookupSession(chatId: string, name: string): number | undefined;
 export declare function persistSession(chatId: string, name: string, threadId: number): void;
 export declare function removeSession(chatId: string, name: string): void;
 export declare function registerMcpSession(threadId: number, mcpSessionId: string, closeTransport: () => void): void;
+export declare function getThreadIdForMcpSession(mcpSessionId: string): number | undefined;
+export declare function expectMcpSessionClose(mcpSessionId: string): void;
+export declare function consumeExpectedMcpSessionClose(mcpSessionId: string): boolean;
+export declare function unregisterMcpSession(mcpSessionId: string): void;
 /**
  * Close all MCP sessions for a thread EXCEPT the current one.
  * Purges orphaned sessions from before a server restart.
@@ -44,6 +57,7 @@ export declare function setTopicRegistryDb(getter: () => Database): void;
 export declare function lookupTopicRegistry(chatId: string, name: string): number | undefined;
 /** Register a topic name → threadId mapping in the registry. */
 export declare function registerTopic(chatId: string, name: string, threadId: number): void;
+export declare function registerTopicRegistry(chatId: string, name: string, threadId: number): void;
 /** Remove a topic from the registry. */
 export declare function unregisterTopic(chatId: string, name: string): void;
 /** Get all registered topics for a chat (or all chats if chatId is omitted). */

package/dist/sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAkC/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMhE;AAYD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,IAAI,GACzB,IAAI,CAIN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAetF;AAKD,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAID,qDAAqD;AACrD,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,OAAO,EAC/B,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,IAAI,CAUN;AAED,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAK3F;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED,sCAAsC;AACtC,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAM3E;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,IAAI,oBAAoB,EAAE,CAE7D;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAQ9C,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,QAAQ,GAAG,IAAI,CAE/D;AAOD,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWpF;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CASlF;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CASlE;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiB9F"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"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"}

package/dist/sessions.js

@@ -9,6 +9,24 @@ import { log } from "./logger.js";
 import { errorMessage } from "./utils.js";
 // ─── Session store (disk-backed name → threadId mapping) ────────────────────
 const SESSION_STORE_PATH = join(homedir(), ".remote-copilot-mcp-sessions.json");
+export class SessionRepository {
+    getSession(chatId, name) {
+        return lookupSession(chatId, name);
+    }
+    setSession(chatId, name, threadId) {
+        persistSession(chatId, name, threadId);
+    }
+    deleteSession(chatId, name) {
+        removeSession(chatId, name);
+    }
+    lookupTopicRegistry(chatId, name) {
+        return lookupTopicRegistry(chatId, name);
+    }
+    registerTopicRegistry(chatId, name, threadId) {
+        registerTopicRegistry(chatId, name, threadId);
+    }
+}
+export const sessionRepository = new SessionRepository();
 function loadSessionMap() {
     try {
         const raw = readFileSync(SESSION_STORE_PATH, "utf8");
@@ -48,10 +66,40 @@ export function removeSession(chatId, name) {
 }
 /** Thread → active MCP transport sessions */
 const threadSessionRegistry = new Map();
+const sessionThreadRegistry = new Map();
+const expectedSessionCloses = new Set();
 export function registerMcpSession(threadId, mcpSessionId, closeTransport) {
     const entries = threadSessionRegistry.get(threadId) ?? [];
     entries.push({ mcpSessionId, closeTransport });
     threadSessionRegistry.set(threadId, entries);
+    sessionThreadRegistry.set(mcpSessionId, threadId);
+    expectedSessionCloses.delete(mcpSessionId);
+}
+export function getThreadIdForMcpSession(mcpSessionId) {
+    return sessionThreadRegistry.get(mcpSessionId);
+}
+export function expectMcpSessionClose(mcpSessionId) {
+    expectedSessionCloses.add(mcpSessionId);
+}
+export function consumeExpectedMcpSessionClose(mcpSessionId) {
+    const expected = expectedSessionCloses.has(mcpSessionId);
+    expectedSessionCloses.delete(mcpSessionId);
+    return expected;
+}
+export function unregisterMcpSession(mcpSessionId) {
+    const threadId = sessionThreadRegistry.get(mcpSessionId);
+    if (threadId !== undefined) {
+        const entries = threadSessionRegistry.get(threadId) ?? [];
+        const kept = entries.filter((entry) => entry.mcpSessionId !== mcpSessionId);
+        if (kept.length > 0) {
+            threadSessionRegistry.set(threadId, kept);
+        }
+        else {
+            threadSessionRegistry.delete(threadId);
+        }
+    }
+    sessionThreadRegistry.delete(mcpSessionId);
+    expectedSessionCloses.delete(mcpSessionId);
 }
 /**
  * Close all MCP sessions for a thread EXCEPT the current one.
@@ -67,14 +115,18 @@ export function purgeOtherSessions(threadId, keepMcpSessionId) {
             kept.push(entry);
         }
         else {
+            expectMcpSessionClose(entry.mcpSessionId);
             try {
                 entry.closeTransport();
             }
             catch (_) { /* best-effort */ }
+            unregisterMcpSession(entry.mcpSessionId);
             purged++;
         }
     }
     threadSessionRegistry.set(threadId, kept);
+    if (keepMcpSessionId)
+        sessionThreadRegistry.set(keepMcpSessionId, threadId);
     if (kept.length === 0)
         threadSessionRegistry.delete(threadId);
     return purged;
@@ -163,6 +215,9 @@ export function lookupTopicRegistry(chatId, name) {
 }
 /** Register a topic name → threadId mapping in the registry. */
 export function registerTopic(chatId, name, threadId) {
+    registerTopicRegistry(chatId, name, threadId);
+}
+export function registerTopicRegistry(chatId, name, threadId) {
     try {
         const db = getTopicDb();
         db.prepare(`INSERT OR REPLACE INTO topic_registry (chat_id, name, thread_id, registered_at) VALUES (?, ?, ?, datetime('now'))`).run(chatId, name.toLowerCase(), threadId);