glab-agent 0.1.0 → 0.2.1

package/src/local-agent/codex-runner.ts

@@ -14,6 +14,7 @@ import {
   type AgentRunner,
   type AgentRunnerOptions,
   buildAgentPrompt,
+  buildContextualPrompt,
   createOutputPath,
   isSmokeIssue,
   readSummary,
@@ -70,6 +71,7 @@ export class CodexRunner implements AgentRunner {
       todoId: context?.todoId,
       preamble: this.agentDefinition?.prompt.preamble,
       append: this.agentDefinition?.prompt.append,
+      labels: this.agentDefinition?.labels,
       // skills injected via .agent_context/skills/*.md files, not in prompt
     });
     const codexCommand = resolveCodexCommand(this.env);
@@ -135,6 +137,67 @@ export class CodexRunner implements AgentRunner {
       outputPath
     };
   }
+
+  async runContextual(issue: GitlabIssue, todoBody: string, context?: AgentRunContext): Promise<AgentRunResult> {
+    const signal = context?.signal;
+    const outputPath = await createOutputPath("codex-contextual", issue.iid);
+
+    const prompt = buildContextualPrompt({
+      issueIid: issue.iid,
+      issueTitle: issue.title,
+      gitlabHost: this.gitlabHost,
+      gitlabProjectId: this.gitlabProjectId,
+      todoBody,
+    });
+    const codexCommand = resolveCodexCommand(this.env);
+    const repoPath = this.repoPath || process.cwd();
+
+    this.logger.info(`Contextual reply: ${codexCommand} exec --full-auto -C ${repoPath}`);
+    this.logger.info(`Prompt (${prompt.length} chars): contextual issue #${issue.iid} "${issue.title}"`);
+
+    const timeoutMs = this.timeoutSeconds ? this.timeoutSeconds * 1000 : 0;
+
+    try {
+      const args = ["exec", "--full-auto", "-C", repoPath, "--output-last-message", outputPath];
+      if (this.agentDefinition?.model) {
+        args.push("--model", this.agentDefinition.model);
+      }
+      args.push(prompt);
+
+      await this.execFileImpl(
+        codexCommand,
+        args,
+        {
+          encoding: "utf8",
+          maxBuffer: 10 * 1024 * 1024,
+          env: this.env,
+          ...(timeoutMs > 0 ? { timeout: timeoutMs, killSignal: "SIGTERM" } : {}),
+          ...(signal ? { signal } : {})
+        }
+      );
+
+      const summary = await readSummary(outputPath, "Contextual reply sent.");
+      this.logger.info(`Contextual reply finished. Output: ${outputPath}`);
+      return { summary, outputPath };
+    } catch (error) {
+      const execError = error as { stdout?: string; stderr?: string; killed?: boolean };
+      const isTimeout = execError.killed === true && timeoutMs > 0;
+      if (isTimeout) {
+        this.logger.error(`Contextual reply timed out after ${this.timeoutSeconds}s.`);
+        throw new AgentRunnerError(
+          `Codex timed out after ${this.timeoutSeconds}s.`,
+          `Timed out after ${this.timeoutSeconds}s`,
+          outputPath
+        );
+      }
+      if (execError.stderr) {
+        this.logger.error(`Contextual reply stderr: ${execError.stderr.slice(0, 500)}`);
+      }
+      this.logger.error(`Contextual reply failed: ${String(error).slice(0, 300)}`);
+      const summary = await readSummary(outputPath, `Contextual reply failed: ${String(error)}`);
+      throw new AgentRunnerError("Contextual reply failed.", summary, outputPath);
+    }
+  }
 }
 
 export function resolveCodexCommand(env: NodeJS.ProcessEnv = process.env): string {

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

@@ -53,6 +53,12 @@ export interface GitlabBoard {
   name: string;
 }
 
+export interface WikiPage {
+  slug: string;
+  title: string;
+  content?: string;
+}
+
 export interface GitlabUser {
   id: number;
   username: string;
@@ -85,6 +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>;
 }
 
 interface GitlabGlabClientOptions {
@@ -622,6 +632,67 @@ export class GitlabGlabClient implements GitlabClient {
       });
   }
 
