@ai-setting/roy-agent-core 1.6.9 → 1.6.10

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

@@ -0,0 +1,229 @@
+import {
+  envKeyToConfigKey,
+  fromEnvKey,
+  toEnvKey
+} from "./roy-agent-core-7hh0brvs.js";
+
+// src/config/env-source.ts
+class EnvSource {
+  name = "env";
+  priority = 20;
+  prefix;
+  transform;
+  pollInterval;
+  watchers = new Set;
+  pollTimer;
+  lastValues = new Map;
+  watchEnabled = true;
+  constructor(options = {}) {
+    this.prefix = options.prefix ?? "";
+    this.transform = options.transform;
+    this.pollInterval = options.pollInterval;
+    this.watchEnabled = options.watch ?? true;
+  }
+  getEnvKey(key) {
+    return toEnvKey(key, this.prefix);
+  }
+  getInternalKey(envKey) {
+    return fromEnvKey(envKey, this.prefix);
+  }
+  read(key) {
+    const envKey = this.getEnvKey(key);
+    const value = process.env[envKey];
+    if (value === undefined) {
+      return;
+    }
+    if (this.transform) {
+      return this.transform(value, key);
+    }
+    return value;
+  }
+  write(key, value) {
+    const envKey = this.getEnvKey(key);
+    const oldValue = process.env[envKey];
+    const stringValue = String(value);
+    process.env[envKey] = stringValue;
+    const event = {
+      type: oldValue === undefined ? "add" : "change",
+      key,
+      oldValue: oldValue !== undefined ? this.transformValue(oldValue, key) : undefined,
+      newValue: this.transformValue(stringValue, key),
+      source: this.name,
+      timestamp: Date.now()
+    };
+    this.notifyWatchers(event);
+    return true;
+  }
+  delete(key) {
+    const envKey = this.getEnvKey(key);
+    const oldValue = process.env[envKey];
+    if (oldValue === undefined) {
+      return false;
+    }
+    delete process.env[envKey];
+    const event = {
+      type: "delete",
+      key,
+      oldValue: this.transformValue(oldValue, key),
+      newValue: undefined,
+      source: this.name,
+      timestamp: Date.now()
+    };
+    this.notifyWatchers(event);
+    return true;
+  }
+  list() {
+    const result = [];
+    const prefix = this.prefix.toUpperCase();
+    for (const envKey of Object.keys(process.env)) {
+      if (prefix && !envKey.startsWith(prefix)) {
+        continue;
+      }
+      const key = this.getInternalKey(envKey);
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        result.push({
+          key,
+          value: this.transformValue(value, key)
+        });
+      }
+    }
+    return result;
+  }
+  watch(callback) {
+    this.watchers.add(callback);
+    if (!this.watchEnabled) {
+      return () => {
+        this.watchers.delete(callback);
+      };
+    }
+    this.ensurePolling();
+    this.recordCurrentValues();
+    return () => {
+      this.watchers.delete(callback);
+      if (this.watchers.size === 0) {
+        this.stopPolling();
+      }
+    };
+  }
+  ensurePolling() {
+    if (this.pollTimer !== undefined) {
+      return;
+    }
+    const interval = this.pollInterval ?? 1000;
+    this.pollTimer = setInterval(() => {
+      this.checkForChanges();
+    }, interval);
+  }
+  stopPolling() {
+    if (this.pollTimer) {
+      clearInterval(this.pollTimer);
+      this.pollTimer = undefined;
+    }
+  }
+  recordCurrentValues() {
+    this.lastValues.clear();
+    const entries = this.list();
+    for (const entry of entries) {
+      const envKey = this.getEnvKey(entry.key);
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        this.lastValues.set(envKey, value);
+      }
+    }
+  }
+  checkForChanges() {
+    const currentEntries = this.list();
+    const currentValues = new Map;
+    for (const entry of currentEntries) {
+      const envKey = this.getEnvKey(entry.key);
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        currentValues.set(envKey, value);
+      }
+    }
+    for (const [envKey, oldValue] of this.lastValues.entries()) {
+      if (!currentValues.has(envKey)) {
+        const key = this.getInternalKey(envKey);
+        this.notifyWatchers({
+          type: "delete",
+          key,
+          oldValue: this.transformValue(oldValue, key),
+          newValue: undefined,
+          source: this.name,
+          timestamp: Date.now()
+        });
+      }
+    }
+    for (const [envKey, newValue] of currentValues.entries()) {
+      const key = this.getInternalKey(envKey);
+      const oldValue = this.lastValues.get(envKey);
+      if (oldValue === undefined) {
+        this.notifyWatchers({
+          type: "add",
+          key,
+          oldValue: undefined,
+          newValue: this.transformValue(newValue, key),
+          source: this.name,
+          timestamp: Date.now()
+        });
+      } else if (oldValue !== newValue) {
+        this.notifyWatchers({
+          type: "change",
+          key,
+          oldValue: this.transformValue(oldValue, key),
+          newValue: this.transformValue(newValue, key),
+          source: this.name,
+          timestamp: Date.now()
+        });
+      }
+    }
+    this.lastValues = currentValues;
+  }
+  transformValue(value, key) {
+    if (this.transform) {
+      return this.transform(value, key);
+    }
+    return value;
+  }
+  notifyWatchers(event) {
+    this.watchers.forEach((cb) => cb(event));
+  }
+  close() {
+    this.stopPolling();
+    this.watchers.clear();
+  }
+  validateUnrecognizedEnvVars(options = {}) {
+    const { componentName, knownKeys, logger } = options;
+    const prefixUpper = this.prefix.toUpperCase();
+    const unrecognized = [];
+    if (!knownKeys || knownKeys.size === 0) {
+      return unrecognized;
+    }
+    for (const envKey of Object.keys(process.env)) {
+      if (prefixUpper && !envKey.toUpperCase().startsWith(prefixUpper)) {
+        continue;
+      }
+      const configKey = componentName ? envKeyToConfigKey(envKey, this.prefix, componentName) : undefined;
+      const candidateKey = configKey ?? fromEnvKey(envKey, this.prefix).toLowerCase().replace(/_/g, ".");
+      const isKnown = Array.from(knownKeys).some((known) => {
+        if (known === candidateKey)
+          return true;
+        if (candidateKey.startsWith(known + "."))
+          return true;
+        return false;
+      });
+      if (!isKnown) {
+        const valuePreview = JSON.stringify(process.env[envKey]);
+        const truncated = valuePreview.length > 50 ? valuePreview.slice(0, 47) + "..." : valuePreview;
+        const msg = `[EnvSource] Unrecognized env var: ${envKey}=${truncated} ` + `(resolved config key "${candidateKey}" not in known keys: ${Array.from(knownKeys).join(", ") || "<empty>"}). ` + `Check spelling, or add the key to the component's known config keys.`;
+        unrecognized.push(envKey);
+        if (logger?.warn)
+          logger.warn(msg);
+      }
+    }
+    return unrecognized;
+  }
+}
+
+export { EnvSource };

package/dist/shared/@ai-setting/{roy-agent-core-w1e55apa.js → roy-agent-core-z7f8hyv7.js}

@@ -1,7 +1,7 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-g2ntbc33.js";
+} from "./roy-agent-core-jenchn33.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-e25xkv53.js";
 import"./roy-agent-core-dbkkjmqz.js";

package/dist/shared/@ai-setting/{roy-agent-core-sk4xg1dw.js → roy-agent-core-zs31w092.js}

@@ -8,7 +8,7 @@ import {
 import {
   envKeyToConfigKey,
   toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

package/package.json

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