@adhdev/daemon-standalone 0.8.48 → 0.8.50

package/dist/index.js

@@ -30803,6 +30803,8 @@ ${data.message || ""}`.trim();
       CliProviderInstance: () => CliProviderInstance,
       DAEMON_WS_PATH: () => DAEMON_WS_PATH,
       DEFAULT_DAEMON_PORT: () => DEFAULT_DAEMON_PORT,
+      DEFAULT_SESSION_HOST_APP_NAME: () => DEFAULT_SESSION_HOST_APP_NAME,
+      DEFAULT_STANDALONE_SESSION_HOST_APP_NAME: () => DEFAULT_STANDALONE_SESSION_HOST_APP_NAME,
       DaemonAgentStreamManager: () => DaemonAgentStreamManager,
       DaemonCdpInitializer: () => DaemonCdpInitializer,
       DaemonCdpManager: () => DaemonCdpManager,
@@ -30824,7 +30826,11 @@ ${data.message || ""}`.trim();
       buildMachineInfo: () => buildMachineInfo2,
       buildSessionEntries: () => buildSessionEntries,
       buildStatusSnapshot: () => buildStatusSnapshot2,
+      clearDebugTrace: () => clearDebugTrace,
+      configureDebugTraceStore: () => configureDebugTraceStore,
       connectCdpManager: () => connectCdpManager,
+      createDebugTraceStore: () => createDebugTraceStore,
+      createInteractionId: () => createInteractionId,
       detectAllVersions: () => detectAllVersions,
       detectCLIs: () => detectCLIs,
       detectIDEs: () => detectIDEs,
@@ -30835,10 +30841,12 @@ ${data.message || ""}`.trim();
       getAvailableIdeIds: () => getAvailableIdeIds,
       getCurrentDaemonLogPath: () => getCurrentDaemonLogPath,
       getDaemonLogDir: () => getDaemonLogDir,
+      getDebugRuntimeConfig: () => getDebugRuntimeConfig,
       getHostMemorySnapshot: () => getHostMemorySnapshot,
       getLogLevel: () => getLogLevel,
       getRecentActivity: () => getRecentActivity,
       getRecentCommands: () => getRecentCommands,
+      getRecentDebugTrace: () => getRecentDebugTrace,
       getRecentLogs: () => getRecentLogs,
       getSavedProviderSessions: () => getSavedProviderSessions,
       getWorkspaceState: () => getWorkspaceState2,
@@ -30865,13 +30873,19 @@ ${data.message || ""}`.trim();
       normalizeManagedStatus: () => normalizeManagedStatus,
       probeCdpPort: () => probeCdpPort,
       readChatHistory: () => readChatHistory,
+      recordDebugTrace: () => recordDebugTrace,
       registerExtensionProviders: () => registerExtensionProviders,
       resetConfig: () => resetConfig,
+      resetDebugRuntimeConfig: () => resetDebugRuntimeConfig,
       resetState: () => resetState,
+      resolveDebugRuntimeConfig: () => resolveDebugRuntimeConfig,
+      resolveSessionHostAppName: () => resolveSessionHostAppName2,
       saveConfig: () => saveConfig,
       saveState: () => saveState,
+      setDebugRuntimeConfig: () => setDebugRuntimeConfig,
       setLogLevel: () => setLogLevel,
       setupIdeInstance: () => setupIdeInstance,
+      shouldCollectTraceCategory: () => shouldCollectTraceCategory,
       shutdownDaemonComponents: () => shutdownDaemonComponents2,
       spawnDetachedDaemonUpgradeHelper: () => spawnDetachedDaemonUpgradeHelper,
       startDaemonDevSupport: () => startDaemonDevSupport2,
