@cuna_labs/cli 0.1.0

package/dist/workspace/selection-screen.js

@@ -0,0 +1,216 @@
+import { createNodeForegroundTerminalHost } from "../pty/node-host-terminal.js";
+import { sanitizeHumanTerminalOutput } from "../cli/output.js";
+import { truncateTerminalLine } from "../terminal/cell-width.js";
+import { readWorkspaceSelectionSource, listWorkspaceSelections, saveWorkspaceSelection } from "./selection-service.js";
+export async function runWorkspaceSelectionScreen(context, sourcePath, host = createNodeForegroundTerminalHost(), signal) {
+    const lease = await host.acquire("rich");
+    const abort = new AbortController();
+    const encoder = new TextEncoder(), decoder = new TextDecoder();
+    let phase = "source";
+    let text = sourcePath, destination = "", index = 0, busy = false, closed = false, cancelled = false, notice = "";
+    let choices = [];
+    let displayedSource;
+    let sequence = "", paste = false, previousCR = false, escapeTimer;
+    let writes = Promise.resolve();
+    let outcome = "cancelled", revision = 0;
+    let finish;
+    const done = new Promise(resolve => { finish = resolve; });
+    const close = (reason = "cancelled") => { outcome = reason; cancelled = true; abort.abort(); if (!busy) {
+        closed = true;
+        finish();
+    } };
+    const render = () => {
+        if (closed)
+            return;
+        const lines = [" CUNA  /  Workspaces", ""];
+        if (phase === "source")
+            lines.push(" Project context: choose an already linked local folder.", ` > ${text}`);
+        if (phase === "choose") {
+            lines.push(" Same Project and Machine. Choose a remote Workspace:");
+            const labels = ["Create an independent Workspace", ...choices.map(w => `${w.executionWorkspaceId}  generation ${w.activeGeneration}`)];
+            const start = Math.max(0, index - Math.max(1, host.dimensions().rows - 10));
+            labels.slice(start, start + Math.max(1, host.dimensions().rows - 8)).forEach((label, i) => lines.push(`${start + i === index ? " >" : "  "} ${label}`));
+        }
+        if (phase === "destination")
+            lines.push(" Choose an existing local folder without a Workspace binding.", " Its files will not be uploaded by this selection.", ` > ${text}`);
+        if (phase === "confirm")
+            lines.push(index === 0 ? " Create a separate remote Workspace." : ` Adopt remote Workspace ${choices[index - 1].executionWorkspaceId}.`, ` Local folder: ${destination}`, " The selected folder keeps its own files; this does not download remote files.", " Enter confirms the binding. Esc returns.");
+        if (phase === "done")
+            lines.push(" Workspace binding saved.", ` Local folder: ${destination}`, " Open an agent in this folder to use it.", " Existing remote files are preserved; synchronization may require reconciliation.");
+        lines.push("", busy ? " Working… Ctrl+C requests cancellation." : phase === "done" ? " Enter or Esc closes." : " ↑↓ select  ·  Enter continue  ·  Esc back  ·  Ctrl+C cancel");
+        if (notice)
+            lines.push("", notice);
+        const frame = lines.map(line => truncateTerminalLine(sanitizeHumanTerminalOutput(line), host.dimensions().columns)).join("\r\n");
+        const frameRevision = ++revision;
+        writes = writes.then(() => frameRevision === revision && !closed ? host.write(encoder.encode("\x1b[H\x1b[2J" + frame)) : undefined).catch(() => close());
+    };
+    const act = async () => {
+        if (busy)
+            return;
+        if (phase === "done") {
+            close("saved");
+            return;
+        }
+        if (phase === "choose") {
+            phase = "destination";
+            text = "";
+            notice = "";
+            render();
+            return;
+        }
+        if (phase === "destination") {
+            if (!text.trim()) {
+                notice = "Enter a local folder path.";
+                render();
+                return;
+            }
+            destination = text;
+            phase = "confirm";
+            render();
+            return;
+        }
+        busy = true;
+        notice = "";
+        render();
+        try {
+            if (phase === "source") {
+                sourcePath = text;
+                const source = await readWorkspaceSelectionSource(context, sourcePath, abort.signal);
+                displayedSource = source;
+                choices = await listWorkspaceSelections(context, source, abort.signal);
+                phase = "choose";
+                index = 0;
+            }
+            else {
+                if (displayedSource === undefined)
+                    throw new Error("Reload the Project context before confirming.");
+                await saveWorkspaceSelection(context, sourcePath, destination, index === 0 ? undefined : choices[index - 1].executionWorkspaceId, displayedSource, abort.signal);
+                phase = "done";
+            }
+        }
+        catch (error) {
+            notice = error instanceof Error ? error.message : "Workspace selection could not be confirmed.";
+        }
+        finally {
+            busy = false;
+            if (cancelled) {
+                closed = true;
+                finish();
+            }
+            else
+                render();
+        }
+    };
+    const back = () => {
+        if (busy)
+            return;
+        if (phase === "source" || phase === "done") {
+            close(phase === "done" ? "saved" : "back");
+            return;
+        }
+        if (phase === "confirm") {
+            phase = "destination";
+            text = destination;
+        }
+        else if (phase === "destination")
+            phase = "choose";
+        else {
+            phase = "source";
+            text = sourcePath;
+        }
+        notice = "";
+        render();
+    };
+    const input = host.onInput(bytes => {
+        for (const char of decoder.decode(bytes, { stream: true })) {
+            if (char === "\n" && previousCR) {
+                previousCR = false;
+                continue;
+            }
+            previousCR = char === "\r";
+            if (char === "\x03") {
+                close();
+                break;
+            }
+            if (busy || closed)
+                continue;
+            if (sequence === "escape") {
+                if (escapeTimer !== undefined)
+                    clearTimeout(escapeTimer);
+                sequence = char === "[" || char === "O" ? "cursor" : "";
+                continue;
+            }
+            if (sequence.startsWith("cursor")) {
+                if (!/[A-Za-z~]/u.test(char)) {
+                    sequence += char;
+                    continue;
+                }
+                if (sequence === "cursor200" && char === "~") {
+                    paste = true;
+                    sequence = "";
+                    continue;
+                }
+                if (sequence === "cursor201" && char === "~") {
+                    paste = false;
+                    sequence = "";
+                    continue;
+                }
+                sequence = "";
+                if (phase === "choose" && (char === "A" || char === "B")) {
+                    index = Math.max(0, Math.min(choices.length, index + (char === "A" ? -1 : 1)));
+                    render();
+                }
+                continue;
+            }
+            if (char === "\x1b") {
+                sequence = "escape";
+                escapeTimer = setTimeout(() => { sequence = ""; back(); }, 150);
+                continue;
+            }
+            if (char === "\r" || char === "\n") {
+                if (paste) {
+                    notice = "Paste one folder path on a single line.";
+                    render();
+                    continue;
+                }
+                void act();
+                break;
+            }
+            if (phase === "source" || phase === "destination") {
+                if (char === "\x7f" || char === "\b")
+                    text = Array.from(text).slice(0, -1).join("");
+                else if (!/[\p{Cc}\p{Cf}]/u.test(char) && text.length < 4096)
+                    text += char;
+                render();
+            }
+        }
+    });
+    const resize = host.onResize(render);
+    const onAbort = () => close();
+    signal?.addEventListener("abort", onAbort, { once: true });
+    if (signal?.aborted)
+        close();
+    else
+        render();
+    try {
+        await done;
+    }
+    finally {
+        input();
+        resize();
+        signal?.removeEventListener("abort", onAbort);
+        if (escapeTimer !== undefined)
+            clearTimeout(escapeTimer);
+        let timer;
+        try {
+            await Promise.race([writes, new Promise(resolve => { timer = setTimeout(resolve, 2000); })]);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            await lease.restore();
+        }
+    }
+    return outcome;
+}
+//# sourceMappingURL=selection-screen.js.map

