noumen 0.5.0 → 0.6.0

package/dist/{chunk-WPCYGZOE.js → chunk-6MMYCGJQ.js}

@@ -15,7 +15,7 @@ import {
 } from "./chunk-HEQQQGK5.js";
 import {
   ChatStreamError
-} from "./chunk-L3L3FG5T.js";
+} from "./chunk-CCM2AXZG.js";
 import {
   generateUUID
 } from "./chunk-3HEYCV26.js";
@@ -316,6 +316,127 @@ function LocalSandbox(opts) {
   };
 }
 
+// src/session/auto-title.ts
+var DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS = 2e3;
+var DEFAULT_AUTO_TITLE_SYSTEM_PROMPT = `Generate a concise, sentence-case title (3-7 words) that captures the main topic or goal of this coding session. The title should be clear enough that the user recognizes the session in a list. Use sentence case: capitalize only the first word and proper nouns.
+
+Return JSON with a single "title" field.
+
+Good examples:
+{"title": "Fix login button on mobile"}
+{"title": "Add OAuth authentication"}
+{"title": "Debug failing CI tests"}
+{"title": "Refactor API client error handling"}
+
+Bad (too vague): {"title": "Code changes"}
+Bad (too long): {"title": "Investigate and fix the issue where the login button does not respond on mobile devices"}
+Bad (wrong case): {"title": "Fix Login Button On Mobile"}`;
+function extractTitleSeedText(messages, maxChars = DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS) {
+  const parts = [];
+  for (const msg of messages) {
+    if (msg.role !== "user" && msg.role !== "assistant") continue;
+    const content = msg.content;
+    if (content === null || content === void 0) continue;
+    if (typeof content === "string") {
+      if (content.trim()) parts.push(content);
+      continue;
+    }
+    if (Array.isArray(content)) {
+      for (const block of content) {
+        if (block.type === "text" && typeof block.text === "string") {
+          if (block.text.trim()) parts.push(block.text);
+        }
+      }
+    }
+  }
+  const text = parts.join("\n").trim();
+  if (text.length <= maxChars) return text;
+  return text.slice(-maxChars);
+}
+function extractTitleFromResponse(raw) {
+  if (!raw) return null;
+  const trimmed = raw.trim();
+  const parseTitle = (s) => {
+    let obj;
+    try {
+      obj = JSON.parse(s);
+    } catch {
+      return { kind: "none" };
+    }
+    if (obj && typeof obj === "object" && "title" in obj) {
+      const v = obj.title;
+      if (typeof v === "string") {
+        const t = v.trim();
+        if (t) return { kind: "ok", title: t };
+      }
+    }
+    return { kind: "empty" };
+  };
+  const whole = parseTitle(trimmed);
+  if (whole.kind === "ok") return whole.title;
+  if (whole.kind === "empty") return null;
+  const start = trimmed.indexOf("{");
+  const end = trimmed.lastIndexOf("}");
+  if (start >= 0 && end > start) {
+    const sliced = parseTitle(trimmed.slice(start, end + 1));
+    if (sliced.kind === "ok") return sliced.title;
+    if (sliced.kind === "empty") return null;
+  }
+  const quoteMatch = trimmed.match(/"([^"\\]{2,120})"/);
+  if (quoteMatch?.[1]) return quoteMatch[1].trim();
+  return null;
+}
+async function generateAutoTitle(messages, opts) {
+  const seed = extractTitleSeedText(messages, opts.maxInputChars);
+  if (!seed) return null;
+  const model = opts.model ?? opts.provider.defaultModel;
+  if (!model) return null;
+  const system = opts.systemPrompt ?? DEFAULT_AUTO_TITLE_SYSTEM_PROMPT;
+  const params = {
+    model,
+    system,
+    messages: [{ role: "user", content: seed }],
+    max_tokens: 60,
+    outputFormat: {
+      type: "json_schema",
+      schema: {
+        type: "object",
+        properties: { title: { type: "string" } },
+        required: ["title"],
+        additionalProperties: false
+      },
+      name: "session_title",
+      strict: true
+    },
+    signal: opts.signal
+  };
+  let text = "";
+  try {
+    for await (const chunk of opts.provider.chat(params)) {
+      for (const choice of chunk.choices) {
+        const delta = choice.delta.content;
+        if (typeof delta === "string") text += delta;
+      }
+    }
+  } catch {
+    return null;
+  }
+  if (!text) return null;
+  const extracted = extractTitleFromResponse(text) ?? text.trim();
+  return normalizeTitle(extracted);
+}
+function normalizeTitle(raw) {
+  if (!raw) return null;
+  let t = raw.replace(/\s+/g, " ").trim();
+  if (t.length >= 2 && (t.startsWith('"') && t.endsWith('"') || t.startsWith("'") && t.endsWith("'"))) {
+    t = t.slice(1, -1).trim();
+  }
+  t = t.replace(/\.+$/, "").trim();
+  if (!t) return null;
+  if (t.length > 120) t = t.slice(0, 120).trim();
+  return t;
+}
+
 // src/checkpoint/manager.ts
 import { createHash } from "crypto";
 
