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

package/dist/svelte/types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Public types for `@vibesdotdev/terminal-client/svelte`.
+ *
+ * The `ExecutionSession` shape is OWNED BY L3 (`@vibesdotdev/kernel/execution`)
+ * and consumed here type-only — this lane MUST NOT vary it. We re-export the type
+ * so consumers can annotate the `session` prop without a direct dep on
+ * runtime-execution if they only need the type.
+ */
+import type { ExecutionSession } from '@vibesdotdev/kernel/execution';
+export type { ExecutionSession };
+/**
+ * Terminal color theme tokens. Mirrors the subset of xterm.js's `ITheme` the
+ * component forwards. All optional; the component fills a vibes default palette.
+ */
+export interface TerminalTheme {
+    background?: string;
+    foreground?: string;
+    cursor?: string;
+    cursorAccent?: string;
+    selectionBackground?: string;
+    /** Selection foreground color (xterm.js ITheme.selectionForeground). */
+    selectionForeground?: string;
+    black?: string;
+    red?: string;
+    green?: string;
+    yellow?: string;
+    blue?: string;
+    magenta?: string;
+    cyan?: string;
+    white?: string;
+    brightBlack?: string;
+    brightRed?: string;
+    brightGreen?: string;
+    brightYellow?: string;
+    brightBlue?: string;
+    brightMagenta?: string;
+    brightCyan?: string;
+    brightWhite?: string;
+}
+/**
+ * Props for `<Terminal>`.
+ *
+ * The component is transport-agnostic: it only ever sees an `ExecutionSession`.
+ * The consumer resolves that session — locally via
+ * `runtime.query('runtime/execution').resolve().session(...)` (or
+ * `terminal-client.openLocalSession`), or remotely via
+ * `terminal-client.openRemoteSession` (L9b, phase 4). The same component renders
+ * both; only `onDisconnect` differs (local sessions never fire it).
+ */
+export interface TerminalProps {
+    /**
+     * A live execution session whose byte stream this component renders.
+     * May be null/absent while the parent is still opening the session — the
+     * component boots xterm, fits, reports its grid via `onReady`, and shows the
+     * connecting skeleton until a session is attached. Opening the session at
+     * the `onReady` dimensions avoids a boot-time PTY resize entirely (Bun TUI
+     * children cache `process.stdout.columns`, so a post-boot resize is never
+     * observed by them — the session must START at the right size).
+     */
+    session?: ExecutionSession | null;
+    /**
+     * Fired once after the initial fit settles, with the fitted grid size.
+     * Parents should open their session with these cols/rows.
+     */
+    onReady?: (dims: {
+        cols: number;
+        rows: number;
+    }) => void;
+    /**
+     * Lock the xterm/PTY grid to these columns. When set with `rows`, FitAddon
+     * does not grow the session to the CSS container. Host-fitted columns then
+     * match the requested grid (e.g. `?cols=80&rows=24`).
+     */
+    cols?: number;
+    /**
+     * Lock the xterm/PTY grid to these rows. See `cols`.
+     */
+    rows?: number;
+    /**
+     * Fired after xterm has attached a live session and keystrokes/actions can
+     * reach the execution session. This is later than `onReady`, which only means
+     * the terminal has measured its grid.
+     */
+    onInputReady?: () => void;
+    /** Theme tokens; defaults to the vibes terminal palette. */
+    theme?: TerminalTheme;
+    /** Font family / size for the xterm renderer. */
+    font?: {
+        family?: string;
+        size?: number;
+    };
+    /** Extra class on the host element. */
+    class?: string;
+    /** Called when the session reports it has exited. */
+    onExit?: (result: {
+        exitCode: number | null;
+    }) => void;
+    /**
+     * Called when a *proxy* session's transport disconnects (remote only).
+     * Local sessions never fire this — remoteness is visible in behavior, not
+     * silent (Correction #1).
+     */
+    onDisconnect?: (reason: string) => void;
+    /**
+     * Read-only / observe mode. When true, keyboard input is NOT wired to the
+     * session: both PTY write paths (the xterm `onData` handler and the
+     * non-printing key-chord handler) are gated off, so the terminal renders the
+     * live byte stream but never sends keystrokes. The PTY output, fit/resize, and
+     * lifecycle paths are unaffected. Defaults to false (interactive).
+     *
+     * Non-breaking: existing callers that omit this get the prior interactive
+     * behavior.
+     */
+    readonly?: boolean;
+}
+/**
+ * A selectable host entry in the picker.
+ * `local: true` entries are rendered as "This machine — <name>".
+ */
+export interface HostOption {
+    /** Unique host identifier (hostId for fleet hosts; 'local' for this machine). */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** true when this host is the local machine (consumer-hq only). */
+    local?: boolean;
+    /** Runtime liveness status. */
+    status: 'online' | 'degraded' | 'offline' | 'unknown';
+}
+/**
+ * A tab entry representing a live (or recently exited) terminal session.
+ * Wire-compatible with `SessionMetadata` from `terminal-client/server/session-store`.
+ */
+export interface TabSession {
+    id: string;
+    command: string;
+    /** Short display label for the host (e.g. host name, 'local'). */
+    hostLabel?: string;
+    startedAt: number;
+    /** True when no SSE subscriber is attached (PTY keeps running). */
+    detached: boolean;
+    /** True when the process has exited. */
+    exited: boolean;
+}
+/**
+ * The vibes terminal theme — zinc-dark palette.
+ * Colors sourced from tui/src/theme.semantic.ts `darkColors` (upstream).
+ * Hand-copied here to avoid a runtime dep on @vibesdotdev/tui.
+ */
+export declare const VIBES_TERMINAL_THEME: Readonly<TerminalTheme>;
+/**
+ * @deprecated Use `VIBES_TERMINAL_THEME` instead. Kept for back-compat.
+ * Will be removed in a future major version.
+ */
+export declare const DEFAULT_TERMINAL_THEME: Readonly<TerminalTheme>;
+export declare const DEFAULT_FONT: Readonly<{
+    family: string;
+    size: number;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

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

package/dist/svelte/types.js

@@ -0,0 +1,51 @@
+/**
+ * Public types for `@vibesdotdev/terminal-client/svelte`.
+ *
+ * The `ExecutionSession` shape is OWNED BY L3 (`@vibesdotdev/kernel/execution`)
+ * and consumed here type-only — this lane MUST NOT vary it. We re-export the type
+ * so consumers can annotate the `session` prop without a direct dep on
+ * runtime-execution if they only need the type.
+ */
+/**
+ * The vibes terminal theme — zinc-dark palette.
+ * Colors sourced from tui/src/theme.semantic.ts `darkColors` (upstream).
+ * Hand-copied here to avoid a runtime dep on @vibesdotdev/tui.
+ */
+export const VIBES_TERMINAL_THEME = Object.freeze({
+    // Surface
+    background: '#09090b',
+    foreground: '#fafafa',
+    // Cursor — block, zinc-200 on zinc-950
+    cursor: '#e4e4e7',
+    cursorAccent: '#09090b',
+    // Selection — zinc-900 bg, full-white fg for legibility
+    selectionBackground: '#1f1f23',
+    selectionForeground: '#fafafa',
+    // ANSI standard colors
+    black: '#27272a',
+    red: '#ff6467',
+    green: '#61d46a',
+    yellow: '#fab72a',
+    blue: '#28bbfe',
+    magenta: '#b794f6',
+    cyan: '#56cfd8',
+    white: '#9f9fa9',
+    // ANSI bright colors
+    brightBlack: '#71717b',
+    brightRed: '#ff8a8c',
+    brightGreen: '#7ce085',
+    brightYellow: '#ffc95a',
+    brightBlue: '#5fccff',
+    brightMagenta: '#cbb0fb',
+    brightCyan: '#7fdfe6',
+    brightWhite: '#fafafa'
+});
+/**
+ * @deprecated Use `VIBES_TERMINAL_THEME` instead. Kept for back-compat.
+ * Will be removed in a future major version.
+ */
+export const DEFAULT_TERMINAL_THEME = VIBES_TERMINAL_THEME;
+export const DEFAULT_FONT = Object.freeze({
+    family: '"SF Mono", Menlo, Consolas, "Liberation Mono", monospace',
+    size: 13
+});

package/dist/svelte/workspace.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility surface; the rune-free workspace contract is universally owned. */
+export * from '../workspace.ts';
+//# sourceMappingURL=workspace.d.ts.map

package/dist/svelte/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/svelte/workspace.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,cAAc,iBAAiB,CAAC"}

package/dist/svelte/workspace.js

@@ -0,0 +1,2 @@
+/** Compatibility surface; the rune-free workspace contract is universally owned. */
+export * from "../workspace.js";

package/dist/terminal-client.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Consumer compatibility entrypoint. Portable hosts compose ./api-client-plugin. */
+export { default } from './terminal.consumer.plugin.ts';
+//# sourceMappingURL=terminal-client.plugin.d.ts.map

package/dist/terminal-client.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-client.plugin.d.ts","sourceRoot":"","sources":["../src/terminal-client.plugin.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/terminal-client.plugin.js

@@ -0,0 +1,3 @@
+/** Consumer compatibility entrypoint. Portable hosts compose ./api-client-plugin. */
+export { default } from "./terminal.consumer.plugin.js";
+//# sourceMappingURL=terminal-client.plugin.js.map

package/dist/terminal-client.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-client.plugin.js","sourceRoot":"","sources":["../src/terminal-client.plugin.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/terminal-runtime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Terminal Unified Tool Implementation (consumer)
+ *
+ * `execute` / `spawn` call `runtime/execution` (pipes). `session` / `open` open
+ * a PTY via the per-runtime `TerminalSessionStore`. One store per runtime;
+ * PTY ownership is keyed on the caller's participant/connection. A spawned
+ * process is held per owner too: its `procId` is a handle `read`, `wait`,
+ * `list` and `close` accept, with its stdout/stderr kept in a backlog ring.
+ */
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+import { type TerminalInput, type TerminalOutput } from './tools/terminal.schemas.ts';
+/** The kernel owns one terminal client and its lazy tool state per runtime. */
+export declare class TerminalClient extends BaseRuntimeClient<VibesRuntime> {
+    private state;
+    private sequence;
+    private remoteAbortCleanup?;
+    private readonly stopRemoteSessions;
+    prepareRemoteSession(): void;
+    private readonly remoteSessions;
+    nextRemoteSessionId(hostId: string): string;
+    ownRemoteSession(close: () => void | Promise<void>): () => void;
+    /** Open the HTTP transport on this runtime; hosts select the semantic client once. */
+    openHttpSession(options: import('./schemas/http.ts').OpenHttpSessionOptions): Promise<import("./client/http-session.ts").OpenedHttpSession>;
+    execute(input: TerminalInput, ctx?: ToolCallContext): Promise<TerminalOutput>;
+    protected onDispose(): Promise<void>;
+}
+export default TerminalClient;
+//# sourceMappingURL=terminal-runtime.d.ts.map

package/dist/terminal-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-runtime.d.ts","sourceRoot":"","sources":["../src/terminal-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EASN,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAU7E,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,cAAc,EAA2B,MAAM,6BAA6B,CAAC;AA6nBpI,+EAA+E;AAC/E,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,YAAY,CAAC;IAClE,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,kBAAkB,CAAC,CAAwC;IACnE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAEF,oBAAoB,IAAI,IAAI;IAG5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyC;IAExE,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3C,gBAAgB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAK/D,sFAAsF;IAChF,eAAe,CAAC,OAAO,EAAE,OAAO,mBAAmB,EAAE,sBAAsB;IAsCjF,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;cAQ7D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB1C;AAED,eAAe,cAAc,CAAC"}