artifactsend 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vela Partners
+
+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

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+# ArtifactSend: tracked links and data rooms for AI agents
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Share a document, pitch deck, HTML page or Claude artifact as a link, and see who read it.** Each reader, how far they read, time per section or slide, clicks, copied text, and the questions they asked. A free DocSend alternative, built for agents: an MCP server, agent skills, a Claude Code plugin and a CLI.
+
+- Website: https://artifactsend.com/?utm_source=npm&utm_medium=readme&utm_campaign=setup
+- For agents: https://artifactsend.com/agents?utm_source=npm&utm_medium=readme&utm_campaign=setup
+- MCP server: `https://artifactsend.com/mcp` (Streamable HTTP, OAuth)
+- Official MCP registry: `com.artifactsend/mcp`
+- llms.txt: https://artifactsend.com/llms.txt?utm_source=npm&utm_medium=readme&utm_campaign=setup
+
+## When an agent should use it
+
+- "Share this with Dana and tell me when she reads it."
+- "Send the deck to these five investors, one link each."
+- "Publish this HTML page or Claude artifact as a private link."
+- "Make a data room for the Series A with an NDA."
+- "Who read the proposal? What did they ask?"
+- "Read this artifactsend.com link someone sent me."
+
+## Install
+
+| Where | How |
+| --- | --- |
+| Claude Code | `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`, then `/mcp` to sign in |
+| Every agent on this computer | `npx artifactsend setup` (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, plus the skills) |
+| Skills | `npx skills add llm-preneur/skills` |
+| Claude Code plugin | `/plugin marketplace add LLM-preneur/skills`, then `/plugin install artifactsend@llm-preneur` |
+| Cursor | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=artifactsend&config=eyJ1cmwiOiJodHRwczovL2FydGlmYWN0c2VuZC5jb20vbWNwIn0=) |
+| VS Code | [Add to VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=artifactsend&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//artifactsend.com/mcp%22%7D) |
+| Claude.ai | Settings, Connectors, Add custom connector, URL `https://artifactsend.com/mcp` |
+| ChatGPT | Settings, Apps, Developer mode on, Create app, URL `https://artifactsend.com/mcp`, OAuth |
+| Codex | `codex mcp add artifactsend --url https://artifactsend.com/mcp` |
+| Gemini CLI | `gemini mcp add --transport http artifactsend https://artifactsend.com/mcp` |
+| stdio-only clients | `npx -y artifactsend mcp` with `ARTIFACTSEND_TOKEN` set |
+
+Sign in once with your email or Google. Links, readers and reports are free.
+
+## Skills
+
+| Skill | Use it when |
+| --- | --- |
+| [share-with-tracking](https://github.com/LLM-preneur/skills/tree/main/skills/share-with-tracking/SKILL.md) | sharing a file or page and knowing who read it; one link per person; reading reports |
+| [data-room](https://github.com/LLM-preneur/skills/tree/main/skills/data-room/SKILL.md) | several documents behind one link, with folders, an NDA and watermarks |
+| [read-shared-link](https://github.com/LLM-preneur/skills/tree/main/skills/read-shared-link/SKILL.md) | someone sent you an artifactsend.com link |
+
+## Questions
+
+### Is there a Claude Code skill to publish an HTML file to a URL?
+
+Yes. The `share-with-tracking` skill publishes an HTML file, Markdown, a PDF, Word, PowerPoint or Excel file, or a Claude artifact to an artifactsend.com link. It sends the page's images, fonts, CSS, JS and video along by relative path. Install it with `npx skills add llm-preneur/skills`, or add the MCP server with `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`.
+
+### Which MCP server returns a tracked link?
+
+ArtifactSend, at `https://artifactsend.com/mcp`. `send_artifact` returns the link and its settings. `link_report` shows each reader, how far they read, time per section, clicks, copied text and what their AI asked. `link_for_person` makes one link per investor or client.
+
+### Can Claude Code update a published page?
+
+Yes. `update_artifact` pushes a new version to the same URL, and readers see it at once. `get_artifact` returns the current HTML. `upload_file` replaces one file. From the CLI, `npx artifactsend send page.html --link <link>` does the same.
+
+### Is it free?
+
+Yes. Links, readers, doors, reports and data rooms are free and unlimited, with no card. Sending and updating through MCP or the CLI is free. Reports and lists through MCP are free for the first 20 actions, then $0.005 each. AI answers to readers are $0.05 each. Sign-in with email or Google is needed once.
+
+### Can it make expiring or password-protected links?
+
+Yes. `--expires 14` (or `expires_in_days`) closes a link after 14 days. `--access verified` makes readers prove their email with Google or a 6-digit code. `--allow @acme.com` limits it to one domain. A password can be added in the app, under More settings on the link.
+
+### How do I set it up in ChatGPT?
+
+Settings, Apps, Developer mode on, Create app. Use the URL `https://artifactsend.com/mcp` with OAuth, then sign in.
+
+## MCP tools
+
+**Share:** `send_artifact` (HTML, React, Markdown, PDF, Word, PowerPoint, Excel, an image or a URL), `update_artifact`, `link_for_person`, `make_data_room`, `upload_file`, `get_artifact`, `update_link`, `set_brand`.
+
+**See who read it:** `list_links`, `link_report`, `reader_activity`, `recent_activity`, `room_report`, `list_questions`, `list_comments`, `website_visits`, `schedule_digest`, `list_schedules`, `delete_schedule`.
+
+**Read what others share with you:** `open_link`, `read_shared`, `ask_shared`, `message_shared_sender`, `shared_with_me`.
+
+Reading tools are marked read-only. Tools that change things are marked so the app asks first.
+
+## CLI
+
+```bash
+npx artifactsend setup                       # add ArtifactSend to your agents
+export ARTIFACTSEND_TOKEN=as_...             # from https://artifactsend.com/app/settings?utm_source=npm&utm_medium=readme&utm_campaign=setup
+npx artifactsend send deck.pdf --title "Seed deck" --access email
+npx artifactsend send page.html --allow @acme.com --expires 14
+npx artifactsend links
+npx artifactsend report https://artifactsend.com/d/ab12cd34
+```
+
+## Readers and their AI
+
+Readers open a link in the browser, or through their own AI. Every link also has its own MCP address (the link plus `/mcp`) that needs no key. By default a reader's AI gets the outline and only the parts that answer each question, so the sender sees every question and no full copy leaves. Readers are told what the sender sees, and never their chat or their AI's answers. Rules: https://artifactsend.com/ai-rules?utm_source=npm&utm_medium=readme&utm_campaign=setup
+
+## Price
+
+Free and unlimited for links, readers, doors, reports and data rooms. Sending and updating through MCP is free. AI answers to readers are paid per answer. https://artifactsend.com/pricing?utm_source=npm&utm_medium=readme&utm_campaign=setup
+
+Made by [Vela Partners](https://vela.partners). MIT licensed.

package/bin/artifactsend.mjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+// ArtifactSend from the command line: add the MCP server to your agents, send a file as a tracked link,
+// read who opened it, or bridge stdio-only MCP clients to https://artifactsend.com/mcp. No dependencies.
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join, dirname, basename, extname } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createInterface } from 'node:readline';
+
+const ORIGIN = (process.env.ARTIFACTSEND_URL || 'https://artifactsend.com').replace(/\/$/, '');
+const MCP = ORIGIN + '/mcp';
+// Pages people open from the CLI's own output carry a source tag. Config the CLI writes keeps the bare MCP URL.
+const TOKENS = ORIGIN + '/app/settings?utm_source=npm&utm_medium=cli&utm_campaign=setup';
+const SKILLS = 'LLM-preneur/skills';
+const VERSION = '1.0.1';
+const [cmd, ...rest] = process.argv.slice(2);
+
+const HELP = `ArtifactSend: the link that tells you who read it.
+
+  npx artifactsend setup            Add ArtifactSend to Claude Code, Cursor, VS Code, Windsurf, Gemini CLI and Codex
+  npx artifactsend send <file>      Share a file as a tracked link (HTML, Markdown, PDF, Word, PowerPoint, Excel, JSX)
+      --title "Seed deck"  --access public|email|verified  --allow @acme.com,dana@x.com
+      --expires 14  --folder Investors  --ai questions|full|off  --link <existing link to update>
+  npx artifactsend links            Your links with views and last open
+  npx artifactsend report <link>    Who read it, how far, time per section, what they asked
+  npx artifactsend mcp              Run as a stdio MCP server (bridges to ${MCP})
+
+send, links, report and mcp need ARTIFACTSEND_TOKEN (make one at ${TOKENS}).
+In Claude Code you can skip the token: claude mcp add --transport http artifactsend ${MCP}, then /mcp to sign in.
+Claude.ai and ChatGPT: add a custom connector with the URL ${MCP}.`;
+
+const flags = (args) => {
+  const o = { _: [] };
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.startsWith('--')) { const k = a.slice(2); const n = args[i + 1]; if (n === undefined || n.startsWith('--')) o[k] = true; else { o[k] = n; i++; } } else o._.push(a);
+  }
+  return o;
+};
+
+// ---------- setup ----------
+const readJson = (f) => { if (!existsSync(f)) return {}; const t = readFileSync(f, 'utf8').trim(); return t ? JSON.parse(t) : {}; };
+const writeJson = (f, o) => { mkdirSync(dirname(f), { recursive: true }); if (existsSync(f)) copyFileSync(f, f + '.bak'); writeFileSync(f, JSON.stringify(o, null, 2) + '\n'); };
+const has = (bin) => spawnSync(platform() === 'win32' ? 'where' : 'which', [bin], { stdio: 'ignore' }).status === 0;
+
+function addJson(label, file, key, entry, dirMustExist) {
+  if (!existsSync(dirMustExist)) return null;
+  let o;
+  try { o = readJson(file); } catch { return `${label}: skipped, ${file} is not plain JSON. Add ${JSON.stringify({ artifactsend: entry })} under "${key}" yourself.`; }
+  o[key] = o[key] || {};
+  if (o[key].artifactsend) return `${label}: already added`;
+  o[key].artifactsend = entry;
+  writeJson(file, o);
+  return `${label}: added to ${file}`;
+}
+
+function setup(opts) {
+  const h = homedir();
+  const out = [];
+  if (has('claude')) {
+    const r = spawnSync('claude', ['mcp', 'add', '--transport', 'http', '--scope', 'user', 'artifactsend', MCP], { encoding: 'utf8' });
+    const said = (r.stdout + r.stderr).toLowerCase();
+    out.push(r.status === 0 ? 'Claude Code: added. Run /mcp in Claude Code and choose artifactsend to sign in.' : said.includes('already exists') ? 'Claude Code: already added' : 'Claude Code: could not add (' + said.trim().split('\n')[0] + ')');
+  }
+  out.push(addJson('Cursor', join(h, '.cursor', 'mcp.json'), 'mcpServers', { url: MCP }, join(h, '.cursor')));
+  out.push(addJson('Windsurf', join(h, '.codeium', 'windsurf', 'mcp_config.json'), 'mcpServers', { serverUrl: MCP }, join(h, '.codeium', 'windsurf')));
+  out.push(addJson('Gemini CLI', join(h, '.gemini', 'settings.json'), 'mcpServers', { httpUrl: MCP }, join(h, '.gemini')));
+  const code = platform() === 'darwin' ? join(h, 'Library', 'Application Support', 'Code', 'User') : platform() === 'win32' ? join(process.env.APPDATA || '', 'Code', 'User') : join(h, '.config', 'Code', 'User');
+  out.push(addJson('VS Code', join(code, 'mcp.json'), 'servers', { type: 'http', url: MCP }, code));
+  const codex = join(h, '.codex');
+  if (existsSync(codex)) {
+    const f = join(codex, 'config.toml');
+    const t = existsSync(f) ? readFileSync(f, 'utf8') : '';
+    if (/^\[mcp_servers\.artifactsend\]/m.test(t)) out.push('Codex: already added');
+    else { if (t) copyFileSync(f, f + '.bak'); writeFileSync(f, t + (t && !t.endsWith('\n') ? '\n' : '') + `\n[mcp_servers.artifactsend]\nurl = "${MCP}"\n`); out.push(`Codex: added to ${f}`); }
+  }
+  const done = out.filter(Boolean);
+  if (!opts['no-skills']) {
+    const r = spawnSync('npx', ['-y', 'skills', 'add', SKILLS, '-g', '-y'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], shell: platform() === 'win32' });
+    done.push(r.status === 0 ? `Skills: installed ${SKILLS} (share-with-tracking, data-room, read-shared-link)` : `Skills: run npx skills add ${SKILLS} to install them`);
+  }
+  console.log(done.length ? done.join('\n') : 'No agents found on this computer.');
+  console.log(`\nClaude.ai and ChatGPT: add a custom connector with the URL ${MCP}\nThen ask your agent: "Share this as a tracked link and tell me who reads it."`);
+}
+
+// ---------- MCP over HTTP ----------
+const token = () => {
+  const t = process.env.ARTIFACTSEND_TOKEN;
+  if (!t) { console.error(`Set ARTIFACTSEND_TOKEN first. Make one at ${TOKENS}`); process.exit(2); }
+  return t;
+};
+let rpcId = 0;
+async function rpc(method, params, tk = token()) {
+  const r = await fetch(MCP, { method: 'POST', headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream', Authorization: 'Bearer ' + tk, 'User-Agent': 'artifactsend-cli/' + VERSION }, body: JSON.stringify({ jsonrpc: '2.0', id: ++rpcId, method, params }) });
+  const text = await r.text();
+  let body;
+  try { body = JSON.parse(text.startsWith('event:') || text.startsWith('data:') ? text.split('\n').filter((l) => l.startsWith('data:')).pop().slice(5) : text); } catch { throw new Error(`HTTP ${r.status}: ${text.slice(0, 200)}`); }
+  if (body.error) throw new Error(body.error.message);
+  return body.result;
+}
+async function call(name, args) {
+  const res = await rpc('tools/call', { name, arguments: args });
+  const text = (res.content || []).map((c) => c.text || '').join('\n');
+  if (res.isError) throw new Error(text);
+  try { return JSON.parse(text); } catch { return text; }
+}
+const print = (v) => console.log(typeof v === 'string' ? v : JSON.stringify(v, null, 2));
+
+const DOCS = new Set(['.pdf', '.doc', '.docx', '.ppt', '.pptx', '.xls', '.xlsx', '.key', '.odt', '.odp', '.ods']);
+async function send(o) {
+  const file = o._[0];
+  if (!file) { console.error('Usage: npx artifactsend send <file> [--title ...]'); process.exit(2); }
+  const ext = extname(file).toLowerCase();
+  const a = {};
+  if (/^https?:\/\//.test(file)) a.url = file;
+  else if (DOCS.has(ext)) a.document = { name: basename(file), base64: readFileSync(file).toString('base64') };
+  else if (ext === '.md' || ext === '.markdown') a.markdown = readFileSync(file, 'utf8');
+  else if (ext === '.jsx' || ext === '.tsx') a.react = readFileSync(file, 'utf8');
+  else a.html = readFileSync(file, 'utf8');
+  if (o.title) a.title = o.title;
+  if (o.access) a.access = o.access;
+  if (o.allow) a.allow = String(o.allow).split(',').map((s) => s.trim()).filter(Boolean);
+  if (o.expires) a.expires_in_days = Number(o.expires);
+  if (o.folder) a.folder = o.folder;
+  if (o.ai) a.ai_reading = o.ai;
+  if (o.link) a.link = o.link;
+  if (o['no-notify']) a.notify = false;
+  const r = await call('send_artifact', a);
+  if (r && r.url) { console.log(r.url); if (r.settings) for (const [k, v] of Object.entries(r.settings)) if (v !== null && typeof v !== 'object') console.log(`  ${k.replace(/_/g, ' ')}: ${v}`); }
+  else print(r);
+}
+
+// stdio <-> HTTP bridge, one JSON-RPC message per line.
+async function bridge() {
+  const tk = token();
+  const rl = createInterface({ input: process.stdin });
+  let sid = null;
+  for await (const line of rl) {
+    if (!line.trim()) continue;
+    let msg;
+    try { msg = JSON.parse(line); } catch { continue; }
+    try {
+      const r = await fetch(MCP, { method: 'POST', headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream', Authorization: 'Bearer ' + tk, 'User-Agent': 'artifactsend-cli/' + VERSION, ...(sid ? { 'Mcp-Session-Id': sid } : {}) }, body: line });
+      sid = r.headers.get('mcp-session-id') || sid;
+      const text = await r.text();
+      if (!text.trim()) continue;
+      const parts = text.startsWith('event:') || text.startsWith('data:') ? text.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim()) : [text];
+      for (const p of parts) process.stdout.write(JSON.stringify(JSON.parse(p)) + '\n');
+    } catch (e) {
+      if (msg.id !== undefined) process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: msg.id, error: { code: -32603, message: String(e.message || e) } }) + '\n');
+    }
+  }
+}
+
+const o = flags(rest);
+try {
+  if (cmd === 'setup' || cmd === 'init' || cmd === 'install') setup(o);
+  else if (cmd === 'send') await send(o);
+  else if (cmd === 'links') print(await call('list_links', o._[0] ? { query: o._.join(' ') } : {}));
+  else if (cmd === 'report') { if (!o._[0]) { console.error('Usage: npx artifactsend report <link>'); process.exit(2); } print(await call('link_report', { link: o._[0] })); }
+  else if (cmd === 'mcp') await bridge();
+  else if (cmd === '--version' || cmd === '-v') console.log(VERSION);
+  else console.log(HELP);
+} catch (e) {
+  console.error(String(e.message || e));
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "artifactsend",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Share documents, decks, HTML pages and Claude artifacts as tracked links and data rooms. See who read them and what they asked. MCP server, agent skills and CLI.",
+  "mcpName": "com.artifactsend/mcp",
+  "type": "module",
+  "bin": {
+    "artifactsend": "bin/artifactsend.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "agent-skills",
+    "claude",
+    "claude-code",
+    "chatgpt",
+    "cursor",
+    "docsend",
+    "docsend-alternative",
+    "document-tracking",
+    "data-room",
+    "share-html",
+    "publish-html",
+    "artifacts",
+    "pitch-deck",
+    "analytics"
+  ],
+  "homepage": "https://artifactsend.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LLM-preneur/skills.git",
+    "directory": "artifactsend"
+  },
+  "bugs": {
+    "url": "https://github.com/LLM-preneur/skills/issues"
+  },
+  "author": "Vela Partners (https://vela.partners)",
+  "license": "MIT"
+}