backendplugin

type AccessScope = lipsdk.BackendAccessScope

type AccountingAuthority string

type AccountingEvidence struct {
	InputTokens      *int64
	OutputTokens     *int64
	CacheReadTokens  *int64
	CacheWriteTokens *int64
	ReasoningTokens  *int64
	TotalTokens      *int64
	Presence         UsagePresence
	Source           AccountingSource
	Authority        AccountingAuthority
	Plane            AccountingPlane
	DedupeKey        string
}

type AccountingEvidenceSource interface {
	DrainAccountingEvidence() []AccountingEvidence
}

type AccountingEvidenceV2 struct {
	Observation    metering.Observation
	Coverage       EvidenceCoverage
	CoverageReason string
}

type AccountingEvidenceV2Source interface {
	DrainAccountingEvidenceV2() []AccountingEvidenceV2
}

type AccountingPlane string

type AccountingSource string

type BillingFinalizer interface {
	// FinalizeBilling finalizes billing for an attempt lineage idempotently.
	FinalizeBilling(ctx context.Context, req FinalizeBillingRequest) (FinalizeBillingResponse, error)
}

type CancelMode = lipapi.CancelMode

type CancelOutcome struct {
	Acknowledged bool
	Detail       string
	Reason       CancelReason
	Mode         CancelMode
}

type CancelReason string

type CanonicalEvent struct {
	Kind             EventKind
	MessageIndex     *int32
	Delta            *string
	Signature        *string
	Opaque           []byte
	ToolCallID       *string
	ToolName         *string
	Usage            *UsageEvidence
	Warning          *string
	Error            *PluginError
	ImageRef         *string
	FileRef          *string
	ReasoningDialect *string
	ReasoningOpaque  []byte

	// ReasoningSummary, ReasoningContent, and ReasoningEncryptedContent preserve
	// exact OpenAI Responses reasoning-item fields with absent/null/value presence.
	// Additive v1.3 fields gated by FeatureExactOpenResponsesFields.
	ReasoningSummary          RawJSON
	ReasoningContent          RawJSON
	ReasoningEncryptedContent RawJSON
}

type CapabilitySummary struct {
	Streaming          bool
	Tools              bool
	Vision             bool
	Documents          bool
	StructuredOutputs  bool
	Reasoning          bool
	ReasoningReplay    bool
	ParallelToolCalls  bool
	OrderedItems       bool
	ItemReferences     bool
	Compaction         bool
	AssistantPhase     bool
	OpaqueExtensions   bool
	VideoInput         bool
	Annotations        bool
	AssistantMediaRefs bool
}

type ClientFrame struct {
	Kind                 ClientFrameKind
	Sequence             uint64
	InstanceID           string
	Invocation           *Invocation
	CancelReason         CancelReason
	CancelDeadlineUnixMS int64
}

type ClientFrameKind string

type ConfigureRequest struct {
	InstanceID       string
	FactoryKind      string
	ConfigYAML       []byte
	Secrets          SecretBundle
	RuntimePolicy    RuntimePolicy
	Negotiation      Negotiation
	NegotiationToken string
}

type ConfiguredInstance interface {
	// Resolve returns static or model-aware capability profiles.
	Resolve(ctx context.Context, modelID *string) (ResolvedProfile, error)
	// ListModels returns a bounded inventory snapshot when advertised.
	ListModels(ctx context.Context, maxModels uint32) (ListModelsResponse, error)
	// Execute runs one bidirectional attempt stream.
	Execute(stream ExecuteStream) error
	// Close releases instance resources.
	Close(ctx context.Context) error
}

type CountTokensRequest struct {
	InstanceID string
	ModelID    string
	Invocation Invocation
}

type CountTokensResponse struct {
	InputTokens     *int64
	Presence        UsagePresence
	EvidenceQuality string
}

type CredentialMode = lipsdk.BackendCredentialMode

type DialectRequirementDTO struct {
	Kind        string
	Dialect     string
	Implementor string
}

type DialectSupport struct {
	ItemDialects       []DialectRequirementDTO
	ReasoningDialects  []DialectRequirementDTO
	CompactionDialects []DialectRequirementDTO
	ExtensionTypes     []ExtensionRequirementDTO
}

type EconomicEvidenceSource interface {
	DrainEconomicEvidence() []AccountingEvidenceV2
}

type EconomicEvidenceV2 = AccountingEvidenceV2

type EconomicObservation = metering.Observation

type ErrorCode string

type EventKind = lipapi.EventKind

type EvidenceCoverage string

type ExecuteStream interface {
	// Context is the stream lifetime context.
	Context() context.Context
	// Recv returns the next host-to-plugin frame or a terminal read error.
	Recv() (ClientFrame, error)
	// Send sends one plugin-to-host frame.
	Send(frame ServerFrame) error
}

