# RightNow decision model docs

> The RightNow decision model makes structured decisions: send a state and named questions, then read probabilities, confidence and typed answers.

API base: `https://api.rightnowai.co/v1`.

## Guides

- Inline input: Text, JSON, Robot state (sent as JSON), Codebases (sent as text), PDF, Images, Voice, Video (preview). Only listed formats are supported.
- TypeScript: `npm install @rightnowai/system-zero@0.4.7`.
- Python: `python -m pip install rightnow-system-zero==0.4.7`.
- SDK 0.4.7 adds typed decision provenance, webhook methods and request compression.
- Tool selection: the RightNow decision model picks which of your tools to call next, or none, with a probability for each. It does not write arguments or messages, and it does not run tools.
- Text, PDF and video allow 9 tools and none, or 10 when a tool is required; image or audio allows 25 tools and none, or 26 when a tool is required.
- Use `toolQuestions` / `tool_questions` and `selectTool` / `select_tool`. See [Tool selection](https://github.com/RightNow-AI/system-zero-sdk/blob/sdk-v0.4.7/TOOL-SELECTION.md).
- Stream inline attachment `type` values: "document" or "image" or "audio" or "video".
- PDF and video (preview) use the same limits as HTTP. Read [Attachments](https://www.rightnowai.co/docs/decision-model/attachments).
- The stream does not take upload references.
- Held upload references return 400 media_unsupported at attachments[i].upload. Send files inline.
- An admission store timeout returns 503 service_unavailable. Wait for Retry-After and Retry-After-Ms before retrying.
- Attachment names match `^[A-Za-z][A-Za-z0-9_-]{0,63}$`; a dotted name returns 400.
- The 64k and 128k bands are served through Danger zone with SZ-Danger-Zone: long_context_64k or long_context_128k.
- Video (preview): H.264 MP4 is served inline, with or without an opt-in header.
- Video costs USD 0.0008 per started second, with a USD 0.008 minimum per clip; clips up to 10 seconds.
- Each answered question costs USD 0.0001.
- Residual text tokens are charged separately.
- Send one silent H.264 MP4 video inline.
- Format: H.264 MP4.
- Duration: Up to 10 seconds.
- Dimensions: Up to 1920 x 1080.
- File size: Up to 2.5 MiB.
- Attachments: One video only.
- Send video without other files. Soundtracks and rotated videos are not supported.
- Use Manual HTTP with the rightnow-decision alias for video.
- image: image/png, image/jpeg. Static PNG, including interlaced PNG, and JPEG. Send files inline.
- image: USD 0.003 per image. Minimum per file: USD 0.003. Maximum measure: 16,777,216 source pixels.
- Audio: one WAV file with PCM or float samples at exactly 16,000 Hz per request. All attachments share the 2.5 MiB decoded limit. Channels and sample encoding affect how much audio fits. Audio is limited to 60 seconds per request.
- audio: audio/wav. Send inline RIFF WAV with integer PCM or IEEE float samples at exactly 16,000 Hz. Mono and multichannel files are accepted; pricing counts sample frames, not channels. Other audio formats, other sample rates, unknown audio MIME types and audio upload references are unavailable. Refused audio is not processed or charged and creates no billing receipt. Send files inline.
- audio: USD 0.0002 per started second (about USD 0.012 per minute). Minimum per file: 30 seconds. Maximum measure: 60 seconds, 1 pass.
- Documents: Send PDF files inline. Answers use readable text; pictures may be omitted. For a scan with no readable text, send extracted text in state. A scan whose text can't be read may not be answered reliably. Other native document formats are unavailable; send their extracted text in state.
- Text, office and archive documents return 415 document_unsupported.
- Up to 500 pages per PDF; 2,621,440 decoded bytes per request.
- Send PDF files inline. Document upload references are not available to outside callers today (400 media_unsupported at attachments[i].upload).
- Answers use the PDF text and include a note when pictures were left out.
- PDF is supported. Export this document to PDF and send the PDF file.
- document: USD 0.002 per page. Minimum per file: USD 0.001. Maximum measure: 500 pdf pages.

- [Overview](https://www.rightnowai.co/docs/decision-model): The RightNow decision model makes structured decisions: send a state and named questions, then read probabilities, confidence and typed answers.
- [Quickstart](https://www.rightnowai.co/docs/decision-model/quickstart): Install an SDK, send a request and read the answer.
- [Authentication](https://www.rightnowai.co/docs/decision-model/authentication): Authenticate RightNow decision model calls from your server with a workspace API key, keep it in the calling process, and replace a lost or revoked key.
- [Decisions](https://www.rightnowai.co/docs/decision-model/decisions): Build a RightNow decision model request from state and named boolean, choice or score questions, then read the returned answers, probabilities and refusals.
- [Sessions](https://www.rightnowai.co/docs/decision-model/session-affinity): Use session_id for routing affinity and read the refusal returned by unsupported session routes.
- [Idempotency](https://www.rightnowai.co/docs/decision-model/idempotency): Keep the same RightNow decision model Idempotency-Key and JSON body when retrying a decision, and handle conflicts, changed requests and unavailable replays.
- [Workspaces and keys](https://www.rightnowai.co/docs/decision-model/workspaces): Use a RightNow workspace to manage API keys, usage and the Playground, and understand how member roles control access to workspace settings.
- [API reference](https://www.rightnowai.co/docs/decision-model/decide): Send state and named questions; read answers, headers, errors and the event stream reply.
- [Decision records](https://www.rightnowai.co/docs/decision-model/decision-records): Look up a stored decision from the RightNow decision model, or its trace, with the API key that created it, and read availability, retention and errors.
- [Errors](https://www.rightnowai.co/docs/decision-model/errors): Read refusal codes and retry flags. Keep the request ID for support.
- [Rate limits](https://www.rightnowai.co/docs/decision-model/rate-limits): Read the RightNow decision model rate-limit headers and refusal codes, pace work to the returned limits, and understand that workspace limits still apply.
- [Versions](https://www.rightnowai.co/docs/decision-model/versions): Choose the RightNow decision model alias or a pinned version, discover the currently attested model IDs, and understand model retirement.
- [Models](https://www.rightnowai.co/docs/decision-model/models): Read serving limits, available inputs and version details.
- [Inputs](https://www.rightnowai.co/docs/decision-model/attachments): Read RightNow decision model inline input formats, prices and availability before preparing a request. Send files inline within the request body limits.
- [Coding agent setup](https://www.rightnowai.co/docs/decision-model/agent-setup): Give your coding agent the integration skill and a key from the server environment.
- [Playground](https://www.rightnowai.co/docs/decision-model/playground): Try the RightNow decision model in the workspace Playground, read structured results, and use its server-held identity without pasting an API key.
- [Provenance](https://www.rightnowai.co/docs/decision-model/provenance): Read execution metadata a RightNow decision model reply can include, with request IDs, replay state, calibration versions and attachment classes.
- [Leaked API keys](https://www.rightnowai.co/docs/decision-model/leaked-api-keys): Revoke an exposed RightNow decision model API key, create a replacement, update the apps that use it, and keep keys out of browser code, commits and logs.
- [Text caching](https://www.rightnowai.co/docs/decision-model/caching): Understand RightNow decision model cached text input, its price and text cache hit rate for a selected period or API key, with usage fields and data limits.
- [Request policy](https://www.rightnowai.co/docs/decision-model/request-policy): Use a RightNow decision model request policy to withhold decisions below a confidence threshold and refuse work above your request cost cap.
- [Streaming](https://www.rightnowai.co/docs/decision-model/streaming): Connect from a server to send state changes and receive structured decisions over WebSocket.
- [Webhooks](https://www.rightnowai.co/docs/decision-model/webhooks): Register HTTPS endpoints for signed RightNow decision model event metadata, verify each delivery, and handle retries, secret rotation and deletion.
- [Danger zone](https://www.rightnowai.co/docs/decision-model/danger-zone): Danger zone: the 64k and 128k context classes, with their bands, prices and refusals.
- [Billing and credits](https://www.rightnowai.co/docs/decision-model/billing-and-credits): Read the RightNow decision model billing terms for your workspace, check the API reference before adding balance reads, and follow workspace usage limits.
- [Pricing](https://www.rightnowai.co/docs/decision-model/pricing): See RightNow decision model prices and billing units for supported inputs and answered questions.
- [Questions](https://www.rightnowai.co/docs/decision-model/questions): Find answers about question types, supported inputs, retries, access, billing and data.
- [Support](https://www.rightnowai.co/docs/decision-model/support): Contact RightNow about a RightNow decision model API issue with the request ID, HTTP status and error code so support can investigate the call you identify.
- [Release notes](https://www.rightnowai.co/docs/decision-model/release-notes): RightNow decision model release notes cover text decisions, Playground and launch billing, with links to the guides for access and usage limits.

## Markdown

- [Overview](https://www.rightnowai.co/docs/decision-model/index.md): The same guide in Markdown.
- [Quickstart](https://www.rightnowai.co/docs/decision-model/quickstart.md): The same guide in Markdown.
- [Authentication](https://www.rightnowai.co/docs/decision-model/authentication.md): The same guide in Markdown.
- [Decisions](https://www.rightnowai.co/docs/decision-model/decisions.md): The same guide in Markdown.
- [Sessions](https://www.rightnowai.co/docs/decision-model/session-affinity.md): The same guide in Markdown.
- [Idempotency](https://www.rightnowai.co/docs/decision-model/idempotency.md): The same guide in Markdown.
- [Workspaces and keys](https://www.rightnowai.co/docs/decision-model/workspaces.md): The same guide in Markdown.
- [API reference](https://www.rightnowai.co/docs/decision-model/decide.md): The same guide in Markdown.
- [Decision records](https://www.rightnowai.co/docs/decision-model/decision-records.md): The same guide in Markdown.
- [Errors](https://www.rightnowai.co/docs/decision-model/errors.md): The same guide in Markdown.
- [Rate limits](https://www.rightnowai.co/docs/decision-model/rate-limits.md): The same guide in Markdown.
- [Versions](https://www.rightnowai.co/docs/decision-model/versions.md): The same guide in Markdown.
- [Models](https://www.rightnowai.co/docs/decision-model/models.md): The same guide in Markdown.
- [Inputs](https://www.rightnowai.co/docs/decision-model/attachments.md): The same guide in Markdown.
- [Coding agent setup](https://www.rightnowai.co/docs/decision-model/agent-setup.md): The same guide in Markdown.
- [Playground](https://www.rightnowai.co/docs/decision-model/playground.md): The same guide in Markdown.
- [Provenance](https://www.rightnowai.co/docs/decision-model/provenance.md): The same guide in Markdown.
- [Leaked API keys](https://www.rightnowai.co/docs/decision-model/leaked-api-keys.md): The same guide in Markdown.
- [Text caching](https://www.rightnowai.co/docs/decision-model/caching.md): The same guide in Markdown.
- [Request policy](https://www.rightnowai.co/docs/decision-model/request-policy.md): The same guide in Markdown.
- [Streaming](https://www.rightnowai.co/docs/decision-model/streaming.md): The same guide in Markdown.
- [Webhooks](https://www.rightnowai.co/docs/decision-model/webhooks.md): The same guide in Markdown.
- [Danger zone](https://www.rightnowai.co/docs/decision-model/danger-zone.md): The same guide in Markdown.
- [Billing and credits](https://www.rightnowai.co/docs/decision-model/billing-and-credits.md): The same guide in Markdown.
- [Pricing](https://www.rightnowai.co/docs/decision-model/pricing.md): The same guide in Markdown.
- [Questions](https://www.rightnowai.co/docs/decision-model/questions.md): The same guide in Markdown.
- [Support](https://www.rightnowai.co/docs/decision-model/support.md): The same guide in Markdown.
- [Release notes](https://www.rightnowai.co/docs/decision-model/release-notes.md): The same guide in Markdown.

## Agent files

- [Coding agent skill](https://www.rightnowai.co/docs/decision-model/SKILL.md): The skill linked by Coding agent setup.
- [All guides](https://www.rightnowai.co/llms-full.txt): The same guides in reading order.