pareta 1.2.0 → 1.4.0

package/dist/index.d.cts

@@ -187,6 +187,19 @@ declare class Speech extends BaseModel {
     /** Write the decoded audio to `path` (Node only — lazy node:fs). */
     save(path: string): Promise<this>;
 }
+/** Image result from `images.generate(...)`. `.image` is decoded PNG bytes;
+ * `.size` is the ACTUAL delivered size. Billed flat per image (the
+ * `X-Pareta-Billed` response header carries the receipt). */
+declare class ImageGeneration extends BaseModel {
+    /** The generated image, base64-decoded to raw PNG bytes. */
+    get image(): Uint8Array;
+    get b64Json(): string | null;
+    get size(): string | null;
+    get model(): string | null;
+    get created(): number | null;
+    /** Write the decoded PNG to `path` (Node only — lazy node:fs). */
+    save(path: string): Promise<this>;
+}
 
 /**
  * `client.chat.completions` — OpenAI-compatible chat completions.
@@ -246,8 +259,10 @@ declare class Models {
 }
 
 /**
- * `client.tasks` — browse the benchmark catalog and match free-text intent to
- * a task (`match` is the discovery surface: it tells you what Pareta can do).
+ * `client.tasks` — the grading-contract directory for evals. A task names how
+ * a dataset is scored (row shape + scorer); inference never takes one. `match`
+ * maps a plain-English description of your dataset to the contract that
+ * grades it — feed the matched task id into `evals.runs.create(task=...)`.
  */
 
 declare class Tasks {
@@ -452,6 +467,56 @@ declare class Audio {
     speech(text: string, opts?: SpeechOptions): Promise<Speech>;
 }
 
+/**
+ * `pa.images` — the image capability lanes (generate + edit), TS parity with
+ * the Python SDK's `client.images`.
+ *
+ * Dedicated routes, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?}       -> {created, model,
+ *                                                                data: [{b64_json}], size}
+ *   POST /v1/images/edits       {prompt, image (b64), seed?} -> same shape
+ *
+ * Both run on Pareta's open image model (`hidream-1`) and are metered at a
+ * FLAT price per call — generation by image (every size costs the same;
+ * the model renders at full 2K internally), editing by edit (the output
+ * keeps the reference's aspect ratio). The `X-Pareta-Billed` response
+ * header carries the per-request receipt in micro-USD. Delivery sizes for
+ * generation (server-authoritative): 1024x1024 (default), 2048x2048,
+ * 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ *
+ * Edit input follows the audio FileInput convention: a string is a FILE
+ * PATH (read via lazy node:fs — browser/edge bundles stay clean);
+ * Blob/ArrayBuffer/Uint8Array are raw bytes; `{ base64 }` passes
+ * pre-encoded image data through untouched.
+ */
+
+type ImageInput = string | Blob | ArrayBuffer | Uint8Array | {
+    base64: string;
+};
+interface ImageGenerateOptions {
+    /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
+    size?: string;
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
+interface ImageEditOptions {
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
+declare class Images {
+    private readonly client;
+    constructor(client: Transport);
+    /** Generate one image from a text prompt. Returns an `ImageGeneration`
+     * whose `.image` is decoded PNG bytes (`.save(path)` writes a file in
+     * Node). Billed flat per image. */
+    generate(prompt: string, opts?: ImageGenerateOptions): Promise<ImageGeneration>;
+    /** Edit one reference image with a plain-language instruction (no mask).
+     * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+     * decoded). The output keeps the reference's aspect ratio. Billed flat
+     * per edit. */
+    edit(image: ImageInput, prompt: string, opts?: ImageEditOptions): Promise<ImageGeneration>;
+}
+
 /**
  * `pa.rerank(...)` + `pa.embeddings(...)` — the Retrieval capability lanes
  * (the RAG stack: embeddings for recall, reranking for precision).
@@ -462,7 +527,7 @@ declare class Audio {
  *   POST /v1/embeddings  {input[], input_type?}       -> unit-normalized vectors
  *
  * Rerank is metered per document scored; embeddings per input token. You never
- * pick a serving model — Pareta resolves the lane (`pareta-rerank-1` / `bge-1`),
+ * pick a serving model — Pareta resolves the lane (`pareta-rerank-1` / `qwen-embed-1`),
  * exactly as `model:"auto"` does for chat.
  *
  * Exposed as callable client fields (`pa.rerank(...)`) rather than resource
@@ -540,6 +605,8 @@ declare class Pareta implements Transport {
     readonly rerank: RerankFn;
     /** Text embeddings (the Retrieval recall lane) — `pa.embeddings(input, {inputType})`. */
     readonly embeddings: EmbeddingsFn;
+    /** Image generation — `pa.images.generate(prompt, {size, seed})`, flat price per image. */
+    readonly images: Images;
     constructor(options?: ParetaOptions);
     /** Build from PARETA_API_KEY (+ optional PARETA_BASE_URL); explicit opts win. */
     static fromEnv(options?: ParetaOptions): Pareta;
@@ -563,7 +630,7 @@ declare class Pareta implements Transport {
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "1.2.0";
+declare const VERSION = "1.4.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -655,4 +722,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageEditOptions, type ImageGenerateOptions, ImageGeneration, type ImageInput, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };

package/dist/index.d.ts

@@ -187,6 +187,19 @@ declare class Speech extends BaseModel {
     /** Write the decoded audio to `path` (Node only — lazy node:fs). */
     save(path: string): Promise<this>;
 }
+/** Image result from `images.generate(...)`. `.image` is decoded PNG bytes;
+ * `.size` is the ACTUAL delivered size. Billed flat per image (the
+ * `X-Pareta-Billed` response header carries the receipt). */
+declare class ImageGeneration extends BaseModel {
+    /** The generated image, base64-decoded to raw PNG bytes. */
+    get image(): Uint8Array;
+    get b64Json(): string | null;
+    get size(): string | null;
+    get model(): string | null;
+    get created(): number | null;
+    /** Write the decoded PNG to `path` (Node only — lazy node:fs). */
+    save(path: string): Promise<this>;
+}
 
 /**
  * `client.chat.completions` — OpenAI-compatible chat completions.
@@ -246,8 +259,10 @@ declare class Models {
 }
 
 /**
- * `client.tasks` — browse the benchmark catalog and match free-text intent to
- * a task (`match` is the discovery surface: it tells you what Pareta can do).
+ * `client.tasks` — the grading-contract directory for evals. A task names how
+ * a dataset is scored (row shape + scorer); inference never takes one. `match`
+ * maps a plain-English description of your dataset to the contract that
+ * grades it — feed the matched task id into `evals.runs.create(task=...)`.
  */
 
 declare class Tasks {
@@ -452,6 +467,56 @@ declare class Audio {
     speech(text: string, opts?: SpeechOptions): Promise<Speech>;
 }
 
+/**
+ * `pa.images` — the image capability lanes (generate + edit), TS parity with
+ * the Python SDK's `client.images`.
+ *
+ * Dedicated routes, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?}       -> {created, model,
+ *                                                                data: [{b64_json}], size}
+ *   POST /v1/images/edits       {prompt, image (b64), seed?} -> same shape
+ *
+ * Both run on Pareta's open image model (`hidream-1`) and are metered at a
+ * FLAT price per call — generation by image (every size costs the same;
+ * the model renders at full 2K internally), editing by edit (the output
+ * keeps the reference's aspect ratio). The `X-Pareta-Billed` response
+ * header carries the per-request receipt in micro-USD. Delivery sizes for
+ * generation (server-authoritative): 1024x1024 (default), 2048x2048,
+ * 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ *
+ * Edit input follows the audio FileInput convention: a string is a FILE
+ * PATH (read via lazy node:fs — browser/edge bundles stay clean);
+ * Blob/ArrayBuffer/Uint8Array are raw bytes; `{ base64 }` passes
+ * pre-encoded image data through untouched.
+ */
+
+type ImageInput = string | Blob | ArrayBuffer | Uint8Array | {
+    base64: string;
+};
+interface ImageGenerateOptions {
+    /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
+    size?: string;
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
+interface ImageEditOptions {
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
+declare class Images {
+    private readonly client;
+    constructor(client: Transport);
+    /** Generate one image from a text prompt. Returns an `ImageGeneration`
+     * whose `.image` is decoded PNG bytes (`.save(path)` writes a file in
+     * Node). Billed flat per image. */
+    generate(prompt: string, opts?: ImageGenerateOptions): Promise<ImageGeneration>;
+    /** Edit one reference image with a plain-language instruction (no mask).
+     * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+     * decoded). The output keeps the reference's aspect ratio. Billed flat
+     * per edit. */
+    edit(image: ImageInput, prompt: string, opts?: ImageEditOptions): Promise<ImageGeneration>;
+}
+
 /**
  * `pa.rerank(...)` + `pa.embeddings(...)` — the Retrieval capability lanes
  * (the RAG stack: embeddings for recall, reranking for precision).
@@ -462,7 +527,7 @@ declare class Audio {
  *   POST /v1/embeddings  {input[], input_type?}       -> unit-normalized vectors
  *
  * Rerank is metered per document scored; embeddings per input token. You never
- * pick a serving model — Pareta resolves the lane (`pareta-rerank-1` / `bge-1`),
+ * pick a serving model — Pareta resolves the lane (`pareta-rerank-1` / `qwen-embed-1`),
  * exactly as `model:"auto"` does for chat.
  *
  * Exposed as callable client fields (`pa.rerank(...)`) rather than resource
@@ -540,6 +605,8 @@ declare class Pareta implements Transport {
     readonly rerank: RerankFn;
     /** Text embeddings (the Retrieval recall lane) — `pa.embeddings(input, {inputType})`. */
     readonly embeddings: EmbeddingsFn;
+    /** Image generation — `pa.images.generate(prompt, {size, seed})`, flat price per image. */
+    readonly images: Images;
     constructor(options?: ParetaOptions);
     /** Build from PARETA_API_KEY (+ optional PARETA_BASE_URL); explicit opts win. */
     static fromEnv(options?: ParetaOptions): Pareta;
@@ -563,7 +630,7 @@ declare class Pareta implements Transport {
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "1.2.0";
+declare const VERSION = "1.4.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -655,4 +722,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageEditOptions, type ImageGenerateOptions, ImageGeneration, type ImageInput, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };

package/dist/index.mjs

@@ -172,7 +172,7 @@ function parseSSE(reader, opts) {
 }
 
 // src/version.ts
-var VERSION = "1.2.0";
+var VERSION = "1.4.0";
 
 // src/money.ts
 var MICRO_PER_CENT = 10000n;
@@ -531,6 +531,32 @@ var Speech = class extends BaseModel {
     return this;
   }
 };
+var ImageGeneration = class extends BaseModel {
+  /** The generated image, base64-decoded to raw PNG bytes. */
+  get image() {
+    const b64 = this.b64Json ?? "";
+    return b64 ? base64ToBytes(b64) : new Uint8Array(0);
+  }
+  get b64Json() {
+    const data = this.raw.data ?? [];
+    return data[0]?.b64_json ?? null;
+  }
+  get size() {
+    return this.raw.size ?? null;
+  }
+  get model() {
+    return this.raw.model ?? null;
+  }
+  get created() {
+    return this.raw.created ?? null;
+  }
+  /** Write the decoded PNG to `path` (Node only — lazy node:fs). */
+  async save(path) {
+    const { writeFile } = await import('fs/promises');
+    await writeFile(path, this.image);
+    return this;
+  }
+};
 
 // src/resources/chat.ts
 var PATH = "/v1/chat/completions";
@@ -887,6 +913,56 @@ var Audio = class {
   }
 };
 
+// src/resources/images.ts
+var PATH3 = "/v1/images/generations";
+var EDIT_PATH = "/v1/images/edits";
+async function toBase642(image) {
+  if (typeof image === "string") {
+    const { readFile } = await import('fs/promises');
+    return bytesToBase64(new Uint8Array(await readFile(image)));
+  }
+  if (typeof image === "object" && image !== null && "base64" in image) {
+    if (!image.base64 || !image.base64.trim()) throw new ParetaError("image.base64 is empty");
+    return image.base64;
+  }
+  if (image instanceof Blob) return bytesToBase64(new Uint8Array(await image.arrayBuffer()));
+  const bytes = image instanceof Uint8Array ? image : new Uint8Array(image);
+  if (bytes.byteLength === 0) throw new ParetaError("image is empty");
+  return bytesToBase64(bytes);
+}
+var Images = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Generate one image from a text prompt. Returns an `ImageGeneration`
+   * whose `.image` is decoded PNG bytes (`.save(path)` writes a file in
+   * Node). Billed flat per image. */
+  generate(prompt, opts = {}) {
+    if (!prompt || !prompt.trim()) throw new ParetaError("prompt is required");
+    const body = { prompt };
+    if (opts.size) body.size = opts.size;
+    if (opts.seed !== void 0) body.seed = opts.seed;
+    return this.client.request("POST", PATH3, {
+      body,
+      cast: (raw) => new ImageGeneration(raw)
+    });
+  }
+  /** Edit one reference image with a plain-language instruction (no mask).
+   * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+   * decoded). The output keeps the reference's aspect ratio. Billed flat
+   * per edit. */
+  async edit(image, prompt, opts = {}) {
+    if (!prompt || !prompt.trim()) throw new ParetaError("prompt is required");
+    const body = { prompt, image: await toBase642(image) };
+    if (opts.seed !== void 0) body.seed = opts.seed;
+    return this.client.request("POST", EDIT_PATH, {
+      body,
+      cast: (raw) => new ImageGeneration(raw)
+    });
+  }
+};
+
 // src/resources/retrieval.ts
 function makeRerank(client) {
   return (query, documents, opts = {}) => {
@@ -953,6 +1029,8 @@ var Pareta = class _Pareta {
   rerank;
   /** Text embeddings (the Retrieval recall lane) — `pa.embeddings(input, {inputType})`. */
   embeddings;
+  /** Image generation — `pa.images.generate(prompt, {size, seed})`, flat price per image. */
+  images;
   constructor(options = {}) {
     if (!options.apiKey) {
       throw new ParetaError(
@@ -976,6 +1054,7 @@ var Pareta = class _Pareta {
     this.audio = new Audio(this);
     this.rerank = makeRerank(this);
     this.embeddings = makeEmbeddings(this);
+    this.images = new Images(this);
   }
   /** Build from PARETA_API_KEY (+ optional PARETA_BASE_URL); explicit opts win. */
   static fromEnv(options = {}) {
@@ -1156,6 +1235,6 @@ var Pareta = class _Pareta {
   }
 };
 
-export { APIConnectionError, APIStatusError, APITimeoutError, Audio, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, Choice, ConflictError, Embeddings, EndpointNotReadyError, EvalItemResult, EvalResult, EvalRun, EvalRuns, EvalSet, EvalSets, FrontierModel, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, PermissionDeniedError, RateLimitError, Rerank, RerankResult, Speech, Task, TaskMatch, TaskMatchCandidate, Transcription, Usage, VERSION };
+export { APIConnectionError, APIStatusError, APITimeoutError, Audio, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, Choice, ConflictError, Embeddings, EndpointNotReadyError, EvalItemResult, EvalResult, EvalRun, EvalRuns, EvalSet, EvalSets, FrontierModel, ImageGeneration, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, PermissionDeniedError, RateLimitError, Rerank, RerankResult, Speech, Task, TaskMatch, TaskMatchCandidate, Transcription, Usage, VERSION };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map