glab-agent 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glab-agent",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "description": "Multi-agent GitLab To-Do watcher with YAML-defined agents, skills, and GitLab registry.",
   "license": "MIT",

package/src/local-agent/gitlab-glab-client.ts

@@ -91,10 +91,10 @@ export interface GitlabClient {
   updateUserStatus(emoji: string, message: string, availability?: "busy" | "not_set"): Promise<void>;
   updateUserBio(bio: string): Promise<void>;
   listAllPendingTodos(): Promise<GitlabTodoItem[]>;
-  listWikiPages(projectId: number): Promise<WikiPage[]>;
-  getWikiPage(projectId: number, slug: string): Promise<WikiPage>;
-  createWikiPage(projectId: number, title: string, content: string): Promise<WikiPage>;
-  updateWikiPage(projectId: number, slug: string, title: string, content: string): Promise<WikiPage>;
+  listWikiPages(projectId: number | string): Promise<WikiPage[]>;
+  getWikiPage(projectId: number | string, slug: string): Promise<WikiPage>;
+  createWikiPage(projectId: number | string, title: string, content: string): Promise<WikiPage>;
+  updateWikiPage(projectId: number | string, slug: string, title: string, content: string): Promise<WikiPage>;
 }
 
 interface GitlabGlabClientOptions {
@@ -632,7 +632,7 @@ export class GitlabGlabClient implements GitlabClient {
       });
   }
 
-  async listWikiPages(projectId: number): Promise<WikiPage[]> {
+  async listWikiPages(projectId: number | string): Promise<WikiPage[]> {
     const endpoint = this.withQuery(`projects/${projectId}/wikis`, { with_content: "0" });
     let payload: unknown;
     try {
@@ -656,7 +656,7 @@ export class GitlabGlabClient implements GitlabClient {
       .filter((w): w is WikiPage => w !== undefined);
   }
 
-  async getWikiPage(projectId: number, slug: string): Promise<WikiPage> {
+  async getWikiPage(projectId: number | string, slug: string): Promise<WikiPage> {
     const payload = await this.readJson(`projects/${projectId}/wikis/${encodeURIComponent(slug)}`);
     const p = (payload ?? {}) as Payload;
     return {
@@ -666,7 +666,7 @@ export class GitlabGlabClient implements GitlabClient {
     };
   }
 
-  async createWikiPage(projectId: number, title: string, content: string): Promise<WikiPage> {
+  async createWikiPage(projectId: number | string, title: string, content: string): Promise<WikiPage> {
     const stdout = await this.request(`projects/${projectId}/wikis`, {
       method: "POST",
       fields: { title, content }
@@ -679,7 +679,7 @@ export class GitlabGlabClient implements GitlabClient {
     };
   }
 
-  async updateWikiPage(projectId: number, slug: string, title: string, content: string): Promise<WikiPage> {
+  async updateWikiPage(projectId: number | string, slug: string, title: string, content: string): Promise<WikiPage> {
     // title must be passed to preserve directory prefix in slug (GitLab API quirk)
     const stdout = await this.request(`projects/${projectId}/wikis/${encodeURIComponent(slug)}`, {
       method: "PUT",

package/src/local-agent/watcher.ts

@@ -797,6 +797,91 @@ async function updateAgentUserBio(
   }
 }
 
+async function publishAgentProfileWiki(
+  config: LocalAgentConfig,
+  dependencies: WatcherDependencies
+): Promise<void> {
+  const logger = dependencies.logger ?? console;
+  const def = config.agentDefinition;
+  if (!def) return;
+
+  // Resolve project identifier: explicit/inferred ID, or encoded path from git remote
+  let projectRef: number | string | undefined = config.gitlabProjectId;
+  if (!projectRef) {
+    const remoteUrl = readOriginRemote(config.agentRepoPath, execFileSync);
+    const remote = remoteUrl ? parseGitRemoteUrl(remoteUrl) : undefined;
+    if (remote) {
+      // GitLab API accepts URL-encoded project path as project ID
+      const projectPath = remote.projectPath.startsWith("git/")
+        ? remote.projectPath.replace(/^git\//, "")
+        : remote.projectPath;
+      projectRef = encodeURIComponent(projectPath);
+    }
+  }
+  if (!projectRef) return;
+
+  const agentName = def.name;
+  const slug = `agents/${agentName}`;
+
+  // Build profile page content
+  const lines: string[] = [
+    `# ${def.display_name || agentName}`,
+    "",
+  ];
+
+  if (def.description) {
+    lines.push(def.description, "");
+  }
+
+  // Skills section — skill_refs are the string names from YAML; fall back to parsed skill objects
+  const skillNames = def.skill_refs.length > 0
+    ? def.skill_refs
+    : def.skills.map(s => s.name);
+  if (skillNames.length > 0) {
+    lines.push("## Skills", "", ...skillNames.map(s => `- ${s}`), "");
+  }
+
+  // Triggers section
+  const triggers = def.triggers;
+  if (triggers.labels.length > 0) {
+    lines.push("## Trigger Labels", "", ...triggers.labels.map(l => `- \`${l}\``), "");
+  }
+
+  // Instructions preview (from preamble)
+  if (def.prompt.preamble) {
+    lines.push("## Instructions", "", def.prompt.preamble.trim(), "");
+  }
+
+  // How to use section
+  const botMention = config.botUsername ? `@${config.botUsername}` : `@${agentName}`;
+  lines.push(
+    "## How to Use",
+    "",
+    `在 GitLab issue 或 MR 中评论 \`${botMention} <你的需求>\`，agent 会自动接单处理。`,
+    "",
+    "## Status",
+    "",
+    `> Provider: \`${def.provider}\` | Poll interval: ${def.poll_interval_seconds ?? 30}s`,
+    `>`,
+    `> *Auto-updated by glab-agent on ${new Date().toISOString().slice(0, 16).replace("T", " ")}*`,
+  );
+
+  const content = lines.join("\n");
+
+  try {
+    const pages = await dependencies.gitlabClient.listWikiPages(projectRef);
+    const existing = pages.find(p => p.slug === slug || p.slug === `agents-${agentName}`);
+    if (existing) {
+      await dependencies.gitlabClient.updateWikiPage(projectRef, existing.slug, slug, content);
+    } else {
+      await dependencies.gitlabClient.createWikiPage(projectRef, slug, content);
+    }
+    logger.info(`Wiki profile published: agents/${agentName}`);
+  } catch (error) {
+    logger.info?.(`Wiki profile update skipped: ${String(error).slice(0, 100)}`);
+  }
+}
+
 export async function markAgentOffline(
   _config: LocalAgentConfig,
   gitlabClient: GitlabClient,
@@ -1178,6 +1263,7 @@ export async function main(argv: string[] = process.argv.slice(2)): Promise<void
 
     // Update GitLab user bio with agent profile (P1: Agent = 员工)
     await updateAgentUserBio(config, dependencies);
+    await publishAgentProfileWiki(config, dependencies);
     await updateAgentUserStatus(dependencies, "idle", undefined, config);
   } catch (error) {
     logger.error(`Token validation failed for agent "${agentName}": ${String(error)}`);