@atomic-chat/core 0.13.6 → 0.18.3

package/dist/lock/process-identity.d.ts

@@ -14,8 +14,8 @@ export interface IdentityDeps {
     platform?: NodeJS.Platform;
     /** Read a procfs entry (Linux). */
     readText?: (path: string) => Promise<string>;
-    /** Run a probe and return its stdout. */
-    run?: (file: string, args: string[]) => Promise<string>;
+    /** Run a probe and return its stdout; `env` is laid over this process's environment. */
+    run?: (file: string, args: string[], env?: Record<string, string>) => Promise<string>;
     /** Signal-0 liveness probe. */
     alive?: (pid: number) => boolean;
 }
@@ -27,7 +27,7 @@ export interface IdentityDeps {
  */
 export declare const IDENTITY_PROBE_TIMEOUT_MS = 15000;
 export declare function isProcessAlive(pid: number): boolean;
-export declare function runProbe(file: string, args: string[]): Promise<string>;
+export declare function runProbe(file: string, args: string[], env?: Record<string, string>): Promise<string>;
 /**
  * An opaque, comparable token for "this incarnation of this PID", or `undefined` when the platform
  * cannot tell us. Only ever compared for equality, never parsed.
@@ -44,5 +44,11 @@ export declare function processStartEpoch(pid: number, deps?: IdentityDeps): Pro
 export declare function processName(pid: number, deps?: IdentityDeps): Promise<string | undefined>;
 /** Compare a recorded identity with the live process. `unknown` means "cannot prove"; treat as live. */
 export declare function verifyProcessIdentity(pid: number, expected: string | null | undefined, deps?: IdentityDeps): Promise<IdentityVerdict>;
+/**
+ * Compare a recorded start time (`epoch:<seconds>`, `processStartEpoch`) with the live process. Seconds
+ * since the epoch read the same in every locale and zone, so a difference is proof of another process
+ * behind the PID; a second either way is the same start read at a different instant.
+ */
+export declare function verifyStartEpoch(pid: number, expected: string | null | undefined, deps?: IdentityDeps): Promise<IdentityVerdict>;
 /** Only a proven-gone process releases what it held. */
 export declare function identityPermitsTakeover(verdict: IdentityVerdict): boolean;

package/dist/lock/process-identity.js

@@ -30,9 +30,13 @@ export function isProcessAlive(pid) {
         return e.code === 'EPERM';
     }
 }