type ExtensionRequirementDTO struct {
	Namespace   string
	Type        string
	Implementor string
}

type FactoryDescriptor struct {
	Kind                      string
	DisplayName               string
	Description               string
	CredentialMode            CredentialMode
	AccessScope               AccessScope
	RoutePrefixes             []string
	SupportsCountTokens       bool
	SupportsFinalizeBilling   bool
	SupportsDynamicInventory  bool
	SupportsModelAwareProfile bool
	ProcessSharing            ProcessSharing
	Experimental              bool
	Deprecated                bool
	StaticCapabilities        CapabilitySummary
	TransportCapabilities     TransportCapabilitySummary
	// SupportsAccountingEvidenceV2 is an explicit descriptor capability. The
	// negotiated feature remains the transport authority for each session.
	SupportsAccountingEvidenceV2 bool
}

type Feature struct {
	// Name is the feature identifier.
	Name string
	// Required means the peer must understand the feature or negotiation fails.
	Required bool
}

type FinalizeBillingRequest struct {
	InstanceID     string
	ALegID         string
	BLegID         string
	ModelID        string
	Reason         string
	IdempotencyKey string
}

type FinalizeBillingResponse struct {
	Usage           UsageEvidence
	EvidenceQuality string
	// AccountingV2 retains every provider observation returned by the finalizer.
	// It is host-only and may include multiple charge events for one attempt.
	AccountingV2 []AccountingEvidenceV2
}

type GRPCServer struct {
	backendpluginv1.UnimplementedBackendPluginServer

	PluginOffer ProtocolOffer
	Service     Service
	// contains filtered or unexported fields
}

type GenerationOptions struct {
	MaxOutputTokens    *uint32
	TemperatureMillis  *int32
	ReasoningEffort    *string
	ParallelToolCalls  *bool
	ResponseMIMEType   *string
	ResponseSchemaJSON RawJSON
}

type GracefulShutdownRequest struct {
	DrainTimeoutMS int64
}

type GracefulShutdownResponse struct {
	Accepted bool
}

type HealthResponse struct {
	Serving bool
	Detail  string
}

type Invocation struct {
	RequestID        string
	AttemptID        string
	ALegID           string
	BLegID           string
	CanonicalModelID string
	NativeModelID    string
	Instructions     []Message
	Messages         []Message
	Tools            []ToolDef
	ToolChoice       *string
	Options          GenerationOptions
	SafeMetadata     map[string]string
	// ProxyOwnedSessionID is injected by the proxy host from lipapi.Call.Session.
	// It is not client metadata and must not be populated from SafeMetadata.
	ProxyOwnedSessionID string

	// PromptCacheKey is a source-compatible legacy alias. SemanticExtensions is
	// the sole authority for new carrier-aware paths; bridges reject conflicting
	// values rather than choosing between two representations.
	PromptCacheKey     string
	SemanticExtensions []SemanticExtension

	// Ordered-item ABI fields (protocol minor >= ProtocolMinorOrderedItems).
	Operation            string
	DeliveryMode         string
	TransportMode        string
	ItemAuthority        bool
	Items                []InvocationItem
	ProtocolRequirements ProtocolRequirements
}

type InvocationCompactionItem struct {
	EncapsulatedID string
	Dialect        string
	Implementor    string
	Opaque         RawJSON
	// EncryptedContent is the exact provider compaction blob (pinned profile
	// encrypted_content). Additive v1.3 field gated by FeatureExactOpenResponsesFields.
	EncryptedContent string
}

type InvocationContentPart struct {
	Kind           PartKind
	Text           *string
	ImageRef       *string
	ImageMIME      *string
	FileRef        *string
	FileMIME       *string
	FileName       *string
	VideoRef       *string
	VideoMIME      *string
	Reasoning      *InvocationReasoningPart
	Refusal        *string
	Summary        *string
	AnnotationType *string
	AnnotationData RawJSON
	AssistantRef   *string

	// FileData carries an inline base64 file payload (pinned profile file_data).
	// Additive v1.3 field gated by FeatureExactOpenResponsesFields.
	FileData *string

	// ExtensionType and ExtensionData preserve an opaque vendor-prefixed custom
	// content part (ContentPartExtension) losslessly. ExtensionType is the
	// prefixed wire discriminator; ExtensionData is the full raw part object.
	// Additive v1.3 fields gated by FeatureExactOpenResponsesFields.
	ExtensionType *string
	ExtensionData RawJSON
	// ExtensionNamespace and ExtensionImplementor preserve canonical extension
	// identity metadata independently of the derived Type namespace.
	ExtensionNamespace   *string
	ExtensionImplementor *string
}

type InvocationExtensionItem struct {
	Namespace   string
	Type        string
	Implementor string
	Direction   string
	Opaque      RawJSON
}

type InvocationItem struct {
	Kind          string
	ID            string
	Status        string
	Role          Role
	Phase         string
	Content       []InvocationContentPart
	ToolCall      *InvocationToolCall
	ToolResult    *InvocationToolResult
	ItemReference *InvocationItemReference
	Reasoning     *InvocationReasoningItem
	Compaction    *InvocationCompactionItem
	Extension     *InvocationExtensionItem
}

type InvocationItemReference struct {
	ID string
}

type InvocationReasoningItem struct {
	Dialect   *string
	Text      *string
	Signature *string
	Opaque    RawJSON

	// Summary, Content, and EncryptedContent preserve exact OpenAI Responses
	// reasoning-item fields with absent/null/value presence (RawJSON states).
	// Additive v1.3 fields gated by FeatureExactOpenResponsesFields.
	Summary          RawJSON
	Content          RawJSON
	EncryptedContent RawJSON
}

type InvocationReasoningPart struct {
	Dialect   *string
	Text      *string
	Signature *string
	Opaque    RawJSON

	// Summary, Content, and EncryptedContent preserve exact OpenAI Responses
	// reasoning-item fields with absent/null/value presence (RawJSON states).
	// Additive v1.3 fields gated by FeatureExactOpenResponsesFields.
	Summary          RawJSON
	Content          RawJSON
	EncryptedContent RawJSON
}

type InvocationToolCall struct {
	CallID    string
	Name      string
	Arguments RawJSON
}

type InvocationToolResult struct {
	CallID          string
	Name            string
	Output          *string
	StructuredParts []InvocationContentPart
}

type ListModelsResponse struct {
	Models             []ModelDescriptor
	InventorySource    string
	FetchedUnixMS      int64
	RefreshAfterUnixMS *int64
	ErrorCode          string
}

type Message struct {
	Role  Role
	Parts []Part
}

type ModeError struct {
	Code string
}

type ModelDescriptor struct {
	CanonicalModelID string
	NativeModelID    string
	DisplayName      string
	RoutePrefix      string
	FactoryKind      string
	Capabilities     CapabilitySummary
}

type Negotiation struct {
	// Compatible is true when majors match and required features are mutual.
	Compatible bool
	// NegotiatedMinor is min(host.Minor, plugin.Minor).
	NegotiatedMinor uint32
	// EnabledFeatures is the sorted intersection of host-requested features present on the plugin.
	EnabledFeatures []string
	// RejectReason explains incompatibility when Compatible is false.
	RejectReason string
	// TransportPolicy is the accepted transport policy.
	TransportPolicy TransportPolicy
	// PluginMajor is the plugin-advertised major carried on NegotiateResponse.
	PluginMajor uint32
	// PluginMinor is the plugin-advertised minor carried on NegotiateResponse.
	PluginMinor uint32
	// PluginFeatures is the plugin-advertised feature set carried on NegotiateResponse.
	PluginFeatures []Feature
	// NegotiationToken binds a compatible outcome to a later ConfigureRequest (wire field).
	NegotiationToken string
}

type OpenManagedStream func(ctx context.Context, inv Invocation, call lipapi.Call) (lipapi.ManagedEventStream, error)

type OptionalExecuteStreamCloser interface {
	Close() error
}

type OptionalNegotiatedStream interface {
	Negotiation() Negotiation
}

type Part struct {
	Kind             PartKind
	Text             *string
	ImageRef         *string
	FileRef          *string
	ReasoningText    *string
	ReasoningDialect *string
	ReasoningOpaque  RawJSON
	ToolArgsJSON     RawJSON
	ToolCallID       *string
	ToolName         *string

	// ReasoningSummary, ReasoningContent, and ReasoningEncryptedContent preserve
	// exact OpenAI Responses reasoning-item fields with absent/null/value presence.
	// Additive v1.3 fields gated by FeatureExactOpenResponsesFields.
	ReasoningSummary          RawJSON
	ReasoningContent          RawJSON
	ReasoningEncryptedContent RawJSON
}

type PartKind string

type PluginDescriptor struct {
	ProtocolMajor uint32
	ProtocolMinor uint32
	PluginID      string
	Version       string
	BuildID       string
	Features      []Feature
	Factories     []FactoryDescriptor
}

type PluginError struct {
	Code            ErrorCode
	Message         string
	Retryable       bool
	OutputCommitted bool
}

type ProcessSharing string

type PromptCacheController interface {
	RenewPromptCache(context.Context, promptcache.RenewRequest) (promptcache.RenewResponse, error)
	ReleasePromptCache(context.Context, promptcache.ReleaseRequest) error
}

type PromptCacheObservationSource interface{ promptcache.ObservationSource }

type ProtocolOffer struct {
	// Major is the protocol major version.
	Major uint32
	// Minor is the protocol minor version.
	Minor uint32
	// Features is the advertised feature set.
	Features []Feature
	// DisableTransportRetries must be true on both sides.
	DisableTransportRetries bool
}

type ProtocolRequirements struct {
	Capabilities       []string
	ItemDialects       []DialectRequirementDTO
	ReasoningDialects  []DialectRequirementDTO
	CompactionDialects []DialectRequirementDTO
	ExtensionTypes     []ExtensionRequirementDTO
}

type RawJSON struct {
	// contains filtered or unexported fields
}

type RawJSONState int

type ResolvedProfile struct {
	Capabilities             CapabilitySummary
	TransportCapabilities    TransportCapabilitySummary
	DialectSupport           DialectSupport
	ReasoningReplaySupported bool
	RoutePrefixes            []string
	EnforceMaxOutput         bool
	MaxOutputTokens          *uint32
	SupportsCountTokens      bool
	SupportsFinalizeBilling  bool
	SupportsDynamicInventory bool
	EvidenceSource           string
	ProfileVersion           string
	PromptCacheProfile       promptcache.Profile
	// SupportsAccountingEvidenceV2 is the resolved instance capability bit.
	SupportsAccountingEvidenceV2 bool
}

type Role = lipapi.Role

type RuntimePolicy struct {
	MaxRequestBytes         uint64
	MaxStreamFrameBytes     uint64
	MaxPendingEvents        uint64
	RequestTimeoutMS        int64
	CancelDeadlineMS        int64
	DiagnosticsVerbosity    string
	MaxConcurrentExecutions uint32
	LocalOnly               bool
	AllowedEnvNames         []string
	DisableTransportRetries bool
}

type SecretBundle struct {
	Values map[string][]byte
}

type SemanticExtension struct {
	Namespace   string
	Type        string
	Implementor string
	Direction   string
	Presence    SemanticExtensionPresence
	Data        RawJSON
}

type SemanticExtensionPresence string

type ServerFrame struct {
	Kind          ServerFrameKind
	Sequence      uint64
	Event         *CanonicalEvent
	Diagnostic    string
	CancelOutcome *CancelOutcome
	Terminal      *Terminal
	Accounting    *AccountingEvidence
	// AccountingV2 is the additive typed V2 sideband. It is never a canonical
	// client event and is legal only after explicit feature negotiation.
	AccountingV2           *AccountingEvidenceV2
	PromptCacheObservation *promptcache.Observation
}

type ServerFrameKind string

type Service interface {
	// Describe returns plugin identity and factory exports.
	Describe(ctx context.Context) (PluginDescriptor, error)
	// Configure creates a configured instance after negotiation and peer authentication.
	Configure(ctx context.Context, req ConfigureRequest) (ConfiguredInstance, error)
}

type StreamValidator struct {
	// contains filtered or unexported fields
}

type Terminal struct {
	Status TerminalStatus
	Error  *PluginError
}

type TerminalStatus string

type TokenCounter interface {
	// CountTokens estimates tokens for an invocation.
	CountTokens(ctx context.Context, req CountTokensRequest) (CountTokensResponse, error)
}

type ToolDef struct {
	Name           string
	Description    string
	ParametersJSON RawJSON
}

type TransportCapabilitySummary struct {
	Keepalive           bool
	Cancellation        bool
	BidirectionalStream bool
}

type TransportPolicy struct {
	// DisableAutomaticRetries must be true; transport retries are prohibited.
	DisableAutomaticRetries bool
	// MaxMessageBytes is the whole-message ceiling.
	MaxMessageBytes uint64
	// MaxStreamFrameBytes is the per-frame ceiling and must be <= MaxMessageBytes.
	MaxStreamFrameBytes uint64
}

type UsageEvidence struct {
	InputTokens      *int64
	OutputTokens     *int64
	CacheReadTokens  *int64
	CacheWriteTokens *int64
	ReasoningTokens  *int64
	TotalTokens      *int64
	Presence         UsagePresence
	RawUsageJSON     RawJSON
}

type UsageEvidenceBuffer struct {
	// contains filtered or unexported fields
}

type UsagePresence = lipapi.UsagePresence

type V1EvidenceIdentity struct {
	StoreID        string
	ObservationID  string
	SourceEventKey string
	Revision       uint64
	StreamID       string
	Sequence       uint64
	Subject        metering.SubjectRef
	Correlation    metering.CorrelationV2
	Scope          scope.PrincipalScopeView
	ObservedAt     time.Time
	ReceivedAt     time.Time
	MappingRef     string
}