@evolinkai/mcp 0.0.0-stage → 1.3.0

package/dist/core/src/data/model-params.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-params.generated.js","sourceRoot":"","sources":["../../../../../core/src/data/model-params.generated.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,CAAC,MAAM,iBAAiB,GAAW,47idAA47id,CAAC"}

package/dist/core/src/data/model-params.js

@@ -0,0 +1,22 @@
+import { MODEL_PARAMS_JSON } from './model-params.generated.js';
+let index;
+function load() {
+    index ??= JSON.parse(MODEL_PARAMS_JSON);
+    return index;
+}
+export function modelParamsMeta() {
+    return load().meta;
+}
+export function allModelParams() {
+    return Object.values(load().models);
+}
+/** Exact model ID first, then a case-insensitive match. */
+export function findModelParams(model) {
+    const models = load().models;
+    const trimmed = model.trim();
+    if (models[trimmed])
+        return models[trimmed];
+    const lower = trimmed.toLowerCase();
+    return Object.values(models).find(entry => entry.model.toLowerCase() === lower);
+}
+//# sourceMappingURL=model-params.js.map

package/dist/core/src/data/model-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-params.js","sourceRoot":"","sources":["../../../../../core/src/data/model-params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAuDhE,IAAI,KAAmC,CAAC;AAExC,SAAS,IAAI;IACX,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAqB,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;AAClF,CAAC"}

package/dist/core/src/request-context.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Per-request EvoLink credentials for the hosted (remote) MCP service.
+ *
+ * The stdio packages never enter a scope, so getApiKey() keeps reading
+ * EVOLINK_API_KEY or the CLI credential helper there. Inside a scope the
+ * request's own credential is the only one used: there is no fallback to
+ * process-wide credentials.
+ */
+export interface RequestCredentials {
+    /** Caller's own API key (hosted api-key mode); absent for signed-in connections. */
+    apiKey?: string;
+    /** Signed-in connections (key custody A): the gateway finds the connection's key itself. */
+    serviceChannel?: ServiceChannelCredentials;
+    /** Agent-readable reason surfaced by tools that need an API key when there is none. */
+    unavailableReason?: string;
+    /** Assistant name sent as X-Evo-Client-Name; the hosted service takes it from the HTTP User-Agent. */
+    clientName?: string;
+    /** Hosted service: told about every tool call of this request, for usage records. */
+    onToolCall?: (call: ToolCallRecord) => void;
+}
+/** One tool call as usage records see it: no arguments except the model name. */
+export interface ToolCallRecord {
+    tool: string;
+    ok: boolean;
+    /** Error category of a failed call (`exception` when the tool threw). */
+    category?: string;
+    model?: string;
+    durationMs: number;
+}
+/**
+ * Key custody A: this service never holds a user's key. A signed-in call
+ * forwards the connection's Passport access token, which this service has
+ * already verified; the gateway verifies it again, takes the session, account
+ * and client from it, checks the session with Passport and bills the account's
+ * EvoLink MCP key.
+ */
+export interface ServiceChannelCredentials {
+    /** The connection's Passport access token (audience: this MCP server, scope mcp). */
+    accessToken: string;
+}
+export declare function runWithRequestCredentials<T>(credentials: RequestCredentials, fn: () => T): T;
+export declare function currentRequestCredentials(): RequestCredentials | undefined;
+/** Hosted mode: never fall back to EVOLINK_API_KEY or the local credential helper. */
+export declare function disableProcessCredentials(): void;
+export declare function processCredentialsAllowed(): boolean;
+/**
+ * How this request is billed: `signed_in` spends the account's internal MCP key
+ * through the service channel (its limit is the user's "EvoLink MCP limit");
+ * `api_key` is the hosted service with the caller's own API key; `local` is a
+ * stdio server with EVOLINK_API_KEY or the CLI login.
+ */
+export type CredentialMode = 'local' | 'api_key' | 'signed_in';
+export declare function currentCredentialMode(): CredentialMode;
+/** stdio: remember the assistant name from the MCP initialize handshake. */
+export declare function setProcessClientName(name: string | undefined): void;
+/** The request's assistant name inside a hosted scope, otherwise the stdio client's. */
+export declare function currentClientName(): string | undefined;
+/** Printable ASCII only, at most 64 characters, so it is safe in a header and a log line. */
+export declare function sanitizeClientName(value: string | undefined): string | undefined;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/core/src/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../core/src/request-context.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7C;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5F;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,SAAS,CAE1E;AAED,sFAAsF;AACtF,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAE/D,wBAAgB,qBAAqB,IAAI,cAAc,CAGtD;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEnE;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAItD;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGhF"}

