@code-yeongyu/senpi 2026.7.4 → 2026.7.9-2

package/node_modules/@earendil-works/pi-pty/dist/session-native.js

@@ -0,0 +1,94 @@
+import { normalizeUnknownOperationResult } from "./session-exit.js";
+export function getNativeSessionFactory(loadResult) {
+    if (loadResult.native === null)
+        return null;
+    const create = loadResult.native.createPtySession ?? loadResult.native.startPtySession;
+    if (isNativeSessionCreator(create)) {
+        return (options, onData) => normalizeTerminalSessionHandle(create(options, onData));
+    }
+    const PtySession = loadResult.native.PtySession;
+    if (isNativeSessionConstructor(PtySession)) {
+        return (options, onData) => normalizeTerminalSessionHandle(new PtySession(options, onData));
+    }
+    return null;
+}
+function normalizeTerminalSessionHandle(value) {
+    if (!isRecord(value))
+        throw new Error("Native PTY session factory did not return an object");
+    const write = value.write;
+    const resize = value.resize;
+    const kill = value.kill;
+    if (!isNativeWrite(write))
+        throw new Error("Native PTY session handle is missing write()");
+    if (!isNativeResize(resize))
+        throw new Error("Native PTY session handle is missing resize()");
+    if (!isNativeKill(kill))
+        throw new Error("Native PTY session handle is missing kill()");
+    const waitExit = value.waitExit;
+    const wait = value.wait;
+    if (!isNativeWait(waitExit) && !isNativeWait(wait)) {
+        throw new Error("Native PTY session handle is missing waitExit() or wait()");
+    }
+    const requiredHandle = {
+        write(data) {
+            return normalizeUnknownOperationResult(write.call(value, data));
+        },
+        resize(cols, rows) {
+            return normalizeUnknownOperationResult(resize.call(value, cols, rows));
+        },
+        kill(signal) {
+            return normalizeUnknownOperationResult(kill.call(value, signal));
+        },
+    };
+    const onData = value.onData;
+    if (isNativeWait(waitExit) && isNativeOnData(onData)) {
+        return {
+            ...requiredHandle,
+            onData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),
+            waitExit: async () => waitExit.call(value),
+        };
+    }
+    if (isNativeWait(waitExit))
+        return { ...requiredHandle, waitExit: async () => waitExit.call(value) };
+    if (isNativeOnData(onData) && isNativeWait(wait)) {
+        return {
+            ...requiredHandle,
+            onData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),
+            wait: async () => wait.call(value),
+        };
+    }
+    if (isNativeWait(wait))
+        return { ...requiredHandle, wait: async () => wait.call(value) };
+    throw new Error("Native PTY session handle is missing waitExit() or wait()");
+}
+function normalizeUnsubscribe(value) {
+    return isUnsubscribe(value) ? value : () => { };
+}
+function isNativeSessionCreator(value) {
+    return typeof value === "function";
+}
+function isNativeSessionConstructor(value) {
+    return typeof value === "function";
+}
+function isNativeWrite(value) {
+    return typeof value === "function";
+}
+function isNativeResize(value) {
+    return typeof value === "function";
+}
+function isNativeKill(value) {
+    return typeof value === "function";
+}
+function isNativeWait(value) {
+    return typeof value === "function";
+}
+function isNativeOnData(value) {
+    return typeof value === "function";
+}
+function isUnsubscribe(value) {
+    return typeof value === "function";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=session-native.js.map

package/node_modules/@earendil-works/pi-pty/dist/session-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-native.js","sourceRoot":"","sources":["../src/session-native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NativePtyLoadResult } from \"./native-loader.ts\";\nimport { normalizeUnknownOperationResult } from \"./session-exit.ts\";\nimport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionDataHandler,\n\tTerminalSessionHandle,\n\tTerminalSessionNativeOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\ntype NativeSessionCreator = (options: TerminalSessionNativeOptions, onData: TerminalSessionDataHandler) => unknown;\ntype NativeSessionConstructor = new (\n\toptions: TerminalSessionNativeOptions,\n\tonData: TerminalSessionDataHandler,\n) => unknown;\ntype NativeWrite = (data: string | Uint8Array) => unknown;\ntype NativeResize = (cols: number, rows: number) => unknown;\ntype NativeKill = (signal?: TerminalSessionSignal) => unknown;\ntype NativeWait = () => Promise<unknown> | unknown;\ntype NativeOnData = (handler: TerminalSessionDataHandler) => (() => void) | unknown;\n\nexport function getNativeSessionFactory(loadResult: NativePtyLoadResult): CreateNativeTerminalSession | null {\n\tif (loadResult.native === null) return null;\n\tconst create = loadResult.native.createPtySession ?? loadResult.native.startPtySession;\n\tif (isNativeSessionCreator(create)) {\n\t\treturn (options, onData) => normalizeTerminalSessionHandle(create(options, onData));\n\t}\n\tconst PtySession = loadResult.native.PtySession;\n\tif (isNativeSessionConstructor(PtySession)) {\n\t\treturn (options, onData) => normalizeTerminalSessionHandle(new PtySession(options, onData));\n\t}\n\treturn null;\n}\n\nfunction normalizeTerminalSessionHandle(value: unknown): TerminalSessionHandle {\n\tif (!isRecord(value)) throw new Error(\"Native PTY session factory did not return an object\");\n\tconst write = value.write;\n\tconst resize = value.resize;\n\tconst kill = value.kill;\n\tif (!isNativeWrite(write)) throw new Error(\"Native PTY session handle is missing write()\");\n\tif (!isNativeResize(resize)) throw new Error(\"Native PTY session handle is missing resize()\");\n\tif (!isNativeKill(kill)) throw new Error(\"Native PTY session handle is missing kill()\");\n\n\tconst waitExit = value.waitExit;\n\tconst wait = value.wait;\n\tif (!isNativeWait(waitExit) && !isNativeWait(wait)) {\n\t\tthrow new Error(\"Native PTY session handle is missing waitExit() or wait()\");\n\t}\n\n\tconst requiredHandle = {\n\t\twrite(data: string | Uint8Array) {\n\t\t\treturn normalizeUnknownOperationResult(write.call(value, data));\n\t\t},\n\t\tresize(cols: number, rows: number) {\n\t\t\treturn normalizeUnknownOperationResult(resize.call(value, cols, rows));\n\t\t},\n\t\tkill(signal?: TerminalSessionSignal) {\n\t\t\treturn normalizeUnknownOperationResult(kill.call(value, signal));\n\t\t},\n\t};\n\tconst onData = value.onData;\n\tif (isNativeWait(waitExit) && isNativeOnData(onData)) {\n\t\treturn {\n\t\t\t...requiredHandle,\n\t\t\tonData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),\n\t\t\twaitExit: async () => waitExit.call(value),\n\t\t};\n\t}\n\tif (isNativeWait(waitExit)) return { ...requiredHandle, waitExit: async () => waitExit.call(value) };\n\tif (isNativeOnData(onData) && isNativeWait(wait)) {\n\t\treturn {\n\t\t\t...requiredHandle,\n\t\t\tonData: (handler) => normalizeUnsubscribe(onData.call(value, handler)),\n\t\t\twait: async () => wait.call(value),\n\t\t};\n\t}\n\tif (isNativeWait(wait)) return { ...requiredHandle, wait: async () => wait.call(value) };\n\tthrow new Error(\"Native PTY session handle is missing waitExit() or wait()\");\n}\n\nfunction normalizeUnsubscribe(value: unknown): () => void {\n\treturn isUnsubscribe(value) ? value : () => {};\n}\n\nfunction isNativeSessionCreator(value: unknown): value is NativeSessionCreator {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeSessionConstructor(value: unknown): value is NativeSessionConstructor {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeWrite(value: unknown): value is NativeWrite {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeResize(value: unknown): value is NativeResize {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeKill(value: unknown): value is NativeKill {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeWait(value: unknown): value is NativeWait {\n\treturn typeof value === \"function\";\n}\n\nfunction isNativeOnData(value: unknown): value is NativeOnData {\n\treturn typeof value === \"function\";\n}\n\nfunction isUnsubscribe(value: unknown): value is () => void {\n\treturn typeof value === \"function\";\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n\treturn typeof value === \"object\" && value !== null;\n}\n"]}

