@north-light/cli 0.0.0 → 0.3.413

package/dist/core/config.js

@@ -0,0 +1 @@
+var De=Object.defineProperty;var s=(e,n)=>De(e,"name",{value:n,configurable:!0});import{envProfileId as Ue}from"../shared/env.js";import{basename as X,join as Q}from"node:path";import{existsSync as Ke,mkdirSync as qe,statSync as Ge}from"node:fs";import{isDeepStrictEqual as Be}from"node:util";import{CONFIG_FILE as We,STATE_FILE as He,CONDENSED_HISTORY_MODES as Je,MOUSE_MODE_DEFAULTS as Ze,WHIP_MESSAGE_MODES as Ye,DEFAULT_WHIP_MESSAGES as ee,defaultScopeConfig as k,defaultScopeState as ne,defaultModelLaddersConfig as Ve,defaultKindsConfig as Xe,defaultRemoteCanvasConfig as Qe}from"../types.js";import{BINDING_CATALOG as en,BINDING_IDS as nn,isAttachPaneBinding as on}from"./keybindings/catalog.js";import{notFound as tn}from"./errors.js";import{emitEvent as rn}from"./events/emit.js";import{atomicWriteJson as oe,readJsonIfExists as K,ensureDir as sn}from"./fs-utils.js";import{scopeRoot as y,requireScopeRoot as w,findProjectScopeRoots as cn,userScopeRoot as E}from"./scope.js";import{listInstalledPluginsInRoot as te}from"./installed-plugins.js";import{profileMemoryDir as q,listProfiles as re}from"./profiles/manifest.js";import{canonicalRoot as A,projectStore as un,userStore as ie}from"./scoped-state/paths.js";import{convertLegacyScopedStore as dn,initializeFreshScopedStore as fn}from"./scoped-state/migrate.js";import{mutateRawSettings as ln,readBookkeeping as an,readRawSettings as mn,readRawSettingsWithRevision as pn,replaceRawSettings as gn,writeBookkeeping as yn,writeRawSettings as hn}from"./scoped-state/settings.js";import{withExclusiveDirectoryLock as bn}from"./exclusive-lock.js";import{SCOPE_CONFIG_KEYS as _n}from"./user-settings.js";import{normalizeWorkingGerunds as vn}from"../shared/working-activity.js";import{mergePageComponentLayers as kn,normalizePageComponents as se}from"./human/page-catalog.js";function b(e){return Q(e,We)}s(b,"configPathFor");function ce(e,n){return bn(`${e}.lock`,()=>n(e),{timeoutError:s(()=>new Error(`timed out waiting for config lock: ${e}`),"timeoutError")})}s(ce,"withConfigPathLock");function wn(e){return Q(e,He)}s(wn,"statePathFor");function bo(e){const n=y(e);return n?b(n):null}s(bo,"configPath");function _o(e){const n=y(e);return n?wn(n):null}s(_o,"statePath");function g(e){const n=A(e),o=A(E());if(n===o)return{store:ie(o),key:"user",kind:"user",root:o};if(X(n)===".crouter")return dn({kind:"project",root:n}),{store:un(n),key:"project",kind:"project",root:n};for(const t of re()){const r=A(q(t.profileId));if(n===r)return{store:ie(o),key:`profile:${t.profileId}`,kind:"profile",root:r,profileId:t.profileId}}throw new Error(`settings root is not a recognized owner: ${e}`)}s(g,"settingsOwnerForRoot");function I(e){if(X(e)===".crouter"){let n;try{n=A(e)}catch(o){if(o.code==="ENOENT")return null;throw o}if(n!==A(E()))return K(b(e))}return mn(g(e))}s(I,"readRawAtRoot");function G(e,n){const o=g(e);if(o.kind==="project"){ce(b(o.root),t=>oe(t,n,{createParent:!1}));return}hn(o,n)}s(G,"writeRawAtRoot");function S(e,n){const o=g(e);return o.kind==="project"?ce(b(o.root),t=>{const r=n(K(t)??{});return oe(t,r.next,{createParent:!1}),r.value}):ln(o,t=>n(t))}s(S,"mutateRawAtRoot");const P=globalThis,T=Symbol.for("crtr.broker.config-snapshot");function vo(e){P[T]=e}s(vo,"installBrokerConfigSnapshot");function ko(){return P[T]}s(ko,"brokerConfigSnapshot");function An(e){const n=P[T];if(n){if(e!=="user")throw new Error(`broker config snapshot has no ${e} scope`);return n.user}const o=y(e);return o?Sn(o):k()}s(An,"readConfig");function Sn(e){const n=I(e);return n?z(n):k()}s(Sn,"readConfigAtRoot");function jn(e){const n=y(e);if(!n)return ne();try{return an(g(n))}catch(o){if(e==="project"&&!Ke(n))return ne();throw o}}s(jn,"readState");class Rn extends Error{static{s(this,"InvalidRawSettingsError")}constructor(n){super(`settings cannot be merged: ${n instanceof Error?n.message:String(n)}`),this.name="InvalidRawSettingsError"}}function ue(e){if(e.scope==="user")return g(E());if(!re().some(n=>n.profileId===e.profileId))throw tn(`profile not found: ${e.profileId}`,{received:e.profileId,next:"Run `crtr profile list` to see available profiles."});return g(q(e.profileId))}s(ue,"rawSettingsOwnerForTarget");function wo(e){return pn(ue(e))}s(wo,"readRawSettingsForTarget");function Ao(e,n,o){return gn(ue(e),n,o,t=>{try{z(t)}catch(r){throw new Rn(r)}})}s(Ao,"replaceRawSettingsForTarget");function So(e,n){const o=w(e);return S(o,t=>{const r=n(t);return{value:r,next:r}})}s(So,"updateRawConfigAtomically");function jo(e,n){G(w(e),n)}s(jo,"writeConfig");function Ro(e,n){G(w(e),n)}s(Ro,"writeRawConfig");function xn(e,n){const o=w(e);yn(g(o),n)}s(xn,"writeState");function xo(e,n){if(e==="project")try{qe(n)}catch(t){if(t.code!=="EEXIST"||!Ge(n).isDirectory())throw t}else sn(n);const o=g(e==="user"?E():n);fn({kind:o.kind==="user"?"user":"project",root:o.store.root}),o.kind==="project"&&K(b(o.root))===null&&G(o.root,{schema_version:k().schema_version})}s(xo,"ensureScopeInitialized");function On(e){if(e===null||typeof e!="object"||Array.isArray(e))return{};const n={};for(const[o,t]of Object.entries(e))Array.isArray(t)&&t.every(r=>typeof r=="string")&&(n[o]=[...t]);return n}s(On,"normalizeKeybindings");const En=new Set(en.filter(on).map(e=>e.id));function In(e){return Array.isArray(e)?[...new Set(e.filter(n=>typeof n=="string"&&nn.has(n)&&En.has(n)))]:[]}s(In,"normalizeTmuxPassthrough");function C(e,n=Ve()){const o=n;if(e===null||typeof e!="object")return o;const t=e,r={anthropic:{...o.anthropic},openai:{...o.openai},...o.defaultProvider!==void 0?{defaultProvider:o.defaultProvider}:{}};(t.defaultProvider==="anthropic"||t.defaultProvider==="openai")&&(r.defaultProvider=t.defaultProvider);for(const i of["anthropic","openai"]){const c=t[i];if(!(c===null||typeof c!="object"))for(const[u,d]of Object.entries(c))(u==="ultra"||u==="strong"||u==="medium"||u==="light")&&typeof d=="string"&&(r[i][u]=d)}return r}s(C,"mergeModelLadders");function de(e){return e==="ultra"||e==="strong"||e==="medium"||e==="light"}s(de,"validStrength");const B=["ultra","strong","medium","light"];function W(){return Object.create(null)}s(W,"routeRecord");function j(e,n,o){Object.defineProperty(e,n,{value:o,writable:!0,enumerable:!0,configurable:!0})}s(j,"setRouteRecord");function fe(e){const n=W();for(const[o,t]of Object.entries(e??{}))j(n,o,t);return n}s(fe,"copyRouteRecord");function R(e,n){rn({level:"warn",event:"config.model_routes.invalid",fields:{route_id:e,rule:n}})}s(R,"routeInvalid");function $(e,n={}){const o=fe(n);if(e===null||typeof e!="object"||Array.isArray(e))return o;for(const[t,r]of Object.entries(e)){if(t.trim()===""){R(t,"route id must be a non-empty string");continue}if(r===null||typeof r!="object"||Array.isArray(r)){R(t,"route must be an object");continue}const i=r,c=o[t],u={...c};let d;for(const l of["family","credentialSource","providerId"]){const f=i[l];if(f!==void 0){if(typeof f!="string"||f.trim()===""){d=`${l} must be a non-empty string`;break}u[l]=f}}if(d===void 0&&i.models!==void 0)if(i.models===null||typeof i.models!="object"||Array.isArray(i.models))d="models must be an object";else{const l={...c?.models};for(const[f,a]of Object.entries(i.models)){if(!de(f)){d=`models.${f} is not a model strength`;break}if(typeof a!="string"||a.trim()===""){d=`models.${f} must be a non-empty provider/id ref`;break}const m=a.indexOf("/");if(m<=0||m===a.length-1){d=`models.${f} must be provider/id`;break}l[f]=a}u.models=l}if(d===void 0&&u.models!==void 0&&u.providerId!==void 0){for(const[l,f]of Object.entries(u.models))if(f.slice(0,f.indexOf("/"))!==u.providerId){d=`models.${l} provider prefix must equal providerId`;break}}if(d!==void 0){R(t,d);continue}j(o,t,u)}return o}s($,"mergeModelRoutePatches");function le(e){const n=W(),o=W();for(const[t,r]of Object.entries(e)){if(r.family===void 0||r.credentialSource===void 0||r.providerId===void 0||r.models===void 0){R(t,"route must include family, credentialSource, providerId, and models");continue}const i=B.filter(c=>r.models[c]===void 0);if(i.length>0){R(t,`incomplete route; missing strengths: ${i.join(", ")}`),j(o,t,{family:r.family,credentialSource:r.credentialSource,providerId:r.providerId,models:r.models});continue}j(n,t,{family:r.family,credentialSource:r.credentialSource,providerId:r.providerId,models:r.models})}return{complete:n,legacy:o}}s(le,"resolveModelRoutes");function Pn(e,n){if(e.trim()==="")throw new Error("model route id must be a non-empty string");for(const t of["family","credentialSource","providerId"])if(typeof n[t]!="string"||n[t].trim()==="")throw new Error(`model route "${e}" ${t} must be a non-empty string`);const o=B.filter(t=>n.models?.[t]===void 0);if(o.length>0)throw new Error(`model route "${e}" is incomplete; missing strengths: ${o.join(", ")}`);for(const t of B){const r=n.models[t];if(typeof r!="string"||r.trim()==="")throw new Error(`model route "${e}" models.${t} must be a non-empty provider/id ref`);const i=r.indexOf("/");if(i<=0||i===r.length-1)throw new Error(`model route "${e}" models.${t} must be provider/id`);if(r.slice(0,i)!==n.providerId)throw new Error(`model route "${e}" models.${t} provider prefix must equal providerId`)}}s(Pn,"assertCompleteModelRoute");function M(e,n){if(e===void 0||e===null||typeof e!="object"||Array.isArray(e))return n;const o=e,t=s(i=>Array.isArray(i)&&i.every(c=>typeof c=="string"&&c.trim()!=="")?[...i]:void 0,"strings"),r=Array.isArray(o.strengthFallback)&&o.strengthFallback.every(i=>de(i))?[...o.strengthFallback]:void 0;return{...t(o.credentialSourceOrder)!==void 0?{credentialSourceOrder:t(o.credentialSourceOrder)}:{},...t(o.familyOrder)!==void 0?{familyOrder:t(o.familyOrder)}:{},...r!==void 0?{strengthFallback:r}:{}}}s(M,"mergeModelRouting");function Tn(e){return e!==""&&e.replace(/\*/g,"")===""}s(Tn,"isInheritAllGlob");function N(e,n=[]){const o=e,t=Array.isArray(o?.allow)?o.allow.filter(r=>typeof r=="string"):[];for(const r of t)if(Tn(r))throw new Error(`spawnEnv.allow: "${r}" matches every env var name (inherit-all) \u2014 this is exactly the leak the spawn-env boundary closes. Name the specific vars/prefixes you actually need instead (e.g. "AWS_*", "GIT_ASKPASS").`);return{allow:[...new Set([...n,...t])]}}s(N,"mergeSpawnEnv");function L(e,n={}){const o={};for(const[t,r]of Object.entries(n))o[t]={...r};if(e!==null&&typeof e=="object")for(const[t,r]of Object.entries(e)){if(r===null||typeof r!="object")continue;const i={...o[t]},c=r.fastMode;typeof c=="boolean"&&(i.fastMode=c),o[t]=i}return o}s(L,"mergeProviderOptions");const ae=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/,Cn=new Set(["crtr","crtrd"]);function F(e,n){if(n==="bin"&&Cn.has(e))return`${n}.${e} is reserved by crouter \u2014 pick another bare command name`;if(!ae.test(e))return`${n}.${e} is not a safe bare command name (expected ${ae.source})`}s(F,"bareCommandNameIssue");function $n(e){if(e===null||typeof e!="object"||Array.isArray(e))return[{name:"bin",message:"bin must be a JSON object mapping bare command name to a relative path"}];const n=[];for(const[o,t]of Object.entries(e)){const r=F(o,"bin");r!==void 0&&n.push({name:o,message:r}),(typeof t!="string"||t.trim()==="")&&n.push({name:o,message:`bin.${o} must be a non-empty relative path to an executable inside the contributor root`})}return n}s($n,"binDeclarationIssues");function Mn(e){if(e===null||typeof e!="object"||Array.isArray(e))return{};const n={};for(const[o,t]of Object.entries(e))F(o,"bin")===void 0&&(typeof t!="string"||t.trim()===""||(n[o]=t));return n}s(Mn,"normalizeBin");const me=/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;function Nn(e){if(e===null||typeof e!="object"||Array.isArray(e))return[{name:"humanActions",reason:"humanActions must be a JSON object mapping action names to {argv, cwd}",block:!0}];const n=[];for(const[o,t]of Object.entries(e)){const r=[];if(me.test(o)||r.push(`action name must match ${me.source}`),t===null||typeof t!="object"||Array.isArray(t))r.push("action must be an object with argv and cwd");else{const i=t,c=Object.keys(i).filter(u=>u!=="argv"&&u!=="cwd");c.length>0&&r.push(`action has unsupported field${c.length===1?"":"s"}: ${c.join(", ")}`),(!Array.isArray(i.argv)||i.argv.length===0||!i.argv.every(u=>typeof u=="string"&&u.length>0))&&r.push("argv must be a non-empty array of non-empty strings"),(typeof i.cwd!="string"||i.cwd.length===0)&&r.push("cwd is required and must be a non-empty string")}r.length>0&&n.push({name:o,reason:r.join("; ")})}return n}s(Nn,"humanActionDeclarationIssues");function Ln(e){if(e===null||typeof e!="object"||Array.isArray(e))return{};const n=new Set(Nn(e).map(t=>t.name)),o={};for(const[t,r]of Object.entries(e)){if(n.has(t))continue;const i=r;o[t]={argv:[...i.argv],cwd:i.cwd}}return o}s(Ln,"normalizeHumanActions");function Oo(e){return $n(e).map(n=>n.message)}s(Oo,"invalidPluginBinReasons");function Eo(e){if(e===null||typeof e!="object"||Array.isArray(e))return{};const n={};for(const[o,t]of Object.entries(e))F(o,"requires")===void 0&&(typeof t!="string"||t.trim()===""||/[\r\n]/.test(t)||(n[o]=t));return n}s(Eo,"normalizeRequires");function Io(e){if(e===null||typeof e!="object"||Array.isArray(e))return["requires must be a JSON object mapping a bare executable name to a one-line install hint"];const n=[];for(const[o,t]of Object.entries(e)){const r=F(o,"requires");r!==void 0&&n.push(r),typeof t!="string"||t.trim()===""?n.push(`requires.${o} must be a non-empty one-line install hint`):/[\r\n]/.test(t)&&n.push(`requires.${o} must be a one-line install hint`)}return n}s(Io,"invalidPluginRequiresReasons");function pe(e){if(e===null||typeof e!="object")return null;const n=e,o={};typeof n.whenToUse=="string"&&n.whenToUse.trim()!==""&&(o.whenToUse=n.whenToUse),typeof n.model=="string"&&n.model.trim()!==""&&(o.model=n.model),typeof n.orchestratorModel=="string"&&n.orchestratorModel.trim()!==""&&(o.orchestratorModel=n.orchestratorModel);const t=s(r=>Array.isArray(r)&&r.every(i=>typeof i=="string"),"isStringArray");return t(n.tools)&&(o.tools=n.tools),t(n.extensions)&&(o.extensions=n.extensions),t(n.availableTo)&&(o.availableTo=n.availableTo),Object.keys(o).length>0?o:null}s(pe,"normalizeKindFields");function x(e,n=Xe()){const o={...n};if(e!==null&&typeof e=="object")for(const[t,r]of Object.entries(e)){const i=pe(r);if(i===null)continue;const c=o[t];c!==void 0?o[t]={...c,...i}:i.whenToUse!==void 0&&(o[t]=i)}return o}s(x,"mergeKinds");function ge(e,n,o){if(n===null)return o;const t=te(e,n).filter(i=>i.enabled&&i.manifest.kinds!==void 0).sort((i,c)=>i.name.localeCompare(c.name));let r=o;for(const i of t)r=x(i.manifest.kinds,r);return r}s(ge,"layerPluginKinds");function Po(){const e=[{origin:"config.json",components:An("user").page_components}],n=y("user");if(n!==null){const o=te("user",n).filter(t=>t.enabled&&t.manifest.page_components!==void 0).sort((t,r)=>t.name.localeCompare(r.name));for(const t of o){const r=`plugin "${t.name}" page_components`;e.push({origin:`plugin "${t.name}"`,components:se(t.manifest.page_components,r)})}}return kn(e)}s(Po,"resolvePageComponents");const H=new Set(["whenToUse","model","orchestratorModel","tools","extensions","availableTo"]);function To(e){if(e===null||typeof e!="object"||Array.isArray(e))return["kinds must be a JSON object keyed by kind name"];const n=[],o=s(t=>Array.isArray(t)&&t.every(r=>typeof r=="string"),"isStringArray");for(const[t,r]of Object.entries(e)){if(t.trim()===""){n.push("kinds contains an empty kind name");continue}if(r===null||typeof r!="object"||Array.isArray(r)){n.push(`kinds.${t} must be a JSON object`);continue}const i=r;for(const c of Object.keys(i))H.has(c)||n.push(`kinds.${t}.${c} is not a KindConfig field (expected one of: ${[...H].join(", ")})`);i.whenToUse!==void 0&&(typeof i.whenToUse!="string"||i.whenToUse.trim()==="")&&n.push(`kinds.${t}.whenToUse must be a non-empty string`);for(const c of["model","orchestratorModel"])i[c]!==void 0&&(typeof i[c]!="string"||i[c].trim()==="")&&n.push(`kinds.${t}.${c} must be a non-empty string`);for(const c of["tools","extensions","availableTo"])i[c]!==void 0&&!o(i[c])&&n.push(`kinds.${t}.${c} must be an array of strings`);pe(r)===null&&n.push(`kinds.${t} has no valid KindConfig field \u2014 an entry must set at least one of: ${[...H].join(", ")} (whenToUse is required when the kind exists in no lower layer)`)}return n}s(To,"invalidPluginKindsReasons");function Fn(e){if(e===null||typeof e!="object")return null;const n=e;if(typeof n.previewEndpoint!="string"||n.previewEndpoint.trim()===""||typeof n.relayTokenRef!="string"||n.relayTokenRef.trim()==="")return null;const o={previewEndpoint:n.previewEndpoint,relayTokenRef:n.relayTokenRef};return typeof n.cpOrigin=="string"&&n.cpOrigin.trim()!==""&&(o.cpOrigin=n.cpOrigin),o}s(Fn,"normalizeRemoteCanvasTarget");function zn(e,n=Qe()){const o={...n.targets};if(e!==null&&typeof e=="object"){const t=e;if(t.targets!==null&&typeof t.targets=="object")for(const[r,i]of Object.entries(t.targets)){const c=Fn(i);c!==null&&(o[r]=c)}}return{targets:o}}s(zn,"mergeRemoteCanvas");function ye(e,n){return e===!0?"notify":e===!1?!1:e==="notify"||e==="apply"?e:n}s(ye,"normalizeMode");function O(e,n){return typeof e=="number"&&Number.isSafeInteger(e)&&e>=1?e:n}s(O,"normalizePositiveInteger");function Dn(e,n){const o=e!==null&&typeof e=="object"?e:{},t=O(o.warning,n.warning),r=O(o.automaticReviveCap,n.automaticReviveCap);return t<=r?{warning:t,automaticReviveCap:r}:{...n}}s(Dn,"mergeBrokerThresholds");function Un(e,n){return{unattendedParkMs:O((e!==null&&typeof e=="object"?e:{}).unattendedParkMs,n.unattendedParkMs)}}s(Un,"mergeLifecycle");function Kn(e){if(!Array.isArray(e))return[...ee];const n=e.filter(o=>typeof o=="string"&&o.trim()!=="").map(o=>o.trim());return n.length>0?n:[...ee]}s(Kn,"normalizeWhipMessages");function qn(e,n){if(e===null||typeof e!="object")return{...n};const o=e.tcp;return{tcp:typeof o=="string"?o:n.tcp}}s(qn,"mergeApi");function z(e){const n=k(),o=n.schema_version,t=e.marketplaces===void 0?{}:e.marketplaces,r=e.plugins===void 0?{}:e.plugins,i=e.auto_update,c=i&&typeof i.interval_hours=="number"?i.interval_hours:void 0,u=c!==void 0&&Number.isFinite(c)&&c>=0?c:n.auto_update.interval_hours,d={crtr:ye(i?.crtr,n.auto_update.crtr),content:ye(i?.content,n.auto_update.content),interval_hours:u},l=e.max_panes_per_window,f=O(l,n.max_panes_per_window),a=typeof e.auto_open_child_viewers=="boolean"?e.auto_open_child_viewers:n.auto_open_child_viewers,m=Dn(e.brokerThresholds,n.brokerThresholds),h=Un(e.lifecycle,n.lifecycle),D=typeof e.completion_bell=="boolean"?e.completion_bell:n.completion_bell,p=e.working_gerunds===void 0?[...n.working_gerunds]:vn(e.working_gerunds),be=typeof e.whip_mode=="boolean"?e.whip_mode:n.whip_mode,_e=se(e.page_components),ve=typeof e.page_surface=="boolean"?e.page_surface:n.page_surface,ke=Kn(e.whip_messages),we=Ye.includes(e.whip_message_mode)?e.whip_message_mode:n.whip_message_mode,Ae=Ze.includes(e.mouse_mode_default)?e.mouse_mode_default:n.mouse_mode_default,Se=O(e.live_cycles,n.live_cycles),je=Je.includes(e.condensed_history)?e.condensed_history:n.condensed_history,Re=typeof e.bash_tool_purpose=="boolean"?e.bash_tool_purpose:n.bash_tool_purpose,xe=typeof e.fold_finished_tools=="boolean"?e.fold_finished_tools:n.fold_finished_tools,Oe=typeof e.summarize_tool_calls=="boolean"?e.summarize_tool_calls:n.summarize_tool_calls,Ee=typeof e.detailed_tool_recaps=="boolean"?e.detailed_tool_recaps:n.detailed_tool_recaps,Ie=On(e.keybindings),Pe=In(e.tmux_passthrough),Te=C(e.modelLadders),Ce=L(e.providerOptions,n.providerOptions),U=le($(e.modelRoutes)),J=U.complete,Z=M(e.modelRouting,void 0),$e=x(e.kinds),Me=zn(e.remoteCanvas),Ne=qn(e.api,n.api),_=e.paths;if(_?.user_files!==void 0&&(typeof _.user_files!="string"||!_.user_files.startsWith("/")))throw new Error("paths.user_files must be an absolute path");const Y=e.store,v=e.runtime;if(v?.person_uids!==void 0&&(!Array.isArray(v.person_uids)||!v.person_uids.every(V=>Number.isSafeInteger(V)&&V>=0)))throw new Error("runtime.person_uids must be an array of nonnegative integer uids");const Le=N(e.spawnEnv,n.spawnEnv?.allow),Fe=Mn(e.bin),ze=Ln(e.humanActions);return{bin:Fe,humanActions:ze,schema_version:o,marketplaces:t,plugins:r,auto_update:d,max_panes_per_window:f,auto_open_child_viewers:a,brokerThresholds:m,lifecycle:h,completion_bell:D,working_gerunds:p,whip_mode:be,page_components:_e,page_surface:ve,whip_messages:ke,whip_message_mode:we,mouse_mode_default:Ae,live_cycles:Se,condensed_history:je,bash_tool_purpose:Re,fold_finished_tools:xe,summarize_tool_calls:Oe,detailed_tool_recaps:Ee,keybindings:Ie,tmux_passthrough:Pe,modelLadders:Te,providerOptions:Ce,...Object.keys(J).length>0?{modelRoutes:J}:{},...Object.keys(U.legacy).length>0?{legacyModelRoutes:U.legacy}:{},...Z!==void 0?{modelRouting:Z}:{},kinds:$e,remoteCanvas:Me,api:Ne,..._?{paths:_}:{},...Y?{store:Y}:{},...v?{runtime:v}:{},spawnEnv:Le}}s(z,"mergeConfig");function Gn(e){return I(e)}s(Gn,"readRawConfigAtRoot");function Bn(e){const n=y(e);return n?Gn(n):null}s(Bn,"readRawScopeConfig");function Wn(e){if(e===null||e==="")return null;try{return I(q(e))}catch{return null}}s(Wn,"readRawProfileConfig");function Hn(e,n){return[...cn(e,n)].reverse().map(r=>({root:r,raw:I(r)}))}s(Hn,"readRawProjectScopeConfigs");function he(e=process.cwd(),n=Ue()||null){const o=P[T];if(o)return o.launch;const t=k(),r=Bn("user"),i=Wn(n),c=Hn(e,n);let u=x(r?.kinds,ge("user",y("user"),t.kinds)),d=C(r?.modelLadders,t.modelLadders),l=L(r?.providerOptions,t.providerOptions),f=$(r?.modelRoutes),a=M(r?.modelRouting,void 0),m=N(r?.spawnEnv,t.spawnEnv?.allow);i!==null&&(u=x(i.kinds,u),d=C(i.modelLadders,d),l=L(i.providerOptions,l),f=$(i.modelRoutes,f),a=M(i.modelRouting,a),m=N(i.spawnEnv,m.allow));for(const{root:D,raw:p}of c)u=x(p?.kinds,ge("project",D,u)),p!==null&&(d=C(p.modelLadders,d),l=L(p.providerOptions,l),f=$(p.modelRoutes,f),a=M(p.modelRouting,a),m=N(p.spawnEnv,m.allow));const h=le(f);return{kinds:u,modelLadders:d,providerOptions:l,...Object.keys(h.complete).length>0?{modelRoutes:h.complete}:{},...Object.keys(h.legacy).length>0?{legacyModelRoutes:h.legacy}:{},...a!==void 0?{modelRouting:a}:{},spawnEnv:m}}s(he,"readMergedLaunchConfig");function Co(e){return he().kinds[e]}s(Co,"resolveKindConfig");function $o(e){const n=he().kinds,o=[];for(const[t,r]of Object.entries(n)){const i=t.indexOf("/");if(i===-1)continue;const c=t.slice(0,i),u=r.availableTo??[c];(u.includes("*")||u.includes(e))&&o.push({kind:t,whenToUse:r.whenToUse})}return o.sort((t,r)=>t.kind.localeCompare(r.kind))}s($o,"subKindsAvailableTo");function Jn(e,n,o){const t={...e??{}};t.anthropic!==void 0&&(t.anthropic={...t.anthropic}),t.openai!==void 0&&(t.openai={...t.openai}),o.defaultProvider!==n.defaultProvider&&o.defaultProvider!==void 0&&(t.defaultProvider=o.defaultProvider);for(const i of["anthropic","openai"])for(const c of["ultra","strong","medium","light"])o[i][c]!==n[i][c]&&(t[i]={...t[i]??{},[c]:o[i][c]});return t.defaultProvider!==void 0||t.anthropic!==void 0||t.openai!==void 0?t:void 0}s(Jn,"sparseModelLaddersToPersist");function Zn(e,n){return S(e,o=>{const t=z(o),r=z(o);n(r);const i={...o};for(const u of _n)u!=="modelLadders"&&!Be(r[u],t[u])&&(i[u]=r[u]);const c=Jn(o.modelLadders,t.modelLadders,r.modelLadders);return c!==void 0?i.modelLadders=c:delete i.modelLadders,{value:r,next:i}})}s(Zn,"mutateConfigAtRoot");function Mo(e,n){S(e,o=>{const t=o.modelLadders??{},r={...t};n.defaultProvider!==void 0&&(r.defaultProvider=n.defaultProvider);for(const i of["anthropic","openai"])n[i]!==void 0&&(r[i]={...t[i]??{},...n[i]});return{value:void 0,next:{...o,modelLadders:r}}})}s(Mo,"persistModelLadders");function No(e,n,o){if(o!==void 0)Pn(n,o);else if(n.trim()==="")throw new Error("model route id must be a non-empty string");S(e,t=>{const r=fe(t.modelRoutes??{});o===void 0?delete r[n]:j(r,n,{...o,models:{...o.models}});const i={...t};return Object.keys(r).length===0?delete i.modelRoutes:i.modelRoutes=r,{value:void 0,next:i}})}s(No,"persistModelRoute");function Yn(e,n){return Zn(e,n)}s(Yn,"updateConfigAtRoot");function Lo(e,n){return Yn(w(e),n)}s(Lo,"updateConfig");function Fo(e){const n=e.orchestrator===!0?"orchestratorModel":"model";return S(e.root,o=>{const t={...o.kinds??{},[e.kind]:{...(o.kinds??{})[e.kind],[n]:e.model}};return{value:void 0,next:{...o,kinds:t}}}),{path:b(e.root),field:n}}s(Fo,"persistDefaultKindModel");function zo(e,n){const o=jn(e);return n(o),xn(e,o),o}s(zo,"updateState");export{Rn as InvalidRawSettingsError,$n as binDeclarationIssues,ko as brokerConfigSnapshot,bo as configPath,xo as ensureScopeInitialized,Nn as humanActionDeclarationIssues,vo as installBrokerConfigSnapshot,Oo as invalidPluginBinReasons,To as invalidPluginKindsReasons,Io as invalidPluginRequiresReasons,Mn as normalizeBin,Ln as normalizeHumanActions,Eo as normalizeRequires,In as normalizeTmuxPassthrough,Fo as persistDefaultKindModel,Mo as persistModelLadders,No as persistModelRoute,An as readConfig,Sn as readConfigAtRoot,he as readMergedLaunchConfig,Gn as readRawConfigAtRoot,Bn as readRawScopeConfig,wo as readRawSettingsForTarget,jn as readState,Ao as replaceRawSettingsForTarget,Co as resolveKindConfig,Po as resolvePageComponents,_o as statePath,$o as subKindsAvailableTo,Lo as updateConfig,Yn as updateConfigAtRoot,So as updateRawConfigAtomically,zo as updateState,jo as writeConfig,Ro as writeRawConfig,xn as writeState};

package/dist/core/conversation-store/client-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/conversation-store/client-worker.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(e,n)=>c(e,"name",{value:n,configurable:!0});import{parentPort as g,workerData as y}from"node:worker_threads";import{request as m}from"node:http";import{request as b}from"node:https";g?.on("message",e=>{const{address:n,token:d}=y,s=n.startsWith("http")?new URL(e.path,n):null,p=e.data===void 0?void 0:JSON.stringify(e.data),f=i(t=>{const u=[];t.on("data",a=>u.push(a)),t.on("aborted",()=>r({error:"conversation store response ended before completion"})),t.on("error",a=>r({error:a.message})),t.on("end",()=>r({status:t.statusCode,body:Buffer.concat(u).toString("utf8"),path:t.headers["x-conversation-path"],tail:t.headers["x-conversation-tail"]}))},"onResponse"),o=s?(s.protocol==="https:"?b:m)(s,{method:e.method},f):m({socketPath:n,path:e.path,method:e.method},f);let h=!1;function r(t){h||(h=!0,e.reply.postMessage(t),e.signal&&(Atomics.store(new Int32Array(e.signal),0,1),Atomics.notify(new Int32Array(e.signal),0)),e.reply.close())}i(r,"finish"),e.reply.on("message",t=>{t==="cancel"&&o.destroy()}),o.once("error",t=>r({error:t.message})),d&&o.setHeader("authorization",`Bearer ${d}`),p!==void 0?(o.setHeader("content-type","application/json"),o.end(p)):o.end()});

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

