@ashx-j/lunr 0.2.13 → 0.2.15

package/docs/interactive-startup.md

@@ -0,0 +1,58 @@
+# Interactive startup plan
+
+Paint the normal lunR interface before importing the agent runtime. Models,
+resources, session restoration, extensions, and maintenance may take longer;
+they must not determine when the user first sees the chatbox.
+
+PR #41 starts a generic editor with a separate startup message, then changes the
+layout and editor after hydration. Its first-frame marker also accepts terminal
+setup writes. Keep its useful early routing and startup-dialog work, but replace
+the temporary presentation and measure actual rendered content.
+
+1. Start a persistent view using the existing themed ChatboxEditor,
+   BootScreenComponent, and stats renderer. Read only local display preferences.
+   Reuse the terminal and editor when InteractiveMode attaches. Unknown runtime
+   data fills in later; no second startup screen or editor reset.
+2. Begin runtime imports after a complete TUI frame has been written. Keep
+   session selection and trust dialogs on that terminal. Preserve drafts,
+   cursor position, and pasted images while initialization proceeds.
+3. Hold submissions until session and extension initialization completes, then
+   dispatch through the normal command/message handler. Keep failures visible
+   and allow exit while loading. Defer session retention and other maintenance.
+4. Verify real frame content without a runtime, editor identity across binding,
+   delayed/failing initialization, command routing, and noninteractive launches.
+   Benchmark first content frame separately from runtime and feature readiness,
+   using isolated settings and both cold and warm compile caches.
+
+This PR targets startup only. The permission, rollback, orchestrator, and release
+changes in #41 remain separate. Custom extension themes/editors become available
+when their resources load; the builtin moon interface is available immediately.
+
+## Validation
+
+The Node CLI keeps one terminal and one moon editor through attachment. Enter
+during loading holds the current draft. Edits continue to change that draft;
+Escape cancels the pending submission. Commands run through the normal handler
+after features are ready. A failed feature load preserves the draft and reports
+the error instead of submitting it.
+
+The shipped moon theme avoids loading the schema compiler and highlighter before
+paint. Custom theme validation and syntax highlighting use the same implementations
+on first use. Footer git discovery and diffs run asynchronously.
+
+After the offline builds, run:
+
+```sh
+node scripts/check-interactive-first-paint.mjs
+node scripts/profile-coding-agent-node.mjs --mode tui --skip-build --isolated-agent-dir --runs 3
+```
+
+The first command exercises the built CLI with runtime loading stalled or failed.
+It verifies the real chatbox appears before hydration, accepts edits while
+waiting, and restores the terminal on exit. The Vitest integration also checks
+editor identity, cursor position, images, dialogs, and delayed command dispatch.
+
+On Windows with Node 24.15.0 and moon, three fresh compile-cache runs wrote the
+first complete frame in 94.8–95.3ms. Three warm runs measured 96.6–99.1ms. Feature
+readiness came at 2.01–2.43s. Milestones include Node entry-module loading.
+Terminal compositor latency and compiled Bun binaries were not measured.

package/docs/keybindings.md

@@ -87,7 +87,7 @@ Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1
 | `app.exit` | `ctrl+d` | Exit (when editor empty) |
 | `app.suspend` | `ctrl+z` (none on Windows) | Suspend to background |
 | `app.editor.external` | `ctrl+g` | Open in external editor (`externalEditor`, `$VISUAL`, `$EDITOR`, Notepad on Windows, or `nano` elsewhere) |
-| `app.clipboard.pasteImage` | `ctrl+v` (`alt+v` on Windows) | Paste image from clipboard |
+| `app.clipboard.pasteImage` | `ctrl+v` (`alt+v` on Windows) | Paste image from clipboard; `/paste-image` needs no shortcut |
 
 ### Sessions
 

package/docs/model-catalog.md

