feagi-api 0.0.8

FEAGI REST API layer with HTTP and ZMQ transport adapters
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

// Copyright 2025 Neuraville Inc.
// SPDX-License-Identifier: Apache-2.0

// Brain Region DTOs for V1 API
//
// These DTOs must match Python FastAPI response structures exactly.

use serde::{Deserialize, Serialize};
use utoipa::ToSchema;

/// Brain region information (summary)
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
#[schema(example = json!({
    "region_id": "visual_cortex",
    "name": "Visual Cortex",
    "region_type": "Sensory",
    "parent_id": "neocortex",
    "cortical_areas": ["v1", "v2", "v4"],
    "child_count": 3
}))]
pub struct BrainRegionSummary {
    /// Brain region ID
    pub region_id: String,

    /// Human-readable name
    pub name: String,

    /// Functional type (Sensory, Motor, Association, Custom)
    pub region_type: String,

    /// Parent region ID (if any)
    pub parent_id: Option<String>,

    /// List of cortical area IDs in this region
    pub cortical_areas: Vec<String>,

    /// Number of child regions
    pub child_count: usize,
}

/// Detailed brain region information
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
#[schema(example = json!({
    "region_id": "visual_cortex",
    "name": "Visual Cortex",
    "region_type": "Sensory",
    "parent_id": "neocortex",
    "cortical_areas": ["v1", "v2", "v4"],
    "child_regions": ["primary_visual", "secondary_visual"],
    "properties": {}
}))]
pub struct BrainRegionDetail {
    /// Brain region ID
    pub region_id: String,

    /// Human-readable name
    pub name: String,

    /// Functional type
    pub region_type: String,

    /// Parent region ID
    pub parent_id: Option<String>,

    /// Cortical areas in this region
    pub cortical_areas: Vec<String>,

    /// Child region IDs
    pub child_regions: Vec<String>,

    /// Additional properties
    pub properties: serde_json::Value,
}

/// Create brain region request
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
pub struct CreateBrainRegionRequest {
    /// Brain region ID
    pub region_id: String,

    /// Human-readable name
    pub name: String,

    /// Functional type
    pub region_type: String,

    /// Optional: Parent region ID
    #[serde(default)]
    pub parent_id: Option<String>,
}

/// List brain regions response
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
pub struct BrainRegionListResponse {
    /// List of brain regions
    pub brain_regions: Vec<BrainRegionSummary>,

    /// Total count
    pub total_count: usize,
}