@vellumai/plugin-api 0.9.0-dev.202606162337.b5a0f93 → 0.9.0-dev.202606170102.00832b6

package/index.d.ts

@@ -524,8 +524,7 @@ declare type _BookmarksServerMessages = BookmarkCreated | BookmarkDeleted;
 
 /**
  * Wire-shape representation of a bookmark, joined with the bookmarked
- * message and its parent conversation. Mirrors
- * `clients/shared/Network/BookmarkSummary.swift` — dates are emitted as
+ * message and its parent conversation. Dates are emitted as
  * unix-millisecond integers, and the message preview is capped to keep
  * the list payload bounded.
  */
@@ -1471,6 +1470,19 @@ declare const GenerationHandoffEventSchema: z.ZodObject<{
     attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 
+/**
+ * List the workspace inference profiles a plugin can route to, in the order the
+ * `/model` picker presents them (`llm.profileOrder` first, then the rest
+ * alphabetically). Disabled profiles are included and flagged via
+ * {@link ModelProfileInfo.isDisabled}; weighted "mix" profiles are included and
+ * flagged via {@link ModelProfileInfo.isMix}, since a mix is itself a valid
+ * routing target (it resolves to one constituent per conversation).
+ *
+ * Reads the live in-memory config, so the result reflects the current profile
+ * set each time it is called.
+ */
+export declare function getModelProfiles(): ModelProfileInfo[];
+
 /**
  * Retrieve a secret from secure storage. Convenience wrapper over
  * `getSecureKeyResultAsync` that returns only the value.
@@ -2453,6 +2465,33 @@ declare interface ModelInfo {
     }>;
 }
 
+/**
+ * A workspace inference profile a plugin can route to. Returned by
+ * {@link getModelProfiles}; {@link key} is the value a `pre-model-call` hook
+ * assigns to `PreModelCallContext.modelProfile` to route a call. A model router
+ * reads this list (typically at `init`) to learn which profiles exist before
+ * mapping a classified message onto one.
+ */
+export declare interface ModelProfileInfo {
+    /** Profile key in `llm.profiles`; assignable to `PreModelCallContext.modelProfile`. */
+    readonly key: string;
+    /** Human-readable label, falling back to {@link key} when none is set. */
+    readonly label: string;
+    /** Author-supplied description, or `null` when none is set. */
+    readonly description: string | null;
+    /** Whether this is the workspace's active profile. */
+    readonly isActive: boolean;
+    /** Whether the profile is disabled; routing to it is rejected by the resolver. */
+    readonly isDisabled: boolean;
+    /**
+     * Whether this is a weighted "mix" profile — an A/B blend that resolves to one
+     * of its constituent profiles per conversation via a seeded weighted pick.
+     * Routing to its {@link key} is valid; it directs the call into the blend
+     * rather than at a single fixed model.
+     */
+    readonly isMix: boolean;
+}
+
 declare type NavigateSettingsEvent = z.infer<typeof NavigateSettingsEventSchema>;
 
 declare const NavigateSettingsEventSchema: z.ZodObject<{

package/index.js

@@ -3,4 +3,5 @@ const api = globalThis[Symbol.for("vellum.plugin-api")] ?? {};
 export const HOOKS = api.HOOKS;
 export const RiskLevel = api.RiskLevel;
 export const assistantEventHub = api.assistantEventHub;
+export const getModelProfiles = api.getModelProfiles;
 export const getSecureKeyAsync = api.getSecureKeyAsync;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.9.0-dev.202606162337.b5a0f93",
+  "version": "0.9.0-dev.202606170102.00832b6",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",