@vellumai/plugin-api 0.10.3-dev.202606291517.f0c68f7 → 0.10.3-dev.202606291709.2b4d83d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +19 -9
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -3050,19 +3050,29 @@ export declare interface PostToolUseContext {
3050
3050
  /**
3051
3051
  * Model id reported by the provider for the assistant turn that issued
3052
3052
  * this tool call (e.g. `claude-opus-4-8`,
3053
- * `accounts/fireworks/models/kimi-k2p6`). A hook needing a finer-grained
3054
- * model-family signal than {@link needsFirmerSteering} e.g. matching a
3055
- * specific loop-prone family reads it directly.
3053
+ * `accounts/fireworks/models/kimi-k2p6`). Hooks use it to vary coaching by
3054
+ * model family each plugin owns its own model policy (e.g. which families
3055
+ * need firmer steering) and matches against this string directly.
3056
3056
  */
3057
3057
  readonly model: string;
3058
3058
  /**
3059
- * Host's assessment that this turn's model needs firmer mid-turn steering
3060
- * than the static prompt provides `true` for weaker open-weight families
3061
- * that disregard prompt-level coaching, `false` for models that follow it.
3062
- * Hooks gate aggressive nudges on this boolean instead of re-deriving the
3063
- * model taxonomy themselves.
3059
+ * The LLM call site driving this turn `mainAgent` for a live user-facing
3060
+ * turn, `subagentSpawn` for a subagent, or a background site (e.g.
3061
+ * `heartbeatAgent`, `titleGenerate`). `null` when the run tagged none. A hook
3062
+ * that should only act on a live user-facing turn gates on
3063
+ * `callSite === "mainAgent"`; one that should skip subagents checks
3064
+ * `callSite === "subagentSpawn"`.
3064
3065
  */
3065
- readonly needsFirmerSteering: boolean;
3066
+ readonly callSite: LLMCallSite | null;
3067
+ /**
3068
+ * Whether the connected client can render dynamic UI surfaces this turn —
3069
+ * `true` unless the channel explicitly lacks the capability (SMS, phone,
3070
+ * email, and most chat bridges). A fact about what the model can *do* this
3071
+ * turn, not who is calling: a hook that prompts a surface tool (e.g. the
3072
+ * `ui_show` progress card) gates on this so it does not coach the model
3073
+ * toward a tool the channel filters out of the tool set.
3074
+ */
3075
+ readonly supportsDynamicUi: boolean;
3066
3076
  /**
3067
3077
  * The model's context-window size in tokens. Plugins derive their own
3068
3078
  * character budget from this (e.g. a share of the window) rather than
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/plugin-api",
3
- "version": "0.10.3-dev.202606291517.f0c68f7",
3
+ "version": "0.10.3-dev.202606291709.2b4d83d",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",