@pi-oxide/extension-js 0.13.0 → 0.13.3

package/main/runner/tools/chrome/scripting.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/sessions.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/side-panel.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/system.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/tab-groups.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/tabs.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/top-sites.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome/windows.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/chrome-storage.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/clipboard.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/dom.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/host-call.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/network.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/page.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/sidepanel.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/storage.d.ts

@@ -1 +0,0 @@
-export {};

package/main/runner/tools/tab.d.ts

@@ -1 +0,0 @@
-export {};

package/main/session/extension-session.d.ts

@@ -1,106 +0,0 @@
-import { CellResult, FsCopyParams, FsHashParams, FsPathParams, FsReadRangeDataParams, FsReadRangeParams, FsWriteParams, WasmGlobalsSnapshot } from '../../../pkg/extension_js.js';
-import { InlineSnapshotResult } from '../../shared/cross/collect-inline-snapshot.js';
-import { SnapshotFilter } from '../../shared/cross/snapshot-filter.js';
-import { LogLevel } from '../../shared/main/logger.js';
-
-export declare class ExtensionSession {
-    private worker;
-    private pendingCalls;
-    private inFlightRelays;
-    private disposed;
-    private onCleanupComplete;
-    private abortController;
-    private runQueue;
-    private constructor();
-    /**
-     * Initialize the extension-js runtime.
-     * Automatically detects extension context, spawns the Worker,
-     * starts the main-thread runner loop, and returns [session, runner].
-     *
-     * The spawned Worker uses `new Worker(..., { type: "module" })`. Your bundler
-     * must support emitting module Workers as separate chunks.
-     *
-     * AbortController is module-global: only one active session per extension
-     * page is fully safe. Concurrent sessions race on the same abort signal.
-     */
-    static init(): Promise<[ExtensionSession, Promise<void>]>;
-    private startWorker;
-    private handleWorkerMessage;
-    private executeContextCommand;
-    /**
-     * Race a main-thread command against a hard timeout. If the handler hangs
-     * (e.g. waitForTabLoad on a page that never reaches `complete`, or a content
-     * script that never reconnects), this converts the hang into a structured
-     * E_TIMEOUT error that the relay posts back to the worker — instead of
-     * leaving the cell's join_all awaiting forever.
-     */
-    private withMainThreadTimeout;
-    registerWorkerRelayPort(owner: string, port: MessagePort): void;
-    private executeContentScriptCommand;
-    /** Send a registryCall to a specific frame and unwrap the response. */
-    private sendToFrame;
-    private postAndWait;
-    runCellAsync(code: string, stdin?: string, traceId?: string): Promise<CellResult>;
-    setLogLevel(level: LogLevel): void;
-    reset(): Promise<void>;
-    inspectGlobals(): Promise<WasmGlobalsSnapshot>;
-    apiDocs(format?: "json" | "markdown"): Promise<unknown[] | string>;
-    setFuelLimit(limit: number): void;
-    loadLibrary(source: string): Promise<CellResult>;
-    private safePost;
-    private safePostCsv;
-    private safePostZip;
-    private safePostXlsx;
-    private safePostPdf;
-    get fs(): {
-        exists: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsExistsResult>;
-        stat: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStatResult>;
-        read: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-        readText: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-        readBase64: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-        list: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsListResult>;
-        mkdir: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsBoolResult>;
-        delete: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsBoolResult>;
-        copy: (params: FsCopyParams) => Promise<import('../../worker/extension_js.js').FsBoolResult>;
-        move: (params: FsCopyParams) => Promise<import('../../worker/extension_js.js').FsBoolResult>;
-        write: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        writeText: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        writeBase64: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        append: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        appendText: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        appendBase64: (params: FsWriteParams) => Promise<import('../../worker/extension_js.js').FsWriteResult>;
-        readRange: (params: FsReadRangeParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-        update: (params: FsReadRangeDataParams) => Promise<import('../../worker/extension_js.js').FsBoolResult>;
-        hash: (params: FsHashParams) => Promise<import('../../worker/extension_js.js').FsHashResult>;
-    };
-    get csv(): {
-        parse: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-    };
-    get zip(): {
-        list: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-    };
-    get xlsx(): {
-        read: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-    };
-    get pdf(): {
-        text: (params: FsPathParams) => Promise<import('../../worker/extension_js.js').FsStringResult>;
-    };
-    get snapshot(): {
-        query: (filter?: SnapshotFilter, options?: {
-            maxNodes?: number;
-            tabId?: number;
-        }) => Promise<InlineSnapshotResult>;
-    };
-    /**
-     * Clean up the session, terminate the Worker, and release resources.
-     * Accepts the runner Promise returned by init() so it can be awaited
-     * for graceful shutdown.
-     *
-     * Sends a reset message to the Worker, then waits only 50 ms before
-     * forcefully calling worker.terminate(). If WASM cleanup takes longer,
-     * the Worker is killed mid-operation. Pending async calls are rejected
-     * with "ExtensionSession stopped".
-     */
-    stopWith(runner: Promise<void>): Promise<void>;
-    private generateId;
-}

package/main/tab-context.d.ts

@@ -1,12 +0,0 @@
-import { TabPolicy } from '../shared/cross/types.js';
-
-export declare function getActiveTabId(): number | null;
-export declare function setActiveTabId(tabId: number | null): void;
-export declare function initTabContext(chromeApi: typeof chrome): void;
-export declare function removeTabContextListeners(): void;
-/** @deprecated Use initTabContext — kept for runner API compatibility */
-export declare function initExtensionListeners(): void;
-/** @deprecated Use removeTabContextListeners — kept for runner API compatibility */
-export declare function removeExtensionListeners(): void;
-export declare function resolveActiveTabId(): Promise<number | null>;
-export declare function resolveTabId(tabPolicy: TabPolicy, params: Record<string, unknown>): number;

package/shared/array-buffer.d.ts

@@ -1,4 +0,0 @@
-/** Decode a base64 string into bytes. Throws on invalid input. */
-export declare function base64ToUint8Array(base64: string): Uint8Array;
-/** Convert Uint8Array to base64 without spread-arg limits on large buffers. */
-export declare function arrayBufferToBase64(bytes: Uint8Array): string;

package/shared/collect-inline-snapshot.d.ts

@@ -1,50 +0,0 @@
-export type InlineSnapshotNode = {
-    refId: string;
-    role: string;
-    tag: string;
-    controlType?: string;
-    actionable?: boolean;
-    forControl?: string;
-    recommendedAction?: string;
-    controls?: string;
-    expanded?: boolean;
-    name?: string;
-    text?: string;
-    value?: string;
-    checked?: boolean;
-    disabled?: boolean;
-    readOnly?: boolean;
-    selected?: boolean;
-    required?: boolean;
-    valid?: boolean;
-    invalid?: boolean;
-    validationMessage?: string;
-    errorMessage?: string;
-    href?: string;
-    src?: string;
-    alt?: string;
-    title?: string;
-    parentRefId?: string;
-    postId?: string;
-    permalink?: string;
-    imageUrls?: string[];
-    accept?: string;
-    filesCount?: number;
-};
-export type FormErrorEntry = {
-    field: string;
-    error: string;
-    refId: string;
-};
-export type InlineSnapshotResult = {
-    text: string;
-    nodes: InlineSnapshotNode[];
-    formErrors: FormErrorEntry[];
-    url: string;
-    title: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-};
-export declare function collectInlineSnapshot(maxNodes: number): InlineSnapshotResult;

package/shared/cross/agent-errors.d.ts

@@ -1,28 +0,0 @@
-import { AsyncError } from './manifest.js';
-
-export declare function contentScriptMissingError(tabId?: number, url?: string): AsyncError;
-export declare function noTabError(action: string): AsyncError;
-export type StaleRefCandidate = {
-    refId: string;
-    role?: string;
-    name?: string;
-};
-export declare function staleRefError(refId: string, options?: {
-    label?: string;
-    candidates?: StaleRefCandidate[];
-    snapshot?: unknown;
-}): AsyncError;
-export declare function notInteractableError(action: string, refId: string, details?: Record<string, unknown>): AsyncError;
-export declare function observationRequiredError(action: string): AsyncError;
-export declare function ambiguousTargetError(label: string): AsyncError;
-export declare function isContentScriptConnectionError(msg: string): boolean;
-export declare function throwStructuredAgentError(error: AsyncError): never;
-export declare function labelNotFoundError(label: string, candidates?: StaleRefCandidate[], extra?: {
-    searchedIds?: string[];
-    ignoredIds?: string[];
-    targetRefId?: string;
-    targetName?: string;
-    ariaControlsBefore?: string | null;
-    ariaControlsAfter?: string | null;
-    isDropdown?: boolean;
-}): AsyncError;

package/shared/cross/array-buffer.d.ts

@@ -1,4 +0,0 @@
-/** Decode a base64 string into bytes. Throws on invalid input. */
-export declare function base64ToUint8Array(base64: string): Uint8Array;
-/** Convert Uint8Array to base64 without spread-arg limits on large buffers. */
-export declare function arrayBufferToBase64(bytes: Uint8Array): string;

package/shared/cross/collect-inline-snapshot.d.ts

@@ -1,58 +0,0 @@
-export type InlineSnapshotNode = {
-    refId: string;
-    role: string;
-    tag: string;
-    controlType?: string;
-    actionable?: boolean;
-    forControl?: string;
-    recommendedAction?: string;
-    controls?: string;
-    expanded?: boolean;
-    name?: string;
-    text?: string;
-    value?: string;
-    checked?: boolean;
-    disabled?: boolean;
-    readOnly?: boolean;
-    selected?: boolean;
-    required?: boolean;
-    valid?: boolean;
-    invalid?: boolean;
-    validationMessage?: string;
-    errorMessage?: string;
-    href?: string;
-    src?: string;
-    alt?: string;
-    title?: string;
-    parentRefId?: string;
-    postId?: string;
-    permalink?: string;
-    imageUrls?: string[];
-    accept?: string;
-    filesCount?: number;
-};
-export type FormErrorEntry = {
-    field: string;
-    error: string;
-    refId: string;
-};
-export type InlineSnapshotResult = {
-    text: string;
-    nodes: InlineSnapshotNode[];
-    formErrors: FormErrorEntry[];
-    url: string;
-    title: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-};
-export declare const enrichDropdown: (el: Element, node: {
-    role?: string;
-    tag: string;
-    controlType?: string;
-    recommendedAction?: string;
-    controls?: string;
-    expanded?: boolean;
-}) => void;
-export declare function collectInlineSnapshot(maxNodes: number): InlineSnapshotResult;

package/shared/cross/content-script-actions.d.ts

@@ -1,7 +0,0 @@
-export declare function addContentScriptAction(action: string): void;
-export declare function isContentScriptAction(action: string): boolean;
-export declare function getContentScriptActions(): string[];
-/** Test-only helper: clear the dynamic content-script action set. */
-export declare function clearContentScriptActions(): void;
-/** Map registry action (page_click) to content-script handler key (click). */
-export declare function toHandlerAction(action: string): string;

package/shared/cross/content-script-tools.d.ts

@@ -1,3 +0,0 @@
-export type { ContentScriptToolSpec } from './page-specs.js';
-export { AWAIT_PROMISE_NOTE } from './page-specs.js';
-export declare const CONTENT_SCRIPT_TOOL_SPECS: readonly (import('./page-specs.js').ContentScriptToolSpec<unknown, unknown> | import('./page-specs.js').ContentScriptToolSpec)[];

package/shared/cross/dispatch.d.ts

@@ -1,5 +0,0 @@
-import { z } from 'zod';
-import { AsyncResponse } from './manifest.js';
-
-export declare function formatValidationError(action: string, schema: z.ZodTypeAny, issues: z.ZodIssue[], params?: unknown): string;
-export declare function dispatchValidated<P, R>(paramsSchema: z.ZodSchema<P>, returnsSchema: z.ZodSchema<R>, handler: (params: P) => Promise<R> | R, params: unknown, action: string): Promise<AsyncResponse<R>>;

package/shared/cross/fetch-response.d.ts

@@ -1,12 +0,0 @@
-export type FetchValue = {
-    status: number;
-    ok: boolean;
-    headers: Record<string, string>;
-    body: string;
-    bodyEncoding: "text" | "base64";
-    byteLength: number;
-    contentType: string;
-    finalUrl: string;
-};
-/** Encode a fetch Response for page.fetch / web.fetch with binary-safe handling. */
-export declare function encodeFetchResponse(resp: Response): Promise<FetchValue>;

package/shared/cross/format-types.d.ts

@@ -1,43 +0,0 @@
-import { FsPathParams, FsStringResult } from '../../../pkg/extension_js.js';
-
-export type CsvAction = "parse";
-export type CsvActionMap = {
-    parse: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-};
-export type ZipAction = "list";
-export type ZipActionMap = {
-    list: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-};
-export type XlsxAction = "read";
-export type XlsxActionMap = {
-    read: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-};
-export type PdfAction = "text";
-export type PdfActionMap = {
-    text: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-};
-export type FormatCallMessage<TType extends string, TMap extends Record<string, {
-    params: unknown;
-    result: unknown;
-}>> = {
-    type: TType;
-    id: string;
-    action: keyof TMap & string;
-    params: TMap[keyof TMap]["params"];
-};
-export type CsvCallMessage = FormatCallMessage<"csvCall", CsvActionMap>;
-export type ZipCallMessage = FormatCallMessage<"zipCall", ZipActionMap>;
-export type XlsxCallMessage = FormatCallMessage<"xlsxCall", XlsxActionMap>;
-export type PdfCallMessage = FormatCallMessage<"pdfCall", PdfActionMap>;

package/shared/cross/fs-types.d.ts

@@ -1,81 +0,0 @@
-import { FsBoolResult, FsCopyParams, FsExistsResult, FsHashParams, FsHashResult, FsListResult, FsPathParams, FsReadRangeDataParams, FsReadRangeParams, FsStatResult, FsStringResult, FsWriteParams, FsWriteResult } from '../../../pkg/extension_js.js';
-
-export type FsActionMap = {
-    exists: {
-        params: FsPathParams;
-        result: FsExistsResult;
-    };
-    stat: {
-        params: FsPathParams;
-        result: FsStatResult;
-    };
-    read: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-    readText: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-    readBase64: {
-        params: FsPathParams;
-        result: FsStringResult;
-    };
-    list: {
-        params: FsPathParams;
-        result: FsListResult;
-    };
-    mkdir: {
-        params: FsPathParams;
-        result: FsBoolResult;
-    };
-    delete: {
-        params: FsPathParams;
-        result: FsBoolResult;
-    };
-    copy: {
-        params: FsCopyParams;
-        result: FsBoolResult;
-    };
-    move: {
-        params: FsCopyParams;
-        result: FsBoolResult;
-    };
-    write: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    writeText: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    writeBase64: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    append: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    appendText: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    appendBase64: {
-        params: FsWriteParams;
-        result: FsWriteResult;
-    };
-    readRange: {
-        params: FsReadRangeParams;
-        result: FsStringResult;
-    };
-    update: {
-        params: FsReadRangeDataParams;
-        result: FsBoolResult;
-    };
-    hash: {
-        params: FsHashParams;
-        result: FsHashResult;
-    };
-};
-export type FsAction = keyof FsActionMap;