mixdog 0.9.110 → 0.9.112

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mixdog",
-  "version": "0.9.110",
+  "version": "0.9.112",
   "private": false,
   "type": "module",
   "description": "Standalone mixdog coding-agent CLI/TUI workspace.",
@@ -48,72 +48,24 @@
     "prepublishOnly": "node -e \"if(!process.env.CI){console.error('local npm publish is disabled — run npm run release:patch');process.exit(1)}\"",
     "start": "node src/cli.mjs",
     "smoke": "node scripts/smoke.mjs",
-    "test:contract": "node scripts/run-suite.mjs contract",
-    "smoke:all": "npm run smoke && npm run smoke:boot && npm run smoke:patch && npm run smoke:output && npm run smoke:tui && npm run smoke:live-worker",
+    "smoke:all": "npm run smoke && npm run smoke:boot && npm run smoke:patch && npm run smoke:compact",
     "smoke:boot": "node scripts/boot-smoke.mjs",
     "smoke:compact": "node scripts/compact-smoke.mjs",
-    "test:compact": "node --test scripts/compact-active-turn-test.mjs scripts/compact-file-reattach-test.mjs scripts/compact-prior-context-flatten-test.mjs scripts/compact-recall-digest-test.mjs scripts/compact-pressure-test.mjs",
-    "test:context": "node --test scripts/context-mcp-metering-test.mjs scripts/v4a-context-miss-excerpt-test.mjs",
+    "test:compact": "node --test scripts/suite-compact-test.mjs",
     "smoke:loop": "node scripts/smoke-loop.mjs",
     "smoke:loop:final": "node scripts/smoke-loop-report.mjs --require-complete --min-elapsed 5h --min-iterations 400 --max-gap 60s --max-smoke-ms 10000 --max-avg-smoke-ms 8500 --max-step-ms smoke.mjs=4000 --max-step-ms boot-smoke.mjs=8000 --max-rss-mb 140 --max-rss-growth-mb 50",
     "smoke:loop:report": "node scripts/smoke-loop-report.mjs",
     "test:tool-contracts": "node scripts/tool-smoke.mjs",
     "smoke:patch": "node scripts/apply-patch-edit-smoke.mjs",
-    "smoke:patch-replay": "node scripts/apply-patch-replay-smoke.mjs",
-    "smoke:tool-rescue": "node scripts/tool-rescue-smoke.mjs",
-    "smoke:output": "node scripts/output-style-smoke.mjs",
-    "smoke:tui": "node scripts/build-tui.mjs && node scripts/tui-render-smoke.mjs && npm run test:tui-input-render && npm run test:tui-streaming-window && npm run test:tui-queue",
-    "smoke:freevars": "node scripts/freevar-smoke.mjs",
-    "smoke:logguard": "node scripts/log-writer-guard-smoke.mjs",
-    "smoke:live-worker": "node scripts/live-worker-smoke.mjs",
-    "smoke:agent-tag-reuse": "node scripts/agent-tag-reuse-smoke.mjs",
-    "test:agent-terminal-reap": "node scripts/agent-terminal-reap-test.mjs",
-    "test:agent-job-views": "node --test scripts/agent-job-terminal-view-test.mjs",
-    "test:agent-fanout": "node scripts/agent-parallel-smoke.mjs && node --test scripts/agent-route-batch-test.mjs scripts/execution-completion-dedup-test.mjs",
-    "test:toolcall": "node --test scripts/toolcall-args-test.mjs",
-    "test:tool-batching": "node --test scripts/eager-patch-shell-order-test.mjs scripts/session-bench-batching-test.mjs scripts/tool-cwd-rebind-test.mjs",
-    "test:shipmode": "node --test scripts/ship-mode-test.mjs",
-    "test:shellhardening": "node --test scripts/shell-hardening-test.mjs scripts/shell-failure-diagnostics-test.mjs scripts/windows-hide-spawn-options-test.mjs scripts/shell-job-session-scope-test.mjs",
-    "test:placeholder": "node --test scripts/compacted-placeholder-scrub-test.mjs",
-    "test:providers": "node --test scripts/provider-toolcall-test.mjs scripts/provider-contract-test.mjs scripts/provider-stream-stall-test.mjs scripts/provider-stream-outcome-test.mjs scripts/stream-frame-fault-matrix-test.mjs scripts/gemini-provider-test.mjs scripts/anthropic-transport-policy-test.mjs scripts/anthropic-native-block-replay-test.mjs scripts/openai-oauth-ws-1006-retry-test.mjs scripts/stream-close-retry-test.mjs scripts/openai-end-turn-signal-test.mjs",
-    "test:provider-admission": "node --test scripts/provider-admission-scheduler-test.mjs scripts/provider-stream-json-test.mjs",
-    "test:resource-admission": "node --test scripts/resource-admission-test.mjs scripts/child-spawn-isolation-test.mjs scripts/owner-fair-gate-test.mjs",
-    "test:deferred-tools": "node --test scripts/deferred-tool-loading-test.mjs",
-    "test:anthropic-oauth-race": "node --test scripts/anthropic-oauth-refresh-race-test.mjs",
-    "test:grok-oauth-race": "node --test scripts/grok-oauth-refresh-race-test.mjs",
-    "test:atomiclock": "node --test scripts/atomic-lock-tryonce-test.mjs",
-    "test:keychain": "node --test scripts/keychain-prewarm-test.mjs",
-    "test:memory-leaks": "node --expose-gc --test scripts/memory-retention-test.mjs scripts/memory-worker-stability-test.mjs scripts/session-transport-test.mjs apps/desktop/src/renderer/memory-retention.test.mjs",
-    "test:memory-routing": "node --test scripts/memory-cycle-routing-test.mjs scripts/maintenance-default-routes-test.mjs scripts/embedding-worker-exit-test.mjs scripts/embedding-runtime-prune-test.mjs",
-    "test:embedding-runtime": "node --test scripts/embedding-runtime-prune-test.mjs scripts/memory-pg-recovery-test.mjs && node scripts/verify-embedding-runtime.mjs",
-    "test:embedding-runtime:core": "node --test scripts/embedding-runtime-prune-test.mjs scripts/memory-pg-recovery-test.mjs && node scripts/verify-embedding-runtime.mjs --core",
+    "test:shellhardening": "node --test scripts/suite-shellhardening-test.mjs",
+    "test:providers": "node --test scripts/provider-toolcall-test.mjs scripts/provider-contract-test.mjs scripts/provider-stream-outcome-test.mjs",
     "test:embedding-runtime:warmup": "node scripts/verify-embedding-runtime.mjs --warmup",
