@north-light/cli 0.3.529 → 0.3.531

package/dist/core/canvas/daemon-actions.js

@@ -1,4 +1,4 @@
-var f=Object.defineProperty;var a=(t,e)=>f(t,"name",{value:e,configurable:!0});import{prepared as n}from"../sqlite-statements.js";import{randomBytes as T}from"node:crypto";import{openDb as l,withCanvasWrite as _}from"./db.js";import{normalizedSettlement as A}from"./deliveries.js";import{withRetryBudget as L}from"./delivery-contract.js";import{emitEvent as y}from"../events/emit.js";function h(t){t.exec(`CREATE TABLE IF NOT EXISTS daemon_actions (
+var u=Object.defineProperty;var a=(t,e)=>u(t,"name",{value:e,configurable:!0});import{randomBytes as N}from"node:crypto";import{withCanvasWrite as l,openDb as c}from"./db.js";import{normalizedSettlement as f}from"./deliveries.js";import{withRetryBudget as T}from"./delivery-contract.js";import{emitEvent as y}from"../events/emit.js";async function O(t){await t.exec(`CREATE TABLE IF NOT EXISTS daemon_actions (
     action_id TEXT PRIMARY KEY,
     adapter_json TEXT NOT NULL,
     body_json TEXT,
@@ -15,14 +15,14 @@ var f=Object.defineProperty;var a=(t,e)=>f(t,"name",{value:e,configurable:!0});i
     created_at INTEGER NOT NULL,
     updated_at INTEGER NOT NULL
   );
-  CREATE INDEX IF NOT EXISTS daemon_actions_due ON daemon_actions(state, next_attempt_at, created_at, action_id) WHERE canceled_at IS NULL;`)}a(h,"createDaemonActionsTable");function m(t){return{actionId:t.action_id,adapter:JSON.parse(t.adapter_json),body:t.body_json===null?null:JSON.parse(t.body_json),idempotencyKey:t.idempotency_key,state:t.state,attempts:t.attempts,nextAttemptAt:t.next_attempt_at,claimedAt:t.claimed_at,claimOwner:t.claim_owner,acknowledgedAt:t.acknowledged_at,failedAt:t.failed_at,lastFailure:t.last_failure_json===null?null:JSON.parse(t.last_failure_json),canceledAt:t.canceled_at,createdAt:t.created_at,updatedAt:t.updated_at}}a(m,"actionFrom");function g(){return T(16).toString("hex")}a(g,"newId");function b(t){return _(e=>{const i=n(e,"SELECT action_id FROM daemon_actions WHERE idempotency_key = ?").get(t.idempotencyKey);if(i!==void 0)return i.action_id;const c=Date.now(),d=g(),r=t.bodyJson===void 0?null:JSON.stringify(t.bodyJson);return n(e,`INSERT INTO daemon_actions (action_id, adapter_json, body_json, idempotency_key, state, attempts, next_attempt_at, created_at, updated_at)
-       VALUES (?, ?, ?, ?, 'pending', 0, ?, ?, ?)`).run(d,JSON.stringify(t.adapter),r,t.idempotencyKey,c,c,c),d})}a(b,"enqueueDaemonAction");function H(t){const e=n(l(),"SELECT * FROM daemon_actions WHERE idempotency_key = ?").get(t);return e===void 0?null:m(e)}a(H,"readDaemonAction");function j(t){const e=n(l(),"SELECT * FROM daemon_actions WHERE action_id = ?").get(t);return e===void 0?null:m(e)}a(j,"readDaemonActionById");function C(t){return n(l(),`SELECT * FROM daemon_actions
+  CREATE INDEX IF NOT EXISTS daemon_actions_due ON daemon_actions(state, next_attempt_at, created_at, action_id) WHERE canceled_at IS NULL;`)}a(O,"createDaemonActionsTable");function s(t){return{actionId:t.action_id,adapter:JSON.parse(t.adapter_json),body:t.body_json===null?null:JSON.parse(t.body_json),idempotencyKey:t.idempotency_key,state:t.state,attempts:t.attempts,nextAttemptAt:t.next_attempt_at,claimedAt:t.claimed_at,claimOwner:t.claim_owner,acknowledgedAt:t.acknowledged_at,failedAt:t.failed_at,lastFailure:t.last_failure_json===null?null:JSON.parse(t.last_failure_json),canceledAt:t.canceled_at,createdAt:t.created_at,updatedAt:t.updated_at}}a(s,"actionFrom");function A(){return N(16).toString("hex")}a(A,"newId");async function I(t){return await l(async e=>{const o=await e.prepare("SELECT action_id FROM daemon_actions WHERE idempotency_key = ?").get(t.idempotencyKey);if(o!==void 0)return o.action_id;const d=Date.now(),n=A(),r=t.bodyJson===void 0?null:JSON.stringify(t.bodyJson);return await e.prepare(`INSERT INTO daemon_actions (action_id, adapter_json, body_json, idempotency_key, state, attempts, next_attempt_at, created_at, updated_at)
+       VALUES (?, ?, ?, ?, 'pending', 0, ?, ?, ?)`).run(n,JSON.stringify(t.adapter),r,t.idempotencyKey,d,d,d),n})}a(I,"enqueueDaemonAction");async function U(t){const e=await(await c()).prepare("SELECT * FROM daemon_actions WHERE idempotency_key = ?").get(t);return e===void 0?null:s(e)}a(U,"readDaemonAction");async function w(t){const e=await(await c()).prepare("SELECT * FROM daemon_actions WHERE action_id = ?").get(t);return e===void 0?null:s(e)}a(w,"readDaemonActionById");async function h(t){return(await(await c()).prepare(`SELECT * FROM daemon_actions
       WHERE state = 'pending' AND canceled_at IS NULL AND next_attempt_at <= ?
-      ORDER BY next_attempt_at, created_at, action_id`).all(t).map(m)}a(C,"dueDaemonActions");function k(t,e,i){return _(c=>{const d=n(c,`UPDATE daemon_actions SET state = 'handed_off', attempts = attempts + 1, claimed_at = ?, claim_owner = ?, updated_at = ?
-        WHERE action_id = ? AND state = 'pending' AND canceled_at IS NULL AND next_attempt_at <= ?`).run(e,i,e,t,e);return Number(d.changes)===0?null:m(n(c,"SELECT * FROM daemon_actions WHERE action_id = ?").get(t))})}a(k,"claimDaemonAction");function F(t,e,i,c,d=Date.now()){const r=L(A(c),e),o=r.settlement,p=o.state==="pending"||o.state==="permanent_failed"?JSON.stringify(o.failure):null,s=o.state==="released"?"pending":o.state,u=o.state==="pending"?o.nextAttemptAt:s==="pending"?d:null,E=_(N=>Number(n(N,`UPDATE daemon_actions
+      ORDER BY next_attempt_at, created_at, action_id`).all(t)).map(s)}a(h,"dueDaemonActions");async function b(t,e,o){return await l(async d=>{const n=await d.prepare(`UPDATE daemon_actions SET state = 'handed_off', attempts = attempts + 1, claimed_at = ?, claim_owner = ?, updated_at = ?
+        WHERE action_id = ? AND state = 'pending' AND canceled_at IS NULL AND next_attempt_at <= ?`).run(e,o,e,t,e);return Number(n.changes)===0?null:s(await d.prepare("SELECT * FROM daemon_actions WHERE action_id = ?").get(t))})}a(b,"claimDaemonAction");async function H(t,e,o,d,n=Date.now()){const r=T(f(d),e),i=r.settlement,p=i.state==="pending"||i.state==="permanent_failed"?JSON.stringify(i.failure):null,_=i.state==="released"?"pending":i.state,E=i.state==="pending"?i.nextAttemptAt:_==="pending"?n:null,m=Number((await(await c()).prepare(`UPDATE daemon_actions
         SET state = ?, next_attempt_at = ?, claimed_at = NULL, claim_owner = NULL,
             acknowledged_at = ?, failed_at = ?, last_failure_json = ?, updated_at = ?
-      WHERE action_id = ? AND state = 'handed_off' AND attempts = ? AND claim_owner = ?`).run(s,u,s==="acknowledged"?d:null,s==="permanent_failed"?d:null,p,d,t,e,i).changes)===1);return E&&r.exhausted&&o.state==="permanent_failed"&&y({level:"error",event:"daemon_action.exhausted",outcome:"failed",attempt:e,fields:{action_id:t,failure:o.failure,retry:`crtr sys retry-delivery ${t}`}}),E}a(F,"settleDaemonAction");function W(t,e=Date.now()){return _(i=>Number(n(i,`UPDATE daemon_actions
+      WHERE action_id = ? AND state = 'handed_off' AND attempts = ? AND claim_owner = ?`).run(_,E,_==="acknowledged"?n:null,_==="permanent_failed"?n:null,p,n,t,e,o)).changes)===1;return m&&r.exhausted&&i.state==="permanent_failed"&&y({level:"error",event:"daemon_action.exhausted",outcome:"failed",attempt:e,fields:{action_id:t,failure:i.failure,retry:`crtr sys retry-delivery ${t}`}}),m}a(H,"settleDaemonAction");async function j(t,e=Date.now()){return Number((await(await c()).prepare(`UPDATE daemon_actions
         SET state = 'pending', attempts = 0, next_attempt_at = ?, failed_at = NULL, updated_at = ?
-      WHERE action_id = ? AND state = 'permanent_failed' AND canceled_at IS NULL AND last_failure_json IS NOT NULL`).run(e,e,t).changes)===1)}a(W,"retryFailedDaemonAction");function X(t){return _(e=>Number(n(e,`UPDATE daemon_actions SET state = 'pending', next_attempt_at = ?, claimed_at = NULL, claim_owner = NULL, updated_at = ?
-      WHERE state = 'handed_off'`).run(t,t).changes))}a(X,"resetHandedOffDaemonActions");export{k as claimDaemonAction,h as createDaemonActionsTable,C as dueDaemonActions,b as enqueueDaemonAction,H as readDaemonAction,j as readDaemonActionById,X as resetHandedOffDaemonActions,W as retryFailedDaemonAction,F as settleDaemonAction};
+      WHERE action_id = ? AND state = 'permanent_failed' AND canceled_at IS NULL AND last_failure_json IS NOT NULL`).run(e,e,t)).changes)===1}a(j,"retryFailedDaemonAction");async function C(t){return Number((await(await c()).prepare(`UPDATE daemon_actions SET state = 'pending', next_attempt_at = ?, claimed_at = NULL, claim_owner = NULL, updated_at = ?
+      WHERE state = 'handed_off'`).run(t,t)).changes)}a(C,"resetHandedOffDaemonActions");export{b as claimDaemonAction,O as createDaemonActionsTable,h as dueDaemonActions,I as enqueueDaemonAction,U as readDaemonAction,w as readDaemonActionById,C as resetHandedOffDaemonActions,j as retryFailedDaemonAction,H as settleDaemonAction};

package/dist/core/canvas/daemon-owner.d.ts

@@ -55,13 +55,13 @@ export type DaemonOwnerClaimResult = {
  *  to probe), so a malformed incumbent can only ever be lost against, never
  *  reclaimed, by this primitive alone. That is intentional: this module never
  *  guesses at repair. */
