@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.3

package/dist/svelte/ui/help/HelpIcon.svelte

@@ -0,0 +1,83 @@
+<script lang="ts">
+	/**
+	 * <HelpIcon topic="…" /> — in-app help affordance.
+	 *
+	 * Resolves the topic from the Svelte context set by the consuming app's
+	 * layout (`setDocsTopics(topics)`). Clicking opens <HelpDialog />.
+	 */
+	import HelpDialog from './HelpDialog.svelte';
+
+	interface Props {
+		/** Topic id (e.g. 'tools.list'). Mutually exclusive with subject form. */
+		topic?: string;
+		/** Subject kind (e.g. 'tools/tool'). Pair with `id`. */
+		kind?: string;
+		/** Subject id (e.g. 'tools.list'). Pair with `kind`. */
+		id?: string;
+		/** Catalogued docs origin. When omitted, HelpDialog prefers `serviceOrigin(runtime, 'docs')` and otherwise the `docs.svelte` `publicOrigin` default. */
+		docsOrigin?: string;
+		/** Accessible label override. Defaults to "Help for <topic-or-subject>". */
+		label?: string;
+	}
+
+	const { topic, kind, id, docsOrigin, label }: Props = $props();
+	let open = $state(false);
+
+	const ariaLabel = $derived(
+		label ?? `Help for ${topic ?? (kind && id ? `${kind}:${id}` : 'this control')}`
+	);
+</script>
+
+<button
+	type="button"
+	class="help-icon"
+	aria-label={ariaLabel}
+	aria-haspopup="dialog"
+	onclick={(event) => {
+		// Help icons commonly nest inside clickable rows (sidebar entries,
+		// table rows). Open the dialog without bubbling the click to an
+		// enclosing anchor / button.
+		event.stopPropagation();
+		event.preventDefault();
+		open = true;
+	}}
+>
+	<svg
+		xmlns="http://www.w3.org/2000/svg"
+		width="16"
+		height="16"
+		viewBox="0 0 24 24"
+		fill="none"
+		stroke="currentColor"
+		stroke-width="2"
+		stroke-linecap="round"
+		stroke-linejoin="round"
+		aria-hidden="true"
+	>
+		<circle cx="12" cy="12" r="10" />
+		<path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" />
+		<line x1="12" y1="17" x2="12.01" y2="17" />
+	</svg>
+</button>
+
+<HelpDialog bind:open {topic} {kind} {id} {docsOrigin} />
+
+<style>
+	.help-icon {
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
+		width: 1.25rem;
+		height: 1.25rem;
+		border-radius: 9999px;
+		border: 1px solid var(--color-border, hsl(0 0% 90%));
+		background: var(--color-card, hsl(0 0% 99%));
+		color: var(--color-muted-foreground, hsl(220 13% 26%));
+		cursor: pointer;
+		padding: 0;
+	}
+	.help-icon:hover {
+		background: var(--color-muted, hsl(220 13% 91%));
+		color: var(--color-foreground, hsl(0 0% 7%));
+	}
+</style>

package/dist/svelte/ui/help/HelpIcon.svelte.d.ts

@@ -0,0 +1,16 @@
+interface Props {
+    /** Topic id (e.g. 'tools.list'). Mutually exclusive with subject form. */
+    topic?: string;
+    /** Subject kind (e.g. 'tools/tool'). Pair with `id`. */
+    kind?: string;
+    /** Subject id (e.g. 'tools.list'). Pair with `kind`. */
+    id?: string;
+    /** Catalogued docs origin. When omitted, HelpDialog prefers `serviceOrigin(runtime, 'docs')` and otherwise the `docs.svelte` `publicOrigin` default. */
+    docsOrigin?: string;
+    /** Accessible label override. Defaults to "Help for <topic-or-subject>". */
+    label?: string;
+}
+declare const HelpIcon: import("svelte").Component<Props, {}, "">;
+type HelpIcon = ReturnType<typeof HelpIcon>;
+export default HelpIcon;
+//# sourceMappingURL=HelpIcon.svelte.d.ts.map

package/dist/svelte/ui/help/HelpIcon.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpIcon.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/ui/help/HelpIcon.svelte.ts"],"names":[],"mappings":"AAYC,UAAU,KAAK;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wJAAwJ;IACxJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAmCF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/svelte/ui/markdown/CodeBlock.svelte

@@ -0,0 +1,125 @@
+<script lang="ts">
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { CodeViewer } from '@vibesdotdev/kit/components/code';
+
+	interface Props {
+		text: string;
+		lang?: string;
+	}
+
+	const { text, lang = '' }: Props = $props();
+
+	function normalizeLang(input: string): string {
+		const l = (input || '').trim().toLowerCase();
+		if (!l) return 'text';
+		switch (l) {
+			case 'bash':
+			case 'sh':
+			case 'console':
+				return 'shell';
+			case 'zsh':
+				return 'bash';
+			case 'yml':
+				return 'yaml';
+			case 'js':
+				return 'javascript';
+			case 'ts':
+				return 'typescript';
+			case 'md':
+				return 'markdown';
+			default:
+				return l;
+		}
+	}
+
+	const displayLang = $derived(normalizeLang(lang));
+	let copied = $state(false);
+
+	function copyCode() {
+		void navigator.clipboard.writeText(text).then(() => {
+			copied = true;
+			setTimeout(() => (copied = false), 1500);
+		});
+	}
+</script>
+
+<div class="code-block">
+	<div class="code-block__header">
+		<span class="code-block__lang">{displayLang}</span>
+		<button type="button" class="code-block__copy" onclick={copyCode} aria-label="Copy code">
+			{#if copied}
+				<Icon icon="lucide:check" size={14} aria-hidden="true" />
+				<span>Copied</span>
+			{:else}
+				<Icon icon="lucide:copy" size={14} aria-hidden="true" />
+				<span>Copy</span>
+			{/if}
+		</button>
+	</div>
+	<CodeViewer
+		code={text}
+		language={displayLang}
+		appearance="system"
+		minHeight="44px"
+		maxHeight="520px"
+		framed={false}
+	/>
+</div>
+
+<style>
+	.code-block {
+		position: relative;
+		margin: 1em 0;
+		border-radius: 0.625rem;
+		border: 1px solid var(--border, hsl(0 0% 90%));
+		background: var(--muted, hsl(220 13% 96%));
+		overflow: hidden;
+		font-size: 0.8125rem;
+	}
+
+	.code-block__header {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		padding: 0.375rem 0.75rem;
+		border-bottom: 1px solid var(--border, hsl(0 0% 90%));
+		background: color-mix(in oklab, var(--muted, hsl(220 13% 96%)) 70%, transparent);
+	}
+
+	.code-block__lang {
+			font-family: var(--font-mono, ui-monospace, monospace);
+			font-size: 0.6875rem;
+			text-transform: lowercase;
+			letter-spacing: 0;
+			color: var(--muted-foreground, hsl(220 13% 40%));
+		}
+
+	.code-block__copy {
+		display: inline-flex;
+		align-items: center;
+		gap: 0.25rem;
+		padding: 0.125rem 0.5rem;
+		border-radius: 0.375rem;
+		background: transparent;
+		border: 1px solid transparent;
+		color: var(--muted-foreground, hsl(220 13% 40%));
+		font-size: 0.6875rem;
+		font-family: inherit;
+		cursor: pointer;
+		transition: color 120ms, background 120ms, border-color 120ms;
+	}
+
+	.code-block__copy :global(svg) {
+		flex: 0 0 auto;
+	}
+
+	.code-block__copy:hover {
+		color: var(--foreground, hsl(220 13% 10%));
+		background: color-mix(in oklab, var(--foreground, black) 6%, transparent);
+		border-color: var(--border, hsl(0 0% 90%));
+	}
+
+	:global(.dark) .code-block {
+		background: color-mix(in oklab, var(--muted, hsl(220 13% 18%)) 70%, transparent);
+	}
+</style>

package/dist/svelte/ui/markdown/CodeBlock.svelte.d.ts

@@ -0,0 +1,8 @@
+interface Props {
+    text: string;
+    lang?: string;
+}
+declare const CodeBlock: import("svelte").Component<Props, {}, "">;
+type CodeBlock = ReturnType<typeof CodeBlock>;
+export default CodeBlock;
+//# sourceMappingURL=CodeBlock.svelte.d.ts.map

package/dist/svelte/ui/markdown/CodeBlock.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/ui/markdown/CodeBlock.svelte.ts"],"names":[],"mappings":"AAOC,UAAU,KAAK;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AA8DF,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/svelte/ui/markdown/MarkdownView.svelte

@@ -0,0 +1,319 @@
+<script lang="ts">
+	import type { Token, Tokens } from 'marked';
+	import type { ParsedTopic } from '@vibesdotdev/docs/render';
+	import { tokenToDirectiveNode } from '@vibesdotdev/docs/render';
+	import type { DirectiveNode } from '@vibesdotdev/docs/directives';
+	import DirectiveDispatch from '../directives/DirectiveDispatch.svelte';
+	import CodeBlock from './CodeBlock.svelte';
+
+	interface Props {
+		/** Parsed AST from `@vibesdotdev/docs`'s `parseMarkdown`. */
+		parsed: ParsedTopic;
+	}
+	const { parsed }: Props = $props();
+</script>
+
+{#snippet inline(tokens: Token[])}
+	{#each tokens as tok}
+		{#if tok.type === 'text'}{(tok as Tokens.Text).text}
+		{:else if tok.type === 'strong'}
+			<strong>{@render inline((tok as Tokens.Strong).tokens ?? [])}</strong>
+		{:else if tok.type === 'em'}
+			<em>{@render inline((tok as Tokens.Em).tokens ?? [])}</em>
+		{:else if tok.type === 'codespan'}
+			<code class="inline-code">{(tok as Tokens.Codespan).text}</code>
+		{:else if tok.type === 'link'}
+			{@const link = tok as Tokens.Link}
+			<a href={link.href}>{@render inline(link.tokens ?? [])}</a>
+		{:else if tok.type === 'del'}
+			<del>{@render inline((tok as Tokens.Del).tokens ?? [])}</del>
+		{:else if tok.type === 'br'}
+			<br />
+		{:else if tok.type === 'escape'}{(tok as Tokens.Escape).text}
+		{:else if tok.type === 'image'}
+			{@const img = tok as Tokens.Image}
+			<img src={img.href} alt={img.text} title={img.title ?? ''} />
+		{:else}{(tok as { raw?: string }).raw ?? ''}
+		{/if}
+	{/each}
+{/snippet}
+
+{#snippet blocks(tokens: Token[])}
+	{#each tokens as tok}
+		{#if tok.type === 'directive'}
+			{@const node = tokenToDirectiveNode(
+				tok as unknown as Parameters<typeof tokenToDirectiveNode>[0]
+			) as DirectiveNode | null}
+			{#if node}<DirectiveDispatch {node} />{/if}
+		{:else if tok.type === 'heading'}
+			{@const h = tok as Tokens.Heading}
+			{#if h.depth === 1}
+				<h1>{@render inline(h.tokens ?? [])}</h1>
+			{:else if h.depth === 2}
+				<h2>{@render inline(h.tokens ?? [])}</h2>
+			{:else if h.depth === 3}
+				<h3>{@render inline(h.tokens ?? [])}</h3>
+			{:else if h.depth === 4}
+				<h4>{@render inline(h.tokens ?? [])}</h4>
+			{:else if h.depth === 5}
+				<h5>{@render inline(h.tokens ?? [])}</h5>
+			{:else}
+				<h6>{@render inline(h.tokens ?? [])}</h6>
+			{/if}
+		{:else if tok.type === 'paragraph'}
+			<p>{@render inline((tok as Tokens.Paragraph).tokens ?? [])}</p>
+		{:else if tok.type === 'code'}
+			{@const c = tok as Tokens.Code}
+			<CodeBlock text={c.text} lang={c.lang ?? ''} />
+		{:else if tok.type === 'list'}
+			{@const list = tok as Tokens.List}
+			{#if list.ordered}
+				<ol>
+					{#each list.items as item}
+						<li>{@render blocks(item.tokens ?? [])}</li>
+					{/each}
+				</ol>
+			{:else}
+				<ul>
+					{#each list.items as item}
+						<li>{@render blocks(item.tokens ?? [])}</li>
+					{/each}
+				</ul>
+			{/if}
+		{:else if tok.type === 'blockquote'}
+			<blockquote>{@render blocks((tok as Tokens.Blockquote).tokens ?? [])}</blockquote>
+		{:else if tok.type === 'table'}
+			{@const table = tok as Tokens.Table}
+			<div class="table-wrap">
+				<table>
+					<thead>
+						<tr>
+							{#each table.header as cell, i}
+								<th style:text-align={table.align[i] ?? undefined}>
+									{@render inline(cell.tokens ?? [])}
+								</th>
+							{/each}
+						</tr>
+					</thead>
+					<tbody>
+						{#each table.rows as row}
+							<tr>
+								{#each row as cell, i}
+									<td style:text-align={table.align[i] ?? undefined}>
+										{@render inline(cell.tokens ?? [])}
+									</td>
+								{/each}
+							</tr>
+						{/each}
+					</tbody>
+				</table>
+			</div>
+		{:else if tok.type === 'hr'}
+			<hr />
+		{:else if tok.type === 'html'}
+			{@html (tok as Tokens.HTML).text}
+		{:else if tok.type === 'space'}
+			<!-- spacing handled by stylesheet -->
+		{:else if tok.type === 'text'}
+			{@const t = tok as Tokens.Text}
+			{#if t.tokens && t.tokens.length}{@render inline(t.tokens)}{:else}{t.text}{/if}
+		{/if}
+	{/each}
+{/snippet}
+
+<article class="markdown-view">
+	{@render blocks(parsed.tokens)}
+</article>
+
+<style>
+	.markdown-view {
+		color: var(--foreground, hsl(220 13% 10%));
+		font-size: 0.9375rem;
+		line-height: 1.65;
+	}
+
+	/* Headings */
+	.markdown-view :global(h1),
+	.markdown-view :global(h2),
+	.markdown-view :global(h3),
+	.markdown-view :global(h4),
+	.markdown-view :global(h5),
+	.markdown-view :global(h6) {
+		margin: 1.75em 0 0.75em;
+		font-weight: 600;
+		line-height: 1.25;
+		letter-spacing: -0.01em;
+		color: var(--foreground, hsl(220 13% 10%));
+		scroll-margin-top: 5rem;
+	}
+	.markdown-view :global(h1) {
+		font-size: 2rem;
+		margin-top: 0;
+	}
+	.markdown-view :global(h2) {
+		font-size: 1.5rem;
+		padding-bottom: 0.375rem;
+		border-bottom: 1px solid var(--border, hsl(0 0% 90%));
+	}
+	.markdown-view :global(h3) {
+		font-size: 1.2rem;
+	}
+	.markdown-view :global(h4) {
+		font-size: 1.05rem;
+	}
+	.markdown-view :global(h5),
+	.markdown-view :global(h6) {
+		font-size: 0.95rem;
+		color: var(--muted-foreground, hsl(220 13% 40%));
+	}
+
+	/* First heading right after a section header should hug the top. */
+	.markdown-view :global(:where(h1, h2, h3, h4, h5, h6):first-child) {
+		margin-top: 0;
+	}
+
+	/* Paragraphs */
+	.markdown-view :global(p) {
+		margin: 0.875em 0;
+	}
+
+	/* Lists */
+	.markdown-view :global(ul),
+	.markdown-view :global(ol) {
+		margin: 0.875em 0;
+		padding-left: 1.5rem;
+	}
+	.markdown-view :global(ul) {
+		list-style: disc;
+	}
+	.markdown-view :global(ol) {
+		list-style: decimal;
+	}
+	.markdown-view :global(li) {
+		margin: 0.25em 0;
+	}
+	.markdown-view :global(li > p) {
+		margin: 0.25em 0;
+	}
+	.markdown-view :global(li > ul),
+	.markdown-view :global(li > ol) {
+		margin: 0.25em 0;
+	}
+
+	/* Blockquote */
+	.markdown-view :global(blockquote) {
+		margin: 1em 0;
+		padding: 0.5em 1rem;
+		border-left: 3px solid var(--primary, hsl(217 91% 60%));
+		background: color-mix(in oklab, var(--muted, hsl(220 13% 96%)) 60%, transparent);
+		border-radius: 0 0.375rem 0.375rem 0;
+		color: var(--muted-foreground, hsl(220 13% 30%));
+	}
+	.markdown-view :global(blockquote > p:first-child) {
+		margin-top: 0;
+	}
+	.markdown-view :global(blockquote > p:last-child) {
+		margin-bottom: 0;
+	}
+
+	/* Inline code */
+	.markdown-view :global(.inline-code),
+	.markdown-view :global(p > code),
+	.markdown-view :global(li > code),
+	.markdown-view :global(td > code),
+	.markdown-view :global(th > code),
+	.markdown-view :global(h1 > code),
+	.markdown-view :global(h2 > code),
+	.markdown-view :global(h3 > code),
+	.markdown-view :global(h4 > code) {
+		font-family: var(--font-mono, ui-monospace, monospace);
+		font-size: 0.875em;
+		padding: 0.125em 0.375em;
+		background: var(--muted, hsl(220 13% 95%));
+		border: 1px solid var(--border, hsl(0 0% 90%));
+		border-radius: 0.3125rem;
+		color: var(--foreground, hsl(220 13% 15%));
+		/* Long identifiers like `runtime.query('config/manifest')` shouldn't push
+		   the line beyond the container. Allow breaking inside the token. */
+		overflow-wrap: anywhere;
+		word-break: break-word;
+	}
+
+	/* Horizontal rule */
+	.markdown-view :global(hr) {
+		border: none;
+		border-top: 1px solid var(--border, hsl(0 0% 90%));
+		margin: 2em 0;
+	}
+
+	/* Links */
+	.markdown-view :global(a) {
+		color: var(--primary, hsl(217 91% 50%));
+		text-decoration: underline;
+		text-decoration-thickness: 1px;
+		text-underline-offset: 3px;
+		text-decoration-color: color-mix(in oklab, var(--primary, currentColor) 40%, transparent);
+		transition: text-decoration-color 120ms;
+	}
+	.markdown-view :global(a:hover) {
+		text-decoration-color: currentColor;
+	}
+
+	/* Images */
+	.markdown-view :global(img) {
+		max-width: 100%;
+		height: auto;
+		border-radius: 0.5rem;
+		border: 1px solid var(--border, hsl(0 0% 90%));
+	}
+
+	/* Tables */
+	.markdown-view :global(.table-wrap) {
+		margin: 1em 0;
+		overflow-x: auto;
+		border: 1px solid var(--border, hsl(0 0% 90%));
+		border-radius: 0.5rem;
+	}
+	.markdown-view :global(table) {
+		width: 100%;
+		border-collapse: collapse;
+		font-size: 0.875rem;
+	}
+	.markdown-view :global(thead) {
+		background: color-mix(in oklab, var(--muted, hsl(220 13% 96%)) 70%, transparent);
+	}
+	.markdown-view :global(th),
+	.markdown-view :global(td) {
+		padding: 0.5rem 0.75rem;
+		border-bottom: 1px solid var(--border, hsl(0 0% 90%));
+		text-align: left;
+		vertical-align: top;
+	}
+	.markdown-view :global(th) {
+		font-weight: 600;
+		color: var(--foreground, hsl(220 13% 15%));
+	}
+	.markdown-view :global(tbody tr:last-child td) {
+		border-bottom: none;
+	}
+	.markdown-view :global(tbody tr:hover) {
+		background: color-mix(in oklab, var(--muted, hsl(220 13% 96%)) 40%, transparent);
+	}
+
+	/* Pre blocks rendered outside of CodeBlock (rare fallback). */
+	.markdown-view :global(pre) {
+		font-family: var(--font-mono, ui-monospace, monospace);
+		font-size: 0.8125rem;
+		background: var(--muted, hsl(220 13% 95%));
+		padding: 0.875rem 1rem;
+		border-radius: 0.5rem;
+		overflow-x: auto;
+		margin: 1em 0;
+		border: 1px solid var(--border, hsl(0 0% 90%));
+	}
+	.markdown-view :global(pre code) {
+		background: transparent;
+		padding: 0;
+		border: none;
+	}
+</style>

package/dist/svelte/ui/markdown/MarkdownView.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedTopic } from '@vibesdotdev/docs/render';
+interface Props {
+    /** Parsed AST from `@vibesdotdev/docs`'s `parseMarkdown`. */
+    parsed: ParsedTopic;
+}
+declare const MarkdownView: import("svelte").Component<Props, {}, "">;
+type MarkdownView = ReturnType<typeof MarkdownView>;
+export default MarkdownView;
+//# sourceMappingURL=MarkdownView.svelte.d.ts.map

package/dist/svelte/ui/markdown/MarkdownView.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownView.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/ui/markdown/MarkdownView.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO3D,UAAU,KAAK;IACd,6DAA6D;IAC7D,MAAM,EAAE,WAAW,CAAC;CACpB;AAgIF,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/tools/docs.descriptor.d.ts

@@ -0,0 +1,48 @@
+export declare const docsToolDescriptor: {
+    readonly kind: "tools/tool";
+    readonly id: "docs";
+    readonly name: "docs";
+    readonly description: "Query, search, and retrieve high-level Vibes platform and package documentation topics";
+    readonly mcpDescription: "Search for documentation topics or read full contents of specific vibes platform topics.";
+    readonly hardware: ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly category: "utility";
+    readonly subcategory: "documentation";
+    readonly safety: "read";
+    readonly requiresApproval: false;
+    readonly tags: ["docs", "help", "search", "topics"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            action: import("zod").ZodEnum<{
+                search: "search";
+                read: "read";
+                list: "list";
+            }>;
+            query: import("zod").ZodOptional<import("zod").ZodString>;
+            topicId: import("zod").ZodOptional<import("zod").ZodString>;
+            tag: import("zod").ZodOptional<import("zod").ZodString>;
+            parent: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            message: import("zod").ZodOptional<import("zod").ZodString>;
+            topics: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                summary: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                tags: import("zod").ZodArray<import("zod").ZodString>;
+                parent: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                order: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+            }, import("zod/v4/core").$strip>>>;
+            topic: import("zod").ZodOptional<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                summary: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                body: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                tags: import("zod").ZodArray<import("zod").ZodString>;
+                parent: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default docsToolDescriptor;
+//# sourceMappingURL=docs.descriptor.d.ts.map

package/dist/tools/docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/tools/docs.descriptor.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/docs.descriptor.js

@@ -0,0 +1,23 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { DocsToolInputSchema, DocsToolOutputSchema } from "./schemas.js";
+export const docsToolDescriptor = createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'docs',
+    name: 'docs',
+    description: 'Query, search, and retrieve high-level Vibes platform and package documentation topics',
+    mcpDescription: 'Search for documentation topics or read full contents of specific vibes platform topics.',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    category: 'utility',
+    subcategory: 'documentation',
+    safety: 'read',
+    // Read-only platform docs lookup.
+    requiresApproval: false,
+    tags: ['docs', 'help', 'search', 'topics'],
+    schemas: {
+        input: DocsToolInputSchema,
+        output: DocsToolOutputSchema
+    }
+});
+export default docsToolDescriptor;
+//# sourceMappingURL=docs.descriptor.js.map

package/dist/tools/docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.descriptor.js","sourceRoot":"","sources":["../../src/tools/docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;IACpD,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wFAAwF;IACrG,cAAc,EAAE,0FAA0F;IAC1G,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC;IAC7C,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,eAAe;IAC5B,MAAM,EAAE,MAAM;IACd,kCAAkC;IAClC,gBAAgB,EAAE,KAAK;IACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC1C,OAAO,EAAE;QACR,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;KAC5B;CACD,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/docs.impl.d.ts

@@ -0,0 +1,7 @@
+import type { VibesRuntime, ToolCallContext } from '@vibesdotdev/kernel';
+import { type DocsToolInput, type DocsToolOutput } from './schemas.ts';
+declare const _default: {
+    execute(input: DocsToolInput, runtime: VibesRuntime, _ctx: ToolCallContext): Promise<DocsToolOutput>;
+};
+export default _default;
+//# sourceMappingURL=docs.impl.d.ts.map

package/dist/tools/docs.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.impl.d.ts","sourceRoot":"","sources":["../../src/tools/docs.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,MAAM,cAAc,CAAC;;mBAIb,aAAa,WACX,YAAY,QACf,eAAe,GACnB,OAAO,CAAC,cAAc,CAAC;;AAL3B,wBAgFE"}