feat: export versioned schemas in package.json

[joan-anthropic]

Summary

Add exports for versioned schemas (both Zod and JSON Schema) to allow consumers to import schemas cleanly. Bump version to 1.1.3.

All schema exports are now explicitly versioned with no legacy non-versioned files. Added a union schema (any) that validates manifests from any supported version.

Changes

1. Package Exports

Added export paths for:

Zod Schemas:

• ./schemas - All versioned Zod schemas (v0_1, v0_2, v0_3, latest, any)
• ./schemas/any - Union schema that accepts any version (v0.1, v0.2, v0.3)
• ./schemas/* - Wildcard export for specific schema files (e.g., ./schemas/0.2)
• ./schemas-loose - Loose validation schemas

JSON Schemas (all explicitly versioned):

• ./mcpb-manifest-v0.1.schema.json - v0.1 JSON Schema
• ./mcpb-manifest-v0.2.schema.json - v0.2 JSON Schema
• ./mcpb-manifest-v0.3.schema.json - v0.3 JSON Schema
• ./mcpb-manifest-latest.schema.json - Latest version JSON Schema

2. Union Schema (any)

Created src/schemas/any.ts:

export const McpbManifestSchema = z.union([
  v0_1.McpbManifestSchema,
  v0_2.McpbManifestSchema,
  v0_3.McpbManifestSchema,
]);

This schema accepts and validates manifests from any supported version (0.1, 0.2, 0.3).

3. JSON Schema Generation

Updated build script to generate JSON schemas for all versions:

• All versioned schemas generated to both dist/ and schemas/ directories
• Each version has strict constraints on version fields
• Removed non-versioned mcpb-manifest.schema.json (all schemas now explicitly versioned)

4. Version Bump

• Updated package version from 1.1.2 to 1.1.3

Usage Examples

Zod Schema Imports

Import union schema (recommended for validating any version):

import { McpbManifestSchema } from '@anthropic-ai/mcpb/schemas/any';
// ✅ Validates v0.1, v0.2, or v0.3 manifests

Import specific version:

import { McpbManifestSchema } from '@anthropic-ai/mcpb/schemas/0.2';
// ✅ Only validates v0.2 manifests

Import all versions as namespace:

import * as schemas from '@anthropic-ai/mcpb/schemas';
// Access: schemas.v0_1, schemas.v0_2, schemas.v0_3, schemas.latest, schemas.any

// Use the union:
schemas.any.McpbManifestSchema.parse(manifest);

// Or create custom union:
import { z } from 'zod';
const CustomSchema = z.union([
  schemas.v0_1.McpbManifestSchema,
  schemas.v0_2.McpbManifestSchema,
]);

Import latest:

import { McpbManifestSchema } from '@anthropic-ai/mcpb/schemas/latest';
// or
import { McpbManifestSchema } from '@anthropic-ai/mcpb';
// Both validate v0.3 (current latest)

JSON Schema Imports

// Import specific version JSON schema
import schemaV02 from '@anthropic-ai/mcpb/mcpb-manifest-v0.2.schema.json'

// Import latest version (recommended)
import latestSchema from '@anthropic-ai/mcpb/mcpb-manifest-latest.schema.json'

// Use in validation tools
import Ajv from 'ajv'
const ajv = new Ajv()
const validate = ajv.compile(schemaV02)

Before

Consumers had to reach into dist folder:

// @ts-ignore
import * as v0_1 from '@anthropic-ai/mcpb/dist/schemas/0.1.js'

// Ambiguous non-versioned schema
import schema from '@anthropic-ai/mcpb/mcpb-manifest.schema.json'

// No union schema available - had to create manually

After

Clean, properly exported imports with explicit versioning:

// Union schema for any version
import { McpbManifestSchema } from '@anthropic-ai/mcpb/schemas/any'

// Specific versions
import * as v0_1 from '@anthropic-ai/mcpb/schemas/0.1'

// Versioned JSON schemas
import schemaV01 from '@anthropic-ai/mcpb/mcpb-manifest-v0.1.schema.json'
import latestSchema from '@anthropic-ai/mcpb/mcpb-manifest-latest.schema.json'

Files Structure

dist/ (npm package distribution):

• schemas/any.js - Union of all versions (NEW)
• schemas/0.1.js, 0.2.js, 0.3.js - Specific versions
• schemas/latest.js - Latest version
• schemas/index.js - All exports
• mcpb-manifest-v0.1.schema.json
• mcpb-manifest-v0.2.schema.json
• mcpb-manifest-v0.3.schema.json
• mcpb-manifest-latest.schema.json
• mcpb-signature-info.schema.json

schemas/ (source schemas, included in package):

• mcpb-manifest-v0.1.schema.json
• mcpb-manifest-v0.2.schema.json
• mcpb-manifest-v0.3.schema.json
• mcpb-manifest-latest.schema.json

Testing

• ✅ Built the package successfully
• ✅ All tests pass (99 tests)
• ✅ Lint clean (0 errors, 0 warnings)
• ✅ Verified union schema exports correctly
• ✅ Verified all Zod schema files exported from dist/
• ✅ Verified only versioned JSON schemas (no legacy files)
• ✅ Verified JSON schemas have correct version constraints

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

[MarshallOfSound]

Approving for now, we should have a script that ensures the JSON files haven't drifted tho (ez follow up)