@letterstory/cli 0.140.0 → 0.142.0

package/lib/cli.mjs

@@ -64,7 +64,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.140.0";
+export const VERSION = "0.142.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. Every `type: "bool"` flag (and its
@@ -75,6 +75,8 @@ export const BOOLEAN_FLAGS = new Set([
 	// sim seed: make the new seed active; collections it doesn't cover start empty.
 	"activate",
 	"empty",
+	// sim create: agents can use it at once, instead of starting paused for review.
+	"live",
 	// admin models runs: only the starred ones.
 	"starred",
 	// shredder file / arena file: save the version as a candidate beside live.

package/lib/commands/enclosures.mjs

@@ -114,6 +114,10 @@ export const ARGS = {
 		generator_id: { positional: 0, label: "enclosure-id", required: true },
 		prospect_id: "prospect",
 	},
+	set_generator_photo: {
+		generator_id: { positional: 0, label: "enclosure-id", required: true },
+		photo_url: { flag: "url", required: true },
+	},
 	get_generator_version: {
 		generator_id: { positional: 0, label: "enclosure-id", required: true },
 		version: { value: (_flags, positionals) => Number(requirePositional(positionals, 1, "version")) },
@@ -182,6 +186,7 @@ const USAGE = `Usage: enclosures <list|show|create|update|prints>
   enclosures starters
   enclosures create --starter site_audit --login <app-id>       Begin from a starter (its version 1 included)
   enclosures write-steps <enclosure-id> [--prospect <id>]        Claude Code writes its steps from its description
+  enclosures photo <enclosure-id> --url <https link>             A sign photo's photo: you holding a blank sheet
   enclosures version <enclosure-id> <n>                        One version in full: its steps and the script prints replay
   enclosures add-version <enclosure-id> (--script <code>|--script-file <path>) --step <text>… [--host <h>…] [--summary <s>]
   enclosures approve <enclosure-id> --version <n>
@@ -215,6 +220,8 @@ export async function cmdEnclosures(ctx) {
 			return enclosuresVersion(rest);
 		case "write-steps":
 			return enclosuresWriteSteps(rest);
+		case "photo":
+			return enclosuresPhoto(rest);
 		case "add-version":
 			return enclosuresAddVersion(rest);
 		case "approve":
@@ -372,6 +379,18 @@ async function enclosuresWriteSteps(ctx) {
 	return 0;
 }
 
+async function enclosuresPhoto(ctx) {
+	const { client, flags, positionals, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.set_generator_photo, []);
+	const result = await client.callTool(
+		"set_generator_photo",
+		argsFromFlags(ARGS.set_generator_photo, flags, positionals)
+	);
+	ok(ctx, `Added version ${result.version} with your photo. Test it, then approve it to print with it.`);
+	printResult(io, flags, result, (r) => `version ${r.version}`);
+	return 0;
+}
+
 async function enclosuresVersion(ctx) {
 	const { client, flags, positionals, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.get_generator_version, []);

package/lib/commands/sim.mjs

@@ -10,6 +10,7 @@
 //   letterstory sim key <id> --agent our-ci --goal "nightly integration test"
 //   letterstory sim seed <id> --prompt "a 3-person content team with two blogs" --activate
 //   letterstory sim seed <id> --use <seed-id|none>
+//   letterstory sim limits <id> --daily-calls 5000 --daily-sessions 100
 //   letterstory sim report <id> --since 7d
 //   letterstory sim sessions <id>
 //   letterstory sim session <session-id>
@@ -57,12 +58,15 @@ export const ARGS = {
 			},
 		},
 		tool_route: "tool-route",
+		live: { flag: "live", type: "bool" },
 		auth_header: "auth-header",
 	},
 	list_simulations: {},
 	get_simulation: { simulation_id: simulationId },
 	update_simulation: {
 		simulation_id: simulationId,
+		daily_call_cap: { flag: "daily-calls", type: "num" },
+		daily_session_cap: { flag: "daily-sessions", type: "num" },
 		status: { flag: "status", enum: ["live", "paused"] },
 		active_seed_id: {
 			value: (flags) => {
@@ -119,6 +123,9 @@ export async function cmdSim(ctx) {
 			if (sub !== "rule") rest.flags = { ...rest.flags, status: sub === "pause" ? "paused" : "live" };
 			return simShow(rest, await call(rest, "update_simulation"));
 		}
+		case "limits":
+			refuseUnknownFlags(rest, ARGS.update_simulation, []);
+			return simShow(rest, await call(rest, "update_simulation"));
 		case "seed":
 			return simSeed(rest);
 		case "key":
@@ -130,7 +137,9 @@ export async function cmdSim(ctx) {
 		case "report":
 			return simReport(rest);
 		default:
-			throw new CliError("Usage: sim [list|create|show|rule|pause|resume|seed|key|sessions|session|report]");
+			throw new CliError(
+				"Usage: sim [list|create|show|rule|pause|resume|limits|seed|key|sessions|session|report]"
+			);
 	}
 }
 
@@ -157,6 +166,10 @@ function simShow(ctx, result) {
 			`  REST  ${s.urls.base}`,
 			`  MCP   ${s.urls.mcp}`,
 			`  Docs  ${s.urls.llms}`,
+			`  Limits ${s.daily_call_cap} calls and ${s.daily_session_cap} new sessions per 24 h; ${s.session_call_cap} calls per session`,
+			...(s.status === "paused"
+				? ["  Paused: review the rules below, then `sim resume <id>` to let agents in."]
+				: []),
 			"",
 			"Resources (rule · side effect · who set it):",
 		];

package/package.json

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