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

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,107 @@
-# Temporary Holding Version
+# @vibesdotdev/tools
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Svelte catalog uses per-surface presentation state. Capture
+`const state = getToolsState()` from `@vibesdotdev/tools/svelte/state` during
+component initialization (the compatibility accessor is `toolsState()`).
+`ToolsLoader` loads that context and disposes it on unmount; its children inherit
+it. Establish the context in the parent when composing sibling loader and view
+components. `ToolsOverview` also works standalone. Initial data renders immediately;
+refresh reads the handed runtime's `tools/catalog` owner. Rebinding and unmount
+invalidate outstanding reads without affecting another surface.
+
+Tool descriptors, invocation contracts, and agent-facing primitives for Vibes applications.
+
+This package is part of the public Vibes framework package set. The source repository is private while the public repository split is being prepared, so package documentation is published on the Vibes docs site.
+
+## Runtime entrypoints
+
+The root `toolsPlugin` export provides the isomorphic tools contract, schemas,
+kinds and canonical client. Its static import graph contains no consumer, CLI
+or host implementations. Consumer hosts compose `@vibesdotdev/tools/consumer.plugin`;
+`@vibesdotdev/tools/plugin` remains the compatible consumer alias with the same
+providers, agent execution, audit tools, subscriptions and filesystem webhooks.
+Browser and cloud hosts use `./browser.plugin` and `./cloud.plugin` respectively.
+These are alternative compositions of the same `tools` capability.
+
+`vibes tools init --example` uses its handed runtime's filesystem adapter.
+Standalone callers of `./local/node/init-local-tools` supply
+`{ cwd, adapter, example: true }` with an initialized host-owned adapter, or
+`{ cwd, runtime, example: true }` with a composed runtime. Initialization preserves
+existing README and example files. Omitting both runtime and adapter refuses
+`UNAVAILABLE tools-init-filesystem-unavailable` before creating files.
+
+## Encoding and derived state
+
+`ToolsClient.encoding` owns each runtime's surface policies. Activate the client
+with `getVibesClient('tools', runtime)`, then pass that runtime to
+`registerSurfacePolicy(policy, runtime)` or `resetSurfacePolicies(runtime)`.
+Missing ownership refuses `UNAVAILABLE tools-client-unavailable`.
+`resolveRuntimeEncoder(runtime, surfaceId, selection)` from `./encoding`
+resolves `tools/result-encoder`; policy violations refuse
+`INVALID_INPUT encoder-out-of-policy`. JSON and compact JSON are registered
+on all compositions. Consumer composition retains the optional TOON binding
+with JSON fallback when its format library is absent.
+
+Existing `resolveEncoder('tool-results')` calls retain stateless JSON formatting.
+For synchronous runtime-aware calls, pass `{ runtime }` after async resolution;
+a cold implementation refuses `UNAVAILABLE tools-encoder-unavailable`.
+Configuration defaults remain JSON and never change because another runtime
+registered a policy.
+
+The client also owns dashboard statistics, tier warning histories and TUI view
+refresh handlers. Statistics retain their five-minute TTL and platform owner
+keys; disposing one client clears its state without touching another runtime.
+
+## Install
+
+```sh
+bun add @vibesdotdev/tools
+# or
+npm install @vibesdotdev/tools
+```
+
+## Documentation
+
+- Package guide: https://docs.vibes.dev/tools
+- Vibes docs: https://docs.vibes.dev
+
+## Tool scenario tests
+
+Import scenario helpers from `@vibesdotdev/tools/testing/node/harness`
+with the optional `@vibesdotdev/testing` peer installed.
+`await buildContextForScenario({ scenario })` and `await createIsolationTest()`
+create owned runtimes with disposable fixtures; always `await cleanup()` in
+`finally`. The one-shot harness and isolation helpers clean up automatically.
+Callbacks run as registered `tools/tool` invocations, including lifecycle hooks.
+Narrow `result.passed` before reading isolation `result.results`: success retains
+both session outputs, while failure carries `result.error`.
+
+## Verification
+
+- `bun run check`: typecheck all source tests and Svelte helper TypeScript with
+  no emit, then check Svelte components.
+- `bun run test`: fast source tests in process, with no build prerequisite.
+- `bun run build`: production TypeScript plus separate Svelte packaging that
+  replaces `dist/svelte`, then emitted-export verification and generated-test
+  cleanup in `build:artifact`.
+
+A compile failure blocks packaging and artifact verification, not source tests.
+Report each command's actual result separately. External CLI type errors remain
+CLI owner work when present.
+
+Prompt-test preferences are owned by the Tools runtime client. Activate it with
+`await getVibesClient('tools', runtime)` before using the synchronous
+`getPromptTestPreferencesService(runtime)` compatibility entrypoint.
+
+Agent configuration belongs to `ToolsClient.agentConfig`; pending approval decisions
+belong to `ToolsClient.approval.pending`. Configuration uses the runtime's
+`tools.agents` storage manifest. Resolve the client with `getVibesClient('tools', runtime)`
+before using synchronous `getAgentConfigService(runtime)` or approval-store helpers.
+These helpers refuse `UNAVAILABLE tools-client-unavailable` without an active owner.
+Disposing the client or runtime disarms approval deadlines and rejects outstanding
+decisions with `UNAVAILABLE tools-approval-disposed`; callers must handle rejection.
+`LocalAgentClient` resolves its owner asynchronously and needs no activation step.
+
+## License
+
+MIT

