@ouro.bot/cli 0.1.0-alpha.133 → 0.1.0-alpha.135

package/dist/heart/daemon/thoughts.js

@@ -93,7 +93,7 @@ function extractToolNames(messages) {
         if (msg.role === "assistant" && Array.isArray(msg.tool_calls)) {
             for (const tc of msg.tool_calls) {
                 const toolFunction = extractToolFunction(tc);
-                if (toolFunction?.name && toolFunction.name !== "final_answer")
+                if (toolFunction?.name && toolFunction.name !== "settle")
                     names.push(toolFunction.name);
             }
         }
@@ -321,15 +321,15 @@ function formatInnerDialogStatus(status) {
     }
     return lines.join("\n");
 }
-/** Extract text from a final_answer tool call's arguments. */
-function extractFinalAnswer(messages) {
+/** Extract text from a settle tool call's arguments. */
+function extractSettleAnswer(messages) {
     for (let k = messages.length - 1; k >= 0; k--) {
         const msg = messages[k];
         if (msg.role !== "assistant" || !Array.isArray(msg.tool_calls))
             continue;
         for (const tc of msg.tool_calls) {
             const toolFunction = extractToolFunction(tc);
-            if (toolFunction?.name !== "final_answer")
+            if (toolFunction?.name !== "settle")
                 continue;
             try {
                 const parsed = JSON.parse(toolFunction.arguments ?? "{}");
@@ -348,7 +348,7 @@ function extractThoughtResponseFromMessages(messages) {
     const lastAssistant = assistantMsgs.reverse().find((message) => contentToText(message.content).trim().length > 0);
     return lastAssistant
         ? contentToText(lastAssistant.content).trim()
-        : extractFinalAnswer(messages);
+        : extractSettleAnswer(messages);
 }
 function parseInnerDialogSession(sessionPath) {
     (0, runtime_1.emitNervesEvent)({
@@ -397,7 +397,7 @@ function parseInnerDialogSession(sessionPath) {
             j++;
         }
         // Find the last assistant text response in this turn.
-        // With tool_choice="required", the response may be inside a final_answer tool call.
+        // With tool_choice="required", the response may be inside a settle tool call.
         const response = extractThoughtResponseFromMessages(turnMessages);
         const tools = extractToolNames(turnMessages);
         turns.push({

package/dist/heart/delegation.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.decideDelegation = decideDelegation;
 const runtime_1 = require("../nerves/runtime");
 const CROSS_SESSION_TOOLS = new Set(["query_session", "send_message", "bridge_manage"]);
-const FAST_PATH_TOOLS = new Set(["final_answer"]);
+const FAST_PATH_TOOLS = new Set(["settle"]);
 const REFLECTION_PATTERN = /\b(think|reflect|ponder|surface|surfaces|surfaced|sit with|metaboli[sz]e)\b/i;
 const CROSS_SESSION_PATTERN = /\b(other chat|other session|across chats?|across sessions?|keep .* aligned|relay|carry .* across)\b/i;
 function hasExplicitReflection(ingressTexts) {

package/dist/heart/kicks.js

@@ -5,7 +5,7 @@ exports.detectKick = detectKick;
 const runtime_1 = require("../nerves/runtime");
 const KICK_MESSAGES = {
     empty: "I sent an empty message by accident — let me try again.",
-    narration: "I narrated instead of acting. Using the tool now -- if done, calling final_answer.",
+    narration: "I narrated instead of acting. Using the tool now -- if done, calling settle.",
     tool_required: "tool-required is on — I need to call a tool. use /tool-required to turn it off.",
 };
 const TOOL_INTENT_PATTERNS = [

package/dist/heart/providers/anthropic.js

@@ -301,7 +301,7 @@ async function streamAnthropicMessages(client, model, request) {
     const toolCalls = new Map();
     const thinkingBlocks = new Map();
     const redactedBlocks = new Map();
-    const answerStreamer = new streaming_1.FinalAnswerStreamer(request.callbacks, request.eagerFinalAnswerStreaming);
+    const answerStreamer = new streaming_1.SettleStreamer(request.callbacks, request.eagerSettleStreaming);
     try {
         for await (const event of response) {
             if (request.signal?.aborted)
@@ -327,9 +327,9 @@ async function streamAnthropicMessages(client, model, request) {
                         name,
                         arguments: input,
                     });
-                    // Activate eager streaming for sole final_answer tool call
-                    /* v8 ignore next -- final_answer streaming activation, tested via FinalAnswerStreamer unit tests @preserve */
-                    if (name === "final_answer" && toolCalls.size === 1) {
+                    // Activate eager streaming for sole settle tool call
+                    /* v8 ignore next -- settle streaming activation, tested via SettleStreamer unit tests @preserve */
+                    if (name === "settle" && toolCalls.size === 1) {
                         answerStreamer.activate();
                     }
                 }
@@ -374,8 +374,8 @@ async function streamAnthropicMessages(client, model, request) {
                     if (existing) {
                         const partialJson = String(delta?.partial_json ?? "");
                         existing.arguments = mergeAnthropicToolArguments(existing.arguments, partialJson);
-                        /* v8 ignore next -- final_answer delta streaming, tested via FinalAnswerStreamer unit tests @preserve */
-                        if (existing.name === "final_answer" && toolCalls.size === 1) {
+                        /* v8 ignore next -- settle delta streaming, tested via SettleStreamer unit tests @preserve */
+                        if (existing.name === "settle" && toolCalls.size === 1) {
                             answerStreamer.processDelta(partialJson);
                         }
                     }
@@ -414,7 +414,7 @@ async function streamAnthropicMessages(client, model, request) {
         toolCalls: [...toolCalls.values()],
         outputItems,
         usage,
-        finalAnswerStreamed: answerStreamer.streamed,
+        settleStreamed: answerStreamer.streamed,
     };
 }
 function createAnthropicProviderRuntime(config) {

package/dist/heart/providers/azure.js

@@ -159,7 +159,7 @@ function createAzureProviderRuntime(config) {
                 params.metadata = { trace_id: request.traceId };
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
-            const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
+            const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerSettleStreaming);
             for (const item of result.outputItems)
                 nativeInput.push(item);
             return result;

package/dist/heart/providers/github-copilot.js

@@ -88,7 +88,7 @@ function createGithubCopilotProviderRuntime(injectedConfig) {
                 if (request.toolChoiceRequired)
                     params.tool_choice = "required";
                 try {
-                    return await (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
+                    return await (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerSettleStreaming);
                 }
                 catch (error) {
                     throw error instanceof Error ? error : new Error(String(error));
@@ -139,7 +139,7 @@ function createGithubCopilotProviderRuntime(injectedConfig) {
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
             try {
-                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
+                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerSettleStreaming);
                 for (const item of result.outputItems)
                     nativeInput.push(item);
                 return result;

package/dist/heart/providers/minimax.js

@@ -74,7 +74,7 @@ function createMinimaxProviderRuntime(config) {
                 params.metadata = { trace_id: request.traceId };
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
-            return (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
+            return (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerSettleStreaming);
         },
         classifyError(error) {
             return classifyMinimaxError(error);

package/dist/heart/providers/openai-codex.js

@@ -180,7 +180,7 @@ function createOpenAICodexProviderRuntime(config) {
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
             try {
-                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
+                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerSettleStreaming);
                 for (const item of result.outputItems)
                     nativeInput.push(item);
                 return result;

package/dist/heart/streaming.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FinalAnswerStreamer = exports.FinalAnswerParser = void 0;
+exports.SettleStreamer = exports.SettleParser = void 0;
 exports.toResponsesInput = toResponsesInput;
 exports.toResponsesTools = toResponsesTools;
 exports.streamChatCompletion = streamChatCompletion;
 exports.streamResponsesApi = streamResponsesApi;
 const runtime_1 = require("../nerves/runtime");
 // Character-level state machine that extracts the answer value from
-// `final_answer` tool call JSON arguments as they stream in.
+// `settle` tool call JSON arguments as they stream in.
 // Scans for prefix `"answer":"` or `"answer": "` in the character stream,
 // then emits text handling JSON escapes, stopping at unescaped closing `"`.
-class FinalAnswerParser {
+class SettleParser {
     // Possible prefixes to match (with and without space after colon)
     static PREFIXES = ['"answer":"', '"answer": "'];
     // Buffer of characters seen so far (pre-activation only)
@@ -29,7 +29,7 @@ class FinalAnswerParser {
             if (!this._active) {
                 this.buf += ch;
                 // Check if any prefix has been fully matched in the buffer
-                for (const prefix of FinalAnswerParser.PREFIXES) {
+                for (const prefix of SettleParser.PREFIXES) {
                     if (this.buf.endsWith(prefix)) {
                         this._active = true;
                         break;
@@ -76,12 +76,12 @@ class FinalAnswerParser {
         return out;
     }
 }
-exports.FinalAnswerParser = FinalAnswerParser;
-// Shared helper: wraps FinalAnswerParser with onClearText + onTextChunk wiring.
+exports.SettleParser = SettleParser;
+// Shared helper: wraps SettleParser with onClearText + onTextChunk wiring.
 // Used by all streaming providers (Chat Completions, Responses API, Anthropic)
-// so the eager-match streaming pattern lives in one place.
-class FinalAnswerStreamer {
-    parser = new FinalAnswerParser();
+// so the eager-match settle streaming pattern lives in one place.
+class SettleStreamer {
+    parser = new SettleParser();
     _detected = false;
     callbacks;
     enabled;
@@ -91,7 +91,7 @@ class FinalAnswerStreamer {
     }
     get detected() { return this._detected; }
     get streamed() { return this.parser.active; }
-    /** Mark final_answer as detected. Calls onClearText on the callbacks. */
+    /** Mark settle as detected. Calls onClearText on the callbacks. */
     activate() {
         if (!this.enabled)
             return;
@@ -111,7 +111,7 @@ class FinalAnswerStreamer {
             this.callbacks.onTextChunk(text);
     }
 }
-exports.FinalAnswerStreamer = FinalAnswerStreamer;
+exports.SettleStreamer = SettleStreamer;
 function toResponsesUserContent(content) {
     if (typeof content === "string") {
         return content;
@@ -233,7 +233,7 @@ function toResponsesTools(ccTools) {
         strict: false,
     }));
 }
-async function streamChatCompletion(client, createParams, callbacks, signal, eagerFinalAnswerStreaming = true) {
+async function streamChatCompletion(client, createParams, callbacks, signal, eagerSettleStreaming = true) {
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.stream_start",
@@ -247,7 +247,7 @@ async function streamChatCompletion(client, createParams, callbacks, signal, eag
     let toolCalls = {};
     let streamStarted = false;
     let usage;
-    const answerStreamer = new FinalAnswerStreamer(callbacks, eagerFinalAnswerStreaming);
+    const answerStreamer = new SettleStreamer(callbacks, eagerSettleStreaming);
     // State machine for parsing inline <think> tags (MiniMax pattern)
     let contentBuf = "";
     let inThinkTag = false;
@@ -362,19 +362,19 @@ async function streamChatCompletion(client, createParams, callbacks, signal, eag
                     toolCalls[tc.index].id = tc.id;
                 if (tc.function?.name) {
                     toolCalls[tc.index].name = tc.function.name;
-                    // Detect final_answer tool call on first name delta.
+                    // Detect settle tool call on first name delta.
                     // Only activate streaming if this is the sole tool call (index 0
                     // and no other indices seen). Mixed calls are rejected by core.ts.
-                    if (tc.function.name === "final_answer" && !answerStreamer.detected
+                    if (tc.function.name === "settle" && !answerStreamer.detected
                         && tc.index === 0 && Object.keys(toolCalls).length === 1) {
                         answerStreamer.activate();
                     }
                 }
                 if (tc.function?.arguments) {
                     toolCalls[tc.index].arguments += tc.function.arguments;
-                    // Feed final_answer argument deltas to the parser for progressive
+                    // Feed settle argument deltas to the parser for progressive
                     // streaming, but only when it appears to be the sole tool call.
-                    if (answerStreamer.detected && toolCalls[tc.index].name === "final_answer"
+                    if (answerStreamer.detected && toolCalls[tc.index].name === "settle"
                         && Object.keys(toolCalls).length === 1) {
                         answerStreamer.processDelta(tc.function.arguments);
                     }
@@ -390,10 +390,10 @@ async function streamChatCompletion(client, createParams, callbacks, signal, eag
         toolCalls: Object.values(toolCalls),
         outputItems: [],
         usage,
-        finalAnswerStreamed: answerStreamer.streamed,
+        settleStreamed: answerStreamer.streamed,
     };
 }
-async function streamResponsesApi(client, createParams, callbacks, signal, eagerFinalAnswerStreaming = true) {
+async function streamResponsesApi(client, createParams, callbacks, signal, eagerSettleStreaming = true) {
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.stream_start",
@@ -408,7 +408,7 @@ async function streamResponsesApi(client, createParams, callbacks, signal, eager
     const outputItems = [];
     let currentToolCall = null;
     let usage;
-    const answerStreamer = new FinalAnswerStreamer(callbacks, eagerFinalAnswerStreaming);
+    const answerStreamer = new SettleStreamer(callbacks, eagerSettleStreaming);
     let functionCallCount = 0;
     for await (const event of response) {
         if (signal?.aborted)
@@ -438,10 +438,10 @@ async function streamResponsesApi(client, createParams, callbacks, signal, eager
                         name: String(event.item.name),
                         arguments: "",
                     };
-                    // Detect final_answer function call -- clear any streamed noise.
+                    // Detect settle function call -- clear any streamed noise.
                     // Only activate when this is the first (and so far only) function call.
                     // Mixed calls are rejected by core.ts; no need to stream their args.
-                    if (String(event.item.name) === "final_answer" && functionCallCount === 1) {
+                    if (String(event.item.name) === "settle" && functionCallCount === 1) {
                         answerStreamer.activate();
                     }
                 }
@@ -450,9 +450,9 @@ async function streamResponsesApi(client, createParams, callbacks, signal, eager
             case "response.function_call_arguments.delta": {
                 if (currentToolCall) {
                     currentToolCall.arguments += event.delta;
-                    // Feed final_answer argument deltas to the parser for progressive
+                    // Feed settle argument deltas to the parser for progressive
                     // streaming, but only when it appears to be the sole function call.
-                    if (answerStreamer.detected && currentToolCall.name === "final_answer"
+                    if (answerStreamer.detected && currentToolCall.name === "settle"
                         && functionCallCount === 1) {
                         answerStreamer.processDelta(String(event.delta));
                     }
@@ -494,6 +494,6 @@ async function streamResponsesApi(client, createParams, callbacks, signal, eager
         toolCalls,
         outputItems,
         usage,
-        finalAnswerStreamed: answerStreamer.streamed,
+        settleStreamed: answerStreamer.streamed,
     };
 }

package/dist/heart/tool-loop.js

@@ -178,8 +178,12 @@ function recordToolOutcome(state, toolName, args, result, success) {
         state.history.splice(0, state.history.length - exports.TOOL_LOOP_HISTORY_LIMIT);
     }
 }
+// Tools that must never be blocked by the circuit breaker.
+// settle = end the turn, surface = deliver results outward.
+// Blocking these traps the agent: it can think all it wants but can never speak.
+const CIRCUIT_BREAKER_EXEMPT = new Set(["settle", "surface"]);
 function detectToolLoop(state, toolName, args) {
-    if (state.history.length >= exports.GLOBAL_CIRCUIT_BREAKER_LIMIT) {
+    if (state.history.length >= exports.GLOBAL_CIRCUIT_BREAKER_LIMIT && !CIRCUIT_BREAKER_EXEMPT.has(toolName)) {
         return emitDetection("global_circuit_breaker", toolName, state.history.length, `this turn has already made ${state.history.length} tool calls. stop thrashing, use the current evidence, and either change approach or answer truthfully with the best grounded status.`);
     }
     const callHash = digest(normalizeArgs(toolName, args));

package/dist/mind/context.js

@@ -36,7 +36,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.trimMessages = trimMessages;
 exports.validateSessionMessages = validateSessionMessages;
 exports.repairSessionMessages = repairSessionMessages;
+exports.migrateToolNames = migrateToolNames;
 exports.saveSession = saveSession;
+exports.appendSyntheticAssistantMessage = appendSyntheticAssistantMessage;
 exports.loadSession = loadSession;
 exports.postTurn = postTurn;
 exports.deleteSession = deleteSession;
@@ -255,6 +257,43 @@ function stripOrphanedToolResults(messages) {
     }
     return repaired;
 }
+// Tool renames that have shipped. Old names in session history confuse the
+// model into calling tools that no longer exist. Applied on session load so
+// the transcript uses the current vocabulary.
+const TOOL_NAME_MIGRATIONS = {
+    final_answer: "settle",
+    no_response: "observe",
+    go_inward: "descend",
+};
+function migrateToolNames(messages) {
+    let migrated = 0;
+    const result = messages.map((msg) => {
+        if (msg.role !== "assistant" || !Array.isArray(msg.tool_calls) || msg.tool_calls.length === 0)
+            return msg;
+        let changed = false;
+        const updatedCalls = msg.tool_calls.map((tc) => {
+            if (tc.type !== "function")
+                return tc;
+            const newName = TOOL_NAME_MIGRATIONS[tc.function.name];
+            if (!newName)
+                return tc;
+            changed = true;
+            migrated++;
+            return { ...tc, function: { ...tc.function, name: newName } };
+        });
+        return changed ? { ...msg, tool_calls: updatedCalls } : msg;
+    });
+    if (migrated > 0) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "info",
+            event: "mind.session_tool_name_migration",
+            component: "mind",
+            message: "migrated deprecated tool names in session history",
+            meta: { migrated },
+        });
+    }
+    return result;
+}
 function saveSession(filePath, messages, lastUsage, state) {
     const violations = validateSessionMessages(messages);
     if (violations.length > 0) {
@@ -280,6 +319,28 @@ function saveSession(filePath, messages, lastUsage, state) {
     }
     fs.writeFileSync(filePath, JSON.stringify(envelope, null, 2));
 }
+function appendSyntheticAssistantMessage(filePath, content) {
+    try {
+        if (!fs.existsSync(filePath))
+            return false;
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.version !== 1 || !Array.isArray(data.messages))
+            return false;
+        data.messages.push({ role: "assistant", content });
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+        (0, runtime_1.emitNervesEvent)({
+            component: "mind",
+            event: "mind.session_synthetic_message_appended",
+            message: "appended synthetic assistant message to session",
+            meta: { path: filePath, contentLength: content.length },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function loadSession(filePath) {
     try {
         const raw = fs.readFileSync(filePath, "utf-8");
@@ -299,6 +360,7 @@ function loadSession(filePath) {
             messages = repairSessionMessages(messages);
         }
         messages = stripOrphanedToolResults(messages);
+        messages = migrateToolNames(messages);
         const rawState = data?.state && typeof data.state === "object" && data.state !== null
             ? data.state
             : undefined;

package/dist/mind/prompt.js

@@ -56,6 +56,7 @@ const ouro_version_manager_1 = require("../heart/daemon/ouro-version-manager");
 const tools_1 = require("../repertoire/tools");
 const skills_1 = require("../repertoire/skills");
 const identity_1 = require("../heart/identity");
+const runtime_mode_1 = require("../heart/daemon/runtime-mode");
 const types_1 = require("./friends/types");
 const trust_explanation_1 = require("./friends/trust-explanation");
 const channel_1 = require("./friends/channel");
@@ -262,6 +263,9 @@ function runtimeInfoSection(channel) {
         }
     }
     lines.push(`changelog available at: ${(0, bundle_manifest_1.getChangelogPath)()}`);
+    const sourceRoot = (0, identity_1.getRepoRoot)();
+    lines.push(`source root: ${sourceRoot}`);
+    lines.push(`runtime mode: ${(0, runtime_mode_1.detectRuntimeMode)(sourceRoot)}`);
     lines.push(`cwd: ${process.cwd()}`);
     lines.push(`channel: ${channel}`);
     lines.push(`current sense: ${channel}`);
@@ -271,11 +275,11 @@ function runtimeInfoSection(channel) {
         lines.push("i introduce myself on boot with a fun random greeting.");
     }
     else if (channel === "inner") {
-        // No boot greeting or channel-specific guidance for inner dialog
+        lines.push("this is my private thinking space. when a thought is ready to share, i surface it to whoever needs to hear it. i settle when i'm done thinking.");
     }
     else if (channel === "bluebubbles") {
         lines.push("i am responding in iMessage through BlueBubbles. i keep replies short and phone-native. i do not use markdown. i do not introduce myself on boot.");
-        lines.push("when a bluebubbles turn arrives from a thread, the harness tells me the current lane and any recent active thread ids. if widening back to top-level or routing into a different active thread is the better move, i use bluebubbles_set_reply_target before final_answer.");
+        lines.push("when a bluebubbles turn arrives from a thread, the harness tells me the current lane and any recent active thread ids. if widening back to top-level or routing into a different active thread is the better move, i use bluebubbles_set_reply_target before settle.");
     }
     else {
         lines.push("i am responding in Microsoft Teams. i keep responses concise. i use markdown formatting. i do not introduce myself on boot.");
@@ -356,7 +360,7 @@ function dateSection() {
 }
 function toolsSection(channel, options, context) {
     const channelTools = (0, tools_1.getToolsForChannel)((0, channel_1.getChannelCapabilities)(channel), undefined, context, options?.providerCapabilities);
-    const activeTools = (options?.toolChoiceRequired ?? true) ? [...channelTools, tools_1.finalAnswerTool] : channelTools;
+    const activeTools = (options?.toolChoiceRequired ?? true) ? [...channelTools, tools_1.settleTool] : channelTools;
     const list = activeTools
         .map((t) => `- ${t.function.name}: ${t.function.description}`)
         .join("\n");
@@ -557,7 +561,7 @@ i should orient around that live lane first, then decide what still needs to com
         return `## where my attention is
 i have unfinished work that needs attention before i move on.
 
-i can take it inward with go_inward to think privately, or address it directly here.`;
+i can take it inward with descend to think privately, or address it directly here.`;
     }
     if (cog === "shared-work") {
         /* v8 ignore stop */
@@ -619,19 +623,20 @@ function toolBehaviorSection(options) {
     return `## tool behavior
 tool_choice is set to "required" -- i must call a tool on every turn.
 - need more information? i call a tool.
-- ready to respond to the user? i call \`final_answer\`.
-\`final_answer\` is a tool call -- it satisfies the tool_choice requirement.
-\`final_answer\` must be the ONLY tool call in that turn. do not combine it with other tool calls.
-do NOT call no-op tools just before \`final_answer\`. if i am done, i call \`final_answer\` directly.`;
+- ready to respond to the user? i call \`settle\`.
+\`settle\` is a tool call -- it satisfies the tool_choice requirement.
+\`settle\` must be the ONLY tool call in that turn. do not combine it with other tool calls.
+do NOT call no-op tools just before \`settle\`. if i am done, i call \`settle\` directly.`;
 }
 function workspaceDisciplineSection() {
     return `## repo workspace discipline
-when a shared-harness or local code fix needs repo work, i get the real workspace first with \`safe_workspace\`.
-\`read_file\`, \`write_file\`, and \`edit_file\` already map repo paths into that workspace. shell commands that target the harness run there too.
+my source code lives at the path shown in \`source root\` above. that always matches my running version.
+when i need to read my own code to understand my tools or debug behavior, i read from source root.
+when i need to EDIT harness code (self-fix, feature work), i create a git worktree first so i don't dirty the working tree.
 
 before the first repo edit, i tell the user in 1-2 short lines:
 - the friction i'm fixing
-- the workspace path/branch i'm using
+- the worktree path/branch i'm using
 - the first concrete action i'm taking`;
 }
 function contextSection(context, options) {
@@ -668,7 +673,7 @@ function contextSection(context, options) {
     lines.push("my conversation memory is ephemeral -- it resets between sessions. anything i learn about my friend, i save with save_friend_note so future me remembers.");
     lines.push("the conversation is my source of truth. my notes are a journal for future me -- they may be stale or incomplete.");
     lines.push("when i learn something that might invalidate an existing note, i check related notes and update or override any that are stale.");
-    lines.push("i save ANYTHING i learn about my friend immediately with save_friend_note -- names, preferences, what they do, what they care about. when in doubt, save it. saving comes BEFORE responding: i call save_friend_note first, then final_answer on the next turn.");
+    lines.push("i save ANYTHING i learn about my friend immediately with save_friend_note -- names, preferences, what they do, what they care about. when in doubt, save it. saving comes BEFORE responding: i call save_friend_note first, then settle on the next turn.");
     // Onboarding instructions (only below token threshold -- drop once exceeded)
     const impressions = (0, first_impressions_1.getFirstImpressions)(friend, options);
     if (impressions) {
@@ -727,13 +732,13 @@ function groupChatParticipationSection(context) {
 group chats are conversations between people. i'm one participant, not the host.
 
 i don't need to respond to everything. most reactions, tapbacks, and side
-conversations between others aren't for me. i use no_response to stay quiet
+conversations between others aren't for me. i use observe to stay quiet
 when the moment doesn't call for my voice — same as any person would.
 
 when a reaction or emoji says it better than words, i can react instead of
 typing a full reply. a thumbs-up is often the perfect response.
 
-no_response must be the sole tool call in the turn (same rule as final_answer).
+observe must be the sole tool call in the turn (same rule as settle).
 when unsure whether to chime in, i lean toward silence rather than noise.`;
 }
 function mixedTrustGroupSection(context) {

package/dist/repertoire/ado-semantic.js

@@ -279,6 +279,7 @@ exports.adoSemanticToolDefinitions = [
             return formatForChannel(items, ctx, organization, project);
         },
         integration: "ado",
+        summaryKeys: ["organization", "project"],
     },
     // -- ado_create_epic --
     {
@@ -318,6 +319,7 @@ exports.adoSemanticToolDefinitions = [
         },
         integration: "ado",
         confirmationRequired: true,
+        summaryKeys: ["organization", "project", "title"],
     },
     // -- ado_create_issue --
     {
@@ -359,6 +361,7 @@ exports.adoSemanticToolDefinitions = [
         },
         integration: "ado",
         confirmationRequired: true,
+        summaryKeys: ["organization", "project", "title"],
     },
     // -- ado_move_items --
     {
@@ -413,6 +416,7 @@ exports.adoSemanticToolDefinitions = [
         },
         integration: "ado",
         confirmationRequired: true,
+        summaryKeys: ["organization", "project", "workItemIds"],
     },
     // -- ado_restructure_backlog --
     {
@@ -471,6 +475,7 @@ exports.adoSemanticToolDefinitions = [
         },
         integration: "ado",
         confirmationRequired: true,
+        summaryKeys: ["organization", "project"],
     },
     // -- ado_validate_structure --
     {
@@ -672,6 +677,7 @@ exports.adoSemanticToolDefinitions = [
         },
         integration: "ado",
         confirmationRequired: true,
+        summaryKeys: ["organization", "project"],
     },
     // -- ado_detect_orphans --
     {

package/dist/repertoire/coding/tools.js

@@ -279,6 +279,7 @@ exports.codingToolDefinitions = [
             }
             return JSON.stringify(session);
         },
+        summaryKeys: ["runner", "workdir", "taskRef"],
     },
     {
         tool: codingStatusTool,
@@ -294,6 +295,7 @@ exports.codingToolDefinitions = [
                 return `session not found: ${sessionId}`;
             return JSON.stringify(session);
         },
+        summaryKeys: ["sessionId"],
     },
     {
         tool: codingTailTool,
@@ -307,6 +309,7 @@ exports.codingToolDefinitions = [
                 return `session not found: ${sessionId}`;
             return (0, index_1.formatCodingTail)(session);
         },
+        summaryKeys: ["sessionId"],
     },
     {
         tool: codingSendInputTool,
@@ -320,6 +323,7 @@ exports.codingToolDefinitions = [
                 return "input is required";
             return JSON.stringify((0, index_1.getCodingSessionManager)().sendInput(sessionId, input));
         },
+        summaryKeys: ["sessionId", "input"],
     },
     {
         tool: codingKillTool,
@@ -330,5 +334,6 @@ exports.codingToolDefinitions = [
                 return "sessionId is required";
             return JSON.stringify((0, index_1.getCodingSessionManager)().killSession(sessionId));
         },
+        summaryKeys: ["sessionId"],
     },
 ];