ios-webkit-mcp 0.18.3

package/build/src/capability.js

@@ -0,0 +1,146 @@
+export class WipError extends Error {
+    code;
+    domain;
+    rawCode;
+    fallback;
+    constructor(code, message, opts) {
+        super(message);
+        this.name = 'WipError';
+        this.code = code;
+        this.domain = opts?.domain;
+        this.rawCode = opts?.rawCode;
+        this.fallback = opts?.fallback;
+    }
+    toStructured() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.domain !== undefined ? { domain: this.domain } : {}),
+            ...(this.rawCode !== undefined ? { rawCode: this.rawCode } : {}),
+            ...(this.fallback !== undefined ? { fallback: this.fallback } : {}),
+        };
+    }
+}
+/**
+ * Map a raw WIP error response (or thrown Error) to a WipError with code.
+ * `code === -32601` → METHOD_NOT_FOUND (or DOMAIN_UNAVAILABLE if message
+ * contains "domain was not found"). `-32602` → INVALID_PARAMS. Plain timeout
+ * messages from `WipSession.send` → TIMEOUT.
+ */
+export function classifyWipError(err, method) {
+    const msg = err instanceof Error ? err.message : String(err);
+    // Match patterns from WipSession.handleInner reject + connect/send timeout
+    // strings.
+    if (/Timeout \(\d+ms\)/.test(msg)) {
+        return new WipError('TIMEOUT', msg, { domain: domainOf(method) });
+    }
+    // WipSession threw the legacy "<method> failed: <wip-error.message>" format.
+    // Check for known sentinel substrings in the WIP-side message.
+    const domainMatch = msg.match(/'([A-Z][A-Za-z0-9]+)' domain was not found/);
+    if (domainMatch) {
+        return new WipError('DOMAIN_UNAVAILABLE', msg, { domain: domainMatch[1], rawCode: -32601 });
+    }
+    if (/'[^']+' was not found/.test(msg)) {
+        return new WipError('METHOD_NOT_FOUND', msg, { domain: domainOf(method), rawCode: -32601 });
+    }
+    if (/Invalid params|expected/i.test(msg)) {
+        return new WipError('INVALID_PARAMS', msg, { domain: domainOf(method), rawCode: -32602 });
+    }
+    if (/WipSession not connected|closed by peer/.test(msg)) {
+        return new WipError('TRANSPORT_ERROR', msg, { domain: domainOf(method) });
+    }
+    return new WipError('INTERNAL', msg, { domain: domainOf(method) });
+}
+function domainOf(method) {
+    const idx = method.indexOf('.');
+    return idx > 0 ? method.slice(0, idx) : undefined;
+}
+/**
+ * Sentinels for Schema-fallback domain probing. **Important constraint**: any
+ * method that *hangs* (no response within `timeoutMs`) blocks every concurrent
+ * tool call on the same ws — Apple WIP serializes per-target message
+ * processing. So sentinels MUST be methods that always reply quickly (success
+ * or `-32601 NOT_FOUND`), never methods known to hang.
+ *
+ * CSS.* is intentionally NOT a sentinel: `CSS.enable` hangs on iOS 26.5 (real
+ * receipt 2026-05-17). Detection of CSS unavailability happens via:
+ *   ① Schema.getDomains absence of "CSS" entry, OR
+ *   ② tool-level timeout when a CSS-dependent tool eventually ships.
+ *
+ * Currently empty — all batch-13 Must tools live in domains we already have
+ * positive matrix coverage for.
+ */
+const SENTINEL_PROBES = [];
+export async function probeCapabilities(session) {
+    const startedAt = Date.now();
+    const sentinels = {};
+    const notes = [];
+    let supportedDomains;
+    let schemaProbeSucceeded = false;
+    // Step 1: Schema.getDomains.
+    try {
+        const result = await session.send('Schema.getDomains', undefined, 3_000);
+        if (Array.isArray(result?.domains)) {
+            supportedDomains = new Set(result.domains
+                .map(d => (typeof d?.domain === 'string' ? d.domain : ''))
+                .filter(Boolean));
+            schemaProbeSucceeded = true;
+            notes.push(`Schema.getDomains → ${supportedDomains.size} domains`);
+        }
+        else {
+            notes.push(`Schema.getDomains returned no domains[] array`);
+        }
+    }
+    catch (e) {
+        const err = classifyWipError(e, 'Schema.getDomains');
+        notes.push(`Schema.getDomains ${err.code}: ${err.message.slice(0, 80)}`);
+    }
+    // Step 2: Sentinel probes — currently CSS only.
+    await Promise.all(SENTINEL_PROBES.map(async ({ domain, method, params, timeoutMs }) => {
+        try {
+            await session.send(method, params, timeoutMs);
+            sentinels[domain] = 'ok';
+        }
+        catch (e) {
+            const err = classifyWipError(e, method);
+            if (err.code === 'TIMEOUT')
+                sentinels[domain] = 'timeout';
+            else if (err.code === 'DOMAIN_UNAVAILABLE' || err.code === 'METHOD_NOT_FOUND')
+                sentinels[domain] = 'not-found';
+            else if (err.code === 'INVALID_PARAMS')
+                sentinels[domain] = 'invalid-params';
+            else
+                sentinels[domain] = 'error';
+        }
+    }));
+    // Step 3: Cross-check Schema vs sentinels — capture "claimed but hung" cases.
+    for (const { domain } of SENTINEL_PROBES) {
+        const sentinel = sentinels[domain];
+        if (sentinel === 'timeout' && supportedDomains?.has(domain)) {
+            notes.push(`⚠ ${domain} domain reported by Schema but ${domain}.* hung — likely WebKit fork omits implementation. Treating as unavailable.`);
+            supportedDomains.delete(domain);
+        }
+    }
+    return {
+        probedAt: new Date(startedAt).toISOString(),
+        probeDurationMs: Date.now() - startedAt,
+        supportedDomains,
+        schemaProbeSucceeded,
+        sentinels,
+        notes,
+    };
+}
+/**
+ * Convenience: throw a structured WipError if the snapshot tells us the
+ * required domain is unavailable. No-op if `supportedDomains` is undefined
+ * (Schema probe failed → assume optimistic).
+ */
+export function assertDomainAvailable(snap, domain) {
+    if (!snap || !snap.supportedDomains)
+        return; // optimistic when discovery failed
+    if (!snap.supportedDomains.has(domain)) {
+        throw new WipError('DOMAIN_UNAVAILABLE', `${domain} domain is not supported on this WebKit build. ` +
+            `Schema.getDomains did not list it (probedAt=${snap.probedAt}).`, { domain, fallback: undefined });
+    }
+}
+//# sourceMappingURL=capability.js.map

