stagent 0.9.5 → 0.10.0

package/src/components/shared/upgrade-banner.tsx

@@ -1,112 +0,0 @@
-"use client";
-
-import { useEffect } from "react";
-import Link from "next/link";
-import { AlertTriangle, Lock } from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { cn } from "@/lib/utils";
-import { TIER_LABELS, type LicenseTier } from "@/lib/license/tier-limits";
-import type { LimitResource } from "@/lib/license/tier-limits";
-import { trackConversionEvent } from "@/lib/telemetry/conversion-events";
-
-const BANNER_TITLES: Record<LimitResource, string> = {
-  agentMemories: "Memory limit approaching",
-  contextVersions: "Context version limit reached",
-  activeSchedules: "Schedule limit reached",
-  historyRetentionDays: "History retention limit",
-  parallelWorkflows: "Parallel workflow limit reached",
-};
-
-function getBannerMessage(
-  resource: LimitResource,
-  current: number,
-  max: number,
-  requiredTier: string
-): string {
-  const tierLabel = TIER_LABELS[requiredTier as LicenseTier] ?? requiredTier;
-  switch (resource) {
-    case "agentMemories":
-      return `${current} of ${max} agent memories used. Upgrade to ${tierLabel} for more capacity.`;
-    case "contextVersions":
-      return `${current} of ${max} context versions used. Upgrade to ${tierLabel} to unlock more.`;
-    case "activeSchedules":
-      return `${current} of ${max} active schedules. Upgrade to ${tierLabel} for more schedules.`;
-    case "historyRetentionDays":
-      return `Execution history limited to ${max} days. Upgrade to ${tierLabel} for longer retention.`;
-    case "parallelWorkflows":
-      return `${current} of ${max} parallel workflows running. Upgrade to ${tierLabel} for more concurrency.`;
-  }
-}
-
-interface UpgradeBannerProps {
-  resource: LimitResource;
-  current: number;
-  max: number;
-  requiredTier: string;
-  variant: "warning" | "blocked";
-  onDismiss?: () => void;
-  onSnooze?: () => void;
-  className?: string;
-}
-
-export function UpgradeBanner({
-  resource,
-  current,
-  max,
-  requiredTier,
-  variant,
-  onDismiss,
-  onSnooze,
-  className,
-}: UpgradeBannerProps) {
-  const Icon = variant === "blocked" ? Lock : AlertTriangle;
-  const tierLabel = TIER_LABELS[requiredTier as LicenseTier] ?? requiredTier;
-
-  // Track banner impression on mount
-  useEffect(() => {
-    trackConversionEvent("banner_impression", resource);
-  }, [resource]);
-
-  return (
-    <div
-      role="alert"
-      aria-live="polite"
-      className={cn(
-        "surface-card-muted rounded-lg border p-4 flex items-start gap-3",
-        variant === "warning" && "border-amber-500/25",
-        variant === "blocked" && "border-destructive/25",
-        className
-      )}
-    >
-      <Icon
-        className={cn(
-          "size-4 shrink-0 mt-0.5",
-          variant === "warning" ? "text-amber-500" : "text-destructive"
-        )}
-      />
-      <div className="flex-1 space-y-1">
-        <p className="text-sm font-medium">{BANNER_TITLES[resource]}</p>
-        <p className="text-xs text-muted-foreground">
-          {getBannerMessage(resource, current, max, requiredTier)}
-        </p>
-        <div className="flex items-center gap-2 pt-2">
-          <Button size="sm" asChild onClick={() => trackConversionEvent("banner_click", resource)}>
-            <Link href={`/settings?highlight=${requiredTier}`}>
-              Upgrade to {tierLabel}
-            </Link>
-          </Button>
-          {onSnooze && (
-            <Button size="sm" variant="ghost" onClick={onSnooze}>
-              Remind later
-            </Button>
-          )}
-          {onDismiss && (
-            <Button size="sm" variant="ghost" onClick={onDismiss}>
-              Dismiss
-            </Button>
-          )}
-        </div>
-      </div>
-    </div>
-  );
-}

