@hachej/boring-agent 0.1.63 → 0.1.65

package/dist/shared/index.js

@@ -1,24 +1,22 @@
 import {
-  noopTelemetry,
-  safeCapture,
   validateTool
-} from "../chunk-HDOSWEXG.js";
+} from "../chunk-ZD7MM2LQ.js";
+import {
+  AGENT_NOT_IMPLEMENTED_UNTIL_T1,
+  AgentNotImplementedError,
+  sessionStreamPath
+} from "../chunk-WSQ5QNIY.js";
 import {
   WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT,
   WORKSPACE_COMMAND_NOTIFY_EVENT
 } from "../chunk-DGRKMMXO.js";
 import {
-  ApiErrorPayloadSchema,
-  ApiErrorResponseSchema,
   BoringChatMessageSchema,
   BoringChatPartSchema,
   ChatAttachmentPayloadSchema,
   ChatErrorSchema,
   ChatModelSelectionSchema,
   CommandReceiptSchema,
-  ERROR_CODES,
-  ErrorCode,
-  ErrorLogFieldsSchema,
   FollowUpPayloadSchema,
   FollowUpReceiptSchema,
   InterruptPayloadSchema,
@@ -39,7 +37,18 @@ import {
   extractToolUiMetadata,
   isToolUiMetadata,
   sanitizeToolUiMetadata2 as sanitizeToolUiMetadata
-} from "../chunk-G6YPXDHR.js";
+} from "../chunk-4LXA7OOV.js";
+import {
+  noopTelemetry,
+  safeCapture
+} from "../chunk-AQBXNPMD.js";
+import {
+  ApiErrorPayloadSchema,
+  ApiErrorResponseSchema,
+  ERROR_CODES,
+  ErrorCode,
+  ErrorLogFieldsSchema
+} from "../chunk-XZKU7FBV.js";
 
 // src/shared/config-schema.ts
 import { z } from "zod";
