@xenosystem/agent-sdk 0.9.25 → 0.9.27

package/dist/providers/index.d.cts

@@ -37,6 +37,22 @@ interface ToolUseBlock {
     provider_metadata?: Record<string, unknown>;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
+type DirectEndpointProfile = "public-https" | "local-network";
+interface DirectEndpointPolicy {
+    profile?: DirectEndpointProfile;
+    allowedHosts?: string[];
+    resolveHostname?: (hostname: string) => Promise<string[]>;
+}
+declare function validateDirectEndpoint(raw: string, policy?: DirectEndpointPolicy): URL;
+declare function assertDirectEndpointResolution(url: URL, policy?: DirectEndpointPolicy): Promise<void>;
+interface ProviderTransportLimits {
+    connectTimeoutMs?: number;
+    totalTimeoutMs?: number;
+    idleTimeoutMs?: number;
+    maxResponseBytes?: number;
+    maxHeaderBytes?: number;
+    maxEventBytes?: number;
+}
 interface ApiTextContentBlock {
     type: "text";
     text: string;
@@ -138,6 +154,12 @@ interface LLMProviderCapabilities {
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
+    prepareQuotaRequest?(model: string, messages: LLMProviderMessage[], tools: ToolDefinition[], context?: LLMProviderRequestContext, signal?: AbortSignal): Promise<{
+        basis: "provider-enforced";
+        inputTokensUpperBound: number;
+        outputTokensUpperBound: number;
+        execute(onText?: (text: string) => void, signal?: AbortSignal): Promise<LLMCompletionResult>;
+    }>;
     readonly id: string;
     readonly model?: string;
     readonly capabilities?: LLMProviderCapabilities;
@@ -212,22 +234,6 @@ declare class DualLLMProvider {
     private chatLocal;
     private chatCloud;
 }
-type DirectEndpointProfile = "public-https" | "local-network";
-interface DirectEndpointPolicy {
-    profile?: DirectEndpointProfile;
-    allowedHosts?: string[];
-    resolveHostname?: (hostname: string) => Promise<string[]>;
-}
-declare function validateDirectEndpoint(raw: string, policy?: DirectEndpointPolicy): URL;
-declare function assertDirectEndpointResolution(url: URL, policy?: DirectEndpointPolicy): Promise<void>;
-interface ProviderTransportLimits {
-    connectTimeoutMs?: number;
-    totalTimeoutMs?: number;
-    idleTimeoutMs?: number;
-    maxResponseBytes?: number;
-    maxHeaderBytes?: number;
-    maxEventBytes?: number;
-}
 type DirectProviderKind = "anthropic" | "openai-responses" | "google" | "openai-compatible";
 type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching">;
 interface DirectProviderConfig {
@@ -254,6 +260,8 @@ 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 {
@@ -460,4 +468,71 @@ declare class FileXenoProviderConnectionStore {
     load(): Promise<XenoProviderConnectionSnapshot>;
     private mutate;
 }
-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, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, 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, directProviderConfigFromConnection, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, selectXenoProviderRoute, validateDirectEndpoint };
+interface QuotaEntity {
+    id: string;
+    generation: string;
+}
+interface QuotaScope {
+    workspace: QuotaEntity;
+    team?: QuotaEntity;
+    agent?: QuotaEntity;
+}
+interface QuotaLimits {
+    requestsPerMinute: number | null;
+    tokensPerDay: number | null;
+}
+interface QuotaReservation {
+    id: string;
+    scope: QuotaScope;
+    requestHash: string;
+    reservedTokens: number;
+    admittedAt: number;
+    state: "reserved" | "dispatched" | "settled" | "void";
+    actualTokens?: number;
+}
+interface QuotaAuthority {
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    void(id: string): Promise<void>;
+}
+declare class QuotaError extends Error {
+    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
+    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
+}
+declare function quotaInteger(value: unknown): number;
+declare function quotaText(value: unknown): string;
+declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
+declare function quotaScopeKey(scope: QuotaScope): string;
+declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
+declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
+interface Policy {
+    scope: QuotaScope;
+    revision: number;
+    limits: QuotaLimits;
+}
+declare class FileQuotaAuthority implements QuotaAuthority {
+    private readonly now;
+    private readonly maximumEntries;
+    readonly directory: string;
+    constructor(directory: string, now?: () => number, maximumEntries?: number);
+    policy(scope: QuotaScope): Promise<Policy | null>;
+    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
+    reservation(id: string): Promise<QuotaReservation | null>;
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    void(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    snapshot(scope: QuotaScope): Promise<{
+        authority: "local-file";
+        policies: Policy[];
+        heldTokens: number;
+        usedTokens: number;
+        requestsInLastMinute: number;
+        unresolved: number;
+    }>;
+    private apply;
+    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, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, 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, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };

package/dist/providers/index.d.ts

@@ -37,6 +37,22 @@ interface ToolUseBlock {
     provider_metadata?: Record<string, unknown>;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
+type DirectEndpointProfile = "public-https" | "local-network";
+interface DirectEndpointPolicy {
+    profile?: DirectEndpointProfile;
+    allowedHosts?: string[];
+    resolveHostname?: (hostname: string) => Promise<string[]>;
+}
+declare function validateDirectEndpoint(raw: string, policy?: DirectEndpointPolicy): URL;
+declare function assertDirectEndpointResolution(url: URL, policy?: DirectEndpointPolicy): Promise<void>;
+interface ProviderTransportLimits {
+    connectTimeoutMs?: number;
+    totalTimeoutMs?: number;
+    idleTimeoutMs?: number;
+    maxResponseBytes?: number;
+    maxHeaderBytes?: number;
+    maxEventBytes?: number;
+}
 interface ApiTextContentBlock {
     type: "text";
     text: string;
@@ -138,6 +154,12 @@ interface LLMProviderCapabilities {
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
+    prepareQuotaRequest?(model: string, messages: LLMProviderMessage[], tools: ToolDefinition[], context?: LLMProviderRequestContext, signal?: AbortSignal): Promise<{
+        basis: "provider-enforced";
+        inputTokensUpperBound: number;
+        outputTokensUpperBound: number;
+        execute(onText?: (text: string) => void, signal?: AbortSignal): Promise<LLMCompletionResult>;
+    }>;
     readonly id: string;
     readonly model?: string;
     readonly capabilities?: LLMProviderCapabilities;
@@ -212,22 +234,6 @@ declare class DualLLMProvider {
     private chatLocal;
     private chatCloud;
 }
-type DirectEndpointProfile = "public-https" | "local-network";
-interface DirectEndpointPolicy {
-    profile?: DirectEndpointProfile;
-    allowedHosts?: string[];
-    resolveHostname?: (hostname: string) => Promise<string[]>;
-}
-declare function validateDirectEndpoint(raw: string, policy?: DirectEndpointPolicy): URL;
-declare function assertDirectEndpointResolution(url: URL, policy?: DirectEndpointPolicy): Promise<void>;
-interface ProviderTransportLimits {
-    connectTimeoutMs?: number;
-    totalTimeoutMs?: number;
-    idleTimeoutMs?: number;
-    maxResponseBytes?: number;
-    maxHeaderBytes?: number;
-    maxEventBytes?: number;
-}
 type DirectProviderKind = "anthropic" | "openai-responses" | "google" | "openai-compatible";
 type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching">;
 interface DirectProviderConfig {
@@ -254,6 +260,8 @@ 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 {
@@ -460,4 +468,71 @@ declare class FileXenoProviderConnectionStore {
     load(): Promise<XenoProviderConnectionSnapshot>;
     private mutate;
 }
-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, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, 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, directProviderConfigFromConnection, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, selectXenoProviderRoute, validateDirectEndpoint };
+interface QuotaEntity {
+    id: string;
+    generation: string;
+}
+interface QuotaScope {
+    workspace: QuotaEntity;
+    team?: QuotaEntity;
+    agent?: QuotaEntity;
+}
+interface QuotaLimits {
+    requestsPerMinute: number | null;
+    tokensPerDay: number | null;
+}
+interface QuotaReservation {
+    id: string;
+    scope: QuotaScope;
+    requestHash: string;
+    reservedTokens: number;
+    admittedAt: number;
+    state: "reserved" | "dispatched" | "settled" | "void";
+    actualTokens?: number;
+}
+interface QuotaAuthority {
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    void(id: string): Promise<void>;
+}
+declare class QuotaError extends Error {
+    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
+    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
+}
+declare function quotaInteger(value: unknown): number;
+declare function quotaText(value: unknown): string;
+declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
+declare function quotaScopeKey(scope: QuotaScope): string;
+declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
+declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
+interface Policy {
+    scope: QuotaScope;
+    revision: number;
+    limits: QuotaLimits;
+}
+declare class FileQuotaAuthority implements QuotaAuthority {
+    private readonly now;
+    private readonly maximumEntries;
+    readonly directory: string;
+    constructor(directory: string, now?: () => number, maximumEntries?: number);
+    policy(scope: QuotaScope): Promise<Policy | null>;
+    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
+    reservation(id: string): Promise<QuotaReservation | null>;
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    void(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    snapshot(scope: QuotaScope): Promise<{
+        authority: "local-file";
+        policies: Policy[];
+        heldTokens: number;
+        usedTokens: number;
+        requestsInLastMinute: number;
+        unresolved: number;
+    }>;
+    private apply;
+    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, type ProbeXenoProviderOptions, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderTransportLimits, 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, normalizeQuotaScope, parseRetryAfter, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };