Tool design

import assert from "node:assert/strict";
const pedidos=new Map([["p1",{id:"p1",cliente:"u1",versao:3,endereco:"A",despachado:false}]]);
const intencoes=new Map();const notas=new Map();const traces=[];
let efeitos=0;
function falhar(codigo){throw new Error(codigo);}
function pedidoAutorizado(id,ctx){
  const pedido=pedidos.get(id);
  if(!pedido||pedido.cliente!==ctx.usuario) falhar("SEM_PERMISSAO");
  return pedido;
}
function atualizarEndereco(args,ctx){
  const pedido=pedidoAutorizado(args.pedidoId,ctx);
  if(typeof args.endereco!=="string"||!args.endereco.trim()) falhar("SCHEMA_INVALIDO");
  const normalizado=JSON.stringify({pedidoId:args.pedidoId,endereco:args.endereco.trim(),
    pedidoVersao:args.pedidoVersao,propostaVersao:args.propostaVersao});
  const chave=ctx.usuario+":"+args.intencaoId;
  const anterior=intencoes.get(chave);
  if(anterior){
    if(anterior.payload!==normalizado) falhar("PAYLOAD_INCOMPATIVEL");
    return anterior.resultado;
  }
  if(args.confirmadaVersao!==args.propostaVersao) falhar("SEM_CONFIRMACAO");
  if(args.pedidoVersao!==pedido.versao) falhar("CONFLITO");
  if(pedido.despachado) falhar("PEDIDO_DESPACHADO");
  const registro={usuario:ctx.usuario,pedidoId:pedido.id,payload:normalizado};
  intencoes.set(chave,registro);
  const atualizado={...pedido,endereco:args.endereco.trim(),versao:pedido.versao+1};
  pedidos.set(pedido.id,atualizado);efeitos++;
  registro.resultado={status:"atualizado",pedidoId:pedido.id,versao:atualizado.versao,recibo:"crm-"+efeitos};
  traces.push({etapa:"escrita",intencao:args.intencaoId,status:"confirmado"});
  if(args.perderResposta) falhar("RESPOSTA_PERDIDA");
  return registro.resultado;
}
function recuperarIntencao(intencaoId,ctx){
  const registro=intencoes.get(ctx.usuario+":"+intencaoId);
  if(!registro) return {status:"nao_enviado"};
  pedidoAutorizado(registro.pedidoId,ctx);
  traces.push({etapa:"reconciliacao",intencao:intencaoId,status:"consultado"});
  return registro.resultado;
}
// Catálogo de oito ferramentas locais com efeitos explícitos.
const ferramentas={
  buscarCliente:(_,ctx)=>({id:ctx.usuario}),
  consultarPedido:(a,ctx)=>({...pedidoAutorizado(a.pedidoId,ctx)}),
  listarAtendimentos:(_,ctx)=>[{id:"at1",cliente:ctx.usuario,status:"aberto"}],
  consultarElegibilidade:(a,ctx)=>({podeAlterar:!pedidoAutorizado(a.pedidoId,ctx).despachado}),
  prepararEndereco:(a,ctx)=>({pedidoId:pedidoAutorizado(a.pedidoId,ctx).id,
    endereco:a.endereco,propostaVersao:1,pedidoVersao:pedidos.get(a.pedidoId).versao}),
  atualizarEndereco,
  criarNota:(a,ctx)=>{
    if(typeof a.texto!=="string"||!a.texto.trim()) falhar("SCHEMA_INVALIDO");
    const chave=ctx.usuario+":"+a.intencaoId;
    const existente=notas.get(chave);
    if(existente&&existente.texto!==a.texto) falhar("PAYLOAD_INCOMPATIVEL");
    if(existente) return existente;
    const nota={id:"nota-"+(notas.size+1),cliente:ctx.usuario,texto:a.texto};
    notas.set(chave,nota);return nota;
  },
  arquivarAtendimento:(a,ctx)=>{
    if(a.atendimentoId!=="at1"||a.cliente!==ctx.usuario) falhar("SEM_PERMISSAO");
    if(!a.confirmado) falhar("SEM_CONFIRMACAO");
    return {atendimentoId:a.atendimentoId,status:"arquivado"};
  }
};
function chamar(nome,args,ctx){
  if(!Object.hasOwn(ferramentas,nome)) falhar("TOOL_NAO_PERMITIDA");
  return ferramentas[nome](args,ctx);
}
const ctx={usuario:"u1"};
const proposta=chamar("prepararEndereco",{pedidoId:"p1",endereco:"B"},ctx);
assert.equal(pedidos.get("p1").endereco,"A");
const args={...proposta,intencaoId:"i1",confirmadaVersao:1};
const recibo=chamar("atualizarEndereco",args,ctx);
assert.equal(pedidos.get("p1").endereco,"B");
assert.deepEqual(chamar("atualizarEndereco",args,ctx),recibo);assert.equal(efeitos,1);
assert.throws(()=>chamar("atualizarEndereco",{...args,endereco:"C"},ctx),/PAYLOAD_INCOMPATIVEL/);
assert.throws(()=>chamar("atualizarEndereco",{...args,intencaoId:"i2"},ctx),/CONFLITO/);
assert.throws(()=>chamar("atualizarEndereco",args,{usuario:"u2"}),/SEM_PERMISSAO/);
const proposta2=chamar("prepararEndereco",{pedidoId:"p1",endereco:"C"},ctx);
const args2={...proposta2,intencaoId:"i2",confirmadaVersao:1,perderResposta:true};
assert.throws(()=>chamar("atualizarEndereco",args2,ctx),/RESPOSTA_PERDIDA/);
const recuperado=recuperarIntencao("i2",ctx);
assert.equal(recuperado.versao,5);assert.equal(efeitos,2);
assert.deepEqual(chamar("atualizarEndereco",args2,ctx),recuperado);assert.equal(efeitos,2);
assert.throws(()=>chamar("atualizarEndereco",{...args2,intencaoId:"i3",
  pedidoVersao:5,confirmadaVersao:0},ctx),/SEM_CONFIRMACAO/);
const nota=chamar("criarNota",{intencaoId:"n1",texto:"Endereço confirmado"},ctx);
assert.deepEqual(chamar("criarNota",{intencaoId:"n1",texto:"Endereço confirmado"},ctx),nota);
assert.equal(notas.size,1);assert.equal(Object.keys(ferramentas).length,8);
assert.throws(()=>chamar("terminal",{},ctx),/TOOL_NAO_PERMITIDA/);
console.log({status:"aprovado",efeitos,intencoes:intencoes.size,notas:notas.size,traces});