@celestia-island/plana-types 0.1.0

package/src/mcp/philia.rs

@@ -0,0 +1,267 @@
+use serde_json::Value;
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct AgentRegistryEntry {
+    pub agent_type: String,
+    pub status: String,
+    pub mcp_tool_count: usize,
+    pub skill_count: usize,
+    pub mcp_tools: Vec<String>,
+    pub skills: Vec<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct AgentRegistryListResult {
+    pub agents: Vec<AgentRegistryEntry>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct McpToolDetail {
+    pub name: String,
+    pub description: String,
+    #[ts(type = "Record<string, unknown>")]
+    pub parameters: serde_json::Value,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct SkillDetail {
+    pub name: String,
+    pub description: String,
+    pub related_tools: Vec<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct AgentRegistryGetResult {
+    pub agent_type: String,
+    pub mcp_tools: Vec<McpToolDetail>,
+    pub skills: Vec<SkillDetail>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct DataStoreSaveResult {
+    pub key: String,
+    pub namespace: String,
+    pub store_key: String,
+    pub saved_at: String,
+    #[ts(type = "Record<string, unknown>")]
+    pub value: Value,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct DataStoreLoadResult {
+    pub key: String,
+    pub namespace: String,
+    pub store_key: String,
+    pub loaded_at: String,
+    #[ts(type = "Record<string, unknown>")]
+    pub value: Value,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct ContextPrepareResult {
+    pub episode_count: usize,
+    pub entity_count: usize,
+    pub relevant_nodes: usize,
+    pub summary: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryStoreResult {
+    pub node_id: String,
+    pub node_type: String,
+    pub text_preview: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryQueryItem {
+    pub node_type: String,
+    pub text: String,
+    pub score: f64,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryQueryResult {
+    pub query: String,
+    pub total: usize,
+    pub results: Vec<MemoryQueryItem>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryConsolidateResult {
+    pub episode_id: String,
+    pub linked_count: usize,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemorySubgraphEdge {
+    pub source_id: String,
+    pub target_id: String,
+    pub edge_type: String,
+    pub weight: f64,
+    #[ts(type = "Record<string, unknown> | null")]
+    pub metadata: Option<serde_json::Map<String, Value>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryNodeFull {
+    pub id: String,
+    pub node_type: String,
+    pub text: String,
+    pub score: f64,
+    pub tags: Vec<String>,
+    pub created_at: Option<String>,
+    pub source: Option<String>,
+    #[ts(type = "Record<string, unknown> | null")]
+    pub metadata: Option<serde_json::Map<String, Value>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemorySubgraphResult {
+    pub query: String,
+    pub total_nodes: usize,
+    pub total_edges: usize,
+    pub nodes: Vec<MemoryNodeFull>,
+    pub edges: Vec<MemorySubgraphEdge>,
+}
+
+// ── Tool parameter structs (for .d.ts API signature generation) ──
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryStoreParams {
+    pub text: String,
+    pub node_type: String,
+    pub entity_type: Option<String>,
+    pub source_episode_id: Option<String>,
+    pub related_node_ids: Option<Vec<String>>,
+    pub properties: Option<std::collections::HashMap<String, String>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryQueryParams {
+    pub query: String,
+    pub limit: Option<u64>,
+    pub graph_depth: Option<u64>,
+    pub node_type_filter: Option<String>,
+    pub subgraph: Option<bool>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct MemoryConsolidateParams {
+    pub episode_focus: String,
+    pub node_ids: Vec<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct ContextPrepareParams {
+    pub query: String,
+    pub max_nodes: Option<u64>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct TimeseriesQueryParams {
+    pub metric: String,
+    pub start_time: Option<i64>,
+    pub end_time: Option<i64>,
+    pub include_stats: Option<bool>,
+    pub limit: Option<u64>,
+    pub tags: Option<std::collections::HashMap<String, String>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct DataQualityCheckParams {
+    pub metric: String,
+    pub expected_interval_ms: Option<u64>,
+    pub stale_threshold_ms: Option<u64>,
+    pub z_score_threshold: Option<f64>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct ToolSchemaGetParams {
+    pub agent_type: String,
+    pub tool_name: String,
+}
+
+// ── Tool result structs for timeseries / registry tools ──
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct ToolSchemaGetResult {
+    pub agent_type: String,
+    pub tool_name: String,
+    pub declaration: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct TimeseriesPointResult {
+    pub timestamp: i64,
+    pub value: f64,
+    pub tags: std::collections::HashMap<String, String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct QueryStats {
+    pub min: f64,
+    pub max: f64,
+    pub mean: f64,
+    pub std_dev: f64,
+    pub p50: f64,
+    pub p95: f64,
+    pub p99: f64,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct TimeseriesQueryResult {
+    pub metric: String,
+    pub points: Vec<TimeseriesPointResult>,
+    pub stats: Option<QueryStats>,
+    pub count: usize,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct GapInfo {
+    pub start_time: i64,
+    pub end_time: i64,
+    pub estimated_missing: usize,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/philia.ts")]
+pub struct QualityReport {
+    pub metric: String,
+    pub total_points: usize,
+    pub completeness: f64,
+    pub expected_points: usize,
+    pub missing_points: usize,
+    pub duplicate_points: usize,
+    pub stale_points: usize,
+    pub outlier_count: usize,
+    pub outlier_ratio: f64,
+    pub gaps: Vec<GapInfo>,
+    pub score: f64,
+}

package/src/mcp/polemos.rs

@@ -0,0 +1,241 @@
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeInfo {
+    pub id: String,
+    pub name: String,
+    pub address: String,
+    pub status: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeDiscoverResult {
+    pub host: String,
+    pub port: u16,
+    pub node_id: Option<String>,
+    pub total_nodes: usize,
+    pub status: String,
+    pub nodes: Vec<NodeInfo>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeConnectResult {
+    pub node_id: String,
+    pub node_name: String,
+    pub address: String,
+    pub status: String,
+    pub last_seen: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeExecuteResult {
+    pub node_id: String,
+    pub node_name: String,
+    pub host: String,
+    pub command: String,
+    pub exit_code: Option<i64>,
+    pub stdout: String,
+    pub stderr: String,
+    pub status: String,
+}
+
+// ── Tool parameter structs (for .d.ts API signature generation) ──
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeDiscoverParams {
+    pub auto_register: Option<bool>,
+    pub host: Option<String>,
+    pub port: Option<u16>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeConnectParams {
+    pub node_id: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeExecuteParams {
+    pub node_id: String,
+    pub command: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct ProtocolProbeParams {
+    pub host: String,
+    pub ports: Option<Vec<u64>>,
+    pub protocols: Option<Vec<String>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct DeviceSelfTestParams {
+    pub host: String,
+    pub device_id: Option<String>,
+    pub modbus_port: Option<u64>,
+    pub mqtt_port: Option<u64>,
+    pub http_port: Option<u64>,
+    pub skip_adaptive: Option<bool>,
+    pub register_ranges: Option<Vec<String>>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct EmptyParams {}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeTerminalOpenParams {
+    pub node_id: String,
+    pub cols: Option<u64>,
+    pub rows: Option<u64>,
+    pub shell: Option<String>,
+    pub session_id: Option<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeTerminalWriteParams {
+    pub session_id: String,
+    pub data: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeTerminalResizeParams {
+    pub session_id: String,
+    pub cols: u64,
+    pub rows: u64,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeTerminalCloseParams {
+    pub session_id: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeFileListParams {
+    pub node_id: String,
+    pub path: Option<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeFileDownloadParams {
+    pub node_id: String,
+    pub remote_path: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeFileUploadParams {
+    pub node_id: String,
+    pub remote_path: String,
+    pub data_base64: String,
+    pub mode: Option<String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct NodeScreenOfferParams {
+    pub node_id: String,
+}
+
+// ── Tool result structs (network tools) ──
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct ProtocolProbeResult {
+    pub host: String,
+    pub port: u16,
+    pub protocol: String,
+    pub confidence: f64,
+    pub banner: String,
+    pub details: std::collections::HashMap<String, String>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct ProtocolProbeResponse {
+    pub host: String,
+    pub probes: Vec<ProtocolProbeResult>,
+    pub total_found: usize,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct KneeJerkTest {
+    pub test_name: String,
+    pub protocol: String,
+    pub passed: bool,
+    pub latency_ms: u64,
+    pub detail: String,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct DeviceRegisterRangeResult {
+    pub start: u16,
+    pub end: u16,
+    pub function_code: u8,
+    pub bytes_readable: u16,
+    pub success: bool,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct AdaptiveProbeResult {
+    pub register_range: String,
+    pub function_codes_tested: Vec<u8>,
+    pub readable_ranges: Vec<DeviceRegisterRangeResult>,
+    pub latency_avg_ms: u64,
+    pub latency_max_ms: u64,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct DeviceCapability {
+    pub protocols: Vec<String>,
+    pub register_maps: Vec<DeviceRegisterRangeResult>,
+    pub estimated_device_type: String,
+    pub function_codes_supported: Vec<u8>,
+    pub max_latency_ms: u64,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct Phase1Result {
+    pub tests_run: usize,
+    pub tests_passed: usize,
+    pub tests_failed: usize,
+    pub results: Vec<KneeJerkTest>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct Phase2Result {
+    pub register_ranges_scanned: usize,
+    pub function_codes_probed: Vec<u8>,
+    pub readable_registers: usize,
+    pub probe_results: Vec<AdaptiveProbeResult>,
+}
+
+#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, ts_rs::TS)]
+#[ts(export, export_to = "mcp/polemos.ts")]
+pub struct DeviceSelfTestResponse {
+    pub device_id: String,
+    pub host: String,
+    pub overall_status: String,
+    pub phase1_self_sensing: Phase1Result,
+    pub phase2_adaptive: Phase2Result,
+    pub capability_profile: DeviceCapability,
+    pub registered_to_node_graph: bool,
+    pub timestamp: String,
+}