@atomic-chat/core 0.13.2 → 0.17.0

package/dist/media/adapters/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * What an adapter is: the code that speaks one provider media API (a "dialect"). An image adapter
+ * answers a generation with the images; a video adapter submits a job, polls it and downloads the
+ * clip, because every video API is asynchronous and a clip takes minutes. The job runner
+ * (`src/diffusion/remote-job.ts`) drives both; adapters never touch the gallery, the job table or
+ * events.
+ *
+ * Rules every adapter keeps (see `http.ts`):
+ * - derive every URL from `ctx.baseUrl` in code; never take a host from the catalog;
+ * - never retry a request that starts a generation (the provider may bill twice);
+ * - throw `REMOTE_*` errors (`remoteError`, `remoteHttpError`), `CANCELLED` when `ctx.signal` fired;
+ * - read model-specific settings from `job.model.options` and parameters from `job.model.params`.
+ */
+import type { ImageModelDescriptor, MediaDialect, RemoteImageWorkflow, RemoteVideoWorkflow, VideoModelDescriptor } from '../../contracts/index.js';
+import type { AtomicCoreError } from '../../contracts/index.js';
+import type { LiveMediaModel } from '../catalog.js';
+import type { MediaContext } from '../http.js';
+/** An image handed to the provider: a source, a reference, a frame or a mask. */
+export interface MediaInput {
+    bytes: Buffer;
+    mime: string;
+}
+export interface ImageGenerationJob {
+    model: ImageModelDescriptor;
+    prompt: string;
+    negativePrompt?: string;
+    workflow: RemoteImageWorkflow;
+    /** Images to make, within `model.params.n.max` (1 when the model has no `n`). */
+    n: number;
+    seed?: number;
+    /** The form's pixel size, for a model whose `size` is a range. */
+    width?: number;
+    height?: number;
+    /** `auto` or `WxH`, for a model whose `size` is a list. */
+    size?: string;
+    aspectRatio?: string;
+    resolution?: string;
+    quality?: string;
+    background?: string;
+    outputFormat?: string;
+    steps?: number;
+    cfgScale?: number;
+    guidance?: number;
+    sampler?: string;
+    /** Denoise strength 0..1 (`transform`, `inpaint`). */
+    strength?: number;
+    /** The source image first (every workflow but `create`), then the references. */
+    images: MediaInput[];
+    /** `inpaint`: a PNG the size of the source, white where the model repaints. */
+    mask?: MediaInput;
+}
+export interface GeneratedImage {
+    bytes: Buffer;
+    /** What the bytes are (`image/png`, `image/jpeg`, `image/webp`); sniffed, not the header's word. */
+    mime: string;
+}
+/** How far a generation got, when the provider says; both fields optional. */
+export interface RemoteProgress {
+    /** 0..1 */
+    fraction?: number;
+    phase?: 'queued' | 'generating';
+}
+export interface ImageAdapter {
+    readonly dialect: MediaDialect;
+    readonly kind: 'image';
+    /** The provider's live model listing; absent when it has none (the catalog alone applies). */
+    listModels?(ctx: MediaContext): Promise<LiveMediaModel[]>;
+    generate(ctx: MediaContext, job: ImageGenerationJob, report: (progress: RemoteProgress) => void): Promise<GeneratedImage[]>;
+}
+export interface VideoGenerationJob {
+    model: VideoModelDescriptor;
+    prompt: string;
+    negativePrompt?: string;
+    workflow: RemoteVideoWorkflow;
+    durationSecs?: number;
+    resolution?: string;
+    aspectRatio?: string;
+    /** `WxH`, for a model whose `sizes` is a list. */
+    size?: string;
+    generateAudio?: boolean;
+    seed?: number;
+    /** `image-to-video`: the first frame. */
+    firstFrame?: MediaInput;
+    /** `image-to-video`: the last frame, when the model takes one. */
+    lastFrame?: MediaInput;
+}
+type Plain = string | number | boolean | null;
+/**
+ * What a submit answered: enough to poll, download and cancel later, also after a restart of the
+ * core. Written to disk as JSON, so plain data only.
+ */
+export interface VideoSubmission {
+    /** The provider's job id. */
+    id: string;
+    data?: Record<string, Plain>;
+}
+/** Where the finished clip is: a URL the provider gave, and/or what the adapter needs to fetch it. */
+export interface VideoResultRef {
+    url?: string;
+    data?: Record<string, Plain>;
+}
+export type VideoPoll = {
+    state: 'queued' | 'running'; /** 0..1 */
+    progress?: number;
+} | {
+    state: 'completed';
+    result: VideoResultRef;
+} | {
+    state: 'failed';
+    error: AtomicCoreError;
+};
+export interface VideoAdapter {
+    readonly dialect: MediaDialect;
+    readonly kind: 'video';
+    listModels?(ctx: MediaContext): Promise<LiveMediaModel[]>;
+    /** Starts the generation; never retried. */
+    submit(ctx: MediaContext, job: VideoGenerationJob): Promise<VideoSubmission>;
+    /** One look at the job; a transport failure here is retried by the runner. */
+    poll(ctx: MediaContext, submission: VideoSubmission): Promise<VideoPoll>;
+    download(ctx: MediaContext, submission: VideoSubmission, result: VideoResultRef): Promise<{
+        bytes: Buffer;
+        mime: string;
+    }>;
+    /** Best effort; most providers cannot cancel a running clip. */
+    cancel?(ctx: MediaContext, submission: VideoSubmission): Promise<void>;
+    /** How often to poll: the first wait, and the cap backoff grows it to. Default 5 s and 20 s. */
+    readonly pollIntervalMs?: {
+        first: number;
+        max: number;
+    };
+}
+export type MediaAdapter = ImageAdapter | VideoAdapter;
+export {};

