@cortexkit/opencode-magic-context 0.42.6 → 0.43.1

package/dist/tui/data/context-db.d.ts

@@ -33,13 +33,25 @@ export type CompartmentCountResult = {
 export declare function getCompartmentCount(sessionId: string, directory?: string): Promise<CompartmentCountResult>;
 /** Send recomp request to server via RPC. */
 export declare function requestRecomp(sessionId: string): Promise<boolean>;
-/** Run `/ctx-session-upgrade` for the session (full recomp + once-per-project
- *  memory migration). Fired from the upgrade dialog's "Run upgrade now" action. */
-export declare function requestUpgrade(sessionId: string): Promise<boolean>;
-/** Mark the upgrade reminder dismissed (the user made an explicit Confirm/Cancel
- *  choice), setting the durable stamp so the FRESH dialog won't re-show. Resume
- *  prompts are staging-driven and unaffected. */
-export declare function dismissUpgradeReminder(sessionId: string): Promise<boolean>;
+/** Start a manual `/ctx-dream` run (optionally one named task) via RPC. The
+ *  server starts the pass in the background and pushes the summary when done. */
+export declare function requestDream(sessionId: string, task?: string): Promise<boolean>;
+/** What a command RPC reports back: finished text, an acknowledgement that
+ *  background work started (no text yet), or the failure. */
+export type CommandRpcResult = {
+    ok: true;
+    message?: string;
+    started?: boolean;
+} | {
+    ok: false;
+    error?: string;
+};
+/** Run `/ctx-flush` for the session: apply the queued operations now. */
+export declare function requestFlush(sessionId: string): Promise<CommandRpcResult>;
+/** Start `/ctx-wrapup`: compact the older live tail, keeping the newest N raw. */
+export declare function requestWrapup(sessionId: string, messagesToKeep: number): Promise<CommandRpcResult>;
+/** `/ctx-embed`: read coverage, or start/pause the history embedding drain. */
+export declare function requestEmbed(sessionId: string, action: "status" | "start" | "pause", directory?: string): Promise<CommandRpcResult>;
 /** Resolve global toast duration from server config via RPC. */
 export declare function loadToastDurationMs(): Promise<number>;
 /**

package/dist/tui/data/context-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEzF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAK3D,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;sCACsC;AACtC,wBAAgB,YAAY,IAAI,qBAAqB,GAAG,IAAI,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAM/B;AAwFD,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,yFAAyF;AACzF,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAYD,gEAAgE;AAChE,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAchG;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,oFAAoF;AACpF,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED;mFACmF;AACnF,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxE;AAED;;iDAEiD;AACjD,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhF;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ3D;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkBrE;AAED,wEAAwE;AACxE,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQtD"}
+{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"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"}

package/dist/tui-compiled/data/context-db.d.ts

@@ -33,13 +33,25 @@ export type CompartmentCountResult = {
 export declare function getCompartmentCount(sessionId: string, directory?: string): Promise<CompartmentCountResult>;
 /** Send recomp request to server via RPC. */
 export declare function requestRecomp(sessionId: string): Promise<boolean>;
-/** Run `/ctx-session-upgrade` for the session (full recomp + once-per-project
- *  memory migration). Fired from the upgrade dialog's "Run upgrade now" action. */
-export declare function requestUpgrade(sessionId: string): Promise<boolean>;
-/** Mark the upgrade reminder dismissed (the user made an explicit Confirm/Cancel
- *  choice), setting the durable stamp so the FRESH dialog won't re-show. Resume
- *  prompts are staging-driven and unaffected. */
-export declare function dismissUpgradeReminder(sessionId: string): Promise<boolean>;
+/** Start a manual `/ctx-dream` run (optionally one named task) via RPC. The
+ *  server starts the pass in the background and pushes the summary when done. */
+export declare function requestDream(sessionId: string, task?: string): Promise<boolean>;
+/** What a command RPC reports back: finished text, an acknowledgement that
+ *  background work started (no text yet), or the failure. */
+export type CommandRpcResult = {
+    ok: true;
+    message?: string;
+    started?: boolean;
+} | {
+    ok: false;
+    error?: string;
+};
+/** Run `/ctx-flush` for the session: apply the queued operations now. */
+export declare function requestFlush(sessionId: string): Promise<CommandRpcResult>;
+/** Start `/ctx-wrapup`: compact the older live tail, keeping the newest N raw. */
+export declare function requestWrapup(sessionId: string, messagesToKeep: number): Promise<CommandRpcResult>;
+/** `/ctx-embed`: read coverage, or start/pause the history embedding drain. */
+export declare function requestEmbed(sessionId: string, action: "status" | "start" | "pause", directory?: string): Promise<CommandRpcResult>;
 /** Resolve global toast duration from server config via RPC. */
 export declare function loadToastDurationMs(): Promise<number>;
 /**

package/dist/tui-compiled/data/context-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui-compiled/data/context-db.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEzF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAK3D,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;sCACsC;AACtC,wBAAgB,YAAY,IAAI,qBAAqB,GAAG,IAAI,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAM/B;AAwFD,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,yFAAyF;AACzF,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAYD,gEAAgE;AAChE,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAchG;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,oFAAoF;AACpF,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED;mFACmF;AACnF,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxE;AAED;;iDAEiD;AACjD,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhF;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ3D;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkBrE;AAED,wEAAwE;AACxE,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQtD"}
+{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui-compiled/data/context-db.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEzF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAK3D,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;sCACsC;AACtC,wBAAgB,YAAY,IAAI,qBAAqB,GAAG,IAAI,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAM/B;AAwFD,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,yFAAyF;AACzF,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAYD,gEAAgE;AAChE,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAchG;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,oFAAoF;AACpF,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED;iFACiF;AACjF,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWrF;AAED;6DAC6D;AAC7D,MAAM,MAAM,gBAAgB,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAiBpC,yEAAyE;AACzE,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE/E;AAED,kFAAkF;AAClF,wBAAsB,aAAa,CAC/B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,+EAA+E;AAC/E,wBAAsB,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,EACpC,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ3D;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkBrE;AAED,wEAAwE;AACxE,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQtD"}

package/dist/v2/fold/host-media.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Rebuilding attachment payloads in the host's own `Media.Asset` class.
+ *
+ * From OpenCode 2.0.15 a media content part carries its bytes in a `Media.Asset` class
+ * instance, and after the context hook the host rebuilds every message with
+ * `Message.make`, whose schema checks `value instanceof Asset`. Rows restored from the
+ * store after a host checkpoint are built by Magic Context, not by the host, so their
+ * attachments need a real host instance. The plugin cannot import that class: a second
+ * copy of `@opencode/ai` has a different `Asset`, which fails the host's instanceof check.
+ *
+ * Two zero-loss ways to get one, in order:
+ * 1. The constructor of any `Media.Asset` the host itself put into a draft during this
+ *    process. `new Asset({ source: { type: "base64", data, mediaType } })` is exactly what
+ *    the host's own `Media.base64(data, mediaType)` does when it renders a stored row.
+ * 2. The host's own schema, reached from the draft message's class:
+ *    `Message.fields.content.value` (the content-part union) → the member whose `type` is
+ *    the literal "media" → `fields.media` (`Media.AssetSchema`) → `ast.encoding[0]
+ *    .transformation.decode`, whose `run(some(encoded))` returns `Success(some(asset))`.
+ *    That transformation is the host's `new Asset(encoded)`. It depends on Effect Schema
+ *    internals, so every step is checked and any mismatch counts as unavailable.
+ */
+/** Test hook: forget what earlier drafts taught this process. */
+export declare function resetHostMediaForTests(): void;
+/** Learn the host's message class and, when present, its `Media.Asset` class from a draft. */
+export declare function rememberHostMedia(messages: ReadonlyArray<unknown>): void;
+/**
+ * True when the remembered host message schema declares attachments as `Media.Asset`
+ * (OpenCode 2.0.15 and later). Earlier hosts take the plain `{ mediaType, data }` shape.
+ */
+export declare function hostUsesMediaAssets(): boolean;
+/**
+ * The host's own `Media.Asset` for a base64 payload, or the reason neither zero-loss way
+ * produced one.
+ */
+export declare function hostMediaAsset(data: string, mediaType: string): object | string;
+//# sourceMappingURL=host-media.d.ts.map

package/dist/v2/fold/host-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-media.d.ts","sourceRoot":"","sources":["../../../src/v2/fold/host-media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAkBH,iEAAiE;AACjE,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAgBxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAe7C;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAmB/E"}

package/dist/v2/fold/restore.d.ts

@@ -1,5 +1,25 @@
 import type { V2Message } from "../hooks/types";
 import type { StoreRow } from "../store-reader";
+/**
+ * How restored attachments are rendered. Hosts before OpenCode 2.0.15 take a plain
+ * `{ mediaType, data }` media part; later hosts need their own `Media.Asset` instance
+ * (see host-media.ts). When no instance can be produced the attachment is replaced by a
+ * short note, so the row's text still reaches the model and the host does not reject
+ * the whole request.
+ */
+export interface RestoreMedia {
+    /** The host's asset for a base64 payload, or why none could be built. */
+    asset(data: string, mediaType: string): object | string;
+    /** Called once per attachment replaced by the note. */
+    unavailable(detail: {
+        rowID: string;
+        name?: string;
+        mediaType: string;
+        reason: string;
+    }): void;
+}
+/** Depends only on the stored row, so a replay of the same row produces the same bytes. */
+export declare function unavailableAttachmentNote(name: string | undefined, mediaType: string): string;
 /** Render retained store rows using GA's to-llm-message representation, not the lossy
  * historian projection. Tool results stay paired, and attachments retain their payloads.
  * The store remains read-only; the host's bounded recent-context is not a preservation source.
@@ -7,5 +27,5 @@ import type { StoreRow } from "../store-reader";
 export declare function restoreRow(row: StoreRow, model: {
     providerID: string;
     id: string;
-}): V2Message[];
+}, media?: RestoreMedia): V2Message[];
 //# sourceMappingURL=restore.d.ts.map

package/dist/v2/fold/restore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/v2/fold/restore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAyEhD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,CA4HhG"}
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/v2/fold/restore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAWhD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB,yEAAyE;IACzE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,uDAAuD;IACvD,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClG;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7F;AA6ED;;;GAGG;AACH,wBAAgB,UAAU,CACtB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACzC,KAAK,CAAC,EAAE,YAAY,GACrB,SAAS,EAAE,CA+Hb"}

package/dist/v2/hidden-completion.d.ts

@@ -1,8 +1,9 @@
 import type { HiddenCompletionExecutor } from "../hooks/magic-context/compartment-runner-types";
 import type { Database } from "../shared/sqlite";
 import { type HiddenChildHook } from "./hooks/hidden-child";
+import { type HostServiceOwner } from "./host-service";
 import type { StoreRow } from "./store-reader";
-type HiddenChildRole = "historian" | "dreamer";
+type HiddenChildRole = "historian" | "dreamer" | "dreamer-curate";
 export interface HiddenChildHost {
     create(input: {
         title: string;
@@ -30,7 +31,13 @@ export interface HiddenChildHost {
             id: string;
             variant?: string;
         };
+        /** Returned only when the host exposes an error for the terminal session. */
+        error?: unknown;
     }>;
