Parity Notices

Which TypeScript SDK options are accepted for Python parity but not yet acted on

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

   import { Task } from 'praisonai';
   
   const task = new Task({
     name: 'Research',
     description: 'Research a topic',
     memory: true,   // accepted for parity, not yet honoured on Task
   });
   // console: [praisonai] Task: option "memory" is accepted for parity
   // with the Python SDK but is not yet honoured in TypeScript.

   As of PR #4841 every Agent constructor and Agent.chat option is honoured — see the Agent page — and PR #4836 honoured all eight Handoff options. The notice above now fires only for the surfaces still in the queue below.

2. Silence the notices

   Set PRAISONAI_PARITY_SILENT=1 for the process (useful in tests) to mute every parity notice.

   PRAISONAI_PARITY_SILENT=1 node app.js

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 Remaining 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.

AgentTeam.toolsRunOn stays on the list on purpose: team-level placement needs one shared instance across members, and that is not wired.

Plus partial options that work for some inputs and announce themselves for the rest:

Different defaults, same option

The same Agent(output=…) code is silent in Python and verbose in TypeScript because the two SDKs resolve different defaults for an option that both honour.

The option is honoured on both sides, so this is not a “not yet honoured” surface — only the default differs when you leave it unset.

from praisonaiagents import Agent

agent = Agent(instructions="You are helpful")
print(agent.start("Say hi"))
# Silent: no verbose logs, plain text returned, full string at once

import { Agent } from 'praisonai';

const agent = new Agent({ instructions: 'You are helpful' });
await agent.start('Say hi');
// Verbose logs, markdown-formatted, tokens streamed as they arrive

To make TypeScript behave like Python’s silent default, set the three fields explicitly:

import { Agent } from 'praisonai';

const agent = new Agent({
  instructions: 'You are helpful',
  output: { verbose: false, markdown: false, stream: false },
});

Best Practices

Related