@ai-setting/roy-agent-core 1.0.0

package/src/index.ts

@@ -0,0 +1,422 @@
+/**
+ * @roy-agent/core - Core SDK
+ */
+
+// Utils
+export { generateId, generateDescendingId } from "./utils/id";
+
+// Environment
+export {
+  type Environment,
+  BaseEnvironment,
+} from "./env";
+
+export type {
+  EnvironmentConfig,
+  BaseEnvironmentConfig,
+  EnvEvent,
+  EnvEventMetadata,
+  EnvEventHandler,
+  Action,
+  Context,
+} from "./env";
+
+// Component
+export {
+  type Component,
+  type ComponentConfig,
+  type ComponentSchema,
+  type ComponentPaths,
+  type ComponentStatus,
+  type ComponentConfigChangeEvent,
+  type ComponentWatchCallback,
+  BaseComponent,
+} from "./env/component";
+
+// Hook System
+export {
+  globalHookManager,
+  type HookPhase,
+  type HookMeta,
+  type BaseHookContext,  // 通用 HookContext
+  type BaseHook,  // 通用 Hook
+  type BaseHookFn,  // 通用 HookFn
+  type HookManagerOptions,
+  type HookAction,
+  type HookResult,
+  type HookActionType,
+  createHook,
+  createPriorityHook,
+  HookManager,
+} from "./env/hook";
+
+// Paths
+export {
+  type XDGPaths,
+  type XDGDirType,
+  XDG_PATHS,
+  getXDGPaths,
+  getXDGPath,
+} from "./env/paths";
+
+// ConfigComponent
+export {
+  type ConfigSource,
+  type ConfigSourceType,
+  type ConfigChangeEvent,
+  ConfigComponent,
+} from "./config/config-component";
+
+// LLM Component
+export {
+  LLMComponent,
+  type LLMComponentOptions,
+  type LLMMessage,
+  type LLMOutput,
+  type UsageInfo,
+  type ToolCall,
+  type LLMConfig,
+  type LLMProvider,
+  type ProviderConfig,
+  type ProviderType,
+  type LLMInvokeRequest,
+  type LLMInvokeResult,
+  type StreamEvent,
+  invoke,
+  invokeNonStream,
+  parseModelString,
+  createInvokeConfig,
+  type InvokeConfig,
+  type InvokeOptions,
+  type LLMToolContext,
+  type ConvertedUsageInfo,
+  LLMConfigSchema,
+  ProviderConfigSchema,
+  ProviderCapabilitiesSchema,
+  ModelLimitsSchema,
+  LLMDefaultConfigSchema,
+} from "./env/llm";
+
+// Tool Component
+export {
+  ToolComponent,
+  type ToolComponentConfig,
+  type Tool,
+  type ToolInfo,
+  type ToolResult,
+  type ToolResultMetadata,
+  type ToolMetadata,
+  type SandboxConfig,
+  type ValidationResult,
+  ToolRegistry,
+  ToolValidator,
+  getAllBuiltInTools,
+  getBuiltInTool,
+  bashTool,
+  globTool,
+  readFileTool,
+  writeFileTool,
+  editFileTool,
+  grepTool,
+} from "./env/tool";
+
+// Re-export ToolContext from tool (it's defined in tool/types.ts)
+export type { ToolContext } from "./env/tool/types";
+export type { ToolHookContext } from "./env/tool/tool-component";
+
+// Agent Component
+export {
+  AgentComponent,
+  type AgentComponentConfig,
+  type AgentContext,
+  AgentComponentConfigSchema,
+  type Plugin,
+  type HookPoint,
+  type HookContext,  // Agent 特有的 HookContext
+} from "./env/agent";
+
+// Log & Trace Component
+export {
+  LogTraceComponent,
+  type LogTraceConfig,
+  type LogTraceComponentOptions,
+  LogTraceConfigSchema,
+  Traced,
+  TracedAs,
+  TracedLightweight,
+  wrapFunction,
+  type TracedOptions,
+  createLogger,
+  getLogDir,
+  setLogDirOverride,
+  setQuietMode,
+  isQuietMode,
+  getLogLevels,
+  getLogLevel,
+  setLoggerConfigComponent,
+  SQLiteSpanStorage,
+  type SpanContext,
+  type SpanAttributes,
+  type Span,
+  type TraceInfo,
+  type SpanStorage,
+  type LogLevel,
+  type LoggerConfig,
+  type ILogger,
+  SpanKind,
+  SpanStatus,
+  // OpenTelemetry Tracer Provider
+  OTelTracerProvider,
+  getTracerProvider,
+  resetTracerProvider,
+  type OTelTracer,
+  type OTelSpan,
+  type SpanOptions,
+  // OpenTelemetry Propagation
+  propagation,
+} from "./env/log-trace";
+
+// Debug Component
+export {
+  DebugComponent,
+  TraceFormatter,
+  TreeFormatter,
+  ReplFormatter,
+  type TraceDataSource,
+  type TraceParserOptions,
+} from "./env/debug";
+export type {
+  TraceEntry,
+  TraceTreeNode,
+  ParserOptions,
+  LogDiscoveryOptions,
+  TraceIdInfo,
+  TraceSummary,
+  TraceAction,
+  LogLevel as DebugLogLevel,
+  FormatOptions,
+} from "./env/debug";
+
+// Prompt Component
+export {
+  PromptComponent,
+  type PromptComponentOptions,
+} from "./env/prompt/prompt-component";
+
+// Prompt types
+export type {
+  PromptConfig,
+  PromptPath,
+  PromptEntry,
+  PromptSource,
+  PromptHook,
+  RenderHookContext,
+  PromptHookMap,
+} from "./env/prompt/types";
+
+// Session Component
+export {
+  SessionComponent,
+  MemorySessionStore,
+} from "./env/session";
+
+// Session types
+export type {
+  Session,
+  SessionMessage,
+  SessionConfig,
+  CreateSessionOptions,
+  UpdateSessionOptions,
+  ListSessionsOptions,
+  AddMessageOptions,
+  SessionCheckpoint,
+  CompactOptions,
+  CompactResult,
+  CompactPreview,
+  GetContextOptions,
+  GetContextResult,
+  CheckpointType,
+  SearchMessagesOptions,
+  MessageMatch,
+  SearchResult,
+} from "./env/session/types";
+
+// Memory Component - re-export from plugin for backwards compatibility
+// Note: MemoryComponent is exported from ./env/memory/plugin
+// Additional exports for memory-agent-tools and prompts
+export {
+  createMemoryAgentTools,
+} from "./env/memory/tools/memory-agent-tools";
+
+// Memory Agent Tools types
+export type {
+  SearchSessionsParams,
+  GetSessionParams,
+  WriteMemoryParams,
+} from "./env/memory/tools/memory-agent-tools";
+
+// Prompt utilities
+export {
+  getBuiltInPrompt,
+  getBuiltInPromptNames,
+} from "./env/prompt/prompts-index";
+
+// Task Component
+export {
+  TaskComponent,
+} from "./env/task";
+export type {
+  Task,
+  TaskOperation,
+  TaskStatus,
+  TaskPriority,
+  ActionType,
+  CreateTaskOptions,
+  UpdateTaskOptions,
+  ListTasksOptions,
+  CreateOperationOptions,
+  ListOperationsOptions,
+  TaskConfig,
+} from "./env/task/types";
+
+// Task Plugins
+export {
+  TaskPlugin,
+  TaskTagPlugin,
+  type TaskPluginConfig,
+  type TaskPluginHook,
+} from "./env/task/plugins";
+export {
+  TaskHookPoints,
+  type TaskHookPoint,
+} from "./env/task/hooks";
+
+// Skill Component
+export {
+  SkillComponent,
+} from "./env/skill";
+export type {
+  SkillEntry,
+  SkillListItem,
+  SkillConfig,
+  SkillPath,
+  SkillSource,
+  SkillToolParams,
+} from "./env/skill/types";
+
+// Mcp Component
+export {
+  McpComponent,
+} from "./env/mcp";
+export type {
+  McpComponentConfig,
+  McpComponentOptions,
+  McpPath,
+  McpServerConfig,
+  McpServerLocalConfig,
+  McpServerRemoteConfig,
+  McpServerStatus,
+  DiscoveredMcpServer,
+} from "./env/mcp";
+
+// Memory Component
+export {
+  MemoryComponent,
+} from "./env/memory";
+export type {
+  MemoryConfig,
+  MemoryPath,
+  MemorySource,
+  RecordMemoryParams,
+  RecallMemoryParams,
+  RecordMemoryMode,
+  RecordMemoryResult,
+} from "./env/memory/types";
+export type { MemoryComponentOptions } from "./env/memory";
+
+// Memory Plugin (for --plugin memory) - Simplified
+export {
+  MemoryPlugin,
+  createMemoryPlugin,
+} from "./env/memory/plugin";
+export type {
+  MemoryPluginConfig,
+} from "./env/memory/plugin/types";
+
+// Commands Component
+export {
+  CommandsComponent,
+} from "./env/commands";
+export type {
+  CommandsComponentConfig,
+  CommandIndex,
+  ScanResult,
+  ExecutionResult,
+  DiscoverOptions,
+  AddCommandOptions,
+  RemoveCommandOptions,
+  CommandSource,
+  CommandsComponentOptions,
+} from "./env/commands";
+
+// EventSource Component
+export {
+  EventSourceComponent,
+} from "./env/event-source/event-source-component";
+export {
+  EventSourceAgentHandler,
+} from "./env/event-source/event-source-agent-handler";
+export type {
+  EventSourceConfig,
+  EventSourceStatus,
+  EventSourceType,
+  EventSourceEvent,
+  EventSourceEventPayload,
+  EventSourceEventHandler,
+  EventSourceStatusChangeEvent,
+  EventSourcePersistenceConfig,
+  EventSourceComponentInterface,
+  EventSourceAgentHandlerConfig,
+  EventMetadata,
+  RecommendedAction,
+} from "./env/event-source/types";
+
+// Error types
+export {
+  ErrorCodes,
+  RoyError,
+  AgentError,
+  ToolError,
+  LLMError,
+  ComponentError,
+  ContextError,
+  isRoyError,
+  getErrorCode,
+} from "./env/errors";
+
+export type { ErrorCode } from "./env/errors";
+
+// Workflow Component
+export {
+  WorkflowComponent,
+  type WorkflowComponentConfig,
+} from "./env/workflow/workflow-component";
+
+// Workflow Decorators
+export {
+  Workflow,
+  WorkflowEdges,
+  NodeAs,
+  Edge,
+} from "./env/workflow/decorators";
+export type {
+  WorkflowOptions,
+  NodeAsOptions,
+  EdgeMetadata,
+} from "./env/workflow/types/decorators-types";
+export {
+  createWorkflowFromClass,
+} from "./env/workflow/utils/create-workflow";
+export {
+  registerDecoratorNodeType,
+} from "./env/workflow/utils/node-registry-helper";

package/src/utils/id.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview ID Generation Utilities
+ */
+
+/**
+ * Generate a unique ID with optional prefix
+ */
+export function generateId(prefix: string = "id"): string {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 11);
+  return `${prefix}_${timestamp}_${random}`;
+}
+
+/**
+ * Generate a descending ID (useful for creating IDs that sort newest first)
+ */
+export function generateDescendingId(prefix: string = "id"): string {
+  const timestamp = (Number.MAX_SAFE_INTEGER - Date.now()).toString(36);
+  const random = Math.random().toString(36).substring(2, 11);
+  return `${prefix}_${timestamp}_${random}`;
+}