package/dist/workspace/selection-screen.js.map

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

package/dist/workspace/selection-service.d.ts

@@ -0,0 +1,16 @@
+import type { CunaApiClient } from "../api/client.js";
+import type { ExecutionWorkspace } from "../api/execution-workspaces.js";
+import { type WorkspaceBindingRecord } from "./binding-store.js";
+export interface WorkspaceSelectionContext {
+    readonly client: CunaApiClient;
+    readonly profileId: string;
+    readonly userId: string;
+    readonly workspaceId: string;
+    readonly machineId: string;
+    readonly stateDirectory: string;
+    readonly platform: "windows" | "macos" | "linux";
+}
+export declare function readWorkspaceSelectionSource(context: WorkspaceSelectionContext, path: string, signal?: AbortSignal): Promise<WorkspaceBindingRecord>;
+export declare function listWorkspaceSelections(context: WorkspaceSelectionContext, source: WorkspaceBindingRecord, signal?: AbortSignal): Promise<readonly ExecutionWorkspace[]>;
+export declare function saveWorkspaceSelection(context: WorkspaceSelectionContext, sourcePath: string, destinationPath: string, executionWorkspaceId: string | undefined, displayedSource: WorkspaceBindingRecord, signal?: AbortSignal): Promise<WorkspaceBindingRecord>;
+//# sourceMappingURL=selection-service.d.ts.map

