Module task_state 

Task Operating State — introspection-driven state synthesis.

This module defines the types and synthesis rules for building a TaskOperatingState from raw subsystem outputs (TaskStateInput).

Design Invariants

• roboticus-agent owns all synthesis rules. roboticus-api supplies inputs only.
• No duplicated truth between crates — if both compute “fit,” that’s a bug.
• Memory has two roles:
  • Conversation: ambient enrichment (passive, automatic)
  • Task: operational input (active, introspective)
  • InspectMemory applies to task turns only. Conversational turns get passive memory via the existing context builder.

Structs

BehavioralHistory

Behavioral self-assessment based on recent output history.

DeclaredAction

A user-declared action that must be resolved, not redirected.

DeclaredActionState

Assessment of whether the user declared a specific action.

DecompositionProposal

Decomposition gate output, used as one scored signal by the planner.

MemoryConfidence

Memory retrieval confidence assessment.

RosterFit

Subagent roster fit assessment.

RuntimeConstraints

Runtime and storage constraints affecting action selection.

SkillFit

Skill fit assessment.

TaskOperatingState

Full introspection-driven operating state for a turn.

TaskStateInput

Raw facts assembled by roboticus-api from pipeline subsystems. This is the sole input to synthesize — the API layer collects these values but does NOT interpret them.

ToolFit

Tool availability and relevance assessment.

Enums

TaskClassification

Classification of the turn as task-oriented or conversational.

Constants

ACTION_VERBS

Canonical list of physical/mechanical action verbs indicating the user is declaring an action that must be resolved, not a conversational request. Shared between task_state::assess_declared_action and the DeclaredActionGuard in guard_registry.rs.

Functions

extract_echo_fragments

Extract notable phrases (8+ words) from assistant response text.

response_skeleton

Derive a compact structural skeleton label from an assistant response.

synthesize

Synthesize a TaskOperatingState from raw subsystem outputs.