@phren/cli/dist/bridge/pane-status.d.ts

Knowledge layer for AI agents - CLI, MCP server, and data layer

/** The status a lifecycle event leaves the agent in; undefined for events that say nothing about it. */
export declare function eventStatus(event: unknown): string | undefined;
/** Records the status of the agent in `pane`, which runs in terminal instance
 * `terminal`, and answers it with its sequence number. */
export declare function notePaneStatus(server: string, pane: string, terminal: string, status: string, at?: number): {
    status: string;
    seq: number;
};
/** A blocked pane whose dialog is gone was answered in the terminal: the
 * agent went back to work. Only after `minimumMs`, so a request whose
 * dialog is still being drawn is not settled early. */
export declare function settleBlockedPane(server: string, pane: string, minimumMs?: number): void;
/** The pane's last known status while `terminal` still runs there: from
 * memory, else from the binding file the last lifecycle event wrote. */
export declare function paneStatus(server: string, pane: string, terminal: string): Promise<{
    status: string;
    seq: number;
} | undefined>;
/** Claude's optional "Teach auto mode about your environment?" dialog. */
export declare function claudeTeachAutoModeDialog(screen: string): boolean;
/** Whether `screen` (a pane's visible lines, with or without colors) shows a
 * dialog waiting for `agent`'s owner. Stricter than the readers that answer
 * a dialog, because it runs while the agent is still writing: Claude's and
 * phren-agent's numbered rows count only with their "Esc to cancel" footer,
 * OpenCode's only as its own permission prompt. */
export declare function screenDialog(agent: string, screen: string): boolean;
/** The status of a pane after a look at its screen: blocked while a working
 * agent shows a dialog there (`screenDialog`), else `base` unchanged. `read`
 * answers the pane's visible lines; it runs only for a working pane, at most
 * once per DIALOG_READ_MS per pane. */
export declare function dialogStatus(server: string, pane: string, terminal: string, agent: string, base: {
    status: string;
    seq: number;
} | undefined, read: () => Promise<string>): Promise<{
    status: string;
    seq: number;
} | undefined>;
/** A Codex that has not sent its first lifecycle event, read from its
 * screen: blocked on a startup menu (folder trust, hooks to review), working
 * while it shows its interrupt hint (a turn whose hooks did not run), idle
 * once its composer and footer are drawn, else undefined (still starting). */
export declare function codexStartupStatus(screen: string): "blocked" | "working" | "idle" | undefined;
/** The status of a hooked agent in `pane` that has sent no lifecycle event
 * yet: Codex's screen read (`codexStartupStatus`) at most once per
 * DIALOG_READ_MS, else undefined. Its first event takes over for good. */
export declare function startupStatus(server: string, pane: string, terminal: string, agent: string, read: () => Promise<string>): Promise<{
    status: string;
    seq: number;
} | undefined>;
/** For tests. */
export declare function resetPaneStatus(): void;