package/build/src/capability.js.map

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

package/build/src/index.d.ts

@@ -0,0 +1 @@
+export { createServer } from './server.js';

package/build/src/index.js

@@ -0,0 +1,2 @@
+export { createServer } from './server.js';
+//# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/build/src/page-session.d.ts

@@ -0,0 +1,108 @@
+import { WipSession } from './wip-client/ws-session.js';
+import { type CapabilitySnapshot } from './capability.js';
+export interface ConsoleEntry {
+    source: 'Console.messageAdded' | 'Runtime.exceptionThrown';
+    level: string;
+    text: string;
+    url?: string;
+    line?: number;
+    column?: number;
+    timestamp?: number;
+    args?: unknown[];
+    stackTrace?: unknown;
+    raw: unknown;
+}
+export interface NetworkEntry {
+    requestId: string;
+    url: string;
+    method?: string;
+    status?: number;
+    statusText?: string;
+    mimeType?: string;
+    type?: string;
+    initiatorType?: string;
+    startedAt?: number;
+    endedAt?: number;
+    encodedDataLength?: number;
+    errorText?: string;
+    state: 'pending' | 'response-received' | 'finished' | 'failed';
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    postData?: string;
+}
+/**
+ * batch-14 frozen contract for `Network.requestIntercepted` (cross-review v2.0.1):
+ *  - 30s auto-continue if not consumed
+ *  - 16 max concurrent pending; oldest auto-continued when overflow
+ *  - explicit `abort=true` for block; default = continue
+ */
+export interface InterceptedRequest {
+    requestId: string;
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    postData?: string;
+    stage?: string;
+    arrivedAt: number;
+    autoContinueTimer?: ReturnType<typeof setTimeout>;
+}
+export declare const INTERCEPT_AUTO_CONTINUE_MS = 30000;
+export declare const INTERCEPT_MAX_PENDING = 16;
+export interface AttachInfo {
+    deviceId: string;
+    deviceOSVersion?: string;
+    pageId: string;
+    pageTitle: string;
+    pageUrl: string;
+    webSocketDebuggerUrl: string;
+    targetId?: string;
+    attachedAt: number;
+}
+export declare class PageSession {
+    private static cached;
+    static get(opts?: {
+        proxyDeviceListUrl?: string;
+        bufferCap?: number;
+        pageId?: string;
+    }): Promise<PageSession>;
+    static reset(): void;
+    readonly session: WipSession;
+    readonly consoleBuffer: ConsoleEntry[];
+    readonly networkBuffer: NetworkEntry[];
+    readonly networkById: Map<string, NetworkEntry>;
+    readonly intercepted: Map<string, InterceptedRequest>;
+    attachInfo: AttachInfo | undefined;
+    enableErrors: Array<{
+        method: string;
+        error: string;
+    }>;
+    private alive;
+    private readonly cap;
+    private capabilityPromise;
+    private capabilitySnapshot;
+    private constructor();
+    isAlive(): boolean;
+    close(): void;
+    private init;
+    /**
+     * Returns the capability snapshot synchronously if the background probe has
+     * completed, else `undefined`. Tools that want to fail fast should call
+     * `await pageSession.capability()` instead.
+     */
+    capabilitySync(): CapabilitySnapshot | undefined;
+    /** Awaits capability probe completion. Resolves immediately if already done. */
+    capability(): Promise<CapabilitySnapshot>;
+    private push;
+    private recordConsoleMessageAdded;
+    private recordRuntimeException;
+    private upsertNetwork;
+    private recordNetworkRequestWillBeSent;
+    private recordNetworkResponseReceived;
+    private recordNetworkLoadingFinished;
+    private recordNetworkLoadingFailed;
+    private recordRequestIntercepted;
+    /** Drain an intercepted request's bookkeeping. Called when a tool consumes
+     *  the request via continue/respond — clears auto-continue timer and removes
+     *  from the pending map. Returns the entry if it existed. */
+    consumeIntercepted(requestId: string): InterceptedRequest | undefined;
+}

