Skip to main content
Some TypeScript SDK options are accepted for Python-SDK parity but are not yet acted on; when you pass one, the SDK tells you so it’s never silently dropped.

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 the UNHONOURED_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

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.
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.
Pass it. If you see no notice at startup, it’s honoured. Otherwise check BEHAVIOUR_PARITY.md on main for the current list.
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.

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.