@north-light/crouter 0.3.353 → 0.3.354

package/dist/core/substrate/delivery/sub-persona-menu.js

@@ -0,0 +1,6 @@
+var a=Object.defineProperty;var o=(e,n)=>a(e,"name",{value:n,configurable:!0});import{subKindsAvailableTo as r}from"../../config.js";import{packageFiles as u}from"../../graph/package-files.js";import{builtinMemoryRoot as p}from"../../scope.js";let s;function c(e){s??=u(p()).files.map(t=>t.name);const n=`kinds/${e}`;return s.some(t=>t===n||t.startsWith(`${n}/`))?` (\`crtr canvas read ${n}\`)`:""}o(c,"subKindDocCitation");function f(e){const n=r(e);if(n.length===0)return"";const t=n.map(i=>`- \`${i.kind}\` \u2014 ${i.whenToUse}${c(i.kind)}`);return`## Sub-personas you may spawn
+
+These specialist sub-personas are available to the ${e} kind. Spawn one with \`crtr node new --kind <sub> "<scope>"\`, and treat it as its own scope instead of dragging unrelated context into it.
+
+`+t.join(`
+`)}o(f,"buildSubPersonaMenu");export{f as buildSubPersonaMenu};

package/dist/core/substrate/delivery/types.d.ts

@@ -0,0 +1,30 @@
+/** Row-backed delivery engine: one document as the planner and renderers see it. */
+import type { RuleRow } from '../../graph/rules.js';
+import type { ObjectRow } from '../../graph/types.js';
+import type { Rung } from '../schema.js';
+export interface DeliveryDoc {
+    object: ObjectRow;
+    owner: ObjectRow;
+    /** How `<handle>/<name>` names the owner: a node's id, else the owner's name. */
+    ownerHandle: string;
+    /** The owner's index in the reader's view (0 = own node); lower wins a bare name. */
+    viewRank: number;
+    /** The document belongs to the reading node itself. */
+    ownNode: boolean;
+    /** A package document (`documents.source_path` set): an installed plugin's or crtr's own. */
+    shipped: boolean;
+    kind: 'knowledge' | 'preference';
+    name: string;
+    /** The bare name when `[[name]]` resolves to this object for the reader, else `<ownerHandle>/<name>`. */
+    displayName: string;
+    preview: string;
+    unlisted: boolean;
+    headsKey: string;
+    /** Body hash of the highest head revision. */
+    bodyHash: string;
+    /** Lazy: preview and name deliveries never read the body. */
+    body(): string;
+    rules: RuleRow[];
+    /** The profile's cap for this owner on `boot` / `workspace-open`. */
+    limit: Rung;
+}

package/dist/core/substrate/gate-explain.d.ts

@@ -1,5 +1,4 @@
 import type { NodeConfigSubject } from './subject-fields.js';
-import type { DeliveryRecord } from './plan.js';
 /** The subject has no value at this field path — distinct from a value of
  *  `null`, which a gate can legitimately demand. */
 export declare const ABSENT: unique symbol;
@@ -34,15 +33,3 @@ export declare function formatClause(clause: GateClause): string;
  *  the directory it names, else the longest literal run it insists on, else an
  *  admission that it is a pattern. The source is never printed. */
 export declare function readableRegex(source: string): string;
-/** Which of a record's two gates is being explained. */
-export type GateSide = 'doc' | 'entry';
-/** The failing clauses of one record's document or entry gate, or an empty list
- *  when there is nothing to explain — the gate passed, there is no subject to
- *  match against, or the predicate resists decomposition. An evaluator that
- *  throws is the planner's own `failed to evaluate` outcome and keeps its
- *  sentence. */
-export declare function explainRecordGate(record: DeliveryRecord, side: GateSide, subject: NodeConfigSubject | null): GateClause[];
-/** Does every failing clause name a node value the reader can change? Only then
- *  is "dial the snapshot" a true instruction — a malformed gate is fixed in the
- *  document. */
-export declare function allMismatches(clauses: readonly GateClause[]): boolean;

package/dist/core/substrate/gate-explain.js