package/src/hooks/use-supabase-auth.ts

@@ -1,79 +0,0 @@
-"use client";
-
-import { useState, useEffect, useCallback } from "react";
-import { getSupabaseBrowserClient } from "@/lib/cloud/supabase-browser";
-import type { Session, User } from "@supabase/supabase-js";
-
-interface AuthState {
-  session: Session | null;
-  user: User | null;
-  email: string | null;
-  loading: boolean;
-}
-
-/**
- * Hook for Supabase Auth state in the browser.
- * Tracks session, provides sign-in/sign-out helpers.
- */
-export function useSupabaseAuth() {
-  const [auth, setAuth] = useState<AuthState>({
-    session: null,
-    user: null,
-    email: null,
-    loading: true,
-  });
-
-  useEffect(() => {
-    const supabase = getSupabaseBrowserClient();
-
-    // Get initial session
-    supabase.auth.getSession().then(({ data: { session } }) => {
-      setAuth({
-        session,
-        user: session?.user ?? null,
-        email: session?.user?.email ?? null,
-        loading: false,
-      });
-    });
-
-    // Listen for auth state changes (magic link callback, sign-out, etc.)
-    const {
-      data: { subscription },
-    } = supabase.auth.onAuthStateChange((_event, session) => {
-      setAuth({
-        session,
-        user: session?.user ?? null,
-        email: session?.user?.email ?? null,
-        loading: false,
-      });
-    });
-
-    return () => subscription.unsubscribe();
-  }, []);
-
-  const signInWithEmail = useCallback(async (email: string) => {
-    const supabase = getSupabaseBrowserClient();
-    const redirectTo = typeof window !== "undefined"
-      ? `${window.location.origin}/auth/callback`
-      : "http://localhost:3000/auth/callback";
-
-    const { error } = await supabase.auth.signInWithOtp({
-      email,
-      options: { emailRedirectTo: redirectTo },
-    });
-
-    return { error: error?.message ?? null };
-  }, []);
-
-  const signOut = useCallback(async () => {
-    const supabase = getSupabaseBrowserClient();
-    await supabase.auth.signOut();
-  }, []);
-
-  return {
-    ...auth,
-    isSignedIn: !!auth.session,
-    signInWithEmail,
-    signOut,
-  };
-}

package/src/lib/billing/email.ts

