@ank1015/llm-extension 0.0.1

package/dist/sdk/observe/storage.d.ts

@@ -0,0 +1,39 @@
+import type { NormalizedObserveOptions, ObserveSnapshot } from './types.js';
+interface PersistObserveSnapshotInput {
+    windowId: number;
+    tabId: number;
+    snapshot: ObserveSnapshot;
+    options: NormalizedObserveOptions;
+}
+export interface PersistObserveSnapshotResult {
+    snapshotId: string;
+    snapshotPath: string;
+    latestPath: string;
+}
+export interface ObserveSnapshotPointer {
+    version: number;
+    snapshotId: string;
+    createdAt: string;
+    windowId: number;
+    tabId: number;
+    snapshotPath: string;
+}
+export interface ObserveSnapshotRecord {
+    version: number;
+    snapshotId: string;
+    createdAt: string;
+    windowId: number;
+    tabId: number;
+    options: NormalizedObserveOptions;
+    snapshot: ObserveSnapshot;
+}
+export declare function getObserveTabDir(windowId: number, tabId: number): string;
+export declare function getObserveLatestPath(windowId: number, tabId: number): string;
+export declare function persistObserveSnapshot(input: PersistObserveSnapshotInput): Promise<PersistObserveSnapshotResult>;
+/**
+ * Reads the latest observe snapshot record for a window+tab.
+ * Returns null when no snapshot exists yet.
+ */
+export declare function readLatestObserveSnapshot(windowId: number, tabId: number): Promise<ObserveSnapshotRecord | null>;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/sdk/observe/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/sdk/observe/storage.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,UAAU,2BAA2B;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,wBAAwB,CAAC;IAClC,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAkCvC;AA4BD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAkBvC"}

package/dist/sdk/observe/storage.js