-export function runProbe(file, args) {
+export function runProbe(file, args, env) {
     return new Promise((resolve, reject) => {
-        execFile(file, args, { timeout: IDENTITY_PROBE_TIMEOUT_MS, windowsHide: true }, (err, stdout) => {
+        execFile(file, args, {
+            timeout: IDENTITY_PROBE_TIMEOUT_MS,
+            windowsHide: true,
+            ...(env ? { env: { ...process.env, ...env } } : {}),
+        }, (err, stdout) => {
             if (err)
                 reject(err);
             else
@@ -40,6 +44,21 @@ export function runProbe(file, args) {
         });
     });
 }
+/**
+ * What `ps` prints depends on the locale and the time zone of whoever runs it; an identity compared
+ * later by another process (a core started from another terminal, a laptop in another zone) must not.
+ */
+const PINNED_PS_ENV = { LC_ALL: 'C', TZ: 'UTC' };
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** `Mon Oct 19 10:33:52 2026` (C locale, UTC) → seconds since the epoch; `undefined` for anything else. */
+function utcLstartSeconds(text) {
+    const m = /^[A-Z][a-z]{2} ([A-Z][a-z]{2}) +(\d{1,2}) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/.exec(text);
+    const month = m ? MONTHS.indexOf(m[1]) : -1;
+    if (!m || month < 0)
+        return undefined;
+    const [day, h, min, sec, year] = m.slice(2).map(Number);
+    return Date.UTC(year, month, day, h, min, sec) / 1000;
+}
 /**
  * An opaque, comparable token for "this incarnation of this PID", or `undefined` when the platform
  * cannot tell us. Only ever compared for equality, never parsed.
@@ -65,19 +84,19 @@ export async function processStartId(pid, deps = {}) {
         if (platform === 'darwin') {
             // `lstart` has one-second resolution; a PID reused inside the same second is indistinguishable,
             // which the takeover path treats as "unknown", never as a free lock.
-            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)]);
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], PINNED_PS_ENV);
             const value = out.trim().replace(/\s+/g, ' ');
-            return value ? `darwin:${value}` : undefined;
+            return value ? `darwin-utc:${value}` : undefined;
         }
         if (platform === 'win32') {
             const out = await run('powershell.exe', [
                 '-NoProfile',
                 '-NonInteractive',
                 '-Command',
-                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.Ticks`,
+                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks`,
             ]);
             const value = out.trim();
-            return /^\d+$/.test(value) ? `win32:${value}` : undefined;
+            return /^\d+$/.test(value) ? `win32-utc:${value}` : undefined;
         }
     }
     catch {
@@ -107,9 +126,9 @@ export async function processStartEpoch(pid, deps = {}) {
             return `epoch:${Math.floor(boot + ticks / 100)}`;
         }
         if (platform === 'darwin') {
-            const out = (await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)])).trim();
-            const epoch = Math.floor(Date.parse(out) / 1000);
-            return Number.isFinite(epoch) ? `epoch:${epoch}` : undefined;
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], PINNED_PS_ENV);
+            const epoch = utcLstartSeconds(out.trim().replace(/\s+/g, ' '));
+            return epoch === undefined ? undefined : `epoch:${epoch}`;
         }
         if (platform === 'win32') {
             const out = await run('powershell.exe', [
@@ -168,11 +187,58 @@ export async function verifyProcessIdentity(pid, expected, deps = {}) {
         return 'dead';
     if (!expected)
         return 'unknown';
+    // Written before identities were pinned: in the writer's locale and zone, which this reader cannot
+    // know. Equal still proves it; a difference proves nothing, so it never frees what the owner holds.
+    if (/^(darwin|win32):/.test(expected)) {
+        const legacy = await legacyStartId(pid, deps);
+        return legacy !== undefined && legacy === expected ? 'match' : 'unknown';
+    }
     const actual = await processStartId(pid, deps);
     if (!actual)
         return 'unknown';
     return actual === expected ? 'match' : 'mismatch';
 }
+/** The identity as cores before 0.18.3 wrote it: `ps` in the C locale and local zone, local ticks. */
+async function legacyStartId(pid, deps) {
+    const platform = deps.platform ?? process.platform;
+    const run = deps.run ?? runProbe;
+    try {
+        if (platform === 'darwin') {
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], { LC_ALL: 'C' });
+            const value = out.trim().replace(/\s+/g, ' ');
+            return value ? `darwin:${value}` : undefined;
+        }
+        if (platform === 'win32') {
+            const out = await run('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.Ticks`,
+            ]);
+            const value = out.trim();
+            return /^\d+$/.test(value) ? `win32:${value}` : undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Compare a recorded start time (`epoch:<seconds>`, `processStartEpoch`) with the live process. Seconds
+ * since the epoch read the same in every locale and zone, so a difference is proof of another process
+ * behind the PID; a second either way is the same start read at a different instant.
+ */
+export async function verifyStartEpoch(pid, expected, deps = {}) {
+    const alive = deps.alive ?? isProcessAlive;
+    if (!alive(pid))
+        return 'dead';
+    const want = Number(/^epoch:(\d+)$/.exec(expected ?? '')?.[1]);
+    const got = Number(/^epoch:(\d+)$/.exec((await processStartEpoch(pid, deps)) ?? '')?.[1]);
+    if (!Number.isFinite(want) || !Number.isFinite(got))
+        return 'unknown';
+    return Math.abs(want - got) <= 1 ? 'match' : 'mismatch';
+}
 /** Only a proven-gone process releases what it held. */
 export function identityPermitsTakeover(verdict) {
     return verdict === 'dead' || verdict === 'mismatch';

package/dist/lock/process-identity.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * `a1111`: the Automatic1111 web UI API (`--api`) and the forks that keep it — Forge and Forge Neo.
+ * A self-hosted server, usually keyless, registered at its root (`http://127.0.0.1:7860`); a base
+ * entered with a trailing `/sdapi/v1` or `/v1` is cut back to the root, and every route below is
+ * `{root}/sdapi/v1/...`.
+ *
+ * - `create` → `POST /sdapi/v1/txt2img`; `transform` and `inpaint` → `POST /sdapi/v1/img2img` with
+ *   the source as `init_images` and, for `inpaint`, the mask as is (white repaints there too).
+ *   The checkpoint is picked per request (`override_settings.sd_model_checkpoint`), `n` images are
+ *   one batch, and the images come back as base64 PNGs.
+ * - While a generation runs, `GET /sdapi/v1/progress` is polled about once a second for the
+ *   fraction; cancelling the job sends `POST /sdapi/v1/interrupt`, best effort.
+ * - Listing: `GET /sdapi/v1/sd-models` (its `title` is what `sd_model_checkpoint` takes) and
+ *   `GET /sdapi/v1/samplers` (missing on some forks; then no samplers are listed).
+ *
+ * Basic auth (`--api-auth user:pass`) is a custom `Authorization` header, or the registration's key
+ * as `user:pass`, sent as `Basic` only when no custom `Authorization` is set.
+ */
+import type { LiveMediaModel } from '../catalog.js';
+import type { MediaContext } from '../http.js';
+import type { GeneratedImage, ImageAdapter, ImageGenerationJob } from './types.js';
+/** The server root: the registered base without trailing slashes, `/sdapi/v1` or `/v1`. */
+export declare function a1111Root(baseUrl: string): string;
+/** `Basic <base64(key)>` from the registration's key, unless a custom `Authorization` is set. */
+export declare function a1111Auth(ctx: Pick<MediaContext, 'apiKey' | 'customHeaders'>): Record<string, string>;
+/** The `txt2img` / `img2img` body of a job. The source and the mask must be there for their workflows. */
+export declare function a1111Body(job: ImageGenerationJob): Record<string, unknown>;
+/** The images of an answer: `n` of them, without the grid a batch may put first. */
+export declare function a1111Images(ctx: Pick<MediaContext, 'provider'>, json: unknown, n: number): GeneratedImage[];
+/** The checkpoints of `/sd-models`, each with the samplers of `/samplers`. */
+export declare function liveModelsFromA1111(models: unknown, samplers: unknown): LiveMediaModel[];
+export declare const A1111: ImageAdapter;

package/dist/media/adapters/a1111.js

@@ -0,0 +1,207 @@
+/**
+ * `a1111`: the Automatic1111 web UI API (`--api`) and the forks that keep it — Forge and Forge Neo.
+ * A self-hosted server, usually keyless, registered at its root (`http://127.0.0.1:7860`); a base
+ * entered with a trailing `/sdapi/v1` or `/v1` is cut back to the root, and every route below is
+ * `{root}/sdapi/v1/...`.
+ *
+ * - `create` → `POST /sdapi/v1/txt2img`; `transform` and `inpaint` → `POST /sdapi/v1/img2img` with
+ *   the source as `init_images` and, for `inpaint`, the mask as is (white repaints there too).
+ *   The checkpoint is picked per request (`override_settings.sd_model_checkpoint`), `n` images are
+ *   one batch, and the images come back as base64 PNGs.
+ * - While a generation runs, `GET /sdapi/v1/progress` is polled about once a second for the
+ *   fraction; cancelling the job sends `POST /sdapi/v1/interrupt`, best effort.
+ * - Listing: `GET /sdapi/v1/sd-models` (its `title` is what `sd_model_checkpoint` takes) and
+ *   `GET /sdapi/v1/samplers` (missing on some forks; then no samplers are listed).
+ *
+ * Basic auth (`--api-auth user:pass`) is a custom `Authorization` header, or the registration's key
+ * as `user:pass`, sent as `Basic` only when no custom `Authorization` is set.
+ */
+import { callProvider, decodeBase64Image, GENERATE_TIMEOUT_MS, joinUrl, parseWxH, remoteError, remoteHttpError, } from '../http.js';
+const asObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const text = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+/** How often the progress route is asked while a generation runs. */
+const PROGRESS_INTERVAL_MS = 1000;
+/** A progress poll or an interrupt that takes longer than this is dropped. */
+const SIDE_CALL_TIMEOUT_MS = 10_000;
+/** The server root: the registered base without trailing slashes, `/sdapi/v1` or `/v1`. */
+export function a1111Root(baseUrl) {
+    return baseUrl.replace(/\/+$/, '').replace(/(\/sdapi)?\/v1$/i, '');
+}
+/** `Basic <base64(key)>` from the registration's key, unless a custom `Authorization` is set. */
+export function a1111Auth(ctx) {
+    const key = ctx.apiKey?.trim();
+    if (!key || ctx.customHeaders.some(({ header }) => header.toLowerCase() === 'authorization'))
+        return {};
+    return { Authorization: `Basic ${Buffer.from(key, 'utf8').toString('base64')}` };
+}
+/** One call to the server: its own auth, and a 404 read as "no API here". */
+async function a1111Call(ctx, path, options = {}) {
+    const accept = options.accept ?? [];
+    const answer = await callProvider(ctx, joinUrl(a1111Root(ctx.baseUrl), path), {
+        ...options,
+        auth: 'none',
+        headers: { ...a1111Auth(ctx), ...options.headers },
+        accept: accept.includes(404) ? accept : [...accept, 404],
+    });
+    if (answer.status === 404 && !accept.includes(404))
+        throw remoteError('REMOTE_NOT_CONFIGURED', `${ctx.provider} has no Automatic1111 API at this address; start the server with --api.`, `HTTP 404 ${path}`);
+    return answer;
+}
+/** The job's pixel size: the form's width and height, its `WxH`, else the model's default. */
+function pixelSize(job) {
+    if (job.width && job.height)
+        return { width: job.width, height: job.height };
+    const listed = parseWxH(job.size);
+    if (listed)
+        return listed;
+    const size = job.model.params.size;
+    if (size?.kind === 'range' && size.default_width && size.default_height)
+        return { width: size.default_width, height: size.default_height };
+    return undefined;
+}
+/** The `txt2img` / `img2img` body of a job. The source and the mask must be there for their workflows. */
+export function a1111Body(job) {
+    const params = job.model.params;
+    const body = { prompt: job.prompt, negative_prompt: job.negativePrompt ?? '' };
+    const size = pixelSize(job);
+    if (size)
+        Object.assign(body, size);
+    const steps = job.steps ?? params.steps?.default;
+    if (steps !== undefined)
+        body['steps'] = steps;
+    const cfg = job.cfgScale ?? params.cfg?.default;
+    if (cfg !== undefined)
+        body['cfg_scale'] = cfg;
+    // Forge's distilled CFG (FLUX); the original A1111 ignores the field.
+    if (job.guidance !== undefined)
+        body['distilled_cfg_scale'] = job.guidance;
+    if (job.sampler)
+        body['sampler_name'] = job.sampler;
+    body['seed'] = job.seed !== undefined && job.seed >= 0 ? Math.trunc(job.seed) : -1;
+    body['batch_size'] = Math.max(1, job.n);
+    body['n_iter'] = 1;
+    body['override_settings'] = { sd_model_checkpoint: job.model.id };
+    body['override_settings_restore_afterwards'] = true;
+    body['send_images'] = true;
+    body['save_images'] = false;
+    if (job.workflow === 'transform' || job.workflow === 'inpaint') {
+        const source = job.images[0];
+        if (!source)
+            throw remoteError('REMOTE_UNSUPPORTED', 'This workflow needs a source image.', job.workflow);
+        body['init_images'] = [source.bytes.toString('base64')];
+        body['denoising_strength'] = job.strength ?? 0.75;
+    }
+    if (job.workflow === 'inpaint') {
+        if (!job.mask)
+            throw remoteError('REMOTE_UNSUPPORTED', 'Inpainting needs a mask.', job.workflow);
+        body['mask'] = job.mask.bytes.toString('base64');
+        body['inpainting_fill'] = 1;
+        body['inpaint_full_res'] = false;
+        body['mask_blur'] = 4;
+    }
+    return body;
+}
+/** The images of an answer: `n` of them, without the grid a batch may put first. */
+export function a1111Images(ctx, json, n) {
+    const listed = (Array.isArray(asObject(json)['images']) ? asObject(json)['images'] : []).filter((item) => typeof item === 'string' && item !== '');
+    const count = Math.max(1, n);
+    const images = count > 1 && listed.length === count + 1 ? listed.slice(1) : listed;
+    const out = images.slice(0, count).map((payload) => decodeBase64Image(payload));
+    if (out.length === 0)
+        throw remoteError('REMOTE_UNAVAILABLE', `${ctx.provider} answered without an image.`);
+    return out;
+}
+/** The checkpoints of `/sd-models`, each with the samplers of `/samplers`. */
+export function liveModelsFromA1111(models, samplers) {
+    const names = (Array.isArray(samplers) ? samplers : [])
+        .map((item) => text(asObject(item)['name']))
+        .filter((name) => name !== undefined);
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(models) ? models : []) {
+        const entry = asObject(item);
+        const id = text(entry['title']) ?? text(entry['model_name']);
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        const model = { id, name: text(entry['model_name']) ?? id };
+        if (names.length > 0)
+            model.samplers = [...new Set(names)];
+        out.push(model);
+    }
+    return out;
+}
+/**
+ * Polls the progress route until `finished` settles, reporting the fraction. Best effort: a failed
+ * poll is skipped, a server without the route stops the polling.
+ */
+async function followProgress(ctx, finished, report) {
+    let over = false;
+    void finished.then(() => {
+        over = true;
+    });
+    for (;;) {
+        const woke = await Promise.race([
+            ctx.sleep(PROGRESS_INTERVAL_MS).then(() => true, () => false),
+            finished.then(() => false),
+        ]);
+        if (!woke || over)
+            return;
+        let answer;
+        try {
+            answer = await a1111Call(ctx, '/sdapi/v1/progress?skip_current_image=true', {
+                accept: [404, 405],
+                timeoutMs: SIDE_CALL_TIMEOUT_MS,
+            });
+        }
+        catch {
+            continue;
+        }
+        if (over || answer.status === 404 || answer.status === 405)
+            return;
+        const fraction = asObject(answer.json)['progress'];
+        if (typeof fraction === 'number' && Number.isFinite(fraction) && fraction > 0)
+            report({ phase: 'generating', fraction: Math.min(fraction, 1) });
+    }
+}
+/** Stops the server's current generation, best effort and without waiting. */
+function interrupt(ctx) {
+    const quiet = { ...ctx, signal: new AbortController().signal };
+    void a1111Call(quiet, '/sdapi/v1/interrupt', { method: 'POST', timeoutMs: SIDE_CALL_TIMEOUT_MS }).catch(() => undefined);
+}
+export const A1111 = {
+    dialect: 'a1111',
+    kind: 'image',
+    async listModels(ctx) {
+        const models = await a1111Call(ctx, '/sdapi/v1/sd-models');
+        const samplers = await a1111Call(ctx, '/sdapi/v1/samplers', { accept: [404] });
+        return liveModelsFromA1111(models.json, samplers.status === 404 ? [] : samplers.json);
+    },
+    async generate(ctx, job, report) {
+        report({ phase: 'generating' });
+        if (job.workflow !== 'create' && job.workflow !== 'transform' && job.workflow !== 'inpaint')
+            throw remoteError('REMOTE_UNSUPPORTED', 'Automatic1111 cannot do that workflow here.', job.workflow);
+        const body = a1111Body(job);
+        const route = job.workflow === 'create' ? '/sdapi/v1/txt2img' : '/sdapi/v1/img2img';
+        const onAbort = () => interrupt(ctx);
+        ctx.signal.addEventListener('abort', onAbort, { once: true });
+        try {
+            const call = a1111Call(ctx, route, { json: body, timeoutMs: GENERATE_TIMEOUT_MS, accept: [500] });
+            void followProgress(ctx, call.then(() => undefined, () => undefined), report).catch(() => undefined);
+            const answer = await call;
+            if (answer.status === 500) {
+                // A1111 puts the exception class in `error` and its words in `errors`.
+                const fields = asObject(answer.json);
+                const said = [text(fields['error']), text(fields['errors']) ?? text(fields['detail'])]
+                    .filter(Boolean)
+                    .join(': ');
+                throw remoteHttpError(ctx.provider, 500, said ? { message: said } : answer.json, answer.text);
+            }
+            return a1111Images(ctx, answer.json, job.n);
+        }
+        finally {
+            ctx.signal.removeEventListener('abort', onAbort);
+        }
+    },
+};
+//# sourceMappingURL=a1111.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a1111.js","sourceRoot":"","sources":["../../../src/media/adapters/a1111.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAA;AAMnB,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAU,EAAE,CAC1C,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAgB,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/F,MAAM,IAAI,GAAG,CAAC,KAAc,EAAsB,EAAE,CAClD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAE7E,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACjC,8EAA8E;AAC9E,MAAM,oBAAoB,GAAG,MAAM,CAAA;AAEnC,2FAA2F;AAC3F,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;AACpE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,SAAS,CAAC,GAAmD;IAC3E,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC;QAAE,OAAO,EAAE,CAAA;IACvG,OAAO,EAAE,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAA;AAClF,CAAC;AAED,6EAA6E;AAC7E,KAAK,UAAU,SAAS,CAAC,GAAiB,EAAE,IAAY,EAAE,UAAuB,EAAE;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE;QAC5E,GAAG,OAAO;QACV,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;QAClD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC;KACzD,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAChD,MAAM,WAAW,CACf,uBAAuB,EACvB,GAAG,GAAG,CAAC,QAAQ,yEAAyE,EACxF,YAAY,IAAI,EAAE,CACnB,CAAA;IACH,OAAO,MAAM,CAAA;AACf,CAAC;AAED,8FAA8F;AAC9F,SAAS,SAAS,CAAC,GAAuB;IACxC,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;IAC5E,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAA;IAClC,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc;QACrE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,CAAA;IACnE,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,SAAS,CAAC,GAAuB;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA;IAC/B,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,EAAE,CAAA;IACvG,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,CAAA;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAA;IAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAA;IAC/C,IAAI,GAAG,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,CAAA;IAC9C,sEAAsE;IACtE,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAA;IAC1E,IAAI,GAAG,CAAC,OAAO;QAAE,IAAI,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,OAAO,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClF,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAClB,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAA;IACjE,IAAI,CAAC,sCAAsC,CAAC,GAAG,IAAI,CAAA;IACnD,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,aAAa,CAAC,GAAG,KAAK,CAAA;IAC3B,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM;YAAE,MAAM,WAAW,CAAC,oBAAoB,EAAE,qCAAqC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QACzG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QACvD,IAAI,CAAC,oBAAoB,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAA;IACnD,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,MAAM,WAAW,CAAC,oBAAoB,EAAE,0BAA0B,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QAChG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAA;QAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,GAAmC,EAAE,IAAa,EAAE,CAAS;IACvF,MAAM,MAAM,GAAG,CACb,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAe,CAAC,CAAC,CAAC,EAAE,CACvF,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAA;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAClF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/E,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,WAAW,CAAC,oBAAoB,EAAE,GAAG,GAAG,CAAC,QAAQ,6BAA6B,CAAC,CAAA;IAC3G,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,MAAe,EAAE,QAAiB;IACpE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SAC3C,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;IACvD,MAAM,GAAG,GAAqB,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;QAC5D,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAQ;QACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACZ,MAAM,KAAK,GAAmB,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;QAC3E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,GAAiB,EACjB,QAAuB,EACvB,MAA0C;IAE1C,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,KAAK,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;QACtB,IAAI,GAAG,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IACF,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC9B,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAClC,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ;YACD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;SAC3B,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,OAAM;QACzB,IAAI,MAAkB,CAAA;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,4CAA4C,EAAE;gBAC1E,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;gBAClB,SAAS,EAAE,oBAAoB;aAChC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;YAAE,OAAM;QAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAA;QAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;YAC3E,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACpE,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,SAAS,CAAC,GAAiB;IAClC,MAAM,KAAK,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM,EAAE,CAAA;IAC9D,KAAK,SAAS,CAAC,KAAK,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CACrG,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAiB;IACjC,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,OAAO;IAEb,KAAK,CAAC,UAAU,CAAC,GAAG;QAClB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9E,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM;QAC7B,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;QAC/B,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;YACzF,MAAM,WAAW,CAAC,oBAAoB,EAAE,6CAA6C,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtG,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAA;QACnF,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC1C,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACjG,KAAK,cAAc,CACjB,GAAG,EACH,IAAI,CAAC,IAAI,CACP,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,EACD,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAA;YACzB,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC1B,uEAAuE;gBACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACpC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;qBACnF,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAA;gBACb,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAC/F,CAAC;YACD,OAAO,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC7C,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;CACF,CAAA"}

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

@@ -0,0 +1,34 @@
+/**
+ * `aimlapi-videos`: AIMLAPI's video API. The provider is registered with `https://api.aimlapi.com/v1`;
+ * video lives on `/v2` of the same server, so `{video}` is the base with its trailing version
+ * segment swapped for `/v2/video/generations` (`https://api.aimlapi.com/v2/video/generations`).
+ *
+ * - submit: `POST {video}`, JSON `{model, prompt, duration, aspect_ratio, resolution, generate_audio,
+ *   seed, negative_prompt, image_url}` → `{id, status}`. The first frame goes as a data URL in
+ *   `image_url` (the field most of its image-to-video models take), or in the field the model's
+ *   `options.image_field` names; a last frame only into the field `options.last_frame_field` names.
+ * - poll: `GET {video}?generation_id={id}` → `queued | generating | completed | error` (also
+ *   `waiting`, `active`), `video: {url}`, `error: {name, message}`.
+ * - download: `video.url`, a file on AIMLAPI's CDN; off the API's origin it goes without the key.
+ * - models: `GET {base}/models`, the entries typed `internal/video-generations/submit`. An id that
+ *   says image to video (`-i2v`, `image-to-video`) takes only that workflow, one that says text to
+ *   video only `create`; models that need a video, references or a voice are left out.
+ *
+ * No cancel: AIMLAPI 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>;
+/** `POST`/`GET` URL of AIMLAPI's video API: the registered base with `/v2/video/generations` for its version. */
+export declare function aimlapiVideoUrl(baseUrl: string): string;
+/** The submit body: each field only when the job set it and the model offers it; frames as data URLs. */
+export declare function aimlapiVideoBody(job: VideoGenerationJob, provider?: string): Fields;
+/** A generation's `error: {name, message}` as the closest `REMOTE_*` code. */
+export declare function aimlapiVideoError(provider: string, error: unknown): AtomicCoreError;
+/** One generation answer (the submit's or a poll's) as a poll result. */
+export declare function readAimlapiVideo(provider: string, json: unknown): VideoPoll;
+/** The video models of AIMLAPI's `GET {base}/models`, with the workflow their id names. */
+export declare function aimlapiVideoModels(json: unknown): LiveMediaModel[];
+export declare const AIMLAPI_VIDEOS: VideoAdapter;
+export {};