@@ -0,0 +1,2 @@
+import type { ConversationStore } from './index.js';
+export declare function createStoreClient(address: string, token?: string): ConversationStore;

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

@@ -0,0 +1,2 @@
+var k=Object.defineProperty;var s=(l,w)=>k(l,"name",{value:w,configurable:!0});import{MessageChannel as E,Worker as S,receiveMessageOnPort as b}from"node:worker_threads";import{ConversationNotFoundError as g}from"./index.js";function N(l,w){const u=new S(new URL(import.meta.url.endsWith(".ts")?"./client-worker.ts":"./client-worker.js",import.meta.url),{workerData:{address:l,token:w}});u.unref();let c;u.on("error",e=>{c=e}),u.on("exit",e=>{c=new Error(`conversation store worker exited with ${e}`)});function m(e,r,t){if(!t)throw new Error("conversation store worker returned no reply");if(t.error)throw new Error(t.error);if(t.status===404)throw new g(r.split("/")[2]??r);if(!t.status||t.status>=400)throw new Error(`conversation store ${e} ${r} failed (${t.status}): ${t.body}`);return{body:t.body??"",...t.path?{path:t.path}:{},...t.tail?{tail:Number(t.tail)}:{}}}s(m,"settle");function n(e,r,t){if(c)throw c;const o=new SharedArrayBuffer(4),{port1:i,port2:d}=new E;try{if(u.postMessage({method:e,path:r,data:t,signal:o,reply:d},[d]),Atomics.wait(new Int32Array(o),0,0,3e4)==="timed-out")throw i.postMessage("cancel"),new Error(`conversation store request timed out: ${e} ${r}`);return m(e,r,b(i)?.message)}finally{i.close()}}s(n,"call");function p(e,r){if(c)return Promise.reject(c);const{port1:t,port2:o}=new E;return new Promise((i,d)=>{const f=setTimeout(()=>{t.postMessage("cancel"),t.close(),d(new Error(`conversation store request timed out: ${e} ${r}`))},3e4);f.unref(),t.once("message",v=>{clearTimeout(f),t.close();try{i(m(e,r,v))}catch(T){d(T)}}),u.postMessage({method:e,path:r,reply:o},[o])})}s(p,"callAsync");const a=s(e=>`/conversations/${encodeURIComponent(e)}`,"url"),$=s(e=>{const[r,...t]=e.body.trimEnd().split(`
+`).map(i=>JSON.parse(i)),o=t;return e.tail===void 0?{header:r,entries:o,path:e.path??""}:{header:r,entries:o.slice(0,e.tail-1),tail:o.slice(e.tail-1),path:e.path??""}},"parseRead"),h=s((e,r)=>r?`${a(e)}?head=${r.head}&tail=${r.tail}`:a(e),"readPath");return{create(e,r,t,o){return JSON.parse(n("POST","/conversations",{node_id:e,header:r,entries:t,path:o}).body).conversation_id},append(e,r){n("POST",`${a(e)}/entries`,{entries:r})},replace(e,r,t){n("PUT",a(e),{header:r,entries:t})},read(e,r){return $(n("GET",h(e,r)))},async readAsync(e,r){return $(await p("GET",h(e,r)))},header(e){return JSON.parse(n("GET",`${a(e)}/header`).body)},fork(e,r,t,o){return JSON.parse(n("POST",`${a(e)}/fork`,{node_id:r,leaf_id:t,cwd:o}).body).conversation_id},list(e){const r=e===void 0?"":`?node_id=${encodeURIComponent(e)}`;return JSON.parse(n("GET",`/conversations${r}`).body).conversations},delete(e){n("DELETE",a(e))}}}s(N,"createStoreClient");export{N as createStoreClient};

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

@@ -0,0 +1,37 @@
+import { type SessionEntry, type SessionHeader } from '@earendil-works/pi-coding-agent';
+import { type ConversationStore } from './index.js';
+/** What one write does to a conversation. A create names its node; an append or replace
+ *  goes to the conversation's current owner. */
+export type ConversationWrite = {
+    kind: 'create';
+    nodeId: string;
+    path: string;
+    sourceId?: string;
+    entries: SessionEntry[];
+} | {
+    kind: 'append';
+    entries: SessionEntry[];
+} | {
+    kind: 'replace';
+};
+/** One coherent write: the canvas step, `write()` (returns the new file size), then commit. */
+export type AppendSection = (conversationId: string, change: ConversationWrite, write: () => number) => void;
+/** The canvas side of the store: the write section, and each conversation's current owner. */
+export interface ConversationCanvas {
+    appendSection: AppendSection;
+    owners(): Map<string, string>;
+    createPath?(nodeId: string, header: SessionHeader): string;
+    pathFor?(id: string): string | undefined;
+    repair?(id: string, path: string): void;
+    abortCreate?(id: string): void;
+    delete?(id: string): void;
+}
+export declare function sessionDirectory(root: string, cwd: string): string;
+export declare function createFileStore(root: string, canvas: ConversationCanvas): ConversationStore & {
+    recover(rows: Array<{
+        session_id: string;
+        node_id: string;
+        transcript_path: string | null;
+    }>): void;
+    repair(id: string): void;
+};

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

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

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

@@ -0,0 +1,60 @@
+import type { SessionEntry, SessionHeader } from '@earendil-works/pi-coding-agent';
+export type { SessionEntry, SessionHeader };
+export declare class ConversationNotFoundError extends Error {
+    readonly code = "not_found";
+    constructor(id: string);
+}
+export declare function isConversationNotFound(error: unknown): boolean;
+export interface ConversationInfo {
+    conversation_id: string;
+    node_id?: string;
+    header: SessionHeader;
+    mtime: number;
+    size: number;
+    path: string;
+}
+/** Byte budgets for a bounded read of a conversation's two ends. */
+export interface ConversationWindow {
+    head: number;
+    tail: number;
+}
+export interface ConversationStore {
+    create(nodeId: string, header: SessionHeader, entries: SessionEntry[], path?: string): string;
+    append(id: string, entries: SessionEntry[]): void;
+    replace(id: string, header: SessionHeader, entries: SessionEntry[]): void;
+    /** Given a window and a file larger than head + tail bytes, `entries` holds the entries wholly
+     *  inside the first `head` bytes and `tail` those wholly inside the last `tail` bytes.
+     *  Otherwise `entries` is the whole conversation and `tail` is absent. */
+    read(id: string, window?: ConversationWindow): {
+        header: SessionHeader;
+        entries: SessionEntry[];
+        tail?: SessionEntry[];
+        path: string;
+    };
+    /** `read` without blocking the calling thread. Stores that read in-process may omit it;
+     *  use `readConversationAsync`, which falls back to `read`. */
+    readAsync?(id: string, window?: ConversationWindow): Promise<ReturnType<ConversationStore['read']>>;
+    /** Stream a complete conversation without blocking the daemon on a full-file read. */
+    readLines?(id: string): {
+        path: string;
+        lines: AsyncIterable<string>;
+    };
+    header(id: string): {
+        header: SessionHeader;
+        mtime: number;
+        size: number;
+        path: string;
+    };
+    fork(id: string, nodeId?: string, leafId?: string, cwd?: string): string;
+    list(nodeId?: string): ConversationInfo[];
+    delete(id: string): void;
+}
+export declare function conversationIdFromPath(path: string): string | null;
+export declare function defaultConversationRoot(): string;
+export declare function storeAddress(): string;
+export declare function installConversationStore(store: ConversationStore | undefined): void;
+export declare function conversationStore(): ConversationStore;
+/** Read a conversation without parking the event loop on the store worker. */
+export declare function readConversationAsync(id: string, window?: ConversationWindow): Promise<ReturnType<ConversationStore['read']>>;
+export { createFileStore, sessionDirectory, type AppendSection, type ConversationCanvas, type ConversationWrite } from './file-store.js';
+export { installSessionManagerStorePatch } from './patch.js';

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

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

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

@@ -0,0 +1,4 @@
+import { type ConversationStore } from './index.js';
+export declare function listenConversationStore(address: string, store: ConversationStore): Promise<{
+    close(): Promise<void>;
+}>;

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

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

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

@@ -0,0 +1 @@
+export declare function installSessionManagerStorePatch(nodeId: string): void;

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

