@glasstrace/sdk 1.10.0 → 1.10.2

package/dist/cli/init.js

@@ -26,7 +26,7 @@ import {
   detectAgents,
   generateInfoSection,
   generateMcpConfig
-} from "../chunk-KI7YJ7XD.js";
+} from "../chunk-CIKPFJOM.js";
 import {
   MCP_ENDPOINT,
   getOrCreateAnonKey,
@@ -901,7 +901,7 @@ Then add this as the first statement in your register() function:
           }
           anyConfigWritten = true;
           anyConfigRewrittenWithBearer = true;
-          const sdkVersionForInject = true ? "1.10.0" : "0.0.0-dev";
+          const sdkVersionForInject = true ? "1.10.2" : "0.0.0-dev";
           const infoContent = generateInfoSection(
             agent,
             MCP_ENDPOINT,
@@ -1007,7 +1007,7 @@ async function verifyAnonKeyRegistration(projectRoot) {
   }
   const baseConfig = resolveConfig({ apiKey: devKey });
   const config = { ...baseConfig, apiKey: devKey };
-  const sdkVersion = true ? "1.10.0" : "0.0.0-dev";
+  const sdkVersion = true ? "1.10.2" : "0.0.0-dev";
   const result = await verifyInitReachable(config, anonKey, sdkVersion);
   if (result.ok) {
     return { outcome: "verified" };

package/dist/cli/mcp-add.cjs

@@ -14413,6 +14413,49 @@ async function detectAgents(projectRoot) {
   return detected;
 }
 
+// src/agent-detection/agent-instruction-text.ts
+function buildAgentInstructionBody() {
+  return [
+    "",
+    "## Glasstrace MCP \u2014 Runtime Debugging Evidence",
+    "",
+    "Glasstrace is connected via MCP (`glasstrace`). It captures runtime traces from this app and exposes them through tools that disambiguate bugs source alone cannot resolve.",
+    "",
+    "### Call Glasstrace FIRST when:",
+    "- A value passed at runtime is suspect: wrong role, locale, timezone, template, tenant id, or any enum/config that branches downstream.",
+    "- The bug is in a side-effect operation: email sent, calendar event created, webhook dispatched, queued job, `after()` callback.",
+    "- The user reports a symptom but you do not yet know which code path actually executed.",
+    "- You need to confirm a route or procedure ran in the relevant time window before doing a source dive.",
+    "",
+    "### SKIP Glasstrace when:",
+    "- The bug is statically obvious from source (N+1 query, missing await, redundant query, type error, missing null check).",
+    "- The change is a refactor whose correctness does not depend on runtime behavior.",
+    "- You already have a precise traceId from another source.",
+    "",
+    "### Workflow",
+    "1. Start with `find_trace_candidates`. Pass whatever route or procedure name is natural \u2014 the server normalizes vocabulary and, on miss, returns close matches and a sample of routes actually present in the window.",
+    "2. Take the highest-confidence candidate's `suggestedFollowups` and pass them straight to `get_trace` or `get_root_cause`.",
+    "3. For side-effect bugs, read `sideEffectSummary` in the `get_trace` / `get_root_cause` response. The allowlisted fields (`templateKey`, `providerOperation`, `role`, `locale`, `timezone`, `status`, `phase`) are the ones that disambiguate payload bugs.",
+    "4. If a tool returns empty, READ the response's empty-result envelope before pivoting to source \u2014 each field disambiguates a different reason for the empty result:",
+    "   - `closeMatches` / `recentRoutesSample` \u2014 your filter vocabulary doesn't match server-side names; the server returns the closest known names + a sample of routes actually present.",
+    '   - `windowActivity` \u2014 load-bearing four-way distinguisher. `totalTracesInWindow === 0` AND `totalTracesInTenantEver > 0` means "your time window missed the activity"; `totalTracesInTenantEver === 0` means "this tenant has never produced traces" (SDK not registered, or never hit); `captureConfigBlocksRequest === true` means "the SDK\'s capture config dropped this route"; otherwise the empty result is a vocabulary miss \u2014 see `closeMatches`.',
+    "   - `humanReadable` \u2014 prose guidance written for the agent.",
+    "   - `recoveryActions` \u2014 concrete next-call shapes.",
+    "   - `diagnosticValue` / `recommendedNextStep` \u2014 whether to keep searching or stop.",
+    "   Empty results carry `notAbsenceProof: true` \u2014 they are never proof the bug did not occur.",
+    "",
+    "### Tools",
+    "- `find_trace_candidates` \u2014 discovery, vocabulary-tolerant filter",
+    "- `get_trace` \u2014 exact trace by `traceId`",
+    "- `get_root_cause` \u2014 root-cause analysis for a `traceId`",
+    "- `get_session_timeline` \u2014 events for a session",
+    "- `get_latest_error` / `get_error_list` \u2014 recent server errors",
+    "",
+    "Side-effect evidence is allowlisted and compact by design. Fields you don't see may have been omitted by policy, not absent at runtime.",
+    ""
+  ].join("\n");
+}
+
 // src/agent-detection/configs.ts
 function generateMcpConfig(agent, endpoint, bearer) {
   if (!endpoint || endpoint.trim() === "") {
@@ -14467,6 +14510,7 @@ function generateMcpConfig(agent, endpoint, bearer) {
         {
           mcpServers: {
             glasstrace: {
+              type: "http",
               url: endpoint,
               headers: {
                 Authorization: `Bearer ${bearer}`
@@ -14482,7 +14526,8 @@ function generateMcpConfig(agent, endpoint, bearer) {
         {
           mcpServers: {
             glasstrace: {
-              serverUrl: endpoint,
+              type: "http",
+              url: endpoint,
               headers: {
                 Authorization: `Bearer ${bearer}`
               }
@@ -14539,26 +14584,7 @@ function generateInfoSection(agent, endpoint, sdkVersion) {
       "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.",
-    "- `get_error_list` - List recent errors with filtering and pagination",
-    "- `get_trace` - Get a specific trace by ID or URL pattern",
-    "- `get_root_cause` - Get the root cause analysis for a specific error trace (requires a `traceId` from `get_latest_error`, `get_error_list`, or `get_trace`)",
-    "- `get_test_suggestions` - Get test suggestions for a specific error trace (requires a `traceId` from `get_latest_error`, `get_error_list`, or `get_trace`)",
-    "- `get_session_timeline` - Get the timeline of all traces in the current session",
-    "",
-    "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");
+  const content = buildAgentInstructionBody();
   switch (agent.name) {
     case "claude": {
       const m = htmlMarkers(sdkVersion);
@@ -14929,7 +14955,7 @@ async function mcpAdd(options) {
   const bearer = resolved.effective.key;
   for (const agent of targetAgents) {
     const name = formatAgentName(agent.name);
-    const sdkVersion = true ? "1.10.0" : "0.0.0-dev";
+    const sdkVersion = true ? "1.10.2" : "0.0.0-dev";
     if (agent.name !== "generic") {
       const cliSuccess = await registerViaCli(agent, bearer);
       if (cliSuccess) {