@glasstrace/sdk 1.3.9 → 1.5.0

package/dist/cli/mcp-add.cjs

@@ -13831,7 +13831,18 @@ var CaptureConfigSchema = external_exports.object({
   fullConsoleOutput: external_exports.boolean(),
   importGraph: external_exports.boolean(),
   consoleErrors: external_exports.boolean().optional().default(false),
-  errorResponseBodies: external_exports.boolean().optional().default(false)
+  errorResponseBodies: external_exports.boolean().optional().default(false),
+  /**
+   * Account opt-in for side-effect evidence emission (SDK-049).
+   *
+   * When `false` (default), `recordSideEffect()` is a silent no-op:
+   * no allowlist evaluation runs and no `glasstrace.side_effect.*`
+   * attribute reaches the wire. When `true`, allowlisted side-effect
+   * metadata is attached to the active OTel span subject to the
+   * client-side allowlist enforcement layered with the product's
+   * storage-time filter as defense-in-depth.
+   */
+  sideEffectEvidence: external_exports.boolean().optional().default(false)
 });
 var SdkCachedConfigSchema = external_exports.object({
   response: external_exports.record(external_exports.string(), external_exports.unknown()),
@@ -14503,28 +14514,39 @@ function generateMcpConfig(agent, endpoint, bearer) {
     }
   }
 }
