@cortexkit/opencode-magic-context 0.47.0 → 0.48.0

package/src/v2/tui/host-contract.test.ts

@@ -1,10 +1,12 @@
-import { afterEach, expect, spyOn, test } from "bun:test";
+import { afterEach, expect, test } from "bun:test";
 import { rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { resolve } from "node:path";
 import { Host } from "@opencode/plugin/host";
-import * as logger from "../../shared/logger";
+import type { MagicContextRpcServer } from "../../shared/rpc-server";
 import { createTestTempDirFromPath } from "../../shared/test-temp-dir";
+import { registerV2Commands } from "../hooks/commands";
+import type { V2CommandDomain } from "../hooks/types";
 import { setupWithJsx } from "./index";
 import type { V2SidebarState, V2SlotClaim, V2TuiContext } from "./types";
 
@@ -110,7 +112,7 @@ function v1Api(directory: string) {
     };
 }
 
-test("GA 2.0.5 resolves ./tui and executes the union setup contract", async () => {
+test("GA 2.0.5 registers each /ctx-* command once on the server, not the TUI keymap", async () => {
     const packageRoot = resolve(import.meta.dir, "../../..");
     const entrypoints = Host.resolve({
         name: "@cortexkit/opencode-magic-context",
@@ -125,76 +127,48 @@ test("GA 2.0.5 resolves ./tui and executes the union setup contract", async () =
         };
     };
     expect(typeof loaded.default.setup).toBe("function");
-    const fixture = v2Context();
-    const cleanup = await setupWithJsx(fixture.context, (type, props) => ({ type, props }));
-    expect(fixture.claims.map((claim) => claim.append)).toEqual(["sidebar.content"]);
-    const sidebarClaim = fixture.claims[0]!;
-    if (sidebarClaim.append !== "sidebar.content") throw new Error("expected the sidebar claim");
-    expect(sidebarClaim.render({ sessionID: "ses-v2-tui" })).toEqual({
-        type: "text",
-        props: { children: expect.stringContaining("Magic Context") },
-    });
-    expect(fixture.layers[0]!.commands.map((command) => command.slash.name)).toEqual([
-        "ctx-status",
-        "ctx-recomp",
-        "ctx-dream",
-        "ctx-flush",
-        "ctx-embed",
-        "ctx-wrapup",
-    ]);
-    cleanup();
-});
-
-test("GA 2.0.5 registers the keymap layer from the app slot when setup runs outside the provider", async () => {
-    const fixture = v2Context();
-    let providerAvailable = false;
-    Object.assign(fixture.context.keymap, {
-        layer: (input: () => unknown) => {
-            if (!providerAvailable) throw new Error("Keymap.Provider is missing");
-            fixture.layers.push(input() as never);
+    const serverCommands: string[] = [];
+    const commandDomain: V2CommandDomain = {
+        async transform(callback) {
+            callback({ add: (definition) => serverCommands.push(definition.name) });
         },
+        async reload() {},
+    };
+    const serverRegistered = await registerV2Commands({
+        command: commandDomain,
+        rpc: { dispatch: async () => ({}) } as unknown as MagicContextRpcServer,
+        directory: process.cwd(),
+        compactionEnabled: true,
     });
-    const cleanup = await setupWithJsx(fixture.context, (type, props) => ({ type, props }));
-    expect(fixture.claims.map((claim) => claim.append)).toEqual(["sidebar.content", "app"]);
-    expect(fixture.layers).toHaveLength(0);
+    expect(serverRegistered).toBe(true);
 
-    // The app slot render executes inside the component tree, where the provider resolves.
-    providerAvailable = true;
-    const appClaim = fixture.claims.find((claim) => claim.append === "app");
-    if (appClaim?.append !== "app") throw new Error("expected the app slot claim");
-    appClaim.render({});
-    expect(
-        fixture.layers.map((layer) => layer.commands.map((command) => command.slash.name)),
-    ).toEqual([["ctx-status", "ctx-recomp", "ctx-dream", "ctx-flush", "ctx-embed", "ctx-wrapup"]]);
-    // Repeated renders must not stack duplicate layers.
-    appClaim.render({});
-    expect(fixture.layers).toHaveLength(1);
-    cleanup();
-});
-
-test("GA 2.0.5 keeps the sidebar when the app-slot keymap registration also fails", async () => {
     const fixture = v2Context();
-    Object.assign(fixture.context.keymap, {
-        layer: () => {
-            throw new Error("Keymap.Provider is missing");
-        },
-    });
-    // The gap is recorded in the plugin log; the TUI host drops console output.
-    const logged = spyOn(logger, "log");
+    const cleanup = await setupWithJsx(fixture.context, (type, props) => ({ type, props }));
     try {
-        const cleanup = await setupWithJsx(fixture.context, (type, props) => ({ type, props }));
-        expect(fixture.claims.map((claim) => claim.append)).toEqual(["sidebar.content", "app"]);
-        const appClaim = fixture.claims.find((claim) => claim.append === "app");
-        if (appClaim?.append !== "app") throw new Error("expected the app slot claim");
-        appClaim.render({});
-        appClaim.render({});
-        expect(fixture.layers).toHaveLength(0);
-        expect(
-            logged.mock.calls.filter(([line]) => line.includes("keymap.layer is unavailable")),
-        ).toHaveLength(1);
-        cleanup();
+        expect(fixture.claims.map((claim) => claim.append)).toEqual(["sidebar.content"]);
+        const sidebarClaim = fixture.claims[0]!;
+        if (sidebarClaim.append !== "sidebar.content")
+            throw new Error("expected the sidebar claim");
+        expect(sidebarClaim.render({ sessionID: "ses-v2-tui" })).toEqual({
+            type: "text",
+            props: { children: expect.stringContaining("Magic Context") },
+        });
+        const tuiCommands = fixture.layers.flatMap((layer) =>
+            layer.commands.map((command) => command.slash.name),
+        );
+        const allRegistrations = [...serverCommands, ...tuiCommands].sort();
+        const expectedCommands = [
+            "ctx-dream",
+            "ctx-embed",
+            "ctx-flush",
+            "ctx-recomp",
+            "ctx-status",
+            "ctx-wrapup",
+        ];
+        expect(allRegistrations).toEqual(expectedCommands);
+        expect(new Set(allRegistrations).size).toBe(expectedCommands.length);
     } finally {
-        logged.mockRestore();
+        cleanup();
     }
 });
 

package/src/v2/tui/index.ts

@@ -1,23 +1,18 @@
 import { createElement, spread } from "@opentui/solid";
 import { COMPACTION_ENABLED_PATH } from "../../config/agent-disable";
-import { flushLogger, log } from "../../shared/logger";
+import { log } from "../../shared/logger";
 import { pluginPackageVersion } from "../../shared/plugin-package-version";
 import type { SidebarSnapshot, StatusDetail } from "../../shared/rpc-types";
 import { buildUnavailableStatusView } from "../../shared/status-view";
 import { statusVersionNotice } from "../../shared/status-view-check";
 import { compactionOffSidebarRows, nativeCompactionContextLabel } from "../../tui/compaction-off";
 import {
-    type CommandRpcResult,
     closeRpc,
     getCompartmentCount,
     initRpcClient,
     loadSidebarSnapshot,
     loadStatusDetail,
-    requestDream,
-    requestEmbed,
-    requestFlush,
     requestRecomp,
-    requestWrapup,
     type StatusDetailResult,
 } from "../../tui/data/context-db";
 import {
@@ -29,7 +24,7 @@ import { directoryForSession } from "../../tui/data/session-directory";
 import { eventSessionID } from "./events";
 import { mountV1Sidebar, sessionDirectory, type V1SidebarMount } from "./sidebar-mount";
 import { mountV1StatusDialog, type V1StatusDialogMount } from "./status-dialog-mount";
-import type { V2KeymapLayer, V2SidebarState, V2TuiContext } from "./types";
+import type { V2SidebarState, V2TuiContext } from "./types";
 
 const SIDEBAR_REFRESH_MS = 1_000;
 const inflight = new Set<string>();
@@ -174,6 +169,9 @@ type JsxFactory = (type: string, props: Record<string, unknown>) => unknown;
 
 export async function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Promise<() => void> {
     const directory = context.location?.directory ?? context.data.location.default().directory;
+    // The server command registry is the single /ctx-* registration for OpenCode 2.
+    // This TUI handles its notifications; a keymap slash layer would duplicate the
+    // palette entries and would not be available to clients without a TUI.
     initRpcClient(directory);
     const [sidebar, updateSidebar] = context.storage.memory<V2SidebarState>(
         "magic-context.sidebar.v2",
@@ -264,22 +262,6 @@ export async function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Prom
         return requested;
     };
 
-    const showDream = async (task?: string) => {
-        const target = currentSessionID(context);
-        if (!target) {
-            context.ui.toast.show({ message: "No active session", variant: "warning" });
-            return false;
-        }
-        const started = await requestDream(target, task);
-        context.ui.toast.show({
-            message: started
-                ? "Dream run started; the summary appears when it finishes"
-                : "Dream request failed",
-            variant: started ? "info" : "error",
-        });
-        return started;
-    };
-
     // One sidebar: the OpenCode 1 component, mounted on the v2 slot through the
     // host's own OpenTUI runtime. `mountV1Sidebar` returns null only when the
     // host registers no runtime modules to load it through, which is the single
@@ -311,196 +293,6 @@ export async function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Prom
         },
     });
 
-    // Every /ctx-* command this host can reach goes through the keymap layer:
-    // OpenCode 2 has no `command.execute.before` hook, so the server-side command
-    // handler the OpenCode 1 plugin uses never runs here. Each `run` calls the
-    // RPC handler that does the same server-side work and reports back through a
-    // dialog or toast, because this host has no ignored-message chat carrier.
-    const runCommandRpc = async (
-        title: string,
-        call: (sessionID: string) => Promise<CommandRpcResult>,
-        pending?: string,
-    ): Promise<boolean> => {
-        const target = currentSessionID(context);
-        if (!target) {
-            context.ui.toast.show({ message: "No active session", variant: "warning" });
-            return false;
-        }
-        const result = await call(target);
-        if (!result.ok) {
-            context.ui.toast.show({
-                message: result.error ?? `${title} request failed`,
-                variant: "error",
-            });
-            return false;
-        }
-        // A started background run has no text yet; its outcome arrives later as a
-        // show-result-dialog notification.
-        if (result.started) {
-            context.ui.toast.show({ message: pending ?? `${title} started`, variant: "info" });
-            return true;
-        }
-        if (currentSessionID(context) !== target) return false;
-        await context.ui.dialog.alert({ title, message: result.message ?? "" });
-        return true;
-    };
-
-    // OpenCode 2 runs plugin setup() outside the TUI component tree, where
-    // context.keymap.layer() throws "Keymap.Provider is missing" (the provider is
-    // a Solid context). Try the direct call first (hosts that do run setup
-    // in-tree), then fall back to the app slot: its render executes inside the
-    // component tree, the same place the host's own built-in plugins register
-    // their layers.
-    const buildKeymapLayer = (): V2KeymapLayer => ({
-        mode: "global",
-        commands: [
-            {
-                id: "magic-context.status",
-                title: "Magic Context: Status",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-status" },
-                run: async () => {
-                    await showStatus();
-                },
-            },
-            {
-                id: "magic-context.recomp",
-                title: "Magic Context: Recomp",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-recomp" },
-                run: async () => {
-                    await showRecomp();
-                },
-            },
-            {
-                id: "magic-context.dream",
-                title: "Magic Context: Dream",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-dream", arguments: true },
-                run: async (input) => {
-                    await showDream(input?.trim() || undefined);
-                },
-            },
-            {
-                id: "magic-context.flush",
-                title: "Magic Context: Flush",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-flush" },
-                run: async () => {
-                    const flushed = await runCommandRpc("Flush", requestFlush);
-                    if (flushed) void refresh(currentSessionID(context) ?? "", true);
-                },
-            },
-            {
-                id: "magic-context.embed",
-                title: "Magic Context: Embed",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-embed", arguments: true },
-                run: async (input) => {
-                    const argument = input?.trim().toLowerCase() ?? "";
-                    if (argument !== "" && argument !== "start" && argument !== "pause") {
-                        context.ui.toast.show({
-                            message:
-                                "Usage: /ctx-embed (status), /ctx-embed start, or /ctx-embed pause",
-                            variant: "warning",
-                        });
-                        return;
-                    }
-                    const action = argument === "" ? "status" : argument;
-                    await runCommandRpc(
-                        "Embed",
-                        (sessionID) => requestEmbed(sessionID, action, directory),
-                        "Embedding started; the summary appears when it finishes",
-                    );
-                },
-            },
-            {
-                id: "magic-context.wrapup",
-                title: "Magic Context: Wrapup",
-                group: "Magic Context",
-                palette: true,
-                slash: { name: "ctx-wrapup", arguments: true },
-                run: async (input) => {
-                    const argument = input?.trim() ?? "";
-                    if (argument !== "" && !/^\d+$/.test(argument)) {
-                        context.ui.toast.show({
-                            message:
-                                "Usage: /ctx-wrapup [messages_to_keep] where messages_to_keep is a positive integer",
-                            variant: "warning",
-                        });
-                        return;
-                    }
-                    const messagesToKeep = argument === "" ? 20 : Number.parseInt(argument, 10);
-                    if (messagesToKeep <= 0) {
-                        context.ui.toast.show({
-                            message: "messages_to_keep must be a positive integer",
-                            variant: "warning",
-                        });
-                        return;
-                    }
-                    await runCommandRpc(
-                        "Wrapup",
-                        (sessionID) => requestWrapup(sessionID, messagesToKeep),
-                        "Wrapup started; the summary appears when it finishes",
-                    );
-                },
-            },
-        ],
-    });
-    let keymapLayerRegistered = false;
-    let keymapGapLogged = false;
-    const registerKeymapLayer = (): boolean => {
-        if (keymapLayerRegistered) return true;
-        try {
-            context.keymap.layer(buildKeymapLayer);
-            keymapLayerRegistered = true;
-            // The accepted layer is the only place that knows which slash commands
-            // this host actually got, so report them from it. Anything missing here
-            // is missing from the host's command palette too. It goes to the
-            // diagnostic log because a TUI host owns the screen and drops plugin
-            // console output.
-            const registered = `registered slash commands: ${buildKeymapLayer()
-                .commands.map((command) => command.slash.name)
-                .join(" ")}`;
-            log(`[magic-context] ${registered}`);
-            // Startup lines are worth an immediate write: a TUI that exits or is
-            // killed before the next buffer flush would otherwise leave no record
-            // of which commands this host received.
-            flushLogger();
-            return true;
-        } catch (error) {
-            if (!(error instanceof Error) || error.message !== "Keymap.Provider is missing")
-                throw error;
-            return false;
-        }
-    };
-    let unregisterKeymapSlot: (() => void) | undefined;
-    if (!registerKeymapLayer()) {
-        unregisterKeymapSlot = context.ui.slot({
-            append: "app",
-            render: () => {
-                let registered = false;
-                try {
-                    registered = registerKeymapLayer();
-                } catch (error) {
-                    log("[magic-context] keymap.layer registration failed", error);
-                }
-                if (!registered && !keymapGapLogged) {
-                    keymapGapLogged = true;
-                    log(
-                        "[magic-context] OpenCode 2 keymap.layer is unavailable; /ctx-status, /ctx-recomp, /ctx-dream, /ctx-flush, /ctx-embed and /ctx-wrapup were not registered",
-                    );
-                }
-                return null;
-            },
-        });
-    }
-
     // Only the text projection needs the sidebar snapshot store; the mounted
     // component keeps its own snapshot and subscribes to the same event stream
     // itself.
@@ -537,6 +329,7 @@ export async function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Prom
         if (notification.payload.action === "refresh-sidebar" && target) {
             if (mountedSidebar) mountedSidebar.refresh();
             else await refresh(target, true);
+            log(`[magic-context] sidebar refresh requested for session ${target}`);
             return true;
         }
         if (notification.payload.action === "show-result-dialog") {
@@ -565,7 +358,6 @@ export async function setupWithJsx(context: V2TuiContext, jsx: JsxFactory): Prom
         mountedSidebar?.dispose();
         mountedSidebar = null;
         statusDialog = null;
-        unregisterKeymapSlot?.();
         stopListening();
         stopNotificationSocket();
         closeRpc();

package/src/v2/tui/types.ts

@@ -119,23 +119,11 @@ export interface V2TuiContext {
     };
 }
 
-/**
- * A slot claim's `render` runs inside the host's component tree; `app` is the
- * always-mounted root slot, which is where `keymap.layer()` can be called from
- * when plugin `setup()` runs outside the keymap provider (see index.ts).
- */
-export type V2SlotClaim =
-    | {
-          readonly append: "sidebar.content";
-          readonly render: (input: { readonly sessionID: string }) => unknown;
-      }
-    | {
-          readonly append: "app";
-          readonly render: (input: Readonly<Record<string, never>>) => unknown;
-      };
-
-/** The layer object `context.keymap.layer()` accepts, derived from the context type. */
-export type V2KeymapLayer = ReturnType<Parameters<V2TuiContext["keymap"]["layer"]>[0]>;
+/** The sidebar slot used by the OpenCode 2 TUI. */
+export type V2SlotClaim = {
+    readonly append: "sidebar.content";
+    readonly render: (input: { readonly sessionID: string }) => unknown;
+};
 
 export interface V2SidebarState {
     snapshots: Record<string, SidebarSnapshot | undefined>;

package/dist/features/magic-context/checkout-claim-fake-subc.test-support.d.ts

@@ -1,45 +0,0 @@
-export interface FakeSubcRoute {
-    target: Record<string, unknown>;
-    identity: Record<string, unknown>;
-    consumerIdentity: unknown;
-}
-export interface FakeSubcCall {
-    route: FakeSubcRoute;
-    method: string;
-    params: unknown;
-}
-/** `result` is sent as `{"result": ...}`; `error` as an Error frame; `hang` never answers. */
-export type FakeSubcReply = {
-    result: unknown;
-} | {
-    error: {
-        code: string;
-        message: string;
-    };
-} | {
-    hang: true;
-};
-export interface FakeSubcDaemon {
-    readonly connectionFile: string;
-    readonly port: number;
-    /** Every route.open, in arrival order. */
-    readonly routeOpens: FakeSubcRoute[];
-    /** Every data-plane request, in arrival order. */
-    readonly calls: FakeSubcCall[];
-    close(): Promise<void>;
-}
-/**
- * Start the fake daemon and write its connection file (mode 0600, as the real
- * client requires) at `connectionFile`.
- */
-export declare function startFakeSubcDaemon(connectionFile: string, respond: (call: FakeSubcCall) => FakeSubcReply | Promise<FakeSubcReply>): Promise<FakeSubcDaemon>;
-/**
- * The fleet as the checkout-claim check sees it: ALF maps sessions to agents,
- * engram reports each agent's claim. Anything not listed answers as ALF and
- * engram do for unknown subjects (`agent_id: null`, an unclaimed epoch-0 view).
- */
-export declare function fakeFleetResponder(fleet: {
-    agents: Record<string, string>;
-    claims: Record<string, Record<string, unknown>>;
-}): (call: FakeSubcCall) => FakeSubcReply;
-//# sourceMappingURL=checkout-claim-fake-subc.test-support.d.ts.map

package/dist/features/magic-context/checkout-claim-fake-subc.test-support.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkout-claim-fake-subc.test-support.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/checkout-claim-fake-subc.test-support.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GACnB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAkDD;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GACxE,OAAO,CAAC,cAAc,CAAC,CAkHzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,aAAa,CAqBxC"}

package/dist/features/magic-context/checkout-claim.d.ts

@@ -1,155 +0,0 @@
-export declare const ALF_MODULE_ID = "prefrontal-core";
-export declare const ALF_AGENT_FOR_HOST_SESSION_OP = "agent.for_host_session";
-export declare const ENGRAM_MODULE_ID = "engram";
-export declare const ENGRAM_AGENT_SYNC_SERVICE_ID = "agent-sync";
-export declare const ENGRAM_CLAIM_READ_OP = "claim.read";
-/** How long an admitted verdict (checked or not) is reused for a session. */
-export declare const CHECKOUT_CLAIM_TTL_MS = 60000;
-/**
- * How long a refusal is reused. Short, so that a turn retried after the agent
- * moves back to this machine goes through without waiting out the full TTL,
- * while the several passes of one refused turn still share one check.
- */
-export declare const CHECKOUT_CLAIM_REFUSAL_RECHECK_MS = 5000;
-/** The whole check (connect, both queries) must finish within this budget. */
-export declare const CHECKOUT_CLAIM_CHECK_TIMEOUT_MS = 1500;
-export declare const CHECKOUT_CLAIM_REFUSAL_CODE = "checkout_claim_held_elsewhere";
-/** ALF's harness names for host sessions. OMP runs the Pi plugin and its sessions are Pi's. */
-export type CheckoutClaimHarness = "opencode" | "pi";
-export type CheckoutClaimOutcome = {
-    verdict: "admit";
-    reason: "no_agent" | "held_here" | "unclaimed" | "not_held_elsewhere";
-    agentId: string | null;
-    epoch?: number;
-} | {
-    verdict: "admit_unchecked";
-    reason: "not_configured" | "error" | "timeout" | "invalid_reply";
-    stage: "connect" | "agent" | "claim";
-    agentId?: string;
-    code?: string;
-    detail: string;
-} | {
-    verdict: "refuse";
-    agentId: string;
-    holder: string | null;
-    epoch: number | null;
-};
-/** One connected client for a single check. Each query resolves to the module's reply body. */
-export interface CheckoutClaimConnection {
-    agentForHostSession(params: {
-        harness: CheckoutClaimHarness;
-        session: string;
-    }, timeoutMs: number): Promise<unknown>;
-    claimRead(params: {
-        subject: string;
-    }, timeoutMs: number): Promise<unknown>;
-    close(): void;
-}
-/** Opens a connection for one check, or returns null when subc is not configured on this machine. */
-export type CheckoutClaimConnector = (args: {
-    harness: CheckoutClaimHarness;
-    sessionId: string;
-    projectRoot: string;
-    timeoutMs: number;
-}) => Promise<CheckoutClaimConnection | null>;
-export declare function renderCheckoutClaimRefusal(holder: string | null, epoch: number | null): string;
-/** The turn is refused because another machine holds the session's agent. */
-export declare class CheckoutClaimRefusalError extends Error {
-    readonly code = "checkout_claim_held_elsewhere";
-    readonly userFacingCode: "MC-C16";
-    readonly agentId: string;
-    readonly holder: string | null;
-    readonly epoch: number | null;
-    constructor(args: {
-        agentId: string;
-        holder: string | null;
-        epoch: number | null;
-    });
-}
-/** Matches the refusal across bundled copies of this module, which do not share the class. */
-export declare function isCheckoutClaimRefusalError(error: unknown): error is CheckoutClaimRefusalError;
-type ParsedAgent = {
-    ok: true;
-    agentId: string | null;
-} | {
-    ok: false;
-    detail: string;
-};
-export declare function parseAgentForHostSessionReply(reply: unknown): ParsedAgent;
-type ParsedClaim = {
-    ok: true;
-    heldElsewhere: boolean;
-    heldHere: boolean;
-    epoch: number;
-    holder: string | null;
-} | {
-    ok: false;
-    detail: string;
-};
-export declare function parseClaimReadReply(reply: unknown): ParsedClaim;
-/**
- * Run one check end to end within `timeoutMs`. Never throws: every way the
- * check can fail to finish is an `admit_unchecked` outcome.
- */
-export declare function readCheckoutClaim(args: {
-    connector: CheckoutClaimConnector;
-    harness: CheckoutClaimHarness;
-    sessionId: string;
-    projectRoot: string;
-    timeoutMs: number;
-    now?: () => number;
-}): Promise<CheckoutClaimOutcome>;
-/**
- * The production connector: a fresh subc client per check, authenticated as a
- * direct caller (both queries admit direct callers), closed when the check ends.
- */
-export declare function subcCheckoutClaimConnector(connectionFile: () => string): CheckoutClaimConnector;
-export interface CheckoutClaimGateOptions {
-    harness: CheckoutClaimHarness;
-    connector: CheckoutClaimConnector;
-    /** Runs one check; tests substitute it to drive the cache with fixed outcomes. */
-    read?: typeof readCheckoutClaim;
-    ttlMs?: number;
-    refusalRecheckMs?: number;
-    timeoutMs?: number;
-    now?: () => number;
-}
-/**
- * Per-process gate over {@link readCheckoutClaim}: caches each session's
- * verdict, shares one in-flight check per session, and turns a refusal into
- * {@link CheckoutClaimRefusalError}.
- */
-export declare class CheckoutClaimGate {
-    readonly harness: CheckoutClaimHarness;
-    private readonly connector;
-    private readonly read;
-    private readonly ttlMs;
-    private readonly refusalRecheckMs;
-    private readonly timeoutMs;
-    private readonly now;
-    private readonly cache;
-    private readonly inFlight;
-    constructor(options: CheckoutClaimGateOptions);
-    /** The session's verdict, from the cache while it is fresh. */
-    check(sessionId: string, projectRoot: string): Promise<CheckoutClaimOutcome>;
-    /** The refusal to raise for this session, or null when it is admitted. */
-    refusal(sessionId: string, projectRoot: string): Promise<CheckoutClaimRefusalError | null>;
-    /** Throws {@link CheckoutClaimRefusalError} when another machine holds the session's agent. */
-    enforce(sessionId: string, projectRoot: string): Promise<void>;
-    /** Drop a session's cached verdict so its next pass checks again. */
-    forget(sessionId: string): void;
-    private runCheck;
-}
-/** The gate production hosts use: subc's connection file, ALF and engram over it. */
-export declare function createSubcCheckoutClaimGate(harness: CheckoutClaimHarness, connectionFile: () => string): CheckoutClaimGate;
-/**
- * The session an OpenCode 1 bus event belongs to, or undefined for events that
- * name none. Session lifecycle events carry it as `info.id`; message events as
- * `info.sessionID`; part events as `part.sessionID`; the rest as `sessionID`.
- */
-export declare function openCodeEventSessionId(event: {
-    type?: unknown;
-    properties?: unknown;
-}): string | undefined;
-export {};
-//# sourceMappingURL=checkout-claim.d.ts.map

package/dist/features/magic-context/checkout-claim.d.ts.map

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