@evolinkai/mcp 0.0.0-stage → 1.3.0

package/dist/core/src/tools/check-balance.js

@@ -0,0 +1,78 @@
+import { currentCredentialMode } from '../request-context.js';
+import { getCredits } from '../services/api-client.js';
+import { CREDITS_PER_USD } from '../services/error-handler.js';
+import { API_KEYS_URL, MCP_CONSOLE_URL, MCP_KEY_NAME, TOP_UP_URL } from '../services/http-policy.js';
+import { READ_ONLY, dailyLimitOf, errorResult, money, ok, usdOf } from './shared.js';
+/** Below this the user is told the balance, or the limit, is nearly gone (about $1). */
+const LOW_BALANCE_CREDITS = CREDITS_PER_USD;
+export function registerCheckBalance(server, config) {
+    server.registerTool('check_balance', {
+        title: 'Check balance',
+        description: [
+            'Show the EvoLink account balance and what has been spent: by EvoLink MCP in total (all assistants connected by sign-in) or by this API key, with its limit if one is set. Free.',
+            'Also a quick way to confirm the connection works.',
+            'Credits: 68 credits ≈ $1.',
+        ].join(' '),
+        inputSchema: {},
+        annotations: { title: 'Check balance', ...READ_ONLY },
+    }, async () => {
+        try {
+            const credits = await getCredits(config);
+            // A signed-in connection spends the account's MCP key: its spend and limit cover every connected assistant.
+            const signedIn = currentCredentialMode() === 'signed_in';
+            const who = signedIn ? 'EvoLink MCP (all assistants connected to this account)' : 'This API key';
+            const limitName = signedIn ? 'the EvoLink MCP limit' : 'its limit';
+            const balance = Math.max(0, credits.user.remaining_credits);
+            const lines = [`Account balance: ${money(balance)}`];
+            const structured = {
+                account_balance_credits: balance,
+                account_balance_usd: usdOf(balance),
+                spent_scope: signedIn ? 'mcp' : 'api_key',
+                spent_credits: credits.token.used_credits,
+                spent_usd: usdOf(credits.token.used_credits),
+                has_limit: !credits.token.unlimited_credits,
+                top_up_url: TOP_UP_URL,
+                ...(signedIn ? { mcp_settings_url: MCP_CONSOLE_URL } : {}),
+            };
+            if (credits.token.unlimited_credits) {
+                lines.push(signedIn
+                    ? `${who} has spent ${money(credits.token.used_credits)}; no EvoLink MCP limit is set, so only the account balance applies.`
+                    : `${who} has spent ${money(credits.token.used_credits)} and has no spending limit of its own (the account balance applies).`);
+            }
+            else {
+                const left = Math.max(0, credits.token.remaining_credits);
+                lines.push(`${who} has spent ${money(credits.token.used_credits)}; ${money(left)} of ${limitName} is left.`);
+                structured.limit_remaining_credits = left;
+                structured.limit_remaining_usd = usdOf(left);
+                if (left < LOW_BALANCE_CREDITS) {
+                    lines.push(signedIn
+                        ? `The EvoLink MCP limit is nearly used up (it is a limit, not the account balance); the user can raise it at ${MCP_CONSOLE_URL} (the key named "${MCP_KEY_NAME}").`
+                        : `This API key's limit is nearly used up; raise it at ${API_KEYS_URL}.`);
+                }
+            }
+            const daily = dailyLimitOf(credits.token);
+            if (daily) {
+                const resets = `it resets at midnight${daily.zone ? ` (${daily.zone})` : ''}`;
+                lines.push(signedIn
+                    ? `Today EvoLink MCP has spent ${money(daily.used)} of its ${money(daily.limit)} daily limit; ${resets}.`
+                    : `Today this API key has spent ${money(daily.used)} of its ${money(daily.limit)} daily limit; ${resets}.`);
+                if (daily.left < LOW_BALANCE_CREDITS)
+                    lines.push(`Today's limit is nearly used up (${money(daily.left)} left).`);
+                Object.assign(structured, {
+                    daily_limit_credits: daily.limit,
+                    daily_used_credits: daily.used,
+                    daily_left_credits: daily.left,
+                    ...(daily.zone ? { reset_timezone: daily.zone } : {}),
+                });
+            }
+            if (balance < LOW_BALANCE_CREDITS)
+                lines.push('The account balance is low; paid generations may be refused.');
+            lines.push(`Top up: ${TOP_UP_URL}`);
+            return ok(lines.join('\n'), structured);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=check-balance.js.map

package/dist/core/src/tools/check-balance.js.map

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

package/dist/core/src/tools/estimate-cost.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../config.js';
+export declare function registerEstimateCost(server: McpServer, config: ServerConfig): void;
+//# sourceMappingURL=estimate-cost.d.ts.map

package/dist/core/src/tools/estimate-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-cost.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/estimate-cost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AASjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8GlF"}

package/dist/core/src/tools/estimate-cost.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { getCredits } from '../services/api-client.js';
+import { resolveModel, suggestModels } from '../services/model-catalog.js';
+import { formatIssues, validateInput } from '../services/param-validator.js';
+import { estimateCost, formatEstimateRange } from '../services/pricing-client.js';
+import { API_KEYS_URL, MCP_CONSOLE_URL, MCP_KEY_NAME, TOP_UP_URL } from '../services/http-policy.js';
+import { currentCredentialMode } from '../request-context.js';
+import { READ_ONLY, dailyLimitOf, errorResult, failure, money, ok } from './shared.js';
+export function registerEstimateCost(server, config) {
+    server.registerTool('estimate_cost', {
+        title: 'Estimate cost',
+        description: [
+            'Check a generation input and estimate what it will cost, without submitting anything. Free.',
+            'Returns whether the input is valid, the expected price range in USD and credits, what it is based on, and whether the account balance and any spending limit (the EvoLink MCP limit, or this API key\'s) cover it.',
+            'Call it before a paid generate_* call and tell the user the price.',
+        ].join(' '),
+        inputSchema: {
+            model: z.string().min(1).max(128).describe('Model ID, e.g. "seedance-2.0-text-to-video".'),
+            input: z.record(z.unknown()).optional()
+                .describe('The input you plan to pass to the generate tool, e.g. {"prompt":"…","duration":5,"quality":"1080p"}.'),
+        },
+        annotations: { title: 'Estimate cost', ...READ_ONLY },
+    }, async ({ model, input }) => {
+        try {
+            const { catalog, entry } = await resolveModel(model);
+            if (!entry) {
+                const suggestions = suggestModels(catalog, model);
+                return failure(`Unknown model "${model}".${suggestions.length ? ` Did you mean: ${suggestions.join(', ')}?` : ''} Use search_models to find model IDs.`, { error: { category: 'not_found', param: 'model' }, suggestions });
+            }
+            const values = input ?? {};
+            const validation = entry.spec ? validateInput(entry.spec, values) : undefined;
+            const estimate = estimateCost(entry.priced, entry.kind, values, entry.spec);
+            const lines = [`Estimate for ${entry.id} (${entry.kind}); nothing was submitted or charged.`];
+            if (!validation) {
+                lines.push('Input not checked: this model\'s parameters are not documented here.');
+            }
+            else if (validation.errors.length > 0) {
+                lines.push(`Input problems (generate_${entry.kind} would refuse this input):`, ...formatIssues(validation.errors));
+            }
+            else {
+                lines.push('Input looks valid.');
+            }
+            if (validation?.warnings.length)
+                lines.push('Warnings:', ...formatIssues(validation.warnings));
+            const range = formatEstimateRange(estimate);
+            if (estimate.status === 'estimated' && range)
+                lines.push(`Estimated cost: ${range}`);
+            else if (estimate.status === 'token_billed')
+                lines.push('Cost: billed by tokens used; it is only known after the task runs.');
+            else if (estimate.status === 'needs_input')
+                lines.push('Cost: cannot estimate yet; see the note below.');
+            else
+                lines.push('Cost: no published price to estimate from.');
+            if (estimate.basis.length)
+                lines.push('Based on:', ...estimate.basis.map(line => `- ${line}`));
+            if (estimate.possible_extras.length)
+                lines.push('May also charge:', ...estimate.possible_extras.map(line => `- ${line}`));
+            for (const note of estimate.notes)
+                lines.push(`Note: ${note}`);
+            const structured = {
+                model: entry.id,
+                type: entry.kind,
+                input_valid: validation ? validation.errors.length === 0 : null,
+                problems: validation?.errors ?? [],
+                warnings: validation?.warnings ?? [],
+                estimate,
+            };
+            try {
+                const credits = await getCredits(config, 'estimate_cost');
+                const balance = Math.max(0, credits.user.remaining_credits);
+                lines.push(`Account balance: ${money(balance)}`);
+                structured.balance_credits = balance;
+                if (estimate.max_credits !== undefined) {
+                    const enough = balance >= estimate.max_credits;
+                    structured.enough_balance = enough;
+                    if (!enough)
+                        lines.push(`The account balance may not cover this; top up at ${TOP_UP_URL}.`);
+                }
+                // The key's own limit is checked before the balance: warn now instead of failing on submit.
+                if (!credits.token.unlimited_credits) {
+                    const signedIn = currentCredentialMode() === 'signed_in';
+                    const left = Math.max(0, credits.token.remaining_credits);
+                    lines.push(signedIn
+                        ? `EvoLink MCP limit left: ${money(left)} (shared by all connected assistants).`
+                        : `This API key's limit left: ${money(left)}.`);
+                    structured.limit_scope = signedIn ? 'mcp' : 'api_key';
+                    structured.limit_remaining_credits = left;
+                    if (estimate.max_credits !== undefined) {
+                        const enoughLimit = left >= estimate.max_credits;
+                        structured.enough_limit = enoughLimit;
+                        if (!enoughLimit) {
+                            lines.push(signedIn
+                                ? `The EvoLink MCP limit may not cover this. It is a limit the user set, not the account balance; they can raise it at ${MCP_CONSOLE_URL} (the key named "${MCP_KEY_NAME}").`
+                                : `This API key's limit may not cover this; raise it at ${API_KEYS_URL} or use another key.`);
+                        }
+                    }
+                }
+                const daily = dailyLimitOf(credits.token);
+                if (daily && estimate.max_credits !== undefined) {
+                    const signedIn = currentCredentialMode() === 'signed_in';
+                    const enoughToday = daily.left >= estimate.max_credits;
+                    structured.daily_left_credits = daily.left;
+                    structured.enough_daily_limit = enoughToday;
+                    if (!enoughToday) {
+                        const resets = `it resets at midnight${daily.zone ? ` (${daily.zone})` : ''}`;
+                        lines.push(signedIn
+                            ? `Today's EvoLink MCP limit may not cover this (${money(daily.left)} left today; ${resets}). It is a limit the user set, not the account balance.`
+                            : `Today's limit of this API key may not cover this (${money(daily.left)} left today; ${resets}).`);
+                    }
+                }
+            }
+            catch {
+                lines.push('Balance: could not be read right now.');
+            }
+            if (catalog.pricingWarning) {
+                lines.push(`Note: ${catalog.pricingWarning}`);
+                structured.pricing_warning = catalog.pricingWarning;
+            }
+            lines.push('This is an estimate from published prices. The amount actually reserved is shown when the task is submitted, and the final charge when it finishes.');
+            return ok(lines.join('\n'), structured);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=estimate-cost.js.map

package/dist/core/src/tools/estimate-cost.js.map

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

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

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../config.js';
+export declare function registerGenerateTools(server: McpServer, config: ServerConfig): void;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/generate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA+CjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAEnF"}

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

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { submitTask } from '../services/api-client.js';
+import { resolveModel, suggestModels } from '../services/model-catalog.js';
+import { formatIssues, validateInput } from '../services/param-validator.js';
+import { estimateCost, formatEstimateRange } from '../services/pricing-client.js';
+import { CLIENT_REQUEST_ID_PATTERN, newRunId } from '../services/http-policy.js';
+import { formatUsd } from '../services/error-handler.js';
+import { PAID, errorResult, failure, money, ok, progressReporter, usdOf } from './shared.js';
+import { TERMINAL_STATUSES, describeTask, waitForTask } from './task-format.js';
+const PATHS = {
+    image: '/v1/images/generations',
+    video: '/v1/videos/generations',
+    audio: '/v1/audios/generations',
+};
+/** Images usually finish in seconds, so the tool waits for them; video and audio return the task at once. */
+const WAIT_MS = { image: 40_000, video: 0, audio: 0 };
+const DESCRIPTIONS = {
+    image: 'Generate or edit images with an EvoLink image model. PAID: charges the user\'s EvoLink balance.',
+    video: 'Generate a video with an EvoLink video model (text-to-video, image-to-video, reference, edit, extend). PAID: charges the user\'s EvoLink balance.',
+    audio: 'Generate music, songs or speech with an EvoLink audio model. PAID: charges the user\'s EvoLink balance.',
+};
+const AFTER = {
+    image: 'Waits up to 40 s and returns the image links when ready; otherwise returns the task_id for get_task.',
+    video: 'Returns a task_id at once (videos take minutes); then call get_task, which can wait up to 45 s per call.',
+    audio: 'Returns a task_id at once; then call get_task, which can wait up to 45 s per call.',
+};
+function description(kind) {
+    return [
+        DESCRIPTIONS[kind],
+        'Before calling, get the price with estimate_cost (or get_model) and tell the user, unless they already approved this spend.',
+        'Find models with search_models and their parameters with get_model; pass the parameters in input.',
+        AFTER[kind],
+        'Never call this again to check progress or to "retry" a running task: each call creates and charges a new task.',
+        'After a network error or timeout, reuse the same client_request_id to retry without being charged twice.',
+    ].join(' ');
+}
+function rangeText(estimate) {
+    return formatEstimateRange(estimate) ?? 'unknown';
+}
+export function registerGenerateTools(server, config) {
+    for (const kind of ['image', 'video', 'audio'])
+        registerGenerate(server, config, kind);
+}
+function registerGenerate(server, config, kind) {
+    const name = `generate_${kind}`;
+    const title = `Generate ${kind} (paid)`;
+    server.registerTool(name, {
+        title,
+        description: description(kind),
+        inputSchema: {
+            model: z.string().min(1).max(128).describe(`${kind[0].toUpperCase()}${kind.slice(1)} model ID from search_models.`),
+            prompt: z.string().max(20_000).optional().describe('Shortcut for input.prompt.'),
+            input: z.record(z.unknown()).optional()
+                .describe('Model parameters exactly as listed by get_model, e.g. {"prompt":"…","quality":"1080p"}. Do not put model or callback_url here.'),
+            client_request_id: z.string().regex(CLIENT_REQUEST_ID_PATTERN).optional()
+                .describe('Optional idempotency key (16–96 characters: letters, digits, . _ -). Reuse the same value only to retry the same request after a network error or timeout.'),
+            max_cost_usd: z.number().positive().max(10_000).optional()
+                .describe('Optional spending cap: if the estimated cost is higher, nothing is submitted.'),
+        },
+        annotations: { title, ...PAID },
+    }, async (args, extra) => {
+        const started = Date.now();
+        const input = { ...(args.input ?? {}) };
+        if (args.prompt !== undefined) {
+            if (input.prompt !== undefined && input.prompt !== args.prompt) {
+                return failure('prompt was given twice with different values (prompt and input.prompt). Pass it once. Nothing was submitted or charged.', {
+                    error: { category: 'invalid_request', param: 'prompt' },
+                    charged: 'no',
+                });
+            }
+            input.prompt = args.prompt;
+        }
+        let clientRequestId;
+        try {
+            const { catalog, entry } = await resolveModel(args.model);
+            if (!entry) {
+                const suggestions = suggestModels(catalog, args.model, kind);
+                return failure(`Unknown ${kind} model "${args.model}".${suggestions.length ? ` Did you mean: ${suggestions.join(', ')}?` : ''} Use search_models to find model IDs. Nothing was submitted or charged.`, { error: { category: 'not_found', param: 'model' }, suggestions, charged: 'no' });
+            }
+            if (entry.kind !== kind) {
+                return failure(`${entry.id} is a ${entry.kind} model; use generate_${entry.kind}. Nothing was submitted or charged.`, {
+                    error: { category: 'invalid_request', param: 'model' },
+                    use_tool: `generate_${entry.kind}`,
+                    charged: 'no',
+                });
+            }
+            const warnings = [];
+            if (entry.spec) {
+                const validation = validateInput(entry.spec, input);
+                if (validation.errors.length > 0) {
+                    return failure([
+                        `The input for ${entry.id} has problems; nothing was submitted or charged:`,
+                        ...formatIssues(validation.errors),
+                        'get_model lists every parameter with its allowed values.',
+                    ].join('\n'), { error: { category: 'invalid_request' }, problems: validation.errors, charged: 'no' });
+                }
+                warnings.push(...validation.warnings.map(issue => `${issue.param} ${issue.problem}`));
+            }
+            else {
+                warnings.push('This model\'s parameters are not documented here, so the input was not checked before sending.');
+            }
+            const estimate = estimateCost(entry.priced, kind, input, entry.spec);
+            if (args.max_cost_usd !== undefined) {
+                if (estimate.status !== 'estimated' || estimate.max_usd === undefined) {
+                    const reason = estimate.status === 'token_billed'
+                        ? 'it is billed by tokens used, so its cost is only known afterwards'
+                        : estimate.notes[0] ?? catalog.pricingWarning ?? 'no price could be found for it';
+                    return failure(`max_cost_usd cannot be checked for ${entry.id}: ${reason}. Nothing was submitted or charged. Ask the user whether to proceed without a cap.`, {
+                        error: { category: 'invalid_request', param: 'max_cost_usd' },
+                        estimate,
+                        charged: 'no',
+                    });
+                }
+                if (estimate.max_usd > args.max_cost_usd) {
+                    return failure(`The estimated cost ${rangeText(estimate)} is above max_cost_usd $${formatUsd(args.max_cost_usd)}. Nothing was submitted or charged. Lower the duration, count or quality, or ask the user to raise the cap.`, {
+                        error: { category: 'invalid_request', param: 'max_cost_usd' },
+                        estimate,
+                        charged: 'no',
+                    });
+                }
+            }
+            clientRequestId = args.client_request_id ?? newRunId();
+            const body = { ...input, model: entry.id };
+            const submitted = await submitTask(config, {
+                path: entry.spec?.path ?? PATHS[kind],
+                body,
+                tool: name,
+                idempotencyKey: clientRequestId,
+            });
+            let task = submitted;
+            const waitUntil = started + WAIT_MS[kind];
+            if (!TERMINAL_STATUSES.has(task.status) && WAIT_MS[kind] > 0 && Date.now() + 3_000 < waitUntil) {
+                const report = progressReporter(extra, WAIT_MS[kind] / 1000);
+                try {
+                    task = await waitForTask(config, submitted.id, {
+                        deadline: waitUntil,
+                        tool: name,
+                        signal: extra.signal,
+                        onPoll: current => report((Date.now() - started) / 1000, `${current.status}, ${current.progress ?? 0}%`),
+                    });
+                }
+                catch {
+                    // The task exists; a failed status read must not turn a successful submit into an error.
+                    task = submitted;
+                }
+                task.usage = { ...submitted.usage, ...task.usage };
+            }
+            const view = describeTask({ ...task, request_id: task.request_id ?? submitted.request_id });
+            const header = submitted.idempotency_replayed
+                ? `This client_request_id was used before: returning the original task (no new charge).`
+                : `Submitted ${entry.id}.`;
+            const lines = [header, ...view.lines];
+            const reserved = submitted.usage?.credits_reserved;
+            if (typeof reserved === 'number' && reserved > 0 && !lines.some(line => line.startsWith('Reserved:')) && task.status !== 'completed') {
+                lines.push(`Reserved: ${money(reserved)}`);
+            }
+            if (estimate.status === 'estimated')
+                lines.push(`Estimate before submitting: ${rangeText(estimate)}`);
+            for (const warning of warnings)
+                lines.push(`Warning: ${warning}`);
+            lines.push(`client_request_id: ${clientRequestId}`);
+            return ok(lines.join('\n'), {
+                ...view.structured,
+                submitted: { model: entry.id, input },
+                client_request_id: clientRequestId,
+                replayed: submitted.idempotency_replayed === true,
+                ...(typeof reserved === 'number' ? { reserved_credits: reserved, reserved_usd: usdOf(reserved) } : {}),
+                ...(estimate.status === 'estimated' ? { estimate: { min_usd: estimate.min_usd, max_usd: estimate.max_usd } } : {}),
+                ...(warnings.length ? { warnings } : {}),
+            });
+        }
+        catch (error) {
+            // clientRequestId is set right before the submit, so it also tells whether a request may have gone out.
+            return errorResult(error, { paid: clientRequestId !== undefined, clientRequestId });
+        }
+    });
+}
+//# sourceMappingURL=generate.js.map

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

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

package/dist/core/src/tools/get-model.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ParamSpec } from '../data/model-params.js';
+export declare function describeParam(name: string, spec: ParamSpec, indent?: string): string[];
+export declare function registerGetModel(server: McpServer): void;
+//# sourceMappingURL=get-model.d.ts.map

package/dist/core/src/tools/get-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/get-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAW1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAelF;AAQD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmExD"}

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

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { modelParamsMeta } from '../data/model-params.js';
+import { resolveModel, suggestModels } from '../services/model-catalog.js';
+import { formatPrice } from '../services/pricing-client.js';
+import { formatUsd } from '../services/error-handler.js';
+import { READ_ONLY, errorResult, failure, ok } from './shared.js';
+import { modelTitle } from './search-models.js';
+function value(v) {
+    return JSON.stringify(v);
+}
+export function describeParam(name, spec, indent = '') {
+    const facts = [spec.type, spec.required ? 'required' : undefined].filter(Boolean);
+    const details = [];
+    if (spec.enum?.length)
+        details.push(`one of ${spec.enum.map(value).join(', ')}`);
+    if (spec.default !== undefined)
+        details.push(`default ${value(spec.default)}`);
+    if (spec.minimum !== undefined || spec.maximum !== undefined)
+        details.push(`range ${spec.minimum ?? '…'}–${spec.maximum ?? '…'}`);
+    if (spec.minItems !== undefined || spec.maxItems !== undefined)
+        details.push(`${spec.minItems ?? 0}–${spec.maxItems ?? '…'} items`);
+    if (spec.maxLength !== undefined)
+        details.push(`up to ${spec.maxLength} characters`);
+    if (spec.items?.enum?.length)
+        details.push(`each one of ${spec.items.enum.map(value).join(', ')}`);
+    const head = `${indent}- ${name}${facts.length ? ` (${facts.join(', ')})` : ''}${details.length ? `: ${details.join('; ')}` : ''}`;
+    const lines = [spec.description ? `${head} — ${spec.description}` : head];
+    for (const [child, childSpec] of Object.entries(spec.properties ?? spec.items?.properties ?? {})) {
+        lines.push(...describeParam(child, childSpec, `${indent}  `));
+    }
+    return lines;
+}
+function priceLine(price) {
+    const minimum = price.min_charge_usd !== undefined ? ` (minimum $${formatUsd(price.min_charge_usd)} per task)` : '';
+    const factors = price.multipliers ? ` (resolution factors ${Object.entries(price.multipliers).map(([k, v]) => `${k} ×${v}`).join(', ')})` : '';
+    return `${price.name}: ${formatPrice(price)}${minimum}${factors}`;
+}
+export function registerGetModel(server) {
+    server.registerTool('get_model', {
+        title: 'Get model parameters and pricing',
+        description: [
+            'Show what one model accepts and what it costs: every input parameter (required, allowed values, ranges, defaults), the published prices and an example input. Free.',
+            'Read this before calling generate_image, generate_video or generate_audio, and quote the price to the user.',
+        ].join(' '),
+        inputSchema: {
+            model: z.string().min(1).max(128).describe('Model ID from search_models, e.g. "seedance-2.0-text-to-video".'),
+        },
+        annotations: { title: 'Get model parameters and pricing', ...READ_ONLY },
+    }, async ({ model }) => {
+        try {
+            const { catalog, entry } = await resolveModel(model);
+            if (!entry) {
+                const suggestions = suggestModels(catalog, model);
+                return failure(`Unknown model "${model}".${suggestions.length ? ` Did you mean: ${suggestions.join(', ')}?` : ''} Use search_models to find model IDs.`, { error: { category: 'not_found', param: 'model' }, suggestions });
+            }
+            const { spec, priced } = entry;
+            const title = modelTitle(entry);
+            const lines = [`${entry.id} (${entry.kind})${title ? ` — ${title}` : ''}`, `Generate with: generate_${entry.kind}`];
+            const structured = {
+                model: entry.id,
+                type: entry.kind,
+                tool: `generate_${entry.kind}`,
+            };
+            if (spec) {
+                lines.push(`Docs: ${spec.docs}`, '', 'Input parameters (pass them in input):');
+                const names = Object.keys(spec.params).sort((a, b) => Number(!!spec.params[b].required) - Number(!!spec.params[a].required));
+                for (const name of names)
+                    lines.push(...describeParam(name, spec.params[name]));
+                if (spec.example)
+                    lines.push('', `Example input: ${JSON.stringify(spec.example)}`);
+                Object.assign(structured, {
+                    endpoint: spec.path,
+                    docs: spec.docs,
+                    required: spec.required,
+                    parameters: spec.params,
+                    example_input: spec.example,
+                    parameters_source: modelParamsMeta(),
+                });
+            }
+            else {
+                lines.push('', 'Parameters for this model are not documented here; the gateway checks the input when you submit.');
+            }
+            lines.push('', 'Pricing (USD; 68 credits ≈ $1):');
+            if (priced && priced.prices.length > 0) {
+                const groups = [['output', 'Main charge'], ['add_on', 'Extra charges'], ['token', 'Usage-based']];
+                for (const [role, label] of groups) {
+                    const prices = priced.prices.filter(price => price.role === role);
+                    if (prices.length === 0)
+                        continue;
+                    lines.push(`${label}:`);
+                    for (const price of prices)
+                        lines.push(`- ${priceLine(price)}`);
+                }
+                lines.push('Use estimate_cost with your input for a total before generating.');
+                structured.prices = priced.prices;
+            }
+            else {
+                lines.push(catalog.pricingWarning ?? 'No price is published for this model.');
+            }
+            if (catalog.pricingWarning)
+                structured.pricing_warning = catalog.pricingWarning;
+            return ok(lines.join('\n'), structured);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=get-model.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../config.js';
+export declare const TASK_ID: RegExp;
+/** Codex and Cursor drop a tool call after about 60 s; the reply also needs time to travel. */
+export declare const MAX_WAIT_SECONDS = 45;
+export declare function registerGetTask(server: McpServer, config: ServerConfig): void;
+//# sourceMappingURL=get-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-task.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/get-task.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,eAAO,MAAM,OAAO,QAA6B,CAAC;AAClD,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAInC,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2C7E"}