package/node_modules/@earendil-works/pi-pty/dist/session-options.d.ts

@@ -0,0 +1,10 @@
+import type { PipeFallbackSessionOptions } from "./pipe-fallback.ts";
+import type { TerminalSessionNativeOptions, TerminalSessionOptions } from "./session-types.ts";
+export declare const DEFAULT_COLS = 80;
+export declare const DEFAULT_ROWS = 24;
+export declare const DEFAULT_RAW_TAIL_BYTES: number;
+export declare function normalizeRawTailBytes(value: number | undefined): number;
+export declare function defaultCommand(): string;
+export declare function toNativeOptions(options: TerminalSessionOptions): TerminalSessionNativeOptions;
+export declare function toPipeFallbackOptions(options: TerminalSessionOptions): PipeFallbackSessionOptions;
+//# sourceMappingURL=session-options.d.ts.map

package/node_modules/@earendil-works/pi-pty/dist/session-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-options.d.ts","sourceRoot":"","sources":["../src/session-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE/F,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMvE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,4BAA4B,CAU7F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,0BAA0B,CAQjG"}

package/node_modules/@earendil-works/pi-pty/dist/session-options.js

@@ -0,0 +1,38 @@
+import process from "node:process";
+export const DEFAULT_COLS = 80;
+export const DEFAULT_ROWS = 24;
+export const DEFAULT_RAW_TAIL_BYTES = 64 * 1024;
+export function normalizeRawTailBytes(value) {
+    if (value === undefined)
+        return DEFAULT_RAW_TAIL_BYTES;
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error("Invalid rawTailBytes: must be a non-negative safe integer");
+    }
+    return value;
+}
+export function defaultCommand() {
+    if (process.platform === "win32")
+        return process.env.ComSpec ?? "cmd.exe";
+    return process.env.SHELL ?? "sh";
+}
+export function toNativeOptions(options) {
+    return {
+        command: options.command ?? defaultCommand(),
+        args: [...(options.args ?? [])],
+        cwd: options.cwd,
+        env: options.env ? { ...options.env } : undefined,
+        cols: options.cols ?? DEFAULT_COLS,
+        rows: options.rows ?? DEFAULT_ROWS,
+        timeoutMs: options.timeoutMs,
+    };
+}
+export function toPipeFallbackOptions(options) {
+    return {
+        command: options.command ?? defaultCommand(),
+        args: options.args ? [...options.args] : undefined,
+        cwd: options.cwd,
+        env: options.env ? { ...options.env } : undefined,
+        timeoutMs: options.timeoutMs,
+    };
+}
+//# sourceMappingURL=session-options.js.map