@@ -0,0 +1 @@
+var b=Object.defineProperty;var l=(u,a)=>b(u,"name",{value:a,configurable:!0});import{dirname as E,resolve as v}from"node:path";import{SessionManager as m}from"@earendil-works/pi-coding-agent";import{conversationIdFromPath as x,conversationStore as B}from"./index.js";let N=!1;function j(u){if(N)return;const a=m.prototype,h=m;for(const e of["_setSessionFile","_rewriteFile","_persist","createBranchedSession","newSession"])if(typeof a[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);for(const e of["create","open","continueRecent","forkFrom","findById","list","listAll"])if(typeof h[e]!="function")throw new Error(`pi SessionManager.${e} changed; store patch cannot start`);const D=a.createBranchedSession,w=a.newSession,r=B();function y(e,s){const{header:t,entries:i,path:o}=r.read(e),n=m.inMemory(s??t.cwd);n.sessionFile=o,n.sessionDir=E(o),n._loadEntries([t,...i]),n.persist=!0,n.flushed=!0;const d=n.fileEntries[0];return d?.type==="session"&&d.version!==t.version&&n._rewriteFile(),n}l(y,"fromStore");function p(e){const[s,...t]=e.fileEntries;if(!s||s.type!=="session")throw new Error("conversation has no session header");r.create(u,s,t),e.sessionFile=r.header(s.id).path,e.sessionDir=E(e.sessionFile),e.flushed=!0}l(p,"persistNew");function g(e){const s=x(e);if(!s)throw new Error(`invalid conversation path: ${e}`);return s}l(g,"idOf"),a._setSessionFile=function(e){const{header:s,entries:t}=r.read(g(e));this.sessionFile=r.header(s.id).path,this.sessionDir=E(this.sessionFile),this._loadEntries([s,...t]),this.flushed=!0},a._rewriteFile=function(){if(!this.persist||!this.sessionFile)return;const[e,...s]=this.fileEntries;if(!e||e.type!=="session")throw new Error("conversation has no session header");r.replace(e.id,e,s)},a._persist=function(e){!this.persist||!this.sessionFile||(this.flushed?r.append(this.sessionId,[e]):p(this))},a.newSession=function(e){if(!this.persist)return w.call(this,e);const s=this.flushed&&this.fileEntries.length===1&&this.sessionFile!==void 0?this.sessionId:void 0;if(s!==void 0&&(e?.id===void 0||e.id===s)){const t=this.sessionFile;w.call(this,{...e,id:s});const i=this.fileEntries[0];if(!i||i.type!=="session")throw new Error("conversation has no session header");return r.replace(s,i,[]),this.sessionFile=t,this.flushed=!0,t}return w.call(this,e),p(this),this.sessionFile},a.createBranchedSession=function(e){if(!this.persist)return D.call(this,e);const s=this.sessionFile;this.persist=!1;try{D.call(this,e)}finally{this.persist=!0}const t=this.fileEntries[0];if(!t||t.type!=="session")throw new Error("branch has no header");return this.fileEntries[0]={...t,parentSession:s},p(this),this.sessionFile},h.create=(e,s,t)=>{const i=m.inMemory(e,t);return i.persist=!0,p(i),i},h.open=(e,s,t)=>y(g(e),t),h.continueRecent=e=>{const s=r.list().find(t=>t.header.cwd===v(e));return s?y(s.conversation_id,e):h.create(e)},h.forkFrom=(e,s)=>y(r.fork(g(e),u,void 0,s)),h.findById=(e,s)=>r.list().find(t=>t.conversation_id===s&&t.header.cwd===v(e))?.path;function M(e){return r.list().filter(s=>e===void 0||s.header.cwd===v(e)).map(s=>{let t,i=0,o="",n;const d=[];for(const f of r.read(s.conversation_id).entries){if(f.type==="session_info"&&(t=f.name?.trim()||void 0),f.type!=="message")continue;i++;const c=f.message;if(c.role!=="user"&&c.role!=="assistant")continue;const A=typeof c.timestamp=="number"?c.timestamp:Date.parse(f.timestamp);Number.isNaN(A)||(n=Math.max(n??0,A));const S=typeof c.content=="string"?c.content:Array.isArray(c.content)?c.content.filter(_=>_.type==="text").map(_=>_.text??"").join(" "):"";S&&(d.push(S),!o&&c.role==="user"&&(o=S))}const F=new Date(s.header.timestamp);return{path:s.path,id:s.conversation_id,cwd:s.header.cwd,...t?{name:t}:{},...s.header.parentSession?{parentSessionPath:s.header.parentSession}:{},created:F,modified:n&&n>0?new Date(n):Number.isNaN(F.getTime())?new Date(s.mtime):F,messageCount:i,firstMessage:o||"(no messages)",allMessagesText:d.join(" ")}})}l(M,"sessionInfos"),h.list=async(e,s,t,i)=>{i?.throwIfAborted();const o=M(e);return t?.(o.length,o.length,o),o},h.listAll=async(...e)=>(e.find(t=>t instanceof AbortSignal)?.throwIfAborted(),M()),N=!0}l(j,"installSessionManagerStorePatch");export{j as installSessionManagerStorePatch};

package/dist/core/directory/join.d.ts

@@ -0,0 +1,27 @@
+import { type JsonWebKey } from 'node:crypto';
+/** The runtime-client key file grant sync reads, plus the accepted
+ *  enrollment's metadata. Written only after a successful registration. */
+interface JoinedClient {
+    jwk: JsonWebKey & {
+        kid: string;
+    };
+    kid: string;
+    alg: 'ES256';
+    client_id: string;
+    runtime: string;
+    issuer: string;
+    owner: string;
+    url: string;
+    token_sha256: string;
+}
+type Registration = Pick<JoinedClient, 'runtime' | 'client_id' | 'issuer' | 'owner' | 'url'>;
+export interface JoinResult extends Registration {
+    /** False when the token matched the stored successful registration and no directory call was made. */
+    registered: boolean;
+}
+/** The owner a successful join recorded, or null when `crtr sys join` never
+ *  wrote the client file (no file, or one provisioned without join, which has
+ *  no `token_sha256`). The daemon applies OWN-11 to canvas.db from it at every start. */
+export declare function joinedOwner(): string | null;
+export declare function joinDirectory(directory: string, token: string): Promise<JoinResult>;
+export {};

package/dist/core/directory/join.js

@@ -0,0 +1 @@
+var j=Object.defineProperty;var a=(t,e)=>j(t,"name",{value:e,configurable:!0});import{createHash as S,generateKeyPairSync as v,randomUUID as _}from"node:crypto";import{mkdirSync as b}from"node:fs";import{join as $}from"node:path";import{InputError as c}from"../io.js";import{network as d}from"../errors.js";import{secretsDir as l}from"../layout.js";import{apiSocketPath as E}from"../canvas/paths.js";import{daemonAnswers as P}from"../layout-migrate/index.js";import{atomicWriteJson as U,readJsonIfExists as w}from"../fs-utils.js";import{updateConfig as J}from"../config.js";import{userScopeRoot as L}from"../scope.js";import{rewriteLocalProfileGrantees as O}from"../scoped-state/profiles.js";function m(){return $(l(),"runtime-client.json")}a(m,"clientPath");function p(t){if(typeof t!="string")return!1;try{const{protocol:e}=new URL(t);return e==="http:"||e==="https:"}catch{return!1}}a(p,"isUrl");function g(t){const e=t??{},{runtime:i,client_id:n,issuer:o,owner:s,url:r}=e;if(typeof i!="string"||!/^runtime:.+/.test(i)||typeof n!="string"||n===""||!p(o)||typeof s!="string"||!/^user:.+/.test(s)||!p(r))throw d("directory registration answer is missing runtime, client_id, issuer, owner, or url");return{runtime:i,client_id:n,issuer:o,owner:s,url:r}}a(g,"registration");async function R(t,e,i){const n=`${t.replace(/\/$/,"")}/v1/runtimes/registration`;let o;try{o=await fetch(n,{method:"PUT",headers:{authorization:`Bearer ${e}`,"content-type":"application/json"},body:JSON.stringify({jwk:i}),signal:AbortSignal.timeout(3e4)})}catch(r){throw d(`directory registration request to ${n} failed: ${r instanceof Error?r.message:String(r)}`)}const s=await o.text();if(!o.ok)throw new c({error:"join_refused",message:`directory refused the registration: ${o.status} ${s.slice(0,500)}`,next:"The enrollment token is single-use and short-lived; provisioning must retry with a fresh token."});try{return g(JSON.parse(s))}catch(r){throw r instanceof SyntaxError?d("directory registration answer is not JSON"):r}}a(R,"register");function y(t){J("user",e=>{e.runtime={...e.runtime,issuer:t.issuer,audience:t.url}}),O(L())}a(y,"commit");function F(){const t=w(m());if(t?.token_sha256===void 0)return null;const{owner:e}=t;if(typeof e!="string"||!/^user:.+/.test(e))throw new Error(`${m()} was written by join but has a missing or invalid owner`);return e}a(F,"joinedOwner");async function M(t,e){if(!p(t))throw new c({error:"invalid_directory",message:"directory must be an http or https URL",received:t,field:"directory",next:"Pass the directory base URL, for example https://directory.example."});if(e==="")throw new c({error:"invalid_token",message:"token is empty",field:"token",next:"Pass the enrollment token provisioning supplied."});const i=E();if(await P(i))throw new c({error:"daemon_running",message:`cannot join while a daemon answers on ${i}`,next:"Join before the daemon starts: stop the daemon that owns this volume, then run `crtr sys join` again."});const n=S("sha256").update(e).digest("hex"),o=w(m());if(o?.token_sha256===n){const h=g(o);return y(h),{...h,registered:!1}}const{privateKey:s,publicKey:r}=v("ec",{namedCurve:"P-256"}),u=_(),k={...s.export({format:"jwk"}),kid:u,alg:"ES256",use:"sig"},f=await R(t,e,{...r.export({format:"jwk"}),kid:u,alg:"ES256",use:"sig"});b(l(),{recursive:!0,mode:448});const x={jwk:k,kid:u,alg:"ES256",...f,token_sha256:n};return U(m(),x,{mode:384}),y(f),{...f,registered:!0}}a(M,"joinDirectory");export{M as joinDirectory,F as joinedOwner};

package/dist/core/disk-usage.d.ts

@@ -0,0 +1,4 @@
+/** Disk usage of one directory in bytes, or null when it cannot be measured.
+ *  `du` is spawned asynchronously: a managed checkout can be tens of gigabytes,
+ *  and this runs inside the daemon, which must never block its event loop. */
+export declare function directorySizeBytes(path: string): Promise<number | null>;

package/dist/core/disk-usage.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(r,t)=>u(r,"name",{value:t,configurable:!0});import{spawn as l}from"node:child_process";import{existsSync as c}from"node:fs";async function f(r){return c(r)?new Promise(t=>{const n=l("du",["-sk",r]);let e="";n.stdout.on("data",o=>e+=o.toString()),n.stderr.on("data",()=>{}),n.on("error",()=>t(null)),n.on("close",o=>{if(o!==0)return t(null);const i=Number(e.trim().split(/\s+/)[0]);t(Number.isSafeInteger(i)?i*1024:null)})}):null}s(f,"directorySizeBytes");export{f as directorySizeBytes};

package/dist/core/document-lines.d.ts

@@ -0,0 +1,4 @@
+/** The document's logical lines: a single terminating newline closes the last
+ *  line rather than opening an empty one. Never empty — an empty document is
+ *  one empty line. */
+export declare function documentLines(text: string): string[];

package/dist/core/document-lines.js

@@ -0,0 +1,3 @@
+var s=Object.defineProperty;var i=(n,e)=>s(n,"name",{value:e,configurable:!0});function o(n){return(n.endsWith(`
+`)?n.slice(0,-1):n).split(`
+`)}i(o,"documentLines");export{o as documentLines};

package/dist/core/editor-resolver.d.ts

@@ -0,0 +1,28 @@
+/** Candidates tried, in order, when neither $VISUAL nor $EDITOR is set. */
+export declare const FALLBACK_EDITORS: readonly ["nano", "pico", "micro", "nvim", "vim", "vi"];
+export interface ResolvedEditor {
+    /** Shell fragment to run, e.g. `code --wait` or `nano`. */
+    command: string;
+    /** `env` = the person's $VISUAL/$EDITOR; `fallback` = we picked it. */
+    source: 'env' | 'fallback';
+    /** Short, human hint to show after a fallback was used; undefined for `env`. */
+    hint?: string;
+}
+export declare const NO_EDITOR_MESSAGE = "No text editor found \u2014 install nano (macOS: brew install nano; Debian/Ubuntu: apt install nano) or set $EDITOR";
+/** First-token basename of an editor fragment: `/usr/bin/nvim -p` → `nvim`. */
+export declare function editorBasename(fragment: string): string;
+export declare function isViFamilyEditor(fragment: string): boolean;
+/** Is `name` an executable file on `pathEnv`? */
+export declare function executableOnPath(name: string, pathEnv?: string | undefined): boolean;
+/**
+ * Resolve the editor to launch, or null when none is installed.
+ * `available` is injectable so tests need no real binaries.
+ */
+export declare function resolveEditor(env?: Record<string, string | undefined>, available?: (name: string) => boolean): ResolvedEditor | null;
+/**
+ * Show the fallback editor's guidance before it takes over the screen, and
+ * pause for Enter so a full-screen editor (vi uses the alternate screen) cannot
+ * erase it unread. Call after the host TUI has released the terminal. No-op for
+ * the person's own $VISUAL/$EDITOR.
+ */
+export declare function announceFallbackEditor(resolved: ResolvedEditor, write?: (text: string) => void, wait?: () => void): void;

package/dist/core/editor-resolver.js

@@ -0,0 +1,4 @@
+var a=Object.defineProperty;var r=(n,t)=>a(n,"name",{value:t,configurable:!0});import{accessSync as u,constants as f,readSync as l,statSync as m}from"node:fs";import{delimiter as p,join as d}from"node:path";const h=["nano","pico","micro","nvim","vim","vi"],e=new Set(["nvim","vim","vi","view"]),v="No text editor found \u2014 install nano (macOS: brew install nano; Debian/Ubuntu: apt install nano) or set $EDITOR";function c(n){const t=n.trim().split(/\s+/)[0]??"";return t.split("/").pop()||t}r(c,"editorBasename");function I(n){return e.has(c(n))}r(I,"isViFamilyEditor");function E(n,t=process.env.PATH){for(const o of(t??"").split(p))if(o!=="")try{const i=d(o,n);if(!m(i).isFile())continue;return u(i,f.X_OK),!0}catch{}return!1}r(E,"executableOnPath");function y(n=process.env,t=o=>E(o,n.PATH)){const o=(n.VISUAL??"").trim()||(n.EDITOR??"").trim();if(o!=="")return{command:o,source:"env"};for(const i of h){if(!t(i))continue;const s=e.has(i)?" \u2014 :wq saves and quits, :q! quits without saving":"";return{command:i,source:"fallback",hint:`Used ${i}; set $EDITOR to choose another${s}`}}return null}r(y,"resolveEditor");function x(){const n=Buffer.alloc(256);try{for(;;){const t=l(0,n,0,n.length,null);if(t===0||n.subarray(0,t).includes(10))return}}catch{}}r(x,"waitForEnter");function A(n,t=i=>{process.stdout.write(i)},o=x){n.source!=="fallback"||n.hint===void 0||(t(`
+${n.hint}
+Press Enter to open ${c(n.command)}\u2026 `),o(),t(`
+`))}r(A,"announceFallbackEditor");export{h as FALLBACK_EDITORS,v as NO_EDITOR_MESSAGE,A as announceFallbackEditor,c as editorBasename,E as executableOnPath,I as isViFamilyEditor,y as resolveEditor};

package/dist/core/env-name.d.ts

@@ -0,0 +1,6 @@
+export interface EnvNameValidation {
+    isValid: boolean;
+    errors: string[];
+}
+/** Validate an environment variable identifier without reading its value. */
+export declare function validateEnvVarName(name: unknown): EnvNameValidation;

package/dist/core/env-name.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(r,e)=>a(r,"name",{value:e,configurable:!0});function s(r){const e=[];return typeof r!="string"?e.push("env var name must be a string"):/^[A-Za-z_][A-Za-z0-9_]*$/.test(r)||e.push("env var name must start with letter/underscore, followed by alphanumeric/underscore"),{isValid:e.length===0,errors:e}}t(s,"validateEnvVarName");export{s as validateEnvVarName};

package/dist/core/errors.d.ts

@@ -0,0 +1,38 @@
+import { type ExitCodeValue } from '../types.js';
+export declare class CrtrError extends Error {
+    code: string;
+    exitCode: ExitCodeValue;
+    details?: Record<string, unknown>;
+    constructor(code: string, message: string, exitCode?: ExitCodeValue, details?: Record<string, unknown>);
+}
+export declare function notFound(message: string, details?: Record<string, unknown>): CrtrError;
+export declare function usage(message: string, details?: Record<string, unknown>): CrtrError;
+export declare function ambiguous(message: string, details?: Record<string, unknown>): CrtrError;
+export declare function network(message: string, details?: Record<string, unknown>): CrtrError;
+export declare function general(message: string, details?: Record<string, unknown>): CrtrError;
+/** A node's broker ENGINE failed to launch or bind its view socket — an
+ *  operational failure surfaced from deep in the spawn/revive path (e.g. the
+ *  front-door root create). It is NOT a bad request and NOT an internal crtr
+ *  bug: it carries a curated cause the caller needs, so it must never collapse
+ *  into a bare `internal` 500 with the message stripped.
+ *
+ *  The `details` deliberately carry the FULL `{error, message, next}` payload so
+ *  a server-thrown instance round-trips through crtrd verbatim: `toErrorBody`
+ *  surfaces it as a <500 body with structured details, and the client's
+ *  `apiErrorToCliError` (tier 2) reconstructs the exact code, message, and
+ *  actionable `next` instead of degrading to a generic `invalid_request`. */
+export declare function brokerLaunchFailed(message: string, next: string): CrtrError;
+export declare function nodeCreateRefused(message: string, next: string): CrtrError;
+/** Refuse, inside an app's sandboxed node, something only the person's own
+ *  terminal can reach (their stores, settings, or remote canvas targets) with
+ *  the daemon-operations `owner_only` refusal instead of an internal error
+ *  from touching storage the sandbox does not mount. */
+export declare function ownerOnly(reason: string, next: string): CrtrError;
+/** Refuse a CLI capability that was omitted from this run's allow-list with
+ *  the daemon-operations `scope_missing` refusal naming the missing string.
+ *  `scope` is an identity scope string (`crtr:act`); a bare capability name
+ *  (`act`) is read as `crtr:<name>` so it can never reach `covers()` unparsed. */
+export declare function requireScope(scope: string, command: string): void;
+/** Thrown by stub handlers for leaves not yet wired in P3+.
+ *  code='not_implemented', exitCode=GENERAL, next names the node. */
+export declare function notImplemented(node: string): CrtrError;

package/dist/core/errors.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var n=(e,r)=>l(e,"name",{value:r,configurable:!0});import{ExitCode as o}from"../types.js";import{envScopes as p,scopeAllowed as w}from"../shared/env.js";class i extends Error{static{n(this,"CrtrError")}code;exitCode;details;constructor(r,t,s=o.GENERAL,u){super(t),this.name="CrtrError",this.code=r,this.exitCode=s,this.details=u}}function m(e,r){return new i("not_found",e,o.NOT_FOUND,r)}n(m,"notFound");function x(e,r){return new i("usage",e,o.USAGE,r)}n(x,"usage");function y(e,r){return new i("ambiguous",e,o.AMBIGUOUS,r)}n(y,"ambiguous");function A(e,r){return new i("network",e,o.NETWORK,r)}n(A,"network");function G(e,r){return new i("error",e,o.GENERAL,r)}n(G,"general");function N(e,r){const t="broker_launch_failed";return new i(t,e,o.GENERAL,{error:t,message:e,next:r})}n(N,"brokerLaunchFailed");function _(e,r){const t="node_create_refused";return new i(t,e,o.GENERAL,{error:t,message:e,next:r})}n(_,"nodeCreateRefused");function g(e,r){const t="owner_only",s=`${e}; only the person's terminal can.`;return new i(t,s,o.USAGE,{error:t,message:s,next:r})}n(g,"ownerOnly");function R(e,r){const t=e.startsWith("crtr:")?e:`crtr:${e}`,s=p();if(s==null||s.some(d=>{try{return w([d],t)}catch{return!1}}))return;const c="scope_missing",a=`missing scope ${t}: this run was not launched with it, so \`${r}\` is not available.`;throw new i(c,a,o.GENERAL,{error:c,message:a,scope:t,next:"This capability was not granted to the run. Do not retry it \u2014 proceed without it and say so in your result."})}n(R,"requireScope");function L(e){return new i("not_implemented",`${e} is not yet implemented.`,o.GENERAL,{next:"This leaf is not yet wired."})}n(L,"notImplemented");export{i as CrtrError,y as ambiguous,N as brokerLaunchFailed,G as general,A as network,_ as nodeCreateRefused,m as notFound,L as notImplemented,g as ownerOnly,R as requireScope,x as usage};

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

@@ -0,0 +1,6 @@
+import type { BuildEnvelopeInput } from './types.js';
+export type EmitEventInput = Omit<BuildEnvelopeInput, 'component' | 'stream_id'>;
+/** Resolves after every broker event emitted so far has been appended or written to stderr. */
+export declare function flushBrokerLog(): Promise<void>;
+/** The only canonical write path. The bound source owns the destination component/path/stream; node_id identifies the event target, with a broker source enforcing its bound node. */
+export declare function emitEvent(input: EmitEventInput): boolean;

package/dist/core/events/emit.js

@@ -0,0 +1,3 @@
+var i=Object.defineProperty;var n=(o,e)=>i(o,"name",{value:e,configurable:!0});import{appendBufferedDaemonRecord as s,appendRotatingRecord as f}from"../log.js";import{buildEnvelope as c}from"./envelope.js";import{serializeEventRecord as m}from"./serialize.js";import{eventSource as p}from"./source.js";import{envExecutionId as a}from"../../shared/env.js";import{appendBrokerLog as u}from"../runtime/broker/daemon-ops.js";let t=Promise.resolve();function E(){return t}n(E,"flushBrokerLog");function l(o,e){t=t.then(async()=>{try{const{appended:r}=await u(o,e);r||process.stderr.write(`[broker] log.jsonl refused record: ${e}
+`)}catch(r){process.stderr.write(`[broker] log.jsonl append failed (${r instanceof Error?r.message:String(r)}): ${e}
+`)}})}n(l,"queueBrokerRecord");function w(o){const e=p();if(e===void 0)return!1;if(e.component==="broker"&&e.node_id!==void 0&&o.node_id!==void 0&&o.node_id!==e.node_id)throw new TypeError(`broker event target node_id must match bound node_id; received ${o.node_id}`);if(o.level==="debug"&&process.env.CRTR_LOG!=="debug")return!1;const r=c({...o,component:e.component,...e.node_id===void 0?{}:{node_id:e.node_id},...e.stream_id===void 0?{}:{stream_id:e.stream_id}}),d=m(r);return e.component==="broker"&&e.node_id!==void 0&&a()!==void 0?(l(e.node_id,d),!0):e.component==="daemon"?s(e.path,d):f(e.path,d)}n(w,"emitEvent");export{w as emitEvent,E as flushBrokerLog};

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

@@ -0,0 +1,2 @@
+import type { BuildEnvelopeInput, EventEnvelope } from './types.js';
+export declare function buildEnvelope(input: BuildEnvelopeInput): EventEnvelope;

package/dist/core/events/envelope.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var o=(e,r)=>i(e,"name",{value:r,configurable:!0});import{errorClassCodes as d,eventErrorFromUnknown as a}from"./errors.js";import{generateOperationId as f,operationIdContext as m,validateOperationId as c}from"./operation-id.js";const w=/^[a-z][a-z0-9]*(?:[._][a-z0-9]+)*$/,l=new Set(["error","warn","info","debug"]),_=new Set(["daemon","broker","control-plane","front","sentinel"]),p=new Set(["succeeded","failed","skipped"]),y=new Set(["auto","manual","fatal"]),h=new Set(d);function u(e){return Buffer.byteLength(e,"utf8")}o(u,"bytes");function s(e,r,n=128){if(typeof e!="string"||e===""||u(e)>n)throw new TypeError(`${r} must be a non-empty string of at most ${n} UTF-8 bytes`);return e}o(s,"requireString");function b(e){if(typeof e!="string"||!/^\d{4}-\d{2}-\d{2}T/.test(e))throw new TypeError("ts must be an ISO 8601 timestamp");const r=new Date(e);if(Number.isNaN(r.getTime()))throw new TypeError("ts must be an ISO 8601 timestamp");return r.toISOString()}o(b,"normalizedTimestamp");function T(e){if(!h.has(e.class))throw new TypeError("error_class.class is invalid");const r={class:e.class};if(e.status!==void 0){if(!Number.isInteger(e.status))throw new TypeError("error_class.status must be an integer");r.status=e.status}if(e.provider!==void 0&&(r.provider=s(e.provider,"error_class.provider")),e.retry_disposition!==void 0){if(!y.has(e.retry_disposition))throw new TypeError("error_class.retry_disposition is invalid");r.retry_disposition=e.retry_disposition}return r}o(T,"checkedErrorClass");function v(e){if(!l.has(e.level))throw new TypeError("level is invalid");if(!_.has(e.component))throw new TypeError("component is invalid");const r=s(e.event,"event");if(!w.test(r))throw new TypeError("event must be a lowercase dotted identifier");const n=e.operation_id===void 0?m.current()??f():c(e.operation_id),t={v:1,ts:e.ts===void 0?new Date().toISOString():b(e.ts),level:e.level,event:r,component:e.component,operation_id:n};if(e.node_id!==void 0&&(t.node_id=s(e.node_id,"node_id")),e.stream_id!==void 0&&(t.stream_id=s(e.stream_id,"stream_id")),e.duration_ms!==void 0){if(!Number.isFinite(e.duration_ms)||e.duration_ms<0)throw new TypeError("duration_ms must be finite and non-negative");t.duration_ms=e.duration_ms}if(e.outcome!==void 0){if(!p.has(e.outcome))throw new TypeError("outcome is invalid");t.outcome=e.outcome}if(e.attempt!==void 0){if(!Number.isInteger(e.attempt)||e.attempt<=0)throw new TypeError("attempt must be a positive integer");t.attempt=e.attempt}return e.error_class!==void 0&&(t.error_class=T(e.error_class)),e.error!==void 0&&(t.error=a(e.error)),e.fields!==void 0&&(t.fields=e.fields),t}o(v,"buildEnvelope");export{v as buildEnvelope};

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

@@ -0,0 +1,4 @@
+import { errorClassCodes, type ErrorClass, type ErrorClassHints, type EventError } from './types.js';
+export declare function errorClassFromError(error: unknown, hints?: ErrorClassHints): ErrorClass;
+export declare function eventErrorFromUnknown(error: unknown): EventError;
+export { errorClassCodes };

package/dist/core/events/errors.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});import{errorClassCodes as a}from"./types.js";const f=new Set(["auto","manual","fatal"]);function s(e){return typeof e=="object"&&e!==null?e:void 0}o(s,"record");function i(e){return typeof e=="string"?e:""}o(i,"text");function d(e){const t=s(e)?.status;return typeof t=="number"&&Number.isInteger(t)?t:void 0}o(d,"statusFrom");function c(e){const t=s(e);return i(t?.code)||i(t?.errno)}o(c,"codeFrom");function l(e){if(typeof e=="string")return e;if(e instanceof Error)return e.message;const t=s(e);return i(t?.message)||i(t?.statusText)||i(t?.reason)}o(l,"messageFrom");function p(e,t,n){return e===429||/rate.?limit|too many requests|quota/i.test(n)?"rate_limit":e===401||e===403||/invalid_grant|refresh token|unauthori[sz]ed|invalid.?api.?key|authentication failed/i.test(n)?"auth":/context overflow/i.test(n)?"context_overflow":/model.{0,40}(not found|does not exist|not available)|not_found_error/i.test(n)?"model_not_found":/wedged/i.test(n)?"wedged":/^(ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENOENT|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH)$/i.test(t)||/connection|econnreset|etimedout|enotfound|network|fetch failed|socket hang|timed? out|websocket.*(?:closed|error)/i.test(n)?"connection":e!==void 0&&e>=500||/overloaded|capacity|server.{0,3}busy|temporarily unavailable|internal server error/i.test(n)?"overloaded":e!==void 0&&e>=400||/protocol|invalid (?:frame|payload)|policy violation/i.test(n)?"protocol":"unknown"}o(p,"classify");function y(e,t={}){const n=t.status??d(e),r={class:p(n,c(e),l(e))};return n!==void 0&&(r.status=n),typeof t.provider=="string"&&t.provider!==""&&(r.provider=t.provider),t.retry_disposition!==void 0&&f.has(t.retry_disposition)&&(r.retry_disposition=t.retry_disposition),r}o(y,"errorClassFromError");function v(e){if(e instanceof Error){const n={type:e.name||"Error",message:e.message};return typeof e.stack=="string"&&(n.stack=e.stack),e.cause!==void 0&&(n.cause=e.cause instanceof Error?e.cause.message:String(e.cause)),n}if(typeof e=="string")return{type:"Error",message:e};const t=s(e);return{type:i(t?.name)||"Error",message:i(t?.message)||String(e)}}o(v,"eventErrorFromUnknown");export{a as errorClassCodes,y as errorClassFromError,v as eventErrorFromUnknown};

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

