@ponraaj/dimple-sdk 0.0.0-alpha.12 → 0.0.0-alpha.14

package/dist/dimple.d.ts

@@ -1,4 +1,5 @@
 import { Effect } from "effect";
+import { type QueueStat } from "./internal/workflow/index.js";
 import type { QueryProfile } from "./internal/retriever/index.js";
 import type { CoreInterface } from "./internal/core/index.js";
 import type { CodeExtractor } from "./internal/extractor/index.js";
@@ -126,6 +127,18 @@ export interface ReloadResult {
  * Every method runs the underlying Effect at the boundary, remaps errors
  * onto the closed `DimpleError` hierarchy, and never leaks Effect types.
  */
+/**
+ * `Dimple.health` — the topic-tree invariant sweep plus durable-queue drain
+ * state. `jobs` counts outstanding elements per job queue
+ * (`DurableQueue/<job name>`): offered and not yet finished — in-flight work
+ * included. The internal resume-signal queue is excluded (its rows outlive
+ * the work they point at), so an empty array genuinely means "everything
+ * drained". This is what answers "is the deferred index still embedding?"
+ * after `index({ deferEmbed: true })`.
+ */
+export interface DimpleHealth extends TopicHealth {
+    readonly jobs: readonly QueueStat[];
+}
 export interface Dimple {
     /** The config-default embedding model's key — what `dream`/`repair`/
      * `stats` use when no model is passed. */
@@ -179,10 +192,18 @@ export interface Dimple {
         readonly maxTotal?: number;
         readonly includePending?: boolean;
     }) => Promise<ExplainResult>;
-    readonly health: (modelKey: string) => Promise<TopicHealth>;
+    /**
+     * Status report for one model's tree: the invariant sweep PLUS durable-queue
+     * drain state (`jobs`) — pending elements per queue, so callers can tell
+     * whether deferred work (index embeddings, splits, audit writes) is still in
+     * flight. `jobs: []` means every queue is empty.
+     */
+    readonly health: (modelKey: string) => Promise<DimpleHealth>;
     readonly graph: {
         readonly addEdge: (input: AddEdgeInput) => Promise<ArtifactEdge>;
-        readonly candidates: () => Promise<GraphCandidatesResult>;
+        readonly candidates: (options?: {
+            readonly limit?: number;
+        }) => Promise<GraphCandidatesResult>;
         readonly coverage: (modelKey: string) => Promise<GraphCoverage>;
         /** Promote a pending edge to confirmed (for `memory_supersedes` the
          * old endpoint flips to superseded in the same transaction). */