@celestia-island/plana-types 0.1.0

package/src/ws/agent/layer2.rs

@@ -0,0 +1,126 @@
+//! Layer-2 / custom agent registry types.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2AgentInfo {
+    pub name: String,
+    pub description: String,
+    pub mcp_count: usize,
+    pub skills_count: usize,
+    pub languages: Vec<String>,
+    pub enabled: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2AgentListResponseParams {
+    pub agents: Vec<Layer2AgentInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2McpToolInfo {
+    pub name: String,
+    pub description: String,
+    pub languages: Vec<String>,
+    pub references_layer1: Vec<String>,
+    pub references_layer2: Vec<String>,
+    pub related_items: Vec<String>,
+    pub referenced_by_items: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2AgentMcpResponseParams {
+    pub agent_name: String,
+    pub tools: Vec<Layer2McpToolInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2SkillInfo {
+    pub name: String,
+    pub description: String,
+    pub languages: Vec<String>,
+    pub references_layer1: Vec<String>,
+    pub references_layer2: Vec<String>,
+    pub related_items: Vec<String>,
+    pub referenced_by_items: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2AgentSkillsResponseParams {
+    pub agent_name: String,
+    pub skills: Vec<Layer2SkillInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2McpPromptResponseParams {
+    pub agent_name: String,
+    pub tool: String,
+    pub lang: String,
+    pub content: String,
+    pub name: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct Layer2SkillPromptResponseParams {
+    pub agent_name: String,
+    pub skill: String,
+    pub lang: String,
+    pub content: String,
+    pub name: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct CustomAgentInfo {
+    pub name: String,
+    pub display_name: String,
+    pub description: String,
+    pub skills_count: usize,
+    pub source: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub version: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub last_updated: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct CustomAgentListResponseParams {
+    pub agents: Vec<CustomAgentInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct SubscribeCustomAgentResponseParams {
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub agent: Option<CustomAgentInfo>,
+    #[serde(default)]
+    pub skills: Vec<String>,
+    #[serde(default)]
+    pub permissions: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/layer2.ts")]
+pub struct UnsubscribeCustomAgentResponseParams {
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}

package/src/ws/agent/mod.rs

@@ -0,0 +1,9 @@
+//! Agent runtime & orchestration message params — lifecycle streaming,
+//! task management, state snapshots, the YOLO autonomous loop, and the
+//! layer-2 / custom-agent registry.
+
+pub mod agent_lifecycle;
+pub mod layer2;
+pub mod state_sync;
+pub mod tasks;
+pub mod yolo;

package/src/ws/agent/state_sync.rs

@@ -0,0 +1,111 @@
+//! State sync / snapshots — global, container, and task snapshots.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use crate::{AgentBadge, ContainerStatus, TaskStatus, TuiAgentInfo};
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct ContainerInfo {
+    pub id: String,
+    pub name: String,
+    pub status: ContainerStatus,
+    pub cpu_usage: f64,
+    pub memory_mb: u64,
+    #[serde(default)]
+    pub image: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub agent_type: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub parent_id: Option<String>,
+    #[serde(default)]
+    pub branch_level: u32,
+    #[serde(default)]
+    pub is_cosmos: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub branch: Option<String>,
+    #[serde(default)]
+    pub is_read_only: bool,
+    #[serde(default)]
+    #[ts(type = "string")]
+    #[ts(optional)]
+    pub badge: Option<AgentBadge>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub current_skill: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub workspace_id: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub workspace_path: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub git_remote_url: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub git_branch: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct TaskInfo {
+    #[ts(type = "string")]
+    pub id: uuid::Uuid,
+    #[ts(type = "string")]
+    pub issue_id: uuid::Uuid,
+    pub title: String,
+    pub status: TaskStatus,
+    pub progress: u8,
+    #[serde(default)]
+    #[ts(optional)]
+    pub assigned_agent: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct GlobalSnapshotParams {
+    pub snapshot: GlobalSnapshotData,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct GlobalSnapshotData {
+    pub version: u64,
+    pub timestamp: i64,
+    pub agents: Vec<TuiAgentInfo>,
+    pub containers: Vec<ContainerInfo>,
+    pub active_tasks: Vec<TaskInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct ContainerSnapshotParams {
+    pub snapshot: ContainerSnapshotData,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct ContainerSnapshotData {
+    pub version: u64,
+    pub timestamp: i64,
+    pub containers: Vec<ContainerInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct TasksSnapshotParams {
+    pub snapshot: TasksSnapshotData,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/stateSync.ts")]
+pub struct TasksSnapshotData {
+    pub version: u64,
+    pub timestamp: i64,
+    pub tasks: Vec<TaskInfo>,
+}

package/src/ws/agent/tasks.rs

@@ -0,0 +1,43 @@
+//! Task management — task creation and status updates.
+
+use schemars::JsonSchema;
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use crate::{Agent, AgentBadge, TaskStatus};
+
+#[derive(JsonSchema, Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/tasks.ts")]
+pub struct TaskCreatedParams {
+    #[ts(type = "string")]
+    pub task_id: uuid::Uuid,
+    #[ts(type = "string")]
+    pub issue_id: uuid::Uuid,
+    pub title: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub description: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub assigned_agent: Option<Agent>,
+    #[serde(default)]
+    #[ts(type = "string")]
+    #[ts(optional)]
+    pub parent_task_id: Option<uuid::Uuid>,
+    #[serde(default)]
+    #[ts(type = "string")]
+    #[ts(optional)]
+    pub badge: Option<AgentBadge>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub tags: Option<Vec<String>>,
+}
+
+#[derive(JsonSchema, Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/tasks.ts")]
+pub struct TaskStatusUpdateParams {
+    #[ts(type = "string")]
+    pub task_id: uuid::Uuid,
+    pub status: TaskStatus,
+    pub progress: u8,
+}

package/src/ws/agent/yolo.rs

@@ -0,0 +1,161 @@
+//! YOLO Cruise Control — autonomous loop status & configuration.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use crate::YoloTaskTier;
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloStartResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloStopResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTerminateResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTaskResult {
+    pub success: bool,
+    pub duration_ms: u64,
+    pub completed_at: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTaskStatus {
+    pub agent: String,
+    pub skill: String,
+    pub enabled: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub last_result: Option<YoloTaskResult>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTierStatus {
+    pub tier: YoloTaskTier,
+    pub enabled: bool,
+    pub interval_secs: u64,
+    #[serde(default)]
+    #[ts(optional)]
+    pub last_run_at: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub next_run_at: Option<String>,
+    #[serde(default)]
+    pub tasks: Vec<YoloTaskStatus>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloStatusResponseParams {
+    pub active: bool,
+    pub loop_count: u64,
+    #[serde(default)]
+    #[ts(optional)]
+    pub started_at: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub current_cycle: Option<String>,
+    #[serde(default)]
+    pub tiers: Vec<YoloTierStatus>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloCycleStepParams {
+    pub skill: String,
+    pub loop_count: u64,
+    pub status: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub token_usage: Option<(u32, u32)>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub model_name: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloCycleCompleteParams {
+    pub loop_count: u64,
+    pub duration_ms: u64,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTierTaskConfig {
+    pub agent: String,
+    pub skill: String,
+    #[serde(default = "crate::default_true")]
+    pub enabled: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloTierConfig {
+    pub tier: YoloTaskTier,
+    #[serde(default)]
+    pub enabled: bool,
+    #[serde(default)]
+    pub interval_secs: u64,
+    #[serde(default)]
+    pub tasks: Vec<YoloTierTaskConfig>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloConfigResponseParams {
+    pub tiers: Vec<YoloTierConfig>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloUpdateTaskResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloSetTierIntervalResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/yolo.ts")]
+pub struct YoloRunTierNowResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}

package/src/ws/mod.rs

@@ -0,0 +1,10 @@
+//! WebSocket TUI message domains — the variant params of the platform's
+//! `SyncMessage` enum, mirroring entelecheia's `tui_types/message/types`.
+//!
+//! Each submodule's types are re-exported at the crate root
+//! (`arona::TypeName`); the TypeScript bindings land under `ws/*.ts`, matching
+//! the `#[ts(export_to = "ws/…")]` attributes on every type defined here.
+
+pub mod agent;
+pub mod services;
+pub mod ui;

package/src/ws/services/auth.rs

@@ -0,0 +1,99 @@
+//! Authentication — login/register/user-management responses.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthLoginResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub token: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub session_id: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub user_id: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub username: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub display_name: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub role: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthRegisterResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub user_id: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub username: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct UserProfileSummary {
+    pub id: String,
+    pub username: String,
+    pub email: String,
+    pub display_name: String,
+    pub role: String,
+    pub is_active: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthListUsersResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub users: Option<Vec<UserProfileSummary>>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthGetUserResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub user: Option<UserProfileSummary>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthDeleteUserResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/auth.ts")]
+pub struct AuthChangePasswordResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}