@paneui/cli 0.0.1 → 0.0.3

package/dist/commands/create.js

@@ -58,7 +58,10 @@ Options:
                       the --artifact value is treated as a URL. Note: the relay
                       does not serve "html-ref" artifacts in this release and
                       will reject the session — use "html-inline".
-  --ttl <seconds>     Session time-to-live in seconds.
+  --ttl <seconds>     Session time-to-live in seconds. The relay clamps this
+                      to its configured MAX_TTL_SECONDS (defaults: 1 h
+                      requested, 24 h max for self-host; hosted may differ).
+                      The returned \`expires_at\` is the authoritative value.
   --participants <n>  Number of human participants (default 1).
   --metadata <path|json>  Arbitrary metadata object (file path or inline JSON).
   --callback <path|json>  Webhook callback config: { url, events[], secret }.

package/dist/commands/taste.js

@@ -0,0 +1,148 @@
+// `pane taste` — read / write / clear the calling agent's freeform "taste
+// notes" markdown blob.
+//
+// Taste notes are presentation preferences the agent has learned from human
+// feedback ("denser layout", "no rounded corners", "use a dark header") — the
+// kind of guidance that should outlive a single session. The intended loop:
+//
+//   1. Before generating a pane artifact, run `pane taste get` and feed the
+//      `taste` field into the prompt so prior preferences shape the output.
+//   2. When the human gives new presentation feedback, run `pane taste get`,
+//      merge the feedback into the existing notes IN THE PROMPT, then call
+//      `pane taste set` with the WHOLE new blob (the relay does whole-blob
+//      replace, not append — that's deliberate, so the notes can't grow
+//      unbounded into noise).
+//
+// Keep taste notes about *presentation/UI taste only* — colours, density,
+// component preferences. Project context, todos, and per-session state belong
+// somewhere else. Today the blob is keyed by the agent's API key (per-agent);
+// when pane gains first-class humans, this may move to per-human.
+import { readFileSync } from "node:fs";
+import { makeClient } from "../config.js";
+import { printJson, fail, failFromError } from "../output.js";
+export const tasteHelp = `pane taste — read / write / clear YOUR agent's UI taste notes
+
+Taste notes are a small markdown blob storing presentation preferences your
+agent has picked up from human feedback ("denser table", "no rounded corners",
+"use a dark header"). Read them before generating a pane artifact so prior
+feedback shapes the output; rewrite them whenever the human gives new
+presentation feedback. Keep entries about UI/presentation taste only — not
+project context, todos, or session state.
+
+Usage:
+  pane taste <subcommand> [options]
+
+Subcommands:
+  get        Print the current notes blob:
+             { taste: string|null, updated_at: string|null, bytes: number }.
+             taste is null and bytes is 0 when notes have never been written.
+
+  set        Whole-blob replace. Read markdown from stdin OR --file <path>
+             (exactly one). The relay rejects empty/whitespace-only payloads
+             and caps the blob at MAX_TASTE_BYTES (utf8). To clear the notes,
+             use 'pane taste clear', not 'set' with an empty body.
+
+  clear      Delete the notes. Requires --yes (it is destructive). Prints
+             { cleared: true }.
+
+Options:
+  --file <path>       Read 'set' input from <path> (otherwise reads stdin).
+  --yes               Confirm 'clear'.
+  --url <url>         Relay base URL (overrides PANE_URL).
+  --api-key <key>     Agent API key (overrides PANE_API_KEY).
+  -h, --help          Show this help.
+
+Examples:
+  pane taste get
+  echo "- denser layout\\n- no rounded corners" | pane taste set
+  pane taste set --file ./taste.md
+  pane taste clear --yes
+
+Output: stdout is machine-readable JSON.`;
+// Drain process.stdin to a utf8 string. Resolves to "" when stdin is a TTY
+// (i.e. nothing was piped in), so the caller can detect "no input" and emit a
+// proper error instead of hanging forever waiting for keystrokes.
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+async function runTasteGet(args) {
+    const client = makeClient(args);
+    try {
+        const info = await client.getTaste();
+        printJson(info);
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+async function runTasteSet(args) {
+    const filePath = args.flags.get("file");
+    const hasStdin = !process.stdin.isTTY;
+    if (filePath !== undefined && hasStdin) {
+        fail("'pane taste set' takes input from EITHER stdin OR --file <path>, not both", "invalid_args");
+    }
+    if (filePath === undefined && !hasStdin) {
+        fail("'pane taste set' needs input — pipe markdown on stdin or pass --file <path>", "invalid_args");
+    }
+    let taste;
+    if (filePath !== undefined) {
+        try {
+            taste = readFileSync(filePath, "utf8");
+        }
+        catch (e) {
+            fail(`failed to read --file '${filePath}': ${e instanceof Error ? e.message : String(e)}`, "invalid_args");
+        }
+    }
+    else {
+        taste = await readStdin();
+    }
+    if (taste.trim().length === 0) {
+        fail("'pane taste set' refuses an empty or whitespace-only blob — use 'pane taste clear --yes' to delete the notes", "invalid_args");
+    }
+    const client = makeClient(args);
+    try {
+        const info = await client.setTaste(taste);
+        printJson(info);
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+async function runTasteClear(args) {
+    if (!args.bools.has("yes")) {
+        fail("'pane taste clear' deletes YOUR agent's taste notes — it is destructive. Pass --yes to confirm.", "confirmation_required");
+    }
+    const client = makeClient(args);
+    try {
+        await client.clearTaste();
+        printJson({ cleared: true });
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+export async function runTaste(args) {
+    const sub = args.positionals[0];
+    switch (sub) {
+        case "get":
+            await runTasteGet(args);
+            break;
+        case "set":
+            await runTasteSet(args);
+            break;
+        case "clear":
+            await runTasteClear(args);
+            break;
+        case undefined:
+            fail("missing subcommand — usage: pane taste <get|set|clear> (run 'pane taste --help')", "invalid_args");
+            break;
+        default:
+            fail(`unknown taste subcommand '${sub}' — expected get|set|clear (run 'pane taste --help')`, "invalid_args");
+    }
+}

package/dist/index.js

@@ -13,8 +13,9 @@ import { runArtifact, artifactHelp } from "./commands/artifact.js";
 import { runConfig, configHelp } from "./commands/config.js";
 import { runLogout, logoutHelp } from "./commands/logout.js";
 import { runKeys, keysHelp } from "./commands/keys.js";
+import { runTaste, tasteHelp } from "./commands/taste.js";
 import { runDelete, deleteHelp } from "./commands/delete.js";
-const VERSION = "0.0.1";
+const VERSION = "0.0.3";
 const ROOT_HELP = `pane — a round-trip UI channel between agents and humans
 
 Usage:
