@cortexkit/opencode-magic-context 0.26.0 → 0.27.0

package/src/shared/tui-config.ts

@@ -3,7 +3,15 @@
  * Called from the server plugin at startup so the TUI sidebar loads on next restart.
  */
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import {
+    chmodSync,
+    existsSync,
+    mkdirSync,
+    readFileSync,
+    renameSync,
+    statSync,
+    writeFileSync,
+} from "node:fs";
 import { dirname, join } from "node:path";
 import { parse, stringify } from "comment-json";
 import { log } from "./logger";
@@ -12,27 +20,41 @@ import { getOpenCodeConfigPaths } from "./opencode-config-dir";
 const PLUGIN_NAME = "@cortexkit/opencode-magic-context";
 const PLUGIN_ENTRY = `${PLUGIN_NAME}@latest`;
 
-/**
- * Detect whether a tui.json plugin entry already references magic-context, in
- * any form. Covers:
- *   - Bare npm name: "@cortexkit/opencode-magic-context"
- *   - Versioned npm: "@cortexkit/opencode-magic-context@latest" / "@0.15.7" / etc.
- *   - Local dev directory path (absolute or relative): ".../magic-context"
- *     or ".../magic-context/packages/plugin"
- *   - file:// URLs pointing at the same paths
- *   - Tarball paths ending in opencode-magic-context-*.tgz
- *
- * Without the path/URL detection, doctor/setup auto-injection adds the npm
- * @latest entry on top of an existing dev path, double-loading the plugin.
- */
-function isMagicContextEntry(entry: string): boolean {
-    if (!entry) return false;
-    if (entry === PLUGIN_NAME) return true;
-    if (entry.startsWith(`${PLUGIN_NAME}@`)) return true;
-    // Local directory paths: match anywhere in the string so the setup pattern
-    // (dir-only, dir + /packages/plugin, file:// + either) all qualify.
-    if (entry.includes("opencode-magic-context")) return true;
-    return false;
+function pluginEntryId(entry: unknown): string {
+    if (typeof entry === "string") return entry;
+    if (Array.isArray(entry) && typeof entry[0] === "string") return entry[0];
+    return "";
+}
+
+function isLocalMagicContextDevEntry(entry: unknown): boolean {
+    const id = pluginEntryId(entry);
+    if (!id) return false;
+    if (id === PLUGIN_NAME || id.startsWith(`${PLUGIN_NAME}@`)) return false;
+    const isPath =
+        id.startsWith("file://") || id.startsWith("/") || id.startsWith("./") || id.includes("\\");
+    if (!isPath) return false;
+    return id.includes("opencode-magic-context") || id.includes("magic-context");
+}
+
+function isMagicContextPluginEntry(entry: unknown): boolean {
+    const id = pluginEntryId(entry);
+    if (!id) return false;
+    if (id === PLUGIN_NAME || id.startsWith(`${PLUGIN_NAME}@`)) return true;
+    return isLocalMagicContextDevEntry(entry);
+}
+
+function writeTuiConfigAtomic(configPath: string, config: Record<string, unknown>): void {
+    const body = `${stringify(config, null, 2)}\n`;
+    const tmpPath = `${configPath}.tmp`;
+    writeFileSync(tmpPath, body);
+    try {
+        if (statSync(configPath, { throwIfNoEntry: false })?.isFile()) {
+            chmodSync(tmpPath, statSync(configPath).mode & 0o777);
+        }
+    } catch {
+        /* new file */
+    }
+    renameSync(tmpPath, configPath);
 }
 
 function resolveTuiConfigPath(): string {
@@ -59,35 +81,41 @@ export function ensureTuiPluginEntry(): boolean {
             config = (parse(raw) as Record<string, unknown>) ?? {};
         }
 
-        const plugins = Array.isArray(config.plugin)
-            ? config.plugin.filter((p): p is string => typeof p === "string")
-            : [];
+        const plugins: unknown[] = Array.isArray(config.plugin) ? [...config.plugin] : [];
 
-        const existingIdx = plugins.findIndex(isMagicContextEntry);
+        const existingIdx = plugins.findIndex(isMagicContextPluginEntry);
         if (existingIdx >= 0) {
             const existing = plugins[existingIdx];
-            if (existing === PLUGIN_ENTRY) {
-                return false; // Already @latest
+            if (isLocalMagicContextDevEntry(existing)) {
+                return false;
+            }
+            const id = pluginEntryId(existing);
+            if (id === PLUGIN_ENTRY) {
+                return false;
             }
-            // Only upgrade the bare versionless npm name to @latest.
-            // Pinned versions (e.g. @0.8.10), local dev paths
-            // (~/Work/OSS/magic-context/packages/plugin), and
-            // file:// URLs are all left as-is — the user chose them
-            // intentionally and overwriting their dev-loop entry would
-            // either double-load the plugin (npm + dev) or replace
-            // their working directory pointer.
-            if (existing === PLUGIN_NAME) {
-                plugins[existingIdx] = PLUGIN_ENTRY;
+            if (id === PLUGIN_NAME) {
+                if (Array.isArray(existing) && existing.length >= 1) {
+                    const replacement = [...existing];
+                    replacement[0] = PLUGIN_ENTRY;
+                    plugins[existingIdx] = replacement;
+                } else {
+                    plugins[existingIdx] = PLUGIN_ENTRY;
+                }
             } else {
                 return false;
             }
         } else {
-            plugins.push(PLUGIN_ENTRY);
+            const hasDev = plugins.some(isLocalMagicContextDevEntry);
+            if (!hasDev) {
+                plugins.push(PLUGIN_ENTRY);
+            } else {
+                return false;
+            }
         }
         config.plugin = plugins;
 
         mkdirSync(dirname(configPath), { recursive: true });
-        writeFileSync(configPath, `${stringify(config, null, 2)}\n`);
+        writeTuiConfigAtomic(configPath, config);
         log(`[magic-context] updated TUI plugin entry in ${configPath}`);
         return true;
     } catch (error) {

package/src/tui/data/context-db.ts

@@ -205,6 +205,7 @@ export async function loadStatusDetail(
         historyBlockTokens: 0,
         compressionBudget: null,
         compressionUsage: null,
+        toastDurationMs: 5000,
     };
 
     if (!rpcClient) return emptyDetail;
@@ -299,6 +300,17 @@ export async function dismissUpgradeReminder(sessionId: string): Promise<boolean
     }
 }
 
+/** Resolve global toast duration from server config via RPC. */
+export async function loadToastDurationMs(): Promise<number> {
+    if (!rpcClient) return 5000;
+    try {
+        const result = await rpcClient.call<{ toastDurationMs?: number }>("toast-duration", {});
+        return typeof result.toastDurationMs === "number" ? result.toastDurationMs : 5000;
+    } catch {
+        return 5000;
+    }
+}
+
 export interface TuiMessage {
     id: number;
     type: string;

package/src/tui/index.tsx

@@ -6,7 +6,7 @@ import { createMemo } from "solid-js"
 import type { TuiPlugin, TuiPluginApi, TuiThemeCurrent } from "@opencode-ai/plugin/tui"
 import { createSidebarContentSlot, kickRecompProgressRefresh } from "./slots/sidebar-content"
 import packageJson from "../../package.json"
-import { closeRpc, consumeTuiMessages, dismissUpgradeReminder, getAnnouncement, getCompartmentCount, getRpcGeneration, initRpcClient, loadEmbedDetail, loadStatusDetail, markAnnounced, markTuiMessagesHandled, requestRecomp, requestUpgrade, type EmbedDetail, type TuiMessage, type StatusDetail } from "./data/context-db"
+import { closeRpc, consumeTuiMessages, dismissUpgradeReminder, getAnnouncement, getCompartmentCount, getRpcGeneration, initRpcClient, loadEmbedDetail, loadStatusDetail, loadToastDurationMs, markAnnounced, markTuiMessagesHandled, requestRecomp, requestUpgrade, type EmbedDetail, type TuiMessage, type StatusDetail } from "./data/context-db"
 import { formatThresholdPercent } from "../shared/format-threshold"
 import { detectConflicts } from "../shared/conflict-detector"
 import { fixConflicts } from "../shared/conflict-fixer"
@@ -14,6 +14,48 @@ import { readJsoncFile } from "../shared/jsonc-parser"
 import { getOpenCodeConfigPaths } from "../shared/opencode-config-dir"
 
 const PLUGIN_NAME = "@cortexkit/opencode-magic-context"
+const DEFAULT_TOAST_DURATION_MS = 5000
+let unifiedToastDurationMs = DEFAULT_TOAST_DURATION_MS
+
+async function refreshToastDurationMs(): Promise<void> {
+    try {
+        const resolved = await loadToastDurationMs()
+        if (typeof resolved === "number" && Number.isFinite(resolved)) {
+            unifiedToastDurationMs = resolved
+        }
+    } catch {
+        // Keep the current value; the next poll/startup can retry.
+    }
+}
+
+function getToastDurationMs(): number {
+    return unifiedToastDurationMs
+}
+
+function showToast(
+    api: TuiPluginApi,
+    input: {
+        message: string
+        variant: "info" | "warning" | "error" | "success"
+        durationOverrideMs?: number
+    },
+): void {
+    const duration =
+        typeof input.durationOverrideMs === "number" && Number.isFinite(input.durationOverrideMs)
+            ? input.durationOverrideMs
+            : getToastDurationMs()
+    // toast_duration_ms = 0 disables Magic Context toasts entirely. An explicit
+    // positive per-call override (e.g. restart-required) still shows; only a
+    // non-positive effective duration suppresses the toast.
+    if (!(duration > 0)) {
+        return
+    }
+    api.ui.toast({
+        message: input.message,
+        variant: input.variant,
+        duration,
+    })
+}
 
 function ensureParentDir(filePath: string) {
     mkdirSync(dirname(filePath), { recursive: true })
@@ -97,14 +139,18 @@ function showConflictDialog(api: TuiPluginApi, directory: string, reasons: strin
                             title="✅ Configuration Fixed"
                             message={`${actionSummary}\n\nPlease restart OpenCode for changes to take effect.`}
                             onConfirm={() => {
-                                api.ui.toast({ message: "Restart OpenCode to enable Magic Context", variant: "warning", duration: 10000 })
+                                showToast(api, {
+                                    message: "Restart OpenCode to enable Magic Context",
+                                    variant: "warning",
+                                    durationOverrideMs: 10_000,
+                                })
                             }}
                         />
                     ))
                 }, 50)
             }}
             onCancel={() => {
-                api.ui.toast({ message: "Magic Context remains disabled. Run: npx @cortexkit/opencode-magic-context@latest doctor", variant: "warning", duration: 5000 })
+                showToast(api, { message: "Magic Context remains disabled. Run: npx @cortexkit/opencode-magic-context@latest doctor", variant: "warning" })
             }}
         />
     ))
@@ -132,7 +178,7 @@ function showTuiSetupDialog(api: TuiPluginApi) {
                                 title="❌ Setup Failed"
                                 message={'Could not update tui.json automatically. Add the plugin manually:\n\n  { "plugin": ["@cortexkit/opencode-magic-context"] }'}
                                 onConfirm={() => {
-                                    api.ui.toast({ message: "Add plugin to tui.json manually", variant: "warning", duration: 5000 })
+                                    showToast(api, { message: "Add plugin to tui.json manually", variant: "warning" })
                                 }}
                             />
                         ))
@@ -146,14 +192,18 @@ function showTuiSetupDialog(api: TuiPluginApi) {
                             title="✅ Sidebar Enabled"
                             message="tui.json updated with Magic Context plugin.\n\nPlease restart OpenCode to see the sidebar."
                             onConfirm={() => {
-                                api.ui.toast({ message: "Restart OpenCode to see the sidebar", variant: "warning", duration: 10000 })
+                                showToast(api, {
+                                    message: "Restart OpenCode to see the sidebar",
+                                    variant: "warning",
+                                    durationOverrideMs: 10_000,
+                                })
                             }}
                         />
                     ))
                 }, 50)
             }}
             onCancel={() => {
-                api.ui.toast({ message: "You can add the sidebar later via: npx @cortexkit/opencode-magic-context@latest doctor", variant: "info", duration: 5000 })
+                showToast(api, { message: "You can add the sidebar later via: npx @cortexkit/opencode-magic-context@latest doctor", variant: "info" })
             }}
         />
     ))
