@vellumai/plugin-api 0.10.3-dev.202606291517.f0c68f7 → 0.10.3-dev.202606291850.7e0a3f7

package/index.d.ts

@@ -472,6 +472,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;
@@ -3050,19 +3059,29 @@ 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`). A hook needing a finer-grained
-     * model-family signal than {@link needsFirmerSteering} — e.g. matching a
-     * specific loop-prone family — reads it directly.
+     * `accounts/fireworks/models/kimi-k2p6`). Hooks use it to vary coaching by
+     * 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;
     /**
-     * Host's assessment that this turn's model needs firmer mid-turn steering
-     * than the static prompt provides — `true` for weaker open-weight families
-     * that disregard prompt-level coaching, `false` for models that follow it.
-     * Hooks gate aggressive nudges on this boolean instead of re-deriving the
-     * model taxonomy themselves.
+     * 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 needsFirmerSteering: boolean;
+    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
@@ -3753,7 +3772,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 {
@@ -4098,6 +4117,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

package/package.json

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