macrocosmos 1.2.2 → 1.2.3

package/dist/generated/apex/v1/apex.d.ts

@@ -1,747 +1,469 @@
-export interface IChatCompletionRequest {
-    uids?: number[];
-    messages?: IChatMessage[];
-    seed?: number;
-    task?: string;
-    model?: string;
-    testTimeInference?: boolean;
-    mixture?: boolean;
-    samplingParameters?: ISamplingParameters;
-    inferenceMode?: string;
-    jsonFormat?: boolean;
-    stream?: boolean;
-    timeout?: number;
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { type CallOptions, ChannelCredentials, Client, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type handleServerStreamingCall, type handleUnaryCall, Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+export declare const protobufPackage = "apex.v1";
+/**
+ * A request to generate completions following Apex CompletionsRequest format.
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface ChatCompletionRequest {
+    /** uids: the miner UIDs that will be used to generate the completion (optional). */
+    uids: number[];
+    /** messages: the messages to generate completions for. */
+    messages: ChatMessage[];
+    /** seed: the seed to use for the completion. */
+    seed?: number | undefined;
+    /** task: the task to generate completions for (e.g. "InferenceTask"). */
+    task?: string | undefined;
+    /** model: the LLM name to use for the completion. (optional, suggest leaving this empty as not all LLMs are supported) */
+    model?: string | undefined;
+    /** test_time_inference: whether to use test time inference. */
+    testTimeInference?: boolean | undefined;
+    /** mixture: whether to use a mixture of miners to create a slower but better answer. */
+    mixture?: boolean | undefined;
+    /** sampling_parameters: the sampling parameters to use for the completion. */
+    samplingParameters?: SamplingParameters | undefined;
+    /** inference_mode: the inference mode to use for the completion. */
+    inferenceMode?: string | undefined;
+    /** json_format: whether to use JSON format for the completion. */
+    jsonFormat?: boolean | undefined;
+    /** stream: whether to stream the completion. */
+    stream?: boolean | undefined;
+    /** timeout: the timeout for the completion in seconds. */
+    timeout?: number | undefined;
 }
-export interface ISamplingParameters {
-    temperature?: number;
-    topP?: number;
-    topK?: number;
-    maxNewTokens?: number;
-    doSample?: boolean;
+/**
+ * The sampling parameters for the completion.
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface SamplingParameters {
+    /** temperature: the temperature to use for the completion. */
+    temperature: number;
+    /** top_p: the top_p to use for the completion. */
+    topP: number;
+    /** top_k: the top_k to use for the completion. */
+    topK?: number | undefined;
+    /** max_new_tokens: the max_new_tokens to use for the completion. */
+    maxNewTokens: number;
+    /** do_sample: whether to do sample for the completion. */
+    doSample: boolean;
 }
-export interface IChatCompletionResponse {
-    id?: string;
-    choices?: IChoice[];
-    created?: number;
-    model?: string;
-    object?: string;
-    serviceTier?: string;
-    systemFingerprint?: string;
-    usage?: ICompletionUsage;
+/**
+ * A chat completion response, following OpenAI's ChatCompletion format.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion.py
+ */
+export interface ChatCompletionResponse {
+    /** id: the id of the completion. */
+    id: string;
+    /** choices: the choices of the completion. */
+    choices: Choice[];
+    /** created: the created time of the completion. */
+    created: number;
+    /** model: the model of the completion. */
+    model: string;
+    /** object: the object of the completion. */
+    object: string;
+    /** service_tier: the service tier of the completion. (not currently supported in Apex) */
+    serviceTier: string;
+    /** system_fingerprint: the system fingerprint of the completion. (not currently supported in Apex) */
+    systemFingerprint: string;
+    /** usage: the usage of the completion. (not currently supported in Apex) */
+    usage?: CompletionUsage | undefined;
 }
-export interface IChoice {
-    finishReason?: string;
-    index?: number;
-    logprobs?: IChoiceLogprobs;
-    message?: IChatCompletionMessage;
+/**
+ * The choice object containing the message response from the LLM for the completion.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion.py
+ */
+export interface Choice {
+    /** finish_reason: the finish reason of the choice. */
+    finishReason: string;
+    /** index: the index of the choice. */
+    index: number;
+    /** logprobs: the logprobs of the choice. */
+    logprobs?: ChoiceLogprobs | undefined;
+    /** message: the message of the choice. */
+    message?: ChatCompletionMessage | undefined;
 }
-export interface IChatCompletionMessage {
-    content?: string;
-    refusal?: string;
-    role?: string;
-    annotations?: IAnnotation[];
-    audio?: IChatCompletionAudio;
-    functionCall?: IFunctionCall;
-    toolCalls?: IChatCompletionMessageToolCall[];
+/**
+ * The message response object from the LLM.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_message.py
+ */
+export interface ChatCompletionMessage {
+    /** content: the content of the message. */
+    content: string;
+    /** refusal: the refusal of the message. (not currently supported in Apex) */
+    refusal: string;
+    /** role: the role of the message. */
+    role: string;
+    /** annotations: the annotations of the message. (not currently supported in Apex) */
+    annotations: Annotation[];
+    /** audio: the audio of the message. (not currently supported in Apex) */
+    audio?: ChatCompletionAudio | undefined;
+    /** function_call: the function call of the message. */
+    functionCall?: FunctionCall | undefined;
+    /** tool_calls: the tool calls of the message. */
+    toolCalls: ChatCompletionMessageToolCall[];
 }
-export interface IAnnotation {
-    content?: string;
-    role?: string;
+/**
+ * The annotation object for the message. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_message.py
+ */
+export interface Annotation {
+    /** content: the content of the annotation. */
+    content: string;
+    /** role: the role of the annotation. */
+    role: string;
 }
-export interface IChatCompletionAudio {
-    id?: string;
-    data?: string;
-    expiresAt?: number;
-    transcript?: string;
+/**
+ * The audio object for the message. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_audio.py
+ */
+export interface ChatCompletionAudio {
+    /** id: the id of the audio. */
+    id: string;
+    /** data: the data of the audio. */
+    data: string;
+    /** expires_at: the expires at of the audio. */
+    expiresAt: number;
+    /** transcript: the transcript of the audio. */
+    transcript: string;
 }
-export interface IFunctionCall {
-    arguments?: string[];
-    name?: string;
+/**
+ * The function call object for the message.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_message.py
+ */
+export interface FunctionCall {
+    /** arguments: the arguments of the function call. */
+    arguments: string[];
+    /** name: the name of the function call. */
+    name: string;
 }
-export interface IChatCompletionMessageToolCall {
-    id?: string;
-    function?: IFunction;
-    type?: string;
+/**
+ * The tool call object for the message.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_message_tool_call.py
+ */
+export interface ChatCompletionMessageToolCall {
+    /** id: the id of the tool call. */
+    id: string;
+    /** function: the function object for the tool call. */
+    function?: FunctionMessage | undefined;
+    /** type: the type of the tool call. */
+    type: string;
 }
-export interface IFunction {
-    arguments?: string[];
-    name?: string;
+/**
+ * The function object for the tool call.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_message_tool_call.py
+ */
+export interface FunctionMessage {
+    /** arguments: the arguments of the function. */
+    arguments: string[];
+    /** name: the name of the function. */
+    name: string;
 }
-export interface IChatCompletionChunkResponse {
-    id?: string;
-    choices?: IChunkChoice[];
-    created?: number;
-    model?: string;
-    object?: string;
-    serviceTier?: string;
-    systemFingerprint?: string;
-    usage?: ICompletionUsage;
+/**
+ * A streaming chunk response, following OpenAI's ChatCompletionChunk format.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChatCompletionChunkResponse {
+    /** id: the id of the chunk. */
+    id: string;
+    /** choices: the choices of the chunk. */
+    choices: ChunkChoice[];
+    /** created: the created time of the chunk. */
+    created: number;
+    /** model: the model of the chunk. */
+    model: string;
+    /** object: the object of the chunk. (not currently supported in Apex) */
+    object: string;
+    /** service_tier: the service tier of the chunk. (not currently supported in Apex) */
+    serviceTier: string;
+    /** system_fingerprint: the system fingerprint of the chunk. (not currently supported in Apex) */
+    systemFingerprint: string;
+    /** usage: the usage of the chunk. (not currently supported in Apex) */
+    usage?: CompletionUsage | undefined;
 }
-export interface IChatMessage {
-    role?: string;
-    content?: string;
+/**
+ * The choice object for the chunk.
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface ChatMessage {
+    /** role: the role of the message. */
+    role: string;
+    /** content: the content of the message. */
+    content: string;
 }
-export interface IChunkChoice {
-    delta?: IChoiceDelta;
-    finishReason?: string;
-    index?: number;
-    logprobs?: IChoiceLogprobs;
+/**
+ * The choice object for the chunk.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChunkChoice {
+    /** delta: the delta of the choice. */
+    delta?: ChoiceDelta | undefined;
+    /** finish_reason: the finish reason of the choice. */
+    finishReason: string;
+    /** index: the index of the choice. */
+    index: number;
+    /** logprobs: the logprobs of the choice. (not currently supported in Apex) */
+    logprobs?: ChoiceLogprobs | undefined;
 }
-export interface IChoiceLogprobs {
-    content?: IChatCompletionTokenLogprob[];
-    refusal?: IChatCompletionTokenLogprob[];
+/**
+ * The logprobs object for the choice.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChoiceLogprobs {
+    /** content: the content of the logprobs. */
+    content: ChatCompletionTokenLogprob[];
+    /** refusal: the refusal of the logprobs. */
+    refusal: ChatCompletionTokenLogprob[];
 }
-export interface IChoiceDelta {
-    content?: string;
-    functionCall?: IChoiceDeltaFunctionCall;
-    refusal?: string;
-    role?: string;
-    toolCalls?: IChoiceDeltaToolCall[];
+/**
+ * The delta object for the choice.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChoiceDelta {
+    /** content: the content of the delta. */
+    content: string;
+    /** function_call: the function call of the delta. */
+    functionCall?: ChoiceDeltaFunctionCall | undefined;
+    /** refusal: the refusal of the delta. */
+    refusal: string;
+    /** role: the role of the delta. */
+    role: string;
+    /** tool_calls: the tool calls of the delta. */
+    toolCalls: ChoiceDeltaToolCall[];
 }
-export interface IChoiceDeltaFunctionCall {
-    arguments?: string[];
-    name?: string;
+/**
+ * The function call object for the delta.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChoiceDeltaFunctionCall {
+    /** arguments: the arguments of the function call. */
+    arguments: string[];
+    /** name: the name of the function call. */
+    name: string;
 }
-export interface IChoiceDeltaToolCall {
-    index?: number;
-    id?: string;
-    function?: IChoiceDeltaToolCallFunction;
-    type?: string;
+/**
+ * The tool call object for the delta.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChoiceDeltaToolCall {
+    /** index: the index of the tool call. */
+    index: number;
+    /** id: the id of the tool call. */
+    id: string;
+    /** function: the function object for the tool call. */
+    function?: ChoiceDeltaToolCallFunction | undefined;
+    /** type: the type of the tool call. */
+    type: string;
 }
-export interface IChoiceDeltaToolCallFunction {
-    arguments?: string[];
-    name?: string;
+/**
+ * The function object for the tool call.
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_chunk.py
+ */
+export interface ChoiceDeltaToolCallFunction {
+    /** arguments: the arguments of the function. */
+    arguments: string[];
+    /** name: the name of the function. */
+    name: string;
 }
-export interface IChatCompletionTokenLogprob {
-    token?: string;
-    bytes?: number[];
-    logprob?: number;
-    topLogprobs?: ITopLogprob[];
+/**
+ * The chat completion token logprob object. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_token_logprob.py
+ */
+export interface ChatCompletionTokenLogprob {
+    /** token: the token of the logprob. */
+    token: string;
+    /** bytes: the bytes of the logprob. */
+    bytes: number[];
+    /** logprob: the logprob of the token. */
+    logprob: number;
+    /** top_logprobs: the top logprobs of the token. */
+    topLogprobs: TopLogprob[];
 }
-export interface ITopLogprob {
-    token?: string;
-    bytes?: number[];
-    logprob?: number;
+/**
+ * The top logprob object for the token. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_token_logprob.py
+ */
+export interface TopLogprob {
+    /** token: the token of the logprob. */
+    token: string;
+    /** bytes: the bytes of the logprob. */
+    bytes: number[];
+    /** logprob: the logprob of the token. */
+    logprob: number;
 }
-export interface ICompletionUsage {
-    completionTokens?: number;
-    promptTokens?: number;
-    totalTokens?: number;
-    completionTokensDetails?: ICompletionTokensDetails;
-    promptTokensDetails?: IPromptTokensDetails;
+/**
+ * The completion usage object. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/completion_usage.py
+ */
+export interface CompletionUsage {
+    /** completion_tokens: the completion tokens of the usage. */
+    completionTokens: number;
+    /** prompt_tokens: the prompt tokens of the usage. */
+    promptTokens: number;
+    /** total_tokens: the total tokens of the usage. */
+    totalTokens: number;
+    /** completion_tokens_details: the completion tokens details of the usage. */
+    completionTokensDetails?: CompletionTokensDetails | undefined;
+    /** prompt_tokens_details: the prompt tokens details of the usage. */
+    promptTokensDetails?: PromptTokensDetails | undefined;
 }
-export interface ICompletionTokensDetails {
-    acceptedPredictionTokens?: number;
-    audioTokens?: number;
-    reasoningTokens?: number;
-    rejectedPredictionTokens?: number;
+/**
+ * The completion tokens details object. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/completion_usage.py
+ */
+export interface CompletionTokensDetails {
+    /** accepted_prediction_tokens: the accepted prediction tokens of the details. */
+    acceptedPredictionTokens: number;
+    /** audio_tokens: the audio tokens of the details. */
+    audioTokens: number;
+    /** reasoning_tokens: the reasoning tokens of the details. */
+    reasoningTokens: number;
+    /** rejected_prediction_tokens: the rejected prediction tokens of the details. */
+    rejectedPredictionTokens: number;
 }
-export interface IPromptTokensDetails {
-    audioTokens?: number;
-    cachedTokens?: number;
+/**
+ * The prompt tokens details object. (not currently supported in Apex)
+ * Parsed from https://github.com/openai/openai-python/blob/main/src/openai/types/completion_usage.py
+ */
+export interface PromptTokensDetails {
+    /** audio_tokens: the audio tokens of the details. */
+    audioTokens: number;
+    /** cached_tokens: the cached tokens of the details. */
+    cachedTokens: number;
 }
-export interface IWebRetrievalRequest {
-    uids?: number[];
-    searchQuery?: string;
-    nMiners?: number;
-    nResults?: number;
-    maxResponseTime?: number;
-    timeout?: number;
+/**
+ * A web retrival request from Apex
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface WebRetrievalRequest {
+    /** uids: the miner UIDs that will be used to generate the completion (optional). */
+    uids: number[];
+    /** search_query: the search query. */
+    searchQuery: string;
+    /** n_miners: the number of miners to use for the query. */
+    nMiners?: number | undefined;
+    /** n_results: the number of results to return. */
+    nResults?: number | undefined;
+    /** max_response_time: the max response time to allow for the miners to respond in seconds. */
+    maxResponseTime?: number | undefined;
+    /** timeout: the timeout for the web retrieval in seconds. */
+    timeout?: number | undefined;
 }
-export interface IWebSearchResult {
-    url?: string;
-    content?: string;
-    relevant?: string;
+/**
+ * A web search result from Apex
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface WebSearchResult {
+    /** url: the url of the result. */
+    url: string;
+    /** content: the entire page contents. */
+    content: string;
+    /** relevant: the relevant part of the page best fitting the query.. */
+    relevant: string;
 }
-export interface IWebRetrievalResponse {
-    results?: IWebSearchResult[];
+/**
+ * A web retrieval response from Apex
+ * Parsed from https://github.com/macrocosm-os/prompting/blob/main/validator_api/serializers.py
+ */
+export interface WebRetrievalResponse {
+    /** results: the results of the web retrieval. */
+    results: WebSearchResult[];
 }
-export interface IApexServiceClient {
-    ChatCompletion(request: IChatCompletionRequest): Promise<IChatCompletionResponse>;
-    ChatCompletion(request: IChatCompletionRequest, callback: (error: Error | null, response: IChatCompletionResponse) => void): void;
-    ChatCompletionStream(request: IChatCompletionRequest): Promise<AsyncIterable<IChatCompletionChunkResponse>>;
-    ChatCompletionStream(request: IChatCompletionRequest, callback: (error: Error | null, response: AsyncIterable<IChatCompletionChunkResponse>) => void): void;
-    WebRetrieval(request: IWebRetrievalRequest): Promise<IWebRetrievalResponse>;
-    WebRetrieval(request: IWebRetrievalRequest, callback: (error: Error | null, response: IWebRetrievalResponse) => void): void;
-}
-export declare const apex: {
-    options: {
-        syntax: string;
+export declare const ChatCompletionRequest: MessageFns<ChatCompletionRequest>;
+export declare const SamplingParameters: MessageFns<SamplingParameters>;
+export declare const ChatCompletionResponse: MessageFns<ChatCompletionResponse>;
+export declare const Choice: MessageFns<Choice>;
+export declare const ChatCompletionMessage: MessageFns<ChatCompletionMessage>;
+export declare const Annotation: MessageFns<Annotation>;
+export declare const ChatCompletionAudio: MessageFns<ChatCompletionAudio>;
+export declare const FunctionCall: MessageFns<FunctionCall>;
+export declare const ChatCompletionMessageToolCall: MessageFns<ChatCompletionMessageToolCall>;
+export declare const FunctionMessage: MessageFns<FunctionMessage>;
+export declare const ChatCompletionChunkResponse: MessageFns<ChatCompletionChunkResponse>;
+export declare const ChatMessage: MessageFns<ChatMessage>;
+export declare const ChunkChoice: MessageFns<ChunkChoice>;
+export declare const ChoiceLogprobs: MessageFns<ChoiceLogprobs>;
+export declare const ChoiceDelta: MessageFns<ChoiceDelta>;
+export declare const ChoiceDeltaFunctionCall: MessageFns<ChoiceDeltaFunctionCall>;
+export declare const ChoiceDeltaToolCall: MessageFns<ChoiceDeltaToolCall>;
+export declare const ChoiceDeltaToolCallFunction: MessageFns<ChoiceDeltaToolCallFunction>;
+export declare const ChatCompletionTokenLogprob: MessageFns<ChatCompletionTokenLogprob>;
+export declare const TopLogprob: MessageFns<TopLogprob>;
+export declare const CompletionUsage: MessageFns<CompletionUsage>;
+export declare const CompletionTokensDetails: MessageFns<CompletionTokensDetails>;
+export declare const PromptTokensDetails: MessageFns<PromptTokensDetails>;
+export declare const WebRetrievalRequest: MessageFns<WebRetrievalRequest>;
+export declare const WebSearchResult: MessageFns<WebSearchResult>;
+export declare const WebRetrievalResponse: MessageFns<WebRetrievalResponse>;
+export type ApexServiceService = typeof ApexServiceService;
+export declare const ApexServiceService: {
+    /** ChatCompletion generates a completion for a given request. */
+    readonly chatCompletion: {
+        readonly path: "/apex.v1.ApexService/ChatCompletion";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ChatCompletionRequest) => Buffer<ArrayBuffer>;
+        readonly requestDeserialize: (value: Buffer) => ChatCompletionRequest;
+        readonly responseSerialize: (value: ChatCompletionResponse) => Buffer<ArrayBuffer>;
+        readonly responseDeserialize: (value: Buffer) => ChatCompletionResponse;
+    };
+    /** ChatCompletionStream generates a stream of completions for a given request. */
+    readonly chatCompletionStream: {
+        readonly path: "/apex.v1.ApexService/ChatCompletionStream";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: ChatCompletionRequest) => Buffer<ArrayBuffer>;
+        readonly requestDeserialize: (value: Buffer) => ChatCompletionRequest;
+        readonly responseSerialize: (value: ChatCompletionChunkResponse) => Buffer<ArrayBuffer>;
+        readonly responseDeserialize: (value: Buffer) => ChatCompletionChunkResponse;
     };
-    nested: {
-        apex: {
-            nested: {
-                v1: {
-                    options: {
-                        go_package: string;
-                    };
-                    nested: {
-                        ApexService: {
-                            methods: {
-                                ChatCompletion: {
-                                    requestType: string;
-                                    responseType: string;
-                                };
-                                ChatCompletionStream: {
-                                    requestType: string;
-                                    responseType: string;
-                                    responseStream: boolean;
-                                };
-                                WebRetrieval: {
-                                    requestType: string;
-                                    responseType: string;
-                                };
-                            };
-                        };
-                        ChatCompletionRequest: {
-                            fields: {
-                                uids: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                messages: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                seed: {
-                                    type: string;
-                                    id: number;
-                                };
-                                task: {
-                                    type: string;
-                                    id: number;
-                                };
-                                model: {
-                                    type: string;
-                                    id: number;
-                                };
-                                testTimeInference: {
-                                    type: string;
-                                    id: number;
-                                };
-                                mixture: {
-                                    type: string;
-                                    id: number;
-                                };
-                                samplingParameters: {
-                                    type: string;
-                                    id: number;
-                                };
-                                inferenceMode: {
-                                    type: string;
-                                    id: number;
-                                };
-                                jsonFormat: {
-                                    type: string;
-                                    id: number;
-                                };
-                                stream: {
-                                    type: string;
-                                    id: number;
-                                };
-                                timeout: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        SamplingParameters: {
-                            fields: {
-                                temperature: {
-                                    type: string;
-                                    id: number;
-                                };
-                                topP: {
-                                    type: string;
-                                    id: number;
-                                };
-                                topK: {
-                                    type: string;
-                                    id: number;
-                                };
-                                maxNewTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                doSample: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionResponse: {
-                            fields: {
-                                id: {
-                                    type: string;
-                                    id: number;
-                                };
-                                choices: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                created: {
-                                    type: string;
-                                    id: number;
-                                };
-                                model: {
-                                    type: string;
-                                    id: number;
-                                };
-                                object: {
-                                    type: string;
-                                    id: number;
-                                };
-                                serviceTier: {
-                                    type: string;
-                                    id: number;
-                                };
-                                systemFingerprint: {
-                                    type: string;
-                                    id: number;
-                                };
-                                usage: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        Choice: {
-                            fields: {
-                                finishReason: {
-                                    type: string;
-                                    id: number;
-                                };
-                                index: {
-                                    type: string;
-                                    id: number;
-                                };
-                                logprobs: {
-                                    type: string;
-                                    id: number;
-                                };
-                                message: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionMessage: {
-                            fields: {
-                                content: {
-                                    type: string;
-                                    id: number;
-                                };
-                                refusal: {
-                                    type: string;
-                                    id: number;
-                                };
-                                role: {
-                                    type: string;
-                                    id: number;
-                                };
-                                annotations: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                audio: {
-                                    type: string;
-                                    id: number;
-                                };
-                                functionCall: {
-                                    type: string;
-                                    id: number;
-                                };
-                                toolCalls: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        Annotation: {
-                            fields: {
-                                content: {
-                                    type: string;
-                                    id: number;
-                                };
-                                role: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionAudio: {
-                            fields: {
-                                id: {
-                                    type: string;
-                                    id: number;
-                                };
-                                data: {
-                                    type: string;
-                                    id: number;
-                                };
-                                expiresAt: {
-                                    type: string;
-                                    id: number;
-                                };
-                                transcript: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        FunctionCall: {
-                            fields: {
-                                arguments: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                name: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionMessageToolCall: {
-                            fields: {
-                                id: {
-                                    type: string;
-                                    id: number;
-                                };
-                                function: {
-                                    type: string;
-                                    id: number;
-                                };
-                                type: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        Function: {
-                            fields: {
-                                arguments: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                name: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionChunkResponse: {
-                            fields: {
-                                id: {
-                                    type: string;
-                                    id: number;
-                                };
-                                choices: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                created: {
-                                    type: string;
-                                    id: number;
-                                };
-                                model: {
-                                    type: string;
-                                    id: number;
-                                };
-                                object: {
-                                    type: string;
-                                    id: number;
-                                };
-                                serviceTier: {
-                                    type: string;
-                                    id: number;
-                                };
-                                systemFingerprint: {
-                                    type: string;
-                                    id: number;
-                                };
-                                usage: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatMessage: {
-                            fields: {
-                                role: {
-                                    type: string;
-                                    id: number;
-                                };
-                                content: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChunkChoice: {
-                            fields: {
-                                delta: {
-                                    type: string;
-                                    id: number;
-                                };
-                                finishReason: {
-                                    type: string;
-                                    id: number;
-                                };
-                                index: {
-                                    type: string;
-                                    id: number;
-                                };
-                                logprobs: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChoiceLogprobs: {
-                            fields: {
-                                content: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                refusal: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChoiceDelta: {
-                            fields: {
-                                content: {
-                                    type: string;
-                                    id: number;
-                                };
-                                functionCall: {
-                                    type: string;
-                                    id: number;
-                                };
-                                refusal: {
-                                    type: string;
-                                    id: number;
-                                };
-                                role: {
-                                    type: string;
-                                    id: number;
-                                };
-                                toolCalls: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChoiceDeltaFunctionCall: {
-                            fields: {
-                                arguments: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                name: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChoiceDeltaToolCall: {
-                            fields: {
-                                index: {
-                                    type: string;
-                                    id: number;
-                                };
-                                id: {
-                                    type: string;
-                                    id: number;
-                                };
-                                function: {
-                                    type: string;
-                                    id: number;
-                                };
-                                type: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChoiceDeltaToolCallFunction: {
-                            fields: {
-                                arguments: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                name: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        ChatCompletionTokenLogprob: {
-                            fields: {
-                                token: {
-                                    type: string;
-                                    id: number;
-                                };
-                                bytes: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                logprob: {
-                                    type: string;
-                                    id: number;
-                                };
-                                topLogprobs: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        TopLogprob: {
-                            fields: {
-                                token: {
-                                    type: string;
-                                    id: number;
-                                };
-                                bytes: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                logprob: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        CompletionUsage: {
-                            fields: {
-                                completionTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                promptTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                totalTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                completionTokensDetails: {
-                                    type: string;
-                                    id: number;
-                                };
-                                promptTokensDetails: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        CompletionTokensDetails: {
-                            fields: {
-                                acceptedPredictionTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                audioTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                reasoningTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                rejectedPredictionTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        PromptTokensDetails: {
-                            fields: {
-                                audioTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                                cachedTokens: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        WebRetrievalRequest: {
-                            fields: {
-                                uids: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                                searchQuery: {
-                                    type: string;
-                                    id: number;
-                                };
-                                nMiners: {
-                                    type: string;
-                                    id: number;
-                                };
-                                nResults: {
-                                    type: string;
-                                    id: number;
-                                };
-                                maxResponseTime: {
-                                    type: string;
-                                    id: number;
-                                };
-                                timeout: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        WebSearchResult: {
-                            fields: {
-                                url: {
-                                    type: string;
-                                    id: number;
-                                };
-                                content: {
-                                    type: string;
-                                    id: number;
-                                };
-                                relevant: {
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                        WebRetrievalResponse: {
-                            fields: {
-                                results: {
-                                    rule: string;
-                                    type: string;
-                                    id: number;
-                                };
-                            };
-                        };
-                    };
-                };
-            };
-        };
+    /** WebRetrieval retrieves web search results for a given request. */
+    readonly webRetrieval: {
+        readonly path: "/apex.v1.ApexService/WebRetrieval";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: WebRetrievalRequest) => Buffer<ArrayBuffer>;
+        readonly requestDeserialize: (value: Buffer) => WebRetrievalRequest;
+        readonly responseSerialize: (value: WebRetrievalResponse) => Buffer<ArrayBuffer>;
+        readonly responseDeserialize: (value: Buffer) => WebRetrievalResponse;
     };
 };
+export interface ApexServiceServer extends UntypedServiceImplementation {
+    /** ChatCompletion generates a completion for a given request. */
+    chatCompletion: handleUnaryCall<ChatCompletionRequest, ChatCompletionResponse>;
+    /** ChatCompletionStream generates a stream of completions for a given request. */
+    chatCompletionStream: handleServerStreamingCall<ChatCompletionRequest, ChatCompletionChunkResponse>;
+    /** WebRetrieval retrieves web search results for a given request. */
+    webRetrieval: handleUnaryCall<WebRetrievalRequest, WebRetrievalResponse>;
+}
+export interface ApexServiceClient extends Client {
+    /** ChatCompletion generates a completion for a given request. */
+    chatCompletion(request: ChatCompletionRequest, callback: (error: ServiceError | null, response: ChatCompletionResponse) => void): ClientUnaryCall;
+    chatCompletion(request: ChatCompletionRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ChatCompletionResponse) => void): ClientUnaryCall;
+    chatCompletion(request: ChatCompletionRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ChatCompletionResponse) => void): ClientUnaryCall;
+    /** ChatCompletionStream generates a stream of completions for a given request. */
+    chatCompletionStream(request: ChatCompletionRequest, options?: Partial<CallOptions>): ClientReadableStream<ChatCompletionChunkResponse>;
+    chatCompletionStream(request: ChatCompletionRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<ChatCompletionChunkResponse>;
+    /** WebRetrieval retrieves web search results for a given request. */
+    webRetrieval(request: WebRetrievalRequest, callback: (error: ServiceError | null, response: WebRetrievalResponse) => void): ClientUnaryCall;
+    webRetrieval(request: WebRetrievalRequest, metadata: Metadata, callback: (error: ServiceError | null, response: WebRetrievalResponse) => void): ClientUnaryCall;
+    webRetrieval(request: WebRetrievalRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: WebRetrievalResponse) => void): ClientUnaryCall;
+}
+export declare const ApexServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): ApexServiceClient;
+    service: typeof ApexServiceService;
+    serviceName: string;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create(base?: DeepPartial<T>): T;
+    fromPartial(object: DeepPartial<T>): T;
+}
+export {};