@@ -35227,6 +35241,128 @@ ${effect.notification.body || ""}`.trim();
       return content.filter((b2) => b2.type === "text").map((b2) => b2.text).join("\n");
     }
     init_logger();
+    var NORMAL_TRACE_BUFFER_SIZE = 200;
+    var DEV_TRACE_BUFFER_SIZE = 1e3;
+    var DEFAULT_CONFIG2 = {
+      logLevel: "info",
+      collectDebugTrace: false,
+      traceContent: false,
+      traceBufferSize: NORMAL_TRACE_BUFFER_SIZE,
+      traceCategories: []
+    };
+    var currentConfig = { ...DEFAULT_CONFIG2 };
+    function normalizeCategories(categories) {
+      if (!Array.isArray(categories)) return [];
+      return categories.map((category) => String(category || "").trim()).filter(Boolean);
+    }
+    function resolveDebugRuntimeConfig(options = {}) {
+      const dev = options.dev === true;
+      return {
+        logLevel: options.logLevel || (dev ? "debug" : DEFAULT_CONFIG2.logLevel),
+        collectDebugTrace: typeof options.trace === "boolean" ? options.trace : dev,
+        traceContent: options.traceContent === true,
+        traceBufferSize: Number.isFinite(options.traceBufferSize) ? Math.max(10, Math.floor(options.traceBufferSize)) : dev ? DEV_TRACE_BUFFER_SIZE : DEFAULT_CONFIG2.traceBufferSize,
+        traceCategories: normalizeCategories(options.traceCategories)
+      };
+    }
+    function setDebugRuntimeConfig(config2) {
+      currentConfig = {
+        ...config2,
+        traceCategories: normalizeCategories(config2.traceCategories),
+        traceBufferSize: Math.max(10, Math.floor(config2.traceBufferSize || DEFAULT_CONFIG2.traceBufferSize))
+      };
+    }
+    function getDebugRuntimeConfig() {
+      return { ...currentConfig, traceCategories: [...currentConfig.traceCategories] };
+    }
+    function resetDebugRuntimeConfig() {
+      currentConfig = { ...DEFAULT_CONFIG2 };
+    }
+    function shouldCollectTraceCategory(category) {
+      const config2 = currentConfig;
+      if (!config2.collectDebugTrace) return false;
+      if (!category) return true;
+      if (config2.traceCategories.length === 0) return true;
+      return config2.traceCategories.includes(category);
+    }
+    function summarizeString(value) {
+      return `[${value.length} chars]`;
+    }
+    function sanitizeTraceValue(value, traceContent) {
+      if (traceContent) {
+        if (Array.isArray(value)) return value.map((entry) => sanitizeTraceValue(entry, traceContent));
+        if (value && typeof value === "object") {
+          return Object.fromEntries(
+            Object.entries(value).map(([key, nested]) => [key, sanitizeTraceValue(nested, traceContent)])
+          );
+        }
+        return value;
+      }
+      if (typeof value === "string") return summarizeString(value);
+      if (Array.isArray(value)) return value.map((entry) => sanitizeTraceValue(entry, traceContent));
+      if (value && typeof value === "object") {
+        return Object.fromEntries(
+          Object.entries(value).map(([key, nested]) => [key, sanitizeTraceValue(nested, traceContent)])
+        );
+      }
+      return value;
+    }
+    function sanitizeTracePayload(payload) {
+      if (!payload) return {};
+      const { traceContent } = getDebugRuntimeConfig();
+      return sanitizeTraceValue(payload, traceContent);
+    }
+    function createEntry(event) {
+      return {
+        id: `trace_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`,
+        ts: Date.now(),
+        ...event,
+        payload: sanitizeTracePayload(event.payload)
+      };
+    }
+    function createDebugTraceStore(options) {
+      const entries = [];
+      const capacity = Math.max(1, Math.floor(options.capacity || 100));
+      return {
+        record(event) {
+          if (!options.enabled) return null;
+          const entry = createEntry(event);
+          entries.push(entry);
+          if (entries.length > capacity) {
+            entries.splice(0, entries.length - capacity);
+          }
+          return entry;
+        },
+        list(query = {}) {
+          const limit = Math.max(1, Math.floor(query.limit || 100));
+          return entries.filter((entry) => !query.interactionId || entry.interactionId === query.interactionId).filter((entry) => !query.category || entry.category === query.category).slice(-limit).map((entry) => ({ ...entry, payload: entry.payload ? { ...entry.payload } : {} }));
+        },
+        clear() {
+          entries.splice(0, entries.length);
+        }
+      };
+    }
+    var globalStore = createDebugTraceStore({ enabled: false, capacity: getDebugRuntimeConfig().traceBufferSize });
+    function configureDebugTraceStore() {
+      const config2 = getDebugRuntimeConfig();
+      globalStore = createDebugTraceStore({
+        enabled: config2.collectDebugTrace,
+        capacity: config2.traceBufferSize
+      });
+    }
+    function recordDebugTrace(event) {
+      if (!shouldCollectTraceCategory(event.category)) return null;
+      return globalStore.record(event);
+    }
+    function getRecentDebugTrace(query = {}) {
+      return globalStore.list(query);
+    }
+    function clearDebugTrace() {
+      globalStore.clear();
+    }
+    function createInteractionId(prefix = "ix") {
+      return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+    }
     var RECENT_SEND_WINDOW_MS = 1200;
     var recentSendByTarget = /* @__PURE__ */ new Map();
     function hashSignatureParts2(parts) {
@@ -35293,6 +35429,20 @@ ${effect.notification.body || ""}`.trim();
       const providerSessionId = typeof state?.providerSessionId === "string" ? state.providerSessionId.trim() : "";
       return providerSessionId || targetSessionId;
     }
