refactor + tests

.gitignore

@@ -6,6 +6,7 @@
 .env-elasticsearch-secrets
 .env-migration-tool-secrets
 .env-secrets
+.env-support-tool-secrets
 _develop/tools/.secrets
 _develop/tools/db_secrets.toml
 crates/service/web/storyteller_web/config/storyteller-web.development-secrets.env

.sqlx/query-2436eb7bf4b0e23a899311a67a77f71d89eb35461e2113e43cd9d221bfa91c9a.json

@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n    SELECT\n      id,\n      task_status,\n      task_type,\n      model_type,\n      provider,\n      provider_job_id,\n      frontend_caller,\n      frontend_subscriber_id,\n      frontend_subscriber_payload,\n      on_complete_primary_media_file_token,\n      on_complete_primary_media_file_class,\n      on_complete_batch_token,\n      on_complete_primary_media_file_cdn_url,\n      on_complete_primary_media_file_thumbnail_url_template,\n      created_at as \"created_at: DateTime<Utc>\",\n      updated_at as \"updated_at: DateTime<Utc>\",\n      completed_at as \"completed_at: DateTime<Utc>\"\n    FROM tasks\n    WHERE is_dismissed_by_user == 0\n  ",
+  "query": "\n    SELECT\n      id,\n      task_status,\n      task_type,\n      model_type,\n      provider,\n      provider_job_id,\n      frontend_caller,\n      frontend_subscriber_id,\n      frontend_subscriber_payload,\n      on_complete_primary_media_file_token,\n      on_complete_primary_media_file_class,\n      on_complete_batch_token,\n      on_complete_primary_media_file_cdn_url,\n      on_complete_primary_media_file_thumbnail_url_template,\n      on_failure_type,\n      on_failure_message,\n      created_at as \"created_at: DateTime<Utc>\",\n      updated_at as \"updated_at: DateTime<Utc>\",\n      completed_at as \"completed_at: DateTime<Utc>\"\n    FROM tasks\n    WHERE is_dismissed_by_user == 0\n  ",
   "describe": {
     "columns": [
       {
@@ -74,18 +74,28 @@
         "type_info": "Text"
       },
       {
-        "name": "created_at: DateTime<Utc>",
+        "name": "on_failure_type",
         "ordinal": 14,
+        "type_info": "Text"
+      },
+      {
+        "name": "on_failure_message",
+        "ordinal": 15,
+        "type_info": "Text"
+      },
+      {
+        "name": "created_at: DateTime<Utc>",
+        "ordinal": 16,
         "type_info": "Int64"
       },
       {
         "name": "updated_at: DateTime<Utc>",
-        "ordinal": 15,
+        "ordinal": 17,
         "type_info": "Int64"
       },
       {
         "name": "completed_at: DateTime<Utc>",
-        "ordinal": 16,
+        "ordinal": 18,
         "type_info": "Int64"
       }
     ],
@@ -107,10 +117,12 @@
       true,
       true,
       true,
+      true,
+      true,
       false,
       false,
       true
     ]
   },
-  "hash": "47f94c127abc20683b25c257aed3c2190b9bd29eb829d61392f08e10fd986767"
+  "hash": "2436eb7bf4b0e23a899311a67a77f71d89eb35461e2113e43cd9d221bfa91c9a"
 }

.sqlx/query-be9867966f24f44e14f96966cf5113055f00c339dda75334e7e88d355b9bfe72.json

@@ -0,0 +1,58 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  username,\n  display_name,\n  username_is_generated as `username_is_generated: bool`,\n  username_is_not_customized as `username_is_not_customized: bool`\nFROM users\nWHERE\n  token = ?\n  AND user_deleted_at IS NULL\n  AND mod_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "username",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "display_name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "username_is_generated: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "username_is_not_customized: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 1
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "be9867966f24f44e14f96966cf5113055f00c339dda75334e7e88d355b9bfe72"
+}

.sqlx/query-f4fb945b4311bd4458a68d82e417b40f8c36c08d572c07881b89cd157a8a8699.json

@@ -1,6 +1,6 @@
 {
   "db_name": "MySQL",
-  "query": "\nINSERT INTO wallets\nSET\n  token = ?,\n  wallet_namespace = ?,\n\n  owner_user_token = ?,\n  \n  banked_credits = 0,\n  monthly_credits = 0\n        ",
+  "query": "\nINSERT INTO wallets\nSET\n  token = ?,\n  wallet_namespace = ?,\n\n  owner_user_token = ?,\n\n  banked_credits = 0,\n  monthly_credits = 0\n        ",
   "describe": {
     "columns": [],
     "parameters": {
@@ -8,5 +8,5 @@
     },
     "nullable": []
   },
-  "hash": "4f5100a2cfb465964e77eaacb1ae394daae94de20c56a0966a8222dc9bea63c6"
+  "hash": "f4fb945b4311bd4458a68d82e417b40f8c36c08d572c07881b89cd157a8a8699"
 }

Cargo.lock

