@code-yeongyu/senpi 2026.8.18-3 → 2026.8.19

package/dist/modes/interactive/tips/catalog/dag-tips.d.ts

@@ -0,0 +1,7 @@
+export declare const DAG_TIPS: {
+    id: string;
+    bindings: never[];
+    requiresCommand: string;
+    render: () => string;
+}[];
+//# sourceMappingURL=dag-tips.d.ts.map

package/dist/modes/interactive/tips/catalog/dag-tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/dag-tips.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;;;GA+De,CAAC"}

package/dist/modes/interactive/tips/catalog/dag-tips.js

@@ -0,0 +1,57 @@
+export const DAG_TIPS = [
+    {
+        id: "dag.one-keyword-mastery",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => 'One keyword makes you a master of graph engineering: say "mass-ulw" and your work becomes a dependency graph that schedules itself.',
+    },
+    {
+        id: "dag.what-it-is",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => 'Trigger "mass-ulw" when some tasks must wait for others - describe the work, get a graph that runs in the right order.',
+    },
+    {
+        id: "dag.parallel-waves",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "A graph run executes in waves: everything with no pending dependency starts at once, the rest starts the moment it is unblocked.",
+    },
+    {
+        id: "dag.depends-on",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Say what needs what - review after implementation, docs after both - and the ordering is enforced for you.",
+    },
+    {
+        id: "dag.categories",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Each node in the graph picks its own worker category, so cheap steps stay cheap and hard steps get the strong model.",
+    },
+    {
+        id: "dag.status-view",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Use /dag to watch a run: which nodes finished, which are running, and which one failed.",
+    },
+    {
+        id: "dag.resume",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Graph runs are journaled - if the session dies mid-run it resumes later and never redoes the nodes that already finished.",
+    },
+    {
+        id: "dag.vs-parallel",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Fully independent jobs just need parallel subagents; reach for a graph when the ordering between them is the whole point.",
+    },
+    {
+        id: "dag.scale",
+        bindings: [],
+        requiresCommand: "dag",
+        render: () => "Stop hand-running steps in sequence. Describe the dependencies once and let a dozen agents fan out and rejoin on their own.",
+    },
+];
+//# sourceMappingURL=dag-tips.js.map

package/dist/modes/interactive/tips/catalog/dag-tips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/dag-tips.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,qIAAqI;KACtI;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,wHAAwH;KACzH;IACD;QACC,EAAE,EAAE,oBAAoB;QACxB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,kIAAkI;KACnI;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,4GAA4G;KAC7G;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,sHAAsH;KACvH;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,yFAAyF;KACvG;IACD;QACC,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,2HAA2H;KAC5H;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,2HAA2H;KAC5H;IACD;QACC,EAAE,EAAE,WAAW;QACf,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,GAAG,EAAE,CACZ,6HAA6H;KAC9H;CACkC,CAAC","sourcesContent":["import type { TipDefinition } from \"./types.ts\";\n\nexport const DAG_TIPS = [\n\t{\n\t\tid: \"dag.one-keyword-mastery\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t'One keyword makes you a master of graph engineering: say \"mass-ulw\" and your work becomes a dependency graph that schedules itself.',\n\t},\n\t{\n\t\tid: \"dag.what-it-is\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t'Trigger \"mass-ulw\" when some tasks must wait for others - describe the work, get a graph that runs in the right order.',\n\t},\n\t{\n\t\tid: \"dag.parallel-waves\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"A graph run executes in waves: everything with no pending dependency starts at once, the rest starts the moment it is unblocked.\",\n\t},\n\t{\n\t\tid: \"dag.depends-on\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"Say what needs what - review after implementation, docs after both - and the ordering is enforced for you.\",\n\t},\n\t{\n\t\tid: \"dag.categories\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"Each node in the graph picks its own worker category, so cheap steps stay cheap and hard steps get the strong model.\",\n\t},\n\t{\n\t\tid: \"dag.status-view\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () => \"Use /dag to watch a run: which nodes finished, which are running, and which one failed.\",\n\t},\n\t{\n\t\tid: \"dag.resume\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"Graph runs are journaled - if the session dies mid-run it resumes later and never redoes the nodes that already finished.\",\n\t},\n\t{\n\t\tid: \"dag.vs-parallel\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"Fully independent jobs just need parallel subagents; reach for a graph when the ordering between them is the whole point.\",\n\t},\n\t{\n\t\tid: \"dag.scale\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dag\",\n\t\trender: () =>\n\t\t\t\"Stop hand-running steps in sequence. Describe the dependencies once and let a dozen agents fan out and rejoin on their own.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}

package/dist/modes/interactive/tips/catalog/memory-tips.d.ts

@@ -0,0 +1,7 @@
+export declare const MEMORY_TIPS: {
+    id: string;
+    bindings: never[];
+    requiresCommand: string;
+    render: () => string;
+}[];
+//# sourceMappingURL=memory-tips.d.ts.map

package/dist/modes/interactive/tips/catalog/memory-tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/memory-tips.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;GAqGY,CAAC"}

package/dist/modes/interactive/tips/catalog/memory-tips.js

@@ -0,0 +1,100 @@
+import { APP_NAME } from "../../../../config.js";
+export const MEMORY_TIPS = [
+    {
+        id: "memory.persistent",
+        bindings: [],
+        requiresCommand: "memory",
+        render: () => `${APP_NAME} remembers across sessions. Close the terminal, come back tomorrow, and the context is still there.`,
+    },
+    {
+        id: "memory.remember-command",
+        bindings: [],
+        requiresCommand: "remember",
+        render: () => "Use /remember to save something you want kept - a preference, a decision, a fact worth reusing.",
+    },
+    {
+        id: "memory.just-tell-it",
+        bindings: [],
+        requiresCommand: "remember",
+        render: () => 'You can also just say it: "remember that we deploy on Fridays" is enough. No syntax, no file to open.',
+    },
+    {
+        id: "memory.search-command",
+        bindings: [],
+        requiresCommand: "search",
+        render: () => "Use /search to look through everything remembered so far, in plain words.",
+    },
+    {
+        id: "memory.memory-command",
+        bindings: [],
+        requiresCommand: "memory",
+        render: () => "Use /memory to see what is currently remembered about you and this project.",
+    },
+    {
+        id: "memory.init-command",
+        bindings: [],
+        requiresCommand: "init",
+        render: () => "Use /init to start memory for a new project, so it learns this codebase from the first session.",
+    },
+    {
+        id: "memory.people-command",
+        bindings: [],
+        requiresCommand: "people",
+        render: () => "Use /people to keep notes on teammates - who owns what, who to ask, what they prefer.",
+    },
+    {
+        id: "memory.reflect-command",
+        bindings: [],
+        requiresCommand: "reflect",
+        render: () => "Use /reflect to have the session reviewed now and the parts worth keeping written down.",
+    },
+    {
+        id: "memory.dream-command",
+        bindings: [],
+        requiresCommand: "dream",
+        render: () => "Memory tidies itself in the background between turns - /dream shows that work and lets you start it yourself.",
+    },
+    {
+        id: "memory.sleeptime-command",
+        bindings: [],
+        requiresCommand: "sleeptime",
+        render: () => "Use /sleeptime to decide how often memory reorganizes itself while you are not looking.",
+    },
+    {
+        id: "memory.memfs-command",
+        bindings: [],
+        requiresCommand: "memfs",
+        render: () => "Memory is plain files you own - browse them with /memfs and edit anything that looks wrong.",
+    },
+    {
+        id: "memory.repository-command",
+        bindings: [],
+        requiresCommand: "memory-repository",
+        render: () => "Every memory change is a git commit - use /memory-repository to see the history and undo a bad one.",
+    },
+    {
+        id: "memory.doctor-command",
+        bindings: [],
+        requiresCommand: "doctor",
+        render: () => "Use /doctor when memory feels off; it checks the setup and tells you what to fix.",
+    },
+    {
+        id: "memory.facts-command",
+        bindings: [],
+        requiresCommand: "facts",
+        render: () => "Use /facts to see the individual things learned about you, and drop the ones that no longer hold.",
+    },
+    {
+        id: "memory.recompile-command",
+        bindings: [],
+        requiresCommand: "recompile",
+        render: () => "Edited memory files by hand? Run /recompile so this session picks the changes up right away.",
+    },
+    {
+        id: "memory.stop-repeating",
+        bindings: [],
+        requiresCommand: "memory",
+        render: () => "Explain your setup once. Memory means you stop re-explaining it at the start of every session.",
+    },
+];
+//# sourceMappingURL=memory-tips.js.map