package/dist/media/adapters/types.js

@@ -0,0 +1,15 @@
+/**
+ * What an adapter is: the code that speaks one provider media API (a "dialect"). An image adapter
+ * answers a generation with the images; a video adapter submits a job, polls it and downloads the
+ * clip, because every video API is asynchronous and a clip takes minutes. The job runner
+ * (`src/diffusion/remote-job.ts`) drives both; adapters never touch the gallery, the job table or
+ * events.
+ *
+ * Rules every adapter keeps (see `http.ts`):
+ * - derive every URL from `ctx.baseUrl` in code; never take a host from the catalog;
+ * - never retry a request that starts a generation (the provider may bill twice);
+ * - throw `REMOTE_*` errors (`remoteError`, `remoteHttpError`), `CANCELLED` when `ctx.signal` fired;
+ * - read model-specific settings from `job.model.options` and parameters from `job.model.params`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/media/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/media/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/media/adapters/xai-images.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `xai-images`: xAI's image API (Grok Imagine), registered with base `https://api.x.ai/v1`, Bearer key.
+ *
+ * Every URL is the registered base joined to a path: `create` → `POST {base}/images/generations`;
+ * `edit` and `reference` → `POST {base}/images/edits` with the inputs as data URLs, one image as
+ * `image: {url}`, several (up to five) as `images: [{url}]`, never both. xAI has no mask, so
+ * `inpaint` and `transform` are refused. The answer is the Images API shape (`data[]` with `b64_json`
+ * or a `url`); we ask for `b64_json`. The live listing is `GET {base}/image-generation-models`.
+ */
+import type { LiveMediaModel } from '../catalog.js';
+import type { ImageAdapter, ImageGenerationJob } from './types.js';
+/** The JSON body of a generation or an edit: what the job set, and the inputs for an edit. */
+export declare function xaiImageBody(job: ImageGenerationJob): Record<string, unknown>;
+/**
+ * The models of `GET /image-generation-models`: those that output images (when the entry says), able
+ * to edit and take references when they accept images.
+ */
+export declare function xaiImageModels(json: unknown): LiveMediaModel[];
+export declare const XAI_IMAGES: ImageAdapter;

