@radaros/core 0.3.5 → 0.3.7

package/src/agent/run-context.ts

@@ -1,35 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-import type { EventBus } from "../events/event-bus.js";
-
-export class RunContext {
-  readonly runId: string;
-  readonly sessionId: string;
-  readonly userId?: string;
-  readonly metadata: Record<string, unknown>;
-  readonly eventBus: EventBus;
-  sessionState: Record<string, unknown>;
-
-  constructor(opts: {
-    sessionId: string;
-    userId?: string;
-    metadata?: Record<string, unknown>;
-    eventBus: EventBus;
-    sessionState?: Record<string, unknown>;
-    runId?: string;
-  }) {
-    this.runId = opts.runId ?? uuidv4();
-    this.sessionId = opts.sessionId;
-    this.userId = opts.userId;
-    this.metadata = opts.metadata ?? {};
-    this.eventBus = opts.eventBus;
-    this.sessionState = opts.sessionState ?? {};
-  }
-
-  getState<T>(key: string): T | undefined {
-    return this.sessionState[key] as T | undefined;
-  }
-
-  setState(key: string, value: unknown): void {
-    this.sessionState[key] = value;
-  }
-}

package/src/agent/types.ts

@@ -1,89 +0,0 @@
-import type { z } from "zod";
-import type { ModelProvider } from "../models/provider.js";
-import type { ToolDef, ToolCallResult } from "../tools/types.js";
-import type { Memory } from "../memory/memory.js";
-import type { StorageDriver } from "../storage/driver.js";
-import type { EventBus } from "../events/event-bus.js";
-import type { TokenUsage, StreamChunk, MessageContent, ReasoningConfig } from "../models/types.js";
-import type { RunContext } from "./run-context.js";
-import type { LogLevel } from "../logger/logger.js";
-import type { UserMemory } from "../memory/user-memory.js";
-import type { RetryConfig } from "../utils/retry.js";
-
-export interface AgentConfig {
-  name: string;
-  model: ModelProvider;
-  tools?: ToolDef[];
-  instructions?: string | ((ctx: RunContext) => string);
-  memory?: Memory;
-  storage?: StorageDriver;
-  sessionId?: string;
-  userId?: string;
-  addHistoryToMessages?: boolean;
-  numHistoryRuns?: number;
-  maxToolRoundtrips?: number;
-  temperature?: number;
-  structuredOutput?: z.ZodSchema;
-  hooks?: AgentHooks;
-  guardrails?: {
-    input?: InputGuardrail[];
-    output?: OutputGuardrail[];
-  };
-  eventBus?: EventBus;
-  /** Logging level. Set to "debug" for tool call details, "info" for summaries, "silent" to disable. Default: "silent". */
-  logLevel?: LogLevel;
-  /** Enable extended thinking / reasoning for the model. */
-  reasoning?: ReasoningConfig;
-  /** User-scoped memory for cross-session personalization. */
-  userMemory?: UserMemory;
-  /** Retry configuration for transient LLM API failures (429, 5xx, network errors). */
-  retry?: Partial<RetryConfig>;
-  /** Maximum context window tokens. History is auto-trimmed to fit. */
-  maxContextTokens?: number;
-}
-
-export interface RunOpts {
-  sessionId?: string;
-  userId?: string;
-  metadata?: Record<string, unknown>;
-  /** Per-request API key override passed to the model provider. */
-  apiKey?: string;
-}
-
-export interface RunOutput {
-  text: string;
-  toolCalls: ToolCallResult[];
-  usage: TokenUsage;
-  /** Parsed structured output if structuredOutput schema is set. */
-  structured?: unknown;
-  /** Model's internal reasoning / thinking content (when reasoning is enabled). */
-  thinking?: string;
-  durationMs?: number;
-}
-
-export interface AgentHooks {
-  beforeRun?: (ctx: RunContext) => Promise<void>;
-  afterRun?: (ctx: RunContext, output: RunOutput) => Promise<void>;
-  onToolCall?: (
-    ctx: RunContext,
-    toolName: string,
-    args: unknown
-  ) => Promise<void>;
-  onError?: (ctx: RunContext, error: Error) => Promise<void>;
-}
-
-export type GuardrailResult =
-  | { pass: true }
-  | { pass: false; reason: string };
-
-export interface InputGuardrail {
-  name: string;
-  validate: (input: MessageContent, ctx: RunContext) => Promise<GuardrailResult>;
-}
-
-export interface OutputGuardrail {
-  name: string;
-  validate: (output: RunOutput, ctx: RunContext) => Promise<GuardrailResult>;
-}
-
-export type { StreamChunk };

