# Needlepath

> Select which context records enter a model call, verbatim.

## Docs

- [API reference](https://docs.nextmoca.com/api-reference/introduction.md): Three endpoints, one credential, and the two client rules that keep an integration working across additive changes.
- [Liveness, and the label this build serves by default](https://docs.nextmoca.com/api-reference/registry/liveness-and-the-label-this-build-serves-by-default.md): Liveness plus the deployment's own identity. No engine work is done.
- [The public registry of immutable operating-point labels](https://docs.nextmoca.com/api-reference/registry/the-public-registry-of-immutable-operating-point-labels.md): Every label this deployment can resolve, and the frozen `policy_version` behind each. Only the label and its version cross the wire — the configuration a label resolves to (excerpt tiers, gate mode, floors) is not disclosed. That is the documented limit of the reproducibility promise: published resu…
- [Select the records worth sending to a model](https://docs.nextmoca.com/api-reference/selection/select-the-records-worth-sending-to-a-model.md): Send every record you are considering plus the task they must serve. Needlepath returns the subset it selected — together with a rendered block, per-record scores and reasons, and the token arithmetic.
- [Authentication](https://docs.nextmoca.com/authentication.md): Bearer keys: format, scope, rotation, revocation — and the two things never to put in a request.
- [How billing works](https://docs.nextmoca.com/billing/how-billing-works.md): One meter, one number, echoed on every response — what is counted, what is not, and what is never charged.
- [How to recompute your own bill](https://docs.nextmoca.com/billing/recompute-your-bill.md): You hold the payload, we publish the function, the receipt names the version. Here is the arithmetic, in full, with runnable code.
- [Adaptive budget](https://docs.nextmoca.com/concepts/adaptive-budget.md): Let the engine escalate its own budget along a ladder you define, instead of guessing a single number per request.
- [Operating points and models](https://docs.nextmoca.com/concepts/operating-points.md): An opaque, immutable label naming a frozen configuration — what it guarantees, what it deliberately does not, and why Needlepath never calls a model.
- [Records and tasks](https://docs.nextmoca.com/concepts/records-and-tasks.md): What to put in each field, what each one buys you, and the three mistakes that quietly cost you selection quality.
- [Shadow mode](https://docs.nextmoca.com/concepts/shadow-mode.md): Watch what Needlepath would have selected on your real traffic, without changing a single prompt.
- [Errors](https://docs.nextmoca.com/errors.md): Every status this API returns, what causes it, whether to retry — and the two cases that are not errors at all.
- [Needlepath](https://docs.nextmoca.com/index.md): Select which context records enter a model call — selecting your own text rather than rewriting it, and stepping aside when trimming would not pay.
- [Integrations](https://docs.nextmoca.com/integrations.md): Where Needlepath plugs into an agent framework, what to write yourself today, and the rules every adapter follows.
- [Limits](https://docs.nextmoca.com/limits.md): Three limits per plan, one exact ceiling — and an honest statement of how approximate each of them is.
- [Quickstart](https://docs.nextmoca.com/quickstart.md): One authenticated call to /v1/context/select, in cURL, Python and TypeScript.
- [Retention and trust](https://docs.nextmoca.com/retention-and-trust.md): What we keep, for how long, what enforces it — and the one field you control that does reach our logs.
- [Versioning](https://docs.nextmoca.com/versioning.md): Major-only URL versions, what counts as breaking, and the commitment that a version keeps serving until it is formally deprecated.

## OpenAPI Specs

- [openapi](https://docs.nextmoca.com/api-reference/openapi.yaml)