im-hub-pro 0.2.29

package/dist/core/schedule.js

@@ -0,0 +1,316 @@
+// Scheduler — persistent cron-driven Job creation.
+//
+// Schedules live in the same SQLite DB as Jobs (extra table). A 30s tick
+// scans for due rows, creates a Job for each, and bumps `next_run`. When
+// SQLite is unavailable (bun runtime / disk error) the scheduler exposes
+// the same API but persists nothing — exact same fail-soft pattern as
+// audit-log + job-board.
+import { homedir } from 'os';
+import { join } from 'path';
+import { logger as rootLogger } from './logger.js';
+import { parseCron, nextOccurrence } from './cron.js';
+import { createJob, runJob } from './job-board.js';
+import { registry } from './registry.js';
+import { AgentBase } from './agent-base.js';
+import { createSqliteHelper } from './sqlite-helper.js';
+const SCHED_DB = join(homedir(), '.im-hub', 'schedules.db');
+const TICK_INTERVAL_MS = 30 * 1000;
+const NOTIFY_TIMEOUT_MS = 10 * 1000;
+/** Hard cap on webhook response body — we only read a small ack. */
+const NOTIFY_MAX_RESPONSE_BYTES = 64 * 1024;
+const log = rootLogger.child({ component: 'schedule' });
+let tickTimer = null;
+/**
+ * Validate a user-supplied webhook URL before the scheduler POSTs to it.
+ * Defends against accidental misconfig and basic SSRF: no protocols other
+ * than http(s); no loopback / RFC1918 / link-local destinations unless the
+ * operator explicitly opts in via IMHUB_ALLOW_PRIVATE_WEBHOOKS=1.
+ *
+ * Note: this is a lexical check (IP literals + "localhost"). DNS-rebinding
+ * mitigation requires an at-fetch-time guard; tracked separately.
+ */
+export function validateWebhookUrl(raw) {
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        return { ok: false, reason: 'malformed URL' };
+    }
+    if (u.protocol !== 'http:' && u.protocol !== 'https:') {
+        return { ok: false, reason: `protocol ${u.protocol} not allowed (use http: or https:)` };
+    }
+    if (process.env.IMHUB_ALLOW_PRIVATE_WEBHOOKS === '1')
+        return { ok: true, url: u };
+    const host = u.hostname.toLowerCase();
+    if (host === 'localhost' || host === '0.0.0.0' || host === '::' || host === '[::]') {
+        return { ok: false, reason: `host ${host} not allowed` };
+    }
+    // IPv4 literals
+    const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    if (v4) {
+        const o = v4.slice(1, 5).map(Number);
+        if (o.some((b) => !Number.isFinite(b) || b < 0 || b > 255)) {
+            return { ok: false, reason: 'malformed IPv4 literal' };
+        }
+        const [a, b] = o;
+        // 127/8 loopback, 10/8, 192.168/16, 172.16-31/12, 169.254/16 link-local,
+        // 0/8 "this network", 100.64/10 CGNAT.
+        if (a === 127 || a === 10 || a === 0
+            || (a === 192 && b === 168)
+            || (a === 172 && b >= 16 && b <= 31)
+            || (a === 169 && b === 254)
+            || (a === 100 && b >= 64 && b <= 127)) {
+            return { ok: false, reason: `private/loopback IPv4 ${host} not allowed` };
+        }
+    }
+    // IPv6 literals come wrapped in [] in URL.hostname strips them; bracket
+    // forms still surface in u.host though. Block well-known unsafe prefixes.
+    if (host === '::1' || host.startsWith('fc') || host.startsWith('fd') || host.startsWith('fe80')) {
+        return { ok: false, reason: `private/loopback IPv6 ${host} not allowed` };
+    }
+    return { ok: true, url: u };
+}
+/**
+ * Idempotent column-add for ownership tracking. Same shape as job-board's
+ * migrateOwnership — survive multiple boots without breaking.
+ */
+function migrateOwnership(d) {
+    for (const col of ['creator_id', 'workspace_id']) {
+        try {
+            d.prepare(`ALTER TABLE schedules ADD COLUMN ${col} TEXT NOT NULL DEFAULT ''`).run();
+            rootLogger.info({ component: 'schedule', column: col, event: 'schedule.migration' }, `Added ${col} column to schedules table`);
+        }
+        catch {
+            // duplicate column — already migrated
+        }
+    }
+}
+const helper = createSqliteHelper({
+    file: SCHED_DB,
+    component: 'schedule',
+    logger: rootLogger,
+    schema: `
+    CREATE TABLE IF NOT EXISTS schedules (
+      id            INTEGER PRIMARY KEY AUTOINCREMENT,
+      name          TEXT    NOT NULL,
+      agent         TEXT    NOT NULL,
+      prompt        TEXT    NOT NULL,
+      cron          TEXT    NOT NULL,
+      enabled       INTEGER NOT NULL DEFAULT 1,
+      next_run      TEXT    NOT NULL,
+      last_run      TEXT,
+      notify_url    TEXT,
+      created_at    TEXT    NOT NULL DEFAULT (datetime('now')),
+      creator_id    TEXT    NOT NULL DEFAULT '',
+      workspace_id  TEXT    NOT NULL DEFAULT ''
+    );
+    CREATE INDEX IF NOT EXISTS idx_sched_next ON schedules(next_run, enabled);
+    CREATE INDEX IF NOT EXISTS idx_sched_creator ON schedules(creator_id);
+  `,
+    init: (d) => migrateOwnership(d),
+});
+function getDb() {
+    return helper.get();
+}
+export function createSchedule(input) {
+    const d = getDb();
+    if (!d)
+        throw new Error('Scheduler unavailable (SQLite not initialized)');
+    const spec = parseCron(input.cron); // throws on bad expr
+    const next = nextOccurrence(spec, new Date());
+    if (!next)
+        throw new Error('Cron expression has no future occurrence');
+    if (input.notifyUrl) {
+        const v = validateWebhookUrl(input.notifyUrl);
+        if (!v.ok)
+            throw new Error(`notifyUrl rejected: ${v.reason}`);
+    }
+    const info = d.prepare('INSERT INTO schedules (name, agent, prompt, cron, enabled, next_run, notify_url, creator_id, workspace_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)').run(input.name, input.agent, input.prompt, input.cron, input.enabled === false ? 0 : 1, next.toISOString(), input.notifyUrl || null, input.creatorId || '', input.workspaceId || '');
+    return Number(info.lastInsertRowid);
+}
+export function listSchedules(limit = 50, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return [];
+    const conditions = [];
+    const params = [];
+    if (opts.creatorId !== undefined) {
+        conditions.push("(creator_id = ? OR creator_id = '')");
+        params.push(opts.creatorId);
+    }
+    if (opts.agent) {
+        conditions.push('agent = ?');
+        params.push(opts.agent);
+    }
+    const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+    return d.prepare(`SELECT * FROM schedules ${where} ORDER BY id DESC LIMIT ?`)
+        .all(...params, limit);
+}
+export function getSchedule(id, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return null;
+    const row = (opts.creatorId !== undefined
+        ? d.prepare("SELECT * FROM schedules WHERE id = ? AND (creator_id = ? OR creator_id = '')")
+            .get(id, opts.creatorId)
+        : d.prepare('SELECT * FROM schedules WHERE id = ?').get(id));
+    return row || null;
+}
+export function deleteSchedule(id, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return false;
+    if (opts.creatorId !== undefined) {
+        return d.prepare("DELETE FROM schedules WHERE id = ? AND (creator_id = ? OR creator_id = '')")
+            .run(id, opts.creatorId).changes > 0;
+    }
+    return d.prepare('DELETE FROM schedules WHERE id = ?').run(id).changes > 0;
+}
+export function setEnabled(id, enabled, opts = {}) {
+    const d = getDb();
+    if (!d)
+        return false;
+    if (opts.creatorId !== undefined) {
+        return d.prepare("UPDATE schedules SET enabled = ? WHERE id = ? AND (creator_id = ? OR creator_id = '')").run(enabled ? 1 : 0, id, opts.creatorId).changes > 0;
+    }
+    return d.prepare('UPDATE schedules SET enabled = ? WHERE id = ?')
+        .run(enabled ? 1 : 0, id).changes > 0;
+}
+/** Find schedules whose next_run is at or before `now` and are enabled. */
+function dueSchedules(d, now) {
+    return d.prepare("SELECT * FROM schedules WHERE enabled = 1 AND next_run <= ?").all(now.toISOString());
+}
+/**
+ * Execute a single scheduled run: create a Job, kick it off through Job
+ * Board (which honors the concurrency cap), bump next_run.
+ */
+async function fireSchedule(s, logger) {
+    const d = getDb();
+    if (!d)
+        return;
+    const agent = registry.findAgent(s.agent);
+    if (!agent) {
+        logger.warn({ scheduleId: s.id, agent: s.agent }, 'Schedule agent not registered, skipping');
+        return;
+    }
+    const jobId = createJob(s.agent, s.prompt);
+    logger.info({ scheduleId: s.id, jobId, name: s.name }, 'Schedule fired');
+    // Compute next_run BEFORE running so even a long-running job doesn't
+    // block the next tick.
+    try {
+        const nextSpec = parseCron(s.cron);
+        const next = nextOccurrence(nextSpec, new Date());
+        if (next) {
+            d.prepare('UPDATE schedules SET last_run = ?, next_run = ? WHERE id = ?')
+                .run(new Date().toISOString(), next.toISOString(), s.id);
+        }
+    }
+    catch {
+        // Bad cron at this point would only happen if it was edited externally.
+        // Disable rather than re-fire forever.
+        d.prepare('UPDATE schedules SET enabled = 0 WHERE id = ?').run(s.id);
+    }
+    // Run via Job Board so the result is persisted + bounded concurrency.
+    void runJob(jobId, async function* (job, jobLogger, signal) {
+        if (agent instanceof AgentBase) {
+            const text = await agent.spawnAndCollect(job.prompt, signal);
+            if (text)
+                yield text;
+        }
+        else {
+            for await (const chunk of agent.sendPrompt(`schedule-${s.id}-${jobId}`, job.prompt, [])) {
+                if (signal.aborted)
+                    break;
+                yield chunk;
+            }
+        }
+    }, logger).then(async () => {
+        if (!s.notify_url)
+            return;
+        // Defense in depth: re-validate at fire time in case the row was edited
+        // out-of-band (manual SQL, future v0.x importer) — never trust DB content
+        // as an authorization bypass for the SSRF gate.
+        const v = validateWebhookUrl(s.notify_url);
+        if (!v.ok) {
+            logger.warn({ scheduleId: s.id, reason: v.reason, event: 'schedule.notify.rejected' }, 'Schedule notify webhook rejected by URL validator');
+            return;
+        }
+        try {
+            const job = (await import('./job-board.js')).getJob(jobId);
+            if (!job)
+                return;
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), NOTIFY_TIMEOUT_MS);
+            try {
+                const resp = await fetch(v.url.toString(), {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    body: JSON.stringify({
+                        scheduleId: s.id,
+                        jobId,
+                        status: job.status,
+                        result: job.result,
+                        error: job.error,
+                    }),
+                    signal: ctrl.signal,
+                    // Drop redirects so a 30x can't pivot us back to a private host.
+                    redirect: 'manual',
+                });
+                // Drain (capped) so the connection can be reused / closed cleanly.
+                if (resp.body) {
+                    let read = 0;
+                    const reader = resp.body.getReader();
+                    while (read < NOTIFY_MAX_RESPONSE_BYTES) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        read += value?.byteLength ?? 0;
+                    }
+                    await reader.cancel().catch(() => { });
+                }
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        catch (err) {
+            logger.warn({ scheduleId: s.id, err: err instanceof Error ? err.message : String(err) }, 'Schedule notify webhook failed');
+        }
+    }).catch(() => { });
+}
+/** Run one tick — exposed for tests so they don't have to wait for setInterval. */
+export async function tick(now = new Date()) {
+    const d = getDb();
+    if (!d)
+        return 0;
+    const due = dueSchedules(d, now);
+    for (const s of due) {
+        await fireSchedule(s, log).catch((err) => {
+            log.error({ scheduleId: s.id, err: err instanceof Error ? err.message : String(err) }, 'fireSchedule threw');
+        });
+    }
+    return due.length;
+}
+/** Start the periodic ticker. Idempotent. */
+export function startScheduler() {
+    if (tickTimer)
+        return;
+    tickTimer = setInterval(() => { void tick(); }, TICK_INTERVAL_MS);
+    if (typeof tickTimer === 'object' && tickTimer && 'unref' in tickTimer) {
+        tickTimer.unref();
+    }
+    log.info({ tickMs: TICK_INTERVAL_MS }, 'Scheduler started');
+}
+export function stopScheduler() {
+    if (tickTimer) {
+        clearInterval(tickTimer);
+        tickTimer = null;
+    }
+}
+/** Close the underlying SQLite handle. Called by cli.ts on graceful
+ *  shutdown so the WAL is checkpointed before exit (L2). */
+export function closeScheduleDb() {
+    helper.close();
+}
+//# sourceMappingURL=schedule.js.map

