agent-worker 0.2.0 → 0.3.0

package/README.md

@@ -52,15 +52,23 @@ agent-worker session end --all
 ### Sending Messages
 
 ```bash
-# Send to current session
-agent-worker send "What is 2+2?"
+# Send to current session (async by default - returns immediately)
+agent-worker send "Analyze this codebase"
 
 # Send to specific session
 agent-worker send "Explain recursion" --to my-session
 
-# View conversation history
-agent-worker history
-agent-worker history --last 5
+# Send and wait for response (synchronous mode)
+agent-worker send "What is 2+2?" --wait
+
+# Send with debug logging (useful for troubleshooting)
+agent-worker send "Debug this" --debug
+
+# View conversation messages
+agent-worker peek                    # Show last 10 messages (default)
+agent-worker peek --last 5           # Show last 5 messages
+agent-worker peek --all              # Show all messages
+agent-worker peek --find "error"     # Search messages containing "error"
 
 # View token usage
 agent-worker stats
@@ -68,10 +76,58 @@ agent-worker stats
 # Export transcript
 agent-worker export > transcript.json
 
-# Clear history (keep session)
+# Clear messages (keep session)
 agent-worker clear
 ```
 
+**Understanding Message Flow:**
+
+The CLI supports two modes for sending messages:
+
+1. **Asynchronous (default)**: The command returns immediately after sending. The agent processes in the background. Use `peek` to view the response.
+   ```bash
+   # Send message (returns immediately)
+   agent-worker send "Analyze this large codebase"
+   # Output: "Message sent. Use 'peek' command to view response."
+
+   # View response later
+   agent-worker peek --last 2
+   ```
+
+2. **Synchronous (`--wait`)**: The command waits for the agent to fully process the message and return a response. This is best for quick questions when you need immediate results.
+   ```bash
+   agent-worker send "What is 2+2?" --wait
+   # Waits for response, then prints: 4
+   ```
+
+**Troubleshooting:**
+
+If `send` appears stuck or times out, use `--debug` to see what's happening:
+
+```bash
+agent-worker send "test message" --debug
+```
+
+Debug output shows:
+- Session lookup and connection status
+- Socket communication
+- Request/response timing
+- Error details
+
+**Backend Limitations:**
+
+The CLI supports two backend types:
+
+1. **SDK Backend (default)**: Full-featured, works in all environments. Requires `ANTHROPIC_API_KEY` environment variable.
+
+2. **Claude CLI Backend (`-b claude`)**: Uses `claude -p` for non-interactive mode.
+   - **Known limitation**: May not work properly within Claude Code environment itself due to command interception
+   - **Timeout**: Async requests timeout after 60 seconds to prevent indefinite hangs
+   - **Recommended use**: Normal terminal environments outside Claude Code
+   - **For testing**: Use SDK backend instead when developing within Claude Code
+
+If you see messages stuck in `(processing...)` state for more than 60 seconds, it indicates a backend issue. The message will automatically update to show a timeout error.
+
 ### Tool Management (SDK Backend Only)
 
 ```bash
@@ -357,7 +413,7 @@ process.on('exit', async () => {
 agent-worker session new -f ./my-prompt.txt -n test
 agent-worker send "Test case 1: ..." --to test
 agent-worker send "Test case 2: ..." --to test
-agent-worker history --to test
+agent-worker peek --to test
 agent-worker session end test
 ```
 

package/dist/{backends-BGJk-onJ.mjs → backends-BZ866Ij9.mjs}

