opengate 0.2.3 → 0.2.8

package/dist/index.d.ts

@@ -1,5 +1,12 @@
+import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
 import { OpenClawPluginApi } from 'openclaw/plugin-sdk';
 
-declare function register(api: OpenClawPluginApi): void;
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: openclaw_plugin_sdk.OpenClawPluginConfigSchema;
+    register(api: OpenClawPluginApi): void;
+};
 
-export { register as default };
+export { _default as default };

package/dist/index.js

@@ -1,21 +1,35 @@
+// src/index.ts
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
 // src/config.ts
 function resolveConfig(raw) {
   const url = typeof raw.url === "string" ? raw.url.replace(/\/$/, "") : "";
   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 +38,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 +95,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 +117,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 +244,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 +278,7 @@ var OpenGatePoller = class {
   timer = null;
   state;
   running = false;
+  projectCache = /* @__PURE__ */ new Map();
   start() {
     if (this.running) return;
     this.running = true;
@@ -291,9 +332,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,
@@ -312,34 +370,40 @@ var OpenGatePoller = class {
 };
 
 // src/index.ts
-function register(api) {
-  let poller = null;
-  let pluginCfg;
-  try {
-    pluginCfg = resolveConfig(api.pluginConfig ?? {});
-  } catch (e) {
-    api.logger.error(e instanceof Error ? e.message : String(e));
-    return;
-  }
-  const hooksToken = api.config?.hooks?.token;
-  if (!hooksToken) {
-    api.logger.error(
-      '[opengate] hooks.token is not configured. Add the following to your OpenClaw config to enable task spawning:\n  "hooks": { "enabled": true, "token": "<your-secret>", "allowRequestSessionKey": true, "allowedSessionKeyPrefixes": ["opengate-task:"] }'
-    );
-    return;
-  }
-  api.registerService({
-    id: "opengate-poller",
-    start(ctx) {
-      poller = new OpenGatePoller(pluginCfg, api.config, ctx.logger, ctx.stateDir);
-      poller.start();
-    },
-    stop(ctx) {
-      poller?.stop();
-      poller = null;
+var index_default = {
+  id: "opengate",
+  name: "OpenGate",
+  description: "Polls OpenGate for assigned tasks and spawns isolated OpenClaw sessions to execute them. Turns OpenGate into the orchestrator.",
+  configSchema: emptyPluginConfigSchema(),
+  register(api) {
+    let poller = null;
+    let pluginCfg;
+    try {
+      pluginCfg = resolveConfig(api.pluginConfig ?? {});
+    } catch (e) {
+      api.logger.error(e instanceof Error ? e.message : String(e));
+      return;
     }
-  });
-}
+    const hooksToken = api.config?.hooks?.token;
+    if (!hooksToken) {
+      api.logger.error(
+        '[opengate] hooks.token is not configured. Add the following to your OpenClaw config to enable task spawning:\n  "hooks": { "enabled": true, "token": "<your-secret>", "allowRequestSessionKey": true, "allowedSessionKeyPrefixes": ["opengate-task:"] }'
+      );
+      return;
+    }
+    api.registerService({
+      id: "opengate-poller",
+      start(ctx) {
+        poller = new OpenGatePoller(pluginCfg, api.config, ctx.logger, ctx.stateDir);
+        poller.start();
+      },
+      stop(ctx) {
+        poller?.stop();
+        poller = null;
+      }
+    });
+  }
+};
 export {
-  register as default
+  index_default as default
 };

package/openclaw.plugin.json

@@ -2,12 +2,11 @@
   "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.8",
   "skills": ["./skills/opengate"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "required": ["url", "apiKey"],
     "properties": {
       "url": {
         "type": "string",
@@ -32,6 +31,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 +44,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.8",
   "description": "OpenGate task executor plugin for OpenClaw — polls assigned tasks and spawns isolated agent sessions",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,11 @@
   "openclaw": {
     "extensions": [
       "./dist/index.js"
-    ]
+    ],
+    "install": {
+      "npmSpec": "opengate",
+      "defaultChoice": "npm"
+    }
   },
   "publishConfig": {
     "access": "public"