Chrome DevTools for coding agents
feat: add an error logging method (#2006)
yulunz06e0ab602258
diff --git a/src/telemetry/ClearcutLogger.ts b/src/telemetry/ClearcutLogger.tsindex 6d9d6499..25704ead 100644--- a/src/telemetry/ClearcutLogger.ts+++ b/src/telemetry/ClearcutLogger.ts@@ -10,6 +10,7 @@ import {DAEMON_CLIENT_NAME} from '../daemon/utils.js';import {logger} from '../logger.js';import type {zod, ShapeOutput} from '../third_party/index.js';+import type {ErrorCode} from './errors.js';import type {LocalState, Persistence} from './persistence.js';import {FilePersistence} from './persistence.js';import {@@ -310,6 +311,22 @@ export class ClearcutLogger {}}+ async logServerError(args: {+ toolName?: string;+ errorCode: ErrorCode;+ }): Promise<void> {+ this.#watchdog.send({+ type: WatchdogMessageType.LOG_EVENT,+ payload: {+ mcp_client: this.#mcpClient,+ server_error: {+ tool_name: args.toolName ?? '',+ error_code: args.errorCode,+ },+ },+ });+ }+#shouldLogDailyActive(state: LocalState): boolean {if (!state.lastActive) {return true;diff --git a/src/telemetry/errors.ts b/src/telemetry/errors.tsnew file mode 100644index 00000000..e318fe08--- /dev/null+++ b/src/telemetry/errors.ts@@ -0,0 +1,13 @@+/**+ * @license+ * Copyright 2026 Google LLC+ * SPDX-License-Identifier: Apache-2.0+ *+ * IMPORTANT:+ * 1. this module must only contain ErrorCode.+ * 2. do not refactor ErrorCode to elsewhere.+ */++export enum ErrorCode {+ ERROR_CODE_UNSPECIFIED = 0,+}diff --git a/src/telemetry/types.ts b/src/telemetry/types.tsindex 0b00ef2d..0f941335 100644--- a/src/telemetry/types.ts+++ b/src/telemetry/types.ts@@ -4,6 +4,8 @@* SPDX-License-Identifier: Apache-2.0*/+import type {ErrorCode} from './errors.js';+// Protobuf message interfacesexport interface ChromeDevToolsMcpExtension {os_type?: OsType;@@ -14,6 +16,12 @@ export interface ChromeDevToolsMcpExtension {server_start?: ServerStart;daily_active?: DailyActive;server_shutdown?: ServerShutdown;+ server_error?: ServerError;+}++export interface ServerError {+ tool_name?: string;+ error_code: ErrorCode;}export type ServerShutdown = Record<string, never>;diff --git a/tests/telemetry/ClearcutLogger.test.ts b/tests/telemetry/ClearcutLogger.test.tsindex e88c0401..cab0f447 100644--- a/tests/telemetry/ClearcutLogger.test.ts+++ b/tests/telemetry/ClearcutLogger.test.ts@@ -14,9 +14,10 @@ import {ClearcutLogger,sanitizeParams,} from '../../src/telemetry/ClearcutLogger.js';+import {ErrorCode} from '../../src/telemetry/errors.js';import type {Persistence} from '../../src/telemetry/persistence.js';import {FilePersistence} from '../../src/telemetry/persistence.js';-import {WatchdogMessageType} from '../../src/telemetry/types.js';+import {McpClient, WatchdogMessageType} from '../../src/telemetry/types.js';import {WatchdogClient} from '../../src/telemetry/WatchdogClient.js';import {zod} from '../../src/third_party/index.js';@@ -126,6 +127,59 @@ describe('ClearcutLogger', () => {}});+ describe('logServerError', () => {+ it('sends correct payload with toolName', async () => {+ const logger = ClearcutLogger.initialize({+ persistence: mockPersistence,+ appVersion: '1.0.0',+ watchdogClient: mockWatchdogClient,+ });++ await logger.logServerError({+ toolName: 'my_tool',+ errorCode: ErrorCode.ERROR_CODE_UNSPECIFIED,+ });++ assert(mockWatchdogClient.send.calledOnce);+ const msg = mockWatchdogClient.send.firstCall.args[0];+ assert.deepStrictEqual(msg, {+ type: WatchdogMessageType.LOG_EVENT,+ payload: {+ mcp_client: McpClient.MCP_CLIENT_UNSPECIFIED,+ server_error: {+ tool_name: 'my_tool',+ error_code: ErrorCode.ERROR_CODE_UNSPECIFIED,+ },+ },+ });+ });++ it('sends correct payload without toolName defaulting to empty string', async () => {+ const logger = ClearcutLogger.initialize({+ persistence: mockPersistence,+ appVersion: '1.0.0',+ watchdogClient: mockWatchdogClient,+ });++ await logger.logServerError({+ errorCode: ErrorCode.ERROR_CODE_UNSPECIFIED,+ });++ assert(mockWatchdogClient.send.calledOnce);+ const msg = mockWatchdogClient.send.firstCall.args[0];+ assert.deepStrictEqual(msg, {+ type: WatchdogMessageType.LOG_EVENT,+ payload: {+ mcp_client: McpClient.MCP_CLIENT_UNSPECIFIED,+ server_error: {+ tool_name: '',+ error_code: ErrorCode.ERROR_CODE_UNSPECIFIED,+ },+ },+ });+ });+ });+describe('logServerStart', () => {it('logs flag usage', async () => {const logger = ClearcutLogger.initialize({