srift-transfer 2.2.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SRIFT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# srift
+
+**Secure peer-to-peer file transfer and encrypted chat for AI agents and humans.** Ships an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server so Claude, Cursor, Continue, Zed, Codex and any MCP-compatible agent can send and receive files directly — no accounts, no API keys, no cloud storage.
+
+```bash
+npm install -g srift-transfer
+```
+
+---
+
+## Why
+
+Coding agents can read and write files in their own sandbox, but they have no good way to get a file **to you** — or to another machine. Attaching, uploading and pasting all break down for anything large or binary.
+
+SRIFT gives an agent one tool call that produces a link a human can open:
+
+```
+srift_quick_share({ filepath: "./build/report.pdf" })
+→ https://srift.app/d/a1b2c3d
+```
+
+No signup on either end. Payloads are AES-256-GCM encrypted end-to-end; keys derive locally from the session ID (plus an optional room secret) and are never sent to the server.
+
+## Quick start
+
+```bash
+npm install -g srift-transfer
+
+srift quick-share ./report.pdf      # public link, open anywhere
+srift session start                 # long-lived room, host approves joins
+srift status                        # daemon + session + transfers
+srift doctor                        # full health check
+```
+
+## Use as an MCP server
+
+Register SRIFT with any MCP client:
+
+```bash
+srift install-mcp            # print config snippets for every supported IDE
+srift install-mcp --auto     # write directly into Claude Desktop's config
+```
+
+Or configure it manually:
+
+```json
+{
+  "mcpServers": {
+    "srift": {
+      "command": "srift",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Works in **Claude Desktop, Claude Code, Cursor, Continue, Zed, Codex, Windsurf** and any client speaking MCP `2025-06-18` (backward compatible with `2024-11-05`).
+
+### Transports
+
+| Transport | Endpoint |
+|---|---|
+| stdio | `srift mcp` |
+| Streamable HTTP | `POST http://127.0.0.1:3822/mcp` |
+| SSE (legacy) | `GET http://127.0.0.1:3822/mcp/sse` |
+
+### Tools exposed
+
+| Tool | Purpose |
+|---|---|
+| `srift_quick_share` | One-step public download link for a file |
+| `srift_start_session` | Open a session; returns 7-character ID + URL |
+| `srift_join_session` | Request to join a session |
+| `srift_session_status` | Current session, peers, state |
+| `srift_close_session` | Tear down the session |
+| `srift_send_file` | Offer a file to joined peers |
+| `srift_accept_transfer` | Accept an incoming offer |
+| `srift_list_transfers` | List active transfers |
+| `srift_approve_join` / `srift_reject_join` / `srift_kick_user` | Host controls |
+| `srift_send_chat` / `srift_chat_history` | Encrypted chat |
+| `srift_read_state` | Read workspace state |
+
+Resources: `srift://session/status`, `srift://transfers/active`, `srift://chat/messages`, `srift://workspace/state`, `srift://docs/quickstart`
+
+Prompts: `send_file_to_user`, `receive_file_from_user`, `start_collab_session`
+
+## CLI reference
+
+```
+Sessions    srift session start | join <id> | status | close
+Transfers   srift quick-share <file> [--ttl 15m] [--once] [--max-downloads N]
+            srift send <file> | receive <file-id> | list | monitor <file-id>
+Public      srift pubshare list | add <file> | revoke <token>
+Host        srift approve <id> | reject <id> | kick <id>
+Chat        srift chat send "<msg>" | chat history
+Agents      srift install-mcp [--auto] | bootstrap [dir] | info
+Daemon      srift daemon start | stop | restart | status
+Maintenance srift status | doctor | logs | version | self-update | reset | config
+```
+
+Every command accepts `--json` for machine-readable output — intended for agent use.
+
+## How transfers work
+
+- **Small/medium files** stream over an authenticated WebSocket channel.
+- **Large files** (>10 MB) switch to WebTorrent swarm transfer where available.
+- **Browser-to-browser** sessions negotiate WebRTC data channels directly.
+- Content is encrypted client-side with **AES-256-GCM** before it leaves your machine. Relay infrastructure forwards ciphertext and does not hold decryption keys.
+
+`webtorrent` is an *optional* dependency — it pulls native modules that don't build everywhere. If it's unavailable, SRIFT logs a warning and falls back to WebSocket transfer; every other feature keeps working.
+
+## Configuration
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `SRIFT_DAEMON_PORT` | `3822` | Daemon port |
+| `SRIFT_NO_UPDATE_CHECK` | – | Set to `1` to disable update checks |
+
+Config file: `~/.srift/config.json` (`srift config get|set|delete`)
+
+## Requirements
+
+Node.js >= 20.
+
+## Links
+
+- Website — <https://srift.app>
+- Agent documentation — <https://srift.app/ai-agents>
+- OpenAPI spec — <https://srift.app/openapi.json>
+- `llms.txt` — <https://srift.app/llms.txt>
+
+## License
+
+MIT