Quick Start
1
See the notice fire
2
Silence the notices
Set
PRAISONAI_PARITY_SILENT=1 for the process (useful in tests) to mute every parity notice.How It Works
Each surface consults theUNHONOURED_OPTIONS ledger when it is constructed, and warns once per (surface, option) pair if you pass a listed option with a non-default value.
The Five Surfaces
These options are accepted for Python-SDK parity but not yet acted on. Pass any with a non-default value and the SDK emits a notice.
Plus 10 partial options that work for some inputs and announce themselves for the rest:
Counts current as of PR #4789 (2026-09-03). The list is a downward ratchet, so it will shrink over time. The live list is
BEHAVIOUR_PARITY.md; the ledger is parity-notice.ts.Best Practices
An option in this list didn't do anything — why?
An option in this list didn't do anything — why?
It’s accepted for API compatibility with the Python SDK, but the TypeScript behaviour behind it hasn’t been implemented yet. Watch the console for a
[praisonai] … not yet honoured notice at startup.How do I silence the notices?
How do I silence the notices?
Set the environment variable
PRAISONAI_PARITY_SILENT=1 (or PRAISONAI_PARITY_SILENT=true) for the process. This is what test suites use to keep output clean.How do I know if a specific option works?
How do I know if a specific option works?
Pass it. If you see no notice at startup, it’s honoured. Otherwise check
BEHAVIOUR_PARITY.md on main for the current list.How can I help close a row?
How can I help close a row?
Implement the behaviour, delete the option’s entry from the ledger, add a test that proves the option changes what the code does, and regenerate. See
_dev/parity/README.md in the SDK repo.Related
Agent
TypeScript Agent class —
Agent.__init__ and Agent.chat options.Agent Team
Multi-agent teams —
AgentTeam.__init__ options.Handoffs
Agent handoffs —
Handoff options.Tasks
Task definitions —
Task.__init__ options.