@@ -105,6 +114,8 @@ var PI_AGENT_RUNTIME_CAPABILITIES = {
   aiSdkOwnsHistory: false
 };
 export {
+  AGENT_NOT_IMPLEMENTED_UNTIL_T1,
+  AgentNotImplementedError,
   ApiErrorPayloadSchema,
   ApiErrorResponseSchema,
   BoringChatMessageSchema,
@@ -145,6 +156,7 @@ export {
   noopTelemetry,
   safeCapture,
   sanitizeToolUiMetadata,
+  sessionStreamPath,
   validateConfig,
   validateTool
 };

package/docs/ERROR_CODES.md

@@ -49,6 +49,8 @@ All API failures must use the response envelope:
 | `CIRCUIT_OPEN` | Circuit breaker open; request fast-failed | 503 | retry | warn | stable (public API) |
 | `ABORTED` | Request cancelled via `AbortSignal` | 499 | retry | warn | stable (public API) |
 | `PAYMENT_REQUIRED` | Billing/metering sink rejected the run (e.g. credits exhausted) | 402 | user-fix | warn | stable (public API) |
+| `MODEL_BUDGET_EXCEEDED` | Governance model budget for this user/model is exhausted | 402 | user-fix | warn | stable (public API) |
+| `METERING_UNSUPPORTED_COMMAND` | Slash-command execution is disabled because metering cannot yet reserve/settle that path | 409 | user-fix | warn | stable (public API) |
 | `SESSION_NOT_FOUND` | Session id does not exist | 404 | user-fix | warn | stable (public API) |
 | `SESSION_LOCKED` | Session currently locked by concurrent writer | 409 | retry | warn | stable (public API) |
 | `STREAM_BUFFER_EVICTED` | Resume cursor evicted from in-memory stream buffer | 410 | retry | warn | stable (public API) |
@@ -76,6 +78,7 @@ All API failures must use the response envelope:
 | `PROVISIONING_UV_BOOTSTRAP_FAILED` | uv bootstrap/preflight failed for Python runtime packages | 500 | user-fix | error | stable (public API) |
 | `PROVISIONING_UV_INSTALL_FAILED` | uv venv or uv pip install failed | 500 | user-fix | error | stable (public API) |
 | `PROVISIONING_ARTIFACT_FAILED` | Runtime-mode adapter failed to prepare/upload install artifact | 500 | retry | error | stable (public API) |
+| `ERR_NOT_IMPLEMENTED_UNTIL_T1` | Headless core method exists but the durable T1 implementation has not landed yet | 501 | retry-after-upgrade | warn | stable (public API) |
 | `INTERNAL_ERROR` | Catch-all internal failure | 500 | report-bug | error | internal (may change) |
 
 ## Readiness error details

package/docs/plans/archive/harness-followup-capabilities.md

@@ -178,7 +178,7 @@ Locked implementation choices for the first pass:
 - Keep current pi projection as temporary, adapter-owned compatibility behind `aiSdkOwnsHistory === false`.
 - Add a stable unsupported-follow-up error code: `FOLLOWUP_UNSUPPORTED`.
 
-This means the next implementation bead should transform the already-working pi follow-up branch into a pluggable design:
+This means the next implementation task should transform the already-working pi follow-up branch into a pluggable design:
 
 ```txt
 pi runtime:

package/docs/plans/archive/pi-tools-migration.md

@@ -822,7 +822,7 @@ convenience accessors `command.stdout()` + `command.stderr()` by choice,
 not necessity. `DirectSandbox` and `BwrapSandbox` use `child_process`
 which has streamed via `child.stdout.on('data', ...)` since forever.
 
-**Mitigation: bead `uhwx.5b` (a new precursor)** extends `ExecOptions`
+**Mitigation: task `uhwx.5b` (a new precursor)** extends `ExecOptions`
 with optional `onStdout`/`onStderr` callbacks and updates all three
 sandbox adapters to invoke them as bytes arrive. ~4-6 hours total. Gates
 `uhwx.6` (vercel*Ops) and `uhwx.7` (buildHarnessAgentTools) since both

package/docs/plans/archive/vercel-persistent-sandbox-adapter.md

@@ -475,7 +475,7 @@ Acceptance:
   no longer needed.
 - Decide whether to rename channel from `persistent-beta` to `persistent`.
 - Keep backwards compatibility for old stable records until an explicit cleanup
-  bead removes it.
+  task removes it.
 
 ## Test Matrix
 

package/docs/runtime.md

@@ -2,7 +2,15 @@
 
 # Runtime Modes and Provisioning
 
-The agent supports three execution modes controlling how `bash` and filesystem tools run.
+When a boring-bash filesystem/exec environment is attached, the agent supports
+three execution modes controlling how `bash` and filesystem tools run.
+
+Pure/headless agents use `runtime: 'none'` instead. That mode has no
+`Workspace`, no `Sandbox`, no cwd, no file routes, no file tools, and no bash
+tools. It is not selected with `BORING_AGENT_MODE`; the host composes a
+runtime-free agent and supplies only non-bash tools plus session/model
+configuration. If the host later attaches a filesystem/exec environment, that
+attachment enters the boring-bash runtime contract below.
 
 ## Modes
 
@@ -22,7 +30,7 @@ Defaults to `direct` when unset.
 
 ## Runtime cwd contract
 
-Every adapter must preserve this invariant:
+Every boring-bash runtime adapter must preserve this invariant:
 
 ```txt
 file tree root == shell cwd == model-visible cwd == BORING_AGENT_WORKSPACE_ROOT
@@ -36,7 +44,7 @@ interface WorkspaceRuntimeContext {
 }
 ```
 
-Adapter rules:
+Adapter rules for attached filesystem/exec environments:
 
 - `Workspace.root` must equal `runtimeContext.runtimeCwd`.
 - `Sandbox.runtimeContext.runtimeCwd` must equal the same value.
@@ -228,12 +236,17 @@ default this to the sibling `/data/pi-sessions` path when the env var is absent.
 
 ## Adding a custom runtime mode
 
-A mode is a `RuntimeModeAdapter` (defined in `src/server/runtime/mode.ts`).
-There is no registry to edit: pass your adapter as the `runtimeModeAdapter`
-option to `createAgentApp(opts)` or `registerAgentRoutes(app, opts)` — it takes
-precedence over `mode`/auto-detection (`createAgentApp.ts`,
-`registerAgentRoutes.ts`). `resolveMode()` only knows the three built-ins and
-throws for unknown ids, telling you to pass `runtimeModeAdapter`.
+A boring-bash-active mode is a `RuntimeModeAdapter` (defined in
+`src/server/runtime/mode.ts`). There is no registry to edit: pass your adapter
+as the `runtimeModeAdapter` option to `createAgentApp(opts)` or
+`registerAgentRoutes(app, opts)` — it takes precedence over
+`mode`/auto-detection (`createAgentApp.ts`, `registerAgentRoutes.ts`).
+`resolveMode()` only knows the three built-ins and throws for unknown ids,
+telling you to pass `runtimeModeAdapter`.
+
+This interface is for environments that intentionally provide a workspace,
+filesystem/search, and sandbox/execution substrate. Pure `runtime: 'none'`
+agents do not construct a `RuntimeBundle`.
 
 ```ts
 interface RuntimeModeAdapter {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -18,6 +18,10 @@
       "types": "./dist/shared/index.d.ts",
       "import": "./dist/shared/index.js"
     },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js",
@@ -42,57 +46,58 @@
   ],
   "dependencies": {
     "@mariozechner/pi-coding-agent": "npm:@earendil-works/pi-coding-agent@0.75.5",
-    "@radix-ui/react-collapsible": "^1.1.12",
-    "@radix-ui/react-dialog": "^1.1.15",
-    "@radix-ui/react-dropdown-menu": "^2.1.16",
-    "@radix-ui/react-hover-card": "^1.1.15",
-    "@radix-ui/react-select": "^2.2.6",
-    "@radix-ui/react-separator": "^1.1.8",
-    "@radix-ui/react-slot": "^1.2.4",
-    "@radix-ui/react-tooltip": "^1.2.8",
-    "@radix-ui/react-use-controllable-state": "^1.2.2",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@radix-ui/react-collapsible": "^1.1.14",
+    "@radix-ui/react-dialog": "^1.1.17",
+    "@radix-ui/react-dropdown-menu": "^2.1.18",
+    "@radix-ui/react-hover-card": "^1.1.17",
+    "@radix-ui/react-select": "^2.3.1",
+    "@radix-ui/react-separator": "^1.1.10",
+    "@radix-ui/react-slot": "^1.3.0",
+    "@radix-ui/react-tooltip": "^1.2.10",
+    "@radix-ui/react-use-controllable-state": "^1.2.3",
     "@streamdown/cjk": "^1.0.3",
     "@streamdown/code": "^1.1.1",
     "@streamdown/math": "^1.0.2",
     "@streamdown/mermaid": "^1.0.2",
-    "@tanstack/react-query": "^5.0.0",
-    "@vercel/blob": "^2.3.3",
-    "@vercel/sandbox": "2.0.0-beta.14",
-    "ai": "^6.0.168",
-    "chokidar": "^4.0.3",
+    "@tanstack/react-query": "^5.101.1",
+    "@vercel/blob": "^2.5.0",
+    "@vercel/sandbox": "2.2.1",
+    "ai": "^7.0.2",
+    "chokidar": "^5.0.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "diff": "^9.0.0",
-    "fastify": "^5.3.3",
-    "lucide-react": "^1.8.0",
-    "motion": "^12.38.0",
-    "nanoid": "^5.1.9",
-    "shiki": "^4.0.2",
+    "fastify": "^5.9.0",
+    "lucide-react": "^1.21.0",
+    "motion": "^12.42.0",
+    "nanoid": "^5.1.16",
+    "shiki": "^4.3.0",
     "streamdown": "^2.5.0",
     "tailwind-merge": "^3.5.0",
-    "use-stick-to-bottom": "^1.1.3",
-    "yaml": "^2.8.3",
+    "use-stick-to-bottom": "^1.1.6",
+    "yaml": "^2.9.0",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.63"
+    "@hachej/boring-ui-kit": "0.1.65"
   },
   "devDependencies": {
-    "@antithesishq/bombadil": "0.5.0",
+    "@antithesishq/bombadil": "0.6.1",
     "@opentelemetry/api": "^1.9.1",
-    "@tailwindcss/postcss": "^4.2.4",
-    "@types/node": "^22.15.3",
-    "@types/react": "^19.1.2",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^22.20.0",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.1.3",
     "@vitejs/plugin-react": "^4.7.0",
-    "ajv": "^8.18.0",
-    "postcss": "^8.5.13",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "ajv": "^8.20.0",
+    "postcss": "^8.5.15",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tsup": "^8.4.0",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
     "vite": "^6.3.3",
-    "vitest": "^3.2.6"
+    "vitest": "^4.1.9"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/dist/chatSubmitPayload-DHqQL2wD.d.ts

@@ -1,48 +0,0 @@
-interface SessionStore {
-    list(ctx: SessionCtx, options?: SessionListOptions): Promise<SessionSummary[]>;
-    create(ctx: SessionCtx, init?: {
-        title?: string;
-    }): Promise<SessionSummary>;
-    load(ctx: SessionCtx, sessionId: string): Promise<SessionDetail>;
-    delete(ctx: SessionCtx, sessionId: string): Promise<void>;
-}
-interface SessionCtx {
-    workspaceId: string;
-    userId?: string;
-}
-interface SessionListOptions {
-    limit?: number;
-    offset?: number;
-    includeId?: string;
-}
-interface SessionSummary {
-    id: string;
-    title: string;
-    createdAt: string;
-    updatedAt: string;
-    turnCount: number;
-}
-type SessionDetail = SessionSummary;
-
-type ThinkingLevel = 'off' | 'low' | 'medium' | 'high';
-interface ChatModelSelection {
-    provider: string;
-    id: string;
-}
-interface ChatAttachmentPayload {
-    filename?: string;
-    mediaType?: string;
-    url: string;
-    /** Workspace-relative path when the browser upload endpoint persisted the attachment. */
-    path?: string;
-}
-interface ChatSubmitPayload {
-    message: string;
-    displayMessage?: string;
-    clientNonce: string;
-    model?: ChatModelSelection;
-    thinkingLevel?: ThinkingLevel;
-    attachments?: ChatAttachmentPayload[];
-}
-
-export type { ChatAttachmentPayload as C, SessionCtx as S, ThinkingLevel as T, ChatModelSelection as a, ChatSubmitPayload as b, SessionDetail as c, SessionStore as d, SessionSummary as e };