@saadnvd1/agent-os 0.3.523 → 0.3.527

package/lib/simulator/simctl.ts

@@ -0,0 +1,167 @@
+/**
+ * The iOS simulators AgentOS makes for tasks, through `xcrun simctl`. Every
+ * device is named with this instance's prefix, and nothing destructive is
+ * ever done to a device without it: a project's own simulators and another
+ * AgentOS instance's (a dev one, say) are never touched.
+ */
+
+import { execFile } from "child_process";
+import { createHash } from "crypto";
+import path from "path";
+import { promisify } from "util";
+
+const execFileAsync = promisify(execFile);
+
+export interface SimDevice {
+  udid: string;
+  name: string;
+  state: string;
+  runtime: string;
+}
+
+export type SimctlRun = (args: string[]) => Promise<string>;
+
+const realRun: SimctlRun = async (args) =>
+  (
+    await execFileAsync("xcrun", ["simctl", ...args], {
+      timeout: 180_000,
+      maxBuffer: 16 * 1024 * 1024,
+    })
+  ).stdout.trim();
+
+let run: SimctlRun = realRun;
+// Tests swap simctl for a fake; nothing else calls this.
+export function setSimctlRunner(fake: SimctlRun | null): void {
+  run = fake ?? realRun;
+}
+
+// Short and stable per database, so two instances on one Mac stay apart.
+export function instancePrefix(): string {
+  const db = process.env.DB_PATH || path.join(process.cwd(), "agent-os.db");
+  return `aos-${createHash("sha1").update(db).digest("hex").slice(0, 6)}-`;
+}
+
+export const baseName = () => `${instancePrefix()}base`;
+export const deviceNameFor = (sessionId: string) =>
+  `${instancePrefix()}${sessionId.replace(/-/g, "").slice(0, 8)}`;
+export const ownsDevice = (name: string) => name.startsWith(instancePrefix());
+
+export function parseDevices(json: string): SimDevice[] {
+  const parsed = JSON.parse(json) as {
+    devices?: Record<
+      string,
+      { udid: string; name: string; state: string; isAvailable?: boolean }[]
+    >;
+  };
+  return Object.entries(parsed.devices ?? {}).flatMap(([runtime, list]) =>
+    list
+      .filter((d) => d.isAvailable !== false)
+      .map((d) => ({
+        udid: d.udid,
+        name: d.name,
+        state: d.state,
+        runtime,
+      }))
+  );
+}
+
+export async function listDevices(): Promise<SimDevice[]> {
+  return parseDevices(await run(["list", "devices", "-j"]));
+}
+
+// The newest installed iOS runtime and the device type for a model name
+// ("iPhone 17" is com.apple.CoreSimulator.SimDeviceType.iPhone-17).
+async function newestRuntime(): Promise<string> {
+  const parsed = JSON.parse(await run(["list", "runtimes", "-j"])) as {
+    runtimes: { identifier: string; name: string; isAvailable: boolean }[];
+  };
+  const ios = parsed.runtimes.filter(
+    (r) => r.isAvailable && r.name.startsWith("iOS")
+  );
+  const newest = ios.sort((a, b) =>
+    a.name.localeCompare(b.name, undefined, { numeric: true })
+  )[ios.length - 1];
+  if (!newest) throw new Error("no iOS simulator runtime is installed");
+  return newest.identifier;
+}
+
+export const deviceTypeFor = (model: string) =>
+  `com.apple.CoreSimulator.SimDeviceType.${model.trim().replace(/\s+/g, "-")}`;
+
+let baseBuilding: Promise<SimDevice> | null = null;
+
+// The device every task's simulator is cloned from: made once, booted once so
+// its first-run setup is done, then left shut down.
+export function ensureBase(model: string): Promise<SimDevice> {
+  baseBuilding ??= buildBase(model).finally(() => {
+    baseBuilding = null;
+  });
+  return baseBuilding;
+}
+
+async function buildBase(model: string): Promise<SimDevice> {
+  const runtime = await newestRuntime();
+  const existing = (await listDevices()).find(
+    (d) => d.name === baseName() && d.runtime === runtime
+  );
+  if (existing) return existing;
+  // A base on an older runtime is replaced; its clones keep working.
+  for (const d of (await listDevices()).filter((d) => d.name === baseName()))
+    await deleteDevice(d);
+  const udid = await run(["create", baseName(), deviceTypeFor(model), runtime]);
+  await run(["boot", udid]);
+  await run(["bootstatus", udid, "-b"]);
+  await run(["shutdown", udid]);
+  return { udid, name: baseName(), state: "Shutdown", runtime };
+}
+
+export async function cloneDevice(base: SimDevice, name: string) {
+  if (!ownsDevice(name)) throw new Error(`refusing to create ${name}`);
+  return run(["clone", base.udid, name]);
+}
+
+export async function bootDevice(udid: string): Promise<void> {
+  try {
+    await run(["boot", udid]);
+  } catch (error) {
+    // Booting a booted device is not a failure.
+    if (!/current state: Booted/i.test(String(error))) throw error;
+  }
+  await run(["bootstatus", udid, "-b"]);
+}
+
+export async function shutdownDevice(device: {
+  udid: string;
+  name: string;
+}): Promise<void> {
+  if (!ownsDevice(device.name)) return;
+  try {
+    await run(["shutdown", device.udid]);
+  } catch (error) {
+    if (!/current state: Shutdown/i.test(String(error))) throw error;
+  }
+}
+
+export async function deleteDevice(device: {
+  udid: string;
+  name: string;
+}): Promise<void> {
+  if (!ownsDevice(device.name)) return;
+  await shutdownDevice(device).catch(() => {});
+  await run(["delete", device.udid]);
+}
+
+// What the device's app logged lately, newest last.
+export const recentLog = (udid: string, process: string, last: string) =>
+  run([
+    "spawn",
+    udid,
+    "log",
+    "show",
+    "--last",
+    last,
+    "--predicate",
+    `process == "${process.replace(/[^\w .-]/g, "")}"`,
+    "--style",
+    "compact",
+  ]);

