aimux-cli 0.1.0

package/dist/tmux-runtime-manager.d.ts

@@ -0,0 +1,164 @@
+export interface TmuxExecOptions {
+    cwd?: string;
+}
+export type TmuxExec = (args: string[], options?: TmuxExecOptions) => string;
+export type TmuxInteractiveExec = (args: string[], options?: TmuxExecOptions) => void;
+export interface TmuxWindowInfo {
+    id: string;
+    index: number;
+    name: string;
+    active: boolean;
+    activity?: number;
+}
+export interface TmuxSessionRef {
+    projectRoot: string;
+    projectId: string;
+    sessionName: string;
+}
+export interface TmuxTarget {
+    sessionName: string;
+    windowId: string;
+    windowIndex: number;
+    windowName: string;
+}
+export interface TmuxClientInfo {
+    tty: string;
+    sessionName: string;
+    windowId: string;
+    name: string;
+}
+export interface OpenTargetOptions {
+    insideTmux?: boolean;
+    alreadyResolved?: boolean;
+}
+export interface CaptureTargetOptions {
+    /** Number of lines from the bottom of scrollback to include. */
+    startLine?: number;
+}
+export interface TmuxCommandSpec {
+    cwd: string;
+    command: string;
+    args: string[];
+}
+export interface TmuxWindowMetadata {
+    kind?: "agent" | "service";
+    sessionId: string;
+    command: string;
+    args: string[];
+    toolConfigKey: string;
+    backendSessionId?: string;
+    worktreePath?: string;
+    label?: string;
+    role?: string;
+    activity?: string;
+    attention?: string;
+    unseenCount?: number;
+    statusText?: string;
+}
+export declare function isDashboardWindowName(name: string): boolean;
+export declare const MANAGED_TMUX_SESSION_OPTIONS: Readonly<{
+    prefix: "C-a";
+    prefix2: "C-b";
+    mouse: "on";
+    extendedKeys: "always";
+    extendedKeysFormat: "csi-u";
+}>;
+export declare const MANAGED_TMUX_TERMINAL_FEATURES: readonly ["xterm*:extkeys", "xterm*:hyperlinks"];
+export declare const MANAGED_TMUX_AGENT_WINDOW_OPTIONS: Readonly<{
+    allowPassthrough: "on";
+}>;
+export declare class TmuxRuntimeManager {
+    private readonly exec;
+    private readonly interactiveExec;
+    constructor(exec?: TmuxExec, interactiveExec?: TmuxInteractiveExec);
+    isAvailable(): boolean;
+    getVersion(): string | null;
+    getProjectSession(projectRoot: string): TmuxSessionRef;
+    getProjectClientSessionName(hostSessionName: string, clientSuffix: string): string;
+    isClientSessionName(sessionName: string): boolean;
+    getOpenSessionName(sessionName: string, insideTmux?: boolean): string;
+    peekOpenSessionName(sessionName: string, insideTmux?: boolean): string;
+    private ensureClientSession;
+    private ensureLinkedWindow;
+    private getSessionPrefix;
+    isManagedSessionName(sessionName: string): boolean;
+    hasSession(sessionName: string): boolean;
+    ensureProjectSession(projectRoot: string, dashboardCommand?: TmuxCommandSpec): TmuxSessionRef;
+    listWindows(sessionName: string): TmuxWindowInfo[];
+    listSessionNames(): string[];
+    getTargetByWindowId(sessionName: string, windowId: string): TmuxTarget | null;
+    hasWindow(target: TmuxTarget): boolean;
+    isWindowAlive(target: TmuxTarget): boolean;
+    ensureDashboardWindow(sessionName: string, projectRoot: string, dashboardCommand?: TmuxCommandSpec): TmuxTarget;
+    createWindow(sessionName: string, name: string, cwd: string, command: string, args: string[], options?: {
+        detached?: boolean;
+    }): TmuxTarget;
+    killWindow(target: TmuxTarget): void;
+    killSession(sessionName: string): void;
+    renameWindow(windowTarget: string, name: string): void;
+    respawnWindow(target: TmuxTarget, spec: TmuxCommandSpec): void;
+    selectWindow(target: TmuxTarget): void;
+    sendFocusIn(target: TmuxTarget): void;
+    switchClientToTarget(clientTty: string, target: TmuxTarget): void;
+    displayWindowMenu(title: string, items: Array<{
+        label: string;
+        target: TmuxTarget;
+    }>): void;
+    displayWindowMenuForClient(clientTty: string, title: string, items: Array<{
+        label: string;
+        target: TmuxTarget;
+    }>): void;
+    captureTarget(target: TmuxTarget, options?: CaptureTargetOptions): string;
+    listClients(): TmuxClientInfo[];
+    findClientByTty(clientTty: string): TmuxClientInfo | null;
+    getAttachedClientForTarget(target: TmuxTarget): TmuxClientInfo | null;
+    sendText(target: TmuxTarget, text: string): void;
+    sendEnter(target: TmuxTarget): void;
+    sendClientEnter(clientTty: string): void;
+    sendClientCarriageReturn(clientTty: string, target: TmuxTarget): void;
+    sendCarriageReturn(target: TmuxTarget): void;
+    sendEscape(target: TmuxTarget): void;
+    sendModifiedEnter(target: TmuxTarget): void;
+    sendKey(target: TmuxTarget, key: string): void;
+    setWindowMetadata(target: TmuxTarget | string, metadata: TmuxWindowMetadata): void;
+    setWindowOption(target: TmuxTarget | string, key: string, value: string): void;
+    setSessionOption(sessionName: string, key: string, value: string): void;
+    applyManagedAgentWindowPolicy(target: TmuxTarget | string, toolConfigKey: string): void;
+    getWindowOption(target: TmuxTarget | string, key: string): string | null;
+    getWindowMetadata(target: TmuxTarget | string): TmuxWindowMetadata | null;
+    listManagedWindows(sessionName: string): Array<{
+        target: TmuxTarget;
+        metadata: TmuxWindowMetadata;
+    }>;
+    findManagedWindow(sessionName: string, matcher: {
+        sessionId?: string;
+        backendSessionId?: string;
+    }): {
+        target: TmuxTarget;
+        metadata: TmuxWindowMetadata;
+    } | null;
+    attachSession(sessionName: string, windowIndex?: number): void;
+    detachClient(): void;
+    switchToLastClientSession(): void;
+    currentClientSession(): string | null;
+    displayMessage(format: string, target?: string): string | null;
+    getSessionOption(sessionName: string, key: string): string | null;
+    setReturnSession(sessionName: string, returnSessionName: string): void;
+    getReturnSession(sessionName: string): string | null;
+    leaveManagedSession(options?: {
+        insideTmux?: boolean;
+        sessionName?: string;
+    }): void;
+    switchClient(sessionName: string, windowIndex?: number): void;
+    isInsideTmux(env?: NodeJS.ProcessEnv): boolean;
+    openTarget(target: TmuxTarget, options?: OpenTargetOptions): void;
+    private configureSession;
+    refreshStatus(): void;
+    private ensureTerminalFeature;
+    private resolveOpenSessionName;
+    private getDashboardWindowName;
+    private normalizeClientSuffix;
+    private resolveClientSuffix;
+    private getStatuslineCommandSpec;
+    private getControlScriptShellCommand;
+}