@polderlabs/bizar-omp 0.7.6 → 0.7.8

package/dist/omp/terminal-title.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Terminal tab title for a Bizar-owned session.
+ *
+ * OMP renders the tab title from its own session name, which for an `omb` host
+ * is the bare binary name — every tab reads "omb" and nothing distinguishes a
+ * working session from an idle one. `setTitle()` is the supported way to own
+ * that title, but an extension override is rendered verbatim: OMP's own
+ * run-state spinner never rewrites it. So the spinner has to be driven here,
+ * from the same turn boundaries that drive the hub's state.
+ *
+ * Frames are braille dots, the style OMP itself uses, so a Bizar title and a
+ * plain OMP title animate identically.
+ */
+/** Braille spinner frames, matching OMP's own working-state animation. */
+export declare const TITLE_SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** How often the working title advances a frame. */
+export declare const TITLE_SPINNER_INTERVAL_MS = 120;
+export type TitleState = "idle" | "working";
+/**
+ * One rendered title, without any escape sequence.
+ *
+ * Kept pure so the exact text is testable without a terminal.
+ */
+export declare function formatSessionTitle(input: {
+    label: string;
+    state: TitleState;
+    frame: number;
+}): string;
+/** Session identity sources a title label can be resolved from. */
+export interface SessionTitleSources {
+    /** OMP's generated/renamed conversation title, once one exists. */
+    sessionName?: string | undefined;
+    /** The Bizar host name, which is a hashed directory id rather than a title. */
+    ombSessionName?: string | undefined;
+    /** The working directory, used to name the project before a title exists. */
+    cwd?: string | undefined;
+}
+/**
+ * The readable label for one session's tab.
+ *
+ * The host name is deliberately not used as the label: `bizar-<project>-<hash>`
+ * identifies a host, not a conversation, and putting it in the tab is exactly
+ * the unreadable title this replaces. OMP's session name is its conversation
+ * title once generated; before that the project directory names the work.
+ */
+export declare function resolveSessionTitleLabel(sources: SessionTitleSources): string;
+export interface SessionTitleController {
+    /** Point the title at a label, e.g. after the conversation is renamed. */
+    setLabel(label: string | undefined): void;
+    /** Enter or leave the working state; the spinner runs only while working. */
+    setState(state: TitleState): void;
+    /** Stop animating and leave the title in its last idle form. */
+    dispose(): void;
+}
+export interface SessionTitleOptions {
+    /** Emits one title update. Returns whether the write was accepted. */
+    write: (title: string) => void;
+    label?: string | undefined;
+    intervalMs?: number;
+}
+/**
+ * Drive a spinner-backed tab title.
+ *
+ * The timer is only armed while working: an idle session writes its title once
+ * and then stops, so a finished agent costs nothing. `write` is expected to be
+ * OMP's `ctx.ui.setTitle`, which is unavailable in non-interactive modes; the
+ * controller then simply does nothing rather than throwing on every frame.
+ */
+export declare function createSessionTitleController(options: SessionTitleOptions): SessionTitleController;
+//# sourceMappingURL=terminal-title.d.ts.map

package/dist/omp/terminal-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-title.d.ts","sourceRoot":"","sources":["../../src/omp/terminal-title.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,YAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEhG,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAM5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMrG;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAc7E;AAED,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,gEAAgE;IAChE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,CAsDjG"}

package/dist/omp/terminal-title.js

