dsh-agy-link 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -96,6 +96,8 @@ Resolution order (highest first): `DSH_AGY_*` environment variable → runtime o
96
96
  | `translateMaxTokens` | `—` | `4096` | Output token cap |
97
97
  | `translateTimeoutMs` | `—` | `120000` | Per-translation timeout |
98
98
  | `translateRetries` | `—` | `2` | Retries on retryable failures (account stall, empty answer) |
99
+
100
+ `translateModel` and `translateEffort` are also editable in **DSH Settings → Antigravity**, on the auto-translate row (two dropdowns next to the on/off control). Leaving them on their default option hands the choice back to the fallback chain above.
99
101
  | `translateSkipSameModel` | `—` | `true` | Skip translation when the reply already came from the translate model |
100
102
  | `translateBindConversation` | `—` | `true` | One agy conversation per DSH session, persona sent once |
101
103
  | `translateMinIntervalMs` | `—` | `3000` | Minimum spacing between automatic translations |
package/docs/README.en.md CHANGED
@@ -1,83 +1,77 @@
1
1
  # dsh-agy-link — English
2
2
 
3
- Bring Google Antigravity into DeepSeek Harness (DSH). The plugin drives the official, unmodified `agy` CLI and adds multi-account pooling, official multi-bucket quota tracking, native streaming and tool cards, and `/tsl` plain-language rewriting.
4
-
5
- <p align="center">
6
- <img src="./assets/console.png" alt="Antigravity console: account pool, official quota bars and proxy state" width="760">
7
- </p>
8
-
9
- <p align="center">
10
- <img src="./assets/model-picker.png" alt="Antigravity models in the DSH model picker" width="300">
11
- &nbsp;&nbsp;
12
- <img src="./assets/settings.png" alt="Antigravity settings embedded in the DSH plugin page" width="520">
13
- </p>
14
-
15
- ## Overview
16
-
17
- Each turn spawns the official `agy` process, parses its NDJSON event stream and maps it to native DSH text, thinking, tool cards and token accounting. Account rotation, quota inspection and retries happen inside the plugin; DSH only sees a normal model call.
18
-
19
- - Multiple Google accounts drain in order, so a conversation survives a quota wall.
20
- - Quotas come from the official endpoint: 5-hour window, weekly window and the paid Argon pool are reported separately.
21
- - Thinking, terminal commands and file edits render as native DSH cards.
22
- - `/tsl` rewrites any reply in plain language when a model writes too formally.
3
+ Integrate Google Antigravity models into DeepSeek Harness (DSH) through the official, unmodified `agy` CLI. The plugin provides streaming, thinking, tool activity, token metering, in-GUI OAuth login, official multi-bucket quota tracking, and `/tsl` plain-language translation.
23
4
 
24
5
  ## Requirements
25
6
 
26
7
  | Requirement | Verification |
27
8
  | --- | --- |
28
9
  | DSH | `dsh --version` |
29
- | Node.js ≥ 24 | `node --version` |
10
+ | Node.js >= 24 | `node --version` |
30
11
  | Google Antigravity CLI | `agy --version` |
31
- | Google connectivity | proxy / VPN / TUN where required |
12
+ | Google connectivity | proxy/VPN/TUN where required |
32
13
 
33
- Where Google is not directly reachable, enable system proxy or TUN mode. If the terminal does not inherit the proxy, export it before starting DSH:
14
+ Where Google is not directly reachable, enable system proxy/TUN mode. If the terminal does not inherit proxy settings, export them before starting DSH:
34
15
 
35
16
  ```bash
36
17
  export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
37
18
  ```
38
19
 
39
- Replace the port with your local proxy port. A dedicated proxy can also be configured per account in the console.
20
+ Replace the port with the correct local proxy port. An HTTP(S) or SOCKS proxy can also be configured per account in the DSH Antigravity panel.
40
21
 
41
22
  ## Install and quick start
42
23
 
43
24
  ```bash
25
+ # Install into the web profile
44
26
  dsh plugin --profile web add dsh-agy-link
27
+
28
+ # Start DSH Web
45
29
  dsh web
46
30
  ```
47
31
 
48
- In DSH, click the `AGY (n)` badge and choose "Add account" to complete Google login in the browser; no authorization code needs copying. Alternatively run `/agy auth` for the primary account. Then pick an Antigravity model in `/model` and start chatting. `/agy status` reports the current state.
32
+ In DSH, click the `AGY (n)` badge and choose **Add Account** to complete Google login in the browser. Alternatively run `/agy auth` to start primary-account login. Then choose an Antigravity model from `/model` and start chatting. Use `/agy status` to check status.
49
33
 