-export declare function claimDaemonOwnership(token: string): DaemonOwnerClaimResult;
+export declare function claimDaemonOwnership(token: string): Promise<DaemonOwnerClaimResult>;
 /** Release exclusive daemon ownership, iff the persisted row still equals
  *  `claim` EXACTLY (key present and value byte-identical to this invocation's
  *  own winning claim). This is a conditional delete, not an unconditional one:
  *  a caller must never release a row a successor has since won (e.g. after
  *  this invocation's claim was already reclaimed via the dead-incumbent CAS
  *  path while this process lingered mid-teardown). */
-export declare function releaseDaemonOwnership(claim: DaemonOwnerClaim): {
+export declare function releaseDaemonOwnership(claim: DaemonOwnerClaim): Promise<{
     readonly released: boolean;
-};
+}>;

package/dist/core/canvas/daemon-owner.js

@@ -1,6 +1,6 @@
-var T=Object.defineProperty;var r=(e,n)=>T(e,"name",{value:n,configurable:!0});import{prepared as u}from"../sqlite-statements.js";import{openDb as m,withCanvasWrite as l}from"./db.js";import{capturePidIdentities as _,recordedPidLiveness as v}from"./pid.js";const s="daemon_owner";function E(e){return JSON.stringify({pid:e.pid,pid_identity:e.pid_identity,token:e.token})}r(E,"serializeClaim");function h(e){let n;try{n=JSON.parse(e)}catch{return null}if(typeof n!="object"||n===null)return null;const{pid:t,pid_identity:i,token:a}=n;return!Number.isInteger(t)||t<=0||typeof i!="string"||i.length===0||typeof a!="string"||a.length===0?null:{pid:t,pid_identity:i,token:a}}r(h,"parseClaim");function y(){m().exec(`
+var p=Object.defineProperty;var i=(e,n)=>p(e,"name",{value:n,configurable:!0});import{openDb as s}from"./db.js";import{capturePidIdentities as E,recordedPidLiveness as m}from"./pid.js";const c="daemon_owner";function l(e){return JSON.stringify({pid:e.pid,pid_identity:e.pid_identity,token:e.token})}i(l,"serializeClaim");function f(e){let n;try{n=JSON.parse(e)}catch{return null}if(typeof n!="object"||n===null)return null;const{pid:a,pid_identity:t,token:r}=n;return!Number.isInteger(a)||a<=0||typeof t!="string"||t.length===0||typeof r!="string"||r.length===0?null:{pid:a,pid_identity:t,token:r}}i(f,"parseClaim");async function y(){await(await s()).exec(`
     CREATE TABLE IF NOT EXISTS canvas_meta (
       key TEXT PRIMARY KEY,
       value TEXT NOT NULL
     )
-  `)}r(y,"ensureOwnerTable");function g(){const e=m();return u(e,"SELECT value FROM canvas_meta WHERE key = ?").get(s)?.value}r(g,"readSnapshot");function w(e){const n=_([process.pid]),t=n?.get(process.pid);if(n===null||t===void 0)return{claimed:!1,reason:"own_identity_indeterminate"};const i={pid:process.pid,pid_identity:t,token:e},a=E(i);for(y();;){const d=g();if(d===void 0){if(l(f=>u(f,"INSERT INTO canvas_meta (key, value) SELECT ?, ? WHERE NOT EXISTS (SELECT 1 FROM canvas_meta WHERE key = ?)").run(s,a,s).changes)===1)return{claimed:!0,claim:i};continue}const c=h(d);if(c===null)return{claimed:!1,reason:"incumbent_malformed"};const o=v(c.pid,c.pid_identity);if(o==="alive"||o==="indeterminate")return{claimed:!1,reason:o==="alive"?"incumbent_alive":"incumbent_indeterminate",incumbentPid:c.pid,verdict:o};if(l(p=>u(p,"UPDATE canvas_meta SET value = ? WHERE key = ? AND value = ?").run(a,s,d).changes)===1)return{claimed:!0,claim:i}}}r(w,"claimDaemonOwnership");function I(e){return{released:l(t=>u(t,"DELETE FROM canvas_meta WHERE key = ? AND value = ?").run(s,E(e)).changes)===1}}r(I,"releaseDaemonOwnership");export{s as DAEMON_OWNER_META_KEY,w as claimDaemonOwnership,I as releaseDaemonOwnership};
+  `)}i(y,"ensureOwnerTable");async function w(){return(await(await s()).prepare("SELECT value FROM canvas_meta WHERE key = ?").get(c))?.value}i(w,"readSnapshot");async function O(e){const n=E([process.pid]),a=n?.get(process.pid);if(n===null||a===void 0)return{claimed:!1,reason:"own_identity_indeterminate"};const t={pid:process.pid,pid_identity:a,token:e},r=l(t);for(await y();;){const d=await w();if(d===void 0){if((await(await s()).prepare("INSERT INTO canvas_meta (key, value) SELECT ?, ? WHERE NOT EXISTS (SELECT 1 FROM canvas_meta WHERE key = ?)").run(c,r,c)).changes===1)return{claimed:!0,claim:t};continue}const o=f(d);if(o===null)return{claimed:!1,reason:"incumbent_malformed"};const u=m(o.pid,o.pid_identity);if(u==="alive"||u==="indeterminate")return{claimed:!1,reason:u==="alive"?"incumbent_alive":"incumbent_indeterminate",incumbentPid:o.pid,verdict:u};if((await(await s()).prepare("UPDATE canvas_meta SET value = ? WHERE key = ? AND value = ?").run(r,c,d)).changes===1)return{claimed:!0,claim:t}}}i(O,"claimDaemonOwnership");async function N(e){return{released:(await(await s()).prepare("DELETE FROM canvas_meta WHERE key = ? AND value = ?").run(c,l(e))).changes===1}}i(N,"releaseDaemonOwnership");export{c as DAEMON_OWNER_META_KEY,O as claimDaemonOwnership,N as releaseDaemonOwnership};

package/dist/core/canvas/db.d.ts

@@ -1,35 +1,11 @@
 import { DatabaseSync, type SQLInputValue } from 'node:sqlite';
-import { prepared } from '../sqlite-statements.js';
 export { MIGRATIONS } from './migrations.js';
-export { prepared };
 /** A schema change invalidates statements compiled against the old schema. */
 export declare function migrate(db: DatabaseSync): void;
 /** Only the daemon (and its API-server test host) registers this process-local hook.
  * Register after migration: TEMP triggers need the real tables to exist. */
 export declare function bindDaemonCanvasOpenHook(hook: (db: DatabaseSync) => void): void;
 export declare function clearDaemonCanvasOpenHook(): void;
-/** Open (or reuse) the canvas db at the current `CRTR_HOME`, configuring WAL
- *  but never changing its schema. Keyed by path so tests with distinct homes get
- *  independent handles.
- *
- *  A cache hit trusts the cached handle outright: `crtrd` is this process's
- *  sole canvas-db owner (see `crtrd-sole-state-owner`), and nothing outside
- *  `openDb`/`closeDb` ever touches `handles` — there is no other actor in this
- *  process that could invalidate a live handle out from under it. (A
- *  2026-06-25 revision added a `PRAGMA database_list` liveness probe here that
- *  silently closed and reopened the handle on any throw; it shipped alongside
- *  an unrelated guest-relay `PATH` fix for the now-removed `hearth` guest
- *  bootstrap, named no concrete failure mode in its commit or a test, and that
- *  guest-relay path no longer exists. Removed rather than kept-and-logged: a
- *  silent boot-path reopen is worse than trusting a handle this process
- *  already owns.) */
-export declare function openDb(): DatabaseSync;
-/** Run `body` under the canvas SQLite write lock, joining an outer transaction
- *  when the shared connection already owns one. This is the common boundary for
- *  multi-statement mutations whose reads and writes must linearize as one unit;
- *  `node:sqlite` rejects nested BEGINs, so only the outermost call commits.
- */
-export declare function withCanvasWrite<T>(body: (db: DatabaseSync) => T): T;
 /** Close and forget the handle for the current home. Mainly for tests. */
 export declare function closeDb(): void;
 export type CanvasParams = [Record<string, SQLInputValue>, ...SQLInputValue[]] | SQLInputValue[];
@@ -48,12 +24,25 @@ export interface CanvasDb {
     /** A statement compiled per call; for generated SQL (IN lists, schema-dependent text). */
     prepareUncached(sql: string): CanvasStatement;
     exec(sql: string): Promise<void>;
+    /** True when the calling async context is inside a `withCanvasWrite` body (its own open transaction). */
+    readonly inTransaction: boolean;
     /** The SQLite connection, for the synchronous migration chain only. Deleted with the Postgres swap. */
     readonly raw: DatabaseSync;
 }
-/** The async handle over the same cached connection `openDb()` returns. */
-export declare function openCanvasDb(): Promise<CanvasDb>;
-/** Run `body` in one `BEGIN IMMEDIATE` transaction. A call from inside the
- *  body's own async context joins it and only the outermost call commits; a call
- *  from any other context waits its turn. A throwing body rolls back. */
-export declare function withCanvasWriteAsync<T>(body: (db: CanvasDb) => Promise<T> | T): Promise<T>;
+/** Open (or reuse) the canvas db handle for the current `CRTR_HOME`. */
+export declare function openDb(): Promise<CanvasDb>;
+/** Run `hook` once the calling context's outermost transaction has committed (and released the write lock); drop it if
+ *  the transaction or the savepoint holding it rolls back. Outside a transaction it runs in the next microtask. Use it for anything
+ *  that tells another context about a write, so that context never reads uncommitted rows or hears of a rolled-back one. */
+export declare function afterCommit(hook: () => void): void;
+export interface CanvasWriteOptions {
+    /** When nested, run the body in a SAVEPOINT so a throw undoes only its own writes and the outer transaction continues. */
+    savepoint?: boolean;
+    /** Always undo the body's writes, even when it returns (a dry run). Nested, it runs in a SAVEPOINT rolled back at the end. */
+    rollback?: boolean;
+}
+/** Run `body` in one `BEGIN IMMEDIATE` transaction, the only transaction entry point for canvas.db.
+ *  A call from inside the body's own async context joins it and only the outermost call commits; a call
+ *  from any other context waits its turn. A throwing body rolls back (with `savepoint`, a nested body
+ *  rolls back only its own writes). With `rollback` the body's writes are always undone. */
+export declare function withCanvasWrite<T>(body: (db: CanvasDb) => Promise<T> | T, options?: CanvasWriteOptions): Promise<T>;

package/dist/core/canvas/db.js

