@posthog/agent 2.0.3 → 2.1.5

package/dist/types.d.ts

@@ -101,6 +101,8 @@ interface AgentConfig {
     posthog?: PostHogAPIConfig;
     /** OTEL transport config for shipping logs to PostHog Logs */
     otelTransport?: OtelTransportConfig;
+    /** Skip session log persistence (e.g. for preview sessions with no real task) */
+    skipLogPersistence?: boolean;
     debug?: boolean;
     onLog?: OnLogCallback;
 }

package/package.json

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

package/src/adapters/claude/claude-agent.ts

@@ -138,7 +138,11 @@ export class ClaudeAcpAgent extends BaseAcpAgent {
 
     const meta = params._meta as NewSessionMeta | undefined;
     const internalSessionId = uuidv7();
-    const permissionMode: TwigExecutionMode = "default";
+    const permissionMode: TwigExecutionMode =
+      meta?.permissionMode &&
+      TWIG_EXECUTION_MODES.includes(meta.permissionMode as TwigExecutionMode)
+        ? (meta.permissionMode as TwigExecutionMode)
+        : "default";
 
     const mcpServers = parseMcpServers(params);
     await fetchMcpToolMetadata(mcpServers, this.logger);
@@ -203,10 +207,16 @@ export class ClaudeAcpAgent extends BaseAcpAgent {
     const mcpServers = parseMcpServers(params);
     await fetchMcpToolMetadata(mcpServers, this.logger);
 
+    const permissionMode: TwigExecutionMode =
+      meta?.permissionMode &&
+      TWIG_EXECUTION_MODES.includes(meta.permissionMode as TwigExecutionMode)
+        ? (meta.permissionMode as TwigExecutionMode)
+        : "default";
+
     const { query: q, session } = await this.initializeQuery({
       internalSessionId,
       cwd: params.cwd,
-      permissionMode: "default",
+      permissionMode,
       mcpServers,
       systemPrompt: buildSystemPrompt(meta?.systemPrompt),
       userProvidedOptions: meta?.claudeCode?.options,

package/src/adapters/claude/types.ts

@@ -55,6 +55,7 @@ export type NewSessionMeta = {
   disableBuiltInTools?: boolean;
   systemPrompt?: unknown;
   sessionId?: string;
+  permissionMode?: string;
   claudeCode?: {
     options?: Options;
   };

package/src/agent.ts

@@ -32,22 +32,24 @@ export class Agent {
       this.posthogAPI = new PostHogAPIClient(config.posthog);
     }
 
-    if (config.otelTransport) {
-      // OTEL pipeline: use OtelLogWriter only (no S3 writer)
-      this.sessionLogWriter = new SessionLogWriter({
-        otelConfig: {
-          posthogHost: config.otelTransport.host,
-          apiKey: config.otelTransport.apiKey,
-          logsPath: config.otelTransport.logsPath,
-        },
-        logger: this.logger.child("SessionLogWriter"),
-      });
-    } else if (config.posthog) {
-      // Legacy: use S3 writer via PostHog API
-      this.sessionLogWriter = new SessionLogWriter({
-        posthogAPI: this.posthogAPI,
-        logger: this.logger.child("SessionLogWriter"),
-      });
+    if (!config.skipLogPersistence) {
+      if (config.otelTransport) {
+        // OTEL pipeline: use OtelLogWriter only (no S3 writer)
+        this.sessionLogWriter = new SessionLogWriter({
+          otelConfig: {
+            posthogHost: config.otelTransport.host,
+            apiKey: config.otelTransport.apiKey,
+            logsPath: config.otelTransport.logsPath,
+          },
+          logger: this.logger.child("SessionLogWriter"),
+        });
+      } else if (config.posthog) {
+        // Legacy: use S3 writer via PostHog API
+        this.sessionLogWriter = new SessionLogWriter({
+          posthogAPI: this.posthogAPI,
+          logger: this.logger.child("SessionLogWriter"),
+        });
+      }
     }
   }
 

package/src/types.ts

@@ -141,6 +141,8 @@ export interface AgentConfig {
   posthog?: PostHogAPIConfig;
   /** OTEL transport config for shipping logs to PostHog Logs */
   otelTransport?: OtelTransportConfig;
+  /** Skip session log persistence (e.g. for preview sessions with no real task) */
+  skipLogPersistence?: boolean;
   debug?: boolean;
   onLog?: OnLogCallback;
 }