autotel 3.3.1 → 3.4.0

package/dist/index.js

@@ -1,19 +1,19 @@
 export { createDrainPipeline } from './chunk-KFOHQK7X.js';
-export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-4EXFRREO.js';
+export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-TEXCI2S6.js';
 export { attrs, autoRedactPII, dbClient, httpClient, httpServer, identify, mergeAttrs, mergeServiceResource, request, safeSetAttributes, setDevice, setError, setException, setSession, setUser, validateAttribute } from './chunk-454CH4OV.js';
 export { httpRequestHeaderAttribute, httpResponseHeaderAttribute } from './chunk-7552UTQW.js';
 export { HTTPAttributes, ServiceAttributes, URLAttributes } from './chunk-4A53YIAX.js';
 export { parseError } from './chunk-J7VGRIAJ.js';
-export { traceConsumer, traceProducer } from './chunk-VFU663OM.js';
+export { traceConsumer, traceProducer } from './chunk-DMSD5AF3.js';
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
 export { BusinessBaggage, createSafeBaggageSchema } from './chunk-4IFSYQVX.js';
 import { resetMetrics } from './chunk-7SAWIN74.js';
 export { Metric, getMetrics, resetMetrics } from './chunk-7SAWIN74.js';
 import './chunk-5ZN622AO.js';
 export { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter } from './chunk-TQ5UWA7S.js';
-export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-2GWM2CIT.js';
-import { trace as trace$1 } from './chunk-55ALGIAR.js';
-export { ctx, instrument, markAsImmediate, span, withBaggage, withNewContext, withTracing } from './chunk-55ALGIAR.js';
+export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-NMEYVL4L.js';
+import { trace as trace$1 } from './chunk-AIX6BVNN.js';
+export { ctx, instrument, markAsImmediate, span, withBaggage, withNewContext, withTracing } from './chunk-AIX6BVNN.js';
 export { createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan } from './chunk-HLZ7H3VZ.js';
 import { resetEvents } from './chunk-LKASEUWE.js';
 export { Event, getEvents, resetEvents } from './chunk-LKASEUWE.js';

package/dist/messaging.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkVUYLXWCB_cjs = require('./chunk-VUYLXWCB.cjs');
+var chunk6WWXA6IK_cjs = require('./chunk-6WWXA6IK.cjs');
 require('./chunk-4P6ZOARG.cjs');
-require('./chunk-FMTNB27Z.cjs');
+require('./chunk-FOFBFQES.cjs');
 require('./chunk-2GIBANLB.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-JAX4LFGG.cjs');
@@ -24,15 +24,15 @@ require('./chunk-YREV3LGG.cjs');
 
 Object.defineProperty(exports, "clearOrderingState", {
   enumerable: true,
-  get: function () { return chunkVUYLXWCB_cjs.clearOrderingState; }
+  get: function () { return chunk6WWXA6IK_cjs.clearOrderingState; }
 });
 Object.defineProperty(exports, "traceConsumer", {
   enumerable: true,
-  get: function () { return chunkVUYLXWCB_cjs.traceConsumer; }
+  get: function () { return chunk6WWXA6IK_cjs.traceConsumer; }
 });
 Object.defineProperty(exports, "traceProducer", {
   enumerable: true,
-  get: function () { return chunkVUYLXWCB_cjs.traceProducer; }
+  get: function () { return chunk6WWXA6IK_cjs.traceProducer; }
 });
 //# sourceMappingURL=messaging.cjs.map
 //# sourceMappingURL=messaging.cjs.map

package/dist/messaging.js

@@ -1,6 +1,6 @@
-export { clearOrderingState, traceConsumer, traceProducer } from './chunk-VFU663OM.js';
+export { clearOrderingState, traceConsumer, traceProducer } from './chunk-DMSD5AF3.js';
 import './chunk-KIL5CUN6.js';
-import './chunk-55ALGIAR.js';
+import './chunk-AIX6BVNN.js';
 import './chunk-HLZ7H3VZ.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-LCXOOJIP.js';

package/dist/semantic-helpers.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkDK6VFPVK_cjs = require('./chunk-DK6VFPVK.cjs');
-require('./chunk-FMTNB27Z.cjs');
+var chunkBGO7TZID_cjs = require('./chunk-BGO7TZID.cjs');
+require('./chunk-FOFBFQES.cjs');
 require('./chunk-2GIBANLB.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-JAX4LFGG.cjs');