package/node_modules/@earendil-works/pi-pty/dist/session-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-options.js","sourceRoot":"","sources":["../src/session-options.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAInC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC9D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC9D,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE;QAC5C,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACpE,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,CAAC;AACH,CAAC","sourcesContent":["import process from \"node:process\";\nimport type { PipeFallbackSessionOptions } from \"./pipe-fallback.ts\";\nimport type { TerminalSessionNativeOptions, TerminalSessionOptions } from \"./session-types.ts\";\n\nexport const DEFAULT_COLS = 80;\nexport const DEFAULT_ROWS = 24;\nexport const DEFAULT_RAW_TAIL_BYTES = 64 * 1024;\n\nexport function normalizeRawTailBytes(value: number | undefined): number {\n\tif (value === undefined) return DEFAULT_RAW_TAIL_BYTES;\n\tif (!Number.isSafeInteger(value) || value < 0) {\n\t\tthrow new Error(\"Invalid rawTailBytes: must be a non-negative safe integer\");\n\t}\n\treturn value;\n}\n\nexport function defaultCommand(): string {\n\tif (process.platform === \"win32\") return process.env.ComSpec ?? \"cmd.exe\";\n\treturn process.env.SHELL ?? \"sh\";\n}\n\nexport function toNativeOptions(options: TerminalSessionOptions): TerminalSessionNativeOptions {\n\treturn {\n\t\tcommand: options.command ?? defaultCommand(),\n\t\targs: [...(options.args ?? [])],\n\t\tcwd: options.cwd,\n\t\tenv: options.env ? { ...options.env } : undefined,\n\t\tcols: options.cols ?? DEFAULT_COLS,\n\t\trows: options.rows ?? DEFAULT_ROWS,\n\t\ttimeoutMs: options.timeoutMs,\n\t};\n}\n\nexport function toPipeFallbackOptions(options: TerminalSessionOptions): PipeFallbackSessionOptions {\n\treturn {\n\t\tcommand: options.command ?? defaultCommand(),\n\t\targs: options.args ? [...options.args] : undefined,\n\t\tcwd: options.cwd,\n\t\tenv: options.env ? { ...options.env } : undefined,\n\t\ttimeoutMs: options.timeoutMs,\n\t};\n}\n"]}

package/node_modules/@earendil-works/pi-pty/dist/session-types.d.ts

@@ -0,0 +1,64 @@
+import type { Buffer } from "node:buffer";
+import type { NativePtyLoadResult } from "./native-loader.ts";
+export type TerminalSessionBackend = "native" | "pipe-fallback";
+export type TerminalSessionDataHandler = (chunk: Buffer) => void;
+export type TerminalSessionSignal = NodeJS.Signals;
+export interface TerminalSessionOptions {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly cols?: number;
+    readonly rows?: number;
+    readonly timeoutMs?: number;
+    readonly rawTailBytes?: number;
+}
+export interface TerminalSessionNativeOptions {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly cols: number;
+    readonly rows: number;
+    readonly timeoutMs?: number;
+}
+export interface TerminalSessionOperationResult {
+    readonly ok: boolean;
+    readonly note: string;
+    readonly code?: string;
+    readonly idempotent?: boolean;
+}
+export interface TerminalSessionExitError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface TerminalSessionExit {
+    readonly backend: TerminalSessionBackend;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+    readonly cancelled: boolean;
+    readonly timedOut: boolean;
+    readonly error?: TerminalSessionExitError;
+}
+export type TerminalSessionExitState = {
+    readonly status: "not_started" | "running";
+    readonly exit: null;
+} | {
+    readonly status: "exited";
+    readonly exit: TerminalSessionExit;
+};
+export interface TerminalSessionHandle {
+    readonly onData?: (handler: TerminalSessionDataHandler) => () => void;
+    readonly write: (data: string | Uint8Array) => TerminalSessionOperationResult | undefined;
+    readonly resize: (cols: number, rows: number) => TerminalSessionOperationResult | undefined;
+    readonly kill: (signal?: TerminalSessionSignal) => TerminalSessionOperationResult | undefined;
+    readonly waitExit?: () => Promise<unknown>;
+    readonly wait?: () => Promise<unknown>;
+}
+export type CreateNativeTerminalSession = (options: TerminalSessionNativeOptions, onData: TerminalSessionDataHandler) => TerminalSessionHandle;
+export interface TerminalSessionDependencies {
+    readonly nativeLoadResult?: NativePtyLoadResult;
+    readonly createNativeSession?: CreateNativeTerminalSession;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+//# sourceMappingURL=session-types.d.ts.map

package/node_modules/@earendil-works/pi-pty/dist/session-types.d.ts.map

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

package/node_modules/@earendil-works/pi-pty/dist/session-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-types.js.map

package/node_modules/@earendil-works/pi-pty/dist/session-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../src/session-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Buffer } from \"node:buffer\";\nimport type { NativePtyLoadResult } from \"./native-loader.ts\";\n\nexport type TerminalSessionBackend = \"native\" | \"pipe-fallback\";\nexport type TerminalSessionDataHandler = (chunk: Buffer) => void;\nexport type TerminalSessionSignal = NodeJS.Signals;\n\nexport interface TerminalSessionOptions {\n\treadonly command?: string;\n\treadonly args?: readonly string[];\n\treadonly cwd?: string;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n\treadonly cols?: number;\n\treadonly rows?: number;\n\treadonly timeoutMs?: number;\n\treadonly rawTailBytes?: number;\n}\n\nexport interface TerminalSessionNativeOptions {\n\treadonly command: string;\n\treadonly args: readonly string[];\n\treadonly cwd?: string;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n\treadonly cols: number;\n\treadonly rows: number;\n\treadonly timeoutMs?: number;\n}\n\nexport interface TerminalSessionOperationResult {\n\treadonly ok: boolean;\n\treadonly note: string;\n\treadonly code?: string;\n\treadonly idempotent?: boolean;\n}\n\nexport interface TerminalSessionExitError {\n\treadonly code: string;\n\treadonly message: string;\n}\n\nexport interface TerminalSessionExit {\n\treadonly backend: TerminalSessionBackend;\n\treadonly exitCode: number | null;\n\treadonly signal: string | null;\n\treadonly cancelled: boolean;\n\treadonly timedOut: boolean;\n\treadonly error?: TerminalSessionExitError;\n}\n\nexport type TerminalSessionExitState =\n\t| {\n\t\t\treadonly status: \"not_started\" | \"running\";\n\t\t\treadonly exit: null;\n\t  }\n\t| {\n\t\t\treadonly status: \"exited\";\n\t\t\treadonly exit: TerminalSessionExit;\n\t  };\n\nexport interface TerminalSessionHandle {\n\treadonly onData?: (handler: TerminalSessionDataHandler) => () => void;\n\treadonly write: (data: string | Uint8Array) => TerminalSessionOperationResult | undefined;\n\treadonly resize: (cols: number, rows: number) => TerminalSessionOperationResult | undefined;\n\treadonly kill: (signal?: TerminalSessionSignal) => TerminalSessionOperationResult | undefined;\n\treadonly waitExit?: () => Promise<unknown>;\n\treadonly wait?: () => Promise<unknown>;\n}\n\nexport type CreateNativeTerminalSession = (\n\toptions: TerminalSessionNativeOptions,\n\tonData: TerminalSessionDataHandler,\n) => TerminalSessionHandle;\n\nexport interface TerminalSessionDependencies {\n\treadonly nativeLoadResult?: NativePtyLoadResult;\n\treadonly createNativeSession?: CreateNativeTerminalSession;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n}\n"]}

package/node_modules/@earendil-works/pi-pty/dist/session.d.ts

@@ -0,0 +1,47 @@
+import { Buffer } from "node:buffer";
+import { type NativePtyLoadResult, type NativePtyUnavailableDiagnostic } from "./native-loader.ts";
+import type { TerminalSessionBackend, TerminalSessionDataHandler, TerminalSessionDependencies, TerminalSessionExit, TerminalSessionExitState, TerminalSessionOperationResult, TerminalSessionOptions, TerminalSessionSignal } from "./session-types.ts";
+export type { CreateNativeTerminalSession, TerminalSessionBackend, TerminalSessionDataHandler, TerminalSessionDependencies, TerminalSessionExit, TerminalSessionExitError, TerminalSessionExitState, TerminalSessionHandle, TerminalSessionNativeOptions, TerminalSessionOperationResult, TerminalSessionOptions, TerminalSessionSignal, } from "./session-types.ts";
+export declare class TerminalSession {
+    readonly options: TerminalSessionOptions;
+    private readonly nativeLoadResult;
+    private readonly createNativeSessionDependency?;
+    private readonly env;
+    private readonly rawTailLimit;
+    private readonly dataHandlers;
+    private readonly exitHandlers;
+    private backendHandle;
+    private backendValue;
+    private exitPromise;
+    private settledExit;
+    private rawTailBuffer;
+    private rawByteCount;
+    private killRequested;
+    private unsubscribeBackendData;
+    constructor(options?: TerminalSessionOptions, dependencies?: TerminalSessionDependencies);
+    get native(): NativePtyLoadResult;
+    get unavailableDiagnostic(): NativePtyUnavailableDiagnostic | null;
+    get backend(): TerminalSessionBackend | null;
+    get command(): string;
+    get status(): "not_started" | "running" | "exited";
+    get exited(): boolean;
+    get isExited(): boolean;
+    get exitResult(): TerminalSessionExit | null;
+    get rawTail(): Buffer;
+    get rawOutputBytes(): number;
+    get exitState(): TerminalSessionExitState;
+    start(): this;
+    onData(handler: TerminalSessionDataHandler): () => void;
+    onExit(handler: () => void): () => void;
+    write(data: string | Uint8Array): TerminalSessionOperationResult;
+    resize(cols: number, rows: number): TerminalSessionOperationResult;
+    kill(signal?: TerminalSessionSignal): TerminalSessionOperationResult;
+    stop(): TerminalSessionOperationResult;
+    waitExit(): Promise<TerminalSessionExit>;
+    private waitBackendExit;
+    private settleExit;
+    private emitData;
+    private appendRawTail;
+}
+export declare function createTerminalSession(options?: TerminalSessionOptions, dependencies?: TerminalSessionDependencies): TerminalSession;
+//# sourceMappingURL=session.d.ts.map

