@posthog/agent 2.1.47 → 2.1.53

package/dist/{agent-BJ7Uacyp.d.ts → agent-9gv5HohC.d.ts}

@@ -44,6 +44,8 @@ interface SessionLogWriterOptions {
     posthogAPI?: PostHogAPIClient;
     /** Logger instance */
     logger?: Logger;
+    /** Local cache path for instant log loading (e.g., ~/.twig) */
+    localCachePath?: string;
 }
 declare class SessionLogWriter {
     private static readonly FLUSH_DEBOUNCE_MS;
@@ -58,6 +60,7 @@ declare class SessionLogWriter {
     private sessions;
     private messageCounts;
     private logger;
+    private localCachePath?;
     constructor(options?: SessionLogWriterOptions);
     flushAll(): Promise<void>;
     register(sessionId: string, context: SessionContext): void;
@@ -68,6 +71,7 @@ declare class SessionLogWriter {
     private extractChunkText;
     private emitCoalescedMessage;
     private scheduleFlush;
+    private writeToLocalCache;
 }
 
 type StreamPair = {
@@ -94,8 +98,6 @@ type AcpConnectionConfig = {
     /** Deployment environment - "local" for desktop, "cloud" for cloud sandbox */
     deviceType?: "local" | "cloud";
     logger?: Logger;
-    /** Enable dev-only instrumentation (timing, verbose logging) */
-    debug?: boolean;
     processCallbacks?: ProcessSpawnedCallback;
     codexOptions?: CodexProcessOptions;
     allowedModelIds?: Set<string>;

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-export { b as Agent } from './agent-BJ7Uacyp.js';
+export { b as Agent } from './agent-9gv5HohC.js';
 import './types.js';
 import '@agentclientprotocol/sdk';
 import './logger-DDBiMOOD.js';

package/dist/agent.js

@@ -271,49 +271,12 @@ import {
 import {
   query
 } from "@anthropic-ai/claude-agent-sdk";
-
-// ../shared/dist/index.js
-var NOOP_COLLECTOR = {
-  time: (_label, fn) => fn(),
-  timeSync: (_label, fn) => fn(),
-  record: () => {
-  },
-  summarize: () => {
-  }
-};
-function createTimingCollector(enabled, log) {
-  if (!enabled) return NOOP_COLLECTOR;
-  const steps = {};
-  return {
-    async time(label, fn) {
-      const start = Date.now();
-      const result = await fn();
-      steps[label] = Date.now() - start;
-      return result;
-    },
-    timeSync(label, fn) {
-      const start = Date.now();
-      const result = fn();
-      steps[label] = Date.now() - start;
-      return result;
-    },
-    record(label, ms) {
-      steps[label] = ms;
-    },
-    summarize(label) {
-      const total = Object.values(steps).reduce((a, b) => a + b, 0);
-      log(`[timing] ${label}: ${total}ms`, steps);
-    }
-  };
-}
-
-// src/adapters/claude/claude-agent.ts
 import { v7 as uuidv7 } from "uuid";
 
 // package.json
 var package_default = {
   name: "@posthog/agent",
-  version: "2.1.47",
+  version: "2.1.53",
   repository: "https://github.com/PostHog/twig",
   description: "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   exports: {
@@ -727,8 +690,8 @@ var ToolContentBuilder = class {
     this.items.push({ type: "content", content: image(data, mimeType, uri) });
     return this;
   }
-  diff(path4, oldText, newText) {
-    this.items.push({ type: "diff", path: path4, oldText, newText });
+  diff(path5, oldText, newText) {
+    this.items.push({ type: "diff", path: path5, oldText, newText });
     return this;
   }
   build() {
@@ -918,13 +881,13 @@ function toolInfoFromToolUse(toolUse, cachedFileContent, logger = new Logger({ d
         locations: []
       };
     case "Edit": {
-      const path4 = input?.file_path ? String(input.file_path) : void 0;
+      const path5 = input?.file_path ? String(input.file_path) : void 0;
       let oldText = input?.old_string ? String(input.old_string) : null;
       let newText = input?.new_string ? String(input.new_string) : "";
       let affectedLines = [];
-      if (path4 && oldText) {
+      if (path5 && oldText) {
         try {
-          const oldContent = cachedFileContent[path4] || "";
+          const oldContent = cachedFileContent[path5] || "";
           const newContent = replaceAndCalculateLocation(oldContent, [
             {
               oldText,
@@ -940,17 +903,17 @@ function toolInfoFromToolUse(toolUse, cachedFileContent, logger = new Logger({ d
         }
       }
       return {
-        title: path4 ? `Edit \`${path4}\`` : "Edit",
+        title: path5 ? `Edit \`${path5}\`` : "Edit",
         kind: "edit",
-        content: input && path4 ? [
+        content: input && path5 ? [
           {
             type: "diff",
-            path: path4,
+            path: path5,
             oldText,
             newText
           }
         ] : [],
-        locations: path4 ? affectedLines.length > 0 ? affectedLines.map((line) => ({ line, path: path4 })) : [{ path: path4 }] : []
+        locations: path5 ? affectedLines.length > 0 ? affectedLines.map((line) => ({ line, path: path5 })) : [{ path: path5 }] : []
       };
     }
     case "Write": {
@@ -2424,12 +2387,10 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
   logWriter;
   options;
   lastSentConfigOptions;
-  debug;
   constructor(client, logWriter, options) {
     super(client);
     this.logWriter = logWriter;
     this.options = options;
-    this.debug = options?.debug ?? false;
     this.toolUseCache = {};
     this.logger = new Logger({ debug: true, prefix: "[ClaudeAcpAgent]" });
   }
@@ -2472,36 +2433,26 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
   }
   async newSession(params) {
     this.checkAuthStatus();
-    const tc = createTimingCollector(
-      this.debug,
-      (msg, data) => this.logger.info(msg, data)
-    );
     const meta = params._meta;
     const sessionId = uuidv7();
     const permissionMode = meta?.permissionMode && TWIG_EXECUTION_MODES.includes(meta.permissionMode) ? meta.permissionMode : "default";
-    const mcpServers = tc.timeSync(
-      "parseMcpServers",
-      () => parseMcpServers(params)
-    );
-    const options = tc.timeSync(
-      "buildSessionOptions",
-      () => buildSessionOptions({
-        cwd: params.cwd,
-        mcpServers,
-        permissionMode,
-        canUseTool: this.createCanUseTool(sessionId),
-        logger: this.logger,
-        systemPrompt: buildSystemPrompt(meta?.systemPrompt),
-        userProvidedOptions: meta?.claudeCode?.options,
-        sessionId,
-        isResume: false,
-        onModeChange: this.createOnModeChange(sessionId),
-        onProcessSpawned: this.options?.onProcessSpawned,
-        onProcessExited: this.options?.onProcessExited
-      })
-    );
+    const mcpServers = parseMcpServers(params);
+    const options = buildSessionOptions({
+      cwd: params.cwd,
+      mcpServers,
+      permissionMode,
+      canUseTool: this.createCanUseTool(sessionId),
+      logger: this.logger,
+      systemPrompt: buildSystemPrompt(meta?.systemPrompt),
+      userProvidedOptions: meta?.claudeCode?.options,
+      sessionId,
+      isResume: false,
+      onModeChange: this.createOnModeChange(sessionId),
+      onProcessSpawned: this.options?.onProcessSpawned,
+      onProcessExited: this.options?.onProcessExited
+    });
     const input = new Pushable();
-    const q = tc.timeSync("sdkQuery", () => query({ prompt: input, options }));
+    const q = query({ prompt: input, options });
     const session = this.createSession(
       sessionId,
       q,
@@ -2513,27 +2464,17 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
     session.taskRunId = meta?.taskRunId;
     this.registerPersistence(sessionId, meta);
     if (meta?.taskRunId) {
-      await tc.time(
-        "extNotification",
-        () => this.client.extNotification("_posthog/sdk_session", {
-          taskRunId: meta.taskRunId,
-          sessionId,
-          adapter: "claude"
-        })
-      );
+      await this.client.extNotification("_posthog/sdk_session", {
+        taskRunId: meta.taskRunId,
+        sessionId,
+        adapter: "claude"
+      });
     }
-    const modelOptions = await tc.time(
-      "fetchModels",
-      () => this.getModelConfigOptions()
-    );
-    this.deferBackgroundFetches(tc, q, sessionId, mcpServers);
+    const modelOptions = await this.getModelConfigOptions();
+    this.deferBackgroundFetches(q, sessionId, mcpServers);
     session.modelId = modelOptions.currentModelId;
     await this.trySetModel(q, modelOptions.currentModelId);
-    const configOptions = await tc.time(
-      "buildConfigOptions",
-      () => this.buildConfigOptions(modelOptions)
-    );
-    tc.summarize("newSession");
+    const configOptions = await this.buildConfigOptions(modelOptions);
     return {
       sessionId,
       configOptions
@@ -2543,10 +2484,6 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
     return this.resumeSession(params);
   }
   async resumeSession(params) {
-    const tc = createTimingCollector(
-      this.debug,
-      (msg, data) => this.logger.info(msg, data)
-    );
     const meta = params._meta;
     const sessionId = meta?.sessionId;
     if (!sessionId) {
@@ -2555,32 +2492,22 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
     if (this.sessionId === sessionId) {
       return {};
     }
-    const mcpServers = tc.timeSync(
-      "parseMcpServers",
-      () => parseMcpServers(params)
-    );
+    const mcpServers = parseMcpServers(params);
     const permissionMode = meta?.permissionMode && TWIG_EXECUTION_MODES.includes(meta.permissionMode) ? meta.permissionMode : "default";
-    const { query: q, session } = await tc.time(
-      "initializeQuery",
-      () => this.initializeQuery({
-        cwd: params.cwd,
-        permissionMode,
-        mcpServers,
-        systemPrompt: buildSystemPrompt(meta?.systemPrompt),
-        userProvidedOptions: meta?.claudeCode?.options,
-        sessionId,
-        isResume: true,
-        additionalDirectories: meta?.claudeCode?.options?.additionalDirectories
-      })
-    );
+    const { query: q, session } = await this.initializeQuery({
+      cwd: params.cwd,
+      permissionMode,
+      mcpServers,
+      systemPrompt: buildSystemPrompt(meta?.systemPrompt),
+      userProvidedOptions: meta?.claudeCode?.options,
+      sessionId,
+      isResume: true,
+      additionalDirectories: meta?.claudeCode?.options?.additionalDirectories
+    });
     session.taskRunId = meta?.taskRunId;
     this.registerPersistence(sessionId, meta);
-    this.deferBackgroundFetches(tc, q, sessionId, mcpServers);
-    const configOptions = await tc.time(
-      "buildConfigOptions",
-      () => this.buildConfigOptions()
-    );
-    tc.summarize("resumeSession");
+    this.deferBackgroundFetches(q, sessionId, mcpServers);
+    const configOptions = await this.buildConfigOptions();
     return { configOptions };
   }
   async prompt(params) {
@@ -2768,13 +2695,10 @@ var ClaudeAcpAgent = class extends BaseAcpAgent {
    * Fire-and-forget: fetch slash commands and MCP tool metadata in parallel.
    * Both populate caches used later — neither is needed to return configOptions.
    */
-  deferBackgroundFetches(tc, q, sessionId, mcpServers) {
+  deferBackgroundFetches(q, sessionId, mcpServers) {
     Promise.all([
-      tc.time("slashCommands", () => getAvailableSlashCommands(q)),
-      tc.time(
-        "mcpMetadata",
-        () => fetchMcpToolMetadata(mcpServers, this.logger)
-      )
+      getAvailableSlashCommands(q),
+      fetchMcpToolMetadata(mcpServers, this.logger)
     ]).then(([slashCommands]) => {
       this.sendAvailableCommandsUpdate(sessionId, slashCommands);
     }).catch((err) => {
@@ -3068,10 +2992,7 @@ function createClaudeConnection(config) {
   const agentStream = ndJsonStream(agentWritable, streams.agent.readable);
   let agent = null;
   const agentConnection = new AgentSideConnection((client) => {
-    agent = new ClaudeAcpAgent(client, logWriter, {
-      ...config.processCallbacks,
-      debug: config.debug
-    });
+    agent = new ClaudeAcpAgent(client, logWriter, config.processCallbacks);
     logger.info(`Created ${agent.adapterName} agent`);
     return agent;
   }, agentStream);
@@ -3486,6 +3407,8 @@ var PostHogAPIClient = class {
 };
 
 // src/session-log-writer.ts
+import fs3 from "fs";
+import path4 from "path";
 var SessionLogWriter = class _SessionLogWriter {
   static FLUSH_DEBOUNCE_MS = 500;
   static FLUSH_MAX_INTERVAL_MS = 5e3;
@@ -3499,8 +3422,10 @@ var SessionLogWriter = class _SessionLogWriter {
   sessions = /* @__PURE__ */ new Map();
   messageCounts = /* @__PURE__ */ new Map();
   logger;
+  localCachePath;
   constructor(options = {}) {
     this.posthogAPI = options.posthogAPI;
+    this.localCachePath = options.localCachePath;
     this.logger = options.logger ?? new Logger({ debug: false, prefix: "[SessionLogWriter]" });
   }
   async flushAll() {
@@ -3530,6 +3455,21 @@ var SessionLogWriter = class _SessionLogWriter {
     });
     this.sessions.set(sessionId, { context });
     this.lastFlushAttemptTime.set(sessionId, Date.now());
+    if (this.localCachePath) {
+      const sessionDir = path4.join(
+        this.localCachePath,
+        "sessions",
+        context.runId
+      );
+      try {
+        fs3.mkdirSync(sessionDir, { recursive: true });
+      } catch (error) {
+        this.logger.warn("Failed to create local cache directory", {
+          sessionDir,
+          error
+        });
+      }
+    }
   }
   isRegistered(sessionId) {
     return this.sessions.has(sessionId);
@@ -3567,6 +3507,7 @@ var SessionLogWriter = class _SessionLogWriter {
         timestamp,
         notification: message
       };
+      this.writeToLocalCache(sessionId, entry);
       if (this.posthogAPI) {
         const pending = this.pendingEntries.get(sessionId) ?? [];
         pending.push(entry);
@@ -3667,6 +3608,7 @@ var SessionLogWriter = class _SessionLogWriter {
         }
       }
     };
+    this.writeToLocalCache(sessionId, entry);
     if (this.posthogAPI) {
       const pending = this.pendingEntries.get(sessionId) ?? [];
       pending.push(entry);
@@ -3694,6 +3636,23 @@ var SessionLogWriter = class _SessionLogWriter {
     const timeout = setTimeout(() => this.flush(sessionId), delay);
     this.flushTimeouts.set(sessionId, timeout);
   }
+  writeToLocalCache(sessionId, entry) {
+    if (!this.localCachePath) return;
+    const session = this.sessions.get(sessionId);
+    if (!session) return;
+    const logPath = path4.join(
+      this.localCachePath,
+      "sessions",
+      session.context.runId,
+      "logs.ndjson"
+    );
+    try {
+      fs3.appendFileSync(logPath, `${JSON.stringify(entry)}
+`);
+    } catch (error) {
+      this.logger.warn("Failed to write to local cache", { logPath, error });
+    }
+  }
 };
 
 // src/agent.ts
@@ -3717,7 +3676,8 @@ var Agent = class {
     if (config.posthog && !config.skipLogPersistence) {
       this.sessionLogWriter = new SessionLogWriter({
         posthogAPI: this.posthogAPI,
-        logger: this.logger.child("SessionLogWriter")
+        logger: this.logger.child("SessionLogWriter"),
+        localCachePath: config.localCachePath
       });
     }
   }
@@ -3771,7 +3731,6 @@ var Agent = class {
       taskId,
       deviceType: "local",
       logger: this.logger,
-      debug: this.debug,
       processCallbacks: options.processCallbacks,
       allowedModelIds,
       codexOptions: options.adapter === "codex" && gatewayConfig ? {