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/CHANGELOG.md +20 -0
- package/README.md +349 -318
- package/dist/client.js +141 -48
- package/dist/index.js +28 -5
- package/docs/CONFIGURATION.md +108 -0
- package/docs/README.en.md +48 -32
- package/docs/README.es.md +49 -33
- package/docs/README.pt-BR.md +48 -32
- package/docs/assets/console.png +0 -0
- package/docs/assets/model-picker.png +0 -0
- package/docs/assets/settings.png +0 -0
- package/package.json +1 -1
- package/docs/assets/dashboard.png +0 -0
package/docs/README.es.md
CHANGED
|
@@ -1,67 +1,83 @@
|
|
|
1
1
|
# dsh-agy-link — Español
|
|
2
2
|
|
|
3
|
-
Integra
|
|
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
|
+
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
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
|
-
##
|
|
59
|
+
## Comandos `/agy`
|
|
46
60
|
|
|
47
|
-
|
|
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
|
-
##
|
|
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
|
-
`
|
|
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
|
|
78
|
+
## Seguridad y condiciones
|
|
63
79
|
|
|
64
|
-
El plugin invoca
|
|
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
|
|
package/docs/README.pt-BR.md
CHANGED
|
@@ -1,67 +1,83 @@
|
|
|
1
1
|
# dsh-agy-link — Português (Brasil)
|
|
2
2
|
|
|
3
|
-
Integre
|
|
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
|
+
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
-
##
|
|
50
|
+
## Principais recursos
|
|
35
51
|
|
|
36
|
-
- Pool de contas
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
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
|
-
##
|
|
59
|
+
## Comandos `/agy`
|
|
46
60
|
|
|
47
|
-
|
|
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
|
-
##
|
|
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
|
-
`
|
|
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
|
|
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.
|
|
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
|