@@ -578,9 +578,9 @@ dependencies = [
 
 [[package]]
 name = "anstyle"
-version = "1.0.7"
+version = "1.0.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "038dfcf04a5feb68e9c60b21c9625a54c2c0616e79b72b0fd87075a056ae1d1b"
+checksum = "5192cca8006f1fd4f7237516f40fa183bb07f8fbdfedaa0036de5ea9b0b45e78"
 
 [[package]]
 name = "anstyle-parse"
@@ -2225,9 +2225,9 @@ dependencies = [
 
 [[package]]
 name = "clap"
-version = "4.5.13"
+version = "4.5.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0fbb260a053428790f3de475e304ff84cdbc4face759ea7a3e64c1edd938a7fc"
+checksum = "2797f34da339ce31042b27d23607e051786132987f595b02ba4f6a6dffb7030a"
 dependencies = [
  "clap_builder",
  "clap_derive",
@@ -2235,21 +2235,21 @@ dependencies = [
 
 [[package]]
 name = "clap_builder"
-version = "4.5.13"
+version = "4.5.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "64b17d7ea74e9f833c7dbf2cbe4fb12ff26783eda4782a8975b72f895c9b4d99"
+checksum = "24a241312cea5059b13574bb9b3861cabf758b879c15190b37b6d6fd63ab6876"
 dependencies = [
  "anstream",
  "anstyle",
- "clap_lex 0.7.4",
+ "clap_lex 1.0.0",
  "strsim 0.11.1",
 ]
 
 [[package]]
 name = "clap_derive"
-version = "4.5.13"
+version = "4.5.55"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "501d359d5f3dcaf6ecdeee48833ae73ec6e42723a1e52419c79abf9507eec0a0"
+checksum = "a92793da1a46a5f2a02a6f4c46c6496b28c43638adea8306fcb0caa1634f24e5"
 dependencies = [
  "heck 0.5.0",
  "proc-macro2",
@@ -2268,9 +2268,9 @@ dependencies = [
 
 [[package]]
 name = "clap_lex"
-version = "0.7.4"
+version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f46ad14479a25103f283c0f10005961cf086d8dc42205bb44c46ac563475dca6"
+checksum = "3a822ea5bc7590f9d40f1ba12c0dc3c2760f3482c6984db1573ad11031420831"
 
 [[package]]
 name = "cloud_storage"
@@ -3068,7 +3068,7 @@ version = "0.0.1"
 dependencies = [
  "anyhow",
  "chrono",
- "clap 4.5.13",
+ "clap 4.5.60",
  "datetimes",
  "dotenv",
  "easyenv",
@@ -3103,7 +3103,7 @@ name = "db-cleanup"
 version = "0.0.1"
 dependencies = [
  "bucket_paths",
- "clap 4.5.13",
+ "clap 4.5.60",
  "dotenv",
  "easyenv",
  "enums",
@@ -3263,7 +3263,7 @@ name = "dev-database-seed"
 version = "0.0.1"
 dependencies = [
  "bucket_paths",
- "clap 4.5.13",
+ "clap 4.5.60",
  "cloud_storage",
  "config",
  "easyenv",
@@ -3289,7 +3289,7 @@ name = "dev-upload-media-file"
 version = "0.0.1"
 dependencies = [
  "bucket_paths",
- "clap 4.5.13",
+ "clap 4.5.60",
  "cloud_storage",
  "config",
  "easyenv",
@@ -3763,7 +3763,7 @@ name = "elasticsearch-cli"
 version = "0.0.1"
 dependencies = [
  "bucket_paths",
- "clap 4.5.13",
+ "clap 4.5.60",
  "config",
  "easyenv",
  "elasticsearch",
@@ -6744,7 +6744,7 @@ dependencies = [
 name = "lru-delete-models"
 version = "0.0.1"
 dependencies = [
- "clap 4.5.13",
+ "clap 4.5.60",
  "errors",
  "logging",
  "walkdir",
@@ -7054,7 +7054,7 @@ name = "migration-tool"
 version = "0.0.1"
 dependencies = [
  "bucket_paths",
- "clap 4.5.13",
+ "clap 4.5.60",
  "cloud_storage",
  "config",
  "easyenv",
@@ -10316,7 +10316,7 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 name = "scrape-test"
 version = "0.0.1"
 dependencies = [
- "clap 4.5.13",
+ "clap 4.5.60",
  "errors",
  "tokio",
  "web_scrapers",
@@ -11749,6 +11749,20 @@ dependencies = [
  "rsa",
 ]
 
+[[package]]
+name = "support-tool"
+version = "0.0.1"
+dependencies = [
+ "anyhow",
+ "clap 4.5.60",
+ "easyenv",
+ "errors",
+ "log",
+ "seedance2pro",
+ "serde_json",
+ "tokio",
+]
+
 [[package]]
 name = "swift-rs"
 version = "1.0.7"
@@ -14914,7 +14928,7 @@ dependencies = [
  "bytes",
  "cc",
  "chrono",
- "clap 4.5.13",
+ "clap 4.5.60",
  "cookie 0.18.1",
  "core-foundation-sys",
  "crossbeam-utils",

Cargo.toml

@@ -33,6 +33,7 @@ members = [
   "crates/cli/production/kubectl-pod-cleanup",
   "crates/cli/production/lru-delete-models",
   "crates/cli/production/migration-tool",
+  "crates/cli/production/support-tool",
 
   # Desktop apps
   "crates/desktop/artcraft",
@@ -222,6 +223,7 @@ component_traits = { path = "crates/service/plugins/component_traits" }
 cookie_store = { path = "crates/lib/cookie_store" }
 cookies = { path = "crates/lib/cookies" }
 crockford = { path = "crates/lib/data/crockford" }
+easyenv = { path = "crates/lib/easyenv" }
 enums = { path = "crates/schema/public/enums" }
 enums_public = { path = "crates/schema/public/enums_public" }
 errors = { path = "crates/lib/errors" }
@@ -271,6 +273,7 @@ base64 = "0.22.1"
 bstr = "1.12.1"
 bytes = "1.10.1"
 chrono = { version = "0.4.41", features = ["serde"] }
+clap = { version = "4.5.60", features = ["derive"] }
 cookie = "0.18.1"
 env = "1.0.1"
 env_logger = "0.11.9"

_database/sql/artcraft_migrations/20250708000000_create_tasks_table.sql

@@ -16,7 +16,9 @@
 --      on_complete_primary_media_file_class,
 --      on_complete_primary_media_file_cdn_url,
 --      on_complete_primary_media_file_thumbnail_url_template,
---
+--   tasks_v6.sqlite - added two fields:
+--      on_failure_type
+--      on_failure_message
 
 CREATE TABLE tasks (
     -- Task auto-incrementing primary key.
@@ -84,6 +86,15 @@ CREATE TABLE tasks (
     -- The URL template for the thumbnail of the primary media file.
     on_complete_primary_media_file_thumbnail_url_template TEXT,
 
+    -- OPTIONAL.
+    -- An enum-like string describing the failure reason (even for non-terminal failures).
+    -- The enum is `TaskFailureType`, which is a close analogue of the backend API's `FrontendFailureCategory`.
+    on_failure_type TEXT,
+
+    -- OPTIONAL.
+    -- A human-readable message describing the failure reason (even for non-terminal failures).
+    on_failure_message TEXT,
+
     created_at INTEGER NOT NULL DEFAULT (unixepoch('now')),
     updated_at INTEGER NOT NULL DEFAULT (unixepoch('now')),
     completed_at INTEGER DEFAULT NULL

crates/api_clients/artcraft/artcraft_api_defs/src/moderation/wallets/mod.rs

@@ -1,3 +1,4 @@
 pub mod list_user_wallets;
 pub mod moderator_add_banked_balance_to_wallet;
+pub mod moderator_create_wallet_for_user;
 pub mod moderator_get_wallet;

crates/api_clients/artcraft/artcraft_api_defs/src/moderation/wallets/moderator_create_wallet_for_user.rs

@@ -0,0 +1,19 @@
+use enums::common::payments_namespace::PaymentsNamespace;
+use serde_derive::{Deserialize, Serialize};
+use tokens::tokens::users::UserToken;
+use tokens::tokens::wallets::WalletToken;
+use utoipa::ToSchema;
+
+pub const MODERATOR_CREATE_WALLET_FOR_USER_PATH: &str = "/v1/moderation/wallet/create_for_user";
+
+#[derive(Deserialize, ToSchema)]
+pub struct ModeratorCreateWalletForUserRequest {
+  pub user_token: Option<UserToken>,
+  pub payments_namespace: Option<PaymentsNamespace>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct ModeratorCreateWalletForUserResponse {
+  pub success: bool,
+  pub wallet_token: WalletToken,
+}

crates/api_clients/seedance2pro/src/requests/poll_orders/failure_reason.rs

@@ -0,0 +1,26 @@
+use super::failure_type::FailureType;
+
+/// A structured failure reason parsed from the raw Seedance2 Pro API response.
+#[derive(Debug, Clone)]
+pub struct FailureReason {
+  /// The original reason string from the API.
+  pub reason: String,
+
+  /// The categorized failure type.
+  pub failure_type: FailureType,
+}
+
+impl FailureReason {
+  /// Parse a raw failure reason string into a structured `FailureReason`.
+  ///
+  /// First checks for exact string matches against known reasons,
+  /// then falls back to case-insensitive substring matching.
+  pub fn from_reason(reason: &str) -> Self {
+    let failure_type = FailureType::classify_text(reason);
+    FailureReason {
+      reason: reason.to_string(),
+      failure_type,
+    }
+  }
+}
+

crates/api_clients/seedance2pro/src/requests/poll_orders/failure_type.rs

@@ -0,0 +1,84 @@
+
+/// Categorized failure type for a Seedance2 Pro order.
+#[derive(Debug, Clone, PartialEq)]
+pub enum FailureType {
+  /// User's uploaded image was rejected by platform content rules.
+  RuleBansUserImage,
+  /// User's uploaded image was rejected because it contains faces.
+  RuleBansUserImageWithFaces,
+  /// User's text prompt was rejected by platform content rules.
+  RuleBansUserTextPrompt,
+  /// User's content (image or text) was rejected by platform content rules (generic).
+  RuleBansUserContent,
+  /// The generated video was rejected by platform content review.
+  RuleBansGeneratedVideo,
+  /// The generated audio was rejected by platform content rules.
+  RuleBansGeneratedAudio,
+  /// The generated content (video/audio/other) was rejected by platform content rules (generic).
+  RuleBansGeneratedContent,
+  /// Video generation failed (timeout, server error, processing error, etc.)
+  GenerationFailed,
+  /// An unrecognized or absent failure reason.
+  OtherUnknownReason,
+}
+
+impl FailureType {
+  pub fn classify_text(reason: &str) -> Self {
+    // --- Exact matches first ---
+    match reason {
+      "Your uploaded image violates platform rules. Please modify and try again." =>
+        return Self::RuleBansUserImage,
+      "Face detected in uploaded media. Please adjust your media and try again." =>
+        return Self::RuleBansUserImageWithFaces,
+      "Your input text violates platform rules. Please modify and try again." =>
+        return Self::RuleBansUserTextPrompt,
+      "Content violates platform rules. Please modify and try again." =>
+        return Self::RuleBansUserContent,
+      "The generated video did not pass review. Credits will not be deducted." =>
+        return Self::RuleBansGeneratedVideo,
+      "The generated audio violates platform rules. Please adjust your prompt or images and try again." =>
+        return Self::RuleBansGeneratedAudio,
+      "The generated content violates platform rules. Please adjust your prompt or images and try again." =>
+        return Self::RuleBansGeneratedContent,
+      "Video generation failed. Please try again." =>
+        return Self::GenerationFailed,
+      "Generation timed out. Please try again." =>
+        return Self::GenerationFailed,
+      "Server error. Please try again later." =>
+        return Self::GenerationFailed,
+      "Your content could not be processed. Please try different images or adjust your prompt." =>
+        return Self::GenerationFailed,
+      _ => {}
+    }
+
+    // --- Substring matches (case-insensitive) ---
+    let lower = reason.to_lowercase();
+
+    if lower.contains("face detected") || lower.contains("ensure no faces") {
+      return Self::RuleBansUserImageWithFaces;
+    }
+    if lower.contains("uploaded image violates") {
+      return Self::RuleBansUserImage;
+    }
+    if lower.contains("input text violates") {
+      return Self::RuleBansUserTextPrompt;
+    }
+    if lower.contains("generated video") && lower.contains("not pass review") {
+      return Self::RuleBansGeneratedVideo;
+    }
+    if lower.contains("generated audio") && lower.contains("violates") {
+      return Self::RuleBansGeneratedAudio;
+    }
+    if lower.contains("generated content") && lower.contains("violates") {
+      return Self::RuleBansGeneratedContent;
+    }
+    if lower.contains("content violates") || lower.contains("platform rules") {
+      return Self::RuleBansUserContent;
+    }
+    if lower.contains("video generation failed") || lower.contains("timed out") || lower.contains("server error") {
+      return Self::GenerationFailed;
+    }
+
+    Self::OtherUnknownReason
+  }
+}

crates/api_clients/seedance2pro/src/requests/poll_orders/mod.rs

@@ -1,2 +1,4 @@
+pub mod failure_reason;
+pub mod failure_type;
 pub mod poll_orders;
 mod request_types;

crates/api_clients/seedance2pro/src/requests/poll_orders/poll_orders.rs

@@ -2,6 +2,7 @@ use crate::creds::seedance2pro_session::Seedance2ProSession;
 use crate::error::seedance2pro_client_error::Seedance2ProClientError;
 use crate::error::seedance2pro_error::Seedance2ProError;
 use crate::error::seedance2pro_generic_api_error::Seedance2ProGenericApiError;
+use crate::requests::poll_orders::failure_reason::FailureReason;
 use crate::requests::poll_orders::request_types::*;
 use crate::utils::common_headers::FIREFOX_USER_AGENT;
 use log::info;
@@ -10,17 +11,6 @@ use wreq_util::Emulation;
 
 const GET_ORDERS_BASE_URL: &str = "https://seedance2-pro.com/api/trpc/userOrder.getOrders";
 
-/// Builds the tRPC `input` JSON for the getOrders endpoint.
-/// When `cursor` is `Some`, it is included in the JSON payload.
-fn build_input_json(cursor: Option<u64>) -> String {
-  match cursor {
-    None => r#"{"0":{"json":{"limit":30,"format":null,"direction":"forward"},"meta":{"values":{"format":["undefined"]},"v":1}}}"#.to_string(),
-    Some(c) => format!(
-      r#"{{"0":{{"json":{{"limit":30,"format":null,"cursor":{cursor},"direction":"forward"}},"meta":{{"values":{{"format":["undefined"]}},"v":1}}}}}}"#,
-      cursor = c
-    ),
-  }
-}
 
 // --- Args & response ---
 
@@ -97,8 +87,8 @@ pub struct OrderStatus {
   /// Detailed result entries. Typically one entry per video.
   pub results: Vec<VideoResult>,
 
-  /// Failure reason. Populated when `task_status` is `Failed`.
-  pub fail_reason: Option<String>,
+  /// Structured failure reason. Populated when `task_status` is `Failed` or `fail_reason` is present.
+  pub fail_reason: Option<FailureReason>,
 
   /// ISO 8601 creation timestamp (e.g. `"2026-02-19T01:20:50.398Z"`).
   pub created_at: String,
@@ -172,18 +162,25 @@ pub async fn poll_orders(args: PollOrdersArgs<'_>) -> Result<PollOrdersResponse,
 
   let orders: Vec<OrderStatus> = json.orders
     .into_iter()
-    .map(|o| OrderStatus {
-      order_id: o.order_id,
-      task_status: TaskStatus::from_str(&o.task_status),
-      result_url: o.result_url,
-      results: o.results.into_iter().map(|r| VideoResult {
-        url: r.url,
-        width: r.width,
-        height: r.height,
-        // ratio: r.ratio,
-      }).collect(),
-      fail_reason: o.fail_reason,
-      created_at: o.created_at,
+    .map(|o| {
+      let task_status = TaskStatus::from_str(&o.task_status);
+      let fail_reason = match (&o.fail_reason, &task_status) {
+        (Some(reason), _) => Some(FailureReason::from_reason(reason)),
+        (None, TaskStatus::Failed) => Some(FailureReason::from_reason("(no reason)")),
+        _ => None,
+      };
+      OrderStatus {
+        order_id: o.order_id,
+        task_status,
+        result_url: o.result_url,
+        results: o.results.into_iter().map(|r| VideoResult {
+          url: r.url,
+          width: r.width,
+          height: r.height,
+        }).collect(),
+        fail_reason,
+        created_at: o.created_at,
+      }
     })
     .collect();
 
@@ -192,6 +189,18 @@ pub async fn poll_orders(args: PollOrdersArgs<'_>) -> Result<PollOrdersResponse,
   Ok(PollOrdersResponse { orders, next_cursor })
 }
 
+/// Builds the tRPC `input` JSON for the getOrders endpoint.
+/// When `cursor` is `Some`, it is included in the JSON payload.
+fn build_input_json(cursor: Option<u64>) -> String {
+  match cursor {
+    None => r#"{"0":{"json":{"limit":30,"format":null,"direction":"forward"},"meta":{"values":{"format":["undefined"]},"v":1}}}"#.to_string(),
+    Some(c) => format!(
+      r#"{{"0":{{"json":{{"limit":30,"format":null,"cursor":{cursor},"direction":"forward"}},"meta":{{"values":{{"format":["undefined"]}},"v":1}}}}}}"#,
+      cursor = c
+    ),
+  }
+}
+
 #[cfg(test)]
 mod tests {
   use super::*;

crates/cli/production/support-tool/Cargo.toml

@@ -0,0 +1,22 @@
+[package]
+name = "support-tool"
+edition = "2024"
+version = "0.0.1"
+
+[[bin]]
+name = "support-tool"
+path = "src/main.rs"
+
+[dependencies]
+easyenv.workspace = true
+
+# Internal
+errors.workspace = true
+seedance2pro.workspace = true
+
+# External
+anyhow.workspace = true
+clap.workspace = true
+log.workspace = true
+serde_json.workspace = true
+tokio.workspace = true

crates/cli/production/support-tool/src/commands/mod.rs

@@ -0,0 +1,2 @@
+pub mod run;
+pub mod seedance2pro;

crates/cli/production/support-tool/src/commands/run.rs

@@ -0,0 +1,36 @@
+use clap::{Parser, Subcommand};
+
+use super::seedance2pro;
+
+/// All canonical subcommand names across all modules.
+/// Used by the underscore-insensitive arg normalizer.
+pub fn all_canonical_names() -> Vec<&'static str> {
+  let mut names: Vec<&str> = vec!["seedance2pro"];
+  names.extend_from_slice(seedance2pro::dispatch::SUBCOMMAND_NAMES);
+  names
+}
+
+#[derive(Parser)]
+#[command(name = "support-tool", about = "Production support CLI")]
+pub struct Cli {
+  #[command(subcommand)]
+  pub command: TopLevelCommand,
+}
+
+#[derive(Subcommand)]
+#[command(rename_all = "snake_case")]
+pub enum TopLevelCommand {
+  /// Seedance2 Pro support commands
+  Seedance2pro {
+    #[command(subcommand)]
+    command: seedance2pro::Seedance2proCommand,
+  },
+}
+
+pub async fn run(cli: Cli) -> anyhow::Result<()> {
+  match cli.command {
+    TopLevelCommand::Seedance2pro { command } => {
+      seedance2pro::run(command).await
+    }
+  }
+}

crates/cli/production/support-tool/src/commands/seedance2pro/dispatch.rs

@@ -0,0 +1,31 @@
+use anyhow::anyhow;
+use clap::Subcommand;
+
+use super::state::Seedance2ProState;
+use super::subcommands;
+
+/// All canonical subcommand names for this module.
+/// Used by the underscore-insensitive arg normalizer.
+pub const SUBCOMMAND_NAMES: &[&str] = &["find_job", "failed_job_histogram"];
+
+#[derive(Subcommand)]
+#[command(rename_all = "snake_case")]
+pub enum Seedance2proCommand {
+  /// Find a job by its order ID across all pages
+  FindJob(subcommands::find_job::FindJobArgs),
+
+  /// Scan all jobs and print a histogram of failure reasons
+  FailedJobHistogram,
+}
+
+pub async fn run(command: Seedance2proCommand) -> anyhow::Result<()> {
+  let cookies = easyenv::get_env_string_required("SEEDANCE2PRO_COOKIES")
+    .map_err(|err| anyhow!("Missing SEEDANCE2PRO_COOKIES env var: {:?}", err))?;
+
+  let state = Seedance2ProState { cookies };
+
+  match command {
+    Seedance2proCommand::FindJob(args) => subcommands::find_job::run(&state, args).await,
+    Seedance2proCommand::FailedJobHistogram => subcommands::failed_job_histogram::run(&state).await,
+  }
+}

crates/cli/production/support-tool/src/commands/seedance2pro/mod.rs

@@ -0,0 +1,6 @@
+pub mod dispatch;
+mod state;
+mod subcommands;
+
+pub use dispatch::Seedance2proCommand;
+pub use dispatch::run;

crates/cli/production/support-tool/src/commands/seedance2pro/state.rs

@@ -0,0 +1,3 @@
+pub struct Seedance2ProState {
+  pub cookies: String,
+}

crates/cli/production/support-tool/src/commands/seedance2pro/subcommands/failed_job_histogram.rs

@@ -0,0 +1,94 @@
+use std::collections::BTreeMap;
+
+use anyhow::anyhow;
+use log::info;
+use seedance2pro::creds::seedance2pro_session::Seedance2ProSession;
+use seedance2pro::requests::poll_orders::failure_type::FailureType;
+use seedance2pro::requests::poll_orders::poll_orders::{poll_orders, PollOrdersArgs, TaskStatus};
+
+use super::super::state::Seedance2ProState;
+
+pub async fn run(state: &Seedance2ProState) -> anyhow::Result<()> {
+  let session = Seedance2ProSession::from_cookies_string(state.cookies.clone());
+
+  let mut cursor: Option<u64> = None;
+  let mut page = 0usize;
+  let mut total_orders = 0usize;
+  let mut failed_count = 0usize;
+  let mut histogram: BTreeMap<String, usize> = BTreeMap::new();
+
+  loop {
+    page += 1;
+    info!("Fetching page {} (cursor: {:?})...", page, cursor);
+
+    let result = poll_orders(PollOrdersArgs {
+      session: &session,
+      cursor,
+    }).await
+      .map_err(|err| anyhow!("Error polling orders on page {}: {:?}", page, err))?;
+
+    let page_count = result.orders.len();
+    total_orders += page_count;
+
+    for order in &result.orders {
+      if order.task_status == TaskStatus::Failed {
+        failed_count += 1;
+        let reason = order.fail_reason.as_ref()
+          .map(|fr| fr.reason.as_str())
+          .unwrap_or("(no reason)");
+        *histogram.entry(reason.to_string()).or_insert(0) += 1;
+      }
+    }
+
+    info!("Page {}: {} orders ({} failed so far).", page, page_count, failed_count);
+
+    cursor = result.next_cursor;
+    if cursor.is_none() {
+      break;
+    }
+  }
+
+  println!("\nScanned {} orders across {} pages.", total_orders, page);
+  println!("Failed: {}\n", failed_count);
+
+  if histogram.is_empty() {
+    println!("No failed jobs found.");
+    return Ok(());
+  }
+
+  // Sort by count descending.
+  let mut sorted: Vec<(&String, &usize)> = histogram.iter().collect();
+  sorted.sort_by(|a, b| b.1.cmp(a.1));
+
+  println!("{:<6}  {}", "Count", "Failure Reason");
+  println!("{:<6}  {}", "-----", "--------------");
+  for (reason, count) in &sorted {
+    println!("{:<6}  {}", count, reason);
+  }
+
+  // Build a second histogram by FailureType.
+  let mut type_histogram: BTreeMap<String, usize> = BTreeMap::new();
+  for (reason, count) in &histogram {
+    let failure_type = FailureType::classify_text(reason);
+    *type_histogram.entry(format!("{:?}", failure_type)).or_insert(0) += count;
+  }
+
+  let mut type_sorted: Vec<(&String, &usize)> = type_histogram.iter().collect();
+  type_sorted.sort_by(|a, b| b.1.cmp(a.1));
+
+  println!("\n{:<6}  {}", "Count", "Failure Type");
+  println!("{:<6}  {}", "-----", "------------");
+  for (failure_type, count) in &type_sorted {
+    println!("{:<6}  {}", count, failure_type);
+  }
+
+  // Print reason → type mapping table.
+  println!("\n{:<30}  {}", "Failure Type", "Failure Reason");
+  println!("{:<30}  {}", "------------", "--------------");
+  for (reason, _) in &sorted {
+    let failure_type = FailureType::classify_text(reason);
+    println!("{:<30}  {}", format!("{:?}", failure_type), reason);
+  }
+
+  Ok(())
+}

crates/cli/production/support-tool/src/commands/seedance2pro/subcommands/find_job.rs

@@ -0,0 +1,67 @@
+use anyhow::anyhow;
+use clap::Args;
+use log::info;
+use seedance2pro::creds::seedance2pro_session::Seedance2ProSession;
+use seedance2pro::requests::poll_orders::poll_orders::{poll_orders, PollOrdersArgs};
+
+use super::super::state::Seedance2ProState;
+
+#[derive(Args)]
+pub struct FindJobArgs {
+  /// The order ID (job token) to search for
+  #[arg(long)]
+  pub token: String,
+}
+
+pub async fn run(state: &Seedance2ProState, args: FindJobArgs) -> anyhow::Result<()> {
+  let session = Seedance2ProSession::from_cookies_string(state.cookies.clone());
+
+  let mut cursor: Option<u64> = None;
+  let mut page = 0usize;
+
+  loop {
+    page += 1;
+    info!("Fetching page {} (cursor: {:?})...", page, cursor);
+
+    let result = poll_orders(PollOrdersArgs {
+      session: &session,
+      cursor,
+    }).await
+      .map_err(|err| anyhow!("Error polling orders on page {}: {:?}", page, err))?;
+
+    for order in &result.orders {
+      if order.order_id == args.token {
+        println!("{}", serde_json::to_string_pretty(&order_to_json(order))?);
+        return Ok(());
+      }
+    }
+
+    info!("Page {}: checked {} orders, no match.", page, result.orders.len());
+
+    cursor = result.next_cursor;
+    if cursor.is_none() {
+      break;
+    }
+  }
+
+  eprintln!("Order '{}' not found after {} pages.", args.token, page);
+  std::process::exit(1);
+}
+
+fn order_to_json(order: &seedance2pro::requests::poll_orders::poll_orders::OrderStatus) -> serde_json::Value {
+  serde_json::json!({
+    "order_id": order.order_id,
+    "task_status": format!("{:?}", order.task_status),
+    "result_url": order.result_url,
+    "fail_reason": order.fail_reason.as_ref().map(|fr| fr.reason.as_str()),
+    "failure_type": order.fail_reason.as_ref().map(|fr| format!("{:?}", fr.failure_type)),
+    "created_at": order.created_at,
+    "results": order.results.iter().map(|r| {
+      serde_json::json!({
+        "url": r.url,
+        "width": r.width,
+        "height": r.height,
+      })
+    }).collect::<Vec<_>>(),
+  })
+}

crates/cli/production/support-tool/src/commands/seedance2pro/subcommands/mod.rs

@@ -0,0 +1,2 @@
+pub mod failed_job_histogram;
+pub mod find_job;

crates/cli/production/support-tool/src/main.rs

@@ -0,0 +1,24 @@
+mod commands;
+mod utils;
+
+use clap::Parser;
+use commands::run::{Cli, all_canonical_names};
+use utils::normalize_subcommands::normalize_subcommand_args;
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+  // Normalize args so underscores in subcommand names are optional.
+  let canonical_names = all_canonical_names();
+  let args = normalize_subcommand_args(std::env::args(), &canonical_names);
+
+  // Parse CLI args first so --help works without the env file.
+  let cli = Cli::parse_from(args);
+
+  // Load secrets from .env file.
+  easyenv::from_filename(".env-support-tool-secrets")
+    .expect("Failed to load .env-support-tool-secrets");
+
+  easyenv::init_env_logger(Some("info"));
+
+  commands::run::run(cli).await
+}

crates/cli/production/support-tool/src/utils/mod.rs

@@ -0,0 +1 @@
+pub mod normalize_subcommands;

crates/cli/production/support-tool/src/utils/normalize_subcommands.rs

@@ -0,0 +1,27 @@
+/// Normalize CLI args so that underscores in subcommand names are optional.
+///
+/// For each arg that isn't a flag (doesn't start with `-`), if removing all
+/// underscores from the arg matches removing all underscores from a canonical
+/// name, the arg is replaced with the canonical name.
+///
+/// This lets users type `findjob`, `find_job`, or even `f_ind_job` and all
+/// resolve to the canonical `find_job`.
+pub fn normalize_subcommand_args(
+  args: impl IntoIterator<Item = String>,
+  canonical_names: &[&str],
+) -> Vec<String> {
+  args.into_iter()
+    .map(|arg| {
+      if arg.starts_with('-') {
+        return arg;
+      }
+      let stripped = arg.replace('_', "").to_lowercase();
+      for &name in canonical_names {
+        if name.replace('_', "").to_lowercase() == stripped {
+          return name.to_string();
+        }
+      }
+      arg
+    })
+    .collect()
+}

crates/desktop/artcraft/src/core/commands/task_queue/get_task_queue_command.rs

@@ -18,6 +18,7 @@ use serde_derive::{Deserialize, Serialize};
 use sqlite_tasks::queries::list_tasks_for_frontend::list_tasks_for_frontend;
 use artcraft_client::endpoints::media_files::delete_media_file::delete_media_file;
 use tauri::{AppHandle, State};
+use enums::tauri::tasks::task_failure_type::TaskFailureType;
 use enums::tauri::tasks::task_media_file_class::TaskMediaFileClass;
 use tokens::tokens::batch_generations::BatchGenerationToken;
 use tokens::tokens::media_files::MediaFileToken;
@@ -31,12 +32,20 @@ pub struct GetTaskQueueCommandResponse {
 #[derive(Serialize)]
 pub struct TaskQueueItem {
   pub id: TaskId,
+
   pub task_status: TaskStatus,
   pub task_type: TaskType,
   pub model_type: Option<TaskModelType>,
+
   pub provider: Option<GenerationProvider>,
   pub provider_job_id: Option<String>,
+
+  /// If the item is done, these will be filled out.
   pub completed_item: Option<CompletedItemData>,
+
+  /// If the item failed, this will be filled out.
+  pub failure_reason: Option<FailedItemData>,
+
   pub created_at: DateTime<Utc>,
   pub updated_at: DateTime<Utc>,
   pub completed_at: Option<DateTime<Utc>>,
@@ -63,6 +72,12 @@ pub struct MediaFileData {
   pub created_at: DateTime<Utc>,
 }
 
+#[derive(Serialize)]
+pub struct FailedItemData {
+  pub failure_type: TaskFailureType,
+  pub failure_message: Option<String>,
+}
+
 impl SerializeMarker for GetTaskQueueCommandResponse {}
 
 #[tauri::command]
@@ -103,6 +118,7 @@ pub async fn handle_request(
 
   for task in tasks.tasks.into_iter() {
     let mut completed_item = None;
+    let mut failure_reason = None;
 
     if task.status == TaskStatus::CompleteSuccess {
       let token_and_url = task.on_complete_primary_media_file_token
@@ -123,6 +139,19 @@ pub async fn handle_request(
       } else {
         warn!("Task {} is marked complete but has no primary media file token or URL.", task.id);
       }
+    } else {
+      // If either failure field is present, fill out the failure report.
+      if let Some(failure_message) = task.on_failure_message.as_deref() {
+        failure_reason = Some(FailedItemData {
+          failure_type: task.on_failure_type.unwrap_or(TaskFailureType::Unknown),
+          failure_message: Some(failure_message.to_string()),
+        });
+      } else if let Some(failure_type) = task.on_failure_type {
+        failure_reason = Some(FailedItemData {
+          failure_type,
+          failure_message: None,
+        });
+      }
     }
 
     transformed_tasks.push(TaskQueueItem {
@@ -136,6 +165,7 @@ pub async fn handle_request(
       updated_at: task.updated_at,
       completed_at: task.completed_at,
       completed_item,
+      failure_reason,
     })
   }
 

crates/desktop/artcraft/src/core/lifecycle/startup/tasks/spawn_storyteller_threads.rs

@@ -4,7 +4,7 @@ use crate::core::state::artcraft_usage_tracker::artcraft_usage_tracker::Artcraft
 use crate::core::state::task_database::TaskDatabase;
 use crate::services::storyteller::state::storyteller_credential_manager::StorytellerCredentialManager;
 use crate::services::storyteller::threads::storyteller_activity_thread::storyteller_activity_thread;
-use crate::services::storyteller::threads::storyteller_task_polling_thread::storyteller_task_polling_thread;
+use crate::services::storyteller::threads::storyteller_task_polling_thread::storyteller_task_polling_thread::storyteller_task_polling_thread;
 use errors::AnyhowResult;
 use tauri::{AppHandle, Manager};
 

crates/desktop/artcraft/src/core/state/task_database_version.rs

@@ -7,4 +7,4 @@
 /// We increment this whenever we make a change to the database schema.
 /// This prevents deadlock on startup if the schema has changed from the
 /// previous version.
-pub const TASK_DATABASE_VERSION: u32 = 5;
+pub const TASK_DATABASE_VERSION: u32 = 6;

crates/desktop/artcraft/src/services/storyteller/threads/mod.rs

@@ -1,3 +1,2 @@
-pub mod events;
 pub mod storyteller_activity_thread;
 pub mod storyteller_task_polling_thread;

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_activity_thread.rs

@@ -1,34 +1,16 @@
-use crate::core::events::basic_sendable_event_trait::BasicSendableEvent;
 use crate::core::state::app_env_configs::app_env_configs::AppEnvConfigs;
 use crate::core::state::artcraft_platform_info::ArtcraftPlatformInfo;
 use crate::core::state::artcraft_usage_tracker::artcraft_usage_tracker::ArtcraftUsageTracker;
-use crate::core::state::data_dir::app_data_root::AppDataRoot;
-use crate::core::state::data_dir::trait_data_subdir::DataSubdir;
-use crate::core::state::os_platform::OsPlatform;
-use crate::core::state::task_database::TaskDatabase;
 use crate::services::storyteller::state::storyteller_credential_manager::StorytellerCredentialManager;
 use anyhow::anyhow;
 use artcraft_api_defs::analytics::log_active_user::LogAppActiveUserRequest;
-use artcraft_api_defs::jobs::list_session_jobs::ListSessionJobsItem;
-use enums::common::generation_provider::GenerationProvider;
-use enums::common::job_status_plus::JobStatusPlus;
-use enums::tauri::tasks::task_status::TaskStatus;
-use enums::tauri::tasks::task_type::TaskType;
-use errors::AnyhowResult;
-use log::{debug, error, info};
-use os_info::Info;
-use reqwest::Url;
-use sqlite_tasks::queries::list_tasks_by_provider_and_tokens::{list_tasks_by_provider_and_tokens, ListTasksArgs};
-use sqlite_tasks::queries::update_task_status::{update_task_status, UpdateTaskArgs};
-use std::time::Instant;
-use artcraft_client::credentials::storyteller_credential_set::StorytellerCredentialSet;
-use artcraft_client::endpoints::analytics::log_active_user::log_active_user;
 use artcraft_client::endpoints::analytics::log_active_user_v2::log_active_user_v2;
-use artcraft_client::endpoints::jobs::list_session_jobs::{list_session_jobs, States};
-use artcraft_client::endpoints::media_files::upload_image_media_file_from_file::upload_image_media_file_from_file;
 use artcraft_client::error::api_error::ApiError;
 use artcraft_client::error::storyteller_error::StorytellerError;
-use tauri::AppHandle;
+use errors::AnyhowResult;
+use log::{debug, error, info};
+use sqlite_tasks::queries::list_tasks_by_provider_and_tokens::{list_tasks_by_provider_and_tokens, ListTasksArgs};
+use std::time::Instant;
 use tokens::tokens::app_session::AppSessionToken;
 
 const CLIENT_NAME : &str = "artcraft";

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_task_polling_thread.rs

@@ -1,339 +0,0 @@
-use crate::core::events::basic_sendable_event_trait::BasicSendableEvent;
-use crate::core::events::generation_events::common::{GenerationAction, GenerationServiceProvider};
-use crate::core::events::generation_events::generation_complete_event::GenerationCompleteEvent;
-use crate::core::events::generation_events::generation_failed_event::GenerationFailedEvent;
-use crate::core::events::sendable_event_trait::SendableEvent;
-use crate::core::state::app_env_configs::app_env_configs::AppEnvConfigs;
-use crate::core::state::data_dir::app_data_root::AppDataRoot;
-use crate::core::state::data_dir::trait_data_subdir::DataSubdir;
-use crate::core::state::task_database::TaskDatabase;
-use crate::core::utils::enum_conversion::generation_provider::to_generation_service_provider;
-use crate::core::utils::enum_conversion::task_type::to_generation_action;
-use crate::services::sora::state::sora_credential_manager::SoraCredentialManager;
-use crate::services::sora::state::sora_task_queue::SoraTaskQueue;
-use crate::services::storyteller::state::storyteller_credential_manager::StorytellerCredentialManager;
-use crate::services::storyteller::threads::events::maybe_handle_frontend_caller_notification::maybe_handle_frontend_caller_notification;
-use crate::services::storyteller::threads::events::maybe_handle_inpainting_complete_event::maybe_handle_inpainting_complete_event;
-use crate::services::storyteller::threads::events::maybe_handle_text_to_image_complete_event::maybe_handle_text_to_image_complete_event;
-use crate::services::storyteller::threads::events::maybe_send_background_removal_complete_event::maybe_send_background_removal_complete_event;
-use anyhow::anyhow;
-use artcraft_api_defs::jobs::list_session_jobs::ListSessionJobsItem;
-use artcraft_api_defs::utils::media_links_to_thumbnail_template::media_links_to_thumbnail_template;
-use enums::by_table::generic_inference_jobs::inference_category::InferenceCategory;
-use enums::common::generation_provider::GenerationProvider;
-use enums::common::job_status_plus::JobStatusPlus;
-use enums::tauri::tasks::task_media_file_class::TaskMediaFileClass;
-use enums::tauri::tasks::task_status::TaskStatus;
-use enums::tauri::tasks::task_type::TaskType;
-use errors::AnyhowResult;
-use log::{error, info};
-use reqwest::Url;
-use sqlite_tasks::queries::list_tasks_by_provider_and_tokens::{list_tasks_by_provider_and_tokens, ListTasksArgs};
-use sqlite_tasks::queries::task::Task;
-use sqlite_tasks::queries::update_successful_task_status_with_metadata::{update_successful_task_status_with_metadata, UpdateSuccessfulTaskArgs};
-use sqlite_tasks::queries::update_task_status::{update_task_status, UpdateTaskArgs};
-use std::collections::HashMap;
-use std::fs::File;
-use std::io::Write;
-use std::path::PathBuf;
-use artcraft_client::credentials::storyteller_credential_set::StorytellerCredentialSet;
-use artcraft_client::endpoints::jobs::list_session_jobs::{list_session_jobs, States};
-use artcraft_client::endpoints::media_files::upload_image_media_file_from_file::upload_image_media_file_from_file;
-use artcraft_client::error::api_error::ApiError;
-use artcraft_client::error::storyteller_error::StorytellerError;
-use tauri::AppHandle;
-use tempdir::TempDir;
-use tokens::tokens::media_files::MediaFileToken;
-
-pub async fn storyteller_task_polling_thread(
-  app_handle: AppHandle,
-  app_env_configs: AppEnvConfigs,
-  task_database: TaskDatabase,
-  storyteller_creds_manager: StorytellerCredentialManager,
-) -> ! {
-  loop {
-    let res = polling_loop(
-      &app_handle,
-      &app_env_configs,
-      &task_database,
-      &storyteller_creds_manager,
-    ).await;
-    if let Err(err) = res {
-      error!("An error occurred: {:?}", err);
-    }
-    // NB: Only sleep if an error occurs.
-    tokio::time::sleep(std::time::Duration::from_millis(30_000)).await;
-  }
-}
-
-async fn polling_loop(
-  app_handle: &AppHandle,
-  app_env_configs: &AppEnvConfigs,
-  task_database: &TaskDatabase,
-  storyteller_creds_manager: &StorytellerCredentialManager,
-) -> AnyhowResult<()> {
-  loop {
-    // Wait before next request for jobs.
-    tokio::time::sleep(std::time::Duration::from_millis(5_000)).await;
-
-    let creds = storyteller_creds_manager.get_credentials()?;
-
-    let result = list_session_jobs(
-      &app_env_configs.storyteller_host,
-      creds.as_ref(),
-      States::All,
-    ).await;
-
-    let jobs = match result {
-      Ok(result) => result.jobs,
-      Err(err) => {
-        match &err {
-          StorytellerError::Api(ApiError::TooManyRequests(message)) => {
-            error!("Too many requests (sleeping): {:?}", message);
-            tokio::time::sleep(std::time::Duration::from_millis(60_000)).await;
-          }
-          _ => {}
-        }
-        return Err(anyhow!(err));
-      }
-    };
-
-    let job_ids = jobs.iter()
-        .map(|job| job.job_token.to_string())
-        .collect::<Vec<_>>();
-
-    let tasks = list_tasks_by_provider_and_tokens(ListTasksArgs {
-      db: task_database.get_connection(),
-      provider: GenerationProvider::Artcraft,
-      provider_job_ids: Some(job_ids),
-    }).await?;
-
-    let tasks = tasks.tasks;
-
-    let jobs_by_id = jobs.iter()
-        .map(|job| (job.job_token.to_string(), job))
-        .collect::<HashMap<String, _>>();
-
-    let tasks_by_provider_job_id = tasks.iter()
-        .filter_map(|task| {
-          if let Some(provider_job_id) = &task.provider_job_id {
-            Some((provider_job_id.clone(), task.clone()))
-          } else {
-            None
-          }
-        })
-        //.map(|task| (task.provider_job_id.clone(), task.clone()))
-        .collect::<HashMap<String, Task>>();
-
-    for job in jobs.iter() {
-      let task = match tasks_by_provider_job_id.get(job.job_token.as_str()) {
-        Some(task) => task,
-        None => continue,
-      };
-
-      match job.status.status {
-        JobStatusPlus::CompleteSuccess => {
-          match task.status {
-            TaskStatus::CompleteSuccess => continue,
-            _ => {}
-          }
-          handle_successful_job(app_handle, app_env_configs, creds.as_ref(), job, task, task_database).await?;
-        }
-        JobStatusPlus::CompleteFailure => {
-          match task.status {
-            TaskStatus::CompleteFailure => continue,
-            _ => {}
-          }
-          handle_failed_job(app_handle, job, task, task_database).await?;
-        }
-        _ => continue,
-      }
-    }
-
-  }
-}
-
-async fn handle_successful_job(
-  app_handle: &AppHandle,
-  app_env_configs: &AppEnvConfigs,
-  creds: Option<&StorytellerCredentialSet>,
-  job: &ListSessionJobsItem,
-  task: &Task,
-  task_database: &TaskDatabase,
-) -> AnyhowResult<()> {
-  let maybe_primary_media_file_token = job.maybe_result
-      .as_ref()
-      .map(|result| MediaFileToken::new_from_str(&result.entity_token));
-
-  let updated = update_successful_task_status_with_metadata(UpdateSuccessfulTaskArgs {
-    db: task_database.get_connection(),
-    task_id: &task.id,
-    maybe_batch_token: job.maybe_result
-        .as_ref()
-        .map(|result| result.maybe_batch_token.as_ref())
-        .flatten(),
-    maybe_primary_media_file_token: maybe_primary_media_file_token.as_ref(),
-    maybe_primary_media_file_class: get_media_file_class(job),
-    maybe_primary_media_file_thumbnail_url_template: get_thumbnail_template(job),
-    maybe_primary_media_file_cdn_url: job.maybe_result
-        .as_ref()
-        .map(|result| result.media_links.cdn_url.as_str()),
-  }).await?;
-
-  if !updated {
-    return Ok(()); // If anything breaks with queries, don't spam events.
-  }
-
-  send_additional_success_events(app_handle, app_env_configs, creds, job, task).await;
-
-  let service = to_generation_service_provider(task.provider);
-  let action = to_generation_action(task.task_type);
-
-  let event = GenerationCompleteEvent {
-    action: Some(action),
-    service,
-    model: None, // TODO
-  };
-
-  if let Err(err) = event.send(app_handle) {
-    error!("Failed to send GenerationCompleteEvent: {:?}", err); // Fail open
-  }
-
-  Ok(())
-}
-
-async fn handle_failed_job(
-  app_handle: &AppHandle,
-  job: &ListSessionJobsItem,
-  task: &Task,
-  task_database: &TaskDatabase,
-) -> AnyhowResult<()> {
-  info!("Marking storyteller job as failed: {:?}", task.id);
-
-  update_task_status(UpdateTaskArgs {
-    db: task_database.get_connection(),
-    task_id: &task.id,
-    status: TaskStatus::CompleteFailure,
-  }).await?;
-
-  let service = to_generation_service_provider(task.provider);
-  let action = to_generation_action(task.task_type);
-
-  let event = GenerationFailedEvent {
-    action,
-    service,
-    model: None,
-    reason: None,
-  };
-
-  event.send_infallible(app_handle);
-
-  Ok(())
-}
-
-async fn send_additional_success_events(
-  app_handle: &AppHandle,
-  app_env_configs: &AppEnvConfigs,
-  creds: Option<&StorytellerCredentialSet>,
-  job: &ListSessionJobsItem,
-  task: &Task
-) {
-  info!("Attempting to dispatch events for completed Storyteller job: {:?}", task);
-
-  let result = maybe_handle_frontend_caller_notification(
-    app_handle,
-    app_env_configs,
-    creds,
-    task,
-    job,
-  ).await;
-
-  if let Err(err) = result {
-    error!("Failed to send generation complete event: {:?}", err);
-  }
-
-  //let result = maybe_handle_text_to_image_complete_event(
-  //  app_handle,
-  //  app_env_configs,
-  //  creds,
-  //  task,
-  //  job,
-  //).await;
-
-  //if let Err(err) = result {
-  //  error!("Failed to send text-to-image complete event: {:?}", err);
-  //}
-
-  //let result = maybe_handle_inpainting_complete_event(
-  //  app_handle,
-  //  app_env_configs,
-  //  creds,
-  //  task,
-  //  job,
-  //).await;
-
-  //if let Err(err) = result {
-  //  error!("Failed to send image inpainting complete event: {:?}", err);
-  //}
-
-  //let result = maybe_send_background_removal_complete_event(
-  //  app_handle,
-  //  task,
-  //  job,
-  //).await;
-
-  //if let Err(err) = result {
-  //  error!("Failed to send background removal complete event: {:?}", err);
-  //}
-}
-
-fn get_thumbnail_template<'a>(job: &'a ListSessionJobsItem) -> Option<&'a str> {
-  let links = match job.maybe_result.as_ref() {
-    None => return None,
-    Some(result) => &result.media_links,
-  };
-
-  media_links_to_thumbnail_template(links)
-}
-
-fn get_media_file_class<'a>(job: &'a ListSessionJobsItem) -> Option<TaskMediaFileClass> {
-  match job.request.inference_category {
-    InferenceCategory::BackgroundRemoval => return Some(TaskMediaFileClass::Image),
-    InferenceCategory::ImageGeneration => return Some(TaskMediaFileClass::Image),
-    InferenceCategory::VideoGeneration => return Some(TaskMediaFileClass::Video),
-    InferenceCategory::ObjectGeneration => return Some(TaskMediaFileClass::Dimensional),
-    _ => {}, // Fall-through
-  }
-
-  let result = match job.maybe_result.as_ref() {
-    None => return None,
-    Some(result) => result,
-  };
-
-  let url = result.media_links.cdn_url.as_str();
-
-  if url.ends_with("jpg")
-      || url.ends_with("jpeg")
-      || url.ends_with("png")
-  {
-    return Some(TaskMediaFileClass::Image);
-  }
-
-  if url.ends_with("mp4")
-      || url.ends_with("webm")
-  {
-    return Some(TaskMediaFileClass::Video);
-  }
-
-  if url.ends_with("glb") {
-    return Some(TaskMediaFileClass::Dimensional);
-  }
-
-  if url.ends_with("wav")
-      || url.ends_with("mp3")
-  {
-    return Some(TaskMediaFileClass::Audio);
-  }
-
-  None
-}

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_task_polling_thread/handle_storyteller_failed_job.rs

@@ -0,0 +1,41 @@
+use crate::core::events::basic_sendable_event_trait::BasicSendableEvent;
+use crate::core::events::generation_events::generation_failed_event::GenerationFailedEvent;
+use crate::core::state::task_database::TaskDatabase;
+use crate::core::utils::enum_conversion::generation_provider::to_generation_service_provider;
+use crate::core::utils::enum_conversion::task_type::to_generation_action;
+use artcraft_api_defs::jobs::list_session_jobs::ListSessionJobsItem;
+use enums::tauri::tasks::task_status::TaskStatus;
+use errors::AnyhowResult;
+use log::info;
+use sqlite_tasks::queries::task::Task;
+use sqlite_tasks::queries::update_task_status::{update_task_status, UpdateTaskArgs};
+use tauri::AppHandle;
+
+pub async fn handle_failed_job(
+  app_handle: &AppHandle,
+  job: &ListSessionJobsItem,
+  task: &Task,
+  task_database: &TaskDatabase,
+) -> AnyhowResult<()> {
+  info!("Marking storyteller job as failed: {:?}", task.id);
+
+  update_task_status(UpdateTaskArgs {
+    db: task_database.get_connection(),
+    task_id: &task.id,
+    status: TaskStatus::CompleteFailure,
+  }).await?;
+
+  let service = to_generation_service_provider(task.provider);
+  let action = to_generation_action(task.task_type);
+
+  let event = GenerationFailedEvent {
+    action,
+    service,
+    model: None,
+    reason: None,
+  };
+
+  event.send_infallible(app_handle);
+
+  Ok(())
+}

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_task_polling_thread/handle_storyteller_successful_job.rs

@@ -0,0 +1,177 @@
+use crate::core::events::basic_sendable_event_trait::BasicSendableEvent;
+use crate::core::events::generation_events::common::GenerationAction;
+use crate::core::events::generation_events::generation_complete_event::GenerationCompleteEvent;
+use crate::core::events::sendable_event_trait::SendableEvent;
+use crate::core::state::app_env_configs::app_env_configs::AppEnvConfigs;
+use crate::core::state::task_database::TaskDatabase;
+use crate::core::utils::enum_conversion::generation_provider::to_generation_service_provider;
+use crate::core::utils::enum_conversion::task_type::to_generation_action;
+use super::events::maybe_handle_frontend_caller_notification::maybe_handle_frontend_caller_notification;
+use artcraft_api_defs::jobs::list_session_jobs::ListSessionJobsItem;
+use artcraft_api_defs::utils::media_links_to_thumbnail_template::media_links_to_thumbnail_template;
+use artcraft_client::credentials::storyteller_credential_set::StorytellerCredentialSet;
+use enums::by_table::generic_inference_jobs::inference_category::InferenceCategory;
+use enums::tauri::tasks::task_media_file_class::TaskMediaFileClass;
+use errors::AnyhowResult;
+use log::error;
+use log::info;
+use sqlite_tasks::queries::task::Task;
+use sqlite_tasks::queries::update_successful_task_status_with_metadata::{update_successful_task_status_with_metadata, UpdateSuccessfulTaskArgs};
+use tauri::AppHandle;
+use tokens::tokens::media_files::MediaFileToken;
+
+pub async fn handle_successful_job(
+  app_handle: &AppHandle,
+  app_env_configs: &AppEnvConfigs,
+  creds: Option<&StorytellerCredentialSet>,
+  job: &ListSessionJobsItem,
+  task: &Task,
+  task_database: &TaskDatabase,
+) -> AnyhowResult<()> {
+  let maybe_primary_media_file_token = job.maybe_result
+      .as_ref()
+      .map(|result| MediaFileToken::new_from_str(&result.entity_token));
+
+  let updated = update_successful_task_status_with_metadata(UpdateSuccessfulTaskArgs {
+    db: task_database.get_connection(),
+    task_id: &task.id,
+    maybe_batch_token: job.maybe_result
+        .as_ref()
+        .map(|result| result.maybe_batch_token.as_ref())
+        .flatten(),
+    maybe_primary_media_file_token: maybe_primary_media_file_token.as_ref(),
+    maybe_primary_media_file_class: get_media_file_class(job),
+    maybe_primary_media_file_thumbnail_url_template: get_thumbnail_template(job),
+    maybe_primary_media_file_cdn_url: job.maybe_result
+        .as_ref()
+        .map(|result| result.media_links.cdn_url.as_str()),
+  }).await?;
+
+  if !updated {
+    return Ok(()); // If anything breaks with queries, don't spam events.
+  }
+
+  send_additional_success_events(app_handle, app_env_configs, creds, job, task).await;
+
+  let service = to_generation_service_provider(task.provider);
+  let action = to_generation_action(task.task_type);
+
+  let event = GenerationCompleteEvent {
+    action: Some(action),
+    service,
+    model: None, // TODO
+  };
+
+  if let Err(err) = event.send(app_handle) {
+    error!("Failed to send GenerationCompleteEvent: {:?}", err); // Fail open
+  }
+
+  Ok(())
+}
+
+async fn send_additional_success_events(
+  app_handle: &AppHandle,
+  app_env_configs: &AppEnvConfigs,
+  creds: Option<&StorytellerCredentialSet>,
+  job: &ListSessionJobsItem,
+  task: &Task
+) {
+  info!("Attempting to dispatch events for completed Storyteller job: {:?}", task);
+
+  let result = maybe_handle_frontend_caller_notification(
+    app_handle,
+    app_env_configs,
+    creds,
+    task,
+    job,
+  ).await;
+
+  if let Err(err) = result {
+    error!("Failed to send generation complete event: {:?}", err);
+  }
+
+  //let result = maybe_handle_text_to_image_complete_event(
+  //  app_handle,
+  //  app_env_configs,
+  //  creds,
+  //  task,
+  //  job,
+  //).await;
+
+  //if let Err(err) = result {
+  //  error!("Failed to send text-to-image complete event: {:?}", err);
+  //}
+
+  //let result = maybe_handle_inpainting_complete_event(
+  //  app_handle,
+  //  app_env_configs,
+  //  creds,
+  //  task,
+  //  job,
+  //).await;
+
+  //if let Err(err) = result {
+  //  error!("Failed to send image inpainting complete event: {:?}", err);
+  //}
+
+  //let result = maybe_send_background_removal_complete_event(
+  //  app_handle,
+  //  task,
+  //  job,
+  //).await;
+
+  //if let Err(err) = result {
+  //  error!("Failed to send background removal complete event: {:?}", err);
+  //}
+}
+
+fn get_thumbnail_template<'a>(job: &'a ListSessionJobsItem) -> Option<&'a str> {
+  let links = match job.maybe_result.as_ref() {
+    None => return None,
+    Some(result) => &result.media_links,
+  };
+
+  media_links_to_thumbnail_template(links)
+}
+
+fn get_media_file_class(job: &ListSessionJobsItem) -> Option<TaskMediaFileClass> {
+  match job.request.inference_category {
+    InferenceCategory::BackgroundRemoval => return Some(TaskMediaFileClass::Image),
+    InferenceCategory::ImageGeneration => return Some(TaskMediaFileClass::Image),
+    InferenceCategory::VideoGeneration => return Some(TaskMediaFileClass::Video),
+    InferenceCategory::ObjectGeneration => return Some(TaskMediaFileClass::Dimensional),
+    _ => {}, // Fall-through
+  }
+
+  let result = match job.maybe_result.as_ref() {
+    None => return None,
+    Some(result) => result,
+  };
+
+  let url = result.media_links.cdn_url.as_str();
+
+  if url.ends_with("jpg")
+      || url.ends_with("jpeg")
+      || url.ends_with("png")
+  {
+    return Some(TaskMediaFileClass::Image);
+  }
+
+  if url.ends_with("mp4")
+      || url.ends_with("webm")
+  {
+    return Some(TaskMediaFileClass::Video);
+  }
+
+  if url.ends_with("glb") {
+    return Some(TaskMediaFileClass::Dimensional);
+  }
+
+  if url.ends_with("wav")
+      || url.ends_with("mp3")
+  {
+    return Some(TaskMediaFileClass::Audio);
+  }
+
+  None
+}

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_task_polling_thread/mod.rs

@@ -0,0 +1,4 @@
+mod events;
+mod handle_storyteller_failed_job;
+mod handle_storyteller_successful_job;
+pub mod storyteller_task_polling_thread;

crates/desktop/artcraft/src/services/storyteller/threads/storyteller_task_polling_thread/storyteller_task_polling_thread.rs

@@ -0,0 +1,126 @@
+use crate::core::state::app_env_configs::app_env_configs::AppEnvConfigs;
+use crate::core::state::task_database::TaskDatabase;
+use crate::services::storyteller::state::storyteller_credential_manager::StorytellerCredentialManager;
+use crate::services::storyteller::threads::storyteller_task_polling_thread::handle_storyteller_failed_job::handle_failed_job;
+use crate::services::storyteller::threads::storyteller_task_polling_thread::handle_storyteller_successful_job::handle_successful_job;
+use anyhow::anyhow;
+use artcraft_client::endpoints::jobs::list_session_jobs::{list_session_jobs, States};
+use artcraft_client::error::api_error::ApiError;
+use artcraft_client::error::storyteller_error::StorytellerError;
+use enums::common::generation_provider::GenerationProvider;
+use enums::common::job_status_plus::JobStatusPlus;
+use enums::tauri::tasks::task_status::TaskStatus;
+use errors::AnyhowResult;
+use log::error;
+use sqlite_tasks::queries::list_tasks_by_provider_and_tokens::{list_tasks_by_provider_and_tokens, ListTasksArgs};
+use sqlite_tasks::queries::task::Task;
+use std::collections::HashMap;
+use tauri::AppHandle;
+
+pub async fn storyteller_task_polling_thread(
+  app_handle: AppHandle,
+  app_env_configs: AppEnvConfigs,
+  task_database: TaskDatabase,
+  storyteller_creds_manager: StorytellerCredentialManager,
+) -> ! {
+  loop {
+    let res = polling_loop(
+      &app_handle,
+      &app_env_configs,
+      &task_database,
+      &storyteller_creds_manager,
+    ).await;
+    if let Err(err) = res {
+      error!("An error occurred: {:?}", err);
+    }
+    // NB: Only sleep if an error occurs.
+    tokio::time::sleep(std::time::Duration::from_millis(30_000)).await;
+  }
+}
+
+async fn polling_loop(
+  app_handle: &AppHandle,
+  app_env_configs: &AppEnvConfigs,
+  task_database: &TaskDatabase,
+  storyteller_creds_manager: &StorytellerCredentialManager,
+) -> AnyhowResult<()> {
+  loop {
+    // Wait before next request for jobs.
+    tokio::time::sleep(std::time::Duration::from_millis(5_000)).await;
+
+    let creds = storyteller_creds_manager.get_credentials()?;
+
+    let result = list_session_jobs(
+      &app_env_configs.storyteller_host,
+      creds.as_ref(),
+      States::All,
+    ).await;
+
+    let jobs = match result {
+      Ok(result) => result.jobs,
+      Err(err) => {
+        match &err {
+          StorytellerError::Api(ApiError::TooManyRequests(message)) => {
+            error!("Too many requests (sleeping): {:?}", message);
+            tokio::time::sleep(std::time::Duration::from_millis(60_000)).await;
+          }
+          _ => {}
+        }
+        return Err(anyhow!(err));
+      }
+    };
+
+    let job_ids = jobs.iter()
+        .map(|job| job.job_token.to_string())
+        .collect::<Vec<_>>();
+
+    let tasks = list_tasks_by_provider_and_tokens(ListTasksArgs {
+      db: task_database.get_connection(),
+      provider: GenerationProvider::Artcraft,
+      provider_job_ids: Some(job_ids),
+    }).await?;
+
+    let tasks = tasks.tasks;
+
+    let jobs_by_id = jobs.iter()
+        .map(|job| (job.job_token.to_string(), job))
+        .collect::<HashMap<String, _>>();
+
+    let tasks_by_provider_job_id = tasks.iter()
+        .filter_map(|task| {
+          if let Some(provider_job_id) = &task.provider_job_id {
+            Some((provider_job_id.clone(), task.clone()))
+          } else {
+            None
+          }
+        })
+        //.map(|task| (task.provider_job_id.clone(), task.clone()))
+        .collect::<HashMap<String, Task>>();
+
+    for job in jobs.iter() {
+      let task = match tasks_by_provider_job_id.get(job.job_token.as_str()) {
+        Some(task) => task,
+        None => continue,
+      };
+
+      match job.status.status {
+        JobStatusPlus::CompleteSuccess => {
+          match task.status {
+            TaskStatus::CompleteSuccess => continue, // NB: We're done with this task.
+            _ => {}
+          }
+          handle_successful_job(app_handle, app_env_configs, creds.as_ref(), job, task, task_database).await?;
+        }
+        JobStatusPlus::CompleteFailure => {
+          match task.status {
+            TaskStatus::CompleteFailure => continue, // NB: We're done with this task.
+            _ => {}
+          }
+          handle_failed_job(app_handle, job, task, task_database).await?;
+        }
+        _ => continue,
+      }
+    }
+
+  }
+}

crates/schema/database/mysql_queries/src/queries/users/user/get/get_username_by_user_token.rs

@@ -0,0 +1,45 @@
+use log::warn;
+use sqlx::MySqlPool;
+
+use crate::errors::select_optional_record_error::SelectOptionalRecordError;
+use tokens::tokens::users::UserToken;
+
+pub struct UsernameDetails {
+  pub username: String,
+  pub display_name: String,
+  pub username_is_generated: bool,
+  pub username_is_not_customized: bool,
+}
+
+pub async fn get_username_by_user_token(
+  user_token: &UserToken,
+  pool: &MySqlPool,
+) -> Result<Option<UsernameDetails>, SelectOptionalRecordError> {
+  let result = sqlx::query_as!(
+    UsernameDetails,
+    r#"
+SELECT
+  username,
+  display_name,
+  username_is_generated as `username_is_generated: bool`,
+  username_is_not_customized as `username_is_not_customized: bool`
+FROM users
+WHERE
+  token = ?
+  AND user_deleted_at IS NULL
+  AND mod_deleted_at IS NULL
+LIMIT 1
+    "#,
+    user_token.as_str(),
+  )
+    .fetch_optional(pool)
+    .await;
+
+  match result {
+    Ok(maybe_record) => Ok(maybe_record),
+    Err(err) => {
+      warn!("get_username_by_user_token query error: {:?}", err);
+      Err(err.into())
+    }
+  }
+}

crates/schema/database/mysql_queries/src/queries/users/user/get/mod.rs

@@ -1,4 +1,5 @@
 pub mod get_user_token_by_username;
+pub mod get_username_by_user_token;
 pub mod lookup_user_for_login_by_email;
 pub mod lookup_user_for_login_by_email_with_transactor;
 pub mod lookup_user_for_login_by_username;

crates/schema/database/mysql_queries/src/queries/wallets/create_new_artcraft_wallet_for_owner_user.rs

@@ -1,44 +1,12 @@
-use crate::queries::wallet_ledger_entries::internal_insert_wallet_created_ledger_entry::internal_insert_wallet_created_ledger_entry;
+use crate::queries::wallets::create_new_wallet_for_owner_user::create_new_wallet_for_owner_user;
 use enums::common::payments_namespace::PaymentsNamespace;
-use errors::AnyhowResult;
-use log::error;
 use sqlx::MySql;
 use tokens::tokens::users::UserToken;
 use tokens::tokens::wallets::WalletToken;
 
-const ARTCRAFT_NAMESPACE: &str = PaymentsNamespace::Artcraft.to_str();
-
 pub async fn create_new_artcraft_wallet_for_owner_user(
   user_token: &UserToken,
   transaction: &mut sqlx::Transaction<'_, MySql>,
 ) -> Result<WalletToken, sqlx::Error> {
-  let token = WalletToken::generate();
-
-  let result = sqlx::query!(
-        r#"
-INSERT INTO wallets
-SET
-  token = ?,
-  wallet_namespace = ?,
-
-  owner_user_token = ?,
-  
-  banked_credits = 0,
-  monthly_credits = 0
-        "#,
-        token.as_str(),
-        ARTCRAFT_NAMESPACE,
-        user_token.as_str()
-    )
-      .execute(&mut **transaction)
-      .await;
-  
-  if let Err(err) = result {
-    error!("Error while inserting wallet: {}", err);
-    return Err(err);
-  }
-  
-  internal_insert_wallet_created_ledger_entry(&token, transaction).await?;
-  
-  Ok(token)
+  create_new_wallet_for_owner_user(user_token, PaymentsNamespace::Artcraft, transaction).await
 }

crates/schema/database/mysql_queries/src/queries/wallets/create_new_wallet_for_owner_user.rs

@@ -0,0 +1,42 @@
+use crate::queries::wallet_ledger_entries::internal_insert_wallet_created_ledger_entry::internal_insert_wallet_created_ledger_entry;
+use enums::common::payments_namespace::PaymentsNamespace;
+use log::error;
+use sqlx::MySql;
+use tokens::tokens::users::UserToken;
+use tokens::tokens::wallets::WalletToken;
+
+pub async fn create_new_wallet_for_owner_user(
+  user_token: &UserToken,
+  namespace: PaymentsNamespace,
+  transaction: &mut sqlx::Transaction<'_, MySql>,
+) -> Result<WalletToken, sqlx::Error> {
+  let token = WalletToken::generate();
+
+  let result = sqlx::query!(
+        r#"
+INSERT INTO wallets
+SET
+  token = ?,
+  wallet_namespace = ?,
+
+  owner_user_token = ?,
+
+  banked_credits = 0,
+  monthly_credits = 0
+        "#,
+        token.as_str(),
+        namespace.to_str(),
+        user_token.as_str()
+    )
+      .execute(&mut **transaction)
+      .await;
+
+  if let Err(err) = result {
+    error!("Error while inserting wallet: {}", err);
+    return Err(err);
+  }
+
+  internal_insert_wallet_created_ledger_entry(&token, transaction).await?;
+
+  Ok(token)
+}

crates/schema/database/mysql_queries/src/queries/wallets/mod.rs

@@ -1,6 +1,7 @@
 pub (crate) mod internal_select_wallet_balance_for_update;
 pub mod add_durable_banked_balance_to_wallet;
 pub mod create_new_artcraft_wallet_for_owner_user;
+pub mod create_new_wallet_for_owner_user;
 pub mod find_primary_wallet_for_owner;
 pub mod find_primary_wallet_token_for_owner;
 pub mod refill_monthly_credits_balance_on_wallet;

crates/schema/database/sqlite_tasks/src/queries/list_tasks_for_frontend.rs

@@ -2,6 +2,7 @@ use crate::connection::TaskDbConnection;
 use crate::error::SqliteTasksError;
 use chrono::{DateTime, Utc};
 use enums::common::generation_provider::GenerationProvider;
+use enums::tauri::tasks::task_failure_type::TaskFailureType;
 use enums::tauri::tasks::task_media_file_class::TaskMediaFileClass;
 use enums::tauri::tasks::task_model_type::TaskModelType;
 use enums::tauri::tasks::task_status::TaskStatus;
@@ -30,6 +31,8 @@ pub struct TaskItem {
   pub on_complete_batch_token: Option<BatchGenerationToken>,
   pub on_complete_primary_media_file_cdn_url: Option<String>,
   pub on_complete_primary_media_file_thumbnail_url_template: Option<String>,
+  pub on_failure_type: Option<TaskFailureType>,
+  pub on_failure_message: Option<String>,
   pub created_at: DateTime<Utc>,
   pub updated_at: DateTime<Utc>,
   pub completed_at: Option<DateTime<Utc>>,
@@ -56,6 +59,8 @@ pub async fn list_tasks_for_frontend(
       on_complete_batch_token,
       on_complete_primary_media_file_cdn_url,
       on_complete_primary_media_file_thumbnail_url_template,
+      on_failure_type,
+      on_failure_message,
       created_at as "created_at: DateTime<Utc>",
       updated_at as "updated_at: DateTime<Utc>",
       completed_at as "completed_at: DateTime<Utc>"
@@ -92,6 +97,10 @@ pub async fn list_tasks_for_frontend(
       on_complete_batch_token: raw.on_complete_batch_token.map(|t| BatchGenerationToken::new_from_str(&t)),
       on_complete_primary_media_file_cdn_url: raw.on_complete_primary_media_file_cdn_url,
       on_complete_primary_media_file_thumbnail_url_template: raw.on_complete_primary_media_file_thumbnail_url_template,
+      on_failure_type: raw.on_failure_type
+          .map(|t| TaskFailureType::from_str(&t))
+          .transpose()?,
+      on_failure_message: raw.on_failure_message,
       created_at: raw.created_at,
       updated_at: raw.updated_at,
       completed_at: raw.completed_at,
@@ -118,6 +127,8 @@ struct TaskItemRaw {
   on_complete_batch_token: Option<String>,
   on_complete_primary_media_file_cdn_url: Option<String>,
   on_complete_primary_media_file_thumbnail_url_template: Option<String>,
+  on_failure_type: Option<String>,
+  on_failure_message: Option<String>,
   created_at: DateTime<Utc>,
   updated_at: DateTime<Utc>,
   completed_at: Option<DateTime<Utc>>,

crates/schema/public/enums/src/by_table/generic_inference_jobs/frontend_failure_category.rs

@@ -47,6 +47,56 @@ pub enum FrontendFailureCategory {
   /// Eg. Seedance 2 will report: "your input text violates platform rules. please modify and try again"
   #[serde(rename = "model_rules_violation")]
   ModelRulesViolation,
+
+  /// Model content violation
+  /// e.g. "Your uploaded image violates platform rules. Please modify and try again." (seedance2pro)
+  /// Model content rules prohibit the uploaded image.
+  #[serde(rename = "rule_bans_user_image")]
+  RuleBansUserImage,
+
+  /// Model content violation
+  /// Model content rules prohibit user uploaded images containing faces (Seedance 2.0)
+  /// e.g. "The generated video did not pass review. Credits will not be deducted." (seedance2pro)
+  #[serde(rename = "rule_bans_user_image_with_faces")]
+  RuleBansUserImageWithFaces,
+
+  /// Model content violation
+  /// Model content rules prohibit the user's given text prompt (this fails early).
+  /// e.g. "The generated video did not pass review. Credits will not be deducted." (seedance2pro)
+  #[serde(rename = "rule_bans_user_text_prompt")]
+  RuleBansUserTextPrompt,
+
+  /// Model content violation
+  /// Model content rules prohibit user content. (I think this check happens early.)
+  /// e.g. "Content violates platform rules. Please modify and try again." (seedance2pro)
+  #[serde(rename = "rule_bans_user_content")]
+  RuleBansUserContent,
+
+  /// Model content violation
+  /// The video didn't pass checks after it finished generation (this fails at the very end of the generation).
+  /// e.g. "The generated video did not pass review. Credits will not be deducted." (seedance2pro)
+  #[serde(rename = "rule_bans_generated_video")]
+  RuleBansGeneratedVideo,
+
+  /// Model content violation
+  /// The audio (even in video!) didn't pass checks after it finished generation (this fails at the very end of the generation).
+  /// e.g. "The generated audio violates platform rules. Please adjust your prompt or images and try again." (seedance2pro)
+  #[serde(rename = "rule_bans_generated_audio")]
+  RuleBansGeneratedAudio,
+
+  /// Model content violation
+  /// The content didn't pass checks after it finished generation (this fails at the very end of the generation).
+  /// e.g. "The generated content violates platform rules. Please adjust your prompt or images and try again." (seedance2pro)
+  #[serde(rename = "rule_bans_generated_content")]
+  RuleBansGeneratedContent,
+
+  /// Generation failed (no reason)
+  /// Unspecified failure reason
+  /// Various example failures:
+  ///   - "The generated video did not pass review. Credits will not be deducted." (seedance2pro)
+  ///   - "Server error. Please try again later." (seedance2pro)
+  #[serde(rename = "generation_failed")]
+  GenerationFailed,
 }
 
 // TODO(bt, 2022-12-21): This desperately needs MySQL integration tests!
@@ -62,6 +112,14 @@ impl FrontendFailureCategory {
       Self::NotYetImplemented => "not_yet_implemented",
       Self::RetryableWorkerError => "retryable_worker_error",
       Self::ModelRulesViolation => "model_rules_violation",
+      Self::RuleBansUserImage => "rule_bans_user_image",
+      Self::RuleBansUserImageWithFaces => "rule_bans_user_image_with_faces",
+      Self::RuleBansUserTextPrompt => "rule_bans_user_text_prompt",
+      Self::RuleBansUserContent => "rule_bans_user_content",
+      Self::RuleBansGeneratedVideo => "rule_bans_generated_video",
+      Self::RuleBansGeneratedAudio => "rule_bans_generated_audio",
+      Self::RuleBansGeneratedContent => "rule_bans_generated_content",
+      Self::GenerationFailed => "generation_failed",
     }
   }
 
@@ -72,6 +130,14 @@ impl FrontendFailureCategory {
       "not_yet_implemented" => Ok(Self::NotYetImplemented),
       "retryable_worker_error" => Ok(Self::RetryableWorkerError),
       "model_rules_violation" => Ok(Self::ModelRulesViolation),
+      "rule_bans_user_image" => Ok(Self::RuleBansUserImage),
+      "rule_bans_user_image_with_faces" => Ok(Self::RuleBansUserImageWithFaces),
+      "rule_bans_user_text_prompt" => Ok(Self::RuleBansUserTextPrompt),
+      "rule_bans_user_content" => Ok(Self::RuleBansUserContent),
+      "rule_bans_generated_video" => Ok(Self::RuleBansGeneratedVideo),
+      "rule_bans_generated_audio" => Ok(Self::RuleBansGeneratedAudio),
+      "rule_bans_generated_content" => Ok(Self::RuleBansGeneratedContent),
+      "generation_failed" => Ok(Self::GenerationFailed),
       _ => Err(format!("invalid value: {:?}", value)),
     }
   }
@@ -85,6 +151,14 @@ impl FrontendFailureCategory {
       Self::NotYetImplemented,
       Self::RetryableWorkerError,
       Self::ModelRulesViolation,
+      Self::RuleBansUserImage,
+      Self::RuleBansUserImageWithFaces,
+      Self::RuleBansUserTextPrompt,
+      Self::RuleBansUserContent,
+      Self::RuleBansGeneratedVideo,
+      Self::RuleBansGeneratedAudio,
+      Self::RuleBansGeneratedContent,
+      Self::GenerationFailed,
     ])
   }
 }
@@ -104,6 +178,14 @@ mod tests {
       assert_serialization(FrontendFailureCategory::NotYetImplemented, "not_yet_implemented");
       assert_serialization(FrontendFailureCategory::RetryableWorkerError, "retryable_worker_error");
       assert_serialization(FrontendFailureCategory::ModelRulesViolation, "model_rules_violation");
+      assert_serialization(FrontendFailureCategory::RuleBansUserImage, "rule_bans_user_image");
+      assert_serialization(FrontendFailureCategory::RuleBansUserImageWithFaces, "rule_bans_user_image_with_faces");
+      assert_serialization(FrontendFailureCategory::RuleBansUserTextPrompt, "rule_bans_user_text_prompt");
+      assert_serialization(FrontendFailureCategory::RuleBansUserContent, "rule_bans_user_content");
+      assert_serialization(FrontendFailureCategory::RuleBansGeneratedVideo, "rule_bans_generated_video");
+      assert_serialization(FrontendFailureCategory::RuleBansGeneratedAudio, "rule_bans_generated_audio");
+      assert_serialization(FrontendFailureCategory::RuleBansGeneratedContent, "rule_bans_generated_content");
+      assert_serialization(FrontendFailureCategory::GenerationFailed, "generation_failed");
     }
 
     #[test]
@@ -113,6 +195,14 @@ mod tests {
       assert_eq!(FrontendFailureCategory::NotYetImplemented.to_str(), "not_yet_implemented");
       assert_eq!(FrontendFailureCategory::RetryableWorkerError.to_str(), "retryable_worker_error");
       assert_eq!(FrontendFailureCategory::ModelRulesViolation.to_str(), "model_rules_violation");
+      assert_eq!(FrontendFailureCategory::RuleBansUserImage.to_str(), "rule_bans_user_image");
+      assert_eq!(FrontendFailureCategory::RuleBansUserImageWithFaces.to_str(), "rule_bans_user_image_with_faces");
+      assert_eq!(FrontendFailureCategory::RuleBansUserTextPrompt.to_str(), "rule_bans_user_text_prompt");
+      assert_eq!(FrontendFailureCategory::RuleBansUserContent.to_str(), "rule_bans_user_content");
+      assert_eq!(FrontendFailureCategory::RuleBansGeneratedVideo.to_str(), "rule_bans_generated_video");
+      assert_eq!(FrontendFailureCategory::RuleBansGeneratedAudio.to_str(), "rule_bans_generated_audio");
+      assert_eq!(FrontendFailureCategory::RuleBansGeneratedContent.to_str(), "rule_bans_generated_content");
+      assert_eq!(FrontendFailureCategory::GenerationFailed.to_str(), "generation_failed");
     }
 
     #[test]
@@ -122,17 +212,34 @@ mod tests {
       assert_eq!(FrontendFailureCategory::from_str("not_yet_implemented").unwrap(), FrontendFailureCategory::NotYetImplemented);
       assert_eq!(FrontendFailureCategory::from_str("retryable_worker_error").unwrap(), FrontendFailureCategory::RetryableWorkerError);
       assert_eq!(FrontendFailureCategory::from_str("model_rules_violation").unwrap(), FrontendFailureCategory::ModelRulesViolation);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_user_image").unwrap(), FrontendFailureCategory::RuleBansUserImage);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_user_image_with_faces").unwrap(), FrontendFailureCategory::RuleBansUserImageWithFaces);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_user_text_prompt").unwrap(), FrontendFailureCategory::RuleBansUserTextPrompt);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_user_content").unwrap(), FrontendFailureCategory::RuleBansUserContent);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_generated_video").unwrap(), FrontendFailureCategory::RuleBansGeneratedVideo);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_generated_audio").unwrap(), FrontendFailureCategory::RuleBansGeneratedAudio);
+      assert_eq!(FrontendFailureCategory::from_str("rule_bans_generated_content").unwrap(), FrontendFailureCategory::RuleBansGeneratedContent);
+      assert_eq!(FrontendFailureCategory::from_str("generation_failed").unwrap(), FrontendFailureCategory::GenerationFailed);
+      assert_eq!(FrontendFailureCategory::from_str("invalid_value").is_err(), true);
     }
 
     #[test]
     fn all_variants() {
       let mut variants = FrontendFailureCategory::all_variants();
-      assert_eq!(variants.len(), 5);
+      assert_eq!(variants.len(), 13);
       assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::FaceNotDetected));
       assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::KeepAliveElapsed));
       assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::NotYetImplemented));
       assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RetryableWorkerError));
       assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::ModelRulesViolation));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansUserImage));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansUserImageWithFaces));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansUserTextPrompt));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansUserContent));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansGeneratedVideo));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansGeneratedAudio));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::RuleBansGeneratedContent));
