stagent 0.1.11 → 0.1.12

package/src/app/api/permissions/presets/route.ts

@@ -0,0 +1,80 @@
+import { NextRequest, NextResponse } from "next/server";
+import { z } from "zod";
+import {
+  getPreset,
+  getActivePresets,
+  applyPreset,
+  removePreset,
+  PRESETS,
+} from "@/lib/settings/permission-presets";
+
+const presetSchema = z.object({
+  presetId: z.string().min(1),
+});
+
+/**
+ * GET /api/permissions/presets — list all presets with their active status.
+ */
+export async function GET() {
+  const activeIds = await getActivePresets();
+  const activeSet = new Set(activeIds);
+
+  const presets = PRESETS.map((p) => ({
+    ...p,
+    active: activeSet.has(p.id),
+  }));
+
+  return NextResponse.json({ presets });
+}
+
+/**
+ * POST /api/permissions/presets — enable a preset (adds all its patterns).
+ */
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+  const parsed = presetSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json(
+      { error: "presetId (string) is required" },
+      { status: 400 }
+    );
+  }
+
+  const preset = getPreset(parsed.data.presetId);
+  if (!preset) {
+    return NextResponse.json(
+      { error: `Unknown preset: ${parsed.data.presetId}` },
+      { status: 404 }
+    );
+  }
+
+  await applyPreset(parsed.data.presetId);
+  return NextResponse.json({ success: true });
+}
+
+/**
+ * DELETE /api/permissions/presets — disable a preset (removes unique patterns).
+ */
+export async function DELETE(req: NextRequest) {
+  const body = await req.json();
+  const parsed = presetSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json(
+      { error: "presetId (string) is required" },
+      { status: 400 }
+    );
+  }
+
+  const preset = getPreset(parsed.data.presetId);
+  if (!preset) {
+    return NextResponse.json(
+      { error: `Unknown preset: ${parsed.data.presetId}` },
+      { status: 404 }
+    );
+  }
+
+  await removePreset(parsed.data.presetId);
+  return NextResponse.json({ success: true });
+}

package/src/app/api/playbook/status/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from "next/server";
+import { getDocsLastGenerated } from "@/lib/docs/reader";
+import { getSetting } from "@/lib/settings/helpers";
+
+export async function GET() {
+  const lastGenerated = getDocsLastGenerated();
+  const lastVisit = await getSetting("lastPlaybookVisit");
+
+  const hasUpdates =
+    lastGenerated != null &&
+    lastVisit != null &&
+    new Date(lastGenerated) > new Date(lastVisit);
+
+  return NextResponse.json({ hasUpdates });
+}

package/src/app/api/profiles/route.ts

@@ -1,28 +1,31 @@
 import { NextRequest, NextResponse } from "next/server";
 import { listProfiles, createProfile, isBuiltin } from "@/lib/agents/profiles/registry";
+import { sortProfilesByName } from "@/lib/agents/profiles/sort";
 import { ProfileConfigSchema } from "@/lib/validators/profile";
 
 export async function GET() {
-  const profiles = listProfiles().map((p) => ({
-    id: p.id,
-    name: p.name,
-    description: p.description,
-    domain: p.domain,
-    tags: p.tags,
-    skillMd: p.skillMd,
-    allowedTools: p.allowedTools,
-    mcpServers: p.mcpServers,
-    canUseToolPolicy: p.canUseToolPolicy,
-    maxTurns: p.maxTurns,
-    outputFormat: p.outputFormat,
-    version: p.version,
-    author: p.author,
-    source: p.source,
-    tests: p.tests,
-    supportedRuntimes: p.supportedRuntimes,
-    runtimeOverrides: p.runtimeOverrides,
-    isBuiltin: isBuiltin(p.id),
-  }));
+  const profiles = sortProfilesByName(
+    listProfiles().map((p) => ({
+      id: p.id,
+      name: p.name,
+      description: p.description,
+      domain: p.domain,
+      tags: p.tags,
+      skillMd: p.skillMd,
+      allowedTools: p.allowedTools,
+      mcpServers: p.mcpServers,
+      canUseToolPolicy: p.canUseToolPolicy,
+      maxTurns: p.maxTurns,
+      outputFormat: p.outputFormat,
+      version: p.version,
+      author: p.author,
+      source: p.source,
+      tests: p.tests,
+      supportedRuntimes: p.supportedRuntimes,
+      runtimeOverrides: p.runtimeOverrides,
+      isBuiltin: isBuiltin(p.id),
+    }))
+  );
 
   return NextResponse.json(profiles);
 }

