@microsoft/teams.ai 0.2.7

package/dist/message.d.ts

@@ -0,0 +1,76 @@
+import { Citation } from './citation.js';
+import { FunctionCall } from './function.js';
+import './schema.js';
+
+type Message = UserMessage | ModelMessage | SystemMessage | FunctionMessage;
+type UserMessage = {
+    role: 'user';
+    content: string | ContentPart[];
+};
+type ModelMessage = {
+    role: 'model';
+    audio?: MessageAudio;
+    content?: string;
+    context?: MessageContext;
+    function_calls?: FunctionCall[];
+};
+type SystemMessage = {
+    role: 'system';
+    content: string;
+};
+type FunctionMessage = {
+    role: 'function';
+    content?: string;
+    function_id: string;
+};
+type ContentPart = TextContentPart | ImageContentPart;
+type TextContentPart = {
+    type: 'text';
+    text: string;
+};
+type ImageContentPart = {
+    type: 'image_url';
+    image_url: string;
+};
+/**
+ * A representation of the additional context information available when Azure OpenAI chat extensions are involved
+ * in the generation of a corresponding chat completions response. This context information is only populated when
+ * using an Azure OpenAI request configured to use a matching extension.
+ */
+type MessageContext = {
+    /**
+     * The contextual information associated with the Azure chat extensions used for a chat completions request.
+     * These messages describe the data source retrievals, plugin invocations, and other intermediate steps taken in the
+     * course of generating a chat completions response that was augmented by capabilities from Azure OpenAI chat
+     * extensions.
+     */
+    citations?: Array<Citation>;
+    /** The detected intent from the chat history, used to pass to the next turn to carry over the context. */
+    intent?: string;
+};
+/**
+ * If the audio output modality is requested, this object contains data about the
+ * audio response from the model.
+ */
+type MessageAudio = {
+    /**
+     * Unique identifier for this audio response.
+     */
+    id: string;
+    /**
+     * Base64 encoded audio bytes generated by the model, in the format specified in
+     * the request.
+     */
+    data: string;
+    /**
+     * The Unix timestamp (in seconds) for when this audio response will no longer be
+     * accessible on the server for use in multi-turn conversations.
+     */
+    expires_at: number;
+    /**
+     * Transcript of the audio generated by the model.
+     */
+    transcript: string;
+};
+
+export type { ContentPart, FunctionMessage, ImageContentPart, Message, MessageAudio, MessageContext, ModelMessage, SystemMessage, TextContentPart, UserMessage };

package/dist/message.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=message.js.map
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"message.js"}

package/dist/message.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=message.mjs.map
+//# sourceMappingURL=message.mjs.map

package/dist/message.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"message.mjs"}

package/dist/models/audio.d.mts

@@ -0,0 +1,27 @@
+type TextToAudioParams = {
+    readonly type: string;
+    readonly text: string;
+    readonly voice: string;
+};
+type AudioToTextParams = {
+    readonly type: string;
+    readonly data: Buffer;
+    readonly prompt?: string;
+    readonly lang?: string;
+};
+/**
+ * a model that can convert text to audio
+ * or audio to text
+ */
+interface IAudioModel {
+    /**
+     * convert text to audio
+     */
+    textToAudio?(params: TextToAudioParams): Promise<Buffer>;
+    /**
+     * transcribe audio to text
+     */
+    audioToText?(params: AudioToTextParams): Promise<string>;
+}
+
+export type { AudioToTextParams, IAudioModel, TextToAudioParams };

package/dist/models/audio.d.ts

@@ -0,0 +1,27 @@
+type TextToAudioParams = {
+    readonly type: string;
+    readonly text: string;
+    readonly voice: string;
+};
+type AudioToTextParams = {
+    readonly type: string;
+    readonly data: Buffer;
+    readonly prompt?: string;
+    readonly lang?: string;
+};
+/**
+ * a model that can convert text to audio
+ * or audio to text
+ */
+interface IAudioModel {
+    /**
+     * convert text to audio
+     */
+    textToAudio?(params: TextToAudioParams): Promise<Buffer>;
+    /**
+     * transcribe audio to text
+     */
+    audioToText?(params: AudioToTextParams): Promise<string>;
+}
+
+export type { AudioToTextParams, IAudioModel, TextToAudioParams };

