@ai-setting/roy-agent-core 1.5.22 → 1.5.24

package/dist/env/event-source/index.js

@@ -0,0 +1,41 @@
+import"../../shared/@ai-setting/roy-agent-core-2grcjaad.js";
+import {
+  EventSourceComponent,
+  builtInHandlers,
+  getBuiltInHandler,
+  larkCliHandler,
+  timerHandler,
+  websocketHandler
+} from "../../shared/@ai-setting/roy-agent-core-5ex3za0m.js";
+import {
+  BUILT_IN_EVENT_SOURCE_TYPES,
+  BUILT_IN_EVENT_SOURCE_TYPE_LIST,
+  EventSourceInitHooks,
+  getDefaultConfigForType,
+  isBuiltInEventSourceType,
+  isValidEventSourceType,
+  validateEventSourceConfig
+} from "../../shared/@ai-setting/roy-agent-core-avq1x4t7.js";
+import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
+import"../../shared/@ai-setting/roy-agent-core-kkbwepqb.js";
+import"../../shared/@ai-setting/roy-agent-core-2dhd60aw.js";
+import"../../shared/@ai-setting/roy-agent-core-gjq1yk68.js";
+import"../../shared/@ai-setting/roy-agent-core-44hnfb02.js";
+import"../../shared/@ai-setting/roy-agent-core-xs5rsgat.js";
+import"../../shared/@ai-setting/roy-agent-core-psv4v63c.js";
+import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  websocketHandler,
+  validateEventSourceConfig,
+  timerHandler,
+  larkCliHandler,
+  isValidEventSourceType,
+  isBuiltInEventSourceType,
+  getDefaultConfigForType,
+  getBuiltInHandler,
+  builtInHandlers,
+  EventSourceInitHooks,
+  EventSourceComponent,
+  BUILT_IN_EVENT_SOURCE_TYPE_LIST,
+  BUILT_IN_EVENT_SOURCE_TYPES
+};

package/dist/env/index.js

