@ashx-j/lunr 0.2.20 → 0.2.21

package/dist/node-runtime/rpc-entry.js

@@ -2,14 +2,15 @@
 import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
 import {
   main
-} from "./chunk-AL2FMKKM.js";
-import "./chunk-K3646JTM.js";
-import "./chunk-4DJ6HEGH.js";
-import "./chunk-AROOY4BB.js";
+} from "./chunk-PDNXVXMD.js";
+import "./chunk-AWVD5IEY.js";
+import "./chunk-VZR3NCM7.js";
+import "./chunk-YMEAYRBE.js";
+import "./chunk-5ZH3ZFIZ.js";
 import "./chunk-25I2BHAA.js";
-import "./chunk-JYNNB7DU.js";
+import "./chunk-XI77KVKA.js";
 import "./chunk-STERBGUB.js";
-import "./chunk-4CSFRBCN.js";
+import "./chunk-Y5KOEMBH.js";
 import "./chunk-OBMWP3I5.js";
 import "./chunk-DVGWF6A2.js";
 import "./chunk-QFWG2RVL.js";
@@ -20,10 +21,11 @@ import "./chunk-KBKMCJDU.js";
 import "./chunk-CSFI6YXL.js";
 import {
   configureHttpDispatcher
-} from "./chunk-CBGB57XT.js";
+} from "./chunk-WLLDXJRT.js";
+import "./chunk-LISUTZS3.js";
 import "./chunk-GKLEQ3I4.js";
 import "./chunk-FVDOXRUD.js";
-import "./chunk-AOFXZQKA.js";
+import "./chunk-W3SILANP.js";
 import "./chunk-W3CVH5RX.js";
 import "./chunk-LTYWTR3V.js";
 import "./chunk-PL6JKXWI.js";
@@ -35,7 +37,7 @@ import "./chunk-JHYKXIMM.js";
 import "./chunk-H2EOZYMP.js";
 import "./chunk-PVCDKGR6.js";
 import "./chunk-OR4L3IB2.js";
-import "./chunk-HQCKFM2O.js";
+import "./chunk-VGYZ3APQ.js";
 import "./chunk-AY6CAJSL.js";
 import "./chunk-QZMODZQ2.js";
 import "./chunk-CCZJ3PYY.js";

package/dist/node-runtime/{runtime-bridges-NJQERQ72.js → runtime-bridges-2VQTLPOZ.js}

@@ -1,10 +1,10 @@
 import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
 import {
   bindRuntimeBridges
-} from "./chunk-AOFXZQKA.js";
+} from "./chunk-W3SILANP.js";
 import "./chunk-W3CVH5RX.js";
 import "./chunk-LTYWTR3V.js";
-import "./chunk-HQCKFM2O.js";
+import "./chunk-VGYZ3APQ.js";
 import "./chunk-AY6CAJSL.js";
 import "./chunk-BRJX2PRC.js";
 export {

package/dist/node-runtime/{settings-manager-GHPTUN7R.js → settings-manager-CUGAZWAB.js}

@@ -6,7 +6,8 @@ import {
   SKILL_TAG_CHARACTERS,
   SettingsManager,
   parseSkillTagCharacter
-} from "./chunk-CBGB57XT.js";
+} from "./chunk-WLLDXJRT.js";
+import "./chunk-LISUTZS3.js";
 import "./chunk-AY6CAJSL.js";
 import "./chunk-FQMM2EZ2.js";
 import "./chunk-Q4Q6D4IY.js";

package/dist/node-runtime/{subagent-executor-SRFC26SJ.js → subagent-executor-MH4A7CCF.js}