50
- ## Core features
34
+ ## Features
51
35
 
52
- - **Account pool**: isolated HOME and OAuth credentials per account; sequential drain on 429 or exhaustion; quota-expiry-first rotation; family-scoped cooldowns; manual switch; per-account proxy; parallel credential leases.
53
- - **Official quotas**: 5-hour rolling, 7-day weekly and the Argon weekly pool, each with reset countdowns and per-model detail.
54
- - **Console and settings**: the `AGY (n)` header badge and Settings → Plugins → Antigravity open the same console. Inside: the account card (proxy, enable, warmup, delete), a runtime note (permission fixed to `skip`), pool scheduling (sequential drain / round robin), 7-day auto-warmup, auto translate, default thinking effort and model visibility toggles. The picker lists models under `Antigravity (agy CLI)`: Gemini 3.8 Flash, Claude Sonnet 4.6 (Thinking), Claude Opus 4.6 (Thinking), GPT-OSS 120B (Medium).
55
- - **Native integration**: `antigravity` provider in `/model` with the Gemini, Claude, GPT-OSS and Argon families; streaming text, thinking and tool activity; Terminal and diff cards, with MCP meta-tools unwrapped; mermaid diagrams; `--conversation` session continuity; goal and plan forwarding; full token metering with 1M context; multimodal images; `agy_ask` delegation.
56
- - **Effort learning**: a model that rejects `--effort` is replayed once without the flag and remembered in `~/.dsh/agy-link/effort-unsupported.json`, so a mismatch never fails a turn.
57
- - **`/tsl` translation**: command, opt-in auto mode and a per-reply action; results persist as a card under the reply, keep the original behind a toggle and never enter model-visible history; uses the same account pool with failover.
36
+ - Account pool with isolated HOME environments and credentials.
37
+ - Sequential failover on HTTP 429 or quota exhaustion.
38
+ - Official five-hour, seven-day, and Argon weekly quota monitoring with reset countdowns.
39
+ - Text, thinking, and tool-activity streaming into native DSH UI cards.
40
+ - DSH sessions bound to native `agy` conversations through `--conversation`.
41
+ - Gemini, Claude, and GPT-OSS models available through the `antigravity` provider.
42
+ - Mobile web responsiveness: transitions to full-height drawer (`100dvh`) under 680px with equal-width buttons.
43
+ - Plain-language translation (`/tsl`): Gemini-branded card pinned below reply, 1:1 bound translation conversation.
44
+ - Effort learning: learns when a model rejects `--effort` and re-runs smoothly without failure.
45
+ - Multimodal images staged locally and authorized to `agy` through `--add-dir`.
46
+ - `agy_ask` for delegating a one-off task to an Antigravity model.
58
47
 
59
- ## `/agy` commands
48
+ ## Configuration
60
49
 
