/** * Parity notices for options accepted from the Python SDK surface. * * The signature parity gate (src/praisonai/praisonai/_dev/parity/signatures) * requires every Python constructor/method parameter to exist on the * TypeScript side. Some of those parameters are accepted and typed before the * behaviour behind them is ported. Such an option must never be silently * ignored: a setting that is accepted and does nothing is a defect that no * test catches. This helper makes the gap audible once per process and * queryable from code. * * Usage inside a constructor: * * if (config.sandbox !== undefined) notYetHonoured('Agent', 'sandbox'); * * Silence with PRAISONAI_PARITY_SILENT=1 (for example in tests), and read * back what was accepted-but-unhonoured with `unhonouredOptions()`. */ /** * Every option this SDK accepts for Python parity but does not yet act on. * * This is the ledger, not a convenience: the name and signature gates both * measure whether a parameter EXISTS, so an option that is accepted and does * nothing passes them both. Nothing counted these until they were counted by * hand and there were 76. Declaring them in one place makes the number * generated rather than remembered -- `praisonai._dev.parity.behaviour` reads * this file, writes BEHAVIOUR_PARITY.md, and fails the build if the total * grows. * * To close one: implement the behaviour, delete its entry here, add a test * that proves the option changes what the code does, and regenerate. * The list is the work queue, and it is meant to shrink to nothing. * * READ THIS BEFORE "CLOSING" ANY OF THE ENTRIES BELOW. * * Verified against praisonaiagents on 2026-09-08: Python does not act on most * of them either, so implementing them here would make TypeScript DIVERGE from * the reference rather than match it. * * - AgentTeam knowledge / guardrails / web / reflection / caching / learn: * Python's AgentTeam constructor logs that it "does not yet apply them at * the team level; pass these to individual Agent(...) instances instead". * See TEAM_OPTION_NOTES in agent/team.ts. * - Task web / reflection / autonomy / planning: Python's Task assigns each * to self, and nothing in agents.py or process.py ever reads them back * (grep for `task.