@nimblebrain/mpak-sdk 0.0.1 → 0.1.1

package/dist/index.d.cts

@@ -0,0 +1,1245 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+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}/badge.svg": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get an SVG badge for a bundle (for README embeds) */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Badge type: version (default), downloads, or runtime */
+                    type?: "version" | "downloads" | "runtime";
+                };
+                header?: never;
+                path: {
+                    scope: string;
+                    package: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description SVG badge image */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": string;
+                    };
+                };
+            };
+        };
+        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;
+    };
+    "/v1/skills/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Search for skills */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Search query */
+                    q?: string;
+                    /** @description Filter by tags (comma-separated) */
+                    tags?: string;
+                    /** @description Filter by category */
+                    category?: string;
+                    /** @description Filter by surface (claude-code, claude-api, claude-ai) */
+                    surface?: 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": {
+                            skills: {
+                                name: string;
+                                description: string;
+                                latest_version: string;
+                                tags?: string[];
+                                /** @enum {string} */
+                                category?: "development" | "writing" | "research" | "consulting" | "data" | "design" | "operations" | "security" | "other";
+                                surfaces?: ("claude-code" | "claude-api" | "claude-ai")[];
+                                downloads: number;
+                                published_at: string;
+                                author?: {
+                                    name: string;
+                                    /** Format: uri */
+                                    url?: string;
+                                    /** Format: email */
+                                    email?: string;
+                                };
+                            }[];
+                            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/skills/@{scope}/{name}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get detailed skill information */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    scope: string;
+                    name: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            name: string;
+                            description: string;
+                            latest_version: string;
+                            license?: string;
+                            compatibility?: string;
+                            allowed_tools?: string[];
+                            tags?: string[];
+                            /** @enum {string} */
+                            category?: "development" | "writing" | "research" | "consulting" | "data" | "design" | "operations" | "security" | "other";
+                            triggers?: string[];
+                            surfaces?: ("claude-code" | "claude-api" | "claude-ai")[];
+                            downloads: number;
+                            published_at: string;
+                            author?: {
+                                name: string;
+                                /** Format: uri */
+                                url?: string;
+                                /** Format: email */
+                                email?: string;
+                            };
+                            examples?: {
+                                prompt: string;
+                                context?: string;
+                            }[];
+                            versions: {
+                                version: string;
+                                published_at: string;
+                                downloads: number;
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/skills/@{scope}/{name}/badge.svg": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get an SVG badge for a skill (for README embeds) */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Badge type: version (default) or downloads */
+                    type?: "version" | "downloads";
+                };
+                header?: never;
+                path: {
+                    scope: string;
+                    name: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description SVG badge image */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": string;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/skills/@{scope}/{name}/download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Download the latest version of a skill bundle */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    scope: string;
+                    name: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            url: string;
+                            skill: {
+                                name: string;
+                                version: 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/skills/@{scope}/{name}/versions/{version}/download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Download a specific version of a skill bundle */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    scope: string;
+                    name: string;
+                    version: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            url: string;
+                            skill: {
+                                name: string;
+                                version: 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/skills/announce": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Announce a skill version from a GitHub release (OIDC only). Idempotent - can be called multiple times. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name: string;
+                        version: string;
+                        skill: {
+                            name: string;
+                            description: string;
+                            license?: string;
+                            compatibility?: string;
+                            "allowed-tools"?: string;
+                            metadata?: {
+                                tags?: string[];
+                                /** @enum {string} */
+                                category?: "development" | "writing" | "research" | "consulting" | "data" | "design" | "operations" | "security" | "other";
+                                triggers?: string[];
+                                keywords?: string[];
+                                surfaces?: ("claude-code" | "claude-api" | "claude-ai")[];
+                                author?: {
+                                    name: string;
+                                    /** Format: uri */
+                                    url?: string;
+                                    /** Format: email */
+                                    email?: string;
+                                };
+                                version?: string;
+                                examples?: {
+                                    prompt: string;
+                                    context?: string;
+                                }[];
+                            } & {
+                                [key: string]: unknown;
+                            };
+                        };
+                        release_tag: string;
+                        /** @default false */
+                        prerelease: boolean;
+                        artifact: {
+                            filename: string;
+                            sha256: string;
+                            size: number;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            skill: string;
+                            version: string;
+                            /** @enum {string} */
+                            status: "created" | "exists";
+                        };
+                    };
+                };
+            };
+        };
+        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;
+    };
+}
+
+/**
+ * Type definitions for mpak SDK
+ *
+ * Types are derived from the OpenAPI schema (generated by openapi-typescript)
+ */
+
+/** Extract the JSON response type from a path operation */
+type ResponseOf<T> = T extends {
+    responses: {
+        200: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : never;
+/** Extract query parameters from a path operation */
+type QueryOf<T> = T extends {
+    parameters: {
+        query?: infer Q;
+    };
+} ? Q : never;
+/** Response from GET /v1/bundles/search */
+type BundleSearchResponse = ResponseOf<paths['/v1/bundles/search']['get']>;
+/** Response from GET /v1/bundles/@{scope}/{package} */
+type BundleDetailResponse = ResponseOf<paths['/v1/bundles/@{scope}/{package}']['get']>;
+/** Response from GET /v1/bundles/@{scope}/{package}/versions */
+type BundleVersionsResponse = ResponseOf<paths['/v1/bundles/@{scope}/{package}/versions']['get']>;
+/** Response from GET /v1/bundles/@{scope}/{package}/versions/{version} */
+type BundleVersionResponse = ResponseOf<paths['/v1/bundles/@{scope}/{package}/versions/{version}']['get']>;
+/** Response from GET /v1/bundles/@{scope}/{package}/versions/{version}/download */
+type BundleDownloadResponse = ResponseOf<paths['/v1/bundles/@{scope}/{package}/versions/{version}/download']['get']>;
+/** Response from GET /v1/bundles/@{scope}/{package}/index.json */
+type BundleIndexResponse = ResponseOf<paths['/v1/bundles/@{scope}/{package}/index.json']['get']>;
+/** Query parameters for bundle search */
+type BundleSearchParams = QueryOf<paths['/v1/bundles/search']['get']>;
+type Bundle = BundleSearchResponse['bundles'][number];
+type BundleDetail = BundleDetailResponse;
+type BundleVersion = BundleVersionsResponse['versions'][number];
+type BundleArtifact = BundleVersionResponse['artifacts'][number];
+type BundleDownloadInfo = BundleDownloadResponse;
+/** Response from GET /v1/skills/search */
+type SkillSearchResponse = ResponseOf<paths['/v1/skills/search']['get']>;
+/** Response from GET /v1/skills/@{scope}/{name} */
+type SkillDetailResponse = ResponseOf<paths['/v1/skills/@{scope}/{name}']['get']>;
+/** Response from GET /v1/skills/@{scope}/{name}/download */
+type SkillDownloadResponse = ResponseOf<paths['/v1/skills/@{scope}/{name}/download']['get']>;
+/** Query parameters for skill search */
+type SkillSearchParams = QueryOf<paths['/v1/skills/search']['get']>;
+type Skill = SkillSearchResponse['skills'][number];
+type SkillDetail = SkillDetailResponse;
+type SkillDownloadInfo = SkillDownloadResponse;
+type SkillVersion = SkillDetailResponse['versions'][number];
+/** Platform identifier (os + arch) */
+interface Platform {
+    os: string;
+    arch: string;
+}
+/** Pagination info returned by search endpoints */
+interface Pagination {
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+/** Provenance information for verified packages */
+interface Provenance {
+    schema_version: string;
+    provider: string;
+    repository: string;
+    sha: string;
+}
+/** Author information */
+interface Author {
+    name: string;
+    url?: string;
+    email?: string;
+}
+/**
+ * Configuration options for MpakClient
+ */
+interface MpakClientConfig {
+    /**
+     * Base URL for the mpak registry API
+     * @default 'https://api.mpak.dev'
+     */
+    registryUrl?: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+}
+/**
+ * Base fields shared by all skill reference types
+ */
+interface SkillReferenceBase {
+    /** Skill artifact identifier (e.g., '@nimbletools/folk-crm') */
+    name: string;
+    /** Semver version (e.g., '1.0.0') or 'latest' */
+    version: string;
+    /** SHA256 integrity hash (format: 'sha256-hexdigest') */
+    integrity?: string;
+}
+/**
+ * Skill reference from mpak registry
+ */
+interface MpakSkillReference extends SkillReferenceBase {
+    source: 'mpak';
+}
+/**
+ * Skill reference from GitHub repository
+ */
+interface GithubSkillReference extends SkillReferenceBase {
+    source: 'github';
+    /** GitHub repository (owner/repo) */
+    repo: string;
+    /** Path to skill file in repo */
+    path: string;
+}
+/**
+ * Skill reference from direct URL
+ */
+interface UrlSkillReference extends SkillReferenceBase {
+    source: 'url';
+    /** Direct download URL */
+    url: string;
+}
+/**
+ * Discriminated union of skill reference types
+ */
+type SkillReference = MpakSkillReference | GithubSkillReference | UrlSkillReference;
+/**
+ * Result of resolving a skill reference
+ */
+interface ResolvedSkill {
+    /** The markdown content of the skill */
+    content: string;
+    /** Version that was resolved */
+    version: string;
+    /** Source the skill was fetched from */
+    source: 'mpak' | 'github' | 'url';
+    /** Whether integrity was verified */
+    verified: boolean;
+}
+
+/**
+ * Client for interacting with the mpak registry
+ *
+ * Zero runtime dependencies - uses native fetch and crypto only.
+ * Requires Node.js 18+ for native fetch support.
+ */
+declare class MpakClient {
+    private readonly registryUrl;
+    private readonly timeout;
+    constructor(config?: MpakClientConfig);
+    /**
+     * Search for bundles
+     */
+    searchBundles(params?: BundleSearchParams): Promise<BundleSearchResponse>;
+    /**
+     * Get bundle details
+     */
+    getBundle(name: string): Promise<BundleDetailResponse>;
+    /**
+     * Get all versions of a bundle
+     */
+    getBundleVersions(name: string): Promise<BundleVersionsResponse>;
+    /**
+     * Get a specific version of a bundle
+     */
+    getBundleVersion(name: string, version: string): Promise<BundleVersionResponse>;
+    /**
+     * Get download info for a bundle
+     */
+    getBundleDownload(name: string, version: string, platform?: Platform): Promise<BundleDownloadResponse>;
+    /**
+     * Search for skills
+     */
+    searchSkills(params?: SkillSearchParams): Promise<SkillSearchResponse>;
+    /**
+     * Get skill details
+     */
+    getSkill(name: string): Promise<SkillDetailResponse>;
+    /**
+     * Get download info for a skill (latest version)
+     */
+    getSkillDownload(name: string): Promise<SkillDownloadResponse>;
+    /**
+     * Get download info for a specific skill version
+     */
+    getSkillVersionDownload(name: string, version: string): Promise<SkillDownloadResponse>;
+    /**
+     * Download skill content and verify integrity
+     *
+     * @throws {MpakIntegrityError} If expectedSha256 is provided and doesn't match (fail-closed)
+     */
+    downloadSkillContent(downloadUrl: string, expectedSha256?: string): Promise<{
+        content: string;
+        verified: boolean;
+    }>;
+    /**
+     * Resolve a skill reference to actual content
+     *
+     * Supports mpak, github, and url sources. This is the main method for
+     * fetching skill content from any supported source.
+     *
+     * @throws {MpakNotFoundError} If skill not found
+     * @throws {MpakIntegrityError} If integrity check fails (fail-closed)
+     * @throws {MpakNetworkError} For network failures
+     *
+     * @example
+     * ```typescript
+     * // Resolve from mpak registry
+     * const skill = await client.resolveSkillRef({
+     *   source: 'mpak',
+     *   name: '@nimblebraininc/folk-crm',
+     *   version: '1.3.0',
+     * });
+     *
+     * // Resolve from GitHub
+     * const skill = await client.resolveSkillRef({
+     *   source: 'github',
+     *   name: '@example/my-skill',
+     *   version: 'v1.0.0',
+     *   repo: 'owner/repo',
+     *   path: 'skills/my-skill/SKILL.md',
+     * });
+     *
+     * // Resolve from URL
+     * const skill = await client.resolveSkillRef({
+     *   source: 'url',
+     *   name: '@example/custom',
+     *   version: '1.0.0',
+     *   url: 'https://example.com/skill.md',
+     * });
+     * ```
+     */
+    resolveSkillRef(ref: SkillReference): Promise<ResolvedSkill>;
+    /**
+     * Resolve a skill from mpak registry
+     *
+     * The API returns a ZIP bundle containing SKILL.md and metadata.
+     */
+    private resolveMpakSkill;
+    /**
+     * Resolve a skill from GitHub releases
+     */
+    private resolveGithubSkill;
+    /**
+     * Resolve a skill from a direct URL
+     */
+    private resolveUrlSkill;
+    /**
+     * Extract SKILL.md content from a skill bundle ZIP
+     */
+    private extractSkillFromZip;
+    /**
+     * Verify content integrity and throw if mismatch (fail-closed)
+     */
+    private verifyIntegrityOrThrow;
+    /**
+     * Extract hash from integrity string (removes prefix)
+     */
+    private extractHash;
+    /**
+     * Detect the current platform
+     */
+    static detectPlatform(): Platform;
+    /**
+     * Compute SHA256 hash of content
+     */
+    private computeSha256;
+    /**
+     * Validate that a name is scoped (@scope/name)
+     */
+    private validateScopedName;
+    /**
+     * Fetch with timeout support
+     */
+    private fetchWithTimeout;
+}
+
+/**
+ * Base error class for mpak SDK errors
+ */
+declare class MpakError extends Error {
+    code: string;
+    statusCode?: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+/**
+ * Thrown when a requested resource is not found (404)
+ */
+declare class MpakNotFoundError extends MpakError {
+    constructor(resource: string);
+}
+/**
+ * Thrown when integrity verification fails (hash mismatch)
+ * This is a fail-closed error - content is NOT returned when this is thrown
+ */
+declare class MpakIntegrityError extends MpakError {
+    expected: string;
+    actual: string;
+    constructor(expected: string, actual: string);
+}
+/**
+ * Thrown for network-related failures (timeouts, connection errors)
+ */
+declare class MpakNetworkError extends MpakError {
+    constructor(message: string);
+}
+
+export { type Author, type Bundle, type BundleArtifact, type BundleDetail, type BundleDetailResponse, type BundleDownloadInfo, type BundleDownloadResponse, type BundleIndexResponse, type BundleSearchParams, type BundleSearchResponse, type BundleVersion, type BundleVersionResponse, type BundleVersionsResponse, type GithubSkillReference, MpakClient, type MpakClientConfig, MpakError, MpakIntegrityError, MpakNetworkError, MpakNotFoundError, type MpakSkillReference, type Pagination, type Platform, type Provenance, type ResolvedSkill, type Skill, type SkillDetail, type SkillDetailResponse, type SkillDownloadInfo, type SkillDownloadResponse, type SkillReference, type SkillSearchParams, type SkillSearchResponse, type SkillVersion, type UrlSkillReference };