@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/hooks/magic-context/system-prompt-hash.d.ts

@@ -0,0 +1,129 @@
+import { type ContextDatabase } from "../../features/magic-context/storage";
+import type { PluginContext } from "../../plugin/types";
+import type { PromptSurfaceConfig } from "../../shared/prompt-surface";
+import type { PromptSurfaceRuntime } from "../../shared/prompt-surface-runtime";
+/**
+ * Clear all per-session cache entries the system-prompt handler maintains,
+ * including the module-scope key-files maps and the per-handler
+ * sticky-date/cached-docs maps (the latter passed in via the cleanup handle).
+ * Called from the session-deleted event path.
+ */
+export declare function clearSystemPromptHashSession(sessionId: string, handleMaps: {
+    stickyDateBySession: Map<string, string>;
+    cachedDocsBySession: Map<string, string | null>;
+}): void;
+/**
+ * Detect Magic Context's OWN hidden child agents by their system-prompt
+ * openers. These children (historian/dreamer) load a fixed agent identity and
+ * must NOT receive the MC guidance block — it's wasted spend and a
+ * contradictory second identity frame ("You are Historian…" plus "You are the
+ * user's long-term partner…").
+ *
+ * This is the timing-independent companion to the `internalChildSessions` flag:
+ * the flag is set at `session.created` (may race the very first system.transform
+ * by event-delivery latency), whereas this signature is present in the prompt
+ * content on pass 1 with zero timing dependency.
+ *
+ * Literal substrings (not fuzzy) so an upstream prompt edit fails open (resumes
+ * injection) rather than silently mis-detecting.
+ */
+export declare function isMagicContextInternalAgent(systemPromptContent: string): boolean;
+/**
+ * Handle system prompt via experimental.chat.system.transform:
+ *
+ * 1. Inject generic magic-context guidance into the system prompt.
+ *    Skips injection if guidance is already present (e.g., baked into the
+ *    agent prompt by oh-my-opencode).
+ *
+ * 2. Detect system-prompt content or prompt-surface preset changes for
+ *    cache-flush triggering. The hash transition is the semantic boundary at
+ *    which queued operations can ride the same HARD fold.
+ */
+export declare function createSystemPromptHashHandler(deps: {
+    db: ContextDatabase;
+    /** When false (`memory.enabled: false`), the `<project-memory>` block is
+     *  never injected, so mmc_memory guidance is dropped from the prompt and the
+     *  mmc_memory tool is not registered. mmc_search guidance stays (it still
+     *  recalls conversation + git commits). Default true. */
+    memoryEnabled?: boolean;
+    /** Optional language from user config for the main agent's generated text. */
+    language?: string;
+    promptSurface?: PromptSurfaceConfig;
+    promptSurfaceRuntime?: PromptSurfaceRuntime;
+    /** Recover the session's latest model when the transform input omits it. */
+    resolveModel?: (sessionId: string) => {
+        providerID: string;
+        modelID: string;
+    } | undefined;
+    /**
+     * One-shot signal that disk-backed adjuncts (user profile, key files,
+     * sticky date) need to be re-read on this pass.
+     * Drained at the end of the handler regardless of whether anything
+     * actually refreshed — defer passes after this point MUST hit cached
+     * values to keep the system prompt cache-stable.
+     */
+    systemPromptRefreshSessions: Set<string>;
+    /**
+     * Producer side: when this handler detects a real prompt-content or
+     * prompt-surface-preset hash change, it adds the session to all three sets
+     * so downstream consumers
+     * (transform `prepareCompartmentInjection`, postprocess heuristics)
+     * react on the same cycle. The hash change usually pairs with a new
+     * agent identity, so all three are appropriate.
+     */
+    historyRefreshSessions: Set<string>;
+    pendingMaterializationSessions: Set<string>;
+    lastHeuristicsTurnId: Map<string, string>;
+    /**
+     * Issue #53: when false, Magic Context skips ALL system-prompt injection
+     * for ALL agents. Global escape hatch for users who don't want Magic
+     * Context guidance / sticky date touching the system prompt. (default: true)
+     */
+    injectionEnabled?: boolean;
+    /**
+     * Issue #53: per-agent opt-out. If the agent's system prompt contains
+     * any of these substrings, skip ALL injection for this call. Lets users
+     * mark specific custom agents (e.g. read-only QA agents that deny our
+     * `mmc_*` tools) as no-injection without having to disable injection
+     * globally.
+     */
+    injectionSkipSignatures?: string[];
+    /**
+     * Process-scoped set of Magic Context's OWN hidden child sessions
+     * (historian/dreamer), flagged by title prefix at
+     * `session.created`. When the active session is in this set we skip ALL
+     * injection — these children have their own fixed agent identity/prompt and
+     * never benefit from the MC guidance block. Belt to the prompt-signature
+     * detection below (which is the pass-1 timing-independent suspenders).
+     */
+    internalChildSessions?: Set<string>;
+    /** @deprecated key files now render in m[1], not system prompt. */
+    experimentalPinKeyFiles?: boolean;
+    /** @deprecated key files now render in m[1], not system prompt. */
+    experimentalPinKeyFilesTokenBudget?: number;
+    /** When true, add a temporal-awareness guidance paragraph + surface compartment dates */
+    experimentalTemporalAwareness?: boolean;
+    /**
+     * OpenCode SDK client used to read the agent and session permissions for
+     * mmc_reduce before the verdict freezes. OpenCode can run this hook before
+     * the messages transform, so this hook may be the one that freezes it.
+     * Absent (tests, hosts without the SDK): the verdict freezes from the
+     * tools map alone, as before permissions were considered.
+     */
+    client?: PluginContext["client"];
+    /** When true, inject a "BEWARE: history compression is on" warning so the
+     *  agent doesn't mimic its own caveman-compressed past output. */
+    experimentalCavemanTextCompression?: boolean;
+}): {
+    handler: (input: {
+        sessionID?: string;
+        model?: {
+            providerID?: string;
+            modelID?: string;
+        };
+    }, output: {
+        system: string[];
+    }) => Promise<void>;
+    clearSession: (sessionId: string) => void;
+};
+//# sourceMappingURL=system-prompt-hash.d.ts.map

package/dist/hooks/magic-context/system-prompt-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-hash.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/system-prompt-hash.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAqBhF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE;IACR,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACnD,GACF,IAAI,CAGN;AA8CD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAOhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,eAAe,CAAC;IACpB;;;6DAGyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1F;;;;;;OAMG;IACH,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC;;;;;;;OAOG;IACH,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mEAAmE;IACnE,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,yFAAyF;IACzF,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC;sEACkE;IAClE,kCAAkC,CAAC,EAAE,OAAO,CAAC;CAChD,GAAG;IACA,OAAO,EAAE,CACL,KAAK,EAAE;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACrD,EACD,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,CAsYA"}

package/dist/hooks/magic-context/tag-content-primitives.d.ts

@@ -0,0 +1,31 @@
+import type { ThinkingLikePart } from "./tag-messages";
+export declare function stripWellFormedLeadingTagPrefix(value: string): string;
+export declare function stripCompleteTagPairsGlobally(value: string): string;
+export declare function stripMalformedTagNotationGlobally(value: string): string;
+/** Dangling `§N<closer?>` shapes anywhere (cargo-cult cleanup). */
+export declare function stripDanglingTagNotationGlobally(value: string): string;
+export declare function stripTagSectionCharacters(value: string): string;
+/**
+ * Strip MC tag notation from assistant text at the persistence boundary
+ * (`experimental.text.complete`, Pi `message_end`). Removes whole `§N§` pairs
+ * (never bare leading digits), then malformed hybrids and stray `§`.
+ */
+export declare function stripPersistedAssistantText(value: string): string;
+export declare function byteSize(value: string): number;
+/**
+ * Strip only §-shaped MC tag notation from the start of transform-visible text.
+ * Does not remove bare leading digits — those may be legitimate user content
+ * (`99 files`, `2024 roadmap`, numbered lists).
+ */
+export declare function stripTagPrefix(value: string): string;
+/**
+ * Split leading MC tag notation from the body (temporal marker injection).
+ * Uses the same §-only rules as {@link stripTagPrefix}.
+ */
+export declare function peelLeadingMcTagNotation(value: string): {
+    tagPrefix: string;
+    body: string;
+};
+export declare function prependTag(tagId: number, value: string): string;
+export declare function isThinkingPart(part: unknown): part is ThinkingLikePart;
+//# sourceMappingURL=tag-content-primitives.d.ts.map

package/dist/hooks/magic-context/tag-content-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-content-primitives.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/tag-content-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAoEvD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,mEAAmE;AACnE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI3F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAItE"}

