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

package/dist/client/index.d.ts

@@ -0,0 +1,12 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { DocsClient } from './docs-client.ts';
+export { DocsClient } from './docs-client.ts';
+export type { IDocsClient, SubjectRef, ListOptions } from './types.ts';
+/**
+ * Resolve the canonical Docs client.
+ *
+ * Equivalent to `runtime.query('runtime/client').withId('docs').resolve()`.
+ * Requires the `docsPlugin` to have been registered with the runtime.
+ */
+export declare function getVibesDocsClient(runtime: VibesRuntime): Promise<DocsClient>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAEnF"}

package/dist/client/index.js

@@ -0,0 +1,13 @@
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { DocsClient } from "./docs-client.js";
+export { DocsClient } from "./docs-client.js";
+/**
+ * Resolve the canonical Docs client.
+ *
+ * Equivalent to `runtime.query('runtime/client').withId('docs').resolve()`.
+ * Requires the `docsPlugin` to have been registered with the runtime.
+ */
+export async function getVibesDocsClient(runtime) {
+    return getVibesClient('docs', runtime);
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAqB;IAC7D,OAAO,cAAc,CAAa,MAAM,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,26 @@
+import type { DocsTopicDescriptor } from '../schemas/topic.schema.ts';
+import type { CitationOwner } from '@vibesdotdev/shared/citations';
+import type { DocsMarkdownSections } from '@vibesdotdev/docs-contracts';
+export interface SubjectRef {
+    kind: string;
+    id: string;
+}
+export interface ListOptions {
+    tag?: string;
+    parent?: string;
+    surface?: 'cli' | 'web' | 'in-app' | 'mcp';
+}
+export interface IDocsClient extends Partial<DocsMarkdownSections> {
+    readonly citations: CitationOwner;
+    /** Resolve a topic descriptor by canonical id (e.g., 'tools.list'). */
+    findById(id: string): DocsTopicDescriptor | null;
+    /** Reverse-lookup by descriptor cross-reference. */
+    findBySubject(subject: SubjectRef): DocsTopicDescriptor | null;
+    /** List topics, optionally filtered by tag / parent / surface. */
+    list(opts?: ListOptions): DocsTopicDescriptor[];
+    /** Resolve markdown body content for a topic. Returns null for non-markdown bodies. */
+    resolveBody(descriptor: DocsTopicDescriptor): string | null;
+    /** Fuzzy substring match across id / title / summary. */
+    search(query: string): DocsTopicDescriptor[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC3C;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAC;IAEjD,oDAAoD;IACpD,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CAAC;IAE/D,kEAAkE;IAClE,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAEhD,uFAAuF;IACvF,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;IAE5D,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;CAC7C"}

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/config/docs.svelte.config.descriptor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Docs svelte settings — the Open-in-docs public origin the help UI reads
+ * when the `docs` service catalog is out of reach.
+ *
+ * `publicOrigin` is the previous in-app default (`https://docs.vibes.dev`).
+ * Callers with a handed runtime still prefer `serviceOrigin(runtime, 'docs')`.
+ * This manifest is the declared fallback so the link stays when the host
+ * omits `docsOrigin` and has no runtime svelte context.
+ */
+import * as z from 'zod/v4';
+export declare const DocsSvelteConfigSchema: z.ZodObject<{
+    publicOrigin: z.ZodDefault<z.ZodURL>;
+}, z.core.$strip>;
+export type DocsSvelteConfig = z.infer<typeof DocsSvelteConfigSchema>;
+export declare const DOCS_SVELTE_CONFIG_MANIFEST_ID = "docs.svelte";
+export declare const docsSvelteConfigDescriptor: {
+    kind: "config/manifest";
+    id: string;
+    name: string;
+    namespace: string;
+    description: string;
+    tier: string;
+    category: string;
+    schema: z.ZodObject<{
+        publicOrigin: z.ZodDefault<z.ZodURL>;
+    }, z.core.$strip>;
+    fields: {
+        publicOrigin: {
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+    };
+    groups: {
+        id: string;
+        label: string;
+    }[];
+    allowedAdapters: string[];
+    defaultAdapter: string;
+    scope: string;
+    customTables: boolean;
+    version: number;
+    internal: boolean;
+    enabled: true;
+};
+export default docsSvelteConfigDescriptor;
+//# sourceMappingURL=docs.svelte.config.descriptor.d.ts.map

package/dist/config/docs.svelte.config.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.svelte.config.descriptor.d.ts","sourceRoot":"","sources":["../../src/config/docs.svelte.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,8BAA8B,gBAAgB,CAAC;AAE5D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BrC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}

package/dist/config/docs.svelte.config.descriptor.js

@@ -0,0 +1,46 @@
+/**
+ * Docs svelte settings — the Open-in-docs public origin the help UI reads
+ * when the `docs` service catalog is out of reach.
+ *
+ * `publicOrigin` is the previous in-app default (`https://docs.vibes.dev`).
+ * Callers with a handed runtime still prefer `serviceOrigin(runtime, 'docs')`.
+ * This manifest is the declared fallback so the link stays when the host
+ * omits `docsOrigin` and has no runtime svelte context.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export const DocsSvelteConfigSchema = z.object({
+    /** Public docs-app origin for in-app "Open in docs" links. */
+    publicOrigin: z.url().default('https://docs.vibes.dev')
+});
+export const DOCS_SVELTE_CONFIG_MANIFEST_ID = 'docs.svelte';
+export const docsSvelteConfigDescriptor = createRuntimeAsset({
+    kind: 'config/manifest',
+    id: DOCS_SVELTE_CONFIG_MANIFEST_ID,
+    name: 'Docs svelte',
+    namespace: 'docs',
+    description: 'Public origin for in-app Open in docs links',
+    tier: 'user',
+    category: 'docs',
+    schema: DocsSvelteConfigSchema,
+    fields: {
+        publicOrigin: {
+            ui: {
+                label: 'Public docs origin',
+                description: 'Open in docs URL when the docs service catalog is not in hand',
+                component: 'input',
+                group: 'origin'
+            }
+        }
+    },
+    groups: [{ id: 'origin', label: 'Origin' }],
+    allowedAdapters: ['storage.localdb', 'storage.json'],
+    defaultAdapter: 'storage.localdb',
+    scope: 'auto',
+    customTables: false,
+    version: 1,
+    internal: false,
+    enabled: true
+});
+export default docsSvelteConfigDescriptor;
+//# sourceMappingURL=docs.svelte.config.descriptor.js.map

package/dist/config/docs.svelte.config.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.svelte.config.descriptor.js","sourceRoot":"","sources":["../../src/config/docs.svelte.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,8DAA8D;IAC9D,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;CACvD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,8BAA8B,GAAG,aAAa,CAAC;AAE5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;IAC5D,IAAI,EAAE,iBAAiB;IACvB,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,6CAA6C;IAC1D,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,sBAAsB;IAC9B,MAAM,EAAE;QACP,YAAY,EAAE;YACb,EAAE,EAAE;gBACH,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EAAE,+DAA+D;gBAC5E,SAAS,EAAE,OAAO;gBAClB,KAAK,EAAE,QAAQ;aACf;SACD;KACD;IACD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3C,eAAe,EAAE,CAAC,iBAAiB,EAAE,cAAc,CAAC;IACpD,cAAc,EAAE,iBAAiB;IACjC,KAAK,EAAE,MAAM;IACb,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}

package/dist/config/documents.source-refresh.config.descriptor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Where a document ref's source refresh may go.
+ *
+ * A ref's `sourceRefreshUrl` re-mints a short-lived download URL, and that call
+ * authenticates with the internal service credential. So the URL is admitted
+ * only when its origin is the primary or internal origin of an `infra/service`
+ * listed here, resolved through the runtime's service catalog in its configured
+ * service environment. The default names `platform`, which mints the storage
+ * source handles that `storage.browse` / `storage.search` hand to document
+ * reads. A host whose agents read another app's document refs adds that app's
+ * declared service in its composition.
+ *
+ * Composition only (`storedLayer: 'none'`): no stored edit can widen where the
+ * credential is sent.
+ */
+import * as z from 'zod/v4';
+export declare const DOCUMENTS_SOURCE_REFRESH_CONFIG_ID = "documents.source-refresh";
+export declare const DocumentsSourceRefreshConfigSchema: z.ZodObject<{
+    services: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type DocumentsSourceRefreshConfig = z.infer<typeof DocumentsSourceRefreshConfigSchema>;
+export declare const documentsSourceRefreshConfigDescriptor: {
+    id: string;
+    kind: "config/manifest";
+    name: string;
+    description: string;
+    namespace: string;
+    schema: z.ZodObject<{
+        services: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    scope: "global";
+    tier: "system";
+    storedLayer: "none";
+    allowedAdapters: string[];
+    fields: {};
+    customTables: false;
+    version: number;
+    internal: true;
+};
+export default documentsSourceRefreshConfigDescriptor;
+//# sourceMappingURL=documents.source-refresh.config.descriptor.d.ts.map

package/dist/config/documents.source-refresh.config.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.source-refresh.config.descriptor.d.ts","sourceRoot":"","sources":["../../src/config/documents.source-refresh.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E,eAAO,MAAM,kCAAkC;;kBAG7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;CAef,CAAC;AAErC,eAAe,sCAAsC,CAAC"}

package/dist/config/documents.source-refresh.config.descriptor.js

@@ -0,0 +1,39 @@
+/**
+ * Where a document ref's source refresh may go.
+ *
+ * A ref's `sourceRefreshUrl` re-mints a short-lived download URL, and that call
+ * authenticates with the internal service credential. So the URL is admitted
+ * only when its origin is the primary or internal origin of an `infra/service`
+ * listed here, resolved through the runtime's service catalog in its configured
+ * service environment. The default names `platform`, which mints the storage
+ * source handles that `storage.browse` / `storage.search` hand to document
+ * reads. A host whose agents read another app's document refs adds that app's
+ * declared service in its composition.
+ *
+ * Composition only (`storedLayer: 'none'`): no stored edit can widen where the
+ * credential is sent.
+ */
+import * as z from 'zod/v4';
+export const DOCUMENTS_SOURCE_REFRESH_CONFIG_ID = 'documents.source-refresh';
+export const DocumentsSourceRefreshConfigSchema = z.strictObject({
+    /** Declared `infra/service` ids whose origins may receive a source refresh. */
+    services: z.array(z.string().min(1)).default(['platform'])
+});
+export const documentsSourceRefreshConfigDescriptor = {
+    id: DOCUMENTS_SOURCE_REFRESH_CONFIG_ID,
+    kind: 'config/manifest',
+    name: 'Document source refresh destinations',
+    description: 'The declared services a document ref may name as its source refresh endpoint',
+    namespace: DOCUMENTS_SOURCE_REFRESH_CONFIG_ID,
+    schema: DocumentsSourceRefreshConfigSchema,
+    scope: 'global',
+    tier: 'system',
+    storedLayer: 'none',
+    allowedAdapters: ['storage.json', 'storage.localdb'],
+    fields: {},
+    customTables: false,
+    version: 1,
+    internal: true
+};
+export default documentsSourceRefreshConfigDescriptor;
+//# sourceMappingURL=documents.source-refresh.config.descriptor.js.map

package/dist/config/documents.source-refresh.config.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.source-refresh.config.descriptor.js","sourceRoot":"","sources":["../../src/config/documents.source-refresh.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,kCAAkC,GAAG,0BAA0B,CAAC;AAE7E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,YAAY,CAAC;IAChE,+EAA+E;IAC/E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;CAC1D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACrD,EAAE,EAAE,kCAAkC;IACtC,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,8EAA8E;IAC3F,SAAS,EAAE,kCAAkC;IAC7C,MAAM,EAAE,kCAAkC;IAC1C,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACpD,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,IAAI;CACqB,CAAC;AAErC,eAAe,sCAAsC,CAAC"}

package/dist/directives/index.d.ts

@@ -0,0 +1,4 @@
+export type { DirectiveDescriptor, DirectiveNode } from './types.ts';
+export { builtinDirectives, descriptorDirective, endpointDirective, installDirective, shellDirective, usageDirective, cardDirective, indexDirectives } from './registry.ts';
+export { renderDirectiveCli } from '../cli/directives/index.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/directives/index.js

@@ -0,0 +1,3 @@
+export { builtinDirectives, descriptorDirective, endpointDirective, installDirective, shellDirective, usageDirective, cardDirective, indexDirectives } from "./registry.js";
+export { renderDirectiveCli } from "../cli/directives/index.js";
+//# sourceMappingURL=index.js.map

package/dist/directives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/directives/registry.d.ts

@@ -0,0 +1,31 @@
+import type { DirectiveDescriptor } from './types.ts';
+/**
+ * Six builtin directives. Each web/CLI renderer is registered separately
+ * (see `./cli/index.ts` for CLI; `docs-svelte/src/directives/web/`
+ * for web at Tier 2).
+ */
+export declare const descriptorDirective: DirectiveDescriptor<{
+    kind: string;
+    id: string;
+}>;
+export declare const endpointDirective: DirectiveDescriptor<{
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    appId?: string;
+}>;
+export declare const installDirective: DirectiveDescriptor<{
+    package: string;
+}>;
+export declare const shellDirective: DirectiveDescriptor<Record<string, string>>;
+export declare const usageDirective: DirectiveDescriptor<{
+    language: string;
+}>;
+export declare const cardDirective: DirectiveDescriptor<{
+    title?: string;
+}>;
+export declare const builtinDirectives: DirectiveDescriptor[];
+/**
+ * Build an index from directive name → descriptor for fast lookup.
+ */
+export declare function indexDirectives(directives: readonly DirectiveDescriptor[]): Map<string, DirectiveDescriptor>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/directives/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/directives/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACX,CAMA,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,CAAC;IACnD,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAUA,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAKrE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKtE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAAmB,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAKpE,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,mBAAmB,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAKjE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,EAOlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACxC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAMlC"}

package/dist/directives/registry.js

@@ -0,0 +1,65 @@
+import * as z from 'zod/v4';
+/**
+ * Six builtin directives. Each web/CLI renderer is registered separately
+ * (see `./cli/index.ts` for CLI; `docs-svelte/src/directives/web/`
+ * for web at Tier 2).
+ */
+export const descriptorDirective = {
+    name: 'descriptor',
+    description: 'Render a kit-styled reference card for the named runtime descriptor.',
+    attrs: z.object({ kind: z.string(), id: z.string() }),
+    hasBody: false
+};
+export const endpointDirective = {
+    name: 'endpoint',
+    description: 'Render a one-line HTTP endpoint card (method + path, optional app reference).',
+    attrs: z.object({
+        method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']),
+        path: z.string(),
+        appId: z.string().optional()
+    }),
+    hasBody: false
+};
+export const installDirective = {
+    name: 'install',
+    description: 'Render an install card with copy-able shell commands.',
+    attrs: z.object({ package: z.string() }),
+    hasBody: true
+};
+export const shellDirective = {
+    name: 'shell',
+    description: 'Render a shell command block with copy affordance.',
+    attrs: z.record(z.string(), z.string()),
+    hasBody: true
+};
+export const usageDirective = {
+    name: 'usage',
+    description: 'Render a code-usage example block.',
+    attrs: z.object({ language: z.string().default('ts') }),
+    hasBody: true
+};
+export const cardDirective = {
+    name: 'card',
+    description: 'Render a titled bordered card around the body content.',
+    attrs: z.object({ title: z.string().optional() }),
+    hasBody: true
+};
+export const builtinDirectives = [
+    descriptorDirective,
+    endpointDirective,
+    installDirective,
+    shellDirective,
+    usageDirective,
+    cardDirective
+];
+/**
+ * Build an index from directive name → descriptor for fast lookup.
+ */
+export function indexDirectives(directives) {
+    const map = new Map();
+    for (const d of directives) {
+        map.set(d.name, d);
+    }
+    return map;
+}
+//# sourceMappingURL=registry.js.map

package/dist/directives/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/directives/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAG3B;IACJ,IAAI,EAAE,YAAY;IAClB,WAAW,EACV,sEAAsE;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACrD,OAAO,EAAE,KAAK;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAIzB;IACJ,IAAI,EAAE,UAAU;IAChB,WAAW,EACV,+EAA+E;IAChF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC;IACF,OAAO,EAAE,KAAK;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA6C;IACzE,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,uDAAuD;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACxC,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgD;IAC1E,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,oDAAoD;IACjE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA8C;IACxE,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,oCAAoC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA4C;IACrE,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wDAAwD;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACvD,mBAAmB;IACnB,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,aAAa;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,UAA0C;IAE1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAA+B,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/directives/types.d.ts

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+/**
+ * A directive AST node — emitted by the markdown parser when it encounters
+ * a `:::name{key=val}` block. Web and CLI renderers consume the AST node
+ * shape.
+ */
+export interface DirectiveNode {
+    type: 'directive';
+    name: string;
+    attrs: Record<string, string>;
+    body: string;
+    /**
+     * Optional shiki-rendered HTML for the body, attached server-side at build
+     * time (e.g. by `highlightParsedTopic` for `:::usage`). Lets renderers ship
+     * pre-highlighted code in the prerendered HTML instead of highlighting on the
+     * client after hydration.
+     */
+    highlighted?: string;
+}
+/**
+ * Descriptor for a builtin or extension directive.
+ */
+export interface DirectiveDescriptor<TAttrs = unknown> {
+    /** Directive name as written in markdown (`:::name`). */
+    name: string;
+    /** Zod schema for the attributes block (`{key=val key2=val2}`). */
+    attrs: z.ZodType<TAttrs>;
+    /** Whether the directive expects a body (lines between `:::name` and `:::`). */
+    hasBody: boolean;
+    /** Optional human-readable description of the directive. */
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/directives/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,OAAO;IACpD,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/directives/types.js

@@ -0,0 +1,2 @@
+import * as z from 'zod/v4';
+//# sourceMappingURL=types.js.map

package/dist/directives/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/directives/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC"}

package/dist/docs/agent-voice.docs.descriptor.d.ts

@@ -0,0 +1,30 @@
+declare const descriptor: {
+    kind: "docs/topic";
+    id: string;
+    title: string;
+    summary: string;
+    body: {
+        type: "markdown";
+        sourceType: "raw";
+        source: string;
+    };
+    parent: string;
+    order: number;
+    tags: string[];
+    surfaces: readonly ["cli", "web", "in-app"];
+    hardware: readonly ["consumer", "cloud"];
+    enabled: boolean;
+    man: {
+        name: string;
+        section: number;
+        synopsis: string;
+        options: never[];
+        examples: {
+            description: string;
+            command: string;
+        }[];
+        seeAlso: string[];
+    };
+};
+export default descriptor;
+//# sourceMappingURL=agent-voice.docs.descriptor.d.ts.map

package/dist/docs/agent-voice.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-voice.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/agent-voice.docs.descriptor.ts"],"names":[],"mappings":"AA4EA,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/agent-voice.docs.descriptor.js

@@ -0,0 +1,107 @@
+const markdown = `---
+title: Agent Voice
+summary: Half-duplex voice pipeline (STT -> agent loop -> TTS) via the agent/voice runtime kind
+tags: [agent, voice, stt, tts, audio, pipeline, runtime]
+parent: agents
+order: 14
+surfaces: [cli, web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Agent Voice
+
+\`@vibesdotdev/agent-execution/voice\` owns the \`agent/voice\` runtime kind: a half-duplex
+(turn-based) voice pipeline that wires three existing seams together —
+
+> audio ──STT──▶ transcript ──agent loop──▶ reply text ──TTS──▶ audio
+
+The agent loop is never modified. The voice kind is an orchestrator that
+converts speech↔text at the edges and delegates "what should the assistant say"
+to the (unchanged, text-only) NativeToolsAgentLoop. \`interruptible\` is fixed
+\`false\` this round — barge-in / full-duplex is a follow-up.
+
+## Dependency injection
+
+The pipeline (\`runVoiceTurn\`) takes its STT, agent-turn, and TTS stages as
+injected async functions (\`VoicePipelineDeps\`). The host resolves them from the
+runtime's \`ai/generation\` providers + the agent loop, so this package stays
+workerd-safe — it imports only the runtime + ai schemas + logging, never a
+Node-only generation executor.
+
+## Turn ceiling
+
+\`runVoiceTurn\` takes the handed runtime first. The descriptor's
+\`turnTimeoutMs\` is a hard ceiling over the whole STT → agent → TTS chain, run as
+that runtime's bounded \`lifecycle.wait\`: disposing the runtime aborts the turn
+and no timer outlives it. Every stage receives one combined \`AbortSignal\` (the
+caller's optional signal, the runtime's and the deadline). Exceeding the ceiling
+rejects \`CapabilityError\` with code \`TIMEOUT\` and reason
+\`voice-turn-timeout\`; an empty transcript rejects \`CapabilityError\` with
+code \`INVALID_INPUT\` and reason \`voice-empty-transcript\`; an empty agent
+reply returns without synthesis.
+
+\`SilenceSegmenter\` does server-side turn segmentation: feed PCM frames, and it
+returns the completed utterance when trailing silence exceeds the threshold.
+
+## Consumer vs cloud
+
+- **Consumer** (this package): default descriptor \`agent-voice-local\` —
+  whisper-cpp STT, bark TTS, native-tools loop. Exercised against LM Studio.
+- **Cloud**: provider-owned implementations are supported by the same kind, but
+  no Cloudflare voice implementation is currently registered. The Cloudflare
+  connector helper is not itself an \`agent/voice\` implementation.
+
+## Usage
+
+\`\`\`ts
+import { runVoiceTurn } from '@vibesdotdev/agent-execution/voice';
+
+const result = await runVoiceTurn(runtime, descriptor, {
+  transcribe: (audio, signal) => sttProvider.transcribe(audio, signal),
+  runAgentTurn: (text, history, signal) => agentLoop.run(text, history, signal),
+  synthesize: (text, signal) => ttsProvider.speak(text, signal)
+}, audio, history, request.signal);
+\`\`\`
+
+The chat-web voice route invokes \`runVoiceTurn\` directly and owns the transport
+plus injected dependencies.
+
+## Related
+
+:::card{title="See also"}
+- [\`agents\`](agents) — the agent loop the pipeline drives
+- [\`ai\`](ai) — the STT/TTS providers
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'agent.voice',
+    title: 'Agent Voice',
+    summary: 'Half-duplex voice pipeline (STT -> agent loop -> TTS) via the agent/voice runtime kind',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'agents',
+    order: 14,
+    tags: ['agent', 'voice', 'stt', 'tts', 'audio', 'pipeline', 'runtime'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true,
+    man: {
+        name: 'agent.voice — half-duplex voice pipeline',
+        section: 1,
+        synopsis: 'vibes man agent.voice',
+        options: [],
+        examples: [
+            {
+                description: 'Run one voice turn',
+                command: 'await runVoiceTurn(runtime, descriptor, deps, audio, history, signal)'
+            }
+        ],
+        seeAlso: ['agents', 'ai']
+    }
+};
+export default descriptor;
+//# sourceMappingURL=agent-voice.docs.descriptor.js.map

package/dist/docs/agent-voice.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-voice.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/agent-voice.docs.descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EhB,CAAC;AAEF,MAAM,UAAU,GAAG;IAClB,IAAI,EAAE,YAAqB;IAC3B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,wFAAwF;IACjG,IAAI,EAAE;QACL,IAAI,EAAE,UAAmB;QACzB,UAAU,EAAE,KAAc;QAC1B,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC;IACtE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAU;IAC3C,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAU;IACxC,OAAO,EAAE,IAAI;IACb,GAAG,EAAE;QACJ,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACT;gBACC,WAAW,EAAE,oBAAoB;gBACjC,OAAO,EAAE,uEAAuE;aAChF;SACD;QACD,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;KACzB;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/charts.usage.docs.descriptor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Descriptor for charts.usage
+ *
+ * Charts is a surface-only feature (no base @vibesdotdev/charts plugin in the
+ * standard umbrella); the components live in @vibesdotdev/kit/components/viz.
+ * This descriptor is registered through the docs plugin so the topic is
+ * discoverable from `vibes docs list`.
+ */
+declare const descriptor: {
+    kind: "docs/topic";
+    id: string;
+    title: string;
+    summary: string;
+    body: {
+        type: "markdown";
+        sourceType: "raw";
+        source: string;
+    };
+    parent: string;
+    order: number;
+    tags: string[];
+    surfaces: readonly ["cli", "web", "in-app"];
+    hardware: readonly ["consumer"];
+    enabled: boolean;
+};
+export default descriptor;
+//# sourceMappingURL=charts.usage.docs.descriptor.d.ts.map

package/dist/docs/charts.usage.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.usage.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/charts.usage.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkEH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEF,eAAe,UAAU,CAAC"}