@standardagents/builder 0.27.7 → 0.27.8

package/dist/runtime.d.ts

@@ -3602,6 +3602,10 @@ interface ProviderLookupResult {
  */
 declare class ProviderRegistryImpl {
     private providerCache;
+    /** Why the last thread-scoped resolution did (not) contribute user env,
+     *  keyed by the env object handed back — surfaced in missing-variable
+     *  errors so a silent user-env failure is diagnosable from the log. */
+    private scopeDiagnostics;
     private providerOverrideFn;
     private providerOverrideRevision;
     setProviderOverride(fn: ProviderOverrideFn | null): void;

package/dist/runtime.js

@@ -884,6 +884,10 @@ var init_ProviderRegistry = __esm({
     init_factory();
     ProviderRegistryImpl = class {
       providerCache = /* @__PURE__ */ new Map();
+      /** Why the last thread-scoped resolution did (not) contribute user env,
+       *  keyed by the env object handed back — surfaced in missing-variable
+       *  errors so a silent user-env failure is diagnosable from the log. */
+      scopeDiagnostics = /* @__PURE__ */ new WeakMap();
       providerOverrideFn = null;
       providerOverrideRevision = 0;
       setProviderOverride(fn) {
@@ -906,6 +910,7 @@ var init_ProviderRegistry = __esm({
         const threadEnv = state.thread.metadata?.env ?? state.thread.metadata?.tenvs ?? null;
         const userId = state.thread.metadata?.user_id ?? null;
         let userEnv = null;
+        let diagnostic = userId ? "" : "no thread user_id";
         if (userId) {
           try {
             const agentBuilderId = state.env.AGENT_BUILDER.idFromName("singleton");
@@ -917,14 +922,25 @@ var init_ProviderRegistry = __esm({
                 for (const entry of entries) {
                   if (entry?.name) userEnv[entry.name] = entry.value;
                 }
+                diagnostic = `user env: ${Object.keys(userEnv).length} entries`;
+              } else {
+                diagnostic = `user env empty for ${userId} (entries: ${Array.isArray(entries) ? entries.length : typeof entries})`;
               }
+            } else {
+              diagnostic = "singleton has no getUserEnvEntries";
             }
           } catch (error) {
-            console.warn("buildThreadScopedEnv: user env unavailable:", error instanceof Error ? error.message : String(error));
+            diagnostic = `user env lookup failed: ${error instanceof Error ? error.message : String(error)}`;
+            console.warn("buildThreadScopedEnv:", diagnostic);
           }
         }
-        if (!userEnv && !threadEnv) return state.env;
-        return { ...state.env, ...userEnv ?? {}, ...threadEnv ?? {} };
+        if (!userEnv && !threadEnv) {
+          this.scopeDiagnostics.set(state.env, diagnostic);
+          return state.env;
+        }
+        const merged = { ...state.env, ...userEnv ?? {}, ...threadEnv ?? {} };
+        this.scopeDiagnostics.set(merged, diagnostic);
+        return merged;
       }
       /**
        * Get provider for a model.
@@ -963,8 +979,9 @@ var init_ProviderRegistry = __esm({
         if (providerDefinition) {
           const resolved = resolveDefinedProviderConfig(providerDefinition, env);
           if (resolved.missing.length > 0) {
+            const scopeNote = this.scopeDiagnostics.get(env);
             throw new Error(
-              `Missing required environment variables for provider '${providerName}': ${resolved.missing.join(", ")}.`
+              `Missing required environment variables for provider '${providerName}': ${resolved.missing.join(", ")}.` + (scopeNote ? ` [thread-scoped env: ${scopeNote}]` : "")
             );
           }
           const config = resolved.providerConfig;