@distri/core 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,197 @@
+import { AgentSkill, Message, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Task, MessageSendParams } from '@a2a-js/sdk/client';
+export * from '@a2a-js/sdk/client';
+export { AgentCard, Message, MessageSendParams, Task, TaskArtifactUpdateEvent, TaskStatus, TaskStatusUpdateEvent } from '@a2a-js/sdk/client';
+
+/**
+ * Distri-specific Agent type that wraps A2A AgentCard
+ */
+interface DistriAgent {
+    /** The name of the agent. */
+    name: string;
+    id: string;
+    /** A brief description of the agent's purpose. */
+    description?: string;
+    /** The version of the agent. */
+    version?: string;
+    /** The system prompt for the agent, if any. */
+    system_prompt?: string | null;
+    /** A list of MCP server definitions associated with the agent. */
+    mcp_servers?: McpDefinition[];
+    /** Settings related to the model used by the agent. */
+    model_settings?: ModelSettings;
+    /** The size of the history to maintain for the agent. */
+    history_size?: number;
+    /** The planning configuration for the agent, if any. */
+    plan?: any;
+    /** A2A-specific fields */
+    icon_url?: string;
+    max_iterations?: number;
+    skills?: AgentSkill[];
+    /** List of sub-agents that this agent can transfer control to */
+    sub_agents?: string[];
+}
+interface McpDefinition {
+    /** The filter applied to the tools in this MCP definition. */
+    filter?: string[];
+    /** The name of the MCP server. */
+    name: string;
+    /** The type of the MCP server (Tool or Agent). */
+    type?: McpServerType;
+}
+interface ModelSettings {
+    model: string;
+    temperature: number;
+    max_tokens: number;
+    top_p: number;
+    frequency_penalty: number;
+    presence_penalty: number;
+    max_iterations: number;
+    provider: ModelProvider;
+    /** Additional parameters for the agent, if any. */
+    parameters?: any;
+    /** The format of the response, if specified. */
+    response_format?: any;
+}
+type McpServerType = 'tool' | 'agent';
+type ModelProvider = 'openai' | 'aigateway';
+/**
+ * Distri Thread type for conversation management
+ */
+interface DistriThread {
+    id: string;
+    title: string;
+    agent_id: string;
+    agent_name: string;
+    updated_at: string;
+    message_count: number;
+    last_message?: string;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string;
+    status: 'online' | 'offline';
+}
+interface Thread {
+    id: string;
+    title: string;
+    agent_id: string;
+    agent_name: string;
+    updated_at: string;
+    message_count: number;
+    last_message?: string;
+}
+interface ChatProps {
+    thread: Thread;
+    agent: Agent;
+    onThreadUpdate?: () => void;
+}
+/**
+ * Connection Status
+ */
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+/**
+ * Distri Client Configuration
+ */
+interface DistriClientConfig {
+    baseUrl: string;
+    apiVersion?: string;
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    debug?: boolean;
+    headers?: Record<string, string>;
+}
+/**
+ * Error Types
+ */
+declare class DistriError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+declare class A2AProtocolError extends DistriError {
+    constructor(message: string, details?: any);
+}
+declare class ApiError extends DistriError {
+    statusCode: number;
+    constructor(message: string, statusCode: number, details?: any);
+}
+declare class ConnectionError extends DistriError {
+    constructor(message: string, details?: any);
+}
+
+type A2AStreamEventData = Message | TaskStatusUpdateEvent | TaskArtifactUpdateEvent | Task;
+
+/**
+ * Enhanced Distri Client that wraps A2AClient and adds Distri-specific features
+ */
+declare class DistriClient {
+    private config;
+    private agentClients;
+    constructor(config: DistriClientConfig);
+    /**
+     * Get all available agents from the Distri server
+     */
+    getAgents(): Promise<DistriAgent[]>;
+    /**
+     * Get specific agent by ID
+     */
+    getAgent(agentId: string): Promise<DistriAgent>;
+    /**
+     * Get or create A2AClient for an agent
+     */
+    private getA2AClient;
+    /**
+     * Send a message to an agent
+     */
+    sendMessage(agentId: string, params: MessageSendParams): Promise<Message | Task>;
+    /**
+     * Send a streaming message to an agent
+     */
+    sendMessageStream(agentId: string, params: MessageSendParams): AsyncGenerator<A2AStreamEventData>;
+    /**
+     * Get task details
+     */
+    getTask(agentId: string, taskId: string): Promise<Task>;
+    /**
+     * Cancel a task
+     */
+    cancelTask(agentId: string, taskId: string): Promise<void>;
+    /**
+     * Get threads from Distri server
+     */
+    getThreads(): Promise<DistriThread[]>;
+    getThread(threadId: string): Promise<DistriThread>;
+    /**
+     * Get thread messages
+     */
+    getThreadMessages(threadId: string): Promise<Message[]>;
+    /**
+     * Get the base URL for making direct requests
+     */
+    get baseUrl(): string;
+    /**
+     * Enhanced fetch with retry logic
+     */
+    private fetch;
+    /**
+     * Delay utility
+     */
+    private delay;
+    /**
+     * Debug logging
+     */
+    private debug;
+    /**
+     * Helper method to create A2A messages
+     */
+    static initMessage(input: string, role?: 'agent' | 'user', contextId?: string, messageId?: string, taskId?: string): Message;
+    /**
+     * Helper method to create message send parameters
+     */
+    static initMessageParams(message: Message, configuration?: MessageSendParams['configuration']): MessageSendParams;
+}
+declare function uuidv4(): string;
+
+export { A2AProtocolError, type A2AStreamEventData, type Agent, ApiError, type ChatProps, ConnectionError, type ConnectionStatus, type DistriAgent, DistriClient, type DistriClientConfig, DistriError, type DistriThread, type McpDefinition, type McpServerType, type ModelProvider, type ModelSettings, type Thread, uuidv4 };