package/src/events/event-bus.ts

@@ -1,45 +0,0 @@
-import { EventEmitter } from "node:events";
-import type { AgentEventMap } from "./types.js";
-
-type EventKey = keyof AgentEventMap;
-
-export class EventBus {
-  private emitter = new EventEmitter();
-
-  constructor() {
-    this.emitter.setMaxListeners(100);
-  }
-
-  on<K extends EventKey>(
-    event: K,
-    handler: (data: AgentEventMap[K]) => void
-  ): this {
-    this.emitter.on(event, handler as (...args: unknown[]) => void);
-    return this;
-  }
-
-  once<K extends EventKey>(
-    event: K,
-    handler: (data: AgentEventMap[K]) => void
-  ): this {
-    this.emitter.once(event, handler as (...args: unknown[]) => void);
-    return this;
-  }
-
-  off<K extends EventKey>(
-    event: K,
-    handler: (data: AgentEventMap[K]) => void
-  ): this {
-    this.emitter.off(event, handler as (...args: unknown[]) => void);
-    return this;
-  }
-
-  emit<K extends EventKey>(event: K, data: AgentEventMap[K]): boolean {
-    return this.emitter.emit(event, data);
-  }
-
-  removeAllListeners(event?: EventKey): this {
-    this.emitter.removeAllListeners(event);
-    return this;
-  }
-}

package/src/events/types.ts

@@ -1,16 +0,0 @@
-import type { RunOutput } from "../agent/types.js";
-
-export type AgentEventMap = {
-  "run.start": { runId: string; agentName: string; input: string };
-  "run.complete": { runId: string; output: RunOutput };
-  "run.error": { runId: string; error: Error };
-  "run.stream.chunk": { runId: string; chunk: string };
-  "tool.call": { runId: string; toolName: string; args: unknown };
-  "tool.result": { runId: string; toolName: string; result: unknown };
-  "team.delegate": { runId: string; memberId: string; task: string };
-  "workflow.step": {
-    runId: string;
-    stepName: string;
-    status: "start" | "done" | "error";
-  };
-};

package/src/guardrails/types.ts

@@ -1,5 +0,0 @@
-export type {
-  InputGuardrail,
-  OutputGuardrail,
-  GuardrailResult,
-} from "../agent/types.js";

package/src/hooks/types.ts

@@ -1,6 +0,0 @@
-export type {
-  AgentHooks,
-  InputGuardrail,
-  OutputGuardrail,
-  GuardrailResult,
-} from "../agent/types.js";

package/src/index.ts

@@ -1,157 +0,0 @@
-// Agent
-export { Agent } from "./agent/agent.js";
-export { RunContext } from "./agent/run-context.js";
-export { LLMLoop } from "./agent/llm-loop.js";
-export type {
-  AgentConfig,
-  RunOpts,
-  RunOutput,
-  AgentHooks,
-  InputGuardrail,
-  OutputGuardrail,
-  GuardrailResult,
-} from "./agent/types.js";
-
-// Team
-export { Team } from "./team/team.js";
-export { TeamMode } from "./team/types.js";
-export type { TeamConfig } from "./team/types.js";
-
-// Workflow
-export { Workflow } from "./workflow/workflow.js";
-export type {
-  WorkflowConfig,
-  WorkflowResult,
-  StepDef,
-  StepResult,
-  AgentStep,
-  FunctionStep,
-  ConditionStep,
-  ParallelStep,
-} from "./workflow/types.js";
-
-// Models
-export type { ModelProvider } from "./models/provider.js";
-export type {
-  ChatMessage,
-  MessageRole,
-  MessageContent,
-  ContentPart,
-  TextPart,
-  ImagePart,
-  AudioPart,
-  FilePart,
-  ToolCall,
-  ToolDefinition,
-  TokenUsage,
-  ModelResponse,
-  StreamChunk,
-  ModelConfig,
-  ReasoningConfig,
-} from "./models/types.js";
-export { getTextContent, isMultiModal } from "./models/types.js";
-export { ModelRegistry, registry, openai, anthropic, google, ollama, vertex } from "./models/registry.js";
-export { OpenAIProvider } from "./models/providers/openai.js";
-export { AnthropicProvider } from "./models/providers/anthropic.js";
-export { GoogleProvider } from "./models/providers/google.js";
-export { OllamaProvider } from "./models/providers/ollama.js";
-export { VertexAIProvider } from "./models/providers/vertex.js";
-export type { VertexAIConfig } from "./models/providers/vertex.js";
-
-// Tools
-export { defineTool } from "./tools/define-tool.js";
-export { ToolExecutor } from "./tools/tool-executor.js";
-export type { ToolDef, ToolResult, ToolCallResult, Artifact, ToolCacheConfig } from "./tools/types.js";
-
-// Storage
-export type { StorageDriver } from "./storage/driver.js";
-export { InMemoryStorage } from "./storage/in-memory.js";
-export { SqliteStorage } from "./storage/sqlite.js";
-export { PostgresStorage } from "./storage/postgres.js";
-export { MongoDBStorage } from "./storage/mongodb.js";
-
-// Vector Stores
-export type {
-  VectorStore,
-  VectorDocument,
-  VectorSearchResult,
-  VectorSearchOptions,
-  EmbeddingProvider,
-} from "./vector/types.js";
-export { BaseVectorStore } from "./vector/base.js";
-export { InMemoryVectorStore } from "./vector/in-memory.js";
-export { PgVectorStore } from "./vector/pgvector.js";
-export type { PgVectorConfig } from "./vector/pgvector.js";
-export { QdrantVectorStore } from "./vector/qdrant.js";
-export type { QdrantConfig } from "./vector/qdrant.js";
-export { MongoDBVectorStore } from "./vector/mongodb.js";
-export type { MongoDBVectorConfig } from "./vector/mongodb.js";
-
-// Embedding Providers
-export { OpenAIEmbedding } from "./vector/embeddings/openai.js";
-export type { OpenAIEmbeddingConfig } from "./vector/embeddings/openai.js";
-export { GoogleEmbedding } from "./vector/embeddings/google.js";
-export type { GoogleEmbeddingConfig } from "./vector/embeddings/google.js";
-
-// Knowledge Base
-export { KnowledgeBase } from "./knowledge/knowledge-base.js";
-export type { KnowledgeBaseConfig, KnowledgeBaseToolConfig } from "./knowledge/knowledge-base.js";
-
-// Session
-export { SessionManager } from "./session/session-manager.js";
-export type { Session } from "./session/types.js";
-
-// Memory
-export { Memory } from "./memory/memory.js";
-export type { MemoryConfig, MemoryEntry } from "./memory/types.js";
-export { UserMemory } from "./memory/user-memory.js";
-export type { UserMemoryConfig, UserFact } from "./memory/user-memory.js";
-
-// Events
-export { EventBus } from "./events/event-bus.js";
-export type { AgentEventMap } from "./events/types.js";
-
-// Logger
-export { Logger } from "./logger/logger.js";
-export type { LogLevel, LoggerConfig } from "./logger/logger.js";
-
-// Utils
-export { withRetry } from "./utils/retry.js";
-export type { RetryConfig } from "./utils/retry.js";
-
-// MCP
-export { MCPToolProvider } from "./mcp/mcp-client.js";
-export type { MCPToolProviderConfig } from "./mcp/mcp-client.js";
-
-// A2A
-export { A2ARemoteAgent } from "./a2a/a2a-remote-agent.js";
-export type { A2ARemoteAgentConfig } from "./a2a/a2a-remote-agent.js";
-export type {
-  A2AAgentCard,
-  A2ASkill,
-  A2ATask,
-  A2ATaskState,
-  A2AMessage,
-  A2APart,
-  A2ATextPart,
-  A2AFilePart,
-  A2ADataPart,
-  A2AArtifact,
-  A2AJsonRpcRequest,
-  A2AJsonRpcResponse,
-  A2ASendParams,
-  A2ATaskQueryParams,
-} from "./a2a/types.js";
-
-// Toolkits
-export { Toolkit } from "./toolkits/base.js";
-export { WebSearchToolkit } from "./toolkits/websearch.js";
-export type { WebSearchConfig } from "./toolkits/websearch.js";
-export { GmailToolkit } from "./toolkits/gmail.js";
-export type { GmailConfig } from "./toolkits/gmail.js";
-export { WhatsAppToolkit } from "./toolkits/whatsapp.js";
-export type { WhatsAppConfig } from "./toolkits/whatsapp.js";
-export { HackerNewsToolkit } from "./toolkits/hackernews.js";
-export type { HackerNewsConfig } from "./toolkits/hackernews.js";
-export { DuckDuckGoToolkit } from "./toolkits/duckduckgo.js";
-export type { DuckDuckGoConfig } from "./toolkits/duckduckgo.js";

package/src/knowledge/knowledge-base.ts

