@geohar/un-bien 0.8.0 → 0.14.0

package/dist/index.d.ts

@@ -31,84 +31,11 @@
  */
 import type { ExtensionContext, ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import type { ClientMessage } from "./protocol/types.js";
-import { PlainPeerChannel } from "./transport/peer_channel.js";
+import type { PlainPeerChannel } from "./transport/peer_channel.js";
+import { CTRL_PREFIX, type RelayConnectivity } from "./session/relay_lifecycle.js";
+export { CTRL_PREFIX };
+export type { RelayConnectivity };
 export type RemoteState = "idle" | "started";
-/** Relay connectivity as seen by an RPC client (Cockpit). Derived from
- *  `_state` + `_relay`: "disconnected" = relay off (idle); "connected" = live
- *  WS; "reconnecting" = was on, WS dropped, retrying. Surfaced via the
- *  `un-bien:relay-state` custom message (see `_emitRelayState`). */
-export type RelayConnectivity = "connected" | "reconnecting" | "disconnected";
-/** Sentinel prefix for a transparent control message an RPC client sends on the
- *  `prompt` channel (stdin). The `input` hook intercepts it, runs the action,
- *  and swallows it (`action:"handled"`) so it never becomes an LLM turn or a
- *  transcript entry. Starts with NUL so it can't collide with real user input
- *  and doesn't begin with "/" (which would route to the command parser). */
-export declare const CTRL_PREFIX = "\0un-bien-ctrl:";
-type MeshEnvelope = {
-    id: string;
-    from: string;
-    re: string | null;
-    body: unknown;
-};
-/** Test-only override of the message buffer. */
-/**
- * Test-only: emulate what `/unbien` does on the returning-user path
- * (join the local mesh, then start the relay) without touching the FS for
- * a `localConfigExists()` lookup. Lets tests bring the relay up without
- * mocking the wizard or the local config storage.
- *
- * Typed loosely to accept any ctx shape with `ui.notify` + `cwd` — the
- * unit tests use minimal mocks that don't satisfy the full
- * `ExtensionContext` interface.
- */
-export declare function _connectForTest(ctx: unknown): Promise<void>;
-/** Test-only: tear everything down (mirrors `/unbien stop`). */
-export declare function _stopForTest(ctx: unknown): Promise<void>;
-/** Test-only: read/reset the `_disposed` flag. Production clears it only when
- *  a host reuses this module for a replacement session; tests share one module
- *  across cases, so they also reset it to avoid cross-test pollution. */
-export declare function _getDisposedForTest(): boolean;
-export declare function _setDisposedForTest(v: boolean): void;
-/** Test-only: reset the once-per-session auto-init gate so session_start re-runs it. */
-export declare function _resetAutoInitedForTest(): void;
-/** Test-only: clear the globalThis panel/ui bridge ownership so each fresh
- *  `extension(pi)` in a shared test process can (re)claim and rebuild bridges. */
-export declare function _resetBridgeOwnersForTest(): void;
-/** Test-only: reset the keyed per-session state at a TEST BOUNDARY (beforeEach).
- *  Must NOT be folded into _resetBridgeOwnersForTest — that fires mid-test on
- *  every captureEventHandler call and would wipe state a test seeds across two
- *  captures (e.g. input seeds turnId, message_update reads it). */
-export declare function _resetSessionsForTest(): void;
-/** Test-only: set the auto-init gate for lifecycle replacement tests. */
-export declare function _setAutoInitedForTest(value: boolean): void;
-/** Test-only: true when this instance holds a live local-mesh node. */
-export declare function _hasMeshNodeForTest(): boolean;
-/** Test-only: drive the current real SelfRevoke producer through one sweep. */
-export declare function _checkSelfRevokeForTest(): Promise<void>;
-/** Test-only: the effective (possibly `#N`-suffixed) name the cwd-lock reserved. */
-export declare function _getLockedNameForTest(): string | null;
-/** Test-only: release + clear the cwd lock (the lock normally survives stop). */
-export declare function _resetCwdLockForTest(): void;
-/**
- * Test-only: relay-only startup, no UDS mesh join. Replaces the old
- * `unbien relay start` handler that some tests captured to bring up
- * the relay in isolation (e.g. ping/pong tests that don't care about the
- * agent-network broker).
- */
-export declare function _startRelayForTest(ctx: unknown): Promise<void>;
-/** Test-only: public marker for canceled-keypair cache regression checks. */
-export declare function _getCachedPublicKeyForTest(): string | null;
-/** Test-only override of session started timestamp. */
-export declare function _setSessionStartedAtForTest(ts: number | null): void;
-/** Test-only: reset the cached model name (between tests). */
-export declare function _setCurrentModelForTest(name: string | undefined): void;
-/** Test-only: read the active turn id used for plain `cancel` routing. */
-export declare function _getCurrentTurnIdForTest(): string | null;
-/** Test-only: override the bound AgentSession so a spy can capture the
- *  content handed to `sendUserMessage` (plan/30 multimodal ingest). */
-export declare function _setPiForTest(pi: unknown): void;
-/** Test-only: exposes pending reconnect timer state. */
-export declare function _hasPendingReconnect(): boolean;
 /**
  * Public state-snapshot helper. Returns the derived UX state, not the raw
  * `_state` enum: the W2D refactor collapsed the internal machine to
@@ -117,37 +44,38 @@ export declare function _hasPendingReconnect(): boolean;
  * mental model via this getter.
  */
 export declare function _getState(): "idle" | "started" | "paired";
-/** Test-only: number of owners currently attached via PlainPeerChannel. */
-export declare function _getActivePeerCountForTest(): number;
-/** Test-only: true if a specific peer (base64 std) has an attached channel. */
-export declare function _hasActivePeerForTest(appPeerIdStd: string): boolean;
-/**
- * Handle a transparent control command from an RPC client (Cockpit), received
- * as a `CTRL_PREFIX`-tagged input the `input` hook swallowed. Toggles the relay
- * WITHOUT leaving the local mesh (relay-only: `_cmdStart` up / `_goIdle` down),
- * then emits the fresh state. `relay:status` just re-emits (no change) so the
- * client can sync its button after (re)attaching to the RPC stream.
- */
 export declare function _handleControl(cmd: string): Promise<void>;
-/**
- * Per-owner disconnect callback. Fires when one specific owner's channel
- * detaches (e.g. relay told us the peer is gone). Other owners' channels
- * keep running — relay stays "started".
- *
- * Exported so tests can trigger the disconnect path for a specific peer.
- *
- * Backward-compat: a no-arg call (legacy tests / pre-W2D callers) falls
- * back to detaching the most recently attached peer, mirroring the old
- * singleton semantics.
- */
 export declare function _onPeerDisconnect(appPeerId?: string): void;
-/** Build the argv for a detached tmux launch of `pi` in `cwd`. Args are an
- *  ARRAY (never a shell string) so cwd/name can't inject. Exported for tests. */
-export declare function _buildTmuxLaunchArgs(name: string, cwd: string): string[];
+export declare const _connectForTest: (ctx: unknown) => Promise<void>;
+export declare const _stopForTest: (ctx: unknown) => Promise<void>;
+export declare const _getDisposedForTest: () => boolean;
+export declare const _setDisposedForTest: (v: boolean) => void;
+export declare const _resetAutoInitedForTest: () => void;
+export declare const _resetBridgeOwnersForTest: () => void;
+export declare const _resetSessionsForTest: () => void;
+export declare const _seedRootSessionForTest: (sid?: string) => void;
+export declare const _setAutoInitedForTest: (value: boolean) => void;
+export declare const _hasMeshNodeForTest: () => boolean;
+export declare const _checkSelfRevokeForTest: () => Promise<void>;
+export declare const _getLockedNameForTest: () => string | null;
+export declare const _resetCwdLockForTest: () => void;
+export declare const _startRelayForTest: (ctx: unknown) => Promise<void>;
+export declare const _getCachedPublicKeyForTest: () => string | null;
+export declare const _setSessionStartedAtForTest: (ts: number | null) => void;
+export declare const _setCurrentModelForTest: (name: string | undefined) => void;
+export declare const _getCurrentTurnIdForTest: () => string | null;
+export declare const _setPiForTest: (pi: unknown) => void;
+export declare const _hasPendingReconnect: () => boolean;
+export declare const _getActivePeerCountForTest: () => number;
+export declare const _hasActivePeerForTest: (appPeerIdStd: string) => boolean;
+export declare const _deliverMeshMessageToAgentForTest: (env: {
+    id: string;
+    from: string;
+    re: string | null;
+    body: unknown;
+}) => void;
 declare const extension: ExtensionFactory;
 export default extension;
-/** Test-only entry point for verifying mesh-to-agent delivery semantics. */
-export declare function _deliverMeshMessageToAgentForTest(env: MeshEnvelope): void;
 export declare function _routeClientMessageFrom(sender: PlainPeerChannel, msg: ClientMessage, ctx: Pick<ExtensionContext, "abort">): void;
 /**
  * Backward-compatible shim for legacy callers + tests that didn't track
@@ -155,29 +83,6 @@ export declare function _routeClientMessageFrom(sender: PlainPeerChannel, msg: C
  * mirroring the pre-W2D singleton behavior.
  */
 export declare function routeClientMessage(msg: ClientMessage, ctx: Pick<ExtensionContext, "abort">): void;
-type ToolArgs = Record<string, unknown>;
-export declare function _enrichToolArgs(tool: string, args: unknown): ToolArgs;
-/**
- * `unbien restart-supervisor` — restarts the `pi-supervisord` PROCESS
- * (not the daemons). The supervisor is a long-running Node process with no
- * hot-reload, so after a `dist` rebuild the old code keeps running until the
- * process is restarted. The Cockpit "Restart supervisor" button shells out to
- * this; the OS-specific restart lives here so the app stays cross-platform.
- *
- * Restarting the supervisor re-spawns every daemon as a side effect. Exits 0
- * on success, non-zero on failure (the Cockpit detects failure by exit code).
- */
-/** One step of a restart sequence. `ignoreFailure` steps (e.g. `schtasks /End`
- *  when the task isn't running) don't abort the sequence. */
-export interface RestartStep {
-    cmd: string;
-    args: string[];
-    ignoreFailure?: boolean;
-}
-/** Pure: the OS command sequence that restarts the supervisor service, or null
- *  when the platform isn't supported. Most platforms are 1 step; Windows is 2
- *  (`schtasks /End` then `/Run`). Exported for tests. */
-export declare function _restartSupervisorCommand(platform: NodeJS.Platform, uid: number): RestartStep[] | null;
 /**
  * Read-only probe of the local UDS broker for the mesh roster, backing
  * `unbien peers`. Opens a raw connection to `sockPath`, sends a single