package/dist/core/schedule.js.map

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

package/dist/core/session-subtasks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-subtasks.test.d.ts.map

package/dist/core/session-subtasks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-subtasks.test.d.ts","sourceRoot":"","sources":["../../src/core/session-subtasks.test.ts"],"names":[],"mappings":""}

package/dist/core/session-subtasks.test.js

@@ -0,0 +1,88 @@
+// listAllSubtasks — covers the dashboard's flattened-subtask view. We can't
+// monkey-patch SESSIONS_DIR (it's a const), so this test goes via the real
+// public API: nextSubtaskId + updateSubtask write to ~/.im-hub/sessions, and
+// we then read them back and clean up.
+//
+// We use a unique platform/channelId/threadId triple so we don't collide with
+// any real sessions and we delete them afterwards.
+import { describe, it, expect, beforeAll, afterEach } from 'bun:test';
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir, unlink, readdir } from 'fs/promises';
+import { sessionManager } from './session.js';
+const PLATFORM = 'subtest';
+const CHANNEL = 'c-' + Math.random().toString(36).slice(2, 8);
+const THREAD = 't-' + Math.random().toString(36).slice(2, 8);
+const SESSIONS_DIR = join(homedir(), '.im-hub', 'sessions');
+// CI runs on a fresh runner where ~/.im-hub/sessions/ doesn't exist yet.
+// Without this beforeAll, saveSessionMeta's atomicWrite hits ENOENT, the
+// outer try/catch swallows it (correct for runtime — never crash the
+// session manager on a disk hiccup) and the test sees 0 subtasks instead
+// of 2. Local boxes happened to have the dir from prior runs, masking
+// the issue until a clean CI environment surfaced it.
+beforeAll(async () => {
+    await mkdir(SESSIONS_DIR, { recursive: true });
+});
+async function cleanupTestSessions() {
+    // The session manager sanitizes the key, so we can't compute the filename.
+    // Instead, scan and delete any file whose JSON has our test platform.
+    let names;
+    try {
+        names = await readdir(SESSIONS_DIR);
+    }
+    catch {
+        return;
+    }
+    const { readFile } = await import('fs/promises');
+    for (const name of names) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            const raw = await readFile(join(SESSIONS_DIR, name), 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed.platform === PLATFORM) {
+                await unlink(join(SESSIONS_DIR, name)).catch(() => { });
+                await unlink(join(SESSIONS_DIR, name.replace(/\.json$/, '.log'))).catch(() => { });
+            }
+        }
+        catch { /* ignore */ }
+    }
+}
+afterEach(async () => {
+    await cleanupTestSessions();
+});
+describe('sessionManager.listAllSubtasks', () => {
+    it('returns subtasks across all sessions, flattened with parent context', async () => {
+        // Spawn two subtasks in our test session.
+        const id1 = await sessionManager.nextSubtaskId(PLATFORM, CHANNEL, THREAD, 'claude-code');
+        await sessionManager.updateSubtask(PLATFORM, CHANNEL, THREAD, id1, {
+            id: id1, agent: 'claude-code', prompt: 'hello',
+            status: 'running', createdAt: new Date('2026-05-01T09:00:00Z'),
+        });
+        const id2 = await sessionManager.nextSubtaskId(PLATFORM, CHANNEL, THREAD, 'claude-code');
+        await sessionManager.updateSubtask(PLATFORM, CHANNEL, THREAD, id2, {
+            id: id2, agent: 'opencode', prompt: 'world',
+            status: 'completed', createdAt: new Date('2026-05-01T10:00:00Z'),
+        });
+        const all = await sessionManager.listAllSubtasks();
+        const ours = all.filter((s) => s.platform === PLATFORM);
+        expect(ours.length).toBe(2);
+        // newest first
+        expect(ours[0].createdAt.getTime()).toBeGreaterThan(ours[1].createdAt.getTime());
+        // parent context attached
+        for (const s of ours) {
+            expect(s.platform).toBe(PLATFORM);
+            expect(s.channelId).toBe(CHANNEL);
+            expect(s.threadId).toBe(THREAD);
+            expect(s.parentSessionId).toContain(PLATFORM);
+        }
+        expect(ours.find((s) => s.agent === 'opencode')?.status).toBe('completed');
+    });
+    it('returns empty array when no sessions on disk match', async () => {
+        // No subtasks written for our (unique) platform. Other real sessions
+        // may exist; our filter shows ours is zero.
+        const all = await sessionManager.listAllSubtasks();
+        expect(all.filter((s) => s.platform === PLATFORM).length).toBe(0);
+    });
+});
+//# sourceMappingURL=session-subtasks.test.js.map

