@saadnvd1/agent-os 0.3.533 → 0.3.534

package/lib/schedules/start.ts

@@ -17,6 +17,8 @@ import { notifyStatusChanged } from "../status/hub";
 import { formatRunTime } from "./cron";
 import { Braked, fromLabel, type RunDeps, type Started } from "./run";
 import { braked, BrakeRefused } from "../orchestrator/brakes";
+import { startRun } from "../recipes/run";
+import { hasLiveRun } from "../recipes/store";
 import { startedSessions, type Schedule, type ScheduleRun } from "./store";
 
 function projectOf(schedule: Schedule) {
@@ -220,6 +222,8 @@ export async function stillRunning(
       return schedule.target_session_id
         ? sessionBusy(schedule.target_session_id)
         : false;
+    case "recipe":
+      return schedule.recipe_id ? hasLiveRun(schedule.recipe_id) : false;
     case "orchestrator": {
       // A message: done once it's delivered. An agent's check-in, like one
       // to any session, waits while the orchestrator is still working.
@@ -279,17 +283,37 @@ async function throughBrakes(
   }
 }
 
+// A recipe's timer starts a run; the recipe's own checks (one live run,
+// brakes) decide the rest.
+async function startRecipe(
+  schedule: Schedule,
+  onSession: OnSession,
+  trigger: "timer" | "catch-up"
+): Promise<string> {
+  if (!schedule.recipe_id) throw new Error("Its recipe is gone");
+  try {
+    const { run } = await startRun(schedule.recipe_id, { trigger });
+    if (run.session_id) onSession(run.session_id);
+    return run.session_id ?? "";
+  } catch (error) {
+    if (error instanceof BrakeRefused) throw new Braked(error.reason);
+    throw error;
+  }
+}
+
 export const realDeps: RunDeps = {
   start: (schedule, onSession) =>
-    schedule.kind === "task"
-      ? throughBrakes(schedule, "task", () => startTask(schedule, onSession))
-      : schedule.kind === "session"
-        ? throughBrakes(schedule, "session", () =>
-            startSession(schedule, onSession)
-          )
-        : schedule.kind === "message"
-          ? messageSession(schedule, onSession)
-          : postToOrchestrator(schedule, onSession),
+    schedule.kind === "recipe"
+      ? startRecipe(schedule, onSession, "timer")
+      : schedule.kind === "task"
+        ? throughBrakes(schedule, "task", () => startTask(schedule, onSession))
+        : schedule.kind === "session"
+          ? throughBrakes(schedule, "session", () =>
+              startSession(schedule, onSession)
+            )
+          : schedule.kind === "message"
+            ? messageSession(schedule, onSession)
+            : postToOrchestrator(schedule, onSession),
   stillRunning,
   notify,
 };

package/lib/schedules/store.ts

@@ -25,7 +25,9 @@ export const SCHEDULE_KINDS = [
   "orchestrator",
   "message",
 ] as const;
-export type ScheduleKind = (typeof SCHEDULE_KINDS)[number];
+// "recipe" is a recipe's timer (lib/recipes/timer): it runs a recipe, and is
+// made and edited through the recipe, never through the Schedules form.
+export type ScheduleKind = (typeof SCHEDULE_KINDS)[number] | "recipe";
 
 export type RunTrigger = "schedule" | "catch-up" | "manual";
 // "claimed" only between taking a slot and starting its work.
@@ -44,6 +46,8 @@ export interface Schedule {
   // A "message" schedule's session. Its id is the address; its name is
   // only looked up to show.
   target_session_id: string | null;
+  // A recipe timer's recipe.
+  recipe_id?: string | null;
   // The agent session that made it (aos schedule add), or null for Saad.
   created_by_session_id: string | null;
   enabled: boolean;
@@ -223,7 +227,7 @@ function validate(
     throw new Error("A schedule name can't use quotes or [ ]");
   const prompt = input.prompt?.trim();
   if (!prompt) throw new Error("Write the prompt it runs");
-  if (!SCHEDULE_KINDS.includes(input.kind))
+  if (!(SCHEDULE_KINDS as readonly string[]).includes(input.kind))
     throw new Error("Pick task, session, orchestrator or message");
   const timezone = input.timezone?.trim() || DEFAULT_TIMEZONE;
   if (!isTimezone(timezone)) throw new Error(`Unknown time zone "${timezone}"`);

package/lib/security/demo.ts

@@ -57,6 +57,7 @@ export const STATIC_SIBLINGS = [
   "connect",
   "detect",
   "done-idle",
+  "draft",
   "held-replies",
   "import",
   "init",

package/lib/settings-url.ts

@@ -10,6 +10,7 @@ export const SETTINGS_SECTIONS = [
   "models",
   "devices",
   "notifications",
+  "recipes",
   "schedules",
   "audits",
   "setup",

package/lib/tasks/loop-types.ts

@@ -149,7 +149,30 @@ export interface TaskChecks {
 
 // -- A task's plan ---------------------------------------------------------
 
+export interface PlanPieceView {
+  position: number;
+  name: string;
+  slice: string;
+  project: string;
+  afterPosition: number | null;
+  afterKind: "merged" | "deployed" | null;
+  reasons: string[];
+  owns: string[];
+  // Merging into the piece before would break why it was split (a).
+  forced: boolean;
+  // Saad's pending edit, applied at approval.
+  edit: "merge" | "drop" | null;
+}
+
+export interface PlanPiecesView {
+  pieces: PlanPieceView[];
+  folded: { name: string; into: number; why: string }[];
+  warnings: string[];
+}
+
 export interface TaskPlan {
+  // Set once a plan waits for approval: how the checker split it.
+  pieces?: PlanPiecesView | null;
   // As the starter decided (null reason when unstated).
   planned: boolean;
   reason: string | null;

package/lib/tasks/plan-view.ts

@@ -9,7 +9,13 @@ import fs from "fs";
 import path from "path";
 import { db, type Session } from "../db";
 import { PLAN_FILE, planSummary } from "../models/plan-step";
-import { PLAN_TEXT_MAX, type TaskPlan } from "./loop-types";
+import { planFor } from "../plans/features";
+import { parseEdits } from "../plans/pieces";
+import {
+  PLAN_TEXT_MAX,
+  type PlanPiecesView,
+  type TaskPlan,
+} from "./loop-types";
 import { expandHome } from "./session";
 
 const TITLE_MAX = 120;
@@ -61,6 +67,36 @@ function capped(text: string) {
   return { text: over ? text.slice(0, PLAN_TEXT_MAX) : text, truncated: over };
 }
 
+const PIECES_READ_MAX = 400_000;
+
+// How the plan splits, read from the whole file (the block is at its end).
+function piecesView(session: Session, file: string): PlanPiecesView | null {
+  const text = readHead(file, PIECES_READ_MAX);
+  const result = text ? planFor(session, text) : null;
+  if (!result) return null;
+  const edits = parseEdits(session.plan_edits);
+  return {
+    pieces: result.pieces.map((p) => ({
+      position: p.position,
+      name: p.name,
+      slice: p.slice,
+      project: p.project.name,
+      afterPosition: p.afterPosition,
+      afterKind: p.afterKind,
+      reasons: p.reasons,
+      owns: p.owns,
+      forced: p.reasons.includes("a"),
+      edit: edits.drop?.includes(p.position)
+        ? "drop"
+        : edits.merge?.includes(p.position)
+          ? "merge"
+          : null,
+    })),
+    folded: result.folded,
+    warnings: result.warnings,
+  };
+}
+
 export function taskPlan(session: Session): TaskPlan | null {
   const decided = session.plan_decided ?? null;
   const phase = session.plan_phase ?? null;
@@ -111,6 +147,7 @@ export function taskPlan(session: Session): TaskPlan | null {
         source: "step",
         title: planTitle(body),
         path: text !== null ? PLAN_FILE : null,
+        pieces: phase === "awaiting" ? piecesView(session, file) : null,
         ...capped(body),
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.533",
+  "version": "0.3.534",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"

package/server.ts

@@ -13,6 +13,7 @@ import { stackStartGate } from "./lib/orchestrator/brakes";
 import { buildId } from "./lib/build";
 import { startOrchestratorWatcher } from "./lib/orchestrator/watcher";
 import { realDeps, schedulesEnabled, startScheduler } from "./lib/schedules";
+import { startSettling } from "./lib/recipes";
 import { startUsageRollup, usageRollupEnabled } from "./lib/usage/nightly";
 import { resumePhoneOutbox } from "./lib/notify";
 import { resumePushOutbox } from "./lib/notify/push";
@@ -411,6 +412,7 @@ app.prepare().then(async () => {
   if (process.env.AGENTOS_ORCHESTRATOR !== "off") startOrchestratorWatcher();
   // Schedules tick here, once a minute, and nowhere else.
   if (schedulesEnabled(process.env)) startScheduler(realDeps);
+  startSettling();
   resumePhoneOutbox();
   resumePushOutbox();
   // The usage ledger's daily rollup and its ratchet alerts.

package/stores/recipesUi.ts

@@ -0,0 +1,53 @@
+import { proxy } from "valtio";
+import { settingsUiActions } from "./settingsUi";
+
+// Settings > Recipes: one workspace's, or all of them. A recipe opened from
+// elsewhere (a session's menu, the palette), or a finished session to save
+// as one, lands here.
+export const recipesUi = proxy<{
+  workspaceId: string | null;
+  recipeId: string | null;
+  fromSessionId: string | null;
+  runRecipeId: string | null;
+}>({
+  workspaceId: null,
+  recipeId: null,
+  fromSessionId: null,
+  runRecipeId: null,
+});
+
+export const recipesUiActions = {
+  open: (workspaceId: string | null = null) => {
+    Object.assign(recipesUi, {
+      workspaceId,
+      recipeId: null,
+      fromSessionId: null,
+      runRecipeId: null,
+    });
+    settingsUiActions.open("recipes");
+  },
+  openRecipe: (recipeId: string, run = false) => {
+    Object.assign(recipesUi, {
+      recipeId,
+      fromSessionId: null,
+      runRecipeId: run ? recipeId : null,
+    });
+    settingsUiActions.open("recipes");
+  },
+  saveSessionAs: (sessionId: string, workspaceId: string | null = null) => {
+    Object.assign(recipesUi, {
+      workspaceId,
+      recipeId: null,
+      fromSessionId: sessionId,
+      runRecipeId: null,
+    });
+    settingsUiActions.open("recipes");
+  },
+  clear: () => {
+    Object.assign(recipesUi, {
+      recipeId: null,
+      fromSessionId: null,
+      runRecipeId: null,
+    });
+  },
+};