@cortexkit/opencode-magic-context 0.42.4 → 0.42.6

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

@@ -1,15 +1,19 @@
-/** 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 interface MessageData {
     [key: string]: unknown;
     content?: Array<Record<string, unknown>>;
     text?: string;
+    finish?: string;
+    error?: unknown;
+    model?: {
+        id: string;
+        providerID: string;
+        variant?: string;
+    };
     tokens?: {
         input: number;
         output: number;
@@ -56,6 +60,8 @@ export declare class V2StoreReader {
     };
     latestCompaction(sessionID: string): StoreRow<"compaction"> | undefined;
     idleRows(sessionID: string, after?: number): StoreRow<"idle">[];
+    latestSequence(sessionID: string): number;
+    latestAssistant(sessionID: string): StoreRow<"assistant"> | 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. */

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/index.d.ts

@@ -0,0 +1,10 @@
+import type { V2TuiContext } from "./types";
+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":"AAeA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAoE5D,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,CAkL9F;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAEtE;;;;;AAED,wBAAuD"}

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

@@ -0,0 +1,80 @@
+import type { SidebarSnapshot } from "../../shared/rpc-types";
+export interface V2TuiLocation {
+    readonly directory: string;
+}
+export interface V2TuiRoute {
+    readonly type: string;
+    readonly sessionID?: string;
+}
+export interface V2TuiContext {
+    readonly location?: V2TuiLocation;
+    readonly renderer: {
+        requestRender(): void;
+    };
+    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: {
+            readonly append: "sidebar.content";
+            readonly render: (input: {
+                readonly sessionID: string;
+            }) => unknown;
+        }) => () => void;
+        readonly toast: {
+            show(options: {
+                readonly title?: string;
+                readonly message: string;
+                readonly variant?: "info" | "success" | "warning" | "error";
+                readonly duration?: number;
+            }): void;
+        };
+        readonly dialog: {
+            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>;
+        };
+    };
+}
+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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE;QAAE,aAAa,IAAI,IAAI,CAAA;KAAE,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QAChF,QAAQ,CAAC,QAAQ,EAAE;YAAE,OAAO,IAAI,aAAa,CAAA;SAAE,CAAC;KACnD,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,KAAK,EAAE,CACZ,KAAK,EAAE,MAAM;YACT,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;gBACvB,QAAQ,CAAC,KAAK,EAAE;oBAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;oBAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;iBAAE,CAAC;gBACrE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;aAC1D,CAAC,CAAC;SACN,KACA,IAAI,CAAC;KACb,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,MAAM,EAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;SAAE,KACnC,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC;KACrE,CAAC;IACF,QAAQ,CAAC,EAAE,EAAE;QACT,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,UAAU,CAAA;SAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;YACnB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;YACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;gBAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;aAAE,KAAK,OAAO,CAAC;SACvE,KAAK,MAAM,IAAI,CAAC;QACjB,QAAQ,CAAC,KAAK,EAAE;YACZ,IAAI,CAAC,OAAO,EAAE;gBACV,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;gBAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;aAC9B,GAAG,IAAI,CAAC;SACZ,CAAC;QACF,QAAQ,CAAC,MAAM,EAAE;YACb,KAAK,CAAC,OAAO,EAAE;gBAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACpF,OAAO,CAAC,OAAO,EAAE;gBACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,KAAK,CAAC,EAAE;oBAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;oBAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC5E,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;SACpC,CAAC;KACL,CAAC;CACL;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;CAC1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.42.4",
+  "version": "0.42.6",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
@@ -27,6 +27,7 @@
     "index.js",
     "src/tui",
     "src/tui-compiled",
+    "src/v2/tui",
     "src/shared",
     "src/config",
     "src/agents",
