@pi-oxide/extension-js 0.12.3 → 0.13.0

package/main/index.d.ts

@@ -0,0 +1,8 @@
+import { ExtensionSession } from './session/extension-session.js';
+export type { CellResult as JsRunResult, WasmGlobalsSnapshot as JsGlobalsSnapshot, } from '../../pkg/extension_js.js';
+export type { LogLevel } from '../shared/main/logger.js';
+export { LOG_LEVEL_NUMERIC, setLogLevel } from '../shared/main/logger.js';
+export { registerHostHandler, registerHostHandlers, } from './runner/index.js';
+export { ExtensionSession } from './session/extension-session.js';
+/** Register a MessagePort for routing registry calls to an auxiliary worker context. */
+export declare function registerWorkerRelayPort(session: ExtensionSession, owner: string, port: MessagePort): void;

package/main/runner/chrome/internals.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { AsyncError, ToolDocParam } from '../../../shared/main/tool-registry.js';
+
+export { invokeNative, isNativeParityAction, type NativeArgs, normalizeParityArgs, requireArgumentArray, resolveChromeMethod, } from './native.js';
+export declare function normalizeChromeError(err: unknown): {
+    ok: false;
+    error: AsyncError;
+};
+export declare function registerChromePassthrough(action: string, _namespace: string, description: string, apiPath: string[], returnsSchema: z.ZodSchema<unknown>, errorCode: string, errorCategory: string | undefined, paramTypes?: ToolDocParam[], example?: string, returnType?: string): void;

package/main/runner/chrome/native.d.ts

@@ -0,0 +1,6 @@
+export type NativeArgs = readonly unknown[];
+export declare function isNativeParityAction(action: string): boolean;
+export declare function invokeNative(method: (...args: unknown[]) => unknown, args: NativeArgs): unknown;
+export declare function normalizeParityArgs(action: string, args: NativeArgs): NativeArgs;
+export declare function requireArgumentArray(value: unknown, action: string): NativeArgs;
+export declare function resolveChromeMethod(chromeRoot: unknown, apiPath: string[], methodName: string): (...args: unknown[]) => unknown;

package/main/runner/command.d.ts

@@ -0,0 +1,3 @@
+import { AsyncResponse, Command } from '../../shared/main/tool-registry.js';
+
+export declare function executeMainThreadCommand(command: Command, relaySignal?: AbortSignal): Promise<AsyncResponse>;

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

@@ -0,0 +1,8 @@
+import { AsyncResponse } from '../../../shared/main/tool-registry.js';
+import { DomFormatParams, DomSnapshotParams, DomSnapshotValue } from '../lib/types.js';
+
+export declare function ensureDomSnapshot(): Promise<void>;
+export declare function handleDomSnapshot(params: DomSnapshotParams): Promise<AsyncResponse<DomSnapshotValue>>;
+export declare function handleDomFormat(params: DomFormatParams): Promise<AsyncResponse<string>>;
+/** Local/test entry — production snapshots use the content-script path. */
+export declare function buildSnapshotInTab(maxNodesArg: unknown): import('../../../shared/cross/collect-inline-snapshot.js').InlineSnapshotResult;

package/main/runner/fetch.d.ts

@@ -0,0 +1,4 @@
+import { AsyncResponse } from '../../shared/main/tool-registry.js';
+import { FetchParams, FetchValue } from './lib/types.js';
+
+export declare function handleFetch(params: FetchParams): Promise<AsyncResponse<FetchValue>>;

package/main/runner/host.d.ts

@@ -0,0 +1,3 @@
+import { AsyncResponse } from '../../shared/main/tool-registry.js';
+
+export declare function handleHostCallAction(action: string, params: unknown): Promise<AsyncResponse>;

package/main/runner/index.d.ts

@@ -0,0 +1,2 @@
+export { type Command, setRunnerAbortController, } from '../../shared/main/tool-registry.js';
+export { executeMainThreadCommand, getActiveTabId, initExtensionListeners, isValidMainThreadAction, normalizeParams, registerHostHandler, registerHostHandlers, removeExtensionListeners, } from './runtime.js';

