@aitne/daemon 0.1.2 → 0.1.4

package/dist/core/dispatcher-morning-routine.js

@@ -0,0 +1,434 @@
+/**
+ * `MorningRoutineRunner` — owns `routine.morning_routine` execution
+ * end-to-end: today.md write-lock acquisition, prompt-variant
+ * selection (`morning_routine` vs `morning_routine_initial`), tier
+ * inheritance for the initial variant, retry chain wrapping
+ * (`morningRoutineInProgress` flag), post-run today.md health check
+ * (missing / wrong-date), exponential-back-off retry scheduling, and
+ * the deferred post-morning catchup emit.
+ *
+ * Extracted from `core/dispatcher.ts` as part of phase D-2 of
+ * `docs/design/appendices/file-split-plan.md`. Pattern B (stateful
+ * coordinator): the runner has no mutable state of its own; it
+ * borrows the dispatcher's `morningRoutineInProgress` flag through a
+ * setter callback so the existing C-fix invariants survive the split,
+ * and bridges into a handful of dispatcher / coordinator methods that
+ * are still owned elsewhere (`rotateDayFiles`,
+ * `diagnoseTodayMdState`, `isRoadmapStale`, `emitRoadmapRefresh`,
+ * `triggerHourlyCheck`).
+ *
+ * Dispatcher entry points served:
+ *   - `EventDispatcher.dispatch` routes `routine === "morning_routine"`
+ *     into `executeMorningRoutine(event)`;
+ *   - `ScheduledTaskRunner.handleMorningRoutineRetry` (after Task 7)
+ *     calls back into the same entry point with a synthesized
+ *     RoutineEvent carrying the propagated retryCount.
+ *
+ * Shared-state references held:
+ *   - `setMorningRoutineInProgress` — setter callback. The flag is
+ *     flipped to true at the start of the execute → executeWithRetry
+ *     wrapper and reset in `finally` so the hourly check can resume.
+ */
+import { EventPriority, createEvent, formatSqliteDatetime, isBackendId, } from "@aitne/shared";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { getContextDir } from "../config.js";
+import { findRegisteredModel } from "./backends/model-registry.js";
+import { flushPendingTodayRefresh } from "./drift-effects.js";
+import { maybeTriggerRoadmapRefresh } from "./schedule-insert-helper.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("dispatcher-morning-routine");
+export class MorningRoutineRunner {
+    db;
+    config;
+    eventBus;
+    contextBuilder;
+    agentRouter;
+    notificationMgr;
+    todayWriteLock;
+    prompt;
+    errorRouter;
+    resultProcessor;
+    fetchWindowRunner;
+    setMorningRoutineInProgress;
+    rotateDayFiles;
+    diagnoseTodayMdState;
+    isRoadmapStale;
+    emitRoadmapRefresh;
+    triggerHourlyCheck;
+    constructor(deps) {
+        this.db = deps.db;
+        this.config = deps.config;
+        this.eventBus = deps.eventBus;
+        this.contextBuilder = deps.contextBuilder;
+        this.agentRouter = deps.agentRouter;
+        this.notificationMgr = deps.notificationMgr;
+        this.todayWriteLock = deps.todayWriteLock;
+        this.prompt = deps.prompt;
+        this.errorRouter = deps.errorRouter;
+        this.resultProcessor = deps.resultProcessor;
+        this.fetchWindowRunner = deps.fetchWindowRunner;
+        this.setMorningRoutineInProgress = deps.setMorningRoutineInProgress;
+        this.rotateDayFiles = deps.rotateDayFiles;
+        this.diagnoseTodayMdState = deps.diagnoseTodayMdState;
+        this.isRoadmapStale = deps.isRoadmapStale;
+        this.emitRoadmapRefresh = deps.emitRoadmapRefresh;
+        this.triggerHourlyCheck = deps.triggerHourlyCheck;
+    }
+    /**
+     * Morning routine execution with pre-processing (lock, rotateDayFiles,
+     * prompt variant selection). Only called for routine === "morning_routine".
+     * Tier is resolved by BackendRouter from process-key defaults or user config.
+     */
+    async executeMorningRoutine(event) {
+        let lockId = null;
+        let effectiveEvent = event;
+        if (this.todayWriteLock) {
+            const lock = this.todayWriteLock.acquire();
+            if (!lock.ok) {
+                logger.warn({
+                    eventType: event.type,
+                    source: event.source,
+                    holder: lock.holder,
+                }, "today.md write lock held during morning routine — scheduling retry");
+                this.scheduleMorningRetry(event);
+                return;
+            }
+            lockId = lock.lockId;
+            effectiveEvent = {
+                ...event,
+                data: {
+                    ...event.data,
+                    todayWriteLockId: lockId,
+                },
+            };
+        }
+        this.rotateDayFiles();
+        // Check roadmap staleness BEFORE agent runs (agent may PATCH roadmap, updating mtime)
+        const roadmapStaleBeforeMorning = this.isRoadmapStale();
+        // Select prompt variant based on whether yesterday.md exists
+        const contextDir = getContextDir(this.config, this.db);
+        const hasYesterday = existsSync(join(contextDir, "yesterday.md"));
+        const promptKey = hasYesterday
+            ? "routine.morning_routine"
+            : "routine.morning_routine_initial";
+        // Retry runs on the light tier (Sonnet) instead of the configured heavy
+        // tier (Opus). Cost trade-off: a wrong-date or malformed today.md is
+        // cheap to regenerate — the heavy work (mail classification, journal
+        // synthesis, roadmap walk) was already done by the first attempt and its
+        // outputs persisted via /api/context/* writes that survive into the
+        // retry's prompt context. Sonnet at ~1/5 of Opus's per-turn cost keeps
+        // the worst-case retry chain (3 attempts) under $2 instead of $12,
+        // which is the cap the user asked for after observing $25/hour
+        // burn during a date-format loop. See morning-routine fix doc.
+        const retryCount = Number(effectiveEvent.data?.retryCount ?? 0);
+        const isRetry = retryCount > 0 || effectiveEvent.data?.isRetry === true;
+        let requestedTier = isRetry
+            ? "medium"
+            : undefined;
+        // `routine.morning_routine_initial` is non-configurable, so plan presets
+        // and operator pins on `routine.morning_routine` are silently ignored
+        // here without explicit inheritance — Max5/Max20/Team/Enterprise users
+        // pinned to Sonnet would still run Opus on the initial variant whenever
+        // `yesterday.md` is missing (cf. plan-presets.ts and process-key.ts §
+        // morning_routine_initial). Mirror morning_routine's configured tier
+        // onto the initial run when available.
+        if (!isRetry && promptKey === "routine.morning_routine_initial") {
+            const inheritedTier = this.inferConfiguredMorningRoutineTier();
+            if (inheritedTier) {
+                requestedTier = inheritedTier;
+            }
+        }
+        logger.info({ hasYesterday, promptKey, roadmapStale: roadmapStaleBeforeMorning, isRetry, retryCount, requestedTier: requestedTier ?? "default" }, "Morning routine prompt selected");
+        // B2 fix + ROUTINE_DATA_ACQUISITION_DESIGN.md Phase 4 / D2 race fix:
+        // flip `morningRoutineInProgress=true` BEFORE the pre-pass fires so
+        // hourly_check can't squeeze through the cold-start window
+        // (`hourlyCheck.trigger` skips when `isMorningRoutineActive()`
+        // returns true). The original B2 fix already widened the flag to
+        // span the whole retry chain; the pre-pass shifts the boundary
+        // earlier so the same guard covers context build + binding resolve
+        // + Haiku fetcher cold-start, all of which precede the executor.
+        // The flag is reset in `finally` regardless of whether the pre-pass,
+        // context build, or main session throws — so a partial-failure path
+        // cannot leave the flag stuck `true` and starve hourly_check forever.
+        this.setMorningRoutineInProgress(true);
+        let result;
+        try {
+            // ROUTINE_DATA_ACQUISITION_DESIGN.md Phase 4 / D2 — fire the
+            // pre-pass fetcher session BEFORE we build the parent's context.
+            // The fetcher POSTs to `/api/observations` so the parent's
+            // `pending=true` reads see the fresh rows; the rendered
+            // `<fetch_report>` block is grafted into `event.data.fetchReportBlock`
+            // so ContextBuilder injects it verbatim into the parent prompt. The
+            // runner never throws — failures surface as
+            // `<fetch_report status="failed">` and the parent routine
+            // continues with whatever observations the rest of the plan
+            // produced (cf. runner doc-comment, design §11 R5).
+            //
+            // Retry runs (`isRetry === true`) skip the pre-pass: by the time we
+            // retry, observations posted by the original attempt are still
+            // available (TTL is days; retries are minutes apart), and Haiku
+            // tokens spent re-confirming the same window inflate the retry
+            // cost cap the user explicitly set. The morning_routine_initial
+            // path shares morning_routine's plan via the runner's automatic
+            // key derivation, so no special-casing is required there.
+            const fetchPrepass = isRetry
+                ? null
+                : await this.fetchWindowRunner.run(effectiveEvent, promptKey);
+            if (fetchPrepass) {
+                effectiveEvent = {
+                    ...effectiveEvent,
+                    data: {
+                        ...effectiveEvent.data,
+                        fetchReportBlock: fetchPrepass.block,
+                    },
+                };
+            }
+            const context = await this.contextBuilder.build(effectiveEvent);
+            const binding = this.agentRouter.resolveBinding(effectiveEvent, {
+                processKey: promptKey,
+                ...(requestedTier ? { requestedTier } : {}),
+            });
+            const reassemblePrompt = (bid) => this.prompt.assemble(promptKey, promptKey, bid);
+            const prompt = reassemblePrompt(binding.main.backendId);
+            result = await this.errorRouter.executeWithRetry(() => this.agentRouter.execute({
+                prompt,
+                context,
+                event: effectiveEvent,
+                processKey: promptKey,
+                preResolvedBinding: binding,
+                reassemblePrompt,
+                ...(requestedTier ? { requestedTier } : {}),
+            }), effectiveEvent);
+        }
+        finally {
+            this.setMorningRoutineInProgress(false);
+            if (lockId && this.todayWriteLock) {
+                this.todayWriteLock.release(lockId);
+            }
+        }
+        await this.resultProcessor.processResult(result, effectiveEvent);
+        // Post-morning-routine: verify today.md was generated, retry if not.
+        // This catches agent failures that don't throw (e.g., early stop, context
+        // building succeeded but the PUT /api/context/today call was skipped).
+        //
+        // Distinguish the two failure modes so the operator can tell from the log
+        // whether the agent skipped the write entirely vs. wrote with the wrong
+        // agent-day date. Pre-fix, both paths logged the same "does not exist"
+        // string and the wrong-date case looked indistinguishable from a hard
+        // crash, masking the date-confusion root cause.
+        const todayMdState = this.diagnoseTodayMdState();
+        if (todayMdState.kind !== "fresh") {
+            logger.warn({
+                eventType: effectiveEvent.type,
+                isError: result.isError,
+                numTurns: result.numTurns,
+                todayMdState: todayMdState.kind,
+                ...(todayMdState.kind === "wrong_date"
+                    ? {
+                        writtenDate: todayMdState.writtenDate,
+                        expectedAgentDay: todayMdState.expectedAgentDay,
+                    }
+                    : {}),
+            }, todayMdState.kind === "missing"
+                ? "Morning routine completed but today.md does not exist — scheduling retry"
+                : "Morning routine completed but today.md has wrong agent-day date — scheduling retry");
+            this.scheduleMorningRetry(effectiveEvent);
+        }
+        else {
+            if (effectiveEvent.data?.deferPostMorningCatchupsUntilStartupReady === true) {
+                logger.info({ eventType: effectiveEvent.type, source: effectiveEvent.source }, "Deferring post-morning catchups until startup messaging is ready");
+            }
+            else {
+                await this.emitPostMorningCatchups(effectiveEvent);
+            }
+            const todayRefreshFlush = flushPendingTodayRefresh(this.db);
+            if (todayRefreshFlush.hadPending) {
+                logger.info({ scheduled: todayRefreshFlush.scheduled }, "Flushed pending today_refresh after morning routine");
+            }
+        }
+        // Post-morning-routine: trigger roadmap refresh if stale
+        if (roadmapStaleBeforeMorning) {
+            if (effectiveEvent.data?.deferPostMorningCatchupsUntilStartupReady === true) {
+                logger.info({ eventType: effectiveEvent.type, source: effectiveEvent.source }, "Deferring roadmap_refresh until startup messaging is ready");
+            }
+            else {
+                this.emitRoadmapRefresh("post_morning_routine");
+            }
+        }
+    }
+    /**
+     * Read the operator-or-preset configured tier for `routine.morning_routine`
+     * so the non-configurable `morning_routine_initial` variant can mirror it.
+     * Returns null when no row exists (fresh install before the setup wizard
+     * applies a preset) or when the pinned model isn't in the registry — the
+     * caller falls back to the router's default tier in those cases.
+     */
+    inferConfiguredMorningRoutineTier() {
+        try {
+            const row = this.db
+                .prepare("SELECT main_backend, main_model FROM process_backend_config WHERE process_key = 'routine.morning_routine'")
+                .get();
+            if (!row || !isBackendId(row.main_backend))
+                return null;
+            return findRegisteredModel(row.main_backend, row.main_model)?.tier ?? null;
+        }
+        catch (err) {
+            logger.debug({ err }, "Failed to infer morning_routine configured tier");
+            return null;
+        }
+    }
+    async emitPostMorningCatchups(event) {
+        const queuedRoutines = Array.isArray(event.data?.postCatchupRoutines)
+            ? event.data.postCatchupRoutines.filter((value) => typeof value === "string")
+            : [];
+        for (const routine of queuedRoutines) {
+            logger.info({ routine }, "Emitting deferred post-morning catchup routine");
+            await this.eventBus.put({
+                ...createEvent({
+                    type: `routine.${routine}`,
+                    source: "post_morning_catchup",
+                    priority: EventPriority.HIGH,
+                }),
+                routine,
+            });
+        }
+        if (event.data?.postCatchupHourlyCheck === true) {
+            logger.info("Triggering deferred hourly_check after morning catchup");
+            await this.triggerHourlyCheck("post_morning_catchup");
+        }
+    }
+    /**
+     * Schedule a retry of the morning routine when today.md wasn't generated.
+     *
+     * Uses the existing agent_schedule → ScheduleWatcher path rather than
+     * re-enqueuing on the EventBus directly. Benefits:
+     * 1. Retry persists across daemon restarts.
+     * 2. Shares the same Opus cost-limit and concurrency gates.
+     * 3. Back-off delay is enforced by scheduled_for timestamp.
+     *
+     * Retry policy: exponential back-off (5 min → 10 min → 15 min), max 3
+     * attempts. After the 3rd failure, send a critical notification to
+     * the user and stop retrying.
+     *
+     * Retry count is tracked via `event.data.retryCount` on the RoutineEvent.
+     * On the first failure the count comes from the cron-fired RoutineEvent
+     * (undefined → 0). On subsequent failures handleMorningRoutineRetry
+     * synthesizes a new RoutineEvent carrying the previous count from the
+     * wake task's taskContext, so the chain propagates through a single
+     * code path: event.data.retryCount → +1 → task_context.retryCount
+     * → next event.data.retryCount → ...
+     *
+     * Dedup protects against pathological cases:
+     *  - M1: another retry is already pending/running → skip
+     */
+    scheduleMorningRetry(event) {
+        const previousCount = Number(event.data?.retryCount ?? 0);
+        const retryCount = previousCount + 1;
+        const MAX_RETRIES = 3;
+        // Preserve the original cron morning_routine correlationId through
+        // the chain if present. On the first call this is the cron event's
+        // own id. On later calls it's propagated via event.correlationId
+        // (which handleMorningRoutineRetry sets from taskCtx).
+        const originalCorrelationId = event.data?.originalCorrelationId ??
+            event.correlationId;
+        if (retryCount > MAX_RETRIES) {
+            logger.error({
+                retryCount: previousCount,
+                maxRetries: MAX_RETRIES,
+                originalCorrelationId,
+            }, "Morning routine retry exhausted — sending critical notification");
+            void this.notificationMgr
+                .send(`⚠️ Morning routine failed to generate today.md after ${MAX_RETRIES} attempts. Please regenerate manually from the dashboard.`, event, { category: "critical", priority: "critical" })
+                .catch((err) => {
+                logger.error({ err }, "Failed to send morning-routine-retry-exhausted notification");
+            });
+            return;
+        }
+        // Exponential back-off: 5 / 10 / 15 minutes
+        const delayMinutes = retryCount * 5;
+        const retryTime = new Date(Date.now() + delayMinutes * 60 * 1000);
+        const scheduledFor = formatSqliteDatetime(retryTime);
+        // Encode the retry state in task_context so the wake agent (via
+        // executeScheduledTask → handleMorningRoutineRetry) can propagate
+        // retryCount into the synthesized RoutineEvent's event.data.
+        // `importance: "low"` keeps the retry out of roadmap.md — the
+        // originating morning_routine is already tracked elsewhere.
+        const taskContext = JSON.stringify({
+            routine: "morning_routine",
+            retryCount,
+            originalCorrelationId,
+            source: typeof event.data?.queuedSource === "string" ? event.data.queuedSource : event.source,
+            postCatchupRoutines: Array.isArray(event.data?.postCatchupRoutines)
+                ? event.data.postCatchupRoutines
+                : [],
+            postCatchupHourlyCheck: event.data?.postCatchupHourlyCheck === true,
+            importance: "low",
+        });
+        // M1: dedup + INSERT in a single transaction so two concurrent
+        // retry schedulers cannot both race past the dedup check and both
+        // insert new rows. better-sqlite3 is synchronous so the transaction
+        // callback runs atomically relative to any other DB access from
+        // this process.
+        //
+        // Dedup checks for 'pending' only — not 'running' — because the
+        // retry chain legitimately calls this method while the current
+        // wake task is still in 'running' state (handleMorningRoutineRetry
+        // → executeMorningRoutine → this). Including 'running' would break chain
+        // continuation.
+        const insertRetryTxn = this.db.transaction(() => {
+            // C5 fix: dedup on task_context.routine, not task_description prefix.
+            // Both `scheduleMorningRetry` (here) and `isMorningRoutineActive`
+            // (above) now use the same JSON-path check, so the detection path
+            // doesn't depend on the human-readable description string.
+            const existing = this.db
+                .prepare(`SELECT id FROM agent_schedule
+           WHERE task_type = 'wake'
+             AND status = 'pending'
+             AND json_extract(task_context, '$.routine') = 'morning_routine'
+           LIMIT 1`)
+                .get();
+            if (existing) {
+                return { inserted: false, existingId: existing.id };
+            }
+            this.db
+                .prepare(`INSERT INTO agent_schedule
+             (scheduled_for, task_type, task_description, task_context, correlation_id, model, status)
+           VALUES (?, 'wake', ?, ?, ?, NULL, 'pending')`)
+                .run(scheduledFor, `Morning routine retry (attempt ${retryCount}/${MAX_RETRIES}). Generate today.md per the morning_routine flow.`, taskContext, originalCorrelationId);
+            return { inserted: true };
+        });
+        try {
+            const outcome = insertRetryTxn();
+            if (!outcome.inserted) {
+                logger.info({
+                    existingScheduleId: outcome.existingId,
+                    retryCount,
+                    originalCorrelationId,
+                }, "Morning routine retry dedup — another pending retry already exists");
+                return;
+            }
+            logger.info({
+                retryCount,
+                delayMinutes,
+                scheduledFor,
+                originalCorrelationId,
+                // Retries always fall back to the medium tier (Sonnet) per the
+                // cost-cap fix in executeMorningRoutine — surface that explicitly
+                // in the schedule log so the operator can confirm the
+                // downgrade happened without grepping the next agent-execute line.
+                plannedTier: "medium",
+                plannedTierReason: "morning_routine_retry_cost_cap",
+            }, "Morning routine retry scheduled (will run on Sonnet)");
+            // Route the INSERT through the shared roadmap-refresh gate.
+            // `importance:"low"` short-circuits the trigger — the morning
+            // routine is already represented elsewhere — but going through
+            // the helper keeps all five INSERT call-sites on one path.
+            maybeTriggerRoadmapRefresh({ scheduledFor, taskContext: { importance: "low" } }, (src) => this.emitRoadmapRefresh(src), "morning_retry");
+        }
+        catch (err) {
+            logger.error({ err, retryCount }, "Failed to schedule morning routine retry");
+        }
+    }
+}
+//# sourceMappingURL=dispatcher-morning-routine.js.map

