@xenosystem/agent-sdk 0.10.36 → 0.10.38

package/dist/electron/index.d.cts

@@ -166,6 +166,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";
@@ -442,6 +448,14 @@ interface PermissionPromptInfo {
     };
 }
 type PermissionPromptFn = (info: PermissionPromptInfo) => Promise<"allow" | "always" | "deny">;
+type MemoryLevel = "global" | "project" | "role" | "session";
+interface MemoryBudget {
+    global: number;
+    project: number;
+    role: number;
+    session: number;
+    total: number;
+}
 type SessionStatus = "creating" | "active" | "paused" | "completed" | "abandoned" | "archived";
 interface AgentSessionHostBindingV1 {
     schemaVersion: 1;
@@ -640,6 +654,132 @@ interface PolicyEnforcerConfig {
     };
 }
 type AgentSandbox = PolicyEnforcerConfig;
+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";
@@ -652,10 +792,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;
@@ -880,6 +1024,7 @@ type XenoChatMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -938,8 +1083,10 @@ interface LlmClientDeps {
     reportFailure(diagnostics: ApiRequestFailureDiagnostics): Promise<void>;
 }
 declare class LlmClient {
-    private readonly deps;
+    private deps;
     constructor(deps: LlmClientDeps);
+    configureAuthorization(options: Pick<LlmClientDeps, "apiKey" | "authorizeRequest">): void;
+    private localGrammarProbe?;
     readonly id = "xeno-llm-client";
     complete(model: string, messages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
     completeLocal(model: string, messages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
@@ -1050,6 +1197,9 @@ interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
     quotaRemainingTokens?: number;
+    toolChoice?: "auto" | "none" | "required" | {
+        name: string;
+    };
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -1065,6 +1215,8 @@ interface LLMProviderCapabilities {
     readonly cancellation?: boolean;
     readonly retryAfter?: boolean;
     readonly promptCaching?: boolean;
+    readonly customToolGrammarsGbnf?: boolean;
+    readonly customToolGrammarsGbnfStreaming?: boolean;
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
@@ -1745,6 +1897,11 @@ declare class AgentLoop {
         modelWorkAccounting?: ModelWorkAccounting;
         runAuthority?: RunAuthority;
     }): void;
+    configureRequestAuthorization(options: {
+        apiKey?: string;
+        authorizeRequest?: AgentLoopConfig["authorizeRequest"];
+    }): void;
+    createChildRequestAuthorizer(): NonNullable<AgentLoopConfig["authorizeRequest"]>;
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;

package/dist/electron/index.d.ts

@@ -166,6 +166,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";
@@ -442,6 +448,14 @@ interface PermissionPromptInfo {
     };
 }
 type PermissionPromptFn = (info: PermissionPromptInfo) => Promise<"allow" | "always" | "deny">;
+type MemoryLevel = "global" | "project" | "role" | "session";
+interface MemoryBudget {
+    global: number;
+    project: number;
+    role: number;
+    session: number;
+    total: number;
+}
 type SessionStatus = "creating" | "active" | "paused" | "completed" | "abandoned" | "archived";
 interface AgentSessionHostBindingV1 {
     schemaVersion: 1;
@@ -640,6 +654,132 @@ interface PolicyEnforcerConfig {
     };
 }
 type AgentSandbox = PolicyEnforcerConfig;
+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";
@@ -652,10 +792,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;
@@ -880,6 +1024,7 @@ type XenoChatMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -938,8 +1083,10 @@ interface LlmClientDeps {
     reportFailure(diagnostics: ApiRequestFailureDiagnostics): Promise<void>;
 }
 declare class LlmClient {
-    private readonly deps;
+    private deps;
     constructor(deps: LlmClientDeps);
+    configureAuthorization(options: Pick<LlmClientDeps, "apiKey" | "authorizeRequest">): void;
+    private localGrammarProbe?;
     readonly id = "xeno-llm-client";
     complete(model: string, messages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
     completeLocal(model: string, messages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
@@ -1050,6 +1197,9 @@ interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
     quotaRemainingTokens?: number;
+    toolChoice?: "auto" | "none" | "required" | {
+        name: string;
+    };
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -1065,6 +1215,8 @@ interface LLMProviderCapabilities {
     readonly cancellation?: boolean;
     readonly retryAfter?: boolean;
     readonly promptCaching?: boolean;
+    readonly customToolGrammarsGbnf?: boolean;
+    readonly customToolGrammarsGbnfStreaming?: boolean;
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
@@ -1745,6 +1897,11 @@ declare class AgentLoop {
         modelWorkAccounting?: ModelWorkAccounting;
         runAuthority?: RunAuthority;
     }): void;
+    configureRequestAuthorization(options: {
+        apiKey?: string;
+        authorizeRequest?: AgentLoopConfig["authorizeRequest"];
+    }): void;
+    createChildRequestAuthorizer(): NonNullable<AgentLoopConfig["authorizeRequest"]>;
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;