package/dist/index.d.ts

@@ -0,0 +1,197 @@
+import { AgentSkill, Message, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Task, MessageSendParams } from '@a2a-js/sdk/client';
+export * from '@a2a-js/sdk/client';
+export { AgentCard, Message, MessageSendParams, Task, TaskArtifactUpdateEvent, TaskStatus, TaskStatusUpdateEvent } from '@a2a-js/sdk/client';
+
+/**
+ * Distri-specific Agent type that wraps A2A AgentCard
+ */
+interface DistriAgent {
+    /** The name of the agent. */
+    name: string;
+    id: string;
+    /** A brief description of the agent's purpose. */
+    description?: string;
+    /** The version of the agent. */
+    version?: string;
+    /** The system prompt for the agent, if any. */
+    system_prompt?: string | null;
+    /** A list of MCP server definitions associated with the agent. */
+    mcp_servers?: McpDefinition[];
+    /** Settings related to the model used by the agent. */
+    model_settings?: ModelSettings;
+    /** The size of the history to maintain for the agent. */
+    history_size?: number;
+    /** The planning configuration for the agent, if any. */
+    plan?: any;
+    /** A2A-specific fields */
+    icon_url?: string;
+    max_iterations?: number;
+    skills?: AgentSkill[];
+    /** List of sub-agents that this agent can transfer control to */
+    sub_agents?: string[];
+}
+interface McpDefinition {
+    /** The filter applied to the tools in this MCP definition. */
+    filter?: string[];
+    /** The name of the MCP server. */
+    name: string;
+    /** The type of the MCP server (Tool or Agent). */
+    type?: McpServerType;
+}
+interface ModelSettings {
+    model: string;
+    temperature: number;
+    max_tokens: number;
+    top_p: number;
+    frequency_penalty: number;
+    presence_penalty: number;
+    max_iterations: number;
+    provider: ModelProvider;
+    /** Additional parameters for the agent, if any. */
+    parameters?: any;
+    /** The format of the response, if specified. */
+    response_format?: any;
+}
+type McpServerType = 'tool' | 'agent';
+type ModelProvider = 'openai' | 'aigateway';
+/**
+ * Distri Thread type for conversation management
+ */
+interface DistriThread {
+    id: string;
+    title: string;
+    agent_id: string;
+    agent_name: string;
+    updated_at: string;
+    message_count: number;
+    last_message?: string;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string;
+    status: 'online' | 'offline';
+}
+interface Thread {
+    id: string;
+    title: string;
+    agent_id: string;
+    agent_name: string;
+    updated_at: string;
+    message_count: number;
+    last_message?: string;
+}
+interface ChatProps {
+    thread: Thread;
+    agent: Agent;
+    onThreadUpdate?: () => void;
+}
+/**
+ * Connection Status
+ */
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+/**
+ * Distri Client Configuration
+ */
+interface DistriClientConfig {
+    baseUrl: string;
+    apiVersion?: string;
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    debug?: boolean;
+    headers?: Record<string, string>;
+}
+/**
+ * Error Types
+ */
+declare class DistriError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+declare class A2AProtocolError extends DistriError {
+    constructor(message: string, details?: any);
+}
+declare class ApiError extends DistriError {
+    statusCode: number;
+    constructor(message: string, statusCode: number, details?: any);
+}
+declare class ConnectionError extends DistriError {
+    constructor(message: string, details?: any);
+}
+
+type A2AStreamEventData = Message | TaskStatusUpdateEvent | TaskArtifactUpdateEvent | Task;
+
+/**
+ * Enhanced Distri Client that wraps A2AClient and adds Distri-specific features
+ */
+declare class DistriClient {
+    private config;
+    private agentClients;
+    constructor(config: DistriClientConfig);
+    /**
+     * Get all available agents from the Distri server
+     */
+    getAgents(): Promise<DistriAgent[]>;
+    /**
+     * Get specific agent by ID
+     */
+    getAgent(agentId: string): Promise<DistriAgent>;
+    /**
+     * Get or create A2AClient for an agent
+     */
+    private getA2AClient;
+    /**
+     * Send a message to an agent
+     */
+    sendMessage(agentId: string, params: MessageSendParams): Promise<Message | Task>;
+    /**
+     * Send a streaming message to an agent
+     */
+    sendMessageStream(agentId: string, params: MessageSendParams): AsyncGenerator<A2AStreamEventData>;
+    /**
+     * Get task details
+     */
+    getTask(agentId: string, taskId: string): Promise<Task>;
+    /**
+     * Cancel a task
+     */
+    cancelTask(agentId: string, taskId: string): Promise<void>;
+    /**
+     * Get threads from Distri server
+     */
+    getThreads(): Promise<DistriThread[]>;
+    getThread(threadId: string): Promise<DistriThread>;
+    /**
+     * Get thread messages
+     */
+    getThreadMessages(threadId: string): Promise<Message[]>;
+    /**
+     * Get the base URL for making direct requests
+     */
+    get baseUrl(): string;
+    /**
+     * Enhanced fetch with retry logic
+     */
+    private fetch;
+    /**
+     * Delay utility
+     */
+    private delay;
+    /**
+     * Debug logging
+     */
+    private debug;
+    /**
+     * Helper method to create A2A messages
+     */
+    static initMessage(input: string, role?: 'agent' | 'user', contextId?: string, messageId?: string, taskId?: string): Message;
+    /**
+     * Helper method to create message send parameters
+     */
+    static initMessageParams(message: Message, configuration?: MessageSendParams['configuration']): MessageSendParams;
+}
+declare function uuidv4(): string;
+
+export { A2AProtocolError, type A2AStreamEventData, type Agent, ApiError, type ChatProps, ConnectionError, type ConnectionStatus, type DistriAgent, DistriClient, type DistriClientConfig, DistriError, type DistriThread, type McpDefinition, type McpServerType, type ModelProvider, type ModelSettings, type Thread, uuidv4 };