@hachej/boring-agent 0.1.31 → 0.1.33

package/dist/shared/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentTool } from '../harness-CQ0uw6xW.js';
-export { a as AgentHarness, J as JSONSchema, R as RunContext, S as SendMessageInput, b as SessionCtx, c as SessionDetail, d as SessionStore, e as SessionSummary, T as TelemetryEvent, f as TelemetrySink, g as ToolExecContext, h as ToolResult, n as noopTelemetry, s as safeCapture } from '../harness-CQ0uw6xW.js';
+import { A as AgentTool } from '../harness-dYuMzxmp.js';
+export { a as AgentHarness, J as JSONSchema, R as RunContext, S as SendMessageInput, b as SessionCtx, c as SessionDetail, d as SessionStore, e as SessionSummary, T as TelemetryEvent, f as TelemetrySink, g as ToolExecContext, h as ToolResult, n as noopTelemetry, s as safeCapture } from '../harness-dYuMzxmp.js';
 import { W as Workspace, S as Sandbox, F as FileSearch } from '../agentPluginEvents-CF0BGY4D.js';
 export { E as Entry, a as ExecOptions, b as ExecResult, I as IsolatedCodeInput, c as IsolatedCodeOutput, d as SandboxCapability, e as SandboxHandleRecord, f as SandboxHandleStore, g as Stat, h as WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT, i as WorkspaceRuntimeContext } from '../agentPluginEvents-CF0BGY4D.js';
 export { T as ToolUiMetadata, e as extractToolUiMetadata, i as isToolUiMetadata } from '../tool-ui-DIFNGwYd.js';

package/docs/ERROR_CODES.md

@@ -34,8 +34,8 @@ All API failures must use the response envelope:
 | `PATH_NOT_WRITABLE` | Path parent missing or write denied | 403 | user-fix | warn | stable (public API) |
 | `WORKSPACE_UNINITIALIZED` | Workspace adapter/store not initialized yet | 503 | retry | warn | stable (public API) |
 | `WORKSPACE_NOT_READY` | Workspace substrate (`workspace-fs`, `sandbox-exec`, or `ui-bridge`) is still preparing | 503 | retry | warn | stable (public API) |
-| `AGENT_RUNTIME_NOT_READY` | Selected workspace agent runtime is still preparing | 503 | retry | warn | stable (public API) |
-| `RUNTIME_PROVISIONING_FAILED` | Agent runtime provisioning failed before runtime became ready | 503 | retry/report | error | stable (public API) |
+| `AGENT_RUNTIME_NOT_READY` | Selected workspace runtime dependencies (`runtime-dependencies` or `runtime:<name>`, e.g. `runtime:python`/`runtime:node`) are still preparing | 503 | retry | warn | stable (public API) |
+| `RUNTIME_PROVISIONING_FAILED` | Agent runtime dependency provisioning failed before Level 3 runtime dependencies became ready | 503 | retry/report | error | stable (public API) |
 | `RUNTIME_PROVISIONING_LOCKED` | Agent runtime provisioning is locked by another reconciler | 423 | retry | warn | stable (public API) |
 | `BWRAP_UNAVAILABLE` | `bwrap` binary not found | 500 | report-bug | error | stable (public API) |
 | `BWRAP_TIMEOUT` | Sandbox command exceeded timeout | 408 | retry | warn | stable (public API) |
@@ -68,3 +68,39 @@ All API failures must use the response envelope:
 | `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) |
 | `INTERNAL_ERROR` | Catch-all internal failure | 500 | report-bug | error | internal (may change) |
+
+## Readiness error details
+
+`WORKSPACE_NOT_READY` is reserved for workspace substrate requirements:
+
+```json
+{
+  "code": "WORKSPACE_NOT_READY",
+  "retryable": true,
+  "requirement": "workspace-fs"
+}
+```
+
+Runtime dependency preparation is separate so chat/file work can continue while `.boring-agent` dependencies install:
+
+```json
+{
+  "code": "AGENT_RUNTIME_NOT_READY",
+  "retryable": true,
+  "requirement": "runtime:python",
+  "state": "preparing",
+  "workspaceId": "workspace_123"
+}
+```
+
+If dependency provisioning fails, dependency-backed tools return:
+
+```json
+{
+  "code": "RUNTIME_PROVISIONING_FAILED",
+  "retryable": true,
+  "requirement": "runtime:python",
+  "state": "failed",
+  "causeCode": "PROVISIONING_UV_INSTALL_FAILED"
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -75,7 +75,7 @@
     "use-stick-to-bottom": "^1.1.3",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.31"
+    "@hachej/boring-ui-kit": "0.1.33"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
@@ -129,6 +129,8 @@
     "lint": "pnpm run typecheck && pnpm run lint:invariants",
     "lint:invariants": "bash ../../scripts/check-invariants.sh .",
     "clean": "rm -rf dist .tsbuildinfo",
-    "smoke:vercel-sandbox": "tsx ./scripts/smoke-vercel-sandbox.mts"
+    "smoke:vercel-sandbox": "tsx ./scripts/smoke-vercel-sandbox.mts",
+    "smoke:capability-readiness": "tsx ./scripts/smoke-capability-readiness.mts",
+    "smoke:capability-readiness:vercel": "tsx ./scripts/smoke-capability-readiness-vercel.mts"
   }
 }