@selesai/code 0.13.33 → 0.13.35

package/docs/settings.md

@@ -49,8 +49,8 @@ Use `/trust` in interactive mode to save a project trust decision for future ses
 ### Jev Advisory Routing
 
 The bundled `jev-advisory-routing` extension uses the Jev decisions model for bounded opt-in
-routing. Every route stays off until it is enabled in `jevAdvisory`; the two routes share one
-Jev provider/model pair:
+routing. The host-side routes stay off until they are enabled in `jevAdvisory`; the agent's own
+`ask` route is on by default. All routes share one Jev provider/model pair:
 
 - `memory` — only after an explicit durable-memory cue (for example “the convention we
   decided” or “don't repeat the past failure”), Jev chooses one read-only local
@@ -58,6 +58,29 @@ Jev provider/model pair:
 - `recommendations` — one discovered skill or prompt workflow that fits, or a proportionate
   verification level. Nothing is loaded, started, or executed: the recommendation is context for the
   agent, and required project/workflow gates are unchanged.
+- `ask` — the agent-callable `ask_jev` tool (on by default). The agent decides when to call it: it
+  passes its own prose, file `paths`, and one `command`, and gets typed choice/score/noul answers back —
+  never the file contents or command output, so a verdict about code costs a few lines of context
+  instead of the files. Files must be inside the working directory, secret-named files (`.env`,
+  `*.pem`, `id_rsa*`, `auth.json`, …) are refused, and the command runs through the bash tool's local
+  shell. Whatever the agent passes is sent to Jev. Without Token-In credentials the tool is taken out
+  of the agent's loadout before each run (it returns after `/tokenin add`, no reload needed), and a call
+  that slips through reads no file and runs no command.
+
+  The same route also offers `jev_find`, a file finder: ripgrep gathers up to 48 candidate files
+  (those matching `pattern`, or every file under `path` filtered by `glob`, ranked by question words),
+  Jev judges each file's best-matching lines against the agent's `question` in parallel batches of 16,
+  and the agent gets ranked `path:lines (relevance)` pointers — never file contents. It respects
+  `.gitignore`, stays inside the working directory, skips secret-named files, and still returns the
+  unranked candidates when Jev is unavailable.
+- `subagent` — sets up a single-child `subagent` call from the parent agent (off by default). Jev only
+  fills what the parent left open, and can only narrow: (1) when `agent` is omitted or generic
+  (`genericAgents`, default `["delegate"]`), it picks an agent by function from enabled native agents
+  inside the capability ceiling; (2) it may drop tools from that agent's declared `tools` for this run
+  (never `read` or supervision tools, and never adds one); (3) when `tiers` is set and the parent
+  passed no `model`, it picks `simple`, `complex`, or `reasoning` and launches that tier's model. Jev
+  sees only the task and agent descriptions. Any abstention launches exactly what was asked; an
+  agentless task that Jev cannot route is rejected with a request to name an agent.
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
@@ -66,11 +89,18 @@ Jev provider/model pair:
 | `jevAdvisory.baseUrl` | string | inherited | Base URL override; defaults to any registered model of `provider` |
 | `jevAdvisory.routes.memory.enabled` | boolean | `false` | Enable the memory-lookup route |
 | `jevAdvisory.routes.recommendations.enabled` | boolean | `false` | Enable skill/workflow and verification recommendations |
-| `<route>.timeoutMs` | number | `8000` | Route request timeout (ms); memory is capped at 750ms |
+| `jevAdvisory.routes.ask.enabled` | boolean | `true` | Offer the agent the `ask_jev` and `jev_find` tools; set `false` to turn both off |
+| `jevAdvisory.routes.subagent.enabled` | boolean | `false` | Let Jev choose the agent, tools, and model tier of a subagent call |
+| `jevAdvisory.routes.subagent.tiers` | object | unset | `{ "simple"?, "complex"?, "reasoning"? }` → `provider/id` model; tier routing needs at least two |
+| `jevAdvisory.routes.subagent.genericAgents` | string[] | `["delegate"]` | Agents Jev may replace with a specialist |
+| `<route>.timeoutMs` | number | `8000` | Route request timeout (ms); memory is capped at 750ms; `ask` defaults to `15000`, `subagent` to `5000` |
 | `<route>.minConfidence` | number | `0.6` | Below this Jev confidence the route abstains |
 | `<route>.contextTurns` | number | `4` | Prior user turns sent as recommendation context; memory sends only the current bounded prompt |
 | `<route>.contextChars` | number | `4000` | Character budget for recommendation context |
-| `<route>.payloadBytes` | number | `8192` | Hard cap on the serialized decision request |
+| `<route>.payloadBytes` | number | `8192` | Hard cap on the serialized decision request; `ask` defaults to `32768`, `subagent` to `16384` |
+
+`ask` ignores `minConfidence`, `contextTurns`, and `contextChars`: it returns every confidence to the
+agent, and its context is whatever the agent put in the request.
 
 Only idle, top-level, interactive prompts are routed: queued steering/follow-up input, slash
 commands, and extension-injected turns are skipped, and each turn is routed at most once. The memory
@@ -99,16 +129,28 @@ needed: a compact `capability_catalog` lists them, `capability_discover` activat
 current run, and `capability_skill_show` loads one skill's full instructions. Set
 `SELESAI_CAPABILITY_GATEWAY=0` to disable the gateway and keep every tool visible.
 
-Routing has two rungs:
+Routing has three rungs:
 
 1. A deterministic router activates a tool when the prompt uniquely matches its name, alias, or
    discovery summary. Skills are never auto-loaded or auto-selected.
 2. Default-on Jev tie-breaking: when the deterministic router returns an ambiguous lexical hint
    among optional tools, the Jev decisions model is asked which of two or three hinted tools (or
    `none`) should be exposed. Jev sees only the bounded current prompt and each hinted tool's compact
-   discovery line — never conversation history, tool schemas, or the full catalog. A prompt with no
+   discovery line — never conversation history or tool schemas. A prompt with no
    lexical signal, a unique activation, and a skill-only match never reach Jev. Token-In credentials
    are required; without them, no Jev request is sent and Selesai prompts you to run `/tokenin add`.
+3. The agent-driven route: `capability_discover` also takes a `job` instead of a name. Tools and
+   skills are separate decisions — a tool is callable code from an extension or MCP server that the
+   agent may use many times, a skill is a written procedure it reads once — so one Jev request asks
+   two questions, each from catalog metadata only (never a schema or skill body), each allowed to
+   answer `none`. A chosen tool is activated for the run and its parameters are returned; a chosen
+   skill is named for `capability_skill_show`. Tools are offered first, so only skills can be left out
+   of an oversized catalog, and a `none` then says how many were not considered. A skill found in
+   several sources is offered once. While Jev has no credential, the `job` route is left out of the
+   agent's instructions and the agent is pointed at `capability_catalog` plus an exact `name`.
+
+All Jev features share one warning per session, shown the first time one of them actually needs the
+missing credential; a user without a subscription is not warned just for starting a session.
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
@@ -117,8 +159,9 @@ Routing has two rungs:
 | `capabilityGateway.routing.jev.model` | string | `"jev-1.13"` | Decisions model the tie-breaker calls |
 | `capabilityGateway.routing.jev.baseUrl` | string | inherited | Base URL override; defaults to any registered model of `provider` |
 | `capabilityGateway.routing.jev.timeoutMs` | number | `1000` | Pre-turn request timeout (ms); hard-capped at `2000` |
+| `capabilityGateway.routing.jev.discoverTimeoutMs` | number | `5000` | Timeout (ms) for `capability_discover({ job })`; hard-capped at `15000` |
 | `capabilityGateway.routing.jev.minConfidence` | number | `0.6` | Below this Jev confidence the tie-breaker abstains |
-| `capabilityGateway.routing.jev.payloadBytes` | number | `8192` | Hard cap on the serialized decision request |
+| `capabilityGateway.routing.jev.payloadBytes` | number | `32768` | Hard cap on the serialized decision request; the pre-turn tie-break uses a few hundred bytes of it |
 
 This area is independent of `jevAdvisory`: gateway routing reads only
 `capabilityGateway.routing.jev` and shares just the Jev provider/model deployment identity. A
@@ -362,6 +405,20 @@ When selesai reads extensions from both `~/.selesai/agent/extensions/` and `~/.p
 
 Keys are top-level entry names (dir name for packaged extensions, file name for loose `.ts`). Values are `"selesai"` or `"pi"`. See [Shared Host Extensions](shared-host-extensions.md) for the full flow.
 
+## Bundled extension settings
+
+The `pi-hermes-memory` extension reads its options from the `hermesMemory` object in global `~/.selesai/agent/settings.json`:
+
+```json
+{
+  "hermesMemory": {
+    "llmThinkingOverride": "off",
+    "consolidationTimeoutMs": 300000
+  }
+}
+```
+
+These settings load at startup and take precedence over the legacy `hermes-memory-config.json` fallback. `llmModelOverride` is optional and uses `provider/model` format (for example, `tokenin/deepseek-v4.1-flash` if your account has access); leave it unset to use the active model. See the [memory extension configuration reference](../src/extensions/pi-hermes-memory/README.md#configuration) for all options.
 
 ## Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.33",
+  "version": "0.13.35",
   "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
   "type": "module",
   "engines": {
@@ -55,8 +55,8 @@
     "clean": "shx rm -rf dist",
     "dev": "tsx src/cli.ts",
     "dev:print": "tsx src/cli.ts --print",
-    "test": "vitest run src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/pi-graft src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
-    "test:coverage": "vitest run --coverage src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
+    "test": "vitest run src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/pi-graft src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
+    "test:coverage": "vitest run --coverage src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
     "prepare": "npm run build",
     "build": "npm run clean && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
     "copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/ && shx mkdir -p dist/defaults && shx cp src/defaults/* dist/defaults/ && shx mkdir -p dist/extensions && node scripts/copy-extensions.mjs && shx mkdir -p dist/themes && shx cp -r src/themes/. dist/themes/ && shx mkdir -p dist/skills && shx cp -r src/skills/. dist/skills/"