pareta 0.1.0 → 1.0.0

package/dist/index.d.cts

@@ -11,9 +11,8 @@ interface SSEEvent {
  * typed layer.
  *
  * Alias / D3 boundary (a BACKEND contract, the SDK adds no alias logic):
- * `Endpoint.model`, `EvalResult.modelId`, leaderboard names and
- * `run.candidateModels` are per-task PUBLIC aliases — real open-weights ids
- * never cross. Frontier (vendor) ids are in the clear.
+ * `EvalResult.modelId` and `run.candidateModels` are per-task PUBLIC aliases —
+ * real open-weights ids never cross. Frontier (vendor) ids are in the clear.
  */
 type Raw = Record<string, any>;
 /** Base: holds the raw payload, dict-style escape hatches. */
@@ -63,19 +62,6 @@ declare class ModelList extends BaseModel implements Iterable<Model> {
     get length(): number;
     [Symbol.iterator](): Iterator<Model>;
 }
-/**
- * A deployed endpoint. `id` (== name) is what you pass to
- * `chat.completions.create({ model })`. `model` is the per-task public alias.
- */
-declare class Endpoint extends BaseModel {
-    get id(): string | null;
-    get name(): string | null;
-    get model(): string | null;
-    get status(): string | null;
-    get task(): string | null;
-    get url(): string | null;
-    get isLive(): boolean;
-}
 declare class Task extends BaseModel {
     get id(): string | null;
     get defaultScorer(): string | null;
@@ -102,6 +88,17 @@ declare class EvalSet extends BaseModel {
     get itemCount(): number | null;
     get scoringStrategy(): string | null;
 }
+/**
+ * One scored item inside `EvalResult.perItem`. `prediction` is the model's raw
+ * output, truncated server-side — present only on items that reached scoring
+ * (not pool/build errors), there to debug a 0.0 `score` without re-running.
+ */
+declare class EvalItemResult extends BaseModel {
+    get idx(): number | null;
+    get score(): number | null;
+    get prediction(): string | null;
+    get error(): string | null;
+}
 /**
  * One model's aggregate on an eval run. `modelId` is the per-task public alias;
  * `kind` ('open' | 'frontier') is populated by the Slice-4 result schema.
@@ -115,30 +112,15 @@ declare class EvalResult extends BaseModel {
     get meanCostMicroUsd(): number | null;
     get nSucceeded(): number | null;
     get errorCount(): number | null;
-}
-declare class LeaderboardEntry extends BaseModel {
-    get name(): string | null;
-    get kind(): string | null;
-    get quality(): number | null;
-    get costPerRequestMicroUsd(): number | null;
-    get contextK(): number | null;
-    get runMode(): string | null;
-}
-/** Models ranked for a task. `recommended` is the deployable pick; `frontier` the baseline. */
-declare class Leaderboard extends BaseModel {
-    get taskId(): string | null;
-    get metric(): string | null;
-    get costUnit(): string | null;
-    get recommended(): string | null;
-    get models(): LeaderboardEntry[];
-    get frontier(): LeaderboardEntry | null;
+    /** Per-item rows (idx/score/prediction/error); empty when not persisted. */
+    get perItem(): EvalItemResult[];
 }
 /** A vendor frontier model you can evaluate against (from the eval pool). */
 declare class FrontierModel extends BaseModel {
     get id(): string | null;
     get vendor(): string | null;
     get vision(): boolean;
-    /** Only meaningful when a task was given: it's on that task's leaderboard. */
+    /** Only meaningful when a task was given: it has benchmark results on that task. */
     get benchmarked(): boolean;
 }
 /**
@@ -164,9 +146,9 @@ declare class EvalRun extends BaseModel {
 /**
  * `client.chat.completions` — OpenAI-compatible chat completions.
  *
- * `model` is an endpoint id from `endpoints.deploy(...)` (or any model id the
- * caller's org can reach). The call is metered: a successful completion debits
- * the org's balance; a zero balance raises `InsufficientCreditsError` (402).
+ * `model` is `"auto"` — Pareta plans, routes, and verifies each request. The
+ * call is metered: a successful completion debits the org's balance; a zero
+ * balance raises `InsufficientCreditsError` (402).
  */
 
 /** An OpenAI-style chat message. `content` is a string or content-block array. */
@@ -177,7 +159,7 @@ interface ChatMessage {
 }
 /** Params for `chat.completions.create`. Extra OpenAI params pass through. */
 interface ChatCompletionCreateParams {
-    /** An endpoint id from `endpoints.deploy(...)`. */
+    /** `"auto"` — Pareta routes the request to the right model. */
     model: string;
     messages: ChatMessage[];
     stream?: boolean;
@@ -207,10 +189,9 @@ declare class Chat {
 }
 
 /**
- * `client.models` — list the deployed models (endpoints) your org can call.
- *
- * OpenAI-compatible: only deployed, url-bearing endpoints appear. Each
- * `Model.id` is an endpoint id usable as `chat.completions.create({ model })`.
+ * `client.models` — the OpenAI-compatible `/v1/models` list of model ids your
+ * org can call. Each `Model.id` is usable as
+ * `chat.completions.create({ model })`.
  */
 
 declare class Models {
@@ -220,70 +201,8 @@ declare class Models {
 }
 
 /**
- * `client.endpoints` — deploy, operate, and measure deployed endpoints.
- *
- * `deploy({ task, model })` is ergonomic: Pareta picks the GPU/serving config
- * (you never pass hardware) and `model` defaults to the task's recommended pick.
- * The backend resolver behind POST /v1/endpoints evolved with the discovery
- * work — verify the deploy body against staging when wiring real deploys.
- */
-
-/** Params for `endpoints.deploy`. Extra keys pass through to the deploy body. */
-interface DeployParams {
-    /** The task id to deploy a model for. */
-    task: string;
-    /** Model alias to deploy; defaults to "recommended" (the task's top pick). */
-    model?: string;
-    /** Optional endpoint name. */
-    name?: string;
-    /** If true, block through the deploy and resolve the live Endpoint. */
-    wait?: boolean;
-    [key: string]: unknown;
-}
-/**
- * `endpoints.metrics(id).performance()` etc. Each returns the raw metric JSON
- * (shapes vary by dimension; typed models arrive with the OpenAPI generation).
- */
-declare class EndpointMetrics {
-    private readonly client;
-    private readonly id;
-    constructor(client: Transport, id: string);
-    performance(params?: Record<string, unknown>): Promise<unknown>;
-    uptime(params?: Record<string, unknown>): Promise<unknown>;
-    cost(params?: Record<string, unknown>): Promise<unknown>;
-    quality(params?: Record<string, unknown>): Promise<unknown>;
-    activity(params?: Record<string, unknown>): Promise<unknown>;
-}
-declare class Endpoints {
-    private readonly client;
-    constructor(client: Transport);
-    /**
-     * Deploy a model for a task. `wait: false` (default) → an `AsyncIterable` of
-     * progress events (`{event, data}`); the terminal event is `complete`
-     * (`data.endpoint`) or `error`. `wait: true` → resolves the live `Endpoint`
-     * (throws `ParetaError` on a deploy `error` event).
-     */
-    deploy(params: DeployParams & {
-        wait: true;
-    }): Promise<Endpoint>;
-    deploy(params: DeployParams & {
-        wait?: false;
-    }): AsyncIterable<SSEEvent>;
-    private waitForDeploy;
-    list(): Promise<Endpoint[]>;
-    retrieve(endpointId: string): Promise<Endpoint>;
-    start(endpointId: string): Promise<unknown>;
-    stop(endpointId: string): Promise<unknown>;
-    delete(endpointId: string): Promise<void>;
-    metrics(endpointId: string): EndpointMetrics;
-}
-
-/**
- * `client.tasks` — browse the benchmark catalog + match free-text intent, and
- * the per-task discovery surface (leaderboard / recommended).
- *
- * Unlike the Python SDK (where `leaderboard`/`recommended` exist only on the
- * sync client), these are present uniformly here — JS has one client.
+ * `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).
  */
 
 declare class Tasks {
@@ -297,10 +216,6 @@ declare class Tasks {
     match(query: string, opts?: {
         topK?: number;
     }): Promise<TaskMatch>;
-    /** Models ranked by quality/cost for a task (+ recommended + frontier baseline). */
-    leaderboard(taskId: string): Promise<Leaderboard>;
-    /** The task's recommended deployable model — what deploy(model:"recommended") resolves to. */
-    recommended(taskId: string): Promise<string | null>;
 }
 
 /**
@@ -378,6 +293,79 @@ declare class Evals {
     frontierModels(task?: string): Promise<FrontierModel[]>;
 }
 
+/**
+ * `client.auto` — the routing brain's surrounding surfaces.
+ *
+ * Calling the brain itself is plain chat with `model: "auto"`:
+ *
+ *   client.chat.completions.create({
+ *     model: "auto",
+ *     messages: [{ role: "user", content: "…" }],
+ *   })
+ *
+ * This resource carries the org-level metrics rollup (requests, success,
+ * spend, PROJECTED savings vs frontier) and the metered frontier comparison
+ * the Playground uses.
+ */
+
+interface AutoMetrics {
+    requests_30d: number;
+    requests_today: number;
+    success_rate_30d: number | null;
+    billed_micro_usd_30d: number;
+    billed_micro_usd_today: number;
+    cost_to_serve_micro_usd_30d: number;
+    /** PROJECTED (frontier list-priced counterfactual) — labeled so until
+     * dual-run calibration lands. */
+    savings_vs_frontier_micro_usd_30d: number | null;
+    savings_multiple_30d: number | null;
+    performance_hourly_7d: Array<{
+        hour: string;
+        requests: number;
+        error_rate: number;
+        p50_ms: number | null;
+        p95_ms: number | null;
+    }>;
+    days_30d: Array<{
+        day: string;
+        n: number;
+        ok: number;
+        success_rate: number;
+    }>;
+    last_request: {
+        created_at: string;
+        status_code: number;
+        duration_ms: number;
+        billed_micro_usd: number | null;
+        cost_to_serve_micro_usd: number | null;
+    } | null;
+}
+interface FrontierComparison {
+    model: string;
+    content: string;
+    cost_micro_usd: number;
+    latency_ms: number;
+}
+declare class Auto {
+    private readonly client;
+    constructor(client: Transport);
+    /** Your org's `model: "auto"` traffic, rolled up. Read-only, free. */
+    metrics(): Promise<AutoMetrics>;
+    /**
+     * One prompt against a frontier vendor for a side-by-side with
+     * `model: "auto"` — METERED at the vendor's actual token cost (a failed
+     * vendor call bills $0). Allowed models: gpt-5.5, gemini-3-5-flash,
+     * gemini-3-1-pro, claude-sonnet-4-6.
+     */
+    compareFrontier(params: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    }): Promise<FrontierComparison>;
+}
+
 /**
  * The `Pareta` client — one class (no sync/async split; JS is Promise-only).
  * A faithful port of the Python `_client.py` transport: header construction,
@@ -429,9 +417,9 @@ declare class Pareta implements Transport {
     private readonly fetchImpl;
     readonly chat: Chat;
     readonly models: Models;
-    readonly endpoints: Endpoints;
     readonly tasks: Tasks;
     readonly evals: Evals;
+    readonly auto: Auto;
     constructor(options?: ParetaOptions);
     /** Build from PARETA_API_KEY (+ optional PARETA_BASE_URL); explicit opts win. */
     static fromEnv(options?: ParetaOptions): Pareta;
@@ -450,12 +438,12 @@ declare class Pareta implements Transport {
     /**
      * Yield parsed SSE objects. Retries ONLY the initial connect/handshake — once
      * bytes are flowing a mid-stream drop raises (re-issuing would re-run a
-     * metered generation / re-trigger a deploy). `events:true` → `{event,data}`.
+     * metered generation). `events:true` → `{event,data}`.
      */
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION = "1.0.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -470,7 +458,7 @@ declare const VERSION = "0.1.0";
  *   402 → InsufficientCreditsError ("organization is out of credit…")
  *   403 → PermissionDeniedError
  *   404 → NotFoundError
- *   409 → ConflictError            (seed/legacy endpoint not deployed)
+ *   409 → ConflictError            (resource conflict / not servable)
  *   422 → BadRequestError          (FastAPI validation; `detail` is an array)
  *   429 → RateLimitError
  *   503 → EndpointNotReadyError    (stopped / cold / provider down)
@@ -547,4 +535,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, type DeployParams, Endpoint, EndpointMetrics, EndpointNotReadyError, type ErrorDetail, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, InsufficientCreditsError, Leaderboard, LeaderboardEntry, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, type SSEEvent, Task, TaskMatch, TaskMatchCandidate, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, 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, type SSEEvent, Task, TaskMatch, TaskMatchCandidate, type Transport, Usage, VERSION, type ValidationErrorItem };

package/dist/index.d.ts

@@ -11,9 +11,8 @@ interface SSEEvent {
  * typed layer.
  *
  * Alias / D3 boundary (a BACKEND contract, the SDK adds no alias logic):
- * `Endpoint.model`, `EvalResult.modelId`, leaderboard names and
- * `run.candidateModels` are per-task PUBLIC aliases — real open-weights ids
- * never cross. Frontier (vendor) ids are in the clear.
+ * `EvalResult.modelId` and `run.candidateModels` are per-task PUBLIC aliases —
+ * real open-weights ids never cross. Frontier (vendor) ids are in the clear.
  */
 type Raw = Record<string, any>;
 /** Base: holds the raw payload, dict-style escape hatches. */
@@ -63,19 +62,6 @@ declare class ModelList extends BaseModel implements Iterable<Model> {
     get length(): number;
     [Symbol.iterator](): Iterator<Model>;
 }
-/**
- * A deployed endpoint. `id` (== name) is what you pass to
- * `chat.completions.create({ model })`. `model` is the per-task public alias.
- */
-declare class Endpoint extends BaseModel {
-    get id(): string | null;
-    get name(): string | null;
-    get model(): string | null;
-    get status(): string | null;
-    get task(): string | null;
-    get url(): string | null;
-    get isLive(): boolean;
-}
 declare class Task extends BaseModel {
     get id(): string | null;
     get defaultScorer(): string | null;
@@ -102,6 +88,17 @@ declare class EvalSet extends BaseModel {
     get itemCount(): number | null;
     get scoringStrategy(): string | null;
 }
+/**
+ * One scored item inside `EvalResult.perItem`. `prediction` is the model's raw
+ * output, truncated server-side — present only on items that reached scoring
+ * (not pool/build errors), there to debug a 0.0 `score` without re-running.
+ */
+declare class EvalItemResult extends BaseModel {
+    get idx(): number | null;
+    get score(): number | null;
+    get prediction(): string | null;
+    get error(): string | null;
+}
 /**
  * One model's aggregate on an eval run. `modelId` is the per-task public alias;
  * `kind` ('open' | 'frontier') is populated by the Slice-4 result schema.
@@ -115,30 +112,15 @@ declare class EvalResult extends BaseModel {
     get meanCostMicroUsd(): number | null;
     get nSucceeded(): number | null;
     get errorCount(): number | null;
-}
-declare class LeaderboardEntry extends BaseModel {
-    get name(): string | null;
-    get kind(): string | null;
-    get quality(): number | null;
-    get costPerRequestMicroUsd(): number | null;
-    get contextK(): number | null;
-    get runMode(): string | null;
-}
-/** Models ranked for a task. `recommended` is the deployable pick; `frontier` the baseline. */
-declare class Leaderboard extends BaseModel {
-    get taskId(): string | null;
-    get metric(): string | null;
-    get costUnit(): string | null;
-    get recommended(): string | null;
-    get models(): LeaderboardEntry[];
-    get frontier(): LeaderboardEntry | null;
+    /** Per-item rows (idx/score/prediction/error); empty when not persisted. */
+    get perItem(): EvalItemResult[];
 }
 /** A vendor frontier model you can evaluate against (from the eval pool). */
 declare class FrontierModel extends BaseModel {
     get id(): string | null;
     get vendor(): string | null;
     get vision(): boolean;
-    /** Only meaningful when a task was given: it's on that task's leaderboard. */
+    /** Only meaningful when a task was given: it has benchmark results on that task. */
     get benchmarked(): boolean;
 }
 /**
@@ -164,9 +146,9 @@ declare class EvalRun extends BaseModel {
 /**
  * `client.chat.completions` — OpenAI-compatible chat completions.
  *
- * `model` is an endpoint id from `endpoints.deploy(...)` (or any model id the
- * caller's org can reach). The call is metered: a successful completion debits
- * the org's balance; a zero balance raises `InsufficientCreditsError` (402).
+ * `model` is `"auto"` — Pareta plans, routes, and verifies each request. The
+ * call is metered: a successful completion debits the org's balance; a zero
+ * balance raises `InsufficientCreditsError` (402).
  */
 
 /** An OpenAI-style chat message. `content` is a string or content-block array. */
@@ -177,7 +159,7 @@ interface ChatMessage {
 }
 /** Params for `chat.completions.create`. Extra OpenAI params pass through. */
 interface ChatCompletionCreateParams {
-    /** An endpoint id from `endpoints.deploy(...)`. */
+    /** `"auto"` — Pareta routes the request to the right model. */
     model: string;
     messages: ChatMessage[];
     stream?: boolean;
@@ -207,10 +189,9 @@ declare class Chat {
 }
 
 /**
- * `client.models` — list the deployed models (endpoints) your org can call.
- *
- * OpenAI-compatible: only deployed, url-bearing endpoints appear. Each
- * `Model.id` is an endpoint id usable as `chat.completions.create({ model })`.
+ * `client.models` — the OpenAI-compatible `/v1/models` list of model ids your
+ * org can call. Each `Model.id` is usable as
+ * `chat.completions.create({ model })`.
  */
 
 declare class Models {
@@ -220,70 +201,8 @@ declare class Models {
 }
 
 /**
- * `client.endpoints` — deploy, operate, and measure deployed endpoints.
- *
- * `deploy({ task, model })` is ergonomic: Pareta picks the GPU/serving config
- * (you never pass hardware) and `model` defaults to the task's recommended pick.
- * The backend resolver behind POST /v1/endpoints evolved with the discovery
- * work — verify the deploy body against staging when wiring real deploys.
- */
-
-/** Params for `endpoints.deploy`. Extra keys pass through to the deploy body. */
-interface DeployParams {
-    /** The task id to deploy a model for. */
-    task: string;
-    /** Model alias to deploy; defaults to "recommended" (the task's top pick). */
-    model?: string;
-    /** Optional endpoint name. */
-    name?: string;
-    /** If true, block through the deploy and resolve the live Endpoint. */
-    wait?: boolean;
-    [key: string]: unknown;
-}
-/**
- * `endpoints.metrics(id).performance()` etc. Each returns the raw metric JSON
- * (shapes vary by dimension; typed models arrive with the OpenAPI generation).
- */
-declare class EndpointMetrics {
-    private readonly client;
-    private readonly id;
-    constructor(client: Transport, id: string);
-    performance(params?: Record<string, unknown>): Promise<unknown>;
-    uptime(params?: Record<string, unknown>): Promise<unknown>;
-    cost(params?: Record<string, unknown>): Promise<unknown>;
-    quality(params?: Record<string, unknown>): Promise<unknown>;
-    activity(params?: Record<string, unknown>): Promise<unknown>;
-}
-declare class Endpoints {
-    private readonly client;
-    constructor(client: Transport);
-    /**
-     * Deploy a model for a task. `wait: false` (default) → an `AsyncIterable` of
-     * progress events (`{event, data}`); the terminal event is `complete`
-     * (`data.endpoint`) or `error`. `wait: true` → resolves the live `Endpoint`
-     * (throws `ParetaError` on a deploy `error` event).
-     */
-    deploy(params: DeployParams & {
-        wait: true;
-    }): Promise<Endpoint>;
-    deploy(params: DeployParams & {
-        wait?: false;
-    }): AsyncIterable<SSEEvent>;
-    private waitForDeploy;
-    list(): Promise<Endpoint[]>;
-    retrieve(endpointId: string): Promise<Endpoint>;
-    start(endpointId: string): Promise<unknown>;
-    stop(endpointId: string): Promise<unknown>;
-    delete(endpointId: string): Promise<void>;
-    metrics(endpointId: string): EndpointMetrics;
-}
-
-/**
- * `client.tasks` — browse the benchmark catalog + match free-text intent, and
- * the per-task discovery surface (leaderboard / recommended).
- *
- * Unlike the Python SDK (where `leaderboard`/`recommended` exist only on the
- * sync client), these are present uniformly here — JS has one client.
+ * `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).
  */
 
 declare class Tasks {
@@ -297,10 +216,6 @@ declare class Tasks {
     match(query: string, opts?: {
         topK?: number;
     }): Promise<TaskMatch>;
-    /** Models ranked by quality/cost for a task (+ recommended + frontier baseline). */
-    leaderboard(taskId: string): Promise<Leaderboard>;
-    /** The task's recommended deployable model — what deploy(model:"recommended") resolves to. */
-    recommended(taskId: string): Promise<string | null>;
 }
 
 /**
@@ -378,6 +293,79 @@ declare class Evals {
     frontierModels(task?: string): Promise<FrontierModel[]>;
 }
 
+/**
+ * `client.auto` — the routing brain's surrounding surfaces.
+ *
+ * Calling the brain itself is plain chat with `model: "auto"`:
+ *
+ *   client.chat.completions.create({
+ *     model: "auto",
+ *     messages: [{ role: "user", content: "…" }],
+ *   })
+ *
+ * This resource carries the org-level metrics rollup (requests, success,
+ * spend, PROJECTED savings vs frontier) and the metered frontier comparison
+ * the Playground uses.
+ */
+
+interface AutoMetrics {
+    requests_30d: number;
+    requests_today: number;
+    success_rate_30d: number | null;
+    billed_micro_usd_30d: number;
+    billed_micro_usd_today: number;
+    cost_to_serve_micro_usd_30d: number;
+    /** PROJECTED (frontier list-priced counterfactual) — labeled so until
+     * dual-run calibration lands. */
+    savings_vs_frontier_micro_usd_30d: number | null;
+    savings_multiple_30d: number | null;
+    performance_hourly_7d: Array<{
+        hour: string;
+        requests: number;
+        error_rate: number;
+        p50_ms: number | null;
+        p95_ms: number | null;
+    }>;
+    days_30d: Array<{
+        day: string;
+        n: number;
+        ok: number;
+        success_rate: number;
+    }>;
+    last_request: {
+        created_at: string;
+        status_code: number;
+        duration_ms: number;
+        billed_micro_usd: number | null;
+        cost_to_serve_micro_usd: number | null;
+    } | null;
+}
+interface FrontierComparison {
+    model: string;
+    content: string;
+    cost_micro_usd: number;
+    latency_ms: number;
+}
+declare class Auto {
+    private readonly client;
+    constructor(client: Transport);
+    /** Your org's `model: "auto"` traffic, rolled up. Read-only, free. */
+    metrics(): Promise<AutoMetrics>;
+    /**
+     * One prompt against a frontier vendor for a side-by-side with
+     * `model: "auto"` — METERED at the vendor's actual token cost (a failed
+     * vendor call bills $0). Allowed models: gpt-5.5, gemini-3-5-flash,
+     * gemini-3-1-pro, claude-sonnet-4-6.
+     */
+    compareFrontier(params: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    }): Promise<FrontierComparison>;
+}
+
 /**
  * The `Pareta` client — one class (no sync/async split; JS is Promise-only).
  * A faithful port of the Python `_client.py` transport: header construction,
@@ -429,9 +417,9 @@ declare class Pareta implements Transport {
     private readonly fetchImpl;
     readonly chat: Chat;
     readonly models: Models;
-    readonly endpoints: Endpoints;
     readonly tasks: Tasks;
     readonly evals: Evals;
+    readonly auto: Auto;
     constructor(options?: ParetaOptions);
     /** Build from PARETA_API_KEY (+ optional PARETA_BASE_URL); explicit opts win. */
     static fromEnv(options?: ParetaOptions): Pareta;
@@ -450,12 +438,12 @@ declare class Pareta implements Transport {
     /**
      * Yield parsed SSE objects. Retries ONLY the initial connect/handshake — once
      * bytes are flowing a mid-stream drop raises (re-issuing would re-run a
-     * metered generation / re-trigger a deploy). `events:true` → `{event,data}`.
+     * metered generation). `events:true` → `{event,data}`.
      */
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION = "1.0.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -470,7 +458,7 @@ declare const VERSION = "0.1.0";
  *   402 → InsufficientCreditsError ("organization is out of credit…")
  *   403 → PermissionDeniedError
  *   404 → NotFoundError
- *   409 → ConflictError            (seed/legacy endpoint not deployed)
+ *   409 → ConflictError            (resource conflict / not servable)
  *   422 → BadRequestError          (FastAPI validation; `detail` is an array)
  *   429 → RateLimitError
  *   503 → EndpointNotReadyError    (stopped / cold / provider down)
@@ -547,4 +535,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, type DeployParams, Endpoint, EndpointMetrics, EndpointNotReadyError, type ErrorDetail, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, InsufficientCreditsError, Leaderboard, LeaderboardEntry, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, type SSEEvent, Task, TaskMatch, TaskMatchCandidate, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, 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, type SSEEvent, Task, TaskMatch, TaskMatchCandidate, type Transport, Usage, VERSION, type ValidationErrorItem };