@@ -1 +1 @@
-var O=Object.defineProperty;var o=(n,t)=>O(n,"name",{value:t,configurable:!0});import{getField as y,matchField as W,evalCondition as m}from"../predicate.js";import{tildify as w}from"../fs-utils.js";const h=Symbol("absent");function N(n,t){return g(n,t)??[]}o(N,"explainGate");function g(n,t){if(n==null||typeof n!="object")return[];if(Array.isArray(n))return A(n,t);const e=n,r=[];if(("any"in e||"not"in e)&&("any"in e&&!m({any:e.any},t)||"not"in e&&!m({not:e.not},t)))return null;if("all"in e){const s=A(Array.isArray(e.all)?e.all:[e.all],t);if(s===null)return null;r.push(...s)}const i=Object.keys(e).filter(s=>s!=="all"&&s!=="any"&&s!=="not");if(i.length===0&&!("all"in e)&&!("any"in e)&&!("not"in e))return[{field:"",failure:"malformed",actual:h,demand:e,defect:"is empty, and an empty gate never matches"}];for(const s of i){const l=e[s];W(y(t,s),l)||r.push(E(s,l,t))}return r}o(g,"walk");function A(n,t){const e=[];for(const r of n){const i=g(r,t);if(i===null)return null;e.push(...i)}return e}o(A,"collect");function E(n,t,e){const r=y(e,n),i=r===void 0?h:r,s=j(t);return s===null?{field:n,failure:"mismatch",actual:i,demand:t}:{field:n,failure:"malformed",actual:i,demand:t,defect:s}}o(E,"clauseFor");const R=new Set(["eq","ne","in","nin","exists","contains","containsAll","containsAny","matches","imatches","gt","gte","lt","lte"]);function j(n){if(n===null||Array.isArray(n)||typeof n!="object")return null;for(const[t,e]of Object.entries(n)){if(!R.has(t))return`uses unknown operator "${t}" \u2014 unknown operators never match`;if(t==="matches"||t==="imatches"){if(typeof e!="string")return"is matched against something that is not a pattern \u2014 it never matches";try{new RegExp(e,t==="imatches"?"i":"")}catch{return"has an invalid regular expression \u2014 an invalid pattern never matches"}}if(["gt","gte","lt","lte"].includes(t)&&Number.isNaN(Number(e)))return`compares ${t} against something that is not a number \u2014 it never matches`}return null}o(j,"matcherDefect");function $(n){return n==="hasManager"?"manager":n==="orchestration.depth"?"depth":n}o($,"labelFor");const L=" | gate: ";function D(n){return n.failure==="malformed"?`${n.field===""?"the gate":$(n.field)} ${n.defect??"never matches"}`:`${$(n.field)}: ${x(n.actual)}${L}${a(n.demand)}`}o(D,"formatClause");function x(n){return n===h||n===null||n===void 0?"none":typeof n=="boolean"?n?"yes":"no":Array.isArray(n)?n.map(t=>x(t)).join(", "):typeof n=="string"?n===""?"none":d(n):typeof n=="object"?JSON.stringify(n):String(n)}o(x,"renderActual");function a(n){if(n==null)return"none";if(typeof n=="boolean")return n?"yes":"no";if(typeof n=="string")return n===""?"none":d(n);if(typeof n=="number")return String(n);if(Array.isArray(n))return p(n);const t=Object.entries(n);return t.length===0?"nothing":t.map(([e,r])=>C(e,r)).join(" and ")}o(a,"renderDemand");function C(n,t){switch(n){case"eq":return a(t);case"ne":return`not ${a(t)}`;case"in":return p(t);case"nin":return`not ${p(t)}`;case"exists":return t===!1?"no value":"any value";case"contains":return`includes ${a(t)}`;case"containsAll":return`includes all of ${S(t)}`;case"containsAny":return`includes any of ${S(t)}`;case"matches":case"imatches":return typeof t=="string"?F(t):"a pattern";case"gt":return`> ${String(t)}`;case"gte":return`\u2265 ${String(t)}`;case"lt":return`< ${String(t)}`;case"lte":return`\u2264 ${String(t)}`;default:return`${n} ${String(t)}`}}o(C,"renderOp");function p(n){const t=(Array.isArray(n)?n:[n]).map(e=>a(e));return t.length===0?"nothing":t.join(" or ")}o(p,"orList");function S(n){return(Array.isArray(n)?n:[n]).map(t=>a(t)).join(", ")}o(S,"commaList");function d(n){return n.startsWith("/")?w(n):n}o(d,"shortPath");const c=new Set(["\\","^","$",".","|","?","*","+","(",")","[","]","{","}"]);function F(n){let t=n;t.startsWith("^")&&(t=t.slice(1)),t=t.replace(/\((?:\?:)?\\?\/\|\$\)\??$/,""),t.endsWith("$")&&!t.endsWith("\\$")&&(t=t.slice(0,-1));const e=b(t);if(e!==null&&e!=="")return d(e);const r=G(t);if(r!==null)return r.map(s=>d(s)).join(" or ");const i=M(n);return i===null?"a pattern":`contains "${d(i)}"`}o(F,"readableRegex");function b(n){let t="";for(let e=0;e<n.length;e++){const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(b,"unescapeLiteral");function G(n){const t=n.indexOf("(");if(t===-1||!n.endsWith(")"))return null;const e=b(n.slice(0,t));if(e===null)return null;let r=n.slice(t+1,-1);if(r.startsWith("?:")&&(r=r.slice(2)),r.includes("(")||r.includes(")"))return null;const i=r.split("|");if(i.length<2)return null;const s=[];for(const l of i){const u=T(l);if(u===null)return null;s.push(e+u)}return s}o(G,"distributeAlternation");function T(n){let t="";for(let e=0;e<n.length;e++){if(n.startsWith("[^/]+",e)){t+="*",e+=4;continue}if(n.startsWith("[^\\/]+",e)){t+="*",e+=5;continue}if(n.startsWith(".*",e)){t+="*",e+=1;continue}const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(T,"branchText");function M(n){let t="",e="",r=0,i=!1;const s=o(()=>{e.length>t.length&&(t=e),e=""},"flush");for(let l=0;l<n.length;l++){const u=n[l];if(u==="\\"){const f=n[l+1];if(l++,r===0&&!i&&f!==void 0&&(c.has(f)||f==="/"||f==="-")){e+=f;continue}s();continue}if(i){u==="]"&&(i=!1);continue}if(u==="["){s(),i=!0;continue}if(u==="("){s(),r++;continue}if(u===")"){s(),r>0&&r--;continue}if(u==="|"&&r===0)return null;if(u==="{"){e.length>0&&(e=e.slice(0,-1)),s();const f=n.indexOf("}",l);f!==-1&&(l=f);continue}if(c.has(u)||r>0){(u==="?"||u==="*")&&e.length>0&&(e=e.slice(0,-1)),s();continue}e+=u}return s(),t.length>1?t:null}o(M,"longestLiteralRun");function _(n,t,e){const r=t==="doc"?n.docGate:n.entryGate;if(r===null||r.pass||e===null)return[];const i=t==="doc"?n.doc.gate:n.authoredEntries.find(s=>!s.gate.pass)?.entry.gate;if(i===void 0)return[];try{return N(i,e)}catch{return[]}}o(_,"explainRecordGate");function B(n){return n.length>0&&n.every(t=>t.failure==="mismatch")}o(B,"allMismatches");export{h as ABSENT,L as CLAUSE_SEPARATOR,B as allMismatches,N as explainGate,_ as explainRecordGate,D as formatClause,F as readableRegex};
+var O=Object.defineProperty;var o=(n,t)=>O(n,"name",{value:t,configurable:!0});import{getField as y,matchField as W,evalCondition as m}from"../predicate.js";import{tildify as w}from"../fs-utils.js";const d=Symbol("absent");function M(n,t){return g(n,t)??[]}o(M,"explainGate");function g(n,t){if(n==null||typeof n!="object")return[];if(Array.isArray(n))return A(n,t);const e=n,r=[];if(("any"in e||"not"in e)&&("any"in e&&!m({any:e.any},t)||"not"in e&&!m({not:e.not},t)))return null;if("all"in e){const s=A(Array.isArray(e.all)?e.all:[e.all],t);if(s===null)return null;r.push(...s)}const i=Object.keys(e).filter(s=>s!=="all"&&s!=="any"&&s!=="not");if(i.length===0&&!("all"in e)&&!("any"in e)&&!("not"in e))return[{field:"",failure:"malformed",actual:d,demand:e,defect:"is empty, and an empty gate never matches"}];for(const s of i){const u=e[s];W(y(t,s),u)||r.push(N(s,u,t))}return r}o(g,"walk");function A(n,t){const e=[];for(const r of n){const i=g(r,t);if(i===null)return null;e.push(...i)}return e}o(A,"collect");function N(n,t,e){const r=y(e,n),i=r===void 0?d:r,s=E(t);return s===null?{field:n,failure:"mismatch",actual:i,demand:t}:{field:n,failure:"malformed",actual:i,demand:t,defect:s}}o(N,"clauseFor");const j=new Set(["eq","ne","in","nin","exists","contains","containsAll","containsAny","matches","imatches","gt","gte","lt","lte"]);function E(n){if(n===null||Array.isArray(n)||typeof n!="object")return null;for(const[t,e]of Object.entries(n)){if(!j.has(t))return`uses unknown operator "${t}" \u2014 unknown operators never match`;if(t==="matches"||t==="imatches"){if(typeof e!="string")return"is matched against something that is not a pattern \u2014 it never matches";try{new RegExp(e,t==="imatches"?"i":"")}catch{return"has an invalid regular expression \u2014 an invalid pattern never matches"}}if(["gt","gte","lt","lte"].includes(t)&&Number.isNaN(Number(e)))return`compares ${t} against something that is not a number \u2014 it never matches`}return null}o(E,"matcherDefect");function $(n){return n==="hasManager"?"manager":n==="orchestration.depth"?"depth":n}o($,"labelFor");const L=" | gate: ";function _(n){return n.failure==="malformed"?`${n.field===""?"the gate":$(n.field)} ${n.defect??"never matches"}`:`${$(n.field)}: ${x(n.actual)}${L}${a(n.demand)}`}o(_,"formatClause");function x(n){return n===d||n===null||n===void 0?"none":typeof n=="boolean"?n?"yes":"no":Array.isArray(n)?n.map(t=>x(t)).join(", "):typeof n=="string"?n===""?"none":h(n):typeof n=="object"?JSON.stringify(n):String(n)}o(x,"renderActual");function a(n){if(n==null)return"none";if(typeof n=="boolean")return n?"yes":"no";if(typeof n=="string")return n===""?"none":h(n);if(typeof n=="number")return String(n);if(Array.isArray(n))return p(n);const t=Object.entries(n);return t.length===0?"nothing":t.map(([e,r])=>R(e,r)).join(" and ")}o(a,"renderDemand");function R(n,t){switch(n){case"eq":return a(t);case"ne":return`not ${a(t)}`;case"in":return p(t);case"nin":return`not ${p(t)}`;case"exists":return t===!1?"no value":"any value";case"contains":return`includes ${a(t)}`;case"containsAll":return`includes all of ${S(t)}`;case"containsAny":return`includes any of ${S(t)}`;case"matches":case"imatches":return typeof t=="string"?C(t):"a pattern";case"gt":return`> ${String(t)}`;case"gte":return`\u2265 ${String(t)}`;case"lt":return`< ${String(t)}`;case"lte":return`\u2264 ${String(t)}`;default:return`${n} ${String(t)}`}}o(R,"renderOp");function p(n){const t=(Array.isArray(n)?n:[n]).map(e=>a(e));return t.length===0?"nothing":t.join(" or ")}o(p,"orList");function S(n){return(Array.isArray(n)?n:[n]).map(t=>a(t)).join(", ")}o(S,"commaList");function h(n){return n.startsWith("/")?w(n):n}o(h,"shortPath");const c=new Set(["\\","^","$",".","|","?","*","+","(",")","[","]","{","}"]);function C(n){let t=n;t.startsWith("^")&&(t=t.slice(1)),t=t.replace(/\((?:\?:)?\\?\/\|\$\)\??$/,""),t.endsWith("$")&&!t.endsWith("\\$")&&(t=t.slice(0,-1));const e=b(t);if(e!==null&&e!=="")return h(e);const r=F(t);if(r!==null)return r.map(s=>h(s)).join(" or ");const i=P(n);return i===null?"a pattern":`contains "${h(i)}"`}o(C,"readableRegex");function b(n){let t="";for(let e=0;e<n.length;e++){const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(b,"unescapeLiteral");function F(n){const t=n.indexOf("(");if(t===-1||!n.endsWith(")"))return null;const e=b(n.slice(0,t));if(e===null)return null;let r=n.slice(t+1,-1);if(r.startsWith("?:")&&(r=r.slice(2)),r.includes("(")||r.includes(")"))return null;const i=r.split("|");if(i.length<2)return null;const s=[];for(const u of i){const l=T(u);if(l===null)return null;s.push(e+l)}return s}o(F,"distributeAlternation");function T(n){let t="";for(let e=0;e<n.length;e++){if(n.startsWith("[^/]+",e)){t+="*",e+=4;continue}if(n.startsWith("[^\\/]+",e)){t+="*",e+=5;continue}if(n.startsWith(".*",e)){t+="*",e+=1;continue}const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(T,"branchText");function P(n){let t="",e="",r=0,i=!1;const s=o(()=>{e.length>t.length&&(t=e),e=""},"flush");for(let u=0;u<n.length;u++){const l=n[u];if(l==="\\"){const f=n[u+1];if(u++,r===0&&!i&&f!==void 0&&(c.has(f)||f==="/"||f==="-")){e+=f;continue}s();continue}if(i){l==="]"&&(i=!1);continue}if(l==="["){s(),i=!0;continue}if(l==="("){s(),r++;continue}if(l===")"){s(),r>0&&r--;continue}if(l==="|"&&r===0)return null;if(l==="{"){e.length>0&&(e=e.slice(0,-1)),s();const f=n.indexOf("}",u);f!==-1&&(u=f);continue}if(c.has(l)||r>0){(l==="?"||l==="*")&&e.length>0&&(e=e.slice(0,-1)),s();continue}e+=l}return s(),t.length>1?t:null}o(P,"longestLiteralRun");export{d as ABSENT,L as CLAUSE_SEPARATOR,M as explainGate,_ as formatClause,C as readableRegex};

package/dist/core/substrate/schema.d.ts

@@ -1,11 +1,6 @@
 import { type ProfileProjectMemory } from '../../api/dto/profiles.js';
-import type { MemoryDoc, MemoryScope } from '../memory-resolver.js';
 export declare const KINDS: readonly ["knowledge", "preference"];
 export type DocKind = (typeof KINDS)[number];
-export declare const PRIVACY_LEVELS: readonly ["public", "friends", "private"];
-export type PrivacyLevel = (typeof PRIVACY_LEVELS)[number];
-/** Missing or malformed privacy is treated conservatively on reads; lint rejects malformed values. */
-export declare function effectivePrivacy(fm: Record<string, unknown> | null): PrivacyLevel;
 /** Is `v` one of the two valid document kinds? */
 export declare function isDocKind(v: unknown): v is DocKind;
 export declare const RUNGS: readonly ["none", "name", "preview", "content"];
@@ -17,141 +12,18 @@ export declare function rungAtLeast(r: Rung, min: Rung): boolean;
 /** The lower of two rungs — the clamp automatic delivery applies to an
  *  authored rung against its project relationship's cap. */
 export declare function minRung(a: Rung, b: Rung): Rung;
-export { normalizeNameSegment, normalizeDocName, resolveLocalName as resolveDocName } from '../memory/identity.js';
-export declare const SURFACE_EVENTS: readonly ["boot", "workspace-open", "read", "memory-read", "command", "pre-command"];
-export type SurfaceEvent = (typeof SURFACE_EVENTS)[number];
-/** The rungs an entry may deliver at. There is no `none` — silence is the
- *  absence of an entry. (`Rung`'s `none` survives only as the internal
- *  ranking floor — the planner's verdict for a doc that delivers nothing.) */
-export declare const SURFACE_RUNGS: readonly ["name", "preview", "content"];
-export type SurfaceRung = (typeof SURFACE_RUNGS)[number];
-/** One routing entry: when event `on` exposes a subject that fits `match`
- *  (and `matchFrontmatter`, `read` only) and its optional node-config `gate`,
- *  the doc delivers at rung `at`. Constraints within one entry AND together
- *  (each present constraint must fit; a `match` list is satisfied by any one
- *  glob); multiple entries per event OR together. */
-export interface SurfaceEntry {
-    on: SurfaceEvent;
-    /** Globs vs the event's subject namespace. Required on read/memory-read/
-     *  command/pre-command (a read entry may carry `matchFrontmatter` instead);
-     *  meaningless on boot/workspace-open (presence of the entry is the match). */
-    match?: string[];
-    /** Predicate over the read file's own YAML frontmatter — `read` event only.
-     *  Frontmatter key `match-frontmatter`. */
-    matchFrontmatter?: GatePredicate;
-    /** Optional predicate over the current node config. Frontmatter key `gate`.
-     *  The document-level gate remains the hard eligibility check. */
-    gate?: GatePredicate;
-    at: SurfaceRung;
-}
 /** A gate predicate tree, evaluated by predicate.ts (`evalCondition`) against
  *  the node-config subject. Typed loosely on purpose — the matcher engine owns
  *  validation; structurally it is a field→matcher map with optional
- *  `all`/`any`/`not` combinators (design §4). */
+ *  `all`/`any`/`not` combinators. */
 export type GatePredicate = Record<string, unknown>;
-/** The frontmatter-derived schema of a substrate document, with kind-aware
- *  defaults applied. Required fields (`kind`/`when-and-why-to-read`) and
- *  optionals all resolved to concrete typed values. */
-export interface SubstrateSchema {
-    /** Which of the two semantic kinds (knowledge | preference). */
-    kind: DocKind;
-    /** App access level; legacy documents without the field resolve to private. */
-    privacy: PrivacyLevel;
-    /** The read-routing line — a single sentence answering WHEN to read this doc
-     *  and WHY it is worth the read: "When <circumstance>, this <kind> should be
-     *  read because <broader downstream payoff>." (design §4). This is
-     *  read-routing: WHY is the reader's payoff for the task in front of them,
-     *  NEVER a document summary, its rule, or that rule reworded as an outcome (a
-     *  benefit-shaped restatement still fails). It IS the preview verbatim.
-     *  Frontmatter key `when-and-why-to-read`. */
-    whenAndWhyToRead: string;
-    /** Human-facing abbreviation for `crtr memory list`. NEVER loaded into an
-     *  agent's context (design §3). Empty string when absent. */
-    shortForm: string;
-    /** Suppress this doc from directory listings (default false). Suppression,
-     *  not a type — the doc is otherwise ordinary. */
-    unlisted: boolean;
-    /** Explicit event routing. Empty = no explicit routing (listings still
-     *  apply, unless `unlisted`). Invalid entries are dropped by the tolerant
-     *  runtime parser; lint enforces strictly. */
-    surfaces: SurfaceEntry[];
-    /** Optional eligibility predicate over the node's own config. Absent ⇒ always
-     *  eligible. An empty `{}` is carried as-is and is inert (never matches) — see
-     *  `gatePasses`. */
-    gate?: GatePredicate;
-    /** Opt-in: this doc is invocable as a pi slash command (`/<name>`, `/` in a
-     *  nested name rendered as `:`). Default `false` — most docs are consulted,
-     *  not invoked. Frontmatter key `slash`. */
-    slash: boolean;
-    /** The gap this doc exists to close — the observed agent failure that
-     *  prompted it (CTO ruling 2026-07-03, `insights/agent-memory/document-substrate` §"Rationale
-     *  is a frontmatter field, never delivered"). MAINTAINER-FACING ONLY: excluded
-     *  from every delivered surface by construction — it is frontmatter, never
-     *  body, so it never reaches a boot render, on-read injection, or `memory
-     *  read` content output; only the raw file at `path` (or `memory read
-     *  --frontmatter`) shows it. It is NOT read-routing (`whenAndWhyToRead` owns
-     *  that) and NOT a content summary (`shortForm` owns that) — it answers
-     *  "what observed failure made this doc exist," never "why obey it." Absent
-     *  when the doc carries none. Frontmatter key `rationale`. */
-    rationale?: string;
-}
-/** A fully-resolved substrate document: the parsed schema PLUS the resolver's
- *  identity (explicit frontmatter `name` when present, otherwise the normalized
- *  path-derived fallback) and body. This single object flows through the whole
- *  pipeline (gate eval → boot/on-read render), so a renderer never re-parses. */
-export interface SubstrateDoc extends SubstrateSchema {
-    /** Resolver-supplied identity, e.g. `insights/agent-memory/document-substrate` or an explicit
-     *  frontmatter name when one is present. */
-    name: string;
-    /** The scope this doc resolved from. */
-    scope: MemoryScope;
-    /** Owning plugin name when the doc is mounted from an installed plugin;
-     *  undefined for a native scope doc. Shipped (builtin/plugin) docs and
-     *  agent-editable scope docs render differently at boot (see renderGrouped). */
-    plugin?: string;
-    /** Absolute path to the source .md. */
-    path: string;
-    /** Document body, frontmatter stripped. */
-    body: string;
-    /** The selected profile relationship's cap on the project store this doc
-     *  resolved from — the maximum rung automatic boot and workspace-open
-     *  delivery may disclose it at. `content` is the neutral ceiling every
-     *  non-project doc and every uncapped project root carries. Targeted reads,
-     *  command routing, and directory listings ignore it. */
-    projectMemory: ProfileProjectMemory;
-}
-/** Parse a raw frontmatter record (from `parseFrontmatterGeneric`, via the
- *  resolver) into a typed schema with defaults applied. Returns `null` when the
- *  record is absent or carries no valid `kind` — i.e. it is not a substrate
- *  document and cannot be classified. Tolerant of every other imperfection (a
- *  missing `when-and-why-to-read` defaults to '', a missing/bad rung falls back
- *  to the neutral floor `none`), so a renderer mapping over many docs never
- *  throws. Authoring-time enforcement of these fields lives in `crtr memory
- *  write` (on create) and `crtr memory lint`. */
-export declare function parseSubstrateFrontmatter(fm: Record<string, unknown> | null): SubstrateSchema | null;
-/** Parse a resolved MemoryDoc into a fully-typed SubstrateDoc (schema + the
- *  resolver's name/scope/path/body). Returns `null` for a non-substrate doc
- *  (no valid `kind`), so callers can `docs.map(parseSubstrateDoc).filter(...)`. */
-export declare function parseSubstrateDoc(doc: MemoryDoc): SubstrateDoc | null;
-/** The kind a doc resolves to for `--kind` filtering/matching: the substrate
- *  kind when the frontmatter parses as a valid substrate doc, else the raw
- *  frontmatter `kind` string when present (even if not one of the two valid
- *  kinds — an authoring error, not grounds to silently reclassify it), else
- *  the legacy default `knowledge` for a frontmatter-less/kindless doc. The
- *  single coercion `memory read`'s resolution and result display share, so a
- *  `--kind` filter and the displayed `kind` field never disagree. */
-export declare function effectiveDocKind(doc: MemoryDoc): string;
-/** The `preview`-rung routing line (design §4): the `when-and-why-to-read`
- *  field rendered essentially verbatim — it is already authored as the complete
- *  routing sentence ("When …, this <kind> should be read …"), so there is no
- *  template to compose. Both boot and on-read render this identical line, so it
- *  lives once here to prevent drift. Light cleanup normalizes the trailing
- *  period. */
-export declare function previewLine(doc: Pick<SubstrateSchema, 'whenAndWhyToRead'>): string;
-/** Tolerant `surfaces` parse: a non-array yields `[]`; invalid entries are
- *  dropped (bad `on`, bad `at`, a read/memory-read/command/pre-command entry
- *  left with neither `match` nor — read only — `match-frontmatter`). `match-frontmatter`
- *  on a non-read event is dropped from the entry, which survives iff it still
- *  carries a `match`; an invalid entry `gate` is dropped. Lint owns strict
- *  enforcement; the runtime parser maps over many docs and must never throw. */
-export declare function parseSurfaces(v: unknown): SurfaceEntry[];
+export type DocRepresentation = 'leaf-file' | 'directory-index';
+/** Which form a store-relative markdown path takes. */
+export declare function representationForPath(physicalRelativePath: string): DocRepresentation;
+/** Local name derived from a store-relative markdown path: ordering prefixes
+ *  stripped from every segment and one trailing `INDEX` collapsed. Empty only
+ *  for a root `INDEX.md`. */
+export declare function localNameFromPath(physicalRelativePath: string): string;
+/** A document's explicit frontmatter `name` as a local name — normalized with
+ *  one trailing `INDEX` collapsed — or `null` when it carries none. */
+export declare function explicitLocalName(fm: Record<string, unknown> | null | undefined): string | null;

package/dist/core/substrate/schema.js

@@ -1 +1 @@
-var l=Object.defineProperty;var t=(e,n)=>l(e,"name",{value:n,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as m}from"../../api/dto/profiles.js";const y=["knowledge","preference"],g=["public","friends","private"];function h(e){const n=e?.privacy;return typeof n=="string"&&g.includes(n)?n:"private"}t(h,"effectivePrivacy");function x(e){return typeof e=="string"&&y.includes(e)}t(x,"isDocKind");const A=m;function a(e){return A.indexOf(e)}t(a,"rungRank");function D(e,n){return a(e)>=a(n)}t(D,"rungAtLeast");function _(e,n){return a(e)<=a(n)?e:n}t(_,"minRung");import{normalizeNameSegment as G,normalizeDocName as O,resolveLocalName as P}from"../memory/identity.js";const R=["boot","workspace-open","read","memory-read","command","pre-command"],S=["name","preview","content"];function w(e){return e===null||!x(e.kind)?null:{kind:e.kind,privacy:h(e),whenAndWhyToRead:d(e["when-and-why-to-read"]),shortForm:d(e["short-form"]),unlisted:e.unlisted===!0,surfaces:E(e.surfaces),gate:p(e.gate),slash:e.slash===!0,rationale:k(e.rationale)}}t(w,"parseSubstrateFrontmatter");function b(e){const n=w(e.frontmatter);return n===null?null:{...n,name:e.name,scope:e.scope,plugin:e.plugin,path:e.path,body:e.body,projectMemory:e.projectMemory}}t(b,"parseSubstrateDoc");function M(e){const n=b(e);if(n!==null)return n.kind;const r=e.frontmatter?.kind;return typeof r=="string"?r:"knowledge"}t(M,"effectiveDocKind");function U(e){const n=e.whenAndWhyToRead.trim().replace(/\.+$/,"");return n===""?"":`${n}.`}t(U,"previewLine");function d(e){return typeof e=="string"?e:""}t(d,"strField");function k(e){return typeof e=="string"&&e.trim()!==""?e:void 0}t(k,"parseRationale");function p(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}t(p,"parseGate");function E(e){if(!Array.isArray(e))return[];const n=[];for(const r of e){if(r===null||typeof r!="object"||Array.isArray(r))continue;const i=r,o=i.on;if(typeof o!="string"||!R.includes(o))continue;const u=i.at;if(typeof u!="string"||!S.includes(u))continue;const s=N(i.match),c=o==="read"?p(i["match-frontmatter"]):void 0,f=p(i.gate);(o==="read"||o==="memory-read"||o==="command"||o==="pre-command")&&s===void 0&&c===void 0||n.push({on:o,at:u,...s!==void 0?{match:s}:{},...c!==void 0?{matchFrontmatter:c}:{},...f!==void 0?{gate:f}:{}})}return n}t(E,"parseSurfaces");function N(e){if(typeof e=="string"){const n=e.trim();return n===""?void 0:[n]}if(Array.isArray(e)){const n=e.filter(r=>typeof r=="string"&&r.trim()!=="").map(r=>r.trim());return n.length>0?n:void 0}}t(N,"parseMatchGlobs");export{y as KINDS,g as PRIVACY_LEVELS,A as RUNGS,R as SURFACE_EVENTS,S as SURFACE_RUNGS,M as effectiveDocKind,h as effectivePrivacy,x as isDocKind,_ as minRung,O as normalizeDocName,G as normalizeNameSegment,b as parseSubstrateDoc,w as parseSubstrateFrontmatter,E as parseSurfaces,U as previewLine,P as resolveDocName,D as rungAtLeast,a as rungRank};
+var a=Object.defineProperty;var t=(n,e)=>a(n,"name",{value:e,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as l}from"../../api/dto/profiles.js";const f=["knowledge","preference"];function d(n){return typeof n=="string"&&f.includes(n)}t(d,"isDocKind");const s=l;function r(n){return s.indexOf(n)}t(r,"rungRank");function N(n,e){return r(n)>=r(e)}t(N,"rungAtLeast");function R(n,e){return r(n)<=r(e)?n:e}t(R,"minRung");const m=/^\d{2}-/,o="INDEX";function i(n){return n.replace(m,"")}t(i,"normalizeNameSegment");function g(n){return n.split("/").map(i).join("/")}t(g,"normalizeDocName");function c(n){return n.split("/").filter(e=>e!=="")}t(c,"canonicalSegments");function u(n){const e=c(n);return e[e.length-1]===o&&e.pop(),e.join("/")}t(u,"collapseTrailingIndex");function p(n){return c(n.replace(/\\/g,"/").replace(/\.md$/i,"")).map(i)}t(p,"pathIdentitySegments");function I(n){const e=p(n);return e[e.length-1]===o?"directory-index":"leaf-file"}t(I,"representationForPath");function S(n){return u(p(n).join("/"))}t(S,"localNameFromPath");function _(n){const e=n?.name;return typeof e!="string"||e.trim()===""?null:u(g(e.trim()))}t(_,"explicitLocalName");export{f as KINDS,s as RUNGS,_ as explicitLocalName,d as isDocKind,S as localNameFromPath,R as minRung,I as representationForPath,N as rungAtLeast,r as rungRank};

package/dist/core/substrate/subject-fields.d.ts

@@ -30,6 +30,9 @@ export interface NodeConfigSubject {
     profile: string | null;
     /** Effective per-run scopes. */
     scopes: readonly string[];
+    /** DERIVED: handles of the repos enclosing `cwd`, nearest first. A rule's
+     *  `if: {repo: crouter}` holds when any element is `crouter`. */
+    repo: readonly string[];
 }
 export declare function effectiveScopes(scopes: readonly string[] | null | undefined): string[];
 /** The scope a cwd resolves into: `project` when scope.ts finds a

package/dist/core/substrate/subject.d.ts

@@ -1,3 +1,4 @@
+import type { ObjectRow } from '../graph/types.js';
 import { type NodeConfigSubject } from './subject-fields.js';
 export { effectiveScopes, scopeForCwd, profileNameFor } from './subject-fields.js';
 export type { NodeConfigSubject } from './subject-fields.js';
@@ -9,4 +10,4 @@ export declare function spineDepth(nodeId: string): number;
 /** Assemble the node-config subject for `nodeId` from its `NodeMeta` + the
  *  derived fields. Returns `null` when the node has no canvas-db row (an
  *  unknown id). Pure aside from the canvas-db + profile-manifest reads. */
-export declare function assembleNodeSubject(nodeId: string): NodeConfigSubject | null;
+export declare function assembleNodeSubject(nodeId: string, repos?: readonly ObjectRow[]): NodeConfigSubject | null;

package/dist/core/substrate/subject.js

@@ -1 +1 @@
-var l=Object.defineProperty;var t=(o,e)=>l(o,"name",{value:e,configurable:!0});import{getNode as p,getRow as i}from"../canvas/index.js";import{effectiveScopes as s,scopeForCwd as f,profileNameFor as a}from"./subject-fields.js";import{effectiveScopes as F,scopeForCwd as N,profileNameFor as S}from"./subject-fields.js";function d(o){let e=o;const n=new Set;let c=0;for(;!n.has(e);){n.add(e);const r=i(e);if(r===null||r.parent==null)break;e=r.parent,c++}return c}t(d,"spineDepth");function h(o){const e=p(o);return e===null?null:{kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,hasManager:(e.parent??null)!==null,cwd:e.cwd,scope:f(e.cwd),orchestration:{depth:d(o)},profile:a(e.profile_id),scopes:s(e.scopes)}}t(h,"assembleNodeSubject");export{h as assembleNodeSubject,F as effectiveScopes,S as profileNameFor,N as scopeForCwd,d as spineDepth};
+var c=Object.defineProperty;var n=(r,o)=>c(r,"name",{value:o,configurable:!0});import{getNode as l,getRow as i}from"../canvas/index.js";import{openDb as f}from"../canvas/db.js";import{reposForCwd as s}from"../graph/repo-sync/repos.js";import{effectiveScopes as a,scopeForCwd as m,profileNameFor as d}from"./subject-fields.js";import{effectiveScopes as x,scopeForCwd as C,profileNameFor as v}from"./subject-fields.js";function u(r){let o=r;const e=new Set;let t=0;for(;!e.has(o);){e.add(o);const p=i(o);if(p===null||p.parent==null)break;o=p.parent,t++}return t}n(u,"spineDepth");function N(r,o){const e=l(r);return e===null?null:{kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,hasManager:(e.parent??null)!==null,cwd:e.cwd,scope:m(e.cwd),orchestration:{depth:u(r)},profile:d(e.profile_id),scopes:a(e.scopes),repo:(o??s(f(),e.cwd)).map(t=>t.name)}}n(N,"assembleNodeSubject");export{N as assembleNodeSubject,x as effectiveScopes,v as profileNameFor,C as scopeForCwd,u as spineDepth};

package/dist/daemon/api/handlers/app-profiles.js

@@ -1 +1 @@
-var a=Object.defineProperty;var i=(e,o)=>a(e,"name",{value:o,configurable:!0});import{covers as f}from"@north-light/crouter-identity";import{ensureAppProfile as l,listProfiles as m}from"../../../core/profiles/manifest.js";function P(e){const o=l(e.grantee).profileId;return{profiles:m().filter(({profileId:t,manifest:r})=>{const n=r.grantee??"app:terminal";if(n===e.grantee)return!0;const p=`crtr:memory:rw:${n}:profile:${t}`;return e.resolved.some(s=>f(s,p))}).map(({profileId:t,manifest:r})=>({profile_id:t,name:r.name,grantee:r.grantee??"app:terminal",default_kind:r.default_kind??"general",default:t===o}))}}i(P,"listAppProfiles");export{P as listAppProfiles};
+var s=Object.defineProperty;var t=(r,o)=>s(r,"name",{value:o,configurable:!0});import{covers as m}from"@north-light/crouter-identity";import{ensureAppProfile as a,listProfiles as l}from"../../../core/profiles/manifest.js";import{resolveRunKind as d}from"../../../core/runtime/launch-target.js";function P(r){const o=a(r.grantee).profileId;return{profiles:l().filter(({profileId:e,manifest:p})=>{const i=p.grantee??"app:terminal";if(i===r.grantee)return!0;const n=`crtr:memory:rw:${i}:profile:${e}`;return r.resolved.some(f=>m(f,n))}).map(e=>({profile_id:e.profileId,name:e.manifest.name,grantee:e.manifest.grantee??"app:terminal",default_kind:d(e),default:e.profileId===o}))}}t(P,"listAppProfiles");export{P as listAppProfiles};

package/dist/daemon/api/handlers/bash-jobs.js

@@ -1,2 +1 @@
-var I=Object.defineProperty;var l=(t,o)=>I(t,"name",{value:o,configurable:!0});import{enqueueNodeMail as S}from"../../../core/feed/messages.js";import{join as k}from"node:path";import{createFileBeneath as f,existsBeneath as B,unlinkBeneath as E}from"../../../core/spaces/open-beneath.js";import{launchAppProcess as J,appProcessSandboxed as A}from"../../../core/spaces/process.js";import{BASH_JOB_SUPERVISOR_SCRIPT as P}from"../../../core/bash-job-supervisor.js";import{resolveAdmittedHostCommand as $}from"../../../core/runtime/spawn-env.js";import{requireCurrentExecution as w}from"./broker-recovery.js";import{isSafeNodeId as N}from"../../../core/canvas/paths.js";import{contextDir as y}from"../../../core/canvas/node-agent-paths.js";import{getNode as m}from"../../../core/canvas/canvas.js";import{isBrokerLive as q}from"../../../core/runtime/model-swap.js";import{assertNotFinalized as O}from"../../../core/runtime/reopen.js";import{reviveNode as L}from"../../../core/runtime/revive.js";import{activeBackgroundBashJobs as T,bashJobPaths as j,isBashJobProcessGroupAlive as R,readJobPgid as C,readJobPgidIdentity as D,isSafeBashJobId as _,readBashNiceness as x,stopBackgroundBashJob as z}from"../../../core/bash-jobs.js";import{ApiError as d}from"../../../api/index.js";import{notFound as M}from"../../../core/errors.js";function g(t){const o=t.params.id;if(o===void 0||!N(o))throw new d(400,"invalid_node_id",`invalid node id: ${JSON.stringify(o)}`);if(m(o)===null)throw M(`unknown node: ${o}`,{received:o});const i=t.params.jobId;if(i!==void 0){if(!_(i))throw new d(400,"invalid_job_id",`invalid background job id: ${JSON.stringify(i)}`);return{nodeId:o,jobId:i,dir:y(o)}}return{nodeId:o,dir:y(o)}}l(g,"requireTarget");async function F(t){const{nodeId:o,dir:n}=g(t);if(t.principal.class!=="broker"||t.principal.node!==o)throw new d(403,"permission_error","only this node\u2019s broker may start a job");const i=t.body;if(!i||typeof i!="object"||Array.isArray(i))throw new d(400,"invalid_request","job.start requires a JSON body");const c=i;w(o,c.expected_execution_id);const e=c.job_id,a=c.cwd,b=c.env;if(typeof e!="string"||!_(e)||typeof a!="string"||!b||typeof b!="object"||Array.isArray(b)||Object.entries(b).some(([s,p])=>!/^[A-Za-z_][A-Za-z0-9_]*$/.test(s)||typeof p!="string"))throw new d(400,"invalid_request","invalid job id, cwd or environment");if(!A())throw new d(400,"invalid_request","job.start is only used with the root launcher");const r=j(n,e);if(![r.jobRun,r.cmdSh,r.jobLog].every(s=>B(r.root,s)))throw new d(404,"job_not_found","job was not prepared by this node");const h=k(r.dir,"job.starting");try{f(r.root,h,"")}catch(s){throw s.code==="EEXIST"?new d(409,"job_already_started","job was already started"):s}let u;try{const s=b,p=$("bash",s,a),v=m(o);return u=await J({nodeId:o,app:v.grantee??"app:terminal",cwd:a,env:s,capture:!1,command:[p,"-c",P,"--",r.cmdSh,r.jobLog,r.jobExit,r.jobRun,r.jobDone,r.jobBg,e,o,p,String(x(n)),process.execPath,"daemon"]}),f(r.root,r.jobPgid,String(u.pid),384),f(r.root,r.jobPgidIdentity,`launcher:${u.pid}`,384),{status:201,body:{pid:u.pid}}}catch(s){if(u!==void 0)try{await u.stop()}catch(p){throw new AggregateError([s,p],`job ${e} launched but could not be recorded or stopped`)}try{E(r.root,h)}catch(p){if(p.code!=="ENOENT")throw p}throw s}}l(F,"handleStart");function G(t){const{nodeId:o,dir:n}=g(t),i=Date.now();return{status:200,body:T(n).map(e=>{const a=C(n,e.jobId)??null;return{job_id:e.jobId,command:e.command,purpose:e.purpose,started_at:new Date(e.startedAtMs).toISOString(),elapsed_ms:Math.max(0,i-e.startedAtMs),pgid:a,pgid_alive:a!==null&&R(a,D(n,e.jobId))}})}}l(G,"handleList");async function H(t){const{nodeId:o,jobId:n,dir:i}=g(t);if(n===void 0)throw new d(400,"invalid_request","a job id is required");const c=t.query.get("foreground")==="1";if(c){if(t.principal.class!=="broker"||t.principal.node!==o)throw new d(403,"permission_error","only this node\u2019s broker may abort its foreground job");w(o,t.body?.expected_execution_id)}const e=await z(i,n,c,o);if(e.kind==="missing")throw new d(404,"job_not_found",`no background job ${n} for ${o}`);if(e.kind==="retired")throw new d(404,"job_not_found",`background job ${n} for ${o} is no longer running`,{log_path:e.logPath});if(e.kind==="not-stoppable")throw new d(409,"job_not_stoppable",`job ${n} recorded no trusted process identity`,{log_path:e.logPath});if(c)return{status:200,body:{node_id:o,job_id:n,signaled:e.signaled}};O(o);const a=j(i,n),b=`Background bash job ${n} was stopped by the user before it finished. Log: ${a.jobLog}  Command: ${a.cmdSh}`;S(o,{senderNodeId:null,urgency:"urgent",wake:1,kind:"message",label:b.split(`
-`)[0].slice(0,120),bodyJson:{body:b}});const r=m(o);if(r!==null&&!q(r))try{await L(o,{resume:!0,capacity:"freeze"})}catch{}return{status:200,body:{node_id:o,job_id:n,signaled:e.signaled}}}l(H,"handleStop");const po=[{method:"POST",pattern:"/v1/nodes/:id/jobs/start",handler:F},{method:"GET",pattern:"/v1/nodes/:id/jobs",handler:G},{method:"DELETE",pattern:"/v1/nodes/:id/jobs/:jobId",handler:H}];export{po as bashJobRoutes};
+var k=Object.defineProperty;var h=(e,o)=>k(e,"name",{value:o,configurable:!0});import{killBashJobObject as S,recordBashJobObject as B}from"../../../core/spaces/stop.js";import{readerFor as E}from"../reader.js";import{join as J}from"node:path";import{createFileBeneath as m,existsBeneath as g,unlinkBeneath as P}from"../../../core/spaces/open-beneath.js";import{launchAppProcess as $,appProcessSandboxed as A}from"../../../core/spaces/process.js";import{BASH_JOB_SUPERVISOR_SCRIPT as q}from"../../../core/bash-job-supervisor.js";import{resolveAdmittedHostCommand as O}from"../../../core/runtime/spawn-env.js";import{requireCurrentExecution as w}from"./broker-recovery.js";import{isSafeNodeId as N}from"../../../core/canvas/paths.js";import{contextDir as _}from"../../../core/canvas/node-agent-paths.js";import{getNode as j}from"../../../core/canvas/canvas.js";import{isBrokerLive as L}from"../../../core/runtime/model-swap.js";import{assertNotFinalized as T}from"../../../core/runtime/reopen.js";import{reviveNode as D}from"../../../core/runtime/revive.js";import{activeBackgroundBashJobs as R,bashJobPaths as y,isBashJobProcessGroupAlive as z,readJobPgid as C,readJobPgidIdentity as F,isSafeBashJobId as v,readBashNiceness as M,stopBackgroundBashJob as G}from"../../../core/bash-jobs.js";import{ApiError as i}from"../../../api/index.js";import{notFound as H}from"../../../core/errors.js";function f(e){const o=e.params.id;if(o===void 0||!N(o))throw new i(400,"invalid_node_id",`invalid node id: ${JSON.stringify(o)}`);if(j(o)===null)throw H(`unknown node: ${o}`,{received:o});const d=e.params.jobId;if(d!==void 0){if(!v(d))throw new i(400,"invalid_job_id",`invalid background job id: ${JSON.stringify(d)}`);return{nodeId:o,jobId:d,dir:_(o)}}return{nodeId:o,dir:_(o)}}h(f,"requireTarget");async function Z(e){const{nodeId:o,dir:t}=f(e);if(e.principal.class!=="broker"||e.principal.node!==o)throw new i(403,"permission_error","only this node\u2019s broker may start a job");const d=e.body;if(!d||typeof d!="object"||Array.isArray(d))throw new i(400,"invalid_request","job.start requires a JSON body");const s=d;w(o,s.expected_execution_id);const r=s.job_id,a=s.cwd,u=s.env;if(typeof r!="string"||!v(r)||typeof a!="string"||!u||typeof u!="object"||Array.isArray(u)||Object.entries(u).some(([c,b])=>!/^[A-Za-z_][A-Za-z0-9_]*$/.test(c)||typeof b!="string"))throw new i(400,"invalid_request","invalid job id, cwd or environment");if(!A())throw new i(400,"invalid_request","job.start is only used with the root launcher");const n=y(t,r);if(![n.jobRun,n.cmdSh,n.jobLog].every(c=>g(n.root,c)))throw new i(404,"job_not_found","job was not prepared by this node");const p=J(n.dir,"job.starting");try{m(n.root,p,"")}catch(c){throw c.code==="EEXIST"?new i(409,"job_already_started","job was already started"):c}let l;try{const c=u,b=O("bash",c,a),I=j(o);return l=await $({nodeId:o,app:I.grantee??"app:terminal",cwd:a,env:c,capture:!1,command:[b,"-c",q,"--",n.cmdSh,n.jobLog,n.jobExit,n.jobRun,n.jobDone,b,String(M(t)),process.execPath]}),m(n.root,n.jobPgid,String(l.pid),384),m(n.root,n.jobPgidIdentity,`launcher:${l.pid}`,384),{status:201,body:{pid:l.pid}}}catch(c){if(l!==void 0)try{await l.stop()}catch(b){throw new AggregateError([c,b],`job ${r} launched but could not be recorded or stopped`)}try{P(n.root,p)}catch(b){if(b.code!=="ENOENT")throw b}throw c}}h(Z,"handleStart");function U(e){const{nodeId:o,dir:t}=f(e),d=Date.now();return{status:200,body:R(t).map(r=>{const a=C(t,r.jobId)??null;return{job_id:r.jobId,command:r.command,purpose:r.purpose,started_at:new Date(r.startedAtMs).toISOString(),elapsed_ms:Math.max(0,d-r.startedAtMs),pgid:a,pgid_alive:a!==null&&z(a,F(t,r.jobId))}})}}h(U,"handleList");async function V(e){const{nodeId:o,jobId:t,dir:d}=f(e);if(t===void 0)throw new i(400,"invalid_request","a job id is required");const s=e.query.get("foreground")==="1";if(s){if(e.principal.class!=="broker"||e.principal.node!==o)throw new i(403,"permission_error","only this node\u2019s broker may abort its foreground job");w(o,e.body?.expected_execution_id)}const r=await G(d,t,s,o);if(r.kind==="missing")throw new i(404,"job_not_found",`no background job ${t} for ${o}`);if(r.kind==="retired")throw new i(404,"job_not_found",`background job ${t} for ${o} is no longer running`,{log_path:r.logPath});if(r.kind==="not-stoppable")throw new i(409,"job_not_stoppable",`job ${t} recorded no trusted process identity`,{log_path:r.logPath});if(s)return{status:200,body:{node_id:o,job_id:t,signaled:r.signaled}};T(o),S(t,n=>{const p=E(n,e);return p.class==="person"?p.person:p.class==="app"?p.app:p.node});const a=j(o);if(a!==null&&!L(a))try{await D(o,{resume:!0,capacity:"freeze"})}catch{}return{status:200,body:{node_id:o,job_id:t,signaled:r.signaled}}}h(V,"handleStop");function X(e){const{nodeId:o,jobId:t,dir:d}=f(e);if(t===void 0)throw new i(400,"invalid_request","a job id is required");if(e.principal.class!=="broker"||e.principal.node!==o)throw new i(403,"permission_error","only this node\u2019s broker may record its job");const s=e.body,r=y(d,t);if(typeof s?.command!="string"||s.job_dir!==r.dir||s.log_path!==r.jobLog)throw new i(400,"invalid_request",`job.background requires command, job_dir ${r.dir} and log_path ${r.jobLog}`);if(!g(r.root,r.jobBg))throw new i(404,"job_not_found",`job ${t} of ${o} is not backgrounded`);const a=s.command;return{status:201,body:{id:B(o,t,{command:a,jobDir:r.dir,logPath:r.jobLog}).id}}}h(X,"handleBackground");const ho=[{method:"POST",pattern:"/v1/nodes/:id/jobs/:jobId/background",handler:X},{method:"POST",pattern:"/v1/nodes/:id/jobs/start",handler:Z},{method:"GET",pattern:"/v1/nodes/:id/jobs",handler:U},{method:"DELETE",pattern:"/v1/nodes/:id/jobs/:jobId",handler:V}];export{ho as bashJobRoutes};

package/dist/daemon/api/handlers/broker-ops.js

@@ -1 +1 @@
-var q=Object.defineProperty;var s=(t,e)=>q(t,"name",{value:e,configurable:!0});import{canonicalSessionFile as D,findNodeBySessionFile as L,getNode as y,isWarmSpare as W,listNodeIdentities as G,recordSettledTurn as J,setPresence as x,subscriptionsOf as X,updateNode as S,updateNodeTelemetry as Y}from"../../../core/canvas/canvas.js";import{recordExecutionPid as V}from"../../../core/canvas/executions.js";import{bindSession as z,readLiveSession as U,transferSession as H}from"../../../core/canvas/sessions.js";import{isSafeNodeId as K}from"../../../core/canvas/paths.js";import{appForNode as h}from"../../../core/canvas/node-agent-paths.js";import{isPidAlive as Q}from"../../../core/canvas/pid.js";import{editorLabel as T}from"../../../core/canvas/labels.js";import{assembleNodeSubject as P}from"../../../core/substrate/subject.js";import{withCanvasWrite as f}from"../../../core/canvas/db.js";import{notFound as _,usage as d}from"../../../core/errors.js";import{ApiError as Z}from"../../../api/errors.js";import{hasUnseenWakeMail as C}from"../../../core/canvas/deliveries.js";import{clearYieldMessage as ee}from"../../../core/runtime/kickoff.js";import{forkSourceNode as te}from"../../../core/runtime/nodes.js";import{transition as k}from"../../../core/runtime/lifecycle.js";import{focusOf as w,tearDownNode as O}from"../../../core/runtime/placement.js";import{hasAttachedBrokerViewers as ne}from"../viewer-presence.js";import{evaluateStop as oe}from"../../../core/runtime/stop-guard.js";import{clearFault as b,recordFault as re}from"../../../core/canvas/recovery.js";import{updateModelRecipe as ie}from"../../../core/runtime/model-swap.js";import{completeCompanionRequestedSubmit as se}from"../../review/finish.js";import{emitEvent as E}from"../../../core/events/emit.js";import{consumePendingPark as ae,recordPendingParkActivity as de}from"../../park-pending.js";import{shouldParkAfterSummary as ce}from"../../park-activity.js";import{ownerOnly as ue}from"../router.js";import{requireCurrentExecution as p}from"./broker-recovery.js";import{ensureRunObserver as le}from"../../runs/observer.js";import{buildContextBearings as pe}from"../../../core/runtime/bearings.js";import{renderPreferencesForNodeSubject as me}from"../../../core/runtime/broker-extension-render.js";import{automaticMemoryTarget as A}from"../../../core/spaces/permissions.js";import{buildRefInventory as fe}from"../../../core/memory/inline-ref-inventory.js";import{clearSessionCache as he}from"../../../core/substrate/session-cache.js";import{insertMemoryReads as be}from"../../../core/canvas/memory-reads.js";import{MAX_MEMORY_READ_EVENTS as F,MAX_MEMORY_READ_TEXT as B}from"./memory-reads.js";import{memoryEvents as ye}from"../../../core/substrate/memory-events.js";import{cloneContextExposureState as R,cloneTranscriptExposureState as _e,emptyContextExposureState as j,exposureTarget as N,freezePreferenceSnapshot as ke,hasTranscriptExposure as we,loadContextExposureState as I,restoreContextExposure as ge,saveContextExposureState as ve,snapshotContextExposure as $}from"../../../core/substrate/injected-store.js";import{renderOnReadDocsForSubject as xe,renderOnCommandDocsForSubject as Se,renderPreCommandDocsForSubject as Pe,demotePreCommandExposures as Oe}from"../../../core/substrate/on-read.js";import{renderConfigChangeDelta as Ae}from"../../../core/substrate/render.js";function l(t,e){if(typeof t!="object"||t===null||Array.isArray(t))throw d(`${e} requires a JSON body`);return t}s(l,"objectBody");function Ne(t){const e=l(t,"broker session-bound");if(typeof e.executionId!="string"||e.executionId==="")throw d("executionId must be a non-empty string");if(typeof e.piSessionId!="string"||e.piSessionId==="")throw d("piSessionId must be a non-empty string");if(e.sessionFile!==null&&typeof e.sessionFile!="string")throw d("sessionFile must be a string or null");if(!Number.isSafeInteger(e.pid)||e.pid<=0)throw d("pid must be a positive safe integer");if(e.reason!==null&&typeof e.reason!="string")throw d("reason must be a string or null");if(!Array.isArray(e.reviewBoundaryIds)||!e.reviewBoundaryIds.every(n=>typeof n=="string"))throw d("reviewBoundaryIds must be an array of strings");return e}s(Ne,"parseSessionBoundBody");function Te(t){const e=l(t,"broker settle");if(typeof e.stopReason!="string")throw d("stopReason must be a string");for(const n of["backgroundJobsRunning","pushedFinal"])if(typeof e[n]!="boolean")throw d(`${n} must be a boolean`);return e}s(Te,"parseSettleBody");function Ce(t){const e=l(t,"broker park-complete");if(e.outcome!=="completed"&&e.outcome!=="failed")throw d("outcome must be completed or failed");return e}s(Ce,"parseParkCompleteBody");function Ee(t){const e=l(t,"broker telemetry");if(typeof e.expected_execution_id!="string"||e.expected_execution_id==="")throw d("expected_execution_id must be a non-empty string");if(typeof e.tokens_in!="number"||!Number.isFinite(e.tokens_in)||e.tokens_in<0)throw d("tokens_in must be a non-negative finite number");if(e.context_tokens!==null&&(typeof e.context_tokens!="number"||!Number.isFinite(e.context_tokens)||e.context_tokens<0))throw d("context_tokens must be a non-negative finite number or null");if(e.last_activity!==null&&typeof e.last_activity!="string")throw d("last_activity must be a string or null");if(typeof e.updated_at!="string"||Number.isNaN(Date.parse(e.updated_at)))throw d("updated_at must be an ISO timestamp");return{...e,updated_at:new Date(e.updated_at).toISOString()}}s(Ee,"parseTelemetryBody");function Fe(t){const e=l(t,"broker model");if(typeof e.spec!="string"||e.spec.trim()==="")throw d("spec must be a non-empty string");const n=e.intent;if(n!==void 0){const r=n!==null&&typeof n=="object"?n:void 0;if(r===void 0||typeof r.family!="string"||r.family===""||!["ultra","strong","medium","light"].includes(r.strength))throw d("intent must be { family, strength } with strength ultra|strong|medium|light when present")}if(typeof e.userSelected!="boolean")throw d("userSelected must be a boolean");return e}s(Fe,"parseModelCommitBody");function m(t){const e=y(t);if(e===null)throw _(`unknown node: ${t}`,{received:t});return e}s(m,"requireNode");function g(t){return{node_id:t.node_id,grantee:h(t.node_id),name:t.name,...t.description===void 0?{}:{description:t.description},...t.title===void 0?{}:{title:t.title},...t.icon===void 0?{}:{icon:t.icon},kind:t.kind,mode:t.mode,lifecycle:t.lifecycle,status:t.status,cwd:t.cwd,parent:t.parent??null,fork_from:t.fork_from??null,profile_id:t.profile_id??null,...t.managed_worktree===void 0?{}:{managed_worktree:t.managed_worktree===null?null:{state:t.managed_worktree.state,...t.managed_worktree.cleanup===void 0?{}:{cleanup:t.managed_worktree.cleanup},path:t.managed_worktree.path,branch:t.managed_worktree.branch,base_ref:t.managed_worktree.base_ref,base_sha:t.managed_worktree.base_sha}},...t.review_binding===void 0?{}:{review_binding:t.review_binding??null},intent:t.intent??null,...t.persona_ack===void 0?{}:{persona_ack:t.persona_ack},created:t.created}}s(g,"extensionNode");function Be(t){const e=m(t),n=[],r=new Set([t]);let o=e.parent??null;for(;o!==null&&o!==""&&!r.has(o);){r.add(o);const c=y(o);if(c===null)break;n.unshift(g(c)),o=c.parent??null}const a=X(t).map(c=>y(c.node_id)).filter(c=>c!==null&&c.kind!=="human").sort((c,v)=>c.status===v.status?0:c.status==="active"?-1:v.status==="active"?1:0).map(g),i=typeof e.fork_source_file=="string"?te(e.fork_source_file):null,u=P(t);if(u===null)throw _(`unknown node: ${t}`,{received:t});return{node:g(e),warm_spare:W(t),ancestors:n,children:a,fork_source:i===null?null:g(i),subject:u,report_nodes:G().map(c=>({...c,grantee:h(c.node_id)}))}}s(Be,"extensionState");function M(t,e){return t?.kind===e.kind&&t?.mode===e.mode&&t?.lifecycle===e.lifecycle}s(M,"samePersona");function Re(t){const e=l(t,"broker generated-name");if(e.kind!=="initial"&&e.kind!=="recap")throw d("kind must be initial or recap");if(typeof e.description!="string"||typeof e.title!="string"||typeof e.icon!="string")throw d("description, title, and icon must be strings");if(e.kind==="initial")return e;const n=e.expected;if(typeof n!="object"||n===null||Array.isArray(n)||["name","description","title","icon","kind"].some(r=>typeof n[r]!="string"))throw d("recap expected must contain name, description, title, icon, and kind strings");return e}s(Re,"parseGeneratedNameBody");function je(t){const e=l(t,"broker persona-ack"),n=s(r=>{const o=e[r];if(typeof o!="object"||o===null||Array.isArray(o)||typeof o.kind!="string"||o.mode!=="base"&&o.mode!=="orchestrator"||o.lifecycle!=="terminal"&&o.lifecycle!=="resident")throw d(`${r} must be a persona state`);return o},"parse");return{expected_execution_id:e.expected_execution_id,from:n("from"),to:n("to")}}s(je,"parsePersonaAckBody");function Ie(t){const e=t.params.id,n=Ne(t.body),r=n.sessionFile===null?null:D(n.sessionFile);return{status:200,body:f(()=>{const a=m(e);if(V(n.executionId,e,n.pid)==="shutdown")return{action:"shutdown"};const i=a.review_binding?.review_id;if(i!==void 0&&!n.reviewBoundaryIds.includes(i))return{action:"shutdown"};if(n.reason==="new"&&a.parent==null)return{action:"relaunch_root"};if(n.reason!=="new"&&a.fork_from!=null&&a.pi_session_id==null&&r===null)return{action:"shutdown"};const u=r===null?null:L(r);if(u!==null&&u.node_id!==e){if(Q(u.pi_pid))return re(e,{link:"daemon\u2192node",op:"session-file-ownership",kind:"protocol",retry:{disposition:"fatal"},message:`refusing to bind ${r}: it is owned by live node ${u.node_id}`}),{action:"shutdown"};const c=U(u.node_id);if(c===null||H({fromNodeId:u.node_id,fromBindingId:c.bindingId,toNodeId:e,executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:r})!=="transferred")return{action:"shutdown"}}else if(z(e,{executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:r})==="shutdown")return{action:"shutdown"};return n.reason!=="new"&&(ee(e),a.intent==="refresh"&&k(e,"revive")),{action:"none"}})}}s(Ie,"handleSessionBound");function $e(t,e){const n=y(t);if(n===null){if(e.pushedFinal)return{action:"shutdown"};throw _(`unknown node: ${t}`,{received:t})}if(J(t,new Date().toISOString()),e.stopReason==="quit")return(n.status==="active"||n.status==="idle")&&n.intent===null&&(k(t,"finish"),b(t),w(t)!==null&&O(t),x(t,{pane:null,tmux_session:null,window:null})),{action:"shutdown"};if(e.stopReason!=="stop"&&e.stopReason!=="length")return b(t,{link:"daemon\u2192node"}),n.intent==="refresh"?{action:"shutdown"}:{action:"stay_dormant"};const r={pushedFinal:e.pushedFinal};if(r.pushedFinal||n.status==="done")return b(t),w(t)!==null&&O(t),x(t,{pane:null,tmux_session:null,window:null}),{action:"shutdown"};if(n.intent==="refresh")return b(t),{action:"shutdown"};const o=oe(t,r,e.backgroundJobsRunning);return b(t),o.action==="reprompt"?{action:"reprompt",prompt:o.message}:o.reason==="finished"?C(t)?{action:"stay_dormant"}:{action:"shutdown"}:o.reason!=="awaiting"&&o.reason!=="scheduled"?{action:"stay_dormant"}:w(t)!==null||ne(t)||C(t)?{action:"stay_dormant"}:(k(t,"release"),{action:"shutdown"})}s($e,"settleBroker");function Me(t){const e=t.params.id,n=Te(t.body);p(e,n.expected_execution_id);const r=f(()=>$e(e,n));return r.action!=="reprompt"&&se(e),{status:200,body:r}}s(Me,"handleSettle");function qe(t){const e=t.params.id,n=Ce(t.body);return p(e,n.expected_execution_id),{status:200,body:f(()=>{const o=ae(e);if(o===void 0)return{action:"stay_dormant"};const a=m(e);return ce(e,a,o)?(b(e),k(e,"park"),w(e)!==null&&O(e),x(e,{pane:null,tmux_session:null,window:null}),E({level:n.outcome==="completed"?"info":"warn",event:"broker.park.complete",...K(e)?{node_id:e}:{},outcome:n.outcome==="completed"?"succeeded":"failed"}),{action:"shutdown"}):{action:"stay_dormant"}})}}s(qe,"handleParkComplete");function De(t){const e=t.params.id;return p(e,l(t.body,"broker park-activity").expected_execution_id),{status:200,body:f(()=>({activity:de(e)?"recorded":"none"}))}}s(De,"handleParkActivity");function Le(t){const e=t.params.id,n=Ee(t.body);return p(e,n.expected_execution_id),f(()=>{Y(e,{tokensIn:n.tokens_in,contextTokens:n.context_tokens,lastActivity:n.last_activity,updatedAt:n.updated_at})}),{status:204}}s(Le,"handleTelemetry");function We(t){const e=t.params.id,n=Fe(t.body);return p(e,n.expected_execution_id),{status:200,body:{modelOverride:f(()=>ie(m(e),n.spec,n.intent,n.userSelected)).model_override}}}s(We,"handleModelCommit");function Ge(t){const e=t.params.id,n=m(e);return n.run_id&&le(e,n.run_id),{status:200,body:Be(e)}}s(Ge,"handleExtensionState");function Je(t){const e=t.params.id,n=l(t.body,"broker context");if(p(e,n.expected_execution_id),n.mode!=="baseline"&&n.mode!=="compact"&&n.mode!=="preferences")throw d("invalid broker context mode");const r=m(e),o=n.mode==="baseline"?j():I(e),a=n.mode==="compact"&&we(o),i=a?_e(o):n.mode==="preferences"?R(o):j(),u=[],c=n.mode!=="preferences"&&!a?pe(e,N(i,"transcript",u)):"";return i.preferenceSnapshot===null&&ke(i,me(e,P(e),N(i,"system",u),h(e),A({...r,grantee:h(e)}))),{status:200,body:{content:c,compact:a,snapshot:$(i),loads:u}}}s(Je,"handleContext");function Xe(t){const e=t.params.id,n=l(t.body,"broker memory refs");p(e,n.expected_execution_id);const r=m(e);he();const o=fe(A({...r,grantee:h(e)}));return{status:200,body:{refs:o.refs,names:[...o.names]}}}s(Xe,"handleMemoryRefs");function Ye(t){if(t===void 0)return[];if(!Array.isArray(t)||t.length>F)throw d(`loads must be an array of at most ${F} entries`);const e=s((n,r,o)=>{if(typeof n!="string"||n===""||n.length>B)throw d(`loads[${o}].${r} must be a non-empty string of at most ${B} characters`);return n},"field");return t.map((n,r)=>{if(typeof n!="object"||n===null||Array.isArray(n))throw d(`loads[${r}] must be an object`);const o=n,a=Object.keys(o).filter(i=>i!=="name"&&i!=="scope");if(a.length>0)throw d(`loads[${r}] has unknown field: ${a.join(", ")}`);return{name:e(o.name,"name",r),scope:e(o.scope,"scope",r)}})}s(Ye,"parseLoads");function Ve(t,e){if(e.length!==0)try{be(t,ye(e,"loaded"))}catch(n){E({level:"warn",event:"memory_reads.insert_failed",error:n,fields:{node_id:t}})}}s(Ve,"recordLoaded");function ze(t){const e=t.params.id,n=l(t.body,"broker context commit");p(e,n.expected_execution_id);const r=Ye(n.loads);return ve(e,ge(n.snapshot)),Ve(e,r),{status:204}}s(ze,"handleContextCommit");function Ue(t){const e=t.params.id,n=l(t.body,"broker context event");if(p(e,n.expected_execution_id),!["read","command","pre-command","compact","persona"].includes(n.event))throw d("invalid broker context event");if(["read","command","pre-command"].includes(n.event)&&(typeof n.value!="string"||n.value===""))throw d("broker context event requires a value");const r=m(e),o=P(e);if(o===null)throw _(`unknown node: ${e}`);const a=R(I(e)),i=A({...r,grantee:h(e)});if(n.event==="read"&&(typeof n.value!="string"||!n.value.startsWith("/")||i.allowsProject?.(n.value)===!1))throw new Z(403,"scope_missing","read file is outside the run mounts");const u=[],c=N(a,"transcript",u);return{status:200,body:{content:n.event==="read"?xe(o,n.value,c,void 0,i):n.event==="command"?Se(o,n.value,c,void 0,i):n.event==="pre-command"?Pe(o,n.value,c,void 0,i):n.event==="persona"?Ae(o,e,c,h(e),i):(Oe(a,i),""),compact:!1,snapshot:$(a),loads:u}}}s(Ue,"handleContextEvent");function He(t){const e=t.params.id,n=Re(t.body);return p(e,n.expected_execution_id),{status:200,body:f(()=>{const o=m(e);if(n.kind==="initial"){if((o.description??"").trim()!=="")return{applied:!1};const u=S(e,{description:n.description,...n.title.trim()===""?{}:{title:n.title},...n.icon.trim()===""?{}:{icon:n.icon}});return{applied:!0,editorLabel:T(u),description:u.description??"",title:u.title??"",icon:u.icon??""}}const a=n.expected;if(o.name!==a.name||(o.description??"")!==a.description||(o.title??"")!==a.title||(o.icon??"")!==a.icon||o.kind!==a.kind)return{applied:!1};const i=S(e,{description:n.description,title:n.title.trim()===""?void 0:n.title,icon:n.icon.trim()===""?void 0:n.icon});return{applied:!0,editorLabel:T(i),description:i.description??"",title:i.title??"",icon:i.icon??""}})}}s(He,"handleGeneratedName");function Ke(t){const e=t.params.id,n=je(t.body);return p(e,n.expected_execution_id),{status:200,body:f(()=>{const o=m(e),a={kind:o.kind,mode:o.mode,lifecycle:o.lifecycle},i=o.persona_ack,u=i===void 0?a:{kind:i.kind??o.kind,mode:i.mode,lifecycle:i.lifecycle};return!M(a,n.to)||!M(u,n.from)?{applied:!1}:(S(e,{persona_ack:n.to}),{applied:!0})})}}s(Ke,"handlePersonaAck");const $t=ue([{method:"POST",pattern:"/v1/nodes/:id/broker/session-bound",handler:Ie},{method:"POST",pattern:"/v1/nodes/:id/broker/settle",handler:Me},{method:"POST",pattern:"/v1/nodes/:id/broker/park-complete",handler:qe},{method:"POST",pattern:"/v1/nodes/:id/broker/park-activity",handler:De},{method:"POST",pattern:"/v1/nodes/:id/broker/telemetry",handler:Le},{method:"POST",pattern:"/v1/nodes/:id/broker/model",handler:We},{method:"GET",pattern:"/v1/nodes/:id/broker/extension-state",handler:Ge},{method:"POST",pattern:"/v1/nodes/:id/broker/context",handler:Je},{method:"POST",pattern:"/v1/nodes/:id/broker/memory-refs",handler:Xe},{method:"POST",pattern:"/v1/nodes/:id/broker/context/commit",handler:ze},{method:"POST",pattern:"/v1/nodes/:id/broker/context/event",handler:Ue},{method:"POST",pattern:"/v1/nodes/:id/broker/generated-name",handler:He},{method:"POST",pattern:"/v1/nodes/:id/broker/persona-ack",handler:Ke}]);export{$t as brokerOperationRoutes};
+var O=Object.defineProperty;var r=(t,e)=>O(t,"name",{value:e,configurable:!0});import{canonicalSessionFile as A,findNodeBySessionFile as T,getNode as _,isWarmSpare as R,listNodeIdentities as I,recordSettledTurn as $,setPresence as w,subscriptionsOf as j,updateNode as g,updateNodeTelemetry as q}from"../../../core/canvas/canvas.js";import{recordExecutionPid as C}from"../../../core/canvas/executions.js";import{bindSession as E,readLiveSession as M,transferSession as D}from"../../../core/canvas/sessions.js";import{isSafeNodeId as L}from"../../../core/canvas/paths.js";import{appForNode as P}from"../../../core/canvas/node-agent-paths.js";import{isPidAlive as G}from"../../../core/canvas/pid.js";import{editorLabel as N}from"../../../core/canvas/labels.js";import{assembleNodeSubject as J}from"../../../core/substrate/subject.js";import{withCanvasWrite as l}from"../../../core/canvas/db.js";import{notFound as v,usage as s}from"../../../core/errors.js";import{hasUnseenWakeMail as F}from"../../../core/canvas/deliveries.js";import{clearYieldMessage as W}from"../../../core/runtime/kickoff.js";import{readRoadmap as U}from"../../../core/runtime/roadmap.js";import{forkSourceNode as V}from"../../../core/runtime/nodes.js";import{transition as k}from"../../../core/runtime/lifecycle.js";import{focusOf as y,tearDownNode as x}from"../../../core/runtime/placement.js";import{hasAttachedBrokerViewers as Y}from"../viewer-presence.js";import{evaluateStop as z}from"../../../core/runtime/stop-guard.js";import{clearFault as h,recordFault as H}from"../../../core/canvas/recovery.js";import{updateModelRecipe as K}from"../../../core/runtime/model-swap.js";import{completeCompanionRequestedSubmit as Q}from"../../review/finish.js";import{emitEvent as X}from"../../../core/events/emit.js";import{consumePendingPark as Z,recordPendingParkActivity as ee}from"../../park-pending.js";import{shouldParkAfterSummary as te}from"../../park-activity.js";import{ownerOnly as ne}from"../router.js";import{requireCurrentExecution as m}from"./broker-recovery.js";import{ensureRunObserver as oe}from"../../runs/observer.js";function p(t,e){if(typeof t!="object"||t===null||Array.isArray(t))throw s(`${e} requires a JSON body`);return t}r(p,"objectBody");function ie(t){const e=p(t,"broker session-bound");if(typeof e.executionId!="string"||e.executionId==="")throw s("executionId must be a non-empty string");if(typeof e.piSessionId!="string"||e.piSessionId==="")throw s("piSessionId must be a non-empty string");if(e.sessionFile!==null&&typeof e.sessionFile!="string")throw s("sessionFile must be a string or null");if(!Number.isSafeInteger(e.pid)||e.pid<=0)throw s("pid must be a positive safe integer");if(e.reason!==null&&typeof e.reason!="string")throw s("reason must be a string or null");if(!Array.isArray(e.reviewBoundaryIds)||!e.reviewBoundaryIds.every(n=>typeof n=="string"))throw s("reviewBoundaryIds must be an array of strings");return e}r(ie,"parseSessionBoundBody");function re(t){const e=p(t,"broker settle");if(typeof e.stopReason!="string")throw s("stopReason must be a string");for(const n of["backgroundJobsRunning","pushedFinal"])if(typeof e[n]!="boolean")throw s(`${n} must be a boolean`);return e}r(re,"parseSettleBody");function se(t){const e=p(t,"broker park-complete");if(e.outcome!=="completed"&&e.outcome!=="failed")throw s("outcome must be completed or failed");return e}r(se,"parseParkCompleteBody");function ae(t){const e=p(t,"broker telemetry");if(typeof e.expected_execution_id!="string"||e.expected_execution_id==="")throw s("expected_execution_id must be a non-empty string");if(typeof e.tokens_in!="number"||!Number.isFinite(e.tokens_in)||e.tokens_in<0)throw s("tokens_in must be a non-negative finite number");if(e.context_tokens!==null&&(typeof e.context_tokens!="number"||!Number.isFinite(e.context_tokens)||e.context_tokens<0))throw s("context_tokens must be a non-negative finite number or null");if(e.last_activity!==null&&typeof e.last_activity!="string")throw s("last_activity must be a string or null");if(typeof e.updated_at!="string"||Number.isNaN(Date.parse(e.updated_at)))throw s("updated_at must be an ISO timestamp");return{...e,updated_at:new Date(e.updated_at).toISOString()}}r(ae,"parseTelemetryBody");function de(t){const e=p(t,"broker model");if(typeof e.spec!="string"||e.spec.trim()==="")throw s("spec must be a non-empty string");const n=e.intent;if(n!==void 0){const i=n!==null&&typeof n=="object"?n:void 0;if(i===void 0||typeof i.family!="string"||i.family===""||!["ultra","strong","medium","light"].includes(i.strength))throw s("intent must be { family, strength } with strength ultra|strong|medium|light when present")}if(typeof e.userSelected!="boolean")throw s("userSelected must be a boolean");return e}r(de,"parseModelCommitBody");function f(t){const e=_(t);if(e===null)throw v(`unknown node: ${t}`,{received:t});return e}r(f,"requireNode");function b(t){return{node_id:t.node_id,grantee:P(t.node_id),name:t.name,...t.description===void 0?{}:{description:t.description},...t.title===void 0?{}:{title:t.title},...t.icon===void 0?{}:{icon:t.icon},kind:t.kind,mode:t.mode,lifecycle:t.lifecycle,status:t.status,cwd:t.cwd,parent:t.parent??null,fork_from:t.fork_from??null,profile_id:t.profile_id??null,...t.managed_worktree===void 0?{}:{managed_worktree:t.managed_worktree===null?null:{state:t.managed_worktree.state,...t.managed_worktree.cleanup===void 0?{}:{cleanup:t.managed_worktree.cleanup},path:t.managed_worktree.path,branch:t.managed_worktree.branch,base_ref:t.managed_worktree.base_ref,base_sha:t.managed_worktree.base_sha}},...t.review_binding===void 0?{}:{review_binding:t.review_binding??null},intent:t.intent??null,...t.persona_ack===void 0?{}:{persona_ack:t.persona_ack},created:t.created}}r(b,"extensionNode");function ue(t){const e=f(t),n=[],i=new Set([t]);let o=e.parent??null;for(;o!==null&&o!==""&&!i.has(o);){i.add(o);const d=_(o);if(d===null)break;n.unshift(b(d)),o=d.parent??null}const a=j(t).map(d=>_(d.node_id)).filter(d=>d!==null&&d.kind!=="human").sort((d,S)=>d.status===S.status?0:d.status==="active"?-1:S.status==="active"?1:0).map(b),c=typeof e.fork_source_file=="string"?V(e.fork_source_file):null,u=J(t);if(u===null)throw v(`unknown node: ${t}`,{received:t});return{node:b(e),warm_spare:R(t),ancestors:n,children:a,fork_source:c===null?null:b(c),subject:u,report_nodes:I().map(d=>({...d,grantee:P(d.node_id)})),roadmap:U(t)}}r(ue,"extensionState");function B(t,e){return t?.kind===e.kind&&t?.mode===e.mode&&t?.lifecycle===e.lifecycle}r(B,"samePersona");function ce(t){const e=p(t,"broker generated-name");if(e.kind!=="initial"&&e.kind!=="recap")throw s("kind must be initial or recap");if(typeof e.description!="string"||typeof e.title!="string"||typeof e.icon!="string")throw s("description, title, and icon must be strings");if(e.kind==="initial")return e;const n=e.expected;if(typeof n!="object"||n===null||Array.isArray(n)||["name","description","title","icon","kind"].some(i=>typeof n[i]!="string"))throw s("recap expected must contain name, description, title, icon, and kind strings");return e}r(ce,"parseGeneratedNameBody");function le(t){const e=p(t,"broker persona-ack"),n=r(i=>{const o=e[i];if(typeof o!="object"||o===null||Array.isArray(o)||typeof o.kind!="string"||o.mode!=="base"&&o.mode!=="orchestrator"||o.lifecycle!=="terminal"&&o.lifecycle!=="resident")throw s(`${i} must be a persona state`);return o},"parse");return{expected_execution_id:e.expected_execution_id,from:n("from"),to:n("to")}}r(le,"parsePersonaAckBody");function pe(t){const e=t.params.id,n=ie(t.body),i=n.sessionFile===null?null:A(n.sessionFile);return{status:200,body:l(()=>{const a=f(e);if(C(n.executionId,e,n.pid)==="shutdown")return{action:"shutdown"};const c=a.review_binding?.review_id;if(c!==void 0&&!n.reviewBoundaryIds.includes(c))return{action:"shutdown"};if(n.reason==="new"&&a.parent==null)return{action:"relaunch_root"};if(n.reason!=="new"&&a.fork_from!=null&&a.pi_session_id==null&&i===null)return{action:"shutdown"};const u=i===null?null:T(i);if(u!==null&&u.node_id!==e){if(G(u.pi_pid))return H(e,{link:"daemon\u2192node",op:"session-file-ownership",kind:"protocol",retry:{disposition:"fatal"},message:`refusing to bind ${i}: it is owned by live node ${u.node_id}`}),{action:"shutdown"};const d=M(u.node_id);if(d===null||D({fromNodeId:u.node_id,fromBindingId:d.bindingId,toNodeId:e,executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:i})!=="transferred")return{action:"shutdown"}}else if(E(e,{executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:i})==="shutdown")return{action:"shutdown"};return n.reason!=="new"&&(W(e),a.intent==="refresh"&&k(e,"revive")),{action:"none"}})}}r(pe,"handleSessionBound");function me(t,e){const n=_(t);if(n===null){if(e.pushedFinal)return{action:"shutdown"};throw v(`unknown node: ${t}`,{received:t})}if($(t,new Date().toISOString()),e.stopReason==="quit")return(n.status==="active"||n.status==="idle")&&n.intent===null&&(k(t,"finish"),h(t),y(t)!==null&&x(t),w(t,{pane:null,tmux_session:null,window:null})),{action:"shutdown"};if(e.stopReason!=="stop"&&e.stopReason!=="length")return h(t,{link:"daemon\u2192node"}),n.intent==="refresh"?{action:"shutdown"}:{action:"stay_dormant"};const i={pushedFinal:e.pushedFinal};if(i.pushedFinal||n.status==="done")return h(t),y(t)!==null&&x(t),w(t,{pane:null,tmux_session:null,window:null}),{action:"shutdown"};if(n.intent==="refresh")return h(t),{action:"shutdown"};const o=z(t,i,e.backgroundJobsRunning);return h(t),o.action==="reprompt"?{action:"reprompt",prompt:o.message}:o.reason==="finished"?F(t)?{action:"stay_dormant"}:{action:"shutdown"}:o.reason!=="awaiting"&&o.reason!=="scheduled"?{action:"stay_dormant"}:y(t)!==null||Y(t)||F(t)?{action:"stay_dormant"}:(k(t,"release"),{action:"shutdown"})}r(me,"settleBroker");function fe(t){const e=t.params.id,n=re(t.body);m(e,n.expected_execution_id);const i=l(()=>me(e,n));return i.action!=="reprompt"&&Q(e),{status:200,body:i}}r(fe,"handleSettle");function he(t){const e=t.params.id,n=se(t.body);return m(e,n.expected_execution_id),{status:200,body:l(()=>{const o=Z(e);if(o===void 0)return{action:"stay_dormant"};const a=f(e);return te(e,a,o)?(h(e),k(e,"park"),y(e)!==null&&x(e),w(e,{pane:null,tmux_session:null,window:null}),X({level:n.outcome==="completed"?"info":"warn",event:"broker.park.complete",...L(e)?{node_id:e}:{},outcome:n.outcome==="completed"?"succeeded":"failed"}),{action:"shutdown"}):{action:"stay_dormant"}})}}r(he,"handleParkComplete");function _e(t){const e=t.params.id;return m(e,p(t.body,"broker park-activity").expected_execution_id),{status:200,body:l(()=>({activity:ee(e)?"recorded":"none"}))}}r(_e,"handleParkActivity");function ke(t){const e=t.params.id,n=ae(t.body);return m(e,n.expected_execution_id),l(()=>{q(e,{tokensIn:n.tokens_in,contextTokens:n.context_tokens,lastActivity:n.last_activity,updatedAt:n.updated_at})}),{status:204}}r(ke,"handleTelemetry");function ye(t){const e=t.params.id,n=de(t.body);return m(e,n.expected_execution_id),{status:200,body:{modelOverride:l(()=>K(f(e),n.spec,n.intent,n.userSelected)).model_override}}}r(ye,"handleModelCommit");function be(t){const e=t.params.id,n=f(e);return n.run_id&&oe(e,n.run_id),{status:200,body:ue(e)}}r(be,"handleExtensionState");function we(t){const e=t.params.id,n=ce(t.body);return m(e,n.expected_execution_id),{status:200,body:l(()=>{const o=f(e);if(n.kind==="initial"){if((o.description??"").trim()!=="")return{applied:!1};const u=g(e,{description:n.description,...n.title.trim()===""?{}:{title:n.title},...n.icon.trim()===""?{}:{icon:n.icon}});return{applied:!0,editorLabel:N(u),description:u.description??"",title:u.title??"",icon:u.icon??""}}const a=n.expected;if(o.name!==a.name||(o.description??"")!==a.description||(o.title??"")!==a.title||(o.icon??"")!==a.icon||o.kind!==a.kind)return{applied:!1};const c=g(e,{description:n.description,title:n.title.trim()===""?void 0:n.title,icon:n.icon.trim()===""?void 0:n.icon});return{applied:!0,editorLabel:N(c),description:c.description??"",title:c.title??"",icon:c.icon??""}})}}r(we,"handleGeneratedName");function ge(t){const e=t.params.id,n=le(t.body);return m(e,n.expected_execution_id),{status:200,body:l(()=>{const o=f(e),a={kind:o.kind,mode:o.mode,lifecycle:o.lifecycle},c=o.persona_ack,u=c===void 0?a:{kind:c.kind??o.kind,mode:c.mode,lifecycle:c.lifecycle};return!B(a,n.to)||!B(u,n.from)?{applied:!1}:(g(e,{persona_ack:n.to}),{applied:!0})})}}r(ge,"handlePersonaAck");const Ke=ne([{method:"POST",pattern:"/v1/nodes/:id/broker/session-bound",handler:pe},{method:"POST",pattern:"/v1/nodes/:id/broker/settle",handler:fe},{method:"POST",pattern:"/v1/nodes/:id/broker/park-complete",handler:he},{method:"POST",pattern:"/v1/nodes/:id/broker/park-activity",handler:_e},{method:"POST",pattern:"/v1/nodes/:id/broker/telemetry",handler:ke},{method:"POST",pattern:"/v1/nodes/:id/broker/model",handler:ye},{method:"GET",pattern:"/v1/nodes/:id/broker/extension-state",handler:be},{method:"POST",pattern:"/v1/nodes/:id/broker/generated-name",handler:we},{method:"POST",pattern:"/v1/nodes/:id/broker/persona-ack",handler:ge}]);export{Ke as brokerOperationRoutes};

package/dist/daemon/api/handlers/canvas.js

@@ -1,6 +1,6 @@
-var H=Object.defineProperty;var c=(t,e)=>H(t,"name",{value:e,configurable:!0});import{graphNodes as q,listNodes as M,pruneNodes as x,pruneToLimit as J,rosterEdges as N,rosterNodes as z}from"../../../core/canvas/canvas.js";import{activeBackgroundBashJobs as Q}from"../../../core/bash-jobs.js";import{contextDir as U}from"../../../core/canvas/node-agent-paths.js";import{nowIso as k}from"../../../core/fs-utils.js";import{isPidPresent as Y}from"../../../core/canvas/pid.js";import{dashboardRowsAllFromSource as V,enrichRowsFromSource as W}from"../../../core/canvas/render-source.js";import{localCanvasSource as j}from"../../../core/canvas/source.js";import{ticketCountsForNodes as B,ticketsAcrossCanvas as X}from"../../../core/canvas/attention.js";import{buildCorpus as Z,groupCorpus as ee,resolveRef as te}from"../../../core/canvas/history.js";import{listFocuses as O,reapEmptyNodes as ne}from"../../../core/runtime/placement.js";import{boundFleet as oe}from"../../../core/runtime/fleet.js";import{retentionHold as re}from"../../reconcilers/live-obligation.js";import{notFound as se,usage as p}from"../../../core/errors.js";import{toGraphNodeDTO as ie}from"../map.js";import{canReadNode as L,canReadRun as de}from"../router.js";import{ApiError as ae}from"../../../api/errors.js";function g(t){return t.principal.class==="person"?null:new Set(M().filter(e=>L(t.principal,e.grantee??"app:terminal")).map(e=>e.node_id))}c(g,"visibleNodes");function T(t){return t.principal.class==="person"?null:new Set(M().filter(e=>e.run_id?de(t.principal,e.grantee??"app:terminal"):L(t.principal,e.grantee??"app:terminal")).map(e=>e.node_id))}c(T,"visibleHistoryNodes");function ce(t){const e=g(t);return{status:200,body:{items:X().filter(n=>e===null||e.has(n.node_id)).map(n=>({node_id:n.node_id,name:n.name,cwd:n.cwd,count:n.count,subjects:n.subjects}))}}}c(ce,"handleAttention");function le(t){const e=t.body;if(e===null||typeof e!="object"||!Array.isArray(e.node_ids))throw p("attention count request requires node_ids: string[]");const o=e.node_ids;if(!o.every(i=>typeof i=="string"))throw p("attention count request node_ids must contain only strings");const n=g(t);return{status:200,body:{counts:B(o.filter(i=>n===null||n.has(i)))}}}c(le,"handleAttentionCounts");function E(t){return Buffer.from(String(t),"utf8").toString("base64")}c(E,"encodeCursor");function F(t){const e=Number(Buffer.from(t,"base64").toString("utf8"));if(!Number.isInteger(e)||e<0)throw p(`invalid cursor: ${t}`);return e}c(F,"decodeCursor");function ue(t,e,o){const s=t.loadBody().split(`
-`);if(e.length>0){const a=s.findIndex(u=>{const l=u.toLowerCase();return e.some(m=>l.includes(m))});if(a!==-1)return s.slice(a,a+o).map(u=>u.trim()).filter(u=>u!=="").join(" \u23CE ")}const i=s.map(a=>a.trim()).filter(a=>a!=="").slice(0,o).join(" \u23CE ");return i!==""?i:t.title}c(ue,"snippet");function fe(t,e,o){const n=[...t];return e==="relevance"&&o!==void 0?n.sort((s,i)=>(o.get(i.ref)??0)-(o.get(s.ref)??0)||i.tsMs-s.tsMs||s.ref.localeCompare(i.ref)):e==="oldest"?n.sort((s,i)=>s.tsMs-i.tsMs||s.ref.localeCompare(i.ref)):n.sort((s,i)=>i.tsMs-s.tsMs||s.ref.localeCompare(i.ref)),n}c(fe,"sortArtifacts");function pe(t){if(t==null)return{};if(typeof t!="object")throw p("history search body must be a JSON object");return t}c(pe,"parseSearchBody");function me(t){if(t===null||typeof t!="object")throw p("history grep body must be a JSON object");const e=t;if(typeof e.pattern!="string"||e.pattern==="")throw p("history grep body requires a non-empty pattern");return e}c(me,"parseGrepBody");function $(t,e){const o={cwd:t.cwd,allCwds:t.all_cwds===!0,under:t.under,nodes:t.nodes},n={types:t.types,reportKind:t.report_kind,kinds:t.kinds,statuses:t.statuses,sinceMs:t.since_ms,untilMs:t.until_ms,origins:t.origins,roles:t.roles,from:t.from},s=T(e);return Z(o,n).filter(i=>s===null||s.has(i.nodeId))}c($,"buildCorpusFromQuery");function he(t){if(t==null)return{};if(typeof t!="object")throw p("history stats body must be a JSON object");return t}c(he,"parseStatsBody");const I=["origin","node","kind","day","type","role"];function ye(t){const e=he(t.body),o=e.group_by??"type";if(!I.includes(o))throw p(`--group-by must be one of: ${I.join(", ")}; received: ${String(e.group_by)}`);const n=$(e,t),s=ee(n,o);return{status:200,body:{group_by:o,groups:s,total:s.reduce((a,u)=>a+u.count,0),scanned:n.length}}}c(ye,"handleHistoryStats");function _e(t){const e=me(t.body),o=Math.min(100,Math.max(1,e.limit??20)),n=$(e,t),s=e.cursor!==void 0?F(e.cursor):0;let i;try{i=new RegExp(e.pattern,"i")}catch{throw p(`invalid regex pattern: ${e.pattern}`)}const a=[];for(const r of n)r.loadBody().split(`
-`).forEach((y,b)=>{i.test(y)&&a.push({ref:r.ref,node:`${r.nodeName} (${r.nodeId})`,ts:r.ts,line:b+1,text:y.trim()})});a.sort((r,d)=>r.ref.localeCompare(d.ref)||r.line-d.line);const u=a.slice(s,s+o),l=s+o<a.length?E(s+o):null;return{status:200,body:{hits:u,next_cursor:l,total:a.length}}}c(_e,"handleHistoryGrep");function be(t){const e=pe(t.body),o=(e.query??"").trim(),n=e.weigh_body===!0,s=e.full===!0,i=Math.max(1,e.snippet_lines??1),a=Math.min(100,Math.max(1,e.limit??20)),u=$(e,t),l=e.cursor!==void 0?F(e.cursor):0,m=o.toLowerCase().split(/\s+/).filter(f=>f.length>0);let r=u,d;const y=e.sort??(m.length>0?"relevance":"recency");if(m.length>0&&y==="relevance"){d=new Map;const f=[];for(const h of u){const C=h.title.toLowerCase(),K=h.nodeName.toLowerCase(),D=h.nodeDesc.toLowerCase(),R=n?h.loadBody().toLowerCase():null;let _=0;for(const w of m)C.includes(w)&&(_+=10),K.includes(w)&&(_+=5),D.includes(w)&&(_+=3),R!==null&&R.includes(w)&&(_+=1);_>0&&(d.set(h.ref,_),f.push(h))}r=f}else m.length>0&&(r=u.filter(f=>{const h=`${f.title}
+var x=Object.defineProperty;var c=(t,e)=>x(t,"name",{value:e,configurable:!0});import{graphNodes as q,listNodes as M,pruneNodes as J,pruneToLimit as K,rosterEdges as N,rosterNodes as z}from"../../../core/canvas/canvas.js";import{activeBackgroundBashJobs as Q}from"../../../core/bash-jobs.js";import{contextDir as U}from"../../../core/canvas/node-agent-paths.js";import{nowIso as k}from"../../../core/fs-utils.js";import{isPidPresent as Y}from"../../../core/canvas/pid.js";import{dashboardRowsAllFromSource as V,enrichRowsFromSource as W}from"../../../core/canvas/render-source.js";import{localCanvasSource as j}from"../../../core/canvas/source.js";import{ticketCountsForNodes as B,ticketsAcrossCanvas as X}from"../../../core/canvas/attention.js";import{buildCorpus as Z,groupCorpus as ee,resolveRef as te}from"../../../core/canvas/history.js";import{listFocuses as O,reapEmptyNodes as ne}from"../../../core/runtime/placement.js";import{boundFleet as oe}from"../../../core/runtime/fleet.js";import{retentionHold as se}from"../../reconcilers/live-obligation.js";import{notFound as re,usage as m}from"../../../core/errors.js";import{toGraphNodeDTO as ie}from"../map.js";import{canReadNode as L,canReadRun as de}from"../router.js";import{ApiError as ae}from"../../../api/errors.js";function g(t){return t.principal.class==="person"?null:new Set(M().filter(e=>L(t.principal,e.grantee??"app:terminal")).map(e=>e.node_id))}c(g,"visibleNodes");function T(t){return t.principal.class==="person"?null:new Set(M().filter(e=>e.run_id?de(t.principal,e.grantee??"app:terminal"):L(t.principal,e.grantee??"app:terminal")).map(e=>e.node_id))}c(T,"visibleHistoryNodes");function ce(t){const e=g(t);return{status:200,body:{items:X().filter(o=>e===null||e.has(o.node_id)).map(o=>({node_id:o.node_id,name:o.name,cwd:o.cwd,count:o.count,subjects:o.subjects}))}}}c(ce,"handleAttention");function le(t){const e=t.body;if(e===null||typeof e!="object"||!Array.isArray(e.node_ids))throw m("attention count request requires node_ids: string[]");const n=e.node_ids;if(!n.every(i=>typeof i=="string"))throw m("attention count request node_ids must contain only strings");const o=g(t);return{status:200,body:{counts:B(n.filter(i=>o===null||o.has(i)))}}}c(le,"handleAttentionCounts");function E(t){return Buffer.from(String(t),"utf8").toString("base64")}c(E,"encodeCursor");function I(t){const e=Number(Buffer.from(t,"base64").toString("utf8"));if(!Number.isInteger(e)||e<0)throw m(`invalid cursor: ${t}`);return e}c(I,"decodeCursor");function ue(t,e,n){const r=t.loadBody().split(`
+`);if(e.length>0){const a=r.findIndex(u=>{const l=u.toLowerCase();return e.some(p=>l.includes(p))});if(a!==-1)return r.slice(a,a+n).map(u=>u.trim()).filter(u=>u!=="").join(" \u23CE ")}const i=r.map(a=>a.trim()).filter(a=>a!=="").slice(0,n).join(" \u23CE ");return i!==""?i:t.title}c(ue,"snippet");function fe(t,e,n){const o=[...t];return e==="relevance"&&n!==void 0?o.sort((r,i)=>(n.get(i.ref)??0)-(n.get(r.ref)??0)||i.tsMs-r.tsMs||r.ref.localeCompare(i.ref)):e==="oldest"?o.sort((r,i)=>r.tsMs-i.tsMs||r.ref.localeCompare(i.ref)):o.sort((r,i)=>i.tsMs-r.tsMs||r.ref.localeCompare(i.ref)),o}c(fe,"sortArtifacts");function me(t){if(t==null)return{};if(typeof t!="object")throw m("history search body must be a JSON object");return t}c(me,"parseSearchBody");function pe(t){if(t===null||typeof t!="object")throw m("history grep body must be a JSON object");const e=t;if(typeof e.pattern!="string"||e.pattern==="")throw m("history grep body requires a non-empty pattern");return e}c(pe,"parseGrepBody");function R(t,e){const n={cwd:t.cwd,allCwds:t.all_cwds===!0,under:t.under,nodes:t.nodes},o={types:t.types,kinds:t.kinds,statuses:t.statuses,sinceMs:t.since_ms,untilMs:t.until_ms,origins:t.origins,roles:t.roles,from:t.from},r=T(e);return Z(n,o).filter(i=>r===null||r.has(i.nodeId))}c(R,"buildCorpusFromQuery");function he(t){if(t==null)return{};if(typeof t!="object")throw m("history stats body must be a JSON object");return t}c(he,"parseStatsBody");const F=["origin","node","kind","day","type","role"];function ye(t){const e=he(t.body),n=e.group_by??"type";if(!F.includes(n))throw m(`--group-by must be one of: ${F.join(", ")}; received: ${String(e.group_by)}`);const o=R(e,t),r=ee(o,n);return{status:200,body:{group_by:n,groups:r,total:r.reduce((a,u)=>a+u.count,0),scanned:o.length}}}c(ye,"handleHistoryStats");function _e(t){const e=pe(t.body),n=Math.min(100,Math.max(1,e.limit??20)),o=R(e,t),r=e.cursor!==void 0?I(e.cursor):0;let i;try{i=new RegExp(e.pattern,"i")}catch{throw m(`invalid regex pattern: ${e.pattern}`)}const a=[];for(const s of o)s.loadBody().split(`
+`).forEach((y,b)=>{i.test(y)&&a.push({ref:s.ref,node:`${s.nodeName} (${s.nodeId})`,ts:s.ts,line:b+1,text:y.trim()})});a.sort((s,d)=>s.ref.localeCompare(d.ref)||s.line-d.line);const u=a.slice(r,r+n),l=r+n<a.length?E(r+n):null;return{status:200,body:{hits:u,next_cursor:l,total:a.length}}}c(_e,"handleHistoryGrep");function be(t){const e=me(t.body),n=(e.query??"").trim(),o=e.weigh_body===!0,r=e.full===!0,i=Math.max(1,e.snippet_lines??1),a=Math.min(100,Math.max(1,e.limit??20)),u=R(e,t),l=e.cursor!==void 0?I(e.cursor):0,p=n.toLowerCase().split(/\s+/).filter(f=>f.length>0);let s=u,d;const y=e.sort??(p.length>0?"relevance":"recency");if(p.length>0&&y==="relevance"){d=new Map;const f=[];for(const h of u){const C=h.title.toLowerCase(),D=h.nodeName.toLowerCase(),H=h.nodeDesc.toLowerCase(),$=o?h.loadBody().toLowerCase():null;let _=0;for(const w of p)C.includes(w)&&(_+=10),D.includes(w)&&(_+=5),H.includes(w)&&(_+=3),$!==null&&$.includes(w)&&(_+=1);_>0&&(d.set(h.ref,_),f.push(h))}s=f}else p.length>0&&(s=u.filter(f=>{const h=`${f.title}
 ${f.nodeName}
-${f.nodeDesc}${n?`
-`+f.loadBody():""}`.toLowerCase();return m.some(C=>h.includes(C))}));const b=fe(r,y,d),P=b.slice(l,l+a),A=l+a<b.length?E(l+a):null;return{status:200,body:{hits:P.map(f=>{const h={ref:f.ref,node:`${f.nodeName} (${f.nodeId})`,kind:f.nodeKind,source:f.source==="report"&&f.reportKind?`report:${f.reportKind}`:f.source,ts:f.ts};return y==="relevance"&&d!==void 0&&(h.score=d.get(f.ref)??0),s?h.body=f.loadBody():h.snippet=ue(f,m,i),h}),next_cursor:A,total:b.length}}}c(be,"handleHistorySearch");function ge(t){const e=(t.query.get("ref")??"").trim(),o=t.query.get("frontmatter")==="true";if(!e.includes(":"))throw p(`ref must be <node-id>:<relpath>; received: ${e}`,{received:e,next:"Get a valid ref from `crtr canvas history search` or `crtr node inspect artifacts <node-id>`."});let n;try{n=te(e)}catch(l){throw p(`ref rejected: ${l.message}`,{received:e,next:"Refs come verbatim from `crtr canvas history search`; do not hand-construct relpaths."})}if(n===null)throw se(`no artifact for ref: ${e}`,{ref:e,next:"The node or file may not exist. Re-run `crtr canvas history search` for a current ref, or `crtr node inspect artifacts <node-id>` to list a node's artifacts."});if(T(t)?.has(n.nodeId)===!1)throw new ae(404,"not_found","artifact not found");const s=n.source==="report"&&n.reportKind?`report:${n.reportKind}`:n.source,a=(t.query.get("format")==="raw"||o)&&n.raw!==null?n.raw:n.body;return{status:200,body:{ref:e,node:`${n.nodeName} (${n.nodeId})`,source:s,ts:n.ts,content:a}}}c(ge,"handleHistoryRead");function ve(t){for(const[n]of t.query)if(n!=="live")throw p(`unknown snapshot query parameter: ${n}`);const e=t.query.getAll("live");if(e.length>1)throw p("live must appear at most once");const o=e[0];if(o===void 0||o==="false"||o==="0")return!1;if(o==="true"||o==="1")return!0;throw p("live must be true or false")}c(ve,"snapshotLiveOnly");async function we(t){const e=new Set(O().map(r=>r.node_id)),o=g(t),n=(await V(j,e,ve(t))).filter(r=>o===null||o.has(r.node_id)),s=B(n.map(r=>r.node_id));await W(j,n,s);const i=n.map(r=>{const d=r.srcRow,y=d?.host_kind??"tmux";return{node_id:r.node_id,name:r.name,title:r.handle??r.name,description:r.description??null,kind:r.kind,mode:r.mode,lifecycle:r.lifecycle??d?.lifecycle,status:r.status,cwd:r.cwd,profile_id:r.profile_id??null,parent:d?.parent??null,created:r.created,host_kind:y,enterable:y==="broker",attention_count:r.asks,...d?.cycles!=null?{cycles:d.cycles}:{},...r.mtimeMs!==void 0?{last_activity:new Date(r.mtimeMs).toISOString()}:{},ctx_tokens:r.ctx_tokens,streaming:r.streaming??!1,jobs_active:d!==void 0&&Y(d.pi_pid)?Q(U(r.node_id)).length:0,waiting_for:d?.waiting_for??null,hanging:r.hanging??null,viewed:r.viewed??!1,final_report:d?.final_report??null,finalized_at:d?.finalized_at??null}}),a=new Map;for(const r of N()){const d=a.get(r.from_id);d===void 0?a.set(r.from_id,[r.to_id]):d.push(r.to_id)}const u=new Set(n.map(r=>r.node_id)),l=Object.fromEntries(n.map(r=>[r.node_id,(a.get(r.node_id)??[]).filter(d=>u.has(d))]));return{status:200,body:{generated_at:k(),nodes:i,subscriptions:l}}}c(we,"handleSnapshot");function G(){const t=z().map(o=>{const n=o.host_kind??"tmux";return{node_id:o.node_id,name:o.name,kind:o.kind,mode:o.mode,lifecycle:o.lifecycle,status:o.status,cwd:o.cwd,host_kind:n,enterable:n==="broker",parent:o.parent,created:o.created}}),e=N().map(o=>({from_id:o.from_id,to_id:o.to_id,active:o.active,created:o.created}));return{generated_at:k(),nodes:t,edges:e}}c(G,"buildRoster");let v=null,S=null;function Se(){return v===null?(v=Promise.resolve().then(()=>G()).finally(()=>{v=null}),v):(S===null&&(S=v.then(()=>G()).finally(()=>{S=null})),S)}c(Se,"rosterCoalesced");async function Ce(t){const e=await Se(),o=g(t);return o===null?{status:200,body:e}:{status:200,body:{...e,nodes:e.nodes.filter(n=>o.has(n.node_id)),edges:e.edges.filter(n=>o.has(n.from_id)&&o.has(n.to_id))}}}c(Ce,"handleRoster");function Ne(t){const e=g(t);return{status:200,body:{generated_at:k(),nodes:q().filter(n=>e===null||e.has(n.node_id)).map(ie),edges:N().filter(n=>e===null||e.has(n.from_id)&&e.has(n.to_id)).map(n=>({from_id:n.from_id,to_id:n.to_id,active:n.active,created:n.created})),focused_node_ids:O().map(n=>n.node_id).filter(n=>e===null||e.has(n))}}}c(Ne,"handleGraph");function ke(t){if(t==null)return{};if(typeof t!="object")throw p("prune body must be a JSON object");const e=t,o=c(r=>{const d=e[r];if(d!==void 0){if(typeof d!="number"||!Number.isFinite(d))throw p(`${r} must be a number`);return d}},"num"),n=c(r=>{const d=e[r];if(d!==void 0){if(typeof d!="boolean")throw p(`${r} must be a boolean`);return d}},"bool"),s={},i=o("limit");i!==void 0&&(s.limit=i);const a=o("ttl_days");a!==void 0&&(s.ttl_days=a);const u=n("include_stale");u!==void 0&&(s.include_stale=u);const l=n("empty");l!==void 0&&(s.empty=l);const m=n("dry_run");return m!==void 0&&(s.dry_run=m),s}c(ke,"parsePruneBody");function $e(t){const e=ke(t.body),o=e.ttl_days??14,n=e.dry_run??!1,s=re(oe());let i;return e.limit!==void 0?i=J({maxNodes:e.limit,held:s,dryRun:n}).pruned.map(l=>({node_id:l.node_id,status:l.status,created:l.created})):e.empty===!0?i=ne({dryRun:n}).map(l=>({node_id:l,status:"empty",created:""})):i=x({ttlDays:o,held:s,dryRun:n,includeStale:e.include_stale??!1}).pruned.map(l=>({node_id:l.node_id,status:l.status,created:l.created})),{status:200,body:{pruned:i,dry_run:n,ttl_days:o}}}c($e,"handlePrune");const ze=[{method:"GET",pattern:"/v1/canvas/attention",handler:ce},{method:"POST",pattern:"/v1/canvas/attention/counts",handler:le},{method:"POST",pattern:"/v1/canvas/history/search",handler:be},{method:"POST",pattern:"/v1/canvas/history/grep",handler:_e},{method:"GET",pattern:"/v1/canvas/history/read",handler:ge},{method:"POST",pattern:"/v1/canvas/history/stats",handler:ye},{method:"GET",pattern:"/v1/canvas/snapshot",handler:we},{method:"GET",pattern:"/v1/canvas/roster",handler:Ce},{method:"GET",pattern:"/v1/canvas/graph",handler:Ne},{method:"POST",pattern:"/v1/canvas/prune",ownerOnly:!0,handler:$e}];export{ze as canvasRoutes};
+${f.nodeDesc}${o?`
+`+f.loadBody():""}`.toLowerCase();return p.some(C=>h.includes(C))}));const b=fe(s,y,d),P=b.slice(l,l+a),A=l+a<b.length?E(l+a):null;return{status:200,body:{hits:P.map(f=>{const h={ref:f.ref,node:`${f.nodeName} (${f.nodeId})`,kind:f.nodeKind,source:f.source,ts:f.ts};return y==="relevance"&&d!==void 0&&(h.score=d.get(f.ref)??0),r?h.body=f.loadBody():h.snippet=ue(f,p,i),h}),next_cursor:A,total:b.length}}}c(be,"handleHistorySearch");function ge(t){const e=(t.query.get("ref")??"").trim();if(!e.includes(":"))throw m(`ref must be <node-id>:inbox/<n>, <node-id>:session, or <node-id>:session/<n>; received: ${e}`,{received:e,next:"Get a valid ref from `crtr canvas history search`. Reports and documents are `crtr canvas read <name>`."});const n=te(e);if(n===null)throw re(`no inbox entry or message for ref: ${e}`,{ref:e,next:"Re-run `crtr canvas history search` for a current ref. Reports and documents are `crtr canvas read <name>`."});if(T(t)?.has(n.nodeId)===!1)throw new ae(404,"not_found","artifact not found");const o=n.source,i=t.query.get("format")==="raw"&&n.raw!==null?n.raw:n.body;return{status:200,body:{ref:e,node:`${n.nodeName} (${n.nodeId})`,source:o,ts:n.ts,content:i}}}c(ge,"handleHistoryRead");function ve(t){for(const[o]of t.query)if(o!=="live")throw m(`unknown snapshot query parameter: ${o}`);const e=t.query.getAll("live");if(e.length>1)throw m("live must appear at most once");const n=e[0];if(n===void 0||n==="false"||n==="0")return!1;if(n==="true"||n==="1")return!0;throw m("live must be true or false")}c(ve,"snapshotLiveOnly");async function we(t){const e=new Set(O().map(s=>s.node_id)),n=g(t),o=(await V(j,e,ve(t))).filter(s=>n===null||n.has(s.node_id)),r=B(o.map(s=>s.node_id));await W(j,o,r);const i=o.map(s=>{const d=s.srcRow,y=d?.host_kind??"tmux";return{node_id:s.node_id,name:s.name,title:s.handle??s.name,description:s.description??null,kind:s.kind,mode:s.mode,lifecycle:s.lifecycle??d?.lifecycle,status:s.status,cwd:s.cwd,profile_id:s.profile_id??null,parent:d?.parent??null,created:s.created,host_kind:y,enterable:y==="broker",attention_count:s.asks,...d?.cycles!=null?{cycles:d.cycles}:{},...s.mtimeMs!==void 0?{last_activity:new Date(s.mtimeMs).toISOString()}:{},ctx_tokens:s.ctx_tokens,streaming:s.streaming??!1,jobs_active:d!==void 0&&Y(d.pi_pid)?Q(U(s.node_id)).length:0,waiting_for:d?.waiting_for??null,hanging:s.hanging??null,viewed:s.viewed??!1,final_report:d?.final_report??null,finalized_at:d?.finalized_at??null}}),a=new Map;for(const s of N()){const d=a.get(s.from_id);d===void 0?a.set(s.from_id,[s.to_id]):d.push(s.to_id)}const u=new Set(o.map(s=>s.node_id)),l=Object.fromEntries(o.map(s=>[s.node_id,(a.get(s.node_id)??[]).filter(d=>u.has(d))]));return{status:200,body:{generated_at:k(),nodes:i,subscriptions:l}}}c(we,"handleSnapshot");function G(){const t=z().map(n=>{const o=n.host_kind??"tmux";return{node_id:n.node_id,name:n.name,kind:n.kind,mode:n.mode,lifecycle:n.lifecycle,status:n.status,cwd:n.cwd,host_kind:o,enterable:o==="broker",parent:n.parent,created:n.created}}),e=N().map(n=>({from_id:n.from_id,to_id:n.to_id,active:n.active,created:n.created}));return{generated_at:k(),nodes:t,edges:e}}c(G,"buildRoster");let v=null,S=null;function Se(){return v===null?(v=Promise.resolve().then(()=>G()).finally(()=>{v=null}),v):(S===null&&(S=v.then(()=>G()).finally(()=>{S=null})),S)}c(Se,"rosterCoalesced");async function Ce(t){const e=await Se(),n=g(t);return n===null?{status:200,body:e}:{status:200,body:{...e,nodes:e.nodes.filter(o=>n.has(o.node_id)),edges:e.edges.filter(o=>n.has(o.from_id)&&n.has(o.to_id))}}}c(Ce,"handleRoster");function Ne(t){const e=g(t);return{status:200,body:{generated_at:k(),nodes:q().filter(o=>e===null||e.has(o.node_id)).map(ie),edges:N().filter(o=>e===null||e.has(o.from_id)&&e.has(o.to_id)).map(o=>({from_id:o.from_id,to_id:o.to_id,active:o.active,created:o.created})),focused_node_ids:O().map(o=>o.node_id).filter(o=>e===null||e.has(o))}}}c(Ne,"handleGraph");function ke(t){if(t==null)return{};if(typeof t!="object")throw m("prune body must be a JSON object");const e=t,n=c(s=>{const d=e[s];if(d!==void 0){if(typeof d!="number"||!Number.isFinite(d))throw m(`${s} must be a number`);return d}},"num"),o=c(s=>{const d=e[s];if(d!==void 0){if(typeof d!="boolean")throw m(`${s} must be a boolean`);return d}},"bool"),r={},i=n("limit");i!==void 0&&(r.limit=i);const a=n("ttl_days");a!==void 0&&(r.ttl_days=a);const u=o("include_stale");u!==void 0&&(r.include_stale=u);const l=o("empty");l!==void 0&&(r.empty=l);const p=o("dry_run");return p!==void 0&&(r.dry_run=p),r}c(ke,"parsePruneBody");function Re(t){const e=ke(t.body),n=e.ttl_days??14,o=e.dry_run??!1,r=se(oe());let i;return e.limit!==void 0?i=K({maxNodes:e.limit,held:r,dryRun:o}).pruned.map(l=>({node_id:l.node_id,status:l.status,created:l.created})):e.empty===!0?i=ne({dryRun:o}).map(l=>({node_id:l,status:"empty",created:""})):i=J({ttlDays:n,held:r,dryRun:o,includeStale:e.include_stale??!1}).pruned.map(l=>({node_id:l.node_id,status:l.status,created:l.created})),{status:200,body:{pruned:i,dry_run:o,ttl_days:n}}}c(Re,"handlePrune");const ze=[{method:"GET",pattern:"/v1/canvas/attention",handler:ce},{method:"POST",pattern:"/v1/canvas/attention/counts",handler:le},{method:"POST",pattern:"/v1/canvas/history/search",handler:be},{method:"POST",pattern:"/v1/canvas/history/grep",handler:_e},{method:"GET",pattern:"/v1/canvas/history/read",handler:ge},{method:"POST",pattern:"/v1/canvas/history/stats",handler:ye},{method:"GET",pattern:"/v1/canvas/snapshot",handler:we},{method:"GET",pattern:"/v1/canvas/roster",handler:Ce},{method:"GET",pattern:"/v1/canvas/graph",handler:Ne},{method:"POST",pattern:"/v1/canvas/prune",ownerOnly:!0,handler:Re}];export{ze as canvasRoutes};

package/dist/daemon/api/handlers/daemon.js

@@ -1 +1 @@
-var i=Object.defineProperty;var s=(e,t)=>i(e,"name",{value:t,configurable:!0});import{toMigrateStateDTO as u}from"../map.js";import{boundDaemonControl as a}from"../../control.js";import{ownerOnly as m}from"../router.js";function c(){const e=a();if(e===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot hand over"};const{graceMs:t}=e.requestHandover();return{status:202,body:{accepted:!0,predecessor_pid:process.pid,predecessor_epoch:e.epoch,grace_ms:t}}}s(c,"handleRestart");async function l(e){if(e.body!==void 0)throw{status:400,code:"invalid_request",message:"admission request must not include a body"};const t=a();if(t===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot admit normal work"};return{status:200,body:await t.admitStartup()}}s(l,"handleAdmit");async function y(e){const t=a();if(t===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot migrate its corpus"};const r=e.body;if(r!==void 0&&(typeof r!="object"||r===null||Array.isArray(r)))throw{status:400,code:"invalid_request",message:"migration request body must be an object"};const o=r??{};if(o.dry_run!==void 0&&typeof o.dry_run!="boolean")throw{status:400,code:"invalid_request",message:"dry_run must be a boolean"};if(o.dirs!==void 0&&(!Array.isArray(o.dirs)||o.dirs.some(d=>typeof d!="string")))throw{status:400,code:"invalid_request",message:"dirs must be an array of strings"};const n=await t.repairMigrations({dryRun:o.dry_run===!0,dirs:o.dirs??[]});return{status:200,body:u(n.result,{resumed:n.resumed,resumeError:n.resumeError})}}s(y,"handleMigrate");const v=m([{method:"POST",pattern:"/v1/daemon/restart",handler:s(e=>c(),"handler")},{method:"POST",pattern:"/v1/daemon/migrate",handler:y},{method:"POST",pattern:"/v1/daemon/admit",handler:l}]);export{v as daemonRoutes};
+var d=Object.defineProperty;var n=(e,t)=>d(e,"name",{value:t,configurable:!0});import{toMigrateStateDTO as i}from"../map.js";import{boundDaemonControl as s}from"../../control.js";import{ownerOnly as u}from"../router.js";function c(){const e=s();if(e===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot hand over"};const{graceMs:t}=e.requestHandover();return{status:202,body:{accepted:!0,predecessor_pid:process.pid,predecessor_epoch:e.epoch,grace_ms:t}}}n(c,"handleRestart");async function m(e){if(e.body!==void 0)throw{status:400,code:"invalid_request",message:"admission request must not include a body"};const t=s();if(t===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot admit normal work"};return{status:200,body:await t.admitStartup()}}n(m,"handleAdmit");async function l(e){const t=s();if(t===null)throw{status:503,code:"daemon_control_unavailable",message:"this API server is not hosted by a live daemon and cannot run the canvas import"};const o=e.body;if(o!==void 0&&(typeof o!="object"||o===null||Array.isArray(o)))throw{status:400,code:"invalid_request",message:"migration request body must be an object"};const r=o??{};if(r.dry_run!==void 0&&typeof r.dry_run!="boolean")throw{status:400,code:"invalid_request",message:"dry_run must be a boolean"};const a=await t.repairMigrations({dryRun:r.dry_run===!0});return{status:200,body:i(a.result,{resumed:a.resumed,resumeError:a.resumeError})}}n(l,"handleMigrate");const v=u([{method:"POST",pattern:"/v1/daemon/restart",handler:n(e=>c(),"handler")},{method:"POST",pattern:"/v1/daemon/migrate",handler:l},{method:"POST",pattern:"/v1/daemon/admit",handler:m}]);export{v as daemonRoutes};

package/dist/daemon/api/handlers/delivery.d.ts

@@ -0,0 +1,2 @@
+import type { RouteTable } from '../router.js';
+export declare const deliveryRoutes: RouteTable;

package/dist/daemon/api/handlers/delivery.js

@@ -0,0 +1 @@
+var v=Object.defineProperty;var d=(e,n)=>v(e,"name",{value:n,configurable:!0});import{ApiError as i}from"../../../api/errors.js";import{openDb as _,withCanvasWrite as j}from"../../../core/canvas/db.js";import{readerForNode as l}from"../../../core/graph/reader.js";import{noteNodeBooting as A}from"../../../core/graph/repo-sync/index.js";import{reposForCwd as f}from"../../../core/graph/repo-sync/repos.js";import{DRY_RUN_ONLY as E,deliver as I,hypotheticalFrom as O,hypotheticalReader as k,inspect as p}from"../../../core/substrate/delivery/deliver.js";import{requireCurrentExecution as h}from"./broker-recovery.js";const N=["boot","system-prompt","compact","persona","file-read","command","pre-command","slash-command","names",...E];function y(e){if(typeof e!="object"||e===null||Array.isArray(e))throw new i(400,"usage","delivery requires a JSON body");const n=e;if(!N.includes(n.activity))throw new i(400,"usage",`invalid delivery activity: ${String(n.activity)}`);if(n.subject!==void 0&&typeof n.subject!="string")throw new i(400,"usage","delivery subject must be a string");return n}d(y,"parse");function m(e){if(e.principal.class!=="person"&&e.principal.class!=="broker")throw new i(403,"permission_error","a delivery dry run is available to a person or a node only")}d(m,"requirePerson");function w(e){const n=_(),r=n.isTransaction;n.exec(r?"SAVEPOINT delivery_dry_run":"BEGIN IMMEDIATE");try{return e(n)}finally{r?n.exec("ROLLBACK TO delivery_dry_run; RELEASE delivery_dry_run"):n.exec("ROLLBACK")}}d(w,"rolledBack");function R(e){if(typeof e!="object"||e===null||Array.isArray(e))throw new i(400,"usage","hypothetical must be an object");const n=d((a,s)=>{if(a!==void 0){if(typeof a!="string"||a==="")throw new i(400,"usage",`hypothetical.${s} must be a non-empty string`);return a}},"str"),r=n(e.cwd,"cwd");if(r!==void 0&&!r.startsWith("/"))throw new i(400,"usage","hypothetical.cwd must be an absolute path");if(e.mode!==void 0&&e.mode!=="base"&&e.mode!=="orchestrator")throw new i(400,"usage","hypothetical.mode must be base or orchestrator");if(e.lifecycle!==void 0&&e.lifecycle!=="terminal"&&e.lifecycle!=="resident")throw new i(400,"usage","hypothetical.lifecycle must be terminal or resident");if(e.has_manager!==void 0&&typeof e.has_manager!="boolean")throw new i(400,"usage","hypothetical.has_manager must be a boolean");if(e.depth!==void 0&&(!Number.isInteger(e.depth)||e.depth<0))throw new i(400,"usage","hypothetical.depth must be a non-negative integer");const t={};r!==void 0&&(t.cwd=r),e.profile!==void 0&&(t.profile=e.profile===null?null:n(e.profile,"profile"));const c=n(e.grantee,"grantee");c!==void 0&&(t.grantee=c);const o=n(e.kind,"kind");return o!==void 0&&(t.kind=o),e.mode!==void 0&&(t.mode=e.mode),e.lifecycle!==void 0&&(t.lifecycle=e.lifecycle),e.has_manager!==void 0&&(t.hasManager=e.has_manager),e.depth!==void 0&&(t.depth=e.depth),t}d(R,"hypotheticalOf");async function T(e){m(e);const n=y(e.body);if(n.node!==void 0&&typeof n.node!="string")throw new i(400,"usage","node must be a node id");const r={activity:n.activity,...n.subject!==void 0?{subject:n.subject}:{}},{result:t,plan:c}=w(o=>{if(n.hypothetical===void 0){if(n.node===void 0)throw new i(400,"usage","a delivery dry run names a node, a hypothetical node, or both");return p(o,l(o,n.node,g=>f(o,g)),r,n.subject_override)}const a=R(n.hypothetical),s=n.node!==void 0?O(n.node,a):{...a,cwd:a.cwd??""};if(s.cwd==="")throw new i(400,"usage","a hypothetical node needs a cwd");const{reader:u,subject:b}=k(o,s);return p(o,u,r,n.subject_override,b)});return{status:200,body:{...t,plan:c}}}d(T,"handleDryRun");async function S(e){const n=e.params.id,r=y(e.body),t={activity:r.activity,...r.subject!==void 0?{subject:r.subject}:{},...r.inherited===!0?{inherited:!0}:{}};if(r.dry_run===!0){m(e);const{result:o,plan:a}=w(s=>p(s,l(s,n,u=>f(s,u)),t,r.subject_override));return{status:200,body:{...o,plan:a}}}if(e.principal.class==="broker"&&e.principal.node!==n)throw new i(403,"permission_error","delivery is performed by the node's own broker");return h(n,r.expected_execution_id),r.activity==="boot"&&(await A(n),h(n,r.expected_execution_id)),{status:200,body:j(o=>I(o,l(o,n,a=>f(o,a)),t))}}d(S,"handleDelivery");const M=[{method:"POST",pattern:"/v1/nodes/:id/delivery",handler:S},{method:"POST",pattern:"/v1/delivery/dry-run",handler:T}];export{M as deliveryRoutes};