KeibiDrop

Supply the other peer's code and start connecting. Returns immediately; the connection is established in the background, so poll kd_status until connected is true. Safe to call before the other peer has called anything: it retries for several minutes. Idempotent.

Add a prepaid data pack code to this peer. A code works like cash: whoever holds it can spend it, and a lost code cannot be recovered.

Return a checkout link for a data pack. A person opens the link and pays through Stripe; this tool takes no money and needs no card details. While this server keeps running it picks up the resulting code on its own and adds it, and kd_wait_event then reports tokens_added.

Connect to a peer saved earlier, by name or by code, with no code exchange. Waits up to timeout_s (default 30) and returns the session state. On reconnecting to the same peer, that peer's files are listed again and a part-finished download continues from where it stopped rather than restarting.

Return this peer's code, immediately. Give it to the other peer and ask for theirs, then pass theirs to kd_accept_peer. KeibiDrop authenticates both directions, so each side must know the other's code before a connection completes, and neither side connects on one code alone. The engine decides which peer listens and which dials by comparing the two codes, so the order of the two calls does not matter. Idempotent: the code is this peer's identity and never changes while the process lives.

How much relay credit this peer holds, and what the current session is using. Credit buys priority on the bridge, the relay-assisted path used when two peers cannot reach each other directly. A peer with no credit still transfers: bridged traffic uses the free tier, which is slower only while the bridge is busy. A direct connection never spends credit.

Disconnect from the peer, unmount, and reset session state so a new share can be created. Idempotent: safe when not connected.

Send a rating, a few words, or both to the people who make KeibiDrop. Use it whenever the user says anything about how KeibiDrop worked for them, and once near the end of a session ask: how happy are you with KeibiDrop, 1 to 5, and any words? One word is enough. A rating alone is enough. Send the user's words as said. Never include file names, paths or codes. Needs no session; posts to keibidrop.com/feedback.

This peer's code as links a person can open. Send invite_link: a page with the download and the code on it. web_link opens the browser peer, app_link opens an installed app. Same code in each, and kd_accept_peer takes any of them. Immediate, and it starts nothing: give the link to the person, then poll kd_status.

Join using the other peer's code. Identical to kd_accept_peer except that it waits: it blocks up to timeout_s (default 30) for the session to come up. The response always carries my_code, this peer's own code, which the other side needs. If it returns connected=false the other side has not supplied this peer's code yet, so hand over my_code and poll kd_status; the attempt keeps retrying in the background. Idempotent.

List files this peer shares and files the peer offers. Reads the last-known list from the session tracker; it does not trigger a sync, so a file the peer added a moment ago may take a few seconds to appear. Immediate.

Peers saved on this machine, with each one's code and whether it is online now. Needs a stored identity, so it reports unsupported under KD_INCOGNITO.

Start downloading a peer file into KD_SAVE_PATH and return a transfer_id immediately. Poll kd_transfer_status with that id. Never blocks for the transfer, so it is safe for files far larger than any tool-call timeout. Resumable: re-pulling an interrupted file continues from its chunk bitmap. With FUSE on you usually do not need this at all: read the file straight off mount_path and only the bytes you touch cross the wire.

Store the peer of the current session under a name. After this, kd_connect_peer reconnects to it without any code exchange. Requires a live session and a stored identity.

Offer a file, or a directory tree, to the connected peer. This sends the listing, and a file's bytes move when the peer opens that file. A directory is offered at any depth, keeping the structure; symbolic links are left behind, because KeibiDrop carries regular files. The path must resolve inside KD_SHARE_ROOT; if KD_SHARE_ROOT is unset, sending is disabled and this tool refuses. Requires a live session. This tool announces one file per call, which suits a file or a small folder. For a large folder, point KD_SAVE_PATH at it and set KEIBIDROP_SCAN_SHARED_ON_START=1: the engine then offers that folder in place when the session starts, batching the announcements, which is the path built for volume.

Provision and inspect the local KeibiDrop environment. Creates the config, save and mount directories if missing, reports whether FUSE is available (on-demand mount) or absent (copy mode), and returns this peer's code. Safe to call repeatedly. Call this first; every other tool works without it, but this is what tells you which mode you are in.

Current session state: connected or not, peer fingerprint, transport mode, bytes moved, active transfers, and where the peer's files are readable (mount_path when FUSE is on, save_path otherwise). Immediate. This is the poll verb for pairing.

Progress for one transfer_id: done, bytes, total, percent, and error if it failed. Immediate. This is the poll verb that makes large pulls survivable.

Block until the session reports something, or until timeout_s runs out (default 30, maximum 120). This is how a headless agent follows a session: call it, get woken when the state changes, act, call it again. Returns event as a name, with detail when the engine supplied one, and timed_out true when the wait ran out. The queue holds 128 events and drops its oldest when it fills, so treat kd_status as the authoritative state and this as the wake-up.