@simulacra-ai/session 0.0.2 → 0.0.4

package/dist/index.js

@@ -1,4 +1,575 @@
-export { SessionManager } from "./session-manager.js";
-export { FileSessionStore } from "./file-session-store.js";
-export { InMemorySessionStore } from "./in-memory-session-store.js";
+// src/session-manager.ts
+import { randomUUID } from "crypto";
+import EventEmitter from "events";
+var SessionManager = class _SessionManager {
+  #store;
+  #conversation;
+  #auto_save;
+  #auto_slug;
+  #event_emitter = new EventEmitter();
+  #child_sessions = [];
+  #session_id;
+  #fork_offset = 0;
+  #has_label = false;
+  #disposed = false;
+  /**
+   * Creates a new SessionManager instance.
+   *
+   * @param store - The storage backend to use for persisting sessions.
+   * @param conversation - The conversation instance to manage.
+   * @param options - Optional configuration for session management behavior.
+   */
+  constructor(store, conversation, options) {
+    this.#store = store;
+    this.#conversation = conversation;
+    this.#auto_save = options?.auto_save ?? true;
+    this.#auto_slug = options?.auto_slug ?? true;
+    if (this.#auto_save) {
+      this.#conversation.on("message_complete", this.#on_message_complete);
+    }
+    this.#conversation.on("create_child", this.#on_create_child);
+    this.#conversation.once("dispose", this.#on_conversation_dispose);
+  }
+  /**
+   * The ID of the currently active session.
+   *
+   * @returns The session ID if a session is active, otherwise undefined.
+   */
+  get current_session_id() {
+    return this.#session_id;
+  }
+  /**
+   * Whether a session is currently loaded.
+   *
+   * @returns True if a session is active, false otherwise.
+   */
+  get is_loaded() {
+    return !!this.#session_id;
+  }
+  /**
+   * Disposes of the SessionManager and cleans up resources.
+   *
+   * This method removes event listeners, disposes child sessions, and emits the dispose event.
+   * It is called automatically when the associated conversation is disposed or when using
+   * explicit resource management.
+   */
+  [Symbol.dispose]() {
+    if (this.#disposed) {
+      return;
+    }
+    this.#disposed = true;
+    for (const child of this.#child_sessions) {
+      child[Symbol.dispose]();
+    }
+    this.#child_sessions.length = 0;
+    this.#conversation.off("message_complete", this.#on_message_complete);
+    this.#conversation.off("create_child", this.#on_create_child);
+    this.#conversation.off("dispose", this.#on_conversation_dispose);
+    this.#event_emitter.emit("dispose");
+    this.#event_emitter.removeAllListeners();
+  }
+  /**
+   * Starts a new session with a freshly generated ID.
+   *
+   * This method clears the conversation history and creates a new session. If auto_save
+   * is enabled or a label is provided, the session is immediately saved to the store.
+   *
+   * @param label - Optional label to assign to the new session.
+   * @returns The generated session ID.
+   */
+  start_new(label) {
+    this.#session_id = randomUUID();
+    this.#fork_offset = 0;
+    this.#has_label = !!label;
+    if (this.#conversation.messages.length > 0) {
+      this.#conversation.clear();
+    }
+    if (label || this.#auto_save) {
+      this.save({ label }).catch((error) => {
+        this.#event_emitter.emit("lifecycle_error", {
+          error,
+          operation: "save",
+          context: { session_id: this.#session_id }
+        });
+      });
+    }
+    return this.#session_id;
+  }
+  /**
+   * Creates a new session as a fork of an existing parent session.
+   *
+   * A fork creates a new session that inherits messages from the parent session up to
+   * the fork point. If detached, the fork does not inherit any messages from the parent
+   * but still maintains a parent reference for organizational purposes.
+   *
+   * @param parent_session_id - The ID of the session to fork from.
+   * @param options - Optional configuration for the fork operation.
+   * @param options.detached - Whether to create a detached fork that does not inherit parent messages.
+   * @returns A promise that resolves to the generated session ID for the fork.
+   */
+  async fork(parent_session_id, options) {
+    const detached = options?.detached ?? false;
+    this.#session_id = randomUUID();
+    this.#has_label = false;
+    if (!detached) {
+      this.#conversation.clear();
+    }
+    let fork_message_id;
+    if (!detached) {
+      const messages = await this.#resolve_messages(parent_session_id);
+      if (messages.length > 0) {
+        this.#conversation.load(messages);
+        this.#fork_offset = messages.length;
+        fork_message_id = messages.at(-1)?.id;
+      } else {
+        this.#fork_offset = 0;
+      }
+    } else {
+      this.#fork_offset = 0;
+    }
+    const parent_result = await this.#store.load(parent_session_id);
+    if (parent_result?.metadata.checkpoint_state) {
+      this.#conversation.checkpoint_state = parent_result.metadata.checkpoint_state;
+    }
+    await this.save({
+      parent_id: parent_session_id,
+      fork_message_id,
+      detached
+    });
+    return this.#session_id;
+  }
+  /**
+   * Loads a session by ID or loads the most recent session if no ID is provided.
+   *
+   * If no session ID is provided and no sessions exist in the store, this method
+   * starts a new session automatically. Loading a session resolves its full message
+   * history by recursively following parent references.
+   *
+   * @param id - The ID of the session to load, or undefined to load the most recent session.
+   * @returns A promise that resolves when the session is loaded.
+   * @throws {Error} If the specified session ID is not found in the store.
+   */
+  async load(id) {
+    if (id) {
+      const messages = await this.#resolve_messages(id);
+      const result = await this.#store.load(id);
+      if (!result) {
+        throw new Error(`session not found: ${id}`);
+      }
+      this.#session_id = id;
+      this.#has_label = !!result.metadata.label;
+      this.#conversation.clear();
+      this.#fork_offset = messages.length - result.messages.length;
+      this.#conversation.load(messages);
+      this.#conversation.checkpoint_state = result.metadata.checkpoint_state;
+      this.#emit_load(messages);
+      return;
+    }
+    const sessions = await this.#store.list();
+    if (!sessions.length) {
+      this.start_new();
+      return;
+    }
+    const latest = sessions[0];
+    return this.load(latest.id);
+  }
+  /**
+   * Saves the current session to the store.
+   *
+   * This method persists only the messages owned by this session, excluding any messages
+   * inherited from parent sessions. If auto_slug is enabled and no label has been set,
+   * a label is automatically generated from the first user message.
+   *
+   * @param metadata - Optional partial metadata to update on the session.
+   * @returns A promise that resolves when the save operation is complete.
+   * @throws {Error} If no session is currently active.
+   */
+  async save(metadata) {
+    if (!this.#session_id) {
+      throw new Error("no active session");
+    }
+    const all_messages = this.#conversation.messages;
+    const owned_messages = [...all_messages].slice(this.#fork_offset);
+    if (this.#auto_slug && !metadata?.label && !this.#has_label) {
+      const slug = _SessionManager.#derive_slug(all_messages);
+      if (slug) {
+        metadata = { ...metadata, label: slug };
+        this.#has_label = true;
+      }
+    }
+    const conversation_metadata = { ...metadata };
+    if (this.#conversation.is_checkpoint) {
+      conversation_metadata.is_checkpoint = true;
+    }
+    const checkpoint_state = this.#conversation.checkpoint_state;
+    if (checkpoint_state) {
+      conversation_metadata.checkpoint_state = { ...checkpoint_state };
+    }
+    await this.#store.save(this.#session_id, owned_messages, conversation_metadata);
+    this.#event_emitter.emit("save", {
+      id: this.#session_id,
+      messages: Object.freeze([...all_messages])
+    });
+  }
+  /**
+   * Lists all sessions stored in the store.
+   *
+   * @returns A promise that resolves to an array of session metadata, typically sorted by last update time.
+   */
+  async list() {
+    return this.#store.list();
+  }
+  /**
+   * Deletes a session from the store.
+   *
+   * If the deleted session is currently active, the conversation is cleared and the
+   * current session is unset.
+   *
+   * @param id - The ID of the session to delete.
+   * @returns A promise that resolves to true if the session was deleted, false if it was not found.
+   */
+  async delete(id) {
+    if (id === this.#session_id) {
+      this.#session_id = void 0;
+      this.#conversation.clear();
+    }
+    return this.#store.delete(id);
+  }
+  /**
+   * Renames a session by updating its label.
+   *
+   * @param id - The ID of the session to rename.
+   * @param label - The new label to assign to the session.
+   * @returns A promise that resolves when the rename operation is complete.
+   * @throws {Error} If the specified session ID is not found in the store.
+   */
+  async rename(id, label) {
+    const result = await this.#store.load(id);
+    if (!result) {
+      throw new Error(`session not found: ${id}`);
+    }
+    await this.#store.save(id, result.messages, { label });
+    if (id === this.#session_id) {
+      this.#has_label = true;
+    }
+  }
+  /**
+   * Registers an event listener for the specified event.
+   *
+   * @param event - The name of the event to listen for.
+   * @param listener - The callback function to invoke when the event is emitted.
+   * @returns This SessionManager instance for method chaining.
+   */
+  on(event, listener) {
+    this.#event_emitter.on(event, listener);
+    return this;
+  }
+  /**
+   * Removes an event listener for the specified event.
+   *
+   * @param event - The name of the event to stop listening for.
+   * @param listener - The callback function to remove.
+   * @returns This SessionManager instance for method chaining.
+   */
+  off(event, listener) {
+    this.#event_emitter.off(event, listener);
+    return this;
+  }
+  #emit_load(messages) {
+    this.#event_emitter.emit("load", {
+      id: this.#session_id,
+      messages: Object.freeze([...messages])
+    });
+  }
+  async #resolve_messages(id) {
+    const result = await this.#store.load(id);
+    if (!result) {
+      return [];
+    }
+    const { metadata, messages } = result;
+    if (metadata.parent_id && !metadata.detached) {
+      const parent_messages = await this.#resolve_messages(metadata.parent_id);
+      if (metadata.fork_message_id) {
+        const cut = parent_messages.findIndex((m) => m.id === metadata.fork_message_id);
+        if (cut >= 0) {
+          return [...parent_messages.slice(0, cut + 1), ...messages];
+        }
+      }
+      return [...parent_messages, ...messages];
+    }
+    return messages;
+  }
+  static #derive_slug(messages) {
+    const first_user = messages.find((m) => m.role === "user");
+    if (!first_user) {
+      return void 0;
+    }
+    const text_content = first_user.content.find((c) => c.type === "text");
+    if (!text_content || text_content.type !== "text" || !text_content.text) {
+      return void 0;
+    }
+    const raw = text_content.text.trim();
+    if (!raw) {
+      return void 0;
+    }
+    const truncated = raw.slice(0, 60);
+    const at_boundary = truncated.replace(/\s+\S*$/, "");
+    return (at_boundary || truncated).slice(0, 50);
+  }
+  #on_create_child = (child) => {
+    if (!this.#session_id) {
+      return;
+    }
+    const child_session = new _SessionManager(this.#store, child, {
+      auto_save: this.#auto_save,
+      auto_slug: !child.is_checkpoint && this.#auto_slug
+    });
+    child_session.fork(this.#session_id, { detached: true }).catch((error) => {
+      this.#event_emitter.emit("lifecycle_error", { error, operation: "fork" });
+    });
+    this.#child_sessions.push(child_session);
+    child.once("dispose", () => {
+      child_session[Symbol.dispose]();
+      const idx = this.#child_sessions.indexOf(child_session);
+      if (idx >= 0) {
+        this.#child_sessions.splice(idx, 1);
+      }
+    });
+  };
+  #on_message_complete = () => {
+    if (this.#session_id) {
+      this.save().catch((error) => {
+        this.#event_emitter.emit("lifecycle_error", {
+          error,
+          operation: "save",
+          context: { session_id: this.#session_id }
+        });
+      });
+    }
+  };
+  #on_conversation_dispose = () => this[Symbol.dispose]();
+};
+
+// src/file-session-store.ts
+import fs from "fs/promises";
+import path from "path";
+var FileSessionStore = class {
+  #root;
+  /**
+   * Creates a new FileSessionStore instance.
+   *
+   * @param root - The absolute path to the directory where session files will be stored.
+   */
+  constructor(root) {
+    this.#root = root;
+  }
+  /**
+   * Lists all sessions stored in the file system.
+   *
+   * Reads all JSON files from the root directory and parses their metadata.
+   *
+   * @returns A promise that resolves to an array of session metadata, sorted by most recently updated first.
+   */
+  async list() {
+    await this.#ensure_dir();
+    const sessions = [];
+    const entries = await fs.readdir(this.#root, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".json")) {
+        continue;
+      }
+      const session = await this.#read_session(
+        path.join(this.#root, entry.name),
+        entry.name.replace(/\.json$/, "")
+      );
+      if (session) {
+        sessions.push(session);
+      }
+    }
+    return sessions.sort((a, b) => b.updated_at.localeCompare(a.updated_at));
+  }
+  /**
+   * Loads a session from the file system.
+   *
+   * @param id - The unique identifier of the session to load.
+   * @returns A promise that resolves to the session metadata and messages, or undefined if not found.
+   */
+  async load(id) {
+    return this.#read_file(path.join(this.#root, `${id}.json`), id);
+  }
+  /**
+   * Saves a session to the file system.
+   *
+   * Creates a new session file if the ID does not exist, or updates an existing file.
+   * Automatically updates the updated_at timestamp and message_count. If the session
+   * has a parent, creates a hard link in the parent's fork directory for efficient querying.
+   *
+   * @param id - The unique identifier of the session.
+   * @param messages - The messages to store for this session.
+   * @param metadata - Optional partial metadata to merge with existing metadata.
+   * @returns A promise that resolves when the save operation is complete.
+   */
+  async save(id, messages, metadata) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    await this.#ensure_dir();
+    const file_path = path.join(this.#root, `${id}.json`);
+    const existing = await this.#read_file(file_path, id);
+    const existing_metadata = existing?.metadata ?? {};
+    const parent_id = metadata?.parent_id ?? existing_metadata.parent_id;
+    const file = {
+      metadata: {
+        ...existing_metadata,
+        created_at: existing_metadata.created_at ?? now,
+        updated_at: now,
+        message_count: messages.length,
+        ...metadata
+      },
+      messages
+    };
+    await fs.writeFile(file_path, JSON.stringify(file, null, 2), "utf8");
+    if (parent_id) {
+      await this.#ensure_fork_link(parent_id, id);
+    }
+  }
+  /**
+   * Deletes a session from the file system.
+   *
+   * Removes the session file, any hard links in parent fork directories, and the session's
+   * own fork directory if it exists.
+   *
+   * @param id - The unique identifier of the session to delete.
+   * @returns A promise that resolves to true if the session was deleted, false if it was not found.
+   */
+  async delete(id) {
+    const file_path = path.join(this.#root, `${id}.json`);
+    try {
+      const result = await this.#read_file(file_path, id);
+      await fs.unlink(file_path);
+      if (result?.metadata.parent_id) {
+        const link = path.join(this.#root, `${result.metadata.parent_id}-forks`, `${id}.json`);
+        try {
+          await fs.unlink(link);
+        } catch {
+        }
+      }
+      const fork_dir = path.join(this.#root, `${id}-forks`);
+      try {
+        await fs.rm(fork_dir, { recursive: true });
+      } catch {
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async #ensure_fork_link(parent_id, fork_id) {
+    const fork_dir = path.join(this.#root, `${parent_id}-forks`);
+    await fs.mkdir(fork_dir, { recursive: true });
+    const canonical = path.join(this.#root, `${fork_id}.json`);
+    const link = path.join(fork_dir, `${fork_id}.json`);
+    try {
+      await fs.unlink(link);
+    } catch {
+    }
+    try {
+      await fs.link(canonical, link);
+    } catch {
+    }
+  }
+  async #read_file(file_path, id) {
+    try {
+      const content = await fs.readFile(file_path, "utf8");
+      const data = JSON.parse(content);
+      return {
+        metadata: { id, ...data.metadata },
+        messages: data.messages
+      };
+    } catch {
+      return void 0;
+    }
+  }
+  async #read_session(file_path, id) {
+    try {
+      const content = await fs.readFile(file_path, "utf8");
+      const data = JSON.parse(content);
+      return { id, ...data.metadata };
+    } catch {
+      return void 0;
+    }
+  }
+  async #ensure_dir() {
+    await fs.mkdir(this.#root, { recursive: true });
+  }
+};
+
+// src/in-memory-session-store.ts
+var InMemorySessionStore = class {
+  #sessions = /* @__PURE__ */ new Map();
+  /**
+   * Lists all sessions stored in memory.
+   *
+   * @returns A promise that resolves to an array of session metadata, sorted by most recently updated first.
+   */
+  async list() {
+    return [...this.#sessions.values()].map((s) => s.metadata).sort((a, b) => b.updated_at.localeCompare(a.updated_at));
+  }
+  /**
+   * Loads a session from memory.
+   *
+   * Returns a deep clone of the stored data to prevent external mutations.
+   *
+   * @param id - The unique identifier of the session to load.
+   * @returns A promise that resolves to the session metadata and messages, or undefined if not found.
+   */
+  async load(id) {
+    const entry = this.#sessions.get(id);
+    if (!entry) {
+      return void 0;
+    }
+    return {
+      metadata: { ...entry.metadata },
+      messages: structuredClone(entry.messages)
+    };
+  }
+  /**
+   * Saves a session to memory.
+   *
+   * Creates a new session if the ID does not exist, or updates an existing session.
+   * Automatically updates the updated_at timestamp and message_count.
+   *
+   * @param id - The unique identifier of the session.
+   * @param messages - The messages to store for this session.
+   * @param metadata - Optional partial metadata to merge with existing metadata.
+   * @returns A promise that resolves when the save operation is complete.
+   */
+  async save(id, messages, metadata) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const existing = this.#sessions.get(id);
+    this.#sessions.set(id, {
+      metadata: {
+        id,
+        ...existing?.metadata,
+        created_at: existing?.metadata.created_at ?? now,
+        updated_at: now,
+        message_count: messages.length,
+        ...metadata
+      },
+      messages: structuredClone(messages)
+    });
+  }
+  /**
+   * Deletes a session from memory.
+   *
+   * @param id - The unique identifier of the session to delete.
+   * @returns A promise that resolves to true if the session was deleted, false if it was not found.
+   */
+  async delete(id) {
+    return this.#sessions.delete(id);
+  }
+};
+export {
+  FileSessionStore,
+  InMemorySessionStore,
+  SessionManager
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"sources":["../src/session-manager.ts","../src/file-session-store.ts","../src/in-memory-session-store.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport EventEmitter from \"node:events\";\nimport type { Conversation, Message } from \"@simulacra-ai/core\";\nimport type {\n  SessionMetadata,\n  SessionStore,\n  SessionManagerOptions,\n  SessionManagerEvents,\n} from \"./types.ts\";\n\n/**\n * Manages conversation sessions including creation, loading, saving, and forking.\n *\n * The SessionManager acts as a bridge between a Conversation instance and a SessionStore,\n * handling session lifecycle, automatic saving, and session tree management through forking.\n * It supports disposable resource management and event emission for session operations.\n */\nexport class SessionManager {\n  readonly #store: SessionStore;\n  readonly #conversation: Conversation;\n  readonly #auto_save: boolean;\n  readonly #auto_slug: boolean;\n  readonly #event_emitter = new EventEmitter<SessionManagerEvents>();\n  readonly #child_sessions: SessionManager[] = [];\n\n  #session_id?: string;\n  #fork_offset = 0;\n  #has_label = false;\n  #disposed = false;\n\n  /**\n   * Creates a new SessionManager instance.\n   *\n   * @param store - The storage backend to use for persisting sessions.\n   * @param conversation - The conversation instance to manage.\n   * @param options - Optional configuration for session management behavior.\n   */\n  constructor(store: SessionStore, conversation: Conversation, options?: SessionManagerOptions) {\n    this.#store = store;\n    this.#conversation = conversation;\n    this.#auto_save = options?.auto_save ?? true;\n    this.#auto_slug = options?.auto_slug ?? true;\n\n    if (this.#auto_save) {\n      this.#conversation.on(\"message_complete\", this.#on_message_complete);\n    }\n    this.#conversation.on(\"create_child\", this.#on_create_child);\n    this.#conversation.once(\"dispose\", this.#on_conversation_dispose);\n  }\n\n  /**\n   * The ID of the currently active session.\n   *\n   * @returns The session ID if a session is active, otherwise undefined.\n   */\n  get current_session_id() {\n    return this.#session_id;\n  }\n\n  /**\n   * Whether a session is currently loaded.\n   *\n   * @returns True if a session is active, false otherwise.\n   */\n  get is_loaded() {\n    return !!this.#session_id;\n  }\n\n  /**\n   * Disposes of the SessionManager and cleans up resources.\n   *\n   * This method removes event listeners, disposes child sessions, and emits the dispose event.\n   * It is called automatically when the associated conversation is disposed or when using\n   * explicit resource management.\n   */\n  [Symbol.dispose]() {\n    if (this.#disposed) {\n      return;\n    }\n    this.#disposed = true;\n\n    for (const child of this.#child_sessions) {\n      child[Symbol.dispose]();\n    }\n    this.#child_sessions.length = 0;\n\n    this.#conversation.off(\"message_complete\", this.#on_message_complete);\n    this.#conversation.off(\"create_child\", this.#on_create_child);\n    this.#conversation.off(\"dispose\", this.#on_conversation_dispose);\n    this.#event_emitter.emit(\"dispose\");\n    this.#event_emitter.removeAllListeners();\n  }\n\n  /**\n   * Starts a new session with a freshly generated ID.\n   *\n   * This method clears the conversation history and creates a new session. If auto_save\n   * is enabled or a label is provided, the session is immediately saved to the store.\n   *\n   * @param label - Optional label to assign to the new session.\n   * @returns The generated session ID.\n   */\n  start_new(label?: string): string {\n    this.#session_id = randomUUID();\n    this.#fork_offset = 0;\n    this.#has_label = !!label;\n    if (this.#conversation.messages.length > 0) {\n      this.#conversation.clear();\n    }\n    if (label || this.#auto_save) {\n      this.save({ label }).catch((error) => {\n        this.#event_emitter.emit(\"lifecycle_error\", {\n          error,\n          operation: \"save\",\n          context: { session_id: this.#session_id },\n        });\n      });\n    }\n    return this.#session_id;\n  }\n\n  /**\n   * Creates a new session as a fork of an existing parent session.\n   *\n   * A fork creates a new session that inherits messages from the parent session up to\n   * the fork point. If detached, the fork does not inherit any messages from the parent\n   * but still maintains a parent reference for organizational purposes.\n   *\n   * @param parent_session_id - The ID of the session to fork from.\n   * @param options - Optional configuration for the fork operation.\n   * @param options.detached - Whether to create a detached fork that does not inherit parent messages.\n   * @returns A promise that resolves to the generated session ID for the fork.\n   */\n  async fork(parent_session_id: string, options?: { detached?: boolean }): Promise<string> {\n    const detached = options?.detached ?? false;\n    this.#session_id = randomUUID();\n    this.#has_label = false;\n    if (!detached) {\n      this.#conversation.clear();\n    }\n\n    let fork_message_id: string | undefined;\n\n    if (!detached) {\n      const messages = await this.#resolve_messages(parent_session_id);\n      if (messages.length > 0) {\n        this.#conversation.load(messages);\n        this.#fork_offset = messages.length;\n        fork_message_id = messages.at(-1)?.id;\n      } else {\n        this.#fork_offset = 0;\n      }\n    } else {\n      this.#fork_offset = 0;\n    }\n\n    const parent_result = await this.#store.load(parent_session_id);\n    if (parent_result?.metadata.checkpoint_state) {\n      this.#conversation.checkpoint_state = parent_result.metadata.checkpoint_state;\n    }\n\n    await this.save({\n      parent_id: parent_session_id,\n      fork_message_id,\n      detached,\n    });\n\n    return this.#session_id;\n  }\n\n  /**\n   * Loads a session by ID or loads the most recent session if no ID is provided.\n   *\n   * If no session ID is provided and no sessions exist in the store, this method\n   * starts a new session automatically. Loading a session resolves its full message\n   * history by recursively following parent references.\n   *\n   * @param id - The ID of the session to load, or undefined to load the most recent session.\n   * @returns A promise that resolves when the session is loaded.\n   * @throws {Error} If the specified session ID is not found in the store.\n   */\n  async load(id?: string): Promise<void> {\n    if (id) {\n      const messages = await this.#resolve_messages(id);\n      const result = await this.#store.load(id);\n      if (!result) {\n        throw new Error(`session not found: ${id}`);\n      }\n      this.#session_id = id;\n      this.#has_label = !!result.metadata.label;\n      this.#conversation.clear();\n      this.#fork_offset = messages.length - result.messages.length;\n      this.#conversation.load(messages);\n      this.#conversation.checkpoint_state = result.metadata.checkpoint_state;\n      this.#emit_load(messages);\n      return;\n    }\n\n    const sessions = await this.#store.list();\n    if (!sessions.length) {\n      this.start_new();\n      return;\n    }\n\n    const latest = sessions[0];\n    return this.load(latest.id);\n  }\n\n  /**\n   * Saves the current session to the store.\n   *\n   * This method persists only the messages owned by this session, excluding any messages\n   * inherited from parent sessions. If auto_slug is enabled and no label has been set,\n   * a label is automatically generated from the first user message.\n   *\n   * @param metadata - Optional partial metadata to update on the session.\n   * @returns A promise that resolves when the save operation is complete.\n   * @throws {Error} If no session is currently active.\n   */\n  async save(\n    metadata?: Partial<\n      Pick<\n        SessionMetadata,\n        \"label\" | \"provider\" | \"model\" | \"parent_id\" | \"fork_message_id\" | \"detached\"\n      >\n    >,\n  ) {\n    if (!this.#session_id) {\n      throw new Error(\"no active session\");\n    }\n    const all_messages = this.#conversation.messages;\n    const owned_messages = [...all_messages].slice(this.#fork_offset);\n\n    if (this.#auto_slug && !metadata?.label && !this.#has_label) {\n      const slug = SessionManager.#derive_slug(all_messages);\n      if (slug) {\n        metadata = { ...metadata, label: slug };\n        this.#has_label = true;\n      }\n    }\n\n    const conversation_metadata: Partial<SessionMetadata> = { ...metadata };\n    if (this.#conversation.is_checkpoint) {\n      conversation_metadata.is_checkpoint = true;\n    }\n    const checkpoint_state = this.#conversation.checkpoint_state;\n    if (checkpoint_state) {\n      conversation_metadata.checkpoint_state = { ...checkpoint_state };\n    }\n\n    await this.#store.save(this.#session_id, owned_messages, conversation_metadata);\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#event_emitter as any).emit(\"save\", {\n      id: this.#session_id,\n      messages: Object.freeze([...all_messages]),\n    });\n  }\n\n  /**\n   * Lists all sessions stored in the store.\n   *\n   * @returns A promise that resolves to an array of session metadata, typically sorted by last update time.\n   */\n  async list() {\n    return this.#store.list();\n  }\n\n  /**\n   * Deletes a session from the store.\n   *\n   * If the deleted session is currently active, the conversation is cleared and the\n   * current session is unset.\n   *\n   * @param id - The ID of the session to delete.\n   * @returns A promise that resolves to true if the session was deleted, false if it was not found.\n   */\n  async delete(id: string) {\n    if (id === this.#session_id) {\n      this.#session_id = undefined;\n      this.#conversation.clear();\n    }\n    return this.#store.delete(id);\n  }\n\n  /**\n   * Renames a session by updating its label.\n   *\n   * @param id - The ID of the session to rename.\n   * @param label - The new label to assign to the session.\n   * @returns A promise that resolves when the rename operation is complete.\n   * @throws {Error} If the specified session ID is not found in the store.\n   */\n  async rename(id: string, label: string) {\n    const result = await this.#store.load(id);\n    if (!result) {\n      throw new Error(`session not found: ${id}`);\n    }\n    await this.#store.save(id, result.messages, { label });\n    if (id === this.#session_id) {\n      this.#has_label = true;\n    }\n  }\n\n  /**\n   * Registers an event listener for the specified event.\n   *\n   * @param event - The name of the event to listen for.\n   * @param listener - The callback function to invoke when the event is emitted.\n   * @returns This SessionManager instance for method chaining.\n   */\n  on<E extends keyof SessionManagerEvents>(\n    event: E,\n    listener: (...args: SessionManagerEvents[E]) => void,\n  ): this {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#event_emitter as any).on(event, listener);\n    return this;\n  }\n\n  /**\n   * Removes an event listener for the specified event.\n   *\n   * @param event - The name of the event to stop listening for.\n   * @param listener - The callback function to remove.\n   * @returns This SessionManager instance for method chaining.\n   */\n  off<E extends keyof SessionManagerEvents>(\n    event: E,\n    listener: (...args: SessionManagerEvents[E]) => void,\n  ): this {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#event_emitter as any).off(event, listener);\n    return this;\n  }\n\n  #emit_load(messages: Readonly<Message[]>) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#event_emitter as any).emit(\"load\", {\n      id: this.#session_id,\n      messages: Object.freeze([...messages]),\n    });\n  }\n\n  async #resolve_messages(id: string): Promise<Message[]> {\n    const result = await this.#store.load(id);\n    if (!result) {\n      return [];\n    }\n\n    const { metadata, messages } = result;\n\n    if (metadata.parent_id && !metadata.detached) {\n      const parent_messages = await this.#resolve_messages(metadata.parent_id);\n      if (metadata.fork_message_id) {\n        const cut = parent_messages.findIndex((m) => m.id === metadata.fork_message_id);\n        if (cut >= 0) {\n          return [...parent_messages.slice(0, cut + 1), ...messages];\n        }\n      }\n      return [...parent_messages, ...messages];\n    }\n\n    return messages;\n  }\n\n  static #derive_slug(messages: readonly Readonly<Message>[]): string | undefined {\n    const first_user = messages.find((m) => m.role === \"user\");\n    if (!first_user) {\n      return undefined;\n    }\n\n    const text_content = first_user.content.find((c) => c.type === \"text\");\n    if (!text_content || text_content.type !== \"text\" || !text_content.text) {\n      return undefined;\n    }\n\n    const raw = text_content.text.trim();\n    if (!raw) {\n      return undefined;\n    }\n\n    const truncated = raw.slice(0, 60);\n    const at_boundary = truncated.replace(/\\s+\\S*$/, \"\");\n    return (at_boundary || truncated).slice(0, 50);\n  }\n\n  #on_create_child = (child: Conversation) => {\n    if (!this.#session_id) {\n      return;\n    }\n\n    const child_session = new SessionManager(this.#store, child, {\n      auto_save: this.#auto_save,\n      auto_slug: !child.is_checkpoint && this.#auto_slug,\n    });\n    child_session.fork(this.#session_id, { detached: true }).catch((error) => {\n      this.#event_emitter.emit(\"lifecycle_error\", { error, operation: \"fork\" });\n    });\n    this.#child_sessions.push(child_session);\n\n    child.once(\"dispose\", () => {\n      child_session[Symbol.dispose]();\n      const idx = this.#child_sessions.indexOf(child_session);\n      if (idx >= 0) {\n        this.#child_sessions.splice(idx, 1);\n      }\n    });\n  };\n\n  #on_message_complete = () => {\n    if (this.#session_id) {\n      this.save().catch((error) => {\n        this.#event_emitter.emit(\"lifecycle_error\", {\n          error,\n          operation: \"save\",\n          context: { session_id: this.#session_id },\n        });\n      });\n    }\n  };\n\n  #on_conversation_dispose = () => this[Symbol.dispose]();\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Message } from \"@simulacra-ai/core\";\nimport type { SessionMetadata, SessionStore } from \"./types.ts\";\n\ninterface SessionFile {\n  metadata: Omit<SessionMetadata, \"id\">;\n  messages: Message[];\n}\n\n/**\n * A file-based implementation of SessionStore.\n *\n * This store persists sessions as JSON files in a specified directory. Each session\n * is stored in a separate file named with its session ID. The store also maintains\n * hard links for fork relationships to enable efficient querying of session trees.\n */\nexport class FileSessionStore implements SessionStore {\n  readonly #root: string;\n\n  /**\n   * Creates a new FileSessionStore instance.\n   *\n   * @param root - The absolute path to the directory where session files will be stored.\n   */\n  constructor(root: string) {\n    this.#root = root;\n  }\n\n  /**\n   * Lists all sessions stored in the file system.\n   *\n   * Reads all JSON files from the root directory and parses their metadata.\n   *\n   * @returns A promise that resolves to an array of session metadata, sorted by most recently updated first.\n   */\n  async list(): Promise<SessionMetadata[]> {\n    await this.#ensure_dir();\n    const sessions: SessionMetadata[] = [];\n\n    const entries = await fs.readdir(this.#root, { withFileTypes: true });\n    for (const entry of entries) {\n      if (!entry.isFile() || !entry.name.endsWith(\".json\")) {\n        continue;\n      }\n      const session = await this.#read_session(\n        path.join(this.#root, entry.name),\n        entry.name.replace(/\\.json$/, \"\"),\n      );\n      if (session) {\n        sessions.push(session);\n      }\n    }\n\n    return sessions.sort((a, b) => b.updated_at.localeCompare(a.updated_at));\n  }\n\n  /**\n   * Loads a session from the file system.\n   *\n   * @param id - The unique identifier of the session to load.\n   * @returns A promise that resolves to the session metadata and messages, or undefined if not found.\n   */\n  async load(id: string) {\n    return this.#read_file(path.join(this.#root, `${id}.json`), id);\n  }\n\n  /**\n   * Saves a session to the file system.\n   *\n   * Creates a new session file if the ID does not exist, or updates an existing file.\n   * Automatically updates the updated_at timestamp and message_count. If the session\n   * has a parent, creates a hard link in the parent's fork directory for efficient querying.\n   *\n   * @param id - The unique identifier of the session.\n   * @param messages - The messages to store for this session.\n   * @param metadata - Optional partial metadata to merge with existing metadata.\n   * @returns A promise that resolves when the save operation is complete.\n   */\n  async save(id: string, messages: Message[], metadata?: Partial<SessionMetadata>) {\n    const now = new Date().toISOString();\n    await this.#ensure_dir();\n\n    const file_path = path.join(this.#root, `${id}.json`);\n    const existing = await this.#read_file(file_path, id);\n    const existing_metadata: Partial<SessionMetadata> = existing?.metadata ?? {};\n    const parent_id = metadata?.parent_id ?? existing_metadata.parent_id;\n\n    const file: SessionFile = {\n      metadata: {\n        ...existing_metadata,\n        created_at: existing_metadata.created_at ?? now,\n        updated_at: now,\n        message_count: messages.length,\n        ...metadata,\n      },\n      messages,\n    };\n\n    await fs.writeFile(file_path, JSON.stringify(file, null, 2), \"utf8\");\n\n    if (parent_id) {\n      await this.#ensure_fork_link(parent_id, id);\n    }\n  }\n\n  /**\n   * Deletes a session from the file system.\n   *\n   * Removes the session file, any hard links in parent fork directories, and the session's\n   * own fork directory if it exists.\n   *\n   * @param id - The unique identifier of the session to delete.\n   * @returns A promise that resolves to true if the session was deleted, false if it was not found.\n   */\n  async delete(id: string) {\n    const file_path = path.join(this.#root, `${id}.json`);\n    try {\n      const result = await this.#read_file(file_path, id);\n      await fs.unlink(file_path);\n\n      if (result?.metadata.parent_id) {\n        const link = path.join(this.#root, `${result.metadata.parent_id}-forks`, `${id}.json`);\n        try {\n          await fs.unlink(link);\n        } catch {\n          /* link may not exist */\n        }\n      }\n\n      const fork_dir = path.join(this.#root, `${id}-forks`);\n      try {\n        await fs.rm(fork_dir, { recursive: true });\n      } catch {\n        /* no forks */\n      }\n\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async #ensure_fork_link(parent_id: string, fork_id: string) {\n    const fork_dir = path.join(this.#root, `${parent_id}-forks`);\n    await fs.mkdir(fork_dir, { recursive: true });\n\n    const canonical = path.join(this.#root, `${fork_id}.json`);\n    const link = path.join(fork_dir, `${fork_id}.json`);\n\n    try {\n      await fs.unlink(link);\n    } catch {\n      /* doesn't exist yet */\n    }\n\n    try {\n      await fs.link(canonical, link);\n    } catch {\n      // hard links can fail across filesystems — fall back to no index\n    }\n  }\n\n  async #read_file(file_path: string, id: string) {\n    try {\n      const content = await fs.readFile(file_path, \"utf8\");\n      const data: SessionFile = JSON.parse(content);\n      return {\n        metadata: { id, ...data.metadata } as SessionMetadata,\n        messages: data.messages,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  async #read_session(file_path: string, id: string): Promise<SessionMetadata | undefined> {\n    try {\n      const content = await fs.readFile(file_path, \"utf8\");\n      const data: SessionFile = JSON.parse(content);\n      return { id, ...data.metadata };\n    } catch {\n      return undefined;\n    }\n  }\n\n  async #ensure_dir() {\n    await fs.mkdir(this.#root, { recursive: true });\n  }\n}\n","import type { Message } from \"@simulacra-ai/core\";\nimport type { SessionMetadata, SessionStore } from \"./types.ts\";\n\n/**\n * An in-memory implementation of SessionStore.\n *\n * This store keeps all session data in memory using a Map. Data is not persisted\n * across process restarts. Useful for testing or scenarios where persistence is not required.\n */\nexport class InMemorySessionStore implements SessionStore {\n  readonly #sessions = new Map<string, { metadata: SessionMetadata; messages: Message[] }>();\n\n  /**\n   * Lists all sessions stored in memory.\n   *\n   * @returns A promise that resolves to an array of session metadata, sorted by most recently updated first.\n   */\n  async list(): Promise<SessionMetadata[]> {\n    return [...this.#sessions.values()]\n      .map((s) => s.metadata)\n      .sort((a, b) => b.updated_at.localeCompare(a.updated_at));\n  }\n\n  /**\n   * Loads a session from memory.\n   *\n   * Returns a deep clone of the stored data to prevent external mutations.\n   *\n   * @param id - The unique identifier of the session to load.\n   * @returns A promise that resolves to the session metadata and messages, or undefined if not found.\n   */\n  async load(id: string) {\n    const entry = this.#sessions.get(id);\n    if (!entry) {\n      return undefined;\n    }\n    return {\n      metadata: { ...entry.metadata },\n      messages: structuredClone(entry.messages),\n    };\n  }\n\n  /**\n   * Saves a session to memory.\n   *\n   * Creates a new session if the ID does not exist, or updates an existing session.\n   * Automatically updates the updated_at timestamp and message_count.\n   *\n   * @param id - The unique identifier of the session.\n   * @param messages - The messages to store for this session.\n   * @param metadata - Optional partial metadata to merge with existing metadata.\n   * @returns A promise that resolves when the save operation is complete.\n   */\n  async save(id: string, messages: Message[], metadata?: Partial<SessionMetadata>) {\n    const now = new Date().toISOString();\n    const existing = this.#sessions.get(id);\n\n    this.#sessions.set(id, {\n      metadata: {\n        id,\n        ...existing?.metadata,\n        created_at: existing?.metadata.created_at ?? now,\n        updated_at: now,\n        message_count: messages.length,\n        ...metadata,\n      },\n      messages: structuredClone(messages),\n    });\n  }\n\n  /**\n   * Deletes a session from memory.\n   *\n   * @param id - The unique identifier of the session to delete.\n   * @returns A promise that resolves to true if the session was deleted, false if it was not found.\n   */\n  async delete(id: string) {\n    return this.#sessions.delete(id);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,23 +1,29 @@
 {
   "name": "@simulacra-ai/session",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Session persistence for the Simulacra conversation engine with pluggable file and in-memory storage",
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsup",
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "peerDependencies": {
-    "@simulacra-ai/core": "0.0.2"
+    "@simulacra-ai/core": "0.0.4"
   },
   "repository": {
     "type": "git",