@agentuity/coder-tui 2.0.8

package/dist/remote-lifecycle.d.ts

@@ -0,0 +1,61 @@
+export type RemoteLifecyclePhase = 'connecting' | 'hydrating' | 'replaying' | 'live' | 'paused' | 'resuming' | 'reconnecting' | 'disconnected';
+export type RemoteTransportState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+export interface RemoteLifecycleState {
+    sessionId: string;
+    label: string;
+    transport: RemoteTransportState;
+    phase: RemoteLifecyclePhase;
+    leadConnected: boolean | null;
+    isStreaming: boolean;
+    hydrationReceived: boolean;
+    streamId: string | null;
+    streamUrl: string | null;
+    lastError: string | null;
+}
+export interface RemoteLifecycleWorkingMessageUi {
+    setWorkingMessage(message?: string): void;
+}
+export type RemoteLifecycleEvent = {
+    type: 'connect_start';
+    reconnect: boolean;
+} | {
+    type: 'init';
+    sessionId?: string;
+    label?: string;
+} | {
+    type: 'hydration';
+    leadConnected?: boolean;
+    isStreaming?: boolean;
+} | {
+    type: 'replay_event';
+} | {
+    type: 'replay_idle';
+} | {
+    type: 'live_signal';
+    isStreaming?: boolean;
+} | {
+    type: 'session_resume';
+    streamId?: string | null;
+    streamUrl?: string | null;
+} | {
+    type: 'stream_ready';
+    streamId?: string | null;
+    streamUrl?: string | null;
+} | {
+    type: 'rpc_command_error';
+    error: string;
+    paused: boolean;
+} | {
+    type: 'local_resume_requested';
+} | {
+    type: 'connection_change';
+    state: 'reconnecting' | 'disconnected';
+};
+export declare function createRemoteLifecycleState(sessionId: string): RemoteLifecycleState;
+export declare function applyRemoteLifecycleEvent(state: RemoteLifecycleState, event: RemoteLifecycleEvent): RemoteLifecycleState;
+export declare function getRemoteLifecycleLabel(state: RemoteLifecycleState): string;
+export declare function getRemoteLifecycleActivityLabel(state: RemoteLifecycleState): string | undefined;
+export declare function getRemoteLifecycleWorkingMessage(state: RemoteLifecycleState): string | undefined;
+export declare function clearRemoteLifecycleWorkingMessage(ui: RemoteLifecycleWorkingMessageUi, lifecycleOwnsWorkingMessage: boolean): boolean;
+export declare function syncRemoteLifecycleWorkingMessage(state: RemoteLifecycleState, ui: RemoteLifecycleWorkingMessageUi, lifecycleOwnsWorkingMessage: boolean): boolean;
+//# sourceMappingURL=remote-lifecycle.d.ts.map

package/dist/remote-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-lifecycle.d.ts","sourceRoot":"","sources":["../src/remote-lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC7B,YAAY,GACZ,WAAW,GACX,WAAW,GACX,MAAM,GACN,QAAQ,GACR,UAAU,GACV,cAAc,GACd,cAAc,CAAC;AAElB,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAEhG,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC/C,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAAA;CAAE,CAAC;AAEzE,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAalF;AA8BD,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,GACzB,oBAAoB,CA6FtB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAmB3E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAmB/F;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAiBhG;AAED,wBAAgB,kCAAkC,CACjD,EAAE,EAAE,+BAA+B,EACnC,2BAA2B,EAAE,OAAO,GAClC,OAAO,CAKT;AAED,wBAAgB,iCAAiC,CAChD,KAAK,EAAE,oBAAoB,EAC3B,EAAE,EAAE,+BAA+B,EACnC,2BAA2B,EAAE,OAAO,GAClC,OAAO,CAOT"}

package/dist/remote-lifecycle.js

