@vellumai/plugin-api 0.10.11-dev.202607241335.d95a4c6 → 0.10.11-dev.202607241439.ab7e771

package/index.d.ts

@@ -210,15 +210,6 @@ declare const AssistantActivityStateEventSchema: z.ZodObject<{
     statusText: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-/** Attention state metadata for a conversation's latest assistant message. */
-declare interface AssistantAttention {
-    hasUnseenLatestAssistantMessage: boolean;
-    latestAssistantMessageAt?: number;
-    lastSeenAssistantMessageAt?: number;
-    lastSeenConfidence?: string;
-    lastSeenSignalType?: string;
-}
-
 declare type AssistantConfig = z.infer<typeof AssistantConfigSchema>;
 
 declare const AssistantConfigSchema: z.ZodObject<{
@@ -1641,32 +1632,6 @@ export declare function buildMessageExcerpt(rawContent: string, query: string):
  */
 declare const CHANNEL_IDS: readonly ["telegram", "phone", "vellum", "whatsapp", "slack", "email", "platform", "a2a"];
 
-/** Channel binding metadata exposed in conversation list APIs. */
-declare interface ChannelBinding {
-    sourceChannel: ChannelId;
-    externalChatId: string;
-    externalChatName?: string | null;
-    externalThreadId?: string | null;
-    externalUserId?: string | null;
-    displayName?: string | null;
-    username?: string | null;
-    slackThread?: {
-        channelId: string;
-        threadTs: string;
-        link?: {
-            appUrl?: string;
-            webUrl?: string;
-        };
-    };
-    slackChannel?: {
-        channelId: string;
-        name?: string;
-        link?: {
-            webUrl?: string;
-        };
-    };
-}
-
 declare type ChannelId = (typeof CHANNEL_IDS)[number];
 
 declare interface ChannelVerificationSessionResponse {
@@ -2009,12 +1974,6 @@ declare const ConversationErrorEventSchema: z.ZodObject<{
     profileName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare interface ConversationForkParent {
-    conversationId: string;
-    messageId: string;
-    title: string;
-}
-
 declare type ConversationInferenceProfileUpdatedEvent = z.infer<typeof ConversationInferenceProfileUpdatedEventSchema>;
 
 declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
@@ -2025,19 +1984,6 @@ declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
     expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 
-declare interface ConversationInfo {
-    type: "conversation_info";
-    conversationId: string;
-    title: string;
-    correlationId?: string;
-    conversationType?: ConversationType;
-    /**
-     * Per-conversation override for the LLM inference profile. `undefined`
-     * means the conversation inherits the workspace `llm.activeProfile`.
-     */
-    inferenceProfile?: string;
-}
-
 declare type ConversationListInvalidatedEvent = z.infer<typeof ConversationListInvalidatedEventSchema>;
 
 declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
@@ -2051,33 +1997,6 @@ declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 
-declare interface ConversationListResponse {
-    type: "conversation_list_response";
-    conversations: Array<{
-        id: string;
-        title: string;
-        createdAt?: number;
-        updatedAt: number;
-        conversationType?: ConversationType;
-        source?: string;
-        scheduleJobId?: string;
-        channelBinding?: ChannelBinding;
-        conversationOriginChannel?: ChannelId;
-        conversationOriginInterface?: InterfaceId;
-        assistantAttention?: AssistantAttention;
-        displayOrder?: number;
-        isPinned?: boolean;
-        forkParent?: ConversationForkParent;
-        /**
-         * Per-conversation override for the LLM inference profile. Omitted when
-         * the conversation inherits the workspace `llm.activeProfile`.
-         */
-        inferenceProfile?: string;
-    }>;
-    /** Whether more conversations exist beyond the returned page. */
-    hasMore?: boolean;
-}
-
 declare type ConversationNoticeEvent = z.infer<typeof ConversationNoticeEventSchema>;
 
 declare const ConversationNoticeEventSchema: z.ZodObject<{
@@ -2155,7 +2074,7 @@ export declare interface ConversationRow {
  */
 export declare type ConversationsClearedContext = BaseHookContext;
 
-declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
+declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | UsageUpdateEvent | UsageProgressEvent | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationTitleUpdatedEvent | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2165,10 +2084,8 @@ declare const ConversationTitleUpdatedEventSchema: z.ZodObject<{
     title: z.ZodString;
 }, z.core.$strip>;
 
-declare type ConversationType = "standard" | "background" | "scheduled";
-
 /** Read-side alias of {@link ConversationCreateType}. */
-declare type ConversationType_2 = ConversationCreateType;
+declare type ConversationType = ConversationCreateType;
 
 /** Create a live voice connection bound to the caller's `send` transport. */
 export declare function createLiveVoiceConnection(options: {
@@ -2506,99 +2423,6 @@ declare const HeartbeatConversationCreatedEventSchema: z.ZodObject<{
     title: z.ZodString;
 }, z.core.$strip>;
 
-declare interface HistoryResponse {
-    type: "history_response";
-    conversationId: string;
-    messages: Array<{
-        /** Database ID used by clients for the rendered message. */
-        id?: string;
-        role: string;
-        text: string;
-        timestamp: number;
-        toolCalls?: HistoryResponseToolCall[];
-        /** True when tool_use blocks appeared before any text block in the original content. */
-        toolCallsBeforeText?: boolean;
-        attachments?: UserMessageAttachment[];
-        /** Text segments split by tool-call boundaries. Preserves interleaving order. */
-        textSegments?: string[];
-        /** Content block ordering using "text:N", "tool:N", "surface:N" encoding. */
-        contentOrder?: string[];
-        /** UI surfaces (widgets) embedded in the message. */
-        surfaces?: HistoryResponseSurface[];
-        /** Present when this message is a subagent lifecycle notification (running/completed/failed/aborted). */
-        subagentNotification?: {
-            subagentId: string;
-            label: string;
-            status: "running" | "completed" | "failed" | "aborted";
-            error?: string;
-            conversationId?: string;
-            objective?: string;
-        };
-        /** True when text or tool result content was truncated due to maxTextChars/maxToolResultChars. */
-        wasTruncated?: boolean;
-    }>;
-    /** Whether older messages exist beyond the returned page. */
-    hasMore: boolean;
-    /** Timestamp of the oldest message in the response (client uses as next pagination cursor). */
-    oldestTimestamp?: number;
-    /** ID of the oldest message in the response (tie-breaker for same-millisecond cursors). */
-    oldestMessageId?: string;
-}
-
-declare interface HistoryResponseSurface {
-    surfaceId: string;
-    surfaceType: string;
-    title?: string;
-    data: Record<string, unknown>;
-    actions?: Array<{
-        id: string;
-        label: string;
-        style?: string;
-        data?: Record<string, unknown>;
-    }>;
-    display?: string;
-    /** True when the surface was completed (e.g. form submitted, action taken). */
-    completed?: boolean;
-    /** Human-readable summary shown in the completion chip. */
-    completionSummary?: string;
-}
-
-declare interface HistoryResponseToolCall {
-    name: string;
-    input: Record<string, unknown>;
-    result?: string;
-    isError?: boolean;
-    /** Base64-encoded image data from tool contentBlocks (e.g. browser_screenshot). @deprecated Use imageDataList. */
-    imageData?: string;
-    /** Base64-encoded image data from tool contentBlocks (e.g. browser_screenshot, image generation). */
-    imageDataList?: string[];
-    /** Workspace attachment ids for tool-result images persisted as references; clients fetch bytes by id on render instead of embedding base64. */
-    imageAttachmentIds?: string[];
-    /** Unix ms when the tool started executing. */
-    startedAt?: number;
-    /** Unix ms when the tool completed. */
-    completedAt?: number;
-    /** Confirmation decision for this tool call: "approved" | "denied" | "timed_out". */
-    confirmationDecision?: string;
-    /** Friendly label for the confirmation (e.g. "Edit File", "Run Command"). */
-    confirmationLabel?: string;
-    /** Risk level at the time of invocation ("low" | "medium" | "high" | "unknown"). */
-    riskLevel?: string;
-    /** Human-readable reason for the risk classification. */
-    riskReason?: string;
-    /**
-     * @deprecated Use `approvalMode` and `approvalReason` instead.
-     * Kept for backward compatibility during the migration window.
-     */
-    autoApproved?: boolean;
-    /** How the approval decision was reached: prompted, auto, blocked, or unknown (legacy). */
-    approvalMode?: string;
-    /** Why the approval decision was reached (stable enum for client display). */
-    approvalReason?: string;
-    /** Snapshot of the auto-approve threshold at execution time. */
-    riskThreshold?: string;
-}
-
 declare type HomeFeedUpdatedEvent = z.infer<typeof HomeFeedUpdatedEventSchema>;
 
 declare const HomeFeedUpdatedEventSchema: z.ZodObject<{
@@ -3140,7 +2964,7 @@ export declare function lastToolResultUserMessageIndex(history: Message[]): numb
 export declare function listCatalogSkills(): Promise<ResolvedSkillEntry[]>;
 
 /** List conversation rows, newest first. */
-export declare function listConversations(limit?: number, conversationType?: ConversationType_2, offset?: number, archiveStatus?: ArchiveStatusFilter, originChannel?: string): Promise<ConversationRow[]>;
+export declare function listConversations(limit?: number, conversationType?: ConversationType, offset?: number, archiveStatus?: ArchiveStatusFilter, originChannel?: string): Promise<ConversationRow[]>;
 
 /**
  * The locally installed skill catalog with resolved states. Includes every
@@ -4333,6 +4157,17 @@ declare interface ProxyApprovalRequest {
 
 declare type ProxyToolResolver = (toolName: string, input: Record<string, unknown>) => Promise<ToolExecutionResult>;
 
+/**
+ * Publish a runtime event to the assistant's event hub. Resolves once fanout to
+ * all subscribers has been attempted (a throwing subscriber never aborts
+ * delivery to the rest). Rejects if the event is non-serializable or is a
+ * host-proxy control event, which plugins may not publish.
+ */
+export declare function publishEvent(event: AssistantEvent, options?: PublishEventOptions): Promise<void>;
+
+/** Publish options, mirroring the hub's `publish` options (targeting, self-echo suppression). */
+export declare type PublishEventOptions = NonNullable<Parameters<PluginEventHub["publish"]>[1]>;
+
 /**
  * Remove every previously-refused exchange from a working history: for each
  * assistant message that is exactly the refusal fallback, drop it together with
@@ -4891,7 +4726,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _HostUiSnapshotServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | HookEvent | SubagentEvent;
+declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _HostUiSnapshotServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | HookEvent | SubagentEventEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -5254,27 +5089,23 @@ export declare interface SttStreamServerPartialEvent {
     readonly confidence?: number;
 }
 
-declare interface SubagentDetailResponse {
-    type: "subagent_detail_response";
-    subagentId: string;
-    objective?: string;
-    usage?: UsageStats;
-    events: Array<{
-        type: string;
-        content: string;
-        toolName?: string;
-        isError?: boolean;
-        messageId?: string;
-    }>;
-}
+declare type SubagentEventEvent = z.infer<typeof SubagentEventEventSchema>;
 
-/** Wraps any ServerMessage emitted by a subagent conversation for routing to the client. */
-declare interface SubagentEvent {
-    type: "subagent_event";
-    subagentId: string;
-    conversationId: string;
-    event: ServerMessage;
-}
+declare const SubagentEventEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"subagent_event">;
+    conversationId: z.ZodString;
+    subagentId: z.ZodString;
+    event: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        toolName: z.ZodOptional<z.ZodString>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+        toolUseId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strict>;
 
 declare type SubagentSpawnedEvent = z.infer<typeof SubagentSpawnedEventSchema>;
 
@@ -5288,7 +5119,7 @@ declare const SubagentSpawnedEventSchema: z.ZodObject<{
     parentToolUseId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
-declare type _SubagentsServerMessages = SubagentSpawnedEvent | SubagentStatusChangedEvent | SubagentDetailResponse;
+declare type _SubagentsServerMessages = SubagentSpawnedEvent | SubagentStatusChangedEvent;
 
 declare type SubagentStatusChangedEvent = z.infer<typeof SubagentStatusChangedEventSchema>;
 
@@ -5299,9 +5130,9 @@ declare const SubagentStatusChangedEventSchema: z.ZodObject<{
         completed: "completed";
         failed: "failed";
         running: "running";
-        aborted: "aborted";
         pending: "pending";
         awaiting_input: "awaiting_input";
+        aborted: "aborted";
         interrupted: "interrupted";
     }>;
     error: z.ZodOptional<z.ZodString>;
@@ -6144,12 +5975,6 @@ declare const UISurfaceUpdateEventSchema: z.ZodObject<{
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
 
-declare interface UndoComplete {
-    type: "undo_complete";
-    removedCount: number;
-    conversationId?: string;
-}
-
 /** Merge the given keys into a message's metadata JSON. */
 export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
 
@@ -6185,20 +6010,6 @@ declare const UsageProgressEventSchema: z.ZodObject<{
     model: z.ZodString;
 }, z.core.$strip>;
 
-declare interface UsageResponse {
-    type: "usage_response";
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    estimatedCost: number;
-    model: string;
-}
-
-declare interface UsageStats {
-    inputTokens: number;
-    outputTokens: number;
-    estimatedCost: number;
-}
-
 declare type UsageUpdateEvent = z.infer<typeof UsageUpdateEventSchema>;
 
 declare const UsageUpdateEventSchema: z.ZodObject<{
@@ -6216,24 +6027,6 @@ declare const UsageUpdateEventSchema: z.ZodObject<{
     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 
-declare interface UserMessageAttachment {
-    id?: string;
-    filename: string;
-    mimeType: string;
-    data: string;
-    /** Origin of the attachment on the daemon side, when known. */
-    sourceType?: "sandbox_file" | "host_file" | "tool_block";
-    extractedText?: string;
-    /** Original file size in bytes. Present when data was omitted from history_response to reduce payload size. */
-    sizeBytes?: number;
-    /** Base64-encoded JPEG thumbnail. Generated server-side for video attachments. */
-    thumbnailData?: string;
-    /** Absolute path to the local file on disk. Present for file-backed attachments (e.g. recordings). */
-    filePath?: string;
-    /** True when the attachment is file-backed and clients should hydrate via the /content endpoint. */
-    fileBacked?: boolean;
-}
-
 declare type UserMessageEchoEvent = z.infer<typeof UserMessageEchoEventSchema>;
 
 declare const UserMessageEchoEventSchema: z.ZodObject<{

package/index.js

@@ -33,6 +33,7 @@ export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const publishEvent = api.publishEvent;
 export const quarantineRefusedExchanges = api.quarantineRefusedExchanges;
 export const resolveCredential = api.resolveCredential;
 export const resolveMediaSourceData = api.resolveMediaSourceData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.11-dev.202607241335.d95a4c6",
+  "version": "0.10.11-dev.202607241439.ab7e771",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",