+      assert_eq!(variants.pop_first(), Some(FrontendFailureCategory::GenerationFailed));
       assert_eq!(variants.pop_first(), None);
     }
   }

crates/schema/public/enums/src/tauri/tasks/mod.rs

@@ -1,3 +1,4 @@
+pub mod task_failure_type;
 pub mod task_media_file_class;
 pub mod task_model_type;
 pub mod task_status;

crates/schema/public/enums/src/tauri/tasks/task_failure_type.rs

@@ -0,0 +1,195 @@
+use std::collections::BTreeSet;
+
+use crate::by_table::generic_inference_jobs::frontend_failure_category::FrontendFailureCategory;
+use crate::error::enum_error::EnumError;
+#[cfg(test)]
+use strum::EnumCount;
+#[cfg(test)]
+use strum::EnumIter;
+use utoipa::ToSchema;
+
+/// Failure type for tasks in the Tauri desktop app.
+///
+/// Mirrors the relevant variants from `FrontendFailureCategory` so the desktop
+/// client can display localized failure information without depending / breaking on the
+/// server-side enum directly.
+#[cfg_attr(test, derive(EnumIter, EnumCount))]
+#[derive(Clone, Copy, PartialEq, Eq, Hash, Ord, PartialOrd, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "snake_case")]
+pub enum TaskFailureType {
+  /// Catch-all for unknown failures.
+  Unknown,
+
+  RuleBansUserImage,
+  RuleBansUserImageWithFaces,
+  RuleBansUserTextPrompt,
+  RuleBansUserContent,
+
+  RuleBansGeneratedVideo,
+  RuleBansGeneratedAudio,
+  RuleBansGeneratedContent,
+
+  /// No reason given for generation failure, but this matches what we were told.
+  GenerationFailed,
+}
+
+impl_enum_display_and_debug_using_to_str!(TaskFailureType);
+
+impl TaskFailureType {
+
+  /// Convert the web API's `FrontendFailureCategory` to a Tauri-facing type, if there is a matching variant.
+  /// If there isn't a matching variant, return `Unknown`.
+  pub fn from_frontend_failure_category(category: FrontendFailureCategory) -> Self {
+    match category {
+      FrontendFailureCategory::ModelRulesViolation => Self::RuleBansUserContent, // NB: This is a legacy enum value.
+      FrontendFailureCategory::RuleBansUserImage => Self::RuleBansUserImage,
+      FrontendFailureCategory::RuleBansUserImageWithFaces => Self::RuleBansUserImageWithFaces,
+      FrontendFailureCategory::RuleBansUserTextPrompt => Self::RuleBansUserTextPrompt,
+      FrontendFailureCategory::RuleBansUserContent => Self::RuleBansUserContent,
+      FrontendFailureCategory::RuleBansGeneratedVideo => Self::RuleBansGeneratedVideo,
+      FrontendFailureCategory::RuleBansGeneratedAudio => Self::RuleBansGeneratedAudio,
+      FrontendFailureCategory::RuleBansGeneratedContent => Self::RuleBansGeneratedContent,
+      FrontendFailureCategory::GenerationFailed => Self::GenerationFailed,
+      _ => Self::Unknown,
+    }
+  }
+
+  pub const fn to_str(&self) -> &'static str {
+    match self {
+      Self::Unknown => "unknown",
+      Self::RuleBansUserImage => "rule_bans_user_image",
+      Self::RuleBansUserImageWithFaces => "rule_bans_user_image_with_faces",
+      Self::RuleBansUserTextPrompt => "rule_bans_user_text_prompt",
+      Self::RuleBansUserContent => "rule_bans_user_content",
+      Self::RuleBansGeneratedVideo => "rule_bans_generated_video",
+      Self::RuleBansGeneratedAudio => "rule_bans_generated_audio",
+      Self::RuleBansGeneratedContent => "rule_bans_generated_content",
+      Self::GenerationFailed => "generation_failed",
+    }
+  }
+
+  pub fn from_str(value: &str) -> Result<Self, EnumError> {
+    match value {
+      "unknown" => Ok(Self::Unknown),
+      "rule_bans_user_image" => Ok(Self::RuleBansUserImage),
+      "rule_bans_user_image_with_faces" => Ok(Self::RuleBansUserImageWithFaces),
+      "rule_bans_user_text_prompt" => Ok(Self::RuleBansUserTextPrompt),
+      "rule_bans_user_content" => Ok(Self::RuleBansUserContent),
+      "rule_bans_generated_video" => Ok(Self::RuleBansGeneratedVideo),
+      "rule_bans_generated_audio" => Ok(Self::RuleBansGeneratedAudio),
+      "rule_bans_generated_content" => Ok(Self::RuleBansGeneratedContent),
+      "generation_failed" => Ok(Self::GenerationFailed),
+      _ => Err(EnumError::CouldNotConvertFromString(value.to_string())),
+    }
+  }
+
+  pub fn all_variants() -> BTreeSet<Self> {
+    BTreeSet::from([
+      Self::Unknown,
+      Self::RuleBansUserImage,
+      Self::RuleBansUserImageWithFaces,
+      Self::RuleBansUserTextPrompt,
+      Self::RuleBansUserContent,
+      Self::RuleBansGeneratedVideo,
+      Self::RuleBansGeneratedAudio,
+      Self::RuleBansGeneratedContent,
+      Self::GenerationFailed,
+    ])
+  }
+}
+
+#[cfg(test)]
+mod tests {
+  use crate::tauri::tasks::task_failure_type::TaskFailureType;
+  use crate::test_helpers::assert_serialization;
+
+  mod explicit_checks {
+    use super::*;
+    use crate::error::enum_error::EnumError;
+
+    #[test]
+    fn test_serialization() {
+      assert_serialization(TaskFailureType::Unknown, "unknown");
+      assert_serialization(TaskFailureType::RuleBansUserImage, "rule_bans_user_image");
+      assert_serialization(TaskFailureType::RuleBansUserImageWithFaces, "rule_bans_user_image_with_faces");
+      assert_serialization(TaskFailureType::RuleBansUserTextPrompt, "rule_bans_user_text_prompt");
+      assert_serialization(TaskFailureType::RuleBansUserContent, "rule_bans_user_content");
+      assert_serialization(TaskFailureType::RuleBansGeneratedVideo, "rule_bans_generated_video");
+      assert_serialization(TaskFailureType::RuleBansGeneratedAudio, "rule_bans_generated_audio");
+      assert_serialization(TaskFailureType::RuleBansGeneratedContent, "rule_bans_generated_content");
+      assert_serialization(TaskFailureType::GenerationFailed, "generation_failed");
+    }
+
+    #[test]
+    fn to_str() {
+      assert_eq!(TaskFailureType::Unknown.to_str(), "unknown");
+      assert_eq!(TaskFailureType::RuleBansUserImage.to_str(), "rule_bans_user_image");
+      assert_eq!(TaskFailureType::RuleBansUserImageWithFaces.to_str(), "rule_bans_user_image_with_faces");
+      assert_eq!(TaskFailureType::RuleBansUserTextPrompt.to_str(), "rule_bans_user_text_prompt");
+      assert_eq!(TaskFailureType::RuleBansUserContent.to_str(), "rule_bans_user_content");
+      assert_eq!(TaskFailureType::RuleBansGeneratedVideo.to_str(), "rule_bans_generated_video");
+      assert_eq!(TaskFailureType::RuleBansGeneratedAudio.to_str(), "rule_bans_generated_audio");
+      assert_eq!(TaskFailureType::RuleBansGeneratedContent.to_str(), "rule_bans_generated_content");
+      assert_eq!(TaskFailureType::GenerationFailed.to_str(), "generation_failed");
+    }
+
+    #[test]
+    fn from_str() {
+      assert_eq!(TaskFailureType::from_str("unknown").unwrap(), TaskFailureType::Unknown);
+      assert_eq!(TaskFailureType::from_str("rule_bans_user_image").unwrap(), TaskFailureType::RuleBansUserImage);
+      assert_eq!(TaskFailureType::from_str("rule_bans_user_image_with_faces").unwrap(), TaskFailureType::RuleBansUserImageWithFaces);
+      assert_eq!(TaskFailureType::from_str("rule_bans_user_text_prompt").unwrap(), TaskFailureType::RuleBansUserTextPrompt);
+      assert_eq!(TaskFailureType::from_str("rule_bans_user_content").unwrap(), TaskFailureType::RuleBansUserContent);
+      assert_eq!(TaskFailureType::from_str("rule_bans_generated_video").unwrap(), TaskFailureType::RuleBansGeneratedVideo);
+      assert_eq!(TaskFailureType::from_str("rule_bans_generated_audio").unwrap(), TaskFailureType::RuleBansGeneratedAudio);
+      assert_eq!(TaskFailureType::from_str("rule_bans_generated_content").unwrap(), TaskFailureType::RuleBansGeneratedContent);
+      assert_eq!(TaskFailureType::from_str("generation_failed").unwrap(), TaskFailureType::GenerationFailed);
+    }
+
+    #[test]
+    fn from_str_err() {
+      let result = TaskFailureType::from_str("asdf");
+      assert!(result.is_err());
+      if let Err(EnumError::CouldNotConvertFromString(value)) = result {
+        assert_eq!(value, "asdf");
+      } else {
+        panic!("Expected EnumError::CouldNotConvertFromString");
+      }
+    }
+
+    #[test]
+    fn all_variants() {
+      let mut variants = TaskFailureType::all_variants();
+      assert_eq!(variants.len(), 9);
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::Unknown));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansUserImage));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansUserImageWithFaces));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansUserTextPrompt));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansUserContent));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansGeneratedVideo));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansGeneratedAudio));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::RuleBansGeneratedContent));
+      assert_eq!(variants.pop_first(), Some(TaskFailureType::GenerationFailed));
+      assert_eq!(variants.pop_first(), None);
+    }
+  }
+
+  mod mechanical_checks {
+    use super::*;
+
+    #[test]
+    fn variant_length() {
+      use strum::IntoEnumIterator;
+      assert_eq!(TaskFailureType::all_variants().len(), TaskFailureType::iter().len());
+    }
+
+    #[test]
+    fn round_trip() {
+      for variant in TaskFailureType::all_variants() {
+        assert_eq!(variant, TaskFailureType::from_str(variant.to_str()).unwrap());
+        assert_eq!(variant, TaskFailureType::from_str(&format!("{}", variant)).unwrap());
+        assert_eq!(variant, TaskFailureType::from_str(&format!("{:?}", variant)).unwrap());
+      }
+    }
+  }
+}

crates/service/job/seedance2_pro_job/src/process_job/process_failed_job.rs

@@ -4,6 +4,7 @@ use enums::by_table::generic_inference_jobs::frontend_failure_category::Frontend
 use mysql_queries::queries::generic_inference::job::mark_job_failed_by_token::{mark_job_failed_by_token, MarkJobFailedByTokenArgs};
 use mysql_queries::queries::generic_inference::seedance2pro::list_pending_seedance2pro_jobs::PendingSeedance2ProJob;
 use mysql_queries::queries::wallets::refund::try_to_refund_ledger_entry::{try_to_refund_ledger_entry, WalletRefundOutcome};
+use seedance2pro::requests::poll_orders::failure_type::FailureType;
 use seedance2pro::requests::poll_orders::poll_orders::OrderStatus;
 
 use crate::job_dependencies::JobDependencies;
@@ -15,7 +16,8 @@ pub async fn process_failed_job(
 ) {
   let reason = order
     .fail_reason
-    .as_deref()
+    .as_ref()
+    .map(|fr| fr.reason.as_str())
     .unwrap_or("unknown failure reason");
 
   // --- Step 1: Attempt the refund before touching the job status. ---
@@ -89,17 +91,19 @@ pub async fn process_failed_job(
 
   // --- Step 2: Mark the job record as failed. ---
 
-  let reason_lower = reason.to_lowercase();
-
-  let platform_rules_violation = reason_lower.contains("violates") ||
-    reason_lower.contains("platform rules") ||
-    reason_lower.contains("please modify");
-
-  let frontend_failure_category = if platform_rules_violation {
-    Some(FrontendFailureCategory::ModelRulesViolation)
-  } else {
-    None
-  };
+  let frontend_failure_category = order.fail_reason.as_ref().map(|fr| {
+    match fr.failure_type {
+      FailureType::RuleBansUserImage => FrontendFailureCategory::RuleBansUserImage,
+      FailureType::RuleBansUserImageWithFaces => FrontendFailureCategory::RuleBansUserImageWithFaces,
+      FailureType::RuleBansUserTextPrompt => FrontendFailureCategory::RuleBansUserTextPrompt,
+      FailureType::RuleBansUserContent => FrontendFailureCategory::RuleBansUserContent,
+      FailureType::RuleBansGeneratedVideo => FrontendFailureCategory::RuleBansGeneratedVideo,
+      FailureType::RuleBansGeneratedAudio => FrontendFailureCategory::RuleBansGeneratedAudio,
+      FailureType::RuleBansGeneratedContent => FrontendFailureCategory::RuleBansGeneratedContent,
+      FailureType::GenerationFailed => FrontendFailureCategory::GenerationFailed,
+      FailureType::OtherUnknownReason => FrontendFailureCategory::GenerationFailed,
+    }
+  });
 
   warn!(
     "Order {} failed: {}. Marking job {} failed.",

crates/service/web/storyteller_web/src/docs/api_doc.rs

@@ -281,6 +281,7 @@ use artcraft_api_defs::moderation::wallet_ledger_entries::list_wallet_ledger_ent
 use artcraft_api_defs::moderation::wallet_ledger_entries::moderator_get_wallet_ledger_entry::*;
 use artcraft_api_defs::moderation::wallets::list_user_wallets::*;
 use artcraft_api_defs::moderation::wallets::moderator_add_banked_balance_to_wallet::*;
+use artcraft_api_defs::moderation::wallets::moderator_create_wallet_for_user::*;
 use artcraft_api_defs::moderation::wallets::moderator_get_wallet::*;
 use artcraft_api_defs::web_referrals::log_web_referral::*;
 use crate::http_server::endpoints::web_referrals::log_web_referral_handler::*;
@@ -468,6 +469,7 @@ use crate::http_server::endpoints::media_files::list::list_batch_generated_redux
     crate::http_server::endpoints::moderation::wallet_ledger_entries::moderator_get_wallet_ledger_entry_handler::moderator_get_wallet_ledger_entry_handler,
     crate::http_server::endpoints::moderation::wallets::list_user_wallets_handler::list_user_wallets_handler,
     crate::http_server::endpoints::moderation::wallets::moderator_add_banked_balance_to_wallet_handler::moderator_add_banked_balance_to_wallet_handler,
+    crate::http_server::endpoints::moderation::wallets::moderator_create_wallet_for_user_handler::moderator_create_wallet_for_user_handler,
     crate::http_server::endpoints::moderation::wallets::moderator_get_wallet_handler::moderator_get_wallet_handler,
     // Credits
     crate::http_server::endpoints::credits::get_session_credits_handler::get_session_credits_handler,
@@ -666,6 +668,8 @@ use crate::http_server::endpoints::media_files::list::list_batch_generated_redux
     ModeratorAddBankedBalanceToWalletPathInfo,
     ModeratorAddBankedBalanceToWalletRequest,
     ModeratorAddBankedBalanceToWalletResponse,
+    ModeratorCreateWalletForUserRequest,
+    ModeratorCreateWalletForUserResponse,
     ModeratorGetWalletPathInfo,
     ModeratorGetWalletResponse,
     ModeratorGetWalletDetails,

crates/service/web/storyteller_web/src/http_server/common_responses/media/cover_image_links.rs

@@ -1,5 +1,7 @@
+use crate::http_server::common_responses::media::cdn_link;
 use crate::http_server::common_responses::media::media_domain::MediaDomain;
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
 use url::Url;
 use utoipa::ToSchema;
 
@@ -24,24 +26,27 @@ impl CoverImageLinks {
 
   pub fn from_media_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     bucket_path: &MediaFileBucketPath,
   ) -> Option<Self> {
     let rooted_path = bucket_path.get_full_object_path_str();
-    Self::from_rooted_path(domain, rooted_path)
+    Self::from_rooted_path(domain, server_environment, rooted_path)
   }
 
   pub fn from_maybe_media_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     bucket_path: Option<&MediaFileBucketPath>,
   ) -> Option<Self> {
     match bucket_path {
       None => None,
-      Some(bucket_path) => Self::from_media_path(domain, bucket_path),
+      Some(bucket_path) => Self::from_media_path(domain, server_environment, bucket_path),
     }
   }
 
   pub fn from_parts(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -55,11 +60,12 @@ impl CoverImageLinks {
       maybe_cover_image_public_bucket_prefix,
       maybe_cover_image_public_bucket_extension
     );
-    Self::from_media_path(domain, &bucket_path)
+    Self::from_media_path(domain, server_environment, &bucket_path)
   }
 
   pub fn from_rooted_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     rooted_path: &str,
   ) -> Option<Self> {
     if !rooted_path.ends_with(".jpg")
@@ -68,17 +74,24 @@ impl CoverImageLinks {
       return None;
     }
 
-    let mut cdn_url = domain.new_cdn_url();
+    let mut cdn_url = cdn_link::new_cdn_url(domain, server_environment);
     cdn_url.set_path(rooted_path);
 
     Some(Self {
       cdn_url,
-      thumbnail_template: thumbnail_template(domain, rooted_path),
+      thumbnail_template: thumbnail_template(domain, server_environment, rooted_path),
     })
   }
 }
 
-fn thumbnail_template(media_domain: MediaDomain, rooted_path: &str) -> String {
-  let host = media_domain.cdn_url_str();
-  format!("{host}/cdn-cgi/image/width={{WIDTH}},quality={QUALITY}{rooted_path}")
+fn thumbnail_template(media_domain: MediaDomain, server_environment: ServerEnvironment, rooted_path: &str) -> String {
+  let host = cdn_link::get_cdn_host(media_domain, server_environment);
+  match server_environment {
+    ServerEnvironment::Production => {
+      format!("{host}/cdn-cgi/image/width={{WIDTH}},quality={QUALITY}{rooted_path}")
+    }
+    ServerEnvironment::Development => {
+      format!("{host}{rooted_path}")
+    }
+  }
 }

crates/service/web/storyteller_web/src/http_server/common_responses/media/cover_image_links_builder.rs

@@ -1,6 +1,8 @@
+use crate::http_server::common_responses::media::cdn_link;
 use crate::http_server::common_responses::media::media_domain::MediaDomain;
 use artcraft_api_defs::common::responses::cover_image_links::CoverImageLinks;
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
 
 // TODO(bt,2024-09-18): Consolidate thumbnail builder code and vars
 // TODO(bt,2024-09-05): Worth reducing the quality at all?
@@ -12,24 +14,27 @@ impl CoverImageLinksBuilder {
 
   pub fn from_media_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     bucket_path: &MediaFileBucketPath,
   ) -> Option<CoverImageLinks> {
     let rooted_path = bucket_path.get_full_object_path_str();
-    Self::from_rooted_path(domain, rooted_path)
+    Self::from_rooted_path(domain, server_environment, rooted_path)
   }
 
   pub fn from_maybe_media_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     bucket_path: Option<&MediaFileBucketPath>,
   ) -> Option<CoverImageLinks> {
     match bucket_path {
       None => None,
-      Some(bucket_path) => Self::from_media_path(domain, bucket_path),
+      Some(bucket_path) => Self::from_media_path(domain, server_environment, bucket_path),
     }
   }
 
   pub fn from_parts(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -43,11 +48,12 @@ impl CoverImageLinksBuilder {
       maybe_cover_image_public_bucket_prefix,
       maybe_cover_image_public_bucket_extension
     );
-    Self::from_media_path(domain, &bucket_path)
+    Self::from_media_path(domain, server_environment, &bucket_path)
   }
 
   pub fn from_rooted_path(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     rooted_path: &str,
   ) -> Option<CoverImageLinks> {
     if !rooted_path.ends_with(".jpg")
@@ -56,17 +62,24 @@ impl CoverImageLinksBuilder {
       return None;
     }
 
-    let mut cdn_url = domain.new_cdn_url();
+    let mut cdn_url = cdn_link::new_cdn_url(domain, server_environment);
     cdn_url.set_path(rooted_path);
 
     Some(CoverImageLinks {
       cdn_url,
-      thumbnail_template: thumbnail_template(domain, rooted_path),
+      thumbnail_template: thumbnail_template(domain, server_environment, rooted_path),
     })
   }
 }
 
-fn thumbnail_template(media_domain: MediaDomain, rooted_path: &str) -> String {
-  let host = media_domain.cdn_url_str();
-  format!("{host}/cdn-cgi/image/width={{WIDTH}},quality={QUALITY}{rooted_path}")
+fn thumbnail_template(media_domain: MediaDomain, server_environment: ServerEnvironment, rooted_path: &str) -> String {
+  let host = cdn_link::get_cdn_host(media_domain, server_environment);
+  match server_environment {
+    ServerEnvironment::Production => {
+      format!("{host}/cdn-cgi/image/width={{WIDTH}},quality={QUALITY}{rooted_path}")
+    }
+    ServerEnvironment::Development => {
+      format!("{host}{rooted_path}")
+    }
+  }
 }

crates/service/web/storyteller_web/src/http_server/common_responses/media/media_file_cover_image_details.rs

@@ -3,10 +3,11 @@ use std::hash::{Hash, Hasher};
 use url::Url;
 use utoipa::ToSchema;
 
+use crate::http_server::common_responses::media::cdn_link;
 use crate::http_server::common_responses::media::cover_image_links::CoverImageLinks;
 use crate::http_server::common_responses::media::media_domain::MediaDomain;
-use crate::http_server::web_utils::bucket_urls::bucket_url_from_media_path::bucket_url_from_media_path;
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
 use tokens::tokens::media_files::MediaFileToken;
 
 /// There are currently 25 cover images numbered 0 to 24 (0-indexed).
@@ -62,7 +63,11 @@ impl MediaFileCoverImageDetails {
   }
 
   /// For non-media file tokens (eg. emulated TTS results)
-  pub fn from_token_str(token: &str) -> Self {
+  pub fn from_legacy_token_str(token: &str) -> Self {
+    Self::from_token_str(token)
+  }
+  
+  fn from_token_str(token: &str) -> Self {
     Self {
       // TODO(bt,2024-04-07): Add column to schema to support + CRUD to add.
       maybe_cover_image_public_bucket_path: None,
@@ -76,6 +81,7 @@ impl MediaFileCoverImageDetails {
   pub fn from_optional_db_fields(
     token: &MediaFileToken,
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -83,15 +89,17 @@ impl MediaFileCoverImageDetails {
     Self::from_optional_db_str_fields(
       token.as_str(),
       domain,
+      server_environment,
       maybe_cover_image_public_bucket_path,
       maybe_cover_image_public_bucket_prefix,
       maybe_cover_image_public_bucket_extension
     )
   }
 
-  pub fn from_optional_db_str_fields(
+  fn from_optional_db_str_fields(
     token: &str,
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -112,19 +120,19 @@ impl MediaFileCoverImageDetails {
     // NB: Fail construction open.
     let maybe_cover_image_public_bucket_url = maybe_bucket_path
         .as_ref()
-        .map(|bucket_path| bucket_url_from_media_path(bucket_path).ok())
-        .flatten();
+        .and_then(|bucket_path| {
+          let rooted_path = bucket_path.get_full_object_path_str();
+          let mut url = cdn_link::new_cdn_url(domain, server_environment);
+          url.set_path(rooted_path);
+          Some(url)
+        });
 
     let maybe_links = CoverImageLinks::from_maybe_media_path(
-      domain, maybe_bucket_path.as_ref());
-
-    // let maybe_media_links = maybe_bucket_path
-    //     .map(|path| MediaLinks::from_media_path(domain, &path));
+      domain, server_environment, maybe_bucket_path.as_ref());
 
     Self {
       maybe_cover_image_public_bucket_path,
       maybe_cover_image_public_bucket_url,
-      //maybe_media_links,
       maybe_links,
       default_cover: MediaFileDefaultCover::from_token_str(token),
     }
@@ -181,4 +189,142 @@ mod tests {
     assert_eq!(cover.color_index, 0);
     assert_eq!(cover.image_index, 23);
   }
+
+  #[test]
+  fn test_cover_image_url_production() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Production;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let url = details.maybe_cover_image_public_bucket_url.unwrap();
+    assert!(
+      url.as_str().starts_with("https://cdn-2.fakeyou.com"),
+      "Production URL should start with https://cdn-2.fakeyou.com, got: {}",
+      url
+    );
+  }
+
+  #[test]
+  fn test_cover_image_url_development() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Development;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let url = details.maybe_cover_image_public_bucket_url.unwrap();
+    assert!(
+      url.as_str().starts_with("https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/"),
+      "Development URL should start with https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/, got: {}",
+      url
+    );
+  }
+
+  #[test]
+  fn test_cover_image_links_cdn_url_production() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Production;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let links = details.maybe_links.unwrap();
+    assert!(
+      links.cdn_url.as_str().starts_with("https://cdn-2.fakeyou.com"),
+      "Production cdn_url should start with https://cdn-2.fakeyou.com, got: {}",
+      links.cdn_url
+    );
+  }
+
+  #[test]
+  fn test_cover_image_links_cdn_url_development() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Development;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let links = details.maybe_links.unwrap();
+    assert!(
+      links.cdn_url.as_str().starts_with("https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/"),
+      "Development cdn_url should start with https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/, got: {}",
+      links.cdn_url
+    );
+  }
+
+  #[test]
+  fn test_cover_image_links_thumbnail_template_production() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Production;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let links = details.maybe_links.unwrap();
+    assert!(
+      links.thumbnail_template.starts_with("https://cdn-2.fakeyou.com"),
+      "Production thumbnail_template should start with https://cdn-2.fakeyou.com, got: {}",
+      links.thumbnail_template
+    );
+  }
+
+  #[test]
+  fn test_cover_image_links_thumbnail_template_development() {
+    let token = MediaFileToken::new_from_str("test_token");
+    let domain = super::MediaDomain::FakeYou;
+    let env = super::ServerEnvironment::Development;
+
+    let details = super::MediaFileCoverImageDetails::from_optional_db_fields(
+      &token,
+      domain,
+      env,
+      Some("bucket_hash"),
+      Some("image_"),
+      Some(".png"),
+    );
+
+    let links = details.maybe_links.unwrap();
+    assert!(
+      links.thumbnail_template.starts_with("https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/"),
+      "Development thumbnail_template should start with https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/, got: {}",
+      links.thumbnail_template
+    );
+  }
 }

crates/service/web/storyteller_web/src/http_server/common_responses/media/media_file_cover_image_details_builder.rs

@@ -1,8 +1,8 @@
 use crate::http_server::common_responses::media::cover_image_links_builder::CoverImageLinksBuilder;
 use crate::http_server::common_responses::media::media_domain::MediaDomain;
-use crate::http_server::web_utils::bucket_urls::bucket_url_from_media_path::bucket_url_from_media_path;
 use artcraft_api_defs::common::responses::media_file_cover_image_details::{MediaFileCoverImageDetails, MediaFileDefaultCover};
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
 use std::collections::hash_map::DefaultHasher;
 use std::hash::{Hash, Hasher};
 use tokens::tokens::media_files::MediaFileToken;
@@ -42,6 +42,7 @@ impl MediaFileCoverImageDetailsBuilder {
   pub fn from_optional_db_fields(
     token: &MediaFileToken,
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -49,6 +50,7 @@ impl MediaFileCoverImageDetailsBuilder {
     Self::from_optional_db_str_fields(
       token.as_str(),
       domain,
+      server_environment,
       maybe_cover_image_public_bucket_path,
       maybe_cover_image_public_bucket_prefix,
       maybe_cover_image_public_bucket_extension
@@ -58,6 +60,7 @@ impl MediaFileCoverImageDetailsBuilder {
   pub fn from_optional_db_str_fields(
     token: &str,
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
     maybe_cover_image_public_bucket_extension: Option<&str>,
@@ -69,29 +72,10 @@ impl MediaFileCoverImageDetailsBuilder {
           maybe_cover_image_public_bucket_extension
         ));
 
-    let maybe_cover_image_public_bucket_path = maybe_bucket_path
-        .as_ref()
-        .map(|bucket_path| bucket_path
-            .get_full_object_path_str()
-            .to_string());
-
-    // NB: Fail construction open.
-    let maybe_cover_image_public_bucket_url = maybe_bucket_path
-        .as_ref()
-        .map(|bucket_path| bucket_url_from_media_path(bucket_path).ok())
-        .flatten();
-
     let maybe_links = CoverImageLinksBuilder::from_maybe_media_path(
-      domain, maybe_bucket_path.as_ref());
-
-    // let maybe_media_links = maybe_bucket_path
-    //     .map(|path| MediaLinks::from_media_path(domain, &path));
+      domain, server_environment, maybe_bucket_path.as_ref());
 
     MediaFileCoverImageDetails {
-      // NB: The code using this builder does not populate or read these legacy fields:
-      // maybe_cover_image_public_bucket_path,
-      // maybe_cover_image_public_bucket_url,
-      // maybe_media_links,
       maybe_links,
       default_cover: MediaFileDefaultCoverBuilder::from_token_str(token),
     }

crates/service/web/storyteller_web/src/http_server/common_responses/media/weights_cover_image_details.rs

@@ -1,12 +1,13 @@
 use url::Url;
 use utoipa::ToSchema;
 
+use crate::http_server::common_responses::media::cdn_link;
 use crate::http_server::common_responses::media::cover_image_links::CoverImageLinks;
 use crate::http_server::common_responses::media::media_domain::MediaDomain;
-use crate::http_server::web_utils::bucket_urls::bucket_url_from_media_path::bucket_url_from_media_path;
 use crate::util::placeholder_images::cover_images::default_cover_image_color_from_token::default_cover_image_color_from_token;
 use crate::util::placeholder_images::cover_images::default_cover_image_from_token::default_cover_image_from_token;
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
 use tokens::tokens::model_weights::ModelWeightToken;
 
 /// Everything we need to create a cover image.
@@ -45,6 +46,7 @@ impl WeightsCoverImageDetails {
 
   pub fn from_optional_db_fields(
     domain: MediaDomain,
+    server_environment: ServerEnvironment,
     model_weight_token: &ModelWeightToken,
     maybe_cover_image_public_bucket_path: Option<&str>,
     maybe_cover_image_public_bucket_prefix: Option<&str>,
@@ -66,13 +68,15 @@ impl WeightsCoverImageDetails {
     // NB: Fail construction open.
     let maybe_cover_image_public_bucket_url = maybe_bucket_path
         .as_ref()
-        .map(|bucket_path| bucket_url_from_media_path(bucket_path).ok())
-        .flatten();
-
-    let image_index = default_cover_image_from_token(model_weight_token);
+        .and_then(|bucket_path| {
+          let rooted_path = bucket_path.get_full_object_path_str();
+          let mut url = cdn_link::new_cdn_url(domain, server_environment);
+          url.set_path(rooted_path);
+          Some(url)
+        });
 
     let maybe_links = CoverImageLinks::from_maybe_media_path(
-      domain, maybe_bucket_path.as_ref());
+      domain, server_environment, maybe_bucket_path.as_ref());
 
     Self {
       maybe_cover_image_public_bucket_path,
@@ -96,6 +100,7 @@ impl WeightsDefaultCoverInfo {
 mod tests {
   use crate::http_server::common_responses::media::media_domain::MediaDomain;
   use crate::http_server::common_responses::media::weights_cover_image_details::WeightsCoverImageDetails;
+  use server_environment::ServerEnvironment;
   use tokens::tokens::model_weights::ModelWeightToken;
   use url::Url;
 
@@ -109,6 +114,7 @@ mod tests {
 
     let cover_image = WeightsCoverImageDetails::from_optional_db_fields(
       domain,
+      ServerEnvironment::Production,
       &token,
       maybe_public_bucket_hash,
       maybe_prefix,

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/get/batch_get_media_files_handler.rs

@@ -341,10 +341,11 @@ pub async fn batch_get_media_files_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &result.token,
             media_domain,
+            server_state.server_environment,
             result.maybe_file_cover_image_public_bucket_hash.as_deref(),
             result.maybe_file_cover_image_public_bucket_prefix.as_deref(),
             result.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/get/get_media_file_handler.rs

@@ -366,7 +366,7 @@ async fn modern_media_file_lookup(
       maybe_batch_token: result.maybe_batch_token,
       maybe_scene_source_media_file_token: result.maybe_scene_source_media_file_token,
       media_links: MediaLinksBuilder::from_media_path_and_env(media_domain, server_state.server_environment, &public_bucket_path),
-      public_bucket_url: bucket_url_from_media_path(&public_bucket_path)
+      public_bucket_url: bucket_url_from_media_path(&public_bucket_path, media_domain, server_state.server_environment)
           .map_err(|err| {
             warn!("error creating URL: {:?}", err);
             GetMediaFileError::ServerError
@@ -377,6 +377,7 @@ async fn modern_media_file_lookup(
       cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
         &result.token,
         media_domain,
+        server_state.server_environment,
         result.maybe_file_cover_image_public_bucket_hash.as_deref(),
         result.maybe_file_cover_image_public_bucket_prefix.as_deref(),
         result.maybe_file_cover_image_public_bucket_extension.as_deref(),
@@ -503,13 +504,13 @@ async fn emulate_media_file_with_legacy_tts_result_lookup(
       maybe_batch_token: None,
       maybe_scene_source_media_file_token: None,
       media_links: MediaLinksBuilder::from_rooted_path_and_env(media_domain, server_state.server_environment, &public_bucket_path),
-      public_bucket_url: bucket_url_from_str_path(&public_bucket_path)
+      public_bucket_url: bucket_url_from_str_path(&public_bucket_path, media_domain, server_state.server_environment)
           .map_err(|err| {
             warn!("error creating URL: {:?}", err);
             GetMediaFileError::ServerError
           })?,
       public_bucket_path,
-      cover_image: MediaFileCoverImageDetails::from_token_str(&result.tts_result_token),
+      cover_image: MediaFileCoverImageDetails::from_legacy_token_str(&result.tts_result_token),
       maybe_model_weight_info: Some(GetMediaFileModelInfo {
         // NB: These should be reasonable synthetic defaults for emulated TT2 results, even the "ModelWeightToken".
         weight_token: ModelWeightToken::new_from_str(&result.tts_model_token),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_batch_generated_redux_media_files_handler.rs

@@ -8,7 +8,6 @@ use crate::http_server::common_responses::media::media_links_builder::MediaLinks
 use crate::http_server::common_responses::user_details_lite_builder::UserDetailsLightBuilder;
 use crate::http_server::endpoints::media_files::get::get_media_file_handler::GetMediaFilePathInfo;
 use crate::http_server::endpoints::media_files::helpers::get_media_domain::get_media_domain;
-use crate::http_server::web_utils::bucket_urls::bucket_url_string_from_media_path::bucket_url_string_from_media_path;
 use crate::http_server::web_utils::response_error_helpers::to_simple_json_error;
 use crate::state::server_state::ServerState;
 use actix_web::error::ResponseError;
@@ -120,6 +119,7 @@ pub async fn list_batch_generated_redux_media_files_handler(
           cover_image: MediaFileCoverImageDetailsBuilder::from_optional_db_fields(
             &result.token,
             media_domain,
+            server_state.server_environment,
             result.maybe_file_cover_image_public_bucket_hash.as_deref(),
             result.maybe_file_cover_image_public_bucket_prefix.as_deref(),
             result.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_featured_media_files_handler.rs

@@ -296,10 +296,11 @@ pub async fn list_featured_media_files_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &m.token,
             media_domain,
+            server_state.server_environment,
             m.maybe_file_cover_image_public_bucket_hash.as_deref(),
             m.maybe_file_cover_image_public_bucket_prefix.as_deref(),
             m.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_media_files_by_batch_token_handler.rs

@@ -285,7 +285,7 @@ pub async fn list_media_files_by_batch_token_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_token(&record.token),
           creator_set_visibility: record.creator_set_visibility,
           is_user_upload: record.is_user_upload,

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_media_files_for_user_handler.rs

@@ -344,10 +344,11 @@ pub async fn list_media_files_for_user_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &record.token,
             media_domain,
+            server_state.server_environment,
             record.maybe_file_cover_image_public_bucket_hash.as_deref(),
             record.maybe_file_cover_image_public_bucket_prefix.as_deref(),
             record.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_media_files_handler.rs

@@ -353,10 +353,11 @@ pub async fn list_media_files_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &record.token,
             media_domain,
+            server_state.server_environment,
             record.maybe_file_cover_image_public_bucket_hash.as_deref(),
             record.maybe_file_cover_image_public_bucket_prefix.as_deref(),
             record.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/list/list_pinned_media_files_handler.rs

@@ -223,10 +223,11 @@ pub async fn list_pinned_media_files_handler(
             public_bucket_path: public_bucket_path
                 .get_full_object_path_str()
                 .to_string(),
-            public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+            public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
             cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
               &m.token,
               media_domain,
+              server_state.server_environment,
               m.maybe_file_cover_image_public_bucket_hash.as_deref(),
               m.maybe_file_cover_image_public_bucket_prefix.as_deref(),
               m.maybe_file_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/search/search_featured_media_files_handler.rs

@@ -235,10 +235,11 @@ pub async fn search_featured_media_files_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &result.token,
             media_domain,
+            server_state.server_environment,
             result.maybe_cover_image_public_bucket_hash.as_deref(),
             result.maybe_cover_image_public_bucket_prefix.as_deref(),
             result.maybe_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/media_files/search/search_session_media_files_handler.rs

@@ -262,10 +262,11 @@ pub async fn search_session_media_files_handler(
           public_bucket_path: public_bucket_path
               .get_full_object_path_str()
               .to_string(),
-          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path),
+          public_bucket_url: bucket_url_string_from_media_path(&public_bucket_path, media_domain, server_state.server_environment),
           cover_image: MediaFileCoverImageDetails::from_optional_db_fields(
             &result.token,
             media_domain,
+            server_state.server_environment,
             result.maybe_cover_image_public_bucket_hash.as_deref(),
             result.maybe_cover_image_public_bucket_prefix.as_deref(),
             result.maybe_cover_image_public_bucket_extension.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/moderation/wallets/mod.rs

@@ -1,3 +1,4 @@
 pub mod list_user_wallets_handler;
 pub mod moderator_add_banked_balance_to_wallet_handler;
+pub mod moderator_create_wallet_for_user_handler;
 pub mod moderator_get_wallet_handler;

crates/service/web/storyteller_web/src/http_server/endpoints/moderation/wallets/moderator_create_wallet_for_user_handler.rs

@@ -0,0 +1,116 @@
+use std::sync::Arc;
+
+use actix_web::web::Json;
+use actix_web::{web, HttpRequest};
+use enums::common::payments_namespace::PaymentsNamespace;
+use log::{error, warn};
+use sqlx::Acquire;
+
+use artcraft_api_defs::moderation::wallets::moderator_create_wallet_for_user::{
+  ModeratorCreateWalletForUserRequest,
+  ModeratorCreateWalletForUserResponse,
+};
+use mysql_queries::queries::users::user::get::get_username_by_user_token::get_username_by_user_token;
+use mysql_queries::queries::wallets::create_new_wallet_for_owner_user::create_new_wallet_for_owner_user;
+use mysql_queries::queries::wallets::find_primary_wallet_token_for_owner::find_primary_wallet_token_for_owner_using_connection;
+
+use crate::http_server::common_responses::common_web_error::CommonWebError;
+use crate::http_server::web_utils::user_session::require_moderator::{require_moderator, UseDatabase};
+use crate::state::server_state::ServerState;
+
+/// Create a wallet for a user (moderation)
+#[utoipa::path(
+  post,
+  tag = "Moderation",
+  path = "/v1/moderation/wallet/create_for_user",
+  request_body = ModeratorCreateWalletForUserRequest,
+  responses(
+    (status = 200, description = "Success", body = ModeratorCreateWalletForUserResponse),
+    (status = 400, description = "Bad request"),
+    (status = 401, description = "Unauthorized"),
+    (status = 500, description = "Server error"),
+  ),
+)]
+pub async fn moderator_create_wallet_for_user_handler(
+  http_request: HttpRequest,
+  request: Json<ModeratorCreateWalletForUserRequest>,
+  server_state: web::Data<Arc<ServerState>>,
+) -> Result<Json<ModeratorCreateWalletForUserResponse>, CommonWebError> {
+
+  let _user_session = require_moderator(&http_request, &server_state, UseDatabase::GrabNewConnection)
+    .await
+    .map_err(|_| CommonWebError::NotAuthorized)?;
+
+  let user_token = request.user_token.as_ref()
+    .ok_or_else(|| CommonWebError::BadInputWithSimpleMessage("user_token is required".to_string()))?;
+
+  // Verify user exists
+  let maybe_user = get_username_by_user_token(user_token, &server_state.mysql_pool)
+    .await
+    .map_err(|err| {
+      warn!("moderator_create_wallet_for_user user lookup error: {:?}", err);
+      CommonWebError::ServerError
+    })?;
+
+  if maybe_user.is_none() {
+    return Err(CommonWebError::BadInputWithSimpleMessage("User not found".to_string()));
+  }
+
+  let namespace = request.payments_namespace.unwrap_or(PaymentsNamespace::Artcraft);
+
+  // Check for existing wallet
+  let mut mysql_connection = server_state.mysql_pool
+    .acquire()
+    .await
+    .map_err(|err| {
+      error!("Error acquiring MySQL connection: {:?}", err);
+      CommonWebError::ServerError
+    })?;
+
+  let maybe_wallet_token = find_primary_wallet_token_for_owner_using_connection(
+    user_token,
+    namespace,
+    &mut mysql_connection,
+  ).await.map_err(|err| {
+    error!("Error finding wallet for user {:?}: {:?}", user_token, err);
+    CommonWebError::ServerError
+  })?;
+
+  if let Some(wallet_token) = maybe_wallet_token {
+    return Ok(Json(ModeratorCreateWalletForUserResponse {
+      success: true,
+      wallet_token,
+    }));
+  }
+
+  // Create new wallet
+  let mut transaction = mysql_connection
+    .begin()
+    .await
+    .map_err(|err| {
+      error!("Error starting MySQL transaction: {:?}", err);
+      CommonWebError::ServerError
+    })?;
+
+  let wallet_token = create_new_wallet_for_owner_user(
+    user_token,
+    namespace,
+    &mut transaction,
+  ).await.map_err(|err| {
+    error!("Error creating wallet for user {:?}: {:?}", user_token, err);
+    CommonWebError::ServerError
+  })?;
+
+  transaction
+    .commit()
+    .await
+    .map_err(|err| {
+      error!("Error committing MySQL transaction: {:?}", err);
+      CommonWebError::ServerError
+    })?;
+
+  Ok(Json(ModeratorCreateWalletForUserResponse {
+    success: true,
+    wallet_token,
+  }))
+}

crates/service/web/storyteller_web/src/http_server/endpoints/user_bookmarks/list_user_bookmarks_for_user_handler.rs

@@ -243,6 +243,7 @@ pub async fn list_user_bookmarks_for_user_handler(
               maybe_media_file_cover = Some(MediaFileCoverImageDetails::from_optional_db_fields(
                 &MediaFileToken::new_from_str(&user_bookmark.entity_token),
                 media_domain,
+                server_state.server_environment,
                 user_bookmark.maybe_media_file_cover_image_public_bucket_hash.as_deref(),
                 user_bookmark.maybe_media_file_cover_image_public_bucket_prefix.as_deref(),
                 user_bookmark.maybe_media_file_cover_image_public_bucket_extension.as_deref(),
@@ -251,6 +252,7 @@ pub async fn list_user_bookmarks_for_user_handler(
             UserBookmarkEntityType::ModelWeight => {
               maybe_model_weight_cover = Some(WeightsCoverImageDetails::from_optional_db_fields(
                 media_domain,
+                server_state.server_environment,
                 &ModelWeightToken::new_from_str(&user_bookmark.entity_token),
                 user_bookmark.maybe_model_weight_cover_image_public_bucket_hash.as_deref(),
                 user_bookmark.maybe_model_weight_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/get/get_weight_handler.rs

@@ -184,6 +184,7 @@ pub async fn get_weight_handler(
 
     let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
         media_domain,
+        server_state.server_environment,
         &weight.token,
         weight.maybe_cover_image_public_bucket_hash.as_deref(),
         weight.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/list/list_available_weights_handler.rs

@@ -234,6 +234,7 @@ pub async fn list_available_weights_handler(
             .map(|weight| {
                 let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
                     media_domain,
+                    server_state.server_environment,
                     &weight.token,
                     weight.maybe_cover_image_public_bucket_hash.as_deref(),
                     weight.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/list/list_featured_weights_handler.rs

@@ -235,6 +235,7 @@ pub async fn list_featured_weights_handler(
         .map(|w| {
           let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
             media_domain,
+            server_state.server_environment,
             &w.token,
             w.maybe_cover_image_public_bucket_hash.as_deref(),
             w.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/list/list_pinned_weights_handler.rs

@@ -156,6 +156,7 @@ pub async fn list_pinned_weights_handler(
         .map(|w| {
           let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
             media_domain,
+            server_state.server_environment,
             &w.token,
             w.maybe_cover_image_public_bucket_hash.as_deref(),
             w.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/list/list_weights_by_user_handler.rs

@@ -212,6 +212,7 @@ pub async fn list_weights_by_user_handler(
 
     let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
       media_domain,
+      server_state.server_environment,
       &weight.token,
       weight.maybe_cover_image_public_bucket_hash.as_deref(),
       weight.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/endpoints/weights/search/search_model_weights_impl.rs

@@ -201,6 +201,7 @@ pub async fn search_model_weights_impl(
       .map(|result| {
         let cover_image_details = WeightsCoverImageDetails::from_optional_db_fields(
           media_domain,
+          server_state.server_environment,
           &result.token,
           result.maybe_cover_image_public_bucket_hash.as_deref(),
           result.maybe_cover_image_public_bucket_prefix.as_deref(),

crates/service/web/storyteller_web/src/http_server/routes/application_routes/moderation_routes.rs

@@ -24,6 +24,7 @@ use crate::http_server::endpoints::moderation::wallet_ledger_entries::list_walle
 use crate::http_server::endpoints::moderation::wallet_ledger_entries::moderator_get_wallet_ledger_entry_handler::moderator_get_wallet_ledger_entry_handler;
 use crate::http_server::endpoints::moderation::wallets::list_user_wallets_handler::list_user_wallets_handler;
 use crate::http_server::endpoints::moderation::wallets::moderator_add_banked_balance_to_wallet_handler::moderator_add_banked_balance_to_wallet_handler;
+use crate::http_server::endpoints::moderation::wallets::moderator_create_wallet_for_user_handler::moderator_create_wallet_for_user_handler;
 use crate::http_server::endpoints::moderation::wallets::moderator_get_wallet_handler::moderator_get_wallet_handler;
 use crate::http_server::endpoints::moderation::jobs::get_tts_inference_queue_count::get_tts_inference_queue_count_handler;
 use crate::http_server::endpoints::moderation::jobs::get_w2l_inference_queue_count::get_w2l_inference_queue_count_handler;
@@ -66,13 +67,19 @@ pub fn add_moderator_routes<T, B> (app: App<T>) -> App<T>
                 .route(web::head().to(|| HttpResponse::Ok()))
             )
         )
-        .service(web::resource("/wallet/{wallet_token}")
-            .route(web::get().to(moderator_get_wallet_handler))
-            .route(web::head().to(|| HttpResponse::Ok()))
-        )
-        .service(web::resource("/wallet/{wallet_token}/add_banked_balance")
-            .route(web::post().to(moderator_add_banked_balance_to_wallet_handler))
-            .route(web::head().to(|| HttpResponse::Ok()))
+        .service(web::scope("/wallet")
+            .service(web::resource("/create_for_user")
+                .route(web::post().to(moderator_create_wallet_for_user_handler))
+                .route(web::head().to(|| HttpResponse::Ok()))
+            )
+            .service(web::resource("/{wallet_token}")
+                .route(web::get().to(moderator_get_wallet_handler))
+                .route(web::head().to(|| HttpResponse::Ok()))
+            )
+            .service(web::resource("/{wallet_token}/add_banked_balance")
+                .route(web::post().to(moderator_add_banked_balance_to_wallet_handler))
+                .route(web::head().to(|| HttpResponse::Ok()))
+            )
         )
         .service(web::scope("/wallets")
             .service(web::resource("/user/{user_token}/list")

crates/service/web/storyteller_web/src/http_server/web_utils/bucket_urls/bucket_url_from_media_path.rs

@@ -2,13 +2,20 @@ use url::Url;
 
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
 use errors::AnyhowResult;
+use server_environment::ServerEnvironment;
+
+use crate::http_server::common_responses::media::cdn_link;
+use crate::http_server::common_responses::media::media_domain::MediaDomain;
 
 #[deprecated(note = "This is tied to GCP and is legacy.")]
 pub fn bucket_url_from_media_path(
   bucket_path: &MediaFileBucketPath,
+  domain: MediaDomain,
+  server_environment: ServerEnvironment,
 ) -> AnyhowResult<Url> {
   let path = bucket_path.get_full_object_path_str();
-  let url = format!("https://cdn-2.fakeyou.com{}", path);
+  let host = cdn_link::get_cdn_host(domain, server_environment);
+  let url = format!("{host}{path}");
   let url = Url::parse(&url)?;
   Ok(url)
 }
@@ -18,14 +25,24 @@ mod tests {
   use url::Url;
 
   use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+  use server_environment::ServerEnvironment;
 
+  use crate::http_server::common_responses::media::media_domain::MediaDomain;
   use crate::http_server::web_utils::bucket_urls::bucket_url_from_media_path::bucket_url_from_media_path;
 
   #[test]
-  fn test() {
+  fn test_production() {
     let bucket_path = MediaFileBucketPath::from_object_hash("test", Some("pre_"), Some(".ext"));
 
-    assert_eq!(bucket_url_from_media_path(&bucket_path).unwrap(),
-               Url::parse("https://storage.googleapis.com/vocodes-public/media/t/e/s/test/pre_test.ext").unwrap());
+    assert_eq!(bucket_url_from_media_path(&bucket_path, MediaDomain::FakeYou, ServerEnvironment::Production).unwrap(),
+               Url::parse("https://cdn-2.fakeyou.com/media/t/e/s/test/pre_test.ext").unwrap());
+  }
+
+  #[test]
+  fn test_development() {
+    let bucket_path = MediaFileBucketPath::from_object_hash("test", Some("pre_"), Some(".ext"));
+
+    assert_eq!(bucket_url_from_media_path(&bucket_path, MediaDomain::FakeYou, ServerEnvironment::Development).unwrap(),
+               Url::parse("https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/media/t/e/s/test/pre_test.ext").unwrap());
   }
 }

crates/service/web/storyteller_web/src/http_server/web_utils/bucket_urls/bucket_url_from_str_path.rs

@@ -1,11 +1,18 @@
 use url::Url;
 
 use errors::AnyhowResult;
+use server_environment::ServerEnvironment;
+
+use crate::http_server::common_responses::media::cdn_link;
+use crate::http_server::common_responses::media::media_domain::MediaDomain;
 
 pub fn bucket_url_from_str_path(
   bucket_path: &str,
+  domain: MediaDomain,
+  server_environment: ServerEnvironment,
 ) -> AnyhowResult<Url> {
-  let url = format!("https://cdn-2.fakeyou.com{}", bucket_path);
+  let host = cdn_link::get_cdn_host(domain, server_environment);
+  let url = format!("{host}{bucket_path}");
   let url = Url::parse(&url)?;
   Ok(url)
 }
@@ -13,12 +20,20 @@ pub fn bucket_url_from_str_path(
 #[cfg(test)]
 mod tests {
   use url::Url;
+  use server_environment::ServerEnvironment;
 
+  use crate::http_server::common_responses::media::media_domain::MediaDomain;
   use crate::http_server::web_utils::bucket_urls::bucket_url_from_str_path::bucket_url_from_str_path;
 
   #[test]
-  fn test() {
-    assert_eq!(bucket_url_from_str_path("/foo/bar").unwrap(),
-               Url::parse("https://storage.googleapis.com/vocodes-public/foo/bar").unwrap());
+  fn test_production() {
+    assert_eq!(bucket_url_from_str_path("/foo/bar", MediaDomain::FakeYou, ServerEnvironment::Production).unwrap(),
+               Url::parse("https://cdn-2.fakeyou.com/foo/bar").unwrap());
+  }
+
+  #[test]
+  fn test_development() {
+    assert_eq!(bucket_url_from_str_path("/foo/bar", MediaDomain::FakeYou, ServerEnvironment::Development).unwrap(),
+               Url::parse("https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/foo/bar").unwrap());
   }
 }

crates/service/web/storyteller_web/src/http_server/web_utils/bucket_urls/bucket_url_string_from_media_path.rs

@@ -1,24 +1,41 @@
 use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+use server_environment::ServerEnvironment;
+
+use crate::http_server::common_responses::media::cdn_link;
+use crate::http_server::common_responses::media::media_domain::MediaDomain;
 
 /// An infallible version of `bucket_url_from_media_path` that returns a string.
 pub fn bucket_url_string_from_media_path(
   bucket_path: &MediaFileBucketPath,
+  domain: MediaDomain,
+  server_environment: ServerEnvironment,
 ) -> String {
   let path = bucket_path.get_full_object_path_str();
-  format!("https://cdn-2.fakeyou.com{}", path)
+  let host = cdn_link::get_cdn_host(domain, server_environment);
+  format!("{host}{path}")
 }
 
 #[cfg(test)]
 mod tests {
   use bucket_paths::legacy::typified_paths::public::media_files::bucket_file_path::MediaFileBucketPath;
+  use server_environment::ServerEnvironment;
 
+  use crate::http_server::common_responses::media::media_domain::MediaDomain;
   use crate::http_server::web_utils::bucket_urls::bucket_url_string_from_media_path::bucket_url_string_from_media_path;
 
   #[test]
-  fn test() {
+  fn test_production() {
     let bucket_path = MediaFileBucketPath::from_object_hash("test", Some("pre_"), Some(".ext"));
 
-    assert_eq!(&bucket_url_string_from_media_path(&bucket_path),
-               "https://storage.googleapis.com/vocodes-public/media/t/e/s/test/pre_test.ext");
+    assert_eq!(&bucket_url_string_from_media_path(&bucket_path, MediaDomain::FakeYou, ServerEnvironment::Production),
+               "https://cdn-2.fakeyou.com/media/t/e/s/test/pre_test.ext");
+  }
+
+  #[test]
+  fn test_development() {
+    let bucket_path = MediaFileBucketPath::from_object_hash("test", Some("pre_"), Some(".ext"));
+
+    assert_eq!(&bucket_url_string_from_media_path(&bucket_path, MediaDomain::FakeYou, ServerEnvironment::Development),
+               "https://pub-c8a4a5bdbdb048f286b77bdf9f786ff2.r2.dev/media/t/e/s/test/pre_test.ext");
   }
 }

frontend/apps/artcraft-website/vite.config.ts

@@ -1,7 +1,7 @@
 /// <reference types='vitest' />
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
-import tsconfigPaths from 'vite-tsconfig-paths';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
 import { execSync } from 'child_process';
 import path from 'path';
 
@@ -42,7 +42,7 @@ export default defineConfig(() => ({
     port: 4300,
     host: 'localhost',
   },
-  plugins: [generateNewsPlugin(), tsconfigPaths(), react()],
+  plugins: [generateNewsPlugin(), nxViteTsPaths(), react()],
   // Uncomment this if you are using workers.
   // worker: {
   //  plugins: [ nxViteTsPaths() ],

frontend/apps/artcraft/app/src/components/experiences/ImageTo3DExperience.tsx

@@ -140,6 +140,12 @@ export const ImageTo3DExperience = ({
   const clearPendingExternalImage = useImageTo3DWorldStore(
     (s) => s.clearPendingExternalImage,
   );
+  const pendingObjectImage = useImageTo3DStore(
+    (s) => s.pendingExternalImage,
+  );
+  const clearPendingObjectImage = useImageTo3DStore(
+    (s) => s.clearPendingExternalImage,
+  );
 
   const results = variant === "object" ? objectResults : worldResults;
   const resetResults = variant === "object" ? objectReset : worldReset;
@@ -153,24 +159,34 @@ export const ImageTo3DExperience = ({
 
   useEffect(() => {
     // Read from store directly to avoid Strict Mode double-execution adding the image twice
-    const pending = useImageTo3DWorldStore.getState().pendingExternalImage;
-    if (variant === "world" && pending) {
-      setWorldImages((prev) => {
-        if (prev.length >= MAX_WORLD_IMAGES) return prev;
-        return [
-          ...prev,
-          {
-            id: generateId(),
-            preview: pending.url,
-            mediaToken: pending.mediaToken,
-            name: "Library Image",
-            isUploading: false,
-          },
-        ];
-      });
-      clearPendingExternalImage();
+    if (variant === "world") {
+      const pending = useImageTo3DWorldStore.getState().pendingExternalImage;
+      if (pending) {
+        setWorldImages((prev) => {
+          if (prev.length >= MAX_WORLD_IMAGES) return prev;
+          return [
+            ...prev,
+            {
+              id: generateId(),
+              preview: pending.url,
+              mediaToken: pending.mediaToken,
+              name: "Library Image",
+              isUploading: false,
+            },
+          ];
+        });
+        clearPendingExternalImage();
+      }
+    } else if (variant === "object") {
+      const pending = useImageTo3DStore.getState().pendingExternalImage;
+      if (pending) {
+        setUploadedPreview(pending.url);
+        setUploadedMediaToken(pending.mediaToken);
+        setUploadedName("Library Image");
+        clearPendingObjectImage();
+      }
     }
-  }, [variant, pendingExternalImage, clearPendingExternalImage]);
+  }, [variant, pendingExternalImage, clearPendingExternalImage, pendingObjectImage, clearPendingObjectImage]);
 
   useEffect(() => {
     const onResize = () => setVh(window.innerHeight);

frontend/apps/artcraft/app/src/components/signaled/TopBar/TaskQueue.tsx

@@ -10,6 +10,7 @@ import {
   faBroom,
   faBomb,
   faCircleExclamation,
+  faTriangleExclamation,
 } from "@fortawesome/pro-solid-svg-icons";
 import { Modal } from "@storyteller/ui-modal";
 import {
@@ -55,6 +56,7 @@ type InProgressTask = {
   updatedAt?: Date;
   canDismiss?: boolean;
   estimatedTimeLeftMs?: number;
+  modelType?: string;
 };
 
 type CompletedTask = {
@@ -76,6 +78,7 @@ type FailedTask = {
   subtitle?: string;
   failedAt?: Date;
   status: string;
+  failureReason?: string;
 };
 
 const formatTimeLeft = (ms: number): string => {
@@ -104,6 +107,7 @@ const InProgressCard = ({
     : task.estimatedTimeLeftMs != null && task.estimatedTimeLeftMs > 0
       ? formatTimeLeft(task.estimatedTimeLeftMs)
       : null;
+  const isSeedance2 = task.modelType === "seedance_2p0";
   return (
     <div className="rounded-md p-2 transition-colors hover:bg-ui-controls/40">
       <div className="flex items-center gap-2.5">
@@ -116,8 +120,23 @@ const InProgressCard = ({
         </div>
         <div className="min-w-0 flex-1">
           <div className="flex items-center justify-between text-sm">
-            <div className="truncate font-medium text-base-fg/90">
+            <div className="flex items-center gap-1.5 truncate font-medium text-base-fg/90">
               {task.title}
+              {isSeedance2 && (
+                <Tooltip
+                  content="Seedance 2.0 is in Early Alpha. Generations may be slow and may experience outages."
+                  position="top"
+                  strategy="fixed"
+                  className="w-[200px] text-wrap bg-yellow-400/60 backdrop-blur-3xl"
+                  zIndex={50}
+                  delay={100}
+                >
+                  <FontAwesomeIcon
+                    icon={faTriangleExclamation}
+                    className="h-3 w-3 shrink-0 text-yellow-400/60 transition-all hover:text-yellow-400"
+                  />
+                </Tooltip>
+              )}
             </div>
             <div className="ml-2 shrink-0 text-xs tabular-nums text-base-fg/60">
               {progressPercent}%
@@ -237,6 +256,18 @@ const FAILED_STATUS_LABEL: Record<string, string> = {
   cancelled_by_us: "Cancelled",
 };
 
+const FAILURE_REASON_LABEL: Record<string, string> = {
+  rule_bans_user_image: "Image violates content policy",
+  rule_bans_user_image_with_faces: "Images with faces are not allowed",
+  rule_bans_user_text_prompt: "Text prompt violates content policy",
+  rule_bans_user_content: "Content violates content policy",
+  rule_bans_generated_video: "Generated video flagged by content policy",
+  rule_bans_generated_audio: "Generated audio flagged by content policy",
+  rule_bans_generated_content: "Generated content flagged by content policy",
+  generation_failed: "Generation failed",
+  unknown: "An unknown error occurred",
+};
+
 const FailedCard = ({
   task,
   onDismiss,
@@ -269,6 +300,11 @@ const FailedCard = ({
           <div className="mt-1 text-xs font-medium text-red-400">
             {statusLabel}
           </div>
+          {task.failureReason && (
+            <div className="mt-0.5 text-xs text-red-400/60">
+              {task.failureReason}
+            </div>
+          )}
         </div>
         {onDismiss && (
           <button
@@ -412,7 +448,9 @@ export const TaskQueue = () => {
         ? getProviderDisplayName(String(t.provider).toLowerCase())
         : undefined;
       const taskTypeStr = t.task_type ? String(t.task_type).toLowerCase() : "";
-      const modelTypeStr = t.model_type ? String(t.model_type).toLowerCase() : "";
+      const modelTypeStr = t.model_type
+        ? String(t.model_type).toLowerCase()
+        : "";
       const isSplatModel =
         taskTypeStr.includes("gaussian") ||
         modelTypeStr.includes("marble") ||
@@ -498,6 +536,7 @@ export const TaskQueue = () => {
               updatedAt: t.updated_at,
               canDismiss,
               estimatedTimeLeftMs,
+              modelType: t.model_type ? String(t.model_type) : undefined,
             };
           });
 
@@ -562,12 +601,19 @@ export const TaskQueue = () => {
           .sort((a, b) => b.updated_at.getTime() - a.updated_at.getTime())
           .map((t: TaskQueueItem) => {
             const parts = formatTitleParts(t);
+            const fr = t.failure_reason;
+            const failureReason = fr
+              ? fr.failure_message ||
+                FAILURE_REASON_LABEL[fr.failure_type] ||
+                undefined
+              : undefined;
             return {
               id: t.id,
               title: parts.title || "Task",
               subtitle: parts.subtitle,
               failedAt: t.completed_at || t.updated_at,
               status: t.task_status,
+              failureReason,
             };
           });
 

frontend/apps/artcraft/app/src/components/signaled/TopBar/TopBar.tsx

@@ -63,6 +63,7 @@ import {
   is3DSceneLoaded,
   set3DPageMounted,
 } from "~/pages/PageEnigma/Editor/editor";
+import { useImageTo3DStore } from "~/pages/PageImageTo3DObject/ImageTo3DStore";
 import { useImageTo3DWorldStore } from "~/pages/PageImageTo3DWorld/ImageTo3DWorldStore";
 import { useRemoveBackgroundStore } from "~/pages/PageRemoveBackground/RemoveBackgroundStore";
 import { TabId, useTabStore } from "~/pages/Stores/TabState";
@@ -274,6 +275,23 @@ export const TopBar = ({ pageName }: Props) => {
     }
   };
 
+  const handleMake3DObjectFromGallery = async (
+    url: string,
+    mediaId?: string,
+  ) => {
+    try {
+      if (mediaId) {
+        useImageTo3DStore.getState().setPendingExternalImage(url, mediaId);
+      }
+      useTabStore.getState().setActiveTab("IMAGE_TO_3D_OBJECT");
+      galleryModalVisibleViewMode.value = false;
+      galleryModalVisibleDuringDrag.value = false;
+      galleryModalLightboxVisible.value = false;
+    } catch (e) {
+      // no-op
+    }
+  };
+
   const handleMake3DWorldFromGallery = async (
     url: string,
     mediaId?: string,
@@ -620,6 +638,7 @@ export const TopBar = ({ pageName }: Props) => {
         onEditClicked={handleEditFromGallery}
         onTurnIntoVideoClicked={handleTurnIntoVideoFromGallery}
         onRemoveBackgroundClicked={handleRemoveBackgroundFromGallery}
+        onMake3DObjectClicked={handleMake3DObjectFromGallery}
         onMake3DWorldClicked={handleMake3DWorldFromGallery}
       />
 

frontend/apps/artcraft/app/src/pages/PageImageTo3DObject/ImageTo3DStore.ts

@@ -129,6 +129,11 @@ async function captureModelThumbnail(modelUrl: string): Promise<string | null> {
   });
 }
 
+export interface PendingExternalImage {
+  url: string;
+  mediaToken: string;
+}
+
 export type ImageTo3DResult = {
   id: string;
   mode: "image" | "text";
@@ -149,6 +154,9 @@ export const coverImageCache = new Map<string, string>();
 
 type ImageTo3DState = {
   results: ImageTo3DResult[];
+  pendingExternalImage: PendingExternalImage | null;
+  setPendingExternalImage: (url: string, mediaToken: string) => void;
+  clearPendingExternalImage: () => void;
   startGeneration: (
     mode: "image" | "text",
     note: string,
@@ -175,6 +183,13 @@ type ImageTo3DState = {
 
 export const useImageTo3DStore = create<ImageTo3DState>((set, get) => ({
   results: [],
+  pendingExternalImage: null,
+  setPendingExternalImage: (url: string, mediaToken: string) => {
+    set({ pendingExternalImage: { url, mediaToken } });
+  },
+  clearPendingExternalImage: () => {
+    set({ pendingExternalImage: null });
+  },
   startGeneration: (
     mode: "image" | "text",
     note: string,

frontend/apps/genhub/_redirects

@@ -0,0 +1 @@
+/* /index.html 200

frontend/apps/genhub/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "radix-nova",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/styles.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "~/components",
+    "utils": "~/lib/utils",
+    "ui": "~/components/ui",
+    "lib": "~/lib",
+    "hooks": "~/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

frontend/apps/genhub/index.html

@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    <!-- Primary Meta Tags -->
+    <title>GenHub - Discover & Share AI-Generated Art and Prompts</title>
+    <meta name="description" content="Discover, share, and remix AI-generated art and prompts. Browse a community-driven gallery of images created with Stable Diffusion, Midjourney, DALL-E, and more." />
+    <meta name="keywords" content="AI art, AI prompts, stable diffusion, midjourney, DALL-E, prompt gallery, AI generated images, text to image, prompt engineering, generative AI" />
+    <meta name="theme-color" content="#000000" />
+    <meta name="author" content="GenHub" />
+
+    <!-- Canonical -->
+    <link rel="canonical" href="https://genhub.app/" />
+
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" content="website" />
+    <meta property="og:url" content="https://genhub.app/" />
+    <meta property="og:title" content="GenHub - Discover & Share AI-Generated Art and Prompts" />
+    <meta property="og:description" content="Discover, share, and remix AI-generated art and prompts. Browse a community-driven gallery of images created with Stable Diffusion, Midjourney, DALL-E, and more." />
+    <meta property="og:image" content="https://genhub.app/og-image.png" />
+    <meta property="og:site_name" content="GenHub" />
+    <meta property="og:locale" content="en_US" />
+
+    <!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:url" content="https://genhub.app/" />
+    <meta name="twitter:title" content="GenHub - Discover & Share AI-Generated Art and Prompts" />
+    <meta name="twitter:description" content="Discover, share, and remix AI-generated art and prompts. Browse a community-driven gallery of images created with Stable Diffusion, Midjourney, DALL-E, and more." />
+    <meta name="twitter:image" content="https://genhub.app/og-image.png" />
+
+    <!-- Favicon -->
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
+    <link rel="apple-touch-icon" href="/og-image.png" />
+
+    <!-- Styles -->
+    <link rel="stylesheet" href="/src/styles.css" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

frontend/apps/genhub/netlify.toml

@@ -0,0 +1,41 @@
+[build]
+command = "./apps/genhub/script/netlify_build.sh"
+publish = "apps/genhub/dist/"
+
+[[headers]]
+for = "/build/*"
+
+[headers.values]
+"Cache-Control" = "public, max-age=31560000, immutable"
+
+[[headers]]
+for = "/og-image.png"
+
+[headers.values]
+"Cache-Control" = "public, max-age=86400"
+
+[[headers]]
+for = "/robots.txt"
+
+[headers.values]
+"Cache-Control" = "public, max-age=3600"
+
+[[headers]]
+for = "/sitemap.xml"
+
+[headers.values]
+"Cache-Control" = "public, max-age=3600"
+
+# [[redirects]]
+#   from = "/ingest/static/*"
+#   to = "https://us-assets.i.posthog.com/static/:splat"
+#   host = "us-assets.i.posthog.com"
+#   status = 200
+#   force = true
+# 
+# [[redirects]]
+#   from = "/ingest/*"
+#   to = "https://us.i.posthog.com/:splat"
+#   host = "us.i.posthog.com"
+#   status = 200
+#   force = true

frontend/apps/genhub/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@frontend/genhub",
+  "version": "0.0.1",
+  "private": true,
+  "dependencies": {
+    "@fontsource-variable/figtree": "^5.2.10",
+    "@fontsource-variable/geist": "^5.2.8",
+    "@tailwindcss/vite": "^4.2.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.512.0",
+    "next-themes": "^0.4.6",
+    "radix-ui": "^1.4.3",
+    "react-helmet-async": "^3.0.0",
+    "react-masonry-css": "^1.0.16",
+    "react-resizable-panels": "^4.7.2",
+    "shadcn": "^4.0.5",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^2.2.2",
+    "tailwindcss": "^4.2.1",
+    "tw-animate-css": "^1.4.0",
+    "vaul": "^1.1.2"
+  }
+}

frontend/apps/genhub/public/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://genhub.app/sitemap.xml

frontend/apps/genhub/public/sitemap.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://genhub.app/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+</urlset>

frontend/apps/genhub/public/svg/artcraft-logo-black.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_2" data-name="Layer 2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 72.22 65.68">
+  <g id="Layer_1-2" data-name="Layer 1">
+    <path d="M69.38,45.46c-3.18-6.24-6.58-12.49-9.86-18.53-3.31-6.08-6.72-12.37-9.91-18.63l-.05-.09C46.44,3.07,41.24,0,35.66,0s-10.34,3-13.13,8.23L.97,48.96l-.03.07c-1.51,3.8-1.2,8.03.82,11.31,1.9,3.08,5.01,4.96,8.76,5.28.38.03.75.05,1.1.05,2.94,0,4.98-1.12,7.33-2.41,7.13-3.91,19.45-11.21,27.61-16.04,2.6-1.54,4.95-2.93,6.31-3.73l10.71,20.43c.2.39.54.7.95.86.46.19.98.2,1.43,0,1.39-.66,3.05-2.47,3.07-2.49,5.22-5.9,3.03-11.55.34-16.83ZM34.53,14.8c.31-.46.77-.99,1.32-.99.58,0,1.29.57,1.85,1.49,1.57,2.56,2.99,5.44,4.35,8.22,1.34,2.73,2.72,5.55,4.29,8.15l.02.05-29.6,16.99L34.53,14.8Z"/>
+  </g>
+</svg>

frontend/apps/genhub/script/netlify_build.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+set -euxo pipefail 
+
+echo "Run build script (TODO: Make strict)"
+nx build genhub
+
+echo "Change to project dir"
+pushd apps/genhub/
+
+echo "Copy netlify configs into dist"
+#cp _headers dist/
+cp _redirects dist/
+
+#echo "Copy netlify 404.html page into dist"
+#cp "404.html" dist/
+
+echo "List final files in build"
+find dist/
+

frontend/apps/genhub/src/app/app.module.css

@@ -0,0 +1 @@
+/* Your styles goes here. */

frontend/apps/genhub/src/app/app.spec.tsx

@@ -0,0 +1,16 @@
+import { render } from '@testing-library/react';
+import { BrowserRouter } from 'react-router-dom';
+
+import App from './app';
+
+describe('App', () => {
+  it('should render successfully', () => {
+    const { baseElement } = render(<BrowserRouter><App /></BrowserRouter>);
+    expect(baseElement).toBeTruthy();
+  });
+
+  it('should have a greeting as the title', () => {
+    const { getAllByText } = render(<BrowserRouter><App /></BrowserRouter>);
+    expect(getAllByText(new RegExp('Welcome @frontend/genhub', 'gi')).length > 0).toBeTruthy();
+  });
+});

frontend/apps/genhub/src/app/app.tsx

@@ -0,0 +1,60 @@
+import { Routes, Route, useLocation, useNavigate, useParams, Navigate } from 'react-router-dom';
+import type { Location } from 'react-router-dom';
+import { ThemeProvider } from 'next-themes';
+import { SEO } from '~/components/seo';
+import { Navbar } from '~/components/layout/navbar';
+import { AuthProvider } from '~/hooks/use-auth';
+import { FeedPage } from '~/pages/feed';
+import { LoginPage } from '~/pages/login';
+import { SignupPage } from '~/pages/signup';
+import { PromptPage } from '~/pages/prompt';
+import { MediaDialog } from '~/components/feed/media-dialog';
+import { getItemById } from '~/data/mock-gallery';
+
+/** Modal overlay rendered when navigating to /prompt/:id from the feed. */
+function PromptModal() {
+  const { id } = useParams<{ id: string }>();
+  const navigate = useNavigate();
+  const item = id ? getItemById(id) : null;
+
+  if (!item) return <Navigate to="/" replace />;
+
+  return (
+    <MediaDialog
+      item={item}
+      open
+      onOpenChange={(open) => {
+        if (!open) navigate(-1);
+      }}
+    />
+  );
+}
+
+export function App() {
+  const location = useLocation();
+  const state = location.state as { backgroundLocation?: Location } | null;
+
+  return (
+    <ThemeProvider attribute="class" defaultTheme="light" enableSystem>
+      <AuthProvider>
+        <SEO />
+        <Navbar />
+        <Routes location={state?.backgroundLocation || location}>
+          <Route path="/" element={<FeedPage />} />
+          <Route path="/prompt/:id" element={<PromptPage />} />
+          <Route path="/login" element={<LoginPage />} />
+          <Route path="/signup" element={<SignupPage />} />
+        </Routes>
+
+        {/* When coming from feed, show the prompt as a modal overlay */}
+        {state?.backgroundLocation && (
+          <Routes>
+            <Route path="/prompt/:id" element={<PromptModal />} />
+          </Routes>
+        )}
+      </AuthProvider>
+    </ThemeProvider>
+  );
+}
+
+export default App;

frontend/apps/genhub/src/app/nx-welcome.tsx

@@ -0,0 +1,857 @@
+/*
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+ This is a starter component and can be deleted.
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+ Delete this file and get started with your project!
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+ */
+export function NxWelcome({ title }: { title: string }) {
+  return (
+    <>
+      <style
+        dangerouslySetInnerHTML={{
+          __html: `
+    html {
+      -webkit-text-size-adjust: 100%;
+      font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+      'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif,
+      'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol',
+      'Noto Color Emoji';
+      line-height: 1.5;
+      tab-size: 4;
+      scroll-behavior: smooth;
+    }
+    body {
+      font-family: inherit;
+      line-height: inherit;
+      margin: 0;
+    }
+    h1,
+    h2,
+    p,
+    pre {
+      margin: 0;
+    }
+    *,
+    ::before,
+    ::after {
+      box-sizing: border-box;
+      border-width: 0;
+      border-style: solid;
+      border-color: currentColor;
+    }
+    h1,
+    h2 {
+      font-size: inherit;
+      font-weight: inherit;
+    }
+    a {
+      color: inherit;
+      text-decoration: inherit;
+    }
+    pre {
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+      'Liberation Mono', 'Courier New', monospace;
+    }
+    svg {
+      display: block;
+      vertical-align: middle;
+      shape-rendering: auto;
+      text-rendering: optimizeLegibility;
+    }
+    pre {
+      background-color: rgba(55, 65, 81, 1);
+      border-radius: 0.25rem;
+      color: rgba(229, 231, 235, 1);
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+      'Liberation Mono', 'Courier New', monospace;
+      overflow: auto;
+      padding: 0.5rem 0.75rem;
+    }
+
+    .shadow {
+      box-shadow: 0 0 #0000, 0 0 #0000, 0 10px 15px -3px rgba(0, 0, 0, 0.1),
+      0 4px 6px -2px rgba(0, 0, 0, 0.05);
+    }
+    .rounded {
+      border-radius: 1.5rem;
+    }
+    .wrapper {
+      width: 100%;
+    }
+    .container {
+      margin-left: auto;
+      margin-right: auto;
+      max-width: 768px;
+      padding-bottom: 3rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+      color: rgba(55, 65, 81, 1);
+      width: 100%;
+    }
+    #welcome {
+      margin-top: 2.5rem;
+    }
+    #welcome h1 {
+      font-size: 3rem;
+      font-weight: 500;
+      letter-spacing: -0.025em;
+      line-height: 1;
+    }
+    #welcome span {
+      display: block;
+      font-size: 1.875rem;
+      font-weight: 300;
+      line-height: 2.25rem;
+      margin-bottom: 0.5rem;
+    }
+    #hero {
+      align-items: center;
+      background-color: hsla(214, 62%, 21%, 1);
+      border: none;
+      box-sizing: border-box;
+      color: rgba(55, 65, 81, 1);
+      display: grid;
+      grid-template-columns: 1fr;
+      margin-top: 3.5rem;
+    }
+    #hero .text-container {
+      color: rgba(255, 255, 255, 1);
+      padding: 3rem 2rem;
+    }
+    #hero .text-container h2 {
+      font-size: 1.5rem;
+      line-height: 2rem;
+      position: relative;
+    }
+    #hero .text-container h2 svg {
+      color: hsla(162, 47%, 50%, 1);
+      height: 2rem;
+      left: -0.25rem;
+      position: absolute;
+      top: 0;
+      width: 2rem;
+    }
+    #hero .text-container h2 span {
+      margin-left: 2.5rem;
+    }
+    #hero .text-container a {
+      background-color: rgba(255, 255, 255, 1);
+      border-radius: 0.75rem;
+      color: rgba(55, 65, 81, 1);
+      display: inline-block;
+      margin-top: 1.5rem;
+      padding: 1rem 2rem;
+      text-decoration: inherit;
+    }
+    #hero .logo-container {
+      display: none;
+      justify-content: center;
+      padding-left: 2rem;
+      padding-right: 2rem;
+    }
+    #hero .logo-container svg {
+      color: rgba(255, 255, 255, 1);
+      width: 66.666667%;
+    }
+    #middle-content {
+      align-items: flex-start;
+      display: grid;
+      grid-template-columns: 1fr;
+      margin-top: 3.5rem;
+    }
+
+    #middle-content #middle-content-container {
+      display: flex;
+      flex-direction: column;
+      gap: 2rem;
+    }
+    #learning-materials {
+      padding: 2.5rem 2rem;
+    }
+    #learning-materials h2 {
+      font-weight: 500;
+      font-size: 1.25rem;
+      letter-spacing: -0.025em;
+      line-height: 1.75rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+    }
+    .list-item-link {
+      align-items: center;
+      border-radius: 0.75rem;
+      display: flex;
+      margin-top: 1rem;
+      padding: 1rem;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      transition-duration: 150ms;
+      width: 100%;
+    }
+    .list-item-link svg:first-child {
+      margin-right: 1rem;
+      height: 1.5rem;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      transition-duration: 150ms;
+      width: 1.5rem;
+    }
+    .list-item-link > span {
+      flex-grow: 1;
+      font-weight: 400;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+    }
+    .list-item-link > span > span {
+      color: rgba(107, 114, 128, 1);
+      display: block;
+      flex-grow: 1;
+      font-size: 0.75rem;
+      font-weight: 300;
+      line-height: 1rem;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+    }
+    .list-item-link svg:last-child {
+      height: 1rem;
+      transition-property: all;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      transition-duration: 150ms;
+      width: 1rem;
+    }
+    .list-item-link:hover {
+      color: rgba(255, 255, 255, 1);
+      background-color: hsla(162, 55%, 33%, 1);
+    }
+    .list-item-link:hover > span {}
+    .list-item-link:hover > span > span {
+      color: rgba(243, 244, 246, 1);
+    }
+    .list-item-link:hover svg:last-child {
+      transform: translateX(0.25rem);
+    }
+    #other-links {}
+    .button-pill {
+      padding: 1.5rem 2rem;
+      margin-bottom: 2rem;
+      transition-duration: 300ms;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      align-items: center;
+      display: flex;
+    }
+    .button-pill svg {
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      transition-duration: 150ms;
+      flex-shrink: 0;
+      width: 3rem;
+    }
+    .button-pill > span {
+      letter-spacing: -0.025em;
+      font-weight: 400;
+      font-size: 1.125rem;
+      line-height: 1.75rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+    }
+    .button-pill span span {
+      display: block;
+      font-size: 0.875rem;
+      font-weight: 300;
+      line-height: 1.25rem;
+    }
+    .button-pill:hover svg,
+    .button-pill:hover {
+      color: rgba(255, 255, 255, 1) !important;
+    }
+    #nx-console:hover {
+      background-color: rgba(0, 122, 204, 1);
+    }
+    #nx-console svg {
+      color: rgba(0, 122, 204, 1);
+    }
+    #nx-console-jetbrains {
+      margin-top: 2rem;
+    }
+    #nx-console-jetbrains:hover {
+      background-color: rgba(255, 49, 140, 1);
+    }
+    #nx-console-jetbrains svg {
+      color: rgba(255, 49, 140, 1);
+    }
+    #nx-repo:hover {
+      background-color: rgba(24, 23, 23, 1);
+    }
+    #nx-repo svg {
+      color: rgba(24, 23, 23, 1);
+    }
+    #nx-cloud {
+      margin-bottom: 2rem;
+      margin-top: 2rem;
+      padding: 2.5rem 2rem;
+    }
+    #nx-cloud > div {
+      align-items: center;
+      display: flex;
+    }
+    #nx-cloud > div svg {
+      border-radius: 0.375rem;
+      flex-shrink: 0;
+      width: 3rem;
+    }
+    #nx-cloud > div h2 {
+      font-size: 1.125rem;
+      font-weight: 400;
+      letter-spacing: -0.025em;
+      line-height: 1.75rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+    }
+    #nx-cloud > div h2 span {
+      display: block;
+      font-size: 0.875rem;
+      font-weight: 300;
+      line-height: 1.25rem;
+    }
+    #nx-cloud p {
+      font-size: 1rem;
+      line-height: 1.5rem;
+      margin-top: 1rem;
+    }
+    #nx-cloud pre {
+      margin-top: 1rem;
+    }
+    #nx-cloud a {
+      color: rgba(107, 114, 128, 1);
+      display: block;
+      font-size: 0.875rem;
+      line-height: 1.25rem;
+      margin-top: 1.5rem;
+      text-align: right;
+    }
+    #nx-cloud a:hover {
+      text-decoration: underline;
+    }
+    #commands {
+      padding: 2.5rem 2rem;
+      margin-top: 3.5rem;
+    }
+    #commands h2 {
+      font-size: 1.25rem;
+      font-weight: 400;
+      letter-spacing: -0.025em;
+      line-height: 1.75rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+    }
+    #commands p {
+      font-size: 1rem;
+      font-weight: 300;
+      line-height: 1.5rem;
+      margin-top: 1rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+    }
+    details {
+      align-items: center;
+      display: flex;
+      margin-top: 1rem;
+      padding-left: 1rem;
+      padding-right: 1rem;
+      width: 100%;
+    }
+    details pre > span {
+      color: rgba(181, 181, 181, 1);
+      display: block;
+    }
+    summary {
+      border-radius: 0.5rem;
+      display: flex;
+      font-weight: 400;
+      padding: 0.5rem;
+      cursor: pointer;
+      transition-property: background-color, border-color, color, fill, stroke,
+      opacity, box-shadow, transform, filter, backdrop-filter,
+      -webkit-backdrop-filter;
+      transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+      transition-duration: 150ms;
+    }
+    summary:hover {
+      background-color: rgba(243, 244, 246, 1);
+    }
+    summary svg {
+      height: 1.5rem;
+      margin-right: 1rem;
+      width: 1.5rem;
+    }
+    #love {
+      color: rgba(107, 114, 128, 1);
+      font-size: 0.875rem;
+      line-height: 1.25rem;
+      margin-top: 3.5rem;
+      opacity: 0.6;
+      text-align: center;
+    }
+    #love svg {
+      color: rgba(252, 165, 165, 1);
+      width: 1.25rem;
+      height: 1.25rem;
+      display: inline;
+      margin-top: -0.25rem;
+    }
+    @media screen and (min-width: 768px) {
+      #hero {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+      }
+      #hero .logo-container {
+        display: flex;
+      }
+      #middle-content {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 4rem;
+      }
+    }
+          `,
+        }}
+      />
+      <div className="wrapper">
+        <div className="container">
+          <div id="welcome">
+            <h1>
+              <span> Hello there, </span>
+              Welcome {title} 👋
+            </h1>
+          </div>
+
+          <div id="hero" className="rounded">
+            <div className="text-container">
+              <h2>
+                <svg
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth="2"
+                    d="M9 12l2 2 4-4M7.835 4.697a3.42 3.42 0 001.946-.806 3.42 3.42 0 014.438 0 3.42 3.42 0 001.946.806 3.42 3.42 0 013.138 3.138 3.42 3.42 0 00.806 1.946 3.42 3.42 0 010 4.438 3.42 3.42 0 00-.806 1.946 3.42 3.42 0 01-3.138 3.138 3.42 3.42 0 00-1.946.806 3.42 3.42 0 01-4.438 0 3.42 3.42 0 00-1.946-.806 3.42 3.42 0 01-3.138-3.138 3.42 3.42 0 00-.806-1.946 3.42 3.42 0 010-4.438 3.42 3.42 0 00.806-1.946 3.42 3.42 0 013.138-3.138z"
+                  />
+                </svg>
+                <span>You&apos;re up and running</span>
+              </h2>
+              <a href="#commands"> What&apos;s next? </a>
+            </div>
+            <div className="logo-container">
+              <svg
+                fill="currentColor"
+                role="img"
+                viewBox="0 0 24 24"
+                xmlns="http://www.w3.org/2000/svg"
+              >
+                <path d="M11.987 14.138l-3.132 4.923-5.193-8.427-.012 8.822H0V4.544h3.691l5.247 8.833.005-3.998 3.044 4.759zm.601-5.761c.024-.048 0-3.784.008-3.833h-3.65c.002.059-.005 3.776-.003 3.833h3.645zm5.634 4.134a2.061 2.061 0 0 0-1.969 1.336 1.963 1.963 0 0 1 2.343-.739c.396.161.917.422 1.33.283a2.1 2.1 0 0 0-1.704-.88zm3.39 1.061c-.375-.13-.8-.277-1.109-.681-.06-.08-.116-.17-.176-.265a2.143 2.143 0 0 0-.533-.642c-.294-.216-.68-.322-1.18-.322a2.482 2.482 0 0 0-2.294 1.536 2.325 2.325 0 0 1 4.002.388.75.75 0 0 0 .836.334c.493-.105.46.36 1.203.518v-.133c-.003-.446-.246-.55-.75-.733zm2.024 1.266a.723.723 0 0 0 .347-.638c-.01-2.957-2.41-5.487-5.37-5.487a5.364 5.364 0 0 0-4.487 2.418c-.01-.026-1.522-2.39-1.538-2.418H8.943l3.463 5.423-3.379 5.32h3.54l1.54-2.366 1.568 2.366h3.541l-3.21-5.052a.7.7 0 0 1-.084-.32 2.69 2.69 0 0 1 2.69-2.691h.001c1.488 0 1.736.89 2.057 1.308.634.826 1.9.464 1.9 1.541a.707.707 0 0 0 1.066.596zm.35.133c-.173.372-.56.338-.755.639-.176.271.114.412.114.412s.337.156.538-.311c.104-.231.14-.488.103-.74z" />
+              </svg>
+            </div>
+          </div>
+
+          <div id="middle-content">
+            <div id="middle-content-container">
+              <div id="learning-materials" className="rounded shadow">
+                <h2>Learning materials</h2>
+                <a
+                  href="https://nx.dev/getting-started/intro?utm_source=nx-project"
+                  target="_blank"
+                  rel="noreferrer"
+                  className="list-item-link"
+                >
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253"
+                    />
+                  </svg>
+                  <span>
+                    Documentation
+                    <span> Everything is in there </span>
+                  </span>
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M9 5l7 7-7 7"
+                    />
+                  </svg>
+                </a>
+                <a
+                  href="https://nx.dev/blog/?utm_source=nx-project"
+                  target="_blank"
+                  rel="noreferrer"
+                  className="list-item-link"
+                >
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"
+                    />
+                  </svg>
+                  <span>
+                    Blog
+                    <span> Changelog, features & events </span>
+                  </span>
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M9 5l7 7-7 7"
+                    />
+                  </svg>
+                </a>
+                <a
+                  href="https://www.youtube.com/@NxDevtools/videos?utm_source=nx-project&sub_confirmation=1"
+                  target="_blank"
+                  rel="noreferrer"
+                  className="list-item-link"
+                >
+                  <svg
+                    role="img"
+                    viewBox="0 0 24 24"
+                    fill="currentColor"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <title>YouTube</title>
+                    <path d="M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z" />
+                  </svg>
+                  <span>
+                    YouTube channel
+                    <span> Nx Show, talks & tutorials </span>
+                  </span>
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M9 5l7 7-7 7"
+                    />
+                  </svg>
+                </a>
+                <a
+                  href="https://nx.dev/react-tutorial/1-code-generation?utm_source=nx-project"
+                  target="_blank"
+                  rel="noreferrer"
+                  className="list-item-link"
+                >
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M15 15l-2 5L9 9l11 4-5 2zm0 0l5 5M7.188 2.239l.777 2.897M5.136 7.965l-2.898-.777M13.95 4.05l-2.122 2.122m-5.657 5.656l-2.12 2.122"
+                    />
+                  </svg>
+                  <span>
+                    Interactive tutorials
+                    <span> Create an app, step-by-step </span>
+                  </span>
+                  <svg
+                    fill="none"
+                    stroke="currentColor"
+                    viewBox="0 0 24 24"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                      strokeWidth="2"
+                      d="M9 5l7 7-7 7"
+                    />
+                  </svg>
+                </a>
+              </div>
+              <a
+                id="nx-repo"
+                className="button-pill rounded shadow"
+                href="https://github.com/nrwl/nx?utm_source=nx-project"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <svg
+                  fill="currentColor"
+                  role="img"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+                </svg>
+                <span>
+                  Nx is open source
+                  <span> Love Nx? Give us a star! </span>
+                </span>
+              </a>
+            </div>
+            <div id="other-links">
+              <a
+                id="nx-console"
+                className="button-pill rounded shadow"
+                href="https://marketplace.visualstudio.com/items?itemName=nrwl.angular-console&utm_source=nx-project"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <svg
+                  fill="currentColor"
+                  role="img"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <title>Visual Studio Code</title>
+                  <path d="M23.15 2.587L18.21.21a1.494 1.494 0 0 0-1.705.29l-9.46 8.63-4.12-3.128a.999.999 0 0 0-1.276.057L.327 7.261A1 1 0 0 0 .326 8.74L3.899 12 .326 15.26a1 1 0 0 0 .001 1.479L1.65 17.94a.999.999 0 0 0 1.276.057l4.12-3.128 9.46 8.63a1.492 1.492 0 0 0 1.704.29l4.942-2.377A1.5 1.5 0 0 0 24 20.06V3.939a1.5 1.5 0 0 0-.85-1.352zm-5.146 14.861L10.826 12l7.178-5.448v10.896z" />
+                </svg>
+                <span>
+                  Install Nx Console for VSCode
+                  <span>The official VSCode extension for Nx.</span>
+                </span>
+              </a>
+              <a
+                id="nx-console-jetbrains"
+                className="button-pill rounded shadow"
+                href="https://plugins.jetbrains.com/plugin/21060-nx-console"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <svg
+                  height="48"
+                  width="48"
+                  viewBox="20 20 60 60"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path d="m22.5 22.5h60v60h-60z" />
+                  <g fill="#fff">
+                    <path d="m29.03 71.25h22.5v3.75h-22.5z" />
+                    <path d="m28.09 38 1.67-1.58a1.88 1.88 0 0 0 1.47.87c.64 0 1.06-.44 1.06-1.31v-5.98h2.58v6a3.48 3.48 0 0 1 -.87 2.6 3.56 3.56 0 0 1 -2.57.95 3.84 3.84 0 0 1 -3.34-1.55z" />
+                    <path d="m36 30h7.53v2.19h-5v1.44h4.49v2h-4.42v1.49h5v2.21h-7.6z" />
+                    <path d="m47.23 32.29h-2.8v-2.29h8.21v2.27h-2.81v7.1h-2.6z" />
+                    <path d="m29.13 43.08h4.42a3.53 3.53 0 0 1 2.55.83 2.09 2.09 0 0 1 .6 1.53 2.16 2.16 0 0 1 -1.44 2.09 2.27 2.27 0 0 1 1.86 2.29c0 1.61-1.31 2.59-3.55 2.59h-4.44zm5 2.89c0-.52-.42-.8-1.18-.8h-1.29v1.64h1.24c.79 0 1.25-.26 1.25-.81zm-.9 2.66h-1.57v1.73h1.62c.8 0 1.24-.31 1.24-.86 0-.5-.4-.87-1.27-.87z" />
+                    <path d="m38 43.08h4.1a4.19 4.19 0 0 1 3 1 2.93 2.93 0 0 1 .9 2.19 3 3 0 0 1 -1.93 2.89l2.24 3.27h-3l-1.88-2.84h-.87v2.84h-2.56zm4 4.5c.87 0 1.39-.43 1.39-1.11 0-.75-.54-1.12-1.4-1.12h-1.44v2.26z" />
+                    <path d="m49.59 43h2.5l4 9.44h-2.79l-.67-1.69h-3.63l-.67 1.69h-2.71zm2.27 5.73-1-2.65-1.06 2.65z" />
+                    <path d="m56.46 43.05h2.6v9.37h-2.6z" />
+                    <path d="m60.06 43.05h2.42l3.37 5v-5h2.57v9.37h-2.26l-3.53-5.14v5.14h-2.57z" />
+                    <path d="m68.86 51 1.45-1.73a4.84 4.84 0 0 0 3 1.13c.71 0 1.08-.24 1.08-.65 0-.4-.31-.6-1.59-.91-2-.46-3.53-1-3.53-2.93 0-1.74 1.37-3 3.62-3a5.89 5.89 0 0 1 3.86 1.25l-1.26 1.84a4.63 4.63 0 0 0 -2.62-.92c-.63 0-.94.25-.94.6 0 .42.32.61 1.63.91 2.14.46 3.44 1.16 3.44 2.91 0 1.91-1.51 3-3.79 3a6.58 6.58 0 0 1 -4.35-1.5z" />
+                  </g>
+                </svg>
+                <span>
+                  Install Nx Console for JetBrains
+                  <span>
+                    Available for WebStorm, Intellij IDEA Ultimate and more!
+                  </span>
+                </span>
+              </a>
+              <div id="nx-cloud" className="rounded shadow">
+                <div>
+                  <svg
+                    id="nx-cloud-logo"
+                    role="img"
+                    xmlns="http://www.w3.org/2000/svg"
+                    stroke="currentColor"
+                    fill="transparent"
+                    viewBox="0 0 24 24"
+                  >
+                    <path
+                      strokeWidth="2"
+                      d="M23 3.75V6.5c-3.036 0-5.5 2.464-5.5 5.5s-2.464 5.5-5.5 5.5-5.5 2.464-5.5 5.5H3.75C2.232 23 1 21.768 1 20.25V3.75C1 2.232 2.232 1 3.75 1h16.5C21.768 1 23 2.232 23 3.75Z"
+                    />
+                    <path
+                      strokeWidth="2"
+                      d="M23 6v14.1667C23 21.7307 21.7307 23 20.1667 23H6c0-3.128 2.53867-5.6667 5.6667-5.6667 3.128 0 5.6666-2.5386 5.6666-5.6666C17.3333 8.53867 19.872 6 23 6Z"
+                    />
+                  </svg>
+                  <h2>
+                    Nx Cloud
+                    <span>Enable faster CI & better DX</span>
+                  </h2>
+                </div>
+                <p>
+                  You can activate distributed tasks executions and caching by
+                  running:
+                </p>
+                <pre>nx connect</pre>
+                <a
+                  href="https://nx.dev/nx-cloud?utm_source=nx-project"
+                  target="_blank"
+                  rel="noreferrer"
+                >
+                  {' '}
+                  What is Nx Cloud?{' '}
+                </a>
+              </div>
+            </div>
+          </div>
+
+          <div id="commands" className="rounded shadow">
+            <h2>Next steps</h2>
+            <p>Here are some things you can do with Nx:</p>
+            <details>
+              <summary>
+                <svg
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth="2"
+                    d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                  />
+                </svg>
+                Build, test and lint your app
+                </summary>
+                <pre>
+                 <span># Build</span>
+                  nx build {title}
+                  <span># Test</span>
+                  nx test {title}
+                  <span># Lint</span>
+                  nx lint {title}
+                  <span># Run them together!</span>
+                  nx run-many -p {title} -t build test lint
+                
+                </pre>
+                </details>
+
+            <details>
+              <summary>
+                <svg
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth="2"
+                    d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                  />
+                </svg>
+                View project details
+              </summary>
+              <pre>nx show project {title}</pre>
+            </details>
+            <details>
+              <summary>
+                <svg
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth="2"
+                    d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                  />
+                </svg>
+                View interactive project graph
+              </summary>
+              <pre>nx graph</pre>
+            </details>
+            <details>
+              <summary>
+                <svg
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth="2"
+                    d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                  />
+                </svg>
+                Add UI library
+              </summary>
+              <pre>
+                <span># Generate UI lib</span>
+                nx g @nx/react:lib ui
+                <span># Add a component</span>
+                nx g @nx/react:component ui/src/lib/button
+              </pre>
+            </details>
+          </div>
+
+          <p id="love">
+            Carefully crafted with
+            <svg
+              fill="currentColor"
+              stroke="none"
+              viewBox="0 0 24 24"
+              xmlns="http://www.w3.org/2000/svg"
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                strokeWidth="2"
+                d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z"
+              />
+            </svg>
+          </p>
+        </div>
+      </div>
+    </>
+  );
+}
+
+export default NxWelcome;