Pemecahan Masalah

Periksa versi yang terpasang

snsagent --version
snsagent --help

Versi yang diharapkan untuk rilis ini:

snsagent 0.3.9

Biner terkompilasi menampilkan TUI kosong / “JS-only mode”

Biner terkompilasi (./bin/snsagent-linux-x64, dan biner yang diinstal npm) mencetak:

[pi-natives] JS-only mode: native addon unavailable for linux-x64 (modern)
[pi-natives] Native features (grep, pty, shell, clipboard, syntax highlighting, etc.) are disabled.

dan TUI interaktif tidak tampil. Bundle terkompilasi tidak menyematkan addon native .node, jadi fitur terminal native nonaktif.

Catatan: ini batasan yang diketahui dari biner terkompilasi, bukan crash. Biner yang diinstal npm berperilaku sama karena bundle tidak menyematkan addon native.

Solusi: jalankan dari source dengan Bun, yang memuat addon native secara normal:

bun install
bun run src/cli/entry.ts

command not found: snsagent

Periksa apakah paket terinstal secara global:

npm ls -g --depth=0
command -v snsagent

Instal dengan:

npm install -g @sns-myagent/cli

Error provider atau model

Jalankan /setup di agen interaktif, lalu verifikasi Base URL, tipe API, ID model, dan kredensial. Untuk setup manual, periksa ~/.omp/agent/models.yml tanpa mencetak nilai rahasia.

Tidak ada model yang dipilih

Periksa definisi provider dan penugasan role:

/model

Jika orkestrasi terlibat, verifikasi modelRoles.default di ~/.omp/agent/config.yml.

Permission denied untuk biner hasil build source

Hanya untuk biner yang dibangun dari source:

chmod +x bin/snsagent-linux-x64
./bin/snsagent-linux-x64 --version

Bun tidak ada

Bun diperlukan untuk eksekusi source dan build, tetapi tidak untuk instalasi npm normal. Instal Bun saat menggunakan mode source:

curl -fsSL https://bun.sh/install | bash
export PATH="$HOME/.bun/bin:$PATH"

Database memory terkunci

Peringatan: hentikan snsagent sebelum menyalin atau memperbaiki state SQLite, dan jangan hapus file journal saat proses lain berjalan. Periksa proses aktif dulu:

pgrep -af snsagent

Agen interaktif menyimpan state di bawah ~/.omp/agent. Database mnemopi berada di bawah pohon memories/ direktori tersebut.

Telegram tidak merespons

Periksa status adapter dan sumber token:

snsagent telegram status

Untuk service, verifikasi SNS_TELEGRAM_BOT_TOKEN di /etc/snsagent/secrets.env dan periksa:

sudo systemctl status snsagent
journalctl -u snsagent -e

Masalah build

bun install
bun run check
bun run build

Jika dependency native opsional gagal saat instalasi, coba lagi dengan versi Bun yang didukung repository dan periksa error modul native pertama sebelum menghapus file.

Masih buntu?

Buka issue di https://github.com/Reihantt6/sns-myagent/issues dengan perintah persis, output, sistem operasi, versi Node atau Bun, dan ringkasan konfigurasi yang di-redaksi.