package/dist/models/audio.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=audio.js.map
+//# sourceMappingURL=audio.js.map

package/dist/models/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"audio.js"}

package/dist/models/audio.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=audio.mjs.map
+//# sourceMappingURL=audio.mjs.map

package/dist/models/audio.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"audio.mjs"}

package/dist/models/chat.d.mts

@@ -0,0 +1,46 @@
+import { Function } from '../function.mjs';
+import { IMemory } from '../memory.mjs';
+import { Message, SystemMessage, UserMessage, ModelMessage } from '../message.mjs';
+import '../schema.mjs';
+import '@microsoft/teams.common';
+import '../citation.mjs';
+
+type TextChunkHandler = (chunk: string) => void | Promise<void>;
+type ChatSendOptions<TOptions = Record<string, any>> = {
+    /**
+     * the initial system/user message that defines
+     * model behavior
+     */
+    readonly system?: SystemMessage | UserMessage;
+    /**
+     * the conversation history
+     */
+    readonly messages?: IMemory;
+    /**
+     * the registered functions
+     */
+    readonly functions?: Record<string, Function>;
+    /**
+     * the request option overrides
+     */
+    readonly request?: TOptions;
+    /**
+     * the handler to call with each
+     * stream chunk
+     */
+    readonly onChunk?: TextChunkHandler;
+};
+/**
+ * a conversational model for sending and receiving
+ * messages
+ */
+interface IChatModel<TOptions = Record<string, any>> {
+    /**
+     * send a message to the model
+     * @param input the message to send
+     * @param options the send options
+     */
+    send(input: Message, options?: ChatSendOptions<TOptions>): Promise<ModelMessage>;
+}
+
+export type { ChatSendOptions, IChatModel, TextChunkHandler };

package/dist/models/chat.d.ts

@@ -0,0 +1,46 @@
+import { Function } from '../function.js';
+import { IMemory } from '../memory.js';
+import { Message, SystemMessage, UserMessage, ModelMessage } from '../message.js';
+import '../schema.js';
+import '@microsoft/teams.common';
+import '../citation.js';
+
+type TextChunkHandler = (chunk: string) => void | Promise<void>;
+type ChatSendOptions<TOptions = Record<string, any>> = {
+    /**
+     * the initial system/user message that defines
+     * model behavior
+     */
+    readonly system?: SystemMessage | UserMessage;
+    /**
+     * the conversation history
+     */
+    readonly messages?: IMemory;
+    /**
+     * the registered functions
+     */
+    readonly functions?: Record<string, Function>;
+    /**
+     * the request option overrides
+     */
+    readonly request?: TOptions;
+    /**
+     * the handler to call with each
+     * stream chunk
+     */
+    readonly onChunk?: TextChunkHandler;
+};
+/**
+ * a conversational model for sending and receiving
+ * messages
+ */
+interface IChatModel<TOptions = Record<string, any>> {
+    /**
+     * send a message to the model
+     * @param input the message to send
+     * @param options the send options
+     */
+    send(input: Message, options?: ChatSendOptions<TOptions>): Promise<ModelMessage>;
+}
+
+export type { ChatSendOptions, IChatModel, TextChunkHandler };

package/dist/models/chat.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chat.js.map
+//# sourceMappingURL=chat.js.map

package/dist/models/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chat.js"}

package/dist/models/chat.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chat.mjs.map
+//# sourceMappingURL=chat.mjs.map

package/dist/models/chat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chat.mjs"}

package/dist/models/image.d.mts

