@letterstory/cli 0.177.23 → 0.177.25

package/lib/cli.mjs

@@ -88,7 +88,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.177.23";
+export const VERSION = "0.177.25";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -97,6 +97,11 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
 // `negate` spelling) in a command's ARGS map must be listed; boolean-flags.test.ts enforces it.
 export const BOOLEAN_FLAGS = new Set([
+	// visits export: only the people or companies who fit the ICP, or only those who don't.
+	"icp",
+	"not-icp",
+	// org mcp add: the server signs in with OAuth instead of a header value.
+	"sign-in",
 	// collection onboard: connect without drafting or scheduling.
 	"connect-only",
 	// admin demo ideas: every live recipe, not only the Ideas that fit.
@@ -2003,6 +2008,8 @@ Visits (Visitors: AI agents reading your site, and AI answers sending people to
   visits [--agent <a>] [--since 7d] [--path '/docs/*'] [--purpose live|index|training|automated_browser] [--kind page|agent_file|site_file|asset] [--paths <n>] [--site <id>]
                                                        Agent visits: per agent, why they came, most-read paths by kind
   visits citations [--since 30d] [--site <id>]         Visits that clicked through from ChatGPT, Claude, Perplexity…
+  visits who [--icp|--not-icp] [--category <group>] [--path <p>] [--since 30d] [--limit <n>]
+                                                       Who was identified, and who fits your ICP
   visits compare <agent-a> <agent-b> [--since 7d] [--path '/docs/*'] [--purpose <p>]
                                                        Pages one agent read that the other didn't
   visits export [--since 30d] [--format json|csv] [--table agent_visits|citations]

package/lib/commands/org.mjs

@@ -58,6 +58,27 @@ export const ARGS = {
 		project_id: { value: (flags) => (flags.project === "none" ? null : flagStr(flags.project)) },
 	},
 	disconnect_linear: {},
+	list_mcp_connections: {},
+	connect_mcp: {
+		name: { positional: 0, label: "name", required: true },
+		url: { positional: 1, label: "url", required: true },
+		token: { flag: "token" },
+		header_name: { flag: "header" },
+		allow_tools: { flag: "allow", type: "list" },
+		sign_in: { flag: "sign-in", type: "bool" },
+	},
+	test_mcp_connection: { name: { positional: 0, label: "name", required: true } },
+	update_mcp_connection: {
+		name: { positional: 0, label: "name", required: true },
+		enabled: { value: (flags) => (flags.off ? false : flags.on ? true : undefined) },
+		allow_tools: {
+			value: (flags) => (flags.allow === "none" ? [] : flags.allow ? flagStr(flags.allow).split(",") : undefined),
+		},
+		token: { value: (flags) => (flags.clear ? null : flagStr(flags.token)) },
+		header_name: { flag: "header" },
+		sign_in: { flag: "sign-in", type: "bool" },
+	},
+	remove_mcp_connection: { name: { positional: 0, label: "name", required: true } },
 	connect_org_config_source: {
 		repo: { positional: 0, label: "owner/name" },
 		branch: { flag: "branch" },
@@ -91,11 +112,13 @@ export async function cmdOrg(ctx) {
 			return orgFields(rest);
 		case "linear":
 			return orgLinear(rest);
+		case "mcp":
+			return orgMcp(rest);
 		case "billing":
 			return orgBilling(rest);
 		default:
 			throw new CliError(
-				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations, linear, fields, billing`
+				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations, linear, mcp, fields, billing`
 			);
 	}
 }
@@ -454,6 +477,105 @@ async function orgLinear(ctx) {
 	}
 }
 
+/**
+ * `org mcp` — other products' MCP servers Letter's agent can call (docs/architecture/mcp-connections.md):
+ *   org mcp                                              the connections (list_mcp_connections)
+ *   org mcp add <name> <url> [--token <value> [--header <name>] | --sign-in] [--allow a,b]   (connect_mcp)
+ *   org mcp signin <name>                                sign in again with OAuth (update_mcp_connection)
+ *   org mcp tools <name>                                 read the server's tools again (test_mcp_connection)
+ *   org mcp allow <name> <a,b|none>                      the tools that change things the agent may call (update_mcp_connection)
+ *   org mcp on|off <name>                                (update_mcp_connection)
+ *   org mcp token <name> <value>|--clear                 a new header value (update_mcp_connection)
+ *   org mcp remove <name>                                (remove_mcp_connection)
+ */
+async function orgMcp(ctx) {
+	const { client, flags, io } = ctx;
+	const sub = ctx.positionals[0] ?? "list";
+	const rest = ctx.positionals.slice(1);
+	const call = async (tool, allowed, args) => {
+		refuseUnknownFlags(ctx, {}, allowed);
+		const result = await client.callTool(tool, args ?? argsFromFlags(ARGS[tool], flags, rest));
+		ok(ctx, result.message);
+		return result;
+	};
+	const tools = (r) =>
+		r.tools
+			.map((t) => `${t.allowed ? "●" : "○"} ${t.name}${t.read_only ? "  (reads only)" : ""}  ${t.description}`)
+			.join("\n");
+	switch (sub) {
+		case "list": {
+			const result = await call("list_mcp_connections", []);
+			printResult(
+				io,
+				flags,
+				result,
+				(r) =>
+					r.connections
+						.map(
+							(c) =>
+								`${c.enabled ? "●" : "○"} ${c.name}  ${c.url}  ${c.tool_count ?? "?"} tools${c.last_status === "failed" ? `  (failed: ${c.last_error})` : ""}`
+						)
+						.join("\n") || r.message
+			);
+			return 0;
+		}
+		case "add": {
+			const result = await call("connect_mcp", ["token", "header", "allow", "sign-in"]);
+			printResult(io, flags, result, (r) =>
+				r.sign_in_url ? `${r.message}\n${r.sign_in_url}` : `${r.message}\n${tools(r)}`
+			);
+			return 0;
+		}
+		case "signin": {
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				sign_in: true,
+			});
+			printResult(io, flags, result, (r) => `${r.message}\n${r.sign_in_url}`);
+			return 0;
+		}
+		case "tools": {
+			const result = await call("test_mcp_connection", []);
+			printResult(io, flags, result, tools);
+			return 0;
+		}
+		case "allow": {
+			const list = requirePositional(rest, 1, "a,b|none");
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				allow_tools: list === "none" ? [] : list.split(","),
+			});
+			printResult(io, flags, result, tools);
+			return 0;
+		}
+		case "on":
+		case "off": {
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				enabled: sub === "on",
+			});
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "token": {
+			const name = requirePositional(rest, 0, "name");
+			const value = flags.clear ? null : requirePositional(rest, 1, "value");
+			const result = await call("update_mcp_connection", ["clear"], { name, token: value });
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "remove": {
+			const result = await call("remove_mcp_connection", []);
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		default:
+			throw new CliError(
+				`Unknown org mcp subcommand: ${sub}. Try: add, signin, tools, allow, on, off, token, remove`
+			);
+	}
+}
+
 const ROOT_FILE = "organization.json";
 
 function slug(name) {

package/lib/commands/visits.mjs

@@ -9,6 +9,7 @@
 //   letterstory visits compare chatgpt claude --path '/docs/*' --since 7d
 //   letterstory visits citations --since 30d
 //   letterstory visits people --since 30d [--path /pricing]   people who read the site, and how many were identified
+//   letterstory visits who --icp [--category Investors] [--path /pricing]   who was identified (--icp: who fits your ICP)
 //   letterstory visits export --since 30d --format csv
 //   letterstory visits sites
 //   letterstory visits domain composal.com [--site <id>]   move the site to a new domain, keeping its key
@@ -43,6 +44,14 @@ export const ARGS = {
 	},
 	visitors_get_citations: { site_id: "site", days },
 	visitors_get_human_visits: { site_id: "site", days, path: "path" },
+	visitors_get_people: {
+		site_id: "site",
+		days,
+		path: "path",
+		category: "category",
+		limit: { flag: "limit", type: "num" },
+		icp: { flag: "icp", type: "bool", negate: "not-icp" },
+	},
 	visitors_admin_coverage: { site_id: "site" },
 	visitors_add_connector: {
 		site_id: "site",
@@ -99,6 +108,8 @@ export async function cmdVisits(ctx) {
 			return visitsCitations(rest);
 		case "people":
 			return visitsPeople(rest);
+		case "who":
+			return visitsWho(rest);
 		case "compare":
 			return visitsCompare(rest);
 		case "export":
@@ -119,7 +130,7 @@ export async function cmdVisits(ctx) {
 			return visitsDisconnect(rest);
 		default:
 			throw new CliError(
-				"Usage: visits [list|citations|people|compare|export|sites|domain|pages|health|connect|connectors|disconnect]"
+				"Usage: visits [list|citations|people|who|compare|export|sites|domain|pages|health|connect|connectors|disconnect]"
 			);
 	}
 }
@@ -311,6 +322,25 @@ async function visitsPeople(ctx) {
 	return 0;
 }
 
+async function visitsWho(ctx) {
+	const { flags, io } = ctx;
+	const result = await call(ctx, "visitors_get_people");
+	printResult(io, flags, result, (r) => {
+		if (!r.enabled) return "Identification is off for this site.";
+		const lines = [];
+		if (r.icp) lines.push(`ICP: ${r.icp} (${r.icp_total} fit)`);
+		else if (r.icp_filter !== null) lines.push("No ICP set. Set it in Memory → General.");
+		lines.push(`${r.total} identified in the last ${r.window_days} days`);
+		for (const v of r.visitors) {
+			const fit = v.icp_fit === true ? `  ICP: ${v.icp_reason ?? "fits"}` : "";
+			const where = [v.title, v.company ?? v.company_domain].filter(Boolean).join(", ");
+			lines.push(`  ${v.name ?? "Unknown"}${where ? ` (${where})` : ""}  ${v.category ?? "Others"}${fit}`);
+		}
+		return lines.join("\n");
+	});
+	return 0;
+}
+
 async function visitsCompare(ctx) {
 	const { flags, io } = ctx;
 	const result = await call(ctx, "visitors_compare_agents");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.177.23",
+	"version": "0.177.25",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",