generativeaiagentruntime

type ChatDetails struct {

	// The input user message content for the chat.
	UserMessage *string `mandatory:"false" json:"userMessage"`

	// Whether to stream the response.
	ShouldStream *bool `mandatory:"false" json:"shouldStream"`

	// Optional sessionId. If not provided, will chat without any prior context.
	SessionId *string `mandatory:"false" json:"sessionId"`

	// A map where each key is a toolId and the value contains tool type and additional dynamic parameters. This field is deprecated and will be removed after July 02 2026.
	ToolParameters map[string]string `mandatory:"false" json:"toolParameters"`

	// Array of tool input objects, each specifying a tool's ID, type, and corresponding input parameters required for execution.
	ToolInputs []ToolInput `mandatory:"false" json:"toolInputs"`

	// A list of actions that have been performed based on prior required actions.
	PerformedActions []PerformedAction `mandatory:"false" json:"performedActions"`
}

type ChatRequest struct {

	// A unique ID for the endpoint.
	AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

	// Input for chat.
	ChatDetails `contributesTo:"body"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// For optimistic concurrency control. In the PUT or DELETE call
	// for a resource, set the `if-match` parameter to the value of the
	// etag from a previous GET or POST response for that resource.
	// The resource will be updated or deleted only if the etag you
	// provide matches the resource's current etag value.
	IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

	// A token that uniquely identifies a request so it can be retried in case of a timeout or
	// server error without risk of executing that same action again. Retry tokens expire after 24
	// hours, but can be invalidated before then due to conflicting operations. For example, if a resource
	// has been deleted and purged from the system, then a retry of the original creation request
	// might be rejected.
	OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type ChatResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// The ChatResult instance
	ChatResult `presentIn:"body"`

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type ChatResult struct {
	Message *Message `mandatory:"false" json:"message"`

	// The trace that displays the internal progression, such as reasoning and actions during an execution.
	Traces []Trace `mandatory:"false" json:"traces"`

	// A map where each key is a toolId and the value contains tool type and additional dynamic results. This field is deprecated and will be removed after July 02 2026.
	ToolResults map[string]string `mandatory:"false" json:"toolResults"`

	// Array of tool outputs in execution order. Each item includes the tool OCID, output type,
	// and corresponding content. The result structure is defined by the `toolOutputType` discriminator.
	ToolOutputs []ToolOutput `mandatory:"false" json:"toolOutputs"`

	// A list of actions the agent requires the user or agent client to perform.
	RequiredActions []RequiredAction `mandatory:"false" json:"requiredActions"`

	// Captures the result of guardrail evaluations as JSON string performed on either the input to the agent or the output generated by the agent.
	GuardrailResult *string `mandatory:"false" json:"guardrailResult"`
}

type Citation struct {

	// The text that's the source for the agent's response.
	SourceText *string `mandatory:"false" json:"sourceText"`

	SourceLocation SourceLocation `mandatory:"false" json:"sourceLocation"`

	// The title of the source text, if available.
	Title *string `mandatory:"false" json:"title"`

	// The id of the retrieved document, if available.
	DocId *string `mandatory:"false" json:"docId"`

	// The page numbers on the retrieved document, if available.
	PageNumbers []int `mandatory:"false" json:"pageNumbers"`

	// The metadata of the retrieved document, if available.
	Metadata map[string]interface{} `mandatory:"false" json:"metadata"`
}

type CreateSessionDetails struct {

	// The name of the session. A session names doesn't have to be unique and you can change the session name later.
	DisplayName *string `mandatory:"false" json:"displayName"`

	// An optional description of the session.
	Description *string `mandatory:"false" json:"description"`
}

type CreateSessionRequest struct {

	// Details for the new agent session.
	CreateSessionDetails `contributesTo:"body"`

	// A unique ID for the endpoint.
	AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

	// A token that uniquely identifies a request so it can be retried in case of a timeout or
	// server error without risk of executing that same action again. Retry tokens expire after 24
	// hours, but can be invalidated before then due to conflicting operations. For example, if a resource
	// has been deleted and purged from the system, then a retry of the original creation request
	// might be rejected.
	OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type CreateSessionResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// The Session instance
	Session `presentIn:"body"`

	// For optimistic concurrency control. See `if-match`.
	Etag *string `presentIn:"header" name:"etag"`

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type DeleteSessionRequest struct {

	// A unique ID for the endpoint.
	AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

	// A unique ID for the session.
	SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

	// For optimistic concurrency control. In the PUT or DELETE call
	// for a resource, set the `if-match` parameter to the value of the
	// etag from a previous GET or POST response for that resource.
	// The resource will be updated or deleted only if the etag you
	// provide matches the resource's current etag value.
	IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type DeleteSessionResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type ErrorTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// The error message in this trace.
	ErrorMessage *string `mandatory:"false" json:"errorMessage"`

	// Error code.
	Code *string `mandatory:"false" json:"code"`
}

type ExecutionTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// Input data.
	Input *string `mandatory:"false" json:"input"`

	// Output data.
	Output *string `mandatory:"false" json:"output"`
}

type FunctionCall struct {

	// Name of the function to be executed.
	Name *string `mandatory:"true" json:"name"`

	// Arguments for the function call as a JSON string.
	Arguments *string `mandatory:"true" json:"arguments"`
}

type FunctionCallingPerformedAction struct {

	// The unique identifier for the action that has been performed.
	ActionId *string `mandatory:"true" json:"actionId"`

	// The result or output of the function call.
	FunctionCallOutput *string `mandatory:"true" json:"functionCallOutput"`
}

type FunctionCallingRequiredAction struct {

	// The unique identifier for the action to be performed.
	ActionId *string `mandatory:"true" json:"actionId"`

	FunctionCall *FunctionCall `mandatory:"true" json:"functionCall"`
}

type GenerationTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// The generated response that's returned to the user.
	Generation *string `mandatory:"false" json:"generation"`

	// The input to the generation operation.
	Input *string `mandatory:"false" json:"input"`

	// Details of model and its usage.
	Usage []Usage `mandatory:"false" json:"usage"`
}

type GenerativeAiAgentRuntimeClient struct {
	common.BaseClient
	// contains filtered or unexported fields
}

type GenericToolInput struct {

	// Unique OCID of the tool.
	ToolId *string `mandatory:"true" json:"toolId"`

	// A freeform JSON object containing the input parameters to be passed to the tool during execution.
	Input *interface{} `mandatory:"true" json:"input"`
}

type GenericToolOutput struct {

	// Specifies the unique OCID of the tool.
	ToolId *string `mandatory:"true" json:"toolId"`

	// Specifies the freeform JSON object containing the tool’s output.
	Output *interface{} `mandatory:"true" json:"output"`

	// Specifies the display name of the tool.
	ToolName *string `mandatory:"false" json:"toolName"`
}

type GetSessionRequest struct {

	// A unique ID for the endpoint.
	AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

	// A unique ID for the session.
	SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type GetSessionResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// The Session instance
	Session `presentIn:"body"`

	// For optimistic concurrency control. See `if-match`.
	Etag *string `presentIn:"header" name:"etag"`

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type HumanApprovalPerformedAction struct {

	// The unique identifier for the action that has been performed.
	ActionId *string `mandatory:"true" json:"actionId"`

	// The chosen approval or denial option to the agent.
	ChosenOption HumanApprovalPerformedActionChosenOptionEnum `mandatory:"true" json:"chosenOption"`
}

type HumanApprovalPerformedActionChosenOptionEnum string

type HumanApprovalRequiredAction struct {

	// The unique identifier for the action to be performed.
	ActionId *string `mandatory:"true" json:"actionId"`

	// Message accompanying the human input request asking for approval or denial of a tool execution.
	Message *string `mandatory:"true" json:"message"`

	// The options presented to the user approving and denying execution of the tool.
	Options []HumanApprovalRequiredActionOptionsEnum `mandatory:"true" json:"options"`
}

type HumanApprovalRequiredActionOptionsEnum string

type KnowledgeBaseMetadataSummary struct {

	// The name of the field
	Name *string `mandatory:"true" json:"name"`

	// The data type of the field (e.g., "array", "number", "string")
	Type *string `mandatory:"true" json:"type"`

	// List of supported operations for this field (e.g., "equals", "in", "contains")
	Operations []string `mandatory:"true" json:"operations"`

	// List of metadata values available in the knowledge base along with the matching documents count.
	Values []KnowledgeBaseMetadataValue `mandatory:"true" json:"values"`

	// Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.
	// Example: `{"bar-key": "value"}`
	FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`

	// Defined tags for this resource. Each key is predefined and scoped to a namespace.
	// Example: `{"foo-namespace": {"bar-key": "value"}}`
	DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`

	// System tags for this resource. Each key is predefined and scoped to a namespace.
	// Example: `{"orcl-cloud": {"free-tier-retained": "true"}}`
	SystemTags map[string]map[string]interface{} `mandatory:"false" json:"systemTags"`
}

type KnowledgeBaseMetadataValue struct {

	// The value of the metadata
	Value *string `mandatory:"true" json:"value"`

	// Number of documents where this value exists
	Count *int64 `mandatory:"true" json:"count"`
}

type Message struct {

	// The role of the sender of this message.
	Role MessageRoleEnum `mandatory:"true" json:"role"`

	Content *MessageContent `mandatory:"true" json:"content"`

	// The date and time that the message was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`
}

type MessageContent struct {

	// The content of the message.
	Text *string `mandatory:"true" json:"text"`

	// Citations to data sources used for generating an agent's message.
	Citations []Citation `mandatory:"false" json:"citations"`

	// A list of citations used to generate the paragraphs of the agent message.
	ParagraphCitations []ParagraphCitation `mandatory:"false" json:"paragraphCitations"`
}

type MessageRoleEnum string

type MetadataFilter struct {

	// The name of the field to filter on
	FieldName *string `mandatory:"true" json:"fieldName"`

	// The value to filter for in the specified field
	Value *string `mandatory:"true" json:"value"`
}

type ModelDetails struct {

	// Name of the model.
	ModelName *string `mandatory:"false" json:"modelName"`

	// Version of the model.
	ModelVersion *string `mandatory:"false" json:"modelVersion"`

	ModelParams *ModelParams `mandatory:"false" json:"modelParams"`
}

type ModelParams struct {

	// Maximum number of tokens.
	MaxTokens *int `mandatory:"false" json:"maxTokens"`

	// Sampling temperature.
	Temperature *float32 `mandatory:"false" json:"temperature"`

	// Nucleus sampling probability.
	TopP *float32 `mandatory:"false" json:"topP"`

	// Top-K sampling parameter.
	TopK *int `mandatory:"false" json:"topK"`

	// Frequency penalty to reduce repeating tokens.
	FrequencyPenalty *float32 `mandatory:"false" json:"frequencyPenalty"`

	// Presence penalty to encourage new topics.
	PresencePenalty *float32 `mandatory:"false" json:"presencePenalty"`
}

