@xenosystem/agent-sdk 0.10.34 → 0.10.36

package/dist/electron/index.d.cts

@@ -780,6 +780,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;
@@ -877,6 +915,13 @@ interface LlmClientDeps {
         dpop?: string;
     } | null>;
     readonly requestContext?: Readonly<XenoRequestContext>;
+    authorizeRunDispatch?(target: {
+        model: string;
+        url: string;
+        authorization: string | undefined;
+        maxOutputTokens: number;
+    }, signal: AbortSignal): Promise<Record<string, string>>;
+    hasRunAdmission?(): boolean;
     readonly maxTokens: number;
     getApiRequestTimeoutMs(): number;
     getStreamDeadlines?(): {
@@ -940,6 +985,12 @@ declare class LlmClient {
     private createRequestDeadline;
     private streamingMemoryKey;
     private static normalizeRequestError;
+    private preparedDispatch?;
+    prepareRunDispatch(model: string, signal: AbortSignal): Promise<void>;
+    clearPreparedRunDispatch(): void;
+    private dispatch;
+    private requestSecrets;
+    private static typedRequestFailure;
     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>;
@@ -1493,8 +1544,13 @@ interface RunAuthorityToolCall {
     toolName: string;
     toolCallId: string;
 }
+interface RunDispatchCredential {
+    readonly admissionId: string;
+    readonly lease: string;
+}
 interface RunAuthority {
-    authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | Promise<void>;
+    readonly admissionId?: string;
+    authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | RunDispatchCredential | Promise<void | RunDispatchCredential>;
     authorizeToolCall(request: Readonly<RunAuthorityToolCall>, signal: AbortSignal): void | Promise<void>;
 }
 interface ModeSwitchRequest {
@@ -1540,6 +1596,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>;
@@ -1651,6 +1708,7 @@ declare class AgentLoop {
     private activeTaskPrompt;
     private activeToolPolicy;
     private apiFailureDiagnosticsLogged;
+    private lastProviderOverflowDetail;
     private queryLifecycle;
     private toolWaitDepth;
     private watchdogReason;
@@ -1663,6 +1721,7 @@ declare class AgentLoop {
     private readonly promptSections;
     private readonly completionGuards;
     private readonly toolFailureGuard;
+    private readonly preToolUseGate;
     private turnToolCalls;
     private turnToolFailures;
     private turnFailuresByTool;
@@ -1737,6 +1796,7 @@ declare class AgentLoop {
     private currentTurnStats;
     private appendAuditEvent;
     private setExecutionModeInternal;
+    private redactProviderDiagnostic;
     private maybeAppendApiRequestFailureAudit;
     private static parsePositiveInteger;
     private sleep;
@@ -1908,6 +1968,8 @@ type AgentToAppChannel = keyof AgentToAppMessages;
 type AppToAgentChannel = keyof AppToAgentMessages;
 type AgentIpcChannel = AgentToAppChannel | AppToAgentChannel;
 type IpcHandler<C extends string, M extends Record<string, unknown>> = C extends keyof M ? (payload: M[C]) => void : never;
+type ProviderErrorCategory = "authentication" | "authorization" | "unsupported_model" | "unsupported_capability" | "rate_limit" | "context_overflow" | "safety_refusal" | "timeout" | "disconnect" | "malformed_response" | "server" | "transport" | "endpoint_policy" | "cancelled";
+type ProviderErrorCode = "PROVIDER_AUTHENTICATION_FAILED" | "PROVIDER_AUTHORIZATION_FAILED" | "PROVIDER_MODEL_UNSUPPORTED" | "PROVIDER_CAPABILITY_UNSUPPORTED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_CONTEXT_OVERFLOW" | "PROVIDER_SAFETY_REFUSAL" | "PROVIDER_TIMEOUT" | "PROVIDER_DISCONNECTED" | "PROVIDER_MALFORMED_RESPONSE" | "PROVIDER_SERVER_ERROR" | "PROVIDER_TRANSPORT_ERROR" | "PROVIDER_ENDPOINT_REJECTED" | "PROVIDER_CANCELLED";
 type DualLLMMode = "auto" | "local" | "cloud";
 interface ChatParams {
     messages: Array<{
@@ -1932,6 +1994,10 @@ interface ChatResponse {
         totalTokens: number;
     };
     error?: string;
+    errorCode?: ProviderErrorCode;
+    errorCategory?: ProviderErrorCategory;
+    retryable?: boolean;
+    statusCode?: number;
 }
 interface DualLLMStatus {
     mode: DualLLMMode;

package/dist/electron/index.d.ts

@@ -780,6 +780,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;
@@ -877,6 +915,13 @@ interface LlmClientDeps {
         dpop?: string;
     } | null>;
     readonly requestContext?: Readonly<XenoRequestContext>;
+    authorizeRunDispatch?(target: {
+        model: string;
+        url: string;
+        authorization: string | undefined;
+        maxOutputTokens: number;
+    }, signal: AbortSignal): Promise<Record<string, string>>;
+    hasRunAdmission?(): boolean;
     readonly maxTokens: number;
     getApiRequestTimeoutMs(): number;
     getStreamDeadlines?(): {
@@ -940,6 +985,12 @@ declare class LlmClient {
     private createRequestDeadline;
     private streamingMemoryKey;
     private static normalizeRequestError;
+    private preparedDispatch?;
+    prepareRunDispatch(model: string, signal: AbortSignal): Promise<void>;
+    clearPreparedRunDispatch(): void;
+    private dispatch;
+    private requestSecrets;
+    private static typedRequestFailure;
     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>;
@@ -1493,8 +1544,13 @@ interface RunAuthorityToolCall {
     toolName: string;
     toolCallId: string;
 }
+interface RunDispatchCredential {
+    readonly admissionId: string;
+    readonly lease: string;
+}
 interface RunAuthority {
-    authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | Promise<void>;
+    readonly admissionId?: string;
+    authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | RunDispatchCredential | Promise<void | RunDispatchCredential>;
     authorizeToolCall(request: Readonly<RunAuthorityToolCall>, signal: AbortSignal): void | Promise<void>;
 }
 interface ModeSwitchRequest {
@@ -1540,6 +1596,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>;
@@ -1651,6 +1708,7 @@ declare class AgentLoop {
     private activeTaskPrompt;
     private activeToolPolicy;
     private apiFailureDiagnosticsLogged;
+    private lastProviderOverflowDetail;
     private queryLifecycle;
     private toolWaitDepth;
     private watchdogReason;
@@ -1663,6 +1721,7 @@ declare class AgentLoop {
     private readonly promptSections;
     private readonly completionGuards;
     private readonly toolFailureGuard;
+    private readonly preToolUseGate;
     private turnToolCalls;
     private turnToolFailures;
     private turnFailuresByTool;
@@ -1737,6 +1796,7 @@ declare class AgentLoop {
     private currentTurnStats;
     private appendAuditEvent;
     private setExecutionModeInternal;
+    private redactProviderDiagnostic;
     private maybeAppendApiRequestFailureAudit;
     private static parsePositiveInteger;
     private sleep;
@@ -1908,6 +1968,8 @@ type AgentToAppChannel = keyof AgentToAppMessages;
 type AppToAgentChannel = keyof AppToAgentMessages;
 type AgentIpcChannel = AgentToAppChannel | AppToAgentChannel;
 type IpcHandler<C extends string, M extends Record<string, unknown>> = C extends keyof M ? (payload: M[C]) => void : never;
+type ProviderErrorCategory = "authentication" | "authorization" | "unsupported_model" | "unsupported_capability" | "rate_limit" | "context_overflow" | "safety_refusal" | "timeout" | "disconnect" | "malformed_response" | "server" | "transport" | "endpoint_policy" | "cancelled";
+type ProviderErrorCode = "PROVIDER_AUTHENTICATION_FAILED" | "PROVIDER_AUTHORIZATION_FAILED" | "PROVIDER_MODEL_UNSUPPORTED" | "PROVIDER_CAPABILITY_UNSUPPORTED" | "PROVIDER_RATE_LIMITED" | "PROVIDER_CONTEXT_OVERFLOW" | "PROVIDER_SAFETY_REFUSAL" | "PROVIDER_TIMEOUT" | "PROVIDER_DISCONNECTED" | "PROVIDER_MALFORMED_RESPONSE" | "PROVIDER_SERVER_ERROR" | "PROVIDER_TRANSPORT_ERROR" | "PROVIDER_ENDPOINT_REJECTED" | "PROVIDER_CANCELLED";
 type DualLLMMode = "auto" | "local" | "cloud";
 interface ChatParams {
     messages: Array<{
@@ -1932,6 +1994,10 @@ interface ChatResponse {
         totalTokens: number;
     };
     error?: string;
+    errorCode?: ProviderErrorCode;
+    errorCategory?: ProviderErrorCategory;
+    retryable?: boolean;
+    statusCode?: number;
 }
 interface DualLLMStatus {
     mode: DualLLMMode;