@evolinkai/mcp 0.0.0-stage → 1.4.0

package/dist/core/src/tools/task-format.js

@@ -0,0 +1,212 @@
+import { queryTask } from '../services/api-client.js';
+import { getTaskErrorInfo } from '../services/error-handler.js';
+import { money, sleep, usdOf } from './shared.js';
+/** Result links from the gateway stay downloadable for this long. */
+export const RESULT_LINK_HOURS = 24;
+/** Generation permission does not also authorize the assistant to alter the output. */
+export const RESULT_DELIVERY_INSTRUCTIONS = [
+    'Deliver the original EvoLink result links immediately on completion, with clear view/download labels and the 24-hour expiry notice. Use delivery_markdown as the primary reply when supplied.',
+    'Do not delay delivery for inspection or post-processing. A generation request alone does not authorize local editing, compositing, repair or re-encoding; do that only when the user explicitly requests or authorizes post-processing.',
+    'Report quality issues and offer options. Keep the original links and label any authorized edited version separately.',
+    'Default to ordinary Markdown links for all media, including images; do not automatically add inline remote images or thumbnail placeholders. Only add an image preview when the user requests it and a supported working client preview route is available; otherwise keep the links.',
+    'The server may supply small embedded MCP image thumbnails or video cover frames alongside the original links. These optional previews are not edited replacements; let the client display them and keep delivery_markdown and the original download links in the reply. Do not turn preview metadata into remote Markdown images.',
+    'Use ordinary Markdown links for video/audio, never image syntax for a video URL. Inline previews depend on the client; do not promise them.',
+].join(' ');
+/** Compact tool description; the full contract is sent in server instructions and completed results. */
+export const RESULT_DELIVERY_GUIDANCE = 'On completion, promptly deliver original links with the 24-hour expiry and delivery_markdown. Edit only when the user explicitly requests or authorizes post-processing. Keep original links alongside optional embedded MCP thumbnails; do not add remote-image Markdown or use image syntax for video/audio.';
+export const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled']);
+const MEDIA_EXTENSIONS = {
+    png: { kind: 'image', mimeType: 'image/png' },
+    jpg: { kind: 'image', mimeType: 'image/jpeg' },
+    jpeg: { kind: 'image', mimeType: 'image/jpeg' },
+    webp: { kind: 'image', mimeType: 'image/webp' },
+    gif: { kind: 'image', mimeType: 'image/gif' },
+    bmp: { kind: 'image', mimeType: 'image/bmp' },
+    mp4: { kind: 'video', mimeType: 'video/mp4' },
+    mov: { kind: 'video', mimeType: 'video/quicktime' },
+    webm: { kind: 'video', mimeType: 'video/webm' },
+    m4v: { kind: 'video', mimeType: 'video/x-m4v' },
+    mp3: { kind: 'audio', mimeType: 'audio/mpeg' },
+    wav: { kind: 'audio', mimeType: 'audio/wav' },
+    m4a: { kind: 'audio', mimeType: 'audio/mp4' },
+    flac: { kind: 'audio', mimeType: 'audio/flac' },
+    ogg: { kind: 'audio', mimeType: 'audio/ogg' },
+    aac: { kind: 'audio', mimeType: 'audio/aac' },
+};
+/** Infer metadata from the path only: a signed query or fragment is not a file extension. */
+function mediaOfUrl(url) {
+    try {
+        const extension = /\.([a-z0-9]+)$/i.exec(new URL(url).pathname)?.[1].toLowerCase();
+        return extension && Object.prototype.hasOwnProperty.call(MEDIA_EXTENSIONS, extension) ? MEDIA_EXTENSIONS[extension] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function kindOfUrl(url, taskType, hint) {
+    const media = mediaOfUrl(url);
+    if (media)
+        return media.kind;
+    if (hint)
+        return hint;
+    if (taskType.includes('image'))
+        return 'image';
+    if (taskType.includes('video'))
+        return 'video';
+    if (taskType.includes('audio') || taskType.includes('music'))
+        return 'audio';
+    return 'file';
+}
+export function resultLinks(task) {
+    const seen = new Set();
+    const links = [];
+    const add = (url, kind) => {
+        if (typeof url !== 'string' || !/^https?:\/\//.test(url) || seen.has(url))
+            return;
+        seen.add(url);
+        links.push({ url, kind: kindOfUrl(url, task.type ?? '', kind) });
+    };
+    for (const url of task.results ?? [])
+        add(url);
+    if (Array.isArray(task.result_data)) {
+        for (const item of task.result_data) {
+            add(item.video_url, 'video');
+            add(item.image_url, 'image');
+            add(item.audio_url, 'audio');
+        }
+    }
+    return links;
+}
+/** Typed links complement the text fallback; they do not guarantee a client preview.
+ * Never fetch or transform media here, and never wrap a video URL in ImageContent.
+ * Unknown extensions deliberately omit MIME instead of guessing a container.
+ */
+export function resultResources(taskId, links) {
+    return links.map((link, index) => {
+        const media = mediaOfUrl(link.url);
+        return {
+            type: 'resource_link',
+            uri: link.url,
+            name: `View/download original ${link.kind} ${index + 1} (${taskId})`,
+            description: `Original EvoLink generated ${link.kind}. View or download; result links expire after ${RESULT_LINK_HOURS} hours. Inline preview depends on the client.`,
+            ...(media ? { mimeType: media.mimeType } : {}),
+        };
+    });
+}
+/** A ready-to-send reply avoids triggering a client's remote-image fallback by default.
+ * Angle brackets keep parentheses in signed URLs inside the link destination.
+ * Resource URIs remain untouched; encode only characters unsafe in a Markdown destination.
+ */
+export function resultDeliveryMarkdown(taskId, links) {
+    return [
+        `EvoLink task ${taskId} completed.`,
+        ...links.map((link, index) => {
+            const destination = link.url.replace(/[\u0000-\u0020<>\\]/g, char => encodeURIComponent(char));
+            return `[View/download original ${link.kind} ${index + 1}](<${destination}>)`;
+        }),
+        `Result links expire after ${RESULT_LINK_HOURS} hours; save them promptly.`,
+    ].join('\n\n');
+}
+/** One task as text lines and the same facts as structured content. */
+export function describeTask(task) {
+    const status = task.status ?? 'pending';
+    const links = resultLinks(task);
+    const lines = [
+        `Task ${task.id}: ${status}${status === 'completed' || status === 'failed' ? '' : ` (${task.progress ?? 0}%)`}`,
+        `Model: ${task.model}`,
+    ];
+    const structured = {
+        task_id: task.id,
+        status,
+        progress: task.progress ?? 0,
+        model: task.model,
+        type: task.type,
+    };
+    if (links.length > 0) {
+        lines.push(`Results (download links expire after ${RESULT_LINK_HOURS} hours; save them now):`);
+        for (const link of links)
+            lines.push(`- ${link.kind}: ${link.url}`);
+        structured.results = links;
+        structured.links_expire_after_hours = RESULT_LINK_HOURS;
+    }
+    const used = task.usage?.credits_used ?? task.usage?.cost?.credits;
+    if (status === 'completed' && typeof used === 'number') {
+        lines.push(`Charged: ${money(used)}`);
+        structured.charged_credits = used;
+        structured.charged_usd = task.usage?.cost?.usd ?? usdOf(used);
+    }
+    const reserved = task.usage?.credits_reserved;
+    if (status !== 'completed' && status !== 'failed' && typeof reserved === 'number' && reserved > 0) {
+        lines.push(`Reserved: ${money(reserved)} (the final charge is settled when the task finishes)`);
+        structured.reserved_credits = reserved;
+        structured.reserved_usd = usdOf(reserved);
+    }
+    if (typeof task.duration === 'number' && task.duration > 0 && TERMINAL_STATUSES.has(status)) {
+        lines.push(`Took: ${task.duration} s`);
+        structured.took_seconds = task.duration;
+    }
+    if (status === 'failed' || status === 'cancelled') {
+        const code = task.error?.code ?? (status === 'cancelled' ? 'request_cancelled' : 'unknown_error');
+        const info = getTaskErrorInfo(code);
+        const suggestion = task.error?.suggestion ? `${info.suggestion} ${task.error.suggestion}` : info.suggestion;
+        lines.push(`Error: ${code}${task.error?.message ? ` — ${task.error.message}` : ''}`);
+        lines.push('Charge: failed tasks are refunded.');
+        lines.push(`Next step: ${info.retryable ? 'You can retry with a new generate call.' : 'Change the input before retrying.'} ${suggestion}`);
+        structured.error = { code, message: task.error?.message, retryable: info.retryable, suggestion };
+        structured.refunded = true;
+    }
+    else if (status === 'completed') {
+        if (links.length > 0) {
+            const delivery = resultDeliveryMarkdown(task.id, links);
+            structured.delivery_markdown = delivery;
+            lines.push(`Suggested reply (plain links; no automatic inline previews):\n${delivery}`);
+        }
+        lines.push(links.length > 0
+            ? `Next step: ${RESULT_DELIVERY_INSTRUCTIONS}`
+            : 'Next step: the task completed but returned no result links. Tell the user; use get_task or list_tasks to recover them. Do not generate again automatically.');
+    }
+    else {
+        const eta = task.task_info?.estimated_time;
+        if (eta) {
+            lines.push(`Estimated time left: ~${eta} s`);
+            structured.estimated_seconds = eta;
+        }
+        lines.push(`Next step: call get_task with task_id "${task.id}" again (it can wait up to 45 s). Do not call generate again to check progress: that starts and charges a new task.`);
+    }
+    if (task.request_id) {
+        lines.push(`Request ID: ${task.request_id}`);
+        structured.request_id = task.request_id;
+    }
+    return { lines, structured, resources: resultResources(task.id, links) };
+}
+let pollIntervalOverrideMs;
+/** Tests only: shorten the pause between task reads. */
+export function setPollIntervalForTests(ms) {
+    pollIntervalOverrideMs = ms;
+}
+/** Pause between task reads: each read of an unfinished task makes the gateway ask the provider. */
+export function pollIntervalMs(type) {
+    if (pollIntervalOverrideMs !== undefined)
+        return pollIntervalOverrideMs;
+    if (type?.includes('video'))
+        return 8_000;
+    if (type?.includes('audio') || type?.includes('music'))
+        return 6_000;
+    return 3_000;
+}
+/** Reads a task until it finishes or the deadline passes, pacing reads by task type. */
+export async function waitForTask(config, taskId, options) {
+    let task = options.initial ?? await queryTask(config, taskId, options.tool);
+    while (!TERMINAL_STATUSES.has(task.status) && !options.signal?.aborted) {
+        const interval = pollIntervalMs(task.type);
+        if (Date.now() + interval > options.deadline)
+            break;
+        await options.onPoll?.(task);
+        await sleep(interval, options.signal);
+        if (options.signal?.aborted)
+            break;
+        task = await queryTask(config, taskId, options.tool);
+    }
+    return task;
+}
+//# sourceMappingURL=task-format.js.map

package/dist/core/src/tools/task-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-format.js","sourceRoot":"","sources":["../../../../../core/src/tools/task-format.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAA0C,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAElD,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,uFAAuF;AACvF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,+LAA+L;IAC/L,yOAAyO;IACzO,sHAAsH;IACtH,uRAAuR;IACvR,mUAAmU;IACnU,6IAA6I;CAC9I,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,wGAAwG;AACxG,MAAM,CAAC,MAAM,wBAAwB,GAAG,gTAAgT,CAAC;AAEzV,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAO/E,MAAM,gBAAgB,GAAuE;IAC3F,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE;IACnD,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC9C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;CAC9C,CAAC;AAEF,6FAA6F;AAC7F,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACnF,OAAO,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClI,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,QAAgB,EAAE,IAA6B;IAC7E,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC7B,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,GAAY,EAAE,IAA6B,EAAE,EAAE;QAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAClF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAA+B,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAuB;IACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,0BAA0B,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,GAAG;YACpE,WAAW,EAAE,8BAA8B,IAAI,CAAC,IAAI,iDAAiD,iBAAiB,+CAA+C;YACrK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,KAAuB;IAC5E,OAAO;QACL,gBAAgB,MAAM,aAAa;QACnC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/F,OAAO,2BAA2B,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,MAAM,WAAW,IAAI,CAAC;QAChF,CAAC,CAAC;QACF,6BAA6B,iBAAiB,6BAA6B;KAC5E,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAQD,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,IAAkB;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG;QACZ,QAAQ,IAAI,CAAC,EAAE,KAAK,MAAM,GAAG,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE;QAC/G,UAAU,IAAI,CAAC,KAAK,EAAE;KACvB,CAAC;IACF,MAAM,UAAU,GAA4B;QAC1C,OAAO,EAAE,IAAI,CAAC,EAAE;QAChB,MAAM;QACN,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,wCAAwC,iBAAiB,yBAAyB,CAAC,CAAC;QAC/F,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC3B,UAAU,CAAC,wBAAwB,GAAG,iBAAiB,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;IACnE,IAAI,MAAM,KAAK,WAAW,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC;QAClC,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAC9C,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAClG,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,CAAC,uDAAuD,CAAC,CAAC;QAChG,UAAU,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACvC,UAAU,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAClG,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC5G,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC,mCAAmC,IAAI,UAAU,EAAE,CAAC,CAAC;QAC3I,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC;QACjG,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC7B,CAAC;SAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACxD,UAAU,CAAC,iBAAiB,GAAG,QAAQ,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,iEAAiE,QAAQ,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,cAAc,4BAA4B,EAAE;YAC9C,CAAC,CAAC,6JAA6J,CAAC,CAAC;IACrK,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC;QAC3C,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;YAC7C,UAAU,CAAC,iBAAiB,GAAG,GAAG,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,0CAA0C,IAAI,CAAC,EAAE,qHAAqH,CAAC,CAAC;IACrL,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,IAAI,sBAA0C,CAAC;AAE/C,wDAAwD;AACxD,MAAM,UAAU,uBAAuB,CAAC,EAAsB;IAC5D,sBAAsB,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,IAAI,sBAAsB,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IACxE,IAAI,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAYD,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB,EAAE,MAAc,EAAE,OAAoB;IAC1F,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ;YAAE,MAAM;QACpD,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,MAAM;QACnC,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/src/tools/upload-file.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../config.js';
+export interface UploadFileOptions {
+    /** Allow file_path uploads. The hosted service sets false: it must never read its own disk. */
+    localFiles?: boolean;
+    /**
+     * Signed-in hosted connection: no API key of its own, so each upload asks
+     * the gateway (config) for a short-lived upload token; base64_data is
+     * limited to 1 MB, larger local files go through prepare_upload.
+     */
+    signedIn?: {
+        config: ServerConfig;
+        oneTimeUploads: boolean;
+    };
+}
+export declare function registerUploadFile(server: McpServer, options?: UploadFileOptions): void;
+//# sourceMappingURL=upload-file.d.ts.map

package/dist/core/src/tools/upload-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/upload-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAuCjD,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAQD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,CA2G3F"}

package/dist/core/src/tools/upload-file.js

@@ -0,0 +1,134 @@
+import { basename } from 'node:path';
+import { z } from 'zod';
+import { requestUploadToken } from '../services/api-client.js';
+import { fileStreamUpload, fileBase64Upload, fileUrlUpload } from '../services/file-client.js';
+import { inspectBase64Upload, inspectLocalUpload, validateRemoteUploadURL, validateUploadDestination, } from '../services/upload-policy.js';
+import { SIGNED_IN_BASE64_MAX_BYTES } from '../services/upload-slots.js';
+import { WRITES, errorResult, failure, ok } from './shared.js';
+const localFileSchema = {
+    file_path: z.string().optional()
+        .describe('Absolute path under EVOLINK_UPLOAD_ALLOWED_DIRS. Provide exactly one of file_path, base64_data, or file_url.'),
+};
+const contentSchema = {
+    base64_data: z.string().optional()
+        .describe('Base64 media data for small files. Data URLs carry their MIME type; raw base64 also needs mime_type.'),
+    mime_type: z.string().optional()
+        .describe('MIME type for raw base64_data; must match the file content.'),
+    file_url: z.string().optional()
+        .describe('Public HTTPS link to the media. Loopback, private-network and credential-bearing links are refused.'),
+    upload_path: z.string().optional()
+        .describe('Optional relative folder in EvoLink storage (no ..).'),
+    file_name: z.string().optional()
+        .describe('Optional plain file name (no folders).'),
+};
+const SHARED_DESCRIPTION = [
+    'Store an image, audio or video file on EvoLink and get a link to pass to generate_* (for example in image_urls). Free; uses the file quota, and files are deleted after 72 hours.',
+    'Formats: images JPEG, PNG, GIF, WebP; audio MP3, WAV, M4A, AAC, FLAC, OGG/Opus; video MP4, MOV, WebM.',
+    'Max 100 MB; prefer file_url for large files.',
+];
+export function registerUploadFile(server, options = {}) {
+    const localFiles = options.localFiles ?? true;
+    const signedIn = options.signedIn;
+    const sourceNames = localFiles ? 'file_path, base64_data, or file_url' : 'base64_data or file_url';
+    const largeFiles = signedIn?.oneTimeUploads
+        ? 'for a local file over 1 MB call prepare_upload'
+        : 'pass a public file_url for anything larger';
+    /** Signed-in connections send an upload token from the gateway; everyone else sends their API key. */
+    async function withAuth(send) {
+        if (!signedIn)
+            return send();
+        const token = await requestUploadToken(signedIn.config, 'upload_file');
+        return send({ bearer: token.token });
+    }
+    const handler = async (params) => {
+        const { base64_data, file_url, mime_type, upload_path, file_name } = params;
+        const file_path = localFiles ? params.file_path : undefined;
+        const sources = [file_path, base64_data, file_url].filter(Boolean);
+        if (sources.length !== 1) {
+            const message = sources.length === 0 && signedIn
+                ? `This hosted EvoLink connection cannot read files on the user's computer. Pass a public file_url, or base64_data for a file up to 1 MB; ${largeFiles}.`
+                : `Provide exactly one of ${sourceNames}.`;
+            return failure(message, { error: { category: 'invalid_request' } });
+        }
+        // Local checks first: a refused source never reaches the network.
+        let upload;
+        try {
+            validateUploadDestination(upload_path, file_name);
+            if (file_path) {
+                const inspected = await inspectLocalUpload(file_path);
+                upload = () => fileStreamUpload(inspected.realPath, inspected.size, inspected.mimeType, basename(inspected.realPath), upload_path, file_name);
+            }
+            else if (base64_data) {
+                const { dataUrl, decodedBytes } = inspectBase64Upload(base64_data, mime_type);
+                if (signedIn && decodedBytes > SIGNED_IN_BASE64_MAX_BYTES) {
+                    throw new Error(`base64_data is limited to 1 MB on signed-in connections; ${largeFiles}`);
+                }
+                upload = () => withAuth(auth => fileBase64Upload(dataUrl, upload_path, file_name, auth));
+            }
+            else {
+                const url = validateRemoteUploadURL(file_url);
+                upload = () => withAuth(auth => fileUrlUpload(url, upload_path, file_name, auth));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'the file was refused';
+            return failure(`Upload refused: ${message}`, { error: { category: 'invalid_request', message } });
+        }
+        try {
+            const result = await upload();
+            const data = result.data;
+            if (!data)
+                throw new Error('File API returned no upload record');
+            const lines = [
+                'File uploaded.',
+                `File URL: ${data.file_url}`,
+                `Name: ${data.original_name} · ${(data.file_size / 1024).toFixed(1)} KB · ${data.mime_type}`,
+                `Expires: ${data.expires_at}`,
+            ];
+            if (result.request_id)
+                lines.push(`Request ID: ${result.request_id}`);
+            lines.push('Next step: pass the File URL to a generate tool as input.');
+            return ok(lines.join('\n'), {
+                file_url: data.file_url,
+                file_id: data.file_id,
+                file_name: data.original_name,
+                size_bytes: data.file_size,
+                mime_type: data.mime_type,
+                expires_at: data.expires_at,
+                ...(result.request_id ? { request_id: result.request_id } : {}),
+            });
+        }
+        catch (error) {
+            return errorResult(error, { upload: true });
+        }
+    };
+    if (localFiles) {
+        server.registerTool('upload_file', {
+            title: 'Upload a file',
+            description: [...SHARED_DESCRIPTION, 'Local paths work only inside EVOLINK_UPLOAD_ALLOWED_DIRS.'].join(' '),
+            inputSchema: { ...localFileSchema, ...contentSchema },
+            annotations: { title: 'Upload a file', ...WRITES },
+        }, handler);
+    }
+    else if (signedIn) {
+        server.registerTool('upload_file', {
+            title: 'Upload a file',
+            description: [
+                SHARED_DESCRIPTION[0],
+                SHARED_DESCRIPTION[1],
+                `Accepts a public file_url, or base64_data of a small file up to 1 MB. This service cannot read files on the user's computer: ${largeFiles}.`,
+            ].join(' '),
+            inputSchema: contentSchema,
+            annotations: { title: 'Upload a file', ...WRITES },
+        }, handler);
+    }
+    else {
+        server.registerTool('upload_file', {
+            title: 'Upload a file',
+            description: [...SHARED_DESCRIPTION, 'Accepts base64_data or a public file_url.'].join(' '),
+            inputSchema: contentSchema,
+            annotations: { title: 'Upload a file', ...WRITES },
+        }, handler);
+    }
+}
+//# sourceMappingURL=upload-file.js.map

package/dist/core/src/tools/upload-file.js.map

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

package/dist/core/src/version.d.ts

@@ -0,0 +1,3 @@
+/** Version reported in serverInfo and in the X-Evo-Client-Version header. */
+export declare const MCP_VERSION = "1.4.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/core/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../core/src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/core/src/version.js

@@ -0,0 +1,3 @@
+/** Version reported in serverInfo and in the X-Evo-Client-Version header. */
+export const MCP_VERSION = '1.4.0';
+//# sourceMappingURL=version.js.map

package/dist/core/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../core/src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/evolink-media/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/evolink-media/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":""}

package/dist/evolink-media/src/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer, createConfig, getApiKey } from '../../core/src/server.js';
+import { setProcessLinkCampaign } from '../../core/src/request-context.js';
+async function main() {
+    setProcessLinkCampaign('mcp_local'); // site links from the npm package: utm_campaign=mcp_local
+    getApiKey(); // validate API key early
+    const config = createConfig('official');
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('EvoLink Media MCP Server (official) started');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/evolink-media/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,KAAK,UAAU,IAAI;IACjB,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,0DAA0D;IAC/F,SAAS,EAAE,CAAC,CAAC,yBAAyB;IAEtC,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@evolinkai/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.4.0",
+  "mcpName": "ai.evolink/mcp",
+  "description": "Generate AI videos, images & music with one API key. 150+ models (Seedance, Kling, Veo, Sora, GPT Image, Suno...).",
+  "type": "module",
+  "main": "dist/evolink-media/src/index.js",
+  "bin": {
+    "evolink-mcp": "dist/evolink-media/src/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\"",
+    "postpack": "node -e \"require('fs').rmSync('LICENSE',{force:true})\""
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "ai",
+    "video",
+    "image",
+    "music",
+    "generation",
+    "sora",
+    "suno",
+    "kling",
+    "veo",
+    "seedance"
+  ],
+  "author": "EvoLink AI <support@evolink.ai>",
+  "license": "Apache-2.0",
+  "homepage": "https://evolink.ai/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Evolink-AI/evolink-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  }
+}