@agent-native/core 0.191.0 → 0.192.0-nightly-20260926045737

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

@@ -766,6 +766,10 @@ const messages = {
     "settings.emailNewLabel": "البريد الإلكتروني الجديد",
     "settings.emailNewPlaceholder": "أدخل بريدًا إلكترونيًا جديدًا",
     "usage.builderCredits": "أرصدة Builder",
+    "usage.inviteFriends": "ادعُ الأصدقاء",
+    "usage.inviteCredits": "احصل على {{amount}} من أرصدة Builder عندما يشترك صديق.",
+    "usage.copyInviteLink": "نسخ رابط الدعوة",
+    "usage.inviteLinkCopied": "تم نسخ رابط الدعوة",
     "usage.creditBalance": "رصيد مساحة العمل",
     "usage.monthlyPlan": "الخطة الشهرية",
     "usage.dailyFreeLimit": "الحد اليومي المجاني",

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

@@ -738,6 +738,10 @@ const messages = {
     "settings.emailNewLabel": "Neue E-Mail-Adresse",
     "settings.emailNewPlaceholder": "Neue E-Mail-Adresse eingeben",
     "usage.builderCredits": "Builder-Credits",
+    "usage.inviteFriends": "Freunde einladen",
+    "usage.inviteCredits": "Erhalte {{amount}} Builder-Credits, wenn sich ein Freund anmeldet.",
+    "usage.copyInviteLink": "Einladungslink kopieren",
+    "usage.inviteLinkCopied": "Einladungslink kopiert",
     "usage.creditBalance": "Workspace-Guthaben",
     "usage.monthlyPlan": "Monatsplan",
     "usage.dailyFreeLimit": "Tägliches Gratislimit",

package/dist/localization/core-messages/en-US.d.ts

@@ -738,6 +738,10 @@ declare const messages: {
     readonly "settings.emailNewLabel": "New email";
     readonly "settings.emailNewPlaceholder": "Enter new email";
     readonly "usage.builderCredits": "Builder credits";
+    readonly "usage.inviteFriends": "Invite friends";
+    readonly "usage.inviteCredits": "Earn {{amount}} Builder credits when a friend subscribes.";
+    readonly "usage.copyInviteLink": "Copy invite link";
+    readonly "usage.inviteLinkCopied": "Invite link copied";
     readonly "usage.creditBalance": "Workspace balance";
     readonly "usage.monthlyPlan": "Monthly plan";
     readonly "usage.dailyFreeLimit": "Free daily limit";

package/dist/localization/core-messages/en-US.js

@@ -738,6 +738,10 @@ const messages = {
     "settings.emailNewLabel": "New email",
     "settings.emailNewPlaceholder": "Enter new email",
     "usage.builderCredits": "Builder credits",
+    "usage.inviteFriends": "Invite friends",
+    "usage.inviteCredits": "Earn {{amount}} Builder credits when a friend subscribes.",
+    "usage.copyInviteLink": "Copy invite link",
+    "usage.inviteLinkCopied": "Invite link copied",
     "usage.creditBalance": "Workspace balance",
     "usage.monthlyPlan": "Monthly plan",
     "usage.dailyFreeLimit": "Free daily limit",

package/dist/localization/core-messages/es-ES.js

@@ -745,6 +745,10 @@ const messages = {
     "settings.emailNewLabel": "Correo electrónico nuevo",
     "settings.emailNewPlaceholder": "Introduce un correo nuevo",
     "usage.builderCredits": "Créditos de Builder",
+    "usage.inviteFriends": "Invita a tus amigos",
+    "usage.inviteCredits": "Gana {{amount}} créditos de Builder cuando un amigo se suscriba.",
+    "usage.copyInviteLink": "Copiar enlace de invitación",
+    "usage.inviteLinkCopied": "Enlace de invitación copiado",
     "usage.creditBalance": "Saldo del espacio de trabajo",
     "usage.monthlyPlan": "Plan mensual",
     "usage.dailyFreeLimit": "Límite diario gratuito",

package/dist/localization/core-messages/fr-FR.js

@@ -745,6 +745,10 @@ const messages = {
     "settings.emailNewLabel": "Nouvelle adresse e-mail",
     "settings.emailNewPlaceholder": "Saisissez une nouvelle adresse e-mail",
     "usage.builderCredits": "Crédits Builder",
+    "usage.inviteFriends": "Inviter des amis",
+    "usage.inviteCredits": "Gagnez {{amount}} crédits Builder lorsqu’un ami s’abonne.",
+    "usage.copyInviteLink": "Copier le lien d’invitation",
+    "usage.inviteLinkCopied": "Lien d’invitation copié",
     "usage.creditBalance": "Solde de l’espace de travail",
     "usage.monthlyPlan": "Forfait mensuel",
     "usage.dailyFreeLimit": "Limite quotidienne gratuite",

package/dist/localization/core-messages/hi-IN.js

@@ -738,6 +738,10 @@ const messages = {
     "settings.emailNewLabel": "नया ईमेल",
     "settings.emailNewPlaceholder": "नया ईमेल दर्ज करें",
     "usage.builderCredits": "Builder क्रेडिट",
+    "usage.inviteFriends": "दोस्तों को आमंत्रित करें",
+    "usage.inviteCredits": "दोस्त के सदस्यता लेने पर {{amount}} Builder क्रेडिट पाएं।",
+    "usage.copyInviteLink": "आमंत्रण लिंक कॉपी करें",
+    "usage.inviteLinkCopied": "आमंत्रण लिंक कॉपी हो गया",
     "usage.creditBalance": "वर्कस्पेस बैलेंस",
     "usage.monthlyPlan": "मासिक प्लान",
     "usage.dailyFreeLimit": "मुफ़्त दैनिक सीमा",

package/dist/localization/core-messages/ja-JP.js

@@ -731,6 +731,10 @@ const messages = {
     "settings.emailNewLabel": "新しいメールアドレス",
     "settings.emailNewPlaceholder": "新しいメールアドレスを入力",
     "usage.builderCredits": "Builder クレジット",
+    "usage.inviteFriends": "友だちを招待",
+    "usage.inviteCredits": "友だちが登録すると Builder クレジットを {{amount}} 獲得できます。",
+    "usage.copyInviteLink": "招待リンクをコピー",
+    "usage.inviteLinkCopied": "招待リンクをコピーしました",
     "usage.creditBalance": "ワークスペース残高",
     "usage.monthlyPlan": "月間プラン",
     "usage.dailyFreeLimit": "無料の日次上限",

package/dist/localization/core-messages/ko-KR.js

@@ -731,6 +731,10 @@ const messages = {
     "settings.emailNewLabel": "새 이메일",
     "settings.emailNewPlaceholder": "새 이메일 입력",
     "usage.builderCredits": "Builder 크레딧",
+    "usage.inviteFriends": "친구 초대",
+    "usage.inviteCredits": "친구가 구독하면 Builder 크레딧 {{amount}}개를 받을 수 있습니다.",
+    "usage.copyInviteLink": "초대 링크 복사",
+    "usage.inviteLinkCopied": "초대 링크를 복사했습니다",
     "usage.creditBalance": "워크스페이스 잔액",
     "usage.monthlyPlan": "월간 플랜",
     "usage.dailyFreeLimit": "무료 일일 한도",

package/dist/localization/core-messages/pt-BR.js

@@ -745,6 +745,10 @@ const messages = {
     "settings.emailNewLabel": "Novo e-mail",
     "settings.emailNewPlaceholder": "Digite o novo e-mail",
     "usage.builderCredits": "Créditos do Builder",
+    "usage.inviteFriends": "Convide amigos",
+    "usage.inviteCredits": "Ganhe {{amount}} créditos do Builder quando um amigo assinar.",
+    "usage.copyInviteLink": "Copiar link de convite",
+    "usage.inviteLinkCopied": "Link de convite copiado",
     "usage.creditBalance": "Saldo do workspace",
     "usage.monthlyPlan": "Plano mensal",
     "usage.dailyFreeLimit": "Limite diário gratuito",

package/dist/localization/core-messages/zh-CN.js

@@ -731,6 +731,10 @@ const messages = {
     "settings.emailNewLabel": "新电子邮件",
     "settings.emailNewPlaceholder": "输入新电子邮件",
     "usage.builderCredits": "Builder 积分",
+    "usage.inviteFriends": "邀请好友",
+    "usage.inviteCredits": "好友订阅后可获得 {{amount}} 个 Builder 积分。",
+    "usage.copyInviteLink": "复制邀请链接",
+    "usage.inviteLinkCopied": "邀请链接已复制",
     "usage.creditBalance": "工作区余额",
     "usage.monthlyPlan": "月度套餐",
     "usage.dailyFreeLimit": "免费每日上限",

package/dist/localization/core-messages/zh-TW.js

@@ -731,6 +731,10 @@ const messages = {
     "settings.emailNewLabel": "新電子郵件",
     "settings.emailNewPlaceholder": "輸入新電子郵件",
     "usage.builderCredits": "Builder 點數",
+    "usage.inviteFriends": "邀請朋友",
+    "usage.inviteCredits": "朋友訂閱後可獲得 {{amount}} 點 Builder 點數。",
+    "usage.copyInviteLink": "複製邀請連結",
+    "usage.inviteLinkCopied": "邀請連結已複製",
     "usage.creditBalance": "工作區餘額",
     "usage.monthlyPlan": "月度方案",
     "usage.dailyFreeLimit": "免費每日上限",

package/dist/localization/core-messages.d.ts

@@ -740,6 +740,10 @@ export declare const englishAgentChatMessages: {
     readonly "settings.emailNewLabel": "New email";
     readonly "settings.emailNewPlaceholder": "Enter new email";
     readonly "usage.builderCredits": "Builder credits";
+    readonly "usage.inviteFriends": "Invite friends";
+    readonly "usage.inviteCredits": "Earn {{amount}} Builder credits when a friend subscribes.";
+    readonly "usage.copyInviteLink": "Copy invite link";
+    readonly "usage.inviteLinkCopied": "Invite link copied";
     readonly "usage.creditBalance": "Workspace balance";
     readonly "usage.monthlyPlan": "Monthly plan";
     readonly "usage.dailyFreeLimit": "Free daily limit";

package/dist/notifications/routes.d.ts

@@ -17,17 +17,17 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     ok?: undefined;
 } | {
     error?: undefined;
+    count?: undefined;
     updated: number;
     ok?: undefined;
-    count?: undefined;
 } | {
+    count?: undefined;
     updated?: undefined;
     error: string;
     ok?: undefined;
-    count?: undefined;
 } | {
     error?: undefined;
+    count?: undefined;
     updated?: undefined;
     ok: boolean;
-    count?: undefined;
 }>>;

package/dist/observability/routes.d.ts

@@ -41,27 +41,27 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
+    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
+} | {
     error?: undefined;
     ok?: undefined;
-} | {
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
-    ok?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
-    ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
-    error?: undefined;
     ok: boolean;
 }>>;

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -76,8 +76,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     }>>;
 }, z.core.$strip>>, {
     id?: undefined;
+    provider?: undefined;
     deleted?: undefined;
-    found?: undefined;
     providers: {
         id: string;
         label: string;
@@ -88,7 +88,7 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
+    found?: undefined;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
@@ -103,31 +103,31 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     deleted?: undefined;
     count?: undefined;
     providers?: undefined;
-    provider?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     count?: undefined;
-    found?: undefined;
     providers?: undefined;
-    provider?: undefined;
+    found?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     deleted?: undefined;
     count?: undefined;
-    found?: undefined;
     providers?: undefined;
-    provider?: undefined;
+    found?: undefined;
     registered: boolean;
     id: string;
     label: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -311,10 +311,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
-        message?: undefined;
         id?: undefined;
         deleted?: undefined;
-        found?: undefined;
+        provider?: undefined;
         providers: {
             id: string;
             label: string;
@@ -325,45 +324,46 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
-        provider?: undefined;
+        found?: undefined;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
+    } | {
         id?: undefined;
-        count?: undefined;
         deleted?: undefined;
         providers?: undefined;
+        count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
-        count?: undefined;
+    } | {
         deleted?: undefined;
-        providers?: undefined;
         provider?: undefined;
+        providers?: undefined;
+        count?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
+    } | {
+        provider?: undefined;
+        providers?: undefined;
         count?: undefined;
         found?: undefined;
-        providers?: undefined;
-        provider?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
+        message?: undefined;
     } | {
-        count?: undefined;
         deleted?: undefined;
-        found?: undefined;
-        providers?: undefined;
         provider?: undefined;
+        providers?: undefined;
+        count?: undefined;
+        found?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/secrets/routes.d.ts

@@ -57,16 +57,16 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    status?: undefined;
     ok?: undefined;
+    status?: undefined;
 } | {
     ok: boolean;
     status: string;
     error?: undefined;
 } | {
+    ok?: undefined;
     error: string;
     removed?: undefined;
-    ok?: undefined;
 } | {
     ok: boolean;
     removed: boolean;
@@ -77,9 +77,9 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    ok?: undefined;
     error: string;
     note?: undefined;
-    ok?: undefined;
 } | {
     ok: boolean;
     note?: undefined;

package/dist/server/action-discovery.js

@@ -716,6 +716,10 @@ export async function mergeCoreSharingActions(registry) {
             "get-builder-credit-usage",
             () => import("../usage/actions/get-builder-credit-usage.js"),
         ],
+        [
+            "get-builder-referral-info",
+            () => import("../usage/actions/get-builder-referral-info.js"),
+        ],
         [
             "context-manifest-get",
             () => import("../agent/context-xray/actions/context-manifest-get.js"),

package/dist/server/agent-chat/plugin-options.d.ts

@@ -280,7 +280,7 @@ export interface AgentChatPluginOptions {
      * Which of the framework's OWN agent tools this app exposes — raw SQL,
      * extensions, sharing, review comments, version history, feature flags,
      * localization, audit, context X-Ray, profile, automations, docs, resources,
-     * web, cross-app delegation, chat, email.
+     * browser-session controls, web, cross-app delegation, chat, email.
      *
      * Every group defaults to today's behavior, so omitting this leaves the tool
      * surface unchanged. `"minimal"` (or `{ preset: "minimal" }`) turns them all

package/dist/server/agent-chat-plugin.js

@@ -1223,10 +1223,12 @@ export function createAgentChatPlugin(options) {
             }
             let browserSessionTools = {};
             try {
-                const { createBrowserSessionActionEntries } = await import("../browser-sessions/actions.js");
-                browserSessionTools = createBrowserSessionActionEntries({
-                    getOwnerEmail: () => requireCurrentRunOwner("use browser sessions"),
-                });
+                if (frameworkTools.isEnabled("browserSessions")) {
+                    const { createBrowserSessionActionEntries } = await import("../browser-sessions/actions.js");
+                    browserSessionTools = createBrowserSessionActionEntries({
+                        getOwnerEmail: () => requireCurrentRunOwner("use browser sessions"),
+                    });
+                }
             }
             catch { }
             let remoteBrowserTools = {};

package/dist/server/agent-engine-api-key-route.d.ts

@@ -56,10 +56,10 @@ export declare function createAgentEngineApiKeyHandler(): import("h3").EventHand
     ok: boolean;
     error: string;
 } | {
+    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
-    error?: undefined;
 }>>;
 export {};

package/dist/server/agent-engine-ollama-models-route.d.ts

@@ -5,8 +5,8 @@
  * static suggestion list in `model-config.ts`.
  */
 export declare function createAgentEngineOllamaModelsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
     models?: undefined;
 } | {
     ok: boolean;

package/dist/server/core-routes-plugin.d.ts

@@ -419,8 +419,8 @@ export declare function createPublicRemoteAgentsHandler(discover?: PublicAgentDi
     error: string;
     agents?: undefined;
 } | {
-    agents: Omit<import("./agent-discovery.js").DiscoveredAgent, "auth" | "kind">[];
     error?: undefined;
+    agents: Omit<import("./agent-discovery.js").DiscoveredAgent, "auth" | "kind">[];
 }>>;
 export declare function getBuilderConnectErrorDisposition(error: unknown, connectAttemptId: string | null): "correlated" | "legacy" | null;
 export declare function getBuilderConnectErrorKey(ownerEmail: string, connectAttemptId?: string | null): string;

package/dist/server/fusion-app.d.ts

@@ -24,6 +24,7 @@
  * respond with newline-delimited JSON over chunked HTTP.
  */
 import { z } from "zod";
+import { type BuilderReferralInfo } from "../shared/builder-referrals.js";
 export interface FusionBranchRef {
     projectId: string;
     branchName: string;
@@ -65,6 +66,8 @@ declare const builderCreditUsageSchema: z.ZodObject<{
 export type BuilderCreditUsage = z.infer<typeof builderCreditUsageSchema>;
 /** Current Builder balance and the active free-daily or paid-monthly quota. */
 export declare function getBuilderCreditUsage(): Promise<BuilderCreditUsage | null>;
+/** The connected Builder workspace's eligible referral link and credit totals. */
+export declare function getBuilderReferralInfo(): Promise<BuilderReferralInfo | null>;
 /** The Builder visual-editor URL for a fusion branch. */
 export declare function getFusionBranchEditorUrl(ref: FusionBranchRef): string;
 /** Public URL for a reserved fusion hosting slug. */

package/dist/server/fusion-app.js

@@ -25,6 +25,7 @@
  */
 import { z } from "zod";
 import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
+import { builderReferralInfoSchema, } from "../shared/builder-referrals.js";
 import { resolveBuilderRequestAuthorization, } from "./builder-api-auth.js";
 import { getBuilderApiHost, getBuilderAppHost } from "./builder-browser.js";
 async function resolveFusionAuth(requiredScope) {
@@ -78,6 +79,22 @@ export async function getBuilderCreditUsage() {
     }
     return builderCreditUsageSchema.parse(await response.json());
 }
+/** The connected Builder workspace's eligible referral link and credit totals. */
+export async function getBuilderReferralInfo() {
+    const authorization = await resolveBuilderRequestAuthorization({
+        requiredScope: "builder:ai:invoke",
+    });
+    if (!authorization)
+        return null;
+    const response = await fetch(fusionUrl("/agent-native/credits/v1/referrals", authorization), {
+        headers: { Authorization: authorization.authorization },
+        signal: AbortSignal.timeout(5000),
+    });
+    if (!response.ok) {
+        throw new Error(`Builder referral info failed (${response.status}).`);
+    }
+    return builderReferralInfoSchema.parse(await response.json());
+}
 /** The Builder visual-editor URL for a fusion branch. */
 export function getFusionBranchEditorUrl(ref) {
     const host = getBuilderAppHost().replace(/\/+$/, "");

package/dist/shared/builder-referrals.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const builderReferralInfoSchema: z.ZodObject<{
+    eligible: z.ZodBoolean;
+    inviteUrl: z.ZodNullable<z.ZodString>;
+    creditsPerReferral: z.ZodNumber;
+    completedReferrals: z.ZodNumber;
+    pendingReferrals: z.ZodNumber;
+    creditsEarned: z.ZodNumber;
+}, z.core.$strip>;
+export type BuilderReferralInfo = z.infer<typeof builderReferralInfoSchema>;

package/dist/shared/builder-referrals.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+const safeCount = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+const inviteUrlSchema = z
+    .string()
+    .url()
+    .refine((value) => {
+    const url = new URL(value);
+    return (url.origin === "https://builder.io" &&
+        url.pathname === "/signup" &&
+        /^[0-9a-f]{32}$/i.test(url.searchParams.get("fus_ref") ?? ""));
+});
+export const builderReferralInfoSchema = z
+    .object({
+    eligible: z.boolean(),
+    inviteUrl: inviteUrlSchema.nullable(),
+    creditsPerReferral: safeCount,
+    completedReferrals: safeCount,
+    pendingReferrals: safeCount,
+    creditsEarned: safeCount,
+})
+    .superRefine((info, context) => {
+    if (info.eligible !== Boolean(info.inviteUrl)) {
+        context.addIssue({
+            code: "custom",
+            message: "Referral eligibility and invite URL must agree.",
+            path: ["inviteUrl"],
+        });
+    }
+});

package/dist/usage/actions/get-builder-referral-info.d.ts

@@ -0,0 +1,9 @@
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, {
+    eligible: boolean;
+    inviteUrl?: string;
+    creditsPerReferral: number;
+    completedReferrals: number;
+    pendingReferrals: number;
+    creditsEarned: number;
+}>;
+export default _default;

package/dist/usage/actions/get-builder-referral-info.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { defineAction } from "../../action.js";
+import { BUILDER_CREDIT_USAGE_REPORTING_FLAG } from "../../feature-flags/registry.js";
+import { isFeatureFlagEnabled } from "../../feature-flags/store.js";
+import { getBuilderReferralInfo } from "../../server/fusion-app.js";
+import { ForbiddenError } from "../../sharing/access.js";
+import { canViewWorkspaceUsage } from "../metrics-store.js";
+export default defineAction({
+    description: "Get the connected Builder workspace's referral eligibility, invite link, and aggregate referral credit totals. The invite link is only available for eligible paid Builder workspaces; the workspace is resolved from the connected Builder credentials.",
+    http: { method: "GET" },
+    schema: z.object({}),
+    run: async (_input, ctx) => {
+        if (!ctx?.userEmail)
+            throw new Error("Not authenticated.");
+        const enabled = await isFeatureFlagEnabled(BUILDER_CREDIT_USAGE_REPORTING_FLAG, { userEmail: ctx.userEmail, orgId: ctx.orgId });
+        if (!enabled)
+            return null;
+        if (!(await canViewWorkspaceUsage({
+            ownerEmail: ctx.userEmail,
+            orgId: ctx.orgId,
+        }))) {
+            throw new ForbiddenError("Only organization owners and admins can view workspace referral information.");
+        }
+        return getBuilderReferralInfo();
+    },
+});