@posthog/agent 2.3.466 → 2.3.478

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/agent",
-  "version": "2.3.466",
+  "version": "2.3.478",
   "repository": "https://github.com/PostHog/code",
   "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   "exports": {

package/src/adapters/claude/session/instructions.ts

@@ -2,6 +2,8 @@ const BRANCH_NAMING = `
 # Branch Naming
 
 When working in a detached HEAD state, create a descriptive branch name based on the work being done before committing. Do this automatically without asking the user.
+
+When creating a new branch, prefix it with \`posthog-code/\` (e.g. \`posthog-code/fix-login-redirect\`).
 `;
 
 const PLAN_MODE = `

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

@@ -382,6 +382,35 @@ describe("AgentServer HTTP Mode", () => {
     }, 20000);
   });
 
+  describe("session lifecycle", () => {
+    it("emits _posthog/run_started after session initialization", async () => {
+      await createServer().start();
+
+      // The notification is persisted via `logWriter.appendRawLine` which the
+      // mock backend's append_log handler captures into `appendLogCalls`.
+      await vi.waitFor(
+        () => {
+          const allEntries = appendLogCalls.flat() as Array<{
+            type?: string;
+            notification?: {
+              method?: string;
+              params?: Record<string, unknown>;
+            };
+          }>;
+          const runStarted = allEntries.find(
+            (e) => e?.notification?.method === "_posthog/run_started",
+          );
+          expect(runStarted).toBeDefined();
+          expect(runStarted?.notification?.params).toMatchObject({
+            runId: "test-run-id",
+            taskId: "test-task-id",
+          });
+        },
+        { timeout: 15000, interval: 100 },
+      );
+    }, 30000);
+  });
+
   describe("getInitialPromptOverride", () => {
     it("returns override string from run state", () => {
       const s = createServer();

package/src/server/agent-server.ts

@@ -958,6 +958,29 @@ export class AgentServer {
     await logAgentshRuntimeInfo(this.logger);
     this.logger.debug(`Initial permission mode: ${initialPermissionMode}`);
 
+    // Lifecycle handshake: clients gate "agent is ready to accept user
+    // messages" on this notification. Persisted to the session log so
+    // warm reconnects (sandbox restart with snapshot resume) replay it
+    // and see the agent come online again.
+    const runStartedNotification = {
+      jsonrpc: "2.0" as const,
+      method: POSTHOG_NOTIFICATIONS.RUN_STARTED,
+      params: {
+        sessionId: acpSessionId,
+        runId: payload.run_id,
+        taskId: payload.task_id,
+      },
+    };
+    this.broadcastEvent({
+      type: "notification",
+      timestamp: new Date().toISOString(),
+      notification: runStartedNotification,
+    });
+    this.session.logWriter.appendRawLine(
+      payload.run_id,
+      JSON.stringify(runStartedNotification),
+    );
+
     // Signal in_progress so the UI can start polling for updates
     this.posthogAPI
       .updateTaskRun(payload.task_id, payload.run_id, {