@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/hooks/magic-context/image-token-estimate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Estimate token cost of an image from its data URL.
+ * Returns a conservative fallback when parsing fails.
+ */
+export declare function estimateImageTokensFromDataUrl(url: string): number;
+/**
+ * Image tokens of a tool part's `state.attachments`: the images a tool returned next to its
+ * text output (OpenCode's `read` on a PNG, for example). The provider bills each one as an
+ * image, so it is counted from its pixel dimensions, never from its base64 length. Other
+ * attachment types stay uncounted, as they are for message file parts. Callers skip a
+ * dropped output themselves: on OpenCode 2 the drop placeholder replaces the whole result,
+ * images included.
+ */
+export declare function estimateToolAttachmentImageTokens(state: unknown): number;
+//# sourceMappingURL=image-token-estimate.d.ts.map

package/dist/hooks/magic-context/image-token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-token-estimate.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/image-token-estimate.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkClE;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAexE"}

package/dist/hooks/magic-context/inject-compartments.d.ts

@@ -0,0 +1,389 @@
+import { Buffer } from "node:buffer";
+import { type Compartment, type SessionFact } from "../../features/magic-context/compartment-storage";
+import type { Memory } from "../../features/magic-context/memory/types";
+import { type WorkspaceIdentitySet } from "../../features/magic-context/workspaces";
+import type { Database } from "../../shared/sqlite";
+import type { MessageLike } from "./tag-messages";
+export interface PreparedCompartmentInjection {
+    block: string;
+    compartmentEndMessage: number;
+    compartmentEndMessageId: string | null;
+    compartmentCount: number;
+    skippedVisibleMessages: number;
+    factCount: number;
+    memoryCount: number;
+    rebuiltFromDb: boolean;
+    /**
+     * Set when the injection stayed degraded (boundary not in the visible
+     * window) AND no durable compartment boundary is visible either, so no
+     * safe re-anchor splice exists. The transform queues a fresh
+     * materialization so the baseline is re-cut instead of silently looping
+     * (#264 layer-B fallback).
+     */
+    needsFreshMaterialization?: boolean;
+}
+export declare function clearInjectionCache(sessionId: string): void;
+export declare function resetDegradedReanchorState(sessionId: string): void;
+/**
+ * Return the set of memory ids currently rendered in the cached
+ * <session-history> block for this session, if any. Used by mmc_search
+ * to hard-filter memories the agent already sees in context — retrieving
+ * them from search wastes tokens and pushes high-signal raw-history hits
+ * further down the ranking.
+ *
+ * Returns null when no cache exists or the JSON payload is malformed
+ * (callers should treat null as "don't filter" — the worst case is a
+ * redundant memory result, not a correctness issue).
+ */
+export declare function getVisibleMemoryIds(db: Database, sessionId: string): Set<number> | null;
+export interface CompartmentInjectionResult {
+    injected: boolean;
+    prependedMessageCount: number;
+    compartmentEndMessage: number;
+    compartmentCount: number;
+    skippedVisibleMessages: number;
+}
+export declare function renderMemoryBlock(memories: Memory[]): string | null;
+/**
+ * The historian's `<project-memory>` block. Canonical form: category-grouped
+ * `- <fact>` lines WITHOUT memory ids, ordered by CATEGORY_PRIORITY (v2
+ * taxonomy first, then the legacy categories so pre-v2 rows remain visible);
+ * categories outside the priority list are not rendered.
+ *
+ * Why this differs from the agent-facing wire (`renderMemoryBlockV2`, which
+ * emits `#id: fact`): the historian system prompt uses this block only for
+ * content-based fact dedup ("scan <project_memory> and silently skip any fact
+ * that overlaps") and contradiction reporting — it never addresses a memory by
+ * id. Ids exist on the m0/m1 wire so the `<memory-updates>` corrections block
+ * can point at baseline lines (`<updated id="N">`, `<removed id="N">`); the
+ * historian has no such corrections mechanism, so ids would be noise. This
+ * block must emit this exact form.
+ */
+/**
+ * The memories `renderHistorianMemoryBlock` would show, in the order it shows
+ * them. Rendering any prefix of this list reproduces the first lines of the full
+ * block, so a caller that must shrink the block to fit a model window can drop
+ * the lowest-priority lines by taking a shorter prefix.
+ */
+export declare function orderHistorianMemories(memories: Memory[]): Memory[];
+export declare function renderHistorianMemoryBlock(memories: Memory[]): string | null;
+/**
+ * Sort memories by priority and trim to budget.
+ *
+ * Priority order:
+ *   1. permanent status first
+ *   2. utility tier (retrieved > constraint > other)
+ *   3. seen count descending
+ *   4. shorter content first (fit more memories in budget)
+ *   5. deterministic id tiebreaker for cache stability
+ *
+ * Uses the real Claude tokenizer (via estimateTokens) so the trim stays
+ * consistent with the rest of the plugin's token math — mismatching units
+ * (chars/4 here vs real tokens elsewhere) caused either under- or
+ * over-injection of memories, depending on memory content shape.
+ */
+export declare function trimMemoriesToBudget(sessionId: string, memories: Memory[], budgetTokens: number): Memory[];
+/**
+ * Return only rows between OpenCode's marker boundary and the in-memory trim
+ * boundary. filterCompacted requires a user marker row, so an assistant-ended
+ * compartment can temporarily re-expose the assistant suffix after that user.
+ */
+export declare function selectHiddenMessagesAtCompactionSeam(messagesBeforeTrim: MessageLike[], skippedVisibleMessages: number): MessageLike[];
+export declare function prepareCompartmentInjection(db: Database, sessionId: string, messages: MessageLike[], isCacheBusting: boolean, projectPath?: string, injectionBudgetTokens?: number, temporalAwareness?: boolean): PreparedCompartmentInjection | null;
+export declare function renderCompartmentInjection(sessionId: string, messages: MessageLike[], prepared: PreparedCompartmentInjection): CompartmentInjectionResult;
+export interface M0SnapshotMarkers {
+    projectMemoryEpoch: number;
+    workspaceFingerprint: string | null;
+    projectUserProfileVersion: number;
+    maxCompartmentSeq: number;
+    maxMemoryId: number;
+    maxMutationId: number;
+    maxMemoryMutationId: number;
+    projectDocsHash: string;
+    materializedAt: number;
+    sessionFactsVersion: number;
+    upgradeState: string | null;
+    compartmentRenderEpoch: string | null;
+    /** Records the renderer used by cached bytes; written on a natural HARD but never triggers one. */
+    memoryRenderEpoch: string | null;
+    systemHash: string;
+    toolSetHash: string;
+    modelKey: string;
+    projectIdentity?: string | null;
+    /** Hash of the image identity folded into this m0 baseline. */
+    muralHash?: string | null;
+    muralEnabled: boolean | null;
+    renderBudgetIdentity: string | null;
+    /** Numeric allowances used by the cached render; absent on older baselines. */
+    renderedBudgets?: string | null;
+}
+/**
+ * Runtime cache-eviction signals threaded into the materialization decision.
+ * These are NOT derived from durable DB state like the content markers — they
+ * come from the current flight (system-prompt hash, tool-set fingerprint,
+ * provider/model key) plus the TTL idle window. Tool-set changes are observed
+ * for attribution only; they never request a materialization.
+ */
+export interface M0HardSignals {
+    systemHash: string;
+    /** Empty or absent means the provider tool set is not observable this pass. */
+    toolSetHash?: string;
+    modelKey: string;
+    /** True when the provider cache TTL has elapsed since lastResponseTime. */
+    cacheExpired: boolean;
+    /** Epoch ms of the last completed assistant response (end-of-turn). */
+    lastResponseTime: number;
+    /**
+     * A native host compaction heading the live window, read from the messages
+     * the host served this pass before anything trimmed them. Absent when the
+     * window does not start with one.
+     */
+    hostCompaction?: HostCompactionWindow;
+}
+/**
+ * A native OpenCode compaction (`/compact` or automatic) heading the live window.
+ * OpenCode then serves [compaction request, summary, retained tail, newer rows]
+ * and stops loading everything older. Magic Context's own marker pair has the
+ * same shape and is never reported here.
+ */
+export interface HostCompactionWindow {
+    compactionMessageId: string;
+    summaryMessageId: string;
+    /** Epoch ms at which the host finished writing the summary. */
+    completedAt: number;
+}
+export interface M0M1State {
+    sessionId: string;
+    isSubagent?: boolean;
+    cachedM0Bytes: Buffer | null;
+    cachedM1Bytes: Buffer | null;
+    cachedM0ProjectMemoryEpoch: number | null;
+    cachedM0WorkspaceFingerprint: string | null;
+    cachedM0ProjectUserProfileVersion: number | null;
+    cachedM0MaxCompartmentSeq: number | null;
+    cachedM0MaxMemoryId: number | null;
+    cachedM0MaxMutationId: number | null;
+    cachedM0MaxMemoryMutationId: number | null;
+    cachedM0ProjectDocsHash: string | null;
+    cachedM0MaterializedAt: number | null;
+    cachedM0SessionFactsVersion: number | null;
+    cachedM0UpgradeState: string | null;
+    cachedM0SystemHash: string | null;
+    cachedM0ToolSetHash: string | null;
+    cachedM0ModelKey: string | null;
+    cachedM0ProjectIdentity?: string | null;
+    snapshotMarkers?: M0SnapshotMarkers | null;
+    /** Keep the persisted mural image unchanged for the current cached M0 prompt;
+     * replace it only when the next normal hard cache fold rebuilds that prompt. */
+    cachedM0MuralDataUrl?: string | null;
+    cachedM0MuralHash?: string | null;
+}
+export interface M0M1RenderOptions {
+    db: Database;
+    sessionId: string;
+    messages?: MessageLike[];
+    state: M0M1State;
+    projectPath?: string;
+    projectDirectory?: string;
+    /** Defaults true. When false, suppress every memory-derived m[0]/m[1] surface. */
+    memoryEnabled?: boolean;
+    memoryInjectionBudgetTokens?: number;
+    historyBudgetTokens?: number;
+    historyBudgetPolicyIdentity?: string;
+    temporalAwareness?: boolean;
+    isCacheBustingPass?: boolean;
+    /** Force/emergency may serve a fresh recovery prefix even if persistence loses contention. */
+    allowFreshContentionFallback?: boolean;
+    /** Exact off-wire prefix chosen before reduction gates; do not decide again at delivery. */
+    preparedPrefix?: InjectM0M1Result;
+    /** Preserve the original host message order so prefix trimming can still identify the boundary after replay or pruning removes rows. */
+    prefixTrimSourceOrder?: PrefixTrimSourceOrder;
+    /** Persisted pair captured before a fallible preflight. Contention may recover
+     * from it, but must not adopt a newer row written while the preflight ran. */
+    contentionFallbackPrefix?: InjectM0M1Result;
+    /**
+     * Compaction-off mode (issue #266): materialize through the
+     * zero-compartment path — memory/docs render into m[0], but
+     * historical compartment rows never reach `<session-history>` (no render,
+     * no raw-tail trim, no boundary splice, no marker write), and the
+     * isSubagent skip in injectM0M1 is lifted so subagent sessions receive
+     * the additive knowledge blocks too.
+     */
+    compactionOff?: boolean;
+    /** Provider-side cache-eviction signals for HARD-bust detection. */
+    hardSignals?: M0HardSignals;
+    workspaceIdentitySet?: WorkspaceIdentitySet;
+    beforePhase3ForTest?: () => void;
+    /**
+     * Runs inside the transaction that records a HARD fold, just before it
+     * commits (and again on each contention retry, whose earlier attempt rolled
+     * back). Writes that must land only together with an executed fold, such as
+     * converting legacy dropped-tool skeletons, go here. `rendered` carries the
+     * bytes this fold is about to persist, so the caller can tell whether the
+     * fold changes the served prefix or re-renders it byte-identically.
+     */
+    onFoldCommit?: (db: Database, rendered: {
+        m0Bytes: Buffer;
+        m1Bytes: Buffer;
+    }) => void;
+}
+export interface MaterializeDecision {
+    value: boolean;
+    reason: string | null;
+    /** Present only when the system-hash operands triggered this decision. */
+    systemHashPrev?: string;
+    systemHashNew?: string;
+    /** Present only when the canonical model-key operands triggered this decision. */
+    m0ModelKeyPrev?: string;
+    m0ModelKeyNew?: string;
+    /**
+     * Present when the decision site compared the cached and live tool-set
+     * fingerprints. These operands are observational: a difference never
+     * triggers materialization. A null previous value means the cached baseline
+     * had no recorded tool-set fingerprint yet.
+     */
+    m0ToolSetHashPrev?: string | null;
+    m0ToolSetHashNew?: string | null;
+}
+export interface MaterializeM0Result {
+    m0Bytes: Buffer;
+    m0Text: string;
+    m1Bytes: Buffer;
+    m1Text: string;
+    snapshotMarkers: M0SnapshotMarkers;
+    renderedMemoryIds: number[];
+}
+export type PrefixTrimStatus = "not-attempted" | "not-required" | "applied" | "boundary-precedes-window" | "refused";
+export interface PrefixTrimSourceOrder {
+    /** Stable IDs in the exact order supplied by the host before this transform mutates the array. */
+    messageIds: readonly string[];
+    /** ID-less synthetic users are valid only as one contiguous leading block. */
+    syntheticHeadCount: number;
+    invalidReason: string | null;
+}
+export interface InjectM0M1Result {
+    injected: boolean;
+    prependedMessageCount: number;
+    m0RematerializedThisPass: boolean;
+    materializationContentionRetryExhausted: boolean;
+    decision: MaterializeDecision;
+    m0Bytes: Buffer | null;
+    m1Text: string | null;
+    preparedMessages?: MessageLike[];
+    preparedTrimBoundaryId?: string | null;
+    prefixTrimStatus?: PrefixTrimStatus;
+}
+export declare class MaterializeContentionError extends Error {
+    readonly retries: number;
+    readonly reason: string;
+    constructor(args?: {
+        retries?: number;
+        reason?: string;
+    });
+}
+export declare class RenderM1InvalidMarkersError extends Error {
+    constructor(sessionId: string);
+}
+type M0Compartment = Compartment & {
+    startDate?: string | null;
+    endDate?: string | null;
+};
+export declare const DEFAULT_MEMORY_BUDGET_TOKENS = 8000;
+export interface WorkspaceRenderContext {
+    identities: string[];
+    expandedIdentities: string[];
+    ownIdentities: string[];
+    shareCategories: string[] | null;
+    namesByIdentity: Map<string, string>;
+    canonicalIdentityByStoredPath: Map<string, string>;
+    isWorkspaced: boolean;
+}
+export interface MemoryRenderOptions {
+    sourceNameByMemoryId?: ReadonlyMap<number, string>;
+}
+interface M0SnapshotMarkerReadArgs {
+    db: Database;
+    sessionId: string;
+    projectPath?: string;
+    /** False suppresses the memory surfaces for this render. */
+    memoryEnabled?: boolean;
+    memoryInjectionBudgetTokens?: number;
+    historyBudgetTokens?: number;
+    historyBudgetPolicyIdentity?: string;
+    hardSignals?: M0HardSignals;
+    workspaceIdentitySet?: WorkspaceIdentitySet;
+}
+/**
+ * Read the current marker set while keeping the steady-state decision to one query.
+ *
+ * Completeness is based on the values the full read observes, not writer heuristics:
+ * the probe reads project/global state, compartment sequence and legacy count,
+ * filtered memory and memory-mutation maxima, and the session m0-mutation maximum.
+ * Its workspace signatures include current membership, names, sharing policy,
+ * aliases, and every member epoch. Therefore historian publishes, all memory
+ * additions/mutations/classification changes, m0 mutations, epoch/profile bumps,
+ * membership transitions, alias writes, and legacy upgrades change at least one
+ * probe field. `sessionFactsVersion` is intentionally absent because its getter is
+ * pinned to zero and no longer renders. Project docs are intentionally absent too:
+ * edits join the next natural HARD fold rather than triggering one.
+ * A changed field falls through to the authoritative multi-read implementation.
+ */
+export declare function readCurrentM0SnapshotMarkers(args: M0SnapshotMarkerReadArgs): M0SnapshotMarkers;
+export declare function mustMaterialize(args: {
+    db: Database;
+    sessionId: string;
+    state: M0M1State;
+    projectPath?: string;
+    projectDirectory?: string;
+    hardSignals?: M0HardSignals;
+    workspaceIdentitySet?: WorkspaceIdentitySet;
+    /** False suppresses the profile and memory surfaces alongside project memory. */
+    memoryEnabled?: boolean;
+    memoryInjectionBudgetTokens?: number;
+    historyBudgetTokens?: number;
+    historyBudgetPolicyIdentity?: string;
+}): MaterializeDecision;
+export interface TrimMemoriesResultV2 {
+    selected: Memory[];
+    renderOrder: Memory[];
+}
+export declare function trimMemoriesToBudgetV2(sessionId: string, memories: Memory[], budgetTokens: number, renderOptions?: MemoryRenderOptions): TrimMemoriesResultV2;
+export declare function trimWorkspaceMemoriesToBudgetV2(sessionId: string, memories: Memory[], budgetTokens: number, workspace: WorkspaceRenderContext, renderOptions?: MemoryRenderOptions): TrimMemoriesResultV2;
+/** Render one compact memory fact line. Importance still controls selection, but
+ * is deliberately absent from the wire so classification-only updates do not change bytes. */
+export declare function renderMemoryLineV2(memory: Memory, sourceName?: string): string;
+export declare function renderMemoryBlockV2(memories: Memory[], wrapper?: string, renderOptions?: MemoryRenderOptions): string;
+/** Remove a stale mural reference when a legacy cached baseline has no paired image payload. */
+export declare function stripMemoryMuralBlock(m0Text: string): string;
+export declare function renderM0(args: {
+    compartments: M0Compartment[];
+    memories: Memory[];
+    facts: SessionFact[];
+    memoryRenderOptions?: MemoryRenderOptions;
+    historyBudgetTokens?: number;
+    decayPressureMultiplier?: number;
+    modelKey?: string;
+}): string;
+export declare function materializeM0(options: M0M1RenderOptions): MaterializeM0Result;
+export declare function materializeWithRetry(options: M0M1RenderOptions, maxRetries?: number): MaterializeM0Result;
+export declare function renderM1(options: M0M1RenderOptions, markers: M0SnapshotMarkers, renderedMemoryIds?: readonly number[]): string;
+export declare function resetPrefixTrimFallbackState(sessionId: string): void;
+/**
+ * Read a native host compaction off the head of the messages the host served,
+ * before anything in this pass trims them. `readMagicContextSummaryMessageId`
+ * returns the summary row of Magic Context's own marker, which has the same
+ * shape and is excluded along with any row carrying its placeholder text. It is
+ * only called when the head has that shape, so ordinary passes read nothing.
+ */
+export declare function findHostCompactionWindow(messages: readonly MessageLike[], readMagicContextSummaryMessageId: () => string | null): HostCompactionWindow | null;
+/**
+ * Freeze the host's source order before tag replay and tool pruning mutate the live array.
+ * The IDs are evidence only: delivery trims surviving live objects and never restores old parts.
+ */
+export declare function capturePrefixTrimSourceOrder(messages: readonly MessageLike[]): PrefixTrimSourceOrder;
+/** Capture a complete persisted pair and its boundary before a fallible preflight. */
+export declare function prepareCachedM0M1Replay(db: Database, sessionId: string): InjectM0M1Result | undefined;
+export declare function hasCompleteCachedM0M1(db: Database, sessionId: string): boolean;
+export declare function injectM0M1(options: M0M1RenderOptions): InjectM0M1Result;
+export {};
+//# sourceMappingURL=inject-compartments.d.ts.map

package/dist/hooks/magic-context/inject-compartments.d.ts.map

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

package/dist/hooks/magic-context/issue-135-wire-fixtures.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Captured openai-compat wire fixtures from issue #135 pinning harness.
+ * Source: scripts/experiments/issue-135-pinning-harness.ts (case 1c).
+ */
+import type { OpenAiCompatWireMessage } from "./openai-compat-adjacency";
+/** Known FAIL: [dropped] assistant between tool_calls and tool result. */
+export declare const ISSUE_135_ORPHAN_WIRE: OpenAiCompatWireMessage[];
+//# sourceMappingURL=issue-135-wire-fixtures.d.ts.map

package/dist/hooks/magic-context/issue-135-wire-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-135-wire-fixtures.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/issue-135-wire-fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,EAAE,uBAAuB,EAe1D,CAAC"}

package/dist/hooks/magic-context/issue-423-fixture.d.ts

@@ -0,0 +1,37 @@
+import type { RawMessage } from "./read-session-raw";
+import type { MessageLike } from "./tag-messages";
+/** One prompt followed by completed tool rounds, then one invocation still awaiting its result. */
+export declare function issue423Fixture(count?: number, firstOutputMultiplier?: number): {
+    pi: Record<string, unknown>[];
+    opencode: (MessageLike & {
+        info: {
+            id: string;
+            role: string;
+        };
+    })[];
+    raw: RawMessage[];
+    entries: {
+        type: string;
+        id: string;
+        message: Record<string, unknown>;
+    }[];
+    output: string;
+};
+/** Completed reasoning/tool rounds that expose same-role merge seams when an arc disappears. */
+export declare function issue423ReasoningFixture(count?: number): {
+    pi: Record<string, unknown>[];
+    opencode: (MessageLike & {
+        info: {
+            id: string;
+            role: string;
+        };
+    })[];
+    raw: RawMessage[];
+    entries: {
+        type: string;
+        id: string;
+        message: Record<string, unknown>;
+    }[];
+    output: string;
+};
+//# sourceMappingURL=issue-423-fixture.d.ts.map

package/dist/hooks/magic-context/issue-423-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-423-fixture.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/issue-423-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiFlD,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,KAAK,SAAM,EAAE,qBAAqB,SAAI;;;cAnEtB;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;;;;;;;;;EAwE3E;AAED,gGAAgG;AAChG,wBAAgB,wBAAwB,CAAC,KAAK,SAAK;;;cA3EH;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;;;;;;;;;EA6E3E"}

package/dist/hooks/magic-context/issue-424-fixture.d.ts

@@ -0,0 +1,11 @@
+import type { RawMessage } from "./read-session-raw";
+/** Parallel results finish in reverse order; selected batches insert a user message before their final result. */
+export declare function issue424Fixture(count?: number, firstOutputMultiplier?: number, seed?: number): {
+    raw: RawMessage[];
+    entries: {
+        type: string;
+        id: string;
+        message: Record<string, unknown>;
+    }[];
+};
+//# sourceMappingURL=issue-424-fixture.d.ts.map

package/dist/hooks/magic-context/issue-424-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-424-fixture.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/issue-424-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,KAAK,SAAM,EAAE,qBAAqB,SAAI,EAAE,IAAI,SAAI;;;;;;;EAuE/E"}

package/dist/hooks/magic-context/legacy-compartments.d.ts

@@ -0,0 +1,20 @@
+import type { Database } from "../../shared/sqlite";
+/**
+ * Detection of compartments written before the current (tiered) historian
+ * format. Such rows still render, only in the degraded title-only/P4 form, and
+ * a plain `/mmc-recomp` rebuilds them into the current shape.
+ */
+/** A compartment needs rebuilding when it lacks usable tiers — either a pre-v2
+ *  `legacy=1` row, OR a malformed "pseudo-v2" row flagged `legacy=0` but with no
+ *  `p1` tier (e.g. from an interrupted/crashed recomp, or an older partial-v2
+ *  build). The `legacy=0 ⟹ has tiers` invariant can break from any partial state,
+ *  so both shapes must count as "still old". */
+export declare const NEEDS_UPGRADE_SQL = "((title <> '' OR content <> '' OR COALESCE(p1, '') <> '' OR COALESCE(p2, '') <> '' OR COALESCE(p3, '') <> '' OR COALESCE(p4, '') <> '') AND (legacy = 1 OR p1 IS NULL OR p1 = ''))";
+/**
+ * Count compartments still written in the pre-tier format (pre-v2 `legacy=1`
+ * rows OR tierless `p1 IS NULL/''` rows from an interrupted/old partial build).
+ * Surfaced by the Pi `/mmc-status` dialog (Pi has no sidebar). Returns 0 on any
+ * error.
+ */
+export declare function countCompartmentsNeedingUpgrade(db: Database, sessionId: string): number;
+//# sourceMappingURL=legacy-compartments.d.ts.map

package/dist/hooks/magic-context/legacy-compartments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-compartments.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/legacy-compartments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AAEH;;;;gDAIgD;AAChD,eAAO,MAAM,iBAAiB,uLAA+E,CAAC;AAE9G;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWvF"}

package/dist/hooks/magic-context/live-session-state.d.ts

@@ -0,0 +1,68 @@
+import type { RecompProgress } from "./compartment-runner-types";
+import type { Channel1State } from "./ctx-reduce-nudge";
+import type { AgentBySession, LatestAssistantMessageIdBySession, LiveModelBySession, VariantBySession } from "./hook-handlers";
+/**
+ * Plugin-process-scoped shared state. Lives in `index.ts` and is threaded into
+ * every component that needs to share signals with the others (the magic-
+ * context hook, RPC handlers, command handlers, etc).
+ *
+ * The `*Sessions` sets are the cache-busting signal channels added in
+ * the Oracle 2026-04-26 review (replaces the old single `flushedSessions`).
+ * See `hook-handlers.ts` for the full lifetime/semantics doc-comment on
+ * each set, and `system-prompt-hash.ts` / `transform.ts` /
+ * `transform-postprocess-phase.ts` for the consumer drain points.
+ *
+ * Storing them here lets RPC-driven recomp (TUI command path) signal the
+ * same sets the hook-driven recomp (server `/mmc-recomp` path) signals.
+ * Without this, the TUI recomp publish would silently leave injection cache
+ * stale and the next defer pass would reuse old `<session-history>`.
+ */
+export interface LiveSessionState {
+    liveModelBySession: LiveModelBySession;
+    /** Tracks the greatest assistant message ID so older or id-less events cannot overwrite the live model. */
+    latestAssistantMessageIdBySession: LatestAssistantMessageIdBySession;
+    variantBySession: VariantBySession;
+    agentBySession: AgentBySession;
+    /** Cached U/T token measurement of each rendered conversation tail, shared with display RPCs. */
+    channel1StateBySession: Map<string, Channel1State>;
+    historyRefreshSessions: Set<string>;
+    deferredHistoryRefreshSessions: Set<string>;
+    systemPromptRefreshSessions: Set<string>;
+    pendingMaterializationSessions: Set<string>;
+    deferredMaterializationSessions: Set<string>;
+    /**
+     * Cache of resolved session.directory values from `client.session.get(...)`.
+     *
+     * The session→project binding is set at session create time and never
+     * changes (OpenCode source: `Session.directory` is read once from the
+     * session record, no migration path), so caching for the lifetime of the
+     * plugin process is safe. Without this, transform.ts hits OpenCode's
+     * local API on every transform pass — observed to be 1.5s+ for large
+     * sessions under Electron, accounting for the bulk of transform latency.
+     *
+     * Populated on first successful resolution; cleared on `session.deleted`.
+     */
+    sessionDirectoryBySession: Map<string, string>;
+    /**
+     * Live recomp progress, keyed by sessionId. Written by the recomp paths (via
+     * the runner's `onRecompProgress` callback plus their own terminal updates)
+     * and read by `buildSidebarSnapshot` so the TUI sidebar + /mmc-status can
+     * show a live progress bar. In-memory only — a process restart interrupts
+     * the recomp anyway.
+     */
+    recompProgressBySession: Map<string, RecompProgress>;
+    /**
+     * Sessions that are Magic Context's OWN hidden children (historian and
+     * dreamer). Detected at `session.created` by
+     * the `magic-context-` title prefix. These sessions are fully exempt from
+     * the message transform AND system-prompt injection — they have their own
+     * fixed agent identity/prompt, never use mmc_reduce/nudges/compartments,
+     * and getting the MC guidance block bolted on is wasted spend plus a
+     * contradictory second identity frame. In-memory only: these children are
+     * ephemeral (a process restart abandons any in-flight run), so the set
+     * never needs to survive a restart.
+     */
+    internalChildSessions: Set<string>;
+}
+export declare function createLiveSessionState(): LiveSessionState;
+//# sourceMappingURL=live-session-state.d.ts.map

package/dist/hooks/magic-context/live-session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session-state.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/live-session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACR,cAAc,EACd,iCAAiC,EACjC,kBAAkB,EAClB,gBAAgB,EACnB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,2GAA2G;IAC3G,iCAAiC,EAAE,iCAAiC,CAAC;IACrE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,iGAAiG;IACjG,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,8BAA8B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,+BAA+B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C;;;;;;;;;;;OAWG;IACH,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;;;;OAMG;IACH,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD;;;;;;;;;;OAUG;IACH,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAgBzD"}

package/dist/hooks/magic-context/lkg-persist.d.ts

@@ -0,0 +1,22 @@
+import type { Database } from "../../shared/sqlite";
+import type { LkgPersistenceBackend, LkgSlot } from "./lkg-slot";
+/** Parse a stored row into a slot; returns undefined (and reasons to delete) on any malformation. */
+export declare function parsePersistedLkgSlot(row: unknown): LkgSlot | undefined;
+/**
+ * Persist a slot for the session, replacing any prior row. Best-effort: callers
+ * treat a failure as "this process still has the in-memory slot" and log.
+ *
+ * Only the prefix slices whose hash differs from the stored slice's hash are
+ * written. Comparing against the stored hashes, not a hash this process
+ * remembers, keeps the first save after a restart and a save after another
+ * connection's save just as small and just as correct. The slices, the removal
+ * of slices past the new count, and the metadata row (with the count, length and
+ * hash a load verifies) commit in one transaction.
+ */
+export declare function saveLkgSlotToDb(db: Database, sessionId: string, slot: LkgSlot): boolean;
+export declare function clearPersistedLkgSlot(db: Database, sessionId: string): void;
+export declare function loadPersistedLkgSlot(db: Database, sessionId: string): LkgSlot | undefined;
+export declare function pruneStaleLkgSlots(db: Database, now?: number): number;
+/** Backend bound to one database handle, for registration with the slot store. */
+export declare function createDbLkgPersistence(db: Database): LkgPersistenceBackend;
+//# sourceMappingURL=lkg-persist.d.ts.map

package/dist/hooks/magic-context/lkg-persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lkg-persist.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/lkg-persist.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA+DjE,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAsFvE;AA6CD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CA0EvF;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAU3E;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAgDzF;AAgDD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,SAAa,GAAG,MAAM,CAEzE;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,GAAG,qBAAqB,CAK1E"}