@adcp/client 0.2.0

package/dist/lib/core/ADCPMultiAgentClient.d.ts

@@ -0,0 +1,308 @@
+import type { AgentConfig } from '../types';
+import { AgentClient } from './AgentClient';
+import type { ADCPClientConfig } from './ADCPClient';
+import type { InputHandler, TaskOptions, TaskResult } from './ConversationTypes';
+import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, CreateMediaBuyResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ListAuthorizedPropertiesRequest, ListAuthorizedPropertiesResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse } from '../types/tools.generated';
+/**
+ * Collection of agent clients for parallel operations
+ */
+export declare class AgentCollection {
+    private agents;
+    private config;
+    private clients;
+    constructor(agents: AgentConfig[], config?: ADCPClientConfig);
+    /**
+     * Execute getProducts on all agents in parallel
+     */
+    getProducts(params: GetProductsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetProductsResponse>[]>;
+    /**
+     * Execute listCreativeFormats on all agents in parallel
+     */
+    listCreativeFormats(params: ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativeFormatsResponse>[]>;
+    /**
+     * Execute createMediaBuy on all agents in parallel
+     * Note: This might not make sense for all use cases, but provided for completeness
+     */
+    createMediaBuy(params: CreateMediaBuyRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CreateMediaBuyResponse>[]>;
+    /**
+     * Execute updateMediaBuy on all agents in parallel
+     */
+    updateMediaBuy(params: UpdateMediaBuyRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<UpdateMediaBuyResponse>[]>;
+    /**
+     * Execute syncCreatives on all agents in parallel
+     */
+    syncCreatives(params: SyncCreativesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncCreativesResponse>[]>;
+    /**
+     * Execute listCreatives on all agents in parallel
+     */
+    listCreatives(params: ListCreativesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativesResponse>[]>;
+    /**
+     * Execute getMediaBuyDelivery on all agents in parallel
+     */
+    getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetMediaBuyDeliveryResponse>[]>;
+    /**
+     * Execute listAuthorizedProperties on all agents in parallel
+     */
+    listAuthorizedProperties(params: ListAuthorizedPropertiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAuthorizedPropertiesResponse>[]>;
+    /**
+     * Execute providePerformanceFeedback on all agents in parallel
+     */
+    providePerformanceFeedback(params: ProvidePerformanceFeedbackRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ProvidePerformanceFeedbackResponse>[]>;
+    /**
+     * Execute getSignals on all agents in parallel
+     */
+    getSignals(params: GetSignalsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetSignalsResponse>[]>;
+    /**
+     * Execute activateSignal on all agents in parallel
+     */
+    activateSignal(params: ActivateSignalRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ActivateSignalResponse>[]>;
+    /**
+     * Get individual agent client
+     */
+    getAgent(agentId: string): AgentClient;
+    /**
+     * Get all agent clients
+     */
+    getAllAgents(): AgentClient[];
+    /**
+     * Get agent IDs
+     */
+    getAgentIds(): string[];
+    /**
+     * Get agent count
+     */
+    get count(): number;
+    /**
+     * Filter agents by a condition
+     */
+    filter(predicate: (agent: AgentClient) => boolean): AgentClient[];
+    /**
+     * Map over all agents
+     */
+    map<T>(mapper: (agent: AgentClient) => T): T[];
+    /**
+     * Execute a custom function on all agents in parallel
+     */
+    execute<T>(executor: (agent: AgentClient) => Promise<T>): Promise<T[]>;
+}
+/**
+ * Main multi-agent ADCP client providing simple, intuitive API
+ *
+ * This is the primary entry point for most users. It provides:
+ * - Single agent access via agent(id)
+ * - Multi-agent access via agents([ids])
+ * - Broadcast access via allAgents()
+ * - Simple parallel execution using Promise.all()
+ *
+ * @example Basic usage
+ * ```typescript
+ * const client = new ADCPMultiAgentClient([
+ *   { id: 'agent1', name: 'Agent 1', agent_uri: 'https://agent1.com', protocol: 'mcp' },
+ *   { id: 'agent2', name: 'Agent 2', agent_uri: 'https://agent2.com', protocol: 'a2a' }
+ * ]);
+ *
+ * // Single agent
+ * const result = await client.agent('agent1').getProducts(params, handler);
+ *
+ * // Multiple specific agents
+ * const results = await client.agents(['agent1', 'agent2']).getProducts(params, handler);
+ *
+ * // All agents
+ * const allResults = await client.allAgents().getProducts(params, handler);
+ * ```
+ */
+export declare class ADCPMultiAgentClient {
+    private config;
+    private agentClients;
+    constructor(agentConfigs: AgentConfig[], config?: ADCPClientConfig);
+    /**
+     * Create client by auto-discovering agent configuration
+     *
+     * Automatically loads agents from:
+     * 1. Environment variables (SALES_AGENTS_CONFIG, ADCP_AGENTS_CONFIG, etc.)
+     * 2. Config files (adcp.config.json, adcp.json, .adcp.json, agents.json)
+     *
+     * @param config - Optional client configuration
+     * @returns ADCPMultiAgentClient instance with discovered agents
+     *
+     * @example
+     * ```typescript
+     * // Simplest possible setup - auto-discovers configuration
+     * const client = ADCPMultiAgentClient.fromConfig();
+     *
+     * // Use with options
+     * const client = ADCPMultiAgentClient.fromConfig({
+     *   debug: true,
+     *   defaultTimeout: 60000
+     * });
+     * ```
+     */
+    static fromConfig(config?: ADCPClientConfig): ADCPMultiAgentClient;
+    /**
+     * Create client from environment variables only
+     *
+     * @param config - Optional client configuration
+     * @returns ADCPMultiAgentClient instance with environment-loaded agents
+     *
+     * @example
+     * ```typescript
+     * // Load agents from SALES_AGENTS_CONFIG environment variable
+     * const client = ADCPMultiAgentClient.fromEnv();
+     * ```
+     */
+    static fromEnv(config?: ADCPClientConfig): ADCPMultiAgentClient;
+    /**
+     * Create client from a specific config file
+     *
+     * @param configPath - Path to configuration file
+     * @param config - Optional client configuration
+     * @returns ADCPMultiAgentClient instance with file-loaded agents
+     *
+     * @example
+     * ```typescript
+     * // Load from specific file
+     * const client = ADCPMultiAgentClient.fromFile('./my-agents.json');
+     *
+     * // Load from default locations
+     * const client = ADCPMultiAgentClient.fromFile();
+     * ```
+     */
+    static fromFile(configPath?: string, config?: ADCPClientConfig): ADCPMultiAgentClient;
+    /**
+     * Create a simple client with minimal configuration
+     *
+     * @param agentUrl - Single agent URL
+     * @param options - Optional agent and client configuration
+     * @returns ADCPMultiAgentClient instance with single agent
+     *
+     * @example
+     * ```typescript
+     * // Simplest possible setup for single agent
+     * const client = ADCPMultiAgentClient.simple('https://my-agent.example.com');
+     *
+     * // With options
+     * const client = ADCPMultiAgentClient.simple('https://my-agent.example.com', {
+     *   agentName: 'My Agent',
+     *   protocol: 'mcp',
+     *   requiresAuth: true,
+     *   debug: true
+     * });
+     * ```
+     */
+    static simple(agentUrl: string, options?: {
+        agentId?: string;
+        agentName?: string;
+        protocol?: 'mcp' | 'a2a';
+        requiresAuth?: boolean;
+        authTokenEnv?: string;
+        debug?: boolean;
+        timeout?: number;
+    }): ADCPMultiAgentClient;
+    /**
+     * Get a single agent for operations
+     *
+     * @param agentId - ID of the agent to get
+     * @returns AgentClient for the specified agent
+     * @throws Error if agent not found
+     *
+     * @example
+     * ```typescript
+     * const agent = client.agent('premium-agent');
+     * const products = await agent.getProducts({ brief: 'Coffee brands' }, handler);
+     * const refined = await agent.continueConversation('Focus on premium brands');
+     * ```
+     */
+    agent(agentId: string): AgentClient;
+    /**
+     * Get multiple specific agents for parallel operations
+     *
+     * @param agentIds - Array of agent IDs
+     * @returns AgentCollection for parallel operations
+     * @throws Error if any agent not found
+     *
+     * @example
+     * ```typescript
+     * const agents = client.agents(['agent1', 'agent2']);
+     * const results = await agents.getProducts({ brief: 'Coffee brands' }, handler);
+     *
+     * // Process results
+     * results.forEach(result => {
+     *   if (result.success) {
+     *     console.log(`${result.metadata.agent.name}: ${result.data.products.length} products`);
+     *   }
+     * });
+     * ```
+     */
+    agents(agentIds: string[]): AgentCollection;
+    /**
+     * Get all configured agents for broadcast operations
+     *
+     * @returns AgentCollection containing all agents
+     *
+     * @example
+     * ```typescript
+     * const allResults = await client.allAgents().getProducts({
+     *   brief: 'Premium coffee brands'
+     * }, handler);
+     *
+     * // Find best result
+     * const successful = allResults.filter(r => r.success);
+     * const bestResult = successful.sort((a, b) =>
+     *   b.data.products.length - a.data.products.length
+     * )[0];
+     * ```
+     */
+    allAgents(): AgentCollection;
+    /**
+     * Add an agent to the client
+     *
+     * @param agentConfig - Agent configuration to add
+     * @throws Error if agent ID already exists
+     */
+    addAgent(agentConfig: AgentConfig): void;
+    /**
+     * Remove an agent from the client
+     *
+     * @param agentId - ID of agent to remove
+     * @returns True if agent was removed, false if not found
+     */
+    removeAgent(agentId: string): boolean;
+    /**
+     * Check if an agent exists
+     */
+    hasAgent(agentId: string): boolean;
+    /**
+     * Get all configured agent IDs
+     */
+    getAgentIds(): string[];
+    /**
+     * Get all agent configurations
+     */
+    getAgentConfigs(): AgentConfig[];
+    /**
+     * Get count of configured agents
+     */
+    get agentCount(): number;
+    /**
+     * Filter agents by protocol
+     */
+    getAgentsByProtocol(protocol: 'mcp' | 'a2a'): AgentCollection;
+    /**
+     * Find agents that support a specific task
+     * This is a placeholder - in a full implementation, you'd query agent capabilities
+     */
+    findAgentsForTask(taskName: string): AgentCollection;
+    /**
+     * Get all active tasks across all agents
+     */
+    getAllActiveTasks(): import("./ConversationTypes").TaskState[];
+}
+/**
+ * Factory function to create a multi-agent ADCP client
+ *
+ * @param agents - Array of agent configurations
+ * @param config - Client configuration
+ * @returns Configured ADCPMultiAgentClient instance
+ */
+export declare function createADCPMultiAgentClient(agents: AgentConfig[], config?: ADCPClientConfig): ADCPMultiAgentClient;
+//# sourceMappingURL=ADCPMultiAgentClient.d.ts.map

package/dist/lib/core/ADCPMultiAgentClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ADCPMultiAgentClient.d.ts","sourceRoot":"","sources":["../../../src/lib/core/ADCPMultiAgentClient.ts"],"names":[],"mappings":"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"}