@posthog/agent 2.3.524 → 2.3.527

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/agent",
-  "version": "2.3.524",
+  "version": "2.3.527",
   "repository": "https://github.com/PostHog/code",
   "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   "exports": {
@@ -20,6 +20,10 @@
       "types": "./dist/posthog-api.d.ts",
       "import": "./dist/posthog-api.js"
     },
+    "./pr-url-detector": {
+      "types": "./dist/pr-url-detector.d.ts",
+      "import": "./dist/pr-url-detector.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js"
@@ -102,9 +106,9 @@
     "tsx": "^4.20.6",
     "typescript": "^5.5.0",
     "vitest": "^2.1.8",
-    "@posthog/git": "1.0.0",
     "@posthog/shared": "1.0.0",
-    "@posthog/enricher": "1.0.0"
+    "@posthog/enricher": "1.0.0",
+    "@posthog/git": "1.0.0"
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "0.19.0",

package/src/adapters/claude/conversion/sdk-to-acp.ts

@@ -90,13 +90,23 @@ function toolMeta(
   toolName: string,
   toolResponse?: unknown,
   parentToolCallId?: string,
+  bashCommand?: string,
 ): ToolUpdateMeta {
   const meta: ToolUpdateMeta["claudeCode"] = { toolName };
   if (toolResponse !== undefined) meta.toolResponse = toolResponse;
   if (parentToolCallId) meta.parentToolCallId = parentToolCallId;
+  if (bashCommand) meta.bashCommand = bashCommand;
   return { claudeCode: meta };
 }
 
+function bashCommandFromToolUse(
+  toolUse: ToolUseCache[string] | undefined,
+): string | undefined {
+  if (!toolUse || toolUse.name !== "Bash") return undefined;
+  const command = (toolUse.input as { command?: unknown } | undefined)?.command;
+  return typeof command === "string" ? command : undefined;
+}
+
 function handleTextChunk(
   chunk: { text: string },
   role: Role,
@@ -181,7 +191,12 @@ function handleToolUseChunk(
           await ctx.client.sessionUpdate({
             sessionId: ctx.sessionId,
             update: {
-              _meta: toolMeta(toolUse.name, toolResponse, ctx.parentToolCallId),
+              _meta: toolMeta(
+                toolUse.name,
+                toolResponse,
+                ctx.parentToolCallId,
+                bashCommandFromToolUse(toolUse),
+              ),
               toolCallId: toolUseId,
               sessionUpdate: "tool_call_update",
               ...(editUpdate ? editUpdate : {}),
@@ -211,7 +226,12 @@ function handleToolUseChunk(
   });
 
   const meta: Record<string, unknown> = {
-    ...toolMeta(chunk.name, undefined, ctx.parentToolCallId),
+    ...toolMeta(
+      chunk.name,
+      undefined,
+      ctx.parentToolCallId,
+      bashCommandFromToolUse(chunk),
+    ),
   };
   if (chunk.name === "Bash" && ctx.supportsTerminalOutput && !alreadyCached) {
     meta.terminal_info = { terminal_id: chunk.id };
@@ -351,7 +371,12 @@ function handleToolResultChunk(
   }
 
   const meta: Record<string, unknown> = {
-    ...toolMeta(toolUse.name, undefined, ctx.parentToolCallId),
+    ...toolMeta(
+      toolUse.name,
+      undefined,
+      ctx.parentToolCallId,
+      bashCommandFromToolUse(toolUse),
+    ),
     ...(resultMeta?.terminal_exit
       ? { terminal_exit: resultMeta.terminal_exit }
       : {}),

package/src/adapters/claude/types.ts

@@ -106,6 +106,7 @@ export type ToolUpdateMeta = {
     toolName: string;
     toolResponse?: unknown;
     parentToolCallId?: string;
+    bashCommand?: string;
   };
   terminal_info?: TerminalInfo;
   terminal_output?: TerminalOutput;

package/src/handoff-checkpoint.ts

@@ -300,7 +300,7 @@ export class HandoffCheckpointTracker {
     checkpoint: GitHandoffCheckpoint,
     uploads: Uploads,
   ): void {
-    this.logger.info("Captured handoff checkpoint", {
+    this.logger.debug("Captured handoff checkpoint", {
       branch: checkpoint.branch,
       head: checkpoint.head?.slice(0, 7),
       totalBytes: this.sumRawBytes(uploads.pack, uploads.index),
@@ -312,7 +312,7 @@ export class HandoffCheckpointTracker {
     _downloads: Downloads,
     totalBytes: number,
   ): void {
-    this.logger.info("Applied handoff checkpoint", {
+    this.logger.debug("Applied handoff checkpoint", {
       branch: checkpoint.branch,
       head: checkpoint.head?.slice(0, 7),
       totalBytes,

package/src/pr-url-detector.test.ts

@@ -0,0 +1,140 @@
+import { describe, expect, it } from "vitest";
+import {
+  type ExtractCreatedPrUrlInput,
+  extractCreatedPrUrl,
+} from "./pr-url-detector";
+
+const PR_URL = "https://github.com/PostHog/posthog/pull/12345";
+
+interface Case {
+  name: string;
+  input: ExtractCreatedPrUrlInput;
+  expected: string | null;
+}
+
+const cases: Case[] = [
+  {
+    name: "returns the URL when gh pr create produced it (string toolResponse)",
+    input: {
+      toolName: "Bash",
+      bashCommand: 'gh pr create --title "x" --body "y"',
+      toolResponse: `${PR_URL}\n`,
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "returns the URL when gh pr create produced it (object toolResponse)",
+    input: {
+      toolName: "Bash",
+      bashCommand: "gh pr create --fill",
+      toolResponse: { stdout: `${PR_URL}\n`, stderr: "" },
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "ignores PR URLs from gh pr view",
+    input: {
+      toolName: "Bash",
+      bashCommand: `gh pr view ${PR_URL}`,
+      toolResponse: { stdout: PR_URL },
+    },
+    expected: null,
+  },
+  {
+    name: "ignores PR URLs from gh search prs",
+    input: {
+      toolName: "Bash",
+      bashCommand: 'gh search prs "fix login"',
+      toolResponse: PR_URL,
+    },
+    expected: null,
+  },
+  {
+    name: "ignores PR URLs from gh pr list",
+    input: {
+      toolName: "Bash",
+      bashCommand: "gh pr list --json url",
+      toolResponse: PR_URL,
+    },
+    expected: null,
+  },
+  {
+    name: "returns null when bashCommand is missing",
+    input: {
+      toolName: "Bash",
+      bashCommand: undefined,
+      toolResponse: PR_URL,
+    },
+    expected: null,
+  },
+  {
+    name: "returns null for non-Bash tools",
+    input: {
+      toolName: "Edit",
+      bashCommand: "gh pr create",
+      toolResponse: PR_URL,
+    },
+    expected: null,
+  },
+  {
+    name: "accepts the lowercase 'bash' tool variant",
+    input: {
+      toolName: "bash",
+      bashCommand: "gh pr create",
+      toolResponse: PR_URL,
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "returns null when output has no PR URL",
+    input: {
+      toolName: "Bash",
+      bashCommand: "gh pr create",
+      toolResponse: "no pr was created",
+    },
+    expected: null,
+  },
+  {
+    name: "finds the URL in the content array when toolResponse is empty",
+    input: {
+      toolName: "Bash",
+      bashCommand: "gh pr create --fill",
+      toolResponse: undefined,
+      content: [{ type: "text", text: `Created: ${PR_URL}` }],
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "handles output field on object toolResponse",
+    input: {
+      toolName: "Bash",
+      bashCommand: "gh pr create",
+      toolResponse: { output: PR_URL },
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "matches gh pr create even with a chained command",
+    input: {
+      toolName: "Bash",
+      bashCommand: "git push -u origin feat/x && gh pr create --fill",
+      toolResponse: { stdout: PR_URL },
+    },
+    expected: PR_URL,
+  },
+  {
+    name: "does not match a fake command containing 'pr create' as text",
+    input: {
+      toolName: "Bash",
+      bashCommand: "echo 'i should pr create later'",
+      toolResponse: PR_URL,
+    },
+    expected: null,
+  },
+];
+
+describe("extractCreatedPrUrl", () => {
+  it.each(cases)("$name", ({ input, expected }) => {
+    expect(extractCreatedPrUrl(input)).toBe(expected);
+  });
+});

package/src/pr-url-detector.ts

@@ -0,0 +1,46 @@
+const PR_URL_REGEX = /https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+/;
+const GH_PR_CREATE_REGEX = /\bgh\s+pr\s+create\b/;
+
+export interface ExtractCreatedPrUrlInput {
+  toolName: string | undefined;
+  bashCommand: string | undefined;
+  toolResponse: unknown;
+  content?: Array<{ type?: string; text?: string }>;
+}
+
+export function extractCreatedPrUrl(
+  input: ExtractCreatedPrUrlInput,
+): string | null {
+  const { toolName, bashCommand, toolResponse, content } = input;
+
+  if (!toolName || !/bash/i.test(toolName)) return null;
+  if (!bashCommand || !GH_PR_CREATE_REGEX.test(bashCommand)) return null;
+
+  let textToSearch = "";
+
+  if (toolResponse) {
+    if (typeof toolResponse === "string") {
+      textToSearch = toolResponse;
+    } else if (typeof toolResponse === "object" && toolResponse !== null) {
+      const respObj = toolResponse as Record<string, unknown>;
+      textToSearch =
+        String(respObj.stdout || "") + String(respObj.stderr || "");
+      if (!textToSearch && respObj.output) {
+        textToSearch = String(respObj.output);
+      }
+    }
+  }
+
+  if (Array.isArray(content)) {
+    for (const item of content) {
+      if (item.type === "text" && item.text) {
+        textToSearch += ` ${item.text}`;
+      }
+    }
+  }
+
+  if (!textToSearch) return null;
+
+  const match = textToSearch.match(PR_URL_REGEX);
+  return match ? match[0] : null;
+}

package/src/server/agent-server.test.ts

@@ -625,7 +625,7 @@ describe("AgentServer HTTP Mode", () => {
   });
 
   describe("detectedPrUrl tracking", () => {
-    it("stores PR URL when detectAndAttachPrUrl finds a match", () => {
+    it("stores PR URL when gh pr create produces it", () => {
       const s = createServer();
       const payload = {
         task_id: "test-task-id",
@@ -635,6 +635,7 @@ describe("AgentServer HTTP Mode", () => {
         _meta: {
           claudeCode: {
             toolName: "Bash",
+            bashCommand: 'gh pr create --title "x" --body "y"',
             toolResponse: {
               stdout:
                 "https://github.com/PostHog/posthog/pull/42\nCreating pull request...",
@@ -659,6 +660,7 @@ describe("AgentServer HTTP Mode", () => {
         _meta: {
           claudeCode: {
             toolName: "Bash",
+            bashCommand: "gh pr create",
             toolResponse: { stdout: "just some output" },
           },
         },
@@ -667,6 +669,71 @@ describe("AgentServer HTTP Mode", () => {
       (s as unknown as TestableServer).detectAndAttachPrUrl(payload, update);
       expect((s as unknown as TestableServer).detectedPrUrl).toBeNull();
     });
+
+    it("does not attach PR URL when the bash command is gh pr view", () => {
+      const s = createServer();
+      const payload = {
+        task_id: "test-task-id",
+        run_id: "test-run-id",
+      };
+      const update = {
+        _meta: {
+          claudeCode: {
+            toolName: "Bash",
+            bashCommand: "gh pr view 42 --json url",
+            toolResponse: {
+              stdout: "https://github.com/PostHog/posthog/pull/42",
+            },
+          },
+        },
+      };
+
+      (s as unknown as TestableServer).detectAndAttachPrUrl(payload, update);
+      expect((s as unknown as TestableServer).detectedPrUrl).toBeNull();
+    });
+
+    it("does not attach PR URL when the bash command is gh search prs", () => {
+      const s = createServer();
+      const payload = {
+        task_id: "test-task-id",
+        run_id: "test-run-id",
+      };
+      const update = {
+        _meta: {
+          claudeCode: {
+            toolName: "Bash",
+            bashCommand: 'gh search prs "fix login"',
+            toolResponse: {
+              stdout: "https://github.com/PostHog/posthog/pull/42",
+            },
+          },
+        },
+      };
+
+      (s as unknown as TestableServer).detectAndAttachPrUrl(payload, update);
+      expect((s as unknown as TestableServer).detectedPrUrl).toBeNull();
+    });
+
+    it("does not attach PR URL when bashCommand is missing", () => {
+      const s = createServer();
+      const payload = {
+        task_id: "test-task-id",
+        run_id: "test-run-id",
+      };
+      const update = {
+        _meta: {
+          claudeCode: {
+            toolName: "Bash",
+            toolResponse: {
+              stdout: "https://github.com/PostHog/posthog/pull/42",
+            },
+          },
+        },
+      };
+
+      (s as unknown as TestableServer).detectAndAttachPrUrl(payload, update);
+      expect((s as unknown as TestableServer).detectedPrUrl).toBeNull();
+    });
   });
 
   describe("buildCloudSystemPrompt", () => {

package/src/server/agent-server.ts

@@ -29,6 +29,7 @@ import type { PermissionMode } from "../execution-mode";
 import { DEFAULT_CODEX_MODEL } from "../gateway-models";
 import { HandoffCheckpointTracker } from "../handoff-checkpoint";
 import { PostHogAPIClient } from "../posthog-api";
+import { extractCreatedPrUrl } from "../pr-url-detector";
 import {
   formatConversationForResume,
   type ResumeState,
@@ -588,7 +589,7 @@ export class AgentServer {
     switch (method) {
       case POSTHOG_NOTIFICATIONS.USER_MESSAGE:
       case "user_message": {
-        this.logger.info("Received user_message command", {
+        this.logger.debug("Received user_message command", {
           hasContent:
             typeof params.content === "string"
               ? params.content.trim().length > 0
@@ -608,7 +609,7 @@ export class AgentServer {
         if (prompt.length === 0) {
           throw new Error("User message cannot be empty");
         }
-        this.logger.info("Built user_message prompt", {
+        this.logger.debug("Built user_message prompt", {
           blockTypes: prompt.map((block) => block.type),
         });
         const promptPreview = promptBlocksToText(prompt);
@@ -718,7 +719,7 @@ export class AgentServer {
           ? params.mcpServers
           : [];
 
-        this.logger.info("Refresh session requested", {
+        this.logger.debug("Refresh session requested", {
           serverCount: mcpServers.length,
         });
 
@@ -1191,7 +1192,7 @@ export class AgentServer {
             this.resumeState.latestGitCheckpoint,
           );
           checkpointApplied = true;
-          this.logger.info("Git checkpoint applied", {
+          this.logger.debug("Git checkpoint applied", {
             branch: this.resumeState.latestGitCheckpoint.branch,
             head: this.resumeState.latestGitCheckpoint.head,
             packBytes: metrics.packBytes,
@@ -1314,7 +1315,7 @@ export class AgentServer {
       taskId: taskRun.task,
       runId: taskRun.id,
     });
-    this.logger.info("Built pending user prompt", {
+    this.logger.debug("Built pending user prompt", {
       hasMessage: typeof message === "string" && message.trim().length > 0,
       requestedArtifactCount: artifactIds.length,
       blockTypes: prompt.map((block) => block.type),
@@ -2131,45 +2132,21 @@ ${attributionInstructions}
       const meta = (update?._meta as Record<string, unknown>)?.claudeCode as
         | Record<string, unknown>
         | undefined;
-      const toolResponse = meta?.toolResponse;
-
-      // Extract text content from tool response
-      let textToSearch = "";
-
-      if (toolResponse) {
-        if (typeof toolResponse === "string") {
-          textToSearch = toolResponse;
-        } else if (typeof toolResponse === "object" && toolResponse !== null) {
-          const respObj = toolResponse as Record<string, unknown>;
-          textToSearch =
-            String(respObj.stdout || "") + String(respObj.stderr || "");
-          if (!textToSearch && respObj.output) {
-            textToSearch = String(respObj.output);
-          }
-        }
-      }
-
-      // Also check content array
-      const content = update?.content;
-      if (Array.isArray(content)) {
-        for (const item of content) {
-          if (item.type === "text" && item.text) {
-            textToSearch += ` ${item.text}`;
-          }
-        }
-      }
 
-      if (!textToSearch) return;
+      const content = update?.content as
+        | Array<{ type?: string; text?: string }>
+        | undefined;
 
-      // Match GitHub PR URLs
-      const prUrlMatch = textToSearch.match(
-        /https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+/,
-      );
-      if (!prUrlMatch) return;
+      const prUrl = extractCreatedPrUrl({
+        toolName: meta?.toolName as string | undefined,
+        bashCommand: meta?.bashCommand as string | undefined,
+        toolResponse: meta?.toolResponse,
+        content,
+      });
+      if (!prUrl) return;
 
-      const prUrl = prUrlMatch[0];
       this.detectedPrUrl = prUrl;
-      this.logger.debug("Detected PR URL in bash output", {
+      this.logger.debug("Detected PR URL from gh pr create", {
         runId: payload.run_id,
         prUrl,
       });