@radaros/core 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -491,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;
@@ -584,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;
@@ -1107,4 +1148,136 @@ declare class A2ARemoteAgent {
     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, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry };
+/**
+ * Base class for all RadarOS Toolkits.
+ * A Toolkit is a collection of related tools that share configuration.
+ */
+declare abstract class Toolkit {
+    abstract readonly name: string;
+    /**
+     * Returns all tools provided by this toolkit as ToolDef[].
+     * Spread them into an Agent's `tools` array.
+     */
+    abstract getTools(): ToolDef[];
+}
+
+interface WebSearchConfig {
+    /** Search provider: "tavily" or "serpapi". */
+    provider: "tavily" | "serpapi";
+    /** API key for the search provider. Falls back to TAVILY_API_KEY or SERPAPI_API_KEY env vars. */
+    apiKey?: string;
+    /** Max results to return per search (default 5). */
+    maxResults?: number;
+}
+/**
+ * Web Search Toolkit — search the web from your agent.
+ *
+ * Supports Tavily and SerpAPI backends.
+ *
+ * @example
+ * ```ts
+ * const search = new WebSearchToolkit({ provider: "tavily" });
+ * const agent = new Agent({ tools: [...search.getTools()] });
+ * ```
+ */
+declare class WebSearchToolkit extends Toolkit {
+    readonly name = "websearch";
+    private config;
+    constructor(config: WebSearchConfig);
+    private getApiKey;
+    getTools(): ToolDef[];
+    private searchTavily;
+    private searchSerpApi;
+}
+
+interface GmailConfig {
+    /** Path to OAuth2 credentials JSON file. Falls back to GMAIL_CREDENTIALS_PATH env var. */
+    credentialsPath?: string;
+    /** Path to saved token JSON file. Falls back to GMAIL_TOKEN_PATH env var. */
+    tokenPath?: string;
+    /** Pre-authenticated OAuth2 client (if you handle auth yourself). */
+    authClient?: any;
+}
+/**
+ * Gmail Toolkit — send, search, and read emails from your agent.
+ *
+ * Requires: npm install googleapis
+ *
+ * @example
+ * ```ts
+ * const gmail = new GmailToolkit({ credentialsPath: "./credentials.json", tokenPath: "./token.json" });
+ * const agent = new Agent({ tools: [...gmail.getTools()] });
+ * ```
+ */
+declare class GmailToolkit extends Toolkit {
+    readonly name = "gmail";
+    private config;
+    private gmail;
+    constructor(config?: GmailConfig);
+    private getGmailClient;
+    getTools(): ToolDef[];
+}
+
+interface WhatsAppConfig {
+    /** WhatsApp Business API access token. Falls back to WHATSAPP_ACCESS_TOKEN env var. */
+    accessToken?: string;
+    /** WhatsApp Business phone number ID. Falls back to WHATSAPP_PHONE_NUMBER_ID env var. */
+    phoneNumberId?: string;
+    /** API version (default "v22.0"). Falls back to WHATSAPP_VERSION env var. */
+    version?: string;
+    /** Default recipient WhatsApp ID. Falls back to WHATSAPP_RECIPIENT_WAID env var. */
+    recipientWaid?: string;
+}
+/**
+ * WhatsApp Toolkit — send messages via WhatsApp Business Cloud API (Meta).
+ *
+ * Uses the WhatsApp Cloud API directly (no Twilio).
+ * Setup: https://developers.facebook.com/docs/whatsapp/cloud-api/get-started
+ *
+ * @example
+ * ```ts
+ * const whatsapp = new WhatsAppToolkit({
+ *   accessToken: "...",
+ *   phoneNumberId: "...",
+ * });
+ * const agent = new Agent({ tools: [...whatsapp.getTools()] });
+ * ```
+ */
+declare class WhatsAppToolkit extends Toolkit {
+    readonly name = "whatsapp";
+    private accessToken;
+    private phoneNumberId;
+    private version;
+    private recipientWaid;
+    constructor(config?: WhatsAppConfig);
+    private getBaseUrl;
+    private validate;
+    private resolveRecipient;
+    getTools(): ToolDef[];
+}
+
+interface HackerNewsConfig {
+    /** Enable fetching top stories (default true). */
+    enableGetTopStories?: boolean;
+    /** Enable fetching user details (default true). */
+    enableGetUserDetails?: boolean;
+}
+/**
+ * Hacker News Toolkit — search top stories and user details from HN.
+ *
+ * No API key required — uses the public Hacker News API.
+ *
+ * @example
+ * ```ts
+ * const hn = new HackerNewsToolkit();
+ * const agent = new Agent({ tools: [...hn.getTools()] });
+ * ```
+ */
+declare class HackerNewsToolkit extends Toolkit {
+    readonly name = "hackernews";
+    private config;
+    constructor(config?: HackerNewsConfig);
+    getTools(): ToolDef[];
+}
+
+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, type GmailConfig, GmailToolkit, GoogleEmbedding, type GoogleEmbeddingConfig, GoogleProvider, type GuardrailResult, type HackerNewsConfig, HackerNewsToolkit, 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, Toolkit, type VectorDocument, type VectorSearchOptions, type VectorSearchResult, type VectorStore, type VertexAIConfig, VertexAIProvider, type WebSearchConfig, WebSearchToolkit, type WhatsAppConfig, WhatsAppToolkit, Workflow, type WorkflowConfig, type WorkflowResult, anthropic, defineTool, getTextContent, google, isMultiModal, ollama, openai, registry, vertex };