@@ -1,16 +1,18 @@
 import {
-  BaseEnvironment,
-  EventSourceComponent,
-  builtInHandlers,
-  larkCliHandler,
-  timerHandler,
-  websocketHandler
-} from "../shared/@ai-setting/roy-agent-core-rccptwv0.js";
+  BaseEnvironment
+} from "../shared/@ai-setting/roy-agent-core-j1sr5pk9.js";
 import {
   XDG_PATHS,
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
+import {
+  EventSourceComponent,
+  builtInHandlers,
+  larkCliHandler,
+  timerHandler,
+  websocketHandler
+} from "../shared/@ai-setting/roy-agent-core-5ex3za0m.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,

package/dist/index.js

@@ -40,6 +40,7 @@ import {
 import {
   ConfigComponent
 } from "./shared/@ai-setting/roy-agent-core-vn2bc59q.js";
+import"./shared/@ai-setting/roy-agent-core-2grcjaad.js";
 import {
   MemoryComponent
 } from "./shared/@ai-setting/roy-agent-core-4txzpsbt.js";
@@ -62,16 +63,31 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-rvv6ydff.js";
 import {
   BaseEnvironment,
-  EventSourceComponent,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-rccptwv0.js";
+} from "./shared/@ai-setting/roy-agent-core-j1sr5pk9.js";
 import {
   XDG_PATHS,
   getXDGPath,
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"./shared/@ai-setting/roy-agent-core-avq1x4t7.js";
+import {
+  EventSourceComponent,
+  builtInHandlers,
+  getBuiltInHandler,
+  larkCliHandler,
+  timerHandler,
+  websocketHandler
+} from "./shared/@ai-setting/roy-agent-core-5ex3za0m.js";
+import {
+  BUILT_IN_EVENT_SOURCE_TYPES,
+  BUILT_IN_EVENT_SOURCE_TYPE_LIST,
+  EventSourceInitHooks,
+  getDefaultConfigForType,
+  isBuiltInEventSourceType,
+  isValidEventSourceType,
+  validateEventSourceConfig
+} from "./shared/@ai-setting/roy-agent-core-avq1x4t7.js";
 import {
   WorkflowComponent
 } from "./shared/@ai-setting/roy-agent-core-pw7cv1px.js";
@@ -303,6 +319,9 @@ init_node_registry_helper();
 export {
   writeFileTool,
   wrapFunction,
+  websocketHandler,
+  validateEventSourceConfig,
+  timerHandler,
   setQuietMode,
   setConfigComponent as setLoggerConfigComponent,
   setLogDirOverride,
@@ -311,8 +330,11 @@ export {
   readFileTool,
   propagation,
   parseModelString,
+  larkCliHandler,
+  isValidEventSourceType,
   isRoyError,
   isQuietMode,
+  isBuiltInEventSourceType,
   invokeNonStream,
   invoke,
   grepTool,
@@ -325,9 +347,11 @@ export {
   getLogLevel,
   getLogDir,
   getErrorCode,
+  getDefaultConfigForType,
   getBuiltInTool,
   getBuiltInPromptNames,
   getBuiltInPrompt,
+  getBuiltInHandler,
   getAllBuiltInTools,
   generateId,
   generateDescendingId,
@@ -339,6 +363,7 @@ export {
   createLogger,
   createInvokeConfig,
   createHook,
+  builtInHandlers,
   bashTool,
   XDG_PATHS,
   WorkflowEdges,
@@ -381,6 +406,7 @@ export {
   LLMConfigSchema,
   LLMComponent,
   HookManager,
+  EventSourceInitHooks,
   EventSourceComponent,
   ErrorCodes,
   Edge,
@@ -391,6 +417,8 @@ export {
   CommandsComponent,
   BaseEnvironment,
   BaseComponent,
+  BUILT_IN_EVENT_SOURCE_TYPE_LIST,
+  BUILT_IN_EVENT_SOURCE_TYPES,
   AskUserError,
   AgentError,
   AgentComponentConfigSchema,

package/dist/shared/@ai-setting/{roy-agent-core-rccptwv0.js → roy-agent-core-5ex3za0m.js}

@@ -1,452 +1,17 @@
-import {
-  ContextError,
-  ErrorCodes
-} from "./roy-agent-core-ctdhjv68.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
 } from "./roy-agent-core-kkbwepqb.js";
-import {
-  TracedAs,
-  init_decorator
-} from "./roy-agent-core-zgypchmt.js";
 import {
   createLogger,
   init_logger
 } from "./roy-agent-core-44hnfb02.js";
 import {
-  __legacyDecorateClassTS,
   __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
-// src/env/environment.ts
-init_logger();
-
-// src/utils/id.ts
-function generateId(prefix = "id") {
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 11);
-  return `${prefix}_${timestamp}_${random}`;
-}
-function generateDescendingId(prefix = "id") {
-  const timestamp = (Number.MAX_SAFE_INTEGER - Date.now()).toString(36);
-  const random = Math.random().toString(36).substring(2, 11);
-  return `${prefix}_${timestamp}_${random}`;
-}
-
-// src/env/environment.ts
-init_decorator();
-import * as fsSync from "fs";
-import * as path from "path";
-var logger = createLogger("environment");
-
-class BaseEnvironment extends BaseComponent {
-  name;
-  version;
-  components = new Map;
-  constructor(config) {
-    super();
-    this.name = config?.name ?? "base-environment";
-    this.version = config?.version ?? "1.0.0";
-    this.registerDefaultComponents();
-  }
-  registerDefaultComponents() {}
-  getConfig() {
-    return {
-      name: this.name,
-      version: this.version,
-      enabled: true,
-      env: this
-    };
-  }
-  registerComponent(component) {
-    this.components.set(component.name, component);
-    logger.debug(`Component registered: ${component.name}`);
-  }
-  unregisterComponent(name) {
-    const component = this.components.get(name);
-    if (component) {
-      this.components.delete(name);
-      logger.debug(`Component unregistered: ${name}`);
-    }
-  }
-  getComponent(name) {
-    return this.components.get(name);
-  }
-  listComponents() {
-    return Array.from(this.components.values());
-  }
-  async handle_query(query, context) {
-    const agentComponent = this.getComponent("agent");
-    if (!agentComponent) {
-      throw new Error("AgentComponent not found. Please register AgentComponent before calling handle_query.");
-    }
-    let systemPrompt = "You are a helpful assistant.";
-    let promptSource = "fallback";
-    try {
-      const promptComponent = this.getComponent("prompt");
-      if (promptComponent) {
-        const loadedPrompt = await promptComponent.getPrompt("default");
-        if (loadedPrompt) {
-          systemPrompt = loadedPrompt;
-          promptSource = "PromptComponent";
-        }
-      }
-    } catch (err) {
-      logger.warn(`[handle_query] Failed to get prompt from PromptComponent: ${err}`);
-    }
-    logger.info(`[handle_query] Using system prompt from ${promptSource}, length: ${systemPrompt.length}`);
-    let finalSystemPrompt = systemPrompt;
-    if (systemPrompt.includes("{{memory}}")) {
-      try {
-        const memoryComponent = this.getComponent("memory");
-        if (memoryComponent) {
-          const memoryContent = await memoryComponent.recallMemory();
-          finalSystemPrompt = systemPrompt.replace("{{memory}}", memoryContent || "(No memory)");
-          logger.info(`[handle_query] Injected memory content, length: ${memoryContent.length}`);
-        } else {
-          finalSystemPrompt = systemPrompt.replace("{{memory}}", "(Memory component not available)");
-        }
-      } catch (err) {
-        logger.warn(`[handle_query] Failed to load memory content: ${err}`);
-        finalSystemPrompt = systemPrompt.replace("{{memory}}", "(Failed to load memory)");
-      }
-    }
-    if (finalSystemPrompt.includes("{{workspace_dir}}")) {
-      const workspaceDir = process.cwd();
-      finalSystemPrompt = finalSystemPrompt.replace("{{workspace_dir}}", workspaceDir);
-      logger.debug(`[handle_query] Injected workspace_dir: ${workspaceDir}`);
-    }
-    const agentName = context?.agentType && context.agentType !== "default" ? context.agentType : "default";
-    let agent = agentComponent.getAgent(agentName);
-    if (!agent) {
-      if (agentName !== "default") {
-        logger.warn(`[handle_query] Agent "${agentName}" not found, falling back to "default"`);
-      }
-      agent = agentComponent.getAgent("default");
-    }
-    if (!agent) {
-      agent = agentComponent.registerAgent("default", {
-        type: "primary",
-        systemPrompt: finalSystemPrompt
-      });
-    }
-    const result = await agentComponent.run(agent.name, query, context);
-    if (result.error) {
-      const errorMsg = result.error.toLowerCase();
-      if (errorMsg.includes("context") || errorMsg.includes("threshold") || errorMsg.includes("token") || result.error.includes("CTX_001")) {
-        const usageMatch = result.error.match(/(\d+)\/(\d+)\s*\(([\d.]+)%\)/);
-        let usage;
-        let contextWindow;
-        if (usageMatch) {
-          const totalTokens = parseInt(usageMatch[1], 10);
-          usage = {
-            promptTokens: totalTokens,
-            completionTokens: 0,
-            totalTokens
-          };
-          contextWindow = parseInt(usageMatch[2], 10);
-        }
-        const ctxError = new ContextError(result.error, ErrorCodes.CONTEXT_THRESHOLD_EXCEEDED, context?.sessionId, usage, contextWindow);
-        throw ctxError;
-      }
-      throw new Error(result.error);
-    }
-    return result.finalText || "";
-  }
-  async handle_action(action, context) {
-    throw new Error("handle_action not implemented. Override in subclass.");
-  }
-  eventHandlers = new Map;
-  wildcardHandlers = new Set;
-  subscribe(handler) {
-    this.wildcardHandlers.add(handler);
-    logger.debug(`EnvEvent handler subscribed (wildcard)`);
-    return () => {
-      this.wildcardHandlers.delete(handler);
-      logger.debug(`EnvEvent handler unsubscribed (wildcard)`);
-    };
-  }
-  subscribeTo(eventType, handler) {
-    const types = Array.isArray(eventType) ? eventType : [eventType];
-    for (const type of types) {
-      if (!this.eventHandlers.has(type)) {
-        this.eventHandlers.set(type, new Set);
-      }
-      this.eventHandlers.get(type).add(handler);
-    }
-    logger.debug(`EnvEvent handler subscribed for types: ${types.join(", ")}`);
-    return () => {
-      for (const type of types) {
-        this.eventHandlers.get(type)?.delete(handler);
-      }
-      logger.debug(`EnvEvent handler unsubscribed for types: ${types.join(", ")}`);
-    };
-  }
-  subscribeAll(handler) {
-    return this.subscribe(handler);
-  }
-  pushEnvEvent(event) {
-    const fullEvent = "id" in event && event.id ? event : {
-      id: event.id ?? generateId(),
-      type: event.type,
-      timestamp: event.timestamp ?? Date.now(),
-      metadata: {
-        ...event.metadata,
-        env_name: event.metadata?.env_name ?? this.name
-      },
-      payload: event.payload ?? {}
-    };
-    for (const handler of this.wildcardHandlers) {
-      try {
-        handler(fullEvent);
-      } catch (error) {
-        logger.error(`Error in EnvEvent handler: ${error}`);
-      }
-    }
-    const handlers = this.eventHandlers.get(fullEvent.type);
-    if (handlers) {
-      for (const handler of handlers) {
-        try {
-          handler(fullEvent);
-        } catch (error) {
-          logger.error(`Error in EnvEvent handler for ${fullEvent.type}: ${error}`);
-        }
-      }
-    }
-  }
-  emit(type, payload, metadata) {
-    const event = {
-      id: generateId(),
-      type,
-      timestamp: Date.now(),
-      metadata: {
-        env_name: this.name,
-        ...metadata
-      },
-      payload
-    };
-    this.pushEnvEvent(event);
-  }
-  async initializeComponents() {
-    logger.debug(`Starting component initialization, total: ${this.components.size}`);
-    const configComp = this.components.get("config");
-    if (configComp && configComp.getStatus() === "created") {
-      logger.debug(`Initializing ConfigComponent first...`);
-      await configComp.init({
-        name: "config",
-        version: configComp.version,
-        enabled: true,
-        env: this
-      });
-      logger.debug(`ConfigComponent initialized`);
-    } else {
-      logger.debug(`No ConfigComponent found, skipping first stage`);
-    }
-    const otherComponents = Array.from(this.components.values()).filter((c) => c.getStatus() === "created");
-    if (otherComponents.length > 0) {
-      logger.debug(`Initializing ${otherComponents.length} other components...`);
-      for (const component of otherComponents) {
-        logger.debug(`Initializing component: ${component.name}`);
-        await component.init({
-          name: component.name,
-          version: component.version,
-          enabled: true,
-          env: this
-        });
-        logger.debug(`Component initialized: ${component.name}`);
-      }
-    }
-    logger.debug(`All components initialized`);
-  }
-  async startComponents() {
-    const allComponents = Array.from(this.components.values());
-    if (allComponents.length > 0) {
-      logger.debug(`Starting ${allComponents.length} components...`);
-      for (const component of allComponents) {
-        logger.debug(`Starting component: ${component.name} (current status: ${component.getStatus()})`);
-        await component.start();
-        logger.debug(`Component started: ${component.name}`);
-      }
-    }
-  }
-  async stopComponents() {
-    const componentsToStop = Array.from(this.components.values()).filter((c) => c.getStatus() !== "stopped");
-    if (componentsToStop.length > 0) {
-      logger.debug(`Stopping ${componentsToStop.length} components...`);
-      for (const component of componentsToStop) {
-        logger.debug(`Stopping component: ${component.name}`);
-        await component.stop();
-        logger.debug(`Component stopped: ${component.name}`);
-      }
-    }
-  }
-  async onInit() {
-    await this.initializeComponents();
-    logger.info(`Environment "${this.name}" initialized`);
-  }
-  async onStart() {
-    await this.startComponents();
-    logger.info(`Environment "${this.name}" started`);
-  }
-  async onStop() {
-    await this.stopComponents();
-    this.eventHandlers.clear();
-    this.wildcardHandlers.clear();
-    logger.info(`Environment "${this.name}" stopped`);
-  }
-  async init() {
-    Object.defineProperty(this, "env", {
-      value: this,
-      writable: true,
-      enumerable: false,
-      configurable: true
-    });
-    this.setStatus("initializing");
-    await this.onInit();
-    this.setStatus("running");
-  }
-  async start() {
-    if (this._started)
-      return;
-    this._started = true;
-    await this.onStart();
-    this.setStatus("running");
-    logger.info(`Environment "${this.name}" started`);
-  }
-  async stop() {
-    this.setStatus("stopping");
-    await this.onStop();
-    this.setStatus("stopped");
-  }
-  async loadServiceConfig(configPath) {
-    const configComponent = this.getComponent("config");
-    if (!configComponent) {
-      throw new Error("ConfigComponent not found. Please register ConfigComponent before loading service config.");
-    }
-    const xdgDataHome = configComponent.getXdgDataHome();
-    const fullPath = path.resolve(xdgDataHome, configPath);
-    if (!fsSync.existsSync(fullPath)) {
-      throw new Error(`Service config file not found: ${fullPath}`);
-    }
-    const content = fsSync.readFileSync(fullPath, "utf-8");
-    let config;
-    try {
-      config = JSON.parse(content);
-    } catch (e) {
-      throw new Error(`Failed to parse service config: ${e}`);
-    }
-    logger.debug(`Service config loaded from: ${fullPath}`);
-    return config;
-  }
-  generateComponentOptions(componentName, configEntry) {
-    const configComponent = this.getComponent("config");
-    if (!configComponent) {
-      throw new Error("ConfigComponent not found. Please register ConfigComponent before generating component options.");
-    }
-    const options = {
-      configComponent,
-      configPath: configEntry.configPath,
-      envPrefix: configEntry.envPrefix,
-      config: configEntry.config
-    };
-    logger.debug(`Generated options for component: ${componentName}`);
-    return options;
-  }
-  async registerComponentWithConfig(component, configEntry) {
-    if (!this.components.has(component.name)) {
-      this.registerComponent(component);
-    }
-    const options = this.generateComponentOptions(component.name, configEntry);
-    if (component.getStatus() === "running") {
-      logger.debug(`Component ${component.name} already initialized, skipping`);
-      return;
-    }
-    await component.init({
-      name: component.name,
-      version: component.version,
-      enabled: configEntry.enabled ?? true,
-      env: this,
-      options
-    });
-    logger.debug(`Component ${component.name} registered and initialized with config`);
-  }
-  async initFromConfig(configPath) {
-    if (!this.env) {
-      Object.defineProperty(this, "env", {
-        value: this,
-        writable: true,
-        enumerable: false,
-        configurable: true
-      });
-    }
-    const serviceConfig = await this.loadServiceConfig(configPath);
-    if (serviceConfig.environment) {
-      if (serviceConfig.environment.name) {
-        this.name = serviceConfig.environment.name;
-      }
-      if (serviceConfig.environment.version) {
-        this.version = serviceConfig.environment.version;
-      }
-    }
-    const configComponent = this.getComponent("config");
-    if (!configComponent) {
-      throw new Error("ConfigComponent not found. Please register ConfigComponent before initFromConfig.");
-    }
-    if (configComponent.getStatus() === "created") {
-      await configComponent.init({
-        name: "config",
-        version: configComponent.version,
-        enabled: true,
-        env: this
-      });
-    }
-    const components = serviceConfig.components || {};
-    for (const [componentName, configEntry] of Object.entries(components)) {
-      if (configEntry.enabled === false) {
-        logger.debug(`Component ${componentName} is disabled, skipping`);
-        continue;
-      }
-      const component = this.getComponent(componentName);
-      if (!component) {
-        logger.warn(`Component ${componentName} not registered, skipping`);
-        continue;
-      }
-      if (component.name === "config")
-        continue;
-      await this.registerComponentWithConfig(component, configEntry);
-    }
-    this.setStatus("running");
-    logger.info(`Environment "${this.name}" initialized from config: ${configPath}`);
-  }
-}
-__legacyDecorateClassTS([
-  TracedAs("env.handle_query", { recordParams: true, recordResult: true, log: true })
-], BaseEnvironment.prototype, "handle_query", null);
-// src/env/event-source/event-source-component.ts
-import { join } from "path";
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-init_logger();
-
-// src/env/event-source/event-source-config-registration.ts
-var EVENT_SOURCE_DEFAULTS = {
-  "event-source.enabled": true,
-  "event-source.persistenceEnabled": true
-};
-var EVENT_SOURCE_CONFIG_REGISTRATION = {
-  name: "event-source",
-  sources: [
-    { type: "env", envPrefix: "EVENT_SOURCE", priority: 20, watch: false }
-  ],
-  keys: [
-    { key: "event-source.enabled", sources: ["env", "file"] },
-    { key: "event-source.persistenceEnabled", sources: ["env", "file"] },
-    { key: "event-source.configPath", sources: ["env", "file"] }
-  ]
-};
-
 // src/env/event-source/event-source-handlers.ts
 import { spawn } from "child_process";
 function matchEventType(eventType, patterns) {
@@ -596,7 +161,7 @@ class LarkCliInstance {
         this.status = "error";
       }
     });
-    await new Promise((resolve2) => setTimeout(resolve2, 1000));
+    await new Promise((resolve) => setTimeout(resolve, 1000));
     this.status = "running";
   }
   async stop() {
@@ -789,7 +354,7 @@ class WebSocketInstance {
     this.ws.on("close", () => {
       this.status = "stopped";
     });
-    await new Promise((resolve2) => setTimeout(resolve2, 5000));
+    await new Promise((resolve) => setTimeout(resolve, 5000));
   }
   async stop() {
     if (this.ws) {
@@ -865,9 +430,34 @@ var builtInHandlers = [
   timerHandler,
   websocketHandler
 ];
+function getBuiltInHandler(type) {
+  return builtInHandlers.find((h) => h.type === type);
+}
+
+// src/env/event-source/event-source-component.ts
+import { join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+init_logger();
+
+// src/env/event-source/event-source-config-registration.ts
+var EVENT_SOURCE_DEFAULTS = {
+  "event-source.enabled": true,
+  "event-source.persistenceEnabled": true
+};
+var EVENT_SOURCE_CONFIG_REGISTRATION = {
+  name: "event-source",
+  sources: [
+    { type: "env", envPrefix: "EVENT_SOURCE", priority: 20, watch: false }
+  ],
+  keys: [
+    { key: "event-source.enabled", sources: ["env", "file"] },
+    { key: "event-source.persistenceEnabled", sources: ["env", "file"] },
+    { key: "event-source.configPath", sources: ["env", "file"] }
+  ]
+};
 
 // src/env/event-source/event-source-component.ts
-var logger2 = createLogger("event-source");
+var logger = createLogger("event-source");
 
 class EventSourceComponent extends BaseComponent {
   name = "event-source";
@@ -929,7 +519,7 @@ class EventSourceComponent extends BaseComponent {
     for (const handler of builtInHandlers) {
       if (!this.handlers.has(handler.type)) {
         this.handlers.set(handler.type, handler);
-        logger2.debug(`Registered built-in handler: ${handler.type}`);
+        logger.debug(`Registered built-in handler: ${handler.type}`);
       }
     }
   }
@@ -939,15 +529,15 @@ class EventSourceComponent extends BaseComponent {
   }
   registerHandler(handler) {
     if (this.handlers.has(handler.type)) {
-      logger2.warn(`Handler already registered for type: ${handler.type}, overwriting`);
+      logger.warn(`Handler already registered for type: ${handler.type}, overwriting`);
     }
     this.handlers.set(handler.type, handler);
-    logger2.debug(`Handler registered: ${handler.type}`);
+    logger.debug(`Handler registered: ${handler.type}`);
   }
   unregisterHandler(type) {
     const deleted = this.handlers.delete(type);
     if (deleted) {
-      logger2.debug(`Handler unregistered: ${type}`);
+      logger.debug(`Handler unregistered: ${type}`);
     }
     return deleted;
   }
@@ -1037,7 +627,7 @@ class EventSourceComponent extends BaseComponent {
     });
   }
   onConfigChange(event) {
-    logger2.info(`EventSource config changed: ${event.key}`, {
+    logger.info(`EventSource config changed: ${event.key}`, {
       oldValue: event.oldValue,
       newValue: event.newValue
     });
@@ -1056,9 +646,9 @@ class EventSourceComponent extends BaseComponent {
     }
     this.sources.set(config.id, config);
     this.statuses.set(config.id, "created");
-    logger2.debug(`EventSource registered: ${config.id} (${config.type})`);
+    logger.debug(`EventSource registered: ${config.id} (${config.type})`);
     this.saveConfig().catch((err) => {
-      logger2.error(`Failed to save config after registering ${config.id}:`, err);
+      logger.error(`Failed to save config after registering ${config.id}:`, err);
     });
   }
   unregister(id) {
@@ -1073,9 +663,9 @@ class EventSourceComponent extends BaseComponent {
     this.eventHandlers.delete(id);
     this.buffers.delete(id);
     if (existed) {
-      logger2.debug(`EventSource unregistered: ${id}`);
+      logger.debug(`EventSource unregistered: ${id}`);
       this.saveConfig().catch((err) => {
-        logger2.error(`Failed to save config after unregistering ${id}:`, err);
+        logger.error(`Failed to save config after unregistering ${id}:`, err);
       });
     }
     return existed;
@@ -1133,18 +723,18 @@ class EventSourceComponent extends BaseComponent {
         type: "event-source.started",
         payload: { sourceId: id, sourceType: config.type }
       });
-      logger2.info(`EventSource started: ${id} (${config.type})`);
+      logger.info(`EventSource started: ${id} (${config.type})`);
     } catch (error) {
       this.statuses.set(id, "error");
-      logger2.error(`EventSource failed to start: ${id}`, error);
+      logger.error(`EventSource failed to start: ${id}`, error);
       throw error;
     }
   }
   async stopSource(id) {
     const status = this.statuses.get(id);
-    logger2.info(`[EventSource ${id}] stopSource called, current status: ${status}`);
+    logger.info(`[EventSource ${id}] stopSource called, current status: ${status}`);
     if (status === "stopped" || status === "created") {
-      logger2.info(`[EventSource ${id}] already stopped/created, skipping`);
+      logger.info(`[EventSource ${id}] already stopped/created, skipping`);
       return;
     }
     this.statuses.set(id, "stopping");
@@ -1160,10 +750,10 @@ class EventSourceComponent extends BaseComponent {
         type: "event-source.stopped",
         payload: { sourceId: id, sourceType: config?.type }
       });
-      logger2.info(`EventSource stopped: ${id}`);
+      logger.info(`EventSource stopped: ${id}`);
     } catch (error) {
       this.statuses.set(id, "error");
-      logger2.error(`EventSource failed to stop: ${id}`, error);
+      logger.error(`EventSource failed to stop: ${id}`, error);
       throw error;
     }
   }
@@ -1173,7 +763,7 @@ class EventSourceComponent extends BaseComponent {
     }
     const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
     const dataDir = join(home, ".roy-agent");
-    if (!existsSync2(dataDir)) {
+    if (!existsSync(dataDir)) {
       mkdirSync(dataDir, { recursive: true });
     }
     return join(dataDir, "event-sources.json");
@@ -1188,9 +778,9 @@ class EventSourceComponent extends BaseComponent {
         sources: Array.from(this.sources.values())
       };
       writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-      logger2.debug(`Saved ${this.sources.size} event source configurations`);
+      logger.debug(`Saved ${this.sources.size} event source configurations`);
     } catch (error) {
-      logger2.error("Failed to save event source configurations:", error);
+      logger.error("Failed to save event source configurations:", error);
       throw error;
     }
   }
@@ -1199,14 +789,14 @@ class EventSourceComponent extends BaseComponent {
       return;
     try {
       const configPath = this.getConfigFilePath();
-      if (!existsSync2(configPath)) {
-        logger2.debug(`No event source config file found at ${configPath}`);
+      if (!existsSync(configPath)) {
+        logger.debug(`No event source config file found at ${configPath}`);
         return;
       }
-      const content = readFileSync2(configPath, "utf-8");
+      const content = readFileSync(configPath, "utf-8");
       const config = JSON.parse(content);
       if (!config.sources || !Array.isArray(config.sources)) {
-        logger2.warn("Invalid event source config format, skipping load");
+        logger.warn("Invalid event source config format, skipping load");
         return;
       }
       let loadedCount = 0;
@@ -1217,10 +807,11 @@ class EventSourceComponent extends BaseComponent {
           loadedCount++;
         }
       }
-      logger2.info(`Loaded ${loadedCount} event source configurations`);
+      logger.info(`Loaded ${loadedCount} event source configurations`);
     } catch (error) {
-      logger2.error("Failed to load event source configurations:", error);
+      logger.error("Failed to load event source configurations:", error);
     }
   }
 }
-export { generateId, generateDescendingId, BaseEnvironment, larkCliHandler, timerHandler, websocketHandler, builtInHandlers, EventSourceComponent };
+
+export { larkCliHandler, timerHandler, websocketHandler, builtInHandlers, getBuiltInHandler, EventSourceComponent };

package/dist/shared/@ai-setting/roy-agent-core-j1sr5pk9.js

@@ -0,0 +1,424 @@
+import {
+  ContextError,
+  ErrorCodes
+} from "./roy-agent-core-ctdhjv68.js";
+import {
+  BaseComponent
+} from "./roy-agent-core-kkbwepqb.js";
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-zgypchmt.js";
+import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-44hnfb02.js";
+import {
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/environment.ts
+init_logger();
+
+// src/utils/id.ts
+function generateId(prefix = "id") {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 11);
+  return `${prefix}_${timestamp}_${random}`;
+}
+function generateDescendingId(prefix = "id") {
+  const timestamp = (Number.MAX_SAFE_INTEGER - Date.now()).toString(36);
+  const random = Math.random().toString(36).substring(2, 11);
+  return `${prefix}_${timestamp}_${random}`;
+}
+
+// src/env/environment.ts
+init_decorator();
+import * as fsSync from "fs";
+import * as path from "path";
+var logger = createLogger("environment");
+
+class BaseEnvironment extends BaseComponent {
+  name;
+  version;
+  components = new Map;
+  constructor(config) {
+    super();
+    this.name = config?.name ?? "base-environment";
+    this.version = config?.version ?? "1.0.0";
+    this.registerDefaultComponents();
+  }
+  registerDefaultComponents() {}
+  getConfig() {
+    return {
+      name: this.name,
+      version: this.version,
+      enabled: true,
+      env: this
+    };
+  }
+  registerComponent(component) {
+    this.components.set(component.name, component);
+    logger.debug(`Component registered: ${component.name}`);
+  }
+  unregisterComponent(name) {
+    const component = this.components.get(name);
+    if (component) {
+      this.components.delete(name);
+      logger.debug(`Component unregistered: ${name}`);
+    }
+  }
+  getComponent(name) {
+    return this.components.get(name);
+  }
+  listComponents() {
+    return Array.from(this.components.values());
+  }
+  async handle_query(query, context) {
+    const agentComponent = this.getComponent("agent");
+    if (!agentComponent) {
+      throw new Error("AgentComponent not found. Please register AgentComponent before calling handle_query.");
+    }
+    let systemPrompt = "You are a helpful assistant.";
+    let promptSource = "fallback";
+    try {
+      const promptComponent = this.getComponent("prompt");
+      if (promptComponent) {
+        const loadedPrompt = await promptComponent.getPrompt("default");
+        if (loadedPrompt) {
+          systemPrompt = loadedPrompt;
+          promptSource = "PromptComponent";
+        }
+      }
+    } catch (err) {
+      logger.warn(`[handle_query] Failed to get prompt from PromptComponent: ${err}`);
+    }
+    logger.info(`[handle_query] Using system prompt from ${promptSource}, length: ${systemPrompt.length}`);
+    let finalSystemPrompt = systemPrompt;
+    if (systemPrompt.includes("{{memory}}")) {
+      try {
+        const memoryComponent = this.getComponent("memory");
+        if (memoryComponent) {
+          const memoryContent = await memoryComponent.recallMemory();
+          finalSystemPrompt = systemPrompt.replace("{{memory}}", memoryContent || "(No memory)");
+          logger.info(`[handle_query] Injected memory content, length: ${memoryContent.length}`);
+        } else {
+          finalSystemPrompt = systemPrompt.replace("{{memory}}", "(Memory component not available)");
+        }
+      } catch (err) {
+        logger.warn(`[handle_query] Failed to load memory content: ${err}`);
+        finalSystemPrompt = systemPrompt.replace("{{memory}}", "(Failed to load memory)");
+      }
+    }
+    if (finalSystemPrompt.includes("{{workspace_dir}}")) {
+      const workspaceDir = process.cwd();
+      finalSystemPrompt = finalSystemPrompt.replace("{{workspace_dir}}", workspaceDir);
+      logger.debug(`[handle_query] Injected workspace_dir: ${workspaceDir}`);
+    }
+    const agentName = context?.agentType && context.agentType !== "default" ? context.agentType : "default";
+    let agent = agentComponent.getAgent(agentName);
+    if (!agent) {
+      if (agentName !== "default") {
+        logger.warn(`[handle_query] Agent "${agentName}" not found, falling back to "default"`);
+      }
+      agent = agentComponent.getAgent("default");
+    }
+    if (!agent) {
+      agent = agentComponent.registerAgent("default", {
+        type: "primary",
+        systemPrompt: finalSystemPrompt
+      });
+    }
+    const result = await agentComponent.run(agent.name, query, context);
+    if (result.error) {
+      const errorMsg = result.error.toLowerCase();
+      if (errorMsg.includes("context") || errorMsg.includes("threshold") || errorMsg.includes("token") || result.error.includes("CTX_001")) {
+        const usageMatch = result.error.match(/(\d+)\/(\d+)\s*\(([\d.]+)%\)/);
+        let usage;
+        let contextWindow;
+        if (usageMatch) {
+          const totalTokens = parseInt(usageMatch[1], 10);
+          usage = {
+            promptTokens: totalTokens,
+            completionTokens: 0,
+            totalTokens
+          };
+          contextWindow = parseInt(usageMatch[2], 10);
+        }
+        const ctxError = new ContextError(result.error, ErrorCodes.CONTEXT_THRESHOLD_EXCEEDED, context?.sessionId, usage, contextWindow);
+        throw ctxError;
+      }
+      throw new Error(result.error);
+    }
+    return result.finalText || "";
+  }
+  async handle_action(action, context) {
+    throw new Error("handle_action not implemented. Override in subclass.");
+  }
+  eventHandlers = new Map;
+  wildcardHandlers = new Set;
+  subscribe(handler) {
+    this.wildcardHandlers.add(handler);
+    logger.debug(`EnvEvent handler subscribed (wildcard)`);
+    return () => {
+      this.wildcardHandlers.delete(handler);
+      logger.debug(`EnvEvent handler unsubscribed (wildcard)`);
+    };
+  }
+  subscribeTo(eventType, handler) {
+    const types = Array.isArray(eventType) ? eventType : [eventType];
+    for (const type of types) {
+      if (!this.eventHandlers.has(type)) {
+        this.eventHandlers.set(type, new Set);
+      }
+      this.eventHandlers.get(type).add(handler);
+    }
+    logger.debug(`EnvEvent handler subscribed for types: ${types.join(", ")}`);
+    return () => {
+      for (const type of types) {
+        this.eventHandlers.get(type)?.delete(handler);
+      }
+      logger.debug(`EnvEvent handler unsubscribed for types: ${types.join(", ")}`);
+    };
+  }
+  subscribeAll(handler) {
+    return this.subscribe(handler);
+  }
+  pushEnvEvent(event) {
+    const fullEvent = "id" in event && event.id ? event : {
+      id: event.id ?? generateId(),
+      type: event.type,
+      timestamp: event.timestamp ?? Date.now(),
+      metadata: {
+        ...event.metadata,
+        env_name: event.metadata?.env_name ?? this.name
+      },
+      payload: event.payload ?? {}
+    };
+    for (const handler of this.wildcardHandlers) {
+      try {
+        handler(fullEvent);
+      } catch (error) {
+        logger.error(`Error in EnvEvent handler: ${error}`);
+      }
+    }
+    const handlers = this.eventHandlers.get(fullEvent.type);
+    if (handlers) {
+      for (const handler of handlers) {
+        try {
+          handler(fullEvent);
+        } catch (error) {
+          logger.error(`Error in EnvEvent handler for ${fullEvent.type}: ${error}`);
+        }
+      }
+    }
+  }
+  emit(type, payload, metadata) {
+    const event = {
+      id: generateId(),
+      type,
+      timestamp: Date.now(),
+      metadata: {
+        env_name: this.name,
+        ...metadata
+      },
+      payload
+    };
+    this.pushEnvEvent(event);
+  }
+  async initializeComponents() {
+    logger.debug(`Starting component initialization, total: ${this.components.size}`);
+    const configComp = this.components.get("config");
+    if (configComp && configComp.getStatus() === "created") {
+      logger.debug(`Initializing ConfigComponent first...`);
+      await configComp.init({
+        name: "config",
+        version: configComp.version,
+        enabled: true,
+        env: this
+      });
+      logger.debug(`ConfigComponent initialized`);
+    } else {
+      logger.debug(`No ConfigComponent found, skipping first stage`);
+    }
+    const otherComponents = Array.from(this.components.values()).filter((c) => c.getStatus() === "created");
+    if (otherComponents.length > 0) {
+      logger.debug(`Initializing ${otherComponents.length} other components...`);
+      for (const component of otherComponents) {
+        logger.debug(`Initializing component: ${component.name}`);
+        await component.init({
+          name: component.name,
+          version: component.version,
+          enabled: true,
+          env: this
+        });
+        logger.debug(`Component initialized: ${component.name}`);
+      }
+    }
+    logger.debug(`All components initialized`);
+  }
+  async startComponents() {
+    const allComponents = Array.from(this.components.values());
+    if (allComponents.length > 0) {
+      logger.debug(`Starting ${allComponents.length} components...`);
+      for (const component of allComponents) {
+        logger.debug(`Starting component: ${component.name} (current status: ${component.getStatus()})`);
+        await component.start();
+        logger.debug(`Component started: ${component.name}`);
+      }
+    }
+  }
+  async stopComponents() {
+    const componentsToStop = Array.from(this.components.values()).filter((c) => c.getStatus() !== "stopped");
+    if (componentsToStop.length > 0) {
+      logger.debug(`Stopping ${componentsToStop.length} components...`);
+      for (const component of componentsToStop) {
+        logger.debug(`Stopping component: ${component.name}`);
+        await component.stop();
+        logger.debug(`Component stopped: ${component.name}`);
+      }
+    }
+  }
+  async onInit() {
+    await this.initializeComponents();
+    logger.info(`Environment "${this.name}" initialized`);
+  }
+  async onStart() {
+    await this.startComponents();
+    logger.info(`Environment "${this.name}" started`);
+  }
+  async onStop() {
+    await this.stopComponents();
+    this.eventHandlers.clear();
+    this.wildcardHandlers.clear();
+    logger.info(`Environment "${this.name}" stopped`);
+  }
+  async init() {
+    Object.defineProperty(this, "env", {
+      value: this,
+      writable: true,
+      enumerable: false,
+      configurable: true
+    });
+    this.setStatus("initializing");
+    await this.onInit();
+    this.setStatus("running");
+  }
+  async start() {
+    if (this._started)
+      return;
+    this._started = true;
+    await this.onStart();
+    this.setStatus("running");
+    logger.info(`Environment "${this.name}" started`);
+  }
+  async stop() {
+    this.setStatus("stopping");
+    await this.onStop();
+    this.setStatus("stopped");
+  }
+  async loadServiceConfig(configPath) {
+    const configComponent = this.getComponent("config");
+    if (!configComponent) {
+      throw new Error("ConfigComponent not found. Please register ConfigComponent before loading service config.");
+    }
+    const xdgDataHome = configComponent.getXdgDataHome();
+    const fullPath = path.resolve(xdgDataHome, configPath);
+    if (!fsSync.existsSync(fullPath)) {
+      throw new Error(`Service config file not found: ${fullPath}`);
+    }
+    const content = fsSync.readFileSync(fullPath, "utf-8");
+    let config;
+    try {
+      config = JSON.parse(content);
+    } catch (e) {
+      throw new Error(`Failed to parse service config: ${e}`);
+    }
+    logger.debug(`Service config loaded from: ${fullPath}`);
+    return config;
+  }
+  generateComponentOptions(componentName, configEntry) {
+    const configComponent = this.getComponent("config");
+    if (!configComponent) {
+      throw new Error("ConfigComponent not found. Please register ConfigComponent before generating component options.");
+    }
+    const options = {
+      configComponent,
+      configPath: configEntry.configPath,
+      envPrefix: configEntry.envPrefix,
+      config: configEntry.config
+    };
+    logger.debug(`Generated options for component: ${componentName}`);
+    return options;
+  }
+  async registerComponentWithConfig(component, configEntry) {
+    if (!this.components.has(component.name)) {
+      this.registerComponent(component);
+    }
+    const options = this.generateComponentOptions(component.name, configEntry);
+    if (component.getStatus() === "running") {
+      logger.debug(`Component ${component.name} already initialized, skipping`);
+      return;
+    }
+    await component.init({
+      name: component.name,
+      version: component.version,
+      enabled: configEntry.enabled ?? true,
+      env: this,
+      options
+    });
+    logger.debug(`Component ${component.name} registered and initialized with config`);
+  }
+  async initFromConfig(configPath) {
+    if (!this.env) {
+      Object.defineProperty(this, "env", {
+        value: this,
+        writable: true,
+        enumerable: false,
+        configurable: true
+      });
+    }
+    const serviceConfig = await this.loadServiceConfig(configPath);
+    if (serviceConfig.environment) {
+      if (serviceConfig.environment.name) {
+        this.name = serviceConfig.environment.name;
+      }
+      if (serviceConfig.environment.version) {
+        this.version = serviceConfig.environment.version;
+      }
+    }
+    const configComponent = this.getComponent("config");
+    if (!configComponent) {
+      throw new Error("ConfigComponent not found. Please register ConfigComponent before initFromConfig.");
+    }
+    if (configComponent.getStatus() === "created") {
+      await configComponent.init({
+        name: "config",
+        version: configComponent.version,
+        enabled: true,
+        env: this
+      });
+    }
+    const components = serviceConfig.components || {};
+    for (const [componentName, configEntry] of Object.entries(components)) {
+      if (configEntry.enabled === false) {
+        logger.debug(`Component ${componentName} is disabled, skipping`);
+        continue;
+      }
+      const component = this.getComponent(componentName);
+      if (!component) {
+        logger.warn(`Component ${componentName} not registered, skipping`);
+        continue;
+      }
+      if (component.name === "config")
+        continue;
+      await this.registerComponentWithConfig(component, configEntry);
+    }
+    this.setStatus("running");
+    logger.info(`Environment "${this.name}" initialized from config: ${configPath}`);
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("env.handle_query", { recordParams: true, recordResult: true, log: true })
+], BaseEnvironment.prototype, "handle_query", null);
+export { generateId, generateDescendingId, BaseEnvironment };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.22",
+  "version": "1.5.24",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",