osFoundry / Platform
Hot replay & riwayat
Setiap channel menyimpan event N hari terakhir. Reset cursor, replay dari seq id mana pun.
Apa itu
Hot replay dan riwayat adalah log event per channel di osFoundry. Setiap channel, yaitu stream di balik chat, agent, dan tool Anda, menyimpan event N hari terakhir, dan setiap event membawa sequence id monoton (seq id). Consumer membaca maju dengan melacak cursor yang menunjuk ke seq id terakhir yang mereka proses. Karena jendela terkini dijaga tetap hot, Anda tidak perlu memperlakukan channel sebagai stream fire-and-forget: riwayatnya ada di sana untuk dibaca ulang.
Operasi intinya sederhana. Pindahkan cursor kembali ke seq id mana pun lalu replay dari titik itu. Agent yang crash di tengah run, consumer baru yang baru saja bergabung ke channel, atau tool yang salah memproses event, semuanya bisa membaca ulang urutan yang persis sama, alih-alih kehilangan celah itu atau menebak apa yang terjadi. Karena osFoundry adalah workspace desktop bring-your-own-key, riwayat ini hidup bersama workspace Anda, bukan di server vendor: jendela event bersifat local-first, sehingga me-replay event lama tidak berarti mengirim data Anda keluar ke pihak ketiga. Anda mereset cursor, me-replay, dan consumer melihat event terurut yang sama seperti yang akan dilihatnya secara live.
Mengapa ini penting: alur kerja agent dan multichannel bersifat stateful, dan state itu hanya sepercaya kemampuan Anda merekonstruksinya. Jendela yang disimpan dan dialamatkan lewat seq id mengubah pertanyaan "apa yang sebenarnya dilihat channel ini?" dari sekadar tebakan menjadi pembacaan ulang yang deterministik. Ini membuat debugging bisa direproduksi (replay urutan persis yang memicu bug), membuat pemulihan murah (lanjutkan dari cursor baik terakhir alih-alih dari nol), dan membuat onboarding consumer baru aman (backfill dari seq id pilihan). Jendela ini dibatasi secara desain pada N hari terakhir, sehingga riwayat tetap berguna dan mutakhir tanpa tumbuh tanpa batas.
Kemampuan utama
- Setiap channel menyimpan event N hari terakhir, masing-masing dicap dengan sequence id monoton (seq id)
- Reset cursor consumer ke seq id mana pun dan replay urutan event yang persis dan terurut dari titik itu
- Pulihkan agent yang crash atau run yang terputus dengan melanjutkan dari cursor terakhir yang diproses, bukan mengulang dari awal
- Reproduksi bug secara deterministik dengan me-replay urutan event tepat yang memicunya, atau backfill consumer yang baru ditambahkan dari seq id pilihan
- Retensi yang dibatasi dan local-first menjaga riwayat terkini tetap hot di perangkat Anda, tanpa pertumbuhan tak terbatas atau bolak-balik ke vendor
Kasus penggunaan
- Pengembang agent: sebuah agent crash di tengah run, jadi Anda memundurkan cursor-nya ke seq id terakhir yang di-commit lalu me-replay channel untuk melanjutkan persis dari tempat ia berhenti
- Debugger alur kerja: sebuah tool hilir menghasilkan hasil yang salah, jadi Anda me-replay rentang event yang sama untuk mereproduksinya dan mengonfirmasi perbaikan secara deterministik
- Pembangun integrasi: Anda menambahkan consumer baru ke channel yang sibuk lalu mem-backfill-nya dari seq id pilihan agar ia menyusul N hari terakhir sebelum go live
Pertanyaan yang sering diajukan
Sampai seberapa jauh saya bisa me-replay event di sebuah channel?
Setiap channel menyimpan jendela bergulir berisi event N hari terakhir. Apa pun di dalam jendela itu dapat dialamatkan lewat sequence id-nya dan bisa di-replay; event yang lebih tua dari jendela retensi akan luruh seiring waktu, jadi hot replay dirancang untuk riwayat terkini dan pemulihan, bukan pengarsipan permanen.
Apa sebenarnya yang dilakukan mereset cursor?
Cursor menandai seq id terakhir yang telah diproses oleh consumer. Meresetnya ke seq id lebih awal memberi tahu consumer itu untuk membaca ulang channel dari titik tersebut ke depan, dan menerima kembali event terurut yang sama. Ini tidak menghapus atau menulis ulang event, hanya mengubah dari mana pembacaan dilanjutkan.
Apakah me-replay riwayat channel saya mengirim data ke server osFoundry?
Tidak. osFoundry adalah workspace desktop bring-your-own-key yang local-first, dan jendela event disimpan bersama workspace Anda. Replay membaca ulang event yang sudah disimpan secara lokal, sehingga memulihkan atau memproses ulang riwayat tidak memerlukan pengiriman data channel Anda ke layanan pihak ketiga.