ballerina/workflow.internal Ballerina library

Registers a durable agent's runner workflow with the program runtime, marking the workflow type as an agent workflow so the adapter injects the native agent context handle (instead of a workflow:Context) and arms the agent update handler.

This is an internal function: registerDurableAgentRunner routes through it for object-model agents, and the module's own unit tests use it to register loop-test agents directly (the compiler plugin does not run on the workflow package itself).

Registers a module-level final client object so that it can be passed as an argument to activity functions whose parameter type is a client object.

This is an internal function used by the compiler plugin. It is emitted by the source modifier for every module-level final variable whose type is a client object and is invoked during module initialization, before startWorkflowRuntime.

When an activity is called with such a client as one of its arguments, the native runtime substitutes the value with the marker string "connection:<name>" for transport, then resolves it back to the registered client on the activity worker side using the same name.

Registers an activity capability declaration of a durable agent.

Registers a durable agent declaration: identity, model, system prompt, and reasoning limit. Must be called before the capability registrations below.

Registers an event channel declaration of a durable agent.

Registers a human task capability declaration of a durable agent.

Registers a peer-agent declaration of an object-model durable agent: the peer is advertised to the agent's model as a delegable tool and runs as a true Temporal child workflow of the agent.

Registers the shared object-model runner as an agent's workflow: the agent gets its own workflow type (workflow-<agentName>) whose activities are the agent's declared activity functions plus the built-in agent activities. The runner and the built-ins are captured natively at workflow-module init, so callers pass only the agent name — no runner machinery leaks into any public API.

Registers an AI tool of an object-model durable agent: stored on the declaration (so the runner can advertise it to the model) and published to the agent tool registry (so the built-in executeAgentTool activity can resolve it).

Registers a human task type so that the workflow worker can route child workflows whose type equals taskName to the built-in human task handler.

This is an internal function intended to be called by the compiler plugin at module initialization time for every awaitHumanTask call site found in user code, similar to how registerWorkflow is generated for @Workflow functions.

Registers a workflow function with the program runtime.

This is an internal function used by the compiler plugin to register workflows at module initialization time. It is not intended to be called directly by users.

Starts the workflow runtime after all workflows have been registered.

This is an internal function used by the compiler plugin as the last generated module-level statement, ensuring that polling only begins after every registerWorkflow call has executed.