@@ -0,0 +1,83 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export function getObserveTabDir(windowId, tabId) {
+    return join(tmpdir(), 'ank1015-llm', 'window-observe', `window-${windowId}`, `tab-${tabId}`);
+}
+export function getObserveLatestPath(windowId, tabId) {
+    return join(getObserveTabDir(windowId, tabId), 'latest.json');
+}
+export async function persistObserveSnapshot(input) {
+    const dir = getObserveTabDir(input.windowId, input.tabId);
+    await mkdir(dir, { recursive: true });
+    const snapshotId = `obs_${Date.now().toString(36)}_${randomUUID().slice(0, 8)}`;
+    const snapshotPath = join(dir, `snapshot-${snapshotId}.json`);
+    const latestPath = join(dir, 'latest.json');
+    const record = {
+        version: 1,
+        snapshotId,
+        createdAt: new Date().toISOString(),
+        windowId: input.windowId,
+        tabId: input.tabId,
+        options: input.options,
+        snapshot: input.snapshot,
+    };
+    await writeFile(snapshotPath, JSON.stringify(record, null, 2), 'utf-8');
+    const pointer = {
+        version: 1,
+        snapshotId,
+        createdAt: record.createdAt,
+        windowId: input.windowId,
+        tabId: input.tabId,
+        snapshotPath,
+    };
+    await writeFile(latestPath, JSON.stringify(pointer, null, 2), 'utf-8');
+    return {
+        snapshotId,
+        snapshotPath,
+        latestPath,
+    };
+}
+async function readJsonFile(path) {
+    try {
+        const raw = await readFile(path, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSnapshotRecord(value) {
+    return (isObject(value) &&
+        typeof value.snapshotId === 'string' &&
+        typeof value.windowId === 'number' &&
+        typeof value.tabId === 'number' &&
+        isObject(value.snapshot));
+}
+/**
+ * Reads the latest observe snapshot record for a window+tab.
+ * Returns null when no snapshot exists yet.
+ */
+export async function readLatestObserveSnapshot(windowId, tabId) {
+    const latestPath = getObserveLatestPath(windowId, tabId);
+    const pointer = await readJsonFile(latestPath);
+    if (!pointer || typeof pointer.snapshotPath !== 'string') {
+        return null;
+    }
+    const record = await readJsonFile(pointer.snapshotPath);
+    if (!isSnapshotRecord(record)) {
+        return null;
+    }
+    if (record.windowId !== windowId || record.tabId !== tabId) {
+        return null;
+    }
+    return record;
+}
+//# sourceMappingURL=storage.js.map

package/dist/sdk/observe/storage.js.map

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

package/dist/sdk/observe/types.d.ts

@@ -0,0 +1,140 @@
+export type ObserveFilter = 'interactive' | 'buttons' | 'links' | 'inputs' | 'text' | 'forms' | 'media' | 'alerts';
+export interface WindowObserveOptions {
+    tabId?: number;
+    filters?: ObserveFilter[];
+    /**
+     * Optional semantic query. When provided, Window.observe passes a semantic input
+     * string to the constructor-provided semanticFilter callback and returns its result.
+     */
+    semanticFilter?: string;
+    /**
+     * Maximum number of items to return in list-heavy sections.
+     * Default: 120. Filtered observe defaults to a lower cap when omitted.
+     */
+    max?: number;
+    timeoutMs?: number;
+}
+export interface ObserveLocator {
+    id?: string;
+    testId?: string;
+    name?: string;
+    role?: string;
+    cssPath?: string;
+}
+export interface ObserveBBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type ObserveInteractiveCategory = 'button' | 'link' | 'input' | 'interactive';
+export interface ObserveSelectOption {
+    value: string;
+    label: string;
+    selected: boolean;
+    disabled: boolean;
+}
+export interface ObserveInteractiveElement {
+    id: string;
+    category: ObserveInteractiveCategory;
+    tag: string;
+    role: string;
+    name: string;
+    groupId: string;
+    actions: string[];
+    state: string[];
+    locator: ObserveLocator;
+    bbox: ObserveBBox;
+    href?: string;
+    selectOptions?: ObserveSelectOption[];
+}
+export interface ObserveTextBlock {
+    id: string;
+    kind: 'heading' | 'text';
+    text: string;
+    source: string;
+    groupId: string;
+    level?: number;
+}
+export interface ObserveFormSummary {
+    id: string;
+    name: string;
+    fields: string[];
+    submitButtons: string[];
+}
+export interface ObserveMediaElement {
+    id: string;
+    kind: 'audio' | 'video';
+    name: string;
+    state: string[];
+    locator: ObserveLocator;
+    bbox: ObserveBBox;
+    currentTime: number;
+    duration: number;
+    src?: string;
+}
+export interface ObservePageInfo {
+    url: string;
+    title: string;
+    lang: string;
+    capturedAt: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    scroll: {
+        x: number;
+        y: number;
+        maxY: number;
+    };
+}
+export interface ObservePageSummary {
+    interactiveCount: number;
+    totalInteractiveCount: number;
+    textBlockCount: number;
+    totalTextBlockCount: number;
+    formCount: number;
+    mediaCount: number;
+    alertCount: number;
+    totalLinks: number;
+    totalButtons: number;
+    totalInputs: number;
+}
+export interface ObserveTruncation {
+    interactive: boolean;
+    textBlocks: boolean;
+    hiddenFilteredCount: number;
+    offscreenFilteredCount: number;
+}
+export interface ObserveSnapshot {
+    page: ObservePageInfo;
+    summary: ObservePageSummary;
+    interactive: ObserveInteractiveElement[];
+    textBlocks: ObserveTextBlock[];
+    forms: ObserveFormSummary[];
+    media: ObserveMediaElement[];
+    alerts: string[];
+    truncation: ObserveTruncation;
+    warnings: string[];
+}
+export interface NormalizedObserveOptions {
+    filters: ObserveFilter[];
+    semanticFilter?: string;
+    max: number;
+    effectiveMax: number;
+}
+export interface ObserveView {
+    interactive: ObserveInteractiveElement[];
+    textBlocks: ObserveTextBlock[];
+    forms: ObserveFormSummary[];
+    media: ObserveMediaElement[];
+    alerts: string[];
+    includeSections: {
+        interactive: boolean;
+        text: boolean;
+        forms: boolean;
+        media: boolean;
+        alerts: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/observe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/observe/types.ts"],"names":[],"mappings":"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"}

package/dist/sdk/observe/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/observe/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sdk/observe/types.ts"],"names":[],"mappings":""}

package/dist/sdk/window.d.ts

@@ -0,0 +1,97 @@
+import type { WindowActionOptions, WindowScrollOptions, WindowTypeOptions } from './action/index.js';
+import type { WindowObserveOptions } from './observe/index.js';
+export interface WindowOpenOptions {
+    newTab?: boolean;
+    active?: boolean;
+    tabId?: number;
+    timeoutMs?: number;
+}
+export interface WindowScreenshotOptions {
+    tabId?: number;
+    /** Capture full-page screenshot when true. Default: false (viewport only). */
+    fullPage?: boolean;
+}
+export interface WindowEvaluateOptions {
+    tabId?: number;
+    timeoutMs?: number;
+    awaitPromise?: boolean;
+    userGesture?: boolean;
+}
+export interface WindowDownloadOptions {
+    timeoutMs?: number;
+    saveAs?: boolean;
+}
+export interface WindowGetPageOptions {
+    tabId?: number;
+    url?: string;
+    timeoutMs?: number;
+    converterUrl?: string;
+}
+export type { ObserveFilter, WindowObserveOptions } from './observe/index.js';
+export type { WindowActionOptions, WindowScrollBehavior, WindowScrollOptions, WindowTypeOptions, } from './action/index.js';
+export type WindowSemanticFilter = (input: string) => string | Promise<string>;
+export interface WindowTab {
+    id?: number;
+    windowId?: number;
+    active?: boolean;
+    status?: string;
+    url?: string;
+    title?: string;
+}
+/**
+ * Agent-facing window wrapper.
+ *
+ * If a window ID is provided, it is used directly.
+ * Otherwise, a new Chrome window is created during initialization.
+ */
+export declare class Window {
+    private chromePromise;
+    private semanticFilter;
+    private windowId;
+    /** Resolves when constructor initialization completes. */
+    readonly ready: Promise<void>;
+    constructor(windowId?: number | WindowSemanticFilter, semanticFilter?: WindowSemanticFilter);
+    open(url: string, options?: WindowOpenOptions): Promise<WindowTab>;
+    tabs(): Promise<WindowTab[]>;
+    switchTab(tabId: number): Promise<WindowTab>;
+    closeTab(tabId?: number): Promise<void>;
+    back(tabId?: number): Promise<WindowTab>;
+    reload(tabId?: number): Promise<WindowTab>;
+    screenshot(options?: WindowScreenshotOptions): Promise<string>;
+    download(url: string, downloadPath: string, options?: WindowDownloadOptions): Promise<string>;
+    evaluate<T = unknown>(code: string, options?: WindowEvaluateOptions): Promise<T>;
+    getPage(input?: WindowGetPageOptions | number | string): Promise<string>;
+    observe(options?: WindowObserveOptions): Promise<string>;
+    click(targetId: string, options?: WindowActionOptions): Promise<string>;
+    hover(targetId: string, options?: WindowActionOptions): Promise<string>;
+    focus(targetId: string, options?: WindowActionOptions): Promise<string>;
+    pressEnter(targetId: string, options?: WindowActionOptions): Promise<string>;
+    clear(targetId: string, options?: WindowActionOptions): Promise<string>;
+    toggle(targetId: string, options?: WindowActionOptions): Promise<string>;
+    type(targetId: string, value: string, options?: WindowTypeOptions): Promise<string>;
+    select(targetId: string, value: string, options?: WindowActionOptions): Promise<string>;
+    scroll(options?: WindowScrollOptions): Promise<string>;
+    current(): Promise<WindowTab | null>;
+    private runTargetAction;
+    private runPageAction;
+    private waitForPostActionLoad;
+    private captureActionSnapshot;
+    private getTabIfPresent;
+    private renderActionMarkdown;
+    private formatUrlForOutput;
+    private buildScrollPayload;
+    private normalizeGetPageInput;
+    private getCompleteHtml;
+    private convertHtmlToMarkdown;
+    private parseConvertedMarkdown;
+    private closeTabIfPresent;
+    private getChrome;
+    private getWindowId;
+    private resolveTargetTabId;
+    private assertTabInWindow;
+    private waitForTabLoad;
+    private waitForTabClosed;
+    private waitForDownloadCompletion;
+    private getFullPageCaptureParams;
+}
+//# sourceMappingURL=window.d.ts.map

package/dist/sdk/window.d.ts.map

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