@karmaniverous/jeeves-watcher 0.16.3 → 0.17.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
+import { JeevesComponentDescriptor } from '@karmaniverous/jeeves';
 import { FastifyInstance } from 'fastify';
 import pino from 'pino';
 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';
 
 /**
@@ -746,6 +746,8 @@ interface ApplyRulesOptions {
     customMapLib?: Record<string, (...args: unknown[]) => unknown>;
     /** Optional global schemas collection for resolving schema references. */
     globalSchemas?: Record<string, SchemaEntry>;
+    /** Optional callback to extract text from a file path (for fetchSiblings). */
+    extractText?: (filePath: string) => string | undefined;
 }
 /**
  * Apply compiled inference rules to file attributes, returning merged metadata and optional rendered content.
@@ -1703,6 +1705,8 @@ declare class ReindexTracker {
  * Options for {@link createApiServer}.
  */
 interface ApiServerOptions {
+    /** The component descriptor (used for config-apply handler). */
+    descriptor: JeevesComponentDescriptor;
     /** The document processor. */
     processor: DocumentProcessorInterface;
     /** The vector store client. */
@@ -1810,7 +1814,7 @@ interface JeevesWatcherFactories {
  *   When provided, the file is loaded as-is (no migration).
  * @returns The running JeevesWatcher instance.
  */
-declare function startFromConfig(configPath?: string): Promise<JeevesWatcher>;
+declare function startFromConfig(configPath?: string, descriptor?: JeevesComponentDescriptor): Promise<JeevesWatcher>;
 
 /**
  * @module app
@@ -1828,6 +1832,7 @@ interface JeevesWatcherRuntimeOptions {
 declare class JeevesWatcher {
     private config;
     private readonly configPath?;
+    private readonly descriptor;
     private readonly factories;
     private readonly runtimeOptions;
     private logger;
@@ -1848,7 +1853,7 @@ declare class JeevesWatcher {
     private readonly initialScanTracker;
     private readonly version;
     /** Create a new JeevesWatcher instance. */
-    constructor(config: JeevesWatcherConfig, configPath?: string, factories?: Partial<JeevesWatcherFactories>, runtimeOptions?: JeevesWatcherRuntimeOptions);
+    constructor(config: JeevesWatcherConfig, configPath?: string, descriptor?: JeevesComponentDescriptor, factories?: Partial<JeevesWatcherFactories>, runtimeOptions?: JeevesWatcherRuntimeOptions);
     /**
      * Start the watcher, API server, and all components.
      */