@@ -0,0 +1,29 @@
+# Model catalog maintenance
+
+Routine catalog updates use HTTP requests and deterministic TypeScript normalization, with no AI inference or agent runs.
+
+## Discovery and precedence
+
+The public generator combines models.dev, OpenRouter, Vercel, NVIDIA, OpenCode Zen/Go, and OpenAI's published Codex metadata. Codex model IDs come from that upstream document, not a handwritten list.
+
+At runtime, supported providers also expose live discovery. Codex uses the authenticated account-specific `/codex/models` endpoint, including its client-version query and account header. The client version is resolved from official npm release metadata; only JSON metadata is fetched, never package code. If that lookup fails, discovery uses its last successful version or the bundled fallback.
+
+Provider-supplied capability fields override older published metadata for the same model. Missing fields use existing exact-model metadata or conservative defaults; unknown prices are marked unavailable in the picker. Explicit `models.json` and extension model configuration are applied last. API-specific transport compatibility remains code-owned.
+
+A successful Codex account list controls picker availability, including hidden models. Existing model records remain resolvable for saved sessions and explicit configuration. Codex context limits are route-specific: its default context is not necessarily the maximum advertised for the OpenAI API. Unknown reasoning levels are retained as metadata but are not offered or sent until lunR supports them. Server prompt templates are not imported.
+
+## Refresh and recovery
+
+Interactive startup uses cached or bundled data without catalog network requests. After prompt readiness, an idle poll checks for refreshes; successful automatic refreshes are limited to once an hour per runtime/account configuration, with a one-minute retry delay on failure. Active turns retain their model object, and shutdown cancels the poll. `/refresh` bypasses the freshness gate. The model picker and CLI model listing also request a freshness check; unresolved explicit CLI models get a discovery attempt.
+
+Live caches are scoped to provider, endpoint, and credential/account identity using a digest. A response from an account changed during the request is discarded. Legacy unscoped public provider caches remain readable; unscoped Codex account caches do not. A failed request retains the last good data for the same scope.
+
+## Publication
+
+The hourly `publish-model-catalog.yml` workflow validates sources and publication contracts, then publishes data directly to the dedicated `model-catalog` branch. Application code still goes through normal review. Each publication has an immutable content-addressed snapshot, per-shard checksums, source fetch timestamps/status, and a manifest. Clients fetch the manifest and only the shards for providers with stored credentials; the old master-branch index remains a fallback during migration. Custom catalog mirrors retain the legacy index/shard format.
+
+Source requests have bounded retries and a last-good cache. Invalid schemas and suspicious drops greater than 25% for a source/provider previously containing at least ten models reuse cached data and appear in the workflow summary/manifest. Other sources can still update. A first run without a valid source cache fails closed. The final bundle must contain at least 500 models and include Anthropic, OpenAI, Codex, and OpenRouter, with valid limits, inputs, and prices.
+
+For an upstream outage, inspect the workflow summary and manifest source status; the timestamps describe when data was actually fetched. For a legitimate large removal caught by the guard, review the upstream change before invalidating that source's last-good Actions cache. New provider protocols or incompatible capability schemas still require adapter work; discovery cannot grant access an account does not have.
+
+`npm run sync:model-catalog` regenerates the checked-in offline bundle. Normal release builds remain offline and copy that bundle into the CLI package. Deploying the runtime changes requires a new CLI release; the publication workflow becomes active after it lands on the default branch.

package/docs/quickstart.md

@@ -121,7 +121,8 @@ lunR loads context files at startup. Add an `AGENTS.md` file to tell it how to w
 
 lunR loads:
 
-- `~/.lunr/agent/AGENTS.md` for global instructions
+- `~/.lunr/agent/agents/AGENTS.md` for global instructions
+- `~/.lunr/agent/agents/<model-name>/AGENTS.md` for optional model-specific instructions enabled in `/settings`
 - `AGENTS.md` or `CLAUDE.md` from parent directories and the current directory
 
 Restart lunR, or run `/reload`, after changing context files.
@@ -137,7 +138,7 @@ lunr @README.md "Summarize this"
 lunr @src/app.ts @src/app.test.ts "Review these together"
 ```
 
-Paste images with Ctrl+V (Alt+V on Windows). The editor inserts `[image_1]`, `[image_2]`, … chips instead of a temp path. Dragging images into supported terminals also works.
+Paste images with Ctrl+V or Alt+V on Windows. VS Code owns those keys, so `/paste-image` pastes without a terminal shortcut. The editor inserts `[image_1]`, `[image_2]`, … chips instead of a temp path. Dragging images into supported terminals also works.
 
 ### Run shell commands
 

package/docs/settings.md

@@ -64,6 +64,8 @@ Use `/trust` in interactive mode to save a project trust decision for future ses
 | `memoryCharCap` | number | `5000` | Durable-facts memory character cap (1–30000) |
 | `sessionRetentionDays` | number | `30` | Delete session files older than N days at launch; `0` keeps forever |
 | `modelTiers` | object | - | Enable model tiers and per-tier thinking |
+| `modelInstructions` | object | `{ enabled: false, mode: "both" }` | Model-specific instructions and whether they append to or replace global instructions |
+| `confirmLargeSubagentLaunches` | boolean | `true` | Ask once before aggregate launches of three or more children outside Auto mode |
 | `enableAnalytics` | boolean | `false` | Opt-in analytics data sharing. Currently only asked for during the experimental first-time setup (`PI_EXPERIMENTAL=1`) |
 | `trackingId` | string | - | Analytics tracking identifier, generated when `enableAnalytics` is turned on |
 | `doubleEscapeAction` | string | `"tree"` | Action for double-escape: `"tree"`, `"fork"`, or `"none"` |
@@ -224,21 +226,19 @@ When multiple sources specify a session directory, precedence is `--session-dir`
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
-| `gutterRail` | boolean | `true` | Thin left rail around each turn |
-| `promptSymbol` | boolean | `true` | Show the ☾ › prompt glyph on the editor's first line |
 | `footerMcp` | boolean | `true` | Show MCP status in the footer |
 | `footerLsp` | boolean | `false` | Show LSP status in the footer |
 | `footerContext` | boolean | `true` | Show context-usage pct/window |
 | `footerTokens` | boolean | `true` | Show ↑in ↓out token totals |
 | `footerCacheHitRate` | boolean | `true` | Show the latest prompt cache-hit rate when reported |
 | `footerTps` | boolean | `true` | Show tokens/second. Independent of feature statuses |
-| `footerStatuses` | boolean | `true` | Show plan/goal/swarm status segments |
+| `footerStatuses` | boolean | `true` | Show plan and goal status segments |
 | `footerGit` | boolean | `true` | Show git branch + added/removed |
 | `footerPlan` | boolean | `true` | Show the subscription usage segment |
 | `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 → Footer as well.
