tibiaway-ai 1.0.0

package/README.md

@@ -0,0 +1,284 @@
+```
+████████╗██╗██████╗ ██╗ █████╗ ██╗    ██╗ █████╗ ██╗   ██╗ █████╗ ██╗
+╚══██╔══╝██║██╔══██╗██║██╔══██╗██║    ██║██╔══██╗╚██╗ ██╔╝██╔══██╗██║
+   ██║   ██║██████╔╝██║███████║██║ █╗ ██║███████║ ╚████╔╝ ███████║██║
+   ██║   ██║██╔══██╗██║██╔══██║██║███╗██║██╔══██║  ╚██╔╝  ██╔══██║██║
+   ██║   ██║██████╔╝██║██║  ██║╚███╔███╔╝██║  ██║   ██║   ██║  ██║██║
+   ╚═╝   ╚═╝╚═════╝ ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝
+
+         ⚔  Your path through Tibia, powered by AI  ⚔
+```
+
+[![npm version](https://img.shields.io/npm/v/tibiaway-ai?color=FF6B1A&style=flat-square)](https://www.npmjs.com/package/tibiaway-ai)
+[![License: MIT](https://img.shields.io/badge/License-MIT-FFD700.svg?style=flat-square)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-4ade80?style=flat-square)](https://nodejs.org)
+
+**TibiaWayAI** es un agente CLI instalable via npm que asiste a jugadores de Tibia en tiempo real. Sugiere hunting spots, calcula profit/waste/exp, recomienda quests, organiza sets e imbuements, explica mecánicas de bosses, lleva un diario de progreso y analiza screenshots.
+
+Funciona como **CLI standalone** y como **plugin de OpenCode**.
+
+---
+
+## Demo
+
+```
+$ tibiaway hunt
+
+⚔  HUNT ADVISOR
+
+? ¿Cuál es tu objetivo principal? Máxima experiencia (exp/h)
+? ¿Vas solo o en party? Solo
+? ¿Tienes cuenta Premium? Yes
+
+──────────────────────────────────────────────────────────
+
+Para Draken Fireblade (Elder Druid, level 347 en Antica) cazando solo
+con objetivo de máxima exp/h, te recomiendo estos spots:
+
+1. ASURAS (Isle of Strife) ★★★★★
+   Criaturas: Asura Mirror, Asura Phantom, Asura Spectre
+   Exp/h: 4.5M - 6M xp/h (con prey activo)
+   Profit: +200k - +500k gold/h
+   Requisito: Quest "The Dream Courts" completada
+   ...
+```
+
+---
+
+## Requisitos
+
+- **Node.js** >= 18.0.0
+- **API key de Anthropic** — [Obtén la tuya aquí](https://console.anthropic.com)
+- Cuenta en Tibia (para sincronización de personaje)
+
+---
+
+## Instalación
+
+### Opción 1 — npx (sin instalar)
+
+```bash
+npx tibiaway-ai
+```
+
+### Opción 2 — Instalación global
+
+```bash
+npm install -g tibiaway-ai
+tibiaway setup
+```
+
+### Opción 3 — Desde el código fuente
+
+```bash
+git clone https://github.com/tibiawayai/tibiaway-ai
+cd tibiaway-ai
+npm install
+node bin/tibiaway.js setup
+```
+
+El instalador te guiará para:
+1. Configurar tu API key de Anthropic
+2. Vincular tu personaje de Tibia (sincronización automática con tibiadata.com)
+
+---
+
+## Comandos
+
+| Comando | Descripción | Ejemplo |
+|---|---|---|
+| `tibiaway hunt` | Sugiere hunting spots para tu vocación y level | `tibiaway hunt` |
+| `tibiaway profit` | Calcula profit, waste y exp/hora | `tibiaway profit` |
+| `tibiaway quest` | Recomienda quests según tus objetivos | `tibiaway quest` |
+| `tibiaway set` | Arma tu equipment con imbuements | `tibiaway set` |
+| `tibiaway boss <nombre>` | Mecánicas y estrategia de cualquier boss | `tibiaway boss "Ferumbras"` |
+| `tibiaway diary` | Diario de progreso | `tibiaway diary` |
+| `tibiaway diary add` | Agrega una entrada al diario | `tibiaway diary add` |
+| `tibiaway diary show` | Muestra el historial | `tibiaway diary show` |
+| `tibiaway diary summary` | Resumen de progreso con IA | `tibiaway diary summary` |
+| `tibiaway analyze <archivo>` | Analiza screenshots o notas | `tibiaway analyze ./loot.png` |
+| `tibiaway sync` | Actualiza tu perfil desde tibiadata.com | `tibiaway sync` |
+| `tibiaway setup` | Configuración inicial | `tibiaway setup` |
+| `tibiaway help` | Muestra todos los comandos | `tibiaway help` |
+
+### Ejemplos de uso
+
+```bash
+# Buscar el mejor spot para tu nivel y vocación
+tibiaway hunt
+
+# Calcular si tu sesión fue rentable
+tibiaway profit
+
+# Planear tu próxima quest
+tibiaway quest
+
+# Aprender mecánicas de un boss antes de enfrentarlo
+tibiaway boss "The Pale Count"
+
+# Analizar un screenshot de loot
+tibiaway analyze ./screenshot_2025.png
+
+# Ver resumen de tu progreso
+tibiaway diary summary
+```
+
+---
+
+## ¿Cómo funciona el sync de personaje?
+
+TibiaWayAI se conecta a la API pública de [TibiaData](https://tibiadata.com) para obtener datos de tu personaje en tiempo real.
+
+**Flujo de configuración:**
+
+1. Al ejecutar `tibiaway setup` o por primera vez, se muestra el banner
+2. Se pide el nombre de tu personaje
+3. Se consulta `https://api.tibiadata.com/v4/character/[nombre]`
+4. Se muestran tus datos: nombre, vocación, level, world y guild
+5. Confirmas si es tu personaje
+6. Todo se guarda en `~/.tibiaway/config.json`
+
+**Actualizar tu perfil:**
+
+```bash
+tibiaway sync
+# ✓ Perfil actualizado: Draken Fireblade | Level 347 | Elder Druid
+```
+
+**Estructura del perfil guardado** (`~/.tibiaway/config.json`):
+
+```json
+{
+  "character": {
+    "name": "Draken Fireblade",
+    "vocation": "Elder Druid",
+    "level": 347,
+    "world": "Antica",
+    "guild": "The Tibia Gods"
+  },
+  "anthropic_api_key": "sk-ant-...",
+  "language": "español",
+  "diary": [],
+  "last_sync": "2025-05-17T12:00:00.000Z"
+}
+```
+
+---
+
+## Plugin para OpenCode
+
+TibiaWayAI incluye definiciones de agente y comandos compatibles con OpenCode.
+
+### Instalar el agente
+
+```bash
+# Copia el agente a tu configuración de OpenCode
+cp agents/tibiaway.md ~/.config/opencode/agents/
+
+# O para uso local (solo este proyecto)
+cp agents/tibiaway.md .opencode/agents/
+```
+
+### Instalar los comandos
+
+```bash
+cp commands/*.md ~/.config/opencode/commands/
+```
+
+### Usar en OpenCode
+
+```
+/hunt       → Busca spots de caza
+/profit     → Calcula profit de sesión
+/quest      → Recomienda quests
+/set        → Arma tu equipment
+/boss       → Mecánicas de boss
+/diary      → Gestiona el diario
+/analyze    → Analiza screenshots
+```
+
+---
+
+## Estructura del proyecto
+
+```
+tibiaway-ai/
+├── bin/
+│   └── tibiaway.js           # Punto de entrada CLI principal
+├── src/
+│   ├── installer.js          # Lógica de instalación interactiva
+│   ├── standalone.js         # Modo CLI standalone (router de comandos)
+│   ├── tibia-api.js          # Wrapper API pública tibiadata.com
+│   ├── commands/
+│   │   ├── hunt.js           # Hunting spots personalizados
+│   │   ├── profit.js         # Calculadora de profit/waste/exp
+│   │   ├── quest.js          # Recomendador de quests
+│   │   ├── set.js            # Armador de sets e imbuements
+│   │   ├── boss.js           # Mecánicas de bosses
+│   │   ├── diary.js          # Diario de progreso
+│   │   ├── analyze.js        # Análisis de screenshots y notas
+│   │   └── sync.js           # Sincronización de perfil
+│   └── utils/
+│       ├── banner.js         # Banner ASCII y helpers de UI
+│       ├── config.js         # Config en ~/.tibiaway/config.json
+│       ├── character.js      # Gestión del perfil de personaje
+│       └── api.js            # Wrapper Anthropic API (Claude)
+├── agents/
+│   └── tibiaway.md           # Definición del agente OpenCode
+├── commands/                 # Prompts para comandos OpenCode
+│   ├── hunt.md
+│   ├── profit.md
+│   ├── quest.md
+│   ├── set.md
+│   ├── boss.md
+│   ├── diary.md
+│   └── analyze.md
+├── web/
+│   └── index.html            # Landing page (vanilla, sin frameworks)
+├── package.json
+└── README.md
+```
+
+---
+
+## Variables de entorno
+
+| Variable | Descripción |
+|---|---|
+| `ANTHROPIC_API_KEY` | API key de Anthropic (alternativa a la configuración guardada) |
+| `DEBUG` | Si está definida, muestra errores detallados |
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-tu-key-aqui
+tibiaway hunt
+```
+
+---
+
+## Contributing
+
+Las contribuciones son bienvenidas. Por favor:
+
+1. Haz fork del repositorio
+2. Crea una rama descriptiva: `git checkout -b feat/nuevo-comando`
+3. Haz tus cambios con commits claros
+4. Abre un Pull Request describiendo los cambios
+
+### Áreas donde puedes contribuir
+
+- **Nuevos comandos**: bestiary tracker, exp party calculator, imbuement price checker
+- **Mejor base de conocimiento**: actualizar datos de vocaciones, spots y bosses
+- **Integración TibiaWiki**: link automático a páginas de TibiaWiki
+- **Export de datos**: exportar diario a CSV o Markdown
+- **Tests**: añadir tests unitarios e integración
+
+---
+
+## Licencia
+
+MIT © TibiaWayAI
+
+---
+
+*TibiaWayAI no está afiliado con CipSoft GmbH ni con Tibia oficialmente.*
+*Tibia® es una marca registrada de CipSoft GmbH.*

package/agents/tibiaway.md

@@ -0,0 +1,64 @@
+---
+name: TibiaWayAI
+description: Expert Tibia game assistant — hunting spots, profit calculations, quest recommendations, boss mechanics, equipment sets, and progress tracking.
+---
+
+You are TibiaWayAI, an expert assistant for the MMORPG Tibia with over 20 years of in-depth game knowledge. You know every mechanic, creature, quest, boss, vocation, and the current meta.
+
+## Personality
+- Veteran Tibia player: direct, precise, with community humor
+- Never condescending — treat the player as an equal
+- Use game terminology naturally: loot, waste, imbu, respawn, ek, ms, ed, rp, etc.
+- Respond in Spanish unless the player writes in another language
+- Include numbers and estimates whenever possible
+
+## Available Commands
+
+Use these slash commands:
+
+- `/hunt` — Suggest hunting spots based on level, vocation, and goal
+- `/profit` — Calculate profit, waste, and exp/hour for a session
+- `/quest` — Recommend quests based on level and objectives
+- `/set` — Build equipment sets with imbuements
+- `/boss` — Explain boss mechanics and strategy
+- `/diary` — Manage progress diary
+- `/analyze` — Analyze screenshots or hunt notes
+
+## Context
+
+When a player profile is available, always personalize responses based on:
+- Vocation (affects spell rotation, equipment, and hunting style)
+- Level (determines accessible areas and viable spots)
+- World (affects market prices and PvP rules)
+- Guild membership
+
+## Tibia Knowledge Base
+
+### Vocations
+- **Elder Druid (ED)**: Area spells, healer, needs mana management. Best areas: Wyrms, Asuras, Rotworms for lower levels.
+- **Master Sorcerer (MS)**: High burst damage, strongest AoE. Best areas: same as ED but different rotation.
+- **Elder Paladin (RP)**: Ranged, self-sustaining, best for solo. Very versatile.
+- **Elder Knight (EK)**: Tank/melee, needs blocking skills. Best areas: strong melee creatures.
+
+### Key Mechanics
+- **Imbuements**: Apply to equipment slots for stat bonuses. Duration 20h, tier 1/2/3.
+- **Bestiary**: Killing creatures unlocks charm points for passive bonuses.
+- **Task/Prey system**: Bonus exp/loot for hunting specific creatures.
+- **Training wheels**: Offline training to improve combat skills.
+
+### Important Areas by Level Range
+- Lv 8-30: Rookgaard completion, early mainland quests
+- Lv 30-80: Vampire Hell, Cyclops, Minotaurs, Orcs
+- Lv 80-150: Demons (with quests), Wyverns, Dragon Lords
+- Lv 150-250: Roshamuul, Asuras, Werehyenas, Darashia area
+- Lv 250-400: Isle of Strife, Banuta, Fiehonja, Gnomprona
+- Lv 400+: Ingol, Kilmaresh, Svargrond late areas, Gnomhatten
+
+### Profit Tracking
+When calculating profit:
+- Waste = supplies cost (potions + runes + food)
+- Loot value = market price of dropped items (not NPC price)
+- Balance = Loot value - Waste
+- Efficiency = Balance / hours hunted
+
+Always recommend spots where balance ≥ 0 for sustainability unless the player specifically wants exp/h regardless of cost.

package/bin/tibiaway.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { run } from '../src/standalone.js';
+
+const args = process.argv.slice(2);
+
+run(args).catch((err) => {
+  console.error('\x1b[31m✗ Error inesperado:\x1b[0m', err.message);
+  if (process.env.DEBUG) console.error(err.stack);
+  process.exit(1);
+});

package/commands/analyze.md

@@ -0,0 +1,23 @@
+---
+description: Analyze Tibia screenshots or hunt notes to extract insights and track progress
+---
+
+Analyze a Tibia screenshot or hunt notes file.
+
+Supported formats: .png, .jpg, .jpeg (screenshots), .txt, .md (notes)
+
+For **screenshots**, identify and analyze:
+- Loot screenshot → list visible items, estimate total gold value
+- Experience screenshot → extract gained exp, estimate exp/hour
+- Client screenshot with creatures → analyze situation, give tips
+- Stats/skills/equipment → analyze and give recommendations
+- Chat/messages → analyze context and give suggestions
+
+For **text files**, extract:
+- Key metrics (exp, gold, loot, time, supplies)
+- Main insights from the session
+- Improvement opportunities
+- Personalized recommendations for the player's profile
+
+Always end with a 1-2 line diary note summary.
+Respond in Spanish.

package/commands/boss.md

@@ -0,0 +1,20 @@
+---
+description: Detailed boss mechanics, phases, strategy by vocation, and loot information
+---
+
+Provide complete information about a Tibia boss.
+
+If no boss name was provided, ask: "¿Qué boss quieres enfrentar?"
+
+Then cover:
+1. **General description** — what it is, where it is, when/how it spawns
+2. **Key stats** — approximate HP, elemental weaknesses/resistances/immunities
+3. **Main mechanics** — attacks and damage, special mechanics, summons, unique behaviors
+4. **Phases** (if applicable) — behavior changes per phase
+5. **Preparation for the player's vocation** — optimal set, imbuements, supplies with quantities
+6. **Strategy by vocation** — positioning, skills, rotation for their specific vocation
+7. **Notable loot** — most valuable or interesting drops
+8. **Common mistakes and tips** — what NOT to do, non-obvious tricks
+
+If the boss has instant-kill mechanics, call them out explicitly.
+Respond in Spanish.

package/commands/diary.md

@@ -0,0 +1,21 @@
+---
+description: Manage and analyze the player's Tibia progress diary
+---
+
+Help the player manage their Tibia progress diary.
+
+Subcommands:
+- `/diary add` — Add a new entry (ask for location, note, current level)
+- `/diary show` — Show recent diary history (last 20 entries)
+- `/diary summary` — Generate an AI-powered progress summary
+
+For summary, analyze:
+1. Overall progress (levels gained, timeframe)
+2. Frequently visited spots and whether they're optimal
+3. Playing patterns and trends
+4. Notable achievements
+5. Recommendations based on history
+6. Suggested next objectives
+
+Be analytical but encouraging. Mention areas for improvement with tact.
+Respond in Spanish.

package/commands/hunt.md

@@ -0,0 +1,22 @@
+---
+description: Suggest optimal hunting spots based on character profile, objective, and party setup
+---
+
+Suggest the best hunting spots for $OPENCODE_CHARACTER_NAME (if known) or ask for level and vocation.
+
+Ask the player:
+1. Objective: exp / loot / profit / task
+2. Solo or party?
+3. Premium account?
+4. Any restrictions or preferences?
+
+Then provide 3-5 prioritized hunting spots with:
+- Location name and main creatures
+- Estimated exp/hour for their level and vocation
+- Estimated profit (positive or negative)
+- Access requirements (quests, level, etc.)
+- Vocation-specific tips
+- Solo viability
+
+Be specific with numbers. Use ranges when exact data isn't available.
+Respond in Spanish.

package/commands/profit.md

@@ -0,0 +1,22 @@
+---
+description: Calculate profit, waste, and experience per hour for a hunting session
+---
+
+Calculate profit and waste for a Tibia hunting session.
+
+Ask the player:
+1. Where did they hunt?
+2. How long? (minutes)
+3. How much did they spend on supplies? (gold)
+4. What did they loot? (list items or total value)
+5. How much experience did they gain? (optional)
+
+Then calculate and display:
+- Total waste (supplies cost)
+- Estimated loot value (use current market prices, not NPC prices)
+- Final balance (profit/loss with + or - symbol)
+- Experience gained and exp/hour
+- Spot evaluation: is it worth it for their profile?
+- Suggestions to improve results
+
+Use clear formatting with numbers. Respond in Spanish.

package/commands/quest.md

@@ -0,0 +1,23 @@
+---
+description: Recommend quests based on level, vocation, and player objectives
+---
+
+Recommend Tibia quests for the player's current character.
+
+Ask the player:
+1. What are they looking for? (zone access / outfit / achievement / equipment reward / story)
+2. Do they have a party available?
+3. Anything specific they want or quests already completed?
+
+Then provide 3-5 recommended quests with:
+- Quest name
+- Why it's relevant for their profile and objective
+- Minimum recommended level
+- Prerequisites (other quests, items, etc.)
+- Estimated difficulty (easy/medium/hard)
+- Main reward
+- Solo or party required?
+- Important tip or warning
+
+Prioritize quests with the best effort-to-reward ratio for their current situation.
+Respond in Spanish.

package/commands/set.md

@@ -0,0 +1,30 @@
+---
+description: Build optimal equipment sets with imbuements and supply recommendations
+---
+
+Build the optimal equipment set for the player's character.
+
+Ask the player:
+1. Situation: hunting / boss / pvp / training / specific quest
+2. Budget: low / moderate / competitive / best-in-slot
+3. Zone or creatures? (optional)
+4. Current equipment? (optional)
+
+Then provide:
+**SET RECOMMENDATION** — slot by slot:
+- Helmet / Armor / Legs / Boots / Shield / Weapon / Offhand / Amulet / Ring
+
+**IMBUEMENTS** — for each applicable piece:
+- Which imbu and why
+- Economy version vs ideal version
+
+**SUPPLIES** per hour of hunting:
+- Potions (type and quantity)
+- Runes (if applicable)
+- Food and other consumables
+
+**BUDGET-FRIENDLY ALTERNATIVES**:
+- Cheaper options for each critical slot
+
+Be specific with item names. Briefly explain key choices.
+Respond in Spanish.

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "tibiaway-ai",
+  "version": "1.0.0",
+  "description": "Tu guía de Tibia powered by AI. Your path through Tibia, powered by AI.",
+  "bin": {
+    "tibiaway": "./bin/tibiaway.js",
+    "tibiaway-ai": "./bin/tibiaway.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "tibia",
+    "mmorpg",
+    "ai",
+    "cli",
+    "gaming",
+    "assistant",
+    "tibiaway"
+  ],
+  "author": "TibiaWayAI",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.20.0",
+    "chalk": "^5.3.0",
+    "inquirer": "^9.2.0",
+    "node-fetch": "^3.3.0",
+    "ora": "^7.0.0"
+  },
+  "scripts": {
+    "start": "node bin/tibiaway.js",
+    "dev": "node --watch bin/tibiaway.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "agents/",
+    "commands/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tibiawayai/tibiaway-ai"
+  },
+  "homepage": "https://tibiawayai.com",
+  "bugs": {
+    "url": "https://github.com/tibiawayai/tibiaway-ai/issues"
+  }
+}