package/dist/core/session-subtasks.test.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,182 @@
+import type { Session, ChatMessage, SubtaskMeta } from './types.js';
+declare class SessionManager {
+    private sessions;
+    private cleanupTimer?;
+    /**
+     * Per-key promise chain used to serialize writes that perform a
+     * read-modify-write on the in-memory session + persistent JSONL log.
+     *
+     * Without this, two concurrent {@link addMessage} calls on the same key
+     * could interleave: A reads cached session, B reads cached session, both
+     * push a different message into the same array, then both write — the
+     * later write wins and the earlier message is lost from disk (the
+     * in-memory copy is fine because both pushes happened on the same object
+     * reference, but the JSONL log only reflects the most recent appendFile +
+     * meta save).
+     *
+     * The lock is keyed by `${platform}:${channelId}:${threadId}`; different
+     * threads still proceed in parallel.
+     */
+    private writeQueues;
+    start(): Promise<void>;
+    stop(): void;
+    /**
+     * Run `fn` while holding a per-key serial lock. Subsequent calls with the
+     * same key wait until prior ones settle (success OR failure). Returns the
+     * value of `fn`. Internal use only — keeps {@link addMessage} race-free
+     * without introducing an external dep like p-queue.
+     */
+    private withLock;
+    /**
+     * Get or create a session for a conversation
+     * Session key: `${platform}:${channelId}:${threadId}`
+     */
+    getOrCreateSession(platform: string, channelId: string, threadId: string, agent: string): Promise<Session>;
+    /**
+     * Get existing session without creating a new one
+     * Returns undefined if no session exists or it's expired
+     */
+    getExistingSession(platform: string, channelId: string, threadId: string): Promise<Session | undefined>;
+    /**
+     * Switch the agent for a session.
+     *
+     * Generates a new session id but preserves thread identity AND every
+     * thread-level field that isn't agent-specific:
+     *   - usage             (per-thread /stats roll-up)
+     *   - subtasks/active   (subtask state lives at thread level)
+     *   - claudeSessionId   (Claude UUID survives /oc → /cc round-trips so the
+     *                        underlying ~/.claude/projects jsonl keeps continuing
+     *                        when the user comes back to claude)
+     *
+     * `model` and `variant` are reset because they live in different namespaces
+     * across CLIs (`opencode` model ≠ `claude` model); carrying them across
+     * would just feed the new agent an unrecognized argument.
+     */
+    switchAgent(platform: string, channelId: string, threadId: string, newAgent: string): Promise<Session>;
+    /**
+     * Append a message to the session history.
+     *
+     * Performance: instead of re-serializing the entire session JSON every
+     * turn, the message body is appended to a JSONL log file alongside the
+     * metadata (which gets a tiny atomic update for `lastActivity`).
+     *
+     * Concurrency: the entire read-modify-write is serialized per session key
+     * via {@link withLock} so two concurrent calls on the same thread (e.g.
+     * the IM message landing event AND a tool-result event arriving within
+     * the same ms) cannot lose either message to a lost-update race.
+     */
+    addMessage(platform: string, channelId: string, threadId: string, message: ChatMessage): Promise<void>;
+    /**
+     * Persist `model` / `variant` / arbitrary patchable fields. Used by
+     * `/model`, `/think` etc so the change survives a restart between turns.
+     * Mutates the in-memory session in place AND writes metadata atomically.
+     */
+    patchSession(platform: string, channelId: string, threadId: string, patch: Partial<Pick<Session, 'model' | 'variant' | 'agent' | 'planMode'>>): Promise<Session | undefined>;
+    /**
+     * Persist claude-code resumable session bookkeeping (UUID + primed flag).
+     * Returns the updated session, or undefined if no session exists yet for
+     * this thread. Caller is expected to ensure the session exists first.
+     */
+    setClaudeSessionId(platform: string, channelId: string, threadId: string, claudeSessionId: string): Promise<Session | undefined>;
+    markClaudeSessionPrimed(platform: string, channelId: string, threadId: string): Promise<void>;
+    /**
+     * Persist opencode's native session id (`ses_…`) once we've seen it in the
+     * adapter's stream. Idempotent — calling with the same id is a no-op so
+     * the per-event callback can fire as many times as opencode sends events.
+     */
+    setOpencodeSessionId(platform: string, channelId: string, threadId: string, opencodeSessionId: string): Promise<Session | undefined>;
+    /**
+     * Persist codex's native thread id (UUID) once we've seen it in the
+     * adapter's `thread.started` event. Idempotent — same id may fire multiple
+     * times per spawn. Mirrors setOpencodeSessionId.
+     */
+    setCodexSessionId(platform: string, channelId: string, threadId: string, codexSessionId: string): Promise<Session | undefined>;
+    /**
+     * Increment the per-session usage roll-up after a successful agent
+     * invocation. Used by router.callAgentWithHistory to power /stats.
+     */
+    recordUsage(platform: string, channelId: string, threadId: string, delta: {
+        costUsd: number;
+        promptChars: number;
+        responseChars: number;
+        durationMs: number;
+    }): Promise<void>;
+    /**
+     * Reset conversation history (keep session but clear messages)
+     */
+    resetConversation(platform: string, channelId: string, threadId: string): Promise<Session | undefined>;
+    /**
+     * Get session with messages (convenience method)
+     */
+    getSessionWithHistory(platform: string, channelId: string, threadId: string): Promise<{
+        session: Session;
+        messages: ChatMessage[];
+    } | undefined>;
+    /**
+     * Create or get a subtask session (independent from parent).
+     */
+    getOrCreateSubSession(platform: string, channelId: string, threadId: string, subtaskId: number, agent: string): Promise<Session>;
+    /**
+     * Set active subtask id on parent session — subsequent messages route to the subtask.
+     */
+    setActiveSubtask(platform: string, channelId: string, threadId: string, taskId: number | null): Promise<void>;
+    /**
+     * Get subtask metadata list from parent session.
+     */
+    getSubtasks(platform: string, channelId: string, threadId: string): Promise<SubtaskMeta[]>;
+    /**
+     * Scan all session files on disk and return every subtask, flattened, with
+     * its parent platform/channelId/threadId/agent attached so the dashboard
+     * can render subtasks across all conversations.
+     *
+     * Session files live as `<sanitized-key>.json` under SESSIONS_DIR. The
+     * sanitized key is one-way (sha256-prefix per non-alnum char), so we
+     * cannot reverse it — but each session file preserves the original
+     * platform/channelId/threadId fields, which is what we need.
+     */
+    listAllSubtasks(opts?: {
+        agent?: string;
+    }): Promise<Array<SubtaskMeta & {
+        platform: string;
+        channelId: string;
+        threadId: string;
+        parentAgent: string;
+        parentSessionId: string;
+    }>>;
+    /**
+     * Update subtask metadata in parent session.
+     */
+    updateSubtask(platform: string, channelId: string, threadId: string, taskId: number, patch: Partial<SubtaskMeta>): Promise<void>;
+    /**
+     * Get next subtask id and persist the increment.
+     *
+     * Previously returned 1 when the parent session didn't exist yet, but
+     * never created one — second call returned 1 again, leading to subtask
+     * id collisions. Now we lazy-create the parent session so the counter
+     * increments durably from the first call.
+     */
+    nextSubtaskId(platform: string, channelId: string, threadId: string, agent?: string): Promise<number>;
+    /**
+     * Persist the full session (metadata + messages). Used for the legacy
+     * one-file format on resetConversation() and switchAgent() — anywhere
+     * the messages array itself was rewritten. Atomic via tmp+rename.
+     */
+    private saveSession;
+    /** Persist metadata only (no messages payload), atomically. */
+    private saveSessionMeta;
+    /** Crash-safe write: tmp file + atomic rename.
+     *
+     *  Recovers from ENOENT (parent dir missing) by mkdir-recursive + retry
+     *  exactly once. This keeps the manager robust to environments where
+     *  start() wasn't called yet — tests in particular tend to import
+     *  sessionManager without going through the start() lifecycle, and
+     *  saveSessionMeta's outer try/catch would otherwise swallow the ENOENT
+     *  and silently produce a no-op write (the bug that caused
+     *  session-subtasks.test.ts to fail on a fresh CI runner). */
+    private atomicWrite;
+    private loadSession;
+    private cleanup;
+}
+export declare const sessionManager: SessionManager;
+export {};
+//# sourceMappingURL=session.d.ts.map

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

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