-    "prepare:code-graph-test": "node scripts/prepare-code-graph-test.mjs",
-    "test:code-graph-dispatch": "node --test scripts/code-graph-dispatch-test.mjs",
-    "test:tui-queue": "node --test scripts/submit-commandbusy-race-test.mjs scripts/steering-drain-buckets-test.mjs scripts/abort-recovery-test.mjs scripts/message-rewind-test.mjs scripts/execution-pending-resume-kick-test.mjs scripts/execution-resume-esc-integration-test.mjs scripts/pending-stale-injection-test.mjs",
-    "test:tui-input-render": "node --test scripts/prompt-immediate-render-test.mjs scripts/prompt-key-parity-test.mjs",
-    "test:tui-streaming-window": "node --test scripts/streaming-tail-window-test.mjs scripts/tui-store-frame-batch-test.mjs && node scripts/tui-transcript-jitter-harness.mjs",
-    "test:tui-ambiguous-width": "node --test scripts/tui-ambiguous-width-test.mjs",
-    "test:release-assets": "node --check scripts/verify-release-assets.mjs && node --check scripts/verify-release-assets-test.mjs && node --check scripts/deploy-workflow-test.mjs && node --check scripts/release-version-discipline-test.mjs && node --test scripts/verify-release-assets-test.mjs scripts/deploy-workflow-test.mjs scripts/release-version-discipline-test.mjs",
-    "test:release-focused": "npm run test:release-focused:contracts && npm run test:release-focused:providers && npm run test:release-focused:compact && npm run test:release-focused:session",
-    "test:release-focused:contracts": "npm run test:release-assets && npm run test:tool-contracts && npm run test:tool-batching && npm run test:placeholder && npm run smoke:patch && npm run test:patch-binary-cache",
-    "test:release-focused:providers": "npm run test:providers && npm run test:deferred-tools && npm run test:compact && npm run test:context && npm run prepare:code-graph-test && node --test scripts/code-graph-root-federation-test.mjs scripts/code-graph-aggregate-cwd-test.mjs && npm run test:code-graph-dispatch && node --test scripts/code-graph-disk-hit-test.mjs",
-    "test:release-focused:compact": "npm run smoke:compact && npm run test:shellhardening",
-    "test:release-focused:session": "npm run test:project-registry && npm run test:session && npm run test:workflow-editor && npm run test:embedding-runtime && node --test scripts/tui-transcript-perf-test.mjs",
-    "test:native-edit-wire": "node --test scripts/native-edit-wire-test.mjs",
-    "test:patch-binary-cache": "node --test scripts/patch-binary-cache-test.mjs",
-    "test:patch-parity": "node --test scripts/v4a-parity-test.mjs",
-    "test:project-registry": "node --test scripts/project-registry-isolation-test.mjs",
-    "test:session-transport": "node --test scripts/fair-call-scheduler-test.mjs scripts/session-transport-test.mjs scripts/session-tui-parity-test.mjs scripts/session-recovery-test.mjs scripts/session-submit-delivery-test.mjs scripts/daemon-process-lifetime-test.mjs scripts/session-multipane-stress-test.mjs && node --test scripts/runtime-isolation-stress-test.mjs",
-    "smoke:session": "node scripts/session-smoke.mjs",
-    "test:session": "node --test scripts/runtime-turn-contract-test.mjs scripts/session-orphan-sweep-test.mjs scripts/interrupted-turn-history-test.mjs scripts/turn-checkpoint-crash-test.mjs scripts/turn-outcome-fault-matrix-test.mjs scripts/session-save-fault-store-test.mjs scripts/session-disk-authority-test.mjs scripts/session-load-cache-race-test.mjs scripts/agent-loop-complete-turn-test.mjs scripts/session-heartbeat-lifecycle-test.mjs scripts/remote-transition-order-test.mjs scripts/session-new-reset-test.mjs scripts/turn-ttft-critical-path-test.mjs",
-    "test:live-canary": "node --test scripts/live-canary-test.mjs",
-    "test:rebindtail": "node --test scripts/forwarder-rebind-tail-test.mjs scripts/channel-remote-format-test.mjs",
-    "test:workflow-editor": "node --test scripts/workflow-id-test.mjs scripts/workflow-pack-editor-test.mjs",
-    "test:route-scope": "node --test scripts/route-scope-isolation-test.mjs",
-    "test:schedule-reload": "node --test scripts/schedule-reload-arm-test.mjs",
+    "test:release-assets": "node --check scripts/verify-release-assets.mjs && node --check scripts/release-gate-test.mjs && node --test scripts/release-gate-test.mjs",
+    "test:release-focused": "npm run test:release-critical && npm run test:compact && npm run test:shellhardening && npm run test:tool-contracts && npm run test:session && npm run test:session-transport",
+    "test:release-critical": "npm run test:release-assets && npm run smoke:patch && npm run test:providers",
+    "test:session-transport": "node --test scripts/session-transport-test.mjs",
+    "test:session": "node --test scripts/runtime-turn-contract-test.mjs scripts/session-save-fault-store-test.mjs",
     "test:media": "node --test src/runtime/media/store.test.mjs src/runtime/media/renditions.test.mjs src/runtime/media/adapters/codex-image.test.mjs",
