@karmaniverous/jeeves 0.5.7 → 0.5.8

package/dist/cli/jeeves/index.js

@@ -269,14 +269,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.6` placeholder is replaced by
+ * The `0.5.7` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.6';
+const CORE_VERSION = '0.5.7';
 
 /**
  * Runtime Node.js version floor check.
@@ -444,6 +444,7 @@ function init(options) {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
         coreConfigDir: join(options.configRoot, CORE_CONFIG_DIR),
+        componentConfigPaths: new Map(),
     };
 }
 /**

package/dist/cli/plugin/index.js

@@ -130,14 +130,14 @@ const COMPONENT_VERSIONS_FILE = 'component-versions.json';
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.6` placeholder is replaced by
+ * The `0.5.7` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.6';
+const CORE_VERSION = '0.5.7';
 
 /**
  * Shared file I/O helpers for managed section operations.
@@ -386,6 +386,7 @@ function init(options) {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
         coreConfigDir: join(options.configRoot, CORE_CONFIG_DIR),
+        componentConfigPaths: new Map(),
     };
 }
 /**

package/dist/cli/service/index.js

@@ -261,6 +261,7 @@ function init(options) {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
         coreConfigDir: join(options.configRoot, CORE_CONFIG_DIR),
+        componentConfigPaths: new Map(),
     };
 }
 /**

package/dist/index.d.ts

@@ -652,7 +652,8 @@ interface AsyncContentCacheOptions {
     placeholder?: string;
     /**
      * Optional error handler. Called when `fetch` throws.
-     * Defaults to `console.warn`.
+     * Defaults to a handler that logs transient network errors as
+     * concise warnings and unexpected errors with full details.
      */
     onError?: (error: unknown) => void;
 }
@@ -1111,6 +1112,28 @@ declare function getCoreConfigFile(): string;
  * @throws Error if `init()` has not been called.
  */
 declare function getComponentConfigDir(componentName: string): string;
+/**
+ * Register the actual config file path for a component.
+ *
+ * @remarks
+ * Call this after resolving the `--config` CLI argument so that
+ * `getComponentConfigPath` returns the real file location instead of
+ * the default derived from `configRoot`.
+ *
+ * @param componentName - The component name (e.g., 'watcher', 'runner').
+ * @param absolutePath - Absolute path to the component's config file.
+ * @throws Error if `init()` has not been called.
+ */
+declare function registerComponentConfigPath(componentName: string, absolutePath: string): void;
+/**
+ * Get the registered config file path for a component, or `undefined`
+ * if no override has been registered.
+ *
+ * @param componentName - The component name.
+ * @returns The registered absolute path, or `undefined`.
+ * @throws Error if `init()` has not been called.
+ */
+declare function getComponentConfigPath(componentName: string): string | undefined;
 /**
  * Reset initialization state. Used for testing only.
  */
