Submit a Task
- Duale AI
- Documentation
- Agent harness
- Task limits
Public Preview
Task limits: submission, deadlines, and continuations
This reference lists Duale AI Task limits for submission, deadlines, continuations, and code execution, with the outcome at each limit and the next action.
This page lists the limits for submitting, planning, receiving, continuing, stopping, and running code in Duale AI Tasks.
- Task submission limits for instructions, IDs, and request size.
- Deadline planning for Task lifetime, work cutoff, and answer timing.
- Outcome limits for free-text answers and result retention.
- Continuation and recall limits for parent age and chain depth.
- Code execution limits for run time, machine size, and disk space.
Summaries were generated by AI.
Plan each Task against these limits: each row states what happens at the limit and what to do next.
Submit a Task
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Instruction | 1 to 100,000 characters, without NUL characters | The SDK or Duale AI refuses the request, and no Task starts. | Put long material in attachments. |
| Task ID | 10 to 128 ASCII letters, digits, _, or - | Duale AI refuses the request with 422, and no Task starts. | Let the SDK generate the Task ID. |
| Task ID reuse | 30 days from the first submission | Within 30 days, a request with the same Task ID from the same Agent Identity starts nothing new and streams the first Task, even with a different instruction. After 30 days, the same Task ID can start a new Task, which Duale AI charges. | Reuse a Task ID only to retry the same request. |
| Response-format description | 500 characters | The SDK or Duale AI refuses the request, and no Task starts. | Shorten the description. |
| Request size | 4 MiB for one Task submission or continuation | Duale AI refuses the request with 413 REQUEST_BODY_TOO_LARGE, and no Task starts. | Shorten the JSON Schema of the response format. |
| Size of one model turn | A fixed size for the Task history, the Tool definitions, and the Tool Results of one turn. A larger context window does not raise it. | Before the Task starts, Duale AI refuses it with LLM_CONFIG_CONTEXT_TOO_SMALL and does not charge it. Later, the Task fails with that code. | Return smaller Tool Results, shorten Tool definitions, or start a new Task instead of a continuation. |
- Limit
- Instruction
- Value
- 1 to 100,000 characters, without NUL characters
- What happens
- The SDK or Duale AI refuses the request, and no Task starts.
- Your action
- Put long material in attachments.
- Limit
- Task ID
- Value
- 10 to 128 ASCII letters, digits,
_, or- - What happens
- Duale AI refuses the request with
422, and no Task starts. - Your action
- Let the SDK generate the Task ID.
- Limit
- Task ID reuse
- Value
- 30 days from the first submission
- What happens
- Within 30 days, a request with the same Task ID from the same Agent Identity starts nothing new and streams the first Task, even with a different instruction. After 30 days, the same Task ID can start a new Task, which Duale AI charges.
- Your action
- Reuse a Task ID only to retry the same request.
- Limit
- Response-format description
- Value
- 500 characters
- What happens
- The SDK or Duale AI refuses the request, and no Task starts.
- Your action
- Shorten the description.
- Limit
- Request size
- Value
- 4 MiB for one Task submission or continuation
- What happens
- Duale AI refuses the request with
413REQUEST_BODY_TOO_LARGE, and no Task starts. - Your action
- Shorten the JSON Schema of the response format.
- Limit
- Size of one model turn
- Value
- A fixed size for the Task history, the Tool definitions, and the Tool Results of one turn. A larger context window does not raise it.
- What happens
- Before the Task starts, Duale AI refuses it with
LLM_CONFIG_CONTEXT_TOO_SMALLand does not charge it. Later, the Task fails with that code. - Your action
- Return smaller Tool Results, shorten Tool definitions, or start a new Task instead of a continuation.
Plan around the deadline
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Task lifetime | 30 days from submission, whatever the deadline | Duale AI shortens a later deadline to this limit, with no error, and the Task ends by then. | Split longer work into continuations. Each has its own lifetime. |
| Default deadline | 30 minutes from submission, when ask() or next() gets no deadline | The Task ends near that time. | Pass a deadline that fits the work. |
| Work cutoff | 5 minutes before the deadline. With a deadline less than 10 minutes away: 5 minutes after submission, or at the deadline when that comes first. | The Task starts no new model turn, delegated work, or Tool Call, and writes its answer. A Tool Call still running at this point times out, even when its own time limit is longer. | Set the deadline 5 minutes later than the time the work needs. |
| Answer after the deadline | Up to 5 minutes after the deadline | The Task’s result can arrive in this time. If no answer is ready by then, the Task fails with TASK_DEADLINE_EXCEEDED. | Keep waiting for the result for 5 minutes after the deadline. |
- Limit
- Task lifetime
- Value
- 30 days from submission, whatever the deadline
- What happens
- Duale AI shortens a later deadline to this limit, with no error, and the Task ends by then.
- Your action
- Split longer work into continuations. Each has its own lifetime.
- Limit
- Default deadline
- Value
- 30 minutes from submission, when
ask()ornext()gets nodeadline - What happens
- The Task ends near that time.
- Your action
- Pass a
deadlinethat fits the work.
- Limit
- Work cutoff
- Value
- 5 minutes before the deadline. With a deadline less than 10 minutes away: 5 minutes after submission, or at the deadline when that comes first.
- What happens
- The Task starts no new model turn, delegated work, or Tool Call, and writes its answer. A Tool Call still running at this point times out, even when its own time limit is longer.
- Your action
- Set the deadline 5 minutes later than the time the work needs.
- Limit
- Answer after the deadline
- Value
- Up to 5 minutes after the deadline
- What happens
- The Task’s result can arrive in this time. If no answer is ready by then, the Task fails with
TASK_DEADLINE_EXCEEDED. - Your action
- Keep waiting for the result for 5 minutes after the deadline.
Receive and keep the outcome
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Free-text answer | 100,000 bytes of UTF-8 text, for an answer without a JSON Schema response format | Duale AI does not accept a longer answer. When the Task cannot write a shorter one, it fails with RESULT_UNAVAILABLE. | Ask for a shorter answer, or split the work across continuations that each answer one part. |
| Reading a Task again | A limited time after submission | After that time, a request with the Task ID cannot return the Task’s events or its result. | Save the result when it arrives. |
- Limit
- Free-text answer
- Value
- 100,000 bytes of UTF-8 text, for an answer without a JSON Schema response format
- What happens
- Duale AI does not accept a longer answer. When the Task cannot write a shorter one, it fails with
RESULT_UNAVAILABLE. - Your action
- Ask for a shorter answer, or split the work across continuations that each answer one part.
- Limit
- Reading a Task again
- Value
- A limited time after submission
- What happens
- After that time, a request with the Task ID cannot return the Task’s events or its result.
- Your action
- Save the result when it arrives.
Continue a Task or recall earlier work
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Continuation Task ID | Differs from the parent’s Task ID | Duale AI refuses the request with 422, and no Task starts. | Let the SDK generate the Task ID. |
| Parent age | 30 days from the parent’s submission | The continuation fails with PARENT_TASK_NOT_FOUND or PARENT_TASK_UNAVAILABLE. | Start a new Task. |
| Inherited history | 30 days from the request that supplied each part, including the first Task’s instruction | The continuation uses only the history that remains, with no error. | Restate lasting rules in the continuation’s own instruction. |
| Continuation chain | 90 days from the chain’s first Task | A later continuation fails with CONTINUATION_UNAVAILABLE. | Start a new Task. |
| Wait for a running parent | Up to the continuation’s own deadline | The continuation waits until the parent has work to inherit, and can start several minutes after that. If the parent has none in time, the continuation fails with PARENT_TASK_UNAVAILABLE. | Give the continuation a deadline that leaves time to wait, or continue the parent after it ends. |
| Recall reach | Earlier Tasks of the same Agent Identity, for a limited period after they ran | Recall does not find older Tasks. A Task that just ended can also be missing for a short time. | To build on one earlier Task, continue it. |
- Limit
- Continuation Task ID
- Value
- Differs from the parent’s Task ID
- What happens
- Duale AI refuses the request with
422, and no Task starts. - Your action
- Let the SDK generate the Task ID.
- Limit
- Parent age
- Value
- 30 days from the parent’s submission
- What happens
- The continuation fails with
PARENT_TASK_NOT_FOUNDorPARENT_TASK_UNAVAILABLE. - Your action
- Start a new Task.
- Limit
- Inherited history
- Value
- 30 days from the request that supplied each part, including the first Task’s instruction
- What happens
- The continuation uses only the history that remains, with no error.
- Your action
- Restate lasting rules in the continuation’s own instruction.
- Limit
- Continuation chain
- Value
- 90 days from the chain’s first Task
- What happens
- A later continuation fails with
CONTINUATION_UNAVAILABLE. - Your action
- Start a new Task.
- Limit
- Wait for a running parent
- Value
- Up to the continuation’s own deadline
- What happens
- The continuation waits until the parent has work to inherit, and can start several minutes after that. If the parent has none in time, the continuation fails with
PARENT_TASK_UNAVAILABLE. - Your action
- Give the continuation a deadline that leaves time to wait, or continue the parent after it ends.
- Limit
- Recall reach
- Value
- Earlier Tasks of the same Agent Identity, for a limited period after they ran
- What happens
- Recall does not find older Tasks. A Task that just ended can also be missing for a short time.
- Your action
- To build on one earlier Task, continue it.
SDK errors gives the next action for each code.
Stop a Task
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Stop reason | 1 to 500 characters, not only spaces, without NUL characters | The SDK or Duale AI refuses the Stop request, and the Task keeps running. | Shorten the reason. |
| Size of the Task’s work | A fixed bound on the model turns and Tool Calls of the whole Task, including its delegated work | Duale AI accepts the Stop with 202, then drops it with no error, event, or result. The Task keeps running, and a repeated Stop fails the same way. | Set a deadline that bounds the work, and check the Task’s result after each Stop. |
- Limit
- Stop reason
- Value
- 1 to 500 characters, not only spaces, without NUL characters
- What happens
- The SDK or Duale AI refuses the Stop request, and the Task keeps running.
- Your action
- Shorten the reason.
- Limit
- Size of the Task’s work
- Value
- A fixed bound on the model turns and Tool Calls of the whole Task, including its delegated work
- What happens
- Duale AI accepts the Stop with
202, then drops it with no error, event, or result. The Task keeps running, and a repeated Stop fails the same way. - Your action
- Set a deadline that bounds the work, and check the Task’s result after each Stop.
Run code
| Limit | Value | What happens | Your action |
|---|---|---|---|
| Run time | 5 minutes for each run, including any wait while another run or document copy of the Task uses the machine | A run still running shortly before then stops and shows Outcome unknown, and the machine keeps none of the run’s changes. | For longer work, publish an SDK Tool that does it. |
| Machine size | 1 vCPU and 512 MiB of memory | A run stops when its code runs out of memory, with the same outcome as at the end of the run time. | For larger work, publish an SDK Tool that does it. |
| Disk space | 512 MiB on each machine | Code on the machine cannot write more. A document copy holds only the extracted text when the original does not fit, and Duale AI refuses to copy a document whose text does not fit. | For larger data, publish an SDK Tool that works on it. |
| Printed output | A fixed amount for each run | Output past that amount does not reach the model. When one piece of code prints past it, that code can fail without returning any output, and the run stops there. | Ask the Task to print compact results, such as totals or only the rows it needs. |
| Machine lifetime | 30 days after the machine’s last use | Duale AI erases the machine and its files. A continuation that runs code later starts without them. | Ask for the data you need in the Task’s answer, and keep it in your own system. |
- Limit
- Run time
- Value
- 5 minutes for each run, including any wait while another run or document copy of the Task uses the machine
- What happens
- A run still running shortly before then stops and shows Outcome unknown, and the machine keeps none of the run’s changes.
- Your action
- For longer work, publish an SDK Tool that does it.
- Limit
- Machine size
- Value
- 1 vCPU and 512 MiB of memory
- What happens
- A run stops when its code runs out of memory, with the same outcome as at the end of the run time.
- Your action
- For larger work, publish an SDK Tool that does it.
- Limit
- Disk space
- Value
- 512 MiB on each machine
- What happens
- Code on the machine cannot write more. A document copy holds only the extracted text when the original does not fit, and Duale AI refuses to copy a document whose text does not fit.
- Your action
- For larger data, publish an SDK Tool that works on it.
- Limit
- Printed output
- Value
- A fixed amount for each run
- What happens
- Output past that amount does not reach the model. When one piece of code prints past it, that code can fail without returning any output, and the run stops there.
- Your action
- Ask the Task to print compact results, such as totals or only the rows it needs.
- Limit
- Machine lifetime
- Value
- 30 days after the machine’s last use
- What happens
- Duale AI erases the machine and its files. A continuation that runs code later starts without them.
- Your action
- Ask for the data you need in the Task’s answer, and keep it in your own system.