cueloop 0.1.0-alpha.34 → 0.1.0-alpha.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueloop",
-  "version": "0.1.0-alpha.34",
+  "version": "0.1.0-alpha.35",
   "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,9 +27,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@cueloop/client": "0.1.0-alpha.34",
-    "@cueloop/daemon": "0.1.0-alpha.34",
-    "@cueloop/schema": "0.1.0-alpha.34"
+    "@cueloop/adapters": "0.1.0-alpha.35",
+    "@cueloop/client": "0.1.0-alpha.35",
+    "@cueloop/daemon": "0.1.0-alpha.35",
+    "@cueloop/schema": "0.1.0-alpha.35"
   },
   "engines": {
     "bun": ">=1.3.0"

package/src/main.ts

@@ -85,6 +85,10 @@ async function main(): Promise<number> {
         return sharePullCommand({ ...target, sessionId: positional[1] });
       return shareCommand({ ...target, sessionId: positional[0] });
     }
+    case "wake": {
+      const { wakeCommand } = await import("./wake-command");
+      return wakeCommand(argv.slice(1));
+    }
     case "review":
       return reviewEntry(argv.slice(1));
     case "review-post": {
@@ -250,6 +254,7 @@ function printHelp(): void {
       "",
       "scripting:",
       "  cueloop session <verb> [flags]   script the daemon (create|get|list|wait|annotate|resolve|submit-revision)",
+      "  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/wake-command.test.ts

@@ -0,0 +1,14 @@
+/** cueloop wake argument guards: a missing session id and a codex wake without a thread id both fail with a usage code before any daemon or harness work. */
+
+import { describe, expect, test } from "bun:test";
+import { wakeCommand } from "./wake-command";
+
+describe("wakeCommand argument guards", () => {
+  test("a missing session id is a usage error", async () => {
+    expect(await wakeCommand([])).toBe(2);
+  });
+
+  test("a codex wake without a thread id is a usage error", async () => {
+    expect(await wakeCommand(["ses_1", "--harness", "codex"])).toBe(2);
+  });
+});

package/src/wake-command.ts

@@ -0,0 +1,37 @@
+/**
+ * `cueloop wake <session-id>` - the production caller for the non-blocking wake.
+ * A detached child of a coding-agent session parks on the review's verdict and
+ * injects it back into that same live session when the human decides, so the
+ * agent resumes itself without a blocked, pinned tool call. The plan skill (and
+ * the Claude Code hook's non-blocking path) spawn this right after a
+ * non-blocking review:  `cueloop wake <session-id> &`.
+ *
+ * Claude Code is the default and reads its inbox socket from the environment.
+ * Codex needs its running thread id (`--harness codex --thread <thread-id>`).
+ * pi wakes in-process from its extension and does not use this command.
+ */
+
+import { parseArgs, stringFlag } from "./args";
+
+export async function wakeCommand(argv: string[]): Promise<number> {
+  const { positional, flags } = parseArgs(argv);
+  const sessionId = positional[0];
+  if (sessionId === undefined) {
+    console.error(
+      "usage: cueloop wake <session-id> [--harness claude-code|codex] [--thread <codex-thread-id>]",
+    );
+    return 2;
+  }
+  const harness = stringFlag(flags, "harness") ?? "claude-code";
+  if (harness === "codex") {
+    const threadId = stringFlag(flags, "thread");
+    if (threadId === undefined) {
+      console.error("cueloop wake --harness codex needs --thread <codex-thread-id>");
+      return 2;
+    }
+    const { runCodexWake } = await import("@cueloop/adapters/codex/wake");
+    return (await runCodexWake(sessionId, threadId)) ? 0 : 1;
+  }
+  const { runInboxWake } = await import("@cueloop/adapters/claude-code/wake");
+  return (await runInboxWake(sessionId)) ? 0 : 1;
+}