@@ -1805,31 +1926,83 @@ var SessionStorage = class {
     await this.appendEntry(sessionId, entry);
   }
   /**
-   * Re-append custom-title and key metadata entries after a compact boundary
-   * so they remain discoverable in the active-entries window.
+   * Append a user-set session title. Wins over any `ai-title` when read.
+   * Idempotent-ish: callers may append as many as they like; the last one
+   * wins according to file order.
+   */
+  async appendCustomTitle(sessionId, title) {
+    const entry = {
+      type: "custom-title",
+      sessionId,
+      title,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.appendEntry(sessionId, entry);
+  }
+  /**
+   * Append an AI-generated session title. A `custom-title` (if present)
+   * always takes precedence on read.
+   */
+  async appendAiTitle(sessionId, title) {
+    const entry = {
+      type: "ai-title",
+      sessionId,
+      title,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.appendEntry(sessionId, entry);
+  }
+  /**
+   * Re-append custom-title, ai-title, and key metadata entries after a
+   * compact boundary so they remain discoverable in the active-entries
+   * window. Written as a single batched append so a crash mid-write can't
+   * leave the transcript with only a subset of the re-emitted entries.
    */
   async reAppendMetadataAfterCompact(sessionId) {
     const entries = await this.loadAllEntries(sessionId);
     let customTitle;
+    let aiTitle;
     const metadataByKey = /* @__PURE__ */ new Map();
     for (const entry of entries) {
       if (entry.type === "custom-title") {
         customTitle = entry.title;
       }
+      if (entry.type === "ai-title") {
+        aiTitle = entry.title;
+      }
       if (entry.type === "metadata") {
         metadataByKey.set(entry.key, entry.value);
       }
     }
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const batch = [];
     if (customTitle) {
-      await this.appendEntry(sessionId, {
+      batch.push({
         type: "custom-title",
         sessionId,
         title: customTitle,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        timestamp
+      });
+    }
+    if (aiTitle) {
+      batch.push({
+        type: "ai-title",
+        sessionId,
+        title: aiTitle,
+        timestamp
       });
     }
     for (const [key, value] of metadataByKey) {
-      await this.appendMetadata(sessionId, key, value);
+      batch.push({
+        type: "metadata",
+        sessionId,
+        timestamp,
+        key,
+        value
+      });
+    }
+    if (batch.length > 0) {
+      await this.appendEntriesBatch(sessionId, batch);
     }
   }
   async loadMessages(sessionId) {
@@ -1880,6 +2053,21 @@ var SessionStorage = class {
   async sessionExists(sessionId) {
     return this.fs.exists(this.getTranscriptPath(sessionId));
   }
+  /**
+   * Return the currently persisted titles for a session. `title` reflects
+   * the display preference (custom > ai). Returns all-undefined if the
+   * session file doesn't exist.
+   */
+  async getSessionTitles(sessionId) {
+    const entries = await this.loadAllEntries(sessionId);
+    let customTitle;
+    let aiTitle;
+    for (const entry of entries) {
+      if (entry.type === "custom-title") customTitle = entry.title;
+      if (entry.type === "ai-title") aiTitle = entry.title;
+    }
+    return { title: customTitle ?? aiTitle, customTitle, aiTitle };
+  }
   async deleteSession(sessionId) {
     const filePath = this.getTranscriptPath(sessionId);
     const exists = await this.fs.exists(filePath);
@@ -1918,8 +2106,8 @@ var SessionStorage = class {
           tailSlice = content;
         }
         const headEntries = parseJSONL(headSlice);
-        const tailEntries = isSplit ? parseJSONL(tailSlice) : headEntries;
-        let title;
+        let customTitle;
+        let aiTitle;
         let firstTimestamp;
         let lastTimestamp;
         let messageCount = 0;
@@ -1929,22 +2117,27 @@ var SessionStorage = class {
             if (!firstTimestamp) firstTimestamp = e.timestamp;
             lastTimestamp = e.timestamp;
           }
-          if (e.type === "custom-title") title = e.title;
+          if (e.type === "custom-title") customTitle = e.title;
+          if (e.type === "ai-title") aiTitle = e.title;
         }
         if (isSplit) {
+          const tailEntries = parseJSONL(tailSlice);
           for (const e of tailEntries) {
             if (e.type === "message" || e.type === "summary") {
               messageCount++;
               if (e.timestamp) lastTimestamp = e.timestamp;
             }
-            if (e.type === "custom-title") title = e.title;
+            if (e.type === "custom-title") customTitle = e.title;
+            if (e.type === "ai-title") aiTitle = e.title;
           }
         }
         sessions.push({
           sessionId,
           createdAt: firstTimestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
           lastMessageAt: lastTimestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
-          title,
+          title: customTitle ?? aiTitle,
+          customTitle,
+          aiTitle,
           messageCount
         });
       } catch {
@@ -7052,7 +7245,13 @@ var Thread = class {
     this.config = config;
     this.sessionId = opts?.sessionId ?? generateUUID();
     this.cwd = opts?.cwd ?? "/";
-    this.model = opts?.model ?? config.model ?? "gpt-5.4";
+    const resolvedModel = opts?.model ?? config.model ?? config.provider.defaultModel;
+    if (!resolvedModel) {
+      throw new Error(
+        "Thread: no model resolved. Pass `model` to Thread / Agent / preset options, set `config.model`, or provide a provider with a `defaultModel` (built-in providers expose one automatically)."
+      );
+    }
+    this.model = resolvedModel;
     this.storage = new SessionStorage(config.fs, config.sessionDir);
     if (config.permissions) {
       this.permissionContext = {
@@ -7977,6 +8176,14 @@ var Agent = class {
   historySnipConfig;
   outputFormat;
   structuredOutputMode;
+  autoTitleConfig;
+  /**
+   * Keyed by `${sessionId}:${force ? "force" : "normal"}`. Parallel calls
+   * that pass the same `force` mode coalesce to one in-flight request; a
+   * `force: true` call arriving during a normal in-flight request runs its
+   * own pass so the caller's intent isn't silently dropped.
+   */
+  autoTitleInFlight = /* @__PURE__ */ new Map();
   providerPromise = null;
   initPromise = null;
   constructor(opts) {
@@ -8047,6 +8254,12 @@ var Agent = class {
     this.historySnipConfig = opts.options?.historySnip;
     this.outputFormat = opts.options?.outputFormat;
     this.structuredOutputMode = opts.options?.structuredOutputMode;
+    const autoTitleOpt = opts.options?.autoTitle;
+    if (autoTitleOpt === true) {
+      this.autoTitleConfig = { enabled: true };
+    } else if (autoTitleOpt && typeof autoTitleOpt === "object") {
+      this.autoTitleConfig = { enabled: true, ...autoTitleOpt };
+    }
     if (opts.options?.checkpoint?.enabled) {
       this.checkpointManager = new FileCheckpointManager(
         this.fs,
@@ -8058,7 +8271,7 @@ var Agent = class {
     if (this.resolvedProvider) return this.resolvedProvider;
     if (!this.providerPromise) {
       this.providerPromise = (async () => {
-        const { resolveProvider: resolveProvider2 } = await import("./resolve-GDSHNMG6.js");
+        const { resolveProvider: resolveProvider2 } = await import("./resolve-6KUZNEYW.js");
         return resolveProvider2(this.providerInput, { model: this.model });
       })();
     }
@@ -8216,6 +8429,92 @@ var Agent = class {
   async listSessions() {
     return this.storage.listSessions();
   }
+  /**
+   * Load the message history for a stored session, respecting compact
+   * boundaries and history snips. Returns `[]` when the session does
+   * not exist. Use this to rehydrate a UI — resuming a Thread for
+   * further execution should go through `resumeThread()` instead.
+   */
+  async getMessages(sessionId) {
+    return this.storage.loadMessages(sessionId);
+  }
+  /**
+   * Persist a user-set title for a session. Takes precedence over any
+   * AI-generated title on read. No-op on empty / whitespace-only input.
+   */
+  async setCustomTitle(sessionId, title) {
+    const trimmed = title.trim();
+    if (!trimmed) return;
+    await this.storage.appendCustomTitle(sessionId, trimmed);
+  }
+  /**
+   * Persist an AI-generated title for a session. A user-set title
+   * (see `setCustomTitle`) always wins on read, so writing this after a
+   * user has renamed the session is harmless.
+   */
+  async setAiTitle(sessionId, title) {
+    const trimmed = title.trim();
+    if (!trimmed) return;
+    await this.storage.appendAiTitle(sessionId, trimmed);
+  }
+  /**
+   * Delete a session's persisted transcript. Does not affect any
+   * currently-running `Thread` reading from the same session id.
+   */
+  async deleteSession(sessionId) {
+    await this.storage.deleteSession(sessionId);
+  }
+  /**
+   * Return the currently persisted titles for a session.
+   * `title` reflects the display preference (custom > ai).
+   */
+  async getSessionTitles(sessionId) {
+    return this.storage.getSessionTitles(sessionId);
+  }
+  /**
+   * When `autoTitle` is enabled and the session has no title yet,
+   * generate one via the configured provider + model and persist it
+   * as an `ai-title` entry. Returns the new title on success, or `null`
+   * when skipped (feature disabled, title already present, empty seed,
+   * or provider error).
+   *
+   * Concurrency-safe: parallel calls for the same session coalesce to
+   * a single in-flight request.
+   */
+  async autoTitleIfMissing(sessionId, opts) {
+    const cfg = this.autoTitleConfig;
+    if (!cfg?.enabled) return null;
+    const force = opts?.force === true;
+    const key = `${sessionId}:${force ? "force" : "normal"}`;
+    const existing = this.autoTitleInFlight.get(key);
+    if (existing) return existing;
+    const task = (async () => {
+      try {
+        if (!force) {
+          const titles = await this.storage.getSessionTitles(sessionId);
+          if (titles.customTitle || titles.aiTitle) return null;
+        }
+        await this.ensureProvider();
+        const provider = cfg.provider ?? this.getProvider();
+        const messages = await this.storage.loadMessages(sessionId);
+        if (messages.length === 0) return null;
+        const title = await generateAutoTitle(messages, {
+          provider,
+          model: cfg.model ?? provider.defaultModel ?? this.model,
+          systemPrompt: cfg.systemPrompt ?? DEFAULT_AUTO_TITLE_SYSTEM_PROMPT,
+          maxInputChars: cfg.maxInputChars ?? DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS,
+          signal: opts?.signal
+        });
+        if (!title) return null;
+        await this.storage.appendAiTitle(sessionId, title);
+        return title;
+      } finally {
+        this.autoTitleInFlight.delete(key);
+      }
+    })();
+    this.autoTitleInFlight.set(key, task);
+    return task;
+  }
   getCostSummary() {
     return this.costTracker?.getSummary() ?? null;
   }
@@ -8461,7 +8760,8 @@ function codingAgent(opts) {
       costTracking: { enabled: true },
       retry: true,
       hooks: opts.hooks,
-      mcpServers: opts.mcpServers
+      mcpServers: opts.mcpServers,
+      autoTitle: opts.autoTitle
     }
   });
 }
@@ -8483,7 +8783,8 @@ function planningAgent(opts) {
       costTracking: { enabled: true },
       retry: true,
       hooks: opts.hooks,
-      mcpServers: opts.mcpServers
+      mcpServers: opts.mcpServers,
+      autoTitle: opts.autoTitle
     }
   });
 }
@@ -8506,6 +8807,7 @@ function reviewAgent(opts) {
       retry: true,
       hooks: opts.hooks,
       mcpServers: opts.mcpServers,
+      autoTitle: opts.autoTitle,
       webSearch: {
         search: async (query) => {
           try {
@@ -9081,6 +9383,12 @@ export {
   SandboxedLocalComputer,
   UnsandboxedLocal,
   LocalSandbox,
+  DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS,
+  DEFAULT_AUTO_TITLE_SYSTEM_PROMPT,
+  extractTitleSeedText,
+  extractTitleFromResponse,
+  generateAutoTitle,
+  normalizeTitle,
   createCheckpointState,
   FileCheckpointManager,
   runPreToolUseHooks,
@@ -9108,6 +9416,7 @@ export {
   findModelPricing,
   calculateCost,
   CostTracker,
+  SessionStorage,
   TaskStore,
   buildProjectContextSection,
   parseFrontmatter,
@@ -9192,4 +9501,4 @@ export {
   truncateIndex,
   FileMemoryProvider
 };
-//# sourceMappingURL=chunk-WPCYGZOE.js.map
+//# sourceMappingURL=chunk-6MMYCGJQ.js.map