@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/v2/hooks/rpc-live-state.d.ts

@@ -0,0 +1,9 @@
+import { type LiveSessionState } from "../../hooks/magic-context/live-session-state";
+/**
+ * The RPC surface must read and write the SAME live sets the v2 pass uses.
+ * `systemPromptRefreshSessions` is part of that: a `/mmc-flush` arriving over
+ * RPC signals it, and only the shared instance is the one the next
+ * system-prompt transform drains.
+ */
+export declare function createV2RpcLiveSessionState(overrides: Pick<LiveSessionState, "liveModelBySession" | "variantBySession" | "agentBySession" | "channel1StateBySession" | "historyRefreshSessions" | "pendingMaterializationSessions" | "systemPromptRefreshSessions" | "sessionDirectoryBySession">): LiveSessionState;
+//# sourceMappingURL=rpc-live-state.d.ts.map

package/dist/v2/hooks/rpc-live-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-live-state.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/rpc-live-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,IAAI,CACX,gBAAgB,EACd,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,GACxB,wBAAwB,GACxB,gCAAgC,GAChC,6BAA6B,GAC7B,2BAA2B,CAChC,GACF,gBAAgB,CAElB"}

package/dist/v2/hooks/session-api-gate.d.ts

@@ -0,0 +1,4 @@
+export declare const OPENCODE2_SESSION_API_NOTICE = "Magic Context is disabled: OpenCode 2.0.22 or newer is required (session.remove and session.compact). Upgrade OpenCode and restart.";
+/** Capability checks also admit development builds without a release version. */
+export declare function hasRequiredSessionAPI(session: object): boolean;
+//# sourceMappingURL=session-api-gate.d.ts.map

package/dist/v2/hooks/session-api-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-api-gate.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/session-api-gate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wIACgG,CAAC;AAE1I,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9D"}

package/dist/v2/hooks/session-project-backfill.d.ts

@@ -0,0 +1,15 @@
+import { type BackfillResult } from "../../features/magic-context/session-project-backfill";
+import type { Database } from "../../shared/sqlite";
+import type { V2StoreReader } from "../store-reader";
+/**
+ * Bind every existing OpenCode 2 session to its project.
+ *
+ * The OpenCode 1 lane runs the same backfill at boot over the host's `session`
+ * table. OpenCode 2 never runs that lane, and its sessions live in
+ * `session_v2`, so sessions created before the plugin started recording the
+ * binding (or while it could not) stayed projectless: the Dashboard groups
+ * sessions into projects only through `session_projects`. The backfill records
+ * completion per harness, so this pass runs to completion once per store.
+ */
+export declare function runV2SessionProjectBackfill(db: Database, openStoreReader: () => Pick<V2StoreReader, "sessionDirectoryPage" | "close">, allowHomeProject?: boolean): Promise<BackfillResult>;
+//# sourceMappingURL=session-project-backfill.d.ts.map

package/dist/v2/hooks/session-project-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-project-backfill.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/session-project-backfill.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,cAAc,EAEtB,MAAM,uDAAuD,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACvC,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,IAAI,CAAC,aAAa,EAAE,sBAAsB,GAAG,OAAO,CAAC,EAC5E,gBAAgB,UAAQ,GACzB,OAAO,CAAC,cAAc,CAAC,CAazB"}

package/dist/v2/hooks/storage-gate.d.ts

