@xenosystem/agent-sdk 0.10.36 → 0.10.37

package/dist/mcp/index.d.cts

@@ -76,6 +76,12 @@ interface ToolDefinition {
         additionalProperties?: boolean | Record<string, unknown>;
         [keyword: string]: unknown;
     };
+    grammar?: ToolInputGrammar;
+}
+interface ToolInputGrammar {
+    syntax: "gbnf";
+    definition: string;
+    inputField: string;
 }
 interface ImageUrlBlock {
     type: "image_url";
@@ -234,6 +240,14 @@ interface TextBlock {
     type: "text";
     text: string;
 }
+type MemoryLevel = "global" | "project" | "role" | "session";
+interface MemoryBudget {
+    global: number;
+    project: number;
+    role: number;
+    session: number;
+    total: number;
+}
 declare const MCP_APPS_EXTENSION_ID: "io.modelcontextprotocol/ui";
 declare const MCP_APP_RESOURCE_SCHEME: "ui:";
 declare const MCP_APP_MIME_TYPE: "text/html;profile=mcp-app";
@@ -561,6 +575,7 @@ interface MCPConfiguredServer extends MCPServerConfig {
 }
 interface ConnectConfiguredMCPServersOptions {
     cwd: string;
+    filter?: (server: MCPConfiguredServer) => boolean;
     promptForApproval?: (server: MCPConfiguredServer) => Promise<MCPApprovalDecision>;
 }
 interface ConnectConfiguredMCPServersResult {
@@ -647,6 +662,7 @@ declare class MCPManager {
     private readonly fetcher?;
     private readonly appCapabilities?;
     constructor(options?: MCPManagerOptions);
+    get configuredServerFilterVersion(): 1;
     onServerStateChanged(listener: MCPServerChangeListener): () => void;
     addServer(config: MCPServerConfig): Promise<void>;
     connectConfiguredServers(options: ConnectConfiguredMCPServersOptions): Promise<ConnectConfiguredMCPServersResult>;
@@ -695,6 +711,132 @@ declare class MCPManager {
     private resolveApprovalDecision;
     private emitServerStateChanged;
 }
+interface MemoryFile {
+    level: MemoryLevel;
+    path: string;
+    content: string;
+    tokenCount: number;
+    lastModified?: Date;
+}
+interface ResolvedMemory {
+    files: MemoryFile[];
+    byLevel: Record<MemoryLevel, string>;
+    totalTokens: number;
+    truncated: boolean;
+}
+interface ProjectSessionContextEntry {
+    sessionId: string;
+    model: string;
+    lastActivity: string;
+    messageCount: number;
+    excerpt: string;
+}
+interface ProjectSessionContext {
+    entries: ProjectSessionContextEntry[];
+    totalTokens: number;
+    truncated: boolean;
+    content: string;
+}
+interface MemoryManagerOptions {
+    cwd: string;
+    globalDir?: string;
+    role?: string;
+    sessionDir?: string;
+    scope?: MemoryAccessScope;
+    budgets?: Partial<MemoryBudget>;
+    projectSessionContext?: {
+        limit?: number;
+        maxTokens?: number;
+        maxCharsPerSession?: number;
+    };
+}
+type MemoryAccessScope = "none" | "session" | "project" | "user";
+declare class MemoryManager {
+    private cwd;
+    private globalDir;
+    private role?;
+    private sessionDir?;
+    private scope;
+    private budgets;
+    private projectSessionContextDefaults;
+    constructor(options: MemoryManagerOptions);
+    get accessScope(): MemoryAccessScope;
+    canAccessLevel(level: MemoryLevel): boolean;
+    private assertLevelAccess;
+    getProjectSessionContextDefaults(): {
+        limit: number;
+        maxTokens: number;
+        maxCharsPerSession: number;
+    };
+    getPath(level: MemoryLevel): string;
+    loadForPrompt(): Promise<ResolvedMemory>;
+    loadProjectSessionContext(options?: {
+        excludeSessionId?: string;
+        limit?: number;
+        maxTokens?: number;
+        maxCharsPerSession?: number;
+    }): Promise<ProjectSessionContext>;
+    private filterProjectSessions;
+    private normalizePath;
+    private extractRecentTranscriptExcerpt;
+    private formatProjectSessionEntry;
+    add(level: MemoryLevel, content: string, source: "user" | "auto"): Promise<void>;
+    set(level: MemoryLevel, content: string): Promise<void>;
+    formatForPrompt(memory: ResolvedMemory): string;
+    private truncateContent;
+}
+interface AskUserRequest {
+    question: string;
+    options?: string[];
+    context?: string;
+    signal?: AbortSignal;
+}
+interface AskUserResponse {
+    answer: string;
+    selectedOption?: string;
+}
+interface DispatchAgentRequest {
+    agent?: string;
+    prompt: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    dispatchId?: string;
+}
+interface DispatchAgentTermination {
+    status: "completed" | "incomplete" | "suspended" | "interrupted" | "error";
+    reason: string;
+    message?: string;
+}
+interface DispatchAgentResponse {
+    output: string;
+    termination?: DispatchAgentTermination;
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+interface FileObservation {
+    path: string;
+    mtimeMs: number;
+    size: number;
+    source: "read" | "write" | "edit" | "notebook" | "shell";
+    requiresRefresh?: boolean;
+    reason?: string;
+}
+interface ToolRuntimeContext {
+    getCwd(): string;
+    setCwd(nextCwd: string): void;
+    getOwnerSessionId(): string | undefined;
+    getMemoryManager(): MemoryManager | undefined;
+    setMemoryManager(memoryManager: MemoryManager | undefined): void;
+    noteFileObservation(filePath: string, observation: Omit<FileObservation, "path">): void;
+    getFileObservation(filePath: string): FileObservation | undefined;
+    invalidateFileObservation(filePath: string, reason: string): void;
+    listFileObservations(): FileObservation[];
+    askUser?(request: AskUserRequest): Promise<AskUserResponse>;
+    dispatchAgent?(request: DispatchAgentRequest): Promise<DispatchAgentResponse>;
+}
 interface ToolRegistryOptions {
     validateInputs?: boolean;
     toolSchemaMode?: "all" | "demand";
@@ -707,10 +849,14 @@ declare class ToolRegistry {
     private validateInputs;
     private readonly toolSchemaMode;
     private readonly activatedDefinitions;
+    private memoryRuntime?;
+    private memoryBindingScope?;
     constructor(options?: ToolRegistryOptions);
     setValidateInputs(enabled: boolean): this;
     get inputValidationEnabled(): boolean;
     get schemaLoadingMode(): "all" | "demand";
+    bindMemoryManager(manager: MemoryManager | undefined): void;
+    attachMemoryRuntime(runtime: ToolRuntimeContext, scope?: MemoryManager["accessScope"]): void;
     register(tool: RegisteredTool): void;
     registerAlias(tool: RegisteredTool): void;
     registerAll(tools: Iterable<RegisteredTool>): void;

package/dist/mcp/index.d.ts

@@ -76,6 +76,12 @@ interface ToolDefinition {
         additionalProperties?: boolean | Record<string, unknown>;
         [keyword: string]: unknown;
     };
+    grammar?: ToolInputGrammar;
+}
+interface ToolInputGrammar {
+    syntax: "gbnf";
+    definition: string;
+    inputField: string;
 }
 interface ImageUrlBlock {
     type: "image_url";
@@ -234,6 +240,14 @@ interface TextBlock {
     type: "text";
     text: string;
 }
+type MemoryLevel = "global" | "project" | "role" | "session";
+interface MemoryBudget {
+    global: number;
+    project: number;
+    role: number;
+    session: number;
+    total: number;
+}
 declare const MCP_APPS_EXTENSION_ID: "io.modelcontextprotocol/ui";
 declare const MCP_APP_RESOURCE_SCHEME: "ui:";
 declare const MCP_APP_MIME_TYPE: "text/html;profile=mcp-app";
@@ -561,6 +575,7 @@ interface MCPConfiguredServer extends MCPServerConfig {
 }
 interface ConnectConfiguredMCPServersOptions {
     cwd: string;
+    filter?: (server: MCPConfiguredServer) => boolean;
     promptForApproval?: (server: MCPConfiguredServer) => Promise<MCPApprovalDecision>;
 }
 interface ConnectConfiguredMCPServersResult {
@@ -647,6 +662,7 @@ declare class MCPManager {
     private readonly fetcher?;
     private readonly appCapabilities?;
     constructor(options?: MCPManagerOptions);
+    get configuredServerFilterVersion(): 1;
     onServerStateChanged(listener: MCPServerChangeListener): () => void;
     addServer(config: MCPServerConfig): Promise<void>;
     connectConfiguredServers(options: ConnectConfiguredMCPServersOptions): Promise<ConnectConfiguredMCPServersResult>;
@@ -695,6 +711,132 @@ declare class MCPManager {
     private resolveApprovalDecision;
     private emitServerStateChanged;
 }
+interface MemoryFile {
+    level: MemoryLevel;
+    path: string;
+    content: string;
+    tokenCount: number;
+    lastModified?: Date;
+}
+interface ResolvedMemory {
+    files: MemoryFile[];
+    byLevel: Record<MemoryLevel, string>;
+    totalTokens: number;
+    truncated: boolean;
+}
+interface ProjectSessionContextEntry {
+    sessionId: string;
+    model: string;
+    lastActivity: string;
+    messageCount: number;
+    excerpt: string;
+}
+interface ProjectSessionContext {
+    entries: ProjectSessionContextEntry[];
+    totalTokens: number;
+    truncated: boolean;
+    content: string;
+}
+interface MemoryManagerOptions {
+    cwd: string;
+    globalDir?: string;
+    role?: string;
+    sessionDir?: string;
+    scope?: MemoryAccessScope;
+    budgets?: Partial<MemoryBudget>;
+    projectSessionContext?: {
+        limit?: number;
+        maxTokens?: number;
+        maxCharsPerSession?: number;
+    };
+}
+type MemoryAccessScope = "none" | "session" | "project" | "user";
+declare class MemoryManager {
+    private cwd;
+    private globalDir;
+    private role?;
+    private sessionDir?;
+    private scope;
+    private budgets;
+    private projectSessionContextDefaults;
+    constructor(options: MemoryManagerOptions);
+    get accessScope(): MemoryAccessScope;
+    canAccessLevel(level: MemoryLevel): boolean;
+    private assertLevelAccess;
+    getProjectSessionContextDefaults(): {
+        limit: number;
+        maxTokens: number;
+        maxCharsPerSession: number;
+    };
+    getPath(level: MemoryLevel): string;
+    loadForPrompt(): Promise<ResolvedMemory>;
+    loadProjectSessionContext(options?: {
+        excludeSessionId?: string;
+        limit?: number;
+        maxTokens?: number;
+        maxCharsPerSession?: number;
+    }): Promise<ProjectSessionContext>;
+    private filterProjectSessions;
+    private normalizePath;
+    private extractRecentTranscriptExcerpt;
+    private formatProjectSessionEntry;
+    add(level: MemoryLevel, content: string, source: "user" | "auto"): Promise<void>;
+    set(level: MemoryLevel, content: string): Promise<void>;
+    formatForPrompt(memory: ResolvedMemory): string;
+    private truncateContent;
+}
+interface AskUserRequest {
+    question: string;
+    options?: string[];
+    context?: string;
+    signal?: AbortSignal;
+}
+interface AskUserResponse {
+    answer: string;
+    selectedOption?: string;
+}
+interface DispatchAgentRequest {
+    agent?: string;
+    prompt: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    dispatchId?: string;
+}
+interface DispatchAgentTermination {
+    status: "completed" | "incomplete" | "suspended" | "interrupted" | "error";
+    reason: string;
+    message?: string;
+}
+interface DispatchAgentResponse {
+    output: string;
+    termination?: DispatchAgentTermination;
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+interface FileObservation {
+    path: string;
+    mtimeMs: number;
+    size: number;
+    source: "read" | "write" | "edit" | "notebook" | "shell";
+    requiresRefresh?: boolean;
+    reason?: string;
+}
+interface ToolRuntimeContext {
+    getCwd(): string;
+    setCwd(nextCwd: string): void;
+    getOwnerSessionId(): string | undefined;
+    getMemoryManager(): MemoryManager | undefined;
+    setMemoryManager(memoryManager: MemoryManager | undefined): void;
+    noteFileObservation(filePath: string, observation: Omit<FileObservation, "path">): void;
+    getFileObservation(filePath: string): FileObservation | undefined;
+    invalidateFileObservation(filePath: string, reason: string): void;
+    listFileObservations(): FileObservation[];
+    askUser?(request: AskUserRequest): Promise<AskUserResponse>;
+    dispatchAgent?(request: DispatchAgentRequest): Promise<DispatchAgentResponse>;
+}
 interface ToolRegistryOptions {
     validateInputs?: boolean;
     toolSchemaMode?: "all" | "demand";
@@ -707,10 +849,14 @@ declare class ToolRegistry {
     private validateInputs;
     private readonly toolSchemaMode;
     private readonly activatedDefinitions;
+    private memoryRuntime?;
+    private memoryBindingScope?;
     constructor(options?: ToolRegistryOptions);
     setValidateInputs(enabled: boolean): this;
     get inputValidationEnabled(): boolean;
     get schemaLoadingMode(): "all" | "demand";
+    bindMemoryManager(manager: MemoryManager | undefined): void;
+    attachMemoryRuntime(runtime: ToolRuntimeContext, scope?: MemoryManager["accessScope"]): void;
     register(tool: RegisteredTool): void;
     registerAlias(tool: RegisteredTool): void;
     registerAll(tools: Iterable<RegisteredTool>): void;