+    function getInteractionId(args) {
+      return typeof args?._interactionId === "string" && args._interactionId.trim() ? args._interactionId.trim() : void 0;
+    }
+    function traceProviderEvent(args, category, stage, options) {
+      recordDebugTrace({
+        interactionId: getInteractionId(args),
+        category,
+        stage,
+        level: options.level || "info",
+        sessionId: typeof args?.targetSessionId === "string" ? args.targetSessionId : options.h.currentSession?.sessionId,
+        providerType: options.provider?.type || options.h.currentProviderType || options.h.currentSession?.providerType,
+        payload: options.payload
+      });
+    }
     function callLegacyTextScript(script, text) {
       if (typeof script !== "function") return null;
       return script(text);
@@ -35538,6 +35688,16 @@ ${effect.notification.body || ""}`.trim();
             }
             if (parsed && typeof parsed === "object") {
               _log(`Extension OK: ${parsed.messages?.length || 0} msgs`);
+              traceProviderEvent(args, "provider", "extension.read_chat.success", {
+                h,
+                provider,
+                payload: {
+                  method: "evaluateProviderScript",
+                  result: evalResult.result,
+                  parsed,
+                  messageCount: Array.isArray(parsed.messages) ? parsed.messages.length : 0
+                }
+              });
               h.historyWriter.appendNewMessages(
                 provider?.type || "unknown_extension",
                 toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
@@ -35550,6 +35710,12 @@ ${effect.notification.body || ""}`.trim();
           }
         } catch (e) {
           _log(`Extension error: ${e.message}`);
+          traceProviderEvent(args, "provider", "extension.read_chat.error", {
+            h,
+            provider,
+            level: "warn",
+            payload: { method: "evaluateProviderScript", error: e.message }
+          });
         }
         if (h.agentStream) {
           const cdp2 = h.getCdp();
@@ -35613,27 +35779,45 @@ ${effect.notification.body || ""}`.trim();
       const script = h.getProviderScript("readChat") || h.getProviderScript("read_chat");
       if (script) {
         try {
-          const result = await cdp.evaluate(script, 5e4);
-          let parsed = result;
-          if (typeof parsed === "string") {
-            try {
-              parsed = JSON.parse(parsed);
-            } catch {
+          const evalResult = await h.evaluateProviderScript("readChat", void 0, 5e4);
+          if (evalResult?.result) {
+            let parsed = evalResult.result;
+            if (typeof parsed === "string") {
+              try {
+                parsed = JSON.parse(parsed);
+              } catch {
+              }
+            }
+            if (parsed && typeof parsed === "object" && parsed.messages?.length > 0) {
+              _log(`OK: ${parsed.messages?.length} msgs`);
+              traceProviderEvent(args, "provider", "ide.read_chat.success", {
+                h,
+                provider,
+                payload: {
+                  method: "evaluate",
+                  result: evalResult.result,
+                  parsed,
+                  messageCount: Array.isArray(parsed.messages) ? parsed.messages.length : 0
+                }
+              });
+              h.historyWriter.appendNewMessages(
+                provider?.type || getCurrentProviderType(h, "unknown_ide"),
+                toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
+                parsed.title,
+                args?.targetSessionId,
+                historySessionId
+              );
+              return buildReadChatCommandResult(parsed, args);
             }
-          }
-          if (parsed && typeof parsed === "object" && parsed.messages?.length > 0) {
-            _log(`OK: ${parsed.messages?.length} msgs`);
-            h.historyWriter.appendNewMessages(
-              provider?.type || getCurrentProviderType(h, "unknown_ide"),
-              toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
-              parsed.title,
-              args?.targetSessionId,
-              historySessionId
-            );
-            return buildReadChatCommandResult(parsed, args);
           }
         } catch (e) {
           LOG2.info("Command", `[read_chat] Script error: ${e.message}`);
+          traceProviderEvent(args, "provider", "ide.read_chat.error", {
+            h,
+            provider,
+            level: "warn",
+            payload: { method: "evaluate", error: e.message }
+          });
         }
       }
       return buildReadChatCommandResult({ messages: [], status: "idle" }, args);
@@ -41495,6 +41679,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
           ts: entry.ts,
           cmd: entry.cmd,
           src: entry.source,
+          ...entry.interactionId ? { interactionId: entry.interactionId } : {},
           ...entry.args ? { args: maskArgs(entry.args) } : {},
           ...entry.success !== void 0 ? { ok: entry.success } : {},
           ...entry.error ? { err: entry.error } : {},
@@ -41516,6 +41701,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
               ts: parsed.ts,
               cmd: parsed.cmd,
               source: parsed.src,
+              interactionId: parsed.interactionId,
               args: parsed.args,
               success: parsed.ok,
               error: parsed.err,
@@ -41975,6 +42161,13 @@ Run 'adhdev doctor' for detailed diagnostics.`
           return "unknown";
       }
     }
