Sources

Sources identify who created an event, which affects how the wisdom graph weighs and connects the resulting knowledge.

Source Types

agent

The AI agent itself produced this knowledge — a decision it made, a fact it learned, or an observation during processing. Most events use this source.

{ "source": "agent", "event_kind": "decision", "payload": { "topic": "database_choice", "value": "PostgreSQL" } }

user

Input from a human. Feedback, corrections, preferences, or direct instructions. User-sourced knowledge carries high trust weight in retrieval.

{ "source": "user", "event_kind": "feedback", "payload": { "topic": "response_quality", "value": "too verbose" } }

system

System-level events: lifecycle signals, configuration changes, health checks. Typically paired with routine or observation event kinds.

{ "source": "system", "event_kind": "routine", "payload": { "topic": "health_check", "value": "all services healthy" } }

validator

A runtime validator detected something — a constraint violation, a rule trigger, or a validation result. Events from validators often auto-create derived_from links.

{ "source": "validator", "event_kind": "constraint_violation", "payload": { "topic": "rate_limit", "value": "exceeded 1000 req/min" } }

executor

A task executor completed work. Use when a background job, pipeline step, or automated process finishes.

{ "source": "executor", "event_kind": "action", "payload": { "topic": "deployment", "value": "v2.3 deployed to production" } }

How Sources Affect the Graph

Sources influence two things:

1. Retrieval weight. User-sourced knowledge ranks higher by default. Agent and executor sources rank equally. System and validator sources rank lower unless specifically queried.

2. Link inference. The admission pipeline considers the source when auto-creating links. Validator events generate derived_from links. Agent decisions generate related_to links to recent context.

Next