@north-light/cli 0.0.0-stage → 0.3.413

package/dist/daemon/review/finish.d.ts

@@ -0,0 +1,27 @@
+import { type ReviewRecord, type ReviewResult } from '../../core/review/types.js';
+export interface ReviewApprovalFinishOutcome {
+    outcome: 'settled' | 'already_settled';
+    record: ReviewRecord;
+    result: ReviewResult;
+}
+export interface ReviewSubmitDeferredOutcome {
+    outcome: 'awaiting_companion';
+    record: ReviewRecord;
+}
+export type ReviewSubmitOutcome = ReviewApprovalFinishOutcome | ReviewSubmitDeferredOutcome;
+export interface ReviewCancellationFinishOutcome {
+    outcome: 'settled' | 'already_settled';
+    record: ReviewRecord;
+}
+export type ReviewFinishOutcome = ReviewApprovalFinishOutcome | ReviewCancellationFinishOutcome;
+export declare function submitReviewApproval(reviewId: string): Promise<ReviewSubmitOutcome>;
+export declare function completeRequestedSubmit(reviewId: string, opts: {
+    atCompanionTurnEnd: boolean;
+}): Promise<ReviewApprovalFinishOutcome | null>;
+export declare function completeCompanionRequestedSubmit(companionNodeId: string): Promise<ReviewApprovalFinishOutcome | null>;
+export interface ReviewCancellationArgs {
+    reason?: string;
+    actor?: string;
+    disposition?: 'canceled' | 'dismissed';
+}
+export declare function cancelReview(reviewId: string, args?: ReviewCancellationArgs): Promise<ReviewCancellationFinishOutcome>;

package/dist/daemon/review/finish.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var n=(e,t)=>g(e,"name",{value:t,configurable:!0});import{withCanvasWrite as j}from"../../core/canvas/db.js";import{get as S}from"../../core/graph/bodies.js";import{documentById as q,editDocument as C,heads as $}from"../../core/graph/documents.js";import{readerFor as k}from"../../core/graph/reader.js";import{checkoutsForCwd as J}from"../../core/graph/repo-sync/repos.js";import{snapshotCommentsLocked as x}from"../../core/review/comments.js";import{readReviewSource as N}from"../../core/review/document.js";import{projectReviewCancellation as O,projectReviewResult as T,buildReviewResult as A}from"../../core/review/project.js";import{signalReviewActivity as p}from"../../core/review/signal.js";import{clearReviewSubmit as D,getReview as E,getReviewByCompanion as B,requestReviewSubmit as F,requireVisibleReview as u}from"../../core/review/store.js";import{ReviewOperationError as f}from"../../core/review/types.js";import{settleHumanRequest as w}from"../human/settle.js";import{retireCompanion as h}from"../companion-retire.js";import{companionHasQueuedWork as W,companionMidTurn as H,companionStillWorking as M}from"./companion.js";import{renderApprovalMessage as L}from"./deliver.js";function _(){return new Date().toISOString()}n(_,"now");function l(e,t){throw new f("review_terminal","review already has a terminal outcome",{state:e.state,requested:t,review:e})}n(l,"terminalConflict");function v(e){if(e.result_json===null)throw new Error(`approved review lacks its immutable result: ${e.review_id}`);return JSON.parse(e.result_json)}n(v,"approvedResult");function y(e){return`${e.review_dir}/result.json`}n(y,"resultPath");function P(e){return{project:n(t=>{T(u(t.request_id),e)},"project"),retire:n(async(t,o)=>{await h(t,o)},"retire")}}n(P,"effects");function Q(e){return{label:"review approved by the user",disposition:null,body_json:{review_id:e.review_id,result_path:y(e),body:L(e,y(e))}}}n(Q,"approvalNotification");function V(e,t,o){const s=o==="dismissed";return{label:s?"review dismissed":"review canceled",disposition:"human-canceled",body_json:{review_id:e.review_id,disposition:o,body:s?`The review of \`${e.document_name??e.file}\` was dismissed without approval.`:`The review of \`${e.document_name??e.file}\` was canceled${t===""?"":` \u2014 ${t}`}.`}}}n(V,"cancellationNotification");function z(e,t,o){if(t.document_id===null||t.document_base===null)return;const s=n(d=>J(e,d),"reposFn"),i=q(e,t.document_id),a=k(e,{class:"person"},s),c=C(e,a,i,{body:o},`edited in review ${t.review_id}`,t.document_base,{},s);if(!("stale"in c))return;const r=$(e,i);if(!(r.length===1&&S(r[0].body_hash)===o))throw new f("stale_revision",`${t.document_name??i.name} changed since the review began; the reviewed text was not saved`,{review_id:t.review_id,document:t.document_name??i.name,base:t.document_base,heads_key:c.stale.heads_key,revision:c.stale.revision,next:`Read the current revision with \`crtr canvas read ${i.id}\`, then start a new review of it.`})}n(z,"saveReviewedDocument");async function b(e){if(e.state==="canceled")return l(e,"submit");if(e.state==="approved")return{outcome:"already_settled",record:e,result:v(e)};const t=N(e.file,"submit"),{result:o,resultJson:s}=j(c=>{const r=u(e.review_id);if(r.state==="canceled")return l(r,"submit");if(r.state==="approved")return{result:v(r),resultJson:r.result_json};const d=x(c,r.review_id),m=A(r,d,t.sha256,_());return m.changed&&z(c,r,new TextDecoder("utf-8").decode(t.bytes)),{result:m,resultJson:JSON.stringify(m)}}),i=await w({request_id:e.review_id,outcome:"approved",result_json:s,notification:Q({...e,changed:o.changed}),post_commit:P(o)});i.outcome==="settled"&&p();const a=u(e.review_id);return i.outcome==="already_settled"&&a.state!=="approved"?l(a,"submit"):{outcome:i.outcome,record:a,result:i.outcome==="settled"?o:v(a)}}n(b,"approveReview");async function de(e){const t=u(e);return t.state==="canceled"?l(t,"submit"):t.state==="open"&&M(t.companion_node_id)?(F(e,_())&&p(),{outcome:"awaiting_companion",record:u(e)}):b(t)}n(de,"submitReviewApproval");async function G(e,t){const o=E(e);if(o===null||o.state!=="open"||o.submit_requested_at===null||W(o.companion_node_id)||!t.atCompanionTurnEnd&&H(o.companion_node_id))return null;try{return await b(o)}catch(s){throw s instanceof f&&s.code==="stale_revision"&&(D(e),p()),s}}n(G,"completeRequestedSubmit");async function me(e){const t=B(e);return t===null?null:G(t.review_id,{atCompanionTurnEnd:!0})}n(me,"completeCompanionRequestedSubmit");async function le(e,t={}){const o=u(e);if(o.state==="approved")return l(o,"cancel");const s=_(),i=t.reason??"",a=t.disposition??"canceled",c=JSON.stringify({schema:"humanloop.cancel/v1",kind:"canceled",canceledAt:s,...i===""?{}:{reason:i},...t.actor===void 0?{}:{actor:t.actor},...a==="dismissed"?{disposition:a}:{}}),r=await w({request_id:e,outcome:a==="dismissed"?"dismissed":"canceled",result_json:c,notification:V(o,i,a),post_commit:{project:n(m=>{O(u(m.request_id),JSON.parse(c))},"project"),retire:n(async(m,R)=>{await h(m,R)},"retire")}});r.outcome==="settled"&&p();const d=u(e);return r.outcome==="already_settled"&&d.state==="approved"?l(d,"cancel"):{outcome:r.outcome,record:d}}n(le,"cancelReview");export{le as cancelReview,me as completeCompanionRequestedSubmit,G as completeRequestedSubmit,de as submitReviewApproval};

package/dist/daemon/review/sweep.d.ts

@@ -0,0 +1,4 @@
+import { type HumanRequestSweepResult } from '../human/sweep.js';
+export type ReviewSweepResult = HumanRequestSweepResult;
+/** Compatibility entry point for daemon boot. All recovery is driven by human_requests. */
+export declare function sweepReviews(): Promise<ReviewSweepResult>;

package/dist/daemon/review/sweep.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var i=(r,e)=>o(r,"name",{value:e,configurable:!0});import{requireVisibleReview as t}from"../../core/review/store.js";import{projectReviewResult as s}from"../../core/review/project.js";import{realizeReview as m}from"../../core/review/realize.js";import{retireCompanion as n}from"../companion-retire.js";import{sweepHumanRequests as p}from"../human/sweep.js";async function f(){return p({realizeReview:m,projectReview:i(r=>{const e=t(r.request_id);if(e.result_json===null)throw new Error(`approved review lacks its immutable result: ${e.review_id}`);s(e,JSON.parse(e.result_json))},"projectReview"),retireCompanion:i(async(r,e)=>{await n(r,e)},"retireCompanion")})}i(f,"sweepReviews");export{f as sweepReviews};

package/dist/daemon/run-notices.d.ts

@@ -0,0 +1,49 @@
+export declare const RUN_NOTICE_SCOPE = "crtr:run_notice";
+/** Wait before the second and third attempt of one notice. */
+export declare const RUN_NOTICE_RETRY_WAITS_MS: readonly number[];
+/** Minimum gap before the next notice of a run after a 2xx. */
+export declare const RUN_NOTICE_ACK_GAP_MS = 5000;
+/** Quiet period for a run after a notice was dropped. */
+export declare const RUN_NOTICE_FAIL_GAP_MS = 60000;
+export declare const RUN_NOTICE_ATTEMPT_TIMEOUT_MS = 10000;
+export interface NoticeTarget {
+    url: string;
+    sub: string;
+    grantee: string;
+}
+export interface NoticeToken {
+    access_token: string;
+    key: string;
+}
+export interface RunNoticeDeps {
+    /** The run's notice target, or null when the run never notifies. */
+    target(runId: string): NoticeTarget | null;
+    /** The run's highest event sequence. */
+    latest(runId: string): number | null;
+    token(target: NoticeTarget): Promise<NoticeToken>;
+    discard(key: string): void;
+    fetch: typeof fetch;
+    now(): number;
+    retryWaitsMs: readonly number[];
+    ackGapMs: number;
+    failGapMs: number;
+}
+export declare class RunNoticeOutbox {
+    private readonly deps;
+    private readonly runs;
+    constructor(deps: RunNoticeDeps);
+    private state;
+    private forget;
+    /** A `run.events` stream opened on the run. Returns its release, called with the last sequence the stream wrote. */
+    streamOpened(runId: string): (lastWritten: number) => void;
+    /** An event was appended to the run's log. */
+    appended(runId: string): void;
+    private owe;
+    private schedule;
+    private deliver;
+    private attempt;
+}
+/** The daemon's wiring: targets and sequences from the canvas database, tokens from the directory mint. */
+export declare function databaseDeps(): RunNoticeDeps;
+/** The daemon's outbox. */
+export declare function runNotices(): RunNoticeOutbox;

package/dist/daemon/run-notices.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var a=(n,t)=>p(n,"name",{value:t,configurable:!0});import{prepared as d}from"../core/sqlite-statements.js";import{openDb as f}from"../core/canvas/db.js";import{runNoticeTarget as m}from"../core/grants/mirror.js";import{emitEvent as w}from"../core/events/emit.js";import{discardFile as _}from"../core/providers/token-cache.js";import{outboundToken as g}from"../core/providers/mint.js";const y="crtr:run_notice",A=[3e3,5e3],E=5e3,T=6e4,k=1e4;class u extends Error{static{a(this,"Fault")}retryable;status;constructor(t,e,s){super(t),this.retryable=e,this.status=s}}class x{static{a(this,"RunNoticeOutbox")}deps;runs=new Map;constructor(t){this.deps=t}state(t){let e=this.runs.get(t);return e||(e={streams:0,owed:!1,inFlight:!1,timer:void 0,nextAllowedAt:0},this.runs.set(t,e)),e}forget(t,e){e.streams===0&&!e.owed&&!e.inFlight&&e.timer===void 0&&e.nextAllowedAt<=this.deps.now()&&this.runs.delete(t)}streamOpened(t){const e=this.state(t);e.streams++,e.owed=!1,e.nextAllowedAt=0,e.timer&&(clearTimeout(e.timer),e.timer=void 0);let s=!1;return l=>{if(s)return;s=!0,e.streams--;let o=null;try{o=this.deps.latest(t)}catch{}e.streams===0&&o!==null&&o>l?this.owe(t):this.forget(t,e)}}appended(t){const e=this.runs.get(t);e&&e.streams>0||this.owe(t)}owe(t){let e;try{e=this.deps.target(t)}catch{return}if(e===null)return;const s=this.state(t);s.streams>0||(s.owed=!0,this.schedule(t,s))}schedule(t,e){if(!e.owed||e.inFlight||e.timer!==void 0||e.streams>0)return;const s=Math.max(0,e.nextAllowedAt-this.deps.now());e.timer=setTimeout(()=>{e.timer=void 0,this.deliver(t,e)},s),e.timer.unref()}async deliver(t,e){if(!e.owed||e.streams>0){this.forget(t,e);return}const s=this.deps.target(t),l=this.deps.latest(t);if(s===null||l===null){e.owed=!1,this.forget(t,e);return}e.owed=!1,e.inFlight=!0;let o=0,r;try{for(;;){o++;try{await this.attempt(s,t,l),r=void 0;break}catch(i){r=i instanceof u?i:new u(i instanceof Error?i.message:String(i),!0);const c=this.deps.retryWaitsMs[o-1];if(!r.retryable||c===void 0)break;if(await new Promise(h=>{setTimeout(h,c).unref()}),e.streams>0){r=void 0;break}}}}finally{e.inFlight=!1}r?(e.nextAllowedAt=this.deps.now()+this.deps.failGapMs,w({level:"error",event:"run_notice.failed",fields:{run_id:t,url:s.url,grantee:s.grantee,attempts:o,latest_sequence:l,...r.status===void 0?{}:{status:r.status},error:r.message}})):e.streams===0&&(e.nextAllowedAt=this.deps.now()+this.deps.ackGapMs),this.schedule(t,e),this.forget(t,e)}async attempt(t,e,s){for(let l=0;;l++){let o;try{o=await this.deps.token(t)}catch(i){throw new u(`token mint failed: ${i instanceof Error?i.message:String(i)}`,!0)}let r;try{r=await this.deps.fetch(t.url,{method:"POST",redirect:"manual",signal:AbortSignal.timeout(k),headers:{Authorization:`Bearer ${o.access_token}`,"Content-Type":"application/json"},body:JSON.stringify({run_id:e,latest_sequence:s})})}catch(i){throw new u(`request failed: ${i instanceof Error?i.message:String(i)}`,!0)}if(r.body?.cancel().catch(()=>{}),r.status>=200&&r.status<300)return;if(r.status===401){if(this.deps.discard(o.key),l===0)continue;throw new u("the app refused the notice token twice (401)",!0,401)}throw r.status>=500?new u(`the app answered ${r.status}`,!0,r.status):new u(`contract_fault: the app answered ${r.status}`,!1,r.status)}}}function M(){return{target:a(n=>{const t=d(f(),"SELECT grant_id FROM nodes WHERE node_id = ? AND run_id = ?").get(n,n);return t?.grant_id?m(t.grant_id):null},"target"),latest:a(n=>{const t=d(f(),"SELECT event_cursor FROM nodes WHERE node_id = ? AND run_id = ?").get(n,n);return t?.event_cursor==null?null:t.event_cursor-1},"latest"),token:a(async n=>{const t=await g({audience:n.url,sub:n.sub,grantee:n.grantee,initiating_app:n.grantee,scope:[y]});return{access_token:t.access_token,key:t.key}},"token"),discard:_,fetch:a((n,t)=>fetch(n,t),"fetch"),now:Date.now,retryWaitsMs:A,ackGapMs:E,failGapMs:T}}a(M,"databaseDeps");let N;function P(){return N??=new x(M())}a(P,"runNotices");export{E as RUN_NOTICE_ACK_GAP_MS,k as RUN_NOTICE_ATTEMPT_TIMEOUT_MS,T as RUN_NOTICE_FAIL_GAP_MS,A as RUN_NOTICE_RETRY_WAITS_MS,y as RUN_NOTICE_SCOPE,x as RunNoticeOutbox,M as databaseDeps,P as runNotices};

package/dist/daemon/runs/append-section.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { SessionEntry } from '../../core/conversation-store/index.js';
+export declare const TURN_INPUT_TYPE = "crtr-turn-input";
+export declare const SYSTEM_PROMPT_TYPE = "crtr-system-prompt";
+export declare const TURN_END_TYPE = "crtr-turn-end";
+export declare function appendConversationEvents(db: DatabaseSync, runId: string, nodeId: string, entries: SessionEntry[], pendingInputIds: string[]): string[];

package/dist/daemon/runs/append-section.js

@@ -0,0 +1,2 @@
+var T=Object.defineProperty;var u=(t,e)=>T(t,"name",{value:e,configurable:!0});import{prepared as d}from"../../core/sqlite-statements.js";import{appendRunEvent as p}from"../../core/runs/events.js";import{openQuestionIds as h}from"../../core/runs/questions.js";import{getNode as x}from"../../core/canvas/canvas.js";import{runSchemaRepromptPending as N}from"../../core/runtime/stop-guard.js";const S="crtr-turn-input",k="crtr-system-prompt",w="crtr-turn-end",y=u(()=>({input_tokens:0,output_tokens:0,cache_read_tokens:0,cache_write_tokens:0,cost_usd:0}),"zero");function D(t){return typeof t=="string"?t:Array.isArray(t)?t.filter(e=>typeof e?.text=="string").map(e=>e.text).join(`
+`):""}u(D,"text");function O(t){if(t==null)return;const{code:e,message:r}=t;if(e!=="content_refused"&&e!=="model_error"||typeof r!="string")throw new Error("invalid crtr-turn-end error");return{code:e,message:r}}u(O,"turnEndError");function j(t){return{input_tokens:t.input??0,output_tokens:t.output??0,cache_read_tokens:t.cacheRead??0,cache_write_tokens:t.cacheWrite??0,cost_usd:t.cost?.total??0}}u(j,"usageParts");function H(t,e,r,g,R){let l=R;for(const n of g){if(n.type==="custom"&&n.customType===S){const o=n.data?.message_ids;if(!Array.isArray(o)||!o.every(i=>typeof i=="string"))throw new Error("invalid crtr-turn-input message_ids");l=[...new Set([...l,...o])]}if(n.type==="custom"&&n.customType===k){const o=n.data?.text;if(typeof o!="string")throw new Error("invalid crtr-system-prompt text");p(t,e,r,"node.system_prompt.set",{entry_id:n.id,text:o})}if(n.type==="custom"&&n.customType===w){const o=n.data,i=o?.stop_reason;if(typeof i!="string")throw new Error("invalid crtr-turn-end stop_reason");const a=O(o?.error),s=d(t,"SELECT body_json FROM run_events WHERE run_id = ? AND node_id = ? AND type = 'node.turn.started' ORDER BY sequence_number DESC LIMIT 1").get(e,r);if(!s)throw new Error("crtr-turn-end without node.turn.started");const{input:_}=JSON.parse(s.body_json),f=d(t,"SELECT status, pi_pid FROM node_rows WHERE run_id = ? AND node_id != ?").all(e,r),c=r===e?x(e):null,m=f.some(E=>E.pi_pid!==null&&E.status==="active")||c!==null&&N(c)?"running":h(e,t).length?"waiting_on_user":"idle";p(t,e,r,"node.turn.completed",{entry_id:n.id,message_ids:_.message_ids,run_status:m,stop_reason:i,...a?{error:a}:{}}),r===e&&d(t,"UPDATE nodes SET last_turn_error_json = ? WHERE node_id = ?").run(a?JSON.stringify(a):null,e)}if(n.type==="message"){const o=n.message;if(o.role==="user"){const i=d(t,"SELECT type, body_json 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,r),a=i?.type==="node.turn.started"?JSON.parse(i.body_json).input.message_ids:[];p(t,e,r,"node.turn.started",{entry_id:n.id,input:{text:D(o.content),message_ids:[...new Set([...a,...l])]}}),l=[]}if(o.role==="assistant"){let i=!1;const a=u(()=>{if(i)return;i=!0;const s=o.content.filter(_=>_.type==="text").map(_=>_.text).join("");p(t,e,r,"node.output_text.done",{entry_id:n.id,text:s,stop_reason:o.stopReason})},"doneText");for(const s of o.content)s.type==="thinking"&&p(t,e,r,"node.thinking.done",{entry_id:n.id,text:s.thinking}),s.type==="text"&&a(),s.type==="toolCall"&&(a(),p(t,e,r,"node.tool_call.started",{entry_id:n.id,tool_call_id:s.id,name:s.name,arguments:s.arguments}));if(a(),o.usage){const s=j(o.usage),_=d(t,"SELECT usage_json FROM nodes WHERE node_id = ?").get(e),f=_.usage_json?JSON.parse(_.usage_json):y(),c=y();for(const m of Object.keys(c))c[m]=f[m]+s[m];d(t,"UPDATE nodes SET usage_json = ? WHERE node_id = ?").run(JSON.stringify(c),e),p(t,e,r,"usage",{entry_id:n.id,served_model:o.model,...s,usage:c})}d(t,"DELETE FROM run_events WHERE run_id = ? AND node_id = ? AND type IN ('node.thinking.delta', 'node.output_text.delta')").run(e,r)}o.role==="toolResult"&&p(t,e,r,"node.tool_call.completed",{entry_id:n.id,tool_call_id:o.toolCallId,name:o.toolName,result:o.content,status:o.isError?"error":"ok"})}}return l}u(H,"appendConversationEvents");export{k as SYSTEM_PROMPT_TYPE,w as TURN_END_TYPE,S as TURN_INPUT_TYPE,H as appendConversationEvents};

package/dist/daemon/runs/observer.d.ts

@@ -0,0 +1,14 @@
+export declare function openAssistantMessageStartSequence(nodeId: string): number | null;
+/** What the model is streaming now in a node's open assistant message. */
+export type OpenAssistantBlock = {
+    kind: 'thinking' | 'text';
+} | {
+    kind: 'tool_call';
+    name: string;
+};
+/** The newest block of the node's open assistant message; null when no message is open or nothing has streamed yet. */
+export declare function openAssistantBlock(nodeId: string): OpenAssistantBlock | null;
+export declare function ensureRunObserver(nodeId: string, runId: string): void;
+/** Observes run nodes with a live broker, plus those whose current outcome
+ *  (settled within the event retention window) has no `node.settled` event yet. */
+export declare function pollRunObservers(): void;

package/dist/daemon/runs/observer.js

@@ -0,0 +1,4 @@
+var E=Object.defineProperty;var u=(i,t)=>E(i,"name",{value:t,configurable:!0});import{prepared as r}from"../../core/sqlite-statements.js";import{randomUUID as S}from"node:crypto";import{openDb as h}from"../../core/canvas/db.js";import{getNode as p}from"../../core/canvas/canvas.js";import{BrokerClient as k,SocketTransport as I}from"../../core/broker-client/client.js";import{emitRunEvent as c,emitRunSettlement as _}from"../../core/runs/events.js";import{cancelOpenQuestions as D}from"../../core/runs/questions.js";import{emitEvent as T}from"../../core/events/emit.js";import{toRunOutcomeDTO as O}from"../api/map.js";import{readOutputResult as R}from"../../core/runtime/structured-output.js";const N=JSON.stringify({input_tokens:0,output_tokens:0,cache_read_tokens:0,cache_write_tokens:0,cost_usd:0}),l=new Map,A=250;class v{static{u(this,"RunObserver")}nodeId;runId;client;timer;status;outcomeRevision;openAssistant=!1;assistantStartSequence=0;block=null;thinking="";output="";pendingThinking="";pendingOutput="";flushTimer;closed=!1;constructor(t,e){this.nodeId=t,this.runId=e;const s=h(),n=r(s,"SELECT body_json FROM run_events WHERE node_id = ? AND type = ? ORDER BY sequence_number DESC LIMIT 1").get(t,t===e?"node.settled":"child.settled");n&&(this.outcomeRevision=JSON.parse(n.body_json).outcome.revision);const o=r(s,"SELECT body_json FROM run_events WHERE node_id = ? AND type = 'node.status.changed' ORDER BY sequence_number DESC LIMIT 1").get(t);o&&(this.status=JSON.parse(o.body_json).status),this.timer=setInterval(()=>this.poll(),250),this.timer.unref(),l.set(t,this),this.poll()}poll(){const t=p(this.nodeId);if(!t||t.run_id!==this.runId){this.close();return}const e=t.pi_pid===null?"dormant":t.status;this.status!==e&&c(this.runId,this.nodeId,"node.status.changed",{status:e,reason:t.intent??null}),this.status=e;const s=O(t);if(s&&s.revision!==this.outcomeRevision&&Date.now()-Date.parse(s.settled_at)<720*60*6e4){if(this.nodeId===this.runId){const n=r(h(),"SELECT node_id FROM nodes WHERE run_id = ? AND node_id != ? ORDER BY created DESC").all(this.runId,this.runId);for(const o of n)f(o.node_id,this.runId),l.get(o.node_id)?.poll()}if(this.outcomeRevision=s.revision,this.nodeId===this.runId){const n=s.kind==="result"?R(this.nodeId,t.grantee):void 0;_(this.runId,this.nodeId,"node.settled",{outcome:s,usage:JSON.parse(t.usage_json??N),...n===void 0?{}:{result:n}})}else _(this.runId,this.nodeId,"child.settled",{child_node_id:this.nodeId,outcome:s});if(t.grantee&&t.grantee!=="app:terminal"){const n=this.nodeId===this.runId?{run_id:this.runId}:{node_id:this.nodeId};D(n,this.nodeId===this.runId?"the run settled":"the asking node was closed").catch(o=>T({level:"error",event:"daemon.runs.question_cancel_failed",node_id:this.nodeId,error:o}))}}t.pi_pid===null?this.close():this.connect()}get assistantMessageStartSequence(){return this.openAssistant&&this.client&&p(this.nodeId)?.pi_pid!=null?this.assistantStartSequence:null}get openBlock(){return this.assistantMessageStartSequence===null?null:this.block}connect(){if(this.client||this.closed)return;const t=new k(this.nodeId,{transport:new I(this.nodeId,{recordsViewerFaults:!1})});this.client=t,t.on("connect",()=>t.send({type:"hello",role:"observer",client_id:S(),attends:!1})),t.on("frame",e=>{if(e.type==="message_start"&&e.message.role==="assistant"&&(this.discardDeltas(),this.openAssistant=!0,this.block=null,this.thinking="",this.output="",this.assistantStartSequence=r(h(),"SELECT event_cursor FROM nodes WHERE node_id = ?").get(this.runId).event_cursor),e.type==="message_update"&&e.message.role==="assistant"&&this.openAssistant){const s=e.message.content;if(!Array.isArray(s))return;const n=s.at(-1);n&&typeof n=="object"&&"type"in n&&(n.type==="toolCall"?this.block={kind:"tool_call",name:"name"in n&&typeof n.name=="string"?n.name:""}:(n.type==="text"||n.type==="thinking")&&(this.block={kind:n.type}));const o=s.filter(d=>d?.type==="thinking").map(d=>d.thinking).join(""),a=s.filter(d=>d?.type==="text").map(d=>d.text).join(""),m=o.startsWith(this.thinking)?o.slice(this.thinking.length):o,g=a.startsWith(this.output)?a.slice(this.output.length):a;this.thinking=o,this.output=a,this.pendingThinking+=m,this.pendingOutput+=g,(this.pendingThinking||this.pendingOutput)&&!this.flushTimer&&(this.flushTimer=setTimeout(()=>this.flushDeltas(),A),this.flushTimer.unref())}e.type==="message_end"&&e.message.role==="assistant"&&(this.flushDeltas(),this.openAssistant=!1,this.block=null)}),t.on("error",()=>{}),t.on("close",()=>{this.client===t&&(this.client=void 0,this.discardDeltas(),this.openAssistant=!1,this.block=null)}),t.connect()}flushDeltas(){this.flushTimer&&clearTimeout(this.flushTimer),this.flushTimer=void 0;const t=this.pendingThinking,e=this.pendingOutput;if(this.pendingThinking="",this.pendingOutput="",!this.openAssistant||!t&&!e)return;if(r(h(),"SELECT 1 FROM run_events WHERE run_id = ? AND node_id = ? AND sequence_number >= ? AND type IN ('node.output_text.done', 'node.thinking.done', 'usage') LIMIT 1").get(this.runId,this.nodeId,this.assistantStartSequence)){this.openAssistant=!1;return}t&&c(this.runId,this.nodeId,"node.thinking.delta",{delta:t}),e&&c(this.runId,this.nodeId,"node.output_text.delta",{delta:e})}discardDeltas(){this.flushTimer&&clearTimeout(this.flushTimer),this.flushTimer=void 0,this.pendingThinking="",this.pendingOutput=""}close(){this.closed=!0,this.discardDeltas(),clearInterval(this.timer),l.delete(this.nodeId);const t=this.client;this.client=void 0,t?.close()}}function F(i){return l.get(i)?.assistantMessageStartSequence??null}u(F,"openAssistantMessageStartSequence");function B(i){return l.get(i)?.openBlock??null}u(B,"openAssistantBlock");function f(i,t){if(!l.has(i)){if(i!==t){const e=p(i);!r(h(),"SELECT 1 FROM run_events WHERE run_id = ? AND node_id = ? AND type = 'child.started' LIMIT 1").get(t,i)&&e&&Date.now()-Date.parse(e.created)<720*60*6e4&&c(t,i,"child.started",{child_node_id:i,kind:e.kind})}new v(i,t)}}u(f,"ensureRunObserver");function U(){const i=new Date(Date.now()-2592e6).toISOString(),t=r(h(),`SELECT n.node_id, n.run_id FROM node_rows n WHERE n.run_id IS NOT NULL AND (n.pi_pid IS NOT NULL OR (n.outcome_at IS NOT NULL AND n.outcome_at > ?
+    AND n.outcome_reason != 'parked' AND NOT EXISTS (
+    SELECT 1 FROM run_events e WHERE e.run_id = n.run_id AND e.node_id = n.node_id AND e.type = CASE WHEN n.node_id = n.run_id THEN 'node.settled' ELSE 'child.settled' END
+      AND json_extract(e.body_json, '$.outcome.revision') = COALESCE(n.outcome_revision, 1))))`).all(i);for(const e of t)f(e.node_id,e.run_id)}u(U,"pollRunObservers");export{f as ensureRunObserver,B as openAssistantBlock,F as openAssistantMessageStartSequence,U as pollRunObservers};

package/dist/daemon/startup-policy.d.ts

@@ -0,0 +1 @@
+export declare const DAEMON_STARTUP_WINDOW_MS: number;

package/dist/daemon/startup-policy.js

@@ -0,0 +1 @@
+const _=3e5;export{_ as DAEMON_STARTUP_WINDOW_MS};

package/dist/daemon/structured-requests/boot.d.ts

@@ -0,0 +1,2 @@
+/** Rebuild pending sidecars, settle pending requests on terminal nodes, and adopt pre-request-id sidecars. */
+export declare function reconcileStructuredRequestSidecars(): void;

package/dist/daemon/structured-requests/boot.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,t)=>o(e,"name",{value:t,configurable:!0});import{listNodes as u}from"../../core/canvas/index.js";import{getPendingStructuredRequestForNode as s,registerLegacyStructuredRequest as c,settlePendingStructuredRequestForNode as a}from"../../core/canvas/structured-requests.js";import{readLegacyOutputRequest as l,readOutputRequest as f,writeStructuredRequestSidecar as i}from"../../core/runtime/structured-output.js";import{emitEvent as m}from"../../core/events/emit.js";function _(e){return e.status!=="done"&&e.status!=="dead"&&e.status!=="canceled"?null:e.terminal_reason==="deadline_exceeded"?{intended:"expired",failureReason:"node_deadline_exceeded"}:{intended:"failed",failureReason:e.terminal_reason??"finished"}}n(_,"terminalSettlement");function x(){for(const e of u())try{const t=_(e);t!==null&&a(e.node_id,t);const d=s(e.node_id);if(d!==null){i(d);continue}if(f(e.node_id).state==="valid"||t!==null)continue;const r=l(e.node_id);r!==null&&i(c(e.node_id,r.mode,r.schema))}catch(t){m({level:"error",event:"structured_request.boot_reconcile_failed",node_id:e.node_id,error:t})}}n(x,"reconcileStructuredRequestSidecars");export{x as reconcileStructuredRequestSidecars};

package/dist/daemon/structured-requests/effects.d.ts

@@ -0,0 +1,4 @@
+import { type StructuredRequestRow } from '../../core/canvas/structured-requests.js';
+import { type StagedStructuredProjection } from '../../core/runtime/structured-output.js';
+/** Replays only durable request-owned effects. A successful final never enters teardown. */
+export declare function applySettlementEffects(row: StructuredRequestRow, staged?: StagedStructuredProjection): Promise<void>;

package/dist/daemon/structured-requests/effects.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,d)=>o(e,"name",{value:d,configurable:!0});import{markStructuredRequestEffectsDone as l,ownsStructuredRequestDeclineProjection as _,ownsStructuredRequestResultProjection as f,registerStructuredRequestEffectRunner as m}from"../../core/canvas/structured-requests.js";import{getNode as s}from"../../core/canvas/index.js";import{emitEvent as p}from"../../core/events/emit.js";import{requestBrokerTeardown as q}from"../../core/runtime/host.js";import{transition as S}from"../../core/runtime/lifecycle.js";import{expireNodeDeadline as y}from"../reconcilers/node-deadline.js";import{installStagedStructuredProjection as c,readOutputRequest as g,removeOutputSchema as h,stageStructuredResult as x,writeOutputDeclined as D}from"../../core/runtime/structured-output.js";import{enqueueNodeMail as R}from"../../core/feed/messages.js";import{notifyStructuredRequest as v}from"./notifier.js";function b(e){if(e.node_id===null)return!1;const d=g(e.node_id);return d.state==="valid"&&d.request.request_id===e.request_id}n(b,"ownsCurrentSidecar");async function j(e,d){v(e.request_id);let a=!1,u=null;const i=n((t,r)=>{a=!0,p({level:"error",event:t,node_id:e.node_id??void 0,error:r,fields:{request_id:e.request_id}})},"report");if(e.node_id!==null&&e.state==="completed")try{const t=e.submission,r=s(e.node_id)?.grantee;f(e)&&(u=d===void 0?c(x(e.node_id,e.request_id,t,e.result,r)):c(d))}catch(t){i("structured_request.projection_failed",t)}if(e.node_id!==null&&e.state==="declined"&&_(e)&&e.declined!==null)try{u=D(e.node_id,{mode:e.submission,...e.declined,at:new Date(e.settled_at??Date.now()).toISOString()},s(e.node_id)?.grantee)}catch(t){i("structured_request.decline_projection_failed",t)}if(e.node_id!==null&&b(e))try{h(e.node_id,e.request_id)}catch(t){i("structured_request.sidecar_remove_failed",t)}if(e.node_id!==null&&!e.dedicated&&e.state==="expired")try{R(e.node_id,{kind:"urgent",label:`Structured request ${e.request_id} expired`,bodyJson:{body:`Structured request ${e.request_id} expired. Stop trying to answer it; this request can no longer accept a result.`},urgency:"urgent",wake:1,idempotencyKey:`structured-request-expiry:${e.request_id}`})}catch(t){i("structured_request.expiry_notice_failed",t)}if(e.node_id!==null&&e.dedicated&&(e.state==="expired"||e.state==="canceled"||e.state==="failed"))try{if(e.state==="expired")await y(e.node_id,new Date(e.deadline_at??Date.now()).toISOString(),Date.now());else{const t=s(e.node_id);t!==null&&(t.status==="active"||t.status==="idle")&&S(e.node_id,"cancel",{reason:"stranded"});const r=await q(e.node_id);if(!r.confirmed)throw r.error??new Error("broker teardown was not confirmed")}}catch(t){i("structured_request.teardown_failed",t)}a||l(e.request_id,u)}n(j,"applySettlementEffects"),m(e=>{j(e)});export{j as applySettlementEffects};

package/dist/daemon/structured-requests/notifier.d.ts

@@ -0,0 +1,2 @@
+export declare function subscribeStructuredRequest(requestId: string, listener: () => void): () => void;
+export declare function notifyStructuredRequest(requestId: string): void;

package/dist/daemon/structured-requests/notifier.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var s=(e,t)=>r(e,"name",{value:t,configurable:!0});const o=new Map;function u(e,t){const n=o.get(e)??new Set;return n.add(t),o.set(e,n),()=>{n.delete(t),n.size===0&&o.delete(e)}}s(u,"subscribeStructuredRequest");function i(e){for(const t of o.get(e)??[])t()}s(i,"notifyStructuredRequest");export{i as notifyStructuredRequest,u as subscribeStructuredRequest};

package/dist/daemon/structured-requests/sidecar.d.ts

@@ -0,0 +1,3 @@
+import { type StructuredOutputMode } from '../../core/runtime/structured-output.js';
+/** Admit legacy node/message schema requests before publishing their sidecar. */
+export declare function admitLegacyStructuredOutput(nodeId: string, submission: StructuredOutputMode, schema: Record<string, unknown>, requestMessageId?: string): string;

package/dist/daemon/structured-requests/sidecar.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var e=(t,r)=>i(t,"name",{value:r,configurable:!0});import{registerLegacyStructuredRequest as o}from"../../core/canvas/structured-requests.js";import{writeStructuredRequestSidecar as d}from"../../core/runtime/structured-output.js";function S(t,r,u,c){return d(o(t,r,u,c))}e(S,"admitLegacyStructuredOutput");export{S as admitLegacyStructuredOutput};

package/dist/daemon/supervise-cadence.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_INTERVAL_MS = 2000;

package/dist/daemon/supervise-cadence.js

@@ -0,0 +1 @@
+const o=2e3;export{o as DEFAULT_INTERVAL_MS};

package/dist/hook-authoring.d.ts

@@ -0,0 +1,130 @@
+export type HookJson = null | boolean | number | string | HookJson[] | {
+    [key: string]: HookJson;
+};
+export type HookPhase = 'before' | 'after' | 'replace';
+export interface HookContext {
+    cwd: string;
+    providedParams: string[];
+}
+export interface LifecycleHookNode {
+    id: string;
+    name: string;
+    kind: string;
+    mode: string;
+    lifecycle: string;
+    cwd: string;
+    nodeDir: string;
+    contextDir: string;
+    jobDir: string;
+}
+export interface LifecycleHookRuntime {
+    isBirth: boolean;
+    canvasHome: string;
+    profile: string | null;
+}
+/** `node:create` runs before every node birth, immediately before a cold row is written or a warm spare is claimed. Return `ok:false` to refuse the birth. There is no node payload because no node exists yet. */
+export interface NodeCreateHookRequest {
+    protocolVersion: 1;
+    op: string;
+    event: 'node:create';
+    phase: 'before';
+    operationId: string;
+    create: {
+        kind: string;
+        mode: string;
+        cwd: string;
+        profile: string | null;
+        root: boolean;
+        parentId: string | null;
+        requestingNodeId: string | null;
+        lifecycle: 'resident' | 'terminal';
+        replaces: string | null;
+    };
+    runtime: {
+        canvasHome: string;
+        profile: string | null;
+    };
+    context: {
+        cwd: string;
+    };
+}
+interface HookRequestBase {
+    protocolVersion: 1;
+    op: string;
+    command: string[];
+    operationId: string;
+    input: {
+        [key: string]: HookJson;
+    };
+    context: HookContext;
+}
+export interface BeforeHookRequest extends HookRequestBase {
+    phase: 'before';
+}
+export interface AfterHookRequest extends HookRequestBase {
+    phase: 'after';
+    result: HookJson;
+}
+export interface ReplaceHookRequest extends HookRequestBase {
+    phase: 'replace';
+}
+/** `node:start` handlers run for birth and every revive, so they must be idempotent. `node:close` runs after close. */
+export interface LifecycleHookRequest {
+    protocolVersion: 1;
+    op: string;
+    event: 'node:start' | 'node:close';
+    phase: 'on';
+    operationId: string;
+    node: LifecycleHookNode;
+    runtime: LifecycleHookRuntime;
+    context: {
+        cwd: string;
+    };
+}
+export type HookRequest = BeforeHookRequest | AfterHookRequest | ReplaceHookRequest | NodeCreateHookRequest | LifecycleHookRequest;
+export interface HookSuccess {
+    protocolVersion: 1;
+    ok: true;
+    result?: HookJson;
+}
+export interface HookError {
+    code: string;
+    message: string;
+    field?: string;
+    next?: string;
+}
+export interface HookFailure {
+    protocolVersion: 1;
+    ok: false;
+    error: HookError;
+}
+export type HookResponse = HookSuccess | HookFailure;
+export type HookHandler = (request: HookRequest) => HookResponse | Promise<HookResponse>;
+export type HookHandlers = Record<string, HookHandler>;
+export interface RunHookExecutableOptions {
+    stdin?: NodeJS.ReadableStream;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+}
+export interface LocalHookProcessOptions {
+    timeoutMs: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    input?: string | Uint8Array;
+}
+export interface LocalHookProcessSuccess {
+    ok: true;
+    stdout: string;
+}
+export type LocalHookProcessResult = LocalHookProcessSuccess | HookFailure;
+export interface ForwardHookOptions {
+    headers?: HeadersInit;
+    bearer?: string;
+    timeoutMs: number;
+    maxResponseBytes: number;
+}
+export declare function hookError(code: string, message: string, details?: Omit<HookError, 'code' | 'message'>): HookFailure;
+export declare function runHookExecutable(handlers: HookHandlers, options?: RunHookExecutableOptions): Promise<void>;
+export declare function runLocalHookProcess(argv: readonly string[], options: LocalHookProcessOptions): Promise<LocalHookProcessResult>;
+export declare function forwardHook(endpoint: string | URL, request: HookRequest, options: ForwardHookOptions): Promise<HookResponse>;
+export {};

package/dist/hook-authoring.js

@@ -0,0 +1,5 @@
+var B=Object.defineProperty;var o=(e,r)=>B(e,"name",{value:r,configurable:!0});import{spawn as R}from"node:child_process";import{Console as T}from"node:console";import{posixProcessGroupSpawnOptions as M,terminateProcessGroup as j}from"./hook-process.js";function d(e,r,t={}){return{protocolVersion:1,ok:!1,error:{code:e,message:r,...t}}}o(d,"hookError");async function X(e,r={}){const t=r.stdin??process.stdin,s=r.stdout??process.stdout,i=r.stderr??process.stderr;let c;try{const m=await C(t);let p;try{p=JSON.parse(m)}catch{c=d("invalid_hook_request","stdin must contain one JSON hook request"),_(s,c);return}const f=A(p);if(!f.valid){c=d("invalid_hook_request",f.message),_(s,c);return}const g=e[f.value.op];if(g===void 0){c=d("unsupported_hook_op",`no handler is registered for ${f.value.op}`),_(s,c);return}try{c=await H(i,()=>g(f.value))}catch(h){i.write(`hook handler ${f.value.op} failed: ${b(h)}
+`),c=d("hook_handler_failed",`handler failed for ${f.value.op}`)}const a=I(c,f.value);a.valid||(i.write(`hook handler ${f.value.op} returned an invalid response: ${a.message}
+`),c=d("invalid_hook_response",a.message))}catch(m){i.write(`hook executable failed: ${b(m)}
+`),c=d("hook_executable_failed","hook executable could not read its request")}_(s,c)}o(X,"runHookExecutable");async function Y(e,r){const t=e[0];return t===void 0||t===""?d("local_process_invalid","local process argv[0] must not be empty"):!Number.isFinite(r.timeoutMs)||r.timeoutMs<=0?d("local_process_invalid_options","timeoutMs must be greater than zero"):new Promise(s=>{let i=!1,c=!1,m=!1,p=!1,f;const g=[],a=o(u=>{i||(i=!0,f!==void 0&&clearTimeout(f),s(u))},"settle");let h;try{h=R(t,e.slice(1),{cwd:r.cwd,env:r.env,shell:!1,stdio:[r.input===void 0?"ignore":"pipe","pipe","inherit"],...M()})}catch(u){a(d("local_process_spawn_failed",`could not start ${t}: ${b(u)}`));return}const x=o(()=>{c&&m&&p&&a(d("local_process_timeout",`${t} did not finish within ${r.timeoutMs}ms`))},"settleTimeout");f=setTimeout(()=>{c=!0,j(h).then(()=>{p=!0,x()},u=>{p=!0,a(d("local_process_cleanup_failed",`could not stop ${t}: ${b(u)}`))})},r.timeoutMs),h.stdout.on("data",u=>g.push(u)),h.once("error",u=>{h.pid===void 0&&a(d("local_process_spawn_failed",`could not start ${t}: ${b(u)}`))}),h.once("close",(u,$)=>{if(m=!0,c){x();return}if(u===0){a({ok:!0,stdout:Buffer.concat(g).toString("utf8")});return}const V=$===null?`exit code ${u??"unknown"}`:`signal ${$}`;a(d("local_process_failed",`${t} exited with ${V}`))}),r.input!==void 0&&h.stdin!==null&&h.stdin.end(r.input)})}o(Y,"runLocalHookProcess");async function Z(e,r,t){if(!Number.isFinite(t.timeoutMs)||t.timeoutMs<=0)return d("hook_forward_invalid_options","timeoutMs must be greater than zero");if(!Number.isSafeInteger(t.maxResponseBytes)||t.maxResponseBytes<=0)return d("hook_forward_invalid_options","maxResponseBytes must be a positive integer");const s=new Headers(t.headers);s.has("content-type")||s.set("content-type","application/json"),t.bearer!==void 0&&s.set("authorization",`Bearer ${t.bearer}`);const i=new AbortController;let c=!1;const m=setTimeout(()=>{c=!0,i.abort()},t.timeoutMs);try{const p=await fetch(e,{method:"POST",headers:s,body:JSON.stringify(r),signal:i.signal}),f=await J(p,t.maxResponseBytes);let g;try{g=JSON.parse(f)}catch{return d("hook_forward_invalid_response",`hook endpoint returned invalid JSON (HTTP ${p.status})`)}const a=I(g,r);return a.valid?a.value:d("hook_forward_invalid_response",`${a.message} (HTTP ${p.status})`)}catch(p){return c?d("hook_forward_timeout",`hook endpoint did not respond within ${t.timeoutMs}ms`):p instanceof N?d("hook_forward_response_too_large",`hook endpoint exceeded ${t.maxResponseBytes} response bytes`):d("hook_forward_failed",`hook endpoint request failed: ${b(p)}`)}finally{clearTimeout(m)}}o(Z,"forwardHook");const O=["log","info","debug","dir","table","group","groupCollapsed"];async function H(e,r){const t=new T({stdout:e,stderr:e,colorMode:!1}),s=new Map;for(const i of O)s.set(i,console[i]),console[i]=t[i].bind(t);try{return await r()}finally{for(const i of O)console[i]=s.get(i)}}o(H,"withConsoleStdoutOnStderr");function _(e,r){e.write(`${JSON.stringify(r)}
+`)}o(_,"writeResponse");async function C(e){const r=[];for await(const t of e)r.push(Buffer.isBuffer(t)?t:Buffer.from(t));return Buffer.concat(r).toString("utf8")}o(C,"readStream");async function J(e,r){if(e.body===null)return"";const t=e.body.getReader(),s=[];let i=0;try{for(;;){const{done:c,value:m}=await t.read();if(c)break;if(i+=m.byteLength,i>r)throw await t.cancel(),new N;s.push(m)}}finally{t.releaseLock()}return new TextDecoder().decode(P(s,i))}o(J,"readResponseBody");function P(e,r){const t=new Uint8Array(r);let s=0;for(const i of e)t.set(i,s),s+=i.byteLength;return t}o(P,"concatBytes");function A(e){return y(e)?e.protocolVersion!==1?n("unsupported hook protocol version"):typeof e.op!="string"||e.op===""?n("op must be a non-empty string"):typeof e.operationId!="string"||!/^[0-9a-f]{32}$/.test(e.operationId)?n("operationId must be a 32-character lowercase hexadecimal string"):e.event==="node:create"?l(e,["protocolVersion","op","event","phase","operationId","create","runtime","context"])?e.phase!=="before"?n("node:create phase must be before"):E(e.create)?L(e.runtime)?q(e.context)?w({protocolVersion:1,op:e.op,event:"node:create",phase:"before",operationId:e.operationId,create:e.create,runtime:e.runtime,context:e.context}):n("node:create request context must contain cwd"):n("node:create request runtime contains invalid fields"):n("node:create request create contains invalid fields"):n("node:create request contains unknown fields"):e.phase==="on"?l(e,["protocolVersion","op","event","phase","operationId","node","runtime","context"])?e.event!=="node:start"&&e.event!=="node:close"?n("unsupported lifecycle event"):z(e.node)?F(e.runtime)?q(e.context)?w({protocolVersion:1,op:e.op,event:e.event,phase:"on",operationId:e.operationId,node:e.node,runtime:e.runtime,context:e.context}):n("lifecycle request context must contain cwd"):n("lifecycle request runtime contains invalid fields"):n("lifecycle request node contains invalid fields"):n("lifecycle request contains unknown fields"):l(e,["protocolVersion","op","phase","command","operationId","input","context","result"])?!S(e.command)||e.command.length===0?n("command must be a non-empty string array"):!y(e.input)||!k(e.input)?n("input must be a JSON object"):D(e.context)?e.phase==="after"?!Object.hasOwn(e,"result")||!k(e.result)?n("after requests require a JSON result"):w({protocolVersion:1,op:e.op,phase:"after",command:e.command,operationId:e.operationId,input:e.input,context:e.context,result:e.result}):e.phase!=="before"&&e.phase!=="replace"?n("phase must be before, after, or replace"):Object.hasOwn(e,"result")?n("only after requests may contain result"):e.phase==="before"?w({protocolVersion:1,op:e.op,phase:"before",command:e.command,operationId:e.operationId,input:e.input,context:e.context}):w({protocolVersion:1,op:e.op,phase:"replace",command:e.command,operationId:e.operationId,input:e.input,context:e.context}):n("context must contain cwd and providedParams"):n("request contains unknown fields"):n("request must be an object")}o(A,"validateRequest");function I(e,r){if(!y(e))return n("response must be an object");if(e.protocolVersion!==1)return n("response has an unsupported hook protocol version");if(e.ok===!0){if(!l(e,["protocolVersion","ok","result"]))return n("successful response contains unknown fields");const t=Object.hasOwn(e,"result");if(r.phase==="replace"&&!t)return n("replace response requires result");if(r.phase!=="replace"&&t)return n("only replace responses may contain result");if(t){const s=e.result;return k(s)?w({protocolVersion:1,ok:!0,result:s}):n("response result must be JSON")}return w({protocolVersion:1,ok:!0})}return e.ok!==!1||!l(e,["protocolVersion","ok","error"])?n("response must contain protocolVersion, ok, and error or result"):G(e.error)?w({protocolVersion:1,ok:!1,error:e.error}):n("response error must contain code and message strings")}o(I,"validateResponse");function D(e){return y(e)&&l(e,["cwd","providedParams"])&&typeof e.cwd=="string"&&S(e.providedParams)}o(D,"isContext");function q(e){return y(e)&&l(e,["cwd"])&&typeof e.cwd=="string"}o(q,"isLifecycleContext");function E(e){return y(e)&&l(e,["kind","mode","cwd","profile","root","parentId","requestingNodeId","lifecycle","replaces"])&&typeof e.kind=="string"&&typeof e.mode=="string"&&typeof e.cwd=="string"&&(typeof e.profile=="string"||e.profile===null)&&typeof e.root=="boolean"&&(typeof e.parentId=="string"||e.parentId===null)&&(typeof e.requestingNodeId=="string"||e.requestingNodeId===null)&&(e.lifecycle==="resident"||e.lifecycle==="terminal")&&(typeof e.replaces=="string"||e.replaces===null)}o(E,"isNodeCreate");function L(e){return y(e)&&l(e,["canvasHome","profile"])&&typeof e.canvasHome=="string"&&(typeof e.profile=="string"||e.profile===null)}o(L,"isCreateRuntime");function z(e){return y(e)&&l(e,["id","name","kind","mode","lifecycle","cwd","nodeDir","contextDir","jobDir"])&&["id","name","kind","mode","lifecycle","cwd","nodeDir","contextDir","jobDir"].every(r=>typeof e[r]=="string")}o(z,"isLifecycleNode");function F(e){return y(e)&&l(e,["isBirth","canvasHome","profile"])&&typeof e.isBirth=="boolean"&&typeof e.canvasHome=="string"&&(typeof e.profile=="string"||e.profile===null)}o(F,"isLifecycleRuntime");function G(e){return y(e)&&l(e,["code","message","field","next"])&&typeof e.code=="string"&&e.code!==""&&typeof e.message=="string"&&e.message!==""&&(e.field===void 0||typeof e.field=="string")&&(e.next===void 0||typeof e.next=="string")}o(G,"isHookError");function y(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}o(y,"isRecord");function S(e){return Array.isArray(e)&&e.every(r=>typeof r=="string")}o(S,"isStringArray");function k(e){return e===null||typeof e=="boolean"||typeof e=="string"?!0:typeof e=="number"?Number.isFinite(e):Array.isArray(e)?e.every(k):y(e)&&Object.values(e).every(k)}o(k,"isJson");function l(e,r){return Object.keys(e).every(t=>r.includes(t))}o(l,"hasOnlyKeys");function w(e){return{valid:!0,value:e}}o(w,"valid");function n(e){return{valid:!1,message:e}}o(n,"invalid");function b(e){return e instanceof Error?e.message:String(e)}o(b,"describeError");class N extends Error{static{o(this,"ResponseTooLargeError")}}export{Z as forwardHook,d as hookError,X as runHookExecutable,Y as runLocalHookProcess};

package/dist/hook-process.d.ts

@@ -0,0 +1,7 @@
+import type { ChildProcess } from 'node:child_process';
+export declare const PROCESS_GROUP_KILL_GRACE_MS = 250;
+export declare function posixProcessGroupSpawnOptions(): {
+    detached: true;
+};
+/** Signal the isolated group, then unconditionally reap survivors after grace. */
+export declare function terminateProcessGroup(child: ChildProcess, graceMs?: number): Promise<void>;

package/dist/hook-process.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var t=(o,e)=>s(o,"name",{value:e,configurable:!0});const p=250;function f(){if(process.platform==="win32")throw new Error("hook process execution requires POSIX process groups");return{detached:!0}}t(f,"posixProcessGroupSpawnOptions");async function S(o,e=250){const n=o.pid;n!==void 0&&(r(n,"SIGTERM"),await c(e),r(n,"SIGKILL"))}t(S,"terminateProcessGroup");function r(o,e){try{process.kill(-o,e)}catch(n){if(!i(n))throw n}}t(r,"signalProcessGroup");function i(o){return typeof o=="object"&&o!==null&&"code"in o&&o.code==="ESRCH"}t(i,"isMissingProcess");function c(o){return new Promise(e=>setTimeout(e,o))}t(c,"delay");export{p as PROCESS_GROUP_KILL_GRACE_MS,f as posixProcessGroupSpawnOptions,S as terminateProcessGroup};

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export { reviveNode } from './core/runtime/revive.js';
+export type { ReviveResult } from './core/runtime/revive.js';
+export { closeNode } from './core/runtime/close.js';
+export type { CloseNodeResult } from './core/runtime/close.js';
+export { enqueueNodeMail } from './core/feed/messages.js';
+export type { NodeMailInput } from './core/feed/messages.js';
+export type { InboxEntry, InboxTier, InboxKind } from './core/feed/inbox.js';
+export { appendSituationalContext } from './core/runtime/situational-context.js';
+export { isTurnInternal } from './core/runtime/turn-visibility.js';
+export { getNode, listNodes } from './core/canvas/canvas.js';
+export { nodeDir } from './core/canvas/paths.js';
+export type { NodeMeta, NodeRow, NodeStatus, Lifecycle, Mode, } from './core/canvas/types.js';
+export { ticketCountsForNodes, ticketsAcrossCanvas } from './core/canvas/attention.js';
+export type { TicketEntry } from './core/canvas/attention.js';
+export { readTelemetry, readContextTokens } from './core/canvas/telemetry.js';
+export type { Telemetry } from './core/canvas/telemetry.js';
+export { BrokerClient, BrokerUnavailableError } from './core/broker-client/index.js';
+export { encodeFrame, FrameDecoder, FrameOverflowError, CLIENT_READ_CAPS, BROKER_READ_CAPS, } from './core/runtime/broker-protocol.js';
+export type { FrameDecoderCaps, BrokerSnapshot, ClientRole, WelcomeFrame, AckFrame, ErrorFrame, ExtensionUIRequestFrame, BrokerToClient, HelloFrame, PromptFrame, SteerFrame, FollowUpFrame, AbortFrame, ByeFrame, ShutdownFrame, SetModelFrame, CycleModelFrame, SetThinkingLevelFrame, SetAutoRetryFrame, SetAutoCompactionFrame, CompactFrame, NewSessionFrame, SwitchSessionFrame, ForkFrame, SetSessionNameFrame, GetCommandsFrame, NavigateTreeFrame, ReloadFrame, ExportFrame, ClientToBroker, RpcExtensionUIRequest, RpcExtensionUIResponse, ExtensionUIResponseFrame, } from './core/runtime/broker-protocol.js';
+export type { SessionStats } from '@earendil-works/pi-coding-agent';
+export { general } from './core/errors.js';
+export type { CrtrError } from './core/errors.js';
+export { nowIso } from './core/fs-utils.js';
+export { validateOperationId, buildEnvelope, operationIdContext, errorClassCodes, serializeEventRecord, errorClassFromError, } from './core/events/index.js';
+export type { BuildEnvelopeInput, ErrorClass, ErrorClassCode, ErrorClassHints, EventComponent, EventEnvelope, EventError, EventField, EventLevel, EventOutcome, OperationId, OperationIdContext, RetryDisposition, } from './core/events/index.js';
+export { forwardHook, hookError, runHookExecutable, runLocalHookProcess } from './hook-authoring.js';
+export type { AfterHookRequest, BeforeHookRequest, ForwardHookOptions, HookContext, HookError, HookFailure, HookHandler, HookHandlers, HookJson, HookPhase, HookRequest, HookResponse, HookSuccess, LocalHookProcessOptions, LocalHookProcessResult, LocalHookProcessSuccess, LifecycleHookNode, LifecycleHookRequest, LifecycleHookRuntime, NodeCreateHookRequest, ReplaceHookRequest, RunHookExecutableOptions, } from './hook-authoring.js';
+export { validateCommandManifest } from './api/command-manifest/manifest.js';
+export type { CommandManifestValidation, ValidatedCommandManifest } from './api/command-manifest/manifest.js';
+export type { CommandManifestIssue, TransportKind } from './api/command-manifest/schema.js';
+export { validatePluginBundle } from './core/command-plugins/bundle.js';
+export type { BundleIssue, PluginBundleValidation, ValidatedBundle } from './core/command-plugins/bundle.js';
+export { SUBTREE_NAMES } from './build-root.js';

package/dist/index.js

@@ -0,0 +1 @@
+import{reviveNode as e}from"./core/runtime/revive.js";import{closeNode as a}from"./core/runtime/close.js";import{enqueueNodeMail as m}from"./core/feed/messages.js";import{appendSituationalContext as l}from"./core/runtime/situational-context.js";import{isTurnInternal as x}from"./core/runtime/turn-visibility.js";import{getNode as i,listNodes as s}from"./core/canvas/canvas.js";import{nodeDir as C}from"./core/canvas/paths.js";import{ticketCountsForNodes as c,ticketsAcrossCanvas as v}from"./core/canvas/attention.js";import{readTelemetry as N,readContextTokens as A}from"./core/canvas/telemetry.js";import{BrokerClient as B,BrokerUnavailableError as F}from"./core/broker-client/index.js";import{encodeFrame as S,FrameDecoder as T,FrameOverflowError as _,CLIENT_READ_CAPS as D,BROKER_READ_CAPS as P}from"./core/runtime/broker-protocol.js";import{general as g}from"./core/errors.js";import{nowIso as H}from"./core/fs-utils.js";import{validateOperationId as O,buildEnvelope as L,operationIdContext as U,errorClassCodes as h,serializeEventRecord as q,errorClassFromError as y}from"./core/events/index.js";import{forwardHook as K,hookError as j,runHookExecutable as G,runLocalHookProcess as J}from"./hook-authoring.js";import{validateCommandManifest as V}from"./api/command-manifest/manifest.js";import{validatePluginBundle as X}from"./core/command-plugins/bundle.js";import{SUBTREE_NAMES as Z}from"./build-root.js";export{P as BROKER_READ_CAPS,B as BrokerClient,F as BrokerUnavailableError,D as CLIENT_READ_CAPS,T as FrameDecoder,_ as FrameOverflowError,Z as SUBTREE_NAMES,l as appendSituationalContext,L as buildEnvelope,a as closeNode,S as encodeFrame,m as enqueueNodeMail,h as errorClassCodes,y as errorClassFromError,K as forwardHook,g as general,i as getNode,j as hookError,x as isTurnInternal,s as listNodes,C as nodeDir,H as nowIso,U as operationIdContext,A as readContextTokens,N as readTelemetry,e as reviveNode,G as runHookExecutable,J as runLocalHookProcess,q as serializeEventRecord,c as ticketCountsForNodes,v as ticketsAcrossCanvas,V as validateCommandManifest,O as validateOperationId,X as validatePluginBundle};

package/dist/launcher/bwrap.d.ts

@@ -0,0 +1,13 @@
+import { type ChildProcess } from 'node:child_process';
+import { type LaunchSpec } from './spec.js';
+import type { SourceValidator } from './validate.js';
+import type { RunPlan } from './limits/manager.js';
+import { type TmpfsSizes } from './limits/policy.js';
+/** bwrap 0.12: `--size BYTES` applies to the `--tmpfs` that follows it. */
+export declare function bwrapBaseArgs(network: LaunchSpec['network'], sizes?: TmpfsSizes): string[];
+/** The program and arguments that start bwrap. A shell first moves itself into the run's cgroup and raises its oom_score_adj, then execs bwrap, so bwrap and everything it starts are members from their first instruction and cannot outrun the group. */
+export declare function bwrapCommand(args: string[], cgroupDir: string | null): {
+    command: string;
+    args: string[];
+};
+export declare function launchSandbox(spec: LaunchSpec, tokenFd: number | undefined, validator: SourceValidator, dataGid: number, onSpawn?: (child: ChildProcess) => void, plan?: Pick<RunPlan, 'cgroupDir' | 'tmpfs'>): Promise<ChildProcess>;

package/dist/launcher/bwrap.js

@@ -0,0 +1,2 @@
+var O=Object.defineProperty;var u=(e,r)=>O(e,"name",{value:r,configurable:!0});import{spawn as I}from"node:child_process";import{closeSync as h}from"node:fs";import{join as l}from"node:path";import{loadLinuxNative as T}from"../native/linux.js";import{seccompFd as E}from"./seccomp.js";import{LaunchRefused as i}from"./spec.js";import{SANDBOX_OOM_SCORE_ADJ as k,SANDBOX_ROOT_TMPFS_BYTES as D,SANDBOX_TMP_TMPFS_BYTES as N}from"./limits/policy.js";const P=T();function R(e,r){const s=l(r.runtime,"nodes",e.nodeId,"job","broker.log");if(e.log!==s)throw new i("log_refused","log must be this node\u2019s broker.log");try{return r.openLog(e.nodeId)}catch(f){throw new i("log_refused",String(f))}}u(R,"openLog");function F(e,r={root:D,tmp:N}){if(e!==void 0&&e!=="none")throw new i("invalid_spec","unsupported network mode");return["--unshare-pid","--unshare-ipc","--unshare-uts",...e==="none"?["--unshare-net"]:[],"--die-with-parent","--new-session","--clearenv","--size",String(r.root),"--tmpfs","/","--proc","/proc","--dev","/dev","--perms","1777","--size",String(r.tmp),"--tmpfs","/tmp"]}u(F,"bwrapBaseArgs");function M(e,r){return{command:"/bin/sh",args:["-c",`{ ${r===null?"":'echo $$ > "$0/cgroup.procs"; '}echo ${k} > /proc/self/oom_score_adj; } 2>/dev/null; exec /usr/bin/bwrap "$@"`,r??"-",...e]}}u(M,"bwrapCommand");async function K(e,r,s,f,x,b){if(!P)throw new Error("Linux native addon is required");const y=l(s.runtime,"nodes",e.nodeId,"job","broker.log");if(e.log!==y)throw new i("log_refused","log must be this node\u2019s broker.log");const B=F(e.network,b?.tmpfs),w=s.pin(e);let a,m;try{if(e.capture===void 0)a=R(e,s);else if(!Number.isInteger(e.capture.stdoutBytes)||e.capture.stdoutBytes<0||e.capture.stdoutBytes>10*1024*1024||!Number.isInteger(e.capture.stderrBytes)||e.capture.stderrBytes<0||e.capture.stderrBytes>10*1024*1024||e.capture.stdin!==void 0&&Buffer.byteLength(e.capture.stdin)>10*1024*1024)throw new i("invalid_spec","invalid capture limits");m=E();const c=[],S=u(n=>(c.push(n),c.length+4),"addFd"),p=B,g=new Set;for(const n of w){let t=l(n.source,"..");const d=[];for(;t!=="/"&&!g.has(t);)d.push(t),t=l(t,"..");for(const v of d.reverse())p.push("--perms","0755","--dir",v),g.add(v);const L=S(n.fd);p.push(n.writable?"--bind-fd":"--ro-bind-fd",String(L),n.source),n.kind===16384&&g.add(n.source)}const A=S(m);p.push("--seccomp",String(A));const $=Object.entries(e.env).map(([n,t])=>`${n}=${t}`);p.push("--setenv","PATH","/usr/bin:/bin","--chdir",e.cwd,"--","/bin/setpriv","--reuid",String(e.uid),"--regid",String(f),"--groups",String(f),"--no-new-privs","--bounding-set=-all","--inh-caps=-all","--ambient-caps=-all","--","/usr/bin/env","-i",...$,"/bin/sh","-c",'printf "READY\\n" >&4; exec 4>&-; exec "$@"',"sh",...e.command);const _=M(p,b?.cgroupDir??null),o=I(_.command,_.args,{stdio:[e.capture?.stdin===void 0?"ignore":"pipe",e.capture?"pipe":a,e.capture?"pipe":a,r??"ignore","pipe",...c],env:{PATH:"/usr/bin:/bin"},cwd:"/",detached:!1});x?.(o),e.capture?.stdin!==void 0&&(o.stdin?.on("error",()=>{}),o.stdin?.end(e.capture.stdin));try{await new Promise((n,t)=>{o.once("error",t),o.once("exit",d=>t(new i("launch_failed",`bwrap exited before sandbox command: ${d}`))),o.stdio[4]?.once("data",d=>d.toString()===`READY
+`?n():t(new i("launch_failed","invalid sandbox readiness")))})}catch(n){throw o.kill("SIGKILL"),n}return o.stdio[4]?.destroy(),o}finally{a!==void 0&&h(a),m!==void 0&&h(m);for(const c of w)h(c.fd)}}u(K,"launchSandbox");export{F as bwrapBaseArgs,M as bwrapCommand,K as launchSandbox};

package/dist/launcher/client.d.ts

@@ -0,0 +1,4 @@
+import { type LauncherReply, type LauncherRequest, type LimitEvent } from './spec.js';
+/** The daemon registers where launcher diagnostics (limit applications, OOM kills, skipped limits) become canonical events. */
+export declare function setLauncherEventSink(sink: ((events: LimitEvent[]) => void) | undefined): void;
+export declare function launcherRequest(request: LauncherRequest, fds?: number[], path?: string): Promise<LauncherReply>;

package/dist/launcher/client.js

@@ -0,0 +1,3 @@
+var w=Object.defineProperty;var s=(o,a)=>w(o,"name",{value:a,configurable:!0});import{connect as p}from"node:net";import{loadLinuxNative as v}from"../native/linux.js";import{LAUNCHER_SOCKET as m,LaunchRefused as y}from"./spec.js";const u=v();let d;function k(o){d=o}s(k,"setLauncherEventSink");async function N(o,a=[],f=m){if(!u)throw new Error("Linux launcher client requires the native addon");const e=p(f);try{await new Promise((r,t)=>{e.once("connect",r),e.once("error",t)});const c=e._handle?.fd;if(c===void 0||c<0)throw new Error("launcher socket fd unavailable");u.sendFds(c,JSON.stringify(o),a);const l=await new Promise((r,t)=>{let i="";e.on("data",h=>{i+=h.toString(),i.includes(`
+`)&&r(i.slice(0,i.indexOf(`
+`)))}),e.once("end",()=>t(new Error("launcher disconnected without reply"))),e.once("error",t)}),n=JSON.parse(l);if("refusal"in n)throw new y(n.refusal,`launcher refused ${n.refusal}`);if("events"in n&&n.events!==void 0){const{events:r,...t}=n;if(r.length>0)try{d?.(r)}catch{}return t}return n}finally{e.destroy()}}s(N,"launcherRequest");export{N as launcherRequest,k as setLauncherEventSink};

package/dist/launcher/limits/cgroup.d.ts

@@ -0,0 +1,28 @@
+import { type AppBudget } from './policy.js';
+export declare const CGROUP_ROOT = "/sys/fs/cgroup";
+export declare class Cgroups {
+    private readonly root;
+    private readonly procMeminfo;
+    /** Why per-app memory limits are off on this host, or null when they work. */
+    unavailable: string | null;
+    constructor(root?: string, procMeminfo?: string);
+    /** Guest memory: the enclosing cgroup's own limit when it has one, else MemTotal. */
+    guestMemoryBytes(): number;
+    /** Create `apps/` with its cap and controllers. Returns false (and sets `unavailable`) when the host cannot. */
+    init(): boolean;
+    /** Create or update an app group with its budget; `memory.high` and `memory.swap.max` are written before `memory.max`. */
+    applyApp(app: string, budget: AppBudget): void;
+    /** Create a run group that kills as one when the kernel's OOM killer picks any member. */
+    createRun(app: string, run: string): string;
+    oomKilled(dir: string): boolean;
+    kill(dir: string): void;
+    /** Remove an empty run group; a group still dying is retried by the caller. */
+    remove(dir: string): boolean;
+    exists(dir: string): boolean;
+    /** Whether `pid` is a member of the group (checked after launch: the join happens in a shell prefix). */
+    contains(dir: string, pid: number): boolean;
+    /** Remove run groups left empty by a previous launcher; groups with members stay. */
+    sweep(): number;
+}
+/** Raising oom_score_adj is always allowed; lowering needs CAP_SYS_RESOURCE. */
+export declare function setOomScoreAdj(pid: number, value: number): void;

package/dist/launcher/limits/cgroup.js

@@ -0,0 +1,2 @@
+var p=Object.defineProperty;var c=(s,r)=>p(s,"name",{value:r,configurable:!0});import{existsSync as l,mkdirSync as m,readdirSync as a,readFileSync as i,rmdirSync as y,writeFileSync as u}from"node:fs";import{appCgroupPath as h,appCgroupValues as f,appsMemoryMax as d,parseMemoryEvents as $,runCgroupPath as g,wasOomKilled as x}from"./policy.js";const b="/sys/fs/cgroup";function o(s,r){u(s,r)}c(o,"write");class S{static{c(this,"Cgroups")}root;procMeminfo;unavailable=null;constructor(r=b,t="/proc/meminfo"){this.root=r,this.procMeminfo=t}guestMemoryBytes(){try{const t=i(`${this.root}/memory.max`,"utf8").trim();if(/^\d+$/.test(t))return Number(t)}catch{}const r=/^MemTotal:\s+(\d+)\s+kB/m.exec(i(this.procMeminfo,"utf8"));if(!r)throw new Error("cannot read guest memory");return Number(r[1])*1024}init(){try{if(!i(`${this.root}/cgroup.controllers`,"utf8").split(/\s+/).includes("memory"))throw new Error("memory controller is not available");const t=`${this.root}/apps`;return m(t,{recursive:!0}),i(`${this.root}/cgroup.subtree_control`,"utf8").split(/\s+/).includes("memory")||o(`${this.root}/cgroup.subtree_control`,"+memory +pids"),o(`${t}/cgroup.subtree_control`,"+memory +pids"),o(`${t}/memory.max`,String(d(this.guestMemoryBytes()))),this.unavailable=null,!0}catch(r){return this.unavailable=r.message,!1}}applyApp(r,t){if(this.unavailable!==null)return;const e=h(this.root,r);m(e,{recursive:!0}),o(`${e}/cgroup.subtree_control`,"+memory +pids");const n=f(t);o(`${e}/memory.high`,n.memoryHigh);try{o(`${e}/memory.swap.max`,n.swapMax)}catch{}o(`${e}/memory.max`,n.memoryMax),o(`${e}/pids.max`,n.pidsMax)}createRun(r,t){const e=g(this.root,r,t);return m(e),o(`${e}/memory.oom.group`,"1"),e}oomKilled(r){try{return x($(i(`${r}/memory.events`,"utf8")))}catch{return!1}}kill(r){try{o(`${r}/cgroup.kill`,"1")}catch{}}remove(r){try{return y(r),!0}catch(t){return t.code==="ENOENT"}}exists(r){return l(r)}contains(r,t){try{return i(`${r}/cgroup.procs`,"utf8").split(`
+`).includes(String(t))}catch{return!1}}sweep(){let r=0;try{for(const t of a(`${this.root}/apps`,{withFileTypes:!0}))if(t.isDirectory())for(const e of a(`${this.root}/apps/${t.name}`,{withFileTypes:!0}))e.isDirectory()&&this.remove(`${this.root}/apps/${t.name}/${e.name}`)&&(r+=1)}catch{}return r}}function _(s,r){u(`/proc/${s}/oom_score_adj`,String(r))}c(_,"setOomScoreAdj");export{b as CGROUP_ROOT,S as Cgroups,_ as setOomScoreAdj};

package/dist/launcher/limits/log.d.ts

@@ -0,0 +1,3 @@
+import type { LimitEvent } from '../spec.js';
+/** The launcher has no canonical event log; its journal line is the record until the daemon emits the event. */
+export declare function writeLimitsLog(event: LimitEvent): void;

package/dist/launcher/limits/log.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var n=(o,e)=>i(o,"name",{value:e,configurable:!0});function r(o){const e=JSON.stringify({source:"launcher",...o});o.level==="warn"?console.warn(e):console.log(e)}n(r,"writeLimitsLog");export{r as writeLimitsLog};