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

package/dist/svelte/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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 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 { 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,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,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,26 @@
+/**
+ * @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 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 { 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-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,19 @@
+/**
+ * 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":"AAQA;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;CAU1C,CAAC;AAEF,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAID,eAAO,MAAM,oBAAoB,6CAiB/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/svelte/terminal-svelte.plugin.js

@@ -0,0 +1,42 @@
+import { createRuntimeImplementation, createRuntimePlugin, loader, settle } from '@vibesdotdev/kernel';
+import terminalSvelteDocsDescriptor from "./docs/terminal-svelte.docs.descriptor.js";
+const loadTerminalToolCard = () => import('./tool-widgets/TerminalToolCard.svelte');
+const kitToolWidgets = await settle(() => import('@vibesdotdev/kit/components/tool-widgets'));
+const registerKitToolWidget = kitToolWidgets.ok ? kitToolWidgets.value.registerToolWidget : undefined;
+/**
+ * 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 const terminalSvelteWidgetDescriptor = {
+    id: 'terminal.svelte-widget',
+    kind: 'tools/ui',
+    name: 'Terminal Svelte Widget',
+    description: 'Renders terminal tool results: cwd, command/session, and an output excerpt.',
+    surfaces: ['web'],
+    role: 'widget',
+    targetToolId: 'terminal',
+    targetId: 'terminal',
+    enabled: true
+};
+export function registerTerminalSvelteToolWidget() {
+    registerKitToolWidget?.(terminalSvelteWidgetDescriptor.targetToolId, loadTerminalToolCard);
+}
+registerTerminalSvelteToolWidget();
+export const terminalSveltePlugin = createRuntimePlugin({
+    id: '@vibesdotdev/terminal-client/svelte',
+    name: 'Terminal Svelte',
+    description: 'Svelte terminal surfaces over runtime-resolved interactive execution sessions, including the designed terminal tool card.',
+    descriptors: [terminalSvelteDocsDescriptor, terminalSvelteWidgetDescriptor],
+    loaders: [
+        loader(terminalSvelteWidgetDescriptor.id, { kind: 'tools/ui', scope: 'browser' }, async () => {
+            registerTerminalSvelteToolWidget();
+            const module = await loadTerminalToolCard();
+            return createRuntimeImplementation({
+                kind: 'tools/ui',
+                id: terminalSvelteWidgetDescriptor.id,
+                implementation: { web: { component: module.default } }
+            });
+        })
+    ]
+});
+export default terminalSveltePlugin;

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

@@ -0,0 +1,11 @@
+import { type TerminalTheme } from './types.ts';
+interface TerminalAppearance {
+    theme: TerminalTheme;
+    fontFamily: string;
+}
+/** Resolve CSS through the browser: xterm cannot consume var() or oklch() itself. */
+export declare function readTerminalAppearance(host: HTMLElement): TerminalAppearance;
+/** Follow ancestor appearance, asynchronously loaded theme CSS, and font metrics. */
+export declare function observeTerminalAppearance(host: HTMLElement, refresh: () => void): () => void;
+export {};
+//# sourceMappingURL=terminal-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-theme.d.ts","sourceRoot":"","sources":["../../src/svelte/terminal-theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAoDtF,UAAU,kBAAkB;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAuB5E;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAkC5F"}

package/dist/svelte/terminal-theme.js

@@ -0,0 +1,116 @@
+import { normalizeVibesMonacoColor } from '@vibesdotdev/kit/components/code/monaco-theme.js';
+import { DEFAULT_FONT, DEFAULT_TERMINAL_THEME } from "./types.js";
+const tokens = {
+    background: '--background',
+    foreground: '--foreground',
+    cursor: '--ring',
+    cursorAccent: '--background',
+    selectionBackground: '--accent',
+    selectionForeground: '--accent-foreground',
+    black: '--background',
+    red: '--destructive',
+    green: '--success',
+    yellow: '--warning',
+    blue: '--info',
+    magenta: '--primary',
+    cyan: '--info',
+    white: '--foreground',
+    brightBlack: '--muted-foreground',
+    brightRed: '--destructive',
+    brightGreen: '--success',
+    brightYellow: '--warning',
+    brightBlue: '--info',
+    brightMagenta: '--primary',
+    brightCyan: '--info',
+    brightWhite: '--foreground'
+};
+const terminalThemeKeys = [
+    'background',
+    'foreground',
+    'cursor',
+    'cursorAccent',
+    'selectionBackground',
+    'selectionForeground',
+    'black',
+    'red',
+    'green',
+    'yellow',
+    'blue',
+    'magenta',
+    'cyan',
+    'white',
+    'brightBlack',
+    'brightRed',
+    'brightGreen',
+    'brightYellow',
+    'brightBlue',
+    'brightMagenta',
+    'brightCyan',
+    'brightWhite'
+];
+/** Resolve CSS through the browser: xterm cannot consume var() or oklch() itself. */
+export function readTerminalAppearance(host) {
+    const document = host.ownerDocument;
+    const view = document.defaultView;
+    if (!view)
+        return { theme: { ...DEFAULT_TERMINAL_THEME }, fontFamily: DEFAULT_FONT.family };
+    const probe = document.createElement('span');
+    probe.style.cssText =
+        'position:absolute;visibility:hidden;pointer-events:none;width:0;height:0;overflow:hidden';
+    probe.setAttribute('aria-hidden', 'true');
+    host.appendChild(probe);
+    try {
+        const theme = {};
+        for (const key of terminalThemeKeys) {
+            const terminalToken = key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+            probe.style.color = `var(--terminal-${terminalToken}, var(${tokens[key]}, ${DEFAULT_TERMINAL_THEME[key]}))`;
+            theme[key] =
+                normalizeVibesMonacoColor(view.getComputedStyle(probe).color, document) ??
+                    DEFAULT_TERMINAL_THEME[key];
+        }
+        probe.style.fontFamily = `var(--vibes-font-mono, var(--font-mono, ${DEFAULT_FONT.family}))`;
+        return { theme, fontFamily: view.getComputedStyle(probe).fontFamily };
+    }
+    finally {
+        probe.remove();
+    }
+}
+/** Follow ancestor appearance, asynchronously loaded theme CSS, and font metrics. */
+export function observeTerminalAppearance(host, refresh) {
+    const document = host.ownerDocument;
+    const view = document.defaultView;
+    if (!view)
+        return () => { };
+    let frame = null;
+    const schedule = () => {
+        if (frame !== null)
+            return;
+        frame = view.requestAnimationFrame(() => {
+            frame = null;
+            refresh();
+        });
+    };
+    const observer = new view.MutationObserver(schedule);
+    for (let element = host; element; element = element.parentElement) {
+        observer.observe(element, { attributes: true });
+    }
+    if (document.head)
+        observer.observe(document.head, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            characterData: true
+        });
+    const media = view.matchMedia('(prefers-color-scheme: dark)');
+    media.addEventListener('change', schedule);
+    document.addEventListener('load', schedule, true);
+    document.fonts?.addEventListener('loadingdone', schedule);
+    return () => {
+        observer.disconnect();
+        media.removeEventListener('change', schedule);
+        document.removeEventListener('load', schedule, true);
+        document.fonts?.removeEventListener('loadingdone', schedule);
+        if (frame !== null)
+            view.cancelAnimationFrame(frame);
+    };
+}