@@ -14,6 +14,7 @@ import {
   PI_CODING_AGENT_PACKAGE_ROOT_ENV,
   RESULTS_DIR,
   SUBAGENT_ACTIONS,
+  SUBAGENT_ASYNC_GUIDANCE,
   SUBAGENT_ASYNC_STARTED_EVENT,
   SUBAGENT_CONTROL_EVENT,
   SUBAGENT_CONTROL_INTERCOM_EVENT,
@@ -147,6 +148,7 @@ import {
   resolveSkillsWithFallback,
   resolveStepBehavior,
   resolveSubagentIntercomTarget,
+  resolveSubagentRequestParams,
   resolveSubagentResultStatus,
   resolveSubagentRunId,
   resolveTopLevelParallelConcurrency,
@@ -161,6 +163,7 @@ import {
   splitThinkingSuffix,
   stripAcceptanceReport,
   stripDetailsOutputsForIntercomReceipt,
+  subagentLaunchRunsAsync,
   sumResultsCost,
   sumResultsUsage,
   suppressProgressForReadOnlyTask,
@@ -184,7 +187,7 @@ import {
   writeNestedControlRequest,
   writeNestedEvent,
   writePrivateAtomicJson
-} from "./chunk-46ECNOLF.js";
+} from "./chunk-SY2TFMLO.js";
 import {
   PLAN_MODE_WRITE_SPAWN_ERROR,
   resolveChildPermissions,
@@ -894,34 +897,6 @@ var ChainClarifyComponent = class {
   }
 };
 
-// packages/coding-agent/dist/builtin-extensions/pi-subagents/src/runs/foreground/request-params.js
-var LAUNCH_COMPATIBLE_ACTIONS = /* @__PURE__ */ new Set(["schedule", "append-step", "resume", "steer"]);
-function omitExecutionModeActionAlias(params) {
-  let action = params.action?.toLowerCase();
-  if (action === "single" && params.task !== void 0) {
-    let rest = { ...params };
-    return delete rest.action, rest;
-  }
-  if ((action === "parallel" || action === "tasks") && (params.tasks?.length ?? 0) > 0) {
-    let rest = { ...params };
-    return delete rest.action, rest;
-  }
-  return params;
-}
-function hasLaunchFields(params) {
-  return params.task !== void 0 || Array.isArray(params.tasks) && params.tasks.length > 0 || Array.isArray(params.chain) && params.chain.length > 0;
-}
-function omitConflictingControlAction(params) {
-  let action = params.action?.toLowerCase();
-  if (!action || LAUNCH_COMPATIBLE_ACTIONS.has(action) || !hasLaunchFields(params))
-    return params;
-  let rest = { ...params };
-  return delete rest.action, typeof rest.task == "string" && rest.task.length > 0 && (delete rest.tasks, delete rest.chain), rest;
-}
-function resolveSubagentRequestParams(params) {
-  return omitConflictingControlAction(omitExecutionModeActionAlias(params));
-}
-
 // packages/coding-agent/dist/builtin-extensions/pi-subagents/src/runs/foreground/chain-execution.js
 import * as fs7 from "node:fs";
 import * as path6 from "node:path";
@@ -1223,7 +1198,7 @@ function hasMutationToolCall(messages) {
   return !1;
 }
 function evaluateCompletionMutationGuard(input) {
-  let expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools) ? expectsImplementationMutation(input.agent, input.task) : !1, attemptedMutation = hasMutationToolCall(input.messages);
+  let expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools) ? expectsImplementationMutation(input.permissions, input.task) : !1, attemptedMutation = hasMutationToolCall(input.messages);
   return {
     expectedMutation,
     attemptedMutation,
@@ -2160,7 +2135,7 @@ ${fullOutput}` : timeoutMessage;
 ${fullOutput}` : note;
   }
   if ((result2.exitCode === 0 && !result2.error ? evaluateCompletionMutationGuard({
-    agent: spec.effectivePermissions,
+    permissions: spec.effectivePermissions,
     task: shared.originalTask ?? task,
     messages: result2.messages,
     tools: spec.effectivePermissions === "read-only" ? ["read", "grep", "find", "ls", "bash"] : void 0
@@ -4033,9 +4008,8 @@ function formatAsyncStartedMessage(headline) {
   return [
     headline,
     "",
-    "The async run is detached. Do not run sleep timers or polling loops just to wait for it.",
-    "If you have independent work, continue that work. When you have nothing left to do until the async result arrives, call subagent_wait() \u2014 it blocks until the run finishes and delivers the completion here. Only if you are certain you will get another turn (an interactive session where the user will prompt you again) can you instead stop and let Pi wake you; inside a skill that must run to completion, or in a non-interactive run, there is no next turn, so use subagent_wait().",
-    'Use subagent({ action: "status", id: "..." }) when you need a one-shot status/result or to inspect a blocked/stale run. To block until completion, prefer subagent_wait(). Do not poll in a loop just to wait.'
+    SUBAGENT_ASYNC_GUIDANCE,
+    'For one-time inspection or recovery of a blocked or stale run, use subagent({ action: "status", id: "..." }).'
   ].join(`
 `);
 }
@@ -4673,6 +4647,7 @@ ${injection}` : injection;
           permissions: spec.effectivePermissions,
           agent,
           task: taskWithOutputInstruction,
+          completionTask: params.completionTask ?? task,
           cwd: runnerCwd,
           model,
           thinking: resolveEffectiveThinking(model, effectiveThinking),
@@ -5737,11 +5712,6 @@ function inspectSubagentStatus(params, deps = {}) {
   };
 }
 
-// packages/coding-agent/dist/builtin-extensions/pi-subagents/src/runs/background/top-level-async.js
-function applyForceTopLevelAsyncOverride(params, depth, forceTopLevelAsync) {
-  return params.foregroundOnly || !(depth === 0 && forceTopLevelAsync) ? params : { ...params, async: !0, clarify: !1 };
-}
-
 // packages/coding-agent/dist/builtin-extensions/pi-subagents/src/runs/foreground/subagent-executor.js
 var MUTATING_MANAGEMENT_ACTIONS = /* @__PURE__ */ new Set(["create", "update", "delete", "eject", "disable", "enable", "reset"]);
 function resolveRequestedCwd(runtimeCwd, requestedCwd) {
@@ -6568,6 +6538,7 @@ ${followUp}`, 500, { source: "async-resume", runId: target.runId, agent: target.
   }
   let result2 = executeAsyncSingle(runId, {
     spec: recoverySpec,
+    completionTask: followUp,
     goal: followUp,
     ctx: {
       pi: input.deps.pi,
@@ -8003,7 +7974,7 @@ function foregroundCapacityResult(params, inFlight, limit) {
   return {
     content: [{
       type: "text",
-      text: `Foreground subagent capacity reached (${inFlight}/${limit} running). Wait for a child to finish, use ONE subagent call with tasks: [{task, description}, \u2026], or set async: true.`
+      text: `Foreground subagent capacity reached (${inFlight}/${limit} running). Wait for a child to finish, combine work in ONE tasks call, or launch without async:false or clarify:true when foreground execution is unnecessary.`
     }],
     isError: !0,
     details: { mode: inferExecutionMode(params), results: [] }
@@ -8191,7 +8162,7 @@ function createSubagentExecutor(deps) {
     let normalized = normalizeRepeatedParallelCounts(paramsWithResolvedCwd);
     if (normalized.error)
       return normalized.error;
-    let normalizedParams = normalized.params, effectiveParams = applyForceTopLevelAsyncOverride(normalizedParams, depth, deps.config.forceTopLevelAsync === !0), runToolBudget = resolveToolBudget(effectiveParams.toolBudget, "toolBudget");
+    let effectiveParams = normalized.params, runToolBudget = resolveToolBudget(effectiveParams.toolBudget, "toolBudget");
     if (runToolBudget.error)
       return buildRequestedModeError(effectiveParams, runToolBudget.error);
     let configToolBudget = resolveToolBudget(deps.config.toolBudget, "config.toolBudget");
@@ -8242,7 +8213,7 @@ function createSubagentExecutor(deps) {
     } catch (error) {
       return toExecutionErrorResult(effectiveParams, error);
     }
-    let requestedAsync = effectiveParams.async ?? deps.asyncByDefault, backgroundRequestedWhileClarifying = (hasChain || hasTasks) && requestedAsync && effectiveParams.clarify === !0, effectiveAsync = requestedAsync && effectiveParams.clarify !== !0, controlConfig = resolveControlConfig(deps.config.control, effectiveParams.control), artifactConfig = {
+    let backgroundRequestedWhileClarifying = (hasChain || hasTasks) && effectiveParams.async === !0 && effectiveParams.clarify === !0, effectiveAsync = subagentLaunchRunsAsync(effectiveParams), controlConfig = resolveControlConfig(deps.config.control, effectiveParams.control), artifactConfig = {
       ...DEFAULT_ARTIFACT_CONFIG,
       enabled: effectiveParams.artifacts !== !1
     }, artifactsDir = getArtifactsDir(parentSessionFile, effectiveCwd), sessionRoot;
@@ -8397,10 +8368,7 @@ function createSubagentExecutor(deps) {
   };
   return { execute: async (id, params, signal, onUpdate, ctx) => {
     let requestParams = resolveSubagentRequestParams(params);
-    if (requestParams.action)
-      return execute(id, requestParams, signal, onUpdate, ctx);
-    let { depth } = checkSubagentDepth(deps.config.maxSubagentDepth), dispatchParams = applyForceTopLevelAsyncOverride(requestParams, depth, deps.config.forceTopLevelAsync === !0);
-    if (!(dispatchParams.clarify === !0 || (dispatchParams.async ?? deps.asyncByDefault) !== !0))
+    if (requestParams.action || !!subagentLaunchRunsAsync(requestParams))
       return execute(id, requestParams, signal, onUpdate, ctx);
     let limit = resolveTopLevelParallelConcurrency(void 0, deps.config.parallel?.concurrency), inFlight = deps.state.foregroundSubagentInFlight ?? 0;
     if (inFlight >= limit)

package/dist/node-runtime/{update-cli-L3JIBH2U.js → update-cli-XTZMZGOL.js}

@@ -6,7 +6,8 @@ import {
 import "./chunk-DVGWF6A2.js";
 import {
   SettingsManager
-} from "./chunk-CBGB57XT.js";
+} from "./chunk-WLLDXJRT.js";
+import "./chunk-LISUTZS3.js";
 import "./chunk-AY6CAJSL.js";
 import {
   APP_NAME,

package/docs/features.md

@@ -21,7 +21,11 @@ Permission modes: `manual | yolo | plan | auto`. Shift+Tab (`app.mode.cycle`) cy
 
 Advertised subagents always start **fresh** (no forked parent context). Default parallel concurrency / max tasks / global run cap are unlimited; an explicit `concurrency` is still honored.
 
-Collapsed subagent rows (foreground and async) are one line: status glyph, description, selected tier or explicit model, tokens, and elapsed time. Running rows keep a live spinner and clock; completed collapsed rows freeze those stats. Async launches show `subagent async` in the tool header. Completed notify cards show title and status only; the model still receives the full result text.
+Single, parallel, and chain launches run async when `async` is omitted. Set `async:false` for an immediate foreground result or use `clarify:true` for the interactive preview/editor. Continue independent work after an async launch, then yield for normal interactive completion. Use `subagent_wait` only when the same turn or skill must finish after its children. Headless sessions auto-drain current-session work. Use status for one-time inspection rather than polling or sleeping for completion.
+
+The legacy extension config keys `asyncByDefault` and `forceTopLevelAsync` remain accepted but no longer change launch mode. Omitted `async` resolves to async, while explicit `async:false`, `clarify:true`, and internal `foregroundOnly` calls stay foreground. RPC and scheduled launches remain always async.
+
+Collapsed subagent rows (foreground and async) are one line: status glyph, description, selected tier or explicit model, tokens, and elapsed time. Mixed async runs use the same flat child rows without an aggregate tree. Running rows keep a live spinner and clock; completed collapsed rows freeze those stats. Choose the running child spinner under `/settings` → Customize. Async launches show `subagent async` in the tool header. Completed notify cards show title and status only; the model still receives the full result text.
 
 A launch of 3+ parallel children in one `tasks`/`chain.parallel` call, or 3+ same-turn SINGLE `subagent` calls, receives one aggregate confirmation in **manual and yolo**. Sequential work stays `chain`. Auto bypasses this confirmation, and it can be disabled independently in `/settings`.
 
@@ -41,7 +45,7 @@ The agent must ask only when the child has missing context, the answer changes a
 
 ## Todos, memory, and global instructions
 
-- **Todos** — lunr-todos is a full-replace list. Completed todos prune on the next user turn (no leftover `✓ N done` footer).
+- **Todos** — lunr-todos is a full-replace list. Collapsed lists show all four active items; lists of five or more show three and a `+N more` line. Completed todos prune on the next user turn (no leftover `✓ N done` footer).
 - **Agent memory** — durable established facts and stable preferences in `~/.lunr/simple-memory/memory.md`. `/settings` → Agent memory controls injection and the `memory_add`, `memory_remove`, and `memory_load` tools without deleting stored facts. `memoryCharCap` defaults to 5000. Behavior instructions, transient task state, transcripts, guesses, and secrets do not belong in memory.
 - **Global instructions** — create `~/.lunr/agent/agents/AGENTS.md` yourself when you want global behavior or instructions. lunR injects it through the normal context loader; `/reload` picks up changes. The model cannot modify this user-managed file. The retired `behavior.md` file and behavior presets are no longer loaded.
 - **Model instructions** — `/settings` can enable `~/.lunr/agent/agents/<model-name>/AGENTS.md` and choose **Both** (global then model-specific) or **Model only**. The folder name is provider-independent and filesystem-safe. Project `AGENTS.md`/`CLAUDE.md` files are unaffected, and `--no-context-files` disables all instruction files.

package/docs/settings.md

@@ -55,6 +55,7 @@ Use `/trust` in interactive mode to save a project trust decision for future ses
 | `externalEditor` | string | `$VISUAL`, then `$EDITOR`, then Notepad on Windows or `nano` elsewhere | Command for Ctrl+G external editor; takes precedence over environment variables |
 | `quietStartup` | boolean | `false` | Hide startup header |
 | `smoothStreaming` | boolean | `false` | Reveal streamed responses grapheme by grapheme (~30 FPS). Interactive TUI only |
+| `subagentSpinner` | string | `"braille"` | Foreground and async running child indicator: `"braille"`, `"orbit"`, `"snake"`, or `"sparkle"` |
 | `thinkingCollapse` | boolean | `true` | Collapse completed thinking blocks to a short label plus the first sentence |
 | `cacheRetention` | string | unset → `PI_CACHE_RETENTION` → `"short"` | `"none"`, `"short"`, or `"long"` prompt-cache retention |
 | `defaultProjectTrust` | string | `"ask"` | Fallback project trust behavior: `"ask"`, `"always"`, or `"never"`. Global setting only |
@@ -238,7 +239,7 @@ When multiple sources specify a session directory, precedence is `--session-dir`
 | `footerPlanBar` | boolean | `true` | Show the █░ fill; off keeps the percent only |
 | `planUsageWindow` | string | `"5h"` | Preferred plan window: `"5h"` or `"weekly"`. Missing 5h falls back to weekly |
 
-Customize these from `/settings` → Customize as well.
+Customize these from `/settings` → Customize as well. The same menu controls `subagentSpinner` with an animated preview.
 
 ### Cron, rollback, subscriptions
 

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.2.19",
+      "version": "0.2.21",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/gondolin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-gondolin",
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-gondolin",
-			"version": "0.2.19",
+			"version": "0.2.21",
 			"dependencies": {
 				"@earendil-works/gondolin": "0.12.0"
 			}

package/examples/extensions/gondolin/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-gondolin",
 	"private": true,
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-sandbox",
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "0.2.19",
+			"version": "0.2.21",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "^0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-sandbox",
 	"private": true,
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.2.19",
+      "version": "0.2.21",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-with-deps",
 	"private": true,
-	"version": "0.2.19",
+	"version": "0.2.21",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ashx-j/lunr",
-	"version": "0.2.20",
+	"version": "0.2.21",
 	"description": "lunR — terminal coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -37,9 +37,9 @@
 		"shrinkwrap": "node ../../scripts/generate-coding-agent-shrinkwrap.mjs"
 	},
 	"dependencies": {
-		"@ashx-j/lunr-agent": "^0.2.20",
-		"@ashx-j/lunr-ai": "^0.2.20",
-		"@ashx-j/lunr-tui": "^0.2.20",
+		"@ashx-j/lunr-agent": "^0.2.21",
+		"@ashx-j/lunr-ai": "^0.2.21",
+		"@ashx-j/lunr-tui": "^0.2.21",
 		"@modelcontextprotocol/ext-apps": "1.7.4",
 		"@modelcontextprotocol/sdk": "1.30.0",
 		"@mozilla/readability": "0.6.0",