package/dist/workspace/selection-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-service.d.ts","sourceRoot":"","sources":["../../src/workspace/selection-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAC;AAIvE,OAAO,EAAoD,KAAK,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAElH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAC,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAC,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAC,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAC,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAC,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAC,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAC,SAAS,GAAC,OAAO,GAAC,OAAO,CAAC;CAC7C;AAUD,wBAAsB,4BAA4B,CAAC,OAAO,EAAC,yBAAyB,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,CAAC,EAAC,WAAW,GAAE,OAAO,CAAC,sBAAsB,CAAC,CAQpJ;AACD,wBAAsB,uBAAuB,CAAC,OAAO,EAAC,yBAAyB,EAAC,MAAM,EAAC,sBAAsB,EAAC,MAAM,CAAC,EAAC,WAAW,GAAE,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAYxK;AACD,wBAAsB,sBAAsB,CAAC,OAAO,EAAC,yBAAyB,EAAC,UAAU,EAAC,MAAM,EAAC,eAAe,EAAC,MAAM,EAAC,oBAAoB,EAAC,MAAM,GAAC,SAAS,EAAC,eAAe,EAAC,sBAAsB,EAAC,MAAM,CAAC,EAAC,WAAW,GAAE,OAAO,CAAC,sBAAsB,CAAC,CAgBxP"}

package/dist/workspace/selection-service.js