@@ -0,0 +1,123 @@
+/**
+ * Terminal tab title for a Bizar-owned session.
+ *
+ * OMP renders the tab title from its own session name, which for an `omb` host
+ * is the bare binary name — every tab reads "omb" and nothing distinguishes a
+ * working session from an idle one. `setTitle()` is the supported way to own
+ * that title, but an extension override is rendered verbatim: OMP's own
+ * run-state spinner never rewrites it. So the spinner has to be driven here,
+ * from the same turn boundaries that drive the hub's state.
+ *
+ * Frames are braille dots, the style OMP itself uses, so a Bizar title and a
+ * plain OMP title animate identically.
+ */
+/** Braille spinner frames, matching OMP's own working-state animation. */
+export const TITLE_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** How often the working title advances a frame. */
+export const TITLE_SPINNER_INTERVAL_MS = 120;
+/** Separator between the spinner and the session label, mirroring OMP. */
+const WORKING_SEPARATOR = ":";
+const IDLE_SEPARATOR = ">";
+/**
+ * One rendered title, without any escape sequence.
+ *
+ * Kept pure so the exact text is testable without a terminal.
+ */
+export function formatSessionTitle(input) {
+    const label = input.label.trim();
+    if (!label)
+        return "";
+    if (input.state !== "working")
+        return `${label} ${IDLE_SEPARATOR}`;
+    const frame = TITLE_SPINNER_FRAMES[((input.frame % TITLE_SPINNER_FRAMES.length) + TITLE_SPINNER_FRAMES.length) % TITLE_SPINNER_FRAMES.length];
+    return `${frame} ${WORKING_SEPARATOR} ${label}`;
+}
+/**
+ * The readable label for one session's tab.
+ *
+ * The host name is deliberately not used as the label: `bizar-<project>-<hash>`
+ * identifies a host, not a conversation, and putting it in the tab is exactly
+ * the unreadable title this replaces. OMP's session name is its conversation
+ * title once generated; before that the project directory names the work.
+ */
+export function resolveSessionTitleLabel(sources) {
+    const title = sources.sessionName?.trim();
+    if (title && title !== "omb")
+        return title;
+    const cwd = sources.cwd?.trim();
+    if (cwd) {
+        const base = cwd.replace(/[\\/]+$/, "").split(/[\\/]/).pop();
+        if (base)
+            return base;
+    }
+    // Last resort: strip the hash off the Bizar host name, which still names the
+    // project even when no directory or title is available. A bare "omb" is the
+    // unreadable title this whole path exists to replace, so it is never used.
+    const host = sources.ombSessionName?.trim();
+    if (host)
+        return host.replace(/^bizar-/, "").replace(/-[a-f0-9]{10}(?:-.*)?$/, "") || host;
+    return "";
+}
+/**
+ * Drive a spinner-backed tab title.
+ *
+ * The timer is only armed while working: an idle session writes its title once
+ * and then stops, so a finished agent costs nothing. `write` is expected to be
+ * OMP's `ctx.ui.setTitle`, which is unavailable in non-interactive modes; the
+ * controller then simply does nothing rather than throwing on every frame.
+ */
+export function createSessionTitleController(options) {
+    const intervalMs = options.intervalMs ?? TITLE_SPINNER_INTERVAL_MS;
+    let label = options.label ?? "";
+    let state = "idle";
+    let frame = 0;
+    let timer;
+    const render = () => formatSessionTitle({ label, state, frame });
+    const stopTimer = () => {
+        if (timer)
+            clearInterval(timer);
+        timer = undefined;
+    };
+    const emit = () => {
+        const title = render();
+        // An empty title would release OMP's override and strand the tab on the
+        // bare brand, so a nameless session writes nothing at all.
+        if (!title)
+            return;
+        options.write(title);
+    };
+    const startTimer = () => {
+        if (timer)
+            return;
+        timer = setInterval(() => {
+            frame += 1;
+            emit();
+        }, intervalMs);
+        // A spinner must never be the reason the process stays alive.
+        timer.unref?.();
+    };
+    return {
+        setLabel(next) {
+            label = next ?? "";
+            emit();
+        },
+        setState(next) {
+            if (state === next)
+                return;
+            state = next;
+            if (state === "working") {
+                frame = 0;
+                emit();
+                startTimer();
+                return;
+            }
+            stopTimer();
+            frame = 0;
+            emit();
+        },
+        dispose() {
+            stopTimer();
+        },
+    };
+}
+//# sourceMappingURL=terminal-title.js.map

package/dist/omp/terminal-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-title.js","sourceRoot":"","sources":["../../src/omp/terminal-title.ts"],"names":[],"mappings":"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"}

package/dist/omp/tmux.d.ts

@@ -11,6 +11,42 @@ export declare function shouldLaunchOmbInTmux(options?: TmuxLaunchEnvironment):
  * A session id creates an additional durable session in the same project.
  */
 export declare function ombSessionName(cwd: string, sessionId?: string, profile?: string): string;
