@hasna/loops 0.3.14 → 0.3.16

package/dist/lib/health.d.ts

@@ -0,0 +1,70 @@
+import type { Loop, LoopRun } from "../types.js";
+import type { Store } from "./store.js";
+export type RunFailureClassification = "rate_limit" | "auth" | "model_not_found" | "context_length" | "schema_response_format" | "node_init" | "timeout" | "sigsegv" | "skipped_previous_active" | "unknown";
+export interface RunFailureSignal {
+    classification: RunFailureClassification;
+    fingerprint: string;
+    evidence: {
+        error?: string;
+        stdout?: string;
+        stderr?: string;
+        exitCode?: number;
+    };
+}
+export interface RecommendedTaskUpsert {
+    title: string;
+    description: string;
+    priority: "critical" | "high" | "medium" | "low";
+    tags: string[];
+    dedupeKey: string;
+    search: {
+        query: string;
+    };
+    compatibilityFallback: {
+        search: string[];
+        add: string[];
+        comment: string[];
+    };
+    futureNativeUpsert: {
+        command: string;
+        fields: Record<string, string | string[]>;
+    };
+}
+export interface LoopExpectationResult {
+    loop: Pick<Loop, "id" | "name" | "status" | "nextRunAt">;
+    ok: boolean;
+    check: {
+        id: "latest-run-succeeded";
+        status: "pass" | "fail" | "warn";
+        message: string;
+    };
+    latestRun?: LoopRun;
+    failure?: RunFailureSignal;
+    route: {
+        source: "openloops";
+        kind: "loop_expectation";
+        loopId: string;
+        loopName: string;
+        cwd?: string;
+        provider?: string;
+    };
+    recommendedTask?: RecommendedTaskUpsert;
+}
+export interface LoopsHealthReport {
+    ok: boolean;
+    generatedAt: string;
+    summary: {
+        loops: number;
+        healthy: number;
+        unhealthy: number;
+        warnings: number;
+    };
+    classifications: Record<RunFailureClassification, number>;
+    expectations: LoopExpectationResult[];
+}
+export declare function classifyRunFailure(run: LoopRun): RunFailureSignal | undefined;
+export declare function expectationForLoop(store: Store, loop: Loop): LoopExpectationResult;
+export declare function buildHealthReport(store: Store, opts?: {
+    includeArchived?: boolean;
+    limit?: number;
+}): LoopsHealthReport;

package/dist/lib/store.d.ts

@@ -74,9 +74,13 @@ export declare class Store {
     listLoops(opts?: {
         status?: LoopStatus;
         limit?: number;
+        archived?: boolean;
+        includeArchived?: boolean;
     }): Loop[];
     dueLoops(now: Date): Loop[];
     updateLoop(id: string, patch: Partial<Pick<Loop, "status" | "nextRunAt" | "retryScheduledFor" | "expiresAt">>, opts?: DaemonLeaseFence): Loop;
+    archiveLoop(idOrName: string): Loop;
+    unarchiveLoop(idOrName: string): Loop;
     deleteLoop(idOrName: string): boolean;
     createWorkflow(input: CreateWorkflowInput): WorkflowSpec;
     getWorkflow(id: string): WorkflowSpec | undefined;
@@ -159,7 +163,10 @@ export declare class Store {
     }): LoopRun[];
     recoverExpiredRunLeases(now?: Date, opts?: DaemonLeaseFence): LoopRun[];
     expireLoops(now?: Date, opts?: DaemonLeaseFence): Loop[];