package/dist/adapters/default.d.ts

@@ -0,0 +1,22 @@
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+/**
+ * Default Tool Adapter
+ *
+ * Default implementation used when no specific adapter is registered.
+ * Throws on execute to ensure proper implementations are provided.
+ */
+import type { ToolDescriptor } from '../kinds/tool.ts';
+import type { ToolExecutionInput, ToolExecutionResult, ToolJsonValue } from '../kinds/schemas/tool.ts';
+import type { ToolAdapterInterface, AdapterExecutionContext } from '../interfaces/adapter.ts';
+import type { ToolAdapterDescriptor } from '../schemas/adapter.ts';
+/**
+ * Default tool adapter - throws on execute to force registration
+ */
+export declare class DefaultToolAdapter implements ToolAdapterInterface {
+    readonly id: string;
+    readonly descriptor: ToolAdapterDescriptor;
+    constructor(descriptor: ToolAdapterDescriptor, _context: KindContext);
+    formatDescriptor(tool: ToolDescriptor): ToolJsonValue;
+    execute(_tool: ToolDescriptor, _input: ToolExecutionInput, _context: AdapterExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=default.d.ts.map

package/dist/adapters/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/adapters/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACX,oBAAoB,EACpB,uBAAuB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,qBAAa,kBAAmB,YAAW,oBAAoB;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;gBAE/B,UAAU,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW;IAKpE,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa;IASrD,OAAO,CACN,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;CAM/B"}

package/dist/adapters/default.js

@@ -0,0 +1,24 @@
+/**
+ * Default tool adapter - throws on execute to force registration
+ */
+export class DefaultToolAdapter {
+    id;
+    descriptor;
+    constructor(descriptor, _context) {
+        this.id = descriptor.id;
+        this.descriptor = descriptor;
+    }
+    formatDescriptor(tool) {
+        // Return basic representation - real adapters format for their surface
+        return {
+            id: tool.id,
+            name: tool.name ?? tool.id,
+            description: tool.description ?? null
+        };
+    }
+    execute(_tool, _input, _context) {
+        throw new Error(`No adapter implementation registered for '${this.id}'. ` +
+            `Register an implementation via runtime.registerLoader('tools/adapter', '${this.id}', loader).`);
+    }
+}
+//# sourceMappingURL=default.js.map

package/dist/adapters/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/adapters/default.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,EAAE,CAAS;IACX,UAAU,CAAwB;IAE3C,YAAY,UAAiC,EAAE,QAAqB;QACnE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,gBAAgB,CAAC,IAAoB;QACpC,uEAAuE;QACvE,OAAO;YACN,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;SACrC,CAAC;IACH,CAAC;IAED,OAAO,CACN,KAAqB,EACrB,MAA0B,EAC1B,QAAiC;QAEjC,MAAM,IAAI,KAAK,CACd,6CAA6C,IAAI,CAAC,EAAE,KAAK;YACxD,2EAA2E,IAAI,CAAC,EAAE,aAAa,CAChG,CAAC;IACH,CAAC;CACD"}

package/dist/adapters/skill/compose.d.ts

@@ -0,0 +1,6 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { type SkillCompositionDescriptor } from '../../skills/descriptor.ts';
+import type { FormattedSkill } from './types.ts';
+/** Compose one live `tools/skill` descriptor into a portable Agent Skill bundle. */
+export declare function composeSkill(runtime: VibesRuntime, input: SkillCompositionDescriptor): Promise<FormattedSkill>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/adapters/skill/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAaxD,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2NjD,oFAAoF;AACpF,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,0BAA0B,GAC/B,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/adapters/skill/compose.js

@@ -0,0 +1,239 @@
+import { RuntimeJsonSchemaSourceSchema, toRuntimeJsonSchema } from '@vibesdotdev/kernel/schemas/json-schema';
+import * as z from 'zod/v4';
+import { PROMPTS_MANIFEST_KIND_ID, promptsManifestDescriptorSchema } from '@vibesdotdev/ai-schemas';
+import { SkillCompositionDescriptorSchema } from "../../skills/descriptor.js";
+import { renderYamlFrontmatter } from "./yaml-frontmatter.js";
+function selectAssets(runtime, kind, selector, sourceId) {
+    if (!selector)
+        return [];
+    if (!runtime.hasKind(kind)) {
+        throw new Error(`Skill '${sourceId}' selects ${kind} assets, but that runtime kind is unavailable`);
+    }
+    // SAFETY: assets query returns descriptors matching T extends RuntimeDescriptor
+    const candidates = runtime.query(kind).enabled().descriptors();
+    const byId = new Map(candidates.map((candidate) => [candidate.id, candidate]));
+    const selected = new Map();
+    for (const id of selector.ids ?? []) {
+        const candidate = byId.get(id);
+        if (!candidate) {
+            throw new Error(`Skill '${sourceId}' requires missing or disabled ${kind} asset '${id}'`);
+        }
+        selected.set(id, candidate);
+    }
+    for (const candidate of [...candidates].sort((a, b) => a.id.localeCompare(b.id))) {
+        const tagged = (selector.tags?.length ?? 0) > 0 &&
+            selector.tags.some((tag) => candidate.tags?.includes(tag));
+        const prefixed = (selector.prefixes?.length ?? 0) > 0 &&
+            selector.prefixes.some((prefix) => candidate.id.startsWith(prefix));
+        if (tagged || prefixed)
+            selected.set(candidate.id, candidate);
+    }
+    for (const id of selector.excludeIds ?? [])
+        selected.delete(id);
+    if (selected.size === 0) {
+        throw new Error(`Skill '${sourceId}' selector matched no enabled ${kind} assets`);
+    }
+    return [...selected.values()];
+}
+/**
+ * The selected `prompts/manifest` prompts, named by manifest id (`role.qa`),
+ * the id a skill selector and its `promptVariables` use.
+ */
+function selectPrompts(runtime, selector, sourceId) {
+    if (!selector)
+        return [];
+    if (!runtime.hasKind(PROMPTS_MANIFEST_KIND_ID)) {
+        throw new Error(`Skill '${sourceId}' selects ${PROMPTS_MANIFEST_KIND_ID} assets, but that runtime kind is unavailable`);
+    }
+    const candidates = runtime.query(PROMPTS_MANIFEST_KIND_ID).enabled().descriptors().map((descriptor) => {
+        const parsed = promptsManifestDescriptorSchema.parse(descriptor);
+        return { descriptor: parsed, manifest: parsed.manifest };
+    });
+    const byId = new Map(candidates.map((candidate) => [candidate.manifest.id, candidate]));
+    const selected = new Map();
+    for (const id of selector.ids ?? []) {
+        const candidate = byId.get(id);
+        if (!candidate) {
+            throw new Error(`Skill '${sourceId}' requires missing or disabled ${PROMPTS_MANIFEST_KIND_ID} asset '${id}'`);
+        }
+        selected.set(id, candidate);
+    }
+    for (const candidate of [...candidates].sort((a, b) => a.manifest.id.localeCompare(b.manifest.id))) {
+        const tagged = (selector.tags ?? []).some((tag) => candidate.manifest.tags.includes(tag));
+        const prefixed = (selector.prefixes ?? []).some((prefix) => candidate.manifest.id.startsWith(prefix));
+        if (tagged || prefixed)
+            selected.set(candidate.manifest.id, candidate);
+    }
+    for (const id of selector.excludeIds ?? [])
+        selected.delete(id);
+    if (selected.size === 0) {
+        throw new Error(`Skill '${sourceId}' selector matched no enabled ${PROMPTS_MANIFEST_KIND_ID} assets`);
+    }
+    return [...selected.values()];
+}
+function renderTools(_runtime, tools) {
+    const sections = ['# Vibes tools', '', 'Invoke the exact IDs through the host\'s native Vibes tool surface. In a compact MCP catalog, use `tool-search`, inspect the schema with `tool-help`, then use `tool-call` only for read-safe tools. Other tools require their explicit host capability. The CLI equivalent is `vibes tools run <id> --input \'{...}\'`.'];
+    for (const tool of tools) {
+        sections.push('', `## \`${tool.id}\``, '', tool.mcpDescription || tool.description || tool.name || tool.id);
+        const safetyParsed = z.string().safeParse(tool.safety);
+        const objSafetyParsed = z.object({ category: z.string() }).safeParse(tool.safety);
+        const safety = safetyParsed.success ? safetyParsed.data : (objSafetyParsed.success ? objSafetyParsed.data.category : undefined);
+        if (safety)
+            sections.push('', `- Safety: \`${safety}\``);
+        if (tool.requiresApproval)
+            sections.push('- Approval: required');
+        if (tool.usageGuidance?.when)
+            sections.push(`- Use when: ${tool.usageGuidance.when}`);
+        if (tool.usageGuidance?.whenNot)
+            sections.push(`- Avoid when: ${tool.usageGuidance.whenNot}`);
+        if (tool.schemas?.input) {
+            let inputSchema = tool.schemas.input;
+            const parsedSource = RuntimeJsonSchemaSourceSchema.safeParse(tool.schemas.input);
+            if (parsedSource.success) {
+                inputSchema = toRuntimeJsonSchema(parsedSource.data, { io: 'input', unrepresentable: 'any' });
+            }
+            sections.push('', '### Input schema', '', '```json', JSON.stringify(inputSchema, null, 2), '```');
+        }
+        if (tool.examples?.length) {
+            sections.push('', '### Examples');
+            for (const example of tool.examples) {
+                sections.push('', example.description ? `- ${example.description}` : '- Example', '', '```json', JSON.stringify(example.input ?? example, null, 2), '```');
+            }
+        }
+    }
+    return `${sections.join('\n')}\n`;
+}
+async function renderPrompts(runtime, selected, descriptor) {
+    // The kind renders composition, argument defaults and typed refusals (cycles, missing parts).
+    const resolved = await Promise.all(selected.map(async ({ descriptor: promptDescriptor, manifest: prompt }) => {
+        const asset = await runtime.query(PROMPTS_MANIFEST_KIND_ID)
+            .withId(promptDescriptor.id).resolve();
+        const content = await asset.render({ args: descriptor.promptVariables?.[prompt.id] ?? {} });
+        if (!content)
+            throw new Error(`Skill '${descriptor.id}' could not resolve prompt '${prompt.id}'`);
+        return { prompt, paragraphs: content.trim().split(/\n\s*\n/).map((part) => part.trim()) };
+    }));
+    let sharedParagraphs = 0;
+    if (resolved.length > 1) {
+        const shortest = Math.min(...resolved.map(({ paragraphs }) => paragraphs.length));
+        while (sharedParagraphs < shortest &&
+            resolved.every(({ paragraphs }) => paragraphs[sharedParagraphs] === resolved[0]?.paragraphs[sharedParagraphs])) {
+            sharedParagraphs++;
+        }
+    }
+    const sections = ['# Vibes prompts'];
+    if (sharedParagraphs > 0) {
+        sections.push('', '## Shared prompt preamble', '', resolved[0].paragraphs.slice(0, sharedParagraphs).join('\n\n'));
+    }
+    const emittedParagraphs = new Set(resolved[0]?.paragraphs.slice(0, sharedParagraphs) ?? []);
+    for (const { prompt, paragraphs } of resolved) {
+        sections.push('', `## \`${prompt.id}\` — ${prompt.name}`, '');
+        if (prompt.description)
+            sections.push(prompt.description, '');
+        const remainder = paragraphs.slice(sharedParagraphs);
+        const uniqueParagraphs = remainder.filter((paragraph) => {
+            if (emittedParagraphs.has(paragraph))
+                return false;
+            emittedParagraphs.add(paragraph);
+            return true;
+        });
+        const reusedCount = remainder.length - uniqueParagraphs.length;
+        const uniqueContent = uniqueParagraphs.join('\n\n');
+        sections.push(uniqueContent || '_This prompt reuses content already included above._');
+        if (uniqueContent && reusedCount > 0) {
+            sections.push('', `_Also reuses ${reusedCount} exact paragraph${reusedCount === 1 ? '' : 's'} already included above._`);
+        }
+    }
+    return `${sections.join('\n')}\n`;
+}
+function renderAgents(agents) {
+    const sections = ['# Vibes agents'];
+    for (const agent of agents) {
+        sections.push('', `## \`${agent.id}\` — ${agent.name ?? agent.id}`, '');
+        if (agent.description)
+            sections.push(agent.description, '');
+        if (agent.promptId)
+            sections.push(`- Primary prompt: \`${agent.promptId}\``);
+        const toolIds = agent.tools?.filter((binding) => binding.enabled !== false).map((binding) => binding.toolId) ?? [];
+        if (toolIds.length)
+            sections.push(`- Bound tools: ${toolIds.map((id) => `\`${id}\``).join(', ')}`);
+        if (agent.promptTemplate) {
+            sections.push('', '### Agent instructions', '', agent.promptTemplate);
+        }
+    }
+    return `${sections.join('\n')}\n`;
+}
+function renderFrontmatter(descriptor) {
+    const metadata = {
+        author: 'vibes',
+        source: descriptor.id
+    };
+    if (descriptor.compatibility) {
+        metadata.compatibility = descriptor.compatibility;
+    }
+    if (descriptor.metadata) {
+        for (const [key, value] of Object.entries(descriptor.metadata)) {
+            if (value !== undefined) {
+                metadata[key] = value;
+            }
+        }
+    }
+    const frontmatter = {
+        name: descriptor.skillName,
+        description: descriptor.description,
+        metadata
+    };
+    if (descriptor.allowedTools && descriptor.allowedTools.length > 0) {
+        frontmatter['allowed-tools'] = descriptor.allowedTools.join(' ');
+    }
+    if (descriptor.disableModelInvocation) {
+        frontmatter['disable-model-invocation'] = true;
+    }
+    return renderYamlFrontmatter(frontmatter);
+}
+/** Compose one live `tools/skill` descriptor into a portable Agent Skill bundle. */
+export async function composeSkill(runtime, input) {
+    const descriptor = SkillCompositionDescriptorSchema.parse(input);
+    const tools = selectAssets(runtime, 'tools/tool', descriptor.tools, descriptor.id);
+    const prompts = selectPrompts(runtime, descriptor.prompts, descriptor.id);
+    const agents = selectAssets(runtime, 'tools/agent/instance', descriptor.agents, descriptor.id);
+    const references = {};
+    if (descriptor.references) {
+        Object.assign(references, descriptor.references);
+    }
+    for (const [name, content] of [
+        ['tools.md', tools.length ? renderTools(runtime, tools) : undefined],
+        ['prompts.md', prompts.length ? await renderPrompts(runtime, prompts, descriptor) : undefined],
+        ['agents.md', agents.length ? renderAgents(agents) : undefined]
+    ]) {
+        if (!content)
+            continue;
+        if (references[name]) {
+            throw new Error(`Skill '${descriptor.id}' reference '${name}' collides with a generated reference`);
+        }
+        references[name] = content;
+    }
+    const body = [`# ${descriptor.name}`, '', descriptor.description];
+    if (descriptor.instructions)
+        body.push('', descriptor.instructions);
+    const referenceNames = Object.keys(references).sort();
+    if (referenceNames.length) {
+        body.push('', '## Runtime-backed references', '');
+        if (references['agents.md'])
+            body.push('- Read [agents.md](references/agents.md) for the selected agent profile and its instructions.');
+        if (references['prompts.md'])
+            body.push('- Read [prompts.md](references/prompts.md) for the resolved Vibes prompt practices.');
+        if (references['tools.md'])
+            body.push('- Read [tools.md](references/tools.md) for exact tool IDs, safety, schemas, and invocation guidance.');
+        for (const name of referenceNames.filter((name) => !['agents.md', 'prompts.md', 'tools.md'].includes(name))) {
+            body.push(`- Read [${name}](references/${name}).`);
+        }
+    }
+    body.push('', '> Generated from live Vibes runtime descriptors. Regenerate it through `vibes dev external skills generate`; do not hand-edit the installed projection.');
+    return {
+        skillName: descriptor.skillName,
+        content: `${renderFrontmatter(descriptor)}\n\n${body.join('\n')}\n`,
+        references
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/adapters/skill/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/adapters/skill/compose.ts"],"names":[],"mappings":"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"}

package/dist/adapters/skill/consumer.d.ts

@@ -0,0 +1,5 @@
+/** Host-side Agent Skills writer and preview surface. */
+export * from './index.ts';
+export { toSkillName, SkillAdapter } from './skill-adapter.impl.consumer.ts';
+export { generateSkills, previewSkillNames, PROJECTION_RETIRED_DOC, PROJECTION_RETIRED_REASON } from './generator.impl.consumer.ts';
+//# sourceMappingURL=consumer.d.ts.map

package/dist/adapters/skill/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/consumer.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,MAAM,8BAA8B,CAAC"}

package/dist/adapters/skill/consumer.js

@@ -0,0 +1,5 @@
+/** Host-side Agent Skills writer and preview surface. */
+export * from "./index.js";
+export { toSkillName, SkillAdapter } from "./skill-adapter.impl.consumer.js";
+export { generateSkills, previewSkillNames, PROJECTION_RETIRED_DOC, PROJECTION_RETIRED_REASON } from "./generator.impl.consumer.js";
+//# sourceMappingURL=consumer.js.map

package/dist/adapters/skill/consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../../src/adapters/skill/consumer.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,MAAM,8BAA8B,CAAC"}

package/dist/adapters/skill/generator.impl.consumer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent Skills generator.
+ *
+ * Deliberate `tools/skill` compositions are generated by default. The noisy
+ * one-SKILL-per-tool projection remains an explicit diagnostic escape hatch.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { SkillAdapterOptions, SkillGenerationResult } from './types.ts';
+export declare const PROJECTION_RETIRED_DOC = "docs/architecture/CONTEXT-ENGINEERING.md \u00A7\"Retired: projecting every tool into a skill\"";
+export declare const PROJECTION_RETIRED_REASON = "Tool\u2192skill projection is retired. Use deliberate aggregate tools/skill compositions instead.";
+export declare function generateSkills(runtime: VibesRuntime, options: SkillAdapterOptions): Promise<SkillGenerationResult>;
+export declare function previewSkillNames(runtime: VibesRuntime, filter?: SkillAdapterOptions['filter'], options?: Pick<SkillAdapterOptions, 'includeTools' | 'targetId' | 'toolFilter'>): Array<{
+    sourceId: string;
+    sourceKind: 'tools/skill' | 'tools/tool';
+    skillName: string;
+    valid: boolean;
+}>;
+//# sourceMappingURL=generator.impl.consumer.d.ts.map

package/dist/adapters/skill/generator.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/generator.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAKpE,OAAO,KAAK,EAGX,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,mGACuD,CAAC;AAC3F,eAAO,MAAM,yBAAyB,sGACyD,CAAC;AAwLhG,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EACtC,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAM,GACjF,KAAK,CAAC;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,aAAa,GAAG,YAAY,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CACf,CAAC,CAwCD"}