dsh-bash-terminal-ts 0.2.6 → 0.4.1

package/lib/terminal.d.ts

@@ -1,87 +1,87 @@
-import type { BashTerminalContext, ResolvedPaths, TerminalHandle } from "./dsh-types.js";
-declare const TERMINAL_SIGNALS: readonly ["SIGINT", "SIGTERM", "SIGKILL", "SIGTSTP", "SIGHUP"];
-export type TerminalSignal = (typeof TERMINAL_SIGNALS)[number];
-interface TerminalBufferRead {
-    delta: string;
-    nextOffset: number;
-}
-interface TerminalBuffer {
-    append(chunk: string): void;
-    readFrom(offset: number): TerminalBufferRead;
-    snapshot(): string;
-}
-/** Interactive-shell argv (no -c: the terminal itself is the session). */
-export declare function terminalArgv(shell: string, paths: ResolvedPaths, distro?: string): Array<string | undefined>;
-interface TerminalSession {
-    id: string;
-    handle: TerminalHandle;
-    buffer: TerminalBuffer;
-    shell: string;
-    distro?: string;
-    closed: boolean;
-}
-export interface TerminalOpenOptions {
-    argv: string[];
-    shell: string;
-    cwd: string;
-    env: Record<string, string | undefined>;
-    rows: number;
-    cols: number;
-    distro?: string;
-    initial?: string;
-}
-export interface TerminalRegistry {
-    open(options: TerminalOpenOptions): Promise<TerminalSession>;
-    get(id: string): TerminalSession;
-    send(id: string, input: string): Promise<TerminalBufferRead>;
-    read(id: string): TerminalBufferRead;
-    signal(id: string, sig: string): Promise<TerminalBufferRead>;
-    close(id: string): Promise<boolean>;
-}
-/**
- * Terminal-session registry owned by the plugin fiber: opens PTYs through
- * the official seam, forwards output into a capped buffer, and tears every
- * session down on plugin disposal.
- */
-export declare function createTerminalRegistry(ctx: BashTerminalContext): TerminalRegistry;
-/** The terminal tool's arguments after runtime validation (discriminated by action). */
-export type ValidatedTerminalArgs = {
-    action: "open";
-    sessionId?: string;
-    command?: string;
-    distro?: string;
-    workdir?: string;
-} | {
-    action: "send";
-    sessionId: string;
-    input: string;
-} | {
-    action: "read";
-    sessionId: string;
-} | {
-    action: "signal";
-    sessionId: string;
-    signal: TerminalSignal;
-} | {
-    action: "close";
-    sessionId: string;
-};
-export declare function validateArgs(args: Record<string, unknown>): asserts args is ValidatedTerminalArgs;
-export interface TerminalOpenResult {
-    kind: "open";
-    sessionId: string;
-    pid: number;
-    shell: string;
-    output: string;
-}
-export interface TerminalSessionResult {
-    kind: "session";
-    output: string;
-}
-export interface TerminalClosedResult {
-    kind: "closed";
-    sessionId: string;
-}
-export type TerminalToolResult = TerminalOpenResult | TerminalSessionResult | TerminalClosedResult;
-export declare function terminalTool(ctx: BashTerminalContext, registry: TerminalRegistry, paths: ResolvedPaths, defaultShell: () => string): import("./dsh-types.js").ToolDefinition;
-export {};
+import type { BashTerminalContext, ResolvedPaths, TerminalHandle } from "./dsh-types.js";
+declare const TERMINAL_SIGNALS: readonly ["SIGINT", "SIGTERM", "SIGKILL", "SIGTSTP", "SIGHUP"];
+export type TerminalSignal = (typeof TERMINAL_SIGNALS)[number];
+interface TerminalBufferRead {
+    delta: string;
+    nextOffset: number;
+}
+interface TerminalBuffer {
+    append(chunk: string): void;
+    readFrom(offset: number): TerminalBufferRead;
+    snapshot(): string;
+}
+/** Interactive-shell argv (no -c: the terminal itself is the session). */
+export declare function terminalArgv(shell: string, paths: ResolvedPaths, distro?: string): Array<string | undefined>;
+interface TerminalSession {
+    id: string;
+    handle: TerminalHandle;
+    buffer: TerminalBuffer;
+    shell: string;
+    distro?: string;
+    closed: boolean;
+}
+export interface TerminalOpenOptions {
+    argv: string[];
+    shell: string;
+    cwd: string;
+    env: Record<string, string | undefined>;
+    rows: number;
+    cols: number;
+    distro?: string;
+    initial?: string;
+}
+export interface TerminalRegistry {
+    open(options: TerminalOpenOptions): Promise<TerminalSession>;
+    get(id: string): TerminalSession;
+    send(id: string, input: string): Promise<TerminalBufferRead>;
+    read(id: string): TerminalBufferRead;
+    signal(id: string, sig: string): Promise<TerminalBufferRead>;
+    close(id: string): Promise<boolean>;
+}
+/**
+ * Terminal-session registry owned by the plugin fiber: opens PTYs through
+ * the official seam, forwards output into a capped buffer, and tears every
+ * session down on plugin disposal.
+ */
+export declare function createTerminalRegistry(ctx: BashTerminalContext): TerminalRegistry;
+/** The terminal tool's arguments after runtime validation (discriminated by action). */
+export type ValidatedTerminalArgs = {
+    action: "open";
+    sessionId?: string;
+    command?: string;
+    distro?: string;
+    workdir?: string;
+} | {
+    action: "send";
+    sessionId: string;
+    input: string;
+} | {
+    action: "read";
+    sessionId: string;
+} | {
+    action: "signal";
+    sessionId: string;
+    signal: TerminalSignal;
+} | {
+    action: "close";
+    sessionId: string;
+};
+export declare function validateArgs(args: Record<string, unknown>): asserts args is ValidatedTerminalArgs;
+export interface TerminalOpenResult {
+    kind: "open";
+    sessionId: string;
+    pid: number;
+    shell: string;
+    output: string;
+}
+export interface TerminalSessionResult {
+    kind: "session";
+    output: string;
+}
+export interface TerminalClosedResult {
+    kind: "closed";
+    sessionId: string;
+}
+export type TerminalToolResult = TerminalOpenResult | TerminalSessionResult | TerminalClosedResult;
+export declare function terminalTool(ctx: BashTerminalContext, registry: TerminalRegistry, paths: ResolvedPaths, defaultShell: () => string): import("./dsh-types.js").ToolDefinition;
+export {};