btcp-browser-agent 0.1.6 → 0.1.7

package/packages/core/dist/types.d.ts

@@ -93,12 +93,19 @@ export interface GrepOptions {
     /** Treat pattern as fixed string, not regex (grep -F) */
     fixedStrings?: boolean;
 }
+/**
+ * Snapshot mode determines what content to capture
+ */
+export type SnapshotMode = 'interactive' | 'outline' | 'content';
+/**
+ * Snapshot output format
+ */
+export type SnapshotFormat = 'tree' | 'html' | 'markdown';
 export interface SnapshotCommand extends BaseCommand {
     action: 'snapshot';
     selector?: Selector;
     maxDepth?: number;
     includeHidden?: boolean;
-    interactive?: boolean;
     compact?: boolean;
     minDepth?: number;
     samplingStrategy?: 'importance' | 'balanced' | 'depth-first';
@@ -106,10 +113,28 @@ export interface SnapshotCommand extends BaseCommand {
     landmarks?: boolean;
     incremental?: boolean;
     baseSnapshot?: SnapshotData;
-    all?: boolean;
-    format?: 'tree' | 'html';
+    /**
+     * Snapshot mode:
+     * - 'interactive': Find clickable elements (default)
+     * - 'outline': Understand page structure with xpaths + metadata
+     * - 'content': Extract text content from sections
+     */
+    mode?: SnapshotMode;
+    /**
+     * Output format:
+     * - 'tree': Flat accessibility tree (default)
+     * - 'html': Raw HTML
+     * - 'markdown': Markdown formatted content
+     */
+    format?: SnapshotFormat;
     /** Filter output lines - simple string or full grep options */
     grep?: string | GrepOptions;
+    /** Max chars per section in content mode */
+    maxLength?: number;
+    /** Include links as [text](url) in markdown format */
+    includeLinks?: boolean;
+    /** Include images as ![alt](src) in markdown format */
+    includeImages?: boolean;
 }
 export interface QuerySelectorCommand extends BaseCommand {
     action: 'querySelector';

package/packages/extension/dist/index.d.ts

@@ -87,9 +87,13 @@ export interface Client {
     snapshot(options?: {
         selector?: string;
         maxDepth?: number;
-        interactive?: boolean;
+        mode?: 'interactive' | 'outline' | 'content';
         compact?: boolean;
-        format?: 'tree' | 'html';
+        format?: 'tree' | 'html' | 'markdown';
+        grep?: string;
+        maxLength?: number;
+        includeLinks?: boolean;
+        includeImages?: boolean;
     }): Promise<string>;
     /**
      * Click an element

package/packages/extension/dist/index.js

@@ -175,9 +175,13 @@ export function createClient() {
                 action: 'snapshot',
                 selector: options?.selector,
                 maxDepth: options?.maxDepth,
-                interactive: options?.interactive,
+                mode: options?.mode,
                 compact: options?.compact,
                 format: options?.format,
+                grep: options?.grep,
+                maxLength: options?.maxLength,
+                includeLinks: options?.includeLinks,
+                includeImages: options?.includeImages,
             });
             assertSuccess(response);
             return response.data;