@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.4

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

@@ -0,0 +1,97 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `workspace-exec`: remote command, exit, stdout/stderr.
+	 */
+	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 * as z from 'zod/v4';
+	import { readCardPayload, readPayloadValues } from './payload.js';
+	import { toolEmptyCopy } from './empty-state.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const WorkspaceExecInputFields = {
+		workspaceId: z.string(),
+		command: z.string(),
+		args: z.unknown(),
+		cwd: z.string()
+	};
+	const WorkspaceExecOutputFields = {
+		exitCode: z.number(),
+		stdout: z.string(),
+		stderr: z.string(),
+		timedOut: z.boolean()
+	};
+
+	const input = $derived(readCardPayload(WorkspaceExecInputFields, tool.input));
+	const output = $derived(readCardPayload(WorkspaceExecOutputFields, tool.output));
+	const workspaceId = $derived(input.get('workspaceId') ?? '');
+	const command = $derived.by(() => {
+		const cmd = input.get('command') ?? '';
+		const extra = readPayloadValues(z.string(), input.get('args')).join(' ');
+		return extra ? `${cmd} ${extra}` : cmd;
+	});
+	const cwd = $derived(input.get('cwd') ?? '');
+	const exitCode = $derived(output.get('exitCode') ?? null);
+	const stdout = $derived(output.get('stdout') ?? '');
+	const stderr = $derived(output.get('stderr') ?? '');
+	const timedOut = $derived(output.get('timedOut') === true);
+	const ok = $derived(exitCode === 0 || exitCode === null);
+	const hasContent = $derived(Boolean(stdout || stderr || exitCode !== null));
+	const emptyCopy = $derived(
+		hasContent ? null : toolEmptyCopy(tool.status, tool.error != null && tool.error !== '')
+	);
+</script>
+
+<ToolCard {tool} {compact} title={command || 'Workspace exec'} icon="lucide:terminal">
+	<ToolCardBody {compact}>
+		<div class="flex flex-wrap items-center gap-1.5">
+			{#if workspaceId}
+				<Badge variant="outline" class="font-mono text-caption">{workspaceId}</Badge>
+			{/if}
+			{#if cwd}
+				<Badge variant="outline" class="text-caption">{cwd}</Badge>
+			{/if}
+			{#if timedOut}
+				<Badge variant="warning" class="text-caption">timed out</Badge>
+			{:else if exitCode !== null}
+				<Badge variant={ok ? 'secondary' : 'destructive'} class="text-caption">
+					exit {exitCode}
+				</Badge>
+			{/if}
+		</div>
+		{#if stdout}
+			<CodeViewer
+				code={stdout}
+				language="plaintext"
+				appearance="system"
+				maxHeight="16rem"
+				minHeight="0"
+				showLineNumbers={false}
+			/>
+		{/if}
+		{#if stderr}
+			<div>
+				<div class="mb-1 text-caption font-medium tracking-wider text-muted-foreground uppercase">
+					stderr
+				</div>
+				<CodeViewer
+					code={stderr}
+					language="plaintext"
+					appearance="system"
+					maxHeight="10rem"
+					minHeight="0"
+					showLineNumbers={false}
+				/>
+			</div>
+		{/if}
+		{#if emptyCopy}
+			<p class="text-muted-foreground italic">{emptyCopy}</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceExecToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/WorkspaceExecToolCard.svelte.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAqFnD,QAAA,MAAM,qBAAqB,qDAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

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

@@ -0,0 +1,156 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `workspace-fs`: list, read, and search results
+	 * rather than a JSON blob. A call the agent rewrote from a shell command
+	 * (`ls`, `cat`, `rg`) keeps that command as its title (`tool.title`).
+	 */
+	import { CodeViewer } from '@vibesdotdev/kit/components/code';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import * as z from 'zod/v4';
+	import { readCardPayload, readCardPayloadList, readPayloadValues } from './payload.js';
+	import { toolEmptyCopy } from './empty-state.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const WorkspaceFsInputFields = { action: z.string(), path: z.string() };
+	const WorkspaceFsOutputFields = {
+		path: z.string(),
+		entries: z.unknown(),
+		matches: z.array(z.unknown()),
+		files: z.unknown(),
+		content: z.string(),
+		preview: z.string()
+	};
+	const FsEntryFields = { path: z.string(), type: z.string() };
+	const FsMatchFields = { file: z.string(), match: z.string(), content: z.string(), line: z.number() };
+
+	type Hit = { file: string; line?: number; content: string };
+	// A file hit is a bare path, or an object naming a non-empty `path`.
+	const FsFileHitSchema = z.union([
+		z.string().transform((file): Hit | null => ({ file, content: file })),
+		z.object({ path: z.string() }).transform(({ path: file }): Hit | null => (file ? { file, content: file } : null))
+	]);
+
+	const input = $derived(readCardPayload(WorkspaceFsInputFields, tool.input));
+	const output = $derived(readCardPayload(WorkspaceFsOutputFields, tool.output));
+	const action = $derived(input.get('action') ?? '');
+	const path = $derived(output.get('path') || input.get('path') || '');
+
+	type Entry = { path: string; type?: string };
+	const entries = $derived.by<Entry[]>(() => {
+		return readCardPayloadList(FsEntryFields, output.get('entries'))
+			.map((row): Entry | null => {
+				const entryPath = row.get('path') ?? '';
+				if (!entryPath) return null;
+				return { path: entryPath, type: row.get('type') };
+			})
+			.filter((item): item is Entry => item !== null);
+	});
+
+	const hits = $derived.by<Hit[]>(() => {
+		const matches = output.get('matches');
+		if (matches !== undefined) {
+			return readCardPayloadList(FsMatchFields, matches)
+				.map((row): Hit | null => {
+					const file = row.get('file') ?? '';
+					const content = row.get('match') || row.get('content') || '';
+					if (!file && !content) return null;
+					return { file, line: row.get('line'), content };
+				})
+				.filter((item): item is Hit => item !== null);
+		}
+		return readPayloadValues(FsFileHitSchema, output.get('files')).filter(
+			(item): item is Hit => item !== null
+		);
+	});
+
+	const content = $derived(output.get('content') ?? output.get('preview') ?? '');
+
+	const known = $derived(
+		action === 'list' ||
+			action === 'read' ||
+			action === 'search' ||
+			action === 'write' ||
+			action === 'edit' ||
+			action === 'delete'
+	);
+	const hasError = $derived(tool.error != null && tool.error !== '');
+	const listEmpty = $derived(toolEmptyCopy(tool.status, hasError, 'Empty directory.'));
+	const searchEmpty = $derived(toolEmptyCopy(tool.status, hasError, 'No matches.'));
+	const writeEmpty = $derived(
+		toolEmptyCopy(tool.status, hasError, path || 'Workspace file updated.')
+	);
+</script>
+
+{#if !known}
+	<ToolCard {tool} {compact} title={action || 'Workspace files'} icon="lucide:folder">
+		<ToolCardBody {compact}>
+			{#if action}
+				<Badge variant="outline" class="text-caption">{action}</Badge>
+				<p class="text-muted-foreground">This file action has no specialized preview.</p>
+			{:else if !tool.error}
+				<p class="text-muted-foreground">No file action was provided.</p>
+			{/if}
+		</ToolCardBody>
+	</ToolCard>
+{:else}
+	<ToolCard {tool} {compact} title={tool.title ?? (path || action || 'Workspace files')} icon="lucide:folder">
+		<ToolCardBody {compact}>
+			{#if action}
+				<Badge variant="outline" class="text-caption">{action}</Badge>
+			{/if}
+
+			{#if action === 'list'}
+				<ul class="space-y-0.5">
+					{#each entries as entry (entry.path)}
+						<li class="flex items-center gap-1.5 font-mono text-caption">
+							<Icon
+								icon={entry.type === 'directory' ? 'lucide:folder' : 'lucide:file'}
+								class="size-3 shrink-0 text-muted-foreground"
+							/>
+							<span class="truncate">{entry.path}</span>
+						</li>
+					{/each}
+				</ul>
+				{#if entries.length === 0 && listEmpty}
+					<p class="text-muted-foreground italic">{listEmpty}</p>
+				{/if}
+			{:else if action === 'read' && content}
+				<CodeViewer
+					code={content}
+					filename={path || undefined}
+					language="auto"
+					appearance="system"
+					maxHeight="20rem"
+					minHeight="0"
+					showLineNumbers
+				/>
+			{:else if action === 'search'}
+				<ul class="space-y-2">
+					{#each hits as hit, i (i)}
+						<li>
+							<div class="mb-0.5 font-mono text-caption text-muted-foreground">
+								{hit.file}{hit.line ? `:${hit.line}` : ''}
+							</div>
+							{#if hit.content && hit.content !== hit.file}
+								<pre
+									class="overflow-x-auto rounded-md bg-background/70 p-2 font-mono text-caption leading-relaxed ring-1 ring-border/40 ring-inset">{hit.content}</pre>
+							{/if}
+						</li>
+					{/each}
+				</ul>
+				{#if hits.length === 0 && searchEmpty}
+					<p class="text-muted-foreground italic">{searchEmpty}</p>
+				{/if}
+			{:else if writeEmpty}
+				<p class="text-muted-foreground">{writeEmpty}</p>
+			{/if}
+		</ToolCardBody>
+	</ToolCard>
+{/if}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceFsToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/WorkspaceFsToolCard.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAgJnD,QAAA,MAAM,mBAAmB,qDAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,123 @@
+<script lang="ts">
+	/**
+	 * Family widget for `workspace-create`, `workspace-destroy`, and `workspace-status`.
+	 */
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import * as z from 'zod/v4';
+	import { externalHref } from './external-href.js';
+	import { readCardPayload } from './payload.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	function formatTtl(seconds: number): string {
+		if (seconds <= 0) return 'due';
+		if (seconds < 60) return `${seconds}s`;
+		if (seconds < 3600) return `${Math.round(seconds / 60)}m`;
+		return `${Math.round(seconds / 3600)}h`;
+	}
+
+	const WorkspaceHostInputFields = {
+		workspaceId: z.string(),
+		name: z.string(),
+		region: z.string(),
+		repo: z.string(),
+		branch: z.string()
+	};
+	const WorkspaceHostOutputFields = {
+		workspaceId: z.string(),
+		status: z.string(),
+		ip: z.string(),
+		region: z.string(),
+		terminalUrl: z.string(),
+		editorUrl: z.string(),
+		cpu: z.number(),
+		ram: z.number(),
+		ttl: z.number(),
+		ok: z.boolean()
+	};
+
+	const input = $derived(readCardPayload(WorkspaceHostInputFields, tool.input));
+	const output = $derived(readCardPayload(WorkspaceHostOutputFields, tool.output));
+	const action = $derived(tool.name.replace(/^workspace-/, '') || 'workspace');
+	const workspaceId = $derived(
+		output.get('workspaceId') || input.get('workspaceId') || input.get('name') || ''
+	);
+	const status = $derived(output.get('status') ?? '');
+	const ip = $derived(output.get('ip') ?? '');
+	const region = $derived(output.get('region') || input.get('region') || '');
+	const repo = $derived(input.get('repo') ?? '');
+	const branch = $derived(input.get('branch') ?? '');
+	// A scripting-scheme URL from tool output is never linked (see external-href.ts).
+	const terminalUrl = $derived(externalHref(output.get('terminalUrl') ?? ''));
+	const editorUrl = $derived(externalHref(output.get('editorUrl') ?? ''));
+	const cpu = $derived(output.get('cpu') ?? null);
+	const ram = $derived(output.get('ram') ?? null);
+	const ttl = $derived(output.get('ttl') ?? null);
+	const ok = $derived(output.get('ok') === true);
+	const failed = $derived(output.get('ok') === false);
+	const title = $derived(workspaceId ? `${action} ${workspaceId}` : `Workspace ${action}`);
+</script>
+
+<ToolCard {tool} {compact} {title} icon="lucide:cloud">
+	<ToolCardBody {compact}>
+		<div class="flex flex-wrap items-center gap-1.5">
+			<Badge variant="outline" class="text-caption">{action}</Badge>
+			{#if status}
+				<Badge variant="secondary" class="text-caption">{status}</Badge>
+			{/if}
+			{#if ok}
+				<Badge variant="success" class="text-caption">destroyed</Badge>
+			{:else if failed}
+				<Badge variant="destructive" class="text-caption">failed</Badge>
+			{/if}
+			{#if region}
+				<Badge variant="outline" class="text-caption">{region}</Badge>
+			{/if}
+			{#if ttl !== null}
+				<Badge variant={ttl === 0 ? 'warning' : 'outline'} class="text-caption">
+					ttl {formatTtl(ttl)}
+				</Badge>
+			{/if}
+		</div>
+		{#if ip || cpu !== null || ram !== null}
+			<p class="text-muted-foreground">
+				{#if ip}{ip}{/if}
+				{#if cpu !== null}{ip ? ' · ' : ''}{cpu} cores{/if}
+				{#if ram !== null}{ip || cpu !== null ? ' · ' : ''}{ram} MB{/if}
+			</p>
+		{/if}
+		{#if repo}
+			<p class="truncate font-mono text-caption text-muted-foreground">
+				{repo}{branch ? `@${branch}` : ''}
+			</p>
+		{/if}
+		{#if terminalUrl}
+			<a
+				href={terminalUrl}
+				target="_blank"
+				rel="noopener noreferrer"
+				class="flex items-center gap-1.5 text-xs font-medium hover:underline"
+			>
+				<Icon icon="lucide:terminal" class="size-3 shrink-0 text-muted-foreground" />
+				<span class="truncate">Terminal</span>
+			</a>
+		{/if}
+		{#if editorUrl}
+			<a
+				href={editorUrl}
+				target="_blank"
+				rel="noopener noreferrer"
+				class="flex items-center gap-1.5 text-xs font-medium hover:underline"
+			>
+				<Icon icon="lucide:code" class="size-3 shrink-0 text-muted-foreground" />
+				<span class="truncate">Editor</span>
+			</a>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceHostToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/WorkspaceHostToolCard.svelte.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAmHnD,QAAA,MAAM,qBAAqB,qDAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

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

@@ -0,0 +1,92 @@
+<script lang="ts">
+	/**
+	 * Bespoke widget for the `workspace-search` (code atlas) tool — renders the
+	 * match list (location · code snippet · kind) instead of raw JSON. Composes
+	 * the kit's `ToolCard` shell to stay aligned with every other tool card.
+	 *
+	 * Search-only fallback: editor owns the full Atlas card. Search-kind calls
+	 * never dump blobs here; non-search Atlas actions with real content still
+	 * remain readable context cards until the editor card loads.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { workspaceSearchFallbackView } from './workspace-search-fallback.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(workspaceSearchFallbackView(tool));
+</script>
+
+{#if view.kind === 'hits'}
+	<ToolCard {tool} {compact}>
+		{#snippet children()}
+			<ToolCardBody {compact}>
+				<ul class="space-y-2">
+					{#each view.hits as r, i (i)}
+						<li class="min-w-0">
+							{#if r.location || r.type}
+								<div class="mb-0.5 flex items-center gap-1.5">
+									{#if r.location}
+										<span class="truncate font-mono text-caption text-muted-foreground"
+											>{r.location}</span
+										>
+									{/if}
+									{#if r.type}
+										<Badge variant="outline" class="shrink-0 text-caption">{r.type}</Badge>
+									{/if}
+								</div>
+							{/if}
+							<pre
+								class="overflow-x-auto rounded-md bg-background/70 p-2 font-mono text-caption leading-relaxed ring-1 ring-border/40 ring-inset">{r.content}</pre>
+						</li>
+					{/each}
+				</ul>
+			</ToolCardBody>
+		{/snippet}
+	</ToolCard>
+{:else if view.kind === 'search'}
+	<ToolCard {tool} {compact}>
+		{#snippet children()}
+			<ToolCardBody {compact}>
+				{#if view.query || view.mode}
+					<div class="flex flex-wrap items-center gap-1.5">
+						{#if view.query}
+							<span class="truncate font-mono text-caption text-muted-foreground"
+								>“{view.query}”</span
+							>
+						{/if}
+						{#if view.mode}
+							<Badge variant="outline" class="shrink-0 text-caption">{view.mode}</Badge>
+						{/if}
+					</div>
+				{/if}
+				{#if view.empty}
+					<p class="text-xs text-muted-foreground italic">{view.empty}</p>
+				{/if}
+			</ToolCardBody>
+		{/snippet}
+	</ToolCard>
+{:else if view.kind === 'failed'}
+	<ToolCard {tool} {compact}>
+		{#snippet children()}
+			<ToolCardBody {compact} class="flex flex-wrap items-center gap-1.5">
+				<Badge variant="outline" class="shrink-0 text-caption">{view.action}</Badge>
+			</ToolCardBody>
+		{/snippet}
+	</ToolCard>
+{:else}
+	<ToolCard {tool} {compact} title={view.action || 'Workspace search'} icon="lucide:search-code">
+		<ToolCardBody {compact}>
+			{#if view.action}
+				<Badge variant="outline" class="text-caption">{view.action}</Badge>
+			{/if}
+			<p class="text-muted-foreground">
+				The detailed Atlas preview is loading from the Editor feature.
+			</p>
+		</ToolCardBody>
+	</ToolCard>
+{/if}

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

@@ -0,0 +1,14 @@
+/**
+     * Bespoke widget for the `workspace-search` (code atlas) tool — renders the
+     * match list (location · code snippet · kind) instead of raw JSON. Composes
+     * the kit's `ToolCard` shell to stay aligned with every other tool card.
+     *
+     * Search-only fallback: editor owns the full Atlas card. Search-kind calls
+     * never dump blobs here; non-search Atlas actions with real content still
+     * remain readable context cards until the editor card loads.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const WorkspaceSearchToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type WorkspaceSearchToolCard = ReturnType<typeof WorkspaceSearchToolCard>;
+export default WorkspaceSearchToolCard;
+//# sourceMappingURL=WorkspaceSearchToolCard.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSearchToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/WorkspaceSearchToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;OAQI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAkFnD,QAAA,MAAM,uBAAuB,qDAAwC,CAAC;AACtE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC1E,eAAe,uBAAuB,CAAC"}

package/dist/svelte/tool-widgets/empty-state.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared empty-state copy for first-party tool cards.
+ *
+ * A card with no renderable content must name its actual state: only a live
+ * call says "Running…". A completed (or phantom-completed) card that says
+ * "Running…" reads as stuck work; a failed call already shows its error in the
+ * ToolCard chrome, so the body stays quiet.
+ */
+/** Statuses that mean the call is still in flight (mirrors ToolCard). */
+export declare function isLiveToolStatus(status: string | undefined): boolean;
+/**
+ * Body copy for a contentless card, or null when the body should stay empty
+ * (failed calls surface `tool.error` through the shared chrome instead).
+ * Callers with a more specific settled-empty line (e.g. "Empty directory.")
+ * pass it as `completedText`.
+ */
+export declare function toolEmptyCopy(status: string | undefined, hasError: boolean, completedText?: string): string | null;
+//# sourceMappingURL=empty-state.d.ts.map

package/dist/svelte/tool-widgets/empty-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/empty-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,OAAO,EACjB,aAAa,SAAe,GAC1B,MAAM,GAAG,IAAI,CAIf"}

package/dist/svelte/tool-widgets/empty-state.js

@@ -0,0 +1,26 @@
+/**
+ * Shared empty-state copy for first-party tool cards.
+ *
+ * A card with no renderable content must name its actual state: only a live
+ * call says "Running…". A completed (or phantom-completed) card that says
+ * "Running…" reads as stuck work; a failed call already shows its error in the
+ * ToolCard chrome, so the body stays quiet.
+ */
+/** Statuses that mean the call is still in flight (mirrors ToolCard). */
+export function isLiveToolStatus(status) {
+    const s = status ?? 'completed';
+    return s === 'running' || s === 'pending' || s === 'streaming';
+}
+/**
+ * Body copy for a contentless card, or null when the body should stay empty
+ * (failed calls surface `tool.error` through the shared chrome instead).
+ * Callers with a more specific settled-empty line (e.g. "Empty directory.")
+ * pass it as `completedText`.
+ */
+export function toolEmptyCopy(status, hasError, completedText = 'No output.') {
+    if (isLiveToolStatus(status))
+        return 'Running…';
+    if (hasError)
+        return null;
+    return completedText;
+}

package/dist/svelte/tool-widgets/external-href.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Link targets a tool card takes from tool output.
+ *
+ * A card links to URLs the tool returned (a fetched page, a workspace terminal
+ * or editor). Svelte does not vet `href`, so an absolute URL with a scripting
+ * scheme (`javascript:`, `vbscript:`, `data:`) would run in the host page when
+ * clicked. Only `http:` and `https:` absolute URLs are linked; any other
+ * absolute scheme is refused (the card shows no link). A value that is not an
+ * absolute URL keeps the previous behaviour and is linked as given (it can
+ * carry no scheme of its own).
+ */
+/** The href to render for `value`, or `undefined` when it must not be linked. */
+export declare function externalHref(value: string): string | undefined;
+//# sourceMappingURL=external-href.d.ts.map

package/dist/svelte/tool-widgets/external-href.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-href.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/external-href.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D"}

package/dist/svelte/tool-widgets/external-href.js

@@ -0,0 +1,18 @@
+/**
+ * Link targets a tool card takes from tool output.
+ *
+ * A card links to URLs the tool returned (a fetched page, a workspace terminal
+ * or editor). Svelte does not vet `href`, so an absolute URL with a scripting
+ * scheme (`javascript:`, `vbscript:`, `data:`) would run in the host page when
+ * clicked. Only `http:` and `https:` absolute URLs are linked; any other
+ * absolute scheme is refused (the card shows no link). A value that is not an
+ * absolute URL keeps the previous behaviour and is linked as given (it can
+ * carry no scheme of its own).
+ */
+const LINKABLE_PROTOCOLS = new Set(['http:', 'https:']);
+/** The href to render for `value`, or `undefined` when it must not be linked. */
+export function externalHref(value) {
+    if (!URL.canParse(value))
+        return value;
+    return LINKABLE_PROTOCOLS.has(new URL(value).protocol) ? value : undefined;
+}

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

@@ -0,0 +1,5 @@
+export { createSvelteToolWidgetDescriptor, createSvelteToolWidgetLoader, registerSvelteToolWidget, type SvelteToolWidgetDescriptorOptions, type SvelteToolWidgetModule } from './runtime.ts';
+export { default as RunFeedbackPanel } from './RunFeedbackPanel.svelte';
+export { default as RunFeedbackInbox } from './RunFeedbackInbox.svelte';
+export { default as RunLogThread } from './RunLogThread.svelte';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,iCAAiC,EACtC,KAAK,sBAAsB,EAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/svelte/tool-widgets/index.js

@@ -0,0 +1,4 @@
+export { createSvelteToolWidgetDescriptor, createSvelteToolWidgetLoader, registerSvelteToolWidget } from "./runtime.js";
+export { default as RunFeedbackPanel } from './RunFeedbackPanel.svelte';
+export { default as RunFeedbackInbox } from './RunFeedbackInbox.svelte';
+export { default as RunLogThread } from './RunLogThread.svelte';