+    function normalizeCommandArgsWithInteractionId(args) {
+      const base = args && typeof args === "object" ? { ...args } : {};
+      if (typeof base._interactionId !== "string" || !String(base._interactionId).trim()) {
+        base._interactionId = createInteractionId();
+      }
+      return base;
+    }
     function toHostedCliRuntimeDescriptor(record2) {
       if (!record2 || typeof record2 !== "object") return null;
       const runtimeId = typeof record2.sessionId === "string" ? record2.sessionId : "";
@@ -42013,20 +42206,50 @@ Run 'adhdev doctor' for detailed diagnostics.`
       async execute(cmd, args, source = "unknown") {
         const cmdStart = Date.now();
         const logSource = normalizeCommandSource(source);
+        const normalizedArgs = normalizeCommandArgsWithInteractionId(args);
+        const interactionId = typeof normalizedArgs._interactionId === "string" ? normalizedArgs._interactionId : void 0;
+        recordDebugTrace({
+          interactionId,
+          category: "command",
+          stage: "received",
+          level: "info",
+          payload: { cmd, source: logSource }
+        });
         try {
-          const daemonResult = await this.executeDaemonCommand(cmd, args);
+          const daemonResult = await this.executeDaemonCommand(cmd, normalizedArgs);
           if (daemonResult) {
-            logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, args, success: daemonResult.success, durationMs: Date.now() - cmdStart });
+            logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, interactionId, args: normalizedArgs, success: daemonResult.success, durationMs: Date.now() - cmdStart });
+            recordDebugTrace({
+              interactionId,
+              category: "command",
+              stage: "completed",
+              level: daemonResult.success ? "info" : "warn",
+              payload: { cmd, source: logSource, success: daemonResult.success, durationMs: Date.now() - cmdStart }
+            });
             return daemonResult;
           }
-          const handlerResult = await this.deps.commandHandler.handle(cmd, args);
-          logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, args, success: handlerResult.success, durationMs: Date.now() - cmdStart });
+          const handlerResult = await this.deps.commandHandler.handle(cmd, normalizedArgs);
+          logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, interactionId, args: normalizedArgs, success: handlerResult.success, durationMs: Date.now() - cmdStart });
+          recordDebugTrace({
+            interactionId,
+            category: "command",
+            stage: "completed",
+            level: handlerResult.success ? "info" : "warn",
+            payload: { cmd, source: logSource, success: handlerResult.success, durationMs: Date.now() - cmdStart }
+          });
           if (CHAT_COMMANDS.includes(cmd) && this.deps.onPostChatCommand) {
             this.deps.onPostChatCommand();
           }
           return handlerResult;
         } catch (e) {
-          logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, args, success: false, error: e.message, durationMs: Date.now() - cmdStart });
+          logCommand({ ts: (/* @__PURE__ */ new Date()).toISOString(), cmd, source: logSource, interactionId, args: normalizedArgs, success: false, error: e.message, durationMs: Date.now() - cmdStart });
+          recordDebugTrace({
+            interactionId,
+            category: "command",
+            stage: "failed",
+            level: "error",
+            payload: { cmd, source: logSource, error: e?.message || String(e), durationMs: Date.now() - cmdStart }
+          });
           throw e;
         }
       }
@@ -42068,6 +42291,14 @@ Run 'adhdev doctor' for detailed diagnostics.`
               return { success: false, error: e.message };
             }
           }
