Skip to main content

Module tasks

Module tasks 

Source
Expand description

Skill authoring and the shared task runtime.

Re-exports§

pub use crate::spec::SkillSpec;
pub use crate::spec::SkillToolSpec;
pub use crate::spec::TaskExpectation;
pub use crate::spec::TaskObservationKind;
pub use crate::spec::TaskScenario;
pub use crate::spec::TaskStep;
pub use crate::spec::TaskTraceSnapshot;

Structs§

AcceptedTaskEffect
A service effect accepted by the reducer, retaining its original owner.
CompiledSkill
Executable capability definition. Trusted closures must not capture unrelated mutable state.
InvocationCompletion
A worker result carrying the original owner and private state. Fields are private so applications cannot manufacture accepted state writes.
OperationId
A session-local invocation and approval identity.
OperationSnapshot
An operation receipt or immutable approval proposal.
OwnedInvocation
The only executable ticket produced by task admission or trusted approval. Its state and tool closures belong to this invocation, never another task.
OwnedTaskServiceWork
Runtime-scoped service work. The private ticket cannot grant another task writes.
Skill
Small fluent authoring surface over the serializable skill definition.
SkillKey
The installed definition pinned by an activation.
SkillSummary
Discoverable installed skill metadata.
TaskDelivery
A tool completion’s publication decision.
TaskError
Configuration, admission or lifecycle error.
TaskId
A session-local activation identity.
TaskOwner
Identity carried through contextual tool execution.
TaskPattern
A task-local temporal detector and its declarative actions.
TaskRuntime
Task lifecycle reducer. Drive it from one control lane or a deterministic replay. At most one invocation is pending per activation; different tasks may execute concurrently. All commands finish synchronously, including approval requests.
TaskServiceCompletion
Private completion of a runtime-prepared service job.
TaskServices
Fresh per-activation services. Workers never receive session transport.
TaskSessionSnapshot
Complete observable task session. This is not a durable restore checkpoint.
TaskSnapshot
One activation’s observable progress. Raw state is deliberately excluded.
TaskTool
One declared operation. Names are local to a skill.
TaskWatcher
A state predicate and its declarative task-local actions.

Enums§

OperationStatus
Operation lifecycle, including uncertainty after an interrupted commit.
ReconciledOutcome
An externally verified commit result, not an inference from cancellation.
TaskCommand
Trusted application/UI command. Models must never receive Decide or Reconcile.
TaskEffect
An effect requested by task-local declarative services.
TaskObservation
An observation whose task/revision was captured before routing or async work.
TaskStatus
Task lifecycle, separate from the lifecycle of its external operations.
TaskToolEffect
Effects determine admission, approval, cancellation and reconciliation.

Constants§

MAX_SKILL_NAME
The longest skill name: its entry point, start_{skill}, must fit the Live API’s 64-character function names.

Traits§

TaskMemoryService
Memory operations bound to a trusted session subject and declared task slots. Ingestion and remember are accepted effects. Cancellation after execution starts cannot undo storage; returned slot projections still require current ownership. Each result is a complete projection: omitted or null slots remove a previous memory-owned value, while explicit inputs and accepted local changes remain.

Functions§

validate_skill_identity
Validate identity shared by compiled catalogs and authoring documents.

Type Aliases§

FlowFactory
Builds fresh governance for each activation.
OutputProjector
Projects declared outputs from accepted task state.
ReceiptApplier
Reconstructs declared state effects from a verified external receipt without executing a tool.
TaskEffects
Declarative effects rendered against accepted task state.
TaskServicesFactory
Builds fresh service registries, counters and resource bindings for an activation.
TaskToolFactory
Binds all captured state in tools to an isolated invocation state.
ValueValidator
Input/output validation supplied by the authoring layer.