package/dist/hooks/magic-context/tag-id-fallback.d.ts

@@ -0,0 +1,11 @@
+import type { ContextDatabase } from "../../features/magic-context/storage";
+import type { Tagger } from "../../features/magic-context/tagger";
+type TaggableContentType = "message" | "file";
+export interface ExistingTagResolver {
+    resolve: (messageId: string, type: TaggableContentType, currentContentId: string, ordinal: number, options?: {
+        accept?: (tagNumber: number) => boolean;
+    }) => number | undefined;
+}
+export declare function createExistingTagResolver(sessionId: string, tagger: Tagger, db: ContextDatabase): ExistingTagResolver;
+export {};
+//# sourceMappingURL=tag-id-fallback.d.ts.map

package/dist/hooks/magic-context/tag-id-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-id-fallback.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/tag-id-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAElE,KAAK,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC;AAgB9C,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,CACL,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,EACzB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,KACpD,MAAM,GAAG,SAAS,CAAC;CAC3B;AAmCD,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,eAAe,GACpB,mBAAmB,CAoDrB"}

package/dist/hooks/magic-context/tag-messages.d.ts

@@ -0,0 +1,145 @@
+import type { ContextDatabase } from "../../features/magic-context/storage";
+import { type Tagger } from "../../features/magic-context/tagger";
+import { type ToolCallIndex, type ToolDropResult, ToolMutationBatch, type ToolSweepVariantResolver } from "./tool-drop-target";
+type ToolOwnerFallbackLookup = {
+    kind: "candidates";
+    callId: string;
+} | {
+    kind: "messageTimes";
+    messageIds: readonly string[];
+};
+export type MessageInfo = {
+    id?: string;
+    role?: string;
+    sessionID?: string;
+    summary?: boolean;
+    /** Marks one of the two m[0]/m[1] messages prepended by compartment injection. */
+    syntheticHead?: boolean;
+    finish?: string;
+    error?: unknown;
+};
+export interface ThinkingLikePart {
+    type: string;
+    thinking?: string;
+    text?: string;
+}
+export type MessageLike = {
+    info: MessageInfo;
+    parts: unknown[];
+};
+export interface TagNormalizationTarget {
+    tagNumber: number;
+    message: MessageLike;
+    part: unknown;
+    field: "text" | "tool_state_output" | "tool_result_content";
+}
+export type TagTarget = {
+    /** Non-mutating count of current and replacement token-bearing fields for a planned drop. */
+    measureReclaim?: (skeleton: boolean) => {
+        beforeTools: number;
+        afterTools: number;
+        beforeProse: number;
+        afterProse: number;
+    };
+    /**
+     * Replace the part's text. A text target treats this as a drop by default
+     * and also takes the reasoning of its message off the wire, since that
+     * reasoning answered the text that left. `keepReasoning` marks an in-place
+     * rewrite that keeps the text's meaning (caveman compression, a partial
+     * system-injection strip): the reasoning stays, because removing it would
+     * leave a gap in the middle of the history that prefix-bound models reject
+     * for every later thinking block.
+     */
+    setContent: (content: string, options?: {
+        keepReasoning?: boolean;
+    }) => boolean;
+    getContent?: () => string | null;
+    /**
+     * Text targets: the `§N§ ` prefix this pass puts in front of the text, or
+     * "" when prefixes are not injected. A rewrite computed from the stored
+     * source (which never carries the prefix) puts it back with this.
+     */
+    textPrefix?: string;
+    drop?: () => ToolDropResult;
+    /** Legacy skeleton: arguments replaced by the `{"dropped": …}` marker.
+     * Replay-only, for `drop_mode = 'truncated'` tags not yet converted. */
+    truncate?: () => ToolDropResult;
+    /** Real-argument skeleton: the call keeps the arguments the host gave it,
+     * only the output becomes `[dropped §N§]` (`drop_mode = 'skeleton_real'`). */
+    skeletonReal?: () => ToolDropResult;
+    /** New attachment-bearing skeletons omit media; legacy skeletons retain it. */
+    skeletonStripped?: () => ToolDropResult;
+    hasAttachments?: () => boolean;
+    /** Total UTF-8 bytes of the string values in the call's input (see
+     * tool-input-size.ts); null when the call is not on this pass's wire. */
+    inputStringBytes?: () => number | null;
+    /** Non-mutating: would removing this call leave the request ending on an
+     * assistant turn (given what this pass already removed)? */
+    wouldStrandConversationEnd?: () => boolean;
+    /** Non-mutating: the host adapter cannot remove this call structurally, so
+     * drop() would keep a paired shell instead. A new drop then keeps the real
+     * arguments (skeletonReal) rather than any placeholder. */
+    cannotRemove?: () => boolean;
+    /** Edit-marker compression for an edit/write superseded by a later edit to
+     * the same file: keep the call + filePath + a region hint of the diff,
+     * output → [dropped §N§]. Used by smart-drops. */
+    editMarker?: () => ToolDropResult;
+    editMarkerStripped?: () => ToolDropResult;
+    /** Non-mutating: would drop()/truncate() actually reclaim bytes? Tool
+     * targets only; absent on message/file targets. */
+    canDrop?: () => boolean;
+    /** A full arc removal would strand or merge native reasoning, so keep a paired skeleton. */
+    requiresToolArcSkeleton?: boolean;
+    /** Non-mutating read of the tool invocation's input object (e.g. to read
+     * `mmc_note`'s action or an edit's filePath for supersession selection).
+     * Tool targets only; null when no invocation part is present. */
+    readInput?: () => Record<string, unknown> | null;
+    message?: MessageLike;
+};
+export interface TagMessagesResult {
+    targets: Map<number, TagTarget>;
+    reasoningByMessage: Map<MessageLike, ThinkingLikePart[]>;
+    messageTagNumbers: Map<MessageLike, number>;
+    toolCallIndex: ToolCallIndex;
+    batch: ToolMutationBatch;
+    hasRecentReduceCall: boolean;
+    /** Whether recent assistant messages contain git commit hash patterns */
+    hasRecentCommit: boolean;
+    /** Exact part references that received a Magic Context tag prefix while tagMessages processed them. */
+    normalizationTargets: TagNormalizationTarget[];
+}
+export interface TagMessagesOptions {
+    /**
+     * When true, skip injecting §N§ prefix into message text/tool output parts.
+     * DB-level tag records are still created normally — this flag only affects
+     * whether the agent-visible part content gets the tag prefix. Used when
+     * the session's tool allow-list denies mmc_reduce so agents don't see tag
+     * markers they can't act on. Cache-safe: the availability verdict is frozen
+     * per session, so message shape stays stable.
+     */
+    skipPrefixInjection?: boolean;
+    /**
+     * Prune only tool-drop owners; callers enable this after persisting
+     * cache-safe session adoption. A resolver defers the choice to finalize
+     * time, where both candidate arrays are known (see
+     * `createPreAdoptionToolSweepResolver`).
+     */
+    scopedToolSweep?: boolean | ToolSweepVariantResolver;
+    /**
+     * The array that reaches the provider, when it is not `messages`. Passes
+     * that trim a compaction prefix tag the pre-trim copy, and the sweep has to
+     * remove its emptied rows from the served array as well.
+     */
+    servedMessages?: MessageLike[];
+    /** @internal diagnostic hook used by cache-stability/perf tests. */
+    onToolOwnerFallbackLookup?: (lookup: ToolOwnerFallbackLookup) => void;
+}
+/**
+ * Detect commit announcements in the same recent assistant window used by tagging.
+ * Rust authority skips the host tag walk, so this pure scan lets both authorities
+ * drive the shared durable note-nudge trigger without mirror-writing tag state.
+ */
+export declare function hasRecentAssistantCommit(messages: readonly MessageLike[]): boolean;
+export declare function tagMessages(sessionId: string, messages: MessageLike[], tagger: Tagger, db: ContextDatabase, options?: TagMessagesOptions): TagMessagesResult;
+export {};
+//# sourceMappingURL=tag-messages.d.ts.map

package/dist/hooks/magic-context/tag-messages.d.ts.map

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

package/dist/hooks/magic-context/tag-part-guards.d.ts

@@ -0,0 +1,23 @@
+import { stripTagPrefix } from "./tag-content-primitives";
+export { stripTagPrefix };
+export interface ValidTextPart {
+    type: string;
+    text: string;
+}
+export interface ValidToolPart {
+    type: string;
+    callID: string;
+    state: {
+        output: string;
+        input?: Record<string, unknown>;
+    };
+}
+interface ValidFilePart {
+    type: string;
+    url: string;
+}
+export declare function isTextPart(part: unknown): part is ValidTextPart;
+export declare function isToolPartWithOutput(part: unknown): part is ValidToolPart;
+export declare function isFilePart(part: unknown): part is ValidFilePart;
+export declare function buildFileSourceContent(parts: unknown[]): string | null;
+//# sourceMappingURL=tag-part-guards.d.ts.map

package/dist/hooks/magic-context/tag-part-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-part-guards.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/tag-part-guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC9D;AAED,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAI/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAMzE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAI/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAQtE"}

package/dist/hooks/magic-context/tail-hygiene-walk.d.ts

@@ -0,0 +1,178 @@
+import type { TagEntry } from "../../features/magic-context/types";
+import type { MessageLike } from "./tag-messages";
+export interface TailHygieneDeltas {
+    u: number;
+    t: number;
+}
+export type TailHygienePartKind = "text" | "toolInput" | "toolOutput" | "file" | "excluded";
+export interface TailHygienePartMeasurement {
+    key: string;
+    contentHash: string;
+    kind: TailHygienePartKind;
+    tokens: number;
+    uTokens: number;
+    tagNumber: number | null;
+    tagStatus: TagEntry["status"] | null;
+    protected: boolean;
+    /** The agent already requested this drop; it remains in the rendered token total until the next cache-busting render applies it. */
+    queuedForDrop: boolean;
+}
+export interface TailHygieneMeasurement {
+    u: number;
+    t: number;
+    contentSignature: string;
+    parts: TailHygienePartMeasurement[];
+    /** First index in `parts` that belongs to the newest message; the frozen prefix stops here. */
+    newestMessagePartStart: number;
+}
+/**
+ * Which measured field of a frozen prefix part stopped matching. `shorter` means
+ * the measured array no longer reaches the end of the frozen prefix at all.
+ */
+export type TailHygienePrefixMismatchField = "shorter" | "key" | "contentHash" | "kind" | "tokens" | "tagNumber" | "tagStatus" | "protection-entered" | "protection-exit-inactive" | "queued-drop-inactive" | "uTokens";
+/** First point where a defer pass stopped matching the frozen prefix. */
+export interface TailHygienePrefixMismatch {
+    /** Index into the frozen prefix; for `shorter` it is the first index the measured array lacks. */
+    partIndex: number;
+    /** Message the mismatching part belongs to, so the cause can be attributed to a message shape. */
+    messageId: string;
+    field: TailHygienePrefixMismatchField;
+    frozenParts: number;
+    measuredParts: number;
+}
+/**
+ * Cheap served-array shape used in production to catch a write after the tail
+ * walk without repeating its content hashing and token accounting.
+ */
+export interface TailHygieneStructuralSignature {
+    messageCount: number;
+    partCounts: number[];
+    /** Legacy field name: a structural size proxy, not a UTF-8 byte count. */
+    totalBytes: number;
+}
+export type TailHygieneChannel1Level = "" | "gentle" | "firm" | "urgent";
+export interface TailHygienePostReduceGrace {
+    /** True between the mmc_reduce call and the first post-drop tail measurement. */
+    pending: boolean;
+    /** Reclaimable mass after queued drops have already been excluded from U. */
+    baselineU?: number;
+    /** Channel-1 band observed immediately before mmc_reduce ran. */
+    preReduceLevel: TailHygieneChannel1Level;
+}
+export interface TailHygieneBaseline {
+    baselineU: number;
+    baselineT: number;
+    turnDeltaU: number;
+    turnDeltaT: number;
+    /** Unit epoch and frozen ratios used for every baseline/delta value in this generation. */
+    hygieneUnitsVersion: number;
+    toolsRatio: number;
+    proseRatio: number;
+    baselineGeneration: number;
+    computedAt: number;
+    evaluable: boolean;
+    generationInvalidated: boolean;
+    /** Measurements from the last full walk; defer passes compare against this immutable prefix. */
+    baselineParts: TailHygienePartMeasurement[];
+    /** Signature of the array served by the current pass, including valid appended deltas. */
+    contentSignature: string;
+    /** Live mirror of the durable nudge grace state; it never contributes rendered bytes. */
+    channel1PostReduceGrace?: TailHygienePostReduceGrace;
+    /**
+     * Set only on the pass that found a mismatch and re-measured, so a caller can
+     * log one line per invalidation event instead of one line per pass.
+     */
+    lastPrefixMismatch?: TailHygienePrefixMismatch;
+}
+export declare function isSyntheticMessage(message: MessageLike): boolean;
+/**
+ * Counts user turns with the same all-parts synthetic predicate used by the
+ * mid-turn release valve. MC's reminder, Channel-2, and m0/m1 rows are
+ * injected user-shaped messages and must not advance a user-turn cadence.
+ */
+export declare function countRealUserMessages(messages: readonly MessageLike[]): number;
+export declare function stripChannel1ReminderSpans(output: string): string;
+/**
+ * Capture a last-writer alarm, not a content hash. The legacy totalBytes field
+ * now sums string-leaf UTF-16 lengths and counts keys/array elements in one
+ * allocation-free tree walk, instead of materializing JSON and UTF-8 buffers.
+ * Like the old byte-length signature, it can miss same-length substitutions;
+ * the size proxy does not promise the same collision set or exact byte counts.
+ * The full content-hash assertion remains a separate opt-in debug check. Only the
+ * returned signature and per-message part-count array need to be allocated.
+ */
+export declare function tailHygieneStructuralSignature(messages: readonly MessageLike[]): TailHygieneStructuralSignature;
+export declare function sameTailHygieneStructuralSignature(expected: TailHygieneStructuralSignature, actual: TailHygieneStructuralSignature): boolean;
+type MeasurementInput = {
+    messages: readonly MessageLike[];
+    tags: readonly TagEntry[];
+    /**
+     * Canonical membership from computeProtectionWindow(persistedRows, snapshottedFloor).
+     * Coordinate space: tag-number. An empty set means the token window has no tool rows.
+     */
+    protectedTagNumbers: ReadonlySet<number>;
+    /** Active tags whose drop is queued but not yet materialized into the rendered tail. */
+    pendingDropTagNumbers?: ReadonlySet<number>;
+};
+export declare function measureTailHygiene(input: MeasurementInput): TailHygieneMeasurement;
+/** Result of comparing a frozen prefix against the current measurement. */
+export interface TailHygienePrefixComparison {
+    valid: boolean;
+    boundaryAdvanceU: number;
+    queuedDropDeltaU: number;
+    /** Present only when the comparison failed; names the first part that stopped matching. */
+    mismatch?: TailHygienePrefixMismatch;
+}
+/**
+ * Lane-neutral: both TypeScript walks (OpenCode and Pi) compare their measured
+ * parts through this one implementation so their defer-window rules cannot drift.
+ */
+export declare function compareMeasuredTailPrefix(baseline: readonly TailHygienePartMeasurement[], current: readonly TailHygienePartMeasurement[]): TailHygienePrefixComparison;
+/** One line per invalidation event: where it happened, which field moved, and what was done about it. */
+export declare function formatTailHygienePrefixMismatch(mismatch: TailHygienePrefixMismatch, baselineGeneration: number): string;
+/**
+ * Freeze a measurement into a baseline prefix plus this pass's delta.
+ *
+ * The newest message is deliberately left out of the frozen prefix: while it is
+ * newest its parts are still in flight (text absorbs a trailing blank, reasoning
+ * is demoted once it stops being newest, new parts arrive mid-turn), so freezing
+ * them guarantees a mismatch on the very next pass. Everything after the cut is
+ * re-measured on every pass, so the reported totals are unchanged.
+ */
+export declare function freezeTailHygieneMeasurement(measured: TailHygieneMeasurement): {
+    baselineU: number;
+    baselineT: number;
+    turnDeltaU: number;
+    turnDeltaT: number;
+    baselineParts: TailHygienePartMeasurement[];
+};
+export declare function refreshTailHygieneBaseline(input: {
+    messages: readonly MessageLike[];
+    tags: readonly TagEntry[];
+    /** Canonical tag-number membership from persisted row mass and the floor snapshot. */
+    protectedTagNumbers: ReadonlySet<number>;
+    pendingDropTagNumbers?: ReadonlySet<number>;
+    cacheBusting: boolean;
+    previous?: TailHygieneBaseline;
+    /** Frozen decision ratios. They change only on an authorized bust. */
+    calibration?: {
+        toolsRatio: number;
+        proseRatio: number;
+    };
+    hygieneUnitsVersion?: number;
+    now?: number;
+}): TailHygieneBaseline;
+export declare function effectiveTailHygiene(baseline: Pick<TailHygieneBaseline, "baselineU" | "baselineT" | "turnDeltaU" | "turnDeltaT">): {
+    u: number;
+    t: number;
+};
+export declare function assertTailHygieneContentUnchanged(input: {
+    messages: readonly MessageLike[];
+    tags: readonly TagEntry[];
+    protectedTagNumbers: ReadonlySet<number>;
+    expectedSignature: string;
+}): void;
+/** Opt-in diagnostics must not add a second hashing/token walk to shipped passes. */
+export declare function assertTailHygieneContentUnchangedIfEnabled(input: Parameters<typeof assertTailHygieneContentUnchanged>[0]): void;
+export {};
+//# sourceMappingURL=tail-hygiene-walk.d.ts.map

