@aitne/daemon 0.1.7 → 0.1.8

package/dist/bootstrap/api.js

@@ -0,0 +1,443 @@
+/**
+ * Hono API server bootstrap — §11 of the legacy `startup()` IIFE.
+ *
+ * Extracted from `index.ts` per
+ * `docs/design/appendices/index-bootstrap-stage-split.md` Phase B-3.
+ * Companion to `bootstrap/db.ts`, `bootstrap/adapters.ts`, and
+ * `bootstrap/services.ts`; same Pattern-C shape (file-split-plan.md §10).
+ *
+ * Responsibilities (in run order):
+ *  1. Assemble the `ApiDependencies` record from typed inputs — translate
+ *     subsystem instances (dispatcher, scheduler, messageHub, …) into the
+ *     small closures the API surface consumes (`getHealthData`,
+ *     `sendNotification`, `triggerHourlyCheck`, etc.).
+ *  2. Construct WhatsApp / messaging-platform controls (Pattern-C; takes
+ *     the adapter state holder + reload closures as deps).
+ *  3. Invoke `createApp(apiDeps)` to mount every route module and the
+ *     middleware stack (host-check, CORS, bearer-token gate, integration
+ *     route gate).
+ *  4. Mount `/api/docs/*` after createApp so the indexer handle + docs-QA
+ *     adapter can be threaded in without widening `ApiDependencies`.
+ *  5. Call `serve()` from `@hono/node-server` with
+ *     `overrideGlobalObjects: false` — the workaround documented in
+ *     `project_hono_global_response_pitfall` memory and required for
+ *     `@huggingface/transformers` cache.put() to function correctly. The
+ *     literal `false` is load-bearing; do not refactor away.
+ *
+ * Ordering invariants this module preserves (design §11):
+ *  - The server starts listening before `dispatcher.run()` / `heartbeat.start()`
+ *    run in `index.ts` — those calls happen at the call site immediately
+ *    after this factory returns.
+ *  - `onSecretChanged` (passed in from event-pipeline territory) is wired
+ *    into the API surface here, but `secretBroker.onSecretChanged()`
+ *    registration stays at the call site so the timing is observable.
+ *
+ * Note: this module is the API-assembly chokepoint, not the construction
+ * site for the cross-stage closures (`handleSecretChange`,
+ * `handlePromptContextChanged`, `rematerializeActiveDmWorkdirs`,
+ * `handleGoogleServicesReady`, `fireRoadmapMaintenance`). Those are owned
+ * by Phase B-4 (event-pipeline) per the design doc; this factory accepts
+ * them as deps and threads them into `createApp`.
+ */
+import { serve } from "@hono/node-server";
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+import { applyIntegrationModeChange, } from "../core/integration-lifecycle.js";
+import { continueDashboardSession as continueDashboardSessionFromHistory, endDashboardSession as endDashboardSessionFromChannel, } from "../core/dashboard-session-controls.js";
+import { sendSetupWelcomeDm } from "../messaging/setup-welcome-dm.js";
+import { recordProactiveForwardDeliveries } from "../core/channel-timeline.js";
+import { createApp, } from "../api/server.js";
+import { createDocsRoutes } from "../api/routes/docs.js";
+import { whatsappQrResponseFromAdapter, } from "./adapters.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("daemon-bootstrap-api");
+/**
+ * Compose the Hono app, mount post-createApp routes, and start the HTTP
+ * listener. The returned `server` is already listening on
+ * `deps.config.apiPort`; the caller is responsible for kicking off any
+ * dispatcher / heartbeat work that depends on the listener being live.
+ */
+export function startApiServer(deps) {
+    const apiDeps = composeApiDependencies(deps);
+    const app = createApp(apiDeps);
+    // Mount /api/docs/* AFTER createApp so the indexer handle + docs-QA
+    // adapter can be threaded in without widening `ApiDependencies`. The
+    // read endpoints don't need messaging/dispatcher deps; the QA POST/SSE
+    // pair leans on `docsQAAdapter` to register clients and enqueue
+    // docs_qa events (DOCS_QA_DESIGN.md §10.4 + DOCS_QA_B7_DESIGN.md §S5–S6).
+    app.route("/api", createDocsRoutes({
+        db: deps.db,
+        ...(deps.docsIndexer ? { indexer: deps.docsIndexer } : {}),
+        docsQAAdapter: deps.docsQAAdapter,
+    }));
+    const serveFn = deps.serveImpl ?? serve;
+    const server = serveFn({
+        fetch: app.fetch,
+        hostname: "127.0.0.1",
+        port: deps.config.apiPort,
+        // @hono/node-server's getRequestListener defaults to replacing
+        // `globalThis.Request` / `globalThis.Response` with its own lazy
+        // wrapper classes (named `_Request` / `_Response`) for response-
+        // body materialization performance. The wrappers are prototype-
+        // chained to the native classes — fine for Hono's own response
+        // path — but they break `instanceof Response` checks for objects
+        // returned by native `fetch()`, because a native Response's
+        // prototype chain doesn't include `_Response.prototype`. This
+        // makes `@huggingface/transformers`'s `toCacheResponse` check
+        // (`response instanceof Response && response.status === 200`)
+        // evaluate to false on fresh fetches, which silently skips
+        // `cache.put` and then throws "Unable to get model file path or
+        // buffer." Disabling the override keeps the native globals
+        // intact and costs us nothing — we don't construct Hono's
+        // `Response` instances directly anywhere in the daemon.
+        overrideGlobalObjects: false,
+    });
+    logger.info({ port: deps.config.apiPort }, "API server listening");
+    return { app, server, eventBroadcaster: deps.eventBroadcaster };
+}
+// ── Internals ────────────────────────────────────────────────────────────
+/**
+ * Translate the high-level `BootstrapApiDeps` record into the
+ * closure-laden `ApiDependencies` shape `createApp` consumes. Pure
+ * function (no side effects, no construction); every call returns a
+ * fresh deps record that captures the input refs. Extracted from the
+ * giant inline object literal that lived inside `startup()` so the
+ * call site reads as one factory call.
+ */
+function composeApiDependencies(deps) {
+    const { db, config, secretBroker, services, blobStore, agentBackends, authHealthMonitor, authRecovery, authTelemetry, eventBus, readTokenManager, morningRoutineLock, roadmapWriteLock, migrationLock, contextWriteGate, managementMdWriteLockManager, dispatcher, scheduler, customRoutineScheduler, healthMonitor, heartbeat, messageHub, observerManager, contextIndexReconciler, primaryVaultWatcher, delegatedBackendInvoker, gitAccountRegistry, writeTracker, auditLogger, attachmentStore, dashboardAdapter, eventBroadcaster, getIntegrationStatus, getMessagingStatus, isStartupComplete, getDelegatedSyncWorker, handleSecretChange, handlePromptContextChanged, onGoogleServicesReady, rematerializeActiveDmWorkdirs, fireRoadmapMaintenance, buildCalendarPoller, buildNotionPoller, buildGitWatcher, buildGithubPoller, buildDelegatedSyncWorker, buildGitDelegatedCronObserver, clearGitWatcher, queueGitProjectInitsForCurrentConfig, } = deps;
+    const whatsappControls = buildWhatsAppControls(deps);
+    const messagingControls = {
+        telegram: deps.buildTelegramControls(),
+        slack: deps.buildSlackControls(),
+        discord: deps.buildDiscordControls(),
+    };
+    const sendNotification = async ({ message, platforms, priority, notificationType, originSessionId }) => {
+        const dispatchId = randomBytes(16).toString("hex");
+        const deliveries = await messageHub.sendToUser(message, platforms, {
+            dispatchId,
+            notificationType: notificationType ?? "agent",
+            priority: priority ?? "normal",
+            contentSummary: message.slice(0, 200),
+        });
+        if (deliveries.length > 0) {
+            const insert = db.prepare(`INSERT INTO notification_log (
+             dispatch_id,
+             notification_type,
+             priority,
+             platform,
+             delivery_channel,
+             delivery_message_id,
+             content_summary,
+             status,
+             delivered_at
+           )
+           VALUES (?, ?, ?, ?, ?, ?, ?, 'delivered', CURRENT_TIMESTAMP)`);
+            for (const delivery of deliveries) {
+                insert.run(dispatchId, notificationType ?? "agent", priority ?? "normal", delivery.platform, delivery.channel, delivery.messageId ?? null, message.slice(0, 200));
+            }
+            recordProactiveForwardDeliveries({
+                db,
+                config,
+                deliveries,
+                content: message,
+                dispatchId,
+                dispatchIds: [dispatchId],
+                originSessionIds: originSessionId !== undefined ? [originSessionId] : [],
+                notificationType: "proactive_forward",
+            });
+        }
+        return { dispatchId, deliveries };
+    };
+    const onIntegrationModeChange = async (key, prev, next) => {
+        const buildObserver = (observerName) => {
+            // Registry-gated direct observers. Mail's multi-provider poller is a
+            // deferred follow-up — gmail.observersTouched is empty, so that
+            // branch remains unreachable today.
+            if (observerName === "calendar")
+                return buildCalendarPoller();
+            if (observerName === "notion-poller")
+                return buildNotionPoller();
+            if (observerName === "git")
+                return buildGitWatcher();
+            if (observerName === "github")
+                return buildGithubPoller();
+            return null;
+        };
+        await applyIntegrationModeChange({
+            db,
+            observerManager,
+            buildObserver,
+            buildDelegatedSyncWorker,
+            buildGitDelegatedCronObserver,
+            // DELEGATED-PROXY-API-DESIGN.md Phase F (§4.8) — every mode
+            // change re-materializes active DM workdirs so the next turn
+            // picks up the new skill body / accounts.md / instruction file
+            // without tearing down the SDK session.
+            rematerializeDmSessions: (reason) => {
+                const result = rematerializeActiveDmWorkdirs(reason);
+                if (!result)
+                    return;
+                logger.info({ reason, ...result.summary }, "Integration mode changed — DM session workdirs re-materialized");
+            },
+        }, key, prev, next);
+        if (key === "git" && next.mode !== "direct") {
+            clearGitWatcher();
+        }
+    };
+    const onMainBackendChange = (reason) => {
+        // DELEGATED-MODE-V2-DESIGN.md §4.4 — every main-backend flip
+        // re-materializes active DM workdirs so the next turn's skill
+        // variant and instruction file reflect the new same- vs.
+        // cross-backend topology. Mirrors the `onMailScopeChanged`
+        // pattern: helper handles the "no active sessions" no-op + per-
+        // session failure containment, and we broadcast a structured
+        // event so the dashboard can refresh without polling.
+        const result = rematerializeActiveDmWorkdirs(reason);
+        if (!result)
+            return;
+        logger.info({ reason, ...result.summary }, "Main backend changed — DM session workdirs re-materialized");
+        eventBroadcaster.broadcastEvent({
+            kind: "main_backend_changed",
+            reason,
+            ...result.summary,
+        });
+    };
+    const onSetupComplete = () => {
+        // Kick off an immediate morning routine so today.md is generated
+        // right away — otherwise the user completes setup mid-day and sits
+        // without a populated today.md until 04:00 next morning. We go
+        // through the scheduler's queueMorningRoutineWake so:
+        //   - the dedup check prevents a double-run if startup catchup was
+        //     about to kick off the same routine (race on first boot after
+        //     setup completes)
+        //   - the wake task is durable: if the daemon crashes before the
+        //     routine runs, it replays on restart via ScheduleWatcher
+        //   - ScheduleWatcher obeys the autonomous-work gate, so in the
+        //     unlikely case clearSetupMode fails to persist, the gate
+        //     still prevents the routine from running mid-setup.
+        // Don't emit roadmap_refresh here — skeleton has "(Not yet configured)"
+        // which isRoadmapStale() detects. The refresh will be triggered by:
+        // - morning_routine's post-completion hook, or
+        // - onGoogleServicesReady (once calendar auth completes)
+        // This avoids generating a roadmap before calendar data is available.
+        dispatcher.clearSetupMode();
+        try {
+            scheduler.queueMorningRoutineWake("setup_complete");
+        }
+        catch (err) {
+            logger.error({ err }, "Failed to queue post-setup morning routine — today.md will not be generated until next 04:00");
+        }
+        // Fire-and-forget: greet the user on every connected messaging
+        // platform exactly once. The runtime_state latch inside the helper
+        // makes this idempotent across repeated setup completions.
+        void sendSetupWelcomeDm({ db, messageHub }).catch((err) => {
+            logger.error({ err }, "Welcome DM dispatch crashed");
+        });
+    };
+    return {
+        db,
+        config,
+        secretBroker,
+        readTokenValidator: (token) => readTokenManager.isValid(token),
+        enforceReadToken: config.enforceReadToken,
+        agentBackends,
+        authHealthMonitor,
+        authRecovery,
+        authTelemetry,
+        eventBus,
+        morningRoutineLock,
+        roadmapWriteLock,
+        migrationLock,
+        contextWriteGate,
+        ...(managementMdWriteLockManager
+            ? { managementMdWriteLockManager }
+            : {}),
+        observerManager,
+        delegatedInvoker: delegatedBackendInvoker,
+        gitAccountRegistry,
+        onPrimaryVaultPathChange: (newPath) => primaryVaultWatcher.setVaultPath(newPath),
+        onGitReposChanged: () => queueGitProjectInitsForCurrentConfig("config-patch"),
+        getInFlightExecutions: () => dispatcher.getInFlightExecutions(),
+        getHealthData: () => {
+            const status = healthMonitor.getStatus();
+            return {
+                uptime: status.daemonUptime,
+                eventBusSize: status.eventBusSize,
+                activeSessions: status.activeSessions,
+                connectedPlatforms: status.connectedPlatforms,
+                registeredObservers: status.registeredObservers,
+                missingContextFiles: status.missingContextFiles,
+                contextFilesOk: status.contextFilesOk,
+            };
+        },
+        getLastTickAt: () => heartbeat.getLastTickAt(),
+        services,
+        isStartupComplete,
+        getIntegrationStatus,
+        getMessagingStatus,
+        // Bang-commands `/api/health` surface — messaging-bang-commands.md §6.1.
+        // Returns `"ok"` for the unblocked case so dashboards never have to
+        // null-check, while preserving the original gate enum for the blocked
+        // states.
+        getAutonomousState: () => dispatcher.isAutonomousAllowed() ?? "ok",
+        getNotificationDestinations: () => ({
+            defaultPlatforms: config.defaultNotificationPlatforms,
+            effectiveFallbackPlatforms: messageHub.getEffectiveFallbackPlatforms(),
+        }),
+        getIntegrationDriftSyncStatus: () => getDelegatedSyncWorker()?.getStatus() ?? {
+            workerRunning: false,
+            lastSuccessAt: null,
+            circuitState: "ok",
+            activeHours: { startHour: 4, endHour: 24 },
+            withinActiveHours: false,
+            cadences: {},
+            unrecognizedIntervalKeys: [],
+            ttlContractViolations: [],
+        },
+        // delegated-sync opt-in routes consume the live worker reference for
+        // cadence Run Now + status snapshot. When no integration is in
+        // delegated mode the worker is null and the routes report a
+        // worker_unavailable / empty-status response — see
+        // `docs/design/appendices/delegated-sync-opt-in.md`.
+        get delegatedSyncWorker() {
+            return getDelegatedSyncWorker() ?? undefined;
+        },
+        sendNotification,
+        markEventNotified: (correlationId) => {
+            dispatcher.markEventNotified(correlationId);
+        },
+        onGoogleServicesReady,
+        onScheduleConfigChanged: () => scheduler.reloadCrons(),
+        onIntegrationModeChange,
+        onMainBackendChange,
+        onSetupStart: (mode) => {
+            dispatcher.beginSetupMode(mode);
+        },
+        onSecretChanged: handleSecretChange,
+        onSetupComplete,
+        // Layer-3 defense for the Customize Your Rules bug (see
+        // context-staleness.ts and the inline comment that lived next to
+        // this callback before the B-3 split).
+        onPromptContextChanged: handlePromptContextChanged,
+        onIndexableContextChange: (_path) => {
+            // API-route hint: any successful PUT/PATCH/DELETE under `/context/*`
+            // queues a reconcile. The observer's own chokidar watcher already
+            // catches manual edits the API bypasses (e.g. the user editing via
+            // Obsidian when contextDir *is* the Obsidian vault) — this hint
+            // shortens reconcile latency for API-origin writes from chokidar
+            // debounce + stabilityThreshold to the observer's 10s debounce. The
+            // reconciler short-circuits when nothing changed, so firing for
+            // non-indexed paths is harmless.
+            contextIndexReconciler.requestReconcile("manual");
+        },
+        onCustomRoutinesChanged: () => {
+            try {
+                customRoutineScheduler.reload();
+            }
+            catch (err) {
+                logger.error({ err }, "Custom routine reload failed");
+            }
+        },
+        triggerHourlyCheck: (source, options) => dispatcher.triggerHourlyCheck(source, options),
+        triggerRoadmapRefresh: (source, options) => dispatcher.emitRoadmapRefresh(source, options),
+        triggerRoadmapMaintenance: () => fireRoadmapMaintenance(),
+        endDashboardSession: (channelId) => endDashboardSessionFromChannel({
+            sessionManager: deps.sessionManager,
+            channelId,
+        }),
+        continueDashboardSession: async (sessionId) => continueDashboardSessionFromHistory({
+            db,
+            dataDir: config.dataDir,
+            sessionManager: deps.sessionManager,
+            sessionId,
+        }),
+        writeTracker,
+        blobStore,
+        dashboardAdapter,
+        eventBroadcaster,
+        attachmentStore,
+        auditLogger,
+        validateAttachmentTurnToken: (token) => dispatcher.validateAttachmentTurnToken(token),
+        whatsappControls,
+        messagingControls,
+    };
+}
+/**
+ * Build the WhatsApp dashboard control surface. Captures the shared
+ * `adapterState` holder + adapter build/teardown closures + config refs
+ * so the dashboard's pairing / reset flows can drive the adapter
+ * without each route knowing the internals. Logic preserved bit-for-bit
+ * from the pre-B-3 inline block in `index.ts`.
+ */
+function buildWhatsAppControls(deps) {
+    const { adapterState, buildWhatsAppAdapter, teardownWhatsAppAdapter, enableWhatsAppAdapter, config, db, } = deps;
+    return {
+        isInitialized: () => adapterState.whatsapp !== null,
+        enable: async () => {
+            const adapter = buildWhatsAppAdapter();
+            if (adapter.getStatus() === "disabled") {
+                await adapter.start();
+            }
+        },
+        disable: async () => {
+            await teardownWhatsAppAdapter();
+        },
+        requestQr: async () => {
+            if (!adapterState.whatsapp) {
+                await enableWhatsAppAdapter();
+            }
+            await adapterState.whatsapp.requestQR();
+        },
+        waitForQr: async (timeoutMs = 10_000) => {
+            if (!adapterState.whatsapp) {
+                await enableWhatsAppAdapter();
+            }
+            const snapshot = await adapterState.whatsapp.waitForQr(timeoutMs);
+            return whatsappQrResponseFromAdapter(adapterState.whatsapp, snapshot);
+        },
+        getQrResponse: () => whatsappQrResponseFromAdapter(adapterState.whatsapp),
+        reset: async (timeoutMs = 10_000) => {
+            // 1. Stop + unregister any live adapter so no Baileys callbacks fire
+            //    against the auth dir while we delete it.
+            await teardownWhatsAppAdapter();
+            // 2. Wipe Baileys' multi-file auth state. Without this, a fresh
+            //    enable() would re-load the stale creds and never emit a QR —
+            //    which is exactly the "stale creds left over from a previous
+            //    pairing make re-pairing impossible" failure mode the
+            //    dashboard's "Reset connection" button exists
+            //    to recover from. Recursive + force so a partially-written dir
+            //    (e.g. only qr.txt present, no creds.json yet) still wipes
+            //    cleanly. `force: true` also no-ops if the dir is already gone.
+            const authDir = config.whatsappAuthDir ?? join(config.dataDir, "whatsapp", "auth");
+            try {
+                rmSync(authDir, { recursive: true, force: true });
+            }
+            catch (err) {
+                logger.warn({ err, authDir }, "Failed to wipe WhatsApp auth directory during reset");
+            }
+            // 3. Drop the cached owner_channels mapping so a freshly-paired
+            //    session re-discovers the channel id from the inbound auth
+            //    handshake rather than reusing the prior LID alias.
+            try {
+                db
+                    .prepare("DELETE FROM owner_channels WHERE platform = ?")
+                    .run("whatsapp");
+            }
+            catch (err) {
+                logger.warn({ err }, "Failed to clear WhatsApp owner_channels row during reset");
+            }
+            // 4. If the integration is still enabled, rebuild the adapter and
+            //    await the first scannable QR so the dashboard can render it
+            //    in the same request that triggered the reset.
+            if (!config.whatsappEnabled) {
+                return whatsappQrResponseFromAdapter(null);
+            }
+            await enableWhatsAppAdapter();
+            const snapshot = await adapterState.whatsapp.waitForQr(timeoutMs);
+            return whatsappQrResponseFromAdapter(adapterState.whatsapp, snapshot);
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/bootstrap/api.js.map

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

package/dist/bootstrap/db.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Database bootstrap — §3 of the legacy `startup()` IIFE.
+ *
+ * Extracted from `index.ts` per
+ * `docs/design/appendices/index-bootstrap-stage-split.md` Phase B-1.
+ * Companion to `bootstrap/adapters.ts` and `bootstrap/services.ts`; same
+ * Pattern-C shape (file-split-plan.md §10).
+ *
+ * Responsibilities (in run order):
+ *  1. Open the SQLite file and apply the idempotent schema.
+ *  2. Register the wiki workspace token resolver so skill compilation can
+ *     resolve `<wiki_workspace>` tokens via the DB.
+ *  3. Backfill the content-less `fts_wiki` virtual table once per workspace.
+ *  4. Bump `managed_task_seq.next_id` past any restored backup rows.
+ *  5. Close orphaned `dashboard_chat` sessions left active by a crash so
+ *     the setup wizard's resume gate flips correctly on next dashboard load.
+ *  6. Construct the chat `AttachmentStore` (top-level so adapter reloaders
+ *     can capture it in closure) and reap orphan rows.
+ *  7. Fire-and-forget price refresh (best-effort, network call).
+ *  8. Load persisted `settings` rows and merge them on top of env defaults.
+ *  9. Best-effort seed of git-project document templates (filesystem write).
+ *  10. Heal the `delegatedTaskModeEnabled` Phase-1 canary default for users
+ *      who have delegated integrations but never explicitly set the flag.
+ *
+ * Each step that has its own peer-test surface is exported by name so the
+ * test file can pin its behavior independent of the parent `initDatabase`
+ * factory. Steps with no testable branches (boot-time backfill / managed
+ * task seq / price refresh) stay inline.
+ *
+ * Ordering invariants this module preserves (design §11):
+ *  - Wiki token resolver is registered before any observer reads it.
+ *  - Orphan dashboard_chat sessions are closed before `SessionManager` is
+ *    constructed downstream.
+ *  - `mergeRuntimeSettingsFromDb` runs before any observer or service
+ *    reloader reads the config.
+ */
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import { type SettingsStore } from "../settings/settings-store.js";
+import type { RuntimeSettings } from "../settings/runtime-settings.js";
+import { AttachmentStore } from "../services/attachments/store.js";
+export interface BootstrapDbDeps {
+    readonly config: AgentConfig;
+}
+export interface BootstrapDbResult {
+    readonly db: Database.Database;
+    readonly settingsStore: SettingsStore;
+    readonly persistedSettings: Partial<RuntimeSettings>;
+    readonly attachmentStore: AttachmentStore;
+}
+/**
+ * Open the SQLite file, apply schema, run boot-time backfills, hydrate
+ * persisted settings, and apply the delegated-task-mode default
+ * correction. Mutates `deps.config` in place via
+ * `mergeRuntimeSettingsFromDb` and (when triggered) the default
+ * correction.
+ */
+export declare function initDatabase(deps: BootstrapDbDeps): BootstrapDbResult;
+export interface WikiWorkspaceTokens {
+    vault_path: string;
+    language: string;
+    workspace_name: string;
+    schema_version: string;
+}
+export type WikiTokenResolver = (processKey: string, workspaceName?: string) => WikiWorkspaceTokens | null;
+/**
+ * Pure factory for the wiki workspace token resolver — separated from the
+ * `setWikiWorkspaceTokenResolver` side effect so peer tests can pin the
+ * lookup logic without going through the `skills-compiler.ts` singleton.
+ *
+ * Matches the per-event lookup in `context-builder.ts`: prefer the named
+ * workspace, fall back to the default. Without this, multi-workspace
+ * installs would render the `<wiki_workspace>` XML against the target
+ * workspace while skill prose (`{{vault_path}}` etc.) referenced the
+ * default — the agent would then operate on the wrong vault.
+ */
+export declare function createWikiTokenResolver(db: Database.Database): WikiTokenResolver;
+/**
+ * Register the per-process wiki workspace token resolver consumed by
+ * `skills-compiler.ts`. Idempotent: replacing the resolver simply
+ * re-points the singleton at the new DB handle.
+ */
+export declare function initWikiTokenResolver(db: Database.Database): void;
+/**
+ * Close any `dashboard_chat` sessions that were left `status='active'`
+ * from before the daemon restart. They cannot be resumed cleanly: the
+ * SSE channel is gone and `Dispatcher.currentSetupMode` is in-process
+ * state lost on restart, so a setup conversation half-way through would
+ * otherwise be re-adopted by `findActiveDashboardSessionId` and processed
+ * as regular chat against stale prompts. The setup wizard's resume path
+ * on the client-side checks active status; closing here flips the check
+ * so the wizard correctly falls through to a fresh `/setup/start`.
+ *
+ * Best-effort: logs and returns 0 on failure (a DB that can't accept this
+ * one UPDATE has bigger problems that downstream steps will surface).
+ */
+export declare function closeOrphanedDashboardChatSessions(db: Database.Database): number;
+export interface LoadPersistedSettingsDeps {
+    readonly db: Database.Database;
+    readonly config: AgentConfig;
+}
+export interface LoadPersistedSettingsResult {
+    readonly settingsStore: SettingsStore;
+    readonly persistedSettings: Partial<RuntimeSettings>;
+}
+/**
+ * Construct the `SettingsStore`, read its current snapshot, and merge
+ * the persisted values on top of the env-derived `config`. Mutates
+ * `deps.config` in place via `mergeRuntimeSettingsFromDb`.
+ */
+export declare function loadPersistedSettings(deps: LoadPersistedSettingsDeps): LoadPersistedSettingsResult;
+export interface DelegatedTaskModeCorrectionDeps {
+    readonly db: Database.Database;
+    readonly config: AgentConfig;
+    readonly settingsStore: SettingsStore;
+    readonly persistedSettings: Partial<RuntimeSettings>;
+}
+export declare function applyDelegatedTaskModeDefaultCorrection(deps: DelegatedTaskModeCorrectionDeps): void;
+//# sourceMappingURL=db.d.ts.map

package/dist/bootstrap/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/bootstrap/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAKnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CA4DrE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,KACnB,mBAAmB,GAAG,IAAI,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,iBAAiB,CAchF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,MAAM,CAoBR;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,yBAAyB,GAC9B,2BAA2B,CAK7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACtD;AAuGD,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,+BAA+B,GACpC,IAAI,CAwBN"}