@@ -23,19 +23,19 @@ require('./chunk-YREV3LGG.cjs');
 
 Object.defineProperty(exports, "traceDB", {
   enumerable: true,
-  get: function () { return chunkDK6VFPVK_cjs.traceDB; }
+  get: function () { return chunkBGO7TZID_cjs.traceDB; }
 });
 Object.defineProperty(exports, "traceHTTP", {
   enumerable: true,
-  get: function () { return chunkDK6VFPVK_cjs.traceHTTP; }
+  get: function () { return chunkBGO7TZID_cjs.traceHTTP; }
 });
 Object.defineProperty(exports, "traceLLM", {
   enumerable: true,
-  get: function () { return chunkDK6VFPVK_cjs.traceLLM; }
+  get: function () { return chunkBGO7TZID_cjs.traceLLM; }
 });
 Object.defineProperty(exports, "traceMessaging", {
   enumerable: true,
-  get: function () { return chunkDK6VFPVK_cjs.traceMessaging; }
+  get: function () { return chunkBGO7TZID_cjs.traceMessaging; }
 });
 //# sourceMappingURL=semantic-helpers.cjs.map
 //# sourceMappingURL=semantic-helpers.cjs.map

package/dist/semantic-helpers.js

@@ -1,5 +1,5 @@
-export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-2GWM2CIT.js';
-import './chunk-55ALGIAR.js';
+export { traceDB, traceHTTP, traceLLM, traceMessaging } from './chunk-NMEYVL4L.js';
+import './chunk-AIX6BVNN.js';
 import './chunk-HLZ7H3VZ.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-LCXOOJIP.js';

