@cortexkit/opencode-magic-context 0.34.2 → 0.35.1

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -1,6 +1,7 @@
 import type { MagicContextPluginConfig } from "../../config";
 import type { LiveSessionState } from "../../hooks/magic-context/live-session-state";
 import type { RustModeModuleClient } from "../../hooks/magic-context/rust-mode-transform";
+import type { PromptSurfaceRuntime } from "../../shared/prompt-surface-runtime";
 import type { PluginContext } from "../types";
 /**
  * Map the full plugin config down to the per-session hook config. Pure and
@@ -35,6 +36,7 @@ export declare function buildMagicContextHookConfig(pluginConfig: MagicContextPl
         default: string;
         [modelKey: string]: string;
     };
+    prompt_surface: import("../../config/schema/magic-context").PromptSurfaceConfig;
     output_reserve?: number | {
         default: number;
         [modelKey: string]: number;
@@ -104,6 +106,7 @@ export declare function createSessionHooks(args: {
     pluginConfig: MagicContextPluginConfig;
     liveSessionState: LiveSessionState;
     rustModeModuleClient?: RustModeModuleClient;
+    promptSurfaceRuntime?: PromptSurfaceRuntime;
 }): {
     magicContext: ({
         "experimental.chat.messages.transform": ((_input: Record<string, never>, output: {
@@ -114,6 +117,10 @@ export declare function createSessionHooks(args: {
         };
         "experimental.chat.system.transform": (input: {
             sessionID?: string;
+            model?: {
+                providerID?: string;
+                modelID?: string;
+            };
         }, output: {
             system: string[];
         }) => Promise<void>;
@@ -151,6 +158,7 @@ export declare function createSessionHooksAsync(args: {
     pluginConfig: MagicContextPluginConfig;
     liveSessionState: LiveSessionState;
     rustModeModuleClient?: RustModeModuleClient;
+    promptSurfaceRuntime?: PromptSurfaceRuntime;
 }): Promise<{
     magicContext: ({
         "experimental.chat.messages.transform": ((_input: Record<string, never>, output: {
@@ -161,6 +169,10 @@ export declare function createSessionHooksAsync(args: {
         };
         "experimental.chat.system.transform": (input: {
             sessionID?: string;
+            model?: {
+                providerID?: string;
+                modelID?: string;
+            };
         }, output: {
             system: string[];
         }) => Promise<void>;

package/dist/plugin/hooks/create-session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,wBAAwB;;;;;;;;;mBAC5C,CAAC;aAA2B,CAAC;aACnD,CAAC;eAA6B,CAAC;;;;;;;;;;;;;;;;;;;;eAsFq9gB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAzEpghB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C;;;;;;;;;qBAkE4zI,CAAC;;;;;;;;;;;;qBAA38C,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAutwD,CAAC;;;;;;;;;EArCtr2D;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C;;;;;;;;;qBA8B4zI,CAAC;;;;;;;;;;;;qBAA38C,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAutwD,CAAC;;;;;;;;;GADtr2D"}
+{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,wBAAwB;;;;;;;;;mBACxD,CAAC;aAA2B,CAAC;aAQnD,CAPC;eAA8B,CAAA;;;;;;;;;;;;;;;;;;;;;eA0Fw4lB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA7E36lB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C;;;;;;;;;qBAqEmpJ,CAAC;iBAA2B,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;;;;;;;;qBAApoE,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAujzD,CAAC;;;;;;;;;EAvCjv4D;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C;;;;;;;;;qBA+BmpJ,CAAC;iBAA2B,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;;;;;;;;qBAApoE,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAujzD,CAAC;;;;;;;;;GADjv4D"}

package/dist/plugin/rpc-handlers.d.ts

@@ -14,6 +14,7 @@ export interface RustSessionStatus {
     compartment_count?: number;
     compartment_tokens?: number;
     pending_drop_count?: number;
+    tag_count?: number;
     pending_m1_delta?: boolean;
     pending_m1_age_ms?: number | null;
     wrapup_active?: boolean;

package/dist/plugin/rpc-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-handlers.d.ts","sourceRoot":"","sources":["../../src/plugin/rpc-handlers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAWzE,OAAO,EACH,KAAK,eAAe,IAAI,QAAQ,EAGnC,MAAM,mCAAmC,CAAC;AAkB3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAQlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAavF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAe,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUtF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE;QAAE,0BAA0B,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA2GD,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAK9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,eAAe,CAgWjB;AAED;gFACgF;AAChF,wBAAgB,+BAA+B,CAC3C,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAC9B,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,YAAY,CAuNd;AA4BD;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C,GACF,IAAI,CA2PN"}
+{"version":3,"file":"rpc-handlers.d.ts","sourceRoot":"","sources":["../../src/plugin/rpc-handlers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAWzE,OAAO,EACH,KAAK,eAAe,IAAI,QAAQ,EAGnC,MAAM,mCAAmC,CAAC;AAkB3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAQlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAavF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAe,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUtF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE;QAAE,0BAA0B,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA2GD,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAK9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,eAAe,CAgWjB;AAED;gFACgF;AAChF,wBAAgB,+BAA+B,CAC3C,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAC9B,YAAY,CAAC,EAAE,iBAAiB,EAChC,iBAAiB,UAAO,GACzB,YAAY,CAuNd;AA4BD;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C,GACF,IAAI,CA2PN"}

package/dist/plugin/tool-registry.d.ts

@@ -1,5 +1,7 @@
 import type { ToolDefinition } from "@opencode-ai/plugin";
 import type { MagicContextPluginConfig } from "../config";
+import type { PromptSurfaceConfig } from "../shared/prompt-surface";
+import type { PromptSurfaceRuntime } from "../shared/prompt-surface-runtime";
 import type { RustToolBackends } from "./rust-tool-backends";
 import type { PluginContext } from "./types";
 /**
@@ -14,5 +16,7 @@ export declare function createToolRegistry(args: {
     ctx: PluginContext;
     pluginConfig: MagicContextPluginConfig;
     rustToolBackends?: RustToolBackends;
+    promptSurfaceRuntime?: PromptSurfaceRuntime;
+    registrationPromptSurface?: PromptSurfaceConfig;
 }): Record<string, ToolDefinition>;
 //# sourceMappingURL=tool-registry.d.ts.map

package/dist/plugin/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/plugin/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAoB1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAiB7C;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,SAAS,MAAM,EAAE,CAElE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAoHjC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/plugin/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAY1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAU7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAiB7C;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,SAAS,MAAM,EAAE,CAElE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,yBAAyB,CAAC,EAAE,mBAAmB,CAAC;CACnD,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2IjC"}

package/dist/{recomp-orchestrator-6cd3nrt7.js → recomp-orchestrator-29f4rqax.js}

@@ -9,12 +9,13 @@ import {
   setRecompNote,
   setRecompStarting,
   setRecompTerminal
-} from "./index-z70pxrq1.js";
+} from "./index-fkyamz2w.js";
 import"./index-ry8rh8cv.js";
 import"./index-td9depx5.js";
-import"./index-cn960ffd.js";
-import"./index-b563sga5.js";
-import"./index-fcyvznch.js";
+import"./index-h5zjfesc.js";
+import"./index-dpdnjawy.js";
+import"./index-w0nygb4p.js";
+import"./index-0c9dmw9m.js";
 import"./index-d62ypazr.js";
 import"./index-k1esqfwk.js";
 import"./index-kvrcg31b.js";

package/dist/{send-session-notification-6njqewzk.js → send-session-notification-sr5g06hz.js}

@@ -5,8 +5,8 @@ import {
   flushIgnoredMessages,
   sendIgnoredMessage,
   sendUserPrompt
-} from "./index-cn960ffd.js";
-import"./index-fcyvznch.js";
+} from "./index-h5zjfesc.js";
+import"./index-w0nygb4p.js";
 import"./index-k1esqfwk.js";
 import"./index-kvrcg31b.js";
 import"./index-wckvcay0.js";

package/dist/shared/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./logger";
 export * from "./model-suggestion-retry";
 export * from "./normalize-sdk-response";
+export * from "./prompt-surface";
+export * from "./prompt-surface-runtime";
 export * from "./resolve-fallbacks";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/shared/prompt-surface-a1-golden.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared accessors for the A1 prompt-surface golden.
+ *
+ * The golden (`prompt-surface-a1-golden.md`, generated by
+ * `scripts/export-agent-surface.ts`) is read by tests in BOTH packages, and its
+ * section headings are the contract between the generator and those readers.
+ * Keeping the path, the heading strings, and the offset guard here means a
+ * change to the golden's section format is a one-file edit rather than a hunt
+ * across packages.
+ *
+ * This module resolves the golden relative to ITSELF, so consumers never carry
+ * their own `../..` path arithmetic — that arithmetic differs per package and is
+ * exactly the kind of thing that rots silently when files move.
+ */
+export declare const A1_TOOL_SECTION_HEADING = "## 2. Tool surface";
+export declare const A1_HASH_BASELINE_HEADING = "## 3. System-prompt hash baseline";
+export declare function readA1GoldenDocument(): string;
+/**
+ * Locate a golden section heading, refusing to continue when it is absent.
+ *
+ * A bare `indexOf` returns -1 for a missing heading, and `slice(start, -1)`
+ * silently yields an empty (or truncated) section rather than failing: the
+ * golden then parses as ZERO tools and the consuming test passes by comparing
+ * empty to empty. Failing loudly here keeps a malformed golden from reading as a
+ * clean run.
+ */
+export declare function a1GoldenSectionOffset(document: string, heading: string): number;
+//# sourceMappingURL=prompt-surface-a1-golden.d.ts.map

