Function addState

addState<T extends unknown = any>(stateSchema: IStateSchema<T>): string
Adds a new state to the state registry for use within the swarm system.

This function registers a new state, enabling the swarm to manage and utilize it for agent operations or shared data persistence. Only states registered through this function are recognized by the swarm. If the state is marked as shared, it initializes a connection to the shared state service and waits for its initialization. The execution is wrapped in beginContext to ensure it runs outside of existing method and execution contexts, providing a clean execution environment. The function logs the operation if enabled and returns the state's name upon successful registration.
Type Parameters
- T extends unknown = any
  The type of data stored in the state (defaults to any if unspecified).
Parameters
- stateSchema: IStateSchema<T>
  The schema defining the state's properties, including its name (stateName), shared status (shared), and other configuration details.
Returns string
The name of the newly added state (stateSchema.stateName), confirming its registration.
Throws
If the state schema is invalid, registration fails (e.g., duplicate state name), or shared state initialization encounters an error.
Example
```
const stateSchema = { stateName: "UserPrefs", shared: true, initialValue: { theme: "dark" } };
const stateName = addState(stateSchema);
console.log(stateName); // Outputs "UserPrefs"
```
- Defined in types.d.ts:11429