type OciDatabaseSourceLocation struct {

	// The OCID of the OCI Database Tools Connection (https://docs.oracle.com/iaas/database-tools/home.htm).
	Id *string `mandatory:"false" json:"id"`

	// The name of the function that returns source text.
	FunctionName *string `mandatory:"false" json:"functionName"`

	// The URL of the retrieved document, if available.
	Url *string `mandatory:"false" json:"url"`
}

type OciObjectStorageSourceLocation struct {

	// The URL of the OCI Object Storage data source.
	Url *string `mandatory:"false" json:"url"`
}

type OciOpenSearchSourceLocation struct {

	// The OCID of the OCI OpenSearch cluster.
	Id *string `mandatory:"false" json:"id"`

	// The name of the index in OpenSearch that contains the source text.
	IndexName *string `mandatory:"false" json:"indexName"`

	// The URL of the retrieved document, if available.
	Url *string `mandatory:"false" json:"url"`
}

type Paragraph struct {

	// The part of the generated message that contains a citation.
	Text *string `mandatory:"true" json:"text"`

	// Where the text with a citation starts in the generated message.
	Start *int `mandatory:"true" json:"start"`

	// Where the text with a citation ends in the generated message.
	End *int `mandatory:"true" json:"end"`
}

type ParagraphCitation struct {
	Paragraph *Paragraph `mandatory:"true" json:"paragraph"`

	// A list of citations for the paragraph of the generated message.
	Citations []Citation `mandatory:"false" json:"citations"`
}

