WORKER 1.4.0 • REPOSITÓRIO 1.0.1

Automação desktop controlada e rastreável

Serviço local que executa comandos na sessão gráfica do Windows e integra Domínio Web, GraphOn, Playwright, PowerShell e APIs Win32.

Ver comandos Referência OpenAPI

A API é local e deve ser acessada pelo Agent Bridge ou por consumidores autorizados na própria máquina.

ARQUITETURA

Fluxo de execução local

n8n

Solicita a execução.

PES2B Agent

Cria o job.

Agent Bridge

Encaminha por HTTP local.

Desktop Worker

Executa na sessão gráfica.

Domínio / Windows

Sistema-alvo.

SEGURANÇA

Autenticação local

As rotas operacionais exigem a chave configurada em WORKER_API_KEY.

X-WORKER-API-KEY: SUA_CHAVE

Não execute como serviço na Sessão 0. O Worker deve iniciar por tarefa agendada oculta, dentro da sessão interativa do usuário.

API LOCAL

Endpoints

GET/healthPúblico local

GET/api/v1/commandsAPI Key

GET/api/v1/statusAPI Key

POST/api/v1/executeAPI Key

CATÁLOGO

Comandos disponíveis

`ensure-session`

Garante que o módulo solicitado esteja pronto, reutilizando a sessão quando possível.

`heartbeat-session`

Envia interação inofensiva e recupera a sessão se necessário.

`ensure-web-session`

Garante login no Domínio Web e aguarda a Lista de Programas.

`abrir-escrita-fiscal`

Abre o módulo Escrita Fiscal.

`login-escrita-fiscal`

Preenche credenciais internas e valida o módulo.

`diagnosticar-dominio`

Coleta janelas e estado operacional para diagnóstico.

REQUISIÇÃO

Executar comando

curl -X POST 'http://127.0.0.1:3100/api/v1/execute' \
  -H 'Content-Type: application/json' \
  -H 'X-WORKER-API-KEY: SUA_CHAVE' \
  -d '{"requestId":"teste-001","command":"heartbeat-session","input":{"module":"escrita-fiscal","sessionPolicy":"REUTILIZAR"}}'

GOVERNANÇA

Políticas de sessão

Política	Comportamento
`REUTILIZAR`	Usa a sessão existente e evita nova instância.
`NOVA_SESSAO`	Reservada para cenários explicitamente autorizados.

CONTINUIDADE

Heartbeat e recuperação

Estado	Significado
`SESSION_OK`	Sessão encontrada e interação F15 enviada.
`SESSION_RECOVERED`	Sessão refeita automaticamente.
`SESSION_RECOVERY_FAILED`	Não foi possível recuperar.

INTEGRAÇÃO

Agent Bridge

O pacote dominio-desktop-worker é instalado na raiz de automações do PES2B Agent. Ele recebe o job, chama o Worker em 127.0.0.1:3100 e devolve o contrato PES2B_RESULT_JSON.

WINDOWS

Operação

Inicialização por tarefa agendada oculta.
Usuário deve permanecer conectado.
Uma execução por vez; novas requisições durante processamento recebem 409 BUSY.
Health local em http://127.0.0.1:3100/health.

DIAGNÓSTICO

Erros comuns

{
  "success": false,
  "state": "BUSY",
  "error": "Worker ocupado com ensure-session."
}

ARQUIVOS

Downloads

Documentação Markdown OpenAPI JSON Postman