@@ -1,2 +1,3 @@
-var M=Object.defineProperty;var r=(e,t)=>M(e,"name",{value:t,configurable:!0});import{DatabaseSync as D}from"node:sqlite";import{AsyncLocalStorage as v}from"node:async_hooks";import{forgetPrepared as l,prepared as f}from"../sqlite-statements.js";import{appendFileSync as O}from"node:fs";import{canvasDbPath as w,ensureHome as k}from"./paths.js";import{initializeEmptyLayout as C}from"../layout.js";import{migrate as I}from"./migrations.js";import{MIGRATIONS as Q}from"./migrations.js";function H(e){try{I(e)}finally{l(e)}}r(H,"migrate");const c=new Map;let i;function $(e){const t=p();e(t),i=e}r($,"bindDaemonCanvasOpenHook");function q(){i=void 0}r(q,"clearDaemonCanvasOpenHook");function S(){const e=process.env.CRTR_DB_OPEN_LEDGER;if(e)try{const t=`${new Date().toISOString()} ${process.pid} ${process.argv[1]??"<unknown>"}
-`;O(e,t)}catch{}}r(S,"recordOpenLedger");function p(){const e=w(),t=c.get(e);if(t)return t;C(),k(),S();const n=new D(e);n.exec("PRAGMA busy_timeout = 5000;"),n.exec("PRAGMA journal_mode = WAL;"),n.exec("PRAGMA foreign_keys = ON;");try{i?.(n)}catch(o){throw n.close(),o}return c.set(e,n),n}r(p,"openDb");function K(e){const t=p();if(t.isTransaction)return e(t);t.exec("BEGIN IMMEDIATE");try{const n=e(t);return t.exec("COMMIT"),n}catch(n){try{t.exec("ROLLBACK")}catch{}throw n}}r(K,"withCanvasWrite");function j(){const e=w(),t=c.get(e);t&&(l(t),t.close(),c.delete(e))}r(j,"closeDb");const L=1e3,m=new v;class E{static{r(this,"FifoLock")}tail=Promise.resolve();pending=0;get busy(){return this.pending>0}async acquire(){this.pending++;const t=this.tail;let n;return this.tail=new Promise(o=>{n=o}),await t,()=>{this.pending--,n()}}}const y=new WeakMap,g=new WeakMap;function h(e){let t=y.get(e);return t||y.set(e,t=new E),t}r(h,"lockFor");function d(e){const t=m.getStore();return t!==void 0&&t.open&&t.db===e}r(d,"ownsTransaction");async function s(e,t){const n=h(e);if(d(e)||!n.busy)return t();const o=await n.acquire();try{return t()}finally{o()}}r(s,"gated");function x(e,t){const n=r(o=>o,"args");return{get:r((...o)=>s(e,()=>t().get(...n(o))),"get"),all:r((...o)=>s(e,()=>t().all(...n(o))),"all"),run:r((...o)=>s(e,()=>t().run(...n(o))),"run")}}r(x,"wrapStatement");function R(e){let t=g.get(e);return t||(t={prepare:r(n=>x(e,()=>f(e,n)),"prepare"),prepareUncached:r(n=>x(e,()=>e.prepare(n)),"prepareUncached"),exec:r(n=>s(e,()=>{e.exec(n)}),"exec"),raw:e},g.set(e,t)),t}r(R,"canvasDbFor");async function T(){return R(p())}r(T,"openCanvasDb");async function z(e){const t=await T(),n=t.raw;if(d(n))return e(t);const o=await h(n).acquire(),A=Date.now(),u={db:n,open:!0};try{n.exec("BEGIN IMMEDIATE");try{const a=await m.run(u,()=>e(t));return n.exec("COMMIT"),a}catch(a){try{n.exec("ROLLBACK")}catch{}throw a}}finally{u.open=!1;const a=Date.now()-A;a>L&&console.warn(`[canvas db] write transaction held ${a}ms; its body awaited non-db work while every other db caller waited`),o()}}r(z,"withCanvasWriteAsync");export{Q as MIGRATIONS,$ as bindDaemonCanvasOpenHook,q as clearDaemonCanvasOpenHook,j as closeDb,H as migrate,T as openCanvasDb,p as openDb,f as prepared,K as withCanvasWrite,z as withCanvasWriteAsync};
+var C=Object.defineProperty;var o=(e,t)=>C(e,"name",{value:t,configurable:!0});import{DatabaseSync as v}from"node:sqlite";import{AsyncLocalStorage as R}from"node:async_hooks";import{forgetPrepared as y,prepared as $}from"../sqlite-statements.js";import{appendFileSync as D}from"node:fs";import{canvasDbPath as k,ensureHome as T}from"./paths.js";import{initializeEmptyLayout as _}from"../layout.js";import{migrate as I}from"./migrations.js";import{MIGRATIONS as re}from"./migrations.js";function J(e){try{I(e)}finally{y(e)}}o(J,"migrate");const l=new Map;let m;function Q(e){const t=x();e(t),m=e}o(Q,"bindDaemonCanvasOpenHook");function X(){m=void 0}o(X,"clearDaemonCanvasOpenHook");function P(){const e=process.env.CRTR_DB_OPEN_LEDGER;if(e)try{const t=`${new Date().toISOString()} ${process.pid} ${process.argv[1]??"<unknown>"}
+`;D(e,t)}catch{}}o(P,"recordOpenLedger");function x(){const e=k(),t=l.get(e);if(t)return t;_(),T(),P();const n=new v(e);n.exec("PRAGMA busy_timeout = 5000;"),n.exec("PRAGMA journal_mode = WAL;"),n.exec("PRAGMA foreign_keys = ON;");try{m?.(n)}catch(r){throw n.close(),r}return l.set(e,n),n}o(x,"openConnection");function Y(){const e=k(),t=l.get(e);t&&(y(t),t.close(),l.delete(e))}o(Y,"closeDb");const b=1e3,i=new R;class B{static{o(this,"FifoLock")}tail=Promise.resolve();pending=0;get busy(){return this.pending>0}async acquire(){this.pending++;const t=this.tail;let n;return this.tail=new Promise(r=>{n=r}),await t,()=>{this.pending--,n()}}}const A=new WeakMap,M=new WeakMap;function S(e){let t=A.get(e);return t||A.set(e,t=new B),t}o(S,"lockFor");function w(e){const t=i.getStore();return t!==void 0&&t.open&&t.db===e}o(w,"ownsTransaction");async function p(e,t){const n=S(e);if(w(e)){const f=i.getStore(),u=performance.now();try{return t()}finally{f.statementMs+=performance.now()-u}}if(!n.busy)return t();const r=await n.acquire();try{return t()}finally{r()}}o(p,"gated");function E(e,t){const n=o(r=>r,"args");return{get:o((...r)=>p(e,()=>t().get(...n(r))),"get"),all:o((...r)=>p(e,()=>t().all(...n(r))),"all"),run:o((...r)=>p(e,()=>t().run(...n(r))),"run")}}o(E,"wrapStatement");function N(e){let t=M.get(e);return t||(t={prepare:o(n=>E(e,()=>$(e,n)),"prepare"),prepareUncached:o(n=>E(e,()=>e.prepare(n)),"prepareUncached"),exec:o(n=>p(e,()=>{e.exec(n)}),"exec"),get inTransaction(){return w(e)},raw:e},M.set(e,t)),t}o(N,"canvasDbFor");async function G(){return N(x())}o(G,"openDb");function Z(e){const t=i.getStore();if(t===void 0||!t.open){queueMicrotask(e);return}t.afterCommit.push(e)}o(Z,"afterCommit");let q=0;async function ee(e,t={}){const n=await G(),r=n.raw;if(w(r)){if(!t.savepoint&&!t.rollback)return e(n);const a=`canvas_write_${++q}`;r.exec(`SAVEPOINT ${a}`);const s=i.getStore()?.afterCommit,h=s?.length??0;let d;try{d=await e(n)}catch(O){throw r.exec(`ROLLBACK TO ${a}; RELEASE ${a}`),s?.splice(h),O}return r.exec(t.rollback?`ROLLBACK TO ${a}; RELEASE ${a}`:`RELEASE ${a}`),t.rollback&&s?.splice(h),d}const f=await S(r).acquire(),u=performance.now(),L=new Error("canvas write transaction entered here"),c={db:r,open:!0,afterCommit:[],statementMs:0};let g=!1;try{r.exec("BEGIN IMMEDIATE");try{const a=await i.run(c,()=>e(n));return r.exec(t.rollback?"ROLLBACK":"COMMIT"),g=!t.rollback,a}catch(a){try{r.exec("ROLLBACK")}catch{}throw a}}finally{c.open=!1;const a=performance.now()-u;if(a-c.statementMs>b&&console.warn(`[canvas db] write transaction held ${Math.round(a)}ms (${Math.round(c.statementMs)}ms in its statements); its body did non-db work while every other db caller waited
+${L.stack}`),f(),g)for(const s of c.afterCommit)queueMicrotask(s)}}o(ee,"withCanvasWrite");export{re as MIGRATIONS,Z as afterCommit,Q as bindDaemonCanvasOpenHook,X as clearDaemonCanvasOpenHook,Y as closeDb,J as migrate,G as openDb,ee as withCanvasWrite};

package/dist/core/canvas/deliveries.d.ts

@@ -60,12 +60,12 @@ export declare function deliveryFrom(row: StoredDelivery): DeliveryRecord;
 /** Claim one broker channel. A refreshing or stale broker receives hold and changes nothing.
  * Empty polls have no handoff to commit. If mail arrives after the plain read,
  * the next tick claims it, just as if it arrived after the write transaction. */
-export declare function claimNodeMail(nodeId: string, executionId: string, channel: 'wake' | 'passive' | 'deferred_run', now?: number): {
+export declare function claimNodeMail(nodeId: string, executionId: string, channel: 'wake' | 'passive' | 'deferred_run', now?: number): Promise<{
     action: 'claimed' | 'hold';
     deliveries: ClaimedNodeMail[];
-};
+}>;
 /** Pre-launch wake claim. It uses the same state transition but deliberately does not reject refresh intent. */
-export declare function claimKickoffMail(nodeId: string, executionId: string, now?: number): ClaimedNodeMail[];
+export declare function claimKickoffMail(nodeId: string, executionId: string, now?: number): Promise<ClaimedNodeMail[]>;
 export type DeliverySettlement = {
     state: 'acknowledged';
 } | {
@@ -80,12 +80,12 @@ export type DeliverySettlement = {
 };
 export declare function normalizedSettlement(settlement: DeliverySettlement | ProcessDeliverySettlement): DeliverySettlement;
 /** The one execution/attempt/owner fence for node mail and external actions. */
-export declare function settleDelivery(deliveryId: string, attempts: number, claimOwner: string, settlement: DeliverySettlement | ProcessDeliverySettlement, now?: number): boolean;
+export declare function settleDelivery(deliveryId: string, attempts: number, claimOwner: string, settlement: DeliverySettlement | ProcessDeliverySettlement, now?: number): Promise<boolean>;
 /** Deliberate operator retry of a delivery that failed for good: back to pending, due now,
  *  with a fresh attempt budget. The id and the claim fence are unchanged, and the last
  *  failure stays recorded until the next attempt replaces it. Returns false when the id
  *  is not a failed, uncanceled push delivery. */
-export declare function retryFailedDelivery(deliveryId: string, now?: number): boolean;
+export declare function retryFailedDelivery(deliveryId: string, now?: number): Promise<boolean>;
 /** Broker acknowledgement additionally checks that the execution is live before the per-row fence.
  *  Refresh intent does not refuse it: a yielding turn still acknowledges the mail
  *  its conversation consumed, and the watcher withholds the queued mail the
@@ -94,27 +94,27 @@ export declare function acknowledgeNodeMail(nodeId: string, executionId: string,
     deliveryId: string;
     attempts: number;
     disposition: 'acknowledged' | 'released';
-}>, now?: number): {
+}>, now?: number): Promise<{
     action: 'acknowledged' | 'hold';
     results: Array<{
         deliveryId: string;
         outcome: 'acknowledged' | 'released' | 'stale';
     }>;
-};
+}>;
 /** The immutable action document belonging to one external-action obligation. */
-export declare function messageBodyForDelivery(deliveryId: string): unknown | null;
-export declare function duePushDeliveries(now: number): DeliveryRecord[];
-export declare function claimPushDelivery(deliveryId: string, now: number, claimOwner: string): DeliveryRecord | null;
-export declare function resetHandedOffDeliveries(now: number): number;
+export declare function messageBodyForDelivery(deliveryId: string): Promise<unknown | null>;
+export declare function duePushDeliveries(now: number): Promise<DeliveryRecord[]>;
+export declare function claimPushDelivery(deliveryId: string, now: number, claimOwner: string): Promise<DeliveryRecord | null>;
+export declare function resetHandedOffDeliveries(now: number): Promise<number>;
 /** The lane checks the claim immediately before launching the action. An action
  * superseded after claim but before dispatch must not start with stale input. */
-export declare function pushDeliveryClaimIsCurrent(delivery: DeliveryRecord, owner: string): boolean;
+export declare function pushDeliveryClaimIsCurrent(delivery: DeliveryRecord, owner: string): Promise<boolean>;
 /** Reset mail held by an execution that is no longer this node's one live execution.
  * Push receiver deliveries have a due timestamp and are claimed by the daemon lane. */
-export declare function resetStaleExecutionMail(now: number): number;
-export declare function hasUnseenWakeMail(nodeId: string): boolean;
-export declare function hasWakeMailSince(nodeId: string, since: number): boolean;
-export declare function acknowledgedNodeMailCount(nodeId: string): number;
+export declare function resetStaleExecutionMail(now: number): Promise<number>;
+export declare function hasUnseenWakeMail(nodeId: string): Promise<boolean>;
+export declare function hasWakeMailSince(nodeId: string, since: number): Promise<boolean>;
+export declare function acknowledgedNodeMailCount(nodeId: string): Promise<number>;
 /** Create the messaging schema and import every legacy mailbox/action/wait row. The caller owns the encompassing migration transaction. */
 export declare function migrateMessagingState(db: DatabaseSync): void;
 export {};

package/dist/core/canvas/deliveries.js

@@ -1,51 +1,51 @@
-var C=Object.defineProperty;var l=(e,a)=>C(e,"name",{value:a,configurable:!0});import{prepared as s}from"../sqlite-statements.js";import{existsSync as R,readFileSync as y}from"node:fs";import{randomBytes as H}from"node:crypto";import{openDb as T,prepared as L,withCanvasWrite as N}from"./db.js";import{inboxPath as D,passivePath as k}from"./paths.js";import{withRetryBudget as X}from"./delivery-contract.js";import{emitEvent as F}from"../events/emit.js";function v(e){return{deliveryId:e.delivery_id,messageId:e.message_id,destinationId:e.destination_id,urgency:e.urgency,wake:e.wake===1?1:0,state:e.state,attempts:e.attempts,nextAttemptAt:e.next_attempt_at,claimedAt:e.claimed_at,claimOwner:e.claim_owner,acknowledgedAt:e.acknowledged_at,failedAt:e.failed_at,lastFailure:e.last_failure_json===null?null:JSON.parse(e.last_failure_json),idempotencyKey:e.idempotency_key,canceledAt:e.canceled_at,createdAt:e.created_at,updatedAt:e.updated_at}}l(v,"deliveryFrom");function S(e,a,o,d){return L(e,`SELECT 1 FROM nodes n JOIN executions e ON e.node_id = n.node_id
-      WHERE n.node_id = ? AND e.execution_id = ? AND e.state != 'exited'${d?" AND n.intent IS NOT 'refresh'":""}`).get(a,o)!==void 0}l(S,"executionIsLive");function I(e,a,o,d,r,m=!1){return L(e,`SELECT d.*, m.message_id AS m_message_id, m.seq, m.operation_id, m.created_at AS message_created_at,
+var x=Object.defineProperty;var _=(e,a)=>x(e,"name",{value:a,configurable:!0});import{prepared as m}from"../sqlite-statements.js";import{existsSync as O,readFileSync as D}from"node:fs";import{randomBytes as C}from"node:crypto";import{withCanvasWrite as T,openDb as N}from"./db.js";import{inboxPath as A,passivePath as v}from"./paths.js";import{withRetryBudget as H}from"./delivery-contract.js";import{emitEvent as X}from"../events/emit.js";import{mapAsync as F}from"../async-array.js";function I(e){return{deliveryId:e.delivery_id,messageId:e.message_id,destinationId:e.destination_id,urgency:e.urgency,wake:e.wake===1?1:0,state:e.state,attempts:e.attempts,nextAttemptAt:e.next_attempt_at,claimedAt:e.claimed_at,claimOwner:e.claim_owner,acknowledgedAt:e.acknowledged_at,failedAt:e.failed_at,lastFailure:e.last_failure_json===null?null:JSON.parse(e.last_failure_json),idempotencyKey:e.idempotency_key,canceledAt:e.canceled_at,createdAt:e.created_at,updatedAt:e.updated_at}}_(I,"deliveryFrom");async function L(e,a,r,d){return await e.prepare(`SELECT 1 FROM nodes n JOIN executions e ON e.node_id = n.node_id
+      WHERE n.node_id = ? AND e.execution_id = ? AND e.state != 'exited'${d?" AND n.intent IS NOT 'refresh'":""}`).get(a,r)!==void 0}_(L,"executionIsLive");async function w(e,a,r,d,s,E=!1){return(await e.prepare(`SELECT d.*, m.message_id AS m_message_id, m.seq, m.operation_id, m.created_at AS message_created_at,
             m.sender_node_id, m.sender_name, m.kind, m.label, m.body_ref, m.body_json, m.disposition,
             CASE WHEN d.state = 'handed_off' THEN 'inherited' ELSE 'fresh' END AS handoff
        FROM deliveries d JOIN messages m ON m.message_id = d.message_id
       WHERE d.destination_id = ? AND d.wake = ?
-        ${m?"AND m.kind = 'message' AND json_extract(m.body_json, '$.start_turn') = 0":d===0?"AND NOT (m.kind = 'message' AND coalesce(json_extract(m.body_json, '$.start_turn'), 1) = 0)":""}
+        ${E?"AND m.kind = 'message' AND json_extract(m.body_json, '$.start_turn') = 0":d===0?"AND NOT (m.kind = 'message' AND coalesce(json_extract(m.body_json, '$.start_turn'), 1) = 0)":""}
         AND d.canceled_at IS NULL
         AND (d.state = 'pending' OR (d.state = 'handed_off' AND d.claim_owner = ?))
-      ORDER BY m.seq`).all(a,d,o).map(i=>({...v(i),message:{messageId:i.m_message_id,seq:Number(i.seq),operationId:i.operation_id,createdAt:i.message_created_at,senderNodeId:i.sender_node_id,senderName:i.sender_name,kind:i.kind,label:i.label,bodyRef:i.body_ref,bodyJson:i.body_json===null?null:JSON.parse(i.body_json),disposition:i.disposition},handoff:r?.has(i.delivery_id)===!0?"fresh":i.handoff}))}l(I,"nodeMailRows");const w=`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+      ORDER BY m.seq`).all(a,d,r)).map(i=>({...I(i),message:{messageId:i.m_message_id,seq:Number(i.seq),operationId:i.operation_id,createdAt:i.message_created_at,senderNodeId:i.sender_node_id,senderName:i.sender_name,kind:i.kind,label:i.label,bodyRef:i.body_ref,bodyJson:i.body_json===null?null:JSON.parse(i.body_json),disposition:i.disposition},handoff:s?.has(i.delivery_id)===!0?"fresh":i.handoff}))}_(w,"nodeMailRows");const R=`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
   WHERE d.destination_id = ? AND d.wake = ? AND d.state = 'pending' AND d.canceled_at IS NULL
     AND NOT (d.wake = 0 AND m.kind = 'message' AND coalesce(json_extract(m.body_json, '$.start_turn'), 1) = 0)`,j=`UPDATE deliveries SET state = 'handed_off', attempts = attempts + 1, claim_owner = ?, claimed_at = ?, updated_at = ?
-  WHERE delivery_id IN (${w})`;function Q(e,a,o,d=Date.now()){const r=o==="wake"?1:0;if(o==="deferred_run")return N(E=>{if(!S(E,e,a,!0))return{action:"hold",deliveries:[]};const i=s(E,`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+  WHERE delivery_id IN (${R})`;async function V(e,a,r,d=Date.now()){const s=r==="wake"?1:0;if(r==="deferred_run")return await T(async c=>{if(!await L(c,e,a,!0))return{action:"hold",deliveries:[]};const i=await c.prepare(`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
         WHERE d.destination_id = ? AND d.wake = 0 AND d.canceled_at IS NULL
           AND m.kind = 'message' AND json_extract(m.body_json, '$.start_turn') = 0
-          AND (d.state = 'pending' OR (d.state = 'handed_off' AND d.claim_owner = ?))`).all(e,a),t=new Set(s(E,`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+          AND (d.state = 'pending' OR (d.state = 'handed_off' AND d.claim_owner = ?))`).all(e,a),t=new Set((await c.prepare(`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
         WHERE d.destination_id = ? AND d.wake = 0 AND d.state = 'pending' AND d.canceled_at IS NULL
-          AND m.kind = 'message' AND json_extract(m.body_json, '$.start_turn') = 0`).all(e).map(n=>n.delivery_id));return i.length&&s(E,`UPDATE deliveries SET state = 'handed_off', attempts = attempts + 1, claim_owner = ?, claimed_at = ?, updated_at = ?
-        WHERE delivery_id IN (${i.map(()=>"?").join(",")}) AND state = 'pending'`).run(a,d,d,...i.map(n=>n.delivery_id)),{action:"claimed",deliveries:I(E,e,a,0,t,!0)}});const m=T();return!m.isTransaction&&L(m,w).get(e,r)===void 0?S(m,e,a,!0)?{action:"claimed",deliveries:I(m,e,a,r)}:{action:"hold",deliveries:[]}:N(E=>{if(!S(E,e,a,!0))return{action:"hold",deliveries:[]};const i=new Set(L(E,w).all(e,r).map(t=>t.delivery_id));return L(E,j).run(a,d,d,e,r),{action:"claimed",deliveries:I(E,e,a,r,i)}})}l(Q,"claimNodeMail");function V(e,a,o=Date.now()){return N(d=>{if(!S(d,e,a,!1))throw new Error(`execution ${a} is not live for node ${e}`);const r=new Set(s(d,`SELECT delivery_id FROM deliveries
-        WHERE destination_id = ? AND wake = 1 AND state = 'pending' AND canceled_at IS NULL`).all(e).map(m=>m.delivery_id));return s(d,`UPDATE deliveries SET state = 'handed_off', attempts = attempts + 1, claim_owner = ?, claimed_at = ?, updated_at = ?
-        WHERE destination_id = ? AND wake = 1 AND state = 'pending' AND canceled_at IS NULL`).run(a,o,o,e),I(d,e,a,1,r)})}l(V,"claimKickoffMail");function M(e){return e.state==="accepted"?{state:"acknowledged"}:e}l(M,"normalizedSettlement");function W(e,a,o,d,r=Date.now()){const m=[],E=N(i=>{const n=s(i,"SELECT canceled_at FROM deliveries WHERE delivery_id = ? AND next_attempt_at IS NOT NULL").get(e)?.canceled_at!=null?{state:"acknowledged"}:M(d),_=X(n,a),c=_.settlement,A=c.state==="pending"||c.state==="permanent_failed"?JSON.stringify(c.failure):null,g=c.state==="released"?"pending":c.state,u=c.state==="pending"?c.nextAttemptAt:g==="pending"?r:null,p=Number(s(i,`UPDATE deliveries
+          AND m.kind = 'message' AND json_extract(m.body_json, '$.start_turn') = 0`).all(e)).map(n=>n.delivery_id));return i.length&&await c.prepare(`UPDATE deliveries SET state = 'handed_off', attempts = attempts + 1, claim_owner = ?, claimed_at = ?, updated_at = ?
+        WHERE delivery_id IN (${i.map(()=>"?").join(",")}) AND state = 'pending'`).run(a,d,d,...i.map(n=>n.delivery_id)),{action:"claimed",deliveries:await w(c,e,a,0,t,!0)}});const E=await N();return!E.inTransaction&&await E.prepare(R).get(e,s)===void 0?await L(E,e,a,!0)?{action:"claimed",deliveries:await w(E,e,a,s)}:{action:"hold",deliveries:[]}:await T(async c=>{if(!await L(c,e,a,!0))return{action:"hold",deliveries:[]};const i=new Set((await c.prepare(R).all(e,s)).map(t=>t.delivery_id));return await c.prepare(j).run(a,d,d,e,s),{action:"claimed",deliveries:await w(c,e,a,s,i)}})}_(V,"claimNodeMail");async function z(e,a,r=Date.now()){return await T(async d=>{if(!await L(d,e,a,!1))throw new Error(`execution ${a} is not live for node ${e}`);const s=new Set((await d.prepare(`SELECT delivery_id FROM deliveries
+        WHERE destination_id = ? AND wake = 1 AND state = 'pending' AND canceled_at IS NULL`).all(e)).map(E=>E.delivery_id));return await d.prepare(`UPDATE deliveries SET state = 'handed_off', attempts = attempts + 1, claim_owner = ?, claimed_at = ?, updated_at = ?
+        WHERE destination_id = ? AND wake = 1 AND state = 'pending' AND canceled_at IS NULL`).run(a,r,r,e),await w(d,e,a,1,s)})}_(z,"claimKickoffMail");function M(e){return e.state==="accepted"?{state:"acknowledged"}:e}_(M,"normalizedSettlement");async function W(e,a,r,d,s=Date.now()){const E=[],c=await T(async i=>{const n=(await i.prepare("SELECT canceled_at FROM deliveries WHERE delivery_id = ? AND next_attempt_at IS NOT NULL").get(e))?.canceled_at!=null?{state:"acknowledged"}:M(d),o=H(n,a),l=o.settlement,S=l.state==="pending"||l.state==="permanent_failed"?JSON.stringify(l.failure):null,g=l.state==="released"?"pending":l.state,p=l.state==="pending"?l.nextAttemptAt:g==="pending"?s:null,f=Number((await i.prepare(`UPDATE deliveries
           SET state = ?, next_attempt_at = ?, claimed_at = NULL, claim_owner = NULL,
               acknowledged_at = ?, failed_at = ?, last_failure_json = ?, updated_at = ?
-        WHERE delivery_id = ? AND state = 'handed_off' AND attempts = ? AND claim_owner = ?`).run(g,u,g==="acknowledged"?r:null,g==="permanent_failed"?r:null,A,r,e,a,o).changes)===1;if(p&&_.exhausted&&c.state==="permanent_failed"){const O=s(i,"SELECT destination_id, message_id FROM deliveries WHERE delivery_id = ?").get(e);m.push({failure:c.failure,destinationId:O.destination_id,messageId:O.message_id})}return p});for(const i of m)F({level:"error",event:"delivery.exhausted",outcome:"failed",attempt:a,fields:{delivery_id:e,destination_id:i.destinationId,message_id:i.messageId,failure:i.failure,retry:`crtr sys retry-delivery ${e}`}});return E}l(W,"settleDelivery");function z(e,a=Date.now()){return N(o=>Number(s(o,`UPDATE deliveries
+        WHERE delivery_id = ? AND state = 'handed_off' AND attempts = ? AND claim_owner = ?`).run(g,p,g==="acknowledged"?s:null,g==="permanent_failed"?s:null,S,s,e,a,r)).changes)===1;if(f&&o.exhausted&&l.state==="permanent_failed"){const y=await i.prepare("SELECT destination_id, message_id FROM deliveries WHERE delivery_id = ?").get(e);E.push({failure:l.failure,destinationId:y.destination_id,messageId:y.message_id})}return f});for(const i of E)X({level:"error",event:"delivery.exhausted",outcome:"failed",attempt:a,fields:{delivery_id:e,destination_id:i.destinationId,message_id:i.messageId,failure:i.failure,retry:`crtr sys retry-delivery ${e}`}});return c}_(W,"settleDelivery");async function Z(e,a=Date.now()){return Number((await(await N()).prepare(`UPDATE deliveries
         SET state = 'pending', attempts = 0, next_attempt_at = ?, failed_at = NULL, updated_at = ?
-      WHERE delivery_id = ? AND state = 'permanent_failed' AND canceled_at IS NULL AND last_failure_json IS NOT NULL`).run(a,a,e).changes)===1)}l(z,"retryFailedDelivery");function Z(e,a,o,d=Date.now()){return N(r=>S(r,e,a,!1)?{action:"acknowledged",results:o.map(E=>{const i=s(r,"SELECT 1 FROM deliveries WHERE delivery_id = ? AND destination_id = ?").get(E.deliveryId,e)!==void 0;return{deliveryId:E.deliveryId,outcome:i&&W(E.deliveryId,E.attempts,a,{state:E.disposition},d)?E.disposition:"stale"}})}:{action:"hold",results:[]})}l(Z,"acknowledgeNodeMail");function ee(e){const a=s(T(),`SELECT m.body_json FROM deliveries d JOIN messages m ON m.message_id = d.message_id
-      WHERE d.delivery_id = ?`).get(e);return a===void 0||a.body_json===null?null:JSON.parse(a.body_json)}l(ee,"messageBodyForDelivery");function te(e){return s(T(),`SELECT * FROM deliveries
+      WHERE delivery_id = ? AND state = 'permanent_failed' AND canceled_at IS NULL AND last_failure_json IS NOT NULL`).run(a,a,e)).changes)===1}_(Z,"retryFailedDelivery");async function ee(e,a,r,d=Date.now()){return await T(async s=>await L(s,e,a,!1)?{action:"acknowledged",results:await F(r,async c=>{const i=await s.prepare("SELECT 1 FROM deliveries WHERE delivery_id = ? AND destination_id = ?").get(c.deliveryId,e)!==void 0;return{deliveryId:c.deliveryId,outcome:i&&await W(c.deliveryId,c.attempts,a,{state:c.disposition},d)?c.disposition:"stale"}})}:{action:"hold",results:[]})}_(ee,"acknowledgeNodeMail");async function te(e){const a=await(await N()).prepare(`SELECT m.body_json FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+      WHERE d.delivery_id = ?`).get(e);return a===void 0||a.body_json===null?null:JSON.parse(a.body_json)}_(te,"messageBodyForDelivery");async function ae(e){return(await(await N()).prepare(`SELECT * FROM deliveries
       WHERE state = 'pending' AND canceled_at IS NULL AND next_attempt_at <= ?
-      ORDER BY next_attempt_at, created_at, delivery_id`).all(e).map(v)}l(te,"duePushDeliveries");function ae(e,a,o){return N(d=>{const r=s(d,`UPDATE deliveries AS d SET state = 'handed_off', attempts = attempts + 1, claimed_at = ?, claim_owner = ?, updated_at = ?
+      ORDER BY next_attempt_at, created_at, delivery_id`).all(e)).map(I)}_(ae,"duePushDeliveries");async function ne(e,a,r){return await T(async d=>{const s=await d.prepare(`UPDATE deliveries AS d SET state = 'handed_off', attempts = attempts + 1, claimed_at = ?, claim_owner = ?, updated_at = ?
         WHERE d.delivery_id = ? AND d.state = 'pending' AND d.canceled_at IS NULL AND d.next_attempt_at <= ?
           AND NOT EXISTS (SELECT 1 FROM deliveries old JOIN messages prior ON prior.message_id = old.message_id
             JOIN messages next ON next.message_id = d.message_id
             WHERE old.destination_id = d.destination_id AND old.delivery_id != d.delivery_id
               AND old.state = 'handed_off' AND old.canceled_at IS NOT NULL
-              AND prior.event = 'outcome' AND next.event = 'outcome' AND prior.object_id = next.object_id)`).run(a,o,a,e,a);return Number(r.changes)===0?null:v(s(d,"SELECT * FROM deliveries WHERE delivery_id = ?").get(e))})}l(ae,"claimPushDelivery");function ne(e){return N(a=>{const o=s(a,`UPDATE deliveries SET state = 'permanent_failed', next_attempt_at = NULL,
+              AND prior.event = 'outcome' AND next.event = 'outcome' AND prior.object_id = next.object_id)`).run(a,r,a,e,a);return Number(s.changes)===0?null:I(await d.prepare("SELECT * FROM deliveries WHERE delivery_id = ?").get(e))})}_(ne,"claimPushDelivery");async function ie(e){return await T(async a=>{const r=await a.prepare(`UPDATE deliveries SET state = 'permanent_failed', next_attempt_at = NULL,
       claimed_at = NULL, claim_owner = NULL, failed_at = ?, updated_at = ?
-      WHERE state = 'handed_off' AND canceled_at IS NOT NULL AND next_attempt_at IS NOT NULL`).run(e,e),d=s(a,`UPDATE deliveries SET state = 'pending', next_attempt_at = CASE WHEN next_attempt_at IS NOT NULL THEN ? ELSE NULL END,
+      WHERE state = 'handed_off' AND canceled_at IS NOT NULL AND next_attempt_at IS NOT NULL`).run(e,e),d=await a.prepare(`UPDATE deliveries SET state = 'pending', next_attempt_at = CASE WHEN next_attempt_at IS NOT NULL THEN ? ELSE NULL END,
          claimed_at = NULL, claim_owner = NULL, updated_at = ?
-         WHERE state = 'handed_off' AND (canceled_at IS NULL OR next_attempt_at IS NULL)`).run(e,e);return Number(o.changes)+Number(d.changes)})}l(ne,"resetHandedOffDeliveries");function ie(e,a){return s(T(),`SELECT 1 FROM deliveries WHERE delivery_id = ? AND state = 'handed_off'
-    AND attempts = ? AND claim_owner = ? AND canceled_at IS NULL`).get(e.deliveryId,e.attempts,a)!==void 0}l(ie,"pushDeliveryClaimIsCurrent");function de(e){return N(a=>Number(s(a,`UPDATE deliveries AS d SET state = 'pending', claimed_at = NULL, claim_owner = NULL, updated_at = ?
+         WHERE state = 'handed_off' AND (canceled_at IS NULL OR next_attempt_at IS NULL)`).run(e,e);return Number(r.changes)+Number(d.changes)})}_(ie,"resetHandedOffDeliveries");async function de(e,a){return await(await N()).prepare(`SELECT 1 FROM deliveries WHERE delivery_id = ? AND state = 'handed_off'
+    AND attempts = ? AND claim_owner = ? AND canceled_at IS NULL`).get(e.deliveryId,e.attempts,a)!==void 0}_(de,"pushDeliveryClaimIsCurrent");async function se(e){return Number((await(await N()).prepare(`UPDATE deliveries AS d SET state = 'pending', claimed_at = NULL, claim_owner = NULL, updated_at = ?
       WHERE d.state = 'handed_off' AND d.next_attempt_at IS NULL
         AND NOT EXISTS (
           SELECT 1 FROM executions e WHERE e.node_id = d.destination_id AND e.execution_id = d.claim_owner AND e.state != 'exited'
-        )`).run(e).changes))}l(de,"resetStaleExecutionMail");function se(e){return s(T(),`SELECT 1 FROM deliveries WHERE destination_id = ? AND wake = 1
-       AND canceled_at IS NULL AND urgency != 'deferred' AND state IN ('pending', 'handed_off') LIMIT 1`).get(e)!==void 0}l(se,"hasUnseenWakeMail");function re(e,a){return s(T(),`SELECT 1 FROM deliveries WHERE destination_id = ? AND wake = 1
-       AND urgency != 'deferred' AND created_at >= ? LIMIT 1`).get(e,a)!==void 0}l(re,"hasWakeMailSince");function oe(e){return Number(s(T(),"SELECT COUNT(*) AS count FROM deliveries WHERE destination_id = ? AND acknowledged_at IS NOT NULL").get(e).count)}l(oe,"acknowledgedNodeMailCount");function f(){let e;do e=H(16).toString("hex");while(e==="00000000000000000000000000000000");return e}l(f,"newId");function U(e){if(!R(e))return[];const a=y(e,"utf8");return a.trim()===""?[]:a.split(`
-`).filter(o=>o.trim()!=="").map((o,d)=>{let r;try{r=JSON.parse(o)}catch(m){throw new Error(`invalid mailbox JSON at ${e}:${d+1}: ${m.message}`)}if(!/^(?!0{32}$)[0-9a-f]{32}$/.test(r.entry_id)||!/^(?!0{32}$)[0-9a-f]{32}$/.test(r.operation_id))throw new Error(`invalid mailbox identity at ${e}:${d+1}`);if(typeof r.ts!="string"||typeof r.label!="string")throw new Error(`incomplete mailbox entry at ${e}:${d+1}`);return r})}l(U,"readJsonLines");function $(e){return R(e)?new Set(y(e,"utf8").split(`
-`).map(a=>a.trim()).filter(Boolean)):new Set}l($,"readCanceled");function _e(e){e.exec(`
+        )`).run(e)).changes)}_(se,"resetStaleExecutionMail");async function re(e){return await(await N()).prepare(`SELECT 1 FROM deliveries WHERE destination_id = ? AND wake = 1
+       AND canceled_at IS NULL AND urgency != 'deferred' AND state IN ('pending', 'handed_off') LIMIT 1`).get(e)!==void 0}_(re,"hasUnseenWakeMail");async function oe(e,a){return await(await N()).prepare(`SELECT 1 FROM deliveries WHERE destination_id = ? AND wake = 1
+       AND urgency != 'deferred' AND created_at >= ? LIMIT 1`).get(e,a)!==void 0}_(oe,"hasWakeMailSince");async function _e(e){return Number((await(await N()).prepare("SELECT COUNT(*) AS count FROM deliveries WHERE destination_id = ? AND acknowledged_at IS NOT NULL").get(e)).count)}_(_e,"acknowledgedNodeMailCount");function u(){let e;do e=C(16).toString("hex");while(e==="00000000000000000000000000000000");return e}_(u,"newId");function k(e){if(!O(e))return[];const a=D(e,"utf8");return a.trim()===""?[]:a.split(`
+`).filter(r=>r.trim()!=="").map((r,d)=>{let s;try{s=JSON.parse(r)}catch(E){throw new Error(`invalid mailbox JSON at ${e}:${d+1}: ${E.message}`)}if(!/^(?!0{32}$)[0-9a-f]{32}$/.test(s.entry_id)||!/^(?!0{32}$)[0-9a-f]{32}$/.test(s.operation_id))throw new Error(`invalid mailbox identity at ${e}:${d+1}`);if(typeof s.ts!="string"||typeof s.label!="string")throw new Error(`incomplete mailbox entry at ${e}:${d+1}`);return s})}_(k,"readJsonLines");function $(e){return O(e)?new Set(D(e,"utf8").split(`
+`).map(a=>a.trim()).filter(Boolean)):new Set}_($,"readCanceled");function le(e){e.exec(`
 CREATE TABLE IF NOT EXISTS messages (
   message_id TEXT PRIMARY KEY,
   seq INTEGER NOT NULL UNIQUE,
@@ -99,4 +99,4 @@ CREATE TABLE IF NOT EXISTS waits (
 );
 CREATE UNIQUE INDEX IF NOT EXISTS waits_live ON waits(node_id) WHERE satisfied_at IS NULL;
 CREATE INDEX IF NOT EXISTS waits_node ON waits(node_id);
-`);const a=[];for(const t of s(e,"SELECT node_id FROM nodes").all()){const n=t.node_id,_=U(D(n)),c=R(`${D(n)}.cursor`)?y(`${D(n)}.cursor`,"utf8").trim():"",A=_.findIndex(u=>u.entry_id===c),g=$(`${D(n)}.canceled`);_.forEach((u,p)=>a.push({nodeId:n,wake:1,source:"inbox",fileRank:0,physicalIndex:p,entry:u,acknowledged:A>=0&&p<=A,canceled:g.has(u.entry_id),seq:0}));for(const[u,p]of[[0,`${k(n)}.draining`],[1,k(n)]])U(p).forEach((O,x)=>a.push({nodeId:n,wake:0,source:"passive",fileRank:u,physicalIndex:x,entry:O,acknowledged:!1,canceled:!1,seq:0}))}a.sort((t,n)=>t.entry.ts.localeCompare(n.entry.ts)||t.nodeId.localeCompare(n.nodeId)||t.fileRank-n.fileRank||t.physicalIndex-n.physicalIndex),a.forEach((t,n)=>{t.seq=n+1});const o=new Map;for(const t of a){const n=`${t.nodeId}\0${t.source}`,_=o.get(n)??[];_.push(t),o.set(n,_)}for(const t of o.values()){const n=t.map(_=>_.seq).sort((_,c)=>_-c);t.sort((_,c)=>_.fileRank-c.fileRank||_.physicalIndex-c.physicalIndex).forEach((_,c)=>{_.seq=n[c]})}const d=s(e,"INSERT INTO messages (message_id, seq, operation_id, created_at, sender_node_id, sender_name, kind, label, body_ref, body_json, disposition) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"),r=s(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, acknowledged_at, canceled_at, created_at, updated_at) VALUES (?, ?, 'node_inbox', ?, ?, ?, ?, 0, ?, ?, ?, ?)");for(const t of a){const n=t.entry;d.run(n.entry_id,t.seq,n.operation_id,n.ts,n.from,n.from_name??null,n.kind,n.label,n.ref??null,n.data===void 0?null:JSON.stringify(n.data),n.disposition??null);const _=Date.parse(n.ts),c=Number.isFinite(_)?_:0;r.run(f(),n.entry_id,t.nodeId,n.tier,t.wake,t.acknowledged?"acknowledged":"pending",t.acknowledged?c:null,t.canceled?c:null,c,c)}const m=s(e,"SELECT * FROM human_action_deliveries").all();for(const t of m){const n=f();d.run(n,h(e),f(),new Date(t.created_at).toISOString(),null,null,"completed",t.request_id,null,t.completion_json,null);const _=t.state==="running"?"handed_off":t.state==="accepted"?"acknowledged":t.state;s(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, next_attempt_at, claimed_at, claim_owner, acknowledged_at, failed_at, last_failure_json, adapter_json, idempotency_key, created_at, updated_at) VALUES (?, ?, 'external_action', 'human_action', 'normal', 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(f(),n,_,t.attempt,t.next_attempt_at,t.claimed_at,t.claim_owner,t.accepted_at,t.permanent_failed_at,t.last_failure_json,JSON.stringify({adapter:"subprocess",argv:JSON.parse(t.argv_json),cwd:t.cwd}),`human-action:${t.request_id}`,t.created_at,t.updated_at)}const E=s(e,"SELECT * FROM node_outcome_deliveries").all();for(const t of E){const n=t.document_json===null?null:f();n!==null&&d.run(n,h(e),f(),new Date(t.created_at).toISOString(),null,null,"completed",t.node_id,null,t.document_json,null);const _=t.document_json===null?"armed":t.state==="running"?"handed_off":t.state==="accepted"?"acknowledged":t.state;s(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, next_attempt_at, claimed_at, claim_owner, acknowledged_at, failed_at, last_failure_json, adapter_json, idempotency_key, created_at, updated_at) VALUES (?, ?, 'external_action', ?, 'normal', 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(f(),n,t.action_name,_,t.attempt,t.next_attempt_at,t.claimed_at,t.claim_owner,t.accepted_at,t.permanent_failed_at,t.last_failure_json,JSON.stringify({adapter:"subprocess",argv:JSON.parse(t.argv_json),cwd:t.cwd,config_origin:t.config_origin,payload:t.payload_json===null?null:JSON.parse(t.payload_json)}),`node-outcome:${t.node_id}`,t.created_at,t.updated_at)}const i=s(e,"SELECT node_id, waiting_for, waiting_for_generation FROM nodes WHERE waiting_for IS NOT NULL").all();for(const t of i)s(e,"INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at) VALUES (?, ?, 'controller', ?, ?, ?, NULL)").run(f(),t.node_id,t.waiting_for,t.waiting_for_generation,Date.now())}l(_e,"migrateMessagingState");function h(e){return Number(s(e,"SELECT COALESCE(MAX(seq), 0) AS seq FROM messages").get().seq)+1}l(h,"nextSeq");export{Z as acknowledgeNodeMail,oe as acknowledgedNodeMailCount,V as claimKickoffMail,Q as claimNodeMail,ae as claimPushDelivery,v as deliveryFrom,te as duePushDeliveries,se as hasUnseenWakeMail,re as hasWakeMailSince,ee as messageBodyForDelivery,_e as migrateMessagingState,M as normalizedSettlement,ie as pushDeliveryClaimIsCurrent,ne as resetHandedOffDeliveries,de as resetStaleExecutionMail,z as retryFailedDelivery,W as settleDelivery};
+`);const a=[];for(const t of m(e,"SELECT node_id FROM nodes").all()){const n=t.node_id,o=k(A(n)),l=O(`${A(n)}.cursor`)?D(`${A(n)}.cursor`,"utf8").trim():"",S=o.findIndex(p=>p.entry_id===l),g=$(`${A(n)}.canceled`);o.forEach((p,f)=>a.push({nodeId:n,wake:1,source:"inbox",fileRank:0,physicalIndex:f,entry:p,acknowledged:S>=0&&f<=S,canceled:g.has(p.entry_id),seq:0}));for(const[p,f]of[[0,`${v(n)}.draining`],[1,v(n)]])k(f).forEach((y,h)=>a.push({nodeId:n,wake:0,source:"passive",fileRank:p,physicalIndex:h,entry:y,acknowledged:!1,canceled:!1,seq:0}))}a.sort((t,n)=>t.entry.ts.localeCompare(n.entry.ts)||t.nodeId.localeCompare(n.nodeId)||t.fileRank-n.fileRank||t.physicalIndex-n.physicalIndex),a.forEach((t,n)=>{t.seq=n+1});const r=new Map;for(const t of a){const n=`${t.nodeId}\0${t.source}`,o=r.get(n)??[];o.push(t),r.set(n,o)}for(const t of r.values()){const n=t.map(o=>o.seq).sort((o,l)=>o-l);t.sort((o,l)=>o.fileRank-l.fileRank||o.physicalIndex-l.physicalIndex).forEach((o,l)=>{o.seq=n[l]})}const d=m(e,"INSERT INTO messages (message_id, seq, operation_id, created_at, sender_node_id, sender_name, kind, label, body_ref, body_json, disposition) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"),s=m(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, acknowledged_at, canceled_at, created_at, updated_at) VALUES (?, ?, 'node_inbox', ?, ?, ?, ?, 0, ?, ?, ?, ?)");for(const t of a){const n=t.entry;d.run(n.entry_id,t.seq,n.operation_id,n.ts,n.from,n.from_name??null,n.kind,n.label,n.ref??null,n.data===void 0?null:JSON.stringify(n.data),n.disposition??null);const o=Date.parse(n.ts),l=Number.isFinite(o)?o:0;s.run(u(),n.entry_id,t.nodeId,n.tier,t.wake,t.acknowledged?"acknowledged":"pending",t.acknowledged?l:null,t.canceled?l:null,l,l)}const E=m(e,"SELECT * FROM human_action_deliveries").all();for(const t of E){const n=u();d.run(n,U(e),u(),new Date(t.created_at).toISOString(),null,null,"completed",t.request_id,null,t.completion_json,null);const o=t.state==="running"?"handed_off":t.state==="accepted"?"acknowledged":t.state;m(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, next_attempt_at, claimed_at, claim_owner, acknowledged_at, failed_at, last_failure_json, adapter_json, idempotency_key, created_at, updated_at) VALUES (?, ?, 'external_action', 'human_action', 'normal', 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(u(),n,o,t.attempt,t.next_attempt_at,t.claimed_at,t.claim_owner,t.accepted_at,t.permanent_failed_at,t.last_failure_json,JSON.stringify({adapter:"subprocess",argv:JSON.parse(t.argv_json),cwd:t.cwd}),`human-action:${t.request_id}`,t.created_at,t.updated_at)}const c=m(e,"SELECT * FROM node_outcome_deliveries").all();for(const t of c){const n=t.document_json===null?null:u();n!==null&&d.run(n,U(e),u(),new Date(t.created_at).toISOString(),null,null,"completed",t.node_id,null,t.document_json,null);const o=t.document_json===null?"armed":t.state==="running"?"handed_off":t.state==="accepted"?"acknowledged":t.state;m(e,"INSERT INTO deliveries (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, attempts, next_attempt_at, claimed_at, claim_owner, acknowledged_at, failed_at, last_failure_json, adapter_json, idempotency_key, created_at, updated_at) VALUES (?, ?, 'external_action', ?, 'normal', 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(u(),n,t.action_name,o,t.attempt,t.next_attempt_at,t.claimed_at,t.claim_owner,t.accepted_at,t.permanent_failed_at,t.last_failure_json,JSON.stringify({adapter:"subprocess",argv:JSON.parse(t.argv_json),cwd:t.cwd,config_origin:t.config_origin,payload:t.payload_json===null?null:JSON.parse(t.payload_json)}),`node-outcome:${t.node_id}`,t.created_at,t.updated_at)}const i=m(e,"SELECT node_id, waiting_for, waiting_for_generation FROM nodes WHERE waiting_for IS NOT NULL").all();for(const t of i)m(e,"INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at) VALUES (?, ?, 'controller', ?, ?, ?, NULL)").run(u(),t.node_id,t.waiting_for,t.waiting_for_generation,Date.now())}_(le,"migrateMessagingState");function U(e){return Number(m(e,"SELECT COALESCE(MAX(seq), 0) AS seq FROM messages").get().seq)+1}_(U,"nextSeq");export{ee as acknowledgeNodeMail,_e as acknowledgedNodeMailCount,z as claimKickoffMail,V as claimNodeMail,ne as claimPushDelivery,I as deliveryFrom,ae as duePushDeliveries,re as hasUnseenWakeMail,oe as hasWakeMailSince,te as messageBodyForDelivery,le as migrateMessagingState,M as normalizedSettlement,de as pushDeliveryClaimIsCurrent,ie as resetHandedOffDeliveries,se as resetStaleExecutionMail,Z as retryFailedDelivery,W as settleDelivery};