+    /** Optional event-backed error lookup for hosts that do not retain the reason on session.get. */
+    terminalError?(input: {
+        sessionID: string;
+    }): Promise<unknown>;
     switchModel(input: {
         sessionID: string;
         model: {
@@ -55,10 +62,20 @@ export interface HiddenChildHost {
         sessionID: string;
         title: string;
     }): Promise<void>;
+    /**
+     * Deletes a session and everything hanging off it, through the host that created it. Optional
+     * because the host surface this adapter is handed does not always carry it; when it is missing,
+     * a retired child keeps its entry in the retired list and the next boot sweep tries again.
+     */
+    remove?(input: {
+        sessionID: string;
+        owner?: HostServiceOwner;
+    }): Promise<void>;
 }
 export interface HiddenChildRows {
     latestSequence(sessionID: string): number;
     latestAssistant(sessionID: string): StoreRow<"assistant"> | undefined;
+    latestIdle(sessionID: string): StoreRow<"idle"> | undefined;
 }
 export interface V2HiddenCompletionOptions {
     db: Database;
@@ -69,8 +86,35 @@ export interface V2HiddenCompletionOptions {
     };
     ensureAgent?(): Promise<void>;
     generation?: string;
+    /**
+     * Gap left between two session removals. Deleting a session walks its children one at a time
+     * inside the host and publishes an event per deletion, so a backlog is drained slowly on
+     * purpose rather than fired off in parallel.
+     */
+    removalSpacingMs?: number;
+    /**
+     * Which host service registration, if any, owns the children this process creates. Called once
+     * per created child so a host that starts serving later still binds correctly.
+     */
+    resolveOwner?: () => HostServiceOwner | undefined;
+    /**
+     * The user's `keep_subagents` setting. When true, retired children that the OpenCode 1 lane
+     * would keep are left in the host instead of deleted (see `keptUnderRetention`).
+     */
+    keepSubagents?: boolean;
+    log?: (message: string) => void;
+    /** Return the host catalog when available; catalog failures leave the request unchanged. */
+    modelCatalog?: () => Promise<unknown>;
 }
 export declare function hiddenChildrenMetaKey(projectIdentity: string): string;
+/**
+ * A terminal provider or model-resolution failure persisted by the host, as opposed to an unsettled
+ * dispatch error, timeout, or abort. Only this class keeps the now-idle child alive, so reuse does
+ * not depend on wording that a later editor could accidentally change.
+ */
+export declare class HiddenProviderError extends Error {
+    constructor(detail: string);
+}
 export declare function createV2HiddenCompletionExecutor(host: HiddenChildHost, options: V2HiddenCompletionOptions): Promise<HiddenCompletionExecutor>;
 export {};
 //# sourceMappingURL=hidden-completion.d.ts.map

package/dist/v2/hidden-completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hidden-completion.d.ts","sourceRoot":"","sources":["../../src/v2/hidden-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAER,wBAAwB,EAG3B,MAAM,iDAAiD,CAAC;AAKzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAIH,KAAK,eAAe,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,KAAK,eAAe,GAAG,WAAW,GAAG,SAAS,CAAC;AAuB/C,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,KAAK,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5D,QAAQ,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAChC,QAAQ,EAAE;YAAE,aAAa,EAAE,YAAY,CAAC;YAAC,IAAI,EAAE,eAAe,CAAA;SAAE,CAAC;KACpE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5B,GAAG,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvC,KAAK,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChE,CAAC,CAAC;IACH,WAAW,CAAC,KAAK,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/D,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,MAAM,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,MAAM,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC5B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;CACzE;AAED,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,eAAe,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAErE;AAmSD,wBAAsB,gCAAgC,CAClD,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,yBAAyB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAkRnC"}
+{"version":3,"file":"hidden-completion.d.ts","sourceRoot":"","sources":["../../src/v2/hidden-completion.ts"],"names":[],"mappings":"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"}

package/dist/v2/hooks/commands.d.ts

@@ -0,0 +1,29 @@
+import type { MagicContextRpcServer } from "../../shared/rpc-server";
+import type { V2CommandDomain } from "./types";
+/**
+ * Register the `/ctx-*` commands with the OpenCode 2 host so every client can
+ * run them, not only the terminal UI.
+ *
+ * The host keeps added definitions in a location-scoped registry that
+ * `GET /api/command` lists and `POST /api/session/:sessionID/command` executes,
+ * calling this plugin's own `execute` back. A terminal UI keymap entry, by
+ * contrast, exists only inside that one UI process, so it is not reachable from
+ * `opencode run`, the HTTP API or Desktop.
+ *
+ * Each command runs the SAME in-process RPC handler the terminal UI calls over
+ * the plugin's loopback RPC, so the two entry points cannot drift into doing
+ * different work for the same command name.
+ *
+ * Result TEXT still reaches only a connected terminal UI: the host's command
+ * contract returns no payload to the caller, and OpenCode 2 has no
+ * ignored-message carrier for writing a status report into a session without
+ * making it conversation input. The work itself runs on every client. See
+ * PARITY.md.
+ */
+export declare function registerV2Commands(args: {
+    command: V2CommandDomain | undefined;
+    rpc: MagicContextRpcServer;
+    directory: string;
+    compactionEnabled: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/v2/hooks/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC,GAAG,EAAE,qBAAqB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BnB"}

package/dist/v2/hooks/context.d.ts

@@ -2,17 +2,61 @@ import { type TransformDeps } from "../../hooks/magic-context/transform";
 import type { PromptSurfaceConfig } from "../../shared/prompt-surface";
 import { type PromptSurfaceRuntime } from "../../shared/prompt-surface-runtime";
 import type { SessionContext, V2Context } from "./types";
-export declare function createHostSeams(context: V2Context, read: TransformDeps["hostRawMessages"] & {}, liveModels: NonNullable<TransformDeps["liveModelBySession"]>): Required<Pick<TransformDeps, "hostRawMessages" | "hostProtectedTailBoundary" | "hostModelFallback" | "hostRefuse">>;
+export declare function isBlockingV2TransformError(error: unknown): boolean;
+export declare function createHostSeams(context: V2Context, readAllForConversion: TransformDeps["hostRawMessages"] & {}, reconciliationSource: NonNullable<TransformDeps["hostMessageReconciliationSource"]>, liveModels: NonNullable<TransformDeps["liveModelBySession"]>): Required<Pick<TransformDeps, "hostRawMessages" | "hostMessageReconciliationSource" | "hostProtectedTailBoundary" | "hostModelFallback" | "hostRefusalNotice" | "hostRefuse">>;
+/**
+ * Record why a turn is about to be refused before the model is called.
+ *
+ * When reading the host store or the context database fails, the turn is treated
+ * as unsafe and interrupted before the provider request. The host then stores the
+ * turn as interrupted and the user simply never receives a reply — there is no
+ * error on screen and no assistant message. Without this line the reason exists
+ * only in OpenCode's own server log, so the Magic Context log that users are
+ * asked for during a support request says nothing about why their turn died
+ * (issue #493, where a store the OpenCode 2 host had migrated from OpenCode 1
+ * was refused by the v2 store reader and every turn ended in silence).
+ */
+export declare function reportPreProviderRefusal(sessionID: string, error: unknown): void;
 /** Accept both a raw model array and the 2.0.5 `{ data }` list payload. */
-export declare function catalogModels(listed: unknown): Array<{
+export declare function catalogModels(listed: unknown, draftModel?: SessionContext["model"]): Array<{
     id: string;
     providerID: string;
     limit: {
         context: number;
+        input?: number;
+        output?: number;
     };
 }>;
+export declare function removeDreamerOnlyTools(draft: SessionContext): void;
 /** Rewrite Magic Context ctx_* tool descriptions for this draft's model. */
 export declare function applyV2PromptSurfaceTools(draft: SessionContext, runtime: PromptSurfaceRuntime, config: PromptSurfaceConfig | undefined): void;
+/**
+ * Experimental Rust mode is a v1-only route: the Rust transform reaches the module over a subc
+ * transport that only the v1 server lane constructs, and nothing on this lane builds or owns one.
+ * Rather than accepting the setting and quietly running something else, downgrade it here, once,
+ * where every later reader of the config sees the mode that is actually running — including the
+ * RPC status and sidebar handlers, which otherwise ask a Rust module that does not exist for the
+ * session state and answer every status request with an error.
+ *
+ * The downgrade is announced twice on purpose: once in the log for whoever is reading it, and as a
+ * named limitation that /ctx-status and the sidebar keep showing for as long as the process runs.
+ */
+export declare function resolveV2TransformMode<T extends {
+    transform_mode?: "ts" | "rust";
+}>(config: T): T;
+/**
+ * Measure the tool definitions this request is actually going to send.
+ *
+ * OpenCode 1 measures the same thing through its `tool.definition` hook; OpenCode 2 has no such
+ * hook, but the request draft carries the whole tool set, so the draft is the measurement seam.
+ * This runs after the per-model descriptions have been applied, so what is counted is what goes on
+ * the wire, and it is keyed by the same {provider, model, agent} triple the status and sidebar
+ * handlers look the measurement up by.
+ *
+ * Measuring changes no served byte: the resulting tool-set hash is an attribution marker that the
+ * m[0] materialization decision records but never folds on.
+ */
+export declare function recordV2ToolDefinitions(draft: SessionContext): void;
 export declare function registerContext(context: V2Context): Promise<{
     dispose(): Promise<void>;
 } | undefined>;

package/dist/v2/hooks/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/context.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAK1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAGH,KAAK,oBAAoB,EAC5B,MAAM,qCAAqC,CAAC;AAa7C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,wBAAgB,eAAe,CAC3B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,EAC3C,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,GAC7D,QAAQ,CACP,IAAI,CACA,aAAa,EACb,iBAAiB,GAAG,2BAA2B,GAAG,mBAAmB,GAAG,YAAY,CACvF,CACJ,CAaA;AAyBD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B,CAAC,CAkBD;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACrC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACxC,IAAI,CASN;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,SAAS;;eAwavD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/context.ts"],"names":[],"mappings":"AAsDA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAc1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAGH,KAAK,oBAAoB,EAC5B,MAAM,qCAAqC,CAAC;AA8B7C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElE;AA4BD,wBAAgB,eAAe,CAC3B,OAAO,EAAE,SAAS,EAClB,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,EAC3D,oBAAoB,EAAE,WAAW,CAAC,aAAa,CAAC,iCAAiC,CAAC,CAAC,EACnF,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,GAC7D,QAAQ,CACP,IAAI,CACA,aAAa,EACX,iBAAiB,GACjB,iCAAiC,GACjC,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,GACnB,YAAY,CACjB,CACJ,CAsBA;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAMhF;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CACzB,MAAM,EAAE,OAAO,EACf,UAAU,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GACrC,KAAK,CAAC;IACL,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,CAAC,CAyCD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAElE;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACrC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACxC,IAAI,CAUN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAQjG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAgBnE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,SAAS;;eAs5BvD"}

package/dist/v2/hooks/deleted-session-tombstones.d.ts

@@ -0,0 +1,10 @@
+export declare class DeletedSessionTombstones {
+    #private;
+    readonly limit: number;
+    constructor(limit?: number);
+    add(sessionID: string): void;
+    has(sessionID: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=deleted-session-tombstones.d.ts.map

package/dist/v2/hooks/deleted-session-tombstones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleted-session-tombstones.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/deleted-session-tombstones.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAwB;;IAGrB,QAAQ,CAAC,KAAK;gBAAL,KAAK,SAAQ;IAMlC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAU5B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/v2/hooks/dream-manual.d.ts

@@ -0,0 +1,43 @@
+import type { DreamerConfig } from "../../config/schema/magic-context";
+import { type DreamTaskName } from "../../features/magic-context/dreamer/task-registry";
+import { type DreamTaskRuntimeConfig, type ManualRunResult } from "../../features/magic-context/dreamer/task-scheduler";
+import type { ContextDatabase } from "../../features/magic-context/storage";
+import type { HiddenCompletionExecutor } from "../../hooks/magic-context/compartment-runner-types";
+/** Validate the optional `/ctx-dream <task>` argument (mirrors the v1 command). */
+export declare function resolveManualDreamTask(raw: unknown): {
+    task?: DreamTaskName;
+    error?: string;
+};
+/**
+ * Split configured tasks into the set this host can run and tasks that need a
+ * tool loop. This keeps unsupported tasks out of failure accounting.
+ */
+export declare function selectRunnableDreamTasks(args: {
+    tasks: readonly DreamTaskRuntimeConfig[];
+    toolsSupported: boolean;
+    requestedTask?: DreamTaskName;
+}): {
+    runnable: DreamTaskRuntimeConfig[];
+    unsupported: DreamTaskName[];
+};
+export interface ManualDreamOutcome {
+    summary: ManualRunResult;
+    /** Selected tasks skipped because this host has no tool loop. */
+    unsupportedTasks: DreamTaskName[];
+}
+/** Run a manual dream pass through the shared scheduler and v2 hidden executor. */
+export declare function runManualDreamNow(args: {
+    db: ContextDatabase;
+    dreamer: DreamerConfig;
+    projectIdentity: string;
+    directory: string;
+    language?: string;
+    mural?: {
+        enabled: boolean;
+        model?: string;
+    };
+    executor: HiddenCompletionExecutor;
+    sessionId: string;
+    task?: DreamTaskName;
+}): Promise<ManualDreamOutcome>;
+//# sourceMappingURL=dream-manual.d.ts.map

package/dist/v2/hooks/dream-manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-manual.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/dream-manual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGvE,OAAO,EAGH,KAAK,aAAa,EAErB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EAEvB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAEnG,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC,GAAG;IAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IAAC,WAAW,EAAE,aAAa,EAAE,CAAA;CAAE,CAqBvE;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,iEAAiE;IACjE,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACrC;AAED,mFAAmF;AACnF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,eAAe,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,wBAAwB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4B9B"}

package/dist/v2/hooks/dream-trigger.d.ts

@@ -6,6 +6,13 @@ import type { V2Context } from "./types";
  * completion cannot recursively schedule itself through this subscription. */
 export declare function startDreamTrigger(context: V2Context, args: {
     config: DreamerConfig;
+    sample?: () => {
+        config: DreamerConfig;
+        mural?: {
+            enabled: boolean;
+            model?: string;
+        };
+    };
     executor: HiddenCompletionExecutor;
     projectIdentity: () => string;
     language?: string;

package/dist/v2/hooks/dream-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dream-trigger.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/dream-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAKvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;8EAE8E;AAC9E,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;;EA8CJ"}
+{"version":3,"file":"dream-trigger.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/dream-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAKvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;8EAE8E;AAC9E,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACvF,QAAQ,EAAE,wBAAwB,CAAC;IACnC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;;EAqDJ"}

package/dist/v2/hooks/hidden-child.d.ts

@@ -3,12 +3,18 @@ import type { PromptArgs } from "../../shared/model-suggestion-retry";
 import type { SessionContext, V2AgentDomain } from "./types";
 export declare const HIDDEN_HISTORIAN_AGENT = "historian";
 export declare const HIDDEN_DREAMER_AGENT = "dreamer-classifier";
+export declare const HIDDEN_CURATE_AGENT = "dreamer";
+export declare function hiddenAgentFor(identity: HiddenRunIdentity): string;
+export declare function hiddenToolLoop(identity: HiddenRunIdentity): boolean;
 export declare function registerHiddenChildAgents(agent: Pick<V2AgentDomain, "transform">): Promise<void>;
 export interface HiddenChildAttempt {
     childSessionId: string;
     identity: HiddenRunIdentity;
     request: PromptArgs;
     shaped: boolean;
+    steps?: number;
+    observedMessages?: SessionContext["messages"];
+    marker?: string;
 }
 /** Last user text on a context draft. 2.0.5 may use a string body, extra parts, or input_text. */
 export declare function newestUserText(draft: SessionContext): string | undefined;
@@ -21,6 +27,7 @@ export declare function newestUserText(draft: SessionContext): string | undefine
 export declare class HiddenChildHook {
     private readonly childIDs;
     private readonly attempts;
+    private readonly active;
     registerChild(sessionID: string): void;
     registerAttempt(marker: string, attempt: HiddenChildAttempt): void;
     releaseAttempt(marker: string): void;

package/dist/v2/hooks/hidden-child.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hidden-child.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/hidden-child.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,wBAAsB,yBAAyB,CAC3C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAef;AAED,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAmBxE;AAwBD;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAElE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKlE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhC,qFAAqF;IACrF,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;CAuCxC"}
+{"version":3,"file":"hidden-child.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/hidden-child.ts"],"names":[],"mappings":"AAOA,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,mBAAmB,YAAgB,CAAC;AAmBjD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAQlE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEnE;AAED,wBAAsB,yBAAyB,CAC3C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAmBxE;AAqDD;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAEhE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMlE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhC,qFAAqF;IACrF,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;CA2ExC"}

package/dist/v2/hooks/model-limit-cache.d.ts

@@ -0,0 +1,19 @@
+import type { V2Context } from "./types";
+/** True once the harness-scoped shared cache holds at least one catalog model. */
+export declare function modelLimitCacheWarm(): boolean;
+/** Test-only: clear the in-process warm latch. */
+export declare function resetModelLimitCacheWarmForTest(): void;
+/** Convert the v2 flat model catalog into the shared cache provider shape. */
+export declare function catalogProvidersPayload(listed: unknown): Array<{
+    id: string;
+    models: Record<string, Record<string, unknown>>;
+}>;
+/**
+ * Seed the shared model-limit cache from the v2 host catalog. A failed early
+ * warm releases its latch so a later context pass can retry after host startup.
+ */
+export declare function warmModelLimitCacheFromCatalog(context: V2Context, options?: {
+    retries?: number;
+    retryDelayMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=model-limit-cache.d.ts.map

package/dist/v2/hooks/model-limit-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-limit-cache.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/model-limit-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED,kDAAkD;AAClD,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD,CAAC,CAgBD;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAChD,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/v2/hooks/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,SAAS,CAAC;AAEzD,eAAO,MAAM,QAAQ,iEAAkE,CAAC;AASxF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa;;;EA8H/F"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,SAAS,CAAC;AAEzD,eAAO,MAAM,QAAQ,iEAAkE,CAAC;AAiGxF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa;;;EA+R/F"}

package/dist/v2/hooks/provider-admission.d.ts

@@ -0,0 +1,22 @@
+export interface ProviderAdmissionInput {
+    /** Input + cached-read + cached-write tokens of the newest assistant reply. */
+    inputTokens: number;
+    /** The provider's own context window for the outgoing model, when the catalog knows it. */
+    rawContextLimit: number | undefined;
+    /** True when the host wrote a compaction after the reply the tokens were read from. */
+    hostCompactionReducedUsage: boolean;
+}
+/**
+ * Whether the OpenCode 2 context hook must stop a request before it reaches the
+ * provider.
+ *
+ * The provider's own context window is the only admission boundary here. Every
+ * other kind of pressure — in particular usage that fits the window but not the
+ * room reserved for the reply — has to be admitted, because the work that
+ * relieves it (compacting history into a compartment, and the high-pressure
+ * handling around it) all happens further down this same pass. A request stopped
+ * here runs none of it, so a session refused for pressure Magic Context could
+ * have removed is refused again on every following turn.
+ */
+export declare function refusesBeforeProvider(input: ProviderAdmissionInput): boolean;
+//# sourceMappingURL=provider-admission.d.ts.map

package/dist/v2/hooks/provider-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-admission.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/provider-admission.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACnC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,uFAAuF;IACvF,0BAA0B,EAAE,OAAO,CAAC;CACvC;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAkB5E"}

package/dist/v2/hooks/rpc-live-state.d.ts

@@ -0,0 +1,9 @@
+import { type LiveSessionState } from "../../hooks/magic-context/live-session-state";
+/**
+ * The RPC surface must read and write the SAME live sets the v2 pass uses.
+ * `systemPromptRefreshSessions` is part of that: a `/ctx-flush` arriving over
+ * RPC signals it, and only the shared instance is the one the next
+ * system-prompt transform drains.
+ */
+export declare function createV2RpcLiveSessionState(overrides: Pick<LiveSessionState, "liveModelBySession" | "variantBySession" | "agentBySession" | "channel1StateBySession" | "historyRefreshSessions" | "pendingMaterializationSessions" | "systemPromptRefreshSessions">): LiveSessionState;
+//# sourceMappingURL=rpc-live-state.d.ts.map

package/dist/v2/hooks/rpc-live-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-live-state.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/rpc-live-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,IAAI,CACX,gBAAgB,EACd,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,GACxB,wBAAwB,GACxB,gCAAgC,GAChC,6BAA6B,CAClC,GACF,gBAAgB,CAElB"}