+          case "get_debug_trace": {
+            const count = parseInt(args?.count) || parseInt(args?.limit) || 100;
+            const sinceTs = Number(args?.since) || 0;
+            const interactionId = typeof args?.interactionId === "string" ? args.interactionId : void 0;
+            const category = typeof args?.category === "string" ? args.category : void 0;
+            const trace = getRecentDebugTrace({ interactionId, category, limit: count }).filter((entry) => !sinceTs || entry.ts > sinceTs);
+            return { success: true, trace, count: trace.length };
+          }
           case "session_host_get_diagnostics": {
             if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
             const diagnostics = await this.deps.sessionHostControl.getDiagnostics({
@@ -49394,6 +49625,14 @@ data: ${JSON.stringify(msg.data)}
         });
       }
     };
+    var DEFAULT_SESSION_HOST_APP_NAME = "adhdev";
+    var DEFAULT_STANDALONE_SESSION_HOST_APP_NAME = "adhdev-standalone";
+    function resolveSessionHostAppName2(options = {}) {
+      const env = options.env || process.env;
+      const explicit = typeof env.ADHDEV_SESSION_HOST_NAME === "string" ? env.ADHDEV_SESSION_HOST_NAME.trim() : "";
+      if (explicit) return explicit;
+      return options.standalone ? DEFAULT_STANDALONE_SESSION_HOST_APP_NAME : DEFAULT_SESSION_HOST_APP_NAME;
+    }
     var import_session_host_core32 = require_dist();
     var STARTUP_TIMEOUT_MS = 8e3;
     var STARTUP_POLL_MS = 200;
@@ -49926,8 +50165,11 @@ var fs2 = __toESM(require("fs"));
 var os2 = __toESM(require("os"));
 var path = __toESM(require("path"));
 var import_daemon_core = __toESM(require_dist2());
-var SESSION_HOST_APP_NAME = process.env.ADHDEV_SESSION_HOST_NAME || "adhdev";
+var SESSION_HOST_APP_NAME = (0, import_daemon_core.resolveSessionHostAppName)({ standalone: true });
 var SESSION_HOST_START_TIMEOUT_MS = 15e3;
+function getStandaloneSessionHostAppName() {
+  return SESSION_HOST_APP_NAME;
+}
 function buildSessionHostEnv(baseEnv) {
   const env = {};
   for (const [key, value] of Object.entries(baseEnv)) {
@@ -50693,6 +50935,7 @@ var StandaloneServer = class {
     const cdpCount = [...this.components.cdpManagers.values()].filter((m) => m.isConnected).length;
     console.log(`   CDP: ${cdpCount > 0 ? `\u2705 ${cdpCount} connected` : "\u274C none"}`);
     console.log(`   Providers: ${this.components.providerLoader.getAll().length} loaded`);
+    console.log(`   Session Host: ${getStandaloneSessionHostAppName()}`);
     if (options.dev) {
       console.log(`   \u{1F6E0}\uFE0F  DevConsole: http://127.0.0.1:19280`);
     }
@@ -51703,6 +51946,9 @@ Options:
   --dev               Enable DevConsole to debug and test providers
   --public <path>     Custom path to the web dashboard distribution
   --no-open           Do not automatically open the browser on startup
+
+Environment:
+  ADHDEV_SESSION_HOST_NAME   Override session host namespace (default: adhdev-standalone)
   --help, -h          Show this help message
 
 Runtime commands: