cpex-core 0.2.2

CPEX plugin runtime core — PluginManager, executor, hooks, and config.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

// Location: ./crates/cpex-core/src/extensions/meta.rs
// Copyright 2025
// SPDX-License-Identifier: Apache-2.0
// Authors: Teryl Taylor
//
// MetaExtension — host-provided operational metadata.
// Mirrors cpex/framework/extensions/meta.py.

use std::collections::{HashMap, HashSet};

use serde::{Deserialize, Serialize};

/// Host-provided operational metadata.
///
/// Carries entity identification (type + name) for route resolution,
/// operational tags for policy group inheritance, scope for
/// host-defined grouping, and arbitrary properties.
///
/// Immutable — set by the host before invoking the hook. Plugins
/// can read but not modify.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct MetaExtension {
    /// Entity type: "tool", "resource", "prompt", "llm".
    /// Used by the manager for route resolution.
    #[serde(default)]
    pub entity_type: Option<String>,

    /// Entity name: "get_compensation", "hr://employees/*", etc.
    /// Used by the manager for route resolution.
    #[serde(default)]
    pub entity_name: Option<String>,

    /// Operational tags — drive policy group inheritance.
    /// Merged with static tags from the matching route's `meta.tags`.
    #[serde(default)]
    pub tags: HashSet<String>,

    /// Host-defined grouping (virtual server ID, namespace, etc.).
    #[serde(default)]
    pub scope: Option<String>,

    /// Arbitrary key-value metadata.
    #[serde(default)]
    pub properties: HashMap<String, String>,
}