traceforge-toolkit 0.1.0__py3-none-any.whl

traceforge/mappings/crewai.yaml

@@ -0,0 +1,592 @@
+# CrewAI event mapping for MappedJsonAdapter
+# Targets: crewai >= 1.0.0 (crewai_event_bus with BaseEventListener)
+# Source: crewAIInc/crewAI lib/crewai/src/crewai/events/
+#
+# CrewAI 1.x ships a full event bus (crewai_event_bus) with 60+ typed events.
+# All events inherit from BaseEvent which provides:
+#   type (Literal[...]), timestamp, event_id, parent_event_id, previous_event_id,
+#   triggered_by_event_id, emission_sequence, source_fingerprint, source_type,
+#   fingerprint_metadata, task_id, task_name, agent_id, agent_role
+#
+# Events are subscribed via BaseEventListener + @on(EventType) decorator.
+# The event bus is a singleton: `from crewai.events import crewai_event_bus`
+#
+# NOTE: crewAI-inc/crewAI (hyphenated, 0.86) is a FROZEN FORK.
+# The active repo is crewAIInc/crewAI (capital Inc) at 1.10+.
+
+framework: crewai
+framework_version: ">=1.0.0"
+ingestion_mode: file_watch
+type_field: type
+timestamp_field: timestamp
+
+motivation:
+  sources:
+    - events: ["llm_call_completed"]
+      field: output
+      role: intent
+    - events: ["llm_thinking_chunk"]
+      field: content
+      role: reasoning
+    - events: ["agent_reasoning_completed"]
+      field: plan
+      role: reasoning
+
+events:
+  # ── Flow lifecycle (lib/crewai/src/crewai/events/types/flow_events.py) ──
+  flow_created:
+    kind: workflow.created
+    payload:
+      flow_name: flow_name
+  flow_started:
+    kind: workflow.started
+    payload:
+      flow_name: flow_name
+      inputs: inputs
+  flow_finished:
+    kind: workflow.completed
+    payload:
+      flow_name: flow_name
+      result: result
+      state: state
+  flow_paused:
+    kind: workflow.paused
+    payload:
+      flow_name: flow_name
+  method_execution_started:
+    kind: task.started
+    payload:
+      flow_name: flow_name
+      task_name: method_name
+      state: state
+      params: params
+  method_execution_finished:
+    kind: task.completed
+    payload:
+      flow_name: flow_name
+      task_name: method_name
+      result: result
+      state: state
+  method_execution_failed:
+    kind: task.failed
+    payload:
+      flow_name: flow_name
+      task_name: method_name
+      error: error
+  method_execution_paused:
+    kind: task.paused
+    payload:
+      flow_name: flow_name
+      task_name: method_name
+
+  # ── Crew lifecycle ──
+  crew_kickoff_started:
+    kind: session.started
+    payload:
+      crew_name: crew_name
+      event_id: event_id
+  crew_kickoff_completed:
+    kind: session.ended
+    payload:
+      crew_name: crew_name
+      output: output
+  crew_kickoff_failed:
+    kind: session.error
+    payload:
+      crew_name: crew_name
+      error: error
+
+  # ── Agent execution ──
+  agent_execution_started:
+    kind: agent.spawned
+    payload:
+      agent_id: agent_id
+      agent_role: agent_role
+      task_name: task_name
+  agent_execution_completed:
+    kind: agent.completed
+    payload:
+      agent_id: agent_id
+      agent_role: agent_role
+      output: output
+  agent_execution_error:
+    kind: agent.failed
+    payload:
+      agent_id: agent_id
+      agent_role: agent_role
+      error: error
+
+  # ── Task lifecycle ──
+  task_started:
+    kind: task.started
+    payload:
+      task_id: task_id
+      task_name: task_name
+      agent_role: agent_role
+  task_completed:
+    kind: task.completed
+    payload:
+      task_id: task_id
+      task_name: task_name
+      output: output
+  task_failed:
+    kind: task.failed
+    payload:
+      task_id: task_id
+      task_name: task_name
+      error: error
+
+  # ── Tool usage ──
+  tool_usage_started:
+    kind: tool.call.started
+    payload:
+      tool_name: tool_name
+      tool_call_id: event_id
+      arguments: tool_args
+  tool_usage_finished:
+    kind: tool.call.completed
+    payload:
+      tool_name: tool_name
+      result: output
+  tool_usage_error:
+    kind: tool.call.failed
+    payload:
+      tool_name: tool_name
+      error: error
+
+  # ── LLM calls ──
+  llm_call_started:
+    kind: llm.call.started
+    payload:
+      model: model
+      agent_role: agent_role
+      event_id: event_id
+  llm_call_completed:
+    kind: llm.call.completed
+    payload:
+      model: model
+      output: response
+      input_tokens: usage.prompt_tokens
+      output_tokens: usage.completion_tokens
+  llm_call_failed:
+    kind: llm.call.failed
+    payload:
+      model: model
+      error: error
+  llm_stream_chunk:
+    kind: llm.output.chunk
+    payload:
+      content: chunk
+
+  # ── Memory operations ──
+  memory_save_started:
+    kind: memory.save.started
+    payload:
+      event_id: event_id
+  memory_save_completed:
+    kind: memory.save.completed
+    payload:
+      event_id: event_id
+  memory_query_started:
+    kind: memory.query.started
+    payload:
+      event_id: event_id
+  memory_query_completed:
+    kind: memory.query.completed
+    payload:
+      event_id: event_id
+
+  # ── Knowledge retrieval ──
+  knowledge_search_query_started:
+    kind: knowledge.query.started
+    payload:
+      event_id: event_id
+  knowledge_search_query_completed:
+    kind: knowledge.query.completed
+    payload:
+      event_id: event_id
+
+  # ── MCP connections ──
+  mcp_connection_started:
+    kind: mcp.connection.started
+    payload:
+      event_id: event_id
+  mcp_connection_completed:
+    kind: mcp.connection.completed
+    payload:
+      event_id: event_id
+  mcp_connection_failed:
+    kind: mcp.connection.failed
+    payload:
+      error: error
+  mcp_tool_execution_started:
+    kind: mcp.tool.started
+    payload:
+      event_id: event_id
+  mcp_tool_execution_completed:
+    kind: mcp.tool.completed
+    payload:
+      event_id: event_id
+  mcp_tool_execution_failed:
+    kind: mcp.tool.failed
+    payload:
+      error: error
+
+  # ── Human feedback / conversation ──
+  flow_input_requested:
+    kind: input.requested
+    payload:
+      flow_name: flow_name
+  flow_input_received:
+    kind: input.received
+    payload:
+      flow_name: flow_name
+  human_feedback_requested:
+    kind: input.requested
+    payload:
+      event_id: event_id
+  human_feedback_received:
+    kind: input.received
+    payload:
+      event_id: event_id
+  conversation_message_added:
+    kind: message.user
+    payload:
+      event_id: event_id
+
+  # ── Checkpoints ──
+  checkpoint_started:
+    kind: checkpoint.started
+    payload:
+      event_id: event_id
+  checkpoint_completed:
+    kind: checkpoint.created
+    payload:
+      event_id: event_id
+  checkpoint_failed:
+    kind: checkpoint.failed
+    payload:
+      event_id: event_id
+      error: error
+  checkpoint_pruned:
+    kind: checkpoint.pruned
+    payload:
+      event_id: event_id
+  checkpoint_fork_started:
+    kind: checkpoint.fork.started
+    payload:
+      event_id: event_id
+  checkpoint_fork_completed:
+    kind: checkpoint.fork.completed
+    payload:
+      event_id: event_id
+  checkpoint_restore_started:
+    kind: checkpoint.restore.started
+    payload:
+      event_id: event_id
+  checkpoint_restore_completed:
+    kind: checkpoint.restore.completed
+    payload:
+      event_id: event_id
+  checkpoint_restore_failed:
+    kind: checkpoint.restore.failed
+    payload:
+      event_id: event_id
+      error: error
+
+  # ── Crew training/testing ──
+  crew_train_started:
+    kind: session.started
+    payload:
+      crew_name: crew_name
+  crew_train_completed:
+    kind: session.ended
+    payload:
+      crew_name: crew_name
+  crew_train_failed:
+    kind: session.error
+    payload:
+      crew_name: crew_name
+      error: error
+  crew_test_started:
+    kind: session.started
+    payload:
+      crew_name: crew_name
+  crew_test_completed:
+    kind: session.ended
+    payload:
+      crew_name: crew_name
+  crew_test_failed:
+    kind: session.error
+    payload:
+      crew_name: crew_name
+      error: error
+  crew_test_result:
+    kind: session.info
+    payload:
+      crew_name: crew_name
+      event_id: event_id
+
+  # ── Lite agent execution ──
+  lite_agent_execution_started:
+    kind: agent.spawned
+    payload:
+      agent_id: agent_id
+      agent_role: agent_role
+  lite_agent_execution_completed:
+    kind: agent.completed
+    payload:
+      agent_id: agent_id
+      output: output
+  lite_agent_execution_error:
+    kind: agent.failed
+    payload:
+      agent_id: agent_id
+      error: error
+
+  # ── Agent evaluation ──
+  agent_evaluation_started:
+    kind: agent.evaluation.started
+    payload:
+      agent_id: agent_id
+      event_id: event_id
+  agent_evaluation_completed:
+    kind: agent.evaluation.completed
+    payload:
+      agent_id: agent_id
+      event_id: event_id
+  agent_evaluation_failed:
+    kind: agent.evaluation.failed
+    payload:
+      agent_id: agent_id
+      error: error
+
+  # ── Agent reasoning ──
+  agent_reasoning_started:
+    kind: reasoning.started
+    payload:
+      agent_id: agent_id
+      event_id: event_id
+  agent_reasoning_completed:
+    kind: reasoning.completed
+    payload:
+      agent_id: agent_id
+      event_id: event_id
+      plan: plan
+  agent_reasoning_failed:
+    kind: reasoning.failed
+    payload:
+      agent_id: agent_id
+      error: error
+
+  # ── Tool errors (granular) ──
+  tool_validate_input_error:
+    kind: tool.validation.failed
+    payload:
+      tool_name: tool_name
+      error: error
+  tool_selection_error:
+    kind: tool.call.failed
+    payload:
+      error: error
+  tool_execution_error:
+    kind: tool.call.failed
+    payload:
+      tool_name: tool_name
+      error: error
+
+  # ── Memory failures ──
+  memory_save_failed:
+    kind: memory.save.failed
+    payload:
+      event_id: event_id
+      error: error
+  memory_query_failed:
+    kind: memory.query.failed
+    payload:
+      event_id: event_id
+      error: error
+  memory_retrieval_started:
+    kind: memory.query.started
+    payload:
+      event_id: event_id
+  memory_retrieval_completed:
+    kind: memory.query.completed
+    payload:
+      event_id: event_id
+  memory_retrieval_failed:
+    kind: memory.query.failed
+    payload:
+      event_id: event_id
+      error: error
+
+  # ── Knowledge failures ──
+  knowledge_query_started:
+    kind: knowledge.query.started
+    payload:
+      event_id: event_id
+  knowledge_query_completed:
+    kind: knowledge.query.completed
+    payload:
+      event_id: event_id
+  knowledge_query_failed:
+    kind: knowledge.query.failed
+    payload:
+      event_id: event_id
+      error: error
+  knowledge_search_query_failed:
+    kind: knowledge.query.failed
+    payload:
+      event_id: event_id
+      error: error
+
+  # ── LLM guardrails ──
+  llm_thinking_chunk:
+    kind: reasoning.chunk
+    payload:
+      content: chunk
+  llm_guardrail_started:
+    kind: guardrail.started
+    payload:
+      event_id: event_id
+  llm_guardrail_completed:
+    kind: guardrail.passed
+    payload:
+      event_id: event_id
+
+  # ── MCP config failure ──
+  mcp_config_fetch_failed:
+    kind: mcp.connection.failed
+    payload:
+      error: error
+
+  # ── Task evaluation ──
+  task_evaluation:
+    kind: task.evaluation
+    payload:
+      task_id: task_id
+      event_id: event_id
+
+  # ── Observation/planning events ──
+  step_observation_started:
+    kind: task.observation.started
+    payload:
+      event_id: event_id
+  step_observation_completed:
+    kind: task.observation.completed
+    payload:
+      event_id: event_id
+  step_observation_failed:
+    kind: task.observation.failed
+    payload:
+      event_id: event_id
+      error: error
+  plan_refinement:
+    kind: planning.updated
+    payload:
+      event_id: event_id
+  plan_replan_triggered:
+    kind: planning.restarted
+    payload:
+      event_id: event_id
+  goal_achieved_early:
+    kind: session.ended
+    payload:
+      event_id: event_id
+
+  # ── Flow routing ──
+  flow_plot:
+    kind: workflow.info
+    payload:
+      flow_name: flow_name
+  conversation_route_selected:
+    kind: workflow.routed
+    payload:
+      flow_name: flow_name
+      event_id: event_id
+
+  # ── Agent logging ──
+  agent_logs_started:
+    kind: agent.log.started
+    payload:
+      event_id: event_id
+  agent_logs_execution:
+    kind: agent.log.entry
+    payload:
+      event_id: event_id
+
+  # ── Plan step lifecycle (#41: sibling to step_observation_*) ──
+  plan_step_started:
+    kind: planning.step.started
+    payload:
+      event_id: event_id
+  plan_step_completed:
+    kind: planning.step.completed
+    payload:
+      event_id: event_id
+      success: success
+      result: result
+      error: error
+
+  # ── Skill system lifecycle (#41) ──
+  skill_discovery_started:
+    kind: skill.discovery.started
+    payload:
+      event_id: event_id
+  skill_discovery_completed:
+    kind: skill.discovery.completed
+    payload:
+      event_id: event_id
+  skill_loaded:
+    kind: skill.loaded
+    payload:
+      event_id: event_id
+  skill_activated:
+    kind: skill.activated
+    payload:
+      event_id: event_id
+  skill_load_failed:
+    kind: skill.load.failed
+    payload:
+      event_id: event_id
+      error: error
+
+  # ── A2A (agent-to-agent) protocol (#41/#32) ──
+  a2a_delegation_started:
+    kind: agent.delegation.started
+    payload:
+      event_id: event_id
+  a2a_delegation_completed:
+    kind: agent.delegation.completed
+    payload:
+      event_id: event_id
+  a2a_conversation_started:
+    kind: agent.conversation.started
+    payload:
+      event_id: event_id
+  a2a_conversation_completed:
+    kind: agent.conversation.completed
+    payload:
+      event_id: event_id
+  a2a_message_sent:
+    kind: agent.message.sent
+    payload:
+      event_id: event_id
+  a2a_response_received:
+    kind: agent.message.received
+    payload:
+      event_id: event_id
+  a2a_artifact_received:
+    kind: agent.artifact.received
+    payload:
+      event_id: event_id
+  a2a_connection_error:
+    kind: agent.connection.failed
+    payload:
+      event_id: event_id
+      error: error
+  a2a_authentication_failed:
+    kind: agent.authentication.failed
+    payload:
+      event_id: event_id
+      error: error

