@evolinkai/mcp 0.0.0-stage → 1.3.0

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { READ_ONLY, errorResult, ok, progressReporter } from './shared.js';
+import { TERMINAL_STATUSES, describeTask, waitForTask } from './task-format.js';
+export const TASK_ID = /^[A-Za-z0-9._:-]{4,128}$/;
+/** Codex and Cursor drop a tool call after about 60 s; the reply also needs time to travel. */
+export const MAX_WAIT_SECONDS = 45;
+const REPLY_MARGIN_MS = 2_000;
+const PROGRESS_EVERY_SECONDS = 10;
+export function registerGetTask(server, config) {
+    server.registerTool('get_task', {
+        title: 'Get task status and results',
+        description: [
+            'Check one generation task and, while it is still running, wait up to wait_seconds (max 45) for it to finish. Free.',
+            'Returns the status, progress, result links (they expire after 24 hours, so give them to the user right away), the final charge, or the error with a next step.',
+            'If the task is still running when this returns, call get_task again.',
+            'Never call generate_image, generate_video or generate_audio again to check progress: that creates and charges a new task.',
+        ].join(' '),
+        inputSchema: {
+            task_id: z.string().regex(TASK_ID).describe('task_id returned by generate_image, generate_video or generate_audio'),
+            wait_seconds: z.number().int().min(0).max(MAX_WAIT_SECONDS).default(30)
+                .describe('How long this call may wait for the task to finish (0–45 s, default 30). Use 0 for a quick check.'),
+        },
+        annotations: { title: 'Get task status and results', ...READ_ONLY },
+    }, async ({ task_id, wait_seconds }, extra) => {
+        const started = Date.now();
+        const waitSeconds = Math.min(wait_seconds ?? 30, MAX_WAIT_SECONDS);
+        const report = progressReporter(extra, waitSeconds);
+        let lastReport = -PROGRESS_EVERY_SECONDS;
+        try {
+            const task = await waitForTask(config, task_id, {
+                deadline: started + waitSeconds * 1000 - REPLY_MARGIN_MS,
+                tool: 'get_task',
+                signal: extra.signal,
+                onPoll: async (current) => {
+                    const elapsed = (Date.now() - started) / 1000;
+                    if (elapsed - lastReport < PROGRESS_EVERY_SECONDS)
+                        return;
+                    lastReport = elapsed;
+                    await report(elapsed, `${current.status}, ${current.progress ?? 0}%`);
+                },
+            });
+            const view = describeTask(task);
+            if (!TERMINAL_STATUSES.has(task.status) && waitSeconds > 0) {
+                const waited = Math.round((Date.now() - started) / 1000);
+                view.lines.splice(1, 0, `Still running after waiting ${waited} s.`);
+                view.structured.waited_seconds = waited;
+            }
+            return ok(view.lines.join('\n'), view.structured);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=get-task.js.map

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

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

package/dist/core/src/tools/list-tasks.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../config.js';
+/** ISO 8601, unix seconds, or relative such as 30m, 2h, 1d. */
+export declare function parseSince(value: string, now?: number): number | undefined;
+export declare function registerListTasks(server: McpServer, config: ServerConfig): void;
+//# sourceMappingURL=list-tasks.d.ts.map

package/dist/core/src/tools/list-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/list-tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS,CAY9E;AAuCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmF/E"}

package/dist/core/src/tools/list-tasks.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { listTasks, queryTasks } from '../services/api-client.js';
+import { READ_ONLY, errorResult, failure, money, ok, usdOf } from './shared.js';
+import { TASK_ID } from './get-task.js';
+import { RESULT_LINK_HOURS, resultLinks } from './task-format.js';
+const MAX_IDS = 50;
+/** ISO 8601, unix seconds, or relative such as 30m, 2h, 1d. */
+export function parseSince(value, now = Date.now()) {
+    const trimmed = value.trim();
+    const relative = /^(\d+)\s*(m|min|mins|minutes?|h|hours?|d|days?)$/i.exec(trimmed);
+    if (relative) {
+        const amount = Number(relative[1]);
+        const unit = relative[2][0].toLowerCase();
+        const factor = unit === 'm' ? 60_000 : unit === 'h' ? 3_600_000 : 86_400_000;
+        return now - amount * factor;
+    }
+    if (/^\d{9,11}$/.test(trimmed))
+        return Number(trimmed) * 1000;
+    const parsed = Date.parse(trimmed);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function rowFromTask(task) {
+    const row = { task_id: task.id, status: task.status, model: task.model, type: task.type, progress: task.progress };
+    if (task.created)
+        row.created_at = new Date(task.created * 1000).toISOString();
+    const links = resultLinks(task);
+    if (links.length > 0)
+        row.results = links;
+    const used = task.usage?.credits_used ?? task.usage?.cost?.credits;
+    if (task.status === 'completed' && typeof used === 'number') {
+        row.charged_credits = used;
+        row.charged_usd = task.usage?.cost?.usd ?? usdOf(used);
+    }
+    if (task.error?.code)
+        row.error_code = task.error.code;
+    return row;
+}
+function rowLine(row) {
+    const parts = [`- ${row.task_id}`, row.status === 'completed' || row.status === 'failed' ? row.status : `${row.status} ${row.progress ?? 0}%`, row.model];
+    if (row.created_at)
+        parts.push(row.created_at);
+    if (row.charged_credits !== undefined)
+        parts.push(`charged ${money(row.charged_credits)}`);
+    if (row.error_code)
+        parts.push(`error ${row.error_code}`);
+    const lines = [parts.join(' · ')];
+    for (const link of row.results ?? [])
+        lines.push(`    ${link.kind}: ${link.url}`);
+    return lines.join('\n');
+}
+export function registerListTasks(server, config) {
+    server.registerTool('list_tasks', {
+        title: 'List generation tasks',
+        description: [
+            'Read several tasks at once by task_ids (up to 50, with result links), or find recent tasks by status, type and since. Free.',
+            'Use it to recover tasks after a lost connection or a timed-out submit before submitting anything again.',
+            'Recent tasks cover the whole EvoLink account, newest first.',
+        ].join(' '),
+        inputSchema: {
+            task_ids: z.array(z.string().regex(TASK_ID)).min(1).max(MAX_IDS).optional()
+                .describe('Task IDs to read in one call (max 50).'),
+            status: z.enum(['processing', 'completed', 'failed', 'cancelled']).optional()
+                .describe('Without task_ids: only tasks in this state ("processing" includes queued tasks).'),
+            type: z.enum(['image', 'video', 'audio']).optional()
+                .describe('Without task_ids: only this kind of task.'),
+            since: z.string().max(40).optional()
+                .describe('Without task_ids: only tasks created after this time, as ISO 8601 (2026-10-05T08:00:00Z) or relative (30m, 2h, 1d).'),
+            limit: z.number().int().min(1).max(MAX_IDS).default(20)
+                .describe('Without task_ids: how many recent tasks to return (1–50, default 20).'),
+        },
+        annotations: { title: 'List generation tasks', ...READ_ONLY },
+    }, async ({ task_ids, status, type, since, limit }) => {
+        try {
+            if (task_ids && task_ids.length > 0) {
+                const unique = [...new Set(task_ids)];
+                const tasks = await queryTasks(config, unique);
+                const rows = tasks.map(rowFromTask);
+                const found = new Set(rows.map(row => row.task_id));
+                const missing = unique.filter(id => !found.has(id));
+                const lines = [`${rows.length} of ${unique.length} tasks found.`, ...rows.map(rowLine)];
+                if (missing.length > 0)
+                    lines.push(`Not found (wrong ID, expired, or another account): ${missing.join(', ')}`);
+                if (rows.some(row => row.results))
+                    lines.push(`Result links expire after ${RESULT_LINK_HOURS} hours.`);
+                return ok(lines.join('\n'), { tasks: rows, missing });
+            }
+            let sinceMs;
+            if (since) {
+                sinceMs = parseSince(since);
+                if (sinceMs === undefined) {
+                    return failure(`since "${since}" is not a time. Use ISO 8601 (2026-10-05T08:00:00Z) or a relative value such as 30m, 2h or 1d.`, {
+                        error: { category: 'invalid_request', param: 'since' },
+                    });
+                }
+            }
+            const pageSize = limit ?? 20;
+            const page = await listTasks(config, { status, type, pageSize });
+            let items = page.data;
+            if (sinceMs !== undefined)
+                items = items.filter(item => item.created_at * 1000 >= sinceMs);
+            // The list endpoint omits result links; read finished tasks in one batch to include them.
+            const finished = items.filter(item => item.status === 'completed' && item.has_results).map(item => item.id).slice(0, MAX_IDS);
+            const details = new Map();
+            if (finished.length > 0) {
+                for (const task of await queryTasks(config, finished))
+                    details.set(task.id, task);
+            }
+            const rows = items.map(item => {
+                const detailed = details.get(item.id);
+                if (detailed)
+                    return rowFromTask(detailed);
+                const row = {
+                    task_id: item.id,
+                    status: item.status,
+                    model: item.model,
+                    type: item.type,
+                    progress: item.progress,
+                    created_at: new Date(item.created_at * 1000).toISOString(),
+                };
+                if (typeof item.credits_used === 'number' && item.status === 'completed') {
+                    row.charged_credits = item.credits_used;
+                    row.charged_usd = usdOf(item.credits_used);
+                }
+                if (item.has_error)
+                    row.error_code = 'failed';
+                return row;
+            });
+            const filters = [status && `status ${status}`, type && `type ${type}`, since && `since ${since}`].filter(Boolean).join(', ');
+            const lines = [`${rows.length} recent task${rows.length === 1 ? '' : 's'} on this account${filters ? ` (${filters})` : ''}, newest first:`];
+            lines.push(...(rows.length > 0 ? rows.map(rowLine) : ['(none)']));
+            if (page.total > page.data.length)
+                lines.push(`${page.total} tasks match in total; raise limit or narrow the filters to see others.`);
+            if (rows.some(row => row.results))
+                lines.push(`Result links expire after ${RESULT_LINK_HOURS} hours.`);
+            return ok(lines.join('\n'), { tasks: rows, total: page.total });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-tasks.js.map

package/dist/core/src/tools/list-tasks.js.map

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

package/dist/core/src/tools/search-models.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type CatalogEntry } from '../services/model-catalog.js';
+export declare function modelTitle(entry: CatalogEntry): string | undefined;
+export declare function registerSearchModels(server: McpServer): void;
+//# sourceMappingURL=search-models.d.ts.map

package/dist/core/src/tools/search-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-models.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/search-models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAI9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAGlE;AAqBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyD5D"}

package/dist/core/src/tools/search-models.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { loadCatalog } from '../services/model-catalog.js';
+import { formatPrice, startingPrice } from '../services/pricing-client.js';
+import { READ_ONLY, errorResult, ok } from './shared.js';
+export function modelTitle(entry) {
+    const title = entry.spec?.title?.replace(/\s+(interface|api)$/i, '').trim();
+    return title || entry.priced?.description?.slice(0, 120) || undefined;
+}
+/** Every term must appear somewhere; matches in the model ID count most. */
+function score(entry, terms) {
+    if (terms.length === 0)
+        return 0;
+    const id = entry.id.toLowerCase();
+    const haystack = [id, modelTitle(entry), entry.priced?.description, entry.priced?.vendor, entry.kind]
+        .filter(Boolean)
+        .join(' ')
+        .toLowerCase();
+    let total = 0;
+    for (const term of terms) {
+        if (id === term)
+            total += 10;
+        else if (id.startsWith(term))
+            total += 6;
+        else if (id.includes(term))
+            total += 4;
+        else if (haystack.includes(term))
+            total += 1;
+        else
+            return undefined;
+    }
+    return total;
+}
+export function registerSearchModels(server) {
+    server.registerTool('search_models', {
+        title: 'Search models',
+        description: [
+            'Find EvoLink image, video and audio models by type and keywords. Free.',
+            'Returns model IDs with a starting price; call get_model for a model\'s parameters and full pricing before generating.',
+            'Prices are in USD (68 credits ≈ $1).',
+        ].join(' '),
+        inputSchema: {
+            type: z.enum(['image', 'video', 'audio', 'all']).default('all').describe('Kind of output to look for.'),
+            query: z.string().max(100).optional().describe('Keywords, e.g. "seedance", "image-to-video", "kling", "music".'),
+            limit: z.number().int().min(1).max(50).default(20).describe('Maximum number of models to return (1–50, default 20).'),
+        },
+        annotations: { title: 'Search models', ...READ_ONLY },
+    }, async ({ type, query, limit }) => {
+        try {
+            const catalog = await loadCatalog();
+            const terms = (query ?? '').toLowerCase().split(/[\s,]+/).filter(Boolean);
+            const matches = catalog.entries
+                .filter(entry => type === 'all' || entry.kind === type)
+                .map(entry => ({ entry, score: score(entry, terms), start: entry.priced ? startingPrice(entry.priced) : undefined }))
+                .filter((item) => item.score !== undefined)
+                .sort((a, b) => b.score - a.score || Number(!!b.start) - Number(!!a.start) || a.entry.id.localeCompare(b.entry.id));
+            const shown = matches.slice(0, limit ?? 20);
+            const models = shown.map(({ entry, start }) => ({
+                id: entry.id,
+                type: entry.kind,
+                title: modelTitle(entry),
+                from_usd: start?.min_usd,
+                from_unit: start?.unit,
+                parameters_documented: !!entry.spec,
+                docs: entry.spec?.docs,
+            }));
+            const lines = [
+                `${matches.length} model${matches.length === 1 ? '' : 's'} match${terms.length ? ` "${query}"` : ''}${type !== 'all' ? ` (${type})` : ''}${matches.length > shown.length ? `; showing ${shown.length}` : ''}:`,
+                ...shown.map(({ entry, start }) => {
+                    const parts = [`- ${entry.id} [${entry.kind}]`];
+                    const title = modelTitle(entry);
+                    if (title)
+                        parts.push(title);
+                    parts.push(start ? `from ${formatPrice(start)}` : 'price not published');
+                    if (!entry.spec)
+                        parts.push('parameters not documented');
+                    return parts.join(' · ');
+                }),
+            ];
+            if (matches.length === 0)
+                lines.push('No model matched. Try fewer or broader keywords, or type "all".');
+            else
+                lines.push('', 'Next: get_model with one of these IDs for its parameters and pricing.');
+            if (catalog.pricingWarning)
+                lines.push(`Note: ${catalog.pricingWarning}`);
+            return ok(lines.join('\n'), {
+                models,
+                total_matches: matches.length,
+                ...(catalog.pricingWarning ? { pricing_warning: catalog.pricingWarning } : {}),
+            });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=search-models.js.map

package/dist/core/src/tools/search-models.js.map

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

package/dist/core/src/tools/shared.d.ts

@@ -0,0 +1,50 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CallToolResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import { type CreditsResponse } from '../services/api-client.js';
+export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+/** Free lookups: clients can run them without asking. */
+export declare const READ_ONLY: {
+    readonly readOnlyHint: true;
+    readonly destructiveHint: false;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Spends the user's balance and cannot be undone: clients ask before running it. */
+export declare const PAID: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+};
+/** Changes stored state without spending money (uploads). */
+export declare const WRITES: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+};
+/** Text and structured content carry the same facts: some clients show the model only one of them. */
+export declare function ok(text: string, structured: Record<string, unknown>): CallToolResult;
+export declare function failure(text: string, structured: Record<string, unknown>): CallToolResult;
+export declare function money(credits: number | undefined): string | undefined;
+export interface DailyLimit {
+    used: number;
+    limit: number;
+    left: number;
+    zone?: string;
+}
+/** The calling key's daily limit, when the gateway reports one (none means no daily limit is set). */
+export declare function dailyLimitOf(token: CreditsResponse['token']): DailyLimit | undefined;
+export declare function usdOf(credits: number | undefined): number | undefined;
+export interface ErrorContext {
+    /** The call may have created a paid task. */
+    paid?: boolean;
+    /** Idempotency key the paid call used; repeating it cannot create a second task once the gateway ledger is live. */
+    clientRequestId?: string;
+}
+/** Converts a thrown error into a tool error with a category and a concrete next step. */
+export declare function errorResult(error: unknown, context?: ErrorContext): CallToolResult;
+/** Sends a progress notification when the client asked for them; failures are ignored. */
+export declare function progressReporter(extra: ToolExtra | undefined, totalSeconds: number): (elapsedSeconds: number, message: string) => Promise<void>;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/core/src/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAE5G,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI/E,MAAM,MAAM,SAAS,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAE/E,yDAAyD;AACzD,eAAO,MAAM,SAAS;;;;;CAAsG,CAAC;AAC7H,qFAAqF;AACrF,eAAO,MAAM,IAAI;;;;;CAAuG,CAAC;AACzH,6DAA6D;AAC7D,eAAO,MAAM,MAAM;;;;;CAAwG,CAAC;AAE5H,sGAAsG;AACtG,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAEpF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAEzF;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAExF,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,SAAS,CAOpF;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oHAAoH;IACpH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiCD,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,cAAc,CAyBtF;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAY/I;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrE"}

package/dist/core/src/tools/shared.js

@@ -0,0 +1,129 @@
+import { processCredentialsAllowed } from '../request-context.js';
+import { ApiHttpError } from '../services/api-client.js';
+import { CREDITS_PER_USD, formatCredits, formatUsd } from '../services/error-handler.js';
+import { PaidRequestOutcomeUnknownError, RequestTimeoutError } from '../services/http-policy.js';
+/** Free lookups: clients can run them without asking. */
+export const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+/** Spends the user's balance and cannot be undone: clients ask before running it. */
+export const PAID = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
+/** Changes stored state without spending money (uploads). */
+export const WRITES = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+/** Text and structured content carry the same facts: some clients show the model only one of them. */
+export function ok(text, structured) {
+    return { content: [{ type: 'text', text }], structuredContent: { ok: true, ...structured } };
+}
+export function failure(text, structured) {
+    return { content: [{ type: 'text', text }], structuredContent: { ok: false, ...structured }, isError: true };
+}
+export function money(credits) {
+    if (typeof credits !== 'number' || !Number.isFinite(credits))
+        return undefined;
+    return `${formatCredits(credits)} credits (≈$${formatUsd(credits / CREDITS_PER_USD)})`;
+}
+/** The calling key's daily limit, when the gateway reports one (none means no daily limit is set). */
+export function dailyLimitOf(token) {
+    const limit = token.daily_limit_credits;
+    if (typeof limit !== 'number' || !Number.isFinite(limit) || limit <= 0)
+        return undefined;
+    const raw = token.daily_used_credits;
+    const used = typeof raw === 'number' && Number.isFinite(raw) ? Math.max(0, raw) : 0;
+    const zone = typeof token.reset_timezone === 'string' && token.reset_timezone.trim() ? token.reset_timezone.trim() : undefined;
+    return { used, limit, left: Math.max(0, limit - used), zone };
+}
+export function usdOf(credits) {
+    if (typeof credits !== 'number' || !Number.isFinite(credits))
+        return undefined;
+    return Number((credits / CREDITS_PER_USD).toFixed(6));
+}
+function infoFor(error) {
+    if (error instanceof ApiHttpError && error.info)
+        return error.info;
+    if (error instanceof ApiHttpError) {
+        return { status: error.status, category: 'server_error', message: error.message, next_step: 'Retry in a minute.', retryable: true, request_id: error.requestId };
+    }
+    if (error instanceof PaidRequestOutcomeUnknownError) {
+        return {
+            status: 0,
+            category: 'outcome_unknown',
+            message: 'The submission timed out or the connection dropped, so it is unknown whether a task was created.',
+            next_step: 'Do not submit again with a new client_request_id. Look for the task with list_tasks (status processing), or retry with the same client_request_id.',
+            retryable: true,
+        };
+    }
+    if (error instanceof RequestTimeoutError || error instanceof TypeError) {
+        return { status: 0, category: 'server_error', message: 'EvoLink did not respond in time.', next_step: 'Retry in a minute.', retryable: true };
+    }
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    // Credential problems surface as plain errors from getApiKey(): no key in this scope, or a
+    // signed-in connection that cannot use the hosted service channel.
+    return {
+        status: 0,
+        category: 'unauthorized',
+        message,
+        next_step: processCredentialsAllowed()
+            ? 'Set EVOLINK_API_KEY (create a key at https://evolink.ai/dashboard/keys), or run `evolink login`.'
+            : 'Ask the user to reconnect EvoLink in this client. If it keeps failing, retry in a few minutes.',
+        retryable: false,
+    };
+}
+/** Converts a thrown error into a tool error with a category and a concrete next step. */
+export function errorResult(error, context = {}) {
+    const info = infoFor(error);
+    const label = `${info.category}${info.code ? `, ${info.code}` : ''}${info.status ? `, HTTP ${info.status}` : ''}`;
+    // A headline names the limit in plain words first, so every client shows the user which one stopped the call.
+    const lines = info.headline ? [info.headline] : [`Error (${label}): ${info.message}`];
+    lines.push(`Next step: ${info.next_step}`);
+    let charged;
+    if (context.paid) {
+        if (info.category === 'outcome_unknown' || info.category === 'server_error') {
+            charged = 'unknown';
+            lines.push(context.clientRequestId
+                ? `It is unclear whether a task was created. To retry this exact request safely, pass client_request_id "${context.clientRequestId}".`
+                : 'It is unclear whether a task was created; check list_tasks before submitting again.');
+        }
+        else {
+            charged = 'no';
+            lines.push('Nothing was submitted or charged.');
+        }
+    }
+    if (info.headline)
+        lines.push(`Error: ${label}`);
+    if (info.request_id)
+        lines.push(`Request ID: ${info.request_id}`);
+    return failure(lines.join('\n'), {
+        error: info,
+        ...(charged ? { charged } : {}),
+        ...(context.clientRequestId && charged === 'unknown' ? { client_request_id: context.clientRequestId } : {}),
+    });
+}
+/** Sends a progress notification when the client asked for them; failures are ignored. */
+export function progressReporter(extra, totalSeconds) {
+    const token = extra?._meta?.progressToken;
+    let last = -1;
+    return async (elapsedSeconds, message) => {
+        if (token === undefined || !extra)
+            return;
+        const progress = Math.max(last + 1, Math.round(elapsedSeconds));
+        last = progress;
+        await extra.sendNotification({
+            method: 'notifications/progress',
+            params: { progressToken: token, progress, total: Math.max(totalSeconds, progress), message },
+        }).catch(() => undefined);
+    };
+}
+export function sleep(ms, signal) {
+    return new Promise(resolve => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(done, ms);
+        function done() {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', done);
+            resolve();
+        }
+        signal?.addEventListener('abort', done, { once: true });
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/core/src/tools/shared.js.map

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

package/dist/core/src/tools/task-format.d.ts

@@ -0,0 +1,32 @@
+import type { ServerConfig } from '../config.js';
+import { type TaskResponse } from '../services/api-client.js';
+/** Result links from the gateway stay downloadable for this long. */
+export declare const RESULT_LINK_HOURS = 24;
+export declare const TERMINAL_STATUSES: Set<string>;
+export interface TaskResultLink {
+    url: string;
+    kind: 'image' | 'video' | 'audio' | 'file';
+}
+export declare function resultLinks(task: TaskResponse): TaskResultLink[];
+export interface TaskView {
+    lines: string[];
+    structured: Record<string, unknown>;
+}
+/** One task as text lines and the same facts as structured content. */
+export declare function describeTask(task: TaskResponse): TaskView;
+/** Tests only: shorten the pause between task reads. */
+export declare function setPollIntervalForTests(ms: number | undefined): void;
+/** Pause between task reads: each read of an unfinished task makes the gateway ask the provider. */
+export declare function pollIntervalMs(type: string | undefined): number;
+export interface WaitOptions {
+    /** Absolute time (ms) by which to return, finished or not. */
+    deadline: number;
+    tool: string;
+    signal?: AbortSignal;
+    onPoll?: (task: TaskResponse) => Promise<void>;
+    /** A task already read by the caller; the first read is skipped when given. */
+    initial?: TaskResponse;
+}
+/** Reads a task until it finishes or the deadline passes, pacing reads by task type. */
+export declare function waitForTask(config: ServerConfig, taskId: string, options: WaitOptions): Promise<TaskResponse>;
+//# sourceMappingURL=task-format.d.ts.map

package/dist/core/src/tools/task-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-format.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/task-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9F,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,iBAAiB,aAAgD,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;CAC5C;AAaD,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,EAAE,CAiBhE;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CA+DzD;AAID,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEpE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK/D;AAED,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,+EAA+E;IAC/E,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAWnH"}