@graphty/remote-logger 1.2.3 → 1.3.0

package/README.md

@@ -48,7 +48,32 @@ npx remote-log-server --port 9080
 remote-log-server --port 9080
 ```
 
-### 2. Add Client to Your Application
+### 2. Add Logging to Your Application
+
+#### Option A: Script Tag (Zero Install)
+
+The server serves a browser-ready script at `/remote-logger.js` that auto-configures itself:
+
+```html
+<script src="http://localhost:9080/remote-logger.js"></script>
+```
+
+Or paste in the browser console for quick debugging:
+
+```javascript
+var s=document.createElement('script');s.src='http://localhost:9080/remote-logger.js';document.head.appendChild(s);
+```
+
+The script automatically intercepts all `console.log/warn/error/info/debug` calls and forwards them to the server. It exposes `window.__remoteLogger__` for manual control:
+
+```javascript
+// Stop intercepting console
+window.__remoteLogger__.destroy();
+```
+
+Add `?ui=true` to the script URL to show a floating console capture widget.
+
+#### Option B: NPM Package
 
 ```typescript
 import { RemoteLogClient } from "@graphty/remote-logger";
@@ -91,6 +116,30 @@ Log levels are displayed with the following colors:
 | TRACE | Dim/gray |
 | LOG (default) | Green |
 
