@letterstory/cli 0.29.3 → 0.30.0

package/lib/cli.mjs

@@ -44,7 +44,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.29.3";
+export const VERSION = "0.30.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -567,6 +567,7 @@ Ledes (opening lines for cold email, chosen per prospect from a hand-approved li
                                                        no_match is free. --no-enrich skips the company
                                                        lookup when latency matters more than fit.
   lede runs [--endpoint <id>] [--limit <n>]            Recent lede calls (telemetry), newest first
+  lede history [<domain>] [--days <n>] [--limit <n>]   Openers already sent to an account
   lede balance                                         Ledes left on this org
 
 Landings (a link + context; auto-mentioned in articles by collections you enable):

package/lib/commands/kernel.mjs

@@ -93,14 +93,15 @@ export const ARGS = {
 		// it from a path. Omit both to write from the article as it stands.
 		brief: { value: (flags) => flagStr(flags.brief) ?? readBodyInput({ file: flagStr(flags["brief-file"]) }) },
 		// How to read --brief: auto (default) treats a short topic as instruction and a pasted
-		// draft/article as source material to decompose first. Same flag name as run_kernel's.
+		// draft/article as source material to decompose first — your own finished post is
+		// `article`. Same flag name as run_kernel's.
 		content_kind: {
 			flag: "read-as",
 			enum: ["auto", "instruction", "document", "article", "outline", "research", "notes"],
 		},
 	},
 	// The standalone door. Two subcommands share this one tool: `write` and `polish` both
-	// send `input`, `polish` forcing content_kind to "document" — the map is one, so a field
+	// send `input`, `polish` defaulting content_kind to "article" — the map is one, so a field
 	// the tool gains is a field BOTH subcommands must learn (or knowingly gap) — that is the
 	// ratchet.
 	run_kernel: {
@@ -169,8 +170,9 @@ export const ARGS = {
 		// `[{"name":"...","treatment":"never"|"mention_once"|"mention_often"|"lead_company",
 		// "linkable":false}, ...]` (linkable optional, default true).
 		entities: { value: (flags) => readJsonFileFlag(flags, "entities-file") },
-		// content_kind "document" only: hold the document's own shape through the edit. Default
-		// true; pass --no-preserve-shape to let the kernel restructure freely.
+		// Hold the input's own shape and embedded media through the rewrite, on any kind that
+		// is decomposed. Default true; pass --no-preserve-shape to let the kernel restructure
+		// freely.
 		preserve_shape: { flag: "preserve-shape", type: "bool" },
 	},
 	create_kernel_endpoint: {
@@ -364,16 +366,22 @@ async function kernelEndpoint(ctx) {
 
 /**
  * The OTHER door: run the same pipeline against a document you already have, instead of
- * writing a new one. Decomposed into a brief and GENERATED FRESH (content_kind: "document",
- * forced below) — not edited in place — with your own headings and embedded media (images,
+ * writing a new one. Decomposed into a brief and GENERATED FRESH (content_kind: "article",
+ * defaulted below) — not edited in place — with your own headings and embedded media (images,
  * tables) extracted first and spliced back into the generated draft afterward, so they
  * survive a pass that would otherwise be text-only and lose them.
  *
+ * IT IS NOT ITS OWN CONTENT KIND any more (2026-09-22). This used to send `document`, the one
+ * kind that held media — which meant `letterstory kernel write --read-as article` on the same
+ * file quietly dropped it. Holding what a text-only decompose cannot carry is now the default
+ * on every decomposed kind, so `polish` is `write` with the kind named for you, and nothing
+ * else. `document` still parses if you pass it; it resolves to `article`.
+ *
  * ASYNCHRONOUS, same as `write` — this used to be a separate, synchronous, unmetered "polish"
  * that answered in one request, and before that an EARLIER `document` mode that skipped
  * generation to hold shape "in place." Neither exists any more (2026-09-15, letterstory#1783;
- * 2026-09-17). `document` now costs a run and follows the identical submit-and-poll shape
- * `write` does, so this command does too — `--no-wait` behaves the same way here.
+ * 2026-09-17). It now costs a run and follows the identical submit-and-poll shape `write`
+ * does, so this command does too — `--no-wait` behaves the same way here.
  */
 async function kernelPolish(ctx) {
 	const { client, positionals, flags, io } = ctx;
@@ -381,7 +389,7 @@ async function kernelPolish(ctx) {
 	if (args.input === undefined) {
 		throw new CliError("Provide the document with --body <text>, --file <path>, or --file - (stdin).");
 	}
-	args.content_kind = args.content_kind ?? "document";
+	args.content_kind = args.content_kind ?? "article";
 	const result = await client.callTool("run_kernel", args);
 	const runId = toolField(result, "run_id");
 	if (!runId) {

package/lib/commands/lede.mjs

@@ -51,6 +51,8 @@ export const ARGS = {
 		notes: "notes",
 		max_candidates: { flag: "candidates", type: "num" },
 		tone: { flag: "tone", enum: ["warm", "direct", "playful", "formal"] },
+		// How picky to be, in bits of distinctiveness. Below the floor is a free no_match.
+		distinctiveness_floor: { flag: "floor", type: "num" },
 		// Your own fallback line, returned (unbilled, still no_match) when nothing qualifies.
 		default_lede: { flag: "default-lede" },
 		// Enrichment is ON by default server-side; `--no-enrich` skips it for latency.
@@ -60,6 +62,13 @@ export const ARGS = {
 		endpoint_id: "endpoint",
 		limit: { flag: "limit", type: "num" },
 	},
+	// What has already been said to an account, so the next send does not repeat it.
+	lede_account_history: {
+		domain: { positional: 0, label: "domain" },
+		endpoint_id: "endpoint",
+		days: { flag: "days", type: "num" },
+		limit: { flag: "limit", type: "num" },
+	},
 	list_lede_endpoints: {},
 	get_lede_balance: {},
 	create_lede_endpoint: {
@@ -99,11 +108,14 @@ export async function cmdLede(ctx) {
 		case "runs":
 		case "telemetry":
 			return ledeRuns(rest);
+		case "history":
+		case "sent":
+			return ledeHistory(rest);
 		case "balance":
 			return ledeBalance(rest);
 		default:
 			throw new CliError(
-				`Unknown lede subcommand: ${sub ?? "(none)"}. Try: list, create, delete, endpoint, run, runs, balance`
+				`Unknown lede subcommand: ${sub ?? "(none)"}. Try: list, create, delete, endpoint, run, runs, history, balance`
 			);
 	}
 }
@@ -217,6 +229,16 @@ async function ledeRuns(ctx) {
 	return 0;
 }
 
+// `lede history acme.com` — what has already been said to that account, so the next
+// send does not repeat it. Omit the domain for a picture across every account.
+async function ledeHistory(ctx) {
+	const { client, flags, io, positionals } = ctx;
+	const args = argsFromFlags(ARGS.lede_account_history, flags, positionals);
+	const result = await client.callTool("lede_account_history", args);
+	printResult(io, flags, result);
+	return 0;
+}
+
 async function ledeBalance(ctx) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool("get_lede_balance", argsFromFlags(ARGS.get_lede_balance, flags));

package/package.json

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