noumen 0.5.0 → 0.6.0

package/dist/a2a/index.d.ts

@@ -1,12 +1,12 @@
-import { A as Agent } from '../agent-C3eDRsxs.js';
+import { A as Agent } from '../agent-DWE4_P5X.js';
 import { A as AgentSkill, a as AgentCard, T as TaskSendParams, b as Task, c as TaskStreamEvent } from '../types-NIyVwQ4h.js';
 export { d as A2A_METHODS, e as Artifact, D as DataPart, F as FilePart, M as Message, P as Part, f as TaskState, g as TaskStatus, h as TextPart } from '../types-NIyVwQ4h.js';
-import '../types-LrU4LRmX.js';
+import '../types-kiGBF35b.js';
 import '../sandbox-9qeMTNrD.js';
 import '../computer-BPdxSo6X.js';
-import '../types-BA87bHPV.js';
+import '../types-DhXwOQwD.js';
 import '../types-CD0rUKKT.js';
-import '../cache-DsRqxx6v.js';
+import '../cache-BlBwXXPS.js';
 import '../types-2kTLUCnD.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

package/dist/acp/index.d.ts

@@ -1,12 +1,12 @@
-import { A as Agent } from '../agent-C3eDRsxs.js';
+import { A as Agent } from '../agent-DWE4_P5X.js';
 import { A as AcpTransport } from '../types-QwfylltH.js';
 export { a as ACP_METHODS, b as AcpCapabilities, c as AcpInitializeParams, d as AcpInitializeResult, e as AcpSessionNewParams, f as AcpSessionPromptParams } from '../types-QwfylltH.js';
 import { a as VirtualFs, R as ReadOptions, F as FileEntry, b as FileStat, V as VirtualComputer, E as ExecOptions, C as CommandResult } from '../computer-BPdxSo6X.js';
-import '../types-LrU4LRmX.js';
+import '../types-kiGBF35b.js';
 import '../sandbox-9qeMTNrD.js';
-import '../types-BA87bHPV.js';
+import '../types-DhXwOQwD.js';
 import '../types-CD0rUKKT.js';
-import '../cache-DsRqxx6v.js';
+import '../cache-BlBwXXPS.js';
 import '../types-2kTLUCnD.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

package/dist/{agent-C3eDRsxs.d.ts → agent-DWE4_P5X.d.ts}

@@ -1,7 +1,7 @@
-import { A as AIProvider, S as StreamEvent, b as ChatMessage, E as Entry, U as UUID, d as FileCheckpointSnapshot, f as ContentReplacementRecord$1, g as SessionInfo, M as ModelPricing, h as UsageRecord, i as CostSummary, j as ModelUsageSummary, k as ChatCompletionUsage, l as ThinkingConfig, m as MemoryConfig, O as OutputFormat, e as ContentPart, R as RunOptions, c as CheckpointConfig, n as ToolResult } from './types-LrU4LRmX.js';
+import { A as AIProvider, b as ChatMessage, S as StreamEvent, E as Entry, U as UUID, d as FileCheckpointSnapshot, f as ContentReplacementRecord$1, g as SessionInfo, M as ModelPricing, h as UsageRecord, i as CostSummary, j as ModelUsageSummary, k as ChatCompletionUsage, l as ThinkingConfig, m as MemoryConfig, O as OutputFormat, e as ContentPart, R as RunOptions, c as CheckpointConfig, n as ToolResult } from './types-kiGBF35b.js';
 import { S as Sandbox } from './sandbox-9qeMTNrD.js';
-import { T as Tool, H as HookDefinition, S as SubagentConfig, i as SubagentRun, j as TaskStore, e as LspServerManager, F as FileCheckpointManager, k as FileStateCacheConfig, L as LspServerConfig } from './types-BA87bHPV.js';
-import { C as CacheControlConfig } from './cache-DsRqxx6v.js';
+import { T as Tool, H as HookDefinition, S as SubagentConfig, i as SubagentRun, j as TaskStore, e as LspServerManager, F as FileCheckpointManager, k as FileStateCacheConfig, L as LspServerConfig } from './types-DhXwOQwD.js';
+import { C as CacheControlConfig } from './cache-BlBwXXPS.js';
 import { M as McpServerConfig, T as TokenStorage } from './types-2kTLUCnD.js';
 import { c as PermissionHandler, d as PermissionConfig } from './types-CD0rUKKT.js';
 import { a as VirtualFs, V as VirtualComputer } from './computer-BPdxSo6X.js';
