comfyui-mcp 0.7.0 → 0.8.0

package/dist/services/node-verify.d.ts

@@ -0,0 +1,35 @@
+export interface VerifyOptions {
+    /** Pack folder under custom_nodes/; used to infer class_types and for messaging. */
+    name?: string;
+    /** The NODE_CLASS_MAPPINGS keys expected to appear in /object_info. */
+    classTypes?: string[];
+    /** Restart ComfyUI before checking (default true). Set false to check the live server as-is. */
+    restart?: boolean;
+}
+export interface VerifyResult {
+    ready: boolean;
+    restarted: boolean;
+    expected: string[];
+    loaded: string[];
+    missing: string[];
+    message: string;
+}
+export interface VerifyDeps {
+    /** Restart ComfyUI; resolves once it is ready (or the readiness wait times out). */
+    restart: () => Promise<{
+        ready: boolean;
+        message: string;
+    }>;
+    /** Return the set of registered node class_types from /object_info. */
+    fetchObjectInfoKeys: () => Promise<string[]>;
+    /** Read a pack's __init__.py contents, or undefined if absent. */
+    readPackInit: (packName: string) => string | undefined;
+}
+/**
+ * Parse NODE_CLASS_MAPPINGS keys from an __init__.py. Best-effort regex (Python
+ * isn't parsed) — good enough for the common `{ "Key": Cls, ... }` literal the
+ * scaffold and most packs use. Returns [] when it can't find a literal.
+ */
+export declare function parseClassMappingKeys(initPy: string): string[];
+export declare function verifyCustomNode(options: VerifyOptions, deps?: VerifyDeps): Promise<VerifyResult>;
+//# sourceMappingURL=node-verify.d.ts.map

package/dist/services/node-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-verify.d.ts","sourceRoot":"","sources":["../../src/services/node-verify.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gGAAgG;IAChG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,kEAAkE;IAClE,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAqCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B9D;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,UAAwB,GAC7B,OAAO,CAAC,YAAY,CAAC,CA8EvB"}

package/dist/services/node-verify.js

