@vibe-agent-toolkit/agent-schema 0.1.9 → 0.1.11

package/README.md

@@ -41,6 +41,7 @@ Available schemas:
 - `agent-interface.json` - Input/output interface
 - `tool.json` - Tool definitions
 - `resource-registry.json` - Resource registry
+- `vat-package-metadata.json` - VAT package.json metadata (distribution standard)
 
 ## Exported Schemas
 
@@ -49,6 +50,7 @@ Available schemas:
 - `AgentManifestSchema` - Complete agent.yaml structure
 - `AgentMetadataSchema` - Agent metadata (name, version, etc.)
 - `AgentSpecSchema` - Agent specification (LLM, tools, resources)
+- `VatPackageMetadataSchema` - package.json `vat` field for distribution
 
 ### Component Schemas
 
@@ -80,7 +82,9 @@ import type {
 } from '@vibe-agent-toolkit/agent-schema';
 ```
 
-## Validation Example
+## Validation Examples
+
+### Validate agent.yaml
 
 ```typescript
 import { AgentManifestSchema } from '@vibe-agent-toolkit/agent-schema';
@@ -105,6 +109,31 @@ if (!result.success) {
 console.log('✅ Valid agent manifest');
 ```
 
+### Validate package.json VAT metadata
+
+```typescript
+import { VatPackageMetadataSchema } from '@vibe-agent-toolkit/agent-schema';
+import { readFileSync } from 'node:fs';
+
+// Load package.json
+const packageJson = JSON.parse(readFileSync('package.json', 'utf-8'));
+
+// Validate vat field
+if (packageJson.vat) {
+  const result = VatPackageMetadataSchema.safeParse(packageJson.vat);
+
+  if (!result.success) {
+    console.error('Invalid VAT metadata:');
+    result.error.issues.forEach(issue => {
+      console.error(`- ${issue.path.join('.')}: ${issue.message}`);
+    });
+    process.exit(1);
+  }
+
+  console.log('✅ Valid VAT metadata');
+}
+```
+
 ## Schema Generation
 
 JSON Schemas are automatically generated from Zod schemas during build:

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export { AgentInterfaceSchema, SchemaRefSchema, type Agent, type AgentInterface,
 export { ToolAlternativeSchema, ToolSchema, type Tool, type ToolAlternative, } from './tool.js';
 export { ResourceRegistrySchema, ResourceSchema, type Resource, type ResourceRegistry, } from './resource-registry.js';
 export { AgentManifestSchema, AgentSpecSchema, CompositionConfigSchema, CredentialsConfigSchema, MemoryConfigSchema, PromptConfigSchema, PromptsConfigSchema, RAGConfigSchema, TestConfigSchema, type AgentManifest, type AgentSpec, type CompositionConfig, type CredentialsConfig, type MemoryConfig, type PromptConfig, type PromptsConfig, type RAGConfig, type TestConfig, } from './agent-manifest.js';
+export { VatAgentMetadataSchema, VatPackageMetadataSchema, VatPureFunctionMetadataSchema, VatSkillMetadataSchema, type VatAgentMetadata, type VatPackageMetadata, type VatPureFunctionMetadata, type VatSkillMetadata, } from './package-metadata.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,IAAI,EACT,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,IAAI,EACT,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -15,4 +15,5 @@ export { AgentInterfaceSchema, SchemaRefSchema, } from './interface.js';
 export { ToolAlternativeSchema, ToolSchema, } from './tool.js';
 export { ResourceRegistrySchema, ResourceSchema, } from './resource-registry.js';
 export { AgentManifestSchema, AgentSpecSchema, CompositionConfigSchema, CredentialsConfigSchema, MemoryConfigSchema, PromptConfigSchema, PromptsConfigSchema, RAGConfigSchema, TestConfigSchema, } from './agent-manifest.js';
+export { VatAgentMetadataSchema, VatPackageMetadataSchema, VatPureFunctionMetadataSchema, VatSkillMetadataSchema, } from './package-metadata.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,eAAe;AACf,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,GAGX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAUjB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,eAAe;AACf,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,GAGX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAUjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,GAKvB,MAAM,uBAAuB,CAAC"}

package/dist/package-metadata.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Package metadata schemas for VAT distribution standard
+ *
+ * Defines the `vat` field structure in package.json for distributing
+ * VAT artifacts (skills, agents, pure functions, runtimes).
+ */
+import { z } from 'zod';
+/**
+ * Skill metadata for distribution
+ *
+ * Describes a Claude Skill packaged in this npm package.
+ */
+export declare const VatSkillMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodString;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    source: string;
+}, {
+    path: string;
+    name: string;
+    source: string;
+}>;
+export type VatSkillMetadata = z.infer<typeof VatSkillMetadataSchema>;
+/**
+ * Agent metadata for distribution
+ *
+ * Describes a VAT agent (agent.yaml based) packaged in this npm package.
+ */
+export declare const VatAgentMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    type?: string | undefined;
+}, {
+    path: string;
+    name: string;
+    type?: string | undefined;
+}>;
+export type VatAgentMetadata = z.infer<typeof VatAgentMetadataSchema>;
+/**
+ * Pure function tool metadata for distribution
+ *
+ * Describes a pure function tool exposed via MCP/CLI.
+ */
+export declare const VatPureFunctionMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    exports: z.ZodOptional<z.ZodObject<{
+        mcp: z.ZodOptional<z.ZodString>;
+        cli: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mcp?: string | undefined;
+        cli?: string | undefined;
+    }, {
+        mcp?: string | undefined;
+        cli?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    exports?: {
+        mcp?: string | undefined;
+        cli?: string | undefined;
+    } | undefined;
+}, {
+    path: string;
+    name: string;
+    exports?: {
+        mcp?: string | undefined;
+        cli?: string | undefined;
+    } | undefined;
+}>;
+export type VatPureFunctionMetadata = z.infer<typeof VatPureFunctionMetadataSchema>;
+/**
+ * VAT package metadata (package.json "vat" field)
+ *
+ * Complete metadata for a VAT package that can contain skills, agents,
+ * pure functions, and runtime adapters.
+ */
+export declare const VatPackageMetadataSchema: z.ZodObject<{
+    version: z.ZodString;
+    type: z.ZodEnum<["agent-bundle", "skill", "runtime", "toolkit"]>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        source: z.ZodString;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        source: string;
+    }, {
+        path: string;
+        name: string;
+        source: string;
+    }>, "many">>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        type?: string | undefined;
+    }, {
+        path: string;
+        name: string;
+        type?: string | undefined;
+    }>, "many">>;
+    pureFunctions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        exports: z.ZodOptional<z.ZodObject<{
+            mcp: z.ZodOptional<z.ZodString>;
+            cli: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        }, {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        exports?: {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        } | undefined;
+    }, {
+        path: string;
+        name: string;
+        exports?: {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        } | undefined;
+    }>, "many">>;
+    runtimes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "agent-bundle" | "skill" | "runtime" | "toolkit";
+    version: string;
+    skills?: {
+        path: string;
+        name: string;
+        source: string;
+    }[] | undefined;
+    agents?: {
+        path: string;
+        name: string;
+        type?: string | undefined;
+    }[] | undefined;
+    pureFunctions?: {
+        path: string;
+        name: string;
+        exports?: {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    runtimes?: string[] | undefined;
+}, {
+    type: "agent-bundle" | "skill" | "runtime" | "toolkit";
+    version: string;
+    skills?: {
+        path: string;
+        name: string;
+        source: string;
+    }[] | undefined;
+    agents?: {
+        path: string;
+        name: string;
+        type?: string | undefined;
+    }[] | undefined;
+    pureFunctions?: {
+        path: string;
+        name: string;
+        exports?: {
+            mcp?: string | undefined;
+            cli?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    runtimes?: string[] | undefined;
+}>;
+export type VatPackageMetadata = z.infer<typeof VatPackageMetadataSchema>;
+//# sourceMappingURL=package-metadata.d.ts.map

package/dist/package-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.d.ts","sourceRoot":"","sources":["../src/package-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAekB,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAee,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBiB,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ByB,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/package-metadata.js

@@ -0,0 +1,113 @@
+/**
+ * Package metadata schemas for VAT distribution standard
+ *
+ * Defines the `vat` field structure in package.json for distributing
+ * VAT artifacts (skills, agents, pure functions, runtimes).
+ */
+import { z } from 'zod';
+/**
+ * Skill metadata for distribution
+ *
+ * Describes a Claude Skill packaged in this npm package.
+ */
+export const VatSkillMetadataSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .describe('Skill name (used for installation directory)'),
+    source: z
+        .string()
+        .min(1)
+        .describe('Source SKILL.md path (relative to package root, for rebuilding)'),
+    path: z
+        .string()
+        .min(1)
+        .describe('Built skill directory path (relative to package root)'),
+})
+    .describe('Claude Skill metadata for distribution');
+/**
+ * Agent metadata for distribution
+ *
+ * Describes a VAT agent (agent.yaml based) packaged in this npm package.
+ */
+export const VatAgentMetadataSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .describe('Agent name'),
+    path: z
+        .string()
+        .min(1)
+        .describe('Agent directory path (relative to package root)'),
+    type: z
+        .string()
+        .optional()
+        .describe('Agent archetype (optional, e.g., "llm-analyzer", "pure-function")'),
+})
+    .describe('VAT agent metadata for distribution');
+/**
+ * Pure function tool metadata for distribution
+ *
+ * Describes a pure function tool exposed via MCP/CLI.
+ */
+export const VatPureFunctionMetadataSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .describe('Pure function name'),
+    path: z
+        .string()
+        .min(1)
+        .describe('Implementation path (relative to package root)'),
+    exports: z
+        .object({
+        mcp: z
+            .string()
+            .optional()
+            .describe('MCP server export path (relative to package root)'),
+        cli: z
+            .string()
+            .optional()
+            .describe('CLI invocation pattern (e.g., "vat-cat-agents haiku-validate")'),
+    })
+        .optional()
+        .describe('Export mechanisms for this pure function'),
+})
+    .describe('Pure function tool metadata for distribution');
+/**
+ * VAT package metadata (package.json "vat" field)
+ *
+ * Complete metadata for a VAT package that can contain skills, agents,
+ * pure functions, and runtime adapters.
+ */
+export const VatPackageMetadataSchema = z
+    .object({
+    version: z
+        .string()
+        .regex(/^\d+\.\d+$/)
+        .describe('VAT metadata schema version (currently "1.0")'),
+    type: z
+        .enum(['agent-bundle', 'skill', 'runtime', 'toolkit'])
+        .describe('Package type'),
+    skills: z
+        .array(VatSkillMetadataSchema)
+        .optional()
+        .describe('Claude Skills for distribution'),
+    agents: z
+        .array(VatAgentMetadataSchema)
+        .optional()
+        .describe('VAT agents (agent.yaml based)'),
+    pureFunctions: z
+        .array(VatPureFunctionMetadataSchema)
+        .optional()
+        .describe('Pure function tools'),
+    runtimes: z
+        .array(z.string())
+        .optional()
+        .describe('Runtime adapters provided (e.g., "vercel-ai-sdk", "langchain")'),
+})
+    .describe('VAT package metadata (package.json "vat" field)');
+//# sourceMappingURL=package-metadata.js.map

package/dist/package-metadata.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/agent-schema",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "JSON Schema definitions and TypeScript types for VAT agent manifest format",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "zod-to-json-schema": "^3.23.5"
   },
   "devDependencies": {
-    "@vibe-agent-toolkit/utils": "0.1.9",
+    "@vibe-agent-toolkit/utils": "0.1.11",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"

package/schemas/vat-package-metadata.json

@@ -0,0 +1,139 @@
+{
+  "$ref": "#/definitions/vat-package-metadata",
+  "definitions": {
+    "vat-package-metadata": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+$",
+          "description": "VAT metadata schema version (currently \"1.0\")"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "agent-bundle",
+            "skill",
+            "runtime",
+            "toolkit"
+          ],
+          "description": "Package type"
+        },
+        "skills": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Skill name (used for installation directory)"
+              },
+              "source": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Source SKILL.md path (relative to package root, for rebuilding)"
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Built skill directory path (relative to package root)"
+              }
+            },
+            "required": [
+              "name",
+              "source",
+              "path"
+            ],
+            "additionalProperties": false,
+            "description": "Claude Skill metadata for distribution"
+          },
+          "description": "Claude Skills for distribution"
+        },
+        "agents": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Agent name"
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Agent directory path (relative to package root)"
+              },
+              "type": {
+                "type": "string",
+                "description": "Agent archetype (optional, e.g., \"llm-analyzer\", \"pure-function\")"
+              }
+            },
+            "required": [
+              "name",
+              "path"
+            ],
+            "additionalProperties": false,
+            "description": "VAT agent metadata for distribution"
+          },
+          "description": "VAT agents (agent.yaml based)"
+        },
+        "pureFunctions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Pure function name"
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Implementation path (relative to package root)"
+              },
+              "exports": {
+                "type": "object",
+                "properties": {
+                  "mcp": {
+                    "type": "string",
+                    "description": "MCP server export path (relative to package root)"
+                  },
+                  "cli": {
+                    "type": "string",
+                    "description": "CLI invocation pattern (e.g., \"vat-cat-agents haiku-validate\")"
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Export mechanisms for this pure function"
+              }
+            },
+            "required": [
+              "name",
+              "path"
+            ],
+            "additionalProperties": false,
+            "description": "Pure function tool metadata for distribution"
+          },
+          "description": "Pure function tools"
+        },
+        "runtimes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Runtime adapters provided (e.g., \"vercel-ai-sdk\", \"langchain\")"
+        }
+      },
+      "required": [
+        "version",
+        "type"
+      ],
+      "additionalProperties": false,
+      "description": "VAT package metadata (package.json \"vat\" field)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}