61
- `status`, `pool` / `accounts`, `auth` / `auth-code`, `add-account` / `remove-account`, `enable-account` / `disable-account`, `refresh-quota` / `clear-cooldown`, `models`, `mode`, `effort`, `dispatch` / `dispatch-retries` / `parallel` / `max-concurrent`, `workspace`, `goal`, `session`, `clear`, `doctor`.
50
+ | Key | Environment variable | Default | Description |
51
+ | --- | --- | --- | --- |
52
+ | `enabled` | `DSH_AGY_ENABLED` | `true` | Plugin master switch |
53
+ | `agyBin` | `DSH_AGY_BIN` | auto-detected | Path to the `agy` executable |
54
+ | `permissionMode` | `DSH_AGY_MODE` | `skip` | `skip`, `plan`, or `accept-edits` (fixed to `skip` in settings panel; config/env still override) |
55
+ | `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | agy default | Default model slug |
56
+ | `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | `low`, `medium`, `high`, or `auto`; initial effort level in model picker |
57
+ | `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Activity watchdog timeout in ms |
58
+ | `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Idle budget (minutes) while an agy tool step is still open; `0` = keep `timeoutMs` |
59
+ | `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | session cwd | Workspace root |
60
+ | `suppressAgyAutoUpdate` | `DSH_AGY_SUPPRESS_AUTOUPDATE` | `true` on Windows | Refreshes update check timestamp before spawn to block console flash |
61
+ | `autoWarmup` | `DSH_AGY_AUTO_WARMUP` | `false` | Opt-in 7-day weekly quota warmup probe |
62
+ | `autoTranslate` | `DSH_AGY_AUTO_TRANSLATE` | `false` | Automatically translate completed turns using Gemini |
63
+ | `translateModel` | `DSH_AGY_TRANSLATE_MODEL` | `gemini-3.8-flash` | Model used for `/tsl` plain translation |
62
64
 
63
- ## `/tsl` usage
65
+ > For complete configuration options, see [docs/CONFIGURATION.md](./CONFIGURATION.md).
64
66
 
65
- ```
66
- /tsl # translate the last completed turn
67
- /tsl 3 # translate turn 3
68
- /tsl --full # include intermediate narration
69
- /tsl --text 任意文本… # translate arbitrary text (no card)
70
- /tsl --model claude-sonnet-5-5 --effort medium
71
- /tsl auto on|off|status # per-session auto mode
72
- ```
73
-
74
- ## Configuration
67
+ ## Commands
75
68
 
76
- Common keys: `enabled`, `agyBin`, `permissionMode` (default `skip`), `defaultModel`, `defaultEffort` (default `high`), `hiddenModels`, `timeoutMs`, `workspaceRoot`, `proxyUrl`, `suppressAgyAutoUpdate`, `autoWarmup`, `autoTranslate`, `translateModel`, `translateEffort`. The complete key list, environment variables and defaults are in [CONFIGURATION.md](./CONFIGURATION.md).
69
+ `/agy`: `status`, `pool`, `auth`, `models`, `mode`, `effort`, `workspace`, `goal`, `session`, `enable-account`, `disable-account`, `clear`, `doctor`, and `help`.
70
+ `/tsl`: translate last turn or arbitrary text with optional `--full`, `--text`, `--model`, or `auto on|off`.
77
71
 
78
72
  ## Security and terms
79
73
 
80
- The plugin invokes only the official, unmodified `agy` binary installed locally. Use it in accordance with Google Antigravity's Terms of Service.
74
+ The plugin invokes only the official, unmodified `agy` binary installed locally. Use it in accordance with Google Antigravity Terms of Service. Preserve commands, variables, model IDs, and paths literally when adapting this documentation.
81
75
 
82
76
  ## License
83
77
 
package/docs/README.es.md CHANGED
@@ -1,83 +1,77 @@
1
1
  # dsh-agy-link — Español
2
2
 
3
- Integra Google Antigravity en DeepSeek Harness (DSH). El plugin controla el CLI oficial y sin modificar `agy` y añade pool de cuentas, seguimiento oficial de cuotas por bucket, streaming nativo con tarjetas de herramientas y reescritura en lenguaje llano con `/tsl`.
4
-
5
- <p align="center">
6
- <img src="./assets/console.png" alt="Consola de Antigravity: pool de cuentas, barras de cuota oficiales y estado del proxy" width="760">
7
- </p>
8
-
9
- <p align="center">
10
- <img src="./assets/model-picker.png" alt="Modelos de Antigravity en el selector de modelos de DSH" width="300">
11
- &nbsp;&nbsp;
12
- <img src="./assets/settings.png" alt="Ajustes de Antigravity integrados en la página de plugins de DSH" width="520">
13
- </p>
14
-
15
- ## Descripción general
16
-
17
- Cada turno lanza el proceso oficial `agy`, analiza su flujo de eventos NDJSON y lo traduce a texto, razonamiento, tarjetas de herramientas y medición de tokens nativos de DSH. La rotación de cuentas, la consulta de cuotas y los reintentos ocurren dentro del plugin; DSH solo ve una llamada normal al modelo.
18
-
19
- - Varias cuentas de Google se consumen en orden, así una conversación sobrevive al agotamiento de una cuota.
20
- - Las cuotas provienen del endpoint oficial: ventana de 5 horas, ventana semanal y el pool Argon de pago se muestran por separado.
21
- - El razonamiento, los comandos de terminal y las ediciones de archivos se renderizan como tarjetas nativas de DSH.
22
- - `/tsl` reescribe cualquier respuesta en lenguaje llano cuando un modelo escribe demasiado formal.
3
+ Integra modelos de Google Antigravity en DeepSeek Harness (DSH) mediante el CLI oficial y sin modificar `agy`. El plugin ofrece streaming, thinking, actividad de herramientas, uso de tokens, login OAuth desde la interfaz, monitor oficial de cuotas y traducción a lenguaje natural con `/tsl`.
23
4
 
24
5
  ## Requisitos
25
6
 
26
7
  | Requisito | Verificación |
27
8
  | --- | --- |
28
9
  | DSH | `dsh --version` |
29
- | Node.js ≥ 24 | `node --version` |
10
+ | Node.js >= 24 | `node --version` |
30
11
  | Google Antigravity CLI | `agy --version` |
31
- | Conectividad con Google | proxy / VPN / TUN cuando sea necesario |
12
+ | Conectividad con Google | proxy/VPN/TUN cuando sea necesario |
32
13
 
33
- Donde Google no sea accesible directamente, active el proxy del sistema o el modo TUN. Si la terminal no hereda el proxy, expórtelo antes de iniciar DSH:
14
+ En regiones donde Google no sea accesible directamente, habilite TUN/proxy del sistema. Si la terminal no hereda el proxy, expórtelo antes de iniciar DSH:
34
15
 
35
16
  ```bash