package/dist/modes/interactive/tips/catalog/memory-tips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/memory-tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B;QACC,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CACZ,GAAG,QAAQ,qGAAqG;KACjH;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,GAAG,EAAE,CACZ,uGAAuG;KACxG;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,2EAA2E;KACzF;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,6EAA6E;KAC3F;IACD;QACC,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,uFAAuF;KACrG;IACD;QACC,EAAE,EAAE,wBAAwB;QAC5B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,yFAAyF;KACvG;IACD;QACC,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE,GAAG,EAAE,CACZ,+GAA+G;KAChH;IACD;QACC,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,WAAW;QAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,yFAAyF;KACvG;IACD;QACC,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,6FAA6F;KAC3G;IACD;QACC,EAAE,EAAE,2BAA2B;QAC/B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,mBAAmB;QACpC,MAAM,EAAE,GAAG,EAAE,CACZ,qGAAqG;KACtG;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,mFAAmF;KACjG;IACD;QACC,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,mGAAmG;KACjH;IACD;QACC,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,WAAW;QAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,8FAA8F;KAC5G;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,gGAAgG;KAC9G;CACkC,CAAC","sourcesContent":["import { APP_NAME } from \"../../../../config.ts\";\nimport type { TipDefinition } from \"./types.ts\";\n\nexport const MEMORY_TIPS = [\n\t{\n\t\tid: \"memory.persistent\",\n\t\tbindings: [],\n\t\trequiresCommand: \"memory\",\n\t\trender: () =>\n\t\t\t`${APP_NAME} remembers across sessions. Close the terminal, come back tomorrow, and the context is still there.`,\n\t},\n\t{\n\t\tid: \"memory.remember-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"remember\",\n\t\trender: () => \"Use /remember to save something you want kept - a preference, a decision, a fact worth reusing.\",\n\t},\n\t{\n\t\tid: \"memory.just-tell-it\",\n\t\tbindings: [],\n\t\trequiresCommand: \"remember\",\n\t\trender: () =>\n\t\t\t'You can also just say it: \"remember that we deploy on Fridays\" is enough. No syntax, no file to open.',\n\t},\n\t{\n\t\tid: \"memory.search-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"search\",\n\t\trender: () => \"Use /search to look through everything remembered so far, in plain words.\",\n\t},\n\t{\n\t\tid: \"memory.memory-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"memory\",\n\t\trender: () => \"Use /memory to see what is currently remembered about you and this project.\",\n\t},\n\t{\n\t\tid: \"memory.init-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"init\",\n\t\trender: () => \"Use /init to start memory for a new project, so it learns this codebase from the first session.\",\n\t},\n\t{\n\t\tid: \"memory.people-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"people\",\n\t\trender: () => \"Use /people to keep notes on teammates - who owns what, who to ask, what they prefer.\",\n\t},\n\t{\n\t\tid: \"memory.reflect-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"reflect\",\n\t\trender: () => \"Use /reflect to have the session reviewed now and the parts worth keeping written down.\",\n\t},\n\t{\n\t\tid: \"memory.dream-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"dream\",\n\t\trender: () =>\n\t\t\t\"Memory tidies itself in the background between turns - /dream shows that work and lets you start it yourself.\",\n\t},\n\t{\n\t\tid: \"memory.sleeptime-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"sleeptime\",\n\t\trender: () => \"Use /sleeptime to decide how often memory reorganizes itself while you are not looking.\",\n\t},\n\t{\n\t\tid: \"memory.memfs-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"memfs\",\n\t\trender: () => \"Memory is plain files you own - browse them with /memfs and edit anything that looks wrong.\",\n\t},\n\t{\n\t\tid: \"memory.repository-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"memory-repository\",\n\t\trender: () =>\n\t\t\t\"Every memory change is a git commit - use /memory-repository to see the history and undo a bad one.\",\n\t},\n\t{\n\t\tid: \"memory.doctor-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"doctor\",\n\t\trender: () => \"Use /doctor when memory feels off; it checks the setup and tells you what to fix.\",\n\t},\n\t{\n\t\tid: \"memory.facts-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"facts\",\n\t\trender: () => \"Use /facts to see the individual things learned about you, and drop the ones that no longer hold.\",\n\t},\n\t{\n\t\tid: \"memory.recompile-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"recompile\",\n\t\trender: () => \"Edited memory files by hand? Run /recompile so this session picks the changes up right away.\",\n\t},\n\t{\n\t\tid: \"memory.stop-repeating\",\n\t\tbindings: [],\n\t\trequiresCommand: \"memory\",\n\t\trender: () => \"Explain your setup once. Memory means you stop re-explaining it at the start of every session.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}

package/dist/modes/interactive/tips/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/tips/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EASnD,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/tips/registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAWnD,CAAC"}

package/dist/modes/interactive/tips/registry.js

@@ -1,6 +1,8 @@
 import { CLI_TIPS } from "./catalog/cli-tips.js";
+import { DAG_TIPS } from "./catalog/dag-tips.js";
 import { ETHOS_TIPS } from "./catalog/ethos-tips.js";
 import { INPUT_TIPS } from "./catalog/input-tips.js";
+import { MEMORY_TIPS } from "./catalog/memory-tips.js";
 import { MODEL_TIPS } from "./catalog/model-tips.js";
 import { SESSION_TIPS } from "./catalog/session-tips.js";
 import { SETTINGS_TIPS } from "./catalog/settings-tips.js";
