@karmaniverous/jeeves-meta 0.6.1 → 0.8.0

package/dist/index.d.ts

@@ -80,8 +80,10 @@ declare const serviceConfigSchema: z.ZodObject<{
     metaProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     metaArchiveProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodString>;
     schedule: z.ZodDefault<z.ZodString>;
     reportChannel: z.ZodOptional<z.ZodString>;
+    serverBaseUrl: z.ZodOptional<z.ZodString>;
     watcherHealthIntervalMs: z.ZodDefault<z.ZodNumber>;
     logging: z.ZodDefault<z.ZodObject<{
         level: z.ZodDefault<z.ZodString>;
@@ -141,6 +143,7 @@ declare const metaJsonSchema: z.ZodObject<{
     _architectTokensAvg: z.ZodOptional<z.ZodNumber>;
     _builderTokensAvg: z.ZodOptional<z.ZodNumber>;
     _criticTokensAvg: z.ZodOptional<z.ZodNumber>;
+    _state: z.ZodOptional<z.ZodUnknown>;
     _error: z.ZodOptional<z.ZodObject<{
         step: z.ZodEnum<{
             architect: "architect";
@@ -256,6 +259,8 @@ interface MetaContext {
     previousFeedback: string | null;
     /** Current _steer value, or null if unset. */
     steer: string | null;
+    /** _state from the last cycle, or null on first run. */
+    previousState: unknown;
     /** Archive snapshot file paths (for steer change detection, etc.). */
     archives: string[];
 }
@@ -794,6 +799,8 @@ interface BuilderOutput {
     content: string;
     /** Additional structured fields (non-underscore keys). */
     fields: Record<string, unknown>;
+    /** Opaque state for progressive synthesis, if provided by the builder. */
+    state?: unknown;
 }
 /**
  * Parse architect output. The architect returns a task brief as text.
@@ -859,6 +866,13 @@ interface MergeOptions {
     criticTokens?: number;
     /** Override output path (default: metaPath/meta.json). Used for lock staging. */
     outputPath?: string;
+    /** Opaque state from builder output for progressive synthesis. */
+    state?: unknown;
+    /**
+     * When true, preserve _content and _generatedAt from current meta.
+     * Used for timeout recovery where state advanced but content did not.
+     */
+    stateOnly?: boolean;
 }
 /**
  * Merge results into meta.json and write atomically.
@@ -890,8 +904,10 @@ type ProgressReporterConfig = {
     gatewayApiKey?: string;
     /** Gateway channel target (platform-agnostic). If unset, reporting is disabled. */
     reportChannel?: string;
+    /** Optional base URL for the service, used to construct entity links. */
+    serverBaseUrl?: string;
 };
-declare function formatProgressEvent(event: ProgressEvent): string;
+declare function formatProgressEvent(event: ProgressEvent, serverBaseUrl?: string): string;
 declare class ProgressReporter {
     private readonly config;
     private readonly logger;
@@ -900,10 +916,7 @@ declare class ProgressReporter {
 }
 
 /**
- * Main orchestration function — the 13-step synthesis cycle.
- *
- * Wires together discovery, scheduling, archiving, executor calls,
- * and merge/write-back.
+ * Main orchestration entry point — discovery, scheduling, candidate selection.
  *
  * @module orchestrator/orchestrate
  */
@@ -1354,9 +1367,9 @@ interface ShutdownDeps {
 declare function registerShutdownHandlers(deps: ShutdownDeps): void;
 
 /**
- * Jeeves Meta Service — knowledge synthesis HTTP service for the Jeeves platform.
+ * Service bootstrap — wire up all components and start listening.
  *
- * @packageDocumentation
+ * @module bootstrap
  */
 
 /**