langwatch 1.11.0 → 1.12.0

package/dist/agent/index.d.mts

@@ -209,7 +209,13 @@ interface ConnectAgentOptions<P extends ParameterInput = ParameterDefinitions> {
     environment?: string;
     /** A definition map, a Standard JSON Schema object, or a JSON Schema object. */
     parameters?: P;
-    /** Default true, except when CI is truthy. LANGWATCH_AGENT_CONNECT=0 always disables. */
+    /**
+     * Whether this process connects. Takes any boolean, so one expression can
+     * gate the deployments that connect. Without it the default is true, except
+     * when CI is truthy; a value given here replaces that rule rather than adding
+     * to it, so keep the CI half: `process.env.APP_ENV !== "production" && !process.env.CI`.
+     * LANGWATCH_AGENT_CONNECT=0 always disables.
+     */
     enabled?: boolean;
     /** Names this instance in the platform. Also LANGWATCH_AGENT_INSTANCE_LABEL. */
     instanceLabel?: string;

package/dist/agent/index.d.ts

@@ -209,7 +209,13 @@ interface ConnectAgentOptions<P extends ParameterInput = ParameterDefinitions> {
     environment?: string;
     /** A definition map, a Standard JSON Schema object, or a JSON Schema object. */
     parameters?: P;
-    /** Default true, except when CI is truthy. LANGWATCH_AGENT_CONNECT=0 always disables. */
+    /**
+     * Whether this process connects. Takes any boolean, so one expression can
+     * gate the deployments that connect. Without it the default is true, except
+     * when CI is truthy; a value given here replaces that rule rather than adding
+     * to it, so keep the CI half: `process.env.APP_ENV !== "production" && !process.env.CI`.
+     * LANGWATCH_AGENT_CONNECT=0 always disables.
+     */
     enabled?: boolean;
     /** Names this instance in the platform. Also LANGWATCH_AGENT_INSTANCE_LABEL. */
     instanceLabel?: string;

package/dist/agent/index.js

@@ -87,7 +87,7 @@ var os = __toESM(require("os"));
 var import_node_crypto = require("crypto");
 
 // package.json
-var version = "1.11.0";
+var version = "1.12.0";
 
 // src/internal/constants.ts
 var LANGWATCH_SDK_VERSION = version;
@@ -1212,6 +1212,8 @@ var AgentClient = class {
     try {
       const result = await import_api.context.with(parent, () => runtime.run(call));
       if (entry.cancelled) return;
+      this.releaseCall({ callId: frame.callId, entry });
+      await this.flushSpans();
       this.send({
         type: "result",
         protocol: PROTOCOL_VERSION,
@@ -1224,11 +1226,34 @@ var AgentClient = class {
       const code = error instanceof AgentParameterError ? error.code : "agent_call_failed";
       const message = describeError(error);
       this.logger.warn(`agent "${runtime.name}" call ${frame.callId} failed: ${message}`);
+      this.releaseCall({ callId: frame.callId, entry });
+      await this.flushSpans();
       this.sendError({ callId: frame.callId, code, message });
     } finally {
       this.releaseCall({ callId: frame.callId, entry });
     }
   }
+  /**
+   * Exports the spans of the call now instead of at the exporter's next
+   * schedule. The judge reads the agent's spans right after the last turn,
+   * and a batch exporter would otherwise hold them for seconds, which is what
+   * made the judge report the spans missing.
+   *
+   * The call awaits this before it sends its result or its error: the frame is
+   * what tells the platform the turn is over, so a frame that goes out first
+   * lets the judge read the call while its spans are still in the exporter.
+   */
+  async flushSpans() {
+    const provider = import_api.trace.getTracerProvider();
+    const delegate = typeof provider.getDelegate === "function" ? provider.getDelegate() : provider;
+    const flush = delegate?.forceFlush;
+    if (typeof flush !== "function") return;
+    try {
+      await flush.call(delegate);
+    } catch (error) {
+      this.logger.debug(`span flush after a call failed: ${describeError(error)}`);
+    }
+  }
   /** Frees the slot the call holds and drops its deadline timer. */
   releaseCall({ callId, entry }) {
     if (entry.timer) {