@xenosystem/agent-sdk 0.10.4 → 0.10.5

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.
@@ -156,7 +156,7 @@ interface LLMProviderCapabilities {
156
156
  }
157
157
  interface LLMProvider {
158
158
  prepareQuotaRequest?(model: string, messages: LLMProviderMessage[], tools: ToolDefinition[], context?: LLMProviderRequestContext, signal?: AbortSignal): Promise<{
159
- basis: "provider-enforced";
159
+ basis: "provider-enforced" | "estimated";
160
160
  inputTokensUpperBound: number;
161
161
  outputTokensUpperBound: number;
162
162
  execute(onText?: (text: string) => void, signal?: AbortSignal): Promise<LLMCompletionResult>;
@@ -493,6 +493,7 @@ interface QuotaReservation {
493
493
  admittedAt: number;
494
494
  state: "reserved" | "dispatched" | "settled" | "void";
495
495
  actualTokens?: number;
496
+ basis?: "estimated";
496
497
  }
497
498
  interface QuotaAuthority {
498
499
  reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
@@ -520,7 +521,10 @@ declare function quotaText(value: unknown): string;
520
521
  declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
521
522
  declare function quotaScopeKey(scope: QuotaScope): string;
522
523
  declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
523
- declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
524
+ interface QuotaGovernorOptions {
525
+ enforcement?: "hard" | "soft";
526
+ }
527
+ declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope, options?: QuotaGovernorOptions): LLMProvider;
524
528
  interface Policy {
525
529
  scope: QuotaScope;
526
530
  revision: number;
@@ -553,4 +557,4 @@ declare class FileQuotaAuthority implements QuotaAuthority {
553
557
  private load;
554
558
  private append;
555
559
  }
556
- 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, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaLimits, type QuotaReservation, type QuotaScope, 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, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };
560
+ 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, 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 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, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };
@@ -156,7 +156,7 @@ interface LLMProviderCapabilities {
156
156
  }
157
157
  interface LLMProvider {
158
158
  prepareQuotaRequest?(model: string, messages: LLMProviderMessage[], tools: ToolDefinition[], context?: LLMProviderRequestContext, signal?: AbortSignal): Promise<{
159
- basis: "provider-enforced";
159
+ basis: "provider-enforced" | "estimated";
160
160
  inputTokensUpperBound: number;
161
161
  outputTokensUpperBound: number;
162
162
  execute(onText?: (text: string) => void, signal?: AbortSignal): Promise<LLMCompletionResult>;
@@ -493,6 +493,7 @@ interface QuotaReservation {
493
493
  admittedAt: number;
494
494
  state: "reserved" | "dispatched" | "settled" | "void";
495
495
  actualTokens?: number;
496
+ basis?: "estimated";
496
497
  }
497
498
  interface QuotaAuthority {
498
499
  reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
@@ -520,7 +521,10 @@ declare function quotaText(value: unknown): string;
520
521
  declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
521
522
  declare function quotaScopeKey(scope: QuotaScope): string;
522
523
  declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
523
- declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
524
+ interface QuotaGovernorOptions {
525
+ enforcement?: "hard" | "soft";
526
+ }
527
+ declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope, options?: QuotaGovernorOptions): LLMProvider;
524
528
  interface Policy {
525
529
  scope: QuotaScope;
526
530
  revision: number;
@@ -553,4 +557,4 @@ declare class FileQuotaAuthority implements QuotaAuthority {
553
557
  private load;
554
558
  private append;
555
559
  }
556
- 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, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, QuotaAcknowledgementError, type QuotaAcknowledgementPhase, type QuotaAuthority, type QuotaEntity, QuotaError, type QuotaLimits, type QuotaReservation, type QuotaScope, 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, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };
560
+ 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, 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 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, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };