@lobu/cli 7.1.0 → 7.2.0

package/dist/commands/context.d.ts

@@ -3,6 +3,13 @@ export declare function contextCurrentCommand(): Promise<void>;
 export declare function contextAddCommand(options: {
     name: string;
     apiUrl: string;
+    port?: number;
+    host?: string;
+    databaseUrl?: string;
+    dataDir?: string;
+    cwd?: string;
+    lifecycle?: "managed" | "external";
 }): Promise<void>;
+export declare function contextRmCommand(name: string): Promise<void>;
 export declare function contextUseCommand(name: string): Promise<void>;
 //# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AASA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBxD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3D;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAWA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBxD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3D;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnE"}

package/dist/commands/context.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { addContext, getCurrentContextName, loadContextConfig, resolveContext, setCurrentContext, } from "../internal/index.js";
+import { addContext, getCurrentContextName, loadContextConfig, removeContext, resolveContext, setCurrentContext, } from "../internal/index.js";
 export async function contextListCommand() {
     const config = await loadContextConfig();
     const currentContext = await getCurrentContextName();
@@ -30,9 +30,26 @@ export async function contextCurrentCommand() {
     console.log();
 }
 export async function contextAddCommand(options) {
-    await addContext(options.name, options.apiUrl);
+    const server = {};
+    if (options.port !== undefined)
+        server.port = options.port;
+    if (options.host)
+        server.host = options.host;
+    if (options.databaseUrl)
+        server.databaseUrl = options.databaseUrl;
+    if (options.dataDir)
+        server.dataDir = options.dataDir;
+    if (options.cwd)
+        server.cwd = options.cwd;
+    if (options.lifecycle)
+        server.lifecycle = options.lifecycle;
+    await addContext(options.name, options.apiUrl, Object.keys(server).length === 0 ? undefined : server);
     console.log(chalk.green(`\n  Saved context ${options.name} -> ${options.apiUrl}\n`));
 }
+export async function contextRmCommand(name) {
+    await removeContext(name);
+    console.log(chalk.dim(`\n  Removed context ${name}\n`));
+}
 export async function contextUseCommand(name) {
     const trimmedName = name.trim();
     const config = await setCurrentContext(trimmedName);

package/dist/commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"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"}

package/dist/connectors/chrome.ts

@@ -0,0 +1,351 @@
+/**
+ * Chrome Connector — Owletto for Chrome only.
+ *
+ * One connector per paired Chrome profile. The cloud-side definition is
+ * pure metadata; all execution happens in the extension's service worker
+ * (apps/chrome/background.js: dispatchToolRun) against the user's signed-in
+ * Chrome via chrome.debugger + chrome.scripting + chrome.tabs.
+ *
+ * Surface:
+ *
+ *   feeds.open_tabs
+ *     Auto-wired snapshot feed. The extension emits one event per open tab
+ *     each sync cycle. Cheap and read-only.
+ *
+ *   actions.navigate
+ *     Page.navigate the target tab (default: a fresh background tab; opt
+ *     out via open_in_new_tab=false) to `url`.
+ *
+ *   actions.get_accessibility_tree
+ *     Inject the bundled accessibility-tree.js content script and return a
+ *     structured snapshot of the visible interactive nodes, each with a
+ *     stable {frame_id, document_epoch, ref_id} that subsequent
+ *     click_ref/type_ref calls can target. Sensitive fields (password,
+ *     one-time-code, credit-card autocomplete) are redacted in the page
+ *     before the snapshot leaves it.
+ *
+ *   actions.click_ref / actions.type_ref
+ *     Act on a ref returned by get_accessibility_tree, in the same tab,
+ *     using chrome.debugger Input.dispatchMouseEvent / dispatchKeyEvent /
+ *     insertText. Refs become stale on navigation or DOM replacement; the
+ *     extension surfaces a clear error and the caller re-snapshots.
+ *
+ *   actions.wait_for_selector
+ *     Poll the page for a CSS selector via Runtime.evaluate. Returns when
+ *     it appears or rejects on timeout (default 10s).
+ *
+ *   actions.screenshot
+ *     Page.captureScreenshot. PNG, base64-encoded.
+ *
+ *   actions.evaluate
+ *     Runtime.evaluate(expression). Returns the JSON-serialised result.
+ *     Last-resort escape hatch — prefer ref-based actions because the
+ *     script string is harder to audit.
+ *
+ * The connector author writes a normal server-side sync() that sequences
+ * these actions through `ctx.chrome.<tool>(args)` (helper added in a
+ * later PR — for v1 the actions are reachable directly via the run
+ * scheduling API). No bespoke executor code lives in the extension; new
+ * connectors compose existing tools.
+ *
+ * URL allowlist: each connector that runs on top of this dispatcher
+ * declares `allowedOrigins` on its own definition. The extension refuses
+ * any tool call whose target URL is outside the allowlist.
+ *
+ * Required worker capability is `browser.debugger`.
+ *
+ * Cloud-side `sync()` / `execute()` throw — actual work happens in the
+ * extension's service worker.
+ */
+
+import {
+  type ActionResult,
+  type ConnectorDefinition,
+  ConnectorRuntime,
+  type SyncContext,
+  type SyncResult,
+} from '@lobu/connector-sdk';
+
+const BRIDGE_ONLY =
+  'chrome runs only on a worker advertising capability "browser.debugger" (Owletto for Chrome).';
+
+const tabIdSchema = {
+  type: 'integer',
+  description: 'Tab to act on. Defaults to the run-scoped scratch tab.',
+} as const;
+
+const refIdSchema = {
+  type: 'object',
+  required: ['document_epoch', 'ref_id'],
+  properties: {
+    document_epoch: { type: 'integer' },
+    ref_id: { type: 'integer' },
+  },
+  description:
+    'Element reference returned by a prior get_accessibility_tree call on the same tab + document. frame_id is reserved for future iframe support; v1 dispatches against the main frame.',
+} as const;
+
+export default class ChromeConnector extends ConnectorRuntime {
+  readonly definition: ConnectorDefinition = {
+    key: 'chrome',
+    name: 'Chrome',
+    description:
+      'Paired Chrome profile. Tab snapshots + a fixed set of typed browser actions (navigate, click, type, wait, screenshot, accessibility snapshot, evaluate) that connectors compose without shipping per-connector code into the extension.',
+    version: '0.2.0',
+    faviconDomain: 'google.com',
+    requiredCapability: 'browser.debugger',
+    runtime: { platforms: ['chrome-extension'] as unknown as ['macos'] },
+    authSchema: { methods: [{ type: 'none' }] },
+    feeds: {
+      open_tabs: {
+        key: 'open_tabs',
+        name: 'Open tabs',
+        description: 'Snapshot of the tabs currently open in this Chrome profile.',
+        configSchema: { type: 'object', properties: {} },
+        eventKinds: {
+          tab_snapshot: {
+            description: 'One row per tab observed in the active poll cycle.',
+            metadataSchema: {
+              type: 'object',
+              required: ['source', 'origin_id', 'url'],
+              properties: {
+                source: { type: 'string', const: 'chrome_tabs' },
+                origin_id: { type: 'string' },
+                url: { type: 'string', format: 'uri' },
+                title: { type: 'string' },
+                window_id: { type: 'integer' },
+                active: { type: 'boolean' },
+              },
+            },
+          },
+        },
+      },
+      tab_events: {
+        key: 'tab_events',
+        name: 'Tab events',
+        description:
+          'Live stream of tab creates / closes / URL changes / focus changes. Each event has a timestamp, so this is the lossless "browsing timeline" companion to the open_tabs snapshot. No extra permission required (baseline `tabs`).',
+        configSchema: { type: 'object', properties: {} },
+        eventKinds: {
+          tab_event: {
+            description:
+              'One row per tab lifecycle event. event_type is one of: created, removed, updated, activated.',
+            metadataSchema: {
+              type: 'object',
+              required: ['source', 'origin_id', 'event_type'],
+              properties: {
+                source: { type: 'string', const: 'chrome_tab_events' },
+                origin_id: { type: 'string' },
+                event_type: {
+                  enum: ['created', 'removed', 'updated', 'activated'],
+                },
+                tab_id: { type: 'integer' },
+                url: { type: 'string' },
+                title: { type: 'string' },
+                window_id: { type: 'integer' },
+                from_url: {
+                  type: 'string',
+                  description: 'For updated events, the URL the tab was on before the change.',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    actions: {
+      navigate: {
+        key: 'navigate',
+        name: 'Navigate',
+        description: 'Open a URL in a fresh background tab (default) or an existing tab.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['url'],
+          properties: {
+            url: { type: 'string', format: 'uri' },
+            tab_id: tabIdSchema,
+            open_in_new_tab: {
+              type: 'boolean',
+              description: 'Default true. Opt out for active-tab control.',
+            },
+            wait_for_load: {
+              type: 'boolean',
+              description:
+                'Wait for Page.frameStoppedLoading on the main frame before returning. Default true.',
+            },
+          },
+        },
+        outputSchema: {
+          type: 'object',
+          properties: {
+            tab_id: { type: 'integer' },
+            current_url: { type: 'string' },
+            title: { type: 'string' },
+          },
+        },
+      },
+      get_accessibility_tree: {
+        key: 'get_accessibility_tree',
+        name: 'Get accessibility tree',
+        description:
+          'Return a structured snapshot of the visible interactive elements on the page, with stable refs for click_ref/type_ref. Sensitive fields are redacted.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          properties: {
+            tab_id: tabIdSchema,
+            filter: {
+              enum: ['interactive', 'visible', 'all'],
+              description: 'Default "interactive". "all" is for debugging only.',
+            },
+          },
+        },
+        outputSchema: {
+          type: 'object',
+          properties: {
+            document_epoch: { type: 'integer' },
+            current_url: { type: 'string' },
+            title: { type: 'string' },
+            tree: { type: 'array' },
+          },
+        },
+      },
+      click_ref: {
+        key: 'click_ref',
+        name: 'Click element by ref',
+        description:
+          'Dispatch a mouse click on the element identified by a ref from a prior accessibility snapshot of the same tab + document.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['ref'],
+          properties: {
+            ref: refIdSchema,
+            tab_id: tabIdSchema,
+            button: {
+              enum: ['left', 'right', 'middle'],
+              description: 'Default "left".',
+            },
+            click_count: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 3,
+              description: 'Default 1. Use 2 for double-click, 3 for triple-click.',
+            },
+          },
+        },
+      },
+      type_ref: {
+        key: 'type_ref',
+        name: 'Type into element by ref',
+        description:
+          'Focus the element identified by a ref and dispatch keystrokes to enter the given text. Existing value is replaced by default.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['ref', 'text'],
+          properties: {
+            ref: refIdSchema,
+            tab_id: tabIdSchema,
+            text: { type: 'string' },
+            clear_first: {
+              type: 'boolean',
+              description: 'Default true. Selects all + deletes before typing.',
+            },
+          },
+        },
+      },
+      wait_for_selector: {
+        key: 'wait_for_selector',
+        name: 'Wait for selector',
+        description:
+          'Poll the page for the first match of a CSS selector and return when it appears.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['selector'],
+          properties: {
+            selector: { type: 'string' },
+            tab_id: tabIdSchema,
+            timeout_ms: {
+              type: 'integer',
+              minimum: 100,
+              maximum: 60_000,
+              description: 'Default 10000.',
+            },
+          },
+        },
+      },
+      screenshot: {
+        key: 'screenshot',
+        name: 'Screenshot',
+        description: 'Capture the visible viewport as a PNG.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          properties: {
+            tab_id: tabIdSchema,
+          },
+        },
+        outputSchema: {
+          type: 'object',
+          properties: {
+            data_url: {
+              type: 'string',
+              description: 'data:image/png;base64,... — caller decodes.',
+            },
+            width: { type: 'integer' },
+            height: { type: 'integer' },
+          },
+        },
+      },
+      close_tab: {
+        key: 'close_tab',
+        name: 'Close tab',
+        description:
+          'Close a tab the extension created for this connector. Required at the end of any multi-step session — tabs the extension owned across navigate / get_accessibility_tree / click_ref / etc. are NOT auto-disposed (that would break the natural flow). A reaper closes orphaned owned tabs after 30 minutes.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['tab_id'],
+          properties: { tab_id: { type: 'integer' } },
+        },
+      },
+      evaluate: {
+        key: 'evaluate',
+        name: 'Evaluate JS',
+        description:
+          'Last-resort escape hatch: run a JS expression with Runtime.evaluate and return the JSON-serialised result. Prefer ref-based actions when possible — scripts are harder to audit.',
+        requiresApproval: false,
+        inputSchema: {
+          type: 'object',
+          required: ['expression'],
+          properties: {
+            expression: { type: 'string' },
+            tab_id: tabIdSchema,
+            await_promise: {
+              type: 'boolean',
+              description: 'Default true.',
+            },
+          },
+        },
+        outputSchema: {
+          type: 'object',
+          properties: {
+            value: {},
+            exception: { type: 'string' },
+          },
+        },
+      },
+    },
+  };
+
+  async sync(_ctx: SyncContext): Promise<SyncResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+
+  async execute(): Promise<ActionResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+}

