DeepSeek Harness: Primeiro Uso

┌──────────────────────────────────────────────────┐
│ [Standard ▼]  [deepseek-chat ▼]  ⚙️  📋  ❓  │
└──────────────────────────────────────────────────┘
   ↑Seleção de Modo   ↑Seleção de Modelo   ↑Config ↑Logs ↑Ajuda

┌─────────────────────────────────────────┐
│ 👤 Alice                                │
│ Me ajude a analisar a estrutura do      │
│ projeto no diretório atual              │
├─────────────────────────────────────────┤
│ 🤖 Agent                                │
│ 🔍 Using tool: search                   │
│   → Searching in /home/alice/project... │
│ ✅ Found 15 files                       │
│                                         │
│ Este projeto é uma app Express.js.      │
│ Estrutura principal:                    │
│ - src/routes/ — Definições de rotas     │
│ - src/models/ — Modelos de dados        │
│ - src/middleware/ — Middleware           │
└─────────────────────────────────────────┘

# O workspace determina o "campo de visão" do Agent
/home/alice/project     ← O Agent só pode ver arquivos neste diretório
├── src/
├── package.json
└── README.md

📂 Select Workspace
┌──────────────────────────────────────┐
│ ○ /home/alice/project               │
│ ○ /home/alice/another-repo          │
│ ● Enter custom path...              │
└──────────────────────────────────────┘

# Pré-configurar workspace via variável de ambiente
export DSH_WORKSPACE="/home/alice/my-project"

# Ou na Web UI: Settings → Workspace → Change

Placeholder for user input

🤖 Agent: Vou te ajudar a analisar este projeto.

🔍 Using tool: search
  → Pattern: *
  → Path: /home/alice/project
  → Max depth: 3

🔍 Using tool: file_edit (read)
  → File: package.json
  → Action: read

📊 Resultados da Análise:

1. Stack Tecnológico:
   - Runtime: Node.js 20.x
   - Framework: Express 4.18
   - Database: PostgreSQL (pg 8.12)
   - Testing: Jest 29.x

2. Estrutura de Diretórios:
   src/
   ├── routes/    — 8 arquivos de rotas
   ├── models/    — 5 modelos de dados
   ├── middleware/ — 3 middleware
   └── utils/     — Funções utilitárias

3. Sugestões:
   - Faltam definições de tipos TypeScript
   - Recomendo adicionar camada src/services/ para separar lógica de negócio

│                                                  │
│ 🔍 search                                        │
│ ├─ Status: ✅ Completo                           │
│ ├─ Duração: 0.3s                                 │
│ └─ Arquivos encontrados: 23                      │
│                                                  │
│ 📄 file_edit (read)                              │
│ ├─ Status: ✅ Completo                           │
│ ├─ Duração: 0.1s                                 │
│ └─ File: package.json (1.2KB)                    │
│                                                  │
│ 📊 Total de ferramentas: 2                       │
│ 📊 Tempo total: 0.4s                             │
└──────────────────────────────────────────────────┘

// Pseudocódigo do pipeline de execução de ferramentas
async function executeTool(tool, params) {
  // 1. pre-execute: validação + aprovação
  await preExecute(tool, params);
  
  // 2. execute: execução real
  const result = await tool.execute(params);
  
  // 3. post-execute: registro de log
  await postExecute(tool, params, result);
  
  return result;
}

┌─ ⚠️ Aprovação Necessária ───────────────────────┐
│                                                   │
│ O Agent quer:                                     │
│ 📝 Editar arquivo: src/index.ts                   │
│                                                   │
│ Mudanças:                                         │
│ - Linha 12: Adicionar declaração de import        │
│ - Linha 45: Modificar tratador de erro            │
│                                                   │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐           │
│ │  ✅ Permitir │ │ 🔁 Sempre│ │  ❌ Negar │           │
│ └──────────┘ └──────────┘ └──────────┘           │
└───────────────────────────────────────────────────┘

# dsh.config.yaml
approval:
  # Leituras de arquivo: sempre permitir
  file_read: always
  
  # Edições de arquivo: requer aprovação
  file_edit: ask
  
  # Comandos Shell: baseado no nível de perigo
  shell:
    safe_commands: always     # ls, cat, grep, etc.
    unsafe_commands: ask      # rm, chmod, sudo, etc.
    dangerous_commands: deny  # rm -rf /, dd, etc.
  
  # Operações de busca: sempre permitir
  search: always

# Configurar modo sandbox
export DSH_SANDBOX=strict    # Mais seguro
export DSH_SANDBOX=permissive # Padrão
export DSH_SANDBOX=off        # Não recomendado

👤 Alice: Crie health.ts em src/routes/, adicione um endpoint GET /health
        que retorna { status: "ok", timestamp: Date.now() }

🤖 Agent: Vou criar o endpoint de health check para você.

📝 Using tool: file_edit
  → Action: create
  → Path: src/routes/health.ts
  → Content: 
    import { Router } from 'express';
    const router = Router();
    router.get('/health', (_req, res) => {
      res.json({ status: 'ok', timestamp: Date.now() });
    });
    export default router;

⚠️ Aprovação Necessária: Criar arquivo src/routes/health.ts
  → [Alice clica Permitir]

✅ Arquivo criado: src/routes/health.ts

Agora precisamos registrar esta rota em app.ts:

📝 Using tool: file_edit
  → Action: edit
  → Path: src/app.ts
  → Changes: 
    + import healthRouter from './routes/health';
    + app.use('/health', healthRouter);

⚠️ Aprovação Necessária: Editar arquivo src/app.ts
  → [Alice clica Permitir]

✅ Arquivo editado: src/app.ts

Pronto! Endpoint de health check adicionado. Teste em GET /health.

┌─ Painel de Ferramentas ────────────────────────┐
│ 📝 file_edit (create)                            │
│ ├─ Path: src/routes/health.ts                    │
│ ├─ Status: ✅ Aprovado & Completo                │
│ └─ Duração: 0.2s                                 │
│                                                   │
│ 📝 file_edit (edit)                              │
│ ├─ Path: src/app.ts                              │
│ ├─ Changes: +2 linhas                            │
│ ├─ Status: ✅ Aprovado & Completo                │
│ └─ Duração: 0.1s                                 │
└──────────────────────────────────────────────────┘

Lista de sessões à esquerda → Clique no botão + → Nova sessão

Sessões são nomeadas automaticamente (com base no conteúdo da primeira conversa), ou podem ser renomeadas manualmente.

// Cada SessionEvent é automaticamente persistido
interface SessionEvent {
  type: 'user_message' | 'agent_message' | 'tool_call' | 'tool_result' | 'approval';
  timestamp: number;
  data: Record<string, unknown>;
}