Observe
Request, response, token, cost, latency, identity, and route context.
// OpenAI-compatible integration
Point compatible requests at Punk, keep the configured live provider as your source of truth, and begin seeing cost, latency, repeated patterns, policy decisions, and route explanations.
Compatibility applies to supported model API traffic. Tool execution, application identity, outcomes, and provider-specific features should be verified for your implementation.
// first connection
Generate a key and choose the environment where you want to establish a baseline.
Keep your existing request shape where supported and send a small test workload first.
Verify app context, messages, model, tokens, cost, latency, and route explanations before expanding traffic.
Collect representative evidence before evaluating caches, workflows, substitutions, or any serving change.
// beyond a proxy
Punk uses compatible traffic as input to an adaptive runtime: observed execution becomes governed evidence, candidates can be replayed and shadowed, and only eligible routes can serve with live fallback.
Request, response, token, cost, latency, identity, and route context.
Policy evaluation and conservative handling for declared agent actions.
Evidence-gated caches, plans, declarative workflows, or model routes where justified.
Limitations: exact API coverage varies. Test streaming, structured outputs, tool calls, multimodal inputs, provider-specific options, and error behavior before routing production traffic.
Use a representative, reviewable model task and confirm the trace before increasing scope.