@runtypelabs/cli 1.8.2 → 1.8.3

package/README.md

@@ -62,6 +62,14 @@ runtype marathon agent_abc123 --goal "Write integration tests for the API" \
 # Override the agent's configured model
 runtype marathon "Code Builder" --goal "Build a calculator" --model claude-sonnet-4-5
 
+# Enable built-in tools for the task (web search, scraping, image generation, etc.)
+runtype marathon "Code Builder" --goal "Search the web and summarize" --tools exa
+runtype marathon "Code Builder" -g "Find docs and scrape them" --tools exa firecrawl
+
+# Combine tools with other options
+runtype marathon "Code Builder" --goal "Research and generate images" \
+  --tools exa dalle --max-sessions 5
+
 # Enable sandboxed code execution tooling for the task (QuickJS or Daytona)
 runtype marathon "Code Builder" --goal "Compute totals from this dataset" --sandbox quickjs
 runtype marathon "Code Builder" -g "Generate a script and run it" --sandbox daytona
@@ -124,6 +132,42 @@ runtype marathon "Code Builder" --goal "Fix the bug" \
 runtype marathon "Code Builder" --goal "Fix the bug" --tool-context full-inline
 ```
 
+#### Built-in Tools
+
+The `--tools` (or `-t`) flag enables built-in platform tools during agent execution. Tools are validated at startup against the built-in tools registry, and compatibility is checked against all models used in the task (including planning and execution phase models).
+
+```bash
+# Enable a single tool
+runtype marathon "Code Builder" --goal "Search the web" --tools exa
+
+# Enable multiple tools (space-separated)
+runtype marathon "Code Builder" --goal "Research and generate" --tools exa firecrawl dalle
+
+# Short flag
+runtype marathon "Code Builder" -g "Scrape docs" -t firecrawl
+```
+
+**Available tools:**
+
+| Tool ID          | Description                                 |
+| ---------------- | ------------------------------------------- |
+| `exa`            | Semantic web search                         |
+| `firecrawl`      | Web scraping and content extraction         |
+| `dalle`          | DALL-E image generation                     |
+| `elevenlabs-tts` | Text-to-speech via ElevenLabs               |
+| `elevenlabs-stt` | Speech-to-text transcription via ElevenLabs |
+
+**Not available via CLI:**
+
+- `openai_web_search`, `anthropic_web_search`, `anthropic_web_fetch` — provider-native tools handled automatically by compatible models
+- `vector-search` — requires additional configuration (use the dashboard instead)
+
+**Validation behavior:**
+
+- Unknown tool IDs produce an error listing all available tools
+- Tools incompatible with the selected model(s) are rejected with a specific error
+- All validation errors are reported together so you can fix them in one pass
+
 ## Configuration
 
 ```bash

package/dist/index.js

@@ -8785,6 +8785,7 @@ var BORDER_H = "\u2500";
 var CORNERS = { tl: "\u250C", tr: "\u2510", bl: "\u2514", br: "\u2518" };
 var BORDER_V = "\u2502";
 var TICK_MS = 100;
+var DIR_RIGHT_ZWJ = "\u200D\u27A1\uFE0F";
 function useRunnerTrack({
   width,
   isAnimating,
@@ -8794,13 +8795,18 @@ function useRunnerTrack({
   showFinish = true,
   initialPosition = 0,
   initialLaps = 0,
-  onPositionChange
+  onPositionChange,
+  contentRows = 0
 }) {
   const innerWidth = Math.max(4, width - 2);
-  const perimeter = innerWidth * 2;
-  const [position, setPosition] = useState11(
-    () => Math.min(initialPosition, perimeter - 1)
-  );
+  const trackWidth = innerWidth - 1;
+  const cR = Math.max(0, contentRows);
+  const perimeter = trackWidth * 2 + cR * 2;
+  const finishPosition = Math.floor(innerWidth / 2);
+  const [position, setPosition] = useState11(() => {
+    const startPos = initialPosition === 0 && initialLaps === 0 ? finishPosition : initialPosition;
+    return Math.min(startPos, perimeter - 1);
+  });
   const [laps, setLaps] = useState11(initialLaps);
   const [elapsed, setElapsed] = useState11(0);
   const startTimeRef = useRef4(Date.now());
@@ -8834,15 +8840,21 @@ function useRunnerTrack({
     }, TICK_MS);
     return () => clearInterval(interval);
   }, [isAnimating, perimeter, laps]);
-  const finishPosition = Math.floor(innerWidth / 2);
-  const getRowCol = useCallback3(
+  const getPosition = useCallback3(
     (pos) => {
-      if (pos < innerWidth) {
-        return { row: "top", col: pos };
+      if (pos < trackWidth) {
+        return { segment: "top", col: pos };
       }
-      return { row: "bottom", col: innerWidth - 1 - (pos - innerWidth) };
+      if (cR > 0 && pos < trackWidth + cR) {
+        return { segment: "right", row: pos - trackWidth };
+      }
+      const bottomStart = trackWidth + cR;
+      if (pos < bottomStart + trackWidth) {
+        return { segment: "bottom", col: trackWidth - 1 - (pos - bottomStart) };
+      }
+      return { segment: "left", row: cR - 1 - (pos - bottomStart - trackWidth) };
     },
-    [innerWidth]
+    [trackWidth, cR]
   );
   const topCells = Array(innerWidth).fill(BORDER_H);
   const bottomCells = Array(innerWidth).fill(BORDER_H);
@@ -8852,23 +8864,43 @@ function useRunnerTrack({
       topCells[finishPosition + 1] = "";
     }
   }
+  const leftBorderMap = /* @__PURE__ */ new Map();
+  const rightBorderMap = /* @__PURE__ */ new Map();
+  const runnerPosObj = getPosition(position);
+  const facingRight = runnerPosObj.segment === "top" || runnerPosObj.segment === "left";
+  const directionalRunner = facingRight ? runnerChar + DIR_RIGHT_ZWJ : runnerChar;
   if (showRunner) {
     for (let i = 0; i < TRAIL_CHARS.length; i++) {
       const trailPos = (position - 1 - i + perimeter) % perimeter;
-      const { row, col } = getRowCol(trailPos);
-      if (showFinish && row === "top" && col === finishPosition) continue;
-      const cells = row === "top" ? topCells : bottomCells;
-      cells[col] = TRAIL_CHARS[i];
+      const tPos = getPosition(trailPos);
+      if (tPos.segment === "top") {
+        if (showFinish && (tPos.col === finishPosition || tPos.col === finishPosition + 1))
+          continue;
+        topCells[tPos.col] = TRAIL_CHARS[i];
+      } else if (tPos.segment === "bottom") {
+        bottomCells[tPos.col] = TRAIL_CHARS[i];
+      } else if (tPos.segment === "right") {
+        rightBorderMap.set(tPos.row, TRAIL_CHARS[i]);
+      } else {
+        leftBorderMap.set(tPos.row, TRAIL_CHARS[i]);
+      }
     }
   }
-  const runnerPos = getRowCol(position);
   if (showRunner) {
-    const runnerCells = runnerPos.row === "top" ? topCells : bottomCells;
-    if (!(showFinish && runnerPos.row === "top" && runnerPos.col === finishPosition)) {
-      runnerCells[runnerPos.col] = runnerChar;
-      if (runnerPos.col + 1 < innerWidth) {
-        runnerCells[runnerPos.col + 1] = "";
+    if (runnerPosObj.segment === "top") {
+      const hitsFinish = showFinish && (runnerPosObj.col === finishPosition || runnerPosObj.col === finishPosition + 1);
+      if (!hitsFinish) {
+        topCells[runnerPosObj.col] = directionalRunner;
+        if (runnerPosObj.col + 1 < innerWidth) {
+          topCells[runnerPosObj.col + 1] = "";
+        }
+      }
+    } else if (runnerPosObj.segment === "bottom") {
+      bottomCells[runnerPosObj.col] = directionalRunner;
+      if (runnerPosObj.col + 1 < innerWidth) {
+        bottomCells[runnerPosObj.col + 1] = "";
       }
+    } else {
     }
   }
   const minutes = Math.floor(elapsed / 60);
@@ -8877,7 +8909,8 @@ function useRunnerTrack({
   const lapStart = Math.max(0, Math.floor((innerWidth - lapText.length) / 2));
   for (let i = 0; i < lapText.length && lapStart + i < innerWidth; i++) {
     const col = lapStart + i;
-    if (runnerPos.row === "bottom" && (col === runnerPos.col || col === runnerPos.col + 1)) continue;
+    if (runnerPosObj.segment === "bottom" && (col === runnerPosObj.col || col === runnerPosObj.col + 1))
+      continue;
     bottomCells[col] = lapText[i];
   }
   const buildRowSegments = (cells, cornerLeft, cornerRight) => {
@@ -8888,7 +8921,7 @@ function useRunnerTrack({
     for (const cell of cells) {
       if (cell === "") continue;
       let cellColor;
-      if (cell === runnerChar || cell === finishChar) {
+      if (cell === runnerChar || cell === directionalRunner || cell === finishChar) {
         cellColor = void 0;
       } else if (TRAIL_CHARS.includes(cell)) {
         cellColor = theme8.accent;
@@ -8909,7 +8942,15 @@ function useRunnerTrack({
   };
   const topSegments = buildRowSegments(topCells, CORNERS.tl, CORNERS.tr);
   const bottomSegments = buildRowSegments(bottomCells, CORNERS.bl, CORNERS.br);
-  const borderSegments = (content, contentVisualWidth) => {
+  const borderSegments = (content, contentVisualWidth, rowIndex) => {
+    const leftDecor = rowIndex !== void 0 ? leftBorderMap.get(rowIndex) : void 0;
+    const rightDecor = rowIndex !== void 0 ? rightBorderMap.get(rowIndex) : void 0;
+    const leftChar = leftDecor ?? BORDER_V;
+    const rightChar = rightDecor ?? BORDER_V;
+    const borderCharColor = (char) => {
+      if (TRAIL_CHARS.includes(char)) return theme8.accent;
+      return theme8.border;
+    };
     let truncated = content;
     if (contentVisualWidth > innerWidth) {
       truncated = [];
@@ -8928,10 +8969,10 @@ function useRunnerTrack({
     const truncatedWidth = truncated.reduce((sum, s) => sum + s.text.length, 0);
     const rightPad = Math.max(0, innerWidth - truncatedWidth);
     return [
-      { text: BORDER_V, color: theme8.border },
+      { text: leftChar, color: borderCharColor(leftChar) },
       ...truncated,
       ...rightPad > 0 ? [{ text: " ".repeat(rightPad) }] : [],
-      { text: BORDER_V, color: theme8.border }
+      { text: rightChar, color: borderCharColor(rightChar) }
     ];
   };
   return { topSegments, bottomSegments, innerWidth, borderSegments };
@@ -8965,6 +9006,9 @@ function SessionHeader({
   const showName = sessionName && sessionName !== `Marathon #${sessionCount}`;
   const separator = theme9.separator ?? " \xB7 ";
   const resolvedWidth = trackWidth ?? 40;
+  let contentRowCount = 1;
+  if (previewUrl) contentRowCount++;
+  if (goal) contentRowCount++;
   const { topSegments, bottomSegments, innerWidth, borderSegments } = useRunnerTrack({
     width: resolvedWidth,
     isAnimating,
@@ -8974,7 +9018,8 @@ function SessionHeader({
     showFinish,
     initialPosition: runnerPosition,
     initialLaps: runnerLaps,
-    onPositionChange: onRunnerPositionChange
+    onPositionChange: onRunnerPositionChange,
+    contentRows: contentRowCount
   });
   const titleText = `Marathon #${sessionCount}`;
   const nameText = showName ? ` (${sessionName})` : "";
@@ -8988,15 +9033,17 @@ function SessionHeader({
     { text: modelText, color: theme9.textMuted },
     { text: costText, color: theme9.warning }
   ];
+  let rowIdx = 0;
   const rows = [
     topSegments,
-    borderSegments(infoSegments, infoVisualWidth)
+    borderSegments(infoSegments, infoVisualWidth, rowIdx++)
   ];
   if (previewUrl) {
     const previewText = ` Preview: ${previewUrl}`;
     rows.push(borderSegments(
       [{ text: previewText, color: theme9.accent }],
-      previewText.length
+      previewText.length,
+      rowIdx++
     ));
   }
   if (goal) {
@@ -9005,11 +9052,12 @@ function SessionHeader({
     const goalText = ` ${displayGoal}`;
     rows.push(borderSegments(
       [{ text: goalText, color: theme9.textMuted }],
-      goalText.length
+      goalText.length,
+      rowIdx++
     ));
   }
   rows.push(bottomSegments);
-  return /* @__PURE__ */ jsx8(Box7, { marginBottom: 1, children: /* @__PURE__ */ jsx8(Text8, { children: rows.map((row, rowIdx) => rowIdx === 0 ? renderSegments(row) : ["\n", ...renderSegments(row)]) }) });
+  return /* @__PURE__ */ jsx8(Box7, { marginBottom: 1, children: /* @__PURE__ */ jsx8(Text8, { children: rows.map((row, rowIdx2) => rowIdx2 === 0 ? renderSegments(row) : ["\n", ...renderSegments(row)]) }) });
 }
 
 // src/ink/marathon/SessionTabs.tsx