package/dist/core/src/request-context.js

@@ -0,0 +1,39 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+let processCredentialsDisabled = false;
+let processClientName;
+export function runWithRequestCredentials(credentials, fn) {
+    return storage.run(credentials, fn);
+}
+export function currentRequestCredentials() {
+    return storage.getStore();
+}
+/** Hosted mode: never fall back to EVOLINK_API_KEY or the local credential helper. */
+export function disableProcessCredentials() {
+    processCredentialsDisabled = true;
+}
+export function processCredentialsAllowed() {
+    return !processCredentialsDisabled;
+}
+export function currentCredentialMode() {
+    if (storage.getStore()?.serviceChannel)
+        return 'signed_in';
+    return processCredentialsDisabled ? 'api_key' : 'local';
+}
+/** stdio: remember the assistant name from the MCP initialize handshake. */
+export function setProcessClientName(name) {
+    processClientName = sanitizeClientName(name);
+}
+/** The request's assistant name inside a hosted scope, otherwise the stdio client's. */
+export function currentClientName() {
+    const scoped = storage.getStore();
+    if (scoped)
+        return sanitizeClientName(scoped.clientName);
+    return processClientName;
+}
+/** Printable ASCII only, at most 64 characters, so it is safe in a header and a log line. */
+export function sanitizeClientName(value) {
+    const cleaned = (value ?? '').replace(/[^\x20-\x7e]/g, '').trim().slice(0, 64);
+    return cleaned || undefined;
+}
+//# sourceMappingURL=request-context.js.map

