sijur-cli 2.0.0 → 2.1.0

package/README.md

@@ -126,6 +126,32 @@ sijur tarefas_encerrar --tarefa_id 123456 --relatorio "Protocolado RExt" \
   --fechar_ns_entidade_pai --momento_processual 46 --dry_run
 ```
 
+## Para um agente
+
+Agente nao abre navegador nem marca caixa de consentimento, entao ele nao usa `sijur login`.
+Ele leva uma chave `sk_sijur_` do escritorio numa variavel:
+
+```bash
+export SIJUR_API_KEY=sk_sijur_...
+sijur tools
+sijur prazos_listar --json
+```
+
+A chave ja responde as duas perguntas que o consentimento responderia, e ambas se escolhem no
+cadastro dela, dentro do SIJUR:
+
+- **quais ferramentas o agente enxerga** — os escopos da chave; `sijur tools` lista exatamente isso;
+- **em nome de quem ele escreve** — o titular da chave ("expedida em nome de"). Sem titular, o
+  trabalho sai no user-bot generico do escritorio.
+
+Com a variavel definida ela **vence o cofre** e nada e gravado na maquina. E por isso que dois
+agentes convivem no mesmo computador: cada um carrega a sua chave no proprio ambiente, sem disputar
+o Keychain. `sijur login` recusa enquanto a variavel existir, para ninguem achar que trocou de
+identidade sem ter trocado; `sijur whoami` mostra qual chave esta respondendo e o que ela alcanca.
+
+O contexto que a CLI gasta no agente e o do catalogo sob demanda: `sijur tools` devolve uma linha
+por ferramenta, e so a escolhida tem o schema lido, com `sijur tools <nome> --json`.
+
 ## Auditoria
 
 Toda chamada apenda uma linha em `~/.sijur-cli/audit.jsonl`: timestamp, ferramenta, argumentos e
@@ -136,3 +162,4 @@ se deu certo.
 | variavel | padrao |
 |---|---|
 | `SIJUR_MCP_URL` | `https://sijur.com.br/mcp` |
+| `SIJUR_API_KEY` | (vazio) — definida, autentica com esta chave `sk_sijur_` e ignora o cofre |

package/bin/sijur.js

@@ -23,6 +23,13 @@ GLOBAIS
   --json          imprime numa linha so (o padrao e identado)
   -h, --help      esta ajuda
 
