@meandmyagents/agent-runner 0.1.0 → 0.1.2

package/README.md

@@ -13,6 +13,20 @@ process as `MAA_API_KEY`, so one Mac can run several agent profiles without
 sharing identity. The launched agent uses MCP to start, complete, and drain the
 remaining actionable cards.
 
+Codex is launched with `--ask-for-approval never --sandbox danger-full-access`.
+Claude is launched with `--permission-mode bypassPermissions`. The runner prompt
+also includes the effective workflow instructions saved in MeAndMyAgents, tells
+the agent not to wait for human answers, and tells it to verify, commit, and push
+code changes before calling `complete_task`.
+
+On macOS, `--launcher codex` will also look for the bundled Codex app executable
+at `/Applications/Codex.app/Contents/Resources/codex` when `codex` is not on
+`PATH`. If your launcher lives somewhere else, pass it explicitly:
+
+```bash
+meandmyagents-runner watch --key maa_live_YOUR_AGENT_KEY --launcher codex --command /Applications/Codex.app/Contents/Resources/codex
+```
+
 ```bash
 meandmyagents-runner watch --key maa_live_YOUR_AGENT_KEY --launcher claude --once
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meandmyagents/agent-runner",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local visible-session task runner for Me And My Agents.",
   "type": "module",
   "bin": {

package/src/runner.js

@@ -1,15 +1,18 @@
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { delimiter, join } from "node:path";
 
 export const defaultApiUrl = "https://meandmyagents.com/api";
 const supportedLaunchers = new Set(["codex", "claude"]);
 
 export function parseRunnerArgs(argv = process.argv.slice(2)) {
   const options = {
-    command: argv[0] ?? "help",
+    command: argv[0] === "--help" || argv[0] === "-h" ? "help" : argv[0] ?? "help",
     apiUrl: defaultApiUrl,
     intervalSeconds: 10,
     key: "",
     launcher: "codex",
+    launcherCommand: "",
     once: false
   };
 
@@ -34,6 +37,12 @@ export function parseRunnerArgs(argv = process.argv.slice(2)) {
       continue;
     }
 
+    if (arg === "--command" || arg === "-c") {
+      options.launcherCommand = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+
     if (arg === "--interval") {
       options.intervalSeconds = Number(argv[index + 1] ?? "10");
       index += 1;
@@ -68,30 +77,58 @@ export function buildAgentPrompt({
   agentName,
   cardId,
   eventId,
-  projectName
+  project,
+  projectName,
+  workflow
 }) {
+  const workflowInstructions = Array.isArray(workflow?.instructions)
+    ? workflow.instructions
+    : [];
+  const defaultBranch = project?.defaultBranch || "the default branch";
+  const codebaseLines = project?.repositoryUrl
+    ? [
+        `Repository: ${project.repositoryUrl}`,
+        `Default branch: ${defaultBranch}`,
+        project.localPath ? `Local checkout path: ${project.localPath}` : null,
+        `If you modify code, run verification, then commit and push to ${defaultBranch} before complete_task.`
+      ].filter(Boolean)
+    : ["This project has no repository URL, so treat it as non-code work unless list_my_tasks says otherwise."];
+
   return [
     `You are ${agentName}. MeAndMyAgents has assigned work in ${projectName}.`,
     `Wake event: ${eventId}. First card that woke this session: ${cardId}.`,
+    "This is an autonomous runner wake-up. Do not wait for a human answer.",
+    "If you are blocked, add a card comment explaining the blocker and stop; do not sit idle asking a question.",
     "Use the MeAndMyAgents MCP server now.",
     "Call whoami to confirm your identity and project access.",
+    "Follow these workflow rules from MeAndMyAgents:",
+    ...workflowInstructions.map((instruction) => `- ${instruction}`),
+    "Codebase context:",
+    ...codebaseLines.map((line) => `- ${line}`),
     "Call list_my_tasks, then start_task on the next actionable card before editing files.",
     "Work only in the task codebase.localPath and only when codebase.canModifyCode is true.",
     "Add comments with useful progress and completion summaries.",
-    "Call complete_task when a task is ready for human testing.",
+    "Call complete_task with a useful summary when a task is ready for human testing.",
     "Call list_my_tasks again after each completion.",
     "Keep taking the next task until no actionable tasks remain, then stop."
   ].join("\n");
 }
 
-export function buildLaunchCommand({ launcher, prompt, cwd, apiKey, apiUrl }) {
+export function buildLaunchCommand({
+  launcher,
+  launcherCommand,
+  prompt,
+  cwd,
+  apiKey,
+  apiUrl
+}) {
   if (!supportedLaunchers.has(launcher)) {
     throw new Error(`Unsupported launcher: ${launcher}`);
   }
 
   return {
-    command: launcher,
-    args: [prompt],
+    command: launcherCommand || launcher,
+    args: buildLauncherArgs({ launcher, prompt, cwd }),
     cwd,
     env: {
       MAA_API_KEY: apiKey,
@@ -100,6 +137,26 @@ export function buildLaunchCommand({ launcher, prompt, cwd, apiKey, apiUrl }) {
   };
 }
 
+function buildLauncherArgs({ launcher, prompt, cwd }) {
+  if (launcher === "codex") {
+    return [
+      "--ask-for-approval",
+      "never",
+      "--sandbox",
+      "danger-full-access",
+      "--cd",
+      cwd,
+      prompt
+    ];
+  }
+
+  if (launcher === "claude") {
+    return ["--permission-mode", "bypassPermissions", prompt];
+  }
+
+  return [prompt];
+}
+
 export async function runCli(argv = process.argv.slice(2)) {
   const options = parseRunnerArgs(argv);
 
@@ -171,10 +228,16 @@ async function launchEvent(options, event) {
     agentName: event.agent?.name ?? options.launcher,
     cardId: event.card?.id ?? "unknown-card",
     eventId: event.id,
-    projectName: event.project?.name ?? "this project"
+    project: event.project,
+    projectName: event.project?.name ?? "this project",
+    workflow: event.workflow
   });
   const launch = buildLaunchCommand({
     launcher: options.launcher,
+    launcherCommand: resolveLauncherCommand({
+      launcher: options.launcher,
+      launcherCommand: options.launcherCommand
+    }),
     prompt,
     cwd,
     apiKey: options.key,
@@ -202,6 +265,60 @@ async function launchEvent(options, event) {
   });
 }
 
+export function resolveLauncherCommand({
+  launcher,
+  launcherCommand = "",
+  pathEnv = process.env.PATH ?? "",
+  platform = process.platform,
+  homeDir = process.env.HOME || process.env.USERPROFILE || "",
+  exists = existsSync
+}) {
+  if (launcherCommand) return launcherCommand;
+  if (!supportedLaunchers.has(launcher)) {
+    throw new Error(`Unsupported launcher: ${launcher}`);
+  }
+
+  if (isCommandOnPath(launcher, { pathEnv, platform, exists })) return launcher;
+
+  const knownPath = knownLauncherPaths(launcher, platform, homeDir).find((path) =>
+    exists(path)
+  );
+  return knownPath ?? launcher;
+}
+
+function isCommandOnPath(command, { pathEnv, platform, exists }) {
+  const executableNames =
+    platform === "win32" ? [command, `${command}.cmd`, `${command}.exe`] : [command];
+
+  return pathEnv
+    .split(delimiter)
+    .filter(Boolean)
+    .some((pathDirectory) =>
+      executableNames.some((executableName) => exists(join(pathDirectory, executableName)))
+    );
+}
+
+function knownLauncherPaths(launcher, platform, homeDir) {
+  if (platform === "darwin") {
+    const commonBinPaths = [
+      homeDir ? join(homeDir, ".local/bin", launcher) : "",
+      join("/opt/homebrew/bin", launcher),
+      join("/usr/local/bin", launcher)
+    ].filter(Boolean);
+
+    if (launcher === "codex") {
+      return [
+        ...commonBinPaths,
+        "/Applications/Codex.app/Contents/Resources/codex"
+      ];
+    }
+
+    return commonBinPaths;
+  }
+
+  return homeDir ? [join(homeDir, ".local/bin", launcher)] : [];
+}
+
 function normalizeApiUrl(value) {
   return (value || defaultApiUrl).replace(/\/$/, "").replace(/\/mcp$/, "");
 }
@@ -232,6 +349,7 @@ Options:
   --key, -k       Required agent-bound API key.
   --api-url, -u   API base URL. Defaults to ${defaultApiUrl}.
   --launcher, -l  Visible CLI launcher: codex or claude.
+  --command, -c   Optional explicit executable path, e.g. /Applications/Codex.app/Contents/Resources/codex.
   --interval      Poll interval in seconds. Defaults to 10.
   --once          Check once, launch at most one visible session, then exit.
 `;