@xenosystem/agent-sdk 0.10.33 → 0.10.35

package/dist/providers/index.d.cts

@@ -1,3 +1,47 @@
+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";
+interface ProviderErrorOptions {
+    category: ProviderErrorCategory;
+    code: ProviderErrorCode;
+    retryable?: boolean;
+    providerId?: string;
+    statusCode?: number;
+    retryAfterMs?: number;
+    requestId?: string;
+    providerCode?: string;
+    remedy?: string;
+    cause?: unknown;
+}
+declare class ProviderError extends Error {
+    readonly category: ProviderErrorCategory;
+    readonly code: ProviderErrorCode;
+    readonly retryable: boolean;
+    readonly providerId?: string;
+    readonly statusCode?: number;
+    readonly retryAfterMs?: number;
+    readonly requestId?: string;
+    readonly providerCode?: string;
+    readonly remedy?: string;
+    constructor(message: string, options: ProviderErrorOptions);
+}
+declare function parseRetryAfter(value: string | null, now?: number): number | undefined;
+declare function classifyProviderHttpError(input: {
+    providerId: string;
+    statusCode: number;
+    body: unknown;
+    retryAfterMs?: number;
+    requestId?: string;
+    secrets?: Iterable<string>;
+    source?: "http" | "stream";
+}): ProviderError;
+declare function classifyProviderStreamError(input: {
+    providerId: string;
+    error: unknown;
+    outputSeen: boolean;
+    secrets?: Iterable<string>;
+}): ProviderError;
+declare function providerProtocolError(providerId: string, message: string, cause?: unknown): ProviderError;
+declare function providerCapabilityError(providerId: string, capability: string): ProviderError;
 interface ToolDefinition {
     name: string;
     description: string;
@@ -198,6 +242,10 @@ interface ChatResponse {
         totalTokens: number;
     };
     error?: string;
+    errorCode?: ProviderErrorCode;
+    errorCategory?: ProviderErrorCategory;
+    retryable?: boolean;
+    statusCode?: number;
 }
 interface DualLLMStatus {
     mode: DualLLMMode;
@@ -271,38 +319,6 @@ interface DirectProviderConfig {
 declare function createDirectProvider(config: DirectProviderConfig): LLMProvider;
 type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath">;
 declare function createOllamaNativeProvider(config: OllamaNativeProviderConfig): LLMProvider;
-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";
-interface ProviderErrorOptions {
-    category: ProviderErrorCategory;
-    code: ProviderErrorCode;
-    retryable?: boolean;
-    providerId?: string;
-    statusCode?: number;
-    retryAfterMs?: number;
-    requestId?: string;
-    cause?: unknown;
-}
-declare class ProviderError extends Error {
-    readonly category: ProviderErrorCategory;
-    readonly code: ProviderErrorCode;
-    readonly retryable: boolean;
-    readonly providerId?: string;
-    readonly statusCode?: number;
-    readonly retryAfterMs?: number;
-    readonly requestId?: string;
-    constructor(message: string, options: ProviderErrorOptions);
-}
-declare function parseRetryAfter(value: string | null, now?: number): number | undefined;
-declare function classifyProviderHttpError(input: {
-    providerId: string;
-    statusCode: number;
-    body: unknown;
-    retryAfterMs?: number;
-    requestId?: string;
-}): ProviderError;
-declare function providerProtocolError(providerId: string, message: string, cause?: unknown): ProviderError;
-declare function providerCapabilityError(providerId: string, capability: string): ProviderError;
 type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google";
 interface ToolSchemaProjectionChange {
     path: string;
@@ -564,4 +580,4 @@ declare class FileQuotaAuthority implements QuotaAuthority {
     private load;
     private append;
 }
-export { BUILT_IN_XENO_PROVIDER_PRESETS, type ChatParams, type ChatResponse, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type OllamaNativeProviderConfig, PROVIDER_TOOL_NAME_PATTERN, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaGovernorOptions, type QuotaLimits, type QuotaReservation, type QuotaScope, type ToolNameCodec, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };
+export { BUILT_IN_XENO_PROVIDER_PRESETS, type ChatParams, type ChatResponse, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type OllamaNativeProviderConfig, PROVIDER_TOOL_NAME_PATTERN, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaGovernorOptions, type QuotaLimits, type QuotaReservation, type QuotaScope, type ToolNameCodec, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, classifyProviderStreamError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };

package/dist/providers/index.d.ts

@@ -1,3 +1,47 @@
+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";
+interface ProviderErrorOptions {
+    category: ProviderErrorCategory;
+    code: ProviderErrorCode;
+    retryable?: boolean;
+    providerId?: string;
+    statusCode?: number;
+    retryAfterMs?: number;
+    requestId?: string;
+    providerCode?: string;
+    remedy?: string;
+    cause?: unknown;
+}
+declare class ProviderError extends Error {
+    readonly category: ProviderErrorCategory;
+    readonly code: ProviderErrorCode;
+    readonly retryable: boolean;
+    readonly providerId?: string;
+    readonly statusCode?: number;
+    readonly retryAfterMs?: number;
+    readonly requestId?: string;
+    readonly providerCode?: string;
+    readonly remedy?: string;
+    constructor(message: string, options: ProviderErrorOptions);
+}
+declare function parseRetryAfter(value: string | null, now?: number): number | undefined;
+declare function classifyProviderHttpError(input: {
+    providerId: string;
+    statusCode: number;
+    body: unknown;
+    retryAfterMs?: number;
+    requestId?: string;
+    secrets?: Iterable<string>;
+    source?: "http" | "stream";
+}): ProviderError;
+declare function classifyProviderStreamError(input: {
+    providerId: string;
+    error: unknown;
+    outputSeen: boolean;
+    secrets?: Iterable<string>;
+}): ProviderError;
+declare function providerProtocolError(providerId: string, message: string, cause?: unknown): ProviderError;
+declare function providerCapabilityError(providerId: string, capability: string): ProviderError;
 interface ToolDefinition {
     name: string;
     description: string;
@@ -198,6 +242,10 @@ interface ChatResponse {
         totalTokens: number;
     };
     error?: string;
+    errorCode?: ProviderErrorCode;
+    errorCategory?: ProviderErrorCategory;
+    retryable?: boolean;
+    statusCode?: number;
 }
 interface DualLLMStatus {
     mode: DualLLMMode;
@@ -271,38 +319,6 @@ interface DirectProviderConfig {
 declare function createDirectProvider(config: DirectProviderConfig): LLMProvider;
 type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath">;
 declare function createOllamaNativeProvider(config: OllamaNativeProviderConfig): LLMProvider;
-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";
-interface ProviderErrorOptions {
-    category: ProviderErrorCategory;
-    code: ProviderErrorCode;
-    retryable?: boolean;
-    providerId?: string;
-    statusCode?: number;
-    retryAfterMs?: number;
-    requestId?: string;
-    cause?: unknown;
-}
-declare class ProviderError extends Error {
-    readonly category: ProviderErrorCategory;
-    readonly code: ProviderErrorCode;
-    readonly retryable: boolean;
-    readonly providerId?: string;
-    readonly statusCode?: number;
-    readonly retryAfterMs?: number;
-    readonly requestId?: string;
-    constructor(message: string, options: ProviderErrorOptions);
-}
-declare function parseRetryAfter(value: string | null, now?: number): number | undefined;
-declare function classifyProviderHttpError(input: {
-    providerId: string;
-    statusCode: number;
-    body: unknown;
-    retryAfterMs?: number;
-    requestId?: string;
-}): ProviderError;
-declare function providerProtocolError(providerId: string, message: string, cause?: unknown): ProviderError;
-declare function providerCapabilityError(providerId: string, capability: string): ProviderError;
 type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google";
 interface ToolSchemaProjectionChange {
     path: string;
@@ -564,4 +580,4 @@ declare class FileQuotaAuthority implements QuotaAuthority {
     private load;
     private append;
 }
-export { BUILT_IN_XENO_PROVIDER_PRESETS, type ChatParams, type ChatResponse, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type OllamaNativeProviderConfig, PROVIDER_TOOL_NAME_PATTERN, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaGovernorOptions, type QuotaLimits, type QuotaReservation, type QuotaScope, type ToolNameCodec, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };
+export { BUILT_IN_XENO_PROVIDER_PRESETS, type ChatParams, type ChatResponse, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type OllamaNativeProviderConfig, PROVIDER_TOOL_NAME_PATTERN, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaGovernorOptions, type QuotaLimits, type QuotaReservation, type QuotaScope, type ToolNameCodec, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, classifyProviderStreamError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };