@autorag/librarian 2.10.0 → 2.10.1

package/dist/cloud/config.d.ts

@@ -10,6 +10,24 @@ export declare const API_PATH = "/v1";
 export declare const MODELS_PATH = "/v1/models";
 export declare const AUTHORIZE_PATH = "/desktop/authorize";
 export declare const TOKEN_PATH = "/api/desktop/token";
+/**
+ * Request limits of the hosted API, declared on every `autorag` model.
+ *
+ * The API is served from Vercel, which rejects a request body above about
+ * 4.49 MB with HTTP 413 before it reaches the model (measured against
+ * `POST /v1/responses`). pi resends every image a tool returned on each later
+ * turn, so a search that reads a few photos crosses that line. The transcript
+ * cap leaves headroom for the tool declarations and request framing the
+ * transcript size does not count; the resize cap keeps one image well below it.
+ */
+export declare const AUTORAG_INPUT_LIMITS: {
+    readonly maxRequestBytes: 3500000;
+    readonly images: {
+        readonly resize: {
+            readonly maxBytes: 1000000;
+        };
+    };
+};
 /** OAuth client identifier for the AutoRAG agent (Pi-compatible hosts use `pi`). */
 export declare const OAUTH_CLIENT_ID = "agent";
 /**

package/dist/cloud/jev-backend.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Jev backend for the hosted AutoRAG (Dazzi) plan.
+ *
+ * The server answers Jev's native dialect at `POST <root>/v1/jev` behind the
+ * account bearer key (`AUTORAG_API_KEY`), returning the same `answers` map the
+ * TypeSafe and OpenRouter backends do. `jev-use`'s package index does not
+ * export its native-dialect helpers, so the small mapping and the retrying JSON
+ * transport are reimplemented here against that documented dialect (covered by
+ * tests against a local HTTP server).
+ *
+ * Failures surface as `BackendError(name, "HTTP <status>: <message>", status)`
+ * so the engine degrades to an escalation with a readable hint instead of
+ * blocking the loop.
+ */
+import { type BackendRequest, type BackendResponse, type JevBackend, type Question, type RawAnswer, type State } from "jev-use";
+/** API path appended to the normalized server root. */
+export declare const JEV_PATH = "/v1/jev";
+/** Live Jev model id on the hosted AutoRAG plan. */
+export declare const AUTORAG_DEFAULT_JEV_MODEL = "jev-1.13";
+/** Options for {@link AutoragJevBackend}. */
+export interface AutoragJevBackendOptions {
+    /** Environment holding the bearer key and `AUTORAG_BASE_URL`. Default `process.env`. */
+    readonly env?: Record<string, string | undefined>;
+    /** Explicit bearer key; when omitted, read from `AUTORAG_API_KEY`. */
+    readonly apiKey?: string;
+    /** Override the server root (test seam); defaults to `resolveBaseUrl(env)`. */
+    readonly baseUrl?: string;
+    /** Model used when a call names none. @default AUTORAG_DEFAULT_JEV_MODEL */
+    readonly defaultModel?: string;
+    /** Abort one attempt after this long. @default 10_000 */
+    readonly timeoutMs?: number;
+    /** Retries on 408/429/5xx and network failures. @default 2 */
+    readonly maxRetries?: number;
+    /** Injection seam for tests. */
+    readonly fetchImpl?: typeof fetch;
+}
+type NativeWireQuestion = {
+    type: "noul";
+    instructions: string;
+    criteria?: {
+        true: string;
+        false: string;
+    };
+} | {
+    type: "choice";
+    instructions: string;
+    criteria: Record<string, string>;
+} | {
+    type: "score";
+    instructions: string;
+    criteria: string[];
+};
+interface NativeBody {
+    model: string;
+    state: string;
+    questions: Record<string, NativeWireQuestion>;
+}
+/**
+ * Jev backend served by the hosted AutoRAG (Dazzi) plan.
+ *
+ * The constructor throws a named error when no account key is configured — a
+ * missing credential must be loud, never a silent fake judgment — and the retry
+ * policy mirrors `jev-use`'s own remote backends (408/429/5xx, `Retry-After`).
+ */
+export declare class AutoragJevBackend implements JevBackend {
+    readonly name = "autorag";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly fetchImpl;
+    constructor(options?: AutoragJevBackendOptions);
+    judge(request: BackendRequest): Promise<BackendResponse>;
+    /** POST JSON with a per-attempt timeout and jev-use's retry policy. */
+    private postJson;
+}
+/** Build the whole request body: model, a string state, and the questions by id. */
+export declare function toNativeBody(state: State, questions: (Question & {
+    id: string;
+})[], model: string): NativeBody;
+/**
+ * Read the provider's answer map back into raw answers, in question order.
+ * Anything missing or mistyped is a `BackendError` — a silently dropped answer
+ * would read as a low-confidence judgment.
+ */
+export declare function parseNativeAnswers(backend: string, answers: unknown, questions: (Question & {
+    id: string;
+})[]): RawAnswer[];
+export {};