@vellumai/plugin-api 0.10.2-dev.202606242234.c9e9e1d → 0.10.2-dev.202606250106.466483e

package/index.d.ts

@@ -575,6 +575,27 @@ 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. */
@@ -1035,6 +1056,40 @@ 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;
@@ -1061,7 +1116,7 @@ declare interface ConversationSearchResultItem {
     matchingMessages: ConversationSearchMatchingMessage[];
 }
 
-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 _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>;
 
@@ -1370,12 +1425,14 @@ export declare interface FileContent {
     _attachmentId?: string;
 }
 
-declare interface FileUploadSurfaceData {
-    prompt: string;
-    acceptedTypes?: string[];
-    maxFiles?: number;
-    maxSizeBytes?: number;
-}
+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 FilingConfigResponse {
     type: "filing_config_response";

package/package.json

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