@vellumai/plugin-api 0.10.2-dev.202606242234.c9e9e1d → 0.10.2-dev.202606242332.3fa9b2b

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. */
@@ -1370,12 +1391,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.202606242332.3fa9b2b",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",