@@ -0,0 +1,22 @@
+type TextToImageParams = {
+    /**
+     * the prompt that defines how
+     * the image should be made
+     */
+    readonly prompt?: string;
+    /**
+     * the desired size of the image
+     */
+    readonly size?: string;
+};
+/**
+ * a model that can generate an image from text
+ */
+interface IImageModel {
+    /**
+     * generate an image from text
+     */
+    textToImage?(params?: TextToImageParams): Promise<string>;
+}
+
+export type { IImageModel, TextToImageParams };

package/dist/models/image.d.ts

@@ -0,0 +1,22 @@
+type TextToImageParams = {
+    /**
+     * the prompt that defines how
+     * the image should be made
+     */
+    readonly prompt?: string;
+    /**
+     * the desired size of the image
+     */
+    readonly size?: string;
+};
+/**
+ * a model that can generate an image from text
+ */
+interface IImageModel {
+    /**
+     * generate an image from text
+     */
+    textToImage?(params?: TextToImageParams): Promise<string>;
+}
+
+export type { IImageModel, TextToImageParams };

package/dist/models/image.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=image.js.map
+//# sourceMappingURL=image.js.map

package/dist/models/image.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"image.js"}

package/dist/models/image.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=image.mjs.map
+//# sourceMappingURL=image.mjs.map

package/dist/models/image.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"image.mjs"}

package/dist/models/index.d.mts

@@ -0,0 +1,16 @@
+import { IAudioModel } from './audio.mjs';
+export { AudioToTextParams, TextToAudioParams } from './audio.mjs';
+import { IImageModel } from './image.mjs';
+export { TextToImageParams } from './image.mjs';
+import { IChatModel } from './chat.mjs';
+export { ChatSendOptions, TextChunkHandler } from './chat.mjs';
+import '../function.mjs';
+import '../schema.mjs';
+import '../memory.mjs';
+import '@microsoft/teams.common';
+import '../message.mjs';
+import '../citation.mjs';
+
+type Model = IChatModel | IAudioModel | IImageModel;
+
+export { IAudioModel, IChatModel, IImageModel, type Model };

package/dist/models/index.d.ts

@@ -0,0 +1,16 @@
+import { IAudioModel } from './audio.js';
+export { AudioToTextParams, TextToAudioParams } from './audio.js';
+import { IImageModel } from './image.js';
+export { TextToImageParams } from './image.js';
+import { IChatModel } from './chat.js';
+export { ChatSendOptions, TextChunkHandler } from './chat.js';
+import '../function.js';
+import '../schema.js';
+import '../memory.js';
+import '@microsoft/teams.common';
+import '../message.js';
+import '../citation.js';
+
+type Model = IChatModel | IAudioModel | IImageModel;
+
+export { IAudioModel, IChatModel, IImageModel, type Model };

