@mazees/mark 5.0.0

package/src/renderer/src/api/tools/core-tools.js

@@ -0,0 +1,707 @@
+/**
+ * Core Built-in Tools Schema untuk MARK V5 (OpenAI-compatible OpenAPI Function Definition).
+ * Seluruh nama tool mempertahankan format kebab-case (100% valid sesuai regex OpenAI ^[a-zA-Z0-9_-]{1,64}$).
+ */
+export const core_tools_schema = [
+  {
+    type: 'function',
+    function: {
+      name: 'browser-search',
+      description:
+        'HANYA untuk mencari dan menemukan URL / link website yang relevan dengan kata kunci (bukan untuk membaca isi artikel lengkap). Mengembalikan daftar judul & URL. Untuk membaca isi konten lengkap dari URL yang ditemukan, gunakan tool "browser-fetch".',
+      parameters: {
+        type: 'object',
+        properties: {
+          query: {
+            type: 'string',
+            description:
+              'Kata kunci pencarian web (misal: "gpt 6 astra", "kebakaran kalimantan 2026")'
+          }
+        },
+        required: ['query'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'browser-fetch',
+      description:
+        'Membaca dan mengambil (curl/fetch) isi konten teks/artikel dari suatu URL secara instan tanpa perlu membuka jendela browser fisik. Sangat cepat untuk membaca isi berita, dokumentasi, atau artikel web.',
+      parameters: {
+        type: 'object',
+        properties: {
+          url: {
+            type: 'string',
+            description: 'URL web yang ingin dibaca isinya (misal: "https://example.com/artikel")'
+          },
+          max_chars: {
+            type: 'number',
+            description:
+              'Batas maksimal karakter teks yang diekstrak (default 4000, maksimal 12000)'
+          }
+        },
+        required: ['url'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read-tools',
+      description:
+        'WAJIB dipanggil jika kamu membutuhkan dokumentasi atau fungsi tambahan dari grup tool tertentu sebelum mengeksekusinya.',
+      parameters: {
+        type: 'object',
+        properties: {
+          group_name: {
+            type: 'string',
+            description: 'Nama grup tool bawaan atau plugin yang ingin dibaca.'
+          }
+        },
+        required: ['group_name'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'manage-memory',
+      description:
+        'Menyimpan, memperbarui, atau menghapus fakta profil, preferensi user, atau catatan penting ke memori jangka panjang.',
+      parameters: {
+        type: 'object',
+        properties: {
+          action: {
+            type: 'string',
+            enum: ['insert', 'update', 'delete'],
+            description: 'Aksi database memori'
+          },
+          type: {
+            type: 'string',
+            enum: ['profile', 'preference', 'notes'],
+            description: 'Kategori memori'
+          },
+          summary: {
+            type: 'string',
+            description: 'Ringkasan singkat memori'
+          },
+          detail: {
+            type: 'string',
+            description: 'Detail konten fakta atau catatan yang disimpan'
+          }
+        },
+        required: ['action', 'type', 'summary', 'detail'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'update-working-memory',
+      description:
+        'Menyimpan atau memperbarui catatan ringkas progres koding, lokasi baris/fungsi yang telah dipetakan ke .mark/working-memory.json.',
+      parameters: {
+        type: 'object',
+        properties: {
+          notes: {
+            type: 'string',
+            description: 'Catatan progres koding atau rencana kerja teknis'
+          }
+        },
+        required: ['notes'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'memory-search',
+      description:
+        'Mencari ingatan masa lalu, preferensi/catatan user, solusi historis, dan riwayat chat percakapan asli.',
+      parameters: {
+        type: 'object',
+        properties: {
+          query: {
+            type: 'string',
+            description: 'Kata kunci pencarian memori'
+          },
+          threshold: {
+            type: 'number',
+            description: 'Tingkat kemiripan (0.1 - 0.9, default 0.5)'
+          },
+          limit: {
+            type: 'number',
+            description: 'Jumlah maksimal data yang diambil (default 5)'
+          }
+        },
+        required: ['query'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read-file',
+      description: 'Membaca isi berkas teks dari workspace atau sistem operasi.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path absolut atau relatif berkas yang akan dibaca'
+          },
+          start_line: {
+            type: 'number',
+            description: 'Nomor baris awal (opsional)'
+          },
+          end_line: {
+            type: 'number',
+            description: 'Nomor baris akhir (opsional)'
+          }
+        },
+        required: ['path'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read-image',
+      description:
+        'Membaca berkas gambar lokal (.png, .jpg, .jpeg, .webp, .gif, dll.) dari workspace atau sistem operasi di luar chat. DILARANG menggunakan tool ini jika gambar sudah dilampirkan langsung di chat (temp-uploads), karena sudah terlihat langsung di visual context.',
+      parameters: {
+        type: 'object',
+        properties: {
+          file_path: {
+            type: 'string',
+            description: 'Path absolut atau relatif berkas gambar yang akan dibaca'
+          },
+          query: {
+            type: 'string',
+            description:
+              'Instruksi atau pertanyaan tentang apa yang ingin kamu analisis dari gambar (opsional)'
+          }
+        },
+        required: ['file_path'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'write-file',
+      description: 'Membuat berkas baru atau menulis ulang berkas dari nol.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas tujuan'
+          },
+          content: {
+            type: 'string',
+            description: 'Konten teks lengkap berkas'
+          }
+        },
+        required: ['path', 'content'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'replace-content',
+      description:
+        'Mengedit berkas kode dengan mencocokkan teks lama dan menggantinya secara presisi.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas yang akan diedit'
+          },
+          target_content: {
+            type: 'string',
+            description: 'Teks lama yang akan diganti'
+          },
+          replacement_content: {
+            type: 'string',
+            description: 'Teks baru pengganti'
+          }
+        },
+        required: ['path', 'target_content', 'replacement_content'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'replace-lines',
+      description: 'Mengedit baris tertentu pada berkas berdasarkan nomor baris.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas yang akan diedit'
+          },
+          start_line: {
+            type: 'number',
+            description: 'Nomor baris awal'
+          },
+          end_line: {
+            type: 'number',
+            description: 'Nomor baris akhir'
+          },
+          new_code: {
+            type: 'string',
+            description: 'Kode baru pengganti'
+          }
+        },
+        required: ['path', 'start_line', 'end_line', 'new_code'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'delete-file',
+      description: 'Menghapus berkas dari sistem operasi.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas yang akan dihapus'
+          }
+        },
+        required: ['path'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'list-dir',
+      description: 'Melihat daftar isi folder langsung (1 level).',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path folder (kosongkan untuk root workspace)'
+          }
+        },
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'find-files',
+      description:
+        'Mencari berkas di seluruh subfolder secara rekursif dengan filter nama/ekstensi glob.',
+      parameters: {
+        type: 'object',
+        properties: {
+          pattern: {
+            type: 'string',
+            description: 'Pola glob pencarian (misal: "*.jsx" atau "*.ts")'
+          },
+          subfolder: {
+            type: 'string',
+            description: 'Subfolder target pencarian'
+          }
+        },
+        required: ['pattern'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'grep-search',
+      description:
+        'Mencari kata kunci atau regex di dalam satu berkas spesifik maupun seluruh berkas dalam folder secara rekursif. Mengembalikan nomor baris dan cuplikan kode yang cocok.',
+      parameters: {
+        type: 'object',
+        properties: {
+          keyword: {
+            type: 'string',
+            description: 'Kata kunci teks atau pola yang dicari'
+          },
+          path: {
+            type: 'string',
+            description:
+              'Path berkas spesifik (misal: "minecraft_2d.html") ATAU folder target (kosongkan untuk root workspace)'
+          }
+        },
+        required: ['keyword'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'file-outline',
+      description:
+        'Melihat peta dan struktur berkas (fungsi, class, heading) tanpa membaca seluruh isi.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas kode'
+          }
+        },
+        required: ['path'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read-document',
+      description: 'Membaca dan mencari isi dokumen teks, PDF, atau DOCX.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: {
+            type: 'string',
+            description: 'Path berkas dokumen'
+          },
+          keyword: {
+            type: 'string',
+            description: 'Kata kunci pencarian spesifik di dalam dokumen'
+          }
+        },
+        required: ['path'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read-skill',
+      description:
+        'Membaca file pedoman skill untuk memuat instruksi dan workflow khusus sebelum eksekusi aksi.',
+      parameters: {
+        type: 'object',
+        properties: {
+          skill_name: {
+            type: 'string',
+            description: 'Nama skill yang ingin dibaca (misal: "speedrunner", "git-commit")'
+          }
+        },
+        required: ['skill_name'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'open',
+      description:
+        'Membuka aplikasi Windows via shell execute atau membuka URL di browser default.',
+      parameters: {
+        type: 'object',
+        properties: {
+          target: {
+            type: 'string',
+            description: 'Nama executable/path atau URL web'
+          }
+        },
+        required: ['target'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'run-powershell',
+      description: 'Menjalankan perintah terminal PowerShell Windows.',
+      parameters: {
+        type: 'object',
+        properties: {
+          command: {
+            type: 'string',
+            description: 'Perintah PowerShell satu baris'
+          }
+        },
+        required: ['command'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'spawn_subagent',
+      description:
+        'Mendelegasikan tugas ke sub-agent baru yang bekerja mandiri di background secara non-blocking. Sub-agent akan mengeksekusi misi dan melapor kembali secara otomatis via push notification tanpa Lead Agent perlu memanggil wait_subagents.',
+      parameters: {
+        type: 'object',
+        properties: {
+          name: {
+            type: 'string',
+            description: 'Nama sub-agent spesialis (misal: "Developer", "Mr Tester", "Researcher")'
+          },
+          role: { type: 'string', description: 'Peran sub-agent' },
+          goal: { type: 'string', description: 'Tujuan utama sub-agent' },
+          initial_message: {
+            type: 'string',
+            description: 'Pesan instruksi awal tugas yang didelegasikan'
+          },
+          tools: {
+            type: 'string',
+            description: 'Daftar tool yang diizinkan (dipisah koma, atau "*")'
+          }
+        },
+        required: ['name', 'role', 'goal', 'initial_message'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'message_agent',
+      description:
+        'Mengirim pesan atau instruksi teknis langsung ke sub-agent spesialis lain (atau membalas sub-agent) dan menerima responnya.',
+      parameters: {
+        type: 'object',
+        properties: {
+          target_agent: {
+            type: 'string',
+            description:
+              'Nama atau ID sub-agent tujuan (misal: "Developer", "Mr Tester", atau "sub_xxx")'
+          },
+          message: { type: 'string', description: 'Pesan, instruksi, atau pertanyaan teknis' }
+        },
+        required: ['target_agent', 'message'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'send_message',
+      description: 'Mengirim pesan instruksi atau evaluasi ke Sub-Agent aktif.',
+      parameters: {
+        type: 'object',
+        properties: {
+          subagent_id: { type: 'string', description: 'ID sub-agent tujuan' },
+          message: { type: 'string', description: 'Pesan instruksi' }
+        },
+        required: ['subagent_id', 'message'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'list_subagents',
+      description:
+        'Melihat daftar seluruh sub-agent yang sedang aktif atau sudah selesai beserta statusnya.',
+      parameters: {
+        type: 'object',
+        properties: {
+          status: { type: 'string', description: 'Filter status (running/idle/completed)' }
+        },
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'report_to_lead',
+      description:
+        'Melaporkan hasil akhir misi, rangkuman eksekusi, atau temuan penting langsung ke Lead Agent (Mark) dan memicu push notification di chat utama.',
+      parameters: {
+        type: 'object',
+        properties: {
+          summary: {
+            type: 'string',
+            description: 'Rangkuman lengkap hasil pekerjaan yang telah selesai'
+          },
+          artifact: {
+            type: 'string',
+            description: 'Path berkas atau artefak yang berhasil dibuat/dimodifikasi jika ada'
+          }
+        },
+        required: ['summary'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'create_agent_task',
+      description:
+        'Membuat dan mengaktifkan rencana alur kerja tugas multi-tahap (Task Workflow) terstruktur dengan sasaran utama dan target deliverable per tahap.',
+      parameters: {
+        type: 'object',
+        properties: {
+          title: { type: 'string', description: 'Judul tugas utama' },
+          objective: {
+            type: 'string',
+            description: 'Tujuan akhir penyelesaian tugas secara menyeluruh'
+          },
+          steps: {
+            type: 'array',
+            description: 'Daftar langkah/tahapan pengerjaan terstruktur',
+            items: {
+              type: 'object',
+              properties: {
+                id: { type: 'string', description: 'ID unik tahap (misal: "step-1")' },
+                title: { type: 'string', description: 'Nama tahapan' },
+                objective: {
+                  type: 'string',
+                  description: 'Sasaran khusus yang harus dicapai pada langkah ini'
+                },
+                deliverable: {
+                  type: 'string',
+                  description: 'Keluaran konkret atau berkas bukti hasil pengerjaan tahap'
+                },
+                acceptanceCriteria: {
+                  type: 'array',
+                  items: { type: 'string' },
+                  description: 'Kriteria kelayakan selesainya tahap ini'
+                }
+              },
+              required: ['id', 'title', 'objective', 'deliverable']
+            }
+          }
+        },
+        required: ['title', 'objective', 'steps'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'mark_done_task',
+      description:
+        'Menandai tahap aktif tugas alur kerja (Task Workflow) telah 100% selesai dan teruji secara final, menulis berkas deliverable artefak markdown (.md), dan memajukan alur kerja ke tahap berikutnya. DILARANG memanggil tool ini untuk menyimpan draf atau progress cicilan; panggil hanya TEPAT 1 KALI di akhir tahap.',
+      parameters: {
+        type: 'object',
+        properties: {
+          taskId: {
+            type: 'string',
+            description:
+              'ID unik alur kerja yang sedang berjalan (opsional jika alur kerja sedang aktif)'
+          },
+          stepIndex: {
+            type: 'integer',
+            description:
+              'Nomor indeks tahap yang diselesaikan (1-based, misal: 1 untuk tahap 1, 2 untuk tahap 2). Wajib diisi sesuai tahap yang dituntaskan.'
+          },
+          artifactContent: {
+            type: 'string',
+            description: 'Isi konten dokumen markdown (.md) deliverable hasil pengerjaan tahap ini'
+          },
+          verificationProof: {
+            type: 'string',
+            description:
+              'Bukti verifikasi dan hasil pengujian konkret bahwa deliverable tahap ini berfungsi dan memenuhi kriteria (misal: log hasil test terminal, verifikasi isi file, atau pemeriksaan sintaks). Wajib disertakan sebelum tahap ditandai selesai.'
+          },
+          summary: {
+            type: 'string',
+            description:
+              'Ringkasan apa yang telah diselesaikan pada tahap ini. Pada tahap terakhir alur kerja, parameter ini WAJIB memuat rangkuman menyeluruh dari awal hingga akhir proyek sebagai laporan penutup final untuk pengguna.'
+          }
+        },
+        required: ['stepIndex', 'artifactContent', 'verificationProof'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'read_task',
+      description:
+        'Membaca status alur kerja tugas (Task Workflow) dan isi artefak markdown dari tahap-tahap yang telah diselesaikan.',
+      parameters: {
+        type: 'object',
+        properties: {
+          taskId: { type: 'string', description: 'ID unik alur kerja yang ingin dibaca' },
+          stepIndex: {
+            type: 'integer',
+            description:
+              'Nomor indeks tahap yang ingin dibaca artefaknya (1-based, opsional. Jika kosong akan membaca seluruh ringkasan alur kerja)'
+          }
+        },
+        required: ['taskId'],
+        additionalProperties: false
+      }
+    }
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'kill_subagent',
+      description: 'Menghentikan paksa eksekusi sub-agent yang sedang berjalan.',
+      parameters: {
+        type: 'object',
+        properties: {
+          subagent_id: { type: 'string', description: 'ID sub-agent yang akan dihentikan' },
+          reason: { type: 'string', description: 'Alasan penghentian' }
+        },
+        required: ['subagent_id'],
+        additionalProperties: false
+      }
+    }
+  }
+]
+
+// Injeksi parameter reason ke seluruh core tools agar model selalu memberikan alasan natural
+for (const t of core_tools_schema) {
+  if (t.function?.parameters?.properties) {
+    if (!t.function.parameters.properties.reason) {
+      t.function.parameters.properties.reason = {
+        type: 'string',
+        description:
+          'Penjelasan ringkas dalam bahasa manusia mengenai alasan atau tujuan aksi ini (contoh: "Membuka tab Instagram di browser").'
+      }
+    }
+    if (Array.isArray(t.function.parameters.required)) {
+      if (!t.function.parameters.required.includes('reason')) {
+        t.function.parameters.required.push('reason')
+      }
+    } else {
+      t.function.parameters.required = ['reason']
+    }
+  }
+}
+
+// Legacy dictionary representation for backwards-compatibility
+export const core_tools = core_tools_schema.reduce((acc, t) => {
+  acc[t.function.name] = t.function.description
+  return acc
+}, {})