agent-ticketing 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # agent-ticketing
 
-Agent SDK for **Agent Mailbox** — claim tickets, heartbeat, ask the requester, complete. Zero dependencies, Node 18+.
+Agent SDK for **Agent Ticketing** — claim tickets, heartbeat, ask the requester, complete. Zero dependencies, Node 18+.
 
 ```bash
 npm install agent-ticketing   # (or use it from this repo via workspaces)
@@ -12,7 +12,7 @@ npm install agent-ticketing   # (or use it from this repo via workspaces)
 import { MailboxAgent } from "agent-ticketing";
 
 const mailbox = new MailboxAgent({
-  baseUrl: "https://agent-mailbox.<you>.workers.dev",
+  baseUrl: "https://agent-ticketing.<you>.workers.dev",
   apiKey: process.env.MAILBOX_API_KEY, // mbx_live_… from Settings → Agents
 });
 
@@ -59,9 +59,14 @@ NOT keep the Durable Object hot, so pick the mode by latency preference, not cos
   the thinking, the ticket is completed with its output.
 
 ```bash
-MAILBOX_URL=https://… MAILBOX_API_KEY=mbx_live_… node examples/runner-claude.mjs --interval 5m
+MAILBOX_URL=https://… MAILBOX_API_KEY=mbx_live_… \
+npx -y -p agent-ticketing mailbox-claude-runner    # add --interval 5m for lazy polling
 ```
 
+Runners are agent-specific — `mailbox-claude-runner` launches headless **Claude Code**
+sessions. Runners for Codex and daemon-style agents (Hermes, OpenClaw) are planned;
+for a custom harness, embed the SDK instead (below).
+
 ## Low-level client
 
 Every REST endpoint is also exposed directly if you don't want the loop:

package/dist/runner.js

@@ -7,11 +7,9 @@
  *   MAILBOX_URL=https://…workers.dev MAILBOX_API_KEY=mbx_live_… \
  *   npx @mailbox/agent   # or: mailbox-claude-runner [--interval 5m] [--once]
  */
-import { execFile } from "node:child_process";
+import { spawn } from "node:child_process";
 import { appendFileSync } from "node:fs";
-import { promisify } from "node:util";
 import { MailboxAgent } from "./index.js";
-const exec = promisify(execFile);
 const baseUrl = process.env.MAILBOX_URL;
 const apiKey = process.env.MAILBOX_API_KEY;
 if (!baseUrl || !apiKey) {
@@ -50,14 +48,50 @@ function promptFor(ticket, messages) {
         thread,
     ].join("\n");
 }
+/**
+ * Run `claude -p` with the prompt on STDIN (immune to ARG_MAX for long threads,
+ * keeps ticket text out of `ps`). On failure, the error carries the exit code
+ * AND the stderr tail — so the release reason / ndjson log show the real cause.
+ */
+function runClaude(prompt, signal) {
+    return new Promise((resolve, reject) => {
+        // The runner is often launched from INSIDE a Claude session (setup prompt);
+        // strip nested-session markers so the child behaves like a fresh CLI run.
+        const env = { ...process.env };
+        delete env.CLAUDECODE;
+        delete env.CLAUDE_CODE_ENTRYPOINT;
+        const child = spawn(claudeCmd, ["-p", "--output-format", "text"], {
+            env,
+            signal,
+            timeout: 10 * 60 * 1000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (d) => {
+            if (stdout.length < 10 * 1024 * 1024)
+                stdout += d.toString();
+        });
+        child.stderr.on("data", (d) => {
+            if (stderr.length < 1024 * 1024)
+                stderr += d.toString();
+        });
+        child.on("error", (e) => reject(new Error(`could not run "${claudeCmd}": ${e.message}`)));
+        child.on("close", (code, sig) => {
+            if (code === 0)
+                return resolve(stdout);
+            const tail = stderr.trim().slice(-600) || stdout.trim().slice(-600) || "(no output)";
+            reject(new Error(`${claudeCmd} exited with ${sig ? `signal ${sig}` : `code ${code}`}: ${tail}`));
+        });
+        child.stdin.on("error", () => undefined); // child died before reading stdin; close() reports it
+        child.stdin.write(prompt);
+        child.stdin.end();
+    });
+}
 const controller = new AbortController();
 await mailbox.poll(async (ticket, ctx) => {
     await ctx.progress("launching headless Claude Code session");
-    const { stdout } = await exec(claudeCmd, ["-p", promptFor(ticket, ctx.messages), "--output-format", "text"], {
-        timeout: 10 * 60 * 1000,
-        maxBuffer: 10 * 1024 * 1024,
-        signal: ctx.signal,
-    });
+    const stdout = await runClaude(promptFor(ticket, ctx.messages), ctx.signal);
     const result = stdout.trim();
     if (!result)
         throw new Error("claude produced no output");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-ticketing",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent SDK for Agent Mailbox — poll tickets, heartbeat, ask the requester, complete. Zero dependencies.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/terryds/agent-mailbox"
+    "url": "https://github.com/terryds/agent-ticketing"
   },
   "license": "MIT",
   "keywords": [