@xenosystem/agent-sdk 0.9.9 → 0.9.11

package/dist/electron/index.d.cts

@@ -294,7 +294,14 @@ interface Message {
 }
 type PermissionDecision = "allow" | "ask" | "deny";
 type ExecutionMode = "agent" | "chatOnly";
-type AgentEffortLevel = "low" | "medium" | "high" | "xhigh" | "max";
+declare const AGENT_EFFORT_LEVELS: readonly [
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max"
+];
+type AgentEffortLevel = (typeof AGENT_EFFORT_LEVELS)[number];
 interface PermissionRule {
     tool: string;
     pattern?: string;
@@ -680,6 +687,7 @@ interface StreamResult {
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
+    usageReported: boolean;
 }
 interface ApiRequestFailureDiagnostics {
     model: string;
@@ -834,7 +842,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 XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "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";
+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;
     sequence: number;
@@ -853,6 +861,8 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     model: string;
     effort?: string;
     promptPreview: string;
+    contextBudgetTokens?: number;
+    contextBudgetSource?: "config" | "model" | "provider" | "fallback";
 }) | (XenoRuntimeEventBase & {
     type: "turn.completed";
     outputPreview: string;
@@ -861,6 +871,34 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
         output: number;
         total: number;
     };
+    contextTokens?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "context.pressure";
+    turnId: string;
+    iteration: number;
+    contextTokens: number;
+    budgetTokens: number;
+    budgetSource: "config" | "model" | "provider" | "fallback";
+}) | (XenoRuntimeEventBase & {
+    type: "context.injected";
+    messageId: string;
+    sourceNodeId?: string;
+    label?: string;
+    deferred: boolean;
+    turnId?: string;
+    iteration?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "context.history.compacted";
+    turnId?: string;
+    messagesRemoved: number;
+    tokensSaved: number;
+    beforeTokens: number;
+    afterTokens: number;
+    accounting: TokenAccountingSource;
+    summaryMessageId: string;
+    firstMessageId: string;
+    lastMessageId: string;
+    removedMessageIds: string[];
 }) | (XenoRuntimeEventBase & {
     type: "turn.failed" | "turn.interrupted";
     error: string;
@@ -1264,6 +1302,8 @@ declare class AgentLoop {
     private _messages;
     private totalInputTokens;
     private totalOutputTokens;
+    private lastRequestInputTokens;
+    private pendingContextInjections;
     private lastCheckpointMessageCount;
     private ollamaBaseUrl;
     private activeAbortController;
@@ -1360,9 +1400,21 @@ declare class AgentLoop {
     private summarizeBackgroundTaskSnapshot;
     private maybeDrainBackgroundTasksAtIterationBudget;
     private getApiRequestTimeoutMs;
+    private resolveContextBudget;
     private getModelContextLimit;
     private createApiRequestSignal;
     private buildRuntimeSystemPrompt;
+    private unresolvedToolUseIds;
+    injectContext(input: {
+        content: string;
+        sourceNodeId?: string;
+        label?: string;
+    }): Promise<{
+        status: "injected" | "deferred";
+        pendingCount: number;
+    }>;
+    get pendingContextInjectionCount(): number;
+    private flushContextInjections;
     get messages(): Message[];
     set messages(value: Message[]);
     private shouldAutoCheckpoint;

package/dist/electron/index.d.ts

@@ -294,7 +294,14 @@ interface Message {
 }
 type PermissionDecision = "allow" | "ask" | "deny";
 type ExecutionMode = "agent" | "chatOnly";
-type AgentEffortLevel = "low" | "medium" | "high" | "xhigh" | "max";
+declare const AGENT_EFFORT_LEVELS: readonly [
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max"
+];
+type AgentEffortLevel = (typeof AGENT_EFFORT_LEVELS)[number];
 interface PermissionRule {
     tool: string;
     pattern?: string;
@@ -680,6 +687,7 @@ interface StreamResult {
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
+    usageReported: boolean;
 }
 interface ApiRequestFailureDiagnostics {
     model: string;
@@ -834,7 +842,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 XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "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";
+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;
     sequence: number;
@@ -853,6 +861,8 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     model: string;
     effort?: string;
     promptPreview: string;
+    contextBudgetTokens?: number;
+    contextBudgetSource?: "config" | "model" | "provider" | "fallback";
 }) | (XenoRuntimeEventBase & {
     type: "turn.completed";
     outputPreview: string;
@@ -861,6 +871,34 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
         output: number;
         total: number;
     };
+    contextTokens?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "context.pressure";
+    turnId: string;
+    iteration: number;
+    contextTokens: number;
+    budgetTokens: number;
+    budgetSource: "config" | "model" | "provider" | "fallback";
+}) | (XenoRuntimeEventBase & {
+    type: "context.injected";
+    messageId: string;
+    sourceNodeId?: string;
+    label?: string;
+    deferred: boolean;
+    turnId?: string;
+    iteration?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "context.history.compacted";
+    turnId?: string;
+    messagesRemoved: number;
+    tokensSaved: number;
+    beforeTokens: number;
+    afterTokens: number;
+    accounting: TokenAccountingSource;
+    summaryMessageId: string;
+    firstMessageId: string;
+    lastMessageId: string;
+    removedMessageIds: string[];
 }) | (XenoRuntimeEventBase & {
     type: "turn.failed" | "turn.interrupted";
     error: string;
@@ -1264,6 +1302,8 @@ declare class AgentLoop {
     private _messages;
     private totalInputTokens;
     private totalOutputTokens;
+    private lastRequestInputTokens;
+    private pendingContextInjections;
     private lastCheckpointMessageCount;
     private ollamaBaseUrl;
     private activeAbortController;
@@ -1360,9 +1400,21 @@ declare class AgentLoop {
     private summarizeBackgroundTaskSnapshot;
     private maybeDrainBackgroundTasksAtIterationBudget;
     private getApiRequestTimeoutMs;
+    private resolveContextBudget;
     private getModelContextLimit;
     private createApiRequestSignal;
     private buildRuntimeSystemPrompt;
+    private unresolvedToolUseIds;
+    injectContext(input: {
+        content: string;
+        sourceNodeId?: string;
+        label?: string;
+    }): Promise<{
+        status: "injected" | "deferred";
+        pendingCount: number;
+    }>;
+    get pendingContextInjectionCount(): number;
+    private flushContextInjections;
     get messages(): Message[];
     set messages(value: Message[]);
     private shouldAutoCheckpoint;