refactor: extract telemetry into separate module with enable/disable toggle

- Create src/common/telemetry.ts — standalone reportNewPrompt() with
  configurable enabled flag
- Add telemetryEnabled to settings types and resolution chain
  (DeepcodingSettings, ResolvedDeepcodingSettings, CreateOpenAIClient)
- Resolution priority: system env > project env > project settings >
  user env > user settings > default true (opt-out)
- Configurable via settings.json ("telemetryEnabled": false) or env
  (DEEPCODE_TELEMETRY_ENABLED=0)
- Reduce session.ts by ~20 lines, delegating to shared module

Author: Lellansin

src/common/openai-client.ts

@@ -26,6 +26,7 @@ export function createOpenAIClient(projectRoot: string = process.cwd()): {
   thinkingEnabled: boolean;
   reasoningEffort: "high" | "max";
   debugLogEnabled: boolean;
+  telemetryEnabled: boolean;
   notify?: string;
   webSearchTool?: string;
   env: Record<string, string>;
@@ -40,6 +41,7 @@ export function createOpenAIClient(projectRoot: string = process.cwd()): {
       thinkingEnabled: settings.thinkingEnabled,
       reasoningEffort: settings.reasoningEffort,
       debugLogEnabled: settings.debugLogEnabled,
+      telemetryEnabled: settings.telemetryEnabled,
       notify: settings.notify,
       webSearchTool: settings.webSearchTool,
       env: settings.env,
@@ -56,6 +58,7 @@ export function createOpenAIClient(projectRoot: string = process.cwd()): {
       thinkingEnabled: settings.thinkingEnabled,
       reasoningEffort: settings.reasoningEffort,
       debugLogEnabled: settings.debugLogEnabled,
+      telemetryEnabled: settings.telemetryEnabled,
       notify: settings.notify,
       webSearchTool: settings.webSearchTool,
       env: settings.env,
@@ -91,6 +94,7 @@ export function createOpenAIClient(projectRoot: string = process.cwd()): {
     thinkingEnabled: settings.thinkingEnabled,
     reasoningEffort: settings.reasoningEffort,
     debugLogEnabled: settings.debugLogEnabled,
+    telemetryEnabled: settings.telemetryEnabled,
     notify: settings.notify,
     webSearchTool: settings.webSearchTool,
     env: settings.env,

src/common/telemetry.ts

@@ -0,0 +1,34 @@
+const DEFAULT_NEW_PROMPT_API_URL = "https://deepcode.vegamo.cn/api/plugin/new";
+const DEFAULT_REPORT_TIMEOUT_MS = 3000;
+
+export type NewPromptReportOptions = {
+  enabled: boolean;
+  machineId?: string;
+  timeoutMs?: number;
+};
+
+/**
+ * Fire-and-forget report of a new prompt session.
+ * Respects the `enabled` toggle: when disabled, the call is a no-op.
+ */
+export function reportNewPrompt(options: NewPromptReportOptions): void {
+  if (!options.enabled || !options.machineId) {
+    return;
+  }
+
+  const timeoutMs = options.timeoutMs ?? DEFAULT_REPORT_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+
+  void fetch(DEFAULT_NEW_PROMPT_API_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Token: options.machineId,
+    },
+    body: JSON.stringify({}),
+    signal: controller.signal,
+  })
+    .catch(() => {})
+    .finally(() => clearTimeout(timeout));
+}

src/session.ts

@@ -45,6 +45,7 @@ import {
   type UserToolPermission,
 } from "./common/permissions";
 import { clearSessionWorkingDir } from "./tools/bash-handler";
+import { reportNewPrompt } from "./common/telemetry";
 
 export type { PermissionScope } from "./settings";
 export type {
@@ -59,8 +60,6 @@ export type {
 const MAX_SESSION_ENTRIES = 50;
 const MAX_PROJECT_CODE_LENGTH = 64;
 const PROJECT_CODE_HASH_LENGTH = 16;
-const DEFAULT_NEW_PROMPT_API_URL = "https://deepcode.vegamo.cn/api/plugin/new";
-const NEW_PROMPT_REPORT_TIMEOUT_MS = 3000;
 const DEFAULT_COMPACT_PROMPT_TOKEN_THRESHOLD = 128 * 1024;
 const DEEPSEEK_V4_COMPACT_PROMPT_TOKEN_THRESHOLD = 512 * 1024;
 
@@ -1504,25 +1503,8 @@ ${skillMd}
   }
 
   private reportNewPrompt(): void {
-    const { machineId } = this.createOpenAIClient();
-    if (!machineId) {
-      return;
-    }
-
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), NEW_PROMPT_REPORT_TIMEOUT_MS);
-
-    void fetch(DEFAULT_NEW_PROMPT_API_URL, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Token: machineId,
-      },
-      body: JSON.stringify({}),
-      signal: controller.signal,
-    })
-      .catch(() => {})
-      .finally(() => clearTimeout(timeout));
+    const { machineId, telemetryEnabled } = this.createOpenAIClient();
+    reportNewPrompt({ enabled: telemetryEnabled ?? true, machineId });
   }
 
   interruptActiveSession(): void {

src/settings.ts

@@ -10,6 +10,7 @@ export type DeepcodingEnv = Record<string, string | undefined> & {
   THINKING_ENABLED?: string;
   REASONING_EFFORT?: string;
   DEBUG_LOG_ENABLED?: string;
+  TELEMETRY_ENABLED?: string;
 };
 
 export type ReasoningEffort = "high" | "max";
@@ -47,6 +48,7 @@ export type DeepcodingSettings = {
   thinkingEnabled?: boolean;
   reasoningEffort?: ReasoningEffort;
   debugLogEnabled?: boolean;
+  telemetryEnabled?: boolean;
   notify?: string;
   webSearchTool?: string;
   mcpServers?: Record<string, McpServerConfig>;
@@ -61,6 +63,7 @@ export type ResolvedDeepcodingSettings = {
   thinkingEnabled: boolean;
   reasoningEffort: ReasoningEffort;
   debugLogEnabled: boolean;
+  telemetryEnabled: boolean;
   notify?: string;
   webSearchTool?: string;
   mcpServers?: Record<string, McpServerConfig>;
@@ -313,6 +316,14 @@ export function resolveSettingsSources(
     parseBoolean(userEnv.DEBUG_LOG_ENABLED) ??
     false;
 
+  const telemetryEnabled =
+    parseBoolean(systemEnv.TELEMETRY_ENABLED) ??
+    parseBoolean(projectSettings?.telemetryEnabled) ??
+    parseBoolean(projectEnv.TELEMETRY_ENABLED) ??
+    parseBoolean(userSettings?.telemetryEnabled) ??
+    parseBoolean(userEnv.TELEMETRY_ENABLED) ??
+    true;
+
   const notify =
     trimString(systemEnv.NOTIFY) || trimString(projectSettings?.notify) || trimString(userSettings?.notify) || "";
   const webSearchTool =
@@ -329,6 +340,7 @@ export function resolveSettingsSources(
     thinkingEnabled,
     reasoningEffort,
     debugLogEnabled,
+    telemetryEnabled,
     notify: notify || undefined,
     webSearchTool: webSearchTool || undefined,
     mcpServers: mergeMcpServers(userSettings, projectSettings, userEnv, projectEnv, systemEnv),

src/tools/executor.ts

@@ -16,6 +16,7 @@ export type CreateOpenAIClient = () => {
   thinkingEnabled: boolean;
   reasoningEffort?: ReasoningEffort;
   debugLogEnabled?: boolean;
+  telemetryEnabled?: boolean;
   notify?: string;
   webSearchTool?: string;
   env?: Record<string, string>;