@xenosystem/agent-sdk 0.10.33 → 0.10.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/README.md +33 -0
  2. package/dist/artifacts/index.cjs +1 -1
  3. package/dist/artifacts/index.js +1 -1
  4. package/dist/automation/index.cjs +1 -1
  5. package/dist/automation/index.js +1 -1
  6. package/dist/control-plane/index.cjs +1 -1
  7. package/dist/control-plane/index.js +1 -1
  8. package/dist/coordination/index.cjs +2 -2
  9. package/dist/coordination/index.js +2 -2
  10. package/dist/coordination/metafile-cjs.json +1 -1
  11. package/dist/coordination/metafile-esm.json +1 -1
  12. package/dist/electron/index.cjs +207 -201
  13. package/dist/electron/index.d.cts +27 -1
  14. package/dist/electron/index.d.ts +27 -1
  15. package/dist/electron/index.js +207 -201
  16. package/dist/electron/metafile-cjs.json +1 -1
  17. package/dist/electron/metafile-esm.json +1 -1
  18. package/dist/index.cjs +381 -376
  19. package/dist/index.d.cts +116 -36
  20. package/dist/index.d.ts +116 -36
  21. package/dist/index.js +379 -374
  22. package/dist/metafile-cjs.json +1 -1
  23. package/dist/metafile-esm.json +1 -1
  24. package/dist/providers/index.cjs +10 -10
  25. package/dist/providers/index.d.cts +49 -33
  26. package/dist/providers/index.d.ts +49 -33
  27. package/dist/providers/index.js +10 -10
  28. package/dist/providers/metafile-cjs.json +1 -1
  29. package/dist/providers/metafile-esm.json +1 -1
  30. package/dist/session/index.cjs +1 -1
  31. package/dist/session/index.js +1 -1
  32. package/dist/utils/index.cjs +15 -15
  33. package/dist/utils/index.d.cts +15 -2
  34. package/dist/utils/index.d.ts +15 -2
  35. package/dist/utils/index.js +14 -14
  36. package/dist/utils/metafile-cjs.json +1 -1
  37. package/dist/utils/metafile-esm.json +1 -1
  38. package/dist/workforce/index.cjs +1 -1
  39. package/dist/workforce/index.d.cts +7 -2
  40. package/dist/workforce/index.d.ts +7 -2
  41. package/dist/workforce/index.js +1 -1
  42. package/dist/workforce/metafile-cjs.json +1 -1
  43. package/dist/workforce/metafile-esm.json +1 -1
  44. package/package.json +1 -1
@@ -877,6 +877,13 @@ interface LlmClientDeps {
877
877
  dpop?: string;
878
878
  } | null>;
879
879
  readonly requestContext?: Readonly<XenoRequestContext>;
880
+ authorizeRunDispatch?(target: {
881
+ model: string;
882
+ url: string;
883
+ authorization: string | undefined;
884
+ maxOutputTokens: number;
885
+ }, signal: AbortSignal): Promise<Record<string, string>>;
886
+ hasRunAdmission?(): boolean;
880
887
  readonly maxTokens: number;
881
888
  getApiRequestTimeoutMs(): number;
