opengate 0.2.3 → 0.2.4

package/dist/index.js

@@ -4,18 +4,29 @@ function resolveConfig(raw) {
   const apiKey = typeof raw.apiKey === "string" ? raw.apiKey : "";
   if (!url) throw new Error("[opengate] plugin config missing: url");
   if (!apiKey) throw new Error("[opengate] plugin config missing: apiKey");
+  const home = process.env.HOME ?? "/home/unknown";
   return {
     url,
     apiKey,
     agentId: typeof raw.agentId === "string" ? raw.agentId : "main",
     model: typeof raw.model === "string" ? raw.model : void 0,
     pollIntervalMs: typeof raw.pollIntervalMs === "number" ? raw.pollIntervalMs : 3e4,
-    maxConcurrent: typeof raw.maxConcurrent === "number" ? raw.maxConcurrent : 3
+    maxConcurrent: typeof raw.maxConcurrent === "number" ? raw.maxConcurrent : 3,
+    projectsDir: typeof raw.projectsDir === "string" ? raw.projectsDir : `${home}/Projects`
   };
 }
 
 // src/bootstrap.ts
-function buildBootstrapPrompt(task, openGateUrl, apiKey) {
+function repoNameFromUrl(repoUrl) {
+  try {
+    const url = new URL(repoUrl);
+    const segments = url.pathname.replace(/\.git$/, "").split("/").filter(Boolean);
+    return segments.length > 0 ? segments[segments.length - 1] : null;
+  } catch {
+    return null;
+  }
+}
+function buildBootstrapPrompt(task, openGateUrl, apiKey, project, projectsDir) {
   const tags = Array.isArray(task.tags) && task.tags.length > 0 ? task.tags.join(", ") : "none";
   const contextBlock = task.context && Object.keys(task.context).length > 0 ? `
 ## Task Context
@@ -24,6 +35,26 @@ ${JSON.stringify(task.context, null, 2)}
 \`\`\`
 ` : "";
   const projectId = task.project_id ?? "unknown";
+  const defaultBranch = project?.default_branch ?? "main";
+  let workspacePath = null;
+  if (project?.repo_url) {
+    const repoName = repoNameFromUrl(project.repo_url);
+    if (repoName && projectsDir) {
+      workspacePath = `${projectsDir}/${repoName}`;
+    }
+  }
+  const workspaceBlock = workspacePath ? `### Phase 4: Workspace Setup
+6. **Set up your workspace:**
+   - \`cd ${workspacePath}\`
+   - Pull latest: \`git fetch origin && git checkout ${defaultBranch} && git pull origin ${defaultBranch}\`
+   - Create a feature branch: \`git checkout -b <branch-name>\`
+   - Branch naming: use the task title slugified, e.g. \`feat/add-user-auth\` or \`fix/null-pointer-in-parser\`
+   - If \`${workspacePath}\` does not exist, clone it: \`git clone ${project.repo_url} ${workspacePath}\`` : `### Phase 4: Workspace Setup
+6. **Set up your workspace:**
+   - Fetch project info: \`GET /api/projects/${projectId}\` \u2014 read \`repo_url\` and \`default_branch\`
+   - Derive the local path from the repo name (under ~/Projects/)
+   - If the directory doesn't exist, clone it
+   - Create a feature branch from the default branch`;
   return `You are an autonomous coding agent assigned a task via OpenGate.
 
 ## Your Task (Summary)
@@ -61,19 +92,12 @@ Before writing any code, gather all available context:
    - Read any returned entries \u2014 they contain architecture decisions, patterns, gotchas, and conventions for this project
    - Follow these conventions in your implementation
 
-4. **Check project info** \u2014 \`GET /api/projects/${projectId}\`
-   - Note the \`repo_url\` and \`default_branch\` \u2014 use these for your workspace setup
-
 ### Phase 3: Plan & Announce
-5. **Post starting comment** \u2014 \`POST /api/tasks/${task.id}/activity\`
+4. **Post starting comment** \u2014 \`POST /api/tasks/${task.id}/activity\`
    Body: \`{"content": "Starting work. Plan: <your plan informed by the context you gathered, 2-4 sentences>"}\`
    - Your plan should reflect what you learned from the knowledge base, existing comments, and dependencies
 
-### Phase 4: Workspace Setup
-6. **Set up your workspace:**
-   - Navigate to the project workspace (based on \`repo_url\` from the project info)
-   - Create a feature branch from the default branch: \`git checkout -b <branch-name>\`
-   - Branch naming: use the task title slugified, e.g. \`feat/add-user-auth\` or \`fix/null-pointer-in-parser\`
+${workspaceBlock}
 
 ### Phase 5: Do the Work
 7. **Implement the solution:**
@@ -90,8 +114,8 @@ Before writing any code, gather all available context:
    Body: \`{"title": "...", "content": "...", "tags": [...], "category": "<architecture|pattern|gotcha|decision|reference>"}\`
    - Write entries for: architectural decisions you made, gotchas you encountered, patterns you established
 
-10. **Complete** \u2014 \`POST /api/tasks/${task.id}/complete\`
-    Body: \`{"summary": "<what was done>", "output": {"branch": "...", "commits": [...]}}\`
+10. **Complete the task** \u2014 \`POST /api/tasks/${task.id}/complete\`
+    Body: \`{"summary": "<what was done>", "output": {"branch": "<branch-name>", "commits": ["<hash>"]}}\`
 
 ## Handling Blockers
 If you encounter a blocker that requires human input:
@@ -217,6 +241,19 @@ var TaskState = class {
 };
 
 // src/poller.ts
+async function fetchProject(url, apiKey, projectId) {
+  try {
+    const resp = await fetch(`${url}/api/projects/${projectId}`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!resp.ok) return null;
+    const body = await resp.json();
+    return body.project ?? body;
+  } catch {
+    return null;
+  }
+}
 async function fetchInbox(url, apiKey) {
   const resp = await fetch(`${url}/api/agents/me/inbox`, {
     headers: { Authorization: `Bearer ${apiKey}` },
@@ -238,6 +275,7 @@ var OpenGatePoller = class {
   timer = null;
   state;
   running = false;
+  projectCache = /* @__PURE__ */ new Map();
   start() {
     if (this.running) return;
     this.running = true;
@@ -291,9 +329,26 @@ var OpenGatePoller = class {
       await this.spawnTask(task);
     }
   }
+  async resolveProject(projectId) {
+    const cached = this.projectCache.get(projectId);
+    if (cached) return cached;
+    const project = await fetchProject(this.pluginCfg.url, this.pluginCfg.apiKey, projectId);
+    if (project) this.projectCache.set(projectId, project);
+    return project;
+  }
   async spawnTask(task) {
     this.logger.info(`[opengate] Spawning session for task: "${task.title}" (${task.id})`);
-    const prompt = buildBootstrapPrompt(task, this.pluginCfg.url, this.pluginCfg.apiKey);
+    let project = null;
+    if (task.project_id) {
+      project = await this.resolveProject(task.project_id);
+    }
+    const prompt = buildBootstrapPrompt(
+      task,
+      this.pluginCfg.url,
+      this.pluginCfg.apiKey,
+      project,
+      this.pluginCfg.projectsDir
+    );
     const result = await spawnTaskSession(
       task.id,
       prompt,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "opengate",
   "name": "OpenGate",
   "description": "Polls OpenGate for assigned tasks and spawns isolated OpenClaw sessions to execute them. Turns OpenGate into the orchestrator.",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "skills": ["./skills/opengate"],
   "configSchema": {
     "type": "object",
@@ -32,6 +32,10 @@
       "maxConcurrent": {
         "type": "number",
         "description": "Max concurrent task sessions (default: 3)"
+      },
+      "projectsDir": {
+        "type": "string",
+        "description": "Base directory where project repos live on disk (default: ~/Projects)"
       }
     }
   },
@@ -41,6 +45,7 @@
     "agentId": { "label": "OpenClaw Agent ID", "placeholder": "main" },
     "model": { "label": "Model Override", "placeholder": "anthropic/claude-sonnet-4-6" },
     "pollIntervalMs": { "label": "Poll Interval (ms)", "advanced": true },
-    "maxConcurrent": { "label": "Max Concurrent Tasks", "advanced": true }
+    "maxConcurrent": { "label": "Max Concurrent Tasks", "advanced": true },
+    "projectsDir": { "label": "Projects Directory", "placeholder": "~/Projects", "advanced": true }
   }
 }

package/package.json

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