@glasstrace/sdk 1.9.1 → 1.10.1

package/dist/{chunk-QXITSNYM.js → chunk-XG6WR2KS.js}

@@ -2,12 +2,12 @@ import {
   atomicWriteFile,
   refreshGenericMcpConfigAtRuntime,
   resolveEffectiveMcpCredential
-} from "./chunk-DKV53A2C.js";
+} from "./chunk-RL43PU2X.js";
 import {
   DEFAULT_CAPTURE_CONFIG,
   SdkCachedConfigSchema,
   SdkInitResponseSchema
-} from "./chunk-JHUNLPSS.js";
+} from "./chunk-6RKS3DNA.js";
 import {
   __require
 } from "./chunk-NSBPE2FW.js";
@@ -692,4 +692,4 @@ export {
   didLastInitSucceed,
   verifyInitReachable
 };
-//# sourceMappingURL=chunk-QXITSNYM.js.map
+//# sourceMappingURL=chunk-XG6WR2KS.js.map

package/dist/cli/init.cjs

@@ -15302,6 +15302,48 @@ var init_detect = __esm({
   }
 });
 
+// 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 `closeMatches`, `recentRoutesSample`, and `recoveryActions` before pivoting to source. 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");
+}
+var init_agent_instruction_text = __esm({
+  "src/agent-detection/agent-instruction-text.ts"() {
+    "use strict";
+  }
+});
+
 // src/agent-detection/configs.ts
 function generateMcpConfig(agent, endpoint, bearer) {
   if (!endpoint || endpoint.trim() === "") {
@@ -15356,6 +15398,7 @@ function generateMcpConfig(agent, endpoint, bearer) {
         {
           mcpServers: {
             glasstrace: {
+              type: "http",
               url: endpoint,
               headers: {
                 Authorization: `Bearer ${bearer}`
@@ -15371,7 +15414,8 @@ function generateMcpConfig(agent, endpoint, bearer) {
         {
           mcpServers: {
             glasstrace: {
-              serverUrl: endpoint,
+              type: "http",
+              url: endpoint,
               headers: {
                 Authorization: `Bearer ${bearer}`
               }
@@ -15427,26 +15471,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);
@@ -15480,6 +15505,7 @@ var SDK_VERSION_STAMP_PATTERN;
 var init_configs = __esm({
   "src/agent-detection/configs.ts"() {
     "use strict";
+    init_agent_instruction_text();
     SDK_VERSION_STAMP_PATTERN = /^[A-Za-z0-9.+-]+$/;
   }
 });
@@ -16994,7 +17020,7 @@ async function mcpAdd(options) {
   const bearer = resolved.effective.key;
   for (const agent of targetAgents) {
     const name = formatAgentName(agent.name);
-    const sdkVersion = true ? "1.9.1" : "0.0.0-dev";
+    const sdkVersion = true ? "1.10.1" : "0.0.0-dev";
     if (agent.name !== "generic") {
       const cliSuccess = await registerViaCli(agent, bearer);
       if (cliSuccess) {
@@ -17262,7 +17288,7 @@ async function runUpgradeInstructions(options) {
     );
     return { exitCode: 1, refreshed, skipped, warnings, errors };
   }
-  const sdkVersion = true ? "1.9.1" : "0.0.0-dev";
+  const sdkVersion = true ? "1.10.1" : "0.0.0-dev";
   for (const agent of agents) {
     if (agent.infoFilePath === null) {
       continue;
@@ -18902,7 +18928,7 @@ Then add this as the first statement in your register() function:
           }
           anyConfigWritten = true;
           anyConfigRewrittenWithBearer = true;
-          const sdkVersionForInject = true ? "1.9.1" : "0.0.0-dev";
+          const sdkVersionForInject = true ? "1.10.1" : "0.0.0-dev";
           const infoContent = generateInfoSection(
             agent,
             MCP_ENDPOINT,
@@ -19008,7 +19034,7 @@ async function verifyAnonKeyRegistration(projectRoot) {
   }
   const baseConfig = resolveConfig({ apiKey: devKey });
   const config2 = { ...baseConfig, apiKey: devKey };
-  const sdkVersion = true ? "1.9.1" : "0.0.0-dev";
+  const sdkVersion = true ? "1.10.1" : "0.0.0-dev";
   const result = await verifyInitReachable(config2, anonKey, sdkVersion);
   if (result.ok) {
     return { outcome: "verified" };