@decentnetwork/lan 0.1.99 → 0.1.101

package/dist/carrier/peer-manager.d.ts

@@ -53,6 +53,10 @@ export declare class PeerManager extends EventEmitter {
         name?: string;
         description?: string;
     }): void;
+    /** Offer a file to a friend (toxcore-standard transfer). Returns the fileId. */
+    sendFile(userid: string, data: Uint8Array, name: string): string | null;
+    /** Accept an incoming file offer. */
+    acceptFile(userid: string, fileNumber: number): void;
     /**
      * Send an outbound friend request to a Carrier address (NOT a bare
      * userid — sendFriendRequest needs the address form because it

package/dist/carrier/peer-manager.js

@@ -106,6 +106,16 @@ export class PeerManager extends EventEmitter {
         this.peer.setUserInfo(info);
         this.logger.info(`Profile updated (name="${info.name ?? "(unchanged)"}")`);
     }
+    /** Offer a file to a friend (toxcore-standard transfer). Returns the fileId. */
+    sendFile(userid, data, name) {
+        if (!this.peer)
+            throw new Error("Peer not created. Call create() first.");
+        return this.peer.sendFile(userid, data, { name });
+    }
+    /** Accept an incoming file offer. */
+    acceptFile(userid, fileNumber) {
+        this.peer?.acceptFile(userid, fileNumber);
+    }
     /**
      * Send an outbound friend request to a Carrier address (NOT a bare
      * userid — sendFriendRequest needs the address form because it
@@ -477,6 +487,12 @@ export class PeerManager extends EventEmitter {
             }
             this.emit("message", message.pubkey, message.text);
         });
+        // Toxcore-standard file transfer (native-compatible). Forward offers,
+        // progress, and completions to the daemon, which auto-accepts and saves.
+        this.peer.onFile((o) => this.emit("file-offer", o));
+        this.peer.onFileProgress((p) => this.emit("file-progress", p));
+        this.peer.onFileComplete((p) => this.emit("file-complete", p));
+        this.peer.onFileCancel((p) => this.emit("file-cancel", p));
         // decentlan custom packets, all lossless so they traverse relay-only
         // sessions: IP data (163), session handshake (161), dora control (162).
         // Each on its own Carrier packet id — a chat message can never be mistaken

package/dist/cli/commands.d.ts

@@ -254,6 +254,17 @@ export declare function cmdChatSend(args: {
     text: string;
     configDir?: string;
 }): Promise<void>;
+/**
+ * Send a file to a friend over toxcore-standard file transfer (direct, over the
+ * reliable net_crypto channel — no express, no size cap). The daemon reads the
+ * file by absolute path, so it must be readable by the daemon's user. The
+ * recipient's daemon auto-accepts and saves to its <configDir>/downloads/.
+ */
+export declare function cmdFileSend(args: {
+    to: string;
+    path: string;
+    configDir?: string;
+}): Promise<void>;
 /**
  * Print chat history (sent + received). Incoming messages are logged by the
  * daemon as they arrive, so this is also how you READ messages from friends.

package/dist/cli/commands.js

@@ -1083,6 +1083,23 @@ export async function cmdChatSend(args) {
         throw new Error(`Daemon refused: ${res.error}`);
     console.log(`-> ${args.to.slice(0, 16)}…  ${args.text}`);
 }
+/**
+ * Send a file to a friend over toxcore-standard file transfer (direct, over the
+ * reliable net_crypto channel — no express, no size cap). The daemon reads the
+ * file by absolute path, so it must be readable by the daemon's user. The
+ * recipient's daemon auto-accepts and saves to its <configDir>/downloads/.
+ */
+export async function cmdFileSend(args) {
+    const dir = args.configDir || ConfigLoader.defaultConfigDir();
+    const config = await ConfigLoader.load(resolve(dir, "config.yaml"));
+    const abs = resolve(process.cwd(), args.path);
+    const res = await ipcCall(config, { op: "file-send", userid: args.to, path: abs }, 30000);
+    if (!res.ok)
+        throw new Error(`File send failed: ${res.error}`);
+    const d = (res.data ?? {});
+    console.log(`Offered "${d.name}" (${d.size} bytes) to ${args.to.slice(0, 16)}… — fileId ${d.fileId}`);
+    console.log("Streams once the recipient accepts; their daemon saves it to ~/.agentnet/downloads/.");
+}
 /**
  * Print chat history (sent + received). Incoming messages are logged by the
  * daemon as they arrive, so this is also how you READ messages from friends.

package/dist/cli/index.js

@@ -10,7 +10,7 @@ import { hideBin } from "yargs/helpers";
 // Belt-and-braces — also raise it here in case the CLI is run directly
 // (e.g. `node dist/cli/index.js` rather than via dist/index.js).
 EventEmitter.defaultMaxListeners = 100;
-import { cmdInit, cmdIdentityShow, cmdPeersList, cmdIpamAssign, cmdGrant, cmdRevoke, cmdResolve, cmdStatus, cmdUp, cmdAuditLog, cmdFriendRequest, cmdFriendAccept, cmdFriendsList, cmdFriendsPending, cmdFriendsAccept, cmdFriendsReject, cmdProxyEnable, cmdProxyDisable, cmdProxyStatus, cmdProxyAllowHost, cmdProxyRevokeHost, cmdProxyListHosts, cmdProxyUse, cmdProxyRouter, cmdDoraEnable, cmdDoraDisable, cmdDoraStatus, cmdDoraAutofriend, cmdDiag, cmdDoctor, cmdDnsInstall, cmdDnsHosts, cmdServiceInstall, cmdRestart, cmdServiceStatus, cmdServiceRestart, cmdUi, cmdConsole, cmdChatSend, cmdChatHistory, cmdFriendRemove, cmdFriendAlias, } from "./commands.js";
+import { cmdInit, cmdIdentityShow, cmdPeersList, cmdIpamAssign, cmdGrant, cmdRevoke, cmdResolve, cmdStatus, cmdUp, cmdAuditLog, cmdFriendRequest, cmdFriendAccept, cmdFriendsList, cmdFriendsPending, cmdFriendsAccept, cmdFriendsReject, cmdProxyEnable, cmdProxyDisable, cmdProxyStatus, cmdProxyAllowHost, cmdProxyRevokeHost, cmdProxyListHosts, cmdProxyUse, cmdProxyRouter, cmdDoraEnable, cmdDoraDisable, cmdDoraStatus, cmdDoraAutofriend, cmdDiag, cmdDoctor, cmdDnsInstall, cmdDnsHosts, cmdServiceInstall, cmdRestart, cmdServiceStatus, cmdServiceRestart, cmdUi, cmdConsole, cmdFileSend, cmdChatSend, cmdChatHistory, cmdFriendRemove, cmdFriendAlias, } from "./commands.js";
 async function main() {
     await yargs(hideBin(process.argv))
         .scriptName("agentnet")
@@ -155,6 +155,17 @@ async function main() {
     })
         .command("console", "Interactive terminal UI (TUI) — friends list + chat, keyboard-driven (q to quit)", (y) => y.option("config-dir", { type: "string" }), async (argv) => {
         await cmdConsole({ configDir: argv["config-dir"] });
+    })
+        .command("file <action> <userid> [path]", "Send a file to a friend (toxcore-standard, direct; recipient auto-saves to ~/.agentnet/downloads)", (y) => y
+        .positional("action", { type: "string", choices: ["send"], demandOption: true })
+        .positional("userid", { type: "string", demandOption: true, describe: "Friend's userid" })
+        .positional("path", { type: "string", describe: "Path to the file to send" })
+        .option("config-dir", { type: "string" }), async (argv) => {
+        if (argv.action === "send") {
+            if (!argv.path)
+                throw new Error("path is required: agentnet file send <userid> <path>");
+            await cmdFileSend({ to: argv.userid, path: argv.path, configDir: argv["config-dir"] });
+        }
     })
         // Tell the running daemon to re-exec itself with its original argv.
         // The daemon inherits its own uid (root if it was launched as root)

package/dist/daemon/ipc.d.ts

@@ -56,6 +56,8 @@ export interface IpcHandlers {
         name?: string;
         description?: string;
     }) => Promise<void>;
+    /** Offer a local file (by path) to a friend over toxcore file transfer. */
+    fileSend: (userid: string, path: string) => Promise<Record<string, unknown>>;
     /** Mark a conversation read up to `ts` (defaults to now) — clears unread. */
     chatMarkRead: (userid: string, ts?: number) => Promise<void>;
     /** Re-read proxy allowlist from config and apply it to the running
@@ -74,7 +76,7 @@ export interface IpcHandlers {
     selfRestart: () => Promise<Record<string, unknown>>;
 }
 export interface IpcRequest {
-    op: "friend-request" | "ping" | "diag" | "friends-pending" | "friends-accept" | "friends-reject" | "chat-send" | "chat-history" | "friends-list" | "friend-remove" | "friend-set-alias" | "set-profile" | "chat-mark-read" | "proxy-reload" | "self-restart";
+    op: "friend-request" | "ping" | "diag" | "friends-pending" | "friends-accept" | "friends-reject" | "chat-send" | "chat-history" | "friends-list" | "friend-remove" | "friend-set-alias" | "set-profile" | "file-send" | "chat-mark-read" | "proxy-reload" | "self-restart";
     address?: string;
     hello?: string;
     userid?: string;
@@ -82,6 +84,7 @@ export interface IpcRequest {
     alias?: string;
     name?: string;
     description?: string;
+    path?: string;
     before?: number;
     limit?: number;
     ts?: number;

package/dist/daemon/ipc.js

@@ -170,6 +170,13 @@ export class IpcServer {
                 await this.handlers.setProfile({ name: req.name, description: req.description });
                 return;
             }
+            case "file-send": {
+                if (!req.userid)
+                    throw new Error("userid is required");
+                if (!req.path)
+                    throw new Error("path is required");
+                return await this.handlers.fileSend(req.userid, req.path);
+            }
             case "chat-mark-read": {
                 if (!req.userid)
                     throw new Error("userid is required");

package/dist/daemon/server.js

@@ -295,6 +295,17 @@ export class DaemonServer {
                         this.logger.warn(`Failed to persist profile: ${e.message}`);
                     });
                 },
+                fileSend: async (userid, path) => {
+                    const fs = await import("fs/promises");
+                    const { basename } = await import("path");
+                    const data = await fs.readFile(path);
+                    const name = basename(path);
+                    const fileId = this.peerManager?.sendFile(userid, new Uint8Array(data), name);
+                    if (!fileId)
+                        throw new Error("No free transfer slot (or friend unknown)");
+                    this.logger.info(`Offering file "${name}" (${data.length}B) to ${userid.slice(0, 8)}`);
+                    return { fileId, name, size: data.length };
+                },
                 chatMarkRead: async (userid, ts) => {
                     this.friendMeta?.markRead(userid, ts);
                 },
@@ -544,6 +555,27 @@ export class DaemonServer {
             this.peerManager.on("message", (pubkey, text) => {
                 this.logChat(pubkey, "in", text);
             });
+            // File transfer (toxcore-standard): auto-accept offers from friends and
+            // save completed files under <configDir>/downloads/.
+            this.peerManager.on("file-offer", (o) => {
+                this.logger.info(`Incoming file "${o.name}" (${o.size}B) from ${o.friendId.slice(0, 8)} — accepting`);
+                this.peerManager?.acceptFile(o.friendId, o.fileNumber);
+            });
+            this.peerManager.on("file-complete", (p) => {
+                if (p.sending || !p.data) {
+                    if (p.sending)
+                        this.logger.info(`File "${p.name}" sent to ${p.friendId.slice(0, 8)}`);
+                    return;
+                }
+                void (async () => {
+                    const dir = resolve(this.configDir, "downloads");
+                    const fs = await import("fs/promises");
+                    await fs.mkdir(dir, { recursive: true });
+                    const safe = (p.name || "file").replace(/[/\\]/g, "_");
+                    await fs.writeFile(resolve(dir, safe), Buffer.from(p.data));
+                    this.logger.info(`Saved file "${p.name}" (${p.size}B) from ${p.friendId.slice(0, 8)} → ${resolve(dir, safe)}`);
+                })().catch((e) => this.logger.warn(`Failed to save file: ${e.message}`));
+            });
             this.peerManager.on("friend-request", (req) => {
                 void pubkeyHexToUserid(req.pubkey).then((userid) => {
                     const who = `${req.name || "(unnamed)"} ${userid}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/lan",
-  "version": "0.1.99",
+  "version": "0.1.101",
   "description": "Private virtual LAN for self-hosted services and AI agents, built on Elastos Carrier. NAT-traversal, name service, ACL, all over a peer-to-peer mesh — no public IP required.",
   "type": "module",
   "main": "./dist/index.js",
@@ -79,7 +79,7 @@
   },
   "dependencies": {
     "@decentnetwork/dora": "^0.1.6",
-    "@decentnetwork/peer": "^0.1.42",
+    "@decentnetwork/peer": "^0.1.44",
     "ink": "^5.2.1",
     "js-yaml": "^4.1.0",
     "react": "^18.3.1",