fix(ai-sdk): improve and align attributes with gen-ai semantic-conventions

Author: galkleinman

packages/ai-semantic-conventions/src/SemanticAttributes.ts

@@ -15,22 +15,68 @@
  */
 
 export const SpanAttributes = {
+  // OpenTelemetry GenAI Semantic Conventions (Current)
+  // Required attributes
+  GEN_AI_OPERATION_NAME: "gen_ai.operation.name",
+  GEN_AI_PROVIDER_NAME: "gen_ai.provider.name",
+
+  // Request attributes
+  GEN_AI_REQUEST_MODEL: "gen_ai.request.model",
+  GEN_AI_REQUEST_TEMPERATURE: "gen_ai.request.temperature",
+  GEN_AI_REQUEST_TOP_P: "gen_ai.request.top_p",
+  GEN_AI_REQUEST_TOP_K: "gen_ai.request.top_k",
+  GEN_AI_REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens",
+  GEN_AI_REQUEST_FREQUENCY_PENALTY: "gen_ai.request.frequency_penalty",
+  GEN_AI_REQUEST_PRESENCE_PENALTY: "gen_ai.request.presence_penalty",
+  GEN_AI_REQUEST_STOP_SEQUENCES: "gen_ai.request.stop_sequences",
+
+  // Response attributes
+  GEN_AI_RESPONSE_ID: "gen_ai.response.id",
+  GEN_AI_RESPONSE_MODEL: "gen_ai.response.model",
+  GEN_AI_RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons",
+
+  // Token usage (Current OTel naming)
+  GEN_AI_USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+  GEN_AI_USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+
+  // Messages
+  GEN_AI_INPUT_MESSAGES: "gen_ai.input.messages",
+  GEN_AI_OUTPUT_MESSAGES: "gen_ai.output.messages",
+  GEN_AI_SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions",
+
+  // Tool definitions
+  GEN_AI_TOOL_DEFINITIONS: "gen_ai.tool.definitions",
+
+  // Agent attributes
+  GEN_AI_AGENT_NAME: "gen_ai.agent.name",
+
+  // Deprecated attributes (kept for backward compatibility)
+  /** @deprecated Use GEN_AI_PROVIDER_NAME instead */
   LLM_SYSTEM: "gen_ai.system",
+  /** @deprecated Use GEN_AI_REQUEST_MODEL instead */
   LLM_REQUEST_MODEL: "gen_ai.request.model",
+  /** @deprecated Use GEN_AI_REQUEST_MAX_TOKENS instead */
   LLM_REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens",
+  /** @deprecated Use GEN_AI_REQUEST_TEMPERATURE instead */
   LLM_REQUEST_TEMPERATURE: "gen_ai.request.temperature",
+  /** @deprecated Use GEN_AI_REQUEST_TOP_P instead */
   LLM_REQUEST_TOP_P: "gen_ai.request.top_p",
+  /** @deprecated Use GEN_AI_INPUT_MESSAGES and events instead */
   LLM_PROMPTS: "gen_ai.prompt",
+  /** @deprecated Use GEN_AI_OUTPUT_MESSAGES and events instead */
   LLM_COMPLETIONS: "gen_ai.completion",
+  /** @deprecated Use GEN_AI_INPUT_MESSAGES instead */
   LLM_INPUT_MESSAGES: "gen_ai.input.messages",
+  /** @deprecated Use GEN_AI_OUTPUT_MESSAGES instead */
   LLM_OUTPUT_MESSAGES: "gen_ai.output.messages",
+  /** @deprecated Use GEN_AI_RESPONSE_MODEL instead */
   LLM_RESPONSE_MODEL: "gen_ai.response.model",
+  /** @deprecated Use GEN_AI_USAGE_INPUT_TOKENS instead */
   LLM_USAGE_PROMPT_TOKENS: "gen_ai.usage.prompt_tokens",
+  /** @deprecated Use GEN_AI_USAGE_OUTPUT_TOKENS instead */
   LLM_USAGE_COMPLETION_TOKENS: "gen_ai.usage.completion_tokens",
 
-  GEN_AI_AGENT_NAME: "gen_ai.agent.name",
-
-  // LLM
+  // LLM (Non-standard attributes)
   LLM_REQUEST_TYPE: "llm.request.type",
   LLM_USAGE_TOTAL_TOKENS: "llm.usage.total_tokens",
   LLM_TOP_K: "llm.top_k",