@karmaniverous/jeeves-watcher 0.15.2 → 0.16.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import * as _karmaniverous_jsonmap from '@karmaniverous/jsonmap';
 import { JsonMapMap } from '@karmaniverous/jsonmap';
 import { z } from 'zod';
 import Handlebars from 'handlebars';
+import { JeevesComponentDescriptor } from '@karmaniverous/jeeves';
 import { Stats } from 'node:fs';
 
 /**
@@ -1423,6 +1424,7 @@ declare class EventQueue {
     private tokens;
     private lastRefillMs;
     private drainWaiters;
+    private idleWorkerWaiters;
     /**
      * Create an event queue.
      *
@@ -1454,6 +1456,14 @@ declare class EventQueue {
      * @returns A promise that resolves when the queue is drained.
      */
     drain(): Promise<void>;
+    /**
+     * Wait until there is no in-flight work.
+     *
+     * Unlike {@link drain}, this does NOT wait for debounced or queued items to be empty.
+     * It's useful when you need to temporarily quiesce outgoing work without losing
+     * or rejecting new enqueues.
+     */
+    waitForIdleWorkers(): Promise<void>;
     private push;
     private refillTokens;
     private takeToken;
@@ -1461,6 +1471,7 @@ declare class EventQueue {
     private pump;
     private isIdle;
     private maybeResolveDrain;
+    private maybeResolveIdleWorkers;
 }
 
 /**
@@ -1791,7 +1802,12 @@ interface JeevesWatcherFactories {
 /**
  * Create and start a JeevesWatcher from a config file path.
  *
- * @param configPath - Optional path to the configuration file.
+ * When no explicit config path is given, auto-migrates the legacy flat
+ * config (`jeeves-watcher.config.json`) to the namespaced convention
+ * (`jeeves-watcher/config.json`) before loading.
+ *
+ * @param configPath - Optional explicit path to the configuration file.
+ *   When provided, the file is loaded as-is (no migration).
  * @returns The running JeevesWatcher instance.
  */
 declare function startFromConfig(configPath?: string): Promise<JeevesWatcher>;
@@ -1856,6 +1872,18 @@ declare class JeevesWatcher {
  */
 declare function loadConfig(configPath?: string): Promise<JeevesWatcherConfig>;
 
+/**
+ * @module descriptor
+ * Jeeves Component Descriptor for the watcher service. Single source of truth
+ * consumed by core factories (CLI, plugin tools, HTTP handlers, service manager).
+ */
+
+/**
+ * Watcher component descriptor. Single source of truth for service identity,
+ * config schema, and extension points consumed by core factories.
+ */
+declare const watcherDescriptor: JeevesComponentDescriptor;
+
 /**
  * @module extractors
  *
@@ -1901,5 +1929,5 @@ declare function contentHash(text: string): string;
  */
 declare function pointId(filePath: string, chunkIndex?: number): string;
 
-export { ContentHashCache, DocumentProcessor, EnrichmentStore, EventQueue, FileSystemWatcher, GitignoreFilter, InitialScanTracker, IssuesManager, JeevesWatcher, ReindexTracker, SystemHealth, TemplateEngine, ValuesManager, VectorStoreClient, VirtualRuleStore, apiConfigSchema, applyRules, buildAttributes, buildTemplateEngine, compileRules, configWatchConfigSchema, contentHash, createApiServer, createEmbeddingProvider, createHandlebarsInstance, createLogger, embeddingConfigSchema, extractText, inferenceRuleSchema, issueRecordSchema, jeevesWatcherConfigSchema, loadConfig, loadCustomHelpers, loggingConfigSchema, mergeEnrichment, pointId, registerBuiltinHelpers, resolveTemplateSource, startFromConfig, vectorStoreConfigSchema, watchConfigSchema };
+export { ContentHashCache, DocumentProcessor, EnrichmentStore, EventQueue, FileSystemWatcher, GitignoreFilter, InitialScanTracker, IssuesManager, JeevesWatcher, ReindexTracker, SystemHealth, TemplateEngine, ValuesManager, VectorStoreClient, VirtualRuleStore, apiConfigSchema, applyRules, buildAttributes, buildTemplateEngine, compileRules, configWatchConfigSchema, contentHash, createApiServer, createEmbeddingProvider, createHandlebarsInstance, createLogger, embeddingConfigSchema, extractText, inferenceRuleSchema, issueRecordSchema, jeevesWatcherConfigSchema, loadConfig, loadCustomHelpers, loggingConfigSchema, mergeEnrichment, pointId, registerBuiltinHelpers, resolveTemplateSource, startFromConfig, vectorStoreConfigSchema, watchConfigSchema, watcherDescriptor };
 export type { AllHelpersIntrospection, ApiConfig, ApiServerOptions, ApplyRulesOptions, ApplyRulesResult, CollectionInfo, CompiledRule, CompiledTemplate, ConfigWatchConfig, DocumentProcessorDeps, DocumentProcessorInterface, EmbeddingConfig, EmbeddingProvider, EnrichmentStoreInterface, EventQueueOptions, ExtractedText, Extractor, FileAttributes, FileSystemWatcherOptions, HelperModuleIntrospection, InferenceRule, InitialScanStatus, IssueRecord, IssuesFile, JeevesWatcherConfig, JeevesWatcherConfigInput, JeevesWatcherFactories, JeevesWatcherRuntimeOptions, LoggingConfig, PayloadFieldSchema, ProcessFn, ProcessorConfig, ProviderFactory, ReindexStatus, RenderResult, RuleLogger, ScrollPageResult, ScrolledPoint, SearchResult, SystemHealthOptions, ValuesIndex, VectorPoint, VectorStore, VectorStoreConfig, WatchConfig, WatchEvent };