@leg3ndy/otto-bridge 1.0.0 → 1.0.2

package/README.md

@@ -15,7 +15,7 @@ Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap
 
 Para o corte de arquitetura do `0.9.0`, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md).
 
-Para a release atual `1.0.0`, com runtime agentico formal e CLI interativo do bridge, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_0_RELEASE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_0_RELEASE.md).
+Para a release atual `1.0.2`, com runtime agentico formal, hub terminal refinado e console alinhado ao Otto da web, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_2_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_2_PATCH.md).
 
 ## Distribuicao
 
@@ -38,14 +38,14 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-1.0.0.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.2.tgz
 ```
 
-Na linha `1.0.0`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
+Na linha `1.0.2`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
 
-No macOS, a linha `1.0.0` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
+No macOS, a linha `1.0.2` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
 
-No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `1.0.0` oficializa isso como runtime agentico e adiciona uma interface terminal propria do bridge para setup e interacao local com o Otto.
+No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `1.0.0` oficializou isso como runtime agentico; o `1.0.2` consolida o hub terminal como fluxo principal, esconde aliases legados da superfície pública e alinha o console ao comportamento normal do Otto antes de fazer handoff local.
 
 ## Publicacao
 
@@ -76,14 +76,13 @@ otto-bridge help
 otto-bridge --help
 ```
 
-### Abrir o hub interativo
+### Abrir o hub interativo e ligar o runtime
 
 ```bash
 otto-bridge
-otto-bridge home
 ```
 
-Em TTY, o comando sem argumentos agora abre o hub interativo com banner, setup, status, extensoes e o `Otto Console`.
+Em TTY, o comando sem argumentos agora abre o hub interativo com banner, setup, status, extensoes e o `Otto Console`. Se ja existir pairing salvo, o próprio `otto-bridge` sobe o runtime local automaticamente e mostra o estado da conexão no hub.
 
 ### Setup interativo
 
@@ -110,24 +109,24 @@ Opcoes suportadas:
 
 No macOS, o caminho recomendado agora e o executor nativo do Otto Bridge. Se nenhum `--executor` for informado, o `pair` usa `native-macos` por padrao no Mac.
 
-### Rodar o bridge
+### Runtime principal do bridge
 
 ```bash
-otto-bridge run
+otto-bridge
 ```
 
-Se o executor estiver salvo no `config.json`, o `run` usa essa configuracao por padrao.
+Esse agora e o fluxo principal do produto: o hub abre, conecta o runtime local e deixa o Otto pronto para handoff e approvals sem depender de nenhum comando separado de runtime.
 
-Para forcar o executor nativo no macOS sem reparar:
+Se precisar do executor nativo no macOS sem reparar, atualize o pairing/config e reabra o hub:
 
 ```bash
-otto-bridge run --executor native-macos
+otto-bridge setup
 ```
 
-O adapter `clawd-cursor` continua disponivel como override opcional:
+O adapter `clawd-cursor` continua disponivel como override opcional no pairing legado:
 
 ```bash
-otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
+otto-bridge pair --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 ```
 
 ### Falar com o Otto no terminal
@@ -136,11 +135,11 @@ otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 otto-bridge console
 ```
 
-O console sobe o runtime local em background no mesmo processo, envia prompts naturais ao backend usando `device_token`, acompanha `device_job` por polling e resolve `confirm_required` diretamente no terminal.
+O console usa a mesma sessão local já ligada pelo `otto-bridge`, envia prompts naturais ao backend usando `device_token`, respeita quota/plano do usuário e só vira handoff local quando o pedido realmente tiver cara de ação no computador. Quando houver `device_job`, ele acompanha polling e resolve `confirm_required` no terminal.
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.0`:
+Fluxo recomendado na linha `1.0.2`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -150,13 +149,13 @@ otto-bridge extensions --status whatsappweb
 
 O setup agora abre o login do WhatsApp Web no helper/background browser do proprio bridge. Depois do QR code, o Otto usa a sessao local em background, sem depender de aba visivel no Safari.
 
-Contrato da linha `1.0.0`:
+Contrato da linha `1.0.2`:
 
 - `otto-bridge extensions --setup whatsappweb`: autentica a sessao uma vez
-- `otto-bridge run`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime estiver ativo, sem depender de uma aba aberta no Safari
-- ao parar o `otto-bridge run`: o browser em background e desligado, mas a sessao local fica lembrada para o proximo boot
+- `otto-bridge`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime do hub estiver ativo, sem depender de uma aba aberta no Safari
+- ao fechar o `otto-bridge`: o browser em background e desligado, mas a sessao local fica lembrada para o proximo boot
 