@@ -0,0 +1,5 @@
+export { validateOperationId, operationIdContext } from './operation-id.js';
+export { buildEnvelope } from './envelope.js';
+export { errorClassCodes, errorClassFromError } from './errors.js';
+export { serializeEventRecord } from './serialize.js';
+export type { BuildEnvelopeInput, ErrorClass, ErrorClassCode, ErrorClassHints, EventComponent, EventEnvelope, EventError, EventField, EventLevel, EventOutcome, OperationId, OperationIdContext, RetryDisposition, } from './types.js';

package/dist/core/events/index.js

@@ -0,0 +1 @@
+import{validateOperationId as e,operationIdContext as t}from"./operation-id.js";import{buildEnvelope as p}from"./envelope.js";import{errorClassCodes as i,errorClassFromError as l}from"./errors.js";import{serializeEventRecord as m}from"./serialize.js";export{p as buildEnvelope,i as errorClassCodes,l as errorClassFromError,t as operationIdContext,m as serializeEventRecord,e as validateOperationId};

package/dist/core/events/operation-id.d.ts

@@ -0,0 +1,4 @@
+import type { OperationId, OperationIdContext } from './types.js';
+export declare function validateOperationId(value: unknown): OperationId;
+export declare function generateOperationId(): OperationId;
+export declare const operationIdContext: OperationIdContext;

package/dist/core/events/operation-id.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var e=(r,t)=>a(r,"name",{value:t,configurable:!0});import{AsyncLocalStorage as i}from"node:async_hooks";import{randomBytes as c}from"node:crypto";const s=/^(?!0{32}$)[0-9a-f]{32}$/,o=new i;function n(r){if(typeof r!="string"||!s.test(r))throw new TypeError("operation_id must be 32 lowercase non-zero hexadecimal characters");return r}e(n,"validateOperationId");function p(){let r;do r=c(16).toString("hex");while(r==="00000000000000000000000000000000");return n(r)}e(p,"generateOperationId");const m={current:e(()=>o.getStore(),"current"),run:e((r,t)=>o.run(n(r),t),"run"),fresh:e(r=>{const t=p();return o.run(t,()=>r(t))},"fresh")};export{p as generateOperationId,m as operationIdContext,n as validateOperationId};

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