36
17
  export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
37
18
  ```
38
19
 
39
- Sustituya el puerto por el de su proxy local. También puede configurar un proxy dedicado por cuenta desde la consola.
20
+ Sustituya el puerto por el de su proxy local. También puede configurar un proxy HTTP(S) o SOCKS por cuenta desde el panel Antigravity de DSH.
40
21
 
41
22
  ## Instalación e inicio rápido
42
23
 
43
24
  ```bash
25
+ # Instale el plugin en el profile web
44
26
  dsh plugin --profile web add dsh-agy-link
27
+
28
+ # Inicie DSH Web
45
29
  dsh web
46
30
  ```
47
31
 
48
- En DSH, haga clic en la insignia `AGY (n)` y elija "Add account" para completar el login de Google en el navegador; no hay que copiar ningún código de autorización. También puede ejecutar `/agy auth` para la cuenta principal. Después seleccione un modelo de Antigravity en `/model` y empiece a conversar. `/agy status` informa del estado actual.
32
+ En DSH, haga clic en la insignia `AGY (n)` y seleccione **Add Account** para completar el login Google en el navegador. También puede ejecutar `/agy auth` para iniciar el login de la cuenta principal. Después seleccione un modelo Antigravity en `/model` y empiece a conversar. Use `/agy status` para comprobar el estado.
49
33
 
50
- ## Funciones principales
34
+ ## Funciones
51
35
 
52
- - **Pool de cuentas**: HOME y credenciales OAuth aislados por cuenta; failover secuencial ante 429 o agotamiento; rotación que prioriza la cuota que caduca antes; enfriamiento por familia de modelos; cambio manual; proxy por cuenta; concesiones de credenciales en paralelo.
53
- - **Cuotas oficiales**: 5 horas móviles, 7 días semanales y el pool semanal Argon, con cuenta atrás de reinicio y detalle por modelo.
54
- - **Consola y ajustes**: la insignia `AGY (n)` de la cabecera y Ajustes → Plugins → Antigravity abren la misma consola. Dentro: tarjeta de cuenta (proxy, activar, precalentar, eliminar), nota de ejecución (permiso fijo en `skip`), planificación del pool (agotamiento secuencial / round robin), precalentamiento semanal de 7 días, traducción automática, esfuerzo de razonamiento por defecto y visibilidad de modelos. El selector lista los modelos bajo `Antigravity (agy CLI)`: Gemini 3.8 Flash, Claude Sonnet 4.6 (Thinking), Claude Opus 4.6 (Thinking), GPT-OSS 120B (Medium).
55
- - **Integración nativa**: proveedor `antigravity` en `/model` con las familias Gemini, Claude, GPT-OSS y Argon; streaming de texto, razonamiento y actividad de herramientas; tarjetas de terminal y diff, con las meta-herramientas MCP desenvueltas; diagramas mermaid; continuidad de sesión con `--conversation`; reenvío de goal y plan; medición completa de tokens con contexto de 1M; imágenes multimodales; delegación con `agy_ask`.
56
- - **Aprendizaje de effort**: un modelo que rechaza `--effort` se reintenta una vez sin la opción y se recuerda en `~/.dsh/agy-link/effort-unsupported.json`; una incompatibilidad nunca hace fallar un turno.
57
- - **Traducción `/tsl`**: comando, modo automático opcional y una acción por respuesta; el resultado se guarda como tarjeta bajo la respuesta, conserva el original y nunca entra en el historial visible para el modelo; usa el mismo pool con failover.
36
+ - Pool de cuentas con entornos HOME y credenciales aislados.
37
+ - Failover secuencial cuando una cuenta recibe HTTP 429 o agota su cuota.
38
+ - Cuotas oficiales de 5 horas, 7 días y Argon con barras y cuenta regresiva.
39
+ - Streaming de texto, thinking y actividad de herramientas en tarjetas nativas de DSH.
40
+ - Sesiones DSH vinculadas a conversaciones `agy` mediante `--conversation`.
41
+ - Modelos Gemini, Claude y GPT-OSS elegibles desde el provider `antigravity`.
42
+ - Adaptabilidad web móvil: cajón a pantalla completa (`100dvh`) bajo 680px y botones de ancho parejo.
43
+ - Traducción a lenguaje natural (`/tsl`): tarjeta estilo Gemini anclada bajo la respuesta, conversación 1:1 dedicada.
44
+ - Aprendizaje adaptativo de `--effort`: detecta si un modelo rechaza el esfuerzo y reintenta de inmediato sin fallar.
45
+ - Imágenes multimodales guardadas localmente y autorizadas a `agy` con `--add-dir`.
46
+ - Herramienta `agy_ask` para delegar una tarea puntual a un modelo Antigravity.
58
47
 
59
- ## Comandos `/agy`
48
+ ## Configuración
60
49
 
61
- `status`, `pool` / `accounts`, `auth` / `auth-code`, `add-account` / `remove-account`, `enable-account` / `disable-account`, `refresh-quota` / `clear-cooldown`, `models`, `mode`, `effort`, `dispatch` / `dispatch-retries` / `parallel` / `max-concurrent`, `workspace`, `goal`, `session`, `clear`, `doctor`.
50
+ | Clave | Variable de entorno | Predeterminado | Descripción |
51
+ | --- | --- | --- | --- |
52
+ | `enabled` | `DSH_AGY_ENABLED` | `true` | Activa/desactiva el plugin |
53
+ | `agyBin` | `DSH_AGY_BIN` | detección automática | Ruta al ejecutable `agy` |
54
+ | `permissionMode` | `DSH_AGY_MODE` | `skip` | `skip`, `plan` o `accept-edits` (fijo a `skip` en el panel; config/env pueden sobrescribirlo) |
55
+ | `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | predeterminado de agy | Slug del modelo predeterminado |
56
+ | `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | `low`, `medium`, `high` o `auto`; valor inicial del menú de modelos |
57
+ | `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Timeout del watchdog en ms |
58
+ | `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Presupuesto de inactividad (minutos) mientras un paso de herramienta sigue abierto; `0` = mantener `timeoutMs` |
59
+ | `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | cwd de la sesión | Raíz del workspace |
60
+ | `suppressAgyAutoUpdate` | `DSH_AGY_SUPPRESS_AUTOUPDATE` | `true` en Windows | Actualiza marca de tiempo para evitar destellos de consola |
61
+ | `autoWarmup` | `DSH_AGY_AUTO_WARMUP` | `false` | Sonda de precalentamiento para cuota semanal de 7 días |
62
+ | `autoTranslate` | `DSH_AGY_AUTO_TRANSLATE` | `false` | Traducción automática a lenguaje natural tras cada turno |
63
+ | `translateModel` | `DSH_AGY_TRANSLATE_MODEL` | `gemini-3.8-flash` | Modelo usado para traducciones `/tsl` |
62
64
 
