attribution

Documentation

Overview

Package attribution carries free-text caller attribution (who a request acts on behalf of) across panda's hops: CLI -> server -> proxy. Values are untrusted and audit-only — they must never influence authorization.

Index

• Constants
• func FromContext(ctx context.Context) string
• func WithValue(ctx context.Context, value string) context.Context

Constants

const EnvVar = "PANDA_ON_BEHALF_OF"

EnvVar is the environment variable callers (e.g. chat agents acting for a human user) set per invocation to attribute their requests.

const Header = "X-Panda-On-Behalf-Of"

Header is the HTTP header that carries attribution between panda components.

Functions

func FromContext

func FromContext(ctx context.Context) string

FromContext returns the attribution value carried by the context, or an empty string when none is set.

func WithValue

func WithValue(ctx context.Context, value string) context.Context

WithValue returns a context carrying the attribution value. Empty or whitespace-only values leave the context unchanged.