@cortexkit/opencode-magic-context 0.42.5 → 0.43.0

package/dist/v2/store-reader.d.ts

@@ -1,15 +1,22 @@
-/** Source rule: oc-audit-7a31b5c0f7.md:186-202; sanitization follows owner R16.
- * The real GA CLI 2.0.3 placement probe confirms OPENCODE_DB is honoured.
- * Isolation must still use private XDG roots, not rely solely on the filename.
- */
+/** Compatibility export; shared/opencode-db-path.ts is the single filename authority. */
 export declare function sourceDatabaseFilename(channel: string, env?: NodeJS.ProcessEnv): string;
-/** GA data root: aft-playbook-fe8d4871f.md:46-48, with the CLI filename rule. */
+/** GA data root resolved by the shared host-generation-aware resolver. */
 export declare function gaDatabasePath(dataHome: string, channel?: string, env?: NodeJS.ProcessEnv): string;
 export type MessageType = "agent-switched" | "model-switched" | "location-switched" | "user" | "synthetic" | "system" | "skill" | "shell" | "assistant" | "compaction" | "idle";
+export declare const RAW_MESSAGE_TYPES: readonly ["user", "synthetic", "assistant", "skill", "shell", "system"];
+export declare const V2_MESSAGE_PAGE_SQL: string;
 export interface MessageData {
     [key: string]: unknown;
     content?: Array<Record<string, unknown>>;
     text?: string;
+    finish?: string;
+    outcome?: "succeeded" | "failed" | "interrupted";
+    error?: unknown;
+    model?: {
+        id: string;
+        providerID: string;
+        variant?: string;
+    };
     tokens?: {
         input: number;
         output: number;
@@ -38,27 +45,92 @@ export interface StoreRow<T extends MessageType = MessageType> {
     session_id: string;
     type: T;
     seq: number;
+    time_created?: number;
     data: T extends "idle" ? IdleData : T extends "compaction" ? CompactionData : MessageData;
 }
+export declare const V2_STORE_READER_DEBUG_COUNTER_KEY = "magic-context.v2.store-reader-debug";
+export interface V2StoreReaderDebugOperation {
+    calls: number;
+    decodedRows: number;
+    maxDecodedRows: number;
+}
+export interface V2StoreReaderDebugQuery {
+    operation: string;
+    statement: string;
+    rows: number;
+    elapsedMs: number;
+}
+export interface V2StoreReaderDebugCounters {
+    decodedRows: number;
+    operations: Record<string, V2StoreReaderDebugOperation>;
+    openReaders: number;
+    maxOpenReaders: number;
+    readersOpened: number;
+    readersClosed: number;
+    queries?: V2StoreReaderDebugQuery[];
+    captureQueries?: boolean;
+}
+export interface V2MessageOrdinalAnchor {
+    timeCreated: number;
+    id: string;
+}
+export interface V2MessageOrdinalEntry extends V2MessageOrdinalAnchor {
+    contributesOrdinal: boolean;
+    hasValidInfo: boolean;
+}
+export declare function getV2StoreReaderDebugCounters(): V2StoreReaderDebugCounters;
+export declare function resetV2StoreReaderDebugCounters(options?: {
+    captureQueries?: boolean;
+}): void;
 /** Opens an existing store read-only; missing/corrupt stores propagate errors, never an empty history. */
 export declare class V2StoreReader {
     private readonly db;
+    private closed;
     constructor(path: string);
     close(): void;
     /** Exclusive cursor, ascending seq. IDs are not chronological in the v2 store. */
     page(sessionID: string, options?: {
         after?: number;
+        through?: number;
         limit?: number;
         type?: MessageType;
     }): {
         rows: StoreRow[];
         cursor: number | undefined;
     };
+    /**
+     * Read one page from the contiguous raw-message ordinal space. OpenCode seq
+     * includes non-conversation rows, so the CTE maps the two ordinal boundaries
+     * to seq values without hydrating any row outside the requested page.
+     */
+    messagePage(sessionID: string, afterOrdinal: number, limit: number, finalWatermark: number): StoreRow[];
+    messageCount(sessionID: string): number;
+    storedMessageCount(sessionID: string): number;
+    messageById(sessionID: string, id: string): StoreRow | null;
+    messageExistsById(sessionID: string, id: string): boolean;
+    messageOrdinalById(sessionID: string, id: string): number | null;
+    messageIdOrdinals(sessionID: string, fromOrdinal: number, toOrdinal: number): Map<string, number>;
+    messageOrdinalPage(sessionID: string, after: V2MessageOrdinalAnchor | null, limit: number): V2MessageOrdinalEntry[];
+    range(sessionID: string, after: number, through: number): StoreRow[];
+    /** Conversational rows at or before `throughSeq`, newest first. */
+    rawRowsThrough(sessionID: string, throughSeq: number, limit: number): StoreRow[];
+    sequenceForId(sessionID: string, id: string | null | undefined): number | undefined;
+    latestSequenceForIds(sessionID: string, ids: readonly string[]): number;
+    private compactionByStatus;
     latestCompaction(sessionID: string): StoreRow<"compaction"> | undefined;
+    latestRunningCompaction(sessionID: string): StoreRow<"compaction"> | undefined;
     idleRows(sessionID: string, after?: number): StoreRow<"idle">[];
+    earliestSequence(sessionID: string): number | undefined;
+    latestSequence(sessionID: string): number;
+    latestAssistant(sessionID: string): StoreRow<"assistant"> | undefined;
+    latestIdle(sessionID: string): StoreRow<"idle"> | undefined;
     /** Include the completed checkpoint itself, matching the host history cut. */
     window(sessionID: string): StoreRow[];
-    /** Full retained source is needed to restore unarchived rows hidden by a host cut. */
+    /**
+     * Read every retained row only for conversions between store generations and
+     * explicit diagnostics, because those operations need every part payload.
+     * Context passes use messagePage, messageCount, and range instead.
+     */
     history(sessionID: string): StoreRow[];
     private all;
 }

package/dist/v2/store-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-reader.d.ts","sourceRoot":"","sources":["../../src/v2/store-reader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CASR;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAW,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CAGR;AAGD,MAAM,MAAM,WAAW,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AACb,MAAM,WAAW,WAAW;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AACD,MAAM,WAAW,QAAS,SAAQ,WAAW;IACzC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;CACnD;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,CAAC,SAAS,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;CAC7F;AAmBD,0GAA0G;AAC1G,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAClB,IAAI,EAAE,MAAM;IAGxB,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,IAAI,CACA,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAO,GACrE;QAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAoBnD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS;IAQvE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE;IAG3D,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMrC,sFAAsF;IACtF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAGtC,OAAO,CAAC,GAAG;CASd"}
+{"version":3,"file":"store-reader.d.ts","sourceRoot":"","sources":["../../src/v2/store-reader.ts"],"names":[],"mappings":"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"}

package/dist/v2/tui/events.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenCode 2 events carry their session id in several different shapes
+ * depending on the event family (`sessionID`/`sessionId`/`id`, sometimes nested
+ * under `data` or `info`), so one extractor serves every v2 TUI listener.
+ */
+export declare function eventSessionID(event: unknown): string | undefined;
+//# sourceMappingURL=events.d.ts.map

package/dist/v2/tui/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAiBjE"}

package/dist/v2/tui/index.d.ts

@@ -0,0 +1,33 @@
+import type { SidebarSnapshot, StatusDetail } from "../../shared/rpc-types";
+import type { V2TuiContext } from "./types";
+/**
+ * Plain-text projection of the sidebar snapshot, used only when the real v1
+ * component cannot be loaded because the host registers no OpenTUI runtime
+ * modules (`opentui:runtime-module:*`). That arm is reachable on a host that
+ * boots the TUI without OpenTUI's runtime-plugin support installed — for
+ * example a future or cut-down OpenCode 2 TUI, or any embedding of this setup
+ * outside the packaged host. GA 2.0.5 and 2.0.11 both register the modules, so
+ * on those hosts the v1 component is what paints.
+ *
+ * Exported for test access; mirrors the v1 sidebar's compaction-off rows.
+ */
+export declare function sidebarText(snapshot: SidebarSnapshot | undefined): string;
+/**
+ * Plain-text projection of the status snapshot, used only when the real v1
+ * dialog component cannot be mounted — a host that publishes no component
+ * dialog surface, or one that registers no OpenTUI runtime modules
+ * (`opentui:runtime-module:*`). GA 2.0.5 and 2.0.11 do both, so on those hosts
+ * the v1 dialog is what paints.
+ *
+ * Exported for test access.
+ */
+export declare function statusText(detail: StatusDetail): string;
+type JsxFactory = (type: string, props: Record<string, unknown>) => unknown;
+export declare function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Promise<() => void>;
+export declare function setup(context: V2TuiContext): Promise<() => void>;
+declare const _default: {
+    id: string;
+    setup: typeof setup;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/v2/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAuB5E,OAAO,KAAK,EAAiC,YAAY,EAAE,MAAM,SAAS,CAAC;AAY3E;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAyBzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA6BvD;AAOD,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAE5E,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CA4Y9F;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAEtE;;;;;AAED,wBAAuD"}

package/dist/v2/tui/sidebar-mount.d.ts

@@ -0,0 +1,40 @@
+import { type V1Theme } from "./load-compiled-sidebar.mjs";
+import type { V2ResolvedTheme, V2TuiContext } from "./types";
+export interface V1SidebarMount {
+    /** Renders the v1 component for one paint of the v2 `sidebar.content` slot. */
+    render(input: {
+        readonly sessionID: string;
+    }): unknown;
+    /** Asks the mounted component to fetch a snapshot now, out of band. */
+    refresh(): void;
+    dispose(): void;
+}
+/**
+ * Colour tokens moved between host generations: OpenCode 1 handed the sidebar a
+ * flat table (`theme.accent`, `theme.textMuted`, …) while OpenCode 2 resolves a
+ * token tree (`@opencode/theme/tui` `ResolvedThemeTokens`: `text.base`,
+ * `text.muted`, `text.feedback.error.base`, `hue.accent[500]`, …). This maps
+ * the eight tokens the sidebar reads. A token the host does not resolve falls
+ * back to a colour chosen for the host's theme mode: an earlier fallback of
+ * white text painted the section headers white-on-white on light themes when
+ * the mapping read key names the theme package never had.
+ *
+ * The accent is read at hue step 200, the step the host draws its own accent
+ * UI in. The ramp is ordered by distance from the page, not by lightness, so
+ * step 200 stays a readable accent in both modes (captured GA host: #9d7cd8 on
+ * #0a0a0a dark, #d68c27 on #ffffff light) where step 500 resolved to a dark
+ * purple on the dark page and a pale orange on the light one.
+ */
+export declare function flattenTheme(theme: V2ResolvedTheme | undefined, mode?: "dark" | "light"): V1Theme;
+/**
+ * True when the import failed because the host does not register the OpenTUI
+ * runtime modules. That is the only failure this module is allowed to answer
+ * with the plain-text fallback; anything else is a real defect and rethrows.
+ */
+export declare function isMissingOpenTuiRuntime(error: unknown): boolean;
+/**
+ * Loads and mounts the v1 sidebar, or returns `null` when the host provides no
+ * OpenTUI runtime registry to load it through.
+ */
+export declare function mountV1Sidebar(context: V2TuiContext, directory: string): Promise<V1SidebarMount | null>;
+//# sourceMappingURL=sidebar-mount.d.ts.map

package/dist/v2/tui/sidebar-mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-mount.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/sidebar-mount.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKH,KAAK,OAAO,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC3B,+EAA+E;IAC/E,MAAM,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IACvD,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,IAAI,GAAE,MAAM,GAAG,OAAgB,GAChC,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM/D;AA2BD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA+ChC"}

package/dist/v2/tui/status-dialog-mount.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mounts the OpenCode 1 `/ctx-status` dialog component on the OpenCode 2 dialog
+ * surface, so both host generations show the same status view instead of one
+ * host getting a plain-text summary of it.
+ *
+ * It is the same arrangement as `sidebar-mount.ts`, for the same reasons: the
+ * component is loaded from `src/tui-compiled/` (Solid transform already applied,
+ * runtime imports pointing at the host's `opentui:runtime-module:*` registry) so
+ * it binds the host's single Solid/OpenTUI runtime rather than a second copy out
+ * of this package.
+ *
+ * Unlike the sidebar, this component fetches nothing: the caller passes the
+ * status snapshot it already loaded over RPC, so no second data layer is
+ * initialised here.
+ */
+import type { StatusDetail } from "../../shared/rpc-types";
+import type { V2TuiContext } from "./types";
+export interface V1StatusDialogMount {
+    /** Replaces the host's dialog surface with the status view for one snapshot. */
+    show(detail: StatusDetail): void;
+}
+/**
+ * Loads and mounts the v1 status dialog, or returns `null` when this host
+ * cannot render it: either it publishes no component dialog surface, or it
+ * registers no OpenTUI runtime modules to load the component through. Both
+ * cases are answered by the caller's plain-text dialog.
+ */
+export declare function mountV1StatusDialog(context: V2TuiContext): Promise<V1StatusDialogMount | null>;
+//# sourceMappingURL=status-dialog-mount.d.ts.map

package/dist/v2/tui/status-dialog-mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-dialog-mount.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/status-dialog-mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAChC,gFAAgF;IAChF,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuCrC"}

package/dist/v2/tui/types.d.ts

@@ -0,0 +1,148 @@
+import type { SidebarSnapshot } from "../../shared/rpc-types";
+export interface V2TuiLocation {
+    readonly directory: string;
+}
+export interface V2TuiRoute {
+    readonly type: string;
+    readonly sessionID?: string;
+}
+/**
+ * One resolved colour from the OpenCode 2 theme. `@opentui/core`'s RGBA keeps
+ * its channels as 0..1 floats; only those four fields are read here, so the
+ * shape is declared structurally instead of depending on the optional
+ * `@opencode/theme` peer package (it is not installed in this workspace).
+ */
+export interface V2ThemeColor {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    readonly a: number;
+}
+/**
+ * The part of `@opencode/theme/tui`'s `ResolvedTheme` the sidebar reads. Every
+ * level is optional because the plugin must still paint on a host whose theme
+ * resolves a different token set than the pinned 2.0.5 one.
+ */
+/**
+ * The part of `@opencode/theme/tui`'s `ResolvedThemeTokens` the sidebar and the
+ * status dialog read, with the key names from the published 2.0.11 declaration
+ * (`dist/tui/types.d.ts`): `text.base` / `text.muted`, `text.feedback.<kind>.base`
+ * for `error` / `warning` / `success` / `info`, `hue.<name>[step]` with steps
+ * 100..900 and the `accent` alias, `background.base`, `border.base`. Every level
+ * is optional because the plugin must still paint on a host whose theme resolves
+ * a different token set.
+ */
+export interface V2ResolvedTheme {
+    readonly hue?: Readonly<Record<string, Readonly<Record<string, V2ThemeColor>>>>;
+    readonly text?: {
+        readonly base?: V2ThemeColor;
+        readonly muted?: V2ThemeColor;
+        readonly feedback?: Readonly<Record<string, {
+            readonly base?: V2ThemeColor;
+        }>>;
+    };
+    readonly background?: {
+        readonly base?: V2ThemeColor;
+    };
+    readonly border?: {
+        readonly base?: V2ThemeColor;
+    };
+}
+export interface V2TuiContext {
+    readonly location?: V2TuiLocation;
+    readonly renderer: {
+        requestRender(): void;
+    };
+    /** `Context.theme` on GA 2.0.5/2.0.11; absent on hosts that publish no theme. */
+    readonly theme?: V2ResolvedTheme;
+    /** `Context.themeMode` on GA 2.0.5/2.0.11; picks readable fallbacks when a token is missing. */
+    readonly themeMode?: "dark" | "light";
+    readonly data: {
+        readonly listen: (handler: (event: {
+            details: unknown;
+        }) => void) => () => void;
+        readonly location: {
+            default(): V2TuiLocation;
+        };
+    };
+    readonly keymap: {
+        readonly layer: (input: () => {
+            readonly mode?: string;
+            readonly commands: ReadonlyArray<{
+                readonly id: string;
+                readonly title: string;
+                readonly group: string;
+                readonly palette: true;
+                readonly slash: {
+                    readonly name: string;
+                    readonly arguments?: true;
+                };
+                readonly run: (input?: string) => void | Promise<void>;
+            }>;
+        }) => void;
+    };
+    readonly storage: {
+        readonly memory: <Value extends object>(key: string, options: {
+            readonly initial: Value;
+        }) => readonly [Value, (mutation: (draft: Value) => void) => void];
+    };
+    readonly ui: {
+        readonly router: {
+            current(): V2TuiRoute;
+        };
+        readonly slot: (claim: V2SlotClaim) => () => void;
+        readonly toast: {
+            show(options: {
+                readonly title?: string;
+                readonly message: string;
+                readonly variant?: "info" | "success" | "warning" | "error";
+                readonly duration?: number;
+            }): void;
+        };
+        readonly dialog: {
+            /**
+             * Renders a plugin-owned component as the dialog surface. GA 2.0.5
+             * and 2.0.11 publish it next to alert/confirm/prompt; it is optional
+             * here so a host without it still gets the text dialog.
+             */
+            show?(component: () => unknown, onClose?: () => void): void;
+            /** Sizes the dialog surface before `show`; "medium" is the host default. */
+            set?(options: {
+                readonly size?: string;
+                readonly centered?: boolean;
+            }): void;
+            alert(options: {
+                readonly title: string;
+                readonly message: string;
+            }): Promise<void>;
+            confirm(options: {
+                readonly title: string;
+                readonly message: string;
+                readonly label?: {
+                    readonly confirm?: string;
+                    readonly cancel?: string;
+                };
+            }): Promise<boolean | undefined>;
+        };
+    };
+}
+/**
+ * A slot claim's `render` runs inside the host's component tree; `app` is the
+ * always-mounted root slot, which is where `keymap.layer()` can be called from
+ * when plugin `setup()` runs outside the keymap provider (see index.ts).
+ */
+export type V2SlotClaim = {
+    readonly append: "sidebar.content";
+    readonly render: (input: {
+        readonly sessionID: string;
+    }) => unknown;
+} | {
+    readonly append: "app";
+    readonly render: (input: Readonly<Record<string, never>>) => unknown;
+};
+/** The layer object `context.keymap.layer()` accepts, derived from the context type. */
+export type V2KeymapLayer = ReturnType<Parameters<V2TuiContext["keymap"]["layer"]>[0]>;
+export interface V2SidebarState {
+    snapshots: Record<string, SidebarSnapshot | undefined>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/v2/tui/types.d.ts.map

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

package/dist/wrapup-orchestrator-5akc87gr.js

@@ -0,0 +1,16 @@
+import {
+  runManagedWrapup2
+} from "./index-w2ety11c.js";
+import"./index-d0dh7v0f.js";
+import"./index-sd3egckz.js";
+import"./index-8w1skpnm.js";
+import"./index-rvwvdq59.js";
+import"./index-ygwdyntq.js";
+import"./index-y5145x8k.js";
+import"./index-ykg9sdzz.js";
+import"./index-9skq8m9y.js";
+import"./index-jdxxq8cz.js";
+import"./index-qp20p2py.js";
+export {
+  runManagedWrapup2 as runManagedWrapup
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.42.5",
+  "version": "0.43.0",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
@@ -25,8 +25,10 @@
   "files": [
     "dist",
     "index.js",
+    "tui.js",
     "src/tui",
     "src/tui-compiled",
+    "src/v2/tui",
     "src/shared",
     "src/config",
     "src/agents",
@@ -41,7 +43,7 @@
     "check:tui-compiled": "bun run build:tui && git diff --exit-code -- src/tui-compiled && test -z \"$(git status --porcelain -- src/tui-compiled)\"",
     "check:transformers-node-wasm": "bun scripts/verify-transformers-node-wasm.ts",
     "typecheck": "tsc -p ../retina-local-fs/tsconfig.build.json && tsc --noEmit && tsc -p tsconfig.scripts.json",
-    "test": "bun ../../scripts/check-bun.mjs && bun install --frozen-lockfile && bun test --parallel --timeout 30000",
+    "test": "bun ../../scripts/check-bun.mjs && bun install --frozen-lockfile && bun test --parallel=4 --timeout 30000",
     "test:serial": "bun install --frozen-lockfile && bun test --timeout 30000",
     "test:parallel:probe": "bun scripts/verify-parallel-db-isolation.ts",
     "lint": "bun ../../scripts/check-bun.mjs && biome check .",
@@ -67,16 +69,16 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "onnxruntime-node": "1.24.3",
+    "onnxruntime-node": "1.30.0",
     "sharp": "^0.35.0"
   },
   "devDependencies": {
-    "@opencode/plugin": "2.0.3",
-    "@opencode/cli": "2.0.3",
-    "@opencode/client": "2.0.3",
+    "@opencode/plugin": "2.0.15",
+    "@opencode/cli": "2.0.15",
+    "@opencode/client": "2.0.15",
     "effect": "4.0.0-rc.112",
     "@ai-sdk/anthropic": "3.0.82",
-    "@huggingface/transformers": "^4.1.0",
+    "@huggingface/transformers": "^4.3.0",
     "@ai-sdk/openai-compatible": "2.0.41",
     "@biomejs/biome": "^2.5.1",
     "@types/better-sqlite3": "^7.6.13",

package/src/agents/dreamer.ts

@@ -33,22 +33,14 @@ export const DREAMER_MEMORY_MAPPER_ALLOWED_TOOLS = [
 // needs no tools at all. Locked so a user override can't grant any.
 export const DREAMER_CLASSIFIER_AGENT = "dreamer-classifier";
 
-// Docs maintainer for the maintain-docs task: explores the codebase and writes
-// ARCHITECTURE.md / STRUCTURE.md. Needs file read + write/edit + bash (git log,
-// find) + aft navigation, but deliberately NO ctx_memory/ctx_search/ctx_note —
-// it touches docs, never the memory store. Locked so a user override can't add
-// the memory surface back.
+// Docs proposal investigator: read-only source tools; the host validates its final text.
 export const DREAMER_DOCS_AGENT = "dreamer-docs";
 
-/** Codebase-read + doc-write tool profile for the docs maintainer. No memory
- *  tools (it edits docs, not the memory store). */
+/** Read-only source investigation for docs proposals. */
 export const DREAMER_DOCS_ALLOWED_TOOLS = [
     "read",
     "grep",
     "glob",
-    "bash",
-    "write",
-    "edit",
     "aft_outline",
     "aft_zoom",
     "aft_search",
@@ -60,9 +52,8 @@ export const DREAMER_DOCS_ALLOWED_TOOLS = [
 export const DREAMER_REVIEWER_AGENT = "dreamer-reviewer";
 
 /** Tool profile for the base `dreamer` agent, now CURATE-ONLY (memory-pool
- *  hygiene). Curate edits the memory store through ctx_memory and never reads
- *  code (a separate verify task owns memory-vs-code correctness), so it needs
- *  only ctx_memory — not the former bash/write/edit/read/aft/ctx_search/ctx_note
- *  kitchen sink. Kept on the `dreamer` id so the ctx_memory dreamer-action gate
- *  (toolContext.agent === DREAMER_AGENT) still recognizes it. */
-export const DREAMER_CURATE_ALLOWED_TOOLS = ["ctx_memory"] as const;
+ *  hygiene). Curate edits memories through ctx_memory and enumerates them through
+ *  the dreamer-only ctx_memory_list; it never reads code because a separate verify
+ *  task owns memory-vs-code correctness. Kept on the `dreamer` id so memory-tool
+ *  agent gates recognize it. */
+export const DREAMER_CURATE_ALLOWED_TOOLS = ["ctx_memory", "ctx_memory_list"] as const;

package/src/agents/hidden-agent-registrations.ts

@@ -102,15 +102,15 @@ export function buildHiddenAgentRegistrations(args: {
             hidden: true,
             description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
-            // CURATE-ONLY now. Curate edits the memory store via ctx_memory and
-            // never reads code (a separate verify task owns memory-vs-code
-            // correctness), so it needs only ctx_memory — not the former
-            // bash/write/edit/read/aft/ctx_search/ctx_note surface. maintain-docs
+            // CURATE-ONLY now. Curate edits through ctx_memory and enumerates through
+            // ctx_memory_list; it never reads code because a separate verify task
+            // owns memory-vs-code correctness. No former bash/write/edit/read/aft/
+            // ctx_search/ctx_note surface remains. maintain-docs
             // and review-user-memories moved to their own scoped agents below.
             // (Inline literal — kept byte-identical to DREAMER_CURATE_ALLOWED_TOOLS
             // by agent-registration-drift.test.ts; see the module header for why
             // these are not const imports.)
-            allowedTools: ["ctx_memory"],
+            allowedTools: ["ctx_memory", "ctx_memory_list"],
             // Curate is a genuine multi-step whole-pool hygiene loop, so it keeps a
             // high cap.
             maxSteps: 150,
@@ -126,23 +126,11 @@ export function buildHiddenAgentRegistrations(args: {
             hidden: true,
             description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
-            // maintain-docs: explore code + write/edit ARCHITECTURE.md/STRUCTURE.md
-            // + bash (git log, find). NO ctx_memory/ctx_search/ctx_note — it edits
-            // docs, never the memory store. (Inline literal — kept byte-identical to
-            // DREAMER_DOCS_ALLOWED_TOOLS by agent-registration-drift.test.ts.)
-            allowedTools: [
-                "read",
-                "grep",
-                "glob",
-                "bash",
-                "write",
-                "edit",
-                "aft_outline",
-                "aft_zoom",
-                "aft_search",
-            ],
-            // Docs maintenance reads the tree and writes two files — a bounded loop,
-            // not the whole-pool 150.
+            // Documentation proposals may inspect source files but cannot mutate them.
+            // Keep this list synchronized with DREAMER_DOCS_ALLOWED_TOOLS and locked against overrides.
+            allowedTools: ["read", "grep", "glob", "aft_outline", "aft_zoom", "aft_search"],
+            // Documentation investigation reads the repository tree in a bounded loop,
+            // unlike whole-memory-pool tasks with a 150-step limit.
             maxSteps: 60,
             overrides: args.dreamerOverrides,
             // Lock so a user override can't add the memory surface back.