@greatlhd/ailo-endpoint-sdk 1.0.0

package/dist/local-endpoint-storage.js

@@ -0,0 +1,143 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+function safeEndpointDirSegment(id) {
+    const s = id.replace(/[^a-zA-Z0-9._-]+/g, "_").trim();
+    return s.slice(0, 200) || "default";
+}
+function loadSync(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const o = JSON.parse(raw);
+        if (typeof o !== "object" || o === null || Array.isArray(o))
+            return {};
+        const out = {};
+        for (const [k, v] of Object.entries(o)) {
+            if (typeof v === "string")
+                out[k] = v;
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+function saveSync(filePath, data) {
+    const tmp = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(data), "utf-8");
+    fs.renameSync(tmp, filePath);
+}
+export function createLocalEndpointStorage(endpointId) {
+    const dir = path.join(os.homedir(), ".ailo", "endpoint-data", safeEndpointDirSegment(endpointId));
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, "kv.json");
+    let chain = Promise.resolve();
+    function runExclusive(fn) {
+        const p = chain.then(fn, fn);
+        chain = p.then(() => { }, () => { });
+        return p;
+    }
+    return {
+        getData(key) {
+            return runExclusive(async () => {
+                const o = loadSync(filePath);
+                return Object.prototype.hasOwnProperty.call(o, key) ? o[key] : null;
+            });
+        },
+        async setData(key, value) {
+            await runExclusive(async () => {
+                const o = loadSync(filePath);
+                o[key] = value;
+                saveSync(filePath, o);
+            });
+        },
+        async deleteData(key) {
+            await runExclusive(async () => {
+                const o = loadSync(filePath);
+                delete o[key];
+                saveSync(filePath, o);
+            });
+        },
+    };
+}
+export function createCachedEndpointStorage(endpointId, options) {
+    const flushDelayMs = options?.flushDelayMs ?? 100;
+    const maxCacheSize = options?.maxCacheSize ?? 1000;
+    const dir = path.join(os.homedir(), ".ailo", "endpoint-data", safeEndpointDirSegment(endpointId));
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, "kv.json");
+    const cache = new Map();
+    const dirtyKeys = new Set();
+    let loaded = false;
+    let flushTimer = null;
+    let writeChain = Promise.resolve();
+    function ensureLoaded() {
+        if (loaded)
+            return;
+        const data = loadSync(filePath);
+        for (const [k, v] of Object.entries(data)) {
+            cache.set(k, v);
+        }
+        loaded = true;
+    }
+    function scheduleFlush() {
+        if (flushTimer)
+            return;
+        flushTimer = setTimeout(() => {
+            flushTimer = null;
+            void flush();
+        }, flushDelayMs);
+    }
+    async function flush() {
+        if (dirtyKeys.size === 0)
+            return;
+        const keysToFlush = [...dirtyKeys];
+        dirtyKeys.clear();
+        await writeChain;
+        writeChain = (async () => {
+            ensureLoaded();
+            const data = {};
+            for (const [k, v] of cache) {
+                data[k] = v;
+            }
+            saveSync(filePath, data);
+        })();
+    }
+    function clearCache() {
+        cache.clear();
+        dirtyKeys.clear();
+        loaded = false;
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = null;
+        }
+    }
+    return {
+        async getData(key) {
+            ensureLoaded();
+            return cache.has(key) ? cache.get(key) : null;
+        },
+        async setData(key, value) {
+            ensureLoaded();
+            if (cache.size >= maxCacheSize && !cache.has(key)) {
+                const oldestKey = cache.keys().next().value;
+                if (oldestKey) {
+                    cache.delete(oldestKey);
+                    dirtyKeys.add(oldestKey);
+                }
+            }
+            cache.set(key, value);
+            dirtyKeys.add(key);
+            scheduleFlush();
+        },
+        async deleteData(key) {
+            ensureLoaded();
+            cache.delete(key);
+            dirtyKeys.add(key);
+            scheduleFlush();
+        },
+        flush,
+        clearCache,
+    };
+}
+//# sourceMappingURL=local-endpoint-storage.js.map

