byterover-cli 1.8.0 → 2.1.0

package/dist/agent/core/domain/llm/schemas.d.ts

@@ -12,20 +12,20 @@ export declare const LLMConfigBaseSchema: z.ZodObject<{
     maxIterations: z.ZodDefault<z.ZodNumber>;
     maxOutputTokens: z.ZodOptional<z.ZodNumber>;
     model: z.ZodString;
-    provider: z.ZodEnum<["claude", "gemini", "openrouter"]>;
+    provider: z.ZodEnum<["claude", "gemini", "openai"]>;
     temperature: z.ZodOptional<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     maxIterations: number;
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     temperature?: number | undefined;
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
 }, {
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     maxIterations?: number | undefined;
     temperature?: number | undefined;
     timeout?: number | undefined;
@@ -40,20 +40,20 @@ export declare const LLMConfigSchema: z.ZodEffects<z.ZodObject<{
     maxIterations: z.ZodDefault<z.ZodNumber>;
     maxOutputTokens: z.ZodOptional<z.ZodNumber>;
     model: z.ZodString;
-    provider: z.ZodEnum<["claude", "gemini", "openrouter"]>;
+    provider: z.ZodEnum<["claude", "gemini", "openai"]>;
     temperature: z.ZodOptional<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     maxIterations: number;
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     temperature?: number | undefined;
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
 }, {
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     maxIterations?: number | undefined;
     temperature?: number | undefined;
     timeout?: number | undefined;
@@ -62,14 +62,14 @@ export declare const LLMConfigSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     maxIterations: number;
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     temperature?: number | undefined;
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
 }, {
     model: string;
-    provider: "claude" | "gemini" | "openrouter";
+    provider: "claude" | "gemini" | "openai";
     maxIterations?: number | undefined;
     temperature?: number | undefined;
     timeout?: number | undefined;
@@ -93,7 +93,7 @@ export declare const LLMUpdatesSchema: z.ZodEffects<z.ZodObject<{
     maxIterations: z.ZodOptional<z.ZodNumber>;
     maxOutputTokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     model: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodEnum<["claude", "gemini", "openrouter"]>>;
+    provider: z.ZodOptional<z.ZodEnum<["claude", "gemini", "openai"]>>;
     temperature: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     timeout: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
@@ -103,7 +103,7 @@ export declare const LLMUpdatesSchema: z.ZodEffects<z.ZodObject<{
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
-    provider?: "claude" | "gemini" | "openrouter" | undefined;
+    provider?: "claude" | "gemini" | "openai" | undefined;
 }, {
     maxIterations?: number | undefined;
     model?: string | undefined;
@@ -111,7 +111,7 @@ export declare const LLMUpdatesSchema: z.ZodEffects<z.ZodObject<{
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
-    provider?: "claude" | "gemini" | "openrouter" | undefined;
+    provider?: "claude" | "gemini" | "openai" | undefined;
 }>, {
     maxIterations?: number | undefined;
     model?: string | undefined;
@@ -119,7 +119,7 @@ export declare const LLMUpdatesSchema: z.ZodEffects<z.ZodObject<{
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
-    provider?: "claude" | "gemini" | "openrouter" | undefined;
+    provider?: "claude" | "gemini" | "openai" | undefined;
 }, {
     maxIterations?: number | undefined;
     model?: string | undefined;
@@ -127,7 +127,7 @@ export declare const LLMUpdatesSchema: z.ZodEffects<z.ZodObject<{
     timeout?: number | undefined;
     maxInputTokens?: number | undefined;
     maxOutputTokens?: number | undefined;
-    provider?: "claude" | "gemini" | "openrouter" | undefined;
+    provider?: "claude" | "gemini" | "openai" | undefined;
 }>;
 /**
  * Input type for LLM updates.

package/dist/agent/core/domain/llm/schemas.js

@@ -6,7 +6,7 @@
 import { z } from 'zod';
 import { ErrorScope, ErrorType, LLMErrorCode } from './error-codes.js';
 import { acceptsAnyModel, getMaxInputTokensForModel, getSupportedModels, isValidProviderModel } from './registry.js';
-import { LLM_PROVIDERS } from './types.js';
+import { PROVIDER_TYPES } from './types.js';
 /**
  * Default-free field definitions for LLM configuration.
  * Used to build both the full config schema (with defaults) and the updates schema (no defaults).
@@ -34,8 +34,8 @@ const LLMConfigFields = {
         .min(1, 'Model name is required')
         .describe('Specific model name for the selected provider'),
     provider: z
-        .enum(LLM_PROVIDERS)
-        .describe("LLM provider (e.g., 'claude', 'gemini', 'openrouter')"),
+        .enum(PROVIDER_TYPES)
+        .describe("LLM provider type (e.g., 'claude', 'gemini', 'openai')"),
     temperature: z.coerce
         .number()
         .min(0)

package/dist/agent/core/domain/llm/types.d.ts

@@ -4,13 +4,23 @@
  * This module defines the core types for LLM provider abstraction,
  */
 /**
- * Supported LLM providers as a const array for runtime validation.
+ * Provider types for formatter/tokenizer selection.
+ * These represent the underlying API format, NOT provider IDs.
+ * e.g., OpenRouter, xAI, Groq, Mistral all use 'openai' format.
  */
-export declare const LLM_PROVIDERS: readonly ["claude", "gemini", "openrouter"];
+export declare const PROVIDER_TYPES: readonly ["claude", "gemini", "openai"];
 /**
- * Union type of all supported LLM providers.
+ * Union type of provider types.
  */
-export type LLMProvider = (typeof LLM_PROVIDERS)[number];
+export type ProviderType = (typeof PROVIDER_TYPES)[number];
+/**
+ * @deprecated Use PROVIDER_TYPES instead. Kept for backward compatibility.
+ */
+export declare const LLM_PROVIDERS: readonly ["claude", "gemini", "openai"];
+/**
+ * @deprecated Use ProviderType instead. Kept for backward compatibility.
+ */
+export type LLMProvider = ProviderType;
 /**
  * Supported file types for multimodal input.
  */
@@ -84,7 +94,7 @@ export interface LLMContext {
     /** Current model name */
     model: string;
     /** Current provider */
-    provider: LLMProvider;
+    provider: ProviderType;
 }
 /**
  * Token usage statistics.

package/dist/agent/core/domain/llm/types.js

@@ -4,9 +4,15 @@
  * This module defines the core types for LLM provider abstraction,
  */
 /**
- * Supported LLM providers as a const array for runtime validation.
+ * Provider types for formatter/tokenizer selection.
+ * These represent the underlying API format, NOT provider IDs.
+ * e.g., OpenRouter, xAI, Groq, Mistral all use 'openai' format.
  */
-export const LLM_PROVIDERS = ['claude', 'gemini', 'openrouter'];
+export const PROVIDER_TYPES = ['claude', 'gemini', 'openai'];
+/**
+ * @deprecated Use PROVIDER_TYPES instead. Kept for backward compatibility.
+ */
+export const LLM_PROVIDERS = PROVIDER_TYPES;
 /**
  * Supported file types for multimodal input.
  */

package/dist/agent/core/domain/sandbox/types.d.ts

@@ -6,8 +6,12 @@
  * Result of code execution in the sandbox.
  */
 export interface REPLResult {
+    /** Accumulated curate() call results from within sandbox execution */
+    curateResults?: unknown[];
     /** Execution time in milliseconds */
     executionTime: number;
+    /** If set by setFinalResult(), signals early termination of the agentic loop */
+    finalResult?: string;
     /** Current context state (variable names to values) */
     locals: Record<string, unknown>;
     /** Return value of the last expression (if any) */
@@ -21,10 +25,14 @@ export interface REPLResult {
  * Configuration for sandbox execution.
  */
 export interface SandboxConfig {
+    /** Command type for gating SDK operations (e.g., 'query' disables curate/writeFile) */
+    commandType?: string;
     /** Context data to preload as "context" variable */
     contextPayload?: Record<string, unknown> | string | unknown[];
     /** Language: 'javascript' or 'typescript' (default: auto-detect) */
     language?: 'javascript' | 'typescript';
+    /** Cap stdout buffer at this many characters. undefined = unlimited. */
+    maxStdoutChars?: number;
     /** Timeout in ms (default: 30000, max: 300000) */
     timeout?: number;
 }

package/dist/agent/core/domain/session/session-metadata.d.ts

@@ -2,7 +2,7 @@
  * Session Metadata Types and Schemas
  *
  * Defines the data structures for persistent session management.
- * Sessions are stored in .brv/sessions/ directory as JSON files.
+ * Sessions are stored in the XDG sessions directory as JSON files.
  *
  * Design adapted from gemini-cli's ChatRecordingService pattern.
  */
@@ -12,7 +12,7 @@ import { z } from 'zod';
  */
 export type SessionStatus = 'active' | 'ended' | 'interrupted';
 /**
- * Active session pointer stored in .brv/sessions/active.json
+ * Active session pointer stored in active.json within sessions directory
  * Points to the currently active session for auto-resume.
  */
 export interface ActiveSessionPointer {
@@ -41,6 +41,8 @@ export interface SessionMetadata {
     lastUpdated: string;
     /** Number of messages in session (cached for quick display) */
     messageCount: number;
+    /** Provider ID active when session was created (for cross-provider resume detection) */
+    providerId?: string;
     /** Unique session identifier (UUID) */
     sessionId: string;
     /** Session lifecycle status */
@@ -104,6 +106,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     createdAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
     lastUpdated: z.ZodUnion<[z.ZodString, z.ZodString]>;
     messageCount: z.ZodNumber;
+    providerId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodString;
     status: z.ZodEnum<["active", "ended", "interrupted"]>;
     summary: z.ZodOptional<z.ZodString>;
@@ -116,6 +119,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     lastUpdated: string;
     messageCount: number;
     workingDirectory: string;
+    providerId?: string | undefined;
     summary?: string | undefined;
     title?: string | undefined;
 }, {
@@ -125,6 +129,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     lastUpdated: string;
     messageCount: number;
     workingDirectory: string;
+    providerId?: string | undefined;
     summary?: string | undefined;
     title?: string | undefined;
 }>;

package/dist/agent/core/domain/session/session-metadata.js

@@ -2,7 +2,7 @@
  * Session Metadata Types and Schemas
  *
  * Defines the data structures for persistent session management.
- * Sessions are stored in .brv/sessions/ directory as JSON files.
+ * Sessions are stored in the XDG sessions directory as JSON files.
  *
  * Design adapted from gemini-cli's ChatRecordingService pattern.
  */
@@ -14,7 +14,10 @@ import { z } from 'zod';
  * Schema for ActiveSessionPointer validation.
  */
 export const ActiveSessionPointerSchema = z.object({
-    activatedAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    activatedAt: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
     pid: z.number().int().positive(),
     // Optional for backward compatibility with existing session files (treated as stale if missing)
     processToken: z.string().optional(),
@@ -24,9 +27,16 @@ export const ActiveSessionPointerSchema = z.object({
  * Schema for SessionMetadata validation.
  */
 export const SessionMetadataSchema = z.object({
-    createdAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
-    lastUpdated: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    createdAt: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    lastUpdated: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
     messageCount: z.number().int().nonnegative(),
+    providerId: z.string().optional(),
     sessionId: z.string().min(1),
     status: z.enum(['active', 'ended', 'interrupted']),
     summary: z.string().optional(),

package/dist/agent/core/domain/streaming/types.d.ts

@@ -89,6 +89,8 @@ export type StreamingEvent = {
 export interface StreamOptions {
     /** Execution context */
     executionContext?: ExecutionContext;
+    /** Session ID override — uses default session if not provided (for per-task session isolation) */
+    sessionId?: string;
     /** AbortSignal for cancellation */
     signal?: AbortSignal;
     /** Task ID for concurrent task isolation (included in all emitted events) */

package/dist/agent/core/domain/tools/constants.d.ts

@@ -3,11 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export declare const ToolName: {
+    readonly AGENTIC_MAP: 'agentic_map';
     readonly CODE_EXEC: 'code_exec';
     readonly CURATE: 'curate';
+    readonly EXPAND_KNOWLEDGE: 'expand_knowledge';
     readonly GLOB_FILES: 'glob_files';
     readonly GREP_CONTENT: 'grep_content';
     readonly LIST_DIRECTORY: 'list_directory';
+    readonly LLM_MAP: 'llm_map';
     readonly READ_FILE: 'read_file';
     readonly SEARCH_KNOWLEDGE: 'search_knowledge';
     readonly WRITE_FILE: 'write_file';

package/dist/agent/core/domain/tools/constants.js

@@ -3,11 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export const ToolName = {
+    AGENTIC_MAP: 'agentic_map',
     CODE_EXEC: 'code_exec',
     CURATE: 'curate',
+    EXPAND_KNOWLEDGE: 'expand_knowledge',
     GLOB_FILES: 'glob_files',
     GREP_CONTENT: 'grep_content',
     LIST_DIRECTORY: 'list_directory',
+    LLM_MAP: 'llm_map',
     READ_FILE: 'read_file',
     SEARCH_KNOWLEDGE: 'search_knowledge',
     WRITE_FILE: 'write_file',

package/dist/agent/core/domain/tools/types.d.ts

@@ -82,6 +82,8 @@ export interface Tool {
  * Contains metadata about the execution environment.
  */
 export interface ToolExecutionContext {
+    /** Command type for context-aware tool behavior (e.g., 'curate', 'query') */
+    commandType?: string;
     /**
      * Callback for streaming metadata updates during execution.
      * Tools can use this to push real-time output (e.g., bash streaming).

package/dist/agent/core/interfaces/cipher-services.d.ts

@@ -34,17 +34,15 @@ export interface CipherAgentServices {
     blobStorage: IBlobStorage;
     /**
      * CompactionService for context overflow management.
-     * Only available when granular storage is enabled (useGranularStorage: true).
      */
-    compactionService?: CompactionService;
+    compactionService: CompactionService;
     fileSystemService: FileSystemService;
     historyStorage: IHistoryStorage;
     memoryManager: MemoryManager;
     /**
      * MessageStorageService for direct granular message access.
-     * Only available when granular storage is enabled (useGranularStorage: true).
      */
-    messageStorageService?: MessageStorageService;
+    messageStorageService: MessageStorageService;
     policyEngine: IPolicyEngine;
     processService: ProcessService;
     sandboxService: ISandboxService;

package/dist/agent/core/interfaces/i-chat-session.d.ts

@@ -48,7 +48,7 @@ export interface IChatSession {
      * Reset the conversation history.
      * Clears all messages except the system prompt (if present).
      */
-    reset(): void;
+    reset(): Promise<void>;
     /**
      * Send a message and get a response.
      * Handles tool execution loop automatically.

package/dist/agent/core/interfaces/i-cipher-agent.d.ts

@@ -7,6 +7,8 @@ import type { ConversationMetadata } from '../domain/system-prompt/types.js';
  * Contains runtime information about how the agent is being executed
  */
 export interface ExecutionContext {
+    /** Clear conversation history before execution (RLM mode — prevents accumulation across calls) */
+    clearHistory?: boolean;
     /** Command type that initiated the execution (for command-specific prompt loading) */
     commandType?: 'chat' | 'curate' | 'query';
     /** Metadata about the conversation (for JSON input mode) */
@@ -62,12 +64,47 @@ export interface ICipherAgent {
      * @returns true if a run was in progress and was signaled to abort; false otherwise
      */
     cancel(): Promise<boolean>;
+    /**
+     * Create a task-scoped child session for parallel execution.
+     * The session gets its own sandbox, context manager, and LLM service.
+     *
+     * @param taskId - Unique task identifier (used as part of session ID)
+     * @param commandType - Command type for agent name tracking ('curate' | 'query')
+     * @param options - Optional configuration
+     * @param options.mapRootEligible - If true, registers the session as root-eligible for
+     *   agentic_map calls (Guard C). Only set for top-level task sessions that may invoke
+     *   agentic_map directly (e.g., curate-executor, folder-pack-executor). Defaults to false.
+     * @returns Session ID of the created task session
+     */
+    createTaskSession(taskId: string, commandType: string, options?: {
+        mapRootEligible?: boolean;
+    }): Promise<string>;
+    /**
+     * Delete a sandbox variable from the agent's default session.
+     *
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariable(key: string): void;
+    /**
+     * Delete a sandbox variable from a specific session's sandbox.
+     *
+     * @param sessionId - Target session
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariableOnSession(sessionId: string, key: string): void;
     /**
      * Delete a session completely (memory + history)
      * @param sessionId - Session ID to delete
      * @returns True if session existed and was deleted
      */
     deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Delete a task session and all its resources (sandbox + history).
+     * Use this for cleanup after per-task session execution.
+     *
+     * @param sessionId - Task session ID to delete
+     */
+    deleteTaskSession(sessionId: string): Promise<void>;
     /**
      * Execute the agent with user input.
      * Uses the agent's default session (created during start()).
@@ -82,6 +119,21 @@ export interface ICipherAgent {
         executionContext?: ExecutionContext;
         taskId?: string;
     }): Promise<string>;
+    /**
+     * Execute the agent on a specific session (not the default session).
+     * Used for per-task session isolation in parallel execution.
+     *
+     * @param sessionId - Session to execute on
+     * @param input - User input string
+     * @param options - Optional execution options
+     * @param options.executionContext - Optional context for command-specific behavior (curate/query/chat)
+     * @param options.taskId - Optional task ID for event routing (required for concurrent task isolation)
+     * @returns Agent response
+     */
+    executeOnSession(sessionId: string, input: string, options?: {
+        executionContext?: ExecutionContext;
+        taskId?: string;
+    }): Promise<string>;
     /**
      * Generate a complete response (waits for full completion).
      * Wrapper around stream() that collects all events and returns final result.
@@ -113,6 +165,24 @@ export interface ICipherAgent {
      * Clears execution history and resets iteration counter
      */
     reset(): void;
+    /**
+     * Set a variable in the agent's default session sandbox.
+     * If the sandbox doesn't exist yet, the variable is buffered and injected
+     * when the sandbox is created on the first code execution.
+     *
+     * @param key - Variable name
+     * @param value - Variable value
+     */
+    setSandboxVariable(key: string, value: unknown): void;
+    /**
+     * Set a variable in a specific session's sandbox.
+     * Used for per-task session isolation in parallel execution.
+     *
+     * @param sessionId - Target session
+     * @param key - Variable name
+     * @param value - Variable value
+     */
+    setSandboxVariableOnSession(sessionId: string, key: string, value: unknown): void;
     /**
      * Start the agent - initializes all services asynchronously
      * Must be called before execute()

package/dist/agent/core/interfaces/i-curate-service.d.ts

@@ -8,11 +8,11 @@
 export interface CurateRawConcept {
     /** Author or source attribution */
     author?: string;
-    /** What changes in the codebase are induced by this concept */
+    /** Changes, updates, or modifications relevant to this concept (code changes, process updates, market shifts, etc.) */
     changes?: string[];
-    /** Which files are related to this concept */
+    /** Related resources: source files, documents, URLs, data sources, or references */
     files?: string[];
-    /** What is the flow included in this concept */
+    /** Process flow, workflow, or sequence of steps */
     flow?: string;
     /** Regex or validation patterns with descriptions */
     patterns?: Array<{
@@ -29,21 +29,36 @@ export interface CurateRawConcept {
  * Narrative section for descriptive and structural context.
  */
 export interface CurateNarrative {
-    /** Dependency management information */
+    /** Dependencies, prerequisites, blockers, or relationship information */
     dependencies?: string;
-    /** Examples and use cases */
+    /** Concrete examples, use cases, or action items */
     examples?: string;
-    /** Feature documentation for this concept */
-    features?: string;
+    /** Key highlights, capabilities, deliverables, or notable outcomes */
+    highlights?: string;
     /** Exact rules, constraints, or guidelines - preserved verbatim */
     rules?: string;
-    /** Code structure documentation */
+    /** Structural or organizational documentation (hierarchies, layouts, timelines, schemas) */
     structure?: string;
 }
+/**
+ * A factual statement extracted during curation.
+ */
+export interface CurateFact {
+    /** Category of the fact */
+    category?: 'convention' | 'environment' | 'other' | 'personal' | 'preference' | 'project' | 'team';
+    /** The full factual statement */
+    statement: string;
+    /** What the fact is about (e.g., "user_name", "database") */
+    subject?: string;
+    /** The extracted value (e.g., "Andy", "PostgreSQL 15") */
+    value?: string;
+}
 /**
  * Content structure for ADD and UPDATE operations.
  */
 export interface CurateContent {
+    /** Factual statements extracted from content */
+    facts?: CurateFact[];
     /** Narrative section with descriptive and structural context */
     narrative?: CurateNarrative;
     /** Raw concept section with metadata and technical footprint */

package/dist/agent/core/interfaces/i-history-storage.d.ts

@@ -7,6 +7,14 @@ import type { InternalMessage } from './message-types.js';
  * to persist and restore conversation history across sessions.
  */
 export interface IHistoryStorage {
+    /**
+     * Append a single message to the session history.
+     * More efficient than saveHistory for incremental updates.
+     *
+     * @param sessionId - Unique session identifier
+     * @param message - Single message to append
+     */
+    appendMessage(sessionId: string, message: InternalMessage): Promise<void>;
     /**
      * Delete all history for a specific session.
      *

package/dist/agent/core/interfaces/i-key-storage.d.ts

@@ -71,6 +71,17 @@ export interface IKeyStorage {
      * @returns Array of matching full keys
      */
     list(prefix: StorageKey): Promise<StorageKey[]>;
+    /**
+     * List all key-value pairs matching a prefix.
+     * More efficient than list() followed by individual get() calls.
+     *
+     * @param prefix - Key prefix to match
+     * @returns Array of key-value pairs
+     */
+    listWithValues<T>(prefix: StorageKey): Promise<Array<{
+        key: StorageKey;
+        value: T;
+    }>>;
     /**
      * Set a value at a composite key.
      * Creates or overwrites the value at the key.

package/dist/agent/core/interfaces/i-llm-service.d.ts

@@ -1,5 +1,5 @@
+import type { LLMServiceConfig } from '../../infra/llm/agent-llm-service.js';
 import type { ContextManager, FileData, ImageData } from '../../infra/llm/context/context-manager.js';
-import type { LLMServiceConfig } from '../../infra/llm/internal-llm-service.js';
 import type { ToolSet } from '../domain/tools/types.js';
 import type { ExecutionContext } from './i-cipher-agent.js';
 /**

package/dist/agent/core/interfaces/i-sandbox-service.d.ts

@@ -1,6 +1,8 @@
 import type { ISearchKnowledgeService } from '../../infra/sandbox/tools-sdk.js';
+import type { SessionManager } from '../../infra/session/session-manager.js';
 import type { EnvironmentContext } from '../domain/environment/types.js';
 import type { REPLResult, SandboxConfig } from '../domain/sandbox/types.js';
+import type { IContentGenerator } from './i-content-generator.js';
 import type { ICurateService } from './i-curate-service.js';
 import type { IFileSystem } from './i-file-system.js';
 /**
@@ -18,6 +20,14 @@ export interface ISandboxService {
      * @param sessionId - Session identifier
      */
     clearSession(sessionId: string): Promise<void>;
+    /**
+     * Delete a variable from a session's sandbox.
+     * If the sandbox doesn't exist yet, cleans up any pending variable with that key.
+     *
+     * @param sessionId - Session identifier
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariable(sessionId: string, key: string): void;
     /**
      * Execute JavaScript/TypeScript code in a sandbox.
      *
@@ -27,6 +37,13 @@ export interface ISandboxService {
      * @returns Execution result with stdout, stderr, and locals
      */
     executeCode(code: string, sessionId: string, config?: SandboxConfig): Promise<REPLResult>;
+    /**
+     * Set the content generator for parallel LLM operations (mapExtract).
+     * When set, sandboxes will have access to `tools.curation.mapExtract()`.
+     *
+     * @param contentGenerator - Content generator instance
+     */
+    setContentGenerator?(contentGenerator: IContentGenerator): void;
     /**
      * Set the curate service for Tools SDK injection.
      * When set, sandboxes will have access to curate operations via `tools.curate()`.
@@ -48,6 +65,16 @@ export interface ISandboxService {
      * @param fileSystem - File system service instance
      */
     setFileSystem?(fileSystem: IFileSystem): void;
+    /**
+     * Set a variable in a session's sandbox.
+     * If the sandbox doesn't exist yet, the variable is buffered and injected
+     * when the sandbox is created on the first executeCode() call.
+     *
+     * @param sessionId - Session identifier
+     * @param key - Variable name
+     * @param value - Variable value (must be JSON-serializable or a plain object)
+     */
+    setSandboxVariable(sessionId: string, key: string, value: unknown): void;
     /**
      * Set the search knowledge service for Tools SDK injection.
      * When set, sandboxes will have access to knowledge search via `tools.searchKnowledge()`.
@@ -55,4 +82,11 @@ export interface ISandboxService {
      * @param searchKnowledgeService - Search knowledge service instance
      */
     setSearchKnowledgeService?(searchKnowledgeService: ISearchKnowledgeService): void;
+    /**
+     * Set the session manager for sub-agent delegation.
+     * When set, sandboxes will have access to `tools.agentQuery()`.
+     *
+     * @param sessionManager - Session manager instance
+     */
+    setSessionManager?(sessionManager: SessionManager): void;
 }