+  async listWikiPages(projectId: number): Promise<WikiPage[]> {
+    const endpoint = this.withQuery(`projects/${projectId}/wikis`, { with_content: "0" });
+    let payload: unknown;
+    try {
+      payload = await this.readJson(endpoint);
+    } catch {
+      return []; // Wiki not enabled or no pages
+    }
+
+    if (!Array.isArray(payload)) {
+      return [];
+    }
+
+    return payload
+      .map((item) => {
+        const p = (item ?? {}) as Payload;
+        const slug = typeof p.slug === "string" ? p.slug : "";
+        const title = typeof p.title === "string" ? p.title : "";
+        if (!slug) return undefined;
+        return { slug, title } satisfies WikiPage;
+      })
+      .filter((w): w is WikiPage => w !== undefined);
+  }
+
+  async getWikiPage(projectId: number, slug: string): Promise<WikiPage> {
+    const payload = await this.readJson(`projects/${projectId}/wikis/${encodeURIComponent(slug)}`);
+    const p = (payload ?? {}) as Payload;
+    return {
+      slug: typeof p.slug === "string" ? p.slug : slug,
+      title: typeof p.title === "string" ? p.title : "",
+      content: typeof p.content === "string" ? p.content : ""
+    };
+  }
+
+  async createWikiPage(projectId: number, title: string, content: string): Promise<WikiPage> {
+    const stdout = await this.request(`projects/${projectId}/wikis`, {
+      method: "POST",
+      fields: { title, content }
+    });
+    const payload = JSON.parse(stdout) as Payload;
+    return {
+      slug: typeof payload.slug === "string" ? payload.slug : "",
+      title: typeof payload.title === "string" ? payload.title : title,
+      content
+    };
+  }
+
+  async updateWikiPage(projectId: number, 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",
+      fields: { title, content }
+    });
+    const payload = JSON.parse(stdout) as Payload;
+    return {
+      slug: typeof payload.slug === "string" ? payload.slug : slug,
+      title: typeof payload.title === "string" ? payload.title : "",
+      content
+    };
+  }
+
   /**
    * Direct HTTP call using Node's built-in fetch.
    * Used for endpoints where glab CLI's response parsing has issues (e.g. PUT /user/status).

package/src/local-agent/notifier.ts

@@ -1,61 +1,3 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-
-export interface NotifyOptions {
-  title: string;
-  subtitle?: string;
-  message: string;
-  url?: string; // URL to open when notification is clicked
-  sound?: boolean; // default true
-}
-
-// Cache the terminal-notifier availability check
-let terminalNotifierAvailable: boolean | undefined;
-
-async function hasTerminalNotifier(): Promise<boolean> {
-  if (terminalNotifierAvailable !== undefined) return terminalNotifierAvailable;
-  try {
-    await execFileAsync("which", ["terminal-notifier"]);
-    terminalNotifierAvailable = true;
-  } catch {
-    terminalNotifierAvailable = false;
-  }
-  return terminalNotifierAvailable;
-}
-
-/** Reset cached availability — for testing only */
-export function _resetTerminalNotifierCache(): void {
-  terminalNotifierAvailable = undefined;
-}
-
-export async function sendNotification(options: NotifyOptions): Promise<void> {
-  const { title, subtitle, message, url, sound = true } = options;
-
-  try {
-    if (process.platform !== "darwin") return; // macOS only
-
-    if (await hasTerminalNotifier()) {
-      const args = ["-title", title, "-message", message];
-      if (subtitle) args.push("-subtitle", subtitle);
-      if (url) args.push("-open", url);
-      if (sound) args.push("-sound", "default");
-      args.push("-group", "glab-agent"); // prevent notification stacking
-      await execFileAsync("terminal-notifier", args);
-    } else {
-      // Fallback to osascript
-      const escape = (s: string) => s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-      let script = `display notification "${escape(message)}" with title "${escape(title)}"`;
-      if (subtitle) script += ` subtitle "${escape(subtitle)}"`;
-      if (sound) script += ` sound name "default"`;
-      await execFileAsync("osascript", ["-e", script]);
-    }
-  } catch {
-    // Notification failures must never affect the main workflow
-  }
-}
-
 // ──────────────────────────────────────────────────────────────────────────────
 // Webhook notification
 // ──────────────────────────────────────────────────────────────────────────────
