botmux 3.15.0 → 3.16.1

package/dist/core/remote-cli-ids.js

@@ -0,0 +1,24 @@
+/**
+ * The single source of truth for "which CLIs run their agent off-box".
+ *
+ * A dependency-free leaf on purpose. This used to live in persistent-backend,
+ * which pulls in every PTY backend class — so a light consumer like the Lark
+ * card builder could not import it and open-coded `cliId !== 'riff'` instead.
+ * That is exactly how adding mojo left the card rendering 11 PTY quick-action
+ * buttons that silently do nothing: a remote backend has no terminal to drive.
+ *
+ * Adding a remote CLI means adding it HERE, once.
+ *
+ * By construction a remote CLI's id and its backendType share a name, so both
+ * helpers can consult the same set.
+ */
+const REMOTE_CLI_IDS = new Set(['riff', 'mojo']);
+/** True for a backend that runs the agent off-box (no local PTY to own). */
+export function isRemoteBackendId(type) {
+    return REMOTE_CLI_IDS.has(type);
+}
+/** True for a CLI whose backend is remote. */
+export function isRemoteCliId(cliId) {
+    return cliId !== undefined && REMOTE_CLI_IDS.has(cliId);
+}
+//# sourceMappingURL=remote-cli-ids.js.map

package/dist/core/remote-cli-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-cli-ids.js","sourceRoot":"","sources":["../../src/core/remote-cli-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,OAAO,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/core/{riff-shutdown-detach.d.ts → remote-shutdown-detach.d.ts}

@@ -6,7 +6,7 @@ type ShutdownPhaseResult = {
     taskId: string | null;
     error?: string;
 };
-export type PreparedRiffShutdown = {
+export type PreparedRemoteShutdown = {
     ok: true;
     fence: 'prepared';
     requestId: string;
@@ -32,7 +32,7 @@ export type PreparedRiffShutdown = {
      * durable verification. */
     worker: ChildProcess | null;
 };
-export type RiffShutdownFailure = {
+export type RemoteShutdownFailure = {
     ok: false;
     requestId?: string;
     taskId: string | null;
@@ -43,34 +43,34 @@ export type RiffShutdownFailure = {
 };
 /** A prepare refusal that is proven to have happened before the worker/backend
  * fence. It must never be sent an abort request. */
-export type UnfencedRiffShutdownRefusal = RiffShutdownFailure & {
+export type UnfencedRemoteShutdownRefusal = RemoteShutdownFailure & {
     fence: 'none';
 };
 /** A prepare attempt whose exact worker may have installed its backend fence.
  * Preparation deliberately does not restore admission inline; the fleet
  * coordinator includes this handle in its one concurrent abort wave. */
-export type PossiblyFencedRiffShutdown = RiffShutdownFailure & {
+export type PossiblyFencedRemoteShutdown = RemoteShutdownFailure & {
     fence: 'possible';
     requestId: string;
     worker: ChildProcess;
     expectedAbortTaskId?: string | null;
 };
-export type RiffShutdownPrepareResult = PreparedRiffShutdown | UnfencedRiffShutdownRefusal | PossiblyFencedRiffShutdown;
-export type RiffShutdownPrepareOptions = {
+export type RemoteShutdownPrepareResult = PreparedRemoteShutdown | UnfencedRemoteShutdownRefusal | PossiblyFencedRemoteShutdown;
+export type RemoteShutdownPrepareOptions = {
     drainTimeoutMs?: number;
     abortTimeoutMs?: number;
     /** Absolute transaction deadline. A worker is never asked to fence unless
      * phase-2 plus the configured admission-restore reserve remain after drain. */
     deadlineMs?: number;
     now?: () => number;
-    /** One projection sampled by prepareRiffFleetForShutdown before any fence. */
-    durableSnapshot?: sessionStore.ActiveRiffShutdownSnapshot;
+    /** One projection sampled by prepareRemoteFleetForShutdown before any fence. */
+    durableSnapshot?: sessionStore.ActiveRemoteShutdownSnapshot;
 };
-export type RiffFleetPrepareEntry = {
+export type RemoteFleetPrepareEntry = {
     ds: DaemonSession;
-    result: RiffShutdownPrepareResult;
+    result: RemoteShutdownPrepareResult;
 };
-export type FencedRiffShutdownParticipant = PreparedRiffShutdown | PossiblyFencedRiffShutdown;
+export type FencedRemoteShutdownParticipant = PreparedRemoteShutdown | PossiblyFencedRemoteShutdown;
 export type UniqueDaemonShutdownSessions = {
     ok: true;
     sessions: DaemonSession[];
@@ -84,81 +84,82 @@ export type UniqueDaemonShutdownSessions = {
  * objects claiming the same durable session id: there is no unique generation
  * that shutdown can safely fence or retire. */
 export declare function collectUniqueDaemonShutdownSessions(candidates: Iterable<DaemonSession>): UniqueDaemonShutdownSessions;
-export type RiffShutdownDetachOutcome = {
+export type RemoteShutdownDetachOutcome = {
     ok: true;
     requestId: string;
     taskId: string | null;
     disposition: 'lineage_persisted';
     worker?: ChildProcess;
-} | RiffShutdownFailure;
-/** Phase 1: fence one exact Riff generation and drain task-id materialization.
+} | RemoteShutdownFailure;
+/** Phase 1: fence one exact remote generation and drain lineage materialization.
  * Nothing exits or restores admission here. A failure after the prepare send
  * returns an exact possibly-fenced handle so all peers can be restored in one
  * concurrent fleet wave rather than serial drain+abort chains. */
-export declare function prepareRiffSessionForShutdown(ds: DaemonSession, options?: RiffShutdownPrepareOptions): Promise<RiffShutdownPrepareResult>;
-export type RiffFleetPrepareOptions = Omit<RiffShutdownPrepareOptions, 'durableSnapshot'> & {
+export declare function prepareRemoteSessionForShutdown(ds: DaemonSession, options?: RemoteShutdownPrepareOptions): Promise<RemoteShutdownPrepareResult>;
+export type RemoteFleetPrepareOptions = Omit<RemoteShutdownPrepareOptions, 'durableSnapshot'> & {
     snapshotTimeoutMs?: number;
 };
 /** Take one fresh projection for the complete candidate set, then (and only
  * then) publish prepare requests concurrently. */
-export declare function prepareRiffFleetForShutdown(candidates: readonly DaemonSession[], options?: RiffFleetPrepareOptions): Promise<RiffFleetPrepareEntry[]>;
-export type PreparedRiffFleetEntry = {
+export declare function prepareRemoteFleetForShutdown(candidates: readonly DaemonSession[], options?: RemoteFleetPrepareOptions): Promise<RemoteFleetPrepareEntry[]>;
+export type PreparedRemoteFleetEntry = {
     ds: DaemonSession;
-    result: PreparedRiffShutdown;
+    result: PreparedRemoteShutdown;
 };
-export type RiffFleetPersistenceResult = {
+export type RemoteFleetPersistenceResult = {
     ok: true;
-} | (RiffShutdownFailure & {
+} | (RemoteShutdownFailure & {
     sessionIds: readonly string[];
     retainFencedSessionIds: readonly string[];
 });
 /** Phase 2 fleet transaction: validate every runtime generation, then compare
  * and publish all durable lineage rows with one lock and one rename. */
-export declare function persistPreparedRiffShutdownFleet(entries: readonly PreparedRiffFleetEntry[], options?: {
+export declare function persistPreparedRemoteShutdownFleet(entries: readonly PreparedRemoteFleetEntry[], options?: {
     persistTimeoutMs?: number;
     deadlineMs?: number;
     now?: () => number;
-}): RiffFleetPersistenceResult;
+}): RemoteFleetPersistenceResult;
 /** Single-session compatibility path. Fleet shutdown uses the batch function
  * above; this API remains for explicit focused operations and older callers. */
-export declare function persistPreparedRiffShutdown(ds: DaemonSession, prepared: PreparedRiffShutdown): {
+export declare function persistPreparedRemoteShutdown(ds: DaemonSession, prepared: PreparedRemoteShutdown): {
     ok: true;
-} | RiffShutdownFailure;
-export declare function isPreparedRiffSessionCurrent(ds: DaemonSession, prepared: PreparedRiffShutdown): boolean;
+} | RemoteShutdownFailure;
+export declare function isPreparedRemoteSessionCurrent(ds: DaemonSession, prepared: PreparedRemoteShutdown): boolean;
 /** After verified lineage persistence, an exact prepared worker that exited
  * and was cleared by worker-pool can be safely rolled back locally. A new
  * worker generation or a different fence remains ownership ambiguity. */
-export declare function canAbortVerifiedExitedRiffPreparation(ds: DaemonSession, prepared: PreparedRiffShutdown): boolean;
+export declare function canAbortVerifiedExitedRemotePreparation(ds: DaemonSession, prepared: PreparedRemoteShutdown): boolean;
 /** Roll back one prepared participant. State clears only after the exact worker
  * ACKs admission restoration; timeout/late ACK remains deliberately fail-closed. */
-export declare function abortPreparedRiffShutdown(ds: DaemonSession, prepared: PreparedRiffShutdown, options?: {
+export declare function abortPreparedRemoteShutdown(ds: DaemonSession, prepared: PreparedRemoteShutdown, options?: {
     abortTimeoutMs?: number;
 }): Promise<ShutdownPhaseResult>;
-export type RiffFleetAbortEntry = {
+export type RemoteFleetAbortEntry = {
     ds: DaemonSession;
-    result: FencedRiffShutdownParticipant;
+    result: FencedRemoteShutdownParticipant;
 };
-export type RiffFleetAbortResult = {
+export type RemoteFleetAbortResult = {
     ds: DaemonSession;
-    participant: FencedRiffShutdownParticipant;
+    participant: FencedRemoteShutdownParticipant;
     result: ShutdownPhaseResult;
 };
 /** Restore every exact prepared/possibly-fenced generation concurrently. No
  * participant can consume another's timeout budget. */
-export declare function abortRiffShutdownFleet(entries: readonly RiffFleetAbortEntry[], options?: {
+export declare function abortRemoteShutdownFleet(entries: readonly RemoteFleetAbortEntry[], options?: {
     abortTimeoutMs?: number;
     deadlineMs?: number;
     now?: () => number;
-}): Promise<RiffFleetAbortResult[]>;
+}): Promise<RemoteFleetAbortResult[]>;
 /** Phase 3: synchronous, infallible-after-validation commit. The coordinator
  * validates every participant first, then calls this without an intervening
  * await, so one session can never refuse after a peer was detached. */
-export declare function commitPreparedRiffShutdown(ds: DaemonSession, prepared: PreparedRiffShutdown): boolean;
+export declare function commitPreparedRemoteShutdown(ds: DaemonSession, prepared: PreparedRemoteShutdown): boolean;
 /** Single-session compatibility wrapper. Daemon shutdown intentionally uses
- * the explicit three-phase API above so a multi-Riff fleet cannot half-commit. */
-export declare function detachRiffWorkerForShutdown(ds: DaemonSession, options?: {
+ * the explicit three-phase API above so a multi-backend remote fleet cannot
+ * half-commit. */
+export declare function detachRemoteWorkerForShutdown(ds: DaemonSession, options?: {
     drainTimeoutMs?: number;
     abortTimeoutMs?: number;
-}): Promise<RiffShutdownDetachOutcome>;
+}): Promise<RemoteShutdownDetachOutcome>;
 export {};
-//# sourceMappingURL=riff-shutdown-detach.d.ts.map
+//# sourceMappingURL=remote-shutdown-detach.d.ts.map

package/dist/core/remote-shutdown-detach.d.ts.map

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