@vellumai/plugin-api 0.10.7-dev.202607101106.c87f4e3 → 0.10.7-dev.202607101343.e727d4c

package/index.d.ts

@@ -1909,6 +1909,25 @@ declare interface ClawhubSlimSkill extends SlimSkillBase {
     version: string;
 }
 
+export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
+
+/**
+ * Fully declarative description of a top-level `assistant` CLI command and its
+ * subcommands. Plain data by design — no action handlers — so plugins (e.g. the
+ * memory capability indexer) can import a command's help and iterate over it
+ * without dragging in the CLI's daemon/IPC action graph. Command modules apply
+ * the same data via {@link applyCommandHelp}, then attach their handlers.
+ */
+declare interface CliCommandHelp {
+    name: string;
+    description: string;
+    /** Options declared directly on the top-level command. */
+    options?: CliOptionHelp[];
+    /** Extra help appended after the option list (`addHelpText("after", …)`). */
+    helpText?: string;
+    subcommands?: CliSubcommandHelp[];
+}
+
 declare interface ClientEntry extends BaseSubscriberEntry {
     type: "client";
     clientId: string;
@@ -1936,6 +1955,24 @@ declare interface ClientSettingsUpdate {
     value: string;
 }
 
+declare interface CliOptionHelp {
+    /** Commander flag spec, e.g. `"--path <file>"` or `"-l, --limit <n>"`. */
+    flags: string;
+    description: string;
+    /** When true, applied via `requiredOption` (missing → error) rather than `option`. */
+    required?: boolean;
+    /** Default value passed to `option(flags, description, defaultValue)`. */
+    defaultValue?: string;
+}
+
+declare interface CliSubcommandHelp {
+    name: string;
+    description: string;
+    options?: CliOptionHelp[];
+    /** Extra help appended after the option list (`addHelpText("after", …)`). */
+    helpText?: string;
+}
+
 declare type CompactionCircuitClosedEvent = z.infer<typeof CompactionCircuitClosedEventSchema>;
 
 declare const CompactionCircuitClosedEventSchema: z.ZodObject<{
@@ -5481,6 +5518,29 @@ declare type _SyncInvalidationServerMessages = SyncChangedEvent;
 /** Re-sync one persisted message into the conversation's disk view. */
 export declare function syncMessageToDisk(conversationId: string, messageId: string, createdAtMs: number): Promise<void>;
 
+/**
+ * Synthesize text to audio using the globally configured TTS provider.
+ *
+ * 1. Resolves the active provider and its config via `tts-config-resolver`.
+ * 2. Looks up the provider adapter in the registry.
+ * 3. Delegates to the adapter's `synthesize` method.
+ *
+ * Throws {@link TtsSynthesisError} when the provider is not registered
+ * or synthesis fails.
+ */
+export declare function synthesizeText(options: SynthesizeTextOptions): Promise<TtsSynthesisResult>;
+
+export declare interface SynthesizeTextOptions {
+    /** Text to speak. Sanitized internally — callers can pass raw model output. */
+    text: string;
+    /** Product surface requesting synthesis. */
+    useCase: TtsUseCase;
+    /** Optional voice override (provider-specific identifier). */
+    voiceId?: string;
+    /** Optional abort signal. */
+    signal?: AbortSignal;
+}
+
 declare interface TableCellValue {
     text: string;
     icon?: string;
@@ -6168,6 +6228,31 @@ declare const trustClassSchema: z.ZodEnum<{
     unverified_contact: "unverified_contact";
 }>;
 
+export declare class TtsSynthesisError extends Error {
+    readonly code: TtsSynthesisErrorCode;
+    constructor(code: TtsSynthesisErrorCode, message: string);
+}
+
+declare type TtsSynthesisErrorCode = "TTS_PROVIDER_NOT_CONFIGURED" | "TTS_SYNTHESIS_FAILED";
+
+/** Output of a completed TTS synthesis call. */
+export declare interface TtsSynthesisResult {
+    /** Complete audio buffer. */
+    audio: Buffer;
+    /** MIME type of the returned audio (e.g. `"audio/mpeg"`, `"audio/wav"`). */
+    contentType: string;
+}
+
+/**
+ * Describes the product surface that is requesting synthesis so providers
+ * can tailor format, latency, and quality trade-offs.
+ */
+declare type TtsUseCase = 
+/** Real-time phone call — prioritize low latency and streaming. */
+"phone-call"
+/** In-app message playback — buffer-oriented, higher quality acceptable. */
+| "message-playback";
+
 declare interface UiSurfaceComplete {
     type: "ui_surface_complete";
     conversationId: string;

package/index.js

@@ -1,7 +1,9 @@
 // Generated by scripts/build-plugin-api.ts — do not edit by hand.
 const api = globalThis[Symbol.for("vellum.plugin-api")] ?? {};
+export const CLI_COMMAND_HELP = api.CLI_COMMAND_HELP;
 export const HOOKS = api.HOOKS;
 export const RiskLevel = api.RiskLevel;
+export const TtsSynthesisError = api.TtsSynthesisError;
 export const addMessage = api.addMessage;
 export const assistantEventHub = api.assistantEventHub;
 export const buildMessageExcerpt = api.buildMessageExcerpt;
@@ -28,4 +30,5 @@ export const searchMessageIdsLexical = api.searchMessageIdsLexical;
 export const selectedBackendSupportsMultimodal = api.selectedBackendSupportsMultimodal;
 export const stringifyMessageContent = api.stringifyMessageContent;
 export const syncMessageToDisk = api.syncMessageToDisk;
+export const synthesizeText = api.synthesizeText;
 export const updateMessageMetadata = api.updateMessageMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.7-dev.202607101106.c87f4e3",
+  "version": "0.10.7-dev.202607101343.e727d4c",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",