@visual-z/xeno 0.1.0 → 0.1.1

package/README.md

@@ -17,7 +17,7 @@ is ever summarized by a model, and nothing is ever rewritten in place.
 messages[]                             frozen system prefix + handoff + this node's events
 ```
 
-Version **0.1.0**. The on-disk session format will still change; `0.x` is that
+Version **0.1.1**. The on-disk session format will still change; `0.x` is that
 statement. Published as `@visual-z/xeno`; the license is `UNLICENSED` (readable and installable, no reuse granted).
 
 ## Install

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visual-z/xeno",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "UNLICENSED",
   "type": "module",
   "description": "Segmented append-only agent log with pure context and handoff projections",

package/src/apps/startup.ts

@@ -125,12 +125,29 @@ export function cliSessionConfig(args: Args): { continuationAfter: number; timeB
   return { continuationAfter: Infinity, ...(args.timeBudgetMs === undefined ? {} : { timeBudgetMs: args.timeBudgetMs }) };
 }
 
+/**
+ * Pure: where each kind of state lives for this workspace. Tool observations
+ * are not listed: Session keeps them in `<logDir>/artifacts`, inside the
+ * session, so fork and copy carry them -- moving sessions moves them too.
+ */
+export function statePaths(workspace: string, stateDir?: string): { blobs: string; sessions: string } {
+  const root = stateDir ?? join(workspace, ".xeno");
+  return { blobs: join(root, "blobs"), sessions: join(root, "sessions") };
+}
+
 export type AskSlot = {
   current?: (request: PermissionRequest) => Promise<ApprovalChoice>;
 };
 
 export interface Args {
   workspace: string;
+  /**
+   * `--state-dir <dir>`: where every xeno write goes -- snapshots, tool
+   * observations and, unless --session-dir says otherwise, sessions. Absent
+   * means `<workspace>/.xeno`. Evaluations need it outside the workspace:
+   * patches and verifiers see whatever is written there.
+   */
+  stateDir?: string;
   /** `--time-budget <seconds>`, in ms: when to warn the model its run is nearly out of time. */
   timeBudgetMs?: number;
   /**
@@ -213,6 +230,7 @@ export interface Args {
 const KNOWN_FLAGS: readonly string[] = [
   "--workspace", "-w",
   "--path-root",
+  "--state-dir",
   "--time-budget",
   "--log",
   "--max-turns",
@@ -346,6 +364,7 @@ export function parseArgs(argv: string[]): Args {
     const a = argv[i]!;
     if (a === "--workspace" || a === "-w") args.workspace = argv[++i] ?? args.workspace;
     else if (a === "--path-root") args.pathRoot = resolve(argv[++i] ?? "/");
+    else if (a === "--state-dir") args.stateDir = resolve(argv[++i] ?? ".");
     else if (a === "--time-budget") {
       const seconds = Number(argv[++i]);
       if (!Number.isFinite(seconds) || seconds <= 0) throw new Error("--time-budget requires a positive number of seconds");
@@ -447,6 +466,7 @@ export function parseArgs(argv: string[]): Args {
           "  --no-builtin-tools drops built-ins and keeps any other source; --tools still wins.\n" +
           "  bash asks before it runs. --allow-tools bash skips the ask for this process.\n" +
           "  --time-budget <seconds> tells the model, once, when 75% of the run's wall-clock budget is used.\n" +
+          "  --state-dir <dir> keeps snapshots, observations and sessions out of the workspace.\n" +
           "  --path-root <dir> lets file tools reach absolute paths under <dir> (e.g. / in a container);\n" +
           "  relative paths, fingerprints and /back stay in the workspace, so edits outside it are not rewound.\n" +
           "  --approve loads .xeno/settings.json this run; --no-approve skips it.\n" +
@@ -1098,7 +1118,8 @@ export async function startup(args: Args): Promise<App> {
    * log stays where it is, still resumable by pointing --log at it. A leftover
    * `.xeno/log` from before named sessions is the same: pointed at, not moved.
    */
-  const sessionDir = (args.sessionDir ?? "").length > 0 ? args.sessionDir : undefined;
+  const paths = statePaths(workspace, args.stateDir);
+  const sessionDir = (args.sessionDir ?? "").length > 0 ? args.sessionDir : args.stateDir !== undefined ? paths.sessions : undefined;
   const sessionPick =
     (args.session ?? "").length > 0
       ? args.session
@@ -1147,7 +1168,7 @@ export async function startup(args: Args): Promise<App> {
   // read-only branch has nothing to snapshot, but a session a person drives is
   // exactly the one that will want to go back, and the content has to have been
   // stored before the turn a person wants back -- it cannot be opted into after.
-  const blobDir = join(workspace, ".xeno", "blobs");
+  const blobDir = paths.blobs;
   await mkdir(logDir, { recursive: true });
   await mkdir(blobDir, { recursive: true });