package/dist/shared/prompt-surface-a1-golden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-a1-golden.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-a1-golden.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM/E"}

package/dist/shared/prompt-surface-runtime.d.ts

@@ -0,0 +1,43 @@
+import { type ConfigHarness } from "../config/migrate-config-location";
+import { type PromptSurfaceConfig, type PromptSurfacePreset } from "./prompt-surface";
+export declare const PROMPT_SURFACE_TOOL_IDS: readonly ["ctx_reduce", "ctx_expand", "ctx_note", "ctx_memory", "ctx_search"];
+export type PromptSurfaceToolId = (typeof PROMPT_SURFACE_TOOL_IDS)[number];
+export declare const LIGHT_TOOL_DESCRIPTIONS: Readonly<Record<PromptSurfaceToolId, string>>;
+/**
+ * Preserve the existing full-preset hash exactly while giving other presets a
+ * distinct semantic cache identity, including during any future asset fallback.
+ */
+export declare function promptSurfaceHashMaterial(systemContent: string, preset?: PromptSurfacePreset): string;
+export interface PromptSurfaceGuidanceSelection {
+    /** The configured built-in preset. */
+    preset: PromptSurfacePreset;
+    /** Complete user-authored primary section captured when a model-key epoch starts. */
+    primaryOverride?: string;
+}
+export interface PromptSurfaceRegistrationSelection {
+    preset: PromptSurfacePreset;
+    descriptionFor: (toolId: string, fullDescription: string) => string;
+}
+export interface PromptSurfaceRuntime {
+    resolveRegistration: (config: PromptSurfaceConfig | undefined) => PromptSurfaceRegistrationSelection;
+    resolveGuidance: (config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+}
+export interface CreatePromptSurfaceRuntimeOptions {
+    harness?: ConfigHarness;
+    directory?: string;
+    /** Explicit test/integration seam; production derives the USER config directory. */
+    userConfigDirectory?: string;
+    warn: (message: string) => void;
+}
+/**
+ * Create one host-registration runtime. Its warning set is shared by tool
+ * registration and every guidance epoch, so invalid overrides are reported once
+ * instead of on every model call.
+ */
+export declare function createPromptSurfaceRuntime(options: CreatePromptSurfaceRuntimeOptions): PromptSurfaceRuntime;
+/** Freeze preset selection and materialized override bytes for one model-key epoch. */
+export declare function createPromptSurfaceGuidanceEpochCache(runtime: PromptSurfaceRuntime): {
+    resolve: (sessionId: string, config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+    clear: (sessionId: string) => void;
+};
+//# sourceMappingURL=prompt-surface-runtime.d.ts.map

package/dist/shared/prompt-surface-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-runtime.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,aAAa,EAGrB,MAAM,mCAAmC,CAAC;AAS3C,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAE3B,MAAM,kBAAkB,CAAC;AAK1B,eAAO,MAAM,uBAAuB,+EAM1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAMjF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,mBAA4B,GACrC,MAAM,CAIR;AAID,MAAM,WAAW,8BAA8B;IAC3C,sCAAsC;IACtC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IAC/C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACjC,mBAAmB,EAAE,CACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,KACtC,kCAAkC,CAAC;IACxC,eAAe,EAAE,CACb,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;CACvC;AAED,MAAM,WAAW,iCAAiC;IAC9C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAwBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,iCAAiC,GAC3C,oBAAoB,CAkGtB;AAQD,uFAAuF;AACvF,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,oBAAoB,GAAG;IAClF,OAAO,EAAE,CACL,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;IACpC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,CAkBA"}

package/dist/shared/prompt-surface.d.ts

@@ -0,0 +1,49 @@
+/** The built-in prompt-surface variants. */
+export type PromptSurfacePreset = "full" | "light";
+/**
+ * The configuration consumed by prompt-surface resolution. The schema adds
+ * validation and defaults; this structural type keeps the resolver usable by
+ * every host without importing a config loader.
+ */
+export interface PromptSurfaceConfig {
+    default?: PromptSurfacePreset;
+    models?: Readonly<Record<string, PromptSurfacePreset>>;
+    guidance_override_path?: string;
+    tool_descriptions?: Readonly<Record<string, string>>;
+}
+export type PromptSurfaceResolutionSource = "exact" | "wildcard" | "default";
+/** Validate the literal provider/model and provider/* key grammar. */
+export declare function isValidPromptSurfaceModelKey(key: string): boolean;
+export type ModelKeyLookupSource = PromptSurfaceResolutionSource | "bare";
+export interface ModelKeyCandidate {
+    key: string;
+    source: ModelKeyLookupSource;
+}
+/**
+ * Return the same progressive model-key candidates used by cache_ttl. The
+ * provider/model boundary is the first slash; the rest of the string remains
+ * the model ID, including additional slashes. Candidates are case-sensitive.
+ *
+ * Provider wildcards are checked after progressively less-specific model keys,
+ * but before the caller's default. That keeps an exact or base-model override
+ * authoritative while still allowing `provider/*` to cover otherwise-unlisted
+ * models.
+ */
+export declare function modelKeyLookupOrder(modelKey: string | undefined): ModelKeyCandidate[];
+/** Resolve one per-model value using the shared cache_ttl lookup walk. */
+export declare function resolveModelConfigValue<T>(values: Readonly<Record<string, T>> | undefined, modelKey: string | undefined): {
+    value: T;
+    source: ModelKeyLookupSource;
+} | undefined;
+/**
+ * Resolve the prompt preset for a model. Invalid or missing model keys use the
+ * configured default and are reported as a default resolution rather than a
+ * partial match.
+ */
+export declare function resolvePromptSurface(config: PromptSurfaceConfig | undefined, modelKey: string | undefined): {
+    preset: PromptSurfacePreset;
+    source: PromptSurfaceResolutionSource;
+};
+/** Resolve a cache_ttl-style value with the shared model-key walk. */
+export declare function resolveModelConfigOrDefault<T>(values: Readonly<Record<string, T>>, modelKey: string | undefined, fallback: T): T;
+//# sourceMappingURL=prompt-surface.d.ts.map

package/dist/shared/prompt-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,sEAAsE;AACtE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAwBjE;AAED,MAAM,MAAM,oBAAoB,GAAG,6BAA6B,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CA2BrF;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,CAAC,EACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,SAAS,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,CAaxE;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,CAAC,EACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,CAAC,GACZ,CAAC,CAEH"}

package/dist/shared/sqlite.d.ts

@@ -39,6 +39,18 @@
  * `run()` → {changes,lastInsertRowid}) is identical and was verified directly.
  */
 import type BetterSqlite3 from "better-sqlite3";
+export type SqliteRuntime = "Bun" | "Node.js";
+type SqliteModule = {
+    Database?: unknown;
+    DatabaseSync?: unknown;
+};
+export declare function detectSqliteRuntime(): SqliteRuntime;
+export declare class SqliteRuntimeUnavailableError extends Error {
+    readonly runtime: SqliteRuntime;
+    readonly specifier: string;
+    constructor(runtime: SqliteRuntime, specifier: string, cause: unknown);
+}
+export declare function loadSqliteModule(runtime?: SqliteRuntime, importer?: (specifier: string) => Promise<SqliteModule>): Promise<SqliteModule>;
 export declare const Database: typeof BetterSqlite3;
 /** Instance type alias used by helpers and storage modules. */
 export type Database = BetterSqlite3.Database;
@@ -65,4 +77,5 @@ export type Statement = BetterSqlite3.Statement<unknown[], unknown>;
  * flag, so an inner scope releasing does not drop permission out from under its caller.
  */
 export declare function withPrivilegedWriter<T>(db: Database, operation: () => T): T;
+export {};
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/shared/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/shared/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAMH,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AA4IhD,eAAO,MAAM,QAAQ,EAAE,OAAO,aAA4B,CAAC;AAE3D,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AASpE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAwC3E"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/shared/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAMH,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,CAAC;AAE9C,KAAK,YAAY,GAAG;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,aAAa,CAWnD;AAgDD,qBAAa,6BAA8B,SAAQ,KAAK;IACpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAaxE;AAED,wBAAsB,gBAAgB,CAClC,OAAO,GAAE,aAAqC,EAC9C,QAAQ,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAsB,GAC5E,OAAO,CAAC,YAAY,CAAC,CAUvB;AAoHD,eAAO,MAAM,QAAQ,EAAE,OAAO,aAA4B,CAAC;AAE3D,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AASpE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAwC3E"}

