Genkit MCP

// Copyright 2025 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // // SPDX-License-Identifier: Apache-2.0 // This file was generated by jsonschemagen. DO NOT EDIT. package ai type BaseDataPoint struct { Context map[string]any `json:"context,omitempty"` Input map[string]any `json:"input,omitempty"` Output map[string]any `json:"output,omitempty"` Reference map[string]any `json:"reference,omitempty"` TestCaseID string `json:"testCaseId,omitempty"` TraceIDs []string `json:"traceIds,omitempty"` } type BaseEvalDataPoint struct { Context map[string]any `json:"context,omitempty"` Input map[string]any `json:"input,omitempty"` Output map[string]any `json:"output,omitempty"` Reference map[string]any `json:"reference,omitempty"` TestCaseID string `json:"testCaseId,omitempty"` TraceIDs []string `json:"traceIds,omitempty"` } type CandidateError struct { Code CandidateErrorCode `json:"code,omitempty"` Index float64 `json:"index,omitempty"` Message string `json:"message,omitempty"` } type CandidateErrorCode string const ( CandidateErrorCodeBlocked CandidateErrorCode = "blocked" CandidateErrorCodeOther CandidateErrorCode = "other" CandidateErrorCodeUnknown CandidateErrorCode = "unknown" ) type CommonRerankerOptions struct { // Number of documents to rerank K float64 `json:"k,omitempty"` } type CommonRetrieverOptions struct { // Number of documents to retrieve K float64 `json:"k,omitempty"` } type customPart struct { Custom map[string]any `json:"custom,omitempty"` Data any `json:"data,omitempty"` Metadata map[string]any `json:"metadata,omitempty"` } type dataPart struct { Data any `json:"data,omitempty"` Metadata map[string]any `json:"metadata,omitempty"` } type EmbedRequest struct { Input []*Document `json:"input,omitempty"` Options any `json:"options,omitempty"` } type EmbedResponse struct { Embeddings []*Embedding `json:"embeddings,omitempty"` } type Embedding struct { Embedding []float32 `json:"embedding,omitempty"` Metadata map[string]any `json:"metadata,omitempty"` } type EvalFnResponse struct { Evaluation any `json:"evaluation,omitempty"` SampleIndex float64 `json:"sampleIndex,omitempty"` SpanID string `json:"spanId,omitempty"` TestCaseID string `json:"testCaseId,omitempty"` TraceID string `json:"traceId,omitempty"` } type EvalRequest struct { Dataset []*BaseDataPoint `json:"dataset,omitempty"` EvalRunID string `json:"evalRunId,omitempty"` Options any `json:"options,omitempty"` } type EvalResponse []any type EvalStatusEnum string const ( EvalStatusEnumUNKNOWN EvalStatusEnum = "UNKNOWN" EvalStatusEnumPASS EvalStatusEnum = "PASS" EvalStatusEnumFAIL EvalStatusEnum = "FAIL" ) type FinishReason string const ( FinishReasonStop FinishReason = "stop" FinishReasonLength FinishReason = "length" FinishReasonBlocked FinishReason = "blocked" FinishReasonInterrupted FinishReason = "interrupted" FinishReasonOther FinishReason = "other" FinishReasonUnknown FinishReason = "unknown" ) type GenerateActionOptions struct { Config any `json:"config,omitempty"` Docs []*Document `json:"docs,omitempty"` MaxTurns int `json:"maxTurns,omitempty"` Messages []*Message `json:"messages,omitempty"` Model string `json:"model,omitempty"` Output *GenerateActionOutputConfig `json:"output,omitempty"` Resume *GenerateActionResume `json:"resume,omitempty"` ReturnToolRequests bool `json:"returnToolRequests,omitempty"` StepName string `json:"stepName,omitempty"` ToolChoice ToolChoice `json:"toolChoice,omitempty"` Tools []string `json:"tools,omitempty"` } type GenerateActionResume struct { Metadata map[string]any `json:"metadata,omitempty"` Respond []*toolResponsePart `json:"respond,omitempty"` Restart []*toolRequestPart `json:"restart,omitempty"` } type ToolChoice string const ( ToolChoiceAuto ToolChoice = "auto" ToolChoiceRequired ToolChoice = "required" ToolChoiceNone ToolChoice = "none" ) type GenerateActionOutputConfig struct { Constrained bool `json:"constrained,omitempty"` ContentType string `json:"contentType,omitempty"` Format string `json:"format,omitempty"` Instructions *string `json:"instructions,omitempty"` JsonSchema map[string]any `json:"jsonSchema,omitempty"` } // GenerationCommonConfig holds configuration for generation. type GenerationCommonConfig struct { MaxOutputTokens int `json:"maxOutputTokens,omitempty"` StopSequences []string `json:"stopSequences,omitempty"` Temperature float64 `json:"temperature,omitempty"` TopK int `json:"topK,omitempty"` TopP float64 `json:"topP,omitempty"` Version string `json:"version,omitempty"` } // GenerationUsage provides information about the generation process. type GenerationUsage struct { CachedContentTokens int `json:"cachedContentTokens,omitempty"` Custom map[string]float64 `json:"custom,omitempty"` InputAudioFiles int `json:"inputAudioFiles,omitempty"` InputCharacters int `json:"inputCharacters,omitempty"` InputImages int `json:"inputImages,omitempty"` InputTokens int `json:"inputTokens,omitempty"` InputVideos int `json:"inputVideos,omitempty"` OutputAudioFiles int `json:"outputAudioFiles,omitempty"` OutputCharacters int `json:"outputCharacters,omitempty"` OutputImages int `json:"outputImages,omitempty"` OutputTokens int `json:"outputTokens,omitempty"` OutputVideos int `json:"outputVideos,omitempty"` ThoughtsTokens int `json:"thoughtsTokens,omitempty"` TotalTokens int `json:"totalTokens,omitempty"` } type Media struct { ContentType string `json:"contentType,omitempty"` Url string `json:"url,omitempty"` } type mediaPart struct { Media *Media `json:"media,omitempty"` Metadata map[string]any `json:"metadata,omitempty"` } // Message is the contents of a model response. type Message struct { Content []*Part `json:"content,omitempty"` Metadata map[string]any `json:"metadata,omitempty"` Role Role `json:"role,omitempty"` } type ModelInfo struct { ConfigSchema map[string]any `json:"configSchema,omitempty"` Label string `json:"label,omitempty"` Stage ModelStage `json:"stage,omitempty"` Supports *ModelSupports `json:"supports,omitempty"` Versions []string `json:"versions,omitempty"` } type ModelStage string const ( ModelStageFeatured ModelStage = "featured" ModelStageStable ModelStage = "stable" ModelStageUnstable ModelStage = "unstable" ModelStageLegacy ModelStage = "legacy" ModelStageDeprecated ModelStage = "deprecated" ) type ModelSupports struct { Constrained ConstrainedSupport `json:"constrained,omitempty"` ContentType []string `json:"contentType,omitempty"` Context bool `json:"context,omitempty"` Media bool `json:"media,omitempty"` Multiturn bool `json:"multiturn,omitempty"` Output []string `json:"output,omitempty"` SystemRole bool `json:"systemRole,omitempty"` ToolChoice bool `json:"toolChoice,omitempty"` Tools bool `json:"tools,omitempty"` } type ConstrainedSupport string const ( ConstrainedSupportNone ConstrainedSupport = "none" ConstrainedSupportAll ConstrainedSupport = "all" ConstrainedSupportNoTools ConstrainedSupport = "no-tools" ) // A ModelRequest is a request to generate completions from a model. type ModelRequest struct { Config any `json:"config,omitempty"` Docs []*Document `json:"docs,omitempty"` Messages []*Message `json:"messages,omitempty"` // Output describes the desired response format. Output *ModelOutputConfig `json:"output,omitempty"` ToolChoice ToolChoice `json:"toolChoice,omitempty"` // Tools lists the available tools that the model can ask the client to run. Tools []*ToolDefinition `json:"tools,omitempty"` } // A ModelResponse is a model's response to a [ModelRequest]. type ModelResponse struct { Custom any `json:"custom,omitempty"` FinishMessage string `json:"finishMessage,omitempty"` FinishReason FinishReason `json:"finishReason,omitempty"` // LatencyMs is the time the request took in milliseconds. LatencyMs float64 `json:"latencyMs,omitempty"` Message *Message `json:"message,omitempty"` // Request is the [ModelRequest] struct used to trigger this response. Request *ModelRequest `json:"request,omitempty"` // Usage describes how many resources were used by this generation request. Usage *GenerationUsage `json:"usage,omitempty"` } // A ModelResponseChunk is the portion of the [ModelResponse] // that is passed to a streaming callback. type ModelResponseChunk struct { Aggregated bool `json:"aggregated,omitempty"` Content []*Part `json:"content,omitempty"` Custom any `json:"custom,omitempty"` Index int `json:"index,omitempty"` Role Role `json:"role,omitempty"` } // OutputConfig describes the structure that the model's output // should conform to. If Format is [OutputFormatJSON], then Schema // can describe the desired form of the generated JSON. type ModelOutputConfig struct { Constrained bool `json:"constrained,omitempty"` ContentType string `json:"contentType,omitempty"` Format string `json:"format,omitempty"` Schema map[string]any `json:"schema,omitempty"` } type PathMetadata struct { Error string `json:"error,omitempty"` Latency float64 `json:"latency,omitempty"` Path string `json:"path,omitempty"` Status string `json:"status,omitempty"` } type RankedDocumentData struct { Content []*Part `json:"content,omitempty"` Metadata *RankedDocumentMetadata `json:"metadata,omitempty"` } type RankedDocumentMetadata struct { Score float64 `json:"score,omitempty"` } type reasoningPart struct { Metadata map[string]any `json:"metadata,omitempty"` Reasoning string `json:"reasoning,omitempty"` } type RerankerRequest struct { Documents []*Document `json:"documents,omitempty"` Options any `json:"options,omitempty"` Query *Document `json:"query,omitempty"` } type RerankerResponse struct { Documents []*RankedDocumentData `json:"documents,omitempty"` } type resourcePart struct { Metadata map[string]any `json:"metadata,omitempty"` Resource *ResourcePart `json:"resource,omitempty"` } type ResourcePart struct { Uri string `json:"uri,omitempty"` } type RetrieverRequest struct { Options any `json:"options,omitempty"` Query *Document `json:"query,omitempty"` } type RetrieverResponse struct { Documents []*Document `json:"documents,omitempty"` } // Role indicates which entity is responsible for the content of a message. type Role string const ( // RoleSystem indicates this message is user-independent context. RoleSystem Role = "system" // RoleUser indicates this message was generated by the client. RoleUser Role = "user" // RoleModel indicates this message was generated by the model during a previous interaction. RoleModel Role = "model" // RoleTool indicates this message was generated by a local tool, likely triggered by a request // from the model in one of its previous responses. RoleTool Role = "tool" ) type ScoreDetails struct { Reasoning string `json:"reasoning,omitempty"` } type textPart struct { Metadata map[string]any `json:"metadata,omitempty"` Text string `json:"text,omitempty"` } // A ToolDefinition describes a tool. type ToolDefinition struct { Description string `json:"description,omitempty"` // Valid JSON Schema representing the input of the tool. InputSchema map[string]any `json:"inputSchema,omitempty"` // additional metadata for this tool definition Metadata map[string]any `json:"metadata,omitempty"` Name string `json:"name,omitempty"` // Valid JSON Schema describing the output of the tool. OutputSchema map[string]any `json:"outputSchema,omitempty"` } // A ToolRequest is a message from the model to the client that it should run a // specific tool and pass a [ToolResponse] to the model on the next chat request it makes. // Any ToolRequest will correspond to some [ToolDefinition] previously sent by the client. type ToolRequest struct { // Input is a JSON object describing the input values to the tool. // An example might be map[string]any{"country":"USA", "president":3}. Input any `json:"input,omitempty"` Name string `json:"name,omitempty"` Ref string `json:"ref,omitempty"` } type toolRequestPart struct { Metadata map[string]any `json:"metadata,omitempty"` ToolRequest *ToolRequest `json:"toolRequest,omitempty"` } // A ToolResponse is a message from the client to the model containing // the results of running a specific tool on the arguments passed to the client // by the model in a [ToolRequest]. type ToolResponse struct { Name string `json:"name,omitempty"` // Output is a JSON object describing the results of running the tool. // An example might be map[string]any{"name":"Thomas Jefferson", "born":1743}. Output any `json:"output,omitempty"` Ref string `json:"ref,omitempty"` } type toolResponsePart struct { Metadata map[string]any `json:"metadata,omitempty"` ToolResponse *ToolResponse `json:"toolResponse,omitempty"` } type TraceMetadata struct { FeatureName string `json:"featureName,omitempty"` Paths []*PathMetadata `json:"paths,omitempty"` Timestamp float64 `json:"timestamp,omitempty"` }