@gishubperu/ghp 0.0.1

package/.env

@@ -0,0 +1,13 @@
+# ── GH-PPA Gateway ───────────────────────────────────────────────────────────
+# Modelos gratis funcionan SIN key (200 req/hora)
+# Para más límites, regístrate en https://kilo.ai y obtén tu key gratis
+GH_PPA_KEY=
+
+# ── APIs directas (opcionales) ────────────────────────────────────────────────
+GEMINI_API_KEY=       # https://aistudio.google.com (gratis)
+ANTHROPIC_API_KEY=    # https://console.anthropic.com
+OPENAI_API_KEY=       # https://platform.openai.com
+
+# ── Ollama local (opcional) ───────────────────────────────────────────────────
+# Instalar: https://ollama.com → ollama pull llama3.2
+OLLAMA_HOST=http://localhost:11434

package/domain/contracts/IAgent.js

@@ -0,0 +1,3 @@
+// domain/contracts/IAgent.js
+// @typedef {{ run(input: string): Promise<{text: string, model: string}> }} IAgent
+export default {};

package/domain/contracts/IMemoryStore.js

@@ -0,0 +1,3 @@
+// domain/contracts/IMemoryStore.js
+// @typedef {{ init, save, recall, recent, clear, getBuffer, pushTurn, clearBuffer }} IMemoryStore
+export default {};

package/domain/contracts/IModelProvider.js

@@ -0,0 +1,3 @@
+// domain/contracts/IModelProvider.js
+// @typedef {{ init, isAvailable, chat({model,messages,tools,systemPrompt}) }} IModelProvider
+export default {};

package/domain/contracts/IToolset.js

@@ -0,0 +1,3 @@
+// domain/contracts/IToolset.js
+// @typedef {{ declarations: ToolDeclaration[], execute(name, args): Promise<any> }} IToolset
+export default {};

package/domain/dtos/requests/RunAgentRequest.js

@@ -0,0 +1,8 @@
+// domain/dtos/requests/RunAgentRequest.js
+export class RunAgentRequest {
+    constructor({ input, agentId = 'auto', onProgress = null }) {
+        this.input      = input;
+        this.agentId    = agentId;
+        this.onProgress = onProgress;
+    }
+}

package/domain/dtos/responses/AgentResponse.js

@@ -0,0 +1,8 @@
+// domain/dtos/responses/AgentResponse.js
+export class AgentResponse {
+    constructor({ text, model, elapsed = null }) {
+        this.text    = text;
+        this.model   = model;
+        this.elapsed = elapsed;
+    }
+}

package/domain/dtos/responses/ToolResult.js

@@ -0,0 +1,8 @@
+// domain/dtos/responses/ToolResult.js
+export class ToolResult {
+    constructor({ toolName, result, error = null }) {
+        this.toolName = toolName;
+        this.result   = result;
+        this.error    = error;
+    }
+}

package/domain/entities/AgentDefinition.js

@@ -0,0 +1,11 @@
+// domain/entities/AgentDefinition.js
+export class AgentDefinition {
+    constructor({ id, label, desc, color, taskType, systemPrompt }) {
+        this.id           = id;
+        this.label        = label;
+        this.desc         = desc;
+        this.color        = color;
+        this.taskType     = taskType;
+        this.systemPrompt = systemPrompt;
+    }
+}

package/domain/entities/Message.js

@@ -0,0 +1,10 @@
+// domain/entities/Message.js
+// Entidad: un turno de conversación
+export class Message {
+    constructor({ role, content, toolCalls = null, tool_call_id = null }) {
+        this.role         = role;          // 'user' | 'assistant' | 'tool' | 'system'
+        this.content      = content;
+        this.toolCalls    = toolCalls;     // solo cuando el modelo pide tools
+        this.tool_call_id = tool_call_id;  // solo para role='tool'
+    }
+}

package/domain/entities/ModelInfo.js

@@ -0,0 +1,11 @@
+// domain/entities/ModelInfo.js
+export class ModelInfo {
+    constructor({ id, name, provider, free = false, gateway = false, contextLength = null }) {
+        this.id            = id;
+        this.name          = name;
+        this.provider      = provider;
+        this.free          = free;
+        this.gateway       = gateway;
+        this.contextLength = contextLength;
+    }
+}

package/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+import { execSync }  from 'child_process';
+import React         from 'react';
+import { render }    from 'ink';
+
+import { App }          from './presentation/console/procedures/App.js';
+import { Orchestrator } from './infrastructure/core/orchestrator.js';
+import { MemoryStore }  from './infrastructure/memory/store.js';
+import { ModelRouter }  from './infrastructure/router/router.js';
+import { TaskQueue }    from './infrastructure/core/queue.js';
+import { WorkerPool }   from './infrastructure/core/workers.js';
+import { toolset }      from './infrastructure/tools/arcgis.js';
+
+// ── CLI args ──────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
+  🧠 Chakra Yachay — GHP Multi-Agent System
+
+  USO:
+    ghp          Inicia la interfaz interactiva
+    chy                    Alias corto
+    ghp --help   Esta ayuda
+    ghp --version Versión
+
+  ATAJOS EN LA INTERFAZ:
+    Tab          Cambiar agente (Auto / GIS / Code / Data / Reasoning)
+    ctrl+k       Selector de modelo
+    /model       Selector de modelo
+    /auto        Modo automático
+    /clear       Borrar memoria de sesión
+    /history     Últimas conversaciones
+    Esc          Cancelar / Salir
+    /exit        Salir
+    `);
+    process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+    const pkg = await import('./package.json', { assert: { type: 'json' } });
+    console.log(`v${pkg.default.version}`);
+    process.exit(0);
+}
+
+// ── Limpiar pantalla ──────────────────────────────────────────────────────────
+try {
+    if (process.platform === 'win32') execSync('cls', { stdio: 'inherit' });
+    else process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+} catch { process.stdout.write('\x1b[2J\x1b[3J\x1b[H'); }
+
+// ── Bootstrap ─────────────────────────────────────────────────────────────────
+const memory     = new MemoryStore();
+const router     = new ModelRouter();
+const queue      = new TaskQueue();
+const workerPool = new WorkerPool({ workers: 4, router, memory, toolset });
+const orch       = new Orchestrator({ queue, workerPool, router, memory, toolset });
+
+await memory.init();
+await router.init();
+
+render(React.createElement(App, { orchestrator: orch, router, memory }), {
+    exitOnCtrlC: true,
+});

package/infrastructure/agents/agent-factory.js

@@ -0,0 +1,79 @@
+// infrastructure/agents/agent-factory.js
+// Factory for creating agent instances
+
+import { BaseAgent } from './base_agent.js';
+import { AgentType, SystemPrompts, AgentConfig } from '../constants/index.js';
+
+class AgricultureAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.AGRICULTURE].taskType,
+            systemPrompt: SystemPrompts[AgentType.AGRICULTURE],
+        });
+    }
+}
+
+class MinningAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.MINNING].taskType,
+            systemPrompt: SystemPrompts[AgentType.MINNING],
+        });
+    }
+}
+
+class DeforestationAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.DEFORESTATION].taskType,
+            systemPrompt: SystemPrompts[AgentType.DEFORESTATION],
+        });
+    }
+}
+
+class GeneralAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.GENERAL].taskType,
+            systemPrompt: SystemPrompts[AgentType.GENERAL],
+        });
+    }
+}
+
+class AutoAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.AUTO].taskType,
+            systemPrompt: SystemPrompts[AgentType.AUTO],
+        });
+    }
+}
+
+const AGENT_CLASSES = Object.freeze({
+    [AgentType.AGRICULTURE]:   AgricultureAgent,
+    [AgentType.MINNING]:       MinningAgent,
+    [AgentType.DEFORESTATION]: DeforestationAgent,
+    [AgentType.GENERAL]:       GeneralAgent,
+    [AgentType.AUTO]:          AutoAgent,
+});
+
+export class AgentFactory {
+    static create(type, options) {
+        const AgentClass = AGENT_CLASSES[type];
+        if (!AgentClass) {
+            throw new Error(`Unknown agent type: ${type}`);
+        }
+        return new AgentClass(options);
+    }
+
+    static getAvailableTypes() {
+        return Object.keys(AGENT_CLASSES);
+    }
+}
+
+export default AgentFactory;

package/infrastructure/agents/agriculture_agent.js

@@ -0,0 +1,13 @@
+// infrastructure/agents/agriculture_agent.js
+import { BaseAgent } from './base_agent.js';
+import { AgentType, SystemPrompts, AgentConfig } from '../constants/index.js';
+
+export class AgricultureAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.AGRICULTURE].taskType,
+            systemPrompt: SystemPrompts[AgentType.AGRICULTURE],
+        });
+    }
+}

package/infrastructure/agents/base_agent.js

@@ -0,0 +1,19 @@
+// infrastructure/agents/base.js
+
+export class BaseAgent {
+    constructor({ router, memory, taskType, systemPrompt }) {
+        this.router       = router;
+        this.memory       = memory;
+        this.taskType     = taskType;
+        this.systemPrompt = systemPrompt;
+    }
+
+    async run(input, { signal } = {}) {
+        return this.router.chat({
+            taskType:     this.taskType,
+            systemPrompt: this.systemPrompt,
+            messages:     [{ role: 'user', content: input }],
+            signal,
+        });
+    }
+}

package/infrastructure/agents/deforestacion_agent.js

@@ -0,0 +1,13 @@
+// infrastructure/agents/deforestacion_agent.js
+import { BaseAgent } from './base_agent.js';
+import { AgentType, SystemPrompts, AgentConfig } from '../constants/index.js';
+
+export class DeforestationAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.DEFORESTATION].taskType,
+            systemPrompt: SystemPrompts[AgentType.DEFORESTATION],
+        });
+    }
+}

package/infrastructure/agents/general_agent.js

@@ -0,0 +1,13 @@
+// infrastructure/agents/general_agent.js
+import { BaseAgent } from './base_agent.js';
+import { AgentType, SystemPrompts, AgentConfig } from '../constants/index.js';
+
+export class GeneralAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.GENERAL].taskType,
+            systemPrompt: SystemPrompts[AgentType.GENERAL],
+        });
+    }
+}

package/infrastructure/agents/minning_agent.js

@@ -0,0 +1,13 @@
+// infrastructure/agents/minning_agent.js
+import { BaseAgent } from './base_agent.js';
+import { AgentType, SystemPrompts, AgentConfig } from '../constants/index.js';
+
+export class MinningAgent extends BaseAgent {
+    constructor(opts) {
+        super({
+            ...opts,
+            taskType: AgentConfig[AgentType.MINNING].taskType,
+            systemPrompt: SystemPrompts[AgentType.MINNING],
+        });
+    }
+}

package/infrastructure/constants/agent-config.js

@@ -0,0 +1,48 @@
+// infrastructure/constants/agent-config.js
+// Agent configuration: labels, colors, descriptions, task types
+
+import { AgentType } from './agent-type.js';
+
+export const AgentConfig = Object.freeze({
+    [AgentType.AUTO]: {
+        id:          AgentType.AUTO,
+        label:       'Auto',
+        description: 'Routing automático',
+        color:       'cyan',
+        taskType:    'fast',
+    },
+    [AgentType.AGRICULTURE]: {
+        id:          AgentType.AGRICULTURE,
+        label:       'Agricultura',
+        description: 'Se utiliza el Padrón de productores agrario del Midagri, específicamente Áreas de cultivo',
+        color:       'green',
+        taskType:    'gis',
+    },
+    [AgentType.MINNING]: {
+        id:          AgentType.MINNING,
+        label:       'Minería',
+        description: 'Se utiliza el catastro minero  del Ingemmet',
+        color:       'yellow',
+        taskType:    'reasoning',
+    },
+    [AgentType.DEFORESTATION]: {
+        id:          AgentType.DEFORESTATION,
+        label:       'Deforestación',
+        description: 'Permitirá crear reportes de deforestación de las áreas de cultivo (PPA) con la plataforma de OpenForis',
+        color:       'magenta',
+        taskType:    'gis',
+    },
+    [AgentType.GENERAL]: {
+        id:          AgentType.GENERAL,
+        label:       'General',
+        description: 'Asistente general (Referencial)',
+        color:       'white',
+        taskType:    'fast',
+    },
+});
+
+export const AGENT_LIST = Object.freeze(
+    Object.values(AgentConfig)
+);
+
+export default AgentConfig;

package/infrastructure/constants/agent-type.js

@@ -0,0 +1,20 @@
+// infrastructure/constants/AgentType.js
+// Enumeration of available agent types
+
+export const AgentType = Object.freeze({
+    AUTO:          'auto',
+    AGRICULTURE:   'agriculture',
+    MINNING:       'minning',
+    DEFORESTATION: 'deforestation',
+    GENERAL:       'general',
+});
+
+export const AgentTypeArray = Object.freeze([
+    AgentType.AUTO,
+    AgentType.AGRICULTURE,
+    AgentType.MINNING,
+    AgentType.DEFORESTATION,
+    AgentType.GENERAL,
+]);
+
+export default AgentType;

package/infrastructure/constants/index.js

@@ -0,0 +1,8 @@
+// infrastructure/constants/index.js
+// Central export for all constants
+
+export { AgentType, AgentTypeArray } from './agent-type.js';
+export { AgentConfig, AGENT_LIST } from './agent-config.js';
+export { SystemPrompts, DEFAULT_SYSTEM_PROMPT } from './system-prompts.js';
+export { TaskType, TaskTypeArray } from './task-type.js';
+export { TASK_MODEL_MAP, FALLBACK_CHAIN, KNOWN_FREE_MODELS } from './model-config.js';

package/infrastructure/constants/model-config.js

@@ -0,0 +1,37 @@
+// infrastructure/constants/model-config.js
+// Model routing configuration
+
+import { TaskType } from './task-type.js';
+
+export const TASK_MODEL_MAP = Object.freeze({
+    [TaskType.CODE]:      { provider: 'gateway',   model: 'anthropic/claude-sonnet-4.5'        },
+    [TaskType.REASONING]: { provider: 'gateway',   model: 'corethink:free'                      },
+    [TaskType.GIS]:       { provider: 'gateway',   model: 'minimax/minimax-m2.1:free'           },
+    [TaskType.DATA]:      { provider: 'gateway',   model: 'minimax/minimax-m2.1:free'           },
+    [TaskType.FAST]:      { provider: 'gateway',   model: 'minimax/minimax-m2.1:free'           },
+    [TaskType.CHEAP]:     { provider: 'gateway',   model: 'giga-potato'                         },
+});
+
+export const FALLBACK_CHAIN = Object.freeze([
+    { provider: 'gateway',   model: 'minimax/minimax-m2.1:free'            },
+    { provider: 'gateway',   model: 'z-ai/glm-5:free'                      },
+    { provider: 'gateway',   model: 'arcee-ai/trinity-large-preview:free'  },
+    { provider: 'gateway',   model: 'giga-potato'                           },
+    { provider: 'gemini',    model: 'gemini-2.5-flash'                     },
+    { provider: 'anthropic', model: 'claude-haiku-4-5-20251001'            },
+]);
+
+export const KNOWN_FREE_MODELS = Object.freeze([
+    { id: 'minimax/minimax-m2.1:free',          name: 'MiniMax M2.1',          provider: 'minimax',   free: true,  gateway: true },
+    { id: 'z-ai/glm-5:free',                    name: 'Z.AI GLM-5',            provider: 'z-ai',      free: true,  gateway: true },
+    { id: 'giga-potato',                         name: 'Giga Potato',           provider: 'community', free: true,  gateway: true },
+    { id: 'corethink:free',                      name: 'CoreThink (Reasoning)', provider: 'corethink', free: true,  gateway: true },
+    { id: 'arcee-ai/trinity-large-preview:free', name: 'Arcee Trinity Large',  provider: 'arcee-ai', free: true,  gateway: true },
+    { id: 'anthropic/claude-sonnet-4.5',         name: 'Claude Sonnet 4.5',    provider: 'anthropic', free: false, gateway: true },
+    { id: 'anthropic/claude-haiku-4.5',          name: 'Claude Haiku 4.5',     provider: 'anthropic', free: false, gateway: true },
+    { id: 'openai/gpt-5.2',                      name: 'GPT-5.2',              provider: 'openai',    free: false, gateway: true },
+    { id: 'google/gemini-3-flash-preview',       name: 'Gemini 3 Flash',       provider: 'google',    free: false, gateway: true },
+    { id: 'moonshotai/kimi-k2.5',               name: 'Kimi K2.5',            provider: 'moonshot',  free: false, gateway: true },
+]);
+
+export default { TASK_MODEL_MAP, FALLBACK_CHAIN, KNOWN_FREE_MODELS };

package/infrastructure/constants/system-prompts.js

@@ -0,0 +1,88 @@
+// infrastructure/constants/system-prompts.js
+// Centralized system prompts for all agents
+
+import { AgentType } from './agent-type.js';
+
+export const SystemPrompts = Object.freeze({
+    [AgentType.AUTO]: `Eres Chakra Yachay, agente del Padrón de productores agrarios (PPA) del Perú.
+Tienes herramientas ArcGIS para consultar datos geoespaciales. Responde en español. Sé conciso y directo.`,
+
+    [AgentType.AGRICULTURE]: `Eres el agente de Agricultura de Chakra Yachay, especializado en el Padrón de productores agrarios (PPA) Perú.
+
+ESPECIALIDAD: Consultas sobre cultivos, áreas agrícolas, productores, campañas y alertas del programa PPA.
+
+FLUJO OBLIGATORIO:
+1. Identifica el tipo de consulta: ¿qué cultivos hay?, ¿cuántos productores?, ¿qué departamentos tienen más?, etc.
+2. Si la pregunta no es técnica responde al usuario sobre tu especialidad y finaliza.
+3. Llama getServiceMetadata PRIMERO si no conoces los campos exactos
+4. Strings en WHERE siempre con comillas simples: TXT_DEPARTAMENTO='PIURA'
+5. Para estadísticas usa outStatistics + groupByFieldsForStatistics
+6. Para contar: returnCountOnly=true — Para valores únicos: returnDistinctValues=true
+7. Si exceededTransferLimit=true → paginar con resultOffset
+8. Nunca mostrar JSON crudo — presentar en tablas y resúmenes legibles
+
+CAPACIDADES:
+- outStatistics: count/sum/min/max/avg por campo numérico
+- groupByFieldsForStatistics: agrupar por departamento, cultivo, campaña, etc.
+- having: filtrar grupos estadísticos
+- Paginación para grandes volúmenes
+
+CONTEXTO PPA:
+- Padrón de productores agrarios del Perú
+- Datos de alertas, registros de productores, áreas de cultivo
+- Cobertura nacional por departamento, provincia y distrito
+- Responde en español con análisis claro y tablas cuando sea apropiado`,
+
+    [AgentType.MINNING]: `Eres el agente de Minería de Chakra Yachay, especializado en análisis del sector minero peruano.
+
+ESPECIALIDAD: Concesiones mineras, impacto ambiental, conflictos sociales, producción mineral, minería ilegal (MAPE).
+
+CAPACIDADES:
+- Análisis de concesiones mineras por región (usando herramientas ArcGIS si están disponibles)
+- Evaluación de impacto ambiental en zonas mineras
+- Relación entre minería y actividad agrícola/deforestación
+- Identificación de zonas de conflicto socioambiental
+- Estadísticas de producción por mineral y región
+
+ENFOQUE:
+- Cruza datos mineros con datos agrícolas del PPA cuando sea relevante
+- Identifica superposición de concesiones con tierras agrícolas
+- Evalúa pasivos ambientales en cuencas hidrográficas
+- Responde en español con análisis técnico pero comprensible`,
+
+    [AgentType.DEFORESTATION]: `Eres el agente de Análisis de Deforestación de Chakra Yachay.
+
+ESPECIALIDAD: Detección, análisis y monitoreo de deforestación en el territorio peruano, con énfasis en Amazonía.
+
+FLUJO CON DATOS ARCGIS:
+1. Usa getServiceMetadata para explorar capas disponibles
+2. Consulta datos de cobertura boscosa, alertas de deforestación, cambio de uso de suelo
+3. Cruza con datos del PPA para identificar presión agrícola sobre bosques
+4. Usa outStatistics para calcular superficies afectadas por región
+
+ANÁLISIS CLAVE:
+- Tasa de deforestación por departamento y cuenca
+- Identificación de drivers: agricultura, minería, tala, infraestructura
+- Alertas tempranas de pérdida de cobertura boscosa
+- Zonas críticas: Loreto, Ucayali, San Martín, Madre de Dios, Amazonas
+- Relación deforestación — expansión de cultivos PPA
+- Impacto en comunidades nativas y áreas naturales protegidas
+
+MÉTRICAS IMPORTANTES:
+- Hectáreas deforestadas por período
+- Porcentaje de pérdida respecto a cobertura original
+- Velocidad de avance del frente de deforestación
+- Correlación con actividad agrícola registrada en PPA
+
+Responde en español con análisis geoespacial preciso, tablas de superficie y tendencias claras.`,
+
+    [AgentType.GENERAL]: `Eres Chakra Yachay, asistente general del sistema GHP para temas de minería y agricultura del Perú.
+
+Puedes ayudar con cualquier consulta relacionada al sector agrario, minero, ambiental o geoespacial peruano.
+Cuando necesites datos específicos, usa las herramientas ArcGIS disponibles.
+Responde en español de forma clara, directa y concisa.`,
+});
+
+export const DEFAULT_SYSTEM_PROMPT = SystemPrompts[AgentType.AUTO];
+
+export default SystemPrompts;

package/infrastructure/constants/task-type.js

@@ -0,0 +1,22 @@
+// infrastructure/constants/TaskType.js
+// Enumeration of task types for model routing
+
+export const TaskType = Object.freeze({
+    FAST:       'fast',
+    GIS:        'gis',
+    CODE:       'code',
+    REASONING:  'reasoning',
+    DATA:       'data',
+    CHEAP:      'cheap',
+});
+
+export const TaskTypeArray = Object.freeze([
+    TaskType.FAST,
+    TaskType.GIS,
+    TaskType.CODE,
+    TaskType.REASONING,
+    TaskType.DATA,
+    TaskType.CHEAP,
+]);
+
+export default TaskType;