@cuna_labs/cli 0.1.0

package/dist/terminal/viewport.js

@@ -0,0 +1,266 @@
+export const MAX_VIEWPORT_CELLS = 250_000;
+export const MAX_VIEWPORT_TABS = 32;
+export function assertViewportRebind(current, next) {
+    validateBinding(next);
+    if (current.userId !== next.userId || current.machineId !== next.machineId ||
+        current.agentSessionId !== next.agentSessionId || current.processEpoch !== next.processEpoch ||
+        next.fencingGeneration <= current.fencingGeneration) {
+        throw new ViewportIsolationError("binding_mismatch", "A viewport rebind requires the same process and a higher attachment fence.");
+    }
+}
+export class ViewportIsolationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ViewportIsolationError";
+        this.code = code;
+    }
+}
+export class ViewportRegistry {
+    #tabs = new Map();
+    #activeTabId;
+    open(tabId, binding, columns, rows) {
+        if (this.#tabs.size >= MAX_VIEWPORT_TABS)
+            throw new ViewportIsolationError("tab_limit", "The viewport tab limit was reached.");
+        if (this.#tabs.has(tabId))
+            throw new ViewportIsolationError("duplicate_tab", "The viewport tab already exists.");
+        validateDimensions(columns, rows);
+        validateBinding(binding);
+        const snapshot = freezeSnapshot({
+            tabId,
+            binding,
+            columns,
+            rows,
+            outputSequence: 0n,
+            replayCursor: 0n,
+            cells: Object.freeze(Array.from({ length: rows }, () => "")),
+            displayWidths: Object.freeze(Array.from({ length: rows }, () => 0)),
+            cursorX: 0,
+            cursorY: 0,
+            modes: Object.freeze({ bracketedPaste: false, mouse: false, alternateScreen: false, cursorVisible: true }),
+        });
+        this.#tabs.set(tabId, snapshot);
+        this.#activeTabId ??= tabId;
+        return snapshot;
+    }
+    select(tabId) {
+        const tab = this.require(tabId);
+        this.#activeTabId = tabId;
+        return tab;
+    }
+    rebind(tabId, binding) {
+        const current = this.require(tabId);
+        assertViewportRebind(current.binding, binding);
+        const next = freezeSnapshot({ ...current, binding });
+        this.#tabs.set(tabId, next);
+        return next;
+    }
+    resetForCurrentView(tabId, binding, columns, rows) {
+        const current = this.require(tabId);
+        assertViewportRebind(current.binding, binding);
+        validateDimensions(columns, rows);
+        const next = freezeSnapshot({
+            tabId, binding, columns, rows, outputSequence: 0n, replayCursor: 0n,
+            cells: Array.from({ length: rows }, () => ""),
+            displayWidths: Array.from({ length: rows }, () => 0), cursorX: 0, cursorY: 0,
+            modes: { bracketedPaste: false, mouse: false, alternateScreen: false, cursorVisible: true },
+        });
+        this.#tabs.set(tabId, next);
+        return next;
+    }
+    close(tabId) {
+        this.require(tabId);
+        this.#tabs.delete(tabId);
+        if (this.#activeTabId === tabId)
+            this.#activeTabId = this.#tabs.keys().next().value;
+    }
+    applyRenderedFrame(input) {
+        const current = this.require(input.tabId);
+        if (!sameBinding(current.binding, input.binding)) {
+            throw new ViewportIsolationError("binding_mismatch", "Rendered cells target another AgentSession or PTY generation.");
+        }
+        if (input.outputSequence <= current.outputSequence || input.replayCursor < current.replayCursor) {
+            throw new ViewportIsolationError("frame_regression", "Viewport sequence state cannot move backward.");
+        }
+        const displayWidths = input.displayWidths ?? input.cells.map((row) => [...row].length);
+        const cursorX = input.cursorX ?? current.cursorX;
+        const cursorY = input.cursorY ?? current.cursorY;
+        if (input.cells.length > current.rows ||
+            displayWidths.length !== input.cells.length ||
+            input.cells.some((row) => containsHostControl(row)) ||
+            displayWidths.some((width) => !Number.isSafeInteger(width) || width < 0 || width > current.columns) ||
+            !Number.isSafeInteger(cursorX) || cursorX < 0 || cursorX > current.columns ||
+            !Number.isSafeInteger(cursorY) || cursorY < 0 || cursorY >= current.rows) {
+            throw new ViewportIsolationError("viewport_limit", "Rendered cells exceed their isolated viewport bounds.");
+        }
+        if (input.renderRows !== undefined)
+            validateRenderRows(input.renderRows, input.cells, displayWidths, current.columns);
+        const next = freezeSnapshot({
+            ...current,
+            outputSequence: input.outputSequence,
+            replayCursor: input.replayCursor,
+            cells: Object.freeze([...input.cells]),
+            ...(input.renderRows === undefined ? {} : { renderRows: freezeRenderRows(input.renderRows) }),
+            displayWidths: Object.freeze([...displayWidths]),
+            cursorX,
+            cursorY,
+            modes: Object.freeze({ ...input.modes }),
+        });
+        this.#tabs.set(input.tabId, next);
+        return next;
+    }
+    resize(tabId, columns, rows) {
+        validateDimensions(columns, rows);
+        const current = this.require(tabId);
+        const cells = current.cells.slice(0, rows).map((row) => [...row].slice(0, columns).join(""));
+        const displayWidths = current.displayWidths.slice(0, rows).map((width) => Math.min(width, columns));
+        // Styled runs are terminal-column based. Drop them until the owning VTE
+        // supplies its authoritative local reflow for the new dimensions.
+        const { renderRows: _renderRows, ...withoutRenderRows } = current;
+        const next = freezeSnapshot({
+            ...withoutRenderRows,
+            columns,
+            rows,
+            cells: Object.freeze(cells),
+            displayWidths: Object.freeze(displayWidths),
+            cursorX: Math.min(current.cursorX, columns),
+            cursorY: Math.min(current.cursorY, rows - 1),
+        });
+        this.#tabs.set(tabId, next);
+        return next;
+    }
+    applyLocalReflow(input) {
+        const current = this.require(input.tabId);
+        if (!sameBinding(current.binding, input.binding)) {
+            throw new ViewportIsolationError("binding_mismatch", "Local reflow targets another terminal generation.");
+        }
+        if (input.outputSequence !== current.outputSequence || input.replayCursor !== current.replayCursor) {
+            throw new ViewportIsolationError("frame_regression", "Local reflow cannot invent or change remote sequence truth.");
+        }
+        return this.#replaceCells(current, input);
+    }
+    active() {
+        return this.#activeTabId === undefined ? undefined : this.require(this.#activeTabId);
+    }
+    require(tabId) {
+        const tab = this.#tabs.get(tabId);
+        if (tab === undefined)
+            throw new ViewportIsolationError("unknown_tab", "The viewport tab does not exist.");
+        return tab;
+    }
+    list() {
+        return Object.freeze([...this.#tabs.values()]);
+    }
+    #replaceCells(current, input) {
+        if (input.cells.length > current.rows ||
+            input.displayWidths.length !== input.cells.length ||
+            input.cells.some((row) => containsHostControl(row)) ||
+            input.displayWidths.some((width) => !Number.isSafeInteger(width) || width < 0 || width > current.columns) ||
+            !Number.isSafeInteger(input.cursorX) || input.cursorX < 0 || input.cursorX > current.columns ||
+            !Number.isSafeInteger(input.cursorY) || input.cursorY < 0 || input.cursorY >= current.rows) {
+            throw new ViewportIsolationError("viewport_limit", "Rendered cells exceed their isolated viewport bounds.");
+        }
+        if (input.renderRows !== undefined)
+            validateRenderRows(input.renderRows, input.cells, input.displayWidths, current.columns);
+        const next = freezeSnapshot({
+            ...current,
+            cells: Object.freeze([...input.cells]),
+            ...(input.renderRows === undefined ? {} : { renderRows: freezeRenderRows(input.renderRows) }),
+            displayWidths: Object.freeze([...input.displayWidths]),
+            cursorX: input.cursorX,
+            cursorY: input.cursorY,
+            modes: Object.freeze({ ...input.modes }),
+        });
+        this.#tabs.set(current.tabId, next);
+        return next;
+    }
+}
+function containsHostControl(value) {
+    // A VTE adapter must resolve control sequences to cells. Passing ESC, C1, or
+    // host control characters here would reintroduce the appbar escape path.
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint !== undefined && (codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f)))
+            return true;
+    }
+    return false;
+}
+function validateDimensions(columns, rows) {
+    if (!Number.isSafeInteger(columns) ||
+        !Number.isSafeInteger(rows) ||
+        columns < 1 ||
+        rows < 1 ||
+        columns * rows > MAX_VIEWPORT_CELLS) {
+        throw new ViewportIsolationError("viewport_limit", "The viewport dimensions exceed the cell budget.");
+    }
+}
+function validateBinding(binding) {
+    for (const value of [binding.userId, binding.machineId, binding.agentSessionId, binding.processEpoch]) {
+        if (value.length === 0 || value.length > 256)
+            throw new ViewportIsolationError("binding_mismatch", "The viewport binding is invalid.");
+    }
+    if (!Number.isSafeInteger(binding.fencingGeneration) || binding.fencingGeneration < 1) {
+        throw new ViewportIsolationError("binding_mismatch", "The viewport fence is invalid.");
+    }
+}
+function sameBinding(left, right) {
+    return (left.userId === right.userId &&
+        left.machineId === right.machineId &&
+        left.agentSessionId === right.agentSessionId &&
+        left.processEpoch === right.processEpoch &&
+        left.fencingGeneration === right.fencingGeneration);
+}
+function freezeSnapshot(snapshot) {
+    return Object.freeze({
+        ...snapshot,
+        binding: Object.freeze({ ...snapshot.binding }),
+        cells: Object.freeze([...snapshot.cells]),
+        ...(snapshot.renderRows === undefined ? {} : { renderRows: freezeRenderRows(snapshot.renderRows) }),
+        displayWidths: Object.freeze([...snapshot.displayWidths]),
+        modes: Object.freeze({ ...snapshot.modes }),
+    });
+}
+function validateRenderRows(rows, cells, displayWidths, columns) {
+    if (rows.length !== cells.length) {
+        throw new ViewportIsolationError("viewport_limit", "Styled viewport rows do not match the rendered cells.");
+    }
+    for (const [rowIndex, row] of rows.entries()) {
+        let width = 0;
+        for (const run of row) {
+            if (!Number.isSafeInteger(run.width) || run.width < 1 || containsHostControl(run.text)) {
+                throw new ViewportIsolationError("viewport_limit", "A styled viewport run is invalid.");
+            }
+            validateStyle(run.style);
+            width += run.width;
+        }
+        const renderedText = row.map((run) => run.text).join("");
+        if (renderedText !== cells[rowIndex]) {
+            throw new ViewportIsolationError("viewport_limit", "Styled viewport text does not match the VTE cells.");
+        }
+        if (width !== (displayWidths[rowIndex] ?? -1) || width > columns) {
+            throw new ViewportIsolationError("viewport_limit", "Styled viewport width does not match the VTE observation.");
+        }
+    }
+}
+function validateStyle(style) {
+    for (const color of [style.foreground, style.background]) {
+        if (color === null)
+            continue;
+        const maximum = color.mode === "palette" ? 0xff : color.mode === "rgb" ? 0xff_ffff : -1;
+        if (!Number.isSafeInteger(color.value) || color.value < 0 || color.value > maximum) {
+            throw new ViewportIsolationError("viewport_limit", "A viewport color is outside its admitted range.");
+        }
+    }
+}
+function freezeRenderRows(rows) {
+    return Object.freeze(rows.map((row) => Object.freeze(row.map((run) => Object.freeze({
+        text: run.text,
+        width: run.width,
+        style: Object.freeze({
+            ...run.style,
+            ...(run.style.foreground === null ? {} : { foreground: Object.freeze({ ...run.style.foreground }) }),
+            ...(run.style.background === null ? {} : { background: Object.freeze({ ...run.style.background }) }),
+        }),
+    })))));
+}
+//# sourceMappingURL=viewport.js.map

package/dist/terminal/viewport.js.map

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

package/dist/terminal/workbench.d.ts

@@ -0,0 +1,32 @@
+import type { AppbarModel } from "./appbar.js";
+import type { ViewportSnapshot } from "./viewport.js";
+export interface WorkbenchTab {
+    readonly id: string;
+    readonly label: string;
+    readonly agent: "claude-code" | "codex" | "openclaw" | "opencode" | "shell";
+    readonly viewport: ViewportSnapshot;
+}
+export interface WorkbenchFrameInput {
+    readonly columns: number;
+    readonly rows: number;
+    readonly activeTabId: string;
+    readonly tabs: readonly WorkbenchTab[];
+    readonly appbar: AppbarModel;
+    readonly notice?: string;
+    readonly action?: string;
+    readonly color?: boolean;
+}
+export interface WorkbenchFrame {
+    readonly bytes: Uint8Array;
+    readonly text: string;
+    readonly appbarRows: number;
+    readonly viewportRows: number;
+}
+export declare class WorkbenchRenderError extends Error {
+    readonly code: "invalid_dimensions" | "active_tab_missing" | "binding_mismatch" | "duplicate_tab";
+    constructor(code: WorkbenchRenderError["code"], message: string);
+}
+/** A cell-only projection for the plain observer; it contains no appbar. */
+export declare function renderBareViewport(viewport: ViewportSnapshot, notice?: string): Uint8Array;
+export declare function renderWorkbenchFrame(input: WorkbenchFrameInput): WorkbenchFrame;
+//# sourceMappingURL=workbench.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workbench.d.ts","sourceRoot":"","sources":["../../src/terminal/workbench.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAA2D,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAS/G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,eAAe,CAAC;gBAEtF,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAKhE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CA8B1F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAoD/E"}

package/dist/terminal/workbench.js

@@ -0,0 +1,316 @@
+const ESC = "\u001b[";
+const CUNA_ORANGE = "48;2;235;86;37";
+const CUNA_ORANGE_DARK = "48;2;121;48;25";
+const WHITE = "38;2;255;255;255";
+const MUTED = "38;2;224;210;203";
+const GRAPHEME_SEGMENTER = new Intl.Segmenter("en", { granularity: "grapheme" });
+export class WorkbenchRenderError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "WorkbenchRenderError";
+        this.code = code;
+    }
+}
+/** A cell-only projection for the plain observer; it contains no appbar. */
+export function renderBareViewport(viewport, notice) {
+    if (!Number.isSafeInteger(viewport.columns) || !Number.isSafeInteger(viewport.rows) ||
+        viewport.columns < 1 || viewport.rows < 1 || viewport.columns > 4096 || viewport.rows > 4096) {
+        throw new WorkbenchRenderError("invalid_dimensions", "Observer dimensions are outside the admitted range.");
+    }
+    // A previous raw writer may have changed origin, margins or auto-wrap. The
+    // projected cells own these modes locally and must not inherit those modes.
+    const notices = [];
+    let remaining = notice === undefined ? "" : safeText(notice);
+    while (remaining.length > 0 && notices.length < Math.max(1, viewport.rows - 1)) {
+        const line = truncate(remaining, viewport.columns);
+        notices.push(line);
+        remaining = remaining.slice(line.length).trimStart();
+    }
+    const contentRows = viewport.rows - notices.length;
+    let text = `${ESC}?25l${ESC}?6l${ESC}r${ESC}?7l`;
+    for (let row = 0; row < contentRows; row += 1) {
+        const cell = viewport.cells[row] ?? "";
+        const width = viewport.displayWidths[row] ?? 0;
+        const runs = viewport.renderRows?.[row];
+        assertViewportCell(cell, width, viewport.columns);
+        if (runs !== undefined)
+            assertViewportRenderRuns(runs, cell, width, viewport.columns);
+        text += `${ESC}${row + 1};1H${ESC}0m${ESC}2K${runs === undefined ? cell : renderStyledRuns(runs)}`;
+    }
+    for (let index = 0; index < notices.length; index += 1) {
+        text += `${ESC}${contentRows + index + 1};1H${ESC}0m${ESC}2K${notices[index]}`;
+    }
+    text += `${ESC}0m${ESC}?7h${ESC}${Math.min(Math.max(0, contentRows - 1), Math.max(0, viewport.cursorY)) + 1};${Math.min(viewport.columns - 1, Math.max(0, viewport.cursorX)) + 1}H`;
+    text += viewport.modes.cursorVisible && viewport.cursorY < contentRows ? `${ESC}?25h` : `${ESC}?25l`;
+    return new TextEncoder().encode(text);
+}
+export function renderWorkbenchFrame(input) {
+    validateDimensions(input.columns, input.rows);
+    if (new Set(input.tabs.map((tab) => tab.id)).size !== input.tabs.length) {
+        throw new WorkbenchRenderError("duplicate_tab", "Workbench tab identities must be unique.");
+    }
+    const active = input.tabs.find((tab) => tab.id === input.activeTabId);
+    if (active === undefined) {
+        throw new WorkbenchRenderError("active_tab_missing", "The active workbench tab does not exist.");
+    }
+    if (active.viewport.tabId !== active.id) {
+        throw new WorkbenchRenderError("binding_mismatch", "The selected viewport belongs to another workbench tab.");
+    }
+    const appbarRows = input.rows >= 5 ? 2 : 1;
+    const viewportRows = input.rows - appbarRows;
+    const lines = appbarRows === 2
+        ? [
+            input.action === undefined ? renderTabs(input.tabs, input.activeTabId, input.columns) : truncate(`[ ${input.action} ]  ${renderTabs(input.tabs, input.activeTabId, input.columns)}`, input.columns),
+            input.notice === undefined ? renderTruth(input.appbar, active.agent, input.columns) : truncate(` ${safeText(input.notice)}`, input.columns),
+        ]
+        : [input.notice === undefined
+                ? renderCompact(input.tabs, input.activeTabId, input.appbar, input.columns)
+                : truncate(` CUNA  ${safeText(input.notice)}`, input.columns)];
+    const color = input.color !== false;
+    let text = `${ESC}?25l${ESC}H`;
+    for (let index = 0; index < lines.length; index += 1) {
+        const background = index === 0 ? CUNA_ORANGE : CUNA_ORANGE_DARK;
+        text += `${ESC}${index + 1};1H${ESC}0m${ESC}2K${color ? `${ESC}${background}m${ESC}${index === 0 ? WHITE : MUTED}m` : ""}`;
+        text += padLine(lines[index] ?? "", input.columns);
+        if (color)
+            text += `${ESC}0m`;
+    }
+    const cells = active.viewport.cells.slice(0, viewportRows);
+    for (let row = 0; row < viewportRows; row += 1) {
+        const cell = cells[row] ?? "";
+        const displayWidth = active.viewport.displayWidths[row] ?? 0;
+        assertViewportCell(cell, displayWidth, input.columns);
+        const renderRuns = active.viewport.renderRows?.[row];
+        if (renderRuns !== undefined)
+            assertViewportRenderRuns(renderRuns, cell, displayWidth, input.columns);
+        const rendered = renderRuns === undefined || !color ? cell : renderStyledRuns(renderRuns);
+        text += `${ESC}${appbarRows + row + 1};1H${ESC}0m${ESC}2K${rendered}`;
+    }
+    const cursorRow = Math.min(viewportRows - 1, Math.max(0, active.viewport.cursorY));
+    const cursorColumn = Math.min(input.columns - 1, Math.max(0, active.viewport.cursorX));
+    text += `${ESC}0m${ESC}${appbarRows + cursorRow + 1};${cursorColumn + 1}H`;
+    text += active.viewport.modes.cursorVisible ? `${ESC}?25h` : `${ESC}?25l`;
+    return Object.freeze({
+        bytes: new TextEncoder().encode(text),
+        text,
+        appbarRows,
+        viewportRows,
+    });
+}
+function renderTabs(tabs, activeTabId, columns) {
+    const parts = [" CUNA"];
+    for (let index = 0; index < tabs.length; index += 1) {
+        const tab = tabs[index];
+        if (tab === undefined)
+            continue;
+        const active = tab.id === activeTabId;
+        const label = `${index + 1}:${agentLabel(tab.agent)} ${safeText(tab.label)}`;
+        parts.push(active ? `[${label}]` : ` ${label} `);
+    }
+    const tabLabels = parts.join("  ");
+    const clipboard = "Select text: Ctrl+Shift+C copy | Ctrl+Shift+V paste";
+    return truncate(process.platform === "win32" && columns >= 100
+        ? `${truncate(tabLabels, Math.max(20, columns - clipboard.length - 3))}   ${clipboard}`
+        : tabLabels, columns);
+}
+function renderTruth(model, agent, columns) {
+    const values = [
+        projection("terminal", model.attachment),
+        providerAuthProjection(providerAuthLabel(agent), model.providerAuthentication),
+    ];
+    if (model.cost !== undefined)
+        values.push(metric("cost", model.cost, (value) => `$${value.toFixed(2)}`));
+    if (model.tokensSaved !== undefined)
+        values.push(metric("tokens saved", model.tokensSaved, String));
+    return truncate(` ${values.join("  \u00b7  ")}`, columns);
+}
+function renderCompact(tabs, activeTabId, model, columns) {
+    const active = tabs.find((tab) => tab.id === activeTabId);
+    const identity = active === undefined ? "session" : `${agentLabel(active.agent)} ${safeText(active.label)}`;
+    const provider = active === undefined ? "provider auth" : providerAuthLabel(active.agent);
+    return truncate(` CUNA  ${identity}  \u00b7  ${projection("terminal", model.attachment)}  \u00b7  ${providerAuthProjection(provider, model.providerAuthentication)}`, columns);
+}
+function providerAuthProjection(label, value) {
+    return value.status === "stale"
+        ? `${label} status not refreshed`
+        : projection(label, value);
+}
+function projection(label, value) {
+    return value.status === "verified"
+        ? `${label} ${humanStatus(value.value)}`
+        : `${label} ${value.status}`;
+}
+function humanStatus(value) {
+    return safeText(value).replace(/[_-]+/gu, " ");
+}
+function metric(label, value, format) {
+    return value.status === "verified"
+        ? `${label} ${format(value.value)}`
+        : `${label} ${value.status}`;
+}
+function agentLabel(agent) {
+    switch (agent) {
+        case "claude-code": return "Claude";
+        case "codex": return "Codex";
+        case "openclaw": return "OpenClaw";
+        case "opencode": return "OpenCode";
+        case "shell": return "Shell";
+    }
+}
+function providerAuthLabel(agent) {
+    return `${agentLabel(agent)} auth`;
+}
+function safeText(value) {
+    const safe = value.normalize("NFC").replace(/[\p{Cc}\p{Cf}\p{Cs}]/gu, "");
+    return safe.replace(/\s+/gu, " ").trim();
+}
+function truncate(value, columns) {
+    let result = "";
+    let width = 0;
+    for (const item of GRAPHEME_SEGMENTER.segment(value)) {
+        const nextWidth = graphemeCellWidth(item.segment);
+        if (width + nextWidth > columns)
+            break;
+        result += item.segment;
+        width += nextWidth;
+    }
+    return result;
+}
+function padLine(value, columns) {
+    const truncated = truncate(value, columns);
+    return truncated + " ".repeat(Math.max(0, columns - displayCellWidth(truncated)));
+}
+function displayCellWidth(value) {
+    let width = 0;
+    for (const item of GRAPHEME_SEGMENTER.segment(value))
+        width += graphemeCellWidth(item.segment);
+    return width;
+}
+function graphemeCellWidth(value) {
+    if (/^[\p{M}\p{Cf}]*$/u.test(value))
+        return 0;
+    if (/\p{Extended_Pictographic}|\p{Regional_Indicator}|\u20e3/u.test(value))
+        return 2;
+    for (const character of value) {
+        const point = character.codePointAt(0);
+        if (point !== undefined && isWideCodePoint(point))
+            return 2;
+    }
+    return 1;
+}
+function isWideCodePoint(point) {
+    return (point >= 0x1100 && (point <= 0x115f ||
+        point === 0x2329 || point === 0x232a ||
+        (point >= 0x2e80 && point <= 0xa4cf && point !== 0x303f) ||
+        (point >= 0xac00 && point <= 0xd7a3) ||
+        (point >= 0xf900 && point <= 0xfaff) ||
+        (point >= 0xfe10 && point <= 0xfe19) ||
+        (point >= 0xfe30 && point <= 0xfe6f) ||
+        (point >= 0xff00 && point <= 0xff60) ||
+        (point >= 0xffe0 && point <= 0xffe6) ||
+        (point >= 0x20000 && point <= 0x3fffd)));
+}
+function assertViewportCell(value, displayWidth, columns) {
+    if (!Number.isSafeInteger(displayWidth) || displayWidth < 0 || displayWidth > columns) {
+        throw new WorkbenchRenderError("invalid_dimensions", "A viewport cell exceeds the host frame width.");
+    }
+    for (const character of value) {
+        const point = character.codePointAt(0);
+        if (point !== undefined && (point <= 0x1f || (point >= 0x7f && point <= 0x9f))) {
+            throw new WorkbenchRenderError("binding_mismatch", "Remote control bytes cannot enter the host compositor.");
+        }
+    }
+}
+function assertViewportRenderRuns(runs, cell, displayWidth, columns) {
+    let width = 0;
+    for (const run of runs) {
+        assertViewportCell(run.text, run.width, columns);
+        assertViewportStyle(run.style);
+        width += run.width;
+    }
+    if (width !== displayWidth || width > columns) {
+        throw new WorkbenchRenderError("invalid_dimensions", "Styled viewport width does not match the selected terminal row.");
+    }
+    if (runs.map((run) => run.text).join("") !== cell) {
+        throw new WorkbenchRenderError("binding_mismatch", "Styled viewport text does not match the selected terminal row.");
+    }
+}
+function assertViewportStyle(style) {
+    for (const flag of [
+        style.bold, style.dim, style.italic, style.underline, style.blink,
+        style.inverse, style.invisible, style.strikethrough, style.overline,
+    ]) {
+        if (typeof flag !== "boolean")
+            throw new WorkbenchRenderError("binding_mismatch", "A viewport style flag is invalid.");
+    }
+    for (const color of [style.foreground, style.background]) {
+        if (color === null)
+            continue;
+        const maximum = color.mode === "palette" ? 0xff : color.mode === "rgb" ? 0xff_ffff : -1;
+        if (!Number.isSafeInteger(color.value) || color.value < 0 || color.value > maximum) {
+            throw new WorkbenchRenderError("binding_mismatch", "A viewport color is outside its admitted range.");
+        }
+    }
+}
+function renderStyledRuns(runs) {
+    let result = "";
+    let previous;
+    for (const run of runs) {
+        if (previous === undefined || !sameViewportStyle(previous, run.style)) {
+            const parameters = styleParameters(run.style);
+            result += `${ESC}0${parameters.length === 0 ? "" : `;${parameters.join(";")}`}m`;
+            previous = run.style;
+        }
+        result += run.text;
+    }
+    return result;
+}
+function styleParameters(style) {
+    const parameters = [];
+    if (style.bold)
+        parameters.push("1");
+    if (style.dim)
+        parameters.push("2");
+    if (style.italic)
+        parameters.push("3");
+    if (style.underline)
+        parameters.push("4");
+    if (style.blink)
+        parameters.push("5");
+    if (style.inverse)
+        parameters.push("7");
+    if (style.invisible)
+        parameters.push("8");
+    if (style.strikethrough)
+        parameters.push("9");
+    if (style.overline)
+        parameters.push("53");
+    appendColor(parameters, "38", style.foreground);
+    appendColor(parameters, "48", style.background);
+    return parameters;
+}
+function appendColor(parameters, prefix, color) {
+    if (color === null)
+        return;
+    if (color.mode === "palette") {
+        parameters.push(prefix, "5", String(color.value));
+        return;
+    }
+    parameters.push(prefix, "2", String((color.value >>> 16) & 0xff), String((color.value >>> 8) & 0xff), String(color.value & 0xff));
+}
+function sameViewportStyle(left, right) {
+    return left.bold === right.bold && left.dim === right.dim && left.italic === right.italic &&
+        left.underline === right.underline && left.blink === right.blink && left.inverse === right.inverse &&
+        left.invisible === right.invisible && left.strikethrough === right.strikethrough && left.overline === right.overline &&
+        sameViewportColor(left.foreground, right.foreground) && sameViewportColor(left.background, right.background);
+}
+function sameViewportColor(left, right) {
+    return left === right || (left !== null && right !== null && left.mode === right.mode && left.value === right.value);
+}
+function validateDimensions(columns, rows) {
+    if (!Number.isSafeInteger(columns) || !Number.isSafeInteger(rows) || columns < 20 || rows < 2) {
+        throw new WorkbenchRenderError("invalid_dimensions", "Workbench dimensions are outside the admitted range.");
+    }
+}
+//# sourceMappingURL=workbench.js.map