package/dist/core/src/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../../../core/src/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA6CrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAsB,CAAC;AAC5D,IAAI,0BAA0B,GAAG,KAAK,CAAC;AACvC,IAAI,iBAAqC,CAAC;AAE1C,MAAM,UAAU,yBAAyB,CAAI,WAA+B,EAAE,EAAW;IACvF,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,yBAAyB;IACvC,0BAA0B,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,CAAC,0BAA0B,CAAC;AACrC,CAAC;AAUD,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,cAAc;QAAE,OAAO,WAAW,CAAC;IAC3D,OAAO,0BAA0B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,iBAAiB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAClC,IAAI,MAAM;QAAE,OAAO,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/E,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,18 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from './config.js';
+export { type ServerConfig, createConfig, getApiKey } from './config.js';
+export interface ServerOptions {
+    /** Allow upload_file to read local paths (stdio only); the hosted service sets false. */
+    localFileUploads?: boolean;
+    /**
+     * Offer upload_file at all. Signed-in hosted connections set false: files-api
+     * accepts only the user's own API key, which key custody A never hands out.
+     */
+    uploads?: boolean;
+    /** Remember the client's name from initialize for X-Evo-Client-Name (stdio only; hosted requests carry their own). */
+    trackClientName?: boolean;
+}
+/** Sent to the client at initialize; most assistants add it to their instructions. */
+export declare const SERVER_INSTRUCTIONS: string;
+export declare function createServer(config: ServerConfig, options?: ServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../core/src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sHAAsH;IACtH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,QASpB,CAAC;AAEb,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,GAAG,SAAS,CAyBzF"}

package/dist/core/src/server.js

@@ -0,0 +1,84 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { currentRequestCredentials, setProcessClientName } from './request-context.js';
+import { registerCheckBalance } from './tools/check-balance.js';
+import { registerEstimateCost } from './tools/estimate-cost.js';
+import { registerGenerateTools } from './tools/generate.js';
+import { registerGetModel } from './tools/get-model.js';
+import { registerGetTask } from './tools/get-task.js';
+import { registerListTasks } from './tools/list-tasks.js';
+import { registerSearchModels } from './tools/search-models.js';
+import { registerUploadFile } from './tools/upload-file.js';
+import { MCP_VERSION } from './version.js';
+export { createConfig, getApiKey } from './config.js';
+/** Sent to the client at initialize; most assistants add it to their instructions. */
+export const SERVER_INSTRUCTIONS = [
+    'EvoLink creates images, videos, music and speech with 150+ models, billed to the user\'s EvoLink balance (68 credits ≈ $1).',
+    '- Find a model with search_models; read its parameters and prices with get_model.',
+    '- Before a paid generate_image, generate_video or generate_audio call, get the price with estimate_cost and tell the user; go ahead once they agree, or if they already approved this spend.',
+    '- generate_video and generate_audio return a task_id; wait for it with get_task (up to 45 s per call). Never call a generate tool again to check progress: that charges again.',
+    '- Result links expire after 24 hours; give them to the user right away.',
+    '- Reference images, audio and video are passed as public http(s) links. If upload_file is listed, use it for a file on the user\'s computer; if it is not, ask the user for a public link, because this connection cannot read local files or chat attachments.',
+    '- Errors include a next step (for example a top-up link); follow it instead of retrying blindly.',
+    '- When a call is refused for money, tell the user which reason the error names: the EvoLink MCP limit (or daily limit) they set, EvoLink MCP being paused, or the account balance. They need different fixes, so never call an MCP limit a low balance; give the link from the error and do not retry until the user has acted.',
+].join('\n');
+export function createServer(config, options = {}) {
+    const server = new McpServer({
+        name: config.channel === 'beta' ? 'evolink-mcp-beta' : 'evolink-mcp',
+        title: 'EvoLink',
+        version: MCP_VERSION,
+        websiteUrl: 'https://evolink.ai/mcp',
+    }, { instructions: SERVER_INSTRUCTIONS });
+    if (options.trackClientName ?? true) {
+        server.server.oninitialized = () => setProcessClientName(server.server.getClientVersion()?.name);
+    }
+    observeToolCalls(server);
+    registerSearchModels(server);
+    registerGetModel(server);
+    registerEstimateCost(server, config);
+    registerGenerateTools(server, config);
+    registerGetTask(server, config);
+    registerListTasks(server, config);
+    if (options.uploads ?? true)
+        registerUploadFile(server, { localFiles: options.localFileUploads ?? true });
+    registerCheckBalance(server, config);
+    return server;
+}
+/** The model a call asked for, when its arguments name one. */
+function modelOf(args) {
+    const input = args[0];
+    if (!input || typeof input !== 'object')
+        return undefined;
+    const model = input.model;
+    return typeof model === 'string' && model.length > 0 && model.length <= 100 ? model : undefined;
+}
+function callRecord(tool, args, result, durationMs) {
+    const outcome = result;
+    const model = modelOf(args);
+    const record = { tool, ok: outcome?.isError !== true, durationMs };
+    if (!record.ok) {
+        const category = outcome?.structuredContent?.error?.category;
+        record.category = typeof category === 'string' ? category : 'error';
+    }
+    if (model)
+        record.model = model;
+    return record;
+}
+/** Tells the request's observer (hosted service usage records) about every tool call; stdio has none. */
+function observeToolCalls(server) {
+    const register = server.registerTool.bind(server);
+    const observed = (name, config, handler) => register(name, config, async (...args) => {
+        const report = currentRequestCredentials()?.onToolCall;
+        const started = Date.now();
+        try {
+            const result = await handler(...args);
+            report?.(callRecord(name, args, result, Date.now() - started));
+            return result;
+        }
+        catch (error) {
+            report?.({ tool: name, ok: false, category: 'exception', durationMs: Date.now() - started, ...(modelOf(args) ? { model: modelOf(args) } : {}) });
+            throw error;
+        }
+    });
+    server.registerTool = observed;
+}
+//# sourceMappingURL=server.js.map

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

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

package/dist/core/src/services/api-client.d.ts

@@ -0,0 +1,129 @@
+import { type ServerConfig } from '../config.js';
+import { type GatewayErrorInfo } from './error-handler.js';
+export type TaskStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+export interface TaskResponse {
+    created: number;
+    id: string;
+    model: string;
+    object: string;
+    progress: number;
+    status: TaskStatus;
+    type: string;
+    duration?: number;
+    video_duration?: number;
+    results?: string[];
+    result_data?: ResultDataItem[] | Record<string, unknown>;
+    task_info?: {
+        can_cancel?: boolean;
+        estimated_time?: number;
+        video_duration?: number;
+    };
+    usage?: {
+        billing_rule?: string;
+        credits_reserved?: number;
+        credits_used?: number;
+        cost?: {
+            credits?: number;
+            usd?: number;
+            cny?: number;
+        };
+        user_group?: string;
+    };
+    error?: {
+        code?: string;
+        message?: string;
+        type?: string;
+        suggestion?: string;
+    };
+    request_id?: string;
+    /** Set by the MCP client when the gateway answered a repeated Idempotency-Key with the original response. */
+    idempotency_replayed?: boolean;
+}
+export interface ResultDataItem {
+    result_id?: string;
+    duration?: number;
+    tags?: string;
+    title?: string;
+    image_url?: string;
+    audio_url?: string;
+    stream_audio_url?: string;
+    video_url?: string;
+}
+export interface TaskListItem {
+    id: string;
+    model: string;
+    type: string;
+    status: TaskStatus;
+    progress: number;
+    created_at: number;
+    duration?: number;
+    has_results?: boolean;
+    result_count?: number;
+    has_error?: boolean;
+    credits_used?: number;
+}
+export interface TaskListResponse {
+    data: TaskListItem[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface CreditsResponse {
+    user: {
+        remaining_credits: number;
+        used_credits: number;
+    };
+    token: {
+        remaining_credits: number;
+        used_credits: number;
+        unlimited_credits: boolean;
+        /** Daily limit of the calling key, when one is set (newer gateways). */
+        daily_limit_credits?: number;
+        daily_used_credits?: number;
+        reset_timezone?: string;
+    };
+}
+export declare class ApiHttpError extends Error {
+    readonly status: number;
+    readonly retryAfterMs?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly info?: GatewayErrorInfo | undefined;
+    constructor(status: number, message: string, retryAfterMs?: number | undefined, requestId?: string | undefined, info?: GatewayErrorInfo | undefined);
+}
+export declare function withRetry<T>(fn: () => Promise<T>, retries: number, baseDelayMs: number): Promise<T>;
+export interface SubmitOptions {
+    path: string;
+    body: Record<string, unknown>;
+    tool: string;
+    /** Reused on a retry of the same intent; a fresh one is generated when absent. */
+    idempotencyKey?: string;
+}
+/**
+ * Submit one paid intent. At most one transport retry, always with the same
+ * idempotency key, so the gateway ledger (Idempotency-Key) can return the
+ * original task instead of creating a second one.
+ */
+export declare function submitTask(config: ServerConfig, options: SubmitOptions): Promise<TaskResponse>;
+/** @deprecated kept for callers outside the tools; use submitTask. */
+export declare function apiRequest(config: ServerConfig, options: {
+    method: 'GET' | 'POST';
+    path: string;
+    body?: Record<string, unknown>;
+    tool?: string;
+}): Promise<TaskResponse>;
+/** One task (GET /v1/tasks/{id}). Unfinished tasks sync with the provider on every read, so callers pace themselves. */
+export declare function queryTask(config: ServerConfig, taskId: string, tool?: string): Promise<TaskResponse>;
+/** Up to 50 tasks in one call (POST /v1/tasks/batch); unknown or foreign IDs are simply absent. */
+export declare function queryTasks(config: ServerConfig, taskIds: string[], tool?: string): Promise<TaskResponse[]>;
+export interface ListTasksQuery {
+    status?: string;
+    type?: string;
+    model?: string;
+    page?: number;
+    pageSize?: number;
+}
+/** The account's recent tasks, newest first (GET /v1/tasks). Items carry no result links. */
+export declare function listTasks(config: ServerConfig, query: ListTasksQuery, tool?: string): Promise<TaskListResponse>;
+/** Account balance and this key's usage (GET /v1/credits). */
+export declare function getCredits(config: ServerConfig, tool?: string): Promise<CreditsResponse>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/src/services/api-client.d.ts.map

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

package/dist/core/src/services/api-client.js

@@ -0,0 +1,163 @@
+import { gatewayAuthHeaders } from '../config.js';
+import { classifyGatewayError, formatGatewayError } from './error-handler.js';
+import { DEFAULT_READ_TIMEOUT_MS, DEFAULT_SUBMIT_TIMEOUT_MS, MAX_RETRY_DELAY_MS, PaidRequestOutcomeUnknownError, RequestTimeoutError, evoHeaders, fetchWithTimeout, newRunId, parseRetryAfter, readJsonBody, responseRequestId, timeoutFromEnv, } from './http-policy.js';
+// --- Error class for HTTP-level failures ---
+export class ApiHttpError extends Error {
+    status;
+    retryAfterMs;
+    requestId;
+    info;
+    constructor(status, message, retryAfterMs, requestId, info) {
+        super(message);
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+        this.requestId = requestId;
+        this.info = info;
+        this.name = 'ApiHttpError';
+    }
+}
+// --- Retry logic ---
+const RETRYABLE_STATUS_CODES = new Set([429, 502, 503]);
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+    // Key and balance rejections are always HTTP 402, so they are never retried here.
+    if (error instanceof ApiHttpError)
+        return RETRYABLE_STATUS_CODES.has(error.status);
+    if (error instanceof PaidRequestOutcomeUnknownError)
+        return true;
+    if (error instanceof RequestTimeoutError)
+        return true;
+    if (error instanceof TypeError)
+        return true; // network errors (DNS, reset, …)
+    return false;
+}
+export async function withRetry(fn, retries, baseDelayMs) {
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < retries && isRetryable(error)) {
+                const retryAfterMs = error instanceof ApiHttpError ? error.retryAfterMs : undefined;
+                await sleep(Math.min(retryAfterMs ?? baseDelayMs * (attempt + 1), MAX_RETRY_DELAY_MS));
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw lastError;
+}
+// --- Core request (no retry) ---
+async function rawRequest(config, options) {
+    const url = `${config.baseUrl}${options.path}`;
+    const headers = {
+        ...gatewayAuthHeaders(),
+        'Accept': 'application/json',
+        ...evoHeaders(options.tool ?? 'unknown'),
+    };
+    if (options.body)
+        headers['Content-Type'] = 'application/json';
+    if (options.idempotencyKey) {
+        headers['Idempotency-Key'] = options.idempotencyKey;
+        headers['X-Evo-Run-Id'] = options.idempotencyKey;
+    }
+    const isRead = options.method === 'GET' || !options.idempotencyKey;
+    let response;
+    try {
+        response = await fetchWithTimeout(url, {
+            method: options.method,
+            headers,
+            body: options.body ? JSON.stringify(options.body) : undefined,
+        }, options.timeoutMs ?? timeoutFromEnv(isRead ? 'EVOLINK_MCP_READ_TIMEOUT_MS' : 'EVOLINK_MCP_WRITE_TIMEOUT_MS', isRead ? DEFAULT_READ_TIMEOUT_MS : DEFAULT_SUBMIT_TIMEOUT_MS));
+    }
+    catch (error) {
+        if (!isRead)
+            throw new PaidRequestOutcomeUnknownError(error, options.idempotencyKey);
+        throw error;
+    }
+    const data = await readJsonBody(response);
+    const requestId = responseRequestId(response.headers);
+    if (!response.ok) {
+        const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));
+        const info = classifyGatewayError(response.status, data, retryAfterMs, requestId);
+        throw new ApiHttpError(response.status, formatGatewayError(info), retryAfterMs, info.request_id, info);
+    }
+    return { data: data, requestId, headers: response.headers };
+}
+/**
+ * Submit one paid intent. At most one transport retry, always with the same
+ * idempotency key, so the gateway ledger (Idempotency-Key) can return the
+ * original task instead of creating a second one.
+ */
+export async function submitTask(config, options) {
+    const idempotencyKey = options.idempotencyKey ?? newRunId();
+    const { data, requestId, headers } = await withRetry(() => rawRequest(config, {
+        method: 'POST',
+        path: options.path,
+        body: options.body,
+        tool: options.tool,
+        idempotencyKey,
+    }), 1, 500);
+    if (!data.request_id && requestId)
+        data.request_id = requestId;
+    if (headers.get('idempotency-replayed') === 'true')
+        data.idempotency_replayed = true;
+    return data;
+}
+/** @deprecated kept for callers outside the tools; use submitTask. */
+export async function apiRequest(config, options) {
+    if (options.method !== 'POST' || !options.body) {
+        throw new Error('apiRequest only accepts generation POST operations');
+    }
+    return submitTask(config, { path: options.path, body: options.body, tool: options.tool ?? 'unknown' });
+}
+/** One task (GET /v1/tasks/{id}). Unfinished tasks sync with the provider on every read, so callers pace themselves. */
+export async function queryTask(config, taskId, tool = 'get_task') {
+    const { data, requestId } = await withRetry(() => rawRequest(config, { method: 'GET', path: `/v1/tasks/${encodeURIComponent(taskId)}`, tool }), 2, 1500);
+    if (!data.request_id && requestId)
+        data.request_id = requestId;
+    return data;
+}
+/** Up to 50 tasks in one call (POST /v1/tasks/batch); unknown or foreign IDs are simply absent. */
+export async function queryTasks(config, taskIds, tool = 'list_tasks') {
+    const { data } = await withRetry(() => rawRequest(config, {
+        method: 'POST',
+        path: '/v1/tasks/batch',
+        body: { task_ids: taskIds },
+        tool,
+    }), 2, 1500);
+    return Array.isArray(data.data) ? data.data : [];
+}
+/** The account's recent tasks, newest first (GET /v1/tasks). Items carry no result links. */
+export async function listTasks(config, query, tool = 'list_tasks') {
+    const params = new URLSearchParams();
+    if (query.status)
+        params.set('status', query.status);
+    if (query.type)
+        params.set('type', query.type);
+    if (query.model)
+        params.set('model', query.model);
+    params.set('page', String(query.page ?? 1));
+    params.set('page_size', String(query.pageSize ?? 20));
+    const { data } = await withRetry(() => rawRequest(config, { method: 'GET', path: `/v1/tasks?${params}`, tool }), 2, 1500);
+    return {
+        data: Array.isArray(data.data) ? data.data : [],
+        total: typeof data.total === 'number' ? data.total : 0,
+        page: typeof data.page === 'number' ? data.page : query.page ?? 1,
+        page_size: typeof data.page_size === 'number' ? data.page_size : query.pageSize ?? 20,
+    };
+}
+/** Account balance and this key's usage (GET /v1/credits). */
+export async function getCredits(config, tool = 'check_balance') {
+    const { data, requestId } = await withRetry(() => rawRequest(config, { method: 'GET', path: '/v1/credits', tool }), 2, 1000);
+    if (data.success === false || !data.data?.user || !data.data?.token) {
+        const info = classifyGatewayError(500, { error: { message: data.message || 'The balance could not be read.' } }, undefined, requestId);
+        throw new ApiHttpError(500, formatGatewayError(info), undefined, requestId, info);
+    }
+    return data.data;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/core/src/services/api-client.js.map

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

package/dist/core/src/services/error-handler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * What the assistant should do about a rejection. The gateway already tells
+ * the three quota cases apart by error.code (all are HTTP 402 with the same
+ * error.type), so classification goes by code first and status second.
+ *
+ * A signed-in connection spends the account's internal MCP key, so its key
+ * limits are the user's "EvoLink MCP limit" (mcp_*), never an API key's.
+ */
+export type ErrorCategory = 'account_balance_insufficient' | 'mcp_limit_reached' | 'mcp_daily_limit_reached' | 'mcp_paused' | 'mcp_key_expired' | 'key_quota_exhausted' | 'key_daily_quota_exhausted' | 'key_disabled' | 'key_expired' | 'model_not_allowed' | 'unauthorized' | 'forbidden' | 'rate_limited' | 'invalid_request' | 'not_found' | 'content_policy' | 'model_unavailable' | 'idempotency_conflict' | 'outcome_unknown' | 'request_too_large' | 'server_error' | 'connection_ended' | 'session_check_unavailable' | 'connection_setup_failed' | 'service_misconfigured' | 'sign_in_token_rejected' | 'mcp_channel_disabled' | 'account_disabled';
+export interface GatewayErrorInfo {
+    status: number;
+    category: ErrorCategory;
+    /**
+     * First sentence for the user when a limit, the balance or the connection
+     * stopped the request. It names which one, so every client can tell an
+     * EvoLink MCP limit from an empty account.
+     */
+    headline?: string;
+    code?: string;
+    message: string;
+    next_step: string;
+    retryable: boolean;
+    retry_after_seconds?: number;
+    action_url?: string;
+    request_id?: string;
+    /** Key name, balance and limit figures the gateway attaches to quota rejections (credits). */
+    details?: Record<string, unknown>;
+}
+/** Gateway display rate: 1 USD = 6.8 CNY and 1 CNY = 10 credits. */
+export declare const CREDITS_PER_USD = 68;
+export declare function formatCredits(value: number): string;
+export declare function formatUsd(value: number): string;
+/** Classifies one non-2xx gateway or files-api response. */
+export declare function classifyGatewayError(status: number, body: unknown, retryAfterMs?: number, headerRequestId?: string): GatewayErrorInfo;
+/**
+ * With a headline the first line says which limit it is; the gateway's own
+ * sentence is left out because it speaks of "API key …" even for the MCP key.
+ */
+export declare function formatGatewayError(info: GatewayErrorInfo): string;
+export declare function formatApiError(status: number, body: unknown): string;
+export type TaskErrorCode = 'content_policy_violation' | 'invalid_parameters' | 'image_dimension_mismatch' | 'image_processing_error' | 'request_cancelled' | 'resource_not_found' | 'generation_timeout' | 'quota_exceeded' | 'resource_exhausted' | 'generation_failed_no_content' | 'service_error' | 'service_unavailable' | 'unknown_error';
+export interface TaskErrorInfo {
+    suggestion: string;
+    retryable: boolean;
+}
+export declare function getTaskErrorInfo(code: string): TaskErrorInfo;
+export declare function formatTaskError(error: {
+    code?: string;
+    message?: string;
+}): string;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/core/src/services/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../../core/src/services/error-handler.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACrB,8BAA8B,GAC9B,mBAAmB,GACnB,yBAAyB,GACzB,YAAY,GACZ,iBAAiB,GACjB,qBAAqB,GACrB,2BAA2B,GAC3B,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,cAAc,GACd,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,cAAc,GACd,kBAAkB,GAClB,2BAA2B,GAC3B,yBAAyB,GACzB,uBAAuB,GACvB,wBAAwB,GACxB,sBAAsB,GACtB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,KAAK,CAAC;AAqHlC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AA0JD,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,gBAAgB,CAuClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAOjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAEpE;AAID,MAAM,MAAM,aAAa,GACrB,0BAA0B,GAC1B,oBAAoB,GACpB,0BAA0B,GAC1B,wBAAwB,GACxB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,GACpB,8BAA8B,GAC9B,eAAe,GACf,qBAAqB,GACrB,eAAe,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAyDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUlF"}