package/dist/core/canvas/executions.d.ts

@@ -9,21 +9,21 @@ export interface Execution {
     endedAt: string | null;
     exitReason: string | null;
 }
-export declare function liveExecutionForNode(nodeId: string): Execution | null;
+export declare function liveExecutionForNode(nodeId: string): Promise<Execution | null>;
 export declare function beginExecution(nodeId: string, input: {
     daemonEpoch: string | null;
-}): string;
+}): Promise<string>;
 /** Returns shutdown when a late broker references an execution no longer live. */
-export declare function recordExecutionPid(executionId: string, nodeId: string, pid: number): 'recorded' | 'shutdown';
+export declare function recordExecutionPid(executionId: string, nodeId: string, pid: number): Promise<'recorded' | 'shutdown'>;
 export declare function endExecution(executionId: string, input: {
     reason: string;
-}): boolean;
+}): Promise<boolean>;
 export declare function abortExecution(executionId: string, input: {
     reason: string;
-}): boolean;
+}): Promise<boolean>;
 export declare function endLiveExecution(nodeId: string, input: {
     reason: string;
-}): boolean;
-export declare function migrateLegacyExecutionIdentities(captureIdentity?: (pid: number) => string | undefined): {
+}): Promise<boolean>;
+export declare function migrateLegacyExecutionIdentities(captureIdentity?: (pid: number) => string | undefined): Promise<{
     migrated: string[];
-};
+}>;

