@celestia-island/plana-types 0.1.0

package/src/ws/services/llm_provider.rs

@@ -0,0 +1,371 @@
+//! LLM provider configuration & config-filesystem types.
+//!
+//! Covers provider lifecycle events, configured-provider catalog, usage
+//! periods, the on-disk provider/model filesystem schema, user config, and
+//! API-key registry info.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use crate::PeriodType;
+
+// ═══════════════════════════════════════════════════════════════
+// LLM Provider configuration
+// ═══════════════════════════════════════════════════════════════
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct LlmProviderConfiguredParams {
+    pub provider_name: String,
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderRenamedParams {
+    pub provider_name: String,
+    pub new_display_name: String,
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderEditedParams {
+    pub provider_name: String,
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderDeletedParams {
+    pub provider_name: String,
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ConfiguredProviderInfo {
+    pub provider_name: String,
+    pub display_name: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub api_endpoint: Option<String>,
+    pub default_model: String,
+    pub is_enabled: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ConfiguredProvidersListParams {
+    pub providers: Vec<ConfiguredProviderInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ModelProviderConfigUpdatedParams {
+    pub provider_name: String,
+    pub success: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct EndpointValidatedParams {
+    pub provider_name: String,
+    pub is_reachable: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub latency_ms: Option<u64>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct UsagePeriodData {
+    pub user_id: String,
+    pub period_type: PeriodType,
+    pub used_tokens: u64,
+    pub cost: f64,
+    pub start_time: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub remaining_tokens: Option<u64>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub remaining_cost: Option<f64>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct UsagePeriodResponseParams {
+    pub data: Vec<UsagePeriodData>,
+}
+
+// ═══════════════════════════════════════════════════════════════
+// Config Filesystem
+// ═══════════════════════════════════════════════════════════════
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct EntrypointApiConfigInfo {
+    pub protocol: String,
+    pub base_url: String,
+    pub chat_endpoint: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub models_endpoint: Option<String>,
+    pub auth_type: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub auth_header: Option<String>,
+    pub env_var: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct MaxConcurrentInfo {
+    #[serde(default)]
+    pub deep: usize,
+    #[serde(default)]
+    pub normal: usize,
+    #[serde(default)]
+    pub basic: usize,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct EntrypointDefaultsInfo {
+    #[serde(default)]
+    pub deep: Vec<String>,
+    #[serde(default)]
+    pub normal: Vec<String>,
+    #[serde(default)]
+    pub basic: Vec<String>,
+    #[serde(default)]
+    pub max_concurrent: MaxConcurrentInfo,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct QuotaInfo {
+    pub data_limit: u64,
+    #[serde(default)]
+    #[ts(optional)]
+    pub period_hours: Option<u32>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub period_days: Option<u32>,
+    #[serde(default)]
+    pub billing_metric: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct EntrypointConfigInfo {
+    pub id: String,
+    #[serde(default)]
+    pub name: std::collections::HashMap<String, String>,
+    #[serde(default, rename = "type")]
+    #[ts(rename = "type")]
+    pub entry_type: String,
+    #[serde(default)]
+    pub billing_type: String,
+    #[serde(default)]
+    pub plan_tier: String,
+    pub api: EntrypointApiConfigInfo,
+    #[serde(default)]
+    pub defaults: EntrypointDefaultsInfo,
+    #[serde(default)]
+    pub quotas: Vec<QuotaInfo>,
+    #[serde(default)]
+    pub models: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderCapabilitiesInfo {
+    #[serde(default)]
+    pub streaming: bool,
+    #[serde(default)]
+    pub function_calling: bool,
+    #[serde(default)]
+    pub vision: bool,
+    #[serde(default)]
+    pub reasoning: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderLimitsInfo {
+    #[serde(default)]
+    pub max_concurrent: u32,
+    #[serde(default)]
+    #[ts(optional)]
+    pub rate_limit_per_minute: Option<u32>,
+    #[serde(default)]
+    pub timeout_seconds: u64,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderFsInfoParams {
+    pub providers: Vec<ProviderFsInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ModelFsPricing {
+    #[serde(default)]
+    #[ts(optional)]
+    pub input_per_million: Option<f64>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub output_per_million: Option<f64>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub cached_per_million: Option<f64>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct RateRuleInfo {
+    pub timezone_offset: i32,
+    pub peak_start: u32,
+    pub peak_end: u32,
+    pub peak_multiplier: f64,
+    pub off_peak_multiplier: f64,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ModelFsInfo {
+    pub id: String,
+    pub name: String,
+    pub provider_id: String,
+    pub context_window: u64,
+    pub max_output_tokens: u64,
+    #[serde(default)]
+    pub supports_vision: bool,
+    #[serde(default = "crate::default_true")]
+    pub supports_function_calling: bool,
+    #[serde(default = "crate::default_true")]
+    pub supports_streaming: bool,
+    #[serde(default)]
+    pub supports_reasoning: bool,
+    #[serde(default)]
+    pub tags: Vec<String>,
+    /// Fine-grained capability flags. When non-empty, supersedes the boolean
+    /// flags above for skill→model routing. See [`crate::ModelCapability`].
+    #[serde(default)]
+    pub capabilities: Vec<crate::ModelCapability>,
+    /// Generation quality tier (image / 3D generation models only).
+    /// See [`crate::GenerationTier`].
+    #[serde(default)]
+    #[ts(optional)]
+    pub generation_tier: Option<crate::GenerationTier>,
+    /// Hardware requirements (local generative models only).
+    /// See [`crate::HardwareRequirements`].
+    #[serde(default)]
+    #[ts(optional)]
+    pub hardware_requirements: Option<crate::HardwareRequirements>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub pricing: Option<ModelFsPricing>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub rate_multiplier: Option<f64>,
+    #[serde(default)]
+    pub rate_rules: Vec<RateRuleInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ModelFsInfoParams {
+    pub models: Vec<ModelFsInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ProviderFsInfo {
+    pub id: String,
+    #[serde(default)]
+    pub name: std::collections::HashMap<String, String>,
+    #[serde(default)]
+    pub protocol: String,
+    #[serde(default)]
+    pub category: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub base_url: Option<String>,
+    #[serde(default)]
+    pub entry_points: Vec<EntrypointConfigInfo>,
+    #[serde(default)]
+    pub models: Vec<ModelFsInfo>,
+    #[serde(default)]
+    pub capabilities: ProviderCapabilitiesInfo,
+    #[serde(default)]
+    pub limits: ProviderLimitsInfo,
+    #[serde(default)]
+    pub pricing_model: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct UserConfigResponseParams {
+    pub config: UserInfoConfig,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct UserInfoConfig {
+    pub preferred_language: String,
+    #[serde(default)]
+    pub default_models: std::collections::HashMap<String, String>,
+    #[serde(default)]
+    pub enabled_providers: Vec<String>,
+    #[serde(default)]
+    pub enabled_models: Vec<String>,
+    #[serde(default)]
+    pub model_priorities: std::collections::HashMap<String, u32>,
+    #[serde(default)]
+    pub auto_import_from_env: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct KeysListResponseParams {
+    pub keys: Vec<KeyInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct KeyInfo {
+    pub provider: String,
+    pub display_name: String,
+    pub has_key: bool,
+    pub created_at: String,
+    pub updated_at: String,
+    pub source: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/llmProvider.ts")]
+pub struct ApiKeyInfoResponseParams {
+    pub info: KeyInfo,
+}

package/src/ws/services/mod.rs

@@ -0,0 +1,7 @@
+//! Service-facing message params — authentication, LLM provider configuration,
+//! knowledge-base (RAG) lifecycle, and industrial-control telemetry.
+
+pub mod auth;
+pub mod industrial;
+pub mod knowledge_base;
+pub mod llm_provider;

package/src/ws/ui/bridge_network.rs

@@ -0,0 +1,96 @@
+//! Bridge Network — host machines + their workspaces.
+//!
+//! The 3rd chat sub-page ("桥接网络"): the left column lists host machines
+//! (localhost + remote polemos devices) with live performance; the right
+//! column lists the workspaces attached to the selected host with their
+//! noa-git status + token usage. Clicking a host opens its file browser
+//! (default /home); clicking a workspace opens its on-disk directory.
+//!
+//! Mirrors `entelecheia/.../tui_types/message/types/mod.rs`.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+/// Live performance snapshot for one host machine.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct HostMetrics {
+    /// Stable host id ("localhost" for self, or a polemos device id).
+    pub host_id: String,
+    pub hostname: String,
+    pub os: String,
+    /// CPU utilisation, 0..100.
+    pub cpu_usage_percent: f64,
+    /// Logical CPU core count (shown with an i18n "cores" unit).
+    pub cpu_cores: u32,
+    pub mem_used_bytes: u64,
+    pub mem_total_bytes: u64,
+    /// Outbound network rate (bytes/sec). Omitted when unknown.
+    #[serde(default)]
+    #[ts(optional)]
+    pub net_up_bps: Option<u64>,
+    /// Inbound network rate (bytes/sec). Omitted when unknown.
+    #[serde(default)]
+    #[ts(optional)]
+    pub net_down_bps: Option<u64>,
+}
+
+/// noa-git status for a workspace checkout (branch / dirty / ahead / behind).
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct WorkspaceGitStatus {
+    pub branch: String,
+    /// Modified/untracked file count.
+    #[serde(default)]
+    pub modified: u32,
+    /// Commits ahead of upstream.
+    #[serde(default)]
+    pub ahead: u32,
+    /// Commits behind upstream.
+    #[serde(default)]
+    pub behind: u32,
+    /// `true` when there are uncommitted changes.
+    #[serde(default)]
+    pub dirty: bool,
+}
+
+/// One agent's token usage within a workspace (top-N entries).
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct WorkspaceTokenUsage {
+    pub agent: String,
+    pub input: u64,
+    pub output: u64,
+}
+
+/// A workspace attached to a host, with its git + token-usage summary.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct WorkspaceNode {
+    #[ts(type = "string")]
+    pub workspace_id: uuid::Uuid,
+    pub host_id: String,
+    pub path: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub alias: Option<String>,
+    #[serde(default)]
+    #[ts(optional)]
+    pub git: Option<WorkspaceGitStatus>,
+    /// Top token consumers in this workspace (max 3).
+    #[serde(default)]
+    pub token_usage: Vec<WorkspaceTokenUsage>,
+}
+
+/// `Sync.RequestBridgeNetwork` — request the host/workspace roster.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct RequestBridgeNetworkParams {}
+
+/// `Sync.BridgeNetwork` — the host/workspace roster response/push.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/bridgeNetwork.ts")]
+pub struct BridgeNetworkParams {
+    pub hosts: Vec<HostMetrics>,
+    pub workspaces: Vec<WorkspaceNode>,
+}

package/src/ws/ui/file_browsing.rs

@@ -0,0 +1,88 @@
+//! File Browsing — SyncMessage variant params.
+//!
+//! Browse/read files inside a container (#demiurge / #NNN), on a host machine,
+//! or in a workspace checkout. Targets are distinguished by `FileTargetKind`.
+//! The node-list container cards, the Bridge Network host cards and the
+//! workspace cards all open this same file browser.
+//!
+//! Mirrors `entelecheia/.../tui_types/message/types/mod.rs`.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+/// Which filesystem a file operation targets.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+#[serde(rename_all = "snake_case")]
+pub enum FileTargetKind {
+    /// A container slot — `#demiurge` or `#NNN` (id is the slot badge).
+    Container,
+    /// A host machine (id is the host_id / device id; "localhost" for self).
+    Host,
+    /// A workspace checkout (id is the workspace_id).
+    Workspace,
+}
+
+/// A file-operation target — a (kind, id) pair plus optional workspace
+/// context (container slots are per-workspace).
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct FileTarget {
+    pub kind: FileTargetKind,
+    /// Container badge (`#demiurge` / `#001`), host id, or workspace id.
+    pub id: String,
+    /// Owning workspace id (container slots are workspace-scoped).
+    #[serde(default)]
+    #[ts(optional, type = "string")]
+    pub workspace_id: Option<uuid::Uuid>,
+}
+
+/// One entry in a directory listing.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct FileTreeEntry {
+    pub name: String,
+    /// `"file"` | `"dir"` | `"symlink"`.
+    pub kind: String,
+    pub size: u64,
+}
+
+/// `Sync.RequestFileTree` — list one level of a directory.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct RequestFileTreeParams {
+    pub target: FileTarget,
+    /// Sub-path under the target root (empty/`""` = root).
+    #[serde(default)]
+    pub path: String,
+}
+
+/// `Sync.FileTree` — directory listing response.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct FileTreeParams {
+    pub target: FileTarget,
+    pub path: String,
+    pub entries: Vec<FileTreeEntry>,
+}
+
+/// `Sync.RequestFileRead` — read a single (text) file, capped server-side.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct RequestFileReadParams {
+    pub target: FileTarget,
+    pub path: String,
+}
+
+/// `Sync.FileRead` — file-content response.
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/fileBrowsing.ts")]
+pub struct FileReadParams {
+    pub target: FileTarget,
+    pub path: String,
+    pub content: String,
+    pub size: u64,
+    /// `true` when content was truncated to the server read cap.
+    #[serde(default)]
+    pub truncated: bool,
+}

package/src/ws/ui/logs.rs

@@ -0,0 +1,55 @@
+//! Log entry types — server / container log streaming.
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/logs.ts")]
+pub struct LogEntryData {
+    pub source: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub instance_uuid: Option<String>,
+    pub level: String,
+    #[serde(default)]
+    #[ts(optional)]
+    pub target: Option<String>,
+    pub message: String,
+    #[serde(default)]
+    #[ts(type = "Record<string, unknown>")]
+    pub fields: serde_json::Value,
+    pub created_at: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/logs.ts")]
+pub struct ServerLogEntryParams {
+    pub entry: LogEntryData,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/logs.ts")]
+pub struct ContainerLogEntryParams {
+    pub instance_uuid: String,
+    pub entry: LogEntryData,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/logs.ts")]
+pub struct SubscribeLogsResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+    #[serde(default)]
+    pub entries: Vec<LogEntryData>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
+#[ts(export, export_to = "ws/logs.ts")]
+pub struct UnsubscribeLogsResponseParams {
+    pub ok: bool,
+    #[serde(default)]
+    #[ts(optional)]
+    pub error: Option<String>,
+}

package/src/ws/ui/mod.rs

@@ -0,0 +1,11 @@
+//! Workspace & UI message params — workspaces & device registry, the
+//! bridge-network host view, file browsing, log streaming, web-UI control,
+//! dashboard views, and the NOA workspace handshake.
+
+pub mod bridge_network;
+pub mod file_browsing;
+pub mod logs;
+pub mod noa;
+pub mod system_ui;
+pub mod views;
+pub mod workspace;