agents 0.10.0 → 0.10.1

package/dist/experimental/memory/session/index.d.ts

@@ -1,250 +1,6 @@
-import { r as CompactResult } from "../../../compaction-helpers-CHNQeyRm.js";
-import { ToolSet, UIMessage } from "ai";
+import { A as SessionOptions, C as AgentSessionProvider, D as StoredCompaction, E as SessionProvider, O as SessionMessage, S as isSearchProvider, T as SearchResult, _ as R2SkillProvider, b as AgentSearchProvider, f as ContextBlock, g as isWritableProvider, h as WritableContextProvider, k as SessionMessagePart, m as ContextProvider, p as ContextConfig, r as CompactResult, v as SkillProvider, w as SqlProvider, x as SearchProvider, y as isSkillProvider } from "../../../compaction-helpers-BdQbZiML.js";
+import { ToolSet } from "ai";
 
-//#region src/experimental/memory/session/provider.d.ts
-interface SearchResult {
-  id: string;
-  role: string;
-  content: string;
-  createdAt?: string;
-  sessionId?: string;
-}
-interface StoredCompaction {
-  id: string;
-  summary: string;
-  fromMessageId: string;
-  toMessageId: string;
-  createdAt: string;
-}
-/**
- * Session storage provider.
- * Messages are tree-structured via parentId for branching.
- */
-interface SessionProvider {
-  getMessage(id: string): UIMessage | null;
-  /**
-   * Get conversation as a path from root to leaf.
-   * Applies compaction overlays. If leafId is null, uses the latest leaf.
-   */
-  getHistory(leafId?: string | null): UIMessage[];
-  getLatestLeaf(): UIMessage | null;
-  getBranches(messageId: string): UIMessage[];
-  getPathLength(leafId?: string | null): number;
-  /**
-   * Append a message. Parented to the latest leaf unless parentId is provided.
-   * Idempotent — same message.id twice is a no-op.
-   */
-  appendMessage(message: UIMessage, parentId?: string | null): void;
-  updateMessage(message: UIMessage): void;
-  deleteMessages(messageIds: string[]): void;
-  clearMessages(): void;
-  addCompaction(summary: string, fromMessageId: string, toMessageId: string): StoredCompaction;
-  getCompactions(): StoredCompaction[];
-  searchMessages?(query: string, limit?: number): SearchResult[];
-}
-//#endregion
-//#region src/experimental/memory/session/providers/agent.d.ts
-interface SqlProvider {
-  sql<T = Record<string, string | number | boolean | null>>(strings: TemplateStringsArray, ...values: (string | number | boolean | null)[]): T[];
-}
-declare class AgentSessionProvider implements SessionProvider {
-  private agent;
-  private initialized;
-  private sessionId;
-  /**
-   * @param agent - Agent or any object with a `sql` tagged template method
-   * @param sessionId - Optional session ID to isolate multiple sessions in the same DO.
-   *                    Messages are filtered by session_id within shared tables.
-   */
-  constructor(agent: SqlProvider, sessionId?: string);
-  private ensureTable;
-  getMessage(id: string): UIMessage | null;
-  getHistory(leafId?: string | null): UIMessage[];
-  getLatestLeaf(): UIMessage | null;
-  getBranches(messageId: string): UIMessage[];
-  getPathLength(leafId?: string | null): number;
-  appendMessage(message: UIMessage, parentId?: string | null): void;
-  updateMessage(message: UIMessage): void;
-  deleteMessages(messageIds: string[]): void;
-  clearMessages(): void;
-  addCompaction(summary: string, fromMessageId: string, toMessageId: string): StoredCompaction;
-  getCompactions(): StoredCompaction[];
-  searchMessages(query: string, limit?: number): SearchResult[];
-  private latestLeafRow;
-  private indexFTS;
-  private deleteFTS;
-  private applyCompactions;
-  private parse;
-  private parseRows;
-}
-//#endregion
-//#region src/experimental/memory/session/search.d.ts
-/**
- * Storage interface for searchable context.
- *
- * - `get()` returns a summary of indexed content (rendered into system prompt)
- * - `search(query)` full-text search (via search_context tool)
- * - `set(key, content)` indexes content under a key (via set_context tool)
- */
-interface SearchProvider extends ContextProvider {
-  search(query: string): Promise<string | null>;
-  set?(key: string, content: string): Promise<void>;
-}
-/**
- * Check if a provider is a SearchProvider (has a `search` method).
- */
-declare function isSearchProvider(provider: unknown): provider is SearchProvider;
-/**
- * SearchProvider backed by Durable Object SQLite with FTS5.
- *
- * - `get()` returns a count of indexed entries
- * - `search(query)` full-text search using FTS5
- * - `set(key, content)` indexes or replaces content under a key
- *
- * Each instance uses a namespaced FTS5 table to avoid collisions
- * with the session message search.
- *
- * @example
- * ```ts
- * Session.create(this)
- *   .withContext("knowledge", {
- *     provider: new AgentSearchProvider(this)
- *   })
- * ```
- */
-declare class AgentSearchProvider implements SearchProvider {
-  private agent;
-  private label;
-  private initialized;
-  constructor(agent: SqlProvider);
-  init(label: string): void;
-  private ensureTable;
-  get(): Promise<string | null>;
-  search(query: string): Promise<string | null>;
-  set(key: string, content: string): Promise<void>;
-  private deleteFTS;
-}
-//#endregion
-//#region src/experimental/memory/session/skills.d.ts
-/**
- * Storage interface for skill collections.
- *
- * - `get()` returns metadata listing (rendered into system prompt)
- * - `load(key)` fetches full content (via load_context tool)
- * - `set(key, content, description?)` writes an entry (via set_context tool)
- */
-interface SkillProvider extends ContextProvider {
-  load(key: string): Promise<string | null>;
-  set?(key: string, content: string, description?: string): Promise<void>;
-}
-/**
- * Check if a provider is a SkillProvider (has a `load` method).
- */
-declare function isSkillProvider(provider: unknown): provider is SkillProvider;
-/**
- * SkillProvider backed by an R2 bucket.
- *
- * - `get()` returns a metadata listing of all skills (key + description)
- * - `load(key)` fetches a skill's full content
- * - `set(key, content, description?)` writes a skill
- *
- * Descriptions are pulled from R2 custom metadata (`description` key).
- * If a prefix is provided, it is prepended on storage operations and
- * stripped from keys in metadata.
- *
- * @example
- * ```ts
- * const skills = new R2SkillProvider(env.SKILLS_BUCKET, { prefix: "skills/" });
- * ```
- */
-declare class R2SkillProvider implements SkillProvider {
-  private bucket;
-  private prefix;
-  constructor(bucket: R2Bucket, options?: {
-    prefix?: string;
-  });
-  get(): Promise<string | null>;
-  load(key: string): Promise<string | null>;
-  set(key: string, content: string, description?: string): Promise<void>;
-}
-//#endregion
-//#region src/experimental/memory/session/context.d.ts
-/**
- * Base storage interface for a context block.
- * A provider with only `get()` is readonly.
- */
-interface ContextProvider {
-  get(): Promise<string | null>;
-  /** Called by the context system to provide the block label before first use. */
-  init?(label: string): void;
-}
-/**
- * Writable context provider — extends ContextProvider with `set()`.
- * Blocks backed by this provider are writable via the `set_context` tool.
- */
-interface WritableContextProvider extends ContextProvider {
-  set(content: string): Promise<void>;
-}
-/**
- * Check if a provider is writable (has a `set` method).
- */
-declare function isWritableProvider(provider: unknown): provider is WritableContextProvider;
-/**
- * Configuration for a context block.
- */
-interface ContextConfig {
-  /** Block label — used as key and in tool descriptions */
-  label: string;
-  /** Human-readable description (shown to AI in tool) */
-  description?: string;
-  /** Maximum tokens allowed. Enforced on set. */
-  maxTokens?: number;
-  /** Storage provider. Determines block behavior:
-   *  - ContextProvider (get only) → readonly
-   *  - WritableContextProvider (get+set) → writable via set_context
-   *  - SkillProvider (get+load+set?) → on-demand via load_context
-   *  - SearchProvider (get+search+set?) → searchable via search_context
-   *  If omitted, auto-wired to writable SQLite when using builder. */
-  provider?: ContextProvider | WritableContextProvider | SkillProvider | SearchProvider;
-}
-/**
- * A loaded context block with computed token count.
- */
-interface ContextBlock {
-  label: string;
-  description?: string;
-  content: string;
-  tokens: number;
-  maxTokens?: number;
-  /** True if provider is writable (has set) */
-  writable: boolean;
-  /** True if backed by a SkillProvider */
-  isSkill: boolean;
-  /** True if backed by a SearchProvider */
-  isSearchable: boolean;
-}
-//#endregion
-//#region src/experimental/memory/session/types.d.ts
-/**
- * Options for querying messages
- */
-interface MessageQueryOptions {
-  limit?: number;
-  offset?: number;
-  before?: Date;
-  after?: Date;
-  role?: "user" | "assistant" | "system";
-}
-/**
- * Options for creating a Session.
- */
-interface SessionOptions {
-  /** Context blocks for the system prompt. */
-  context?: ContextConfig[];
-  /** Provider for persisting the frozen system prompt. */
-  promptStore?: WritableContextProvider;
-}
-//#endregion
 //#region src/experimental/memory/session/session.d.ts
 type SessionContextOptions = Omit<ContextConfig, "label">;
 declare class Session {
@@ -286,23 +42,34 @@ declare class Session {
    * Register a compaction function. Called by `compact()` to compress
    * message history into a summary overlay.
    */
-  onCompaction(fn: (messages: UIMessage[]) => Promise<CompactResult | null>): this;
+  onCompaction(fn: (messages: SessionMessage[]) => Promise<CompactResult | null>): this;
   /**
    * Auto-compact when estimated token count exceeds the threshold.
    * Checked after each `appendMessage`. Requires `onCompaction()`.
    */
   compactAfter(tokenThreshold: number): this;
   private _ensureReady;
-  getHistory(leafId?: string | null): UIMessage[];
-  getMessage(id: string): UIMessage | null;
-  getLatestLeaf(): UIMessage | null;
-  getBranches(messageId: string): UIMessage[];
+  /**
+   * Reconstruct which skills are loaded by scanning conversation history
+   * for load_context tool results that haven't been unloaded.
+   * Called during init to survive hibernation/eviction.
+   */
+  private _restoreLoadedSkills;
+  /**
+   * Replace a load_context tool result in conversation history
+   * with a short marker to reclaim context space.
+   */
+  private _reclaimLoadedSkill;
+  getHistory(leafId?: string | null): SessionMessage[];
+  getMessage(id: string): SessionMessage | null;
+  getLatestLeaf(): SessionMessage | null;
+  getBranches(messageId: string): SessionMessage[];
   getPathLength(leafId?: string | null): number;
   private _broadcast;
   private _emitStatus;
   private _emitError;
-  appendMessage(message: UIMessage, parentId?: string | null): Promise<void>;
-  updateMessage(message: UIMessage): void;
+  appendMessage(message: SessionMessage, parentId?: string | null): Promise<void>;
+  updateMessage(message: SessionMessage): void;
   deleteMessages(messageIds: string[]): void;
   clearMessages(): void;
   addCompaction(summary: string, fromMessageId: string, toMessageId: string): StoredCompaction;
@@ -316,6 +83,37 @@ declare class Session {
   getContextBlocks(): ContextBlock[];
   replaceContextBlock(label: string, content: string): Promise<ContextBlock>;
   appendContextBlock(label: string, content: string): Promise<ContextBlock>;
+  /**
+   * Dynamically register a new context block after session initialization.
+   * Used by extensions to contribute context blocks at runtime.
+   *
+   * The block's provider is initialized and loaded immediately.
+   * Call `refreshSystemPrompt()` afterward to include the new block
+   * in the system prompt.
+   *
+   * Note: When called without a provider, auto-wires to SQLite via
+   * AgentContextProvider. Requires the session to have been created
+   * via `Session.create(agent)` (not the direct constructor).
+   */
+  addContext(label: string, options?: SessionContextOptions): Promise<ContextBlock>;
+  /**
+   * Remove a dynamically registered context block.
+   * Used during extension unload cleanup.
+   *
+   * Returns true if the block existed and was removed.
+   * Call `refreshSystemPrompt()` afterward to rebuild the prompt
+   * without the removed block.
+   */
+  removeContext(label: string): boolean;
+  /**
+   * Unload a previously loaded skill, reclaiming context space.
+   * The tool result in conversation history is replaced with a short marker.
+   */
+  unloadSkill(label: string, key: string): boolean;
+  /**
+   * Get currently loaded skill keys (as "label:key" strings).
+   */
+  getLoadedSkillKeys(): Set<string>;
   freezeSystemPrompt(): Promise<string>;
   refreshSystemPrompt(): Promise<string>;
   search(query: string, options?: {
@@ -344,12 +142,9 @@ interface SessionInfo {
   created_at: string;
   updated_at: string;
 }
-interface SessionManagerOptions {
-  maxContextMessages?: number;
-}
+interface SessionManagerOptions {}
 declare class SessionManager {
   private agent;
-  private _maxContextMessages;
   private _pending;
   private _cachedPrompt?;
   private _compactionFn?;
@@ -358,7 +153,7 @@ declare class SessionManager {
   private _historyLabel?;
   private _tableReady;
   private _ready;
-  constructor(agent: SqlProvider, options?: SessionManagerOptions);
+  constructor(agent: SqlProvider, _options?: SessionManagerOptions);
   /**
    * Chainable SessionManager creation with auto-wired context for all sessions.
    *
@@ -368,7 +163,7 @@ declare class SessionManager {
    *   .withContext("soul", { provider: { get: async () => "You are helpful." } })
    *   .withContext("memory", { description: "Learned facts", maxTokens: 1100 })
    *   .withCachedPrompt()
-   *   .maxContextMessages(50);
+   *   .compactAfter(100_000);
    *
    * // Each getSession(id) auto-creates namespaced providers:
    * //   memory key: "memory_<sessionId>"
@@ -379,12 +174,11 @@ declare class SessionManager {
   static create(agent: SqlProvider): SessionManager;
   withContext(label: string, options?: SessionContextOptions): this;
   withCachedPrompt(provider?: WritableContextProvider): this;
-  maxContextMessages(count: number): this;
   /**
    * Register a compaction function propagated to all sessions.
    * Called by `Session.compact()` to compress message history.
    */
-  onCompaction(fn: (messages: UIMessage[]) => Promise<CompactResult | null>): this;
+  onCompaction(fn: (messages: SessionMessage[]) => Promise<CompactResult | null>): this;
   /**
    * Auto-compact when estimated token count exceeds the threshold.
    * Propagated to all sessions. Requires `onCompaction()`.
@@ -420,20 +214,19 @@ declare class SessionManager {
   list(): SessionInfo[];
   delete(sessionId: string): void;
   rename(sessionId: string, name: string): void;
-  append(sessionId: string, message: UIMessage, parentId?: string): Promise<string>;
-  upsert(sessionId: string, message: UIMessage, parentId?: string): Promise<string>;
-  appendAll(sessionId: string, messages: UIMessage[], parentId?: string): Promise<string | null>;
-  getHistory(sessionId: string, leafId?: string): UIMessage[];
+  append(sessionId: string, message: SessionMessage, parentId?: string): Promise<string>;
+  upsert(sessionId: string, message: SessionMessage, parentId?: string): Promise<string>;
+  appendAll(sessionId: string, messages: SessionMessage[], parentId?: string): Promise<string | null>;
+  getHistory(sessionId: string, leafId?: string): SessionMessage[];
   getMessageCount(sessionId: string): number;
   clearMessages(sessionId: string): void;
   deleteMessages(sessionId: string, messageIds: string[]): void;
-  getBranches(sessionId: string, messageId: string): UIMessage[];
+  getBranches(sessionId: string, messageId: string): SessionMessage[];
   /**
    * Fork a session at a specific message, creating a new session
    * with the history up to that point copied over.
    */
   fork(sessionId: string, atMessageId: string, newName: string): Promise<SessionInfo>;
-  needsCompaction(sessionId: string): boolean;
   addCompaction(sessionId: string, summary: string, fromId: string, toId: string): StoredCompaction;
   getCompactions(sessionId: string): StoredCompaction[];
   compactAndSplit(sessionId: string, summary: string, newName?: string): Promise<SessionInfo>;
@@ -462,5 +255,5 @@ declare class AgentContextProvider implements WritableContextProvider {
   set(content: string): Promise<void>;
 }
 //#endregion
-export { AgentContextProvider, AgentSearchProvider, AgentSessionProvider, type ContextBlock, type ContextConfig, type ContextProvider, type MessageQueryOptions, R2SkillProvider, type SearchProvider, type SearchResult, Session, type SessionContextOptions, type SessionInfo, SessionManager, type SessionManagerOptions, type SessionOptions, type SessionProvider, type SkillProvider, type SqlProvider, type StoredCompaction, type WritableContextProvider, isSearchProvider, isSkillProvider, isWritableProvider };
+export { AgentContextProvider, AgentSearchProvider, AgentSessionProvider, type ContextBlock, type ContextConfig, type ContextProvider, R2SkillProvider, type SearchProvider, type SearchResult, Session, type SessionContextOptions, type SessionInfo, SessionManager, type SessionManagerOptions, type SessionMessage, type SessionMessagePart, type SessionOptions, type SessionProvider, type SkillProvider, type SqlProvider, type StoredCompaction, type WritableContextProvider, isSearchProvider, isSkillProvider, isWritableProvider };
 //# sourceMappingURL=index.d.ts.map