@north-light/cli 0.3.529 → 0.3.531

package/dist/core/review/realize.js

@@ -1 +1 @@
-var m=Object.defineProperty;var r=(i,e)=>m(i,"name",{value:e,configurable:!0});import{conversationIdFromPath as v,conversationStore as h,ConversationNotFoundError as g}from"../conversation-store/index.js";import{getNode as s}from"../canvas/index.js";import{openRequest as q,cancelBindingRequest as b,getRequest as y}from"../human/requests.js";import{NodeIdConflictError as I}from"../runtime/nodes.js";import{reviveNode as N}from"../runtime/revive.js";import{awaitCompanionBind as E,spawnReviewCompanion as S}from"./companion.js";import{signalReviewActivity as l}from"./signal.js";import{COMPANION_BIND_DEADLINE_MS as f,ReviewOperationError as o}from"./types.js";function p(i){const e=y(i);if(e===null||e.kind!=="review")throw new o("unknown_review","review was not found",{received:i});return e}r(p,"requireBinding");function R(i){try{const e=JSON.parse(i.specification_json);if(typeof e!="object"||e===null)throw new Error("not an object");return e}catch(e){throw new Error(`corrupt review specification: ${i.request_id}`,{cause:e})}}r(R,"specification");async function k(i){let e=p(i);if(e.state!=="binding")return e;const w=R(e),t=w.branch_file,d=typeof t=="string"?v(t):null;let u=d===null;if(d!==null)try{h().header(d)}catch(n){if(!(n instanceof g))throw n;u=!0}if(u)throw b(e.request_id,new Date().toISOString(),"branch_lost")&&l(),new o("branch_lost","review branch was lost before realization",{review_id:e.request_id});if(e.file===null||e.requester_node_id===null||e.companion_node_id===null)throw new Error(`binding review has incomplete identity: ${e.request_id}`);const a=s(e.requester_node_id);if(a===null)throw new o("review_origin_missing","review origin was not found",{origin_node_id:e.requester_node_id});if(s(e.companion_node_id)===null){const n=w.model_spec;if(typeof n!="string")throw new Error(`binding review has no model spec: ${e.request_id}`);try{await S({nodeId:e.companion_node_id,reviewId:e.request_id,originNodeId:e.requester_node_id,branchFile:t,targetFile:e.file,modelSpec:n,cwd:a.cwd,profileId:a.profile_id??null})}catch(_){if(!(_ instanceof I))throw _}}const c=s(e.companion_node_id);if(c===null)throw new o("review_companion_unbound","review companion was not created",{review_id:e.request_id});if(c.pi_session_id===null&&await N(c.node_id,{resume:!1,capacity:"refuse"}),!await E(e.companion_node_id,f))throw new o("review_companion_unbound","review companion did not bind in time",{review_id:e.request_id,waited_ms:f});return q(e.request_id,new Date().toISOString())&&l(),e=p(i),e}r(k,"realizeReview");export{k as realizeReview};
+var m=Object.defineProperty;var r=(i,e)=>m(i,"name",{value:e,configurable:!0});import{conversationIdFromPath as v,conversationStore as h,ConversationNotFoundError as g}from"../conversation-store/index.js";import{getNode as s}from"../canvas/index.js";import{openRequest as q,cancelBindingRequest as b,getRequest as y}from"../human/requests.js";import{NodeIdConflictError as I}from"../runtime/nodes.js";import{reviveNode as N}from"../runtime/revive.js";import{awaitCompanionBind as E,spawnReviewCompanion as S}from"./companion.js";import{signalReviewActivity as l}from"./signal.js";import{COMPANION_BIND_DEADLINE_MS as f,ReviewOperationError as o}from"./types.js";async function p(i){const e=await y(i);if(e===null||e.kind!=="review")throw new o("unknown_review","review was not found",{received:i});return e}r(p,"requireBinding");function R(i){try{const e=JSON.parse(i.specification_json);if(typeof e!="object"||e===null)throw new Error("not an object");return e}catch(e){throw new Error(`corrupt review specification: ${i.request_id}`,{cause:e})}}r(R,"specification");async function k(i){let e=await p(i);if(e.state!=="binding")return e;const w=R(e),t=w.branch_file,a=typeof t=="string"?v(t):null;let u=a===null;if(a!==null)try{await h().header(a)}catch(n){if(!(n instanceof g))throw n;u=!0}if(u)throw await b(e.request_id,new Date().toISOString(),"branch_lost")&&l(),new o("branch_lost","review branch was lost before realization",{review_id:e.request_id});if(e.file===null||e.requester_node_id===null||e.companion_node_id===null)throw new Error(`binding review has incomplete identity: ${e.request_id}`);const d=await s(e.requester_node_id);if(d===null)throw new o("review_origin_missing","review origin was not found",{origin_node_id:e.requester_node_id});if(await s(e.companion_node_id)===null){const n=w.model_spec;if(typeof n!="string")throw new Error(`binding review has no model spec: ${e.request_id}`);try{await S({nodeId:e.companion_node_id,reviewId:e.request_id,originNodeId:e.requester_node_id,branchFile:t,targetFile:e.file,modelSpec:n,cwd:d.cwd,profileId:d.profile_id??null})}catch(_){if(!(_ instanceof I))throw _}}const c=await s(e.companion_node_id);if(c===null)throw new o("review_companion_unbound","review companion was not created",{review_id:e.request_id});if(c.pi_session_id===null&&await N(c.node_id,{resume:!1,capacity:"refuse"}),!await E(e.companion_node_id,f))throw new o("review_companion_unbound","review companion did not bind in time",{review_id:e.request_id,waited_ms:f});return await q(e.request_id,new Date().toISOString())&&l(),e=await p(i),e}r(k,"realizeReview");export{k as realizeReview};

package/dist/core/review/remap.d.ts

@@ -16,9 +16,9 @@ export declare function applyRangeBatch(args: {
     entries: RangeBatchEntry[];
     actor: Actor;
     operation_id: string;
-}): {
+}): Promise<{
     updated: number;
     detached: number;
     anchor_base_sha256: string;
-};
+}>;
 export {};

package/dist/core/review/remap.js

