feat(tdl): Add end-to-end TDL package execution flow (resolves #302):

Cargo.toml

@@ -4,6 +4,10 @@ members = [
   "components/spider-core",
   "components/spider-derive",
   "components/spider-storage",
+  "components/spider-task-executor",
   "components/spider-tdl",
   "components/spider-tdl-derive",
+  "examples/huntsman/complex/tasks",
+  "examples/huntsman/complex/types",
+  "tests/huntsman/tdl-integration",
 ]

components/spider-task-executor/Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "spider-task-executor"
+version = "0.1.0"
+edition = "2024"
+
+[lib]
+name = "spider_task_executor"
+path = "src/lib.rs"
+
+[dependencies]
+libloading = "0.8.5"
+rmp-serde = "1.3.1"
+spider-tdl = { path = "../spider-tdl" }
+thiserror = "2.0.18"
+
+[dev-dependencies]
+anyhow = "1.0.98"

components/spider-task-executor/src/error.rs

@@ -0,0 +1,66 @@
+//! Errors produced while loading TDL packages or executing tasks across the FFI boundary.
+
+use spider_tdl::{TdlError, Version};
+
+/// All possible errors produced by the task executor.
+///
+/// [`TdlError`] (failure inside a user task) is wrapped via [`Self::TaskError`] so callers can
+/// distinguish executor-internal failures from in-task failures.
+#[derive(Debug, thiserror::Error)]
+pub enum ExecutorError {
+    /// `dlopen` failed or a required FFI symbol was missing.
+    #[error("failed to load TDL package library: {0}")]
+    InvalidLibrary(#[from] libloading::Error),
+
+    /// The package's declared `spider-tdl` ABI version is not compatible with the executor's.
+    #[error(
+        "incompatible spider-tdl version: \
+         package={package_major}.{package_minor}.{package_patch}, \
+         executor={executor_major}.{executor_minor}.{executor_patch}"
+    )]
+    IncompatibleVersion {
+        package_major: u32,
+        package_minor: u32,
+        package_patch: u32,
+        executor_major: u32,
+        executor_minor: u32,
+        executor_patch: u32,
+    },
+
+    /// Two packages with the same `package_name` were registered with the same manager.
+    #[error("duplicate package name: {0}")]
+    DuplicatePackage(String),
+
+    /// The byte buffer contains invalid UTF-8 patterns.
+    #[error("invalid UTF-8: {0}")]
+    InvalidUtf8(#[from] std::str::Utf8Error),
+
+    /// A user task returned a [`TdlError`] across the FFI boundary.
+    #[error("task execution failed: {0}")]
+    TaskError(#[from] TdlError),
+
+    /// The msgpack-encoded error payload returned by a failing task could not be decoded back into
+    /// a [`TdlError`].
+    #[error("failed to deserialize error payload: {0}")]
+    ErrorPayloadDeserializationFailure(#[from] rmp_serde::decode::Error),
+}
+
+impl ExecutorError {
+    /// Constructs an [`ExecutorError::IncompatibleVersion`] from the package and executor
+    /// [`Version`] values.
+    ///
+    /// # Returns
+    ///
+    /// The constructed error variant.
+    #[must_use]
+    pub const fn incompatible_version(package: Version, executor: Version) -> Self {
+        Self::IncompatibleVersion {
+            package_major: package.major,
+            package_minor: package.minor,
+            package_patch: package.patch,
+            executor_major: executor.major,
+            executor_minor: executor.minor,
+            executor_patch: executor.patch,
+        }
+    }
+}

components/spider-task-executor/src/lib.rs

@@ -0,0 +1,7 @@
+//! Spider task executor for executing tasks from TDL packages.
+
+pub mod error;
+pub mod manager;
+
+pub use error::ExecutorError;
+pub use manager::{TdlPackage, TdlPackageManager};