-    "test:shell-harness": "node --test scripts/shell-harness-regression-test.mjs",
     "failures": "node scripts/tool-failures.mjs",
     "trace:llm": "node scripts/llm-trace-summary.mjs",
     "diag:sessions": "node scripts/session-diag.mjs",
@@ -125,7 +77,6 @@
     "bench:run": "node scripts/bench-run.mjs",
     "bench:recall": "node scripts/recall-bench.mjs",
     "bench:tui-load": "node scripts/tui-runtime-load-bench.mjs",
-    "bench:explore": "node scripts/explore-bench.mjs",
     "bench:output-style": "node scripts/output-style-bench.mjs",
     "bench:session-context": "node scripts/session-context-bench.mjs",
     "bench:session-transport": "node scripts/session-transport-bench.mjs",

package/scripts/routing-corpus.mjs

@@ -68,7 +68,6 @@ function argsSummary(tool, args) {
       const values = args.symbols || args.files || args.symbol || args.file || '';
       return clip(`${args.mode || '?'}:${Array.isArray(values) ? `[${values.length}]${values[0] || ''}` : values}`);
     }
-    case 'explore': return arr(args.query);
     case 'find': return clip(args.query);
     case 'glob': return clip(Array.isArray(args.pattern) ? args.pattern[0] : args.pattern);
     case 'list': return clip(basename(String(args.path || '')));
@@ -95,7 +94,7 @@ function targetValues(tool, args) {
       ? (args.files != null ? 'files' : 'file')
       : symbolMode || args.mode === 'symbols' ? (args.symbols != null ? 'symbols' : 'symbol') : 'file';
   } else if (tool === 'grep' || tool === 'glob') key = 'pattern';
-  else if (tool === 'find' || tool === 'explore') key = 'query';
+  else if (tool === 'find') key = 'query';
   const value = args[key];
   return Array.isArray(value) ? value : value == null ? [] : [value];
 }
@@ -110,7 +109,7 @@ function batchFields(tool, args) {
       ? (args?.files != null ? 'files' : args?.file != null ? 'file' : args?.symbols != null ? 'symbols' : 'symbol')
       : null].filter(Boolean);
   }
