@wolfx/opencode-magic-context 0.21.8-patch.1

package/dist/features/magic-context/tool-owner-backfill.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Tool-owner backfill (plan v3.3.1, Layer B).
+ *
+ * Migration v10 added `tool_owner_message_id` to the tags table. The
+ * runtime carries every new tool tag with a non-NULL owner, but the
+ * 185k+ existing rows in user DBs need their owner column populated to
+ * make the v10 fix fully effective. The backfill pass iterates each
+ * session that has tool tags with NULL owner, queries the OpenCode DB
+ * for the temporally-earliest assistant message that invoked each
+ * callID, and writes the owner via a NULL-guarded UPDATE so the
+ * runtime can lazily adopt rows the backfill couldn't see (e.g. Pi
+ * sessions, deleted OC sessions, transient OC-DB-unavailable cases).
+ *
+ * Concurrency model:
+ *   - Per-session advisory lease via `tool_owner_backfill_state`.
+ *   - 5-minute lease, renewed every 60s during chunked execution.
+ *   - Sibling instances skip sessions whose lease is held and active.
+ *   - Process-death cleanup falls out for free: better-sqlite3 + WAL
+ *     drops all locks at process exit, and the `lease_expires_at`
+ *     column is the only durable state. A crashed process's session
+ *     becomes claimable as soon as the lease wall-clock expires.
+ *   - NULL-guarded UPDATE: backfill never clobbers a row already
+ *     adopted at runtime.
+ *
+ * Skip vs fail semantics:
+ *   - When OpenCode DB is missing (e.g. Pi-only install), every
+ *     session gets marked 'skipped' in the state table. Lazy adoption
+ *     handles the orphans at runtime.
+ *   - When OpenCode DB exists but a specific session is missing or
+ *     yields zero matches, that session is marked 'skipped' too.
+ *     Same lazy-adoption fallback covers it.
+ *   - A session error during backfill (SQLITE_BUSY, malformed JSON,
+ *     anything) is logged and the session is left in 'pending'/
+ *     'running' for a retry on next plugin start. Backfill never
+ *     fail-closes the plugin — it's defense-in-depth on top of
+ *     Layer C lazy adoption.
+ *
+ * Idempotency:
+ *   - The NULL guard makes UPDATE idempotent: re-running against an
+ *     already-backfilled row matches zero rows and moves on.
+ *   - The state table makes session bookkeeping idempotent: a
+ *     completed session is never re-processed.
+ */
+import type { Database } from "../../shared/sqlite";
+interface BackfillStateRow {
+    session_id: string;
+    status: string;
+    started_at: number | null;
+    lease_expires_at: number | null;
+    completed_at: number | null;
+    last_error: string | null;
+}
+interface BackfillResult {
+    sessionsProcessed: number;
+    sessionsSkippedNoOcDb: number;
+    sessionsSkippedNoMatches: number;
+    sessionsCompleted: number;
+    sessionsBlockedByLease: number;
+    sessionsErrored: number;
+    rowsUpdated: number;
+    rowsLeftNull: number;
+    durationMs: number;
+}
+/**
+ * Top-level entry point. Called from `openDatabase()` after
+ * `runMigrations()` returns. Synchronous; runs to completion before
+ * returning so the first transform pass on a fresh upgrade sees a
+ * mostly-backfilled DB.
+ *
+ * Worst-case runtime on the user's playground DB (3,276 sessions,
+ * 185,716 tool tags): ~25 seconds. Well under the 60-second budget.
+ */
+export declare function runToolOwnerBackfill(db: Database): BackfillResult;
+/**
+ * Returns true when at least one tool tag exists with NULL owner that
+ * isn't already marked completed/skipped in the state table.
+ *
+ * Treating "no NULL-owner tags" as "no work" lets us short-circuit on
+ * fresh DBs (every row is born with a non-NULL owner) and on already-
+ * backfilled DBs (re-running is a no-op).
+ */
+export declare function isToolOwnerBackfillNeeded(db: Database): boolean;
+/**
+ * Test-only: read the backfill state for a session. Exposed via the
+ * normal export but namespaced by underscore so it doesn't show up in
+ * the public surface area outside tests.
+ */
+export declare function _getBackfillState(db: Database, sessionId: string): BackfillStateRow | null;
+export {};
+//# sourceMappingURL=tool-owner-backfill.d.ts.map

