@musher-dev/musher-sdk 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,1141 @@
+import { z } from 'zod';
+
+/**
+ * FileHandle — binary-safe content wrapper for bundle assets.
+ */
+declare class FileHandle {
+    readonly logicalPath: string;
+    readonly assetType: string;
+    readonly sha256: string;
+    readonly mediaType: string | undefined;
+    readonly sizeBytes: number;
+    private readonly _content;
+    constructor(logicalPath: string, assetType: string, sha256: string, sizeBytes: number, content: Buffer, mediaType?: string | undefined);
+    /** Return content as a UTF-8 string. */
+    text(): string;
+    /** Return content as a Uint8Array. */
+    bytes(): Uint8Array;
+    /** Return content as a ReadableStream. */
+    stream(): ReadableStream<Uint8Array>;
+}
+
+/**
+ * AgentSpecHandle — wraps a single agent_definition asset.
+ */
+
+declare class AgentSpecHandle {
+    readonly name: string;
+    private readonly _file;
+    constructor(name: string, file: FileHandle);
+    /** All files belonging to this agent spec (single file). */
+    files(): FileHandle[];
+    /** The agent spec content as text. */
+    content(): string;
+    /** The underlying file handle. */
+    file(): FileHandle;
+}
+
+/**
+ * PromptHandle — wraps a single prompt asset.
+ */
+
+declare class PromptHandle {
+    readonly name: string;
+    private readonly _file;
+    constructor(name: string, file: FileHandle);
+    /** All files belonging to this prompt (single file). */
+    files(): FileHandle[];
+    /** The prompt content as text. */
+    content(): string;
+    /** The underlying file handle. */
+    file(): FileHandle;
+}
+
+/**
+ * OpenAI adapter — export skills as local files or inline base64 ZIP.
+ */
+
+interface OpenAILocalSkill {
+    name: string;
+    description: string;
+    path: string;
+}
+interface OpenAIInlineSkill {
+    type: "inline";
+    name: string;
+    description: string;
+    source: {
+        type: "base64";
+        mediaType: "application/zip";
+        data: string;
+    };
+}
+/**
+ * Export a skill as a local file directory structure.
+ */
+declare function exportOpenAILocalSkill(skill: SkillHandle, targetDir: string): Promise<OpenAILocalSkill>;
+/**
+ * Export a skill as an inline base64 ZIP matching OpenAI's ShellToolInlineSkill shape.
+ */
+declare function exportOpenAIInlineSkill(skill: SkillHandle): OpenAIInlineSkill;
+
+/**
+ * Minimal YAML frontmatter parser for SKILL.md files.
+ *
+ * Extracts `name` and `description` from `---` delimited frontmatter.
+ * Only handles single-line scalar values (quoted or unquoted).
+ */
+
+interface FrontmatterResult {
+    name?: string | undefined;
+    description?: string | undefined;
+    body: string;
+}
+/**
+ * Parse YAML frontmatter from a markdown string.
+ * Returns extracted `name` and `description` fields plus the remaining body.
+ */
+declare function parseFrontmatter(text: string): FrontmatterResult;
+/**
+ * Extract a description string from a skill, preferring frontmatter metadata.
+ */
+declare function extractDescription(skill: SkillHandle): string;
+
+declare class SkillHandle {
+    readonly name: string;
+    private readonly _files;
+    constructor(name: string, files: FileHandle[]);
+    /** All files belonging to this skill. */
+    files(): FileHandle[];
+    /** The SKILL.md definition file, if present. */
+    definition(): FileHandle | undefined;
+    /** Parsed frontmatter from SKILL.md, if present. */
+    metadata(): FrontmatterResult | undefined;
+    /** Export as an OpenAI local skill directory. */
+    exportOpenAILocal(targetDir: string): Promise<OpenAILocalSkill>;
+    /** Export as an OpenAI inline base64 ZIP skill. */
+    exportOpenAIInline(): Promise<OpenAIInlineSkill>;
+}
+
+/**
+ * ToolsetHandle — wraps a single tool_config asset.
+ */
+
+declare class ToolsetHandle {
+    readonly name: string;
+    private readonly _file;
+    constructor(name: string, file: FileHandle);
+    /** All files belonging to this toolset (single file). */
+    files(): FileHandle[];
+    /** The toolset content as text. */
+    content(): string;
+    /** The underlying file handle. */
+    file(): FileHandle;
+}
+
+/**
+ * BundleRef — parse and represent bundle references.
+ *
+ * Supported formats:
+ *   namespace/slug
+ *   namespace/slug:version
+ *   namespace/slug@sha256:digest
+ */
+declare class BundleRef {
+    readonly namespace: string;
+    readonly slug: string;
+    readonly version: string | undefined;
+    readonly digest: string | undefined;
+    private constructor();
+    /** Parse a ref string into a BundleRef. */
+    static parse(ref: string): BundleRef;
+    /** Return the base ref without version or digest: "namespace/slug". */
+    toBaseRef(): string;
+    /** Return the full ref string. */
+    toString(): string;
+}
+
+declare const AssetSummaryOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bundleId: z.ZodString;
+    assetType: z.ZodString;
+    logicalPath: z.ZodString;
+    contentSha256: z.ZodString;
+    contentSizeBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    bundleId: string;
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    createdAt: string;
+    contentSizeBytes?: number | null | undefined;
+    mediaType?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+}, {
+    id: string;
+    bundleId: string;
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    createdAt: string;
+    contentSizeBytes?: number | null | undefined;
+    mediaType?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+}>;
+declare const AssetDetailOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bundleId: z.ZodString;
+    assetType: z.ZodString;
+    logicalPath: z.ZodString;
+    contentSha256: z.ZodString;
+    contentSizeBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+} & {
+    contentText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    bundleId: string;
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    createdAt: string;
+    contentSizeBytes?: number | null | undefined;
+    mediaType?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    contentText?: string | null | undefined;
+}, {
+    id: string;
+    bundleId: string;
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    createdAt: string;
+    contentSizeBytes?: number | null | undefined;
+    mediaType?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    contentText?: string | null | undefined;
+}>;
+
+declare const BundleOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    namespace: z.ZodString;
+    slug: z.ZodString;
+    ref: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodEnum<["private", "public"]>;
+    sourceType: z.ZodEnum<["console", "registry"]>;
+    readmeFormat: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    namespace: string;
+    slug: string;
+    id: string;
+    createdAt: string;
+    ref: string;
+    visibility: "private" | "public";
+    sourceType: "console" | "registry";
+    description?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    readmeFormat?: string | null | undefined;
+}, {
+    name: string;
+    namespace: string;
+    slug: string;
+    id: string;
+    createdAt: string;
+    ref: string;
+    visibility: "private" | "public";
+    sourceType: "console" | "registry";
+    description?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    readmeFormat?: string | null | undefined;
+}>;
+declare const BundleDetailOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    namespace: z.ZodString;
+    slug: z.ZodString;
+    ref: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodEnum<["private", "public"]>;
+    sourceType: z.ZodEnum<["console", "registry"]>;
+    readmeFormat: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+} & {
+    readmeContent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latestVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    versionCount: z.ZodNumber;
+    assetCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    namespace: string;
+    slug: string;
+    id: string;
+    createdAt: string;
+    ref: string;
+    visibility: "private" | "public";
+    sourceType: "console" | "registry";
+    versionCount: number;
+    assetCount: number;
+    description?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    readmeFormat?: string | null | undefined;
+    readmeContent?: string | null | undefined;
+    latestVersion?: string | null | undefined;
+}, {
+    name: string;
+    namespace: string;
+    slug: string;
+    id: string;
+    createdAt: string;
+    ref: string;
+    visibility: "private" | "public";
+    sourceType: "console" | "registry";
+    versionCount: number;
+    assetCount: number;
+    description?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    readmeFormat?: string | null | undefined;
+    readmeContent?: string | null | undefined;
+    latestVersion?: string | null | undefined;
+}>;
+
+declare const BundleVisibility: z.ZodEnum<["private", "public"]>;
+declare const BundleVersionState: z.ZodEnum<["published", "yanked"]>;
+declare const AssetType: z.ZodEnum<["agent_definition", "skill", "tool_config", "prompt", "config", "other"]>;
+declare const BundleSourceType: z.ZodEnum<["console", "registry"]>;
+declare const PaginationMetaSchema: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    nextCursor: string | null;
+    hasMore: boolean;
+}, {
+    nextCursor: string | null;
+    hasMore: boolean;
+}>;
+/** Paginated response envelope. */
+declare function paginatedSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    data: z.ZodArray<T, "many">;
+    meta: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        nextCursor: string | null;
+        hasMore: boolean;
+    }, {
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+    meta: {
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+}, {
+    data: T["_input"][];
+    meta: {
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+}>;
+
+declare const BundleLayerOutputSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    logicalPath: z.ZodString;
+    assetType: z.ZodString;
+    contentSha256: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    assetId: string;
+    sizeBytes: number;
+    mediaType?: string | null | undefined;
+}, {
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    assetId: string;
+    sizeBytes: number;
+    mediaType?: string | null | undefined;
+}>;
+declare const BundleManifestOutputSchema: z.ZodObject<{
+    layers: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        logicalPath: z.ZodString;
+        assetType: z.ZodString;
+        contentSha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }, {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    layers: {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }[];
+}, {
+    layers: {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }[];
+}>;
+declare const BundleResolveOutputSchema: z.ZodObject<{
+    bundleId: z.ZodString;
+    versionId: z.ZodString;
+    namespace: z.ZodString;
+    slug: z.ZodString;
+    ref: z.ZodString;
+    version: z.ZodString;
+    sourceType: z.ZodEnum<["console", "registry"]>;
+    ociRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ociDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodEnum<["published", "yanked"]>;
+    manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        layers: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            logicalPath: z.ZodString;
+            assetType: z.ZodString;
+            contentSha256: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }, {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        layers: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    }, {
+        layers: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    namespace: string;
+    slug: string;
+    version: string;
+    bundleId: string;
+    ref: string;
+    sourceType: "console" | "registry";
+    versionId: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    manifest?: {
+        layers: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    } | null | undefined;
+}, {
+    namespace: string;
+    slug: string;
+    version: string;
+    bundleId: string;
+    ref: string;
+    sourceType: "console" | "registry";
+    versionId: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    manifest?: {
+        layers: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    } | null | undefined;
+}>;
+
+declare const BundleVersionSummaryOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bundleId: z.ZodString;
+    version: z.ZodString;
+    state: z.ZodEnum<["published", "yanked"]>;
+    ociRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ociDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publishedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    id: string;
+    bundleId: string;
+    createdAt: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    publishedBy?: string | null | undefined;
+    yankedBy?: string | null | undefined;
+    yankedAt?: string | null | undefined;
+    yankReason?: string | null | undefined;
+}, {
+    version: string;
+    id: string;
+    bundleId: string;
+    createdAt: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    publishedBy?: string | null | undefined;
+    yankedBy?: string | null | undefined;
+    yankedAt?: string | null | undefined;
+    yankReason?: string | null | undefined;
+}>;
+declare const ManifestAssetOutputSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    logicalPath: z.ZodString;
+    assetType: z.ZodString;
+    contentSha256: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    assetId: string;
+    sizeBytes: number;
+    mediaType?: string | null | undefined;
+}, {
+    assetType: string;
+    logicalPath: string;
+    contentSha256: string;
+    assetId: string;
+    sizeBytes: number;
+    mediaType?: string | null | undefined;
+}>;
+declare const ManifestDetailOutputSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    bundleSlug: z.ZodString;
+    version: z.ZodString;
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        logicalPath: z.ZodString;
+        assetType: z.ZodString;
+        contentSha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }, {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    namespace: string;
+    version: string;
+    bundleSlug: string;
+    assets: {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }[];
+}, {
+    namespace: string;
+    version: string;
+    bundleSlug: string;
+    assets: {
+        assetType: string;
+        logicalPath: string;
+        contentSha256: string;
+        assetId: string;
+        sizeBytes: number;
+        mediaType?: string | null | undefined;
+    }[];
+}>;
+declare const BundleVersionDetailOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bundleId: z.ZodString;
+    version: z.ZodString;
+    state: z.ZodEnum<["published", "yanked"]>;
+    ociRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ociDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        namespace: z.ZodString;
+        bundleSlug: z.ZodString;
+        version: z.ZodString;
+        assets: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            logicalPath: z.ZodString;
+            assetType: z.ZodString;
+            contentSha256: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            mediaType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }, {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        namespace: string;
+        version: string;
+        bundleSlug: string;
+        assets: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    }, {
+        namespace: string;
+        version: string;
+        bundleSlug: string;
+        assets: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    }>>>;
+    publishedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    yankReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    id: string;
+    bundleId: string;
+    createdAt: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    manifest?: {
+        namespace: string;
+        version: string;
+        bundleSlug: string;
+        assets: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    } | null | undefined;
+    publishedBy?: string | null | undefined;
+    yankedBy?: string | null | undefined;
+    yankedAt?: string | null | undefined;
+    yankReason?: string | null | undefined;
+}, {
+    version: string;
+    id: string;
+    bundleId: string;
+    createdAt: string;
+    state: "published" | "yanked";
+    ociRef?: string | null | undefined;
+    ociDigest?: string | null | undefined;
+    manifest?: {
+        namespace: string;
+        version: string;
+        bundleSlug: string;
+        assets: {
+            assetType: string;
+            logicalPath: string;
+            contentSha256: string;
+            assetId: string;
+            sizeBytes: number;
+            mediaType?: string | null | undefined;
+        }[];
+    } | null | undefined;
+    publishedBy?: string | null | undefined;
+    yankedBy?: string | null | undefined;
+    yankedAt?: string | null | undefined;
+    yankReason?: string | null | undefined;
+}>;
+
+/**
+ * Inferred TypeScript types from Zod schemas.
+ *
+ * Use these for type annotations — the Zod schemas are used at runtime.
+ */
+
+type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
+interface Paginated<T> {
+    data: T[];
+    meta: PaginationMeta;
+}
+interface PaginateParams {
+    cursor?: string;
+    limit?: number;
+}
+type BundleOutput = z.infer<typeof BundleOutputSchema>;
+type BundleDetailOutput = z.infer<typeof BundleDetailOutputSchema>;
+type AssetSummaryOutput = z.infer<typeof AssetSummaryOutputSchema>;
+type AssetDetailOutput = z.infer<typeof AssetDetailOutputSchema>;
+type BundleVersionSummaryOutput = z.infer<typeof BundleVersionSummaryOutputSchema>;
+type BundleVersionDetailOutput = z.infer<typeof BundleVersionDetailOutputSchema>;
+type ManifestAssetOutput = z.infer<typeof ManifestAssetOutputSchema>;
+type ManifestDetailOutput = z.infer<typeof ManifestDetailOutputSchema>;
+type BundleResolveOutput = z.infer<typeof BundleResolveOutputSchema>;
+type BundleLayerOutput = z.infer<typeof BundleLayerOutputSchema>;
+type BundleManifestOutput = z.infer<typeof BundleManifestOutputSchema>;
+/**
+ * @deprecated Use `FileHandle` instead.
+ */
+interface LoadedAsset {
+    logicalPath: string;
+    assetType: string;
+    content: string;
+    sha256: string;
+    mediaType?: string | undefined;
+}
+/**
+ * @deprecated Use `Bundle` class instead.
+ */
+interface LoadedBundle {
+    ref: string;
+    version: string;
+    assets: Map<string, LoadedAsset>;
+    getAsset(path: string): LoadedAsset | undefined;
+    getAssetsByType(type: string): LoadedAsset[];
+}
+/** @deprecated Use `Bundle` class instead. */
+interface CachedBundle {
+    ref: string;
+    version: string;
+    cacheDir: string;
+    manifest: BundleResolveOutput;
+}
+interface VerifyResult {
+    ok: boolean;
+    errors: Array<{
+        path: string;
+        expected: string;
+        actual: string;
+    }>;
+}
+interface SelectionFilter {
+    skills?: string[];
+    prompts?: string[];
+    toolsets?: string[];
+    agentSpecs?: string[];
+    paths?: string[];
+}
+
+/**
+ * Selection — lazy filtered view over a Bundle.
+ */
+
+declare class Selection {
+    private readonly _bundle;
+    private readonly _filter;
+    constructor(bundle: Bundle, filter: SelectionFilter);
+    /** The underlying bundle. */
+    get bundle(): Bundle;
+    files(): FileHandle[];
+    skills(): SkillHandle[];
+    prompts(): PromptHandle[];
+    toolsets(): ToolsetHandle[];
+    agentSpecs(): AgentSpecHandle[];
+    /** Write selected files to targetDir preserving logical paths. */
+    materialize(targetDir: string): Promise<string[]>;
+    exportClaudePlugin(opts: {
+        targetDir: string;
+        name?: string;
+        description?: string;
+    }): Promise<string>;
+    installClaudeSkills(dir: string, opts?: {
+        prefix?: string;
+    }): Promise<string[]>;
+    installVSCodeSkills(dir: string, opts?: {
+        subdir?: string;
+    }): Promise<string[]>;
+}
+
+/**
+ * Bundle — high-level object returned by pull().
+ *
+ * Groups files into domain handles (skills, prompts, toolsets, agent specs)
+ * by reading assetType + parsing logical path conventions from manifest layers.
+ */
+
+declare class Bundle {
+    readonly ref: BundleRef;
+    readonly version: string;
+    readonly metadata: BundleResolveOutput;
+    private readonly _files;
+    private readonly _skills;
+    private readonly _prompts;
+    private readonly _toolsets;
+    private readonly _agentSpecs;
+    constructor(metadata: BundleResolveOutput, contents: Map<string, Buffer>);
+    file(path: string): FileHandle | undefined;
+    files(): FileHandle[];
+    skills(): SkillHandle[];
+    skill(name: string): SkillHandle;
+    prompts(): PromptHandle[];
+    prompt(name: string): PromptHandle;
+    toolsets(): ToolsetHandle[];
+    toolset(name: string): ToolsetHandle;
+    agentSpecs(): AgentSpecHandle[];
+    agentSpec(name: string): AgentSpecHandle;
+    select(filter: SelectionFilter): Selection;
+    verify(): VerifyResult;
+    writeLockfile(path: string): Promise<void>;
+    exportClaudePlugin(opts: {
+        targetDir: string;
+        name?: string;
+        description?: string;
+    }): Promise<string>;
+    installClaudeSkills(dir: string, opts?: {
+        prefix?: string;
+    }): Promise<string[]>;
+    installVSCodeSkills(dir: string, opts?: {
+        subdir?: string;
+    }): Promise<string[]>;
+    /** @deprecated Use `file(path)` instead. */
+    getAsset(path: string): LoadedAsset | undefined;
+    /** @deprecated Use `files().filter(...)` instead. */
+    getAssetsByType(type: string): LoadedAsset[];
+}
+
+/**
+ * Client configuration with env-var resolution.
+ */
+interface ClientConfig {
+    /** Base URL for the Musher API. Default: https://api.musher.dev */
+    baseUrl?: string;
+    /** API key authentication. */
+    apiKey?: string;
+    /** Override cache directory path. */
+    cacheDir?: string;
+    /** Override config directory path. */
+    configDir?: string;
+    /** Manifest cache TTL in seconds. Default: 86400 (24 hours) */
+    manifestTtlSeconds?: number;
+    /** Ref cache TTL in seconds. Default: 300 (5 minutes) */
+    refTtlSeconds?: number;
+    /** Request timeout in milliseconds. Default: 30000 */
+    timeout?: number;
+    /** Number of retries on transient failures. Default: 2 */
+    retries?: number;
+}
+interface ResolvedConfig {
+    baseUrl: string;
+    apiKey: string | undefined;
+    cacheDir: string;
+    configDir: string;
+    manifestTtlSeconds: number;
+    refTtlSeconds: number;
+    timeout: number;
+    retries: number;
+}
+
+/**
+ * HTTP transport layer — fetch-based with auth, retry, error mapping, and Zod validation.
+ */
+
+declare class HttpTransport {
+    private readonly config;
+    constructor(config: ResolvedConfig);
+    request<T>(method: string, path: string, schema: z.ZodType<T>, options?: {
+        body?: unknown;
+        params?: Record<string, string | number | boolean | undefined> | undefined;
+    }): Promise<T>;
+    private buildUrl;
+    private buildHeaders;
+    private fetchWithTimeout;
+    private mapError;
+    private parse;
+    private backoff;
+}
+
+/**
+ * Bundles resource — namespace-scoped bundle operations.
+ */
+
+declare class BundlesResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    get(namespace: string, bundle: string): Promise<BundleDetailOutput>;
+    list(namespace: string, params?: PaginateParams): Promise<Paginated<BundleOutput>>;
+    resolve(namespace: string, bundle: string, version?: string, digest?: string): Promise<BundleResolveOutput>;
+    listVersions(namespace: string, bundle: string, params?: PaginateParams): Promise<Paginated<BundleVersionSummaryOutput>>;
+    getVersion(namespace: string, bundle: string, version: string): Promise<BundleVersionDetailOutput>;
+    listAssets(namespace: string, bundle: string, params?: PaginateParams): Promise<Paginated<AssetSummaryOutput>>;
+    getAsset(namespace: string, bundle: string, assetId: string, version: string): Promise<AssetDetailOutput>;
+}
+
+/**
+ * MusherClient — main entry point for the SDK.
+ *
+ * Composes HTTP transport, resource classes, and disk cache
+ * into a single facade with high-level pull/load convenience methods.
+ */
+
+declare class MusherClient {
+    readonly bundles: BundlesResource;
+    private readonly _cache;
+    private readonly _http;
+    constructor(config?: ClientConfig);
+    /**
+     * Resolve a bundle via the API, download all assets, and write to disk cache.
+     * Returns a Bundle object.
+     *
+     * @param ref - Bundle reference (e.g. "namespace/slug", "namespace/slug:version").
+     * @param version - Optional semver constraint. Defaults to latest.
+     */
+    pull(ref: string, version?: string): Promise<Bundle>;
+    /**
+     * Resolve bundle metadata without downloading content.
+     * Checks the manifest cache (with TTL) before calling the API.
+     *
+     * @param ref - Bundle reference.
+     * @param version - Optional semver constraint.
+     */
+    resolve(ref: string, version?: string): Promise<BundleResolveOutput>;
+    /**
+     * @deprecated Use `pull()` instead. This method will be removed in a future version.
+     *
+     * Load a bundle into memory. Checks cache first (TTL-aware), pulls if stale.
+     */
+    load(ref: string, version?: string): Promise<Bundle>;
+    /** Cache management utilities. */
+    readonly cache: {
+        /** Remove expired cache entries and garbage-collect unreferenced blobs. */
+        clean: () => Promise<void>;
+        /** Remove all cached data. */
+        purge: () => Promise<void>;
+    };
+}
+
+/**
+ * Platform-aware directory resolution for the Musher SDK.
+ *
+ * Follows the shared cross-platform storage spec:
+ *   - Linux:   XDG Base Directory spec
+ *   - macOS:   ~/Library/{Caches,Application Support}/musher
+ *   - Windows: %LOCALAPPDATA%\musher\{cache,config,data,state}
+ *
+ * Resolution order per directory:
+ *   1. MUSHER_<TYPE>_HOME  (e.g. MUSHER_CACHE_HOME)
+ *   2. MUSHER_HOME/<type>  (umbrella override)
+ *   3. Platform default
+ *
+ * Relative override/XDG paths are rejected (per XDG spec).
+ */
+interface MusherDirs {
+    cache: string;
+    config: string;
+    data: string;
+    state: string;
+    runtime: string;
+}
+/** Resolve all Musher directory paths for the current platform. */
+declare function resolveMusherDirs(): MusherDirs;
+
+/**
+ * Claude Code adapter — export plugin dirs and install skills to .claude/skills/.
+ */
+
+/**
+ * Export a Claude Code plugin directory structure from a Bundle or Selection.
+ *
+ * Produces the layout expected by Claude Code's plugin system:
+ *
+ *   <pluginDir>/.claude-plugin/plugin.json   — plugin metadata
+ *   <pluginDir>/skills/<name>/SKILL.md       — skill content
+ *
+ * Returns the absolute path of the created plugin directory.
+ */
+declare function exportClaudePlugin(source: Bundle | Selection, opts: {
+    targetDir: string;
+    name?: string;
+    description?: string;
+}): Promise<string>;
+/**
+ * Install skills from a bundle into a .claude/skills/ directory.
+ * Returns the list of written absolute paths.
+ */
+declare function installClaudeSkills(bundle: Bundle | Selection, dir: string, opts?: {
+    prefix?: string;
+}): Promise<string[]>;
+
+/**
+ * VS Code / IDE adapter — install skill directories.
+ */
+
+/**
+ * Install skills from a bundle into an IDE skill tree directory.
+ * Default subdir is ".agents/skills".
+ * Mode is always "copy" (real files, not symlinks).
+ * Returns list of written absolute paths.
+ */
+declare function installVSCodeSkills(source: Bundle | Selection, dir: string, opts?: {
+    subdir?: string;
+}): Promise<string[]>;
+
+/**
+ * Module-level convenience functions matching the Python SDK.
+ */
+
+/** Configure the default client used by module-level convenience functions. */
+declare function configure(config: ClientConfig): void;
+/** Get or create the default MusherClient. */
+declare function getClient(): MusherClient;
+/** Pull a bundle (resolve + download + cache). */
+declare function pull(ref: string, version?: string): Promise<Bundle>;
+/** Resolve bundle metadata without downloading content. */
+declare function resolve(ref: string, version?: string): Promise<BundleResolveOutput>;
+
+/**
+ * Error hierarchy for the Musher SDK.
+ *
+ * All errors extend MushError so consumers can catch the base class.
+ */
+declare class MushError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+interface ProblemDetail {
+    type: string;
+    title: string;
+    status: number;
+    detail: string;
+    instance?: string | undefined;
+    traceId?: string | undefined;
+}
+declare class ApiError extends MushError {
+    readonly status: number;
+    readonly problem: ProblemDetail;
+    constructor(problem: ProblemDetail, options?: ErrorOptions);
+}
+declare class NotFoundError extends ApiError {
+    constructor(problem: ProblemDetail, options?: ErrorOptions);
+}
+declare class AuthenticationError extends ApiError {
+    constructor(problem: ProblemDetail, options?: ErrorOptions);
+}
+declare class ForbiddenError extends ApiError {
+    constructor(problem: ProblemDetail, options?: ErrorOptions);
+}
+declare class ValidationError extends ApiError {
+    readonly errors?: Array<{
+        loc: string[];
+        msg: string;
+        type: string;
+    }> | undefined;
+    constructor(problem: ProblemDetail & {
+        errors?: Array<{
+            loc: string[];
+            msg: string;
+            type: string;
+        }>;
+    }, options?: ErrorOptions);
+}
+declare class RateLimitError extends ApiError {
+    readonly retryAfter: number | undefined;
+    constructor(problem: ProblemDetail, retryAfter?: number, options?: ErrorOptions);
+}
+declare class NetworkError extends MushError {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class TimeoutError extends NetworkError {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class CacheError extends MushError {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class IntegrityError extends CacheError {
+    readonly expected: string;
+    readonly actual: string;
+    constructor(expected: string, actual: string, options?: ErrorOptions);
+}
+declare class SchemaError extends MushError {
+    constructor(message: string, options?: ErrorOptions);
+}
+
+export { AgentSpecHandle, ApiError, type AssetDetailOutput, AssetDetailOutputSchema, type AssetSummaryOutput, AssetSummaryOutputSchema, AssetType, AuthenticationError, Bundle, type BundleDetailOutput, BundleDetailOutputSchema, type BundleLayerOutput, BundleLayerOutputSchema, type BundleManifestOutput, BundleManifestOutputSchema, type BundleOutput, BundleOutputSchema, BundleRef, type BundleResolveOutput, BundleResolveOutputSchema, BundleSourceType, type BundleVersionDetailOutput, BundleVersionDetailOutputSchema, BundleVersionState, type BundleVersionSummaryOutput, BundleVersionSummaryOutputSchema, BundleVisibility, CacheError, type CachedBundle, type ClientConfig, FileHandle, ForbiddenError, type FrontmatterResult, IntegrityError, type LoadedAsset, type LoadedBundle, type ManifestAssetOutput, ManifestAssetOutputSchema, type ManifestDetailOutput, ManifestDetailOutputSchema, MushError, MusherClient, type MusherDirs, NetworkError, NotFoundError, type OpenAIInlineSkill, type OpenAILocalSkill, type PaginateParams, type Paginated, type PaginationMeta, PaginationMetaSchema, type ProblemDetail, PromptHandle, RateLimitError, SchemaError, Selection, type SelectionFilter, SkillHandle, TimeoutError, ToolsetHandle, ValidationError, type VerifyResult, configure, exportClaudePlugin, exportOpenAIInlineSkill, exportOpenAILocalSkill, extractDescription, getClient, installClaudeSkills, installVSCodeSkills, paginatedSchema, parseFrontmatter, pull, resolve, resolveMusherDirs };