@cuna_labs/cli 0.1.0

package/dist/terminal/cell-width.d.ts

@@ -0,0 +1,3 @@
+export declare function terminalCellWidth(value: string): number;
+export declare function truncateTerminalLine(value: string, columns: number): string;
+//# sourceMappingURL=cell-width.d.ts.map

package/dist/terminal/cell-width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-width.d.ts","sourceRoot":"","sources":["../../src/terminal/cell-width.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3E"}

package/dist/terminal/cell-width.js

@@ -0,0 +1,53 @@
+const graphemeSegmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+const MARK = /^[\p{Mark}\p{Cf}]+$/u;
+const EMOJI = /\p{Extended_Pictographic}|\p{Emoji_Presentation}|\p{Regional_Indicator}|\u20e3/u;
+export function terminalCellWidth(value) {
+    let width = 0;
+    for (const { segment } of graphemeSegmenter.segment(value))
+        width += graphemeCellWidth(segment);
+    return width;
+}
+export function truncateTerminalLine(value, columns) {
+    if (!Number.isSafeInteger(columns) || columns < 1)
+        return "";
+    if (terminalCellWidth(value) <= columns)
+        return value;
+    if (columns === 1)
+        return "…";
+    let result = "";
+    let width = 0;
+    for (const { segment } of graphemeSegmenter.segment(value)) {
+        const segmentWidth = graphemeCellWidth(segment);
+        if (width + segmentWidth + 1 > columns)
+            break;
+        result += segment;
+        width += segmentWidth;
+    }
+    return `${result}…`;
+}
+function graphemeCellWidth(grapheme) {
+    if (grapheme.length === 0 || MARK.test(grapheme))
+        return 0;
+    if (EMOJI.test(grapheme))
+        return 2;
+    for (const symbol of grapheme) {
+        const codePoint = symbol.codePointAt(0);
+        if (codePoint !== undefined && isWideCodePoint(codePoint))
+            return 2;
+    }
+    return 1;
+}
+function isWideCodePoint(codePoint) {
+    return codePoint >= 0x1100 && (codePoint <= 0x115f ||
+        codePoint === 0x2329 ||
+        codePoint === 0x232a ||
+        (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+//# sourceMappingURL=cell-width.js.map

package/dist/terminal/cell-width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-width.js","sourceRoot":"","sources":["../../src/terminal/cell-width.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAChF,MAAM,IAAI,GAAG,sBAAsB,CAAC;AACpC,MAAM,KAAK,GAAG,iFAAiF,CAAC;AAEhG,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,OAAe;IACjE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,KAAK,GAAG,YAAY,GAAG,CAAC,GAAG,OAAO;YAAE,MAAM;QAC9C,MAAM,IAAI,OAAO,CAAC;QAClB,KAAK,IAAI,YAAY,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,MAAM,GAAG,CAAC;AACtB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,SAAS,KAAK,SAAS,IAAI,eAAe,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB;IACxC,OAAO,SAAS,IAAI,MAAM,IAAI,CAC5B,SAAS,IAAI,MAAM;QACnB,SAAS,KAAK,MAAM;QACpB,SAAS,KAAK,MAAM;QACpB,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,IAAI,SAAS,KAAK,MAAM,CAAC;QACpE,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC;QAC5C,CAAC,SAAS,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,CAAC,CAC/C,CAAC;AACJ,CAAC"}

package/dist/terminal/codec.d.ts

@@ -0,0 +1,107 @@
+import { TERMINAL_FRAME_TYPES } from "./generated/terminal-wire-v1.js";
+export declare const TERMINAL_PROTOCOL: "runa.terminal.v1";
+export declare const TERMINAL_PROTOCOL_VERSION: 1;
+export declare const MAX_TERMINAL_FRAME_BYTES: number;
+export declare const MAX_TERMINAL_BUFFER_BYTES: number;
+export declare const MAX_TERMINAL_QUEUED_FRAMES = 4096;
+export declare const LOCAL_ACTION_PROTOCOL: "cuna.local-actions.v1";
+export declare const MAX_LOCAL_ACTION_CONTROL_BYTES: number;
+export declare const MAX_LOCAL_STREAM_WINDOW_BYTES: number;
+export declare const TERMINAL_LOCAL_ACTION_KINDS: readonly ["browser.open", "auth.device.present", "auth.callback.relay", "auth.result.observe", "clipboard.write", "port.forward", "file.select", "attachment.import", "artifact.save", "preview.open", "diff.open", "editor.open", "notification.show", "git.sign", "local_service.request", "device.select"];
+export type TerminalLocalActionKind = typeof TERMINAL_LOCAL_ACTION_KINDS[number];
+export { TERMINAL_FRAME_TYPES } from "./generated/terminal-wire-v1.js";
+export type TerminalFrameType = keyof typeof TERMINAL_FRAME_TYPES;
+export type TerminalConnectionState = "negotiating" | "ready" | "attached" | "draining" | "interrupted" | "closed";
+export type TerminalFrameDirection = "client_to_server" | "server_to_client";
+export interface TerminalFrame {
+    readonly type: TerminalFrameType;
+    readonly critical: boolean;
+    readonly sequence: bigint;
+    readonly payload: Uint8Array;
+}
+export interface TerminalReadyPayload {
+    readonly terminalViewProtocol?: {
+        readonly name: "cuna.terminal-view.v1";
+        readonly operation: "new";
+        readonly history: "current_view";
+    };
+    readonly protocol: typeof TERMINAL_PROTOCOL;
+    readonly machineId?: string;
+    readonly machineGeneration?: string;
+    readonly workspaceBindingId?: string | null;
+    readonly workspaceBindingGeneration?: number | null;
+    readonly agentSessionId: string;
+    readonly processEpoch: string;
+    readonly fencingGeneration: number;
+    readonly resizeCapability: "live" | "initial_resize_only";
+    readonly accessMode: "writer" | "observer";
+    readonly writerEpoch: number;
+    readonly localActionProtocol?: TerminalLocalActionProtocolOffer;
+}
+export interface TerminalWriterEpochPayload {
+    readonly writerEpoch: number;
+    readonly writerClientInstanceId: string | null;
+    readonly accessMode: "writer" | "observer";
+}
+export interface TerminalGeometryPayload {
+    readonly columns: number;
+    readonly rows: number;
+    readonly writerEpoch: number;
+}
+export interface TerminalLocalActionProtocolOffer {
+    readonly name: typeof LOCAL_ACTION_PROTOCOL;
+    readonly maxRequestBytes: number;
+    readonly maxResultBytes: number;
+    readonly streamWindowBytes: number;
+    readonly kinds: readonly TerminalLocalActionKind[];
+}
+export interface TerminalLocalActionProtocolAcceptance {
+    readonly name: typeof LOCAL_ACTION_PROTOCOL;
+    readonly acceptedKinds: readonly TerminalLocalActionKind[];
+}
+export interface TerminalResumePayload {
+    readonly terminalViewProtocol?: {
+        readonly name: "cuna.terminal-view.v1";
+        readonly operation: "new";
+    };
+    readonly resumeHandle: string;
+    readonly afterOutputSequence: string;
+    readonly localActionProtocol?: TerminalLocalActionProtocolAcceptance;
+}
+export interface TerminalResizePayload {
+    readonly columns: number;
+    readonly rows: number;
+}
+export interface TerminalSignalPayload {
+    readonly signal: "interrupt" | "suspend" | "terminate";
+}
+export interface TerminalExitPayload {
+    readonly exitCode: number | null;
+    readonly reason: "exited" | "signaled" | "terminated" | "failed";
+}
+export interface TerminalErrorPayload {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly safeReason: string;
+}
+export interface TerminalAcknowledgementPayload {
+    readonly clientSequence: string;
+    readonly meaning: "durably_accepted_not_executed";
+}
+export type TerminalControlPayload = TerminalReadyPayload | TerminalResizePayload | TerminalSignalPayload | TerminalExitPayload | TerminalErrorPayload | TerminalAcknowledgementPayload;
+export declare class TerminalProtocolError extends Error {
+    readonly code: "invalid_magic" | "unsupported_version" | "oversize_frame" | "buffer_limit" | "queue_limit" | "unknown_critical_frame" | "malformed_frame" | "illegal_state" | "invalid_payload";
+    constructor(code: TerminalProtocolError["code"], message: string);
+}
+export declare function encodeTerminalFrame(frame: TerminalFrame): Uint8Array;
+export declare function encodeTerminalControl(type: Exclude<TerminalFrameType, "input" | "output">, sequence: bigint, payload: TerminalControlPayload | Readonly<Record<string, unknown>>): Uint8Array;
+export declare function decodeTerminalFrame(bytes: Uint8Array): TerminalFrame | undefined;
+export declare class TerminalFrameDecoder {
+    #private;
+    push(chunk: Uint8Array): readonly TerminalFrame[];
+}
+export declare function assertTerminalFrameLegal(state: TerminalConnectionState, direction: TerminalFrameDirection, type: TerminalFrameType, localActionsNegotiated?: boolean): void;
+export declare function decodeTerminalControl(frame: TerminalFrame): Readonly<Record<string, unknown>>;
+export declare function isLocalActionFrameType(type: TerminalFrameType): boolean;
+export declare function negotiateTerminalLocalActions(offer: unknown, implementedKinds: ReadonlySet<TerminalLocalActionKind>): TerminalLocalActionProtocolAcceptance | undefined;
+//# sourceMappingURL=codec.d.ts.map

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

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