@agentfield/sdk 0.1.138-rc.4 → 0.1.138-rc.6

package/README.md

@@ -122,6 +122,14 @@ agent.reasoner('process', async (ctx) => {
 
 **Use `note()` for AgentField UI tracking, `console.log()` for local debugging.**
 
+## Logging
+
+- `AGENTFIELD_LOG_STDOUT` controls the on-by-default structured JSON mirror; `0`, `false`, `no`, or `off` disables it without disabling execution-scoped control-plane dispatch.
+- `AGENTFIELD_LOGS_ENABLED` controls stdout/stderr capture and the node logs endpoint, not control-plane dispatch.
+- `AGENTFIELD_LOG_MAX_LINE_BYTES` defaults to 16384 bytes. Values below 256 use that default; parsing accepts an integer prefix, so `512abc` yields 512.
+
+See the [environment-variable reference](../../docs/ENVIRONMENT_VARIABLES.md) for details.
+
 ## Human-in-the-Loop Approvals
 
 Use the `ApprovalClient` to pause agent execution for human review:

package/dist/index.d.ts

@@ -584,6 +584,7 @@ declare class ExecutionLogger {
     error(message: string, attributes?: ExecutionLogAttributes, options?: ExecutionLogEmitOptions): ExecutionLogEntry;
     system(eventType: string, message: string, attributes?: ExecutionLogAttributes): ExecutionLogEntry;
     private emit;
+    private shouldMirrorToStdout;
 }
 declare function createExecutionLogger(options?: ExecutionLoggerOptions): ExecutionLogger;
 

package/dist/index.js

@@ -3852,6 +3852,16 @@ var AIClient = class {
   }
 };
 
+// src/utils/envFlags.ts
+var DISABLED_FLAG_VALUES = ["0", "false", "no", "off"];
+function readEnvValue(name) {
+  if (typeof process === "undefined" || !process.env) return void 0;
+  return process.env[name];
+}
+function envFlagEnabled(name) {
+  return !DISABLED_FLAG_VALUES.includes((readEnvValue(name) ?? "true").trim().toLowerCase());
+}
+
 // src/observability/ExecutionLogger.ts
 function isExecutionLogBatchPayload(payload) {
   return "entries" in payload;
@@ -3916,7 +3926,7 @@ var ExecutionLogger = class {
   constructor(options = {}) {
     this.contextProvider = options.contextProvider;
     this.transport = options.transport;
-    this.mirrorToStdout = options.mirrorToStdout ?? true;
+    this.mirrorToStdout = options.mirrorToStdout;
     this.stdout = options.stdout ?? (typeof process !== "undefined" ? process.stdout : void 0);
     this.defaultSource = options.source ?? "sdk.logger";
   }
@@ -3957,9 +3967,8 @@ var ExecutionLogger = class {
   }
   emit(entry) {
     const wire = normalizeExecutionLogEntry(entry);
-    const line = safeJsonStringify(wire) + "\n";
-    if (this.mirrorToStdout && this.stdout?.write) {
-      this.stdout.write(line);
+    if (this.shouldMirrorToStdout() && this.stdout?.write) {
+      this.stdout.write(safeJsonStringify(wire) + "\n");
     }
     if (this.transport && wire.execution_id) {
       try {
@@ -3972,6 +3981,9 @@ var ExecutionLogger = class {
       }
     }
   }
+  shouldMirrorToStdout() {
+    return this.mirrorToStdout ?? envFlagEnabled("AGENTFIELD_LOG_STDOUT");
+  }
 };
 function createExecutionLogger(options = {}) {
   return new ExecutionLogger(options);
@@ -5823,8 +5835,7 @@ function evaluateConstraints(constraints, inputParams) {
 
 // src/agent/processLogs.ts
 function logsEnabled() {
-  const v = (process.env.AGENTFIELD_LOGS_ENABLED ?? "true").trim().toLowerCase();
-  return !["0", "false", "no", "off"].includes(v);
+  return envFlagEnabled("AGENTFIELD_LOGS_ENABLED");
 }
 function maxBufferBytes() {
   const raw = parseInt(process.env.AGENTFIELD_LOG_BUFFER_BYTES ?? "4194304", 10);