@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/hooks/magic-context/transform.d.ts

@@ -0,0 +1,334 @@
+import type { ProtectedTokensTierOverrides } from "../../config/project-security";
+import type { MagicContextConfig } from "../../config/schema/magic-context";
+import { type MaintenanceLauncher } from "../../features/magic-context/memory-maintainer/launcher";
+import { type MessageReconciliationSource } from "../../features/magic-context/message-index-async";
+import type { Scheduler } from "../../features/magic-context/scheduler";
+import { type ContextDatabase } from "../../features/magic-context/storage";
+import type { CoordinateGeneration } from "../../features/magic-context/store-generation-rebase";
+import type { Tagger } from "../../features/magic-context/tagger";
+import type { ContextUsage } from "../../features/magic-context/types";
+import type { PluginContext } from "../../plugin/types";
+import type { ModelInput } from "../../shared/model-resolution";
+import type { CavemanWordRules } from "./caveman";
+import { reconcileCompactionMode } from "./compaction-off-transition";
+import type { HiddenCompletionExecutor } from "./compartment-runner-types";
+import type { LiveModelBySession } from "./hook-handlers";
+import { resolveOpenCodeProtectedTailBoundary } from "./protected-tail-boundary";
+import { readRawSessionMessages } from "./read-session-chunk";
+import { findLastAssistantModelFromOpenCodeDb } from "./read-session-db";
+import { abortSessionFailClosed, type CompactionMarkerStrategy } from "./transform-postprocess-phase";
+export { EmergencyFailClosedError } from "./emergency-fail-closed";
+export declare function clearMessageTokensCache(sessionId: string, messageId?: string): void;
+/**
+ * Test-only accessor that returns (and lazily creates) the per-session token
+ * cache map so tests can seed and inspect entries without running the full
+ * transform pipeline. Not exported from any barrel.
+ */
+export declare function __getMessageTokensCacheForTest(sessionId: string): Map<string, {
+    conversation: number;
+    toolCall: number;
+}>;
+export { computeHardCacheExpired } from "../../features/magic-context/scheduler";
+export declare const EMERGENCY_REFUSAL_NOTICE = "Context full \u2014 /mmc-flush or /clear to continue.";
+export type HostRefusalNotice = (client: PluginContext["client"] | undefined, sessionId: string, message: string, notificationParams: import("./send-session-notification").NotificationParams) => Promise<void>;
+export declare function sendEmergencyRefusalNotice(client: PluginContext["client"] | undefined, sessionId: string, message: string, notificationParams: import("./send-session-notification").NotificationParams): Promise<void>;
+export interface TransformDeps {
+    cacheTtlConfig?: import("../../shared/model-cache-ttl").CacheTtlConfig;
+    hiddenCompletionExecutor?: import("./compartment-runner-types").HiddenCompletionExecutor;
+    /** Host marker lifecycle; omission preserves OpenCode 1 marker writes and replay. */
+    compactionMarkerStrategy?: CompactionMarkerStrategy & {
+        setPending?: typeof import("../../features/magic-context/storage").setPendingCompactionMarkerState;
+        publish?: typeof import("./compaction-marker-manager").updateCompactionMarkerAfterPublication;
+    };
+    /** Host storage and cancellation adapters; omitted callbacks retain OpenCode 1 behavior. */
+    hostRawMessages?: (sessionId: string) => ReturnType<typeof readRawSessionMessages>;
+    hostMessageReconciliationSource?: MessageReconciliationSource;
+    hostProtectedTailBoundary?: typeof resolveOpenCodeProtectedTailBoundary;
+    hostModelFallback?: typeof findLastAssistantModelFromOpenCodeDb;
+    hostRefusalNotice?: HostRefusalNotice;
+    hostRefuse?: typeof abortSessionFailClosed;
+    tagger: Tagger;
+    scheduler: Scheduler;
+    contextUsageMap: Map<string, {
+        usage: ContextUsage;
+        updatedAt: number;
+        lastResponseTime?: number;
+        hasUsageTokens?: boolean;
+    }>;
+    db: ContextDatabase;
+    /**
+     * Channel 1 (mmc_reduce tool-output nudge) per-session metric baseline,
+     * refreshed at the end of each transform pass where mmc_reduce is callable
+     * and read in tool.execute.after.
+     */
+    channel1StateBySession?: Map<string, import("./ctx-reduce-nudge").Channel1State>;
+    /** Module-authored Channel 2 text held until the terminal `message.updated` event, when the host delivers the pending nudge. */
+    channel2DirectiveTextBySession?: Map<string, string>;
+    /** Direct absolute override for callers that do not load tiered config. */
+    protectedTokens?: number;
+    /** User/project values retained until the pass supplies usableSoft geometry. */
+    protectedTokenTierOverrides?: ProtectedTokensTierOverrides;
+    /**
+     * mmc_reduce visibility is resolved per session from the session's tool
+     * allow-list. Tag DB rows are still maintained when the tool is unavailable,
+     * but §N§ prefixes and nudges are suppressed. See tag-messages.ts for the gate.
+     */
+    /** Smart-drops (experimental, default off): also reclaim tool output that a
+     *  later call supersedes, on top of the age-based auto-drop. Off → messages
+     *  sent to the model are byte-identical to the age-based-only behavior. */
+    smartDrops?: boolean;
+    clearReasoningAge: number;
+    /** Commit-cluster historian trigger config (`commit_cluster_trigger`). */
+    commitClusterTrigger?: {
+        enabled: boolean;
+        min_clusters: number;
+    };
+    /**
+     * One-shot signal that `<session-history>` injection cache is stale and
+     * `prepareCompartmentInjection` should rebuild on this pass. Drained
+     * after the rebuild so subsequent defer passes hit the fresh cache.
+     * See Oracle review 2026-04-26 for the three-set split rationale.
+     */
+    historyRefreshSessions: Set<string>;
+    deferredHistoryRefreshSessions?: Set<string>;
+    /**
+     * Persistent signal that pending ops + heuristics need to materialize.
+     * Survives across defer passes when `compartmentRunning` blocks the
+     * heuristic pass. Drained only after `shouldRunHeuristics` succeeds.
+     */
+    pendingMaterializationSessions: Set<string>;
+    deferredMaterializationSessions?: Set<string>;
+    /** Live OpenCode reasoning variant, forwarded only as a provider-cache identity signal. */
+    variantBySession?: Map<string, string | undefined>;
+    lastHeuristicsTurnId: Map<string, string>;
+    client?: PluginContext["client"];
+    directory?: string;
+    /** Whether user-level configuration lets this session use the canonical home directory as its project. */
+    allowHomeProject?: boolean;
+    memoryConfig?: {
+        enabled: boolean;
+        injectionBudgetTokens: number;
+        /** When true, historian/recomp auto-promote eligible session facts
+         *  to project memories. When false, promotion is skipped — agents can
+         *  still write memories explicitly via `mmc_memory write`. Issue #44. */
+        autoPromote: boolean;
+    };
+    ensureProjectRegistered?: (directory: string, db: ContextDatabase) => Promise<void>;
+    /**
+     * Returns the historian chunk budget. Called at each historian spawn site
+     * so the value is always derived from current config — keeping hook,
+     * RPC, and TUI trigger paths consistent and honoring runtime config changes.
+     * Optional for tests; production (hook.ts) always provides it.
+     */
+    getHistorianChunkTokens?: () => number;
+    historyBudgetPercentage?: number;
+    executeThresholdPercentage?: number | {
+        default: number;
+        [modelKey: string]: number;
+    };
+    executeThresholdTokens?: {
+        default?: number;
+        [modelKey: string]: number | undefined;
+    };
+    historianTimeoutMs?: number;
+    /** Active OpenCode historian entry, including its outbound request variant. */
+    historianModel?: ModelInput;
+    historianContextLimit?: number;
+    historianMaxOutputTokens?: number;
+    /** Resolved fallback chain for historian-family calls. */
+    fallbackModels?: readonly ModelInput[];
+    resolveHistorianRun?: () => {
+        model?: ModelInput;
+        fallbackModels: readonly ModelInput[];
+        contextLimit?: number;
+        maxOutputTokens?: number;
+        timeoutMs: number;
+        twoPass: boolean;
+        expandTools?: Record<string, string | false>;
+        autoPromote: boolean;
+        commitClusterTrigger?: {
+            enabled: boolean;
+            min_clusters: number;
+        };
+        toastDurationMs?: number;
+        chunkTokens: number;
+    };
+    /** False when historian.disable=true, blocking historian-backed child agents. */
+    historianRunnable?: boolean;
+    /**
+     * Compaction-off mode (issue #266), boot-resolved and process-stable.
+     * When true the transform runs additive-only: m[0]/m[1] memory/docs
+     * injection, measurement and identity recording stay; every mutating
+     * compaction gate (historian, drops, strips, nudges, emergency, markers,
+     * tag writes) is off. Precedence: every mutating gate becomes
+     * `existingGate && !compactionOff` — the mode wins over both the primary
+     * and the subagent path. It does NOT alias fullFeatureMode=false: the
+     * m[0]/m[1] injection gate is re-expressed as identity-present AND
+     * (fullFeatureMode || compactionOff) so the mode cannot swallow memory
+     * delivery.
+     */
+    compactionOff?: boolean;
+    hostCleanupCompactionMarkers?: Parameters<typeof reconcileCompactionMode>[0]["cleanupMarkers"];
+    getNotificationParams?: (sessionId: string) => import("./send-session-notification").NotificationParams;
+    getModelKey?: (sessionId: string) => string | undefined;
+    /**
+     * Observed provider-tool-set fingerprint for the session route. This is
+     * telemetry only: a change is recorded but never asks m[0] to fold.
+     */
+    getToolSetHash?: (sessionId: string) => string;
+    getFallbackModelId?: (sessionId: string) => string | undefined;
+    projectPath?: string;
+    /** When true, inject wall-clock gap markers (<!-- +Xm -->) on user messages and
+     *  add compact date ranges to compartment headings in <session-history>.
+     *  Controlled by `experimental.temporal_awareness` config. */
+    experimentalTemporalAwareness?: boolean;
+    /** When true, run a second editor pass after historian to clean U: lines.
+     *  Enables the historian-editor agent. Controlled by `historian.two_pass` config. */
+    historianTwoPass?: boolean;
+    historianExpandTools?: Record<string, string | false>;
+    liveModelBySession?: LiveModelBySession;
+    /**
+     * Process-scoped cache of resolved session.directory values. When provided,
+     * we look up here before hitting OpenCode's API and populate after a
+     * successful lookup. The session→project binding is immutable in OpenCode,
+     * so this cache lives until the session is deleted.
+     */
+    sessionDirectoryBySession?: Map<string, string>;
+    /**
+     * Process-scoped set of Magic Context's OWN hidden child sessions
+     * (historian/recomp), detected by title prefix
+     * at `session.created`. When a session is in this set the transform returns
+     * immediately (messages unmodified) — these children have their own fixed
+     * agent identity and never use any MC feature, so even reduced-mode work
+     * (tagging, heuristic drops) is pure overhead. See live-session-state.ts.
+     */
+    internalChildSessions?: Set<string>;
+    /**
+     * Session→agent-name map of this host's drafts (OpenCode 2 context hook).
+     * The memory-maintenance tail probe uses it to recognize Magic Context's
+     * own hidden children (historian + maintainer carriers) — the OC2 lane
+     * does not populate `internalChildSessions`.
+     */
+    agentBySession?: Map<string, string>;
+    /**
+     * The `maintenance.*` config slice (user-tier only; project tier is
+     * stripped). Absent → the maintenance launch probe never arms.
+     */
+    maintenanceConfig?: () => MagicContextConfig["maintenance"];
+    /**
+     * Per-run host-step cap for capped hidden agents (maintainer stage A /
+     * stage B; see memory-maintainer plan decisions 3/9). Enforced by the
+     * hidden child hook through the executor's attempt registration.
+     */
+    resolveStepCap?: (identity: import("./compartment-runner-types").HiddenRunIdentity) => number | undefined;
+    /** Experimental auto-search hint — transform-time mmc_search on each new
+     *  user message; when top hit clears the threshold, append a compact
+     *  fragment hint to the user message. Controlled by
+     *  `experimental.auto_search.*` config. */
+    autoSearch?: {
+        enabled: boolean;
+        scoreThreshold: number;
+        minPromptChars: number;
+        directory?: string;
+        ensureProjectRegistered?: (directory: string, db: ContextDatabase) => Promise<void>;
+    };
+    /**
+     * Experimental age-tier caveman text compression — rewrites long
+     * user/assistant text parts with progressively aggressive caveman
+     * rules based on their position in the eligible tag window. Only runs for
+     * primary sessions; subagents are excluded because their context is curated
+     * by the parent and they have no mmc_expand recovery path.
+     */
+    cavemanTextCompression?: {
+        enabled: boolean;
+        minChars: number;
+        wordRules?: CavemanWordRules;
+    };
+    /**
+     * Which projection of the OpenCode store this host serves. Supplied by the
+     * OpenCode 1 and OpenCode 2 hooks; omitted by every other harness, which
+     * keeps them (Pi in particular) out of the coordinate rebase entirely.
+     */
+    storeGeneration?: CoordinateGeneration;
+}
+export declare function resolveTransformHostSeams(deps: Pick<TransformDeps, "hostRawMessages" | "hostMessageReconciliationSource" | "hostProtectedTailBoundary" | "hostModelFallback" | "hostRefusalNotice" | "hostRefuse">): {
+    hostRawMessages: (sessionId: string) => ReturnType<typeof readRawSessionMessages>;
+    hostMessageReconciliationSource: MessageReconciliationSource;
+    hostProtectedTailBoundary: typeof resolveOpenCodeProtectedTailBoundary;
+    hostModelFallback: typeof findLastAssistantModelFromOpenCodeDb;
+    hostRefusalNotice: HostRefusalNotice;
+    hostRefuse: typeof abortSessionFailClosed;
+};
+export declare function createTransform(deps: TransformDeps): (_input: Record<string, never>, output: {
+    messages: unknown[];
+}) => Promise<void>;
+/**
+ * Record this pass's assembled host system text for `sessionId` (the
+ * post-handler output the pass will actually serve). Called from the v2
+ * context wiring right after the system-prompt handler runs; refreshed every
+ * pass. Memory only — never persisted anywhere.
+ */
+export declare function noteMaintenanceSystemSnapshot(sessionId: string, systemText: string): void;
+/** Drop the snapshot on the session-deleted path (bounds the module map). */
+export declare function clearMaintenanceSystemSnapshot(sessionId: string): void;
+/**
+ * Read the session's latest recorded host system-prompt snapshot (gate-4 M1:
+ * the MANUAL run path — /mmc-memory-maintain run over RPC — builds its
+ * explicit run context from this, so a manual run quotes the same
+ * probe-moment text an automatic launch of that session would).
+ */
+export declare function readMaintenanceSystemSnapshot(sessionId: string): string | undefined;
+export interface MaintenanceTailDeps {
+    db: ContextDatabase;
+    /** `maintenance.*` config accessor; absent or disabled disarms the probe. */
+    getMaintenanceConfig?: () => MagicContextConfig["maintenance"] | undefined;
+    /** The host's hidden executor; absent → runs would fail, so never arm. */
+    hiddenCompletionExecutor?: HiddenCompletionExecutor;
+    /**
+     * Test seam: build the per-project launcher. Production wires the shared
+     * launcher (getMaintenanceLauncher) over the OC2 adapter run factory.
+     */
+    launcherFactory?: (db: ContextDatabase, projectPath: string) => MaintenanceLauncher;
+    nowMs?: () => number;
+}
+export interface MaintenanceTailInput {
+    sessionId: string;
+    /** The pass's working directory (rides the signals to the run factory). */
+    directory: string;
+    /** Resolved project identity for this session's pass ("" = skip). */
+    projectPath: string;
+    /** Decision 6: child / hidden / subagent sessions never trigger. */
+    isChildSession: boolean;
+    /** Decision 25: host historian-avoidance signal. */
+    historianInFlight: boolean;
+    /** Decision 7: compaction-off sessions never trigger. */
+    compactionEnabled: boolean;
+}
+export interface MaintenanceTailLauncher {
+    /**
+     * Synchronous pass-tail probe: enabled gate → child guard → one pool
+     * count → launcher.maybeLaunch (which fires the run factory without
+     * awaiting). The run context (parent session, directory, and the
+     * probe-time host system-prompt snapshot — plan 10 P3 gate-3 contract ①)
+     * is captured HERE, at the probe moment, into the launch signals; the
+     * async run factory consumes those per-launch fields after the pass is
+     * gone (gate-4 M1: no shared slot a concurrent pass could overwrite).
+     * NEVER awaits, NEVER mutates wire bytes, NEVER throws.
+     */
+    maybeLaunch(input: MaintenanceTailInput): void;
+}
+/**
+ * The transform-tail arming of the automatic memory-maintenance launcher
+ * (plan 10 decision 24). Cheap by contract: one config read, one indexed
+ * COUNT, and the launcher's own single-row eligibility reads — only when
+ * maintenance is enabled and the session shape can ever qualify.
+ */
+export declare function createMaintenanceTailLauncher(deps: MaintenanceTailDeps): MaintenanceTailLauncher;
+export declare function resolveHistoryBudgetTokens(historyBudgetPercentage: number | undefined, contextUsage: ContextUsage, executeThresholdPercentage: number | {
+    default: number;
+    [modelKey: string]: number;
+} | undefined, modelKey: string | undefined, executeThresholdTokens?: {
+    default?: number;
+    [modelKey: string]: number | undefined;
+}, resolvedContextLimit?: number): number | undefined;
+//# sourceMappingURL=transform.d.ts.map

package/dist/hooks/magic-context/transform.d.ts.map

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

package/dist/hooks/magic-context/unmanaged-over-window.d.ts

@@ -0,0 +1,36 @@
+/**
+ * How far over the model's context window a session's history has to be
+ * before a pass with no other evidence of its size is treated as over the
+ * window. The comparison uses the local token count of the request (system
+ * prompt, tool definitions and messages, without the provider-specific
+ * scaling the fit checks apply), and that count can be a few percent off the
+ * provider's own. The margin keeps a session that is close to the window, and
+ * may well fit, on the ordinary path: it is served as before, and the
+ * provider's own answer (and the overflow recovery that follows a rejection)
+ * decides. Only a history clearly larger than the window is handled here.
+ */
+export declare const UNMANAGED_OVER_WINDOW_FACTOR = 1.1;
+/**
+ * True when a request of `tokens` local tokens is clearly larger than a
+ * context window of `contextLimit` tokens. An unknown or non-positive limit,
+ * or a count that is not a finite positive number, proves nothing.
+ */
+export declare function isClearlyOverWindow(tokens: number, contextLimit: number | undefined): boolean;
+/**
+ * A pass started with a history clearly larger than the model's context
+ * window and no Magic Context state to send in its place (a session Magic
+ * Context has never seen, or a fork whose parent left nothing to inherit),
+ * and the reductions this pass could make did not bring the request under the
+ * window. Sending it would earn a provider rejection, or on a provider that
+ * accepts it, a silently degraded and expensive turn, so the pass stops here:
+ * the messages wrapper replays the last good request when it can and
+ * otherwise refuses the turn with this message.
+ */
+export declare class UnmanagedOverWindowError extends Error {
+    readonly estimatedTokens: number;
+    readonly contextLimitTokens: number;
+    readonly code = "UNMANAGED_OVER_WINDOW";
+    readonly recoverable = true;
+    constructor(estimatedTokens: number, contextLimitTokens: number);
+}
+//# sourceMappingURL=unmanaged-over-window.d.ts.map

package/dist/hooks/magic-context/unmanaged-over-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmanaged-over-window.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/unmanaged-over-window.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAK7F;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAK3C,QAAQ,CAAC,eAAe,EAAE,MAAM;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM;IALvC,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,WAAW,QAAQ;gBAGf,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM;CAK1C"}

package/dist/hooks/magic-context/unresolved-history-boundary.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The transform could not cut the conversation at the history boundary, and
+ * the uncut request is larger than the model's context window. Sending it
+ * would only earn a provider rejection, so the pass stops here: the messages
+ * wrapper replays the last good request when it can and otherwise refuses the
+ * turn with this message.
+ */
+export declare class UnresolvedHistoryBoundaryError extends Error {
+    readonly estimatedTokens: number;
+    readonly contextLimitTokens: number;
+    readonly code = "UNRESOLVED_HISTORY_BOUNDARY";
+    readonly recoverable = true;
+    constructor(estimatedTokens: number, contextLimitTokens: number);
+}
+//# sourceMappingURL=unresolved-history-boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unresolved-history-boundary.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/unresolved-history-boundary.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IAKjD,QAAQ,CAAC,eAAe,EAAE,MAAM;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM;IALvC,QAAQ,CAAC,IAAI,iCAAiC;IAC9C,QAAQ,CAAC,WAAW,QAAQ;gBAGf,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM;CAK1C"}

