@cuna_labs/cli 0.1.0

package/dist/terminal/foreground.d.ts

@@ -0,0 +1,135 @@
+import type { RuntimeTerminalResponse, RuntimeTerminalSnapshot } from "../runtime/boundary.js";
+import type { TerminalFrame, TerminalLocalActionKind } from "./codec.js";
+import type { BrowserOpener } from "../auth/browser.js";
+import type { TerminalAttachmentAdmission } from "../runtime/terminal-transport.js";
+import type { HostTerminalLease } from "./mode.js";
+import { type AppbarModel, type StatusEvidence } from "./appbar.js";
+import { type WorkbenchTab } from "./workbench.js";
+export declare const HISTORICAL_INPUT_NOTICE = "Prior input uncertain \u00B7 not resent";
+export declare const MAX_FOREGROUND_PENDING_INPUT_BYTES = 1048576;
+export type ForegroundTerminalState = "idle" | "starting" | "active" | "stopping" | "stopped" | "failed";
+export interface ForegroundTerminalRuntime {
+    readonly activeTabId: string | undefined;
+    attach(input: {
+        readonly tabId: string;
+        readonly agentSessionId: string;
+        readonly columns: number;
+        readonly rows: number;
+        readonly expectedAdmission?: TerminalAttachmentAdmission;
+        readonly signal?: AbortSignal;
+    }): Promise<RuntimeTerminalSnapshot>;
+    detach(tabId: string): Promise<void>;
+    reconnect(input: {
+        readonly tabId: string;
+        readonly signal?: AbortSignal;
+    }): Promise<RuntimeTerminalSnapshot>;
+    takeWriter(input: {
+        readonly tabId: string;
+        readonly signal?: AbortSignal;
+    }): Promise<RuntimeTerminalSnapshot>;
+    sendInput(bytes: Uint8Array, tabId?: string, expectedBinding?: RuntimeTerminalResponse["binding"]): Promise<void>;
+    resize(columns: number, rows: number, tabId?: string): Promise<void>;
+    switchActive(tabId: string): RuntimeTerminalSnapshot;
+    sendTerminalResponse(response: RuntimeTerminalResponse): Promise<void>;
+    sendLocalActionControl(type: "local_action_result" | "local_stream_open" | "local_stream_data" | "local_stream_close" | "local_stream_window_update", payload: Readonly<Record<string, unknown>>, tabId?: string): Promise<void>;
+}
+export interface ForegroundTerminalHost {
+    dimensions(): {
+        readonly columns: number;
+        readonly rows: number;
+    };
+    acquire(mode?: "rich" | "plain"): Promise<HostTerminalLease>;
+    write(bytes: Uint8Array): Promise<void>;
+    onInput(listener: (bytes: Uint8Array) => void): () => void;
+    onResize(listener: () => void): () => void;
+}
+export interface ForegroundTabIntent {
+    readonly tabId: string;
+    readonly agentSessionId: string;
+    readonly label: string;
+    readonly agent: WorkbenchTab["agent"];
+    readonly workspaceBindingId?: string;
+    readonly workspaceGeneration?: number;
+    /** Only interactive provider login sessions may request a local browser. */
+    readonly localBrowserActions?: boolean;
+    /** Supervisor-owned lifecycle evidence. Terminal output must never populate this field. */
+    readonly agentSessionLifecycle?: StatusEvidence<string>;
+    /** Provider-auth evidence for this exact AgentSession process generation. */
+    readonly providerAuthentication?: StatusEvidence<string>;
+    /** Exact preflight authority retained through grant admission. */
+    readonly attachmentAdmission?: TerminalAttachmentAdmission;
+}
+/** One AgentSession the person detached from; it keeps running remotely. */
+export interface DetachedForegroundSession {
+    readonly agentSessionId: string;
+    readonly label: string;
+}
+export interface ForegroundTerminalCoordinatorOptions {
+    readonly host: ForegroundTerminalHost;
+    readonly browser?: BrowserOpener;
+    readonly copyText?: (text: string) => Promise<void>;
+    readonly appbar?: () => AppbarModel;
+    readonly color?: boolean;
+    readonly clock?: () => number;
+    readonly resizeCoalesceMs?: number;
+    readonly reconnectAttempts?: number;
+    readonly reconnectBaseDelayMs?: number;
+    readonly disconnectFrameMs?: number;
+    /** Stable only for this foreground process; never a reusable device credential. */
+    readonly deviceId?: string;
+}
+export declare class ForegroundTerminalCoordinator {
+    #private;
+    constructor(options: ForegroundTerminalCoordinatorOptions);
+    get state(): ForegroundTerminalState;
+    get failure(): unknown;
+    /**
+     * AgentSessions the person detached from on purpose (Ctrl+] d or Ctrl+C),
+     * each confirmed by the runtime. A detach never terminates the remote
+     * process, so the runner tells the person how to come back once the host
+     * terminal is theirs again. Tabs detached by cleanup are not listed.
+     */
+    get detachedSessions(): readonly DetachedForegroundSession[];
+    bindRuntime(runtime: ForegroundTerminalRuntime): void;
+    runtimeCallbacks(): {
+        readonly onTerminalViewStarted: (event: {
+            readonly snapshot: RuntimeTerminalSnapshot;
+            readonly columns: number;
+            readonly rows: number;
+            readonly signal: AbortSignal;
+        }) => Promise<void>;
+        readonly onTerminalReady: (snapshot: RuntimeTerminalSnapshot) => Promise<void>;
+        readonly onTerminalGeometry: (event: {
+            readonly snapshot: RuntimeTerminalSnapshot;
+            readonly signal: AbortSignal;
+        }) => Promise<void>;
+        readonly onTerminalOutput: (event: {
+            readonly provenance: "live" | "replay_or_unknown";
+            readonly tabId: string;
+            readonly agentSessionId: string;
+            readonly binding: RuntimeTerminalResponse["binding"];
+            readonly sequence: bigint;
+            readonly bytes: Uint8Array;
+            readonly signal: AbortSignal;
+        }) => Promise<void>;
+        readonly onTerminalState: (snapshot: RuntimeTerminalSnapshot) => void;
+        readonly localActionKinds: (agentSessionId: string) => readonly TerminalLocalActionKind[];
+        readonly onLocalActionFrame: (event: {
+            readonly tabId: string;
+            readonly frame: TerminalFrame;
+            readonly payload: Readonly<Record<string, unknown>>;
+        }) => Promise<void>;
+    };
+    start(intents: readonly ForegroundTabIntent[], signal?: AbortSignal): Promise<void>;
+    stop(): Promise<void>;
+    waitForStop(): Promise<void>;
+}
+export declare function admitForegroundSessionIds(sessionIds: readonly string[]): readonly string[];
+export declare function admitForegroundDimensions(input: {
+    readonly columns: number;
+    readonly rows: number;
+}): {
+    readonly columns: number;
+    readonly rows: number;
+};
+//# sourceMappingURL=foreground.d.ts.map

package/dist/terminal/foreground.d.ts.map

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