package/dist/connectors/chrome_bookmarks.ts

@@ -0,0 +1,79 @@
+/**
+ * Chrome Bookmarks Connector — Owletto for Chrome only.
+ *
+ * Opt-in ambient feed. The Chrome extension advertises capability
+ * `browser.bookmarks` when the user grants the `bookmarks` Chrome
+ * permission via the sidepanel Permissions panel; the gateway then
+ * auto-wires this connector.
+ *
+ * Emits one event per bookmark (with its folder path). Backfills the
+ * full tree on first sync, then streams `bookmarks.onCreated/onRemoved/
+ * onChanged/onMoved` thereafter.
+ *
+ * Cloud-side `sync()` / `execute()` throw — actual work happens in
+ * apps/chrome/feeds-bookmarks.js in the extension.
+ */
+
+import {
+  type ActionResult,
+  type ConnectorDefinition,
+  ConnectorRuntime,
+  type SyncContext,
+  type SyncResult,
+} from '@lobu/connector-sdk';
+
+const BRIDGE_ONLY =
+  'chrome.bookmarks runs only on a worker advertising capability "browser.bookmarks" (Owletto for Chrome with bookmarks permission granted).';
+
+export default class ChromeBookmarksConnector extends ConnectorRuntime {
+  readonly definition: ConnectorDefinition = {
+    key: 'chrome.bookmarks',
+    name: 'Chrome bookmarks',
+    description:
+      "Bookmarks (and folder structure) from the paired Chrome profile. Opt-in — requires the user to grant the extension's optional `bookmarks` permission.",
+    version: '0.1.0',
+    faviconDomain: 'google.com',
+    requiredCapability: 'browser.bookmarks',
+    runtime: { platforms: ['chrome-extension'] as unknown as ['macos'] },
+    authSchema: { methods: [{ type: 'none' }] },
+    feeds: {
+      bookmarks: {
+        key: 'bookmarks',
+        name: 'Bookmarks',
+        description:
+          'One event per bookmark. Backfills the full tree on first sync via chrome.bookmarks.getTree, then streams onCreated / onRemoved / onChanged / onMoved.',
+        configSchema: { type: 'object', properties: {} },
+        eventKinds: {
+          bookmark: {
+            description: 'One row per bookmark add/remove/edit.',
+            metadataSchema: {
+              type: 'object',
+              required: ['source', 'origin_id', 'event_type'],
+              properties: {
+                source: { type: 'string', const: 'chrome_bookmarks' },
+                origin_id: { type: 'string' },
+                event_type: {
+                  enum: ['created', 'removed', 'changed', 'moved'],
+                },
+                bookmark_id: { type: 'string' },
+                title: { type: 'string' },
+                url: { type: 'string' },
+                parent_folder_id: { type: 'string' },
+                parent_folder_path: { type: 'string' },
+                date_added: { type: 'string', format: 'date-time' },
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+
+  async sync(_ctx: SyncContext): Promise<SyncResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+
+  async execute(): Promise<ActionResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+}

package/dist/connectors/chrome_downloads.ts

@@ -0,0 +1,80 @@
+/**
+ * Chrome Downloads Connector — Owletto for Chrome only.
+ *
+ * Opt-in ambient feed. The Chrome extension advertises capability
+ * `browser.downloads` when the user grants the `downloads` Chrome
+ * permission via the sidepanel Permissions panel; the gateway then
+ * auto-wires this connector.
+ *
+ * Emits one event per download (filename, source URL, mime type, size,
+ * finish time). Backfills recent downloads on first sync via
+ * chrome.downloads.search({}), then streams chrome.downloads.onCreated /
+ * onChanged.
+ *
+ * Cloud-side `sync()` / `execute()` throw — actual work happens in
+ * apps/chrome/feeds-downloads.js in the extension.
+ */
+
+import {
+  type ActionResult,
+  type ConnectorDefinition,
+  ConnectorRuntime,
+  type SyncContext,
+  type SyncResult,
+} from '@lobu/connector-sdk';
+
+const BRIDGE_ONLY =
+  'chrome.downloads runs only on a worker advertising capability "browser.downloads" (Owletto for Chrome with downloads permission granted).';
+
+export default class ChromeDownloadsConnector extends ConnectorRuntime {
+  readonly definition: ConnectorDefinition = {
+    key: 'chrome.downloads',
+    name: 'Chrome downloads',
+    description:
+      "Files downloaded in the paired Chrome profile, with their source URLs. Opt-in — requires the user to grant the extension's optional `downloads` permission.",
+    version: '0.1.0',
+    faviconDomain: 'google.com',
+    requiredCapability: 'browser.downloads',
+    runtime: { platforms: ['chrome-extension'] as unknown as ['macos'] },
+    authSchema: { methods: [{ type: 'none' }] },
+    feeds: {
+      downloads: {
+        key: 'downloads',
+        name: 'Downloads',
+        description:
+          'One event per download. Backfills via chrome.downloads.search({}), then streams onCreated / onChanged (state=complete).',
+        configSchema: { type: 'object', properties: {} },
+        eventKinds: {
+          download: {
+            description: 'One row per file the user downloaded.',
+            metadataSchema: {
+              type: 'object',
+              required: ['source', 'origin_id'],
+              properties: {
+                source: { type: 'string', const: 'chrome_downloads' },
+                origin_id: { type: 'string' },
+                download_id: { type: 'integer' },
+                filename: { type: 'string' },
+                source_url: { type: 'string', format: 'uri' },
+                referrer: { type: 'string' },
+                mime: { type: 'string' },
+                bytes: { type: 'integer' },
+                started_at: { type: 'string', format: 'date-time' },
+                finished_at: { type: 'string', format: 'date-time' },
+                state: { type: 'string' },
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+
+  async sync(_ctx: SyncContext): Promise<SyncResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+
+  async execute(): Promise<ActionResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+}

package/dist/connectors/chrome_history.ts

@@ -0,0 +1,80 @@
+/**
+ * Chrome History Connector — Owletto for Chrome only.
+ *
+ * Opt-in ambient feed. The Chrome extension advertises capability
+ * `browser.history` when the user grants the `history` Chrome permission
+ * via the sidepanel Permissions panel; the gateway then auto-wires this
+ * connector to the paired chrome-extension device.
+ *
+ * Emits one event per page load (URL, title, visit time, transition type).
+ * The backfill feed seeds with up to 90 days of history on first sync; the
+ * live feed streams `history.onVisited` thereafter.
+ *
+ * Cloud-side `sync()` / `execute()` throw — actual work happens in
+ * apps/chrome/feeds-history.js in the extension.
+ */
+
+import {
+  type ActionResult,
+  type ConnectorDefinition,
+  ConnectorRuntime,
+  type SyncContext,
+  type SyncResult,
+} from '@lobu/connector-sdk';
+
+const BRIDGE_ONLY =
+  'chrome.history runs only on a worker advertising capability "browser.history" (Owletto for Chrome with history permission granted).';
+
+export default class ChromeHistoryConnector extends ConnectorRuntime {
+  readonly definition: ConnectorDefinition = {
+    key: 'chrome.history',
+    name: 'Chrome history',
+    description:
+      "Every page the user visits in their paired Chrome profile, with visit time + transition type. Opt-in — requires the user to grant the extension's optional `history` permission.",
+    version: '0.1.0',
+    faviconDomain: 'google.com',
+    requiredCapability: 'browser.history',
+    runtime: { platforms: ['chrome-extension'] as unknown as ['macos'] },
+    authSchema: { methods: [{ type: 'none' }] },
+    feeds: {
+      visits: {
+        key: 'visits',
+        name: 'Visits',
+        description:
+          'One event per page visit. Backfills ~90 days on first sync (chrome.history.search), then streams new visits via the chrome.history.onVisited listener.',
+        configSchema: { type: 'object', properties: {} },
+        eventKinds: {
+          page_visit: {
+            description: 'One row per visit observed.',
+            metadataSchema: {
+              type: 'object',
+              required: ['source', 'origin_id', 'url', 'visit_time'],
+              properties: {
+                source: { type: 'string', const: 'chrome_history' },
+                origin_id: { type: 'string' },
+                url: { type: 'string', format: 'uri' },
+                title: { type: 'string' },
+                visit_time: { type: 'string', format: 'date-time' },
+                transition_type: {
+                  description:
+                    'How the user got to the page: link, typed, auto_bookmark, auto_subframe, manual_subframe, generated, start_page, form_submit, reload, keyword, keyword_generated.',
+                  type: 'string',
+                },
+                visit_id: { type: 'integer' },
+                visit_count: { type: 'integer' },
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+
+  async sync(_ctx: SyncContext): Promise<SyncResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+
+  async execute(): Promise<ActionResult> {
+    throw new Error(BRIDGE_ONLY);
+  }
+}