@xenosystem/agent-sdk 0.10.16 → 0.10.18

package/dist/electron/index.d.cts

@@ -176,7 +176,16 @@ interface ResourceContentBlock {
 }
 type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
 type ToolResultContent = string | ToolAssistantContentBlock[];
-type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | "completed" | "failed" | "timed_out" | "cancelled" | "orphaned";
+declare const TOOL_OPERATION_TERMINAL_STATES: readonly [
+    "completed",
+    "failed",
+    "timed_out",
+    "cancelled",
+    "outcome_unknown",
+    "orphaned"
+];
+type ToolOperationTerminalState = (typeof TOOL_OPERATION_TERMINAL_STATES)[number];
+type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | ToolOperationTerminalState;
 type ToolCompletionPolicy = "await" | "observe" | "detach";
 interface ExpectedOutputContract {
     path: string;
@@ -282,6 +291,7 @@ interface ToolPolicyProjection {
 interface RegisteredTool {
     definition: ToolDefinition;
     execute: ToolExecutor;
+    readOnly?: boolean;
     projectPolicyInput?: (input: Record<string, unknown>) => ToolPolicyProjection | {
         error: ToolResult;
     };
@@ -754,6 +764,7 @@ interface StreamResult {
     inputTokens: number;
     outputTokens: number;
     usageReported: boolean;
+    incompleteToolCallIds?: string[];
 }
 interface ApiRequestFailureDiagnostics {
     model: string;
@@ -785,6 +796,16 @@ interface LlmClientDeps {
     } | null>;
     readonly maxTokens: number;
     getApiRequestTimeoutMs(): number;
+    getStreamDeadlines?(): {
+        firstResponseMs?: number;
+        idleMs?: number;
+    };
+    getNonStreamingMemoryMs?(): number | undefined;
+    reportTransportEvent?(event: {
+        type: "provider.warning";
+        code: string;
+        message: string;
+    }): void;
     buildRuntimeSystemPrompt(): string;
     reportFailure(diagnostics: ApiRequestFailureDiagnostics): Promise<void>;
 }
@@ -831,8 +852,11 @@ declare class LlmClient {
     private static stripHtml;
     private static summarizeErrorBody;
     private authorizationHeaders;
-    private createApiRequestSignal;
+    private createRequestDeadline;
+    private streamingMemoryKey;
+    private static normalizeRequestError;
     callChatCompletionsNonStream(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
+    private throwForErrorResponse;
     callChatCompletions(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
     callOllama(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
 }
@@ -922,7 +946,7 @@ interface LLMProvider {
 }
 type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
 type QueryWatchdogReason = "idle" | "lease" | "hard";
-type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled";
+type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled" | "tool.operation.outcome_unknown";
 type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
 interface XenoRuntimeEventBase {
     id: string;
@@ -1441,6 +1465,10 @@ interface AgentLoopConfig {
     maxCompletionGuardReminders?: number;
     progressGuardEveryIterations?: number;
     apiRequestTimeoutMs?: number;
+    apiFirstResponseTimeoutMs?: number;
+    apiStreamIdleTimeoutMs?: number;
+    streamAgentResponses?: boolean;
+    apiNonStreamingMemoryMs?: number;
     queryIdleTimeoutMs?: number;
     queryLeaseTimeoutMs?: number;
     queryHardTimeoutMs?: number;
@@ -1564,6 +1592,7 @@ declare class AgentLoop {
     };
     createSoftBudgetCloudProvider(): LLMProvider;
     private callCloudWithOutputCap;
+    private requestStreams;
     configureModelExecution(options: {
         provider?: LLMProvider;
         modelWorkAccounting?: ModelWorkAccounting;

package/dist/electron/index.d.ts

@@ -176,7 +176,16 @@ interface ResourceContentBlock {
 }
 type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
 type ToolResultContent = string | ToolAssistantContentBlock[];
-type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | "completed" | "failed" | "timed_out" | "cancelled" | "orphaned";
+declare const TOOL_OPERATION_TERMINAL_STATES: readonly [
+    "completed",
+    "failed",
+    "timed_out",
+    "cancelled",
+    "outcome_unknown",
+    "orphaned"
+];
+type ToolOperationTerminalState = (typeof TOOL_OPERATION_TERMINAL_STATES)[number];
+type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | ToolOperationTerminalState;
 type ToolCompletionPolicy = "await" | "observe" | "detach";
 interface ExpectedOutputContract {
     path: string;
@@ -282,6 +291,7 @@ interface ToolPolicyProjection {
 interface RegisteredTool {
     definition: ToolDefinition;
     execute: ToolExecutor;
+    readOnly?: boolean;
     projectPolicyInput?: (input: Record<string, unknown>) => ToolPolicyProjection | {
         error: ToolResult;
     };
@@ -754,6 +764,7 @@ interface StreamResult {
     inputTokens: number;
     outputTokens: number;
     usageReported: boolean;
+    incompleteToolCallIds?: string[];
 }
 interface ApiRequestFailureDiagnostics {
     model: string;
@@ -785,6 +796,16 @@ interface LlmClientDeps {
     } | null>;
     readonly maxTokens: number;
     getApiRequestTimeoutMs(): number;
+    getStreamDeadlines?(): {
+        firstResponseMs?: number;
+        idleMs?: number;
+    };
+    getNonStreamingMemoryMs?(): number | undefined;
+    reportTransportEvent?(event: {
+        type: "provider.warning";
+        code: string;
+        message: string;
+    }): void;
     buildRuntimeSystemPrompt(): string;
     reportFailure(diagnostics: ApiRequestFailureDiagnostics): Promise<void>;
 }
@@ -831,8 +852,11 @@ declare class LlmClient {
     private static stripHtml;
     private static summarizeErrorBody;
     private authorizationHeaders;
-    private createApiRequestSignal;
+    private createRequestDeadline;
+    private streamingMemoryKey;
+    private static normalizeRequestError;
     callChatCompletionsNonStream(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
+    private throwForErrorResponse;
     callChatCompletions(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
     callOllama(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal): Promise<StreamResult>;
 }
@@ -922,7 +946,7 @@ interface LLMProvider {
 }
 type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
 type QueryWatchdogReason = "idle" | "lease" | "hard";
-type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled";
+type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled" | "tool.operation.outcome_unknown";
 type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
 interface XenoRuntimeEventBase {
     id: string;
@@ -1441,6 +1465,10 @@ interface AgentLoopConfig {
     maxCompletionGuardReminders?: number;
     progressGuardEveryIterations?: number;
     apiRequestTimeoutMs?: number;
+    apiFirstResponseTimeoutMs?: number;
+    apiStreamIdleTimeoutMs?: number;
+    streamAgentResponses?: boolean;
+    apiNonStreamingMemoryMs?: number;
     queryIdleTimeoutMs?: number;
     queryLeaseTimeoutMs?: number;
     queryHardTimeoutMs?: number;
@@ -1564,6 +1592,7 @@ declare class AgentLoop {
     };
     createSoftBudgetCloudProvider(): LLMProvider;
     private callCloudWithOutputCap;
+    private requestStreams;
     configureModelExecution(options: {
         provider?: LLMProvider;
         modelWorkAccounting?: ModelWorkAccounting;