@@ -0,0 +1,138 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { config, getComfyUIApiHost, getComfyUIProtocol } from "../config.js";
+import { restartComfyUI } from "./process-control.js";
+import { ComfyUIError, ProcessControlError, ValidationError } from "../utils/errors.js";
+import { logger } from "../utils/logger.js";
+const defaultDeps = {
+    restart: async () => {
+        const result = await restartComfyUI();
+        return { ready: result.readiness?.ready ?? false, message: result.message };
+    },
+    fetchObjectInfoKeys: async () => {
+        const url = `${getComfyUIProtocol()}://${getComfyUIApiHost()}/object_info`;
+        const res = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+        if (!res.ok) {
+            throw new ComfyUIError(`Failed to fetch /object_info: ${res.status} ${res.statusText}`, "OBJECT_INFO_FAILED");
+        }
+        const data = await res.json();
+        if (data === null || typeof data !== "object" || Array.isArray(data)) {
+            throw new ComfyUIError("Unexpected /object_info response (not a JSON object).", "OBJECT_INFO_FAILED");
+        }
+        return Object.keys(data);
+    },
+    readPackInit: (packName) => {
+        if (!config.comfyuiPath)
+            return undefined;
+        const initPath = join(config.comfyuiPath, "custom_nodes", packName, "__init__.py");
+        if (!existsSync(initPath))
+            return undefined;
+        try {
+            return readFileSync(initPath, "utf-8");
+        }
+        catch {
+            return undefined;
+        }
+    },
+};
+/**
+ * Parse NODE_CLASS_MAPPINGS keys from an __init__.py. Best-effort regex (Python
+ * isn't parsed) — good enough for the common `{ "Key": Cls, ... }` literal the
+ * scaffold and most packs use. Returns [] when it can't find a literal.
+ */
+export function parseClassMappingKeys(initPy) {
+    const assign = initPy.search(/NODE_CLASS_MAPPINGS\s*=\s*\{/);
+    if (assign < 0)
+        return [];
+    const open = initPy.indexOf("{", assign);
+    // Find the brace that closes the literal by depth-counting, so a brace inside
+    // a value (e.g. `"Foo": make({"x": 1})`) doesn't truncate the block.
+    let depth = 0;
+    let end = -1;
+    for (let i = open; i < initPy.length; i += 1) {
+        if (initPy[i] === "{")
+            depth += 1;
+        else if (initPy[i] === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                end = i;
+                break;
+            }
+        }
+    }
+    const body = end > open ? initPy.slice(open + 1, end) : initPy.slice(open + 1);
+    // Match keys at the start of a line only, so keys of inline nested dicts in a
+    // value (mid-line) are not mistaken for top-level node class_types.
+    const keys = [];
+    const keyRe = /^[ \t]*["']([^"'\n]+)["']\s*:/gm;
+    let m;
+    while ((m = keyRe.exec(body)) !== null)
+        keys.push(m[1]);
+    return keys;
+}
+export async function verifyCustomNode(options, deps = defaultDeps) {
+    if (!config.comfyuiPath) {
+        throw new ProcessControlError("verify_custom_node is local-only: it restarts and inspects a local ComfyUI " +
+            "install and needs COMFYUI_PATH. It cannot verify a remote --comfyui-url target.");
+    }
+    // Resolve the expected class_types: explicit list wins, else infer from the pack.
+    let expected = (options.classTypes ?? []).map((s) => s.trim()).filter(Boolean);
+    if (expected.length === 0) {
+        if (!options.name) {
+            throw new ValidationError("Provide `class_types` (the NODE_CLASS_MAPPINGS keys to check) or a `name` " +
+                "whose __init__.py declares them.");
+        }
+        const initPy = deps.readPackInit(options.name);
+        if (!initPy) {
+            throw new ValidationError(`Could not read __init__.py for pack "${options.name}" to infer its node ` +
+                `class_types. Pass class_types explicitly.`);
+        }
+        expected = parseClassMappingKeys(initPy);
+        if (expected.length === 0) {
+            throw new ValidationError(`Could not find NODE_CLASS_MAPPINGS keys in "${options.name}"/__init__.py. ` +
+                `Pass class_types explicitly.`);
+        }
+    }
+    // Restart so newly-added packs are (re)loaded, unless the caller opted out.
+    const shouldRestart = options.restart !== false;
+    let ready = true;
+    let restartMessage = "Skipped restart; checked the running server as-is.";
+    if (shouldRestart) {
+        const r = await deps.restart();
+        ready = r.ready;
+        restartMessage = r.message;
+        if (!ready) {
+            return {
+                ready: false,
+                restarted: true,
+                expected,
+                loaded: [],
+                missing: expected,
+                message: `ComfyUI did not become ready after restart, so node loading could not be ` +
+                    `verified. ${restartMessage}`,
+            };
+        }
+    }
+    const registered = new Set(await deps.fetchObjectInfoKeys());
+    const loaded = expected.filter((c) => registered.has(c));
+    const missing = expected.filter((c) => !registered.has(c));
+    const ok = missing.length === 0;
+    logger.info("Verified custom node", {
+        name: options.name,
+        loaded: loaded.length,
+        missing: missing.length,
+    });
+    return {
+        ready,
+        restarted: shouldRestart,
+        expected,
+        loaded,
+        missing,
+        message: ok
+            ? `All ${expected.length} node type(s) registered in ComfyUI. The pack loads correctly.`
+            : `${missing.length} of ${expected.length} node type(s) are NOT registered: ` +
+                `${missing.join(", ")}. The pack likely failed to import — check ComfyUI logs ` +
+                `(a missing dependency or a syntax error keeps a node out of /object_info).`,
+    };
+}
+//# sourceMappingURL=node-verify.js.map

package/dist/services/node-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-verify.js","sourceRoot":"","sources":["../../src/services/node-verify.ts"],"names":[],"mappings":"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"}

package/dist/services/skill-cache.d.ts

@@ -0,0 +1,26 @@
+import { getNodePackDetails } from "./registry-client.js";
+export interface SkillCacheMetadata {
+    source: string;
+    version: string;
+    cachedAt: string;
+    contentHash: string;
+}
+export interface GenerateSkillCachedOptions {
+    refresh?: boolean;
+}
+export interface GenerateSkillCachedResult {
+    markdown: string;
+    cacheHit: boolean;
+    cacheDir: string;
+    safeKey: string;
+    metadata: SkillCacheMetadata;
+}
+export interface SkillCacheDeps {
+    generate: (source: string) => Promise<string>;
+    getDetails: typeof getNodePackDetails;
+    now: () => Date;
+}
+export declare function normalizeSkillSource(source: string): string;
+export declare function buildSkillCacheKey(source: string, version: string): string;
+export declare function generateSkillCached(source: string, options?: GenerateSkillCachedOptions, deps?: SkillCacheDeps): Promise<GenerateSkillCachedResult>;
+//# sourceMappingURL=skill-cache.d.ts.map