type PerformedAction interface {

	// The unique identifier for the action that has been performed.
	GetActionId() *string
}

type PerformedActionPerformedActionTypeEnum string

type PlanningTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// Input prompt to planning LLM.
	Input *string `mandatory:"false" json:"input"`

	// Output string from planning LLM.
	Output *string `mandatory:"false" json:"output"`

	// Details of model and its usage.
	Usage []Usage `mandatory:"false" json:"usage"`
}

type RagToolOutput struct {

	// Specifies the unique OCID of the tool.
	ToolId *string `mandatory:"true" json:"toolId"`

	// Specifies the generated answer from the RAG tool.
	Text *string `mandatory:"true" json:"text"`

	// Specifies the display name of the tool.
	ToolName *string `mandatory:"false" json:"toolName"`

	// Citations to data sources used for tool's generated answer.
	Citations []Citation `mandatory:"false" json:"citations"`

	// A list of citations used to generate the paragraphs of the tool's generated answer.
	ParagraphCitations []ParagraphCitation `mandatory:"false" json:"paragraphCitations"`
}

type RequiredAction interface {

	// The unique identifier for the action to be performed.
	GetActionId() *string
}

type RequiredActionRequiredActionTypeEnum string

type RetrievalTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// The agent's search string for getting the displayed information.
	RetrievalInput *string `mandatory:"false" json:"retrievalInput"`

	// A list of citations retrieved from data sources.
	Citations []Citation `mandatory:"false" json:"citations"`

	// Details of model and its usage.
	Usage []Usage `mandatory:"false" json:"usage"`
}

type RetrieveMetadataDetails struct {

	// List of metadata filters to narrow down the retrieved metadata
	Filters []MetadataFilter `mandatory:"false" json:"filters"`
}

type RetrieveMetadataRequest struct {

	// A unique ID for the Knowledge Base.
	KnowledgeBaseId *string `mandatory:"true" contributesTo:"path" name:"knowledgeBaseId"`

	// Input for retrieve metadata.
	RetrieveMetadataDetails `contributesTo:"body"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// For optimistic concurrency control. In the PUT or DELETE call
	// for a resource, set the `if-match` parameter to the value of the
	// etag from a previous GET or POST response for that resource.
	// The resource will be updated or deleted only if the etag you
	// provide matches the resource's current etag value.
	IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

	// A token that uniquely identifies a request so it can be retried in case of a timeout or
	// server error without risk of executing that same action again. Retry tokens expire after 24
	// hours, but can be invalidated before then due to conflicting operations. For example, if a resource
	// has been deleted and purged from the system, then a retry of the original creation request
	// might be rejected.
	OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type RetrieveMetadataResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// The []KnowledgeBaseMetadataSummary instance
	Items []KnowledgeBaseMetadataSummary `presentIn:"body"`

	// For optimistic concurrency control. See `if-match`.
	Etag *string `presentIn:"header" name:"etag"`

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type Session struct {

	// A unique ID for the session. This ID is immutable on creation.
	Id *string `mandatory:"true" json:"id"`

	// The date and time that the session started in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"true" json:"timeCreated"`

	// A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
	DisplayName *string `mandatory:"false" json:"displayName"`

	// A description of the session.
	Description *string `mandatory:"false" json:"description"`

	// A greeting message that the you receive when you start of a session.
	WelcomeMessage *string `mandatory:"false" json:"welcomeMessage"`

	// The date and time that the session was last updated in the format of an RFC3339 datetime string.
	TimeUpdated *common.SDKTime `mandatory:"false" json:"timeUpdated"`
}

type SourceDetails struct {

	// Id of the source of the event.
	Key *string `mandatory:"false" json:"key"`

	// Name of the source of the event.
	Name *string `mandatory:"false" json:"name"`
}

type SourceLocation interface {
}

type SourceLocationSourceLocationTypeEnum string

type SqlResultFiles struct {

	// Specifies the path or URL to status metadata.
	StatusFile *string `mandatory:"false" json:"statusFile"`

	// Specifies the path or URL to the full SQL result data.
	DataFile *string `mandatory:"false" json:"dataFile"`
}

