@namzu/sdk 43.0.0 → 44.0.0

package/dist/session/handoff/single.js

@@ -8,7 +8,7 @@
  *
  * Flow (pattern doc §5.1 + §6.1):
  *   1. Load source session; verify tenant.
- *   2. Check status (must be `idle`); no non-terminal Runs.
+ *   2. Check status (must be `idle`); no non-terminal turns.
  *   3. Validate capacity (depth + width).
  *   4. Transition source `idle → locked` with CAS on `ownerVersion`.
  *   5. Emit `onLocked`.
@@ -67,9 +67,9 @@ export async function executeSingleHandoff(deps, assignment, tenantId) {
             reason: statusToLockReason(source.status),
         });
     }
-    // 3. Non-terminal Run fan-in (§5.1).
-    const runResolver = deps.runStatus;
-    const blocking = await runResolver.blockingRun(source.id, tenantId);
+    // 3. Non-terminal turn fan-in (§5.1).
+    const turnResolver = deps.turnStatus;
+    const blocking = await turnResolver.blockingTurn(source.id, tenantId);
     if (blocking) {
         throw new HandoffLockRejected({
             sessionId: source.id,
@@ -226,21 +226,21 @@ async function revertLock(deps, source, workspace, createdSessionId, tenantId) {
 function statusToLockReason(status) {
     switch (status) {
         case 'active':
-            return 'active_run';
+            return 'active_turn';
         case 'awaiting_hitl':
             return 'pending_hitl';
         case 'awaiting_merge':
             return 'pending_subsession';
         case 'locked':
-            return 'active_run';
+            return 'active_turn';
         case 'failed':
-            return 'active_run';
+            return 'active_turn';
         case 'archived':
-            return 'active_run';
+            return 'active_turn';
         case 'idle':
             // Unreachable — caller guards. Keep a sentinel value so exhaustiveness
             // does not force an `assert never` export from this module.
-            return 'active_run';
+            return 'active_turn';
     }
 }
 function emit(handler, event) {

package/dist/session/handoff/single.js.map

@@ -1 +1 @@
-{"version":3,"file":"single.js","sourceRoot":"","sources":["../../../src/session/handoff/single.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"single.js","sourceRoot":"","sources":["../../../src/session/handoff/single.ts"],"names":[],"mappings":"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"}

package/dist/session/handoff/version.d.ts

@@ -6,7 +6,7 @@
  * can route without string parsing (Convention #5: deny-by-default, fail
  * fast).
  */
-import type { RunId, SessionId } from '../../types/ids/index.js';
+import type { SessionId, TurnId } from '../../types/ids/index.js';
 /**
  * Raised when a handoff's CAS write finds {@link Session.ownerVersion} has
  * advanced since the assignment was constructed — another actor committed
@@ -28,25 +28,25 @@ export declare class HandoffVersionConflict extends Error {
 /**
  * Reasons a session cannot transition `* → locked` for handoff. See
  * session-hierarchy.md §5.1 — lock entry requires an `idle` session with all
- * runs terminal. The three reasons are the non-terminal Run statuses that
+ * turns terminal. The three reasons are the non-terminal turn statuses that
  * fan in to a non-idle Session.
  */
-export type HandoffLockRejectedReason = 'active_run' | 'pending_hitl' | 'pending_subsession';
+export type HandoffLockRejectedReason = 'active_turn' | 'pending_hitl' | 'pending_subsession';
 /**
- * Raised when a handoff targets a session whose current Run is non-terminal.
- * Callers must wait for the active Run to terminalize (or cancel it) before
+ * Raised when a handoff targets a session whose current turn is non-terminal.
+ * Callers must wait for the active turn to terminalize (or cancel it) before
  * re-attempting the handoff (session-hierarchy.md §5.1).
  */
 export declare class HandoffLockRejected extends Error {
     readonly details: {
         sessionId: SessionId;
         reason: HandoffLockRejectedReason;
-        runId?: RunId;
+        turnId?: TurnId;
     };
     constructor(details: {
         sessionId: SessionId;
         reason: HandoffLockRejectedReason;
-        runId?: RunId;
+        turnId?: TurnId;
     });
 }
 //# sourceMappingURL=version.d.ts.map

package/dist/session/handoff/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/session/handoff/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,SAAS,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;KACd,CAAA;gBAEW,OAAO,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAO/E;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,cAAc,GAAG,oBAAoB,CAAA;AAE5F;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,SAAS,CAAA;QACpB,MAAM,EAAE,yBAAyB,CAAA;QACjC,KAAK,CAAC,EAAE,KAAK,CAAA;KACb,CAAA;gBAEW,OAAO,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,yBAAyB,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAK/F"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/session/handoff/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAEjE;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,SAAS,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;KACd,CAAA;gBAEW,OAAO,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAO/E;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG,cAAc,GAAG,oBAAoB,CAAA;AAE7F;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE;QACjB,SAAS,EAAE,SAAS,CAAA;QACpB,MAAM,EAAE,yBAAyB,CAAA;QACjC,MAAM,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;gBAEW,OAAO,EAAE;QACpB,SAAS,EAAE,SAAS,CAAA;QACpB,MAAM,EAAE,yBAAyB,CAAA;QACjC,MAAM,CAAC,EAAE,MAAM,CAAA;KACf;CAKD"}

package/dist/session/handoff/version.js

@@ -21,8 +21,8 @@ export class HandoffVersionConflict extends Error {
     }
 }
 /**
- * Raised when a handoff targets a session whose current Run is non-terminal.
- * Callers must wait for the active Run to terminalize (or cancel it) before
+ * Raised when a handoff targets a session whose current turn is non-terminal.
+ * Callers must wait for the active turn to terminalize (or cancel it) before
  * re-attempting the handoff (session-hierarchy.md §5.1).
  */
 export class HandoffLockRejected extends Error {

package/dist/session/handoff/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/session/handoff/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,OAAO,CAIf;IAED,YAAY,OAAmE;QAC9E,KAAK,CACJ,+BAA+B,OAAO,CAAC,SAAS,cAAc,OAAO,CAAC,QAAQ,YAAY,OAAO,CAAC,MAAM,EAAE,CAC1G,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAUD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACpC,OAAO,CAIf;IAED,YAAY,OAAmF;QAC9F,KAAK,CAAC,4BAA4B,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACzE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/session/handoff/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,OAAO,CAIf;IAED,YAAY,OAAmE;QAC9E,KAAK,CACJ,+BAA+B,OAAO,CAAC,SAAS,cAAc,OAAO,CAAC,QAAQ,YAAY,OAAO,CAAC,MAAM,EAAE,CAC1G,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAUD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACpC,OAAO,CAIf;IAED,YAAY,OAIX;QACA,KAAK,CAAC,4BAA4B,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACzE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD"}

package/dist/session/home.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `NAMZU_HOME`: the one user-level home the SDK and the CLI share
+ * (default `~/.namzu`). Session logs live under `projects/<slug>/` inside it;
+ * see `./paths.ts`.
+ */
+export interface ResolveNamzuHomeOptions {
+    /** OS home override for embedding and tests. */
+    readonly home?: string;
+    /** Environment override for embedding and tests. */
+    readonly env?: NodeJS.ProcessEnv;
+}
+export declare class NamzuHomeError extends Error {
+    readonly name = "NamzuHomeError";
+}
+/**
+ * Resolve the user-level Namzu application home without creating it.
+ *
+ * `NAMZU_HOME` is an explicit operator assertion, so it is validated more
+ * strictly than the default: it must already be a real directory and its
+ * canonical identity is returned. The default remains creatable on first use.
+ */
+export declare function resolveNamzuHome(options?: ResolveNamzuHomeOptions): string;
+//# sourceMappingURL=home.d.ts.map

package/dist/session/home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/session/home.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAChC;AAED,qBAAa,cAAe,SAAQ,KAAK;IACxC,SAAkB,IAAI,oBAAmB;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAsC9E"}

package/dist/session/home.js

@@ -0,0 +1,45 @@
+import { lstatSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { parse, resolve } from 'node:path';
+export class NamzuHomeError extends Error {
+    name = 'NamzuHomeError';
+}
+/**
+ * Resolve the user-level Namzu application home without creating it.
+ *
+ * `NAMZU_HOME` is an explicit operator assertion, so it is validated more
+ * strictly than the default: it must already be a real directory and its
+ * canonical identity is returned. The default remains creatable on first use.
+ */
+export function resolveNamzuHome(options = {}) {
+    const env = options.env ?? process.env;
+    const configured = env.NAMZU_HOME;
+    if (configured === undefined || configured.length === 0) {
+        return resolve(options.home ?? homedir(), '.namzu');
+    }
+    if (configured.includes('\0')) {
+        throw new NamzuHomeError('NAMZU_HOME contains a NUL byte and cannot name a directory.');
+    }
+    let entry;
+    try {
+        entry = lstatSync(configured);
+    }
+    catch (error) {
+        throw new NamzuHomeError(`NAMZU_HOME points to ${JSON.stringify(configured)}, but that path cannot be read: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (entry.isSymbolicLink() || !entry.isDirectory()) {
+        throw new NamzuHomeError(`NAMZU_HOME points to ${JSON.stringify(configured)}, but it is not a real directory.`);
+    }
+    let canonical;
+    try {
+        canonical = realpathSync(configured);
+    }
+    catch (error) {
+        throw new NamzuHomeError(`NAMZU_HOME ${JSON.stringify(configured)} could not be canonicalized: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (canonical === parse(canonical).root) {
+        throw new NamzuHomeError(`NAMZU_HOME must not be a filesystem root: ${JSON.stringify(canonical)}. Choose a dedicated directory.`);
+    }
+    return canonical;
+}
+//# sourceMappingURL=home.js.map

package/dist/session/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/session/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAc1C,MAAM,OAAO,cAAe,SAAQ,KAAK;IACtB,IAAI,GAAG,gBAAgB,CAAA;CACzC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAA;IACjC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;IACpD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,cAAc,CAAC,6DAA6D,CAAC,CAAA;IACxF,CAAC;IAED,IAAI,KAAmC,CAAA;IACvC,IAAI,CAAC;QACJ,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,cAAc,CACvB,wBAAwB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7I,CAAA;IACF,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,cAAc,CACvB,wBAAwB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,mCAAmC,CACrF,CAAA;IACF,CAAC;IAED,IAAI,SAAiB,CAAA;IACrB,IAAI,CAAC;QACJ,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,cAAc,CACvB,cAAc,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChI,CAAA;IACF,CAAC;IACD,IAAI,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,cAAc,CACvB,6CAA6C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,iCAAiC,CACvG,CAAA;IACF,CAAC;IACD,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/dist/session/index.d.ts

@@ -5,4 +5,5 @@ export * from './summary/index.js';
 export * from './intervention/index.js';
 export * from './retention/index.js';
 export { TenantIsolationError, WorkspaceBackendError, AncestryCycleError } from './errors.js';
+export { readSessionMessages } from './messages.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAQA,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAQA,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA"}

package/dist/session/index.js

@@ -12,4 +12,5 @@ export * from './summary/index.js';
 export * from './intervention/index.js';
 export * from './retention/index.js';
 export { TenantIsolationError, WorkspaceBackendError, AncestryCycleError } from './errors.js';
+export { readSessionMessages } from './messages.js';
 //# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,2EAA2E;AAC3E,sEAAsE;AACtE,sEAAsE;AACtE,4EAA4E;AAC5E,0EAA0E;AAC1E,mBAAmB;AAEnB,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,2EAA2E;AAC3E,sEAAsE;AACtE,sEAAsE;AACtE,4EAA4E;AAC5E,0EAA0E;AAC1E,mBAAmB;AAEnB,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA"}

package/dist/session/log-hash.d.ts

@@ -0,0 +1,25 @@
+import { type SessionRecord } from '../types/session/records.js';
+/** SHA-256 (lowercase hex) of one complete line, its terminating newline included. */
+export declare function recordSha256(line: string | Uint8Array): string;
+/** Serialise a record as the one line a log stores for it. */
+export declare function formatSessionLogLine(record: SessionRecord): string;
+export type SessionLogLineFault = 'torn' | 'too-large' | 'not-utf8' | 'not-json' | 'not-a-record';
+/** One line that is not a complete, valid record. `fault` says which rule it broke. */
+export declare class SessionLogLineError extends Error {
+    readonly fault: SessionLogLineFault;
+    readonly name = "SessionLogLineError";
+    constructor(fault: SessionLogLineFault, message: string);
+}
+export interface ParsedSessionLogLine {
+    readonly record: SessionRecord;
+    /** Bytes of the line, newline included: the `length` of a pointer to it. */
+    readonly length: number;
+    readonly sha256: string;
+}
+/**
+ * Parse one complete line of a session log: exactly one record followed by
+ * one `\n`. A line with no terminating newline is `torn` (a crash mid-append);
+ * the reader, not this function, decides to truncate it.
+ */
+export declare function parseSessionLogLine(line: string | Uint8Array): ParsedSessionLogLine;
+//# sourceMappingURL=log-hash.d.ts.map

package/dist/session/log-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-hash.d.ts","sourceRoot":"","sources":["../../src/session/log-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,aAAa,EAElB,MAAM,6BAA6B,CAAA;AAoBpC,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE9D;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAUlE;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;AAEjG,uFAAuF;AACvF,qBAAa,mBAAoB,SAAQ,KAAK;IAG5C,QAAQ,CAAC,KAAK,EAAE,mBAAmB;IAFpC,SAAkB,IAAI,yBAAwB;gBAEpC,KAAK,EAAE,mBAAmB,EACnC,OAAO,EAAE,MAAM;CAIhB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,oBAAoB,CA8CnF"}

package/dist/session/log-hash.js

@@ -0,0 +1,82 @@
+import { createHash } from 'node:crypto';
+import { SESSION_RECORD_MAX_BYTES, SessionRecordSchema, } from '../types/session/records.js';
+/**
+ * The byte-level rules of one session-log line, shared by the writer, the
+ * reader and the index.
+ *
+ * A line is one record serialised as JSON and terminated by `\n`. Its hash is
+ * the SHA-256 of exactly those bytes, the newline included, and a record's
+ * `prev` pointer names the previous line by seq, byte offset, byte length and
+ * that hash. Nothing is canonicalised: the bytes on disk are the bytes hashed.
+ */
+const NEWLINE = 0x0a;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder('utf-8', { fatal: true });
+function bytesOf(line) {
+    return typeof line === 'string' ? encoder.encode(line) : line;
+}
+/** SHA-256 (lowercase hex) of one complete line, its terminating newline included. */
+export function recordSha256(line) {
+    return createHash('sha256').update(bytesOf(line)).digest('hex');
+}
+/** Serialise a record as the one line a log stores for it. */
+export function formatSessionLogLine(record) {
+    const line = `${JSON.stringify(record)}\n`;
+    const length = encoder.encode(line).byteLength;
+    if (length > SESSION_RECORD_MAX_BYTES) {
+        throw new SessionLogLineError('too-large', `A ${record.type} record is ${length} bytes; the limit is ${SESSION_RECORD_MAX_BYTES}. Spill the body to tool-results/ first.`);
+    }
+    return line;
+}
+/** One line that is not a complete, valid record. `fault` says which rule it broke. */
+export class SessionLogLineError extends Error {
+    fault;
+    name = 'SessionLogLineError';
+    constructor(fault, message) {
+        super(message);
+        this.fault = fault;
+    }
+}
+/**
+ * Parse one complete line of a session log: exactly one record followed by
+ * one `\n`. A line with no terminating newline is `torn` (a crash mid-append);
+ * the reader, not this function, decides to truncate it.
+ */
+export function parseSessionLogLine(line) {
+    const bytes = bytesOf(line);
+    if (bytes.byteLength > SESSION_RECORD_MAX_BYTES) {
+        throw new SessionLogLineError('too-large', `A session-log line is ${bytes.byteLength} bytes; the limit is ${SESSION_RECORD_MAX_BYTES}.`);
+    }
+    const end = bytes.indexOf(NEWLINE);
+    if (end !== bytes.byteLength - 1) {
+        throw new SessionLogLineError('torn', end === -1
+            ? 'The line has no terminating newline: the record was cut off mid-append.'
+            : 'The line holds more than one record.');
+    }
+    let text;
+    try {
+        text = decoder.decode(bytes.subarray(0, end));
+    }
+    catch {
+        throw new SessionLogLineError('not-utf8', 'The line is not valid UTF-8.');
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new SessionLogLineError('not-json', `The line is not JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = SessionRecordSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new SessionLogLineError('not-a-record', `The line is not a session record: ${parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '(record)'}: ${issue.message}`)
+            .join('; ')}`);
+    }
+    return {
+        record: parsed.data,
+        length: bytes.byteLength,
+        sha256: recordSha256(bytes),
+    };
+}
+//# sourceMappingURL=log-hash.js.map

package/dist/session/log-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-hash.js","sourceRoot":"","sources":["../../src/session/log-hash.ts"],"names":[],"mappings":"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"}

package/dist/session/messages.d.ts

@@ -0,0 +1,11 @@
+import { type SessionLog } from '../store/session-log/index.js';
+import type { TenantId } from '../types/ids/index.js';
+import type { SessionMessage } from '../types/session/messages.js';
+/**
+ * A session's conversation as {@link SessionMessage}s: the fold of its log
+ * (with every `message_replaced` applied), each message carrying the id and
+ * time of its record. A compaction summary message has no record of its own
+ * and carries the compaction's time and no id of its own; it is skipped.
+ */
+export declare function readSessionMessages(log: SessionLog, tenantId: TenantId): Promise<SessionMessage[]>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/session/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/session/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,+BAA+B,CAAA;AAEnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAGlE;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAsB3B"}

package/dist/session/messages.js

@@ -0,0 +1,32 @@
+import { SessionMessageFold } from '../store/session-log/index.js';
+/**
+ * A session's conversation as {@link SessionMessage}s: the fold of its log
+ * (with every `message_replaced` applied), each message carrying the id and
+ * time of its record. A compaction summary message has no record of its own
+ * and carries the compaction's time and no id of its own; it is skipped.
+ */
+export async function readSessionMessages(log, tenantId) {
+    const fold = new SessionMessageFold();
+    const times = new Map();
+    for await (const { record } of log.read()) {
+        times.set(record.seq, record.ts);
+        fold.apply(record);
+    }
+    const out = [];
+    for (const entry of fold.entries()) {
+        if (!entry.messageId)
+            continue;
+        const message = entry.spill
+            ? JSON.parse(await log.readSpill(entry.spill))
+            : entry.message;
+        out.push({
+            id: entry.messageId,
+            sessionId: log.sessionId,
+            tenantId,
+            message,
+            at: new Date(times.get(entry.seq) ?? 0),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=messages.js.map

package/dist/session/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/session/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAOnF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,GAAe,EACf,QAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,kBAAkB,EAAE,CAAA;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,IAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK,CAAC,MAAuB,CAAC,CAAA;IACpC,CAAC;IACD,MAAM,GAAG,GAAqB,EAAE,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAQ;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK;YAC1B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,KAAiB,CAAC,CAAa;YACvE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;QAChB,GAAG,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,KAAK,CAAC,SAAS;YACnB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ;YACR,OAAO;YACP,EAAE,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SACvC,CAAC,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}

package/dist/session/paths.d.ts

@@ -0,0 +1,168 @@
+import type { CheckpointId, GoalId, MessageId, ProjectId, SessionId, TaskId, TurnId } from '../types/ids/index.js';
+/**
+ * The on-disk layout of `NAMZU_HOME`, shared by the SDK and the CLI:
+ *
+ * ```text
+ * $NAMZU_HOME/
+ *   index.sqlite                     rebuildable index over every log
+ *   projects/<slug>/
+ *     project.json                   the project id, minted once
+ *     memory/  residents/  worktrees/<label>/
+ *     <session-id>.jsonl             the session log (source of truth)
+ *     <session-id>/
+ *       subagents/<child-id>.jsonl, <child-id>.meta.json, <child-id>/subagents/…
+ *       tool-results/  checkpoints/  budgets/  tasks/  feedback/  goals/
+ *       file-history/  lease.json
+ * $TMPDIR/namzu-<user>/<slug>/<session-id>/scratchpad/
+ * ```
+ *
+ * Every id that becomes a path segment is checked here, because a brand does
+ * not validate a value read from JSON.
+ */
+/** Names a session in the tree: its id, and its ancestors from the root down (empty for a root session). */
+export interface SessionLocator {
+    readonly sessionId: SessionId;
+    readonly ancestors?: readonly SessionId[];
+}
+/**
+ * The locator a session log's own path spells out: `<session-id>.jsonl` at the
+ * top of a project is a root session, and each `<ancestor-id>/subagents/`
+ * above it names an ancestor, nearest last. `undefined` when the file is not
+ * named `<sessionId>.jsonl`.
+ *
+ * The path alone does not say which project the file is in: a
+ * `<sessionId>.jsonl` kept outside any layout still reads as a root session
+ * here. `resolveSessionStorage` trusts this locator only when the layout it
+ * was given puts that locator's log at this very file.
+ *
+ * A log opened from the index's `logPath` knows only its file; this is how it
+ * finds the same `checkpoints/` (and the rest of its session directory) that
+ * {@link SessionPaths} placed for it.
+ */
+export declare function sessionLocatorFromLogFile(file: string, sessionId: SessionId): SessionLocator | undefined;
+export interface SessionPathsOptions {
+    /** The resolved `NAMZU_HOME` (see `resolveNamzuHome`). */
+    readonly home: string;
+    /** The project's slug, as `ensureProject` returned it. */
+    readonly slug: string;
+    /**
+     * The per-user temporary root (`$TMPDIR/namzu-<user>`). Defaults to
+     * {@link tempRoot}, resolved (and created) the first time `tempDir` is called.
+     */
+    readonly tempRoot?: string;
+}
+/** A path segment that is not an id of the expected kind, or not a safe name. */
+export declare class SessionPathError extends Error {
+    readonly name = "SessionPathError";
+}
+/**
+ * The slug a working directory is filed under: every character outside
+ * `[A-Za-z0-9]` becomes `-`.
+ *
+ * Pass the canonical path (`realpath`); `ensureProject` does. A POSIX
+ * absolute path starts with `/`, so its slug starts with `-`; a Windows path
+ * `C:\…` gives `C-…`; a UNC path gives `--…`. None of these can look like a
+ * UUID, which is how a layout reader tells a slug from a legacy
+ * `projects/<uuid>/` directory. A slug longer than 200 characters keeps its
+ * first 191 and ends in `-` plus 8 hex digits of the path's SHA-256.
+ */
+export declare function slugForCwd(cwd: string): string;
+/** The slug used when `project.json` under the plain slug belongs to a different directory. */
+export declare function hashedSlugForCwd(cwd: string): string;
+export interface EnsureProjectOptions {
+    readonly home: string;
+    readonly cwd: string;
+    /** Clock for `createdAt`; tests pin it. */
+    readonly now?: () => Date;
+}
+export interface EnsuredProject {
+    readonly slug: string;
+    readonly projectId: ProjectId;
+    /** The canonical working directory the project stands for. */
+    readonly cwd: string;
+    readonly projectDir: string;
+    /** True when this call minted `project.json`; false when it adopted an existing one. */
+    readonly created: boolean;
+}
+/** `project.json` exists and cannot be read as a project document. */
+export declare class ProjectDocumentError extends Error {
+    readonly name = "ProjectDocumentError";
+}
+/**
+ * Find or create the project a working directory stands for.
+ *
+ * The directory is canonicalised, slugged, and `projects/<slug>/project.json`
+ * is created exclusively: the document is written complete to a private
+ * temporary file and then hard-linked into place, which fails with `EEXIST`
+ * if another process got there first. So a reader never sees a half-written
+ * document, and of two processes racing, exactly one mints the project id and
+ * the other adopts it. If the existing document names a different directory
+ * (two paths that slug alike), the project moves to the hashed slug.
+ */
+export declare function ensureProject(options: EnsureProjectOptions): Promise<EnsuredProject>;
+export interface TempRootOptions {
+    /** Base directory. Default `os.tmpdir()`. */
+    readonly tmpdir?: string;
+    /** Default `process.platform`. */
+    readonly platform?: NodeJS.Platform;
+    /**
+     * Default `process.getuid`. Pass `undefined` explicitly to model a
+     * platform without it (win32).
+     */
+    readonly getuid?: (() => number) | undefined;
+    /** Default `os.userInfo().username`. */
+    readonly username?: () => string;
+}
+/**
+ * The per-user temporary root, `$TMPDIR/namzu-<user>`, created if missing.
+ *
+ * `<user>` is the numeric uid where the platform has one; otherwise the first
+ * 12 hex digits of the SHA-256 of the user name; otherwise `user`. On POSIX
+ * the directory is created with mode 0700 and refused if it is a symlink, not
+ * a directory, owned by another uid, or open to group or others. On win32
+ * `%TEMP%` is already per user: a symlink or junction is refused and the
+ * owner check is skipped.
+ */
+export declare function tempRoot(options?: TempRootOptions): string;
+/** Every path of one project's layout. Pure: nothing is created or read. */
+export declare class SessionPaths {
+    #private;
+    readonly home: string;
+    readonly slug: string;
+    constructor(options: SessionPathsOptions);
+    /** `$NAMZU_HOME/index.sqlite`. */
+    indexFile(): string;
+    projectDir(): string;
+    projectFile(): string;
+    memoryDir(): string;
+    residentDir(agentKey: string): string;
+    /** The `GitWorktreeManager` default root, or one labelled worktree inside it. */
+    worktrees(label?: string): string;
+    /** `<session-id>.jsonl`, or `…/subagents/<child-id>.jsonl` for a child session. */
+    sessionLog(locator: SessionLocator): string;
+    /** The session's own directory, beside its log. */
+    sessionDir(locator: SessionLocator): string;
+    subagentLog(parent: SessionLocator, childId: SessionId): string;
+    /** `<parent-dir>/subagents/<child-id>.meta.json`. */
+    subagentMeta(parent: SessionLocator, childId: SessionId): string;
+    toolResults(locator: SessionLocator): string;
+    /** A spilled tool result, named by the SHA-256 of its provider tool-use id; the manifest is `<file>.manifest.json`. */
+    toolResultFile(locator: SessionLocator, toolUseId: string): string;
+    checkpoints(locator: SessionLocator): string;
+    checkpointFile(locator: SessionLocator, checkpointId: CheckpointId): string;
+    /** Token ledgers; written for root sessions only. */
+    budgets(locator: SessionLocator): string;
+    budgetFile(locator: SessionLocator, rootTurnId: TurnId): string;
+    tasks(locator: SessionLocator): string;
+    taskFile(locator: SessionLocator, taskId: TaskId): string;
+    feedback(locator: SessionLocator): string;
+    feedbackFile(locator: SessionLocator, messageId: MessageId): string;
+    goals(locator: SessionLocator): string;
+    goalFile(locator: SessionLocator, goalId: GoalId): string;
+    /** File snapshots a CLI `/restore` rolls back to. */
+    fileHistory(locator: SessionLocator): string;
+    lease(locator: SessionLocator): string;
+    /** `$TMPDIR/namzu-<user>/<slug>/<session-id>/scratchpad`. Not created; the per-user root is. */
+    tempDir(sessionId: SessionId): string;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/session/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/session/paths.ts"],"names":[],"mappings":"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"}