feat: versioned schemas

src/browser.ts

@@ -1,4 +1,5 @@
 // Browser-compatible exports
-export * from "./schemas.js";
+export * from "./schemas/latest.js";
 export * from "./shared/config.js";
+export * from "./shared/constants.js";
 export * from "./types.js";

src/cli.ts

@@ -3,8 +3,9 @@ export * from "./cli/init.js";
 export * from "./cli/pack.js";
 
 // Include all shared exports
-export * from "./schemas.js";
+export * from "./schemas/latest.js";
 export * from "./shared/config.js";
+export * from "./shared/constants.js";
 export * from "./types.js";
 
 // Include node exports since CLI needs them

src/cli/init.ts

@@ -2,7 +2,7 @@ import { confirm, input, select } from "@inquirer/prompts";
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { basename, join, resolve } from "path";
 
-import { CURRENT_MANIFEST_VERSION } from "../schemas.js";
+import { LATEST_MANIFEST_VERSION } from "../shared/constants.js";
 import type { McpbManifest } from "../types.js";
 
 interface PackageJson {
@@ -774,7 +774,7 @@ export function buildManifest(
   const { keywords, license, repository } = optionalFields;
 
   return {
-    manifest_version: CURRENT_MANIFEST_VERSION,
+    manifest_version: LATEST_MANIFEST_VERSION,
     name,
     ...(displayName && displayName !== name
       ? { display_name: displayName }

src/cli/pack.ts

@@ -13,7 +13,10 @@ import { basename, join, relative, resolve, sep } from "path";
 
 import { getAllFilesWithCount, readMcpbIgnorePatterns } from "../node/files.js";
 import { validateManifest } from "../node/validate.js";
-import { CURRENT_MANIFEST_VERSION, McpbManifestSchema } from "../schemas.js";
+import {
+  LATEST_MANIFEST_SCHEMA,
+  LATEST_MANIFEST_VERSION,
+} from "../shared/constants.js";
 import { getLogger } from "../shared/log.js";
 import { initExtension } from "./init.js";
 
@@ -92,7 +95,7 @@ export async function packExtension({
   try {
     const manifestContent = readFileSync(manifestPath, "utf-8");
     const manifestData = JSON.parse(manifestContent);
-    manifest = McpbManifestSchema.parse(manifestData);
+    manifest = LATEST_MANIFEST_SCHEMA.parse(manifestData);
   } catch (error) {
     logger.error("ERROR: Failed to parse manifest.json");
     if (error instanceof Error) {
@@ -102,12 +105,12 @@ export async function packExtension({
   }
 
   const manifestVersion = manifest.manifest_version || manifest.dxt_version;
-  if (manifestVersion !== CURRENT_MANIFEST_VERSION) {
+  if (manifestVersion !== LATEST_MANIFEST_VERSION) {
     logger.error(
-      `ERROR: Manifest version mismatch. Expected "${CURRENT_MANIFEST_VERSION}", found "${manifestVersion}"`,
+      `ERROR: Manifest version mismatch. Expected "${LATEST_MANIFEST_VERSION}", found "${manifestVersion}"`,
     );
     logger.error(
-      `  Please update the manifest_version in your manifest.json to "${CURRENT_MANIFEST_VERSION}"`,
+      `  Please update the manifest_version in your manifest.json to "${LATEST_MANIFEST_VERSION}"`,
     );
     return false;
   }

src/index.ts

@@ -5,6 +5,7 @@ export * from "./cli/unpack.js";
 export * from "./node/files.js";
 export * from "./node/sign.js";
 export * from "./node/validate.js";
-export * from "./schemas.js";
+export * from "./schemas/latest.js";
 export * from "./shared/config.js";
+export * from "./shared/constants.js";
 export * from "./types.js";

src/node.ts

@@ -4,6 +4,7 @@ export * from "./node/sign.js";
 export * from "./node/validate.js";
 
 // Include all shared exports
-export * from "./schemas.js";
+export * from "./schemas/latest.js";
 export * from "./shared/config.js";
+export * from "./shared/constants.js";
 export * from "./types.js";

src/node/validate.ts

@@ -6,8 +6,10 @@ import { join, resolve } from "path";
 import prettyBytes from "pretty-bytes";
 
 import { unpackExtension } from "../cli/unpack.js";
-import { McpbManifestSchema } from "../schemas.js";
-import { McpbManifestSchema as LooseMcpbManifestSchema } from "../schemas-loose.js";
+import {
+  LATEST_MANIFEST_SCHEMA,
+  LATEST_MANIFEST_SCHEMA_LOOSE,
+} from "../shared/constants.js";
 
 export function validateManifest(inputPath: string): boolean {
   try {
@@ -22,7 +24,7 @@ export function validateManifest(inputPath: string): boolean {
     const manifestContent = readFileSync(manifestPath, "utf-8");
     const manifestData = JSON.parse(manifestContent);
 
-    const result = McpbManifestSchema.safeParse(manifestData);
+    const result = LATEST_MANIFEST_SCHEMA.safeParse(manifestData);
 
     if (result.success) {
       console.log("Manifest schema validation passes!");
@@ -72,7 +74,7 @@ export async function cleanMcpb(inputPath: string) {
     const manifestPath = resolve(unpackPath, "manifest.json");
     const originalManifest = await fs.readFile(manifestPath, "utf-8");
     const manifestData = JSON.parse(originalManifest);
-    const result = LooseMcpbManifestSchema.safeParse(manifestData);
+    const result = LATEST_MANIFEST_SCHEMA_LOOSE.safeParse(manifestData);
 
     if (!result.success) {
       throw new Error(

src/schemas.ts → src/schemas/0.1.ts

@@ -1,6 +1,6 @@
 import * as z from "zod";
 
-export const CURRENT_MANIFEST_VERSION = "0.2";
+export const MANIFEST_VERSION = "0.1";
 
 export const McpServerConfigSchema = z.strictObject({
   command: z.string(),
@@ -34,18 +34,16 @@
   mcp_config: McpbManifestMcpConfigSchema,
 });
 
-export const McpbManifestCompatibilitySchema = z
-  .strictObject({
-    claude_desktop: z.string().optional(),
-    platforms: z.array(z.enum(["darwin", "win32", "linux"])).optional(),
-    runtimes: z
-      .strictObject({
-        python: z.string().optional(),
-        node: z.string().optional(),
-      })
-      .optional(),
-  })
-  .passthrough();
+export const McpbManifestCompatibilitySchema = z.strictObject({
+  claude_desktop: z.string().optional(),
+  platforms: z.array(z.enum(["darwin", "win32", "linux"])).optional(),
+  runtimes: z
+    .strictObject({
+      python: z.string().optional(),
+      node: z.string().optional(),
+    })
+    .optional(),
+});
 
 export const McpbManifestToolSchema = z.strictObject({
   name: z.string(),
@@ -82,10 +80,10 @@
   .strictObject({
     $schema: z.string().optional(),
     dxt_version: z
-      .string()
+      .literal(MANIFEST_VERSION)
       .optional()
       .describe("@deprecated Use manifest_version instead"),
-    manifest_version: z.string().optional(),
+    manifest_version: z.literal(MANIFEST_VERSION).optional(),
     name: z.string(),
     display_name: z.string().optional(),
     version: z.string(),
@@ -100,12 +98,11 @@
     screenshots: z.array(z.string()).optional(),
     server: McpbManifestServerSchema,
     tools: z.array(McpbManifestToolSchema).optional(),
     tools_generated: z.boolean().optional(),  
     prompts: z.array(McpbManifestPromptSchema).optional(),
     prompts_generated: z.boolean().optional(),
     keywords: z.array(z.string()).optional(),
     license: z.string().optional(),
-    privacy_policies: z.array(z.string()).optional(),
     compatibility: McpbManifestCompatibilitySchema.optional(),
     user_config: z
       .record(z.string(), McpbUserConfigurationOptionSchema)

src/schemas/0.2.ts

@@ -0,0 +1,124 @@
+import * as z from "zod";
+
+export const MANIFEST_VERSION = "0.2";
+
+export const McpServerConfigSchema = z.strictObject({
+  command: z.string(),
+  args: z.array(z.string()).optional(),
+  env: z.record(z.string(), z.string()).optional(),
+});
+
+export const McpbManifestAuthorSchema = z.strictObject({
+  name: z.string(),
+  email: z.string().email().optional(),
+  url: z.string().url().optional(),
+});
+
+export const McpbManifestRepositorySchema = z.strictObject({
+  type: z.string(),
+  url: z.string().url(),
+});
+
+export const McpbManifestPlatformOverrideSchema =
+  McpServerConfigSchema.partial();
+
+export const McpbManifestMcpConfigSchema = McpServerConfigSchema.extend({
+  platform_overrides: z
+    .record(z.string(), McpbManifestPlatformOverrideSchema)
+    .optional(),
+});
+
+export const McpbManifestServerSchema = z.strictObject({
+  type: z.enum(["python", "node", "binary"]),
+  entry_point: z.string(),
+  mcp_config: McpbManifestMcpConfigSchema,
+});
+
+export const McpbManifestCompatibilitySchema = z.strictObject({
+  claude_desktop: z.string().optional(),
+  platforms: z.array(z.enum(["darwin", "win32", "linux"])).optional(),
+  runtimes: z
+    .strictObject({
+      python: z.string().optional(),
+      node: z.string().optional(),
+    })
+    .optional(),
+});
+
+export const McpbManifestToolSchema = z.strictObject({
+  name: z.string(),
+  description: z.string().optional(),
+});
+
+export const McpbManifestPromptSchema = z.strictObject({
+  name: z.string(),
+  description: z.string().optional(),
+  arguments: z.array(z.string()).optional(),
+  text: z.string(),
+});
+
+export const McpbUserConfigurationOptionSchema = z.strictObject({
+  type: z.enum(["string", "number", "boolean", "directory", "file"]),
+  title: z.string(),
+  description: z.string(),
+  required: z.boolean().optional(),
+  default: z
+    .union([z.string(), z.number(), z.boolean(), z.array(z.string())])
+    .optional(),
+  multiple: z.boolean().optional(),
+  sensitive: z.boolean().optional(),
+  min: z.number().optional(),
+  max: z.number().optional(),
+});
+
+export const McpbUserConfigValuesSchema = z.record(
+  z.string(),
+  z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]),
+);
+
+export const McpbManifestSchema = z
+  .strictObject({
+    $schema: z.string().optional(),
+    dxt_version: z
+      .literal(MANIFEST_VERSION)
+      .optional()
+      .describe("@deprecated Use manifest_version instead"),
+    manifest_version: z.literal(MANIFEST_VERSION).optional(),
+    name: z.string(),
+    display_name: z.string().optional(),
+    version: z.string(),
+    description: z.string(),
+    long_description: z.string().optional(),
+    author: McpbManifestAuthorSchema,
+    repository: McpbManifestRepositorySchema.optional(),
+    homepage: z.string().url().optional(),
+    documentation: z.string().url().optional(),
+    support: z.string().url().optional(),
+    icon: z.string().optional(),
+    screenshots: z.array(z.string()).optional(),
+    server: McpbManifestServerSchema,
+    tools: z.array(McpbManifestToolSchema).optional(),
+    tools_generated: z.boolean().optional(),
+    prompts: z.array(McpbManifestPromptSchema).optional(),
+    prompts_generated: z.boolean().optional(),
+    keywords: z.array(z.string()).optional(),
+    license: z.string().optional(),
+    privacy_policies: z.array(z.string().url()).optional(),
+    compatibility: McpbManifestCompatibilitySchema.optional(),
+    user_config: z
+      .record(z.string(), McpbUserConfigurationOptionSchema)
+      .optional(),
+  })
+  .refine((data) => !!(data.dxt_version || data.manifest_version), {
+    message:
+      "Either 'dxt_version' (deprecated) or 'manifest_version' must be provided",
+  });
+
+export const McpbSignatureInfoSchema = z.strictObject({
+  status: z.enum(["signed", "unsigned", "self-signed"]),
+  publisher: z.string().optional(),
+  issuer: z.string().optional(),
+  valid_from: z.string().optional(),
+  valid_to: z.string().optional(),
+  fingerprint: z.string().optional(),
+});