Skip to content

feat(catalog): add Parallel Decisions API tool - #1283

Open
wberri13 wants to merge 19 commits into
superdesigndev:mainfrom
wberri13:codex/parallel-decisions-api
Open

wberri13 wants to merge 19 commits into
superdesigndev:mainfrom
wberri13:codex/parallel-decisions-api

Conversation

@wberri13

@wberri13 wberri13 commented Oct 30, 2026 •

Copy link
Copy Markdown

Summary

  • Add parallel.ai-judge.decide as a direct Parallel Decisions catalog tool for one or many named noul, choice, and score questions over shared state.
  • Preserve Parallel's raw answer metadata, token usage, and shared citations through treg's normal relay. Reuse team-owned Parallel credentials without charging the treg balance.
  • Record Parallel's documented $0.001-per-fast-request price, while gating platform-funded calls until shared-key billing and settlement are live verified.
  • Add a sanitized synthetic fixture, CLI examples, focused relay tests, and a verification ledger.

Verification

  • Parallel API reference, question types, limits, rate limits, and pricing checked on 2026-10-30.
  • Mocked Decisions tests cover single and multiple questions, request/response preservation, 401/422/429/503 responses, and own-key precedence with shared-key gating.
  • uv run --frozen --with pytest-xdist pytest -n auto -q --tb=short: 6,888 passed, 132 skipped.
  • uv run --frozen python scripts/catalog_validate.py parallel: 0 errors.
  • uv run --frozen lint-imports and focused Ruff check: passed.

Activation requirement

The fixture and tests use mocked upstream responses. No live Parallel Decisions call or billing observation was made. Before enabling treg-funded access, verify the platform key can call Decisions, observe account charges and error billing, and confirm the settlement rule. Until then the catalog entry is team-key only.

Context fragments

Upstream now keeps provider-specific catalog details in the catalog row and examples, so this PR leaves docs/context/architecture/catalog.md unchanged after syncing with main. The Decisions recipe and verification ledger remain in examples/parallel-decisions.md.

Closes #1285.

@github-actions github-actions Bot added the area:docs Documentation & design fragments label Oct 30, 2026
@wberri13
wberri13 marked this pull request as ready for review October 30, 2026 04:59

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Documentation & design fragments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Parallel Decisions API to the existing Parallel integration

1 participant