@vellumai/plugin-api 0.10.10-dev.202607170140.fd86251 → 0.10.10-dev.202607170508.cf52585

package/index.d.ts

@@ -3609,6 +3609,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 +4735,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 +4818,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<{

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;

package/package.json

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