assistant

package
v0.0.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 12, 2026 License: AGPL-3.0 Imports: 4 Imported by: 0

Documentation

Overview

Package assistant contains the internal types for the assistant API group. The internal version is used for conversion between external versions.

Index

Constants

View Source
const (
	// AssistantEndpointName is the name of the singleton endpoint object. One
	// assistant serves the control plane, so there is exactly one.
	AssistantEndpointName = "assistant"

	// DefaultAgentCardPath is the well-known A2A agent card location.
	DefaultAgentCardPath = "/.well-known/agent-card.json"
)
View Source
const GroupName = "assistant.miloapis.com"

GroupName is the group name for the assistant API.

Variables

View Source
var (
	// SchemeBuilder collects functions that add types to a scheme.
	SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes)
	// AddToScheme adds the types in this group to the given scheme.
	AddToScheme = SchemeBuilder.AddToScheme
)
View Source
var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal}

SchemeGroupVersion is the group version used to register these objects. The internal version uses runtime.APIVersionInternal.

Functions

func Kind

func Kind(kind string) schema.GroupKind

Kind takes an unqualified kind and returns a Group-qualified GroupKind.

func Resource

func Resource(resource string) schema.GroupResource

Resource takes an unqualified resource and returns a Group-qualified GroupResource.

Types

type AssistantEndpoint

type AssistantEndpoint struct {
	metav1.TypeMeta
	metav1.ObjectMeta

	Spec AssistantEndpointSpec
}

AssistantEndpoint is the internal form of the endpoint discovery resource. See the v1alpha1 type for what it is and why it exists. +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

func (*AssistantEndpoint) DeepCopy

func (in *AssistantEndpoint) DeepCopy() *AssistantEndpoint

DeepCopy is a deepcopy function, copying the receiver, creating a new AssistantEndpoint.

func (*AssistantEndpoint) DeepCopyInto

func (in *AssistantEndpoint) DeepCopyInto(out *AssistantEndpoint)

DeepCopyInto is a deepcopy function, copying the receiver into out.

func (*AssistantEndpoint) DeepCopyObject

func (in *AssistantEndpoint) DeepCopyObject() runtime.Object

DeepCopyObject is a deepcopy function, copying the receiver, creating a new runtime.Object.

func (*AssistantEndpoint) Marshal

func (in *AssistantEndpoint) Marshal() ([]byte, error)

func (*AssistantEndpoint) Unmarshal

func (in *AssistantEndpoint) Unmarshal(data []byte) error

type AssistantEndpointList

type AssistantEndpointList struct {
	metav1.TypeMeta
	metav1.ListMeta
	Items []AssistantEndpoint
}

+k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

func (*AssistantEndpointList) DeepCopy

DeepCopy is a deepcopy function, copying the receiver, creating a new AssistantEndpointList.

func (*AssistantEndpointList) DeepCopyInto

func (in *AssistantEndpointList) DeepCopyInto(out *AssistantEndpointList)

DeepCopyInto is a deepcopy function, copying the receiver into out.

func (*AssistantEndpointList) DeepCopyObject

func (in *AssistantEndpointList) DeepCopyObject() runtime.Object

DeepCopyObject is a deepcopy function, copying the receiver, creating a new runtime.Object.

func (*AssistantEndpointList) Marshal

func (in *AssistantEndpointList) Marshal() ([]byte, error)

func (*AssistantEndpointList) Unmarshal

func (in *AssistantEndpointList) Unmarshal(data []byte) error

type AssistantEndpointSpec

type AssistantEndpointSpec struct {
	URL           string
	AgentCardPath string
}

AssistantEndpointSpec describes how to reach the service.

type CapabilityGap

type CapabilityGap struct {
	metav1.TypeMeta
	// Name = capability key (or the report id for a keyless report),
	// Namespace = provider project, CreationTimestamp = first seen.
	metav1.ObjectMeta

	Status CapabilityGapStatus
}

CapabilityGap is the aggregate form of the above: see the v1alpha1 type. +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object +genclient

func (*CapabilityGap) DeepCopy

func (in *CapabilityGap) DeepCopy() *CapabilityGap

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGap.

func (*CapabilityGap) DeepCopyInto

func (in *CapabilityGap) DeepCopyInto(out *CapabilityGap)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*CapabilityGap) DeepCopyObject