+## Debugging Third-Party Sites
+
+The server includes a reverse proxy that injects the remote logger into any website -- no install required on the target site.
+
+```
+http://localhost:9080/proxy/https://example.com
+```
+
+Point your browser (including iOS Safari) at the proxy URL. The proxy:
+- Fetches the target page and injects the remote-logger script into HTML responses (using parse5 for safe HTML manipulation)
+- Injects a `<base>` tag so relative URLs resolve through the proxy
+- Strips Content-Security-Policy headers that would block the injected script
+- Strips integrity attributes (SRI) from script/link tags
+- Rewrites Set-Cookie Domain/Secure attributes for HTTP proxy compatibility
+- Uses a custom TLS fingerprint to avoid CDN bot detection (Fastly, Akamai)
+- Passes non-HTML resources (CSS, JS, images) through unmodified
+
+**Limitations:**
+- Resources using absolute paths (e.g., `/fonts/...`, `/media/...`) bypass the `<base>` tag and return 404
+- JavaScript `fetch()` calls using absolute paths may bypass the proxy
+- OAuth redirect flows that check the origin domain will not work
+- WebSocket connections are not proxied
+- Sites with very aggressive bot detection may still block the proxy
+
 ## CLI Reference
 
 ```
@@ -216,6 +265,8 @@ const server = startLogServer({
 | Endpoint | Method | Description |
 |----------|--------|-------------|
 | `/log` | POST | Receive logs from client |
+| `/remote-logger.js` | GET | Browser-ready auto-config script |
+| `/proxy/<url>` | * | Reverse proxy with script injection |
 | `/logs` | GET | Get all logs by session |
 | `/logs/recent` | GET | Get recent logs (`?n=50&errors=true`) |
 | `/logs/errors` | GET | Get error-level logs only |

package/dist/bundle/browser-entry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Browser bundle entry point for the remote logger.
+ *
+ * When loaded as a script tag, this auto-initializes a RemoteLogClient
+ * that intercepts console methods and forwards them to the server.
+ *
+ * Server URL detection priority:
+ *   1. window.__REMOTE_LOG_SERVER_URL__ (injected by server when serving this file)
+ *   2. document.currentScript.src (parse origin from script tag URL)
+ *   3. window.location.origin (fallback)
+ *
+ * Exposes window.__remoteLogger__ for manual control.
+ * @module bundle/browser-entry
+ */
+import { RemoteLogClient } from "../client/RemoteLogClient.js";
+import { ConsoleCaptureUI } from "../ui/ConsoleCaptureUI.js";
+declare global {
+    interface Window {
+        __REMOTE_LOG_SERVER_URL__?: string;
+        __remoteLogger__?: RemoteLoggerGlobal;
+    }
+}
+export interface RemoteLoggerGlobal {
+    client: RemoteLogClient;
+    ui?: ConsoleCaptureUI;
+    destroy: () => void;
+}
+/**
+ * Initialize the remote logger, intercepting console methods.
+ * @returns The remote logger global object, or undefined if no server URL detected
+ */
+export declare function initRemoteLogger(): RemoteLoggerGlobal | undefined;
+export { ConsoleCaptureUI, RemoteLogClient };
+//# sourceMappingURL=browser-entry.d.ts.map

package/dist/bundle/browser-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-entry.d.ts","sourceRoot":"","sources":["../../src/bundle/browser-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;KACzC;CACJ;AAcD,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAoDD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,GAAG,SAAS,CAqDjE;AAMD,OAAO,EAAE,gBAAgB,EAAC,eAAe,EAAE,CAAC"}

package/dist/bundle/browser-entry.js

@@ -0,0 +1,129 @@
+/**
+ * Browser bundle entry point for the remote logger.
+ *
+ * When loaded as a script tag, this auto-initializes a RemoteLogClient
+ * that intercepts console methods and forwards them to the server.
+ *
+ * Server URL detection priority:
+ *   1. window.__REMOTE_LOG_SERVER_URL__ (injected by server when serving this file)
+ *   2. document.currentScript.src (parse origin from script tag URL)
+ *   3. window.location.origin (fallback)
+ *
+ * Exposes window.__remoteLogger__ for manual control.
+ * @module bundle/browser-entry
+ */
+import { RemoteLogClient } from "../client/RemoteLogClient.js";
+import { ConsoleCaptureUI } from "../ui/ConsoleCaptureUI.js";
+const CONSOLE_LEVEL_MAP = {
+    log: "LOG",
+    warn: "WARN",
+    error: "ERROR",
+    info: "INFO",
+    debug: "DEBUG",
+};
+const INTERCEPTED_METHODS = ["log", "warn", "error", "info", "debug"];
+function detectServerUrl() {
+    if (typeof window !== "undefined" && window.__REMOTE_LOG_SERVER_URL__) {
+        return window.__REMOTE_LOG_SERVER_URL__;
+    }
+    if (typeof document !== "undefined" && document.currentScript) {
+        try {
+            const scriptUrl = new URL(document.currentScript.src);
+            return scriptUrl.origin;
+        }
+        catch {
+            // Invalid URL, fall through
+        }
+    }
+    if (typeof window !== "undefined" && window.location) {
+        return window.location.origin;
+    }
+    return undefined;
+}
+function shouldShowUI() {
+    if (typeof document === "undefined" || !document.currentScript) {
+        return false;
+    }
+    try {
+        const { src } = document.currentScript;
+        if (!src) {
+            return false;
+        }
+        const params = new URL(src).searchParams;
+        return params.get("ui") === "true";
+    }
+    catch {
+        return false;
+    }
+}
+function formatArg(arg) {
+    if (typeof arg === "string") {
+        return arg;
+    }
+    if (arg instanceof Error) {
+        return `${arg.name}: ${arg.message}`;
+    }
+    try {
+        return JSON.stringify(arg);
+    }
+    catch {
+        return String(arg);
+    }
+}
+function formatArgs(args) {
+    return args.map(formatArg).join(" ");
+}
+/**
+ * Initialize the remote logger, intercepting console methods.
+ * @returns The remote logger global object, or undefined if no server URL detected
+ */
+export function initRemoteLogger() {
+    const serverUrl = detectServerUrl();
+    if (!serverUrl) {
+        console.warn("[RemoteLogger] Could not detect server URL. Set window.__REMOTE_LOG_SERVER_URL__ before loading.");
+        return undefined;
+    }
+    const client = new RemoteLogClient({
+        serverUrl,
+        sessionPrefix: "remote",
+        batchIntervalMs: 500,
+    });
+    const originalMethods = {};
+    for (const method of INTERCEPTED_METHODS) {
+        // eslint-disable-next-line no-console
+        originalMethods[method] = console[method];
+        // eslint-disable-next-line no-console
+        console[method] = (...args) => {
+            originalMethods[method].apply(console, args);
+            const message = formatArgs(args);
+            client.log(CONSOLE_LEVEL_MAP[method], message);
+        };
+    }
+    let ui;
+    if (shouldShowUI()) {
+        ui = new ConsoleCaptureUI();
+    }
+    const destroy = () => {
+        for (const method of INTERCEPTED_METHODS) {
+            // eslint-disable-next-line no-console
+            console[method] = originalMethods[method];
+        }
+        void client.close();
+        if (ui) {
+            ui.destroy();
+        }
+        if (typeof window !== "undefined") {
+            delete window.__remoteLogger__;
+        }
+    };
+    const global = { client, ui, destroy };
+    if (typeof window !== "undefined") {
+        window.__remoteLogger__ = global;
+    }
+    return global;
+}
+// Auto-initialize on load
+initRemoteLogger();
+// Re-export for manual use via the IIFE global
+export { ConsoleCaptureUI, RemoteLogClient };
+//# sourceMappingURL=browser-entry.js.map

package/dist/bundle/browser-entry.js.map

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

package/dist/mcp/mcp-server.d.ts

@@ -17,7 +17,7 @@ export declare function getToolNames(): string[];
  * Server instructions for LLMs describing the overall purpose and usage.
  * Exported for testing purposes.
  */
-export declare const SERVER_INSTRUCTIONS = "Remote Logger MCP Server - View console.log output from browser applications.\n\n## What is Remote Logging?\n\nBrowser applications run in a sandbox - their console.log() output appears in browser DevTools but is NOT visible to CLI tools or this assistant. Remote logging bridges this gap by sending browser logs to a server where they can be queried.\n\n## When to Use Remote Logging\n\nUse this when debugging applications where developer tools aren't easily accessible:\n- Storybook components (stories running in browser)\n- Web applications during development\n- Mobile web apps (phones, tablets) where DevTools requires USB debugging\n- VR/AR applications where you can't see a console while wearing a headset\n- Embedded devices, kiosks, or smart displays without keyboard access\n- Any JavaScript running in a browser context\n\nRemote logging is especially valuable for LLM assistants like this one - it enables reading, interpreting, and acting on application logs without requiring user interaction with browser DevTools.\n\n## Architecture\n\nBrowser App \u2192 HTTP POST to /log \u2192 Log Server (stores in memory + JSONL files) \u2192 MCP Tools (query logs)\n\n## Setting Up a Browser App to Send Logs\n\nFirst, get the server endpoint URL by calling logs_status - look for server.httpEndpoint in the response.\n\n### Option 1: Using the RemoteLogClient SDK (Recommended)\n\nInstall: npm install @graphty/remote-logger\n\n```typescript\nimport { RemoteLogClient } from \"@graphty/remote-logger\";\n\nconst logger = new RemoteLogClient({\n  serverUrl: \"http://localhost:9080\",  // Get this from logs_status (client appends /log)\n  projectMarker: \"my-project\",          // Optional: for filtering\n});\n\n// Intercept all console.log/warn/error calls\nlogger.interceptConsole();\n\n// Or log manually\nlogger.log(\"INFO\", \"Hello from browser!\");\n```\n\n### Option 2: Raw fetch() calls\n\n```typescript\nfetch(\"http://localhost:9080/log\", {\n  method: \"POST\",\n  headers: { \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({\n    sessionId: \"unique-session-id\",\n    logs: [\n      { time: new Date().toISOString(), level: \"INFO\", message: \"Hello!\" }\n    ]\n  })\n});\n```\n\n## Querying Logs (MCP Tools)\n\nOnce browser logs are flowing to the server:\n\n1. logs_status - Check server health, get endpoint URL, see retention settings\n2. logs_get_recent - View recent logs (primary tool, sorted chronologically)\n3. logs_get_errors - Quick filter for ERROR level only\n4. logs_search - Find specific text (supports regex)\n5. logs_list_sessions - See all browser sessions\n6. logs_get_all - Get all logs grouped by session\n7. logs_get_file_path - Get JSONL file path for Grep/Read tools\n8. logs_clear - Delete logs (requires confirmation)\n\n## Typical Debugging Workflow\n\n1. Call logs_status to verify server is running and get the endpoint URL\n2. Ensure the browser app is configured to send logs to that endpoint\n3. Trigger the action in the browser you want to debug\n4. Call logs_get_recent to see what happened\n5. Use logs_search if looking for specific errors or messages";
+export declare const SERVER_INSTRUCTIONS = "Remote Logger MCP Server - View console.log output from browser applications.\n\n## What is Remote Logging?\n\nBrowser applications run in a sandbox - their console.log() output appears in browser DevTools but is NOT visible to CLI tools or this assistant. Remote logging bridges this gap by sending browser logs to a server where they can be queried.\n\n## When to Use Remote Logging\n\nUse this when debugging applications where developer tools aren't easily accessible:\n- Storybook components (stories running in browser)\n- Web applications during development\n- Mobile web apps (phones, tablets) where DevTools requires USB debugging\n- VR/AR applications where you can't see a console while wearing a headset\n- Embedded devices, kiosks, or smart displays without keyboard access\n- Any JavaScript running in a browser context\n\nRemote logging is especially valuable for LLM assistants like this one - it enables reading, interpreting, and acting on application logs without requiring user interaction with browser DevTools.\n\n## Architecture\n\nBrowser App \u2192 HTTP POST to /log \u2192 Log Server (stores in memory + JSONL files) \u2192 MCP Tools (query logs)\n\n## Setting Up a Browser App to Send Logs\n\nFirst, get the server endpoint URL by calling logs_status - look for server.httpEndpoint in the response.\n\n### Option 1: Using the RemoteLogClient SDK (Recommended)\n\nInstall: npm install @graphty/remote-logger\n\n```typescript\nimport { RemoteLogClient } from \"@graphty/remote-logger\";\n\nconst logger = new RemoteLogClient({\n  serverUrl: \"http://localhost:9080\",  // Get this from logs_status (client appends /log)\n  projectMarker: \"my-project\",          // Optional: for filtering\n});\n\n// Intercept all console.log/warn/error calls\nlogger.interceptConsole();\n\n// Or log manually\nlogger.log(\"INFO\", \"Hello from browser!\");\n```\n\n### Option 2: Script tag (zero install)\n\nThe server serves a browser-ready script that auto-configures itself.\nGet the script URL from logs_status - look for server.scriptUrl in the response.\n\nAdd to HTML:\n```html\n<script src=\"http://localhost:9080/remote-logger.js\"></script>\n```\n\nOr paste in browser console:\n```javascript\nvar s=document.createElement('script');s.src='http://localhost:9080/remote-logger.js';document.head.appendChild(s);\n```\n\nThe script automatically:\n- Intercepts all console.log/warn/error/info/debug calls\n- Sends them to the server it was loaded from (zero config)\n- Exposes window.__remoteLogger__ for manual control (e.g., window.__remoteLogger__.destroy())\n\nAdd ?ui=true to the script URL to show a floating console capture widget.\n\n### Option 3: Raw fetch() calls\n\n```typescript\nfetch(\"http://localhost:9080/log\", {\n  method: \"POST\",\n  headers: { \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({\n    sessionId: \"unique-session-id\",\n    logs: [\n      { time: new Date().toISOString(), level: \"INFO\", message: \"Hello!\" }\n    ]\n  })\n});\n```\n\n## Debugging Third-Party Websites\n\nThe server includes a reverse proxy that injects the remote logger into any website.\nGet the proxy base URL from logs_status - look for server.proxyBaseUrl.\n\nTo debug a third-party site, prepend the proxy base URL to the target URL:\n  {proxyBaseUrl}https://example.com/page\n\nExample: http://192.168.1.x:9080/proxy/https://example.com\n\nThe proxy automatically:\n- Injects the remote-logger script into HTML responses\n- Strips Content-Security-Policy headers that would block the script\n- Forwards cookies, auth headers, and other request data\n- Passes non-HTML resources (CSS, JS, images) through unmodified\n\nLimitations:\n- Resources using absolute paths (e.g., /fonts/..., /media/...) bypass the base tag and return 404\n- JavaScript fetch() calls using absolute paths may bypass the proxy\n- OAuth redirect flows that check the origin domain will not work\n- WebSocket connections are not proxied (future enhancement)\n\n## Querying Logs (MCP Tools)\n\nOnce browser logs are flowing to the server:\n\n1. logs_status - Check server health, get endpoint URL, see retention settings\n2. logs_get_recent - View recent logs (primary tool, sorted chronologically)\n3. logs_get_errors - Quick filter for ERROR level only\n4. logs_search - Find specific text (supports regex)\n5. logs_list_sessions - See all browser sessions\n6. logs_get_all - Get all logs grouped by session\n7. logs_get_file_path - Get JSONL file path for Grep/Read tools\n8. logs_clear - Delete logs (requires confirmation)\n\n## Typical Debugging Workflow\n\n1. Call logs_status to verify server is running and get the endpoint URL, script URL, and proxy URL\n2. Add logging to the browser app using one of the options above (script tag is simplest)\n   - For third-party sites, use the proxy: navigate to {proxyBaseUrl}https://target-site.com\n3. Trigger the action in the browser you want to debug\n4. Call logs_get_recent to see what happened\n5. Use logs_search if looking for specific errors or messages";
 /**
  * Create an MCP server with logging tools.
  *

package/dist/mcp/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAyC3D;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,okGA+E8B,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAkM9D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAyC3D;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,86JA4H8B,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAkM9D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE"}

package/dist/mcp/mcp-server.js

@@ -67,7 +67,29 @@ logger.interceptConsole();
 logger.log("INFO", "Hello from browser!");
 \`\`\`
 
-### Option 2: Raw fetch() calls
+### Option 2: Script tag (zero install)
+
+The server serves a browser-ready script that auto-configures itself.
+Get the script URL from logs_status - look for server.scriptUrl in the response.
+
+Add to HTML:
+\`\`\`html
+<script src="http://localhost:9080/remote-logger.js"></script>
+\`\`\`
+
+Or paste in browser console:
+\`\`\`javascript
+var s=document.createElement('script');s.src='http://localhost:9080/remote-logger.js';document.head.appendChild(s);
+\`\`\`
+
+The script automatically:
+- Intercepts all console.log/warn/error/info/debug calls
+- Sends them to the server it was loaded from (zero config)
+- Exposes window.__remoteLogger__ for manual control (e.g., window.__remoteLogger__.destroy())
+
+Add ?ui=true to the script URL to show a floating console capture widget.
+
+### Option 3: Raw fetch() calls
 
 \`\`\`typescript
 fetch("http://localhost:9080/log", {
@@ -82,6 +104,28 @@ fetch("http://localhost:9080/log", {
 });
 \`\`\`
 
+## Debugging Third-Party Websites
+
+The server includes a reverse proxy that injects the remote logger into any website.
+Get the proxy base URL from logs_status - look for server.proxyBaseUrl.
+
+To debug a third-party site, prepend the proxy base URL to the target URL:
+  {proxyBaseUrl}https://example.com/page
+
+Example: http://192.168.1.x:9080/proxy/https://example.com
+
+The proxy automatically:
+- Injects the remote-logger script into HTML responses
+- Strips Content-Security-Policy headers that would block the script
+- Forwards cookies, auth headers, and other request data
+- Passes non-HTML resources (CSS, JS, images) through unmodified
+
+Limitations:
+- Resources using absolute paths (e.g., /fonts/..., /media/...) bypass the base tag and return 404
+- JavaScript fetch() calls using absolute paths may bypass the proxy
+- OAuth redirect flows that check the origin domain will not work
+- WebSocket connections are not proxied (future enhancement)
+
 ## Querying Logs (MCP Tools)
 
 Once browser logs are flowing to the server:
@@ -97,8 +141,9 @@ Once browser logs are flowing to the server:
 
 ## Typical Debugging Workflow
 
-1. Call logs_status to verify server is running and get the endpoint URL
-2. Ensure the browser app is configured to send logs to that endpoint
+1. Call logs_status to verify server is running and get the endpoint URL, script URL, and proxy URL
+2. Add logging to the browser app using one of the options above (script tag is simplest)
+   - For third-party sites, use the proxy: navigate to {proxyBaseUrl}https://target-site.com
 3. Trigger the action in the browser you want to debug
 4. Call logs_get_recent to see what happened
 5. Use logs_search if looking for specific errors or messages`;

package/dist/mcp/mcp-server.js.map

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

package/dist/mcp/tools/logs-receive.d.ts

@@ -23,14 +23,14 @@ export declare const logsReceiveInputSchema: z.ZodObject<{
         /** Additional structured data to attach to the log entry. */
         data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