type SqlToolOutput struct {

	// Specifies the unique OCID of the tool.
	ToolId *string `mandatory:"true" json:"toolId"`

	// Specifies the generated SQL query.
	GeneratedSql *string `mandatory:"true" json:"generatedSql"`

	// Specifies the display name of the tool.
	ToolName *string `mandatory:"false" json:"toolName"`

	// Represents preview rows from the SQL query.
	Result []interface{} `mandatory:"false" json:"result"`

	ResultFiles *SqlResultFiles `mandatory:"false" json:"resultFiles"`

	// Specifies optional metadata content.
	AdditionalInfo *string `mandatory:"false" json:"additionalInfo"`
}

type ToolInput interface {

	// Unique OCID of the tool.
	GetToolId() *string
}

type ToolInputToolInputTypeEnum string

type ToolInvocationTrace struct {

	// Unique identifier for the event (UUID).
	Key *string `mandatory:"false" json:"key"`

	// Identifier of the parent event, if applicable (UUID).
	ParentKey *string `mandatory:"false" json:"parentKey"`

	Source *SourceDetails `mandatory:"false" json:"source"`

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

	// Timestamp for when the event ended (In RFC 3339).
	TimeFinished *common.SDKTime `mandatory:"false" json:"timeFinished"`

	// The ID of the selected tool based on the user query.
	ToolId *string `mandatory:"false" json:"toolId"`

	// The display name of the selected tool.
	ToolName *string `mandatory:"false" json:"toolName"`

	// The invocation details related to the selected tool.
	InvocationDetails *string `mandatory:"false" json:"invocationDetails"`
}

type ToolOutput interface {

	// Specifies the unique OCID of the tool.
	GetToolId() *string

	// Specifies the display name of the tool.
	GetToolName() *string
}

type ToolOutputToolOutputTypeEnum string

type Trace interface {

	// Unique identifier for the event (UUID).
	GetKey() *string

	// Identifier of the parent event, if applicable (UUID).
	GetParentKey() *string

	GetSource() *SourceDetails

	// The date and time that the trace was created in the format of an RFC3339 datetime string.
	GetTimeCreated() *common.SDKTime

	// Timestamp for when the event ended (In RFC 3339).
	GetTimeFinished() *common.SDKTime
}

type TraceTraceTypeEnum string

type UpdateSessionDetails struct {

	// The name of the session. A session names doesn't have to be unique and you can change the session name later.
	DisplayName *string `mandatory:"false" json:"displayName"`

	// A description of the session.
	Description *string `mandatory:"false" json:"description"`
}

type UpdateSessionRequest struct {

	// A unique ID for the endpoint.
	AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

	// A unique ID for the session.
	SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

	// Details to update an agent session.
	UpdateSessionDetails `contributesTo:"body"`

	// For optimistic concurrency control. In the PUT or DELETE call
	// for a resource, set the `if-match` parameter to the value of the
	// etag from a previous GET or POST response for that resource.
	// The resource will be updated or deleted only if the etag you
	// provide matches the resource's current etag value.
	IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

	// The client request ID for tracing.
	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

	// Metadata about the request. This information will not be transmitted to the service, but
	// represents information that the SDK will consume to drive retry behavior.
	RequestMetadata common.RequestMetadata
}

type UpdateSessionResponse struct {

	// The underlying http response
	RawResponse *http.Response

	// The Session instance
	Session `presentIn:"body"`

	// For optimistic concurrency control. See `if-match`.
	Etag *string `presentIn:"header" name:"etag"`

	// Unique Oracle-assigned identifier for the request. If you need to contact
	// Oracle about a particular request, please provide the request ID.
	OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

type Usage struct {
	ModelDetails *ModelDetails `mandatory:"false" json:"modelDetails"`

	UsageDetails *UsageDetails `mandatory:"false" json:"usageDetails"`
}

type UsageDetails struct {

	// Number of input tokens.
	InputTokenCount *int `mandatory:"false" json:"inputTokenCount"`

	// Number of output tokens.
	OutputTokenCount *int `mandatory:"false" json:"outputTokenCount"`

	// Number of input characters.
	InputCharCount *int `mandatory:"false" json:"inputCharCount"`

	// Number of output characters.
	OutputCharCount *int `mandatory:"false" json:"outputCharCount"`
}