@north-light/cli 0.3.561 → 0.3.562

package/dist/commands/canvas-config.js

@@ -1,2 +1,2 @@
-var v=Object.defineProperty;var a=(n,e)=>v(n,"name",{value:e,configurable:!0});import{defineBranch as h,defineLeaf as i}from"../core/command.js";import{InputError as c,readStdinRaw as k}from"../core/io.js";import{readConfig as d,updateConfig as m}from"../core/config.js";import{readSecrets as p,setRelayToken as w,deleteRelayToken as y,fingerprint as T}from"../core/secrets.js";const o="user";function f(n,e,r){const t=r.relayTokens[e.relayTokenRef];return{name:n,previewEndpoint:e.previewEndpoint,relayTokenRef:e.relayTokenRef,...e.cpOrigin?{cpOrigin:e.cpOrigin}:{},tokenStored:t!==void 0&&t!=="",...t!==void 0&&t!==""?{fingerprint:T(t)}:{}}}a(f,"maskedTarget");const R=i({name:"add",description:"register a remote canvas target (preview endpoint + relay token)",whenToUse:"wiring up a remote canvas so `node inspect` or `surface attach --canvas` can reach it \u2014 stores the preview endpoint in config.json and the raw relay token in the 0600 secrets store (never together, never persisted to config.json or logged). Re-running with the same name overwrites both.",help:{name:"canvas config add",summary:"register (or overwrite) a named remote canvas target",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name \u2014 the id every other `canvas config`/`canvas use`/`--canvas` reference uses."},{kind:"flag",name:"preview",type:"string",required:!0,constraint:"The Blaxel preview endpoint base URL (e.g. https://<hash>.preview.bl.run)."},{kind:"flag",name:"relay-token",type:"string",required:!0,constraint:"Must be exactly `-` \u2014 the raw token is read from stdin, never argv (keeps it out of shell history). Any other value is rejected."},{kind:"flag",name:"cp",type:"string",required:!1,constraint:"Optional control-plane origin, when this target has one distinct from the preview endpoint."}],output:[],outputKind:"object",effects:["Writes remoteCanvas.targets.<name> to config.json (previewEndpoint, relayTokenRef, cpOrigin).","Writes the raw token to the 0600 secrets store under relayTokenRef \u2014 never to config.json or stdout."]},run:a(async n=>{const e=n.name,r=n.preview,t=n.relayToken,s=n.cp;if(t!=="-")throw new c({error:"invalid_relay_token_arg",message:"relay token must be piped on stdin \u2014 pass `--relay-token -`",field:"relay-token",next:'Re-run with `--relay-token -` and pipe the raw token on stdin (e.g. `echo "$TOKEN" | crtr canvas config add <name> --preview <url> --relay-token -`).'});const g=(await k()).trim();if(g==="")throw new c({error:"empty_token",message:"relay token is empty",field:"relay-token",next:"Pass a non-empty token, or `--relay-token -` and pipe it on stdin."});const u={previewEndpoint:r,relayTokenRef:e,...s?{cpOrigin:s}:{}};return m(o,l=>{l.remoteCanvas.targets[e]=u}),w(e,g,o),{}},"run"),render:a(()=>"Registered remote canvas target (token stored).","render")}),b=i({name:"list",description:"list registered remote canvas targets",whenToUse:"checking which remote canvas targets exist before `canvas use`/`--canvas <name>` \u2014 never prints a raw token, only a non-reversible fingerprint.",help:{name:"canvas config list",summary:"list every registered remote canvas target (masked \u2014 no raw tokens)",output:[{name:"targets",type:"object[]",required:!0,constraint:"Each: {name, previewEndpoint, relayTokenRef, cpOrigin?, tokenStored, fingerprint?}. fingerprint is a non-reversible sha256 prefix, present only when a token is stored."}],outputKind:"object",effects:["Read-only: reads config.json and the secrets-store token presence/fingerprint (never the raw token)."]},run:a(async()=>{const n=d(o),e=p(o);return{targets:Object.entries(n.remoteCanvas.targets).map(([t,s])=>f(t,s,e))}},"run"),render:a(n=>{const e=n.targets;return e.length===0?"No remote canvas targets configured.":e.map(r=>`${r.name} \u2014 ${r.previewEndpoint} (${r.tokenStored?`token ${r.fingerprint}`:"no token stored"})`).join(`
-`)},"render")}),j=i({name:"show",description:"show one registered remote canvas target",whenToUse:"inspecting a single remote canvas target\u2019s config \u2014 masked the same way as `list`.",help:{name:"canvas config show",summary:"show one remote canvas target (masked \u2014 no raw token)",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[{name:"name",type:"string",required:!0,constraint:"The target name."},{name:"previewEndpoint",type:"string",required:!0,constraint:"The stored preview endpoint."},{name:"relayTokenRef",type:"string",required:!0,constraint:"The secrets-store key holding the token."},{name:"cpOrigin",type:"string",required:!1,constraint:"The stored control-plane origin, when this target has one distinct from the preview endpoint."},{name:"tokenStored",type:"boolean",required:!0,constraint:"Whether a token is currently stored under relayTokenRef."}],outputKind:"object",effects:["Read-only."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return f(e,t,p(o))},"run"),render:a(n=>`${n.name} \u2014 ${n.previewEndpoint} (${n.tokenStored?`token ${n.fingerprint}`:"no token stored"})`,"render")}),C=i({name:"remove",description:"remove a registered remote canvas target and its stored token",whenToUse:"decommissioning a remote canvas target \u2014 drops it from config.json and deletes its raw token from the secrets store.",help:{name:"canvas config remove",summary:"remove a remote canvas target and its stored token",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[],outputKind:"object",effects:["Deletes remoteCanvas.targets.<name> from config.json.","Deletes the stored token under relayTokenRef from the secrets store."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return m(o,s=>{delete s.remoteCanvas.targets[e]}),y(t.relayTokenRef,o),{}},"run"),render:a(()=>"Removed remote canvas target.","render")}),x=h({name:"config",description:"register/list/inspect/remove remote canvas targets",whenToUse:"setting up or auditing a remote canvas target (preview endpoint + relay token) before selecting one with `crtr canvas use`.",help:{name:"canvas config",summary:"manage named remote canvas targets",model:"A remote canvas target is a preview endpoint + a relay token registered under a name. `add` registers one (token goes to the 0600 secrets store, never config.json); `list`/`show` display masked entries (fingerprint only, never the raw token); `remove` deletes both the config entry and the stored token. Select a target for read commands with `crtr canvas use <name>`, or back to local with `crtr canvas use --local`."},children:[R,b,j,C]});export{x as canvasConfigBranch};
+var v=Object.defineProperty;var a=(n,e)=>v(n,"name",{value:e,configurable:!0});import{defineBranch as h,defineLeaf as i}from"../core/command.js";import{InputError as c,readStdinRaw as k}from"../core/io.js";import{readConfig as d,updateConfig as m}from"../core/config.js";import{readSecrets as p,setRelayToken as w,deleteRelayToken as y,fingerprint as T}from"../core/secrets.js";const o="user";function f(n,e,r){const t=r.relayTokens[e.relayTokenRef];return{name:n,previewEndpoint:e.previewEndpoint,relayTokenRef:e.relayTokenRef,...e.cpOrigin?{cpOrigin:e.cpOrigin}:{},tokenStored:t!==void 0&&t!=="",...t!==void 0&&t!==""?{fingerprint:T(t)}:{}}}a(f,"maskedTarget");const R=i({name:"add",description:"register a remote canvas target (preview endpoint + relay token)",whenToUse:"wiring up a remote canvas so `node inspect` or `surface attach --canvas` can reach it \u2014 stores the preview endpoint in config.json and the raw relay token in the 0600 secrets store (never together, never persisted to config.json or logged). Re-running with the same name overwrites both.",help:{name:"canvas config add",summary:"register (or overwrite) a named remote canvas target",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name \u2014 the id every other `canvas config`/`canvas use`/`--canvas` reference uses."},{kind:"flag",name:"preview",type:"string",required:!0,constraint:"The Blaxel preview endpoint base URL (e.g. https://<hash>.preview.bl.run)."},{kind:"flag",name:"relay-token",type:"string",required:!0,constraint:"Must be exactly `-` \u2014 the raw token is read from stdin, never argv (keeps it out of shell history). Any other value is rejected."},{kind:"flag",name:"cp",type:"string",required:!1,constraint:"Optional control-plane origin, when this target has one distinct from the preview endpoint."}],output:[],outputKind:"object",effects:["Writes remoteCanvas.targets.<name> to config.json (previewEndpoint, relayTokenRef, cpOrigin).","Writes the raw token to the 0600 secrets store under relayTokenRef \u2014 never to config.json or stdout."]},run:a(async n=>{const e=n.name,r=n.preview,t=n.relayToken,s=n.cp;if(t!=="-")throw new c({error:"invalid_relay_token_arg",message:"relay token must be piped on stdin \u2014 pass `--relay-token -`",field:"relay-token",next:'Re-run with `--relay-token -` and pipe the raw token on stdin (e.g. `echo "$TOKEN" | crtr canvas config add <name> --preview <url> --relay-token -`).'});const g=(await k()).trim();if(g==="")throw new c({error:"empty_token",message:"relay token is empty",field:"relay-token",next:"Pass a non-empty token, or `--relay-token -` and pipe it on stdin."});const u={previewEndpoint:r,relayTokenRef:e,...s?{cpOrigin:s}:{}};return await m(o,l=>{l.remoteCanvas.targets[e]=u}),w(e,g,o),{}},"run"),render:a(()=>"Registered remote canvas target (token stored).","render")}),b=i({name:"list",description:"list registered remote canvas targets",whenToUse:"checking which remote canvas targets exist before `canvas use`/`--canvas <name>` \u2014 never prints a raw token, only a non-reversible fingerprint.",help:{name:"canvas config list",summary:"list every registered remote canvas target (masked \u2014 no raw tokens)",output:[{name:"targets",type:"object[]",required:!0,constraint:"Each: {name, previewEndpoint, relayTokenRef, cpOrigin?, tokenStored, fingerprint?}. fingerprint is a non-reversible sha256 prefix, present only when a token is stored."}],outputKind:"object",effects:["Read-only: reads config.json and the secrets-store token presence/fingerprint (never the raw token)."]},run:a(async()=>{const n=d(o),e=p(o);return{targets:Object.entries(n.remoteCanvas.targets).map(([t,s])=>f(t,s,e))}},"run"),render:a(n=>{const e=n.targets;return e.length===0?"No remote canvas targets configured.":e.map(r=>`${r.name} \u2014 ${r.previewEndpoint} (${r.tokenStored?`token ${r.fingerprint}`:"no token stored"})`).join(`
+`)},"render")}),j=i({name:"show",description:"show one registered remote canvas target",whenToUse:"inspecting a single remote canvas target\u2019s config \u2014 masked the same way as `list`.",help:{name:"canvas config show",summary:"show one remote canvas target (masked \u2014 no raw token)",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[{name:"name",type:"string",required:!0,constraint:"The target name."},{name:"previewEndpoint",type:"string",required:!0,constraint:"The stored preview endpoint."},{name:"relayTokenRef",type:"string",required:!0,constraint:"The secrets-store key holding the token."},{name:"cpOrigin",type:"string",required:!1,constraint:"The stored control-plane origin, when this target has one distinct from the preview endpoint."},{name:"tokenStored",type:"boolean",required:!0,constraint:"Whether a token is currently stored under relayTokenRef."}],outputKind:"object",effects:["Read-only."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return f(e,t,p(o))},"run"),render:a(n=>`${n.name} \u2014 ${n.previewEndpoint} (${n.tokenStored?`token ${n.fingerprint}`:"no token stored"})`,"render")}),C=i({name:"remove",description:"remove a registered remote canvas target and its stored token",whenToUse:"decommissioning a remote canvas target \u2014 drops it from config.json and deletes its raw token from the secrets store.",help:{name:"canvas config remove",summary:"remove a remote canvas target and its stored token",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[],outputKind:"object",effects:["Deletes remoteCanvas.targets.<name> from config.json.","Deletes the stored token under relayTokenRef from the secrets store."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return await m(o,s=>{delete s.remoteCanvas.targets[e]}),y(t.relayTokenRef,o),{}},"run"),render:a(()=>"Removed remote canvas target.","render")}),x=h({name:"config",description:"register/list/inspect/remove remote canvas targets",whenToUse:"setting up or auditing a remote canvas target (preview endpoint + relay token) before selecting one with `crtr canvas use`.",help:{name:"canvas config",summary:"manage named remote canvas targets",model:"A remote canvas target is a preview endpoint + a relay token registered under a name. `add` registers one (token goes to the 0600 secrets store, never config.json); `list`/`show` display masked entries (fingerprint only, never the raw token); `remove` deletes both the config entry and the stored token. Select a target for read commands with `crtr canvas use <name>`, or back to local with `crtr canvas use --local`."},children:[R,b,j,C]});export{x as canvasConfigBranch};

package/dist/commands/canvas-use.js

@@ -1 +1 @@
-var i=Object.defineProperty;var r=(a,e)=>i(a,"name",{value:e,configurable:!0});import{defineLeaf as l}from"../core/command.js";import{InputError as n}from"../core/io.js";import{updateState as c}from"../core/config.js";import{getRemoteCanvasTarget as m}from"../core/remote-canvas-target.js";const s="user",h=l({name:"use",description:"select the durable default canvas for read commands (a remote target, or local)",whenToUse:"switching what remote-capable read commands such as `node inspect list/show` read from by default, without passing `--canvas <name>` on every invocation \u2014 select a remote target registered via `crtr canvas config add`, or switch back to local. A command\u2019s own `--canvas <name>` flag always overrides this for that one call.",help:{name:"canvas use",summary:"select the durable default canvas (a registered remote target, or local) for read commands",params:[{kind:"positional",name:"name",required:!1,constraint:"A remote canvas target registered via `crtr canvas config add`. Mutually exclusive with --local; exactly one of the two is required."},{kind:"flag",name:"local",type:"bool",required:!1,constraint:"Switch back to the local canvas. Mutually exclusive with <name>."}],output:[],outputKind:"object",effects:["Writes state.json\u2019s activeCanvas (user scope)."]},run:r(async a=>{const e=a.name,t=a.local===!0;if(e!==void 0&&t)throw new n({error:"ambiguous_scope",message:"<name> and --local are mutually exclusive",next:"Pass a target name to go remote, or --local to go local \u2014 not both."});if(e===void 0&&!t)throw new n({error:"missing_target",message:"nothing to select \u2014 pass a target name or --local",next:"Pass a target name (see `crtr canvas config list`) to go remote, or --local to go local."});if(t)return c(s,o=>{o.activeCanvas=null}),{};if(m(e,s)===void 0)throw new n({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`, or register one with `crtr canvas config add`."});return c(s,o=>{o.activeCanvas=e}),{}},"run"),render:r(()=>"Canvas selection updated.","render")});export{h as canvasUseLeaf};
+var i=Object.defineProperty;var r=(a,e)=>i(a,"name",{value:e,configurable:!0});import{defineLeaf as l}from"../core/command.js";import{InputError as n}from"../core/io.js";import{updateState as c}from"../core/config.js";import{getRemoteCanvasTarget as m}from"../core/remote-canvas-target.js";const s="user",h=l({name:"use",description:"select the durable default canvas for read commands (a remote target, or local)",whenToUse:"switching what remote-capable read commands such as `node inspect list/show` read from by default, without passing `--canvas <name>` on every invocation \u2014 select a remote target registered via `crtr canvas config add`, or switch back to local. A command\u2019s own `--canvas <name>` flag always overrides this for that one call.",help:{name:"canvas use",summary:"select the durable default canvas (a registered remote target, or local) for read commands",params:[{kind:"positional",name:"name",required:!1,constraint:"A remote canvas target registered via `crtr canvas config add`. Mutually exclusive with --local; exactly one of the two is required."},{kind:"flag",name:"local",type:"bool",required:!1,constraint:"Switch back to the local canvas. Mutually exclusive with <name>."}],output:[],outputKind:"object",effects:["Writes state.json\u2019s activeCanvas (user scope)."]},run:r(async a=>{const e=a.name,t=a.local===!0;if(e!==void 0&&t)throw new n({error:"ambiguous_scope",message:"<name> and --local are mutually exclusive",next:"Pass a target name to go remote, or --local to go local \u2014 not both."});if(e===void 0&&!t)throw new n({error:"missing_target",message:"nothing to select \u2014 pass a target name or --local",next:"Pass a target name (see `crtr canvas config list`) to go remote, or --local to go local."});if(t)return await c(s,o=>{o.activeCanvas=null}),{};if(m(e,s)===void 0)throw new n({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`, or register one with `crtr canvas config add`."});return await c(s,o=>{o.activeCanvas=e}),{}},"run"),render:r(()=>"Canvas selection updated.","render")});export{h as canvasUseLeaf};

package/dist/commands/human.js

@@ -1,4 +1,4 @@
-var s=Object.defineProperty;var r=(e,n)=>s(e,"name",{value:n,configurable:!0});import{defineBranch as i}from"../core/command.js";import{readConfig as m}from"../core/config.js";import{userScopeRoot as c}from"../core/scope.js";import{scopedStoreExists as h}from"../core/scoped-state/db.js";import{userStore as p}from"../core/scoped-state/paths.js";import{humanSend as u,humanShow as l}from"./human/prompts.js";import{humanList as d,humanResolve as f,humanCancel as w}from"./human/queue.js";import{humanReviewBranch as b}from"./human/review.js";import{humanFeedbackBranch as g}from"./human/feedback.js";import{humanComponents as v}from"./human/components.js";import{humanRequestBranch as k}from"./human/request.js";import{pageHelpText as x}from"./human/shared.js";function L(){const e=h(p(c()))&&m("user").page_surface,n=x(e),o=e?"human-in-the-loop decisions and structured pages":"human-in-the-loop decisions, document review, and live display",t="`request` publishes the same page with no bridge at all, for a caller that will have exited before the answer arrives: its outcome is read back or carried to a named local action.",a=e?`Tickets queue in the human inbox; nothing opens on screen. \`send\` routes completion back when the page carries response-bearing components, and publishes a standalone announcement when it does not. ${t}`:`Tickets queue in the human inbox; nothing opens on screen. \`send\` routes completion back when the page carries response-bearing components, and publishes a standalone announcement when it does not. ${t} \`review\` is for live document review with anchored comments; \`show\` is a passive tmux live-watch rather than a ticket.`;return i({name:"human",extensible:!0,rootEntry:{concept:o,desc:e?"send, components, feedback, cancel, list":"send, review new/comment, show, cancel, list",useWhen:n.rootUseWhen},help:{name:"human",summary:o,model:[a,n.brief,n.authoring,n.componentSelection.join(`
+var s=Object.defineProperty;var a=(e,n)=>s(e,"name",{value:n,configurable:!0});import{defineBranch as i}from"../core/command.js";import{readConfig as c}from"../core/config.js";import{personHasSnapshot as m}from"../core/scoped-state/person-store.js";import{humanSend as h,humanShow as p}from"./human/prompts.js";import{humanList as u,humanResolve as l,humanCancel as d}from"./human/queue.js";import{humanReviewBranch as f}from"./human/review.js";import{humanFeedbackBranch as w}from"./human/feedback.js";import{humanComponents as b}from"./human/components.js";import{humanRequestBranch as g}from"./human/request.js";import{pageHelpText as v}from"./human/shared.js";function W(){const e=m()&&c("user").page_surface,n=v(e),o=e?"human-in-the-loop decisions and structured pages":"human-in-the-loop decisions, document review, and live display",t="`request` publishes the same page with no bridge at all, for a caller that will have exited before the answer arrives: its outcome is read back or carried to a named local action.",r=e?`Tickets queue in the human inbox; nothing opens on screen. \`send\` routes completion back when the page carries response-bearing components, and publishes a standalone announcement when it does not. ${t}`:`Tickets queue in the human inbox; nothing opens on screen. \`send\` routes completion back when the page carries response-bearing components, and publishes a standalone announcement when it does not. ${t} \`review\` is for live document review with anchored comments; \`show\` is a passive tmux live-watch rather than a ticket.`;return i({name:"human",extensible:!0,rootEntry:{concept:o,desc:e?"send, components, feedback, cancel, list":"send, review new/comment, show, cancel, list",useWhen:n.rootUseWhen},help:{name:"human",summary:o,model:[r,n.brief,n.authoring,n.componentSelection.join(`
 `),"Props, response contracts, and the full component catalog: `crtr human components`; select with `crtr human components list`, then read one with `crtr human components show <component>`."].join(`
 
-`)},children:[v,u(e),...e?[]:[b],g,...e?[]:[l],k,w,d,f]})}r(L,"registerHuman");export{L as registerHuman};
+`)},children:[b,h(e),...e?[]:[f],w,...e?[]:[p],g,d,u,l]})}a(W,"registerHuman");export{W as registerHuman};

package/dist/commands/node/bash.js

@@ -1,5 +1,5 @@
-var $=Object.defineProperty;var i=(e,a)=>$(e,"name",{value:a,configurable:!0});import{envNodeId as _}from"../../shared/env.js";import{defineBranch as T,defineLeaf as c}from"../../core/command.js";import{InputError as r}from"../../core/io.js";import{ExitCode as I}from"../../types.js";import{existsSync as u,mkdirSync as q,rmSync as D,writeFileSync as f}from"node:fs";import{activeBackgroundBashJobs as E,backgroundRunningBashJobs as R,bashJobCommandLine as N,bashJobPaths as w,clearJobDeadline as B,formatBashElapsed as y,isSafeBashJobId as j,jobStartedAtMs as S,markJobQuietOk as k,newBashJobId as M,readJobPgid as L,tailJobLog as U,writeJobDeadlineMs as A}from"../../core/bash-jobs.js";import{parseDurationMs as J}from"../../core/wake.js";import{cliClient as O,getNodeOrNull as b}from"../api-client.js";import{PREVIEW_RESULT_PATH_ENV as P}from"../../core/preview-result-path.js";import{nodeInPane as C}from"../surface/node/placement.js";function m(e,a){const n=e.pane??process.env.TMUX_PANE;let o=e.node;if((o===void 0||o==="")&&(o=C(n)),(o===void 0||o==="")&&(o=_()),o===void 0||o==="")throw new r({error:"no_node",message:a,next:"Run from inside a node, pass --node <id>, or --pane <pane>."});return{id:o,pane:n}}i(m,"resolveBashTarget");const K=c({name:"run",description:"start a shell command as a background job and return at once",whenToUse:"a command needs longer than one tool call \u2014 a test lane, a build, a soak \u2014 and you should be woken with its exit code instead of waiting, backgrounding with `&`, or polling a log",tier:"normal",help:{name:"node bash run",summary:"start one shell command as a background job owned by the calling node and return before it finishes",params:[{kind:"positional",name:"command",required:!0,constraint:"The shell command, run by bash from the current directory with this process\u2019s environment. The same refusals apply as for a bash tool call, judged on this command."},{kind:"flag",name:"quiet-ok",type:"bool",required:!1,constraint:"Pass for a job that legitimately sits idle \u2014 `gh run watch`, `sleep`, waiting on a lock, a `docker build` whose work runs outside the process tree \u2014 so it gets no silence messages. Omit it for anything that should be making progress."}],output:[{name:"job_id",type:"string",required:!0,constraint:"The job object\u2019s id; read or watch it with `crtr canvas`, stop it with `node bash kill`."},{name:"log_path",type:"string",required:!0,constraint:"File receiving the command\u2019s combined stdout and stderr, capped at 10 MiB."}],outputKind:"object",effects:["Works only inside a node\u2019s bash tool call; the job belongs to the calling node.","Starts the command detached from this call, so it keeps running after the call and the turn end. A `timeout` around this leaf bounds only the launch, not the job.","Records the job as a canvas object; when the command exits, its watchers (the calling node by default) get an urgent `exited` push with the exit code and log path.","Sets no cancel deadline: the job runs to completion unless stopped with `node bash kill`.","A job whose processes use almost no CPU and write to no open file for 15 minutes messages the calling node about it, again at 30 and 60 minutes, then hourly; activity restarts the schedule and nothing is stopped. `--quiet-ok` turns these messages off.","Fails, with the job id and log path, if the job could not be recorded; the command is then running but will not message the node when it exits."]},run:i(async e=>{const a=e.command,n=_(),o=process.env.CRTR_CONTEXT_DIR;if(n===void 0||n===""||o===void 0||o==="")throw new r({error:"no_node",message:"`node bash run` starts a job for the calling node and works only inside a node\u2019s bash tool",next:"Run it from a node\u2019s bash tool call."});const s=process.cwd(),{bashCommandRefusal:d}=await import("../../core/bash-guard.js"),l=d(a,s);if(l!==null)throw new r({error:"refused",message:l,next:"Run a different command."});const t=w(o,M());q(t.dir,{recursive:!0}),f(t.cmdSh,a),f(t.jobLog,""),f(t.jobBg,""),e.quietOk===!0&&k(t);const{launchBashJobSupervisor:h}=await import("../../core/runtime/broker/bash-job-launch.js"),{[P]:g,...x}=process.env;try{await h(n,t,o,s,x)}catch(p){throw D(t.dir,{recursive:!0,force:!0}),p}const{recordBackgroundedJob:v}=await import("../../core/runtime/broker/daemon-ops.js");try{await v(n,t.jobId,{command:a,job_dir:t.dir,log_path:t.jobLog})}catch(p){throw new r({error:"job_not_recorded",message:`job ${t.jobId} is running but could not be recorded (${p.message}); it will NOT message you when it exits. Log: ${t.jobLog}`,next:`Watch it with \`tail -f ${t.jobLog}\`, or stop it with \`crtr node bash kill ${t.jobId}\`.`},I.GENERAL)}return{job_id:t.jobId,log_path:t.jobLog}},"run"),render:i(e=>`[backgrounded as job ${e.job_id}. It will interrupt you with a message when it exits. Watch: tail -f ${e.log_path} ; stop: crtr node bash kill ${e.job_id}]`,"render")}),X=c({name:"background",description:"hand the focused node\u2019s running bash command to its background job system",whenToUse:"the tmux prefix menu invokes this when a foreground bash command should stop blocking the agent immediately but keep running as a file-backed background job",tier:"hidden",help:{name:"node bash background",summary:"hand every running foreground bash command for one node to its file-backed background job system",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node whose running bash command to background. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE. The prefix menu passes this for you."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The target node."},{name:"jobs",type:"object[]",required:!0,constraint:"Per handed-off job {job_id, elapsed_ms} \u2014 the foreground elapsed time in milliseconds at the moment of handoff."}],outputKind:"object",effects:["Signals every foreground bash command currently running for the node to return from its tool call immediately while its detached supervisor keeps the command running.","Each handed-off command retains its log under the node context jobs directory and becomes a job object; when it exits, the job\u2019s watchers (its node by default) get an urgent `exited` push carrying the exit code and log path."]},run:i(async e=>{const{id:a}=m(e,"no node found for the bash handoff"),n=await b(a);if(n===null)throw new r({error:"not_found",message:`no node: ${a}`,next:"List nodes with `crtr node inspect list`."});const o=R(n.paths.context_dir),s=Date.now(),d=o.map(l=>({job_id:l.jobId,elapsed_ms:s-(S(l.jobId)??s)}));return{node_id:a,jobs:d}},"run"),render:i(e=>{const a=e.jobs;if(a.length===0)return`No foreground bash command is running for ${e.node_id}.`;const n=Math.max(...a.map(o=>o.elapsed_ms));return`Handed ${a.length} bash command(s) to the background job system for ${e.node_id} \xB7 ran ${y(n)} in the foreground.`},"render")}),W=c({name:"list",description:"list a node\u2019s live background bash jobs",whenToUse:"you need the ids, commands, and ages of your jobs that are still running",help:{name:"node bash list",summary:"read every still-running background bash job owned by one node",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node whose background jobs to list. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."},{kind:"flag",name:"tail",type:"int",required:!1,default:0,constraint:"Include this many trailing log lines per job (0 = none)."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The target node."},{name:"jobs",type:"object[]",required:!0,constraint:"Oldest-first {job_id, command, purpose, started_at, elapsed_ms, deadline_at, log_path, pgid, log_tail} for every live background job; purpose is a human-readable label or null; deadline_at is the auto-cancel time or null for a job that runs to completion."}],outputKind:"object",effects:["Reads the node context jobs directory. Changes nothing."]},run:i(async e=>{const{id:a}=m(e,"no node found for the bash job list"),n=await b(a);if(n===null)throw new r({error:"not_found",message:`no node: ${a}`,next:"List nodes with `crtr node inspect list`."});const o=Date.now(),s=Math.max(0,Math.trunc(Number(e.tail??0))),d=n.paths.context_dir,l=E(d).map(t=>({job_id:t.jobId,command:t.command,purpose:t.purpose,started_at:new Date(t.startedAtMs).toISOString(),elapsed_ms:o-t.startedAtMs,deadline_at:t.deadlineAtMs===null?null:new Date(t.deadlineAtMs).toISOString(),log_path:t.logPath,pgid:L(d,t.jobId)??null,log_tail:U(t.logPath,s)}));return{node_id:n.node_id,jobs:l}},"run"),render:i(e=>{const a=e.jobs;return a.length===0?`No background bash jobs for ${e.node_id}.`:a.map(n=>`${n.job_id} \xB7 ${y(n.elapsed_ms)} \xB7 ${N(n.command)}${n.purpose===null?"":`
+var $=Object.defineProperty;var s=(e,t)=>$(e,"name",{value:t,configurable:!0});import{envNodeId as _}from"../../shared/env.js";import{defineBranch as T,defineLeaf as c}from"../../core/command.js";import{InputError as i}from"../../core/io.js";import{ExitCode as q}from"../../types.js";import{existsSync as R,mkdirSync as E,rmSync as I,writeFileSync as f}from"node:fs";import{backgroundRunningBashJobs as D,bashJobCommandLine as N,bashJobPaths as y,formatBashElapsed as k,isSafeBashJobId as w,jobStartedAtMs as B,newBashJobId as L,tailJobLog as S}from"../../core/bash-jobs.js";import{parseDurationMs as M}from"../../core/wake.js";import{cliClient as g,getNodeOrNull as h}from"../api-client.js";import{ApiError as U}from"../../api/index.js";import{PREVIEW_RESULT_PATH_ENV as J}from"../../core/preview-result-path.js";import{nodeInPane as C}from"../surface/node/placement.js";function u(e,t){const n=e.pane??process.env.TMUX_PANE;let o=e.node;if((o===void 0||o==="")&&(o=C(n)),(o===void 0||o==="")&&(o=_()),o===void 0||o==="")throw new i({error:"no_node",message:t,next:"Run from inside a node, pass --node <id>, or --pane <pane>."});return{id:o,pane:n}}s(u,"resolveBashTarget");async function j(e,t,n){try{await g().patchBashJob(e,t,n)}catch(o){throw o instanceof U&&(o.status===404||o.status===409)?new i({error:"not_running",message:`background job ${t} for ${e} is not running`,next:"List live jobs with `crtr node bash list`."}):o}}s(j,"patchRunningJob");const A=c({name:"run",description:"start a shell command as a background job and return at once",whenToUse:"a command needs longer than one tool call \u2014 a test lane, a build, a soak \u2014 and you should be woken with its exit code instead of waiting, backgrounding with `&`, or polling a log",tier:"normal",help:{name:"node bash run",summary:"start one shell command as a background job owned by the calling node and return before it finishes",params:[{kind:"positional",name:"command",required:!0,constraint:"The shell command, run by bash from the current directory with this process\u2019s environment. The same refusals apply as for a bash tool call, judged on this command."},{kind:"flag",name:"quiet-ok",type:"bool",required:!1,constraint:"Pass for a job that legitimately sits idle \u2014 `gh run watch`, `sleep`, waiting on a lock, a `docker build` whose work runs outside the process tree \u2014 so it gets no silence messages. Omit it for anything that should be making progress."}],output:[{name:"job_id",type:"string",required:!0,constraint:"The job object\u2019s id; read or watch it with `crtr canvas`, stop it with `node bash kill`."},{name:"log_path",type:"string",required:!0,constraint:"File receiving the command\u2019s combined stdout and stderr, capped at 10 MiB."}],outputKind:"object",effects:["Works only inside a node\u2019s bash tool call; the job belongs to the calling node.","Starts the command detached from this call, so it keeps running after the call and the turn end. A `timeout` around this leaf bounds only the launch, not the job.","Records the job as a canvas object; when the command exits, its watchers (the calling node by default) get an urgent `exited` push with the exit code and log path.","Sets no cancel deadline: the job runs to completion unless stopped with `node bash kill`.","A job whose processes use almost no CPU and write to no open file for 15 minutes messages the calling node about it, again at 30 and 60 minutes, then hourly; activity restarts the schedule and nothing is stopped. `--quiet-ok` turns these messages off.","Fails, with the job id and log path, if the job could not be recorded; the command is then running but will not message the node when it exits."]},run:s(async e=>{const t=e.command,n=_(),o=process.env.CRTR_CONTEXT_DIR;if(n===void 0||n===""||o===void 0||o==="")throw new i({error:"no_node",message:"`node bash run` starts a job for the calling node and works only inside a node\u2019s bash tool",next:"Run it from a node\u2019s bash tool call."});const r=process.cwd(),{bashCommandRefusal:l}=await import("../../core/bash-guard.js"),d=l(t,r);if(d!==null)throw new i({error:"refused",message:d,next:"Run a different command."});const a=y(o,L());E(a.dir,{recursive:!0}),f(a.cmdSh,t),f(a.jobLog,""),f(a.jobBg,"");const{launchBashJobSupervisor:m}=await import("../../core/runtime/broker/bash-job-launch.js"),{[J]:b,...v}=process.env;try{await m(n,a,o,r,v)}catch(p){throw I(a.dir,{recursive:!0,force:!0}),p}const{recordBackgroundedJob:x}=await import("../../core/runtime/broker/daemon-ops.js");try{await x(n,a.jobId,{command:t}),e.quietOk===!0&&await g().patchBashJob(n,a.jobId,{quiet_ok:!0})}catch(p){throw new i({error:"job_not_recorded",message:`job ${a.jobId} is running but could not be recorded (${p.message}); it will NOT message you when it exits. Log: ${a.jobLog}`,next:`Watch it with \`tail -f ${a.jobLog}\`, or stop it with \`crtr node bash kill ${a.jobId}\`.`},q.GENERAL)}return{job_id:a.jobId,log_path:a.jobLog}},"run"),render:s(e=>`[backgrounded as job ${e.job_id}. It will interrupt you with a message when it exits. Watch: tail -f ${e.log_path} ; stop: crtr node bash kill ${e.job_id}]`,"render")}),P=c({name:"background",description:"hand the focused node\u2019s running bash command to its background job system",whenToUse:"the tmux prefix menu invokes this when a foreground bash command should stop blocking the agent immediately but keep running as a file-backed background job",tier:"hidden",help:{name:"node bash background",summary:"hand every running foreground bash command for one node to its file-backed background job system",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node whose running bash command to background. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE. The prefix menu passes this for you."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The target node."},{name:"jobs",type:"object[]",required:!0,constraint:"Per handed-off job {job_id, elapsed_ms} \u2014 the foreground elapsed time in milliseconds at the moment of handoff."}],outputKind:"object",effects:["Signals every foreground bash command currently running for the node to return from its tool call immediately while its detached supervisor keeps the command running.","Each handed-off command retains its log under the node context jobs directory and becomes a job object; when it exits, the job\u2019s watchers (its node by default) get an urgent `exited` push carrying the exit code and log path."]},run:s(async e=>{const{id:t}=u(e,"no node found for the bash handoff"),n=await h(t);if(n===null)throw new i({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const o=D(n.paths.context_dir),r=Date.now(),l=o.map(d=>({job_id:d.jobId,elapsed_ms:r-(B(d.jobId)??r)}));return{node_id:t,jobs:l}},"run"),render:s(e=>{const t=e.jobs;if(t.length===0)return`No foreground bash command is running for ${e.node_id}.`;const n=Math.max(...t.map(o=>o.elapsed_ms));return`Handed ${t.length} bash command(s) to the background job system for ${e.node_id} \xB7 ran ${k(n)} in the foreground.`},"render")}),O=c({name:"list",description:"list a node\u2019s live background bash jobs",whenToUse:"you need the ids, commands, and ages of your jobs that are still running",help:{name:"node bash list",summary:"read every still-running background bash job owned by one node",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node whose background jobs to list. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."},{kind:"flag",name:"tail",type:"int",required:!1,default:0,constraint:"Include this many trailing log lines per job (0 = none). Read from the local log file, so it is available only on the machine that runs the job; elsewhere log_tail is null."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The target node."},{name:"jobs",type:"object[]",required:!0,constraint:"Oldest-first {job_id, command, purpose, started_at, elapsed_ms, deadline_at, output_key, log_path, pgid, log_tail} for every live background job; log_path and log_tail are null when the job\u2019s log is not on this machine (a job running in a sandbox, listed from outside it), and no tail is available from here (its output is stored under output_key); purpose is a human-readable label or null; deadline_at is the auto-cancel time or null for a job that runs to completion."}],outputKind:"object",effects:["Reads the node\u2019s running job rows and, for log_tail, the local log files. Changes nothing."]},run:s(async e=>{const{id:t}=u(e,"no node found for the bash job list"),n=await h(t);if(n===null)throw new i({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const o=Date.now(),r=Math.max(0,Math.trunc(Number(e.tail??0))),l=n.paths.context_dir,d=(await g().listBashJobs(n.node_id)).map(a=>{const m=y(l,a.job_id).jobLog,b=R(m)?m:null;return{job_id:a.job_id,command:a.command,purpose:a.purpose,started_at:a.started_at,elapsed_ms:a.elapsed_ms,deadline_at:a.deadline_at,output_key:a.output_key,log_path:b,pgid:a.pgid,log_tail:b===null?null:S(b,r)}});return{node_id:n.node_id,jobs:d}},"run"),render:s(e=>{const t=e.jobs;return t.length===0?`No background bash jobs for ${e.node_id}.`:t.map(n=>`${n.job_id} \xB7 ${k(n.elapsed_ms)} \xB7 ${N(n.command)}${n.purpose===null?"":`
   purpose: ${n.purpose}`}${n.deadline_at===null?"":`
   cancels at: ${n.deadline_at}`}
-  log: ${n.log_path}`).join(`
-`)},"render")}),G=c({name:"kill",description:"stop one of a node\u2019s background bash jobs",whenToUse:"a job you started is no longer wanted or is stuck, and it should stop now",help:{name:"node bash kill",summary:"best-effort stop a background bash job and tell the owning node it was canceled",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."},{name:"signaled",type:"boolean",required:!0,constraint:"True when at least one observed supervisor-tree process received SIGTERM."}],outputKind:"object",effects:["Snapshots the supervisor\u2019s observable process tree, sends SIGTERM then SIGKILL to those processes, and cannot stop a descendant that detached and reparented before the snapshot.","Records the job\u2019s exit so it stops showing as live, and ends its job object as killed; the job\u2019s watchers (its node by default) get an urgent `killed` push."]},run:i(async e=>{const{id:a}=m(e,"no node found for the bash job"),n=await b(a);if(n===null)throw new r({error:"not_found",message:`no node: ${a}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!j(o))throw new r({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});const s=await O().stopBashJob(n.node_id,o);return{node_id:n.node_id,signaled:s.signaled}},"run"),render:i(e=>`Canceled a background bash job for ${e.node_id}${e.signaled===!0?"":" (no observed job process was still running)"}.`,"render")}),F=c({name:"quiet",description:"mark a running background bash job as an expected wait so it sends no silence messages",whenToUse:"a silence message arrived for a job that is meant to sit idle",help:{name:"node bash quiet",summary:"stop silence messages for one of a node\u2019s live background bash jobs",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list or the silence message."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."}],outputKind:"object",effects:["Writes a marker in the job\u2019s directory; the daemon sends no further silence messages for it. Signals nothing."]},run:i(async e=>{const{id:a}=m(e,"no node found for the bash job"),n=await b(a);if(n===null)throw new r({error:"not_found",message:`no node: ${a}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!j(o))throw new r({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});const s=w(n.paths.context_dir,o);if(!u(s.jobBg)||u(s.jobExit))throw new r({error:"not_running",message:`background job ${o} for ${n.node_id} is not running`,next:"List live jobs with `crtr node bash list`."});return k(s),{node_id:n.node_id}},"run"),render:i(e=>`Background job for ${e.node_id} will send no more silence messages.`,"render")}),H=c({name:"extend",description:"claim an auto-backgrounded bash job so the daemon does not cancel it at its deadline",whenToUse:"a command that was moved to a job automatically is worth keeping past its cancel deadline \u2014 give it more time with --for, or let it run to completion with --keep",help:{name:"node bash extend",summary:"move or clear the auto-cancel deadline on one of a node\u2019s live background bash jobs",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list or the auto-background notice."},{kind:"flag",name:"for",type:"string",required:!1,constraint:"New window from now before the job is canceled, as a duration (e.g. 90s, 10m, 1h30m). Mutually exclusive with --keep; give exactly one."},{kind:"flag",name:"keep",type:"bool",required:!1,constraint:"Remove the deadline entirely so the job runs to completion. Mutually exclusive with --for; give exactly one."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."},{name:"deadline_at",type:"string",required:!1,constraint:"The job\u2019s new auto-cancel time (ISO), or absent when --keep cleared the deadline so the job runs to completion."}],outputKind:"object",effects:["Rewrites or removes the job\u2019s deadline file. The daemon\u2019s deadline lane reads it on its next scan. Signals nothing."]},run:i(async e=>{const{id:a}=m(e,"no node found for the bash job"),n=await b(a);if(n===null)throw new r({error:"not_found",message:`no node: ${a}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!j(o))throw new r({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});const s=e.for,d=e.keep===!0;if(d===(s!==void 0&&s!==""))throw new r({error:"invalid_args",message:"give exactly one of --for <duration> or --keep",next:"Extend by a window with --for 10m, or drop the deadline with --keep."});const l=n.paths.context_dir,t=w(l,o);if(!u(t.dir))throw new r({error:"not_found",message:`no background job ${o} for ${n.node_id}`,next:"List live jobs with `crtr node bash list`."});if(!u(t.jobBg)||u(t.jobExit))throw new r({error:"not_running",message:`background job ${o} for ${n.node_id} is no longer running`,next:`It finished or was stopped, so there is no deadline to change. Log: ${t.jobLog}`});if(d)return B(t),{node_id:n.node_id};const h=J(s);if(h===null||h<=0)throw new r({error:"invalid_duration",message:`not a duration: ${s}`,next:"Use a value like 90s, 10m, or 1h30m."});const g=Date.now()+h;return A(t,g),{node_id:n.node_id,deadline_at:new Date(g).toISOString()}},"run"),render:i(e=>e.deadline_at===void 0?`Cleared the deadline \u2014 the background job will run to completion for ${e.node_id}.`:`Background job for ${e.node_id} will be canceled at ${e.deadline_at} unless extended again.`,"render")}),re=T({name:"bash",description:"start, list, stop, and extend your background bash jobs",whenToUse:"a command needs longer than one tool call \u2014 start it as a job and be woken with its exit code instead of using `&`, `nohup`, or a cron that polls a log \u2014 or you need to list, stop, or extend the deadline of a job you already have",help:{name:"node bash",summary:"start, list, stop, and extend background bash jobs owned by a node",model:"Every bash call runs under a detached supervisor with its output in a log file, so a command that outlives its call keeps running as a job: a canvas object its node owns, readable and watchable with `crtr canvas`. `run` starts a job on purpose and it is never auto-canceled. A job that shows no activity for 15 minutes messages its node, and is never stopped for it. A foreground command still running after 5 minutes is moved to a job automatically, with a cancel deadline unless `extend` claims it."},children:[K,X,W,G,F,H]});export{re as nodeBash};
+  ${n.log_path===null?`log: not on this machine (the job runs in a sandbox); no tail is available here, output is stored under ${n.output_key}`:`log: ${n.log_path}`}`).join(`
+`)},"render")}),K=c({name:"kill",description:"stop one of a node\u2019s background bash jobs",whenToUse:"a job you started is no longer wanted or is stuck, and it should stop now",help:{name:"node bash kill",summary:"best-effort stop a background bash job and tell the owning node it was canceled",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."},{name:"signaled",type:"boolean",required:!0,constraint:"True when at least one observed supervisor-tree process received SIGTERM."}],outputKind:"object",effects:["Snapshots the supervisor\u2019s observable process tree, sends SIGTERM then SIGKILL to those processes, and cannot stop a descendant that detached and reparented before the snapshot.","Records the job\u2019s exit so it stops showing as live, and ends its job object as killed; the job\u2019s watchers (its node by default) get an urgent `killed` push."]},run:s(async e=>{const{id:t}=u(e,"no node found for the bash job"),n=await h(t);if(n===null)throw new i({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!w(o))throw new i({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});const r=await g().stopBashJob(n.node_id,o);return{node_id:n.node_id,signaled:r.signaled}},"run"),render:s(e=>`Canceled a background bash job for ${e.node_id}${e.signaled===!0?"":" (no observed job process was still running)"}.`,"render")}),X=c({name:"quiet",description:"mark a running background bash job as an expected wait so it sends no silence messages",whenToUse:"a silence message arrived for a job that is meant to sit idle",help:{name:"node bash quiet",summary:"stop silence messages for one of a node\u2019s live background bash jobs",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list or the silence message."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."}],outputKind:"object",effects:["Marks the job\u2019s row; the daemon sends no further silence messages for it. Signals nothing."]},run:s(async e=>{const{id:t}=u(e,"no node found for the bash job"),n=await h(t);if(n===null)throw new i({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!w(o))throw new i({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});return await j(n.node_id,o,{quiet_ok:!0}),{node_id:n.node_id}},"run"),render:s(e=>`Background job for ${e.node_id} will send no more silence messages.`,"render")}),G=c({name:"extend",description:"claim an auto-backgrounded bash job so the daemon does not cancel it at its deadline",whenToUse:"a command that was moved to a job automatically is worth keeping past its cancel deadline \u2014 give it more time with --for, or let it run to completion with --keep",help:{name:"node bash extend",summary:"move or clear the auto-cancel deadline on one of a node\u2019s live background bash jobs",params:[{kind:"positional",name:"job",required:!0,constraint:"Job id, as reported by node bash list or the auto-background notice."},{kind:"flag",name:"for",type:"string",required:!1,constraint:"New window from now before the job is canceled, as a duration (e.g. 90s, 10m, 1h30m). Mutually exclusive with --keep; give exactly one."},{kind:"flag",name:"keep",type:"bool",required:!1,constraint:"Remove the deadline entirely so the job runs to completion. Mutually exclusive with --for; give exactly one."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node owning the job. Defaults to the node in --pane, else the caller (CRTR_NODE_ID)."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the target node, when --node is omitted. Defaults to $TMUX_PANE."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The owning node."},{name:"deadline_at",type:"string",required:!1,constraint:"The job\u2019s new auto-cancel time (ISO), or absent when --keep cleared the deadline so the job runs to completion."}],outputKind:"object",effects:["Rewrites or clears the deadline on the job\u2019s row. The daemon\u2019s deadline lane reads it on its next scan. Signals nothing."]},run:s(async e=>{const{id:t}=u(e,"no node found for the bash job"),n=await h(t);if(n===null)throw new i({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const o=e.job;if(!w(o))throw new i({error:"invalid_job_id",message:`invalid background job id: ${o}`,next:"Use a job id reported by `crtr node bash list`."});const r=e.for,l=e.keep===!0;if(l===(r!==void 0&&r!==""))throw new i({error:"invalid_args",message:"give exactly one of --for <duration> or --keep",next:"Extend by a window with --for 10m, or drop the deadline with --keep."});if(l)return await j(n.node_id,o,{keep:!0}),{node_id:n.node_id};const d=M(r);if(d===null||d<=0)throw new i({error:"invalid_duration",message:`not a duration: ${r}`,next:"Use a value like 90s, 10m, or 1h30m."});const a=Date.now()+d;return await j(n.node_id,o,{deadline_at_ms:a}),{node_id:n.node_id,deadline_at:new Date(a).toISOString()}},"run"),render:s(e=>e.deadline_at===void 0?`Cleared the deadline \u2014 the background job will run to completion for ${e.node_id}.`:`Background job for ${e.node_id} will be canceled at ${e.deadline_at} unless extended again.`,"render")}),ae=T({name:"bash",description:"start, list, stop, and extend your background bash jobs",whenToUse:"a command needs longer than one tool call \u2014 start it as a job and be woken with its exit code instead of using `&`, `nohup`, or a cron that polls a log \u2014 or you need to list, stop, or extend the deadline of a job you already have",help:{name:"node bash",summary:"start, list, stop, and extend background bash jobs owned by a node",model:"Every bash call runs under a detached supervisor with its output in a log file, so a command that outlives its call keeps running as a job: a canvas object its node owns, readable and watchable with `crtr canvas`. `run` starts a job on purpose and it is never auto-canceled. A job that shows no activity for 15 minutes messages its node, and is never stopped for it. A foreground command still running after 5 minutes is moved to a job automatically, with a cancel deadline unless `extend` claims it."},children:[A,P,O,K,X,G]});export{ae as nodeBash};

package/dist/commands/node/create.js

@@ -1,2 +1,2 @@
-var G=Object.defineProperty;var s=(e,n)=>G(e,"name",{value:n,configurable:!0});import{envNodeId as V}from"../../shared/env.js";import{defineLeaf as X}from"../../core/command.js";import{InputError as o}from"../../core/io.js";import{requireScope as Q}from"../../core/errors.js";import{mark as N}from"../../core/timing.js";import{OUTPUT_SCHEMA_CONSTRAINTS as Z,OUTPUT_SCHEMA_TRANSPORT as ee,parseOutputSchemaValue as te}from"../../core/runtime/structured-output.js";import{MODEL_SPEC_FORMS as oe,MODEL_SPEC_NEXT as ne}from"../../core/runtime/model-selection.js";import{parseDurationMs as re}from"../../core/wake.js";import{kindsStateBlock as ie,profilesStateBlock as ae,resolveProfileViaDaemon as se}from"../profile/daemon-profiles.js";import{cliClient as H,getNodeOrNull as de,rethrowAsCliError as $}from"../api-client.js";import{inTmux as z}from"../../core/runtime/placement-tmux.js";import{openSpawnViewer as ce}from"../surface/node/placement.js";import{randomUUID as le}from"node:crypto";import{resolve as ue}from"node:path";import{isDaemonTransportApiError as W}from"../../api/errors.js";import{ExitCode as he}from"../../types.js";const fe=1e5,B='--output-schema writes the accepted result to the node\u2019s context/result.json and pushes it as the node\u2019s final report; a node that cannot honestly satisfy the schema declines with `crtr push result --decline "<reason>" --code <token>`, which finishes it with a failure outcome (reason `declined`) whose `declined` field carries { reason, code, retryable } and no result. Name the code tokens you accept in the prompt; crouter carries the code verbatim and you validate it.',K=["A resident is told never to push a final, so the spawner gets no report wake when the work is done.","If it stops mid-task, nothing prompts it to continue.","After 15 unattended minutes it is concluded with only a deferred update, which does not wake the spawner."],J="To re-task a terminal child after its final, use `crtr node message send --reopen`; to make an existing node resident later, use `crtr node config --lifecycle resident`.",T="Do not wait, poll, or duplicate this child's assignment in your own context \u2014 there is no result to await, stopping will not strand you, and duplicated work wastes the delegated context. You're auto-subscribed, so its finish wakes you on its own. Two moves only: do other independent work right now, or stop and end your turn \u2014 the wake brings you back.";async function me(e){if(e===void 0||e==="")return T;const n=await de(e);if(n===null||n.mode!=="orchestrator")return T;const t=n.context_tokens??null;return t===null||t<fe?T:`Child spawned \u2014 you're auto-subscribed, so its finish wakes you on its own; never wait, poll, or duplicate the child's assignment in your own context. But you're an orchestrator already carrying ~${Math.round(t/1e3)}k of context: rather than hold this window open for the result, bring your document \`roadmap\` current (\`crtr doc edit roadmap\`) and \`crtr node yield\` now. Yielding ends this turn, and the child's completion then revives you fresh against your roadmap \u2014 let that clean revive absorb the result instead of this bloated context.`}s(me,"childFollowUp");function pe(e,n){throw W(e)||$(e),new o({error:"node_create_effect_unknown",message:`Node creation did not receive an acknowledgement after automatic recovery with request key ${n}; its effect is unknown.`,next:"Do not create a replacement node until the daemon is reachable and this request can be recovered."},he.NETWORK)}s(pe,"createTransportFailure");function we(){return[{kind:"stdin",name:"prompt",required:!1,constraint:"First user message."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Persona kind. Defaults to the profile's default kind; `general` when the profile has none. The <kinds> list below names every top-level installable kind."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,default:"base",constraint:"Persona mode. base for one hands-on unit; orchestrator when the unit itself needs decomposition across children. When you hold several parallel units of one kind, spawn ONE orchestrator child of that kind to own the fan-out rather than spawning the units yourself \u2014 unless you are already an orchestrator of that kind, whose job is exactly that fan-out."},{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Pin the node to this directory. Without --worktree, defaults to the spawner\u2019s directory for a managed child and the invocation directory for a root. With --worktree, selects the repository used for creation, defaulting to the invocation directory; the child runs in the new checkout."},{kind:"flag",name:"name",type:"string",required:!1,constraint:"Display name."},{kind:"flag",name:"parent",type:"string",required:!1,constraint:"Parent node id. Defaults to the calling node."},{kind:"flag",name:"node-id",type:"string",required:!1,constraint:"Exact id for the new node; lowercase letters, digits, and hyphens only, at most 128 characters. Rejected if already present."},{kind:"flag",name:"root",type:"bool",required:!1,constraint:"Spawn an independent root with no parent or subscription. Mutually exclusive with --worktree."},{kind:"flag",name:"resident",type:"bool",required:!1,constraint:"Birth the node as resident, a conversation partner for a person rather than a worker. Omit unless the user explicitly asks for a node they can talk with back and forth.",focusedHelp:{whenToUse:"Pass it ONLY when the user explicitly asks for a node they can talk with back and forth. Never infer it from task size, from expecting the user to look at the node, or from wanting to follow up later. "+J,value:"Boolean. Roots default to resident, so with --root it changes nothing. Managed children default to terminal; for a managed child the command first refuses, explains the cost, and says how to confirm.",effects:[...K,"It ends by going dormant or by being closed."]}},{kind:"flag",name:"terminal",type:"bool",required:!1,constraint:"Birth the node as terminal: it finalizes when its work is done and leaves nothing wakeable behind. Only meaningful with --root, whose default is resident; managed children are already terminal. Pass it for bounded programmatic work no one will open a viewer on. Mutually exclusive with --resident."},{kind:"flag",name:"force",type:"bool",required:!1,default:!1,hidden:!0,constraint:"Confirm a resident managed child (--resident without --root) after the user explicitly asked for one."},{kind:"flag",name:"worktree",type:"string",required:!1,constraint:"Existing local base branch for this child\u2019s managed worktree. When invoking from a managed worktree, also pass --cwd pointing at the repository\u2019s primary checkout; keep --worktree set to the desired parent branch. Mutually exclusive with --root."},{kind:"flag",name:"fork-from",type:"string",required:!1,constraint:"Fork the new node from an existing node id, absolute session path, or partial pi session uuid."},{kind:"flag",name:"model",type:"string",required:!1,constraint:"Durable model override. Omit unless the task or governing guidance requires a specific model.",focusedHelp:{whenToUse:"Use only when the user, task, or governing agent guidance already requires a specific provider, model, capability tier, or family. Omit it for routine delegation: the selected persona kind and profile own normal model selection, and review personas may enforce a quality floor.",value:`Accepted forms: ${oe}. Concrete provider/id requests must be registered. Portable provider/tier, bare-tier, and family-alias requests resolve through the configured model ladders.`,effects:["The resolved concrete model is stored on the node and in its launch recipe.","A concrete provider/id runs exactly that model on every launch and revive. A portable provider/tier, bare tier, or family alias keeps its tier: when that model's provider is rate-limited or rejects its credential, the node moves to the next model in its route: another provider's model at the same tier first, then the configured fallback tier (strong by default).","A persona quality floor may raise a weaker request before its resolved model is stored."]}},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile override. Use only when the task needs different project purview, owned documents, or environment; otherwise omit for normal inheritance or selection.",focusedHelp:{whenToUse:"Use only when the work must run under a different profile because it needs that profile\u2019s project purview, owned documents, stored environment, or defaults. Do not use it merely to change the working directory, persona kind, model, or graph ownership; those have separate parameters.",value:"Pass a profile id or name from the <profiles> list below; a close-enough name resolves to the nearest profile and the choice is reported on stderr. Omit it inside a node to inherit the caller\u2019s profile; outside a node, omission runs normal cwd-based profile selection.",effects:["The selected profile id is stored on the node and supplies its profile-scoped config, documents, environment, and injected bearings.","It does not change the parent or subscription; --cwd separately pins the working directory."]}},{kind:"flag",name:"situational-context",type:"string",required:!1,constraint:"Hidden ambient context appended to injected bearings, never visible chat."},{kind:"flag",name:"no-kickoff",type:"bool",required:!1,hidden:!0,constraint:"With --root, start the broker and session idle without a first message or model turn. Mutually exclusive with a prompt and --mode orchestrator."},{kind:"flag",name:"scopes",type:"string",required:!1,constraint:"Comma-separated scope allow-list for the node and every descendant (they inherit it and cannot widen it), e.g. `crtr:llm,crtr:act,device:shell,device:messages_read`. A provider-group call (`crtr device messages send` needs `device:messages_send`) is refused with scope_missing before any request leaves the machine when the group is absent. Must be a subset of what you hold; `crtr:act` requires `crtr:llm`. Enforced on the broker route (the node's own `crtr` calls); on an unsandboxed host a same-UID process can bypass it by calling the daemon socket directly (crouter#146), so it guards against a mistaken call, not a hostile node. Keep the list short: it travels in a request header on every device call (crouter#147)."},{kind:"flag",name:"deadline",type:"string",required:!1,constraint:"Positive, representable wall-clock duration from spawn. Grammar: one or more positive integer-unit parts; units: s, m, h, d; adjacent parts are summed. Omit for no deadline."},{kind:"flag",name:"outcome-action",type:"string",required:!1,constraint:"Declared human-action name that receives the node outcome. Grammar: 1\u2013128 ASCII letters, digits, dots, underscores, or hyphens; starts with a letter or digit. Omit when no external delivery target is needed."},{kind:"flag",name:"outcome-payload",type:"string",required:!1,constraint:"JSON value, serialized at most 64 KiB, frozen and echoed to --outcome-action. Requires --outcome-action."},{kind:"flag",name:"output-schema",type:"string",required:!1,constraint:"Replace prose completion with a schema-constrained final result. Use only when its consumer requires fixed fields.",focusedHelp:{whenToUse:"Use only when the node\u2019s consumer needs a machine-checkable final object with fixed fields. Omit it for ordinary delegation or when a prose report is enough; structured output replaces the completion protocol, and an over-constrained schema can force retries.",value:`Pass the JSON Schema the result must satisfy. ${ee} ${Z}`,effects:["The node must answer with `crtr push result` and cannot finish until the result is accepted; a plain `crtr push final` is blocked while the request is pending.",B,"The managed parent wakes through its existing subscription when the final report arrives; an independent root has no subscriber to wake.","An accepted result, or a decline, removes the request and terminates the node."]}}]}s(we,"nodeNewParams");function ye(){return[{name:"node_id",type:"string",required:!0,constraint:"New node id."},{name:"name",type:"string",required:!0,constraint:"Display name."},{name:"frozen_at",type:"string",required:!1,constraint:"Present when a managed child exists but capacity deferred its broker start."},...z()?[{name:"window",type:"string",required:!1,constraint:"tmux window id when a viewer opens."},{name:"session",type:"string",required:!1,constraint:"tmux session when a viewer opens."}]:[],{name:"follow_up",type:"string",required:!0,constraint:"Managed child: continue unrelated work or stop; its final report wakes you. Root: hand it off; no report wakes you."}]}s(ye,"nodeNewOutput");function ke(){return["Creates nodes/<id>/ in the canvas home, indexes the node in canvas.db, and starts its detached broker engine.","A managed child creates an active parent subscription; its pushes wake the parent. --root creates an independent node with spawned_by provenance and no parent subscription.","--worktree creates a managed worktree at ~/.crouter/canvas/worktrees/<node-id>/ on a new crtr/<node-id> branch.",B,"--deadline persists a wall-clock deadline from spawn; expiry cancels the node and records a failure outcome with reason deadline_exceeded.","--outcome-action registers one resolved local human-action target. When the node settles, crouter retries delivery of its outcome document until the target accepts it or permanently rejects it; --outcome-payload is frozen and echoed in that document.",...z()?["--root opens a viewer for the new node in the current tmux session."]:[]]}s(ke,"nodeNewEffects");async function ge(e){Q("crtr:act","crtr node new");const n=e.prompt??"",t=e.noKickoff===!0;if(!t&&n.trim()==="")throw new o({error:"empty_prompt",message:"a prompt is required (stdin or positional)",next:"Pipe a task on stdin or pass it as an argument, or pass --no-kickoff to spawn an idle node with none."});if(t&&n.trim()!=="")throw new o({error:"no_kickoff_with_prompt",message:"--no-kickoff cannot be combined with a prompt",field:"no-kickoff",next:"Drop --no-kickoff, or drop the prompt."});const l=e.kind,O=e.mode??"base",u=e.cwd?.trim(),h=u!==void 0&&u!==""?ue(u):void 0,S=e.name,Y=e.parent,i=e.root===!0,f=e.resident===!0,P=e.terminal===!0;if(f&&P)throw new o({error:"lifecycle_conflict",message:"--resident and --terminal cannot both be passed",field:"terminal",next:"Pass the one birth lifecycle you want, or neither to take the default (resident for --root, terminal for a managed child)."});if(f&&!i&&e.force!==!0)throw new o({error:"resident_child_requires_force",message:`--resident on a managed child makes it a conversation partner for a person, not a worker that reports back. ${K.join(" ")}`,field:"resident",next:`If the user did not explicitly ask for a node they can talk with back and forth, drop --resident; a terminal child's final report wakes you. ${J} If the user did explicitly ask for one, re-run with --force.`});const m=e.worktree;if(m!==void 0&&m.trim()==="")throw new o({error:"worktree_base_required",message:"--worktree requires a base branch",field:"worktree",next:"Pass an existing local branch that landing can fast-forward."});const p=m?.trim(),E=e.forkFrom,w=e.model?.trim();if(w==="")throw new o({error:"empty_spec",message:"a model spec is required",field:"model",next:`Run \`crtr node new --model -h\` and read the focused contract. ${ne}`});const D=e.profile,C=D===void 0?void 0:(await se(D)).id,y=e.situationalContext?.trim(),A=y!==void 0&&y!==""?y:void 0,U=te(e.outputSchema),I=U!==null?JSON.stringify(U):null,d=e.deadline;if(d!==void 0){const r=re(d),q=r===null?Number.NaN:new Date(Date.now()+r).getTime();if(r===null||!Number.isFinite(r)||r<=0||!Number.isFinite(q))throw new o({error:"invalid_deadline",message:"--deadline must be a positive representable duration",field:"deadline",next:"Pass positive integer-unit parts using s, m, h, or d."})}const k=e.outcomeAction,g=e.outcomePayload;if(g!==void 0&&k===void 0)throw new o({error:"outcome_payload_requires_action",message:"--outcome-payload requires --outcome-action",field:"outcome-payload",next:"Pass the declared delivery action with --outcome-action."});let v;if(g!==void 0)try{v=JSON.parse(g)}catch{throw new o({error:"invalid_outcome_payload",message:"--outcome-payload must be valid JSON",field:"outcome-payload",next:"Pass one valid JSON value."})}const R=e.scopes,c=R===void 0?void 0:R.split(",").map(r=>r.trim()).filter(r=>r!=="");if(c!==void 0&&c.length===0)throw new o({error:"empty_scopes",message:"--scopes names no scope",field:"scopes",next:"Pass a comma-separated list such as crtr:llm,crtr:act, or omit --scopes to inherit."});const b=e.nodeId?.trim();if(i&&p!==void 0)throw new o({error:"worktree_root_conflict",message:"--worktree is mutually exclusive with --root",field:"worktree",next:"Drop either --root or --worktree."});if(t&&!i)throw new o({error:"no_kickoff_requires_root",message:"--no-kickoff is only valid with --root",field:"no-kickoff",next:"Add --root, or drop --no-kickoff and provide a prompt."});if(t&&O==="orchestrator")throw new o({error:"no_kickoff_orchestrator_unsupported",message:"--no-kickoff cannot be combined with --mode orchestrator",field:"no-kickoff",next:"Drop --no-kickoff and provide a prompt, or spawn in base mode."});const _=V(),M=Y??_;N("node_new.create_start",{root:i});const j=le(),L={...l!==void 0?{kind:l}:{},mode:O,cwd:process.cwd(),...h!==void 0&&h!==""?{pin_cwd:h}:{},...S!==void 0?{name:S}:{},prompt:n,...i?{root:!0}:{parent:M??null},..._!==void 0?{creator:_}:{},...f?{root_lifecycle:"resident"}:{},...P?{root_lifecycle:"terminal"}:{},...p!==void 0?{worktree:p}:{},...E!==void 0?{fork_from:E}:{},...w!==void 0?{model:w}:{},...C!==void 0?{profile:C}:{},...A!==void 0?{situational_context:A}:{},...t?{no_kickoff:!0}:{},...I!==null?{output_schema:I}:{},...c!==void 0?{scopes:c}:{},...d!==void 0?{deadline:d}:{},...k!==void 0?{outcome_delivery:{action:k,...v===void 0?{}:{payload:v}}}:{},...b!==void 0&&b!==""?{node_id:b}:{},...i?{prefer_warm:!0}:{},request_key:j};let a;try{a=await H().createNode(L)}catch(r){W(r)||$(r);try{a=await H().createNode(L)}catch(q){pe(q,j)}}N("node_new.node_created",{node:a.node_id});let x={};i&&(x=ce(a.node_id,a.cwd,a.name)),i&&N("node_new.viewer_window_opened");const F=!i&&a.frozen_at!==null;return{node_id:a.node_id,name:a.name,...F?{frozen_at:a.frozen_at}:{},window:x.window,session:x.session,follow_up:i?t?"Independent root spawned idle. No kickoff turn ran; hand it off or attach and prompt it. No report wakes you.":"Independent root spawned. You are not subscribed, so its finish does not wake you; hand it off and move on.":F?"Child row exists, but no broker started because capacity (broker slots or the app's memory) is full. It is frozen and will launch when capacity frees; its final report wakes you then.":await me(M)}}s(ge,"runNodeCreation");const je=X({name:"new",description:"create and start a node immediately",whenToUse:"a unit of work is genuinely separable from what you are doing: a bounded subtask you would otherwise grind out inline, several independent units worth running in parallel (usually via one orchestrator child of the matching kind rather than a flat fan-out from you), a scouting pass over unfamiliar code, a change that wants its own git worktree, or an answer you need in a fixed shape rather than as prose",tier:"important",help:{name:"node new",summary:"create a node immediately and start its detached broker",guide:"The prompt is the child\u2019s entire brief: it wakes with this prompt, its persona, and ambient bearings \u2014 none of your conversation carries over. State the outcome and constraints. Pass an implementation plan only when it is already settled or necessary to preserve an approved decision; otherwise, let the child investigate and choose how. Give the reason along with the request: the larger goal this serves and what the child's output enables, so the child resolves ambiguity toward your intent instead of guessing. Point at every document the task depends on (a spec, an explore map, an earlier child's findings) as `[[<node-id>/<name>]]`, or `[[name]]` for a repo, profile or user document; the child reads each with `crtr canvas read` and receives nothing the prompt does not point at. Name every file or directory as an absolute host path, never `~`-relative: the child's `~` is its own HOME, not yours, and a hook cwd outside its mounts (e.g. `/tmp`) is refused. When the report must carry something specific\u2014findings inline, or pointers to documents it wrote\u2014say so in the prompt.",params:we(),output:ye(),outputKind:"object",effects:ke()},helpState:{leaf:ie,flags:{profile:ae}},run:s(e=>ge(e),"run"),render:s(e=>{const n=e.window?` in window ${e.window}`:"",t=[`Spawned "${e.name}" (${e.node_id})${n}.`];return e.session&&t.push(`- session: ${e.session}`),t.push("",String(e.follow_up)),t.join(`
-`)},"render")});export{me as childFollowUp,je as nodeNew};
+var G=Object.defineProperty;var s=(e,n)=>G(e,"name",{value:n,configurable:!0});import{envNodeId as V}from"../../shared/env.js";import{defineLeaf as X}from"../../core/command.js";import{InputError as o}from"../../core/io.js";import{requireScope as Q}from"../../core/errors.js";import{mark as N}from"../../core/timing.js";import{OUTPUT_SCHEMA_CONSTRAINTS as Z,OUTPUT_SCHEMA_TRANSPORT as ee,parseOutputSchemaValue as te}from"../../core/runtime/structured-output.js";import{MODEL_SPEC_FORMS as oe,MODEL_SPEC_NEXT as ne}from"../../core/runtime/model-selection.js";import{parseDurationMs as re}from"../../core/wake.js";import{kindsStateBlock as ie,profilesStateBlock as ae,resolveProfileViaDaemon as se}from"../profile/daemon-profiles.js";import{cliClient as H,getNodeOrNull as de,rethrowAsCliError as $}from"../api-client.js";import{inTmux as z}from"../../core/runtime/placement-tmux.js";import{openSpawnViewer as ce}from"../surface/node/placement.js";import{randomUUID as le}from"node:crypto";import{resolve as ue}from"node:path";import{isDaemonTransportApiError as W}from"../../api/errors.js";import{ExitCode as he}from"../../types.js";const fe=1e5,B='--output-schema records the accepted result on the node\u2019s structured request and pushes it as the node\u2019s final report; a node that cannot honestly satisfy the schema declines with `crtr push result --decline "<reason>" --code <token>`, which finishes it with a failure outcome (reason `declined`) whose `declined` field carries { reason, code, retryable } and no result. Name the code tokens you accept in the prompt; crouter carries the code verbatim and you validate it.',K=["A resident is told never to push a final, so the spawner gets no report wake when the work is done.","If it stops mid-task, nothing prompts it to continue.","After 15 unattended minutes it is concluded with only a deferred update, which does not wake the spawner."],J="To re-task a terminal child after its final, use `crtr node message send --reopen`; to make an existing node resident later, use `crtr node config --lifecycle resident`.",T="Do not wait, poll, or duplicate this child's assignment in your own context \u2014 there is no result to await, stopping will not strand you, and duplicated work wastes the delegated context. You're auto-subscribed, so its finish wakes you on its own. Two moves only: do other independent work right now, or stop and end your turn \u2014 the wake brings you back.";async function me(e){if(e===void 0||e==="")return T;const n=await de(e);if(n===null||n.mode!=="orchestrator")return T;const t=n.context_tokens??null;return t===null||t<fe?T:`Child spawned \u2014 you're auto-subscribed, so its finish wakes you on its own; never wait, poll, or duplicate the child's assignment in your own context. But you're an orchestrator already carrying ~${Math.round(t/1e3)}k of context: rather than hold this window open for the result, bring your document \`roadmap\` current (\`crtr doc edit roadmap\`) and \`crtr node yield\` now. Yielding ends this turn, and the child's completion then revives you fresh against your roadmap \u2014 let that clean revive absorb the result instead of this bloated context.`}s(me,"childFollowUp");function pe(e,n){throw W(e)||$(e),new o({error:"node_create_effect_unknown",message:`Node creation did not receive an acknowledgement after automatic recovery with request key ${n}; its effect is unknown.`,next:"Do not create a replacement node until the daemon is reachable and this request can be recovered."},he.NETWORK)}s(pe,"createTransportFailure");function we(){return[{kind:"stdin",name:"prompt",required:!1,constraint:"First user message."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Persona kind. Defaults to the profile's default kind; `general` when the profile has none. The <kinds> list below names every top-level installable kind."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,default:"base",constraint:"Persona mode. base for one hands-on unit; orchestrator when the unit itself needs decomposition across children. When you hold several parallel units of one kind, spawn ONE orchestrator child of that kind to own the fan-out rather than spawning the units yourself \u2014 unless you are already an orchestrator of that kind, whose job is exactly that fan-out."},{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Pin the node to this directory. Without --worktree, defaults to the spawner\u2019s directory for a managed child and the invocation directory for a root. With --worktree, selects the repository used for creation, defaulting to the invocation directory; the child runs in the new checkout."},{kind:"flag",name:"name",type:"string",required:!1,constraint:"Display name."},{kind:"flag",name:"parent",type:"string",required:!1,constraint:"Parent node id. Defaults to the calling node."},{kind:"flag",name:"node-id",type:"string",required:!1,constraint:"Exact id for the new node; lowercase letters, digits, and hyphens only, at most 128 characters. Rejected if already present."},{kind:"flag",name:"root",type:"bool",required:!1,constraint:"Spawn an independent root with no parent or subscription. Mutually exclusive with --worktree."},{kind:"flag",name:"resident",type:"bool",required:!1,constraint:"Birth the node as resident, a conversation partner for a person rather than a worker. Omit unless the user explicitly asks for a node they can talk with back and forth.",focusedHelp:{whenToUse:"Pass it ONLY when the user explicitly asks for a node they can talk with back and forth. Never infer it from task size, from expecting the user to look at the node, or from wanting to follow up later. "+J,value:"Boolean. Roots default to resident, so with --root it changes nothing. Managed children default to terminal; for a managed child the command first refuses, explains the cost, and says how to confirm.",effects:[...K,"It ends by going dormant or by being closed."]}},{kind:"flag",name:"terminal",type:"bool",required:!1,constraint:"Birth the node as terminal: it finalizes when its work is done and leaves nothing wakeable behind. Only meaningful with --root, whose default is resident; managed children are already terminal. Pass it for bounded programmatic work no one will open a viewer on. Mutually exclusive with --resident."},{kind:"flag",name:"force",type:"bool",required:!1,default:!1,hidden:!0,constraint:"Confirm a resident managed child (--resident without --root) after the user explicitly asked for one."},{kind:"flag",name:"worktree",type:"string",required:!1,constraint:"Existing local base branch for this child\u2019s managed worktree. When invoking from a managed worktree, also pass --cwd pointing at the repository\u2019s primary checkout; keep --worktree set to the desired parent branch. Mutually exclusive with --root."},{kind:"flag",name:"fork-from",type:"string",required:!1,constraint:"Fork the new node from an existing node id, absolute session path, or partial pi session uuid."},{kind:"flag",name:"model",type:"string",required:!1,constraint:"Durable model override. Omit unless the task or governing guidance requires a specific model.",focusedHelp:{whenToUse:"Use only when the user, task, or governing agent guidance already requires a specific provider, model, capability tier, or family. Omit it for routine delegation: the selected persona kind and profile own normal model selection, and review personas may enforce a quality floor.",value:`Accepted forms: ${oe}. Concrete provider/id requests must be registered. Portable provider/tier, bare-tier, and family-alias requests resolve through the configured model ladders.`,effects:["The resolved concrete model is stored on the node and in its launch recipe.","A concrete provider/id runs exactly that model on every launch and revive. A portable provider/tier, bare tier, or family alias keeps its tier: when that model's provider is rate-limited or rejects its credential, the node moves to the next model in its route: another provider's model at the same tier first, then the configured fallback tier (strong by default).","A persona quality floor may raise a weaker request before its resolved model is stored."]}},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile override. Use only when the task needs different project purview, owned documents, or environment; otherwise omit for normal inheritance or selection.",focusedHelp:{whenToUse:"Use only when the work must run under a different profile because it needs that profile\u2019s project purview, owned documents, stored environment, or defaults. Do not use it merely to change the working directory, persona kind, model, or graph ownership; those have separate parameters.",value:"Pass a profile id or name from the <profiles> list below; a close-enough name resolves to the nearest profile and the choice is reported on stderr. Omit it inside a node to inherit the caller\u2019s profile; outside a node, omission runs normal cwd-based profile selection.",effects:["The selected profile id is stored on the node and supplies its profile-scoped config, documents, environment, and injected bearings.","It does not change the parent or subscription; --cwd separately pins the working directory."]}},{kind:"flag",name:"situational-context",type:"string",required:!1,constraint:"Hidden ambient context appended to injected bearings, never visible chat."},{kind:"flag",name:"no-kickoff",type:"bool",required:!1,hidden:!0,constraint:"With --root, start the broker and session idle without a first message or model turn. Mutually exclusive with a prompt and --mode orchestrator."},{kind:"flag",name:"scopes",type:"string",required:!1,constraint:"Comma-separated scope allow-list for the node and every descendant (they inherit it and cannot widen it), e.g. `crtr:llm,crtr:act,device:shell,device:messages_read`. A provider-group call (`crtr device messages send` needs `device:messages_send`) is refused with scope_missing before any request leaves the machine when the group is absent. Must be a subset of what you hold; `crtr:act` requires `crtr:llm`. Enforced on the broker route (the node's own `crtr` calls); on an unsandboxed host a same-UID process can bypass it by calling the daemon socket directly (crouter#146), so it guards against a mistaken call, not a hostile node. Keep the list short: it travels in a request header on every device call (crouter#147)."},{kind:"flag",name:"deadline",type:"string",required:!1,constraint:"Positive, representable wall-clock duration from spawn. Grammar: one or more positive integer-unit parts; units: s, m, h, d; adjacent parts are summed. Omit for no deadline."},{kind:"flag",name:"outcome-action",type:"string",required:!1,constraint:"Declared human-action name that receives the node outcome. Grammar: 1\u2013128 ASCII letters, digits, dots, underscores, or hyphens; starts with a letter or digit. Omit when no external delivery target is needed."},{kind:"flag",name:"outcome-payload",type:"string",required:!1,constraint:"JSON value, serialized at most 64 KiB, frozen and echoed to --outcome-action. Requires --outcome-action."},{kind:"flag",name:"output-schema",type:"string",required:!1,constraint:"Replace prose completion with a schema-constrained final result. Use only when its consumer requires fixed fields.",focusedHelp:{whenToUse:"Use only when the node\u2019s consumer needs a machine-checkable final object with fixed fields. Omit it for ordinary delegation or when a prose report is enough; structured output replaces the completion protocol, and an over-constrained schema can force retries.",value:`Pass the JSON Schema the result must satisfy. ${ee} ${Z}`,effects:["The node must answer with `crtr push result` and cannot finish until the result is accepted; a plain `crtr push final` is blocked while the request is pending.",B,"The managed parent wakes through its existing subscription when the final report arrives; an independent root has no subscriber to wake.","An accepted result, or a decline, removes the request and terminates the node."]}}]}s(we,"nodeNewParams");function ye(){return[{name:"node_id",type:"string",required:!0,constraint:"New node id."},{name:"name",type:"string",required:!0,constraint:"Display name."},{name:"frozen_at",type:"string",required:!1,constraint:"Present when a managed child exists but capacity deferred its broker start."},...z()?[{name:"window",type:"string",required:!1,constraint:"tmux window id when a viewer opens."},{name:"session",type:"string",required:!1,constraint:"tmux session when a viewer opens."}]:[],{name:"follow_up",type:"string",required:!0,constraint:"Managed child: continue unrelated work or stop; its final report wakes you. Root: hand it off; no report wakes you."}]}s(ye,"nodeNewOutput");function ke(){return["Creates nodes/<id>/ in the canvas home, indexes the node in canvas.db, and starts its detached broker engine.","A managed child creates an active parent subscription; its pushes wake the parent. --root creates an independent node with spawned_by provenance and no parent subscription.","--worktree creates a managed worktree at ~/.crouter/canvas/worktrees/<node-id>/ on a new crtr/<node-id> branch.",B,"--deadline persists a wall-clock deadline from spawn; expiry cancels the node and records a failure outcome with reason deadline_exceeded.","--outcome-action registers one resolved local human-action target. When the node settles, crouter retries delivery of its outcome document until the target accepts it or permanently rejects it; --outcome-payload is frozen and echoed in that document.",...z()?["--root opens a viewer for the new node in the current tmux session."]:[]]}s(ke,"nodeNewEffects");async function ge(e){Q("crtr:act","crtr node new");const n=e.prompt??"",t=e.noKickoff===!0;if(!t&&n.trim()==="")throw new o({error:"empty_prompt",message:"a prompt is required (stdin or positional)",next:"Pipe a task on stdin or pass it as an argument, or pass --no-kickoff to spawn an idle node with none."});if(t&&n.trim()!=="")throw new o({error:"no_kickoff_with_prompt",message:"--no-kickoff cannot be combined with a prompt",field:"no-kickoff",next:"Drop --no-kickoff, or drop the prompt."});const l=e.kind,O=e.mode??"base",u=e.cwd?.trim(),h=u!==void 0&&u!==""?ue(u):void 0,S=e.name,Y=e.parent,i=e.root===!0,f=e.resident===!0,P=e.terminal===!0;if(f&&P)throw new o({error:"lifecycle_conflict",message:"--resident and --terminal cannot both be passed",field:"terminal",next:"Pass the one birth lifecycle you want, or neither to take the default (resident for --root, terminal for a managed child)."});if(f&&!i&&e.force!==!0)throw new o({error:"resident_child_requires_force",message:`--resident on a managed child makes it a conversation partner for a person, not a worker that reports back. ${K.join(" ")}`,field:"resident",next:`If the user did not explicitly ask for a node they can talk with back and forth, drop --resident; a terminal child's final report wakes you. ${J} If the user did explicitly ask for one, re-run with --force.`});const m=e.worktree;if(m!==void 0&&m.trim()==="")throw new o({error:"worktree_base_required",message:"--worktree requires a base branch",field:"worktree",next:"Pass an existing local branch that landing can fast-forward."});const p=m?.trim(),E=e.forkFrom,w=e.model?.trim();if(w==="")throw new o({error:"empty_spec",message:"a model spec is required",field:"model",next:`Run \`crtr node new --model -h\` and read the focused contract. ${ne}`});const D=e.profile,C=D===void 0?void 0:(await se(D)).id,y=e.situationalContext?.trim(),A=y!==void 0&&y!==""?y:void 0,U=te(e.outputSchema),I=U!==null?JSON.stringify(U):null,d=e.deadline;if(d!==void 0){const r=re(d),q=r===null?Number.NaN:new Date(Date.now()+r).getTime();if(r===null||!Number.isFinite(r)||r<=0||!Number.isFinite(q))throw new o({error:"invalid_deadline",message:"--deadline must be a positive representable duration",field:"deadline",next:"Pass positive integer-unit parts using s, m, h, or d."})}const k=e.outcomeAction,g=e.outcomePayload;if(g!==void 0&&k===void 0)throw new o({error:"outcome_payload_requires_action",message:"--outcome-payload requires --outcome-action",field:"outcome-payload",next:"Pass the declared delivery action with --outcome-action."});let v;if(g!==void 0)try{v=JSON.parse(g)}catch{throw new o({error:"invalid_outcome_payload",message:"--outcome-payload must be valid JSON",field:"outcome-payload",next:"Pass one valid JSON value."})}const R=e.scopes,c=R===void 0?void 0:R.split(",").map(r=>r.trim()).filter(r=>r!=="");if(c!==void 0&&c.length===0)throw new o({error:"empty_scopes",message:"--scopes names no scope",field:"scopes",next:"Pass a comma-separated list such as crtr:llm,crtr:act, or omit --scopes to inherit."});const b=e.nodeId?.trim();if(i&&p!==void 0)throw new o({error:"worktree_root_conflict",message:"--worktree is mutually exclusive with --root",field:"worktree",next:"Drop either --root or --worktree."});if(t&&!i)throw new o({error:"no_kickoff_requires_root",message:"--no-kickoff is only valid with --root",field:"no-kickoff",next:"Add --root, or drop --no-kickoff and provide a prompt."});if(t&&O==="orchestrator")throw new o({error:"no_kickoff_orchestrator_unsupported",message:"--no-kickoff cannot be combined with --mode orchestrator",field:"no-kickoff",next:"Drop --no-kickoff and provide a prompt, or spawn in base mode."});const _=V(),M=Y??_;N("node_new.create_start",{root:i});const L=le(),j={...l!==void 0?{kind:l}:{},mode:O,cwd:process.cwd(),...h!==void 0&&h!==""?{pin_cwd:h}:{},...S!==void 0?{name:S}:{},prompt:n,...i?{root:!0}:{parent:M??null},..._!==void 0?{creator:_}:{},...f?{root_lifecycle:"resident"}:{},...P?{root_lifecycle:"terminal"}:{},...p!==void 0?{worktree:p}:{},...E!==void 0?{fork_from:E}:{},...w!==void 0?{model:w}:{},...C!==void 0?{profile:C}:{},...A!==void 0?{situational_context:A}:{},...t?{no_kickoff:!0}:{},...I!==null?{output_schema:I}:{},...c!==void 0?{scopes:c}:{},...d!==void 0?{deadline:d}:{},...k!==void 0?{outcome_delivery:{action:k,...v===void 0?{}:{payload:v}}}:{},...b!==void 0&&b!==""?{node_id:b}:{},...i?{prefer_warm:!0}:{},request_key:L};let a;try{a=await H().createNode(j)}catch(r){W(r)||$(r);try{a=await H().createNode(j)}catch(q){pe(q,L)}}N("node_new.node_created",{node:a.node_id});let x={};i&&(x=ce(a.node_id,a.cwd,a.name)),i&&N("node_new.viewer_window_opened");const F=!i&&a.frozen_at!==null;return{node_id:a.node_id,name:a.name,...F?{frozen_at:a.frozen_at}:{},window:x.window,session:x.session,follow_up:i?t?"Independent root spawned idle. No kickoff turn ran; hand it off or attach and prompt it. No report wakes you.":"Independent root spawned. You are not subscribed, so its finish does not wake you; hand it off and move on.":F?"Child row exists, but no broker started because capacity (broker slots or the app's memory) is full. It is frozen and will launch when capacity frees; its final report wakes you then.":await me(M)}}s(ge,"runNodeCreation");const Le=X({name:"new",description:"create and start a node immediately",whenToUse:"a unit of work is genuinely separable from what you are doing: a bounded subtask you would otherwise grind out inline, several independent units worth running in parallel (usually via one orchestrator child of the matching kind rather than a flat fan-out from you), a scouting pass over unfamiliar code, a change that wants its own git worktree, or an answer you need in a fixed shape rather than as prose",tier:"important",help:{name:"node new",summary:"create a node immediately and start its detached broker",guide:"The prompt is the child\u2019s entire brief: it wakes with this prompt, its persona, and ambient bearings \u2014 none of your conversation carries over. State the outcome and constraints. Pass an implementation plan only when it is already settled or necessary to preserve an approved decision; otherwise, let the child investigate and choose how. Give the reason along with the request: the larger goal this serves and what the child's output enables, so the child resolves ambiguity toward your intent instead of guessing. Point at every document the task depends on (a spec, an explore map, an earlier child's findings) as `[[<node-id>/<name>]]`, or `[[name]]` for a repo, profile or user document; the child reads each with `crtr canvas read` and receives nothing the prompt does not point at. Name every file or directory as an absolute host path, never `~`-relative: the child's `~` is its own HOME, not yours, and a hook cwd outside its mounts (e.g. `/tmp`) is refused. When the report must carry something specific\u2014findings inline, or pointers to documents it wrote\u2014say so in the prompt.",params:we(),output:ye(),outputKind:"object",effects:ke()},helpState:{leaf:ie,flags:{profile:ae}},run:s(e=>ge(e),"run"),render:s(e=>{const n=e.window?` in window ${e.window}`:"",t=[`Spawned "${e.name}" (${e.node_id})${n}.`];return e.session&&t.push(`- session: ${e.session}`),t.push("",String(e.follow_up)),t.join(`
+`)},"render")});export{me as childFollowUp,Le as nodeNew};

package/dist/commands/person-settings.d.ts

@@ -0,0 +1 @@
+export declare function loadPersonSettingsViaApi(): Promise<void>;

package/dist/commands/person-settings.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var r=(t,e)=>a(t,"name",{value:e,configurable:!0});import{ApiError as p}from"../api/index.js";import{setPersonId as c}from"../core/canvas/person-state.js";import{installPersonSnapshot as f,setSettingsReloader as g,setSettingsTransport as m,SettingsRevisionConflictError as l}from"../core/scoped-state/person-store.js";import{cliClient as n}from"./api-client.js";const s=r(t=>t.snapshot,"fromDto");async function y(){const t=await n().getSettings();c(t.person),f(t.person,s(t)),g(async()=>s(await n().getSettings())),m(async(e,i)=>{try{return s(await n().putSettings({ops:i}))}catch(o){throw o instanceof p&&o.status===409?new l:o}})}r(y,"loadPersonSettingsViaApi");export{y as loadPersonSettingsViaApi};

package/dist/commands/pkg/market-manage.d.ts

@@ -6,11 +6,11 @@ export declare function addMarketplace(opts: {
     url: string;
     ref?: string;
     scope: Scope;
-}): {
+}): Promise<{
     name: string;
     scope: Scope;
     path: string;
-};
+}>;
 export declare const marketAdd: import("../../core/command.js").LeafDef;
 export declare const marketRemove: import("../../core/command.js").LeafDef;
 export declare const marketUpdate: import("../../core/command.js").LeafDef;

package/dist/commands/pkg/market-manage.js

@@ -1 +1 @@
-var J=Object.defineProperty;var m=(o,n)=>J(o,"name",{value:n,configurable:!0});import{dirname as R,join as g,relative as Q,resolve as M}from"node:path";import{renameSync as y}from"node:fs";import{defineLeaf as D}from"../../core/command.js";import{general as j,notFound as d}from"../../core/errors.js";import{listAllMarketplaces as I,listAllPlugins as W,findMarketplaceByName as w}from"../../core/resolver.js";import{resolveScopeArg as C,requireScopeRoot as S,marketplacesDir as X,pluginsDir as Y}from"../../core/scope.js";import{updateConfig as q,updateState as G,ensureScopeInitialized as Z,readConfig as ee}from"../../core/config.js";import{pathExists as $,ensureDir as L,removePath as f,isSymlink as te,nowIso as N,readSymlinkTarget as oe}from"../../core/fs-utils.js";import{clone as _,deriveNameFromUrl as ne,currentSha as K,gitSync as O,isGitRepo as E}from"../../core/git.js";import{readMarketplaceManifest as U,readPluginManifest as F}from"../../core/manifest.js";import{assertPluginCandidateValid as re,isMarketplaceRelativeSource as ae}from"./plugin-manage.js";import{resolveInstallScope as se}from"./shared.js";function ie(o){const{url:n,ref:s,scope:t}=o,i=S(t);Z(t,i);const p=ne(n),c=X(t);L(c);const l=g(c,p);$(l)&&f(l),_(n,l,{depth:1,ref:s!==void 0?s:void 0});const u=U(l);if(!u)throw f(l),d(`marketplace manifest not found at ${l}/.crouter-marketplace/marketplace.json \u2014 not a valid marketplace`);const e=u.name,r=g(c,e);e!==p&&($(r)&&f(r),y(l,r));const a=s!==void 0?s:"main";return q(t,k=>{k.marketplaces[e]={url:n,ref:a,installed_at:N()}}),{name:e,scope:t,path:r}}m(ie,"addMarketplace");const Re=D({name:"add",description:"add a marketplace by git URL",whenToUse:"registering a new marketplace source repo so its plugins appear in marketplace browse output and become installable by marketplace/plugin ref",help:{name:"pkg market add",summary:"add a marketplace by git URL",params:[{kind:"positional",name:"url",type:"string",required:!0,constraint:"Git URL of the marketplace repo."},{kind:"flag",name:"ref",type:"string",required:!1,constraint:"Git ref to track. Default: main."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Default: project if available, else user."}],output:[{name:"name",type:"string",required:!0,constraint:"Marketplace name as declared in marketplace.json."},{name:"scope",type:"string",required:!0,constraint:"Scope the marketplace was added into."},{name:"path",type:"string",required:!0,constraint:"Absolute path to the cloned marketplace directory."}],outputKind:"object",effects:["Clones the marketplace repo. Registers the marketplace in config.json."]},run:m(async o=>{const n=o.url,s=o.ref,t=o.scope;return ie({url:n,ref:s,scope:se(t)})},"run")}),je=D({name:"remove",description:"remove a marketplace",whenToUse:"unregistering a marketplace source: deletes the source clone and any plugins installed from it in the same scope",help:{name:"pkg market remove",summary:"remove a marketplace and its directory",params:[{kind:"positional",name:"name",type:"string",required:!0,constraint:"Marketplace name to remove."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Narrows resolution."}],output:[],outputKind:"object",effects:["Deletes the marketplace directory. Removes the entry from config.json. Removes plugin files and config entries sourced from that marketplace in the same scope."]},run:m(async o=>{const n=o.name,s=o.scope;let t,i;if(s!==void 0){const r=C(s);if(r!=="all"&&r!=="builtin"){const a=r,k=w(n,a);if(!k)throw d(`marketplace not found: ${n} (scope: ${a})`);t=a,i=k.root}else{const a=w(n);if(!a)throw d(`marketplace not found: ${n}`);t=a.scope,i=a.root}}else{const r=w(n);if(!r)throw d(`marketplace not found: ${n}`);t=r.scope,i=r.root}const p=t,c=S(p),l=Y(p),u=ee(p),e=[];for(const[r,a]of Object.entries(u.plugins))a.source_marketplace===n&&e.push(r);for(const r of e){const a=g(l,r);f(a)}return f(i),q(p,r=>{delete r.marketplaces[n];for(const a of e)delete r.plugins[a]}),{}},"run")});function z(o,n,s,t){try{_(o,t,{depth:1,ref:n})}catch(i){throw f(t),i}return{active:s,candidate:t,previous:`${t}.previous`}}m(z,"stageGitRoot");function ce(o){const n=[],s=[];try{for(const t of o){if($(t.previous))throw j(`prior staged backup remains at ${t.previous}`);y(t.active,t.previous),n.push(t)}for(const t of o)y(t.candidate,t.active),s.push(t)}catch(t){for(const i of[...s].reverse())y(i.active,i.candidate);for(const i of[...n].reverse())y(i.previous,i.active);throw t}for(const t of o)f(t.previous)}m(ce,"activateStagedRoots");function B(o,n,s){return{plugin:{...o,root:n,manifest:s},scopeRoot:R(R(o.root))}}m(B,"candidatePlugin");async function pe(o){const n=K(o.root)??"",s=W().filter(u=>u.scope===o.scope&&u.sourceMarketplace===o.name),t=[],i=[];let p,c;const l=[];try{if(E(o.root)){const e=g(R(o.root),`.${o.name}.${process.pid}.${Date.now()}.candidate`);c=z(o.url,o.ref,o.root,e),i.push(e);const r=U(e);if(r===null)throw d(`marketplace manifest not found in candidate checkout: ${e}/.crouter-marketplace/marketplace.json`);p=r,t.push(c)}else{const e=U(o.root);if(e===null)throw d(`marketplace manifest not found after refresh: ${o.root}/.crouter-marketplace/marketplace.json`);p=e}for(const e of s){if(te(e.root)){if(c===void 0)continue;const b=p.plugins.find(V=>V.name===e.name);if(b===void 0||!ae(b.source))throw j(`marketplace candidate removes relative-source plugin "${e.name}" while it is installed`);const T=oe(e.root);if(T===null)throw j(`installed marketplace plugin "${e.name}" has no readable symlink target`);const x=Q(o.root,M(R(e.root),T)),h=M(c.candidate,b.source);if(h!==M(c.candidate,x))throw j(`marketplace candidate moves installed relative-source plugin "${e.name}" from ${x} to ${b.source}`);if(!$(h))throw d(`marketplace candidate source path does not exist for plugin "${e.name}": ${h}`);const A=F(h);if(A===null)throw d(`plugin manifest not found in marketplace candidate: ${h}/.crouter-plugin/plugin.json`);l.push(B(e,h,A));continue}if(!$(e.root)||!E(e.root))continue;const r=O(["config","--get","remote.origin.url"],e.root).stdout.trim(),a=O(["symbolic-ref","--short","HEAD"],e.root).stdout.trim();if(r===""||a==="")continue;const k=e.scope==="project"?S("project"):S("user"),v=g(k,"tmp",`${e.name}.${process.pid}.${Date.now()}.candidate`);L(g(k,"tmp"));const H=z(r,a,e.root,v);i.push(v);const P=F(v);if(P===null)throw d(`plugin manifest not found in update candidate: ${v}/.crouter-plugin/plugin.json`);l.push(B(e,v,P)),t.push(H)}for(const e of l)await re(e.plugin.manifest,e.plugin.root,e.plugin.scope,e.scopeRoot,`${e.plugin.root}/.crouter-plugin/plugin.json`,l);ce(t),G(o.scope,e=>{e.marketplaces[o.name]===void 0&&(e.marketplaces[o.name]={}),e.marketplaces[o.name].last_updated=N()});for(const e of s){const r=p.plugins.find(a=>a.name===e.name);r?.version!==void 0&&q(e.scope,a=>{a.plugins[e.name]!==void 0&&(a.plugins[e.name].version=r.version)}),G(e.scope,a=>{a.plugins[e.name]===void 0&&(a.plugins[e.name]={}),a.plugins[e.name].last_updated=N()})}const u=K(o.root)??"";return{name:o.name,updated:n!==u,sha:u}}finally{for(const u of i)f(u)}}m(pe,"updateMarketplaceTarget");const Se=D({name:"update",description:"replace marketplace source with its latest revision",whenToUse:"refreshing one named marketplace source from git, or all registered marketplace sources when no name is given; also updates installed plugins sourced from refreshed marketplaces",help:{name:"pkg market update",summary:"refresh one or all registered marketplaces",params:[{kind:"flag",name:"name",type:"string",required:!1,constraint:"Marketplace name to update. Omit to update all registered marketplaces."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Narrows resolution."}],output:[{name:"updated",type:"object[]",required:!0,constraint:"One entry per marketplace processed: {name, updated, sha}."}],outputKind:"object",effects:["Stages and validates marketplace and sourced-plugin revisions before atomically activating them, replacing each checkout even at an unchanged revision \u2014 local modifications inside those directories are discarded. `updated` reports whether the revision moved, not whether the checkout was replaced. Updates installed plugin content/version for plugins sourced from refreshed marketplaces."]},run:m(async o=>{const n=o.name,s=o.scope,t=s===void 0?void 0:C(s),i=n===void 0?t===void 0||t==="all"?I():t==="builtin"?[]:I().filter(c=>c.scope===t):(()=>{const c=t===void 0||t==="all"||t==="builtin"?w(n):w(n,t);if(c===null)throw d(`marketplace not found: ${n}${t===void 0||t==="all"||t==="builtin"?"":` (scope: ${t})`}`);return[c]})(),p=[];for(const c of i)p.push(await pe(c));return{updated:p}},"run")});export{ie as addMarketplace,Re as marketAdd,je as marketRemove,Se as marketUpdate};
+var J=Object.defineProperty;var m=(o,n)=>J(o,"name",{value:n,configurable:!0});import{dirname as R,join as g,relative as Q,resolve as M}from"node:path";import{renameSync as y}from"node:fs";import{defineLeaf as D}from"../../core/command.js";import{general as j,notFound as d}from"../../core/errors.js";import{listAllMarketplaces as I,listAllPlugins as W,findMarketplaceByName as w}from"../../core/resolver.js";import{resolveScopeArg as C,requireScopeRoot as S,marketplacesDir as X,pluginsDir as Y}from"../../core/scope.js";import{updateConfig as q,updateState as G,ensureScopeInitialized as Z,readConfig as ee}from"../../core/config.js";import{pathExists as $,ensureDir as L,removePath as f,isSymlink as te,nowIso as N,readSymlinkTarget as oe}from"../../core/fs-utils.js";import{clone as _,deriveNameFromUrl as ne,currentSha as K,gitSync as O,isGitRepo as E}from"../../core/git.js";import{readMarketplaceManifest as U,readPluginManifest as F}from"../../core/manifest.js";import{assertPluginCandidateValid as ae,isMarketplaceRelativeSource as re}from"./plugin-manage.js";import{resolveInstallScope as se}from"./shared.js";async function ie(o){const{url:n,ref:s,scope:t}=o,i=S(t);await Z(t,i);const p=ne(n),c=X(t);L(c);const l=g(c,p);$(l)&&f(l),_(n,l,{depth:1,ref:s!==void 0?s:void 0});const u=U(l);if(!u)throw f(l),d(`marketplace manifest not found at ${l}/.crouter-marketplace/marketplace.json \u2014 not a valid marketplace`);const e=u.name,a=g(c,e);e!==p&&($(a)&&f(a),y(l,a));const r=s!==void 0?s:"main";return await q(t,k=>{k.marketplaces[e]={url:n,ref:r,installed_at:N()}}),{name:e,scope:t,path:a}}m(ie,"addMarketplace");const Re=D({name:"add",description:"add a marketplace by git URL",whenToUse:"registering a new marketplace source repo so its plugins appear in marketplace browse output and become installable by marketplace/plugin ref",help:{name:"pkg market add",summary:"add a marketplace by git URL",params:[{kind:"positional",name:"url",type:"string",required:!0,constraint:"Git URL of the marketplace repo."},{kind:"flag",name:"ref",type:"string",required:!1,constraint:"Git ref to track. Default: main."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Default: project if available, else user."}],output:[{name:"name",type:"string",required:!0,constraint:"Marketplace name as declared in marketplace.json."},{name:"scope",type:"string",required:!0,constraint:"Scope the marketplace was added into."},{name:"path",type:"string",required:!0,constraint:"Absolute path to the cloned marketplace directory."}],outputKind:"object",effects:["Clones the marketplace repo. Registers the marketplace in config.json."]},run:m(async o=>{const n=o.url,s=o.ref,t=o.scope;return ie({url:n,ref:s,scope:se(t)})},"run")}),je=D({name:"remove",description:"remove a marketplace",whenToUse:"unregistering a marketplace source: deletes the source clone and any plugins installed from it in the same scope",help:{name:"pkg market remove",summary:"remove a marketplace and its directory",params:[{kind:"positional",name:"name",type:"string",required:!0,constraint:"Marketplace name to remove."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Narrows resolution."}],output:[],outputKind:"object",effects:["Deletes the marketplace directory. Removes the entry from config.json. Removes plugin files and config entries sourced from that marketplace in the same scope."]},run:m(async o=>{const n=o.name,s=o.scope;let t,i;if(s!==void 0){const a=C(s);if(a!=="all"&&a!=="builtin"){const r=a,k=w(n,r);if(!k)throw d(`marketplace not found: ${n} (scope: ${r})`);t=r,i=k.root}else{const r=w(n);if(!r)throw d(`marketplace not found: ${n}`);t=r.scope,i=r.root}}else{const a=w(n);if(!a)throw d(`marketplace not found: ${n}`);t=a.scope,i=a.root}const p=t,c=S(p),l=Y(p),u=ee(p),e=[];for(const[a,r]of Object.entries(u.plugins))r.source_marketplace===n&&e.push(a);for(const a of e){const r=g(l,a);f(r)}return f(i),await q(p,a=>{delete a.marketplaces[n];for(const r of e)delete a.plugins[r]}),{}},"run")});function z(o,n,s,t){try{_(o,t,{depth:1,ref:n})}catch(i){throw f(t),i}return{active:s,candidate:t,previous:`${t}.previous`}}m(z,"stageGitRoot");function ce(o){const n=[],s=[];try{for(const t of o){if($(t.previous))throw j(`prior staged backup remains at ${t.previous}`);y(t.active,t.previous),n.push(t)}for(const t of o)y(t.candidate,t.active),s.push(t)}catch(t){for(const i of[...s].reverse())y(i.active,i.candidate);for(const i of[...n].reverse())y(i.previous,i.active);throw t}for(const t of o)f(t.previous)}m(ce,"activateStagedRoots");function B(o,n,s){return{plugin:{...o,root:n,manifest:s},scopeRoot:R(R(o.root))}}m(B,"candidatePlugin");async function pe(o){const n=K(o.root)??"",s=W().filter(u=>u.scope===o.scope&&u.sourceMarketplace===o.name),t=[],i=[];let p,c;const l=[];try{if(E(o.root)){const e=g(R(o.root),`.${o.name}.${process.pid}.${Date.now()}.candidate`);c=z(o.url,o.ref,o.root,e),i.push(e);const a=U(e);if(a===null)throw d(`marketplace manifest not found in candidate checkout: ${e}/.crouter-marketplace/marketplace.json`);p=a,t.push(c)}else{const e=U(o.root);if(e===null)throw d(`marketplace manifest not found after refresh: ${o.root}/.crouter-marketplace/marketplace.json`);p=e}for(const e of s){if(te(e.root)){if(c===void 0)continue;const b=p.plugins.find(V=>V.name===e.name);if(b===void 0||!re(b.source))throw j(`marketplace candidate removes relative-source plugin "${e.name}" while it is installed`);const T=oe(e.root);if(T===null)throw j(`installed marketplace plugin "${e.name}" has no readable symlink target`);const x=Q(o.root,M(R(e.root),T)),h=M(c.candidate,b.source);if(h!==M(c.candidate,x))throw j(`marketplace candidate moves installed relative-source plugin "${e.name}" from ${x} to ${b.source}`);if(!$(h))throw d(`marketplace candidate source path does not exist for plugin "${e.name}": ${h}`);const A=F(h);if(A===null)throw d(`plugin manifest not found in marketplace candidate: ${h}/.crouter-plugin/plugin.json`);l.push(B(e,h,A));continue}if(!$(e.root)||!E(e.root))continue;const a=O(["config","--get","remote.origin.url"],e.root).stdout.trim(),r=O(["symbolic-ref","--short","HEAD"],e.root).stdout.trim();if(a===""||r==="")continue;const k=e.scope==="project"?S("project"):S("user"),v=g(k,"tmp",`${e.name}.${process.pid}.${Date.now()}.candidate`);L(g(k,"tmp"));const H=z(a,r,e.root,v);i.push(v);const P=F(v);if(P===null)throw d(`plugin manifest not found in update candidate: ${v}/.crouter-plugin/plugin.json`);l.push(B(e,v,P)),t.push(H)}for(const e of l)await ae(e.plugin.manifest,e.plugin.root,e.plugin.scope,e.scopeRoot,`${e.plugin.root}/.crouter-plugin/plugin.json`,l);ce(t),await G(o.scope,e=>{e.marketplaces[o.name]===void 0&&(e.marketplaces[o.name]={}),e.marketplaces[o.name].last_updated=N()});for(const e of s){const a=p.plugins.find(r=>r.name===e.name);a?.version!==void 0&&await q(e.scope,r=>{r.plugins[e.name]!==void 0&&(r.plugins[e.name].version=a.version)}),await G(e.scope,r=>{r.plugins[e.name]===void 0&&(r.plugins[e.name]={}),r.plugins[e.name].last_updated=N()})}const u=K(o.root)??"";return{name:o.name,updated:n!==u,sha:u}}finally{for(const u of i)f(u)}}m(pe,"updateMarketplaceTarget");const Se=D({name:"update",description:"replace marketplace source with its latest revision",whenToUse:"refreshing one named marketplace source from git, or all registered marketplace sources when no name is given; also updates installed plugins sourced from refreshed marketplaces",help:{name:"pkg market update",summary:"refresh one or all registered marketplaces",params:[{kind:"flag",name:"name",type:"string",required:!1,constraint:"Marketplace name to update. Omit to update all registered marketplaces."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Narrows resolution."}],output:[{name:"updated",type:"object[]",required:!0,constraint:"One entry per marketplace processed: {name, updated, sha}."}],outputKind:"object",effects:["Stages and validates marketplace and sourced-plugin revisions before atomically activating them, replacing each checkout even at an unchanged revision \u2014 local modifications inside those directories are discarded. `updated` reports whether the revision moved, not whether the checkout was replaced. Updates installed plugin content/version for plugins sourced from refreshed marketplaces."]},run:m(async o=>{const n=o.name,s=o.scope,t=s===void 0?void 0:C(s),i=n===void 0?t===void 0||t==="all"?I():t==="builtin"?[]:I().filter(c=>c.scope===t):(()=>{const c=t===void 0||t==="all"||t==="builtin"?w(n):w(n,t);if(c===null)throw d(`marketplace not found: ${n}${t===void 0||t==="all"||t==="builtin"?"":` (scope: ${t})`}`);return[c]})(),p=[];for(const c of i)p.push(await pe(c));return{updated:p}},"run")});export{ie as addMarketplace,Re as marketAdd,je as marketRemove,Se as marketUpdate};