@@ -123,68 +65,44 @@ export async function sendWebhook(
 // Pre-defined notification templates
 // ──────────────────────────────────────────────────────────────────────────────
 
-export function notifyAccepted(
+export async function notifyAccepted(
   agentName: string,
   issueIid: number,
   issueTitle: string,
   webhookUrl?: string
 ): Promise<void> {
-  const title = `\u{1F916} ${agentName} 已接单`;
-  const message = `#${issueIid} ${issueTitle}`;
-  const promises: Promise<void>[] = [
-    sendNotification({
-      title: `\u{1F916} ${agentName}`,
-      subtitle: "\u5DF2\u63A5\u5355",
-      message,
-    })
-  ];
-  if (webhookUrl) {
-    promises.push(sendWebhook(webhookUrl, { title, message }));
-  }
-  return Promise.all(promises).then(() => {});
+  if (!webhookUrl) return;
+  await sendWebhook(webhookUrl, {
+    title: `\u{1F916} ${agentName} 已接单`,
+    message: `#${issueIid} ${issueTitle}`,
+  });
 }
 
-export function notifyCompleted(
+export async function notifyCompleted(
   agentName: string,
   issueIid: number,
   issueTitle: string,
   mrUrl?: string,
   webhookUrl?: string
 ): Promise<void> {
-  const title = `\u2705 ${agentName} 已完成`;
-  const message = `#${issueIid} ${issueTitle}`;
-  const promises: Promise<void>[] = [
-    sendNotification({
-      title: `\u2705 ${agentName}`,
-      subtitle: "\u5DF2\u5B8C\u6210",
-      message,
-      url: mrUrl,
-    })
-  ];
-  if (webhookUrl) {
-    promises.push(sendWebhook(webhookUrl, { title, message, url: mrUrl }));
-  }
-  return Promise.all(promises).then(() => {});
+  if (!webhookUrl) return;
+  await sendWebhook(webhookUrl, {
+    title: `\u2705 ${agentName} 已完成`,
+    message: `#${issueIid} ${issueTitle}`,
+    url: mrUrl,
+  });
 }
 
-export function notifyFailed(
+export async function notifyFailed(
   agentName: string,
   issueIid: number,
   issueTitle: string,
   summary: string,
   webhookUrl?: string
 ): Promise<void> {
-  const title = `\u274C ${agentName} 执行失败`;
-  const message = `#${issueIid} ${issueTitle}\n${summary.slice(0, 100)}`;
-  const promises: Promise<void>[] = [
-    sendNotification({
-      title: `\u274C ${agentName}`,
-      subtitle: "\u6267\u884C\u5931\u8D25",
-      message,
-    })
-  ];
-  if (webhookUrl) {
-    promises.push(sendWebhook(webhookUrl, { title, message }));
-  }
-  return Promise.all(promises).then(() => {});
+  if (!webhookUrl) return;
+  await sendWebhook(webhookUrl, {
+    title: `\u274C ${agentName} 执行失败`,
+    message: `#${issueIid} ${issueTitle}\n${summary.slice(0, 100)}`,
+  });
 }

package/src/local-agent/report.ts

@@ -1,5 +1,6 @@
 import { readMetrics } from "./metrics.js";
 import type { MetricEvent } from "./metrics.js";
+import type { GitlabClient } from "./gitlab-glab-client.js";
 
 export interface ReportOptions {
   sinceDays: number; // default 7
@@ -181,3 +182,33 @@ export function formatReport(result: ReportResult): string {
 
   return lines.join("\n");
 }
+
+export async function publishReportToWiki(
+  client: GitlabClient,
+  projectId: number,
+  agentName: string,
+  reportText: string
+): Promise<void> {
+  const title = `reports/${agentName}`;
+  const content = [
+    `# Agent Report: ${agentName}`,
+    "",
+    `> Auto-generated by \`glab-agent report\`. Last updated: ${new Date().toISOString()}`,
+    "",
+    reportText
+  ].join("\n");
+
+  // Try update first, create if not found
+  try {
+    const pages = await client.listWikiPages(projectId);
+    const existing = pages.find(p => p.slug === `reports/${agentName}` || p.slug === `reports-${agentName}`);
+    if (existing) {
+      await client.updateWikiPage(projectId, existing.slug, title, content);
+    } else {
+      await client.createWikiPage(projectId, title, content);
+    }
+  } catch {
+    // Fallback: try create
+    await client.createWikiPage(projectId, title, content);
+  }
+}