@agentshouse/kit 0.1.0-alpha.34 → 0.1.0-alpha.35

package/README.md

@@ -12,7 +12,7 @@ The Skill set Kit installs is Matt Pocock's
 On Linux `amd64` or `arm64`, run the published, versioned bootstrap once:
 
 ```sh
-bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.34/connect-linux.sh)
+bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.35/connect-linux.sh)
 ```
 
 The bootstrap first establishes Docker Engine from what it observes on the
@@ -889,9 +889,10 @@ the same for every adapter kind: the line
 `The agents.house house CLI is available: run house --help.`, the base
 instructions of the Execution attempt plan House acquired, and the current text
 of the owner's How-we-work document `/private/library/how-we-work.md`, which the
-launcher reads with the `shell` tool over the Session's own bridge, following
-House's cursor to the whole text. An absent document, one the Session's ceiling
-cannot read, and empty base instructions add nothing. Any other failed read
+launcher reads with the `shell` tool over the Session's own bridge, running
+the continuation each cut reply's `output_cut` line prints until a reply comes
+back uncut. A document that is absent, or that the Session's ceiling cannot
+read, at the first read adds nothing, and so do empty base instructions. Any other failed read
 refuses the attempt as `kit_how_we_work_unreadable` with the bridge's cause
 before a prompt is sent. A session reloaded with `session/load` already holds
 the block and gets none. It forwards only adapter-classified User-visible assistant
@@ -2188,6 +2189,17 @@ and that a pending submission House answers `operation_expired` is pulled first,
 then sent again under a new identifier only if it never landed. Evidence is
 written to `tmp/delivery-evidence/sync-pair.json`.
 
+The How-we-work reader has its own paired proof:
+
+```sh
+HOUSE_CORE_ROOT=<core checkout> HOUSE_AUTH_ROOT=<auth checkout> \
+  KIT_PAIR_SPECS=/kit/test/pair/how-we-work.vitest.ts bash test/pair/run.sh
+```
+
+It writes a document longer than two of House's cut shell replies and proves
+the installed reader returns its whole text by running each printed
+continuation. Evidence is written to `tmp/delivery-evidence/how-we-work-pair.json`.
+
 The retained-original consumers have their own paired proofs:
 
 ```sh

package/bootstrap.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "version": "0.1.0-alpha.34",
+  "version": "0.1.0-alpha.35",
   "hosts": {
     "linux": {
-      "command": "bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.34/connect-linux.sh)",
+      "command": "bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.35/connect-linux.sh)",
       "asset": {
         "name": "connect-linux.sh",
-        "url": "https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.34/connect-linux.sh"
+        "url": "https://github.com/agentshouse/kit/releases/download/v0.1.0-alpha.35/connect-linux.sh"
       },
       "workspace": {
         "argument": "--workspace",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/kit",
-  "version": "0.1.0-alpha.34",
+  "version": "0.1.0-alpha.35",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/adapter-mcp.js

@@ -38,54 +38,70 @@ export async function commandHouseInstructions(bridge) {
   return frame.result.instructions;
 }
 
+const CUT_NOTICE = "shell: output_cut ";
+const CONTINUATION = "; continue with: ";
+const BYTE_CONTINUATION = /\| tail -c \+[1-9][0-9]*$/u;
+
 function shellAnswer(text) {
   const lines = text.split("\n");
   if (!lines[0].startsWith(`protocol: render=${SHELL_RENDER} `)) return null;
   const exit = Number(lines[2].slice("exit: ".length));
+  const truncation = lines[3].slice("truncation: ".length);
   let at = lines[5]?.startsWith("authority: ") ? 6 : 5;
-  if (exit === 0) return { exit, stderr: [], stdout: lines.slice(at).join("\n"), cursor: null };
+  if (exit === 0 && truncation === "none") {
+    return { exit, truncation, stderr: [], stdout: lines.slice(at).join("\n"), continuation: null };
+  }
   const stderr = [];
-  while (lines[at]?.startsWith("stderr: ")) stderr.push(lines[at++].slice("stderr: ".length));
-  const stdout = lines.slice(at);
-  const cursor = stdout.at(-1)?.startsWith("cursor: ") ? stdout.pop().slice("cursor: ".length) : null;
-  return { exit, stderr, stdout: stdout.join("\n"), cursor };
+  let continuation = null;
+  while (continuation === null && lines[at]?.startsWith("stderr: ")) {
+    const line = lines[at++].slice("stderr: ".length);
+    stderr.push(line);
+    const separator = line.indexOf(CONTINUATION);
+    if (line.startsWith(CUT_NOTICE) && separator !== -1) {
+      continuation = line.slice(separator + CONTINUATION.length);
+    }
+  }
+  return { exit, truncation, stderr, stdout: lines.slice(at).join("\n"), continuation };
 }
 
-async function howWeWorkPage(bridge, cursor) {
+async function howWeWorkReply(bridge, command, first) {
   const frame = await bridgeCall(bridge, {
     method: "tools/call",
-    params: {
-      name: "shell",
-      arguments: { command: `cat ${HOW_WE_WORK_PATH}`, ...(cursor === null ? {} : { cursor }) },
-    },
+    params: { name: "shell", arguments: { command } },
   });
   if (frame.error !== undefined) {
     throw new KitRefusal("kit_how_we_work_unreadable", frame.error.message ?? null);
   }
   const text = answerText(frame.result);
   if (frame.result?.isError === true) {
-    if (text.split(":")[0] === "room_not_found") return null;
+    if (first && text.split(":")[0] === "room_not_found") return null;
     throw new KitRefusal("kit_how_we_work_unreadable", text);
   }
-  const page = shellAnswer(text);
-  if (page === null) throw new KitRefusal("kit_how_we_work_unreadable", text);
-  if (page.cursor === null && page.exit !== 0) {
-    if (page.stderr.length === 1 && page.stderr[0].split(" ")[1] === "path_not_found") return null;
-    throw new KitRefusal("kit_how_we_work_unreadable", page.stderr.join("\n"));
+  const reply = shellAnswer(text);
+  if (reply === null) throw new KitRefusal("kit_how_we_work_unreadable", text);
+  if (reply.exit !== 0) {
+    if (first && reply.stderr.length === 1 && reply.stderr[0].split(" ")[1] === "path_not_found") return null;
+    throw new KitRefusal("kit_how_we_work_unreadable", reply.stderr.join("\n"));
+  }
+  if (reply.truncation !== "none" && reply.continuation === null) {
+    throw new KitRefusal("kit_how_we_work_unreadable", reply.stderr.join("\n"));
   }
-  return page;
+  return reply;
 }
 
 export async function commandHouseHowWeWork(bridge) {
-  const pages = [];
-  let cursor = null;
-  do {
-    const page = await howWeWorkPage(bridge, cursor);
-    if (page === null) return "";
-    pages.push(page.stdout);
-    cursor = page.cursor;
-  } while (cursor !== null);
-  return pages.join("\n");
+  let document = "";
+  let command = `cat ${HOW_WE_WORK_PATH}`;
+  let first = true;
+  while (command !== null) {
+    const reply = await howWeWorkReply(bridge, command, first);
+    if (reply === null) return "";
+    document += reply.stdout;
+    command = reply.continuation;
+    if (command !== null && !BYTE_CONTINUATION.test(command)) document += "\n";
+    first = false;
+  }
+  return document;
 }
 
 export async function commandHouseCreateHowWeWork(bridge) {