pareta 1.2.0 → 1.3.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,37 @@ declare class Audio {
     speech(text: string, opts?: SpeechOptions): Promise<Speech>;
 }
 
+/**
+ * `pa.images` — the image-generation capability lane, TS parity with the
+ * Python SDK's `client.images`.
+ *
+ * Dedicated route, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?} -> {created, model,
+ *                                                          data: [{b64_json}], size}
+ *
+ * Generation runs on Pareta's open image model (`hidream-1`) and is metered
+ * at a FLAT price per image — every size costs the same (the model renders
+ * at full 2K quality internally regardless of the delivery size). The
+ * `X-Pareta-Billed` response header carries the per-request receipt in
+ * micro-USD. Delivery sizes today (server-authoritative): 1024x1024
+ * (default), 2048x2048, 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ */
+
+interface ImageGenerateOptions {
+    /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
+    size?: string;
+    /** 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>;
+}
+
 /**
  * `pa.rerank(...)` + `pa.embeddings(...)` — the Retrieval capability lanes
  * (the RAG stack: embeddings for recall, reranking for precision).
@@ -462,7 +508,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 +586,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 +611,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.3.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -655,4 +703,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 ImageGenerateOptions, ImageGeneration, 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,37 @@ declare class Audio {
     speech(text: string, opts?: SpeechOptions): Promise<Speech>;
 }
 
+/**
+ * `pa.images` — the image-generation capability lane, TS parity with the
+ * Python SDK's `client.images`.
+ *
+ * Dedicated route, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?} -> {created, model,
+ *                                                          data: [{b64_json}], size}
+ *
+ * Generation runs on Pareta's open image model (`hidream-1`) and is metered
+ * at a FLAT price per image — every size costs the same (the model renders
+ * at full 2K quality internally regardless of the delivery size). The
+ * `X-Pareta-Billed` response header carries the per-request receipt in
+ * micro-USD. Delivery sizes today (server-authoritative): 1024x1024
+ * (default), 2048x2048, 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ */
+
+interface ImageGenerateOptions {
+    /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
+    size?: string;
+    /** 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>;
+}
+
 /**
  * `pa.rerank(...)` + `pa.embeddings(...)` — the Retrieval capability lanes
  * (the RAG stack: embeddings for recall, reranking for precision).
@@ -462,7 +508,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 +586,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 +611,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.3.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -655,4 +703,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 ImageGenerateOptions, ImageGeneration, 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.3.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,28 @@ var Audio = class {
   }
 };
 
+// src/resources/images.ts
+var PATH3 = "/v1/images/generations";
+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)
+    });
+  }
+};
+
 // src/resources/retrieval.ts
 function makeRerank(client) {
   return (query, documents, opts = {}) => {
@@ -953,6 +1001,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 +1026,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 +1207,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