@namzu/sdk 43.0.0 → 44.1.0

package/dist/store/memory/memory.js

@@ -1,13 +1,20 @@
 import { assertMemoryStatus } from '../../types/memory/index.js';
 import { generateMemoryId } from '../../utils/id.js';
 import { InMemoryMemoryIndex, searchMemoryEntries } from './index.js';
+import { MemoryNameConflictError, assertOptionalMemoryFields, nameHolder, withOptionalFields, } from './naming.js';
 export class InMemoryMemoryStore {
     content = new Map();
     index = new InMemoryMemoryIndex();
     async create(params) {
+        assertOptionalMemoryFields(params);
+        if (params.name !== undefined) {
+            const holder = nameHolder(this.index.allEntries(), params.name);
+            if (holder)
+                throw new MemoryNameConflictError(params.name, holder.id);
+        }
         const id = generateMemoryId();
         const now = Date.now();
-        const entry = {
+        const entry = withOptionalFields({
             id,
             title: params.title,
             summary: params.summary,
@@ -15,7 +22,7 @@ export class InMemoryMemoryStore {
             status: 'active',
             createdAt: now,
             updatedAt: now,
-        };
+        }, params);
         const memoryContent = {
             id,
             content: params.content,
@@ -37,18 +44,24 @@ export class InMemoryMemoryStore {
     async update(id, updates) {
         if (updates.status !== undefined)
             assertMemoryStatus(updates.status);
+        assertOptionalMemoryFields(updates);
         const existing = this.index.getEntry(id);
         if (!existing)
             return undefined;
+        if (updates.name !== undefined) {
+            const holder = nameHolder(this.index.allEntries(), updates.name, id);
+            if (holder)
+                throw new MemoryNameConflictError(updates.name, holder.id);
+        }
         const now = Date.now();
-        const updated = {
+        const updated = withOptionalFields({
             ...existing,
             title: updates.title ?? existing.title,
             summary: updates.summary ?? existing.summary,
             tags: updates.tags ? [...updates.tags] : existing.tags,
             status: updates.status ?? existing.status,
             updatedAt: now,
-        };
+        }, updates);
         this.index.set(updated);
         if (updates.content !== undefined ||
             updates.format !== undefined ||

package/dist/store/memory/memory.js.map

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

package/dist/store/memory/naming.d.ts

@@ -0,0 +1,66 @@
+import { NamzuError } from '../../types/errors/index.js';
+import type { MemoryId } from '../../types/ids/index.js';
+import type { CreateMemoryParams, MemoryIndexEntry, UpdateMemoryParams } from '../../types/memory/index.js';
+/** A memory name is a file name and a link target, so it is kept to what is safe as both. */
+export declare const MEMORY_NAME_PATTERN: RegExp;
+export declare const MEMORY_NAME_MAX_LENGTH = 64;
+/**
+ * Longest name {@link slugifyMemoryName} derives from a title. Shorter than
+ * {@link MEMORY_NAME_MAX_LENGTH} because the name appears twice in an index
+ * line (`- [name](name.md) — description`) inside a 150-character budget; a
+ * derived name that spends it all leaves the description, the only text a
+ * reader judges relevance by, a few words long.
+ */
+export declare const DERIVED_MEMORY_NAME_MAX_LENGTH = 32;
+/** The index file a one-file-per-memory store generates; never a memory's name. */
+export declare const MEMORY_INDEX_NAME = "MEMORY";
+export declare function isMemoryName(value: unknown): value is string;
+export declare function assertMemoryName(value: unknown): asserts value is string;
+/**
+ * The slug a title becomes. Diacritics are folded, everything else outside
+ * `a-z0-9` is a separator, and the result is cut at a word boundary. A title
+ * with no Latin letters or digits at all becomes `memory-note`, which the
+ * caller then suffixes like any other taken name.
+ */
+export declare function slugifyMemoryName(text: string): string;
+/** `base`, or `base-2`, `base-3`… — the first one nobody holds. */
+export declare function uniqueMemoryName(base: string, taken: ReadonlySet<string>): string;
+/**
+ * A save under a name another memory already holds.
+ *
+ * Refused rather than suffixed because an explicit name is a claim about
+ * WHICH memory this is: two records under one name are the duplicate a
+ * caller should have written as an update. The error names the holder so
+ * the caller can do exactly that.
+ */
+export declare class MemoryNameConflictError extends NamzuError {
+    readonly memoryName: string;
+    readonly existingId: MemoryId;
+    constructor(name: string, existingId: MemoryId);
+}
+/** Why a store refused to write a memory's content. */
+export type MemoryContentRejection = 'too_large' | 'nul_byte';
+/**
+ * A memory the store would write but could not read back.
+ *
+ * Refused before anything is written: a one-file-per-memory store refuses to
+ * load a directory holding a file it cannot read, so writing one would turn
+ * a single bad save into every later operation failing.
+ */
+export declare class MemoryContentRejectedError extends NamzuError {
+    readonly reason: MemoryContentRejection;
+    /** Encoded size of the file that would have been written, when `too_large`. */
+    readonly bytes?: number;
+    readonly limit?: number;
+    constructor(reason: MemoryContentRejection, details?: {
+        readonly bytes?: number;
+        readonly limit?: number;
+    });
+}
+/** Refuse malformed optional fields before a store writes anything. */
+export declare function assertOptionalMemoryFields(params: Pick<CreateMemoryParams, 'name' | 'description' | 'type'>): void;
+/** The holder of `name` other than `self`, if any. */
+export declare function nameHolder(entries: readonly MemoryIndexEntry[], name: string, self?: MemoryId): MemoryIndexEntry | undefined;
+/** Copy the optional typed fields onto an entry, leaving absent ones absent. */
+export declare function withOptionalFields(entry: MemoryIndexEntry, fields: Pick<UpdateMemoryParams, 'name' | 'description' | 'type'>): MemoryIndexEntry;
+//# sourceMappingURL=naming.d.ts.map

package/dist/store/memory/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../src/store/memory/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6BAA6B,CAAA;AAGpC,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAA+B,CAAA;AAC/D,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAChD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,WAAW,CAAA;AAEzC,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAO5D;AAWD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAOxE;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAMjF;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAA;gBAEjB,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ;CAW9C;AAED,uDAAuD;AACvD,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,UAAU,CAAA;AAE7D;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;IACzD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;gBAGtB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;CAgBnE;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,GAC/D,IAAI,CASN;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CACzB,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,QAAQ,GACb,gBAAgB,GAAG,SAAS,CAE9B;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,GAC/D,gBAAgB,CAUlB"}

package/dist/store/memory/naming.js

@@ -0,0 +1,162 @@
+import { NamzuError } from '../../types/errors/index.js';
+import { isMemoryType } from '../../types/memory/index.js';
+/** A memory name is a file name and a link target, so it is kept to what is safe as both. */
+export const MEMORY_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const MEMORY_NAME_MAX_LENGTH = 64;
+/**
+ * Longest name {@link slugifyMemoryName} derives from a title. Shorter than
+ * {@link MEMORY_NAME_MAX_LENGTH} because the name appears twice in an index
+ * line (`- [name](name.md) — description`) inside a 150-character budget; a
+ * derived name that spends it all leaves the description, the only text a
+ * reader judges relevance by, a few words long.
+ */
+export const DERIVED_MEMORY_NAME_MAX_LENGTH = 32;
+/** The index file a one-file-per-memory store generates; never a memory's name. */
+export const MEMORY_INDEX_NAME = 'MEMORY';
+export function isMemoryName(value) {
+    return (typeof value === 'string' &&
+        value.length <= MEMORY_NAME_MAX_LENGTH &&
+        MEMORY_NAME_PATTERN.test(value) &&
+        value.toUpperCase() !== MEMORY_INDEX_NAME);
+}
+function invalidField(field, reason) {
+    throw new NamzuError({
+        code: 'invalid_config',
+        message: `Memory ${field} ${reason}.`,
+        details: { field },
+        retryable: false,
+    });
+}
+export function assertMemoryName(value) {
+    if (!isMemoryName(value)) {
+        invalidField('name', `must be a kebab-case slug of lowercase letters and digits, at most ${MEMORY_NAME_MAX_LENGTH} characters, and not "memory"; got ${JSON.stringify(value)}`);
+    }
+}
+/** Latin letters NFKD leaves whole, because they are letters of their own rather than marked ones. */
+const FOLDS = {
+    ı: 'i',
+    ł: 'l',
+    đ: 'd',
+    ø: 'o',
+    ß: 'ss',
+    æ: 'ae',
+    œ: 'oe',
+};
+/**
+ * The slug a title becomes. Diacritics are folded, everything else outside
+ * `a-z0-9` is a separator, and the result is cut at a word boundary. A title
+ * with no Latin letters or digits at all becomes `memory-note`, which the
+ * caller then suffixes like any other taken name.
+ */
+export function slugifyMemoryName(text) {
+    const slug = text
+        .normalize('NFKD')
+        .replace(/\p{M}/gu, '')
+        .replace(/[ıłđøßæœ]/giu, (letter) => FOLDS[letter.toLowerCase()] ?? letter)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    let cut = slug;
+    if (cut.length > DERIVED_MEMORY_NAME_MAX_LENGTH) {
+        // Cut at the last word boundary that fits, when the slug has one past
+        // its first few characters; a single long word is cut where it is.
+        cut = cut.slice(0, DERIVED_MEMORY_NAME_MAX_LENGTH + 1);
+        const boundary = cut.lastIndexOf('-');
+        cut = boundary > 8 ? cut.slice(0, boundary) : cut.slice(0, DERIVED_MEMORY_NAME_MAX_LENGTH);
+        cut = cut.replace(/-+$/, '');
+    }
+    return isMemoryName(cut) ? cut : 'memory-note';
+}
+/** `base`, or `base-2`, `base-3`… — the first one nobody holds. */
+export function uniqueMemoryName(base, taken) {
+    if (!taken.has(base))
+        return base;
+    for (let n = 2;; n++) {
+        const candidate = `${base}-${n}`;
+        if (!taken.has(candidate))
+            return candidate;
+    }
+}
+/**
+ * A save under a name another memory already holds.
+ *
+ * Refused rather than suffixed because an explicit name is a claim about
+ * WHICH memory this is: two records under one name are the duplicate a
+ * caller should have written as an update. The error names the holder so
+ * the caller can do exactly that.
+ */
+export class MemoryNameConflictError extends NamzuError {
+    memoryName;
+    existingId;
+    constructor(name, existingId) {
+        super({
+            code: 'storage_error',
+            message: `A memory named "${name}" already exists (${existingId}). Update that memory instead of saving a duplicate, or choose a different name.`,
+            details: { name, existingId, reason: 'name_conflict' },
+            retryable: false,
+        });
+        this.name = 'MemoryNameConflictError';
+        this.memoryName = name;
+        this.existingId = existingId;
+    }
+}
+/**
+ * A memory the store would write but could not read back.
+ *
+ * Refused before anything is written: a one-file-per-memory store refuses to
+ * load a directory holding a file it cannot read, so writing one would turn
+ * a single bad save into every later operation failing.
+ */
+export class MemoryContentRejectedError extends NamzuError {
+    reason;
+    /** Encoded size of the file that would have been written, when `too_large`. */
+    bytes;
+    limit;
+    constructor(reason, details = {}) {
+        super({
+            code: 'invalid_config',
+            message: reason === 'too_large'
+                ? `The memory would be ${details.bytes} bytes on disk, over the ${details.limit}-byte limit for one memory. Save the rule or fact and where to find the rest, not the rest itself.`
+                : 'The memory contains a NUL character, which a memory file cannot hold. Remove it and save again.',
+            details: { reason, ...details },
+            retryable: false,
+        });
+        this.name = 'MemoryContentRejectedError';
+        this.reason = reason;
+        if (details.bytes !== undefined)
+            this.bytes = details.bytes;
+        if (details.limit !== undefined)
+            this.limit = details.limit;
+    }
+}
+/** Refuse malformed optional fields before a store writes anything. */
+export function assertOptionalMemoryFields(params) {
+    if (params.name !== undefined)
+        assertMemoryName(params.name);
+    if (params.type !== undefined && !isMemoryType(params.type)) {
+        invalidField('type', 'must be user, feedback, project or reference');
+    }
+    if (params.description !== undefined) {
+        if (typeof params.description !== 'string')
+            invalidField('description', 'must be a string');
+        if (/[\r\n]/.test(params.description))
+            invalidField('description', 'must be a single line');
+    }
+}
+/** The holder of `name` other than `self`, if any. */
+export function nameHolder(entries, name, self) {
+    return entries.find((entry) => entry.name === name && entry.id !== self);
+}
+/** Copy the optional typed fields onto an entry, leaving absent ones absent. */
+export function withOptionalFields(entry, fields) {
+    const name = fields.name ?? entry.name;
+    const description = fields.description ?? entry.description;
+    const type = fields.type ?? entry.type;
+    return {
+        ...entry,
+        ...(name !== undefined ? { name } : {}),
+        ...(description !== undefined ? { description } : {}),
+        ...(type !== undefined ? { type } : {}),
+    };
+}
+//# sourceMappingURL=naming.js.map

package/dist/store/memory/naming.js.map

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

package/dist/store/memory/origin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Who wrote a memory, read from the metadata its writer stamps.
+ *
+ * The generated index a host loads into every prompt lists what someone chose
+ * to remember. A record the runtime derived on its own — the session memory
+ * promoter's account of a turn, a consolidation of a turn's working state — is
+ * written after almost every turn; listing it would change the system prompt nearly
+ * every turn, invalidating the prompt cache from there on, and would push the
+ * operator's own memories out of a capped index. Such records stay in the
+ * store, reachable through recall and search, and never enter the index.
+ */
+/** `metadata.source` of a record the session memory promoter writes. */
+export declare const SESSION_MEMORY_SOURCE = "session-memory";
+/** `metadata.kind` of a record consolidation writes. */
+export declare const CONSOLIDATION_KIND = "consolidation";
+/** `metadata.source` of a record the model saved with `save_memory`. */
+export declare const AGENT_MEMORY_SOURCE = "agent-memory";
+/**
+ * - `derived` — written by the runtime, not chosen by anyone: never indexed.
+ * - `model` — saved by the model with `save_memory`.
+ * - `operator` — everything else: a note, a hand-written file, an import.
+ */
+export type MemoryOrigin = 'derived' | 'model' | 'operator';
+export declare function memoryOrigin(metadata: Readonly<Record<string, unknown>> | undefined): MemoryOrigin;
+//# sourceMappingURL=origin.d.ts.map

package/dist/store/memory/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../../../src/store/memory/origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,mBAAmB,CAAA;AACrD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAEjD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;AAE3D,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACrD,YAAY,CAMd"}

package/dist/store/memory/origin.js

@@ -0,0 +1,26 @@
+/**
+ * Who wrote a memory, read from the metadata its writer stamps.
+ *
+ * The generated index a host loads into every prompt lists what someone chose
+ * to remember. A record the runtime derived on its own — the session memory
+ * promoter's account of a turn, a consolidation of a turn's working state — is
+ * written after almost every turn; listing it would change the system prompt nearly
+ * every turn, invalidating the prompt cache from there on, and would push the
+ * operator's own memories out of a capped index. Such records stay in the
+ * store, reachable through recall and search, and never enter the index.
+ */
+/** `metadata.source` of a record the session memory promoter writes. */
+export const SESSION_MEMORY_SOURCE = 'session-memory';
+/** `metadata.kind` of a record consolidation writes. */
+export const CONSOLIDATION_KIND = 'consolidation';
+/** `metadata.source` of a record the model saved with `save_memory`. */
+export const AGENT_MEMORY_SOURCE = 'agent-memory';
+export function memoryOrigin(metadata) {
+    if (metadata?.source === SESSION_MEMORY_SOURCE || metadata?.kind === CONSOLIDATION_KIND) {
+        return 'derived';
+    }
+    if (metadata?.source === AGENT_MEMORY_SOURCE)
+        return 'model';
+    return 'operator';
+}
+//# sourceMappingURL=origin.js.map

package/dist/store/memory/origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.js","sourceRoot":"","sources":["../../../src/store/memory/origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAA;AACrD,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAA;AACjD,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAA;AASjD,MAAM,UAAU,YAAY,CAC3B,QAAuD;IAEvD,IAAI,QAAQ,EAAE,MAAM,KAAK,qBAAqB,IAAI,QAAQ,EAAE,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACzF,OAAO,SAAS,CAAA;IACjB,CAAC;IACD,IAAI,QAAQ,EAAE,MAAM,KAAK,mBAAmB;QAAE,OAAO,OAAO,CAAA;IAC5D,OAAO,UAAU,CAAA;AAClB,CAAC"}

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

@@ -9,34 +9,37 @@
  *     project.json
  *     sessions/{sessionId}/
  *       session.json
- *       messages.jsonl
+ *       summary.json
  *       subsessions/{subSessionId}/
  *         subsession.json
  *
+ * It holds the session ENTITIES (status, actor, ownership version,
+ * sub-session edges, summaries) and nothing of the conversation. A session's
+ * messages are records in its session log (`SessionLog`,
+ * `~/.namzu/projects/<slug>/<session-id>.jsonl`), read through
+ * `foldSessionMessages` and written only by the turn recorder under the
+ * session lease; listing turns and children across sessions is the
+ * `SessionIndex`. This store no longer writes `messages.jsonl`, and one left
+ * behind by an older build is never read.
+ *
  * Tenant scoping is enforced through the JSON payload (`tenantId` field on
  * every record) rather than the path layout; cross-tenant reads reject with
  * {@link TenantIsolationError} (Convention #17, session-hierarchy.md §12.2).
  *
- * Constructor takes `rootDir`; migration to the canonical `.namzu/projects/`
- * path lives in Phase 7 of the overall roadmap.
+ * Constructor takes `rootDir`. This entity tree is NOT the session layout:
+ * it is keyed by project id, so a `rootDir` equal to `NAMZU_HOME` puts
+ * UUID-named directories under `projects/`, which `namzu state` reports as
+ * legacy. Give it a directory of its own. Moving the entities onto the
+ * session log and index needs record types for session status, ownership
+ * and sub-session edges that the log does not have yet.
  */
-import type { MessageId, SessionId, TenantId } from '../../types/ids/index.js';
-import type { Message } from '../../types/message/index.js';
+import type { SessionId, TenantId } from '../../types/ids/index.js';
 import type { Project, ProjectStatus } from '../../types/project/entity.js';
 import type { Session } from '../../types/session/entity.js';
 import type { ProjectId, SubSessionId, TopicId } from '../../types/session/ids.js';
-import type { SessionMessage } from '../../types/session/messages.js';
 import type { CreateProjectParams, CreateSessionParams, CreateSubSessionParams, ProjectConfigInput, SessionStore, SessionView } from '../../types/session/store.js';
 import type { SubSession } from '../../types/session/sub-session.js';
 import type { SessionSummaryRef } from '../../types/summary/ref.js';
-/**
- * v3 → v4: distinguish ordinary message appends from atomic replacements.
- *
- * The schema migrator runs over every record kind in this store, so the
- * predicate names the fields unique to a message-log line and leaves project,
- * session, sub-session and summary records byte-for-byte alone.
- */
-export declare function migrateSessionStoreMessageRecordKind(record: Record<string, unknown>): Record<string, unknown>;
 /**
  * Validate topic UUIDs before accepting a stored record. Prefixed IDs are
  * rejected without rewriting stored references.
@@ -51,11 +54,10 @@ export declare function migrateSessionStoreTopicIdPrefix(record: Record<string,
  * with this as its data migration.
  *
  * One migration function runs over every kind this schema stamps —
- * project.json, session.json, subsession.json, summary.json, and each
- * `messages.jsonl` line — via the single shared `readJson` / `migrate`
- * call. Only `PersistedSession` ever carried `threadId`; an unconditional
- * rewrite here would stamp `topicId: undefined` onto the other three kinds
- * and onto every message line ever written. Exported, not module-private,
+ * project.json, session.json, subsession.json and summary.json — via the
+ * single shared `readJson` / `migrate` call. Only `PersistedSession` ever
+ * carried `threadId`; an unconditional rewrite here would stamp
+ * `topicId: undefined` onto the other kinds. Exported, not module-private,
  * so that guarantee is unit-testable directly against the function rather
  * than only observable through whichever deserializer happens to forward
  * an extra field today (most of them don't — they map named fields, which
@@ -102,10 +104,6 @@ export declare class DiskSessionStore implements SessionStore {
     getSubSession(subSessionId: SubSessionId, tenantId: TenantId): Promise<SubSession | null>;
     updateSubSession(subSession: SubSession, tenantId: TenantId): Promise<void>;
     deleteSubSession(subSessionId: SubSessionId, tenantId: TenantId): Promise<void>;
-    appendMessage(sessionId: SessionId, message: Message, tenantId: TenantId): Promise<MessageId>;
-    replaceMessages(sessionId: SessionId, messages: readonly Message[], tenantId: TenantId): Promise<void>;
-    loadMessages(sessionId: SessionId, tenantId: TenantId): Promise<readonly Message[]>;
-    loadSessionMessages(sessionId: SessionId, tenantId: TenantId): Promise<readonly SessionMessage[]>;
     getChildren(sessionId: SessionId, tenantId: TenantId): Promise<readonly SubSession[]>;
     getAncestry(sessionId: SessionId, tenantId: TenantId): Promise<readonly SessionId[]>;
     drill(sessionId: SessionId, tenantId: TenantId): Promise<SessionView | null>;
@@ -132,5 +130,4 @@ export declare class DiskSessionStore implements SessionStore {
     private locateSubSession;
     private buildLinkageView;
 }
-export type { SessionMessage } from '../../types/session/messages.js';
 //# sourceMappingURL=disk.d.ts.map

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":"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"}