dsh-agy-link 0.5.0 → 0.5.1

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.
package/docs/README.es.md CHANGED
@@ -1,67 +1,83 @@
1
1
  # dsh-agy-link — Español
2
2
 
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 y monitor de cuota.
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.
4
23
 
5
24
  ## Requisitos
6
25
 
7
26
  | Requisito | Verificación |
8
27
  | --- | --- |
9
28
  | DSH | `dsh --version` |
10
- | Node.js >= 24 | `node --version` |
29
+ | Node.js ≥ 24 | `node --version` |
11
30
  | Google Antigravity CLI | `agy --version` |
12
- | Conectividad con Google | proxy/VPN/TUN cuando sea necesario |
31
+ | Conectividad con Google | proxy / VPN / TUN cuando sea necesario |
13
32
 
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:
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:
15
34
 
16
35
  ```bash
17
36
  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
18
37
  ```
19
38
 
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.
39
+ Sustituya el puerto por el de su proxy local. También puede configurar un proxy dedicado por cuenta desde la consola.
21
40
 
22
41
  ## Instalación e inicio rápido
23
42
 
24
43
  ```bash
25
- # Instale el plugin en el profile web
26
44
  dsh plugin --profile web add dsh-agy-link
27
-
28
- # Inicie DSH Web
29
45
  dsh web
30
46
  ```
31
47
 
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.
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.
33
49
 
34
- ## Funciones
50
+ ## Funciones principales
35
51
 
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 y 7 días 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
- - Imágenes multimodales guardadas localmente y autorizadas a `agy` con `--add-dir`.
43
- - Herramienta `agy_ask` para delegar una tarea puntual a un modelo Antigravity.
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.
44
58
 
45
- ## Configuración
59
+ ## Comandos `/agy`
46
60
 
47
- | Clave | Variable de entorno | Predeterminado | Descripción |
48
- | --- | --- | --- | --- |
49
- | `enabled` | `DSH_AGY_ENABLED` | `true` | Activa/desactiva el plugin |
50
- | `agyBin` | `DSH_AGY_BIN` | detección automática | Ruta al ejecutable `agy` |
51
- | `permissionMode` | `DSH_AGY_MODE` | `skip` | `skip`, `plan` o `accept-edits` (ya no se cambia en el panel; config/env siguen pudiendo sobrescribirlo) |
52
- | `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | predeterminado de agy | Slug del modelo predeterminado |
53
- | `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | `low`, `medium`, `high` o `auto`; la fila del panel fija el valor inicial del menú de modelos de la sesión, que puede sobrescribirlo por modelo |
54
- | `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Timeout del watchdog en ms |
55
- | `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Presupuesto de inactividad (minutos) mientras un paso de herramienta sigue abierto; `0` = mantener `timeoutMs` |
56
- | `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | cwd de la sesión | Raíz del workspace |
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`.
57
62
 
58
- ## Comandos `/agy`
63
+ ## Uso de `/tsl`
64
+
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
59
75
 
60
- `status`, `auth`, `models`, `mode`, `effort`, `workspace`, `clear`, `doctor` y `help`.
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).
61
77
 
62
- ## Seguridad y términos
78
+ ## Seguridad y condiciones
63
79
 
64
- 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.
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.
65
81
 
66
82
  ## Licencia
67
83
 
@@ -1,67 +1,83 @@
1
1
  # dsh-agy-link — Português (Brasil)
2
2
 
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 e painel de quota.
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.
4
23
 
5
24
  ## Requisitos
6
25
 
7
26
  | Requisito | Verificação |
8
27
  | --- | --- |
9
28
  | DSH | `dsh --version` |
10
- | Node.js >= 24 | `node --version` |
29
+ | Node.js ≥ 24 | `node --version` |
11
30
  | Google Antigravity CLI | `agy --version` |
12
- | Conectividade com Google | proxy/VPN/TUN quando necessário |
31
+ | Conectividade com o Google | proxy / VPN / TUN quando necessário |
13
32
 
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:
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:
15
34
 
16
35
  ```bash
17
36
  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
18
37
  ```
19
38
 
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.
39
+ Substitua a porta pela do seu proxy local. Também é possível configurar um proxy dedicado por conta no console.
21
40
 
22
41
  ## Instalação e início rápido
23
42
 
24
43
  ```bash
25
- # Instale o plugin no profile web
26
44
  dsh plugin --profile web add dsh-agy-link
27
-
28
- # Inicie o DSH Web
29
45
  dsh web
30
46
  ```
31
47
 
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.
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.
33
49
 
34
- ## Recursos
50
+ ## Principais recursos
35
51
 
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 e 7 dias, 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
- - Imagens multimodais armazenadas localmente e autorizadas ao `agy` por `--add-dir`.
43
- - Ferramenta `agy_ask` para delegar uma tarefa pontual a um modelo Antigravity.
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.
44
58
 
45
- ## Configuração
59
+ ## Comandos `/agy`
46
60
 
47
- | Chave | Variável de ambiente | Padrão | Descrição |
48
- | --- | --- | --- | --- |
49
- | `enabled` | `DSH_AGY_ENABLED` | `true` | Liga/desliga o plugin |
50
- | `agyBin` | `DSH_AGY_BIN` | autodetectado | Caminho do executável `agy` |
51
- | `permissionMode` | `DSH_AGY_MODE` | `skip` | `skip`, `plan` ou `accept-edits` (não é mais alternável no painel; config/env ainda pode sobrescrever) |
52
- | `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | padrão do agy | Slug do modelo padrão |
53
- | `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | `low`, `medium`, `high` ou `auto`; a linha do painel define o valor inicial do menu de modelos da sessão, que ainda pode ser sobrescrito por modelo |
54
- | `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Timeout do watchdog, em ms |
55
- | `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Orçamento de inatividade (minutos) enquanto um passo de ferramenta está aberto; `0` = manter `timeoutMs` |
56
- | `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | cwd da sessão | Raiz do workspace |
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`.
57
62
 
58
- ## Comandos `/agy`
63
+ ## Uso do `/tsl`
64
+
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
59
75
 
60
- `status`, `auth`, `models`, `mode`, `effort`, `workspace`, `clear`, `doctor` e `help`.
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).
61
77
 
62
78
  ## Segurança e termos
63
79
 
64
- 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.
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.
65
81
 
66
82
  ## Licença
67
83
 
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-agy-link",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
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",
Binary file