stagent 0.4.0 → 0.6.0

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

@@ -3,6 +3,7 @@ import { db } from "@/lib/db";
 import { schedules } from "@/lib/db/schema";
 import { desc, eq } from "drizzle-orm";
 import { parseInterval, computeNextFireTime } from "@/lib/schedules/interval-parser";
+import { parseNaturalLanguage } from "@/lib/schedules/nlp-parser";
 import { resolveAgentRuntime } from "@/lib/agents/runtime/catalog";
 import { validateRuntimeProfileAssignment } from "@/lib/agents/profiles/assignment-validation";
 
@@ -27,6 +28,12 @@ export async function POST(req: NextRequest) {
     recurs,
     maxFirings,
     expiresInHours,
+    type,
+    heartbeatChecklist,
+    activeHoursStart,
+    activeHoursEnd,
+    activeTimezone,
+    heartbeatBudgetPerDay,
   } =
     body as {
       name?: string;
@@ -38,27 +45,64 @@ export async function POST(req: NextRequest) {
       recurs?: boolean;
       maxFirings?: number;
       expiresInHours?: number;
+      type?: "scheduled" | "heartbeat";
+      heartbeatChecklist?: Array<{ id: string; instruction: string; priority: string }>;
+      activeHoursStart?: number;
+      activeHoursEnd?: number;
+      activeTimezone?: string;
+      heartbeatBudgetPerDay?: number;
     };
 
+  const scheduleType = type ?? "scheduled";
+
   if (!name?.trim()) {
     return NextResponse.json({ error: "Name is required" }, { status: 400 });
   }
-  if (!prompt?.trim()) {
-    return NextResponse.json({ error: "Prompt is required" }, { status: 400 });
-  }
   if (!interval?.trim()) {
     return NextResponse.json({ error: "Interval is required" }, { status: 400 });
   }
 
-  // Parse interval into cron expression
+  // Heartbeat-specific validation
+  if (scheduleType === "heartbeat") {
+    if (!heartbeatChecklist || heartbeatChecklist.length === 0) {
+      return NextResponse.json(
+        { error: "Heartbeat schedules require at least one checklist item" },
+        { status: 400 }
+      );
+    }
+    if (activeHoursStart !== undefined && (activeHoursStart < 0 || activeHoursStart > 23)) {
+      return NextResponse.json(
+        { error: "Active hours start must be 0-23" },
+        { status: 400 }
+      );
+    }
+    if (activeHoursEnd !== undefined && (activeHoursEnd < 0 || activeHoursEnd > 23)) {
+      return NextResponse.json(
+        { error: "Active hours end must be 0-23" },
+        { status: 400 }
+      );
+    }
+  }
+
+  // For heartbeat type, prompt is optional (auto-generated from checklist)
+  if (scheduleType === "scheduled" && !prompt?.trim()) {
+    return NextResponse.json({ error: "Prompt is required" }, { status: 400 });
+  }
+
+  // Parse interval into cron expression — try NLP first, then shorthand/cron
   let cronExpression: string;
-  try {
-    cronExpression = parseInterval(interval);
-  } catch (err) {
-    return NextResponse.json(
-      { error: (err as Error).message },
-      { status: 400 }
-    );
+  const nlResult = parseNaturalLanguage(interval);
+  if (nlResult) {
+    cronExpression = nlResult.cronExpression;
+  } else {
+    try {
+      cronExpression = parseInterval(interval);
+    } catch (err) {
+      return NextResponse.json(
+        { error: (err as Error).message },
+        { status: 400 }
+      );
+    }
   }
 
   if (assignedAgent !== undefined && assignedAgent !== null && assignedAgent !== "") {
@@ -90,10 +134,15 @@ export async function POST(req: NextRequest) {
     ? new Date(now.getTime() + expiresInHours * 60 * 60 * 1000)
     : null;
 
+  // For heartbeat schedules, use a placeholder prompt (actual prompt is built at runtime from checklist)
+  const effectivePrompt = scheduleType === "heartbeat"
+    ? (prompt?.trim() || `Heartbeat check: ${name?.trim()}`)
+    : prompt!.trim();
+
   await db.insert(schedules).values({
     id,
     name: name.trim(),
-    prompt: prompt.trim(),
+    prompt: effectivePrompt,
     cronExpression,
     projectId: projectId || null,
     assignedAgent: assignedAgent || null,
@@ -104,6 +153,16 @@ export async function POST(req: NextRequest) {
     firingCount: 0,
     expiresAt,
     nextFireAt,
+    type: scheduleType,
+    heartbeatChecklist: heartbeatChecklist ? JSON.stringify(heartbeatChecklist) : null,
+    activeHoursStart: activeHoursStart ?? null,
+    activeHoursEnd: activeHoursEnd ?? null,
+    activeTimezone: activeTimezone ?? "UTC",
+    suppressionCount: 0,
+    lastActionAt: null,
+    heartbeatBudgetPerDay: heartbeatBudgetPerDay ?? null,
+    heartbeatSpentToday: 0,
+    heartbeatBudgetResetAt: null,
     createdAt: now,
     updatedAt: now,
   });

package/src/app/api/settings/author-default/route.ts

@@ -0,0 +1,7 @@
+import { NextResponse } from "next/server";
+import os from "os";
+
+export async function GET() {
+  const info = os.userInfo();
+  return NextResponse.json({ author: info.username });
+}

package/src/app/api/settings/browser-tools/route.ts

@@ -0,0 +1,68 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getSetting, setSetting } from "@/lib/settings/helpers";
+import { SETTINGS_KEYS } from "@/lib/constants/settings";
+
+export async function GET() {
+  const [chromeEnabled, playwrightEnabled, chromeConfig, playwrightConfig] =
+    await Promise.all([
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_ENABLED),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_ENABLED),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_CONFIG),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_CONFIG),
+    ]);
+
+  return NextResponse.json({
+    chromeDevtoolsEnabled: chromeEnabled === "true",
+    playwrightEnabled: playwrightEnabled === "true",
+    chromeDevtoolsConfig: chromeConfig ?? "",
+    playwrightConfig: playwrightConfig ?? "",
+  });
+}
+
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  if (body.chromeDevtoolsEnabled !== undefined) {
+    await setSetting(
+      SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_ENABLED,
+      body.chromeDevtoolsEnabled ? "true" : "false"
+    );
+  }
+
+  if (body.playwrightEnabled !== undefined) {
+    await setSetting(
+      SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_ENABLED,
+      body.playwrightEnabled ? "true" : "false"
+    );
+  }
+
+  if (body.chromeDevtoolsConfig !== undefined) {
+    await setSetting(
+      SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_CONFIG,
+      body.chromeDevtoolsConfig
+    );
+  }
+
+  if (body.playwrightConfig !== undefined) {
+    await setSetting(
+      SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_CONFIG,
+      body.playwrightConfig
+    );
+  }
+
+  // Return updated state
+  const [chromeEnabled, playwrightEnabled, chromeConfig, playwrightConfig] =
+    await Promise.all([
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_ENABLED),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_ENABLED),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_CHROME_DEVTOOLS_CONFIG),
+      getSetting(SETTINGS_KEYS.BROWSER_MCP_PLAYWRIGHT_CONFIG),
+    ]);
+
+  return NextResponse.json({
+    chromeDevtoolsEnabled: chromeEnabled === "true",
+    playwrightEnabled: playwrightEnabled === "true",
+    chromeDevtoolsConfig: chromeConfig ?? "",
+    playwrightConfig: playwrightConfig ?? "",
+  });
+}

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

@@ -0,0 +1,41 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getSetting, setSetting } from "@/lib/settings/helpers";
+import { SETTINGS_KEYS } from "@/lib/constants/settings";
+
+export async function GET() {
+  const contextCharLimit = await getSetting(
+    SETTINGS_KEYS.LEARNING_CONTEXT_CHAR_LIMIT
+  );
+  return NextResponse.json({
+    contextCharLimit: contextCharLimit ?? "8000",
+  });
+}
+
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  if (body.contextCharLimit !== undefined) {
+    const limit = parseInt(body.contextCharLimit, 10);
+    if (isNaN(limit) || limit < 2000 || limit > 32000 || limit % 1000 !== 0) {
+      return NextResponse.json(
+        {
+          error:
+            "contextCharLimit must be between 2,000 and 32,000 (step 1,000)",
+        },
+        { status: 400 }
+      );
+    }
+    await setSetting(
+      SETTINGS_KEYS.LEARNING_CONTEXT_CHAR_LIMIT,
+      String(limit)
+    );
+  }
+
+  const contextCharLimit = await getSetting(
+    SETTINGS_KEYS.LEARNING_CONTEXT_CHAR_LIMIT
+  );
+
+  return NextResponse.json({
+    contextCharLimit: contextCharLimit ?? "8000",
+  });
+}

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

