@xenosystem/agent-sdk 0.10.36 → 0.10.37

package/dist/providers/index.d.cts

@@ -52,6 +52,12 @@ interface ToolDefinition {
         additionalProperties?: boolean | Record<string, unknown>;
         [keyword: string]: unknown;
     };
+    grammar?: ToolInputGrammar;
+}
+interface ToolInputGrammar {
+    syntax: "gbnf";
+    definition: string;
+    inputField: string;
 }
 interface ImageUrlBlock {
     type: "image_url";
@@ -128,6 +134,7 @@ type ApiMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -188,6 +195,9 @@ interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
     quotaRemainingTokens?: number;
+    toolChoice?: "auto" | "none" | "required" | {
+        name: string;
+    };
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -203,6 +213,8 @@ interface LLMProviderCapabilities {
     readonly cancellation?: boolean;
     readonly retryAfter?: boolean;
     readonly promptCaching?: boolean;
+    readonly customToolGrammarsGbnf?: boolean;
+    readonly customToolGrammarsGbnfStreaming?: boolean;
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
@@ -291,14 +303,22 @@ declare class DualLLMProvider {
     private chatCloud;
 }
 type DirectProviderKind = "anthropic" | "openai-responses" | "google" | "openai-compatible";
-type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching">;
+type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching" | "customToolGrammarsGbnf" | "customToolGrammarsGbnfStreaming">;
+interface DirectProviderSamplingOptions {
+    temperature?: number;
+    topP?: number;
+    seed?: number;
+}
 interface DirectProviderConfig {
     kind: DirectProviderKind;
     apiKey: string;
     baseURL?: string;
     anthropicVersion?: string;
     maxTokens?: number;
+    sampling?: DirectProviderSamplingOptions;
     xenoPromptTokenCeiling?: number;
+    xenoEnableThinking?: boolean;
+    xenoToolFormat?: "qwen_native";
     streaming?: boolean;
     capabilityProfile?: DirectProviderCapabilityProfile;
     endpointProfile?: DirectEndpointProfile;
@@ -316,10 +336,18 @@ interface DirectProviderConfig {
         type: "none";
     };
 }
+interface LocalToolGrammarSupport {
+    gbnf: boolean;
+    streaming: boolean;
+}
+declare function probeLocalToolGrammarSupport(baseURL: string, options?: {
+    signal?: AbortSignal;
+    limits?: ProviderTransportLimits;
+}): Promise<LocalToolGrammarSupport>;
 declare function createDirectProvider(config: DirectProviderConfig): LLMProvider;
-type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath">;
+type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath" | "sampling">;
 declare function createOllamaNativeProvider(config: OllamaNativeProviderConfig): LLMProvider;
-type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google";
+type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google" | "google-json-schema";
 interface ToolSchemaProjectionChange {
     path: string;
     keyword: string;
@@ -407,12 +435,28 @@ interface XenoProviderModelDescriptor {
     id: string;
     displayName?: string;
     ownedBy?: string;
+    type?: string;
+    supportedInputModalities?: string[];
+    supportedOutputModalities?: string[];
+    supportedParameters?: string[];
+    supportedGenerationMethods?: string[];
+    execution?: XenoProviderModelExecution;
+    available?: boolean;
+    availability?: string;
     contextTokens?: number;
     inputCostPerMillion?: number;
     outputCostPerMillion?: number;
     capabilities?: Partial<XenoProviderCapabilities>;
     metadataSource: "provider" | "configuration" | "catalog";
 }
+interface XenoProviderModelExecution {
+    sync?: boolean;
+    stream?: boolean;
+    async?: boolean;
+    batch?: boolean;
+    maxBatchItems?: number;
+    endpoint?: string;
+}
 interface XenoProviderProbeResult {
     schemaVersion: 1;
     connectionId: string;
@@ -460,7 +504,7 @@ declare class XenoProviderCatalog {
 }
 declare function probeXenoProvider(options: ProbeXenoProviderOptions): Promise<XenoProviderProbeResult>;
 declare function selectXenoProviderRoute(candidates: XenoProviderRouteCandidate[], policy?: XenoProviderRoutingPolicy): XenoProviderRouteCandidate[];
-declare function directProviderConfigFromConnection(view: XenoProviderConnectionView, secret: string | undefined): DirectProviderConfig;
+declare function directProviderConfigFromConnection(view: XenoProviderConnectionView, secret: string | undefined, model?: XenoProviderModelDescriptor): DirectProviderConfig;
 declare const XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION: 1;
 interface XenoProviderConnectionSnapshot {
     schemaVersion: typeof XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION;
@@ -580,4 +624,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, classifyProviderStreamError, 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 DirectProviderSamplingOptions, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type LocalToolGrammarSupport, 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 XenoProviderModelExecution, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, classifyProviderStreamError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeLocalToolGrammarSupport, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };

package/dist/providers/index.d.ts

@@ -52,6 +52,12 @@ interface ToolDefinition {
         additionalProperties?: boolean | Record<string, unknown>;
         [keyword: string]: unknown;
     };
+    grammar?: ToolInputGrammar;
+}
+interface ToolInputGrammar {
+    syntax: "gbnf";
+    definition: string;
+    inputField: string;
 }
 interface ImageUrlBlock {
     type: "image_url";
@@ -128,6 +134,7 @@ type ApiMessage = {
 };
 interface StreamResult {
     content: ContentBlock[];
+    reasoningContent?: string;
     stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
     inputTokens: number;
     outputTokens: number;
@@ -188,6 +195,9 @@ interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
     quotaRemainingTokens?: number;
+    toolChoice?: "auto" | "none" | "required" | {
+        name: string;
+    };
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -203,6 +213,8 @@ interface LLMProviderCapabilities {
     readonly cancellation?: boolean;
     readonly retryAfter?: boolean;
     readonly promptCaching?: boolean;
+    readonly customToolGrammarsGbnf?: boolean;
+    readonly customToolGrammarsGbnfStreaming?: boolean;
     readonly [capability: string]: boolean | undefined;
 }
 interface LLMProvider {
@@ -291,14 +303,22 @@ declare class DualLLMProvider {
     private chatCloud;
 }
 type DirectProviderKind = "anthropic" | "openai-responses" | "google" | "openai-compatible";
-type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching">;
+type DirectProviderCapabilityProfile = Pick<LLMProviderCapabilities, "streaming" | "textInput" | "imageInput" | "tools" | "parallelToolCalls" | "structuredOutput" | "reasoningMetadata" | "usageAccounting" | "cancellation" | "retryAfter" | "promptCaching" | "customToolGrammarsGbnf" | "customToolGrammarsGbnfStreaming">;
+interface DirectProviderSamplingOptions {
+    temperature?: number;
+    topP?: number;
+    seed?: number;
+}
 interface DirectProviderConfig {
     kind: DirectProviderKind;
     apiKey: string;
     baseURL?: string;
     anthropicVersion?: string;
     maxTokens?: number;
+    sampling?: DirectProviderSamplingOptions;
     xenoPromptTokenCeiling?: number;
+    xenoEnableThinking?: boolean;
+    xenoToolFormat?: "qwen_native";
     streaming?: boolean;
     capabilityProfile?: DirectProviderCapabilityProfile;
     endpointProfile?: DirectEndpointProfile;
@@ -316,10 +336,18 @@ interface DirectProviderConfig {
         type: "none";
     };
 }
+interface LocalToolGrammarSupport {
+    gbnf: boolean;
+    streaming: boolean;
+}
+declare function probeLocalToolGrammarSupport(baseURL: string, options?: {
+    signal?: AbortSignal;
+    limits?: ProviderTransportLimits;
+}): Promise<LocalToolGrammarSupport>;
 declare function createDirectProvider(config: DirectProviderConfig): LLMProvider;
-type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath">;
+type OllamaNativeProviderConfig = Omit<DirectProviderConfig, "kind" | "streaming" | "capabilityProfile" | "chatCompletionsPath" | "sampling">;
 declare function createOllamaNativeProvider(config: OllamaNativeProviderConfig): LLMProvider;
-type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google";
+type ToolSchemaProviderDialect = "xeno" | "anthropic" | "openai-responses" | "openai-chat" | "google" | "google-json-schema";
 interface ToolSchemaProjectionChange {
     path: string;
     keyword: string;
@@ -407,12 +435,28 @@ interface XenoProviderModelDescriptor {
     id: string;
     displayName?: string;
     ownedBy?: string;
+    type?: string;
+    supportedInputModalities?: string[];
+    supportedOutputModalities?: string[];
+    supportedParameters?: string[];
+    supportedGenerationMethods?: string[];
+    execution?: XenoProviderModelExecution;
+    available?: boolean;
+    availability?: string;
     contextTokens?: number;
     inputCostPerMillion?: number;
     outputCostPerMillion?: number;
     capabilities?: Partial<XenoProviderCapabilities>;
     metadataSource: "provider" | "configuration" | "catalog";
 }
+interface XenoProviderModelExecution {
+    sync?: boolean;
+    stream?: boolean;
+    async?: boolean;
+    batch?: boolean;
+    maxBatchItems?: number;
+    endpoint?: string;
+}
 interface XenoProviderProbeResult {
     schemaVersion: 1;
     connectionId: string;
@@ -460,7 +504,7 @@ declare class XenoProviderCatalog {
 }
 declare function probeXenoProvider(options: ProbeXenoProviderOptions): Promise<XenoProviderProbeResult>;
 declare function selectXenoProviderRoute(candidates: XenoProviderRouteCandidate[], policy?: XenoProviderRoutingPolicy): XenoProviderRouteCandidate[];
-declare function directProviderConfigFromConnection(view: XenoProviderConnectionView, secret: string | undefined): DirectProviderConfig;
+declare function directProviderConfigFromConnection(view: XenoProviderConnectionView, secret: string | undefined, model?: XenoProviderModelDescriptor): DirectProviderConfig;
 declare const XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION: 1;
 interface XenoProviderConnectionSnapshot {
     schemaVersion: typeof XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION;
@@ -580,4 +624,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, classifyProviderStreamError, 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 DirectProviderSamplingOptions, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMStatus, FileQuotaAuthority, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, type LocalToolGrammarSupport, 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 XenoProviderModelExecution, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, assertDirectEndpointResolution, classifyProviderHttpError, classifyProviderStreamError, createDirectProvider, createOllamaNativeProvider, createQuotaGovernedProvider, createToolNameCodec, directProviderConfigFromConnection, isQuotaControlError, normalizeQuotaScope, parseRetryAfter, probeLocalToolGrammarSupport, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, providerCapabilityError, providerProtocolError, quotaAncestors, quotaInteger, quotaScopeKey, quotaText, selectXenoProviderRoute, validateDirectEndpoint };