@vellumai/plugin-api 0.10.2-dev.202606250318.5e7cfb0 → 0.10.2

package/index.d.ts

@@ -575,27 +575,6 @@ declare const CardSurfaceDataSchema: z.ZodObject<{
     templateData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 
-/**
- * Canonical channel-id vocabulary shared between the assistant daemon and the
- * gateway.
- *
- * A "channel" is an external messaging surface an actor can reach the
- * assistant through (Slack, Telegram, WhatsApp, phone, …) plus a couple of
- * internal ids (`vellum` for native app conversations, `platform` for the
- * internal control plane). This is the single source of truth for that set:
- * the assistant adopts it wholesale as its `ChannelId`, and the gateway
- * asserts its own (narrower) inbound list is a subset of it so the two sides
- * cannot silently drift.
- *
- * Both packages depend on `@vellumai/service-contracts`, so hoisting the set
- * here (rather than maintaining a copy on each side) means adding or renaming
- * a channel happens in exactly one place.
- *
- * Note that a consumer may legitimately handle only a *subset* of these — the
- * gateway, for example, never ingresses `platform`. Use a local list guarded
- * by `satisfies readonly ChannelId[]` for those cases rather than redefining
- * the union.
- */
 declare const CHANNEL_IDS: readonly ["telegram", "phone", "vellum", "whatsapp", "slack", "email", "platform", "a2a"];
 
 /** Channel binding metadata exposed in conversation list APIs. */
@@ -1056,40 +1035,6 @@ declare interface ConversationListResponse {
     hasMore?: boolean;
 }
 
-declare type ConversationNoticeEvent = z.infer<typeof ConversationNoticeEventSchema>;
-
-declare const ConversationNoticeEventSchema: z.ZodObject<{
-    type: z.ZodLiteral<"conversation_notice">;
-    conversationId: z.ZodString;
-    source: z.ZodEnum<{
-        memory_v3: "memory_v3";
-    }>;
-    code: z.ZodEnum<{
-        PROVIDER_NETWORK: "PROVIDER_NETWORK";
-        PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
-        MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
-        PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
-        PROVIDER_API: "PROVIDER_API";
-        IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
-        PROVIDER_BILLING: "PROVIDER_BILLING";
-        PROVIDER_ORDERING: "PROVIDER_ORDERING";
-        PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
-        PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
-        PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
-        MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
-        CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
-        BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
-        MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
-        CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
-        CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
-        DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-        REGENERATE_FAILED: "REGENERATE_FAILED";
-        UNKNOWN: "UNKNOWN";
-    }>;
-    userMessage: z.ZodString;
-    errorCategory: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-
 declare interface ConversationsClearResponse {
     type: "conversations_clear_response";
     cleared: number;
@@ -1116,7 +1061,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 | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversation;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -1300,13 +1245,21 @@ declare interface DocumentSaveResponse {
 declare type _DocumentsServerMessages = DocumentEditorShow | DocumentEditorUpdateEvent | DocumentSaveResponse | DocumentLoadResponse | DocumentListResponse;
 
 /**
- * Whether the given model or profile can process image input.
+ * Whether a profile's resolved model can process image input.
  *
- * `modelOrProfile` may be a concrete model id, a profile key, or a
- * {@link ModelProfileInfo}. A bare string is resolved as a model id first and,
- * failing that, as a profile key. Returns `false` when nothing resolves.
+ * Resolution mirrors the host's call-site resolver:
+ * - The profile's `(provider, model)` fields are merged over `llm.default` so
+ *   a profile that only sets `model` (or only `provider`) inherits the other
+ *   from the workspace default.
+ * - When `provider` is still missing but `model` is a known catalog model,
+ *   the provider is inferred via `getCatalogProviderForModel` (same logic as
+ *   the resolver's `withImpliedProviderForKnownModel`).
+ * - For a mix profile, returns `true` if any constituent arm supports vision
+ *   (the mix can route to it) and `false` only if every arm is text-only.
+ * - Unknown `(provider, model)` pairs default to `true` (fail-open), matching
+ *   the config GET route's `enrichProfilesWithVisionFlag`.
  */
-export declare function doesSupportVision(modelOrProfile: ModelProfileInfo | string): boolean;
+export declare function doesSupportVision(profile: ModelProfileInfo): boolean;
 
 declare interface DynamicPagePreview {
     title: string;
@@ -1425,14 +1378,12 @@ export declare interface FileContent {
     _attachmentId?: string;
 }
 
-declare type FileUploadSurfaceData = z.infer<typeof FileUploadSurfaceDataSchema>;
-
-declare const FileUploadSurfaceDataSchema: z.ZodObject<{
-    prompt: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    acceptedTypes: z.ZodPipe<z.ZodTransform<string[] | undefined, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    maxFiles: z.ZodCatch<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-    maxSizeBytes: z.ZodCatch<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-}, z.core.$strip>;
+declare interface FileUploadSurfaceData {
+    prompt: string;
+    acceptedTypes?: string[];
+    maxFiles?: number;
+    maxSizeBytes?: number;
+}
 
 declare interface FilingConfigResponse {
     type: "filing_config_response";
@@ -2751,13 +2702,15 @@ declare interface PlatformDisconnected {
 export declare type PluginHookFn<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
 
 /**
- * Context passed to `Plugin.init()` during bootstrap. Carries the resolved
- * config, a pino-compatible logger scoped to the plugin, a per-plugin
- * writable data directory, and the assistant's version metadata.
+ * Context passed to `Plugin.init()` during bootstrap. Carries resolved
+ * config/credentials, a pino-compatible logger scoped to the plugin, a
+ * per-plugin writable data directory, and the assistant's version metadata.
  */
 export declare interface PluginInitContext {
     /** Parsed config for this plugin (may be `unknown` until the manifest validates). */
     config: unknown;
+    /** Resolved credential values keyed by the entries of `manifest.requiresCredential`. */
+    credentials: Record<string, string>;
     /** Pino-compatible child logger bound to `{ plugin: <name> }`. */
     logger: PluginLogger;
     /** Absolute path to `<workspaceDir>/plugins-data/<plugin>/` (created by bootstrap). */
@@ -3104,15 +3057,6 @@ export declare interface Provider {
      * Falls back to `name` when unset.
      */
     tokenEstimationProvider?: string;
-    /**
-     * True when this provider instance was constructed to run web search
-     * server-side (provider-native). The native search only activates when a
-     * `web_search`-named tool is passed in the request, so callers that want to
-     * enable web search on a one-shot completion (e.g. the advisor consult) check
-     * this first — passing the tool to a non-native instance would surface an
-     * unexecutable client tool call. Absent/false on providers without it.
-     */
-    supportsNativeWebSearch?: boolean;
     sendMessage(messages: Message[], options?: SendMessageOptions): Promise<ProviderResponse>;
     /**
      * Exact prompt-token count from the provider's own tokenizer, for the
@@ -4080,7 +4024,6 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         host: "host";
     }>>;
     execute: z.ZodOptional<z.ZodCustom<(input: Record<string, unknown>, context: ToolContext) => Promise<ToolExecutionResult>, (input: Record<string, unknown>, context: ToolContext) => Promise<ToolExecutionResult>>>;
-    exclusive: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 
 /**

package/package.json

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