@@ -0,0 +1,48 @@
+import { type FailClosedReason } from "../../features/magic-context/fail-closed-block";
+import { type ContextDatabase } from "../../features/magic-context/storage";
+/**
+ * The shortest time between two storage open attempts while the context database
+ * is unavailable. A refused open is not free: the migration guard lists processes
+ * and reads every RPC discovery file, so a session that sends turns quickly must
+ * not repeat it on every pass. The interval starts when an attempt finishes;
+ * a later turn can join recovery without blocking the host event loop.
+ */
+export declare const V2_STORAGE_REOPEN_INTERVAL_MS = 5000;
+export interface V2StorageGate {
+    /** The durable database once an open has succeeded; never attempts an open. */
+    current(): ContextDatabase | undefined;
+    /** Why the last attempt left no durable database, or null when none has failed. */
+    reason(): FailClosedReason | null;
+    /** Start or join a bounded open attempt, respecting the retry interval. */
+    probe(): Promise<ContextDatabase | undefined>;
+    /**
+     * The durable database. While storage is unavailable this re-attempts the open
+     * at most once per interval and otherwise throws a `FailClosedBlockingError`
+     * whose message names the recorded reason.
+     */
+    require(): ContextDatabase;
+}
+export interface V2StorageGateOptions {
+    open?: () => ContextDatabase | null | Promise<ContextDatabase | null>;
+    now?: () => number;
+    reopenIntervalMs?: number;
+    /** Called when an attempt fails for a reason different from the previous one. */
+    onUnavailable?: (reason: FailClosedReason) => void;
+    /** Called when an attempt succeeds after an earlier one failed. */
+    onRecovered?: (db: ContextDatabase) => void;
+}
+/**
+ * Own the OpenCode 2 lane's context database handle across the life of the host
+ * process. A refused open (a migration blocked by an older host, a database
+ * newer than this build, an open error) is remembered with its reason and
+ * retried on later turns, so the lane recovers without a host restart once the
+ * cause is gone.
+ */
+export declare function createV2StorageGate(options?: V2StorageGateOptions): V2StorageGate;
+/**
+ * Give slow healthy opens time to retain the tools registered during setup.
+ * OpenCode serves HTTP while this asynchronous wait is pending. An open
+ * still unresolved after fifteen seconds takes the degraded, tool-less route.
+ */
+export declare function probeV2StorageAtBoot(storage: V2StorageGate): Promise<ContextDatabase | undefined>;
+//# sourceMappingURL=storage-gate.d.ts.map

package/dist/v2/hooks/storage-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-gate.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/storage-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,sCAAsC,CAAC;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC1B,+EAA+E;IAC/E,OAAO,IAAI,eAAe,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,MAAM,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAClC,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC9C;;;;OAIG;IACH,OAAO,IAAI,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACtE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnD,mEAAmE;IACnE,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA0ErF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACtC,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAYtC"}

package/dist/v2/hooks/storage-notice.d.ts

@@ -0,0 +1,29 @@
+import { type FailClosedReason } from "../../features/magic-context/fail-closed-block";
+import type { V2Message } from "./types";
+/**
+ * Every notice Magic Context stores in an OpenCode 2 conversation about its own
+ * storage starts with this text. The notices are for the user: none of them may
+ * reach the model, and the conversation keeps them across restarts, so they are
+ * recognized by this fixed prefix together with the host's own record that the
+ * message is a synthetic one Magic Context sent, never by process memory.
+ */
+export declare const STORAGE_NOTICE_PREFIX = "[Magic Context storage notice] ";
+/** The notice stored when a turn is refused because the context database is unavailable. */
+export declare function formatStorageRefusalNotice(reason: FailClosedReason): string;
+/** The notice stored once when the context database opens after a refused start. */
+export declare function formatStorageRecoveryNotice(hiddenWorkRecovered: boolean): string;
+export declare function isStorageNoticeText(text: unknown): boolean;
+/**
+ * Whether a request message has the shape the host gives a stored notice: a user
+ * message whose only part is the notice text. The caller still confirms that the
+ * host recorded the message as a Magic Context synthetic.
+ */
+export declare function hasStorageNoticeShape(message: V2Message): boolean;
+/**
+ * Remove stored storage notices from a request draft in place. A message counts
+ * only when it has the notice shape and `isAdmittedSynthetic` confirms, from the
+ * host's durable plugin storage, that Magic Context sent it as a synthetic; a
+ * user who types the same text keeps their message. Returns how many were removed.
+ */
+export declare function dropStorageNotices(messages: V2Message[], isAdmittedSynthetic: (id: string) => Promise<boolean>): Promise<number>;
+//# sourceMappingURL=storage-notice.d.ts.map

package/dist/v2/hooks/storage-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-notice.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/storage-notice.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,gBAAgB,EAExB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,oCAAoC,CAAC;AAEvE,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE3E;AAED,oFAAoF;AACpF,wBAAgB,2BAA2B,CAAC,mBAAmB,EAAE,OAAO,GAAG,MAAM,CAIhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAKjE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,SAAS,EAAE,EACrB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACtD,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/v2/hooks/store.d.ts