func (in *CapabilityGap) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type CapabilityGapList

type CapabilityGapList struct {
	metav1.TypeMeta
	metav1.ListMeta
	Items []CapabilityGap
}

func (*CapabilityGapList) DeepCopy

func (in *CapabilityGapList) DeepCopy() *CapabilityGapList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapList.

func (*CapabilityGapList) DeepCopyInto

func (in *CapabilityGapList) DeepCopyInto(out *CapabilityGapList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*CapabilityGapList) DeepCopyObject

func (in *CapabilityGapList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type CapabilityGapReport

type CapabilityGapReport struct {
	metav1.TypeMeta
	// Name = report id, Namespace = provider project, CreationTimestamp = created_at.
	metav1.ObjectMeta

	Status CapabilityGapReportStatus
}

CapabilityGapReport is one capability-gap report. name == the report id; namespace == the PROVIDER project (spec.reportingProject on the capability document that raised it) — never the consumer project the conversation ran in, which is carried only as provenance in Status. Read-only (written by the report_capability_gap tool, surfaced here for list/get).

func (*CapabilityGapReport) DeepCopy

func (in *CapabilityGapReport) DeepCopy() *CapabilityGapReport

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapReport.

func (*CapabilityGapReport) DeepCopyInto

func (in *CapabilityGapReport) DeepCopyInto(out *CapabilityGapReport)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*CapabilityGapReport) DeepCopyObject

func (in *CapabilityGapReport) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type CapabilityGapReportEvidence

type CapabilityGapReportEvidence struct {
	// Tool is the tool whose output was at fault.
	Tool string
	// Observed is what that tool returned.
	Observed string
	// ContradictedBy is the fact that makes Observed wrong, thin, or
	// impossible to act on.
	ContradictedBy string
}

CapabilityGapReportEvidence quotes the offending tool output. It carries tool output and object state only — never text from the user's message.

func (*CapabilityGapReportEvidence) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapReportEvidence.

func (*CapabilityGapReportEvidence) DeepCopyInto

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type CapabilityGapReportList

type CapabilityGapReportList struct {
	metav1.TypeMeta
	metav1.ListMeta
	Items []CapabilityGapReport
}

func (*CapabilityGapReportList) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapReportList.

func (*CapabilityGapReportList) DeepCopyInto

func (in *CapabilityGapReportList) DeepCopyInto(out *CapabilityGapReportList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*CapabilityGapReportList) DeepCopyObject