63
- ## Uso de `/tsl`
65
+ > Para consultar la lista completa de opciones, véase [docs/CONFIGURATION.md](./CONFIGURATION.md).
64
66
 
65
- ```
66
- /tsl # traduce el último turno completado
67
- /tsl 3 # traduce el turno 3
68
- /tsl --full # incluye la narración intermedia
69
- /tsl --text 任意文本… # traduce texto arbitrario (sin tarjeta)
70
- /tsl --model claude-sonnet-5-5 --effort medium
71
- /tsl auto on|off|status # modo automático por sesión
72
- ```
73
-
74
- ## Configuración
67
+ ## Comandos
75
68
 
76
- Claves habituales: `enabled`, `agyBin`, `permissionMode` (por defecto `skip`), `defaultModel`, `defaultEffort` (por defecto `high`), `hiddenModels`, `timeoutMs`, `workspaceRoot`, `proxyUrl`, `suppressAgyAutoUpdate`, `autoWarmup`, `autoTranslate`, `translateModel`, `translateEffort`. La lista completa de claves, variables de entorno y valores por defecto está en [CONFIGURATION.md](./CONFIGURATION.md).
69
+ `/agy`: `status`, `pool`, `auth`, `models`, `mode`, `effort`, `workspace`, `goal`, `session`, `enable-account`, `disable-account`, `clear`, `doctor` y `help`.
70
+ `/tsl`: traduce el último turno o texto arbitrario con `--full`, `--text`, `--model` o `auto on|off`.
77
71
 
78
- ## Seguridad y condiciones
72
+ ## Seguridad y términos
79
73
 
80
- El plugin solo invoca el binario oficial y sin modificar `agy` instalado localmente. Su uso está sujeto a las condiciones del servicio de Google Antigravity.
74
+ El plugin invoca solamente el binario `agy` oficial y sin modificar instalado localmente. Úselo conforme a los Términos de Servicio de Google Antigravity. Mantenga literales los comandos, variables, IDs de modelo y rutas al adaptar esta documentación.
81
75
 
82
76
  ## Licencia
83
77
 
@@ -1,83 +1,77 @@
1
1
  # dsh-agy-link — Português (Brasil)
2
2
 
3
- Integre o Google Antigravity ao DeepSeek Harness (DSH). O plugin controla o CLI oficial e não modificado `agy` e adiciona pool de contas, acompanhamento oficial de cotas por bucket, streaming nativo com cartões de ferramentas e reescrita em linguagem simples com `/tsl`.
4
-
5
- <p align="center">
6
- <img src="./assets/console.png" alt="Console do Antigravity: pool de contas, barras de cota oficiais e estado do proxy" width="760">
7
- </p>
8
-
9
- <p align="center">
10
- <img src="./assets/model-picker.png" alt="Modelos do Antigravity no seletor de modelos do DSH" width="300">
11
- &nbsp;&nbsp;
12
- <img src="./assets/settings.png" alt="Configurações do Antigravity embutidas na página de plugins do DSH" width="520">
13
- </p>
14
-
15
- ## Visão geral
16
-
17
- Cada turno inicia o processo oficial `agy`, analisa seu fluxo de eventos NDJSON e o converte em texto, raciocínio, cartões de ferramentas e medição de tokens nativos do DSH. A rotação de contas, a consulta de cotas e as novas tentativas acontecem dentro do plugin; o DSH apenas vê uma chamada normal ao modelo.
18
-
19
- - Várias contas do Google são consumidas em ordem, então uma conversa sobrevive ao esgotamento de uma cota.
20
- - As cotas vêm do endpoint oficial: janela de 5 horas, janela semanal e o pool Argon pago são exibidos separadamente.
21
- - Raciocínio, comandos de terminal e edições de arquivos aparecem como cartões nativos do DSH.
22
- - O `/tsl` reescreve qualquer resposta em linguagem simples quando o modelo escreve de forma formal demais.
3
+ Integre modelos Google Antigravity ao DeepSeek Harness (DSH) por meio do CLI oficial e não modificado `agy`. O plugin oferece streaming, thinking, atividade de ferramentas, medição de tokens, login OAuth pela interface, monitoramento oficial de quotas e tradução para linguagem natural com `/tsl`.
23
4
 
24
5
  ## Requisitos
25
6
 
26
7
  | Requisito | Verificação |
27
8
  | --- | --- |
28
9
  | DSH | `dsh --version` |
29
- | Node.js ≥ 24 | `node --version` |
10
+ | Node.js >= 24 | `node --version` |
30
11
  | Google Antigravity CLI | `agy --version` |
31
- | Conectividade com o Google | proxy / VPN / TUN quando necessário |
12
+ | Conectividade com Google | proxy/VPN/TUN quando necessário |
32
13
 
33
- Onde o Google não for acessível diretamente, ative o proxy do sistema ou o modo TUN. Se o terminal não herdar o proxy, exporte-o antes de iniciar o DSH:
14
+ Em regiões onde o Google não é acessível diretamente, use o modo TUN/proxy do sistema. Se o terminal não herdar o proxy, exporte antes de iniciar o DSH:
34
15
 
35
16
  ```bash
36
17
  export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
37
18
  ```
38
19
 
39
- Substitua a porta pela do seu proxy local. Também é possível configurar um proxy dedicado por conta no console.
20
+ Substitua a porta pelo proxy local correto. Também é possível configurar um proxy HTTP(S) ou SOCKS por conta no painel Antigravity do DSH.
40
21
 
