wehub-resource-sync
4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
2.1 KiB
2.1 KiB
Agent & Investigation State
core/state/ owns the provider-agnostic agent and investigation state that OpenSRE
carries between alert intake, evidence gathering, diagnosis, and reporting stages.
Use this package for typed investigation state, evidence records, and the state-update helpers that decide which incident facts are carried forward. This is state — not REPL session state, CLI prompt grounding, or generic agent-runtime request assembly.
Belongs Here
- The shared
AgentStateruntime envelope and its Pydantic validation model. - Investigation pipeline slice contracts and the chat-mode slice.
- Incident evidence entries (
EvidenceEntry), provenance, and evidence contracts. - State-update helpers and pure defaults.
Does Not Belong Here
- Agent orchestration or stage sequencing; keep that in
tools/investigation/. - Context trimming, ranking, and budget logic; keep that in
core/context_budget.py. - The LLM/tool-calling loop and runtime request contracts; keep those in sibling
core/runtime modules. - Terminal UI, REPL session state, prompt history, CLI help, AGENTS.md grounding,
and slash commands; keep those in
surfaces/interactive_shell/. - External clients, config normalization, and verification; keep those in
integrations/. - Agent-callable tool implementations; keep those in
tools/. - Platform services such as guardrails, masking, auth, telemetry, notifications,
and sandboxing; keep those in
platform/.
Also exported (temporary)
MutableAgentStateinagent_state.py. Now slimmed to the cross-turn transcript (messages) pluslast_observationandclear()— the per-turn tool/prompt machinery has been removed. It still lives here for historical import paths; the remaining move tocore/agent_harness/session/is pending (#3685).
Naming Rule
New names here should make the state boundary obvious. Prefer terms such as
state, slice, evidence, provenance, and snapshot. Avoid adding generic
prompt, session, runtime, or grounding modules here; those belong to their
owning surface or runtime package.