+AGENTE
+  Um agente nao passa por tela de consentimento: em vez de "sijur login", exporte
+  SIJUR_API_KEY com uma chave sk_sijur_ do escritorio. Ela ja carrega quais
+  ferramentas o agente ve e em nome de quem ele escreve, os dois escolhidos no
+  cadastro da chave. Definida a variavel, ela vence o cofre e nada e gravado na
+  maquina — entao dois agentes convivem no mesmo computador, cada um com a sua.
+
 CODIGOS DE SAIDA
   0 ok   1 erro de uso   2 autenticacao/escopo   4 erro da ferramenta ou da rede
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sijur-cli",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Espelho de linha de comando das ferramentas MCP do SIJUR — um comando por ferramenta, sem regra propria",
   "bin": {

package/src/cmds/sessao.js

@@ -1,9 +1,9 @@
 import { fazerLogin, revogar } from '../auth.js';
 import * as cofre from '../keychain.js';
 import { SERVIDOR, escoposSuportados } from '../config.js';
-import { listarTools, fechar } from '../mcp.js';
+import { listarTools, fechar, usandoChaveDoAmbiente, prefixoDaChave } from '../mcp.js';
 
-import { EXIT, erroAuth } from '../exit.js';
+import { EXIT, erroAuth, erroUso } from '../exit.js';
 
 
 function emitir(obj, op) {
@@ -11,6 +11,12 @@ function emitir(obj, op) {
 }
 
 export async function cmdLogin(op) {
+  // WHY barrar em vez de avisar: com SIJUR_API_KEY definida a chave vence em toda chamada, entao o
+  // login gravaria no cofre e nao mudaria nada — e quem rodou ficaria achando que trocou de identidade.
+  if (usandoChaveDoAmbiente) {
+    throw erroUso('SIJUR_API_KEY esta definida: a CLI ja esta autenticando com essa chave, e o login ' +
+      'nao mudaria nada. Tire a variavel do ambiente para autenticar como pessoa.');
+  }
   const r = await fazerLogin({ trocar: op.trocar });
   const blob = cofre.ler();
   const avisos = [];
@@ -36,11 +42,46 @@ export async function cmdLogout(op) {
   let revogado = { revogado: false, motivo: 'nao_pedido' };
   if (op.revogar) revogado = await revogar();
   cofre.apagar();
-  emitir({ ok: true, credenciais_apagadas: true, revogado_no_servidor: revogado.revogado, detalhe: revogado }, op);
+  emitir({
+    ok: true,
+    credenciais_apagadas: true,
+    revogado_no_servidor: revogado.revogado,
+    detalhe: revogado,
+    avisos: usandoChaveDoAmbiente
+      ? ['SIJUR_API_KEY continua definida: apaguei o cofre, mas as proximas chamadas seguem ' +
+         'autenticando com essa chave. Para parar de vez, tire a variavel do ambiente.']
+      : []
+  }, op);
   return EXIT.OK;
 }
 
 export async function cmdWhoami(op) {
+  // Com chave do ambiente nao ha blob local: escopo e titular vivem no cadastro da chave, no
+  // servidor. O que a CLI pode mostrar aqui e o efeito — as ferramentas que a chave enxerga.
+  if (usandoChaveDoAmbiente) {
+    let tools = null;
+    let vivo = false;
+    try {
+      tools = await listarTools();
+      vivo = true;
+    } catch (err) {
+      tools = `nao consegui listar: ${err.message}`;
+    } finally {
+      await fechar();
+    }
+    emitir({
+      ok: vivo,
+      servidor: SERVIDOR,
+      credencial: 'chave da variavel SIJUR_API_KEY',
+      prefixo: prefixoDaChave,
+      guardado_em: 'variavel de ambiente (nada gravado nesta maquina)',
+      sessao_viva: vivo,
+      total_ferramentas: Array.isArray(tools) ? tools.length : null,
+      tools_visiveis: tools
+    }, op);
+    return vivo ? EXIT.OK : EXIT.AUTH;
+  }
+
   const blob = cofre.ler();
   if (!blob?.tokens?.access_token) throw erroAuth('Sem credencial nesta maquina. Rode `sijur login`.');
 

package/src/mcp.js

@@ -12,11 +12,21 @@ import { erroAuth, erroApi } from './exit.js';
 // servidor, entao o canal so tinha custo. Sem ele, some a classe inteira de timeout.
 // O SDK continua sendo a fonte do OAuth (`auth`), que e onde ele e solido.
 
+// WHY chave no ambiente: agente nao passa por tela de consentimento. A chave `sk_sijur_` ja carrega
+// o recorte de ferramentas (scopes) e o titular (mcp_api_keys.userid), ambos escolhidos no cadastro
+// da chave — entao ELA e a credencial do agente, e o cofre fica para a pessoa no terminal. Efeito
+// colateral desejado: sem cofre, dois agentes na mesma maquina nao disputam slot de keychain
+// nenhum; cada um leva a sua chave no proprio ambiente.
+const CHAVE_AMBIENTE = process.env.SIJUR_API_KEY || null;
+export const usandoChaveDoAmbiente = !!CHAVE_AMBIENTE;
+export const prefixoDaChave = CHAVE_AMBIENTE ? CHAVE_AMBIENTE.slice(0, 20) : null;
+
 const PROTOCOLO = '2025-06-18';
 let _sessao = null;
 let _proximoId = 1;
 
 function tokenGuardado() {
+  if (CHAVE_AMBIENTE) return CHAVE_AMBIENTE;
   return cofre.ler()?.tokens?.access_token || null;
 }
 
@@ -63,9 +73,18 @@ async function postar(corpo, { token, sessao }) {
 // Uma tentativa; devolve { resposta, token } ja com renovacao feita se tomou 401.
 async function postarComRenovacao(corpo, sessao) {
   let token = tokenGuardado();
-  if (!token) throw erroAuth('Sem credencial nesta maquina. Rode `sijur login`.');
+  if (!token) {
+    throw erroAuth('Sem credencial nesta maquina. Rode `sijur login`, ou exporte ' +
+      'SIJUR_API_KEY com uma chave sk_sijur_ se quem chama e um agente.');
+  }
   let r = await postar(corpo, { token, sessao });
   if (r.status === 401) {
+    // WHY nao renovar com chave do ambiente: `sk_sijur_` nao tem refresh. Cair no fluxo OAuth aqui
+    // trocaria "a chave foi recusada" por um erro sobre login, que nao e o que aconteceu.
+    if (CHAVE_AMBIENTE) {
+      throw erroAuth('A chave em SIJUR_API_KEY foi recusada (401). Confira se ela existe, ' +
+        'nao expirou e nao foi revogada.');
+    }
     token = await renovarToken();
     r = await postar(corpo, { token, sessao });
     if (r.status === 401) throw erroAuth('Token recusado pelo servidor. Rode `sijur login`.');
@@ -104,7 +123,11 @@ const RE_SCOPE = /Scope insuficiente\.?\s*Requer:\s*([^\s"'}]+)/i;
 
 function checarEscopo(texto) {
   const m = RE_SCOPE.exec(texto || '');
-  if (m) throw erroAuth(`Escopo faltando: ${m[1]}. Rode \`sijur login\` para reautorizar com esse escopo.`);
+  if (!m) return;
+  // Com chave do ambiente o escopo se conserta no cadastro da chave, nao com `sijur login`.
+  throw erroAuth(CHAVE_AMBIENTE
+    ? `Escopo faltando: ${m[1]}. A chave em SIJUR_API_KEY nao tem esse escopo — inclua-o no cadastro dela.`
+    : `Escopo faltando: ${m[1]}. Rode \`sijur login\` para reautorizar com esse escopo.`);
 }
 
 export const chamarBruto = (nome, argumentos) => _chamar(nome, argumentos, true);