reallink-cli 0.1.15 → 0.1.17

package/rust/src/unreal.rs

@@ -1,316 +1,489 @@
-use anyhow::Result;
-use clap::{ArgAction, Args, Subcommand};
-use serde::{Deserialize, Serialize};
-use std::path::PathBuf;
-
-const DEFAULT_UNREAL_PLUGIN_BASE_URL: &str = "https://real-agent.link/plugins/unreal";
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct UnrealLinkRecord {
-    pub project_id: String,
-    pub uproject_path: String,
-    pub project_root: String,
-    pub engine_root: Option<String>,
-    pub editor_path: String,
-    pub created_at_epoch_ms: u128,
-    pub updated_at_epoch_ms: u128,
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct UnrealLinksConfig {
-    pub version: u32,
-    pub default_project_id: Option<String>,
-    pub links: Vec<UnrealLinkRecord>,
-}
-
-impl Default for UnrealLinksConfig {
-    fn default() -> Self {
-        Self {
-            version: 1,
-            default_project_id: None,
-            links: Vec::new(),
-        }
-    }
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct PluginIndexFile {
-    pub schema_version: Option<u32>,
-    #[serde(default)]
-    pub plugins: Vec<PluginIndexPlugin>,
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct PluginIndexPlugin {
-    pub name: String,
-    pub latest: Option<String>,
-    #[serde(default)]
-    pub versions: Vec<PluginIndexVersion>,
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct PluginIndexVersion {
-    pub version: String,
-    pub archive_url: Option<String>,
-    pub sha256: Option<String>,
-}
-
-#[derive(Subcommand)]
-pub(crate) enum LinkCommands {
-    Unreal(LinkUnrealArgs),
-    List,
-    Use(LinkUseArgs),
-    Doctor(LinkDoctorArgs),
-    Paths(LinkPathsArgs),
-    Remove(LinkRemoveArgs),
-    Open(LinkOpenArgs),
-    Run(LinkRunArgs),
-    Plugin {
-        #[command(subcommand)]
-        command: LinkPluginCommands,
-    },
-    /// Register a local source folder for a project
-    Source(LinkSourceArgs),
-    /// Connect to Reallink and bridge local source to agents
-    Connect(LinkConnectArgs),
-}
-
-#[derive(Subcommand)]
-pub(crate) enum LinkPluginCommands {
-    Install(LinkPluginInstallArgs),
-    List(LinkPluginListArgs),
-}
-
-#[derive(Args)]
-pub(crate) struct LinkUnrealArgs {
-    #[arg(long, help = "Remote Reallink project id to bind")]
-    pub project_id: String,
-    #[arg(long, help = "Path to .uproject file or a folder containing one")]
-    pub uproject: PathBuf,
-    #[arg(long, help = "Path to Unreal Engine root (contains Engine/)")]
-    pub engine_root: Option<PathBuf>,
-    #[arg(long, help = "Path to Unreal editor binary (UnrealEditor/UE4Editor)")]
-    pub editor: Option<PathBuf>,
-    #[arg(long, help = "Set this link as default for `reallink link open`")]
-    pub set_default: bool,
-    #[arg(long, help = "Skip remote project verification (useful when offline)")]
-    pub no_verify_remote: bool,
-    #[arg(
-        long,
-        help = "Sync a sanitized Unreal link manifest into project assets (.reallink/link/unreal-link.latest.json)"
-    )]
-    pub sync_project: bool,
-    #[arg(
-        long,
-        help = "When syncing project manifest, include full local paths (disabled by default)"
-    )]
-    pub include_local_paths: bool,
-    #[arg(long)]
-    pub base_url: Option<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkUseArgs {
-    #[arg(long)]
-    pub project_id: String,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkRemoveArgs {
-    #[arg(long)]
-    pub project_id: Option<String>,
-    #[arg(long)]
-    pub uproject: Option<PathBuf>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkOpenArgs {
-    #[arg(long)]
-    pub project_id: Option<String>,
-    #[arg(long)]
-    pub uproject: Option<PathBuf>,
-    #[arg(long, help = "Wait for Unreal process to exit")]
-    pub wait: bool,
-    #[arg(
-        long = "arg",
-        action = ArgAction::Append,
-        help = "Additional argument forwarded to Unreal editor"
-    )]
-    pub extra_arg: Vec<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkRunArgs {
-    #[arg(long)]
-    pub project_id: Option<String>,
-    #[arg(long)]
-    pub uproject: Option<PathBuf>,
-    #[arg(long, help = "Commandlet name to execute via -run=<name>")]
-    pub commandlet: Option<String>,
-    #[arg(long, help = "Add Unreal -log flag")]
-    pub log: bool,
-    #[arg(
-        long,
-        help = "Add headless-friendly flags (-unattended -nop4 -nosplash -nullrhi)"
-    )]
-    pub headless: bool,
-    #[arg(long, help = "Do not wait for process exit")]
-    pub no_wait: bool,
-    #[arg(
-        long = "arg",
-        action = ArgAction::Append,
-        help = "Additional argument forwarded to Unreal editor"
-    )]
-    pub extra_arg: Vec<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkDoctorArgs {
-    #[arg(long)]
-    pub project_id: Option<String>,
-    #[arg(long)]
-    pub uproject: Option<PathBuf>,
-    #[arg(
-        long,
-        help = "Verify linked project access against API using saved session"
-    )]
-    pub verify_remote: bool,
-    #[arg(long)]
-    pub base_url: Option<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkPathsArgs {
-    #[arg(long)]
-    pub project_id: Option<String>,
-    #[arg(long)]
-    pub uproject: Option<PathBuf>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkPluginInstallArgs {
-    #[arg(long, help = "Plugin name (also used for target folder name)")]
-    pub name: String,
-    #[arg(long, default_value = "latest", help = "Plugin version channel or tag")]
-    pub version: String,
-    #[arg(long, help = "Install against linked project id")]
-    pub project_id: Option<String>,
-    #[arg(long, help = "Install against linked uproject path")]
-    pub uproject: Option<PathBuf>,
-    #[arg(
-        long,
-        help = "Install into Engine/Plugins/Marketplace instead of Project/Plugins"
-    )]
-    pub engine: bool,
-    #[arg(long, help = "Overwrite existing plugin directory")]
-    pub force: bool,
-    #[arg(
-        long,
-        help = "Override full plugin zip URL. If omitted, URL is composed from --base-url/--name/--version"
-    )]
-    pub url: Option<String>,
-    #[arg(
-        long,
-        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
-        help = "Public plugin bucket base URL"
-    )]
-    pub base_url: String,
-    #[arg(
-        long,
-        help = "Resolve plugin version/url from plugin index instead of using URL template"
-    )]
-    pub use_index: bool,
-    #[arg(
-        long,
-        default_value = "index.json",
-        help = "Plugin index path under base URL (used with --use-index)"
-    )]
-    pub index_path: String,
-    #[arg(long, help = "Expected SHA-256 hex for downloaded plugin zip")]
-    pub sha256: Option<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkPluginListArgs {
-    #[arg(
-        long,
-        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
-        help = "Public plugin bucket base URL"
-    )]
-    pub base_url: String,
-    #[arg(
-        long,
-        default_value = "index.json",
-        help = "Plugin index path under base URL"
-    )]
-    pub index_path: String,
-}
-
-// ---------------------------------------------------------------------------
-// Source link args
-// ---------------------------------------------------------------------------
-
-#[derive(Args)]
-pub(crate) struct LinkSourceArgs {
-    #[arg(long, help = "Project ID to bind the source folder to")]
-    pub project_id: String,
-    #[arg(long, help = "Local directory path containing source files")]
-    pub path: PathBuf,
-    #[arg(long, default_value = "project", help = "Label for this folder (project, engine, etc.)")]
-    pub label: String,
-    #[arg(long)]
-    pub base_url: Option<String>,
-}
-
-#[derive(Args)]
-pub(crate) struct LinkConnectArgs {
-    #[arg(long, help = "Project ID to connect. Uses default if omitted")]
-    pub project_id: Option<String>,
-    #[arg(long, help = "Push file index + key source files to R2 on connect")]
-    pub sync: bool,
-    #[arg(long, help = "Connect service URL override")]
-    pub connect_url: Option<String>,
-    #[arg(long)]
-    pub base_url: Option<String>,
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct SourceLinkRecord {
-    pub project_id: String,
-    pub folder_path: String,
-    pub folder_label: String,
-    pub created_at_epoch_ms: u128,
-}
-
-#[derive(Debug, Serialize, Deserialize, Clone, Default)]
-#[serde(rename_all = "camelCase")]
-pub(crate) struct SourceLinksConfig {
-    pub version: u32,
-    pub links: Vec<SourceLinkRecord>,
-}
-
-pub(crate) async fn dispatch(client: &reqwest::Client, command: LinkCommands) -> Result<()> {
-    match command {
-        LinkCommands::Unreal(args) => crate::link_unreal_command(client, args).await?,
-        LinkCommands::List => crate::link_list_command().await?,
-        LinkCommands::Use(args) => crate::link_use_command(args).await?,
-        LinkCommands::Doctor(args) => crate::link_doctor_command(client, args).await?,
-        LinkCommands::Paths(args) => crate::link_paths_command(args).await?,
-        LinkCommands::Remove(args) => crate::link_remove_command(args).await?,
-        LinkCommands::Open(args) => crate::link_open_command(args).await?,
-        LinkCommands::Run(args) => crate::link_run_command(args).await?,
-        LinkCommands::Plugin { command } => match command {
-            LinkPluginCommands::Install(args) => crate::link_plugin_install_command(client, args).await?,
-            LinkPluginCommands::List(args) => crate::link_plugin_list_command(client, args).await?,
-        },
-        LinkCommands::Source(args) => crate::link_source_command(client, args).await?,
-        LinkCommands::Connect(args) => crate::link_connect_command(client, args).await?,
-    }
-    Ok(())
-}
+use anyhow::Result;
+use clap::{ArgAction, Args, Subcommand, ValueEnum};
+use serde::{Deserialize, Serialize};
+use std::path::PathBuf;
+
+const DEFAULT_UNREAL_PLUGIN_BASE_URL: &str = "https://real-agent.link/plugins/unreal";
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct UnrealLinkRecord {
+    pub project_id: String,
+    pub uproject_path: String,
+    pub project_root: String,
+    pub engine_root: Option<String>,
+    pub editor_path: String,
+    pub created_at_epoch_ms: u128,
+    pub updated_at_epoch_ms: u128,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct UnrealLinksConfig {
+    pub version: u32,
+    pub default_project_id: Option<String>,
+    pub links: Vec<UnrealLinkRecord>,
+}
+
+impl Default for UnrealLinksConfig {
+    fn default() -> Self {
+        Self {
+            version: 1,
+            default_project_id: None,
+            links: Vec::new(),
+        }
+    }
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexFile {
+    pub schema_version: Option<u32>,
+    #[serde(default)]
+    pub plugins: Vec<PluginIndexPlugin>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexPlugin {
+    pub name: String,
+    pub latest: Option<String>,
+    #[serde(default)]
+    pub versions: Vec<PluginIndexVersion>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexVersion {
+    pub version: String,
+    pub archive_url: Option<String>,
+    pub sha256: Option<String>,
+}
+
+#[derive(Subcommand)]
+pub(crate) enum LinkCommands {
+    Unreal(LinkUnrealArgs),
+    List,
+    Use(LinkUseArgs),
+    Doctor(LinkDoctorArgs),
+    Paths(LinkPathsArgs),
+    Remove(LinkRemoveArgs),
+    Open(LinkOpenArgs),
+    Run(LinkRunArgs),
+    Plugin {
+        #[command(subcommand)]
+        command: LinkPluginCommands,
+    },
+    /// Register a local source folder for a project
+    Source(LinkSourceArgs),
+    /// Connect to Reallink and bridge local source to agents
+    Connect(LinkConnectArgs),
+    /// Manage P2P signaling sessions for direct CLI-to-CLI transports
+    P2p {
+        #[command(subcommand)]
+        command: LinkP2PCommands,
+    },
+}
+
+#[derive(Subcommand)]
+pub(crate) enum LinkPluginCommands {
+    Install(LinkPluginInstallArgs),
+    List(LinkPluginListArgs),
+}
+
+#[derive(Subcommand)]
+pub(crate) enum LinkP2PCommands {
+    Create(LinkP2PCreateArgs),
+    List(LinkP2PListArgs),
+    Get(LinkP2PGetArgs),
+    Wait(LinkP2PWaitArgs),
+    Signal(LinkP2PSignalArgs),
+}
+
+#[derive(Args)]
+pub(crate) struct LinkUnrealArgs {
+    #[arg(long, help = "Remote Reallink project id to bind")]
+    pub project_id: String,
+    #[arg(long, help = "Path to .uproject file or a folder containing one")]
+    pub uproject: PathBuf,
+    #[arg(long, help = "Path to Unreal Engine root (contains Engine/)")]
+    pub engine_root: Option<PathBuf>,
+    #[arg(long, help = "Path to Unreal editor binary (UnrealEditor/UE4Editor)")]
+    pub editor: Option<PathBuf>,
+    #[arg(long, help = "Set this link as default for `reallink link open`")]
+    pub set_default: bool,
+    #[arg(long, help = "Skip remote project verification (useful when offline)")]
+    pub no_verify_remote: bool,
+    #[arg(
+        long,
+        help = "Sync a sanitized Unreal link manifest into project assets (.reallink/link/unreal-link.latest.json)"
+    )]
+    pub sync_project: bool,
+    #[arg(
+        long,
+        help = "When syncing project manifest, include full local paths (disabled by default)"
+    )]
+    pub include_local_paths: bool,
+    #[arg(long)]
+    pub base_url: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkUseArgs {
+    #[arg(long)]
+    pub project_id: String,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkRemoveArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkOpenArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(long, help = "Wait for Unreal process to exit")]
+    pub wait: bool,
+    #[arg(
+        long = "arg",
+        action = ArgAction::Append,
+        help = "Additional argument forwarded to Unreal editor"
+    )]
+    pub extra_arg: Vec<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkRunArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(long, help = "Commandlet name to execute via -run=<name>")]
+    pub commandlet: Option<String>,
+    #[arg(long, help = "Add Unreal -log flag")]
+    pub log: bool,
+    #[arg(
+        long,
+        help = "Add headless-friendly flags (-unattended -nop4 -nosplash -nullrhi)"
+    )]
+    pub headless: bool,
+    #[arg(long, help = "Do not wait for process exit")]
+    pub no_wait: bool,
+    #[arg(
+        long = "arg",
+        action = ArgAction::Append,
+        help = "Additional argument forwarded to Unreal editor"
+    )]
+    pub extra_arg: Vec<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkDoctorArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(
+        long,
+        help = "Verify linked project access against API using saved session"
+    )]
+    pub verify_remote: bool,
+    #[arg(long)]
+    pub base_url: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPathsArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPluginInstallArgs {
+    #[arg(long, help = "Plugin name (also used for target folder name)")]
+    pub name: String,
+    #[arg(long, default_value = "latest", help = "Plugin version channel or tag")]
+    pub version: String,
+    #[arg(long, help = "Install against linked project id")]
+    pub project_id: Option<String>,
+    #[arg(long, help = "Install against linked uproject path")]
+    pub uproject: Option<PathBuf>,
+    #[arg(
+        long,
+        help = "Install into Engine/Plugins/Marketplace instead of Project/Plugins"
+    )]
+    pub engine: bool,
+    #[arg(long, help = "Overwrite existing plugin directory")]
+    pub force: bool,
+    #[arg(
+        long,
+        help = "Override full plugin zip URL. If omitted, URL is composed from --base-url/--name/--version"
+    )]
+    pub url: Option<String>,
+    #[arg(
+        long,
+        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
+        help = "Public plugin bucket base URL"
+    )]
+    pub base_url: String,
+    #[arg(
+        long,
+        help = "Resolve plugin version/url from plugin index instead of using URL template"
+    )]
+    pub use_index: bool,
+    #[arg(
+        long,
+        default_value = "index.json",
+        help = "Plugin index path under base URL (used with --use-index)"
+    )]
+    pub index_path: String,
+    #[arg(long, help = "Expected SHA-256 hex for downloaded plugin zip")]
+    pub sha256: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPluginListArgs {
+    #[arg(
+        long,
+        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
+        help = "Public plugin bucket base URL"
+    )]
+    pub base_url: String,
+    #[arg(
+        long,
+        default_value = "index.json",
+        help = "Plugin index path under base URL"
+    )]
+    pub index_path: String,
+}
+
+// ---------------------------------------------------------------------------
+// Source link args
+// ---------------------------------------------------------------------------
+
+#[derive(Args)]
+pub(crate) struct LinkSourceArgs {
+    #[arg(long, help = "Project ID to bind the source folder to")]
+    pub project_id: String,
+    #[arg(long, help = "Local directory path containing source files")]
+    pub path: PathBuf,
+    #[arg(
+        long,
+        default_value = "project",
+        help = "Label for this folder (project, engine, etc.)"
+    )]
+    pub label: String,
+    #[arg(long)]
+    pub base_url: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkConnectArgs {
+    #[arg(long, help = "Project ID to connect. Uses default if omitted")]
+    pub project_id: Option<String>,
+    #[arg(
+        long,
+        help = "Stable workspace identifier for this linked client session"
+    )]
+    pub workspace_id: Option<String>,
+    #[arg(long, help = "Push file index + key source files to R2 on connect")]
+    pub sync: bool,
+    #[arg(
+        long,
+        default_value = "websocket",
+        help = "Transport used by this linked client session"
+    )]
+    pub transport: String,
+    #[arg(long, help = "Connect service URL override")]
+    pub connect_url: Option<String>,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Clone, Debug, ValueEnum)]
+pub(crate) enum LinkP2PRole {
+    Agent,
+    Client,
+}
+
+impl LinkP2PRole {
+    pub(crate) fn as_api_str(&self) -> &'static str {
+        match self {
+            Self::Agent => "agent",
+            Self::Client => "client",
+        }
+    }
+}
+
+#[derive(Clone, Debug, ValueEnum)]
+pub(crate) enum LinkP2PSignalType {
+    Offer,
+    Answer,
+    Candidate,
+    Ready,
+}
+
+impl LinkP2PSignalType {
+    pub(crate) fn as_api_str(&self) -> &'static str {
+        match self {
+            Self::Offer => "offer",
+            Self::Answer => "answer",
+            Self::Candidate => "candidate",
+            Self::Ready => "ready",
+        }
+    }
+}
+
+#[derive(Args)]
+pub(crate) struct LinkP2PCreateArgs {
+    #[arg(long, help = "Project ID to attach the P2P session to")]
+    pub project_id: String,
+    #[arg(long, help = "Stable workspace identifier for this P2P session")]
+    pub workspace_id: Option<String>,
+    #[arg(
+        long,
+        help = "Optional source clientId already registered under the workspace"
+    )]
+    pub client_id: Option<String>,
+    #[arg(long, help = "Optional peer clientId expected to join this session")]
+    pub peer_client_id: Option<String>,
+    #[arg(long, help = "Session TTL in seconds")]
+    pub ttl_seconds: Option<u64>,
+    #[arg(
+        long,
+        help = "Inline JSON object or @path/to/file.json with additional metadata"
+    )]
+    pub metadata: Option<String>,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkP2PGetArgs {
+    #[arg(long, help = "Project ID owning the P2P session")]
+    pub project_id: String,
+    #[arg(long, help = "P2P session identifier")]
+    pub session_id: String,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkP2PListArgs {
+    #[arg(long, help = "Project ID owning the P2P sessions")]
+    pub project_id: String,
+    #[arg(long)]
+    pub workspace_id: Option<String>,
+    #[arg(long)]
+    pub client_id: Option<String>,
+    #[arg(long)]
+    pub status: Option<String>,
+    #[arg(long, default_value_t = 50)]
+    pub limit: u32,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkP2PWaitArgs {
+    #[arg(long, help = "Project ID owning the P2P session")]
+    pub project_id: String,
+    #[arg(long, help = "P2P session identifier")]
+    pub session_id: String,
+    #[arg(long, default_value = "ready")]
+    pub status: String,
+    #[arg(long, default_value_t = 30_000)]
+    pub timeout_ms: u64,
+    #[arg(long, default_value_t = 1_000)]
+    pub poll_interval_ms: u64,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkP2PSignalArgs {
+    #[arg(long, help = "Project ID owning the P2P session")]
+    pub project_id: String,
+    #[arg(long, help = "P2P session identifier")]
+    pub session_id: String,
+    #[arg(long, value_enum)]
+    pub role: LinkP2PRole,
+    #[arg(long = "signal-type", value_enum)]
+    pub signal_type: LinkP2PSignalType,
+    #[arg(
+        long,
+        help = "Inline JSON object or @path/to/file.json carrying the signal payload"
+    )]
+    pub payload: String,
+    #[arg(long, help = "Idempotency key for this signal")]
+    pub signal_id: Option<String>,
+    #[arg(long, help = "Optional registered clientId originating this signal")]
+    pub from_client_id: Option<String>,
+    #[arg(long)]
+    pub base_url: Option<String>,
+    #[arg(long, help = "Bearer token override for agent/API-token usage")]
+    pub access_token: Option<String>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct SourceLinkRecord {
+    pub project_id: String,
+    pub folder_path: String,
+    pub folder_label: String,
+    pub created_at_epoch_ms: u128,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone, Default)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct SourceLinksConfig {
+    pub version: u32,
+    pub links: Vec<SourceLinkRecord>,
+}
+
+pub(crate) async fn dispatch(client: &reqwest::Client, command: LinkCommands) -> Result<()> {
+    match command {
+        LinkCommands::Unreal(args) => crate::link_unreal_command(client, args).await?,
+        LinkCommands::List => crate::link_list_command().await?,
+        LinkCommands::Use(args) => crate::link_use_command(args).await?,
+        LinkCommands::Doctor(args) => crate::link_doctor_command(client, args).await?,
+        LinkCommands::Paths(args) => crate::link_paths_command(args).await?,
+        LinkCommands::Remove(args) => crate::link_remove_command(args).await?,
+        LinkCommands::Open(args) => crate::link_open_command(args).await?,
+        LinkCommands::Run(args) => crate::link_run_command(args).await?,
+        LinkCommands::Plugin { command } => match command {
+            LinkPluginCommands::Install(args) => {
+                crate::link_plugin_install_command(client, args).await?
+            }
+            LinkPluginCommands::List(args) => crate::link_plugin_list_command(client, args).await?,
+        },
+        LinkCommands::Source(args) => crate::link_source_command(client, args).await?,
+        LinkCommands::Connect(args) => crate::link_connect_command(client, args).await?,
+        LinkCommands::P2p { command } => match command {
+            LinkP2PCommands::Create(args) => crate::link_p2p_create_command(client, args).await?,
+            LinkP2PCommands::List(args) => crate::link_p2p_list_command(client, args).await?,
+            LinkP2PCommands::Get(args) => crate::link_p2p_get_command(client, args).await?,
+            LinkP2PCommands::Wait(args) => crate::link_p2p_wait_command(client, args).await?,
+            LinkP2PCommands::Signal(args) => crate::link_p2p_signal_command(client, args).await?,
+        },
+    }
+    Ok(())
+}