@nimblebrain/mpak 0.1.0 → 0.3.0

package/src/lib/api/schema.d.ts

@@ -1,520 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-
-export interface paths {
-    "/v1/bundles/search": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Search for bundles */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Search query */
-                    q?: string;
-                    /** @description Filter by server type */
-                    type?: string;
-                    sort?: "downloads" | "recent" | "name";
-                    limit?: number;
-                    offset?: number;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            bundles: {
-                                name: string;
-                                display_name?: string | null;
-                                description?: string | null;
-                                author?: {
-                                    name: string;
-                                } | null;
-                                latest_version: string;
-                                icon?: string | null;
-                                server_type?: string | null;
-                                tools?: {
-                                    name: string;
-                                    description?: string;
-                                }[];
-                                downloads: number;
-                                published_at: string | unknown;
-                                verified: boolean;
-                                provenance?: {
-                                    schema_version: string;
-                                    provider: string;
-                                    repository: string;
-                                    sha: string;
-                                } | null;
-                            }[];
-                            total: number;
-                            pagination: {
-                                limit: number;
-                                offset: number;
-                                has_more: boolean;
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/@{scope}/{package}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Get detailed bundle information */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    scope: string;
-                    package: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            name: string;
-                            display_name?: string | null;
-                            description?: string | null;
-                            author?: {
-                                name: string;
-                            } | null;
-                            latest_version: string;
-                            icon?: string | null;
-                            server_type?: string | null;
-                            tools?: {
-                                name: string;
-                                description?: string;
-                            }[];
-                            downloads: number;
-                            published_at: string | unknown;
-                            verified: boolean;
-                            provenance?: {
-                                schema_version: string;
-                                provider: string;
-                                repository: string;
-                                sha: string;
-                            } | null;
-                            homepage?: string | null;
-                            license?: string | null;
-                            versions: {
-                                version: string;
-                                published_at: string | unknown;
-                                downloads: number;
-                            }[];
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/@{scope}/{package}/index.json": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Get multi-platform distribution index for a bundle (MCPB Index spec) */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    scope: string;
-                    package: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            index_version: string;
-                            mimeType: string;
-                            name: string;
-                            version: string;
-                            description: string | null;
-                            bundles: {
-                                mimeType: string | null;
-                                digest: string;
-                                size: number;
-                                platform: {
-                                    os: string;
-                                    arch: string;
-                                };
-                                urls: string[];
-                            }[];
-                            annotations?: {
-                                [key: string]: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/@{scope}/{package}/versions": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description List all versions of a bundle */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    scope: string;
-                    package: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            name: string;
-                            latest: string;
-                            versions: {
-                                version: string;
-                                artifacts_count: number;
-                                platforms: {
-                                    os: string;
-                                    arch: string;
-                                }[];
-                                published_at: string | unknown;
-                                downloads: number;
-                                publish_method: string | null;
-                                provenance?: {
-                                    schema_version: string;
-                                    provider: string;
-                                    repository: string;
-                                    sha: string;
-                                } | null;
-                            }[];
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/@{scope}/{package}/versions/{version}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Get information about a specific version */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    scope: string;
-                    package: string;
-                    version: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            name: string;
-                            version: string;
-                            published_at: string | unknown;
-                            downloads: number;
-                            artifacts: {
-                                platform: {
-                                    os: string;
-                                    arch: string;
-                                };
-                                digest: string;
-                                size: number;
-                                download_url: string;
-                                source_url?: string;
-                            }[];
-                            manifest: {
-                                [key: string]: unknown;
-                            };
-                            release?: {
-                                tag: string | null;
-                                url: string | null;
-                            };
-                            publish_method: string | null;
-                            provenance: {
-                                schema_version: string;
-                                provider: string;
-                                repository: string;
-                                sha: string;
-                            } | null;
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/@{scope}/{package}/versions/{version}/download": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Download a specific version of a bundle */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Target OS (darwin, linux, win32, any) */
-                    os?: string;
-                    /** @description Target arch (x64, arm64, any) */
-                    arch?: string;
-                };
-                header?: never;
-                path: {
-                    scope: string;
-                    package: string;
-                    version: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            url: string;
-                            bundle: {
-                                name: string;
-                                version: string;
-                                platform: {
-                                    os: string;
-                                    arch: string;
-                                };
-                                sha256: string;
-                                size: number;
-                            };
-                            expires_at?: string;
-                        };
-                    };
-                };
-                /** @description Redirect to download URL */
-                302: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bundles/announce": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** @description Announce a single artifact for a bundle version from a GitHub release (OIDC only). Idempotent - can be called multiple times for different artifacts of the same version. */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        name: string;
-                        version: string;
-                        manifest: {
-                            [key: string]: unknown;
-                        };
-                        release_tag: string;
-                        /** @default false */
-                        prerelease: boolean;
-                        artifact: {
-                            filename: string;
-                            os: string;
-                            arch: string;
-                            sha256: string;
-                            size: number;
-                        };
-                    };
-                };
-            };
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            package: string;
-                            version: string;
-                            artifact: {
-                                os: string;
-                                arch: string;
-                                filename: string;
-                            };
-                            total_artifacts: number;
-                            /** @enum {string} */
-                            status: "created" | "updated";
-                        };
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/health": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Health check endpoint */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Default Response */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            status?: string;
-                            /** Format: date-time */
-                            timestamp?: string;
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-}
-export type webhooks = Record<string, never>;
-export interface components {
-    schemas: never;
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export type operations = Record<string, never>;

package/src/lib/api/skills-client.ts

@@ -1,148 +0,0 @@
-/**
- * Skills API client for mpak registry
- */
-
-import type {
-  SkillSearchResponse,
-  SkillDetail,
-  SkillDownloadInfo,
-} from '../../schemas/generated/skill.js';
-
-const DEFAULT_REGISTRY_URL = 'https://api.mpak.dev';
-
-function getRegistryUrl(): string {
-  return process.env.MPAK_REGISTRY_URL || DEFAULT_REGISTRY_URL;
-}
-
-/**
- * Parse a scoped name into scope and name parts
- * Handles both @scope/name and scope/name formats
- */
-function parseScopedName(name: string): { scope: string; skillName: string } {
-  const normalizedName = name.startsWith('@') ? name.slice(1) : name;
-  const [scope, skillName] = normalizedName.split('/');
-  if (!scope || !skillName) {
-    throw new Error(`Invalid skill name format: ${name}. Expected @scope/name or scope/name`);
-  }
-  return { scope, skillName };
-}
-
-export interface SkillSearchOptions {
-  q?: string;
-  tags?: string;
-  category?: string;
-  surface?: string;
-  sort?: 'downloads' | 'recent' | 'name';
-  limit?: number;
-  offset?: number;
-}
-
-/**
- * Search for skills in the registry
- */
-export async function searchSkills(options: SkillSearchOptions): Promise<SkillSearchResponse> {
-  const baseUrl = getRegistryUrl();
-  const params = new URLSearchParams();
-
-  if (options.q) params.set('q', options.q);
-  if (options.tags) params.set('tags', options.tags);
-  if (options.category) params.set('category', options.category);
-  if (options.surface) params.set('surface', options.surface);
-  if (options.sort) params.set('sort', options.sort);
-  if (options.limit) params.set('limit', options.limit.toString());
-  if (options.offset) params.set('offset', options.offset.toString());
-
-  const url = `${baseUrl}/v1/skills/search?${params.toString()}`;
-
-  const response = await fetch(url, {
-    headers: { Accept: 'application/json' },
-  });
-
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`Search failed (${response.status}): ${text}`);
-  }
-
-  return response.json() as Promise<SkillSearchResponse>;
-}
-
-/**
- * Get skill details from the registry
- */
-export async function getSkillDetails(name: string): Promise<SkillDetail> {
-  const baseUrl = getRegistryUrl();
-  const { scope, skillName } = parseScopedName(name);
-
-  // Server expects: /v1/skills/@scope/name
-  const url = `${baseUrl}/v1/skills/@${scope}/${skillName}`;
-
-  const response = await fetch(url, {
-    headers: { Accept: 'application/json' },
-  });
-
-  if (!response.ok) {
-    if (response.status === 404) {
-      throw new Error(`Skill not found: ${name}`);
-    }
-    const text = await response.text();
-    throw new Error(`Failed to get skill details (${response.status}): ${text}`);
-  }
-
-  return response.json() as Promise<SkillDetail>;
-}
-
-/**
- * Get download info for a skill
- */
-export async function getSkillDownloadInfo(
-  name: string,
-  version?: string
-): Promise<SkillDownloadInfo> {
-  const baseUrl = getRegistryUrl();
-  const { scope, skillName } = parseScopedName(name);
-
-  // Server expects: /v1/skills/@scope/name/download or /v1/skills/@scope/name/versions/x.y.z/download
-  const versionPath = version ? `/versions/${version}` : '';
-  const url = `${baseUrl}/v1/skills/@${scope}/${skillName}${versionPath}/download`;
-
-  const response = await fetch(url, {
-    headers: { Accept: 'application/json' },
-  });
-
-  if (!response.ok) {
-    if (response.status === 404) {
-      throw new Error(`Skill not found: ${name}${version ? `@${version}` : ''}`);
-    }
-    const text = await response.text();
-    throw new Error(`Failed to get download info (${response.status}): ${text}`);
-  }
-
-  return response.json() as Promise<SkillDownloadInfo>;
-}
-
-/**
- * Download a skill bundle
- */
-export async function downloadSkillBundle(
-  downloadUrl: string,
-  expectedSha256?: string
-): Promise<Buffer> {
-  const response = await fetch(downloadUrl);
-
-  if (!response.ok) {
-    throw new Error(`Download failed (${response.status})`);
-  }
-
-  const buffer = Buffer.from(await response.arrayBuffer());
-
-  // Verify SHA256 if provided
-  if (expectedSha256) {
-    const { createHash } = await import('crypto');
-    const hash = createHash('sha256').update(buffer).digest('hex');
-    if (hash !== expectedSha256) {
-      throw new Error(`SHA256 mismatch: expected ${expectedSha256}, got ${hash}`);
-    }
-  }
-
-  return buffer;
-}

package/src/program.test.ts

@@ -1,22 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { createProgram } from './program.js';
-
-describe('createProgram', () => {
-  it('should create a program with correct name', () => {
-    const program = createProgram();
-    expect(program.name()).toBe('mpak');
-  });
-
-  it('should have a description', () => {
-    const program = createProgram();
-    expect(program.description()).toBe('CLI for MCP bundles and Agent Skills');
-  });
-
-  it('should have version option', () => {
-    const program = createProgram();
-    const versionOption = program.options.find(
-      (opt) => opt.short === '-v' || opt.long === '--version'
-    );
-    expect(versionOption).toBeDefined();
-  });
-});