# `OzMcp.Structs.CreateTaskResult`
[🔗](https://github.com/oz-elixir/oz_mcp/blob/v0.9.0/lib/oz_mcp/structs/create_task_result.ex#L1)

Helper module used to build `CreateTaskResult` structure.

_(MCP protocol: 2025-11-25)_

## Short example:

```elixir
%CreateTaskResult{}
  |> CreateTaskResult.task(
    %Task{}
    |> Task.task_id("task-123")
    |> Task.status(:working)
    |> Task.created_at("2025-01-12T15:00:58Z")
    |> Task.last_updated_at("2025-01-12T15:01:12Z")
    |> Task.ttl(60_000)
  )
  |> CreateTaskResult.build()
```

Result:

```elixir
%{
  task: %{
    status: "working",
    ttl: 60000,
    taskId: "task-123",
    createdAt: "2025-01-12T15:00:58Z",
    lastUpdatedAt: "2025-01-12T15:01:12Z"
  }
}
```

## Long example:

```elixir
%CreateTaskResult{}
  |> CreateTaskResult.task(
    %Task{}
    |> Task.task_id("task-123")
    |> Task.status(:working)
    |> Task.created_at("2025-01-12T15:00:58Z")
    |> Task.last_updated_at("2025-01-12T15:01:12Z")
    |> Task.ttl(60_000)
  )
  |> CreateTaskResult._meta(%{"key" => "value"})
  |> CreateTaskResult.extras(%{"queuePosition" => 3, "estimatedWaitMs" => 1500})
  |> CreateTaskResult.build()
```

Result:

```elixir
%{
  :task => %{
    status: "working",
    ttl: 60000,
    taskId: "task-123",
    createdAt: "2025-01-12T15:00:58Z",
    lastUpdatedAt: "2025-01-12T15:01:12Z"
  },
  :_meta => %{"key" => "value"},
  "estimatedWaitMs" => 1500,
  "queuePosition" => 3
}
```

Specification: [CreateTaskResult](https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks)

## Fields

| Field | Setter | Type | Required |
|---|---|---|---|
| `task` | `task/2` | `t:OzMcp.Structs.Task.t/0` | yes |
| `_meta` | `_meta/2` | map | no |
| `extras` | `extras/2` | map | no |

# `t`

```elixir
@type t() :: %OzMcp.Structs.CreateTaskResult{
  _meta: map() | nil,
  extras: map() | nil,
  task: OzMcp.Structs.Task.t()
}
```

# `build`

```elixir
@spec build(t()) :: map()
```

# `extras`

```elixir
@spec extras(t(), map() | nil) :: t()
```

# `task`

```elixir
@spec task(t(), OzMcp.Structs.Task.t()) :: t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
