Enum ContentSourceKind 

#[non_exhaustive]
pub enum ContentSourceKind {
    ToolResult,
    WebScrape,
    McpResponse,
    A2aMessage,
    MemoryRetrieval,
    InstructionFile,
}

All known content source categories.

Used for spotlighting annotation and future per-source config overrides. Each variant maps to a fixed ContentTrustLevel via default_trust_level.

Examples

use zeph_sanitizer::{ContentSourceKind, ContentTrustLevel};

assert_eq!(
    ContentSourceKind::ToolResult.default_trust_level(),
    ContentTrustLevel::LocalUntrusted
);
assert_eq!(
    ContentSourceKind::WebScrape.default_trust_level(),
    ContentTrustLevel::ExternalUntrusted
);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ToolResult

Output from a locally-executed tool (shell, file I/O).

WebScrape

Content fetched from a remote URL by the web-scrape tool.

McpResponse

Response from an MCP (Model Context Protocol) server.

A2aMessage

Message received from another agent via the A2A protocol.

MemoryRetrieval

Content retrieved from Qdrant/SQLite semantic memory.

Memory poisoning is a documented attack vector: an adversary can plant injection payloads in web content that gets stored, then recalled in future sessions.

InstructionFile

Project-level instruction files (.zeph/zeph.md, CLAUDE.md, etc.).

Treated as LocalUntrusted by default. Path-based trust inference (e.g. treating user-authored files as Trusted) is a Phase 2 concern.

Implementations

impl ContentSourceKind

pub fn default_trust_level(self) -> ContentTrustLevel

Returns the default ContentTrustLevel for this source kind.

Tool results and instruction files are LocalUntrusted; all network-sourced content (web scrape, MCP, A2A, memory retrieval) is ExternalUntrusted.

Examples

use zeph_sanitizer::{ContentSourceKind, ContentTrustLevel};

assert_eq!(ContentSourceKind::McpResponse.default_trust_level(), ContentTrustLevel::ExternalUntrusted);
assert_eq!(ContentSourceKind::InstructionFile.default_trust_level(), ContentTrustLevel::LocalUntrusted);

pub fn from_str_opt(s: &str) -> Option<ContentSourceKind>

Parse a &str into a ContentSourceKind.

Returns None for unrecognized strings so callers can log a warning and skip unknown values without breaking deserialization.

The comparison is case-sensitive and uses the canonical snake_case form (e.g. "web_scrape", not "WebScrape").

Examples

use zeph_sanitizer::ContentSourceKind;

assert_eq!(ContentSourceKind::from_str_opt("web_scrape"), Some(ContentSourceKind::WebScrape));
assert_eq!(ContentSourceKind::from_str_opt("WebScrape"), None); // case-sensitive
assert_eq!(ContentSourceKind::from_str_opt("unknown"), None);

Trait Implementations

impl Clone for ContentSourceKind

fn clone(&self) -> ContentSourceKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ContentSourceKind

impl Debug for ContentSourceKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentSourceKind

fn deserialize<__D>( __deserializer: __D, ) -> Result<ContentSourceKind, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContentSourceKind

impl Hash for ContentSourceKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ContentSourceKind

fn eq(&self, other: &ContentSourceKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ContentSourceKind

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContentSourceKind