@runappsai/sdk 0.0.0-stage → 0.3.0

package/dist/image.d.ts

@@ -0,0 +1,185 @@
+import type { Transport } from "./transport.js";
+import type { Usage } from "./types.js";
+import type { SDKEvents } from "./events.js";
+/**
+ * Image generation request.
+ *
+ * Sizing: prefer the 2-axis `resolution` + `aspect_ratio` controls —
+ * the gateway translates them into a concrete WxH from the target
+ * model's declared size enum. `size` is the legacy explicit override;
+ * when set, it wins over `(resolution, aspect_ratio)`. When none of
+ * the three is set, the gateway / upstream applies its own default.
+ */
+export interface ImageGenerateParams {
+    prompt: string;
+    /** Legacy explicit "WxH" override. Prefer `resolution` +
+     *  `aspect_ratio` for new code. */
+    size?: string;
+    /** Short-side pixel tier — "512P" | "1K" | "2K" | "4K".
+     *  Model-specific subset; `/v1/models` advertises which tiers each
+     *  image model supports. */
+    resolution?: string;
+    /** Output shape — "1:1" | "9:16" | "16:9" | "3:4" | "4:3" | "3:2"
+     *  | "2:3" | "5:4" | "4:5" | "21:9" | "adaptive". Model-specific
+     *  subset; see `/v1/models`. */
+    aspect_ratio?: string;
+    n?: number;
+    style?: string;
+    reference_image_urls?: string[];
+    user?: string;
+    /**
+     * Pass-through for provider-specific knobs.
+     *
+     * Note: `quality` (OpenAI's render-quality preset
+     * — "low"/"medium"/"high"/"auto") was removed from the canonical
+     * surface. Only one upstream used it and its own default ("auto") is
+     * already optimal; the field caused naming confusion with the
+     * "画质" resolution-tier control. The gateway silently drops it
+     * from inbound requests, so legacy callers keep working.
+     */
+    [extra: string]: unknown;
+}
+/**
+ * Single generated image. `url` carries the bytes via one of two
+ * transport modes — `<img src={url}>` works for both:
+ *   - "https://api.runapps.ai/v1/blobs/<id>" — async / hosted blob
+ *   - "data:<mime>;base64,<payload>"        — sync / inline
+ *
+ * `decodeMediaUrl(url)` resolves either shape into `Uint8Array` +
+ * mime type when raw bytes are wanted (file save, post-process).
+ *
+ * `size` is the actual dimensions of this image — Seedream sequential
+ * generation may produce results different from the requested size.
+ */
+export interface ImageResult {
+    url: string;
+    revised_prompt?: string;
+    size?: string;
+    /**
+     * Human-readable credit line that the client SHOULD display
+     * alongside the image. Populated by stock-library models (Pexels)
+     * whose terms of service require crediting the photographer;
+     * AI-generation models leave it empty. Render verbatim — don't
+     * try to parse the format.
+     *
+     * Example: "Photo by Jane Doe on Pexels (https://www.pexels.com/photo/12345/)"
+     */
+    attribution?: string;
+}
+export interface ImageUsage extends Usage {
+    generated_images?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    /** Tool name → invocation count (e.g. Seedream 5.0 lite web_search). */
+    tool_usage?: Record<string, number>;
+}
+export interface ImageResponse {
+    created: number;
+    data: ImageResult[];
+    usage: ImageUsage;
+}
+/**
+ * Status payload returned by the resumable async-image endpoints
+ * (`/v1/async/images/generations` and friends). Returned verbatim by
+ * `submitGenerate()` (job is still queued / running), and again by
+ * `getAsyncStatus()` (status may now be terminal — `data[]` is
+ * populated when `status === 'succeeded'`).
+ *
+ * The fully-managed `generateAsync()` hides this type behind an
+ * `ImageResponse`; `submitGenerate` + `getAsyncStatus` expose it for
+ * callers who need to PERSIST the job id (e.g. resume polling across
+ * a page refresh, drive their own UI progress, etc.).
+ */
+export interface AsyncImageJob {
+    id: string;
+    status: "queued" | "running" | "succeeded" | "failed" | (string & {});
+    data?: ImageResult[];
+    usage?: ImageUsage;
+    error?: string;
+    /** Unix epoch seconds — same semantics as VideoStatus.created_at /
+     *  current_time. Pair to compute server-truth elapsed. */
+    created_at?: number;
+    current_time?: number;
+}
+/** Minimal interface for an image / mask file passed to `edit()`. */
+export interface ImageFileInput {
+    /** File contents — Blob, ArrayBuffer, Uint8Array, or string. */
+    data: Blob | ArrayBuffer | Uint8Array | string;
+    /** File name including extension (sent in the multipart field). */
+    filename: string;
+    /** Optional MIME type — inferred from the extension when omitted. */
+    contentType?: string;
+}
+export interface ImageEditParams {
+    image: ImageFileInput;
+    mask?: ImageFileInput;
+    prompt: string;
+    size?: string;
+    n?: number;
+    user?: string;
+}
+export declare class ImageService {
+    private readonly transport;
+    private readonly events;
+    constructor(transport: Transport, events: SDKEvents);
+    /**
+     * Generate images from a text prompt via the synchronous endpoint.
+     * For long-running requests (large Seedream batches, slow upstreams)
+     * use `generateAsync()` to avoid 100-second origin timeouts.
+     */
+    generate(model: string, params: ImageGenerateParams, init?: {
+        signal?: AbortSignal;
+    }): Promise<ImageResponse>;
+    /**
+     * Async equivalent of `generate()`. Submits a job to
+     * `/v1/async/images/generations`, polls `/v1/async/images/generations/:id`
+     * until terminal, then resolves to a sync-shape `ImageResponse`. Use
+     * this when a request may exceed the ~100s origin timeout (Cloudflare
+     * otherwise replaces the real upstream error with its own 502 page).
+     *
+     * Implementation is `submitGenerate` + `getAsyncStatus` poll loop, so
+     * the path layout matches the rest of the async API (`/v1/async/...`
+     * everywhere). The caller's `signal` aborts both the submit and the
+     * poll wait; `pollIntervalMs` defaults to 2s.
+     */
+    generateAsync(model: string, params: ImageGenerateParams, init?: {
+        signal?: AbortSignal;
+        pollIntervalMs?: number;
+    }): Promise<ImageResponse>;
+    /**
+     * Submit-only variant of `generate()`. Returns the gateway's job
+     * descriptor (`id`, `status`, `usage`) without polling. Use this
+     * when you want to PERSIST the job id and resume polling later
+     * (e.g. across page reloads, in a separate worker process). Pair
+     * with `getAsyncStatus(id)` to drive the polling loop yourself.
+     *
+     * For a one-shot "submit and wait" call site, use `generateAsync()`
+     * — that wraps the same underlying endpoint with a built-in poll.
+     *
+     * Telemetry note: only the SUBMIT step fires start/end on
+     * `client.events` — the per-call latency reflects the gateway
+     * accepting the job, NOT how long the upstream takes to render.
+     * Track render progress via your own poll loop's status responses.
+     */
+    submitGenerate(model: string, params: ImageGenerateParams, init?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncImageJob>;
+    /**
+     * Single poll of an in-flight async image job. Returns the same
+     * shape `submitGenerate()` returned, with `data[]` populated once
+     * `status` flips to `succeeded`. Caller decides cadence + bail-out;
+     * the gateway's per-poll `current_time` / `created_at` together
+     * give a server-truth elapsed reading regardless of client clock skew.
+     */
+    getAsyncStatus(id: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncImageJob>;
+    /**
+     * Edit an image (inpaint / outpaint / variations) via multipart upload.
+     * Provider-dependent — only available on `gpt-image-1` and similar.
+     */
+    edit(model: string, params: ImageEditParams, init?: {
+        signal?: AbortSignal;
+    }): Promise<ImageResponse>;
+}
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

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

package/dist/image.js

@@ -0,0 +1,148 @@
+import { wrapEvents } from "./event-wrap.js";
+/* ------------------------------------------------------------------ */
+export class ImageService {
+    transport;
+    events;
+    constructor(transport, events) {
+        this.transport = transport;
+        this.events = events;
+    }
+    /**
+     * Generate images from a text prompt via the synchronous endpoint.
+     * For long-running requests (large Seedream batches, slow upstreams)
+     * use `generateAsync()` to avoid 100-second origin timeouts.
+     */
+    async generate(model, params, init) {
+        return wrapEvents(this.events, { model, capability: "image_generation" }, () => this.transport.postJSON("/v1/images/generations", { model, ...params }, init), (r) => ({ costUSD: r.usage?.total_cost }));
+    }
+    /**
+     * Async equivalent of `generate()`. Submits a job to
+     * `/v1/async/images/generations`, polls `/v1/async/images/generations/:id`
+     * until terminal, then resolves to a sync-shape `ImageResponse`. Use
+     * this when a request may exceed the ~100s origin timeout (Cloudflare
+     * otherwise replaces the real upstream error with its own 502 page).
+     *
+     * Implementation is `submitGenerate` + `getAsyncStatus` poll loop, so
+     * the path layout matches the rest of the async API (`/v1/async/...`
+     * everywhere). The caller's `signal` aborts both the submit and the
+     * poll wait; `pollIntervalMs` defaults to 2s.
+     */
+    async generateAsync(model, params, init) {
+        const interval = init?.pollIntervalMs ?? 2000;
+        const signal = init?.signal;
+        return wrapEvents(this.events, { model, capability: "image_generation" }, async () => {
+            const job = await this.transport.postJSON("/v1/async/images/generations", { model, ...params }, { signal });
+            let current = job;
+            while (current.status !== "succeeded" && current.status !== "failed") {
+                await sleep(interval, signal);
+                current = await this.getAsyncStatus(current.id, { signal });
+            }
+            if (current.status === "failed") {
+                throw new Error(current.error ?? "image generation failed");
+            }
+            return {
+                created: current.created_at ?? Math.floor(Date.now() / 1000),
+                data: current.data ?? [],
+                usage: current.usage ?? { total_cost: 0 },
+            };
+        }, (r) => ({ costUSD: r.usage?.total_cost }));
+    }
+    /**
+     * Submit-only variant of `generate()`. Returns the gateway's job
+     * descriptor (`id`, `status`, `usage`) without polling. Use this
+     * when you want to PERSIST the job id and resume polling later
+     * (e.g. across page reloads, in a separate worker process). Pair
+     * with `getAsyncStatus(id)` to drive the polling loop yourself.
+     *
+     * For a one-shot "submit and wait" call site, use `generateAsync()`
+     * — that wraps the same underlying endpoint with a built-in poll.
+     *
+     * Telemetry note: only the SUBMIT step fires start/end on
+     * `client.events` — the per-call latency reflects the gateway
+     * accepting the job, NOT how long the upstream takes to render.
+     * Track render progress via your own poll loop's status responses.
+     */
+    async submitGenerate(model, params, init) {
+        return wrapEvents(this.events, { model, capability: "image_generation" }, () => this.transport.postJSON("/v1/async/images/generations", { model, ...params }, init));
+    }
+    /**
+     * Single poll of an in-flight async image job. Returns the same
+     * shape `submitGenerate()` returned, with `data[]` populated once
+     * `status` flips to `succeeded`. Caller decides cadence + bail-out;
+     * the gateway's per-poll `current_time` / `created_at` together
+     * give a server-truth elapsed reading regardless of client clock skew.
+     */
+    async getAsyncStatus(id, init) {
+        return this.transport.getJSON(`/v1/async/images/generations/${encodeURIComponent(id)}`, init);
+    }
+    /**
+     * Edit an image (inpaint / outpaint / variations) via multipart upload.
+     * Provider-dependent — only available on `gpt-image-1` and similar.
+     */
+    async edit(model, params, init) {
+        const form = buildEditForm(model, params);
+        return wrapEvents(this.events, { model, capability: "image_edit" }, () => this.transport.postMultipart("/v1/images/edits", form, init), (r) => ({ costUSD: r.usage?.total_cost }));
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error("aborted"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason ?? new Error("aborted"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function buildEditForm(model, params) {
+    const form = new FormData();
+    form.set("model", model);
+    form.set("prompt", params.prompt);
+    if (params.size)
+        form.set("size", params.size);
+    if (params.n !== undefined)
+        form.set("n", String(params.n));
+    if (params.user)
+        form.set("user", params.user);
+    form.set("image", toBlob(params.image), params.image.filename);
+    if (params.mask)
+        form.set("mask", toBlob(params.mask), params.mask.filename);
+    return form;
+}
+/** Internal: coerce ImageFileInput to a Blob the multipart layer accepts. */
+function toBlob(input) {
+    const ct = input.contentType ?? guessMime(input.filename);
+    if (input.data instanceof Blob) {
+        return input.data.type === ct ? input.data : new Blob([input.data], { type: ct });
+    }
+    if (typeof input.data === "string") {
+        return new Blob([input.data], { type: ct });
+    }
+    // ArrayBuffer | Uint8Array — wrap in Blob. Cast widens TS's strict
+    // Uint8Array<ArrayBuffer> back to BlobPart (it's accepted at runtime).
+    return new Blob([input.data], { type: ct });
+}
+function guessMime(filename) {
+    const ext = filename.toLowerCase().split(".").pop() ?? "";
+    switch (ext) {
+        case "png":
+            return "image/png";
+        case "jpg":
+        case "jpeg":
+            return "image/jpeg";
+        case "webp":
+            return "image/webp";
+        case "gif":
+            return "image/gif";
+        default:
+            return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA8H7C,wEAAwE;AAExE,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAAoB,EACpB,MAAiB;QADjB,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAW;IACjC,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,MAA2B,EAC3B,IAA+B;QAE/B,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,EACzC,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,wBAAwB,EACxB,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACpB,IAAI,CACL,EACH,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,MAA2B,EAC3B,IAAwD;QAExD,MAAM,QAAQ,GAAG,IAAI,EAAE,cAAc,IAAI,IAAI,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;QAC5B,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,EACzC,KAAK,IAAI,EAAE;YACT,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CACvC,8BAA8B,EAC9B,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACpB,EAAE,MAAM,EAAE,CACX,CAAC;YACF,IAAI,OAAO,GAAG,GAAG,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrE,MAAM,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC9B,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAC5D,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE;aAClB,CAAC;QAC5B,CAAC,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,MAA2B,EAC3B,IAA+B;QAE/B,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,EACzC,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,8BAA8B,EAC9B,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACpB,IAAI,CACL,CACJ,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,IAA+B;QAE/B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3B,gCAAgC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxD,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,KAAa,EACb,MAAuB,EACvB,IAA+B;QAE/B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,EACnC,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC,aAAa,CAC1B,kBAAkB,EAClB,IAAI,EACJ,IAAI,CACL,EACH,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAO,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,MAAuB;IAC3D,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI;QAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,IAAI;QAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,IAAI;QAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,SAAS,MAAM,CAAC,KAAqB;IACnC,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,mEAAmE;IACnE,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC1D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RunApps SDK for JavaScript / TypeScript.
+ *
+ * Top-level entry point — exports the `RunApps` client class plus all
+ * public types so callers can write strongly-typed wrappers without
+ * reaching into per-service modules.
+ */
+export { RunApps, RunApps as Client, RunApps as RunJobs, type ClientOptions, type AuthProvider } from "./client.js";
+export { SDKEvents, newRequestId, type RequestStartEvent, type RequestStreamDeltaEvent, type RequestEndEvent, type RequestErrorEvent, type SDKEventMap, type SDKCapability, type Unsubscribe, } from "./events.js";
+export { ActivityTracker, type ActiveCall, type CompletedCall, type SessionStats, type ActivitySnapshot, } from "./activity-tracker.js";
+export { BrowserAuth, type BrowserAuthOptions, type BrowserUser } from "./browser-auth.js";
+export { APIError } from "./errors.js";
+export type { Usage } from "./types.js";
+export type { ChatMessage, ContentPart, ChatTool, StreamOptions, ChatCompletionParams, ChatToolCall, ChatChoiceMessage, ChatChoice, ChatCompletion, ChatChunkDelta, ChatChunkChoice, ChatCompletionChunk, } from "./chat.js";
+export { userMessage, systemMessage, assistantMessage, toolResultMessage, userMessageParts, textPart, imagePart, videoPart, audioPart, } from "./chat.js";
+export type { Model, ModelListOptions, Tag } from "./models.js";
+export { hasCapabilityTag, acceptsModality, supportsVoiceClone, supportsInstructText, defaultVoice, } from "./models.js";
+export type { Schema, FieldSchema, Constraint, ConstraintKind, Catalog, } from "./model_options.js";
+export { getOptionsSchema, acceptsField, requiresField, allowedValuesFor, } from "./model_options.js";
+export type { ValidationError } from "./validate.js";
+export { validateRequest } from "./validate.js";
+export type { ImageGenerateParams, ImageResult, ImageUsage, ImageResponse, ImageEditParams, ImageFileInput, AsyncImageJob, } from "./image.js";
+export type { SpeechParams, SpeechResponse, TranscribeParams, TranscribeResponse, AudioFileInput, } from "./audio.js";
+export type { VideoGenerateParams, VideoTask, VideoStatus, VideoUsageTokens, WaitOptions, } from "./video.js";
+export { encodeImageUrl, decodeMediaUrl } from "./media.js";
+export type { ComputerStepParams, ComputerContentBlock, ComputerResponse, } from "./computer.js";
+export type { FileObject, FileListResult, PutOptions as FilePutOptions, ListOptions as FileListOptions, PutFromURLOptions as FilePutFromURLOptions, BatchOp as FileBatchOp, BatchResult as FileBatchResult, } from "./files.js";
+export type { EmbeddingsParams, Embedding, EmbeddingsUsage, EmbeddingsResponse, } from "./embeddings.js";
+export { ServerTools, type ServerToolName } from "./chat.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAOpH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,YAAY,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,cAAc,EACd,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5D,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,IAAI,cAAc,EAC5B,WAAW,IAAI,eAAe,EAC9B,iBAAiB,IAAI,qBAAqB,EAC1C,OAAO,IAAI,WAAW,EACtB,WAAW,IAAI,eAAe,GAC/B,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * RunApps SDK for JavaScript / TypeScript.
+ *
+ * Top-level entry point — exports the `RunApps` client class plus all
+ * public types so callers can write strongly-typed wrappers without
+ * reaching into per-service modules.
+ */
+export { RunApps, RunApps as Client, RunApps as RunJobs } from "./client.js";
+// SDK telemetry — `client.events` fires these around every LLM-ish
+// service call so UI overlays (the badge being the canonical example)
+// can render real-time state. The ActivityTracker turns the raw
+// stream into the snapshot the badge reads each frame; exported
+// alongside the bus so power users can build their own status UI.
+export { SDKEvents, newRequestId, } from "./events.js";
+export { ActivityTracker, } from "./activity-tracker.js";
+export { BrowserAuth } from "./browser-auth.js";
+export { APIError } from "./errors.js";
+export { userMessage, systemMessage, assistantMessage, toolResultMessage, userMessageParts, textPart, imagePart, videoPart, audioPart, } from "./chat.js";
+export { hasCapabilityTag, acceptsModality, supportsVoiceClone, supportsInstructText, defaultVoice, } from "./models.js";
+export { getOptionsSchema, acceptsField, requiresField, allowedValuesFor, } from "./model_options.js";
+export { validateRequest } from "./validate.js";
+// Media helpers (shared by image + video + chat-multimodal)
+export { encodeImageUrl, decodeMediaUrl } from "./media.js";
+// Server-tool names for chat.create({ server_tools }), with autocomplete.
+export { ServerTools } from "./chat.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,OAAO,EAAyC,MAAM,aAAa,CAAC;AAEpH,mEAAmE;AACnE,sEAAsE;AACtE,gEAAgE;AAChE,gEAAgE;AAChE,kEAAkE;AAClE,OAAO,EACL,SAAS,EACT,YAAY,GAQb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,GAKhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAA6C,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAkBvC,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AAInB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA+BhD,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA4B5D,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAuB,MAAM,WAAW,CAAC"}

package/dist/media.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Media helpers shared by image / video / chat-multimodal endpoints.
+ *
+ * The gateway accepts media payloads as `data:<mime>;base64,<payload>`
+ * URIs on every `*_url` field — `encodeImageUrl` is the bridge from
+ * raw bytes to that wire format. Replaces the deprecated `*_b64` SDK
+ * fields, which were removed in favour of routing every payload
+ * through `*_url`.
+ */
+/**
+ * Wrap raw image bytes as a `data:<mime>;base64,<payload>` URI.
+ *
+ * MIME is sniffed from the magic bytes (PNG / JPEG / GIF / WebP). On
+ * unrecognised input we default to `application/octet-stream` — most
+ * upstreams accept and re-sniff server-side.
+ *
+ * @param bytes Image bytes — `Uint8Array`, `ArrayBuffer`, or `Blob`.
+ * @returns A data: URI suitable for any `*_url` field on the gateway.
+ *
+ * @example
+ * ```ts
+ * import { encodeImageUrl } from "@runjobs/sdk";
+ * const png = await fs.readFile("frame.png");
+ * await client.video.generate("Veo 3.1", {
+ *   prompt: "...",
+ *   first_frame_url: encodeImageUrl(png),
+ * });
+ * ```
+ */
+export declare function encodeImageUrl(bytes: Uint8Array | ArrayBuffer | Blob): string;
+/**
+ * Resolve a media URL to raw bytes plus the declared mime label.
+ *
+ * Inverse of `encodeImageUrl`. Two transport modes handled:
+ *   - "data:<mime>;base64,<payload>"  — decode the inline payload
+ *   - "https://...", "http://..."     — `fetch()` + `.arrayBuffer()`,
+ *                                       mime from the response's
+ *                                       `Content-Type` header
+ *
+ * Returns `{bytes: Uint8Array, contentType: string}`. Pairs with
+ * `encodeImageUrl` so callers can round-trip bytes through the gateway
+ * without thinking about which transport mode the response chose.
+ *
+ * @example
+ * ```ts
+ * import { decodeMediaUrl } from "@runjobs/sdk";
+ * const job = await client.image.generateAsync("Seedream 5.0", {...});
+ * const { bytes, contentType } = await decodeMediaUrl(job.data[0].url);
+ * await fs.writeFile("out.png", bytes);
+ * ```
+ */
+export declare function decodeMediaUrl(url: string): Promise<{
+    bytes: Uint8Array;
+    contentType: string;
+}>;
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GACrC,MAAM,CA4BR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBrD"}

package/dist/media.js

@@ -0,0 +1,133 @@
+/**
+ * Media helpers shared by image / video / chat-multimodal endpoints.
+ *
+ * The gateway accepts media payloads as `data:<mime>;base64,<payload>`
+ * URIs on every `*_url` field — `encodeImageUrl` is the bridge from
+ * raw bytes to that wire format. Replaces the deprecated `*_b64` SDK
+ * fields, which were removed in favour of routing every payload
+ * through `*_url`.
+ */
+/**
+ * Wrap raw image bytes as a `data:<mime>;base64,<payload>` URI.
+ *
+ * MIME is sniffed from the magic bytes (PNG / JPEG / GIF / WebP). On
+ * unrecognised input we default to `application/octet-stream` — most
+ * upstreams accept and re-sniff server-side.
+ *
+ * @param bytes Image bytes — `Uint8Array`, `ArrayBuffer`, or `Blob`.
+ * @returns A data: URI suitable for any `*_url` field on the gateway.
+ *
+ * @example
+ * ```ts
+ * import { encodeImageUrl } from "@runjobs/sdk";
+ * const png = await fs.readFile("frame.png");
+ * await client.video.generate("Veo 3.1", {
+ *   prompt: "...",
+ *   first_frame_url: encodeImageUrl(png),
+ * });
+ * ```
+ */
+export function encodeImageUrl(bytes) {
+    // Normalize to Uint8Array so the rest of the function is uniform.
+    if (bytes instanceof Blob) {
+        throw new Error("encodeImageUrl: Blob input requires async; await blob.arrayBuffer() and pass the result instead");
+    }
+    const u8 = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+    const mime = sniffImageMime(u8);
+    // btoa(String.fromCharCode(...u8)) blows the stack on large arrays;
+    // chunk to keep arg count bounded. 0x8000 is the conventional safe
+    // limit on JS engines.
+    const CHUNK = 0x8000;
+    let binary = "";
+    for (let i = 0; i < u8.length; i += CHUNK) {
+        binary += String.fromCharCode.apply(null, Array.from(u8.subarray(i, i + CHUNK)));
+    }
+    // btoa is browser-native and shimmed in Node ≥ 16 globalThis.
+    const b64 = globalThis.btoa
+        ? globalThis.btoa(binary)
+        : Buffer.from(binary, "binary").toString("base64");
+    return `data:${mime};base64,${b64}`;
+}
+/**
+ * Resolve a media URL to raw bytes plus the declared mime label.
+ *
+ * Inverse of `encodeImageUrl`. Two transport modes handled:
+ *   - "data:<mime>;base64,<payload>"  — decode the inline payload
+ *   - "https://...", "http://..."     — `fetch()` + `.arrayBuffer()`,
+ *                                       mime from the response's
+ *                                       `Content-Type` header
+ *
+ * Returns `{bytes: Uint8Array, contentType: string}`. Pairs with
+ * `encodeImageUrl` so callers can round-trip bytes through the gateway
+ * without thinking about which transport mode the response chose.
+ *
+ * @example
+ * ```ts
+ * import { decodeMediaUrl } from "@runjobs/sdk";
+ * const job = await client.image.generateAsync("Seedream 5.0", {...});
+ * const { bytes, contentType } = await decodeMediaUrl(job.data[0].url);
+ * await fs.writeFile("out.png", bytes);
+ * ```
+ */
+export async function decodeMediaUrl(url) {
+    if (url.startsWith("data:")) {
+        const rest = url.slice(5);
+        const semi = rest.indexOf(";");
+        const comma = rest.indexOf(",");
+        if (semi === -1 || comma === -1 || comma < semi) {
+            throw new Error("decodeMediaUrl: malformed data URI");
+        }
+        const mime = rest.slice(0, semi);
+        const b64 = rest.slice(comma + 1);
+        return { bytes: base64ToBytes(b64), contentType: mime };
+    }
+    if (url.startsWith("http://") || url.startsWith("https://")) {
+        const resp = await fetch(url);
+        if (!resp.ok) {
+            throw new Error(`decodeMediaUrl: upstream ${resp.status}`);
+        }
+        const buf = await resp.arrayBuffer();
+        return {
+            bytes: new Uint8Array(buf),
+            contentType: resp.headers.get("Content-Type") ?? "",
+        };
+    }
+    throw new Error(`decodeMediaUrl: unsupported url scheme: ${url.slice(0, 32)}`);
+}
+/** Decode standard base64 to Uint8Array. Browser `atob` + Node `Buffer`
+ *  fallback — same impl as the audio service uses internally. */
+function base64ToBytes(b64) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(b64, "base64"));
+    }
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+/**
+ * Sniff a small set of image mimes from magic bytes. Mirrors the
+ * gateway's own sniff so encode / decode round-trip lands on the same
+ * label.
+ */
+function sniffImageMime(b) {
+    if (b.length >= 8 &&
+        b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47) {
+        return "image/png";
+    }
+    if (b.length >= 3 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff) {
+        return "image/jpeg";
+    }
+    if (b.length >= 6 &&
+        b[0] === 0x47 && b[1] === 0x49 && b[2] === 0x46 && b[3] === 0x38) {
+        return "image/gif";
+    }
+    if (b.length >= 12 &&
+        b[0] === 0x52 && b[1] === 0x49 && b[2] === 0x46 && b[3] === 0x46 &&
+        b[8] === 0x57 && b[9] === 0x45 && b[10] === 0x42 && b[11] === 0x50) {
+        return "image/webp";
+    }
+    return "application/octet-stream";
+}
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAsC;IAEtC,kEAAkE;IAClE,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAEvE,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAEhC,oEAAoE;IACpE,mEAAmE;IACnE,uBAAuB;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC1C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CACjC,IAAI,EACJ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CACtC,CAAC;IACJ,CAAC;IACD,8DAA8D;IAC9D,MAAM,GAAG,GAAI,UAA+C,CAAC,IAAI;QAC/D,CAAC,CAAE,UAA8C,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErD,OAAO,QAAQ,IAAI,WAAW,GAAG,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW;IAEX,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,KAAK,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC;YAC1B,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;SACpD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;iEACiE;AACjE,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,CAAa;IACnC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE;QACd,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAChE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACvE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,0BAA0B,CAAC;AACpC,CAAC"}