882
889
  getStreamDeadlines?(): {
@@ -940,6 +947,12 @@ declare class LlmClient {
940
947
  private createRequestDeadline;
941
948
  private streamingMemoryKey;
942
949
  private static normalizeRequestError;
950
+ private preparedDispatch?;
951
+ prepareRunDispatch(model: string, signal: AbortSignal): Promise<void>;
952
+ clearPreparedRunDispatch(): void;
953
+ private dispatch;
954
+ private requestSecrets;
955
+ private static typedRequestFailure;
943
956
  callChatCompletionsNonStream(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
944
957
  private throwForErrorResponse;
945
958
  callChatCompletions(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
@@ -1493,8 +1506,13 @@ interface RunAuthorityToolCall {
1493
1506
  toolName: string;
1494
1507
  toolCallId: string;
1495
1508
  }
1509
+ interface RunDispatchCredential {
1510
+ readonly admissionId: string;
1511
+ readonly lease: string;
1512
+ }
1496
1513
  interface RunAuthority {
1497
- authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | Promise<void>;
1514
+ readonly admissionId?: string;
1515
+ authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | RunDispatchCredential | Promise<void | RunDispatchCredential>;
1498
1516
  authorizeToolCall(request: Readonly<RunAuthorityToolCall>, signal: AbortSignal): void | Promise<void>;
1499
1517
  }
1500
1518
  interface ModeSwitchRequest {
@@ -1651,6 +1669,7 @@ declare class AgentLoop {
1651
1669
  private activeTaskPrompt;
1652
1670
  private activeToolPolicy;
1653
1671
  private apiFailureDiagnosticsLogged;
1672
+ private lastProviderOverflowDetail;
1654
1673
  private queryLifecycle;
1655
1674
  private toolWaitDepth;
1656
1675
  private watchdogReason;
@@ -1737,6 +1756,7 @@ declare class AgentLoop {
1737
1756
  private currentTurnStats;
1738
1757
  private appendAuditEvent;
1739
1758
  private setExecutionModeInternal;
1759
+ private redactProviderDiagnostic;
1740
1760
  private maybeAppendApiRequestFailureAudit;
1741
1761
  private static parsePositiveInteger;
1742
1762
  private sleep;
@@ -1908,6 +1928,8 @@ type AgentToAppChannel = keyof AgentToAppMessages;
1908
1928
  type AppToAgentChannel = keyof AppToAgentMessages;
1909
1929
  type AgentIpcChannel = AgentToAppChannel | AppToAgentChannel;
1910
1930
  type IpcHandler<C extends string, M extends Record<string, unknown>> = C extends keyof M ? (payload: M[C]) => void : never;
1931
+ type ProviderErrorCategory = "authentication" | "authorization" | "unsupported_model" | "unsupported_capability" | "rate_limit" | "context_overflow" | "safety_refusal" | "timeout" | "disconnect" | "malformed_response" | "server" | "transport" | "endpoint_policy" | "cancelled";
1932
+ 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";
1911
1933
  type DualLLMMode = "auto" | "local" | "cloud";
1912
1934
  interface ChatParams {
1913
1935
  messages: Array<{
@@ -1932,6 +1954,10 @@ interface ChatResponse {
1932
1954
  totalTokens: number;
1933
1955
  };
1934
1956
  error?: string;
1957
+ errorCode?: ProviderErrorCode;
1958
+ errorCategory?: ProviderErrorCategory;
1959
+ retryable?: boolean;
1960
+ statusCode?: number;
1935
1961
  }
1936
1962
  interface DualLLMStatus {
1937
1963
  mode: DualLLMMode;
@@ -877,6 +877,13 @@ interface LlmClientDeps {
877
877
  dpop?: string;
878
878
  } | null>;
879
879
  readonly requestContext?: Readonly<XenoRequestContext>;
880
+ authorizeRunDispatch?(target: {
881
+ model: string;
882
+ url: string;
883
+ authorization: string | undefined;
884
+ maxOutputTokens: number;
885
+ }, signal: AbortSignal): Promise<Record<string, string>>;
886
+ hasRunAdmission?(): boolean;
880
887
  readonly maxTokens: number;
881
888
  getApiRequestTimeoutMs(): number;
882
889
  getStreamDeadlines?(): {
@@ -940,6 +947,12 @@ declare class LlmClient {
940
947
  private createRequestDeadline;
941
948
  private streamingMemoryKey;
942
949
  private static normalizeRequestError;
950
+ private preparedDispatch?;
951
+ prepareRunDispatch(model: string, signal: AbortSignal): Promise<void>;
952
+ clearPreparedRunDispatch(): void;
953
+ private dispatch;
954
+ private requestSecrets;
955
+ private static typedRequestFailure;
943
956
  callChatCompletionsNonStream(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
944
957
  private throwForErrorResponse;
945
958
  callChatCompletions(model: string, apiMessages: ApiMessage[], tools: ToolDefinition[], onText?: (text: string) => void, signal?: AbortSignal, maxOutputTokens?: number): Promise<StreamResult>;
@@ -1493,8 +1506,13 @@ interface RunAuthorityToolCall {
1493
1506
  toolName: string;
1494
1507
  toolCallId: string;
1495
1508
  }
1509
+ interface RunDispatchCredential {
1510
+ readonly admissionId: string;
1511
+ readonly lease: string;
1512
+ }
1496
1513
  interface RunAuthority {
1497
- authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | Promise<void>;
1514
+ readonly admissionId?: string;
1515
+ authorizeDispatch(request: Readonly<RunAuthorityDispatch>, signal: AbortSignal): void | RunDispatchCredential | Promise<void | RunDispatchCredential>;
1498
1516
  authorizeToolCall(request: Readonly<RunAuthorityToolCall>, signal: AbortSignal): void | Promise<void>;
1499
1517
  }
1500
1518
  interface ModeSwitchRequest {
@@ -1651,6 +1669,7 @@ declare class AgentLoop {
1651
1669
  private activeTaskPrompt;
1652
1670
  private activeToolPolicy;
1653
1671
  private apiFailureDiagnosticsLogged;
1672
+ private lastProviderOverflowDetail;
1654
1673
  private queryLifecycle;
1655
1674
  private toolWaitDepth;
1656
1675
  private watchdogReason;
@@ -1737,6 +1756,7 @@ declare class AgentLoop {
1737
1756
  private currentTurnStats;
1738
1757
  private appendAuditEvent;
1739
1758
  private setExecutionModeInternal;
1759
+ private redactProviderDiagnostic;
1740
1760
  private maybeAppendApiRequestFailureAudit;
1741
1761
  private static parsePositiveInteger;
1742
1762
  private sleep;
@@ -1908,6 +1928,8 @@ type AgentToAppChannel = keyof AgentToAppMessages;
1908
1928
  type AppToAgentChannel = keyof AppToAgentMessages;
1909
1929
  type AgentIpcChannel = AgentToAppChannel | AppToAgentChannel;
1910
1930
  type IpcHandler<C extends string, M extends Record<string, unknown>> = C extends keyof M ? (payload: M[C]) => void : never;
1931
+ type ProviderErrorCategory = "authentication" | "authorization" | "unsupported_model" | "unsupported_capability" | "rate_limit" | "context_overflow" | "safety_refusal" | "timeout" | "disconnect" | "malformed_response" | "server" | "transport" | "endpoint_policy" | "cancelled";
1932
+ 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";
1911
1933
  type DualLLMMode = "auto" | "local" | "cloud";
1912
1934
  interface ChatParams {
1913
1935
  messages: Array<{
@@ -1932,6 +1954,10 @@ interface ChatResponse {
1932
1954
  totalTokens: number;
1933
1955
  };
1934
1956
  error?: string;
1957
+ errorCode?: ProviderErrorCode;
1958
+ errorCategory?: ProviderErrorCategory;
1959
+ retryable?: boolean;
1960
+ statusCode?: number;
1935
1961
  }
1936
1962
  interface DualLLMStatus {
1937
1963
  mode: DualLLMMode;