package/node_modules/@earendil-works/pi-pty/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAiB,KAAK,mBAAmB,EAAE,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAUlH,OAAO,KAAK,EAEX,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EAExB,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACX,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,eAAe;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAA8B;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,sBAAsB,CAA6B;IAE3D,YAAY,OAAO,GAAE,sBAA2B,EAAE,YAAY,GAAE,2BAAgC,EAU/F;IAED,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,IAAI,qBAAqB,IAAI,8BAA8B,GAAG,IAAI,CAGjE;IAED,IAAI,OAAO,IAAI,sBAAsB,GAAG,IAAI,CAE3C;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,GAAG,QAAQ,CAEjD;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,UAAU,IAAI,mBAAmB,GAAG,IAAI,CAE3C;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,SAAS,IAAI,wBAAwB,CAGxC;IAED,KAAK,IAAI,IAAI,CA2BZ;IAED,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,IAAI,CAGtD;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAItC;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,8BAA8B,CAK/D;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,8BAA8B,CAKjE;IAED,IAAI,CAAC,MAAM,GAAE,qBAAiC,GAAG,8BAA8B,CAe9E;IAED,IAAI,IAAI,8BAA8B,CAErC;IAEK,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAI7C;YAEa,eAAe;IAU7B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,aAAa;CAUrB;AAED,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,sBAA2B,EACpC,YAAY,GAAE,2BAAgC,GAC5C,eAAe,CAEjB"}

package/node_modules/@earendil-works/pi-pty/dist/session.js