@@ -27,6 +27,91 @@ declare function resolveProvider(input: AIProvider | ProviderName, opts?: Resolv
  */
 declare function detectProvider(): Promise<ProviderName | undefined>;
 
+/**
+ * AI-generated session title helper.
+ *
+ * Given a short prompt sourced from recent messages, ask a provider to
+ * produce a 3–7 word sentence-case title suitable for a session list.
+ *
+ * This is a pure helper: it never touches the filesystem and never knows
+ * about `SessionStorage`. Callers (e.g. `Agent.autoTitleIfMissing`) own
+ * persistence and event emission.
+ */
+
+/**
+ * Config for the Agent's opt-in auto-title feature.
+ *
+ * Pass `true` for defaults (use the Agent's own provider + its
+ * `defaultModel`). Pass an object to customise the provider, model,
+ * system prompt, or input cap.
+ */
+interface AutoTitleConfig {
+    /** Master switch. Default false on `AgentOptions.autoTitle`. */
+    enabled?: boolean;
+    /**
+     * Override provider used for title generation. Falls back to the
+     * Agent's main provider.
+     */
+    provider?: AIProvider;
+    /**
+     * Override model (e.g. `"claude-haiku-4-5"`). Falls back to the
+     * provider's `defaultModel`.
+     */
+    model?: string;
+    /** Override system prompt. */
+    systemPrompt?: string;
+    /** Cap on seed-text characters. Defaults to 2 000. */
+    maxInputChars?: number;
+}
+/** Default cap on characters fed to the title model. */
+declare const DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS = 2000;
+/**
+ * System prompt for the auto-title generator. Mirrors the shape used by
+ * Claude Code so that output quality is familiar.
+ */
+declare const 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.\n\nReturn JSON with a single \"title\" field.\n\nGood examples:\n{\"title\": \"Fix login button on mobile\"}\n{\"title\": \"Add OAuth authentication\"}\n{\"title\": \"Debug failing CI tests\"}\n{\"title\": \"Refactor API client error handling\"}\n\nBad (too vague): {\"title\": \"Code changes\"}\nBad (too long): {\"title\": \"Investigate and fix the issue where the login button does not respond on mobile devices\"}\nBad (wrong case): {\"title\": \"Fix Login Button On Mobile\"}";
+interface GenerateAutoTitleOptions {
+    provider: AIProvider;
+    /** Model override. When omitted, uses `provider.defaultModel`. */
+    model?: string;
+    /** System prompt override. Falls back to the built-in prompt. */
+    systemPrompt?: string;
+    /** Character cap on the flattened input. Defaults to 2 000. */
+    maxInputChars?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Flatten recent user + assistant text into a single block of plain text
+ * suitable for the title model. Tool results are skipped; image parts
+ * are skipped; only the tail of the concatenated text is kept when long
+ * so the most recent context wins.
+ */
+declare function extractTitleSeedText(messages: ChatMessage[], maxChars?: number): string;
+/**
+ * Attempt to pull a title out of a free-form model response.
+ *
+ * Strategy, cheapest-first:
+ *   1. Parse the whole string as JSON; return `.title` if present.
+ *   2. Slice out the first `{...}` block and `JSON.parse` that.
+ *   3. Fall back to the first bare quoted substring in the response.
+ *
+ * Going through `JSON.parse` (instead of a bespoke regex-unescape) means
+ * `\n`, `\\`, `\uXXXX`, and any other valid JSON string escapes round-trip
+ * correctly — the previous regex only handled `\"`.
+ */
+declare function extractTitleFromResponse(raw: string): string | null;
+/**
+ * Drive the provider once to produce a session title. Returns null on
+ * empty seed text, empty model output, or provider errors (callers decide
+ * whether to retry — this helper never throws).
+ */
+declare function generateAutoTitle(messages: ChatMessage[], opts: GenerateAutoTitleOptions): Promise<string | null>;
+/**
+ * Trim, collapse whitespace, strip wrapping quotes, clamp length.
+ * Returns null if the cleaned string would be empty.
+ */
+declare function normalizeTitle(raw: string): string | null;
+
 interface SkillDefinition {
     name: string;
     /** Skill body content (after frontmatter is stripped) */
@@ -219,13 +304,36 @@ declare class SessionStorage {
     appendContentReplacement(sessionId: string, replacements: ContentReplacementRecord$1[]): Promise<void>;
     appendMetadata(sessionId: string, key: string, value: unknown): Promise<void>;
     /**
-     * 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.
+     */
+    appendCustomTitle(sessionId: string, title: string): Promise<void>;
+    /**
+     * Append an AI-generated session title. A `custom-title` (if present)
+     * always takes precedence on read.
+     */
+    appendAiTitle(sessionId: string, title: string): Promise<void>;
+    /**
+     * 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.
      */
     reAppendMetadataAfterCompact(sessionId: string): Promise<void>;
     loadMessages(sessionId: string): Promise<ChatMessage[]>;
     loadAllEntries(sessionId: string): Promise<Entry[]>;
     sessionExists(sessionId: string): Promise<boolean>;
+    /**
+     * 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.
+     */
+    getSessionTitles(sessionId: string): Promise<{
+        title?: string;
+        customTitle?: string;
+        aiTitle?: string;
+    }>;
     deleteSession(sessionId: string): Promise<void>;
     listSessions(): Promise<SessionInfo[]>;
 }
@@ -704,6 +812,17 @@ interface AgentOptions {
         outputFormat?: OutputFormat;
         /** Default structured output mode for all threads. */
         structuredOutputMode?: "alongside_tools" | "final_response";
+        /**
+         * Opt-in AI-generated session titles. When enabled, callers can invoke
+         * `agent.autoTitleIfMissing(sessionId)` (typically once per session,
+         * e.g. after the first assistant turn) to produce a short title and
+         * persist it as an `ai-title` JSONL entry. User-set `custom-title`
+         * entries (see `agent.setCustomTitle`) always take precedence on read.
+         *
+         * Pass `true` for defaults (same provider as the Agent, provider's
+         * default model, built-in prompt) or an object to customise.
+         */
+        autoTitle?: AutoTitleConfig | boolean;
     };
 }
 interface RunCallbacks {
@@ -777,6 +896,14 @@ declare class Agent {
     private historySnipConfig;
     private outputFormat;
     private structuredOutputMode;
+    private 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.
+     */
+    private autoTitleInFlight;
     private providerPromise;
     private initPromise;
     constructor(opts: AgentOptions);
@@ -787,6 +914,52 @@ declare class Agent {
     private createSpawnSubagent;
     createThread(opts?: ThreadOptions): Promise<Thread>;
     listSessions(): Promise<SessionInfo[]>;
+    /**
+     * 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.
+     */
+    getMessages(sessionId: string): Promise<ChatMessage[]>;
+    /**
+     * Persist a user-set title for a session. Takes precedence over any
+     * AI-generated title on read. No-op on empty / whitespace-only input.
+     */
+    setCustomTitle(sessionId: string, title: string): Promise<void>;
+    /**
+     * 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.
+     */
+    setAiTitle(sessionId: string, title: string): Promise<void>;
+    /**
+     * Delete a session's persisted transcript. Does not affect any
+     * currently-running `Thread` reading from the same session id.
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Return the currently persisted titles for a session.
+     * `title` reflects the display preference (custom > ai).
+     */
+    getSessionTitles(sessionId: string): Promise<{
+        title?: string;
+        customTitle?: string;
+        aiTitle?: string;
+    }>;
+    /**
+     * 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.
+     */
+    autoTitleIfMissing(sessionId: string, opts?: {
+        signal?: AbortSignal;
+        force?: boolean;
+    }): Promise<string | null>;
     getCostSummary(): CostSummary | null;
     /**
      * Create a thread that resumes an existing session. Automatically restores
@@ -840,4 +1013,4 @@ declare class Agent {
     close(): Promise<void>;
 }
 
-export { createAutoCompactConfig as $, Agent as A, type BudgetState as B, type ContextFile as C, DEFAULT_MODELS as D, type RunCallbacks as E, type RunResult as F, SUPPORTED_PROVIDERS as G, type SnipConfig as H, type SnipResult as I, Thread as J, type ThreadOptions as K, type ToolResultBudgetConfig as L, type MicrocompactConfig as M, type ToolResultBudgetResult as N, type ContentReplacementRecord as O, type ProjectContextConfig as P, type ToolResultSpillResult as Q, type RetryConfig as R, type SkillDefinition as S, type ThreadConfig as T, type ToolResultStorageConfig as U, type TracingConfig as V, type WebSearchConfig as W, type WebSearchResult as X, applyPersistedReplacements as Y, applySnipRemovals as Z, canAutoCompact as _, SessionStorage as a, createAutoCompactTracking as a0, createBudgetState as a1, createContentReplacementState as a2, createWebSearchTool as a3, detectProvider as a4, enforceToolResultBudget as a5, enforceToolResultStorageBudget as a6, microcompactMessages as a7, persistToolResult as a8, projectSnippedView as a9, reconstructContentReplacementState as aa, recordAutoCompactFailure as ab, recordAutoCompactSuccess as ac, resolveProvider as ad, shouldAutoCompact as ae, snipMessagesByUuids as af, tryReactiveCompact as ag, webSearchToolPlaceholder as ah, type ContextScope as b, type RetryContext as c, type RetryEngineOptions as d, type Span as e, type SpanAttributeValue as f, SpanStatusCode as g, type Tracer as h, type SpanOptions as i, type StoredCostState as j, type AgentOptions as k, type AutoCompactConfig as l, type AutoCompactTrackingState as m, CLEARED_PLACEHOLDER as n, COMPACTABLE_TOOLS as o, type ContentReplacementState as p, CostTracker as q, DEFAULT_RETRY_CONFIG as r, type DiagnoseCheckResult as s, type DiagnoseResult as t, type MicrocompactResult as u, type ProviderName as v, type ReactiveCompactConfig as w, type ReactiveCompactResult as x, type ResolveProviderOptions as y, type RetryEvent as z };
+export { type WebSearchResult as $, Agent as A, type BudgetState as B, type ContextFile as C, DEFAULT_AUTO_TITLE_MAX_INPUT_CHARS as D, type ReactiveCompactResult as E, type ResolveProviderOptions as F, type GenerateAutoTitleOptions as G, type RetryEvent as H, type RunCallbacks as I, type RunResult as J, SUPPORTED_PROVIDERS as K, type SnipConfig as L, type MicrocompactConfig as M, type SnipResult as N, Thread as O, type ProjectContextConfig as P, type ThreadOptions as Q, type RetryConfig as R, type SkillDefinition as S, type ThreadConfig as T, type ToolResultBudgetConfig as U, type ToolResultBudgetResult as V, type ContentReplacementRecord as W, type ToolResultSpillResult as X, type ToolResultStorageConfig as Y, type TracingConfig as Z, type WebSearchConfig as _, type AutoTitleConfig as a, applyPersistedReplacements as a0, applySnipRemovals as a1, canAutoCompact as a2, createAutoCompactConfig as a3, createAutoCompactTracking as a4, createBudgetState as a5, createContentReplacementState as a6, createWebSearchTool as a7, detectProvider as a8, enforceToolResultBudget as a9, enforceToolResultStorageBudget as aa, extractTitleFromResponse as ab, extractTitleSeedText as ac, generateAutoTitle as ad, microcompactMessages as ae, normalizeTitle as af, persistToolResult as ag, projectSnippedView as ah, reconstructContentReplacementState as ai, recordAutoCompactFailure as aj, recordAutoCompactSuccess as ak, resolveProvider as al, shouldAutoCompact as am, snipMessagesByUuids as an, tryReactiveCompact as ao, webSearchToolPlaceholder as ap, SessionStorage as b, type ContextScope as c, type RetryContext as d, type RetryEngineOptions as e, type Span as f, type SpanAttributeValue as g, SpanStatusCode as h, type Tracer as i, type SpanOptions as j, type StoredCostState as k, type AgentOptions as l, type AutoCompactConfig as m, type AutoCompactTrackingState as n, CLEARED_PLACEHOLDER as o, COMPACTABLE_TOOLS as p, type ContentReplacementState as q, CostTracker as r, DEFAULT_AUTO_TITLE_SYSTEM_PROMPT as s, DEFAULT_MODELS as t, DEFAULT_RETRY_CONFIG as u, type DiagnoseCheckResult as v, type DiagnoseResult as w, type MicrocompactResult as x, type ProviderName as y, type ReactiveCompactConfig as z };

package/dist/{cache-DsRqxx6v.d.ts → cache-BlBwXXPS.d.ts}

@@ -1,4 +1,4 @@
-import { b as ChatMessage, T as ToolDefinition } from './types-LrU4LRmX.js';
+import { b as ChatMessage, T as ToolDefinition } from './types-kiGBF35b.js';
 
 /**
  * Provider-agnostic prompt caching utilities.