+Customize these from `/settings` → Customize as well.
 
 ### Cron, rollback, subscriptions
 

package/docs/terminal-setup.md

@@ -97,7 +97,7 @@ Add to `keybindings.json`:
 }
 ```
 
-On Windows, lunR pastes clipboard images with `Alt+V` (`app.clipboard.pasteImage`). VS Code owns `Ctrl+V` and right-click paste (text only). VS Code also swallows `Alt+V` as the View menu mnemonic, so lunR never sees the key (no toast). Forward it with:
+On Windows, VS Code owns `Ctrl+V` and uses `Alt+V` as the View menu mnemonic. Forward lunR's `Alt+V` image-paste binding explicitly:
 
 ```json
 {
@@ -108,7 +108,7 @@ On Windows, lunR pastes clipboard images with `Alt+V` (`app.clipboard.pasteImage
 }
 ```
 
-A successful paste toasts `Pasted [image_1]` and inserts that chip in the editor. Submit keeps the label in the chat card and attaches the image to the model. `Clipboard contains no image or text` means the key arrived but the OS clipboard had no image.
+A successful paste toasts `Pasted [image_1]` and inserts that chip in the editor. If VS Code still owns the key, `/paste-image` invokes the same operation without depending on any terminal shortcut. Submit keeps the label in the chat card and attaches the image to the model. `Clipboard contains no image` means the command arrived but the OS clipboard had no image.
 
 ## Windows Terminal
 

package/docs/termux.md

@@ -34,7 +34,7 @@ Image clipboard is not supported on Termux (the `ctrl+v` image paste feature wil
 
 ## Example AGENTS.md for Termux
 
-Create `~/.lunr/agent/AGENTS.md` to help the agent understand the Termux environment:
+Create `~/.lunr/agent/agents/AGENTS.md` to help the agent understand the Termux environment:
 
 ````markdown
 # Agent Environment: Termux on Android

package/docs/usage.md

@@ -23,7 +23,7 @@ The editor can be replaced temporarily by built-in UI such as `/settings` or by
 | Path completion | Press Tab to complete paths |
 | Multi-line input | Shift+Enter, or Ctrl+Enter on Windows Terminal |
 | Copy response | Ctrl+X copies the last assistant message; in `/tree`, it copies the selected message |
-| Images | Paste with Ctrl+V, Alt+V on Windows, or drag into the terminal. Images insert `[image_n]` chips, not a temp path. |
+| Images | Paste with Ctrl+V, Alt+V on Windows, `/paste-image`, or drag into the terminal. VS Code must forward Alt+V. Images insert `[image_n]` chips. |
 | Shell command | `!command` runs and sends output to the model |
 | Hidden shell command | `!!command` runs without sending output to the model |
 | External editor | Ctrl+G opens `externalEditor`, `$VISUAL`, `$EDITOR`, Notepad on Windows, or `nano` elsewhere |
@@ -46,6 +46,7 @@ Built-in commands (from `slash-commands.ts`):
 | `/import` | Import and resume a session from a JSONL file |
 | `/share` | Share session as a secret GitHub gist. HTML viewer still defaults to https://pi.dev/session/ (leftover, not lunR-hosted). Override with `PI_SHARE_VIEWER_URL`. |
 | `/copy` | Copy last agent message to clipboard |
+| `/paste-image` | Paste an image from the clipboard |
 | `/name`, `/title` | Set session display name |
 | `/session` | Show session info and stats |
 | `/usage` | This-session token totals, context, and every stored subscription plan (no `/token-usage`) |
@@ -68,7 +69,6 @@ Built-in commands (from `slash-commands.ts`):
 | `/logout`, `/deauth` | Remove provider authentication |
 | `/new` | Start a new session |
 | `/init` | Generate a starter AGENTS.md for this project |
-| `/swarm` | Orchestrate parallel subagents for a complex task |
 | `/compact` | Manually compact the session context |
 | `/resume`, `/sessions` | Browse and resume sessions |
 | `/reload` | Reload keybindings, extensions, skills, prompts, themes, and context files |
@@ -120,7 +120,8 @@ See [Sessions](sessions.md) and [Compaction](compaction.md) for details.
 
 lunR loads `AGENTS.md` or `CLAUDE.md` at startup from:
 
-- `~/.lunr/agent/AGENTS.md` for global instructions
+- `~/.lunr/agent/agents/AGENTS.md` for global instructions
+- `~/.lunr/agent/agents/<model-name>/AGENTS.md` for optional model-specific instructions enabled in `/settings`
 - parent directories, walking up from the current working directory
 - the current directory
 

package/docs/windows.md

@@ -18,7 +18,7 @@ For most users, [Git for Windows](https://git-scm.com/download/win) is sufficien
 
 ## Image paste
 
-Ctrl+V is the terminal's paste. lunR image paste is **Alt+V**. The editor inserts `[image_n]` chips, not a temp path. VS Code may eat Alt+V (View mnemonic); forward it with `sendSequence` `\u001b[118;3u`.
+Ctrl+V is the terminal's paste. lunR image paste is **Alt+V**. The editor inserts `[image_n]` chips, not a temp path. VS Code must forward Alt+V with `sendSequence` `\u001b[118;3u`; `/paste-image` works without a terminal shortcut.
 
 ## LSP
 

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

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.2.13",
+      "version": "0.2.15",
       "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.13",
+	"version": "0.2.15",
 	"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.13",
+	"version": "0.2.15",
 	"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.13",
+	"version": "0.2.15",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-gondolin",
-			"version": "0.2.13",
+			"version": "0.2.15",
 			"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.13",
+	"version": "0.2.15",
 	"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.13",
+	"version": "0.2.15",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "0.2.13",
+			"version": "0.2.15",
 			"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.13",
+	"version": "0.2.15",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/subagent/README.md

@@ -1,6 +1,6 @@
 # Subagent Example (sample)
 
-This is an **Extension API sample**, not lunR's product subagent implementation. lunR ships baked-in subagents (always fresh; swarm gate for 3+ parallel). See [docs/features.md](../../../docs/features.md).
+This is an **Extension API sample**, not lunR's product subagent implementation. lunR ships baked-in subagents (always fresh; aggregate confirmation for 3+ parallel). See [docs/features.md](../../../docs/features.md).
 
 Delegate tasks to specialized subagents with isolated context windows.
 

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

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.2.13",
+      "version": "0.2.15",
       "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.13",
+	"version": "0.2.15",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ashx-j/lunr",
-	"version": "0.2.13",
+	"version": "0.2.15",
 	"description": "lunR — terminal coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -37,12 +37,12 @@
 		"shrinkwrap": "node ../../scripts/generate-coding-agent-shrinkwrap.mjs"
 	},
 	"dependencies": {
-		"@ashx-j/lunr-agent": "^0.2.13",
-		"@ashx-j/lunr-ai": "^0.2.13",
-		"@ashx-j/lunr-tui": "^0.2.13",
-		"@modelcontextprotocol/ext-apps": "^1.7.4",
+		"@ashx-j/lunr-agent": "^0.2.15",
+		"@ashx-j/lunr-ai": "^0.2.15",
+		"@ashx-j/lunr-tui": "^0.2.15",
+		"@modelcontextprotocol/ext-apps": "1.7.4",
 		"@modelcontextprotocol/sdk": "1.30.0",
-		"@mozilla/readability": "^0.6.0",
+		"@mozilla/readability": "0.6.0",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"@sinclair/typebox": "npm:typebox@1.1.38",
 		"chalk": "5.6.2",
@@ -55,23 +55,23 @@
 		"hosted-git-info": "9.0.3",
 		"ignore": "7.0.5",
 		"jiti": "2.7.0",
-		"linkedom": "^0.16.11",
+		"linkedom": "0.16.11",
 		"minimatch": "10.2.5",
-		"open": "^10.2.0",
-		"p-limit": "^6.2.0",
+		"open": "10.2.0",
+		"p-limit": "6.2.0",
 		"proper-lockfile": "4.1.2",
-		"recheck": "^4.5.0",
+		"recheck": "4.5.0",
 		"semver": "7.8.0",
-		"tree-sitter-wasms": "^0.1.13",
-		"turndown": "^7.2.4",
+		"tree-sitter-wasms": "0.1.13",
+		"turndown": "7.2.4",
 		"typebox": "1.1.38",
 		"undici": "8.5.0",
 		"unicode-animations": "1.0.3",
-		"unpdf": "^1.6.2",
-		"vscode-languageserver-protocol": "^3.18.2",
-		"web-tree-sitter": "^0.24.7",
+		"unpdf": "1.6.2",
+		"vscode-languageserver-protocol": "3.18.2",
+		"web-tree-sitter": "0.24.7",
 		"yaml": "2.9.0",
-		"zod": "^4.4.3"
+		"zod": "4.4.3"
 	},
 	"overrides": {
 		"rimraf": "6.1.2",

package/dist/core/swarm.d.ts

@@ -1,54 +0,0 @@
-/**
- * lunR: reusable swarm prompt builder.
- *
- * Moved out of interactive-mode so the gateway can decompose tasks across
- * parallel subagents the same way the TUI does.
- */
-export declare function buildSwarmPrompt(task: string): string;
-/**
- * lunR: agent-swarm auto-activation gate helpers.
- *
- * When the model launches more than SWARM_APPROVAL_THRESHOLD parallel subagents
- * in one `subagent` `tasks`/`chain.parallel` call, or that many same-turn SINGLE
- * `subagent` calls, that counts as an auto-activated agent swarm and requires
- * user approval in every permission mode except `auto` (see core/permissions.ts).
- * An explicit /swarm turn is pre-approved because the user already asked for the swarm.
- */
-/** Parallel-subagent count above which the swarm approval gate engages. */
-export declare const SWARM_APPROVAL_THRESHOLD = 2;
-/**
- * Effective number of parallel subagents a `subagent` tool call will launch:
- * the `tasks` array (with `count` multipliers) plus any `chain` step `parallel`
- * fan-out blocks. Sequential chain steps and single-agent calls count as 0.
- * Dynamic `expand` fan-out has no static count and is not gated.
- */
-export declare function effectiveSwarmCount(args: Record<string, unknown>): number;
-interface AssistantMessageLike {
-    content?: ReadonlyArray<{
-        type?: string;
-        name?: string;
-        arguments?: unknown;
-    }>;
-}
-/**
- * Parallel subagent count for the swarm gate. Uses this call's `tasks` / chain
- * `parallel` blocks, plus every other same-turn SINGLE `subagent` call so three
- * sibling singles still trip the >2 approval gate.
- */
-export declare function effectiveSwarmCountForTurn(args: Record<string, unknown>, assistantMessage?: AssistantMessageLike): number;
-interface BranchEntryLike {
-    type: string;
-    message?: {
-        role?: string;
-        content?: unknown;
-    };
-}
-/**
- * True when the current turn started from an explicit /swarm prompt (the most
- * recent user message carries the literal `[SWARM MODE]` prefix). Both the TUI
- * and the gateway inject the same buildSwarmPrompt text, so this works on both
- * surfaces without extra state.
- */
-export declare function isExplicitSwarmTurn(branch: readonly BranchEntryLike[]): boolean;
-export {};
-//# sourceMappingURL=swarm.d.ts.map

package/dist/core/swarm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/core/swarm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAe1C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAczE;AAaD,UAAU,oBAAoB;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,gBAAgB,CAAC,EAAE,oBAAoB,GACrC,MAAM,CAYR;AAED,UAAU,eAAe;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAaD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAO/E","sourcesContent":["/**\n * lunR: reusable swarm prompt builder.\n *\n * Moved out of interactive-mode so the gateway can decompose tasks across\n * parallel subagents the same way the TUI does.\n */\n\nexport function buildSwarmPrompt(task: string): string {\n\treturn `[SWARM MODE] Task: ${task}\nAct as an orchestrator. 1) Decompose into 3-8 independent subtasks. 2) Launch them\nin ONE parallel subagent call (async:false) as generic children, each with task,\ndescription, and permissions (\"full\" or \"read-only\"; omit permissions for full).\nUse read-only children for inspection/review and full children only when edits\nare required. Pick a model tier per subtask. 3) Synthesize the results and report.\nRules: max 8 concurrent children; no nested fan-out; if a subtask fails, retry\nonce with the heavy tier before giving up on it; keep your final report under\n100 lines with per-subtask status.`;\n}\n\n/**\n * lunR: agent-swarm auto-activation gate helpers.\n *\n * When the model launches more than SWARM_APPROVAL_THRESHOLD parallel subagents\n * in one `subagent` `tasks`/`chain.parallel` call, or that many same-turn SINGLE\n * `subagent` calls, that counts as an auto-activated agent swarm and requires\n * user approval in every permission mode except `auto` (see core/permissions.ts).\n * An explicit /swarm turn is pre-approved because the user already asked for the swarm.\n */\n\n/** Parallel-subagent count above which the swarm approval gate engages. */\nexport const SWARM_APPROVAL_THRESHOLD = 2;\n\nfunction countEntry(item: unknown): number {\n\tconst count = item && typeof item === \"object\" ? (item as { count?: unknown }).count : undefined;\n\treturn typeof count === \"number\" && Number.isInteger(count) && count >= 1 ? count : 1;\n}\n\nfunction isManagementCall(args: Record<string, unknown>): boolean {\n\treturn typeof args.action === \"string\" && args.action.length > 0;\n}\n\nfunction isAsyncDetached(args: Record<string, unknown>): boolean {\n\treturn args.async === true && args.clarify !== true;\n}\n\n/**\n * Effective number of parallel subagents a `subagent` tool call will launch:\n * the `tasks` array (with `count` multipliers) plus any `chain` step `parallel`\n * fan-out blocks. Sequential chain steps and single-agent calls count as 0.\n * Dynamic `expand` fan-out has no static count and is not gated.\n */\nexport function effectiveSwarmCount(args: Record<string, unknown>): number {\n\tlet total = 0;\n\tif (Array.isArray(args.tasks)) {\n\t\tfor (const task of args.tasks) total += countEntry(task);\n\t}\n\tif (Array.isArray(args.chain)) {\n\t\tfor (const step of args.chain) {\n\t\t\tconst parallel = step && typeof step === \"object\" ? (step as { parallel?: unknown }).parallel : undefined;\n\t\t\tif (Array.isArray(parallel)) {\n\t\t\t\tfor (const child of parallel) total += countEntry(child);\n\t\t\t}\n\t\t}\n\t}\n\treturn total;\n}\n\nfunction siblingSingleCount(args: Record<string, unknown>): number {\n\tif (isManagementCall(args) || isAsyncDetached(args)) return 0;\n\tif (Array.isArray(args.tasks) || Array.isArray(args.chain)) return 0;\n\treturn typeof args.task === \"string\" &&\n\t\targs.task.length > 0 &&\n\t\ttypeof args.description === \"string\" &&\n\t\targs.description.length > 0\n\t\t? 1\n\t\t: 0;\n}\n\ninterface AssistantMessageLike {\n\tcontent?: ReadonlyArray<{ type?: string; name?: string; arguments?: unknown }>;\n}\n\n/**\n * Parallel subagent count for the swarm gate. Uses this call's `tasks` / chain\n * `parallel` blocks, plus every other same-turn SINGLE `subagent` call so three\n * sibling singles still trip the >2 approval gate.\n */\nexport function effectiveSwarmCountForTurn(\n\targs: Record<string, unknown>,\n\tassistantMessage?: AssistantMessageLike,\n): number {\n\tconst own = effectiveSwarmCount(args);\n\tconst siblingSingles = (assistantMessage?.content ?? []).reduce((total, block) => {\n\t\tif (block.type !== \"toolCall\" || block.name !== \"subagent\") return total;\n\t\tconst siblingArgs =\n\t\t\tblock.arguments && typeof block.arguments === \"object\" && !Array.isArray(block.arguments)\n\t\t\t\t? (block.arguments as Record<string, unknown>)\n\t\t\t\t: undefined;\n\t\tif (!siblingArgs) return total;\n\t\treturn total + siblingSingleCount(siblingArgs);\n\t}, 0);\n\treturn Math.max(own, siblingSingles);\n}\n\ninterface BranchEntryLike {\n\ttype: string;\n\tmessage?: { role?: string; content?: unknown };\n}\n\nfunction messageText(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (Array.isArray(content)) {\n\t\treturn content\n\t\t\t.filter((c) => c && typeof c === \"object\" && (c as { type?: unknown }).type === \"text\")\n\t\t\t.map((c) => String((c as { text?: unknown }).text ?? \"\"))\n\t\t\t.join(\"\");\n\t}\n\treturn \"\";\n}\n\n/**\n * True when the current turn started from an explicit /swarm prompt (the most\n * recent user message carries the literal `[SWARM MODE]` prefix). Both the TUI\n * and the gateway inject the same buildSwarmPrompt text, so this works on both\n * surfaces without extra state.\n */\nexport function isExplicitSwarmTurn(branch: readonly BranchEntryLike[]): boolean {\n\tfor (let i = branch.length - 1; i >= 0; i--) {\n\t\tconst entry = branch[i];\n\t\tif (entry.type !== \"message\" || entry.message?.role !== \"user\") continue;\n\t\treturn messageText(entry.message.content).startsWith(\"[SWARM MODE]\");\n\t}\n\treturn false;\n}\n"]}

package/dist/core/swarm.js

@@ -1,119 +0,0 @@
-/**
- * lunR: reusable swarm prompt builder.
- *
- * Moved out of interactive-mode so the gateway can decompose tasks across
- * parallel subagents the same way the TUI does.
- */
-export function buildSwarmPrompt(task) {
-    return `[SWARM MODE] Task: ${task}
-Act as an orchestrator. 1) Decompose into 3-8 independent subtasks. 2) Launch them
-in ONE parallel subagent call (async:false) as generic children, each with task,
-description, and permissions ("full" or "read-only"; omit permissions for full).
-Use read-only children for inspection/review and full children only when edits
-are required. Pick a model tier per subtask. 3) Synthesize the results and report.
-Rules: max 8 concurrent children; no nested fan-out; if a subtask fails, retry
-once with the heavy tier before giving up on it; keep your final report under
-100 lines with per-subtask status.`;
-}
-/**
- * lunR: agent-swarm auto-activation gate helpers.
- *
- * When the model launches more than SWARM_APPROVAL_THRESHOLD parallel subagents
- * in one `subagent` `tasks`/`chain.parallel` call, or that many same-turn SINGLE
- * `subagent` calls, that counts as an auto-activated agent swarm and requires
- * user approval in every permission mode except `auto` (see core/permissions.ts).
- * An explicit /swarm turn is pre-approved because the user already asked for the swarm.
- */
-/** Parallel-subagent count above which the swarm approval gate engages. */
-export const SWARM_APPROVAL_THRESHOLD = 2;
-function countEntry(item) {
-    const count = item && typeof item === "object" ? item.count : undefined;
-    return typeof count === "number" && Number.isInteger(count) && count >= 1 ? count : 1;
-}
-function isManagementCall(args) {
-    return typeof args.action === "string" && args.action.length > 0;
-}
-function isAsyncDetached(args) {
-    return args.async === true && args.clarify !== true;
-}
-/**
- * Effective number of parallel subagents a `subagent` tool call will launch:
- * the `tasks` array (with `count` multipliers) plus any `chain` step `parallel`
- * fan-out blocks. Sequential chain steps and single-agent calls count as 0.
- * Dynamic `expand` fan-out has no static count and is not gated.
- */
-export function effectiveSwarmCount(args) {
-    let total = 0;
-    if (Array.isArray(args.tasks)) {
-        for (const task of args.tasks)
-            total += countEntry(task);
-    }
-    if (Array.isArray(args.chain)) {
-        for (const step of args.chain) {
-            const parallel = step && typeof step === "object" ? step.parallel : undefined;
-            if (Array.isArray(parallel)) {
-                for (const child of parallel)
-                    total += countEntry(child);
-            }
-        }
-    }
-    return total;
-}
-function siblingSingleCount(args) {
-    if (isManagementCall(args) || isAsyncDetached(args))
-        return 0;
-    if (Array.isArray(args.tasks) || Array.isArray(args.chain))
-        return 0;
-    return typeof args.task === "string" &&
-        args.task.length > 0 &&
-        typeof args.description === "string" &&
-        args.description.length > 0
-        ? 1
-        : 0;
-}
-/**
- * Parallel subagent count for the swarm gate. Uses this call's `tasks` / chain
- * `parallel` blocks, plus every other same-turn SINGLE `subagent` call so three
- * sibling singles still trip the >2 approval gate.
- */
-export function effectiveSwarmCountForTurn(args, assistantMessage) {
-    const own = effectiveSwarmCount(args);
-    const siblingSingles = (assistantMessage?.content ?? []).reduce((total, block) => {
-        if (block.type !== "toolCall" || block.name !== "subagent")
-            return total;
-        const siblingArgs = block.arguments && typeof block.arguments === "object" && !Array.isArray(block.arguments)
-            ? block.arguments
-            : undefined;
-        if (!siblingArgs)
-            return total;
-        return total + siblingSingleCount(siblingArgs);
-    }, 0);
-    return Math.max(own, siblingSingles);
-}
-function messageText(content) {
-    if (typeof content === "string")
-        return content;
-    if (Array.isArray(content)) {
-        return content
-            .filter((c) => c && typeof c === "object" && c.type === "text")
-            .map((c) => String(c.text ?? ""))
-            .join("");
-    }
-    return "";
-}
-/**
- * True when the current turn started from an explicit /swarm prompt (the most
- * recent user message carries the literal `[SWARM MODE]` prefix). Both the TUI
- * and the gateway inject the same buildSwarmPrompt text, so this works on both
- * surfaces without extra state.
- */
-export function isExplicitSwarmTurn(branch) {
-    for (let i = branch.length - 1; i >= 0; i--) {
-        const entry = branch[i];
-        if (entry.type !== "message" || entry.message?.role !== "user")
-            continue;
-        return messageText(entry.message.content).startsWith("[SWARM MODE]");
-    }
-    return false;
-}
-//# sourceMappingURL=swarm.js.map

package/dist/core/swarm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/core/swarm.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunR: reusable swarm prompt builder.\n *\n * Moved out of interactive-mode so the gateway can decompose tasks across\n * parallel subagents the same way the TUI does.\n */\n\nexport function buildSwarmPrompt(task: string): string {\n\treturn `[SWARM MODE] Task: ${task}\nAct as an orchestrator. 1) Decompose into 3-8 independent subtasks. 2) Launch them\nin ONE parallel subagent call (async:false) as generic children, each with task,\ndescription, and permissions (\"full\" or \"read-only\"; omit permissions for full).\nUse read-only children for inspection/review and full children only when edits\nare required. Pick a model tier per subtask. 3) Synthesize the results and report.\nRules: max 8 concurrent children; no nested fan-out; if a subtask fails, retry\nonce with the heavy tier before giving up on it; keep your final report under\n100 lines with per-subtask status.`;\n}\n\n/**\n * lunR: agent-swarm auto-activation gate helpers.\n *\n * When the model launches more than SWARM_APPROVAL_THRESHOLD parallel subagents\n * in one `subagent` `tasks`/`chain.parallel` call, or that many same-turn SINGLE\n * `subagent` calls, that counts as an auto-activated agent swarm and requires\n * user approval in every permission mode except `auto` (see core/permissions.ts).\n * An explicit /swarm turn is pre-approved because the user already asked for the swarm.\n */\n\n/** Parallel-subagent count above which the swarm approval gate engages. */\nexport const SWARM_APPROVAL_THRESHOLD = 2;\n\nfunction countEntry(item: unknown): number {\n\tconst count = item && typeof item === \"object\" ? (item as { count?: unknown }).count : undefined;\n\treturn typeof count === \"number\" && Number.isInteger(count) && count >= 1 ? count : 1;\n}\n\nfunction isManagementCall(args: Record<string, unknown>): boolean {\n\treturn typeof args.action === \"string\" && args.action.length > 0;\n}\n\nfunction isAsyncDetached(args: Record<string, unknown>): boolean {\n\treturn args.async === true && args.clarify !== true;\n}\n\n/**\n * Effective number of parallel subagents a `subagent` tool call will launch:\n * the `tasks` array (with `count` multipliers) plus any `chain` step `parallel`\n * fan-out blocks. Sequential chain steps and single-agent calls count as 0.\n * Dynamic `expand` fan-out has no static count and is not gated.\n */\nexport function effectiveSwarmCount(args: Record<string, unknown>): number {\n\tlet total = 0;\n\tif (Array.isArray(args.tasks)) {\n\t\tfor (const task of args.tasks) total += countEntry(task);\n\t}\n\tif (Array.isArray(args.chain)) {\n\t\tfor (const step of args.chain) {\n\t\t\tconst parallel = step && typeof step === \"object\" ? (step as { parallel?: unknown }).parallel : undefined;\n\t\t\tif (Array.isArray(parallel)) {\n\t\t\t\tfor (const child of parallel) total += countEntry(child);\n\t\t\t}\n\t\t}\n\t}\n\treturn total;\n}\n\nfunction siblingSingleCount(args: Record<string, unknown>): number {\n\tif (isManagementCall(args) || isAsyncDetached(args)) return 0;\n\tif (Array.isArray(args.tasks) || Array.isArray(args.chain)) return 0;\n\treturn typeof args.task === \"string\" &&\n\t\targs.task.length > 0 &&\n\t\ttypeof args.description === \"string\" &&\n\t\targs.description.length > 0\n\t\t? 1\n\t\t: 0;\n}\n\ninterface AssistantMessageLike {\n\tcontent?: ReadonlyArray<{ type?: string; name?: string; arguments?: unknown }>;\n}\n\n/**\n * Parallel subagent count for the swarm gate. Uses this call's `tasks` / chain\n * `parallel` blocks, plus every other same-turn SINGLE `subagent` call so three\n * sibling singles still trip the >2 approval gate.\n */\nexport function effectiveSwarmCountForTurn(\n\targs: Record<string, unknown>,\n\tassistantMessage?: AssistantMessageLike,\n): number {\n\tconst own = effectiveSwarmCount(args);\n\tconst siblingSingles = (assistantMessage?.content ?? []).reduce((total, block) => {\n\t\tif (block.type !== \"toolCall\" || block.name !== \"subagent\") return total;\n\t\tconst siblingArgs =\n\t\t\tblock.arguments && typeof block.arguments === \"object\" && !Array.isArray(block.arguments)\n\t\t\t\t? (block.arguments as Record<string, unknown>)\n\t\t\t\t: undefined;\n\t\tif (!siblingArgs) return total;\n\t\treturn total + siblingSingleCount(siblingArgs);\n\t}, 0);\n\treturn Math.max(own, siblingSingles);\n}\n\ninterface BranchEntryLike {\n\ttype: string;\n\tmessage?: { role?: string; content?: unknown };\n}\n\nfunction messageText(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (Array.isArray(content)) {\n\t\treturn content\n\t\t\t.filter((c) => c && typeof c === \"object\" && (c as { type?: unknown }).type === \"text\")\n\t\t\t.map((c) => String((c as { text?: unknown }).text ?? \"\"))\n\t\t\t.join(\"\");\n\t}\n\treturn \"\";\n}\n\n/**\n * True when the current turn started from an explicit /swarm prompt (the most\n * recent user message carries the literal `[SWARM MODE]` prefix). Both the TUI\n * and the gateway inject the same buildSwarmPrompt text, so this works on both\n * surfaces without extra state.\n */\nexport function isExplicitSwarmTurn(branch: readonly BranchEntryLike[]): boolean {\n\tfor (let i = branch.length - 1; i >= 0; i--) {\n\t\tconst entry = branch[i];\n\t\tif (entry.type !== \"message\" || entry.message?.role !== \"user\") continue;\n\t\treturn messageText(entry.message.content).startsWith(\"[SWARM MODE]\");\n\t}\n\treturn false;\n}\n"]}