@north-light/cli 0.3.530 → 0.3.531

package/dist/core/canvas/waits.js

@@ -1,11 +1,11 @@
-var c=Object.defineProperty;var r=(t,e)=>c(t,"name",{value:e,configurable:!0});import{prepared as i}from"../sqlite-statements.js";import{randomBytes as l}from"node:crypto";import{openDb as o,withCanvasWrite as N}from"./db.js";function _(t){if(t.kind!=="controller")throw new Error(`wait ${t.wait_id} is not a controller wait`);return{waitId:t.wait_id,nodeId:t.node_id,controllerId:t.target_id,generation:t.generation,createdAt:t.created_at,satisfiedAt:t.satisfied_at}}r(_,"waitFrom");function E(){let t;do t=l(16).toString("hex");while(t==="00000000000000000000000000000000");return t}r(E,"newWaitId");function g(t,e,a=Date.now()){return N(n=>{i(n,"UPDATE waits SET satisfied_at = ? WHERE node_id = ? AND kind = 'controller' AND satisfied_at IS NULL").run(a,t);const d=Number(i(n,"SELECT COALESCE(MAX(generation), 0) AS generation FROM waits WHERE node_id = ? AND kind = 'controller'").get(t).generation)+1,s={wait_id:E(),node_id:t,kind:"controller",target_id:e,generation:d,created_at:a,satisfied_at:null};return i(n,`INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at)
-       VALUES (?, ?, 'controller', ?, ?, ?, NULL)`).run(s.wait_id,s.node_id,s.target_id,s.generation,s.created_at),_(s)})}r(g,"armControllerWait");function A(t){const e=i(o(),"SELECT * FROM waits WHERE node_id = ? AND kind = 'controller' AND satisfied_at IS NULL").get(t);return e===void 0?null:_(e)}r(A,"readControllerWait");function D(t,e,a,n=o()){if(e===null)return!1;const d=i(n,"SELECT wait_id, generation FROM waits WHERE node_id = ? AND kind = 'controller' AND target_id = ? AND satisfied_at IS NULL").get(t,e);return d===void 0?!1:Number(i(n,"UPDATE waits SET satisfied_at = ? WHERE wait_id = ? AND generation = ? AND satisfied_at IS NULL").run(a,d.wait_id,d.generation).changes)===1}r(D,"settleMatchingControllerWait");function S(t,e,a,n=o()){const d=i(n,`SELECT w.wait_id, w.generation, target.status AS controller_status
+var w=Object.defineProperty;var n=(t,e)=>w(t,"name",{value:e,configurable:!0});import{randomBytes as c}from"node:crypto";import{withCanvasWrite as E,openDb as d}from"./db.js";function s(t){if(t.kind!=="controller")throw new Error(`wait ${t.wait_id} is not a controller wait`);return{waitId:t.wait_id,nodeId:t.node_id,controllerId:t.target_id,generation:t.generation,createdAt:t.created_at,satisfiedAt:t.satisfied_at}}n(s,"waitFrom");function _(){let t;do t=c(16).toString("hex");while(t==="00000000000000000000000000000000");return t}n(_,"newWaitId");async function f(t,e,i=Date.now()){return await E(async a=>{await a.prepare("UPDATE waits SET satisfied_at = ? WHERE node_id = ? AND kind = 'controller' AND satisfied_at IS NULL").run(i,t);const r=Number((await a.prepare("SELECT COALESCE(MAX(generation), 0) AS generation FROM waits WHERE node_id = ? AND kind = 'controller'").get(t)).generation)+1,o={wait_id:_(),node_id:t,kind:"controller",target_id:e,generation:r,created_at:i,satisfied_at:null};return await a.prepare(`INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at)
+       VALUES (?, ?, 'controller', ?, ?, ?, NULL)`).run(o.wait_id,o.node_id,o.target_id,o.generation,o.created_at),s(o)})}n(f,"armControllerWait");async function p(t){const e=await(await d()).prepare("SELECT * FROM waits WHERE node_id = ? AND kind = 'controller' AND satisfied_at IS NULL").get(t);return e===void 0?null:s(e)}n(p,"readControllerWait");async function L(t,e,i,a){if(a??=await d(),e===null)return!1;const r=await a.prepare("SELECT wait_id, generation FROM waits WHERE node_id = ? AND kind = 'controller' AND target_id = ? AND satisfied_at IS NULL").get(t,e);return r===void 0?!1:Number((await a.prepare("UPDATE waits SET satisfied_at = ? WHERE wait_id = ? AND generation = ? AND satisfied_at IS NULL").run(i,r.wait_id,r.generation)).changes)===1}n(L,"settleMatchingControllerWait");async function g(t,e,i,a){a??=await d();const r=await a.prepare(`SELECT w.wait_id, w.generation, target.status AS controller_status
        FROM waits w LEFT JOIN nodes target ON target.node_id = w.target_id
-      WHERE w.node_id = ? AND w.kind = 'controller' AND w.target_id = ? AND w.satisfied_at IS NULL`).get(t,e);return d===void 0||d.controller_status==="active"||d.controller_status==="idle"?!1:Number(i(n,"UPDATE waits SET satisfied_at = ? WHERE wait_id = ? AND generation = ? AND satisfied_at IS NULL").run(a,d.wait_id,d.generation).changes)===1}r(S,"settleDeadControllerWait");function T(){return i(o(),"SELECT * FROM waits WHERE kind = 'controller' AND satisfied_at IS NULL").all().map(_)}r(T,"liveControllerWaits");function R(t,e,a,n=Date.now()){i(t,`INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at)
+      WHERE w.node_id = ? AND w.kind = 'controller' AND w.target_id = ? AND w.satisfied_at IS NULL`).get(t,e);return r===void 0||r.controller_status==="active"||r.controller_status==="idle"?!1:Number((await a.prepare("UPDATE waits SET satisfied_at = ? WHERE wait_id = ? AND generation = ? AND satisfied_at IS NULL").run(i,r.wait_id,r.generation)).changes)===1}n(g,"settleDeadControllerWait");async function A(){return(await(await d()).prepare("SELECT * FROM waits WHERE kind = 'controller' AND satisfied_at IS NULL").all()).map(s)}n(A,"liveControllerWaits");async function D(t,e,i,a=Date.now()){await t.prepare(`INSERT INTO waits (wait_id, node_id, kind, target_id, generation, created_at, satisfied_at)
      SELECT ?, ?, 'object', ?, 1, ?, NULL
-     WHERE NOT EXISTS (SELECT 1 FROM waits WHERE node_id = ? AND kind = 'object' AND target_id = ? AND satisfied_at IS NULL)`).run(E(),e,a,n,e,a)}r(R,"armObjectWait");function W(t,e,a=null,n=Date.now()){return Number(a===null?i(t,"UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND target_id = ? AND satisfied_at IS NULL").run(n,e).changes:i(t,"UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND target_id = ? AND node_id = ? AND satisfied_at IS NULL").run(n,e,a).changes)}r(W,"settleObjectWaits");function I(t,e,a=Date.now()){return Number(i(t,"UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND node_id = ? AND satisfied_at IS NULL").run(a,e).changes)}r(I,"settleNodeObjectWaits");function O(t=o()){return i(t,`SELECT w.wait_id, w.node_id, w.target_id, w.created_at, o.type AS object_type, o.name AS object_name
+     WHERE NOT EXISTS (SELECT 1 FROM waits WHERE node_id = ? AND kind = 'object' AND target_id = ? AND satisfied_at IS NULL)`).run(_(),e,i,a,e,i)}n(D,"armObjectWait");async function S(t,e,i=null,a=Date.now()){return Number(i===null?(await t.prepare("UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND target_id = ? AND satisfied_at IS NULL").run(a,e)).changes:(await t.prepare("UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND target_id = ? AND node_id = ? AND satisfied_at IS NULL").run(a,e,i)).changes)}n(S,"settleObjectWaits");async function T(t,e,i=Date.now()){return Number((await t.prepare("UPDATE waits SET satisfied_at = ? WHERE kind = 'object' AND node_id = ? AND satisfied_at IS NULL").run(i,e)).changes)}n(T,"settleNodeObjectWaits");async function R(t){return t??=await d(),(await t.prepare(`SELECT w.wait_id, w.node_id, w.target_id, w.created_at, o.type AS object_type, o.name AS object_name
        FROM waits w JOIN objects o ON o.id = w.target_id
       WHERE w.kind = 'object' AND w.satisfied_at IS NULL AND o.deleted_at IS NULL
-      ORDER BY w.node_id, w.created_at, w.rowid`).all().map(e=>({waitId:e.wait_id,nodeId:e.node_id,objectId:e.target_id,createdAt:e.created_at,objectType:e.object_type,objectName:e.object_name}))}r(O,"liveObjectWaitsNamed");function U(t){return i(o(),"SELECT 1 FROM waits WHERE node_id = ? AND kind = 'object' AND satisfied_at IS NULL LIMIT 1").get(t)!==void 0}r(U,"hasLiveObjectWait");function m(t){return i(o(),`SELECT 1 FROM waits w JOIN nodes target ON target.node_id = w.target_id
+      ORDER BY w.node_id, w.created_at, w.rowid`).all()).map(e=>({waitId:e.wait_id,nodeId:e.node_id,objectId:e.target_id,createdAt:e.created_at,objectType:e.object_type,objectName:e.object_name}))}n(R,"liveObjectWaitsNamed");async function W(t){return await(await d()).prepare("SELECT 1 FROM waits WHERE node_id = ? AND kind = 'object' AND satisfied_at IS NULL LIMIT 1").get(t)!==void 0}n(W,"hasLiveObjectWait");async function I(t){return await(await d()).prepare(`SELECT 1 FROM waits w JOIN nodes target ON target.node_id = w.target_id
       WHERE w.node_id = ? AND w.kind = 'controller' AND w.satisfied_at IS NULL
-        AND target.status IN ('active', 'idle') LIMIT 1`).get(t)!==void 0}r(m,"hasLiveControllerWait");export{g as armControllerWait,R as armObjectWait,m as hasLiveControllerWait,U as hasLiveObjectWait,T as liveControllerWaits,O as liveObjectWaitsNamed,A as readControllerWait,S as settleDeadControllerWait,D as settleMatchingControllerWait,I as settleNodeObjectWaits,W as settleObjectWaits};
+        AND target.status IN ('active', 'idle') LIMIT 1`).get(t)!==void 0}n(I,"hasLiveControllerWait");export{f as armControllerWait,D as armObjectWait,I as hasLiveControllerWait,W as hasLiveObjectWait,A as liveControllerWaits,R as liveObjectWaitsNamed,p as readControllerWait,g as settleDeadControllerWait,L as settleMatchingControllerWait,T as settleNodeObjectWaits,S as settleObjectWaits};

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

@@ -1,12 +1,12 @@
-import { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from './db.js';
 import type { ManagedWorktree, ManagedWorktreeObservation } from './types.js';
 export declare function worktreeFromRow(row: Record<string, unknown> | undefined): ManagedWorktree | null;
-export declare function readWorktree(nodeId: string): ManagedWorktree | null;
-export declare function openWorktree(nodeId: string, worktree: ManagedWorktree, db?: DatabaseSync): void;
+export declare function readWorktree(nodeId: string): Promise<ManagedWorktree | null>;
+export declare function openWorktree(nodeId: string, worktree: ManagedWorktree, db?: CanvasDb): Promise<void>;
 export declare function closeWorktree(nodeId: string, input: {
     cleanup: 'pending' | 'complete';
     closedAt: string;
-}): void;
+}): Promise<void>;
 /** Complete a worktree close and repoint the node in the same SQL transaction.
  * A close invalidates the active transcript because Pi remains in the old
  * checkout; the next launch starts from the durable base checkout. */
@@ -15,14 +15,14 @@ export declare function closeWorktreeAndRepoint(nodeId: string, input: {
     cleanup: 'pending' | 'complete';
     closedAt: string;
     unbindSession: boolean;
-}): void;
-export declare function abandonWorktree(nodeId: string, abandoned: NonNullable<ManagedWorktree['abandoned']>): void;
+}): Promise<void>;
+export declare function abandonWorktree(nodeId: string, abandoned: NonNullable<ManagedWorktree['abandoned']>): Promise<void>;
 export declare function abandonWorktreeAndRepoint(nodeId: string, input: {
     cwd: string;
     abandoned: NonNullable<ManagedWorktree['abandoned']>;
-}): void;
-export declare function recordLandIntent(nodeId: string, intent: NonNullable<ManagedWorktree['land_intent']>): void;
-export declare function recordDisposalGrant(nodeId: string, disposal: NonNullable<ManagedWorktree['disposal']>): void;
+}): Promise<void>;
+export declare function recordLandIntent(nodeId: string, intent: NonNullable<ManagedWorktree['land_intent']>): Promise<void>;
+export declare function recordDisposalGrant(nodeId: string, disposal: NonNullable<ManagedWorktree['disposal']>): Promise<void>;
 export declare function recordSweepAttempt(nodeId: string, input: {
     reason: string;
     detail?: string;
@@ -31,11 +31,11 @@ export declare function recordSweepAttempt(nodeId: string, input: {
     lastAttemptAt: string;
     nextAttemptAt: string;
     quarantined: boolean;
-}): void;
-export declare function completeCleanup(nodeId: string): void;
-export declare function hasUnreconciledWorktree(nodeId: string): boolean;
-export declare function sweepCandidates(now: string): string[];
-export declare function quarantinedWorktrees(): Array<{
+}): Promise<void>;
+export declare function completeCleanup(nodeId: string): Promise<void>;
+export declare function hasUnreconciledWorktree(nodeId: string): Promise<boolean>;
+export declare function sweepCandidates(now: string): Promise<string[]>;
+export declare function quarantinedWorktrees(): Promise<Array<{
     nodeId: string;
     worktree: ManagedWorktree;
-}>;
+}>>;

package/dist/core/canvas/worktrees.js

@@ -1 +1 @@
-var l=Object.defineProperty;var n=(e,t)=>l(e,"name",{value:t,configurable:!0});import{prepared as a}from"../sqlite-statements.js";import{openDb as s,withCanvasWrite as p}from"./db.js";function _(e){const t=JSON.stringify(e);if(t===void 0)throw new TypeError("worktree value must be JSON-serializable");return t}n(_,"json");function d(e){if(typeof e=="string")return JSON.parse(e)}n(d,"parse");function i(e){if(e===void 0)return null;const t=d(e.sweep_observed_json),o=e.attempts,r=t===void 0?void 0:{reason:e.sweep_reason,...e.sweep_detail===null?{}:{detail:e.sweep_detail},observed:t,attempts:o,last_attempt:e.sweep_last_at,next_attempt:e.next_attempt_at,...e.quarantined===1?{quarantined:!0}:{}};return{state:e.state,...e.cleanup_state===null?{}:{cleanup:e.cleanup_state},path:e.path,branch:e.branch,repo_root:e.repo_root,base_ref:e.base_ref,base_sha:e.base_sha,created:e.created_at,...e.closed_at===null?{}:{closed:e.closed_at},...d(e.abandoned_json)===void 0?{}:{abandoned:d(e.abandoned_json)},...d(e.land_intent_json)===void 0?{}:{land_intent:d(e.land_intent_json)},...r===void 0?{}:{sweep:r},...d(e.disposal_json)===void 0?{}:{disposal:d(e.disposal_json)}}}n(i,"worktreeFromRow");function c(e){return i(a(s(),"SELECT * FROM worktrees WHERE node_id = ?").get(e))}n(c,"readWorktree");function N(e,t,o=s()){a(o,"INSERT INTO worktrees (node_id, state, cleanup_state, path, branch, repo_root, base_ref, base_sha, created_at, closed_at, next_attempt_at, attempts, quarantined, sweep_reason, sweep_detail, sweep_last_at, sweep_observed_json, abandoned_json, land_intent_json, disposal_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, 0, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL)").run(e,t.state,t.cleanup??null,t.path,t.branch,t.repo_root,t.base_ref,t.base_sha,t.created,t.closed??null)}n(N,"openWorktree");function U(e,t){a(s(),"UPDATE worktrees SET state = 'closed', cleanup_state = ?, closed_at = ?, land_intent_json = NULL, sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(t.cleanup,t.closedAt,e)}n(U,"closeWorktree");function f(e,t){p(o=>{a(o,"UPDATE nodes SET cwd = ? WHERE node_id = ?").run(t.cwd,e),t.unbindSession&&a(o,"UPDATE sessions SET unbound_at = ? WHERE node_id = ? AND unbound_at IS NULL").run(t.closedAt,e),a(o,"UPDATE worktrees SET state = 'closed', cleanup_state = ?, closed_at = ?, land_intent_json = NULL, sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(t.cleanup,t.closedAt,e)})}n(f,"closeWorktreeAndRepoint");function b(e,t){a(s(),"UPDATE worktrees SET state = 'abandoned', abandoned_json = ? WHERE node_id = ? AND abandoned_json IS NULL").run(_(t),e)}n(b,"abandonWorktree");function A(e,t){p(o=>{a(o,"UPDATE nodes SET cwd = ? WHERE node_id = ?").run(t.cwd,e),a(o,"UPDATE worktrees SET state = 'abandoned', abandoned_json = ? WHERE node_id = ? AND abandoned_json IS NULL").run(_(t.abandoned),e)})}n(A,"abandonWorktreeAndRepoint");function m(e,t){a(s(),"UPDATE worktrees SET land_intent_json = ? WHERE node_id = ? AND land_intent_json IS NULL").run(_(t),e)}n(m,"recordLandIntent");function w(e,t){a(s(),"UPDATE worktrees SET disposal_json = ? WHERE node_id = ? AND disposal_json IS NULL").run(_(t),e)}n(w,"recordDisposalGrant");function R(e,t){a(s(),"UPDATE worktrees SET sweep_reason = ?, sweep_detail = ?, sweep_observed_json = ?, attempts = ?, sweep_last_at = ?, next_attempt_at = ?, quarantined = ? WHERE node_id = ?").run(t.reason,t.detail??null,_(t.observed),t.attempts,t.lastAttemptAt,t.nextAttemptAt,t.quarantined?1:0,e)}n(R,"recordSweepAttempt");function S(e){a(s(),"UPDATE worktrees SET state = 'closed', cleanup_state = 'complete', sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(e)}n(S,"completeCleanup");function T(e){return a(s(),"SELECT 1 FROM worktrees WHERE node_id = ? AND state != 'abandoned' AND (state = 'open' OR cleanup_state IS NULL OR cleanup_state != 'complete')").get(e)!==void 0}n(T,"hasUnreconciledWorktree");function D(e){return a(s(),"SELECT w.node_id FROM worktrees w JOIN nodes n ON n.node_id = w.node_id WHERE n.status IN ('done', 'dead', 'canceled') AND n.frozen_at IS NULL AND w.state IN ('open', 'closed') AND (w.state = 'open' OR w.cleanup_state IS NULL OR w.cleanup_state != 'complete') AND (w.state = 'closed' OR (n.status = 'done' AND n.final_report IS NOT NULL)) AND (w.next_attempt_at IS NULL OR w.next_attempt_at <= ?) ORDER BY w.next_attempt_at, w.node_id").all(e).map(({node_id:t})=>t)}n(D,"sweepCandidates");function j(){return a(s(),"SELECT node_id FROM worktrees WHERE quarantined = 1 ORDER BY sweep_last_at").all().flatMap(({node_id:e})=>{const t=c(e);return t===null?[]:[{nodeId:e,worktree:t}]})}n(j,"quarantinedWorktrees");export{b as abandonWorktree,A as abandonWorktreeAndRepoint,U as closeWorktree,f as closeWorktreeAndRepoint,S as completeCleanup,T as hasUnreconciledWorktree,N as openWorktree,j as quarantinedWorktrees,c as readWorktree,w as recordDisposalGrant,m as recordLandIntent,R as recordSweepAttempt,D as sweepCandidates,i as worktreeFromRow};
+var p=Object.defineProperty;var a=(e,t)=>p(e,"name",{value:t,configurable:!0});import{openDb as s,withCanvasWrite as _}from"./db.js";import{flatMapAsync as i}from"../async-array.js";function d(e){const t=JSON.stringify(e);if(t===void 0)throw new TypeError("worktree value must be JSON-serializable");return t}a(d,"json");function o(e){if(typeof e=="string")return JSON.parse(e)}a(o,"parse");function l(e){if(e===void 0)return null;const t=o(e.sweep_observed_json),n=e.attempts,r=t===void 0?void 0:{reason:e.sweep_reason,...e.sweep_detail===null?{}:{detail:e.sweep_detail},observed:t,attempts:n,last_attempt:e.sweep_last_at,next_attempt:e.next_attempt_at,...e.quarantined===1?{quarantined:!0}:{}};return{state:e.state,...e.cleanup_state===null?{}:{cleanup:e.cleanup_state},path:e.path,branch:e.branch,repo_root:e.repo_root,base_ref:e.base_ref,base_sha:e.base_sha,created:e.created_at,...e.closed_at===null?{}:{closed:e.closed_at},...o(e.abandoned_json)===void 0?{}:{abandoned:o(e.abandoned_json)},...o(e.land_intent_json)===void 0?{}:{land_intent:o(e.land_intent_json)},...r===void 0?{}:{sweep:r},...o(e.disposal_json)===void 0?{}:{disposal:o(e.disposal_json)}}}a(l,"worktreeFromRow");async function c(e){return l(await(await s()).prepare("SELECT * FROM worktrees WHERE node_id = ?").get(e))}a(c,"readWorktree");async function w(e,t,n){n??=await s(),await n.prepare("INSERT INTO worktrees (node_id, state, cleanup_state, path, branch, repo_root, base_ref, base_sha, created_at, closed_at, next_attempt_at, attempts, quarantined, sweep_reason, sweep_detail, sweep_last_at, sweep_observed_json, abandoned_json, land_intent_json, disposal_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, 0, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL)").run(e,t.state,t.cleanup??null,t.path,t.branch,t.repo_root,t.base_ref,t.base_sha,t.created,t.closed??null)}a(w,"openWorktree");async function N(e,t){await(await s()).prepare("UPDATE worktrees SET state = 'closed', cleanup_state = ?, closed_at = ?, land_intent_json = NULL, sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(t.cleanup,t.closedAt,e)}a(N,"closeWorktree");async function U(e,t){await _(async n=>{await n.prepare("UPDATE nodes SET cwd = ? WHERE node_id = ?").run(t.cwd,e),t.unbindSession&&await n.prepare("UPDATE sessions SET unbound_at = ? WHERE node_id = ? AND unbound_at IS NULL").run(t.closedAt,e),await n.prepare("UPDATE worktrees SET state = 'closed', cleanup_state = ?, closed_at = ?, land_intent_json = NULL, sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(t.cleanup,t.closedAt,e)})}a(U,"closeWorktreeAndRepoint");async function f(e,t){await(await s()).prepare("UPDATE worktrees SET state = 'abandoned', abandoned_json = ? WHERE node_id = ? AND abandoned_json IS NULL").run(d(t),e)}a(f,"abandonWorktree");async function b(e,t){await _(async n=>{await n.prepare("UPDATE nodes SET cwd = ? WHERE node_id = ?").run(t.cwd,e),await n.prepare("UPDATE worktrees SET state = 'abandoned', abandoned_json = ? WHERE node_id = ? AND abandoned_json IS NULL").run(d(t.abandoned),e)})}a(b,"abandonWorktreeAndRepoint");async function A(e,t){await(await s()).prepare("UPDATE worktrees SET land_intent_json = ? WHERE node_id = ? AND land_intent_json IS NULL").run(d(t),e)}a(A,"recordLandIntent");async function m(e,t){await(await s()).prepare("UPDATE worktrees SET disposal_json = ? WHERE node_id = ? AND disposal_json IS NULL").run(d(t),e)}a(m,"recordDisposalGrant");async function R(e,t){await(await s()).prepare("UPDATE worktrees SET sweep_reason = ?, sweep_detail = ?, sweep_observed_json = ?, attempts = ?, sweep_last_at = ?, next_attempt_at = ?, quarantined = ? WHERE node_id = ?").run(t.reason,t.detail??null,d(t.observed),t.attempts,t.lastAttemptAt,t.nextAttemptAt,t.quarantined?1:0,e)}a(R,"recordSweepAttempt");async function S(e){await(await s()).prepare("UPDATE worktrees SET state = 'closed', cleanup_state = 'complete', sweep_reason = NULL, sweep_detail = NULL, sweep_last_at = NULL, sweep_observed_json = NULL, next_attempt_at = NULL, attempts = 0, quarantined = 0 WHERE node_id = ?").run(e)}a(S,"completeCleanup");async function T(e){return await(await s()).prepare("SELECT 1 FROM worktrees WHERE node_id = ? AND state != 'abandoned' AND (state = 'open' OR cleanup_state IS NULL OR cleanup_state != 'complete')").get(e)!==void 0}a(T,"hasUnreconciledWorktree");async function D(e){return(await(await s()).prepare("SELECT w.node_id FROM worktrees w JOIN nodes n ON n.node_id = w.node_id WHERE n.status IN ('done', 'dead', 'canceled') AND n.frozen_at IS NULL AND w.state IN ('open', 'closed') AND (w.state = 'open' OR w.cleanup_state IS NULL OR w.cleanup_state != 'complete') AND (w.state = 'closed' OR (n.status = 'done' AND n.final_report IS NOT NULL)) AND (w.next_attempt_at IS NULL OR w.next_attempt_at <= ?) ORDER BY w.next_attempt_at, w.node_id").all(e)).map(({node_id:t})=>t)}a(D,"sweepCandidates");async function j(){return await i(await(await s()).prepare("SELECT node_id FROM worktrees WHERE quarantined = 1 ORDER BY sweep_last_at").all(),async({node_id:e})=>{const t=await c(e);return t===null?[]:[{nodeId:e,worktree:t}]})}a(j,"quarantinedWorktrees");export{f as abandonWorktree,b as abandonWorktreeAndRepoint,N as closeWorktree,U as closeWorktreeAndRepoint,S as completeCleanup,T as hasUnreconciledWorktree,w as openWorktree,j as quarantinedWorktrees,c as readWorktree,m as recordDisposalGrant,A as recordLandIntent,R as recordSweepAttempt,D as sweepCandidates,l as worktreeFromRow};

package/dist/core/command-hooks/transport/exec-lifecycle.js

@@ -1 +1 @@
-var M=Object.defineProperty;var c=(e,t)=>M(e,"name",{value:t,configurable:!0});import{randomBytes as k}from"node:crypto";import{spawn as _}from"node:child_process";import{PROCESS_GROUP_KILL_GRACE_MS as S,posixProcessGroupSpawnOptions as R,terminateProcessGroup as V}from"../../../hook-process.js";import{isRecord as L}from"../../../shared/predicates.js";import{diag as x}from"../../io.js";import{LIFECYCLE_CATALOG as O}from"../lifecycle-catalog.js";import{getNode as A}from"../../canvas/canvas.js";import{buildAppProcessEnv as C}from"../../runtime/spawn-env.js";import{appProcessSandboxed as D,launchAppProcess as G}from"../../spaces/process.js";const P=10*1024*1024;async function H(e,t,n){try{const r=await B(e,t,n);r.ok||x(`crtr: ${g(e)} failed: ${r.error.code}: ${r.error.message}`)}catch(r){x(`crtr: ${g(e)} failed: ${w(r)}`)}}c(H,"invokeLifecycleHook");async function te(e,t){if(e.length===0)return;const{hookTimeoutMs:n,eventBudgetMs:r}=O[e[0].event],s=Date.now()+r;for(const o of e){const a=s-Date.now(),u=Math.min(n,a-S);if(u<=0){x(`crtr: lifecycle hook event ${o.event} exceeded its ${r}ms aggregate budget; skipped ${g(o)}`);return}await H(o,t,u)}}c(te,"invokeLifecycleHooks");async function re(e,t){if(e.length===0)return null;const{hookTimeoutMs:n,eventBudgetMs:r}=O["node:create"],s=Date.now()+r;for(const o of e){const a=s-Date.now(),u=Math.min(n,a-S);if(u<=0)return T(o,`lifecycle hook event node:create exceeded its ${r}ms aggregate budget`);try{const i=await B(o,t,u);if(!i.ok)return{hook:o,message:i.error.message,next:i.error.next??E(o)}}catch(i){return T(o,w(i))}}return null}c(re,"invokeBlockingLifecycleHooks");function T(e,t){return{hook:e,message:`${g(e)} failed: ${t}`,next:E(e)}}c(T,"refusal");function ne(e){return E(e)}c(ne,"lifecycleHookAttribution");async function B(e,t,n){const r=e.event==="node:create"?N(e,t):I(e,t),s=D()?await J(e,t,JSON.stringify(r),n):await q(e,JSON.stringify(r),n);if(s.signal!==null)throw new Error(`executable was killed by signal ${s.signal}`);const o=K(s.stdout);return o.ok&&s.status!==0&&x(`crtr: ${g(e)} returned ok:true but exited ${s.status} (honoring the envelope)`),o}c(B,"executeLifecycleHook");function I(e,t){return{protocolVersion:1,op:e.op,event:e.event,phase:e.phase,operationId:k(16).toString("hex"),node:t.node,runtime:t.runtime,context:{cwd:t.node.cwd}}}c(I,"nodeRequest");function N(e,t){return{protocolVersion:1,op:e.op,event:"node:create",phase:"before",operationId:k(16).toString("hex"),create:t.create,runtime:t.runtime,context:{cwd:t.create.cwd}}}c(N,"createRequest");async function J(e,t,n,r){const s=e.event==="node:create",o=s?t.create.cwd:t.node.cwd,a=s?void 0:t.node.id,u=s?t.app:A(a)?.grantee;if(!u)throw new Error(`missing app for lifecycle hook ${e.event}`);const i=C(o,t.runtime.profile,u),m=await G({...s?{app:u}:{nodeId:a},command:[e.executable,"--crtr-hook-protocol","1"],cwd:e.plugin.root,pluginRoot:e.plugin.root,env:i,stdin:n,stdoutBytes:P,stderrBytes:64*1024});let l;try{const p=await Promise.race([m.completion,new Promise((b,f)=>{l=setTimeout(()=>{m.stop().then(()=>f(new Error(`executable timed out after ${r}ms`)),f)},r)})]);if(p.stdoutTruncated)throw new Error("stdout exceeded the 10 MiB cap");return{stdout:p.stdout,status:p.exitCode,signal:p.signal}}finally{l&&clearTimeout(l)}}c(J,"runSandboxedLifecycleProcess");async function q(e,t,n){let r;try{r=_(e.executable,["--crtr-hook-protocol","1"],{cwd:e.plugin.root,env:process.env,stdio:["pipe","pipe","inherit"],...R()})}catch(s){throw new Error(`executable could not be run (${w(s)})`)}return new Promise((s,o)=>{let a=0;const u=[];let i,m=!1,l=!1,p=null,b=null,f;const y=c(()=>{if(!(!m||i!==void 0&&!l)){if(f!==void 0&&clearTimeout(f),i?.kind==="timeout")return o(new Error(`executable timed out after ${n}ms`));if(i?.kind==="output_limit")return o(new Error("stdout exceeded the 10 MiB cap"));if(i?.kind==="spawn")return o(new Error(`executable could not be run (${w(i.error)})`));if(i?.kind==="cleanup")return o(new Error(`executable cleanup failed (${w(i.error)})`));s({stdout:Buffer.concat(u).toString("utf8"),status:p,signal:b})}},"finish"),$=c(d=>{i===void 0&&(i=d,f!==void 0&&clearTimeout(f),V(r).then(()=>{l=!0,y()},h=>{i={kind:"cleanup",error:h},l=!0,y()}))},"terminate");r.stdout.on("data",d=>{if(a+=d.byteLength,a>P)return $({kind:"output_limit"});u.push(d)}),r.once("error",d=>{if(r.pid===void 0){i={kind:"spawn",error:d},m=!0,l=!0,y();return}$({kind:"spawn",error:d})}),r.once("close",(d,h)=>{p=d,b=h,m=!0,y()}),f=setTimeout(()=>$({kind:"timeout"}),n),r.stdin.end(t)})}c(q,"runLifecycleProcess");function K(e){let t;try{t=JSON.parse(e.trim())}catch{throw new Error("stdout was not a single JSON envelope")}if(!L(t)||t.protocolVersion!==1)throw new Error("stdout was not a protocolVersion: 1 envelope");if(t.ok===!0&&v(t,["protocolVersion","ok"]))return{protocolVersion:1,ok:!0};if(t.ok!==!1||!v(t,["protocolVersion","ok","error"]))throw new Error("response envelope had missing or extra fields");const n=t.error;if(!L(n)||!v(n,["code","message"],["next"])||typeof n.code!="string"||n.code===""||typeof n.message!="string"||n.message===""||n.next!==void 0&&typeof n.next!="string")throw new Error("failure envelope had invalid error fields");return{protocolVersion:1,ok:!1,error:{code:n.code,message:n.message,...n.next===void 0?{}:{next:n.next}}}}c(K,"parseEnvelope");function v(e,t,n=[]){return t.every(r=>Object.hasOwn(e,r))&&Object.keys(e).every(r=>t.includes(r)||n.includes(r))}c(v,"exactKeys");function g(e){return`plugin "${e.plugin.name}" lifecycle hook "${e.op}" for ${e.event}`}c(g,"label");function E(e){return`Refused by plugin ${e.plugin.name}, op ${e.op}.`}c(E,"attribution");function w(e){return e instanceof Error?e.message:String(e)}c(w,"describeError");export{re as invokeBlockingLifecycleHooks,H as invokeLifecycleHook,te as invokeLifecycleHooks,ne as lifecycleHookAttribution};
+var M=Object.defineProperty;var c=(e,t)=>M(e,"name",{value:t,configurable:!0});import{randomBytes as k}from"node:crypto";import{spawn as _}from"node:child_process";import{PROCESS_GROUP_KILL_GRACE_MS as S,posixProcessGroupSpawnOptions as R,terminateProcessGroup as V}from"../../../hook-process.js";import{isRecord as L}from"../../../shared/predicates.js";import{diag as x}from"../../io.js";import{LIFECYCLE_CATALOG as O}from"../lifecycle-catalog.js";import{getNode as A}from"../../canvas/canvas.js";import{buildAppProcessEnv as C}from"../../runtime/spawn-env.js";import{appProcessSandboxed as D,launchAppProcess as G}from"../../spaces/process.js";const P=10*1024*1024;async function H(e,t,n){try{const r=await B(e,t,n);r.ok||x(`crtr: ${g(e)} failed: ${r.error.code}: ${r.error.message}`)}catch(r){x(`crtr: ${g(e)} failed: ${w(r)}`)}}c(H,"invokeLifecycleHook");async function te(e,t){if(e.length===0)return;const{hookTimeoutMs:n,eventBudgetMs:r}=O[e[0].event],s=Date.now()+r;for(const o of e){const a=s-Date.now(),u=Math.min(n,a-S);if(u<=0){x(`crtr: lifecycle hook event ${o.event} exceeded its ${r}ms aggregate budget; skipped ${g(o)}`);return}await H(o,t,u)}}c(te,"invokeLifecycleHooks");async function re(e,t){if(e.length===0)return null;const{hookTimeoutMs:n,eventBudgetMs:r}=O["node:create"],s=Date.now()+r;for(const o of e){const a=s-Date.now(),u=Math.min(n,a-S);if(u<=0)return T(o,`lifecycle hook event node:create exceeded its ${r}ms aggregate budget`);try{const i=await B(o,t,u);if(!i.ok)return{hook:o,message:i.error.message,next:i.error.next??E(o)}}catch(i){return T(o,w(i))}}return null}c(re,"invokeBlockingLifecycleHooks");function T(e,t){return{hook:e,message:`${g(e)} failed: ${t}`,next:E(e)}}c(T,"refusal");function ne(e){return E(e)}c(ne,"lifecycleHookAttribution");async function B(e,t,n){const r=e.event==="node:create"?N(e,t):I(e,t),s=D()?await J(e,t,JSON.stringify(r),n):await q(e,JSON.stringify(r),n);if(s.signal!==null)throw new Error(`executable was killed by signal ${s.signal}`);const o=K(s.stdout);return o.ok&&s.status!==0&&x(`crtr: ${g(e)} returned ok:true but exited ${s.status} (honoring the envelope)`),o}c(B,"executeLifecycleHook");function I(e,t){return{protocolVersion:1,op:e.op,event:e.event,phase:e.phase,operationId:k(16).toString("hex"),node:t.node,runtime:t.runtime,context:{cwd:t.node.cwd}}}c(I,"nodeRequest");function N(e,t){return{protocolVersion:1,op:e.op,event:"node:create",phase:"before",operationId:k(16).toString("hex"),create:t.create,runtime:t.runtime,context:{cwd:t.create.cwd}}}c(N,"createRequest");async function J(e,t,n,r){const s=e.event==="node:create",o=s?t.create.cwd:t.node.cwd,a=s?void 0:t.node.id,u=s?t.app:(await A(a))?.grantee;if(!u)throw new Error(`missing app for lifecycle hook ${e.event}`);const i=C(o,t.runtime.profile,u),m=await G({...s?{app:u}:{nodeId:a},command:[e.executable,"--crtr-hook-protocol","1"],cwd:e.plugin.root,pluginRoot:e.plugin.root,env:i,stdin:n,stdoutBytes:P,stderrBytes:64*1024});let l;try{const p=await Promise.race([m.completion,new Promise((b,f)=>{l=setTimeout(()=>{m.stop().then(()=>f(new Error(`executable timed out after ${r}ms`)),f)},r)})]);if(p.stdoutTruncated)throw new Error("stdout exceeded the 10 MiB cap");return{stdout:p.stdout,status:p.exitCode,signal:p.signal}}finally{l&&clearTimeout(l)}}c(J,"runSandboxedLifecycleProcess");async function q(e,t,n){let r;try{r=_(e.executable,["--crtr-hook-protocol","1"],{cwd:e.plugin.root,env:process.env,stdio:["pipe","pipe","inherit"],...R()})}catch(s){throw new Error(`executable could not be run (${w(s)})`)}return new Promise((s,o)=>{let a=0;const u=[];let i,m=!1,l=!1,p=null,b=null,f;const y=c(()=>{if(!(!m||i!==void 0&&!l)){if(f!==void 0&&clearTimeout(f),i?.kind==="timeout")return o(new Error(`executable timed out after ${n}ms`));if(i?.kind==="output_limit")return o(new Error("stdout exceeded the 10 MiB cap"));if(i?.kind==="spawn")return o(new Error(`executable could not be run (${w(i.error)})`));if(i?.kind==="cleanup")return o(new Error(`executable cleanup failed (${w(i.error)})`));s({stdout:Buffer.concat(u).toString("utf8"),status:p,signal:b})}},"finish"),$=c(d=>{i===void 0&&(i=d,f!==void 0&&clearTimeout(f),V(r).then(()=>{l=!0,y()},h=>{i={kind:"cleanup",error:h},l=!0,y()}))},"terminate");r.stdout.on("data",d=>{if(a+=d.byteLength,a>P)return $({kind:"output_limit"});u.push(d)}),r.once("error",d=>{if(r.pid===void 0){i={kind:"spawn",error:d},m=!0,l=!0,y();return}$({kind:"spawn",error:d})}),r.once("close",(d,h)=>{p=d,b=h,m=!0,y()}),f=setTimeout(()=>$({kind:"timeout"}),n),r.stdin.end(t)})}c(q,"runLifecycleProcess");function K(e){let t;try{t=JSON.parse(e.trim())}catch{throw new Error("stdout was not a single JSON envelope")}if(!L(t)||t.protocolVersion!==1)throw new Error("stdout was not a protocolVersion: 1 envelope");if(t.ok===!0&&v(t,["protocolVersion","ok"]))return{protocolVersion:1,ok:!0};if(t.ok!==!1||!v(t,["protocolVersion","ok","error"]))throw new Error("response envelope had missing or extra fields");const n=t.error;if(!L(n)||!v(n,["code","message"],["next"])||typeof n.code!="string"||n.code===""||typeof n.message!="string"||n.message===""||n.next!==void 0&&typeof n.next!="string")throw new Error("failure envelope had invalid error fields");return{protocolVersion:1,ok:!1,error:{code:n.code,message:n.message,...n.next===void 0?{}:{next:n.next}}}}c(K,"parseEnvelope");function v(e,t,n=[]){return t.every(r=>Object.hasOwn(e,r))&&Object.keys(e).every(r=>t.includes(r)||n.includes(r))}c(v,"exactKeys");function g(e){return`plugin "${e.plugin.name}" lifecycle hook "${e.op}" for ${e.event}`}c(g,"label");function E(e){return`Refused by plugin ${e.plugin.name}, op ${e.op}.`}c(E,"attribution");function w(e){return e instanceof Error?e.message:String(e)}c(w,"describeError");export{re as invokeBlockingLifecycleHooks,H as invokeLifecycleHook,te as invokeLifecycleHooks,ne as lifecycleHookAttribution};

package/dist/core/conversation-store/file-store.d.ts

@@ -15,16 +15,16 @@ export type ConversationWrite = {
     kind: 'replace';
 };
 /** One coherent write: the canvas step, `write()` (returns the new file size), then commit. */
-export type AppendSection = (conversationId: string, change: ConversationWrite, write: () => number) => void;
+export type AppendSection = (conversationId: string, change: ConversationWrite, write: () => number) => Promise<void>;
 /** The canvas side of the store: the write section, and each conversation's current owner. */
 export interface ConversationCanvas {
     appendSection: AppendSection;
-    owners(): Map<string, string>;
-    createPath?(nodeId: string, header: SessionHeader): string;
-    pathFor?(id: string): string | undefined;
-    repair?(id: string, path: string): void;
-    abortCreate?(id: string): void;
-    delete?(id: string): void;
+    owners(): Promise<Map<string, string>>;
+    createPath?(nodeId: string, header: SessionHeader): Promise<string>;
+    pathFor?(id: string): Promise<string | undefined>;
+    repair?(id: string, path: string): Promise<void>;
+    abortCreate?(id: string): Promise<void>;
+    delete?(id: string): Promise<void>;
 }
 export declare function sessionDirectory(root: string, cwd: string): string;
 export declare function createFileStore(root: string, canvas: ConversationCanvas): ConversationStore & {

package/dist/core/conversation-store/file-store.js

@@ -1,9 +1,9 @@
-var G=Object.defineProperty;var u=(l,c)=>G(l,"name",{value:c,configurable:!0});import{randomUUID as J}from"node:crypto";import{closeSync as v,createReadStream as K,existsSync as $,fsyncSync as k,mkdirSync as L,openSync as z,readFileSync as P,readSync as M,renameSync as Q,statSync as S,unlinkSync as O,writeFileSync as j}from"node:fs";import{createInterface as T}from"node:readline";import{dirname as V,join as F,relative as X,resolve as b}from"node:path";import{SessionManager as Y}from"@earendil-works/pi-coding-agent";import{ConversationNotFoundError as Z}from"./index.js";function E(l){const c=[];for(const p of l.split(`
-`))if(p.trim())try{c.push(JSON.parse(p))}catch{}return c}u(E,"parseLines");function I(l){const c=z(l,"r");try{const p=Buffer.allocUnsafe(4096);let f="";for(;;){const w=M(c,p,0,p.length,null);f+=p.toString("utf8",0,w);let m=f.indexOf(`
-`);for(;m!==-1||w===0;){const y=m===-1?f:f.slice(0,m),[h]=E(y);if(h!==void 0)return h;if(m===-1)return;f=f.slice(m+1),m=f.indexOf(`
-`)}}}finally{v(c)}}u(I,"firstLine");function ee(l,c){const p=z(l,"r");try{const f=Buffer.alloc(1);return M(p,f,0,1,c-1),f[0]}finally{v(p)}}u(ee,"lastByte");function C(l,c){return[l,...c].map(p=>`${JSON.stringify(p)}
-`).join("")}u(C,"lines");function W(l,c){const p=`--${b(c).replace(/^[/\\]/,"").replace(/[/\\:]/g,"-")}--`;return F(l,p)}u(W,"sessionDirectory");function A(l){return`${l.timestamp.replace(/[:.]/g,"-")}_${l.id}.jsonl`}u(A,"fileName");function ae(l,c){const{appendSection:p}=c,f=new Map,w=new Map;L(l,{recursive:!0,mode:448});const m=new Set;function y(e){if(m.has(e))return;const t=h(e);if(c.repair?.(e,t),!$(t)){f.delete(e),w.delete(e);return}m.add(e)}u(y,"repair");function h(e){const t=f.get(e)??c.pathFor?.(e);if(!t)throw new Z(e);return f.set(e,t),t}u(h,"pathFor");function x(e){y(e);const t=h(e),r=E(P(t,"utf8")),n=r.shift();if(n?.type!=="session"||n.id!==e)throw new Error(`invalid conversation: ${e}`);return{header:n,entries:r,path:t}}u(x,"read");function B(e,t){const r=I(t);return r?.type==="session"&&r.id===e?r:void 0}u(B,"validHeader");function N(e){const t=h(e),r=B(e,t);if(!r)throw new Error(`invalid conversation: ${e}`);return{header:r,path:t}}u(N,"headerOf");function H(e,t){y(e);const{header:r,path:n}=N(e),a=S(n).size;if(a<=t.head+t.tail)return x(e);const i=z(n,"r");try{const o=u((R,_)=>{if(_<=0)return[];const U=Buffer.allocUnsafe(_),q=M(i,U,0,_,R);return U.subarray(0,q).toString("utf8").split(`
-`)},"slice"),s=o(0,t.head),d=o(a-t.tail,t.tail);s.pop(),d.shift();const g=E(s.join(`
-`));return g[0]?.type==="session"&&g.shift(),{header:r,entries:g,tail:E(d.join(`
-`)),path:n}}finally{v(i)}}u(H,"readWindow");function D(e,t,r,n,a){if(f.has(t.id))throw new Error(`conversation already exists: ${t.id}`);const i=X(l,n);if(i.startsWith("..")||i===""||b(n)===b(l))throw new Error("conversation path outside store root");if(L(V(n),{recursive:!0,mode:448}),$(n))throw new Error(`conversation file already exists: ${n}`);let o=!1;try{const s=u(()=>{const d=z(n,"wx",384);o=!0;try{return j(d,C(t,r)),k(d),o=!1,S(n).size}finally{v(d)}},"write");return e===void 0?s():p(t.id,{kind:"create",nodeId:e,path:n,entries:r,...a?{sourceId:a}:{}},s),f.set(t.id,n),t.id}catch(s){throw o||!$(n)?($(n)&&O(n),c.abortCreate?.(t.id)):f.set(t.id,n),s}}return u(D,"createAt"),{recover(e){for(const t of e){if(!t.transcript_path)continue;const r=f.get(t.session_id);if(r&&r!==t.transcript_path)throw new Error(`conflicting conversation paths: ${t.session_id}`);f.set(t.session_id,t.transcript_path)}},repair:y,readLines(e){y(e);const t=h(e),r=T({input:K(t),crlfDelay:1/0});return{path:t,lines:r}},create(e,t,r,n){return D(e,t,r,c.createPath?.(e,t)??n??F(W(l,t.cwd),A(t)))},append(e,t,r){if(t.length===0)return;y(e);const n=h(e);if(r?.dedupe){const i=new Set(x(e).entries.map(o=>o.id));if(t=t.filter(o=>!i.has(o.id)),t.length===0)return}const a=S(n).size;if(a>0&&ee(n,a)!==10)throw new Error(`incomplete conversation tail: ${e}`);try{p(e,{kind:"append",entries:t},()=>{const i=z(n,"a");try{return j(i,t.map(o=>`${JSON.stringify(o)}
-`).join("")),k(i),S(n).size}finally{v(i)}})}catch(i){throw m.delete(e),i}},replace(e,t,r){y(e);const n=h(e);if(t.id!==e)throw new Error("replacement header id differs from conversation id");const a=P(n),i=u(s=>{const d=`${n}.${J()}.tmp`;try{j(d,s,{flag:"wx",mode:384});const g=z(d,"r");try{k(g)}finally{v(g)}Q(d,n)}finally{$(d)&&O(d)}},"swap");let o=!1;try{p(e,{kind:"replace"},()=>(i(C(t,r)),o=!0,S(n).size))}catch(s){throw o&&i(a),s}finally{w.delete(e)}},read(e,t){return t?H(e,t):x(e)},header(e){y(e);const{header:t,path:r}=N(e),n=S(r);return{header:t,path:r,mtime:n.mtimeMs,size:n.size}},fork(e,t,r,n){const a=x(e);let i=a.entries;if(r!==void 0){const d=Y.inMemory(a.header.cwd,void 0,[a.header,...i]);d.createBranchedSession(r),i=d.getEntries()}const o=new Date().toISOString(),s={...a.header,id:J(),timestamp:o,cwd:n??a.header.cwd,parentSession:a.path};return D(t,s,i,t&&c.createPath?c.createPath(t,s):F(W(l,s.cwd),A(s)),e)},list(e){const t=[],r=c.owners();for(const n of new Set([...f.keys(),...r.keys()])){const a=r.get(n);if(e!==void 0&&a!==e||(y(n),!f.has(n)))continue;const i=h(n),o=S(i);let s=w.get(n);(!s||s.mtime!==o.mtimeMs||s.size!==o.size)&&(s={mtime:o.mtimeMs,size:o.size,header:B(n,i)},w.set(n,s)),s.header&&t.push({conversation_id:n,...a?{node_id:a}:{},header:s.header,mtime:o.mtimeMs,size:o.size,path:i})}return t.sort((n,a)=>a.mtime-n.mtime)},delete(e){O(h(e)),c.delete?.(e),f.delete(e),m.delete(e),w.delete(e)}}}u(ae,"createFileStore");export{ae as createFileStore,W as sessionDirectory};
+var G=Object.defineProperty;var u=(l,o)=>G(l,"name",{value:o,configurable:!0});import{randomUUID as J}from"node:crypto";import{closeSync as v,createReadStream as K,existsSync as $,fsyncSync as k,mkdirSync as L,openSync as z,readFileSync as P,readSync as M,renameSync as Q,statSync as S,unlinkSync as O,writeFileSync as j}from"node:fs";import{createInterface as T}from"node:readline";import{dirname as V,join as F,relative as X,resolve as b}from"node:path";import{SessionManager as Y}from"@earendil-works/pi-coding-agent";import{ConversationNotFoundError as Z}from"./index.js";function E(l){const o=[];for(const w of l.split(`
+`))if(w.trim())try{o.push(JSON.parse(w))}catch{}return o}u(E,"parseLines");function I(l){const o=z(l,"r");try{const w=Buffer.allocUnsafe(4096);let f="";for(;;){const h=M(o,w,0,w.length,null);f+=w.toString("utf8",0,h);let y=f.indexOf(`
+`);for(;y!==-1||h===0;){const m=y===-1?f:f.slice(0,y),[d]=E(m);if(d!==void 0)return d;if(y===-1)return;f=f.slice(y+1),y=f.indexOf(`
+`)}}}finally{v(o)}}u(I,"firstLine");function ee(l,o){const w=z(l,"r");try{const f=Buffer.alloc(1);return M(w,f,0,1,o-1),f[0]}finally{v(w)}}u(ee,"lastByte");function C(l,o){return[l,...o].map(w=>`${JSON.stringify(w)}
+`).join("")}u(C,"lines");function W(l,o){const w=`--${b(o).replace(/^[/\\]/,"").replace(/[/\\:]/g,"-")}--`;return F(l,w)}u(W,"sessionDirectory");function A(l){return`${l.timestamp.replace(/[:.]/g,"-")}_${l.id}.jsonl`}u(A,"fileName");function ce(l,o){const{appendSection:w}=o,f=new Map,h=new Map;L(l,{recursive:!0,mode:448});const y=new Set;async function m(e){if(y.has(e))return;const t=await d(e);if(await o.repair?.(e,t),!$(t)){f.delete(e),h.delete(e);return}y.add(e)}u(m,"repair");async function d(e){const t=f.get(e)??await o.pathFor?.(e);if(!t)throw new Z(e);return f.set(e,t),t}u(d,"pathFor");async function x(e){await m(e);const t=await d(e),r=E(P(t,"utf8")),n=r.shift();if(n?.type!=="session"||n.id!==e)throw new Error(`invalid conversation: ${e}`);return{header:n,entries:r,path:t}}u(x,"read");function B(e,t){const r=I(t);return r?.type==="session"&&r.id===e?r:void 0}u(B,"validHeader");async function N(e){const t=await d(e),r=B(e,t);if(!r)throw new Error(`invalid conversation: ${e}`);return{header:r,path:t}}u(N,"headerOf");async function H(e,t){await m(e);const{header:r,path:n}=await N(e),c=S(n).size;if(c<=t.head+t.tail)return await x(e);const i=z(n,"r");try{const a=u((R,_)=>{if(_<=0)return[];const U=Buffer.allocUnsafe(_),q=M(i,U,0,_,R);return U.subarray(0,q).toString("utf8").split(`
+`)},"slice"),s=a(0,t.head),p=a(c-t.tail,t.tail);s.pop(),p.shift();const g=E(s.join(`
+`));return g[0]?.type==="session"&&g.shift(),{header:r,entries:g,tail:E(p.join(`
+`)),path:n}}finally{v(i)}}u(H,"readWindow");async function D(e,t,r,n,c){if(f.has(t.id))throw new Error(`conversation already exists: ${t.id}`);const i=X(l,n);if(i.startsWith("..")||i===""||b(n)===b(l))throw new Error("conversation path outside store root");if(L(V(n),{recursive:!0,mode:448}),$(n))throw new Error(`conversation file already exists: ${n}`);let a=!1;try{const s=u(()=>{const p=z(n,"wx",384);a=!0;try{return j(p,C(t,r)),k(p),a=!1,S(n).size}finally{v(p)}},"write");return e===void 0?s():await w(t.id,{kind:"create",nodeId:e,path:n,entries:r,...c?{sourceId:c}:{}},s),f.set(t.id,n),t.id}catch(s){throw a||!$(n)?($(n)&&O(n),await o.abortCreate?.(t.id)):f.set(t.id,n),s}}return u(D,"createAt"),{recover(e){for(const t of e){if(!t.transcript_path)continue;const r=f.get(t.session_id);if(r&&r!==t.transcript_path)throw new Error(`conflicting conversation paths: ${t.session_id}`);f.set(t.session_id,t.transcript_path)}},repair:m,async readLines(e){await m(e);const t=await d(e),r=T({input:K(t),crlfDelay:1/0});return{path:t,lines:r}},async create(e,t,r,n){return await D(e,t,r,await o.createPath?.(e,t)??n??F(W(l,t.cwd),A(t)))},async append(e,t,r){if(t.length===0)return;await m(e);const n=await d(e);if(r?.dedupe){const i=new Set((await x(e)).entries.map(a=>a.id));if(t=t.filter(a=>!i.has(a.id)),t.length===0)return}const c=S(n).size;if(c>0&&ee(n,c)!==10)throw new Error(`incomplete conversation tail: ${e}`);try{await w(e,{kind:"append",entries:t},()=>{const i=z(n,"a");try{return j(i,t.map(a=>`${JSON.stringify(a)}
+`).join("")),k(i),S(n).size}finally{v(i)}})}catch(i){throw y.delete(e),i}},async replace(e,t,r){await m(e);const n=await d(e);if(t.id!==e)throw new Error("replacement header id differs from conversation id");const c=P(n),i=u(s=>{const p=`${n}.${J()}.tmp`;try{j(p,s,{flag:"wx",mode:384});const g=z(p,"r");try{k(g)}finally{v(g)}Q(p,n)}finally{$(p)&&O(p)}},"swap");let a=!1;try{await w(e,{kind:"replace"},()=>(i(C(t,r)),a=!0,S(n).size))}catch(s){throw a&&i(c),s}finally{h.delete(e)}},async read(e,t){return t?await H(e,t):await x(e)},async header(e){await m(e);const{header:t,path:r}=await N(e),n=S(r);return{header:t,path:r,mtime:n.mtimeMs,size:n.size}},async fork(e,t,r,n){const c=await x(e);let i=c.entries;if(r!==void 0){const p=Y.inMemory(c.header.cwd,void 0,[c.header,...i]);p.createBranchedSession(r),i=p.getEntries()}const a=new Date().toISOString(),s={...c.header,id:J(),timestamp:a,cwd:n??c.header.cwd,parentSession:c.path};return await D(t,s,i,t&&o.createPath?await o.createPath(t,s):F(W(l,s.cwd),A(s)),e)},async list(e){const t=[],r=await o.owners();for(const n of new Set([...f.keys(),...r.keys()])){const c=r.get(n);if(e!==void 0&&c!==e||(await m(n),!f.has(n)))continue;const i=await d(n),a=S(i);let s=h.get(n);(!s||s.mtime!==a.mtimeMs||s.size!==a.size)&&(s={mtime:a.mtimeMs,size:a.size,header:B(n,i)},h.set(n,s)),s.header&&t.push({conversation_id:n,...c?{node_id:c}:{},header:s.header,mtime:a.mtimeMs,size:a.size,path:i})}return t.sort((n,c)=>c.mtime-n.mtime)},async delete(e){O(await d(e)),await o.delete?.(e),f.delete(e),y.delete(e),h.delete(e)}}}u(ce,"createFileStore");export{ce as createFileStore,W as sessionDirectory};

package/dist/core/conversation-store/index.d.ts

@@ -54,41 +54,43 @@ export interface ConversationStoreClient {
 }
 /** The daemon's file store (`createFileStore`, installed by `sessions.ts`). */
 export interface ConversationStore {
-    create(nodeId: string, header: SessionHeader, entries: SessionEntry[], path?: string): string;
+    create(nodeId: string, header: SessionHeader, entries: SessionEntry[], path?: string): Promise<string>;
     append(id: string, entries: SessionEntry[], options?: {
         dedupe?: boolean;
-    }): void;
-    replace(id: string, header: SessionHeader, entries: SessionEntry[]): void;
-    read(id: string, window?: ConversationWindow): {
+    }): Promise<void>;
+    replace(id: string, header: SessionHeader, entries: SessionEntry[]): Promise<void>;
+    read(id: string, window?: ConversationWindow): Promise<{
         header: SessionHeader;
         entries: SessionEntry[];
         tail?: SessionEntry[];
         path: string;
-    };
+    }>;
     /** Stream a complete conversation without blocking the daemon on a full-file read. */
-    readLines?(id: string): {
+    readLines?(id: string): Promise<{
         path: string;
         lines: AsyncIterable<string>;
-    };
-    header(id: string): {
+    }>;
+    header(id: string): Promise<{
         header: SessionHeader;
         mtime: number;
         size: number;
         path: string;
-    };
-    fork(id: string, nodeId?: string, leafId?: string, cwd?: string): string;
-    list(nodeId?: string): ConversationInfo[];
-    delete(id: string): void;
+    }>;
+    fork(id: string, nodeId?: string, leafId?: string, cwd?: string): Promise<string>;
+    list(nodeId?: string): Promise<ConversationInfo[]>;
+    delete(id: string): Promise<void>;
 }
 export declare function conversationIdFromPath(path: string): string | null;
 export declare function defaultConversationRoot(): string;
 export declare function storeAddress(): string;
 export declare function installConversationStore(store: ConversationStore | undefined): void;
+/** The installed store, else the client over the store socket with each call awaited. */
 export declare function conversationStore(): ConversationStore;
-/** The synchronous store pi's `SessionManager` statics call: the installed store, else the client over the store socket. */
+/** The synchronous store pi's `SessionManager` statics call: always the client over the store socket (the installed
+ *  store is async, so it cannot serve a synchronous caller). */
 export declare function conversationClient(): ConversationStoreClient;
 /** Read a conversation without parking the event loop on the store worker. */
-export declare function readConversationAsync(id: string, window?: ConversationWindow): Promise<ReturnType<ConversationStore['read']>>;
+export declare function readConversationAsync(id: string, window?: ConversationWindow): Promise<Awaited<ReturnType<ConversationStore['read']>>>;
 export { createFileStore, sessionDirectory, type AppendSection, type ConversationCanvas, type ConversationWrite } from './file-store.js';
 export { installSessionManagerStorePatch } from './patch.js';
 export { findOrphanedParents, relinkOrphanedParents, repairConversationFile, type FileRepair, type OrphanRelink } from './repair.js';

package/dist/core/conversation-store/index.js

@@ -1 +1 @@
-var a=Object.defineProperty;var r=(o,t)=>a(o,"name",{value:t,configurable:!0});import{appsRoot as c,socketDir as u}from"../layout.js";import{join as f}from"node:path";import{createStoreClient as p}from"./client.js";import{currentNodeToken as d}from"../runtime/broker/node-token.js";class l extends Error{static{r(this,"ConversationNotFoundError")}code="not_found";constructor(t){super(`conversation not found: ${t}`)}}function R(o){return o instanceof l}r(R,"isConversationNotFound");function y(o){return/(?:^|\/)[^/]+_([0-9a-f-]{36})\.jsonl$/i.exec(o)?.[1]??null}r(y,"conversationIdFromPath");function A(){return c()}r(A,"defaultConversationRoot");function m(){return process.env.CRTR_STORE_ADDRESS||f(u(),"store.sock")}r(m,"storeAddress");let n,s;function F(o){n=o}r(F,"installConversationStore");function k(){return i()}r(k,"conversationStore");function i(){if(n)return n;const o=m();return s?.address!==o&&(s={address:o,store:p(o,d())}),s.store}r(i,"conversationClient");async function D(o,t){const e=i();return e.readAsync?e.readAsync(o,t):e.read(o,t)}r(D,"readConversationAsync");import{createFileStore as _,sessionDirectory as N}from"./file-store.js";import{installSessionManagerStorePatch as T}from"./patch.js";import{findOrphanedParents as $,relinkOrphanedParents as g,repairConversationFile as I}from"./repair.js";export{l as ConversationNotFoundError,i as conversationClient,y as conversationIdFromPath,k as conversationStore,_ as createFileStore,A as defaultConversationRoot,$ as findOrphanedParents,F as installConversationStore,T as installSessionManagerStorePatch,R as isConversationNotFound,D as readConversationAsync,g as relinkOrphanedParents,I as repairConversationFile,N as sessionDirectory,m as storeAddress};
+var c=Object.defineProperty;var o=(e,r)=>c(e,"name",{value:r,configurable:!0});import{appsRoot as i,socketDir as p}from"../layout.js";import{join as d}from"node:path";import{createStoreClient as f}from"./client.js";import{currentNodeToken as u}from"../runtime/broker/node-token.js";class l extends Error{static{o(this,"ConversationNotFoundError")}code="not_found";constructor(r){super(`conversation not found: ${r}`)}}function h(e){return e instanceof l}o(h,"isConversationNotFound");function k(e){return/(?:^|\/)[^/]+_([0-9a-f-]{36})\.jsonl$/i.exec(e)?.[1]??null}o(k,"conversationIdFromPath");function R(){return i()}o(R,"defaultConversationRoot");function m(){return process.env.CRTR_STORE_ADDRESS||d(p(),"store.sock")}o(m,"storeAddress");let t,s;function A(e){t=e}o(A,"installConversationStore");function F(){if(t)return t;const e=a();return{create:o(async(...r)=>e.create(...r),"create"),append:o(async(...r)=>e.append(...r),"append"),replace:o(async(...r)=>e.replace(...r),"replace"),read:o(async(...r)=>e.read(...r),"read"),header:o(async(...r)=>e.header(...r),"header"),fork:o(async(...r)=>e.fork(...r),"fork"),list:o(async(...r)=>e.list(...r),"list"),delete:o(async(...r)=>e.delete(...r),"delete")}}o(F,"conversationStore");function a(){const e=m();return s?.address!==e&&(s={address:e,store:f(e,u())}),s.store}o(a,"conversationClient");async function D(e,r){if(t)return t.read(e,r);const n=a();return n.readAsync?n.readAsync(e,r):n.read(e,r)}o(D,"readConversationAsync");import{createFileStore as _,sessionDirectory as N}from"./file-store.js";import{installSessionManagerStorePatch as T}from"./patch.js";import{findOrphanedParents as $,relinkOrphanedParents as g,repairConversationFile as I}from"./repair.js";export{l as ConversationNotFoundError,a as conversationClient,k as conversationIdFromPath,F as conversationStore,_ as createFileStore,R as defaultConversationRoot,$ as findOrphanedParents,A as installConversationStore,T as installSessionManagerStorePatch,h as isConversationNotFound,D as readConversationAsync,g as relinkOrphanedParents,I as repairConversationFile,N as sessionDirectory,m as storeAddress};

package/dist/core/conversation-store/listener.js

@@ -1,8 +1,8 @@
-var O=Object.defineProperty;var v=(r,t)=>O(r,"name",{value:t,configurable:!0});import{createServer as _}from"node:http";import{chmodSync as k,existsSync as N,unlinkSync as T}from"node:fs";import{isConversationNotFound as b}from"./index.js";import{resolveNodeToken as j}from"../canvas/node-tokens.js";import{conversationOwner as H}from"../canvas/sessions.js";import{peerUid as J}from"../../native/linux.js";async function x(r){const t=[];for await(const s of r)t.push(Buffer.from(s));return JSON.parse(Buffer.concat(t).toString("utf8"))}v(x,"body");function l(r,t,s){r.writeHead(t,{"content-type":"application/json"}),r.end(JSON.stringify(s))}v(l,"json");async function P(r,t,s){if(!t.readLines){const f=t.read(s);r.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":f.path}),r.end([f.header,...f.entries].map(d=>JSON.stringify(d)).join(`
+var O=Object.defineProperty;var v=(o,n)=>O(o,"name",{value:n,configurable:!0});import{createServer as _}from"node:http";import{chmodSync as k,existsSync as N,unlinkSync as T}from"node:fs";import{isConversationNotFound as b}from"./index.js";import{resolveNodeToken as j}from"../canvas/node-tokens.js";import{conversationOwner as H}from"../canvas/sessions.js";import{peerUid as J}from"../../native/linux.js";async function x(o){const n=[];for await(const s of o)n.push(Buffer.from(s));return JSON.parse(Buffer.concat(n).toString("utf8"))}v(x,"body");function l(o,n,s){o.writeHead(n,{"content-type":"application/json"}),o.end(JSON.stringify(s))}v(l,"json");async function P(o,n,s){if(!n.readLines){const f=await n.read(s);o.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":f.path}),o.end([f.header,...f.entries].map(d=>JSON.stringify(d)).join(`
 `)+`
-`);return}const{path:i,lines:e}=t.readLines(s);let a=!1,c=0;for await(const f of e){if(!f.trim())continue;let d;try{d=JSON.parse(f)}catch{continue}if(!a){if(d.type!=="session"||d.id!==s)throw new Error(`invalid conversation: ${s}`);r.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":i}),a=!0}const S=JSON.stringify(d)+`
-`;c+=Buffer.byteLength(S),c>=256*1024?(c=0,await new Promise((p,u)=>r.write(S,m=>m?u(m):p()))):r.write(S)}if(!a)throw new Error(`invalid conversation: ${s}`);r.end()}v(P,"fullRead");async function C(r,t){const s=_(async(i,e)=>{try{const a=i.headers.authorization,c=typeof a=="string"&&a.startsWith("Bearer ")?j(a.slice(7)):null,f=new URL(i.url??"/","http://store"),d=f.pathname.split("/").filter(Boolean);if(a===void 0&&process.platform!=="linux"&&i.method==="GET"&&d[0]==="conversations"&&(d.length===1||d.length===2||d.length===3&&d[2]==="header")){const n=d[1];if(!n)l(e,200,{conversations:t.list(f.searchParams.get("node_id")??void 0)});else if(d[2]==="header")l(e,200,t.header(n));else{const y=f.searchParams.get("head"),h=f.searchParams.get("tail");if(y===null||h===null)await P(e,t,n);else{const g=t.read(n,{head:Number(y),tail:Number(h)});e.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":g.path,...g.tail?{"x-conversation-tail":String(1+g.entries.length)}:{}}),e.end([g.header,...g.entries,...g.tail??[]].map(E=>JSON.stringify(E)).join(`
+`);return}const{path:a,lines:e}=await n.readLines(s);let r=!1,c=0;for await(const f of e){if(!f.trim())continue;let d;try{d=JSON.parse(f)}catch{continue}if(!r){if(d.type!=="session"||d.id!==s)throw new Error(`invalid conversation: ${s}`);o.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":a}),r=!0}const S=JSON.stringify(d)+`
+`;c+=Buffer.byteLength(S),c>=256*1024?(c=0,await new Promise((p,u)=>o.write(S,w=>w?u(w):p()))):o.write(S)}if(!r)throw new Error(`invalid conversation: ${s}`);o.end()}v(P,"fullRead");async function C(o,n){const s=_(async(a,e)=>{try{const r=a.headers.authorization,c=typeof r=="string"&&r.startsWith("Bearer ")?await j(r.slice(7)):null,f=new URL(a.url??"/","http://store"),d=f.pathname.split("/").filter(Boolean);if(r===void 0&&process.platform!=="linux"&&a.method==="GET"&&d[0]==="conversations"&&(d.length===1||d.length===2||d.length===3&&d[2]==="header")){const t=d[1];if(!t)l(e,200,{conversations:await n.list(f.searchParams.get("node_id")??void 0)});else if(d[2]==="header")l(e,200,await n.header(t));else{const y=f.searchParams.get("head"),h=f.searchParams.get("tail");if(y===null||h===null)await P(e,n,t);else{const g=await n.read(t,{head:Number(y),tail:Number(h)});e.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":g.path,...g.tail?{"x-conversation-tail":String(1+g.entries.length)}:{}}),e.end([g.header,...g.entries,...g.tail??[]].map(E=>JSON.stringify(E)).join(`
 `)+`
-`)}}return}if(!c){l(e,401,{error:"unauthorized"});return}if(process.platform==="linux"){let n;try{n=J(i.socket)}catch{l(e,401,{error:"unauthorized"});return}if(n!==c.uid){l(e,401,{error:"unauthorized"});return}}const p=v(n=>H(n)===c.node,"owns"),u=v(()=>l(e,404,{error:"not_found"}),"notFound"),m=new URL(i.url??"/","http://store"),w=m.pathname.split("/").filter(Boolean);if(w[0]!=="conversations"){l(e,404,{error:"not_found"});return}const o=w[1];if(!o&&i.method==="POST"){const n=await x(i);if(n.node_id!==c.node){u();return}l(e,201,{conversation_id:t.create(n.node_id,n.header,n.entries,n.path)})}else if(!o&&i.method==="GET"){if(m.searchParams.has("node_id")&&m.searchParams.get("node_id")!==c.node){u();return}l(e,200,{conversations:t.list(c.node)})}else if(o&&w[2]==="entries"&&i.method==="POST"){if(!p(o)){u();return}const n=await x(i);t.append(o,n.entries,n.dedupe===!0?{dedupe:!0}:void 0),e.writeHead(204).end()}else if(o&&w[2]==="header"&&i.method==="GET"){if(!p(o)){u();return}l(e,200,t.header(o))}else if(o&&w[2]==="fork"&&i.method==="POST"){if(!p(o)){u();return}const n=await x(i);if(n.node_id!==c.node){u();return}l(e,201,{conversation_id:t.fork(o,c.node,n.leaf_id,n.cwd)})}else if(o&&w.length===2&&i.method==="GET"){if(!p(o)){u();return}const n=m.searchParams.get("head"),y=m.searchParams.get("tail");if(n===null||y===null)await P(e,t,o);else{const h=t.read(o,{head:Number(n),tail:Number(y)});e.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":h.path,...h.tail?{"x-conversation-tail":String(1+h.entries.length)}:{}}),e.end([h.header,...h.entries,...h.tail??[]].map(g=>JSON.stringify(g)).join(`
+`)}}return}if(!c){l(e,401,{error:"unauthorized"});return}if(process.platform==="linux"){let t;try{t=J(a.socket)}catch{l(e,401,{error:"unauthorized"});return}if(t!==c.uid){l(e,401,{error:"unauthorized"});return}}const p=v(async t=>await H(t)===c.node,"owns"),u=v(()=>l(e,404,{error:"not_found"}),"notFound"),w=new URL(a.url??"/","http://store"),m=w.pathname.split("/").filter(Boolean);if(m[0]!=="conversations"){l(e,404,{error:"not_found"});return}const i=m[1];if(!i&&a.method==="POST"){const t=await x(a);if(t.node_id!==c.node){u();return}l(e,201,{conversation_id:await n.create(t.node_id,t.header,t.entries,t.path)})}else if(!i&&a.method==="GET"){if(w.searchParams.has("node_id")&&w.searchParams.get("node_id")!==c.node){u();return}l(e,200,{conversations:await n.list(c.node)})}else if(i&&m[2]==="entries"&&a.method==="POST"){if(!await p(i)){u();return}const t=await x(a);await n.append(i,t.entries,t.dedupe===!0?{dedupe:!0}:void 0),e.writeHead(204).end()}else if(i&&m[2]==="header"&&a.method==="GET"){if(!await p(i)){u();return}l(e,200,await n.header(i))}else if(i&&m[2]==="fork"&&a.method==="POST"){if(!await p(i)){u();return}const t=await x(a);if(t.node_id!==c.node){u();return}l(e,201,{conversation_id:await n.fork(i,c.node,t.leaf_id,t.cwd)})}else if(i&&m.length===2&&a.method==="GET"){if(!await p(i)){u();return}const t=w.searchParams.get("head"),y=w.searchParams.get("tail");if(t===null||y===null)await P(e,n,i);else{const h=await n.read(i,{head:Number(t),tail:Number(y)});e.writeHead(200,{"content-type":"application/x-ndjson","x-conversation-path":h.path,...h.tail?{"x-conversation-tail":String(1+h.entries.length)}:{}}),e.end([h.header,...h.entries,...h.tail??[]].map(g=>JSON.stringify(g)).join(`
 `)+`
-`)}}else if(o&&w.length===2&&i.method==="PUT"){if(!p(o)){u();return}const n=await x(i);t.replace(o,n.header,n.entries),e.writeHead(204).end()}else if(o&&w.length===2&&i.method==="DELETE"){if(!p(o)){u();return}t.delete(o),e.writeHead(204).end()}else l(e,404,{error:"not_found"})}catch(a){const c=a instanceof Error?a.message:String(a);e.headersSent?e.destroy(a instanceof Error?a:new Error(c)):l(e,b(a)?404:500,{error:c})}});if(N(r)&&T(r),await new Promise((i,e)=>{s.once("error",e),s.listen(r,()=>{s.off("error",e),i()})}),typeof s.address()!="string")throw s.close(),new Error(`store listener must bind a unix socket: ${JSON.stringify(s.address())}`);return k(r,process.platform==="linux"&&N("/run/crtr/launcher.sock")?438:384),{close:v(()=>new Promise((i,e)=>s.close(a=>a?e(a):i())),"close")}}v(C,"listenConversationStore");export{C as listenConversationStore};
+`)}}else if(i&&m.length===2&&a.method==="PUT"){if(!await p(i)){u();return}const t=await x(a);await n.replace(i,t.header,t.entries),e.writeHead(204).end()}else if(i&&m.length===2&&a.method==="DELETE"){if(!await p(i)){u();return}await n.delete(i),e.writeHead(204).end()}else l(e,404,{error:"not_found"})}catch(r){const c=r instanceof Error?r.message:String(r);e.headersSent?e.destroy(r instanceof Error?r:new Error(c)):l(e,b(r)?404:500,{error:c})}});if(N(o)&&T(o),await new Promise((a,e)=>{s.once("error",e),s.listen(o,()=>{s.off("error",e),a()})}),typeof s.address()!="string")throw s.close(),new Error(`store listener must bind a unix socket: ${JSON.stringify(s.address())}`);return k(o,process.platform==="linux"&&N("/run/crtr/launcher.sock")?438:384),{close:v(()=>new Promise((a,e)=>s.close(r=>r?e(r):a())),"close")}}v(C,"listenConversationStore");export{C as listenConversationStore};

package/dist/core/conversation-store/patch.d.ts

@@ -1 +1,3 @@
-export declare function installSessionManagerStorePatch(nodeId: string): void;
+import { type ConversationStoreClient } from './index.js';
+/** `store` is the synchronous client pi's `SessionManager` needs: the broker's client over the store socket unless a caller supplies one. */
+export declare function installSessionManagerStorePatch(nodeId: string, store?: ConversationStoreClient): void;

package/dist/core/conversation-store/patch.js

@@ -1 +1 @@
-var P=Object.defineProperty;var h=(a,c)=>P(a,"name",{value:c,configurable:!0});import{dirname as E,resolve as A}from"node:path";import{SessionManager as w}from"@earendil-works/pi-coding-agent";import{conversationClient as R,conversationIdFromPath as O}from"./index.js";import{findOrphanedParents as T}from"./repair.js";import{emitEvent as I}from"../events/emit.js";const f=new WeakMap;function k(a){a>0&&Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,a)}h(k,"sleep");function C(){const a=Number(process.env.CRTR_CONVERSATION_APPEND_RETRY_MS);return Number.isFinite(a)&&a>=0?a:500}h(C,"retryDelayMs");let x=!1;function z(a){if(x)return;const c=w.prototype,d=w;for(const e of["_setSessionFile","_rewriteFile","_persist","createBranchedSession","newSession"])if(typeof c[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);for(const e of["create","open","continueRecent","forkFrom","findById","list","listAll"])if(typeof d[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);const M=c.createBranchedSession,y=c.newSession,o=R();function N(e,s){const t=T(s);t.length!==0&&I({level:"error",event:"conversation.orphaned_parent",fields:{conversation_id:e,orphan_count:t.length,orphans:t.slice(0,20).map(i=>({entry_id:i.entryId,missing_parent_id:i.missingParentId}))}})}h(N,"reportOrphans");function _(e,s){const{header:t,entries:i,path:r}=o.read(e);N(t.id,i);const n=w.inMemory(s??t.cwd);n.sessionFile=r,n.sessionDir=E(r),n._loadEntries([t,...i]),n.persist=!0,n.flushed=!0;const u=n.fileEntries[0];return u?.type==="session"&&u.version!==t.version&&n._rewriteFile(),n}h(_,"fromStore");function m(e){const[s,...t]=e.fileEntries;if(!s||s.type!=="session")throw new Error("conversation has no session header");o.create(a,s,t),e.sessionFile=o.header(s.id).path,e.sessionDir=E(e.sessionFile),e.flushed=!0,f.delete(e)}h(m,"persistNew");function B(e,s){const t=f.get(e)??{entries:[],ambiguous:!1};t.entries.push(s),f.set(e,t);let i;for(let r=0;r<2;r++){r>0&&k(C());try{o.append(e.sessionId,t.entries,t.ambiguous?{dedupe:!0}:void 0),f.delete(e);return}catch(n){i=n,t.ambiguous=!0}}throw I({level:"error",event:"conversation.append_failed",error:i,fields:{conversation_id:e.sessionId,pending_entries:t.entries.length}}),i}h(B,"appendInOrder");function g(e){const s=O(e);if(!s)throw new Error(`invalid conversation path: ${e}`);return s}h(g,"idOf"),c._setSessionFile=function(e){const{header:s,entries:t}=o.read(g(e));this.sessionFile=o.header(s.id).path,this.sessionDir=E(this.sessionFile),N(s.id,t),this._loadEntries([s,...t]),this.flushed=!0,f.delete(this)},c._rewriteFile=function(){if(!this.persist||!this.sessionFile)return;const[e,...s]=this.fileEntries;if(!e||e.type!=="session")throw new Error("conversation has no session header");o.replace(e.id,e,s),f.delete(this)},c._persist=function(e){!this.persist||!this.sessionFile||(this.flushed?B(this,e):m(this))},c.newSession=function(e){if(!this.persist)return y.call(this,e);const s=this.flushed&&this.fileEntries.length===1&&this.sessionFile!==void 0?this.sessionId:void 0;if(s!==void 0&&(e?.id===void 0||e.id===s)){const t=this.sessionFile;y.call(this,{...e,id:s});const i=this.fileEntries[0];if(!i||i.type!=="session")throw new Error("conversation has no session header");return o.replace(s,i,[]),this.sessionFile=t,this.flushed=!0,t}return y.call(this,e),m(this),this.sessionFile},c.createBranchedSession=function(e){if(!this.persist)return M.call(this,e);const s=this.sessionFile;this.persist=!1;try{M.call(this,e)}finally{this.persist=!0}const t=this.fileEntries[0];if(!t||t.type!=="session")throw new Error("branch has no header");return this.fileEntries[0]={...t,parentSession:s},m(this),this.sessionFile},d.create=(e,s,t)=>{const i=w.inMemory(e,t);return i.persist=!0,m(i),i},d.open=(e,s,t)=>_(g(e),t),d.continueRecent=e=>{const s=o.list().find(t=>t.header.cwd===A(e));return s?_(s.conversation_id,e):d.create(e)},d.forkFrom=(e,s)=>_(o.fork(g(e),a,void 0,s)),d.findById=(e,s)=>o.list().find(t=>t.conversation_id===s&&t.header.cwd===A(e))?.path;function b(e){return o.list().filter(s=>e===void 0||s.header.cwd===A(e)).map(s=>{let t,i=0,r="",n;const u=[];for(const p of o.read(s.conversation_id).entries){if(p.type==="session_info"&&(t=p.name?.trim()||void 0),p.type!=="message")continue;i++;const l=p.message;if(l.role!=="user"&&l.role!=="assistant")continue;const D=typeof l.timestamp=="number"?l.timestamp:Date.parse(p.timestamp);Number.isNaN(D)||(n=Math.max(n??0,D));const F=typeof l.content=="string"?l.content:Array.isArray(l.content)?l.content.filter(S=>S.type==="text").map(S=>S.text??"").join(" "):"";F&&(u.push(F),!r&&l.role==="user"&&(r=F))}const v=new Date(s.header.timestamp);return{path:s.path,id:s.conversation_id,cwd:s.header.cwd,...t?{name:t}:{},...s.header.parentSession?{parentSessionPath:s.header.parentSession}:{},created:v,modified:n&&n>0?new Date(n):Number.isNaN(v.getTime())?new Date(s.mtime):v,messageCount:i,firstMessage:r||"(no messages)",allMessagesText:u.join(" ")}})}h(b,"sessionInfos"),d.list=async(e,s,t,i)=>{i?.throwIfAborted();const r=b(e);return t?.(r.length,r.length,r),r},d.listAll=async(...e)=>(e.find(t=>t instanceof AbortSignal)?.throwIfAborted(),b()),x=!0}h(z,"installSessionManagerStorePatch");export{z as installSessionManagerStorePatch};
+var P=Object.defineProperty;var c=(a,r)=>P(a,"name",{value:r,configurable:!0});import{dirname as E,resolve as A}from"node:path";import{SessionManager as w}from"@earendil-works/pi-coding-agent";import{conversationClient as R,conversationIdFromPath as O}from"./index.js";import{findOrphanedParents as T}from"./repair.js";import{emitEvent as I}from"../events/emit.js";const f=new WeakMap;function k(a){a>0&&Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,a)}c(k,"sleep");function C(){const a=Number(process.env.CRTR_CONVERSATION_APPEND_RETRY_MS);return Number.isFinite(a)&&a>=0?a:500}c(C,"retryDelayMs");let x=!1;function z(a,r=R()){if(x)return;const l=w.prototype,h=w;for(const e of["_setSessionFile","_rewriteFile","_persist","createBranchedSession","newSession"])if(typeof l[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);for(const e of["create","open","continueRecent","forkFrom","findById","list","listAll"])if(typeof h[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);const M=l.createBranchedSession,y=l.newSession;function N(e,s){const t=T(s);t.length!==0&&I({level:"error",event:"conversation.orphaned_parent",fields:{conversation_id:e,orphan_count:t.length,orphans:t.slice(0,20).map(i=>({entry_id:i.entryId,missing_parent_id:i.missingParentId}))}})}c(N,"reportOrphans");function _(e,s){const{header:t,entries:i,path:o}=r.read(e);N(t.id,i);const n=w.inMemory(s??t.cwd);n.sessionFile=o,n.sessionDir=E(o),n._loadEntries([t,...i]),n.persist=!0,n.flushed=!0;const u=n.fileEntries[0];return u?.type==="session"&&u.version!==t.version&&n._rewriteFile(),n}c(_,"fromStore");function m(e){const[s,...t]=e.fileEntries;if(!s||s.type!=="session")throw new Error("conversation has no session header");r.create(a,s,t),e.sessionFile=r.header(s.id).path,e.sessionDir=E(e.sessionFile),e.flushed=!0,f.delete(e)}c(m,"persistNew");function B(e,s){const t=f.get(e)??{entries:[],ambiguous:!1};t.entries.push(s),f.set(e,t);let i;for(let o=0;o<2;o++){o>0&&k(C());try{r.append(e.sessionId,t.entries,t.ambiguous?{dedupe:!0}:void 0),f.delete(e);return}catch(n){i=n,t.ambiguous=!0}}throw I({level:"error",event:"conversation.append_failed",error:i,fields:{conversation_id:e.sessionId,pending_entries:t.entries.length}}),i}c(B,"appendInOrder");function g(e){const s=O(e);if(!s)throw new Error(`invalid conversation path: ${e}`);return s}c(g,"idOf"),l._setSessionFile=function(e){const{header:s,entries:t}=r.read(g(e));this.sessionFile=r.header(s.id).path,this.sessionDir=E(this.sessionFile),N(s.id,t),this._loadEntries([s,...t]),this.flushed=!0,f.delete(this)},l._rewriteFile=function(){if(!this.persist||!this.sessionFile)return;const[e,...s]=this.fileEntries;if(!e||e.type!=="session")throw new Error("conversation has no session header");r.replace(e.id,e,s),f.delete(this)},l._persist=function(e){!this.persist||!this.sessionFile||(this.flushed?B(this,e):m(this))},l.newSession=function(e){if(!this.persist)return y.call(this,e);const s=this.flushed&&this.fileEntries.length===1&&this.sessionFile!==void 0?this.sessionId:void 0;if(s!==void 0&&(e?.id===void 0||e.id===s)){const t=this.sessionFile;y.call(this,{...e,id:s});const i=this.fileEntries[0];if(!i||i.type!=="session")throw new Error("conversation has no session header");return r.replace(s,i,[]),this.sessionFile=t,this.flushed=!0,t}return y.call(this,e),m(this),this.sessionFile},l.createBranchedSession=function(e){if(!this.persist)return M.call(this,e);const s=this.sessionFile;this.persist=!1;try{M.call(this,e)}finally{this.persist=!0}const t=this.fileEntries[0];if(!t||t.type!=="session")throw new Error("branch has no header");return this.fileEntries[0]={...t,parentSession:s},m(this),this.sessionFile},h.create=(e,s,t)=>{const i=w.inMemory(e,t);return i.persist=!0,m(i),i},h.open=(e,s,t)=>_(g(e),t),h.continueRecent=e=>{const s=r.list().find(t=>t.header.cwd===A(e));return s?_(s.conversation_id,e):h.create(e)},h.forkFrom=(e,s)=>_(r.fork(g(e),a,void 0,s)),h.findById=(e,s)=>r.list().find(t=>t.conversation_id===s&&t.header.cwd===A(e))?.path;function b(e){return r.list().filter(s=>e===void 0||s.header.cwd===A(e)).map(s=>{let t,i=0,o="",n;const u=[];for(const p of r.read(s.conversation_id).entries){if(p.type==="session_info"&&(t=p.name?.trim()||void 0),p.type!=="message")continue;i++;const d=p.message;if(d.role!=="user"&&d.role!=="assistant")continue;const D=typeof d.timestamp=="number"?d.timestamp:Date.parse(p.timestamp);Number.isNaN(D)||(n=Math.max(n??0,D));const F=typeof d.content=="string"?d.content:Array.isArray(d.content)?d.content.filter(S=>S.type==="text").map(S=>S.text??"").join(" "):"";F&&(u.push(F),!o&&d.role==="user"&&(o=F))}const v=new Date(s.header.timestamp);return{path:s.path,id:s.conversation_id,cwd:s.header.cwd,...t?{name:t}:{},...s.header.parentSession?{parentSessionPath:s.header.parentSession}:{},created:v,modified:n&&n>0?new Date(n):Number.isNaN(v.getTime())?new Date(s.mtime):v,messageCount:i,firstMessage:o||"(no messages)",allMessagesText:u.join(" ")}})}c(b,"sessionInfos"),h.list=async(e,s,t,i)=>{i?.throwIfAborted();const o=b(e);return t?.(o.length,o.length,o),o},h.listAll=async(...e)=>(e.find(t=>t instanceof AbortSignal)?.throwIfAborted(),b()),x=!0}c(z,"installSessionManagerStorePatch");export{z as installSessionManagerStorePatch};

package/dist/core/feed/feed.js

@@ -1,4 +1,4 @@
-var N=Object.defineProperty;var i=(e,t)=>N(e,"name",{value:t,configurable:!0});import{prepared as p}from"../sqlite-statements.js";import{cancelCronsOnWake as $,getNode as h}from"../canvas/index.js";import{runStructuredRequestEffects as R,settleStructuredRequestIn as k}from"../canvas/structured-requests.js";import{openDb as y,withCanvasWrite as U}from"../canvas/db.js";import{randomUUID as b}from"node:crypto";import{composeNodeOutcomeDocument as q}from"../runtime/outcome-document.js";import{closeNode as A}from"../runtime/close.js";import{put as F}from"../graph/bodies.js";import{writeDocument as L}from"../graph/documents.js";import{asRuntimeWriter as W}from"../graph/spaces/own-memory.js";import{publish as C}from"../graph/events.js";import{nodeObject as v}from"../graph/objects.js";import{readerForNode as z}from"../graph/reader.js";import{endMessageSubscriptions as D}from"../graph/watches.js";import{operationIdContext as M}from"../events/operation-id.js";class B extends Error{static{i(this,"StructuredRequestFinalizationError")}state;constructor(t){super(t==="expired"?"structured_request_expired":"structured_request_settled"),this.state=t}}class g extends Error{static{i(this,"FinalizationError")}code;report;constructor(t,r){super(t),this.code=t,this.report=r}}function H(e){const t=i((r,n=2)=>String(r).padStart(n,"0"),"pad");return`${e.getUTCFullYear()}${t(e.getUTCMonth()+1)}${t(e.getUTCDate())}T${t(e.getUTCHours())}${t(e.getUTCMinutes())}${t(e.getUTCSeconds())}${t(e.getUTCMilliseconds(),3)}`}i(H,"compactTs");function O(e,t=80){const r=e.split(`
-`)[0]??"";return r.length>t?`${r.slice(0,t-1)}\u2026`:r}i(O,"firstLine");function j(e){return e.kind==="final"?{event:"report.final"}:e.result!==void 0?{event:"report.result"}:e.kind==="urgent"?{event:"report.update",level:7}:{event:"report.update",level:e.deliveryTier==="deferred"?3:e.deliveryTier==="urgent"?7:5}}i(j,"eventFor");function S(e,t,r){const n=r.from??t,o=`reports/${H(new Date)}-${b().slice(-8)}-${r.kind}`,u=v(e,t),a=v(e,n),{object:s}=L(e,W(z(e,n,()=>[])),{owner:u,kind:"report",name:o,preview:O(r.body)||r.kind,privacy:"public"},r.body),c=`${t}/${o}`,{event:_,level:m}=j(r);C(e,{event:_,object:u,actor:a,...m===void 0?{}:{level:m},attrs:{},pointer:s.id,messageBody:{kind:r.kind,label:O(r.body),bodyRef:c,...r.disposition===void 0?{}:{disposition:r.disposition}}});const l=p(e,`SELECT d.destination_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+var N=Object.defineProperty;var i=(e,t)=>N(e,"name",{value:t,configurable:!0});import{cancelCronsOnWake as O,getNode as E}from"../canvas/index.js";import{runStructuredRequestEffects as y,settleStructuredRequestIn as R}from"../canvas/structured-requests.js";import{openDb as q,withCanvasWrite as T}from"../canvas/db.js";import{randomUUID as x}from"node:crypto";import{composeNodeOutcomeDocument as F}from"../runtime/outcome-document.js";import{closeNode as M}from"../runtime/close.js";import{put as W}from"../graph/bodies.js";import{writeDocument as z}from"../graph/documents.js";import{asRuntimeWriter as A}from"../graph/spaces/own-memory.js";import{publish as k}from"../graph/events.js";import{nodeObject as v}from"../graph/objects.js";import{readerForNode as L}from"../graph/reader.js";import{endMessageSubscriptions as C}from"../graph/watches.js";import{operationIdContext as D}from"../events/operation-id.js";class H extends Error{static{i(this,"StructuredRequestFinalizationError")}state;constructor(t){super(t==="expired"?"structured_request_expired":"structured_request_settled"),this.state=t}}class h extends Error{static{i(this,"FinalizationError")}code;report;constructor(t,r){super(t),this.code=t,this.report=r}}function j(e){const t=i((r,n=2)=>String(r).padStart(n,"0"),"pad");return`${e.getUTCFullYear()}${t(e.getUTCMonth()+1)}${t(e.getUTCDate())}T${t(e.getUTCHours())}${t(e.getUTCMinutes())}${t(e.getUTCSeconds())}${t(e.getUTCMilliseconds(),3)}`}i(j,"compactTs");function S(e,t=80){const r=e.split(`
+`)[0]??"";return r.length>t?`${r.slice(0,t-1)}\u2026`:r}i(S,"firstLine");function B(e){return e.kind==="final"?{event:"report.final"}:e.result!==void 0?{event:"report.result"}:e.kind==="urgent"?{event:"report.update",level:7}:{event:"report.update",level:e.deliveryTier==="deferred"?3:e.deliveryTier==="urgent"?7:5}}i(B,"eventFor");async function U(e,t,r){const n=r.from??t,o=`reports/${j(new Date)}-${x().slice(-8)}-${r.kind}`,u=await v(e,t),c=await v(e,n),{object:d}=await z(e,A(await L(e,n,async()=>[])),{owner:u,kind:"report",name:o,preview:S(r.body)||r.kind,privacy:"public"},r.body),s=`${t}/${o}`,{event:p,level:m}=B(r);await k(e,{event:p,object:u,actor:c,...m===void 0?{}:{level:m},attrs:{},pointer:d.id,messageBody:{kind:r.kind,label:S(r.body),bodyRef:s,...r.disposition===void 0?{}:{disposition:r.disposition}}});const l=(await e.prepare(`SELECT d.destination_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id
     JOIN objects receiver ON receiver.id = d.destination_id
-    WHERE m.body_ref = ? AND receiver.type = 'node' ORDER BY d.destination_id`).all(c).map(w=>w.destination_id);return r.kind==="final"?D(e,u,"final"):r.result?.requestMessageId&&D(e,u,{result:r.result.requestMessageId}),{name:o,ref:c,doc:s,createdAt:s.created_at,deliveredTo:l}}i(S,"writeReport");function J(e,t){const r=y();r.exec("BEGIN IMMEDIATE");try{const n=p(r,"SELECT status, final_report FROM nodes WHERE node_id = ?").get(e);if(n===void 0)throw new g("unknown_node");const o=t.outcome;let u;if(o?.structured!==void 0){const d=k(r,o.structured.requestId,o.structured.declined===void 0?{intended:"completed",result:o.structured.value}:{intended:"declined",declined:o.structured.declined});if(!d.changed||d.row===null||d.row.state!=="completed"&&d.row.state!=="declined")return r.exec("COMMIT"),{written:void 0,...d.row===null?{}:{structured:d.row},structuredRefused:!0};u=d.row}else{const d=r.prepare("SELECT request_id FROM structured_requests WHERE node_id = ? AND state = 'pending'").get(e);if(d!==void 0){const f=k(r,d.request_id,{intended:"failed",failureReason:"finalized"});if(!f.changed||f.row===null||f.row.state!=="failed")return r.exec("COMMIT"),{written:void 0,...f.row===null?{}:{structured:f.row},structuredRefused:!0};u=f.row}}if(n.final_report!==null)throw new g("already_finalized",`${e}/${n.final_report}`);if(n.status!=="active"&&n.status!=="idle"&&n.status!=="done")throw new g("finalization_forbidden");const a=S(r,e,t),s=h(e),c=s?.kind!=="human",_=(s?.outcome_revision??0)+1,m=t.outcome?.kind??"result",l=t.outcome?.reason??"finalized",w=t.outcome?.detailJson??null,E=a.createdAt;if(c){const d=s===null?null:q({node:{...s,status:"done",intent:"done",terminal_reason:l},outcome:{kind:m,reason:l,at:E,revision:_,detailJson:w},finalReport:a.name,...u?.state==="completed"?{structuredResult:u.result}:{}});p(r,"UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = ?, final_report = ?, finalized_at = ?, outcome_kind = ?, outcome_reason = ?, outcome_at = ?, outcome_revision = outcome_revision + 1, outcome_detail_json = ? WHERE node_id = ? AND final_report IS NULL").run(l,a.name,E,m,l,E,w,e),d!==null&&C(r,{event:"outcome",object:v(r,e),actor:null,attrs:{revision:_},messageBody:d})}else p(r,"UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = 'finalized', final_report = ?, finalized_at = ? WHERE node_id = ? AND final_report IS NULL").run(a.name,E,e);return r.exec("COMMIT"),{written:a,...u===void 0?{}:{structured:u}}}catch(n){throw r.exec("ROLLBACK"),n}}i(J,"commitCanonicalFinal");async function x(e,t){if(!e)throw new Error(`push: empty nodeId (kind=${t.kind}) \u2014 a report must belong to a node`);if(t.kind==="final"&&t.deliveryTier!==void 0)throw new Error("push final does not accept a delivery tier");if(t.kind!=="final"&&t.outcome!==void 0)throw new Error("push outcome is final-only");if(t.kind!=="update"&&t.result!==void 0)throw new Error("a one-off result is an update report");if(F(t.body),t.kind==="final"){const n=J(e,t);if(n.structuredRefused===!0)throw n.structured!==void 0&&R(n.structured),new B(n.structured?.state??"failed");n.structured!==void 0&&t.outcome?.structured?.skipEffects!==!0&&R(n.structured);const{written:o}=n;if($(e),h(e)?.run_id===e){const a=p(y(),"SELECT node_id FROM nodes WHERE run_id = ? AND node_id != ? ORDER BY created DESC").all(e,e);for(const s of a){const c=h(s.node_id);c&&c.status!=="done"&&c.status!=="canceled"&&c.status!=="dead"&&A(s.node_id,{preserveEmpty:!0})}}return{report:o.ref,reportId:o.doc.id,deliveredTo:o.deliveredTo}}const r=U(n=>S(n,e,t));return{report:r.ref,reportId:r.doc.id,deliveredTo:r.deliveredTo}}i(x,"pushWithContext");function T(e,t){return M.current()===void 0?M.fresh(()=>x(e,t)):x(e,t)}i(T,"push");async function ue(e,t,r){return T(e,{kind:"update",body:t,...r})}i(ue,"pushUpdate");async function se(e,t,r){return T(e,{kind:"urgent",body:t,...r})}i(se,"pushUrgent");async function ce(e,t,r){return T(e,{kind:"final",body:t,...r})}i(ce,"pushFinal");export{g as FinalizationError,B as StructuredRequestFinalizationError,T as push,ce as pushFinal,ue as pushUpdate,se as pushUrgent};
+    WHERE m.body_ref = ? AND receiver.type = 'node' ORDER BY d.destination_id`).all(s)).map(w=>w.destination_id);return r.kind==="final"?await C(e,u,"final"):r.result?.requestMessageId&&await C(e,u,{result:r.result.requestMessageId}),{name:o,ref:s,doc:d,createdAt:d.created_at,deliveredTo:l}}i(U,"writeReport");async function J(e,t){return T(async r=>{const n=await r.prepare("SELECT status, final_report FROM nodes WHERE node_id = ?").get(e);if(n===void 0)throw new h("unknown_node");const o=t.outcome;let u;if(o?.structured!==void 0){const a=await R(r,o.structured.requestId,o.structured.declined===void 0?{intended:"completed",result:o.structured.value}:{intended:"declined",declined:o.structured.declined});if(!a.changed||a.row===null||a.row.state!=="completed"&&a.row.state!=="declined")return{written:void 0,...a.row===null?{}:{structured:a.row},structuredRefused:!0};u=a.row}else{const a=await r.prepareUncached("SELECT request_id FROM structured_requests WHERE node_id = ? AND state = 'pending'").get(e);if(a!==void 0){const f=await R(r,a.request_id,{intended:"failed",failureReason:"finalized"});if(!f.changed||f.row===null||f.row.state!=="failed")return{written:void 0,...f.row===null?{}:{structured:f.row},structuredRefused:!0};u=f.row}}if(n.final_report!==null)throw new h("already_finalized",`${e}/${n.final_report}`);if(n.status!=="active"&&n.status!=="idle"&&n.status!=="done")throw new h("finalization_forbidden");const c=await U(r,e,t),d=await E(e),s=d?.kind!=="human",p=(d?.outcome_revision??0)+1,m=t.outcome?.kind??"result",l=t.outcome?.reason??"finalized",w=t.outcome?.detailJson??null,_=c.createdAt;if(s){const a=d===null?null:await F({node:{...d,status:"done",intent:"done",terminal_reason:l},outcome:{kind:m,reason:l,at:_,revision:p,detailJson:w},finalReport:c.name,...u?.state==="completed"?{structuredResult:u.result}:{}});await r.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = ?, final_report = ?, finalized_at = ?, outcome_kind = ?, outcome_reason = ?, outcome_at = ?, outcome_revision = outcome_revision + 1, outcome_detail_json = ? WHERE node_id = ? AND final_report IS NULL").run(l,c.name,_,m,l,_,w,e),a!==null&&await k(r,{event:"outcome",object:await v(r,e),actor:null,attrs:{revision:p},messageBody:a})}else await r.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = 'finalized', final_report = ?, finalized_at = ? WHERE node_id = ? AND final_report IS NULL").run(c.name,_,e);return{written:c,...u===void 0?{}:{structured:u}}})}i(J,"commitCanonicalFinal");async function $(e,t){if(!e)throw new Error(`push: empty nodeId (kind=${t.kind}) \u2014 a report must belong to a node`);if(t.kind==="final"&&t.deliveryTier!==void 0)throw new Error("push final does not accept a delivery tier");if(t.kind!=="final"&&t.outcome!==void 0)throw new Error("push outcome is final-only");if(t.kind!=="update"&&t.result!==void 0)throw new Error("a one-off result is an update report");if(W(t.body),t.kind==="final"){const n=await J(e,t);if(n.structuredRefused===!0)throw n.structured!==void 0&&y(n.structured),new H(n.structured?.state??"failed");n.structured!==void 0&&t.outcome?.structured?.skipEffects!==!0&&y(n.structured);const{written:o}=n;if(await O(e),(await E(e))?.run_id===e){const c=await(await q()).prepare("SELECT node_id FROM nodes WHERE run_id = ? AND node_id != ? ORDER BY created DESC").all(e,e);for(const d of c){const s=await E(d.node_id);s&&s.status!=="done"&&s.status!=="canceled"&&s.status!=="dead"&&await M(d.node_id,{preserveEmpty:!0})}}return{report:o.ref,reportId:o.doc.id,deliveredTo:o.deliveredTo}}const r=await T(async n=>await U(n,e,t));return{report:r.ref,reportId:r.doc.id,deliveredTo:r.deliveredTo}}i($,"pushWithContext");function g(e,t){return D.current()===void 0?D.fresh(()=>$(e,t)):$(e,t)}i(g,"push");async function oe(e,t,r){return g(e,{kind:"update",body:t,...r})}i(oe,"pushUpdate");async function ae(e,t,r){return g(e,{kind:"urgent",body:t,...r})}i(ae,"pushUrgent");async function ue(e,t,r){return g(e,{kind:"final",body:t,...r})}i(ue,"pushFinal");export{h as FinalizationError,H as StructuredRequestFinalizationError,g as push,ue as pushFinal,oe as pushUpdate,ae as pushUrgent};

package/dist/core/feed/inbox.d.ts

@@ -24,11 +24,11 @@ export interface InboxEntry {
 export declare function nodeMailEntry(delivery: ClaimedNodeMail): InboxEntry;
 /** The newest head body of the report document a message points at, or null when the entry
  *  is not a report or the document is gone. */
-export declare function reportDocumentBody(objectId: string): string | null;
+export declare function reportDocumentBody(objectId: string): Promise<string | null>;
 export interface InboxDelivery {
     kind: 'human' | 'card';
     text: string;
     entries: readonly InboxEntry[];
 }
 /** Split delivered entries into verbatim human messages and sender-grouped inbox cards. */
-export declare function coalesce(entries: readonly InboxEntry[]): readonly InboxDelivery[];
+export declare function coalesce(entries: readonly InboxEntry[]): Promise<readonly InboxDelivery[]>;

package/dist/core/feed/inbox.js

@@ -1 +1 @@
-var c=Object.defineProperty;var d=(o,e)=>c(o,"name",{value:e,configurable:!0});import{prepared as u}from"../sqlite-statements.js";import{openDb as m}from"../canvas/db.js";import{heads as p}from"../graph/documents.js";import{getById as l}from"../graph/objects.js";import{bodyOf as h}from"../graph/bodies.js";import{validateOperationId as y}from"../events/operation-id.js";import{formatInboxCard as b,machineOfEntries as I}from"../../shared/generated-context.js";import{inlineBody as g,renderEntryBody as E,reportRefNodeId as _}from"../../shared/inbox-entry-body.js";const x=/^(?!0{32}$)[0-9a-f]{32}$/;function k(o){if(typeof o!="string"||!x.test(o))throw new TypeError("entry_id must be 32 lowercase non-zero hexadecimal characters");return o}d(k,"validateInboxEntryId");function $(o){const e=o.message;return{entry_id:k(e.messageId),operation_id:y(e.operationId),ts:e.createdAt,from:e.senderNodeId,...e.senderName===null?{}:{from_name:e.senderName},tier:o.urgency,kind:e.kind,...e.bodyRef===null?{}:{ref:e.bodyRef},label:e.label,...e.bodyJson===null?{}:{data:e.bodyJson},...e.disposition===null?{}:{disposition:e.disposition}}}d($,"nodeMailEntry");function B(o){const e=m(),n=l(e,o);if(n===null||n.type!=="document"||n.deleted_at!==null)return null;const s=p(e,n)[0];if(s===void 0)return null;const i=u(e,"SELECT source_path FROM documents WHERE object = ?").get(n.rowid);return h(s.body_hash,i?.source_path??null)}d(B,"reportDocumentBody");function N(o){const e=o.data?.push?.object?.id,n=_(o.ref)!==void 0&&e!==void 0?B(e):null;return E(o,n)}d(N,"entryBody");function R(o){return{kind:o.kind,body:N(o),...o.ref===void 0?{}:{ref:o.ref},...o.disposition===void 0?{}:{disposition:o.disposition}}}d(R,"cardEntry");function z(o){if(o.length===0)return[];const e=new Map;for(const t of o){const r=t.from??"system";e.has(r)||e.set(r,[]),e.get(r).push(t)}const n=[],s=[];let i=-1;for(const[t,r]of e){if(t==="human"){for(const f of r){const a=g(f);n.push({kind:"human",text:a===""?f.label:a,entries:[f]})}continue}i<0&&(i=n.length,n.push({kind:"card",text:"",entries:[]})),s.push({id:t,...I(r),entries:r.map(R)})}return i>=0&&(n[i]={kind:"card",text:b(s),entries:o.filter(t=>(t.from??"system")!=="human")}),n}d(z,"coalesce");export{z as coalesce,$ as nodeMailEntry,B as reportDocumentBody};
+var f=Object.defineProperty;var i=(n,e)=>f(n,"name",{value:e,configurable:!0});import{openDb as u}from"../canvas/db.js";import{heads as m}from"../graph/documents.js";import{getById as p}from"../graph/objects.js";import{bodyOf as l}from"../graph/bodies.js";import{validateOperationId as y}from"../events/operation-id.js";import{formatInboxCard as h,machineOfEntries as b}from"../../shared/generated-context.js";import{inlineBody as w,renderEntryBody as I,reportRefNodeId as g}from"../../shared/inbox-entry-body.js";import{mapAsync as E}from"../async-array.js";const _=/^(?!0{32}$)[0-9a-f]{32}$/;function x(n){if(typeof n!="string"||!_.test(n))throw new TypeError("entry_id must be 32 lowercase non-zero hexadecimal characters");return n}i(x,"validateInboxEntryId");function S(n){const e=n.message;return{entry_id:x(e.messageId),operation_id:y(e.operationId),ts:e.createdAt,from:e.senderNodeId,...e.senderName===null?{}:{from_name:e.senderName},tier:n.urgency,kind:e.kind,...e.bodyRef===null?{}:{ref:e.bodyRef},label:e.label,...e.bodyJson===null?{}:{data:e.bodyJson},...e.disposition===null?{}:{disposition:e.disposition}}}i(S,"nodeMailEntry");async function k(n){const e=await u(),o=await p(e,n);if(o===null||o.type!=="document"||o.deleted_at!==null)return null;const s=(await m(e,o))[0];if(s===void 0)return null;const d=await e.prepare("SELECT source_path FROM documents WHERE object = ?").get(o.rowid);return l(s.body_hash,d?.source_path??null)}i(k,"reportDocumentBody");async function B(n){const e=n.data?.push?.object?.id,o=g(n.ref)!==void 0&&e!==void 0?await k(e):null;return I(n,o)}i(B,"entryBody");async function N(n){return{kind:n.kind,body:await B(n),...n.ref===void 0?{}:{ref:n.ref},...n.disposition===void 0?{}:{disposition:n.disposition}}}i(N,"cardEntry");async function $(n){if(n.length===0)return[];const e=new Map;for(const t of n){const r=t.from??"system";e.has(r)||e.set(r,[]),e.get(r).push(t)}const o=[],s=[];let d=-1;for(const[t,r]of e){if(t==="human"){for(const a of r){const c=w(a);o.push({kind:"human",text:c===""?a.label:c,entries:[a]})}continue}d<0&&(d=o.length,o.push({kind:"card",text:"",entries:[]})),s.push({id:t,...b(r),entries:await E(r,N)})}return d>=0&&(o[d]={kind:"card",text:h(s),entries:n.filter(t=>(t.from??"system")!=="human")}),o}i($,"coalesce");export{$ as coalesce,S as nodeMailEntry,k as reportDocumentBody};

package/dist/core/feed/messages.d.ts

@@ -1,5 +1,4 @@
-import type { DatabaseSync } from 'node:sqlite';
-import { openDb } from '../canvas/db.js';
+import { type CanvasDb } from '../canvas/db.js';
 import type { OperationId } from '../events/types.js';
 import type { Level, ListenDelivery } from '../graph/types.js';
 import { type InboxDisposition, type InboxKind, type InboxTier } from './inbox.js';
@@ -20,7 +19,7 @@ export interface NodeMailInput {
     /** Optional caller-owned obligation identity, used by cron settlement replay. */
     idempotencyKey?: string;
     /** Runs with the mail insert, before the transaction commits. */
-    withinEnqueue?: (db: DatabaseSync, messageId: string) => void;
+    withinEnqueue?: (db: CanvasDb, messageId: string) => Promise<void>;
 }
 export interface EnqueuedNodeMail {
     messageId: string;
@@ -30,8 +29,8 @@ export interface EnqueuedNodeMail {
 }
 export declare function newId(): string;
 /** A terminal-lifecycle destination's normal or deferred mail is raised to urgent. */
-export declare function effectiveTier(nodeId: string, urgency: InboxTier): InboxTier;
-export declare function insertMessage(db: ReturnType<typeof openDb>, input: {
+export declare function effectiveTier(nodeId: string, urgency: InboxTier): Promise<InboxTier>;
+export declare function insertMessage(db: CanvasDb, input: {
     messageId?: string;
     operationId: OperationId;
     createdAt: string;
@@ -50,7 +49,7 @@ export declare function insertMessage(db: ReturnType<typeof openDb>, input: {
     };
     causeMessageId?: string | null;
     depth?: number;
-}): string;
+}): Promise<string>;
 /** The message's creation time, operation id and body — an oversized inline body is clipped
  *  into `destinationNodeId`'s messages dir and referenced; with no destination it stays inline. */
 export declare function finalizeNodeMail(input: Omit<NodeMailInput, 'wake'>, destinationNodeId: string | null): {
@@ -60,24 +59,24 @@ export declare function finalizeNodeMail(input: Omit<NodeMailInput, 'wake'>, des
     bodyJson: unknown | undefined;
 };
 /** Insert one immutable message and one node-inbox obligation into the caller's write transaction. */
-export declare function enqueueNodeMail(destinationNodeId: string, input: NodeMailInput): EnqueuedNodeMail;
+export declare function enqueueNodeMail(destinationNodeId: string, input: NodeMailInput): Promise<EnqueuedNodeMail>;
 /** Contract §1: a listening delivery maps 1:1 onto an inbox tier; only `next-turn` does not wake. */
 export declare function listenDeliveryTier(delivery: ListenDelivery): {
     urgency: InboxTier;
     wake: 0 | 1;
 };
 /** Queue one runtime notice to a node's inbox inside the caller's write transaction (no sender). */
-export declare function queueNodeNotice(db: DatabaseSync, nodeId: string, notice: {
+export declare function queueNodeNotice(db: CanvasDb, nodeId: string, notice: {
     body: string;
     label?: string;
     tier: InboxTier;
     wake: 0 | 1;
-}): EnqueuedNodeMail;
+}): Promise<EnqueuedNodeMail>;
 /** Retract an obligation without fabricating a terminal receipt. */
-export declare function cancelDelivery(deliveryId: string, now?: number): boolean;
+export declare function cancelDelivery(deliveryId: string, now?: number): Promise<boolean>;
 export declare function cancelPendingNodeMail(nodeId: string, select?: {
     senderNodeId?: string | null;
     kind?: InboxKind;
-}): string[];
+}): Promise<string[]>;
 /** Enqueue the one notice only if the same live controller wait is still dead. */
-export declare function enqueueControllerDeathNotice(nodeId: string, controllerId: string): EnqueuedNodeMail | null;
+export declare function enqueueControllerDeathNotice(nodeId: string, controllerId: string): Promise<EnqueuedNodeMail | null>;