@xingular/harness 1.4.0-unstable → 1.5.0-unstable

package/dist/terminal-opentui.js

@@ -1429,7 +1429,7 @@ function isActiveStatus(status) {
 
 // src/tools/todo.ts
 var TODO_WRITE = "todo_write";
-var TODO_GUIDANCE = "If the work has several distinct steps or will take more than one tool call, call todo_write before your first other tool call with the steps you know so far, and keep the list current as steps start and finish. " + 'The list shows the person your progress; it is not the scope of the work. The request, and any document it points to, is the scope: add steps as the work shows them, list the steps of a handoff or plan instead of folding them into one "remaining work" item, and never stop because the list is short or done. ' + "Keep the list true at all times: mark a step completed only once it is done and checked, and never mark unfinished work completed. An open step is work to do in this reply, not something to report. Before you end the turn, compare the request, not the list, with what is done and checked, and do whatever is still yours to do. " + "The person follows your work from it, and a subagent\u2019s todo list shows as its progress in the person\u2019s list of subagents.";
+var TODO_GUIDANCE = "If the work has several distinct steps, call todo_write before your first other tool call with the steps you know so far, and keep the list current as steps start and finish. " + 'The list shows the person your progress; it is not the scope of the work. The request, and any document it points to, is the scope: add steps as the work shows them, and list the steps of a handoff or plan instead of folding them into one "remaining work" item. ' + "Keep the list true: mark a step completed only once it is done and checked, and never mark unfinished work completed. Before you end the turn, compare the request, not the list, with what is done and checked; if a step stays open, say why in the reply. " + "When a login blocks a step, leave it open and give the exact command the person must run in the reply. " + "The person follows your work from it, and a subagent\u2019s todo list shows as its progress in the person\u2019s list of subagents.";
 var TODO_EVENTS = new Set(["todo.updated", "checklist.updated"]);
 var MARK = { pending: "[ ]", in_progress: "[~]", completed: "[x]" };
 function describeTodo(items) {
@@ -1666,7 +1666,7 @@ function askUserTool(run) {
   return {
     name: ASK_USER,
     label: "Ask the user",
-    description: "Ask the user one to five related questions in one request and wait until they answer the batch. Give each question a concise 1\u20132 word label and aim to keep each question to 25 words or fewer. " + "Every question must offer 1\u20136 short choices, each with a helpful description of 25 words or fewer, and at least one choice must be marked recommended: true. Recommendations are visual only: they never preselect an answer, and submitted choices keep their original labels. Mark at most one recommended choice for a single-choice question, or several when multiSelect is true. Every question also includes a free-text \u201CSomething else\u201D answer. Set multiSelect when several can apply. When a UI diagram helps compare choices, set uiSketch: true and give every choice a detailed, bounded ASCII wireframe. Use ASCII tables and panel borders to show the affected element with relevant neighboring UI, readable labels and spacing. Keep each panel\u2019s outer `+` corners in fixed columns, include side edges at those same columns on every content row, and run horizontal borders corner to corner; if a title sits in a top border, leave at least two dashes on both sides. Keep framing consistent across alternatives and concentrate detail on what changes. Do not substitute a symbolic logo or one-line illustration. The preview supplies its outer border; draw internal borders only for actual UI panels. Use it when you need a decision the request and the files do not answer, not for small talk and never to ask permission for work inside the request. If no answer arrives, continue with your best judgment instead of asking again or treating the turn as blocked.",
+    description: "Ask the user one to five related questions in one request and wait until they answer the batch. Give each question a concise 1\u20132 word label and aim to keep each question to 25 words or fewer. " + "Every question must offer 1\u20136 short choices, each with a helpful description of 25 words or fewer, and at least one choice must be marked recommended: true. Recommendations are visual only: they never preselect an answer, and submitted choices keep their original labels. Mark at most one recommended choice for a single-choice question, or several when multiSelect is true. Every question also includes a free-text \u201CSomething else\u201D answer. Set multiSelect when several can apply. When a UI diagram helps compare choices, set uiSketch: true and give every choice a detailed, bounded ASCII wireframe. Use ASCII tables and panel borders to show the affected element with relevant neighboring UI, readable labels and spacing. Keep each panel\u2019s outer `+` corners in fixed columns, include side edges at those same columns on every content row, and run horizontal borders corner to corner; if a title sits in a top border, leave at least two dashes on both sides. Keep framing consistent across alternatives and concentrate detail on what changes. Do not substitute a symbolic logo or one-line illustration. The preview supplies its outer border; draw internal borders only for actual UI panels. Use it when you need a decision the request and the files do not answer, not for small talk and never to ask permission for work inside the request. If no answer arrives, continue with your best judgment instead of asking again or treating the turn as blocked. Never use it to ask for a login, a secret or a credential: give the exact command in the reply instead.",
     parameters: (Type) => Type.Object({
       questions: Type.Array(Type.Object({
         summary: Type.String({ description: "A concise label of one or two words" }),
@@ -17361,73 +17361,36 @@ import { readFileSync as readFileSync9 } from "fs";
 import { createBashTool, createEditTool, createEditToolDefinition, createPowerShellTool, createWriteTool, createWriteToolDefinition } from "@earendil-works/pi-coding-agent";
 import { Type as Type2 } from "typebox";
 
-// src/sessions/compactionCheckpoint.ts
-var COMPACTION_CHECKPOINT_EXTENSION = "compaction-checkpoint";
-function validatedTodo(value) {
-  if (!Array.isArray(value) || value.length > MAX_TODO_ITEMS)
-    return null;
-  const items = [];
-  for (const valueItem of value) {
-    const item = valueItem;
-    const parsed = todoItemSchema.safeParse({
-      text: typeof item?.text === "string" ? item.text.trim() : item?.text,
-      status: item?.status
-    });
-    if (!parsed.success)
-      return null;
-    items.push(parsed.data);
+// src/sessions/goalStop.ts
+function openItems(todo) {
+  return todo.filter((item) => item.status !== "completed");
+}
+function goalStopOutcome(todo, goal) {
+  const open = openItems(todo);
+  if (goal?.status === "blocked")
+    return { code: "needs_person", reason: goal.lastReason || "The goal is blocked.", open };
+  if (goal && (goal.status === "budget_limited" || goal.status === "usage_limited" || goal.status === "paused")) {
+    return { code: "unfinished", reason: goal.lastReason || `The goal is ${goal.status.replace("_", " ")}.`, open };
   }
-  return items;
+  return null;
 }
-function compactionCheckpoint(options = {}) {
-  return (pi) => {
-    let goal = "";
-    let todo = validatedTodo(options.initialTodo ?? []) ?? [];
-    let baseline;
-    let checkpoint;
-    const reset = (prompt = "") => {
-      goal = prompt;
-      todo = validatedTodo(options.initialTodo ?? []) ?? [];
-      baseline = undefined;
-      checkpoint = undefined;
-    };
-    pi.on("before_agent_start", (event) => {
-      if (event.messageType !== "user")
-        return;
-      reset(event.prompt);
-    });
-    pi.on("tool_result", (event) => {
-      if (event.toolName !== TODO_WRITE || event.isError)
-        return;
-      const items = validatedTodo(event.input.items);
-      if (items)
-        todo = items;
-    });
-    pi.on("context", (event) => {
-      const index = event.messages.findLastIndex((message) => message.role === "compactionSummary");
-      const summary = index >= 0 ? event.messages[index] : undefined;
-      const key = summary ? `${summary.timestamp}:${summary.tokensBefore}` : null;
-      if (!baseline) {
-        baseline = { key };
-        return;
-      }
-      if (!key || key === baseline.key)
-        return;
-      if (checkpoint?.key !== key) {
-        const content = renderCompactionCheckpoint({ goal, todo, planInstructions: options.planInstructions?.() ?? null });
-        checkpoint = {
-          key,
-          message: content ? { role: "custom", customType: COMPACTION_CHECKPOINT_EXTENSION, content, display: false, timestamp: Date.now() } : null
-        };
-      }
-      if (!checkpoint.message)
-        return;
-      return { messages: [...event.messages.slice(0, index + 1), checkpoint.message, ...event.messages.slice(index + 1)] };
-    });
-    pi.on("agent_settled", () => reset());
-    pi.on("session_tree", () => reset());
+function handoffFields(todo, goal) {
+  const next = openItems(todo)[0]?.text || "";
+  const blocked = goal?.status === "blocked" ? (goal.lastReason || "The goal is blocked.").slice(0, 500) : "";
+  return {
+    done: todo.filter((item) => item.status === "completed").slice(0, MAX_CHECKPOINT_DONE).map((item) => ({ item: item.text.slice(0, 300), evidence: [] })),
+    next: next.slice(0, 500),
+    ...blocked ? { blocked } : {}
   };
 }
+var stopCheckpointReason = (outcome) => outcome.code === "needs_person" ? "requested" : "stuck";
+function stopSummary(outcome) {
+  if (outcome.code === "needs_person")
+    return `The reply stopped for the person: ${outcome.reason}`.slice(0, 1200);
+  if (outcome.reason)
+    return `The reply ended with work left: ${outcome.reason}`.slice(0, 1200);
+  return `The reply ended with ${outcome.open.length} open todo item${outcome.open.length === 1 ? "" : "s"}.`;
+}
 
 // src/sessions/completionCheck.ts
 var MAX_CHECK_TRANSCRIPT = 24000;
@@ -17555,121 +17518,6 @@ async function runCompletionCheck(ask, input, options = {}) {
 function answerText(message) {
   return textOf(message?.content);
 }
-function launchSwitchOff(name) {
-  const value = process.env[name]?.trim().toLowerCase();
-  return value === "off" || value === "0" || value === "false";
-}
-
-// src/sessions/stopGate.ts
-var STOP_GATE_EXTENSION = "stop-gate";
-var STOP_GATE_CUSTOM_TYPE = "xingular-stop-gate";
-var MAX_STOP_GATE_NUDGES = 3;
-var BOOKKEEPING_TOOLS = new Set([TODO_WRITE, "session_name"]);
-function createStopGateState(initialTodo = []) {
-  return { todo: validatedTodo(initialTodo) ?? [], request: "", nudges: 0, callsSinceNudge: 0, callsInReply: 0 };
-}
-function resetStopGateState(state, initialTodo = [], request = "") {
-  state.todo = validatedTodo(initialTodo) ?? [];
-  state.request = request;
-  state.nudges = 0;
-  state.callsSinceNudge = 0;
-  state.callsInReply = 0;
-}
-function openItems(todo) {
-  return todo.filter((item) => item.status !== "completed");
-}
-function stopOutcome(state, goal) {
-  const open = openItems(state.todo);
-  if (goal?.status === "blocked")
-    return { code: "needs_person", reason: goal.lastReason || "The goal is blocked.", open };
-  if (goal && (goal.status === "budget_limited" || goal.status === "usage_limited" || goal.status === "paused")) {
-    return { code: "unfinished", reason: goal.lastReason || `The goal is ${goal.status.replace("_", " ")}.`, open };
-  }
-  if (open.length)
-    return { code: "unfinished", reason: "", open };
-  return null;
-}
-function handoffFields(state, goal) {
-  const todo = state?.todo ?? [];
-  const next = openItems(todo)[0]?.text || "";
-  const blocked = goal?.status === "blocked" ? (goal.lastReason || "The goal is blocked.").slice(0, 500) : "";
-  return {
-    done: todo.filter((item) => item.status === "completed").slice(0, MAX_CHECKPOINT_DONE).map((item) => ({ item: item.text.slice(0, 300), evidence: [] })),
-    next: next.slice(0, 500),
-    ...blocked ? { blocked } : {}
-  };
-}
-var stopCheckpointReason = (outcome) => outcome.code === "needs_person" ? "requested" : "stuck";
-function stopSummary(outcome) {
-  if (outcome.code === "needs_person")
-    return `The reply stopped for the person: ${outcome.reason}`.slice(0, 1200);
-  if (outcome.reason)
-    return `The reply ended with work left: ${outcome.reason}`.slice(0, 1200);
-  return `The reply ended with ${outcome.open.length} open todo item${outcome.open.length === 1 ? "" : "s"}.`;
-}
-function nudgeText(count, max, open) {
-  const list = open.slice(0, 12).map((item) => `- ${item.text}`).join(`
-`);
-  const more = open.length > 12 ? `
-- \u2026and ${open.length - 12} more` : "";
-  return [
-    `Harness stop gate (${count}/${max}): your reply ended with ${open.length} open todo item${open.length === 1 ? "" : "s"}:`,
-    `${list}${more}`,
-    "Continue with the next open item now. Mark an item completed only after it is done and checked.",
-    "The list shows progress; it is not the limit of the work. If the request needs more than the list says, add it and do it.",
-    "Decisions inside the request are yours. Stop only for something only the person can do (a deploy, a secret, remote data, money, missing access), and then say exactly what it is."
-  ].join(`
-`);
-}
-function stopGateNotice(event) {
-  return `Stop gate ${event.count}: the reply ended with ${event.open.length} open todo item${event.open.length === 1 ? "" : "s"}; continuing.`;
-}
-function stopGate(options) {
-  const { state } = options;
-  const max = options.max ?? MAX_STOP_GATE_NUDGES;
-  return (pi) => {
-    pi.on("before_agent_start", (event) => {
-      if (event.messageType !== undefined && event.messageType !== "user")
-        return;
-      resetStopGateState(state, options.initialTodo, options.request?.() || (typeof event.prompt === "string" ? event.prompt : ""));
-    });
-    pi.on("tool_call", (event) => {
-      if (BOOKKEEPING_TOOLS.has(event.toolName))
-        return;
-      state.callsSinceNudge += 1;
-      state.callsInReply += 1;
-    });
-    pi.on("tool_result", (event) => {
-      if (event.toolName !== TODO_WRITE || event.isError)
-        return;
-      const items = validatedTodo(event.input?.items);
-      if (items)
-        state.todo = items;
-    });
-    pi.on("agent_before_settle", (event, ctx) => {
-      if (event.outcome !== "completed" || event.continue || ctx?.signal?.aborted)
-        return;
-      if (options.active && !options.active())
-        return;
-      if (options.sliceEnded?.() || options.failed?.())
-        return;
-      if (state.nudges >= max)
-        return;
-      if (state.nudges > 0 && state.callsSinceNudge === 0)
-        return;
-      const open = openItems(state.todo);
-      if (!open.length)
-        return;
-      state.nudges += 1;
-      state.callsSinceNudge = 0;
-      options.onEvent?.({ kind: "todo", count: state.nudges, open });
-      return {
-        entries: [...event.entries, { type: "custom_message", customType: STOP_GATE_CUSTOM_TYPE, content: nudgeText(state.nudges, max, open), display: true }],
-        continue: true
-      };
-    });
-  };
-}
 function sessionCheckModel(ctx) {
   const session = ctx ?? {};
   const model = session.model;
@@ -17686,6 +17534,10 @@ function sessionCheckModel(ctx) {
     return { text: answerText(message), message };
   };
 }
+function launchSwitchOff(name) {
+  const value = process.env[name]?.trim().toLowerCase();
+  return value === "off" || value === "0" || value === "false";
+}
 
 // src/sessions/goalLoop.ts
 var GOAL_EXTENSION = "goal";
@@ -17813,6 +17665,7 @@ function goalNotice(event) {
 }
 
 // src/sessions/workSlice.ts
+var WORK_SLICE_EXTENSION = "work-slice";
 var DEFAULT_SLICE_POLICY = {
   enabled: true,
   maxToolCalls: 320,
@@ -18056,6 +17909,74 @@ async function withCommandBudget(run, abort, seconds) {
   }
 }
 
+// src/sessions/compactionCheckpoint.ts
+var COMPACTION_CHECKPOINT_EXTENSION = "compaction-checkpoint";
+function validatedTodo(value) {
+  if (!Array.isArray(value) || value.length > MAX_TODO_ITEMS)
+    return null;
+  const items = [];
+  for (const valueItem of value) {
+    const item = valueItem;
+    const parsed = todoItemSchema.safeParse({
+      text: typeof item?.text === "string" ? item.text.trim() : item?.text,
+      status: item?.status
+    });
+    if (!parsed.success)
+      return null;
+    items.push(parsed.data);
+  }
+  return items;
+}
+function compactionCheckpoint(options = {}) {
+  return (pi) => {
+    let goal = "";
+    let todo = validatedTodo(options.initialTodo ?? []) ?? [];
+    let baseline;
+    let checkpoint;
+    const reset = (prompt = "") => {
+      goal = prompt;
+      todo = validatedTodo(options.initialTodo ?? []) ?? [];
+      baseline = undefined;
+      checkpoint = undefined;
+    };
+    pi.on("before_agent_start", (event) => {
+      if (event.messageType !== "user")
+        return;
+      reset(event.prompt);
+    });
+    pi.on("tool_result", (event) => {
+      if (event.toolName !== TODO_WRITE || event.isError)
+        return;
+      const items = validatedTodo(event.input.items);
+      if (items)
+        todo = items;
+    });
+    pi.on("context", (event) => {
+      const index = event.messages.findLastIndex((message) => message.role === "compactionSummary");
+      const summary = index >= 0 ? event.messages[index] : undefined;
+      const key = summary ? `${summary.timestamp}:${summary.tokensBefore}` : null;
+      if (!baseline) {
+        baseline = { key };
+        return;
+      }
+      if (!key || key === baseline.key)
+        return;
+      if (checkpoint?.key !== key) {
+        const content = renderCompactionCheckpoint({ goal, todo, planInstructions: options.planInstructions?.() ?? null });
+        checkpoint = {
+          key,
+          message: content ? { role: "custom", customType: COMPACTION_CHECKPOINT_EXTENSION, content, display: false, timestamp: Date.now() } : null
+        };
+      }
+      if (!checkpoint.message)
+        return;
+      return { messages: [...event.messages.slice(0, index + 1), checkpoint.message, ...event.messages.slice(index + 1)] };
+    });
+    pi.on("agent_settled", () => reset());
+    pi.on("session_tree", () => reset());
+  };
+}
+
 // src/world/images.ts
 var KEEP_IMAGES = 6;
 var PRUNE_STEP = 4;
@@ -19025,7 +18946,6 @@ async function piExtension_default(pi, planRun, getSession, goal) {
     console.error(`${error instanceof Error ? error.message : String(error)} Using the default work slices.`);
   }
   const sliceState = createSliceState(slicePolicy);
-  const gateState = createStopGateState();
   const recordCheckUsage = (raw) => {
     const message = raw;
     const reported = message.usage;
@@ -19305,18 +19225,6 @@ async function piExtension_default(pi, planRun, getSession, goal) {
       continue: true
     };
   });
-  if (!launchSwitchOff("XINGULAR_STOP_GATE"))
-    stopGate({
-      state: gateState,
-      active: () => !planRun?.active,
-      sliceEnded: () => sliceState.endedBy !== null,
-      failed: () => Boolean(failure),
-      onEvent: (event) => {
-        terminalCall("notice", { kind: "notify", level: "info", extension: STOP_GATE_EXTENSION, text: stopGateNotice(event) }).catch(() => {
-          return;
-        });
-      }
-    })(pi);
   if (goal) {
     for (const spec of goalTools(() => goal))
       pi.registerTool({
@@ -19375,13 +19283,13 @@ async function piExtension_default(pi, planRun, getSession, goal) {
       failed: () => Boolean(failure),
       blocked: () => goal?.get()?.status === "blocked",
       goalActive: () => goal?.active() === true,
-      todo: () => gateState.todo,
-      next: () => handoffFields(gateState, goal?.get() ?? null).next,
+      todo: () => lastTodo,
+      next: () => handoffFields(lastTodo, goal?.get() ?? null).next,
       onContinue: (ended) => {
-        terminalCall("checkpoint", { summary: `Work slice ${ended.slice} reached its limit after ${ended.steps} steps; the reply continues.`, ...handoffFields(gateState, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: ended.slice, reason: "budget" }).catch(() => {
+        terminalCall("checkpoint", { summary: `Work slice ${ended.slice} reached its limit after ${ended.steps} steps; the reply continues.`, ...handoffFields(lastTodo, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: ended.slice, reason: "budget" }).catch(() => {
           return;
         });
-        terminalCall("notice", { kind: "notify", level: "info", extension: STOP_GATE_EXTENSION, text: `Work slice ${ended.slice} reached ${ended.limit ?? "its limit"}; continuing with slice ${ended.slice + 1} of up to ${slicePolicy.maxSlices}.` }).catch(() => {
+        terminalCall("notice", { kind: "notify", level: "info", extension: WORK_SLICE_EXTENSION, text: `Work slice ${ended.slice} reached ${ended.limit ?? "its limit"}; continuing with slice ${ended.slice + 1} of up to ${slicePolicy.maxSlices}.` }).catch(() => {
           return;
         });
       }
@@ -19585,13 +19493,13 @@ async function piExtension_default(pi, planRun, getSession, goal) {
     }
     subagentParent = false;
     const aborted = event.aborted || messageAborted;
-    const stop = !sliceState.endedBy && !failure && !aborted && !planRun?.active ? stopOutcome(gateState, goal?.get() ?? null) : null;
+    const stop = !sliceState.endedBy && !failure && !aborted && !planRun?.active ? goalStopOutcome(lastTodo, goal?.get() ?? null) : null;
     if (stop) {
-      await terminalCall("checkpoint", { summary: stopSummary(stop), ...handoffFields(gateState, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: sliceState.slice, reason: stopCheckpointReason(stop) }).catch(() => {
+      await terminalCall("checkpoint", { summary: stopSummary(stop), ...handoffFields(lastTodo, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: sliceState.slice, reason: stopCheckpointReason(stop) }).catch(() => {
         return;
       });
     } else if (sliceState.endedBy && !failure && !aborted) {
-      await terminalCall("checkpoint", { summary: `The reply stopped after ${sliceState.steps} steps at its work-slice boundary.`, ...handoffFields(gateState, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: sliceState.slice, reason: sliceState.endedBy }).catch(() => {
+      await terminalCall("checkpoint", { summary: `The reply stopped after ${sliceState.steps} steps at its work-slice boundary.`, ...handoffFields(lastTodo, goal?.get() ?? null), files: [], checks: [], decisions: [], slice: sliceState.slice, reason: sliceState.endedBy }).catch(() => {
         return;
       });
     }