@posthog/agent 2.1.125 → 2.1.137

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/agent",
-  "version": "2.1.125",
+  "version": "2.1.137",
   "repository": "https://github.com/PostHog/twig",
   "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   "exports": {
@@ -65,7 +65,6 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/tar": "^6.1.13",
-    "minimatch": "^10.0.3",
     "msw": "^2.12.7",
     "tsup": "^8.5.1",
     "tsx": "^4.20.6",
@@ -88,6 +87,7 @@
     "commander": "^14.0.2",
     "hono": "^4.11.7",
     "jsonwebtoken": "^9.0.2",
+    "minimatch": "^10.0.3",
     "tar": "^7.5.0",
     "uuid": "13.0.0",
     "yoga-wasm-web": "^0.3.3",

package/src/adapters/base-acp-agent.ts

@@ -23,12 +23,14 @@ import {
   isAnthropicModel,
 } from "../gateway-models.js";
 import { Logger } from "../utils/logger.js";
+import type { SettingsManager } from "./claude/session/settings.js";
 
 export interface BaseSession {
   notificationHistory: SessionNotification[];
   cancelled: boolean;
   interruptReason?: string;
   abortController: AbortController;
+  settingsManager: SettingsManager;
 }
 
 export abstract class BaseAcpAgent implements Agent {
@@ -47,18 +49,18 @@ export abstract class BaseAcpAgent implements Agent {
   abstract initialize(request: InitializeRequest): Promise<InitializeResponse>;
   abstract newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
   abstract prompt(params: PromptRequest): Promise<PromptResponse>;
-  protected abstract interruptSession(): Promise<void>;
+  protected abstract interrupt(): Promise<void>;
 
   async cancel(params: CancelNotification): Promise<void> {
     if (this.sessionId !== params.sessionId) {
-      throw new Error("Session not found");
+      throw new Error("Session ID mismatch");
     }
     this.session.cancelled = true;
     const meta = params._meta as { interruptReason?: string } | undefined;
     if (meta?.interruptReason) {
       this.session.interruptReason = meta.interruptReason;
     }
-    await this.interruptSession();
+    await this.interrupt();
   }
 
   async closeSession(): Promise<void> {
@@ -68,6 +70,7 @@ export abstract class BaseAcpAgent implements Agent {
       // while the query waits on an API call that will never abort.
       this.session.abortController.abort();
       await this.cancel({ sessionId: this.sessionId });
+      this.session.settingsManager.dispose();
       this.logger.info("Closed session", { sessionId: this.sessionId });
     } catch (err) {
       this.logger.warn("Failed to close session", {

package/src/adapters/claude/UPSTREAM.md

@@ -0,0 +1,63 @@
+# Upstream Sync
+
+Fork of `@anthropic-ai/claude-agent-acp`. Upstream repo: https://github.com/anthropics/claude-code
+
+## Fork Point
+
+- **Forked**: v0.10.9, commit `5411e0f4`, Dec 2 2025
+- **Last sync**: v0.19.2, March 2 2026
+- **SDK**: `@anthropic-ai/claude-agent-sdk` 0.2.63, `@agentclientprotocol/sdk` ^0.14.0
+
+## File Mapping
+
+| Twig | Upstream |
+|---|---|
+| `conversion/tool-use-to-acp.ts` | `tools.ts` |
+| `conversion/sdk-to-acp.ts` | inline in `acp-agent.ts` |
+| `conversion/acp-to-sdk.ts` | inline in `acp-agent.ts` |
+| `claude-agent.ts` | `acp-agent.ts` |
+| `permissions/*` | inline in `acp-agent.ts` |
+| `session/options.ts` | inline in `acp-agent.ts` |
+| `session/commands.ts` | inline in `acp-agent.ts` |
+| `hooks.ts` | `tools.ts` |
+| `types.ts` | inline |
+
+## Twig-Only Code (Do Not Sync)
+
+- PostHog analytics (`_posthog/*` ext notifications, `_posthog/usage_update`)
+- Process lifecycle (spawn wrappers, PID tracking, `onProcessSpawned`/`onProcessExited`)
+- Plan mode (`plan/`, EnterPlanMode/ExitPlanMode handlers, plan validation)
+- Gateway models (`session/models.ts`, `base-acp-agent.ts`, `fetchGatewayModels`)
+- AskUserQuestion handler (`questions/`, `CLAUDE_CODE_ENABLE_ASK_USER_QUESTION_TOOL`)
+- Execution modes and tool allowlists (`tools.ts`, `TwigExecutionMode`)
+- MCP metadata caching (`mcp/`)
+- Branch naming in system prompt
+- `broadcastUserMessage` in prompt()
+- `interruptReason` on cancel
+- `SYSTEM_REMINDER` stripping from Read tool results
+- WebFetch `resourceLink` content enrichment
+- `customTitle` in listSessions (Twig is ahead of upstream here)
+- SettingsManager `PreToolUse` hook for permission rules
+- `ensureLocalSettings` / `clearStatsigCache`
+- `ELECTRON_RUN_AS_NODE` / `ENABLE_TOOL_SEARCH` env vars
+
+## Intentional Divergences
+
+| Area | Upstream | Twig | Reason |
+|---|---|---|---|
+| AskUserQuestion | Always disallowed | Enabled via env var + permission handler | Twig supports structured questions |
+| Model resolution | `initializationResult.models` from SDK | `fetchGatewayModels()` from gateway API | Different model backend |
+| permissionMode | Hardcoded `"default"` | Reads from `meta.permissionMode` | More flexible mode selection |
+| Session storage | `this.sessions[sessionId]` (multi) | `this.session` (single) | Architectural choice |
+| ExitPlanMode denial | `interrupt: true` | `interrupt: false` | Better UX — lets Claude refine plan |
+| bypassPermissions | `updatedPermissions` with `destination: "session"` | No `updatedPermissions` | Different permission persistence |
+| Auth methods | Always returns `claude-login` auth method | Returns empty `authMethods` | Auth handled externally |
+
+## Next Sync
+
+1. Check upstream changelog since v0.19.2
+2. Diff upstream source against Twig using the file mapping above
+3. Port in phases: bug fixes first, then features
+4. After each phase: `pnpm --filter agent typecheck && pnpm --filter agent build && pnpm lint`
+5. After all phases: `pnpm typecheck && pnpm test`
+6. Update this file