Interface ISwarmSchema

Interface representing the schema for defining a swarm. Configures the swarm's behavior, navigation, and agent management.

interface ISwarmSchema {
    agentList: string[];
    callbacks?: Partial<ISwarmCallbacks>;
    defaultAgent: string;
    docDescription?: string;
    getActiveAgent?: (
        clientId: string,
        swarmName: string,
        defaultAgent: string,
    ) => string | Promise<string>;
    getNavigationStack?: (
        clientId: string,
        swarmName: string,
    ) => string[] | Promise<string[]>;
    persist?: boolean;
    policies?: string[];
    setActiveAgent?: (
        clientId: string,
        agentName: string,
        swarmName: string,
    ) => void | Promise<void>;
    setNavigationStack?: (
        clientId: string,
        navigationStack: string[],
        swarmName: string,
    ) => Promise<void>;
    swarmName: string;
}

Properties

agentList callbacks? defaultAgent docDescription? getActiveAgent? getNavigationStack? persist? policies? setActiveAgent? setNavigationStack? swarmName

Properties

agentList

agentList: string[]

The list of agent names available within the swarm.

Optionalcallbacks

callbacks?: Partial<ISwarmCallbacks>

Optional partial set of lifecycle callbacks for the swarm, allowing customization of events.

defaultAgent

defaultAgent: string

The default agent name to use when no active agent is specified.

OptionaldocDescription

docDescription?: string

Optional description for documentation purposes, aiding in swarm usage understanding.

OptionalgetActiveAgent

getActiveAgent?: (
    clientId: string,
    swarmName: string,
    defaultAgent: string,
) => string | Promise<string>

Optional function to fetch the active agent upon swarm initialization.

OptionalgetNavigationStack

getNavigationStack?: (
    clientId: string,
    swarmName: string,
) => string[] | Promise<string[]>

Optional function to retrieve the initial navigation stack after swarm initialization.

Optionalpersist

persist?: boolean

Optional flag to enable serialization of navigation stack and active agent state to persistent storage (e.g., hard drive).

Optionalpolicies

policies?: string[]

Optional array of policy names defining banhammer or access control rules for the swarm.

OptionalsetActiveAgent

setActiveAgent?: (
    clientId: string,
    agentName: string,
    swarmName: string,
) => void | Promise<void>

Optional function to update the active agent after navigation changes.

Throws

If the update fails (e.g., due to persistence issues).

OptionalsetNavigationStack

setNavigationStack?: (
    clientId: string,
    navigationStack: string[],
    swarmName: string,
) => Promise<void>

Optional function to persist the navigation stack after a change.

Throws

If persistence fails (e.g., due to storage issues).

swarmName

swarmName: string

The unique name of the swarm within the system.

Settings

Member Visibility

On This Page

Properties