@@ -0,0 +1,40 @@
+import { type EventComponent, type EventEnvelope, type EventLevel, type OperationId } from './types.js';
+export interface EventReadQuery {
+    nodeId?: string;
+    component?: EventComponent;
+    operationId?: OperationId;
+    sinceMs?: number;
+    untilMs?: number;
+    minimumLevel?: EventLevel;
+    pattern?: string;
+}
+export interface CanonicalReadItem {
+    kind: 'event';
+    envelope: EventEnvelope;
+    source: string;
+    streamKey: string;
+    generation: 2 | 1 | 0;
+    byteOffset: number;
+    effectiveTsMs: number;
+    /** True when this item's source omitted content: the reader's fixed byte
+     *  bound cut its start, or the same file also contained a corrupt/mismatched
+     *  line. Constant across every item from one source file. */
+    truncated: boolean;
+}
+export interface RawReadItem {
+    kind: 'raw';
+    component: 'daemon' | 'broker';
+    source: string;
+    content: string;
+    effectiveTsMs: number;
+    /** True when the reader's fixed byte bound cut this source's start. */
+    truncated: boolean;
+}
+export type LogSnapshotItem = CanonicalReadItem | RawReadItem;
+export interface LogSnapshotResult {
+    items: LogSnapshotItem[];
+    invalidCanonicalLines: number;
+}
+export type Tier1Event = Pick<EventEnvelope, 'v' | 'ts' | 'level' | 'event' | 'component' | 'operation_id' | 'node_id' | 'stream_id' | 'duration_ms' | 'outcome' | 'attempt' | 'error_class'>;
+export declare function readLogSnapshot(query: EventReadQuery, includeRaw: boolean): LogSnapshotResult;
+export declare function projectTier1Event(envelope: EventEnvelope): Tier1Event;

package/dist/core/events/read.js

@@ -0,0 +1 @@
+var W=Object.defineProperty;var s=(n,e)=>W(n,"name",{value:e,configurable:!0});import{closeSync as X,constants as O,fstatSync as G,lstatSync as L,openSync as H,opendirSync as J,readSync as Q}from"node:fs";import{isAbsolute as Z,join as S,relative as N,resolve as I,sep as q}from"node:path";import{crtrHome as ee,isSafeNodeId as C,nodesRoot as ne}from"../canvas/paths.js";import{validateOperationId as A}from"./operation-id.js";import{MAX_EVENT_RECORD_BYTES as te}from"./serialize.js";import{errorClassCodes as re}from"./types.js";import{isRecord as E}from"../../shared/predicates.js";const k=200,ie=6*1024*1024,oe=256*1024,se=te-1,de=typeof O.O_NOFOLLOW=="number"?O.O_NOFOLLOW:0,fe=/^[a-z][a-z0-9]*(?:[._][a-z0-9]+)*$/,ae=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/,ce=/^\d{4}-\d{2}-\d{2}T/,ue=new Set(["nodeId","component","operationId","sinceMs","untilMs","minimumLevel","pattern"]),me=new Set(["class","status","provider","retry_disposition"]),le=new Set(["type","message","stack","cause"]),pe=new Set(["v","ts","level","event","component","operation_id","node_id","stream_id","duration_ms","outcome","attempt","error_class","error","fields","record_truncated","original_bytes","dropped_fields_count"]),R=new Set(["debug","info","warn","error"]),F=new Set(["daemon","broker"]),ye=new Set(["succeeded","failed","skipped"]),_e=new Set(["auto","manual","fatal"]),be=new Set(re),$={debug:0,info:1,warn:2,error:3},Se={2:0,1:1,0:2};function m(n,e){return Object.prototype.hasOwnProperty.call(n,e)}s(m,"hasOwn");function h(n,e){return Object.keys(n).every(t=>e.has(t))}s(h,"hasOnlyKeys");function y(n,e,t=!1){return typeof n=="string"&&(!t||n!=="")&&Buffer.byteLength(n,"utf8")<=e}s(y,"boundedString");function we(n){if(typeof n!="object"||n===null||Array.isArray(n))throw new TypeError("event read query is invalid");const e=n;if(!h(e,ue))throw new TypeError("event read query is invalid");const t={};if(e.nodeId!==void 0){if(typeof e.nodeId!="string"||!C(e.nodeId))throw new TypeError("nodeId must be a safe non-empty path segment");t.nodeId=e.nodeId}if(e.component!==void 0){if(typeof e.component!="string"||!F.has(e.component))throw new TypeError("component is invalid");t.component=e.component}if(e.operationId!==void 0&&(t.operationId=A(e.operationId)),e.sinceMs!==void 0){if(typeof e.sinceMs!="number"||!Number.isFinite(e.sinceMs))throw new TypeError("sinceMs must be finite");t.sinceMs=e.sinceMs}if(e.untilMs!==void 0){if(typeof e.untilMs!="number"||!Number.isFinite(e.untilMs))throw new TypeError("untilMs must be finite");t.untilMs=e.untilMs}if(t.sinceMs!==void 0&&t.untilMs!==void 0&&t.sinceMs>t.untilMs)throw new TypeError("sinceMs cannot exceed untilMs");if(e.minimumLevel!==void 0){if(typeof e.minimumLevel!="string"||!R.has(e.minimumLevel))throw new TypeError("minimumLevel is invalid");t.minimumLevel=e.minimumLevel}if(e.pattern!==void 0){if(!y(e.pattern,4096,!0))throw new TypeError("pattern must be a non-empty string of at most 4,096 UTF-8 bytes");t.pattern=e.pattern}return t}s(we,"normalizeQuery");function v(n,e){return n.component===void 0||n.component===e}s(v,"selected");function g(n){return{dev:n.dev,ino:n.ino}}s(g,"identityOf");function x(n,e){return n.dev===e.dev&&n.ino===e.ino}s(x,"sameIdentity");function Ee(n,e){if(n.size<0n||n.size>BigInt(Number.MAX_SAFE_INTEGER))throw new Error(`event source has an unsafe size: ${e}`);return Number(n.size)}s(Ee,"safeSize");function B(n){return n?.code==="ENOENT"}s(B,"isMissing");function j(n,e){const t=N(n,e);return t!==""&&!Z(t)&&t!==".."&&!t.startsWith(`..${q}`)}s(j,"isContained");function b(n){for(const e of n){let t;try{t=L(e.absolute,{bigint:!0})}catch(r){throw new Error(`event source directory changed: ${e.absolute}`,{cause:r})}if(t.isSymbolicLink()||!t.isDirectory()||!x(e,g(t)))throw new Error(`event source directory is unsafe: ${e.absolute}`)}}s(b,"validateDirectories");function M(n,e,t,r){if(t.length>0&&!j(n,e))throw new Error(`event source directory escapes its home: ${e}`);b(t);let i;try{i=L(e,{bigint:!0})}catch(o){if(r&&B(o))return;throw new Error(`event source directory is unavailable: ${e}`,{cause:o})}if(i.isSymbolicLink()||!i.isDirectory())throw new Error(`event source directory is unsafe: ${e}`);return b(t),{absolute:e,...g(i)}}s(M,"proveDirectory");function he(n,e){b([n]);let t;try{t=J(n.absolute)}catch(r){throw new Error(`event source directory cannot be opened: ${n.absolute}`,{cause:r})}try{for(;;){const r=t.readSync();if(r===null)break;e(r.name,r.isDirectory())}}finally{t.closeSync()}b([n])}s(he,"forEachDirectoryEntry");function ge(n,e,t){let r=0;for(;r<e.length;){const i=Q(n,e,r,e.length-r,t+r);if(i===0)throw new Error("event source changed during read");r+=i}}s(ge,"readExact");function z(n,e,t,r){if(!j(n,t))throw new Error(`event source escapes its home: ${t}`);b(e);let i;try{i=L(t,{bigint:!0})}catch(d){if(B(d))return;throw new Error(`event source is unavailable: ${t}`,{cause:d})}if(i.isSymbolicLink()||!i.isFile())throw new Error(`event source is unsafe: ${t}`);b(e);let o;try{o=H(t,O.O_RDONLY|de)}catch(d){throw new Error(`event source cannot be opened safely: ${t}`,{cause:d})}try{const d=G(o,{bigint:!0});if(!d.isFile()||!x(g(i),g(d)))throw new Error(`event source changed before read: ${t}`);b(e);const f=Ee(d,t),c=Math.min(f,r),a=f-c,l=Buffer.allocUnsafe(c);ge(o,l,a);const u=Number(d.mtimeMs);return{bytes:l,start:a,mtimeMs:Number.isFinite(u)?u:0}}finally{X(o)}}s(z,"readOwnedFile");function Me(n){return!E(n)||!h(n,me)||typeof n.class!="string"||!be.has(n.class)||m(n,"status")&&(typeof n.status!="number"||!Number.isSafeInteger(n.status))||m(n,"provider")&&!y(n.provider,128,!0)?!1:!m(n,"retry_disposition")||typeof n.retry_disposition=="string"&&_e.has(n.retry_disposition)}s(Me,"validErrorClass");function Oe(n){return!E(n)||!h(n,le)||!y(n.type,128,!0)||!y(n.message,4096)||m(n,"stack")&&!y(n.stack,16384)?!1:!m(n,"cause")||y(n.cause,4096)}s(Oe,"validError");function T(n,e,t){if(t.remaining<=0)return!1;if(t.remaining-=1,n===null||typeof n=="boolean")return!0;if(typeof n=="number")return Number.isFinite(n);if(typeof n=="string")return Buffer.byteLength(n,"utf8")<=4096;if(e>=4||typeof n!="object"||n===null)return!1;if(Array.isArray(n))return n.length<=64&&n.every(i=>T(i,e+1,t));const r=Object.entries(n);return r.length<=64&&r.every(([i,o])=>Buffer.byteLength(i,"utf8")<=128&&T(o,e+1,t))}s(T,"validEventField");function D(n){return typeof n=="number"&&Number.isSafeInteger(n)&&n>=0}s(D,"nonnegativeInteger");function Le(n){if(n.length===0||n.length>se||n.includes(13))return;let e;try{e=JSON.parse(n.toString("utf8"))}catch{return}if(!E(e)||!h(e,pe)||e.v!==1||!y(e.ts,128,!0)||!ae.test(e.ts)||!y(e.event,128,!0)||!fe.test(e.event)||typeof e.level!="string"||!R.has(e.level)||typeof e.component!="string"||!F.has(e.component))return;const t=Date.parse(e.ts);if(!Number.isFinite(t)||new Date(t).toISOString()!==e.ts)return;let r;try{r=A(e.operation_id)}catch{return}const i={v:1,ts:e.ts,level:e.level,event:e.event,component:e.component,operation_id:r};if(m(e,"node_id")){if(!y(e.node_id,128,!0))return;i.node_id=e.node_id}if(m(e,"stream_id")){if(!y(e.stream_id,128,!0))return;i.stream_id=e.stream_id}if(m(e,"duration_ms")){if(typeof e.duration_ms!="number"||!Number.isFinite(e.duration_ms)||e.duration_ms<0)return;i.duration_ms=e.duration_ms}if(m(e,"outcome")){if(typeof e.outcome!="string"||!ye.has(e.outcome))return;i.outcome=e.outcome}if(m(e,"attempt")){if(typeof e.attempt!="number"||!Number.isSafeInteger(e.attempt)||e.attempt<=0)return;i.attempt=e.attempt}if(m(e,"error_class")){if(!Me(e.error_class))return;i.error_class=e.error_class}if(m(e,"error")){if(!Oe(e.error))return;i.error=e.error}if(m(e,"fields")){if(!E(e.fields)||!T(e.fields,0,{remaining:5e3}))return;i.fields=e.fields}const o=m(e,"record_truncated"),d=m(e,"original_bytes"),f=m(e,"dropped_fields_count");if(o){if(e.record_truncated!==!0||!d||!f||!D(e.original_bytes)||!D(e.dropped_fields_count))return;i.record_truncated=!0,i.original_bytes=e.original_bytes,i.dropped_fields_count=e.dropped_fields_count}else if(d||f)return;return{envelope:i,effectiveTsMs:t}}s(Le,"parseCanonicalLine");function Ne(n,e){return e.component!==n.component?!1:n.component==="daemon"?e.stream_id===void 0:n.component==="broker"?e.node_id===n.boundNodeId&&e.stream_id===void 0:e.stream_id===n.boundStreamId}s(Ne,"descriptorMatches");function ve(n,e,t){const{envelope:r,effectiveTsMs:i}=t;return!(n.nodeId!==void 0&&e.component!=="broker"&&r.node_id!==n.nodeId||n.operationId!==void 0&&r.operation_id!==n.operationId||n.sinceMs!==void 0&&i<n.sinceMs||n.untilMs!==void 0&&i>n.untilMs||n.minimumLevel!==void 0&&$[r.level]<$[n.minimumLevel]||n.pattern!==void 0&&!JSON.stringify(r).toLocaleLowerCase("en-US").includes(n.pattern.toLocaleLowerCase("en-US")))}s(ve,"matchesCanonical");function K(n,e){return n.item.effectiveTsMs!==e.item.effectiveTsMs?n.item.effectiveTsMs-e.item.effectiveTsMs:n.orderSlot!==e.orderSlot?n.orderSlot<e.orderSlot?-1:1:n.generationRank!==e.generationRank?n.generationRank-e.generationRank:n.byteOffset-e.byteOffset}s(K,"compareCandidates");function Y(n,e){const t=n.candidates;if(t.length===k&&K(e,t[0])<=0)return;let r=0,i=t.length;for(;r<i;){const o=Math.floor((r+i)/2);K(t[o],e)<=0?r=o+1:i=o}t.splice(r,0,e),t.length>k&&t.shift()}s(Y,"retainCandidate");function Te(n){for(const e of n)if(e!==32&&e!==9&&e!==13)return!0;return!1}s(Te,"hasNonblank");function Ie(n){return n.generation===0?n.activeAbsolute:`${n.activeAbsolute}.${n.generation}`}s(Ie,"sourcePath");function Ce(n,e,t,r){const i=Ie(r),o=z(e,t,i,ie);if(o===void 0)return;const d=N(e,i);let f=0;const c=o.start>0;let a=!1;const l=[];if(c){const u=o.bytes.indexOf(10);if(u<0)return;f=u+1}for(;;){const u=o.bytes.indexOf(10,f);if(u<0)break;const p=Le(o.bytes.subarray(f,u));if(p===void 0||!Ne(r,p.envelope))n.invalidCanonicalLines+=1,a=!0;else if(ve(n.query,r,p)){const _=o.start+f,w={kind:"event",envelope:p.envelope,source:d,streamKey:r.streamKey,generation:r.generation,byteOffset:_,effectiveTsMs:p.effectiveTsMs,truncated:!1};l.push(w),Y(n,{item:w,orderSlot:r.streamKey,generationRank:Se[r.generation],byteOffset:_})}f=u+1}if(f<o.bytes.length&&Te(o.bytes.subarray(f))&&(n.invalidCanonicalLines+=1,a=!0),c||a)for(const u of l)u.truncated=!0}s(Ce,"scanCanonicalSource");function Ae(n,e){const t=/^(\S+)/u.exec(n)?.[1];if(t!==void 0&&ce.test(t)){const r=Date.parse(t);if(Number.isFinite(r))return r}return e}s(Ae,"rawTimestamp");function ke(n,e,t,r){return n.nodeId!==void 0&&e==="daemon"&&!t.includes(n.nodeId)||n.sinceMs!==void 0&&r<n.sinceMs||n.untilMs!==void 0&&r>n.untilMs?!1:n.pattern===void 0||t.toLocaleLowerCase("en-US").includes(n.pattern.toLocaleLowerCase("en-US"))}s(ke,"matchesRaw");function U(n,e,t,r,i){const o=z(e,t,r,oe);if(o===void 0)return;const d=N(e,r),f=o.start>0;let c=0;if(f){const a=o.bytes.indexOf(10);if(a<0)return;c=a+1}for(;;){const a=o.bytes.indexOf(10,c);if(a<0&&c===o.bytes.length)return;const l=a<0?o.bytes.length:a,u=o.bytes.subarray(c,l).toString("utf8"),p=Ae(u,o.mtimeMs);if(ke(n.query,i,u,p)){const _=o.start+c;Y(n,{item:{kind:"raw",component:i,source:d,content:u,effectiveTsMs:p,truncated:f},orderSlot:d,generationRank:2,byteOffset:_})}if(a<0)return;c=a+1}}s(U,"scanRawSource");function P(n,e,t,r){for(const i of[2,1,0])Ce(n,e,t,{...r,generation:i})}s(P,"scanCanonicalGenerations");function V(n,e,t,r,i,o){const d=S(t[t.length-1].absolute,r),f=M(e,d,t,!0);if(f===void 0)return;const c=S(d,"job"),a=M(e,c,[...t,f],!0);if(a===void 0)return;const l=[...t,f,a];i&&P(n,e,l,{component:"broker",streamKey:`broker:${r}`,activeAbsolute:S(c,"log.jsonl"),boundNodeId:r}),o&&U(n,e,l,S(c,"broker.log"),"broker")}s(V,"scanBrokerNode");function Ke(n,e){const t=we(n);if(typeof e!="boolean")throw new TypeError("includeRaw must be boolean");const r={query:t,candidates:[],invalidCanonicalLines:0},i=I(ee()),o=M(i,i,[],!0);if(o===void 0)return{items:[],invalidCanonicalLines:0};const d=[o],f=e&&t.operationId===void 0&&t.minimumLevel===void 0;v(t,"daemon")&&(P(r,i,d,{component:"daemon",streamKey:"daemon",activeAbsolute:S(i,"crtrd.log")}),f&&U(r,i,d,S(i,"crtrd.err"),"daemon"));const c=v(t,"broker"),a=f&&v(t,"broker");if(c||a){const l=I(ne()),u=M(i,l,d,!0);if(u!==void 0){const p=[o,u];t.nodeId!==void 0?V(r,i,p,t.nodeId,c,a):he(u,(_,w)=>{w&&C(_)&&V(r,i,p,_,c,a)})}}return{items:r.candidates.map(l=>l.item),invalidCanonicalLines:r.invalidCanonicalLines}}s(Ke,"readLogSnapshot");function Ye(n){const e={v:n.v,ts:n.ts,level:n.level,event:n.event,component:n.component,operation_id:n.operation_id};return n.node_id!==void 0&&(e.node_id=n.node_id),n.stream_id!==void 0&&(e.stream_id=n.stream_id),n.duration_ms!==void 0&&(e.duration_ms=n.duration_ms),n.outcome!==void 0&&(e.outcome=n.outcome),n.attempt!==void 0&&(e.attempt=n.attempt),n.error_class!==void 0&&(e.error_class=n.error_class),e}s(Ye,"projectTier1Event");export{Ye as projectTier1Event,Ke as readLogSnapshot};

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

@@ -0,0 +1,4 @@
+import type { EventEnvelope } from './types.js';
+export declare const MAX_EVENT_RECORD_BYTES = 65536;
+/** Serializes a bounded NDJSON record without its newline; appendRotatingRecord owns that byte. */
+export declare function serializeEventRecord(envelope: EventEnvelope): string;

package/dist/core/events/serialize.js

@@ -0,0 +1 @@
+var M=Object.defineProperty;var _=(e,n)=>M(e,"name",{value:n,configurable:!0});const X=65536,h=4096,N=128,O=16384,Y=4,b=64,k=5e3;function E(e){return Buffer.byteLength(e,"utf8")}_(E,"byteLength");function m(e,n){if(E(e)<=n)return{value:e,altered:!1};const i="\u2026",t=n-E(i);let r=0,d="";for(const c of e){const o=E(c);if(r+o>t)break;d+=c,r+=o}return{value:d+i,altered:!0}}_(m,"truncate");function R(e){return e===void 0?"[Unsupported undefined]":typeof e=="function"?`[Unsupported function${e.name?` ${e.name}`:""}]`:typeof e=="symbol"?`[Unsupported ${String(e)}]`:`[Unsupported ${e?.constructor?.name??typeof e}]`}_(R,"unsupported");function g(e,n,i,t){if(t.remaining<=0)return{value:"[Omitted]",altered:!0,dropped:0};if(t.remaining-=1,e===null||typeof e=="boolean")return{value:e,altered:!1,dropped:0};if(typeof e=="string"){const r=m(e,4096);return{value:r.value,altered:r.altered,dropped:0}}if(typeof e=="number")return Number.isFinite(e)?{value:e,altered:!1,dropped:0}:{value:String(e),altered:!0,dropped:0};if(typeof e=="bigint")return{value:e.toString(),altered:!0,dropped:0};if(e instanceof Date)return{value:Number.isNaN(e.getTime())?"Invalid Date":e.toISOString(),altered:!0,dropped:0};if(typeof e!="object"||e===void 0)return{value:R(e),altered:!0,dropped:0};if(i.has(e))return{value:"[Circular]",altered:!0,dropped:0};if(n>=4)return{value:"[Max depth]",altered:!0,dropped:0};i.add(e);try{if(Array.isArray(e)){const s=Math.min(e.length,64),f=[];let a=e.length>s,u=e.length-s;for(let p=0;p<s;p+=1){if(t.remaining<=0){a=!0,u+=s-p;break}const T=g(e[p],n+1,i,t);f.push(T.value),a||=T.altered,u+=T.dropped}return{value:f,altered:a,dropped:u}}let r;try{r=Object.keys(e).sort()}catch{return{value:"[Unsupported object]",altered:!0,dropped:0}}const d=r.slice(0,64),c={};let o=r.length>d.length,l=r.length-d.length;for(let s=0;s<d.length;s+=1){const f=d[s];if(t.remaining<=0){o=!0,l+=d.length-s;break}const a=m(f,128);let u;try{u=g(e[f],n+1,i,t)}catch{u={value:"[Unsupported property]",altered:!0,dropped:0}}if(Object.prototype.hasOwnProperty.call(c,a.value)){o=!0,l+=1;continue}c[a.value]=u.value,o||=a.altered||u.altered,l+=u.dropped}return{value:c,altered:o,dropped:l}}finally{i.delete(e)}}_(g,"normalize");function A(e){const n=m(String(e.type),128),i=m(String(e.message),4096),t={type:n.value,message:i.value};let r=n.altered||i.altered;if(e.stack!==void 0){const d=m(String(e.stack),16384);t.stack=d.value,r||=d.altered}if(e.cause!==void 0){const d=m(String(e.cause),4096);t.cause=d.value,r||=d.altered}return{value:t,altered:r}}_(A,"normalizeError");function y(e){return JSON.stringify(e)}_(y,"encoded");function S(e){return E(y(e))+1}_(S,"recordBytes");function D(e){const n=e.fields===void 0?void 0:g(e.fields,0,new WeakSet,{remaining:5e3}),i=e.error===void 0?void 0:A(e.error),t={v:1,ts:e.ts,level:e.level,event:e.event,component:e.component,operation_id:e.operation_id,...e.node_id===void 0?{}:{node_id:e.node_id},...e.stream_id===void 0?{}:{stream_id:e.stream_id},...e.duration_ms===void 0?{}:{duration_ms:e.duration_ms},...e.outcome===void 0?{}:{outcome:e.outcome},...e.attempt===void 0?{}:{attempt:e.attempt},...e.error_class===void 0?{}:{error_class:e.error_class},...i===void 0?{}:{error:i.value},...n===void 0?{}:{fields:n.value}},r=S(t),d=n?.altered===!0||i?.altered===!0||r>65536;let c=n?.dropped??0;for(d&&Object.assign(t,{record_truncated:!0,original_bytes:r,dropped_fields_count:c});S(t)>65536&&t.fields!==void 0;){const s=t.fields,f=Object.keys(s);if(f.length===0){delete t.fields;break}f.sort((a,u)=>{const p=E(y(s[u]))-E(y(s[a]));return p!==0?p:u<a?-1:u>a?1:0}),delete s[f[0]],c+=1,t.record_truncated=!0,t.original_bytes=r,t.dropped_fields_count=c}const o=t.error;S(t)>65536&&o?.stack!==void 0&&delete o.stack,S(t)>65536&&o?.cause!==void 0&&delete o.cause,S(t)>65536&&o!==void 0&&(o.message=m(o.message,64).value);const l=y(t);if(E(l)+1>65536)throw new RangeError("event record cannot fit within 64 KiB");return l}_(D,"serializeEventRecord");export{X as MAX_EVENT_RECORD_BYTES,D as serializeEventRecord};