@@ -0,0 +1,34 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getSetting, setSetting } from "@/lib/settings/helpers";
+import { SETTINGS_KEYS } from "@/lib/constants/settings";
+
+/**
+ * GET /api/settings/ollama — Read Ollama settings.
+ */
+export async function GET() {
+  const baseUrl = await getSetting(SETTINGS_KEYS.OLLAMA_BASE_URL);
+  const defaultModel = await getSetting(SETTINGS_KEYS.OLLAMA_DEFAULT_MODEL);
+
+  return NextResponse.json({
+    baseUrl: baseUrl || "http://localhost:11434",
+    defaultModel: defaultModel || "",
+  });
+}
+
+/**
+ * POST /api/settings/ollama — Update Ollama settings.
+ * Body: { baseUrl?: string, defaultModel?: string }
+ */
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  if (body.baseUrl !== undefined) {
+    await setSetting(SETTINGS_KEYS.OLLAMA_BASE_URL, body.baseUrl);
+  }
+
+  if (body.defaultModel !== undefined) {
+    await setSetting(SETTINGS_KEYS.OLLAMA_DEFAULT_MODEL, body.defaultModel);
+  }
+
+  return NextResponse.json({ ok: true });
+}

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

@@ -0,0 +1,57 @@
+import { NextResponse } from "next/server";
+import { getRuntimeSetupStates } from "@/lib/settings/runtime-setup";
+import { getRoutingPreference } from "@/lib/settings/routing";
+import { getAuthSettings } from "@/lib/settings/auth";
+import { getOpenAIAuthSettings } from "@/lib/settings/openai-auth";
+
+export async function GET() {
+  const [runtimeStates, routingPreference, anthropicAuth, openaiAuth] =
+    await Promise.all([
+      getRuntimeSetupStates(),
+      getRoutingPreference(),
+      getAuthSettings(),
+      getOpenAIAuthSettings(),
+    ]);
+
+  const anthropicConfigured =
+    runtimeStates["claude-code"].configured ||
+    runtimeStates["anthropic-direct"].configured;
+  const openaiConfigured =
+    runtimeStates["openai-codex-app-server"].configured ||
+    runtimeStates["openai-direct"].configured;
+
+  // Detect dual-billing: user has OAuth (subscription) for Claude Code
+  // AND an API key (pay-as-you-go) for Anthropic Direct
+  const anthropicHasOAuth =
+    anthropicAuth.method === "oauth" || anthropicAuth.apiKeySource === "oauth";
+  const anthropicHasApiKey = anthropicAuth.hasKey;
+  const anthropicDualBilling = anthropicHasOAuth && anthropicHasApiKey;
+
+  return NextResponse.json({
+    providers: {
+      anthropic: {
+        configured: anthropicConfigured,
+        authMethod: anthropicAuth.method,
+        hasKey: anthropicAuth.hasKey,
+        apiKeySource: anthropicAuth.apiKeySource,
+        dualBilling: anthropicDualBilling,
+        runtimes: [
+          runtimeStates["claude-code"],
+          runtimeStates["anthropic-direct"],
+        ],
+      },
+      openai: {
+        configured: openaiConfigured,
+        hasKey: openaiAuth.hasKey,
+        apiKeySource: openaiAuth.apiKeySource,
+        dualBilling: false,
+        runtimes: [
+          runtimeStates["openai-codex-app-server"],
+          runtimeStates["openai-direct"],
+        ],
+      },
+    },
+    routingPreference,
+    configuredProviderCount: Number(anthropicConfigured) + Number(openaiConfigured),
+  });
+}

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

