agent-swarm-kit 1.0.83 → 1.0.85

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.0.83",
+  "version": "1.0.85",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -834,6 +834,13 @@ interface IModelMessage {
  * Interface for History Adapter Callbacks
  */
 interface IHistoryInstanceCallbacks {
+    /**
+     * Callback for compute of dynamic system prompt
+     * @param clientId - The client ID.
+     * @param agentName - The agent name.
+     * @returns An array of additional system prompt messages
+     */
+    getSystemPrompt?: (clientId: string, agentName: AgentName) => Promise<string[]> | string[];
     /**
      * Filter condition for history messages.
      * @param message - The model message.
@@ -1387,6 +1394,8 @@ interface IAgentSchema {
     storages?: StorageName[];
     /** The names of the states used by the agent. */
     states?: StateName[];
+    /** The list of dependencies for changeAgent */
+    dependsOn?: AgentName[];
     /**
      * Validates the output.
      * @param output - The output to validate.
@@ -2336,6 +2345,7 @@ declare class AgentValidationService {
     private readonly completionValidationService;
     private readonly storageValidationService;
     private _agentMap;
+    private _agentDepsMap;
     /**
      * Retrieves the storages used by the agent
      * @param {agentName} agentName - The name of the swarm.
@@ -2361,6 +2371,10 @@ declare class AgentValidationService {
      * Check if agent got registered storage
      */
     hasStorage: ((agentName: AgentName, storageName: StorageName) => boolean) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, boolean>;
+    /**
+     * Check if agent got registered dependency
+     */
+    hasDependency: ((targetAgentName: AgentName, depAgentName: StorageName) => boolean) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, boolean>;
     /**
      * Check if agent got registered state
      */
@@ -3021,6 +3035,57 @@ declare class BusService implements IBus {
     dispose: (clientId: string) => void;
 }
 
+/**
+ * Interface representing a meta node.
+ */
+interface IMetaNode {
+    name: string;
+    child?: IMetaNode[];
+}
+/**
+ * Service class for managing agent meta nodes and converting them to UML format.
+ */
+declare class AgentMetaService {
+    private readonly loggerService;
+    private readonly agentSchemaService;
+    private serialize;
+    /**
+     * Creates a meta node for the given agent.
+     * @param {AgentName} agentName - The name of the agent.
+     * @param {Set<AgentName>} seen - A set of seen agent names to avoid circular dependencies.
+     * @returns {IMetaNode} The created meta node.
+     */
+    makeAgentNode: (agentName: AgentName, seen?: Set<string>) => IMetaNode;
+    /**
+     * Converts the meta nodes of the given agent to UML format.
+     * @param {AgentName} agentName - The name of the agent.
+     * @returns {string} The UML representation of the agent's meta nodes.
+     */
+    toUML: (agentName: AgentName) => string;
+}
+
+/**
+ * Service for handling swarm metadata.
+ */
+declare class SwarmMetaService {
+    private readonly loggerService;
+    private readonly swarmSchemaService;
+    private readonly agentMetaService;
+    private serialize;
+    /**
+     * Creates a swarm node with the given swarm name.
+     * @param {SwarmName} swarmName - The name of the swarm.
+     * @returns {IMetaNode} The metadata node of the swarm.
+     */
+    makeSwarmNode: (swarmName: SwarmName) => IMetaNode;
+    /**
+     * Converts the swarm metadata to UML format.
+     * @param {SwarmName} swarmName - The name of the swarm.
+     * @returns {string} The UML representation of the swarm.
+     */
+    toUML: (swarmName: SwarmName) => string;
+}
+
 declare const swarm: {
     agentValidationService: AgentValidationService;
     toolValidationService: ToolValidationService;
@@ -3029,6 +3094,8 @@ declare const swarm: {
     completionValidationService: CompletionValidationService;
     storageValidationService: StorageValidationService;
     embeddingValidationService: EmbeddingValidationService;
+    agentMetaService: AgentMetaService;
+    swarmMetaService: SwarmMetaService;
     agentPublicService: AgentPublicService;
     historyPublicService: HistoryPublicService;
     sessionPublicService: SessionPublicService;
@@ -3058,6 +3125,22 @@ declare const swarm: {
     loggerService: LoggerService;
 };
 
+/**
+ * Dumps the agent information into PlantUML format.
+ *
+ * @param {SwarmName} swarmName - The name of the swarm to be dumped.
+ * @returns {string} The UML representation of the swarm.
+ */
+declare const dumpAgent: (agentName: AgentName) => string;
+
+/**
+ * Dumps the swarm information into PlantUML format.
+ *
+ * @param {SwarmName} swarmName - The name of the swarm to be dumped.
+ * @returns {string} The UML representation of the swarm.
+ */
+declare const dumpSwarm: (swarmName: SwarmName) => string;
+
 /**
  * Adds a new agent to the agent registry. The swarm takes only those agents which was registered
  *
@@ -3981,4 +4064,4 @@ declare class SchemaUtils {
  */
 declare const Schema: SchemaUtils;
 
-export { type EventSource, ExecutionContextService, History, HistoryAdapter, HistoryInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type ICompletionArgs, type ICompletionSchema, type ICustomEvent, type IEmbeddingSchema, type IHistoryAdapter, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type ISessionConfig, type IStateSchema, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, Logger, LoggerAdapter, LoggerInstance, MethodContextService, type ReceiveMessageFn, Schema, type SendMessageFn$1 as SendMessageFn, State, Storage, addAgent, addCompletion, addEmbedding, addState, addStorage, addSwarm, addTool, cancelOutput, cancelOutputForce, changeAgent, commitFlush, commitFlushForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getSessionMode, getUserHistory, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, session, setConfig, swarm };
+export { type EventSource, ExecutionContextService, History, HistoryAdapter, HistoryInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type ICompletionArgs, type ICompletionSchema, type ICustomEvent, type IEmbeddingSchema, type IHistoryAdapter, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type ISessionConfig, type IStateSchema, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, Logger, LoggerAdapter, LoggerInstance, MethodContextService, type ReceiveMessageFn, Schema, type SendMessageFn$1 as SendMessageFn, State, Storage, addAgent, addCompletion, addEmbedding, addState, addStorage, addSwarm, addTool, cancelOutput, cancelOutputForce, changeAgent, commitFlush, commitFlushForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, dumpAgent, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getSessionMode, getUserHistory, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, session, setConfig, swarm };