@radaros/core 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -138,6 +138,8 @@ interface ToolDef {
     description: string;
     parameters: z.ZodObject<any>;
     execute: (args: Record<string, unknown>, ctx: RunContext) => Promise<string | ToolResult>;
+    /** Raw JSON Schema to send to the LLM, bypassing Zod-to-JSON conversion (used by MCP tools). */
+    rawJsonSchema?: Record<string, unknown>;
 }
 interface ToolCallResult {
     toolCallId: string;
@@ -489,6 +491,11 @@ declare function google(modelId: string, config?: {
 declare function ollama(modelId: string, config?: {
     host?: string;
 }): ModelProvider;
+declare function vertex(modelId: string, config?: {
+    project?: string;
+    location?: string;
+    credentials?: string;
+}): ModelProvider;
 
 interface OpenAIConfig {
     apiKey?: string;
@@ -582,6 +589,42 @@ declare class OllamaProvider implements ModelProvider {
     private normalizeResponse;
 }
 
+interface VertexAIConfig {
+    project?: string;
+    location?: string;
+    /** Service account key JSON string or path (optional — uses ADC by default). */
+    credentials?: string;
+}
+/**
+ * Vertex AI provider using Google's @google/genai SDK in Vertex mode.
+ *
+ * Authentication (in order of precedence):
+ *   1. Explicit `project` + `location` in config
+ *   2. GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_LOCATION env vars
+ *   3. Application Default Credentials (gcloud auth)
+ */
+declare class VertexAIProvider implements ModelProvider {
+    readonly providerId = "vertex";
+    readonly modelId: string;
+    private ai;
+    private GoogleGenAICtor;
+    private project;
+    private location;
+    constructor(modelId: string, config?: VertexAIConfig);
+    private getClient;
+    generate(messages: ChatMessage[], options?: ModelConfig & {
+        tools?: ToolDefinition[];
+    }): Promise<ModelResponse>;
+    stream(messages: ChatMessage[], options?: ModelConfig & {
+        tools?: ToolDefinition[];
+    }): AsyncGenerator<StreamChunk>;
+    private toGoogleMessages;
+    private partToGoogle;
+    private toGoogleTools;
+    private cleanJsonSchema;
+    private normalizeResponse;
+}
+
 declare function defineTool<T extends z.ZodObject<any>>(config: {
     name: string;
     description: string;
@@ -884,4 +927,225 @@ declare class SessionManager {
     deleteSession(sessionId: string): Promise<void>;
 }
 
-export { Agent, type AgentConfig, type AgentEventMap, type AgentHooks, type AgentStep, AnthropicProvider, type Artifact, type AudioPart, BaseVectorStore, type ChatMessage, type ConditionStep, type ContentPart, type EmbeddingProvider, EventBus, type FilePart, type FunctionStep, GoogleEmbedding, type GoogleEmbeddingConfig, GoogleProvider, type GuardrailResult, type ImagePart, InMemoryStorage, InMemoryVectorStore, type InputGuardrail, KnowledgeBase, type KnowledgeBaseConfig, type KnowledgeBaseToolConfig, LLMLoop, type LogLevel, Logger, type LoggerConfig, Memory, type MemoryConfig, type MemoryEntry, type MessageContent, type MessageRole, type ModelConfig, type ModelProvider, ModelRegistry, type ModelResponse, MongoDBStorage, type MongoDBVectorConfig, MongoDBVectorStore, OllamaProvider, OpenAIEmbedding, type OpenAIEmbeddingConfig, OpenAIProvider, type OutputGuardrail, type ParallelStep, type PgVectorConfig, PgVectorStore, PostgresStorage, type QdrantConfig, QdrantVectorStore, RunContext, type RunOpts, type RunOutput, type Session, SessionManager, SqliteStorage, type StepDef, type StepResult, type StorageDriver, type StreamChunk, Team, type TeamConfig, TeamMode, type TextPart, type TokenUsage, type ToolCall, type ToolCallResult, type ToolDef, type ToolDefinition, ToolExecutor, type ToolResult, type VectorDocument, type VectorSearchOptions, type VectorSearchResult, type VectorStore, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry };
+interface MCPToolProviderConfig {
+    name: string;
+    transport: "stdio" | "http";
+    /** For stdio transport: command to spawn */
+    command?: string;
+    /** For stdio transport: args for the command */
+    args?: string[];
+    /** For stdio transport: environment variables */
+    env?: Record<string, string>;
+    /** For http transport: server URL */
+    url?: string;
+    /** For http transport: custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Connects to an MCP (Model Context Protocol) server and exposes its tools
+ * as native RadarOS ToolDef[] that any Agent can use.
+ *
+ * Supports stdio and HTTP (Streamable HTTP) transports.
+ * Requires: npm install @modelcontextprotocol/sdk
+ */
+declare class MCPToolProvider {
+    readonly name: string;
+    private config;
+    private client;
+    private transportInstance;
+    private tools;
+    private connected;
+    constructor(config: MCPToolProviderConfig);
+    connect(): Promise<void>;
+    private discoverTools;
+    private jsonSchemaToZod;
+    /**
+     * Returns tools from this MCP server as RadarOS ToolDef[].
+     * Optionally filter by tool names to reduce token usage.
+     *
+     * @param filter - Tool names to include (without the server name prefix).
+     *                 If omitted, returns all tools.
+     *
+     * @example
+     * // All tools
+     * await mcp.getTools()
+     *
+     * // Only specific tools (pass the original MCP tool names, not prefixed)
+     * await mcp.getTools({ include: ["get_latest_release", "search_repositories"] })
+     *
+     * // Exclude specific tools
+     * await mcp.getTools({ exclude: ["push_files", "create_repository"] })
+     */
+    getTools(filter?: {
+        include?: string[];
+        exclude?: string[];
+    }): Promise<ToolDef[]>;
+    /** Refresh the tool list from the MCP server. */
+    refresh(): Promise<void>;
+    /** Disconnect from the MCP server. */
+    close(): Promise<void>;
+}
+
+/**
+ * A2A (Agent-to-Agent) Protocol types.
+ * Based on the A2A specification v0.2.
+ * https://google.github.io/A2A/specification/
+ */
+interface A2ATextPart {
+    kind: "text";
+    text: string;
+}
+interface A2AFilePart {
+    kind: "file";
+    file: {
+        name?: string;
+        mimeType?: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+interface A2ADataPart {
+    kind: "data";
+    data: Record<string, unknown>;
+}
+type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+interface A2AMessage {
+    role: "user" | "agent";
+    parts: A2APart[];
+    messageId?: string;
+    taskId?: string;
+    referenceTaskIds?: string[];
+    metadata?: Record<string, unknown>;
+}
+type A2ATaskState = "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
+interface A2AArtifact {
+    artifactId: string;
+    name?: string;
+    description?: string;
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ATask {
+    id: string;
+    sessionId?: string;
+    status: {
+        state: A2ATaskState;
+        message?: A2AMessage;
+        timestamp?: string;
+    };
+    artifacts?: A2AArtifact[];
+    history?: A2AMessage[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ASkill {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    examples?: string[];
+}
+interface A2AAgentCard {
+    name: string;
+    description?: string;
+    url: string;
+    version?: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+        stateTransitionHistory?: boolean;
+    };
+    authentication?: {
+        schemes?: string[];
+        credentials?: string;
+    };
+    skills?: A2ASkill[];
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    supportedInputModes?: string[];
+    supportedOutputModes?: string[];
+}
+interface A2AJsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface A2AJsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+interface A2ASendParams {
+    message: A2AMessage;
+    configuration?: {
+        acceptedOutputModes?: string[];
+        blocking?: boolean;
+    };
+    metadata?: Record<string, unknown>;
+}
+interface A2ATaskQueryParams {
+    id: string;
+    historyLength?: number;
+}
+
+interface A2ARemoteAgentConfig {
+    url: string;
+    /** Custom headers for every request (e.g. auth tokens). */
+    headers?: Record<string, string>;
+    /** Override the discovered name. */
+    name?: string;
+    /** Request timeout in ms (default 60000). */
+    timeoutMs?: number;
+}
+/**
+ * A2ARemoteAgent wraps a remote A2A-compliant agent.
+ * It can be used as a tool, a Team member, or called directly.
+ */
+declare class A2ARemoteAgent {
+    readonly url: string;
+    name: string;
+    instructions: string;
+    skills: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    private headers;
+    private timeoutMs;
+    private card;
+    private rpcId;
+    get tools(): ToolDef[];
+    get modelId(): string;
+    get providerId(): string;
+    get hasStructuredOutput(): boolean;
+    constructor(config: A2ARemoteAgentConfig);
+    /**
+     * Fetch the Agent Card from /.well-known/agent.json and populate metadata.
+     */
+    discover(): Promise<A2AAgentCard>;
+    /**
+     * Synchronous run: sends message/send and returns RunOutput.
+     */
+    run(input: string, opts?: RunOpts): Promise<RunOutput>;
+    /**
+     * Streaming run: sends message/stream and yields StreamChunks from SSE.
+     */
+    stream(input: string, opts?: RunOpts): AsyncGenerator<StreamChunk>;
+    /**
+     * Wrap this remote agent as a ToolDef so it can be used by an orchestrator agent.
+     */
+    asTool(): ToolDef;
+    getAgentCard(): A2AAgentCard | null;
+    private partsToText;
+}
+
+export { type A2AAgentCard, type A2AArtifact, type A2ADataPart, type A2AFilePart, type A2AJsonRpcRequest, type A2AJsonRpcResponse, type A2AMessage, type A2APart, A2ARemoteAgent, type A2ARemoteAgentConfig, type A2ASendParams, type A2ASkill, type A2ATask, type A2ATaskQueryParams, type A2ATaskState, type A2ATextPart, Agent, type AgentConfig, type AgentEventMap, type AgentHooks, type AgentStep, AnthropicProvider, type Artifact, type AudioPart, BaseVectorStore, type ChatMessage, type ConditionStep, type ContentPart, type EmbeddingProvider, EventBus, type FilePart, type FunctionStep, GoogleEmbedding, type GoogleEmbeddingConfig, GoogleProvider, type GuardrailResult, type ImagePart, InMemoryStorage, InMemoryVectorStore, type InputGuardrail, KnowledgeBase, type KnowledgeBaseConfig, type KnowledgeBaseToolConfig, LLMLoop, type LogLevel, Logger, type LoggerConfig, MCPToolProvider, type MCPToolProviderConfig, Memory, type MemoryConfig, type MemoryEntry, type MessageContent, type MessageRole, type ModelConfig, type ModelProvider, ModelRegistry, type ModelResponse, MongoDBStorage, type MongoDBVectorConfig, MongoDBVectorStore, OllamaProvider, OpenAIEmbedding, type OpenAIEmbeddingConfig, OpenAIProvider, type OutputGuardrail, type ParallelStep, type PgVectorConfig, PgVectorStore, PostgresStorage, type QdrantConfig, QdrantVectorStore, RunContext, type RunOpts, type RunOutput, type Session, SessionManager, SqliteStorage, type StepDef, type StepResult, type StorageDriver, type StreamChunk, Team, type TeamConfig, TeamMode, type TextPart, type TokenUsage, type ToolCall, type ToolCallResult, type ToolDef, type ToolDefinition, ToolExecutor, type ToolResult, type VectorDocument, type VectorSearchOptions, type VectorSearchResult, type VectorStore, type VertexAIConfig, VertexAIProvider, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry, vertex };