@pentoshi/clai 4.11.28 → 4.12.0

package/dist/llm/freebuff-run.js

@@ -0,0 +1,147 @@
+import { randomUUID } from "node:crypto";
+import { ProviderError } from "./http.js";
+import { FREEBUFF_API_BASE_URL } from "./freebuff-auth.js";
+const RUN_PATH = "/api/v1/agent-runs";
+const RUN_TIMEOUT_MS = 30_000;
+const BASE3_AGENT_BY_MODEL = {
+    "crof/kimi-k3-eco": "base3-free-kimi-k3-eco",
+    "deepseek/deepseek-v4-flash": "base3-free-deepseek-flash",
+    "deepseek/deepseek-v4-pro": "base3-free-deepseek",
+    "google/gemini-3.8-flash": "base3-free-gemini-3-8-flash",
+    "meta/muse-spark-1.2-contributor": "base3-free-muse-spark",
+    "meta/muse-spark-1.3-contributor": "base3-free-muse-spark-1-3",
+    "mimo/mimo-v2.5": "base3-free-mimo",
+    "mimo/mimo-v2.6-pro": "base3-free-mimo-2-6-pro",
+    "minimax/minimax-m3": "base3-free-minimax-m3",
+    "openai/gpt-5.6-luna": "base3-free-luna",
+    "openai/gpt-5.6-luna-es": "base3-free-luna-es",
+    "openai/gpt-6-luna": "base3-free-luna-6",
+    "stealth/ox-alpha": "base3-free-ox-alpha",
+    "stealth/space-bunny-alpha": "base3-free-space-bunny-alpha",
+    "upstage/solar-mini4": "base3-free-solar-mini4",
+    "upstage/solar-pro4": "base3-free-solar-pro4",
+    "z-ai/glm-5.2": "base3-free-glm",
+    "z-ai/glm-5.3-flash": "base3-free-glm-5-3-flash",
+};
+const BASE2_AGENT_BY_MODEL = {
+    "anthropic/claude-fable-5.1": "base2-free-fable",
+    "anthropic/claude-opus-4.8": "base2-free-claude-opus-4-8",
+    "anthropic/claude-opus-5": "base2-free-claude-opus-5",
+    "anthropic/claude-opus-5.5": "base2-free-claude-opus-5-5",
+    "anthropic/claude-sonnet-4.6": "base2-free-claude-sonnet-4-6",
+    "anthropic/claude-sonnet-5": "base2-free-claude-sonnet-5",
+    "crof/kimi-k3-eco": "base2-free-kimi-k3-eco",
+    "deepseek/deepseek-v4-flash": "base2-free-deepseek-flash",
+    "deepseek/deepseek-v4-pro": "base2-free-deepseek",
+    "deepseek/deepseek-v4.1-flash": "base2-free-deepseek-v4-1-flash",
+    "google/gemini-3.1-pro-preview": "base2-free-gemini-3-1-pro",
+    "google/gemini-3.5-flash": "base2-free-gemini-3-5-flash",
+    "google/gemini-3.6-flash": "base2-free-gemini-3-6-flash",
+    "google/gemini-3.7-flash": "base2-free-gemini-3-7-flash",
+    "google/gemini-3.8-flash": "base2-free-gemini-3-8-flash",
+    "meta-llama/llama-4-maverick": "base2-free-llama-4-maverick",
+    "meta/muse-spark-1.2-contributor": "base2-free-muse-spark",
+    "meta/muse-spark-1.3-contributor": "base2-free-muse-spark-1-3",
+    "mimo/mimo-v2.5": "base2-free-mimo",
+    "mimo/mimo-v2.5-pro": "base2-free-mimo-2-5-pro",
+    "mimo/mimo-v2.6-pro": "base2-free-mimo-2-6-pro",
+    "minimax/minimax-m3": "base2-free-minimax-m3",
+    "mistralai/codestral-2508": "base2-free-codestral-2508",
+    "mistralai/mistral-large": "base2-free-mistral-large",
+    "moonshotai/kimi-k3": "base2-free-kimi-k3",
+    "openai/gpt-5.4-pro": "base2-free-gpt-5-4-pro",
+    "openai/gpt-5.5": "base2-free-gpt-5-5",
+    "openai/gpt-5.5-pro": "base2-free-gpt-5-5-pro",
+    "openai/gpt-5.6-luna": "base2-free-luna",
+    "openai/gpt-5.6-luna-es": "base2-free-luna-es",
+    "openai/gpt-5.6-luna-pro": "base2-free-gpt-5-6-luna-pro",
+    "openai/gpt-5.6-sol": "base2-free-gpt-5-6-sol",
+    "openai/gpt-5.6-sol-pro": "base2-free-gpt-5-6-sol-pro",
+    "openai/gpt-5.6-terra": "base2-free-gpt-5-6-terra",
+    "openai/gpt-5.6-terra-pro": "base2-free-gpt-5-6-terra-pro",
+    "openai/gpt-6-astra": "base2-free-gpt-6-astra",
+    "openai/gpt-6-astra-pro": "base2-free-gpt-6-astra-pro",
+    "openai/gpt-6-luna": "base2-free-luna-6",
+    "openai/gpt-6-luna-pro": "base2-free-gpt-6-luna-pro",
+    "openai/gpt-6-sol": "base2-free-gpt-6-sol",
+    "openai/gpt-6-sol-pro": "base2-free-gpt-6-sol-pro",
+    "openai/o3-pro": "base2-free-o3-pro",
+    "qwen/qwen3.6-max-preview": "base2-free-qwen3-6-max-preview",
+    "qwen/qwen3.6-plus": "base2-free-qwen3-6-plus",
+    "qwen/qwen3.7-max": "base2-free-qwen3-7-max",
+    "qwen/qwen3.7-plus": "base2-free-qwen3-7-plus",
+    "qwen/qwen3.8-27b": "base2-free-qwen3-8-27b",
+    "qwen/qwen3.8-flash": "base2-free-qwen3-8-flash",
+    "qwen/qwen3.8-max-0902": "base2-free-qwen3-8-max-0902",
+    "qwen/qwen3.8-max-prime": "base2-free-qwen3-8-max-prime",
+    "stealth/ox-alpha": "base2-free-ox-alpha",
+    "stealth/space-bunny-alpha": "base2-free-space-bunny-alpha",
+    "upstage/solar-mini4": "base2-free-solar-mini4",
+    "upstage/solar-pro4": "base2-free-solar-pro4",
+    "x-ai/grok-4.20": "base2-free-grok-4-20",
+    "x-ai/grok-4.5": "base2-free-grok-4-5",
+    "x-ai/grok-4.6": "base2-free-grok-4-6",
+    "x-ai/grok-4.7": "base2-free-grok-4-7",
+    "z-ai/glm-5-turbo": "base2-free-glm-5-turbo",
+    "z-ai/glm-5.2": "base2-free-glm",
+    "z-ai/glm-5.3": "base2-free-glm-5-3",
+    "z-ai/glm-5.3-flash": "base2-free-glm-5-3-flash",
+    "z-ai/glm-5.3-flashx": "base2-free-glm-5-3-flashx",
+    "z-ai/glm-5.3-prime": "base2-free-glm-5-3-prime",
+};
+const FALLBACK_AGENT_ID = "codebuff/base2-free";
+export function freebuffAgentId(model) {
+    const id = model.trim();
+    const agent = BASE3_AGENT_BY_MODEL[id] ?? BASE2_AGENT_BY_MODEL[id];
+    return agent ? `codebuff/${agent}` : FALLBACK_AGENT_ID;
+}
+function runUrl(base) {
+    return `${base.replace(/\/$/, "")}${RUN_PATH}`;
+}
+function runSignal(signal) {
+    const timeout = AbortSignal.timeout(RUN_TIMEOUT_MS);
+    return signal ? AbortSignal.any([signal, timeout]) : timeout;
+}
+async function postRun(token, body, action, deps) {
+    const response = await (deps.fetch ?? fetch)(runUrl(deps.baseUrl ?? FREEBUFF_API_BASE_URL), {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${token}`,
+            "content-type": "application/json",
+        },
+        body: JSON.stringify(body),
+        signal: runSignal(deps.signal),
+    });
+    const text = await response.text().catch(() => "");
+    if (!response.ok) {
+        throw new ProviderError(`Freebuff ${action} failed (${response.status}${text ? `: ${text.slice(0, 300)}` : ""})`, response.status, text.slice(0, 2_000));
+    }
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function startFreebuffRun(token, model, deps = {}) {
+    const agentId = freebuffAgentId(model);
+    const payload = await postRun(token, { action: "START", agentId, ancestorRunIds: [] }, "run start", deps);
+    const runId = payload?.["runId"];
+    if (typeof runId !== "string" || !runId) {
+        throw new ProviderError("Freebuff run start returned no runId; the completion endpoint rejects unregistered runs.");
+    }
+    return { runId, clientId: randomUUID(), agentId };
+}
+export async function finishFreebuffRun(token, run, status, steps, deps = {}) {
+    await postRun(token, {
+        action: "FINISH",
+        runId: run.runId,
+        status,
+        totalSteps: steps,
+        directCredits: 0,
+        totalCredits: 0,
+    }, "run finish", deps).catch(() => undefined);
+}
+//# sourceMappingURL=freebuff-run.js.map

package/dist/llm/freebuff-run.js.map

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

package/dist/llm/freebuff-session-api.d.ts

@@ -0,0 +1,92 @@
+export declare const FREEBUFF_CLI_CLAIM_PREFIX = "cli:";
+export declare const FREEBUFF_SESSION_PATH = "/api/v1/freebuff/session";
+export declare const FREEBUFF_SESSION_ADMISSION_PATH = "/api/v1/freebuff/session/admission";
+export declare const FREEBUFF_HEARTBEAT_INTERVAL_MS = 45000;
+export type FreebuffSessionMethod = "GET" | "POST" | "DELETE";
+export interface FreebuffWalletConsent {
+    readonly price: number;
+    readonly walletSpend: number;
+}
+export type FreebuffSessionResponse = {
+    status: "active";
+    instanceId: string;
+    model: string;
+    admittedAt?: string;
+    expiresAt?: string;
+    remainingMs?: number;
+} | {
+    status: "none";
+    message?: string;
+} | {
+    status: "ended";
+    instanceId?: string;
+    expiresAt?: string;
+} | {
+    status: "superseded";
+} | {
+    status: "consent_required";
+    walletConsent: FreebuffWalletConsent;
+} | {
+    status: "first_tab_discount_changed";
+} | {
+    status: "model_locked";
+    currentModel: string;
+    requestedModel: string;
+} | {
+    status: "model_unavailable";
+    requestedModel: string;
+    availableHours?: string;
+    requiresSubscription?: boolean;
+    withdrawn?: boolean;
+} | {
+    status: "rate_limited";
+    model?: string;
+    retryAfterMs?: number;
+    message?: string;
+} | {
+    status: "spend_limited";
+    message?: string;
+    resetAt?: string;
+    retryAfterMs?: number;
+} | {
+    status: "ip_capped";
+    model?: string;
+    limit?: number;
+    retryAfterMs?: number;
+} | {
+    status: "premium_slot_taken";
+    requestedModel?: string;
+    currentModel?: string;
+} | {
+    status: "purchase_in_use" | "purchase_capacity";
+    requestedModel?: string;
+} | {
+    status: "purchase_claim_released";
+} | {
+    status: "country_blocked";
+    countryCode?: string;
+    message?: string;
+} | {
+    status: "banned";
+    message?: string;
+};
+export declare class FreebuffSessionRequestError extends Error {
+    readonly statusCode: number;
+    readonly retryAfterMs?: number | undefined;
+    readonly errorCode?: string | undefined;
+    constructor(message: string, statusCode: number, retryAfterMs?: number | undefined, errorCode?: string | undefined);
+}
+export declare function newFreebuffCliInstanceId(): string;
+export declare function freebuffCliAttemptId(instanceId: string | undefined): string | undefined;
+export declare function freebuffSessionMetadata(instanceId: string): Record<string, string>;
+export interface FreebuffSessionCallOptions {
+    readonly instanceId?: string | undefined;
+    readonly model?: string | undefined;
+    readonly walletSpendLimit?: number | undefined;
+    readonly compact?: boolean | undefined;
+    readonly heartbeat?: boolean | undefined;
+    readonly signal?: AbortSignal | undefined;
+    readonly baseUrl?: string | undefined;
+    readonly fetch?: typeof fetch | undefined;
+}
+export declare function callFreebuffSession(method: FreebuffSessionMethod, token: string, opts?: FreebuffSessionCallOptions): Promise<FreebuffSessionResponse>;

package/dist/llm/freebuff-session-api.js

@@ -0,0 +1,154 @@
+import { randomUUID } from "node:crypto";
+import { FREEBUFF_API_BASE_URL } from "./freebuff-auth.js";
+import { ProviderError } from "./http.js";
+export const FREEBUFF_CLI_CLAIM_PREFIX = "cli:";
+export const FREEBUFF_SESSION_PATH = "/api/v1/freebuff/session";
+export const FREEBUFF_SESSION_ADMISSION_PATH = "/api/v1/freebuff/session/admission";
+export const FREEBUFF_HEARTBEAT_INTERVAL_MS = 45_000;
+const SESSION_FETCH_TIMEOUT_MS = 20_000;
+const HEADER = {
+    timezone: "x-fb-timezone",
+    firstTabDiscount: "x-freebuff-first-tab-discount",
+    multiSession: "x-freebuff-multi-session",
+    purchaseContinuity: "x-freebuff-purchase-continuity",
+    desktopAttempt: "x-freebuff-desktop-attempt-id",
+    instance: "x-freebuff-instance-id",
+    heartbeat: "x-freebuff-heartbeat",
+    includeUnusedRateLimits: "x-freebuff-include-unused-rate-limits",
+    compactSession: "x-freebuff-compact-session",
+    model: "x-freebuff-model",
+    walletSpendLimit: "x-freebuff-wallet-spend-limit",
+    takeoverInstance: "x-freebuff-takeover-instance-id",
+};
+export class FreebuffSessionRequestError extends Error {
+    statusCode;
+    retryAfterMs;
+    errorCode;
+    constructor(message, statusCode, retryAfterMs, errorCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.retryAfterMs = retryAfterMs;
+        this.errorCode = errorCode;
+        this.name = "FreebuffSessionRequestError";
+    }
+}
+export function newFreebuffCliInstanceId() {
+    return `${FREEBUFF_CLI_CLAIM_PREFIX}${randomUUID()}`;
+}
+export function freebuffCliAttemptId(instanceId) {
+    return instanceId?.startsWith(FREEBUFF_CLI_CLAIM_PREFIX)
+        ? instanceId.slice(FREEBUFF_CLI_CLAIM_PREFIX.length)
+        : undefined;
+}
+export function freebuffSessionMetadata(instanceId) {
+    const attemptId = freebuffCliAttemptId(instanceId);
+    return {
+        freebuff_instance_id: instanceId,
+        ...(attemptId ? { freebuff_multi_session: "1", surface: "cli" } : {}),
+    };
+}
+function timezoneHeader() {
+    try {
+        return { [HEADER.timezone]: Intl.DateTimeFormat().resolvedOptions().timeZone };
+    }
+    catch {
+        return {};
+    }
+}
+function sessionFetchSignal(signal) {
+    const timeout = AbortSignal.timeout(SESSION_FETCH_TIMEOUT_MS);
+    return signal ? AbortSignal.any([signal, timeout]) : timeout;
+}
+function parseRetryAfterMs(value, nowMs = Date.now()) {
+    if (!value)
+        return undefined;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.ceil(seconds * 1_000);
+    const dateMs = Date.parse(value);
+    return Number.isFinite(dateMs) ? Math.max(0, dateMs - nowMs) : undefined;
+}
+function admissionHeaders(method, token, opts) {
+    const headers = {
+        authorization: `Bearer ${token}`,
+        ...timezoneHeader(),
+        [HEADER.firstTabDiscount]: "0",
+    };
+    const attemptId = freebuffCliAttemptId(opts.instanceId);
+    const multiSession = Boolean(attemptId);
+    if (multiSession) {
+        headers[HEADER.multiSession] = "1";
+        headers[HEADER.purchaseContinuity] = "1";
+        if (attemptId && method !== "GET")
+            headers[HEADER.desktopAttempt] = attemptId;
+        if (method === "GET" && opts.instanceId && opts.heartbeat) {
+            headers[HEADER.heartbeat] = "1";
+            if (!opts.compact)
+                headers[HEADER.includeUnusedRateLimits] = "1";
+        }
+    }
+    if ((multiSession || method !== "POST") && opts.instanceId) {
+        headers[HEADER.instance] = opts.instanceId;
+    }
+    if (method === "GET" && opts.compact)
+        headers[HEADER.compactSession] = "1";
+    if (method === "POST") {
+        if (opts.model)
+            headers[HEADER.model] = opts.model;
+        headers[HEADER.walletSpendLimit] = String(opts.walletSpendLimit ?? 0);
+    }
+    return headers;
+}
+function endpointFor(method, base, instanceId) {
+    const root = base.replace(/\/$/, "");
+    if (method === "POST")
+        return `${root}${FREEBUFF_SESSION_ADMISSION_PATH}`;
+    if (method === "DELETE" && freebuffCliAttemptId(instanceId)) {
+        return `${root}${FREEBUFF_SESSION_PATH}/attempt`;
+    }
+    return `${root}${FREEBUFF_SESSION_PATH}`;
+}
+const typedRefusalStatuses = new Set([
+    "country_blocked",
+    "banned",
+    "model_locked",
+    "model_unavailable",
+    "premium_slot_taken",
+    "purchase_in_use",
+    "purchase_capacity",
+    "purchase_claim_released",
+    "first_tab_discount_changed",
+    "consent_required",
+    "rate_limited",
+    "spend_limited",
+    "ip_capped",
+]);
+export async function callFreebuffSession(method, token, opts = {}) {
+    const fetchImpl = opts.fetch ?? fetch;
+    const base = opts.baseUrl ?? FREEBUFF_API_BASE_URL;
+    const response = await fetchImpl(endpointFor(method, base, opts.instanceId), {
+        method,
+        headers: admissionHeaders(method, token, opts),
+        signal: sessionFetchSignal(opts.signal),
+    });
+    if (method === "POST" && (response.status === 404 || response.status === 405)) {
+        throw new FreebuffSessionRequestError("Freebuff session admission is unavailable on this server.", response.status, undefined, "session_admission_unsupported");
+    }
+    if (response.status === 404)
+        return { status: "none" };
+    const parsed = (await response
+        .json()
+        .catch(() => null));
+    if (parsed &&
+        typeof parsed.status === "string" &&
+        (response.ok || typedRefusalStatuses.has(parsed.status))) {
+        return parsed;
+    }
+    if (!response.ok) {
+        throw new FreebuffSessionRequestError(`Freebuff session ${method} failed (${response.status}).`, response.status, parseRetryAfterMs(response.headers.get("retry-after")), typeof parsed?.error === "string"
+            ? parsed.error
+            : undefined);
+    }
+    throw new ProviderError(`Freebuff session ${method} returned an unrecognized response.`);
+}
+//# sourceMappingURL=freebuff-session-api.js.map

package/dist/llm/freebuff-session-api.js.map

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

package/dist/llm/freebuff-session.d.ts

@@ -0,0 +1,31 @@
+import { type FreebuffSessionCallOptions } from "./freebuff-session-api.js";
+export interface FreebuffAdmission {
+    readonly instanceId: string;
+    readonly model: string;
+    readonly expiresAt: number | undefined;
+    readonly metadata: Record<string, string>;
+}
+type SessionDeps = Pick<FreebuffSessionCallOptions, "baseUrl" | "fetch">;
+export declare class FreebuffSessionManager {
+    private readonly deps;
+    private readonly claims;
+    private readonly inflight;
+    private closing;
+    private disposePromise;
+    constructor(deps?: SessionDeps);
+    private scope;
+    ensureAdmission(token: string, model: string, signal?: AbortSignal): Promise<FreebuffAdmission>;
+    private claim;
+    private toAdmission;
+    private scheduleHeartbeat;
+    private beat;
+    private clearClaim;
+    private releaseKey;
+    release(token: string, model?: string, signal?: AbortSignal): Promise<void>;
+    dispose(): Promise<void>;
+    hasActiveClaim(token: string, model: string): boolean;
+}
+export declare function freebuffSessionManager(): FreebuffSessionManager;
+export declare function disposeFreebuffSessionManager(): Promise<void>;
+export declare function runFreebuffSessionShutdownCleanup(runEpilogue?: () => void | Promise<void>): Promise<void>;
+export {};