traceforge/mappings/goose.yaml

@@ -0,0 +1,128 @@
+# Goose event mapping for MappedJsonAdapter
+# Targets: goose >= 1.0 (SQLite messages table, JSON-serialized rows)
+# Source: block/goose crates/goose-providers/src/conversation/message.rs
+#
+# IMPORTANT: Real Goose only has TWO role values: "user" and "assistant".
+# Tool calls are NESTED inside content_json as {"type": "toolRequest", ...}
+# items within the assistant message array. They are NOT separate rows.
+# Tool results are {"type": "toolResponse", ...} nested in user messages.
+#
+# The flat type_field: role approach can ONLY distinguish user/assistant.
+# A GoosePreProcessor is needed to extract nested tool calls into separate events.
+#
+# Real schema: messages table columns:
+#   id, message_id, session_id, role, content_json, created_timestamp,
+#   timestamp, tokens, metadata_json
+# Session table has: total_tokens, input_tokens, output_tokens,
+#   accumulated_total_tokens, accumulated_input_tokens, accumulated_output_tokens,
+#   accumulated_cost
+#
+# MessageContent variants (all in content_json array, serde tag="type" camelCase):
+#   text, image, toolRequest, toolResponse, toolConfirmationRequest,
+#   actionRequired, frontendToolRequest, thinking, redactedThinking,
+#   systemNotification
+#
+# Struct field serialization:
+#   ToolRequest: {type, id, toolCall: {status, value: {name, arguments}}}
+#   ToolResponse: {type, id, toolResult: {status, value: {content: [...]}}}
+#   ToolConfirmationRequest: {type, id, toolName, arguments, prompt}
+#   FrontendToolRequest: {type, id, toolCall: {status, value: {name, arguments}}}
+#   ActionRequired: {type, data: {actionType: "elicitation"|"toolConfirmation"|"elicitationResponse", ...}}
+#   SystemNotification: {type, notificationType, msg, data}
+
+framework: goose
+framework_version: ">=1.0"
+ingestion_mode: poll
+type_field: role
+timestamp_field: created_timestamp
+preprocessor: goose
+
+motivation:
+  sources:
+    - events: ["assistant"]
+      field: content
+      role: intent
+    - events: ["thinking"]
+      field: content
+      role: reasoning
+
+events:
+  # ── REAL messages (preprocessor extracts text from content_json) ──
+  user:
+    kind: message.user
+    payload:
+      content: content
+  assistant:
+    kind: message.assistant
+    payload:
+      content: content
+
+  # ── Tool events (preprocessor extracts from nested content_json) ──
+  tool_use:
+    kind: tool.call.started
+    payload:
+      tool_name: name
+      tool_call_id: id
+      arguments: input
+  tool_result:
+    kind: tool.call.completed
+    payload:
+      tool_call_id: tool_use_id
+      result: content
+      success: is_success
+
+  # ── Additional MessageContent variants (preprocessor extracts from content_json) ──
+  thinking:
+    kind: reasoning.started
+    payload:
+      content: thinking
+  image:
+    kind: message.attachment
+    payload:
+      content: data
+  tool_confirmation_request:
+    kind: permission.requested
+    payload:
+      content: content
+      tool_name: name
+  action_required:
+    kind: input.requested
+    payload:
+      content: content
+      action_type: action_type
+  frontend_tool_request:
+    kind: tool.call.started
+    payload:
+      tool_name: name
+      tool_call_id: id
+      arguments: input
+  redacted_thinking:
+    kind: reasoning.redacted
+    payload:
+      data: data
+  system_notification:
+    kind: session.info
+    payload:
+      message: content
+
+  # ── Session lifecycle (from poll metadata) ──
+  session_start:
+    kind: session.started
+    payload:
+      model: model
+      provider: provider
+  session_end:
+    kind: session.ended
+    payload:
+      reason: reason
+
+  # ── Usage/cost (from session table aggregates) ──
+  usage:
+    kind: telemetry.usage
+    payload:
+      input_tokens: input_tokens
+      output_tokens: output_tokens
+      cache_read_tokens: cache_read_tokens
+      cache_write_tokens: cache_write_tokens
+      cost_usd: cost_usd
+      model: model