@vellumai/plugin-api 0.10.10-dev.202607170310.54734b3 → 0.10.10-dev.202607170655.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;
@@ -3609,6 +3628,31 @@ export declare function isConversationProcessing(id: string): Promise<boolean>;
  */
 export declare function isMaxTokensStopReason(stopReason: string | null | undefined): boolean;
 
+/** A user-role message carrying only tool results, not a fresh prompt. */
+export declare function isToolResultMessage(message: Message): boolean;
+
+/**
+ * Whether a provider error message indicates the model can't accept image
+ * input. Providers wrap raw upstream rejections in their own prose (e.g.
+ * `Anthropic API error (400): …`, `Gemini API error (…): …`), so the classifier
+ * matches the full {@link VISION_NOT_SUPPORTED_PATTERNS} set rather than any
+ * single normalized phrase.
+ */
+export declare function isVisionNotSupportedError(message: string): boolean;
+
+/**
+ * Index of the last user message carrying `tool_result` blocks — the
+ * "current turn" boundary {@link stripOldMediaBlocks} keeps intact while
+ * stripping media from older tool results. Returns -1 when no user message
+ * has tool results.
+ *
+ * Targets the last user message with tool_results (not just the last user
+ * message) because a plain-text user message may follow the tool-result turn;
+ * using the last user message unconditionally would leave the most recent tool
+ * screenshots unprotected from stripping.
+ */
+export declare function lastToolResultUserMessageIndex(history: Message[]): number;
+
 /**
  * The remote skill catalog, fetched via the shared catalog cache. Entries
  * whose declared feature flag is disabled are reported with
@@ -4710,6 +4754,18 @@ declare interface PublishPageResponse {
     errorCode?: string;
 }
 
+/**
+ * Remove every previously-refused exchange from a working history: for each
+ * assistant message that is exactly the refusal fallback, drop it together with
+ * the contiguous run back to (and including) the nearest genuine user prompt.
+ * That excises the flagged prompt (and any tool exchange in that run) so the
+ * provider never replays it. Returns a new array; the input is untouched.
+ */
+export declare function quarantineRefusedExchanges(messages: Message[]): {
+    messages: Message[];
+    droppedExchanges: number;
+};
+
 declare type QuestionRequestEvent = z.infer<typeof QuestionRequestEventSchema>;
 
 declare const QuestionRequestEventSchema: z.ZodObject<{
@@ -4781,6 +4837,19 @@ export declare interface RedactedThinkingContent {
     data: string;
 }
 
+/**
+ * User-facing text a refusal turn is rewritten into (single source of truth for
+ * both the producer — the empty-response plugin's `post-model-call` hook — and
+ * the detector below).
+ *
+ * DETECTION COUPLING: `isRefusalFallbackMessage` matches this string exactly,
+ * so it doubles as the quarantine marker for already-persisted transcripts.
+ * Editing the wording silently stops the sweep from recognizing conversations
+ * poisoned under the old wording (re-introducing the dead-end for that cohort).
+ * If the copy must change, keep matching the historical variants too.
+ */
+export declare const REFUSAL_FALLBACK_TEXT = "Sorry \u2014 I wasn't able to generate a response to that. Please try rephrasing or asking in a different way.";
+
 declare type RelationshipStateUpdatedEvent = z.infer<typeof RelationshipStateUpdatedEventSchema>;
 
 declare const RelationshipStateUpdatedEventSchema: z.ZodObject<{
@@ -5593,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

@@ -4,6 +4,7 @@ export const CLI_COMMAND_HELP = api.CLI_COMMAND_HELP;
 export const CredentialResolutionError = api.CredentialResolutionError;
 export const HOOKS = api.HOOKS;
 export const INTERNAL_NUDGE_OUTPUT_SUPPRESSION = api.INTERNAL_NUDGE_OUTPUT_SUPPRESSION;
+export const REFUSAL_FALLBACK_TEXT = api.REFUSAL_FALLBACK_TEXT;
 export const RiskLevel = api.RiskLevel;
 export const TtsSynthesisError = api.TtsSynthesisError;
 export const addMessage = api.addMessage;
@@ -22,10 +23,14 @@ export const getModelProfiles = api.getModelProfiles;
 export const hasLexicalTokens = api.hasLexicalTokens;
 export const isConversationProcessing = api.isConversationProcessing;
 export const isMaxTokensStopReason = api.isMaxTokensStopReason;
+export const isToolResultMessage = api.isToolResultMessage;
+export const isVisionNotSupportedError = api.isVisionNotSupportedError;
+export const lastToolResultUserMessageIndex = api.lastToolResultUserMessageIndex;
 export const listCatalogSkills = api.listCatalogSkills;
 export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const quarantineRefusedExchanges = api.quarantineRefusedExchanges;
 export const resolveCredential = api.resolveCredential;
 export const resolveMediaSourceData = api.resolveMediaSourceData;
 export const resolveUserName = api.resolveUserName;
@@ -33,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.202607170310.54734b3",
+  "version": "0.10.10-dev.202607170655.fa2b150",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",