@vellumai/plugin-api 0.10.3 → 0.10.4-dev.202607010028.1a4efcc

package/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-declare type _AcpServerMessages = AcpSessionSpawned | AcpSessionUpdate | AcpSessionCompleted | AcpSessionError;
+declare type _AcpServerMessages = AcpSessionSpawned | AcpSessionUpdate | AcpSessionCompleted | AcpSessionError | AcpSessionUsage;
 
 declare interface AcpSessionCompleted {
     type: "acp_session_completed";
@@ -19,6 +19,10 @@ declare interface AcpSessionSpawned {
     acpSessionId: string;
     agent: string;
     parentConversationId: string;
+    /** Tool-use id of the `acp_spawn` call that spawned this session. */
+    parentToolUseId?: string;
+    /** Objective text for the spawned session. */
+    task?: string;
 }
 
 declare interface AcpSessionUpdate {
@@ -30,6 +34,30 @@ declare interface AcpSessionUpdate {
     toolTitle?: string;
     toolKind?: string;
     toolStatus?: string;
+    /** Optional raw input parameters sent to the tool (ACP `rawInput`); shape is tool-specific. */
+    rawInput?: unknown;
+    /** Optional raw output returned by the tool (ACP `rawOutput`); shape is tool-specific. */
+    rawOutput?: unknown;
+    /** Files touched by this tool call (for the file-diff affordance). */
+    locations?: {
+        path: string;
+        line?: number;
+    }[];
+    /** Stable id for the message this chunk belongs to. */
+    messageId?: string;
+    /** Monotonic ordering hint within the session. */
+    seq?: number;
+}
+
+declare interface AcpSessionUsage {
+    type: "acp_session_usage";
+    acpSessionId: string;
+    usedTokens: number;
+    contextSize: number;
+    costAmount?: number;
+    costCurrency?: string;
+    inputTokens?: number;
+    outputTokens?: number;
 }
 
 /**
@@ -224,47 +252,7 @@ declare interface AssistantAttention {
 }
 
 /** Daemon-side specialization of the generic event envelope. */
-export declare type AssistantEvent = AssistantEvent_2<ServerMessage>;
-
-/**
- * Assistant Events -- shared types and SSE framing helpers.
- *
- * This module is intentionally free of imports from `assistant/` or any
- * other repo-local module so it can be consumed by both the daemon and
- * isolated skill processes without circular references.
- *
- * The `AssistantEvent` interface is generic over the `message` payload so
- * the neutral package does not need to know about the daemon-side
- * `ServerMessage` discriminated union. Consumers that want narrower
- * typing can re-export a specialized alias, e.g.:
- *
- *   type AssistantEvent = BaseAssistantEvent<ServerMessage>;
- */
-/**
- * A single assistant event wrapping an outbound message payload.
- *
- * Generic over the payload type so the neutral package has zero dependency
- * on daemon-side message schemas. The `TMessage` default of `unknown`
- * keeps the package importable without a type argument when the caller
- * does not care about message narrowing.
- */
-declare interface AssistantEvent_2<TMessage = unknown> {
-    /** Globally unique event identifier (UUID). */
-    id: string;
-    /** Resolved conversation id when available. */
-    conversationId?: string;
-    /**
-     * Monotonic per-conversation sequence number. Assigned by the daemon at
-     * publish time for conversation-scoped events; absent for unscoped
-     * broadcasts. Clients track the highest observed `seq` per conversation
-     * and pass it back on reconnect to request replay of missed events.
-     */
-    seq?: number;
-    /** ISO-8601 timestamp of when the event was emitted. */
-    emittedAt: string;
-    /** Outbound message payload. */
-    message: TMessage;
-}
+export declare type AssistantEvent = BaseAssistantEvent<ServerMessage>;
 
 export declare type AssistantEventCallback = (event: AssistantEvent) => void | Promise<void>;
 
@@ -403,12 +391,8 @@ export declare class AssistantEventHub {
     hasCapacity(): boolean;
 }
 
-/**
- * Singleton hub shared across the entire runtime process.
- *
- * Import and use this in daemon send paths and the SSE route.
- */
-export declare const assistantEventHub: AssistantEventHub;
+/** The plugin-facing event hub. See module docs. */
+export declare const assistantEventHub: PluginEventHub;
 
 /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
 export declare interface AssistantEventSubscription {
@@ -448,6 +432,15 @@ declare interface AssistantInboxEscalationResponse {
     };
 }
 
+/**
+ * Managed skill authored by the assistant's retrospective. Identical shape to a
+ * custom skill — it stays managed/deletable — but carries a distinct origin so
+ * the UI badges it as "Assistant's Memory" instead of "Custom".
+ */
+declare interface AssistantMemorySlimSkill extends SlimSkillBase {
+    origin: "assistant-memory";
+}
+
 declare interface AssistantStatusMessage {
     type: "assistant_status";
     version?: string;
@@ -494,6 +487,52 @@ declare const AvatarUpdatedEventSchema: z.ZodObject<{
     avatarPath: z.ZodString;
 }, z.core.$strip>;
 
+declare interface BackgroundToolCompleted {
+    type: "background_tool_completed";
+    id: string;
+    conversationId: string;
+    status: "completed" | "failed" | "cancelled";
+    exitCode?: number | null;
+    output?: string;
+    completedAt: number;
+}
+
+declare type _BackgroundToolsServerMessages = BackgroundToolStarted | BackgroundToolCompleted;
+
+declare interface BackgroundToolStarted {
+    type: "background_tool_started";
+    id: string;
+    toolName: string;
+    conversationId: string;
+    command: string;
+    startedAt: number;
+}
+
+/**
+ * A single assistant event wrapping an outbound message payload.
+ *
+ * Generic over the payload type. The `TMessage` default of `unknown` keeps
+ * the envelope nameable without a type argument when the caller does not
+ * care about message narrowing.
+ */
+declare interface BaseAssistantEvent<TMessage = unknown> {
+    /** Globally unique event identifier (UUID). */
+    id: string;
+    /** Resolved conversation id when available. */
+    conversationId?: string;
+    /**
+     * Monotonic per-conversation sequence number. Assigned by the daemon at
+     * publish time for conversation-scoped events; absent for unscoped
+     * broadcasts. Clients track the highest observed `seq` per conversation
+     * and pass it back on reconnect to request replay of missed events.
+     */
+    seq?: number;
+    /** ISO-8601 timestamp of when the event was emitted. */
+    emittedAt: string;
+    /** Outbound message payload. */
+    message: TMessage;
+}
+
 declare interface BaseSubscriberEntry {
     filter: AssistantEventFilter;
     callback: AssistantEventCallback;
@@ -972,7 +1011,6 @@ declare const ConversationErrorEventSchema: z.ZodObject<{
         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;
@@ -1083,7 +1121,6 @@ declare const ConversationNoticeEventSchema: z.ZodObject<{
         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;
@@ -1163,9 +1200,9 @@ declare const DiskPressureStatusChangedEventSchema: z.ZodObject<{
     status: z.ZodObject<{
         enabled: z.ZodBoolean;
         state: z.ZodEnum<{
-            ok: "ok";
             unknown: "unknown";
             disabled: "disabled";
+            ok: "ok";
             warning: "warning";
             critical: "critical";
         }>;
@@ -1353,27 +1390,26 @@ declare const ErrorEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 /**
- * Tool-related type declarations shared between the daemon and any
- * skill-side package that needs to describe tools, permission risk, or tool
- * execution results on the wire.
+ * Tool-related type declarations: the neutral leaf module describing
+ * tools, permission risk, and tool execution results.
  *
- * Pure type-level declarations only (+ the `RiskLevel` enum, which is a value
- * but is safely cross-package). No runtime helpers live here — the assistant
- * keeps all behavior functions in `assistant/src/tools/` and re-exports the
- * types from this file.
+ * Pure type-level declarations only (+ the `RiskLevel` enum, which is a
+ * value). No runtime helpers live here — the assistant keeps all behavior
+ * functions in `assistant/src/tools/` and re-exports the types from this
+ * file. This module imports nothing, so it can sit at the bottom of the
+ * import graph and be consumed by `tools/types.ts`, `providers/types.ts`,
+ * and `permissions/types.ts` without creating cycles.
  *
  * Heavy daemon-internal references (CES client, host-proxy classes, trust
  * classifications, interface IDs, content blocks, CES `ApprovalRequired`)
- * are held as opaque `unknown` / broadened-`string` placeholders on this
- * side so the contracts package never reaches into the assistant or the
- * service-contracts runtime. The assistant redeclares `Tool`, `ToolContext`,
- * `ToolExecutionResult`, `ToolExecutedEvent`, `ToolLifecycleEvent`,
- * `ToolLifecycleEventHandler`, and `ProxyToolResolver` in
- * `assistant/src/tools/types.ts` with the concrete types in place, so
- * existing call sites keep their full type information. The two sides are
- * structurally independent — no inheritance, no intersection — which
- * avoids TypeScript's contravariance mismatches on lifecycle-event
- * handlers.
+ * are held as opaque `unknown` / broadened-`string` placeholders here. The
+ * assistant redeclares `Tool`, `ToolContext`, `ToolExecutionResult`,
+ * `ToolExecutedEvent`, `ToolLifecycleEvent`, `ToolLifecycleEventHandler`,
+ * and `ProxyToolResolver` in `assistant/src/tools/types.ts` with the
+ * concrete types in place, so existing call sites keep their full type
+ * information. The two sides are structurally independent — no inheritance,
+ * no intersection — which avoids TypeScript's contravariance mismatches on
+ * lifecycle-event handlers.
  */
 declare type ExecutionTarget = "sandbox" | "host";
 
@@ -1491,6 +1527,8 @@ declare interface FormSurfaceData {
         back?: string;
         submit?: string;
     };
+    /** Progress indicator style for multi-page forms: segment bar or labeled tabs. */
+    progressStyle?: "bar" | "tabs";
 }
 
 /** Response to a generate_avatar request indicating success or failure. */
@@ -2169,13 +2207,23 @@ declare interface IngressConfigResponse {
  * 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.
+ *
+ * For user-installed plugins, config is read from `<pluginDir>/config.json`
+ * and `pluginStorageDir` points at `<pluginDir>/data/`. For first-party
+ * default plugins and standalone workspace hooks, config comes from the
+ * global `config.plugins.<name>` block and `pluginStorageDir` points at
+ * `<workspaceDir>/plugins-data/<name>/`.
  */
 export declare interface InitContext {
     /** Parsed config for this plugin (may be `unknown` until the manifest validates). */
     config: unknown;
     /** Pino-compatible child logger bound to `{ plugin: <name> }`. */
     logger: PluginLogger;
-    /** Absolute path to `<workspaceDir>/plugins-data/<plugin>/` (created by bootstrap). */
+    /**
+     * Absolute path to the per-plugin writable data directory. For user plugins
+     * this is `<pluginDir>/data/`; for defaults and workspace hooks it falls back
+     * to `<workspaceDir>/plugins-data/<plugin>/`. Created by bootstrap.
+     */
     pluginStorageDir: string;
     /**
      * Assistant semver. Plugins can compare against this for defensive
@@ -2230,6 +2278,23 @@ declare const INTERFACE_IDS: readonly ["macos", "ios", "cli", "telegram", "phone
 
 declare type InterfaceId = (typeof INTERFACE_IDS)[number];
 
+/**
+ * Provider stop-reason classification.
+ *
+ * Providers report an output-length cutoff under several normalized
+ * finish-reason strings; {@link isMaxTokensStopReason} folds them into a single
+ * "was this turn truncated at the token cap?" predicate.
+ *
+ * Kept dependency-free so it can be re-exported through `@vellumai/plugin-api`
+ * without pulling the agent loop (its other caller) into the plugin API's
+ * module graph.
+ */
+/**
+ * Whether a provider stop reason denotes output truncated at the token cap.
+ * Case- and whitespace-insensitive; a `null`/`undefined`/empty reason is false.
+ */
+export declare function isMaxTokensStopReason(stopReason: string | null | undefined): boolean;
+
 declare interface ListItem {
     id: string;
     title: string;
@@ -2288,10 +2353,7 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     styleAnalyzer: "styleAnalyzer";
     inviteInstructionGenerator: "inviteInstructionGenerator";
     skillCategoryInference: "skillCategoryInference";
-    meetConsentMonitor: "meetConsentMonitor";
-    meetChatOpportunity: "meetChatOpportunity";
     inference: "inference";
-    advisor: "advisor";
     vision: "vision";
     trustRuleSuggestion: "trustRuleSuggestion";
     homeGreeting: "homeGreeting";
@@ -2299,139 +2361,6 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     workflowLeaf: "workflowLeaf";
 }>;
 
-/**
- * The assistant successfully posted a chat message into the meeting via
- * the bot's `/send_chat` endpoint. Emitted once per successful send so
- * SSE-subscribed clients can render the outbound chat without waiting for
- * the bot to echo it back through the transcript/chat stream.
- */
-declare interface MeetChatSent {
-    type: "meet.chat_sent";
-    meetingId: string;
-    /** The text that was posted into the meeting's chat. */
-    text: string;
-}
-
-/** The bot hit a non-recoverable error (container crash, join failure, etc.). */
-declare interface MeetError {
-    type: "meet.error";
-    meetingId: string;
-    /** Human-readable error detail. */
-    detail: string;
-}
-
-/** The bot has successfully joined and is live in the meeting. */
-declare interface MeetJoined {
-    type: "meet.joined";
-    meetingId: string;
-}
-
-/** The bot has started attempting to join a meeting. */
-declare interface MeetJoining {
-    type: "meet.joining";
-    meetingId: string;
-    /** The Meet URL the bot was asked to join. */
-    url: string;
-}
-
-/** The bot has left the meeting. */
-declare interface MeetLeft {
-    type: "meet.left";
-    meetingId: string;
-    /** Free-form reason passed to `leave()` (e.g. "user-requested", "timeout"). */
-    reason: string;
-}
-
-/**
- * Meet — server → client push messages for live meeting state.
- *
- * Emitted by the assistant daemon as the Meet-bot progresses through its
- * lifecycle (joining → joined → left) and as in-meeting state changes
- * (participants, active speaker, transcript chunks).
- *
- * Keep payloads small and client-actionable: these events power the
- * macOS "In meeting" status panel and the conversation bridge's live
- * transcript feed. A client that missed an event can always refetch
- * authoritative state from the daemon's HTTP routes.
- */
-/** A single participant in a meeting. Shape mirrors the wire-level type. */
-declare interface MeetParticipant {
-    /** Stable participant identifier (provider-specific). */
-    id: string;
-    /** Display name of the participant. */
-    name: string;
-    /** Whether the participant is the meeting host. */
-    isHost?: boolean;
-    /** Whether the participant is the bot itself. */
-    isSelf?: boolean;
-}
-
-/** Participants joined and/or left the meeting since the last snapshot. */
-declare interface MeetParticipantChanged {
-    type: "meet.participant_changed";
-    meetingId: string;
-    /** Participants who joined since the last snapshot. */
-    joined: MeetParticipant[];
-    /** Participants who left since the last snapshot. */
-    left: MeetParticipant[];
-}
-
-declare type _MeetServerMessages = MeetJoining | MeetJoined | MeetParticipantChanged | MeetSpeakerChanged | MeetTranscriptChunk | MeetLeft | MeetChatSent | MeetError | MeetSpeakingStarted | MeetSpeakingEnded;
-
-/** The active speaker in the meeting changed. */
-declare interface MeetSpeakerChanged {
-    type: "meet.speaker_changed";
-    meetingId: string;
-    /** Stable speaker identifier for the new active speaker. */
-    speakerId: string;
-    /** Display name of the new active speaker. */
-    speakerName: string;
-}
-
-/**
- * The assistant has finished (or cancelled) a TTS playback stream. Fired
- * after the bot-side playback request settles — whether normally, via an
- * explicit cancel, or due to an upstream error.
- */
-declare interface MeetSpeakingEnded {
-    type: "meet.speaking_ended";
-    meetingId: string;
-    /** Opaque stream identifier — matches `meet.speaking_started.streamId`. */
-    streamId: string;
-    /** Why the stream ended: natural completion, caller-initiated cancel, or an upstream error. */
-    reason: "completed" | "cancelled" | "error";
-}
-
-/**
- * The assistant has begun speaking into the meeting via the TTS bridge. Fired
- * once per {@link MeetSessionManager.speak} invocation immediately before the
- * synthesis stream starts flowing to the bot's `/play_audio` endpoint. Useful
- * for clients that want to render a "speaking …" indicator.
- */
-declare interface MeetSpeakingStarted {
-    type: "meet.speaking_started";
-    meetingId: string;
-    /** Opaque stream identifier — matches `meet.speaking_ended.streamId`. */
-    streamId: string;
-}
-
-/**
- * A finalized chunk of transcribed speech. Interim chunks are filtered
- * out before publication so clients only render stable text.
- */
-declare interface MeetTranscriptChunk {
-    type: "meet.transcript_chunk";
-    meetingId: string;
-    /** The transcribed text. */
-    text: string;
-    /** Human-readable speaker label, if the ASR provided one. */
-    speakerLabel?: string;
-    /** Stable speaker identifier across the meeting, if available. */
-    speakerId?: string;
-    /** ASR confidence in [0, 1], if available. */
-    confidence?: number;
-}
-
 declare interface MemoryRecalled {
     type: "memory_recalled";
     provider: string;
@@ -2771,6 +2700,13 @@ declare interface PlatformDisconnected {
     type: "platform_disconnected";
 }
 
+/**
+ * The subset of {@link AssistantEventHub} workspace plugins may use. Picking
+ * method signatures off the class keeps the facade in sync with the hub while
+ * statically withholding everything else.
+ */
+export declare type PluginEventHub = Pick<AssistantEventHub, "subscribe" | "publish" | "hasSubscribersForEvent">;
+
 /**
  * Minimal pino-compatible logger surface handed to plugin hooks. The host
  * supplies a pino child logger bound to `{ plugin: <name> }`; this
@@ -2839,13 +2775,10 @@ export declare interface PostCompactContext {
      */
     readonly isNonInteractive: boolean;
     /**
-     * Active inference profile key to surface in the re-injected context, or
-     * `null` when the profile is unchanged since the one last announced to the
-     * model. Mirrors {@link UserPromptSubmitContext.modelProfileKey}: hooks that
-     * emit the `model_profile` grounding line resolve the human-readable label
-     * from this key rather than receiving the rendered string.
+     * Effective inference profile identity for the model the compacted turn will
+     * keep using. Mirrors {@link UserPromptSubmitContext.modelProfileKey}.
      */
-    readonly modelProfileKey: string | null;
+    readonly modelProfileKey: string;
     /**
      * Volume of runtime injection to re-apply. `"full"` restores the complete
      * runtime context; `"minimal"` is the reduced volume overflow recovery's
@@ -2999,9 +2932,28 @@ export declare interface PostToolUseContext {
      * Model id reported by the provider for the assistant turn that issued
      * this tool call (e.g. `claude-opus-4-8`,
      * `accounts/fireworks/models/kimi-k2p6`). Hooks use it to vary coaching by
-     * model family — some models need earlier or firmer steering than others.
+     * model family — each plugin owns its own model policy (e.g. which families
+     * need firmer steering) and matches against this string directly.
      */
     readonly model: string;
+    /**
+     * The LLM call site driving this turn — `mainAgent` for a live user-facing
+     * turn, `subagentSpawn` for a subagent, or a background site (e.g.
+     * `heartbeatAgent`, `titleGenerate`). `null` when the run tagged none. A hook
+     * that should only act on a live user-facing turn gates on
+     * `callSite === "mainAgent"`; one that should skip subagents checks
+     * `callSite === "subagentSpawn"`.
+     */
+    readonly callSite: LLMCallSite | null;
+    /**
+     * Whether the connected client can render dynamic UI surfaces this turn —
+     * `true` unless the channel explicitly lacks the capability (SMS, phone,
+     * email, and most chat bridges). A fact about what the model can *do* this
+     * turn, not who is calling: a hook that prompts a surface tool (e.g. the
+     * `ui_show` progress card) gates on this so it does not coach the model
+     * toward a tool the channel filters out of the tool set.
+     */
+    readonly supportsDynamicUi: boolean;
     /**
      * The model's context-window size in tokens. Plugins derive their own
      * character budget from this (e.g. a share of the window) rather than
@@ -3096,6 +3048,19 @@ export declare interface Provider {
      * unexecutable client tool call. Absent/false on providers without it.
      */
     supportsNativeWebSearch?: boolean;
+    /**
+     * Per-call native web-search capability for the provider/model this specific
+     * request will route to. Unlike the static {@link supportsNativeWebSearch}
+     * flag — fixed to the DEFAULT provider/model at construction — this consults
+     * the resolved call-site (`options.config.callSite` + `overrideProfile`) so a
+     * routing wrapper reports the ROUTED target's capability. Callers that gate a
+     * `web_search` server tool on a possibly-routed call (e.g. the advisor
+     * consult, whose `advisorProfile` may point at a different provider/model)
+     * must use this rather than the construction-time snapshot. Optional: wrappers
+     * forward it to their inner provider; leaf providers may omit it, in which
+     * case callers fall back to {@link supportsNativeWebSearch}.
+     */
+    supportsNativeWebSearchFor?(options?: SendMessageOptions): boolean;
     sendMessage(messages: Message[], options?: SendMessageOptions): Promise<ProviderResponse>;
     /**
      * Exact prompt-token count from the provider's own tokenizer, for the
@@ -3477,7 +3442,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MeetServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
+declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -3552,22 +3517,34 @@ declare interface ShowPlatformLogin {
 }
 
 /**
- * Context passed to the `shutdown` hook during daemon teardown. Kept
- * intentionally narrower than {@link InitContext} — most teardown
- * paths only need to know which assistant version they're shutting
- * down against (e.g. for version-conditional cleanup of state files
- * written by a previous boot).
+ * Context passed to the `shutdown` hook. Kept intentionally narrower than
+ * {@link InitContext} — teardown paths only need to know which assistant
+ * version they're shutting down against (e.g. for version-conditional cleanup
+ * of state files written by a previous boot) and {@link ShutdownReason why}
+ * they're being torn down (so a plugin can, e.g., delete its state on
+ * `uninstall` but preserve it across a plain `shutdown`).
  *
- * Additional fields may be added as concrete plugin needs surface; the
- * `assistantVersion` field mirrors the init context's so plugins that
- * stash a version stamp at init can compare against the same name on
- * tear-down without keeping their own copy.
+ * The `assistantVersion` field mirrors the init context's so plugins that stash
+ * a version stamp at init can compare against the same name on tear-down
+ * without keeping their own copy.
  */
 export declare interface ShutdownContext {
     /** Assistant semver for compatibility checks inside the plugin. */
     assistantVersion: string;
+    /** Why the plugin is shutting down. */
+    reason: ShutdownReason;
 }
 
+/**
+ * Why a plugin's `shutdown` hook is firing.
+ *
+ * - `shutdown` — the daemon is tearing down (process exit).
+ * - `uninstall` — the plugin's directory was removed at runtime.
+ * - `disable` — the plugin was disabled at runtime (e.g. a `.disabled`
+ *   sentinel was added, or a feature flag turned it off).
+ */
+declare type ShutdownReason = "shutdown" | "uninstall" | "disable";
+
 declare interface SignBundlePayloadRequest {
     type: "sign_bundle_payload";
     requestId: string;
@@ -3679,7 +3656,7 @@ declare interface SlimSkillBase {
     owner?: OwnerInfo;
 }
 
-declare type SlimSkillResponse = VellumSlimSkill | ClawhubSlimSkill | SkillsshSlimSkill | CustomSlimSkill;
+declare type SlimSkillResponse = VellumSlimSkill | ClawhubSlimSkill | SkillsshSlimSkill | CustomSlimSkill | AssistantMemorySlimSkill;
 
 /** Sent by the daemon when sounds config or sound files change on disk. */
 declare interface SoundsConfigUpdated {
@@ -3776,7 +3753,7 @@ declare interface SubagentSpawned {
 
 declare type _SubagentsServerMessages = SubagentSpawned | SubagentStatusChanged | SubagentDetailResponse;
 
-declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted";
+declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted" | "interrupted";
 
 declare interface SubagentStatusChanged {
     type: "subagent_status_changed";
@@ -4024,6 +4001,17 @@ export declare interface ToolContext {
      * @legacy
      */
     executionChannel?: string;
+    /**
+     * Origin tag of the turn driving this tool invocation (the conversation's
+     * `TitleOrigin`, e.g. "memory_retrospective"). Set for background-job turns
+     * that pass `requestOrigin` to `runBackgroundJob`, and for the
+     * memory-retrospective wake (which pins it via {@link WakeToolContextPin}).
+     * `buildPolicyContext` copies it onto the `PolicyContext` so the permission
+     * checker can scope narrow non-interactive auto-grants (e.g. retrospective
+     * skill authoring) to a specific internal origin. Unset for normal
+     * interactive turns.
+     */
+    requestOrigin?: string;
     /**
      * Voice/call session ID, if the invocation originates from a call. Used for scoped grant consumption.
      * @legacy
@@ -4544,6 +4532,7 @@ declare const ToolUsePreviewStartEventSchema: z.ZodObject<{
     toolName: z.ZodString;
     conversationId: z.ZodOptional<z.ZodString>;
     messageId: z.ZodOptional<z.ZodString>;
+    previewStartedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 
 declare type ToolUseStartEvent = z.infer<typeof ToolUseStartEventSchema>;
@@ -4556,6 +4545,7 @@ declare const ToolUseStartEventSchema: z.ZodObject<{
     messageId: z.ZodOptional<z.ZodString>;
     conversationId: z.ZodOptional<z.ZodString>;
     startedAt: z.ZodOptional<z.ZodNumber>;
+    previewStartedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 
 declare type TraceEvent = z.infer<typeof TraceEventSchema>;
@@ -4587,9 +4577,9 @@ declare const TraceEventSchema: z.ZodObject<{
     }>;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
-        info: "info";
         success: "success";
         warning: "warning";
+        info: "info";
     }>>;
     summary: z.ZodString;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
@@ -4866,14 +4856,13 @@ export declare interface UserPromptSubmitContext {
      */
     readonly requestId: string;
     /**
-     * Active inference profile key to surface in this turn's context, or `null`
-     * when the profile is unchanged since the one last announced to the model.
-     * Hooks that emit the `model_profile` grounding line resolve the
-     * human-readable label (and model id) from this key via the workspace LLM
-     * config rather than receiving the rendered string — the key is the minimal
-     * turn input the message arrays cannot carry.
+     * Effective inference profile identity for the model this turn will use.
+     * Named-profile configs receive a profile key; profileless configs receive
+     * the resolved model id. Hooks that need model capabilities should resolve
+     * them from this value rather than the workspace active profile, because a
+     * conversation can be pinned to a different profile.
      */
-    readonly modelProfileKey: string | null;
+    readonly modelProfileKey: string;
     /**
      * Whether the turn has no human present to answer clarification questions
      * (e.g. a scheduled, background, or headless run). Resolved once at turn

package/index.js

@@ -6,3 +6,4 @@ export const assistantEventHub = api.assistantEventHub;
 export const doesSupportVision = api.doesSupportVision;
 export const getConfiguredProvider = api.getConfiguredProvider;
 export const getModelProfiles = api.getModelProfiles;
+export const isMaxTokensStopReason = api.isMaxTokensStopReason;

package/package.json

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