+        time: string;
         level: string;
         message: string;
-        time: string;
         data?: Record<string, unknown> | undefined;
     }, {
+        time: string;
         level: string;
         message: string;
-        time: string;
         data?: Record<string, unknown> | undefined;
     }>, "many">;
     /** Project identifier for filtering. Derived from sessionId prefix if not provided. */
@@ -42,9 +42,9 @@ export declare const logsReceiveInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
     logs: {
+        time: string;
         level: string;
         message: string;
-        time: string;
         data?: Record<string, unknown> | undefined;
     }[];
     projectMarker?: string | undefined;
@@ -53,9 +53,9 @@ export declare const logsReceiveInputSchema: z.ZodObject<{
 }, {
     sessionId: string;
     logs: {
+        time: string;
         level: string;
         message: string;
-        time: string;
         data?: Record<string, unknown> | undefined;
     }[];
     projectMarker?: string | undefined;
@@ -107,14 +107,14 @@ export declare const logsReceiveTool: {
             /** Additional structured data to attach to the log entry. */
             data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
+            time: string;
             level: string;
             message: string;
-            time: string;
             data?: Record<string, unknown> | undefined;
         }, {
+            time: string;
             level: string;
             message: string;
-            time: string;
             data?: Record<string, unknown> | undefined;
         }>, "many">;
         /** Project identifier for filtering. Derived from sessionId prefix if not provided. */
@@ -126,9 +126,9 @@ export declare const logsReceiveTool: {
     }, "strip", z.ZodTypeAny, {
         sessionId: string;
         logs: {
+            time: string;
             level: string;
             message: string;
-            time: string;
             data?: Record<string, unknown> | undefined;
         }[];
         projectMarker?: string | undefined;
@@ -137,9 +137,9 @@ export declare const logsReceiveTool: {
     }, {
         sessionId: string;
         logs: {
+            time: string;
             level: string;
             message: string;
-            time: string;
             data?: Record<string, unknown> | undefined;
         }[];
         projectMarker?: string | undefined;

package/dist/mcp/tools/logs-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs-status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/logs-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,qBAAqB,gDAAe,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IAClD,+BAA+B;IAC/B,WAAW,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAU1B,CAAC"}
+{"version":3,"file":"logs-status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/logs-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,qBAAqB,gDAAe,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IAClD,+BAA+B;IAC/B,WAAW,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAa1B,CAAC"}

package/dist/mcp/tools/logs-status.js

@@ -36,9 +36,12 @@ export const logsStatusTool = {
     name: "logs_status",
     description: "Get the status of the remote log server. " +
         "Returns health metrics (uptime, session count, log count, memory usage), " +
-        "HTTP endpoint configuration (port, host, URL for browser clients), " +
+        "HTTP endpoint configuration (port, host, URL for browser clients, script URL for zero-config injection, " +
+        "proxy base URL for debugging third-party sites), " +
         "and retention settings (how long logs are kept before automatic cleanup). " +
         "Use this to verify the server is running, find the endpoint URL for configuring browser clients, " +
+        "get the script URL (server.scriptUrl) for injecting via a script tag, " +
+        "get the proxy URL (server.proxyBaseUrl) for debugging third-party sites, " +
         "or check server configuration.",
     inputSchema: logsStatusInputSchema,
 };

package/dist/mcp/tools/logs-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs-status.js","sourceRoot":"","sources":["../../../src/mcp/tools/logs-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAmBlD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,OAAO,CAAC,OAAO,CAAC;QACnB,GAAG,MAAM;QACT,WAAW,EAAE;YACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,GAAG,EAAE,QAAQ,CAAC,GAAG;SACpB;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,aAAa;IACnB,WAAW,EACP,2CAA2C;QAC3C,2EAA2E;QAC3E,qEAAqE;QACrE,4EAA4E;QAC5E,mGAAmG;QACnG,gCAAgC;IACpC,WAAW,EAAE,qBAAqB;CACrC,CAAC"}
+{"version":3,"file":"logs-status.js","sourceRoot":"","sources":["../../../src/mcp/tools/logs-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAmBlD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,OAAO,CAAC,OAAO,CAAC;QACnB,GAAG,MAAM;QACT,WAAW,EAAE;YACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,GAAG,EAAE,QAAQ,CAAC,GAAG;SACpB;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,aAAa;IACnB,WAAW,EACP,2CAA2C;QAC3C,2EAA2E;QAC3E,0GAA0G;QAC1G,mDAAmD;QACnD,4EAA4E;QAC5E,mGAAmG;QACnG,wEAAwE;QACxE,2EAA2E;QAC3E,gCAAgC;IACpC,WAAW,EAAE,qBAAqB;CACrC,CAAC"}