@@ -14,6 +16,8 @@ export const TIP_DEFINITIONS = [
     ...SETTINGS_TIPS,
     ...CLI_TIPS,
     ...SUBAGENT_TIPS,
+    ...MEMORY_TIPS,
+    ...DAG_TIPS,
     ...ETHOS_TIPS,
 ];
 //# sourceMappingURL=registry.js.map

package/dist/modes/interactive/tips/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/modes/interactive/tips/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,CAAC,MAAM,eAAe,GAA6B;IACxD,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,aAAa;IAChB,GAAG,UAAU;CACb,CAAC","sourcesContent":["import { CLI_TIPS } from \"./catalog/cli-tips.ts\";\nimport { ETHOS_TIPS } from \"./catalog/ethos-tips.ts\";\nimport { INPUT_TIPS } from \"./catalog/input-tips.ts\";\nimport { MODEL_TIPS } from \"./catalog/model-tips.ts\";\nimport { SESSION_TIPS } from \"./catalog/session-tips.ts\";\nimport { SETTINGS_TIPS } from \"./catalog/settings-tips.ts\";\nimport { SUBAGENT_TIPS } from \"./catalog/subagent-tips.ts\";\nimport type { TipDefinition } from \"./catalog/types.ts\";\nimport { WORKSPACE_TIPS } from \"./catalog/workspace-tips.ts\";\n\nexport type { TipDefinition } from \"./catalog/types.ts\";\n\nexport const TIP_DEFINITIONS: readonly TipDefinition[] = [\n\t...MODEL_TIPS,\n\t...INPUT_TIPS,\n\t...SESSION_TIPS,\n\t...WORKSPACE_TIPS,\n\t...SETTINGS_TIPS,\n\t...CLI_TIPS,\n\t...SUBAGENT_TIPS,\n\t...ETHOS_TIPS,\n];\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/modes/interactive/tips/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,CAAC,MAAM,eAAe,GAA6B;IACxD,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,aAAa;IAChB,GAAG,WAAW;IACd,GAAG,QAAQ;IACX,GAAG,UAAU;CACb,CAAC","sourcesContent":["import { CLI_TIPS } from \"./catalog/cli-tips.ts\";\nimport { DAG_TIPS } from \"./catalog/dag-tips.ts\";\nimport { ETHOS_TIPS } from \"./catalog/ethos-tips.ts\";\nimport { INPUT_TIPS } from \"./catalog/input-tips.ts\";\nimport { MEMORY_TIPS } from \"./catalog/memory-tips.ts\";\nimport { MODEL_TIPS } from \"./catalog/model-tips.ts\";\nimport { SESSION_TIPS } from \"./catalog/session-tips.ts\";\nimport { SETTINGS_TIPS } from \"./catalog/settings-tips.ts\";\nimport { SUBAGENT_TIPS } from \"./catalog/subagent-tips.ts\";\nimport type { TipDefinition } from \"./catalog/types.ts\";\nimport { WORKSPACE_TIPS } from \"./catalog/workspace-tips.ts\";\n\nexport type { TipDefinition } from \"./catalog/types.ts\";\n\nexport const TIP_DEFINITIONS: readonly TipDefinition[] = [\n\t...MODEL_TIPS,\n\t...INPUT_TIPS,\n\t...SESSION_TIPS,\n\t...WORKSPACE_TIPS,\n\t...SETTINGS_TIPS,\n\t...CLI_TIPS,\n\t...SUBAGENT_TIPS,\n\t...MEMORY_TIPS,\n\t...DAG_TIPS,\n\t...ETHOS_TIPS,\n];\n"]}

package/dist/utils/management-http.d.ts

@@ -4,8 +4,10 @@ export interface FetchRetryOptions {
     maxRetries?: number;
     /** Retry transient HTTP responses as well as transport failures. Defaults to true. */
     retryOnStatus?: boolean;
-    /** Per-attempt timeout. A new timeout is created for every attempt. */
+    /** Overall time budget shared by all attempts. */
     timeoutMs?: number;
+    /** Per-attempt timeout. A new timeout is created for every attempt. */
+    attemptTimeoutMs?: number;
 }
 /**
  * Fetch a management HTTP resource with a bounded immediate retry.
@@ -15,8 +17,8 @@ export interface FetchRetryOptions {
  * agent/model operations: those can fail after the HTTP request starts and are
  * retried by their semantic caller instead.
  *
- * Caller cancellation is terminal. When timeoutMs is supplied, it is the
- * overall time budget shared by all attempts.
+ * Caller cancellation and timeoutMs are terminal. attemptTimeoutMs aborts
+ * only the current attempt so a hung connection can be retried.
  */
 export declare function fetchWithRetry(input: FetchInput, init?: RequestInit | undefined, options?: FetchRetryOptions): Promise<Response>;
 export {};