package/dist/features/magic-context/tool-owner-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-owner-backfill.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/tool-owner-backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiBpD,UAAU,gBAAgB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,UAAU,cAAc;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,cAAc,CAqDjE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAkB/D;AA6SD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAO1F"}

package/dist/features/magic-context/types.d.ts

@@ -0,0 +1,72 @@
+export interface TagEntry {
+    tagNumber: number;
+    messageId: string;
+    type: "message" | "tool" | "file";
+    status: "active" | "dropped" | "compacted";
+    dropMode: "full" | "truncated";
+    toolName: string | null;
+    inputByteSize: number;
+    byteSize: number;
+    reasoningByteSize: number;
+    sessionId: string;
+    /**
+     * Caveman compression depth applied to this tag's text part. 0 = none,
+     * 1 = lite, 2 = full, 3 = ultra. Only meaningful for `type: "message"`;
+     * tool/file tags stay at 0. Used by experimental age-tier caveman
+     * heuristic to avoid re-compressing text that already matches the
+     * target depth for its age band.
+     */
+    cavemanDepth: number;
+    /**
+     * For `type: "tool"` tags: the assistant message id where the
+     * underlying tool call was invoked. Identity for a tool tag is the
+     * triple `(sessionId, messageId/callID, toolOwnerMessageId)` —
+     * including this field disambiguates collisions when OpenCode's
+     * per-turn callID counter produces the same id across turns.
+     *
+     * NULL on:
+     *   - all `type: "message"` and `type: "file"` tags (not applicable)
+     *   - legacy tool tags written before plugin v0.16.x (the
+     *     tag-owner-fix migration v10). The runtime lazily adopts these
+     *     orphan rows on first observation; backfill populates them at
+     *     plugin startup against the OpenCode DB.
+     *
+     * See plan v3.3.1 in `.alfonso/plans/tag-owner-fix-plan.md`.
+     */
+    toolOwnerMessageId: string | null;
+}
+export interface PendingOp {
+    id: number;
+    sessionId: string;
+    tagId: number;
+    operation: "drop";
+    queuedAt: number;
+}
+export interface SessionMeta {
+    sessionId: string;
+    lastResponseTime: number;
+    cacheTtl: string;
+    counter: number;
+    lastNudgeTokens: number;
+    lastNudgeBand: "far" | "near" | "urgent" | "critical" | null;
+    lastTransformError: string | null;
+    isSubagent: boolean;
+    lastContextPercentage: number;
+    lastInputTokens: number;
+    observedSafeInputTokens: number;
+    cacheAlertSent: boolean;
+    timesExecuteThresholdReached: number;
+    compartmentInProgress: boolean;
+    systemPromptHash: string;
+    systemPromptTokens: number;
+    conversationTokens: number;
+    toolCallTokens: number;
+    clearedReasoningThroughTag: number;
+    lastTodoState: string;
+}
+export type SchedulerDecision = "execute" | "defer";
+export interface ContextUsage {
+    percentage: number;
+    inputTokens: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/magic-context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC;IAC7D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,4BAA4B,EAAE,MAAM,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B,EAAE,MAAM,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB"}

package/dist/features/magic-context/user-memory/review-user-memories.d.ts

@@ -0,0 +1,22 @@
+import type { PluginContext } from "../../../plugin/types";
+import type { Database } from "../../../shared/sqlite";
+interface ReviewUserMemoriesArgs {
+    db: Database;
+    client: PluginContext["client"];
+    parentSessionId: string | undefined;
+    sessionDirectory: string | undefined;
+    holderId: string;
+    deadline: number;
+    promotionThreshold: number;
+    /** Resolved dreamer fallback chain. */
+    fallbackModels?: readonly string[];
+}
+interface ReviewResult {
+    promoted: number;
+    merged: number;
+    dismissed: number;
+    candidatesConsumed: number;
+}
+export declare function reviewUserMemories(args: ReviewUserMemoriesArgs): Promise<ReviewResult>;
+export {};
+//# sourceMappingURL=review-user-memories.d.ts.map

package/dist/features/magic-context/user-memory/review-user-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-user-memories.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/user-memory/review-user-memories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAavD,UAAU,sBAAsB;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,UAAU,YAAY;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyP5F"}

package/dist/features/magic-context/user-memory/storage-user-memory.d.ts

@@ -0,0 +1,33 @@
+import type { Database } from "../../../shared/sqlite";
+export interface UserMemoryCandidate {
+    id: number;
+    content: string;
+    sessionId: string;
+    sourceCompartmentStart: number | null;
+    sourceCompartmentEnd: number | null;
+    createdAt: number;
+}
+export interface UserMemory {
+    id: number;
+    content: string;
+    status: "active" | "dismissed";
+    promotedAt: number;
+    sourceCandidateIds: number[];
+    createdAt: number;
+    updatedAt: number;
+}
+export declare function insertUserMemoryCandidates(db: Database, candidates: Array<{
+    content: string;
+    sessionId: string;
+    sourceCompartmentStart?: number;
+    sourceCompartmentEnd?: number;
+}>): void;
+export declare function getUserMemoryCandidates(db: Database): UserMemoryCandidate[];
+export declare function deleteUserMemoryCandidates(db: Database, ids: number[]): void;
+export declare function insertUserMemory(db: Database, content: string, sourceCandidateIds: number[]): number;
+export declare function getActiveUserMemories(db: Database): UserMemory[];
+export declare function getAllUserMemories(db: Database): UserMemory[];
+export declare function updateUserMemoryContent(db: Database, id: number, content: string): void;
+export declare function dismissUserMemory(db: Database, id: number): void;
+export declare function deleteUserMemory(db: Database, id: number): void;
+//# sourceMappingURL=storage-user-memory.d.ts.map

package/dist/features/magic-context/user-memory/storage-user-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-user-memory.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/user-memory/storage-user-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,0BAA0B,CACtC,EAAE,EAAE,QAAQ,EACZ,UAAU,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC,GACH,IAAI,CAiBN;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,GAAG,mBAAmB,EAAE,CAqB3E;AAED,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAI5E;AAID,wBAAgB,gBAAgB,CAC5B,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAAE,GAC7B,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,EAAE,CAehE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,EAAE,CAe7D;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMvF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/D"}

package/dist/features/magic-context/work-metrics.d.ts

@@ -0,0 +1,13 @@
+import type { Database } from "../../shared/sqlite";
+export interface WorkMetrics {
+    newWorkTokens: number;
+    totalInputTokens: number;
+}
+export interface PiSessionEntry {
+    role?: unknown;
+    usage?: unknown;
+    message?: unknown;
+}
+export declare function computeOpenCodeWorkMetrics(openCodeDb: Database, sessionId: string): WorkMetrics;
+export declare function computePiWorkMetrics(sessionEntries: PiSessionEntry[] | unknown[]): WorkMetrics;
+//# sourceMappingURL=work-metrics.d.ts.map

package/dist/features/magic-context/work-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-metrics.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/work-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,WAAW;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAuFD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAQ/F;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,GAAG,WAAW,CA8B9F"}

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -0,0 +1,23 @@
+interface AutoUpdateInstallContext {
+    installDir: string;
+    packageJsonPath: string;
+}
+export declare function resolveInstallContext(runtimePackageJsonPath?: string | null): AutoUpdateInstallContext | null;
+export declare function preparePackageUpdate(version: string, packageName?: string, runtimePackageJsonPath?: string | null): string | null;
+/**
+ * Run `npm install` in the install dir to materialize the dependency version
+ * we just rewrote. Earlier versions used `bun install`, but OpenCode itself
+ * installs plugins via npm (the install dir always contains package-lock.json,
+ * never bun.lock), so calling npm matches the existing lockfile shape and
+ * avoids generating a parallel bun.lock that drifts from OpenCode's view.
+ *
+ * The default timeout is 60s — long enough for a typical reinstall over a
+ * mediocre network, short enough that a stuck install doesn't pin the plugin
+ * process. Caller can override.
+ */
+export declare function runNpmInstallSafe(installDir: string, options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<boolean>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/hooks/auto-update-checker/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/cache.ts"],"names":[],"mappings":"AAmBA,UAAU,wBAAwB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAgGD,wBAAgB,qBAAqB,CACjC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GAC3E,wBAAwB,GAAG,IAAI,CA2CjC;AAED,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAqB,EAClC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GAC3E,MAAM,GAAG,IAAI,CAyBf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC3D,OAAO,CAAC,OAAO,CAAC,CA2ClB"}

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -0,0 +1,13 @@
+import { type PluginEntryInfo } from "./types";
+export declare function extractChannel(version: string | null): string;
+export declare function getLocalDevVersion(directory: string): string | null;
+export declare function getCurrentRuntimePackageJsonPath(currentModuleUrl?: string): string | null;
+export declare function findPluginEntry(directory: string): PluginEntryInfo | null;
+export declare function getCachedVersion(spec?: string | null): string | null;
+export declare function updatePinnedVersion(configPath: string, oldEntry: string, newVersion: string): boolean;
+export declare function getLatestVersion(channel?: string, options?: {
+    registryUrl?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<string | null>;
+//# sourceMappingURL=checker.d.ts.map

package/dist/hooks/auto-update-checker/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/checker.ts"],"names":[],"mappings":"AAeA,OAAO,EAIH,KAAK,eAAe,EACvB,MAAM,SAAS,CAAC;AAqCjB,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAY7D;AA4ED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYnE;AAED,wBAAgB,gCAAgC,CAC5C,gBAAgB,GAAE,MAAwB,GAC3C,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2BzE;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA0BpE;AAED,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACnB,OAAO,CAwBT;AAMD,wBAAsB,gBAAgB,CAClC,OAAO,SAAW,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACjF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB"}

package/dist/hooks/auto-update-checker/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const PACKAGE_NAME = "@wolfx/opencode-magic-context";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org";
+export declare const NPM_FETCH_TIMEOUT = 10000;
+/** Root directory OpenCode uses for cached npm plugin wrapper installs. */
+export declare const CACHE_DIR: string;
+/** Primary OpenCode configuration file path (standard JSON). */
+export declare const USER_OPENCODE_CONFIG: string;
+/** Alternative OpenCode configuration file path (JSON with Comments). */
+export declare const USER_OPENCODE_CONFIG_JSONC: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/auto-update-checker/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAC5D,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAC7D,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAgBxC,2EAA2E;AAC3E,eAAO,MAAM,SAAS,QAA2C,CAAC;AAElE,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,QAAiD,CAAC;AAEnF,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,QAAkD,CAAC"}

package/dist/hooks/auto-update-checker/index.d.ts

@@ -0,0 +1,40 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { AutoUpdateCheckerOptions } from "./types";
+type OpenCodeEvent = {
+    type: string;
+    properties?: unknown;
+};
+/**
+ * Auto-update checker.
+ *
+ * Trigger model (rewritten in v0.17.1):
+ *
+ * The check fires from plugin initialization itself via a `setTimeout`
+ * scheduled when this hook is created. We do NOT gate on
+ * `session.created` events — that gate was unreliable because:
+ *
+ *   - TUI restart with a resumed session never fires `session.created`
+ *     (the event fires on session creation, not on plugin reload).
+ *   - Multi-project plugin reloads each get their own plugin lifetime
+ *     with `hasChecked = false`, so only whichever project happens to
+ *     create a fresh session first ever runs the check.
+ *   - Sidebar/status polling and idle TUI use also never fire
+ *     `session.created`.
+ *
+ * Multi-project coordination is now handled by an on-disk timestamp at
+ * `<storageDir>/last-update-check.json`. Every plugin instance reads
+ * the timestamp before checking; if it's within `checkIntervalMs` of
+ * now, the check is skipped. The first instance to claim the slot
+ * writes the timestamp atomically (temp + rename) so concurrent
+ * instances don't all hit npm.
+ *
+ * The returned event hook is preserved as a no-op so existing tests
+ * that pass synthetic events keep working — the hook itself never
+ * triggers a check now.
+ */
+export declare function createAutoUpdateCheckerHook(ctx: PluginInput, options?: AutoUpdateCheckerOptions): (_input: {
+    event: OpenCodeEvent;
+}) => Promise<void>;
+export declare function getAutoUpdateInstallDir(): string;
+export type { AutoUpdateCheckerOptions } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/auto-update-checker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAgBF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CACvC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,wBAA6B,YAiBZ;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,mBAyCrD;AA0MD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAYD,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC"}

package/dist/hooks/auto-update-checker/types.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export declare const NpmPackageEnvelopeSchema: z.ZodObject<{
+    "dist-tags": z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strip>;
+export declare const OpencodePluginTupleSchema: z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>], null>;
+export declare const OpencodeConfigSchema: z.ZodObject<{
+    plugin: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>], null>]>>>;
+}, z.core.$strip>;
+export declare const PackageJsonSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export interface AutoUpdateCheckerOptions {
+    enabled?: boolean;
+    showStartupToast?: boolean;
+    autoUpdate?: boolean;
+    npmRegistryUrl?: string;
+    fetchTimeoutMs?: number;
+    signal?: AbortSignal;
+    /**
+     * Storage directory used for cross-process check coordination. The
+     * checker writes `last-update-check.json` here so concurrent plugin
+     * instances (multi-project TUI launches) only hit npm once per
+     * `checkIntervalMs`. Pass `null`/omit for fail-open behavior — the
+     * check still runs, just without dedup. Recommended: pass the
+     * plugin's existing storage path (e.g. `getMagicContextStorageDir()`).
+     */
+    storageDir?: string | null;
+    /**
+     * Minimum interval between checks across all plugin instances on
+     * this machine. Default: 1 hour.
+     */
+    checkIntervalMs?: number;
+    /**
+     * Delay before the post-init check fires. Lets OpenCode finish boot
+     * before the npm round-trip starts. Default: 5000ms.
+     */
+    initDelayMs?: number;
+}
+export interface PluginEntryInfo {
+    entry: string;
+    isPinned: boolean;
+    pinnedVersion: string | null;
+    configPath: string;
+}
+export type NpmPackageEnvelope = z.infer<typeof NpmPackageEnvelopeSchema>;
+export type OpencodeConfig = z.infer<typeof OpencodeConfigSchema>;
+export type PackageJson = z.infer<typeof PackageJsonSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/auto-update-checker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,eAAO,MAAM,yBAAyB,yEAA2D,CAAC;AAElG,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAMZ,CAAC;AAEnB,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/hooks/is-anthropic-provider.d.ts

@@ -0,0 +1,2 @@
+export declare function isAnthropicProvider(providerID: string): boolean;
+//# sourceMappingURL=is-anthropic-provider.d.ts.map

package/dist/hooks/is-anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/hooks/is-anthropic-provider.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/hooks/magic-context/apply-context-nudge.d.ts

@@ -0,0 +1,5 @@
+import type { NudgePlacementStore } from "./nudge-placement-store";
+import type { ContextNudge } from "./nudger";
+import type { MessageLike } from "./tag-messages";
+export declare function applyContextNudge(messages: MessageLike[], nudge: ContextNudge | null, nudgePlacements: NudgePlacementStore, sessionId: string): void;
+//# sourceMappingURL=apply-context-nudge.d.ts.map

package/dist/hooks/magic-context/apply-context-nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-context-nudge.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/apply-context-nudge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,eAAe,EAAE,mBAAmB,EACpC,SAAS,EAAE,MAAM,GAClB,IAAI,CAgCN"}

package/dist/hooks/magic-context/apply-operations.d.ts

@@ -0,0 +1,7 @@
+import type { ContextDatabase } from "../../features/magic-context/storage";
+import { getPendingOps } from "../../features/magic-context/storage";
+import type { TagEntry } from "../../features/magic-context/types";
+import type { TagTarget } from "./tag-messages";
+export declare function applyPendingOperations(sessionId: string, db: ContextDatabase, targets: Map<number, TagTarget>, protectedTags?: number, preloadedTags?: TagEntry[], preloadedPendingOps?: ReturnType<typeof getPendingOps>): boolean;
+export declare function applyFlushedStatuses(sessionId: string, db: ContextDatabase, targets: Map<number, TagTarget>, preloadedTags?: TagEntry[]): boolean;
+//# sourceMappingURL=apply-operations.d.ts.map

package/dist/hooks/magic-context/apply-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-operations.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/apply-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACH,aAAa,EAKhB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAwDhD,wBAAgB,sBAAsB,CAClC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,aAAa,GAAE,MAAU,EACzB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAC1B,mBAAmB,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GACvD,OAAO,CAoDT;AAED,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,aAAa,CAAC,EAAE,QAAQ,EAAE,GAC3B,OAAO,CA0BT"}

package/dist/hooks/magic-context/auto-search-hint.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Build a compact "you may recall something related" hint from unified search
+ * results, ready to append to a user message.
+ *
+ * The hint intentionally compresses fragments so they feel like vague recall
+ * rather than a drop-in answer — the goal is to nudge the agent to run
+ * ctx_search for full context, not to provide the answer itself.
+ *
+ * Compression strategy per source:
+ *   - memory → caveman-ultra via `cavemanCompress()` (token-dense)
+ *   - git_commit → raw commit subject (already terse); prefixed with SHA + age
+ *   - message → caveman-ultra, role tag
+ *
+ * Guardrails:
+ *   - Per-fragment token cap (~20 tokens, ~80 chars) with ellipsis truncation
+ *   - Skip fragments whose source is already present in visible session-history
+ *     (caller handles) — this module only knows about search results
+ *   - Hard-caps total output at ~200 tokens so misconfigured thresholds can't
+ *     balloon the user message
+ */
+import type { UnifiedSearchResult } from "../../features/magic-context/search";
+export interface AutoSearchHintOptions {
+    maxFragments?: number;
+    fragmentCharCap?: number;
+}
+/**
+ * Build the hint text. Returns null when `results` is empty, when no fragment
+ * has meaningful content after compression, or when limits zero out the budget.
+ *
+ * This function does NOT enforce score thresholds or message-length rules —
+ * callers (the transform-time auto-search wiring) apply those gates first.
+ */
+export declare function buildAutoSearchHint(results: UnifiedSearchResult[], options?: AutoSearchHintOptions): string | null;
+//# sourceMappingURL=auto-search-hint.d.ts.map

package/dist/hooks/magic-context/auto-search-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-search-hint.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/auto-search-hint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAQ/E,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AA2CD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,GAAE,qBAA0B,GACpC,MAAM,GAAG,IAAI,CAgCf"}

package/dist/hooks/magic-context/auto-search-runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Transform-time auto-search hint runner.
+ *
+ * When a new user message arrives, optionally run ctx_search against the user's
+ * prompt and append a caveman-compressed "vague recall" fragment hint to that
+ * message. The hint nudges the agent to run ctx_search for full context rather
+ * than injecting the content directly.
+ *
+ * Cache safety:
+ *   - Attaches to the latest user message (the message that triggered the turn),
+ *     never to message[0] or to any assistant message. Appending to the current
+ *     user message happens BEFORE it reaches Anthropic's cache because this
+ *     transform runs on the prompt path — same property as note nudges.
+ *   - Idempotent via in-memory turn cache + `.includes()` guard in
+ *     appendReminderToUserMessageById. On defer passes we re-append the same
+ *     text; `.includes()` makes that a no-op.
+ *   - New user turn (different message id) → compute fresh hint, new append.
+ *   - Process restart → cache cleared; next pass will recompute but the user
+ *     message is a fresh turn anyway, no provider cache to preserve yet.
+ */
+import type { Database } from "../../shared/sqlite";
+import type { MessageLike } from "./transform-operations";
+export interface AutoSearchRunnerOptions {
+    enabled: boolean;
+    scoreThreshold: number;
+    minPromptChars: number;
+    directory?: string;
+    projectPath: string;
+    ensureProjectRegistered?: (directory: string, db: Database) => Promise<void>;
+    memoryEnabled?: boolean;
+    embeddingEnabled?: boolean;
+    gitCommitsEnabled?: boolean;
+    /** Memory ids already rendered in the injected <session-history> block —
+     *  skip fragments that just duplicate visible memories. */
+    visibleMemoryIds?: Set<number>;
+}
+/**
+ * Entry point. Called from transform post-processing. No-op when disabled,
+ * when there is no meaningful user message, when prompt is too short, when
+ * search returns nothing strong enough, or when the hint has already been
+ * appended for this turn.
+ */
+export declare function runAutoSearchHint(args: {
+    sessionId: string;
+    db: Database;
+    messages: MessageLike[];
+    options: AutoSearchRunnerOptions;
+}): Promise<void>;
+/** Test hook — wipe the per-turn cache. */
+export declare function _resetAutoSearchCache(): void;
+/** Session cleanup hook — call on session.deleted. */
+export declare function clearAutoSearchForSession(_sessionId: string): void;
+//# sourceMappingURL=auto-search-runner.d.ts.map

package/dist/hooks/magic-context/auto-search-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-search-runner.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/auto-search-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiBH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA4C1D,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;+DAC2D;IAC3D,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAyID;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,uBAAuB,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2IhB;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAElE"}

package/dist/hooks/magic-context/boundary-execution.d.ts

@@ -0,0 +1,24 @@
+export type BypassReason = "force-materialize" | "explicit-bust" | "subagent" | "none";
+export interface BypassInput {
+    contextUsage: {
+        percentage: number;
+    };
+    sessionMeta: {
+        isSubagent: boolean;
+    };
+    historyRefreshSessions: Set<string>;
+    sessionId: string;
+}
+export declare const FORCE_MATERIALIZE_PERCENTAGE = 85;
+export declare function detectMidTurnBypassReason(input: BypassInput): BypassReason;
+export interface ApplyMidTurnDeferralInput {
+    base: "execute" | "defer";
+    bypassReason: BypassReason;
+    midTurn: boolean;
+}
+export interface ApplyMidTurnDeferralOutput {
+    midTurnAdjustedSchedulerDecision: "execute" | "defer";
+    sideEffect: "set-flag" | "none";
+}
+export declare function applyMidTurnDeferral(input: ApplyMidTurnDeferralInput): ApplyMidTurnDeferralOutput;
+//# sourceMappingURL=boundary-execution.d.ts.map

package/dist/hooks/magic-context/boundary-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-execution.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/boundary-execution.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvF,MAAM,WAAW,WAAW;IACxB,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,WAAW,EAAE;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAK1E;AAED,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACvC,gCAAgC,EAAE,SAAS,GAAG,OAAO,CAAC;IACtD,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;CACnC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,0BAA0B,CAajG"}

package/dist/hooks/magic-context/cache-busting-signals.d.ts

@@ -0,0 +1,10 @@
+export interface DeferredConsumptionArgs {
+    schedulerDecision: "execute" | "defer";
+    contextPercentage: number;
+    /** True when this pass awaited a run that actually published new compartment state. */
+    justAwaitedPublication: boolean;
+    /** True when an active run would block materialization below the emergency bypass. */
+    activeRunBlocksMaterialization: boolean;
+}
+export declare function canConsumeDeferredOnThisPass(args: DeferredConsumptionArgs): boolean;
+//# sourceMappingURL=cache-busting-signals.d.ts.map

package/dist/hooks/magic-context/cache-busting-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-busting-signals.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/cache-busting-signals.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACpC,iBAAiB,EAAE,SAAS,GAAG,OAAO,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,sBAAsB,EAAE,OAAO,CAAC;IAChC,sFAAsF;IACtF,8BAA8B,EAAE,OAAO,CAAC;CAC3C;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAQnF"}