@@ -0,0 +1,190 @@
+export function createRemoteLifecycleState(sessionId) {
+    return {
+        sessionId,
+        label: '',
+        transport: 'disconnected',
+        phase: 'disconnected',
+        leadConnected: null,
+        isStreaming: false,
+        hydrationReceived: false,
+        streamId: null,
+        streamUrl: null,
+        lastError: null,
+    };
+}
+function patchState(state, patch) {
+    let changed = false;
+    const next = { ...state };
+    for (const [key, value] of Object.entries(patch)) {
+        const typedKey = key;
+        if (next[typedKey] !== value) {
+            changed = true;
+            next[typedKey] =
+                value;
+        }
+    }
+    return changed ? next : state;
+}
+function resolveConnectedPhase(input) {
+    if (input.isStreaming)
+        return 'live';
+    if (input.leadConnected === false)
+        return 'paused';
+    return 'live';
+}
+export function applyRemoteLifecycleEvent(state, event) {
+    switch (event.type) {
+        case 'connect_start':
+            return patchState(state, {
+                transport: event.reconnect ? 'reconnecting' : 'connecting',
+                phase: event.reconnect ? 'reconnecting' : 'connecting',
+                lastError: null,
+            });
+        case 'init':
+            return patchState(state, {
+                sessionId: event.sessionId || state.sessionId,
+                label: event.label || state.label,
+                transport: 'connected',
+                phase: 'hydrating',
+                lastError: null,
+            });
+        case 'hydration': {
+            const leadConnected = typeof event.leadConnected === 'boolean' ? event.leadConnected : state.leadConnected;
+            const isStreaming = typeof event.isStreaming === 'boolean' ? event.isStreaming : state.isStreaming;
+            return patchState(state, {
+                leadConnected,
+                isStreaming,
+                hydrationReceived: true,
+                transport: 'connected',
+                phase: resolveConnectedPhase({ leadConnected, isStreaming }),
+                lastError: null,
+            });
+        }
+        case 'replay_event':
+            if (state.transport !== 'connected')
+                return state;
+            return patchState(state, {
+                phase: 'replaying',
+            });
+        case 'replay_idle':
+            if (state.phase !== 'replaying')
+                return state;
+            return patchState(state, {
+                phase: resolveConnectedPhase({
+                    leadConnected: state.leadConnected,
+                    isStreaming: state.isStreaming,
+                }),
+            });
+        case 'live_signal':
+            return patchState(state, {
+                transport: 'connected',
+                phase: 'live',
+                leadConnected: true,
+                isStreaming: typeof event.isStreaming === 'boolean' ? event.isStreaming : state.isStreaming,
+                lastError: null,
+            });
+        case 'session_resume':
+            return patchState(state, {
+                streamId: event.streamId ?? state.streamId,
+                streamUrl: event.streamUrl ?? state.streamUrl,
+                phase: 'resuming',
+                lastError: null,
+            });
+        case 'stream_ready':
+            return patchState(state, {
+                streamId: event.streamId ?? state.streamId,
+                streamUrl: event.streamUrl ?? state.streamUrl,
+            });
+        case 'rpc_command_error':
+            return patchState(state, {
+                lastError: event.error,
+                leadConnected: event.paused ? false : state.leadConnected,
+                isStreaming: event.paused ? false : state.isStreaming,
+                phase: event.paused ? 'paused' : state.phase,
+            });
+        case 'local_resume_requested':
+            return patchState(state, {
+                phase: 'resuming',
+                lastError: null,
+            });
+        case 'connection_change':
+            return patchState(state, {
+                transport: event.state,
+                phase: event.state,
+                isStreaming: false,
+            });
+    }
+}
+export function getRemoteLifecycleLabel(state) {
+    switch (state.phase) {
+        case 'connecting':
+            return 'Connecting';
+        case 'hydrating':
+            return 'Hydrating';
+        case 'replaying':
+            return 'Replaying';
+        case 'paused':
+            return 'Paused';
+        case 'resuming':
+            return 'Resuming';
+        case 'reconnecting':
+            return 'Reconnecting';
+        case 'disconnected':
+            return 'Disconnected';
+        case 'live':
+            return 'Live';
+    }
+}
+export function getRemoteLifecycleActivityLabel(state) {
+    switch (state.phase) {
+        case 'connecting':
+            return 'connecting to sandbox...';
+        case 'hydrating':
+            return 'hydrating remote session...';
+        case 'replaying':
+            return 'replaying remote history...';
+        case 'paused':
+            return 'sandbox paused';
+        case 'resuming':
+            return 'resuming sandbox...';
+        case 'reconnecting':
+            return 'reconnecting...';
+        case 'disconnected':
+            return state.lastError ? `disconnected: ${state.lastError}` : 'disconnected';
+        case 'live':
+            return undefined;
+    }
+}
+export function getRemoteLifecycleWorkingMessage(state) {
+    switch (state.phase) {
+        case 'connecting':
+            return 'Connecting to remote sandbox...';
+        case 'hydrating':
+            return 'Hydrating remote session...';
+        case 'replaying':
+            return 'Replaying remote history...';
+        case 'resuming':
+            return 'Resuming remote sandbox...';
+        case 'reconnecting':
+            return 'Connection lost - reconnecting...';
+        case 'paused':
+        case 'disconnected':
+        case 'live':
+            return undefined;
+    }
+}
+export function clearRemoteLifecycleWorkingMessage(ui, lifecycleOwnsWorkingMessage) {
+    if (lifecycleOwnsWorkingMessage) {
+        ui.setWorkingMessage();
+    }
+    return false;
+}
+export function syncRemoteLifecycleWorkingMessage(state, ui, lifecycleOwnsWorkingMessage) {
+    const working = getRemoteLifecycleWorkingMessage(state);
+    if (working) {
+        ui.setWorkingMessage(working);
+        return true;
+    }
+    return clearRemoteLifecycleWorkingMessage(ui, lifecycleOwnsWorkingMessage);
+}
+//# sourceMappingURL=remote-lifecycle.js.map

package/dist/remote-lifecycle.js.map

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

