@animalabs/connectome-host 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -6,6 +6,81 @@ release time — see [CONTRIBUTING.md](CONTRIBUTING.md#changelog).
 
 ## Unreleased
 
+## 0.8.1 — 2026-09-10
+
+### Added
+
+- Recipe `subconscious` block (tune-out, agent-framework#77): `enabled`,
+  `systemPrompt` (required — the subconscious's mode block), optional `name`,
+  `model`, `allowChannelSpeech`, `reAnchorFraction`. Validated at recipe load
+  (unknown fields refused by name) and passed through verbatim to
+  `FrameworkConfig.subconscious`; the framework owns the defaults. Requires
+  agent-framework with tune-out (#115).
+
+- Add validated recipe plumbing for Agent Framework's default-off `agent.toolWrapperProseGuard` containment boundary.
+
+### Changed
+
+- Gate telemetry reads `x-gate-channel` from the turn's routing locus or,
+  for gate-batched wakes that set none, from the framework's telemetry-only
+  `wakeChannelId` (agent-framework ≥0.14). On residents with a subconscious
+  the stamp now follows the primary (the exactly-one-agent guard had
+  silenced it), and — because one provider adapter serves every agent — the
+  origin trio is stamped only while the primary is the only agent with a
+  turn in flight; overlap withholds rather than misattributes. Compression
+  debt is read from the primary as well.
+
+### Fixed
+
+- Recipes' `agent.strategy.mergeMaxSourceSpanMessages` now reaches the Context
+  Manager (it was accepted but never passed through, so the CM default applied
+  regardless of the recipe). Also plumbs and validates the Context Manager's
+  `compressionSplitFallback`, `compressionSplitPlaceholder`,
+  `compressionSplitMaxCallsPerChunk` and `compressionSplitMaxCallsPer10Min`
+  keys (all default off / CM defaults).
+
+- Gate telemetry classifies EventGate-batched wakes (`gate:debounce`, source
+  `gate`) as origin `event` instead of passing the raw reason through.
+
+- Name-taking commands (`/checkpoint`, `/restore`, `/checkout`,
+  `/session switch`, `/session delete`) parse the rest of the line instead of
+  only the first token, so multi-word names round-trip with
+  `/session rename` instead of silently truncating (`/checkpoint my test
+  point` used to save a checkpoint named `my`).
+- `/session delete` requires `--confirm`: the bare command echoes exactly
+  which session matched (name, id, message count) before anything
+  irreversible happens. `/help` documents that switch/delete accept ids.
+- Head-moving commands (`/undo`, `/redo`, `/checkout`, `/restore`,
+  `/branchto`, `/newtopic`) are refused while a turn is in flight — moving
+  the head mid-stream committed the streaming reply onto the wrong branch,
+  detached from its request (orphaned Chronicle nodes), including when the
+  move came from a second client on the same session.
+- `/mcp add` on an existing server preserves its env vars and `toolPrefix`
+  (and reports the kept env keys); previously a command update silently
+  wiped the server's env, which only surfaced when the server next started
+  without its tokens.
+- Checkpoints are visible: `/branches` lists them alongside branches, and
+  bare `/checkpoint` lists existing checkpoints (matching bare `/restore`).
+- `/budget` displays small values exactly instead of flooring to `0k`
+  (`/budget 50` used to report "set to 0k" while rejecting `/budget 0`).
+- `/clear` clears the WebUI transcript view (client-side, like the TUI's
+  scrollback wipe) instead of appending a "(cleared)" line while clearing
+  nothing; `/help` and the headless reply now say what `/clear` actually
+  does — display only, history and context kept.
+
+- The WebUI HTTP surface answers honestly: unknown `/debug/*` paths (typos,
+  casing, trailing slashes) return a JSON 404 instead of the SPA shell with
+  a 200; missing `/assets/*` files return 404 instead of HTML (which
+  produced a blank page with a MIME error on stale bundle hashes); non-GET
+  methods get 405 with an `Allow` header. SPA client-side routes still fall
+  back to the shell.
+- The context-makeup panel's exact token count calls `count_tokens` with the
+  model the agent actually runs (provider/Bedrock prefixes normalized away)
+  instead of a hardcoded id that 404'd on every install and silently nulled
+  `exactTotalTokens`. `COUNT_TOKENS_MODEL` remains as an explicit override;
+  non-Anthropic models report `count_tokens_unsupported_model` instead of
+  counting against the wrong tokenizer.
+
 ## 0.8.0 — 2026-09-05
 
 ### Added

package/bun.lock

@@ -5,9 +5,9 @@
     "": {
       "name": "@animalabs/connectome-host",
       "dependencies": {
-        "@animalabs/agent-framework": "^0.12.0",
+        "@animalabs/agent-framework": "^0.13.0",
         "@animalabs/chronicle": "^0.3.0",
-        "@animalabs/context-manager": "^0.6.3",
+        "@animalabs/context-manager": "^0.8.0",
         "@animalabs/membrane": "^0.5.82",
         "@opentui/core": "^0.1.82",
       },
@@ -19,11 +19,11 @@
     },
   },
   "packages": {
-    "@animalabs/agent-framework": ["@animalabs/agent-framework@0.12.0", "", { "dependencies": { "@animalabs/chronicle": "^0.3.0", "@animalabs/context-manager": "^0.6.0", "@animalabs/membrane": "^0.5.78", "chokidar": "^4.0.3", "discord.js": "^14.25.1", "ws": "^8.18.0" }, "bin": { "agent-framework-mcp": "dist/src/api/mcp-server.js", "agent-framework-recover": "dist/src/recovery/recover-cli.js" } }, "sha512-Yj0E4vA+kqMxp8LzVT1DBBppwBtPaaweOCloO47pAbJemLzLsJoCD1O9GOYjZ75LLfvGenzLgg1fWo0wXkMJ1w=="],
+    "@animalabs/agent-framework": ["@animalabs/agent-framework@0.13.0", "", { "dependencies": { "@animalabs/chronicle": "^0.3.0", "@animalabs/context-manager": "^0.8.0", "@animalabs/membrane": "^0.5.78", "chokidar": "^4.0.3", "discord.js": "^14.25.1", "ws": "^8.18.0" }, "bin": { "agent-framework-mcp": "dist/src/api/mcp-server.js", "agent-framework-recover": "dist/src/recovery/recover-cli.js" } }, "sha512-j4QY9pEjOHdmqnwyUPp4NU6fW1f5EHb3Lp+ygoAB3LKj2QjLITlglNFNuLqjRWtGiwwamSopcuqgbwHwAp0wyQ=="],
 
     "@animalabs/chronicle": ["@animalabs/chronicle@0.3.0", "", {}, "sha512-6BBJ9pWb8AnuHTNJTU07Y6Wut3IvdgWFxsy05IdlWcEnR5W23dlaBlaeJq7gDc7TwX05HfsDC+QZFEc69G+s4Q=="],
 
-    "@animalabs/context-manager": ["@animalabs/context-manager@0.6.3", "", { "dependencies": { "@animalabs/chronicle": "^0.3.0", "@animalabs/membrane": "^0.5.69" } }, "sha512-zh60LgZxXzBbGrLpDHBAfGSPSL/H8mxz8nSWLOSh4pjiTOYbD0o0BjAM8CFz4LiaOIXnuSCbRoiv5UKsnrKwDw=="],
+    "@animalabs/context-manager": ["@animalabs/context-manager@0.8.0", "", { "dependencies": { "@animalabs/chronicle": "^0.3.0", "@animalabs/membrane": "^0.5.69" } }, "sha512-lMYU+FazgSl6FFNig8N8Zjo6vqxn16j6H5GkYldS3R902nnUX4gjsqhup/yQDqrrOJuwSvpkrQBpnV8q2iOykA=="],
 
     "@animalabs/membrane": ["@animalabs/membrane@0.5.82", "", { "dependencies": { "@anthropic-ai/sdk": "^0.52.0" } }, "sha512-kCI3s/HXnXBPVcYCXIZfsdJBLRj77j5QyA9Hor1mC/nyD35D7e7N/VgR9awxqdGGWgIvgpjs6owXbGMk5t1pQA=="],
 
@@ -275,8 +275,6 @@
 
     "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
 
-    "@animalabs/context-manager/@animalabs/membrane": ["@animalabs/membrane@0.5.80", "", { "dependencies": { "@anthropic-ai/sdk": "^0.52.0" } }, "sha512-D4xEij+J/3sJo2ZKFyjAeb0VuJl3QmygzEmi44J0nDNtmJSpUPYMJMaSid/ABj3dIs5EyXds/Ltr4qqyQ2DRTw=="],
-
     "@discordjs/rest/@discordjs/collection": ["@discordjs/collection@2.1.1", "", {}, "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg=="],
 
     "@discordjs/ws/@discordjs/collection": ["@discordjs/collection@2.1.1", "", {}, "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg=="],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animalabs/connectome-host",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "General-purpose agent TUI host with recipe-based configuration",
   "type": "module",
   "scripts": {
@@ -14,9 +14,9 @@
     "postinstall": "test -d web && npm --prefix web install && npm --prefix web run build || true"
   },
   "dependencies": {
-    "@animalabs/agent-framework": "^0.12.0",
+    "@animalabs/agent-framework": "^0.13.0",
     "@animalabs/chronicle": "^0.3.0",
-    "@animalabs/context-manager": "^0.6.3",
+    "@animalabs/context-manager": "^0.8.0",
     "@animalabs/membrane": "^0.5.82",
     "@opentui/core": "^0.1.82"
   },

package/src/commands.ts

@@ -121,6 +121,35 @@ function getAgentCM(framework: AgentFramework, agentName?: string): ContextManag
   return all[0]?.getContextManager() ?? null;
 }
 
+/**
+ * Refuse head-moving commands while the main agent's turn is in flight.
+ *
+ * Moving the Chronicle head (undo/redo/checkout/restore/branchto/newtopic)
+ * is not atomic with respect to a streaming generation: the in-flight reply
+ * commits onto whatever branch is current WHEN IT COMPLETES, so a head move
+ * mid-stream detaches the reply from its request — it lands on the new
+ * branch attached to the wrong parent (orphaned node), including when the
+ * move is issued from a second client on the same session. The supported
+ * sequence is: stop the generation, then move the head.
+ *
+ * Returns null when the command may proceed. Agents without a state field
+ * (stubs, minimal harnesses) are treated as idle.
+ */
+function inFlightGuard(app: AppContext, cmd: string): CommandResult | null {
+  const framework = app.framework;
+  const agent = (app.agentName ? framework.getAgent(app.agentName) : undefined)
+    ?? framework.getAllAgents()[0];
+  const status = (agent as { state?: { status?: string } } | undefined)?.state?.status;
+  if (status === undefined || status === 'idle') return null;
+  return {
+    lines: [
+      { text: `/${cmd} refused: a turn is in flight (${(agent as { name?: string }).name ?? 'agent'}: ${status}).`, style: 'system' },
+      { text: '  Moving the head mid-generation would attach the streaming reply to the wrong', style: 'system' },
+      { text: '  branch/request. Stop the generation first, then retry.', style: 'system' },
+    ],
+  };
+}
+
 export function handleCommand(command: string, app: AppContext): CommandResult {
   const parts = command.slice(1).split(/\s+/);
   const cmd = parts[0]!;
@@ -147,16 +176,16 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
           { text: '--- Commands ---', style: 'system' },
           { text: '  /quit, /q              Exit the app', style: 'system' },
           { text: '  /status                Show agent status', style: 'system' },
-          { text: '  /clear                 Clear conversation', style: 'system' },
+          { text: '  /clear                 Clear this client\'s display (history/context are kept)', style: 'system' },
           { text: '  /lessons               Show lesson library', style: 'system' },
           { text: '  /export                Export lessons to ./output/ (JSON + markdown)', style: 'system' },
           { text: '  /undo                  Revert last agent turn', style: 'system' },
           { text: '  /redo                  Re-apply undone action', style: 'system' },
           { text: '  /nudge [agent]         Run inference on current context (no new events)', style: 'system' },
           { text: '  /puppet <tool> [json]  Admin: execute a tool AS the agent, store the pair', style: 'system' },
-          { text: '  /checkpoint <name>     Save current state', style: 'system' },
-          { text: '  /restore <name>        Restore to checkpoint', style: 'system' },
-          { text: '  /branches              List Chronicle branches', style: 'system' },
+          { text: '  /checkpoint [name]     Save current state (no name: list checkpoints)', style: 'system' },
+          { text: '  /restore [name]        Restore to checkpoint (no name: list checkpoints)', style: 'system' },
+          { text: '  /branches              List Chronicle branches and checkpoints', style: 'system' },
           { text: '  /checkout <name>       Switch to branch', style: 'system' },
           { text: '  /history [n]           Show state transitions (last n)', style: 'system' },
           { text: '  /find <text>           Search messages for text', style: 'system' },
@@ -170,9 +199,9 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
           { text: '  /session               Show current session', style: 'system' },
           { text: '  /session list          List all sessions', style: 'system' },
           { text: '  /session new [name]    Create new session', style: 'system' },
-          { text: '  /session switch <name> Switch to session', style: 'system' },
+          { text: '  /session switch <name or id> Switch to session', style: 'system' },
           { text: '  /session rename <name> Rename current session', style: 'system' },
-          { text: '  /session delete <name> Delete a session', style: 'system' },
+          { text: '  /session delete <name or id> --confirm  Delete a session (irreversible)', style: 'system' },
           { text: '  /recipe                Show current recipe info', style: 'system' },
           { text: '  /newtopic [context]    Reset head window (auto-summarize if empty)', style: 'system' },
           { text: '  /usage                 Show session token usage and costs', style: 'system' },
@@ -182,7 +211,12 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
       };
 
     case 'clear':
-      return { lines: [{ text: '(cleared)', style: 'system' }] };
+      // Display-clearing is client-side: the TUI wipes its scrollback and
+      // the SPA wipes its transcript view before this handler is ever
+      // reached. This line is only seen by surfaces with no display to
+      // clear (headless), where it honestly reports that nothing else —
+      // Chronicle, context — was touched.
+      return { lines: [{ text: '(display cleared on clients; history and context are kept)', style: 'system' }] };
 
     case 'status':
       return handleStatus(framework);
@@ -194,7 +228,7 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
       return handleExport(app);
 
     case 'undo':
-      return handleUndo(app);
+      return inFlightGuard(app, cmd) ?? handleUndo(app);
 
     case 'nudge':
       return handleNudge(app, args[0]);
@@ -203,25 +237,29 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
       return handlePuppet(app, args);
 
     case 'redo':
-      return handleRedo(app);
+      return inFlightGuard(app, cmd) ?? handleRedo(app);
 
+    // Name-taking commands join the REST of the line, not just the first
+    // token: names may contain spaces (/checkpoint my test point), and
+    // /session rename already accepts multi-word names — parsing them
+    // differently made multi-word names silently truncate here.
     case 'checkpoint':
-      return handleCheckpoint(app, args[0]);
+      return handleCheckpoint(app, args.join(' ') || undefined);
 
     case 'restore':
-      return handleRestore(app, args[0]);
+      return inFlightGuard(app, cmd) ?? handleRestore(app, args.join(' ') || undefined);
 
     case 'branches':
-      return handleBranches(framework);
+      return handleBranches(app);
 
     case 'checkout':
-      return handleCheckout(framework, args[0]);
+      return inFlightGuard(app, cmd) ?? handleCheckout(framework, args.join(' ') || undefined);
 
     case 'history':
       return handleHistory(framework, args[0]);
 
     case 'branchto':
-      return handleBranchTo(app, args[0]);
+      return inFlightGuard(app, cmd) ?? handleBranchTo(app, args[0]);
 
     case 'find':
       return handleFind(framework, args.join(' '));
@@ -242,7 +280,7 @@ export function handleCommand(command: string, app: AppContext): CommandResult {
       return handleRecipe(app);
 
     case 'newtopic':
-      return handleNewTopic(app, args);
+      return inFlightGuard(app, cmd) ?? handleNewTopic(app, args);
 
     case 'usage':
       return handleUsage(app);
@@ -310,12 +348,14 @@ function handleSession(app: AppContext, args: string[]): CommandResult {
       return handleSessionNew(app, args.slice(1).join(' ') || undefined);
     case 'switch':
     case 'sw':
-      return handleSessionSwitch(app, args[1]);
+      // Rest-of-line, matching rename: session names may contain spaces, and
+      // a session renamed to a multi-word name must stay reachable by name.
+      return handleSessionSwitch(app, args.slice(1).join(' ') || undefined);
     case 'rename':
       return handleSessionRename(app, args.slice(1).join(' ') || undefined);
     case 'delete':
     case 'rm':
-      return handleSessionDelete(app, args[1]);
+      return handleSessionDelete(app, args.slice(1));
     default:
       return { lines: [{ text: `Unknown /session subcommand: ${sub}. Try /session list.`, style: 'system' }] };
   }
@@ -411,9 +451,17 @@ function handleSessionRename(app: AppContext, name?: string): CommandResult {
   return { lines: [{ text: `Session renamed to "${name}".`, style: 'system' }] };
 }
 
-function handleSessionDelete(app: AppContext, nameOrId?: string): CommandResult {
+function handleSessionDelete(app: AppContext, args: string[]): CommandResult {
+  // Deletion is irreversible, so it takes an explicit second step: the bare
+  // command shows exactly what matched (name + id + message count) and asks
+  // for --confirm. This also defuses the truncated-name amplifier: a typo'd
+  // or partial name can match a DIFFERENT session, and without the echo the
+  // wrong one died silently.
+  const confirmed = args[args.length - 1] === '--confirm';
+  const nameOrId = (confirmed ? args.slice(0, -1) : args).join(' ') || undefined;
+
   if (!nameOrId) {
-    return { lines: [{ text: 'Usage: /session delete <name or id>', style: 'system' }] };
+    return { lines: [{ text: 'Usage: /session delete <name or id> [--confirm]', style: 'system' }] };
   }
 
   const session = app.sessionManager.findSession(nameOrId);
@@ -421,6 +469,16 @@ function handleSessionDelete(app: AppContext, nameOrId?: string): CommandResult
     return { lines: [{ text: `Session "${nameOrId}" not found.`, style: 'system' }] };
   }
 
+  if (!confirmed) {
+    const msgs = session.messageCount !== undefined ? `, ${session.messageCount} msgs` : '';
+    return {
+      lines: [
+        { text: `Will delete session "${session.name}" [${session.id}]${msgs} — irreversible.`, style: 'system' },
+        { text: `To proceed: /session delete ${session.id} --confirm`, style: 'system' },
+      ],
+    };
+  }
+
   try {
     app.sessionManager.deleteSession(session.id);
     return { lines: [{ text: `Deleted session "${session.name}" [${session.id}].`, style: 'system' }] };
@@ -526,14 +584,16 @@ function handleBudget(framework: AgentFramework, arg?: string): CommandResult {
   }
 
   if (!arg) {
-    // Show current budgets
+    // Show current budgets. fmtTokens is exact below 1000 — flooring to "0k"
+    // hid real small values and made the display contradict the validator
+    // (which rejects 0 but accepts 50).
     const lines: Line[] = [{ text: '--- Stream Token Budgets ---', style: 'system' }];
     for (const agent of agents) {
       const budget = agent.maxStreamTokens;
       const last = agent.lastStreamInputTokens;
       const pct = budget > 0 ? ((last / budget) * 100).toFixed(0) : '—';
       lines.push({
-        text: `  ${agent.name}: ${(budget / 1000).toFixed(0)}k (last: ${(last / 1000).toFixed(0)}k, ${pct}%)`,
+        text: `  ${agent.name}: ${fmtTokens(budget)} (last: ${fmtTokens(last)}, ${pct}%)`,
         style: 'system',
       });
     }
@@ -559,12 +619,8 @@ function handleBudget(framework: AgentFramework, arg?: string): CommandResult {
     agent.maxStreamTokens = tokens;
   }
 
-  const display = tokens >= 1_000_000
-    ? `${(tokens / 1_000_000).toFixed(1)}m`
-    : `${(tokens / 1_000).toFixed(0)}k`;
-
   return {
-    lines: [{ text: `Stream budget set to ${display} tokens for all agents.`, style: 'system' }],
+    lines: [{ text: `Stream budget set to ${fmtTokens(tokens)} tokens for all agents.`, style: 'system' }],
   };
 }
 
@@ -838,7 +894,17 @@ function handleRedo(app: AppContext): CommandResult {
 
 function handleCheckpoint(app: AppContext, name?: string): CommandResult {
   if (!name) {
-    return { lines: [{ text: 'Usage: /checkpoint <name>', style: 'system' }] };
+    // Bare /checkpoint lists what exists — same affordance as bare /restore —
+    // so the lifecycle is discoverable from either end.
+    const names = [...app.branchState.checkpoints.keys()];
+    return {
+      lines: [
+        { text: 'Usage: /checkpoint <name>', style: 'system' },
+        ...(names.length > 0
+          ? [{ text: `Saved checkpoints: ${names.join(', ')}`, style: 'system' as const }]
+          : []),
+      ],
+    };
   }
 
   const cm = getAgentCM(app.framework);
@@ -934,8 +1000,8 @@ function handleRestore(app: AppContext, name?: string): CommandResult {
   };
 }
 
-function handleBranches(framework: AgentFramework): CommandResult {
-  const cm = getAgentCM(framework);
+function handleBranches(app: AppContext): CommandResult {
+  const cm = getAgentCM(app.framework);
   if (!cm) return { lines: [{ text: 'No agent context manager.', style: 'system' }] };
 
   const branches = cm.listBranches();
@@ -950,6 +1016,19 @@ function handleBranches(framework: AgentFramework): CommandResult {
     });
   }
 
+  // Checkpoints are positions (branch + message), not branches — but they're
+  // part of the same mental model, and being invisible here made the whole
+  // checkpoint lifecycle run blind: created → not listed anywhere → restored
+  // on faith. Session-scoped, in-memory (cleared on session switch/restart).
+  const cps = [...app.branchState.checkpoints.entries()];
+  if (cps.length > 0) {
+    lines.push({ text: `--- Checkpoints (${cps.length}, this session) ---`, style: 'system' });
+    for (const [name, point] of cps) {
+      const at = point.messageId ? ` @ [${point.messageId}]` : '';
+      lines.push({ text: `  ${name} → ${point.branchName}${at}`, style: 'system' });
+    }
+  }
+
   return { lines };
 }
 
@@ -1137,13 +1216,27 @@ function handleMcpAdd(args: string[]): CommandResult {
 
   const [id, command, ...cmdArgs] = args;
   const servers = readMcplServersFile(DEFAULT_CONFIG_PATH);
-  const isOverwrite = id! in servers;
-  servers[id!] = { command: command!, ...(cmdArgs.length > 0 ? { args: cmdArgs } : {}) };
+  const prev = servers[id!];
+  // Overwrite replaces the command line (command + args, which travel as one
+  // unit) but PRESERVES env and other settings: env is edited via /mcp env
+  // and the panel editor, whose contract is "cleared only by explicit empty
+  // save" — a command update silently dropping tokens/settings broke working
+  // servers in a way that only surfaced at next start.
+  servers[id!] = {
+    ...prev,
+    command: command!,
+    ...(cmdArgs.length > 0 ? { args: cmdArgs } : {}),
+  };
+  if (cmdArgs.length === 0) delete servers[id!]!.args;
   saveMcplServers(DEFAULT_CONFIG_PATH, servers);
 
+  const keptEnv = prev?.env ? Object.keys(prev.env) : [];
   return {
     lines: [
-      { text: `${isOverwrite ? 'Updated' : 'Added'} server "${id}". Restart to apply.`, style: 'system' },
+      { text: `${prev ? 'Updated' : 'Added'} server "${id}". Restart to apply.`, style: 'system' },
+      ...(keptEnv.length > 0
+        ? [{ text: `  (kept env: ${keptEnv.join(', ')})`, style: 'system' as const }]
+        : []),
     ],
   };
 }

package/src/framework-agent-config.ts

@@ -113,5 +113,8 @@ export function buildFrameworkAgentConfig(
     ...(recipe.agent.proseRouting !== undefined
       ? { proseRouting: recipe.agent.proseRouting }
       : {}),
+    ...(recipe.agent.toolWrapperProseGuard !== undefined
+      ? { toolWrapperProseGuard: recipe.agent.toolWrapperProseGuard }
+      : {}),
   };
 }

package/src/framework-strategy.ts

@@ -17,11 +17,16 @@ const PASSTHROUGH_KEYS: ReadonlyArray<keyof RecipeStrategy> = [
   'compressionSourceOnlyFallback',
   'compressionMergeSourceOnly',
   'compressionMergeSourceOnlyFallback',
+  'compressionSplitFallback',
+  'compressionSplitPlaceholder',
+  'compressionSplitMaxCallsPerChunk',
+  'compressionSplitMaxCallsPer10Min',
   'compressionRecallBudgetTokens',
   'positionedRecallPairs',
   'recallHeaderTemplate',
   'targetChunkTokens',
   'mergeThreshold',
+  'mergeMaxSourceSpanMessages',
   'summaryTargetTokens',
   'productionBudgetTokens',
   'l1BudgetTokens',

package/src/gate-telemetry.ts

@@ -41,7 +41,11 @@ function envFlag(value: string | undefined): boolean {
 export interface TurnTrigger {
   reason: string;
   source: string;
+  /** Routing locus of the turn (direct channel wakes set it). */
   channelId?: string;
+  /** Telemetry-only channel of a gate-batched wake (agent-framework ≥0.14:
+   *  InferenceRequest.wakeChannelId) — never a locus. */
+  wakeChannelId?: string;
   counterparty?: string;
 }
 
@@ -60,7 +64,8 @@ export function originClass(trigger: TurnTrigger): string {
   const s = trigger.source.toLowerCase();
   if (r.includes('heartbeat') || s.includes('heartbeat')) return 'heartbeat';
   if (r.includes('mail') || s.includes('mail')) return 'mail';
-  if (r === 'mcpl:channel-incoming' || r === 'mcpl:push-event' || r.startsWith('discord')) return 'event';
+  // channel/push events, directly or batched through the framework's EventGate
+  if (r === 'mcpl:channel-incoming' || r === 'mcpl:push-event' || r.startsWith('discord') || r.startsWith('gate:') || s === 'gate') return 'event';
   // a person typing at the host itself: headless IPC, CLI, TUI, web UI, API
   if (r === 'external-message' || ['headless', 'cli', 'tui', 'webui', 'api'].includes(s)) return 'operator';
   if (r.includes('admin') || r.includes('nudge') || r.includes('unstick') || r.includes('operator')) return 'operator';
@@ -86,6 +91,29 @@ function attr(v: string | undefined): string | null {
   return t.slice(0, 120);
 }
 
+/**
+ * Which agent's turn may be stamped onto a request, given that ONE provider
+ * adapter — and therefore one header hook — serves every agent in the
+ * process (primary, subconscious, forks, ephemerals) and the hook cannot
+ * tell whose request it is decorating. Rule: stamp the primary's trigger
+ * only while the primary is the ONLY agent with a turn in flight; any other
+ * agent mid-turn → withhold (null), never guess. Debt is per agent, not per
+ * request, so it may always be read from the primary.
+ */
+export function stampedTrigger(view: {
+  agents: string[];
+  primary?: string | null;
+  triggerOf: (agent: string) => TurnTrigger | null | undefined;
+}): TurnTrigger | null {
+  const primary = view.primary ?? (view.agents.length === 1 ? view.agents[0] : undefined);
+  if (!primary) return null;
+  for (const a of view.agents) {
+    if (a !== primary && view.triggerOf(a)) return null;
+  }
+  const t = view.triggerOf(primary);
+  return t ?? null;
+}
+
 export function gateTelemetryHeaders(
   env: Record<string, string | undefined>,
   pendingDebtChunks: () => number | null,
@@ -99,7 +127,7 @@ export function gateTelemetryHeaders(
     const t = activeTrigger();
     if (!t) return out;
     out['x-gate-origin'] = originClass(t);
-    out['x-gate-channel'] = attr(t.channelId);
+    out['x-gate-channel'] = attr(t.channelId ?? t.wakeChannelId);
     out['x-gate-counterparty'] = attr(t.counterparty);
     return out;
   };

package/src/index.ts

@@ -28,7 +28,7 @@ import {
 } from '@animalabs/membrane';
 import { LoggingAnthropicAdapter } from './logging-adapter.js';
 import { LoggingProviderAdapter } from './logging-provider-wrapper.js';
-import { gateTelemetryHeaders, type TurnTrigger } from './gate-telemetry.js';
+import { gateTelemetryHeaders, stampedTrigger, type TurnTrigger } from './gate-telemetry.js';
 import { LoggingBedrockAdapter } from './logging-bedrock-adapter.js';
 import { CodexSubscriptionAdapter } from './codex-subscription-adapter.js';
 import { CallLedger } from './call-ledger.js';
@@ -510,6 +510,9 @@ agents: [agentConfig],
     // Client-side programmatic tool calling (code_execution) — recipe opt-in.
     ...(recipe.codeExecution ? { codeExecution: recipe.codeExecution } : {}),
     ...(conversations ? { conversations } : {}),
+    // Tune-out's subconscious resident (agent-framework#77) — recipe opt-in,
+    // passed through verbatim; the framework owns the defaults.
+    ...(recipe.subconscious ? { subconscious: recipe.subconscious } : {}),
   });
 
   // Wire post-creation hooks
@@ -946,11 +949,22 @@ async function main() {
   // multi-agent process (whose debt would we even claim?), no strategy — the
   // header is simply not sent: an unstamped call is honest, a guessed one lies.
   let appRefForDebt: AppContext | null = null;
+  // The resident whose turn/debt we stamp. TODO(agent-framework ≥0.14): use a
+  // public getPrimaryAgentName() accessor instead of the private field read.
+  const primaryAgent = (): { name: string; agent: unknown } | null => {
+    const fw = appRefForDebt?.framework;
+    const agents = fw?.getAllAgents() ?? [];
+    const name = (fw as unknown as { primaryAgentName?: string } | undefined)?.primaryAgentName
+      ?? (agents.length === 1 ? agents[0]!.name : undefined);
+    if (!name) return null;
+    const agent = agents.find((a) => a.name === name);
+    return agent ? { name, agent } : null;
+  };
   const pendingDebtChunks = (): number | null => {
     try {
-      const agents = appRefForDebt?.framework.getAllAgents() ?? [];
-      if (agents.length !== 1) return null;
-      const strategy = (agents[0] as unknown as {
+      const p = primaryAgent();
+      if (!p) return null;
+      const strategy = (p.agent as unknown as {
         getContextManager?: () => { getStrategy?: () => { getCompressionDebt?: () => unknown } };
       }).getContextManager?.()?.getStrategy?.();
       const d = strategy?.getCompressionDebt?.() as { pendingChunks?: unknown } | undefined;
@@ -967,10 +981,23 @@ async function main() {
   // -> null -> the origin trio is simply not sent.
   const activeTurnTrigger = (): TurnTrigger | null => {
     try {
-      const agents = appRefForDebt?.framework.getAllAgents() ?? [];
-      if (agents.length !== 1) return null;
-      const t = appRefForDebt?.framework.getActiveTurnTrigger(agents[0]!.name);
-      return t ? { reason: t.reason, source: t.source, channelId: t.channelId, counterparty: t.counterparty } : null;
+      const fw = appRefForDebt?.framework;
+      if (!fw) return null;
+      const agents = fw.getAllAgents();
+      // ONE adapter serves every agent in this process, so this hook cannot
+      // tell whose request it is decorating: stamp the primary's trigger only
+      // while no other agent (subconscious, fork, ephemeral) has a turn in
+      // flight — see stampedTrigger().
+      const t = stampedTrigger({
+        agents: agents.map((a) => a.name),
+        primary: primaryAgent()?.name,
+        triggerOf: (name) => {
+          const r = fw.getActiveTurnTrigger(name) as
+            (ReturnType<typeof fw.getActiveTurnTrigger> & { wakeChannelId?: string }) | undefined;
+          return r ? { reason: r.reason, source: r.source, channelId: r.channelId, wakeChannelId: r.wakeChannelId, counterparty: r.counterparty } : null;
+        },
+      });
+      return t;
     } catch {
       return null;
     }