@@ -203,8 +253,16 @@ const StatusDialog = (props: { api: TuiPluginApi; s: StatusDetail }) => {
     const t = () => theme()
     const s = () => props.s
 
+    // Prefer the RPC-provided model context limit (what the sidebar shows) so the
+    // two surfaces never disagree. Fall back to deriving from usage% only when the
+    // RPC limit is absent (0) — and that derivation is itself undefined at 0%, so
+    // it stays "?" rather than showing a number inconsistent with the sidebar.
     const contextLimit = () =>
-        s().usagePercentage > 0 ? Math.round(s().inputTokens / (s().usagePercentage / 100)) : 0
+        s().contextLimit > 0
+            ? s().contextLimit
+            : s().usagePercentage > 0
+              ? Math.round(s().inputTokens / (s().usagePercentage / 100))
+              : 0
 
     const elapsed = () => (s().lastResponseTime > 0 ? Date.now() - s().lastResponseTime : 0)
 
@@ -450,7 +508,7 @@ function getModelKeyFromMessages(api: TuiPluginApi, sessionId: string): string |
 async function showRecompDialog(api: TuiPluginApi, targetSessionId = getSessionId(api)): Promise<boolean> {
     const sessionId = targetSessionId
     if (!sessionId) {
-        api.ui.toast({ message: "No active session", variant: "warning" })
+        showToast(api, { message: "No active session", variant: "warning" })
         return false
     }
 
@@ -475,10 +533,10 @@ async function showRecompDialog(api: TuiPluginApi, targetSessionId = getSessionI
             onConfirm={() => {
                 void requestRecomp(sessionId)
                 kickRecompProgressRefresh()
-                api.ui.toast({ message: "Recomp requested — historian will start shortly", variant: "info", duration: 5000 })
+                showToast(api, { message: "Recomp requested — historian will start shortly", variant: "info" })
             }}
             onCancel={() => {
-                api.ui.toast({ message: "Recomp cancelled", variant: "info", duration: 3000 })
+                showToast(api, { message: "Recomp cancelled", variant: "info", durationOverrideMs: 3000 })
             }}
         />
     ))
@@ -535,12 +593,11 @@ function showUpgradeDialog(
                     // call fires no message event, so without this the progress
                     // bar wouldn't appear until the upgrade finished.
                     kickRecompProgressRefresh()
-                    api.ui.toast({
+                    showToast(api, {
                         message: resume
                             ? "Resuming session upgrade — running in the background"
                             : "Session upgrade started — running in the background",
                         variant: "info",
-                        duration: 5000,
                     })
                     // Dismiss the durable reminder ONLY after the upgrade request
                     // actually started. If requestUpgrade() returns false (RPC /
@@ -558,10 +615,10 @@ function showUpgradeDialog(
                     // never-upgraded session (dogfood 2026-05-30) relies on THIS
                     // being the only place the TUI path stamps.
                     void dismissUpgradeReminder(sessionId)
-                    api.ui.toast({
+                    showToast(api, {
                         message: "Upgrade skipped — run /ctx-session-upgrade anytime",
                         variant: "info",
-                        duration: 4000,
+                        durationOverrideMs: 4000,
                     })
                 }}
             />
@@ -573,7 +630,7 @@ function showUpgradeDialog(
 async function showStatusDialog(api: TuiPluginApi, targetSessionId = getSessionId(api)): Promise<boolean> {
     const sessionId = targetSessionId
     if (!sessionId) {
-        api.ui.toast({ message: "No active session", variant: "warning" })
+        showToast(api, { message: "No active session", variant: "warning" })
         return false
     }
 
@@ -793,6 +850,7 @@ const tui: TuiPlugin = async (api, _options, meta) => {
     // Initialize RPC client for server communication
     const directory = api.state.path.directory ?? ""
     initRpcClient(directory)
+    await refreshToastDurationMs()
 
     // Register sidebar slot
     api.slots.register(createSidebarContentSlot(api))
@@ -830,6 +888,9 @@ const tui: TuiPlugin = async (api, _options, meta) => {
         pollInFlight = true
         const pollGeneration = getRpcGeneration()
         void consumeTuiMessages(requestedSessionId).then(async (messages) => {
+            if (unifiedToastDurationMs === DEFAULT_TOAST_DURATION_MS) {
+                void refreshToastDurationMs()
+            }
             // The dialog handlers read the current session when they run. If the
             // user switched routes while the RPC was in flight, drop this whole
             // batch without advancing the cursor; the next poll for the new
@@ -843,6 +904,12 @@ const tui: TuiPlugin = async (api, _options, meta) => {
             const orderedMessages = [...messages].sort((a, b) => a.id - b.id)
             const handledMessageIds = new Set<number>()
             for (const msg of orderedMessages) {
+                // A dialog helper earlier in this batch may have awaited; re-check
+                // the route before EACH message so a later action/toast in the same
+                // batch can't paint into a session the user switched to mid-batch
+                // (the pre-batch + pre-ack guards alone don't cover mid-batch awaits).
+                if (getRpcGeneration() !== pollGeneration) return
+                if (getSessionId(api) !== requestedSessionId) return
                 // Drop any action/dialog whose sessionId doesn't match this TUI's
                 // active session (session-less/global notifications still apply).
                 if (
@@ -854,10 +921,13 @@ const tui: TuiPlugin = async (api, _options, meta) => {
                 }
                 if (msg.type === "toast") {
                     const p = msg.payload
-                    api.ui.toast({
+                    showToast(api, {
                         message: String(p.message ?? ""),
                         variant: (p.variant as "info" | "warning" | "error" | "success") ?? "info",
-                        duration: typeof p.duration === "number" ? p.duration : 5000,
+                        durationOverrideMs:
+                            typeof p.duration === "number" && Number.isFinite(p.duration)
+                                ? p.duration
+                                : undefined,
                     })
                     handledMessageIds.add(msg.id)
                 } else if (msg.type === "action") {

package/src/tui/slots/sidebar-content.tsx

@@ -503,6 +503,10 @@ const SidebarContent = (props: {
         const directory = props.api.state.path.directory ?? ""
         void loadSidebarSnapshot(sid, directory)
             .then((data) => {
+                // Guard against a session switch while this load was in flight:
+                // painting session A's snapshot into the now-active session B shows
+                // the wrong session's numbers until B's own refresh resolves.
+                if (props.sessionID() !== sid) return
                 setSnapshot(data)
                 try {
                     props.api.renderer.requestRender()

package/dist/features/magic-context/dreamer/queue.d.ts

@@ -1,55 +0,0 @@
-import type { Database } from "../../../shared/sqlite";
-export interface DreamQueueEntry {
-    id: number;
-    /** Project identity (e.g. "git:<sha>"), NOT a filesystem path */
-    projectIdentity: string;
-    reason: string;
-    enqueuedAt: number;
-    startedAt: number | null;
-}
-export declare function ensureDreamQueueTable(db: Database): void;
-export declare function hasActiveDreamLease(db: Database): boolean;
-/** Enqueue a project for dreaming. Skips if the same project already has any queue entry (queued or running).
- *
- * @param force - When true (e.g. manual /ctx-dream), uses the lease TTL (2 min) as the stale threshold
- *   instead of the full 2-hour max-runtime window. This lets users re-trigger dreaming after a crash or
- *   restart even when the previous queue entry was started only seconds ago.
- */
-export declare function enqueueDream(db: Database, projectIdentity: string, reason: string, force?: boolean): DreamQueueEntry | null;
-/** Peek at the next unstarted entry without claiming it.
- *
- * @param projectIdentity - When provided, only matches entries for this project.
- *   This is critical for cross-process coexistence: each running OpenCode/Pi
- *   process registers exactly one project, so it must only drain entries that
- *   belong to it. Without this filter, Pi (running in project A) would dequeue
- *   queue entries for project B and try to dream B with Pi's runner — which
- *   either spawns `pi` in a directory that doesn't exist (the `git:<sha>`
- *   identity string) or, even if it succeeded, runs the wrong harness for that
- *   project.
- */
-export declare function peekQueue(db: Database, projectIdentity?: string): DreamQueueEntry | null;
-/** Claim the next unstarted entry atomically by marking started_at. Returns null if queue is empty.
- *
- * @param projectIdentity - When provided, only dequeues entries for this project.
- *   See `peekQueue` for the cross-process coexistence rationale.
- */
-export declare function dequeueNext(db: Database, projectIdentity?: string): DreamQueueEntry | null;
-/** Remove a completed or failed entry from the queue. */
-export declare function removeDreamEntry(db: Database, id: number): void;
-/** Reset a dequeued entry so it can be retried (e.g., after lease failure). Increments retry_count. */
-export declare function resetDreamEntry(db: Database, id: number): void;
-/** Get the retry count for a queue entry. */
-export declare function getEntryRetryCount(db: Database, id: number): number;
-/**
- * Clear stale started entries (stuck for more than maxAgeMs).
- *
- * Callers MUST gate this on `!hasActiveDreamLease(db)` — a healthy long-running
- * dream can exceed `maxAgeMs` while still renewing its lease, and deleting its
- * own row mid-run is the bug this guard prevents (mirrors the enqueue path).
- *
- * `projectIdentity` scopes the delete to one project. The shared `dream_queue`
- * is cross-process (OpenCode + Pi); a global delete would reap other hosts'
- * still-running rows. Omit only for the legacy "reap any" test path.
- */
-export declare function clearStaleEntries(db: Database, maxAgeMs: number, projectIdentity?: string): number;
-//# sourceMappingURL=queue.d.ts.map

package/dist/features/magic-context/dreamer/queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAexD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,UAAQ,GACd,eAAe,GAAG,IAAI,CAsCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA4BxF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAa1F;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACzB,MAAM,CAYR"}

package/dist/features/magic-context/dreamer/runner.d.ts

@@ -1,92 +0,0 @@
-import type { DreamingTask } from "../../../config/schema/magic-context";
-import type { PluginContext } from "../../../plugin/types";
-import { Database } from "../../../shared/sqlite";
-interface ExperimentalPinKeyFilesConfig {
-    enabled: boolean;
-    token_budget: number;
-    min_reads: number;
-}
-export declare function registerDreamProjectDirectory(projectIdentity: string, directory: string): void;
-export interface DreamRunResult {
-    startedAt: number;
-    finishedAt: number;
-    holderId: string;
-    smartNotesSurfaced: number;
-    smartNotesPending: number;
-    tasks: {
-        name: string;
-        durationMs: number;
-        result: unknown;
-        error?: string;
-    }[];
-}
-export declare function runDream(args: {
-    db: Database;
-    client: PluginContext["client"];
-    /** Project identity (e.g. "git:<sha>"), NOT a filesystem path. Used for dream state keys. */
-    projectIdentity: string;
-    tasks: DreamingTask[];
-    taskTimeoutMinutes: number;
-    maxRuntimeMinutes: number;
-    parentSessionId?: string;
-    sessionDirectory?: string;
-    experimentalUserMemories?: {
-        enabled: boolean;
-        promotionThreshold: number;
-    };
-    experimentalPinKeyFiles?: ExperimentalPinKeyFilesConfig;
-    /**
-     * Resolved fallback chain for dreamer subagent calls. When the primary
-     * `dreamer.model` fails (auth, model-not-found, rate limit, transient
-     * network), each entry is tried in order before giving up. Empty/undefined
-     * disables fallback iteration (legacy single-suggestion-retry only).
-     *
-     * Caller (`processDreamQueue` / direct caller) resolves this via
-     * `resolveFallbackChain(DREAMER_AGENT, config.dreamer.fallback_models)`.
-     */
-    fallbackModels?: readonly string[];
-}): Promise<DreamRunResult>;
-export declare function processDreamQueue(args: {
-    db: Database;
-    client: PluginContext["client"];
-    tasks: DreamingTask[];
-    taskTimeoutMinutes: number;
-    maxRuntimeMinutes: number;
-    experimentalUserMemories?: {
-        enabled: boolean;
-        promotionThreshold: number;
-    };
-    experimentalPinKeyFiles?: ExperimentalPinKeyFilesConfig;
-    /**
-     * Optional project identity filter — when provided, only entries belonging
-     * to this project are dequeued. Each running OpenCode/Pi process registers
-     * exactly one project, and the host's dreamer client (and `pi` runner, in
-     * Pi's case) is project-specific. Without this filter, a Pi process running
-     * for project A would dequeue queue entries for project B and try to
-     * `posix_spawn 'pi'` in B's `git:<sha>` identity string as a directory,
-     * failing with ENOENT every cycle.
-     *
-     * Callers should pass this whenever they own a single project — both the
-     * scheduled timer tick (`sweepProject`) and the `/ctx-dream` command
-     * handler. Tests pass `undefined` to keep the legacy "dequeue any" semantics.
-     */
-    projectIdentity?: string;
-    /**
-     * Filesystem directory of the project THIS draining process owns. Because
-     * project identity collapses worktrees/clones to one `git:<sha>`, resolving
-     * the execution directory from the shared in-memory map can pick a stale
-     * sibling checkout ("last-registered wins"). The drain caller always knows
-     * its own live directory, so passing it here guarantees the dream runs in a
-     * checkout this process actually registered. Paired with projectIdentity
-     * (the queue filter), so the dequeued entry is guaranteed to be this
-     * project's. Falls back to the map (then the identity string) when omitted.
-     */
-    sessionDirectoryOverride?: string;
-    /**
-     * Resolved Dreamer fallback chain. See `runDream` for semantics. Callers
-     * compute via `resolveFallbackChain(DREAMER_AGENT, pluginConfig.dreamer?.fallback_models)`.
-     */
-    fallbackModels?: readonly string[];
-}): Promise<DreamRunResult | null>;
-export {};
-//# sourceMappingURL=runner.d.ts.map

package/dist/features/magic-context/dreamer/runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiClD,UAAU,6BAA6B;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9F;AAMD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACP;AAqED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;IACxD;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG,OAAO,CAAC,cAAc,CAAC,CAijB1B;AA2OD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;IACxD;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAqEjC"}

package/dist/features/magic-context/dreamer/scheduler.d.ts

@@ -1,29 +0,0 @@
-import type { Database } from "../../../shared/sqlite";
-/** Parse "HH:MM-HH:MM" into start/end minutes since midnight. */
-export declare function parseScheduleWindow(schedule: string): {
-    startMinutes: number;
-    endMinutes: number;
-} | null;
-/** Check if the current time is inside the schedule window. Handles overnight windows (e.g. 23:00-05:00). */
-export declare function isInScheduleWindow(schedule: string, now?: Date): boolean;
-/** Find projects that have memory updates or pending smart notes since their per-project last dream time. */
-export declare function findProjectsNeedingDream(db: Database): string[];
-/**
- * Check schedule and enqueue eligible projects.
- * Called periodically from the hook layer (debounced to once per hour).
- * Returns the number of projects enqueued.
- *
- * @param ownProjectIdentity - When provided, restricts enqueue to this project.
- *   Each running OpenCode/Pi process registers exactly one project, so it
- *   must only enqueue work for THAT project — otherwise a process running for
- *   project A would enqueue dream entries for projects B, C, D... that this
- *   host can't actually drain (it has the wrong client + the wrong
- *   subagent-runner directory). Without the filter, a Pi process running for
- *   `opencode-anthropic-auth` ends up trying to spawn `pi --print` for
- *   `opencode-xtra` (a project Pi was never opened in), failing every cycle.
- *
- *   When undefined, the legacy "enqueue everything that needs a dream"
- *   behavior is preserved for tests and any future single-host caller.
- */
-export declare function checkScheduleAndEnqueue(db: Database, schedule: string, ownProjectIdentity?: string): number;
-//# sourceMappingURL=scheduler.d.ts.map

package/dist/features/magic-context/dreamer/scheduler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAIvD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,GACjB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBrD;AAaD,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAYpF;AAED,6GAA6G;AAC7G,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,CAwD/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC5B,MAAM,CAgCR"}

package/dist/features/magic-context/key-files/aft-availability.d.ts

@@ -1,11 +0,0 @@
-export interface AftAvailability {
-    available: boolean;
-    opencode: boolean;
-    pi: boolean;
-    checkedPaths: string[];
-}
-export declare function getAftAvailability(): AftAvailability;
-export declare function isAftAvailable(): boolean;
-/** Test-only override for deterministic key-files unit tests. */
-export declare function setAftAvailabilityOverride(value: boolean | null): void;
-//# sourceMappingURL=aft-availability.d.ts.map

package/dist/features/magic-context/key-files/aft-availability.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aft-availability.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/key-files/aft-availability.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAsED,wBAAgB,kBAAkB,IAAI,eAAe,CAkDpD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,iEAAiE;AACjE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAEtE"}