@providerkit/core 0.1.0

package/dist/errors.js

@@ -0,0 +1,356 @@
+// One error shape for every provider, classified once.
+//
+// `kind` drives the four decisions a caller actually makes — retry it? try a
+// different model? rotate the key? what do we tell the user? — so no call site
+// ever string-matches an SDK message again.
+//
+// The ordering is the hard-won part. Providers file the same root cause under
+// whatever status they like: quota exhaustion arrives as 429 (OpenAI), 402
+// (DeepSeek), 403 (xAI) and 400 (Anthropic). So for the 4xx family the BODY is
+// read before the status — status alone gives the wrong advice ("retry" for an
+// empty balance, "check your key" for a plan that never included the API).
+/** Worth a cheap retry on the same key and model. */
+const TRANSIENT = new Set([
+    "timeout",
+    "network",
+    "overload",
+    "rate",
+]);
+/** Worth walking to a backup MODEL rather than just waiting. A throttle and an
+ *  overload are per-model-endpoint; nothing else on this list is. */
+const BACKUP_ELIGIBLE = new Set(["overload", "rate"]);
+export function isTransient(kind) {
+    return TRANSIENT.has(kind);
+}
+export function isBackupEligible(kind) {
+    return BACKUP_ELIGIBLE.has(kind);
+}
+export class ProviderError extends Error {
+    provider;
+    kind;
+    status;
+    code;
+    /** Honoured when the provider said how long to wait (Retry-After, or
+     *  Gemini's RetryInfo.retryDelay). */
+    retryAfterMs;
+    /** The provider's own response body, truncated — the actual reason, which is
+     *  otherwise lost behind "400 status code (no body)". */
+    body;
+    constructor(provider, kind, message, opts = {}) {
+        super(message, { cause: opts.cause });
+        this.name = "ProviderError";
+        this.provider = provider;
+        this.kind = kind;
+        this.status = opts.status;
+        this.code = opts.code;
+        this.retryAfterMs = opts.retryAfterMs;
+        this.body = opts.body;
+    }
+    get isTransient() {
+        return isTransient(this.kind);
+    }
+    get isBackupEligible() {
+        return isBackupEligible(this.kind);
+    }
+    /** Wrap anything thrown into a classified ProviderError. Already-wrapped
+     *  errors pass through untouched, so classification happens exactly once. */
+    static from(provider, err) {
+        if (err instanceof ProviderError)
+            return err;
+        const status = readNumber(err, "status");
+        const code = readString(err, "code") ?? readString(err, "type");
+        const message = messageOf(err);
+        const body = bodyTextOf(err);
+        return new ProviderError(provider, classify(err, status, body), message, {
+            status,
+            code,
+            retryAfterMs: parseRetryAfterMs(err, body),
+            body: body.slice(0, 2_000) || undefined,
+            cause: err,
+        });
+    }
+}
+// ── reading whatever shape was thrown ─────────────────────────────────────
+function readNumber(err, key) {
+    if (typeof err !== "object" || err === null)
+        return undefined;
+    const value = err[key];
+    return typeof value === "number" ? value : undefined;
+}
+function readString(err, key) {
+    if (typeof err !== "object" || err === null)
+        return undefined;
+    const value = err[key];
+    return typeof value === "string" ? value : undefined;
+}
+export function messageOf(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === "string")
+        return err;
+    const message = readString(err, "message");
+    if (message !== undefined)
+        return message;
+    try {
+        return JSON.stringify(err) ?? String(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+/**
+ * Everything readable about the failure as one searchable string: the message
+ * plus the parsed provider body. SDKs park the parsed body on `.error`, and
+ * that is where the real reason lives ("max_tokens too large", the quotaId,
+ * `"type": "billing_error"`). Scanned as TEXT — the error-type strings
+ * serialize into it, so no JSON walking is needed.
+ */
+function bodyTextOf(err) {
+    const message = messageOf(err);
+    if (typeof err !== "object" || err === null)
+        return message;
+    const body = err.error;
+    if (body === undefined)
+        return message;
+    try {
+        return `${message} ${typeof body === "string" ? body : JSON.stringify(body)}`;
+    }
+    catch {
+        return message;
+    }
+}
+// ── transport: the failure with no status at all ──────────────────────────
+/** Node/undici codes meaning "the socket died", not "the request was wrong".
+ *  They usually sit on `cause`, not on the thrown error itself. */
+const TRANSPORT_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ECONNABORTED",
+    "ETIMEDOUT",
+    "EPIPE",
+    "ENETUNREACH",
+    "ENETDOWN",
+    "ENOTFOUND",
+    "EHOSTUNREACH",
+    "EAI_AGAIN",
+    "ERR_STREAM_PREMATURE_CLOSE",
+]);
+/**
+ * The same faults when only a message survives. Engine wordings differ:
+ * Chromium says "Failed to fetch", Firefox "NetworkError when attempting to
+ * fetch resource", Safari "Load failed", Node/Bun "fetch failed".
+ */
+const TRANSPORT_MESSAGES = /failed to fetch|fetch failed|network\s?error|load failed|unable to connect|socket hang up|socket (?:connection )?(?:was )?closed|connection (?:error|closed|refused|reset)|premature close|stream (?:ended|closed) unexpectedly|und_err/i;
+/** How far up the `cause` chain to look before giving up. */
+const CAUSE_DEPTH = 5;
+function isAbort(err) {
+    const name = readString(err, "name");
+    const code = readString(err, "code");
+    return name === "AbortError" || name === "APIUserAbortError" || code === "ABORT_ERR";
+}
+/**
+ * A transport fault: the socket died before or during the response, so there
+ * is NO status and no body for the patterns below to read.
+ *
+ * The chain is walked because the useful code is rarely on the thrown error —
+ * it sits on `cause`, sometimes several wrappers deep. Without this walk every
+ * network blip classifies as permanent, and a long run dies on its first
+ * hiccup, which is the single likeliest way to lose a minutes-long job.
+ *
+ * A deliberate abort short-circuits to false: the caller pressed Stop, and
+ * retrying that just re-fails against the same dead signal.
+ */
+export function isTransportFailure(err) {
+    let current = err;
+    for (let depth = 0; current != null && depth < CAUSE_DEPTH; depth++) {
+        if (typeof current !== "object")
+            return false;
+        if (isAbort(current))
+            return false;
+        const name = readString(current, "name");
+        const code = readString(current, "code");
+        const message = readString(current, "message");
+        if (name === "APIConnectionError" || name === "APIConnectionTimeoutError")
+            return true;
+        if (code !== undefined && TRANSPORT_CODES.has(code))
+            return true;
+        // A bare TypeError is also what a real bug throws ("x is not a function"),
+        // so the MESSAGE is checked, not just the type — misfiling one of those
+        // would retry a genuine bug three times and hide it.
+        if (message !== undefined && TRANSPORT_MESSAGES.test(message))
+            return true;
+        current = current.cause;
+    }
+    return false;
+}
+// ── body patterns, most-specific first ────────────────────────────────────
+// The request outgrew the model's window. Distinct from quota in the one way
+// that matters: nothing about the account is wrong and waiting fixes nothing —
+// the fix is to send less, which is what compaction does.
+const CONTEXT_PATTERNS = [
+    /context[_\s]length[_\s]exceeded/i,
+    /maximum context length/i,
+    /context window/i,
+    /prompt is too long/i,
+    /input is too long/i,
+    /too many (?:input )?tokens/i,
+    /reduce the length of the (?:messages|prompt|input)/i,
+    // Scoped to the thing that overflowed: a bare "exceeds the maximum" also
+    // covers image counts and per-minute token rates, which compaction can't fix.
+    /exceeds? the (?:model'?s? )?maximum (?:input |prompt |context )?(?:tokens?|length|context)/i,
+];
+// A plan that never included this API — neither a new key nor a top-up fixes
+// it, and its wording overlaps both other categories ("plan" appears in all
+// three), so it is checked first.
+const ENTITLEMENT_PATTERNS = [
+    /plan does(?:n't| not) (?:include|support)/i,
+    /not included (?:in|with) your .{0,40}plan/i,
+    /upgrade to [\w ]{1,30}(?:or higher|plan)/i,
+    /no api access/i,
+];
+// Balance or usage window used up. Chinese-market providers report it in
+// Chinese, which is why the literal strings are here rather than a rule.
+const QUOTA_PATTERNS = [
+    /insufficient[_\s]quota/i,
+    /exceeded your current quota/i,
+    /insufficient (?:balance|credits?)/i,
+    /credit balance is too low/i,
+    /(?:no|out of) credits/i,
+    // Both word orders occur in the wild.
+    /usage limits? (?:reached|exceeded|hit)/i,
+    /reached your (?:usage|weekly|monthly|daily) limit/i,
+    /(?:weekly|monthly|daily|plan) usage limit/i,
+    /purchase extra usage/i,
+    /upgrade your plan/i,
+    /quota\b[^.]{0,40}\b(?:exhausted|exceeded|will be refreshed)/i,
+    /balance (?:is )?(?:too low|not enough|insufficient)/i,
+    /per\s*day|PerDay|insufficient_quota|billing/i,
+    /余额不足/,
+    /欠费/,
+    /额度(?:不足|已用完)/,
+];
+const MODEL_PATTERNS = [
+    /(?:model|models\/)[^.{\n]{0,40}(?:not found|does not exist|unknown)/i,
+    /no model named/i,
+    /unsupported model/i,
+];
+const AUTH_PATTERNS = [
+    /invalid (?:x-api-key|api[ _-]?key|token|credentials?)/i,
+    /api[ _-]?key (?:is )?(?:not valid|invalid|incorrect)/i,
+    /unauthorized|UNAUTHENTICATED|PERMISSION_DENIED/i,
+    /authentication[_\s](?:failed|invalid|error)/i,
+    /account (?:disabled|suspended|deactivated|banned)/i,
+];
+const CONTENT_PATTERNS = [
+    /content[_\s]filter/i,
+    /content policy/i,
+    /safety|PROHIBITED_CONTENT|blocked|refusal/i,
+];
+/** Theirs and temporary, said in words rather than a status. Gemini reports
+ *  UNAVAILABLE/INTERNAL in the body; gateways say "capacity". */
+const OVERLOAD_PATTERNS = [
+    /overloaded|overloaded_error/i,
+    /\bunavailable\b|UNAVAILABLE/,
+    /internal error|INTERNAL/,
+    /\bcapacity\b/i,
+    /"code"\s*:\s*5\d\d/,
+];
+const matches = (patterns, text) => patterns.some((pattern) => pattern.test(text));
+/**
+ * The kind of failure, from whatever was thrown.
+ *
+ * Body patterns outrank status for the 4xx family; within them, context beats
+ * entitlement beats quota beats auth — each earlier category's fix is useless
+ * for the later ones.
+ */
+export function classify(err, status, body) {
+    if (isAbort(err))
+        return "aborted";
+    if (isTransportFailure(err))
+        return "network";
+    const code = status ?? readNumber(err, "status");
+    const text = body ?? bodyTextOf(err);
+    const name = readString(err, "name");
+    if (name === "TimeoutError" || code === 408)
+        return "timeout";
+    // Context first: a 429 whose body says "too many tokens" is either a
+    // per-minute rate limit or an oversized prompt, and only the wordings here —
+    // which name the WINDOW, not the rate — land on context. Compaction is the
+    // fix, and unlike "wait" it is one the caller can act on immediately.
+    const clientError = code === undefined || code < 500;
+    if (clientError && matches(CONTEXT_PATTERNS, text))
+        return "context";
+    if (clientError && matches(ENTITLEMENT_PATTERNS, text))
+        return "entitlement";
+    if (clientError && matches(QUOTA_PATTERNS, text))
+        return "quota";
+    if (matches(MODEL_PATTERNS, text))
+        return "model";
+    if (code === 401 || code === 403 || matches(AUTH_PATTERNS, text))
+        return "auth";
+    if (code === 402)
+        return "quota";
+    if (code === 404)
+        return "model";
+    if (code === 429)
+        return "rate";
+    if (matches(CONTENT_PATTERNS, text))
+        return "content";
+    // 529 is Anthropic's own "overloaded". 409 is how several gateways say
+    // "the model is still loading" — both are worth another attempt.
+    if (code === 529 || code === 409)
+        return "overload";
+    if (code !== undefined && code >= 500)
+        return "overload";
+    if (matches(OVERLOAD_PATTERNS, text))
+        return "overload";
+    if (/timed out|timeout/i.test(text))
+        return "timeout";
+    if (code !== undefined && code >= 400)
+        return "invalid";
+    return "unknown";
+}
+/**
+ * How long the provider asked us to wait, in ms. Two dialects: Gemini's
+ * RetryInfo (`"retryDelay": "52s"`, inside the body) and the `Retry-After`
+ * header, which SDKs keep on the error. Honouring it beats guessing — a
+ * backoff shorter than the window just burns an attempt.
+ */
+export function parseRetryAfterMs(err, body) {
+    const text = body ?? bodyTextOf(err);
+    const delay = text.match(/"?retryDelay"?\s*[:=]\s*"?(\d+(?:\.\d+)?)s"?/i);
+    if (delay?.[1])
+        return Math.round(parseFloat(delay[1]) * 1000);
+    if (typeof err !== "object" || err === null)
+        return undefined;
+    const headers = err.headers;
+    const value = headers instanceof Headers
+        ? headers.get("retry-after")
+        : typeof headers === "object" && headers !== null
+            ? headers["retry-after"]
+            : undefined;
+    if (typeof value !== "string")
+        return undefined;
+    // Seconds, or an HTTP-date — both are legal per RFC 9110.
+    if (/^\d+$/.test(value))
+        return Number(value) * 1000;
+    const date = Date.parse(value);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());
+}
+/** The loggable surface of a failure — so a dead run never reads
+ *  "400 status code (no body)". */
+export function describeProviderError(err) {
+    if (err instanceof ProviderError) {
+        return {
+            provider: err.provider,
+            kind: err.kind,
+            status: err.status,
+            code: err.code,
+            retryAfterMs: err.retryAfterMs,
+            error: err.message,
+            body: err.body,
+        };
+    }
+    return { error: messageOf(err), kind: classify(err) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./types.ts";
+export * from "./errors.ts";
+export * from "./retry.ts";
+export * from "./watchdog.ts";
+export * from "./usage.ts";
+export * from "./transport.ts";
+export * from "./tool-args.ts";
+export * from "./tools.ts";
+export * from "./schema.ts";
+export * from "./context.ts";
+export * from "./providers/anthropic.ts";
+export * from "./providers/openai.ts";
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./retry.js";
+export * from "./watchdog.js";
+export * from "./usage.js";
+export * from "./transport.js";
+export * from "./tool-args.js";
+export * from "./tools.js";
+export * from "./schema.js";
+export * from "./context.js";
+export * from "./providers/anthropic.js";
+export * from "./providers/openai.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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,26 @@
+import type { ChatMessage, Effort, Provider } from "../types.ts";
+export interface AnthropicConfig {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    /** Bound default; a per-call `effort` overrides it. */
+    effort?: Effort;
+    /** Anthropic requires an output ceiling on every request. */
+    maxTokens?: number;
+    version?: string;
+    fetchImpl?: typeof fetch;
+    /** Send the key as a Bearer instead of `x-api-key` — what a subscription
+     *  access token needs. */
+    bearer?: boolean;
+}
+/**
+ * Anthropic takes `system` at the top level and expects tool RESULTS as user
+ * turns carrying `tool_result` blocks — not as a role of their own. Consecutive
+ * tool results are merged into one user turn, which the API requires.
+ */
+export declare function toAnthropicMessages(messages: readonly ChatMessage[]): {
+    system?: string;
+    messages: unknown[];
+};
+export declare function createAnthropicProvider(config: AnthropicConfig): Provider;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EAEX,MAAM,EAEN,QAAQ,EAIT,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;8BAC0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,CAoDA;AAiCD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAmJzE"}