Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

marginfuse

package module

Go to main page

Versions in this module

v0

v0.3.0

Sep 4, 2026

v0.2.0

Sep 3, 2026

Changes in this version

+ const ContractVersion

+ const Version

type Client

+ func (c *Client) Identify(ctx context.Context, p IdentifyParams) (Identity, error)

type DecideParams

+ Plan string

+ type IdentifyParams struct

+ ClearPlan bool

+ CustomerID string

+ Email string

+ Metadata map[string]string

+ Name string

+ PeriodStart time.Time

+ Plan string

+ type Identity struct

+ CustomerID string

+ PeriodEnd string

+ PeriodStart string

+ Plan string

type TrackParams

+ Plan string

v0.1.0

Sep 1, 2026

Changes in this version

+ type Acknowledgment string

+ const AckBlockedBeforeProviderCall

+ const AckFailedToApply

+ const AckPresentedTopup

+ const AckProceededAsRequested

+ const AckUsedDowngradeModel

+ type Action string

+ const ActionAllow

+ const ActionBlock

+ const ActionDowngrade

+ const ActionTopupRequired

+ type Client struct

+ func New(cfg Config) (*Client, error)

+ func (c *Client) Acknowledge(decisionID string, ack Acknowledgment)

+ func (c *Client) Close()

+ func (c *Client) Decide(ctx context.Context, p DecideParams) Decision

+ func (c *Client) Flush(ctx context.Context)

+ func (c *Client) Guard(ctx context.Context, p DecideParams, ...) (GuardOutcome, error)

+ func (c *Client) Track(p TrackParams)

+ func (c *Client) TrackAndWait(ctx context.Context, p TrackParams)

+ type Config struct

+ APIKey string

+ BaseURL string

+ HTTPClient *http.Client

+ OnError func(err error, context string)

+ Timeout time.Duration

+ type DecideParams struct

+ CustomerID string

+ ExpectedUsage Usage

+ Feature string

+ Model string

+ Provider string

+ type Decision struct

+ Action Action

+ Degraded bool

+ DegradedReason string

+ ID string

+ Model string

+ Provider string

+ TopupContext string

+ type GuardKind string

+ const GuardBlocked

+ const GuardCompleted

+ const GuardTopupRequired

+ type GuardOutcome struct

+ Decision Decision

+ Kind GuardKind

+ type OpenRouterPromptDetails struct

+ AudioTokens float64

+ CacheWriteTokens float64

+ CachedTokens float64

+ type OpenRouterUsage struct

+ CompletionTokens float64

+ Cost *float64

+ PromptTokens float64

+ PromptTokensDetails *OpenRouterPromptDetails

+ type Outcome string

+ const OutcomeAppCancelled

+ const OutcomeProviderError

+ const OutcomeSuccess

+ const OutcomeTimeout

+ type ProviderCall struct

+ CostUSD string

+ Outcome Outcome

+ Usage Usage

+ type TrackParams struct

+ CorrectsEventID string

+ CostUSD string

+ CustomerID string

+ DecisionID string

+ EventID string

+ Feature string

+ Model string

+ OccurredAt time.Time

+ Outcome Outcome

+ Provider string

+ RequestedModel string

+ RetryOfEventID string

+ Usage Usage

+ type Usage struct

+ AudioSeconds float64

+ CacheCreationTokens int

+ CachedInputTokens int

+ Images int

+ InputTokens int

+ OutputTokens int

+ func FromOpenRouter(u *OpenRouterUsage) (Usage, string)