@hachej/boring-agent 0.1.50 → 0.1.51

package/README.md

@@ -54,7 +54,8 @@ function App() {
 
 Set an API key for the model provider (e.g. `ANTHROPIC_API_KEY`). Common env
 vars: `BORING_AGENT_MODE` (default `direct`), `BORING_AGENT_WORKSPACE_ROOT`
-(default cwd), `BORING_AGENT_PORT`, and the `BORING_AGENT_DEFAULT_MODEL*` /
+(default cwd), `BORING_AGENT_SESSION_ROOT` (durable Pi session storage),
+`BORING_AGENT_PORT`, and the `BORING_AGENT_DEFAULT_MODEL*` /
 `BORING_AGENT_CUSTOM_MODEL*` / `BORING_AGENT_INFOMANIAK*` provider settings. See
 [docs/runtime.md](./docs/runtime.md) and [docs/API.md](./docs/API.md).
 

package/dist/server/index.js

@@ -6053,19 +6053,24 @@ import {
   parseSessionEntries,
   CURRENT_SESSION_VERSION
 } from "@mariozechner/pi-coding-agent";
+function sessionBaseDir() {
+  const configured = getEnv(SESSION_ROOT_ENV)?.trim();
+  return configured ? resolve7(configured) : join10(homedir3(), ".pi", "agent", "sessions");
+}
 function defaultSessionDir(cwd) {
   const safePath = `--${cwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
-  return join10(homedir3(), ".pi", "agent", "sessions", safePath);
+  return join10(sessionBaseDir(), safePath);
 }
 var SAFE_ID = /^[a-zA-Z0-9_-]+$/;
 var SAFE_SESSION_NAMESPACE = /^[a-zA-Z0-9_-]+$/;
+var SESSION_ROOT_ENV = "BORING_AGENT_SESSION_ROOT";
 var SUMMARY_PREFIX_BYTES = 64 * 1024;
 function sessionDirForNamespace(namespace) {
   const safeNamespace = namespace.trim();
   if (!SAFE_SESSION_NAMESPACE.test(safeNamespace)) {
     throw new Error("session namespace must contain only letters, numbers, underscores, and dashes");
   }
-  return join10(homedir3(), ".pi", "agent", "sessions", safeNamespace);
+  return join10(sessionBaseDir(), safeNamespace);
 }
 function normalizeListOptions(options) {
   return {

package/docs/runtime.md

@@ -199,6 +199,31 @@ In `direct` mode this is also the model-visible workspace root. In isolated
 modes, the adapter maps that host path into the public runtime namespace
 (`/workspace`).
 
+### Production storage roots in `vercel-sandbox` mode
+
+In a Fly-hosted app using `BORING_AGENT_MODE=vercel-sandbox`, there are two
+filesystems with different jobs:
+
+```txt
+Fly app container / mounted volume:
+  /data/workspaces/<workspaceId>   host/control-plane workspace anchor
+  /data/pi-sessions/<workspaceId>  durable chat transcript storage
+
+Vercel sandbox:
+  /workspace                       agent-visible cwd, file tree, and shell root
+```
+
+`BORING_AGENT_WORKSPACE_ROOT=/data/workspaces` is a host-side configuration
+input. Core resolves each authorized workspace to `/data/workspaces/<id>` and
+ensures that directory exists so host-side resource lookups have a durable,
+workspace-scoped anchor. In `vercel-sandbox` mode, it is not where normal agent
+file edits, shell output, Python files, or uploaded workspace files should live.
+Those belong to the sandbox runtime root, `/workspace`.
+
+Production chat history also must not use the container root filesystem. Set
+`BORING_AGENT_SESSION_ROOT` to a mounted-volume path such as `/data/pi-sessions`
+so Pi wrapper/native transcripts survive Fly deploys and restarts.
+
 ## Adding a custom runtime mode
 
 A mode is a `RuntimeModeAdapter` (defined in `src/server/runtime/mode.ts`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -74,7 +74,7 @@
     "use-stick-to-bottom": "^1.1.3",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.50"
+    "@hachej/boring-ui-kit": "0.1.51"
   },
   "devDependencies": {
     "@antithesishq/bombadil": "0.5.0",