package/dist/utils/management-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"management-http.d.ts","sourceRoot":"","sources":["../../src/utils/management-http.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IACjC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,WAAW,GAAG,SAAqB,EACzC,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAuCnB"}
+{"version":3,"file":"management-http.d.ts","sourceRoot":"","sources":["../../src/utils/management-http.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IACjC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,WAAW,GAAG,SAAqB,EACzC,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CA+CnB"}

package/dist/utils/management-http.js

@@ -7,23 +7,23 @@ const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
  * agent/model operations: those can fail after the HTTP request starts and are
  * retried by their semantic caller instead.
  *
- * Caller cancellation is terminal. When timeoutMs is supplied, it is the
- * overall time budget shared by all attempts.
+ * Caller cancellation and timeoutMs are terminal. attemptTimeoutMs aborts
+ * only the current attempt so a hung connection can be retried.
  */
 export async function fetchWithRetry(input, init = undefined, options = {}) {
     const maxRetries = options.maxRetries === undefined || !Number.isFinite(options.maxRetries)
         ? 2
         : Math.max(0, Math.floor(options.maxRetries));
     const retryOnStatus = options.retryOnStatus ?? true;
-    const parentSignal = init?.signal;
+    const parentSignal = init?.signal ?? undefined;
     const timeoutSignal = options.timeoutMs !== undefined && options.timeoutMs > 0 ? AbortSignal.timeout(options.timeoutMs) : undefined;
-    const signal = timeoutSignal
-        ? parentSignal
-            ? AbortSignal.any([parentSignal, timeoutSignal])
-            : timeoutSignal
-        : parentSignal;
+    const attemptTimeoutMs = options.attemptTimeoutMs !== undefined && options.attemptTimeoutMs > 0 ? options.attemptTimeoutMs : undefined;
     for (let attempt = 0;; attempt++) {
-        signal?.throwIfAborted();
+        parentSignal?.throwIfAborted();
+        timeoutSignal?.throwIfAborted();
+        const attemptTimeoutSignal = attemptTimeoutMs ? AbortSignal.timeout(attemptTimeoutMs) : undefined;
+        const signals = [parentSignal, timeoutSignal, attemptTimeoutSignal].filter((signal) => signal !== undefined);
+        const signal = signals.length > 1 ? AbortSignal.any(signals) : signals[0];
         try {
             const response = await fetch(input, signal ? { ...init, signal } : init);
             const shouldRetry = retryOnStatus && RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxRetries;
@@ -38,9 +38,13 @@ export async function fetchWithRetry(input, init = undefined, options = {}) {
             }
         }
         catch (error) {
+            const attemptTimedOut = attemptTimeoutSignal?.aborted === true && !parentSignal?.aborted && !timeoutSignal?.aborted;
             if (parentSignal?.aborted ||
                 timeoutSignal?.aborted ||
-                (error instanceof Error && error.name === "AbortError" && timeoutSignal === undefined) ||
+                (error instanceof Error &&
+                    error.name === "AbortError" &&
+                    !attemptTimedOut &&
+                    timeoutSignal === undefined) ||
                 attempt >= maxRetries) {
                 throw error;
             }

package/dist/utils/management-http.js.map

@@ -1 +1 @@
-{"version":3,"file":"management-http.js","sourceRoot":"","sources":["../../src/utils/management-http.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAW5E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAAiB,EACjB,OAAgC,SAAS,EACzC,UAA6B,EAAE;IAE/B,MAAM,UAAU,GACf,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,EAAE,MAAM,CAAC;IAClC,MAAM,aAAa,GAClB,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,MAAM,MAAM,GAAG,aAAa;QAC3B,CAAC,CAAC,YAAY;YACb,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAChD,CAAC,CAAC,aAAa;QAChB,CAAC,CAAC,YAAY,CAAC;IAEhB,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QACnC,MAAM,EAAE,cAAc,EAAE,CAAC;QAEzB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzE,MAAM,WAAW,GAAG,aAAa,IAAI,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,GAAG,UAAU,CAAC;YACzG,IAAI,CAAC,WAAW;gBAAE,OAAO,QAAQ,CAAC;YAClC,IAAI,CAAC;gBACJ,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACR,6EAA6E;gBAC7E,wCAAwC;YACzC,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IACC,YAAY,EAAE,OAAO;gBACrB,aAAa,EAAE,OAAO;gBACtB,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,aAAa,KAAK,SAAS,CAAC;gBACtF,OAAO,IAAI,UAAU,EACpB,CAAC;gBACF,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC","sourcesContent":["type FetchInput = Parameters<typeof fetch>[0];\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);\n\nexport interface FetchRetryOptions {\n\t/** Number of additional attempts after the initial request. Defaults to two. */\n\tmaxRetries?: number;\n\t/** Retry transient HTTP responses as well as transport failures. Defaults to true. */\n\tretryOnStatus?: boolean;\n\t/** Per-attempt timeout. A new timeout is created for every attempt. */\n\ttimeoutMs?: number;\n}\n\n/**\n * Fetch a management HTTP resource with a bounded immediate retry.\n *\n * This is intentionally a transport-level helper for idempotent management\n * requests (version checks, catalogs, and downloads). It must not be used for\n * agent/model operations: those can fail after the HTTP request starts and are\n * retried by their semantic caller instead.\n *\n * Caller cancellation is terminal. When timeoutMs is supplied, it is the\n * overall time budget shared by all attempts.\n */\nexport async function fetchWithRetry(\n\tinput: FetchInput,\n\tinit: RequestInit | undefined = undefined,\n\toptions: FetchRetryOptions = {},\n): Promise<Response> {\n\tconst maxRetries =\n\t\toptions.maxRetries === undefined || !Number.isFinite(options.maxRetries)\n\t\t\t? 2\n\t\t\t: Math.max(0, Math.floor(options.maxRetries));\n\tconst retryOnStatus = options.retryOnStatus ?? true;\n\tconst parentSignal = init?.signal;\n\tconst timeoutSignal =\n\t\toptions.timeoutMs !== undefined && options.timeoutMs > 0 ? AbortSignal.timeout(options.timeoutMs) : undefined;\n\tconst signal = timeoutSignal\n\t\t? parentSignal\n\t\t\t? AbortSignal.any([parentSignal, timeoutSignal])\n\t\t\t: timeoutSignal\n\t\t: parentSignal;\n\n\tfor (let attempt = 0; ; attempt++) {\n\t\tsignal?.throwIfAborted();\n\n\t\ttry {\n\t\t\tconst response = await fetch(input, signal ? { ...init, signal } : init);\n\t\t\tconst shouldRetry = retryOnStatus && RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxRetries;\n\t\t\tif (!shouldRetry) return response;\n\t\t\ttry {\n\t\t\t\tawait response.body?.cancel();\n\t\t\t} catch {\n\t\t\t\t// The response is being discarded before a retry. There is nothing useful to\n\t\t\t\t// do if cancelling its body also fails.\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\tparentSignal?.aborted ||\n\t\t\t\ttimeoutSignal?.aborted ||\n\t\t\t\t(error instanceof Error && error.name === \"AbortError\" && timeoutSignal === undefined) ||\n\t\t\t\tattempt >= maxRetries\n\t\t\t) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"management-http.js","sourceRoot":"","sources":["../../src/utils/management-http.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAa5E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAAiB,EACjB,OAAgC,SAAS,EACzC,UAA6B,EAAE;IAE/B,MAAM,UAAU,GACf,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,EAAE,MAAM,IAAI,SAAS,CAAC;IAC/C,MAAM,aAAa,GAClB,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,MAAM,gBAAgB,GACrB,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/G,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QACnC,YAAY,EAAE,cAAc,EAAE,CAAC;QAC/B,aAAa,EAAE,cAAc,EAAE,CAAC;QAChC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClG,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC,MAAM,CACzE,CAAC,MAAM,EAAyB,EAAE,CAAC,MAAM,KAAK,SAAS,CACvD,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE1E,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzE,MAAM,WAAW,GAAG,aAAa,IAAI,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,GAAG,UAAU,CAAC;YACzG,IAAI,CAAC,WAAW;gBAAE,OAAO,QAAQ,CAAC;YAClC,IAAI,CAAC;gBACJ,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACR,6EAA6E;gBAC7E,wCAAwC;YACzC,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,eAAe,GACpB,oBAAoB,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC;YAC7F,IACC,YAAY,EAAE,OAAO;gBACrB,aAAa,EAAE,OAAO;gBACtB,CAAC,KAAK,YAAY,KAAK;oBACtB,KAAK,CAAC,IAAI,KAAK,YAAY;oBAC3B,CAAC,eAAe;oBAChB,aAAa,KAAK,SAAS,CAAC;gBAC7B,OAAO,IAAI,UAAU,EACpB,CAAC;gBACF,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC","sourcesContent":["type FetchInput = Parameters<typeof fetch>[0];\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);\n\nexport interface FetchRetryOptions {\n\t/** Number of additional attempts after the initial request. Defaults to two. */\n\tmaxRetries?: number;\n\t/** Retry transient HTTP responses as well as transport failures. Defaults to true. */\n\tretryOnStatus?: boolean;\n\t/** Overall time budget shared by all attempts. */\n\ttimeoutMs?: number;\n\t/** Per-attempt timeout. A new timeout is created for every attempt. */\n\tattemptTimeoutMs?: number;\n}\n\n/**\n * Fetch a management HTTP resource with a bounded immediate retry.\n *\n * This is intentionally a transport-level helper for idempotent management\n * requests (version checks, catalogs, and downloads). It must not be used for\n * agent/model operations: those can fail after the HTTP request starts and are\n * retried by their semantic caller instead.\n *\n * Caller cancellation and timeoutMs are terminal. attemptTimeoutMs aborts\n * only the current attempt so a hung connection can be retried.\n */\nexport async function fetchWithRetry(\n\tinput: FetchInput,\n\tinit: RequestInit | undefined = undefined,\n\toptions: FetchRetryOptions = {},\n): Promise<Response> {\n\tconst maxRetries =\n\t\toptions.maxRetries === undefined || !Number.isFinite(options.maxRetries)\n\t\t\t? 2\n\t\t\t: Math.max(0, Math.floor(options.maxRetries));\n\tconst retryOnStatus = options.retryOnStatus ?? true;\n\tconst parentSignal = init?.signal ?? undefined;\n\tconst timeoutSignal =\n\t\toptions.timeoutMs !== undefined && options.timeoutMs > 0 ? AbortSignal.timeout(options.timeoutMs) : undefined;\n\tconst attemptTimeoutMs =\n\t\toptions.attemptTimeoutMs !== undefined && options.attemptTimeoutMs > 0 ? options.attemptTimeoutMs : undefined;\n\n\tfor (let attempt = 0; ; attempt++) {\n\t\tparentSignal?.throwIfAborted();\n\t\ttimeoutSignal?.throwIfAborted();\n\t\tconst attemptTimeoutSignal = attemptTimeoutMs ? AbortSignal.timeout(attemptTimeoutMs) : undefined;\n\t\tconst signals = [parentSignal, timeoutSignal, attemptTimeoutSignal].filter(\n\t\t\t(signal): signal is AbortSignal => signal !== undefined,\n\t\t);\n\t\tconst signal = signals.length > 1 ? AbortSignal.any(signals) : signals[0];\n\n\t\ttry {\n\t\t\tconst response = await fetch(input, signal ? { ...init, signal } : init);\n\t\t\tconst shouldRetry = retryOnStatus && RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxRetries;\n\t\t\tif (!shouldRetry) return response;\n\t\t\ttry {\n\t\t\t\tawait response.body?.cancel();\n\t\t\t} catch {\n\t\t\t\t// The response is being discarded before a retry. There is nothing useful to\n\t\t\t\t// do if cancelling its body also fails.\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst attemptTimedOut =\n\t\t\t\tattemptTimeoutSignal?.aborted === true && !parentSignal?.aborted && !timeoutSignal?.aborted;\n\t\t\tif (\n\t\t\t\tparentSignal?.aborted ||\n\t\t\t\ttimeoutSignal?.aborted ||\n\t\t\t\t(error instanceof Error &&\n\t\t\t\t\terror.name === \"AbortError\" &&\n\t\t\t\t\t!attemptTimedOut &&\n\t\t\t\t\ttimeoutSignal === undefined) ||\n\t\t\t\tattempt >= maxRetries\n\t\t\t) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/docs/compaction.md

@@ -281,7 +281,9 @@ pi.on("session_before_compact", async (event, ctx) => {
   const { preparation, branchEntries, customInstructions, reason, willRetry, signal } = event;
 
   // preparation.messagesToSummarize - messages to summarize
+  // preparation.sourceMessages - optional active-context history prefix, including any previous summary
   // preparation.turnPrefixMessages - split turn prefix (if isSplitTurn)
+  // preparation.turnPrefixSourceMessages - optional active-context prefix through the split turn
   // preparation.previousSummary - previous compaction summary
   // preparation.fileOps - extracted file operations
   // preparation.tokensBefore - context tokens before compaction
@@ -346,6 +348,21 @@ pi.on("session_before_compact", async (event, ctx) => {
 
 See [custom-compaction.ts](../examples/extensions/custom-compaction.ts) for a complete example using a different model.
 
+### session_compact_failed
+
+Fired when manual or automatic compaction fails or is aborted. This is useful for telemetry extensions that need to pair `session_before_compact` attempts with terminal outcomes.
+
+```typescript
+pi.on("session_compact_failed", async (event, ctx) => {
+  const { reason, errorMessage, aborted, willRetry, fromExtension } = event;
+  // reason - "manual" (/compact), "threshold", or "overflow"
+  // errorMessage - present for non-abort failures
+  // aborted - true for cancelled/aborted compactions
+  // willRetry - whether the aborted turn would have retried after compaction
+  // fromExtension - whether extension-provided compaction content was being used
+});
+```
+
 ### session_before_tree
 
 Fired before `/tree` navigation. Always fires regardless of whether user chose to summarize. Can cancel navigation or provide custom summary.

package/docs/custom-provider.md

@@ -765,8 +765,10 @@ interface ProviderModelConfig {
     requiresThinkingAsText?: boolean;
     requiresReasoningContentOnAssistantMessages?: boolean;
     thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "baseten" | "zai" | "qwen" | "chat-template" | "qwen-chat-template" | "string-thinking" | "ant-ling";
-    chatTemplateKwargs?: Record<string, string | number | boolean | null | { "$var": "thinking.enabled" | "thinking.effort"; omitWhenOff?: boolean }>;
-    chatTemplateArgs?: Record<string, string | number | boolean | null | { "$var": "thinking.enabled" | "thinking.effort"; omitWhenOff?: boolean }>;
+    chatTemplateKwargs?: Record<string, string | number | boolean | null | { "$var": "thinking.enabled" | "thinking.effort" | "thinking.budget"; omitWhenOff?: boolean }>;
+    chatTemplateArgs?: Record<string, string | number | boolean | null | { "$var": "thinking.enabled" | "thinking.effort" | "thinking.budget"; omitWhenOff?: boolean }>;
+    thinkingTokenBudgetField?: "thinking_token_budget" | "thinking_budget" | "thinking_budget_tokens";
+    supportsThinkingTokenBudget?: boolean;
     cacheControlFormat?: "anthropic";
     sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter";
     sendSessionAffinityHeaders?: boolean;
@@ -784,4 +786,5 @@ interface ProviderModelConfig {
 ```
 
 `openrouter` sends `reasoning: { effort }`. `deepseek` sends `thinking: { type: "enabled" | "disabled" }` and `reasoning_effort` when enabled. `together` sends `reasoning: { enabled }` and also `reasoning_effort` when `supportsReasoningEffort` is enabled. `qwen` is for DashScope-style top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that read `chat_template_kwargs.enable_thinking` and need `preserve_thinking`. Use `chat-template` for configurable `chat_template_kwargs`, for example DeepSeek V3.x behind vLLM with `chatTemplateKwargs: { "thinking": { "$var": "thinking.enabled" } }`. Use `thinkingFormat: "baseten"` with `chatTemplateArgs` when the provider expects toggle values under `chat_template_args` and optionally supports top-level `reasoning_effort`.
+`thinkingTokenBudgetField` sends a clamped per-level thinking budget as a top-level request field (`thinking_token_budget` on vLLM, `thinking_budget` on Qwen/SGLang, `thinking_budget_tokens` on llama.cpp). `supportsThinkingTokenBudget: true` is an alias for the vLLM field name. Do not combine it with `reasoning_effort` on DashScope Qwen models.
 `cacheControlFormat: "anthropic"` applies Anthropic-style `cache_control` markers to the system prompt, last tool definition, and last user, assistant, or tool-result text content.

package/docs/extensions.md

@@ -375,7 +375,8 @@ user sends another prompt ◄─────────────────
 
 /compact or auto-compaction
   ├─► session_before_compact (can cancel or customize)
-  └─► session_compact
+  ├─► session_compact (success)
+  └─► session_compact_failed (failure or abort)
 
 /tree navigation
   ├─► session_before_tree (can cancel or customize)
@@ -510,7 +511,7 @@ pi.on("session_before_reload", () => {
 
 Use this to protect state a reload would destroy — for example running background children owned by the extension runtime. Keep handlers fast and side-effect free; hosts may consult the veto more than once per reload attempt.
 
-#### session_before_compact / session_compact
+#### session_before_compact / session_compact / session_compact_failed
 
 Fired on compaction. See [compaction.md](compaction.md) for details.
 
@@ -547,6 +548,14 @@ pi.on("session_compact", async (event, ctx) => {
   // event.reason - "manual" (/compact), "threshold", or "overflow"
   // event.willRetry - whether the aborted turn is retried after compaction (overflow recovery)
 });
+
+pi.on("session_compact_failed", async (event, ctx) => {
+  // event.reason - "manual" (/compact), "threshold", or "overflow"
+  // event.errorMessage - present for non-abort failures
+  // event.aborted - true for cancelled/aborted compactions
+  // event.willRetry - whether the aborted turn would have retried after compaction
+  // event.fromExtension - whether extension-provided compaction content was being used
+});
 ```
 
 This accepted/rejected contract has been emitted since [#248](https://github.com/code-yeongyu/senpi/pull/248): accepted events carry `compactionEntry`, while rejected events carry `accepted: false` and `rejectionCause` with no compaction entry. Built-in handlers are required to guard on `event.accepted`; for example, the `claude-sdk-oauth` session registry now does so before recording a compaction fork.

package/docs/llama-cpp.md

@@ -53,6 +53,8 @@ Start Pi and configure the provider:
 
 Enter the router URL and optional API key. The default URL is `http://127.0.0.1:8080`.
 
+If you start the router with `--no-models-autoload`, `/login llama.cpp` only stores the connection. Run `/llama` to load a model, then `/model` to select the loaded model for the current session.
+
 Environment variables can configure the same values without `/login`:
 
 ```bash

package/docs/models.md

@@ -357,6 +357,8 @@ expected.
 
 Only OpenAI-compatible APIs apply it (`openai-completions`, `openai-responses`, `azure-openai-responses`); other APIs ignore it. Keys override senpi's named request fields (for example a `temperature` key here beats the request-level temperature), so prefer it as the single source of sampling truth for a model. In `modelOverrides`, `samplingParams` merges per key with the base model's value.
 
+A constant thinking-token cap can go here too, but it will not follow `thinkingBudgets` or leave room for the answer. Prefer `compat.thinkingTokenBudgetField` (or the `supportsThinkingTokenBudget` alias) for that.
+
 ### Thinking Level Map
 
 Use `thinkingLevelMap` on a model to describe model-specific thinking controls. Keys are senpi thinking levels: `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`. Maps may contain holes; for example, a model can expose `high` and `max` without exposing `xhigh`.
@@ -570,8 +572,10 @@ For providers with partial OpenAI compatibility, use the `compat` field.
 | `requiresThinkingAsText` | Convert thinking blocks to plain text |
 | `requiresReasoningContentOnAssistantMessages` | Include empty `reasoning_content` on all replayed assistant messages when reasoning is enabled |
 | `thinkingFormat` | Use `reasoning_effort`, `openrouter`, `deepseek`, `together`, `baseten`, `zai`, `qwen`, `chat-template`, or `qwen-chat-template` thinking parameters |
-| `chatTemplateKwargs` | `chat_template_kwargs` values for `thinkingFormat: "chat-template"`; use `{ "$var": "thinking.enabled" }` or `{ "$var": "thinking.effort" }` for senpi-controlled thinking values |
-| `chatTemplateArgs` | `chat_template_args` values for `thinkingFormat: "baseten"`; use `{ "$var": "thinking.enabled" }` or `{ "$var": "thinking.effort" }` for senpi-controlled thinking values |
+| `chatTemplateKwargs` | `chat_template_kwargs` values for `thinkingFormat: "chat-template"`; use `{ "$var": "thinking.enabled" }`, `{ "$var": "thinking.effort" }`, or `{ "$var": "thinking.budget" }` for senpi-controlled thinking values |
+| `chatTemplateArgs` | `chat_template_args` values for `thinkingFormat: "baseten"`; use `{ "$var": "thinking.enabled" }`, `{ "$var": "thinking.effort" }`, or `{ "$var": "thinking.budget" }` for senpi-controlled thinking values |
+| `thinkingTokenBudgetField` | Top-level request field used to cap reasoning tokens from `thinkingBudgets`, clamped so at least 1024 tokens remain for the answer. `"thinking_token_budget"` (vLLM), `"thinking_budget"` (Qwen/DashScope/SGLang), `"thinking_budget_tokens"` (llama.cpp). Off by default; not set on the generated catalog. |
+| `supportsThinkingTokenBudget` | Alias for `thinkingTokenBudgetField: "thinking_token_budget"` (vLLM). Prefer `thinkingTokenBudgetField`. Default: `false`. |
 | `cacheControlFormat` | Use Anthropic-style `cache_control` markers on the system prompt, last tool definition, and last user, assistant, or tool-result text content. Currently only `anthropic` is supported. |
 | `sendSessionAffinityHeaders` | For `openai-completions`, send session-affinity headers from the session id when caching is enabled. Default: `false`. |
 | `sessionAffinityFormat` | For `openai-completions` and `openai-responses`, the session-affinity header format: `openai` sends `session_id`/`x-client-request-id` (completions also `x-session-affinity`), `openai-nosession` omits the underscore-containing `session_id` header, `openrouter` sends `x-session-id`. Does not affect the `prompt_cache_key` body param. Default: auto-detected. |
@@ -585,6 +589,8 @@ For providers with partial OpenAI compatibility, use the `compat` field.
 
 `openrouter` uses `reasoning: { effort }`. `together` uses `reasoning: { enabled }` and also `reasoning_effort` when `supportsReasoningEffort` is enabled. `qwen` uses top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that require `chat_template_kwargs.enable_thinking` and `preserve_thinking`. Use `chat-template` for vLLM/Hugging Face chat templates that need configurable `chat_template_kwargs`, such as `chatTemplateKwargs: { "thinking": { "$var": "thinking.enabled" } }` for DeepSeek V3.x templates. Use `thinkingFormat: "baseten"` with `chatTemplateArgs` for providers that expose toggle controls through `chat_template_args` and optionally support top-level `reasoning_effort`.
 
+`thinkingTokenBudgetField` is independent of `thinkingFormat`. Do not enable it on the generated Qwen catalog: those models already send `reasoning_effort`, and DashScope rejects `thinking_budget` together with `reasoning_effort`.
+
 `cacheControlFormat: "anthropic"` is for OpenAI-compatible providers that expose Anthropic-style prompt caching through `cache_control` markers on text content and tool definitions.
 
 Example:

package/docs/providers.md

@@ -44,10 +44,11 @@ The `claude-sdk-oauth` provider routes LLM calls through the official [Claude Ag
 - Multiple accounts: each `/login claude-sdk-oauth` adds another named account. `CLAUDE_CODE_OAUTH_TOKEN` (and `_2`..`_N`) are honored as read-only env accounts. `/claude-account` lists, adds, removes, and pins accounts; `--claude-account <name>` pins one for the session; `claudeSdkOauthProvider.pinnedAccount` pins one in settings.
 - Session affinity: one senpi session sticks to one account (rendezvous hashing), which keeps Anthropic's prompt cache warm - accounts never rotate mid-session except on automatic failover. Rate limits and auth errors block the account (with cooldown) and retry on the next account, before any visible output; once output has started, the error surfaces instead of replaying.
 - Default lane: **ambient** - with no `tokenInjection` setting the provider inherits the environment like the upstream extension (Claude Code CLI login or `ANTHROPIC_API_KEY`). Managed lanes (`oauth-slots`, `config-dir`) are opt-in via one settings line until the live subscription spike proves a managed default.
+- Ambient lane is explicit opt-in: a Claude Code CLI login on the host is not consent to spend that subscription, so the ambient lane is gated by `claudeSdkOauthProvider.enabled` (default `false`, env override `SENPI_CLAUDE_SDK_OAUTH_ENABLED`). Before this gate existed, a logged-in Claude Code CLI made the provider available with no senpi-side action. An explicit senpi-side login is itself an opt-in: stored OAuth accounts in `auth.json` and `CLAUDE_CODE_OAUTH_TOKEN` / `CLAUDE_CODE_OAUTH_TOKEN_<n>` env accounts keep the provider available with the flag unset. Only the host-CLI-derived ambient lane requires the flag.
 - Settings (`claudeSdkOauthProvider`):
   - `systemPromptMode` — controls how the system prompt is delivered. **`full`** (default) sends senpi's composed system prompt verbatim; the lane no longer rebuilds from the SDK `claude_code` preset, so all prompt regions (project rules, response-language instructions, etc.) reach the model. **`preset-append`** is the previous behaviour (deprecated, kept for one release; emits a one-time warning). **`override`** loads the system prompt from a file (`systemPromptFile`). The legacy `appendSystemPrompt` key still works: `false` → `preset-append`, `true`/unset → `full`; setting both keys makes `systemPromptMode` win and warns.
   - In `full` and `override` modes, `settingSources` defaults to `[]` on every lane because senpi's prompt already carries project context — loading the SDK's own CLAUDE.md would double-inject it. The CLI always prepends its own `"You are a Claude agent, built on Anthropic's Claude Agent SDK."` block, which senpi cannot suppress; `full` means the prompt is delivered intact, not that it is the only system-prompt text.
-  - `settingSources` (filesystem settings load only in the ambient lane, so they cannot override your selected account), `strictMcpConfig`, `pinnedAccount`, `tokenInjection` (`oauth-slots` | `config-dir` | `ambient`), `resumeMode` (`auto` default | `off` restores per-turn sessions), `systemPromptFile`.
+  - `settingSources` (filesystem settings load only in the ambient lane, so they cannot override your selected account), `strictMcpConfig`, `pinnedAccount`, `tokenInjection` (`oauth-slots` | `config-dir` | `ambient`), `resumeMode` (`auto` default | `off` restores per-turn sessions), `systemPromptFile`, `enabled` (default `false`; gates the ambient lane only).
 - **Environment overrides** (precedence: `env > project settings > global settings > default`; no new CLI flags):
 
   | Variable | Purpose |
@@ -55,6 +56,7 @@ The `claude-sdk-oauth` provider routes LLM calls through the official [Claude Ag
   | `SENPI_CLAUDE_SDK_OAUTH_SYSTEM_PROMPT_MODE` | `full` \| `preset-append` \| `override` |
   | `SENPI_CLAUDE_SDK_OAUTH_SYSTEM_PROMPT_FILE` | Path to the system prompt file (used with `override` mode) |
   | `SENPI_CLAUDE_SDK_OAUTH_RESUME` | `auto` (default) \| `off` — disables session reuse, restoring per-turn SDK queries |
+  | `SENPI_CLAUDE_SDK_OAUTH_ENABLED` | Overrides `enabled`; gates the ambient (host-CLI-derived) lane |
   | `SENPI_CLAUDE_SDK_OAUTH_TOKEN_INJECTION` | `oauth-slots` \| `config-dir` \| `ambient` |
   | `SENPI_CLAUDE_SDK_OAUTH_SETTING_SOURCES` | Overrides `settingSources` |
   | `SENPI_CLAUDE_SDK_OAUTH_PINNED_ACCOUNT` | Overrides `pinnedAccount` |
@@ -146,7 +148,7 @@ Radius is a dynamic `pi-messages` gateway. `/login radius` stores OAuth tokens i
 
 Use the native `cursor` provider above by default - it is the first-party, primary path.
 
-`cursor-cli-oauth` is a default-available fallback (never a replacement) that drives the locally installed `cursor-agent` CLI instead of Cursor's network protocol. It becomes usable automatically when `cursor-agent` is installed and Senpi has a native `cursor` OAuth credential. Fall back to this lane when:
+`cursor-cli-oauth` is an opt-in fallback (never a replacement) that drives the locally installed `cursor-agent` CLI instead of Cursor's network protocol. It becomes usable when `cursor-agent` is installed, Senpi has a native `cursor` OAuth credential, and the lane has been explicitly enabled. Fall back to this lane when:
 
 - the native transport misbehaves on your setup - protocol drift after a Cursor update, Connect-RPC/HTTP2 failures the native provider cannot route around, or
 - you explicitly want Cursor's own agent harness - the model running inside the Cursor CLI with its built-in tools - rather than senpi executing the tools.
@@ -177,7 +179,7 @@ curl https://cursor.com/install -fsS | bash
 /cursor-account [list | add | remove <name> | pin <name> | unpin | import [local | native] | acknowledge | status]
 ```
 
-- The lane is enabled by default. Set `cursorCliOauthProvider.enabled: false` (or `SENPI_CURSOR_CLI_OAUTH_ENABLED=0`) to disable it and prevent automatic native credential bootstrap.
+- The lane is disabled by default. A `cursor-agent` CLI being logged in on the machine is not consent to spend that subscription, so set `cursorCliOauthProvider.enabled: true` (or `SENPI_CURSOR_CLI_OAUTH_ENABLED=1`) to enable it and allow automatic native credential bootstrap. Before this gate existed, an installed and logged-in `cursor-agent` made the lane available with no senpi-side action.
 - `add`, `import local`, and `import native` explicitly persist enabled state and refresh model availability.
 - `import local` copies the locally logged-in Cursor desktop credential into a new slot: the source is read once, on this explicit request only, and copied - never referenced live.
 - `import native` copies the primary Senpi `cursor` provider's OAuth credential into a separate managed slot without moving, deleting, or refreshing the primary entry.

package/docs/settings.md

@@ -89,8 +89,8 @@ Permission rules are a confirmation policy, not a sandbox. Senpi, extensions, pa
 | `modelServiceTiers` | object | - | Per-model service tier memory (`"provider/id": "auto" \| "priority"`) |
 | `promptPreset` | string | `"auto"` | Force a system prompt preset: `"auto"`, `"kimi-k2-6"`, `"kimi-k2-7"`, `"kimi-k3"`, `"glm-5.2"`, `"glm-5.3"`, `"grok-4.5"`, `"grok-4.6"`, `"claude-fable-5"`, `"claude-opus-5"`, `"claude-opus-4-5"`, `"claude-opus-4-6"`, `"claude-opus-4-7"`, `"claude-opus-4-8"`, `"deepseek-v4-flash"`, `"deepseek-v4-flash-0731"`, `"deepseek-v4-pro"`, `"gpt-5"`, `"gpt-5.2"`, `"gpt-5.3-codex"`, `"gpt-5.4"`, `"gpt-5.5"`, or `"gpt-5.6"` |
 | `hideThinkingBlock` | boolean | `false` | Hide thinking blocks in output |
-| `showCacheMissNotices` | boolean | `false` | Show transcript notices for significant prompt-cache misses |
-| `thinkingBudgets` | object | - | Custom token budgets per thinking level |
+| `showCacheMissNotices` | boolean | `false` | Show transcript notices for significant prompt-cache misses and compaction or branch-summary usage |
+| `thinkingBudgets` | object | - | Custom token budgets per thinking level. Anthropic, Google, and Bedrock use these natively. OpenAI-compatible models use them when `compat.thinkingTokenBudgetField` (or `supportsThinkingTokenBudget`) is set. |
 
 #### promptPreset
 
@@ -319,6 +319,26 @@ For diagnostics, Senpi writes sanitized NDJSON records for candidate skips, cool
 
 When unset, senpi leaves provider payloads unchanged. This setting currently applies only to the built-in OpenAI Responses provider path.
 
+### Providers
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `claudeSdkOauthProvider.enabled` | boolean | `false` | Enable the ambient (host-CLI-derived) lane of `claude-sdk-oauth`. Env override: `SENPI_CLAUDE_SDK_OAUTH_ENABLED`. Explicit senpi-side logins (stored OAuth accounts in `auth.json`, `CLAUDE_CODE_OAUTH_TOKEN` / `CLAUDE_CODE_OAUTH_TOKEN_<n>` env accounts) keep the provider available with this unset |
+| `cursorCliOauthProvider.enabled` | boolean | `false` | Enable the `cursor-cli-oauth` fallback lane and automatic native credential bootstrap. Env override: `SENPI_CURSOR_CLI_OAUTH_ENABLED` |
+
+Both ambient-auth providers are explicit opt-in: a vendor CLI being logged in on the machine is not consent to spend that subscription. Before these gates existed, a logged-in Claude Code or `cursor-agent` CLI made the lane available with no senpi-side action, so subscription usage could flow through a provider you never configured. Env overrides follow the usual precedence (`env > project settings > global settings > default`). See [providers.md](providers.md) for the full lane documentation.
+
+```json
+{
+  "claudeSdkOauthProvider": {
+    "enabled": true
+  },
+  "cursorCliOauthProvider": {
+    "enabled": true
+  }
+}
+```
+
 ### Terminal & Images
 
 | Setting | Type | Default | Description |

package/docs/skills.md

@@ -35,9 +35,10 @@ Senpi loads skills from:
 - CLI: `--skill <path>` (repeatable, additive even with `--no-skills`)
 
 Discovery rules:
-- In `~/.senpi/agent/skills/` and `.senpi/skills/`, direct root `.md` files are discovered as individual skills
+- In `~/.senpi/agent/skills/` and `.senpi/skills/`, direct root `.md` files are discovered as individual skills when they have valid skill frontmatter with a non-empty `description`
 - In all skill locations, directories containing `SKILL.md` are discovered recursively
-- In `~/.agents/skills/` and project `.agents/skills/`, root `.md` files are ignored
+- In `~/.agents/skills/` and project `.agents/skills/`, root `.md` files are ignored, but nested `.md` files in grouping folders are discovered when they declare skill frontmatter
+- Root Markdown files other than `SKILL.md` that do not look like skills are ignored silently
 
 Disable discovery with `--no-skills` (explicit `--skill` paths still load).
 
@@ -223,7 +224,7 @@ Senpi validates skills against the Agent Skills standard. Most issues produce wa
 
 Unknown frontmatter fields are ignored.
 
-**Exception:** Skills with missing description are not loaded.
+Declared skills with missing descriptions are not loaded. Malformed `SKILL.md` files and `SKILL.md` files without a description produce warnings and are not loaded. Other Markdown files without valid skill frontmatter are ignored.
 
 Name collisions (same name from different locations) warn and keep the first skill found.
 

package/examples/extensions/border-status-editor.ts

@@ -92,7 +92,7 @@ export default function (pi: ExtensionAPI) {
 		activeTui?.requestRender();
 	});
 
-	pi.on("agent_end", () => {
+	pi.on("agent_settled", () => {
 		isWorking = false;
 		stopSpinner();
 		activeTui?.requestRender();

package/examples/extensions/git-checkpoint.ts

@@ -46,8 +46,8 @@ export default function (pi: ExtensionAPI) {
 		}
 	});
 
-	pi.on("agent_end", async () => {
-		// Clear checkpoints after agent completes
+	pi.on("agent_settled", async () => {
+		// Clear checkpoints after the full agent run completes
 		checkpoints.clear();
 	});
 }