+/**
+ * Re-point a live host at the generation an operator explicitly switched to.
+ *
+ * `bindNativeSessionId` writes the generation immutably on purpose: an
+ * unattended dead-pane recovery must never be talked onto a different journal.
+ * This is the one sanctioned exception, and it differs in three ways. The
+ * caller is an explicit `/resume`, not a recovery. The new generation is
+ * supplied, never inferred from whatever journal is newest in a shared project
+ * directory. And the previous value is returned for reporting.
+ *
+ * The previous value is deliberately *not* meant to be written back. OMP has
+ * already switched by the time this runs, so restoring the old generation would
+ * make `assertNativeSessionBinding` pass against the conversation this host has
+ * left — a silent divergence. A caller that cannot finish the switch must
+ * instead call {@link clearOmbHostGeneration} or drop the journal manifest, so
+ * the respawn check refuses.
+ */
+export declare function rebindOmbHostGeneration(session: string, nativeId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
+    ok: true;
+    previous?: string;
+} | {
+    ok: false;
+    reason: string;
+    previous?: string;
+}>;
+/**
+ * Clear a host's generation binding so a later respawn is refused.
+ *
+ * Used when OMP has already switched conversations but the host's records
+ * could not be brought into agreement. Restoring the *previous* generation
+ * would be actively unsafe: the respawn check would then pass against the old
+ * conversation while the host writes the new one. An absent binding always
+ * fails that check, so the respawn stops instead of resuming the wrong
+ * journal, and the operator is told to restart the host.
+ */
+export declare function clearOmbHostGeneration(session: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<boolean>;
 /** Candidate command names in lookup order, kept pure for cross-platform tests. */
 export declare function executableCandidates(bin: string, platform: "win32" | "posix", pathext?: string): string[];
 /** Resolve an executable on `$PATH`, or an explicit path when it contains a slash. */
@@ -99,4 +135,26 @@ export declare function createOmbSession(cwd: string, args: string[], env?: Node
     name: string;
     code: number;
 }>;
+/**
+ * Recreate a host for a stopped session, bound to the journal it already wrote.
+ *
+ * This is the only route back into a stopped conversation: attaching is
+ * impossible while nothing hosts it. `nativeId` must be the exact generation
+ * the selected row reported — a project directory holds every session for
+ * that project, so resolving "the newest journal" here would resume a
+ * different conversation than the one the operator chose. A row without a
+ * known generation is refused rather than guessed at.
+ *
+ * A session whose journal still sits in a Bizar private directory is migrated
+ * into OMP's project directory first: that is the directory the new host is
+ * started with, and `--resume` can only find a journal there. The migration is
+ * verified against the requested id, so a host is never started on a journal
+ * belonging to another session. The binding invariant is untouched — the fresh
+ * host records the same generation it always did, and a mismatched one still
+ * refuses.
+ */
+export declare function continueOmbSession(session: string, cwd: string, nativeId: string | undefined, env?: NodeJS.ProcessEnv): Promise<{
+    name: string;
+    code: number;
+}>;
 //# sourceMappingURL=tmux.d.ts.map

package/dist/omp/tmux.d.ts.map

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

package/dist/omp/tmux.js

@@ -99,8 +99,15 @@ function quiesceStdinForHandoff() {
 }
 const NATIVE_ID_OPTION = "@bizar-native-id";
 const NATIVE_OWNER_OPTION = "@bizar-session-owner";
-/** Read the native session header id from the exact directory a pane owns. */
-async function nativeSessionId(sessionDir) {
+/**
+ * Read the native session header id from the exact directory a pane owns.
+ *
+ * `only` narrows the answer to one generation. A project directory holds every
+ * session for that project, so the newest journal is not necessarily the one an
+ * operator selected; a caller that must resume a specific conversation passes
+ * its id and gets `undefined` unless that exact journal is present.
+ */
+async function nativeSessionId(sessionDir, only) {
     const journals = await listSessionJournals(sessionDir);
     for (const journal of journals.toReversed()) {
         const head = await readJournalHead(journal);
@@ -109,8 +116,11 @@ async function nativeSessionId(sessionDir) {
         for (const line of head.split("\n")) {
             try {
                 const entry = JSON.parse(line);
-                if (entry.type === "session" && typeof entry.id === "string" && entry.id.trim())
-                    return entry.id.trim();
+                if (entry.type !== "session" || typeof entry.id !== "string" || !entry.id.trim())
+                    continue;
+                const id = entry.id.trim();
+                if (!only || id === only || id.startsWith(only))
+                    return id;
             }
             catch { /* a partial journal line is not a native session header */ }
         }
@@ -121,21 +131,31 @@ async function nativeSessionId(sessionDir) {
  * Bind a tmux session to the native journal generation it started. Once set,
  * the option is never replaced: a conflicting journal is an unsafe recovery,
  * not an invitation to repoint the tmux host.
+ *
+ * `expectedId` pins the generation for a host that is being restarted onto a
+ * specific conversation. Without it the id would be resolved from whatever
+ * journal happens to be newest in the directory, which in a shared project
+ * bucket is a different session than the operator chose.
  */
-async function bindNativeSessionId(tmux, session, sessionDir, cwd, childEnv, existingSession = false) {
+async function bindNativeSessionId(tmux, session, sessionDir, cwd, childEnv, existingSession = false, expectedId) {
     const legacyPrivateDir = resolve(sessionDir) === resolve(ombSessionDir(session, childEnv));
-    let nativeId = ombNativeSessionReference(session, childEnv)?.id ?? (legacyPrivateDir ? await nativeSessionId(sessionDir) : undefined);
+    let nativeId = expectedId
+        ?? ombNativeSessionReference(session, childEnv)?.id
+        ?? (legacyPrivateDir ? await nativeSessionId(sessionDir) : undefined);
     if (!nativeId && existingSession) {
         const pane = await readTmux(tmux, ["list-panes", "-t", `${session}:0.0`, "-F", "#{pane_start_command}"], cwd, childEnv);
         const paneDir = pane.code === 0 ? sessionDirFromPaneCommand(pane.output.trim()) : undefined;
         if (paneDir && (resolve(paneDir) === resolve(ombSessionDir(session, childEnv)) || (await listSessionJournals(paneDir)).length === 1)) {
-            nativeId = await nativeSessionId(paneDir);
+            nativeId = await nativeSessionId(paneDir, expectedId);
         }
     }
     // A newly started OMP can still be creating its first journal. Its next
     // launch records the binding; a dead pane without a binding is refused.
     if (!nativeId)
         return 0;
+    if (expectedId && !expectedId.startsWith(nativeId) && !nativeId.startsWith(expectedId)) {
+        throw new Error(`Bizar tmux session ${session} would bind native generation ${nativeId} instead of the requested ${expectedId}`);
+    }
     const stored = await readTmux(tmux, ["show-options", "-t", session, "-v", NATIVE_ID_OPTION], cwd, childEnv);
     if (stored.code === 0 && stored.output.trim()) {
         if (stored.output.trim() !== nativeId) {
@@ -161,6 +181,71 @@ async function assertNativeSessionBinding(tmux, session, sessionDir, cwd, childE
         throw new Error(`Refusing to respawn ${session}: its tmux native session generation does not match ${sessionDir}`);
     }
 }
+/** The generation a host is currently bound to, reported to the operator. */
+async function readNativeSessionBinding(tmux, session, cwd, childEnv) {
+    const stored = await readTmux(tmux, ["show-options", "-t", session, "-v", NATIVE_ID_OPTION], cwd, childEnv);
+    const value = stored.output.trim();
+    return stored.code === 0 && value ? value : undefined;
+}
+/**
+ * Re-point a live host at the generation an operator explicitly switched to.
+ *
+ * `bindNativeSessionId` writes the generation immutably on purpose: an
+ * unattended dead-pane recovery must never be talked onto a different journal.
+ * This is the one sanctioned exception, and it differs in three ways. The
+ * caller is an explicit `/resume`, not a recovery. The new generation is
+ * supplied, never inferred from whatever journal is newest in a shared project
+ * directory. And the previous value is returned for reporting.
+ *
+ * The previous value is deliberately *not* meant to be written back. OMP has
+ * already switched by the time this runs, so restoring the old generation would
+ * make `assertNativeSessionBinding` pass against the conversation this host has
+ * left — a silent divergence. A caller that cannot finish the switch must
+ * instead call {@link clearOmbHostGeneration} or drop the journal manifest, so
+ * the respawn check refuses.
+ */
+export async function rebindOmbHostGeneration(session, nativeId, cwd = process.cwd(), env = process.env) {
+    if (!isOmbSessionName(session))
+        return { ok: false, reason: "not a Bizar session name" };
+    const id = nativeId.trim();
+    if (!id)
+        return { ok: false, reason: "no native session generation was supplied" };
+    const tmux = resolveMultiplexerBin(env);
+    const childEnv = { ...env, BIZAR_OMP_NO_TMUX: "1" };
+    const previous = await readNativeSessionBinding(tmux, session, cwd, childEnv);
+    if (previous === id)
+        return { ok: true, previous };
+    // No `-o`: this replaces an immutable value on purpose, and only here.
+    const set = await runTmux(tmux, ["set-option", "-t", session, NATIVE_ID_OPTION, id], cwd, childEnv);
+    if (set !== 0)
+        return { ok: false, reason: `multiplexer refused the rebind (exit ${set})`, previous };
+    const confirmed = await readNativeSessionBinding(tmux, session, cwd, childEnv);
+    if (confirmed !== id)
+        return { ok: false, reason: "the rebind did not take effect", previous };
+    return { ok: true, previous };
+}
+/**
+ * Clear a host's generation binding so a later respawn is refused.
+ *
+ * Used when OMP has already switched conversations but the host's records
+ * could not be brought into agreement. Restoring the *previous* generation
+ * would be actively unsafe: the respawn check would then pass against the old
+ * conversation while the host writes the new one. An absent binding always
+ * fails that check, so the respawn stops instead of resuming the wrong
+ * journal, and the operator is told to restart the host.
+ */
+export async function clearOmbHostGeneration(session, cwd = process.cwd(), env = process.env) {
+    if (!isOmbSessionName(session))
+        return false;
+    const tmux = resolveMultiplexerBin(env);
+    const childEnv = { ...env, BIZAR_OMP_NO_TMUX: "1" };
+    const cleared = await runTmux(tmux, ["set-option", "-u", "-t", session, NATIVE_ID_OPTION], cwd, childEnv);
+    if (cleared !== 0)
+        return false;
+    // Confirm the invalidation landed: a binding that survived would let the
+    // respawn check pass against a journal this host no longer writes.
+    return (await readNativeSessionBinding(tmux, session, cwd, childEnv)) === undefined;
+}
 async function bindNativeSessionOwner(tmux, session, cwd, childEnv, owner = session) {
     const stored = await readTmux(tmux, ["show-options", "-t", session, "-v", NATIVE_OWNER_OPTION], cwd, childEnv);
     if (stored.code === 0 && stored.output.trim())
@@ -712,4 +797,65 @@ export async function createOmbSession(cwd, args, env = process.env, sessionId)
         clearOmbSessionDeleted(session, env);
     return { name: session, code: preparedCode };
 }
+/**
+ * Recreate a host for a stopped session, bound to the journal it already wrote.
+ *
+ * This is the only route back into a stopped conversation: attaching is
+ * impossible while nothing hosts it. `nativeId` must be the exact generation
+ * the selected row reported — a project directory holds every session for
+ * that project, so resolving "the newest journal" here would resume a
+ * different conversation than the one the operator chose. A row without a
+ * known generation is refused rather than guessed at.
+ *
+ * A session whose journal still sits in a Bizar private directory is migrated
+ * into OMP's project directory first: that is the directory the new host is
+ * started with, and `--resume` can only find a journal there. The migration is
+ * verified against the requested id, so a host is never started on a journal
+ * belonging to another session. The binding invariant is untouched — the fresh
+ * host records the same generation it always did, and a mismatched one still
+ * refuses.
+ */
+export async function continueOmbSession(session, cwd, nativeId, env = process.env) {
+    if (!isOmbSessionName(session))
+        return { name: session, code: 2 };
+    const id = nativeId?.trim();
+    if (!id)
+        return { name: session, code: 3 };
+    const tmux = resolveMultiplexerBin(env);
+    const omp = env.BIZAR_OMP_BIN || "omp";
+    const settings = loadOmbSettings(env);
+    const childEnv = { ...env, BIZAR_OMP_NO_TMUX: "1" };
+    const journalDir = defaultOmpSessionDir(cwd, env);
+    // The journal must be reachable from the directory the host will search.
+    // A legacy private journal is handed to OMP's own picker directory first.
+    let resolvable = await nativeSessionId(journalDir, id);
+    if (!resolvable && isLegacyOmbSessionDir(ombSessionDir(session, env), session, env)) {
+        const migrated = await migrateLegacyOmbSessionJournal(session, ombSessionDir(session, env), cwd, env);
+        if (!migrated.ok)
+            return { name: session, code: 6 };
+        if (migrated.id !== id)
+            return { name: session, code: 7 };
+        resolvable = await nativeSessionId(journalDir, id);
+    }
+    // Fail closed unless the journal OMP would resume is really in the directory
+    // the host will look in; otherwise `--resume` silently starts a new session.
+    if (!resolvable)
+        return { name: session, code: 5 };
+    const hasSession = await runTmux(tmux, ["has-session", "-t", session], cwd, childEnv);
+    if (hasSession === 0)
+        return { name: session, code: 4 };
+    const created = await runTmux(tmux, ["new-session", "-d", "-s", session, "-e", `BIZAR_OMP_SESSION_NAME=${session}`, "-c", cwd, omp, "--session-dir", journalDir, "--resume", id], cwd, childEnv);
+    if (created !== 0)
+        return { name: session, code: created };
+    const ownerBound = await bindNativeSessionOwner(tmux, session, cwd, childEnv);
+    if (ownerBound !== 0)
+        return { name: session, code: ownerBound };
+    const bound = await bindNativeSessionId(tmux, session, journalDir, cwd, childEnv, false, id);
+    if (bound !== 0)
+        return { name: session, code: bound };
+    const prepared = await prepareOmbSession(tmux, omp, session, cwd, childEnv, settings.mouseScrolling);
+    if (prepared === 0)
+        clearOmbSessionDeleted(session, env);
+    return { name: session, code: prepared };
+}
 //# sourceMappingURL=tmux.js.map