@@ -0,0 +1,24 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getRoutingPreference, setRoutingPreference } from "@/lib/settings/routing";
+import type { RoutingPreference } from "@/lib/constants/settings";
+
+const VALID_VALUES: RoutingPreference[] = ["cost", "latency", "quality", "manual"];
+
+export async function GET() {
+  const preference = await getRoutingPreference();
+  return NextResponse.json({ preference });
+}
+
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  if (!body.preference || !VALID_VALUES.includes(body.preference)) {
+    return NextResponse.json(
+      { error: `preference must be one of: ${VALID_VALUES.join(", ")}` },
+      { status: 400 },
+    );
+  }
+
+  await setRoutingPreference(body.preference);
+  return NextResponse.json({ preference: body.preference });
+}

package/src/app/api/settings/web-search/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getSetting, setSetting } from "@/lib/settings/helpers";
+import { SETTINGS_KEYS } from "@/lib/constants/settings";
+
+export async function GET() {
+  const exaEnabled = await getSetting(SETTINGS_KEYS.EXA_SEARCH_MCP_ENABLED);
+
+  return NextResponse.json({
+    exaSearchEnabled: exaEnabled === "true",
+  });
+}
+
+export async function POST(req: NextRequest) {
+  const body = await req.json();
+
+  if (body.exaSearchEnabled !== undefined) {
+    await setSetting(
+      SETTINGS_KEYS.EXA_SEARCH_MCP_ENABLED,
+      body.exaSearchEnabled ? "true" : "false"
+    );
+  }
+
+  const exaEnabled = await getSetting(SETTINGS_KEYS.EXA_SEARCH_MCP_ENABLED);
+
+  return NextResponse.json({
+    exaSearchEnabled: exaEnabled === "true",
+  });
+}

package/src/app/api/tasks/[id]/execute/route.ts

@@ -1,6 +1,6 @@
 import { NextRequest, NextResponse } from "next/server";
 import { db } from "@/lib/db";
-import { tasks } from "@/lib/db/schema";
+import { tasks, projects } from "@/lib/db/schema";
 import { eq, and } from "drizzle-orm";
 import { executeTaskWithAgent, classifyTaskProfile } from "@/lib/agents/router";
 import { DEFAULT_AGENT_RUNTIME } from "@/lib/agents/runtime/catalog";
@@ -9,6 +9,7 @@ import {
   BudgetLimitExceededError,
   enforceTaskBudgetGuardrails,
 } from "@/lib/settings/budget-guardrails";
