stitchkit 0.119.0 → 0.120.0

package/dist/{index-s0qjs6ee.js → index-pq2m7t46.js}

@@ -25,25 +25,25 @@ import {
 } from "./index-ycqhyars.js";
 import {
   writeContainedFile
-} from "./index-q968hy6y.js";
+} from "./index-e452syyh.js";
 import {
   openPinnedDirectory,
   isSafeEntryName,
   containedEntryMetadata
-} from "./index-arjmb6de.js";
+} from "./index-1jwsfkfz.js";
+import {
+  pollUntil
+} from "./index-bph35vpy.js";
 import {
   collectToolSurface
 } from "./index-ff39f9dr.js";
 import {
   fetchGuarded,
   readCapped
-} from "./index-mgb7r8b8.js";
+} from "./index-jswst0h3.js";
 import {
   errnoOf
 } from "./index-jj9228tt.js";
-import {
-  sleep
-} from "./index-eemvahkc.js";
 import {
   isUnsafeKey,
   safeJsonParse
@@ -59,78 +59,6 @@ import {
   isRecord
 } from "./index-9jfdm5tg.js";
 
-// src/tools/operations/wait-core.ts
-var DEFAULT_BACKOFF = [2, 3, 5, 5, 8, 10];
-var DEFAULT_TIMEOUT = 600;
-
-class WaitTimeoutError extends Error {
-  constructor() {
-    super("wait deadline elapsed before the first snapshot");
-    this.name = "WaitTimeoutError";
-  }
-}
-async function pollUntil(params) {
-  const backoff = params.backoff?.length ? params.backoff : DEFAULT_BACKOFF;
-  const lastBackoff = backoff[backoff.length - 1] ?? 5;
-  const timeoutSec = params.timeoutSec ?? DEFAULT_TIMEOUT;
-  const pause = params.sleepFn ?? sleep;
-  const now = params.nowFn ?? (() => performance.now());
-  const startedAt = now();
-  const deadline = startedAt + timeoutSec * 1000;
-  let last;
-  for (let attempt = 0;; attempt++) {
-    params.signal?.throwIfAborted();
-    const remainingBeforePoll = Math.max(0, deadline - now());
-    if (remainingBeforePoll === 0 && last) {
-      return { state: last.state, timedOut: true };
-    }
-    const deadlineController = new AbortController;
-    const onCallerAbort = () => deadlineController.abort(params.signal?.reason);
-    params.signal?.addEventListener("abort", onCallerAbort, { once: true });
-    const deadlineTimer = setTimeout(() => deadlineController.abort(new WaitTimeoutError), remainingBeforePoll);
-    deadlineTimer.unref?.();
-    let state;
-    try {
-      state = await params.poll(deadlineController.signal);
-    } catch (error) {
-      if (params.signal?.aborted)
-        throw params.signal.reason ?? error;
-      if (deadlineController.signal.aborted && now() >= deadline) {
-        if (last)
-          return { state: last.state, timedOut: true };
-        throw new WaitTimeoutError;
-      }
-      throw error;
-    } finally {
-      clearTimeout(deadlineTimer);
-      params.signal?.removeEventListener("abort", onCallerAbort);
-    }
-    params.signal?.throwIfAborted();
-    last = { state };
-    if (params.done(state))
-      return { state, timedOut: false };
-    const elapsedMs = now() - startedAt;
-    const elapsedSec = elapsedMs / 1000;
-    params.onTick?.(attempt + 1, elapsedSec);
-    if (elapsedSec >= timeoutSec)
-      return { state, timedOut: true };
-    const waitSec = backoff[Math.min(attempt, backoff.length - 1)] ?? lastBackoff;
-    await pause(Math.min(waitSec * 1000, Math.max(0, deadline - now())), params.signal);
-  }
-}
-function runWaitOperation(params) {
-  return pollUntil({
-    poll: (signal) => params.poll(params.input, signal),
-    done: params.done,
-    backoff: params.backoff,
-    timeoutSec: params.timeoutSec,
-    sleepFn: params.sleepFn,
-    onTick: params.onTick,
-    signal: params.signal,
-    nowFn: params.nowFn
-  });
-}
-
 // src/tools/cli/command.ts
 function defineCliCommand2(definition) {
   return definition;
@@ -2151,7 +2079,7 @@ function renderCliView2(data, view) {
 }
 
 // src/tools/cli/wait.ts
-var DEFAULT_TIMEOUT2 = 600;
+var DEFAULT_TIMEOUT = 600;
 function waitFailure(tool, result) {
   return {
     ok: false,
@@ -2173,7 +2101,7 @@ async function pollUntilDone2(params) {
   const pollArgs = wait.poll(initial.data);
   if (!pollArgs)
     return initial;
-  const timeoutSec = params.timeoutSec ?? wait.timeout ?? DEFAULT_TIMEOUT2;
+  const timeoutSec = params.timeoutSec ?? wait.timeout ?? DEFAULT_TIMEOUT;
   let failedState;
   const { state, timedOut } = await pollUntil({
     poll: () => call(wait.tool, pollArgs),
@@ -2455,4 +2383,4 @@ async function createCli2(config) {
   return runManagedInvocation(session, route);
 }
 
-export { WaitTimeoutError, runWaitOperation, defineCliCommand2, DEFAULT_EXIT_CODES2, cliExitCode2, emitResult2, CliArgumentError2, cliInvocationResult2, createCliInvoker2, routeCliArgv2, parseCliArgs2, extractCliGlobalOptions2, renderCliView2, pollUntilDone2, createCli2 };
+export { defineCliCommand2, DEFAULT_EXIT_CODES2, cliExitCode2, emitResult2, CliArgumentError2, cliInvocationResult2, createCliInvoker2, routeCliArgv2, parseCliArgs2, extractCliGlobalOptions2, renderCliView2, pollUntilDone2, createCli2 };

package/dist/{index-yk4g8805.js → index-pq7rkwkk.js}

@@ -101,33 +101,4 @@ function setCorsHeader(headers, key, value) {
     headers.set("Vary", `${existing}, ${value}`);
 }
 
-// src/server/process-signal-common.ts
-var DEFAULT_PROCESS_SIGNALS = ["SIGINT", "SIGTERM"];
-var defaultSignalSource = {
-  on: (signal, handler) => {
-    process.on(signal, handler);
-  },
-  off: (signal, handler) => {
-    process.off(signal, handler);
-  },
-  raiseDefault: (signal) => {
-    if (process.listenerCount(signal) > 0)
-      return false;
-    process.kill(process.pid, signal);
-    return true;
-  }
-};
-function reportSignalError(phase, error, onError) {
-  try {
-    onError?.(phase, error);
-  } catch {}
-}
-function guardSignalCallback(run, phase, onError) {
-  try {
-    run();
-  } catch (error) {
-    reportSignalError(phase, error, onError);
-  }
-}
-
-export { DEFAULT_CORS_ALLOW_HEADERS2, DEFAULT_CORS_EXPOSE_HEADERS2, assertCorsConfig, isOriginAllowed, corsHeaders2, corsPreflightResponse2, requestCorsHeaders, applyCors, DEFAULT_PROCESS_SIGNALS, defaultSignalSource, reportSignalError, guardSignalCallback };
+export { DEFAULT_CORS_ALLOW_HEADERS2, DEFAULT_CORS_EXPOSE_HEADERS2, assertCorsConfig, isOriginAllowed, corsHeaders2, corsPreflightResponse2, requestCorsHeaders, applyCors };

package/dist/{index-x8d9fdeg.js → index-qctbzmg9.js}

@@ -19,10 +19,8 @@ import {
   agentDurableEventId2
 } from "./index-mnkk1ffz.js";
 import {
-  createLocalStepDurability2,
-  isAgentToolError2,
-  createToolDurabilityContext
-} from "./index-tvtacc9a.js";
+  createLocalStepDurability2
+} from "./index-zyc64nbh.js";
 import {
   canonicalAgentJson2,
   createToolChronology,
@@ -39,9 +37,15 @@ import {
 import {
   messageOf
 } from "./index-g149e9pk.js";
+import {
+  createToolDurabilityContext
+} from "./index-sb9dr3tq.js";
 import {
   createMutationQueue
 } from "./index-sykb5ag7.js";
+import {
+  isAgentToolError2
+} from "./index-1psbyyhj.js";
 import {
   assertPositiveSafeInteger
 } from "./index-0s4xebbg.js";

package/dist/{index-g444vfz2.js → index-r3db01kh.js}

@@ -1,6 +1,6 @@
 import {
   attemptExclusiveLock
-} from "./index-ynrf908v.js";
+} from "./index-bz479f0x.js";
 import {
   sleep
 } from "./index-eemvahkc.js";

package/dist/index-sb9dr3tq.js

@@ -0,0 +1,14 @@
+// src/tools/durability-context.ts
+var contexts = new WeakMap;
+function createToolDurabilityContext(factory) {
+  const context = {};
+  contexts.set(context, factory);
+  return context;
+}
+function resolveToolDurability(context, callId, signal) {
+  if (typeof context !== "object" || context === null)
+    return;
+  return contexts.get(context)?.(callId, signal);
+}
+
+export { createToolDurabilityContext, resolveToolDurability };

package/dist/{index-rxcgp4b9.js → index-yb9n4pgj.js}

@@ -4,7 +4,7 @@ import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
   AGENT_CODING_TOOL_NAMES
-} from "./index-1k18qzqa.js";
+} from "./index-0qyrcjfs.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,

package/dist/{index-tvtacc9a.js → index-zyc64nbh.js}

@@ -543,37 +543,4 @@ function createLocalStepDurability2(options) {
   };
 }
 
-// src/tools/agent-tool-error.ts
-var AGENT_TOOL_ERROR_BRAND = Symbol.for("stitchkit.AgentToolError");
-
-class AgentToolError2 extends Error {
-  output;
-  constructor(output, cause) {
-    let message = "Tool execution failed";
-    try {
-      message = JSON.stringify(output);
-    } catch {}
-    super(message, cause === undefined ? undefined : { cause });
-    this.name = "AgentToolError";
-    this.output = output;
-    Object.defineProperty(this, AGENT_TOOL_ERROR_BRAND, { value: true });
-  }
-}
-function isAgentToolError2(value) {
-  return typeof value === "object" && value !== null && AGENT_TOOL_ERROR_BRAND in value;
-}
-
-// src/tools/durability-context.ts
-var contexts = new WeakMap;
-function createToolDurabilityContext(factory) {
-  const context = {};
-  contexts.set(context, factory);
-  return context;
-}
-function resolveToolDurability(context, callId, signal) {
-  if (typeof context !== "object" || context === null)
-    return;
-  return contexts.get(context)?.(callId, signal);
-}
-
-export { createLocalStepDurability2, AgentToolError2, isAgentToolError2, createToolDurabilityContext, resolveToolDurability };
+export { createLocalStepDurability2 };

package/llms/agent-runtime-harness.txt

@@ -27,7 +27,8 @@ import {
   createAgentHarnessFileResources,
   createHeadlessAgentHarness,
 } from 'stitchkit/agent-runtime/harness';
-import { composeToolLifecycle, mountAgent } from 'stitchkit/tools';
+import { composeToolLifecycle } from 'stitchkit/tools';
+import { mountAgent } from 'stitchkit/tools/agent';
 
 const resources = createAgentHarnessFileResources({
   roots: [{ id: 'guide', kind: 'instruction', path: instructionRoot }],
@@ -51,8 +52,8 @@ compose your authorization with the run's `toolFenceLifecycle` by `composeToolLi
 fence rejects a call from a run that no longer owns the conversation, and it must run exactly
 once. Every mount option remains available, including registry, runtime tools, extension,
 coercion, output stripping, hooks and durability, and the callback may be async. The same callback
-still accepts arbitrary typed AI SDK tools and prepareStep. `stitchkit/tools` needs the same `ai` and
-`@modelcontextprotocol/server` peers as any `mountAgent` use; the base harness stays AI-only.
+still accepts arbitrary typed AI SDK tools and prepareStep. `mountAgent` comes from `stitchkit/tools/agent`, which needs only the `ai` peer the
+harness already has; the base harness stays AI-only.
 The resource reader is explicitly selected: filtered allowlists do not gain tools merely
 because a loader exists. Root IDs, kinds, provenance and limits are unchanged.
 

package/llms/agent-runtime-sandbox.txt

@@ -57,7 +57,7 @@ Storage is process-durable, without a power-loss/fsync guarantee.
 
 ```ts
 import { createSandboxCodingTools } from 'stitchkit/agent-runtime/sandbox';
-import { mountAgent } from 'stitchkit/tools';
+import { mountAgent } from 'stitchkit/tools/agent';
 
 const tools = mountAgent([], {
   runtimeTools: createSandboxCodingTools(handle, {

package/llms/agent-runtime.2.txt

@@ -1,4 +1,4 @@
-# stitchkit/agent-runtime — stitchkit docs slice, part 2 of 3
+# stitchkit/agent-runtime — stitchkit docs slice, part 2 of 4
 
 > Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
 > `llms.txt` in this package.
@@ -7,7 +7,8 @@
 Parts of this slice:
 - `llms/agent-runtime.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
 - `llms/agent-runtime.2.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
-- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md) · API reference: `stitchkit-tui`  (docs/api/reference.md)
+- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md)
+- `llms/agent-runtime.4.txt`: API reference: `stitchkit-tui`  (docs/api/reference.md)
 
 ==============================================================================
 # Guide: Agent application runtime  (docs/guide/agent-runtime.md)  (continued)

package/llms/agent-runtime.3.txt

@@ -1,12 +1,14 @@
-# stitchkit/agent-runtime — stitchkit docs slice, part 3 of 3
+# stitchkit/agent-runtime — stitchkit docs slice, part 3 of 4
 
 > Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
 > `llms.txt` in this package.
+> Continues in `llms/agent-runtime.4.txt`.
 
 Parts of this slice:
 - `llms/agent-runtime.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
 - `llms/agent-runtime.2.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
-- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md) · API reference: `stitchkit-tui`  (docs/api/reference.md)
+- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md)
+- `llms/agent-runtime.4.txt`: API reference: `stitchkit-tui`  (docs/api/reference.md)
 
 ==============================================================================
 # Guide: Agent application runtime  (docs/guide/agent-runtime.md)  (continued)
@@ -431,47 +433,3 @@ is an optional atomic capability required by receipt admission, and
 stores supply both; custom adapters must honor the once-only transaction contract.
 A driver's optional `events.find(transaction, { conversationId, eventId })` makes
 both one lookup instead of a scan of the conversation log.
-
-==============================================================================
-# API reference: `stitchkit-tui`  (docs/api/reference.md)
-==============================================================================
-
-## `stitchkit-tui`
-
-Separate optional evolving Bun/OpenTUI package over a caller-composed headless harness.
-
-| Export | Kind | Summary |
-|--------|------|---------|
-| `defineAgentTui` | function | typed config for title/theme/status rows, model catalog, context, commands, runtime bundle and optional host-evidenced recovery policy; the default never requeues acquired effects |
-| `runAgentTui` | function | start one fresh durable conversation and terminal controller, recover durable work and publish its authenticated local session; `initialConversationId` is an explicit resume override |
-| `defineTuiCommand` / `resolveTuiCommand` | function | typed composable slash-command registry; unknown slash input remains an ordinary model prompt |
-| `createAgentTuiController` | function | single admission, selection, approval, interruption and conversation-switch owner over the harness |
-| `startAgentTuiSessionHost` / `createAgentTuiClient` | function | authenticated mode-`0600` Unix-socket host/client for status, submit and interrupt through that controller |
-| `listAgentTuiSessions` | function | discover live local terminal session IDs and their current conversation |
-| `createAgentTuiComposer` / `navigateAgentTuiHistory` | function | multiline draft and reversible prompt-history state |
-| `defaultAgentTuiStatusLine` / `AgentTuiStatusLineFormatter` | function / _type_ | terminal-native default rows and a host formatter over model capacity, durable snapshot, activity, workspace and local identities; `statusLine: false` hides the rows |
-| `createAgentTuiDiagnosticRecorder` / `AgentTuiDiagnosticEventSchema` | function / schema | bounded per-session metadata journal that rejects prompt, reasoning, tool-input and provider-cause payloads before disk admission |
-
-The `stitchkit-agent` binary loads `stitchkit.agent.ts` by default and also exposes `sessions`,
-`status`, `send` and `interrupt`. `--workspace` addresses a host outside the caller's cwd,
-`send --idempotency-key` accepts caller-owned retry identity, and `interrupt` defaults to the
-active run returned by `status`. Session descriptors and sockets are local control credentials,
-not a remote API.
-Interactive `/resume` and `/sessions` open the durable conversation picker. `/clear` creates a new
-conversation and keeps the previous one available there; it is not a viewport-only operation.
-The slash palette owns its highlighted selection: Up/Down move it, Tab completes it, Enter runs
-the exact command and Escape dismisses it. Partial input is never submitted while the palette is
-active; unknown slash text with no match remains an ordinary model prompt.
-
-### `stitchkit-tui/core`
-
-Renderer-neutral state only. This entrypoint imports neither React/OpenTUI nor the agent runtime.
-
-| Export | Kind | Summary |
-|--------|------|---------|
-| `createTerminalCollection` / `reduceTerminalCollection` | function | identity-stable live collection selection, reconciliation, windowing and resize |
-| `createTerminalFeedViewport` / `reduceTerminalFeedViewport` | function | generic follow-tail, history anchoring, unseen and bounded visible-range state |
-| `createTerminalPaneState` / `reduceTerminalPaneState` | function | bounded split-pane focus, resize and single-pane collapse |
-| `createTerminalCommandPalette` / `terminalCommandMatches` | function | bounded command filtering and keyboard selection over a collision-validated registry |
-| `resolveExactTerminalCommand` / `validateTerminalCommands` | function | exact dispatch and fail-closed name/alias validation |
-| `createTerminalOperationState` / `reduceTerminalOperationState` | function | confirmation and single-pending-operation lifecycle |

package/llms/agent-runtime.4.txt

@@ -0,0 +1,113 @@
+# stitchkit/agent-runtime — stitchkit docs slice, part 4 of 4
+
+> Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
+> `llms.txt` in this package.
+
+Parts of this slice:
+- `llms/agent-runtime.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
+- `llms/agent-runtime.2.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
+- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md)
+- `llms/agent-runtime.4.txt`: API reference: `stitchkit-tui`  (docs/api/reference.md)
+
+==============================================================================
+# API reference: `stitchkit-tui`  (docs/api/reference.md)
+==============================================================================
+
+## `stitchkit-tui`
+
+Separate optional evolving Bun/OpenTUI package over a caller-composed headless harness.
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `defineAgentTui` | function | typed config for title, `theme` (a `TerminalPalette` override) and `themeMode`, status rows, model catalog, context, commands, runtime bundle and optional host-evidenced recovery policy; the default never requeues acquired effects |
+| `runAgentTui` | function | start one fresh durable conversation and terminal controller, recover durable work and publish its authenticated local session; `initialConversationId` is an explicit resume override; it closes the session and exits the process on Ctrl-C and every signal OpenTUI catches unless `exitSignals: []` |
+| `defineTuiCommand` / `resolveTuiCommand` | function | typed composable slash-command registry; unknown slash input remains an ordinary model prompt |
+| `createAgentTuiController` | function | single admission, selection, approval, interruption and conversation-switch owner over the harness |
+| `startAgentTuiSessionHost` / `createAgentTuiClient` | function | authenticated mode-`0600` Unix-socket host/client for status, submit and interrupt through that controller |
+| `listAgentTuiSessions` | function | discover live local terminal session IDs and their current conversation |
+| `createAgentTuiComposer` / `navigateAgentTuiHistory` | function | multiline draft and reversible prompt-history state |
+| `defaultAgentTuiStatusLine` / `AgentTuiStatusLineFormatter` | function / _type_ | terminal-native default rows and a host formatter over model capacity, durable snapshot, activity, workspace and local identities; `statusLine: false` hides the rows |
+| `createAgentTuiDiagnosticRecorder` / `AgentTuiDiagnosticEventSchema` | function / schema | bounded per-session metadata journal that rejects prompt, reasoning, tool-input and provider-cause payloads before disk admission |
+
+The `stitchkit-agent` binary runs React's production build unless `NODE_ENV` says otherwise and loads `stitchkit.agent.ts` by default and also exposes `sessions`,
+`status`, `send` and `interrupt`. `--workspace` addresses a host outside the caller's cwd,
+`send --idempotency-key` accepts caller-owned retry identity, and `interrupt` defaults to the
+active run returned by `status`. Session descriptors and sockets are local control credentials,
+not a remote API.
+Interactive `/resume` and `/sessions` open the durable conversation picker. `/clear` creates a new
+conversation and keeps the previous one available there; it is not a viewport-only operation.
+The slash palette owns its highlighted selection: Up/Down move it, Tab completes it, Enter runs
+the exact command and Escape dismisses it. Partial input is never submitted while the palette is
+active; unknown slash text with no match remains an ordinary model prompt.
+
+### `stitchkit-tui/core`
+
+Renderer-neutral state only. This entrypoint imports neither React/OpenTUI nor the agent runtime.
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `createTerminalCollection` / `reduceTerminalCollection` | function | identity-stable live collection selection, reconciliation, windowing and resize |
+| `createTerminalFeedViewport` / `reduceTerminalFeedViewport` | function | generic follow-tail, history anchoring, unseen and bounded visible-range state |
+| `createTerminalPaneState` / `reduceTerminalPaneState` | function | bounded split-pane focus, resize and single-pane collapse |
+| `createTerminalCommandPalette` / `terminalCommandMatches` | function | bounded command filtering and keyboard selection over a collision-validated registry |
+| `resolveExactTerminalCommand` / `validateTerminalCommands` | function | exact dispatch and fail-closed name/alias validation |
+| `createTerminalOperationState` / `reduceTerminalOperationState` | function | confirmation and single-pending-operation lifecycle |
+| `createTerminalTable` / `reduceTerminalTable` / `projectTerminalTable` | function | live table: typed columns, rows validated on entry, sort with key tie-break and missing values last, tree expansion pruned to present rows, filter on displayed text, selection kept across data; a row's `tone` and a column's `tone(value, row)` colour state |
+| `layoutTerminalTableColumns` / `formatTerminalTableCell` / `visibleTerminalTableRows` / `terminalTableTreePrefix` | function | fixed and flexible column widths, `—` for missing values, the virtualized window, tree indentation |
+| `createTerminalList` / `reduceTerminalList` / `visibleTerminalListLines` | function | picker with sections, fuzzy query with title highlight ranges, multi-select, disabled items and "more above/below" counts |
+| `createTerminalForm` / `reduceTerminalForm` / `readTerminalForm` / `terminalFormFieldsFromJsonSchema` | function | typed fields (text, secret, number, integer, boolean, choice, JSON) from a JSON Schema, relative text edits, validation on leave and submit |
+| `createTerminalTabs` / `reduceTerminalTabs` | function | tabs with badges, wrap-around movement, digit selection and reconcile that keeps the selected tab |
+| `createTerminalNavigation` / `reduceTerminalNavigation` / `terminalBreadcrumbs` | function | screen stack keeping each level's state, root never popped |
+| `createTerminalFocus` / `reduceTerminalFocus` | function | focus ring plus layers that take the keyboard and give it back |
+| `createTerminalNotices` / `reduceTerminalNotices` / `nextTerminalNoticeExpiry` | function | bounded toasts on a caller clock, replaced by id |
+| `createTerminalTimeSeries` / `appendTerminalSample` / `sampleTerminalTimeSeries` | function | time window bounded by duration and sample count, value-in-force sampling with explicit gaps |
+| `terminalBrailleChart` / `terminalSparkline` / `terminalTimeAxis` / `terminalChartScale` | function | multi-series braille line or area chart as toned runs, sparkline, time axis |
+| `terminalMeter` / `layoutTerminalMeterGrid` | function | eighth-block bar toned by thresholds, unmeasured as muted; column-major core grid |
+| `terminalProgress` / `terminalSpinnerFrame` / `terminalIndeterminateBlock` / `formatTerminalDuration` | function | ratio, rate and ETA only when knowable; spinner frames; indeterminate bar; elapsed time |
+| `defineTerminalKeymap` / `matchTerminalKey` / `fitTerminalKeyHints` | function | conflict-checked bindings that both answer keys and draw a footer fitted to the width |
+| `terminalTableKeymap` / `terminalTableKey` / `terminalTabsKeymap` / `terminalTabsKey` | function | htop-style table bindings and tab bindings as keymaps |
+| `matchTerminalSearch` / `searchTerminalItems` / `terminalHighlightRuns` | function | multi-word fuzzy match with ranges, stable ranking, highlight runs |
+| `sanitizeTerminalText` / `terminalTextWidth` / `truncateTerminalText` / `fitTerminalText` / `wrapTerminalText` | function | strip escape and control sequences; measure, cut, pad and wrap by terminal cells |
+| `terminalTextEdit` / `applyTerminalTextEdit` | function | one-line edits as relative actions, so fast input is never lost |
+| `terminalJsonLines` / `layoutTerminalDetails` | function | toned, sanitized JSON lines; aligned key/value pairs |
+| `terminalPalettes` / `resolveTerminalPalette` / `TerminalPalette` / `TerminalTone` | value / function / _type_ | one semantic palette (surfaces plus `primary`, `muted`, `accent`, `success`, `warning`, `danger`) for dark and light terminals |
+| `terminalLabelsEn` / `terminalLabelsRu` / `TerminalLabels` | value / _type_ | every word the widgets draw |
+
+### `stitchkit-tui/widgets`
+
+OpenTUI React widgets over the core state. React, `@opentui/core` and `@opentui/react` are peers;
+this entrypoint never loads `stitchkit`.
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `TerminalAppShell` / `TerminalPanel` / `TerminalStatusBar` / `TerminalKeyHints` | component | breadcrumbs, status lines, body, fitted key hints and toast overlay; titled rounded panels with a focus frame |
+| `TerminalTable` | component | virtualized live table with header sort marks, tree, filter line and htop keys; row and cell tones in the palette, bold or dim where colour is missing |
+| `terminalToneAttributes` | function | the text attribute that carries a tone without colour: `danger` and `warning` bold, `muted` dim |
+| `TerminalList` | component | sections, fuzzy search line with highlights, `›` cursor, meta, badges, multi-select, description |
+| `runTerminalApp` / `RunTerminalAppOptions` / `RunningTerminalApp` | function / _type_ | start an application: renderer, theme and labels providers, the error boundary, and an exit with 128 + signal after `onClose` on Ctrl-C and every signal OpenTUI catches — a closed window leaves no orphan |
+| `TerminalErrorBoundary` / `TERMINAL_EXIT_SIGNALS` / `TerminalExitSignal` | component / value / _type_ | draws a render error and its stack in place of the screen, where OpenTUI's own boundary renders nothing under production React |
+| `TerminalForm` | component | fields edited in place, cycling choices, masked secrets, inline errors; a form without fields says so and submits `{}` on Enter |
+| `TerminalTextView` / `TerminalJsonView` | component | pager over sanitized wrapped text or toned JSON |
+| `TerminalMeter` / `TerminalMeterGrid` / `TerminalChart` / `TerminalSparkline` | component | htop meters and core grid; btop braille charts with axis |
+| `TerminalTabs` / `TerminalDialog` / `TerminalSpinner` / `TerminalProgressBar` / `TerminalAsyncView` / `TerminalDetails` / `TerminalNotices` / `TerminalHelp` | component | views, confirmation, loading, progress, async states, details, toasts, key help |
+| `TerminalThemeProvider` / `useTerminalPalette` / `useTerminalThemeMode` | component / hook | palette from the terminal's reported background (`auto`) or a fixed mode |
+| `TerminalLabelsProvider` / `TerminalFocusProvider` / `useTerminalFocused` | component / hook | product language and shared focus |
+
+The `stitchkit-tui-gallery` binary shows every widget live.
+
+### `stitchkit-tui/build`
+
+Build-time only; imports Bun and no React.
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `compileTerminalApp` / `CompileTerminalAppOptions` | function / _type_ | one standalone executable for any Bun compile target, from any machine, with React's production build defined |
+| `terminalNativePlugin` / `TerminalNativePluginOptions` | function / _type_ | the `Bun.build` plugin behind it: the target's `@opentui/core-<os>-<arch>` at the pinned version from the registry, verified against `bun.lock`; other platforms' packages throw; musl refused |
+| `terminalNativeTarget` / `TerminalNativeTarget` | function / _type_ | the native package a compile target needs |
+
+### `stitchkit-tui/testing`
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `renderTerminalTest` / `TerminalTestScreen` / `TerminalTestOptions` | function / _type_ | a screen inside the kit's providers on a test terminal; `press`, `type`, `burst`, `advance`, `waitForText`, `resize` run inside React's `act` and wait out a lone Esc |
+| `TerminalTestKey` / `TerminalTestModifiers` | _type_ | the mock input's key names and modifiers |

package/llms/agent-runtime.txt

@@ -1,4 +1,4 @@
-# stitchkit/agent-runtime — stitchkit docs slice, part 1 of 3
+# stitchkit/agent-runtime — stitchkit docs slice, part 1 of 4
 
 > Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
 > `llms.txt` in this package.
@@ -7,7 +7,8 @@
 Parts of this slice:
 - `llms/agent-runtime.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
 - `llms/agent-runtime.2.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md)
-- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md) · API reference: `stitchkit-tui`  (docs/api/reference.md)
+- `llms/agent-runtime.3.txt`: Guide: Agent application runtime  (docs/guide/agent-runtime.md) · API reference: `stitchkit/agent-runtime`  (docs/api/reference.md)
+- `llms/agent-runtime.4.txt`: API reference: `stitchkit-tui`  (docs/api/reference.md)
 
 ==============================================================================
 # Guide: Agent application runtime  (docs/guide/agent-runtime.md)
@@ -18,16 +19,16 @@ Parts of this slice:
 > **Maturity: evolving.** This surface is still finding its shape and may be
 > redefined in any minor release — always with a `### ⚠️ Breaking changes` entry
 > and a migration section, never silently. If your application already owns the
-> conversation loop, `mountAgent` from `stitchkit/tools` is the stable path.
+> conversation loop, `mountAgent` from `stitchkit/tools/agent` is the direct path.
 
 `stitchkit/agent-runtime` is the server-only, opinionated layer above
 `mountAgent`. Use it when the application wants Stitchkit to own conversation
 mechanics: durable acceptance, history projection, the AI SDK stream loop,
 checkpoints, keyed interruption, terminal commit and stable application events.
 
-If the application already owns that loop, continue importing `mountAgent` from
-`stitchkit/tools`. `stitchkit/tools` does not depend on this entrypoint at all;
-this entrypoint uses the tool executor from it, but pulls no MCP peer, so
+If the application already owns that loop, import `mountAgent` from
+`stitchkit/tools/agent`. Neither `stitchkit/tools` nor `stitchkit/tools/agent` depends on
+this entrypoint; this entrypoint uses the tool executor, but pulls no MCP peer, so
 choosing `mountAgent` alone costs you nothing from here.
 
 UI and shared DTO code must import canonical records and delivery validation from
@@ -51,12 +52,8 @@ persistence, event sinks and every Node context dependency.
 bun add stitchkit ai zod
 ```
 
-`mountAgent` from `stitchkit/tools` — used in the composition below — additionally
-needs the MCP peer, which that entrypoint imports statically:
-
-```sh
-bun add @modelcontextprotocol/server
-```
+`mountAgent` from `stitchkit/tools/agent` — used in the composition below — needs no
+peer beyond `ai`.
 
 OpenRouter is isolated so other runtime users do not resolve its package:
 
@@ -77,7 +74,8 @@ import {
   defineModelRegistry,
 } from 'stitchkit/agent-runtime'
 import { openRouterProvider } from 'stitchkit/agent-runtime/openrouter'
-import { composeToolLifecycle, mountAgent } from 'stitchkit/tools'
+import { composeToolLifecycle } from 'stitchkit/tools'
+import { mountAgent } from 'stitchkit/tools/agent'
 
 const protocol = defineAgentProtocol({
   context: z.object({ userId: z.string() }),

package/llms/cli.txt

@@ -36,7 +36,7 @@ types; the package keeps its required dependencies separate from optional SDKs.
 CLI runtime tools use the one runtime-tool declaration: identity, input and output
 schemas, handler, and explicit CLI exposure. SDK presenters are the adapter's extension
 of that declaration (the fourth type argument of `RuntimeToolDefinitionWithOutput`, or
-`defineRuntimeTool` in `stitchkit/tools`), which requires the corresponding peers. A typed
+`defineRuntimeTool` in `stitchkit/tools`), whose presenter types name the corresponding SDKs. A typed
 definition returned by `defineRuntimeTool` or `createRuntimeToolFactory` can be
 passed directly to both CLI and SDK mounts.