package/dist/services/skill-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-cache.d.ts","sourceRoot":"","sources":["../../src/services/skill-cache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,UAAU,EAAE,OAAO,kBAAkB,CAAC;IACtC,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAoBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY3D;AAWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1E;AAgHD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,0BAA+B,EACxC,IAAI,GAAE,cAA4B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAmCpC"}

package/dist/services/skill-cache.js

@@ -0,0 +1,172 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { generateSkill } from "./skill-generator.js";
+import { getNodePackDetails } from "./registry-client.js";
+import { logger } from "../utils/logger.js";
+const DEFAULT_CACHE_DIR = join(homedir(), ".comfyui-mcp", "skill-cache");
+const HASH_CHARS = 12;
+const defaultDeps = {
+    generate: generateSkill,
+    getDetails: getNodePackDetails,
+    now: () => new Date(),
+};
+function cacheDir() {
+    return resolve(process.env.COMFYUI_SKILL_CACHE_DIR || DEFAULT_CACHE_DIR);
+}
+function shortHash(value) {
+    return createHash("sha256").update(value).digest("hex").slice(0, HASH_CHARS);
+}
+function contentHash(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function normalizeSkillSource(source) {
+    const trimmed = source.trim();
+    try {
+        const url = new URL(trimmed);
+        url.hash = "";
+        url.search = "";
+        url.hostname = url.hostname.toLowerCase();
+        url.pathname = url.pathname.replace(/\/+$/, "").replace(/\.git$/, "");
+        return url.toString().replace(/\/$/, "");
+    }
+    catch {
+        return trimmed.replace(/\/+$/, "");
+    }
+}
+function safeSegment(value) {
+    const segment = value
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64);
+    return segment || "source";
+}
+export function buildSkillCacheKey(source, version) {
+    const normalized = normalizeSkillSource(source);
+    return `${safeSegment(normalized)}-${safeSegment(version)}-${shortHash(`${normalized}\0${version}`)}`;
+}
+async function resolveVersion(source, deps) {
+    const normalized = normalizeSkillSource(source);
+    if (!normalized.includes("github.com")) {
+        try {
+            const details = await deps.getDetails(normalized);
+            return details.latest_version || details.versions?.[0]?.version || `source-${shortHash(normalized)}`;
+        }
+        catch (err) {
+            logger.warn("Could not resolve node pack version for skill cache; using source hash", {
+                source,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return `source-${shortHash(normalized)}`;
+}
+function parseMetadata(raw) {
+    try {
+        const data = JSON.parse(raw);
+        if (typeof data.source === "string" &&
+            typeof data.version === "string" &&
+            typeof data.cachedAt === "string" &&
+            typeof data.contentHash === "string") {
+            return {
+                source: data.source,
+                version: data.version,
+                cachedAt: data.cachedAt,
+                contentHash: data.contentHash,
+            };
+        }
+    }
+    catch {
+        // Ignore corrupt cache entries.
+    }
+    return undefined;
+}
+function isNotFoundError(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+async function readCachedSkill(source, version, dir, safeKey) {
+    const normalized = normalizeSkillSource(source);
+    const entryDir = join(dir, safeKey);
+    let metadataRaw;
+    try {
+        metadataRaw = await readFile(join(entryDir, "metadata.json"), "utf-8");
+    }
+    catch (err) {
+        if (isNotFoundError(err))
+            return undefined;
+        throw err;
+    }
+    const metadata = parseMetadata(metadataRaw);
+    if (!metadata ||
+        normalizeSkillSource(metadata.source) !== normalized ||
+        metadata.version !== version) {
+        return undefined;
+    }
+    let markdown;
+    try {
+        markdown = await readFile(join(entryDir, "SKILL.md"), "utf-8");
+    }
+    catch (err) {
+        if (isNotFoundError(err))
+            return undefined;
+        throw err;
+    }
+    if (contentHash(markdown) !== metadata.contentHash) {
+        return undefined;
+    }
+    return { markdown, cacheHit: true, cacheDir: dir, safeKey, metadata };
+}
+async function writeCachedSkill(dir, safeKey, markdown, metadata) {
+    const entryDir = join(dir, safeKey);
+    const suffix = `.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    const skillPath = join(entryDir, "SKILL.md");
+    const metadataPath = join(entryDir, "metadata.json");
+    const tempSkillPath = join(entryDir, `SKILL.md${suffix}`);
+    const tempMetadataPath = join(entryDir, `metadata.json${suffix}`);
+    await mkdir(entryDir, { recursive: true });
+    await writeFile(tempSkillPath, markdown, "utf-8");
+    await writeFile(tempMetadataPath, JSON.stringify(metadata, null, 2), "utf-8");
+    await rename(tempSkillPath, skillPath);
+    await rename(tempMetadataPath, metadataPath);
+}
+export async function generateSkillCached(source, options = {}, deps = defaultDeps) {
+    const dir = cacheDir();
+    const version = await resolveVersion(source, deps);
+    const safeKey = buildSkillCacheKey(source, version);
+    if (!options.refresh) {
+        try {
+            const cached = await readCachedSkill(source, version, dir, safeKey);
+            if (cached)
+                return cached;
+        }
+        catch (err) {
+            logger.warn("Skill cache read failed; generating without cache hit", {
+                source,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const markdown = await deps.generate(source);
+    const metadata = {
+        source,
+        version,
+        cachedAt: deps.now().toISOString(),
+        contentHash: contentHash(markdown),
+    };
+    try {
+        await writeCachedSkill(dir, safeKey, markdown, metadata);
+    }
+    catch (err) {
+        logger.warn("Skill cache write failed; returning generated skill without caching", {
+            source,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+    return { markdown, cacheHit: false, cacheDir: dir, safeKey, metadata };
+}
+//# sourceMappingURL=skill-cache.js.map

package/dist/services/skill-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-cache.js","sourceRoot":"","sources":["../../src/services/skill-cache.ts"],"names":[],"mappings":"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"}

package/dist/services/storage/azure-blob.d.ts

@@ -0,0 +1,8 @@
+import type { StorageUploadResult, StorageUploadSource } from "./types.js";
+export declare function isAzureBlobUrl(url: string): boolean;
+export declare function downloadAzureBlobToFile(url: string, targetPath: string): Promise<void>;
+export declare function uploadAzureBlobFile(source: StorageUploadSource, destination: {
+    container: string;
+    blob_prefix?: string;
+}): Promise<StorageUploadResult>;
+//# sourceMappingURL=azure-blob.d.ts.map

package/dist/services/storage/azure-blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-blob.d.ts","sourceRoot":"","sources":["../../../src/services/storage/azure-blob.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAM3E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAsGD,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5F;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}

package/dist/services/storage/azure-blob.js

@@ -0,0 +1,146 @@
+import { createReadStream, createWriteStream } from "node:fs";
+import { pipeline } from "node:stream/promises";
+import { BlobClient, BlobServiceClient, StorageSharedKeyCredential, } from "@azure/storage-blob";
+import { ModelError, ValidationError } from "../../utils/errors.js";
+import { redactUrlForLogs } from "../download-auth.js";
+import { safeErrorDetails, withPrefix } from "./utils.js";
+const AZURE_BLOB_HOST_SUFFIX = ".blob.core.windows.net";
+const AZURE_ACCOUNT_RE = /^[a-z0-9]{3,24}$/;
+export function isAzureBlobUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === "https:" && accountFromBlobHost(parsed.hostname) !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+function hasQuery(url) {
+    try {
+        return new URL(url).search.length > 1;
+    }
+    catch {
+        return false;
+    }
+}
+function accountFromBlobHost(hostname) {
+    if (!hostname.endsWith(AZURE_BLOB_HOST_SUFFIX))
+        return undefined;
+    const account = hostname.slice(0, -AZURE_BLOB_HOST_SUFFIX.length);
+    return AZURE_ACCOUNT_RE.test(account) ? account : undefined;
+}
+function accountFromConnectionString(connectionString) {
+    const account = /(?:^|;)AccountName=([^;]+)/i.exec(connectionString)?.[1];
+    if (account)
+        return account.toLowerCase();
+    const endpoint = /(?:^|;)BlobEndpoint=([^;]+)/i.exec(connectionString)?.[1];
+    if (!endpoint)
+        return undefined;
+    try {
+        return accountFromBlobHost(new URL(endpoint).hostname);
+    }
+    catch {
+        return undefined;
+    }
+}
+function blobServiceClientFromEnv() {
+    const connectionString = process.env.AZURE_STORAGE_CONNECTION_STRING;
+    if (connectionString) {
+        return {
+            account: accountFromConnectionString(connectionString),
+            client: BlobServiceClient.fromConnectionString(connectionString),
+        };
+    }
+    const account = process.env.AZURE_STORAGE_ACCOUNT;
+    const key = process.env.AZURE_STORAGE_KEY;
+    if (account && key) {
+        const normalizedAccount = account.toLowerCase();
+        return {
+            account: normalizedAccount,
+            client: new BlobServiceClient(`https://${normalizedAccount}.blob.core.windows.net`, new StorageSharedKeyCredential(normalizedAccount, key)),
+        };
+    }
+    return undefined;
+}
+function parseAzureBlobUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new ValidationError("Invalid Azure Blob URL.");
+    }
+    const account = accountFromBlobHost(parsed.hostname);
+    if (parsed.protocol !== "https:" || !account) {
+        throw new ValidationError("Invalid Azure Blob URL. Expected https://<account>.blob.core.windows.net/<container>/<blob>.");
+    }
+    const parts = parsed.pathname.split("/").filter(Boolean);
+    if (parts.length < 2) {
+        throw new ValidationError("Invalid Azure Blob URL. Expected https://<account>.blob.core.windows.net/<container>/<blob>.");
+    }
+    return { account, container: parts[0], blob: parts.slice(1).join("/") };
+}
+function blobClientForDownload(url) {
+    const parsed = parseAzureBlobUrl(url);
+    if (hasQuery(url)) {
+        return new BlobClient(url);
+    }
+    const envClient = blobServiceClientFromEnv();
+    if (envClient) {
+        if (!envClient.account || envClient.account !== parsed.account) {
+            throw new ValidationError("Azure Blob URL account must match configured Azure storage account.");
+        }
+        return envClient.client.getContainerClient(parsed.container).getBlobClient(parsed.blob);
+    }
+    return new BlobClient(url);
+}
+function blobServiceClientForUpload() {
+    const envClient = blobServiceClientFromEnv();
+    if (!envClient) {
+        throw new ValidationError("Azure upload requires AZURE_STORAGE_CONNECTION_STRING or AZURE_STORAGE_ACCOUNT plus AZURE_STORAGE_KEY.");
+    }
+    return envClient.client;
+}
+export async function downloadAzureBlobToFile(url, targetPath) {
+    try {
+        const response = await blobClientForDownload(url).download();
+        if (!response.readableStreamBody) {
+            throw new ModelError("Azure Blob download response has no body", {
+                url: redactUrlForLogs(url),
+            });
+        }
+        await pipeline(response.readableStreamBody, createWriteStream(targetPath));
+    }
+    catch (err) {
+        if (err instanceof ModelError || err instanceof ValidationError)
+            throw err;
+        throw new ModelError("Azure Blob download failed", {
+            url: redactUrlForLogs(url),
+            ...safeErrorDetails(err),
+        });
+    }
+}
+export async function uploadAzureBlobFile(source, destination) {
+    const blobName = withPrefix(destination.blob_prefix, source.filename);
+    try {
+        const blockBlobClient = blobServiceClientForUpload()
+            .getContainerClient(destination.container)
+            .getBlockBlobClient(blobName);
+        const options = source.contentType
+            ? { blobHTTPHeaders: { blobContentType: source.contentType } }
+            : undefined;
+        if (source.path) {
+            await blockBlobClient.uploadStream(createReadStream(source.path), undefined, undefined, options);
+        }
+        else {
+            await blockBlobClient.uploadData(source.data ?? Buffer.alloc(0), options);
+        }
+        return { provider: "azure", url: redactUrlForLogs(blockBlobClient.url) };
+    }
+    catch (err) {
+        if (err instanceof ValidationError)
+            throw err;
+        throw new ModelError("Azure Blob upload failed", safeErrorDetails(err));
+    }
+}
+//# sourceMappingURL=azure-blob.js.map

package/dist/services/storage/azure-blob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-blob.js","sourceRoot":"","sources":["../../../src/services/storage/azure-blob.ts"],"names":[],"mappings":"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"}

package/dist/services/storage/hf.d.ts

@@ -0,0 +1,7 @@
+import type { StorageUploadResult, StorageUploadSource } from "./types.js";
+export declare function uploadHfFile(source: StorageUploadSource, destination: {
+    repo: string;
+    repo_type?: "model" | "dataset" | "space";
+    path?: string;
+}): Promise<StorageUploadResult>;
+//# sourceMappingURL=hf.d.ts.map

package/dist/services/storage/hf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf.d.ts","sourceRoot":"","sources":["../../../src/services/storage/hf.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAyC3E,wBAAsB,YAAY,CAChC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtF,OAAO,CAAC,mBAAmB,CAAC,CAoC9B"}