@hasna/loops 0.4.1 → 0.4.3

package/dist/sdk/index.js

@@ -1203,7 +1203,7 @@ function discardWorkflowRunManifest(staged) {
 var DEFAULT_RECOVERY_BATCH_LIMIT = 100;
 var DEFAULT_RECOVERY_SCAN_MULTIPLIER = 5;
 var LIVE_EXPIRED_RUN_GRACE_MS = 60000;
-var SCHEMA_USER_VERSION = 6;
+var SCHEMA_USER_VERSION = 7;
 var TERMINAL_RUN_STATUSES = ["succeeded", "failed", "timed_out", "abandoned", "skipped"];
 var PRUNE_BATCH_SIZE = 400;
 var GENERATED_ROUTE_TEMPLATE_IDS = new Set(["todos-task-worker-verifier", "task-lifecycle", "event-worker-verifier"]);
@@ -1523,7 +1523,7 @@ class Store {
     }
     const applied = new Set(this.db.query("SELECT id FROM schema_migrations").all().map((row) => row.id));
     for (const migration of this.migrations()) {
-      if (!migration.baseline && applied.has(migration.id))
+      if (!migration.baseline && !migration.reapply && applied.has(migration.id))
         continue;
       migration.apply();
       if (!applied.has(migration.id)) {
@@ -1573,6 +1573,14 @@ class Store {
           this.addColumnIfMissing("loop_runs", "pgid", "INTEGER");
           this.addColumnIfMissing("loop_runs", "process_started_at", "TEXT");
         }
+      },
+      {
+        id: "0007_run_claim_tokens",
+        reapply: true,
+        apply: () => {
+          this.addColumnIfMissing("loop_runs", "claim_token", "TEXT");
+          this.db.exec("CREATE INDEX IF NOT EXISTS idx_runs_claim_token ON loop_runs(claim_token) WHERE claim_token IS NOT NULL");
+        }
       }
     ];
   }