package/dist/media/adapters/xai-images.js

@@ -0,0 +1,83 @@
+/**
+ * `xai-images`: xAI's image API (Grok Imagine), registered with base `https://api.x.ai/v1`, Bearer key.
+ *
+ * Every URL is the registered base joined to a path: `create` → `POST {base}/images/generations`;
+ * `edit` and `reference` → `POST {base}/images/edits` with the inputs as data URLs, one image as
+ * `image: {url}`, several (up to five) as `images: [{url}]`, never both. xAI has no mask, so
+ * `inpaint` and `transform` are refused. The answer is the Images API shape (`data[]` with `b64_json`
+ * or a `url`); we ask for `b64_json`. The live listing is `GET {base}/image-generation-models`.
+ */
+import { callProvider, GENERATE_TIMEOUT_MS, joinUrl, remoteError, toDataUrl } from '../http.js';
+import { imagesFromAnswer } from './openai-images.js';
+const WORKFLOWS = ['create', 'edit', 'reference'];
+/** The JSON body of a generation or an edit: what the job set, and the inputs for an edit. */
+export function xaiImageBody(job) {
+    const body = { model: job.model.id, prompt: job.prompt };
+    if (job.n > 1)
+        body['n'] = job.n;
+    if (job.aspectRatio)
+        body['aspect_ratio'] = job.aspectRatio;
+    if (job.resolution)
+        body['resolution'] = job.resolution;
+    if (job.quality)
+        body['quality'] = job.quality;
+    body['response_format'] = 'b64_json';
+    if (job.workflow !== 'create') {
+        const inputs = job.images.map((image) => ({ url: toDataUrl(image.bytes, image.mime), type: 'image_url' }));
+        if (inputs.length === 1)
+            body['image'] = inputs[0];
+        else if (inputs.length > 1)
+            body['images'] = inputs;
+    }
+    return body;
+}
+const isStrings = (value) => Array.isArray(value) && value.every((item) => typeof item === 'string');
+/**
+ * The models of `GET /image-generation-models`: those that output images (when the entry says), able
+ * to edit and take references when they accept images.
+ */
+export function xaiImageModels(json) {
+    const list = json && typeof json === 'object' && !Array.isArray(json)
+        ? (json['models'] ?? json['data'])
+        : undefined;
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(list) ? list : []) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const entry = item;
+        const id = entry['id'];
+        if (typeof id !== 'string' || id === '' || seen.has(id))
+            continue;
+        const outputs = entry['output_modalities'];
+        if (isStrings(outputs) && !outputs.some((m) => m.toLowerCase() === 'image'))
+            continue;
+        seen.add(id);
+        const inputs = entry['input_modalities'];
+        const takesImages = isStrings(inputs) && inputs.some((m) => m.toLowerCase() === 'image');
+        out.push({ id, workflows: takesImages ? ['create', 'edit', 'reference'] : ['create'] });
+    }
+    return out;
+}
+export const XAI_IMAGES = {
+    dialect: 'xai-images',
+    kind: 'image',
+    async listModels(ctx) {
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, '/image-generation-models'));
+        return xaiImageModels(answer.json);
+    },
+    async generate(ctx, job, report) {
+        if (!WORKFLOWS.includes(job.workflow))
+            throw remoteError('REMOTE_UNSUPPORTED', `${ctx.provider} does not support this workflow.`, job.workflow);
+        if (job.workflow !== 'create' && job.images.length === 0)
+            throw remoteError('REMOTE_UNSUPPORTED', 'This workflow needs a source image.', job.workflow);
+        report({ phase: 'generating' });
+        const path = job.workflow === 'create' ? '/images/generations' : '/images/edits';
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, path), {
+            json: xaiImageBody(job),
+            timeoutMs: GENERATE_TIMEOUT_MS,
+        });
+        return imagesFromAnswer(ctx, answer.json);
+    },
+};
+//# sourceMappingURL=xai-images.js.map

