@vellumai/plugin-api 0.10.10-dev.202607170508.cf52585 → 0.10.10-dev.202607170744.fa2b150

package/index.d.ts

@@ -2830,6 +2830,25 @@ declare interface GetSigningIdentityRequest {
     requestId: string;
 }
 
+/**
+ * The subset of the Qdrant client the orphan sweep needs, narrowed to an
+ * interface so the sweep can be unit-tested with a fake client.
+ */
+declare interface GraphNodeSweepClient {
+    scrollByTargetType(targetType: string): Promise<Array<{
+        id: string;
+        payload: Record<string, unknown>;
+    }>>;
+    deleteByTarget(targetType: string, targetId: string): Promise<void>;
+}
+
+declare interface GraphNodeSweepResult {
+    /** Distinct `graph_node` target ids currently indexed in Qdrant. */
+    scanned: number;
+    /** Orphan target ids whose Qdrant points were deleted. */
+    deleted: number;
+}
+
 declare interface GuardianActionDecisionResponse {
     type: "guardian_action_decision_response";
     applied: boolean;
@@ -5643,6 +5662,32 @@ declare type SurfaceData = CardSurfaceData | ChoiceSurfaceData | CopyBlockSurfac
 
 declare type _SurfacesServerMessages = UiSurfaceShow | UiSurfaceUpdate | UiSurfaceDismiss | UiSurfaceComplete | UiSurfaceUndoResult;
 
+/**
+ * Delete `graph_node` Qdrant points whose backing `memory_graph_nodes` row no
+ * longer exists.
+ *
+ * `embedAndUpsert` treats the `memory_embeddings` cache write as best-effort: on
+ * a cache-write failure it logs and still upserts the Qdrant point, so a node
+ * can end up with a `graph_node` point but no cache row. Migration 340 discovers
+ * orphans only through cache rows, so those cacheless points survive its sweep;
+ * once migration 323 hard-deletes their backing nodes they keep consuming
+ * `searchGraphNodes` top-K slots (the query hydrates hits from
+ * `memory_graph_nodes` and silently drops rows that are gone).
+ *
+ * This enumerates the authoritative set of indexed `graph_node` points straight
+ * from Qdrant — the only place cacheless points are recorded — and deletes any
+ * whose `target_id` has no row in `memory_graph_nodes`. Membership is
+ * existence-based, matching migration 340: a soft-deleted node keeps its row
+ * (`fidelity = 'gone'`) and therefore its point.
+ *
+ * Idempotent: a second run finds no orphans. Deletion is by Qdrant payload
+ * (`target_type` + `target_id`) via `deleteByTarget`, so it removes cacheless
+ * points a cache lookup could never surface. Each delete goes through the Qdrant
+ * circuit breaker; a transient Qdrant failure propagates so the caller (the
+ * memory worker) can retry the sweep on a later cycle.
+ */
+export declare function sweepOrphanedGraphNodePoints(qdrant: GraphNodeSweepClient): Promise<GraphNodeSweepResult>;
+
 declare type SyncChangedEvent = z.infer<typeof SyncChangedEventSchema>;
 
 declare const SyncChangedEventSchema: z.ZodObject<{

package/index.js

@@ -38,6 +38,7 @@ export const runConversationTurn = api.runConversationTurn;
 export const searchMessageIdsLexical = api.searchMessageIdsLexical;
 export const selectedBackendSupportsMultimodal = api.selectedBackendSupportsMultimodal;
 export const stringifyMessageContent = api.stringifyMessageContent;
+export const sweepOrphanedGraphNodePoints = api.sweepOrphanedGraphNodePoints;
 export const syncMessageToDisk = api.syncMessageToDisk;
 export const synthesizeText = api.synthesizeText;
 export const updateMessageMetadata = api.updateMessageMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.10-dev.202607170508.cf52585",
+  "version": "0.10.10-dev.202607170744.fa2b150",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",