package/main/runner/lib/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_MAX_NODES = 500;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_SCROLL_AMOUNT = 300;
+export declare const DEFAULT_POLL_INTERVAL_MS = 100;
+export declare const RETRY_DELAY_MS = 500;
+export declare const INJECTION_DELAY_MS = 300;
+/** Brief pause after tabs.update so status can transition to loading. */
+export declare const NAVIGATION_SETTLE_MS = 100;
+/** Grace period after content-script ping before returning from page.goto. */
+export declare const CONTENT_SCRIPT_GRACE_MS = 500;
+/** Fast fail-fast ping before content-script mutations (health, relay). */
+export declare const CS_FAST_PING_MS = 500;
+/** Quiet period with no in-flight requests before declaring network idle. */
+export declare const NETWORK_IDLE_QUIET_MS = 500;

package/main/runner/lib/host-registry.d.ts

@@ -0,0 +1,6 @@
+import { HostHandler } from './types.js';
+
+export declare const hostHandlers: Record<string, HostHandler>;
+export declare function registerHostHandler<T, R>(action: string, handler: (params: T) => Promise<R>): void;
+export declare function registerHostHandlers(handlers: Record<string, HostHandler>): void;
+export declare function isValidMainThreadAction(action: string): boolean;

package/main/runner/lib/network-tracker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tracks in-flight network requests for a specific tab using chrome.webRequest.
+ * Observe-only (MV3 compatible) — no request blocking or modification.
+ */
+export declare class NetworkTracker {
+    private readonly tabId;
+    private inFlight;
+    private onBeforeRequest;
+    private onCompleted;
+    private onErrorOccurred;
+    constructor(tabId: number);
+    start(): void;
+    get pendingCount(): number;
+    waitForIdle(timeoutMs: number, traceId?: string): Promise<void>;
+    dispose(): void;
+}

package/main/runner/lib/params-helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function asRecord(params: unknown): Record<string, unknown>;
+export declare function extractTabId(params: unknown): number | null;

package/main/runner/lib/params.d.ts

@@ -0,0 +1,5 @@
+import { AsyncResponse } from '../../../shared/main/tool-registry.js';
+
+export { asRecord, extractTabId } from './params-helpers.js';
+export declare function normalizeParams(action: string, params: unknown): unknown;
+export declare function unwrapResult<T>(result: AsyncResponse<T>): T;

package/main/runner/lib/types.d.ts

@@ -0,0 +1,116 @@
+import { DomFormatParams, DomSnapshotParams, FetchParams, TreeSnapshot } from '../../../shared/cross/generated.js';
+
+export type { DomFormatParams, DomSnapshotParams, FetchParams };
+declare global {
+    interface Window {
+        __hostHandlers?: Record<string, HostHandler>;
+    }
+}
+export type HostHandler<T = unknown, R = unknown> = (params: T) => Promise<R>;
+export type FetchValue = {
+    status: number;
+    ok: boolean;
+    headers: Record<string, string>;
+    body: string;
+    bodyEncoding: "text" | "base64";
+    byteLength: number;
+    contentType: string;
+    finalUrl: string;
+};
+export type DomSnapshotValue = {
+    data: TreeSnapshot;
+    text: string;
+};
+export type TabMessage = {
+    action: "click";
+    params: {
+        refId?: string;
+        label?: string;
+    };
+} | {
+    action: "fill";
+    params: {
+        refId?: string;
+        value: string;
+        label?: string;
+    };
+} | {
+    action: "type";
+    params: {
+        refId?: string;
+        text: string;
+        label?: string;
+    };
+} | {
+    action: "append";
+    params: {
+        refId?: string;
+        text: string;
+        label?: string;
+    };
+} | {
+    action: "press";
+    params: {
+        key: string;
+    };
+} | {
+    action: "select";
+    params: {
+        refId: string;
+        value: string;
+    };
+} | {
+    action: "check";
+    params: {
+        refId: string;
+        checked: boolean;
+    };
+} | {
+    action: "hover";
+    params: {
+        refId: string;
+    };
+} | {
+    action: "unhover";
+    params: Record<string, never>;
+} | {
+    action: "scroll";
+    params: {
+        direction: string;
+        amount: number;
+    };
+} | {
+    action: "scrollTo";
+    params: {
+        x: number;
+        y: number;
+        refId?: string;
+    };
+} | {
+    action: "dblclick";
+    params: {
+        refId: string;
+    };
+} | {
+    action: "back";
+    params: Record<string, never>;
+} | {
+    action: "ping";
+    params?: Record<string, never>;
+};
+type CodedError = Error & {
+    code: string;
+    category?: string;
+    hint?: string;
+    recovery?: string[];
+    details?: Record<string, unknown>;
+};
+export declare function makeError(message: string, code: string, category?: string, extra?: Pick<CodedError, "hint" | "recovery" | "details">): CodedError;
+export declare function throwAgentError(error: {
+    message: string;
+    code: string;
+    category?: string;
+    hint?: string;
+    recovery?: string[];
+    details?: Record<string, unknown>;
+}): never;