-function htmlMarkers() {
+var SDK_VERSION_STAMP_PATTERN = /^[A-Za-z0-9.+-]+$/;
+function htmlMarkers(sdkVersion) {
   return {
-    start: "<!-- glasstrace:mcp:start -->",
+    start: `<!-- glasstrace:mcp:start v=${sdkVersion} -->`,
     end: "<!-- glasstrace:mcp:end -->"
   };
 }
-function hashMarkers() {
+function hashMarkers(sdkVersion) {
   return {
-    start: "# glasstrace:mcp:start",
+    start: `# glasstrace:mcp:start v=${sdkVersion}`,
     end: "# glasstrace:mcp:end"
   };
 }
-function generateInfoSection(agent, endpoint) {
+function generateInfoSection(agent, endpoint, sdkVersion) {
   if (!endpoint || endpoint.trim() === "") {
     throw new Error("endpoint must not be empty");
   }
+  if (!sdkVersion || sdkVersion.trim() === "") {
+    throw new Error("sdkVersion must not be empty");
+  }
+  if (!SDK_VERSION_STAMP_PATTERN.test(sdkVersion)) {
+    throw new Error(
+      "sdkVersion must match [A-Za-z0-9.+\\-]+ (semver-shaped, no whitespace, no angle brackets)"
+    );
+  }
   const content = [
     "",
     "## Glasstrace MCP Integration",
     "",
     `Glasstrace is configured as an MCP server at: ${endpoint}`,
     "",
+    "Glasstrace MCP is available when runtime evidence would materially reduce uncertainty. Use it when there is a failing request, stack trace, unclear runtime behavior, race/data-flow symptom, side effect, or performance issue that source inspection alone does not explain. For a current error, `get_latest_error` or `get_error_list` is usually the cheapest orientation call. For a known route/procedure with no exact error, use `find_trace_candidates` and follow returned exact `get_trace` or `get_root_cause` arguments only if the candidates look relevant. Do not call trace tools for trivial source-local fixes. Treat **no candidates** or **no_traces_found** as a scoped retrieval result, not proof the bug is absent.",
+    "",
     "Available tools:",
     "- `get_latest_error` - Get the most recent error trace from the current session",
     "- `find_trace_candidates` - First-contact route/procedure/URL candidate selection when you have a route fragment, tRPC procedure, method, status, or rough recent activity window but not the exact trace ID. Returns candidate traces plus suggested `get_trace` / `get_root_cause` follow-up call arguments. Candidate discovery, not root-cause proof.",
@@ -14534,24 +14556,24 @@ function generateInfoSection(agent, endpoint) {
     "- `get_test_suggestions` - Get test suggestions based on recent errors",
     "- `get_session_timeline` - Get the timeline of all traces in the current session",
     "",
-    "To reconfigure, run: `npx glasstrace mcp add`",
+    "To refresh this managed section after a `@glasstrace/sdk` upgrade, run: `npx glasstrace upgrade-instructions`. To reconfigure MCP credentials, run: `npx glasstrace mcp add`.",
     ""
   ].join("\n");
   switch (agent.name) {
     case "claude": {
-      const m = htmlMarkers();
+      const m = htmlMarkers(sdkVersion);
       return `${m.start}
 ${content}${m.end}
 `;
     }
     case "codex": {
-      const m = htmlMarkers();
+      const m = htmlMarkers(sdkVersion);
       return `${m.start}
 ${content}${m.end}
 `;
     }
     case "cursor": {
-      const m = hashMarkers();
+      const m = hashMarkers(sdkVersion);
       return `${m.start}
 ${content}${m.end}
 `;
@@ -14570,10 +14592,26 @@ ${content}${m.end}
 // src/agent-detection/inject.ts
 var import_promises2 = require("node:fs/promises");
 var import_node_path2 = require("node:path");
-var HTML_START = "<!-- glasstrace:mcp:start -->";
+var HTML_START_RE = /^<!--\s*glasstrace:mcp:start(?:\s+v=([^\s>]+))?\s*-->$/;
 var HTML_END = "<!-- glasstrace:mcp:end -->";
-var HASH_START = "# glasstrace:mcp:start";
+var HASH_START_RE = /^#\s*glasstrace:mcp:start(?:\s+v=(\S+))?$/;
 var HASH_END = "# glasstrace:mcp:end";
+function parseStartMarkerLine(line) {
+  const trimmed = line.trim();
+  const html = HTML_START_RE.exec(trimmed);
+  if (html !== null) {
+    return { kind: "html", stamp: html[1] ?? null };
+  }
+  const hash2 = HASH_START_RE.exec(trimmed);
+  if (hash2 !== null) {
+    return { kind: "hash", stamp: hash2[1] ?? null };
+  }
+  return null;
+}
+function isEndMarker(line) {
+  const trimmed = line.trim();
+  return trimmed === HTML_END || trimmed === HASH_END;
+}
 function isPermissionError(err) {
   const code = err.code;
   return code === "EACCES" || code === "EPERM" || code === "EROFS";
@@ -14615,22 +14653,14 @@ async function writeMcpConfig(agent, content, projectRoot) {
 }
 function findMarkerBoundaries(lines) {
   let startIdx = -1;
-  let endIdx = -1;
   for (let i = 0; i < lines.length; i++) {
-    const trimmed = lines[i].trim();
-    if (trimmed === HTML_START || trimmed === HASH_START) {
+    if (parseStartMarkerLine(lines[i]) !== null) {
       startIdx = i;
-    } else if (trimmed === HTML_END || trimmed === HASH_END) {
-      if (startIdx !== -1) {
-        endIdx = i;
-        break;
-      }
+    } else if (startIdx !== -1 && isEndMarker(lines[i])) {
+      return { startIdx, endIdx: i };
     }
   }
-  if (startIdx === -1 || endIdx === -1) {
-    return null;
-  }
-  return { startIdx, endIdx };
+  return null;
 }
 async function injectInfoSection(agent, content, projectRoot) {
   if (agent.infoFilePath === null) {
@@ -14899,10 +14929,11 @@ async function mcpAdd(options) {
   const bearer = resolved.effective.key;
   for (const agent of targetAgents) {
     const name = formatAgentName(agent.name);
+    const sdkVersion = true ? "1.5.0" : "0.0.0-dev";
     if (agent.name !== "generic") {
       const cliSuccess = await registerViaCli(agent, bearer);
       if (cliSuccess) {
-        const infoContent = generateInfoSection(agent, MCP_ENDPOINT);
+        const infoContent = generateInfoSection(agent, MCP_ENDPOINT, sdkVersion);
         if (infoContent !== "") {
           await injectInfoSection(agent, infoContent, projectRoot);
         }
@@ -14920,7 +14951,7 @@ async function mcpAdd(options) {
         const configContent = generateMcpConfig(agent, MCP_ENDPOINT, bearer);
         await writeMcpConfig(agent, configContent, projectRoot);
         if (fs.existsSync(agent.mcpConfigPath)) {
-          const infoContent = generateInfoSection(agent, MCP_ENDPOINT);
+          const infoContent = generateInfoSection(agent, MCP_ENDPOINT, sdkVersion);
           if (infoContent !== "") {
             await injectInfoSection(agent, infoContent, projectRoot);
           }