@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/hooks/magic-context/protected-tail-boundary.d.ts

@@ -0,0 +1,234 @@
+import { sessionDecisionCalibration } from "../../features/magic-context/session-decision-calibration";
+import { type ProtectedTailMeta } from "../../features/magic-context/storage-meta-persisted";
+import type { Database } from "../../shared/sqlite";
+import { buildToolArcs, type TrueRawTokenIndex } from "./read-session-true-raw-tokens";
+export type BoundaryMode = "trigger" | "incremental-runner" | "transform-force" | "manual-full-recomp" | "manual-partial-recomp" | "manual-wrapup" | "pi-trigger" | "pi-runner";
+export interface BoundaryUsage {
+    percentage: number;
+    inputTokens: number;
+}
+export interface ResolvedBoundaryContext {
+    sessionId: string;
+    mode: BoundaryMode;
+    contextLimit: number;
+    executeThresholdPercentage: number;
+    triggerBudget: number;
+    usage: BoundaryUsage | null;
+    usageSource: "live" | "persisted" | "provisional-zero" | "manual-none";
+    lastCompartmentEndOrdinal: number;
+    lastCompartmentEndMessageId?: string | null;
+    priorBoundaryOrdinal: number;
+    protectedTailPolicyVersion: number;
+    migrationFloorActive: boolean;
+    emergencyTailScale?: 0.5 | 0.25;
+    providerShapeVersion: "opencode-v1" | "pi-folded-v1";
+    cacheNamespace: string;
+    createdAt?: number;
+    /**
+     * Durable per-message token totals (sum of the message's active tag
+     * token_counts), keyed by real message id. When present, the boundary's
+     * token index reads these instead of re-tokenizing the raw session — the
+     * restart-durable fast path. A message missing here (or with a NULL-count
+     * tag) falls back to live tokenization. Built once in resolveBoundaryContext
+     * from the tag store; omitted (→ all-live) when the caller has no tag store.
+     */
+    storedTokenTotals?: Map<string, number>;
+    calibration?: ReturnType<typeof sessionDecisionCalibration>;
+}
+export interface ProtectedTailBoundarySnapshot {
+    sessionId: string;
+    mode: BoundaryMode;
+    offset: number;
+    /** Latest compartment anchor observed with offset; present on production resolutions. */
+    lastCompartmentEndMessageId?: string | null;
+    offsetMessageId: string | null;
+    protectedTailStart: number;
+    protectedTailStartMessageId: string | null;
+    eligibleEndOrdinal: number;
+    eligibleEndMessageId: string | null;
+    rawMessageCountAtTrigger: number;
+    rawLastMessageIdAtTrigger: string | null;
+    N: number;
+    usagePercentage: number;
+    usageInputTokens: number;
+    usageSource: ResolvedBoundaryContext["usageSource"];
+    contextLimit: number;
+    executeThresholdPercentage: number;
+    triggerBudget: number;
+    priorBoundaryOrdinal: number;
+    migrationFloorActive: boolean;
+    emergencyTailScale?: 0.5 | 0.25;
+    providerShapeVersion: "opencode-v1" | "pi-folded-v1";
+    cacheNamespace: string;
+    createdAt: number;
+    rawRangeFingerprint: string;
+    trueRawEligibleTokens: number;
+    oversizeAtomicUnit: boolean;
+    boundaryReason: string;
+    /** Captured before drain reservation; historian runners log these diagnostics without rereading newer history. */
+    diagnostics?: BoundaryDiagnostics;
+}
+export interface BoundaryDiagnostics {
+    tailTarget: ProtectedTailTokenTarget;
+    usable: number;
+    usagePercentage: number;
+    N: number;
+    triggerBudget: number;
+    capTokens: number;
+    capTier: "normal" | "80" | "95";
+    drainBudget: "not-reserved; does-not-size-cap";
+    sizeWalkStart: number;
+    protectedTailStart: number;
+    livePromptFloor: {
+        ordinal: number | null;
+        from: number;
+        to: number;
+    };
+    head: HeadCapDiagnostics;
+}
+export interface HeadCapDiagnostics {
+    offset: number;
+    capEnd: number;
+    capTokenSum: number;
+    completedFence: {
+        from: number;
+        to: number;
+        arcs: Array<{
+            assistant: number;
+            result: number;
+        }>;
+        tokenMass: number;
+    };
+    oversizeAdmission: {
+        from: number;
+        to: number;
+    };
+    openArcClamp: {
+        from: number;
+        to: number;
+    };
+    completedRefence: HeadCapDiagnostics["completedFence"];
+    eligibleEnd: number;
+}
+export declare function describeBoundaryDiagnostics(snapshot: ProtectedTailBoundarySnapshot): string;
+export interface ProtectedTailTokenTarget {
+    usable: number;
+    rawN: number;
+    floorN: number;
+    ceilingN: number;
+    effectiveFloor: number;
+    N: number;
+    headroom: number;
+    triggerBudget: number;
+    reserve: number;
+}
+export interface RawHistoryEligibility {
+    lastCompartmentEnd: number;
+    offset: number;
+    rawMessageCount: number;
+    hasRawBeyondLastCompartment: boolean;
+}
+export interface ProactiveTriggerInfo {
+    boundary: ProtectedTailBoundarySnapshot;
+    hasProtectedEligibleHead: boolean;
+    trueRawEligibleTokens: number;
+    tcTokenEstimate: number;
+    messageCount: number;
+    commitClusterCount: number;
+    isMeaningful: boolean;
+}
+export interface BoundarySnapshotValidationResult {
+    ok: boolean;
+    reason?: "stale_snapshot" | "model_or_limit_changed";
+    detail?: string;
+}
+export interface WrapupBoundaryPlan {
+    snapshot: ProtectedTailBoundarySnapshot;
+    /** Raw messages (any role) after the last durable compartment, counted at command start. */
+    rawMessagesAboveLastCompartment: number;
+    /** Raw-message count used to anchor the keep watermark for the whole wrapup loop. */
+    anchorRawMessageCount: number;
+    /** First raw ordinal that remains protected by the keep watermark. */
+    targetProtectedTailStart: number;
+    /** Exclusive eligible end before per-run capping. */
+    targetEligibleEndOrdinal: number;
+}
+export declare const RECOVERY_NO_HEAD_LIMIT = 2;
+/** A tiny complete head is still worth summarizing at force pressure; below this, wait for a real arc/user turn. */
+export declare const MIN_FORCE_ELIGIBLE_TOKENS_CAP = 1000;
+export declare function deriveMinForceEligibleTokens(scaledN: number): number;
+export declare function deriveProtectedTailTokenTarget(args: {
+    contextLimit: number;
+    executeThresholdPercentage: number;
+    usagePercentage: number;
+    triggerBudget?: number;
+}): ProtectedTailTokenTarget;
+export declare function nonEmergencyPerRunCap(usable: number, N: number): number;
+export declare function force80PerRunCap(usable: number, N: number): number;
+export declare function force95PerRunCap(usable: number, N: number): number;
+export declare function selectPerRunCap(snapshot: Pick<ProtectedTailBoundarySnapshot, "usagePercentage" | "N" | "contextLimit" | "executeThresholdPercentage">): number;
+export declare function applyHeadCap(args: {
+    index: TrueRawTokenIndex;
+    protectedTailStart: number;
+    offset: number;
+    arcs: ReturnType<typeof buildToolArcs>;
+    lastCompartmentEndOrdinal: number;
+    capTokens: number;
+    recentOpenArcCutoff: number;
+    observeDiagnostics?: (diagnostics: HeadCapDiagnostics) => void;
+}): {
+    eligibleEndOrdinal: number;
+    oversizeAtomicUnit: boolean;
+};
+export declare function resolveProtectedTailBoundary(ctx: ResolvedBoundaryContext): ProtectedTailBoundarySnapshot;
+export declare function resolveBoundaryContext(args: {
+    db: Database;
+    sessionId: string;
+    mode: BoundaryMode;
+    contextLimit: number;
+    executeThresholdPercentage: number;
+    usage?: BoundaryUsage | null;
+    usageSource?: ResolvedBoundaryContext["usageSource"];
+    emergencyTailScale?: 0.5 | 0.25;
+    providerShapeVersion?: "opencode-v1" | "pi-folded-v1";
+    cacheNamespace?: string;
+    /**
+     * Tagger load-scoping floor (OpenCode only). When > 0, the stored-token map
+     * is loaded only for tags at/above this floor (the live wire) instead of
+     * scanning the whole session's tags (~100k rows → ~50ms every pass). The
+     * boundary only indexes the live slice (all >= floor), and any slice message
+     * the scoped map misses degrades to live tokenization of the same content,
+     * so the cut point is byte-identical. Omit / 0 = full scan (Pi, recomp,
+     * tests) — unchanged.
+     */
+    taggerFloor?: number;
+    /** Pass-owned session_meta values; refreshed by the caller on the next pass. */
+    protectedTailMeta?: Pick<ProtectedTailMeta, "priorBoundaryOrdinal" | "protectedTailPolicyVersion">;
+    /**
+     * Pi trigger path only (plan 08 W3/D3): exclude tool-type tags from the
+     * stored-token map so a completed tool arc is not counted twice (stored
+     * total keyed to the wire-owner assistant entry + live estimate on the
+     * synth-user ordinal holding the same result). After the raw-projection
+     * arc merge (R1) the owner row IS the projection ordinal (results
+     * inline), so exclude on/off are equivalent — kept as regression
+     * protection. Default off; OpenCode's stored total stays exact.
+     */
+    storedTotalsExcludeToolTags?: boolean;
+}): ResolvedBoundaryContext;
+export declare function resolveOpenCodeProtectedTailBoundary(args: Parameters<typeof resolveBoundaryContext>[0]): ProtectedTailBoundarySnapshot;
+export declare function resolveWrapupProtectedTailBoundary(args: Parameters<typeof resolveBoundaryContext>[0] & {
+    messagesToKeep: number;
+    anchorRawMessageCount?: number;
+}): WrapupBoundaryPlan;
+export declare function getRawHistoryEligibility(db: Database, sessionId: string): RawHistoryEligibility;
+export declare function hasProtectedEligibleHead(snapshot: ProtectedTailBoundarySnapshot): boolean;
+export declare function hasRunnableCompartmentWindow(snapshot: ProtectedTailBoundarySnapshot): boolean;
+export declare function validateBoundarySnapshot(args: {
+    db: Database;
+    snapshot: ProtectedTailBoundarySnapshot;
+    currentContextLimit?: number;
+}): BoundarySnapshotValidationResult;
+export declare function recordHighPressureNoEligibleHead(db: Database, snapshot: ProtectedTailBoundarySnapshot): number;
+export declare function resetHighPressureNoEligibleHead(db: Database, sessionId: string): void;
+export declare function createDefaultBoundarySnapshotForTests(sessionId: string): ProtectedTailBoundarySnapshot;
+//# sourceMappingURL=protected-tail-boundary.d.ts.map

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

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