package/dist/remote-session.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Remote Session Bridge — TUI ↔ Hub ↔ Sandbox
+ *
+ * Handles the WebSocket connection and RPC protocol bridge for remote mode.
+ * In remote mode, the local Pi TUI connects to an existing sandbox session
+ * through the Hub, acting as a thin client:
+ *   - User input → rpc_command → Hub → sandbox
+ *   - Sandbox events → rpc_event → Hub → TUI rendering
+ *   - Extension UI dialogs → rpc_ui_request/response → Hub ↔ TUI
+ *
+ * This module manages the connection lifecycle and provides an API
+ * for the extension to send commands and receive events.
+ */
+import type { ExtensionAPI, ExtensionContext } from '@mariozechner/pi-coding-agent';
+import { type RemoteLifecycleState } from './remote-lifecycle.ts';
+export interface RpcCommand {
+    type: string;
+    [key: string]: unknown;
+}
+export interface RpcEvent {
+    type: string;
+    [key: string]: unknown;
+}
+export interface RpcUiRequest {
+    id: string;
+    method: string;
+    params: Record<string, unknown>;
+}
+/** RPC response from sandbox (correlated by id) */
+export interface RpcResponse {
+    type: 'response';
+    id: string;
+    command: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export type RemoteEventHandler = (event: RpcEvent) => void;
+export type RemoteResponseHandler = (response: RpcResponse) => void;
+export type RemoteUiHandler = (request: RpcUiRequest) => Promise<unknown>;
+export type RemoteConnectionHandler = (state: 'connected' | 'reconnecting' | 'disconnected') => void;
+export type RemoteLifecycleHandler = (state: RemoteLifecycleState) => void;
+export declare class RemoteSession {
+    private ws;
+    private connected;
+    private intentionallyClosed;
+    private hubWsUrl;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private eventHandlers;
+    private uiHandler;
+    private responseHandlers;
+    private connectionHandlers;
+    private lifecycleHandlers;
+    private lifecycleState;
+    private replaySettledTimer;
+    /** Session ID this client is connected to */
+    sessionId: string;
+    /** Session label (populated after connection) */
+    label: string;
+    /** API key for Hub authentication (Hub API key or CLI/platform key) */
+    apiKey: string | null;
+    /** Organization ID for CLI/platform key auth (sent as x-agentuity-orgid header) */
+    orgId: string | null;
+    constructor(sessionId: string);
+    private dispatchEvent;
+    private dispatchResponse;
+    private applyLifecycle;
+    private clearReplaySettledTimer;
+    private scheduleReplaySettled;
+    private observeLiveSignal;
+    private getLiveSignalStreamingState;
+    private shouldMarkResuming;
+    private shouldObserveRpcResponseAsLive;
+    /** Register a handler for RPC events from the sandbox */
+    onEvent(handler: RemoteEventHandler): void;
+    /** Register a handler for RPC responses from the sandbox */
+    onResponse(handler: RemoteResponseHandler): void;
+    /** Register the UI dialog handler (select, confirm, input, editor) */
+    setUiHandler(handler: RemoteUiHandler): void;
+    /** Register a connection state change handler */
+    onConnectionChange(handler: RemoteConnectionHandler): void;
+    /** Register a lifecycle state handler for remote attach/replay/live transitions. */
+    onLifecycleChange(handler: RemoteLifecycleHandler): void;
+    getLifecycleState(): RemoteLifecycleState;
+    /** Connect to the Hub WebSocket as a controller for the remote session */
+    connect(hubWsUrl: string): Promise<void>;
+    private doConnect;
+    private scheduleReconnect;
+    private notifyConnectionChange;
+    /** Send an RPC command to the sandbox (prompt, steer, abort, etc.) */
+    sendCommand(command: RpcCommand): void;
+    /** Send a user prompt to the remote sandbox */
+    prompt(message: string, images?: string[]): void;
+    /** Steer the agent mid-turn */
+    steer(message: string): void;
+    /** Abort current operation */
+    abort(): void;
+    /** Get current session state */
+    getState(): void;
+    /** Get all messages in current session */
+    getMessages(): void;
+    /** Compact the session context */
+    compact(): void;
+    /** Close the connection */
+    close(): void;
+    get isConnected(): boolean;
+    /** Handle UI request from sandbox — delegate to registered handler */
+    private handleUiRequest;
+    /** Send UI response back to sandbox */
+    private sendUiResponse;
+}
+/**
+ * Set up remote mode for the Pi extension.
+ *
+ * Connects to an existing sandbox session through the Hub and bridges
+ * user input → RPC commands and sandbox events → TUI rendering.
+ *
+ * Uses Pi's extension APIs for rich rendering:
+ * - pi.sendMessage() for completed assistant messages
+ * - ctx.ui.setWidget() for streaming output
+ * - ctx.ui.setWorkingMessage() for tool execution status
+ * - ctx.ui.setStatus() for connection and agent state
+ */
+export declare function setupRemoteMode(pi: ExtensionAPI, hubWsUrl: string, sessionId: string): Promise<RemoteSession>;
+/** Internal interface for passing extension context to RemoteSession */
+export interface RemoteSessionInternal extends RemoteSession {
+    _setExtensionCtx?: (ctx: ExtensionContext) => void;
+}
+//# sourceMappingURL=remote-session.d.ts.map

package/dist/remote-session.d.ts.map

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