package/dist/hooks/magic-context/tail-hygiene-walk.d.ts.map

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

package/dist/hooks/magic-context/temporal-awareness.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Temporal awareness utilities.
+ *
+ * When enabled via experimental.temporal_awareness, the plugin:
+ *   1. Prepends <!-- +Xm --> / <!-- +2h 15m --> / <!-- +3d 4h --> HTML comments
+ *      to user messages where the gap since the previous message exceeds
+ *      TEMPORAL_AWARENESS_THRESHOLD_SECONDS.
+ *   2. Adds a compact date range to each `## start-end · date · title` heading
+ *      in the injected <session-history> block.
+ *
+ * The gap is measured from the previous message's effective end time:
+ *   - Assistant (completed): prev.time.completed
+ *   - Assistant (in-flight/aborted): prev.time.created (best available)
+ *   - User: prev.time.created (user messages have no completed field)
+ *
+ * All values are derived deterministically from immutable message timestamps,
+ * so injection is stable across transform passes and cache-safe.
+ */
+/** User message gaps below this threshold get no marker. 5 minutes. */
+export declare const TEMPORAL_AWARENESS_THRESHOLD_SECONDS = 300;
+/**
+ * Format a gap in seconds as a compact adaptive string.
+ * Returns null for gaps below the threshold (no marker should be injected).
+ *
+ *   < 5 min   → null
+ *   5 min - 1 hour    → "+Xm"          (e.g. "+12m")
+ *   1 hour - 1 day    → "+Xh Ym" / "+Xh" when Y == 0
+ *   1 day - 1 week    → "+Xd Yh" / "+Xd" when Y == 0
+ *   >= 1 week         → "+Xw Yd" / "+Xw" when Y == 0
+ *
+ * Non-finite, negative, or zero deltas return null.
+ */
+export declare function formatGap(seconds: number): string | null;
+/**
+ * Compute the effective end time for a raw OpenCode message given its
+ * time.created and optional time.completed fields.
+ *
+ * For completed assistants use `completed`; for everything else (user messages,
+ * in-flight/aborted assistants) use `created`.
+ */
+export declare function effectiveEndMs(time: {
+    created: number;
+    completed?: number;
+}): number;
+/**
+ * Format a Unix ms timestamp as YYYY-MM-DD in the process local timezone.
+ * Used for compartment heading date ranges.
+ */
+export declare function formatDate(ms: number): string;
+/** Regex matching the injected HTML comment so we can recognize / avoid
+ *  double-injecting on retried transform passes. */
+export declare const TEMPORAL_MARKER_PATTERN: RegExp;
+/**
+ * Produce the HTML comment prefix line for a given gap marker, or null if the
+ * gap is below threshold.
+ */
+export declare function temporalMarkerPrefix(seconds: number): string | null;
+/**
+ * Inject HTML-comment gap markers into authored user-message text parts when
+ * temporal awareness is enabled and the gap since the previous message's
+ * effective end time exceeds TEMPORAL_AWARENESS_THRESHOLD_SECONDS.
+ *
+ * Idempotent: if a text already starts with a temporal marker (e.g. from a
+ * previous transform pass), injection is skipped. Returns the number of
+ * messages that received a new marker.
+ *
+ * The marker is prepended BEFORE any §N§ tag added by tagMessages runs after
+ * this function, since tagging happens in the normal transform flow and
+ * stripTagPrefix re-strips `§N§` on re-tagging — leaving the marker intact
+ * between the tag and the user's text on subsequent passes.
+ */
+export declare function injectTemporalMarkers(messages: unknown[]): number;
+//# sourceMappingURL=temporal-awareness.d.ts.map

package/dist/hooks/magic-context/temporal-awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-awareness.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/temporal-awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAQxD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;oDACoD;AACpD,eAAO,MAAM,uBAAuB,QAA+C,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAiCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAuCjE"}