package/dist/media/adapters/xai-images.js.map

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

package/dist/media/adapters/xai-videos.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `xai-videos`: xAI's Grok Imagine video API (registered base `https://api.x.ai/v1`).
+ *
+ * Every URL is derived from `ctx.baseUrl`:
+ * - submit: `POST {base}/videos/generations`, JSON `{model, prompt, duration, aspect_ratio,
+ *   resolution, generate_audio, image: {url}, last_frame: {url}}` → `{request_id}`. Frames go as data
+ *   URLs. xAI ignores `aspect_ratio` for image to video (the clip takes the image's).
+ * - poll: `GET {base}/videos/{request_id}` → `pending | done | failed | expired`, `progress` 0..100,
+ *   `video: {url, duration, respect_moderation}`, `error: {code, message}`. A `done` clip that
+ *   moderation withheld (`respect_moderation: false`, no URL) is `REMOTE_CONTENT_BLOCKED`.
+ * - download: `video.url`, a temporary file on xAI's CDN; off the API's origin it goes without the key.
+ * - models: `GET {base}/video-generation-models` → `{models: [{id}]}`.
+ *
+ * No cancel: xAI has none.
+ */
+import type { AtomicCoreError } from '../../contracts/index.js';
+import type { LiveMediaModel } from '../catalog.js';
+import type { VideoAdapter, VideoGenerationJob, VideoPoll } from './types.js';
+type Fields = Record<string, unknown>;
+/** The submit body: each field only when the job set it and the model offers it; frames as data URLs. */
+export declare function xaiVideoBody(job: VideoGenerationJob, provider?: string): Fields;
+/** A failed job's `error: {code, message}` as the closest `REMOTE_*` code. */
+export declare function xaiVideoError(provider: string, error: unknown): AtomicCoreError;
+/** One `GET {base}/videos/{request_id}` answer as a poll result. */
+export declare function readXaiVideo(provider: string, json: unknown): VideoPoll;
+/** The models of a `GET {base}/video-generation-models` answer. */
+export declare function xaiVideoModels(json: unknown): LiveMediaModel[];
+export declare const XAI_VIDEOS: VideoAdapter;
+export {};

package/dist/media/adapters/xai-videos.js

@@ -0,0 +1,148 @@
+/**
+ * `xai-videos`: xAI's Grok Imagine video API (registered base `https://api.x.ai/v1`).
+ *
+ * Every URL is derived from `ctx.baseUrl`:
+ * - submit: `POST {base}/videos/generations`, JSON `{model, prompt, duration, aspect_ratio,
+ *   resolution, generate_audio, image: {url}, last_frame: {url}}` → `{request_id}`. Frames go as data
+ *   URLs. xAI ignores `aspect_ratio` for image to video (the clip takes the image's).
+ * - poll: `GET {base}/videos/{request_id}` → `pending | done | failed | expired`, `progress` 0..100,
+ *   `video: {url, duration, respect_moderation}`, `error: {code, message}`. A `done` clip that
+ *   moderation withheld (`respect_moderation: false`, no URL) is `REMOTE_CONTENT_BLOCKED`.
+ * - download: `video.url`, a temporary file on xAI's CDN; off the API's origin it goes without the key.
+ * - models: `GET {base}/video-generation-models` → `{models: [{id}]}`.
+ *
+ * No cancel: xAI has none.
+ */
+import { callProvider, downloadResult, joinUrl, MAX_VIDEO_BYTES, providerMessage, remoteError, sniffVideoMime, toDataUrl, } from '../http.js';
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const BLOCKED = /moderation|content[ _-]?polic|safety|nsfw|sensitive|prohibited|blocked|flagged/i;
+/** The submit body: each field only when the job set it and the model offers it; frames as data URLs. */
+export function xaiVideoBody(job, provider = 'xAI') {
+    const params = job.model.params;
+    const body = { model: job.model.id, prompt: job.prompt };
+    if (job.durationSecs !== undefined && params.durations)
+        body['duration'] = Math.round(job.durationSecs);
+    if (job.aspectRatio && params.aspect_ratios)
+        body['aspect_ratio'] = job.aspectRatio;
+    if (job.resolution && params.resolutions)
+        body['resolution'] = job.resolution;
+    if (job.generateAudio !== undefined && params.audio)
+        body['generate_audio'] = job.generateAudio;
+    if (job.seed !== undefined && params.seed)
+        body['seed'] = job.seed;
+    if (job.workflow === 'image-to-video') {
+        if (!job.firstFrame)
+            throw remoteError('REMOTE_UNSUPPORTED', 'Image to video needs a first frame.', job.workflow);
+        body['image'] = { url: toDataUrl(job.firstFrame.bytes, job.firstFrame.mime) };
+        if (job.lastFrame) {
+            if (!params.last_frame)
+                throw remoteError('REMOTE_UNSUPPORTED', `${provider} takes no last frame for this model.`, job.model.id);
+            body['last_frame'] = { url: toDataUrl(job.lastFrame.bytes, job.lastFrame.mime) };
+        }
+    }
+    return body;
+}
+/** A failed job's `error: {code, message}` as the closest `REMOTE_*` code. */
+export function xaiVideoError(provider, error) {
+    const code = isObject(error) && typeof error['code'] === 'string' ? error['code'].toLowerCase() : '';
+    const said = providerMessage({ error });
+    const details = [code, said].filter(Boolean).join(': ') || undefined;
+    if (BLOCKED.test(said ?? ''))
+        return remoteError('REMOTE_CONTENT_BLOCKED', `${provider} refused the request: ${said}`, details);
+    if (code === 'invalid_argument' || code === 'failed_precondition')
+        return remoteError('REMOTE_REJECTED', said ? `${provider}: ${said}` : `${provider} refused the request.`, details);
+    if (code === 'permission_denied' || code === 'unauthenticated')
+        return remoteError('REMOTE_AUTH_FAILED', `${provider} refused the API key or the model.`, details);
+    if (code === 'resource_exhausted')
+        return remoteError('REMOTE_RATE_LIMITED', `${provider} is rate-limiting requests.`, details);
+    return remoteError('REMOTE_UNAVAILABLE', said ? `${provider} failed to make the clip: ${said}` : `${provider} failed to make the clip.`, details);
+}
+function progressOf(value) {
+    return typeof value === 'number' && Number.isFinite(value)
+        ? { progress: Math.min(1, Math.max(0, value / 100)) }
+        : {};
+}
+/** One `GET {base}/videos/{request_id}` answer as a poll result. */
+export function readXaiVideo(provider, json) {
+    const fields = isObject(json) ? json : {};
+    const status = typeof fields['status'] === 'string' ? fields['status'].toLowerCase() : '';
+    switch (status) {
+        case 'done':
+        case 'completed': {
+            const video = isObject(fields['video']) ? fields['video'] : {};
+            const url = typeof video['url'] === 'string' ? video['url'].trim() : '';
+            if (url !== '')
+                return { state: 'completed', result: { url } };
+            if (video['respect_moderation'] === false)
+                return {
+                    state: 'failed',
+                    error: remoteError('REMOTE_CONTENT_BLOCKED', `${provider} withheld the clip by moderation.`),
+                };
+            return {
+                state: 'failed',
+                error: remoteError('REMOTE_UNAVAILABLE', `${provider} finished without a clip.`),
+            };
+        }
+        case 'failed':
+            return { state: 'failed', error: xaiVideoError(provider, fields['error']) };
+        case 'expired':
+            return {
+                state: 'failed',
+                error: remoteError('REMOTE_UNAVAILABLE', `${provider} let the clip expire before it was fetched.`),
+            };
+        default:
+            // `pending`: xAI does not tell a queue from a render.
+            return { state: 'running', ...progressOf(fields['progress']) };
+    }
+}
+/** The models of a `GET {base}/video-generation-models` answer. */
+export function xaiVideoModels(json) {
+    const fields = isObject(json) ? json : {};
+    const data = fields['models'] ?? fields['data'];
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(data) ? data : []) {
+        if (!isObject(item) || typeof item['id'] !== 'string' || item['id'] === '' || seen.has(item['id']))
+            continue;
+        seen.add(item['id']);
+        out.push({ id: item['id'] });
+    }
+    return out;
+}
+export const XAI_VIDEOS = {
+    dialect: 'xai-videos',
+    kind: 'video',
+    pollIntervalMs: { first: 5_000, max: 15_000 },
+    async listModels(ctx) {
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, '/video-generation-models'), {
+            accept: [404],
+        });
+        return answer.status === 200 ? xaiVideoModels(answer.json) : [];
+    },
+    async submit(ctx, job) {
+        const body = xaiVideoBody(job, ctx.provider);
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, '/videos/generations'), { json: body });
+        const fields = isObject(answer.json) ? answer.json : {};
+        const id = fields['request_id'] ?? fields['id'];
+        if (typeof id !== 'string' || id === '')
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without a request id.`, answer.text.slice(0, 500));
+        return { id };
+    },
+    async poll(ctx, submission) {
+        // 202 is how xAI's other deferred routes say "not yet"; take it as a pending job.
+        const answer = await callProvider(ctx, joinUrl(ctx.baseUrl, `/videos/${encodeURIComponent(submission.id)}`), {
+            accept: [202],
+        });
+        return readXaiVideo(ctx.provider, answer.json);
+    },
+    async download(ctx, _submission, result) {
+        if (!result.url)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} gave no clip to download.`);
+        const file = await downloadResult(ctx, result.url, { maxBytes: MAX_VIDEO_BYTES, what: 'video' });
+        const mime = sniffVideoMime(file.bytes);
+        if (!mime)
+            throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} returned a file that is not a video.`);
+        return { bytes: file.bytes, mime };
+    },
+};
+//# sourceMappingURL=xai-videos.js.map

package/dist/media/adapters/xai-videos.js.map

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

package/dist/media/catalog-baseline.d.ts

@@ -0,0 +1,2 @@
+import type { MediaCatalog } from './catalog.js';
+export declare const MEDIA_CATALOG_BASELINE: MediaCatalog;

package/dist/media/catalog-baseline.js

@@ -0,0 +1,10 @@
+// Offline snapshot of atomic-chat-conf/providers/media.json (without `$schema`): what the core offers
+// when neither the live catalog nor its disk cache are available. Re-copy it from conf when the
+// catalog changes there; a live document with a newer `catalog_version` always wins.
+import raw from './catalog-baseline.json' with { type: 'json' };
+import { parseMediaCatalog } from './catalog.js';
+const parsed = parseMediaCatalog(raw);
+if (!parsed)
+    throw new Error('catalog-baseline.json is not a valid remote media catalog');
+export const MEDIA_CATALOG_BASELINE = parsed;
+//# sourceMappingURL=catalog-baseline.js.map

package/dist/media/catalog-baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-baseline.js","sourceRoot":"","sources":["../../src/media/catalog-baseline.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,gGAAgG;AAChG,qFAAqF;AACrF,OAAO,GAAG,MAAM,yBAAyB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGhD,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;AACrC,IAAI,CAAC,MAAM;IAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;AAEzF,MAAM,CAAC,MAAM,sBAAsB,GAAiB,MAAM,CAAA"}