@@ -0,0 +1,187 @@
+import { Buffer } from "node:buffer";
+import process from "node:process";
+import { loadNativePty } from "./native-loader.js";
+import { PipeFallbackSession, shouldUsePipeFallback } from "./pipe-fallback.js";
+import { exitedOperation, normalizeOperationResult, normalizeTerminalExit, notStartedOperation, } from "./session-exit.js";
+import { getNativeSessionFactory } from "./session-native.js";
+import { defaultCommand, normalizeRawTailBytes, toNativeOptions, toPipeFallbackOptions } from "./session-options.js";
+export class TerminalSession {
+    constructor(options = {}, dependencies = {}) {
+        this.dataHandlers = new Set();
+        this.exitHandlers = new Set();
+        this.backendHandle = null;
+        this.backendValue = null;
+        this.exitPromise = null;
+        this.settledExit = null;
+        this.rawTailBuffer = Buffer.alloc(0);
+        this.rawByteCount = 0;
+        this.killRequested = false;
+        this.unsubscribeBackendData = null;
+        this.options = {
+            ...options,
+            args: options.args ? [...options.args] : undefined,
+            env: options.env ? { ...options.env } : undefined,
+        };
+        this.nativeLoadResult = dependencies.nativeLoadResult ?? loadNativePty();
+        this.createNativeSessionDependency = dependencies.createNativeSession;
+        this.env = dependencies.env ?? process.env;
+        this.rawTailLimit = normalizeRawTailBytes(options.rawTailBytes);
+    }
+    get native() {
+        return this.nativeLoadResult;
+    }
+    get unavailableDiagnostic() {
+        if (this.nativeLoadResult.native !== null)
+            return null;
+        return this.nativeLoadResult.diagnostic;
+    }
+    get backend() {
+        return this.backendValue;
+    }
+    get command() {
+        return this.options.command ?? defaultCommand();
+    }
+    get status() {
+        return this.exitState.status;
+    }
+    get exited() {
+        return this.settledExit !== null;
+    }
+    get isExited() {
+        return this.exited;
+    }
+    get exitResult() {
+        return this.settledExit;
+    }
+    get rawTail() {
+        return Buffer.from(this.rawTailBuffer);
+    }
+    get rawOutputBytes() {
+        return this.rawByteCount;
+    }
+    get exitState() {
+        if (this.settledExit !== null)
+            return { status: "exited", exit: this.settledExit };
+        return { status: this.backendHandle === null ? "not_started" : "running", exit: null };
+    }
+    start() {
+        if (this.settledExit !== null)
+            throw new Error("Cannot restart exited terminal session");
+        if (this.backendHandle !== null)
+            throw new Error("Terminal session has already been started");
+        const nativeFactory = this.createNativeSessionDependency ?? getNativeSessionFactory(this.nativeLoadResult);
+        if (nativeFactory && !shouldUsePipeFallback(this.nativeLoadResult, this.env)) {
+            this.backendValue = "native";
+            this.backendHandle = nativeFactory(toNativeOptions(this.options), (chunk) => this.emitData(chunk));
+        }
+        else {
+            this.backendValue = "pipe-fallback";
+            const fallback = new PipeFallbackSession(toPipeFallbackOptions(this.options));
+            this.backendHandle = fallback;
+            this.unsubscribeBackendData = fallback.onData((chunk) => this.emitData(chunk));
+            fallback.start();
+        }
+        const backendHandle = this.backendHandle;
+        const backendValue = this.backendValue;
+        if (backendHandle === null || backendValue === null) {
+            throw new Error("Terminal session backend did not initialize");
+        }
+        if (backendValue === "native" && backendHandle.onData) {
+            this.unsubscribeBackendData = backendHandle.onData((chunk) => this.emitData(chunk));
+        }
+        this.exitPromise = this.waitBackendExit(backendHandle, backendValue).then((exit) => this.settleExit(exit));
+        return this;
+    }
+    onData(handler) {
+        this.dataHandlers.add(handler);
+        return () => this.dataHandlers.delete(handler);
+    }
+    onExit(handler) {
+        if (this.settledExit !== null)
+            queueMicrotask(handler);
+        else
+            this.exitHandlers.add(handler);
+        return () => this.exitHandlers.delete(handler);
+    }
+    write(data) {
+        const handle = this.backendHandle;
+        if (this.settledExit !== null)
+            return exitedOperation("write");
+        if (handle === null)
+            return notStartedOperation("write");
+        return normalizeOperationResult(handle.write(data), "Wrote data to terminal session.");
+    }
+    resize(cols, rows) {
+        const handle = this.backendHandle;
+        if (this.settledExit !== null)
+            return exitedOperation("resize");
+        if (handle === null)
+            return notStartedOperation("resize");
+        return normalizeOperationResult(handle.resize(cols, rows), `Resized terminal session to ${cols}x${rows}.`);
+    }
+    kill(signal = "SIGTERM") {
+        const handle = this.backendHandle;
+        if (this.killRequested || this.settledExit !== null) {
+            return {
+                ok: true,
+                idempotent: true,
+                note: "Terminal session kill was already requested.",
+            };
+        }
+        if (handle === null)
+            return notStartedOperation("kill");
+        this.killRequested = true;
+        const result = normalizeOperationResult(handle.kill(signal), `Sent ${signal} to terminal session.`);
+        if (!result.ok)
+            this.killRequested = false;
+        return result;
+    }
+    stop() {
+        return this.kill();
+    }
+    async waitExit() {
+        if (this.settledExit !== null)
+            return this.settledExit;
+        if (this.exitPromise === null)
+            throw new Error("Cannot wait for terminal session exit before start");
+        return await this.exitPromise;
+    }
+    async waitBackendExit(handle, backend) {
+        const wait = handle.waitExit ?? handle.wait;
+        if (!wait)
+            throw new Error("Terminal session backend does not expose waitExit or wait");
+        const exit = await wait.call(handle);
+        return normalizeTerminalExit(exit, backend, this.killRequested);
+    }
+    settleExit(exit) {
+        if (this.settledExit !== null)
+            return this.settledExit;
+        this.settledExit = exit;
+        this.unsubscribeBackendData?.();
+        this.unsubscribeBackendData = null;
+        for (const handler of this.exitHandlers)
+            handler();
+        this.exitHandlers.clear();
+        return exit;
+    }
+    emitData(chunk) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        this.appendRawTail(buffer);
+        for (const handler of this.dataHandlers)
+            handler(buffer);
+    }
+    appendRawTail(chunk) {
+        this.rawByteCount += chunk.byteLength;
+        if (this.rawTailLimit === 0) {
+            this.rawTailBuffer = Buffer.alloc(0);
+            return;
+        }
+        const next = Buffer.concat([this.rawTailBuffer, chunk]);
+        this.rawTailBuffer =
+            next.byteLength <= this.rawTailLimit ? next : next.subarray(next.byteLength - this.rawTailLimit);
+    }
+}
+export function createTerminalSession(options = {}, dependencies = {}) {
+    return new TerminalSession(options, dependencies).start();
+}
+//# sourceMappingURL=session.js.map

