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
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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 `AgentState` runtime 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)
|
|
|
|
- ``MutableAgentState`` in ``agent_state.py``. Now slimmed to the cross-turn
|
|
transcript (``messages``) plus ``last_observation`` and ``clear()`` — the
|
|
per-turn tool/prompt machinery has been removed. It still lives here for
|
|
historical import paths; the remaining move to
|
|
``core/agent_harness/session/`` is pending
|
|
([#3685](https://github.com/Tracer-Cloud/opensre/issues/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.
|