+import { ensureFreshScan } from "@/lib/environment/auto-scan";
 
 export async function POST(
   _req: NextRequest,
@@ -47,6 +48,17 @@ export async function POST(
 
   const task = claimed[0];
 
+  // Auto-scan environment if the task's project has a workingDirectory
+  if (task.projectId) {
+    const [project] = await db
+      .select()
+      .from(projects)
+      .where(eq(projects.id, task.projectId));
+    if (project?.workingDirectory) {
+      ensureFreshScan(project.workingDirectory, task.projectId);
+    }
+  }
+
   // Auto-classify profile if none was set
   if (!task.agentProfile) {
     const autoProfile = classifyTaskProfile(

package/src/app/documents/page.tsx

@@ -24,6 +24,9 @@ export default async function DocumentsPage() {
       extractedText: documents.extractedText,
       processedPath: documents.processedPath,
       processingError: documents.processingError,
+      source: documents.source,
+      conversationId: documents.conversationId,
+      messageId: documents.messageId,
       createdAt: documents.createdAt,
       updatedAt: documents.updatedAt,
       taskTitle: tasks.title,

package/src/app/environment/page.tsx

@@ -3,11 +3,16 @@ import { listTemplates } from "@/lib/environment/templates";
 import { calculateHealthScore } from "@/lib/environment/health-scoring";
 import { EnvironmentDashboard } from "@/components/environment/environment-dashboard";
 import { PageShell } from "@/components/shared/page-shell";
-import { getWorkspaceContext } from "@/lib/environment/workspace-context";
+import { getWorkspaceContext, getLaunchCwd } from "@/lib/environment/workspace-context";
+import { ensureFreshScan } from "@/lib/environment/auto-scan";
 
 export const dynamic = "force-dynamic";
 
 export default async function EnvironmentPage() {
+  // Auto-scan the workspace directory if stale or missing
+  const cwd = getLaunchCwd();
+  ensureFreshScan(cwd);
+
   const scan = getLatestScan();
 
   if (!scan) {
@@ -18,6 +23,7 @@ export default async function EnvironmentPage() {
           artifacts={[]}
           categoryCounts={[]}
           toolCounts={[]}
+          scanPath={cwd}
         />
       </PageShell>
     );
@@ -48,6 +54,7 @@ export default async function EnvironmentPage() {
         checkpoints={checkpoints}
         templates={templates}
         healthScore={healthScore}
+        scanPath={cwd}
       />
     </PageShell>
   );

package/src/app/settings/page.tsx

@@ -1,10 +1,14 @@
-import { AuthConfigSection } from "@/components/settings/auth-config-section";
-import { OpenAIRuntimeSection } from "@/components/settings/openai-runtime-section";
+import { ProvidersAndRuntimesSection } from "@/components/settings/providers-runtimes-section";
 import { PermissionsSections } from "@/components/settings/permissions-sections";
 import { DataManagementSection } from "@/components/settings/data-management-section";
 import { BudgetGuardrailsSection } from "@/components/settings/budget-guardrails-section";
 import { ChatSettingsSection } from "@/components/settings/chat-settings-section";
 import { RuntimeTimeoutSection } from "@/components/settings/runtime-timeout-section";
+import { BrowserToolsSection } from "@/components/settings/browser-tools-section";
+import { WebSearchSection } from "@/components/settings/web-search-section";
+import { LearningContextSection } from "@/components/settings/learning-context-section";
+import { OllamaSection } from "@/components/settings/ollama-section";
+import { ChannelsSection } from "@/components/settings/channels-section";
 import { PageShell } from "@/components/shared/page-shell";
 
 export const dynamic = "force-dynamic";
@@ -13,10 +17,14 @@ export default function SettingsPage() {
   return (
     <PageShell title="Settings" description="Manage your Stagent configuration">
       <div className="space-y-6">
-        <AuthConfigSection />
-        <OpenAIRuntimeSection />
+        <ProvidersAndRuntimesSection />
+        <OllamaSection />
         <ChatSettingsSection />
         <RuntimeTimeoutSection />
+        <LearningContextSection />
+        <WebSearchSection />
+        <BrowserToolsSection />
+        <ChannelsSection />
         <BudgetGuardrailsSection />
         <PermissionsSections />
         <DataManagementSection />

package/src/app/workflows/[id]/edit/page.tsx

@@ -34,6 +34,8 @@ export default async function EditWorkflowPage({
     id: p.id,
     name: p.name,
     supportedRuntimes: p.supportedRuntimes,
+    origin: p.origin,
+    scope: p.scope,
   }));
 
   const workflowData = {

package/src/app/workflows/new/page.tsx

@@ -16,6 +16,8 @@ export default async function NewWorkflowPage() {
     id: p.id,
     name: p.name,
     supportedRuntimes: p.supportedRuntimes,
+    origin: p.origin,
+    scope: p.scope,
   }));
 
   return (