@pen.dev/cli 0.3.7 → 0.3.9

package/README.md

@@ -30,7 +30,7 @@ Creates a new account. You'll receive a verification email — click the link, t
 pen login
 ```
 
-This starts an interactive session where you choose your login method (email + password or email + OTP code). On success the session token is stored in `~/.pencil/session-cli.json`.
+This starts an interactive session where you choose your login method (browser on pen.dev, email + password, or email + OTP). Browser sign-in opens pen.dev for consent, then asks you to paste a one-time code into the CLI. On success the session token is stored in `~/.pencil/session-cli.json`.
 
 ### Non-Interactive Login
 
@@ -105,7 +105,7 @@ pen [command] [options]
 
 Commands:
   signup                 Create a new account (flags required, see below)
-  login                  Log in interactively (email + password or OTP)
+  login                  Log in interactively (browser, email + password, or OTP)
   status                 Check authentication status
   version                Show CLI version
   interactive            Start an interactive tool shell (see below)
@@ -236,12 +236,22 @@ PNG/JPEG/WEBP/PDF images and HTML output.
 
 ### Image Generation
 
-The `execute` `Generate()` operation supports both AI-generated and stock images. Generated images are saved to an `images/` directory alongside the output `.pen` file.
+The `execute` `Generate()` operation brings images and vector artwork into the
+document, either from a prompt or by transforming an image the document already
+has. Generated images are saved to an `images/` directory alongside the output
+`.pen` file.
 
 | Type | Description |
 |------|-------------|
-| `Generate(nodeId, "ai", prompt)` | AI-generated image from a text prompt |
-| `Generate(nodeId, "stock", keywords)` | Stock photo from Unsplash |
+| `Generate("ai", nodeId, prompt)` | AI-generated image from a text prompt |
+| `Generate("stock", nodeId, keywords)` | Stock photo from Unsplash |
+| `Generate("svg", frameId, prompt)` | Vector artwork drawn into the frame |
+| `Generate("vectorize-image", frameId, imageUrl)` | Traces an existing image into vector paths inside the frame |
+| `Generate("remove-background", imageUrl)` | Returns the url of a transparent cutout of the subject |
+| `Generate("replace-background", imageUrl, prompt)` | Returns the url of the subject composed onto a described background |
+
+The two `*-background` types write nothing themselves - apply the url they
+return with `Update(nodeId, {fill: {type: "image", url}})`.
 
 ### Guidelines