@@ -1614,6 +1622,7 @@ class Store {
         started_at TEXT,
         finished_at TEXT,
         claimed_by TEXT,
+        claim_token TEXT,
         lease_expires_at TEXT,
         pid INTEGER,
         pgid INTEGER,
@@ -3503,6 +3512,7 @@ class Store {
   }
   claimRun(loop, scheduledFor, runnerId, now = new Date, opts = {}) {
     const startedAt = now.toISOString();
+    const claimToken = opts.claimToken ?? genId();
     this.db.exec("BEGIN IMMEDIATE");
     try {
       this.assertDaemonLeaseFence(opts, startedAt);
@@ -3525,12 +3535,13 @@ class Store {
             return;
           }
           const res3 = this.db.query(`UPDATE loop_runs SET status='running', started_at=$started, finished_at=NULL,
-               claimed_by=$claimedBy, lease_expires_at=$lease, pid=NULL, pgid=NULL, process_started_at=NULL, exit_code=NULL,
+               claimed_by=$claimedBy, claim_token=$claimToken, lease_expires_at=$lease, pid=NULL, pgid=NULL, process_started_at=NULL, exit_code=NULL,
                duration_ms=NULL, stdout=NULL, stderr=NULL, error=NULL, updated_at=$updated
                WHERE id=$id AND status='running' AND lease_expires_at <= $now`).run({
             $id: existing.id,
             $started: startedAt,
             $claimedBy: runnerId,
+            $claimToken: claimToken,
             $lease: leaseExpiresAt,
             $updated: startedAt,
             $now: startedAt
@@ -3539,7 +3550,7 @@ class Store {
           if (res3.changes !== 1)
             return;
           const run3 = this.getRun(existing.id);
-          return run3 ? { run: run3, loop } : undefined;
+          return run3 ? { run: run3, loop, claimToken } : undefined;
         }
         if (existing.status === "succeeded" || existing.status === "skipped") {
           this.db.exec("COMMIT");
@@ -3547,7 +3558,7 @@ class Store {
         }
         const attempt = existing.attempt + 1;
         const res2 = this.db.query(`UPDATE loop_runs SET attempt=$attempt, status='running', started_at=$started, finished_at=NULL,
-             claimed_by=$claimedBy, lease_expires_at=$lease, pid=NULL, pgid=NULL, process_started_at=NULL, exit_code=NULL,
+             claimed_by=$claimedBy, claim_token=$claimToken, lease_expires_at=$lease, pid=NULL, pgid=NULL, process_started_at=NULL, exit_code=NULL,
              duration_ms=NULL, stdout=NULL, stderr=NULL, error=NULL, updated_at=$updated
              WHERE id=$id
                AND status IN ('failed', 'timed_out', 'abandoned')
@@ -3556,6 +3567,7 @@ class Store {
           $attempt: attempt,
           $started: startedAt,
           $claimedBy: runnerId,
+          $claimToken: claimToken,
           $lease: leaseExpiresAt,
           $updated: startedAt,
           $maxAttempts: loop.maxAttempts
@@ -3564,12 +3576,12 @@ class Store {
         if (res2.changes !== 1)
           return;
         const run2 = this.getRun(existing.id);
-        return run2 ? { run: run2, loop } : undefined;
+        return run2 ? { run: run2, loop, claimToken } : undefined;
       }
       const id = genId();
       const res = this.db.query(`INSERT OR IGNORE INTO loop_runs (id, loop_id, loop_name, scheduled_for, attempt, status, started_at, finished_at,
-            claimed_by, lease_expires_at, pid, exit_code, duration_ms, stdout, stderr, error, created_at, updated_at)
-           VALUES ($id, $loopId, $loopName, $scheduledFor, 1, 'running', $started, NULL, $claimedBy, $lease,
+            claimed_by, claim_token, lease_expires_at, pid, exit_code, duration_ms, stdout, stderr, error, created_at, updated_at)
+           VALUES ($id, $loopId, $loopName, $scheduledFor, 1, 'running', $started, NULL, $claimedBy, $claimToken, $lease,
             NULL, NULL, NULL, NULL, NULL, NULL, $created, $updated)`).run({
         $id: id,
         $loopId: loop.id,
@@ -3577,6 +3589,7 @@ class Store {
         $scheduledFor: scheduledFor,
         $started: startedAt,
         $claimedBy: runnerId,
+        $claimToken: claimToken,
         $lease: leaseExpiresAt,
         $created: startedAt,
         $updated: startedAt
@@ -3585,7 +3598,7 @@ class Store {
       if (res.changes !== 1)
         return;
       const run = this.getRun(id);
-      return run ? { run, loop } : undefined;
+      return run ? { run, loop, claimToken } : undefined;
     } catch (error) {
       try {
         this.db.exec("ROLLBACK");
@@ -3608,16 +3621,18 @@ class Store {
       $error: error ?? null,
       $updated: finishedAt,
       $claimedBy: opts.claimedBy ?? null,
+      $claimToken: opts.claimToken ?? null,
       $now: (opts.now ?? new Date).toISOString(),
       $daemonLeaseId: opts.daemonLeaseId ?? null
     };
     return this.transact(() => {
-      const res = opts.claimedBy ? this.db.query(`UPDATE loop_runs SET status=$status, finished_at=$finished, lease_expires_at=NULL, pid=$pid, exit_code=$exitCode,
+      const res = opts.claimedBy ? this.db.query(`UPDATE loop_runs SET status=$status, finished_at=$finished, claim_token=NULL, lease_expires_at=NULL, pid=$pid, exit_code=$exitCode,
                duration_ms=$durationMs, stdout=$stdout, stderr=$stderr, error=$error, updated_at=$updated
                WHERE id=$id AND status='running' AND claimed_by=$claimedBy AND lease_expires_at > $now
+                 AND ($claimToken IS NULL OR claim_token=$claimToken)
                  AND ($daemonLeaseId IS NULL OR EXISTS (
                    SELECT 1 FROM daemon_lease WHERE id=$daemonLeaseId AND expires_at > $now
-                 ))`).run(params) : this.db.query(`UPDATE loop_runs SET status=$status, finished_at=$finished, lease_expires_at=NULL, pid=$pid, exit_code=$exitCode,
+                 ))`).run(params) : this.db.query(`UPDATE loop_runs SET status=$status, finished_at=$finished, claim_token=NULL, lease_expires_at=NULL, pid=$pid, exit_code=$exitCode,
                duration_ms=$durationMs, stdout=$stdout, stderr=$stderr, error=$error, updated_at=$updated WHERE id=$id`).run(params);
       const run = this.getRun(id);
       if (!run)
@@ -3645,11 +3660,13 @@ class Store {
     const expiresAt = new Date(now.getTime() + leaseMs).toISOString();
     const res = this.db.query(`UPDATE loop_runs SET lease_expires_at=$expires, updated_at=$updated
          WHERE id=$id AND status='running' AND claimed_by=$claimedBy AND lease_expires_at > $now
+           AND ($claimToken IS NULL OR claim_token=$claimToken)
            AND ($daemonLeaseId IS NULL OR EXISTS (
              SELECT 1 FROM daemon_lease WHERE id=$daemonLeaseId AND expires_at > $now
            ))`).run({
       $id: id,
       $claimedBy: claimedBy,
+      $claimToken: opts.claimToken ?? null,
       $expires: expiresAt,
       $updated: now.toISOString(),
       $now: now.toISOString(),
@@ -5544,11 +5561,12 @@ function publicLoop(loop) {
     target
   };
 }
-function publicRun(run, showOutput = false) {
+function publicRun(run, showOutput = false, opts = {}) {
   return {
     ...run,
     stdout: showOutput ? run.stdout : run.stdout ? `[redacted ${run.stdout.length} chars]` : undefined,
-    stderr: showOutput ? run.stderr : run.stderr ? `[redacted ${run.stderr.length} chars]` : undefined
+    stderr: showOutput ? run.stderr : run.stderr ? `[redacted ${run.stderr.length} chars]` : undefined,
+    error: opts.redactError ? redact(run.error) : run.error
   };
 }
 function publicExecutorResult(result, showOutput = false) {

package/docs/DEPLOYMENT_MODES.md

@@ -79,12 +79,19 @@ JSON uses these field names:
 
 `loops-api` is a separate process in the same public package. It is not a
 separate package at this stage because self-hosted users and the hosted service
-must share the same public contract.
+must share the same public contract. The API server can expose storage-backed
+`/v1` loop CRUD and run listing when an embedding host injects the public
+storage contract. The standalone `loops-api serve` binary still fails closed
+for those routes until a self-hosted storage adapter is wired by the operator or
+platform host.
 
 `loops-runner` is the process that connects a machine to a non-local control
-plane. The initial foundation exposes status only. The Postgres schema, claim
-protocol, runner heartbeat/finalization protocol, and import/export migration
-must land before `loops-runner` is advertised as an executing worker.
+plane. The current public package supports a bounded one-shot protocol:
+registration, claim polling, claim-token fenced heartbeat/finalization, and
+`loops-runner run-once` execution for non-workflow targets. Full fleet daemon
+mode, workflow target execution over the remote protocol, and import/export
+migration still need follow-up releases before `loops-runner` is advertised as
+a complete always-on worker.
 
 ## Machine Placement
 
@@ -109,9 +116,10 @@ mode.
 
 Non-local execution needs these follow-up releases before it is live:
 
-- Postgres/control-plane persistence for loops, schedules, runners, claims, and
-  evidence.
-- Runner placement, capability labels, leases, heartbeat, and finalization.
+- A full Postgres control-plane adapter behind the public storage contract.
+- Long-running runner daemon mode with backoff, fleet observability, and
+  durable machine registration records.
+- Workflow target execution over the remote protocol.
 - Import/export migration between local SQLite state and a control plane.
 - Hosted product integration outside the public package.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/loops",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   "type": "module",
   "main": "dist/index.js",
@@ -40,6 +40,22 @@
     "./storage": {
       "types": "./dist/lib/store.d.ts",
       "import": "./dist/lib/store.js"
+    },
+    "./storage/contract": {
+      "types": "./dist/lib/storage/contract.d.ts",
+      "import": "./dist/lib/storage/contract.js"
+    },
+    "./storage/sqlite": {
+      "types": "./dist/lib/storage/sqlite.d.ts",
+      "import": "./dist/lib/storage/sqlite.js"
+    },
+    "./storage/postgres": {
+      "types": "./dist/lib/storage/postgres.d.ts",
+      "import": "./dist/lib/storage/postgres.js"
+    },
+    "./storage/postgres-schema": {
+      "types": "./dist/lib/storage/postgres-schema.d.ts",
+      "import": "./dist/lib/storage/postgres-schema.js"
     }
   },
   "files": [
@@ -50,7 +66,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build src/cli/index.ts src/daemon/index.ts src/api/index.ts src/runner/index.ts src/mcp/index.ts src/index.ts src/sdk/index.ts src/lib/store.ts src/lib/mode.ts --root src --outdir dist --target bun --packages external && chmod +x dist/cli/index.js dist/daemon/index.js dist/api/index.js dist/runner/index.js dist/mcp/index.js && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+    "build": "rm -rf dist && bun build src/cli/index.ts src/daemon/index.ts src/api/index.ts src/runner/index.ts src/mcp/index.ts src/index.ts src/sdk/index.ts src/lib/store.ts src/lib/mode.ts src/lib/storage/index.ts src/lib/storage/contract.ts src/lib/storage/sqlite.ts src/lib/storage/postgres.ts src/lib/storage/postgres-schema.ts --root src --outdir dist --target bun --packages external && chmod +x dist/cli/index.js dist/daemon/index.js dist/api/index.js dist/runner/index.js dist/mcp/index.js && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
     "build:bin": "bun build src/cli/index.ts --compile --outfile dist/loops",
     "typecheck": "tsc --noEmit",
     "test": "bun test",