package/build/src/page-session.js

@@ -0,0 +1,331 @@
+/**
+ * Singleton-ish persistent WIP page session shared by stream-based tools
+ * (list_console_messages / list_network_requests / take_snapshot).
+ *
+ * Lifecycle:
+ *   - Lazy: created on first PageSession.get() call.
+ *   - Picks the first WKWebView page (filters out JSCore workers).
+ *   - Enables Console + Network + Runtime + DOM domains (each `enable` is
+ *     try-best-effort; failures are logged but don't abort).
+ *   - Subscribes Console.messageAdded / Runtime.exceptionThrown /
+ *     Network.requestWillBeSent / responseReceived / loadingFailed and
+ *     fills rolling buffers (default cap 200 each).
+ *   - On ws close / target destroyed, marks itself stale; next get() rebuilds.
+ *
+ * Each tool calls `await PageSession.get()` then queries buffers or calls
+ * the underlying `session.send(...)` for one-shot RPCs.
+ */
+import { fetchProxyDevices, fetchDevicePages } from './wip-client/iwdp-http.js';
+import { WipSession } from './wip-client/ws-session.js';
+import { probeCapabilities } from './capability.js';
+const DEFAULT_PROXY_BASE = 'http://127.0.0.1:9221';
+const DEFAULT_BUFFER_CAP = 200;
+export const INTERCEPT_AUTO_CONTINUE_MS = 30_000;
+export const INTERCEPT_MAX_PENDING = 16;
+export class PageSession {
+    static cached;
+    static async get(opts) {
+        if (PageSession.cached && PageSession.cached.alive) {
+            if (opts?.pageId && PageSession.cached.attachInfo?.pageId !== opts.pageId) {
+                PageSession.cached.close();
+                PageSession.cached = undefined;
+            }
+            else {
+                return PageSession.cached;
+            }
+        }
+        if (PageSession.cached) {
+            PageSession.cached.close();
+        }
+        const ps = new PageSession(opts?.bufferCap ?? DEFAULT_BUFFER_CAP);
+        await ps.init(opts?.proxyDeviceListUrl ?? DEFAULT_PROXY_BASE, opts?.pageId);
+        PageSession.cached = ps;
+        return ps;
+    }
+    static reset() {
+        if (PageSession.cached) {
+            PageSession.cached.close();
+            PageSession.cached = undefined;
+        }
+    }
+    session = new WipSession();
+    consoleBuffer = [];
+    networkBuffer = [];
+    networkById = new Map();
+    intercepted = new Map();
+    attachInfo;
+    enableErrors = [];
+    alive = false;
+    cap;
+    capabilityPromise;
+    capabilitySnapshot;
+    constructor(bufferCap) {
+        this.cap = bufferCap;
+    }
+    isAlive() {
+        return this.alive;
+    }
+    close() {
+        this.alive = false;
+        this.session.close();
+    }
+    async init(proxyBase, pageId) {
+        // 1. Pick the requested pageId, else first non-worker WKWebView page across devices.
+        const devices = await fetchProxyDevices(proxyBase);
+        if (devices.length === 0) {
+            throw new Error('No iOS devices found via ios_webkit_debug_proxy. Connect iPhone, enable Web Inspector, ensure proxy is running.');
+        }
+        let chosenDev;
+        let chosenPage;
+        for (const dev of devices) {
+            const pages = await fetchDevicePages(dev.url);
+            let page;
+            if (pageId) {
+                page = pages.find(p => p.id === pageId);
+            }
+            else {
+                page = pages.find(p => p.url && !p.title.startsWith('jsi_'));
+            }
+            if (page) {
+                chosenDev = dev;
+                chosenPage = page;
+                break;
+            }
+        }
+        if (!chosenDev || !chosenPage) {
+            throw new Error(pageId
+                ? `pageId ${JSON.stringify(pageId)} not found on any device. Run \`list_pages\` to enumerate.`
+                : 'No inspectable WKWebView page found. Open a WebView page in the target app first (see `list_pages`).');
+        }
+        // 2. Connect + wait for page target.
+        await this.session.connect(chosenPage.webSocketDebuggerUrl);
+        const target = await this.session.waitForPageTarget();
+        // 3. Wire event subscribers BEFORE enabling, so the first event isn't lost.
+        this.session.on('Console.messageAdded', params => this.recordConsoleMessageAdded(params));
+        this.session.on('Runtime.exceptionThrown', params => this.recordRuntimeException(params));
+        this.session.on('Network.requestWillBeSent', params => this.recordNetworkRequestWillBeSent(params));
+        this.session.on('Network.responseReceived', params => this.recordNetworkResponseReceived(params));
+        this.session.on('Network.loadingFinished', params => this.recordNetworkLoadingFinished(params));
+        this.session.on('Network.loadingFailed', params => this.recordNetworkLoadingFailed(params));
+        this.session.on('Network.requestIntercepted', params => this.recordRequestIntercepted(params));
+        // 4. Enable domains best-effort. WIP support varies — collect failures, don't abort.
+        for (const m of ['Console.enable', 'Network.enable', 'Runtime.enable', 'DOM.enable']) {
+            try {
+                await this.session.send(m, undefined, 5_000);
+            }
+            catch (e) {
+                this.enableErrors.push({ method: m, error: e instanceof Error ? e.message : String(e) });
+            }
+        }
+        this.attachInfo = {
+            deviceId: chosenDev.deviceId,
+            deviceOSVersion: chosenDev.deviceOSVersion,
+            pageId: chosenPage.id,
+            pageTitle: chosenPage.title,
+            pageUrl: chosenPage.url,
+            webSocketDebuggerUrl: chosenPage.webSocketDebuggerUrl,
+            targetId: target.targetId,
+            attachedAt: Date.now(),
+        };
+        this.alive = true;
+        // 5. Async fire-and-forget capability probe. Tools may consult `capability()`
+        //    to fail-fast with DOMAIN_UNAVAILABLE before issuing doomed RPCs.
+        //    NOTE: Sentinels that *hang* (e.g. CSS.* on iOS 26.5) are NOT included
+        //    in probeCapabilities — Apple WIP serializes per-target responses, so a
+        //    hanging probe blocks every concurrent tool call on the shared ws.
+        //    Instead, we rely on Schema.getDomains where available + tool-level
+        //    timeout fallback for unknown WebKit builds.
+        this.capabilityPromise = probeCapabilities(this.session)
+            .then(snap => {
+            this.capabilitySnapshot = snap;
+            return snap;
+        })
+            .catch(e => {
+            // Probe itself failed (rare). Synthesize an "unknown" snapshot so
+            // capability() resolves rather than hanging future awaiters.
+            const fallback = {
+                probedAt: new Date().toISOString(),
+                probeDurationMs: 0,
+                supportedDomains: undefined,
+                schemaProbeSucceeded: false,
+                sentinels: {},
+                notes: [`probe rejected: ${e instanceof Error ? e.message : String(e)}`],
+            };
+            this.capabilitySnapshot = fallback;
+            return fallback;
+        });
+    }
+    /**
+     * Returns the capability snapshot synchronously if the background probe has
+     * completed, else `undefined`. Tools that want to fail fast should call
+     * `await pageSession.capability()` instead.
+     */
+    capabilitySync() {
+        return this.capabilitySnapshot;
+    }
+    /** Awaits capability probe completion. Resolves immediately if already done. */
+    async capability() {
+        if (this.capabilitySnapshot)
+            return this.capabilitySnapshot;
+        if (this.capabilityPromise)
+            return this.capabilityPromise;
+        throw new Error('PageSession.capability() called before init() — should be unreachable');
+    }
+    push(buf, entry) {
+        buf.push(entry);
+        if (buf.length > this.cap) {
+            buf.splice(0, buf.length - this.cap);
+        }
+    }
+    recordConsoleMessageAdded(p) {
+        const params = p?.message;
+        if (!params || typeof params !== 'object')
+            return;
+        const msg = params;
+        this.push(this.consoleBuffer, {
+            source: 'Console.messageAdded',
+            level: String(msg.level ?? 'log'),
+            text: String(msg.text ?? ''),
+            url: typeof msg.url === 'string' ? msg.url : undefined,
+            line: typeof msg.line === 'number' ? msg.line : undefined,
+            column: typeof msg.column === 'number' ? msg.column : undefined,
+            timestamp: typeof msg.timestamp === 'number' ? msg.timestamp : undefined,
+            args: Array.isArray(msg.parameters) ? msg.parameters : undefined,
+            stackTrace: msg.stackTrace,
+            raw: msg,
+        });
+    }
+    recordRuntimeException(p) {
+        const params = p;
+        if (!params)
+            return;
+        const details = params.exceptionDetails;
+        this.push(this.consoleBuffer, {
+            source: 'Runtime.exceptionThrown',
+            level: 'error',
+            text: String(details?.text ?? details?.exception ?? 'Uncaught exception'),
+            url: typeof details?.url === 'string' ? details.url : undefined,
+            line: typeof details?.lineNumber === 'number' ? details.lineNumber : undefined,
+            column: typeof details?.columnNumber === 'number' ? details.columnNumber : undefined,
+            timestamp: typeof params.timestamp === 'number' ? params.timestamp : undefined,
+            stackTrace: details?.stackTrace,
+            raw: params,
+        });
+    }
+    upsertNetwork(requestId, mutator) {
+        let entry = this.networkById.get(requestId);
+        if (!entry) {
+            entry = { requestId, url: '', state: 'pending' };
+            this.networkById.set(requestId, entry);
+            this.push(this.networkBuffer, entry);
+        }
+        mutator(entry);
+    }
+    recordNetworkRequestWillBeSent(p) {
+        const params = p;
+        if (!params || typeof params.requestId !== 'string')
+            return;
+        const req = params.request;
+        this.upsertNetwork(params.requestId, e => {
+            e.url = typeof req?.url === 'string' ? req.url : e.url;
+            e.method = typeof req?.method === 'string' ? req.method : e.method;
+            e.type = typeof params.type === 'string' ? params.type : e.type;
+            const initiator = params.initiator;
+            e.initiatorType = typeof initiator?.type === 'string' ? initiator.type : e.initiatorType;
+            e.startedAt = typeof params.timestamp === 'number' ? params.timestamp : e.startedAt;
+            const headers = req?.headers;
+            if (headers && typeof headers === 'object') {
+                e.requestHeaders = headers;
+            }
+            const postData = req?.postData;
+            if (typeof postData === 'string')
+                e.postData = postData;
+        });
+    }
+    recordNetworkResponseReceived(p) {
+        const params = p;
+        if (!params || typeof params.requestId !== 'string')
+            return;
+        const res = params.response;
+        this.upsertNetwork(params.requestId, e => {
+            e.state = 'response-received';
+            e.status = typeof res?.status === 'number' ? res.status : e.status;
+            e.statusText = typeof res?.statusText === 'string' ? res.statusText : e.statusText;
+            e.mimeType = typeof res?.mimeType === 'string' ? res.mimeType : e.mimeType;
+            e.type = typeof params.type === 'string' ? params.type : e.type;
+            const headers = res?.headers;
+            if (headers && typeof headers === 'object') {
+                e.responseHeaders = headers;
+            }
+        });
+    }
+    recordNetworkLoadingFinished(p) {
+        const params = p;
+        if (!params || typeof params.requestId !== 'string')
+            return;
+        this.upsertNetwork(params.requestId, e => {
+            e.state = 'finished';
+            e.endedAt = typeof params.timestamp === 'number' ? params.timestamp : e.endedAt;
+            e.encodedDataLength = typeof params.encodedDataLength === 'number' ? params.encodedDataLength : e.encodedDataLength;
+        });
+    }
+    recordNetworkLoadingFailed(p) {
+        const params = p;
+        if (!params || typeof params.requestId !== 'string')
+            return;
+        this.upsertNetwork(params.requestId, e => {
+            e.state = 'failed';
+            e.errorText = typeof params.errorText === 'string' ? params.errorText : e.errorText;
+            e.endedAt = typeof params.timestamp === 'number' ? params.timestamp : e.endedAt;
+        });
+    }
+    recordRequestIntercepted(p) {
+        const params = p;
+        if (!params || typeof params.requestId !== 'string')
+            return;
+        const requestId = params.requestId;
+        const req = params.request;
+        const entry = {
+            requestId,
+            url: typeof req?.url === 'string' ? req.url : '',
+            method: typeof req?.method === 'string' ? req.method : undefined,
+            headers: req?.headers && typeof req.headers === 'object' ? req.headers : undefined,
+            postData: typeof req?.postData === 'string' ? req.postData : undefined,
+            stage: typeof params.stage === 'string' ? params.stage : undefined,
+            arrivedAt: Date.now(),
+        };
+        // Enforce 16-pending cap: oldest is auto-continued and dropped.
+        if (this.intercepted.size >= INTERCEPT_MAX_PENDING) {
+            const oldest = this.intercepted.entries().next().value;
+            if (oldest) {
+                const [oldestId, oldestEntry] = oldest;
+                if (oldestEntry.autoContinueTimer)
+                    clearTimeout(oldestEntry.autoContinueTimer);
+                this.intercepted.delete(oldestId);
+                // Best-effort auto-continue.
+                this.session.send('Network.interceptContinue', { requestId: oldestId }, 5_000).catch(() => { });
+            }
+        }
+        // 30s auto-continue if not consumed by tool.
+        entry.autoContinueTimer = setTimeout(() => {
+            if (this.intercepted.has(requestId)) {
+                this.intercepted.delete(requestId);
+                this.session.send('Network.interceptContinue', { requestId }, 5_000).catch(() => { });
+            }
+        }, INTERCEPT_AUTO_CONTINUE_MS);
+        this.intercepted.set(requestId, entry);
+    }
+    /** Drain an intercepted request's bookkeeping. Called when a tool consumes
+     *  the request via continue/respond — clears auto-continue timer and removes
+     *  from the pending map. Returns the entry if it existed. */
+    consumeIntercepted(requestId) {
+        const entry = this.intercepted.get(requestId);
+        if (!entry)
+            return undefined;
+        if (entry.autoContinueTimer)
+            clearTimeout(entry.autoContinueTimer);
+        this.intercepted.delete(requestId);
+        return entry;
+    }
+}
+//# sourceMappingURL=page-session.js.map

package/build/src/page-session.js.map

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

package/build/src/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Parse `WDM_DISABLE_TOOLS` env var (comma-separated tool name list) — runtime
+ * kill switch for individual tools, per spec batch-13 DoD §"回滚开关".
+ *
+ *   WDM_DISABLE_TOOLS=set_init_script,record_timeline node …
+ *
+ * Exported for tests; underscore prefix signals "internal but reachable".
+ */
+export declare function _parseDisabledTools(value?: string | undefined): Set<string>;
+export declare function createServer(): McpServer;