cueloop 0.1.0-alpha.37 → 0.1.0-alpha.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueloop",
-  "version": "0.1.0-alpha.37",
+  "version": "0.1.0-alpha.39",
   "description": "Terminal review surface for coding agents: annotate plans and diffs, return a verdict, send structured feedback back",
   "homepage": "https://github.com/mmurakaru/cueloop#readme",
   "bugs": {
@@ -27,10 +27,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@cueloop/adapters": "0.1.0-alpha.37",
-    "@cueloop/client": "0.1.0-alpha.37",
-    "@cueloop/daemon": "0.1.0-alpha.37",
-    "@cueloop/schema": "0.1.0-alpha.37"
+    "@cueloop/adapters": "0.1.0-alpha.39",
+    "@cueloop/client": "0.1.0-alpha.39",
+    "@cueloop/daemon": "0.1.0-alpha.39",
+    "@cueloop/schema": "0.1.0-alpha.39"
   },
   "engines": {
     "bun": ">=1.3.0"

package/src/actions-command.ts

@@ -0,0 +1,40 @@
+/**
+ * `cueloop actions list [--session <id>]` - print the quick-action vocabulary
+ * (the same presets a human picks in the marker popover) so a review-side agent
+ * can reference one by name or index via `session annotate --action`. With
+ * `--session`, the vocabulary comes from that session's repo (matching what
+ * `--action` will resolve); otherwise from the caller's cwd. JSON on stdout.
+ */
+
+import { loadConfig } from "@cueloop/client/config";
+import { DaemonClient } from "@cueloop/daemon/client";
+import { parseArgs, stringFlag } from "./args";
+
+export async function actionsCommand(argv: string[]): Promise<number> {
+  const { positional, flags } = parseArgs(argv);
+  const verb = positional[0] ?? "list";
+  if (verb !== "list") {
+    console.error("usage: cueloop actions list [--session <id>]");
+    return 2;
+  }
+  const repoRoot = await repoRootForSession(stringFlag(flags, "session"));
+  const actions = loadConfig({ repoRoot }).actions;
+  const numbered = actions.map((action, index) => ({
+    index: index + 1,
+    prompt: action.prompt,
+    metadata: action.metadata,
+  }));
+  console.log(JSON.stringify(numbered, null, 2));
+  return 0;
+}
+
+/** The repo the given session lives in, or the caller's cwd when no session is named. */
+async function repoRootForSession(sessionId: string | undefined): Promise<string> {
+  if (sessionId === undefined) return process.cwd();
+  const client = await DaemonClient.connect({ autostart: true });
+  try {
+    return (await client.sessionGet(sessionId)).workspace.repoRoot;
+  } finally {
+    client.close();
+  }
+}

package/src/main.ts

@@ -89,6 +89,10 @@ async function main(): Promise<number> {
       const { wakeCommand } = await import("./wake-command");
       return wakeCommand(argv.slice(1));
     }
+    case "actions": {
+      const { actionsCommand } = await import("./actions-command");
+      return actionsCommand(argv.slice(1));
+    }
     case "review":
       return reviewEntry(argv.slice(1));
     case "review-post": {
@@ -254,6 +258,7 @@ function printHelp(): void {
       "",
       "scripting:",
       "  cueloop session <verb> [flags]   script the daemon (create|get|list|wait|annotate|resolve|submit-revision)",
+      "  cueloop actions list             list the quick-action vocabulary (for annotate --action)",
       "  cueloop wake <id> [--harness codex --thread <id>]  resume the agent with the verdict (spawn detached)",
       "  cueloop review-post <id> <pr>    post a resolved session's verdict back to the PR",
       "  cueloop daemon                   run the daemon in the foreground",

package/src/session-commands.ts

@@ -8,6 +8,7 @@ import { newAnnotationId, type ArtifactType, type VerdictKind } from "@cueloop/s
 import { DaemonClient } from "@cueloop/daemon/client";
 import { openHerdrPaneForReview } from "@cueloop/daemon/herdr-pane";
 import { openReview, verdictResponse, type ReviewNote } from "@cueloop/daemon/review";
+import { loadConfig, quickActionBody, resolveQuickAction } from "@cueloop/client/config";
 import { parseArgs, stringFlag } from "./args";
 
 async function readStdin(): Promise<string> {
@@ -42,10 +43,8 @@ export async function sessionCommand(argv: string[]): Promise<number> {
           title: stringFlag(flags, "title"),
           notes,
         });
-        // herdr auto-open: a review created from inside herdr spawns a new tab
-        // that renders it. Guarded to genuinely new sessions and no-op outside
-        // herdr; a broken binary never blocks the create.
-        openHerdrPaneForReview(review.session);
+        // herdr auto-open: render the review in a tab (no-op outside herdr).
+        await openHerdrPaneForReview(review.session, client);
         out(review.session);
         return 0;
       }
@@ -72,19 +71,25 @@ export async function sessionCommand(argv: string[]): Promise<number> {
       }
       case "annotate": {
         const id = required(positional[1], "session id");
-        const body = stringFlag(flags, "body") ?? "";
         const quote = required(stringFlag(flags, "quote"), "--quote");
+        const author = stringFlag(flags, "author");
+        const body = await annotateBody(flags, client, id);
         out(
-          await client.sessionAnnotate(id, {
-            id: stringFlag(flags, "annotation-id") ?? newAnnotationId(),
-            kind: stringFlag(flags, "kind") ?? "comment",
-            anchor: {
-              quote,
-              prefix: stringFlag(flags, "prefix") ?? "",
-              suffix: stringFlag(flags, "suffix") ?? "",
+          await client.sessionAnnotate(
+            id,
+            {
+              id: stringFlag(flags, "annotation-id") ?? newAnnotationId(),
+              kind: stringFlag(flags, "kind") ?? "comment",
+              anchor: {
+                quote,
+                prefix: stringFlag(flags, "prefix") ?? "",
+                suffix: stringFlag(flags, "suffix") ?? "",
+              },
+              body,
+              ...(author ? { author } : {}),
             },
-            body,
-          }),
+            stringFlag(flags, "author-name"),
+          ),
         );
         return 0;
       }
@@ -121,3 +126,25 @@ function required<T>(value: T | undefined, description: string): T {
   if (value === undefined) throw new Error(`missing ${description}`);
   return value;
 }
+
+/**
+ * The annotation body: an explicit `--body`, else the `--action <index|name>`
+ * quick-action expanded through the shared vocabulary. The vocabulary is loaded
+ * from the reviewed session's own repo, not the caller's cwd, so an agent
+ * annotating from elsewhere still sees that session's actions.
+ */
+async function annotateBody(
+  flags: Record<string, string | boolean>,
+  client: DaemonClient,
+  id: string,
+): Promise<string> {
+  const explicit = stringFlag(flags, "body");
+  if (explicit !== undefined) return explicit;
+  const actionRef = stringFlag(flags, "action");
+  if (actionRef === undefined) return "";
+  const session = await client.sessionGet(id);
+  const actions = loadConfig({ repoRoot: session.workspace.repoRoot }).actions;
+  const action = resolveQuickAction(actions, actionRef);
+  if (!action) throw new Error(`no quick action ${actionRef} - see: cueloop actions list`);
+  return quickActionBody(action);
+}