opengate 0.2.11 → 0.2.12

package/dist/index.js

@@ -168,6 +168,52 @@ If you receive a \`task.comment_mention\` notification:
 
 Now begin. Start with Phase 1: claim the task.`;
 }
+function buildMentionPrompt(taskId, commentBody, commentAuthor, openGateUrl, apiKey, project, projectsDir) {
+  let workspacePath = null;
+  if (project?.repo_url) {
+    const repoName = repoNameFromUrl(project.repo_url);
+    if (repoName && projectsDir) {
+      workspacePath = `${projectsDir}/${repoName}`;
+    }
+  }
+  const workspaceInstruction = workspacePath ? `Your project workspace is at: ${workspacePath}
+Change into this directory before any file operations.` : "";
+  return `You are an AI agent responding to an @-mention in a task comment.
+
+## API Access
+- Base URL: ${openGateUrl}
+- API Key: ${apiKey} (pass as Authorization: Bearer header)
+
+## Task
+- Task ID: ${taskId}
+${workspaceInstruction}
+
+## The Comment That Mentioned You
+**Author:** ${commentAuthor}
+**Content:**
+${commentBody}
+
+## Instructions
+
+1. Fetch the full task context: GET ${openGateUrl}/api/tasks/${taskId} (with Authorization header)
+2. Read the task description, status, and recent activity to understand context
+3. Reason about what the comment author is asking:
+   - If it's a **question** \u2192 post a reply comment with your answer
+   - If it's a **request for changes** \u2192 assess what's needed, make the changes if possible, and post a comment describing what you did
+   - If it's a **simple acknowledgment or FYI** \u2192 post a brief confirmation comment
+4. Post your reply: POST ${openGateUrl}/api/tasks/${taskId}/activity
+   Body: {"content": "<your reply>", "activity_type": "comment"}
+5. If you made code changes, post a summary of what changed
+
+## Rules
+- ALWAYS reply with a comment so the author knows you've seen the mention
+- Do NOT change the task status unless explicitly asked to
+- Do NOT try to claim or complete the task \u2014 you are just responding to a comment
+- Keep your response focused and concise
+- If you need to make code changes, work on a feature branch
+
+Begin by fetching the task context.`;
+}
 
 // src/spawner.ts
 async function spawnTaskSession(taskId, message, pluginCfg, openclawCfg) {
@@ -304,6 +350,34 @@ async function fetchInbox(url, apiKey) {
     inProgressTasks: body.in_progress_tasks ?? []
   };
 }
+async function fetchNotifications(url, apiKey) {
+  const resp = await fetch(`${url}/api/agents/me/notifications?unread=true`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!resp.ok) return [];
+  return await resp.json();
+}
+async function ackNotification(url, apiKey, notifId) {
+  await fetch(`${url}/api/agents/me/notifications/${notifId}/ack`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${apiKey}` },
+    signal: AbortSignal.timeout(1e4)
+  }).catch(() => {
+  });
+}
+async function fetchTaskById(url, apiKey, taskId) {
+  try {
+    const resp = await fetch(`${url}/api/tasks/${taskId}`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!resp.ok) return null;
+    return await resp.json();
+  } catch {
+    return null;
+  }
+}
 var OpenGatePoller = class {
   constructor(pluginCfg, openclawCfg, logger, stateDir) {
     this.pluginCfg = pluginCfg;
@@ -362,6 +436,7 @@ var OpenGatePoller = class {
         await this.releaseTask(task.id);
       }
     }
+    await this.handleNotifications();
     const maxConcurrent = this.pluginCfg.maxConcurrent ?? 3;
     const active = this.state.activeCount();
     if (active >= maxConcurrent) {
@@ -414,6 +489,68 @@ var OpenGatePoller = class {
       );
     }
   }
+  async handleNotifications() {
+    let notifications;
+    try {
+      notifications = await fetchNotifications(this.pluginCfg.url, this.pluginCfg.apiKey);
+    } catch {
+      return;
+    }
+    const mentionNotifs = notifications.filter(
+      (n) => n.event_type === "task.comment_mention" && n.task_id
+    );
+    for (const notif of mentionNotifs) {
+      if (!this.running) break;
+      const maxConcurrent = this.pluginCfg.maxConcurrent ?? 3;
+      if (this.state.activeCount() >= maxConcurrent) {
+        this.logger.info("[opengate] At capacity \u2014 deferring mention notifications");
+        break;
+      }
+      const mentionKey = `mention:${notif.id}`;
+      if (this.state.isSpawned(mentionKey)) continue;
+      await this.spawnMentionSession(notif);
+      await ackNotification(this.pluginCfg.url, this.pluginCfg.apiKey, notif.id);
+    }
+  }
+  async spawnMentionSession(notif) {
+    const taskId = notif.task_id;
+    this.logger.info(
+      `[opengate] Handling @-mention notification ${notif.id} on task ${taskId}`
+    );
+    const bodyText = notif.body ?? "";
+    const colonIdx = bodyText.indexOf(": ");
+    const author = colonIdx > 0 ? bodyText.slice(0, colonIdx) : "Someone";
+    const commentBody = colonIdx > 0 ? bodyText.slice(colonIdx + 2) : bodyText;
+    const task = await fetchTaskById(this.pluginCfg.url, this.pluginCfg.apiKey, taskId);
+    let project = null;
+    if (task?.project_id) {
+      project = await this.resolveProject(task.project_id);
+    }
+    const prompt = buildMentionPrompt(
+      taskId,
+      commentBody,
+      author,
+      this.pluginCfg.url,
+      this.pluginCfg.apiKey,
+      project,
+      this.pluginCfg.projectsDir
+    );
+    const result = await spawnTaskSession(
+      `mention-${notif.id}`,
+      prompt,
+      this.pluginCfg,
+      this.openclawCfg
+    );
+    if (!result.ok) {
+      this.logger.error(result.error);
+      return;
+    }
+    const mentionKey = `mention:${notif.id}`;
+    this.state.markSpawned(mentionKey, result.sessionKey);
+    this.logger.info(
+      `[opengate] Mention session spawned for notification ${notif.id} \u2192 ${result.sessionKey}`
+    );
+  }
   async spawnTask(task) {
     this.logger.info(`[opengate] Spawning session for task: "${task.title}" (${task.id})`);
     let project = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opengate",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "OpenGate task executor plugin for OpenClaw — polls assigned tasks and spawns isolated agent sessions",
   "type": "module",
   "main": "./dist/index.js",