package/dist/{storage-meta-session-xt41zbw4.js → storage-meta-session-ev8b55a9.js}

@@ -5,8 +5,8 @@ import {
   markSessionCleanupPending,
   retryPendingSessionCleanups,
   updateSessionMeta
-} from "./index-b563sga5.js";
-import"./index-fcyvznch.js";
+} from "./index-dpdnjawy.js";
+import"./index-w0nygb4p.js";
 import"./index-k1esqfwk.js";
 import"./index-kvrcg31b.js";
 import"./index-wckvcay0.js";

package/dist/tools/ctx-expand/tools.d.ts

@@ -1,5 +1,6 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import type { ContextDatabase } from "../../features/magic-context/storage";
+export { CTX_EXPAND_LIGHT_DESCRIPTION } from "../light-descriptions";
 export interface CtxExpandToolDeps {
     db: ContextDatabase;
 }

package/dist/tools/ctx-expand/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAO5E,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,eAAe,CAAC;CACvB;AA4HD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAO5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,eAAe,CAAC;CACvB;AA4HD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-memory/tools.d.ts

@@ -1,4 +1,5 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import { type CtxMemoryToolDeps } from "./types";
+export { CTX_MEMORY_LIGHT_DESCRIPTION } from "../light-descriptions";
 export declare function createCtxMemoryTools(deps: CtxMemoryToolDeps): Record<string, ToolDefinition>;
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools/ctx-memory/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAkDhE,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AAu3BjB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAkDhE,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAs3BrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-note/tools.d.ts

@@ -1,6 +1,7 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import type { RustToolBackends } from "../../plugin/rust-tool-backends";
 import type { Database } from "../../shared/sqlite";
+export { CTX_NOTE_LIGHT_DESCRIPTION } from "../light-descriptions";
 export interface CtxNoteToolDeps {
     db: Database;
     dreamerEnabled?: boolean;

package/dist/tools/ctx-note/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAahE,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAK7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAuaD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAahE,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAK7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAuaD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

package/dist/tools/ctx-reduce/tools.d.ts

@@ -1,6 +1,7 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import type { RustToolBackends } from "../../plugin/rust-tool-backends";
 import type { Database } from "../../shared/sqlite";
+export { CTX_REDUCE_LIGHT_DESCRIPTION } from "../light-descriptions";
 export interface CtxReduceToolDeps {
     db: Database;
     protectedTags: number;

package/dist/tools/ctx-reduce/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAShE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAkMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAShE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAkMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-search/tools.d.ts

@@ -1,4 +1,5 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import type { CtxSearchToolDeps } from "./types";
+export { CTX_SEARCH_LIGHT_DESCRIPTION } from "../light-descriptions";
 export declare function createCtxSearchTools(deps: CtxSearchToolDeps): Record<string, ToolDefinition>;
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools/ctx-search/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAmBhE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAqRjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAmBhE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAqRrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/light-descriptions.d.ts

@@ -0,0 +1,6 @@
+export declare const CTX_REDUCE_LIGHT_DESCRIPTION = "For ctx_reduce users, mark spent \u00A7N\u00A7 outputs discardable; release is QUEUED, not immediate, so content stays visible until space is needed. Newest tags stay protected until they age out. Released content becomes a placeholder; recover it only by rerunning the source or recovery tool, so mark only genuinely finished material. Mark analyzed, redundant, persisted, or merely confirmatory outputs; keep user messages, unresolved errors, unextracted evidence, and exact wording. NEVER blanket-mark a large range: review every tag first.";
+export declare const CTX_EXPAND_LIGHT_DESCRIPTION = "For ctx_expand users, recover compacted conversation by passing a session-history heading's inclusive start/end ordinals. Results are raw [N] U:/A: transcript capped near 15K tokens; oversized ranges return the head and a continuation. Use verbose=true to list each message ordinal, part previews, and tool-output sizes; use message=N for one complete stored message and its tool exchanges. NEVER expand ranges after the last compartment because that live tail is already visible.";
+export declare const CTX_NOTE_LIGHT_DESCRIPTION = "For ctx_note users, write saves, read lists, update changes, and dismiss retires future session notes; surface_condition creates a smart note. For smart notes, NEVER use a condition tied to this conversation or an unobservable future action because the background checker can inspect only external GitHub, disk, git, or web signals.";
+export declare const CTX_MEMORY_LIGHT_DESCRIPTION = "For ctx_memory users, write one standalone durable fact with category and content; update one ID, archive one or more IDs, merge two or more IDs, or get one to twenty numeric IDs. get reads memories in every status; list remains dreamer-only, so primary agents must NEVER assume bulk-list access.";
+export declare const CTX_SEARCH_LIGHT_DESCRIPTION = "For ctx_search users, retrieve only hidden recall: memories not already in <project-memory>, compacted messages outside the live tail, commits, and notes. Omit sources for broad search; select memory, message, git_commit, or note to target a source, or pass memory IDs to bypass text search. Message hits continue through ctx_expand.";
+//# sourceMappingURL=light-descriptions.d.ts.map

package/dist/tools/light-descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/light-descriptions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,oiBAA0hB,CAAC;AAEpkB,eAAO,MAAM,4BAA4B,qeAAqe,CAAC;AAE/gB,eAAO,MAAM,0BAA0B,iVAAiV,CAAC;AAEzX,eAAO,MAAM,4BAA4B,6SAA6S,CAAC;AAEvV,eAAO,MAAM,4BAA4B,kVAAkV,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.34.2",
+  "version": "0.35.1",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",

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

@@ -54,8 +54,18 @@ function clampHiddenAgentStepLimit(value: unknown, cap: number): number {
  * byte-identical to the canonical exported constants so they can't silently
  * diverge.
  */
+export const HIDDEN_AGENT_DESCRIPTION_MARKER = "Internal Magic Context";
+const HIDDEN_AGENT_DESCRIPTION =
+    "Internal Magic Context maintenance agent. Not for general tasks — do not select for user work.";
+
 export interface HiddenAgentRegistration {
     id: string;
+    /** OpenCode's task registry excludes primary agents from general subagent routing. */
+    mode: "primary";
+    /** Hidden agents stay out of the UI picker while remaining directly resolvable. */
+    hidden: true;
+    /** Description used by OpenCode's automatic name/description-based task router; keep it generic so this hidden agent is not selected for unrelated tasks. */
+    description: string;
     prompt: string | undefined;
     allowedTools: readonly string[];
     maxSteps: number;
@@ -90,6 +100,9 @@ export function buildHiddenAgentRegistrations(args: {
     return [
         {
             id: "dreamer",
+            mode: "primary",
+            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
@@ -111,6 +124,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-docs",
+            mode: "primary",
+            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
@@ -136,6 +152,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-reviewer",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
             // review-user-memories: a pure JSON reviewer of behavioral observations.
             // It calls NO tools — the host applies its verdict — so zero tools,
@@ -147,6 +166,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-retrospective",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
             allowedTools: ["ctx_search"],
             maxSteps: 40,
@@ -158,6 +180,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-primer-investigator",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
             // Read-only code investigation: read/navigate/search the CURRENT
             // source to answer a primer. Deliberately NO write/edit/bash (could
@@ -184,6 +209,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-memory-mapper",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
             // Read-only local-source reader for map-memories / verify: open and
             // check the CURRENT source. NO write/edit/bash (could corrupt user
@@ -203,6 +231,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "dreamer-classifier",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.dreamerPrompt,
             // ZERO tools: classify scores importance/scope/shareable from the
             // memory text alone (no code inspection), emits ONE XML manifest, and
@@ -215,6 +246,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "smart-note-compiler",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.smartNoteCompilerPrompt,
             allowedTools: [],
             maxSteps: 8,
@@ -225,6 +259,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "historian",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.historianPrompt,
             allowedTools: historianAllowedTools,
             maxSteps: 40,
@@ -232,6 +269,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "historian-recomp",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.historianRecompPrompt ?? args.historianPrompt,
             allowedTools: historianAllowedTools,
             maxSteps: 40,
@@ -239,6 +279,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "historian-editor",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.historianEditorPrompt,
             allowedTools: historianAllowedTools,
             maxSteps: 40,
@@ -246,6 +289,9 @@ export function buildHiddenAgentRegistrations(args: {
         },
         {
             id: "sidekick",
+            mode: "primary",
+            hidden: true,
+            description: HIDDEN_AGENT_DESCRIPTION,
             prompt: args.sidekickPrompt,
             allowedTools: ["ctx_search", "aft_outline", "aft_zoom"],
             maxSteps: 40,
@@ -266,6 +312,7 @@ export function buildHiddenAgentConfig(
     overrides?: Record<string, unknown>,
     agentLabel?: string,
     lockPermissions = false,
+    description?: string,
 ) {
     const {
         permission: overridePermission,
@@ -325,7 +372,8 @@ export function buildHiddenAgentConfig(
             ...basePermission,
             ...(lockPermissions ? {} : (overridePermission ?? {})),
         },
-        mode: "subagent" as const,
+        mode: "primary" as const,
         hidden: true,
+        ...(description !== undefined ? { description } : {}),
     };
 }