ada-agent 0.1.0

package/src/client/background.ts

@@ -0,0 +1,39 @@
+// Fire-and-forget background jobs: kick off a long, independent subtask without blocking the main
+// loop; check results later with /jobs. ponytail: in-memory, single process — jobs vanish on exit.
+
+interface Job {
+  id: string;
+  task: string;
+  status: "running" | "done" | "error";
+  result?: string;
+  started: number;
+}
+
+const jobs = new Map<string, Job>();
+let seq = 0;
+
+/** Start `run()` in the background; returns a job id immediately. */
+export function startJob(task: string, run: () => Promise<string>): string {
+  const id = `j${++seq}`;
+  const job: Job = { id, task, status: "running", started: Date.now() };
+  jobs.set(id, job);
+  run().then(
+    (r) => {
+      job.status = "done";
+      job.result = r;
+    },
+    (e) => {
+      job.status = "error";
+      job.result = e instanceof Error ? e.message : String(e);
+    },
+  );
+  return id;
+}
+
+export function renderJobs(): string {
+  const all = [...jobs.values()];
+  if (!all.length) return "(no background jobs)";
+  return all
+    .map((j) => `${j.id} [${j.status}] ${j.task.slice(0, 60)}${j.result && j.status !== "running" ? `\n   → ${j.result.slice(0, 240)}` : ""}`)
+    .join("\n");
+}

package/src/client/checkpoint.ts

@@ -0,0 +1,48 @@
+// File checkpoint: the first time the agent touches a file, we record its original content
+// (null = it didn't exist). `/undo` restores everything and removes files the agent created.
+
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+const original = new Map<string, string | null>();
+
+export function record(abs: string): void {
+  if (original.has(abs)) return; // keep the earliest (pre-agent) state
+  original.set(abs, existsSync(abs) ? safeRead(abs) : null);
+}
+
+function safeRead(abs: string): string | null {
+  try {
+    return readFileSync(abs, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+export function pendingCount(): number {
+  return original.size;
+}
+
+export function undoAll(): string {
+  if (!original.size) return "Nothing to undo — the agent hasn't changed any files.";
+  let restored = 0;
+  let removed = 0;
+  for (const [abs, content] of original) {
+    try {
+      if (content === null) {
+        if (existsSync(abs)) {
+          rmSync(abs, { force: true });
+          removed++;
+        }
+      } else {
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, content, "utf8");
+        restored++;
+      }
+    } catch {
+      /* best-effort */
+    }
+  }
+  original.clear();
+  return `Undid agent changes: ${restored} file(s) restored${removed ? `, ${removed} new file(s) removed` : ""}.`;
+}