apcore 0.19.0

Schema-driven module standard for AI-perceivable interfaces
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

// APCore Protocol — Schema module
// Spec reference: Schema loading, validation, export, and reference resolution

pub mod exporter;
pub mod loader;
pub mod ref_resolver;
pub mod strict;
pub mod validator;

pub use exporter::{ExportOptions, ExportProfile, SchemaExporter};
pub use loader::{SchemaLoader, SchemaStrategy};
pub use ref_resolver::RefResolver;
pub use strict::to_strict_schema;
pub use validator::SchemaValidator;

use serde::{Deserialize, Serialize};

/// A structured schema definition for a module.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SchemaDefinition {
    /// The module this schema belongs to.
    pub module_id: String,
    /// Human-readable description of the schema.
    pub description: String,
    /// JSON Schema for the module's input.
    pub input_schema: serde_json::Value,
    /// JSON Schema for the module's output.
    pub output_schema: serde_json::Value,
    /// Optional JSON Schema for the module's error output.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error_schema: Option<serde_json::Value>,
    /// Optional reusable schema definitions (e.g. $defs / definitions).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub definitions: Option<serde_json::Value>,
    /// Optional schema version string.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub version: Option<String>,
}