package/dist/hooks/magic-context/raw-fallback-context-limit.d.ts

@@ -0,0 +1,10 @@
+export declare class RawFallbackContextLimitError extends Error {
+    readonly estimatedTokens: number;
+    readonly contextLimitTokens: number;
+    readonly code = "RAW_FALLBACK_CONTEXT_LIMIT";
+    readonly recoverable = true;
+    constructor(estimatedTokens: number, contextLimitTokens: number, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=raw-fallback-context-limit.d.ts.map

package/dist/hooks/magic-context/raw-fallback-context-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-fallback-context-limit.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/raw-fallback-context-limit.ts"],"names":[],"mappings":"AAEA,qBAAa,4BAA6B,SAAQ,KAAK;IAK/C,QAAQ,CAAC,eAAe,EAAE,MAAM;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM;IALvC,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,QAAQ,CAAC,WAAW,QAAQ;gBAGf,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EACnC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOpC"}

package/dist/hooks/magic-context/read-session-chunk.d.ts

@@ -0,0 +1,271 @@
+import type { ToolExpansionMap } from "../../shared/historian-tool-template";
+import type { Database } from "../../shared/sqlite";
+import { type SessionChunkLine } from "./read-session-formatting";
+import { type RawMessage, type RawMessageOrdinalAnchor, type RawMessageOrdinalEntry, type RawMessageParts } from "./read-session-raw";
+export { extractTexts, hasMeaningfulUserText } from "./read-session-formatting";
+/**
+ * Per-session source override for raw message reading.
+ *
+ * The default implementation of `readRawSessionMessages(sessionId)` reads
+ * from OpenCode's session DB via `withReadOnlySessionDb`. Other harnesses
+ * (e.g. Pi) provide their session data through a different surface
+ * (`pi.sessionManager.getBranch()`), so they register a per-session
+ * provider here BEFORE invoking any code path that calls the shared
+ * `readRawSessionMessages` / `getRawSessionMessageCount` /
+ * `getProtectedTailStartOrdinal` / `readSessionChunk` helpers.
+ *
+ * The registry is lookup-by-sessionId: a registered provider takes
+ * precedence over the OpenCode-DB default. Sessions never registered
+ * here continue to read from OpenCode's DB (existing behavior).
+ *
+ * Lifecycle: providers should be registered for the duration of one
+ * historian/trigger evaluation and unregistered afterward to avoid
+ * leaking session state across unrelated plugin instances. The
+ * `withSessionMessageProvider` helper enforces this by wrapping a
+ * scope.
+ */
+export interface RawMessageProvider {
+    readMessages(): RawMessage[];
+    readMessagePage?: (afterOrdinal: number, limit: number, finalWatermark: number, after?: RawMessageOrdinalAnchor) => RawMessage[];
+    /** A single source traversal; iterator cleanup must release resources on early exit. */
+    iterateMessageRange?: (fromOrdinal: number, toOrdinal: number) => Iterable<RawMessage>;
+    readMessageById?: (messageId: string) => RawMessage | null;
+    readMessagePartsById?: (messageId: string) => RawMessageParts | null;
+    hasMessageById?: (messageId: string) => boolean;
+    readMessageOrdinalById?: (messageId: string) => number | null;
+    readMessageIdOrdinals?: () => Map<string, number>;
+    readMessageIdOrdinalsForRange?: (fromOrdinal: number, toOrdinal: number) => Map<string, number>;
+    readMessageOrdinalPage?: (after: RawMessageOrdinalAnchor | null, limit: number) => RawMessageOrdinalEntry[];
+    /** Optional fast count path; falls back to readMessages().length. */
+    getMessageCount?: () => number;
+    /** Stored row count including compaction summaries, used for ordinal drift detection. */
+    getStoredMessageCount?: () => number;
+    /**
+     * Id of the row a request carries in place of a stored compartment boundary.
+     * Only hosts that store rows they never serve by id implement it; null means
+     * keep the stored id.
+     */
+    readServedBoundaryId?: (messageId: string) => string | null;
+}
+/**
+ * Provider contract for OpenCode 2 context passes. Every operation is SQL-bounded;
+ * the all-history conversion read is intentionally absent from this interface.
+ */
+export interface BoundedRawMessageProvider {
+    readMessagePage(afterOrdinal: number, limit: number, finalWatermark: number, after?: RawMessageOrdinalAnchor): RawMessage[];
+    readMessageById(messageId: string): RawMessage | null;
+    readMessagePartsById(messageId: string): RawMessageParts | null;
+    hasMessageById(messageId: string): boolean;
+    readMessageOrdinalById(messageId: string): number | null;
+    readMessageIdOrdinalsForRange(fromOrdinal: number, toOrdinal: number): Map<string, number>;
+    readMessageOrdinalPage(after: RawMessageOrdinalAnchor | null, limit: number): RawMessageOrdinalEntry[];
+    getMessageCount(): number;
+    getStoredMessageCount(): number;
+    readServedBoundaryId?: (messageId: string) => string | null;
+}
+/**
+ * Map a stored compartment boundary id to the message id a request actually
+ * carries for it. Identity for every host whose raw rows are all served by id.
+ */
+export declare function resolveHostServedBoundaryId(sessionId: string, messageId: string): string;
+/** Whether this session has an explicit non-OpenCode raw-history source. */
+export declare function hasRawMessageProvider(sessionId: string): boolean;
+/**
+ * Register a per-session source for raw message reading. Returns an
+ * unregister function. Pass-through harnesses (OpenCode) never call
+ * this; only Pi/future harnesses install themselves before triggering
+ * historian.
+ */
+export declare function setRawMessageProvider(sessionId: string, provider: RawMessageProvider): () => void;
+export declare function setBoundedRawMessageProvider(sessionId: string, provider: BoundedRawMessageProvider): () => void;
+/**
+ * Run `fn` with a temporary per-session provider override. Cleans up
+ * on return regardless of throw — preferred over manual
+ * `setRawMessageProvider` / `cleanup()` pairs.
+ *
+ * ASYNC-SAFE: if `fn` returns a promise, cleanup is deferred until that promise
+ * settles, so the provider stays registered for the WHOLE async scope. A bare
+ * synchronous `finally` would unregister at `fn`'s FIRST `await` (the function
+ * returns a pending promise immediately), leaving later awaited reads —
+ * e.g. Pi's awaited publication drop-queue traversal — with no
+ * provider, so they fall through to OpenCode's session DB. For a Pi session
+ * that DB is the wrong source (empty), and on a Pi-only install it does not
+ * exist at all, throwing `unable to open database file`.
+ */
+export declare function withRawMessageProvider<T>(sessionId: string, provider: RawMessageProvider, fn: () => T): T;
+/** Strip system-reminder blocks and OMO markers from user text for chunk compaction. */
+export declare function cleanUserText(text: string): string;
+export interface SessionChunk {
+    startIndex: number;
+    endIndex: number;
+    startMessageId: string;
+    endMessageId: string;
+    messageCount: number;
+    tokenEstimate: number;
+    /**
+     * Observation-only side axis: `tokenEstimate` counts the TC-chunked form
+     * (tool-result bodies collapsed to one-line summaries); this adds the
+     * omitted tool-result body tokens back for a raw-size approximation of the
+     * same range. Pure bypass accumulation — never feeds chunk budget,
+     * boundary, or truncation decisions.
+     */
+    rawTokenEstimate: number;
+    /** The formatted chunk exceeds its budget and contains completed tool arcs; do not clip its text afterward. */
+    oversizeAtomicUnit?: boolean;
+    hasMore: boolean;
+    text: string;
+    lines: SessionChunkLine[];
+    /** Raw rows positively excluded by the reader when the entire chunk has no content. */
+    filteredNoiseLines?: SessionChunkLine[];
+    /** Number of distinct commit clusters — assistant blocks with commits separated by meaningful user turns */
+    commitClusterCount: number;
+    /**
+     * Contiguous ranges of raw message ordinals whose visible chunk content was
+     * tool-only (TC: lines, no narrative text). Historian frequently skips such
+     * ranges entirely — that's safe, so validation absorbs gaps that fall fully
+     * within these ranges regardless of size. Gaps outside these ranges still
+     * fail validation and trigger a repair retry.
+     */
+    toolOnlyRanges: Array<{
+        start: number;
+        end: number;
+    }>;
+    /** Completed call/result ranges visible in the raw snapshot, including results past this chunk. */
+    completedToolArcs: Array<{
+        start: number;
+        end: number;
+    }>;
+    /** Character boundaries for omitted tool-result bodies, used only by pathological window fitting. */
+    toolResultBoundaries?: Array<{
+        ordinal: number;
+        sourceOffset: number;
+        bodyTokens: number;
+    }>;
+}
+export declare function withRawSessionMessageCache<T>(fn: () => T): T;
+export declare function readRawSessionMessages(sessionId: string): RawMessage[];
+export declare namespace readRawSessionMessages {
+    var readPage: typeof readRawSessionMessagePage;
+    var getCount: typeof getRawSessionMessageOrdinalCount;
+}
+export declare function readRawSessionMessagePage(sessionId: string, afterOrdinal: number, limit: number, finalWatermark: number, after?: RawMessageOrdinalAnchor): RawMessage[];
+export declare function getRawSessionMessageOrdinalCount(sessionId: string): number;
+/** Messages per page for the streaming visitors below. */
+export declare const RAW_MESSAGE_VISIT_PAGE_SIZE = 50;
+/**
+ * Visit the messages in [fromOrdinal, toOrdinal] in order, one bounded page at a
+ * time, until `visit` returns false. Memory stays at one page whatever the
+ * session or range size, unlike reading the range into one array.
+ *
+ * `summary: true` reads OpenCode's store through the summary projection: text
+ * parts (cut to a bounded length) and tool parts reduced to what a `TC:` line
+ * shows, with outputs, metadata, reasoning, and file payloads left in SQLite.
+ * A registered provider (Pi) serves its own parts unchanged.
+ */
+export declare function visitRawSessionMessages(sessionId: string, fromOrdinal: number, toOrdinal: number, visit: (message: RawMessage) => boolean, options?: {
+    summary?: boolean;
+    pageSize?: number;
+}): void;
+/** Read the requested absolute-ordinal interval from cache and source as needed. */
+export declare function readRawSessionMessageRange(sessionId: string, fromOrdinal: number, toOrdinal: number): RawMessage[];
+/**
+ * Prime the active raw-message cache with a TAIL-ONLY read (only messages
+ * at/after the last compartment boundary), so subsequent bounded reads inside
+ * that interval reuse it instead of reading the whole session.
+ *
+ * This is the O(tail) path: the compartment-trigger boundary resolution is
+ * offset-forward only (its candidate / suffix / range / head-cap / chunk-scan
+ * reads never cross below `baseOrdinal+1`), and the absolute message count it
+ * needs is recovered from the tail reader (`baseOrdinal + tail`), NOT from
+ * counting pre-boundary rows. On a months-long session the full read grows
+ * O(session); this stays flat at the tail size.
+ *
+ * The cached array carries ABSOLUTE ordinals (`baseOrdinal+1 …`) so every
+ * downstream absolute-ordinal computation matches the full read; the true total
+ * is stashed in the parallel absolute-count cache for `.length`-style consumers.
+ *
+ * No-op (returns false) when the active provider cannot page and count, no
+ * OpenCode DB exists, the cache is already populated, or no usable boundary
+ * anchor exists (e.g. no compartments, or the anchor message was deleted) — in
+ * which case the caller falls through to the source read.
+ */
+export declare function primeTailRawMessageCache(args: {
+    sessionId: string;
+    lastCompartmentEnd: number;
+    anchorMessageId: string | null;
+}): boolean;
+/**
+ * Absolute session message count for the active scope. Returns the tail-prime's
+ * stashed absolute count when a tail slice is cached; otherwise null, signalling
+ * callers to use `readRawSessionMessages(sessionId).length` (whole-session
+ * array) as before.
+ */
+export declare function getCachedAbsoluteMessageCount(sessionId: string): number | null;
+/**
+ * Prime the active raw-message cache with an IN-MEMORY tail built from the
+ * transform's `args.messages` — no opencode.db read at all. This is the hot-path
+ * goal: the transform already receives the post-marker tail (the eligible
+ * window) as parsed objects, so the boundary resolver can consume it directly.
+ *
+ * The caller supplies the already-converted absolute-ordinal `RawMessage[]` (via
+ * `buildInMemoryTailRawMessages`) plus its absolute count. Same scope/lifecycle
+ * rules as the other prime helpers: only inside a `withRawSessionMessageCache`
+ * scope and a no-op if the cache is already populated for the session. The supplied
+ * transform tail is authoritative even when the OpenCode 2 adapter has registered a
+ * bounded provider; Pi callers do not supply this OpenCode-specific tail shape.
+ *
+ * Returns true when it primed the cache.
+ */
+export declare function primeInMemoryTailRawMessageCache(args: {
+    sessionId: string;
+    messages: RawMessage[];
+    absoluteMessageCount: number;
+}): boolean;
+export declare function readRawSessionMessageOrdinalPage(sessionId: string, after: RawMessageOrdinalAnchor | null, limit: number): RawMessageOrdinalEntry[];
+export declare function getRawSessionStoredMessageCount(sessionId: string): number;
+export declare function readRawSessionMessageIdOrdinalsForRange(sessionId: string, fromOrdinal: number, toOrdinal: number): Map<string, number>;
+export declare function readRawSessionMessageIdOrdinals(sessionId: string): Map<string, number>;
+export declare function readRawSessionMessagePartsById(sessionId: string, messageId: string, onQuery?: () => void): RawMessageParts | null;
+export declare function hasRawSessionMessageById(sessionId: string, messageId: string): boolean;
+export declare function readRawSessionMessageOrdinalById(sessionId: string, messageId: string): number | null;
+/**
+ * Compare two messages' positions in the session's persisted order without
+ * reading the rest of the session: negative when `leftId` comes first, positive
+ * when it comes after, 0 when they are the same row, null when either row is
+ * unknown here.
+ *
+ * OpenCode's store is compared on (time_created, id), the order raw-message
+ * ordinals are numbered in, with two primary-key lookups. A registered provider
+ * is compared by ordinal only when it can look one up by id directly; any other
+ * provider answers null rather than falling back to a whole-history read.
+ */
+export declare function compareRawSessionMessageOrder(sessionId: string, leftId: string, rightId: string): number | null;
+export declare function readRawSessionMessageById(sessionId: string, messageId: string): RawMessage | null;
+export declare function getRawSessionMessageCount(sessionId: string): number;
+/**
+ * Raw-session keys observed through a compartment boundary. Message and file
+ * content IDs are session-unique. Tool observations retain both call ID and the
+ * FIFO-paired invocation owner so reused call IDs remain distinct.
+ */
+export interface RawSessionTagKeys {
+    messageFileKeys: Set<string>;
+    toolObservations: Map<string, Set<string>>;
+}
+export interface RawSessionTagKeyReadOptions {
+    db?: Database;
+    pageSize?: number;
+    /** First raw ordinal whose tags can become newly compartmentalized. */
+    fromMessageIndex?: number;
+    yieldToEventLoop?: () => Promise<void>;
+}
+export declare const RAW_SESSION_TAG_KEY_PAGE_SIZE = 32;
+export declare function getRawSessionTagKeysThrough(sessionId: string, upToMessageIndex: number, options?: RawSessionTagKeyReadOptions): Promise<RawSessionTagKeys>;
+export declare function getLegacyProtectedTailStartOrdinal(sessionId: string): number;
+export declare function getProtectedTailStartOrdinal(sessionId: string): number;
+export declare function readSessionChunk(sessionId: string, tokenBudget: number, offset?: number, eligibleEndOrdinal?: number, options?: {
+    expandTools?: ToolExpansionMap;
+    expand?: boolean;
+}): SessionChunk;
+export declare function getRawSessionMessageIdsThrough(sessionId: string, endOrdinal: number): string[];
+export declare function readRawSessionSeedTail(sessionId: string, boundaryId: string | null, onQuery?: () => void): Map<string, RawMessage>;
+//# sourceMappingURL=read-session-chunk.d.ts.map

package/dist/hooks/magic-context/read-session-chunk.d.ts.map

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

package/dist/hooks/magic-context/read-session-db.d.ts

@@ -0,0 +1,66 @@
+import { Database } from "../../shared/sqlite";
+export interface LatestPersistedMessage {
+    id: string;
+    role: string;
+    parentID?: string;
+    completedAt?: number;
+    error?: unknown;
+}
+/**
+ * Whether this process may read the OpenCode session database and it exists.
+ * A Pi or OMP process never reads OpenCode's store (see harnessOwnsOpenCodeStore),
+ * so it reports the store as absent there, exactly as on a Pi-only install.
+ */
+export declare function openCodeDbExists(): boolean;
+export declare function withReadOnlySessionDb<T>(fn: (db: Database) => T): T;
+export declare function closeReadOnlySessionDb(): void;
+export declare function getRawSessionMessageCountFromDb(db: Database, sessionId: string): number;
+interface TurnStateMessage {
+    info: Record<string, unknown>;
+    parts: readonly unknown[];
+}
+/** Return whether the latest assistant is still waiting for local tool execution. */
+export declare function assistantAwaitingToolsFromMessages(messages: readonly TurnStateMessage[]): boolean;
+/** Apply the notice-hold predicate to an in-memory OpenCode message array. */
+export declare function shouldHoldIgnoredNotificationFromMessages(messages: readonly TurnStateMessage[]): boolean;
+/** Track OpenCode events so turn-state checks work when no message array is directly available. */
+export declare function observeOpenCodeTurnEvent(type: string, properties: unknown): void;
+export declare function clearTrackedOpenCodeSession(sessionId: string): void;
+export declare function assistantAwaitingTools(_deps: unknown, sessionId: string): boolean;
+export declare const __openCodeTurnStateTest: {
+    retainedPartBytes(): number;
+    reset(): void;
+    setLogObserver(observer: (message: string) => void): void;
+};
+/**
+ * Whether a noReply/ignored status notice must be held instead of appended.
+ *
+ * `assistantAwaitingTools` only covers an assistant waiting on tools, and it releases
+ * when a newer real user message exists. Notices require a stronger guard:
+ * OpenCode's MessageV2.latest is role-based and does not skip
+ * ignored rows, so a notice that becomes the newest user row while a run
+ * is starting or in flight makes the loop-exit parentID check fail and
+ * can fire a phantom generation. Hold whenever a run is in flight or an
+ * unanswered real user prompt exists.
+ */
+export declare function shouldHoldIgnoredNotificationFromOpenCodeDb(db: Database, sessionId: string): boolean;
+export declare function shouldHoldIgnoredNotification(sessionId: string): boolean;
+export declare function assistantAwaitingToolsFromOpenCodeDb(db: Database, sessionId: string): boolean;
+export declare function latestPersistedMessageForRecovery(sessionId: string): LatestPersistedMessage | null;
+export declare function hasNewerRealUserMessage(db: Database, sessionId: string, latestAssistantTimeCreated: unknown): boolean;
+/**
+ * Resolve `time_created` (ms since epoch) for a set of OpenCode message IDs.
+ * Returns a Map keyed by message ID. Missing IDs are simply omitted.
+ *
+ * Used by temporal-awareness to map compartment start/end message IDs to
+ * wall-clock dates for `## start-end · date · title` headings in
+ * `<session-history>`.
+ */
+export declare function getMessageTimesFromOpenCodeDb(sessionId: string, messageIds: readonly string[]): Map<string, number>;
+export declare function findLastAssistantModelFromOpenCodeDb(sessionId: string): {
+    providerID: string;
+    modelID: string;
+    agent?: string;
+} | null;
+export {};
+//# sourceMappingURL=read-session-db.d.ts.map

package/dist/hooks/magic-context/read-session-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session-db.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/read-session-db.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AA0B/C,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAgDD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,CAEnE;AAGD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYvF;AAED,UAAU,gBAAgB;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CAC7B;AAuED,qFAAqF;AACrF,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAYjG;AAED,8EAA8E;AAC9E,wBAAgB,yCAAyC,CACrD,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACtC,OAAO,CAYT;AAkDD,mGAAmG;AACnG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CA4EhF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGnE;AAsBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAWjF;AAED,eAAO,MAAM,uBAAuB;yBACX,MAAM;aAUlB,IAAI;6BAKY,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAG5D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,2CAA2C,CACvD,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAClB,OAAO,CAKT;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAexE;AAED,wBAAgB,oCAAoC,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAwB7F;AAED,wBAAgB,iCAAiC,CAC7C,SAAS,EAAE,MAAM,GAClB,sBAAsB,GAAG,IAAI,CA8B/B;AAED,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,0BAA0B,EAAE,OAAO,GACpC,OAAO,CAuCT;AAkDD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CACzC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrB;AAED,wBAAgB,oCAAoC,CAChD,SAAS,EAAE,MAAM,GAClB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2EhE"}