@athanlab/mcp 0.0.0-stage → 0.1.0

package/dist/api/errors.js

@@ -0,0 +1,284 @@
+export class AthanLabError extends Error {
+    code;
+    source;
+    status;
+    type;
+    retryable;
+    retryAfterSeconds;
+    requestId;
+    docUrl;
+    param;
+    details;
+    upgradeUrl;
+    outcomeUnknown;
+    jobId;
+    /** Set by a tool that knows better than the code alone what the agent should do. */
+    actionOverride = null;
+    constructor(init) {
+        super(init.message);
+        this.name = 'AthanLabError';
+        this.code = init.code;
+        this.source = init.source;
+        this.status = init.status ?? null;
+        this.type = init.type ?? null;
+        this.retryable = init.retryable ?? false;
+        this.retryAfterSeconds = init.retryAfterSeconds ?? null;
+        this.requestId = init.requestId ?? null;
+        this.docUrl = init.docUrl ?? null;
+        this.param = init.param ?? null;
+        this.details = init.details ?? null;
+        this.upgradeUrl = init.upgradeUrl ?? null;
+        this.jobId = init.jobId ?? null;
+        this.outcomeUnknown = init.outcomeUnknown ?? false;
+    }
+    static fromEnvelope(body, status, retryAfterSeconds, headerRequestId) {
+        return new AthanLabError({
+            code: body.code,
+            message: body.message,
+            source: 'api',
+            status,
+            type: body.type,
+            retryable: body.retryable === true,
+            retryAfterSeconds,
+            requestId: body.request_id ?? headerRequestId,
+            docUrl: body.doc_url ?? null,
+            param: body.param ?? null,
+            details: isRecord(body.details) ? body.details : null,
+            upgradeUrl: typeof body.upgrade_url === 'string' ? body.upgrade_url : null,
+        });
+    }
+    static client(code, message, extra = {}) {
+        return new AthanLabError({ ...extra, code, message, source: 'client', retryable: false });
+    }
+    /** What the agent should do about it — always a sentence, never empty. */
+    get action() {
+        return this.actionOverride ?? actionFor(this);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            source: this.source,
+            http_status: this.status,
+            retryable: this.retryable,
+            retry_after_seconds: this.retryAfterSeconds,
+            request_id: this.requestId,
+            param: this.param,
+            job_id: this.jobId,
+            action: this.action,
+            doc_url: this.docUrl,
+            upgrade_url: this.upgradeUrl,
+            details: this.details,
+        };
+    }
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Errors that mean "stop creating jobs": nothing about the next line or the
+ * next text will make them succeed. A script run stops starting new lines on
+ * these and reports what finished.
+ */
+export const ACCOUNT_STOP_CODES = new Set([
+    'plan_required',
+    'insufficient_characters',
+    'key_budget_exceeded',
+    'missing_api_key',
+    'invalid_api_key',
+    'invalid_api_key_format',
+    'scope_missing',
+    'developer_pending',
+    'developer_rejected',
+    'developer_suspended',
+    'developer_not_approved',
+    'account_suspended',
+    'auth_blocked',
+    'api_disabled',
+    'api_read_only',
+    'endpoint_removed',
+]);
+/** Errors that belong to ONE text: fix that line, the others can go on. */
+export const LINE_ERROR_CODES = new Set([
+    'validation_error',
+    'unspeakable_text',
+    'text_too_long',
+    'voice_not_found',
+    'payload_too_large',
+    'input_rejected',
+    'max_chars_exceeded',
+]);
+const DASHBOARD = 'the Developer API page of your AthanLab dashboard (https://athanlab.com/dashboard/api)';
+/** Codes whose action already says what to do about the job they name. */
+const JOB_AWARE_CODES = new Set([
+    'timeout',
+    'gateway_unavailable',
+    'network_error',
+    'job_not_finished',
+    'job_failed',
+    'audio_expired',
+    'not_found',
+    'cancelled',
+    'idempotency_conflict',
+]);
+/** Codes whose generic action is "try again" — which, next to a paid job, reads as "speak again". */
+const TRY_AGAIN_CODES = new Set(['internal_error', 'internal_client_error', 'invalid_response', 'download_failed']);
+function actionFor(e) {
+    const base = baseActionFor(e);
+    if (e.jobId && e.source !== 'job' && !JOB_AWARE_CODES.has(e.code)) {
+        // The job succeeded and was charged; only saving its audio failed (athanlab_speak's
+        // download, athanlab_download_audio). The retry is the free download — never a new job.
+        const save = `The job (job_id ${e.jobId}) exists and was paid for; only saving its audio failed. Save it with athanlab_download_audio (job_id ${e.jobId}) — downloads are free. Do NOT call athanlab_speak again: that would create and charge a second job.`;
+        if (e.retryable || TRY_AGAIN_CODES.has(e.code)) {
+            return e.retryAfterSeconds !== null ? `Wait ${e.retryAfterSeconds} seconds. ${save}` : save;
+        }
+        return `${base} ${save}`;
+    }
+    const key = e.details?.idempotency_key;
+    if (typeof key === 'string' && e.retryable) {
+        return `${base} To retry this create safely, call the same tool with idempotency_key "${key}": if the job was already created the API returns it instead of charging again.`;
+    }
+    return base;
+}
+function baseActionFor(e) {
+    const wait = e.retryAfterSeconds !== null ? `${e.retryAfterSeconds} seconds` : 'a short while';
+    const detail = (key) => e.details?.[key];
+    switch (e.code) {
+        case 'plan_required':
+            return `Creating speech jobs needs an active Max plan (or founder access). Until then this key is read-only: athanlab_get_job, athanlab_list_jobs, athanlab_download_audio, athanlab_cancel_job and athanlab_usage keep working. Subscribe at ${e.upgradeUrl ?? 'https://athanlab.com/dashboard/profile#plans'}. Not retried.`;
+        case 'insufficient_characters': {
+            const need = detail('required');
+            const have = detail('spendable');
+            const numbers = typeof need === 'number' && typeof have === 'number' ? ` This needs ${need} characters; the account can spend ${have}.` : '';
+            return `Nothing was charged.${numbers} Top up Athan Tokens or wait for the monthly allowance to reset (athanlab_usage shows monthly.resets_at), or send a shorter text. Not retried.`;
+        }
+        case 'key_budget_exceeded': {
+            const resets = detail('resets_at');
+            return `This API key reached its monthly character budget; nothing was charged. Raise the key's monthly budget on ${DASHBOARD}${typeof resets === 'string' ? `, or wait until it resets at ${resets}` : ''}. Not retried.`;
+        }
+        case 'concurrency_limit':
+            return 'The account already has its maximum number of jobs running. This server waits and retries automatically; if it keeps happening, wait for running jobs to finish (athanlab_list_jobs with status "processing").';
+        case 'missing_api_key':
+        case 'invalid_api_key':
+            return 'Check ATHANLAB_API_KEY in this MCP server\'s configuration: it must be a live, unrevoked key (ak_live_ + 32 hex characters) from ' + DASHBOARD + '. Never retried — 20 failed key checks in 5 minutes block your whole network for 10 minutes.';
+        case 'invalid_api_key_format':
+            return 'Fix ATHANLAB_API_KEY in this MCP server\'s configuration (ak_live_ + exactly 32 lowercase hex characters) and restart the server. Nothing was sent to the API.';
+        case 'scope_missing': {
+            const scope = detail('required_scope');
+            return `This API key lacks the scope this tool needs${typeof scope === 'string' ? ` (${scope})` : ''}. Create a key with that scope on ${DASHBOARD} and update ATHANLAB_API_KEY.`;
+        }
+        case 'auth_blocked':
+            return `Too many failed key checks from this network: requests are blocked for ${wait}. Fix ATHANLAB_API_KEY first, then try again after the block.`;
+        case 'rate_limited':
+            return `Rate limit reached. Wait ${wait} and try again.`;
+        case 'developer_pending':
+            return 'The developer application is still under review; keys start working once it is approved.';
+        case 'developer_rejected':
+        case 'developer_not_approved':
+            return `This account has no approved developer application. See ${DASHBOARD}.`;
+        case 'developer_suspended':
+        case 'account_suspended':
+            return 'API access for this account is suspended. Contact support@athanlab.com (quote the request_id).';
+        case 'api_disabled':
+        case 'api_read_only':
+            return `The AthanLab API is not accepting new jobs right now (maintenance). Existing jobs, downloads and usage stay readable. Try again in ${wait}.`;
+        case 'capacity_unavailable':
+        case 'server_restarting':
+        case 'server_busy':
+        case 'service_unavailable':
+            return `Temporary capacity or restart; nothing was charged. Try again in ${wait}.`;
+        case 'gateway_unavailable':
+        case 'network_error':
+            return e.jobId
+                ? `The connection failed; the job may still be running. Check it with athanlab_get_job (job_id ${e.jobId}) instead of creating a new one.`
+                : 'The connection to the API failed. Try again shortly; a create is retried with the same Idempotency-Key, so it is never charged twice.';
+        case 'internal_error':
+            return 'Something failed on AthanLab\'s side. Try again; if it keeps failing, contact support@athanlab.com with the request_id.';
+        case 'validation_error':
+            return `Fix the request${e.param ? ` (parameter: ${e.param})` : ''} and try again.`;
+        case 'unspeakable_text':
+            return 'The text has nothing to read aloud (only emoji, punctuation or whitespace). Send Burmese words. Nothing was charged.';
+        case 'text_too_long':
+            return 'Shorten the text, add sentence punctuation (။ ! ?) so it can be split, or choose a number_mode that writes numbers out more briefly. Nothing was charged. See the athanlab-writing-guide.';
+        case 'voice_not_found':
+            return 'Call athanlab_list_voices and pass one of the ids it returns as voice_id.';
+        case 'idempotency_conflict': {
+            const job = detail('job_id');
+            return `This Idempotency-Key was first used for a different request${typeof job === 'string' ? ` (job_id ${job})` : ''}; nothing new was created or charged. A key only ever replays the identical request.${typeof job === 'string' ? ` If that job is the one you meant, check it with athanlab_get_job.` : ''}`;
+        }
+        case 'not_found':
+            return 'No such job (or voice) for this account. Check the id; athanlab_list_jobs lists your jobs.';
+        case 'job_not_finished':
+            return `The job is still processing. Check it with athanlab_get_job${e.jobId ? ` (job_id ${e.jobId})` : ''} and download once it has succeeded.`;
+        case 'job_failed':
+            return 'The job failed or was cancelled, so it has no audio. athanlab_get_job shows why; create a new job to try again.';
+        case 'job_finished':
+            return 'The job already finished; there is nothing to cancel. Download it with athanlab_download_audio if it succeeded.';
+        case 'audio_expired':
+            return 'Audio is deleted 30 days after a job is created. Create a new job to get it again.';
+        case 'payload_too_large':
+            return 'The request is too large. Send a shorter text (at most 5,000 characters per job).';
+        case 'max_chars_exceeded':
+            return 'This call exceeds ATHANLAB_MAX_CHARS_PER_CALL, the safety cap configured for this MCP server. Split the text into smaller calls, or raise the cap in the server configuration.';
+        case 'confirmation_required':
+            return 'Show the quote to the user, then call again with confirm: true to create the jobs.';
+        case 'timeout':
+            return e.jobId
+                ? `The job is still running. Do NOT start it again (that would pay twice): check it later with athanlab_get_job (job_id ${e.jobId}) and fetch the file with athanlab_download_audio.`
+                : 'The request timed out. Try again.';
+        case 'input_rejected':
+            return 'The text could not be turned into speech; the characters were refunded. Change the text (see the athanlab-writing-guide) before trying again.';
+        case 'generation_failed':
+        case 'interrupted':
+            return 'The job failed on AthanLab\'s side and was refunded in full. Submitting it again may succeed.';
+        case 'cancelled':
+            return 'The job was cancelled; the unprocessed share was refunded. Create a new job if you still need the audio.';
+        case 'invalid_job_id':
+            return 'A job id is 32 lowercase hex characters, as returned by athanlab_speak or athanlab_list_jobs.';
+        case 'invalid_input':
+            return 'Fix the input described in the message and try again.';
+        case 'unsupported_media_type':
+            return 'This server sent a request the API could not read. Please report it (with the request_id).';
+        case 'batch_unresolved':
+            return 'Nothing new was created. An earlier batch of this script (whose creation was never confirmed) may still be admitting lines. Run the call again with the lines exactly as they were to re-attach to it, or wait until it has finished (batches admit lines for up to 24 hours) before changing them; contact support@athanlab.com with the request_id if it persists.';
+        case 'script_running':
+            return `Do not run the same script twice at once (it would pay for its lines twice). Wait for the other athanlab_speak_script call to return. If it was abandoned, call again with the same arguments in ${wait}: once the other run has ended this call picks up where it stopped — finished lines are skipped and running jobs are followed, never paid twice.`;
+        case 'wav_mismatch':
+            return 'The line files have different audio formats, so they cannot be joined into one WAV. The per-line files and manifest.json are complete; mix them in an editor instead.';
+        case 'file_error':
+            return 'Check that ATHANLAB_OUTPUT_DIR is writable and has free space.';
+        default:
+            if (e.retryable)
+                return `Temporary problem. Try again in ${wait}.`;
+            return 'This request cannot succeed as sent. Read the message, change the request, then try again.';
+    }
+}
+/** Human-readable block for a tool's text content. */
+export function formatError(e) {
+    const lines = [
+        `AthanLab error: ${e.code}${e.status ? ` (HTTP ${e.status})` : ''}`,
+        e.message,
+        `Retryable: ${e.retryable ? 'yes' : 'no'}${e.retryAfterSeconds !== null ? ` (Retry-After: ${e.retryAfterSeconds} s)` : ''}`,
+    ];
+    if (e.jobId)
+        lines.push(`Job ID: ${e.jobId}`);
+    if (e.param)
+        lines.push(`Parameter: ${e.param}`);
+    if (e.requestId)
+        lines.push(`Request ID: ${e.requestId}`);
+    lines.push(`Action: ${e.action}`);
+    if (e.docUrl)
+        lines.push(`Docs: ${e.docUrl}`);
+    return lines.join('\n');
+}
+/** Anything thrown → AthanLabError, without leaking stack traces into tool output. */
+export function toAthanLabError(err) {
+    if (err instanceof AthanLabError)
+        return err;
+    if (err instanceof Error && (err.name === 'AbortError' || err.name === 'TimeoutError')) {
+        return new AthanLabError({ code: 'timeout', message: 'The operation was cancelled or timed out.', source: 'client', retryable: true });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return new AthanLabError({ code: 'internal_client_error', message: `Unexpected error in the AthanLab MCP server: ${message}`, source: 'client' });
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

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

package/dist/api/features.js

@@ -0,0 +1,123 @@
+import { isRecord } from './errors.js';
+import { USER_AGENT } from '../version.js';
+export const NO_FEATURES = Object.freeze({
+    speed: null,
+    replacements: null,
+    batch: false,
+    timing: false,
+    errorCatalog: new Map(),
+    apiVersion: null,
+});
+const DEFAULT_SPEED = { min: 0.8, max: 1.2 };
+const DEFAULT_REPLACEMENTS = { maxRules: 50, fromMaxLength: 50, toMaxLength: 100 };
+function schemaOf(spec, name) {
+    const components = spec.components;
+    if (!isRecord(components) || !isRecord(components.schemas))
+        return null;
+    const schema = components.schemas[name];
+    return isRecord(schema) ? schema : null;
+}
+function propertiesOf(schema) {
+    return schema && isRecord(schema.properties) ? schema.properties : {};
+}
+/** The non-null branch of a nullable property (`anyOf: [{…}, {type: 'null'}]`), or the property itself. */
+function concrete(prop) {
+    if (!isRecord(prop))
+        return null;
+    for (const key of ['anyOf', 'oneOf']) {
+        const branches = prop[key];
+        if (Array.isArray(branches)) {
+            const branch = branches.find(b => isRecord(b) && b.type !== 'null');
+            if (isRecord(branch))
+                return { ...prop, ...branch };
+        }
+    }
+    return prop;
+}
+function num(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+export function detectFeatures(spec) {
+    if (!isRecord(spec))
+        return { ...NO_FEATURES, errorCatalog: new Map() };
+    const request = propertiesOf(schemaOf(spec, 'CreateSpeechRequest'));
+    const audio = propertiesOf(schemaOf(spec, 'SpeechAudio'));
+    let speed = null;
+    const speedProp = concrete(request.speed);
+    if (speedProp) {
+        speed = {
+            min: num(speedProp.minimum, DEFAULT_SPEED.min),
+            max: num(speedProp.maximum, DEFAULT_SPEED.max),
+        };
+        if (!(speed.min > 0 && speed.min < speed.max))
+            speed = { ...DEFAULT_SPEED };
+    }
+    let replacements = null;
+    const replProp = concrete(request.replacements);
+    if (replProp) {
+        const items = concrete(replProp.items);
+        const itemProps = propertiesOf(items);
+        replacements = {
+            maxRules: num(replProp.maxItems, DEFAULT_REPLACEMENTS.maxRules),
+            fromMaxLength: num(concrete(itemProps.from)?.maxLength, DEFAULT_REPLACEMENTS.fromMaxLength),
+            toMaxLength: num(concrete(itemProps.to)?.maxLength, DEFAULT_REPLACEMENTS.toMaxLength),
+        };
+    }
+    const paths = isRecord(spec.paths) ? spec.paths : {};
+    const batchPath = paths['/speech/batch'];
+    const batch = isRecord(batchPath) && isRecord(batchPath.post);
+    const timing = 'segments' in audio || 'speech_start_seconds' in audio;
+    const errorCatalog = new Map();
+    const codes = spec['x-error-codes'];
+    if (Array.isArray(codes)) {
+        for (const entry of codes) {
+            if (isRecord(entry) && typeof entry.code === 'string' && typeof entry.message === 'string') {
+                errorCatalog.set(entry.code, {
+                    status: num(entry.status, 500),
+                    type: typeof entry.type === 'string' ? entry.type : 'api_error',
+                    retryable: entry.retryable === true,
+                    message: entry.message,
+                });
+            }
+        }
+    }
+    const info = isRecord(spec.info) ? spec.info : {};
+    return {
+        speed,
+        replacements,
+        batch,
+        timing,
+        errorCatalog,
+        apiVersion: typeof info.version === 'string' ? info.version : null,
+    };
+}
+/** Fetch and detect. Never throws: an unreachable document means "no Phase B features". */
+export async function loadFeatures(apiBase, opts) {
+    const fetchImpl = opts.fetch ?? ((input, init) => fetch(input, init));
+    try {
+        const res = await fetchImpl(`${apiBase}/openapi.json`, {
+            headers: { Accept: 'application/json', 'User-Agent': USER_AGENT },
+            signal: AbortSignal.timeout(opts.timeoutMs ?? 5_000),
+        });
+        if (!res.ok) {
+            opts.logger.warn('could not read the API description; optional features stay off', { status: res.status });
+            return { ...NO_FEATURES, errorCatalog: new Map() };
+        }
+        const features = detectFeatures(await res.json());
+        opts.logger.info('API features detected', {
+            api_version: features.apiVersion,
+            speed: features.speed !== null,
+            replacements: features.replacements !== null,
+            batch: features.batch,
+            timing: features.timing,
+        });
+        return features;
+    }
+    catch (err) {
+        opts.logger.warn('could not read the API description; optional features stay off', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return { ...NO_FEATURES, errorCatalog: new Map() };
+    }
+}
+//# sourceMappingURL=features.js.map

package/dist/api/features.js.map

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

package/dist/api/types.js

@@ -0,0 +1,15 @@
+export const OUTPUT_FORMATS = ['wav', 'mp3'];
+export const JOB_STATUSES = ['processing', 'succeeded', 'failed', 'cancelled'];
+/**
+ * Exhaustive by construction: adding a mode to the API's enum (and
+ * regenerating the types) fails the typecheck here until it is listed.
+ */
+const NUMBER_MODE_SET = {
+    smart: true,
+    place: true,
+    digits: true,
+    english: true,
+    english_digits: true,
+};
+export const NUMBER_MODES = Object.keys(NUMBER_MODE_SET);
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,CAA4C,CAAA;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAyC,CAAA;AAEtH;;;GAGG;AACH,MAAM,eAAe,GAA6B;IAChD,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,IAAI;CACrB,CAAA;AACD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAkC,CAAA"}