-    countLoops(status?: LoopStatus): number;
+    countLoops(status?: LoopStatus, opts?: {
+        archived?: boolean;
+        includeArchived?: boolean;
+    }): number;
     countRuns(status?: RunStatus): number;
     acquireDaemonLease(input: {
         id: string;

package/dist/lib/store.js

@@ -326,6 +326,17 @@ function optionalPositiveInteger(value, label) {
     throw new Error(`${label} must be a positive integer`);
   return value;
 }
+function optionalStringArray(value, label) {
+  if (value === undefined)
+    return;
+  if (!Array.isArray(value))
+    throw new Error(`${label} must be an array`);
+  const values = value.map((entry, index) => {
+    assertString(entry, `${label}[${index}]`);
+    return entry.trim();
+  }).filter(Boolean);
+  return values.length ? values : undefined;
+}
 function normalizeGoalSpec(value, label = "goal") {
   if (value === undefined)
     return;
@@ -397,6 +408,14 @@ function validateTarget(value, label) {
         throw new Error(`${label}.sandbox is currently supported only for provider codewith, codex, or cursor`);
       }
     }
+    if (value.allowlist !== undefined) {
+      assertObject(value.allowlist, `${label}.allowlist`);
+      optionalStringArray(value.allowlist.tools, `${label}.allowlist.tools`);
+      optionalStringArray(value.allowlist.commands, `${label}.allowlist.commands`);
+      if (value.allowlist.enforcement !== undefined && value.allowlist.enforcement !== "metadata_only") {
+        throw new Error(`${label}.allowlist.enforcement must be metadata_only`);
+      }
+    }
     return value;
   }
   throw new Error(`${label}.type must be command or agent`);
@@ -480,6 +499,8 @@ function rowToLoop(row) {
     name: row.name,
     description: row.description ?? undefined,
     status: row.status,
+    archivedAt: row.archived_at ?? undefined,
+    archivedFromStatus: row.archived_from_status ? row.archived_from_status : undefined,
     schedule: JSON.parse(row.schedule_json),
     target: JSON.parse(row.target_json),
     goal: row.goal_json ? JSON.parse(row.goal_json) : undefined,
@@ -689,6 +710,8 @@ class Store {
         name TEXT NOT NULL,
         description TEXT,
         status TEXT NOT NULL,
+        archived_at TEXT,
+        archived_from_status TEXT,
         schedule_json TEXT NOT NULL,
         target_json TEXT NOT NULL,
         goal_json TEXT,
@@ -889,6 +912,8 @@ class Store {
     `);
     this.addColumnIfMissing("loops", "machine_json", "TEXT");
     this.addColumnIfMissing("loops", "goal_json", "TEXT");
+    this.addColumnIfMissing("loops", "archived_at", "TEXT");
+    this.addColumnIfMissing("loops", "archived_from_status", "TEXT");
     this.addColumnIfMissing("loop_runs", "goal_run_id", "TEXT");
     this.addColumnIfMissing("workflow_specs", "goal_json", "TEXT");
     this.addColumnIfMissing("workflow_runs", "goal_run_id", "TEXT");
@@ -897,6 +922,7 @@ class Store {
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0001_initial_and_workflows", nowIso());
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0002_loop_machines", nowIso());
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0003_goals", nowIso());
+    this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0004_loop_archive_metadata", nowIso());
   }
   addColumnIfMissing(table, column, definition) {
     const columns = this.db.query(`PRAGMA table_info(${table})`).all();
@@ -973,12 +999,26 @@ class Store {
   }
   listLoops(opts = {}) {
     const limit = opts.limit ?? 200;
-    const rows = opts.status ? this.db.query("SELECT * FROM loops WHERE status = ? ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit) : this.db.query("SELECT * FROM loops ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    let rows;
+    if (opts.status && opts.archived) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? AND archived_at IS NOT NULL ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.status && opts.includeArchived) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.status) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? AND archived_at IS NULL ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.archived) {
+      rows = this.db.query("SELECT * FROM loops WHERE archived_at IS NOT NULL ORDER BY archived_at DESC LIMIT ?").all(limit);
+    } else if (opts.includeArchived) {
+      rows = this.db.query("SELECT * FROM loops ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    } else {
+      rows = this.db.query("SELECT * FROM loops WHERE archived_at IS NULL ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    }
     return rows.map(rowToLoop);
   }
   dueLoops(now) {
     const rows = this.db.query(`SELECT * FROM loops
          WHERE status = 'active'
+           AND archived_at IS NULL
            AND next_run_at IS NOT NULL
            AND next_run_at <= ?
          ORDER BY next_run_at ASC`).all(now.toISOString());
@@ -1010,6 +1050,44 @@ class Store {
       throw new Error(`loop not found after update: ${id}`);
     return after;
   }
+  archiveLoop(idOrName) {
+    const loop = this.requireLoop(idOrName);
+    if (loop.archivedAt)
+      return loop;
+    const updated = nowIso();
+    const archivedStatus = loop.status === "active" ? "paused" : loop.status;
+    this.db.query(`UPDATE loops
+         SET status=$status, archived_at=$archivedAt, archived_from_status=$archivedFromStatus, updated_at=$updated
+         WHERE id=$id`).run({
+      $id: loop.id,
+      $status: archivedStatus,
+      $archivedAt: updated,
+      $archivedFromStatus: loop.status,
+      $updated: updated
+    });
+    const archived = this.getLoop(loop.id);
+    if (!archived)
+      throw new Error(`loop not found after archive: ${loop.id}`);
+    return archived;
+  }
+  unarchiveLoop(idOrName) {
+    const loop = this.requireLoop(idOrName);
+    if (!loop.archivedAt)
+      return loop;
+    const updated = nowIso();
+    const restoredStatus = loop.archivedFromStatus ?? loop.status;
+    this.db.query(`UPDATE loops
+         SET status=$status, archived_at=NULL, archived_from_status=NULL, updated_at=$updated
+         WHERE id=$id`).run({
+      $id: loop.id,
+      $status: restoredStatus,
+      $updated: updated
+    });
+    const unarchived = this.getLoop(loop.id);
+    if (!unarchived)
+      throw new Error(`loop not found after unarchive: ${loop.id}`);
+    return unarchived;
+  }
   deleteLoop(idOrName) {
     const loop = this.requireLoop(idOrName);
     const res = this.db.query("DELETE FROM loops WHERE id = ?").run(loop.id);
@@ -1784,10 +1862,16 @@ class Store {
   }
   claimRun(loop, scheduledFor, runnerId, now = new Date, opts = {}) {
     const startedAt = now.toISOString();
-    const leaseExpiresAt = new Date(now.getTime() + loop.leaseMs).toISOString();
     this.db.exec("BEGIN IMMEDIATE");
     try {
       this.assertDaemonLeaseFence(opts, startedAt);
+      const currentLoop = this.getLoop(loop.id);
+      if (!currentLoop || currentLoop.archivedAt) {
+        this.db.exec("COMMIT");
+        return;
+      }
+      loop = currentLoop;
+      const leaseExpiresAt = new Date(now.getTime() + loop.leaseMs).toISOString();
       const existing = this.getRunBySlot(loop.id, scheduledFor);
       if (existing) {
         if (existing.status === "running") {
@@ -2005,7 +2089,7 @@ class Store {
     return recovered;
   }
   expireLoops(now = new Date, opts = {}) {
-    const rows = this.db.query("SELECT * FROM loops WHERE status = 'active' AND expires_at IS NOT NULL AND expires_at <= ?").all(now.toISOString());
+    const rows = this.db.query("SELECT * FROM loops WHERE status = 'active' AND archived_at IS NULL AND expires_at IS NOT NULL AND expires_at <= ?").all(now.toISOString());
     const expired = [];
     for (const row of rows) {
       const updated = this.updateLoop(row.id, { status: "expired", nextRunAt: undefined }, opts);
@@ -2014,8 +2098,21 @@ class Store {
     }
     return expired;
   }
-  countLoops(status) {
-    const row = status ? this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ?").get(status) : this.db.query("SELECT COUNT(*) AS count FROM loops").get();
+  countLoops(status, opts = {}) {
+    let row;
+    if (status && opts.archived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ? AND archived_at IS NOT NULL").get(status);
+    } else if (status && opts.includeArchived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ?").get(status);
+    } else if (status) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ? AND archived_at IS NULL").get(status);
+    } else if (opts.archived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE archived_at IS NOT NULL").get();
+    } else if (opts.includeArchived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops").get();
+    } else {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE archived_at IS NULL").get();
+    }
     return row?.count ?? 0;
   }
   countRuns(status) {

package/dist/lib/templates.d.ts

@@ -8,7 +8,13 @@ export interface TodosTaskWorkflowTemplateInput {
     projectPath: string;
     provider?: AgentProvider;
     authProfile?: string;
+    authProfilePool?: string[];
+    workerAuthProfile?: string;
+    verifierAuthProfile?: string;
     account?: AccountRef;
+    accountPool?: AccountRef[];
+    workerAccount?: AccountRef;
+    verifierAccount?: AccountRef;
     model?: string;
     variant?: string;
     agent?: string;
@@ -27,7 +33,13 @@ export interface EventWorkflowTemplateInput {
     projectPath: string;
     provider?: AgentProvider;
     authProfile?: string;
+    authProfilePool?: string[];
+    workerAuthProfile?: string;
+    verifierAuthProfile?: string;
     account?: AccountRef;
+    accountPool?: AccountRef[];
+    workerAccount?: AccountRef;
+    verifierAccount?: AccountRef;
     model?: string;
     variant?: string;
     agent?: string;

package/dist/sdk/index.d.ts

@@ -17,6 +17,8 @@ export declare class LoopsClient {
     pause(idOrName: string): Loop;
     resume(idOrName: string): Loop;
     stop(idOrName: string): Loop;
+    archive(idOrName: string): Loop;
+    unarchive(idOrName: string): Loop;
     delete(idOrName: string): boolean;
     runs(loopId?: string): LoopRun[];
     goal(idOrName: string): {

package/dist/sdk/index.js

@@ -326,6 +326,17 @@ function optionalPositiveInteger(value, label) {
     throw new Error(`${label} must be a positive integer`);
   return value;
 }
+function optionalStringArray(value, label) {
+  if (value === undefined)
+    return;
+  if (!Array.isArray(value))
+    throw new Error(`${label} must be an array`);
+  const values = value.map((entry, index) => {
+    assertString(entry, `${label}[${index}]`);
+    return entry.trim();
+  }).filter(Boolean);
+  return values.length ? values : undefined;
+}
 function normalizeGoalSpec(value, label = "goal") {
   if (value === undefined)
     return;
@@ -397,6 +408,14 @@ function validateTarget(value, label) {
         throw new Error(`${label}.sandbox is currently supported only for provider codewith, codex, or cursor`);
       }
     }
+    if (value.allowlist !== undefined) {
+      assertObject(value.allowlist, `${label}.allowlist`);
+      optionalStringArray(value.allowlist.tools, `${label}.allowlist.tools`);
+      optionalStringArray(value.allowlist.commands, `${label}.allowlist.commands`);
+      if (value.allowlist.enforcement !== undefined && value.allowlist.enforcement !== "metadata_only") {
+        throw new Error(`${label}.allowlist.enforcement must be metadata_only`);
+      }
+    }
     return value;
   }
   throw new Error(`${label}.type must be command or agent`);
@@ -480,6 +499,8 @@ function rowToLoop(row) {
     name: row.name,
     description: row.description ?? undefined,
     status: row.status,
+    archivedAt: row.archived_at ?? undefined,
+    archivedFromStatus: row.archived_from_status ? row.archived_from_status : undefined,
     schedule: JSON.parse(row.schedule_json),
     target: JSON.parse(row.target_json),
     goal: row.goal_json ? JSON.parse(row.goal_json) : undefined,
@@ -689,6 +710,8 @@ class Store {
         name TEXT NOT NULL,
         description TEXT,
         status TEXT NOT NULL,
+        archived_at TEXT,
+        archived_from_status TEXT,
         schedule_json TEXT NOT NULL,
         target_json TEXT NOT NULL,
         goal_json TEXT,
@@ -889,6 +912,8 @@ class Store {
     `);
     this.addColumnIfMissing("loops", "machine_json", "TEXT");
     this.addColumnIfMissing("loops", "goal_json", "TEXT");
+    this.addColumnIfMissing("loops", "archived_at", "TEXT");
+    this.addColumnIfMissing("loops", "archived_from_status", "TEXT");
     this.addColumnIfMissing("loop_runs", "goal_run_id", "TEXT");
     this.addColumnIfMissing("workflow_specs", "goal_json", "TEXT");
     this.addColumnIfMissing("workflow_runs", "goal_run_id", "TEXT");
@@ -897,6 +922,7 @@ class Store {
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0001_initial_and_workflows", nowIso());
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0002_loop_machines", nowIso());
     this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0003_goals", nowIso());
+    this.db.query("INSERT OR IGNORE INTO schema_migrations (id, applied_at) VALUES (?, ?)").run("0004_loop_archive_metadata", nowIso());
   }
   addColumnIfMissing(table, column, definition) {
     const columns = this.db.query(`PRAGMA table_info(${table})`).all();
@@ -973,12 +999,26 @@ class Store {
   }
   listLoops(opts = {}) {
     const limit = opts.limit ?? 200;
-    const rows = opts.status ? this.db.query("SELECT * FROM loops WHERE status = ? ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit) : this.db.query("SELECT * FROM loops ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    let rows;
+    if (opts.status && opts.archived) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? AND archived_at IS NOT NULL ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.status && opts.includeArchived) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.status) {
+      rows = this.db.query("SELECT * FROM loops WHERE status = ? AND archived_at IS NULL ORDER BY next_run_at ASC LIMIT ?").all(opts.status, limit);
+    } else if (opts.archived) {
+      rows = this.db.query("SELECT * FROM loops WHERE archived_at IS NOT NULL ORDER BY archived_at DESC LIMIT ?").all(limit);
+    } else if (opts.includeArchived) {
+      rows = this.db.query("SELECT * FROM loops ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    } else {
+      rows = this.db.query("SELECT * FROM loops WHERE archived_at IS NULL ORDER BY status ASC, next_run_at ASC LIMIT ?").all(limit);
+    }
     return rows.map(rowToLoop);
   }
   dueLoops(now) {
     const rows = this.db.query(`SELECT * FROM loops
          WHERE status = 'active'
+           AND archived_at IS NULL
            AND next_run_at IS NOT NULL
            AND next_run_at <= ?
          ORDER BY next_run_at ASC`).all(now.toISOString());
@@ -1010,6 +1050,44 @@ class Store {
       throw new Error(`loop not found after update: ${id}`);
     return after;
   }
+  archiveLoop(idOrName) {
+    const loop = this.requireLoop(idOrName);
+    if (loop.archivedAt)
+      return loop;
+    const updated = nowIso();
+    const archivedStatus = loop.status === "active" ? "paused" : loop.status;
+    this.db.query(`UPDATE loops
+         SET status=$status, archived_at=$archivedAt, archived_from_status=$archivedFromStatus, updated_at=$updated
+         WHERE id=$id`).run({
+      $id: loop.id,
+      $status: archivedStatus,
+      $archivedAt: updated,
+      $archivedFromStatus: loop.status,
+      $updated: updated
+    });
+    const archived = this.getLoop(loop.id);
+    if (!archived)
+      throw new Error(`loop not found after archive: ${loop.id}`);
+    return archived;
+  }
+  unarchiveLoop(idOrName) {
+    const loop = this.requireLoop(idOrName);
+    if (!loop.archivedAt)
+      return loop;
+    const updated = nowIso();
+    const restoredStatus = loop.archivedFromStatus ?? loop.status;
+    this.db.query(`UPDATE loops
+         SET status=$status, archived_at=NULL, archived_from_status=NULL, updated_at=$updated
+         WHERE id=$id`).run({
+      $id: loop.id,
+      $status: restoredStatus,
+      $updated: updated
+    });
+    const unarchived = this.getLoop(loop.id);
+    if (!unarchived)
+      throw new Error(`loop not found after unarchive: ${loop.id}`);
+    return unarchived;
+  }
   deleteLoop(idOrName) {
     const loop = this.requireLoop(idOrName);
     const res = this.db.query("DELETE FROM loops WHERE id = ?").run(loop.id);
@@ -1784,10 +1862,16 @@ class Store {
   }
   claimRun(loop, scheduledFor, runnerId, now = new Date, opts = {}) {
     const startedAt = now.toISOString();
-    const leaseExpiresAt = new Date(now.getTime() + loop.leaseMs).toISOString();
     this.db.exec("BEGIN IMMEDIATE");
     try {
       this.assertDaemonLeaseFence(opts, startedAt);
+      const currentLoop = this.getLoop(loop.id);
+      if (!currentLoop || currentLoop.archivedAt) {
+        this.db.exec("COMMIT");
+        return;
+      }
+      loop = currentLoop;
+      const leaseExpiresAt = new Date(now.getTime() + loop.leaseMs).toISOString();
       const existing = this.getRunBySlot(loop.id, scheduledFor);
       if (existing) {
         if (existing.status === "running") {
@@ -2005,7 +2089,7 @@ class Store {
     return recovered;
   }
   expireLoops(now = new Date, opts = {}) {
-    const rows = this.db.query("SELECT * FROM loops WHERE status = 'active' AND expires_at IS NOT NULL AND expires_at <= ?").all(now.toISOString());
+    const rows = this.db.query("SELECT * FROM loops WHERE status = 'active' AND archived_at IS NULL AND expires_at IS NOT NULL AND expires_at <= ?").all(now.toISOString());
     const expired = [];
     for (const row of rows) {
       const updated = this.updateLoop(row.id, { status: "expired", nextRunAt: undefined }, opts);
@@ -2014,8 +2098,21 @@ class Store {
     }
     return expired;
   }
-  countLoops(status) {
-    const row = status ? this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ?").get(status) : this.db.query("SELECT COUNT(*) AS count FROM loops").get();
+  countLoops(status, opts = {}) {
+    let row;
+    if (status && opts.archived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ? AND archived_at IS NOT NULL").get(status);
+    } else if (status && opts.includeArchived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ?").get(status);
+    } else if (status) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE status = ? AND archived_at IS NULL").get(status);
+    } else if (opts.archived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE archived_at IS NOT NULL").get();
+    } else if (opts.includeArchived) {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops").get();
+    } else {
+      row = this.db.query("SELECT COUNT(*) AS count FROM loops WHERE archived_at IS NULL").get();
+    }
     return row?.count ?? 0;
   }
   countRuns(status) {
@@ -2377,6 +2474,16 @@ function metadataEnv(metadata) {
     env.LOOPS_GOAL_NODE_KEY = metadata.goalNodeKey;
   return env;
 }
+function allowlistEnv(allowlist) {
+  const env = {};
+  if (allowlist?.tools?.length)
+    env.LOOPS_AGENT_ALLOWED_TOOLS = allowlist.tools.join(",");
+  if (allowlist?.commands?.length)
+    env.LOOPS_AGENT_ALLOWED_COMMANDS = allowlist.commands.join(",");
+  if (allowlist?.tools?.length || allowlist?.commands?.length)
+    env.LOOPS_AGENT_ALLOWLIST_ENFORCEMENT = "metadata_only";
+  return env;
+}
 function providerCommand(provider) {
   switch (provider) {
     case "claude":
@@ -2584,7 +2691,8 @@ function commandSpec(target) {
     account: agentTarget.account,
     accountTool: agentTarget.account?.tool ?? accountToolForProvider(agentTarget.provider),
     preflightAnyOf: agentTarget.provider === "cursor" ? ["cursor", "agent"] : undefined,
-    stdin: agentTarget.prompt
+    stdin: agentTarget.prompt,
+    allowlist: agentTarget.allowlist
   };
 }
 function executionEnv(spec, metadata, opts) {
@@ -2596,6 +2704,7 @@ function executionEnv(spec, metadata, opts) {
     Object.assign(env, accountEnv);
   }
   Object.assign(env, spec.env ?? {});
+  Object.assign(env, allowlistEnv(spec.allowlist));
   env.PATH = normalizeExecutionPath(env);
   Object.assign(env, metadataEnv(metadata));
   return env;
@@ -2634,6 +2743,9 @@ function remoteBootstrapLines(spec, metadata) {
       continue;
     lines.push(`export ${key}=${shellQuote(value)}`);
   }
+  for (const [key, value] of Object.entries(allowlistEnv(spec.allowlist))) {
+    lines.push(`export ${key}=${shellQuote(value)}`);
+  }
   return lines;
 }
 function remoteScript(spec, metadata) {
@@ -3587,12 +3699,16 @@ async function executeLoopTarget(store, loop, run, opts = {}) {
 
 // src/lib/scheduler.ts
 function manualRunScheduledFor(loop, now = new Date) {
+  if (loop.archivedAt)
+    return now.toISOString();
   if (loop.status === "active" && loop.nextRunAt && new Date(loop.nextRunAt).getTime() <= now.getTime()) {
     return loop.retryScheduledFor ?? loop.nextRunAt;
   }
   return now.toISOString();
 }
 function shouldAdvanceManualRun(loop, scheduledFor, now = new Date) {
+  if (loop.archivedAt)
+    return false;
   if (loop.status !== "active")
     return false;
   if (!loop.nextRunAt || new Date(loop.nextRunAt).getTime() > now.getTime())
@@ -3600,6 +3716,8 @@ function shouldAdvanceManualRun(loop, scheduledFor, now = new Date) {
   return scheduledFor === (loop.retryScheduledFor ?? loop.nextRunAt);
 }
 function manualRunSource(loop, scheduledFor, now = new Date) {
+  if (loop.archivedAt)
+    return "ad_hoc";
   if (loop.status !== "active")
     return "ad_hoc";
   if (!loop.nextRunAt || new Date(loop.nextRunAt).getTime() > now.getTime())
@@ -3618,7 +3736,7 @@ function advanceLoop(store, loop, run, finishedAt, succeeded, opts = {}) {
   if (run.status === "running")
     return;
   const current = store.getLoop(loop.id);
-  if (!current || current.status !== "active")
+  if (!current || current.status !== "active" || current.archivedAt)
     return;
   if (current.retryScheduledFor && current.retryScheduledFor !== run.scheduledFor)
     return;
@@ -3903,16 +4021,28 @@ class LoopsClient {
   }
   pause(idOrName) {
     const loop = this.get(idOrName);
+    if (loop.archivedAt)
+      throw new Error(`loop is archived; unarchive it before pausing: ${idOrName}`);
     return this.store.updateLoop(loop.id, { status: "paused" });
   }
   resume(idOrName) {
     const loop = this.get(idOrName);
+    if (loop.archivedAt)
+      throw new Error(`loop is archived; unarchive it before resuming: ${idOrName}`);
     return this.store.updateLoop(loop.id, { status: "active" });
   }
   stop(idOrName) {
     const loop = this.get(idOrName);
+    if (loop.archivedAt)
+      throw new Error(`loop is archived; unarchive it before stopping: ${idOrName}`);
     return this.store.updateLoop(loop.id, { status: "stopped", nextRunAt: undefined });
   }
+  archive(idOrName) {
+    return this.store.archiveLoop(idOrName);
+  }
+  unarchive(idOrName) {
+    return this.store.unarchiveLoop(idOrName);
+  }
   delete(idOrName) {
     return this.store.deleteLoop(idOrName);
   }
@@ -3931,6 +4061,8 @@ class LoopsClient {
   }
   async runNow(idOrName) {
     const loop = this.get(idOrName);
+    if (loop.archivedAt)
+      throw new Error(`loop is archived; unarchive it before running: ${idOrName}`);
     const now = new Date;
     let scheduledFor = manualRunScheduledFor(loop, now);
     let shouldAdvance = shouldAdvanceManualRun(loop, scheduledFor, now);

package/dist/types.d.ts

@@ -54,6 +54,11 @@ export type AgentProvider = "claude" | "cursor" | "codewith" | "aicopilot" | "op
 export type AgentConfigIsolation = "safe" | "none";
 export type AgentPermissionMode = "default" | "plan" | "auto" | "bypass";
 export type AgentSandbox = "read-only" | "workspace-write" | "danger-full-access" | "enabled" | "disabled";
+export interface AgentAllowlistSpec {
+    tools?: string[];
+    commands?: string[];
+    enforcement?: "metadata_only";
+}
 export interface AgentTarget {
     type: "agent";
     provider: AgentProvider;
@@ -68,6 +73,7 @@ export interface AgentTarget {
     configIsolation?: AgentConfigIsolation;
     permissionMode?: AgentPermissionMode;
     sandbox?: AgentSandbox;
+    allowlist?: AgentAllowlistSpec;
     account?: AccountRef;
 }
 export interface WorkflowTarget {
@@ -175,6 +181,8 @@ export interface Loop {
     name: string;
     description?: string;
     status: LoopStatus;
+    archivedAt?: string;
+    archivedFromStatus?: LoopStatus;
     schedule: ScheduleSpec;
     target: LoopTarget;
     goal?: GoalSpec;