# Test connection
echo '{"type":"ping"}' | nc -U /tmp/whisp.sock

{
  "event": "complete",
  "response": { ... },
  "model": "gpt-5-nano-2025-08-07",
  "duration_ms": 234
}

{
  "event": "error",
  "message": "Error description"
}

{"type": "ping"}

{"status": "ok"}

{"type": "health"}

{
  "uptime_secs": 3600,
  "request_count": 150,
  "error_count": 2,
  "active_connections": 1,
  "provider": "openai",
  "last_request_time": 1704067200,
  "memory_usage_bytes": 52428800,
  "version": "0.1.0"
}

{"type": "metrics"}

{
  "uptime_secs": 3600,
  "avg_response_ms": 450.5,
  "p50_response_ms": 380,
  "p95_response_ms": 890,
  "p99_response_ms": 1200,
  "requests_per_hour": 25.5,
  "total_input_tokens": 45000,
  "total_output_tokens": 12000,
  "request_type_counts": {
    "query": 100,
    "explain": 30,
    "chat": 20
  }
}

{
  "type": "query",
  "query": "find files larger than 100MB",
  "cwd": "/home/user/projects",
  "shell": "bash",
  "session_id": "abc123",
  "project_type": "rust",
  "project_root": "/home/user/projects/myapp",
  "git_branch": "main",
  "git_dirty": false
}

{
  "command": "find . -type f -size +100M",
  "explanation": "Finds all files larger than 100MB in the current directory and subdirectories.",
  "warning": null
}

{
  "clarification": "Do you want to find files by size or by name pattern?"
}

{
  "type": "error",
  "command": "npm start",
  "exit_code": 1,
  "stderr": "Error: Cannot find module 'express'",
  "cwd": "/home/user/projects/app",
  "session_id": "abc123",
  "project_type": "node",
  "project_root": "/home/user/projects/app",
  "git_branch": "main",
  "git_dirty": true
}

{
  "fix": "npm install express",
  "explanation": "The 'express' module is missing. Install it as a dependency."
}

{
  "type": "pipe",
  "query": "summarize the errors",
  "stdin": "Error: connection refused\nError: timeout\nError: connection refused",
  "cwd": "/home/user",
  "shell": "bash",
  "session_id": "abc123"
}

{
  "type": "pipe",
  "query": "analyze this log",
  "stdin_base64": "RXJyb3I6IGNvbm5lY3Rpb24gcmVmdXNlZAo=",
  "cwd": "/home/user",
  "shell": "bash"
}

{
  "type": "explain",
  "command": "find . -name '*.log' -mtime +7 -delete",
  "cwd": "/var/log",
  "shell": "bash"
}

{
  "explanation": "Finds and deletes all .log files older than 7 days in the current directory.",
  "breakdown": [
    "find . - search in current directory",
    "-name '*.log' - match files ending in .log",
    "-mtime +7 - modified more than 7 days ago",
    "-delete - remove matching files"
  ],
  "warning": "This command may be destructive. Please review carefully before executing."
}

{
  "type": "dry_run",
  "command": "rm -rf ./build",
  "cwd": "/home/user/project",
  "shell": "bash"
}

{
  "effects": [
    "Recursively deletes the ./build directory",
    "Removes all files and subdirectories within ./build"
  ],
  "files_affected": ["./build/", "./build/**/*"],
  "reversible": false,
  "warning": "This command may be destructive. Please review carefully before executing."
}

{
  "type": "variants",
  "original_query": "find large files",
  "original_command": "find . -size +100M",
  "cwd": "/home/user",
  "shell": "bash"
}

{
  "variants": [
    {
      "command": "du -ah . | sort -rh | head -20",
      "explanation": "Lists top 20 largest files/directories with human-readable sizes",
      "tradeoff": "Shows directories too, not just files"
    },
    {
      "command": "find . -type f -size +100M -exec ls -lh {} \\;",
      "explanation": "Finds large files and shows detailed info including size",
      "tradeoff": "More verbose output, slower for many files"
    }
  ]
}

{
  "type": "chat",
  "message": "How do I set up Docker for this project?",
  "conversation_id": "conv_123",
  "cwd": "/home/user/project",
  "shell": "bash",
  "clear_history": false
}

{
  "message": "To set up Docker for this Node.js project, create a Dockerfile...",
  "command": "docker build -t myapp ."
}

{
  "type": "search_history",
  "query": "docker",
  "limit": 10,
  "semantic": false
}

{
  "results": [
    {
      "command": "docker-compose up -d",
      "cwd": "/home/user/project",
      "timestamp": "2024-01-01T12:00:00Z",
      "relevance": 0.95,
      "context": "Starting development services"
    }
  ]
}

{
  "type": "context",
  "command": "cd /var/log",
  "cwd": "/var/log",
  "session_id": "abc123"
}

{"status": "recorded"}

{
  "event": "error",
  "message": "API rate limit exceeded"
}

{
  "event": "complete",
  "response": {
    "error": "Invalid request format"
  },
  "model": "gpt-5-nano-2025-08-07",
  "duration_ms": 5
}

import socket
import json

def whisp_query(query: str, cwd: str = ".") -> dict:
    """Send a query to the whisp daemon."""
    sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
    sock.connect("/tmp/whisp.sock")

    request = {
        "type": "query",
        "query": query,
        "cwd": cwd,
        "shell": "bash"
    }

    sock.send((json.dumps(request) + "\n").encode())
    response = sock.recv(65536).decode()
    sock.close()

    event = json.loads(response)
    if event.get("event") == "complete":
        return event["response"]
    else:
        raise Exception(event.get("message", "Unknown error"))

# Usage
result = whisp_query("list all python files")
print(result["command"])  # find . -name "*.py"

#!/bin/bash

whisp_query() {
    local query="$1"
    local cwd="${2:-$(pwd)}"

    echo "{\"type\":\"query\",\"query\":\"$query\",\"cwd\":\"$cwd\",\"shell\":\"bash\"}" \
        | nc -U /tmp/whisp.sock \
        | jq -r '.response.command // .message'
}

# Usage
cmd=$(whisp_query "compress all log files")
echo "Suggested command: $cmd"