-## Handoff rapido da linha 1.0.0
+## Handoff rapido da linha 1.0.2
 
 Ja fechado no codigo:
 
@@ -190,8 +189,8 @@ Ja fechado no codigo:
 - o `instruction_updater` agora e um descriptor explicito do runtime, com `source_entrypoints`, `target_paths` e `recommended_validation_stage_ids` quando o plano toca `AGENTS.md`, `README.md` ou `docs/`
 - `workspace.tests` agora consegue resolver `profile=auto` via `validation_ladder`, executando stages como `typecheck`, `build`, `node_test`, `lint` e `pytest` por stack, com snapshot agregado por etapa
 - o executor `native-macos` agora publica `runtime_hook_trace` somando hooks de lifecycle e tool-use (`session_start`, `pre_tool_use`, `post_tool_use`, `validation_ladder_started/completed`, `session_end`), preparando enforcement, replay fino e metricas futuras
-- o bridge agora possui um CLI interativo proprio com setup inicial, hub terminal e `Otto Console` para prompts locais pelo proprio terminal
-- o backend agora expoe um caminho `device-auth` para o console do bridge submeter prompt e acompanhar approval/job usando apenas `device_token`
+- o bridge agora possui um CLI interativo proprio com setup inicial, hub terminal e `Otto Console` para conversar com o Otto pelo proprio terminal
+- o backend agora expoe caminhos `device-auth` para o console do bridge usar chat com quota/plano (`/v1/devices/cli/chat/completions`) e acompanhar approval/job usando apenas `device_token`
 - o caminho principal do bridge usa `summary`/`narration_context` no lugar de resposta automatica pronta
 - `read_file` agora entrega conteudo completo segmentado em `content_chunks` para o Otto
 - `list_files` sem `limit` agora lista o diretorio inteiro, sem fallback silencioso para 40 itens

package/dist/chat_cli_client.js

@@ -0,0 +1,91 @@
+function normalizeBaseUrl(apiBaseUrl) {
+    return String(apiBaseUrl || "").trim().replace(/\/+$/, "");
+}
+function buildDeviceAuthHeaders(deviceToken, headers) {
+    const next = new Headers(headers || {});
+    if (deviceToken) {
+        next.set("Authorization", `Bearer ${deviceToken}`);
+    }
+    return next;
+}
+function parseApiError(payload, fallbackStatus) {
+    if (payload && typeof payload === "object") {
+        const detail = "detail" in payload ? payload.detail : null;
+        if (typeof detail === "string" && detail.trim()) {
+            return new Error(detail.trim());
+        }
+        if (detail && typeof detail === "object") {
+            const message = "message" in detail ? detail.message : null;
+            if (typeof message === "string" && message.trim()) {
+                return new Error(message.trim());
+            }
+        }
+        const error = "error" in payload ? payload.error : null;
+        if (typeof error === "string" && error.trim()) {
+            return new Error(error.trim());
+        }
+    }
+    return new Error(`HTTP ${fallbackStatus}`);
+}
+export async function streamDeviceCliChat(config, request, onEvent) {
+    const url = `${normalizeBaseUrl(config.apiBaseUrl)}/v1/devices/cli/chat/completions`;
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: buildDeviceAuthHeaders(config.deviceToken, {
+                "Content-Type": "application/json",
+            }),
+            body: JSON.stringify(request),
+        });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Request failed for ${url}: ${detail}`);
+    }
+    if (!response.ok) {
+        const payload = await response.json().catch(() => null);
+        throw parseApiError(payload, response.status);
+    }
+    if (!response.body) {
+        throw new Error("Empty stream response");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    const flushBlock = async (rawBlock) => {
+        const lines = rawBlock
+            .split("\n")
+            .map((line) => line.trimEnd())
+            .filter((line) => line.startsWith("data:"));
+        if (!lines.length) {
+            return;
+        }
+        const payloadText = lines
+            .map((line) => line.slice(5).trimStart())
+            .join("\n")
+            .trim();
+        if (!payloadText) {
+            return;
+        }
+        const payload = JSON.parse(payloadText);
+        await onEvent(payload);
+    };
+    for (;;) {
+        const { done, value } = await reader.read();
+        buffer += decoder.decode(value || new Uint8Array(), { stream: !done });
+        let separatorIndex = buffer.indexOf("\n\n");
+        while (separatorIndex >= 0) {
+            const block = buffer.slice(0, separatorIndex);
+            buffer = buffer.slice(separatorIndex + 2);
+            await flushBlock(block);
+            separatorIndex = buffer.indexOf("\n\n");
+        }
+        if (done) {
+            break;
+        }
+    }
+    if (buffer.trim()) {
+        await flushBlock(buffer);
+    }
+}