package/dist/svelte/tool-widgets/TerminalToolCard.svelte

@@ -0,0 +1,65 @@
+<script lang="ts">
+	/**
+	 * Designed Kit card for the `terminal` tool: cwd, command/session, and a
+	 * bounded output excerpt through CodeViewer.
+	 */
+	import { CodeViewer } from '@vibesdotdev/kit/components/code';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { presentTerminalToolCard } from './terminal-tool-card.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(presentTerminalToolCard(tool.input, tool.output));
+	const exitOk = $derived(view.exitCode === 0 || view.exitCode === null);
+</script>
+
+<ToolCard {tool} {compact} title={view.title} icon="lucide:terminal">
+	<ToolCardBody {compact}>
+		<div class="flex flex-wrap items-center gap-1.5">
+			{#if view.action}
+				<Badge variant="outline" class="text-caption">{view.action}</Badge>
+			{/if}
+			{#if view.sessionId}
+				<Badge variant="secondary" class="font-mono text-caption">{view.sessionId}</Badge>
+			{/if}
+			{#if view.exitCode !== null}
+				<Badge variant={exitOk ? 'secondary' : 'destructive'} class="text-caption">
+					exit {view.exitCode}
+				</Badge>
+			{/if}
+			{#if view.timedOut}
+				<Badge variant="warning" class="text-caption">timed out</Badge>
+			{/if}
+		</div>
+		{#if view.cwd}
+			<p class="truncate font-mono text-muted-foreground" data-terminal-cwd={view.cwd}>
+				cwd {view.cwd}
+			</p>
+		{/if}
+		{#if view.command}
+			<p class="truncate font-mono text-foreground" data-terminal-command={view.command}>
+				{view.command}
+			</p>
+		{/if}
+		{#if view.excerpt}
+			{#if view.truncated}
+				<p class="text-caption text-muted-foreground">Showing the tail of the output.</p>
+			{/if}
+			<CodeViewer
+				code={view.excerpt}
+				language="plaintext"
+				appearance="system"
+				maxHeight="16rem"
+				minHeight="0"
+				showLineNumbers={false}
+			/>
+		{:else if !tool.error}
+			<p class="text-muted-foreground italic">Running…</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/TerminalToolCard.svelte.d.ts

@@ -0,0 +1,5 @@
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const TerminalToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type TerminalToolCard = ReturnType<typeof TerminalToolCard>;
+export default TerminalToolCard;
+//# sourceMappingURL=TerminalToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/TerminalToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/TerminalToolCard.svelte.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAyDnD,QAAA,MAAM,gBAAgB,qDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/svelte/tool-widgets/terminal-tool-card.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Presentation for the `terminal` Kit ToolCard. Chat and other hosts map a
+ * tool call onto `{ input, output }`; this layer extracts cwd, command/session,
+ * and a bounded output excerpt for CodeViewer.
+ */
+export declare const TERMINAL_OUTPUT_EXCERPT_MAX_CHARS = 4000;
+export interface TerminalToolCardView {
+    title: string;
+    action: string;
+    cwd: string;
+    command: string;
+    sessionId: string;
+    excerpt: string;
+    truncated: boolean;
+    exitCode: number | null;
+    timedOut: boolean;
+}
+interface TerminalOutputExcerpt {
+    excerpt: string;
+    truncated: boolean;
+}
+export declare function excerptTerminalOutput(output: string, maxChars?: number): TerminalOutputExcerpt;
+export declare function presentTerminalToolCard<Input, Output>(input: Input, output: Output): TerminalToolCardView;
+export {};
+//# sourceMappingURL=terminal-tool-card.d.ts.map

package/dist/svelte/tool-widgets/terminal-tool-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-tool-card.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/terminal-tool-card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,qBAAqB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACnB;AAqED,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,SAAoC,GAC1C,qBAAqB,CAMvB;AAUD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EACpD,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,GACZ,oBAAoB,CAuBtB"}

package/dist/svelte/tool-widgets/terminal-tool-card.js

@@ -0,0 +1,116 @@
+/**
+ * Presentation for the `terminal` Kit ToolCard. Chat and other hosts map a
+ * tool call onto `{ input, output }`; this layer extracts cwd, command/session,
+ * and a bounded output excerpt for CodeViewer.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+export const TERMINAL_OUTPUT_EXCERPT_MAX_CHARS = 4_000;
+const NonEmptyStringSchema = z.string().min(1);
+const StringListSchema = z.array(NonEmptyStringSchema);
+const TerminalCardSessionSchema = z.object({
+    id: z.string().optional(),
+    command: z.string().optional(),
+    status: z.string().optional()
+}).passthrough();
+const TerminalCardRecordSchema = z.object({
+    action: z.string().optional(),
+    cwd: z.string().optional(),
+    command: z.union([z.string(), z.array(z.string())]).optional(),
+    args: z.array(z.string()).optional(),
+    sessionId: z.string().optional(),
+    text: z.string().optional(),
+    keys: z.array(z.string()).optional(),
+    output: z.string().optional(),
+    stdout: z.string().optional(),
+    sessions: z.array(TerminalCardSessionSchema).optional(),
+    exitCode: z.number().finite().nullable().optional(),
+    timedOut: z.boolean().optional()
+}).passthrough();
+function parseRecord(value) {
+    try {
+        const parsed = TerminalCardRecordSchema.safeParse(value);
+        return parsed.success ? parsed.data : null;
+    }
+    catch (cause) {
+        throw new CapabilityError('The terminal tool card data is unreadable.', 'INVALID_INPUT', {
+            reason: 'terminal-tool-card-data-invalid',
+            retryable: false,
+            cause
+        });
+    }
+}
+function nonEmptyStrings(values) {
+    if (values === undefined)
+        return [];
+    const parsed = StringListSchema.safeParse(values);
+    return parsed.success ? parsed.data : [];
+}
+function joinCommand(command, args) {
+    if (Array.isArray(command))
+        return nonEmptyStrings(command).join(' ');
+    const base = command ?? '';
+    const extra = nonEmptyStrings(args);
+    if (base && extra.length > 0)
+        return [base, ...extra].join(' ');
+    if (base)
+        return base;
+    return extra.join(' ');
+}
+function commandFrom(input, output) {
+    const fromFields = joinCommand(input?.command ?? output?.command, input?.args);
+    if (fromFields)
+        return fromFields;
+    if (input?.text)
+        return input.text;
+    return nonEmptyStrings(input?.keys).join(' ');
+}
+function formatSessions(sessions) {
+    if (sessions === undefined)
+        return '';
+    return sessions
+        .map((row) => [row.status, row.id, row.command].filter(Boolean).join('  '))
+        .filter(Boolean)
+        .join('\n');
+}
+export function excerptTerminalOutput(output, maxChars = TERMINAL_OUTPUT_EXCERPT_MAX_CHARS) {
+    if (output.length <= maxChars)
+        return { excerpt: output, truncated: false };
+    let slice = output.slice(output.length - maxChars);
+    const newline = slice.indexOf('\n');
+    if (newline >= 0 && newline < slice.length - 1)
+        slice = slice.slice(newline + 1);
+    return { excerpt: slice, truncated: true };
+}
+function excerptFrom(output) {
+    const stream = output?.output || output?.stdout || '';
+    if (stream)
+        return excerptTerminalOutput(stream);
+    const sessions = formatSessions(output?.sessions);
+    if (sessions)
+        return excerptTerminalOutput(sessions);
+    return { excerpt: '', truncated: false };
+}
+export function presentTerminalToolCard(input, output) {
+    const inRecord = parseRecord(input);
+    const outRecord = parseRecord(output);
+    const action = outRecord?.action || inRecord?.action || '';
+    const cwd = inRecord?.cwd || outRecord?.cwd || '';
+    const command = commandFrom(inRecord, outRecord);
+    const sessionId = outRecord?.sessionId || inRecord?.sessionId || '';
+    const { excerpt, truncated } = excerptFrom(outRecord);
+    const exitCode = outRecord?.exitCode ?? null;
+    const timedOut = outRecord?.timedOut === true;
+    const title = command || (sessionId ? `Session ${sessionId}` : '') || (action ? `Terminal ${action}` : 'Terminal');
+    return {
+        title,
+        action,
+        cwd,
+        command,
+        sessionId,
+        excerpt,
+        truncated,
+        exitCode,
+        timedOut
+    };
+}