procsi 0.2.6

package/dist/shared/control-client.js

@@ -0,0 +1,272 @@
+import * as net from "node:net";
+const CONTROL_TIMEOUT_MS = 5000;
+/** Maximum buffer size per connection before disconnecting (1 MB). Shared by both client and server. */
+export const MAX_BUFFER_SIZE = 1024 * 1024;
+/**
+ * Runtime type guard for incoming control responses.
+ */
+function isControlResponse(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value["id"] === "string");
+}
+/**
+ * Recursively revive Buffer objects from JSON serialisation.
+ * JSON.stringify(Buffer) produces { type: 'Buffer', data: [...] }
+ * This converts them back to actual Buffer instances.
+ */
+export function reviveBuffers(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    // Check if this is a serialised Buffer
+    if (typeof obj === "object" &&
+        "type" in obj &&
+        "data" in obj &&
+        obj["type"] === "Buffer" &&
+        Array.isArray(obj["data"])) {
+        return Buffer.from(obj.data);
+    }
+    // Recurse into arrays
+    if (Array.isArray(obj)) {
+        return obj.map(reviveBuffers);
+    }
+    // Recurse into objects
+    if (typeof obj === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = reviveBuffers(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Client for communicating with the control server via Unix socket.
+ * Maintains a persistent connection and multiplexes requests by ID.
+ */
+export class ControlClient {
+    socketPath;
+    requestId = 0;
+    socket = null;
+    pending = new Map();
+    buffer = "";
+    connectPromise = null;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    /**
+     * Send a request to the control server and wait for response.
+     */
+    async request(method, params) {
+        const socket = await this.getSocket();
+        const id = String(++this.requestId);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error("Control request timed out"));
+            }, CONTROL_TIMEOUT_MS);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            const message = { id, method, params };
+            socket.write(JSON.stringify(message) + "\n");
+        });
+    }
+    /**
+     * Close the persistent socket and reject any pending requests.
+     */
+    close() {
+        if (this.socket) {
+            this.socket.end();
+            this.socket = null;
+        }
+        this.connectPromise = null;
+        this.buffer = "";
+        this.rejectAllPending(new Error("Client closed"));
+    }
+    /**
+     * Check if the daemon is running by sending a ping.
+     */
+    async ping() {
+        try {
+            await this.request("ping");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get daemon status.
+     */
+    async status() {
+        return this.request("status");
+    }
+    /**
+     * Register a new session.
+     */
+    async registerSession(label, pid) {
+        return this.request("registerSession", { label, pid });
+    }
+    /**
+     * List all active sessions.
+     */
+    async listSessions() {
+        return this.request("listSessions");
+    }
+    /**
+     * List captured requests (full data including bodies).
+     */
+    async listRequests(options) {
+        return this.request("listRequests", options);
+    }
+    /**
+     * List request summaries (excludes body/header data for performance).
+     */
+    async listRequestsSummary(options) {
+        return this.request("listRequestsSummary", options);
+    }
+    /**
+     * Get a specific request by ID.
+     */
+    async getRequest(id) {
+        return this.request("getRequest", { id });
+    }
+    /**
+     * Count requests.
+     */
+    async countRequests(options) {
+        return this.request("countRequests", options);
+    }
+    /**
+     * Search through request/response body content.
+     */
+    async searchBodies(options) {
+        return this.request("searchBodies", options);
+    }
+    /**
+     * Query JSON bodies using json_extract.
+     */
+    async queryJsonBodies(options) {
+        return this.request("queryJsonBodies", options);
+    }
+    /**
+     * Clear all requests.
+     */
+    async clearRequests() {
+        await this.request("clearRequests");
+    }
+    /**
+     * List loaded interceptors and their metadata.
+     */
+    async listInterceptors() {
+        return this.request("listInterceptors");
+    }
+    /**
+     * Reload interceptors from disk.
+     */
+    async reloadInterceptors() {
+        return this.request("reloadInterceptors");
+    }
+    /**
+     * Lazily connect, reuse existing socket, deduplicate concurrent connect attempts.
+     */
+    getSocket() {
+        if (this.socket && !this.socket.destroyed) {
+            return Promise.resolve(this.socket);
+        }
+        // Deduplicate concurrent connection attempts
+        if (this.connectPromise) {
+            return this.connectPromise;
+        }
+        this.connectPromise = new Promise((resolve, reject) => {
+            const socket = net.createConnection(this.socketPath);
+            socket.on("connect", () => {
+                this.socket = socket;
+                this.connectPromise = null;
+                this.buffer = "";
+                resolve(socket);
+            });
+            socket.on("data", (data) => {
+                this.handleData(data);
+            });
+            socket.on("error", (err) => {
+                // If we're still connecting, reject the connect promise
+                if (this.connectPromise) {
+                    this.connectPromise = null;
+                    reject(err);
+                }
+                this.handleDisconnect(err);
+            });
+            socket.on("close", () => {
+                this.handleDisconnect(new Error("Socket closed"));
+            });
+            socket.setTimeout(CONTROL_TIMEOUT_MS, () => {
+                if (this.connectPromise) {
+                    this.connectPromise = null;
+                    socket.destroy();
+                    reject(new Error("Control connection timed out"));
+                }
+            });
+        });
+        return this.connectPromise;
+    }
+    /**
+     * Parse newline-delimited responses and resolve/reject matching pending requests.
+     */
+    handleData(data) {
+        this.buffer += data.toString();
+        // Guard against unbounded buffer growth
+        if (this.buffer.length > MAX_BUFFER_SIZE) {
+            this.socket?.destroy();
+            this.handleDisconnect(new Error("Response buffer exceeded maximum size"));
+            return;
+        }
+        let newlineIndex;
+        while ((newlineIndex = this.buffer.indexOf("\n")) !== -1) {
+            const responseStr = this.buffer.slice(0, newlineIndex);
+            this.buffer = this.buffer.slice(newlineIndex + 1);
+            try {
+                const parsed = JSON.parse(responseStr);
+                if (!isControlResponse(parsed)) {
+                    continue;
+                }
+                const pending = this.pending.get(parsed.id);
+                if (!pending) {
+                    continue;
+                }
+                this.pending.delete(parsed.id);
+                clearTimeout(pending.timer);
+                if (parsed.error) {
+                    pending.reject(new Error(parsed.error.message));
+                }
+                else {
+                    pending.resolve(reviveBuffers(parsed.result));
+                }
+            }
+            catch {
+                // Skip malformed messages
+            }
+        }
+    }
+    /**
+     * Handle socket disconnection — null socket, reject all pending, next request reconnects.
+     */
+    handleDisconnect(err) {
+        this.socket = null;
+        this.connectPromise = null;
+        this.buffer = "";
+        this.rejectAllPending(err);
+    }
+    rejectAllPending(err) {
+        for (const [id, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.reject(err);
+            this.pending.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=control-client.js.map

package/dist/shared/control-client.js.map

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

package/dist/shared/daemon.d.ts

@@ -0,0 +1,33 @@
+import type { LogLevel } from "./logger.js";
+export interface StartDaemonOptions {
+    logLevel?: LogLevel;
+    autoRestart?: boolean;
+    onVersionMismatch?: (running: string, cli: string) => void;
+}
+/**
+ * Check if the daemon is running for a project.
+ */
+export declare function isDaemonRunning(projectRoot: string): Promise<boolean>;
+/**
+ * Get the version of the running daemon.
+ * Returns null if daemon is not running.
+ */
+export declare function getDaemonVersion(projectRoot: string): Promise<string | null>;
+/**
+ * Restart the daemon for a project.
+ * Returns the new proxy port.
+ */
+export declare function restartDaemon(projectRoot: string, logLevel?: LogLevel): Promise<number>;
+/**
+ * Start the daemon for a project.
+ * Returns the proxy port.
+ *
+ * When the daemon is already running and autoRestart is true (default),
+ * restarts the daemon if there is a version mismatch between CLI and daemon.
+ */
+export declare function startDaemon(projectRoot: string, options?: StartDaemonOptions | LogLevel): Promise<number>;
+/**
+ * Stop the daemon for a project.
+ */
+export declare function stopDaemon(projectRoot: string): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/shared/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/shared/daemon.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAe5C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB3E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBlF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,GACtC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAgDD;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBnE"}

package/dist/shared/daemon.js

@@ -0,0 +1,231 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { getProcsiPaths, readDaemonPid, isProcessRunning, ensureProcsiDir } from "./project.js";
+import { ControlClient } from "./control-client.js";
+import { getProcsiVersion } from "./version.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the path to the daemon entry point.
+ */
+function getDaemonPath() {
+    // This is relative to dist/shared/daemon.js
+    // The daemon entry point is at dist/daemon/index.js
+    return path.resolve(__dirname, "..", "daemon", "index.js");
+}
+/**
+ * Check if the daemon is running for a project.
+ */
+export async function isDaemonRunning(projectRoot) {
+    const paths = getProcsiPaths(projectRoot);
+    // Check PID file first
+    const pid = readDaemonPid(projectRoot);
+    if (!pid || !isProcessRunning(pid)) {
+        return false;
+    }
+    // Verify the daemon is actually responding
+    const client = new ControlClient(paths.controlSocketFile);
+    try {
+        return await client.ping();
+    }
+    finally {
+        client.close();
+    }
+}
+/**
+ * Get the version of the running daemon.
+ * Returns null if daemon is not running.
+ */
+export async function getDaemonVersion(projectRoot) {
+    if (!(await isDaemonRunning(projectRoot))) {
+        return null;
+    }
+    const paths = getProcsiPaths(projectRoot);
+    const client = new ControlClient(paths.controlSocketFile);
+    try {
+        const status = await client.status();
+        return status.version;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        client.close();
+    }
+}
+/**
+ * Restart the daemon for a project.
+ * Returns the new proxy port.
+ */
+export async function restartDaemon(projectRoot, logLevel = "warn") {
+    await stopDaemon(projectRoot);
+    return spawnDaemon(projectRoot, logLevel);
+}
+/**
+ * Start the daemon for a project.
+ * Returns the proxy port.
+ *
+ * When the daemon is already running and autoRestart is true (default),
+ * restarts the daemon if there is a version mismatch between CLI and daemon.
+ */
+export async function startDaemon(projectRoot, options) {
+    // Handle backward compatibility with old signature
+    const opts = typeof options === "string" ? { logLevel: options } : (options ?? {});
+    const { logLevel = "warn", autoRestart = true, onVersionMismatch } = opts;
+    // Check if already running
+    if (await isDaemonRunning(projectRoot)) {
+        const paths = getProcsiPaths(projectRoot);
+        // Check version
+        const daemonVersion = await getDaemonVersion(projectRoot);
+        const cliVersion = getProcsiVersion();
+        if (daemonVersion && daemonVersion !== cliVersion) {
+            // Version mismatch detected
+            if (onVersionMismatch) {
+                onVersionMismatch(daemonVersion, cliVersion);
+            }
+            if (autoRestart) {
+                return restartDaemon(projectRoot, logLevel);
+            }
+        }
+        const portContent = fs.readFileSync(paths.proxyPortFile, "utf-8").trim();
+        return parseInt(portContent, 10);
+    }
+    return spawnDaemon(projectRoot, logLevel);
+}
+/**
+ * Spawn a new daemon process.
+ * Internal function used by startDaemon and restartDaemon.
+ */
+async function spawnDaemon(projectRoot, logLevel) {
+    // Ensure .procsi directory exists
+    ensureProcsiDir(projectRoot);
+    const daemonPath = getDaemonPath();
+    const paths = getProcsiPaths(projectRoot);
+    // Spawn daemon as detached background process
+    // Clear the log file first so we only see errors from this attempt
+    const logFile = path.join(paths.procsiDir, "daemon.log");
+    fs.writeFileSync(logFile, "");
+    const out = fs.openSync(logFile, "a");
+    const err = fs.openSync(logFile, "a");
+    // The daemon is the proxy itself — it must not load its own preload script.
+    // Strip NODE_OPTIONS (which contains --require for the preload) and the
+    // guard variable so they don't leak into the child.
+    const { NODE_OPTIONS: _nodeOpts, PROCSI_ORIG_NODE_OPTIONS: _origNodeOpts, ...cleanEnv } = process.env;
+    const child = spawn("node", [daemonPath], {
+        env: {
+            ...cleanEnv,
+            PROJECT_ROOT: projectRoot,
+            PROCSI_LOG_LEVEL: logLevel,
+        },
+        detached: true,
+        stdio: ["ignore", out, err],
+    });
+    // Detach from parent process
+    child.unref();
+    // Wait for daemon to start and write port file
+    const port = await waitForDaemon(projectRoot, 10000);
+    return port;
+}
+/**
+ * Stop the daemon for a project.
+ */
+export async function stopDaemon(projectRoot) {
+    const pid = readDaemonPid(projectRoot);
+    if (!pid) {
+        return; // Already stopped
+    }
+    if (!isProcessRunning(pid)) {
+        // PID file exists but process is dead - clean up
+        const paths = getProcsiPaths(projectRoot);
+        cleanupDaemonFiles(paths);
+        return;
+    }
+    // Send SIGTERM to daemon
+    process.kill(pid, "SIGTERM");
+    // Wait for daemon to stop
+    await waitForDaemonStop(pid, 5000);
+    // Clean up any remaining files
+    const paths = getProcsiPaths(projectRoot);
+    cleanupDaemonFiles(paths);
+}
+/**
+ * Wait for the daemon to start and return the proxy port.
+ */
+async function waitForDaemon(projectRoot, timeoutMs) {
+    const paths = getProcsiPaths(projectRoot);
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        // Check if port file exists
+        if (fs.existsSync(paths.proxyPortFile)) {
+            const portContent = fs.readFileSync(paths.proxyPortFile, "utf-8").trim();
+            const port = parseInt(portContent, 10);
+            if (!isNaN(port)) {
+                // Verify daemon is responding
+                const client = new ControlClient(paths.controlSocketFile);
+                try {
+                    if (await client.ping()) {
+                        return port;
+                    }
+                }
+                finally {
+                    client.close();
+                }
+            }
+        }
+        // Wait a bit before checking again
+        await sleep(100);
+    }
+    // On timeout, check daemon.log for errors to surface to the user
+    const logPath = path.join(paths.procsiDir, "daemon.log");
+    let logTail = "";
+    if (fs.existsSync(logPath)) {
+        const content = fs.readFileSync(logPath, "utf-8");
+        const lines = content.trim().split("\n");
+        logTail = lines.slice(-20).join("\n"); // Last 20 lines
+    }
+    if (logTail) {
+        throw new Error(`Daemon failed to start. Log output:\n${logTail}`);
+    }
+    throw new Error("Daemon failed to start within timeout (no log output)");
+}
+/**
+ * Wait for daemon process to stop.
+ */
+async function waitForDaemonStop(pid, timeoutMs) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        if (!isProcessRunning(pid)) {
+            return;
+        }
+        await sleep(100);
+    }
+    // Force kill if still running
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // Process may have already exited
+    }
+}
+/**
+ * Clean up daemon files (socket, port file, pid file).
+ */
+function cleanupDaemonFiles(paths) {
+    const files = [paths.controlSocketFile, paths.proxyPortFile, paths.pidFile];
+    for (const file of files) {
+        if (fs.existsSync(file)) {
+            try {
+                fs.unlinkSync(file);
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=daemon.js.map

package/dist/shared/daemon.js.map

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

package/dist/shared/logger.d.ts

@@ -0,0 +1,47 @@
+export type LogLevel = "error" | "warn" | "info" | "debug" | "trace" | "silent";
+export type Component = "daemon" | "tui" | "cli" | "proxy" | "control" | "storage" | "interceptor";
+export interface LoggerOptions {
+    maxLogSize?: number;
+}
+export declare class Logger {
+    private component;
+    private logFile;
+    private level;
+    private stream;
+    private buffer;
+    private flushTimer;
+    private dirEnsured;
+    private maxLogSize;
+    constructor(component: Component, logFile: string, level?: LogLevel, options?: LoggerOptions);
+    error(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    debug(msg: string, data?: Record<string, unknown>): void;
+    trace(msg: string, data?: Record<string, unknown>): void;
+    /**
+     * Flush any buffered log lines and close the write stream.
+     * Uses synchronous write for the final flush to avoid losing entries.
+     */
+    close(): void;
+    private log;
+    private scheduleFlush;
+    private flush;
+    private ensureDir;
+    private ensureStream;
+    private shouldLog;
+    private rotateIfNeeded;
+}
+/**
+ * Create a logger for a specific component.
+ */
+export declare function createLogger(component: Component, projectRoot: string, level?: LogLevel, options?: LoggerOptions): Logger;
+/**
+ * Parse verbosity flag count to log level.
+ * 0 = warn (default), 1 = info, 2 = debug, 3+ = trace
+ */
+export declare function parseVerbosity(verboseCount: number): LogLevel;
+/**
+ * Check if a string is a valid log level.
+ */
+export declare function isValidLogLevel(level: string): level is LogLevel;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAChF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAyBnG,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,MAAM;IAQf,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IATf,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAGjB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,QAAiB,EAChC,OAAO,CAAC,EAAE,aAAa;IAKzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD;;;OAGG;IACH,KAAK,IAAI,IAAI;IA8Bb,OAAO,CAAC,GAAG;IAsBX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;CA+BvB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,QAAiB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAW7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAEhE"}