package/src/app/api/settings/pricing/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from "next/server";
+import {
+  getPricingRegistrySnapshot,
+  refreshPricingRegistry,
+} from "@/lib/usage/pricing-registry";
+
+export async function GET() {
+  const snapshot = await getPricingRegistrySnapshot();
+  return NextResponse.json(snapshot);
+}
+
+export async function POST() {
+  const snapshot = await refreshPricingRegistry();
+  return NextResponse.json(snapshot);
+}

package/src/app/costs/page.tsx

@@ -1,4 +1,3 @@
-import { listRuntimeCatalog } from "@/lib/agents/runtime/catalog";
 import { CostDashboard } from "@/components/costs/cost-dashboard";
 import { getBudgetGuardrailSnapshot } from "@/lib/settings/budget-guardrails";
 import {
@@ -13,8 +12,6 @@ import {
 
 export const dynamic = "force-dynamic";
 
-const runtimeCatalog = listRuntimeCatalog();
-const validRuntimeIds = new Set<string>(runtimeCatalog.map((runtime) => runtime.id));
 const validDateRanges = new Set(["7d", "30d", "90d", "all"]);
 const validStatuses = new Set<UsageLedgerStatus>([
   "completed",
@@ -40,10 +37,6 @@ function resolveDateRange(value: string | undefined) {
   return value && validDateRanges.has(value) ? value : "30d";
 }
 
-function resolveRuntime(value: string | undefined) {
-  return value && validRuntimeIds.has(value) ? value : "all";
-}
-
 function resolveStatus(value: string | undefined) {
   return value && validStatuses.has(value as UsageLedgerStatus) ? value : "all";
 }
@@ -102,25 +95,6 @@ function fillSeries<T extends { day: string }>(
   return keys.map((key) => values.get(key) ?? 0);
 }
 
-function findOverallSpend(
-  statuses: Array<{
-    scopeId: string;
-    window: string;
-    metric: string;
-    currentValue: number;
-  }>,
-  window: "daily" | "monthly"
-) {
-  return (
-    statuses.find(
-      (status) =>
-        status.scopeId === "overall" &&
-        status.window === window &&
-        status.metric === "spend"
-    )?.currentValue ?? 0
-  );
-}
-
 function buildRuntimeBreakdown(
   rows: ProviderModelBreakdownEntry[]
 ): Array<{
@@ -149,9 +123,7 @@ function buildRuntimeBreakdown(
   for (const row of rows) {
     const current = totals.get(row.runtimeId) ?? {
       runtimeId: row.runtimeId,
-      label:
-        runtimeCatalog.find((runtime) => runtime.id === row.runtimeId)?.label ??
-        row.runtimeId,
+      label: row.runtimeId,
       providerId: row.providerId,
       costMicros: 0,
       totalTokens: 0,
@@ -191,22 +163,34 @@ export default async function CostsPage({
 }) {
   const params = await searchParams;
   const dateRange = resolveDateRange(toScalar(params.range));
-  const runtimeId = resolveRuntime(toScalar(params.runtime));
   const status = resolveStatus(toScalar(params.status));
   const activityType = resolveActivityType(toScalar(params.activity));
-
   const rangeStart = getRangeStart(dateRange);
-  const [spendRows30, tokenRows30, monthBreakdown, filteredBreakdown, auditEntries, budgetSnapshot] =
+
+  const budgetSnapshot = await getBudgetGuardrailSnapshot();
+  const configuredRuntimeIds = Object.values(budgetSnapshot.runtimeStates)
+    .filter((runtime) => runtime.configured)
+    .map((runtime) => runtime.runtimeId);
+  const requestedRuntime = toScalar(params.runtime);
+  const runtimeId =
+    requestedRuntime && configuredRuntimeIds.includes(requestedRuntime as never)
+      ? requestedRuntime
+      : "all";
+
+  const [spendRows30, tokenRows30, monthBreakdown, filteredBreakdown, auditEntries] =
     await Promise.all([
       getDailySpendTotals(30),
       getDailyTokenTotals(30),
       getProviderModelBreakdown({ startedAt: startOfCurrentMonth() }),
-      getProviderModelBreakdown(
-        rangeStart ? { startedAt: rangeStart } : undefined
-      ),
+      getProviderModelBreakdown(rangeStart ? { startedAt: rangeStart } : undefined),
       listUsageAuditEntries({
         limit: 100,
-        runtimeIds: runtimeId === "all" ? undefined : [runtimeId],
+        runtimeIds:
+          runtimeId === "all"
+            ? configuredRuntimeIds.length > 0
+              ? configuredRuntimeIds
+              : undefined
+            : [runtimeId],
         statuses: status === "all" ? undefined : [status as UsageLedgerStatus],
         activityTypes:
           activityType === "all"
@@ -214,17 +198,38 @@ export default async function CostsPage({
             : [activityType as UsageActivityType],
         startedAt: rangeStart,
       }),
-      getBudgetGuardrailSnapshot(),
     ]);
 
+  const configuredBreakdown = filteredBreakdown.filter((row) =>
+    configuredRuntimeIds.length > 0
+      ? configuredRuntimeIds.includes(row.runtimeId as never)
+      : true
+  );
+  const configuredMonthBreakdown = monthBreakdown.filter((row) =>
+    configuredRuntimeIds.length > 0
+      ? configuredRuntimeIds.includes(row.runtimeId as never)
+      : true
+  );
+
   const spendSeries30 = fillSeries(30, spendRows30, (row) => row.costMicros);
   const tokenSeries30 = fillSeries(30, tokenRows30, (row) => row.totalTokens);
-  const runtimeBreakdown = buildRuntimeBreakdown(filteredBreakdown);
-  const monthTokens = monthBreakdown.reduce(
+  const runtimeBreakdown = buildRuntimeBreakdown(configuredBreakdown).map((row) => ({
+    ...row,
+    label: budgetSnapshot.runtimeStates[row.runtimeId as keyof typeof budgetSnapshot.runtimeStates]
+      ?.label ?? row.runtimeId,
+  }));
+  const monthTokens = configuredMonthBreakdown.reduce(
     (sum, row) => sum + row.totalTokens,
     0
   );
 
+  const overallDaily = budgetSnapshot.statuses.find(
+    (status) => status.scopeId === "overall" && status.window === "daily"
+  );
+  const overallMonthly = budgetSnapshot.statuses.find(
+    (status) => status.scopeId === "overall" && status.window === "monthly"
+  );
+
   return (
     <div className="gradient-neutral min-h-screen p-6">
       <CostDashboard
@@ -235,9 +240,12 @@ export default async function CostsPage({
           activityType,
         }}
         summary={{
-          todaySpendMicros: findOverallSpend(budgetSnapshot.statuses, "daily"),
-          monthSpendMicros: findOverallSpend(budgetSnapshot.statuses, "monthly"),
-          todayTokens: tokenSeries30[tokenSeries30.length - 1] ?? 0,
+          monthSpendMicros: overallMonthly?.currentValue ?? 0,
+          derivedDailyBudgetMicros: overallDaily?.limitValue ?? 0,
+          remainingMonthlyHeadroomMicros: Math.max(
+            (overallMonthly?.limitValue ?? 0) - (overallMonthly?.currentValue ?? 0),
+            0
+          ),
           monthTokens,
         }}
         trendSeries={{
@@ -247,8 +255,10 @@ export default async function CostsPage({
           tokens30: tokenSeries30,
         }}
         budgetStatuses={budgetSnapshot.statuses}
+        runtimeStates={budgetSnapshot.runtimeStates}
+        pricing={budgetSnapshot.pricing}
         runtimeBreakdown={runtimeBreakdown}
-        modelBreakdown={filteredBreakdown}
+        modelBreakdown={configuredBreakdown}
         auditEntries={auditEntries}
       />
     </div>

package/src/app/playbook/[slug]/page.tsx

@@ -0,0 +1,76 @@
+import { notFound } from "next/navigation";
+import { getDocBySlug, getManifest } from "@/lib/docs/reader";
+import { getAdoptionMap } from "@/lib/docs/adoption";
+import { PlaybookDetailView } from "@/components/playbook/playbook-detail-view";
+
+export const dynamic = "force-dynamic";
+
+interface PlaybookDetailProps {
+  params: Promise<{ slug: string }>;
+}
+
+export async function generateMetadata({ params }: PlaybookDetailProps) {
+  const { slug } = await params;
+  const doc = getDocBySlug(slug);
+  return {
+    title: doc
+      ? `${(doc.frontmatter.title as string) || slug} | Playbook | Stagent`
+      : "Not Found | Playbook",
+  };
+}
+
+export default async function PlaybookDetailPage({
+  params,
+}: PlaybookDetailProps) {
+  const { slug } = await params;
+  const [doc, manifest, adoptionMap] = await Promise.all([
+    getDocBySlug(slug),
+    getManifest(),
+    getAdoptionMap(),
+  ]);
+
+  if (!doc) notFound();
+
+  // Find related sections from manifest
+  const allSections = [...manifest.sections, ...manifest.journeys];
+  const currentSection = allSections.find((s) => s.slug === slug);
+
+  // Find related docs by shared tags
+  const currentTags = new Set(
+    (currentSection && "tags" in currentSection
+      ? (currentSection as { tags: string[] }).tags
+      : (doc.frontmatter.tags as string[]) || []
+    ).map((t) => t.toLowerCase())
+  );
+
+  const relatedSections = manifest.sections
+    .filter(
+      (s) =>
+        s.slug !== slug &&
+        s.tags.some((t) => currentTags.has(t.toLowerCase()))
+    )
+    .slice(0, 4);
+
+  const adoption = Object.fromEntries(adoptionMap);
+
+  // Collect all known doc slugs so markdown links resolve correctly
+  const allSlugs = [
+    ...manifest.sections.map((s) => s.slug),
+    ...manifest.journeys.map((j) => j.slug),
+    "getting-started",
+    "index",
+  ];
+
+  return (
+    <div className="gradient-twilight min-h-[100dvh] p-4 sm:p-6">
+      <div className="surface-page rounded-[28px] border border-border/60 p-6 shadow-[0_18px_48px_oklch(0.12_0.02_260_/_0.08)]">
+        <PlaybookDetailView
+          doc={doc}
+          relatedSections={relatedSections}
+          adoption={adoption}
+          allSlugs={allSlugs}
+        />
+      </div>
+    </div>
+  );
+}

package/src/app/playbook/page.tsx

@@ -0,0 +1,54 @@
+import { getManifest, getDocsLastGenerated } from "@/lib/docs/reader";
+import { getUsageStage } from "@/lib/docs/usage-stage";
+import { getAdoptionMap } from "@/lib/docs/adoption";
+import { getJourneyCompletions } from "@/lib/docs/journey-tracker";
+import { getSetting, setSetting } from "@/lib/settings/helpers";
+import { PlaybookHomepage } from "@/components/playbook/playbook-homepage";
+
+export const dynamic = "force-dynamic";
+
+export const metadata = {
+  title: "Playbook | Stagent",
+};
+
+export default async function PlaybookPage() {
+  const [manifest, stage, adoptionMap, lastGenerated, lastVisit] =
+    await Promise.all([
+      getManifest(),
+      getUsageStage(),
+      getAdoptionMap(),
+      getDocsLastGenerated(),
+      getSetting("lastPlaybookVisit"),
+    ]);
+
+  const journeyCompletions = getJourneyCompletions(
+    manifest.journeys,
+    adoptionMap
+  );
+
+  // Update last visit timestamp
+  await setSetting("lastPlaybookVisit", new Date().toISOString());
+
+  // Serialize maps for client component
+  const adoption = Object.fromEntries(adoptionMap);
+  const completions = Object.fromEntries(journeyCompletions);
+
+  const hasUpdates =
+    lastGenerated != null &&
+    lastVisit != null &&
+    new Date(lastGenerated) > new Date(lastVisit);
+
+  return (
+    <div className="gradient-twilight min-h-[100dvh] p-4 sm:p-6">
+      <div className="surface-page rounded-[28px] border border-border/60 p-6 shadow-[0_18px_48px_oklch(0.12_0.02_260_/_0.08)]">
+        <PlaybookHomepage
+          manifest={manifest}
+          stage={stage}
+          adoption={adoption}
+          journeyCompletions={completions}
+          hasUpdates={hasUpdates}
+        />
+      </div>
+    </div>
+  );
+}

package/src/app/profiles/page.tsx

@@ -1,13 +1,16 @@
 import { listProfiles, isBuiltin } from "@/lib/agents/profiles/registry";
+import { sortProfilesByName } from "@/lib/agents/profiles/sort";
 import { ProfileBrowser } from "@/components/profiles/profile-browser";
 
 export const dynamic = "force-dynamic";
 
 export default async function ProfilesPage() {
-  const profiles = listProfiles().map((p) => ({
-    ...p,
-    isBuiltin: isBuiltin(p.id),
-  }));
+  const profiles = sortProfilesByName(
+    listProfiles().map((p) => ({
+      ...p,
+      isBuiltin: isBuiltin(p.id),
+    }))
+  );
 
   return (
     <div className="gradient-ocean-mist min-h-[100dvh] p-4 sm:p-6">

package/src/app/settings/page.tsx

@@ -1,6 +1,6 @@
 import { AuthConfigSection } from "@/components/settings/auth-config-section";
 import { OpenAIRuntimeSection } from "@/components/settings/openai-runtime-section";
-import { PermissionsSection } from "@/components/settings/permissions-section";
+import { PermissionsSections } from "@/components/settings/permissions-sections";
 import { DataManagementSection } from "@/components/settings/data-management-section";
 import { BudgetGuardrailsSection } from "@/components/settings/budget-guardrails-section";
 
@@ -19,7 +19,7 @@ export default function SettingsPage() {
         <AuthConfigSection />
         <OpenAIRuntimeSection />
         <BudgetGuardrailsSection />
-        <PermissionsSection />
+        <PermissionsSections />
         <DataManagementSection />
       </div>
     </div>