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

package/dist/svelte/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @vibesdotdev/terminal-client/svelte
+ *
+ * The xterm.js rendering surface for an L3 `ExecutionSession` byte stream.
+ * `<Terminal session={…} />` writes keystrokes to the PTY, paints output, and
+ * wires resize/signal/exit. Transport-agnostic: the same component renders a
+ * local PTY (L9a) and an RPC proxy (L9b).
+ *
+ * Registers no runtime kinds — Terminal is a view over a session. The
+ * `./plugin` entrypoint registers package docs; the shared workspace entrypoint
+ * composes session choices through the host's handed runtime.
+ *
+ * All `@xterm/*` imports are deferred to `onMount` inside the component, so this
+ * barrel is import-safe on the server (no eager DOM/WebGL import, no `$state`
+ * barrel trap).
+ */
+export { default as Terminal } from './Terminal.svelte';
+export { default as TerminalWorkspace } from './TerminalWorkspace.svelte';
+export { default as TerminalHostWorkspace } from './TerminalHostWorkspace.svelte';
+export { default as TerminalMobileToolbar } from './TerminalMobileToolbar.svelte';
+export { default as HostPicker } from './HostPicker.svelte';
+export { default as SessionTabs } from './SessionTabs.svelte';
+export { default as ReconnectBanner } from './ReconnectBanner.svelte';
+export { default as TerminalToolCard } from './tool-widgets/TerminalToolCard.svelte';
+export { TerminalHostWorkspaceController, describeTerminalHostFailure, terminalHostLabel, terminalHostTabBanner, type TerminalHostBanner, type TerminalHostBannerStatus, type TerminalHostErrorDescriber, type TerminalHostOpenedSession, type TerminalHostSessionOpener, type TerminalHostSessionRequest, type TerminalHostTab, type TerminalHostTabStatus, type TerminalHostWorkspaceLayout, type TerminalHostWorkspaceOptions, type TerminalHostWorkspaceSnapshot, type TerminalHostWorkspaceStart } from './terminal-host-workspace.ts';
+export { registerTerminalSvelteToolWidget, terminalSveltePlugin, terminalSvelteWidgetDescriptor, default } from './terminal-svelte.plugin.ts';
+export { openTerminalWorkspaceSession, openTerminalWorkspaceTargetSession, terminalWorkspaceCapabilityBanner, terminalWorkspaceError, terminalWorkspaceExitedEvent, terminalWorkspacePlaceDefaultCapabilities, terminalWorkspacePlaceLabel, terminalWorkspaceStatusLabel, terminalWorkspaceVesselStateSchema, type OpenTerminalWorkspaceSessionInput, type OpenTerminalWorkspaceSessionResult, type OpenTerminalWorkspaceTargetSessionInput, type OpenTerminalWorkspaceTargetSessionResult, type TerminalWorkspaceExitedEvent, type TerminalWorkspaceLifecycleEvent, type TerminalWorkspaceOpenedReceipt, type TerminalWorkspaceRuntimePlaceOption, type TerminalWorkspaceSessionMode, type TerminalWorkspaceStatus } from '../workspace.ts';
+export { DEFAULT_FONT, DEFAULT_TERMINAL_THEME, VIBES_TERMINAL_THEME, type ExecutionSession, type TerminalProps, type TerminalTheme, type HostOption, type TabSession } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EACN,+BAA+B,EAC/B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,gCAAgC,EAChC,oBAAoB,EACpB,8BAA8B,EAC9B,OAAO,EACP,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,4BAA4B,EAC5B,kCAAkC,EAClC,iCAAiC,EACjC,sBAAsB,EACtB,4BAA4B,EAC5B,yCAAyC,EACzC,2BAA2B,EAC3B,4BAA4B,EAC5B,kCAAkC,EAClC,KAAK,iCAAiC,EACtC,KAAK,kCAAkC,EACvC,KAAK,uCAAuC,EAC5C,KAAK,wCAAwC,EAC7C,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,EACxC,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,28 @@
+/**
+ * @vibesdotdev/terminal-client/svelte
+ *
+ * The xterm.js rendering surface for an L3 `ExecutionSession` byte stream.
+ * `<Terminal session={…} />` writes keystrokes to the PTY, paints output, and
+ * wires resize/signal/exit. Transport-agnostic: the same component renders a
+ * local PTY (L9a) and an RPC proxy (L9b).
+ *
+ * Registers no runtime kinds — Terminal is a view over a session. The
+ * `./plugin` entrypoint registers package docs; the shared workspace entrypoint
+ * composes session choices through the host's handed runtime.
+ *
+ * All `@xterm/*` imports are deferred to `onMount` inside the component, so this
+ * barrel is import-safe on the server (no eager DOM/WebGL import, no `$state`
+ * barrel trap).
+ */
+export { default as Terminal } from './Terminal.svelte';
+export { default as TerminalWorkspace } from './TerminalWorkspace.svelte';
+export { default as TerminalHostWorkspace } from './TerminalHostWorkspace.svelte';
+export { default as TerminalMobileToolbar } from './TerminalMobileToolbar.svelte';
+export { default as HostPicker } from './HostPicker.svelte';
+export { default as SessionTabs } from './SessionTabs.svelte';
+export { default as ReconnectBanner } from './ReconnectBanner.svelte';
+export { default as TerminalToolCard } from './tool-widgets/TerminalToolCard.svelte';
+export { TerminalHostWorkspaceController, describeTerminalHostFailure, terminalHostLabel, terminalHostTabBanner } from "./terminal-host-workspace.js";
+export { registerTerminalSvelteToolWidget, terminalSveltePlugin, terminalSvelteWidgetDescriptor, default } from "./terminal-svelte.plugin.js";
+export { openTerminalWorkspaceSession, openTerminalWorkspaceTargetSession, terminalWorkspaceCapabilityBanner, terminalWorkspaceError, terminalWorkspaceExitedEvent, terminalWorkspacePlaceDefaultCapabilities, terminalWorkspacePlaceLabel, terminalWorkspaceStatusLabel, terminalWorkspaceVesselStateSchema } from "../workspace.js";
+export { DEFAULT_FONT, DEFAULT_TERMINAL_THEME, VIBES_TERMINAL_THEME } from "./types.js";

package/dist/svelte/styles.css

@@ -0,0 +1,8 @@
+/*
+ * Tailwind v4 source declaration for consumers — mirrors @vibesdotdev/kit's
+ * styles.css pattern. Apps that @import this file get this package's
+ * components scanned by their Tailwind build, so utility classes used only
+ * inside these components are emitted in the app's CSS bundle (Tailwind
+ * never scans node_modules). Paths resolve relative to this file.
+ */
+@source "./";

package/dist/svelte/terminal-host-workspace.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Rune-free state owner for `<TerminalHostWorkspace>`.
+ *
+ * The workspace is the embeddable terminal experience: pick a host, open
+ * sessions in tabs, see reconnect state, close sessions. This controller owns
+ * that state machine so it is the same in a full page, a dialog, or a panel,
+ * and so it is testable without a DOM. The component renders a snapshot and
+ * forwards user and `<Terminal>` events here.
+ *
+ * Transport is injected: the host app supplies a `TerminalHostSessionOpener`
+ * (typically a closure over `openHttpSession`). The controller never imports
+ * an HTTP client and never invents a session — a tab is `live` only after the
+ * opener resolves with a real `ExecutionSession`.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { ExecutionSession } from '@vibesdotdev/kernel/execution';
+import type { HostOption } from './types.ts';
+/** What the workspace asks the host app's opener for. */
+export interface TerminalHostSessionRequest {
+    /** The selected `HostOption.id`. */
+    hostId: string;
+    /** Command to run; `undefined` means the host's default shell. */
+    command?: string;
+    /** Fitted (or locked) grid the session must start at. */
+    cols: number;
+    rows: number;
+    /** Aborted when the user closes the tab or the workspace unmounts mid-open. */
+    signal: AbortSignal;
+    /**
+     * Transport reconnect hooks. Forward these to the transport (for
+     * `openHttpSession`, as `reconnect.onReconnecting` / `reconnect.onReconnected`)
+     * so the workspace can show the reconnect banner.
+     */
+    reconnect: {
+        onReconnecting: (attempt: number, delayMs: number) => void;
+        onReconnected: (attempt: number) => void;
+    };
+}
+/** A session the opener created. */
+export interface TerminalHostOpenedSession {
+    /** Stable session id (shown nowhere; used for tab identity and app hooks). */
+    id: string;
+    session: ExecutionSession;
+}
+/** Dependency-injected session opener; the workspace owns no transport. */
+export type TerminalHostSessionOpener = (request: TerminalHostSessionRequest) => Promise<TerminalHostOpenedSession>;
+/** Turns an open failure into user-facing copy. */
+export type TerminalHostErrorDescriber = (failure: CapabilityError, hostLabel: string) => string;
+/** Where the workspace is mounted. Only density changes; it always fills its container. */
+export type TerminalHostWorkspaceLayout = 'page' | 'dialog' | 'panel';
+export type TerminalHostTabStatus = 'opening' | 'live' | 'reconnecting' | 'failed' | 'exited';
+export type TerminalHostBannerStatus = 'reconnecting' | 'reconnected' | 'failed' | null;
+export interface TerminalHostTab {
+    /** Workspace-local identity (stable before the session id exists). */
+    readonly key: string;
+    /** Session id once opened. */
+    readonly sessionId: string | null;
+    readonly hostId: string;
+    readonly hostLabel: string;
+    /** Requested command; `undefined` = host default shell. */
+    readonly command: string | undefined;
+    /** Observe mode: keystrokes never reach the session. */
+    readonly readonly: boolean;
+    readonly status: TerminalHostTabStatus;
+    readonly session: ExecutionSession | null;
+    readonly inputReady: boolean;
+    readonly exitCode: number | null;
+    /** User-facing failure copy for `failed`. */
+    readonly error: string;
+    /** The typed failure behind `failed`, for hosts that log or report it. */
+    readonly failure: CapabilityError | null;
+    readonly reconnectAttempt: number;
+    readonly reconnectDelayMs: number;
+    /** True for a short moment after a successful reconnect. */
+    readonly reattached: boolean;
+}
+export interface TerminalHostBanner {
+    status: TerminalHostBannerStatus;
+    attempt: number;
+    delayMs: number;
+    reason: string;
+}
+export interface TerminalHostWorkspaceSnapshot {
+    readonly tabs: readonly TerminalHostTab[];
+    readonly activeKey: string;
+    readonly pickerOpen: boolean;
+    /** The deep-linked host is not in the reachable host list. */
+    readonly requestedHostUnavailable: boolean;
+    /** Host the picker preselects. */
+    readonly pickerHostId: string;
+    /** Command the picker pre-fills (never auto-run). */
+    readonly pickerCommand: string;
+}
+export interface TerminalHostWorkspaceStart {
+    hosts: readonly HostOption[];
+    /** Deep-linked host id. Absent → the first host. */
+    initialHostId?: string;
+    /** Deep-linked command: pre-filled in the picker, never run without a click. */
+    initialCommand?: string;
+    /** Open a session on the initial host immediately (no picker) when no command is pre-filled. */
+    autoOpen?: boolean;
+}
+export interface TerminalHostWorkspaceOptions {
+    openSession: TerminalHostSessionOpener;
+    /** Observe mode for every session this workspace opens. */
+    readonly?: boolean;
+    describeError?: TerminalHostErrorDescriber;
+    /** How long the "Reattached" banner stays (ms). */
+    reattachedNoticeMs?: number;
+}
+/** Product copy for an open failure. Never names transports, kinds, or descriptors. */
+export declare function describeTerminalHostFailure(failure: CapabilityError, hostLabel: string): string;
+/** The banner the active tab shows. Exited and failed tabs offer a new session. */
+export declare function terminalHostTabBanner(tab: TerminalHostTab | undefined): TerminalHostBanner;
+/** Tab label host suffix and picker label for a host. */
+export declare function terminalHostLabel(host: HostOption | undefined, hostId: string): string;
+type Listener = (snapshot: TerminalHostWorkspaceSnapshot) => void;
+export declare class TerminalHostWorkspaceController {
+    #private;
+    constructor(options: TerminalHostWorkspaceOptions);
+    get snapshot(): TerminalHostWorkspaceSnapshot;
+    subscribe(listener: Listener): () => void;
+    /** The latest reachable hosts (labels for new tabs). */
+    setHosts(hosts: readonly HostOption[]): void;
+    /** Resolve the deep link once: open on the initial host, or show the picker. */
+    start(input: TerminalHostWorkspaceStart): void;
+    /** Create a tab on `hostId`. The session opens once its terminal reports a grid. */
+    open(hostId: string, command?: string): string;
+    /** `<Terminal onReady>` for a tab: start the session at the fitted grid. */
+    terminalReady(key: string, dims: {
+        cols: number;
+        rows: number;
+    }): void;
+    /** Retry a failed tab in place (same host + command, new session). */
+    retry(key: string, dims: {
+        cols: number;
+        rows: number;
+    }): void;
+    inputReady(key: string): void;
+    exited(key: string, exitCode: number | null): void;
+    disconnected(key: string, reason: string): void;
+    select(key: string): void;
+    /** Close a tab: abort an in-flight open, end a live session. */
+    close(key: string): void;
+    showPicker(): void;
+    /** Dismiss the picker (only when a tab can be shown behind it). */
+    hidePicker(): void;
+    /** Unmount: abort opens and end every session this workspace started. */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=terminal-host-workspace.d.ts.map

package/dist/svelte/terminal-host-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-host-workspace.d.ts","sourceRoot":"","sources":["../../src/svelte/terminal-host-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,EAAuB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IAC1C,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE;QACV,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3D,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACzC,CAAC;CACF;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAAyB;IACzC,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,gBAAgB,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CACvC,OAAO,EAAE,0BAA0B,KAC/B,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC,mDAAmD;AACnD,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAEjG,2FAA2F;AAC3F,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9F,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC;AAExF,MAAM,WAAW,eAAe;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IAC1C,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,WAAW,EAAE,yBAAyB,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,uFAAuF;AACvF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgB/F;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,GAAG,kBAAkB,CAmB1F;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,6BAA6B,KAAK,IAAI,CAAC;AAQlE,qBAAa,+BAA+B;;gBAe/B,OAAO,EAAE,4BAA4B;IAKjD,IAAI,QAAQ,IAAI,6BAA6B,CAE5C;IAED,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAKzC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAI5C,gFAAgF;IAChF,KAAK,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI;IAgB9C,oFAAoF;IACpF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IA+B9C,4EAA4E;IAC5E,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQtE,sEAAsE;IACtE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMlD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAW/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOzB,gEAAgE;IAChE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAaxB,UAAU,IAAI,IAAI;IAKlB,mEAAmE;IACnE,UAAU,IAAI,IAAI;IAMlB,yEAAyE;IACzE,OAAO,IAAI,IAAI;CA4Hf"}

package/dist/svelte/terminal-host-workspace.js

@@ -0,0 +1,335 @@
+/**
+ * Rune-free state owner for `<TerminalHostWorkspace>`.
+ *
+ * The workspace is the embeddable terminal experience: pick a host, open
+ * sessions in tabs, see reconnect state, close sessions. This controller owns
+ * that state machine so it is the same in a full page, a dialog, or a panel,
+ * and so it is testable without a DOM. The component renders a snapshot and
+ * forwards user and `<Terminal>` events here.
+ *
+ * Transport is injected: the host app supplies a `TerminalHostSessionOpener`
+ * (typically a closure over `openHttpSession`). The controller never imports
+ * an HTTP client and never invents a session — a tab is `live` only after the
+ * opener resolves with a real `ExecutionSession`.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+const HttpStatusSchema = z.number().int();
+/** Product copy for an open failure. Never names transports, kinds, or descriptors. */
+export function describeTerminalHostFailure(failure, hostLabel) {
+    const parsedStatus = HttpStatusSchema.safeParse(failure.details?.status);
+    const status = parsedStatus.success ? parsedStatus.data : undefined;
+    const text = `${failure.message} ${failure.reason}`.toLowerCase();
+    const machine = hostLabel || 'this machine';
+    if (status === 401)
+        return 'Sign in to open a terminal session.';
+    if (status === 403 || failure.code === 'PERMISSION_DENIED') {
+        return "Access denied — you don't have permission to open a terminal on this machine.";
+    }
+    if (status === 429 || /max[_\s-]?sessions|too many sessions/.test(text)) {
+        return `Too many sessions are open on ${machine} — close one to start another.`;
+    }
+    if (status === 503 || status === 502 || /unreachable|unavailable|offline/.test(text)) {
+        return `${machine} is not reachable right now. Make sure it is online, then try again.`;
+    }
+    return `Unable to open a terminal on ${machine}. Check that it is online, then try again.`;
+}
+/** The banner the active tab shows. Exited and failed tabs offer a new session. */
+export function terminalHostTabBanner(tab) {
+    const none = { status: null, attempt: 0, delayMs: 0, reason: '' };
+    if (!tab)
+        return none;
+    switch (tab.status) {
+        case 'reconnecting':
+            return { status: 'reconnecting', attempt: tab.reconnectAttempt, delayMs: tab.reconnectDelayMs, reason: '' };
+        case 'failed':
+            return { ...none, status: 'failed', reason: tab.error || 'Connection lost and could not be restored.' };
+        case 'exited':
+            return {
+                ...none,
+                status: 'failed',
+                reason: tab.exitCode === null ? 'Session ended.' : `Session ended — exit code ${tab.exitCode}.`
+            };
+        case 'live':
+            return tab.reattached ? { ...none, status: 'reconnected' } : none;
+        default:
+            return none;
+    }
+}
+/** Tab label host suffix and picker label for a host. */
+export function terminalHostLabel(host, hostId) {
+    if (!host)
+        return hostId;
+    return host.local ? `This machine — ${host.name}` : host.name;
+}
+export class TerminalHostWorkspaceController {
+    #options;
+    #hosts = [];
+    #tabs = [];
+    #runtime = new Map();
+    #activeKey = '';
+    #pickerOpen = true;
+    #requestedHostUnavailable = false;
+    #pickerHostId = '';
+    #pickerCommand = '';
+    #nextKey = 0;
+    #disposed = false;
+    #listeners = new Set();
+    #snapshot;
+    constructor(options) {
+        this.#options = options;
+        this.#snapshot = this.#build();
+    }
+    get snapshot() {
+        return this.#snapshot;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /** The latest reachable hosts (labels for new tabs). */
+    setHosts(hosts) {
+        this.#hosts = hosts;
+    }
+    /** Resolve the deep link once: open on the initial host, or show the picker. */
+    start(input) {
+        this.#hosts = input.hosts;
+        const requested = input.initialHostId?.trim() ?? '';
+        const known = requested ? input.hosts.some((host) => host.id === requested) : false;
+        this.#requestedHostUnavailable = Boolean(requested) && !known;
+        this.#pickerHostId = known ? requested : (input.hosts[0]?.id ?? '');
+        this.#pickerCommand = input.initialCommand ?? '';
+        const canAutoOpen = input.autoOpen === true &&
+            !this.#requestedHostUnavailable &&
+            !this.#pickerCommand &&
+            this.#pickerHostId !== '';
+        if (canAutoOpen)
+            this.open(this.#pickerHostId);
+        else
+            this.#emit();
+    }
+    /** Create a tab on `hostId`. The session opens once its terminal reports a grid. */
+    open(hostId, command) {
+        const key = `tab-${++this.#nextKey}`;
+        const host = this.#hosts.find((candidate) => candidate.id === hostId);
+        this.#tabs = [
+            ...this.#tabs,
+            {
+                key,
+                sessionId: null,
+                hostId,
+                hostLabel: terminalHostLabel(host, hostId),
+                command: command?.trim() ? command.trim() : undefined,
+                readonly: this.#options.readonly === true,
+                status: 'opening',
+                session: null,
+                inputReady: false,
+                exitCode: null,
+                error: '',
+                failure: null,
+                reconnectAttempt: 0,
+                reconnectDelayMs: 0,
+                reattached: false
+            }
+        ];
+        this.#runtime.set(key, { controller: null, requested: false, reattachTimer: null });
+        this.#activeKey = key;
+        this.#pickerOpen = false;
+        this.#requestedHostUnavailable = false;
+        this.#emit();
+        return key;
+    }
+    /** `<Terminal onReady>` for a tab: start the session at the fitted grid. */
+    terminalReady(key, dims) {
+        const tab = this.#tab(key);
+        const runtime = this.#runtime.get(key);
+        if (!tab || !runtime || runtime.requested || tab.status !== 'opening')
+            return;
+        runtime.requested = true;
+        void this.#openSession(key, tab, runtime, dims);
+    }
+    /** Retry a failed tab in place (same host + command, new session). */
+    retry(key, dims) {
+        const tab = this.#tab(key);
+        const runtime = this.#runtime.get(key);
+        if (!tab || !runtime || tab.status !== 'failed')
+            return;
+        tab.session?.kill();
+        this.#patch(key, { status: 'opening', session: null, sessionId: null, error: '', inputReady: false });
+        runtime.requested = false;
+        this.terminalReady(key, dims);
+    }
+    inputReady(key) {
+        const tab = this.#tab(key);
+        if (tab && !tab.inputReady && tab.session)
+            this.#patch(key, { inputReady: true });
+    }
+    exited(key, exitCode) {
+        const tab = this.#tab(key);
+        if (!tab || tab.status === 'exited')
+            return;
+        this.#patch(key, { status: 'exited', exitCode, inputReady: false, reattached: false });
+    }
+    disconnected(key, reason) {
+        const tab = this.#tab(key);
+        if (!tab || tab.status === 'exited')
+            return;
+        this.#patch(key, {
+            status: 'failed',
+            inputReady: false,
+            reattached: false,
+            error: reason ? `Connection lost — ${reason}` : 'Connection lost and could not be restored.'
+        });
+    }
+    select(key) {
+        if (!this.#tab(key))
+            return;
+        this.#activeKey = key;
+        this.#pickerOpen = false;
+        this.#emit();
+    }
+    /** Close a tab: abort an in-flight open, end a live session. */
+    close(key) {
+        const tab = this.#tab(key);
+        if (!tab)
+            return;
+        this.#release(key, tab);
+        const index = this.#tabs.findIndex((candidate) => candidate.key === key);
+        this.#tabs = this.#tabs.filter((candidate) => candidate.key !== key);
+        if (this.#activeKey === key) {
+            this.#activeKey = this.#tabs[Math.min(index, this.#tabs.length - 1)]?.key ?? '';
+        }
+        if (this.#tabs.length === 0)
+            this.#pickerOpen = true;
+        this.#emit();
+    }
+    showPicker() {
+        this.#pickerOpen = true;
+        this.#emit();
+    }
+    /** Dismiss the picker (only when a tab can be shown behind it). */
+    hidePicker() {
+        if (this.#tabs.length === 0)
+            return;
+        this.#pickerOpen = false;
+        this.#emit();
+    }
+    /** Unmount: abort opens and end every session this workspace started. */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        for (const tab of this.#tabs)
+            this.#release(tab.key, tab);
+        this.#listeners.clear();
+    }
+    async #openSession(key, tab, runtime, dims) {
+        const controller = new AbortController();
+        runtime.controller = controller;
+        const live = () => !this.#disposed && !controller.signal.aborted && this.#tab(key) !== undefined;
+        const outcome = await this.#options
+            .openSession({
+            hostId: tab.hostId,
+            command: tab.command,
+            cols: dims.cols,
+            rows: dims.rows,
+            signal: controller.signal,
+            reconnect: {
+                onReconnecting: (attempt, delayMs) => {
+                    if (!live())
+                        return;
+                    this.#clearReattached(runtime);
+                    this.#patch(key, {
+                        status: 'reconnecting',
+                        reconnectAttempt: attempt,
+                        reconnectDelayMs: delayMs,
+                        reattached: false
+                    });
+                },
+                onReconnected: () => {
+                    if (!live())
+                        return;
+                    this.#patch(key, { status: 'live', reconnectAttempt: 0, reconnectDelayMs: 0, reattached: true });
+                    this.#clearReattached(runtime);
+                    runtime.reattachTimer = setTimeout(() => {
+                        runtime.reattachTimer = null;
+                        if (this.#tab(key))
+                            this.#patch(key, { reattached: false });
+                    }, this.#options.reattachedNoticeMs ?? 3000);
+                }
+            }
+        })
+            .then((opened) => ({ kind: 'opened', opened }), (cause) => ({ kind: 'failure', failure: CapabilityError.from(CaughtFailureSchema.parse(cause)) }));
+        if (runtime.controller === controller)
+            runtime.controller = null;
+        if (outcome.kind === 'opened' && !live()) {
+            outcome.opened.session.kill();
+            return;
+        }
+        if (!live())
+            return;
+        if (outcome.kind === 'failure') {
+            const describe = this.#options.describeError ?? describeTerminalHostFailure;
+            this.#patch(key, { status: 'failed', failure: outcome.failure, error: describe(outcome.failure, tab.hostLabel) });
+            return;
+        }
+        this.#patch(key, { status: 'live', session: outcome.opened.session, sessionId: outcome.opened.id });
+        void outcome.opened.session.exited().then((result) => this.exited(key, result.exitCode), (cause) => this.#lost(key, CapabilityError.from(CaughtFailureSchema.parse(cause))));
+    }
+    /** The session's exit wait failed: the transport is gone and could not reconnect. */
+    #lost(key, failure) {
+        const tab = this.#tab(key);
+        if (!tab || tab.status === 'exited')
+            return;
+        this.#patch(key, {
+            status: 'failed',
+            inputReady: false,
+            reattached: false,
+            failure,
+            error: 'Connection lost and could not be restored.'
+        });
+    }
+    #release(key, tab) {
+        const runtime = this.#runtime.get(key);
+        if (runtime) {
+            runtime.controller?.abort();
+            runtime.controller = null;
+            this.#clearReattached(runtime);
+        }
+        this.#runtime.delete(key);
+        if (tab.session && tab.status !== 'exited')
+            tab.session.kill();
+    }
+    #clearReattached(runtime) {
+        if (runtime.reattachTimer !== null) {
+            clearTimeout(runtime.reattachTimer);
+            runtime.reattachTimer = null;
+        }
+    }
+    #tab(key) {
+        return this.#tabs.find((tab) => tab.key === key);
+    }
+    #patch(key, patch) {
+        if (this.#disposed)
+            return;
+        this.#tabs = this.#tabs.map((tab) => (tab.key === key ? { ...tab, ...patch } : tab));
+        this.#emit();
+    }
+    #build() {
+        return {
+            tabs: this.#tabs,
+            activeKey: this.#activeKey,
+            pickerOpen: this.#pickerOpen,
+            requestedHostUnavailable: this.#requestedHostUnavailable,
+            pickerHostId: this.#pickerHostId,
+            pickerCommand: this.#pickerCommand
+        };
+    }
+    #emit() {
+        if (this.#disposed)
+            return;
+        this.#snapshot = this.#build();
+        for (const listener of this.#listeners)
+            listener(this.#snapshot);
+    }
+}

package/dist/svelte/terminal-session-authority.d.ts

@@ -0,0 +1,17 @@
+export interface TerminalSessionLease<T> {
+    session: T;
+    generation: number;
+}
+/**
+ * Keeps async output/exit callbacks scoped to the session attachment that
+ * created them. Detaching invalidates every outstanding lease immediately.
+ */
+export declare class TerminalSessionAuthority<T> {
+    private generation;
+    private currentSession;
+    get current(): T | null;
+    attach(session: T): TerminalSessionLease<T>;
+    detach(session?: T): void;
+    isCurrent(lease: TerminalSessionLease<T>): boolean;
+}
+//# sourceMappingURL=terminal-session-authority.d.ts.map

package/dist/svelte/terminal-session-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-session-authority.d.ts","sourceRoot":"","sources":["../../src/svelte/terminal-session-authority.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAkB;IAExC,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,CAEtB;IAED,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC;IAM3C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI;IAMzB,SAAS,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO;CAGlD"}

package/dist/svelte/terminal-session-authority.js

@@ -0,0 +1,25 @@
+/**
+ * Keeps async output/exit callbacks scoped to the session attachment that
+ * created them. Detaching invalidates every outstanding lease immediately.
+ */
+export class TerminalSessionAuthority {
+    generation = 0;
+    currentSession = null;
+    get current() {
+        return this.currentSession;
+    }
+    attach(session) {
+        this.currentSession = session;
+        this.generation += 1;
+        return { session, generation: this.generation };
+    }
+    detach(session) {
+        if (session !== undefined && this.currentSession !== session)
+            return;
+        this.currentSession = null;
+        this.generation += 1;
+    }
+    isCurrent(lease) {
+        return this.currentSession === lease.session && this.generation === lease.generation;
+    }
+}

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

@@ -0,0 +1,21 @@
+/** Settles after every widget registration this module queued so far (none when Kit is absent). */
+export declare function toolWidgetsRegistered(): Promise<void>;
+/**
+ * Designed Kit card for `tools/tool:terminal`. Queued as `tools/ui` when the
+ * kind is not yet registered so docs-only hosts can still load this plugin.
+ */
+export declare const terminalSvelteWidgetDescriptor: {
+    id: string;
+    kind: "tools/ui";
+    name: string;
+    description: string;
+    surfaces: readonly ["web"];
+    role: "widget";
+    targetToolId: string;
+    targetId: string;
+    enabled: boolean;
+};
+export declare function registerTerminalSvelteToolWidget(): void;
+export declare const terminalSveltePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default terminalSveltePlugin;
+//# sourceMappingURL=terminal-svelte.plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-svelte.plugin.d.ts","sourceRoot":"","sources":["../../src/svelte/terminal-svelte.plugin.ts"],"names":[],"mappings":"AAcA,mGAAmG;AACnG,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;CAU1C,CAAC;AAEF,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAID,eAAO,MAAM,oBAAoB,6CAiB/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}