package/main/runner/runtime.d.ts

@@ -0,0 +1,15 @@
+export { type Command, setRunnerAbortController, throwIfAborted, } from '../../shared/main/tool-registry.js';
+export { getActiveTabId, initExtensionListeners, removeExtensionListeners, resolveActiveTabId, } from '../tab-context.js';
+export { registerChromePassthrough } from './chrome/internals.js';
+export { invokeNative, isNativeParityAction, type NativeArgs, requireArgumentArray, resolveChromeMethod, } from './chrome/native.js';
+export { executeMainThreadCommand } from './command.js';
+export { buildSnapshotInTab, ensureDomSnapshot, handleDomFormat, handleDomSnapshot, } from './dom/snapshot.js';
+export { handleFetch } from './fetch.js';
+export { handleHostCallAction } from './host.js';
+export { CONTENT_SCRIPT_GRACE_MS, CS_FAST_PING_MS, DEFAULT_MAX_NODES, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SCROLL_AMOUNT, DEFAULT_TIMEOUT_MS, NAVIGATION_SETTLE_MS, NETWORK_IDLE_QUIET_MS, } from './lib/constants.js';
+export { isValidMainThreadAction, registerHostHandler, registerHostHandlers, } from './lib/host-registry.js';
+export { asRecord, extractTabId, normalizeParams, unwrapResult, } from './lib/params.js';
+export type { DomFormatParams, DomSnapshotParams, FetchParams, } from './lib/types.js';
+export { makeError, throwAgentError } from './lib/types.js';
+export { extractRefId, getElementByRefId } from './sidepanel/dom.js';
+export { pingTabContentScript, preflightDomTab, waitForTabLoad, } from './tab/execute.js';

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

@@ -0,0 +1,6 @@
+/**
+ * Find an element by its opaque reference ID.
+ * @param refId — opaque element ref in 'e{N}' format (e.g. 'e2'). Must match schema regex ^e\d+$.
+ */
+export declare function getElementByRefId(refId: string): Element | null;
+export declare function extractRefId(params: unknown): string | undefined;

package/main/runner/snapshot-merge.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '../../shared/cross/manifest.js';
+
+export declare function isSnapshotAction(action: string): boolean;
+/**
+ * Collect snapshots from every http(s) frame in the tab, merge them,
+ * and return the unified result. Pipeline: enumerate → collect → merge.
+ */
+export declare function executeMultiFrameSnapshot(cmd: Command, tabId: number, relayId?: string): Promise<unknown>;

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

@@ -0,0 +1,24 @@
+import { AsyncResponse } from '../../../shared/main/tool-registry.js';
+
+/** Fail fast when a tab URL cannot host content-script DOM APIs (non-http(s)). */
+export declare function preflightDomTab(tabId: number): Promise<AsyncResponse | null>;
+export declare function pingTabContentScript(tabId: number, timeoutMs?: number): Promise<AsyncResponse<{
+    ok: true;
+}>>;
+export type WaitForTabLoadOptions = {
+    /** Tab URL before navigation; used to detect blocked navigations, not for redirect matching. */
+    preNavigationUrl?: string;
+    /** When set, returns whether a loading event was observed before waitForTabLoad (e.g. listener registered pre-update). */
+    getNavSawLoading?: () => boolean;
+    /** trace-id for logging correlation with the originating run_js cell. */
+    runId?: string;
+    /**
+     * Grace window (ms) for heavy SPAs whose `load` event never fires. Once the
+     * tab has provably navigated (URL moved away from preNavigationUrl) but
+     * `complete` hasn't arrived, settle as loaded after this delay instead of
+     * waiting out the full timeout. Default 5000. Ignored when preNavigationUrl
+     * is unknown (can't prove navigation).
+     */
+    loadGraceMs?: number;
+};
+export declare function waitForTabLoad(tabId: number | null, timeoutMs?: number, options?: WaitForTabLoadOptions): Promise<AsyncResponse<boolean>>;

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

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

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

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

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

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

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

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

package/main/runner/tools/chrome/browsing-data.d.ts

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

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

@@ -0,0 +1,30 @@
+/**
+ * Initialize capability cache by reading chrome.permissions.getAll().
+ * Call once at extension startup.
+ */
+export declare function initCapabilities(): Promise<void>;
+/** Re-read chrome.permissions.getAll() and update the cache. */
+export declare function refreshCapabilities(): Promise<void>;
+/** Reset the capability cache to null (test helper). */
+export declare function resetCapabilities(): void;
+/**
+ * Manifest permission for a chrome API path, or null when no manifest permission is required.
+ */
+export declare function manifestPermissionForApiPath(apiPath: string[]): string | null;
+/**
+ * @deprecated Use manifestPermissionForApiPath
+ */
+export declare function permissionFromApiPath(apiPath: string[]): string | null;
+/**
+ * Manifest permission for a chrome_* action target.
+ * e.g. "chrome_notifications_create" → "notifications"
+ */
+export declare function permissionFromChromeAction(action: string): string | null;
+/**
+ * Whether a manifest permission is currently granted.
+ * - null permission → always true (namespace-only APIs)
+ * - non-null → cache-only; false when cache missing or permission absent
+ */
+export declare function hasPermission(permission: string | null): boolean;
+/** Throw E_PERMISSION if the manifest permission is required but not granted. */
+export declare function checkPermission(apiName: string, permission: string | null): void;

package/main/runner/tools/chrome/context-menus.d.ts

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

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

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

package/main/runner/tools/chrome/declarative-net-request.d.ts

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

package/main/runner/tools/chrome/desktop-capture.d.ts

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+

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

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

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

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

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

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

package/main/runner/tools/chrome/page-capture.d.ts

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

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

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

package/main/runner/tools/chrome/register-helpers.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export declare const zChromeAny: z.ZodUnknown;
+/** Chrome void APIs often resolve to undefined, null, or boolean (not strictly null). */
+export declare const zChromeVoid: z.ZodUnion<[z.ZodNull, z.ZodUndefined, z.ZodBoolean]>;
+/** @deprecated Use zChromeVoid */
+export declare const zChromeNull: z.ZodUnion<[z.ZodNull, z.ZodUndefined, z.ZodBoolean]>;
+/** Register a chrome.* passthrough from action name and API path segments. */
+export declare function regChrome(action: string, apiPath: string[], description: string, returnsSchema?: z.ZodSchema<unknown>, example?: string, returnType?: string): void;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,106 @@
+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

@@ -0,0 +1,12 @@
+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/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@pi-oxide/extension-js",
 	"type": "module",
-	"version": "0.12.3",
+	"version": "0.13.0",
 	"license": "LicenseRef-PiccoloNotebook-Fair-BYOK-1.0",
 	"main": "index.js",
 	"types": "index.d.ts",
@@ -12,7 +12,10 @@
 		"extension_js.js",
 		"extension_js.d.ts",
 		"content-script.js",
-		"*.d.ts"
+		"content-script/",
+		"main/",
+		"shared/",
+		"worker/"
 	],
 	"dependencies": {
 		"zod": "^3.23.8",

package/shared/array-buffer.d.ts

@@ -0,0 +1,4 @@
+/** 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;