@@ -71,9 +72,9 @@
     "sharp": "^0.35.0"
   },
   "devDependencies": {
-    "@opencode/plugin": "2.0.3",
-    "@opencode/cli": "2.0.3",
-    "@opencode/client": "2.0.3",
+    "@opencode/plugin": "2.0.5",
+    "@opencode/cli": "2.0.5",
+    "@opencode/client": "2.0.5",
     "effect": "4.0.0-rc.112",
     "@ai-sdk/anthropic": "3.0.82",
     "@huggingface/transformers": "^4.1.0",

package/src/agents/magic-context-prompt.ts

@@ -74,7 +74,7 @@ function memoryGuidanceBlock(memoryEnabled: boolean): string {
 const BASE_INTRO = (
     memoryEnabled: boolean,
 ): string => `Messages and tool outputs are tagged with §N§ identifiers (e.g., §1§, §42§).
-Use \`ctx_reduce\` to mark spent tagged content as discardable and reclaim space. Marking is NOT an immediate delete — it queues the content, which stays fully visible until space is actually needed (as soon as the next turn if you're already under pressure, much later if not), so mark a tool output as soon as you're done with it rather than hoarding the call for the end of the turn. The newest token-mass window stays protected until displaced. Syntax: "3-5", "1,2,9", or "1-5,8,12-15".
+Use \`ctx_reduce\` to mark spent tagged content as discardable and reclaim space. Marking QUEUES content for release. It stays fully visible to you until it is actually released, which may be the next turn or many turns later. Mark a tool output as soon as you're done with it rather than hoarding the call for the end of the turn. The newest token-mass window stays protected until displaced. Syntax: "3-5", "1,2,9", or "1-5,8,12-15".
 Do not announce or narrate \`ctx_reduce\` drops — just call the tool silently. Saying "I'll drop these outputs" wastes tokens the user does not care about.
 ${CTX_NOTE_GUIDANCE}
 ${memoryGuidanceBlock(memoryEnabled)}Use \`ctx_search\` to search across project memories, indexed git commits, and this session's full conversation history (including compacted parts) from one query.

package/src/config/index.ts

@@ -33,7 +33,11 @@ import {
 import { pruneNestedConfigLeaf } from "./prune-config-leaf";
 import { loadRawConfigFile } from "./raw-loader";
 import { stripRemovedAgentConfig } from "./removed-agent-config";
-import { type MagicContextConfig, MagicContextConfigSchema } from "./schema/magic-context";
+import {
+    type MagicContextConfig,
+    MagicContextConfigSchema,
+    PROTECTED_TOKENS_MIN,
+} from "./schema/magic-context";
 import { resolveTransformMode } from "./transform-mode";
 import { substituteConfigVariables } from "./variable";
 
@@ -323,6 +327,18 @@ function redactConfigValue(value: unknown): string {
 
 let warnedProtectedTagsDeprecation = false;
 
+/**
+ * Specific warning for a protected_tokens value that is a number below the
+ * schema minimum. The generic "invalid value (number 20), using default
+ * undefined" message is true but unhelpful: it does not say the value is in the
+ * wrong unit (a leftover protected_tags tag count), and "using default
+ * undefined" reads like a bug. This branch fires ONLY for `number < min`;
+ * every other invalid value (wrong type, above max) keeps the generic message.
+ */
+export function formatProtectedTokensBelowMinWarning(value: number): string {
+    return `protected_tokens is a token floor (minimum ${PROTECTED_TOKENS_MIN}, default derived from the context window); ${value} looks like the old protected_tags count. Remove the key to use the default, or set a token count such as 16000.`;
+}
+
 export function resetProtectedTagsDeprecationWarningForTest(): void {
     warnedProtectedTagsDeprecation = false;
 }
@@ -483,6 +499,20 @@ export function parsePluginConfig(
         delete patched[key];
         const defaultVal = (defaults as unknown as Record<string, unknown>)[key];
         const reason = customMessagesByKey.get(key);
+        // A numeric protected_tokens below the schema minimum is almost always a
+        // leftover protected_tags tag count (10–30) renamed by hand. Replace the
+        // generic invalid-leaf message with one that names the unit mismatch.
+        // Scoped precisely to `number < min` so wrong-type and above-max values
+        // still get the generic message.
+        const invalidRawValue = rawConfig[key];
+        if (
+            key === "protected_tokens" &&
+            typeof invalidRawValue === "number" &&
+            invalidRawValue < PROTECTED_TOKENS_MIN
+        ) {
+            warnings.push(formatProtectedTokensBelowMinWarning(invalidRawValue));
+            continue;
+        }
         warnings.push(
             `"${key}": invalid value (${redactConfigValue(rawConfig[key])}), using default ${JSON.stringify(defaultVal)}.${reason ? ` ${reason}` : ""}`,
         );

package/src/config/protected-tokens.test.ts

@@ -188,6 +188,46 @@ describe("protected_tokens config and derivation", () => {
         });
     });
 
+    describe("protected_tokens below-minimum warning", () => {
+        it("emits the specific token-floor warning for a numeric value below the schema minimum", () => {
+            const recovered = parsePluginConfig({ protected_tokens: 20 });
+            const warnings = recovered.configWarnings ?? [];
+            expect(warnings.some((w) => w.includes("protected_tokens is a token floor"))).toBe(
+                true,
+            );
+            expect(warnings.some((w) => w.includes('"protected_tokens": invalid value'))).toBe(
+                false,
+            );
+        });
+
+        it("keeps the generic type message for a string value", () => {
+            const recovered = parsePluginConfig({ protected_tokens: "20" });
+            const warnings = recovered.configWarnings ?? [];
+            expect(warnings.some((w) => w.includes('"protected_tokens": invalid value'))).toBe(
+                true,
+            );
+            expect(warnings.some((w) => w.includes("protected_tokens is a token floor"))).toBe(
+                false,
+            );
+        });
+
+        it("keeps the generic above-max message for a value above the maximum", () => {
+            const recovered = parsePluginConfig({ protected_tokens: 2_000_000 });
+            const warnings = recovered.configWarnings ?? [];
+            expect(warnings.some((w) => w.includes('"protected_tokens": invalid value'))).toBe(
+                true,
+            );
+            expect(warnings.some((w) => w.includes("protected_tokens is a token floor"))).toBe(
+                false,
+            );
+        });
+
+        it("emits no warning when the key is absent", () => {
+            const recovered = parsePluginConfig({});
+            expect(recovered.configWarnings ?? []).toEqual([]);
+        });
+    });
+
     describe("protected_tags deprecation", () => {
         it("is parsed at any value (including 0 and 101) with parse succeeding and no numeric conversion", () => {
             resetProtectedTagsDeprecationWarningForTest();

package/src/config/schema/magic-context.ts

@@ -18,6 +18,11 @@ export const EXECUTE_THRESHOLD_CAP_MESSAGE =
 export const DEFAULT_HISTORIAN_TIMEOUT_MS = 600_000;
 export const DEFAULT_HISTORY_BUDGET_PERCENTAGE = 0.15;
 
+// Minimum absolute token floor for protected_tokens. Kept as a named constant so
+// the schema's `.min()` and the loader's below-minimum warning share ONE source
+// of truth — the loader must not duplicate the literal 4000.
+export const PROTECTED_TOKENS_MIN = 4000;
+
 export const DEFAULT_LOCAL_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
 
 // Re-exported from the (DB-free) task registry so the schema and the runtime
@@ -1107,10 +1112,10 @@ export const MagicContextConfigSchema = z
             .union([z.string(), z.object({ default: z.string() }).catchall(z.string())])
             .default("5m")
             .describe(
-                'How long Magic Context assumes the provider\'s cached prefix stays valid. This is MC\'s own deferral gate — it does not change the provider\'s actual cache lifetime. String (e.g. "5m", "1h", "30s") or per-model object ({ default: "5m", "model-id": "10m" }). Set to "never" to mean MC never assumes expiry (for lanes kept warm externally by a cache-keep tool) — disables the idle-TTL heuristic so MC never initiates a rebuild based on elapsed time. Provider-side extended TTL is a separate request-level concern (cache_control: { ttl } in the request body).',
+                'How long Magic Context assumes the provider\'s cached prefix stays valid. This is MC\'s own deferral gate — it does not change the provider\'s actual cache lifetime. String (e.g. "5m", "1h", "30s") or per-model object ({ default: "5m", "provider/model": "1h", "provider/*": "never" }); keys resolve most-specific first (exact provider/model, bare model ID, shorter dash-prefixes, then the provider/* wildcard, then default). Set to "never" to mean MC never assumes expiry (for lanes kept warm externally by a cache-keep tool) — disables the idle-TTL heuristic so MC never initiates a rebuild based on elapsed time. Provider-side extended TTL is a separate request-level concern (cache_control: { ttl } in the request body).',
             ),
         prompt_surface: PromptSurfaceConfigSchema.default({ default: "full" }).describe(
-            "Prompt-surface presets: default is full; models use bare model IDs, provider/model, or provider/* routing keys. Guidance and tool-description overrides are user-level only. On OpenCode and Pi, per-model routing applies to the guidance block only: tool descriptions are registered once per process, so they follow the default preset (a v1 plugin-surface limitation; per-model tool descriptions are planned for the OpenCode v2 plugin API once the SDK stabilizes).",
+            "Prompt-surface presets: default is full; models use bare model IDs, provider/model, or provider/* routing keys. Guidance and tool-description overrides are user-level only. OpenCode 1.x, Pi, and OMP register tool descriptions once per process (they follow the default preset). OpenCode 2 rewrites the five ctx_* descriptions per request from the draft model.",
         ),
         output_reserve: z
             .union([
@@ -1160,7 +1165,7 @@ export const MagicContextConfigSchema = z
         protected_tokens: z
             .number()
             .int()
-            .min(4000)
+            .min(PROTECTED_TOKENS_MIN)
             .max(1_000_000)
             .optional()
             .describe(

package/src/features/magic-context/dreamer/task-registry.ts

@@ -8,6 +8,8 @@
  * concurrently while memory-mutating tasks serialize. See lease.ts + the A+B spec.
  */
 
+import type { CurateMemoryCategory } from "./curate-category-rotation";
+
 export const CANONICAL_DREAM_TASKS = [
     // map-memories runs BEFORE verify (it records the file mappings verify gates
     // on) and shares the memory lease, so it leads the canonical order.
@@ -52,6 +54,8 @@ export interface DreamTaskBacklog {
     pending: number;
     /** Total items in the task's candidate pool. */
     total: number;
+    /** Curate's one-category scope for this run/window. */
+    category?: CurateMemoryCategory;
 }
 
 /** Backlog counts keyed by canonical task name. */
@@ -66,6 +70,9 @@ export function formatDreamTaskBacklogs(
         .filter((task) => backlogs[task] !== undefined)
         .map((task) => {
             const backlog = backlogs[task];
+            if (task === "curate" && backlog?.category) {
+                return `- curate: ${backlog.category} (${backlog.pending})`;
+            }
             return `- ${task}: ${backlog?.pending ?? 0} pending / ${backlog?.total ?? 0} total`;
         })
         .join("\n");
@@ -77,6 +84,8 @@ export interface DreamTaskProgress {
     processed: number;
     total: number;
     startedAt: number;
+    /** Curate's one-category scope. */
+    category?: CurateMemoryCategory;
     /** Update/archive verdicts refused by host-side verification safety gates during the current run. */
     refused?: number;
 }
@@ -88,6 +97,7 @@ export interface DreamTaskRunBacklog {
     pendingAtEnd: number;
     totalAtEnd: number;
     processed: number;
+    category?: CurateMemoryCategory;
 }
 
 /** Use the decrease in the persisted backlog between the start and end snapshots as the per-run progress count, clamped to zero when the backlog does not decrease. */

package/src/shared/auto-update-provenance.ts

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync } from "node:fs";
+
+export const AUTO_UPDATE_CHECK_STATE_FILENAME = "last-update-check.json";
+
+export interface AutoUpdateCheckState {
+    lastCheckedMs?: number;
+    updaterPinnedSpec?: string;
+    updaterPinnedAt?: number;
+}
+
+export function readAutoUpdateCheckState(path: string): AutoUpdateCheckState | null {
+    if (!existsSync(path)) return null;
+    try {
+        const value = JSON.parse(readFileSync(path, "utf-8")) as unknown;
+        if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+        const raw = value as Record<string, unknown>;
+        const state: AutoUpdateCheckState = {};
+        if (typeof raw.lastCheckedMs === "number" && Number.isFinite(raw.lastCheckedMs)) {
+            state.lastCheckedMs = raw.lastCheckedMs;
+        }
+        if (typeof raw.updaterPinnedSpec === "string" && raw.updaterPinnedSpec.length > 0) {
+            state.updaterPinnedSpec = raw.updaterPinnedSpec;
+        }
+        if (typeof raw.updaterPinnedAt === "number" && Number.isFinite(raw.updaterPinnedAt)) {
+            state.updaterPinnedAt = raw.updaterPinnedAt;
+        }
+        return state;
+    } catch {
+        return null;
+    }
+}
+
+export function isUpdaterPinnedSpec(
+    state: AutoUpdateCheckState | null,
+    configuredSpec: string,
+): boolean {
+    return (
+        state?.updaterPinnedSpec === configuredSpec &&
+        typeof state.updaterPinnedAt === "number" &&
+        Number.isFinite(state.updaterPinnedAt)
+    );
+}

package/src/shared/conflict-detector.test.ts

@@ -480,6 +480,59 @@ describe("detectConflicts", () => {
         });
     });
 
+    describe("OpenCode 2 compaction ownership", () => {
+        it("keeps MC enabled when host auto-compaction is on and never reads v1 prune", () => {
+            const previous = process.env.OPENCODE_DISABLE_AUTOCOMPACT;
+            delete process.env.OPENCODE_DISABLE_AUTOCOMPACT;
+            const resolved = {
+                auto: true,
+                get prune(): boolean {
+                    throw new Error("v2 must not read compaction.prune");
+                },
+                keepTokens: 4_096,
+                buffer: 1_024,
+            };
+            const result = detectConflicts(projectDir, {
+                compactionEnabled: true,
+                hostGeneration: "v2",
+                resolvedCompaction: resolved,
+            });
+            expect(result.hasConflict).toBe(false);
+            expect(result.conflicts.compactionAuto).toBe(false);
+            expect(result.conflicts.compactionPrune).toBe(false);
+            expect(result.nativeCompaction).toEqual({ auto: true, prune: false });
+            if (previous === undefined) delete process.env.OPENCODE_DISABLE_AUTOCOMPACT;
+            else process.env.OPENCODE_DISABLE_AUTOCOMPACT = previous;
+        });
+
+        it("reads the GA v2 auto, keep.tokens, and buffer shape", async () => {
+            const result = await resolveCompactionForBoot(
+                {
+                    config: {
+                        get: async () => ({
+                            data: {
+                                compaction: {
+                                    auto: true,
+                                    keep: { tokens: 4_096 },
+                                    buffer: 1_024,
+                                    prune: true,
+                                },
+                            },
+                        }),
+                    },
+                },
+                2_000,
+                "v2",
+            );
+            expect(result).toEqual({
+                auto: true,
+                prune: false,
+                keepTokens: 4_096,
+                buffer: 1_024,
+            });
+        });
+    });
+
     // --- Resolved-config arm (issue #309) ---
     // The plugin boot now consumes the host's RESOLVED config
     // (ctx.client.config.get()) instead of re-deriving compaction from files.