41
22
  ## Instalação e início rápido
42
23
 
43
24
  ```bash
25
+ # Instale o plugin no profile web
44
26
  dsh plugin --profile web add dsh-agy-link
27
+
28
+ # Inicie o DSH Web
45
29
  dsh web
46
30
  ```
47
31
 
48
- No DSH, clique no selo `AGY (n)` e escolha "Add account" para concluir o login do Google no navegador; não é preciso copiar nenhum código de autorização. Como alternativa, execute `/agy auth` para a conta principal. Depois selecione um modelo do Antigravity em `/model` e comece a conversar. O `/agy status` informa o estado atual.
32
+ No DSH, clique no selo `AGY (n)` e selecione **Add Account** para concluir o login Google no navegador. Como alternativa, execute `/agy auth` para iniciar o login da conta principal. Em seguida, selecione um modelo Antigravity no seletor `/model` e comece a conversar. Use `/agy status` para verificar o estado.
49
33
 
50
- ## Principais recursos
34
+ ## Recursos
51
35
 
52
- - **Pool de contas**: HOME e credenciais OAuth isolados por conta; failover sequencial em caso de 429 ou esgotamento; rotação que prioriza a cota que expira antes; resfriamento por família de modelos; troca manual; proxy por conta; concessões de credenciais em paralelo.
53
- - **Cotas oficiais**: 5 horas móveis, 7 dias semanais e o pool semanal Argon, com contagem regressiva de reinício e detalhe por modelo.
54
- - **Console e configurações**: o selo `AGY (n)` no cabeçalho e Configurações → Plugins → Antigravity abrem o mesmo console. Dentro: cartão da conta (proxy, ativar, pré-aquecer, remover), nota de execução (permissão fixa em `skip`), agendamento do pool (esgotamento sequencial / round robin), pré-aquecimento semanal de 7 dias, tradução automática, esforço de raciocínio padrão e visibilidade de modelos. O seletor lista os modelos em `Antigravity (agy CLI)`: Gemini 3.8 Flash, Claude Sonnet 4.6 (Thinking), Claude Opus 4.6 (Thinking), GPT-OSS 120B (Medium).
55
- - **Integração nativa**: provedor `antigravity` em `/model` com as famílias Gemini, Claude, GPT-OSS e Argon; streaming de texto, raciocínio e atividade de ferramentas; cartões de terminal e diff, com as meta-ferramentas MCP desembrulhadas; diagramas mermaid; continuidade de sessão com `--conversation`; encaminhamento de goal e plan; medição completa de tokens com contexto de 1M; imagens multimodais; delegação com `agy_ask`.
56
- - **Aprendizado de effort**: um modelo que recusa `--effort` é repetido uma vez sem a opção e fica registrado em `~/.dsh/agy-link/effort-unsupported.json`; uma incompatibilidade nunca faz um turno falhar.
57
- - **Tradução `/tsl`**: comando, modo automático opcional e uma ação por resposta; o resultado é persistido como um cartão abaixo da resposta, mantém o original e nunca entra no histórico visível ao modelo; usa o mesmo pool com failover.
36
+ - Pool de contas com ambientes HOME e credenciais isolados.
37
+ - Failover sequencial quando uma conta recebe HTTP 429 ou esgota a quota.
38
+ - Quotas oficiais de 5 horas, 7 dias e Argon com barras e contagem regressiva.
39
+ - Streaming de texto, thinking e atividade de ferramentas em componentes nativos do DSH.
40
+ - Conversas DSH vinculadas às conversas do `agy` por `--conversation`.
41
+ - Modelos Gemini, Claude e GPT-OSS selecionáveis no provider `antigravity`.
42
+ - Responsividade web móvel: gaveta em tela cheia (`100dvh`) abaixo de 680px e botões de largura uniforme.
43
+ - Tradução para linguagem natural (`/tsl`): cartão estilo Gemini ancorado sob a resposta, conversa 1:1 dedicada.
44
+ - Aprendizado de `--effort`: detecta recusas do parâmetro de esforço e reexecuta com sucesso sem falhas.
45
+ - Imagens multimodais armazenadas localmente e autorizadas ao `agy` por `--add-dir`.
46
+ - Ferramenta `agy_ask` para delegar uma tarefa pontual a um modelo Antigravity.
58
47
 
59
- ## Comandos `/agy`
48
+ ## Configuração
60
49
 
61
- `status`, `pool` / `accounts`, `auth` / `auth-code`, `add-account` / `remove-account`, `enable-account` / `disable-account`, `refresh-quota` / `clear-cooldown`, `models`, `mode`, `effort`, `dispatch` / `dispatch-retries` / `parallel` / `max-concurrent`, `workspace`, `goal`, `session`, `clear`, `doctor`.
50
+ | Chave | Variável de ambiente | Padrão | Descrição |
51
+ | --- | --- | --- | --- |
52
+ | `enabled` | `DSH_AGY_ENABLED` | `true` | Liga/desliga o plugin |
53
+ | `agyBin` | `DSH_AGY_BIN` | autodetectado | Caminho do executável `agy` |
54
+ | `permissionMode` | `DSH_AGY_MODE` | `skip` | `skip`, `plan` ou `accept-edits` (fixo em `skip` no painel; config/env ainda podem sobrescrever) |
55
+ | `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | padrão do agy | Slug do modelo padrão |
56
+ | `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | `low`, `medium`, `high` ou `auto`; valor inicial do seletor de modelos |
57
+ | `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Timeout do watchdog, em ms |
58
+ | `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Orçamento de inatividade (minutos) enquanto um passo de ferramenta está aberto; `0` = manter `timeoutMs` |
59
+ | `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | cwd da sessão | Raiz do workspace |
60
+ | `suppressAgyAutoUpdate` | `DSH_AGY_SUPPRESS_AUTOUPDATE` | `true` no Windows | Atualiza timestamp para evitar flashes do terminal |
61
+ | `autoWarmup` | `DSH_AGY_AUTO_WARMUP` | `false` | Sonda de pré-aquecimento para quota semanal de 7 dias |
62
+ | `autoTranslate` | `DSH_AGY_AUTO_TRANSLATE` | `false` | Tradução automática para linguagem natural a cada turno |
63
+ | `translateModel` | `DSH_AGY_TRANSLATE_MODEL` | `gemini-3.8-flash` | Modelo usado para traduções `/tsl` |
62
64
 
63
- ## Uso do `/tsl`
65
+ > Para consultar a lista completa de opções, consulte [docs/CONFIGURATION.md](./CONFIGURATION.md).
64
66
 
65
- ```
66
- /tsl # traduz o último turno concluído
67
- /tsl 3 # traduz o turno 3
68
- /tsl --full # inclui a narração intermediária
69
- /tsl --text 任意文本… # traduz texto arbitrário (sem cartão)
70
- /tsl --model claude-sonnet-5-5 --effort medium
71
- /tsl auto on|off|status # modo automático por sessão
72
- ```
73
-
74
- ## Configuração
67
+ ## Comandos
75
68
 
76
- Chaves comuns: `enabled`, `agyBin`, `permissionMode` (padrão `skip`), `defaultModel`, `defaultEffort` (padrão `high`), `hiddenModels`, `timeoutMs`, `workspaceRoot`, `proxyUrl`, `suppressAgyAutoUpdate`, `autoWarmup`, `autoTranslate`, `translateModel`, `translateEffort`. A lista completa de chaves, variáveis de ambiente e padrões está em [CONFIGURATION.md](./CONFIGURATION.md).
69
+ `/agy`: `status`, `pool`, `auth`, `models`, `mode`, `effort`, `workspace`, `goal`, `session`, `enable-account`, `disable-account`, `clear`, `doctor` e `help`.
70
+ `/tsl`: traduz o último turno ou texto arbitrário com `--full`, `--text`, `--model` ou `auto on|off`.
77
71
 
78
72
  ## Segurança e termos
79
73
 
80
- O plugin invoca apenas o binário oficial e não modificado `agy` instalado localmente. O uso está sujeito aos Termos de Serviço do Google Antigravity.
74
+ O plugin chama somente o binário `agy` oficial e não modificado instalado localmente. Use-o em conformidade com os Termos de Serviço do Google Antigravity. Preserve literalmente comandos, variáveis, IDs de modelo e caminhos ao adaptar esta documentação.
81
75
 
82
76
  ## Licença
83
77
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-agy-link",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "description": "Google Antigravity (agy CLI) models for DeepSeek Harness — stream Gemini/Claude/GPT-OSS subscriptions into DSH with thinking, tool activity, token usage and in-GUI Google OAuth login.",
5
5
  "type": "module",
6
6
  "license": "MIT",