type TracePrimitive = string | number | boolean;
type EnvReader = (name: string) => string | undefined;
/** Public API contract for a value can be used as an agent trace attribute. */
export type AgentTraceAttributeValue = TracePrimitive | readonly TracePrimitive[] | null | undefined;
/** Public API contract for agent trace attributes. */
export type AgentTraceAttributes = Record<string, AgentTraceAttributeValue>;
/** Public API contract for agent trace usage. */
export type AgentTraceUsage = {
    inputTokens?: number;
    outputTokens?: number;
    totalTokens?: number;
    cachedInputTokens?: number;
    cacheCreationInputTokens?: number;
    cacheReadInputTokens?: number;
    reasoningTokens?: number;
};
/** Check whether a value can be used as an agent trace attribute. */
export declare function isAgentTraceAttributeValue(value: unknown): value is AgentTraceAttributeValue;
/** Filter agent trace attributes. */
export declare function filterAgentTraceAttributes(attributes: Record<string, unknown>): AgentTraceAttributes;
/** Builds schedule trigger trace attributes from schedule forwarded props. */
export declare function buildScheduleTraceAttributes(forwardedProps?: Record<string, unknown>): AgentTraceAttributes;
/** Builds Datadog unified service trace attributes for a hosted project run. */
export declare function buildProjectServiceTraceAttributes(input: {
    projectSlug?: string | null;
    readEnv: EnvReader;
}): AgentTraceAttributes;
export declare function resolveGenAiProviderName(modelId: string | null | undefined): string | null;
/** Builds agent run trace attributes. */
export declare function buildAgentRunTraceAttributes(input: {
    operationName: "chat" | "invoke_agent";
    conversationId?: string;
    projectId?: string | null;
    userId: string;
    agentId: string;
    agentName?: string | null;
    modelId?: string | null;
    runId?: string | null;
    parentRunId?: string | null;
    parentConversationId?: string | null;
    messageId?: string | null;
    toolCallId?: string | null;
    scheduleId?: string | null;
    scheduleName?: string | null;
}): AgentTraceAttributes;
/** Builds execute tool trace attributes. */
export declare function buildExecuteToolTraceAttributes(input: {
    toolName: string;
    toolCallId?: string | null;
}): AgentTraceAttributes;
/** Builds invoke agent trace attributes. */
export declare function buildInvokeAgentTraceAttributes(input: {
    conversationId?: string;
    projectId?: string | null;
    runId?: string | null;
    toolCallId: string;
    childAgentId: string;
    childConversationId?: string | null;
    childRunId?: string | null;
    childMessageId?: string | null;
    sourceTargetKind?: string | null;
    runtimeTargetKind?: string | null;
    targetEnvironmentId?: string | null;
    targetBranchId?: string | null;
    status?: "completed" | "failed";
    usage?: AgentTraceUsage;
    terminalErrorCode?: string | null;
    terminalErrorMessage?: string | null;
}): AgentTraceAttributes;
/** Builds finalized agent run trace attributes. */
export declare function buildFinalizedAgentRunTraceAttributes(input: {
    status: "completed" | "failed" | "cancelled";
    modelId?: string | null;
    usage?: AgentTraceUsage;
    terminalErrorCode?: string | null;
    terminalErrorMessage?: string | null;
}): AgentTraceAttributes;
export {};
//# sourceMappingURL=trace-attributes.d.ts.map