@@ -1,19 +1,19 @@
-var q=Object.defineProperty;var i=(e,n)=>q(e,"name",{value:n,configurable:!0});import{prepared as u}from"../sqlite-statements.js";import{withCanvasWrite as A}from"../canvas/db.js";import{nowIso as k}from"../fs-utils.js";import{signalReviewActivity as T}from"./signal.js";import{replaceAnchorBaseLocked as b}from"./store.js";import{ReviewOperationError as h}from"./types.js";import{captureAnchorText as O,readReviewSource as N,validateAnchorShape as D}from"./document.js";function I(e){return{line:e.anchor_line,end_line:e.anchor_end_line,...e.anchor_col_start===null?{}:{col_start:e.anchor_col_start},...e.anchor_col_end===null?{}:{col_end:e.anchor_col_end},...e.anchor_quote===null?{}:{quote:e.anchor_quote}}}i(I,"anchorFromRow");function f(e,n,c,_){throw new h("range_batch_stale","review comment ranges are stale",{reason:e,expected:n,actual:c,..._===void 0?{}:{comment_id:_}})}i(f,"rangeBatchStale");function L(e){if(typeof e.comment_id!="string"||e.comment_id==="")throw new h("invalid_anchor","comment anchor is invalid",{violations:["comment_id must be a non-empty string"]});const n=e.anchor!==void 0,c=e.detached===!0;if(n===c)throw new h("invalid_anchor","comment anchor is invalid",{violations:["each range batch entry must provide exactly one of anchor or detached"]});n&&D(e.anchor)}i(L,"validateEntry");function W(e,n){u(e,`
+var q=Object.defineProperty;var r=(e,o)=>q(e,"name",{value:o,configurable:!0});import{withCanvasWrite as A}from"../canvas/db.js";import{nowIso as S}from"../fs-utils.js";import{signalReviewActivity as k}from"./signal.js";import{replaceAnchorBaseLocked as T}from"./store.js";import{ReviewOperationError as h}from"./types.js";import{captureAnchorText as b,readReviewSource as O,validateAnchorShape as N}from"./document.js";function D(e){return{line:e.anchor_line,end_line:e.anchor_end_line,...e.anchor_col_start===null?{}:{col_start:e.anchor_col_start},...e.anchor_col_end===null?{}:{col_end:e.anchor_col_end},...e.anchor_quote===null?{}:{quote:e.anchor_quote}}}r(D,"anchorFromRow");function p(e,o,c,i){throw new h("range_batch_stale","review comment ranges are stale",{reason:e,expected:o,actual:c,...i===void 0?{}:{comment_id:i}})}r(p,"rangeBatchStale");function I(e){if(typeof e.comment_id!="string"||e.comment_id==="")throw new h("invalid_anchor","comment anchor is invalid",{violations:["comment_id must be a non-empty string"]});const o=e.anchor!==void 0,c=e.detached===!0;if(o===c)throw new h("invalid_anchor","comment anchor is invalid",{violations:["each range batch entry must provide exactly one of anchor or detached"]});o&&N(e.anchor)}r(I,"validateEntry");async function L(e,o){await e.prepare(`
     INSERT INTO review_comment_events
       (review_id, comment_id, kind, state_change, revision_after, actor_kind, actor_node_id, at, operation_id, payload)
     SELECT review_id, ?, 'reanchored', 1, ?, ?, ?, ?, ?, ?
     FROM review_comments WHERE comment_id = ?
-  `).run(n.row.comment_id,n.row.revision+1,n.actor.kind,n.actor.node_id,n.at,n.operation_id,JSON.stringify({previous_anchor:n.previous_anchor,anchor:n.anchor,previous_anchor_state:n.previous_anchor_state,anchor_state:n.anchor_state,previous_doc_hash:n.previous_doc_hash,doc_hash:n.doc_hash,line_text:n.line_text}),n.row.comment_id)}i(W,"appendReanchorEvent");function j(e){const n=A(c=>{const _=u(c,"SELECT file, anchor_base_sha256 FROM human_requests WHERE request_id = ? AND kind = 'review' AND state = 'open'").get(e.review_id);if(_===void 0)throw new h("unknown_review","review was not found",{received:e.review_id});const a=N(_.file,"comment");a.sha256!==e.to_doc_hash&&f("to_doc_hash",e.to_doc_hash,a.sha256),_.anchor_base_sha256!==e.from_doc_hash&&f("from_doc_hash",_.anchor_base_sha256,e.from_doc_hash);const d=u(c,`
+  `).run(o.row.comment_id,o.row.revision+1,o.actor.kind,o.actor.node_id,o.at,o.operation_id,JSON.stringify({previous_anchor:o.previous_anchor,anchor:o.anchor,previous_anchor_state:o.previous_anchor_state,anchor_state:o.anchor_state,previous_doc_hash:o.previous_doc_hash,doc_hash:o.doc_hash,line_text:o.line_text}),o.row.comment_id)}r(L,"appendReanchorEvent");async function U(e){const o=await A(async c=>{const i=await c.prepare("SELECT file, anchor_base_sha256 FROM human_requests WHERE request_id = ? AND kind = 'review' AND state = 'open'").get(e.review_id);if(i===void 0)throw new h("unknown_review","review was not found",{received:e.review_id});const a=O(i.file,"comment");a.sha256!==e.to_doc_hash&&p("to_doc_hash",e.to_doc_hash,a.sha256),i.anchor_base_sha256!==e.from_doc_hash&&p("from_doc_hash",i.anchor_base_sha256,e.from_doc_hash);const d=await c.prepare(`
       SELECT comment_id, status, revision, text, anchor_line, anchor_end_line,
              anchor_col_start, anchor_col_end, anchor_quote, anchor_line_text,
              anchor_doc_hash, anchor_state
       FROM review_comments
       WHERE review_id = ? AND status != 'deleted'
       ORDER BY created_seq
-    `).all(e.review_id);for(const o of d)o.anchor_doc_hash!==e.from_doc_hash&&f("comment_hash",e.from_doc_hash,o.anchor_doc_hash,o.comment_id);const r=new Map,s=[];for(const o of e.entries)L(o),r.has(o.comment_id)?s.push(o.comment_id):r.set(o.comment_id,o);const y=new Set(d.map(o=>o.comment_id));for(const o of r.keys())y.has(o)||s.push(o);const p=d.filter(o=>!r.has(o.comment_id)).map(o=>o.comment_id);if(p.length>0||s.length>0)throw new h("range_batch_incomplete","range batch must cover every non-deleted comment exactly once",{missing:p,extra:s});let w=0,E=0;const x=k();for(const o of d){const m=r.get(o.comment_id),R=I(o),t=m.detached===!0?R:m.anchor,l=m.detached===!0?"detached":"live",v=m.detached===!0?o.anchor_line_text:O(a.lines,t);if(!(o.anchor_state!==l||o.anchor_doc_hash!==a.sha256||o.anchor_line!==t.line||o.anchor_end_line!==t.end_line||o.anchor_col_start!==(t.col_start??null)||o.anchor_col_end!==(t.col_end??null)||o.anchor_quote!==(t.quote??null)||o.anchor_line_text!==v))continue;const S=o.revision+1;u(c,`
+    `).all(e.review_id);for(const n of d)n.anchor_doc_hash!==e.from_doc_hash&&p("comment_hash",e.from_doc_hash,n.anchor_doc_hash,n.comment_id);const _=new Map,s=[];for(const n of e.entries)I(n),_.has(n.comment_id)?s.push(n.comment_id):_.set(n.comment_id,n);const y=new Set(d.map(n=>n.comment_id));for(const n of _.keys())y.has(n)||s.push(n);const v=d.filter(n=>!_.has(n.comment_id)).map(n=>n.comment_id);if(v.length>0||s.length>0)throw new h("range_batch_incomplete","range batch must cover every non-deleted comment exactly once",{missing:v,extra:s});let f=0,w=0;const E=S();for(const n of d){const m=_.get(n.comment_id),x=D(n),t=m.detached===!0?x:m.anchor,l=m.detached===!0?"detached":"live",u=m.detached===!0?n.anchor_line_text:b(a.lines,t);if(!(n.anchor_state!==l||n.anchor_doc_hash!==a.sha256||n.anchor_line!==t.line||n.anchor_end_line!==t.end_line||n.anchor_col_start!==(t.col_start??null)||n.anchor_col_end!==(t.col_end??null)||n.anchor_quote!==(t.quote??null)||n.anchor_line_text!==u))continue;const R=n.revision+1;await c.prepare(`
         UPDATE review_comments
         SET revision = ?, anchor_line = ?, anchor_end_line = ?, anchor_col_start = ?, anchor_col_end = ?,
             anchor_quote = ?, anchor_line_text = ?, anchor_doc_hash = ?, anchor_state = ?,
             updated_by_kind = ?, updated_by_node_id = ?, updated_at = ?
         WHERE comment_id = ?
-      `).run(S,t.line,t.end_line,t.col_start??null,t.col_end??null,t.quote??null,v,a.sha256,l,e.actor.kind,e.actor.node_id,x,o.comment_id),W(c,{row:o,actor:e.actor,operation_id:e.operation_id,at:x,previous_anchor:R,anchor:t,previous_anchor_state:o.anchor_state,anchor_state:l,previous_doc_hash:o.anchor_doc_hash,doc_hash:a.sha256,line_text:v}),w+=1,l==="detached"&&(E+=1)}return b(c,e.review_id,a.bytes,a.sha256),{updated:w,detached:E,anchor_base_sha256:a.sha256}});return T(),n}i(j,"applyRangeBatch");export{j as applyRangeBatch};
+      `).run(R,t.line,t.end_line,t.col_start??null,t.col_end??null,t.quote??null,u,a.sha256,l,e.actor.kind,e.actor.node_id,E,n.comment_id),await L(c,{row:n,actor:e.actor,operation_id:e.operation_id,at:E,previous_anchor:x,anchor:t,previous_anchor_state:n.anchor_state,anchor_state:l,previous_doc_hash:n.anchor_doc_hash,doc_hash:a.sha256,line_text:u}),f+=1,l==="detached"&&(w+=1)}return await T(c,e.review_id,a.bytes,a.sha256),{updated:f,detached:w,anchor_base_sha256:a.sha256}});return k(),o}r(U,"applyRangeBatch");export{U as applyRangeBatch};

package/dist/core/review/stage.d.ts

@@ -30,7 +30,7 @@ export type StagedReview = {
     review_dir: string;
 };
 /** Remove only review-directory state that was never committed to a review row. */
-export declare function discardStaging(reviewId: string, branchFile?: string): void;
+export declare function discardStaging(reviewId: string, branchFile?: string): Promise<void>;
 /**
  * Capture an existing origin and write its immutable branch without creating a
  * canvas node or review row. The caller alone commits or discards this stage.

package/dist/core/review/stage.js

@@ -1 +1 @@
-var v=Object.defineProperty;var o=(e,n)=>v(e,"name",{value:n,configurable:!0});import{createHash as g}from"node:crypto";import{existsSync as y,readFileSync as b,realpathSync as S,rmSync as F,statSync as I,writeFileSync as k}from"node:fs";import{isAbsolute as x,join as R}from"node:path";import{getNode as O}from"../canvas/index.js";import{conversationIdFromPath as j,conversationStore as z,ConversationNotFoundError as D}from"../conversation-store/index.js";import{ensureReviewDir as E,reviewDir as l}from"../canvas/paths.js";import{checkReviewableFile as B}from"../human/visible-paths.js";import{newNodeId as w}from"../runtime/nodes.js";import{captureOrigin as N}from"./companion.js";import{materializeSessionBranch as q}from"../runtime/session-branch.js";import{getRequestByIdempotencyKey as A}from"../human/requests.js";import{ReviewOperationError as r}from"./types.js";function a(e,n){return new r("review_target_unreviewable","review target cannot be staged",{phase:"create",file:e,reason:n})}o(a,"targetError");function h(e){if(!x(e))throw a(e,"not_absolute");if(!y(e))throw a(e,"missing");try{if(!I(e).isFile())throw a(e,"not_a_file")}catch(i){throw i instanceof r?i:a(e,"missing")}const n=B(e);if(!n.ok){const i=n.reason==="file is not UTF-8 text"?"binary":n.reason==="file is too large to review (2 MB limit)"?"too_large":n.reason==="file is too long to review (5,000 line limit)"?"too_many_lines":"not_a_file";throw a(e,i)}try{return S(e)}catch{throw a(e,"missing")}}o(h,"validateReviewFile");function U(e){return new r("review_branch_unavailable","review branch could not be materialized",{reason:"materialize_failed",origin_node_id:e})}o(U,"branchUnavailable");async function C(e){try{return await N(e)}catch(n){throw n instanceof r&&n.code==="review_origin_missing"?new r("review_origin_missing","review origin was not found",{origin_node_id:e,reason:"origin_missing"}):n}}o(C,"captureStagedOrigin");function H(e,n){try{return q(n)}catch{throw U(e)}}o(H,"materialize");function K(e,n){if(n!==void 0){const i=j(n);if(i===null)throw new Error(`invalid staged conversation path: ${n}`);try{z().delete(i)}catch(c){if(!(c instanceof D))throw c}}try{F(l(e),{recursive:!0,force:!0})}catch{}}o(K,"discardStaging");async function ee(e){const n=A(e.idempotency_key);if(n!==null)return{existing:n};if(O(e.origin_node_id)===null)throw new r("review_origin_missing","review origin was not found",{origin_node_id:e.origin_node_id,reason:"origin_missing"});const i=w(),c=w();let d,s=e.document===void 0?h(e.file??""):"";try{if(E(i),e.document!==void 0){const m=R(l(i),"document.md");k(m,e.document.body),s=h(m)}const t=await C(e.origin_node_id),p=new Date().toISOString(),_=b(s),u=g("sha256").update(_).digest("hex");d=H(e.origin_node_id,t);const f=new Date().toISOString();return{row:{review_id:i,idempotency_key:e.idempotency_key,origin_kind:e.origin_kind,origin_node_id:e.origin_node_id,companion_node_id:c,review_dir:l(i),file:s,origin_session_file:t.sourceFile,origin_session_id:t.sourceSessionId,origin_leaf_id:t.leafId,model_spec:t.modelSpec,branch_file:d,baseline_sha256:u,baseline_bytes:_.length,anchor_base_sha256:u,anchor_base_bytes:_,state:"binding",created:f,captured_at:p,opened_at:null,submit_requested_at:null,output_path:e.output_path??null,document_id:e.document?.id??null,document_name:e.document?.name??null,document_base:e.document?.base??null,subtitle:e.subtitle??null,approved_at:null,approved_sha256:null,changed:null,comments_total:null,comments_unresolved:null,result_json:null,canceled_at:null,cancel_reason:null,cancel_actor:null,delivery_entry_id:null,delivered_at:null,delivery_error:null,projected_at:null,projection_error:null},review_dir:l(i)}}catch(t){throw K(i,d),t}}o(ee,"stageReview");export{K as discardStaging,ee as stageReview};
+var v=Object.defineProperty;var t=(e,n)=>v(e,"name",{value:n,configurable:!0});import{createHash as g}from"node:crypto";import{existsSync as y,readFileSync as b,realpathSync as S,rmSync as F,statSync as I,writeFileSync as k}from"node:fs";import{isAbsolute as x,join as R}from"node:path";import{getNode as O}from"../canvas/index.js";import{conversationIdFromPath as j,conversationStore as z,ConversationNotFoundError as D}from"../conversation-store/index.js";import{ensureReviewDir as E,reviewDir as l}from"../canvas/paths.js";import{checkReviewableFile as B}from"../human/visible-paths.js";import{newNodeId as w}from"../runtime/nodes.js";import{captureOrigin as N}from"./companion.js";import{materializeSessionBranch as q}from"../runtime/session-branch.js";import{getRequestByIdempotencyKey as A}from"../human/requests.js";import{ReviewOperationError as r}from"./types.js";function a(e,n){return new r("review_target_unreviewable","review target cannot be staged",{phase:"create",file:e,reason:n})}t(a,"targetError");function h(e){if(!x(e))throw a(e,"not_absolute");if(!y(e))throw a(e,"missing");try{if(!I(e).isFile())throw a(e,"not_a_file")}catch(i){throw i instanceof r?i:a(e,"missing")}const n=B(e);if(!n.ok){const i=n.reason==="file is not UTF-8 text"?"binary":n.reason==="file is too large to review (2 MB limit)"?"too_large":n.reason==="file is too long to review (5,000 line limit)"?"too_many_lines":"not_a_file";throw a(e,i)}try{return S(e)}catch{throw a(e,"missing")}}t(h,"validateReviewFile");function U(e){return new r("review_branch_unavailable","review branch could not be materialized",{reason:"materialize_failed",origin_node_id:e})}t(U,"branchUnavailable");async function C(e){try{return await N(e)}catch(n){throw n instanceof r&&n.code==="review_origin_missing"?new r("review_origin_missing","review origin was not found",{origin_node_id:e,reason:"origin_missing"}):n}}t(C,"captureStagedOrigin");async function H(e,n){try{return await q(n)}catch{throw U(e)}}t(H,"materialize");async function K(e,n){if(n!==void 0){const i=j(n);if(i===null)throw new Error(`invalid staged conversation path: ${n}`);try{await z().delete(i)}catch(c){if(!(c instanceof D))throw c}}try{F(l(e),{recursive:!0,force:!0})}catch{}}t(K,"discardStaging");async function ee(e){const n=await A(e.idempotency_key);if(n!==null)return{existing:n};if(await O(e.origin_node_id)===null)throw new r("review_origin_missing","review origin was not found",{origin_node_id:e.origin_node_id,reason:"origin_missing"});const i=await w(),c=await w();let d,s=e.document===void 0?h(e.file??""):"";try{if(E(i),e.document!==void 0){const m=R(l(i),"document.md");k(m,e.document.body),s=h(m)}const o=await C(e.origin_node_id),p=new Date().toISOString(),_=b(s),u=g("sha256").update(_).digest("hex");d=await H(e.origin_node_id,o);const f=new Date().toISOString();return{row:{review_id:i,idempotency_key:e.idempotency_key,origin_kind:e.origin_kind,origin_node_id:e.origin_node_id,companion_node_id:c,review_dir:l(i),file:s,origin_session_file:o.sourceFile,origin_session_id:o.sourceSessionId,origin_leaf_id:o.leafId,model_spec:o.modelSpec,branch_file:d,baseline_sha256:u,baseline_bytes:_.length,anchor_base_sha256:u,anchor_base_bytes:_,state:"binding",created:f,captured_at:p,opened_at:null,submit_requested_at:null,output_path:e.output_path??null,document_id:e.document?.id??null,document_name:e.document?.name??null,document_base:e.document?.base??null,subtitle:e.subtitle??null,approved_at:null,approved_sha256:null,changed:null,comments_total:null,comments_unresolved:null,result_json:null,canceled_at:null,cancel_reason:null,cancel_actor:null,delivery_entry_id:null,delivered_at:null,delivery_error:null,projected_at:null,projection_error:null},review_dir:l(i)}}catch(o){throw await K(i,d),o}}t(ee,"stageReview");export{K as discardStaging,ee as stageReview};

package/dist/core/review/store.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from '../canvas/db.js';
 import { type ReviewRecord, type ReviewState } from './types.js';
 export interface ApproveReviewArgs {
     review_id: string;
@@ -9,36 +9,36 @@ export interface ApproveReviewArgs {
     comments_unresolved: number;
     result_json: string;
 }
-export declare function getReview(reviewId: string): ReviewRecord | null;
-export declare function requireVisibleReview(reviewId: string): ReviewRecord;
-export declare function getReviewByIdempotencyKey(key: string): ReviewRecord | null;
-export declare function getReviewByCompanion(nodeId: string): ReviewRecord | null;
+export declare function getReview(reviewId: string): Promise<ReviewRecord | null>;
+export declare function requireVisibleReview(reviewId: string): Promise<ReviewRecord>;
+export declare function getReviewByIdempotencyKey(key: string): Promise<ReviewRecord | null>;
+export declare function getReviewByCompanion(nodeId: string): Promise<ReviewRecord | null>;
 export declare function listReviews(filter: {
     state?: ReviewState;
     origin_node_id?: string;
     file?: string;
-}): ReviewRecord[];
-export declare function reviewIdsByOriginNodes(nodeIds: readonly string[]): string[];
-export declare function deleteReviewsByOriginNodes(nodeIds: readonly string[]): string[];
-export declare function listBindingReviews(): ReviewRecord[];
-export declare function listSubmitRequestedReviews(): ReviewRecord[];
-export declare function listUnprojectedTerminalReviews(): ReviewRecord[];
-export declare function openReviewRow(reviewId: string, openedAt: string): boolean;
+}): Promise<ReviewRecord[]>;
+export declare function reviewIdsByOriginNodes(nodeIds: readonly string[]): Promise<string[]>;
+export declare function deleteReviewsByOriginNodes(nodeIds: readonly string[]): Promise<string[]>;
+export declare function listBindingReviews(): Promise<ReviewRecord[]>;
+export declare function listSubmitRequestedReviews(): Promise<ReviewRecord[]>;
+export declare function listUnprojectedTerminalReviews(): Promise<ReviewRecord[]>;
+export declare function openReviewRow(reviewId: string, openedAt: string): Promise<boolean>;
 /** Put a deferred submit back to not-requested, so the person sees the review open again. */
-export declare function clearReviewSubmit(reviewId: string): void;
-export declare function requestReviewSubmit(reviewId: string, at: string): boolean;
-export declare function approveReviewLocked(db: DatabaseSync, args: ApproveReviewArgs): boolean;
+export declare function clearReviewSubmit(reviewId: string): Promise<void>;
+export declare function requestReviewSubmit(reviewId: string, at: string): Promise<boolean>;
+export declare function approveReviewLocked(db: CanvasDb, args: ApproveReviewArgs): Promise<boolean>;
 export declare function cancelReviewRow(reviewId: string, args: {
     at: string;
     reason: string;
     actor: string | null;
-}): boolean;
-export declare function markProjected(reviewId: string, at: string): void;
-export declare function markProjectionError(reviewId: string, error: string): void;
+}): Promise<boolean>;
+export declare function markProjected(reviewId: string, at: string): Promise<void>;
+export declare function markProjectionError(reviewId: string, error: string): Promise<void>;
 export declare function markDelivered(_reviewId: string, _receipt: string | null, _at: string): void;
 export declare function markDeliveryError(_reviewId: string, _error: string): void;
-export declare function readAnchorBase(reviewId: string): {
+export declare function readAnchorBase(reviewId: string): Promise<{
     bytes: Buffer;
     sha256: string;
-} | null;
-export declare function replaceAnchorBaseLocked(db: DatabaseSync, reviewId: string, bytes: Buffer, sha256: string): void;
+} | null>;
+export declare function replaceAnchorBaseLocked(db: CanvasDb, reviewId: string, bytes: Buffer, sha256: string): Promise<void>;

package/dist/core/review/store.js

@@ -1 +1 @@
-var c=Object.defineProperty;var t=(e,n)=>c(e,"name",{value:n,configurable:!0});import{prepared as a}from"../sqlite-statements.js";import{existsSync as d}from"node:fs";import{withCanvasWrite as s}from"../canvas/db.js";import{getRequest as l,getRequestByCompanion as _,getRequestByIdempotencyKey as p,listBindingRequests as m,listRequests as u,listSubmitRequestedRequests as v,listUnprojectedReviews as w,markProjected as f,markProjectionError as h,openRequest as R,readAnchorBase as E,replaceAnchorBaseLocked as y,requestSubmit as j}from"../human/requests.js";import{ReviewOperationError as k}from"./types.js";function b(e){try{const n=JSON.parse(e.specification_json);if(typeof n!="object"||n===null)throw new Error("not an object");return n}catch(n){throw new Error(`corrupt review specification: ${e.request_id}`,{cause:n})}}t(b,"specification");function g(e){return e.state!=="settled"?e.state:e.outcome==="approved"?"approved":"canceled"}t(g,"state");function i(e){if(e.kind!=="review")throw new Error(`human request is not a review: ${e.request_id}`);const n=b(e),r=g(e),o=e.settled_at;return{review_id:e.request_id,idempotency_key:e.idempotency_key??"",origin_kind:n.origin_kind??(e.inbox_listed?"ticket":"inline"),origin_node_id:e.requester_node_id??"",companion_node_id:e.companion_node_id??"",review_dir:e.request_dir,file:e.file??"",origin_session_file:n.origin_session_file,origin_session_id:n.origin_session_id,origin_leaf_id:n.origin_leaf_id,model_spec:n.model_spec,branch_file:n.branch_file,baseline_sha256:n.baseline_sha256,baseline_bytes:n.baseline_bytes,anchor_base_sha256:e.anchor_base_sha256??"",state:r,created:e.created_at,captured_at:n.captured_at,opened_at:e.opened_at,submit_requested_at:e.submit_requested_at,output_path:n.output_path??null,document_id:n.document_id??null,document_name:n.document_name??null,document_base:n.document_base??null,subtitle:e.subtitle,approved_at:r==="approved"?o:null,approved_sha256:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").approved_sha256??null}catch{return null}})():null,changed:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").changed??null}catch{return null}})():null,comments_total:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").comments_total??null}catch{return null}})():null,comments_unresolved:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").comments_unresolved??null}catch{return null}})():null,result_json:e.result_json,canceled_at:r==="canceled"?o:null,cancel_reason:r==="canceled"?(()=>{try{return JSON.parse(e.result_json??"{}").reason??null}catch{return null}})():null,cancel_actor:r==="canceled"?(()=>{try{return JSON.parse(e.result_json??"{}").actor??null}catch{return null}})():null,delivery_entry_id:e.settlement_delivery_id,delivered_at:e.settlement_delivery_id===null?null:o,delivery_error:null,projected_at:e.projected_at,projection_error:e.projection_error,source_missing:!d(e.file??"")}}t(i,"record");function x(e){const n=l(e);return n?.kind==="review"?n:null}t(x,"requestForReview");function N(e){const n=x(e);return n===null?null:i(n)}t(N,"getReview");function T(e){const n=N(e);if(n===null||n.state==="binding")throw new k("unknown_review","review was not found",{received:e});return n}t(T,"requireVisibleReview");function I(e){const n=p(e);return n?.kind==="review"?i(n):null}t(I,"getReviewByIdempotencyKey");function P(e){const n=_(e);return n?.kind==="review"?i(n):null}t(P,"getReviewByCompanion");function J(e){return u({kind:"review",...e.origin_node_id===void 0?{}:{requester_node_id:e.origin_node_id},...e.file===void 0?{}:{file:e.file}}).map(i).filter(n=>n.state!=="binding"&&(e.state===void 0||n.state===e.state))}t(J,"listReviews");function S(e){const n=new Set(e);return u({kind:"review"}).filter(r=>r.requester_node_id!==null&&n.has(r.requester_node_id)).map(r=>r.request_id)}t(S,"reviewIdsByOriginNodes");function U(e){const n=S(e);return n.length===0?[]:(s(r=>{const o=n.map(()=>"?").join(",");r.prepare(`DELETE FROM review_comment_events WHERE review_id IN (${o})`).run(...n),r.prepare(`DELETE FROM review_comments WHERE review_id IN (${o})`).run(...n),r.prepare(`DELETE FROM human_requests WHERE request_id IN (${o})`).run(...n)}),n)}t(U,"deleteReviewsByOriginNodes");function W(){return m().map(i)}t(W,"listBindingReviews");function H(){return v().map(i)}t(H,"listSubmitRequestedReviews");function $(){return w().map(i)}t($,"listUnprojectedTerminalReviews");function F(e,n){return R(e,n)}t(F,"openReviewRow");function C(e){s(n=>a(n,"UPDATE human_requests SET submit_requested_at = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(new Date().toISOString(),e))}t(C,"clearReviewSubmit");function M(e,n){return j(e,n)}t(M,"requestReviewSubmit");function K(e,n){return a(e,"UPDATE human_requests SET state = 'settled', outcome = 'approved', result_json = ?, settled_at = ?, progress_json = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(n.result_json,n.approved_at,n.approved_at,n.review_id).changes>0}t(K,"approveReviewLocked");function V(e,n){return s(r=>a(r,"UPDATE human_requests SET state = 'settled', outcome = 'canceled', result_json = ?, settled_at = ?, progress_json = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(JSON.stringify({schema:"humanloop.cancel/v1",kind:"canceled",canceledAt:n.at,...n.reason===""?{}:{reason:n.reason},...n.actor===null?{}:{actor:n.actor}}),n.at,n.at,e).changes>0)}t(V,"cancelReviewRow");function z(e,n){f(e,n)}t(z,"markProjected");function G(e,n){h(e,n)}t(G,"markProjectionError");function Q(e,n,r){}t(Q,"markDelivered");function X(e,n){}t(X,"markDeliveryError");function Y(e){return E(e)}t(Y,"readAnchorBase");function Z(e,n,r,o){y(e,n,r,o)}t(Z,"replaceAnchorBaseLocked");export{K as approveReviewLocked,V as cancelReviewRow,C as clearReviewSubmit,U as deleteReviewsByOriginNodes,N as getReview,P as getReviewByCompanion,I as getReviewByIdempotencyKey,W as listBindingReviews,J as listReviews,H as listSubmitRequestedReviews,$ as listUnprojectedTerminalReviews,Q as markDelivered,X as markDeliveryError,z as markProjected,G as markProjectionError,F as openReviewRow,Y as readAnchorBase,Z as replaceAnchorBaseLocked,M as requestReviewSubmit,T as requireVisibleReview,S as reviewIdsByOriginNodes};
+var c=Object.defineProperty;var t=(e,n)=>c(e,"name",{value:n,configurable:!0});import{existsSync as u}from"node:fs";import{withCanvasWrite as d,openDb as o}from"../canvas/db.js";import{getRequest as l,getRequestByCompanion as _,getRequestByIdempotencyKey as p,listBindingRequests as w,listRequests as s,listSubmitRequestedRequests as m,listUnprojectedReviews as v,markProjected as y,markProjectionError as f,openRequest as h,readAnchorBase as R,replaceAnchorBaseLocked as E,requestSubmit as j}from"../human/requests.js";import{ReviewOperationError as k}from"./types.js";function b(e){try{const n=JSON.parse(e.specification_json);if(typeof n!="object"||n===null)throw new Error("not an object");return n}catch(n){throw new Error(`corrupt review specification: ${e.request_id}`,{cause:n})}}t(b,"specification");function g(e){return e.state!=="settled"?e.state:e.outcome==="approved"?"approved":"canceled"}t(g,"state");function a(e){if(e.kind!=="review")throw new Error(`human request is not a review: ${e.request_id}`);const n=b(e),r=g(e),i=e.settled_at;return{review_id:e.request_id,idempotency_key:e.idempotency_key??"",origin_kind:n.origin_kind??(e.inbox_listed?"ticket":"inline"),origin_node_id:e.requester_node_id??"",companion_node_id:e.companion_node_id??"",review_dir:e.request_dir,file:e.file??"",origin_session_file:n.origin_session_file,origin_session_id:n.origin_session_id,origin_leaf_id:n.origin_leaf_id,model_spec:n.model_spec,branch_file:n.branch_file,baseline_sha256:n.baseline_sha256,baseline_bytes:n.baseline_bytes,anchor_base_sha256:e.anchor_base_sha256??"",state:r,created:e.created_at,captured_at:n.captured_at,opened_at:e.opened_at,submit_requested_at:e.submit_requested_at,output_path:n.output_path??null,document_id:n.document_id??null,document_name:n.document_name??null,document_base:n.document_base??null,subtitle:e.subtitle,approved_at:r==="approved"?i:null,approved_sha256:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").approved_sha256??null}catch{return null}})():null,changed:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").changed??null}catch{return null}})():null,comments_total:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").comments_total??null}catch{return null}})():null,comments_unresolved:r==="approved"?(()=>{try{return JSON.parse(e.result_json??"{}").comments_unresolved??null}catch{return null}})():null,result_json:e.result_json,canceled_at:r==="canceled"?i:null,cancel_reason:r==="canceled"?(()=>{try{return JSON.parse(e.result_json??"{}").reason??null}catch{return null}})():null,cancel_actor:r==="canceled"?(()=>{try{return JSON.parse(e.result_json??"{}").actor??null}catch{return null}})():null,delivery_entry_id:e.settlement_delivery_id,delivered_at:e.settlement_delivery_id===null?null:i,delivery_error:null,projected_at:e.projected_at,projection_error:e.projection_error,source_missing:!u(e.file??"")}}t(a,"record");async function x(e){const n=await l(e);return n?.kind==="review"?n:null}t(x,"requestForReview");async function N(e){const n=await x(e);return n===null?null:a(n)}t(N,"getReview");async function U(e){const n=await N(e);if(n===null||n.state==="binding")throw new k("unknown_review","review was not found",{received:e});return n}t(U,"requireVisibleReview");async function q(e){const n=await p(e);return n?.kind==="review"?a(n):null}t(q,"getReviewByIdempotencyKey");async function T(e){const n=await _(e);return n?.kind==="review"?a(n):null}t(T,"getReviewByCompanion");async function I(e){return(await s({kind:"review",...e.origin_node_id===void 0?{}:{requester_node_id:e.origin_node_id},...e.file===void 0?{}:{file:e.file}})).map(a).filter(n=>n.state!=="binding"&&(e.state===void 0||n.state===e.state))}t(I,"listReviews");async function S(e){const n=new Set(e);return(await s({kind:"review"})).filter(r=>r.requester_node_id!==null&&n.has(r.requester_node_id)).map(r=>r.request_id)}t(S,"reviewIdsByOriginNodes");async function P(e){const n=await S(e);return n.length===0?[]:(await d(async r=>{const i=n.map(()=>"?").join(",");await r.prepareUncached(`DELETE FROM review_comment_events WHERE review_id IN (${i})`).run(...n),await r.prepareUncached(`DELETE FROM review_comments WHERE review_id IN (${i})`).run(...n),await r.prepareUncached(`DELETE FROM human_requests WHERE request_id IN (${i})`).run(...n)}),n)}t(P,"deleteReviewsByOriginNodes");async function J(){return(await w()).map(a)}t(J,"listBindingReviews");async function W(){return(await m()).map(a)}t(W,"listSubmitRequestedReviews");async function H(){return(await v()).map(a)}t(H,"listUnprojectedTerminalReviews");async function $(e,n){return await h(e,n)}t($,"openReviewRow");async function F(e){await(await o()).prepare("UPDATE human_requests SET submit_requested_at = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(new Date().toISOString(),e)}t(F,"clearReviewSubmit");async function C(e,n){return await j(e,n)}t(C,"requestReviewSubmit");async function M(e,n){return(await e.prepare("UPDATE human_requests SET state = 'settled', outcome = 'approved', result_json = ?, settled_at = ?, progress_json = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(n.result_json,n.approved_at,n.approved_at,n.review_id)).changes>0}t(M,"approveReviewLocked");async function K(e,n){return(await(await o()).prepare("UPDATE human_requests SET state = 'settled', outcome = 'canceled', result_json = ?, settled_at = ?, progress_json = NULL, updated_at = ? WHERE request_id = ? AND kind = 'review' AND state = 'open'").run(JSON.stringify({schema:"humanloop.cancel/v1",kind:"canceled",canceledAt:n.at,...n.reason===""?{}:{reason:n.reason},...n.actor===null?{}:{actor:n.actor}}),n.at,n.at,e)).changes>0}t(K,"cancelReviewRow");async function V(e,n){await y(e,n)}t(V,"markProjected");async function z(e,n){await f(e,n)}t(z,"markProjectionError");function G(e,n,r){}t(G,"markDelivered");function Q(e,n){}t(Q,"markDeliveryError");async function X(e){return await R(e)}t(X,"readAnchorBase");async function Y(e,n,r,i){await E(e,n,r,i)}t(Y,"replaceAnchorBaseLocked");export{M as approveReviewLocked,K as cancelReviewRow,F as clearReviewSubmit,P as deleteReviewsByOriginNodes,N as getReview,T as getReviewByCompanion,q as getReviewByIdempotencyKey,J as listBindingReviews,I as listReviews,W as listSubmitRequestedReviews,H as listUnprojectedTerminalReviews,G as markDelivered,Q as markDeliveryError,V as markProjected,z as markProjectionError,$ as openReviewRow,X as readAnchorBase,Y as replaceAnchorBaseLocked,C as requestReviewSubmit,U as requireVisibleReview,S as reviewIdsByOriginNodes};

package/dist/core/runs/activity.d.ts

@@ -8,4 +8,4 @@ export declare function toolCallSummary(args: unknown): string | null;
  *  state `run.trace` `in_progress_message` reads) says what the model is
  *  streaming. Null unless the run is `running`. `streaming` is that open
  *  message's newest block; a test passes it in place of a live broker. */
-export declare function runActivity(runId: string, status: string, streaming?: () => OpenAssistantBlock | null): RunActivityDTO | null;
+export declare function runActivity(runId: string, status: string, streaming?: () => OpenAssistantBlock | null): Promise<RunActivityDTO | null>;

package/dist/core/runs/activity.js

@@ -1,6 +1,6 @@
-var f=Object.defineProperty;var i=(e,t)=>f(e,"name",{value:t,configurable:!0});import{prepared as a}from"../sqlite-statements.js";import{openDb as b}from"../canvas/db.js";import{openAssistantBlock as y}from"../../daemon/runs/observer.js";import{SUBMIT_RESULT_TOOL as p}from"../runtime/structured-output.js";const _=120;function E(e){if(!e||typeof e!="object")return null;const t=e,s=[t.command,t.file_path,t.path].find(r=>typeof r=="string"&&r.trim()!=="");if(s===void 0)return null;const o=s.trim().split(`
-`)[0].trim();return o.length>_?`${o.slice(0,_-1)}\u2026`:o}i(E,"toolCallSummary");function D(e,t,s=()=>y(e)){if(t!=="running")return null;const o=b(),r=a(o,`SELECT type, sequence_number FROM run_events WHERE run_id = ? AND node_id = ?
-    AND type IN ('node.turn.started', 'node.turn.completed') ORDER BY sequence_number DESC LIMIT 1`).get(e,e);if(!r)return{phase:"starting"};if(r.type==="node.turn.completed")return{phase:"between_turns"};const l=s();if(l?.kind==="text")return{phase:"writing"};if(l?.kind==="tool_call")return l.name===p?{phase:"submitting_result"}:{phase:"tool",tool:{name:l.name,summary:null}};if(l===null){const c=a(o,`SELECT type, json_extract(body_json, '$.tool_call_id') AS id, sequence_number FROM run_events
+var d=Object.defineProperty;var i=(e,t)=>d(e,"name",{value:t,configurable:!0});import{openDb as f}from"../canvas/db.js";import{openAssistantBlock as b}from"../../daemon/runs/observer.js";import{SUBMIT_RESULT_TOOL as m}from"../runtime/structured-output.js";const p=120;function y(e){if(!e||typeof e!="object")return null;const t=e,s=[t.command,t.file_path,t.path].find(o=>typeof o=="string"&&o.trim()!=="");if(s===void 0)return null;const r=s.trim().split(`
+`)[0].trim();return r.length>p?`${r.slice(0,p-1)}\u2026`:r}i(y,"toolCallSummary");async function S(e,t,s=()=>b(e)){if(t!=="running")return null;const r=await f(),o=await r.prepare(`SELECT type, sequence_number FROM run_events WHERE run_id = ? AND node_id = ?
+    AND type IN ('node.turn.started', 'node.turn.completed') ORDER BY sequence_number DESC LIMIT 1`).get(e,e);if(!o)return{phase:"starting"};if(o.type==="node.turn.completed")return{phase:"between_turns"};const l=s();if(l?.kind==="text")return{phase:"writing"};if(l?.kind==="tool_call")return l.name===m?{phase:"submitting_result"}:{phase:"tool",tool:{name:l.name,summary:null}};if(l===null){const u=await r.prepare(`SELECT type, json_extract(body_json, '$.tool_call_id') AS id, sequence_number FROM run_events
       WHERE run_id = ? AND node_id = ? AND type IN ('node.tool_call.started', 'node.tool_call.completed') AND sequence_number > ?
-      ORDER BY sequence_number`).all(e,e,r.sequence_number),d=new Set(c.filter(n=>n.type==="node.tool_call.completed").map(n=>n.id)),m=c.filter(n=>n.type==="node.tool_call.started"&&!d.has(n.id)).at(-1);if(m){const n=a(o,`SELECT json_extract(body_json, '$.name') AS name, json_extract(body_json, '$.arguments') AS args
-        FROM run_events WHERE run_id = ? AND sequence_number = ?`).get(e,m.sequence_number);if(n.name===p)return{phase:"submitting_result"};let u=null;try{u=n.args===null?null:JSON.parse(n.args)}catch{u=null}return{phase:"tool",tool:{name:n.name,summary:E(u)}}}}return{phase:"thinking"}}i(D,"runActivity");export{D as runActivity,E as toolCallSummary};
+      ORDER BY sequence_number`).all(e,e,o.sequence_number),_=new Set(u.filter(n=>n.type==="node.tool_call.completed").map(n=>n.id)),c=u.filter(n=>n.type==="node.tool_call.started"&&!_.has(n.id)).at(-1);if(c){const n=await r.prepare(`SELECT json_extract(body_json, '$.name') AS name, json_extract(body_json, '$.arguments') AS args
+        FROM run_events WHERE run_id = ? AND sequence_number = ?`).get(e,c.sequence_number);if(n.name===m)return{phase:"submitting_result"};let a=null;try{a=n.args===null?null:JSON.parse(n.args)}catch{a=null}return{phase:"tool",tool:{name:n.name,summary:y(a)}}}}return{phase:"thinking"}}i(S,"runActivity");export{S as runActivity,y as toolCallSummary};

package/dist/core/runs/confinement.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from '../canvas/db.js';
 /** A node's run and whether that run is isolated (the node's own flag or its root's). */
 export interface RunPlace {
     run: string;
@@ -7,19 +7,19 @@ export interface RunPlace {
 /** The run a node belongs to: its `run_id`, or the node itself when it has none.
  *  A deleted node of an isolated run keeps its run through `deleted_isolated_nodes`,
  *  so what it leaves behind stays confined; any other node without a row is null. */
-export declare function runPlace(nodeId: string, db?: DatabaseSync): RunPlace | null;
+export declare function runPlace(nodeId: string, db?: CanvasDb): Promise<RunPlace | null>;
 /** Record, before a node's row is deleted, the run of a node of an isolated run. */
-export declare function rememberDeletedIsolated(nodeId: string, db?: DatabaseSync): void;
+export declare function rememberDeletedIsolated(nodeId: string, db?: CanvasDb): Promise<void>;
 /** The place of the node that registered a custom object, which is where that object
  *  reads from; null when the person or the app's server registered it. */
-export declare function objectPlace(objectRowid: number, db?: DatabaseSync): RunPlace | null;
+export declare function objectPlace(objectRowid: number, db?: CanvasDb): Promise<RunPlace | null>;
 /** The confinement predicate: two places see each other when they are the same
  *  run, or when neither run is isolated. */
 export declare function runsSeeEachOther(a: RunPlace, b: RunPlace): boolean;
 /** Whether a node caller of `app` may reach `target` (a node id) under run confinement.
  *  Confinement applies only within one app; cross-app reach stays with the scope rules. */
-export declare function nodeMayReach(callerNode: string, callerApp: string, targetNode: string, targetApp: string | null, db?: DatabaseSync): boolean;
+export declare function nodeMayReach(callerNode: string, callerApp: string, targetNode: string, targetApp: string | null, db?: CanvasDb): Promise<boolean>;
 /** The same question for a caller that has a place but no node (a cron command: its origin run). */
-export declare function placeMayReach(caller: RunPlace, callerApp: string, targetNode: string, targetApp: string | null, db?: DatabaseSync): boolean;
+export declare function placeMayReach(caller: RunPlace, callerApp: string, targetNode: string, targetApp: string | null, db?: CanvasDb): Promise<boolean>;
 /** The node ids of one run (its root and every node carrying its `run_id`). */
-export declare function runNodeIds(run: string, db?: DatabaseSync): string[];
+export declare function runNodeIds(run: string, db?: CanvasDb): Promise<string[]>;

package/dist/core/runs/confinement.js

@@ -1,2 +1,2 @@
-var a=Object.defineProperty;var n=(e,r)=>a(e,"name",{value:r,configurable:!0});import{openDb as i,prepared as u}from"../canvas/db.js";function l(e,r=i()){const t=u(r,`SELECT n.run_id, n.isolated, r.isolated AS root_isolated FROM nodes n
-    LEFT JOIN nodes r ON r.node_id = n.run_id WHERE n.node_id = ?`).get(e);if(!t){const o=u(r,"SELECT run_id FROM deleted_isolated_nodes WHERE node_id = ?").get(e);return o?{run:o.run_id,isolated:!0}:null}return{run:t.run_id??e,isolated:t.isolated===1||t.root_isolated===1}}n(l,"runPlace");function R(e,r=i()){const t=l(e,r);t?.isolated&&u(r,"INSERT OR REPLACE INTO deleted_isolated_nodes (node_id, run_id) VALUES (?, ?)").run(e,t.run)}n(R,"rememberDeletedIsolated");function f(e,r=i()){const t=u(r,"SELECT registered_by FROM custom_objects WHERE object = ?").get(e);return t?.registered_by?l(t.registered_by,r)??{run:t.registered_by,isolated:!1}:null}n(f,"objectPlace");function _(e,r){return e.run===r.run||!e.isolated&&!r.isolated}n(_,"runsSeeEachOther");function O(e,r,t,o,s=i()){const d=l(e,s);return d===null?!0:c(d,r,t,o,s)}n(O,"nodeMayReach");function c(e,r,t,o,s=i()){if((o??"app:terminal")!==r)return!0;const d=l(t,s);return d===null?!e.isolated:_(e,d)}n(c,"placeMayReach");function g(e,r=i()){return u(r,"SELECT node_id FROM nodes WHERE run_id = ? OR node_id = ?").all(e,e).map(t=>t.node_id)}n(g,"runNodeIds");export{O as nodeMayReach,f as objectPlace,c as placeMayReach,R as rememberDeletedIsolated,g as runNodeIds,l as runPlace,_ as runsSeeEachOther};
+var d=Object.defineProperty;var n=(t,e)=>d(t,"name",{value:e,configurable:!0});import{openDb as o}from"../canvas/db.js";async function u(t,e){e??=await o();const r=await e.prepare(`SELECT n.run_id, n.isolated, r.isolated AS root_isolated FROM nodes n
+    LEFT JOIN nodes r ON r.node_id = n.run_id WHERE n.node_id = ?`).get(t);if(!r){const a=await e.prepare("SELECT run_id FROM deleted_isolated_nodes WHERE node_id = ?").get(t);return a?{run:a.run_id,isolated:!0}:null}return{run:r.run_id??t,isolated:r.isolated===1||r.root_isolated===1}}n(u,"runPlace");async function E(t,e){e??=await o();const r=await u(t,e);r?.isolated&&await e.prepare("INSERT OR REPLACE INTO deleted_isolated_nodes (node_id, run_id) VALUES (?, ?)").run(t,r.run)}n(E,"rememberDeletedIsolated");async function w(t,e){e??=await o();const r=await e.prepare("SELECT registered_by FROM custom_objects WHERE object = ?").get(t);return r?.registered_by?await u(r.registered_by,e)??{run:r.registered_by,isolated:!1}:null}n(w,"objectPlace");function l(t,e){return t.run===e.run||!t.isolated&&!e.isolated}n(l,"runsSeeEachOther");async function R(t,e,r,a,i){i??=await o();const s=await u(t,i);return s===null?!0:await c(s,e,r,a,i)}n(R,"nodeMayReach");async function c(t,e,r,a,i){if(i??=await o(),(a??"app:terminal")!==e)return!0;const s=await u(r,i);return s===null?!t.isolated:l(t,s)}n(c,"placeMayReach");async function f(t,e){return e??=await o(),(await e.prepare("SELECT node_id FROM nodes WHERE run_id = ? OR node_id = ?").all(t,t)).map(r=>r.node_id)}n(f,"runNodeIds");export{R as nodeMayReach,w as objectPlace,c as placeMayReach,E as rememberDeletedIsolated,f as runNodeIds,u as runPlace,l as runsSeeEachOther};

package/dist/core/runs/events.d.ts

@@ -1,29 +1,29 @@
-import type { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from '../canvas/db.js';
 import type { RunEvent, RunEventFields, RunEventOf, RunEventType } from '../../api/dto/run-events.js';
 /** Every event on a run's stream, declared once in the API contract. */
 export type { RunEvent, RunEventType, RunEventOf, RunEventFields } from '../../api/dto/run-events.js';
 /** The run-notice outbox's hook: called (after the appender's commit) for every event appended to a run. */
-export declare function onRunEventAppended(hook: ((runId: string) => void) | undefined): void;
+export declare function onRunEventAppended(hook: ((runId: string) => void | Promise<void>) | undefined): void;
 /** Append one event to a run's log. `type` must be a declared run event and `fields` its fields. */
-export declare function appendRunEvent<T extends RunEventType>(db: DatabaseSync, runId: string, nodeId: string, type: T, fields: RunEventFields<T>): RunEventOf<T>;
-export declare function emitRunEvent<T extends RunEventType>(runId: string, nodeId: string, type: T, fields: RunEventFields<T>): RunEventOf<T>;
-export declare function emitRunSettlement<T extends 'node.settled' | 'child.settled'>(runId: string, nodeId: string, type: T, fields: RunEventFields<T>): void;
-export declare function readRunEvents(runId: string, after?: number): {
+export declare function appendRunEvent<T extends RunEventType>(db: CanvasDb, runId: string, nodeId: string, type: T, fields: RunEventFields<T>): Promise<RunEventOf<T>>;
+export declare function emitRunEvent<T extends RunEventType>(runId: string, nodeId: string, type: T, fields: RunEventFields<T>): Promise<RunEventOf<T>>;
+export declare function emitRunSettlement<T extends 'node.settled' | 'child.settled'>(runId: string, nodeId: string, type: T, fields: RunEventFields<T>): Promise<void>;
+export declare function readRunEvents(runId: string, after?: number): Promise<{
     events: RunEvent[];
     earliest_sequence: number | null;
     latest_sequence: number;
     backlog_count: number;
     backlog_bytes: number;
-};
-export declare function subscribeRunEvents(runId: string, wake: () => void): () => void;
+}>;
+export declare function subscribeRunEvents(runId: string, wake: () => void): Promise<() => void>;
 export declare function notifyRunDeleted(runId: string): void;
 /** OWN-11 for a joined runtime: the legacy `user:local` grantee is the terminal app. */
-export declare function rewriteLocalRunEventGrantee(db: DatabaseSync): number;
+export declare function rewriteLocalRunEventGrantee(db: CanvasDb): Promise<number>;
 /** A run event cursor stays monotonic. Keep control/settlement/usage history
  * for the observer's 30-day recovery window, but full payload events for 14
  * days only; older conversation content is in the transcript store. The stream
  * already signals a cursor gap when events have expired. Budget one page/tick. */
-export declare function expireRunEvents(now: number, limit?: number): number;
+export declare function expireRunEvents(now: number, limit?: number): Promise<number>;
 /** The conversation store is the canonical full transcript. Keep the full
  * stream for one day, then redact settled tool calls, prompts and thinking.
  * This includes older completed events of a still-live run, but tool-call
@@ -31,10 +31,10 @@ export declare function expireRunEvents(now: number, limit?: number): number;
  * An open turn's deltas and status/settlement markers are never redacted. Cursor scans
  * avoid re-searching the whole log each tick. Old event payload replay is a
  * deliberate tradeoff; event identities and 30-day sequence gaps survive. */
-export declare function compactRunEvents(now: number, afterRowid?: number, scanLimit?: number, writeLimit?: number): {
+export declare function compactRunEvents(now: number, afterRowid?: number, scanLimit?: number, writeLimit?: number): Promise<{
     cursor: number;
     compacted: number;
-};
+}>;
 /** Track an open `run.events` stream an app caller holds under `grant`. */
 export declare function registerGrantStream(grant: string, close: () => void): () => void;
 /** Close every open stream held under a grant that is no longer active. */

package/dist/core/runs/events.js

@@ -1,7 +1,7 @@
-var g=Object.defineProperty;var c=(e,t)=>g(e,"name",{value:t,configurable:!0});import{prepared as u}from"../sqlite-statements.js";import{openDb as y,withCanvasWrite as l}from"../canvas/db.js";import{repairRunConversations as O}from"../canvas/sessions.js";const _=new Map;let R;function D(e){R=e}c(D,"onRunEventAppended");function f(e,t,n,r,s){const o=u(e,"SELECT event_cursor, grantee, metadata_json FROM node_rows WHERE node_id = ? AND run_id = ?").get(t,t);if(!o||o.event_cursor===null)throw new Error(`missing run event cursor: ${t}`);const i={type:r,run_id:t,node_id:n,sequence_number:o.event_cursor,ts:new Date().toISOString(),metadata:o.metadata_json?JSON.parse(o.metadata_json):{},...s};return u(e,"INSERT INTO run_events (run_id, sequence_number, node_id, type, ts, body_json, grantee) VALUES (?, ?, ?, ?, ?, ?, ?)").run(t,i.sequence_number,n,r,i.ts,JSON.stringify(i),o.grantee),u(e,"UPDATE nodes SET event_cursor = event_cursor + 1, last_activity_at = ? WHERE node_id = ?").run(i.ts,t),queueMicrotask(()=>{for(const d of _.get(t)??[])d();try{R?.(t)}catch{}}),i}c(f,"appendRunEvent");function M(e,t,n,r){return l(s=>f(s,e,t,n,r))}c(M,"emitRunEvent");function L(e,t,n,r){l(s=>{u(s,"SELECT 1 FROM run_events WHERE run_id = ? AND node_id = ? AND type = ? AND json_extract(body_json, '$.outcome.revision') = ? LIMIT 1").get(e,t,n,r.outcome.revision)||f(s,e,t,n,r)})}c(L,"emitRunSettlement");function A(e,t=0){O(e);const n=y(),r=u(n,"SELECT event_cursor FROM nodes WHERE node_id = ? AND run_id = ?").get(e,e);if(!r)throw new Error(`run not found: ${e}`);const s=u(n,"SELECT MIN(sequence_number) AS sequence FROM run_events WHERE run_id = ?").get(e),o=u(n,"SELECT COUNT(*) AS count, COALESCE(SUM(LENGTH(body_json)), 0) AS bytes FROM run_events WHERE run_id = ? AND sequence_number > ?").get(e,t);return{events:(o.count>1e3||o.bytes>32*1024*1024?[]:u(n,"SELECT body_json FROM run_events WHERE run_id = ? AND sequence_number > ? ORDER BY sequence_number LIMIT 1000").all(e,t)).map(d=>JSON.parse(d.body_json)),earliest_sequence:s.sequence,latest_sequence:r.event_cursor-1,backlog_count:o.count,backlog_bytes:o.bytes}}c(A,"readRunEvents");function C(e,t){let n=_.get(e);return n||(n=new Set,_.set(e,n)),n.add(t),()=>{n.delete(t),n.size===0&&_.delete(e)}}c(C,"subscribeRunEvents");function H(e){queueMicrotask(()=>{for(const t of _.get(e)??[])t()})}c(H,"notifyRunDeleted");function x(e){return Number(u(e,"UPDATE run_events SET grantee = 'app:terminal' WHERE grantee = 'user:local'").run().changes)}c(x,"rewriteLocalRunEventGrantee");function W(e,t=128){return l(n=>{const r=new Date(e-12096e5).toISOString(),s=new Date(e-720*60*6e4).toISOString(),o=Number(u(n,`DELETE FROM run_events WHERE rowid IN
+var v=Object.defineProperty;var a=(e,t)=>v(e,"name",{value:t,configurable:!0});import{afterCommit as y,withCanvasWrite as _,openDb as S}from"../canvas/db.js";import{emitEvent as g}from"../events/emit.js";import{repairRunConversations as O}from"../canvas/sessions.js";const E=new Map;let w;function L(e){w=e}a(L,"onRunEventAppended");async function f(e,t,n,r,s){const o=await e.prepare("SELECT event_cursor, grantee, metadata_json FROM node_rows WHERE node_id = ? AND run_id = ?").get(t,t);if(!o||o.event_cursor===null)throw new Error(`missing run event cursor: ${t}`);const i={type:r,run_id:t,node_id:n,sequence_number:o.event_cursor,ts:new Date().toISOString(),metadata:o.metadata_json?JSON.parse(o.metadata_json):{},...s};return await e.prepare("INSERT INTO run_events (run_id, sequence_number, node_id, type, ts, body_json, grantee) VALUES (?, ?, ?, ?, ?, ?, ?)").run(t,i.sequence_number,n,r,i.ts,JSON.stringify(i),o.grantee),await e.prepare("UPDATE nodes SET event_cursor = event_cursor + 1, last_activity_at = ? WHERE node_id = ?").run(i.ts,t),y(()=>{for(const d of E.get(t)??[])d();const u=a(d=>{g({level:"error",event:"runs.notice_hook_failed",error:d})},"failed");try{Promise.resolve(w?.(t)).catch(u)}catch(d){u(d)}}),i}a(f,"appendRunEvent");async function M(e,t,n,r){return await _(async s=>await f(s,e,t,n,r))}a(M,"emitRunEvent");async function A(e,t,n,r){await _(async s=>{await s.prepare("SELECT 1 FROM run_events WHERE run_id = ? AND node_id = ? AND type = ? AND json_extract(body_json, '$.outcome.revision') = ? LIMIT 1").get(e,t,n,r.outcome.revision)||await f(s,e,t,n,r)})}a(A,"emitRunSettlement");async function C(e,t=0){await O(e);const n=await S(),r=await n.prepare("SELECT event_cursor FROM nodes WHERE node_id = ? AND run_id = ?").get(e,e);if(!r)throw new Error(`run not found: ${e}`);const s=await n.prepare("SELECT MIN(sequence_number) AS sequence FROM run_events WHERE run_id = ?").get(e),o=await n.prepare("SELECT COUNT(*) AS count, COALESCE(SUM(LENGTH(body_json)), 0) AS bytes FROM run_events WHERE run_id = ? AND sequence_number > ?").get(e,t);return{events:(o.count>1e3||o.bytes>32*1024*1024?[]:await n.prepare("SELECT body_json FROM run_events WHERE run_id = ? AND sequence_number > ? ORDER BY sequence_number LIMIT 1000").all(e,t)).map(u=>JSON.parse(u.body_json)),earliest_sequence:s.sequence,latest_sequence:r.event_cursor-1,backlog_count:o.count,backlog_bytes:o.bytes}}a(C,"readRunEvents");async function H(e,t){let n=E.get(e);return n||(n=new Set,E.set(e,n)),n.add(t),()=>{n.delete(t),n.size===0&&E.delete(e)}}a(H,"subscribeRunEvents");function x(e){queueMicrotask(()=>{for(const t of E.get(e)??[])t()})}a(x,"notifyRunDeleted");async function W(e){return Number((await e.prepare("UPDATE run_events SET grantee = 'app:terminal' WHERE grantee = 'user:local'").run()).changes)}a(W,"rewriteLocalRunEventGrantee");async function h(e,t=128){return await _(async n=>{const r=new Date(e-12096e5).toISOString(),s=new Date(e-720*60*6e4).toISOString(),o=Number((await n.prepare(`DELETE FROM run_events WHERE rowid IN
       (SELECT rowid FROM run_events WHERE ts < ? AND type IN
         ('node.tool_call.completed', 'node.tool_call.started', 'node.system_prompt.set',
-         'node.thinking.done', 'node.output_text.done') ORDER BY ts LIMIT ?)`).run(r,t).changes),i=Number(u(n,`DELETE FROM run_events WHERE rowid IN
-      (SELECT rowid FROM run_events WHERE ts < ? ORDER BY ts LIMIT ?)`).run(s,t-o).changes);return o+i})}c(W,"expireRunEvents");function h(e,t=0,n=256,r=8){return l(s=>{const o=u(s,`SELECT e.rowid, e.type, e.ts, length(e.body_json) AS bytes,
+         'node.thinking.done', 'node.output_text.done') ORDER BY ts LIMIT ?)`).run(r,t)).changes),i=Number((await n.prepare(`DELETE FROM run_events WHERE rowid IN
+      (SELECT rowid FROM run_events WHERE ts < ? ORDER BY ts LIMIT ?)`).run(s,t-o)).changes);return o+i})}a(h,"expireRunEvents");async function j(e,t=0,n=256,r=8){return await _(async s=>{const o=await s.prepare(`SELECT e.rowid, e.type, e.ts, length(e.body_json) AS bytes,
       n.finalized_at FROM run_events e LEFT JOIN nodes n ON n.node_id = e.node_id
-      WHERE e.rowid > ? ORDER BY e.rowid LIMIT ?`).all(t,n);if(!o.length)return{cursor:0,compacted:0};let i=0,d=t;const m=new Date(e-1440*6e4).toISOString(),S=u(s,"SELECT body_json FROM run_events WHERE rowid = ?"),v=u(s,"UPDATE run_events SET body_json = ? WHERE rowid = ?");for(const a of o){if(d=a.rowid,!["node.tool_call.completed","node.tool_call.started","node.system_prompt.set","node.thinking.done"].includes(a.type)||a.ts>=m||a.bytes<1024||a.type==="node.tool_call.started"&&!a.finalized_at)continue;const E=JSON.parse(S.get(a.rowid).body_json);if(E.content_redacted!==!0&&(a.type==="node.tool_call.completed"?delete E.result:a.type==="node.tool_call.started"?delete E.arguments:delete E.text,E.content_redacted=!0,v.run(JSON.stringify(E),a.rowid),++i>=r))break}return{cursor:d,compacted:i}})}c(h,"compactRunEvents");const p=new Map;function j(e,t){let n=p.get(e);return n||(n=new Set,p.set(e,n)),n.add(t),()=>{n.delete(t),n.size===0&&p.delete(e)}}c(j,"registerGrantStream");function q(e){const t=[...p.get(e)??[]];for(const n of t)n();return t.length}c(q,"closeGrantStreams");export{f as appendRunEvent,q as closeGrantStreams,h as compactRunEvents,M as emitRunEvent,L as emitRunSettlement,W as expireRunEvents,H as notifyRunDeleted,D as onRunEventAppended,A as readRunEvents,j as registerGrantStream,x as rewriteLocalRunEventGrantee,C as subscribeRunEvents};
+      WHERE e.rowid > ? ORDER BY e.rowid LIMIT ?`).all(t,n);if(!o.length)return{cursor:0,compacted:0};let i=0,u=t;const d=new Date(e-1440*6e4).toISOString(),R=s.prepare("SELECT body_json FROM run_events WHERE rowid = ?"),m=s.prepare("UPDATE run_events SET body_json = ? WHERE rowid = ?");for(const c of o){if(u=c.rowid,!["node.tool_call.completed","node.tool_call.started","node.system_prompt.set","node.thinking.done"].includes(c.type)||c.ts>=d||c.bytes<1024||c.type==="node.tool_call.started"&&!c.finalized_at)continue;const p=JSON.parse((await R.get(c.rowid)).body_json);if(p.content_redacted!==!0&&(c.type==="node.tool_call.completed"?delete p.result:c.type==="node.tool_call.started"?delete p.arguments:delete p.text,p.content_redacted=!0,await m.run(JSON.stringify(p),c.rowid),++i>=r))break}return{cursor:u,compacted:i}})}a(j,"compactRunEvents");const l=new Map;function F(e,t){let n=l.get(e);return n||(n=new Set,l.set(e,n)),n.add(t),()=>{n.delete(t),n.size===0&&l.delete(e)}}a(F,"registerGrantStream");function q(e){const t=[...l.get(e)??[]];for(const n of t)n();return t.length}a(q,"closeGrantStreams");export{f as appendRunEvent,q as closeGrantStreams,j as compactRunEvents,M as emitRunEvent,A as emitRunSettlement,h as expireRunEvents,x as notifyRunDeleted,L as onRunEventAppended,C as readRunEvents,F as registerGrantStream,W as rewriteLocalRunEventGrantee,H as subscribeRunEvents};

package/dist/core/runs/operations.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from '../canvas/db.js';
 import type { NodeMeta } from '../canvas/types.js';
 import type { AppPrincipal } from '../../daemon/api/principal.js';
 import { type ResolvedAttachments } from '../storage/attachments.js';
@@ -13,7 +13,7 @@ export interface StorageDeps {
     budgetMs?: number;
 }
 /** OWN-11 for a joined runtime: the legacy `user:local` grantee is the terminal app. */
-export declare function rewriteLocalIdempotencyGrantee(db: DatabaseSync): number;
+export declare function rewriteLocalIdempotencyGrantee(db: CanvasDb): Promise<number>;
 export declare class RunError extends Error {
     readonly status: number;
     readonly code: string;
@@ -23,17 +23,17 @@ export declare class RunError extends Error {
     readonly retryable: boolean;
     constructor(status: number, code: string, message: string, param?: string | undefined, details?: unknown | undefined, scope?: string | undefined, retryable?: boolean);
 }
-export declare function ownedRun(id: string, grantee: string, allowDeleting?: boolean): NodeMeta;
+export declare function ownedRun(id: string, grantee: string, allowDeleting?: boolean): Promise<NodeMeta>;
 export type RunStatus = 'running' | 'waiting_on_user' | 'idle' | 'settled';
 /** Whether the run has a turn in flight or work owed to it (the `running` run status). */
-export declare function runIsRunning(runId: string): boolean;
-export declare function runObject(root: NodeMeta): Record<string, unknown>;
+export declare function runIsRunning(runId: string): Promise<boolean>;
+export declare function runObject(root: NodeMeta): Promise<Record<string, unknown>>;
 /** How long a kept key replays: a record this old or older reads as absent. The SDK's conformance scenarios hold FakeCloud to it. */
 export declare const IDEMPOTENCY_WINDOW_MS = 86400000;
 /** An `Idempotency-Key` header value: absent, or 1–255 characters. */
 export declare function idempotencyKeyOf(header: unknown): string | undefined;
 /** Delete keys past their window; returns how many were removed. */
-export declare function pruneExpiredIdempotencyKeys(now?: number): number;
+export declare function pruneExpiredIdempotencyKeys(now?: number): Promise<number>;
 /** Longest `run.start` deadline an app may set: 24 hours. The grammar is `crtr node new --deadline`'s (parts of `<int>[smhd]`, summed). */
 export declare const RUN_DEADLINE_MAX_MS: number;
 /** The milliseconds of a `run.start` `deadline` duration; refuses a malformed, zero, or over-24h value as `invalid_request` on `deadline`. */
@@ -54,11 +54,11 @@ export declare function listRuns(grantee: string | null, options: {
     status?: string;
     after?: string;
     limit: number;
-    visible?: (runId: string) => boolean;
-}): {
+    visible?: (runId: string) => Promise<boolean>;
+}): Promise<{
     runs: Record<string, unknown>[];
     next: string | null;
-};
+}>;
 export declare function waitRun(id: string, grantee: string, seconds: number): Promise<Record<string, unknown>>;
 export declare function messageRun(root: NodeMeta, original: string, resolveAttachments?: AttachmentResolver, startTurn?: boolean, idempotencyKey?: string): Promise<{
     run_id: string;
@@ -73,11 +73,11 @@ export declare function cancelRun(root: NodeMeta, _options?: {
 export declare const RUN_NAME_MAX = 200;
 /** `run.rename`: set the root node's name — the name `crtr` shows for the node —
  *  through the same path as `PATCH /v1/nodes/:id/config` `name`. */
-export declare function renameRun(root: NodeMeta, name: unknown): Record<string, unknown>;
+export declare function renameRun(root: NodeMeta, name: unknown): Promise<Record<string, unknown>>;
 /** Delete a run. Answers how many of the run's released uploads storage has
  *  not confirmed deleted; the due-work tick retries those. */
 export declare function deleteRun(root: NodeMeta, storage?: StorageDeps): Promise<{
     uploads_pending: number;
 }>;
-export declare function traceRun(id: string, grantee: string, format?: string): Record<string, unknown>;
+export declare function traceRun(id: string, grantee: string, format?: string): Promise<Record<string, unknown>>;
 export declare function requestedScopes(held: readonly string[], value: unknown, grantee: string): string[] | null;