package/dist/models/index.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var chat = require('./chat');
+var audio = require('./audio');
+var image = require('./image');
+
+
+
+Object.keys(chat).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return chat[k]; }
+	});
+});
+Object.keys(audio).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return audio[k]; }
+	});
+});
+Object.keys(image).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return image[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/models/index.mjs

@@ -0,0 +1,5 @@
+export * from './chat';
+export * from './audio';
+export * from './image';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/models/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs","sourcesContent":[]}

package/dist/prompts/audio.d.mts

@@ -0,0 +1,54 @@
+import { IAudioModel, TextToAudioParams, AudioToTextParams } from '../models/audio.mjs';
+
+type AudioPromptOptions = {
+    /**
+     * the name of the prompt
+     */
+    readonly name?: string;
+    /**
+     * the description of the prompt
+     */
+    readonly description?: string;
+    /**
+     * the model to send requests to
+     */
+    readonly model: IAudioModel;
+};
+/**
+ * a prompt that can interface with
+ * an audio model
+ */
+interface IAudioPrompt {
+    /**
+     * the prompt name
+     */
+    readonly name: string;
+    /**
+     * the prompt description
+     */
+    readonly description: string;
+    /**
+     * convert text to audio
+     */
+    textToAudio?(params: TextToAudioParams): Promise<Buffer>;
+    /**
+     * transcribe audio to text
+     */
+    audioToText?(params: AudioToTextParams): Promise<string>;
+}
+/**
+ * a prompt that can interface with
+ * an audio model
+ */
+declare class AudioPrompt implements IAudioPrompt {
+    get name(): string;
+    protected readonly _name: string;
+    get description(): string;
+    protected readonly _description: string;
+    protected readonly _model: IAudioModel;
+    constructor(options: AudioPromptOptions);
+    audioToText(params: AudioToTextParams): Promise<string>;
+    textToAudio(params: TextToAudioParams): Promise<Buffer<ArrayBufferLike>>;
+}
+
+export { AudioPrompt, type AudioPromptOptions, type IAudioPrompt };

package/dist/prompts/audio.d.ts

@@ -0,0 +1,54 @@
+import { IAudioModel, TextToAudioParams, AudioToTextParams } from '../models/audio.js';
+
+type AudioPromptOptions = {
+    /**
+     * the name of the prompt
+     */
+    readonly name?: string;
+    /**
+     * the description of the prompt
+     */
+    readonly description?: string;
+    /**
+     * the model to send requests to
+     */
+    readonly model: IAudioModel;
+};
+/**
+ * a prompt that can interface with
+ * an audio model
+ */
+interface IAudioPrompt {
+    /**
+     * the prompt name
+     */
+    readonly name: string;
+    /**
+     * the prompt description
+     */
+    readonly description: string;
+    /**
+     * convert text to audio
+     */
+    textToAudio?(params: TextToAudioParams): Promise<Buffer>;
+    /**
+     * transcribe audio to text
+     */
+    audioToText?(params: AudioToTextParams): Promise<string>;
+}
+/**
+ * a prompt that can interface with
+ * an audio model
+ */
+declare class AudioPrompt implements IAudioPrompt {
+    get name(): string;
+    protected readonly _name: string;
+    get description(): string;
+    protected readonly _description: string;
+    protected readonly _model: IAudioModel;
+    constructor(options: AudioPromptOptions);
+    audioToText(params: AudioToTextParams): Promise<string>;
+    textToAudio(params: TextToAudioParams): Promise<Buffer<ArrayBufferLike>>;
+}
+
+export { AudioPrompt, type AudioPromptOptions, type IAudioPrompt };

package/dist/prompts/audio.js

@@ -0,0 +1,34 @@
+'use strict';
+
+class AudioPrompt {
+  get name() {
+    return this._name;
+  }
+  _name;
+  get description() {
+    return this._description;
+  }
+  _description;
+  _model;
+  constructor(options) {
+    this._name = options.name || "audio";
+    this._description = options.description || "an agent that can convert text to speech";
+    this._model = options.model;
+  }
+  audioToText(params) {
+    if (!this._model.audioToText) {
+      throw new Error("cannot transcribe audio to text");
+    }
+    return this._model.audioToText(params);
+  }
+  textToAudio(params) {
+    if (!this._model.textToAudio) {
+      throw new Error("cannot translate text to audio");
+    }
+    return this._model.textToAudio(params);
+  }
+}
+
+exports.AudioPrompt = AudioPrompt;
+//# sourceMappingURL=audio.js.map
+//# sourceMappingURL=audio.js.map

package/dist/prompts/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/prompts/audio.ts"],"names":[],"mappings":";;AAiDO,MAAM,WAAoC,CAAA;AAAA,EAC/C,IAAI,IAAO,GAAA;AACT,IAAA,OAAO,IAAK,CAAA,KAAA;AAAA;AACd,EACmB,KAAA;AAAA,EAEnB,IAAI,WAAc,GAAA;AAChB,IAAA,OAAO,IAAK,CAAA,YAAA;AAAA;AACd,EACmB,YAAA;AAAA,EAEA,MAAA;AAAA,EAEnB,YAAY,OAA6B,EAAA;AACvC,IAAK,IAAA,CAAA,KAAA,GAAQ,QAAQ,IAAQ,IAAA,OAAA;AAC7B,IAAK,IAAA,CAAA,YAAA,GAAe,QAAQ,WAAe,IAAA,0CAAA;AAC3C,IAAA,IAAA,CAAK,SAAS,OAAQ,CAAA,KAAA;AAAA;AACxB,EAEA,YAAY,MAA2B,EAAA;AACrC,IAAI,IAAA,CAAC,IAAK,CAAA,MAAA,CAAO,WAAa,EAAA;AAC5B,MAAM,MAAA,IAAI,MAAM,iCAAiC,CAAA;AAAA;AAGnD,IAAO,OAAA,IAAA,CAAK,MAAO,CAAA,WAAA,CAAY,MAAM,CAAA;AAAA;AACvC,EAEA,YAAY,MAA2B,EAAA;AACrC,IAAI,IAAA,CAAC,IAAK,CAAA,MAAA,CAAO,WAAa,EAAA;AAC5B,MAAM,MAAA,IAAI,MAAM,gCAAgC,CAAA;AAAA;AAGlD,IAAO,OAAA,IAAA,CAAK,MAAO,CAAA,WAAA,CAAY,MAAM,CAAA;AAAA;AAEzC","file":"audio.js","sourcesContent":["import { IAudioModel, AudioToTextParams, TextToAudioParams } from '../models';\n\nexport type AudioPromptOptions = {\n  /**\n   * the name of the prompt\n   */\n  readonly name?: string;\n\n  /**\n   * the description of the prompt\n   */\n  readonly description?: string;\n\n  /**\n   * the model to send requests to\n   */\n  readonly model: IAudioModel;\n};\n\n/**\n * a prompt that can interface with\n * an audio model\n */\nexport interface IAudioPrompt {\n  /**\n   * the prompt name\n   */\n  readonly name: string;\n\n  /**\n   * the prompt description\n   */\n  readonly description: string;\n\n  /**\n   * convert text to audio\n   */\n  textToAudio?(params: TextToAudioParams): Promise<Buffer>;\n\n  /**\n   * transcribe audio to text\n   */\n  audioToText?(params: AudioToTextParams): Promise<string>;\n}\n\n/**\n * a prompt that can interface with\n * an audio model\n */\nexport class AudioPrompt implements IAudioPrompt {\n  get name() {\n    return this._name;\n  }\n  protected readonly _name: string;\n\n  get description() {\n    return this._description;\n  }\n  protected readonly _description: string;\n\n  protected readonly _model: IAudioModel;\n\n  constructor(options: AudioPromptOptions) {\n    this._name = options.name || 'audio';\n    this._description = options.description || 'an agent that can convert text to speech';\n    this._model = options.model;\n  }\n\n  audioToText(params: AudioToTextParams) {\n    if (!this._model.audioToText) {\n      throw new Error('cannot transcribe audio to text');\n    }\n\n    return this._model.audioToText(params);\n  }\n\n  textToAudio(params: TextToAudioParams) {\n    if (!this._model.textToAudio) {\n      throw new Error('cannot translate text to audio');\n    }\n\n    return this._model.textToAudio(params);\n  }\n}\n"]}

package/dist/prompts/audio.mjs

@@ -0,0 +1,32 @@
+class AudioPrompt {
+  get name() {
+    return this._name;
+  }
+  _name;
+  get description() {
+    return this._description;
+  }
+  _description;
+  _model;
+  constructor(options) {
+    this._name = options.name || "audio";
+    this._description = options.description || "an agent that can convert text to speech";
+    this._model = options.model;
+  }
+  audioToText(params) {
+    if (!this._model.audioToText) {
+      throw new Error("cannot transcribe audio to text");
+    }
+    return this._model.audioToText(params);
+  }
+  textToAudio(params) {
+    if (!this._model.textToAudio) {
+      throw new Error("cannot translate text to audio");
+    }
+    return this._model.textToAudio(params);
+  }
+}
+
+export { AudioPrompt };
+//# sourceMappingURL=audio.mjs.map
+//# sourceMappingURL=audio.mjs.map

package/dist/prompts/audio.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/prompts/audio.ts"],"names":[],"mappings":"AAiDO,MAAM,WAAoC,CAAA;AAAA,EAC/C,IAAI,IAAO,GAAA;AACT,IAAA,OAAO,IAAK,CAAA,KAAA;AAAA;AACd,EACmB,KAAA;AAAA,EAEnB,IAAI,WAAc,GAAA;AAChB,IAAA,OAAO,IAAK,CAAA,YAAA;AAAA;AACd,EACmB,YAAA;AAAA,EAEA,MAAA;AAAA,EAEnB,YAAY,OAA6B,EAAA;AACvC,IAAK,IAAA,CAAA,KAAA,GAAQ,QAAQ,IAAQ,IAAA,OAAA;AAC7B,IAAK,IAAA,CAAA,YAAA,GAAe,QAAQ,WAAe,IAAA,0CAAA;AAC3C,IAAA,IAAA,CAAK,SAAS,OAAQ,CAAA,KAAA;AAAA;AACxB,EAEA,YAAY,MAA2B,EAAA;AACrC,IAAI,IAAA,CAAC,IAAK,CAAA,MAAA,CAAO,WAAa,EAAA;AAC5B,MAAM,MAAA,IAAI,MAAM,iCAAiC,CAAA;AAAA;AAGnD,IAAO,OAAA,IAAA,CAAK,MAAO,CAAA,WAAA,CAAY,MAAM,CAAA;AAAA;AACvC,EAEA,YAAY,MAA2B,EAAA;AACrC,IAAI,IAAA,CAAC,IAAK,CAAA,MAAA,CAAO,WAAa,EAAA;AAC5B,MAAM,MAAA,IAAI,MAAM,gCAAgC,CAAA;AAAA;AAGlD,IAAO,OAAA,IAAA,CAAK,MAAO,CAAA,WAAA,CAAY,MAAM,CAAA;AAAA;AAEzC","file":"audio.mjs","sourcesContent":["import { IAudioModel, AudioToTextParams, TextToAudioParams } from '../models';\n\nexport type AudioPromptOptions = {\n  /**\n   * the name of the prompt\n   */\n  readonly name?: string;\n\n  /**\n   * the description of the prompt\n   */\n  readonly description?: string;\n\n  /**\n   * the model to send requests to\n   */\n  readonly model: IAudioModel;\n};\n\n/**\n * a prompt that can interface with\n * an audio model\n */\nexport interface IAudioPrompt {\n  /**\n   * the prompt name\n   */\n  readonly name: string;\n\n  /**\n   * the prompt description\n   */\n  readonly description: string;\n\n  /**\n   * convert text to audio\n   */\n  textToAudio?(params: TextToAudioParams): Promise<Buffer>;\n\n  /**\n   * transcribe audio to text\n   */\n  audioToText?(params: AudioToTextParams): Promise<string>;\n}\n\n/**\n * a prompt that can interface with\n * an audio model\n */\nexport class AudioPrompt implements IAudioPrompt {\n  get name() {\n    return this._name;\n  }\n  protected readonly _name: string;\n\n  get description() {\n    return this._description;\n  }\n  protected readonly _description: string;\n\n  protected readonly _model: IAudioModel;\n\n  constructor(options: AudioPromptOptions) {\n    this._name = options.name || 'audio';\n    this._description = options.description || 'an agent that can convert text to speech';\n    this._model = options.model;\n  }\n\n  audioToText(params: AudioToTextParams) {\n    if (!this._model.audioToText) {\n      throw new Error('cannot transcribe audio to text');\n    }\n\n    return this._model.audioToText(params);\n  }\n\n  textToAudio(params: TextToAudioParams) {\n    if (!this._model.textToAudio) {\n      throw new Error('cannot translate text to audio');\n    }\n\n    return this._model.textToAudio(params);\n  }\n}\n"]}