@@ -0,0 +1,58 @@
+import type { BoundedRawMessageProvider } from "../../hooks/magic-context/read-session-chunk";
+import type { RawMessage, RawMessageOrdinalAnchor, RawMessageOrdinalEntry, RawMessageParts } from "../../hooks/magic-context/read-session-raw";
+import { type StoreRow, type V2StoreReader } from "../store-reader";
+/**
+ * Whether the host puts this row into the request draft under its own id. The
+ * decision reuses restoreRow, the local mirror of the host's row-to-message
+ * rendering, so the two cannot drift: an instruction-update `system` row, a
+ * background shell row or an empty user turn renders without the row id (or not
+ * at all) and can never be found again by a boundary lookup.
+ */
+export declare function hostServesRowById(row: StoreRow): boolean;
+/** Ordinals count conversational rows in the complete session, never a post-fold window.
+ * A window caller must supply the full history so compaction cannot reassign tag identities. */
+export declare function rawMessages(rows: readonly StoreRow[], history?: readonly StoreRow[]): RawMessage[];
+/** Project a SQL-bounded page whose first row follows `afterOrdinal`. */
+export declare function rawMessagePage(rows: readonly StoreRow[], afterOrdinal: number): RawMessage[];
+export interface V2RawMessageReader {
+    readPage(sessionID: string, afterOrdinal: number, limit: number, finalWatermark: number, after?: RawMessageOrdinalAnchor): RawMessage[];
+    findById(sessionID: string, messageID: string): RawMessage | null;
+    findPartsById(sessionID: string, messageID: string): RawMessageParts | null;
+    hasById(sessionID: string, messageID: string): boolean;
+    ordinalOf(sessionID: string, messageID: string): number | null;
+    ordinalMapForRange(sessionID: string, fromOrdinal: number, toOrdinal: number): Map<string, number>;
+    readOrdinalPage(sessionID: string, after: RawMessageOrdinalAnchor | null, limit: number): RawMessageOrdinalEntry[];
+    getCount(sessionID: string): number;
+    getStoredCount(sessionID: string): number;
+    /** Id of the row the host serves in place of `messageID`; see servedBoundaryRow. */
+    servedBoundaryIdOf?(sessionID: string, messageID: string): string | null;
+}
+/**
+ * The row a stored compartment boundary stands for in a request: the boundary
+ * row itself when the host serves it by id, otherwise the nearest earlier row
+ * that it does serve. Returns null when the id is not a conversational row in
+ * the store or no earlier served row exists; callers then keep the stored id.
+ */
+export declare function servedBoundaryRow(reader: Pick<V2StoreReader, "messageById" | "rawRowsThrough">, sessionID: string, messageID: string): StoreRow | null;
+/**
+ * The nearest user message at or before `endMessageID`, searched backward
+ * through the store a page at a time rather than by reading the whole session.
+ * Returns null when the id is absent, is not a conversational row, or has no
+ * user message at or before it (the rule `resolveBoundaryUserMessage` applies
+ * to an in-memory history).
+ */
+export declare function resolveV2BoundaryUserMessage(reader: Pick<V2StoreReader, "messageById" | "rawRowsThrough">, sessionID: string, endMessageID: string): RawMessage | null;
+/** The only V2 full-history reader: store-generation conversion must inspect every part. */
+export declare function readAllV2RawMessagesForConversion(openReader: () => V2StoreReader, sessionID: string): RawMessage[];
+/**
+ * `readAllV2RawMessagesForConversion`, a page at a time: the same messages with
+ * the same ordinals, but only one page of store rows is decoded and held at
+ * once. Ordinals count conversational rows across the whole session, so each
+ * page continues the count where the previous one stopped. The reader is
+ * closed when iteration ends, including when the consumer stops early.
+ */
+export declare function readV2RawMessagePagesForConversion(openReader: () => V2StoreReader, sessionID: string, pageRows?: number): Generator<RawMessage[], void, void>;
+/** Build the SQL-bounded reader used by context, indexing, and historian passes. */
+export declare function createV2RawMessageReader(openReader: () => V2StoreReader): V2RawMessageReader;
+export declare function createV2RawMessageProvider(reader: V2RawMessageReader, sessionID: string): BoundedRawMessageProvider;
+//# sourceMappingURL=store.d.ts.map

