/** Browser terminal identities, metadata and screen-stream frames. */
import type { Branded } from '@deepseek-ai/dsh-brand';
declare module '@deepseek-ai/dsh-typert-protocol' {
    interface RemoteErrorDetailsMap {
        /** Input or resize was refused without invalidating the output attachment. */
        'terminal/control-unavailable': {
            readonly reason: 'read-only' | 'not-running';
        };
        /** Retained screens and pending allocations consume the Session's terminal quota. */
        'terminal/limit-reached': {
            readonly limit: number;
        };
    }
}
/** A terminal identity scoped to one Session and one Host lifetime. */
export type WebTerminalId = Branded<'WebTerminalId'>;
/** An attachment allowed to write and resize one terminal. */
export type TerminalAttachmentId = Branded<'TerminalAttachmentId'>;
/** An executable shell verified in the subprocess provider's execution environment. */
export interface TerminalShell {
    readonly path: string;
    readonly args: readonly string[];
    readonly name: string;
}
/** Working directory and limits shared by new and restored terminals. */
export interface TerminalEnvironment {
    readonly cwd: string;
    readonly maxInputBytes: number;
    readonly maxCols: number;
    readonly maxRows: number;
    readonly scrollback: number;
}
/** Host-owned terminal state; process exit never creates a replacement shell. */
export interface WebTerminalInfo {
    readonly id: WebTerminalId;
    readonly title: string;
    readonly shell: TerminalShell;
    /** Initial working directory; shell directory changes do not update this field. */
    readonly cwd: string;
    readonly cols: number;
    readonly rows: number;
    readonly state: 'running' | 'exited' | 'failed';
    readonly exitCode: number | null;
    readonly error?: string;
    readonly controllerId?: TerminalAttachmentId;
}
/** Create is idempotent for an open identity; closed identities cannot be recreated. */
export interface TerminalCreateRequest {
    /** A path returned by shell discovery; absent selects the execution default. */
    readonly shellPath?: string;
    readonly id: WebTerminalId;
    readonly cols: number;
    readonly rows: number;
}
/** Every attachment begins with a complete bounded screen, then ordered output. */
export type TerminalFrame = {
    readonly type: 'snapshot';
    readonly sequence: number;
    readonly screen: string;
    readonly info: WebTerminalInfo;
} | {
    readonly type: 'output';
    readonly sequence: number;
    readonly data: string;
} | {
    readonly type: 'state';
    readonly info: WebTerminalInfo;
};
//# sourceMappingURL=types.d.ts.map