package/dist/core/dispatcher-morning-routine.js.map

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

package/dist/core/dispatcher-prompt.d.ts

@@ -0,0 +1,107 @@
+/**
+ * `PromptAssembler` — composes the dispatcher's per-turn prompt and
+ * owns the inbound-attachment lifecycle (staging into the session dir,
+ * transcribing audio via local Whisper, and rendering the
+ * "[Attached files]" prompt block).
+ *
+ * Extracted from `core/dispatcher.ts` as part of phase D-2 of
+ * `docs/design/appendices/file-split-plan.md`. Pattern B (stateful
+ * coordinator): the assembler owns its own logic but borrows live
+ * references / accessors for state that the dispatcher continues to
+ * own (the `activeTurnTokens` Map, the lazily-injected
+ * `AttachmentStore`, and the lazily-injected `VoiceTranscriber`).
+ *
+ * Dispatcher entry points served:
+ *   - every `dispatch.*` path that needs a task-flow prompt
+ *     (`runStage2Triage`, `executeMorningRoutine`,
+ *     `executeScheduledTask`, `executeDefault`, `handleMessage`);
+ *   - `handleMessage` for the inbound attachment lifecycle
+ *     (`stageInboundAttachments` → `transcribeAttachments` →
+ *     `buildAttachmentPromptBlock`);
+ *   - `validateAttachmentTurnToken` (public on `EventDispatcher`,
+ *     reads the live `activeTurnTokens` Map this assembler issues
+ *     into via `issueAttachmentTurnToken`).
+ *
+ * Shared-state references held:
+ *   - `activeTurnTokens: Map<string, number>` — live reference,
+ *     mutated in place via `issueAttachmentTurnToken` /
+ *     `releaseAttachmentTurnToken`. The dispatcher's
+ *     `validateAttachmentTurnToken` reads the same map.
+ *   - `getAttachmentStore` / `getVoiceTranscriber` — getter callbacks
+ *     because both are set lazily by `index.ts` after the dispatcher
+ *     is constructed. The assembler must read the *current* value at
+ *     each call, not capture it once.
+ */
+import type Database from "better-sqlite3";
+import type { MessageEvent } from "@aitne/shared";
+import type { AgentConfig } from "../config.js";
+import type { AttachmentStore, StoreAttachmentRow } from "../services/attachments/store.js";
+import type { VoiceTranscriber, VoiceTranscriptionResult } from "../services/voice/transcriber.js";
+import type { GetTaskFlow } from "./dispatcher-types.js";
+export interface PromptAssemblerDeps {
+    db: Database.Database;
+    config: AgentConfig;
+    getTaskFlow: GetTaskFlow;
+    /** Live reference to the dispatcher's in-flight turn-token map. */
+    activeTurnTokens: Map<string, number>;
+    /**
+     * Accessor for the lazily-injected AttachmentStore. Returns null
+     * before `EventDispatcher.setAttachmentStore` has been called or in
+     * tests that don't wire the store.
+     */
+    getAttachmentStore: () => AttachmentStore | null;
+    /**
+     * Accessor for the lazily-injected VoiceTranscriber. Returns null
+     * when the local-Whisper layer is not wired.
+     */
+    getVoiceTranscriber: () => VoiceTranscriber | null;
+}
+export declare class PromptAssembler {
+    private readonly db;
+    private readonly config;
+    private readonly getTaskFlow;
+    private readonly activeTurnTokens;
+    private readonly getAttachmentStore;
+    private readonly getVoiceTranscriber;
+    constructor(deps: PromptAssemblerDeps);
+    /**
+     * B-007 §5.8 — compose the final prompt by loading the task-flow
+     * template and appending the vault policy-files block (rules/*.md,
+     * routines/<cadence>.md, custom routine file, etc.). Centralised
+     * here so every dispatch path sees the same policy bundle.
+     */
+    assemble(eventType: string, processKey: string, backendId?: string, flags?: Record<string, unknown>): string;
+    /**
+     * Policy-file prompt assembly must not fall back to `<dataDir>/context`
+     * while degraded. Reactive sessions still run so the user can repair the
+     * vault, but the prompt must not silently inject stale rulebooks from a
+     * legacy location.
+     */
+    private getPromptPolicyContextDir;
+    /** Internal — issue a turn token bound to a session. Cleared by
+     *  `releaseAttachmentTurnToken` in a `finally`. */
+    issueAttachmentTurnToken(sessionId: number): string;
+    releaseAttachmentTurnToken(token: string): void;
+    /**
+     * Stage inbound attachments into `<sessionDir>/_attachments/` via
+     * hard-link (or copy on EXDEV). Returns the rows that were actually
+     * staged — callers feed these into the prompt-block builder.
+     */
+    stageInboundAttachments(event: MessageEvent, sessionDir: string | undefined): StoreAttachmentRow[];
+    /**
+     * Run local-Whisper transcription on every audio attachment in `rows`.
+     * Cached transcripts are returned without re-running inference. Returns
+     * an empty map when the transcriber is unset, when no rows are audio,
+     * or when every transcription failed — callers always render the path
+     * even if the transcript is missing.
+     */
+    transcribeAttachments(rows: StoreAttachmentRow[]): Promise<Map<string, VoiceTranscriptionResult>>;
+    /**
+     * Compose the "[Attached files]" prompt block that the dispatcher
+     * appends to the task-flow body for turns with inbound attachments.
+     * Kept on the assembler (not in prompts.ts) because the attachment
+     * rows are local state for this turn only.
+     */
+    buildAttachmentPromptBlock(rows: StoreAttachmentRow[], transcripts?: Map<string, VoiceTranscriptionResult>): string;
+}
+//# sourceMappingURL=dispatcher-prompt.d.ts.map

package/dist/core/dispatcher-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-prompt.d.ts","sourceRoot":"","sources":["../../src/core/dispatcher-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACjD;;;OAGG;IACH,mBAAmB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;CACpD;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;gBAExD,IAAI,EAAE,mBAAmB;IASrC;;;;;OAKG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM;IAqCT;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAOjC;uDACmD;IACnD,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAMnD,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/C;;;;OAIG;IACH,uBAAuB,CACrB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,kBAAkB,EAAE;IAkBvB;;;;;;OAMG;IACG,qBAAqB,CACzB,IAAI,EAAE,kBAAkB,EAAE,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAuBjD;;;;;OAKG;IACH,0BAA0B,CACxB,IAAI,EAAE,kBAAkB,EAAE,EAC1B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAClD,MAAM;CAsDV"}