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

package/dist/hooks/magic-context/compartment-runner-mapping.d.ts

@@ -0,0 +1,33 @@
+import type { CandidateCompartment } from "./compartment-runner-types";
+export declare function mapParsedCompartmentsToChunk(compartments: Array<{
+    startMessage: number;
+    endMessage: number;
+    title: string;
+    content: string;
+}>, chunk: {
+    startIndex: number;
+    endIndex: number;
+    lines: Array<{
+        ordinal: number;
+        messageId: string;
+    }>;
+}, sequenceOffset: number): {
+    ok: true;
+    compartments: CandidateCompartment[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function mapParsedCompartmentsToSession(compartments: Array<{
+    startMessage: number;
+    endMessage: number;
+    title: string;
+    content: string;
+}>, sessionId: string): {
+    ok: true;
+    compartments: CandidateCompartment[];
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=compartment-runner-mapping.d.ts.map

package/dist/hooks/magic-context/compartment-runner-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner-mapping.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,wBAAgB,4BAA4B,CACxC,YAAY,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,EACF,KAAK,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,EACD,cAAc,EAAE,MAAM,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,oBAAoB,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuBnF;AAED,wBAAgB,8BAA8B,CAC1C,YAAY,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,EACF,SAAS,EAAE,MAAM,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,oBAAoB,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA8BnF"}

package/dist/hooks/magic-context/compartment-runner-partial-recomp.d.ts

@@ -0,0 +1,29 @@
+import type { Compartment } from "../../features/magic-context/compartment-storage";
+import type { CompartmentRunnerDeps } from "./compartment-runner-types";
+export interface PartialRecompRange {
+    /** Inclusive raw message ordinal to start rebuilding from. */
+    start: number;
+    /** Inclusive raw message ordinal to stop rebuilding at. */
+    end: number;
+}
+export interface SnappedPartialRange {
+    /** Snapped start = first enclosing compartment's startMessage. */
+    snapStart: number;
+    /** Snapped end = last enclosing compartment's endMessage. */
+    snapEnd: number;
+    priorCompartments: Compartment[];
+    rangeCompartments: Compartment[];
+    tailCompartments: Compartment[];
+}
+/**
+ * Preview-only snap computation. Shown in the first-tap confirmation warning so
+ * the user sees which compartments will be replaced before executing.
+ *
+ * Returns an error string when the requested range cannot be snapped (e.g. no
+ * compartments exist yet, or the range is entirely after the last compartment).
+ */
+export declare function snapRangeToCompartments(compartments: Compartment[], range: PartialRecompRange): SnappedPartialRange | {
+    error: string;
+};
+export declare function executePartialRecompInternal(deps: CompartmentRunnerDeps, range: PartialRecompRange): Promise<string>;
+//# sourceMappingURL=compartment-runner-partial-recomp.d.ts.map

package/dist/hooks/magic-context/compartment-runner-partial-recomp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner-partial-recomp.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-partial-recomp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EAEd,MAAM,kDAAkD,CAAC;AA0B1D,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAU9F,MAAM,WAAW,kBAAkB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAChC,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,WAAW,EAAE,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,YAAY,EAAE,WAAW,EAAE,EAC3B,KAAK,EAAE,kBAAkB,GAC1B,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2CzC;AAcD,wBAAsB,4BAA4B,CAC9C,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAmXjB"}

package/dist/hooks/magic-context/compartment-runner-recomp.d.ts

@@ -0,0 +1,3 @@
+import type { CompartmentRunnerDeps } from "./compartment-runner-types";
+export declare function executeContextRecompInternal(deps: CompartmentRunnerDeps): Promise<string>;
+//# sourceMappingURL=compartment-runner-recomp.d.ts.map

package/dist/hooks/magic-context/compartment-runner-recomp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner-recomp.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-recomp.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAc9F,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+V/F"}

package/dist/hooks/magic-context/compartment-runner-state-xml.d.ts

@@ -0,0 +1,21 @@
+import type { CandidateCompartment } from "./compartment-runner-types";
+export declare function buildExistingStateXml(compartments: Array<{
+    startMessage: number;
+    endMessage: number;
+    startMessageId: string;
+    endMessageId: string;
+    title: string;
+    content: string;
+}>, facts: Array<{
+    category: string;
+    content: string;
+}>, memoryBlock?: string): string;
+export declare function mergePriorCompartments(priorCompartments: Array<{
+    startMessage: number;
+    endMessage: number;
+    startMessageId: string;
+    endMessageId: string;
+    title: string;
+    content: string;
+}>, newCompartments: CandidateCompartment[]): CandidateCompartment[];
+//# sourceMappingURL=compartment-runner-state-xml.d.ts.map

package/dist/hooks/magic-context/compartment-runner-state-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner-state-xml.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-state-xml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,EACF,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACnD,WAAW,CAAC,EAAE,MAAM,GACrB,MAAM,CA2CR;AAED,wBAAgB,sBAAsB,CAClC,iBAAiB,EAAE,KAAK,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,EACF,eAAe,EAAE,oBAAoB,EAAE,GACxC,oBAAoB,EAAE,CAaxB"}

package/dist/hooks/magic-context/compartment-runner-types.d.ts

@@ -0,0 +1,102 @@
+import type { PluginContext } from "../../plugin/types";
+import type { Database } from "../../shared/sqlite";
+import type { NotificationParams } from "./send-session-notification";
+export interface CompartmentRunnerDeps {
+    client: PluginContext["client"];
+    db: Database;
+    sessionId: string;
+    /**
+     * Historian chunk budget — how much raw history historian processes per
+     * call. Bounded by the HISTORIAN model's context window, not main's.
+     * Derived via `deriveHistorianChunkTokens(historianContextLimit)`.
+     */
+    historianChunkTokens: number;
+    historianTimeoutMs?: number;
+    /** Resolved fallback chain for historian-family calls (historian + compressor). */
+    fallbackModels?: readonly string[];
+    directory: string;
+    historyBudgetTokens?: number;
+    fallbackModelId?: string;
+    ensureProjectRegistered?: (directory: string, db: Database) => Promise<void>;
+    getNotificationParams?: () => NotificationParams;
+    /** When true, extract user behavior observations from historian output */
+    experimentalUserMemories?: boolean;
+    /** When true, inject wall-clock dates on compartments in <session-history>. */
+    experimentalTemporalAwareness?: boolean;
+    /** When true, run an editor pass after successful historian output to clean
+     *  low-signal U: lines and cross-compartment duplicates. */
+    historianTwoPass?: boolean;
+    /** Compressor floor ratio: floor = ceil(lastEndMessage / minCompartmentRatio). */
+    compressorMinCompartmentRatio?: number;
+    /** Compressor max merge depth (1-5). Compartments at or above this depth are skipped. */
+    compressorMaxMergeDepth?: number;
+    /**
+     * Cross-session memory feature gate (`memory.enabled` config). When false,
+     * historian/recomp must NOT promote session facts into project memories
+     * and must NOT generate or store embeddings. Issue #44.
+     */
+    memoryEnabled?: boolean;
+    /**
+     * Automatic-promotion gate (`memory.auto_promote` config). When false (and
+     * memory is otherwise enabled), tools and search still work, but historian
+     * does not auto-promote session facts to memories. Users can still write
+     * memories explicitly via `ctx_memory write`. Issue #44.
+     */
+    autoPromote?: boolean;
+    /**
+     * Called after compartment state is published. The runner marks the active
+     * run as published before invoking this callback.
+     */
+    onCompartmentStatePublished?: (sessionId: string) => void;
+    /**
+     * When true, publication preserves the in-memory injection cache until a
+     * later materializing pass consumes the deferred refresh.
+     */
+    preserveInjectionCacheUntilConsumed?: boolean;
+    /**
+     * Plan v6 §4: Called when historian/recomp publication wrote a pending
+     * compaction-marker row in-transaction (deferring marker application to a
+     * later materializing pass). Consumer (hook.ts) seeds
+     * `liveSessionState.deferredHistoryRefreshSessions` so the next consuming
+     * postprocess pass drains the pending blob and applies the marker.
+     */
+    onDeferredMarkerPending?: (sessionId: string) => void;
+    /** Holder id for the DB-backed compartment-state lease guarding publish paths. */
+    compartmentLeaseHolderId?: string;
+}
+export interface CandidateCompartment {
+    sequence: number;
+    startMessage: number;
+    endMessage: number;
+    startMessageId: string;
+    endMessageId: string;
+    title: string;
+    content: string;
+}
+export interface HistorianRunResult {
+    ok: boolean;
+    result?: string;
+    error?: string;
+    dumpPath?: string;
+    invocationId?: number;
+}
+export type ValidatedHistorianPassResult = {
+    ok: true;
+    compartments: CandidateCompartment[];
+    facts: Array<{
+        category: string;
+        content: string;
+    }>;
+    userObservations?: string[];
+} | {
+    ok: false;
+    error: string;
+};
+export interface StoredCompartmentRange {
+    startMessage: number;
+    endMessage: number;
+}
+export interface HistorianProgressCallbacks {
+    onRepairRetry?: (error: string) => Promise<void>;
+}
+//# sourceMappingURL=compartment-runner-types.d.ts.map

package/dist/hooks/magic-context/compartment-runner-types.d.ts.map

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

package/dist/hooks/magic-context/compartment-runner-validation.d.ts

@@ -0,0 +1,28 @@
+import type { StoredCompartmentRange, ValidatedHistorianPassResult } from "./compartment-runner-types";
+export declare function validateHistorianOutput(text: string, _sessionId: string, chunk: {
+    startIndex: number;
+    endIndex: number;
+    lines: Array<{
+        ordinal: number;
+        messageId: string;
+    }>;
+    /** Optional — when provided, gaps inside these ranges heal at any size. */
+    toolOnlyRanges?: ReadonlyArray<{
+        start: number;
+        end: number;
+    }>;
+}, _priorCompartments: StoredCompartmentRange[], sequenceOffset: number): ValidatedHistorianPassResult;
+export declare function buildHistorianRepairPrompt(originalPrompt: string, previousOutput: string, validationError: string): string;
+export declare function validateStoredCompartments(compartments: Array<{
+    startMessage: number;
+    endMessage: number;
+}>): string | null;
+export declare function validateChunkCoverage(chunk: {
+    startIndex: number;
+    endIndex: number;
+    lines: Array<{
+        ordinal: number;
+    }>;
+}): string | null;
+export declare function getReducedRecompTokenBudget(currentBudget: number): number | null;
+//# sourceMappingURL=compartment-runner-validation.d.ts.map

package/dist/hooks/magic-context/compartment-runner-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner-validation.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,sBAAsB,EACtB,4BAA4B,EAC/B,MAAM,4BAA4B,CAAC;AAmDpC,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,2EAA2E;IAC3E,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,EACD,kBAAkB,EAAE,sBAAsB,EAAE,EAC5C,cAAc,EAAE,MAAM,GACvB,4BAA4B,CAyC9B;AAED,wBAAgB,0BAA0B,CACtC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACxB,MAAM,CAaR;AAED,wBAAgB,0BAA0B,CACtC,YAAY,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAClE,MAAM,GAAG,IAAI,CAoBf;AAgDD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC,GAAG,MAAM,GAAG,IAAI,CAkBhB;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhF"}

package/dist/hooks/magic-context/compartment-runner.d.ts

@@ -0,0 +1,54 @@
+import { type PartialRecompRange } from "./compartment-runner-partial-recomp";
+import type { CompartmentRunnerDeps } from "./compartment-runner-types";
+export interface ActiveCompartmentRun {
+    promise: Promise<void>;
+    published: boolean;
+    /**
+     * Set to true once the 95%-emergency user-facing notification has been
+     * dispatched for this run. Prevents the notification from re-firing on
+     * every subsequent transform pass while the same compartment run is
+     * still active — which would otherwise persist a fresh ignored user
+     * message every pass and drive OpenCode's runLoop break condition false.
+     */
+    notificationSent?: boolean;
+}
+export declare function getActiveCompartmentRun(sessionId: string): ActiveCompartmentRun | undefined;
+export declare function markActiveCompartmentRunPublished(sessionId: string): void;
+/**
+ * Register a compartment-state-mutating promise with the active-runs map.
+ *
+ * Use this to serialize background compressor runs against historian/recomp
+ * runs: both read-modify-write compartment rows, and while SQLite serializes
+ * individual statements it does NOT serialize multi-step update cycles. If a
+ * historian starts while a background compressor is still running, either
+ * side's final write can overwrite the other's work.
+ *
+ * The registered promise is cleared from activeRuns on settle so later passes
+ * can start a new run. If a run is already registered for the session, the
+ * caller is expected to have checked getActiveCompartmentRun() first and
+ * bailed — this function will overwrite silently if called anyway, which is
+ * the desired behavior for the retry path.
+ */
+export declare function registerActiveCompartmentRun(sessionId: string, promise: Promise<void>): ActiveCompartmentRun;
+export declare function startCompartmentAgent(deps: CompartmentRunnerDeps): void;
+export interface ExecuteContextRecompOptions {
+    /**
+     * Optional partial range (inclusive raw message ordinals). When provided,
+     * runs partial recomp — snaps to enclosing compartment boundaries and
+     * rebuilds only the matching compartments, preserving prior/tail
+     * compartments and all session facts.
+     *
+     * When omitted, runs full recomp from message 1 to the protected tail,
+     * replacing all compartments and facts.
+     */
+    range?: PartialRecompRange;
+}
+export interface ExecuteContextRecompResult {
+    message: string;
+    published: boolean;
+}
+export declare function executeContextRecompWithResult(deps: CompartmentRunnerDeps, options?: ExecuteContextRecompOptions): Promise<ExecuteContextRecompResult>;
+export declare function executeContextRecomp(deps: CompartmentRunnerDeps, options?: ExecuteContextRecompOptions): Promise<string>;
+export { runCompartmentAgent } from "./compartment-runner-incremental";
+export type { PartialRecompRange } from "./compartment-runner-partial-recomp";
+//# sourceMappingURL=compartment-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-runner.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner.ts"],"names":[],"mappings":"AASA,OAAO,EAEH,KAAK,kBAAkB,EAC1B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE3F;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GACvB,oBAAoB,CAetB;AA0BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA0CvE;AAED,MAAM,WAAW,2BAA2B;IACxC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,8BAA8B,CAChD,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CA4CrC;AAED,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/hooks/magic-context/compartment-trigger.d.ts

@@ -0,0 +1,17 @@
+import type { ContextUsage, SessionMeta, TagEntry } from "../../features/magic-context/types";
+import type { Database } from "../../shared/sqlite";
+declare const POST_DROP_TARGET_RATIO = 0.75;
+declare const FORCE_COMPARTMENT_PERCENTAGE = 80;
+declare const BLOCK_UNTIL_DONE_PERCENTAGE = 95;
+declare const FORCE_MATERIALIZE_PERCENTAGE = 85;
+export { BLOCK_UNTIL_DONE_PERCENTAGE, FORCE_COMPARTMENT_PERCENTAGE, FORCE_MATERIALIZE_PERCENTAGE, POST_DROP_TARGET_RATIO, };
+export interface CompartmentTriggerResult {
+    shouldFire: boolean;
+    reason?: "projected_headroom" | "force_80" | "commit_clusters" | "tail_size";
+}
+export declare function getProactiveCompartmentTriggerPercentage(executeThresholdPercentage: number): number;
+export declare function checkCompartmentTrigger(db: Database, sessionId: string, sessionMeta: SessionMeta, usage: ContextUsage, _previousPercentage: number, executeThresholdPercentage: number, triggerBudget: number, autoDropToolAge?: number, protectedTagCount?: number, clearReasoningAge?: number, dropToolStructure?: boolean, commitClusterTrigger?: {
+    enabled: boolean;
+    min_clusters: number;
+}, preloadedActiveTags?: readonly TagEntry[]): CompartmentTriggerResult;
+//# sourceMappingURL=compartment-trigger.d.ts.map

package/dist/hooks/magic-context/compartment-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-trigger.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-trigger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AASpD,QAAA,MAAM,sBAAsB,OAAO,CAAC;AAKpC,QAAA,MAAM,4BAA4B,KAAK,CAAC;AACxC,QAAA,MAAM,2BAA2B,KAAK,CAAC;AACvC,QAAA,MAAM,4BAA4B,KAAK,CAAC;AAExC,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,GACzB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,GAAG,iBAAiB,GAAG,WAAW,CAAC;CAChF;AAED,wBAAgB,wCAAwC,CACpD,0BAA0B,EAAE,MAAM,GACnC,MAAM,CAER;AAgJD,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,MAAM,EAC3B,0BAA0B,EAAE,MAAM,EAClC,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,iBAAiB,UAAO,EACxB,oBAAoB,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACjE,mBAAmB,CAAC,EAAE,SAAS,QAAQ,EAAE,GAC1C,wBAAwB,CAiI1B"}

package/dist/hooks/magic-context/derive-budgets.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Budget derivation
+ *
+ * Two scaling bases, two clamps. Replaces the old static
+ * `compartment_token_budget` setting which tried to serve both roles
+ * and scaled with neither model.
+ *
+ *   - triggerBudget: scales with (main model × executeThreshold).
+ *     Drives size-based historian triggers (`tail_size`, `commit_clusters`).
+ *     "How big can the uncompartmentalized tail get before we force
+ *     historian to run." This is anchored to the MAIN model's usable
+ *     working space, not its total context.
+ *
+ *   - historianChunkTokens: scales with the HISTORIAN model's context.
+ *     The raw-history window historian processes per call. Different
+ *     scaling basis because historian is a single-shot summarizer bound
+ *     by its own context, not the main session's pressure math.
+ */
+/**
+ * Budget basis for size-based historian triggers (tail_size, commit_clusters).
+ * Anchored to the MAIN model's usable working space, not its total context.
+ *
+ * @param mainContextLimit Main session model's context window (tokens).
+ * @param executeThresholdPercentage The effective execute threshold (0-100).
+ */
+export declare function deriveTriggerBudget(mainContextLimit: number, executeThresholdPercentage: number): number;
+/**
+ * Raw-history chunk budget for historian's own context window.
+ * Historian formats tool calls as compact `TC:` summaries and drops tool results,
+ * so a 50K-token chunk typically represents far more raw messages than its token
+ * count implies. The max is tuned around that compression.
+ *
+ * @param historianContextLimit Historian model's context window (tokens).
+ */
+export declare function deriveHistorianChunkTokens(historianContextLimit: number): number;
+/**
+ * Resolve the historian model's context limit for chunk budget sizing.
+ *
+ * Behavior:
+ *   - If `historianModelOverride` is a full `provider/model-id` → use that model's
+ *     context directly. This honors explicit user intent.
+ *   - If the override is set but lacks `/` (e.g. `"llama3-32k"`) → warn and fall
+ *     through to the fallback chain, since we can't look up models without a
+ *     provider and silently ignoring would produce incorrect chunk sizes.
+ *   - If no override → scan the expanded fallback chain (all `provider/model`
+ *     combinations OpenCode might try) and use the MINIMUM resolved context.
+ *     This is defensive: if the first-choice model is unavailable and OpenCode
+ *     falls back to a smaller-context entry, the chunk budget is still safe.
+ *   - If neither models.dev nor opencode.json custom providers know the model,
+ *     fall back to 128K as a conservative default.
+ *
+ * Context limits are resolved through `getModelsDevContextLimit`, which reads
+ * both OpenCode's models.dev cache and custom `provider.*.models.*.limit.context`
+ * entries from `opencode.json(c)`.
+ */
+export declare function resolveHistorianContextLimit(historianModelOverride?: string): number;
+//# sourceMappingURL=derive-budgets.d.ts.map

package/dist/hooks/magic-context/derive-budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-budgets.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/derive-budgets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoBH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,gBAAgB,EAAE,MAAM,EACxB,0BAA0B,EAAE,MAAM,GACnC,MAAM,CAYR;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCpF"}

package/dist/hooks/magic-context/drop-stale-reduce-calls.d.ts

@@ -0,0 +1,4 @@
+import type { MessageLike } from "./tag-messages";
+export declare function isReduceToolPart(part: unknown): boolean;
+export declare function dropStaleReduceCalls(messages: MessageLike[], protectedCount?: number): boolean;
+//# sourceMappingURL=drop-stale-reduce-calls.d.ts.map

package/dist/hooks/magic-context/drop-stale-reduce-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-stale-reduce-calls.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/drop-stale-reduce-calls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAoBvD;AAoBD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,cAAc,GAAE,MAAU,GAAG,OAAO,CAiCjG"}

package/dist/hooks/magic-context/event-handler.d.ts

@@ -0,0 +1,49 @@
+import type { createCompactionHandler } from "../../features/magic-context/compaction";
+import type { Tagger } from "../../features/magic-context/tagger";
+import type { ContextUsage } from "../../features/magic-context/types";
+import { type NotificationParams } from "./send-session-notification";
+import { type NudgePlacementStore } from "./transform";
+type CacheTtlConfig = string | Record<string, string>;
+interface ContextUsageEntry {
+    usage: ContextUsage;
+    updatedAt: number;
+    lastResponseTime?: number;
+}
+export interface EventHandlerDeps {
+    contextUsageMap: Map<string, ContextUsageEntry>;
+    compactionHandler: ReturnType<typeof createCompactionHandler>;
+    nudgePlacements: NudgePlacementStore;
+    onSessionCacheInvalidated?: (sessionId: string) => void;
+    onSessionDeleted?: (sessionId: string) => void;
+    config: {
+        protected_tags: number;
+        auto_drop_tool_age?: number;
+        drop_tool_structure?: boolean;
+        clear_reasoning_age?: number;
+        execute_threshold_percentage?: number | {
+            default: number;
+            [modelKey: string]: number;
+        };
+        execute_threshold_tokens?: {
+            default?: number;
+            [modelKey: string]: number | undefined;
+        };
+        cache_ttl: CacheTtlConfig;
+        commit_cluster_trigger?: {
+            enabled: boolean;
+            min_clusters: number;
+        };
+    };
+    tagger: Tagger;
+    db: ReturnType<typeof import("../../features/magic-context/storage").openDatabase>;
+    client?: unknown;
+    getNotificationParams?: (sessionId: string) => NotificationParams;
+}
+export declare function createEventHandler(deps: EventHandlerDeps): (input: {
+    event: {
+        type: string;
+        properties?: unknown;
+    };
+}) => Promise<void>;
+export {};
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/hooks/magic-context/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/event-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AA6BvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAsBvE,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMhF,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,UAAU,iBAAiB;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAOD,MAAM,WAAW,gBAAgB;IAC7B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAChD,iBAAiB,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAC9D,eAAe,EAAE,mBAAmB,CAAC;IACrC,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,MAAM,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,4BAA4B,CAAC,EAAE,MAAM,GAAG;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACxF,wBAAwB,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;SAAE,CAAC;QACxF,SAAS,EAAE,cAAc,CAAC;QAC1B,sBAAsB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;KACvE,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,UAAU,CAAC,cAAc,sCAAsC,EAAE,YAAY,CAAC,CAAC;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;CACrE;AAwHD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IACvC,OAAO;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,KAAG,OAAO,CAAC,IAAI,CAAC,CA2dzF"}

package/dist/hooks/magic-context/event-payloads.d.ts

@@ -0,0 +1,62 @@
+export type MagicContextEventType = "session.created" | "session.error" | "message.updated" | "message.removed" | "session.compacted" | "session.deleted";
+export type MagicContextEvent = {
+    type: MagicContextEventType;
+    properties?: unknown;
+};
+export interface SessionCreatedInfo {
+    id: string;
+    parentID: string;
+    providerID?: string;
+    modelID?: string;
+}
+export interface MessageUpdatedAssistantInfo {
+    role: "assistant";
+    finish?: string;
+    sessionID: string;
+    /** OpenCode assistant message id. Undefined only when the event payload
+     *  doesn't include one (older SDK versions or malformed events). */
+    messageID?: string;
+    providerID?: string;
+    modelID?: string;
+    tokens?: {
+        input?: number;
+        cache?: {
+            read?: number;
+            write?: number;
+        };
+    };
+    /** Error attached to the assistant message, if any. OpenCode attaches
+     *  context-overflow errors here in addition to emitting session.error. */
+    error?: unknown;
+}
+export interface MessageUpdatedInfo {
+    role: "user" | "assistant" | string;
+    sessionID: string;
+    messageID?: string;
+    finish?: string;
+    completedAt?: number;
+}
+export interface SessionErrorInfo {
+    sessionID: string;
+    error: unknown;
+}
+export interface MessageRemovedInfo {
+    sessionID: string;
+    messageID: string;
+}
+export declare function getSessionProperties(properties: unknown): {
+    info?: unknown;
+    sessionID?: string;
+} | undefined;
+export declare function getSessionCreatedInfo(properties: unknown): SessionCreatedInfo | null;
+export declare function getMessageUpdatedAssistantInfo(properties: unknown): MessageUpdatedAssistantInfo | null;
+export declare function getMessageUpdatedInfo(properties: unknown): MessageUpdatedInfo | null;
+/**
+ * Extract `session.error` event payload. The event carries `{ sessionID, error }`
+ * at the top level (no `info` wrapper). We intentionally keep `error` as
+ * `unknown` — the plugin does not depend on OpenCode's NamedError shape, the
+ * overflow detector accepts strings, Errors, or objects with `message`.
+ */
+export declare function getSessionErrorInfo(properties: unknown): SessionErrorInfo | null;
+export declare function getMessageRemovedInfo(properties: unknown): MessageRemovedInfo | null;
+//# sourceMappingURL=event-payloads.d.ts.map

package/dist/hooks/magic-context/event-payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-payloads.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/event-payloads.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,GAC3B,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;wEACoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE;YACJ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACL,CAAC;IACF;8EAC0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,OAAO,GACpB;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUpD;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAiBpF;AAED,wBAAgB,8BAA8B,CAC1C,UAAU,EAAE,OAAO,GACpB,2BAA2B,GAAG,IAAI,CA8BpC;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAmBpF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAMhF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAapF"}

package/dist/hooks/magic-context/event-resolvers.d.ts

@@ -0,0 +1,72 @@
+import type { ContextDatabase } from "../../features/magic-context/storage";
+type CacheTtlConfig = string | Record<string, string>;
+/**
+ * Resolve the effective context limit for a (providerID, modelID) pair.
+ *
+ * Resolution order:
+ *   1. Detected limit from a prior overflow error, when smaller than the
+ *      configured/cache limit. Providers report the REAL limit in the error
+ *      message, which is authoritative for the current deployment.
+ *   2. OpenCode's models.dev cache (overlaid with user's
+ *      `provider.*.models.*.limit.context`).
+ *   3. Conservative default (128k).
+ *
+ * The session context (db + sessionID) is optional — callers that operate
+ * outside a specific session (e.g. warm-up, status-bar summaries) can omit it
+ * and fall back to the global cache/default.
+ */
+export declare function resolveContextLimit(providerID: string | undefined, modelID: string | undefined, ctx?: {
+    db?: ContextDatabase;
+    sessionID?: string;
+}): number;
+export declare function resolveCacheTtl(cacheTtl: CacheTtlConfig, modelKey: string | undefined): string;
+type ExecuteThresholdConfig = number | {
+    default: number;
+    [modelKey: string]: number;
+};
+type ExecuteThresholdTokensConfig = {
+    default?: number;
+    [modelKey: string]: number | undefined;
+} | undefined;
+export interface ExecuteThresholdOptions {
+    /** Optional tokens-based threshold config. When matched for the given modelKey,
+     *  overrides the percentage-based threshold. */
+    tokensConfig?: ExecuteThresholdTokensConfig;
+    /** Required when `tokensConfig` is provided — used to convert tokens → percentage
+     *  and to clamp values above 80% × context_limit. */
+    contextLimit?: number;
+    /** Session ID for warn logs when clamping. If absent, warns to global log. */
+    sessionId?: string;
+}
+export type ExecuteThresholdMode = "percentage" | "tokens";
+export interface ExecuteThresholdDetail {
+    /** Effective execute threshold as a percentage (0–80). Downstream math keys off this. */
+    percentage: number;
+    /** Which source was authoritative: tokens config (when matched + valid context) or percentage. */
+    mode: ExecuteThresholdMode;
+    /** When mode is "tokens", the absolute token value after clamping (≤ 80% × contextLimit). */
+    absoluteTokens?: number;
+    /** The config key that matched, if any (for display/debugging). `"default"` when default fallback. */
+    matchedKey?: string;
+}
+/**
+ * Single source of truth for execute-threshold resolution. Returns the effective
+ * percentage plus which config source was authoritative. Callers that only need
+ * the percentage can use `resolveExecuteThreshold` (thin wrapper below); callers
+ * that surface the mode to users (`/ctx-status`, TUI, RPC) must use this directly
+ * to avoid the "progressive lookup drift" bug where two call sites disagree on
+ * whether tokens mode is active.
+ */
+export declare function resolveExecuteThresholdDetail(config: ExecuteThresholdConfig, modelKey: string | undefined, fallback: number, options?: ExecuteThresholdOptions): ExecuteThresholdDetail;
+/**
+ * Backward-compatible wrapper around `resolveExecuteThresholdDetail`.
+ * Use the detail version when you also need the mode or absolute token value.
+ */
+export declare function resolveExecuteThreshold(config: ExecuteThresholdConfig, modelKey: string | undefined, fallback: number, options?: ExecuteThresholdOptions): number;
+export declare function resolveModelKey(providerID: string | undefined, modelID: string | undefined): string | undefined;
+export declare function resolveSessionId(properties: {
+    info?: unknown;
+    sessionID?: string;
+} | undefined): string | undefined;
+export {};
+//# sourceMappingURL=event-resolvers.d.ts.map

package/dist/hooks/magic-context/event-resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-resolvers.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/event-resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAQ5E,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,GAAG,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,eAAe,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAoBR;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiB9F;AAED,KAAK,sBAAsB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AACvF,KAAK,4BAA4B,GAC3B;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5D,SAAS,CAAC;AAEhB,MAAM,WAAW,uBAAuB;IACpC;oDACgD;IAChD,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C;yDACqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACnC,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AA8CD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAClC,sBAAsB,CA+ExB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAClC,MAAM,CAER;AA2BD,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,gBAAgB,CAC5B,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC/D,MAAM,GAAG,SAAS,CAmBpB"}

package/dist/hooks/magic-context/execute-flush.d.ts

@@ -0,0 +1,3 @@
+import type { Database } from "../../shared/sqlite";
+export declare function executeFlush(db: Database, sessionId: string): string;
+//# sourceMappingURL=execute-flush.d.ts.map

package/dist/hooks/magic-context/execute-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-flush.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/execute-flush.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8BpE"}

package/dist/hooks/magic-context/execute-status.d.ts

@@ -0,0 +1,12 @@
+import type { Database } from "../../shared/sqlite";
+export declare function executeStatus(db: Database, sessionId: string, protectedTags: number, nudgeIntervalTokens?: number, executeThresholdPercentageConfig?: number | {
+    default: number;
+    [modelKey: string]: number;
+}, liveModelKey?: string, historyBudgetPercentage?: number, commitClusterTrigger?: {
+    enabled: boolean;
+    min_clusters: number;
+}, executeThresholdTokens?: {
+    default?: number;
+    [modelKey: string]: number | undefined;
+}, contextLimit?: number): string;
+//# sourceMappingURL=execute-status.d.ts.map

package/dist/hooks/magic-context/execute-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-status.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/execute-status.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AA8BpD,wBAAgB,aAAa,CACzB,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,mBAAmB,GAAE,MAAsC,EAC3D,gCAAgC,GAC1B,MAAM,GACN;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAyC,EAC5F,YAAY,CAAC,EAAE,MAAM,EACrB,uBAAuB,CAAC,EAAE,MAAM,EAChC,oBAAoB,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACjE,sBAAsB,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,EACrF,YAAY,CAAC,EAAE,MAAM,GACtB,MAAM,CA8JR"}