eve/dist/src/tracing/content-attributes.d.ts

Filesystem-first framework for durable backend AI agents that run anywhere.

/**
 * Which span attributes carry conversation content, and in which direction.
 *
 * Two vocabularies land on the same spans: the ones eve sets on its own
 * `agent.*` spans, and the ones the AI SDK's OpenTelemetry integration sets on
 * the model-call spans beneath them. A destination that declined content has to
 * be rid of both, so both are listed here rather than in the module that writes
 * each.
 *
 * Listed by name rather than by prefix because the prefixes are shared with
 * metadata that must survive: `ai.response.finish_reason` and
 * `gen_ai.tool.name` say what happened, not what was said. The cost is that a
 * new content attribute in a dependency is not covered until it is added here.
 */
/** What one destination is willing to receive. */
export interface ResolvedContentOptions {
    readonly recordInputs: boolean;
    readonly recordOutputs: boolean;
}
/**
 * The attributes with the declined content removed, or `undefined` when there
 * was none to remove.
 *
 * The `undefined` return is what lets the caller forward the original span
 * untouched in the common case, so a destination that declined a direction the
 * span never carried costs one pass over its keys and no allocation.
 */
export declare function withoutDeclinedContent(attributes: Readonly<Record<string, unknown>>, content: ResolvedContentOptions): Record<string, unknown> | undefined;