NiadraHooks é um HookProvider do Strands Agents: antes de cada chamada ao modelo ele põe o contexto no prompt de sistema e depois a restaura; tools traz o kit do histórico. Em TypeScript, NiadraPlugin é um plugin do Strands Agents para TypeScript. Serve a quem já está na AWS.
Instalar
@niadra/sdk 0.3.0, pronto no ramo main e no npm quando for publicado; até lá, o pacote do npm é o 0.1.1.
As cinco primitivas
Exemplo mínimo
examples/strands_agent.py.
Em TypeScript
new NiadraPlugin(convo) entra em plugins do Agent: um middleware de entrada do InvokeModelStage registra a mensagem mais nova do cliente uma vez, acrescenta o contexto depois do seu prompt de sistema e dobra o turn_block na última mensagem do usuário (mantendo o ponto de cache antes dele, como o injetor de contexto do próprio Strands faz), sem tocar em agent.messages; um middleware de saída registra a resposta final com o uso do modelo (Bedrock e Anthropic contam os tokens em cache à parte; os outros, dentro); getTools() dá o kit quando a sessão é fixa. O plugin recebe a conversa ou uma função do agente que a encontra a cada chamada.
Memória do agente
NiadraHooks(conversation, agent_memory=True) põe as notas do próprio agente antes do contexto do cliente e acrescenta as duas ferramentas. Veja Memória do agente.
Limites
- O
MemoryStoredo Strands guarda a sessão do próprio agente; a Niadra não é esse armazenamento, então entra por hooks, ao lado de qualquer gerenciador de sessão que você use. - Nada aqui derruba a invocação: sem contexto, o prompt de sistema segue como você o escreveu.
- O Strands para TypeScript exige Node 22 ou mais novo.
- Testado contra
strands-agents1.57 com o modelo substituído por um fake e a Niadra no emulador; em TypeScript, contra@strands-agents/sdk1.19.0, com umAgentreal pelo adaptador de modelo do AI SDK.
Próximos passos
Amazon Bedrock
o
wrap() da API Converse, para quem chama o Bedrock direto.Agentes internos
tarefas, objetos e ações que fecham pendências.

