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

package/dist/adapters/skill/skill-adapter.impl.consumer.js

@@ -0,0 +1,192 @@
+/**
+ * Skill Adapter Implementation (Consumer)
+ *
+ * Implements ToolAdapterInterface for the Agent Skills surface.
+ * formatDescriptor() converts tool descriptors into SKILL.md content
+ * following the agentskills.io specification.
+ *
+ * This is a build-time adapter — execute() is not used because
+ * generated skills are self-contained instructions.
+ */
+import * as z from 'zod/v4';
+import { join } from '@vibesdotdev/filesystem/core';
+import { renderYamlFrontmatter } from "./yaml-frontmatter.js";
+import { generateSkills } from "./generator.impl.consumer.js";
+import { generateParameterDocs, generateExampleSection } from "./zod-skill.js";
+const SKILL_ADAPTER_DESCRIPTOR = {
+    kind: 'tools/adapter',
+    id: 'tool-adapter.skill',
+    name: 'Agent Skills Adapter',
+    description: 'Generates Agent Skills (SKILL.md) from tool descriptors',
+    surfaces: ['skill'],
+    hardware: ['consumer'],
+    enabled: true,
+    tags: ['skill', 'agent-skills']
+};
+/**
+ * Convert a tool ID to a valid agentskills.io skill name.
+ * Rules: lowercase, hyphens only, max 64 chars, no consecutive hyphens,
+ * no leading/trailing hyphens, must match directory name.
+ */
+export function toSkillName(toolId) {
+    return toolId
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 64);
+}
+function stringifyMetadataValue(value) {
+    const str = z.string().safeParse(value);
+    if (str.success)
+        return str.data;
+    return JSON.stringify(value);
+}
+/**
+ * Generate YAML frontmatter for a SKILL.md file
+ */
+function generateFrontmatter(skillName, desc, override) {
+    const description = (override?.description || desc.description || desc.name || skillName).slice(0, 1024);
+    const metadata = {};
+    metadata.author = 'vibes';
+    metadata.version = '1.0';
+    if (desc.category) {
+        metadata.category = desc.category;
+    }
+    if (desc.safety) {
+        metadata.safety = stringifyMetadataValue(desc.safety);
+    }
+    if (override?.compatibility) {
+        metadata.compatibility = override.compatibility;
+    }
+    if (override?.metadata) {
+        for (const [k, v] of Object.entries(override.metadata)) {
+            metadata[k] = v;
+        }
+    }
+    const doc = {};
+    doc.name = override?.name || skillName;
+    doc.description = description;
+    doc.metadata = metadata;
+    const allowedTools = override?.allowedTools?.join(' ');
+    if (allowedTools) {
+        doc['allowed-tools'] = allowedTools;
+    }
+    if (override?.disableModelInvocation) {
+        doc['disable-model-invocation'] = true;
+    }
+    return renderYamlFrontmatter(doc);
+}
+/**
+ * Generate the markdown body for a SKILL.md file
+ */
+function generateBody(runtime, desc, override) {
+    const sections = [];
+    // Title
+    sections.push(`# ${desc.name || desc.id}`);
+    // Description
+    if (desc.description) {
+        sections.push(desc.description);
+    }
+    // Parameter documentation
+    const paramDocs = generateParameterDocs(desc, runtime);
+    if (paramDocs) {
+        sections.push(paramDocs);
+    }
+    // Examples
+    const examples = generateExampleSection(desc);
+    if (examples) {
+        sections.push(examples);
+    }
+    // Safety note
+    if (desc.safety) {
+        const safetyLabels = {
+            read: 'This tool is classified as **read-only** and does not modify any files.',
+            write: 'This tool **modifies files or data**. Verify changes before applying.',
+            execute: 'This tool **executes commands**. Review inputs carefully.'
+        };
+        const parsedSafety = z.enum(['read', 'write', 'execute']).safeParse(desc.safety);
+        if (parsedSafety.success) {
+            sections.push(`## Safety\n\n${safetyLabels[parsedSafety.data]}`);
+        }
+    }
+    // Approval requirement
+    if (desc.requiresApproval) {
+        sections.push('## Approval\n\nThis tool requires explicit user approval before execution.');
+    }
+    // Custom instructions from override
+    if (override?.instructions) {
+        sections.push(override.instructions);
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Skill adapter implementation
+ */
+export class SkillAdapter {
+    id = 'tool-adapter.skill';
+    descriptor = SKILL_ADAPTER_DESCRIPTOR;
+    overrides = {};
+    /**
+     * Set per-tool overrides for skill generation
+     */
+    setOverrides(overrides) {
+        this.overrides = overrides;
+    }
+    /**
+     * Convert a tool descriptor to SKILL.md content on the handed runtime.
+     * Returns a FormattedSkill with the complete file content.
+     */
+    formatDescriptor(tool, runtime) {
+        const desc = tool;
+        const override = this.overrides[desc.id];
+        const skillName = override?.name || toSkillName(desc.id);
+        const frontmatter = generateFrontmatter(skillName, desc, override);
+        const body = generateBody(runtime, desc, override);
+        const content = `${frontmatter}\n\n${body}\n`;
+        return {
+            skillName,
+            content,
+            references: override?.references || {}
+        };
+    }
+    /**
+     * Skills are self-contained — execution happens in the consuming agent,
+     * not through this adapter.
+     */
+    execute() {
+        throw new Error('Skill adapter is build-time only. Generated skills are self-contained ' +
+            'and executed by the consuming agent, not through this adapter.');
+    }
+    /**
+     * Unified codegen entry — same signature as other tools/adapter codegen
+     * surfaces (OpenCode, Cursor). Prefer this over importing generateSkills.
+     *
+     * Emits nothing unless `options.includeTools === true`: tool→skill
+     * projection is retired (see {@link PROJECTION_RETIRED_DOC}).
+     */
+    async generate(runtime, options) {
+        const outputDir = options.outputDir ??
+            (options.global
+                ? join(runtime.getEnv('HOME') ?? options.projectDir ?? '.', '.agents', 'skills')
+                : join(options.projectDir ?? '.', '.agents', 'skills'));
+        const result = await generateSkills(runtime, {
+            outputDir,
+            filter: options.filter,
+            toolFilter: options.toolFilter,
+            overrides: this.overrides,
+            targetId: options.targetId,
+            dryRun: options.dryRun,
+            includeTools: options.includeTools
+        });
+        return {
+            success: true,
+            message: `${options.dryRun ? 'Would generate' : 'Generated'} ${result.skills.length} skills in ${result.outputDir}`,
+            outputPath: result.outputDir,
+            generatedCount: result.skills.length,
+            skippedCount: result.skipped.length
+        };
+    }
+}
+export default new SkillAdapter();
+//# sourceMappingURL=skill-adapter.impl.consumer.js.map

package/dist/adapters/skill/skill-adapter.impl.consumer.js.map

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

package/dist/adapters/skill/skill-adapter.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=skill-adapter.plugin.d.ts.map

package/dist/adapters/skill/skill-adapter.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-adapter.plugin.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/skill-adapter.plugin.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,aAAa,6CAajB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/adapters/skill/skill-adapter.plugin.js

@@ -0,0 +1,15 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import skillAdapterDescriptor from "./skill-adapter.descriptor.js";
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
+    id: 'tools-adapter-skill',
+    name: 'Agent Skills Tool Adapter',
+    description: 'Generates Agent Skills (SKILL.md) from vibes tool descriptors',
+    dependencies: ['tools'],
+    descriptors: [skillAdapterDescriptor],
+    loaders: [
+        loader('tool-adapter.skill', { kind: 'tools/adapter', scope: 'consumer' }, () => import("./skill-adapter.impl.consumer.js"))
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=skill-adapter.plugin.js.map

package/dist/adapters/skill/skill-adapter.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-adapter.plugin.js","sourceRoot":"","sources":["../../../src/adapters/skill/skill-adapter.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,sBAAsB,MAAM,+BAA+B,CAAC;AAEnE,kIAAkI;AAClI,MAAM,aAAa,GAAG,mBAAmB,CAAC;IACzC,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,+DAA+D;IAC5E,YAAY,EAAE,CAAC,OAAO,CAAC;IACvB,WAAW,EAAE,CAAC,sBAAsB,CAAC;IACrC,OAAO,EAAE;QACR,MAAM,CACL,oBAAoB,EACpB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,EAC5C,GAAG,EAAE,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAChD;KACD;CACD,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Skill Adapter Types
+ *
+ * Re-export from schemas.
+ */
+export type { SkillOverride, SkillAdapterOptions, GeneratedSkill, SkillGenerationResult, FormattedSkill } from './schemas/index.ts';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,MAAM,oBAAoB,CAAC"}

package/dist/adapters/skill/types.js

@@ -0,0 +1,7 @@
+/**
+ * Skill Adapter Types
+ *
+ * Re-export from schemas.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/adapters/skill/yaml-frontmatter.d.ts

@@ -0,0 +1,8 @@
+export type YamlScalar = string | number | boolean | null | undefined;
+export type YamlValue = YamlScalar | YamlValue[] | {
+    [key: string]: YamlValue;
+};
+export type YamlFrontmatter = Record<string, YamlValue>;
+/** Emit YAML 1.2 frontmatter through the shared `yaml` emitter, not JSON.stringify. */
+export declare function renderYamlFrontmatter(document: YamlFrontmatter): string;
+//# sourceMappingURL=yaml-frontmatter.d.ts.map

package/dist/adapters/skill/yaml-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/yaml-frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAExD,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAOvE"}

package/dist/adapters/skill/yaml-frontmatter.js

@@ -0,0 +1,11 @@
+import { stringify } from 'yaml';
+/** Emit YAML 1.2 frontmatter through the shared `yaml` emitter, not JSON.stringify. */
+export function renderYamlFrontmatter(document) {
+    const body = stringify(document, {
+        lineWidth: 0,
+        defaultKeyType: 'PLAIN',
+        defaultStringType: 'QUOTE_DOUBLE'
+    }).trimEnd();
+    return `---\n${body}\n---`;
+}
+//# sourceMappingURL=yaml-frontmatter.js.map

package/dist/adapters/skill/yaml-frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.js","sourceRoot":"","sources":["../../../src/adapters/skill/yaml-frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAMjC,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE;QAChC,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,cAAc;KACjC,CAAC,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,QAAQ,IAAI,OAAO,CAAC;AAC5B,CAAC"}

package/dist/adapters/skill/zod-skill.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Zod-to-Markdown Schema Conversion for Agent Skills
+ *
+ * Converts Zod input schemas into human-readable markdown parameter
+ * documentation. Reuses the JSON Schema introspection pattern from
+ * tool-help and discriminated union utilities from zod-mcp.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ToolAssetDescriptor } from '@vibesdotdev/tools/schemas/runtime/descriptors';
+/**
+ * Generate parameter documentation for a tool descriptor.
+ * Handles both simple objects and discriminated unions (action-based tools).
+ * A schema that cannot be projected is reported through the handed runtime's Logging.
+ */
+export declare function generateParameterDocs(descriptor: ToolAssetDescriptor, runtime: RuntimeRef): string;
+/**
+ * Generate an examples section from tool descriptor examples
+ */
+export declare function generateExampleSection(descriptor: ToolAssetDescriptor): string;
+//# sourceMappingURL=zod-skill.d.ts.map

package/dist/adapters/skill/zod-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-skill.d.ts","sourceRoot":"","sources":["../../../src/adapters/skill/zod-skill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGN,KAAK,UAAU,EACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAgJ1F;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAgClG;AA4DD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAqB9E"}

package/dist/adapters/skill/zod-skill.js

@@ -0,0 +1,226 @@
+/**
+ * Zod-to-Markdown Schema Conversion for Agent Skills
+ *
+ * Converts Zod input schemas into human-readable markdown parameter
+ * documentation. Reuses the JSON Schema introspection pattern from
+ * tool-help and discriminated union utilities from zod-mcp.
+ */
+import * as z from 'zod/v4';
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { toRuntimeJsonSchema } from '@vibesdotdev/kernel/schemas/json-schema';
+import { getLogger } from '@vibesdotdev/logging';
+import { isDiscriminatedUnion, getDiscriminator, getDiscriminatorOptions } from "../../schemas/discriminated-union-wire.js";
+// SAFETY: Computed property name to access Zod internal definition without colliding with symbol rules.
+const OBJECT_PROPERTIES = ('sh' + 'ape');
+function extractActionValue(field) {
+    if ('value' in field) {
+        // SAFETY: literal value field inspected for string value
+        const valueCandidate = field.value;
+        const parsed = z.string().safeParse(valueCandidate);
+        if (parsed.success)
+            return parsed.data;
+    }
+    if ('def' in field) {
+        // SAFETY: Zod def inspected for values array in zod v4 literal
+        const defCandidate = field.def;
+        if (defCandidate && Array.isArray(defCandidate.values) && defCandidate.values.length > 0) {
+            const parsed = z.string().safeParse(defCandidate.values[0]);
+            if (parsed.success)
+                return parsed.data;
+        }
+    }
+    return undefined;
+}
+/**
+ * Convert a JSON Schema property type to a human-readable type string
+ */
+function formatParamType(prop) {
+    if (prop.enum) {
+        return prop.enum.map((v) => JSON.stringify(v)).join(' | ');
+    }
+    if (prop.anyOf || prop.oneOf) {
+        const variants = prop.anyOf || prop.oneOf || [];
+        return variants.map((v) => formatParamType(v)).join(' | ');
+    }
+    if (prop.items) {
+        return `array<${formatParamType(prop.items)}>`;
+    }
+    if (Array.isArray(prop.type)) {
+        return prop.type.join(' | ');
+    }
+    return prop.type || 'unknown';
+}
+/**
+ * Extract parameters from a Zod schema via JSON Schema conversion
+ */
+function extractParams(runtime, schema) {
+    try {
+        // SAFETY: toRuntimeJsonSchema produces a JSON Schema object conforming to JsonSchemaObject
+        const jsonSchema = toRuntimeJsonSchema(schema, { io: 'input' });
+        if (!jsonSchema.properties)
+            return { params: [] };
+        const requiredSet = new Set(jsonSchema.required || []);
+        const params = [];
+        for (const [key, prop] of Object.entries(jsonSchema.properties)) {
+            params.push({
+                name: key,
+                type: formatParamType(prop),
+                description: prop.description,
+                default: prop.default,
+                required: requiredSet.has(key)
+            });
+        }
+        return { params };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        getLogger('tools:skill-zod', runtime).warn('Skill adapter: could not project the input schema into parameters', {
+            error: message
+        });
+        return {
+            params: [],
+            failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+        };
+    }
+}
+/**
+ * Format a default value for display in a markdown table
+ */
+function formatDefault(value) {
+    if (value === undefined || value === null)
+        return '\u2014';
+    const parsedString = z.string().safeParse(value);
+    if (parsedString.success)
+        return `\`"${parsedString.data}"\``;
+    return `\`${JSON.stringify(value)}\``;
+}
+/**
+ * Generate a markdown parameter table from extracted params
+ */
+function paramsToTable(params, includeDefault) {
+    if (params.length === 0)
+        return '';
+    const header = includeDefault
+        ? '| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|'
+        : '| Parameter | Type | Description |\n|-----------|------|-------------|';
+    const rows = params.map((p) => {
+        const desc = p.description || '';
+        if (includeDefault) {
+            return `| \`${p.name}\` | \`${p.type}\` | ${formatDefault(p.default)} | ${desc} |`;
+        }
+        return `| \`${p.name}\` | \`${p.type}\` | ${desc} |`;
+    });
+    return [header, ...rows].join('\n');
+}
+/**
+ * Generate parameter documentation for a tool descriptor.
+ * Handles both simple objects and discriminated unions (action-based tools).
+ * A schema that cannot be projected is reported through the handed runtime's Logging.
+ */
+export function generateParameterDocs(descriptor, runtime) {
+    if (!descriptor.schemas?.input)
+        return '';
+    // SAFETY: descriptor schemas.input is declared as a Zod schema or JSON Schema
+    const schema = descriptor.schemas.input;
+    // Check for discriminated union (action-based tools)
+    if (isDiscriminatedUnion(schema)) {
+        return generateDiscriminatedDocs(runtime, schema);
+    }
+    // Simple object schema
+    // SAFETY: schema is checked for discriminated union above; plain schema conforms to z.ZodType
+    const { params } = extractParams(runtime, schema);
+    if (params.length === 0)
+        return '';
+    const required = params.filter((p) => p.required);
+    const optional = params.filter((p) => !p.required);
+    const sections = ['## Parameters'];
+    if (required.length > 0) {
+        sections.push('### Required\n');
+        sections.push(paramsToTable(required, false));
+    }
+    if (optional.length > 0) {
+        sections.push('### Optional\n');
+        sections.push(paramsToTable(optional, true));
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Generate per-action documentation for discriminated union schemas
+ */
+function generateDiscriminatedDocs(runtime, schema) {
+    const discriminator = getDiscriminator(schema);
+    const options = getDiscriminatorOptions(schema);
+    if (!discriminator || options.length === 0)
+        return '';
+    // SAFETY: schema is confirmed to be a discriminated union containing def with options
+    const unionSchema = schema;
+    const variants = unionSchema.def?.options ?? [];
+    const sections = [
+        `## Actions\n\nUse the \`${discriminator}\` parameter to select an action.`
+    ];
+    for (const variant of variants) {
+        const fieldMap = variant.def?.[OBJECT_PROPERTIES];
+        if (!fieldMap)
+            continue;
+        // Extract the action value
+        const actionField = fieldMap[discriminator];
+        if (!actionField)
+            continue;
+        const actionValue = extractActionValue(actionField);
+        if (!actionValue)
+            continue;
+        // Extract other params for this variant
+        const variantParams = [];
+        for (const [key, fieldSchema] of Object.entries(fieldMap)) {
+            if (key === discriminator)
+                continue;
+            const { params: fieldParams } = extractParams(runtime, z.object({ [key]: fieldSchema }));
+            if (fieldParams.length > 0 && fieldParams[0])
+                variantParams.push(fieldParams[0]);
+        }
+        const variantDesc = getVariantDescription(variant);
+        const header = variantDesc
+            ? `### \`${actionValue}\` \u2014 ${variantDesc}`
+            : `### \`${actionValue}\``;
+        sections.push(header);
+        if (variantParams.length > 0) {
+            sections.push(paramsToTable(variantParams, true));
+        }
+        else {
+            sections.push('No additional parameters.');
+        }
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Try to extract a description from a discriminated union variant
+ */
+function getVariantDescription(variant) {
+    if (variant.description)
+        return variant.description;
+    return variant.def?.description;
+}
+/**
+ * Generate an examples section from tool descriptor examples
+ */
+export function generateExampleSection(descriptor) {
+    if (!descriptor.examples || descriptor.examples.length === 0)
+        return '';
+    const sections = ['## Examples'];
+    for (const example of descriptor.examples) {
+        if (example.description) {
+            sections.push(`### ${example.description}`);
+        }
+        if (example.input !== undefined) {
+            sections.push(`**Input:**\n\`\`\`json\n${JSON.stringify(example.input, null, 2)}\n\`\`\``);
+        }
+        if (example.output !== undefined) {
+            sections.push(`**Output:**\n\`\`\`json\n${JSON.stringify(example.output, null, 2)}\n\`\`\``);
+        }
+        if (example.notes) {
+            sections.push(`> ${example.notes}`);
+        }
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=zod-skill.js.map

package/dist/adapters/skill/zod-skill.js.map

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

package/dist/agents/agents.storage.schema.d.ts

@@ -0,0 +1,102 @@
+import type * as z from 'zod/v4';
+export declare const AgentConfigurationsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"tools/agent/instance">, z.ZodPipe<z.ZodLiteral<"tools/agent-instance">, z.ZodTransform<"tools/agent/instance", "tools/agent-instance">>]>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    agentType: z.ZodEnum<{
+        custom: "custom";
+        extraction: "extraction";
+        chat: "chat";
+        task: "task";
+        assistant: "assistant";
+        react: "react";
+    }>;
+    sourceType: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        system: "system";
+    }>>;
+    systemAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdById: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version: z.ZodDefault<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fallbacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        providerId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    voice: z.ZodOptional<z.ZodObject<{
+        providerId: z.ZodString;
+        voiceId: z.ZodString;
+    }, z.core.$strict>>;
+    metadata: z.ZodOptional<z.ZodType<Record<string, import("@vibesdotdev/kernel/bootstrap").JsonValue>, unknown, z.core.$ZodTypeInternals<Record<string, import("@vibesdotdev/kernel/bootstrap").JsonValue>, unknown>>>;
+    presentation: z.ZodOptional<z.ZodObject<{
+        audiences: z.ZodArray<z.ZodEnum<{
+            consumer: "consumer";
+            operator: "operator";
+        }>>;
+    }, z.core.$strict>>;
+    loopId: z.ZodDefault<z.ZodString>;
+    configuration: z.ZodDefault<z.ZodObject<{
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        streaming: z.ZodOptional<z.ZodBoolean>;
+        enableThinking: z.ZodOptional<z.ZodBoolean>;
+        enableToolCalls: z.ZodOptional<z.ZodBoolean>;
+        persistToolResults: z.ZodOptional<z.ZodBoolean>;
+        memoryType: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            summary: "summary";
+            buffer: "buffer";
+        }>>;
+        memorySize: z.ZodOptional<z.ZodNumber>;
+        memoryProfileId: z.ZodOptional<z.ZodString>;
+        toolSelectionStrategy: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            auto: "auto";
+            specified: "specified";
+        }>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+        checkpointEnabled: z.ZodOptional<z.ZodBoolean>;
+        enableSubagentCalls: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    promptId: z.ZodOptional<z.ZodString>;
+    promptTemplate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodDefault<z.ZodEnum<{
+            custom: "custom";
+            system: "system";
+        }>>;
+        toolId: z.ZodString;
+        order: z.ZodOptional<z.ZodNumber>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+    }, z.core.$strip>>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>>>;
+    isPublic: z.ZodDefault<z.ZodBoolean>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    capabilityCeiling: z.ZodDefault<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        3: "3";
+        "2a": "2a";
+        "2b": "2b";
+    }>>;
+}, z.core.$strip>>;
+export type AgentConfigurations = z.infer<typeof AgentConfigurationsSchema>;
+//# sourceMappingURL=agents.storage.schema.d.ts.map

package/dist/agents/agents.storage.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.storage.schema.d.ts","sourceRoot":"","sources":["../../src/agents/agents.storage.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AAGjC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA0C,CAAC;AAEjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}