-  return [tool === 'read' || tool === 'list' ? 'path' : tool === 'find' || tool === 'explore' ? 'query' : null].filter(Boolean);
+  return [tool === 'read' || tool === 'list' ? 'path' : tool === 'find' ? 'query' : null].filter(Boolean);
 }
 function compatibleBatchCalls(tool, left, right) {
   if (tool === 'read') {
@@ -149,7 +148,7 @@ function batchSpec(tool, args, forcedField = null) {
       : (args.symbols != null ? 'symbols' : 'symbol');
     return { field, values: targetValues(tool, args) };
   }
-  const fieldName = forcedField || (tool === 'read' || tool === 'list' ? 'path' : tool === 'grep' || tool === 'glob' ? 'pattern' : tool === 'find' || tool === 'explore' ? 'query' : null);
+  const fieldName = forcedField || (tool === 'read' || tool === 'list' ? 'path' : tool === 'grep' || tool === 'glob' ? 'pattern' : tool === 'find' ? 'query' : null);
   if (!fieldName) return null;
   const value = args[fieldName];
   return { field: fieldName, values: Array.isArray(value) ? value : value == null ? [] : [value] };
@@ -166,7 +165,7 @@ function sameIterationBatchObservations(sequence) {
       if (isMutation(next.tool)) break;
       group.push(next);
     }
-    for (const candidate of ['read', 'grep', 'find', 'glob', 'list', 'explore', 'code_graph']) {
+    for (const candidate of ['read', 'grep', 'find', 'glob', 'list', 'code_graph']) {
       if (candidate === 'read') {
         const calls = group.filter((entry) => entry.tool === 'read' && !entry.failed).map((entry) => ({ entry, targets: readTargets(entry.rawArgs) })).filter(({ targets }) => targets?.length);
         if (calls.some(({ entry, targets }, index) => calls.some(({ entry: other, targets: otherTargets }, otherIndex) => (
@@ -238,7 +237,7 @@ function buildCase(sid, toolRows) {
   const observations = [];
   if (sequence.some((s) => s.tool === 'code_graph' && s.rawArgs?.mode === 'find_symbol' && !s.rawArgs?.file && !s.rawArgs?.files)) flags.push('find_symbol_noscope');
   // Exact duplicate requests are the only relookup signal available in tool
-  // traces. Do not infer waste from counts, roles, turns, or explore→inspection:
+  // traces. Do not infer waste from counts, roles, turns, or locator→inspection:
   // exploration followed by inspection can be the intended route.
   const seenRequests = new Set();
   const readWindows = [];

package/src/app.mjs

@@ -87,7 +87,6 @@ export async function run(argv = [], classifiedInvocation = null) {
       model: opts.model,
       effort: opts.effort,
       fast: opts.fast,
-      explore: opts.explore,
       webSearch: opts.webSearch,
       memory: opts.memory,
       cwd: process.cwd(),

package/src/defaults/agents.json

@@ -1,17 +1,5 @@
 {
   "agents": [
-    {
-      "agent": "explorer",
-      "slot": "explore",
-      "systemFile": "rules/agent/30-explorer.md",
-      "description": "Filesystem navigation agent invoked by the `explore` MCP tool",
-      "invokedBy": "explore",
-      "toolSchemaProfile": "read",
-      "schemaAllowedTools": ["grep", "find", "glob", "code_graph"],
-      "kind": "retrieval",
-      "permission": "read",
-      "stallCap": { "idleSeconds": 240, "toolRunningSeconds": 180 }
-    },
     {
       "agent": "cycle1-agent",
       "slot": "cycle1",

package/src/defaults/skills/setup/SKILL.md

@@ -73,7 +73,7 @@ apply it, and verify the result.
 ### Workflow / agent definitions
 
 1. Workflows and agents are Markdown packs. Built-in services are Web Search,
-   Explore, and Maintainer. Mixdog ships editable starter agents `worker`,
+   and Maintainer. Mixdog ships editable starter agents `worker`,
    `heavy-worker`, and `reviewer`; custom packs live at
    `<mixdogData>/workflows/<id>/WORKFLOW.md` and
    `<mixdogData>/agents/<id>/AGENT.md`.

package/src/headless-command.mjs

@@ -1,10 +1,9 @@
 const VALUE_OPTIONS = new Set(['--provider', '--model', '--effort', '--workflow']);
 const FLAG_OPTIONS = new Set([
   '--readonly', '--help', '-h', '--plain', '--react', '--remote', '--onboarding', '--fast',
-  '--explore', '--web-search', '--memory',
+  '--web-search', '--memory',
 ]);
 const HEADLESS_ROLE_ALIASES = new Map([
-  ['explorer', 'explore'], ['explore', 'explore'],
   ['maint', 'maintainer'], ['maintenance', 'maintainer'], ['maintainer', 'maintainer'],
   ['worker', 'worker'],
   ['heavy', 'heavy-worker'], ['heavyworker', 'heavy-worker'], ['heavy-worker', 'heavy-worker'],
@@ -108,7 +107,6 @@ export function classifyCliInvocation(argv = []) {
     model: parsed.values['--model'],
     effort: parsed.values['--effort'],
     fast: argv.includes('--fast'),
-    explore: argv.includes('--explore'),
     webSearch: argv.includes('--web-search'),
     memory: argv.includes('--memory'),
     toolMode: argv.includes('--readonly') ? 'readonly' : 'full',

package/src/headless-role.mjs

@@ -83,7 +83,6 @@ export async function runHeadlessRole({
   model,
   effort,
   fast,
-  explore = false,
   webSearch = false,
   memory = false,
   cwd = process.cwd(),
@@ -93,11 +92,10 @@ export async function runHeadlessRole({
 } = {}) {
   const cleanAgent = clean(agent);
   const cleanMessage = clean(message);
-  // Classic headless surface: explorer, web search, and memory tools start OFF
-  // and opt back in per run (--explore / --web-search / --memory). An explicit
+  // Classic headless surface: web search and memory tools start OFF
+  // and opt back in per run (--web-search / --memory). An explicit
   // MIXDOG_FEATURE_* value from the caller environment always wins.
   for (const [key, enabled] of [
-    ['MIXDOG_FEATURE_EXPLORE', explore],
     ['MIXDOG_FEATURE_WEB_SEARCH', webSearch],
     ['MIXDOG_FEATURE_MEMORY', memory],
   ]) {

package/src/help.mjs

@@ -21,7 +21,7 @@ export const HELP_LINES = [
   '',
   'Headless role commands require an explicit provider/model pair and run with',
   'ephemeral config/data; host behavioral config and personal state are not loaded.',
-  'Roles: explore, worker, heavy-worker, reviewer, maintainer, web-researcher.',
+  'Roles: worker, heavy-worker, reviewer, maintainer, web-researcher.',
   '',
   'Slash commands (inside mixdog):',
   '  /clear                        start a fresh chat (alias: /new)',

package/src/rules/shared/01-tool.md

@@ -8,15 +8,10 @@
   known file/range→`read`;
   web/current→`search`; returned URL body→`web_fetch`; prior work→`recall`
   (history only, never current local state);
-  durable compact English memory→`memory`; explicit project change→`cwd`;
+  durable compact English memory→`memory`; explicit Project change→`cwd`
+  (`shell.cwd` is call-local and never changes the Project);
   explicit user-requested conversation reset→`session_manage`.
   Use only named tools present in the current tool surface.
-  `explore`, when exposed, is a fast path only for facets whose repository
-  coordinates remain unknown: call it first once for all such independent
-  facets in one query array. It returns direct `path:line` anchors, not
-  analysis or solutions; anchors are tool-verified coordinates that END
-  their location facets — never re-locate or second-guess them; resume
-  baseline routing from them.
 - Act only on verified identities (cwd/project/user/tool-returned) — paths,
   module specifiers, symbols, data/record shapes alike; a guessed identity is
   verified by one lookup or sample only when the next call or edit references
@@ -32,13 +27,20 @@
   route each once to the cheapest sufficient tool with all required
   variants/scopes, and launch every independent call together — never
   split or duplicate a facet across tools, mutate merely to widen
-  retrieval, reserve known work, or cap fanout. Symbol relations end at
+  retrieval, reserve known work, or cap fanout. Guessed terms go wide
+  with batched fan-out; narrow a scope only on verified cues — returned
+  siblings/conventions or known literals. Mine each returned output for
+  every remaining facet before the next round. Symbol relations end at
   `code_graph`; values/locations end at the context grep returns; `read`
   covers only what returned spans cannot, as an anchored offset/limit
   window. The moment evidence determines the answer, edit, or deliverable,
   stop retrieving; patch if needed.
 - Once the edit or deliverable is determined, finish in one assistant turn:
-  one `apply_patch` per file or cohesive unit, all patches first, then one
+  before `apply_patch`, obtain every target hunk's exact current content and
+  anchor from `grep`, `code_graph`, or `read`; never infer patch context from
+  another file, a sample, or expected text. Then issue `apply_patch` calls
+  serially, never in parallel; use one cohesive call with one file section per
+  target, all patches first, then one
   batched verification `shell` that runs the real required postconditions
   on every changed file and produced artifact, never echoes a claim;
   runtime waits for every patch and skips the shell

package/src/runtime/agent/orchestrator/agent-runtime/agent-dispatch.mjs

@@ -47,7 +47,7 @@ import { resourceAdmission } from '../../../shared/resource-admission.mjs';
 export { resolveMaintenanceRoute } from './maintenance-route.mjs';
 
 // Cap agent role synthesis to ~3000 tokens (~12 KB at the 4 B/tok
-// working average). Pool B explore/recall/search answers occasionally land
+// working average). Pool B recall/search answers occasionally land
 // 8-10k-token walls that then ride in the Lead context for the rest of the
 // turn; the cap keeps those outliers bounded without touching the 95%+ of
 // answers already under the threshold.
@@ -68,7 +68,7 @@ function formatCompactElapsedSeconds(ms) {
 
 // True when an abort explicitly opted into partial salvage — the error object
 // or the abort reason carries `salvagePartial: true`. A DEADLINE-driven caller
-// (explore hard timeout) sets it so the anchors the sub-agent already produced
+// A hard timeout sets it so partial output the sub-agent already produced
 // are returned instead of discarded; user cancellation (ESC) never sets it and
 // keeps the throw-everything behaviour.
 function salvagePartialRequested(error, signal) {
@@ -151,7 +151,7 @@ export function resolveHiddenRoleSchemaAllowedTools(hidden) {
  *     against config.presets.
  *   - null — unresolved.
  *
- * Explore and memory hidden roles mirror public spawning precedence:
+ * Hidden maintenance roles mirror public spawning precedence:
  * `agents.<role>` (including the `agents.maintenance` alias) → workflow route →
  * maintenance route → Main. The cycle1/2/3 agents share the memory knob via
  * their `maintKey: 'memory'` override. Scheduler and webhook are unchanged.
@@ -293,7 +293,7 @@ export function makeAgentDispatch(opts = {}) {
             agentId: agent,
         });
 
-        // Callers (e.g. aiWrapped explore dispatch) may pass an explicit
+        // Callers may pass an explicit
         // `cwd` to scope the agent's filesystem view. Absolute path expected
         // (aiWrapped already expands `~` and resolves relatives). When unset
         // we pass `null` through instead of falling back to `process.cwd()`
@@ -418,7 +418,7 @@ export function makeAgentDispatch(opts = {}) {
         const _idleController = (agentWatchdogPolicyActive(_watchdogPolicy) && _linkSignal)
             ? new AbortController()
             : null;
-        // Do not link factory parent, per-call explore cancellation, and the
+        // Do not link factory parent, per-call cancellation, and the
         // watchdog one at a time: each link replaces the previous listener in
         // runtime-liveness.  One composite survives askSession's controller
         // swap and makes every source reach the provider call.
@@ -497,7 +497,7 @@ export function makeAgentDispatch(opts = {}) {
             });
             process.stderr.write(`[agent-dispatch] agent=${agent} session=${session.id} elapsed=${Date.now() - _agentDispatchT0}ms\n`);
             const raw = result?.content || '';
-            // Brief cap. Agent role answers (explore/recall/search)
+            // Brief cap. Agent role answers (recall/search)
             // occasionally balloon to 8-10k token walls that then ride in the
             // parent Lead's context for the rest of the turn. A 3000-token
             // (~12 KB) ceiling trims the long tail while leaving the vast

package/src/runtime/agent/orchestrator/agent-runtime/agent-loop-policy.mjs

@@ -1,7 +1,5 @@
 /**
- * Agent loop ceilings. Lead and general delegated agents share one high
- * runaway guard. Explorer is the sole bounded exception: locator work gets at
- * at most five tool-capable turns, followed by the loop's tool-less report turn.
+ * Agent loop ceilings. Lead and delegated agents share one high runaway guard.
  */
 
 function envPositiveInt(name, fallback) {
@@ -15,29 +13,8 @@ function envPositiveInt(name, fallback) {
 // to raise/lower the safety ceiling, never used as a general task-length budget.
 export const LEAD_MAX_LOOP_ITERATIONS = envPositiveInt('MIXDOG_AGENT_MAX_LOOP', 200);
 
-// Explorer's first turn is the whole maximum-fanout search; turns 2-5 are
-// bounded miss recovery. The override may shorten this but never add a sixth.
-export const EXPLORE_MAX_LOOP_ITERATIONS = Math.min(
-    5,
-    envPositiveInt('MIXDOG_EXPLORE_MAX_LOOP', 5),
-);
-
-/**
- * Resolve the hard cap used by agentLoop for this session.
- *
- * Explorer: the lowest positive explicit/session value, clamped to its
- * dedicated five-turn ceiling. Others: explicit → session-pinned → shared guard.
- */
+/** Resolve the hard cap used by agentLoop for this session. */
 export function resolveSessionMaxLoopIterations(sessionRef, explicit) {
-    const sessionAgent = String(sessionRef?.agent || '').trim().toLowerCase();
-    if (sessionAgent === 'explorer' || sessionAgent === 'explore') {
-        const requested = Number.isFinite(explicit) && explicit > 0
-            ? Math.floor(explicit)
-            : Number.isFinite(sessionRef?.maxLoopIterations) && sessionRef.maxLoopIterations > 0
-                ? Math.floor(sessionRef.maxLoopIterations)
-                : EXPLORE_MAX_LOOP_ITERATIONS;
-        return Math.min(EXPLORE_MAX_LOOP_ITERATIONS, requested);
-    }
     if (Number.isFinite(explicit) && explicit > 0) return Math.floor(explicit);
     if (Number.isFinite(sessionRef?.maxLoopIterations) && sessionRef.maxLoopIterations > 0) {
         return Math.floor(sessionRef.maxLoopIterations);

package/src/runtime/agent/orchestrator/agent-runtime/agent-progress-watchdog.mjs

@@ -17,7 +17,7 @@ import {
 // Ordering guarantee, stated in stall-policy.mjs: the provider layer — which
 // can retry in place or fall back to non-streaming — must fire STRICTLY before
 // the agent watchdog's terminal abort. Role abort budgets (worker/reviewer
-// 300s, explore 240s) sat at or BELOW the provider semantic-idle window
+// 300s) sat at or BELOW the provider semantic-idle window
 // (300s), inverting that order: the watchdog aborted the shared signal first,
 // so the provider's recovery never ran and the `agent_stall` failure — which
 // the classifier calls retryable — died on throwIfAborted instead. Hold the
@@ -140,7 +140,7 @@ export function watchdogPartialHandoffFromError(error, session, messageStartInde
 }
 
 // Salvage path for NON-watchdog aborts that explicitly opt in (the abort error
-// / abort reason carries `salvagePartial: true` — e.g. the explore wall-clock
+// / abort reason carries `salvagePartial: true` — e.g. a bounded wall-clock
 // hard timeout). Same collection rule as the watchdog handoff: only assistant
 // text appended during this run. Plain user cancellation never opts in, so ESC
 // still discards the run.
@@ -266,7 +266,7 @@ export function resolveAgentWatchdogPolicy(agent, overrides = {}) {
             ? Math.min(DEFAULT_STALE_TIMEOUT_MS, backstopMs)
             : DEFAULT_STALE_TIMEOUT_MS;
         // Same floor for the public backstop: a workflow role (worker 300s,
-        // explore 240s) must not undercut the provider window either.
+        // role-specific caps must not undercut the provider window either.
         idleStaleMs = Math.max(idleStaleMs, PROVIDER_RECOVERY_FLOOR_MS);
     }
 

package/src/runtime/agent/orchestrator/agent-runtime/maintenance-route.mjs

@@ -29,7 +29,7 @@ export function resolveMaintenanceRoute({ preset, optsPreset, agent, config: cfg
         try {
             const config = cfgIn || loadConfig({ secrets: false });
             const key = hidden.maintKey || hidden.slot;
-            const role = key === 'explore' ? 'explore' : (key === 'memory' ? 'maintainer' : '');
+            const role = key === 'memory' ? 'maintainer' : '';
             if (!role) return config?.maintenance?.[key] ?? null;
             const candidates = [
                 ...configuredAgentRouteCandidates(config, role),

package/src/runtime/agent/orchestrator/agent-runtime/session-builder.mjs

@@ -49,7 +49,7 @@ function normalizeAgentCompactionConfig(value = {}, { memoryEnabled = true } = {
 
 /**
  * @param {object} opts
- * @param {string}  opts.agent         — canonical agent name ('worker', 'explorer', ...)
+ * @param {string}  opts.agent         — canonical agent name ('worker', 'reviewer', ...)
  * @param {string}  opts.presetName    — resolved preset identifier
  * @param {object}  opts.preset        — resolved preset object from agent-config
  * @param {object}  opts.runtimeSpec   — resolveRuntimeSpec output; must carry .scopeKey / .lane

package/src/runtime/agent/orchestrator/agent-trace-format.mjs

@@ -137,7 +137,6 @@ const TOOL_ARG_KEYS = {
     list: ['path', 'head_limit', 'offset'],
     recall: ['query', 'limit', 'session_id', 'cwd'],
     search: ['query', 'limit', 'cwd'],
-    explore: ['query', 'queries', 'limit', 'cwd'],
     code_graph: ['mode', 'file', 'files', 'symbol', 'symbols', 'body', 'language', 'limit', 'depth', 'page', 'cwd'],
     shell: ['command', 'cwd', 'timeout', 'mode', 'run_in_background', 'persistent', 'session_id'],
     task: ['task_id', 'action', 'timeout_ms', 'poll_ms'],

package/src/runtime/agent/orchestrator/config.mjs

@@ -22,13 +22,12 @@ export function getPluginData() {
 // Canonical maintenance defaults. Single source of truth — imported by
 // llm/index.mjs and setup-server.mjs so UI/runtime cannot drift from config.
 //
-// Explore and Maintainer start without a route so they dynamically inherit the
-// Main route. Their explicit routes live canonically in `agents.explore` and
-// `agents.maintainer`; load-time migration still accepts the older workflow /
-// maintenance aliases.
+// Maintainer starts without a route so it dynamically inherits the Main route.
+// Its explicit route lives canonically in `agents.maintainer`; load-time
+// migration still accepts the older workflow / maintenance aliases.
 // Webhook endpoints may omit a model and use the fallback route below.
 // Legacy route slots accepted only at config ingress for migration.
-const MAINTENANCE_SLOTS = Object.freeze(['explore', 'memory']);
+const MAINTENANCE_SLOTS = Object.freeze(['memory']);
 
 // --- User profile (statusline /profile) -------------------------------------
 // Supported response languages for the /profile picker. `system` is the default
@@ -340,7 +339,7 @@ function canonicalizeShellStorage(value) {
 function canonicalizeModulesStorage(value) {
     const modules = configObject(value);
     delete modules.memory;
-    for (const name of ['search', 'explore']) {
+    for (const name of ['search']) {
         if (!Object.prototype.hasOwnProperty.call(modules, name)) continue;
         const raw = modules[name];
         modules[name] = {

package/src/runtime/agent/orchestrator/context/collect.mjs

@@ -711,8 +711,7 @@ export function loadScopedRoleInstructions(agent, provider = null) {
             agentRuleSectionsToEmit = hiddenPairs.map(p => `## ${p.name}\n\n${p.body}`);
             agentSectionsToEmit = agentSections;
         } else if (agent && classification.retrieval.has(agent)) {
-            // Retrieval agents (explorer) get their own contract section
-            // (rules/agent/30-explorer.md) in BP2.
+            // Retrieval agents get their own contract section in BP2.
             const self = hiddenPairs.find(p => p.name === agent);
             agentRuleSectionsToEmit = self ? [`## ${self.name}\n\n${self.body}`] : [];
             agentSectionsToEmit = agentSections.filter(s =>

package/src/runtime/agent/orchestrator/dispatch-persist.mjs

@@ -8,7 +8,7 @@
  *
  * This module persists the minimum needed to recover:
  *   - handle   (`dispatch_<tool>_...`)
- *   - tool     (`recall` / `search` / `explore`)
+ *   - tool     (`recall` / `search`)
  *   - queries  (for the abort message)
  *   - createdAt
  *

package/src/runtime/agent/orchestrator/internal-agents.mjs

@@ -2,7 +2,7 @@
  * Internal hidden agents — Mixdog-managed, user-untouchable.
  *
  * Unlike public workflow agents, these hidden agents are NEVER exposed to callers of the `agent` tool. They are
- * invoked only by internal handlers (explore / recall / search) and carry
+ * invoked only by internal handlers (recall / search) and carry
  * their own system prompt + tool-set policy.
  *
  * Lookup order (agent-dispatch.resolveMaintenanceRoute):
@@ -20,7 +20,7 @@
  * found" error rather than silently mis-dispatching.
  *
  * Kind classification:
- *   - 'retrieval'   : short-lived hidden retrieval agents (explore).
+ *   - 'retrieval'   : short-lived hidden retrieval agents.
  *   - 'maintenance' : background-trigger hidden agents (memory cycle and
  *                     title generation). Receive only their own self section.
  *
@@ -184,7 +184,7 @@ export function listHiddenAgentsByKind(kind) {
 
 /**
  * Return the agents/<name>.md sections a hidden agent shares in its BP2 catalog
- * (in addition to its own self section). Drives the explorer→worker cache
+ * (in addition to its own self section). Drives hidden-role cache
  * alignment declaratively instead of a hard-coded agent-name branch in
  * collect.mjs. Returns [] when the agent declares none.
  */

package/src/runtime/agent/orchestrator/providers/anthropic-sse.mjs

@@ -107,6 +107,12 @@ function _anthropicSseError(event) {
         err.httpStatus = status;
         err.status = status;
     }
+    // Wire-error marker: an error type OUTSIDE the documented enumeration
+    // (no status resolved above) default-retries under the shared wire-error
+    // contract instead of failing the turn as 'unknown'. Typed statuses and
+    // the fatal-code deny-list still take precedence in classifyError().
+    err.providerWireError = true;
+    if (typeof type === 'string' && type && type !== 'error') err.providerErrorCode = type;
     return err;
 }
 

package/src/runtime/agent/orchestrator/providers/openai-compat-stream.mjs

@@ -841,7 +841,8 @@ function handleCompatResponsesStreamEvent(event, state, { label, parseResponsesT
 // Copy the TYPED failure evidence a Responses `response.failed` / `error`
 // event carries (numeric HTTP status, provider error code/type) onto the
 // thrown error. Message text is never parsed, and nothing is synthesized when
-// the event declares no typed status.
+// the event declares no typed status. The wire-event marker routes the error
+// through the fatal-code deny-list / default-retry classification.
 function _applyTypedResponsesFailure(err, event) {
     const detail = event?.response?.error || event?.error || null;
     const typed = typedStatusFrom(detail, event);
@@ -849,6 +850,7 @@ function _applyTypedResponsesFailure(err, event) {
     const code = detail?.code ?? detail?.type ?? event?.code ?? null;
     if (code != null && code !== '') err.providerErrorCode = String(code);
     if (detail) err.providerError = detail;
+    err.providerWireError = true;
     return err;
 }
 

package/src/runtime/agent/orchestrator/providers/openai-oauth-http-sse.mjs

@@ -959,9 +959,15 @@ export async function sendViaHttpSse({
             case 'response.failed': {
                 const msg = event.response?.error?.message || event.error?.message || event.message || 'response.failed';
                 const err = new Error(`OpenAI OAuth HTTP fallback response.failed: ${msg}`);
-                // Typed status only — a text-only failure stays unclassified.
+                // Typed status only — nothing is synthesized from text. The
+                // frame itself is preserved so the wire-error default-retry
+                // classification applies (fatal codes stay terminal).
+                err.responseFailed = event;
                 const typed = typedStatusFrom(event.response?.error, event.error, event);
                 if (typed) err.httpStatus = typed;
+                const detail = event.response?.error || event.error || null;
+                const code = detail?.code ?? detail?.type ?? null;
+                if (typeof code === 'string' && code) err.providerErrorCode = code;
                 throw err;
             }
             case 'response.incomplete': {
@@ -987,8 +993,12 @@ export async function sendViaHttpSse({
             case 'error': {
                 const msg = event.message || event.error?.message || 'unknown';
                 const err = new Error(`OpenAI OAuth HTTP fallback error: ${msg}`);
+                // Same wire-error contract as response.failed.
+                err.responseFailed = event;
                 const typed = typedStatusFrom(event.error, event);
                 if (typed) err.httpStatus = typed;
+                const code = event.error?.code ?? event.error?.type ?? event.code ?? null;
+                if (typeof code === 'string' && code) err.providerErrorCode = code;
                 throw err;
             }
             default: