@vellumai/plugin-api 0.10.9-dev.202607162126.2d253b7 → 0.10.9-staging.1

package/index.d.ts

@@ -245,15 +245,15 @@ declare const AssistantActivityStateEventSchema: z.ZodObject<{
     reason: z.ZodEnum<{
         thinking_delta: "thinking_delta";
         generation_cancelled: "generation_cancelled";
-        tool_use_start: "tool_use_start";
-        message_complete: "message_complete";
         message_dequeued: "message_dequeued";
         first_text_delta: "first_text_delta";
+        tool_use_start: "tool_use_start";
         preview_start: "preview_start";
         tool_result_received: "tool_result_received";
         confirmation_requested: "confirmation_requested";
         confirmation_resolved: "confirmation_resolved";
         context_compacting: "context_compacting";
+        message_complete: "message_complete";
         error_terminal: "error_terminal";
     }>;
     requestId: z.ZodOptional<z.ZodString>;
@@ -295,6 +295,10 @@ 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;
             }>>;
@@ -663,7 +667,6 @@ 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<{
@@ -706,6 +709,82 @@ 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";
@@ -719,7 +798,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 minimax: "minimax";
                 atlascloud: "atlascloud";
                 together: "together";
-                baseten: "baseten";
             }>>;
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -852,7 +930,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 minimax: "minimax";
                 atlascloud: "atlascloud";
                 together: "together";
-                baseten: "baseten";
             }>>;
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1177,7 +1254,6 @@ 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>;
@@ -2365,7 +2441,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 | OpenConversationEvent;
+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 ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2386,34 +2462,6 @@ 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";
 }
@@ -3586,17 +3634,6 @@ 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>;
 
@@ -3864,8 +3901,8 @@ declare const messageMetadataSchema: z.ZodObject<{
         status: z.ZodEnum<{
             completed: "completed";
             failed: "failed";
-            aborted: "aborted";
             running: "running";
+            aborted: "aborted";
         }>;
         error: z.ZodOptional<z.ZodString>;
         conversationId: z.ZodOptional<z.ZodString>;
@@ -3896,7 +3933,6 @@ declare const messageMetadataSchema: z.ZodObject<{
     provenanceRequesterIdentifier: z.ZodOptional<z.ZodString>;
     automated: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
-    messageKind: z.ZodOptional<z.ZodString>;
     backgroundToolCompletion: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         toolName: z.ZodString;
@@ -4135,15 +4171,22 @@ declare interface OpenBundleResponse {
     bundleSizeBytes: number;
 }
 
-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>;
+/**
+ * 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 OpenPanelEvent = z.infer<typeof OpenPanelEventSchema>;
 
@@ -4788,16 +4831,6 @@ 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 —
@@ -4877,72 +4910,6 @@ export declare enum RiskLevel {
  */
 declare type RiskLevel_2 = "safe" | "low" | "medium" | "high" | "critical" | "unknown";
 
-/**
- * Run a full conversation agent-loop turn: persist the user message, execute
- * the agent loop (history, tools, compaction, injections), and return the
- * assistant's full content-block response.
- *
- * When `conversationId` is omitted, a new conversation is created and its ID
- * is returned in the result.
- *
- * Events are fanned out to SSE/event-hub subscribers via `broadcastMessage`
- * (the same path the daemon's HTTP message route uses) while also being
- * collected internally so the caller receives the final response content.
- * For streaming use cases, subscribe to the conversation's events via the
- * host event hub (`assistantEventHub`).
- *
- * If the conversation is currently processing another turn, the message is
- * queued via `enqueueMessage` and the result carries `queued: true` with
- * empty content -- the queued turn will execute automatically when the
- * current turn finishes.
- */
-export declare function runConversationTurn(options: RunConversationTurnOptions): Promise<RunConversationTurnResult>;
-
-export declare interface RunConversationTurnOptions {
-    /**
-     * Conversation to run the turn in. If omitted, a new conversation is
-     * created (its ID is generated with `uuidv7` and returned in the result).
-     */
-    conversationId?: string;
-    /**
-     * User message content blocks for this turn. Text blocks become the
-     * user message body; image/file blocks are resolved to inline
-     * attachments. Other block types (tool_use, tool_result, thinking) are
-     * ignored as they are not valid user input.
-     */
-    content: ContentBlock[];
-    /**
-     * LLM call-site for inference profile resolution. Defaults to
-     * `"mainAgent"` inside the agent loop when omitted.
-     */
-    callSite?: LLMCallSite;
-    /**
-     * Abort signal. When aborted, the conversation's internal abort
-     * 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 {
-    /** The assistant's full content blocks for this turn (text, tool_use, etc.). */
-    content: ContentBlock[];
-    /** The user message row ID assigned by the persistence layer. */
-    userMessageId: string;
-    /** The conversation this turn ran in. */
-    conversationId: string;
-    /** True when the message was queued because the conversation was busy. */
-    queued?: boolean;
-}
-
 /**
  * Emitted when the compaction circuit breaker trips. After three consecutive
  * summary-LLM failures (with local fallback covering each), auto-compaction is
@@ -5080,8 +5047,7 @@ 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 the shipped call-site defaults when no callSite-specific entry
-     * is present.
+     * back to `llm.default` when no callSite-specific entry is present.
      */
     callSite?: LLMCallSite;
     /**

package/index.js

@@ -1,9 +1,7 @@
 // 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;
@@ -26,10 +24,8 @@ 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;
 export const searchMessageIdsLexical = api.searchMessageIdsLexical;
 export const selectedBackendSupportsMultimodal = api.selectedBackendSupportsMultimodal;
 export const stringifyMessageContent = api.stringifyMessageContent;

package/package.json

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