func (in *CapabilityGapReportList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type CapabilityGapReportStatus

type CapabilityGapReportStatus struct {
	// ServiceName identifies the provider service the gap belongs to.
	ServiceName string
	// ConsumerProject is the project the conversation happened in — provenance only.
	ConsumerProject string
	// ContextID is the conversation the gap arose in — provenance only.
	ContextID string
	// CapabilityKey groups this occurrence with other reports of the same
	// gap. Empty on reports filed before keys existed, or without one.
	CapabilityKey string
	// Capability is a short description of the capability at fault.
	Capability string
	// Summary is what the user was trying to do.
	Summary string
	// Kind classifies the shortfall (MissingCapability, InsufficientDetail,
	// MisleadingOutput, UnactionableGuidance). Reports stored before kinds
	// existed read back as MissingCapability.
	Kind string
	// Evidence quotes the tool output a non-MissingCapability report is
	// about. Nil when there is nothing to quote.
	Evidence *CapabilityGapReportEvidence
}

CapabilityGapReportStatus carries the report's content.

func (*CapabilityGapReportStatus) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapReportStatus.

func (*CapabilityGapReportStatus) DeepCopyInto

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type CapabilityGapStatus

type CapabilityGapStatus struct {
	// ServiceName identifies the provider service the gap belongs to.
	ServiceName string
	// CapabilityKey is the key the occurrences share. Empty for a gap filed
	// before keys existed, which stands alone.
	CapabilityKey string
	// Capability is the most recent occurrence's description.
	Capability string
	// Kind is the most recent occurrence's classification.
	Kind string
	// Conversations counts the distinct conversations that hit this gap.
	Conversations int32
	// Occurrences counts the reports filed; it can exceed Conversations.
	Occurrences int32
	// FirstSeen and LastSeen bound the occurrences.
	FirstSeen metav1.Time
	LastSeen  metav1.Time
}

CapabilityGapStatus carries one distinct gap and how widely it was hit.

func (*CapabilityGapStatus) DeepCopy

func (in *CapabilityGapStatus) DeepCopy() *CapabilityGapStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new CapabilityGapStatus.

func (*CapabilityGapStatus) DeepCopyInto

func (in *CapabilityGapStatus) DeepCopyInto(out *CapabilityGapStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Conversation

type Conversation struct {
	metav1.TypeMeta
	// Name = context_id, Namespace = project, CreationTimestamp = created_at.
	metav1.ObjectMeta

	Status ConversationStatus
}

Conversation is one durable chat conversation. name == the A2A context id; namespace == the milo project. Read-only in v1 (populated by the chat flow, surfaced here for list/get).

func (*Conversation) DeepCopy

func (in *Conversation) DeepCopy() *Conversation

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Conversation.

func (*Conversation) DeepCopyInto

func (in *Conversation) DeepCopyInto(out *Conversation)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*Conversation) DeepCopyObject

func (in *Conversation) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (*Conversation) Marshal

func (in *Conversation) Marshal() ([]byte, error)

func (*Conversation) Unmarshal

func (in *Conversation) Unmarshal(data []byte) error

type ConversationList

type ConversationList struct {
	metav1.TypeMeta
	metav1.ListMeta
	Items []Conversation
}

func (*ConversationList) DeepCopy

func (in *ConversationList) DeepCopy() *ConversationList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConversationList.

func (*ConversationList) DeepCopyInto

func (in *ConversationList) DeepCopyInto(out *ConversationList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*ConversationList) DeepCopyObject

func (in *ConversationList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (*ConversationList) Marshal

func (in *ConversationList) Marshal() ([]byte, error)

func (*ConversationList) Unmarshal

func (in *ConversationList) Unmarshal(data []byte) error

type ConversationMessage

type ConversationMessage struct {
	Seq       int64
	Role      string
	Content   string
	CreatedAt metav1.Time
}

ConversationMessage is a single stored message in a conversation.

func (*ConversationMessage) DeepCopy

func (in *ConversationMessage) DeepCopy() *ConversationMessage

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConversationMessage.

func (*ConversationMessage) DeepCopyInto

func (in *ConversationMessage) DeepCopyInto(out *ConversationMessage)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ConversationMessages

type ConversationMessages struct {
	metav1.TypeMeta
	// Name/Namespace echo the parent conversation.
	metav1.ObjectMeta

	Items []ConversationMessage
}

ConversationMessages is the object returned by the `conversations/messages` subresource — the full transcript embedded.

func (*ConversationMessages) DeepCopy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConversationMessages.

func (*ConversationMessages) DeepCopyInto

func (in *ConversationMessages) DeepCopyInto(out *ConversationMessages)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*ConversationMessages) DeepCopyObject

func (in *ConversationMessages) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (*ConversationMessages) Marshal

func (in *ConversationMessages) Marshal() ([]byte, error)

func (*ConversationMessages) Unmarshal

func (in *ConversationMessages) Unmarshal(data []byte) error

type ConversationStatus

type ConversationStatus struct {
	// LastActiveAt is the timestamp of the most recent message.
	LastActiveAt metav1.Time
	// MessageCount is the number of stored messages.
	MessageCount int32
	// Title is the conversation's opening user message, collapsed to one
	// line and truncated — what the conversation is about, for listings.
	Title string
	// Name is what the user called this conversation, empty until they name
	// one. Clients show it in place of Title where set.
	Name string
}

ConversationStatus reports rollup information about a conversation.

func (*ConversationStatus) DeepCopy

func (in *ConversationStatus) DeepCopy() *ConversationStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConversationStatus.

func (*ConversationStatus) DeepCopyInto

func (in *ConversationStatus) DeepCopyInto(out *ConversationStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

Directories

Path Synopsis
Package install registers the assistant API group with a runtime scheme.
Package install registers the assistant API group with a runtime scheme.
Package v1alpha1 contains API Schema definitions for the assistant v1alpha1 API group.
Package v1alpha1 contains API Schema definitions for the assistant v1alpha1 API group.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL