@decentnetwork/lan 0.1.0

package/dist/cli/commands.d.ts

@@ -0,0 +1,223 @@
+/**
+ * CLI command handlers
+ */
+/**
+ * Initialize ~/.agentnet directory and config
+ */
+export declare function cmdInit(args: {
+    name?: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Show identity information.
+ * Loads (or creates) keypair without joining network — fast and offline.
+ */
+export declare function cmdIdentityShow(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * List peers from IPAM
+ */
+export declare function cmdPeersList(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Assign a virtual IP to a Carrier ID
+ */
+export declare function cmdIpamAssign(args: {
+    peer: string;
+    ip?: string;
+    name: string;
+    services?: string[];
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Grant access to a peer.
+ * Default direction is "both" so TCP return packets are allowed.
+ */
+export declare function cmdGrant(args: {
+    peer: string;
+    tcp?: number[];
+    udp?: number[];
+    expires?: string;
+    purpose?: string;
+    direction?: "inbound" | "outbound" | "both";
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Revoke access from a peer
+ */
+export declare function cmdRevoke(args: {
+    peer: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Resolve a hostname to a virtual IP
+ */
+export declare function cmdResolve(args: {
+    name: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Show daemon status (must be run while daemon is up — placeholder for now)
+ */
+export declare function cmdStatus(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Start the daemon (foreground)
+ */
+export declare function cmdUp(args: {
+    name?: string;
+    configDir?: string;
+    realTun?: boolean;
+}): Promise<void>;
+/**
+ * Send a friend request to another peer's address.
+ * Run while daemon is DOWN — opens a temporary peer, sends request, exits.
+ * The request is delivered via Carrier express relay (HTTP store-and-forward)
+ * AND via onion routing if recipient is announced on the DHT.
+ */
+export declare function cmdFriendRequest(args: {
+    address: string;
+    hello?: string;
+    configDir?: string;
+    waitMs?: number;
+}): Promise<void>;
+/**
+ * Accept a pending friend request.
+ * Run while daemon is DOWN — opens a temporary peer, accepts, exits.
+ *
+ * IMPORTANT: This must be running for the friend request to be delivered
+ * via onion routing. The peer must announce itself on the DHT first
+ * (this takes ~45s), then wait for the request to arrive.
+ */
+export declare function cmdFriendAccept(args: {
+    pubkey?: string;
+    waitForRequest?: boolean;
+    waitMs?: number;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * List friends in the friend store.
+ */
+export declare function cmdFriendsList(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Show audit log
+ */
+export declare function cmdAuditLog(args: {
+    tail?: number;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Enable the built-in CONNECT proxy.
+ * Persists `proxy.enabled = true` in config.yaml. Takes effect on next
+ * `agentnet up`. If port is provided, updates the listener port.
+ */
+export declare function cmdProxyEnable(args: {
+    port?: number;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Disable the built-in CONNECT proxy.
+ * Sets `proxy.enabled = false`. Existing tunnels are torn down on next
+ * daemon restart.
+ */
+export declare function cmdProxyDisable(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Show proxy status from config.yaml.
+ */
+export declare function cmdProxyStatus(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Add a host glob to the proxy allowlist.
+ */
+export declare function cmdProxyAllowHost(args: {
+    host: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Remove a host glob from the proxy allowlist.
+ */
+export declare function cmdProxyRevokeHost(args: {
+    host: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * List proxy allow-host globs.
+ */
+export declare function cmdProxyListHosts(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Print the env-var line for a peer to use this node's proxy.
+ */
+export declare function cmdProxyUse(args: {
+    peer: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Parse duration string like "1h", "24h", "30m"
+ */
+declare function parseDuration(input: string): number;
+export { parseDuration };
+/**
+ * Install (or remove) OS-side resolver config so `<name>.<dnsDomain>`
+ * queries get routed to the daemon's DNS server on
+ * 127.0.0.1:<dnsPort>. macOS uses /etc/resolver/<domain>; Linux uses
+ * systemd-resolved's per-link config via `resolvectl`. Idempotent;
+ * `--uninstall` reverses it.
+ *
+ * Requires root on both platforms (file write to /etc, or root-only
+ * resolvectl). The shipped error tells the operator if so.
+ */
+export declare function cmdDnsInstall(args: {
+    uninstall?: boolean;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Print /etc/hosts entries for the current IPAM contents. Stopgap
+ * for OSes / setups where the resolver wiring is awkward — pipe to
+ * `sudo tee -a /etc/hosts`.
+ */
+export declare function cmdDnsHosts(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Query the running daemon for a JSON-formatted snapshot of its state.
+ * Useful when packets aren't moving and you want to see forwarding
+ * counters, friend status, and IPAM contents without restarting the
+ * daemon with AGENTNET_LOG_LEVEL=debug.
+ */
+export declare function cmdDiag(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Enable dora integration and add a dora server's userid to the
+ * registry list. Subsequent `agentnet up` runs will register with
+ * dora to get a virtual IP and fetch the peer roster automatically.
+ */
+export declare function cmdDoraEnable(args: {
+    userid: string;
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Disable dora integration without losing the configured server list.
+ * Daemon falls back to manual ipam.yaml mode.
+ */
+export declare function cmdDoraDisable(args: {
+    configDir?: string;
+}): Promise<void>;
+/**
+ * Show dora config. Live runtime state (currently-allocated IP,
+ * last roster refresh) would require IPC to the running daemon —
+ * not wired yet.
+ */
+export declare function cmdDoraStatus(args: {
+    configDir?: string;
+}): Promise<void>;