@posthog/agent 2.3.370 → 2.3.386

package/dist/tree-tracker.d.ts

@@ -0,0 +1,67 @@
+import { PostHogAPIClient } from './posthog-api.js';
+import { TreeSnapshot } from './types.js';
+import { L as Logger } from './logger-RC7sPv0S.js';
+
+/**
+ * TreeTracker - Git tree-based state capture for cloud/local sync
+ *
+ * Captures the entire working state as a git tree hash + archive:
+ * - Atomic state snapshots (no partial syncs)
+ * - Efficient delta detection using git's diffing
+ * - Simpler resume logic (restore tree, continue)
+ *
+ * Uses Saga pattern for atomic operations with automatic rollback on failure.
+ * Uses a temporary git index to avoid modifying the user's staging area.
+ */
+
+interface TreeTrackerConfig {
+    repositoryPath: string;
+    taskId: string;
+    runId: string;
+    apiClient?: PostHogAPIClient;
+    logger?: Logger;
+}
+declare class TreeTracker {
+    private repositoryPath;
+    private taskId;
+    private runId;
+    private apiClient?;
+    private logger;
+    private lastTreeHash;
+    constructor(config: TreeTrackerConfig);
+    /**
+     * Capture current working tree state as a snapshot.
+     * Uses a temporary index to avoid modifying user's staging area.
+     * Uses Saga pattern for atomic operation with automatic cleanup on failure.
+     */
+    captureTree(options?: {
+        interrupted?: boolean;
+    }): Promise<TreeSnapshot | null>;
+    /**
+     * Download and apply a tree snapshot.
+     * Uses Saga pattern for atomic operation with rollback on failure.
+     */
+    applyTreeSnapshot(snapshot: TreeSnapshot): Promise<void>;
+    /**
+     * Get the last captured tree hash.
+     */
+    getLastTreeHash(): string | null;
+    /**
+     * Set the last tree hash (used when resuming).
+     */
+    setLastTreeHash(hash: string | null): void;
+}
+/**
+ * Check if a commit is available on any remote branch.
+ * Used to validate that cloud can fetch the base commit during handoff.
+ */
+declare function isCommitOnRemote(commit: string, cwd: string): Promise<boolean>;
+/**
+ * Validate that a snapshot can be handed off to cloud execution.
+ * Cloud needs to be able to fetch the baseCommit from a remote.
+ *
+ * @throws Error if the snapshot cannot be restored on cloud
+ */
+declare function validateForCloudHandoff(snapshot: TreeSnapshot, repositoryPath: string): Promise<void>;
+
+export { TreeSnapshot, TreeTracker, type TreeTrackerConfig, isCommitOnRemote, validateForCloudHandoff };