@ouro.bot/cli 0.1.0-alpha.985 → 0.1.0-alpha.986

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.986",
+      "changes": [
+        "A huge tool result (a glob over a whole folder, a long log) no longer overflows the agent's context and kills the turn: the model sees its start and end with a line saying how big it was and how to narrow it."
+      ]
+    },
     {
       "version": "0.1.0-alpha.985",
       "changes": [

package/deploy/unraid/sanctuary.ouro/bundle-meta.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.985",
+  "runtimeVersion": "0.1.0-alpha.986",
   "bundleSchemaVersion": 3,
   "lastUpdated": "2026-09-03T00:00:00.000Z"
 }

package/deploy/unraid/sanctuary.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <Container version="2">
   <Name>ouro-butler</Name>
-  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.985</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.986</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/heart/core.js

@@ -63,6 +63,7 @@ const obligations_1 = require("../arc/obligations");
 const tool_loop_1 = require("./tool-loop");
 const packets_1 = require("../arc/packets");
 const tool_friction_1 = require("./tool-friction");
+const tool_output_budget_1 = require("./tool-output-budget");
 const delegated_command_1 = require("../a2a/delegated-command");
 const provider_models_1 = require("./provider-models");
 const provider_credentials_1 = require("./provider-credentials");
@@ -2606,7 +2607,7 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                         if (invoked && requiredToolCallNames.includes(tc.name) && !options?.requiredToolCalls?.requireSuccessfulResults)
                             dispatchedRequiredToolCalls.add(tc.name);
                         turnToolRecords.push({ name: tc.name, args, result: toolResult });
-                        const modelResult = (0, delegated_command_1.shieldDelegatedBanner)((0, tool_friction_1.rewriteToolResultForModel)(tc.name, toolResult, toolFrictionLedger));
+                        const modelResult = (0, delegated_command_1.shieldDelegatedBanner)((0, tool_output_budget_1.fitToolOutputForModel)(tc.name, (0, tool_friction_1.rewriteToolResultForModel)(tc.name, toolResult, toolFrictionLedger)));
                         pushGenerated({ role: "tool", tool_call_id: tc.id, content: modelResult });
                         providerRuntime.appendToolOutput(tc.id, modelResult);
                         if (!success)

package/dist/heart/tool-output-budget.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_OUTPUT_MAX_CHARS = void 0;
+exports.fitToolOutputForModel = fitToolOutputForModel;
+const runtime_1 = require("../nerves/runtime");
+/** The most characters one tool result may put in front of the model (about 8k tokens). */
+exports.TOOL_OUTPUT_MAX_CHARS = 32_000;
+const HEAD_SHARE = 0.75;
+/** Cut to the last line break at or before `limit`, or to `limit` when the text has none there. */
+function headWithin(text, limit) {
+    const head = text.slice(0, limit);
+    const lastBreak = head.lastIndexOf("\n");
+    return lastBreak > 0 ? head.slice(0, lastBreak) : head;
+}
+/** Keep the last `limit` characters, starting after a line break when there is one. */
+function tailWithin(text, limit) {
+    const tail = text.slice(text.length - limit);
+    const firstBreak = tail.indexOf("\n");
+    return firstBreak >= 0 ? tail.slice(firstBreak + 1) : tail;
+}
+/**
+ * Fit one tool result into the model's view. Output within the budget is returned unchanged.
+ * Larger output keeps its start and its end, on line boundaries, around one line that says how
+ * big the whole result was and how to see the rest, so a huge listing or log never overflows
+ * the context window and kills the turn.
+ */
+function fitToolOutputForModel(tool, text) {
+    if (text.length <= exports.TOOL_OUTPUT_MAX_CHARS)
+        return text;
+    const head = headWithin(text, Math.floor(exports.TOOL_OUTPUT_MAX_CHARS * HEAD_SHARE));
+    const tail = tailWithin(text, exports.TOOL_OUTPUT_MAX_CHARS - head.length);
+    const omitted = text.length - head.length - tail.length;
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.tool_output_fitted",
+        message: "tool output fitted to the model's budget",
+        meta: { tool, totalChars: text.length, omittedChars: omitted },
+    });
+    const notice = `[${tool} returned ${text.length.toLocaleString("en-US")} characters; the middle ${omitted.toLocaleString("en-US")} are not shown. To see them, narrow the request: a tighter pattern or folder, a line range, or a filter such as head, tail or grep.]`;
+    return `${head}\n${notice}\n${tail}`;
+}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.985",
+  "version": "0.1.0-alpha.986",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.985",
+      "version": "0.1.0-alpha.986",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.78.0",
         "@azure/identity": "^4.13.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.985",
+  "version": "0.1.0-alpha.986",
   "engines": {
     "node": ">=22"
   },