@agent-native/core 0.187.0 → 0.187.1-nightly-20260924193134

package/dist/agent/engine/builder-engine.js

@@ -744,6 +744,14 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
                 }
                 case "usage": {
                     const cacheWrite = (event.cacheCreatedTokens ?? 0) + (event.cacheCreated1hTokens ?? 0);
+                    if (event.creditsUsed !== undefined &&
+                        (!Number.isFinite(event.creditsUsed) || event.creditsUsed < 0)) {
+                        yield gatewayErrorStop({
+                            error: "Builder gateway returned invalid credit usage",
+                            errorCode: "builder_gateway_error",
+                        }, captureContext.creditsLane, captureContext.requestShape);
+                        return;
+                    }
                     yield {
                         type: "usage",
                         inputTokens: event.inputTokens ?? 0,
@@ -752,6 +760,9 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
                             ? { cacheReadTokens: event.cacheInputTokens }
                             : {}),
                         ...(cacheWrite > 0 ? { cacheWriteTokens: cacheWrite } : {}),
+                        ...(event.creditsUsed !== undefined
+                            ? { builderCreditsUsed: event.creditsUsed }
+                            : {}),
                     };
                     break;
                 }

package/dist/agent/engine/types.d.ts

@@ -196,6 +196,7 @@ export type EngineEvent = {
     cacheWriteTokens?: number;
     totalTokens?: number;
     reasoningTokens?: number;
+    builderCreditsUsed?: number;
 } | {
     /** Final assistant content for the turn. Engines MUST emit this
      *  exactly once, immediately before the terminal `stop` event. */

package/dist/agent/production-agent.d.ts

@@ -571,6 +571,8 @@ export interface AgentLoopUsage {
     outputTokens: number;
     cacheReadTokens: number;
     cacheWriteTokens: number;
+    builderCreditsUsed?: number;
+    engineName?: string;
     model: string;
     /** Number of provider model-stream attempts, including retries. */
     llmCalls?: number;

package/dist/agent/production-agent.js

@@ -3735,6 +3735,7 @@ export async function runAgentLoop(opts) {
         outputTokens: 0,
         cacheReadTokens: 0,
         cacheWriteTokens: 0,
+        engineName: opts.engine.name,
         model,
     };
     const maxIterations = normalizeMaxIterations(opts.maxIterations, getDefaultMaxIterations());
@@ -4313,12 +4314,21 @@ export async function runAgentLoop(opts) {
                                 outputTokens: event.outputTokens,
                                 cacheReadTokens: event.cacheReadTokens ?? 0,
                                 cacheWriteTokens: event.cacheWriteTokens ?? 0,
+                                engineName: opts.engine.name,
                                 model,
+                                ...(event.builderCreditsUsed !== undefined
+                                    ? { builderCreditsUsed: event.builderCreditsUsed }
+                                    : {}),
                             };
                             usage.inputTokens += eventUsage.inputTokens;
                             usage.outputTokens += eventUsage.outputTokens;
                             usage.cacheReadTokens += eventUsage.cacheReadTokens;
                             usage.cacheWriteTokens += eventUsage.cacheWriteTokens;
+                            if (eventUsage.builderCreditsUsed !== undefined) {
+                                usage.builderCreditsUsed =
+                                    (usage.builderCreditsUsed ?? 0) +
+                                        eventUsage.builderCreditsUsed;
+                            }
                             usage.usageReported = true;
                             opts.onUsage?.(eventUsage);
                         }
@@ -6188,6 +6198,7 @@ export async function runAgentLoopWithMainChatInternalContinuations(opts) {
         outputTokens: 0,
         cacheReadTokens: 0,
         cacheWriteTokens: 0,
+        engineName: opts.engine.name,
         model: opts.model,
     };
     const addUsage = (next) => {
@@ -6195,6 +6206,11 @@ export async function runAgentLoopWithMainChatInternalContinuations(opts) {
         usage.outputTokens += next.outputTokens;
         usage.cacheReadTokens += next.cacheReadTokens;
         usage.cacheWriteTokens += next.cacheWriteTokens;
+        if (next.builderCreditsUsed !== undefined) {
+            usage.builderCreditsUsed =
+                (usage.builderCreditsUsed ?? 0) + next.builderCreditsUsed;
+        }
+        usage.engineName = next.engineName ?? usage.engineName;
         usage.model = next.model;
         if (typeof next.llmCalls === "number") {
             usage.llmCalls = (usage.llmCalls ?? 0) + next.llmCalls;
@@ -9074,6 +9090,8 @@ export function createProductionAgentHandler(options) {
                                 outputTokens: subUsage.outputTokens,
                                 cacheReadTokens: subUsage.cacheReadTokens,
                                 cacheWriteTokens: subUsage.cacheWriteTokens,
+                                builderCreditsUsed: subUsage.builderCreditsUsed,
+                                engineName: engine.name,
                                 model: subUsage.model,
                                 label: `custom-agent:${ref.name}`,
                                 runId,
@@ -9178,6 +9196,7 @@ export function createProductionAgentHandler(options) {
                 outputTokens: 0,
                 cacheReadTokens: 0,
                 cacheWriteTokens: 0,
+                engineName: engine.name,
                 model: effectiveModel,
             };
             const agentLoopOpts = {
@@ -9197,6 +9216,11 @@ export function createProductionAgentHandler(options) {
                     turnUsage.outputTokens += usage.outputTokens;
                     turnUsage.cacheReadTokens += usage.cacheReadTokens;
                     turnUsage.cacheWriteTokens += usage.cacheWriteTokens;
+                    if (usage.builderCreditsUsed !== undefined) {
+                        turnUsage.builderCreditsUsed =
+                            (turnUsage.builderCreditsUsed ?? 0) + usage.builderCreditsUsed;
+                    }
+                    turnUsage.engineName = usage.engineName ?? turnUsage.engineName;
                     turnUsage.model = usage.model;
                 },
                 ownerEmail,
@@ -9367,7 +9391,8 @@ export function createProductionAgentHandler(options) {
                         (turnUsage.inputTokens > 0 ||
                             turnUsage.outputTokens > 0 ||
                             turnUsage.cacheReadTokens > 0 ||
-                            turnUsage.cacheWriteTokens > 0)) {
+                            turnUsage.cacheWriteTokens > 0 ||
+                            turnUsage.builderCreditsUsed != null)) {
                         const { recordUsage } = await import("../usage/store.js");
                         await recordUsage({
                             ownerEmail: resolvedOwnerEmail,
@@ -9375,6 +9400,8 @@ export function createProductionAgentHandler(options) {
                             outputTokens: turnUsage.outputTokens,
                             cacheReadTokens: turnUsage.cacheReadTokens,
                             cacheWriteTokens: turnUsage.cacheWriteTokens,
+                            builderCreditsUsed: turnUsage.builderCreditsUsed,
+                            engineName: engine.name,
                             model: turnUsage.model,
                             label: turnUsageLabel || "chat",
                             // token_usage has had run_id/thread_id/task_id since it was

package/dist/agent/run-loop-with-resume.js

@@ -373,6 +373,7 @@ control) {
         outputTokens: 0,
         cacheReadTokens: 0,
         cacheWriteTokens: 0,
+        engineName: opts.engine.name,
         model: opts.model,
     };
     const addUsage = (next) => {
@@ -380,6 +381,11 @@ control) {
         usage.outputTokens += next.outputTokens;
         usage.cacheReadTokens += next.cacheReadTokens;
         usage.cacheWriteTokens += next.cacheWriteTokens;
+        if (next.builderCreditsUsed !== undefined) {
+            usage.builderCreditsUsed =
+                (usage.builderCreditsUsed ?? 0) + next.builderCreditsUsed;
+        }
+        usage.engineName = next.engineName ?? usage.engineName;
         usage.model = next.model;
         // Without these, a retry that never got a usage report merges its zeros
         // over an earlier attempt's real numbers, and telemetry reports an

package/dist/automation/index.d.ts

@@ -186,8 +186,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
+    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
-    error?: undefined;
 }>;

package/dist/client/error-format.js

@@ -21,7 +21,7 @@ export const BUILDER_SPACE_SETTINGS_URL = "https://builder.io/account/space?utm_
 export const NEW_CHAT_ACTION_HREF = "agent-native:new-chat";
 const OPEN_BUILDER_SPACE_SETTINGS_LABEL = "Open Builder space settings";
 const START_NEW_CHAT_LABEL = "Start new chat";
-const UPGRADE_AT_BUILDER_LABEL = "Upgrade at builder.io";
+const ADD_CREDITS_IN_BUILDER_LABEL = "Add credits in Builder";
 const BUILDER_AUTHENTICATION_ERROR = "Builder rejected the connected credentials. Reconnect Builder.io (free tier available) in Settings, then retry.";
 /**
  * A 401 says the credential this request carried was refused. It does NOT say
@@ -100,7 +100,7 @@ export function formatChatErrorText(errorMessage, upgradeUrl, errorCode) {
     const normalized = normalizeChatError(errorMessage, errorCode);
     if (normalized.message === CREDITS_LIMIT_REACHED_MESSAGE) {
         return upgradeUrl && isSafeUpgradeUrl(upgradeUrl)
-            ? `${normalized.message}\n\n[${UPGRADE_AT_BUILDER_LABEL}](${upgradeUrl})`
+            ? `${normalized.message}\n\n[${ADD_CREDITS_IN_BUILDER_LABEL}](${upgradeUrl})`
             : normalized.message;
     }
     if (!isServerChosenVisitorMessage(normalized.message) &&
@@ -118,7 +118,7 @@ export function formatChatErrorText(errorMessage, upgradeUrl, errorCode) {
     if (!upgradeUrl || !isSafeUpgradeUrl(upgradeUrl)) {
         return `Error: ${normalized.message}`;
     }
-    return `Error: ${normalized.message}\n\n[${UPGRADE_AT_BUILDER_LABEL}](${upgradeUrl})`;
+    return `Error: ${normalized.message}\n\n[${ADD_CREDITS_IN_BUILDER_LABEL}](${upgradeUrl})`;
 }
 /**
  * True when the server already decided what this reader may be told.
@@ -229,7 +229,7 @@ const KNOWN_CHAT_ERROR_ACTION_KEYS = new Map([
         "agentChat.errorMessages.openBuilderSpaceSettings",
     ],
     ["Start new chat", "agentChat.errorMessages.startNewChat"],
-    ["Upgrade at builder.io", "agentChat.errorMessages.upgradeAtBuilder"],
+    ["Add credits in Builder", "agentChat.errorMessages.addCreditsInBuilder"],
 ]);
 /** Localize only Core's own normalized error copy; preserve provider details. */
 export function localizeKnownChatErrorText(text, t) {

package/dist/client/settings/UsageSection.js

@@ -8,6 +8,7 @@ import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from "
 import { IconArrowUpRight, IconBell, IconChartLine, IconChevronDown, IconLoader2, IconMail, IconPencil, IconPlus, IconRefresh, IconUsers, IconX, } from "@tabler/icons-react";
 import { useState } from "react";
 import { Link } from "react-router";
+import { useT } from "../i18n.js";
 import { useActionMutation, useActionQuery } from "../use-action.js";
 const LOOKBACKS = [
     { value: 7, label: "7d" },
@@ -33,13 +34,53 @@ function compactNumber(value) {
         return `${(value / 1_000).toFixed(1)}K`;
     return Math.round(value).toLocaleString();
 }
-function formatCost(cents, billing) {
-    if (billing.unit === "builder-credits") {
-        const credits = (cents / 100) *
+function usageAmount(cents, billing, builderCredits, estimatedBuilderCredits) {
+    if (billing.unit !== "usd") {
+        if (typeof builderCredits === "number" ||
+            typeof estimatedBuilderCredits === "number") {
+            return (builderCredits ?? 0) + (estimatedBuilderCredits ?? 0);
+        }
+        if (billing.unit === "mixed")
+            return 0;
+        return ((cents / 100) *
             (billing.hardCostMarginMultiplier ?? 1.25) *
-            (billing.creditsPerUsd ?? 20);
-        return `${credits.toLocaleString(undefined, { maximumFractionDigits: 1 })} credits`;
+            (billing.creditsPerUsd ?? 20));
     }
+    return cents;
+}
+function formatCost(t, cents, billing, builderCredits, estimatedBuilderCredits, otherCostCents, includeOtherUsd = true) {
+    if (billing.unit !== "usd") {
+        const parts = [];
+        const actual = builderCredits ?? 0;
+        const estimated = estimatedBuilderCredits ??
+            (typeof builderCredits === "number" || billing.unit === "mixed"
+                ? 0
+                : usageAmount(cents, billing));
+        if (actual > 0) {
+            parts.push(`${actual.toLocaleString(undefined, { maximumFractionDigits: 3 })} ${t("agentChat.usage.builderCredits", { defaultValue: "Builder credits" })}`);
+        }
+        if (estimated > 0) {
+            parts.push(t("agentChat.usage.estimatedBuilderCredits", {
+                defaultValue: "~{{amount}} estimated credits",
+                amount: estimated.toLocaleString(undefined, {
+                    maximumFractionDigits: 3,
+                }),
+            }));
+        }
+        if (includeOtherUsd && otherCostCents && otherCostCents > 0) {
+            parts.push(t("agentChat.usage.otherUsdSpend", {
+                defaultValue: "{{amount}} other USD",
+                amount: formatUsdCost(otherCostCents),
+            }));
+        }
+        return (parts.join(" · ") ||
+            t("agentChat.usage.noBuilderCredits", {
+                defaultValue: "0 Builder credits",
+            }));
+    }
+    return formatUsdCost(cents);
+}
+function formatUsdCost(cents) {
     if (cents < 100)
         return `${cents.toFixed(2)}¢`;
     return `$${(cents / 100).toLocaleString(undefined, {
@@ -69,11 +110,7 @@ function Trend({ daily, billing, }) {
     if (daily.length === 0) {
         return (_jsx("div", { className: "flex h-32 items-center justify-center rounded-lg border border-dashed border-border/70 text-sm text-muted-foreground", children: "No usage recorded in this lookback." }));
     }
-    const values = daily.map((day) => billing.unit === "builder-credits"
-        ? (day.costCents / 100) *
-            (billing.hardCostMarginMultiplier ?? 1.25) *
-            (billing.creditsPerUsd ?? 20)
-        : day.costCents);
+    const values = daily.map((day) => usageAmount(day.costCents, billing, day.builderCredits, day.estimatedBuilderCredits));
     const max = Math.max(...values, 0.01);
     const points = values.map((value, index) => {
         const x = daily.length === 1 ? 50 : (index / (daily.length - 1)) * 100;
@@ -90,17 +127,38 @@ function MetricCard({ label, value, detail, accent = false, }) {
     return (_jsxs("div", { className: "min-w-0 rounded-lg border border-border/70 bg-card px-4 py-4", children: [_jsx("div", { className: "text-xs font-medium text-muted-foreground", children: label }), _jsx("div", { className: `mt-1 truncate text-xl font-semibold tracking-[-0.02em] tabular-nums ${accent ? "text-primary" : "text-foreground"}`, children: value }), _jsx("div", { className: "mt-1 truncate text-xs text-muted-foreground", children: detail })] }));
 }
 function DriverList({ title, rows, billing, }) {
-    const max = Math.max(...rows.map((row) => row.costCents), 1);
-    return (_jsxs("div", { children: [_jsxs("div", { className: "mb-3 flex items-center justify-between gap-3", children: [_jsx("h3", { className: "text-sm font-semibold text-foreground", children: title }), _jsx("span", { className: "text-[11px] uppercase tracking-[0.08em] text-muted-foreground", children: "Spend" })] }), rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: "No usage recorded yet." })) : (_jsx("div", { className: "space-y-3", children: rows.slice(0, 5).map((row) => (_jsxs("div", { children: [_jsxs("div", { className: "flex items-center justify-between gap-3 text-sm", children: [_jsx("span", { className: "min-w-0 truncate text-foreground", title: row.label, children: row.label }), _jsx("span", { className: "shrink-0 tabular-nums text-muted-foreground", children: formatCost(row.costCents, billing) })] }), _jsx("div", { className: "mt-1.5 h-1 overflow-hidden rounded-full bg-muted", children: _jsx("div", { className: "h-full rounded-full bg-primary/70", style: {
-                                    width: `${Math.max(4, (row.costCents / max) * 100)}%`,
-                                } }) })] }, row.key))) }))] }));
+    const t = useT();
+    const max = Math.max(...rows.map((row) => usageAmount(row.costCents, billing, row.builderCredits, row.estimatedBuilderCredits)), 1);
+    const maxOtherUsd = Math.max(...rows.map((row) => row.otherCostCents ?? 0), 1);
+    return (_jsxs("div", { children: [_jsxs("div", { className: "mb-3 flex items-center justify-between gap-3", children: [_jsx("h3", { className: "text-sm font-semibold text-foreground", children: title }), _jsx("span", { className: "text-[11px] uppercase tracking-[0.08em] text-muted-foreground", children: billing.unit === "mixed"
+                            ? t("agentChat.usage.driverCreditsAndUsd", {
+                                defaultValue: "Builder credits / USD",
+                            })
+                            : billing.unit === "builder-credits"
+                                ? t("agentChat.usage.builderCredits", {
+                                    defaultValue: "Builder credits",
+                                })
+                                : "Spend" })] }), rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: "No usage recorded yet." })) : (_jsx("div", { className: "space-y-3", children: rows.slice(0, 5).map((row) => {
+                    const builderAmount = usageAmount(row.costCents, billing, row.builderCredits, row.estimatedBuilderCredits);
+                    const otherOnly = billing.unit === "mixed" && builderAmount === 0;
+                    const amount = otherOnly
+                        ? (row.otherCostCents ?? 0)
+                        : builderAmount;
+                    const scale = otherOnly ? maxOtherUsd : max;
+                    return (_jsxs("div", { children: [_jsxs("div", { className: "flex items-center justify-between gap-3 text-sm", children: [_jsx("span", { className: "min-w-0 truncate text-foreground", title: row.label, children: row.label }), _jsx("span", { className: "shrink-0 tabular-nums text-muted-foreground", children: formatCost(t, row.costCents, billing, row.builderCredits, row.estimatedBuilderCredits, row.otherCostCents) })] }), _jsx("div", { className: "mt-1.5 h-1 overflow-hidden rounded-full bg-muted", children: amount > 0 ? (_jsx("div", { className: "h-full rounded-full bg-primary/70", style: {
+                                        width: `${Math.max(4, (amount / scale) * 100)}%`,
+                                    } })) : null })] }, row.key));
+                }) }))] }));
 }
 function UsageLoadingState() {
     return (_jsxs("div", { className: "space-y-5", role: "status", "aria-label": "Loading usage", children: [_jsx("div", { className: "grid gap-3 sm:grid-cols-3", children: ["w-24", "w-16", "w-20"].map((width) => (_jsxs("div", { className: "rounded-lg border border-border/70 p-4", children: [_jsx(Skeleton, { className: `h-3 ${width}` }), _jsx(Skeleton, { className: "mt-3 h-6 w-24" }), _jsx(Skeleton, { className: "mt-2 h-3 w-28" })] }, width))) }), _jsxs("div", { className: "rounded-lg border border-border/70 p-4", children: [_jsx(Skeleton, { className: "h-4 w-32" }), _jsx(Skeleton, { className: "mt-3 h-32 w-full" })] })] }));
 }
 function AlertEditor({ draft, onChange, onSave, onCancel, isPending, }) {
+    const t = useT();
     const channelCount = Number(draft.inApp) + Number(draft.email);
-    return (_jsxs("div", { className: "mt-3 rounded-lg border border-border/70 bg-muted/20 p-3", children: [_jsxs("div", { className: "grid gap-3 sm:grid-cols-[1fr_1fr_1fr]", children: [_jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Unit" }), _jsxs(Select, { value: draft.unit, onValueChange: (value) => onChange({ unit: value }), children: [_jsx(SelectTrigger, { className: "h-9 bg-background text-sm", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "usd", children: "Dollars" }), _jsx(SelectItem, { value: "builder-credits", children: "Builder credits" }), _jsx(SelectItem, { value: "tokens", children: "Tokens" })] })] })] }), _jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Threshold" }), _jsx(Input, { type: "number", min: "0.01", step: draft.unit === "tokens" ? "1" : "0.01", value: draft.limit, onChange: (event) => onChange({ limit: event.target.value }), className: "h-9 bg-background text-sm" })] }), _jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Window" }), _jsxs(Select, { value: draft.period, onValueChange: (value) => onChange({ period: value }), children: [_jsx(SelectTrigger, { className: "h-9 bg-background text-sm", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "day", children: "Per day" }), _jsx(SelectItem, { value: "month", children: "Per month" })] })] })] })] }), _jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-4 text-xs text-muted-foreground", children: [_jsx("span", { className: "font-medium text-foreground", children: "Deliver via" }), _jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx(Checkbox, { checked: draft.inApp, onCheckedChange: (checked) => onChange({ inApp: checked === true }) }), _jsx(IconBell, { className: "size-3.5" }), " In app"] }), _jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx(Checkbox, { checked: draft.email, onCheckedChange: (checked) => onChange({ email: checked === true }) }), _jsx(IconMail, { className: "size-3.5" }), " Email"] }), _jsxs("div", { className: "ms-auto flex items-center gap-2", children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: onCancel, children: "Cancel" }), _jsxs(Button, { type: "button", size: "sm", onClick: onSave, disabled: isPending || channelCount === 0, children: [isPending ? _jsx(IconLoader2, { className: "animate-spin" }) : null, "Save alert"] })] })] })] }));
+    return (_jsxs("div", { className: "mt-3 rounded-lg border border-border/70 bg-muted/20 p-3", children: [_jsxs("div", { className: "grid gap-3 sm:grid-cols-[1fr_1fr_1fr]", children: [_jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Unit" }), _jsxs(Select, { value: draft.unit, onValueChange: (value) => onChange({ unit: value }), children: [_jsx(SelectTrigger, { className: "h-9 bg-background text-sm", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "usd", children: "Dollars" }), _jsx(SelectItem, { value: "builder-credits", children: t("agentChat.usage.builderCredits", {
+                                                    defaultValue: "Builder credits",
+                                                }) }), _jsx(SelectItem, { value: "tokens", children: "Tokens" })] })] })] }), _jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Threshold" }), _jsx(Input, { type: "number", min: "0.01", step: draft.unit === "tokens" ? "1" : "0.01", value: draft.limit, onChange: (event) => onChange({ limit: event.target.value }), className: "h-9 bg-background text-sm" })] }), _jsxs("label", { className: "space-y-1.5 text-xs text-muted-foreground", children: [_jsx("span", { children: "Window" }), _jsxs(Select, { value: draft.period, onValueChange: (value) => onChange({ period: value }), children: [_jsx(SelectTrigger, { className: "h-9 bg-background text-sm", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "day", children: "Per day" }), _jsx(SelectItem, { value: "month", children: "Per month" })] })] })] })] }), _jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-4 text-xs text-muted-foreground", children: [_jsx("span", { className: "font-medium text-foreground", children: "Deliver via" }), _jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx(Checkbox, { checked: draft.inApp, onCheckedChange: (checked) => onChange({ inApp: checked === true }) }), _jsx(IconBell, { className: "size-3.5" }), " In app"] }), _jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx(Checkbox, { checked: draft.email, onCheckedChange: (checked) => onChange({ email: checked === true }) }), _jsx(IconMail, { className: "size-3.5" }), " Email"] }), _jsxs("div", { className: "ms-auto flex items-center gap-2", children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: onCancel, children: "Cancel" }), _jsxs(Button, { type: "button", size: "sm", onClick: onSave, disabled: isPending || channelCount === 0, children: [isPending ? _jsx(IconLoader2, { className: "animate-spin" }) : null, "Save alert"] })] })] })] }));
 }
 function UsageAlertsSection({ appId }) {
     const query = useActionQuery("get-usage-alerts", {
@@ -176,6 +234,7 @@ function UsageAlertsSection({ appId }) {
                     }), editing && !editing.ruleId ? (_jsxs("div", { className: "px-4 py-4", children: [_jsx("div", { className: "mb-2 text-xs font-medium text-muted-foreground", children: appLabel(editing.appId) }), _jsx(AlertEditor, { draft: editing, onChange: (patch) => setEditing((current) => current ? { ...current, ...patch } : current), onSave: saveDraft, onCancel: () => setEditing(null), isPending: mutation.isPending })] })) : null] })] }));
 }
 export function UsageSection({ appId = null, viewAllHref, }) {
+    const t = useT();
     const [sinceDays, setSinceDays] = useState(30);
     const [scope, setScope] = useState("me");
     const [selectedUserEmail, setSelectedUserEmail] = useState(null);
@@ -199,8 +258,37 @@ export function UsageSection({ appId = null, viewAllHref, }) {
     return (_jsxs("div", { className: "mx-auto w-full max-w-5xl space-y-6", children: [_jsxs("header", { className: "flex flex-col gap-4 border-b border-border/70 pb-5 lg:flex-row lg:items-end lg:justify-between", children: [_jsxs("div", { children: [_jsxs("div", { className: "flex items-center gap-2 text-xs font-medium uppercase tracking-[0.1em] text-primary", children: [_jsx(IconChartLine, { className: "size-4" }), " Usage"] }), _jsxs("h1", { className: "mt-2 text-xl font-semibold tracking-[-0.02em] text-foreground", children: [appLabel(appId), " usage"] }), _jsx("p", { className: "mt-1 max-w-xl text-sm leading-6 text-muted-foreground", children: "A focused view of spend, capacity, and the prompts driving this app." })] }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [data?.access.canViewWorkspace ? (_jsxs(Select, { value: scope, onValueChange: (value) => {
                                     setScope(value);
                                     setSelectedUserEmail(null);
-                                }, children: [_jsx(SelectTrigger, { className: "h-9 w-32 text-xs", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "me", children: "My usage" }), _jsx(SelectItem, { value: "workspace", children: "Workspace" })] })] })) : null, scope === "workspace" && data ? (_jsxs(Select, { value: selectedUserEmail ?? "all", onValueChange: (value) => setSelectedUserEmail(value === "all" ? null : value), children: [_jsx(SelectTrigger, { className: "h-9 w-44 text-xs", children: _jsx(SelectValue, { placeholder: "All users" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "all", children: "All users" }), data.availableUsers.map((user) => (_jsx(SelectItem, { value: user.email, children: user.email }, user.email)))] })] })) : null, _jsx("div", { className: "flex items-center rounded-md border border-border/70 p-0.5", children: LOOKBACKS.map((range) => (_jsx(Button, { type: "button", variant: sinceDays === range.value ? "secondary" : "ghost", size: "sm", className: "h-8 px-2.5 text-xs", onClick: () => setSinceDays(range.value), children: range.label }, range.value))) }), _jsx(Button, { type: "button", variant: "outline", size: "icon", onClick: () => void query.refetch(), disabled: query.isFetching, "aria-label": "Refresh usage", title: "Refresh usage", children: query.isFetching ? (_jsx(IconLoader2, { className: "animate-spin" })) : (_jsx(IconRefresh, {})) })] })] }), query.isError && !data ? (_jsxs("div", { className: "rounded-lg border border-destructive/30 bg-destructive/5 px-4 py-4 text-sm", role: "alert", children: [_jsx("div", { className: "font-medium text-destructive", children: "Usage data couldn\u2019t be loaded." }), _jsx(Button, { type: "button", variant: "link", size: "sm", className: "mt-1 h-auto p-0", onClick: () => void query.refetch(), children: "Try again" })] })) : null, !data && query.isLoading ? _jsx(UsageLoadingState, {}) : null, data ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-3 sm:grid-cols-3", children: [_jsx(MetricCard, { label: billing.label, value: formatCost(data.totals.costCents, billing), detail: `${sinceDays} day lookback`, accent: true }), _jsx(MetricCard, { label: "Calls", value: data.totals.calls.toLocaleString(), detail: `${data.currentDay.calls.toLocaleString()} today` }), _jsx(MetricCard, { label: "Tokens", value: compactNumber(totalTokens), detail: `${compactNumber(data.currentDay.tokens)} today` })] }), _jsxs("section", { className: "rounded-lg border border-border/70 bg-card p-4", children: [_jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-sm font-semibold text-foreground", children: "Daily trend" }), _jsxs("p", { className: "mt-1 text-xs text-muted-foreground", children: [formatCost(data.currentDay.costCents, billing), " used today \u00B7", " ", data.currentDay.calls.toLocaleString(), " calls"] })] }), _jsxs("div", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [scope === "workspace" ? (_jsx(IconUsers, { className: "size-3.5" })) : null, scope === "workspace"
+                                }, children: [_jsx(SelectTrigger, { className: "h-9 w-32 text-xs", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "me", children: "My usage" }), _jsx(SelectItem, { value: "workspace", children: "Workspace" })] })] })) : null, scope === "workspace" && data ? (_jsxs(Select, { value: selectedUserEmail ?? "all", onValueChange: (value) => setSelectedUserEmail(value === "all" ? null : value), children: [_jsx(SelectTrigger, { className: "h-9 w-44 text-xs", children: _jsx(SelectValue, { placeholder: "All users" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "all", children: "All users" }), data.availableUsers.map((user) => (_jsx(SelectItem, { value: user.email, children: user.email }, user.email)))] })] })) : null, _jsx("div", { className: "flex items-center rounded-md border border-border/70 p-0.5", children: LOOKBACKS.map((range) => (_jsx(Button, { type: "button", variant: sinceDays === range.value ? "secondary" : "ghost", size: "sm", className: "h-8 px-2.5 text-xs", onClick: () => setSinceDays(range.value), children: range.label }, range.value))) }), _jsx(Button, { type: "button", variant: "outline", size: "icon", onClick: () => void query.refetch(), disabled: query.isFetching, "aria-label": "Refresh usage", title: "Refresh usage", children: query.isFetching ? (_jsx(IconLoader2, { className: "animate-spin" })) : (_jsx(IconRefresh, {})) })] })] }), query.isError && !data ? (_jsxs("div", { className: "rounded-lg border border-destructive/30 bg-destructive/5 px-4 py-4 text-sm", role: "alert", children: [_jsx("div", { className: "font-medium text-destructive", children: "Usage data couldn\u2019t be loaded." }), _jsx(Button, { type: "button", variant: "link", size: "sm", className: "mt-1 h-auto p-0", onClick: () => void query.refetch(), children: "Try again" })] })) : null, !data && query.isLoading ? _jsx(UsageLoadingState, {}) : null, data ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: `grid gap-3 ${billing.unit === "mixed" ? "sm:grid-cols-2 xl:grid-cols-4" : "sm:grid-cols-3"}`, children: [_jsx(MetricCard, { label: billing.unit === "builder-credits"
+                                    ? t("agentChat.usage.builderCredits", {
+                                        defaultValue: "Builder credits",
+                                    })
+                                    : billing.unit === "mixed"
+                                        ? t("agentChat.usage.builderCredits", {
+                                            defaultValue: "Builder credits",
+                                        })
+                                        : billing.label, value: formatCost(t, data.totals.costCents, billing, data.totals.builderCredits, data.totals.estimatedBuilderCredits, data.totals.otherCostCents, false), detail: `${sinceDays} day lookback`, accent: true }), billing.unit === "mixed" ? (_jsx(MetricCard, { label: t("agentChat.usage.otherUnclassifiedSpend", {
+                                    defaultValue: "Other or unclassified USD spend",
+                                }), value: formatUsdCost(data.totals.otherCostCents ?? 0), detail: t("agentChat.usage.providerSpendDetail", {
+                                    defaultValue: "Provider or older calls outside Builder billing",
+                                }) })) : null, _jsx(MetricCard, { label: "Calls", value: data.totals.calls.toLocaleString(), detail: `${data.currentDay.calls.toLocaleString()} today` }), _jsx(MetricCard, { label: "Tokens", value: compactNumber(totalTokens), detail: `${compactNumber(data.currentDay.tokens)} today` })] }), _jsxs("section", { className: "rounded-lg border border-border/70 bg-card p-4", children: [_jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-sm font-semibold text-foreground", children: "Daily trend" }), _jsxs("p", { className: "mt-1 text-xs text-muted-foreground", children: [formatCost(t, data.currentDay.costCents, billing, data.currentDay.credits, data.currentDay.estimatedBuilderCredits, data.currentDay.otherCostCents, false), " ", "used today \u00B7 ", data.currentDay.calls.toLocaleString(), " calls"] }), billing.unit === "mixed" &&
+                                                (data.currentDay.otherCalls ?? 0) > 0 ? (_jsx("p", { className: "mt-1 text-xs text-muted-foreground", children: t("agentChat.usage.providerSpendToday", {
+                                                    defaultValue: "Other or unclassified usage: {{amount}} today",
+                                                    amount: formatUsdCost(data.currentDay.otherCostCents ?? 0),
+                                                }) })) : null] }), _jsxs("div", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [scope === "workspace" ? (_jsx(IconUsers, { className: "size-3.5" })) : null, scope === "workspace"
                                                 ? (selectedUserEmail ?? "All users")
-                                                : "Your usage"] })] }), _jsx("div", { className: "mt-4", children: _jsx(Trend, { daily: data.daily, billing: billing }) })] }), _jsxs("details", { className: "group rounded-lg border border-border/70 bg-card", children: [_jsxs("summary", { className: "flex cursor-pointer list-none items-center justify-between gap-3 px-4 py-4 outline-none transition-colors hover:bg-accent/30 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset [&::-webkit-details-marker]:hidden", children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-semibold text-foreground", children: "Top usage drivers" }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Breakdowns stay collapsed until you need them." })] }), _jsx(IconChevronDown, { className: "size-4 text-muted-foreground transition-transform group-open:rotate-180" })] }), _jsxs("div", { className: "grid gap-6 border-t border-border/70 px-4 py-4 md:grid-cols-2", children: [_jsx(DriverList, { title: "By workflow", rows: data.byLabel, billing: billing }), _jsx(DriverList, { title: "By model", rows: data.byModel, billing: billing })] })] }), _jsxs("details", { className: "group rounded-lg border border-border/70 bg-card", children: [_jsxs("summary", { className: "flex cursor-pointer list-none items-center justify-between gap-3 px-4 py-4 outline-none transition-colors hover:bg-accent/30 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset [&::-webkit-details-marker]:hidden", children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-semibold text-foreground", children: "Recent prompts" }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Latest recorded prompts for the selected app and user scope." })] }), _jsxs("span", { className: "flex items-center gap-2 text-xs text-muted-foreground", children: [data.recent.length, _jsx(IconChevronDown, { className: "size-4 transition-transform group-open:rotate-180" })] })] }), _jsx("div", { className: "border-t border-border/70", children: data.recent.length === 0 ? (_jsx("p", { className: "px-4 py-5 text-sm text-muted-foreground", children: "No recent prompts recorded." })) : (_jsx("div", { className: "divide-y divide-border/60", children: data.recent.map((entry) => (_jsxs("div", { className: "px-4 py-3", children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2 text-[11px] text-muted-foreground", children: [_jsxs("span", { children: [entry.label, " \u00B7 ", entry.model] }), _jsx("span", { children: entry.ownerEmail })] }), _jsx("p", { className: "mt-1 line-clamp-2 text-sm text-foreground", children: entry.prompt ??
+                                                : "Your usage"] })] }), _jsx("div", { className: "mt-4", children: _jsxs("div", { className: billing.unit === "mixed" &&
+                                        (data.totals.otherCostCents ?? 0) > 0
+                                        ? "grid gap-4 md:grid-cols-2"
+                                        : "", children: [_jsxs("div", { children: [billing.unit === "mixed" ? (_jsx("h3", { className: "mb-2 text-xs font-medium text-muted-foreground", children: t("agentChat.usage.builderCredits", {
+                                                        defaultValue: "Builder credits",
+                                                    }) })) : null, _jsx(Trend, { daily: data.daily, billing: billing })] }), billing.unit === "mixed" &&
+                                            (data.totals.otherCostCents ?? 0) > 0 ? (_jsxs("div", { children: [_jsx("h3", { className: "mb-2 text-xs font-medium text-muted-foreground", children: t("agentChat.usage.otherUnclassifiedSpend", {
+                                                        defaultValue: "Other or unclassified USD spend",
+                                                    }) }), _jsx(Trend, { daily: data.daily.map((day) => ({
+                                                        date: day.date,
+                                                        costCents: day.otherCostCents ?? 0,
+                                                        calls: day.otherCalls ?? 0,
+                                                        tokens: 0,
+                                                    })), billing: { unit: "usd", label: "USD" } })] })) : null] }) })] }), _jsxs("details", { className: "group rounded-lg border border-border/70 bg-card", children: [_jsxs("summary", { className: "flex cursor-pointer list-none items-center justify-between gap-3 px-4 py-4 outline-none transition-colors hover:bg-accent/30 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset [&::-webkit-details-marker]:hidden", children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-semibold text-foreground", children: "Top usage drivers" }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Breakdowns stay collapsed until you need them." })] }), _jsx(IconChevronDown, { className: "size-4 text-muted-foreground transition-transform group-open:rotate-180" })] }), _jsxs("div", { className: "grid gap-6 border-t border-border/70 px-4 py-4 md:grid-cols-2", children: [_jsx(DriverList, { title: "By workflow", rows: data.byLabel, billing: billing }), _jsx(DriverList, { title: "By model", rows: data.byModel, billing: billing })] })] }), _jsxs("details", { className: "group rounded-lg border border-border/70 bg-card", children: [_jsxs("summary", { className: "flex cursor-pointer list-none items-center justify-between gap-3 px-4 py-4 outline-none transition-colors hover:bg-accent/30 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset [&::-webkit-details-marker]:hidden", children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-semibold text-foreground", children: "Recent prompts" }), _jsx("span", { className: "mt-1 block text-xs text-muted-foreground", children: "Latest recorded prompts for the selected app and user scope." })] }), _jsxs("span", { className: "flex items-center gap-2 text-xs text-muted-foreground", children: [data.recent.length, _jsx(IconChevronDown, { className: "size-4 transition-transform group-open:rotate-180" })] })] }), _jsx("div", { className: "border-t border-border/70", children: data.recent.length === 0 ? (_jsx("p", { className: "px-4 py-5 text-sm text-muted-foreground", children: "No recent prompts recorded." })) : (_jsx("div", { className: "divide-y divide-border/60", children: data.recent.map((entry) => (_jsxs("div", { className: "px-4 py-3", children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2 text-[11px] text-muted-foreground", children: [_jsxs("span", { children: [entry.label, " \u00B7 ", entry.model] }), _jsx("span", { children: entry.ownerEmail })] }), _jsx("p", { className: "mt-1 line-clamp-2 text-sm text-foreground", children: entry.prompt ??
                                                     "Prompt text was not captured for this call." })] }, entry.id))) })) })] }), _jsx(UsageAlertsSection, { appId: appId }), viewAllHref ? (_jsx("div", { className: "flex justify-end", children: _jsx(Button, { asChild: true, variant: "link", size: "sm", className: "gap-1.5", children: _jsxs(Link, { to: viewAllHref, children: ["View all usage", _jsx(IconArrowUpRight, {})] }) }) })) : null] })) : null] }));
 }

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/feature-flags/index.d.ts

@@ -1,2 +1,2 @@
-export { CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, getFeatureFlagDefinition, listFeatureFlags, registerFeatureFlags, type FeatureFlagDefinition, } from "./registry.js";
+export { BUILDER_CREDIT_USAGE_REPORTING_FLAG, CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, getFeatureFlagDefinition, listFeatureFlags, registerFeatureFlags, type FeatureFlagDefinition, } from "./registry.js";
 export { defaultFeatureFlagRules, evaluateFeatureFlag, evaluateFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, getFeatureFlagRules, normalizeFeatureFlagRules, type FeatureFlagMode, type FeatureFlagRules, type FeatureFlagScope, } from "./store.js";

package/dist/feature-flags/index.js

@@ -1,4 +1,4 @@
-export { CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, getFeatureFlagDefinition, listFeatureFlags, registerFeatureFlags, } from "./registry.js";
+export { BUILDER_CREDIT_USAGE_REPORTING_FLAG, CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, getFeatureFlagDefinition, listFeatureFlags, registerFeatureFlags, } from "./registry.js";
 export { defaultFeatureFlagRules, evaluateFeatureFlag, evaluateFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, getFeatureFlagRules, normalizeFeatureFlagRules, } from "./store.js";
 // Plugin and A2A auth stay on `./server` and `@agent-native/core/server`.
 // Re-exporting them here pulls HMAC Node builtins into any Vite client that

package/dist/feature-flags/registry.d.ts

@@ -10,6 +10,7 @@ export interface FeatureFlagDefinition {
 export declare function defineFeatureFlag(definition: FeatureFlagDefinition): FeatureFlagDefinition;
 /** Framework-owned labs flag available to every app's feature-flag plugin. */
 export declare const CONNECT_APPS_FLAG: FeatureFlagDefinition;
+export declare const BUILDER_CREDIT_USAGE_REPORTING_FLAG: FeatureFlagDefinition;
 /** Define a small app-owned feature-flag registry. */
 export declare function defineFeatureFlags(definitions: readonly FeatureFlagDefinition[]): readonly FeatureFlagDefinition[];
 /** Register definitions once at Nitro startup. Re-registering identical data is safe for HMR. */

package/dist/feature-flags/registry.js

@@ -25,6 +25,11 @@ export const CONNECT_APPS_FLAG = defineFeatureFlag({
     displayName: "Connect apps",
     description: "Show the experimental app connection surface.",
 });
+export const BUILDER_CREDIT_USAGE_REPORTING_FLAG = defineFeatureFlag({
+    key: "billing.builder-credit-usage-reporting",
+    displayName: "Builder credit usage reporting",
+    description: "Use the Builder gateway's reported credit charges in usage reports.",
+});
 /** Define a small app-owned feature-flag registry. */
 export function defineFeatureFlags(definitions) {
     const seen = new Set();

package/dist/file-upload/actions/upload-image.d.ts

@@ -44,9 +44,9 @@ declare const _default: import("../../action.js").ActionDefinition<{
     url: string;
     id: string;
     provider: string;
-    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
+    error?: undefined;
 } | {
     url?: undefined;
     id?: undefined;

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { createDevScriptRegistry } from "./scripts/dev/index.js";
 export { createAgentChatPlugin, defaultAgentChatPlugin, createAgentNativeEmbeddedPlugin, mountAgentNativeEmbedded, createServer, createSSEHandler, defineNitroPlugin, autoMountAuth, getSession, type AgentChatPluginOptions, type AgentNativeEmbeddedPluginOptions, type AuthSession, type AuthOptions, type CreateServerOptions, type SSEHandlerOptions, } from "./root-server-compat.js";
 export { BUILT_IN_INTEGRATION_CATALOG, INTEGRATION_CATEGORIES, getIntegrationCatalogEntry, listBuiltInChannelIntegrations, listIntegrationCatalog, type AutomationCapabilities, type BuiltInChannelId, type ChannelCapabilities, type IntegrationAvailability, type IntegrationCatalogEntry, type IntegrationCategory, type IntegrationCredentialRequirement, type IntegrationIconKey, type IntegrationSupportMaturity, } from "./integrations/catalog.js";
 export { AutomationConnectorError, createAutomationCallbackHandler, createAutomationRuntime, createInvokeAutomationWorkflowAction, type AutomationCallbackAuthentication, type AutomationCallbackInput, type AutomationCallbackResult, type AutomationInboundDefinition, type AutomationInvocation, type AutomationInvocationResult, type AutomationInvocationStatus, type AutomationOutboundDefinition, type AutomationResponseMode, type AutomationRetryPolicy, type AutomationRuntime, type AutomationRuntimeOptions, type AutomationWorkflowCapabilities, type AutomationWorkflowDefinition, type JsonSchema, } from "./automation/index.js";
-export { CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, evaluateFeatureFlag, getFeatureFlagDefinition, getFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, listFeatureFlags, registerFeatureFlags, type FeatureFlagDefinition, type FeatureFlagMode, type FeatureFlagRules, type FeatureFlagScope, } from "./feature-flags/index.js";
+export { BUILDER_CREDIT_USAGE_REPORTING_FLAG, CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, evaluateFeatureFlag, getFeatureFlagDefinition, getFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, listFeatureFlags, registerFeatureFlags, type FeatureFlagDefinition, type FeatureFlagMode, type FeatureFlagRules, type FeatureFlagScope, } from "./feature-flags/index.js";
 export { createFeatureFlagA2AActionRouteAuth, createFeatureFlagsPlugin, } from "./feature-flags/server.js";
 export { defineLab, defineLabs, getLabDefinition, listLabs, registerLabs, type LabDefinition, } from "./labs/index.js";
 export { createLabsPlugin } from "./labs/server.js";

package/dist/index.js

@@ -16,7 +16,7 @@ export { createDevScriptRegistry } from "./scripts/dev/index.js";
 export { createAgentChatPlugin, defaultAgentChatPlugin, createAgentNativeEmbeddedPlugin, mountAgentNativeEmbedded, createServer, createSSEHandler, defineNitroPlugin, autoMountAuth, getSession, } from "./root-server-compat.js";
 export { BUILT_IN_INTEGRATION_CATALOG, INTEGRATION_CATEGORIES, getIntegrationCatalogEntry, listBuiltInChannelIntegrations, listIntegrationCatalog, } from "./integrations/catalog.js";
 export { AutomationConnectorError, createAutomationCallbackHandler, createAutomationRuntime, createInvokeAutomationWorkflowAction, } from "./automation/index.js";
-export { CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, evaluateFeatureFlag, getFeatureFlagDefinition, getFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, listFeatureFlags, registerFeatureFlags, } from "./feature-flags/index.js";
+export { BUILDER_CREDIT_USAGE_REPORTING_FLAG, CONNECT_APPS_FLAG, defineFeatureFlag, defineFeatureFlags, evaluateFeatureFlag, getFeatureFlagDefinition, getFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, listFeatureFlags, registerFeatureFlags, } from "./feature-flags/index.js";
 export { createFeatureFlagA2AActionRouteAuth, createFeatureFlagsPlugin, } from "./feature-flags/server.js";
 export { defineLab, defineLabs, getLabDefinition, listLabs, registerLabs, } from "./labs/index.js";
 export { createLabsPlugin } from "./labs/server.js";

package/dist/integrations/webhook-handler.js

@@ -1448,7 +1448,8 @@ async function recordIntegrationUsage(options) {
         (usage.inputTokens <= 0 &&
             usage.outputTokens <= 0 &&
             usage.cacheReadTokens <= 0 &&
-            usage.cacheWriteTokens <= 0)) {
+            usage.cacheWriteTokens <= 0 &&
+            usage.builderCreditsUsed == null)) {
         return;
     }
     try {
@@ -1459,6 +1460,8 @@ async function recordIntegrationUsage(options) {
             outputTokens: usage.outputTokens,
             cacheReadTokens: usage.cacheReadTokens,
             cacheWriteTokens: usage.cacheWriteTokens,
+            builderCreditsUsed: usage.builderCreditsUsed,
+            engineName: usage.engineName,
             model: usage.model,
             label: `integration:${options.incoming.platform}`,
             app: options.appId,

package/dist/jobs/background-automation-runner.js

@@ -598,7 +598,8 @@ async function executeBackgroundAutomation(options, deps, historyId, runIdRef) {
             (usage.inputTokens > 0 ||
                 usage.outputTokens > 0 ||
                 usage.cacheReadTokens > 0 ||
-                usage.cacheWriteTokens > 0)) {
+                usage.cacheWriteTokens > 0 ||
+                usage.builderCreditsUsed != null)) {
             try {
                 const { recordUsage } = await import("../usage/store.js");
                 await recordUsage({
@@ -607,6 +608,10 @@ async function executeBackgroundAutomation(options, deps, historyId, runIdRef) {
                     outputTokens: usage.outputTokens,
                     cacheReadTokens: usage.cacheReadTokens,
                     cacheWriteTokens: usage.cacheWriteTokens,
+                    ...(usage.builderCreditsUsed == null
+                        ? {}
+                        : { builderCreditsUsed: usage.builderCreditsUsed }),
+                    engineName: usage.engineName ?? engine.name,
                     model: usage.model,
                     label: usageLabel,
                     app: deps.appId,

package/dist/localization/core-messages/ar-SA.js

@@ -425,7 +425,7 @@ const messages = {
     "errorMessages.providerRateLimit": "يفرض مزوّد النموذج حاليًا حدًا على معدل طلبات هذه المحادثة. انتظر قليلًا، ثم أعد المحاولة.",
     "errorMessages.providerTransientRejection": "رفض مزوّد الذكاء الاصطناعي هذا الطلب مؤقتًا. عادةً ما يُحل هذا خلال دقيقة — أعد المحاولة.",
     "errorMessages.startNewChat": "بدء محادثة جديدة",
-    "errorMessages.upgradeAtBuilder": "الترقية عبر Builder.io",
+    "errorMessages.addCreditsInBuilder": "إضافة أرصدة في Builder",
     "feedback.inaccurate": "غير دقيق",
     "feedback.keyboardHint": "{{shortcut}} Enter للإرسال",
     "feedback.notHelpful": "غير مفيد",
@@ -753,5 +753,13 @@ const messages = {
     "settings.emailChangeError": "تعذر إرسال التأكيد.",
     "settings.emailNewLabel": "البريد الإلكتروني الجديد",
     "settings.emailNewPlaceholder": "أدخل بريدًا إلكترونيًا جديدًا",
+    "usage.builderCredits": "أرصدة Builder",
+    "usage.estimatedBuilderCredits": "~{{amount}} رصيد مقدّر",
+    "usage.otherUsdSpend": "{{amount}} دولار أمريكي أخرى",
+    "usage.noBuilderCredits": "0 من أرصدة Builder",
+    "usage.otherUnclassifiedSpend": "إنفاق آخر أو غير مصنّف بالدولار الأمريكي",
+    "usage.providerSpendDetail": "استخدام المزوّد أو المكالمات الأقدم خارج فوترة Builder",
+    "usage.providerSpendToday": "استخدام آخر أو غير مصنّف اليوم: {{amount}}",
+    "usage.driverCreditsAndUsd": "أرصدة Builder / دولار أمريكي",
 };
 export default messages;

package/dist/localization/core-messages/de-DE.js

@@ -595,7 +595,7 @@ const messages = {
     "errorMessages.providerRateLimit": "Der Modellanbieter begrenzt diesen Chat derzeit. Warte einen Moment und versuche es dann erneut.",
     "errorMessages.providerTransientRejection": "Der KI-Anbieter hat diese Anfrage vorübergehend abgelehnt. Das behebt sich meist innerhalb einer Minute – versuche es erneut.",
     "errorMessages.startNewChat": "Neuen Chat starten",
-    "errorMessages.upgradeAtBuilder": "Bei Builder.io upgraden",
+    "errorMessages.addCreditsInBuilder": "Credits bei Builder hinzufügen",
     "feedback.inaccurate": "Ungenau",
     "feedback.keyboardHint": "{{shortcut}} Enter zum Senden",
     "feedback.notHelpful": "Nicht hilfreich",
@@ -725,5 +725,13 @@ const messages = {
     "settings.emailChangeError": "Bestätigung konnte nicht gesendet werden.",
     "settings.emailNewLabel": "Neue E-Mail-Adresse",
     "settings.emailNewPlaceholder": "Neue E-Mail-Adresse eingeben",
+    "usage.builderCredits": "Builder-Credits",
+    "usage.estimatedBuilderCredits": "~{{amount}} geschätzte Credits",
+    "usage.otherUsdSpend": "{{amount}} USD sonstige",
+    "usage.noBuilderCredits": "0 Builder-Credits",
+    "usage.otherUnclassifiedSpend": "Sonstige oder nicht zugeordnete Ausgaben in USD",
+    "usage.providerSpendDetail": "Anbieteraufrufe oder ältere Aufrufe außerhalb der Builder-Abrechnung",
+    "usage.providerSpendToday": "Sonstige oder nicht zugeordnete Nutzung heute: {{amount}}",
+    "usage.driverCreditsAndUsd": "Builder-Credits / USD",
 };
 export default messages;