@@ -1,54 +0,0 @@
-/**
- * Transactional email helpers via Resend.
- *
- * All emails are sent through the Supabase `send-email` Edge Function.
- * This module provides typed wrappers with no-op behavior when
- * the cloud backend is not configured.
- */
-
-import { isCloudConfigured, getSupabaseUrl, getSupabaseAnonKey } from "@/lib/cloud/supabase-client";
-
-async function sendEmail(
-  template: string,
-  to: string,
-  data: Record<string, unknown>
-): Promise<void> {
-  if (!isCloudConfigured()) return;
-
-  const supabaseUrl = getSupabaseUrl();
-  const anonKey = getSupabaseAnonKey();
-
-  try {
-    await fetch(`${supabaseUrl}/functions/v1/send-email`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${anonKey}`,
-      },
-      body: JSON.stringify({ template, to, data }),
-    });
-  } catch {
-    // Email sending is non-critical — log and continue
-    console.warn(`[email] Failed to send ${template} to ${to}`);
-  }
-}
-
-/** Welcome email for marketing site purchasers with install instructions */
-export function sendWelcomeWithInstall(email: string, tier: string): Promise<void> {
-  return sendEmail("welcome-install", email, { tier });
-}
-
-/** Upgrade confirmation for in-app purchasers */
-export function sendUpgradeConfirmation(email: string, tier: string): Promise<void> {
-  return sendEmail("upgrade-confirmation", email, { tier });
-}
-
-/** Memory cap warning (approaching limit) */
-export function sendMemoryWarning(
-  email: string,
-  profileName: string,
-  current: number,
-  limit: number
-): Promise<void> {
-  return sendEmail("memory-warning", email, { profileName, current, limit });
-}

package/src/lib/billing/products.ts

@@ -1,80 +0,0 @@
-/**
- * Stripe product and price configuration.
- *
- * Price IDs are placeholders — replace with actual Stripe dashboard values
- * after creating products. The structure supports both monthly and annual
- * billing for each tier.
- */
-
-import type { LicenseTier } from "@/lib/license/tier-limits";
-
-export type BillingInterval = "monthly" | "annual";
-
-export interface StripeProduct {
-  tier: Exclude<LicenseTier, "community">;
-  name: string;
-  description: string;
-  prices: Record<BillingInterval, StripePrice>;
-  paymentLinks: Record<BillingInterval, string>; // Static Stripe Payment Links for marketing site
-}
-
-export interface StripePrice {
-  id: string; // Stripe Price ID (price_xxx)
-  amount: number; // In cents
-  currency: string;
-}
-
-/** Stripe product catalog — live Price IDs and Payment Links. */
-export const STRIPE_PRODUCTS: StripeProduct[] = [
-  {
-    tier: "solo",
-    name: "Stagent Solo",
-    description: "Power users — expanded limits and advanced history",
-    prices: {
-      monthly: { id: "price_1TJ2d5RCxnzBPkIX4SnajFok", amount: 1900, currency: "usd" },
-      annual: { id: "price_1TJ2d5RCxnzBPkIXjjiyc7lb", amount: 19000, currency: "usd" },
-    },
-    paymentLinks: {
-      monthly: "https://buy.stagent.io/fZufZjgKC4q9azrgDzdwc06",
-      annual: "https://buy.stagent.io/bJe00l1PI7Cl7nf1IFdwc0b",
-    },
-  },
-  {
-    tier: "operator",
-    name: "Stagent Operator",
-    description: "Professionals — analytics, cloud sync, marketplace publishing",
-    prices: {
-      monthly: { id: "price_1TJ2e1RCxnzBPkIXZg47cNbO", amount: 4900, currency: "usd" },
-      annual: { id: "price_1TJ2e1RCxnzBPkIXODs5fZW2", amount: 49000, currency: "usd" },
-    },
-    paymentLinks: {
-      monthly: "https://buy.stagent.io/aFa4gB0LE9Kt22Vevrdwc07",
-      annual: "https://buy.stagent.io/bJe6oJdyq2i1bDv1IFdwc0a",
-    },
-  },
-  {
-    tier: "scale",
-    name: "Stagent Scale",
-    description: "Teams — unlimited everything, featured marketplace, priority support",
-    prices: {
-      monthly: { id: "price_1TJ2evRCxnzBPkIXy9mBqBHB", amount: 9900, currency: "usd" },
-      annual: { id: "price_1TJ2evRCxnzBPkIXqIRaDxQp", amount: 99000, currency: "usd" },
-    },
-    paymentLinks: {
-      monthly: "https://buy.stagent.io/9B628t2TM5udazr72Zdwc08",
-      annual: "https://buy.stagent.io/dRmfZjbqicWF5f7873dwc09",
-    },
-  },
-];
-
-/** Map from Stripe Price ID → tier for webhook processing */
-export const PRICE_TO_TIER: Record<string, LicenseTier> = Object.fromEntries(
-  STRIPE_PRODUCTS.flatMap((p) =>
-    Object.values(p.prices).map((price) => [price.id, p.tier])
-  )
-);
-
-/** Get the product for a specific tier */
-export function getProductForTier(tier: Exclude<LicenseTier, "community">): StripeProduct | undefined {
-  return STRIPE_PRODUCTS.find((p) => p.tier === tier);
-}

package/src/lib/billing/stripe.ts

@@ -1,101 +0,0 @@
-/**
- * Stripe billing helpers.
- *
- * All Stripe API calls go through Supabase Edge Functions —
- * no Stripe secret key in the local app. This module calls
- * Edge Functions to create Checkout Sessions and Portal Sessions.
- */
-
-import { isCloudConfigured, getSupabaseUrl, getSupabaseAnonKey } from "@/lib/cloud/supabase-client";
-import { getProductForTier } from "./products";
-import type { LicenseTier } from "@/lib/license/tier-limits";
-import type { BillingInterval } from "./products";
-
-/**
- * Create a Stripe Checkout Session for in-app upgrade.
- * Returns the checkout URL to redirect the user to.
- */
-export async function createCheckoutSession(
-  tier: Exclude<LicenseTier, "community">,
-  billingPeriod: BillingInterval = "monthly",
-  returnUrl?: string
-): Promise<{ url: string } | { error: string }> {
-  if (!isCloudConfigured()) {
-    return { error: "Cloud backend not configured" };
-  }
-
-  const product = getProductForTier(tier);
-  if (!product) {
-    return { error: `Unknown tier: ${tier}` };
-  }
-
-  const priceId = product.prices[billingPeriod].id;
-  const supabaseUrl = getSupabaseUrl();
-  const anonKey = getSupabaseAnonKey();
-
-  try {
-    const response = await fetch(
-      `${supabaseUrl}/functions/v1/create-checkout-session`,
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${anonKey}`,
-        },
-        body: JSON.stringify({
-          priceId,
-          returnUrl: returnUrl ?? `${typeof window !== "undefined" ? window.location.origin : "http://localhost:3000"}/settings`,
-        }),
-      }
-    );
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      return { error: data.error ?? `HTTP ${response.status}` };
-    }
-
-    const data = await response.json();
-    return { url: data.url };
-  } catch (err) {
-    return { error: err instanceof Error ? err.message : "Checkout failed" };
-  }
-}
-
-/**
- * Create a Stripe Customer Portal session for billing management.
- * Returns the portal URL to redirect the user to.
- */
-export async function createPortalSession(
-  email: string
-): Promise<{ url: string } | { error: string }> {
-  if (!isCloudConfigured()) {
-    return { error: "Cloud backend not configured" };
-  }
-
-  const supabaseUrl = getSupabaseUrl();
-  const anonKey = getSupabaseAnonKey();
-
-  try {
-    const response = await fetch(
-      `${supabaseUrl}/functions/v1/create-portal-session`,
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${anonKey}`,
-        },
-        body: JSON.stringify({ email }),
-      }
-    );
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      return { error: data.error ?? `HTTP ${response.status}` };
-    }
-
-    const data = await response.json();
-    return { url: data.url };
-  } catch (err) {
-    return { error: err instanceof Error ? err.message : "Portal failed" };
-  }
-}

package/src/lib/cloud/supabase-browser.ts

@@ -1,32 +0,0 @@
-"use client";
-
-/**
- * Browser-side Supabase client with session persistence.
- *
- * Used for auth flows (magic link sign-in) and authenticated operations
- * (Storage uploads for cloud sync). The server-side client in
- * supabase-client.ts is for server components and API routes.
- */
-
-import { createClient, type SupabaseClient } from "@supabase/supabase-js";
-import { getSupabaseUrl, getSupabaseAnonKey } from "@/lib/cloud/supabase-client";
-
-let browserClient: SupabaseClient | null = null;
-
-/**
- * Get the browser-side Supabase client with session persistence.
- * Sessions are stored in localStorage and auto-refreshed.
- */
-export function getSupabaseBrowserClient(): SupabaseClient {
-  if (browserClient) return browserClient;
-
-  browserClient = createClient(getSupabaseUrl(), getSupabaseAnonKey(), {
-    auth: {
-      autoRefreshToken: true,
-      persistSession: true,
-      storageKey: "stagent-auth",
-    },
-  });
-
-  return browserClient;
-}

package/src/lib/cloud/supabase-client.ts

@@ -1,56 +0,0 @@
-/**
- * Supabase client singleton for cloud features.
- *
- * Connects to the Stagent cloud backend for license validation,
- * marketplace, telemetry, and cloud sync. The anon key is safe to
- * embed — Row Level Security policies protect all data.
- *
- * Env vars override the defaults (for self-hosted or development).
- */
-
-import { createClient, type SupabaseClient } from "@supabase/supabase-js";
-
-/** Production Stagent cloud backend — safe to embed (anon key, RLS-protected) */
-const DEFAULT_SUPABASE_URL = "https://yznantjbmacbllhcyzwc.supabase.co";
-const DEFAULT_SUPABASE_ANON_KEY =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inl6bmFudGpibWFjYmxsaGN5endjIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI1MDg1ODMsImV4cCI6MjA4ODA4NDU4M30.i-P7MXpR1_emBjhUkzbFeSX7fgjgPDv90_wkqF7sW3Y";
-
-/** Resolved Supabase URL (env override or production default) */
-export function getSupabaseUrl(): string {
-  return process.env.NEXT_PUBLIC_SUPABASE_URL || DEFAULT_SUPABASE_URL;
-}
-
-/** Resolved Supabase anon key (env override or production default) */
-export function getSupabaseAnonKey(): string {
-  return process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || DEFAULT_SUPABASE_ANON_KEY;
-}
-
-let client: SupabaseClient | null = null;
-let initialized = false;
-
-/**
- * Get the Supabase client. Uses the production Stagent backend by default.
- * Override with NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY
- * env vars for self-hosted or development setups.
- */
-export function getSupabaseClient(): SupabaseClient | null {
-  if (initialized) return client;
-  initialized = true;
-
-  client = createClient(getSupabaseUrl(), getSupabaseAnonKey(), {
-    auth: {
-      autoRefreshToken: true,
-      persistSession: false, // Server-side — no browser session
-    },
-  });
-
-  return client;
-}
-
-/**
- * Cloud is always configured — defaults to Stagent production backend.
- * Returns false only if explicitly disabled via STAGENT_CLOUD_DISABLED=true.
- */
-export function isCloudConfigured(): boolean {
-  return process.env.STAGENT_CLOUD_DISABLED !== "true";
-}

package/src/lib/license/__tests__/features.test.ts

@@ -1,56 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { canAccessFeature, LICENSE_FEATURES, type LicenseFeature } from "../features";
-import type { LicenseTier } from "../tier-limits";
-
-describe("features", () => {
-  it("community can browse marketplace", () => {
-    expect(canAccessFeature("community", "marketplace-browse")).toBe(true);
-  });
-
-  it("community cannot access analytics", () => {
-    expect(canAccessFeature("community", "analytics")).toBe(false);
-  });
-
-  it("community cannot access cloud sync", () => {
-    expect(canAccessFeature("community", "cloud-sync")).toBe(false);
-  });
-
-  it("solo can import from marketplace", () => {
-    expect(canAccessFeature("solo", "marketplace-import")).toBe(true);
-  });
-
-  it("solo cannot publish to marketplace", () => {
-    expect(canAccessFeature("solo", "marketplace-publish")).toBe(false);
-  });
-
-  it("operator can access analytics and cloud sync", () => {
-    expect(canAccessFeature("operator", "analytics")).toBe(true);
-    expect(canAccessFeature("operator", "cloud-sync")).toBe(true);
-    expect(canAccessFeature("operator", "marketplace-publish")).toBe(true);
-  });
-
-  it("scale can access everything", () => {
-    for (const feature of LICENSE_FEATURES) {
-      expect(canAccessFeature("scale", feature)).toBe(true);
-    }
-  });
-
-  it("higher tiers inherit lower tier features", () => {
-    const tiers: LicenseTier[] = ["community", "solo", "operator", "scale"];
-    for (const feature of LICENSE_FEATURES) {
-      let unlocked = false;
-      for (const tier of tiers) {
-        if (canAccessFeature(tier, feature)) {
-          unlocked = true;
-        }
-        // Once unlocked, must stay unlocked for all higher tiers
-        if (unlocked) {
-          expect(
-            canAccessFeature(tier, feature),
-            `${tier} should access ${feature} since a lower tier can`
-          ).toBe(true);
-        }
-      }
-    }
-  });
-});

package/src/lib/license/__tests__/key-format.test.ts

@@ -1,88 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { generateLicenseKey, validateLicenseKey, formatKeyInput } from "../key-format";
-
-describe("key-format", () => {
-  describe("generateLicenseKey", () => {
-    it("generates a key in STAG-XXXX-XXXX-XXXX-XXXX format", () => {
-      const key = generateLicenseKey();
-      expect(key).toMatch(/^STAG-[A-HJ-NP-Z2-9]{4}-[A-HJ-NP-Z2-9]{4}-[A-HJ-NP-Z2-9]{4}-[A-HJ-NP-Z2-9]{4}$/);
-    });
-
-    it("generates keys that pass validation", () => {
-      for (let i = 0; i < 20; i++) {
-        const key = generateLicenseKey();
-        const result = validateLicenseKey(key);
-        expect(result.valid, `Key ${key} should be valid`).toBe(true);
-      }
-    });
-
-    it("generates unique keys", () => {
-      const keys = new Set<string>();
-      for (let i = 0; i < 50; i++) {
-        keys.add(generateLicenseKey());
-      }
-      expect(keys.size).toBe(50);
-    });
-  });
-
-  describe("validateLicenseKey", () => {
-    it("accepts a valid generated key", () => {
-      const key = generateLicenseKey();
-      expect(validateLicenseKey(key)).toEqual({ valid: true });
-    });
-
-    it("rejects empty string", () => {
-      expect(validateLicenseKey("")).toEqual({
-        valid: false,
-        error: expect.stringContaining("Invalid format"),
-      });
-    });
-
-    it("rejects wrong prefix", () => {
-      expect(validateLicenseKey("XXXX-ABCD-EFGH-JKMN-PQRS")).toEqual({
-        valid: false,
-        error: expect.stringContaining("Invalid format"),
-      });
-    });
-
-    it("rejects ambiguous characters (0, O, 1, I, L)", () => {
-      expect(validateLicenseKey("STAG-0OIL-ABCD-EFGH-JKMN")).toEqual({
-        valid: false,
-        error: expect.stringContaining("Invalid format"),
-      });
-    });
-
-    it("rejects a key with a bad checksum", () => {
-      const key = generateLicenseKey();
-      // Flip the last character
-      const bad = key.slice(0, -1) + (key.slice(-1) === "A" ? "B" : "A");
-      const result = validateLicenseKey(bad);
-      expect(result.valid).toBe(false);
-    });
-
-    it("accepts lowercase input (case-insensitive)", () => {
-      const key = generateLicenseKey();
-      expect(validateLicenseKey(key.toLowerCase())).toEqual({ valid: true });
-    });
-  });
-
-  describe("formatKeyInput", () => {
-    it("adds dashes and STAG prefix", () => {
-      expect(formatKeyInput("ABCD")).toBe("STAG-ABCD");
-      expect(formatKeyInput("ABCDEFGH")).toBe("STAG-ABCD-EFGH");
-    });
-
-    it("strips invalid characters", () => {
-      expect(formatKeyInput("AB!@CD")).toBe("STAG-ABCD");
-    });
-
-    it("converts to uppercase", () => {
-      expect(formatKeyInput("abcd")).toBe("STAG-ABCD");
-    });
-
-    it("limits to 16 characters", () => {
-      expect(formatKeyInput("ABCDEFGHJKMNPQRS")).toBe("STAG-ABCD-EFGH-JKMN-PQRS");
-      expect(formatKeyInput("ABCDEFGHJKMNPQRSTUV")).toBe("STAG-ABCD-EFGH-JKMN-PQRS");
-    });
-  });
-});