package/dist/webhook.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk4P6ZOARG_cjs = require('./chunk-4P6ZOARG.cjs');
-var chunkFMTNB27Z_cjs = require('./chunk-FMTNB27Z.cjs');
+var chunkFOFBFQES_cjs = require('./chunk-FOFBFQES.cjs');
 require('./chunk-2GIBANLB.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 var chunkJAX4LFGG_cjs = require('./chunk-JAX4LFGG.cjs');
@@ -157,7 +157,7 @@ function createParkingLot(config) {
     },
     traceCallback(callbackConfig) {
       return (fnFactory) => {
-        return chunkFMTNB27Z_cjs.trace(
+        return chunkFOFBFQES_cjs.trace(
           {
             name: callbackConfig.name,
             spanKind: api.SpanKind.SERVER

package/dist/webhook.js

@@ -1,5 +1,5 @@
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
-import { trace } from './chunk-55ALGIAR.js';
+import { trace } from './chunk-AIX6BVNN.js';
 import './chunk-HLZ7H3VZ.js';
 import './chunk-SEO6NAQT.js';
 import { recordStructuredError } from './chunk-LCXOOJIP.js';

package/dist/workflow-distributed.cjs

@@ -2,7 +2,7 @@
 
 var chunk4P6ZOARG_cjs = require('./chunk-4P6ZOARG.cjs');
 var chunkINJD3G4K_cjs = require('./chunk-INJD3G4K.cjs');
-var chunkFMTNB27Z_cjs = require('./chunk-FMTNB27Z.cjs');
+var chunkFOFBFQES_cjs = require('./chunk-FOFBFQES.cjs');
 require('./chunk-2GIBANLB.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-JAX4LFGG.cjs');
@@ -58,7 +58,7 @@ var WorkflowBaggage = chunkINJD3G4K_cjs.createSafeBaggageSchema(workflowBaggageF
 function traceDistributedWorkflow(config) {
   const spanName = `workflow.${config.name}`;
   return (fnFactory) => {
-    return chunkFMTNB27Z_cjs.trace(
+    return chunkFOFBFQES_cjs.trace(
       { name: spanName, spanKind: api.SpanKind.INTERNAL },
       (baseCtx) => {
         return async (...args) => {
@@ -157,7 +157,7 @@ function traceDistributedWorkflow(config) {
 function traceDistributedStep(config) {
   const spanName = `workflow.step.${config.name}`;
   return (fnFactory) => {
-    return chunkFMTNB27Z_cjs.trace(
+    return chunkFOFBFQES_cjs.trace(
       { name: spanName, spanKind: api.SpanKind.INTERNAL },
       (baseCtx) => {
         return async (...args) => {

package/dist/workflow-distributed.js

@@ -1,6 +1,6 @@
 import { emitCorrelatedEvent } from './chunk-KIL5CUN6.js';
 import { createSafeBaggageSchema } from './chunk-4IFSYQVX.js';
-import { trace } from './chunk-55ALGIAR.js';
+import { trace } from './chunk-AIX6BVNN.js';
 import './chunk-HLZ7H3VZ.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-LCXOOJIP.js';

package/dist/workflow.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkC4JCSBFO_cjs = require('./chunk-C4JCSBFO.cjs');
+var chunkZ3VD3UQZ_cjs = require('./chunk-Z3VD3UQZ.cjs');
 require('./chunk-4P6ZOARG.cjs');
-require('./chunk-FMTNB27Z.cjs');
+require('./chunk-FOFBFQES.cjs');
 require('./chunk-2GIBANLB.cjs');
 require('./chunk-VQTCQKHQ.cjs');
 require('./chunk-JAX4LFGG.cjs');
@@ -24,19 +24,19 @@ require('./chunk-YREV3LGG.cjs');
 
 Object.defineProperty(exports, "getCurrentWorkflowContext", {
   enumerable: true,
-  get: function () { return chunkC4JCSBFO_cjs.getCurrentWorkflowContext; }
+  get: function () { return chunkZ3VD3UQZ_cjs.getCurrentWorkflowContext; }
 });
 Object.defineProperty(exports, "isInWorkflow", {
   enumerable: true,
-  get: function () { return chunkC4JCSBFO_cjs.isInWorkflow; }
+  get: function () { return chunkZ3VD3UQZ_cjs.isInWorkflow; }
 });
 Object.defineProperty(exports, "traceStep", {
   enumerable: true,
-  get: function () { return chunkC4JCSBFO_cjs.traceStep; }
+  get: function () { return chunkZ3VD3UQZ_cjs.traceStep; }
 });
 Object.defineProperty(exports, "traceWorkflow", {
   enumerable: true,
-  get: function () { return chunkC4JCSBFO_cjs.traceWorkflow; }
+  get: function () { return chunkZ3VD3UQZ_cjs.traceWorkflow; }
 });
 //# sourceMappingURL=workflow.cjs.map
 //# sourceMappingURL=workflow.cjs.map

package/dist/workflow.js

@@ -1,6 +1,6 @@
-export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-4EXFRREO.js';
+export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-TEXCI2S6.js';
 import './chunk-KIL5CUN6.js';
-import './chunk-55ALGIAR.js';
+import './chunk-AIX6BVNN.js';
 import './chunk-HLZ7H3VZ.js';
 import './chunk-SEO6NAQT.js';
 import './chunk-LCXOOJIP.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel",
-  "version": "3.3.1",
+  "version": "3.4.0",
   "description": "Write Once, Observe Anywhere",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/functional.test.ts

@@ -337,6 +337,57 @@ describe('Functional API', () => {
         expect(spans[0]!.attributes['userId']).toBe('456');
       });
 
+      it('captures input/output as autotel.input/output when opted in', async () => {
+        const collector = createTraceCollector();
+
+        const calc = traceOptionsFactory(
+          { name: 'calc', captureInput: true, captureOutput: true },
+          (_ctx: TraceContext) => async (a: number, b: number) => a + b,
+        );
+
+        await calc(2, 3);
+
+        const span = collector.getSpans()[0]!;
+        // Multiple args captured as an array; single value would be captured directly.
+        expect(span.attributes['autotel.input']).toBe('[2,3]');
+        expect(span.attributes['autotel.output']).toBe('5');
+      });
+
+      it('does not capture input/output by default', async () => {
+        const collector = createTraceCollector();
+
+        const calc = traceOptionsFactory(
+          { name: 'calc-default' },
+          (_ctx: TraceContext) => async (a: number, b: number) => a + b,
+        );
+
+        await calc(2, 3);
+
+        const span = collector.getSpans()[0]!;
+        expect(span.attributes['autotel.input']).toBeUndefined();
+        expect(span.attributes['autotel.output']).toBeUndefined();
+      });
+
+      it('captures a single argument directly (not wrapped in an array)', async () => {
+        const collector = createTraceCollector();
+
+        const load = traceOptionsFactory(
+          { name: 'load', captureInput: true, captureOutput: true },
+          (_ctx: TraceContext) => async (req: { userId: string }) => ({
+            holdings: 3,
+            userId: req.userId,
+          }),
+        );
+
+        await load({ userId: 'anon' });
+
+        const span = collector.getSpans()[0]!;
+        expect(span.attributes['autotel.input']).toBe('{"userId":"anon"}');
+        expect(span.attributes['autotel.output']).toBe(
+          '{"holdings":3,"userId":"anon"}',
+        );
+      });
+
       it('should respect NeverSampler', async () => {
         const collector = createTraceCollector();
 

package/src/functional.ts

@@ -415,6 +415,21 @@ export interface TracingOptions<
    */
   attributesFromResult?: (result: TReturn) => Record<string, unknown>;
 
+  /**
+   * Capture the function arguments onto the span as `autotel.input`
+   * (JSON, truncated). One arg is captured directly; multiple are captured as
+   * an array. Off by default — opt in per call. Tools (visualizers, devtools)
+   * read this alongside `ai.toolCall.args` to show function I/O uniformly.
+   * Avoid on args with secrets/PII, or pair with a redacting processor.
+   */
+  captureInput?: boolean;
+
+  /**
+   * Capture the function return value onto the span as `autotel.output`
+   * (JSON, truncated). Off by default. Same caveats as {@link captureInput}.
+   */
+  captureOutput?: boolean;
+
   /**
    * Start a new root span instead of creating a child
    * Useful for serverless entry points
@@ -494,6 +509,45 @@ function createDummyCtx<
   } as unknown as TraceContext<TBaggage>;
 }
 
+/** Attribute keys for opt-in function I/O capture (see TracingOptions). */
+const AUTOTEL_INPUT_ATTR = 'autotel.input';
+const AUTOTEL_OUTPUT_ATTR = 'autotel.output';
+const CAPTURE_MAX_CHARS = 4096;
+
+/** JSON-serialize a captured value, defensively (truncate, swallow cycles). */
+function serializeCapture(value: unknown): string | undefined {
+  if (value === undefined) return undefined;
+  try {
+    const json = typeof value === 'string' ? value : JSON.stringify(value);
+    if (json === undefined) return undefined;
+    return json.length > CAPTURE_MAX_CHARS
+      ? `${json.slice(0, CAPTURE_MAX_CHARS)}…[truncated]`
+      : json;
+  } catch {
+    return undefined;
+  }
+}
+
+/** `autotel.input` from args (single arg captured directly, else the array). */
+function captureInputAttrs(
+  args: unknown[],
+  enabled?: boolean,
+): Record<string, unknown> {
+  if (!enabled) return {};
+  const s = serializeCapture(args.length === 1 ? args[0] : args);
+  return s === undefined ? {} : { [AUTOTEL_INPUT_ATTR]: s };
+}
+
+/** `autotel.output` from the return value. */
+function captureOutputAttrs(
+  result: unknown,
+  enabled?: boolean,
+): Record<string, unknown> {
+  if (!enabled) return {};
+  const s = serializeCapture(result);
+  return s === undefined ? {} : { [AUTOTEL_OUTPUT_ATTR]: s };
+}
+
 function isAsyncFunction(fn: unknown): boolean {
   return typeof fn === 'function' && fn.constructor?.name === 'AsyncFunction';
 }
@@ -842,9 +896,12 @@ function wrapWithTracing<TArgs extends unknown[], TReturn>(
 
           const ctxValue = createTraceContext(span);
           const fn = fnFactory(ctxValue);
-          const argsAttributes = options.attributesFromArgs
-            ? options.attributesFromArgs(args)
-            : {};
+          const argsAttributes = {
+            ...captureInputAttrs(args, options.captureInput),
+            ...(options.attributesFromArgs
+              ? options.attributesFromArgs(args)
+              : {}),
+          };
 
           const handleTailSampling = (
             success: boolean,
@@ -879,9 +936,12 @@ function wrapWithTracing<TArgs extends unknown[], TReturn>(
               status: 'success',
             });
 
-            const resultAttributes = options.attributesFromResult
-              ? options.attributesFromResult(result)
-              : {};
+            const resultAttributes = {
+              ...captureOutputAttrs(result, options.captureOutput),
+              ...(options.attributesFromResult
+                ? options.attributesFromResult(result)
+                : {}),
+            };
 
             span.setStatus({ code: SpanStatusCode.OK });
             span.setAttributes({
@@ -1155,9 +1215,12 @@ function wrapWithTracingSync<TArgs extends unknown[], TReturn>(
 
           // Extract attributes only when actually tracing
           // This avoids expensive preprocessing when sampling rejects the trace
-          const argsAttributes = options.attributesFromArgs
-            ? options.attributesFromArgs(args)
-            : {};
+          const argsAttributes = {
+            ...captureInputAttrs(args, options.captureInput),
+            ...(options.attributesFromArgs
+              ? options.attributesFromArgs(args)
+              : {}),
+          };
 
           const handleTailSampling = (
             success: boolean,
@@ -1192,9 +1255,12 @@ function wrapWithTracingSync<TArgs extends unknown[], TReturn>(
               status: 'success',
             });
 
-            const resultAttributes = options.attributesFromResult
-              ? options.attributesFromResult(result)
-              : {};
+            const resultAttributes = {
+              ...captureOutputAttrs(result, options.captureOutput),
+              ...(options.attributesFromResult
+                ? options.attributesFromResult(result)
+                : {}),
+            };
 
             span.setStatus({ code: SpanStatusCode.OK });
             span.setAttributes({