@namzu/sdk 34.2.0 → 35.0.0

package/dist/store/run/token-budget-disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget-disk.d.ts","sourceRoot":"","sources":["../../../src/store/run/token-budget-disk.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,WAAW,EACX,KAAK,mBAAmB,EAExB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAE9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAA;AAU/F,MAAM,WAAW,0BAA0B;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAGhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;gBAE7B,MAAM,EAAE,0BAA0B;IAE/D,OAAO,CAAC,IAAI;IAKN,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAMlE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAqCnE,IAAI;CAmBlB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC3F"}

package/dist/store/run/token-budget-disk.js

@@ -0,0 +1,208 @@
+import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { TokenBudget, validateTokenBudgetSnapshot, } from '../../run/token-budget.js';
+import { DefaultPathBuilder } from '../../session/workspace/path-builder.js';
+import { temporaryPathFor } from '../../utils/atomic-write.js';
+import { asProjectId, asRunId, asSessionId, asTenantId } from '../../utils/id.js';
+/**
+ * Canonical ledger beside the root run, independent of checkpoint pruning.
+ *
+ * Writes from this instance are serialized and use private atomic sidecars.
+ * New directories are mode 0700 and files are mode 0600. This is a single
+ * writer store; atomic replacement does not provide a distributed lease.
+ */
+export class DiskTokenBudgetStore {
+    config;
+    writes = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    path(scope) {
+        validateScope(scope);
+        return join(this.config.baseDir, scope.runId, 'token-budget.json');
+    }
+    async load(scope) {
+        const path = this.path(scope);
+        await this.writes.get(path);
+        return this.read(path, scope);
+    }
+    async save(scope, snapshot) {
+        const path = this.path(scope);
+        const checkedScope = validateScope(scope);
+        const checkedSnapshot = validateSnapshotScope(snapshot, checkedScope);
+        const previous = this.writes.get(path) ?? Promise.resolve();
+        const writing = previous
+            .catch(() => undefined)
+            .then(async () => {
+            const existing = await this.read(path, checkedScope);
+            if (existing)
+                assertSameRoot(existing, checkedSnapshot);
+            await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+            const temporary = temporaryPathFor(path);
+            const record = {
+                version: 1,
+                scope: checkedScope,
+                snapshot: checkedSnapshot,
+            };
+            try {
+                await writeFile(temporary, `${JSON.stringify(record)}\n`, {
+                    encoding: 'utf8',
+                    flag: 'wx',
+                    mode: 0o600,
+                });
+                await rename(temporary, path);
+            }
+            catch (error) {
+                await unlink(temporary).catch(() => undefined);
+                throw error;
+            }
+        });
+        this.writes.set(path, writing);
+        try {
+            await writing;
+        }
+        finally {
+            if (this.writes.get(path) === writing)
+                this.writes.delete(path);
+        }
+    }
+    async read(path, scope) {
+        let text;
+        try {
+            text = await readFile(path, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+        const raw = JSON.parse(text);
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            throw new Error('Invalid token budget record');
+        }
+        const record = raw;
+        if (record.version !== 1)
+            throw new Error('Unsupported token budget record version');
+        if (!record.scope)
+            throw new Error('Token budget record is missing its root scope');
+        const storedScope = validateScope(record.scope);
+        if (!sameScope(scope, storedScope))
+            throw new Error('Token budget root scope mismatch');
+        return validateSnapshotScope(record.snapshot, scope);
+    }
+}
+/** Open the latest authority; a checkpoint only selects an existing account. */
+export async function openTokenBudget(options) {
+    const scope = validateScope(options.scope);
+    const pathBuilder = options.pathBuilder ??
+        new DefaultPathBuilder(join(options.workingDirectory ?? process.cwd(), '.namzu'));
+    const store = options.store ??
+        new DiskTokenBudgetStore({
+            baseDir: join(pathBuilder.sessionDir(scope.projectId, scope.sessionId), 'runs'),
+        });
+    const persistence = {
+        scope,
+        save: (snapshot) => store.save(scope, snapshot),
+    };
+    const saved = await store.load(scope);
+    let budget;
+    if (saved === null) {
+        if (options.requireExisting || options.accountId !== undefined) {
+            throw new Error('The token budget ledger required by this run is missing');
+        }
+        if (options.limit === undefined)
+            throw new Error('A new token budget requires an explicit limit');
+        budget = TokenBudget.create(options.limit, scope.runId, persistence);
+    }
+    else {
+        const snapshot = validateSnapshotScope(saved, scope);
+        if (options.limit !== undefined && rootLimit(snapshot) !== options.limit) {
+            throw new Error('Token budget root limit mismatch');
+        }
+        budget = TokenBudget.restore(snapshot, persistence);
+    }
+    const account = options.accountId === undefined ? budget : budget.account(options.accountId);
+    await budget.flush();
+    return account;
+}
+function validateScope(scope) {
+    return {
+        tenantId: asTenantId(scope.tenantId),
+        projectId: asProjectId(scope.projectId),
+        sessionId: asSessionId(scope.sessionId),
+        runId: asRunId(scope.runId),
+    };
+}
+function sameScope(left, right) {
+    return (left.tenantId === right.tenantId &&
+        left.projectId === right.projectId &&
+        left.sessionId === right.sessionId &&
+        left.runId === right.runId);
+}
+function validateSnapshotScope(snapshot, scope) {
+    const checked = validateTokenBudgetSnapshot(snapshot);
+    if (checked.rootRunId !== scope.runId)
+        throw new Error('Token budget root run mismatch');
+    return checked;
+}
+function rootLimit(snapshot) {
+    const account = snapshot.accounts.find((account) => account.id === snapshot.rootAccountId);
+    if (!account)
+        throw new Error('Token budget root account is missing');
+    return account.limit;
+}
+function assertSameRoot(before, after) {
+    if (before.rootAccountId !== after.rootAccountId) {
+        throw new Error('Cannot replace an existing token budget with a different root');
+    }
+    const reconciled = before.poisoned && !after.poisoned;
+    if (reconciled && after.requests.length > 0) {
+        throw new Error('Cannot reopen a token budget with unresolved requests');
+    }
+    const accounts = new Map(after.accounts.map((account) => [account.id, account]));
+    for (const previous of before.accounts) {
+        const current = accounts.get(previous.id);
+        if (!current ||
+            (previous.limit > 0 && (current.limit === 0 || current.limit > previous.limit)) ||
+            current.parentId !== previous.parentId ||
+            (previous.runId !== undefined && current.runId !== previous.runId) ||
+            (previous.settled && !current.settled)) {
+            throw new Error('Cannot replace or remove an existing token budget account');
+        }
+        for (const [runId, spent] of Object.entries(previous.usage)) {
+            const recorded = current.usage[runId];
+            if (!usageAtLeast(recorded, spent)) {
+                throw new Error('Cannot reduce recorded token budget usage');
+            }
+        }
+    }
+    const receipts = new Map(after.completedRequests.map((request) => [request.id, request]));
+    for (const previous of before.completedRequests) {
+        const current = receipts.get(previous.id);
+        if (!current ||
+            current.accountId !== previous.accountId ||
+            current.runId !== previous.runId ||
+            !usageAtLeast(current.usage, previous.usage)) {
+            throw new Error('Cannot remove or replace a token budget completion receipt');
+        }
+    }
+    const active = new Map(after.requests.map((request) => [request.id, request]));
+    for (const previous of before.requests) {
+        const current = active.get(previous.id) ?? receipts.get(previous.id);
+        if (!current ||
+            current.accountId !== previous.accountId ||
+            current.runId !== previous.runId ||
+            (reconciled && current.usage === undefined) ||
+            !usageAtLeast(current.usage, previous.usage)) {
+            throw new Error('Cannot forget an unresolved token budget request without a completion receipt');
+        }
+    }
+}
+function usageAtLeast(current, previous) {
+    if (previous === undefined)
+        return true;
+    if (current === undefined)
+        return false;
+    return Object.entries(previous).every(([field, amount]) => typeof amount !== 'number' || (current[field] ?? 0) >= amount);
+}
+//# sourceMappingURL=token-budget-disk.js.map

package/dist/store/run/token-budget-disk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget-disk.js","sourceRoot":"","sources":["../../../src/store/run/token-budget-disk.ts"],"names":[],"mappings":"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"}

package/dist/store/session/disk.d.ts

@@ -38,19 +38,10 @@ import type { SessionSummaryRef } from '../../types/summary/ref.js';
  */
 export declare function migrateSessionStoreMessageRecordKind(record: Record<string, unknown>): Record<string, unknown>;
 /**
- * v2 → v3: NZ-TOPIC-04 narrows the Topic id prefix from `thd_` to `top_`.
- * The FIELD is already `topicId` (the v1→v2 step above handled that); this
- * step rewrites only the VALUE, and only when it still carries the old
- * prefix — a record already at v3, or one that just arrived here via the
- * v1→v2 step in the same `migrate()` call, has `topicId` starting `top_`
- * (or `thd_`, freshly renamed from `threadId` — this step runs on it next
- * in the same pass) either way, and the check below is what makes running
- * it on an already-correct value a same-object no-op rather than a
- * needless copy. Same one-function-runs-over-every-kind shape as its
- * v1→v2 sibling: only `PersistedSession.topicId` is ever `thd_`-prefixed,
- * so every other kind this schema stamps (project.json, subsession.json,
- * summary.json, each messages.jsonl line) has no `topicId` key and comes
- * back untouched.
+ * Validate topic UUIDs before accepting a stored record. Prefixed IDs are
+ * rejected without rewriting stored references.
+ * This migrator runs over every session-store record kind; records without
+ * a topicId are intentionally untouched.
  */
 export declare function migrateSessionStoreTopicIdPrefix(record: Record<string, unknown>): Record<string, unknown>;
 /**

package/dist/store/session/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/session/disk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/session/disk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAa,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EACX,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAEpE,OAAO,KAAK,EAGX,iBAAiB,EACjB,MAAM,4BAA4B,CAAA;AA6CnC;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAuCD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAA;CACf;AAwHD,qBAAa,gBAAiB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG7B;gBAES,MAAM,EAAE,sBAAsB;IAMpC,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAiEtF;;;;OAIG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YAuB5E,cAAc;IAwB5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,uBAAuB;YAUjB,sBAAsB;IAwB9B,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQ7E,aAAa,CAClB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAsBpB,gBAAgB,CACrB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,QAAQ,EAClB,oBAAoB,EAAE,MAAM,GAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAqBpB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IA6B7D,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAkChF,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAS7E,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IA8CtF,qBAAqB,CAC1B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAwBxB,aAAa,CAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,oBAAoB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC;IAkCV,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DtE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCzF,aAAa,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASzF,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3E,gBAAgB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/E,aAAa,CAClB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,CAAC;IA4Bf,eAAe,CACpB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IA0BV,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAKnF,mBAAmB,CACxB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IA4C/B,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAOrF,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;IAOpF,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAalF;;;;;;;;;;;;OAYG;IACG,aAAa,CAClB,OAAO,EAAE,iBAAiB,GAAG;QAAE,cAAc,EAAE,QAAQ,CAAA;KAAE,EACzD,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IA8CV,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAW7F,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,UAAU;YASJ,aAAa;YA8Bb,gBAAgB;YAyChB,gBAAgB;CAoC9B;AAuJD,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/store/session/disk.js

@@ -25,7 +25,7 @@ import { appendFile, mkdir, readFile, rm } from 'node:fs/promises';
 import { join } from 'node:path';
 import { ProjectRootPathTakenError, StaleProjectError, StaleSessionError, TenantIsolationError, } from '../../session/errors.js';
 import { SessionAlreadySummarizedError } from '../../session/summary/errors.js';
-import { generateMessageId, generateProjectId, generateSessionId, generateSubSessionId, } from '../../utils/id.js';
+import { asProjectId, asSessionId, asSubSessionId, asTopicId, generateMessageId, generateProjectId, generateSessionId, generateSubSessionId, isEntityId, } from '../../utils/id.js';
 import { DiskRecordStore } from '../kv/record-store.js';
 import { DiskRevisionRecordStore, } from '../kv/revision-record-store.js';
 // `migrate` and `stamp` are imported directly for the append-only
@@ -90,25 +90,17 @@ export function migrateSessionStoreMessageRecordKind(record) {
 const records = new DiskRecordStore(SCHEMA);
 const rootPathBindings = new DiskRevisionRecordStore(SCHEMA, 'project root-path binding', (record) => record.storageRevision);
 /**
- * v2 → v3: NZ-TOPIC-04 narrows the Topic id prefix from `thd_` to `top_`.
- * The FIELD is already `topicId` (the v1→v2 step above handled that); this
- * step rewrites only the VALUE, and only when it still carries the old
- * prefix — a record already at v3, or one that just arrived here via the
- * v1→v2 step in the same `migrate()` call, has `topicId` starting `top_`
- * (or `thd_`, freshly renamed from `threadId` — this step runs on it next
- * in the same pass) either way, and the check below is what makes running
- * it on an already-correct value a same-object no-op rather than a
- * needless copy. Same one-function-runs-over-every-kind shape as its
- * v1→v2 sibling: only `PersistedSession.topicId` is ever `thd_`-prefixed,
- * so every other kind this schema stamps (project.json, subsession.json,
- * summary.json, each messages.jsonl line) has no `topicId` key and comes
- * back untouched.
+ * Validate topic UUIDs before accepting a stored record. Prefixed IDs are
+ * rejected without rewriting stored references.
+ * This migrator runs over every session-store record kind; records without
+ * a topicId are intentionally untouched.
  */
 export function migrateSessionStoreTopicIdPrefix(record) {
     const topicId = record.topicId;
-    if (typeof topicId !== 'string' || !topicId.startsWith('thd_'))
-        return record;
-    return { ...record, topicId: `top_${topicId.slice('thd_'.length)}` };
+    if (typeof topicId === 'string') {
+        asTopicId(topicId);
+    }
+    return record;
 }
 /**
  * v1 → v2: the FK field `session.json` carries to its owning Topic was
@@ -348,6 +340,8 @@ export class DiskSessionStore {
         const entries = await records.scanNames(projectsRoot, '');
         const found = [];
         for (const entry of entries) {
+            if (!isEntityId(entry, 'project'))
+                continue;
             const raw = await records.read(join(projectsRoot, entry, 'project.json'));
             if (!raw)
                 continue;
@@ -366,13 +360,17 @@ export class DiskSessionStore {
     }
     // Session CRUD ------------------------------------------------------------
     async createSession(params, tenantId) {
+        const id = params.id === undefined ? generateSessionId() : asSessionId(params.id);
         const project = await this.getProject(params.projectId, tenantId);
         if (!project) {
             throw new Error(`Project ${params.projectId} not found`);
         }
         const now = new Date();
+        if (params.id !== undefined && (await this.getSession(id, tenantId))) {
+            throw new Error(`Session ${params.id} already exists`);
+        }
         const session = {
-            id: generateSessionId(),
+            id,
             topicId: params.topicId,
             projectId: params.projectId,
             tenantId,
@@ -427,12 +425,12 @@ export class DiskSessionStore {
         const projectDirs = await records.scanNames(projectsDir, '');
         const results = [];
         for (const rawProject of projectDirs) {
-            if (!rawProject.startsWith('prj_'))
+            if (!isEntityId(rawProject, 'project'))
                 continue;
             const sessionsRoot = join(projectsDir, rawProject, 'sessions');
             const sessionDirs = await records.scanNames(sessionsRoot, '');
             for (const rawSessionId of sessionDirs) {
-                if (!rawSessionId.startsWith('ses_'))
+                if (!isEntityId(rawSessionId, 'session'))
                     continue;
                 const path = join(sessionsRoot, rawSessionId);
                 const raw = await records.read(join(path, 'session.json'));
@@ -462,7 +460,7 @@ export class DiskSessionStore {
         const sessionDirs = await records.scanNames(sessionsRoot, '');
         const results = [];
         for (const rawSessionId of sessionDirs) {
-            if (!rawSessionId.startsWith('ses_'))
+            if (!isEntityId(rawSessionId, 'session'))
                 continue;
             const path = join(sessionsRoot, rawSessionId);
             const raw = await records.read(join(path, 'session.json'));
@@ -521,7 +519,7 @@ export class DiskSessionStore {
         // match the in-memory semantics.
         const subsDir = join(located.path, 'subsessions');
         const subEntries = await records.scanNames(subsDir, '');
-        if (subEntries.some((e) => e.startsWith('sub_'))) {
+        if (subEntries.some((entry) => isEntityId(entry, 'subSession'))) {
             throw new Error(`Session ${sessionId} has attached sub-sessions; delete them before deleting the session`);
         }
         // Also scan tree for sub-session records that reference this session as
@@ -532,17 +530,17 @@ export class DiskSessionStore {
         const projectsDir = join(this.rootDir, 'projects');
         const projectDirs = await records.scanNames(projectsDir, '');
         for (const rawProject of projectDirs) {
-            if (!rawProject.startsWith('prj_'))
+            if (!isEntityId(rawProject, 'project'))
                 continue;
             const sessionsRoot = join(projectsDir, rawProject, 'sessions');
             const siblingSessions = await records.scanNames(sessionsRoot, '');
             for (const rawSib of siblingSessions) {
-                if (!rawSib.startsWith('ses_'))
+                if (!isEntityId(rawSib, 'session'))
                     continue;
                 const sibSubsDir = join(sessionsRoot, rawSib, 'subsessions');
                 const sibSubs = await records.scanNames(sibSubsDir, '');
                 for (const rawSub of sibSubs) {
-                    if (!rawSub.startsWith('sub_'))
+                    if (!isEntityId(rawSub, 'subSession'))
                         continue;
                     const subRaw = await records.read(join(sibSubsDir, rawSub, 'subsession.json'));
                     if (!subRaw)
@@ -823,6 +821,7 @@ export class DiskSessionStore {
         }
     }
     projectDir(projectId) {
+        asProjectId(projectId);
         const cached = this.projectIndex.get(projectId);
         if (cached)
             return cached.path;
@@ -831,6 +830,7 @@ export class DiskSessionStore {
         return path;
     }
     async locateSession(sessionId) {
+        asSessionId(sessionId);
         const cached = this.sessionIndex.get(sessionId);
         if (cached)
             return cached;
@@ -839,13 +839,13 @@ export class DiskSessionStore {
         // same `return null` the old catch took directly.
         const projectDirs = await records.scanNames(projectsDir, '');
         for (const rawId of projectDirs) {
-            if (!rawId.startsWith('prj_'))
+            if (!isEntityId(rawId, 'project'))
                 continue;
             const projectId = rawId;
             const sessionsRoot = join(projectsDir, projectId, 'sessions');
             const sessionDirs = await records.scanNames(sessionsRoot, '');
             for (const rawSessionId of sessionDirs) {
-                if (!rawSessionId.startsWith('ses_'))
+                if (!isEntityId(rawSessionId, 'session'))
                     continue;
                 if (rawSessionId === sessionId) {
                     const entry = {
@@ -861,6 +861,7 @@ export class DiskSessionStore {
         return null;
     }
     async locateSubSession(subSessionId) {
+        asSubSessionId(subSessionId);
         const cached = this.subSessionIndex.get(subSessionId);
         if (cached)
             return cached;
@@ -869,13 +870,13 @@ export class DiskSessionStore {
         // same `return null` the old catch took directly.
         const projectDirs = await records.scanNames(projectsDir, '');
         for (const rawProject of projectDirs) {
-            if (!rawProject.startsWith('prj_'))
+            if (!isEntityId(rawProject, 'project'))
                 continue;
             const projectId = rawProject;
             const sessionsRoot = join(projectsDir, projectId, 'sessions');
             const sessionDirs = await records.scanNames(sessionsRoot, '');
             for (const rawSession of sessionDirs) {
-                if (!rawSession.startsWith('ses_'))
+                if (!isEntityId(rawSession, 'session'))
                     continue;
                 const sessionId = rawSession;
                 const subsDir = join(sessionsRoot, sessionId, 'subsessions');
@@ -905,16 +906,18 @@ export class DiskSessionStore {
         // view the old catch returned directly.
         const projectDirs = await records.scanNames(projectsDir, '');
         for (const rawProject of projectDirs) {
-            if (!rawProject.startsWith('prj_'))
+            if (!isEntityId(rawProject, 'project'))
                 continue;
             const sessionsRoot = join(projectsDir, rawProject, 'sessions');
             const sessionDirs = await records.scanNames(sessionsRoot, '');
             for (const rawSession of sessionDirs) {
-                if (!rawSession.startsWith('ses_'))
+                if (!isEntityId(rawSession, 'session'))
                     continue;
                 const subsRoot = join(sessionsRoot, rawSession, 'subsessions');
                 const subDirs = await records.scanNames(subsRoot, '');
                 for (const rawSub of subDirs) {
+                    if (!isEntityId(rawSub, 'subSession'))
+                        continue;
                     const raw = await records.read(join(subsRoot, rawSub, 'subsession.json'));
                     if (!raw)
                         continue;