@@ -1,146 +0,0 @@
-import { z } from "zod";
-import type { ToolDef } from "../tools/types.js";
-import type {
-  VectorStore,
-  VectorDocument,
-  VectorSearchResult,
-  VectorSearchOptions,
-} from "../vector/types.js";
-
-export interface KnowledgeBaseConfig {
-  /** Display name used in tool description auto-generation. */
-  name: string;
-  /** The underlying vector store (any backend). */
-  vectorStore: VectorStore;
-  /** Collection/index name inside the vector store. */
-  collection?: string;
-}
-
-export interface KnowledgeBaseToolConfig {
-  /** Tool name exposed to the LLM. Defaults to `search_<collection>`. */
-  toolName?: string;
-  /** Custom tool description. A sensible default is generated from the KB name. */
-  description?: string;
-  /** Number of results to return per search. Default 5. */
-  topK?: number;
-  /** Minimum similarity score to include. */
-  minScore?: number;
-  /** Metadata filter applied to every search. */
-  filter?: Record<string, unknown>;
-  /** Custom formatter for search results. Defaults to numbered list with scores. */
-  formatResults?: (results: VectorSearchResult[]) => string;
-}
-
-export class KnowledgeBase {
-  readonly name: string;
-  readonly collection: string;
-  private store: VectorStore;
-  private initialized = false;
-
-  constructor(config: KnowledgeBaseConfig) {
-    this.name = config.name;
-    this.store = config.vectorStore;
-    this.collection = config.collection ?? config.name.toLowerCase().replace(/\s+/g, "_");
-  }
-
-  async initialize(): Promise<void> {
-    if (this.initialized) return;
-    await this.store.initialize();
-    this.initialized = true;
-  }
-
-  async add(doc: VectorDocument): Promise<void> {
-    await this.ensureInit();
-    await this.store.upsert(this.collection, doc);
-  }
-
-  async addDocuments(docs: VectorDocument[]): Promise<void> {
-    await this.ensureInit();
-    await this.store.upsertBatch(this.collection, docs);
-  }
-
-  async search(
-    query: string,
-    options?: VectorSearchOptions
-  ): Promise<VectorSearchResult[]> {
-    await this.ensureInit();
-    return this.store.search(this.collection, query, options);
-  }
-
-  async get(id: string): Promise<VectorDocument | null> {
-    await this.ensureInit();
-    return this.store.get(this.collection, id);
-  }
-
-  async delete(id: string): Promise<void> {
-    await this.ensureInit();
-    await this.store.delete(this.collection, id);
-  }
-
-  async clear(): Promise<void> {
-    await this.store.dropCollection(this.collection);
-  }
-
-  async close(): Promise<void> {
-    await this.store.close();
-  }
-
-  /**
-   * Returns a ToolDef that an Agent can use to search this knowledge base.
-   * Plug the result directly into `Agent({ tools: [kb.asTool()] })`.
-   */
-  asTool(config: KnowledgeBaseToolConfig = {}): ToolDef {
-    const topK = config.topK ?? 5;
-    const minScore = config.minScore;
-    const filter = config.filter;
-    const toolName =
-      config.toolName ?? `search_${this.collection}`;
-    const description =
-      config.description ??
-      `Search the "${this.name}" knowledge base for relevant information. Use this before answering questions related to ${this.name}.`;
-
-    const formatResults =
-      config.formatResults ?? defaultFormatResults;
-
-    const kb = this;
-
-    return {
-      name: toolName,
-      description,
-      parameters: z.object({
-        query: z.string().describe("Search query to find relevant documents"),
-      }),
-      execute: async (args: Record<string, unknown>) => {
-        const results = await kb.search(args.query as string, {
-          topK,
-          minScore,
-          filter,
-        });
-
-        if (results.length === 0) {
-          return "No relevant documents found in the knowledge base.";
-        }
-
-        return formatResults(results);
-      },
-    };
-  }
-
-  private async ensureInit(): Promise<void> {
-    if (!this.initialized) await this.initialize();
-  }
-}
-
-function defaultFormatResults(results: VectorSearchResult[]): string {
-  const lines = results.map((r, i) => {
-    const meta = r.metadata
-      ? Object.entries(r.metadata)
-          .filter(([, v]) => v !== undefined)
-          .map(([k, v]) => `${k}: ${v}`)
-          .join(", ")
-      : "";
-    const metaStr = meta ? ` | ${meta}` : "";
-    return `[${i + 1}] (score: ${r.score.toFixed(3)}${metaStr})\n${r.content}`;
-  });
-  return `Found ${results.length} relevant document(s):\n\n${lines.join("\n\n")}`;
-}