@xenosystem/agent-sdk 0.10.35 → 0.10.37

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;
@@ -780,6 +924,44 @@ declare class PermissionEngine {
     private normalizeCommandText;
     private resolveTargetPath;
 }
+type HookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "PreToolUse" | "PostToolUse" | "PreCompact" | "PostCompact" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop";
+interface BaseHookDefinition {
+    name?: string;
+    events?: HookEventName[];
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+    failClosed?: boolean;
+    async?: boolean;
+}
+interface CommandHookDefinition extends BaseHookDefinition {
+    type: "command";
+    command: string;
+    args?: string[];
+    cwd?: string;
+    shell?: boolean;
+    env?: Record<string, string>;
+}
+interface HttpHookDefinition extends BaseHookDefinition {
+    type: "http";
+    url: string;
+    method?: "POST";
+    headers?: Record<string, string>;
+}
+interface PromptHookDefinition extends BaseHookDefinition {
+    type: "prompt";
+    prompt: string;
+}
+interface AgentHookDefinition extends BaseHookDefinition {
+    type: "agent";
+    prompt: string;
+    agent?: string;
+    model?: string;
+}
+type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
+interface HookConfig {
+    hooks?: HookDefinition[];
+    events?: Partial<Record<HookEventName, HookDefinition[]>>;
+}
 type ToolFailureCategory = "schema" | "missing_path" | "permission_denied" | "transport" | "timeout" | "tool_failure";
 interface ToolFailureGuardTrip {
     category: ToolFailureCategory;
@@ -842,6 +1024,7 @@ type XenoChatMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -900,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>;
@@ -1012,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 {
@@ -1027,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 {
@@ -1558,6 +1748,7 @@ interface AgentLoopConfig {
     onIteration?: (iteration: number, totalTokens: number) => void;
     modelWorkAccounting?: ModelWorkAccounting;
     runAuthority?: RunAuthority;
+    hooks?: HookConfig;
     onError?: (error: Error, context: string) => void;
     onTranscriptError?: (error: Error, context: string) => void;
     onModeSwitchRequest?: (request: ModeSwitchRequest) => Promise<boolean>;
@@ -1682,6 +1873,7 @@ declare class AgentLoop {
     private readonly promptSections;
     private readonly completionGuards;
     private readonly toolFailureGuard;
+    private readonly preToolUseGate;
     private turnToolCalls;
     private turnToolFailures;
     private turnFailuresByTool;
@@ -1705,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;
@@ -780,6 +924,44 @@ declare class PermissionEngine {
     private normalizeCommandText;
     private resolveTargetPath;
 }
+type HookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "PreToolUse" | "PostToolUse" | "PreCompact" | "PostCompact" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop";
+interface BaseHookDefinition {
+    name?: string;
+    events?: HookEventName[];
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+    failClosed?: boolean;
+    async?: boolean;
+}
+interface CommandHookDefinition extends BaseHookDefinition {
+    type: "command";
+    command: string;
+    args?: string[];
+    cwd?: string;
+    shell?: boolean;
+    env?: Record<string, string>;
+}
+interface HttpHookDefinition extends BaseHookDefinition {
+    type: "http";
+    url: string;
+    method?: "POST";
+    headers?: Record<string, string>;
+}
+interface PromptHookDefinition extends BaseHookDefinition {
+    type: "prompt";
+    prompt: string;
+}
+interface AgentHookDefinition extends BaseHookDefinition {
+    type: "agent";
+    prompt: string;
+    agent?: string;
+    model?: string;
+}
+type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
+interface HookConfig {
+    hooks?: HookDefinition[];
+    events?: Partial<Record<HookEventName, HookDefinition[]>>;
+}
 type ToolFailureCategory = "schema" | "missing_path" | "permission_denied" | "transport" | "timeout" | "tool_failure";
 interface ToolFailureGuardTrip {
     category: ToolFailureCategory;
@@ -842,6 +1024,7 @@ type XenoChatMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -900,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>;
@@ -1012,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 {
@@ -1027,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 {
@@ -1558,6 +1748,7 @@ interface AgentLoopConfig {
     onIteration?: (iteration: number, totalTokens: number) => void;
     modelWorkAccounting?: ModelWorkAccounting;
     runAuthority?: RunAuthority;
+    hooks?: HookConfig;
     onError?: (error: Error, context: string) => void;
     onTranscriptError?: (error: Error, context: string) => void;
     onModeSwitchRequest?: (request: ModeSwitchRequest) => Promise<boolean>;
@@ -1682,6 +1873,7 @@ declare class AgentLoop {
     private readonly promptSections;
     private readonly completionGuards;
     private readonly toolFailureGuard;
+    private readonly preToolUseGate;
     private turnToolCalls;
     private turnToolFailures;
     private turnFailuresByTool;
@@ -1705,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;