package/node_modules/@earendil-works/pi-pty/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport process from \"node:process\";\nimport { loadNativePty, type NativePtyLoadResult, type NativePtyUnavailableDiagnostic } from \"./native-loader.ts\";\nimport { PipeFallbackSession, shouldUsePipeFallback } from \"./pipe-fallback.ts\";\nimport {\n\texitedOperation,\n\tnormalizeOperationResult,\n\tnormalizeTerminalExit,\n\tnotStartedOperation,\n} from \"./session-exit.ts\";\nimport { getNativeSessionFactory } from \"./session-native.ts\";\nimport { defaultCommand, normalizeRawTailBytes, toNativeOptions, toPipeFallbackOptions } from \"./session-options.ts\";\nimport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionBackend,\n\tTerminalSessionDataHandler,\n\tTerminalSessionDependencies,\n\tTerminalSessionExit,\n\tTerminalSessionExitState,\n\tTerminalSessionHandle,\n\tTerminalSessionOperationResult,\n\tTerminalSessionOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\nexport type {\n\tCreateNativeTerminalSession,\n\tTerminalSessionBackend,\n\tTerminalSessionDataHandler,\n\tTerminalSessionDependencies,\n\tTerminalSessionExit,\n\tTerminalSessionExitError,\n\tTerminalSessionExitState,\n\tTerminalSessionHandle,\n\tTerminalSessionNativeOptions,\n\tTerminalSessionOperationResult,\n\tTerminalSessionOptions,\n\tTerminalSessionSignal,\n} from \"./session-types.ts\";\n\nexport class TerminalSession {\n\treadonly options: TerminalSessionOptions;\n\tprivate readonly nativeLoadResult: NativePtyLoadResult;\n\tprivate readonly createNativeSessionDependency?: CreateNativeTerminalSession;\n\tprivate readonly env: Readonly<Record<string, string | undefined>>;\n\tprivate readonly rawTailLimit: number;\n\tprivate readonly dataHandlers = new Set<TerminalSessionDataHandler>();\n\tprivate readonly exitHandlers = new Set<() => void>();\n\tprivate backendHandle: TerminalSessionHandle | null = null;\n\tprivate backendValue: TerminalSessionBackend | null = null;\n\tprivate exitPromise: Promise<TerminalSessionExit> | null = null;\n\tprivate settledExit: TerminalSessionExit | null = null;\n\tprivate rawTailBuffer = Buffer.alloc(0);\n\tprivate rawByteCount = 0;\n\tprivate killRequested = false;\n\tprivate unsubscribeBackendData: (() => void) | null = null;\n\n\tconstructor(options: TerminalSessionOptions = {}, dependencies: TerminalSessionDependencies = {}) {\n\t\tthis.options = {\n\t\t\t...options,\n\t\t\targs: options.args ? [...options.args] : undefined,\n\t\t\tenv: options.env ? { ...options.env } : undefined,\n\t\t};\n\t\tthis.nativeLoadResult = dependencies.nativeLoadResult ?? loadNativePty();\n\t\tthis.createNativeSessionDependency = dependencies.createNativeSession;\n\t\tthis.env = dependencies.env ?? process.env;\n\t\tthis.rawTailLimit = normalizeRawTailBytes(options.rawTailBytes);\n\t}\n\n\tget native(): NativePtyLoadResult {\n\t\treturn this.nativeLoadResult;\n\t}\n\n\tget unavailableDiagnostic(): NativePtyUnavailableDiagnostic | null {\n\t\tif (this.nativeLoadResult.native !== null) return null;\n\t\treturn this.nativeLoadResult.diagnostic;\n\t}\n\n\tget backend(): TerminalSessionBackend | null {\n\t\treturn this.backendValue;\n\t}\n\n\tget command(): string {\n\t\treturn this.options.command ?? defaultCommand();\n\t}\n\n\tget status(): \"not_started\" | \"running\" | \"exited\" {\n\t\treturn this.exitState.status;\n\t}\n\n\tget exited(): boolean {\n\t\treturn this.settledExit !== null;\n\t}\n\n\tget isExited(): boolean {\n\t\treturn this.exited;\n\t}\n\n\tget exitResult(): TerminalSessionExit | null {\n\t\treturn this.settledExit;\n\t}\n\n\tget rawTail(): Buffer {\n\t\treturn Buffer.from(this.rawTailBuffer);\n\t}\n\n\tget rawOutputBytes(): number {\n\t\treturn this.rawByteCount;\n\t}\n\n\tget exitState(): TerminalSessionExitState {\n\t\tif (this.settledExit !== null) return { status: \"exited\", exit: this.settledExit };\n\t\treturn { status: this.backendHandle === null ? \"not_started\" : \"running\", exit: null };\n\t}\n\n\tstart(): this {\n\t\tif (this.settledExit !== null) throw new Error(\"Cannot restart exited terminal session\");\n\t\tif (this.backendHandle !== null) throw new Error(\"Terminal session has already been started\");\n\n\t\tconst nativeFactory = this.createNativeSessionDependency ?? getNativeSessionFactory(this.nativeLoadResult);\n\t\tif (nativeFactory && !shouldUsePipeFallback(this.nativeLoadResult, this.env)) {\n\t\t\tthis.backendValue = \"native\";\n\t\t\tthis.backendHandle = nativeFactory(toNativeOptions(this.options), (chunk) => this.emitData(chunk));\n\t\t} else {\n\t\t\tthis.backendValue = \"pipe-fallback\";\n\t\t\tconst fallback = new PipeFallbackSession(toPipeFallbackOptions(this.options));\n\t\t\tthis.backendHandle = fallback;\n\t\t\tthis.unsubscribeBackendData = fallback.onData((chunk) => this.emitData(chunk));\n\t\t\tfallback.start();\n\t\t}\n\n\t\tconst backendHandle = this.backendHandle;\n\t\tconst backendValue = this.backendValue;\n\t\tif (backendHandle === null || backendValue === null) {\n\t\t\tthrow new Error(\"Terminal session backend did not initialize\");\n\t\t}\n\n\t\tif (backendValue === \"native\" && backendHandle.onData) {\n\t\t\tthis.unsubscribeBackendData = backendHandle.onData((chunk) => this.emitData(chunk));\n\t\t}\n\t\tthis.exitPromise = this.waitBackendExit(backendHandle, backendValue).then((exit) => this.settleExit(exit));\n\t\treturn this;\n\t}\n\n\tonData(handler: TerminalSessionDataHandler): () => void {\n\t\tthis.dataHandlers.add(handler);\n\t\treturn () => this.dataHandlers.delete(handler);\n\t}\n\n\tonExit(handler: () => void): () => void {\n\t\tif (this.settledExit !== null) queueMicrotask(handler);\n\t\telse this.exitHandlers.add(handler);\n\t\treturn () => this.exitHandlers.delete(handler);\n\t}\n\n\twrite(data: string | Uint8Array): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.settledExit !== null) return exitedOperation(\"write\");\n\t\tif (handle === null) return notStartedOperation(\"write\");\n\t\treturn normalizeOperationResult(handle.write(data), \"Wrote data to terminal session.\");\n\t}\n\n\tresize(cols: number, rows: number): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.settledExit !== null) return exitedOperation(\"resize\");\n\t\tif (handle === null) return notStartedOperation(\"resize\");\n\t\treturn normalizeOperationResult(handle.resize(cols, rows), `Resized terminal session to ${cols}x${rows}.`);\n\t}\n\n\tkill(signal: TerminalSessionSignal = \"SIGTERM\"): TerminalSessionOperationResult {\n\t\tconst handle = this.backendHandle;\n\t\tif (this.killRequested || this.settledExit !== null) {\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tidempotent: true,\n\t\t\t\tnote: \"Terminal session kill was already requested.\",\n\t\t\t};\n\t\t}\n\t\tif (handle === null) return notStartedOperation(\"kill\");\n\n\t\tthis.killRequested = true;\n\t\tconst result = normalizeOperationResult(handle.kill(signal), `Sent ${signal} to terminal session.`);\n\t\tif (!result.ok) this.killRequested = false;\n\t\treturn result;\n\t}\n\n\tstop(): TerminalSessionOperationResult {\n\t\treturn this.kill();\n\t}\n\n\tasync waitExit(): Promise<TerminalSessionExit> {\n\t\tif (this.settledExit !== null) return this.settledExit;\n\t\tif (this.exitPromise === null) throw new Error(\"Cannot wait for terminal session exit before start\");\n\t\treturn await this.exitPromise;\n\t}\n\n\tprivate async waitBackendExit(\n\t\thandle: TerminalSessionHandle,\n\t\tbackend: TerminalSessionBackend,\n\t): Promise<TerminalSessionExit> {\n\t\tconst wait = handle.waitExit ?? handle.wait;\n\t\tif (!wait) throw new Error(\"Terminal session backend does not expose waitExit or wait\");\n\t\tconst exit = await wait.call(handle);\n\t\treturn normalizeTerminalExit(exit, backend, this.killRequested);\n\t}\n\n\tprivate settleExit(exit: TerminalSessionExit): TerminalSessionExit {\n\t\tif (this.settledExit !== null) return this.settledExit;\n\t\tthis.settledExit = exit;\n\t\tthis.unsubscribeBackendData?.();\n\t\tthis.unsubscribeBackendData = null;\n\t\tfor (const handler of this.exitHandlers) handler();\n\t\tthis.exitHandlers.clear();\n\t\treturn exit;\n\t}\n\n\tprivate emitData(chunk: Buffer | Uint8Array | string): void {\n\t\tconst buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\t\tthis.appendRawTail(buffer);\n\t\tfor (const handler of this.dataHandlers) handler(buffer);\n\t}\n\n\tprivate appendRawTail(chunk: Buffer): void {\n\t\tthis.rawByteCount += chunk.byteLength;\n\t\tif (this.rawTailLimit === 0) {\n\t\t\tthis.rawTailBuffer = Buffer.alloc(0);\n\t\t\treturn;\n\t\t}\n\t\tconst next = Buffer.concat([this.rawTailBuffer, chunk]);\n\t\tthis.rawTailBuffer =\n\t\t\tnext.byteLength <= this.rawTailLimit ? next : next.subarray(next.byteLength - this.rawTailLimit);\n\t}\n}\n\nexport function createTerminalSession(\n\toptions: TerminalSessionOptions = {},\n\tdependencies: TerminalSessionDependencies = {},\n): TerminalSession {\n\treturn new TerminalSession(options, dependencies).start();\n}\n"]}