package/lib/welcome-url.ts

@@ -3,7 +3,12 @@
 
 export const WELCOME_PARAM = "welcome";
 
-export const WELCOME_STEPS = ["agents", "project", "finish"] as const;
+export const WELCOME_STEPS = [
+  "agents",
+  "project",
+  "devices",
+  "finish",
+] as const;
 
 export type WelcomeStep = (typeof WELCOME_STEPS)[number];
 

package/package.json

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

package/server.ts

@@ -71,6 +71,7 @@ import { claimAgentosEnv } from "./lib/agents/self-env";
 import { wslNotes, wslVersion } from "./lib/wsl";
 import { getAllProjects } from "./lib/projects";
 import { isRemoteHost } from "./lib/hosts";
+import { sweepSimulators } from "./lib/simulator";
 
 const dev = process.env.NODE_ENV !== "production";
 const hostname = "127.0.0.1";
@@ -369,6 +370,21 @@ app.prepare().then(async () => {
     sweepOrphanTmux().catch((error) =>
       console.error("Sweeping orphaned tmux sessions failed:", error)
     );
+  // Simulators of tasks that ended or crashed, now and every few minutes.
+  let sweepingSims = false;
+  const sweepSims = async () => {
+    if (sweepingSims) return;
+    sweepingSims = true;
+    try {
+      await sweepSimulators();
+    } catch (error) {
+      console.error("Sweeping simulators failed:", error);
+    } finally {
+      sweepingSims = false;
+    }
+  };
+  void sweepSims();
+  setInterval(sweepSims, 5 * 60_000);
   // Chat turns that kept running through a restart.
   void reattachChats();
   // Reviews this restart cut off run again and deliver their verdicts.

package/stores/needsYouFocus.ts

@@ -0,0 +1,13 @@
+import { proxy } from "valtio";
+
+// "Show this ask", raised by the Needs-you strip and handled by the asks list
+// above the chat, which opens itself and scrolls the card into view.
+export const needsYouFocus = proxy<{
+  ask: { id: number; at: number } | null;
+}>({ ask: null });
+
+export const needsYouFocusActions = {
+  ask: (id: number) => {
+    needsYouFocus.ask = { id, at: Date.now() };
+  },
+};

package/stores/welcomeUi.test.ts

@@ -0,0 +1,15 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { welcomeUi, welcomeUiActions } from "./welcomeUi";
+
+describe("choosing a project in the welcome", () => {
+  beforeEach(() => {
+    welcomeUiActions.go("project");
+    welcomeUiActions.setProject(null);
+  });
+
+  it("remembers it and lands on the devices step, not the finish", () => {
+    welcomeUiActions.chooseProject("p1");
+    expect(welcomeUi.projectId).toBe("p1");
+    expect(welcomeUi.step).toBe("devices");
+  });
+});

package/stores/welcomeUi.ts

@@ -1,5 +1,5 @@
 import { proxy } from "valtio";
-import type { WelcomeStep } from "@/lib/welcome-url";
+import { WELCOME_STEPS, type WelcomeStep } from "@/lib/welcome-url";
 
 // The first-run welcome: whether it is on show, the step, and the project
 // the user made (or picked) to start in.
@@ -20,6 +20,11 @@ export const welcomeUiActions = {
   setProject: (projectId: string | null) => {
     welcomeUi.projectId = projectId;
   },
+  // A project picked or added: remember it and move to the step after "project".
+  chooseProject: (projectId: string) => {
+    welcomeUi.projectId = projectId;
+    welcomeUi.step = WELCOME_STEPS[WELCOME_STEPS.indexOf("project") + 1];
+  },
   close: () => {
     welcomeUi.open = false;
   },