@@ -0,0 +1,65 @@
+import { createHash } from "node:crypto";
+import { resolve } from "node:path";
+import { CunaError, EXIT_CODES } from "../core/errors.js";
+import { conservativeFilesystemCapabilities } from "../journey/workspace-effects.js";
+import { inspectWorkspaceSyncPolicy } from "../sync/workspace-sync-product-service.js";
+import { loadWorkspaceBindingIntent, persistWorkspaceBinding } from "./binding-store.js";
+function refusal(message) {
+    throw new CunaError({ code: "cuna.workspace.selection_conflict", message, exitCode: EXIT_CODES.conflict });
+}
+function stableId(text) {
+    const bytes = createHash("sha256").update(text).digest().subarray(0, 16);
+    bytes[6] = (bytes[6] & 15) | 80;
+    bytes[8] = (bytes[8] & 63) | 128;
+    const hex = bytes.toString("hex");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export async function readWorkspaceSelectionSource(context, path, signal) {
+    const loaded = await loadWorkspaceBindingIntent({ startPath: resolve(path), profileId: context.profileId, userId: context.userId, workspaceId: context.workspaceId });
+    if (loaded === undefined)
+        refusal("Choose a folder already linked to this Project. Open an agent in that folder first if the Project has no binding.");
+    const record = loaded.record;
+    if (record.machineId !== context.machineId)
+        refusal("This folder belongs to another Machine. Select its Machine before managing Workspaces.");
+    const authority = await context.client.getWorkspaceBinding(record.bindingId, { workspaceId: record.workspaceId, projectId: record.projectId, localInstanceId: record.localInstanceId, machineId: record.machineId, exclusionPolicyDigest: record.policyDigest, ...(record.executionWorkspaceId === undefined ? {} : { executionWorkspaceId: record.executionWorkspaceId }) }, signal);
+    if (authority.remoteRoot !== record.remoteRoot || (authority.executionWorkspaceId ?? null) !== (record.executionWorkspaceId ?? null))
+        refusal("The Project folder's remote identity changed. Refresh its binding before continuing.");
+    return record;
+}
+export async function listWorkspaceSelections(context, source, signal) {
+    const bounded = signal === undefined ? AbortSignal.timeout(30_000) : AbortSignal.any([signal, AbortSignal.timeout(30_000)]);
+    const items = [];
+    let after;
+    for (let pageNumber = 0; pageNumber < 100; pageNumber++) {
+        const page = await context.client.listExecutionWorkspaces({ workspaceId: context.workspaceId, projectId: source.projectId, machineId: context.machineId, ...(after === undefined ? {} : { after }) }, bounded);
+        items.push(...page.items);
+        if (page.nextCursor === null)
+            return Object.freeze(items);
+        if (page.nextCursor === after)
+            refusal("Workspace discovery did not advance. Retry the observation.");
+        after = page.nextCursor;
+    }
+    refusal("Workspace discovery exceeded its complete-list limit. No partial selection was accepted.");
+}
+export async function saveWorkspaceSelection(context, sourcePath, destinationPath, executionWorkspaceId, displayedSource, signal) {
+    // Re-read source authority at confirmation; a displayed menu is not a lease.
+    const source = await readWorkspaceSelectionSource(context, sourcePath, signal);
+    for (const key of ["bindingId", "projectId", "localInstanceId", "machineId", "workspaceId", "userId", "profileId", "canonicalLocalRoot", "remoteRoot", "executionWorkspaceId"]) {
+        if (source[key] !== displayedSource[key])
+            refusal("The displayed Project context changed. Go back and reload it before confirming a Workspace.");
+    }
+    if (JSON.stringify(source.rootIdentity) !== JSON.stringify(displayedSource.rootIdentity))
+        refusal("The Project folder identity changed. Reload it before confirming a Workspace.");
+    const policy = await inspectWorkspaceSyncPolicy({ localRoot: resolve(destinationPath), filesystemCapabilities: conservativeFilesystemCapabilities(context.platform) });
+    const existing = await loadWorkspaceBindingIntent({ startPath: policy.canonicalRoot, boundaryPath: policy.canonicalRoot, profileId: context.profileId, userId: context.userId, workspaceId: context.workspaceId });
+    if (existing !== undefined)
+        refusal("The selected folder already has a Workspace binding. Choose a different folder; its existing binding was preserved.");
+    const localInstanceId = stableId(JSON.stringify(["cuna.workspace.selection.v1", context.workspaceId, context.userId, source.projectId, policy.canonicalRoot, context.stateDirectory]));
+    const request = { workspaceId: context.workspaceId, projectId: source.projectId, localInstanceId, machineId: context.machineId, exclusionPolicyDigest: policy.exclusionPolicyDigest, excludedPrefixes: Object.freeze([]), ...(executionWorkspaceId === undefined ? {} : { executionWorkspaceId }) };
+    const key = "cuna-workspace-selection-v1-" + createHash("sha256").update(JSON.stringify(request)).digest("hex");
+    const authority = await context.client.createWorkspaceBinding(request, key, signal);
+    if (authority.executionWorkspaceId === null)
+        refusal("The server did not create or adopt an isolated Workspace. This folder was not relabeled as isolated.");
+    return persistWorkspaceBinding({ root: policy.canonicalRoot, expected: null, binding: { profileId: context.profileId, userId: context.userId, workspaceId: context.workspaceId, bindingId: authority.bindingId, projectId: authority.projectId, executionWorkspaceId: authority.executionWorkspaceId, localInstanceId: authority.localInstanceId, machineId: authority.machineId, remoteRoot: authority.remoteRoot, policyDigest: authority.exclusionPolicyDigest, generation: authority.activeGeneration, bindingCreatedAt: authority.createdAt, bindingUpdatedAt: authority.updatedAt } });
+}
+//# sourceMappingURL=selection-service.js.map

package/dist/workspace/selection-service.js.map

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

package/node_modules/@xterm/headless/README.md

@@ -0,0 +1,31 @@
+# [![xterm.js logo](logo-full.png)](https://xtermjs.org)
+
+⚠ This package is experimental
+
+`xterm-headless` is a headless terminal that can be run in node.js. This is useful in combination with the frontend [`xterm`](https://www.npmjs.com/package/xterm) for example to keep track of a terminal's state on a remote server where the process is hosted.
+
+## Getting Started
+
+First, you need to install the module, we ship exclusively through npm, so you need that installed and then add xterm.js as a dependency by running:
+
+```sh
+npm install xterm-headless
+```
+
+Then import as you would a regular node package. The recommended way to load `xterm-headless` is with TypeScript and the ES6 module syntax:
+
+```javascript
+import { Terminal } from '@xterm/headless';
+```
+
+## API
+
+The full API for `xterm-headless` is contained within the [TypeScript declaration file](https://github.com/xtermjs/xterm.js/blob/master/typings/xterm-headless.d.ts), use the branch/tag picker in GitHub (`w`) to navigate to the correct version of the API.
+
+Note that some APIs are marked *experimental*, these are added to enable experimentation with new ideas without committing to support it like a normal [semver](https://semver.org/) API. Note that these APIs can change radically between versions, so be sure to read release notes if you plan on using experimental APIs.
+
+### Addons
+
+Addons in `xterm-headless` work the [same as in `xterm`](https://github.com/xtermjs/xterm.js/blob/master/README.md#addons) with the one caveat being that the addon needs to be packaged for node.js and not use any DOM APIs.
+
+Currently no official addons are packaged on npm.