@vibesdotdev/terminal-client 0.0.0-stage → 1.0.0-rc.3

package/dist/workspace.js

@@ -0,0 +1,292 @@
+import { CapabilityError, composeChildEnv } from '@vibesdotdev/kernel';
+import { openRemoteSession } from "./client.js";
+import * as z from 'zod/v4';
+export const terminalWorkspaceVesselStateSchema = z
+    .object({
+    executionId: z.string().min(1).default('browser-shell'),
+    cwd: z.string().min(1).default('/'),
+    correlationId: z.string().min(1).optional(),
+    sourceSurfaceId: z.string().min(1).optional()
+})
+    .strict();
+/** Stable identity for every prop that selects or configures a live session. */
+export function terminalWorkspaceLaunchSignature(input) {
+    return JSON.stringify([
+        input.runtimePlaceId,
+        input.executionId,
+        input.command,
+        input.args ?? [],
+        input.cwd
+    ]);
+}
+export function terminalWorkspaceDefaultCommand(runtimePlaceId) {
+    return runtimePlaceId.startsWith('browser:') ? 'vessel-sh' : 'sh';
+}
+export const terminalWorkspaceQuickActions = Object.freeze([
+    {
+        id: 'help',
+        label: 'Help',
+        description: 'Show available commands.',
+        command: 'help'
+    },
+    {
+        id: 'clear',
+        label: 'Clear',
+        description: 'Clear the terminal output.',
+        command: 'clear'
+    },
+    {
+        id: 'interrupt',
+        label: 'Stop',
+        description: 'Stop the current command.',
+        signal: 'SIGINT'
+    },
+    {
+        id: 'end',
+        label: 'End',
+        description: 'End this terminal session.',
+        command: 'exit'
+    }
+]);
+/**
+ * Resolve and open the real execution session, then derive its success receipt.
+ * The clock is read after the awaited session resolves, so callers cannot
+ * observe an `opened` receipt for a request the execution provider has not
+ * accepted.
+ */
+export async function openTerminalWorkspaceSession(input) {
+    const resolvedCommand = await input.execution.resolveCommand(input.command);
+    if (!resolvedCommand) {
+        throw new Error('Terminal is not available in this browser yet.');
+    }
+    const session = await input.execution.session({
+        command: resolvedCommand,
+        args: input.args,
+        cwd: input.cwd,
+        env: input.env,
+        envMode: 'replace',
+        cols: input.cols,
+        rows: input.rows
+    });
+    return {
+        session,
+        receipt: {
+            phase: 'opened',
+            sessionId: session.id,
+            environmentId: session.environmentId,
+            executionId: input.execution.id,
+            runtimePlaceId: input.runtimePlaceId,
+            cwd: input.cwd,
+            openedAt: (input.now ?? (() => new Date()))().toISOString()
+        }
+    };
+}
+/**
+ * Open against the authority named by this window's immutable place selector.
+ * Browser, local-machine, and fleet paths stay explicit so a remote label can
+ * never silently fall back to a local browser shell.
+ */
+export async function openTerminalWorkspaceTargetSession(input) {
+    if (input.runtimePlaceId.startsWith('browser:')) {
+        const execution = await input.runtime
+            .query('runtime/execution')
+            .withId(input.executionId)
+            .resolve();
+        const capabilities = execution.getCapabilities();
+        // The browser shell runs in the page; nothing from a host travels to it.
+        return {
+            ...(await openTerminalWorkspaceSession({ ...input, execution, env: {} })),
+            capabilities,
+            mode: 'session'
+        };
+    }
+    if (input.runtimePlaceId === 'device:this-mac') {
+        const execution = await input.runtime
+            .query('runtime/execution')
+            .withId(input.executionId)
+            .resolve();
+        if (execution.descriptor.environmentId === 'browser') {
+            throw new CapabilityError('The selected execution provider is not native.', 'INVALID_INPUT', {
+                reason: 'terminal-native-provider-required',
+                retryable: false
+            });
+        }
+        const capabilities = execution.getCapabilities();
+        // A native session on this host: exactly its composed environment.
+        return {
+            ...(await openTerminalWorkspaceSession({
+                ...input,
+                execution,
+                env: composeChildEnv(input.runtime, {})
+            })),
+            capabilities,
+            mode: 'session'
+        };
+    }
+    if (input.runtimePlaceId.startsWith('fleet:')) {
+        const runtimeId = input.runtimePlaceId.slice('fleet:'.length).trim();
+        if (!runtimeId) {
+            throw new CapabilityError('Choose a fleet machine before opening Terminal.', 'INVALID_INPUT', {
+                reason: 'terminal-fleet-host-missing',
+                retryable: false
+            });
+        }
+        const session = await openRemoteSession(input.runtime, { runtimeId, local: false }, {
+            command: input.command,
+            args: input.args,
+            cwd: input.cwd,
+            cols: input.cols,
+            rows: input.rows
+        });
+        return {
+            session,
+            capabilities: terminalWorkspacePlaceDefaultCapabilities(input.runtimePlaceId),
+            mode: 'session',
+            receipt: {
+                phase: 'opened',
+                sessionId: session.id,
+                environmentId: session.environmentId,
+                executionId: `runtime/execution@${runtimeId}`,
+                runtimePlaceId: input.runtimePlaceId,
+                cwd: input.cwd,
+                openedAt: (input.now ?? (() => new Date()))().toISOString()
+            }
+        };
+    }
+    if (input.runtimePlaceId.startsWith('cloud:') ||
+        input.runtimePlaceId.startsWith('sandbox:')) {
+        const execution = await input.runtime
+            .query('runtime/execution')
+            .withId(input.executionId)
+            .resolve();
+        const capabilities = execution.getCapabilities();
+        const now = input.now ?? (() => new Date());
+        // Honest exception: a cloud impl that truly advertises a PTY may open one.
+        if (capabilities.pty) {
+            return {
+                // A cloud provider runs its children in its own environment:
+                // nothing from this host travels.
+                ...(await openTerminalWorkspaceSession({ ...input, execution, env: {} })),
+                capabilities,
+                mode: 'session'
+            };
+        }
+        // pty === false: session() THROWS here (no PTY on workerd). Never call it.
+        // Drive exec mode via spawn() — a LIVE (streamed) process, not a buffered
+        // blob and not a faked keystroke stream. The handle's stdout/stderr emit as
+        // output arrives; the surface drains them into the exec panel live.
+        const resolvedCommand = await execution.resolveCommand(input.command);
+        if (!resolvedCommand) {
+            throw new CapabilityError('The cloud execution provider cannot resolve the command.', 'NOT_FOUND', {
+                reason: 'terminal-command-unresolved',
+                retryable: false
+            });
+        }
+        const execProcess = await execution.spawn({
+            command: resolvedCommand,
+            args: input.args,
+            cwd: input.cwd,
+            env: {},
+            envMode: 'replace',
+            stdin: 'ignore',
+            stdout: 'pipe',
+            stderr: 'pipe'
+        });
+        return {
+            session: null,
+            capabilities,
+            mode: 'exec',
+            execProcess,
+            receipt: {
+                phase: 'opened',
+                sessionId: `exec:${execution.id}`,
+                environmentId: execution.environmentId,
+                executionId: execution.id,
+                runtimePlaceId: input.runtimePlaceId,
+                cwd: input.cwd,
+                openedAt: now().toISOString()
+            }
+        };
+    }
+    throw new Error(`Terminal does not recognize the selected place: ${input.runtimePlaceId}.`);
+}
+/**
+ * Pre-resolution capability expectation for a place, used only to gate the UI
+ * before the impl is resolved. `cloud:`/`sandbox:` are now interactive
+ * (D-NO-DEFER / A5): a REAL PTY runs inside the CF Sandbox container via the
+ * pty-ws server, so `pty:true`. The live mask from `getCapabilities()` overrides
+ * this once a place is opened.
+ */
+export function terminalWorkspacePlaceDefaultCapabilities(runtimePlaceId) {
+    if (runtimePlaceId.startsWith('cloud:') || runtimePlaceId.startsWith('sandbox:')) {
+        return { pty: true, shell: true, signals: true, resize: true, maxSessions: 8 };
+    }
+    return { pty: true, shell: true, signals: true, resize: true, maxSessions: 1 };
+}
+/**
+ * Banner copy for a place. Non-PTY places get the honest "streams output live,
+ * no interactive TTY" caveat. Interactive cloud/sandbox places get a short
+ * positive note ("cloud PTY (containerized)") — the PTY is real, it just lives
+ * in the sandbox container, so there is no caveat, only context. Interactive
+ * local/device/fleet places get no banner (`null`). No jargon; no overclaim.
+ */
+export function terminalWorkspaceCapabilityBanner(capabilities, runtimePlaceId) {
+    const isCloud = runtimePlaceId.startsWith('cloud:') || runtimePlaceId.startsWith('sandbox:');
+    if (capabilities.pty) {
+        return isCloud ? 'Cloud PTY (containerized) — a real interactive terminal in the sandbox.' : null;
+    }
+    const place = isCloud ? 'Cloud exec' : terminalWorkspacePlaceLabel(runtimePlaceId);
+    return (`${place} — streams output live, but has no interactive TTY (keystrokes or resize). ` +
+        `Use this device or a fleet host for a full terminal.`);
+}
+export function terminalWorkspaceExitedEvent(receipt, result, now = () => new Date()) {
+    return {
+        ...receipt,
+        phase: 'exited',
+        exitedAt: now().toISOString(),
+        exitCode: result.exitCode
+    };
+}
+export function terminalWorkspaceStatusLabel(status) {
+    if (status === 'live')
+        return 'Connected';
+    if (status === 'opening')
+        return 'Opening';
+    if (status === 'exited')
+        return 'Session ended';
+    if (status === 'error')
+        return 'Not available';
+    return 'Ready';
+}
+export function terminalWorkspacePlaceLabel(runtimePlaceId) {
+    if (runtimePlaceId === 'device:this-mac')
+        return 'This Mac';
+    if (runtimePlaceId.startsWith('browser:'))
+        return 'This browser';
+    if (runtimePlaceId.startsWith('fleet:'))
+        return runtimePlaceId.slice('fleet:'.length);
+    return runtimePlaceId.includes(':')
+        ? runtimePlaceId.slice(runtimePlaceId.indexOf(':') + 1)
+        : runtimePlaceId;
+}
+export function terminalWorkspaceConnectionNotice(cwd, runtimePlaceId) {
+    const place = terminalWorkspacePlaceLabel(runtimePlaceId);
+    if (runtimePlaceId.startsWith('browser:')) {
+        return cwd === '/'
+            ? 'Terminal is connected to files kept in this browser.'
+            : `Terminal is connected to ${cwd} in this browser.`;
+    }
+    return cwd === '/'
+        ? `Terminal is connected to ${place}.`
+        : `Terminal on ${place} is connected to ${cwd}.`;
+}
+export function terminalWorkspaceError(_error, runtimePlaceId = 'browser:this-profile') {
+    if (runtimePlaceId === 'device:this-mac') {
+        return "Terminal couldn't connect to this Mac. Start or configure its local Vibes runtime.";
+    }
+    if (runtimePlaceId.startsWith('fleet:')) {
+        return `Terminal couldn't reach ${terminalWorkspacePlaceLabel(runtimePlaceId)}. Check that the machine is online and connected to Vibes.`;
+    }
+    return "Terminal couldn't start in this browser.";
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,6 +1,230 @@
 {
   "name": "@vibesdotdev/terminal-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-rc.3",
+  "dependencies": {
+    "@opentui/react": "^0.5.17",
+    "@vibesdotdev/docs-contracts": "^1.0.0-rc.4",
+    "@vibesdotdev/logging": "^1.0.0-rc.5",
+    "@vibesdotdev/kernel-rpc": "^1.0.0-rc.4",
+    "@vibesdotdev/host-bun": "^1.0.0-rc.3",
+    "@vibesdotdev/tui": "^1.0.0-rc.2",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "react": "^19.3.1",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@lucide/svelte": "^1.59.0",
+    "@vibesdotdev/kernel": "^1.0.0-rc.0",
+    "@vibesdotdev/kit": "^1.0.0-rc.0",
+    "@vibesdotdev/execution-local": "^1.0.0-rc.0",
+    "svelte": "^5.57.2",
+    "@vibesdotdev/surface-sveltekit": "^1.0.0-rc.0"
+  },
+  "optionalDependencies": {
+    "@xterm/addon-webgl": "^0.19.0"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "bun": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "bun": "./dist/terminal-client.plugin.js",
+      "types": "./dist/terminal-client.plugin.d.ts",
+      "import": "./dist/terminal-client.plugin.js",
+      "default": "./dist/terminal-client.plugin.js"
+    },
+    "./client": {
+      "bun": "./dist/client.js",
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./workspace": {
+      "bun": "./dist/workspace.js",
+      "types": "./dist/workspace.d.ts",
+      "import": "./dist/workspace.js",
+      "default": "./dist/workspace.js"
+    },
+    "./server/session-store": {
+      "bun": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./client/http-session": {
+      "bun": "./dist/client/index.js",
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "default": "./dist/client/index.js"
+    },
+    "./pty-bridge": {
+      "bun": "./dist/pty-bridge/index.js",
+      "types": "./dist/pty-bridge/index.d.ts",
+      "import": "./dist/pty-bridge/index.js",
+      "default": "./dist/pty-bridge/index.js"
+    },
+    "./pty-bridge/*": {
+      "bun": "./dist/pty-bridge/*.js",
+      "types": "./dist/pty-bridge/*.d.ts",
+      "import": "./dist/pty-bridge/*.js",
+      "default": "./dist/pty-bridge/*.js"
+    },
+    "./ansi": {
+      "bun": "./dist/ansi/index.js",
+      "types": "./dist/ansi/index.d.ts",
+      "import": "./dist/ansi/index.js",
+      "default": "./dist/ansi/index.js"
+    },
+    "./ansi/*": {
+      "bun": "./dist/ansi/*.js",
+      "types": "./dist/ansi/*.d.ts",
+      "import": "./dist/ansi/*.js",
+      "default": "./dist/ansi/*.js"
+    },
+    "./ansi/keymap": {
+      "bun": "./dist/ansi/keymap.js",
+      "types": "./dist/ansi/keymap.d.ts",
+      "import": "./dist/ansi/keymap.js",
+      "default": "./dist/ansi/keymap.js"
+    },
+    "./tui": {
+      "bun": "./dist/tui/index.js",
+      "types": "./dist/tui/index.d.ts",
+      "import": "./dist/tui/index.js",
+      "default": "./dist/tui/index.js"
+    },
+    "./tui/plugin": {
+      "bun": "./dist/tui/terminal-tui.plugin.js",
+      "types": "./dist/tui/terminal-tui.plugin.d.ts",
+      "import": "./dist/tui/terminal-tui.plugin.js",
+      "default": "./dist/tui/terminal-tui.plugin.js"
+    },
+    "./svelte": {
+      "bun": "./dist/svelte/index.js",
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js",
+      "default": "./dist/svelte/index.js"
+    },
+    "./svelte/plugin": {
+      "bun": "./dist/svelte/terminal-svelte.plugin.js",
+      "types": "./dist/svelte/terminal-svelte.plugin.d.ts",
+      "svelte": "./dist/svelte/terminal-svelte.plugin.js",
+      "import": "./dist/svelte/terminal-svelte.plugin.js",
+      "default": "./dist/svelte/terminal-svelte.plugin.js"
+    },
+    "./svelte/workspace": {
+      "bun": "./dist/svelte/workspace.js",
+      "types": "./dist/svelte/workspace.d.ts",
+      "import": "./dist/svelte/workspace.js",
+      "default": "./dist/svelte/workspace.js"
+    },
+    "./svelte/types": {
+      "bun": "./dist/svelte/types.js",
+      "types": "./dist/svelte/types.d.ts",
+      "svelte": "./dist/svelte/types.js",
+      "import": "./dist/svelte/types.js",
+      "default": "./dist/svelte/types.js"
+    },
+    "./svelte/*": {
+      "bun": "./dist/svelte/*",
+      "types": "./dist/svelte/*.d.ts",
+      "import": "./dist/svelte/*",
+      "default": "./dist/svelte/*"
+    },
+    "./api-client-plugin": {
+      "bun": "./dist/api-client-plugin.js",
+      "types": "./dist/api-client-plugin.d.ts",
+      "import": "./dist/api-client-plugin.js",
+      "default": "./dist/api-client-plugin.js"
+    },
+    "./consumer-plugin": {
+      "bun": "./dist/terminal.consumer.plugin.js",
+      "types": "./dist/terminal.consumer.plugin.d.ts",
+      "import": "./dist/terminal.consumer.plugin.js",
+      "default": "./dist/terminal.consumer.plugin.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "lint": "node ../node_modules/@vibesdotdev/internal-oxlint-toolchain/ratchet.mjs .",
+    "prebuild": "rm -rf dist",
+    "check": "${BUN:-bun} --bun tsc -p tsconfig.json --noEmit && ${BUN:-bun} --bun svelte-check --tsconfig ./tsconfig.svelte.check.json",
+    "build": "rm -rf dist && tsc -p tsconfig.core.json && ${BUN:-bun} --bun svelte-package --input ./src/svelte --output ./dist/svelte --tsconfig ./tsconfig.svelte.json && rm -rf dist/svelte/__tests__ && find dist/svelte -name '*.test.*' -delete && find dist/svelte -name '*.spec.*' -delete && find dist -name '*.tsbuildinfo' -delete",
+    "test": "${BUN:-bun} test src/ && ${BUN:-bun} --bun scripts/prove-remote-render.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "directory": "terminal-client"
+  },
+  "publishConfig": {
+    "registry": "https://packages.vibes.dev",
+    "access": "public"
+  },
+  "vibes": {
+    "visibility": "public",
+    "registry": {
+      "repositoryId": "4b1374d4-6830-4bfd-98e3-de66416368a8",
+      "directory": "terminal-client"
+    },
+    "publishProofProfiles": [
+      {
+        "id": "terminal-client/svelte",
+        "requiredOptionalPeers": [
+          "@lucide/svelte",
+          "@vibesdotdev/kit",
+          "@vibesdotdev/surface-sveltekit"
+        ],
+        "importSpecifiers": [
+          "@vibesdotdev/terminal-client/svelte"
+        ],
+        "surfaceProof": "sveltekit",
+        "ssrRenders": [
+          {
+            "specifier": "@vibesdotdev/terminal-client/svelte",
+            "exportName": "Terminal",
+            "props": {}
+          }
+        ]
+      }
+    ],
+    "handedRuntimeLogging": true,
+    "compositionRoots": [
+      "src/pty-bridge/server.ts"
+    ]
+  },
+  "description": "Terminal feature package: local and remote session composition, the terminal tool, browser rendering, and the feature-owned TUI launcher.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "peerDependenciesMeta": {
+    "@lucide/svelte": {
+      "optional": true
+    },
+    "@vibesdotdev/kit": {
+      "optional": true
+    },
+    "@vibesdotdev/execution-local": {
+      "optional": true
+    },
+    "@vibesdotdev/surface-sveltekit": {
+      "optional": true
+    }
+  },
+  "gitHead": "f1ff526c235b10c970497738beb16b0651c428c8",
+  "_vibes_source": {
+    "repo": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "sha": "f1ff526c235b10c970497738beb16b0651c428c8",
+    "workspaceDigest": "sha256:05ad771f6531189784ed3a20b0c2018f7e69e557018ae5a578a8f03b194190cc"
+  }
+}