package/dist/local-endpoint-storage.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,25 @@
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export interface LogData {
+    [key: string]: unknown;
+}
+export interface Logger {
+    error(event: string, data?: LogData): void;
+    warn(event: string, data?: LogData): void;
+    info(event: string, data?: LogData): void;
+    debug(event: string, data?: LogData): void;
+}
+export declare class ConsoleLogger implements Logger {
+    private prefix;
+    constructor(prefix?: string);
+    error(event: string, data?: LogData): void;
+    warn(event: string, data?: LogData): void;
+    info(event: string, data?: LogData): void;
+    debug(event: string, data?: LogData): void;
+}
+export declare class NoopLogger implements Logger {
+    error(): void;
+    warn(): void;
+    info(): void;
+    debug(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,OAAO;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED,qBAAa,aAAc,YAAW,MAAM;IAC9B,OAAO,CAAC,MAAM;gBAAN,MAAM,GAAE,MAAqB;IAEjD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI1C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAK3C;AAED,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;CACd"}

package/dist/logger.js

@@ -0,0 +1,27 @@
+export class ConsoleLogger {
+    prefix;
+    constructor(prefix = '[endpoint]') {
+        this.prefix = prefix;
+    }
+    error(event, data) {
+        console.error(`${this.prefix} [ERROR] ${event}`, data ?? '');
+    }
+    warn(event, data) {
+        console.warn(`${this.prefix} [WARN] ${event}`, data ?? '');
+    }
+    info(event, data) {
+        console.log(`${this.prefix} [INFO] ${event}`, data ?? '');
+    }
+    debug(event, data) {
+        if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
+            console.log(`${this.prefix} [DEBUG] ${event}`, data ?? '');
+        }
+    }
+}
+export class NoopLogger {
+    error() { }
+    warn() { }
+    info() { }
+    debug() { }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,SAAiB,YAAY;QAA7B,WAAM,GAAN,MAAM,CAAuB;IAAG,CAAC;IAErD,KAAK,CAAC,KAAa,EAAE,IAAc;QACjC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,YAAY,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,IAAc;QAChC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,IAAc;QAChC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAa,EAAE,IAAc;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,YAAY,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACrB,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACjB"}

package/dist/media-util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MIME type inference and media classification utilities.
+ */
+/** Infer MIME type from a file path's extension. */
+export declare function inferMime(filePath: string): string;
+/** Classify a MIME type into a ContentPart.type value. */
+export declare function classifyMedia(mime: string): "image" | "audio" | "video" | "pdf" | "file";
+//# sourceMappingURL=media-util.d.ts.map

package/dist/media-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-util.d.ts","sourceRoot":"","sources":["../src/media-util.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAOxF"}

package/dist/media-util.js

@@ -0,0 +1,78 @@
+/**
+ * MIME type inference and media classification utilities.
+ */
+import * as path from "path";
+const MIME_MAP = {
+    // image
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    bmp: "image/bmp",
+    ico: "image/x-icon",
+    tiff: "image/tiff",
+    tif: "image/tiff",
+    avif: "image/avif",
+    // audio
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    opus: "audio/opus",
+    flac: "audio/flac",
+    aac: "audio/aac",
+    m4a: "audio/mp4",
+    wma: "audio/x-ms-wma",
+    // video
+    mp4: "video/mp4",
+    webm: "video/webm",
+    mkv: "video/x-matroska",
+    avi: "video/x-msvideo",
+    mov: "video/quicktime",
+    wmv: "video/x-ms-wmv",
+    flv: "video/x-flv",
+    m4v: "video/mp4",
+    // document
+    pdf: "application/pdf",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    // text / data
+    txt: "text/plain",
+    csv: "text/csv",
+    json: "application/json",
+    xml: "application/xml",
+    html: "text/html",
+    md: "text/markdown",
+    yaml: "text/yaml",
+    yml: "text/yaml",
+    // archive
+    zip: "application/zip",
+    gz: "application/gzip",
+    tar: "application/x-tar",
+    "7z": "application/x-7z-compressed",
+    rar: "application/vnd.rar",
+};
+/** Infer MIME type from a file path's extension. */
+export function inferMime(filePath) {
+    const ext = path.extname(filePath).toLowerCase().replace(".", "");
+    return MIME_MAP[ext] ?? "application/octet-stream";
+}
+/** Classify a MIME type into a ContentPart.type value. */
+export function classifyMedia(mime) {
+    const m = mime.toLowerCase();
+    if (m.startsWith("image/"))
+        return "image";
+    if (m.startsWith("audio/"))
+        return "audio";
+    if (m.startsWith("video/"))
+        return "video";
+    if (m === "application/pdf")
+        return "pdf";
+    return "file";
+}
+//# sourceMappingURL=media-util.js.map

package/dist/media-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-util.js","sourceRoot":"","sources":["../src/media-util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,QAAQ,GAA2B;IACvC,QAAQ;IACR,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,QAAQ;IACR,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,gBAAgB;IACrB,QAAQ;IACR,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,WAAW;IAChB,WAAW;IACX,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,oBAAoB;IACzB,IAAI,EAAE,yEAAyE;IAC/E,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,mEAAmE;IACzE,GAAG,EAAE,+BAA+B;IACpC,IAAI,EAAE,2EAA2E;IACjF,cAAc;IACd,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,WAAW;IAChB,UAAU;IACV,GAAG,EAAE,iBAAiB;IACtB,EAAE,EAAE,kBAAkB;IACtB,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,6BAA6B;IACnC,GAAG,EAAE,qBAAqB;CAC3B,CAAC;AAEF,oDAAoD;AACpD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACrD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export { autoUploadMedia, resolveFileArgsInPlace, resolveToLocal, materializeInlineMedia } from './media.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACvB,MAAM,YAAY,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,2 @@
+export { autoUploadMedia, resolveFileArgsInPlace, resolveToLocal, materializeInlineMedia } from './media.js';
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACvB,MAAM,YAAY,CAAC"}

package/dist/middleware/media.d.ts

@@ -0,0 +1,7 @@
+import type { ContentPart } from "../types.js";
+import type { BlobClient } from "../blob/client.js";
+export declare function autoUploadMedia(content: ContentPart[], blobClient: BlobClient): Promise<void>;
+export declare function resolveFileArgsInPlace(args: Record<string, unknown>, blobClient: BlobClient, blobUrlPrefix: string): Promise<void>;
+export declare function resolveToLocal(pathOrUrl: string, blobClient: BlobClient, endpointId: string, blobUrlPrefix: string): Promise<string>;
+export declare function materializeInlineMedia(data: string, mime: string | undefined, type: Exclude<ContentPart["type"], "text">): string;
+//# sourceMappingURL=media.d.ts.map

package/dist/middleware/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/middleware/media.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,wBAAsB,eAAe,CACnC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAejB;AAoBD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GACzC,MAAM,CASR"}

package/dist/middleware/media.js

@@ -0,0 +1,112 @@
+import * as path from "path";
+import * as fs from "fs";
+import * as os from "os";
+import * as crypto from "crypto";
+import { inferMime } from "../media-util.js";
+import { parseFileRef, isFileRef } from "../fileref.js";
+export async function autoUploadMedia(content, blobClient) {
+    for (let i = 0; i < content.length; i++) {
+        const part = content[i];
+        if (!part.media?.path)
+            continue;
+        const absPath = path.resolve(part.media.path);
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`auto-upload: file not found: ${absPath}`);
+        }
+        const { fileRef } = await blobClient.upload(absPath);
+        content[i] = {
+            ...part,
+            media: {
+                type: part.media.type,
+                fileRef,
+                mime: part.media.mime || inferMime(absPath),
+                name: part.media.name || path.basename(absPath),
+                sourcePath: absPath,
+            },
+        };
+    }
+}
+export async function resolveFileArgsInPlace(args, blobClient, blobUrlPrefix) {
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === "string" && value.startsWith(blobUrlPrefix)) {
+            try {
+                args[key] = await blobClient.download(value);
+            }
+            catch {
+                // keep original 
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                if (typeof value[i] === "string" && value[i].startsWith(blobUrlPrefix)) {
+                    try {
+                        value[i] = await blobClient.download(value[i]);
+                    }
+                    catch {
+                        // keep 
+                    }
+                }
+                else if (typeof value[i] === "object" && value[i] !== null) {
+                    await resolveFileArgsInPlace(value[i], blobClient, blobUrlPrefix);
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            await resolveFileArgsInPlace(value, blobClient, blobUrlPrefix);
+        }
+    }
+}
+export async function resolveToLocal(pathOrUrl, blobClient, endpointId, blobUrlPrefix) {
+    if (isFileRef(pathOrUrl)) {
+        const parsed = parseFileRef(pathOrUrl);
+        if (parsed.type === "endpoint" && parsed.endpointId === endpointId) {
+            return parsed.path;
+        }
+        if (parsed.type === "blob") {
+            return blobClient.download(`${blobClient['opts'].httpBase}/api/blob/${parsed.blobId}`);
+        }
+        return pathOrUrl;
+    }
+    if (pathOrUrl.startsWith(blobUrlPrefix)) {
+        return blobClient.download(pathOrUrl);
+    }
+    return pathOrUrl;
+}
+function tmpExtensionForMedia(mime, type) {
+    const normalized = (mime || "").toLowerCase();
+    if (normalized === "image/png")
+        return ".png";
+    if (normalized === "image/jpeg")
+        return ".jpg";
+    if (normalized === "image/webp")
+        return ".webp";
+    if (normalized === "image/gif")
+        return ".gif";
+    if (normalized === "audio/mpeg")
+        return ".mp3";
+    if (normalized === "audio/wav" || normalized === "audio/x-wav")
+        return ".wav";
+    if (normalized === "audio/ogg")
+        return ".ogg";
+    if (normalized === "video/mp4")
+        return ".mp4";
+    if (normalized === "application/pdf")
+        return ".pdf";
+    if (type === "image")
+        return ".png";
+    if (type === "audio")
+        return ".mp3";
+    if (type === "video")
+        return ".mp4";
+    if (type === "pdf")
+        return ".pdf";
+    return ".bin";
+}
+export function materializeInlineMedia(data, mime, type) {
+    const dir = path.join(os.tmpdir(), "ailo_mcp_media");
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${Date.now()}_${crypto.randomUUID()}${tmpExtensionForMedia(mime, type)}`);
+    fs.writeFileSync(filePath, Buffer.from(data, "base64"));
+    return filePath;
+}
+//# sourceMappingURL=media.js.map

package/dist/middleware/media.js.map

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

package/dist/skill-loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * skill-loader.ts — Scans local SKILL.md files and parses them into SkillMeta[].
+ *
+ * Compatible with the ~/.agents/skills/ convention used by Cursor, CoPaw and others.
+ * Each skill lives in its own subdirectory with a SKILL.md file:
+ *
+ *   ~/.agents/skills/
+ *     pdf-processing/
+ *       SKILL.md          ← YAML frontmatter (name, description) + markdown body
+ *     ui-analysis/
+ *       SKILL.md
+ */
+import type { SkillMeta } from "./types.js";
+/**
+ * Scan one or more directories for `*​/SKILL.md` files, parse frontmatter, return SkillMeta[].
+ * Directories that don't exist are silently skipped.
+ */
+export declare function loadSkills(dirs?: string[]): SkillMeta[];
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CA8CvD"}

package/dist/skill-loader.js

@@ -0,0 +1,131 @@
+/**
+ * skill-loader.ts — Scans local SKILL.md files and parses them into SkillMeta[].
+ *
+ * Compatible with the ~/.agents/skills/ convention used by Cursor, CoPaw and others.
+ * Each skill lives in its own subdirectory with a SKILL.md file:
+ *
+ *   ~/.agents/skills/
+ *     pdf-processing/
+ *       SKILL.md          ← YAML frontmatter (name, description) + markdown body
+ *     ui-analysis/
+ *       SKILL.md
+ */
+import fs from "fs";
+import path from "path";
+import os from "os";
+import yaml from "js-yaml";
+/**
+ * Scan one or more directories for `*​/SKILL.md` files, parse frontmatter, return SkillMeta[].
+ * Directories that don't exist are silently skipped.
+ */
+export function loadSkills(dirs) {
+    const resolved = (dirs && dirs.length > 0)
+        ? dirs
+        : [path.join(os.homedir(), ".agents", "skills")];
+    const skills = [];
+    const seen = new Set();
+    for (const dir of resolved) {
+        const expanded = dir.startsWith("~")
+            ? path.join(os.homedir(), dir.slice(1))
+            : dir;
+        if (!fs.existsSync(expanded))
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(expanded, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillFile = path.join(expanded, entry.name, "SKILL.md");
+            if (!fs.existsSync(skillFile))
+                continue;
+            try {
+                const raw = fs.readFileSync(skillFile, "utf-8");
+                const meta = parseSkillMd(raw, entry.name);
+                if (meta) {
+                    if (seen.has(meta.name)) {
+                        const idx = skills.findIndex((s) => s.name === meta.name);
+                        if (idx >= 0)
+                            skills[idx] = meta;
+                    }
+                    else {
+                        seen.add(meta.name);
+                        skills.push(meta);
+                    }
+                }
+            }
+            catch {
+                // skip unreadable files
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Parse a SKILL.md file with optional YAML frontmatter.
+ *
+ * Frontmatter format:
+ * ```
+ * ---
+ * name: pdf-processing
+ * description: Extract text and tables from PDF files
+ * ---
+ * (markdown body)
+ * ```
+ *
+ * If no frontmatter, `dirName` is used as the name and the first non-empty line as description.
+ */
+function parseSkillMd(raw, dirName) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    let name = dirName;
+    let description = "";
+    let content;
+    if (trimmed.startsWith("---")) {
+        const endIdx = trimmed.indexOf("---", 3);
+        if (endIdx > 0) {
+            const frontmatter = trimmed.slice(3, endIdx);
+            content = trimmed.slice(endIdx + 3).trim();
+            try {
+                const parsed = yaml.load(frontmatter);
+                if (parsed && typeof parsed === "object") {
+                    if (typeof parsed.name === "string" && parsed.name)
+                        name = parsed.name;
+                    if (typeof parsed.description === "string" && parsed.description)
+                        description = parsed.description;
+                }
+            }
+            catch {
+                // Fall back to simple string parsing if yaml fails
+                for (const line of frontmatter.split("\n")) {
+                    const colonIdx = line.indexOf(":");
+                    if (colonIdx < 0)
+                        continue;
+                    const key = line.slice(0, colonIdx).trim().toLowerCase();
+                    const val = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, "");
+                    if (key === "name" && val)
+                        name = val;
+                    if (key === "description" && val)
+                        description = val;
+                }
+            }
+        }
+        else {
+            content = trimmed;
+        }
+    }
+    else {
+        content = trimmed;
+    }
+    if (!description) {
+        const firstLine = content.split("\n").find((l) => l.trim() && !l.startsWith("#"));
+        description = firstLine?.trim().slice(0, 200) ?? name;
+    }
+    return { name, description, content };
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skill-loader.js.map

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

package/dist/tool-dispatch/index.d.ts

@@ -0,0 +1,3 @@
+export { normalizeToolResult } from './normalize.js';
+export type { ToolHandler } from './normalize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tool-dispatch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool-dispatch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tool-dispatch/index.js

@@ -0,0 +1,2 @@
+export { normalizeToolResult } from './normalize.js';
+//# sourceMappingURL=index.js.map

package/dist/tool-dispatch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-dispatch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tool-dispatch/normalize.d.ts

@@ -0,0 +1,5 @@
+import type { ContentPart, ToolHandler } from "../types.js";
+import type { BlobClient } from "../blob/client.js";
+export declare function normalizeToolResult(result: unknown, blobClient: BlobClient): Promise<ContentPart[] | unknown>;
+export type { ToolHandler };
+//# sourceMappingURL=normalize.d.ts.map