@@ -33,6 +34,10 @@ Commands:
                     (long-lived; the building block for pipe-readers).
   delete <id>       Close/delete a session (DELETE /v1/sessions/:id).
   keys              Inspect or revoke YOUR agent's API key (list / revoke).
+  taste             Read / write / clear YOUR agent's UI taste notes
+                    (get / set / clear) — presentation preferences the agent
+                    has learned from human feedback and reads before
+                    generating a pane artifact.
   config            Show the resolved relay config (no network call).
   logout            Clear the locally-saved relay URL + API key.
 
@@ -99,6 +104,7 @@ async function main() {
         watch: watchHelp,
         delete: deleteHelp,
         keys: keysHelp,
+        taste: tasteHelp,
         config: configHelp,
         logout: logoutHelp,
     };
@@ -140,6 +146,9 @@ async function main() {
         case "keys":
             await runKeys(args);
             break;
+        case "taste":
+            await runTaste(args);
+            break;
         case "config":
             await runConfig(args);
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paneui/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Command-line client for the Pane relay: create sessions, inspect state, send and watch events.",
   "license": "MIT",
   "type": "module",
@@ -41,7 +41,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@paneui/core": "^0.0.1"
+    "@paneui/core": "^0.0.3"
   },
   "devDependencies": {
     "@types/node": "^22.7.0",