agentscope-admin-spring-boot-starter

Spring Boot auto-configuration for the AgentScope admin/ops starter.

Immutable audit record for one admin operation.

Default audit sink: logs at INFO via SLF4J and (optionally) republishes the record as a Spring `ApplicationEvent` so other components can subscribe with `@EventListener`.

Self-describing record of an admin operation exposed by this starter.

Thread-safe registry of `AdminCommand` instances.

Registers the Phase-1 built-in `AdminCommand`s into the `AdminCommandRegistry`.

Which physical surface a command lives on.

Data-plane REST surface.

Data-plane REST for `BackgroundTask`s dispatched to subagents via `TaskRepository`.

Read-only wire view of `Task` (the per-`io.agentscope.core.state.AgentState` task record — the TodoWrite-style work-item list that an agent maintains for itself).

Request body for `POST /v1/admin/sessions/{id}:compact`.

Response body for `POST /v1/admin/sessions/{id}:compact`.

Slim projection of a `io.agentscope.core.message.Msg` for admin listings.

Wire view of `PlanModeContextState`, plus a server-side flag indicating whether the `PlanModeMiddleware` was wired into the agent at build time.

Wire view of a `BackgroundTask` dispatched to a subagent.

`GET /actuator/agentscope-agents`: enumerate agents known to the registry.

`GET /actuator/agentscope-commands`: machine-readable catalog of every admin command exposed by this process.

`GET /actuator/agentscope-doctor`: opinionated self-check.

`POST /actuator/agentscope-drain`: stop accepting new agent requests, wait for in-flight ones to finish, but do NOT terminate the JVM.

`GET /actuator/agentscope-models`: {beanName -> modelName} map.

`GET /actuator/agentscope-permissions`: enumerate the permission posture of every registered `ReActAgent`.

`POST /actuator/agentscope-shutdown`: drain, then schedule a JVM-level shutdown.

`GET /actuator/agentscope-status`: process-wide health summary.

`GET /actuator/agentscope-subagents`: enumerate the registered subagents.

`GET /actuator/agentscope-tools`: per-Toolkit-bean list of registered tools.

`GET /actuator/agentscope-usage`: process-cumulative token usage, sliced both by agent name and by model name.

Legacy `Hook` that observes `PostCallEvent` and forwards the per-call token usage to a `MetricsRecorder`.

Thread-safe accumulator for token usage counters, sliced by agent name and by model name.

Immutable snapshot of accumulated usage counters for a single bucket (agent or model).

Wires the admin starter into springdoc-openapi *only when springdoc is on the classpath*.

Configuration properties for the AgentScope admin/ops starter.

Lightweight projection of an `Agent` for inventory views.

SPI for tracking live agents the admin surface can inspect or act on.

Small unwrap helper that hides the `HarnessAgent` composition from admin call sites.

Single-node, in-memory `AgentRegistry` suitable as the starter default.

Aggregates inventory information across `AgentRegistry`, Spring-managed `Toolkit` and `Model` beans, and the `GracefulShutdownManager`.

Default `SummarizationStrategy` that asks the agent's own model to produce a fresh rolling summary.

Business logic for the per-session data-plane admin actions.

Read/cancel operations over a `TaskRepository`-managed pool of subagent background tasks.

Strategy for the `session:compact` action.

Copies the mutable fields of a snapshotted `AgentState` back into a live one.

In-memory undo/redo stacks per session.

Default `SubagentInventory` that scans the Spring context for any user-declared `SubagentEntry` or `SubagentDeclaration` beans.

Wire view of a registered subagent — flattens whichever projection (a `SubagentEntry` from a built agent, or a `SubagentDeclaration` loaded from a yaml/markdown spec) the inventory adapter happens to hold.

SPI for enumerating the subagents available to this process.