@modeltoolsprotocol/sdk 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modeltoolsprotocol/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Add MTP --describe support to any Commander.js CLI",
   "license": "Apache-2.0",
   "type": "module",
@@ -16,6 +16,9 @@
   "scripts": {
     "test": "bun test"
   },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
   "peerDependencies": {
     "commander": ">=12.0.0"
   },

package/src/index.ts

@@ -29,6 +29,20 @@ export type {
   IODescriptor,
   Example,
   AuthConfig,
+  AuthProvider,
+  CommandAuth,
   DescribeOptions,
   CommandAnnotation,
 } from "./types.js";
+
+export {
+  ExampleSchema,
+  IODescriptorSchema,
+  ArgDescriptorSchema,
+  CommandAuthSchema,
+  CommandDescriptorSchema,
+  AuthProviderSchema,
+  AuthConfigSchema,
+  ToolSchemaSchema,
+  MTP_SPEC_VERSION,
+} from "./schemas.js";

package/src/introspect.ts

@@ -6,8 +6,7 @@ import type {
   DescribeOptions,
   ToolSchema,
 } from "./types.js";
-
-const MTP_SPEC_VERSION = "2026-02-07";
+import { MTP_SPEC_VERSION } from "./schemas.js";
 
 // Commander stores these as private fields. We access them for filtering.
 interface CommandInternals {
@@ -193,6 +192,7 @@ function buildCommand(
   if (annotation?.stdout) descriptor.stdout = annotation.stdout;
   if (annotation?.examples && annotation.examples.length > 0)
     descriptor.examples = annotation.examples;
+  if (annotation?.auth) descriptor.auth = annotation.auth;
 
   return descriptor;
 }

package/src/schemas.ts

@@ -0,0 +1,66 @@
+import { z } from "zod";
+
+export const MTP_SPEC_VERSION = "2026-02-07";
+
+export const ExampleSchema = z.object({
+  description: z.string().optional(),
+  command: z.string(),
+  output: z.string().optional(),
+});
+
+export const IODescriptorSchema = z.object({
+  contentType: z.string().optional(),
+  description: z.string().optional(),
+  schema: z.any().optional(),
+});
+
+export const ArgDescriptorSchema = z.object({
+  name: z.string(),
+  type: z.string(),
+  description: z.string().optional(),
+  required: z.boolean().default(false),
+  default: z.any().optional(),
+  values: z.array(z.string()).optional(),
+});
+
+export const CommandAuthSchema = z.object({
+  required: z.boolean().default(false),
+  scopes: z.array(z.string()).optional(),
+});
+
+export const CommandDescriptorSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  args: z.array(ArgDescriptorSchema).default([]),
+  stdin: IODescriptorSchema.optional(),
+  stdout: IODescriptorSchema.optional(),
+  examples: z.array(ExampleSchema).default([]),
+  auth: CommandAuthSchema.optional(),
+});
+
+export const AuthProviderSchema = z.object({
+  id: z.string(),
+  type: z.string(),
+  displayName: z.string().optional(),
+  authorizationUrl: z.string().optional(),
+  tokenUrl: z.string().optional(),
+  scopes: z.array(z.string()).optional(),
+  clientId: z.string().optional(),
+  registrationUrl: z.string().optional(),
+  instructions: z.string().optional(),
+});
+
+export const AuthConfigSchema = z.object({
+  required: z.boolean().default(false),
+  envVar: z.string(),
+  providers: z.array(AuthProviderSchema),
+});
+
+export const ToolSchemaSchema = z.object({
+  specVersion: z.string(),
+  name: z.string(),
+  version: z.string(),
+  description: z.string(),
+  auth: AuthConfigSchema.optional(),
+  commands: z.array(CommandDescriptorSchema),
+});

package/src/types.ts

@@ -1,5 +1,5 @@
 export interface Example {
-  description: string;
+  description?: string;
   command: string;
   output?: string;
 }
@@ -19,6 +19,11 @@ export interface ArgDescriptor {
   values?: string[];
 }
 
+export interface CommandAuth {
+  required?: boolean;
+  scopes?: string[];
+}
+
 export interface CommandDescriptor {
   name: string;
   description: string;
@@ -26,12 +31,25 @@ export interface CommandDescriptor {
   stdin?: IODescriptor;
   stdout?: IODescriptor;
   examples?: Example[];
+  auth?: CommandAuth;
 }
 
-export interface AuthConfig {
+export interface AuthProvider {
+  id: string;
   type: string;
-  description?: string;
-  [key: string]: unknown;
+  displayName?: string;
+  authorizationUrl?: string;
+  tokenUrl?: string;
+  scopes?: string[];
+  clientId?: string;
+  registrationUrl?: string;
+  instructions?: string;
+}
+
+export interface AuthConfig {
+  required?: boolean;
+  envVar: string;
+  providers: AuthProvider[];
 }
 
 export interface ToolSchema {
@@ -48,6 +66,7 @@ export interface CommandAnnotation {
   stdout?: IODescriptor;
   examples?: Example[];
   argTypes?: Record<string, string>;
+  auth?: CommandAuth;
 }
 
 export interface DescribeOptions {