@@ -198,7 +198,12 @@ var ClaudeCliBackend = class {
 		return new Promise((resolve, reject) => {
 			const proc = spawn("claude", args, {
 				cwd: this.options.cwd,
-				env: process.env
+				env: process.env,
+				stdio: [
+					"ignore",
+					"pipe",
+					"pipe"
+				]
 			});
 			let stdout = "";
 			let stderr = "";

package/dist/{backends-bvhx4Wb6.mjs → backends-DXpJ7FJI.mjs}

@@ -1,3 +1,3 @@
-import { a as CursorCliBackend, i as SdkBackend, n as createBackend, o as CodexCliBackend, r as listBackends, s as ClaudeCliBackend, t as checkBackends } from "./backends-BGJk-onJ.mjs";
+import { a as CursorCliBackend, i as SdkBackend, n as createBackend, o as CodexCliBackend, r as listBackends, s as ClaudeCliBackend, t as checkBackends } from "./backends-BZ866Ij9.mjs";
 
 export { listBackends };

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { c as FRONTIER_MODELS, f as getDefaultModel, n as createBackend } from "../backends-BGJk-onJ.mjs";
-import { a as createSkillsTool, o as SkillsProvider, s as AgentSession, t as SkillImporter } from "../skills-B8z8tFaH.mjs";
+import { c as FRONTIER_MODELS, f as getDefaultModel, n as createBackend } from "../backends-BZ866Ij9.mjs";
+import { a as createSkillsTool, o as SkillsProvider, s as AgentSession, t as SkillImporter } from "../skills-CVdxwuvV.mjs";
 import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
@@ -270,7 +270,7 @@ async function handleRequest(req) {
 				}
 			};
 			case "send": {
-				const { message, options } = req.payload;
+				const { message, options, async } = req.payload;
 				if (backend) {
 					const timestamp = (/* @__PURE__ */ new Date()).toISOString();
 					state.cliHistory.push({
@@ -278,6 +278,35 @@ async function handleRequest(req) {
 						content: message,
 						timestamp
 					});
+					if (async) {
+						state.cliHistory.push({
+							role: "assistant",
+							content: "(processing...)",
+							timestamp: (/* @__PURE__ */ new Date()).toISOString()
+						});
+						const timeoutMs = 6e4;
+						const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("Request timed out after 60 seconds")), timeoutMs));
+						Promise.race([backend.send(message, { system: info.system }), timeoutPromise]).then((result) => {
+							const lastMsg = state.cliHistory[state.cliHistory.length - 1];
+							if (lastMsg && lastMsg.content === "(processing...)") {
+								lastMsg.content = result.content;
+								lastMsg.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+							}
+						}).catch((error) => {
+							const lastMsg = state.cliHistory[state.cliHistory.length - 1];
+							if (lastMsg && lastMsg.content === "(processing...)") {
+								lastMsg.content = `Error: ${error instanceof Error ? error.message : String(error)}`;
+								lastMsg.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+							}
+						});
+						return {
+							success: true,
+							data: {
+								async: true,
+								message: "Processing in background. Use `peek` to check the response."
+							}
+						};
+					}
 					const result = await backend.send(message, { system: info.system });
 					state.cliHistory.push({
 						role: "assistant",
@@ -299,10 +328,24 @@ async function handleRequest(req) {
 						}
 					};
 				}
-				if (session) return {
-					success: true,
-					data: await session.send(message, options)
-				};
+				if (session) {
+					if (async) {
+						session.send(message, options).catch((error) => {
+							console.error("Background send error:", error);
+						});
+						return {
+							success: true,
+							data: {
+								async: true,
+								message: "Processing in background. Use `peek` to check the response."
+							}
+						};
+					}
+					return {
+						success: true,
+						data: await session.send(message, options)
+					};
+				}
 				return {
 					success: false,
 					error: "No backend configured"
@@ -648,13 +691,19 @@ async function waitForReady(nameOrId, timeoutMs = 5e3) {
 
 //#endregion
 //#region src/cli/client.ts
-/**
-* Send a request to a specific session
-* @param req - The request to send
-* @param target - Session ID or name (optional, uses default if not specified)
-*/
-function sendRequest(req, target) {
+function sendRequest(req, targetOrOptions, options) {
+	let target;
+	let opts = {};
+	if (typeof targetOrOptions === "string") {
+		target = targetOrOptions;
+		opts = options || {};
+	} else if (targetOrOptions) {
+		opts = targetOrOptions;
+		target = opts.target;
+	}
+	const debug = opts.debug || false;
 	return new Promise((resolve, reject) => {
+		if (debug) console.error(`[DEBUG] Looking up session: ${target || "(default)"}`);
 		const info = getSessionInfo(target);
 		if (!info) {
 			if (target) resolve({
@@ -667,6 +716,10 @@ function sendRequest(req, target) {
 			});
 			return;
 		}
+		if (debug) {
+			console.error(`[DEBUG] Found session: ${info.id} (${info.backend})`);
+			console.error(`[DEBUG] Socket path: ${info.socketPath}`);
+		}
 		if (!isSessionRunning(target)) {
 			resolve({
 				success: false,
@@ -674,12 +727,22 @@ function sendRequest(req, target) {
 			});
 			return;
 		}
+		if (debug) console.error(`[DEBUG] Connecting to socket...`);
 		const socket = createConnection(info.socketPath);
 		let buffer = "";
+		const startTime = Date.now();
 		socket.on("connect", () => {
+			if (debug) {
+				console.error(`[DEBUG] Connected. Sending request:`);
+				console.error(`[DEBUG] ${JSON.stringify(req, null, 2)}`);
+			}
 			socket.write(JSON.stringify(req) + "\n");
 		});
 		socket.on("data", (data) => {
+			if (debug) {
+				const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+				console.error(`[DEBUG] Received data after ${elapsed}s: ${data.toString().substring(0, 100)}...`);
+			}
 			buffer += data.toString();
 			const lines = buffer.split("\n");
 			buffer = lines.pop() || "";
@@ -687,22 +750,30 @@ function sendRequest(req, target) {
 				if (!line.trim()) continue;
 				try {
 					const res = JSON.parse(line);
+					if (debug) {
+						const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+						console.error(`[DEBUG] Received response after ${elapsed}s`);
+					}
 					socket.end();
 					resolve(res);
 				} catch (error) {
+					if (debug) console.error(`[DEBUG] Parse error:`, error);
 					socket.end();
 					reject(error);
 				}
 			}
 		});
 		socket.on("error", (error) => {
+			if (debug) console.error(`[DEBUG] Socket error:`, error);
 			reject(error);
 		});
 		socket.on("timeout", () => {
+			if (debug) console.error(`[DEBUG] Socket timeout after 60s`);
 			socket.end();
 			reject(/* @__PURE__ */ new Error("Connection timeout"));
 		});
 		socket.setTimeout(6e4);
+		if (debug) console.error(`[DEBUG] Waiting for response (60s timeout)...`);
 	});
 }
 /**
@@ -821,24 +892,32 @@ sessionCmd.command("end [target]").description("End a session (or all with --all
 	if (res.success) console.log("Session ended");
 	else console.error("Error:", res.error);
 });
-program.command("send <message>").description("Send a message").option("--to <target>", "Target session (name or ID)").option("--json", "Output full JSON response").option("--auto-approve", "Auto-approve all tool calls (default)").option("--no-auto-approve", "Require manual approval").action(async (message, options) => {
+program.command("send <message>").description("Send a message (async by default, use --wait to wait for response)").option("--to <target>", "Target session (name or ID)").option("--json", "Output full JSON response").option("--auto-approve", "Auto-approve all tool calls (default)").option("--no-auto-approve", "Require manual approval").option("--wait", "Wait for response before returning (synchronous mode)").option("--debug", "Show debug information").action(async (message, options) => {
 	const target = options.to;
 	if (!isSessionActive(target)) {
 		if (target) console.error(`Session not found: ${target}`);
 		else console.error("No active session. Create one with: agent-worker session new -m <model>");
 		process.exit(1);
 	}
+	const autoApprove = options.autoApprove !== false;
+	const async = !options.wait;
 	const res = await sendRequest({
 		action: "send",
 		payload: {
 			message,
-			options: { autoApprove: options.autoApprove !== false }
+			options: { autoApprove },
+			async
 		}
-	}, target);
+	}, target, { debug: options.debug });
 	if (!res.success) {
 		console.error("Error:", res.error);
 		process.exit(1);
 	}
+	if (async) {
+		const asyncData = res.data;
+		console.log(asyncData.message);
+		return;
+	}
 	const response = res.data;
 	if (options.json) console.log(JSON.stringify(response, null, 2));
 	else {
@@ -957,7 +1036,7 @@ toolCmd.command("list").description("List tools").option("--to <target>", "Targe
 		console.log(`  ${t.name}${approval}${mock} - ${t.description}`);
 	}
 });
-program.command("history").description("Show conversation history").option("--to <target>", "Target session").option("--json", "Output as JSON").option("-n, --last <count>", "Show last N messages", parseInt).action(async (options) => {
+program.command("peek").description("View conversation messages (default: last 10)").option("--to <target>", "Target session").option("--json", "Output as JSON").option("--all", "Show all messages").option("-n, --last <count>", "Show last N messages", parseInt).option("--find <text>", "Filter messages containing text (case-insensitive)").action(async (options) => {
 	const target = options.to;
 	if (!isSessionActive(target)) {
 		console.error(target ? `Session not found: ${target}` : "No active session");
@@ -968,15 +1047,22 @@ program.command("history").description("Show conversation history").option("--to
 		console.error("Error:", res.error);
 		process.exit(1);
 	}
-	let history = res.data;
-	if (options.last && options.last > 0) history = history.slice(-options.last);
-	if (options.json) console.log(JSON.stringify(history, null, 2));
+	let messages = res.data;
+	if (options.find) {
+		const searchText = options.find.toLowerCase();
+		messages = messages.filter((msg) => msg.content.toLowerCase().includes(searchText));
+	}
+	if (!options.all) {
+		const count = options.last ?? 10;
+		messages = messages.slice(-count);
+	}
+	if (options.json) console.log(JSON.stringify(messages, null, 2));
 	else {
-		if (history.length === 0) {
-			console.log("No messages");
+		if (messages.length === 0) {
+			console.log(options.find ? "No messages found matching your search" : "No messages");
 			return;
 		}
-		for (const msg of history) {
+		for (const msg of messages) {
 			const role = msg.role === "user" ? "YOU" : msg.role.toUpperCase();
 			const status = msg.status === "responding" ? " (responding...)" : "";
 			console.log(`[${role}${status}] ${msg.content}`);
@@ -1146,7 +1232,7 @@ program.command("providers").description("Check provider availability").action((
 	console.log(`\nDefault: ${defaultModel} (when no model specified)`);
 });
 program.command("backends").description("Check available backends (SDK, CLI tools)").action(async () => {
-	const { listBackends } = await import("../backends-bvhx4Wb6.mjs");
+	const { listBackends } = await import("../backends-DXpJ7FJI.mjs");
 	const backends = await listBackends();
 	console.log("Backend Status:\n");
 	for (const backend of backends) {

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { a as CursorCliBackend, c as FRONTIER_MODELS, d as createModelAsync, i as SdkBackend, l as SUPPORTED_PROVIDERS, n as createBackend, o as CodexCliBackend, r as listBackends, s as ClaudeCliBackend, t as checkBackends, u as createModel } from "./backends-BGJk-onJ.mjs";
-import { a as createSkillsTool, c as createTools, i as parseImportSpec, n as buildGitUrl, o as SkillsProvider, r as getSpecDisplayName, s as AgentSession, t as SkillImporter } from "./skills-B8z8tFaH.mjs";
+import { a as CursorCliBackend, c as FRONTIER_MODELS, d as createModelAsync, i as SdkBackend, l as SUPPORTED_PROVIDERS, n as createBackend, o as CodexCliBackend, r as listBackends, s as ClaudeCliBackend, t as checkBackends, u as createModel } from "./backends-BZ866Ij9.mjs";
+import { a as createSkillsTool, c as createTools, i as parseImportSpec, n as buildGitUrl, o as SkillsProvider, r as getSpecDisplayName, s as AgentSession, t as SkillImporter } from "./skills-CVdxwuvV.mjs";
 import { createBashTool } from "bash-tool";
 
 //#region src/tools/bash.ts

package/dist/{skills-B8z8tFaH.mjs → skills-CVdxwuvV.mjs}

@@ -1,4 +1,4 @@
-import { d as createModelAsync } from "./backends-BGJk-onJ.mjs";
+import { d as createModelAsync } from "./backends-BZ866Ij9.mjs";
 import { ToolLoopAgent, jsonSchema, stepCountIs, tool } from "ai";
 import { spawn } from "node:child_process";
 import { mkdir, readFile, readdir, rm, stat } from "node:fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-worker",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "SDK and CLI for creating and testing agent workers with Vercel AI SDK",
   "type": "module",
   "main": "./dist/index.mjs",