agent-afk 3.89.2 → 3.89.4

package/dist/index.mjs

@@ -1227,7 +1227,8 @@ Create a ship-ready summary with next steps.`,l=await a.runToResult(c);if(l.stat
 `))return{frontmatter:null,frontmatterFlags:null,body:t};let e=t.indexOf(`
 ---
 `,4);if(e===-1)return{frontmatter:null,frontmatterFlags:null,body:t};let n=t.slice(4,e),r=t.slice(e+5),o={},s=null,i=n.split(`
-`);for(let a=0;a<i.length;a++){let c=i[a];if(!c||!c.trim()||c.trimStart().startsWith("#"))continue;if(c.startsWith("flags:")){let d=c.slice(6).trim();if(d.startsWith("[")){let u=d.match(/\[(.*?)\]/);if(u?.[1]){let p=u[1].split(",").map(f=>f.trim()).filter(f=>f.length>0);p.length>0&&(s=p.map(kc).sort())}continue}if(d===""||d==="null"){let u=[];for(let p=a+1;p<i.length;p++){let f=i[p];if(!f||!f.match(/^\s+-\s/))break;let g=f.match(/^\s+-\s+(.+)/);g?.[1]&&u.push(g[1].trim())}u.length>0&&(s=u.map(kc).sort());continue}}let l=c.match(/^([a-zA-Z][a-zA-Z0-9_-]*):\s*(.*)$/);if(l&&l[1]!==void 0&&l[2]!==void 0){let d=l[2].trim().replace(/^['"]|['"]$/g,"");d.length>0&&(o[l[1]]=d)}}return{frontmatter:o,frontmatterFlags:s,body:r}}function _c(t){let e=fo(t);return e.frontmatterFlags&&e.frontmatterFlags.length>0?e.frontmatterFlags:py(e.body)}function gy(t,e){return t.length===0||t.length>64?{valid:!1,reason:`name must be 1\u201364 characters, got ${t.length}`}:/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)?t!==e?{valid:!1,reason:`name field "${t}" does not match parent directory name "${e}"`}:{valid:!0}:{valid:!1,reason:`name "${t}" does not match spec pattern ^[a-z0-9]+(-[a-z0-9]+)*$ (only lowercase a-z0-9 and hyphens, no leading/trailing/consecutive hyphens)`}}var Ac=1024;function hy(t,e){let n=fo(t);if(!n.frontmatter)return null;let r=n.frontmatter.name,o=n.frontmatter.description,s=n.body.trim();if(!r||!o||s.length===0)return null;let i=gy(r,e);if(!i.valid)return process.stderr.write(`[afk] skipping skill ${e}: ${i.reason}
+`);for(let a=0;a<i.length;a++){let c=i[a];if(!c||!c.trim()||c.trimStart().startsWith("#"))continue;if(c.startsWith("flags:")){let d=c.slice(6).trim();if(d.startsWith("[")){let u=d.match(/\[(.*?)\]/);if(u?.[1]){let p=u[1].split(",").map(f=>f.trim()).filter(f=>f.length>0);p.length>0&&(s=p.map(kc).sort())}continue}if(d===""||d==="null"){let u=[];for(let p=a+1;p<i.length;p++){let f=i[p];if(!f||!f.match(/^\s+-\s/))break;let g=f.match(/^\s+-\s+(.+)/);g?.[1]&&u.push(g[1].trim())}u.length>0&&(s=u.map(kc).sort());continue}}let l=c.match(/^([a-zA-Z][a-zA-Z0-9_-]*):\s*(.*)$/);if(l&&l[1]!==void 0&&l[2]!==void 0){let d=l[2].trim().replace(/^['"]|['"]$/g,"");d.length>0&&(o[l[1]]=d)}}return{frontmatter:o,frontmatterFlags:s,body:r}}function _c(t){let e=fo(t);if(e.frontmatterFlags&&e.frontmatterFlags.length>0)return e.frontmatterFlags;let n=e.frontmatter?.["argument-hint"]??"";return py(`${n}
+${e.body}`)}function gy(t,e){return t.length===0||t.length>64?{valid:!1,reason:`name must be 1\u201364 characters, got ${t.length}`}:/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)?t!==e?{valid:!1,reason:`name field "${t}" does not match parent directory name "${e}"`}:{valid:!0}:{valid:!1,reason:`name "${t}" does not match spec pattern ^[a-z0-9]+(-[a-z0-9]+)*$ (only lowercase a-z0-9 and hyphens, no leading/trailing/consecutive hyphens)`}}var Ac=1024;function hy(t,e){let n=fo(t);if(!n.frontmatter)return null;let r=n.frontmatter.name,o=n.frontmatter.description,s=n.body.trim();if(!r||!o||s.length===0)return null;let i=gy(r,e);if(!i.valid)return process.stderr.write(`[afk] skipping skill ${e}: ${i.reason}
 `),null;if(o.length>Ac)return process.stderr.write(`[afk] skipping skill ${e}: description exceeds ${Ac} characters (got ${o.length})
 `),null;let a=n.frontmatter["argument-hint"]??n.frontmatter.argumentHint,c=_c(t),l={name:r,description:o,body:s,dir:""};a&&a.length>0&&(l.argumentHint=a),c.length>0&&(l.flags=c);let d=n.frontmatter.context;return(d==="inline"||d==="fork"||d==="load")&&(l.context=d),l}function yy(t){return async(e,n,r)=>{let o=typeof e=="string"&&e.length>0?e:`Run the ${t.name} skill now, following the instructions in your system prompt.`,s=new N({parentAbortSignal:n?.abortSignal}),i=r?.callId;return await(await s.forkSubagent({parent:{sessionId:n?.sessionId,getInputStreamRef:n?.getInputStreamRef?.bind(n),abortSignal:n?.abortSignal},config:{model:"sonnet",systemPrompt:t.body,env:{SKILL_ROOT:t.dir},isSkillDispatch:!0},idPrefix:`user-skill-${t.name}`,...i?{parentId:i}:{}})).runToResult(o)}}function by(t,e){try{return ye(t).origin===e?t:`${e}:${t}`}catch{return t}}function Mn(t,e){let n;try{n=fy(t,{withFileTypes:!0})}catch(o){let s=o;return s.code!=="ENOENT"&&process.stderr.write(`[afk] skipping skills dir ${t}: ${s.message}
 `),0}let r=0;for(let o of n){if(!o.isDirectory()||o.name.startsWith("_")||o.name.startsWith("."))continue;let s;try{s=my(Ec(t,o.name,"SKILL.md"),"utf-8")}catch(l){let d=l;d.code!=="ENOENT"&&process.stderr.write(`[afk] skipping skill ${o.name}: ${d.message}

package/dist/telegram.mjs

@@ -1213,14 +1213,49 @@ Do not drift into open-ended exploration when the objective is concrete.
 **High agency, bounded by reversibility.**
 
 - Act without asking when intent is clear and the action is reversible.
-- Ask only when the next action depends on missing information or crosses an irreversible or shared-resource boundary.
+- Ask only when the next action depends on missing information, or when proceeding would cross an irreversible, external, or shared-resource boundary.
 - Batch independent actions into one wave; sequence dependent actions.
 - Delegate bounded sub-tasks; verify their output before relying on it.
 - Stop when further work yields diminishing returns.
 
 Rule: agentic on reversible actions, cautious on irreversible ones.
 
-## Coordinator default
+## The operating loop
+
+Each turn, run this loop:
+
+1. **Observe.** Read what is new: the latest user message, tool results, changed files or plans, and any elapsed time that matters.
+2. **Model.** Hold current world-state, objective-state, and assumption-state. If any of them is too stale for the next action, refresh it first.
+3. **Choose.** Take the smallest action that advances the objective, removes a load-bearing uncertainty, or reaches a terminal state.
+4. **Act.** Emit the action. Tool calls are the only way to affect anything outside this turn's context.
+5. **Update.** Compare result to prediction. If reality diverged, update the model before acting again.
+
+Run the loop; do not narrate it.
+
+## State model
+
+- **Context window.** Ephemeral. Gone next turn unless moved to durable storage.
+- **Memory files.** Durable across sessions. Assume nothing is there unless you wrote it or read it this turn.
+- **Plans.** Durable mid-task state across turns or sessions.
+- **Filesystem, git, external systems, message channels.** Mutable by you and by other actors between turns. Re-check after gaps.
+
+Current observation outranks memory. Anything not read this turn is inference.
+
+## Action surface
+
+Tool calls have real consequences: they persist, propagate, reach people, cost money, and some cannot be undone.
+
+The transcript is not a user channel. AFK users see bridge messages, files, commits, plans or memory you recorded, and process output they can inspect. If something must reach the user, route it through a real channel.
+
+## Constraints
+
+- **Irreversible actions require explicit recent intent.** Examples: deleting files or branches, force-pushing, dropping data, messaging third parties, calling paid APIs, or modifying shared systems.
+- **Tool schemas are authoritative.** Required fields are required. If a value is unknown, fetch it or ask. Do not guess.
+- **Do not skip Observe or Update to save tokens.** Stale-state errors cost more than the tokens saved.
+- **Parallelize independent calls; sequence dependent ones.**
+- **Re-check shared mutable state after divergence, delay, or failure.**
+
+## Delegation
 
 The main session is the coordinator. Subagents are investigators.
 
@@ -1233,11 +1268,11 @@ Default to delegation for any task that would otherwise:
 
 Stay inline for: single-file edits, localized fixes visible in <2 reads, conversational answers, explicit user requests for a direct tool call, and tasks where dispatch overhead exceeds the work.
 
-Parallelize independent subagents in one wave. Use the \`compose\` tool when dispatching related tasks with explicit dependencies \u2014 it executes a DAG of subagent nodes with parallel layers and fail-fast semantics. Nest a subagent only when a child finds a separable sub-investigation that would otherwise pollute its own context.
+When dispatching a subagent, assume zero prior context. Include objective, relevant paths, constraints, expected deliverable, and expected response length. State what not to do and when to stop. Delegate search, test, build, and verify; keep synthesis and final judgment local.
 
-Subagents return compressed findings, not raw exploration. A good subagent reply contains: answer, evidence with file:line citations, confidence, risks, recommended next action, unresolved questions, and what was not checked. If a subagent returns raw logs or wholesale file dumps, treat its result as a draft and synthesize before acting.
+Parallelize independent subagents in one wave. Use the \`compose\` tool when dispatching related tasks with explicit dependencies \u2014 it executes a DAG of subagent nodes with parallel layers and fail-fast semantics. Nest a subagent only when a child finds a separable sub-investigation that would otherwise pollute its own context.
 
-Never silently fall back to inline work after a delegation failure. State the failure and the chosen fallback before proceeding.
+Subagents return compressed findings, not raw exploration. A good subagent reply contains: answer, evidence with file:line citations, confidence, risks, recommended next action, unresolved questions, and what was not checked. Verify high-stakes output before relying on it; treat raw logs or wholesale file dumps as a draft and synthesize before acting.
 
 ## Decision commitment
 
@@ -1250,7 +1285,7 @@ When diagnosing and fixing code:
 - Prefer structural fixes when they resolve a class of bugs with small blast radius.
 - Prefer local patches when structural fixes would broaden scope or create unclear contracts.
 - State the chosen fix in one sentence, then implement and verify.
-- Ask only when the options differ materially in risk, user-facing behavior, irreversible effects, external side effects, or long-term product direction.
+- Ask only when the options differ materially in risk, user-facing behavior, irreversible or external effects, or long-term product direction.
 - Credential-sensitive means: exposing, rotating, persisting, transmitting, deleting, or altering credential sources. Passing an existing credential through an internal context is not credential-sensitive when the fix is reversible, additive, and testable.
 
 ## Skill routing hints
@@ -1264,51 +1299,6 @@ These skills fire automatically at specific points in the task lifecycle. Check
 
 Routing hints are checks, not ceremonies. Skip when the condition is trivially absent.
 
-## The operating loop
-
-Each turn, run this loop:
-
-1. **Observe.** Read what is new: the latest user message, tool results, changed files or plans, and any elapsed time that matters.
-2. **Model.** Hold current world-state, objective-state, and assumption-state. If any of them is too stale for the next action, refresh it first.
-3. **Choose.** Take the smallest action that advances the objective, removes a load-bearing uncertainty, or reaches a terminal state.
-4. **Act.** Emit the action. Tool calls are the only way to affect anything outside this turn's context.
-5. **Update.** Compare result to prediction. If reality diverged, update the model before acting again.
-
-Run the loop; do not narrate it.
-
-## State model
-
-- **Context window.** Ephemeral. Gone next turn unless moved to durable storage.
-- **Memory files.** Durable across sessions. Assume nothing is there unless you wrote it or read it this turn.
-- **Plans.** Durable mid-task state across turns or sessions.
-- **Filesystem, git, external systems, message channels.** Mutable by you and by other actors between turns. Re-check after gaps.
-
-Current observation outranks memory. Anything not read this turn is inference.
-
-## Action surface
-
-Tool calls have real consequences: edits persist, commits push, messages reach humans, API calls can cost money, and deletions may be permanent.
-
-The transcript is not a user channel. AFK users see bridge messages, files, commits, plans or memory you recorded, and process output they can inspect. If something must reach the user, route it through a real channel.
-
-## Constraints
-
-- **Irreversible actions require explicit recent intent.** Examples: deleting files or branches, force-pushing, dropping data, messaging third parties, calling paid APIs, or modifying shared systems.
-- **Tool schemas are authoritative.** Required fields are required. If a value is unknown, fetch it or ask. Do not guess.
-- **Do not skip Observe or Update to save tokens.** Stale-state errors cost more than the tokens saved.
-- **Parallelize independent calls; sequence dependent ones.**
-- **Re-check shared mutable state after divergence, delay, or failure.**
-
-## Delegation
-
-When dispatching a sub-agent:
-
-- Assume zero prior context.
-- Include objective, relevant paths, constraints, expected deliverable, and expected response length.
-- Delegate search, test, build, and verify. Keep synthesis and final judgment local.
-- State what not to do and when to stop.
-- Verify high-stakes output before acting on it.
-
 ## Priorities
 
 Ordered. Higher wins on conflict.
@@ -1401,7 +1391,8 @@ Create a ship-ready summary with next steps.`,l=await a.runToResult(c);if(l.stat
 `))return{frontmatter:null,frontmatterFlags:null,body:t};let e=t.indexOf(`
 ---
 `,4);if(e===-1)return{frontmatter:null,frontmatterFlags:null,body:t};let n=t.slice(4,e),r=t.slice(e+5),o={},s=null,i=n.split(`
-`);for(let a=0;a<i.length;a++){let c=i[a];if(!c||!c.trim()||c.trimStart().startsWith("#"))continue;if(c.startsWith("flags:")){let d=c.slice(6).trim();if(d.startsWith("[")){let u=d.match(/\[(.*?)\]/);if(u?.[1]){let p=u[1].split(",").map(m=>m.trim()).filter(m=>m.length>0);p.length>0&&(s=p.map(Vl).sort())}continue}if(d===""||d==="null"){let u=[];for(let p=a+1;p<i.length;p++){let m=i[p];if(!m||!m.match(/^\s+-\s/))break;let h=m.match(/^\s+-\s+(.+)/);h?.[1]&&u.push(h[1].trim())}u.length>0&&(s=u.map(Vl).sort());continue}}let l=c.match(/^([a-zA-Z][a-zA-Z0-9_-]*):\s*(.*)$/);if(l&&l[1]!==void 0&&l[2]!==void 0){let d=l[2].trim().replace(/^['"]|['"]$/g,"");d.length>0&&(o[l[1]]=d)}}return{frontmatter:o,frontmatterFlags:s,body:r}}function Yl(t){let e=es(t);return e.frontmatterFlags&&e.frontmatterFlags.length>0?e.frontmatterFlags:qw(e.body)}function Vw(t,e){return t.length===0||t.length>64?{valid:!1,reason:`name must be 1\u201364 characters, got ${t.length}`}:/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)?t!==e?{valid:!1,reason:`name field "${t}" does not match parent directory name "${e}"`}:{valid:!0}:{valid:!1,reason:`name "${t}" does not match spec pattern ^[a-z0-9]+(-[a-z0-9]+)*$ (only lowercase a-z0-9 and hyphens, no leading/trailing/consecutive hyphens)`}}var Ql=1024;function Yw(t,e){let n=es(t);if(!n.frontmatter)return null;let r=n.frontmatter.name,o=n.frontmatter.description,s=n.body.trim();if(!r||!o||s.length===0)return null;let i=Vw(r,e);if(!i.valid)return process.stderr.write(`[afk] skipping skill ${e}: ${i.reason}
+`);for(let a=0;a<i.length;a++){let c=i[a];if(!c||!c.trim()||c.trimStart().startsWith("#"))continue;if(c.startsWith("flags:")){let d=c.slice(6).trim();if(d.startsWith("[")){let u=d.match(/\[(.*?)\]/);if(u?.[1]){let p=u[1].split(",").map(m=>m.trim()).filter(m=>m.length>0);p.length>0&&(s=p.map(Vl).sort())}continue}if(d===""||d==="null"){let u=[];for(let p=a+1;p<i.length;p++){let m=i[p];if(!m||!m.match(/^\s+-\s/))break;let h=m.match(/^\s+-\s+(.+)/);h?.[1]&&u.push(h[1].trim())}u.length>0&&(s=u.map(Vl).sort());continue}}let l=c.match(/^([a-zA-Z][a-zA-Z0-9_-]*):\s*(.*)$/);if(l&&l[1]!==void 0&&l[2]!==void 0){let d=l[2].trim().replace(/^['"]|['"]$/g,"");d.length>0&&(o[l[1]]=d)}}return{frontmatter:o,frontmatterFlags:s,body:r}}function Yl(t){let e=es(t);if(e.frontmatterFlags&&e.frontmatterFlags.length>0)return e.frontmatterFlags;let n=e.frontmatter?.["argument-hint"]??"";return qw(`${n}
+${e.body}`)}function Vw(t,e){return t.length===0||t.length>64?{valid:!1,reason:`name must be 1\u201364 characters, got ${t.length}`}:/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)?t!==e?{valid:!1,reason:`name field "${t}" does not match parent directory name "${e}"`}:{valid:!0}:{valid:!1,reason:`name "${t}" does not match spec pattern ^[a-z0-9]+(-[a-z0-9]+)*$ (only lowercase a-z0-9 and hyphens, no leading/trailing/consecutive hyphens)`}}var Ql=1024;function Yw(t,e){let n=es(t);if(!n.frontmatter)return null;let r=n.frontmatter.name,o=n.frontmatter.description,s=n.body.trim();if(!r||!o||s.length===0)return null;let i=Vw(r,e);if(!i.valid)return process.stderr.write(`[afk] skipping skill ${e}: ${i.reason}
 `),null;if(o.length>Ql)return process.stderr.write(`[afk] skipping skill ${e}: description exceeds ${Ql} characters (got ${o.length})
 `),null;let a=n.frontmatter["argument-hint"]??n.frontmatter.argumentHint,c=Yl(t),l={name:r,description:o,body:s,dir:""};a&&a.length>0&&(l.argumentHint=a),c.length>0&&(l.flags=c);let d=n.frontmatter.context;return(d==="inline"||d==="fork"||d==="load")&&(l.context=d),l}function Xw(t){return async(e,n,r)=>{let o=typeof e=="string"&&e.length>0?e:`Run the ${t.name} skill now, following the instructions in your system prompt.`,s=new $({parentAbortSignal:n?.abortSignal}),i=r?.callId;return await(await s.forkSubagent({parent:{sessionId:n?.sessionId,getInputStreamRef:n?.getInputStreamRef?.bind(n),abortSignal:n?.abortSignal},config:{model:"sonnet",systemPrompt:t.body,env:{SKILL_ROOT:t.dir},isSkillDispatch:!0},idPrefix:`user-skill-${t.name}`,...i?{parentId:i}:{}})).runToResult(o)}}function Qw(t,e){try{return he(t).origin===e?t:`${e}:${t}`}catch{return t}}function cr(t,e){let n;try{n=zw(t,{withFileTypes:!0})}catch(o){let s=o;return s.code!=="ENOENT"&&process.stderr.write(`[afk] skipping skills dir ${t}: ${s.message}
 `),0}let r=0;for(let o of n){if(!o.isDirectory()||o.name.startsWith("_")||o.name.startsWith("."))continue;let s;try{s=Jw(Xl(t,o.name,"SKILL.md"),"utf-8")}catch(l){let d=l;d.code!=="ENOENT"&&process.stderr.write(`[afk] skipping skill ${o.name}: ${d.message}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-afk",
-  "version": "3.89.2",
+  "version": "3.89.4",
   "description": "Local-first control plane for long-running AI agent work — delegation, traces, resumable sessions, verification, and notifications.",
   "main": "dist/index.mjs",
   "type": "module",