model

type BeginInput struct {
	TenantID        string
	TaskID          uuid.UUID
	RunID           uuid.UUID
	AttemptID       uuid.UUID
	FencingToken    int64
	AgentVersionRef string
	// ModelRef is the canonical provider/model reference.
	ModelRef       string
	IdempotencyKey string
	// EstimatedInputTokens and MaxOutputTokens define the worst-case call
	// envelope reserved before the provider request is sent. A zero output
	// limit asks the gateway to select a budget-aware bounded default.
	EstimatedInputTokens int64
	MaxOutputTokens      int64
}

type BeginResult struct {
	Call                     store.ModelCall
	Descriptor               store.ModelDescriptor
	EffectiveMaxOutputTokens int64
	PolicyRevision           string
	DenyReasons              []string
}

type FinishInput struct {
	TenantID          string
	ModelCallID       uuid.UUID
	ExpectedVersion   int64
	Status            store.ModelCallStatus
	InputTokens       int64
	OutputTokens      int64
	ProviderRequestID string
	FinishReason      string
	UsageCertainty    store.ModelUsageCertainty
	// ProviderName and WireModel are the physical deployment identity the
	// logical modelRef actually resolved to (P2-10). They are recorded in the
	// audit receipt so a call is reproducible against the exact provider route
	// that served it, distinct from the tenant-visible logical reference.
	// ProviderName is a name only — endpoints/credentials never enter a receipt.
	ProviderName string
	WireModel    string
}

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

type InvokeInput struct {
	TenantID        string
	TaskID          uuid.UUID
	RunID           uuid.UUID
	AttemptID       uuid.UUID
	FencingToken    int64
	AgentVersionRef string
	ModelRef        string
	IdempotencyKey  string

	Messages        []provider.Message
	Temperature     *float64
	MaxOutputTokens int32
	Stream          bool
	// Tools are the platform-described tool contracts the model may call.
	// Callers resolve them from the AgentVersion's capability grants; the
	// invoker never invents or widens them.
	Tools []provider.ToolDefinition
}

type InvokeOutput struct {
	Call      store.ModelCall
	Content   string
	ToolCalls []provider.ToolCall
}

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

type ModelStore interface {
	GetModelDescriptor(context.Context, string, string, string) (store.ModelDescriptor, error)
	CreateModelCall(context.Context, store.CreateModelCallInput) (store.CreateModelCallResult, error)
	GetModelCall(context.Context, string, uuid.UUID) (store.ModelCall, error)
	FinishModelCall(context.Context, store.FinishModelCallInput) (store.ModelCall, error)
}

type PolicyChecker interface {
	EvaluateModel(context.Context, string, policy.ModelContext) policy.Decision
}

type ReceiptStore interface {
	WriteRuntimeReceipt(context.Context, store.WriteRuntimeReceiptInput) error
}

type Usage struct {
	InputTokens  int64
	OutputTokens int64
}