use serde::Deserialize;
use serde_json::{json, Value};
use crate::codes::Code;
use crate::error::{Error, Fault};
use crate::host;
#[derive(Clone, Debug, Deserialize, PartialEq, Eq)]
pub struct Task {
pub id: String,
pub revision: u64,
pub status: String,
}
#[derive(Clone, Debug, Deserialize, PartialEq, Eq)]
pub struct CreateResult {
pub task: Task,
}
pub fn create(task_type_id: &str, title: &str, input: Value) -> Result<CreateResult, Error> {
if task_type_id.trim().is_empty() {
return Err(Error::invalid(
"task_type_id is required for task creation.",
));
}
if title.trim().is_empty() {
return Err(Error::invalid("title is required for task creation."));
}
if !input.is_object() {
return Err(Error::invalid("input must be an object for task creation."));
}
let data = host::transport()?.call(
"action:tasks/create".to_string(),
json!({
"task_type_id": task_type_id,
"title": title,
"input": input,
}),
)?;
serde_json::from_value(data).map_err(|cause| {
Error::Host(Fault::new(
Code::unspecified(),
format!("Task creation returned an unreadable response: {cause}"),
))
})
}
#[cfg(test)]
mod tests {
use serde_json::json;
use super::{create, CreateResult, Task};
use crate::{testing, Error};
#[test]
fn creates_a_task_and_returns_the_platform_task() {
let session = testing::install(|name, params| {
assert_eq!(name, "action:tasks/create");
assert_eq!(
params,
json!({
"task_type_id": "TTY000003",
"title": "Review the invoice",
"input": { "invoice_id": "INV000017" },
})
);
Ok(json!({ "task": { "id": "TASK000042", "revision": 0, "status": "queued" } }))
});
let result = create(
"TTY000003",
"Review the invoice",
json!({ "invoice_id": "INV000017" }),
)
.unwrap();
assert_eq!(
result,
CreateResult {
task: Task {
id: "TASK000042".to_string(),
revision: 0,
status: "queued".to_string(),
},
}
);
assert_eq!(session.calls().len(), 1);
assert_eq!(session.calls()[0].name, "action:tasks/create");
assert_eq!(
session.calls()[0].params,
json!({
"task_type_id": "TTY000003",
"title": "Review the invoice",
"input": { "invoice_id": "INV000017" },
})
);
assert_eq!(
session.calls()[0]
.params
.as_object()
.unwrap()
.keys()
.cloned()
.collect::<Vec<_>>(),
["input", "task_type_id", "title"]
);
}
#[test]
fn an_empty_task_type_id_is_refused_before_anything_is_sent() {
let session = testing::install(|_name, _params| Ok(json!({ "task": {} })));
let error = create(" ", "Review", json!({})).unwrap_err();
assert_eq!(error.code().as_str(), "INVALID_TOOL_INPUT");
assert!(session.calls().is_empty());
}
#[test]
fn an_empty_title_is_refused_before_anything_is_sent() {
let session = testing::install(|_name, _params| Ok(json!({ "task": {} })));
let error = create("TTY000003", "", json!({})).unwrap_err();
assert_eq!(error.code().as_str(), "INVALID_TOOL_INPUT");
assert!(session.calls().is_empty());
}
#[test]
fn a_non_object_input_is_refused_before_anything_is_sent() {
let session = testing::install(|_name, _params| Ok(json!({ "task": {} })));
let error = create("TTY000003", "Review", json!([])).unwrap_err();
assert_eq!(error.code().as_str(), "INVALID_TOOL_INPUT");
assert!(session.calls().is_empty());
}
#[test]
fn a_task_service_refusal_preserves_the_host_message() {
let _session =
testing::install(|_name, _params| Err(Error::failed("TASK_INPUT_INVALID: /title")));
let error = create("TTY000003", "Review", json!({})).unwrap_err();
assert!(matches!(error, Error::Host(_)));
assert_eq!(
error.message(),
"action:tasks/create failed: TASK_INPUT_INVALID: /title"
);
}
}