@linxiraos/pi-utils 1.0.0 → 1.0.2

package/src/logger.ts

@@ -1,7 +1,7 @@
 /**
- * Centralized logger for omp.
+ * Centralized logger for zeta.
  *
- * Default: rotating `~/.omp/logs/omp.<DATE>.<PID>.log`, no console output (writing
+ * Default: rotating `~/.zeta/logs/zeta.<DATE>.<PID>.log`, no console output (writing
  * to stdout/stderr would corrupt the TUI). Long-running headless services
  * (the auth broker, etc.) call {@link setTransports} to swap in a console
  * transport so a process supervisor (pm2, journald, k8s) captures the logs.
@@ -53,9 +53,11 @@ function emitToSinks(level: LogLevel, message: string, context: Record<string, u
 	}
 }
 
-const PROCESS_LOG_PATTERN = /^omp\.\d{4}-\d{2}-\d{2}\.(\d+)\.log(?:\.\d+)?$/;
-const PROCESS_AUDIT_PATTERN = /^\.omp\.(\d+)-audit\.json$/;
-const RETAINED_STALE_LOG_FILES = 5;
+const PROCESS_LOG_PATTERN = /^zeta\.(\d{4}-\d{2}-\d{2})\.(\d+)\.log(?:\.(\d+))?$/;
+const PROCESS_AUDIT_PATTERN = /^\.zeta\.(\d+)-audit\.json$/;
+const RETAINED_STALE_LOGS_PER_PROCESS_DAY = 1;
+const RETAINED_STALE_AUDIT_FILES = 0;
+const RETAINED_STALE_LOG_DAYS = 5;
 
 function processIsRunning(pid: number): boolean {
 	try {
@@ -67,8 +69,10 @@ function processIsRunning(pid: number): boolean {
 }
 
 /**
- * Retain the newest completed-process logs globally and remove their one-use
- * audit files. Live PID namespaces are never touched.
+ * Retain one newest completed-process log per process/day within the current
+ * and previous four local calendar days, and remove one-use audit files. Live
+ * PID namespaces are never touched. The calendar-day boundary preserves daily
+ * diagnostic coverage while bounding completed-process storage and scans.
  */
 function pruneStaleProcessLogs(dir: string): void {
 	let entries: fs.Dirent[];
@@ -77,38 +81,69 @@ function pruneStaleProcessLogs(dir: string): void {
 	} catch {
 		return;
 	}
-
-	const staleLogs: Array<{ path: string; mtimeMs: number }> = [];
+	const current = new Date();
+	const currentDate =
+		`${current.getFullYear()}-${String(current.getMonth() + 1).padStart(2, "0")}-` +
+		String(current.getDate()).padStart(2, "0");
+	const cutoff = new Date(current);
+	cutoff.setDate(cutoff.getDate() - (RETAINED_STALE_LOG_DAYS - 1));
+	const cutoffDate =
+		`${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-` +
+		String(cutoff.getDate()).padStart(2, "0");
+
+	const staleLogsByProcessDay = new Map<string, Array<{ path: string; mtimeMs: number; rollover: number }>>();
 	for (const entry of entries) {
 		if (!entry.isFile()) continue;
 		const logMatch = PROCESS_LOG_PATTERN.exec(entry.name);
 		const auditMatch = PROCESS_AUDIT_PATTERN.exec(entry.name);
-		const pidText = logMatch?.[1] ?? auditMatch?.[1];
+		const pidText = logMatch?.[2] ?? auditMatch?.[1];
 		if (!pidText || processIsRunning(Number(pidText))) continue;
 		const entryPath = path.join(dir, entry.name);
 
 		if (auditMatch) {
+			if (RETAINED_STALE_AUDIT_FILES === 0) {
+				try {
+					fs.rmSync(entryPath, { force: true });
+				} catch {
+					// Retention is best-effort; logging must still initialize.
+				}
+			}
+			continue;
+		}
+		if (!logMatch?.[1]) continue;
+		if (logMatch[1] < cutoffDate || logMatch[1] > currentDate) {
 			try {
 				fs.rmSync(entryPath, { force: true });
 			} catch {
-				// Retention is best-effort; logging must still initialize.
+				// Another process may have pruned the same stale namespace.
 			}
 			continue;
 		}
 
 		try {
-			staleLogs.push({ path: entryPath, mtimeMs: fs.statSync(entryPath).mtimeMs });
+			const key = `${pidText}:${logMatch[1]}`;
+			const staleLogs = staleLogsByProcessDay.get(key) ?? [];
+			staleLogs.push({
+				path: entryPath,
+				mtimeMs: fs.statSync(entryPath).mtimeMs,
+				rollover: Number(logMatch[3] ?? 0),
+			});
+			staleLogsByProcessDay.set(key, staleLogs);
 		} catch {
 			// Another process may have pruned the same stale namespace.
 		}
 	}
 
-	staleLogs.sort((a, b) => b.mtimeMs - a.mtimeMs);
-	for (const stale of staleLogs.slice(RETAINED_STALE_LOG_FILES)) {
-		try {
-			fs.rmSync(stale.path, { force: true });
-		} catch {
-			// Another process may have pruned the same stale namespace.
+	for (const staleLogs of staleLogsByProcessDay.values()) {
+		staleLogs.sort(
+			(a, b) => b.mtimeMs - a.mtimeMs || b.rollover - a.rollover || (a.path < b.path ? -1 : a.path > b.path ? 1 : 0),
+		);
+		for (const stale of staleLogs.slice(RETAINED_STALE_LOGS_PER_PROCESS_DAY)) {
+			try {
+				fs.rmSync(stale.path, { force: true });
+			} catch {
+				// Another process may have pruned the same stale namespace.
+			}
 		}
 	}
 }
@@ -201,11 +236,11 @@ function makeFileTransport(dir?: string): RotatingFileSink {
 	pruneStaleProcessLogs(logsDir);
 	return new RotatingFileSink({
 		directory: logsDir,
-		filenamePrefix: "omp",
+		filenamePrefix: "zeta",
 		filenameSuffix: String(process.pid),
 		maxBytes: 10 * 1024 * 1024,
 		maxFiles: 5,
-		auditFile: path.join(logsDir, `.omp.${process.pid}-audit.json`),
+		auditFile: path.join(logsDir, `.zeta.${process.pid}-audit.json`),
 	});
 }
 

package/src/ptree.ts

@@ -217,11 +217,11 @@ export class ChildProcess<In extends InMask = InMask> {
 		return this;
 	}
 
-	kill(reason?: Exception) {
+	kill(reason?: Exception, gracefulMs?: number) {
 		if (reason && !this.#exitReasonPending) this.#exitReasonPending = reason;
 		if (!this.proc.killed)
 			void Process.fromPid(this.proc.pid)
-				?.terminate()
+				?.terminate(gracefulMs === undefined ? undefined : { gracefulMs })
 				?.catch(e => void e);
 	}
 

package/src/stderr-guard.ts

@@ -104,7 +104,7 @@ export function suppressTerminalStderr(options?: SuppressTerminalStderrOptions):
 	try {
 		const redirectPath = options?.redirectPath ?? getLogPath();
 		// getLogsDir() only computes the path; the logger creates it lazily, so
-		// on a fresh profile ~/.omp/logs may not exist yet. Create it here so
+		// on a fresh profile ~/.zeta/logs may not exist yet. Create it here so
 		// diagnostics land in the log instead of falling through to /dev/null.
 		fs.mkdirSync(path.dirname(redirectPath), { recursive: true });
 		redirectFd = fs.openSync(redirectPath, "a");

package/src/stream.ts

@@ -281,11 +281,16 @@ export async function* readSseJson<T>(
  * - `raw` is the list of decoded non-empty lines that made up the event,
  *   preserved for diagnostic context (error reporting, debugging). The
  *   dispatching blank line is not included.
+ * - `id` and `retry` are present only when the event carried valid fields with
+ *   those names. Control-only events are yielded so reconnecting transports can
+ *   retain the cursor and server-requested retry interval.
  */
 export interface ServerSentEvent {
 	event: string | null;
 	data: string;
 	raw: string[];
+	id?: string;
+	retry?: number;
 }
 
 interface SseEventState {
@@ -296,6 +301,8 @@ interface SseEventState {
 	// seen yet" (distinct from a `data:` field with an empty value).
 	data: string | null;
 	raw: string[];
+	id?: string;
+	retry?: number;
 }
 
 // Complete lines are decoded in one batch per source chunk. Each batch ends on
@@ -303,7 +310,7 @@ interface SseEventState {
 const SSE_DECODER = new TextDecoder("utf-8");
 
 function flushSseEvent(state: SseEventState): ServerSentEvent | null {
-	if (state.event === null && state.data === null) {
+	if (state.event === null && state.data === null && state.id === undefined && state.retry === undefined) {
 		state.raw = [];
 		return null;
 	}
@@ -312,9 +319,13 @@ function flushSseEvent(state: SseEventState): ServerSentEvent | null {
 		data: state.data ?? "",
 		raw: state.raw,
 	};
+	if (state.id !== undefined) event.id = state.id;
+	if (state.retry !== undefined) event.retry = state.retry;
 	state.event = null;
 	state.data = null;
 	state.raw = [];
+	state.id = undefined;
+	state.retry = undefined;
 	return event;
 }
 
@@ -348,9 +359,22 @@ function pushSseLine(line: string, state: SseEventState): ServerSentEvent | null
 			state.data += "\n";
 			state.data += value;
 		}
+	} else if (fieldName === "id") {
+		if (!value.includes("\0")) state.id = value;
+	} else if (fieldName === "retry" && value.length > 0) {
+		let valid = true;
+		for (let index = 0; index < value.length; index++) {
+			const code = value.charCodeAt(index);
+			if (code < 0x30 || code > 0x39) {
+				valid = false;
+				break;
+			}
+		}
+		if (valid) {
+			const retry = Number(value);
+			if (Number.isSafeInteger(retry)) state.retry = retry;
+		}
 	}
-	// `id` and `retry` are intentionally ignored — the providers we consume
-	// don't use them, and the underlying transport handles reconnects itself.
 	return null;
 }
 

package/src/vendor/mermaid-ascii/ascii/canvas.ts

@@ -8,7 +8,7 @@
 
 import type { Canvas, DrawingCoord, RoleCanvas, CharRole, AsciiTheme, ColorMode } from './types'
 import { colorizeLine, DEFAULT_ASCII_THEME } from './ansi'
-import { displayWidth, toCells, WIDE_PAD } from '../text-metrics'
+import { displayWidth, LABEL_SPACE, toCells, WIDE_PAD } from '../text-metrics'
 
 /**
  * Create a blank canvas filled with spaces.
@@ -189,7 +189,7 @@ export function isJunctionChar(c: string): boolean {
  * letter/digit test misses.
  */
 function isLabelChar(c: string): boolean {
-  return c === WIDE_PAD || displayWidth(c) === 2 || /[\p{L}\p{N}]/u.test(c)
+  return c === LABEL_SPACE || c === WIDE_PAD || displayWidth(c) === 2 || /[\p{L}\p{N}]/u.test(c)
 }
 
 /**
@@ -268,7 +268,7 @@ export function mergeCanvases(
     for (let x = 0; x < overlay.length; x++) {
       for (let y = 0; y < overlay[0]!.length; y++) {
         const c = overlay[x]![y]!
-        // WIDE_PAD cells are written atomically with their lead below
+        // Spaces are transparent; WIDE_PAD cells are written atomically with their lead below
         if (c === ' ' || c === WIDE_PAD) continue
         const mx = x + offset.x
         const my = y + offset.y
@@ -327,8 +327,8 @@ export function canvasToString(canvas: Canvas, options?: CanvasToStringOptions):
       let line = ''
       for (let x = 0; x <= maxX; x++) {
         const c = canvas[x]![y]!
-        // Skip wide-glyph continuation cells: the glyph itself spans 2 columns
-        if (c !== WIDE_PAD) line += c
+        // Skip wide-glyph continuation cells and restore opaque label spaces.
+        if (c !== WIDE_PAD) line += c === LABEL_SPACE ? ' ' : c
       }
       lines.push(line)
     } else {
@@ -338,7 +338,7 @@ export function canvasToString(canvas: Canvas, options?: CanvasToStringOptions):
       for (let x = 0; x <= maxX; x++) {
         const c = canvas[x]![y]!
         if (c === WIDE_PAD) continue
-        chars.push(c)
+        chars.push(c === LABEL_SPACE ? ' ' : c)
         roles.push(roleCanvas[x]?.[y] ?? null)
       }
       lines.push(colorizeLine(chars, roles, theme, colorMode))
@@ -370,6 +370,8 @@ const VERTICAL_FLIP_MAP: Record<string, string> = {
   // Unicode corners
   '┌': '└', '└': '┌',
   '┐': '┘', '┘': '┐',
+  '╭': '╰', '╰': '╭',
+  '╮': '╯', '╯': '╮',
   // Unicode junctions (T-pieces flip vertically)
   '┬': '┴', '┴': '┬',
   // Box-start junctions (exit points from node boxes)

package/src/vendor/mermaid-ascii/ascii/draw.ts

@@ -21,7 +21,7 @@ import { gridToDrawingCoord, lineToDrawing } from './grid'
 import { splitLines } from './multiline-utils'
 import { getCorners } from './shapes/corners'
 import { getShapeAttachmentPoint } from './shapes/index'
-import { displayWidth, toCells, WIDE_PAD } from '../text-metrics'
+import { displayWidth, LABEL_SPACE, toCells, WIDE_PAD } from '../text-metrics'
 
 // ============================================================================
 // Node drawing — renders a node using shape-aware rendering
@@ -76,16 +76,18 @@ function drawBoxWithGridDimensions(node: AsciiNode, graph: AsciiGraph): Canvas {
   // Get corner characters for this shape type
   const corners = getCorners(node.shape, useAscii)
 
-  // State-end uses double border to differentiate from state-start
-  const isDoubleBox = node.shape === 'state-end'
-  const hChar = useAscii ? (isDoubleBox ? '=' : '-') : (isDoubleBox ? '═' : '─')
-  const vChar = useAscii ? (isDoubleBox ? '‖' : '|') : (isDoubleBox ? '║' : '│')
+  const isStateStart = node.shape === 'state-start'
+  const isStateEnd = node.shape === 'state-end'
+  const hChar = useAscii ? (isStateEnd ? '=' : '-') : (isStateEnd ? '═' : '─')
+  const vChar = useAscii ? (isStateEnd ? '‖' : '|') : (isStateEnd ? '║' : '│')
 
-  // Double-box corners (for state-end)
-  const doubleCorners = useAscii
+  const stateStartCorners = useAscii
+    ? { tl: '+', tr: '+', bl: '+', br: '+' }
+    : { tl: '╭', tr: '╮', bl: '╰', br: '╯' }
+  const stateEndCorners = useAscii
     ? { tl: '#', tr: '#', bl: '#', br: '#' }
     : { tl: '╔', tr: '╗', bl: '╚', br: '╝' }
-  const effectiveCorners = isDoubleBox ? doubleCorners : corners
+  const effectiveCorners = isStateEnd ? stateEndCorners : isStateStart ? stateStartCorners : corners
 
   // Draw box border with shape-specific corners
   for (let x = from.x + 1; x < to.x; x++) box[x]![from.y] = hChar
@@ -97,8 +99,8 @@ function drawBoxWithGridDimensions(node: AsciiNode, graph: AsciiGraph): Canvas {
   box[from.x]![to.y] = effectiveCorners.bl
   box[to.x]![to.y] = effectiveCorners.br
 
-  // Center the multi-line display label inside the box
-  const label = node.displayLabel
+  // Pseudostates have no source label; restore their UML marker explicitly.
+  const label = node.displayLabel || (isStateStart ? (useAscii ? '*' : '●') : isStateEnd ? (useAscii ? '*' : '◎') : '')
   const lines = splitLines(label)
   const textCenterY = from.y + Math.floor(h / 2)
   const startY = textCenterY - Math.floor((lines.length - 1) / 2)
@@ -677,7 +679,7 @@ function drawTextOnLine(canvas: Canvas, line: DrawingCoord[], label: string, isU
   for (let i = 0; i < lines.length; i++) {
     const lineText = lines[i]!
     const startX = middleX - Math.floor(displayWidth(lineText) / 2)
-    drawText(canvas, { x: startX, y: startY + i }, lineText)
+    drawText(canvas, { x: startX, y: startY + i }, lineText.replaceAll(' ', LABEL_SPACE))
   }
 }
 
@@ -1223,7 +1225,8 @@ function fillRolesFromCanvases(
 
 /**
  * Special handling for node boxes: border chars get 'border' role, text gets 'text' role.
- * Detects text by checking if character is alphanumeric or common punctuation.
+ * Common final-state border characters (`#` and `=`) count only on the outer edge,
+ * so identical characters inside ordinary node labels retain the text role.
  */
 function fillRolesForNodeBox(
   roleCanvas: RoleCanvas,
@@ -1231,7 +1234,9 @@ function fillRolesForNodeBox(
   offset: DrawingCoord,
 ): void {
   const isBorderChar = (c: string) => /^[┌┐└┘├┤┬┴┼│─╭╮╰╯+\-|.':]$/.test(c)
-
+  const isStateEndBorderChar = (c: string) => /^[╔╗╚╝═║#=‖]$/.test(c)
+  const maxX = canvas.length - 1
+  const maxY = (canvas[0]?.length ?? 1) - 1
   for (let x = 0; x < canvas.length; x++) {
     for (let y = 0; y < (canvas[0]?.length ?? 0); y++) {
       const char = canvas[x]?.[y]
@@ -1240,7 +1245,9 @@ function fillRolesForNodeBox(
         const ry = y + offset.y
         // Use setRole which auto-expands the role canvas if needed
         if (rx >= 0 && ry >= 0) {
-          setRole(roleCanvas, rx, ry, isBorderChar(char) ? 'border' : 'text')
+          const isOuterEdge = x === 0 || x === maxX || y === 0 || y === maxY
+          const role = isBorderChar(char) || (isOuterEdge && isStateEndBorderChar(char)) ? 'border' : 'text'
+          setRole(roleCanvas, rx, ry, role)
         }
       }
     }

package/src/vendor/mermaid-ascii/text-metrics.ts

@@ -29,6 +29,9 @@
  */
 export const WIDE_PAD = '\u0000'
 
+/** Opaque label-space placeholder that serializes back to a regular space. */
+export const LABEL_SPACE = '\u0001'
+
 const graphemeSegmenter = new Intl.Segmenter()
 
 /**

package/dist/types/abortable.d.ts

@@ -1,32 +0,0 @@
-export declare class AbortError extends Error {
-    constructor(signal: AbortSignal);
-}
-/**
- * Abortable async iteration over a {@link ReadableStream}. Reads the source
- * reader directly and yields each chunk, so the consumer's `for await` drives a
- * single read loop with no intermediate stream or per-chunk enqueue.
- *
- * Unlike `stream.pipeThrough(..., { signal })`, this explicitly cancels the
- * source reader on abort or early `break`, propagating HTTP-client disconnects
- * and watchdog timeouts to the backend request instead of only stopping the
- * local consumer. On abort it throws {@link AbortError}; the lock is released
- * on completion, abort, throw, or early exit. The source is cancelled only on
- * abort or early exit — never on natural EOF.
- */
-export declare function abortableSource<T>(stream: ReadableStream<T>, signal?: AbortSignal): AsyncGenerator<T>;
-/**
- * Runs a promise-returning function (`pr`). If the given AbortSignal is aborted before or during
- * execution, the promise is rejected with a standard error.
- *
- * @param signal - Optional AbortSignal to cancel the operation
- * @param pr - Function returning a promise to run
- * @returns Promise resolving as `pr` would, or rejecting on abort
- */
-export declare function untilAborted<T>(signal: AbortSignal | undefined | null, pr: Promise<T> | (() => Promise<T>)): Promise<T>;
-/**
- * Memoizes a function with no arguments, calling it once and caching the result.
- *
- * @param fn - Function to be called once
- * @returns A function that returns the cached result of `fn`
- */
-export declare function once<T>(fn: () => T): () => T;

package/dist/types/acp/connection.d.ts

@@ -1,118 +0,0 @@
-import type { Agent, AuthenticateRequest, AuthenticateResponse, CloseSessionRequest, CloseSessionResponse, CompleteElicitationNotification, CreateElicitationRequest, CreateElicitationResponse, CreateTerminalRequest, ForkSessionRequest, ForkSessionResponse, InitializeRequest, InitializeResponse, ListSessionsRequest, ListSessionsResponse, LoadSessionRequest, LoadSessionResponse, MaybePromise, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, ReadTextFileRequest, ReadTextFileResponse, RequestPermissionRequest, RequestPermissionResponse, ResumeSessionRequest, ResumeSessionResponse, SessionNotification, SetSessionConfigOptionRequest, SetSessionConfigOptionResponse, SetSessionModeRequest, SetSessionModeResponse, TerminalActionResponse, TerminalOutputResponse, WaitForTerminalExitResponse, WriteTextFileRequest, WriteTextFileResponse } from "./protocol.js";
-import type { Stream } from "./stream.js";
-import { RpcConnection } from "./transport.js";
-/** Terminal creation response returned by a client. */
-export interface CreateTerminalResponse {
-    terminalId: string;
-}
-/** Client callbacks handled by a client-side connection. */
-export interface Client {
-    requestPermission(params: RequestPermissionRequest): MaybePromise<RequestPermissionResponse>;
-    sessionUpdate(params: SessionNotification): MaybePromise<void>;
-    readTextFile?(params: ReadTextFileRequest): MaybePromise<ReadTextFileResponse>;
-    writeTextFile?(params: WriteTextFileRequest): MaybePromise<WriteTextFileResponse | void>;
-    createTerminal?(params: CreateTerminalRequest): MaybePromise<CreateTerminalResponse>;
-    terminalOutput?(params: {
-        sessionId: string;
-        terminalId: string;
-    }): MaybePromise<TerminalOutputResponse>;
-    waitForTerminalExit?(params: {
-        sessionId: string;
-        terminalId: string;
-    }): MaybePromise<WaitForTerminalExitResponse>;
-    killTerminal?(params: {
-        sessionId: string;
-        terminalId: string;
-    }): MaybePromise<TerminalActionResponse | void>;
-    releaseTerminal?(params: {
-        sessionId: string;
-        terminalId: string;
-    }): MaybePromise<TerminalActionResponse | void>;
-    unstable_createElicitation?(params: CreateElicitationRequest): MaybePromise<CreateElicitationResponse>;
-    unstable_completeElicitation?(params: CompleteElicitationNotification): MaybePromise<void>;
-    extMethod?(method: string, params: Record<string, unknown>): MaybePromise<Record<string, unknown>>;
-    extNotification?(method: string, params: Record<string, unknown>): MaybePromise<void>;
-}
-/** Agent-side ACP connection. */
-export declare class AgentSideConnection {
-    #private;
-    constructor(toAgent: (connection: AgentSideConnection) => Agent, stream: Stream);
-    /** Signal aborted when the transport closes. */
-    get signal(): AbortSignal;
-    /** Promise resolved when the transport closes. */
-    get closed(): Promise<void>;
-    /** Sends a session update notification. */
-    sessionUpdate(params: SessionNotification): Promise<void>;
-    /** Requests permission from the client. */
-    requestPermission(params: RequestPermissionRequest): Promise<RequestPermissionResponse>;
-    /** Reads a client-side text file. */
-    readTextFile(params: ReadTextFileRequest): Promise<ReadTextFileResponse>;
-    /** Writes a client-side text file. */
-    writeTextFile(params: WriteTextFileRequest): Promise<WriteTextFileResponse>;
-    /** Creates a client terminal and returns its control handle. */
-    createTerminal(params: CreateTerminalRequest): Promise<TerminalHandle>;
-    /** Creates an interactive elicitation on the client. */
-    unstable_createElicitation(params: CreateElicitationRequest): Promise<CreateElicitationResponse>;
-    /** Notifies a client that URL elicitation completed. */
-    unstable_completeElicitation(params: CompleteElicitationNotification): Promise<void>;
-    /** Sends a custom request. */
-    request<Response = unknown, Params = unknown>(method: string, params?: Params): Promise<Response>;
-    /** Sends a custom notification. */
-    notify<Params = unknown>(method: string, params?: Params): Promise<void>;
-    /** Sends a legacy extension request. */
-    extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Sends a legacy extension notification. */
-    extNotification(method: string, params: Record<string, unknown>): Promise<void>;
-}
-/** Handle for controlling a client-owned terminal. */
-export declare class TerminalHandle {
-    #private;
-    /** Client terminal identifier. */
-    readonly id: string;
-    constructor(id: string, sessionId: string, connection: RpcConnection);
-    /** Gets current terminal output. */
-    currentOutput(): Promise<TerminalOutputResponse>;
-    /** Waits for terminal exit. */
-    waitForExit(): Promise<WaitForTerminalExitResponse>;
-    /** Kills the terminal. */
-    kill(): Promise<TerminalActionResponse>;
-    /** Releases the terminal. */
-    release(): Promise<TerminalActionResponse | void>;
-    /** Releases the terminal during async disposal. */
-    [Symbol.asyncDispose](): Promise<void>;
-}
-/** Client-side ACP connection used to call an agent. */
-export declare class ClientSideConnection {
-    #private;
-    constructor(toClient: (connection: ClientSideConnection) => Client, stream: Stream);
-    /** Signal aborted when the transport closes. */
-    get signal(): AbortSignal;
-    /** Promise resolved when the transport closes. */
-    get closed(): Promise<void>;
-    /** Initializes protocol capabilities. */
-    initialize(params: InitializeRequest): Promise<InitializeResponse>;
-    /** Authenticates with an agent. */
-    authenticate(params: AuthenticateRequest): Promise<AuthenticateResponse>;
-    /** Creates a session. */
-    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
-    /** Loads a session. */
-    loadSession(params: LoadSessionRequest): Promise<LoadSessionResponse>;
-    /** Lists sessions. */
-    listSessions(params: ListSessionsRequest): Promise<ListSessionsResponse>;
-    /** Resumes a session. */
-    resumeSession(params: ResumeSessionRequest): Promise<ResumeSessionResponse>;
-    /** Forks a session. */
-    unstable_forkSession(params: ForkSessionRequest): Promise<ForkSessionResponse>;
-    /** Closes a session. */
-    closeSession(params: CloseSessionRequest): Promise<CloseSessionResponse>;
-    /** Sets a session mode. */
-    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
-    /** Sets a session config option. */
-    setSessionConfigOption(params: SetSessionConfigOptionRequest): Promise<SetSessionConfigOptionResponse>;
-    /** Sends a prompt. */
-    prompt(params: PromptRequest): Promise<PromptResponse>;
-    /** Cancels an active prompt. */
-    cancel(params: {
-        sessionId: string;
-    }): Promise<void>;
-}