Naut/include/naut/swarm.h
ookami125 8dde48c05a webui: replace nautctl web server with a loadable plugin
Drop the web UI that was compiled into nautctl and serve the
torrent-ui front end (../torrent-ui/public) from a native plugin
(plugins/webui) loaded via `nautd --plugin`. The plugin talks to the
engine only through the host call_rpc ABI and adapts the daemon's RPC
surface to the qBittorrent-style contract the UI expects (snapshot/SSE,
torrent detail tabs, add/delete, cookie auth).

Also folds in the daemon refactor that owns per-torrent worker threads
and the swarm engine (naut_swarm) used by the plugin's data source.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 00:21:48 -04:00

52 lines
1.7 KiB
C

/* swarm.h - reusable multi-peer download driver.
*
* naut_swarm is a small CLI wrapper around this API. Long-running applications
* such as nautd own the worker thread and use callbacks for progress, control
* commands, cancellation, and event delivery.
*/
#ifndef NAUT_SWARM_H
#define NAUT_SWARM_H
#include "naut/common.h"
#include "naut/event.h"
#include "naut/storage.h"
typedef struct {
uint64_t total_bytes;
uint64_t bytes_done;
uint32_t total_pieces;
uint32_t pieces_done;
uint32_t peers_total; /* discovered endpoints */
uint32_t peers_connecting;
uint32_t peers_active;
uint32_t peers_failed;
double elapsed_seconds;
} naut_swarm_stats;
typedef void (*naut_swarm_progress_cb)(void *context,
const naut_swarm_stats *stats);
/* Called on the swarm owner thread. The callback may safely operate on storage,
* including relocating completed files. */
typedef void (*naut_swarm_control_cb)(void *context, naut_storage *storage);
typedef bool (*naut_swarm_stop_cb)(void *context);
typedef struct {
const char *source; /* .torrent path or magnet URI */
const char *output_dir;
const char *const *peers; /* optional explicit ip:port endpoints */
size_t num_peers;
uint64_t torrent_id;
naut_event_bus *events; /* optional */
bool keep_alive; /* retain completed storage until stopped */
naut_swarm_progress_cb on_progress;
naut_swarm_control_cb on_control;
naut_swarm_stop_cb should_stop;
void *context;
} naut_swarm_config;
/* Blocks until the torrent completes, is cancelled, or fails. */
naut_err naut_swarm_run(const naut_swarm_config *config);
#endif /* NAUT_SWARM_H */