package/dist/v2/hooks/store.d.ts.map

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

package/dist/v2/hooks/tools.d.ts

@@ -0,0 +1,8 @@
+import type { MagicContextPluginConfig } from "../../config";
+import { type Database } from "../../shared/sqlite";
+import type { V2Context } from "./types";
+/** OpenCode 2 requires explicit tool-editor registration; it does not load the v1 tool map. */
+export declare function registerTools(context: V2Context, db: Database, config: MagicContextPluginConfig, isInternalChild?: (sessionId: string) => boolean): Promise<{
+    dispose: () => void;
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/v2/hooks/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAO7D,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,qBAAqB,CAAC;AAM/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,+FAA+F;AAC/F,wBAAsB,aAAa,CAC/B,OAAO,EAAE,SAAS,EAClB,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,wBAAwB,EAChC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO;;GA8EnD"}

package/dist/v2/hooks/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Roles of Magic Context's own hidden child sessions, mirrored in the host
+ * create metadata. "historian" is the original compartment carrier;
+ * "maintainer-a"/"maintainer-b" are the memory-maintenance carriers (plan 10
+ * decision 3: two agents, two sessions — A zero tools, B read-only).
+ */
+export type HiddenChildRole = "historian" | "maintainer-a" | "maintainer-b";
+export interface V2Message {
+    id?: string;
+    role: string;
+    content: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
+export interface SessionContext {
+    sessionID: string;
+    model: {
+        providerID: string;
+        id: string;
+        variant?: string;
+        limit?: {
+            context: number;
+            input?: number;
+            output?: number;
+        };
+    };
+    agent: string;
+    messages: V2Message[];
+    system: Array<Record<string, unknown>>;
+    tools: Record<string, {
+        description: string;
+        input: unknown;
+    }>;
+    options: Record<string, unknown>;
+    result?: {
+        summary: string;
+    };
+}
+export interface V2AgentEditor {
+    update(id: string, update: (agent: {
+        system?: string;
+        description?: string;
+        mode: "subagent" | "primary" | "all";
+        hidden: boolean;
+        steps?: number;
+        request: {
+            settings: Record<string, unknown>;
+            headers: Record<string, string>;
+            body: Record<string, unknown>;
+        };
+        permissions: Array<{
+            action: string;
+            resource: string;
+            effect: "allow" | "deny" | "ask";
+        }>;
+    }) => void): void;
+}
+export interface V2AgentDomain {
+    reload(): Promise<void>;
+    transform(callback: (editor: V2AgentEditor) => void): Promise<unknown>;
+}
+/** What the host hands a registered command when a client invokes it. */
+export interface V2CommandInvocation {
+    sessionID: string;
+    /** `text` is the argument remainder the client typed after the command name. */
+    prompt: {
+        text: string;
+    };
+    delivery: string;
+}
+export interface V2CommandEditor {
+    add(definition: {
+        name: string;
+        description?: string;
+        execute: (input: V2CommandInvocation) => Promise<void>;
+    }): void;
+}
+/**
+ * Server-side command registry. The host keeps the added definitions in a
+ * location-scoped map that `GET /api/command` lists and
+ * `POST /api/session/:sessionID/command` executes, so a command registered here
+ * is reachable from every client, not only the terminal UI.
+ */
+export interface V2CommandDomain {
+    transform(callback: (editor: V2CommandEditor) => void): Promise<unknown>;
+    reload(): Promise<void>;
+}
+export interface V2Context {
+    location: {
+        directory: string;
+    };
+    agent: V2AgentDomain;
+    /** Absent on hosts predating the command domain; registration is then skipped. */
+    command?: V2CommandDomain;
+    event: {
+        subscribe(options: {
+            signal: AbortSignal;
+        }): AsyncIterable<unknown>;
+    };
+    model: {
+        list(): Promise<{
+            data: Array<{
+                id: string;
+                providerID: string;
+                limit: {
+                    context: number;
+                };
+            }>;
+        }> | Promise<Array<{
+            id: string;
+            providerID: string;
+            limit: {
+                context: number;
+            };
+        }>> | Array<{
+            id: string;
+            providerID: string;
+            limit: {
+                context: number;
+            };
+        }> | {
+            data: Array<{
+                id: string;
+                providerID: string;
+                limit: {
+                    context: number;
+                };
+            }>;
+        };
+    };
+    storage: {
+        get(key: string): Promise<unknown>;
+        set(key: string, value: unknown): Promise<void>;
+    };
+    tool: {
+        transform?(callback: (editor: {
+            update(id: string, update: (tool: {
+                description: string;
+            }) => void): void;
+            add?(tool: {
+                name: string;
+                description: string;
+                input: unknown;
+                options?: {
+                    codemode: boolean;
+                };
+                execute(input: unknown, context: {
+                    sessionID: string;
+                    messageID: string;
+                    agent: string;
+                    progress(value: Record<string, unknown>): Promise<void>;
+                }): Promise<{
+                    content: string;
+                }>;
+            }): void;
+        }) => void): Promise<unknown>;
+        hook(name: "execute.before" | "execute.after", callback: (draft: {
+            tool: string;
+            sessionID: string;
+            input: unknown;
+            status?: string;
+            result?: {
+                content?: unknown;
+            };
+        }) => void | Promise<void>): Promise<unknown>;
+    };
+    session: {
+        create(input: {
+            title: string;
+            agent: string;
+            model: {
+                providerID: string;
+                id: string;
+                variant?: string;
+            };
+            location: {
+                directory: string;
+            };
+            metadata: {
+                magic_context: "hidden-run";
+                role: HiddenChildRole;
+            };
+            /** Kept only by hosts that also have the optional `session.remove` declared below. */
+            parentID?: string;
+        }): Promise<{
+            id: string;
+        }>;
+        get(input: {
+            sessionID: string;
+        }): Promise<{
+            model?: {
+                providerID: string;
+                id: string;
+                variant?: string;
+            };
+            parentID?: string;
+            /** The directory the host bound the session to when it was created. */
+            location?: {
+                directory?: string;
+            };
+        }>;
+        switchModel(input: {
+            sessionID: string;
+            model: {
+                providerID: string;
+                id: string;
+                variant?: string;
+            };
+        }): Promise<void>;
+        prompt(input: {
+            sessionID: string;
+            text: string;
+        }): Promise<unknown>;
+        wait(input: {
+            sessionID: string;
+        }): Promise<void>;
+        update(input: {
+            sessionID: string;
+            title: string;
+        }): Promise<void>;
+        synthetic(input: {
+            sessionID: string;
+            id: string;
+            text: string;
+            delivery: "steer";
+        }): Promise<unknown>;
+        hook(name: "http.response", callback: (draft: {
+            sessionID: string;
+            model: {
+                providerID: string;
+                id: string;
+            };
+            kind: string;
+            response: Response;
+        }) => Promise<void>): Promise<unknown>;
+        hook(name: "context" | "compaction" | "generate", callback: (draft: SessionContext) => Promise<void>): Promise<unknown>;
+        interrupt(input: {
+            sessionID: string;
+        }): Promise<{
+            interrupted: boolean;
+        }>;
+        /**
+         * Present only on OpenCode 2 builds newer than 2.0.21, so it is optional and must be
+         * feature-checked (`typeof remove === "function"`), never inferred from a version.
+         */
+        remove?(input: {
+            sessionID: string;
+        }): Promise<void>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/v2/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/types.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5E,MAAM,WAAW,SAAS;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AACD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChE,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AACD,MAAM,WAAW,aAAa;IAC1B,MAAM,CACF,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,CAAC,KAAK,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;QACrC,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACjC,CAAC;QACF,WAAW,EAAE,KAAK,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;SACpC,CAAC,CAAC;KACN,KAAK,IAAI,GACX,IAAI,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,UAAU,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1D,GAAG,IAAI,CAAC;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,kFAAkF;IAClF,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE;QAAE,SAAS,CAAC,OAAO,EAAE;YAAE,MAAM,EAAE,WAAW,CAAA;SAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC/E,KAAK,EAAE;QACH,IAAI,IACE,OAAO,CAAC;YACJ,IAAI,EAAE,KAAK,CAAC;gBACR,EAAE,EAAE,MAAM,CAAC;gBACX,UAAU,EAAE,MAAM,CAAC;gBACnB,KAAK,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC9B,CAAC,CAAC;SACN,CAAC,GACF,OAAO,CACH,KAAK,CAAC;YACF,EAAE,EAAE,MAAM,CAAC;YACX,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;SAC9B,CAAC,CACL,GACD,KAAK,CAAC;YACF,EAAE,EAAE,MAAM,CAAC;YACX,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;SAC9B,CAAC,GACF;YACI,IAAI,EAAE,KAAK,CAAC;gBACR,EAAE,EAAE,MAAM,CAAC;gBACX,UAAU,EAAE,MAAM,CAAC;gBACnB,KAAK,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC9B,CAAC,CAAC;SACN,CAAC;KACX,CAAC;IACF,OAAO,EAAE;QACL,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,CAAC;IACF,IAAI,EAAE;QACF,SAAS,CAAC,CACN,QAAQ,EAAE,CAAC,MAAM,EAAE;YACf,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE;gBAAE,WAAW,EAAE,MAAM,CAAA;aAAE,KAAK,IAAI,GAAG,IAAI,CAAC;YAC1E,GAAG,CAAC,CAAC,IAAI,EAAE;gBACP,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;gBACpB,KAAK,EAAE,OAAO,CAAC;gBACf,OAAO,CAAC,EAAE;oBAAE,QAAQ,EAAE,OAAO,CAAA;iBAAE,CAAC;gBAChC,OAAO,CACH,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;oBACL,SAAS,EAAE,MAAM,CAAC;oBAClB,SAAS,EAAE,MAAM,CAAC;oBAClB,KAAK,EAAE,MAAM,CAAC;oBACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;iBAC3D,GACF,OAAO,CAAC;oBAAE,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAC,CAAC;aACnC,GAAG,IAAI,CAAC;SACZ,KAAK,IAAI,GACX,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CACA,IAAI,EAAE,gBAAgB,GAAG,eAAe,EACxC,QAAQ,EAAE,CAAC,KAAK,EAAE;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,OAAO,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC;SAClC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACL,MAAM,CAAC,KAAK,EAAE;YACV,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC5D,QAAQ,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAChC,QAAQ,EAAE;gBAAE,aAAa,EAAE,YAAY,CAAC;gBAAC,IAAI,EAAE,eAAe,CAAA;aAAE,CAAC;YACjE,sFAAsF;YACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;SACrB,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5B,GAAG,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YACvC,KAAK,CAAC,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,uEAAuE;YACvE,QAAQ,CAAC,EAAE;gBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SACrC,CAAC,CAAC;QACH,WAAW,CAAC,KAAK,EAAE;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SAC/D,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,SAAS,CAAC,KAAK,EAAE;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,OAAO,CAAC;SACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CACA,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,CAAC,KAAK,EAAE;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YAC1C,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,QAAQ,CAAC;SACtB,KAAK,OAAO,CAAC,IAAI,CAAC,GACpB,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CACA,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,EAC3C,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,SAAS,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,WAAW,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC3E;;;WAGG;QACH,MAAM,CAAC,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACxD,CAAC;CACL"}

package/dist/v2/hooks/usage-persist.d.ts

@@ -0,0 +1,31 @@
+import { type ContextDatabase } from "../../features/magic-context/storage";
+import type { TransformDeps } from "../../hooks/magic-context/transform";
+import { type UsageReading } from "./usage-reading";
+export interface PersistV2UsageReadingArgs {
+    db: ContextDatabase;
+    sessionID: string;
+    draftModel: {
+        providerID: string;
+        id: string;
+    };
+    reading: UsageReading;
+    contextUsageMap: TransformDeps["contextUsageMap"];
+}
+/**
+ * Record the usage OpenCode stored for the latest completed reply.
+ *
+ * The reading is the prompt size of a request the provider accepted, so it is
+ * real pressure at any size. It is never compared with the configured window:
+ * that window can be smaller than what the model actually serves, and a reading
+ * past it is real overflow of the user's limit for the scheduler to handle.
+ *
+ * A reading never refuses the next request by itself. However high it is, the
+ * next transform pass has to run, because that pass is the only thing that can
+ * shrink the session (the force band's queued drops and emergency reclaim, the
+ * historian, a fold). Refusing on the reading would leave it unchanged and
+ * refuse again on every later turn. The transform refuses only after its own
+ * pass, and only when the provider has rejected the request as too large and
+ * that pass folded nothing, the same rule OpenCode 1 and Pi follow.
+ */
+export declare function persistV2UsageReading(args: PersistV2UsageReadingArgs): void;
+//# sourceMappingURL=usage-persist.d.ts.map

package/dist/v2/hooks/usage-persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-persist.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/usage-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAMzE,OAAO,EAAE,KAAK,YAAY,EAA4B,MAAM,iBAAiB,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CA2D3E"}

package/dist/v2/hooks/usage-reading.d.ts

@@ -0,0 +1,46 @@
+export interface UsageReadingInput {
+    rowModel?: {
+        providerID?: unknown;
+        id?: unknown;
+    };
+    draftModel: {
+        providerID: string;
+        id: string;
+    };
+    tokens?: {
+        input?: number;
+        output?: number;
+        cache?: {
+            read?: number;
+            write?: number;
+        };
+    };
+    completed?: number;
+    finish?: string;
+    error?: unknown;
+    /** Resolve the output-reserved usable window for a model. */
+    limitFor: (providerID: string, modelID: string) => number;
+}
+export interface UsageReading {
+    inputTokens: number;
+    /** Window of the model that produced the persisted reading. */
+    limit: number;
+    /** Window the outgoing draft will use for admission. */
+    admissionLimit: number;
+    /** Absent when a legacy row carries no model metadata. */
+    modelKey?: string;
+    completed?: number;
+    finish?: string;
+    error?: unknown;
+}
+export declare function usageReadingMatchesDraft(reading: UsageReading, draftModel: {
+    providerID: string;
+    id: string;
+}): boolean;
+/**
+ * Attribute stored usage to the model that produced it while measuring the next
+ * request against the outgoing draft model. Partial or non-finite token fields
+ * contribute zero rather than poisoning persisted percentages.
+ */
+export declare function resolveUsageReading(input: UsageReadingInput): UsageReading | undefined;
+//# sourceMappingURL=usage-reading.d.ts.map

package/dist/v2/hooks/usage-reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reading.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/usage-reading.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7C,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7D;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAsCtF"}

package/dist/v2/server.d.ts

@@ -0,0 +1,27 @@
+import type { V2Context } from "./hooks/types";
+/**
+ * Only an OpenCode 2 host hands `setup` a context carrying `session.hook`.
+ * The package's default export is the union `{ id, server, setup }`, and a
+ * v1 host that finds `setup` on it must not run the v2 lane: locking the
+ * harness to "opencode2" there mis-tags every row that seat writes.
+ *
+ * Proven against the shipped OpenCode 1.18.30 binary and traced to source at
+ * tag v1.18.31: the v1 loader (`packages/opencode/src/plugin/index.ts`) calls
+ * `server()`, and independently the bundled core external-plugin layer
+ * (`packages/core/src/plugin/promise.ts:90`) adopts any module whose default
+ * export matches `{ id, setup }` (`core/src/config/plugin/external.ts:15-30`)
+ * and calls `setup(context)` with the 1.18-era v2 host surface
+ * (`core/src/plugin/host.ts:30-208`): keys `[options, agent, aisdk, catalog,
+ * command, integration, plugin, reference, skill]`, no `session`.
+ * `registerContext` then throws on `context.session.hook`; that layer discards
+ * the failure with `Effect.ignoreCause`, so nothing surfaced while the harness
+ * stayed locked to "opencode2" for the rest of the v1 process.
+ */
+export declare function isOpenCode2HostContext(context: unknown): context is V2Context;
+export declare function setup(context: V2Context): Promise<() => Promise<void>>;
+declare const _default: {
+    id: string;
+    setup: typeof setup;
+};
+export default _default;
+//# sourceMappingURL=server.d.ts.map

package/dist/v2/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/v2/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,SAAS,CAQ7E;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,SAAS,gCAwB7C;;;;;AAED,wBAGE"}