package/dist/core/canvas/executions.js

@@ -1 +1 @@
-var g=Object.defineProperty;var r=(e,t)=>g(e,"name",{value:t,configurable:!0});import{prepared as c}from"../sqlite-statements.js";import{randomUUID as h}from"node:crypto";import{openDb as f,prepared as A,withCanvasWrite as p}from"./db.js";import{capturePidIdentities as l,captureLivenessSnapshot as T,identitiesMatch as D,isBootScopedIdentity as L,isLegacyTicksIdentity as S}from"./pid.js";import{existsSync as y,readFileSync as U}from"node:fs";import{LAUNCHER_SOCKET as R}from"../../launcher/spec.js";import{forgetNodeToken as H,mintNodeToken as O,revokeNodeTokens as x}from"./node-tokens.js";function E(){return new Date().toISOString()}r(E,"now");function W(e){return{executionId:e.execution_id,nodeId:e.node_id,daemonEpoch:e.daemon_epoch??null,pid:e.pid??null,processIdentity:e.process_identity??null,state:e.state,startedAt:e.started_at,endedAt:e.ended_at??null,exitReason:e.exit_reason??null}}r(W,"hydrate");function B(e){const t=A(f(),"SELECT * FROM executions WHERE node_id = ? AND state != 'exited'").get(e);return t===void 0?null:W(t)}r(B,"liveExecutionForNode");function K(e,t){return p(n=>{const i=E();c(n,"UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = 'superseded' WHERE node_id = ? AND state != 'exited'").run(i,e),x(n,"node_id",e,i);const o=h();return c(n,"INSERT INTO executions (execution_id, node_id, daemon_epoch, pid, process_identity, state, started_at, ended_at, exit_reason) VALUES (?, ?, ?, NULL, NULL, 'launching', ?, NULL, NULL)").run(o,e,t.daemonEpoch,i),O(n,o,e,i),o})}r(K,"beginExecution");function V(e,t,n){const i=l([n])?.get(n)??null;return p(o=>{if(c(o,"UPDATE executions SET pid = ?, process_identity = ?, state = 'running' WHERE execution_id = ? AND node_id = ? AND state = 'launching'").run(n,i,e,t).changes>0)return"recorded";const d=c(o,"SELECT pid FROM executions WHERE execution_id = ? AND node_id = ? AND state = 'running'").get(e,t);if(d?.pid===n)return"recorded";if(process.platform==="linux"&&y(R)&&d?.pid!=null){const N=T(),u=[d.pid];for(let a=0;a<u.length;a++)u.push(...N?.childrenOf.get(u[a])??[]);if(u.includes(n))return"recorded";for(const a of u)try{const m=U(`/proc/${a}/status`,"utf8"),_=/^NSpid:\s*(.+)$/m.exec(m)?.[1]?.trim().split(/\s+/).map(Number)??[];if(_.length>1&&_.at(-1)===n)return"recorded"}catch{}}return"shutdown"})}r(V,"recordExecutionPid");function P(e,t){return H(e),p(n=>{const i=E(),o=c(n,"UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE execution_id = ? AND state != 'exited'").run(i,t.reason,e);return x(n,"broker_process_id",e,i),Number(o.changes)===1})}r(P,"endExecution");function j(e,t){return P(e,t)}r(j,"abortExecution");function q(e,t){return p(n=>{const i=E(),o=c(n,"UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE node_id = ? AND state != 'exited'").run(i,t.reason,e);return x(n,"node_id",e,i),Number(o.changes)===1})}r(q,"endLiveExecution");function z(e=t=>l([t])?.get(t)){const t=f(),n=c(t,"SELECT execution_id, pid, process_identity FROM executions WHERE state = 'running' AND pid IS NOT NULL AND process_identity IS NOT NULL").all(),i=c(t,"UPDATE executions SET process_identity = ? WHERE execution_id = ? AND pid = ? AND process_identity = ? AND state = 'running'"),o=[];for(const s of n){if(!S(s.process_identity))continue;const d=e(s.pid);d===void 0||!L(d)||!D(d,s.process_identity)||i.run(d,s.execution_id,s.pid,s.process_identity).changes>0&&o.push(s.execution_id)}return{migrated:o}}r(z,"migrateLegacyExecutionIdentities");export{j as abortExecution,K as beginExecution,P as endExecution,q as endLiveExecution,B as liveExecutionForNode,z as migrateLegacyExecutionIdentities,V as recordExecutionPid};
+var y=Object.defineProperty;var o=(e,t)=>y(e,"name",{value:t,configurable:!0});import{randomUUID as m}from"node:crypto";import{openDb as _,withCanvasWrite as u}from"./db.js";import{capturePidIdentities as f,captureLivenessSnapshot as g,identitiesMatch as h,isBootScopedIdentity as A,isLegacyTicksIdentity as T}from"./pid.js";import{existsSync as D,readFileSync as L}from"node:fs";import{LAUNCHER_SOCKET as S}from"../../launcher/spec.js";import{forgetNodeToken as w,mintNodeToken as U,revokeNodeTokens as p}from"./node-tokens.js";function x(){return new Date().toISOString()}o(x,"now");function R(e){return{executionId:e.execution_id,nodeId:e.node_id,daemonEpoch:e.daemon_epoch??null,pid:e.pid??null,processIdentity:e.process_identity??null,state:e.state,startedAt:e.started_at,endedAt:e.ended_at??null,exitReason:e.exit_reason??null}}o(R,"hydrate");async function F(e){const t=await(await _()).prepare("SELECT * FROM executions WHERE node_id = ? AND state != 'exited'").get(e);return t===void 0?null:R(t)}o(F,"liveExecutionForNode");async function M(e,t){return await u(async n=>{const i=x();await n.prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = 'superseded' WHERE node_id = ? AND state != 'exited'").run(i,e),await p(n,"node_id",e,i);const r=m();return await n.prepare("INSERT INTO executions (execution_id, node_id, daemon_epoch, pid, process_identity, state, started_at, ended_at, exit_reason) VALUES (?, ?, ?, NULL, NULL, 'launching', ?, NULL, NULL)").run(r,e,t.daemonEpoch,i),await U(n,r,e,i),r})}o(M,"beginExecution");async function b(e,t,n){const i=f([n])?.get(n)??null;return await u(async r=>{if((await r.prepare("UPDATE executions SET pid = ?, process_identity = ?, state = 'running' WHERE execution_id = ? AND node_id = ? AND state = 'launching'").run(n,i,e,t)).changes>0)return"recorded";const s=await r.prepare("SELECT pid FROM executions WHERE execution_id = ? AND node_id = ? AND state = 'running'").get(e,t);if(s?.pid===n)return"recorded";if(process.platform==="linux"&&D(S)&&s?.pid!=null){const l=g(),c=[s.pid];for(let d=0;d<c.length;d++)c.push(...l?.childrenOf.get(c[d])??[]);if(c.includes(n))return"recorded";for(const d of c)try{const N=L(`/proc/${d}/status`,"utf8"),E=/^NSpid:\s*(.+)$/m.exec(N)?.[1]?.trim().split(/\s+/).map(Number)??[];if(E.length>1&&E.at(-1)===n)return"recorded"}catch{}}return"shutdown"})}o(b,"recordExecutionPid");async function H(e,t){return w(e),await u(async n=>{const i=x(),r=await n.prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE execution_id = ? AND state != 'exited'").run(i,t.reason,e);return await p(n,"broker_process_id",e,i),Number(r.changes)===1})}o(H,"endExecution");async function $(e,t){return await H(e,t)}o($,"abortExecution");async function B(e,t){return await u(async n=>{const i=x(),r=await n.prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE node_id = ? AND state != 'exited'").run(i,t.reason,e);return await p(n,"node_id",e,i),Number(r.changes)===1})}o(B,"endLiveExecution");async function K(e=t=>f([t])?.get(t)){const t=await _(),n=await t.prepare("SELECT execution_id, pid, process_identity FROM executions WHERE state = 'running' AND pid IS NOT NULL AND process_identity IS NOT NULL").all(),i=t.prepare("UPDATE executions SET process_identity = ? WHERE execution_id = ? AND pid = ? AND process_identity = ? AND state = 'running'"),r=[];for(const a of n){if(!T(a.process_identity))continue;const s=e(a.pid);s===void 0||!A(s)||!h(s,a.process_identity)||(await i.run(s,a.execution_id,a.pid,a.process_identity)).changes>0&&r.push(a.execution_id)}return{migrated:r}}o(K,"migrateLegacyExecutionIdentities");export{$ as abortExecution,M as beginExecution,H as endExecution,B as endLiveExecution,F as liveExecutionForNode,K as migrateLegacyExecutionIdentities,b as recordExecutionPid};

package/dist/core/canvas/focuses.d.ts

@@ -1,22 +1,22 @@
 import type { FocusRow } from './types.js';
 /** INSERT a viewport. Throws on UNIQUE(node_id) if `node_id` already occupies
  *  another focus (or on PK conflict if `focus_id` exists) — by design. */
-export declare function openFocusRow(focus_id: string, pane: string | null, session: string | null, node_id: string): void;
+export declare function openFocusRow(focus_id: string, pane: string | null, session: string | null, node_id: string): Promise<void>;
 /** Hot-swap a focus's occupant — single-statement UPDATE. Respects
  *  UNIQUE(node_id): if `node_id` already occupies ANOTHER focus this throws
  *  (correct — vacate-first is placement.focus()'s job, not this setter's). */
-export declare function setFocusOccupant(focus_id: string, node_id: string): void;
+export declare function setFocusOccupant(focus_id: string, node_id: string): Promise<void>;
 /** Re-point a viewer row's durable pane + its derived session cache after the
  *  pane moves. Single-statement UPDATE. */
-export declare function setFocusPane(focus_id: string, pane: string | null, session: string | null): void;
+export declare function setFocusPane(focus_id: string, pane: string | null, session: string | null): Promise<void>;
 /** DELETE a viewport. */
-export declare function closeFocusRow(focus_id: string): void;
+export declare function closeFocusRow(focus_id: string): Promise<void>;
 /** The focus a node occupies (≤1, UNIQUE node_id), or null. */
-export declare function getFocusByNode(node_id: string): FocusRow | null;
+export declare function getFocusByNode(node_id: string): Promise<FocusRow | null>;
 /** The focus realized by a given pane (`%id`), or null. */
-export declare function getFocusByPane(pane: string): FocusRow | null;
+export declare function getFocusByPane(pane: string): Promise<FocusRow | null>;
 /** A focus by its stable id, or null. Used by placement to read a row back by id
  *  after openFocusRow registers a viewer. */
-export declare function getFocusById(focus_id: string): FocusRow | null;
+export declare function getFocusById(focus_id: string): Promise<FocusRow | null>;
 /** Every focus row, ordered by id. */
-export declare function listFocuses(): FocusRow[];
+export declare function listFocuses(): Promise<FocusRow[]>;

package/dist/core/canvas/focuses.js

@@ -1 +1 @@
-var i=Object.defineProperty;var n=(o,e)=>i(o,"name",{value:e,configurable:!0});import{prepared as s}from"../sqlite-statements.js";import{openDb as u}from"./db.js";function c(o){return{focus_id:o.focus_id,pane:o.pane??null,session:o.session??null,node_id:o.node_id}}n(c,"focusFrom");function p(o,e,t,E){s(u(),"INSERT INTO focuses (focus_id, pane, session, node_id) VALUES (?, ?, ?, ?)").run(o,e,t,E)}n(p,"openFocusRow");function R(o,e){s(u(),"UPDATE focuses SET node_id = ? WHERE focus_id = ?").run(e,o)}n(R,"setFocusOccupant");function a(o,e,t){s(u(),"UPDATE focuses SET pane = ?, session = ? WHERE focus_id = ?").run(e,t,o)}n(a,"setFocusPane");function l(o){s(u(),"DELETE FROM focuses WHERE focus_id = ?").run(o)}n(l,"closeFocusRow");function F(o){const e=s(u(),"SELECT * FROM focuses WHERE node_id = ?").get(o);return e?c(e):null}n(F,"getFocusByNode");function _(o){const e=s(u(),"SELECT * FROM focuses WHERE pane = ?").get(o);return e?c(e):null}n(_,"getFocusByPane");function T(o){const e=s(u(),"SELECT * FROM focuses WHERE focus_id = ?").get(o);return e?c(e):null}n(T,"getFocusById");function S(){return s(u(),"SELECT * FROM focuses ORDER BY focus_id").all().map(c)}n(S,"listFocuses");export{l as closeFocusRow,T as getFocusById,F as getFocusByNode,_ as getFocusByPane,S as listFocuses,p as openFocusRow,R as setFocusOccupant,a as setFocusPane};
+var c=Object.defineProperty;var n=(e,o)=>c(e,"name",{value:o,configurable:!0});import{openDb as s}from"./db.js";function a(e){return{focus_id:e.focus_id,pane:e.pane??null,session:e.session??null,node_id:e.node_id}}n(a,"focusFrom");async function p(e,o,t,u){await(await s()).prepare("INSERT INTO focuses (focus_id, pane, session, node_id) VALUES (?, ?, ?, ?)").run(e,o,t,u)}n(p,"openFocusRow");async function E(e,o){await(await s()).prepare("UPDATE focuses SET node_id = ? WHERE focus_id = ?").run(o,e)}n(E,"setFocusOccupant");async function f(e,o,t){await(await s()).prepare("UPDATE focuses SET pane = ?, session = ? WHERE focus_id = ?").run(o,t,e)}n(f,"setFocusPane");async function d(e){await(await s()).prepare("DELETE FROM focuses WHERE focus_id = ?").run(e)}n(d,"closeFocusRow");async function w(e){const o=await(await s()).prepare("SELECT * FROM focuses WHERE node_id = ?").get(e);return o?a(o):null}n(w,"getFocusByNode");async function R(e){const o=await(await s()).prepare("SELECT * FROM focuses WHERE pane = ?").get(e);return o?a(o):null}n(R,"getFocusByPane");async function l(e){const o=await(await s()).prepare("SELECT * FROM focuses WHERE focus_id = ?").get(e);return o?a(o):null}n(l,"getFocusById");async function F(){return(await(await s()).prepare("SELECT * FROM focuses ORDER BY focus_id").all()).map(a)}n(F,"listFocuses");export{d as closeFocusRow,l as getFocusById,w as getFocusByNode,R as getFocusByPane,F as listFocuses,p as openFocusRow,E as setFocusOccupant,f as setFocusPane};

package/dist/core/canvas/history.d.ts

@@ -70,11 +70,11 @@ export interface CorpusFilter {
 /** The cwd the caller means by default: the calling node's cwd (resolved from
  *  CRTR_NODE_ID via the canvas data layer), falling back to the process cwd
  *  when not run as a node. */
-export declare function callerCwd(): string;
+export declare function callerCwd(): Promise<string>;
 /** Build the searchable artifact set for a scope + corpus filter. Node facets
  *  are applied against the db rows first (cheap); only surviving nodes' files
  *  are read. */
-export declare function buildCorpus(scope: ScopeFilter, corpus: CorpusFilter): HistoryArtifact[];
+export declare function buildCorpus(scope: ScopeFilter, corpus: CorpusFilter): Promise<HistoryArtifact[]>;
 export type GroupKey = 'origin' | 'node' | 'kind' | 'day' | 'type' | 'role';
 export interface CorpusGroup {
     key: string;
@@ -101,4 +101,4 @@ export interface ResolvedRef {
 /** Resolve a `<node-id>:inbox/<n>`, `<node-id>:session` or
  *  `<node-id>:session/<n>` handle to its content. Returns null when the node is
  *  unknown, the ref names another corpus, or the entry does not exist. */
-export declare function resolveRef(ref: string): ResolvedRef | null;
+export declare function resolveRef(ref: string): Promise<ResolvedRef | null>;