Temporal

Temporal é uma plataforma open-source de execução durável que permite às equipes escrever workflows como código capazes de sobreviver a falhas, retries e interrupções. Um cluster Temporal rastreia o estado e o histórico de eventos de cada execução de workflow, para que processos de negócio de longa duração — fulfillment de pedidos, pipelines de pagamento, provisionamento de infraestrutura, aprovações human-in-the-loop — rodem de forma confiável por minutos ou meses.

Com a integração do Temporal no Zoen, seus agentes podem conduzir esses workflows duráveis diretamente. Conecte-se a qualquer cluster Temporal que exponha a HTTP API do servidor (habilitada por padrão na porta HTTP do frontend, 7243, em servidores Temporal modernos) e:

• Executar workflows: inicie execuções com input JSON, use signal-with-start para entrega exactly-once e defina políticas de reuso de ID, cron schedules, timeouts, campos de memo e search attributes.
• Comunicar-se com workflows em execução: envie signals, invoque update handlers e aguarde seus resultados, e execute queries contra o estado ao vivo do workflow.
• Observar execuções: descreva uma execução (status, timing, atividades pendentes), liste e conte execuções com a linguagem de consulta de visibility do Temporal e obtenha históricos completos de eventos — inclusive só o close event para ler o resultado de um workflow.
• Operar a frota: cancele ou encerre execuções descontroladas, redefina um workflow para um ponto anterior no histórico e gerencie schedules — liste, descreva, pause, retome, dispare e exclua-os.

Inputs e resultados de workflows são codificados com o payload converter padrão json/plain do Temporal, então a integração interopera com workers escritos em qualquer Temporal SDK. Se o servidor tiver autenticação habilitada, forneça uma API key e o Zoen a envia como Bearer token em cada requisição.

Usage Instructions

Connect to a Temporal cluster over the server's HTTP API to start workflow executions, send signals, run queries against workflow state, describe and list executions, fetch event histories, and cancel or terminate running workflows. API key only required for servers with authentication enabled.

Actions

temporal_start_workflow

Start a new workflow execution on a Temporal cluster.

Input

Output

temporal_signal_workflow

Send a signal to a running Temporal workflow execution.

Input

Output

temporal_signal_with_start

Atomically signal a Temporal workflow, starting it first if it is not already running, so the signal is never lost.

Input

Output

temporal_query_workflow

Run a synchronous query against the state of a Temporal workflow execution and return the result.

Input

Output

temporal_update_workflow

Invoke an update handler on a running Temporal workflow and wait for its result. Unlike a signal, an update is validated by the workflow and returns a response.

Input

Output

temporal_describe_workflow

Get the current state of a Temporal workflow execution, including status, timing, memo, search attributes, and pending activities.

Input

Output

temporal_list_workflows

List workflow executions in a Temporal namespace, optionally filtered with a visibility query.

Input

Output

temporal_count_workflows

Count workflow executions in a Temporal namespace matching a visibility query, with optional GROUP BY aggregation.

Input

Output

temporal_get_workflow_history

Fetch the event history of a Temporal workflow execution, optionally filtered to just the close event.

Input

Output

temporal_cancel_workflow

Request cooperative cancellation of a running Temporal workflow execution. The workflow decides how to respond to the request.

Input

Output

temporal_terminate_workflow

Forcefully terminate a Temporal workflow execution immediately, without giving the workflow a chance to react.

Input

Output

temporal_reset_workflow

Reset a Temporal workflow execution to a past workflow task, terminating the current run and replaying from the reset point in a new run.

Input

Output

temporal_describe_task_queue

List the workers currently polling a Temporal task queue, to check whether a workflow or activity has live workers.

Input

Output

temporal_create_schedule

Create a Temporal schedule that starts a workflow on a cron or interval cadence.

Input

Output

temporal_list_schedules

List schedules in a Temporal namespace.

Input

Output

temporal_describe_schedule

Get the configuration and current state of a Temporal schedule, including its spec, recent actions, and upcoming run times.

Input

Output

temporal_pause_schedule

Pause a Temporal schedule so it stops taking actions until unpaused.

Input

Output

temporal_unpause_schedule

Unpause a Temporal schedule so it resumes taking actions.

Input

Output

temporal_trigger_schedule

Trigger an immediate action of a Temporal schedule, outside its normal spec.

Input

Output

temporal_delete_schedule

Delete a Temporal schedule. Workflows already started by the schedule keep running.

Input

Output