@johpaz/hive-core 1.0.6 → 1.0.7

package/src/tools/workspace.ts

@@ -0,0 +1,171 @@
+import type { Tool } from "./registry.ts";
+import type { WorkspaceLoader } from "../agent/workspace";
+
+export function createWorkspaceTools(loader: WorkspaceLoader): Tool[] {
+  return [
+    {
+      name: "workspace_read",
+      description:
+        "Lee el contenido actual de SOUL.md (tu identidad), " +
+        "USER.md (contexto del usuario) o ETHICS.md (lineamientos éticos). " +
+        "Usa esta herramienta cuando necesites consultar tu configuración actual " +
+        "o verificar qué información tienes sobre el usuario.",
+      parameters: {
+        type: "object",
+        properties: {
+          file: {
+            type: "string",
+            enum: ["soul", "user", "ethics"],
+            description:
+              "soul = tu identidad y personalidad, " +
+              "user = información sobre el usuario, " +
+              "ethics = lineamientos éticos (solo lectura)",
+          },
+        },
+        required: ["file"],
+      },
+      execute: async (params: Record<string, unknown>) => {
+        const file = params.file as "soul" | "user" | "ethics";
+        const content = await loader.read(file);
+        return {
+          file,
+          content,
+          length: content.length,
+        };
+      },
+    },
+
+    {
+      name: "workspace_write",
+      description:
+        "Reescribe completamente SOUL.md o USER.md. " +
+        "Usa esta herramienta solo cuando necesites hacer cambios extensos. " +
+        "Para cambios pequeños, usa workspace_patch en su lugar. " +
+        "NUNCA puedes escribir en ETHICS.md.",
+      parameters: {
+        type: "object",
+        properties: {
+          file: {
+            type: "string",
+            enum: ["soul", "user"],
+            description: "El archivo a escribir. ETHICS.md no está permitido.",
+          },
+          content: {
+            type: "string",
+            description: "El contenido completo del archivo en formato Markdown.",
+          },
+          reason: {
+            type: "string",
+            description:
+              "Razón del cambio. Se registra en los logs. " +
+              "Ej: 'Usuario indicó nueva ubicación'",
+          },
+        },
+        required: ["file", "content", "reason"],
+      },
+      execute: async (params: Record<string, unknown>) => {
+        const file = params.file as "soul" | "user";
+        const content = params.content as string;
+        const reason = params.reason as string;
+        await loader.write(file, content);
+        return {
+          ok: true,
+          file,
+          reason,
+          savedAt: new Date().toISOString(),
+          message: `${file}.md actualizado correctamente`,
+        };
+      },
+    },
+
+    {
+      name: "workspace_patch",
+      description:
+        "Modifica una sección específica de SOUL.md o USER.md " +
+        "sin reescribir el archivo completo. " +
+        "Esta es la herramienta preferida para cambios pequeños y precisos. " +
+        "La sección se identifica por su encabezado Markdown (## Sección). " +
+        "Si la sección no existe, se crea al final del archivo.",
+      parameters: {
+        type: "object",
+        properties: {
+          file: {
+            type: "string",
+            enum: ["soul", "user"],
+            description: "El archivo a modificar.",
+          },
+          section: {
+            type: "string",
+            description:
+              "El nombre de la sección a modificar, sin los ## del encabezado. " +
+              "Ej: 'Ubicación', 'Preferencias', 'Trabajo'",
+          },
+          newContent: {
+            type: "string",
+            description: "El nuevo contenido de esa sección en Markdown.",
+          },
+          reason: {
+            type: "string",
+            description: "Razón del cambio para el registro de logs.",
+          },
+        },
+        required: ["file", "section", "newContent", "reason"],
+      },
+      execute: async (params: Record<string, unknown>) => {
+        const file = params.file as "soul" | "user";
+        const section = params.section as string;
+        const newContent = params.newContent as string;
+        const reason = params.reason as string;
+        await loader.patch(file, section, newContent);
+        return {
+          ok: true,
+          file,
+          section,
+          reason,
+          savedAt: new Date().toISOString(),
+          message: `Sección "${section}" de ${file}.md actualizada`,
+        };
+      },
+    },
+
+    {
+      name: "workspace_append",
+      description:
+        "Añade nueva información a una sección de USER.md " +
+        "sin eliminar el contenido existente. " +
+        "Ideal para acumular información sobre el usuario con el tiempo.",
+      parameters: {
+        type: "object",
+        properties: {
+          section: {
+            type: "string",
+            description: "El nombre de la sección donde añadir la información.",
+          },
+          content: {
+            type: "string",
+            description: "La información a añadir.",
+          },
+          reason: {
+            type: "string",
+            description: "Por qué se añade esta información.",
+          },
+        },
+        required: ["section", "content", "reason"],
+      },
+      execute: async (params: Record<string, unknown>) => {
+        const section = params.section as string;
+        const content = params.content as string;
+        const reason = params.reason as string;
+        await loader.append("user", section, content);
+        return {
+          ok: true,
+          file: "user",
+          section,
+          reason,
+          savedAt: new Date().toISOString(),
+          message: `Información añadida a la sección "${section}" de USER.md`,
+        };
+      },
+    },
+  ];
+}