package/dist/hooks/magic-context/wrapup-orchestrator.d.ts

@@ -0,0 +1,14 @@
+import { runCompartmentAgent } from "./compartment-runner-incremental";
+import type { ManagedRecompContext } from "./recomp-orchestrator";
+export interface ManagedWrapupContext extends ManagedRecompContext {
+    contextLimit: number;
+    executeThresholdPercentage: number;
+    hasPendingNaturalBust?: (sessionId: string) => boolean;
+    runCompartmentAgentForWrapup?: typeof runCompartmentAgent;
+    wrapupLeaseWaitTimeoutMs?: number;
+}
+export interface WrapupOptions {
+    messagesToKeep: number;
+}
+export declare function runManagedWrapup(ctx: ManagedWrapupContext, sessionId: string, options: WrapupOptions): Promise<string>;
+//# sourceMappingURL=wrapup-orchestrator.d.ts.map

package/dist/hooks/magic-context/wrapup-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapup-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/wrapup-orchestrator.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAQvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,4BAA4B,CAAC,EAAE,OAAO,mBAAmB,CAAC;IAC1D,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC1B,cAAc,EAAE,MAAM,CAAC;CAC1B;AA2OD,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,oBAAoB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/index-1vs6anwz.js

@@ -0,0 +1,126 @@
+import {
+  clearEmergencyRecovery,
+  dropSlot,
+  renderUserFacingFailure,
+  userFacingFailureCode,
+  executeContextRecomp
+} from "./index-by6h2pav.js";
+import {
+  sessionLog
+} from "./index-qbkzdkk0.js";
+
+// src/hooks/magic-context/recomp-orchestrator.ts
+function resolveLiveModelKey(liveSessionState, sessionId) {
+  const model = liveSessionState.liveModelBySession.get(sessionId);
+  return model ? `${model.providerID}/${model.modelID}` : undefined;
+}
+function isRecompFailure(message) {
+  return /—\s*(Failed|Skipped)/.test(message);
+}
+function isRecompSkip(message) {
+  return /—\s*Skipped|already mutating compartment state|already running/i.test(message);
+}
+function extractRecompReason(raw) {
+  const meaningful = raw.split(`
+`).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
+  return meaningful.join(" ").trim() || "Recomp finished";
+}
+var RECOMP_DONE_GRACE_MS = 30000;
+function setRecompStarting2(liveSessionState, sessionId, note, kind = "recomp") {
+  dropSlot(sessionId, "recomp-start");
+  liveSessionState.recompProgressBySession.set(sessionId, {
+    sessionId,
+    kind,
+    phase: "recomp",
+    processedMessages: 0,
+    totalMessages: 0,
+    passCount: 0,
+    compartmentsCreated: 0,
+    startedAt: Date.now(),
+    updatedAt: Date.now(),
+    note
+  });
+}
+function setRecompTerminal2(liveSessionState, sessionId, phase, message) {
+  const existing = liveSessionState.recompProgressBySession.get(sessionId);
+  liveSessionState.recompProgressBySession.set(sessionId, {
+    sessionId,
+    kind: existing?.kind ?? "recomp",
+    phase,
+    processedMessages: existing?.processedMessages ?? 0,
+    totalMessages: existing?.totalMessages ?? 0,
+    passCount: existing?.passCount ?? 0,
+    compartmentsCreated: existing?.compartmentsCreated ?? 0,
+    startedAt: existing?.startedAt ?? Date.now(),
+    updatedAt: Date.now(),
+    message
+  });
+  if (phase === "done" || phase === "skipped") {
+    const t = setTimeout(() => {
+      const cur = liveSessionState.recompProgressBySession.get(sessionId);
+      if (cur?.phase === phase)
+        liveSessionState.recompProgressBySession.delete(sessionId);
+    }, RECOMP_DONE_GRACE_MS);
+    t.unref?.();
+  }
+}
+function buildRecompDeps(ctx, sessionId) {
+  return {
+    client: ctx.client,
+    hiddenCompletionExecutor: ctx.hiddenCompletionExecutor,
+    db: ctx.db,
+    sessionId,
+    historianChunkTokens: ctx.historianChunkTokens,
+    historianTimeoutMs: ctx.historianTimeoutMs,
+    directory: ctx.directory,
+    memoryEnabled: ctx.memoryEnabled,
+    autoPromote: ctx.autoPromote,
+    model: ctx.historianModel,
+    historianContextLimit: ctx.historianContextLimit,
+    historianMaxOutputTokens: ctx.historianMaxOutputTokens,
+    fallbackModels: ctx.fallbackModels,
+    language: ctx.language,
+    fallbackModelId: ctx.fallbackModelId ?? resolveLiveModelKey(ctx.liveSessionState, sessionId),
+    historianTwoPass: ctx.historianTwoPass,
+    historianExpandTools: ctx.historianExpandTools,
+    ensureProjectRegistered: ctx.ensureProjectRegistered,
+    getNotificationParams: () => ctx.getNotificationParams(sessionId),
+    onCompartmentStatePublished: (sid) => {
+      ctx.liveSessionState.historyRefreshSessions.add(sid);
+      ctx.liveSessionState.pendingMaterializationSessions.add(sid);
+    },
+    onDeferredMarkerPending: (sid) => {
+      ctx.liveSessionState.deferredHistoryRefreshSessions.add(sid);
+    },
+    onRecompProgress: (p) => {
+      const prevKind = ctx.liveSessionState.recompProgressBySession.get(sessionId)?.kind ?? "recomp";
+      ctx.liveSessionState.recompProgressBySession.set(sessionId, {
+        ...p,
+        kind: p.kind ?? prevKind
+      });
+    }
+  };
+}
+async function runManagedRecomp2(ctx, sessionId, options) {
+  setRecompStarting2(ctx.liveSessionState, sessionId, "Starting recomp…", "recomp");
+  try {
+    const message = await executeContextRecomp(buildRecompDeps(ctx, sessionId), options);
+    const terminalPhase = isRecompSkip(message) ? "skipped" : isRecompFailure(message) ? "failed" : "done";
+    if (terminalPhase === "done") {
+      try {
+        clearEmergencyRecovery(ctx.db, sessionId);
+      } catch {}
+    }
+    setRecompTerminal2(ctx.liveSessionState, sessionId, terminalPhase, extractRecompReason(message));
+    return message;
+  } catch (error) {
+    const failure = renderUserFacingFailure("recomp_unavailable");
+    sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")}`, error);
+    setRecompTerminal2(ctx.liveSessionState, sessionId, "failed", failure);
+    return `## Magic Recomp — Failed
+
+${failure}`;
+  }
+}
+
+export { setRecompStarting2, setRecompTerminal2, runManagedRecomp2 };