@vellumai/plugin-api 0.10.9 → 0.10.10-dev.202607162206.d08e98e

package/index.d.ts

@@ -295,10 +295,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         "web-fetch": z.ZodDefault<z.ZodObject<{
-            mode: z.ZodDefault<z.ZodEnum<{
-                managed: "managed";
-                "your-own": "your-own";
-            }>>;
             provider: z.ZodDefault<z.ZodEnum<{
                 [x: string]: string;
             }>>;
@@ -308,13 +304,13 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 managed: "managed";
                 "your-own": "your-own";
             }>>;
-            provider: z.ZodEnum<{
+            provider: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
                 vellum: "vellum";
                 deepgram: "deepgram";
                 "google-gemini": "google-gemini";
                 "openai-whisper": "openai-whisper";
                 xai: "xai";
-            }>;
+            }>>;
             providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
         }, z.core.$strip>>;
         tts: z.ZodDefault<z.ZodObject<{
@@ -667,6 +663,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             minCooldownMs: z.ZodDefault<z.ZodNumber>;
             keepSupersededRuns: z.ZodDefault<z.ZodBoolean>;
             matchConversationProfile: z.ZodDefault<z.ZodBoolean>;
+            promptPath: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     monitoring: z.ZodDefault<z.ZodObject<{
@@ -709,82 +706,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
         retentionDays: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     llm: z.ZodDefault<z.ZodObject<{
-        default: z.ZodDefault<z.ZodObject<{
-            provider: z.ZodDefault<z.ZodEnum<{
-                anthropic: "anthropic";
-                openai: "openai";
-                gemini: "gemini";
-                fireworks: "fireworks";
-                openrouter: "openrouter";
-                ollama: "ollama";
-                "vercel-ai-gateway": "vercel-ai-gateway";
-                "openai-compatible": "openai-compatible";
-                minimax: "minimax";
-                atlascloud: "atlascloud";
-                together: "together";
-            }>>;
-            provider_connection: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-            maxTokens: z.ZodDefault<z.ZodNumber>;
-            effort: z.ZodDefault<z.ZodEnum<{
-                low: "low";
-                medium: "medium";
-                high: "high";
-                none: "none";
-                xhigh: "xhigh";
-                max: "max";
-            }>>;
-            speed: z.ZodDefault<z.ZodEnum<{
-                standard: "standard";
-                fast: "fast";
-            }>>;
-            verbosity: z.ZodDefault<z.ZodEnum<{
-                low: "low";
-                medium: "medium";
-                high: "high";
-            }>>;
-            temperature: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-            topP: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-            thinking: z.ZodDefault<z.ZodObject<{
-                enabled: z.ZodDefault<z.ZodBoolean>;
-                streamThinking: z.ZodDefault<z.ZodBoolean>;
-                level: z.ZodOptional<z.ZodEnum<{
-                    low: "low";
-                    medium: "medium";
-                    high: "high";
-                    minimal: "minimal";
-                }>>;
-            }, z.core.$strip>>;
-            contextWindow: z.ZodDefault<z.ZodObject<{
-                enabled: z.ZodDefault<z.ZodBoolean>;
-                maxInputTokens: z.ZodDefault<z.ZodNumber>;
-                targetBudgetRatio: z.ZodDefault<z.ZodNumber>;
-                compactThreshold: z.ZodDefault<z.ZodNumber>;
-                summaryBudgetRatio: z.ZodDefault<z.ZodNumber>;
-                overflowRecovery: z.ZodDefault<z.ZodObject<{
-                    enabled: z.ZodDefault<z.ZodBoolean>;
-                    safetyMarginRatio: z.ZodDefault<z.ZodNumber>;
-                    maxAttempts: z.ZodDefault<z.ZodNumber>;
-                    interactiveLatestTurnCompression: z.ZodDefault<z.ZodEnum<{
-                        truncate: "truncate";
-                        summarize: "summarize";
-                        drop: "drop";
-                    }>>;
-                    nonInteractiveLatestTurnCompression: z.ZodDefault<z.ZodEnum<{
-                        truncate: "truncate";
-                        summarize: "summarize";
-                        drop: "drop";
-                    }>>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>>;
-            openrouter: z.ZodDefault<z.ZodObject<{
-                only: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>;
-            logitBias: z.ZodOptional<z.ZodEnum<{
-                "suppress-cjk": "suppress-cjk";
-            }>>;
-            disableCache: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>;
         profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
                 anthropic: "anthropic";
@@ -798,6 +719,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 minimax: "minimax";
                 atlascloud: "atlascloud";
                 together: "together";
+                baseten: "baseten";
             }>>;
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -930,6 +852,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 minimax: "minimax";
                 atlascloud: "atlascloud";
                 together: "together";
+                baseten: "baseten";
             }>>;
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1254,6 +1177,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             bargeInMinSpeechMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
         maxSessionDurationSeconds: z.ZodDefault<z.ZodNumber>;
+        archiveAudio: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     whatsapp: z.ZodDefault<z.ZodObject<{
         phoneNumber: z.ZodDefault<z.ZodString>;
@@ -2441,7 +2365,7 @@ declare interface ConversationSearchResultItem {
     matchingMessages: ConversationSearchMatchingMessage[];
 }
 
-declare type _ConversationsServerMessages = AuthResult | PongMessage | AssistantStatusMessage | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfo | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompacted | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversation;
+declare type _ConversationsServerMessages = AuthResult | PongMessage | AssistantStatusMessage | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfo | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompacted | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversationEvent;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2462,6 +2386,34 @@ declare interface CopyBlockSurfaceData {
     language?: string;
 }
 
+/**
+ * Plugin-facing credential resolution.
+ *
+ * {@link resolveCredential} returns a stored credential's plaintext value — the
+ * same value `assistant credentials reveal` prints — resolving a reference that
+ * is either a credential UUID or a `"service/field"` string, exactly as the
+ * reveal path does (see {@link ../tools/credentials/resolve.resolveCredentialRef}
+ * and the `credentials/reveal` route).
+ *
+ * ## Plugin scoping
+ *
+ * When a plugin is in context — its hook or tool is executing, tracked by
+ * {@link ../plugins/plugin-execution-context.getCurrentPluginName} — resolution
+ * is restricted: the plugin may only resolve credentials whose `field` equals
+ * the plugin's own manifest name. A plugin named `acme` can therefore read
+ * `openai/acme` or `stripe/acme` but not `openai/api_key`. Outside any plugin
+ * context (host-internal callers, CLI, tests) the resolver is unscoped and
+ * behaves like a direct reveal.
+ */
+/**
+ * Raised when a credential cannot be resolved: the reference does not match a
+ * stored credential, the store is unreachable, or the calling plugin is not
+ * permitted to resolve the requested credential.
+ */
+export declare class CredentialResolutionError extends Error {
+    constructor(message: string);
+}
+
 declare interface CustomSlimSkill extends SlimSkillBase {
     origin: "custom";
 }
@@ -3634,6 +3586,17 @@ declare const INTERFACE_IDS: readonly ["macos", "ios", "cli", "telegram", "phone
 
 declare type InterfaceId = (typeof INTERFACE_IDS)[number];
 
+/**
+ * Appended (inside the `<system_notice>` wrapper) to the internal continuation /
+ * completion nudge strings that re-query the model. Those notices are injected
+ * as user-role turns; weaker models without a separate reasoning channel
+ * otherwise narrate or answer the notice as visible text, leaking agent-loop
+ * scaffolding into the user-facing reply. This clause forbids that narration
+ * without licensing an empty reply — each nudge's own instruction still drives
+ * the expected output (summary / final reply / continuation).
+ */
+export declare const INTERNAL_NUDGE_OUTPUT_SUPPRESSION = " This notice is internal: do not repeat, quote, describe, or acknowledge it, and do not narrate whether you will continue or whether the turn is done. Reply with only the content the user should see.";
+
 /** Whether the conversation currently has a turn in flight. */
 export declare function isConversationProcessing(id: string): Promise<boolean>;
 
@@ -3901,8 +3864,8 @@ declare const messageMetadataSchema: z.ZodObject<{
         status: z.ZodEnum<{
             completed: "completed";
             failed: "failed";
-            running: "running";
             aborted: "aborted";
+            running: "running";
         }>;
         error: z.ZodOptional<z.ZodString>;
         conversationId: z.ZodOptional<z.ZodString>;
@@ -3933,6 +3896,8 @@ declare const messageMetadataSchema: z.ZodObject<{
     provenanceRequesterIdentifier: z.ZodOptional<z.ZodString>;
     automated: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    userMessageSource: z.ZodOptional<z.ZodString>;
+    messageKind: z.ZodOptional<z.ZodString>;
     backgroundToolCompletion: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         toolName: z.ZodString;
@@ -4171,22 +4136,15 @@ declare interface OpenBundleResponse {
     bundleSizeBytes: number;
 }
 
-/**
- * Server push — instructs the client to open and focus a conversation. If
- * the conversation isn't already present in the client's sidebar list (e.g.
- * it was just created via `POST /v1/conversations`), the client should stub
- * a sidebar entry using the provided `title` before navigating.
- */
-declare interface OpenConversation {
-    type: "open_conversation";
-    conversationId: string;
-    /** Optional conversation title; supplied when the client may not yet have the conversation in its list. */
-    title?: string;
-    /** Optional message ID to scroll to after focus. */
-    anchorMessageId?: string;
-    /** When `false`, the client should register the conversation in its sidebar (so it's visible and navigable) but must NOT switch focus to it. Omitting the field defaults to `true` for backward compatibility with existing single-target 'jump to conversation' callers. */
-    focus?: boolean;
-}
+declare type OpenConversationEvent = z.infer<typeof OpenConversationEventSchema>;
+
+declare const OpenConversationEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"open_conversation">;
+    conversationId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    anchorMessageId: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 
 declare type OpenPanelEvent = z.infer<typeof OpenPanelEventSchema>;
 
@@ -4831,6 +4789,16 @@ declare const RelationshipStateUpdatedEventSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 
+/**
+ * Resolve a credential reference to its plaintext value.
+ *
+ * @param ref A credential UUID or a `"service/field"` string.
+ * @returns The plaintext credential value.
+ * @throws {CredentialResolutionError} when the reference does not resolve, the
+ *   store is unreachable, or a plugin in context is not scoped to the credential.
+ */
+export declare function resolveCredential(ref: string): Promise<string>;
+
 /**
  * Plugin-facing read API over the skill surface: the locally installed
  * catalog with resolved enablement states, and the remote skill catalog —
@@ -4954,6 +4922,15 @@ export declare interface RunConversationTurnOptions {
      * controller fires, terminating the in-flight agent loop.
      */
     signal?: AbortSignal;
+    /**
+     * Conversation type for newly created conversations. When omitted,
+     * defaults to `"standard"` (visible in the sidebar). Set to
+     * `"background"` for plugin-driven conversations that should not
+     * appear in the sidebar's Recents grouping.
+     *
+     * Ignored when `conversationId` references an existing conversation.
+     */
+    conversationType?: "standard" | "background";
 }
 
 export declare interface RunConversationTurnResult {
@@ -5104,7 +5081,8 @@ export declare interface SendMessageConfig {
      * LLM call-site identifier. `RetryProvider` resolves
      * provider/model/maxTokens/effort/speed/verbosity/temperature/thinking/
      * contextWindow via `resolveCallSiteConfig(callSite, config.llm)`, falling
-     * back to `llm.default` when no callSite-specific entry is present.
+     * back to the shipped call-site defaults when no callSite-specific entry
+     * is present.
      */
     callSite?: LLMCallSite;
     /**
@@ -6660,6 +6638,15 @@ declare interface UserPromptSubmitInputContext {
      * user speech (e.g. title generation) should skip these turns.
      */
     readonly isHiddenPrompt?: boolean;
+    /**
+     * How the triggering message was initiated when it was sent on the
+     * user's behalf by the UI rather than typed by hand (`body.source` on
+     * `POST /v1/messages`, persisted as `metadata.userMessageSource`).
+     * Current value: `"nav_redirect"` — a navigation shortcut redirected the
+     * user into chat with a pre-filled message. Unset for hand-typed
+     * messages.
+     */
+    readonly messageSource?: string;
     /**
      * The user's original message list, immutable for the hook. Plugins
      * may snapshot or compare against this but MUST NOT mutate it.

package/index.js

@@ -1,7 +1,9 @@
 // Generated by scripts/build-plugin-api.ts — do not edit by hand.
 const api = globalThis[Symbol.for("vellum.plugin-api")] ?? {};
 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 RiskLevel = api.RiskLevel;
 export const TtsSynthesisError = api.TtsSynthesisError;
 export const addMessage = api.addMessage;
@@ -24,6 +26,7 @@ export const listCatalogSkills = api.listCatalogSkills;
 export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const resolveCredential = api.resolveCredential;
 export const resolveMediaSourceData = api.resolveMediaSourceData;
 export const resolveUserName = api.resolveUserName;
 export const runConversationTurn = api.runConversationTurn;

package/package.json

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