@@ -1895,5 +1918,26 @@ interface ServiceManager {
  */
 declare function createServiceManager(descriptor: JeevesComponentDescriptor): ServiceManager;
 
-export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
+/**
+ * Shared internal utility functions.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Extract a human-readable message from an unknown caught value.
+ *
+ * @param err - The caught value (typically `unknown`).
+ * @returns The error message string.
+ */
+declare function getErrorMessage(err: unknown): string;
+/**
+ * Classify whether an error is a transient network failure.
+ *
+ * @param err - The caught value.
+ * @returns `true` for ECONNRESET, ETIMEDOUT, UND_ERR_CONNECT_TIMEOUT,
+ *          AbortError, and timeout-related fetch errors.
+ */
+declare function isTransientError(err: unknown): boolean;
+
+export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getComponentConfigPath, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getErrorMessage, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, isTransientError, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, registerComponentConfigPath, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
 export type { AccountConfig, AsyncContentCacheOptions, ComponentDependencies, ComponentState, ComponentVersionEntry, ComponentVersionsState, ComponentWriterOptions, ConfigApplyHandler, ConfigApplyRequest, ConfigApplyResult, ConfigProvenance, ConfigQueryHandler, ConfigQueryResponse, CoreConfig, CreatePluginCliOptions, CreateStatusHandlerOptions, GoogleAuthOptions, HeartbeatEntry, InitOptions, JeevesComponentDescriptor, ManagedMarkers, ManagedSection, MemoryHygieneOptions, MemoryHygieneResult, OrchestrateHeartbeatOptions, ParseManagedResult, ParsedHeartbeat, PlatformComponent, PluginApi, PluginInstallRecord, RefreshPlatformContentOptions, RemoveManagedSectionOptions, ResolvedCliConfig, ResolvedValue, RetryOptions, RunOptions, SectionId, SeedContentOptions, ServiceAccountFileConfig, ServiceManager, ServiceManagerOptions, ServiceState, SlackWorkspaceOptions, StatusHandler, StatusHandlerResult, StatusResponse, ToolDescriptor, ToolRegistrationOptions, ToolResult, UpdateManagedSectionOptions, VersionStamp, WorkspaceConfig, WorkspaceOptions, WriteComponentVersionOptions };

package/dist/index.js

@@ -183,14 +183,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.6` placeholder is replaced by
+ * The `0.5.7` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.6';
+const CORE_VERSION = '0.5.7';
 
 /**
  * Workspace and config root initialization.
@@ -213,6 +213,7 @@ function init(options) {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
         coreConfigDir: join(options.configRoot, CORE_CONFIG_DIR),
+        componentConfigPaths: new Map(),
     };
 }
 /**
@@ -267,6 +268,36 @@ function getComponentConfigDir(componentName) {
         throw new Error('jeeves-core: init() must be called first');
     return join(state.configRoot, `${COMPONENT_CONFIG_PREFIX}${componentName}`);
 }
+/**
+ * Register the actual config file path for a component.
+ *
+ * @remarks
+ * Call this after resolving the `--config` CLI argument so that
+ * `getComponentConfigPath` returns the real file location instead of
+ * the default derived from `configRoot`.
+ *
+ * @param componentName - The component name (e.g., 'watcher', 'runner').
+ * @param absolutePath - Absolute path to the component's config file.
+ * @throws Error if `init()` has not been called.
+ */
+function registerComponentConfigPath(componentName, absolutePath) {
+    if (!state)
+        throw new Error('jeeves-core: init() must be called first');
+    state.componentConfigPaths.set(componentName, absolutePath);
+}
+/**
+ * Get the registered config file path for a component, or `undefined`
+ * if no override has been registered.
+ *
+ * @param componentName - The component name.
+ * @returns The registered absolute path, or `undefined`.
+ * @throws Error if `init()` has not been called.
+ */
+function getComponentConfigPath(componentName) {
+    if (!state)
+        throw new Error('jeeves-core: init() must be called first');
+    return state.componentConfigPaths.get(componentName);
+}
 /**
  * Reset initialization state. Used for testing only.
  */
@@ -410,6 +441,32 @@ async function withWorkspaceLock(workspacePath, fn) {
 function getErrorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
+/** Error codes / names that indicate transient network failures. */
+const TRANSIENT_CODES = new Set([
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'AbortError',
+]);
+/**
+ * Classify whether an error is a transient network failure.
+ *
+ * @param err - The caught value.
+ * @returns `true` for ECONNRESET, ETIMEDOUT, UND_ERR_CONNECT_TIMEOUT,
+ *          AbortError, and timeout-related fetch errors.
+ */
+function isTransientError(err) {
+    let current = err;
+    while (current instanceof Error) {
+        if (TRANSIENT_CODES.has(current.name))
+            return true;
+        const code = current.code;
+        if (typeof code === 'string' && TRANSIENT_CODES.has(code))
+            return true;
+        current = current.cause;
+    }
+    return false;
+}
 
 /**
  * Factory for a framework-agnostic config apply HTTP handler.
@@ -484,9 +541,9 @@ function readConfigFile(filePath) {
 function createConfigApplyHandler(descriptor) {
     return async (request) => {
         const { patch, replace } = request;
-        // Derive config path
-        const configDir = getComponentConfigDir(descriptor.name);
-        const configPath = join(configDir, descriptor.configFileName);
+        // Use registered config path if available, otherwise derive from configRoot
+        const configPath = getComponentConfigPath(descriptor.name) ??
+            join(getComponentConfigDir(descriptor.name), descriptor.configFileName);
         // Read existing config
         const existing = readConfigFile(configPath);
         // Merge or replace
@@ -4803,7 +4860,12 @@ class ComponentWriter {
  */
 function createAsyncContentCache(options) {
     const { fetch: fetchContent, placeholder = '> Initializing...', onError = (err) => {
-        console.warn('[jeeves] async content cache refresh failed:', err);
+        if (isTransientError(err)) {
+            console.warn(`[jeeves] cache refresh: transient error (${getErrorMessage(err)})`);
+        }
+        else {
+            console.warn('[jeeves] cache refresh failed:', err);
+        }
     }, } = options;
     let cached = placeholder;
     let refreshing = false;
@@ -5323,4 +5385,4 @@ async function getChannelWorkspace(channelId, token, options) {
     return teamId;
 }
 
-export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
+export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getComponentConfigPath, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getErrorMessage, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, isTransientError, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, registerComponentConfigPath, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };

package/package.json

@@ -139,5 +139,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.5.7"
+  "version": "0.5.8"
 }