@azure/ai-projects 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/commonjs/agents/traceUtility.js

@@ -1,136 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.traceStartAgentGeneric = traceStartAgentGeneric;
-exports.traceEndAgentGeneric = traceEndAgentGeneric;
-exports.UpdateWithAgentAttributes = UpdateWithAgentAttributes;
-exports.addMessageEvent = addMessageEvent;
-exports.addInstructionsEvent = addInstructionsEvent;
-exports.formatAgentApiResponse = formatAgentApiResponse;
-exports.addToolMessagesEvent = addToolMessagesEvent;
-const tracing_js_1 = require("../tracing.js");
-const telemetry_js_1 = require("../telemetry/telemetry.js");
-function traceStartAgentGeneric(span, options) {
-    var _a;
-    const attributeOptions = options.tracingAttributeOptions || {};
-    tracing_js_1.TracingUtility.setSpanAttributes(span, ((_a = options.tracingAttributeOptions) === null || _a === void 0 ? void 0 : _a.operationName) || "Agent_Operation", UpdateWithAgentAttributes(attributeOptions));
-}
-function traceEndAgentGeneric(span, _options) {
-    const attributeOptions = {};
-    tracing_js_1.TracingUtility.updateSpanAttributes(span, UpdateWithAgentAttributes(attributeOptions));
-}
-function UpdateWithAgentAttributes(attributeOptions) {
-    attributeOptions.genAiSystem = tracing_js_1.TracingAttributes.AZ_AI_AGENT_SYSTEM;
-    return attributeOptions;
-}
-/**
- * Adds a message event to the span.
- * @param span - The span to add the event to.
- * @param messageAttributes - The attributes of the message event.
- */
-function addMessageEvent(span, messageAttributes, usage) {
-    var _a;
-    const eventBody = {};
-    const telemetryOptions = (0, telemetry_js_1.getTelemetryOptions)();
-    if (telemetryOptions.enableContentRecording) {
-        eventBody.content = getMessageContent(messageAttributes.content);
-    }
-    eventBody.role = messageAttributes.role;
-    if (messageAttributes.attachments) {
-        eventBody.attachments = messageAttributes.attachments.map((attachment) => {
-            return {
-                id: attachment.file_id,
-                tools: attachment.tools.map((tool) => tool.type),
-            };
-        });
-    }
-    const threadId = messageAttributes.thread_id;
-    const agentId = (_a = messageAttributes.assistant_id) !== null && _a !== void 0 ? _a : undefined;
-    const threadRunId = messageAttributes.run_id;
-    const messageStatus = messageAttributes.status;
-    const messageId = messageAttributes.id;
-    const incompleteDetails = messageAttributes.incomplete_details;
-    if (incompleteDetails) {
-        eventBody.incomplete_details = incompleteDetails;
-    }
-    const usagePromptTokens = usage === null || usage === void 0 ? void 0 : usage.prompt_tokens;
-    const usageCompletionTokens = usage === null || usage === void 0 ? void 0 : usage.completion_tokens;
-    const attributes = {
-        eventContent: JSON.stringify(eventBody),
-        threadId,
-        agentId,
-        threadRunId,
-        messageStatus,
-        messageId,
-        usagePromptTokens,
-        usageCompletionTokens,
-        genAiSystem: tracing_js_1.TracingAttributes.AZ_AI_AGENT_SYSTEM,
-    };
-    tracing_js_1.TracingUtility.addSpanEvent(span, `gen_ai.${messageAttributes.role}.message`, attributes);
-}
-/**
- * Adds an instruction event to the span.
- * @param span - The span to add the event to.
- * @param instructionAttributes - The attributes of the instruction event.
- */
-function addInstructionsEvent(span, instructionAttributes) {
-    const eventBody = {};
-    if (instructionAttributes.instructions || instructionAttributes.additional_instructions) {
-        eventBody.content =
-            instructionAttributes.instructions && instructionAttributes.additional_instructions
-                ? `${instructionAttributes.instructions} ${instructionAttributes.additional_instructions}`
-                : instructionAttributes.instructions || instructionAttributes.additional_instructions;
-    }
-    const attributes = {
-        eventContent: JSON.stringify(eventBody),
-        threadId: instructionAttributes.threadId,
-        agentId: instructionAttributes.agentId,
-        genAiSystem: tracing_js_1.TracingAttributes.AZ_AI_AGENT_SYSTEM,
-    };
-    tracing_js_1.TracingUtility.addSpanEvent(span, "gen_ai.system.message", attributes);
-}
-/**
- * Formats the agent API response.
- * @param responseFormat - The response format option.
- * @returns The formatted response as a string, or null/undefined.
- */
-function formatAgentApiResponse(responseFormat) {
-    var _a;
-    if (typeof responseFormat === "string" ||
-        responseFormat === undefined ||
-        responseFormat === null) {
-        return responseFormat !== null && responseFormat !== void 0 ? responseFormat : undefined;
-    }
-    if (responseFormat.type) {
-        return (_a = responseFormat.type) !== null && _a !== void 0 ? _a : undefined;
-    }
-    return undefined;
-}
-/**
- * Adds a tool messages event to the span
- * @param span - The span to add the event to.
- * @param tool_outputs - List of tool oupts
- */
-function addToolMessagesEvent(span, tool_outputs) {
-    tool_outputs.forEach((tool_output) => {
-        const eventBody = { content: tool_output.output, id: tool_output.tool_call_id };
-        tracing_js_1.TracingUtility.addSpanEvent(span, "gen_ai.tool.message", {
-            eventContent: JSON.stringify(eventBody),
-            genAiSystem: tracing_js_1.TracingAttributes.AZ_AI_AGENT_SYSTEM,
-        });
-    });
-}
-function getMessageContent(messageContent) {
-    if (!Array.isArray(messageContent)) {
-        return messageContent;
-    }
-    const contentBody = {};
-    messageContent.forEach((content) => {
-        const typedContent = content.type;
-        const { value, annotations } = content[typedContent];
-        contentBody[typedContent] = { value, annotations };
-    });
-    return contentBody;
-}
-//# sourceMappingURL=traceUtility.js.map

package/dist/commonjs/agents/traceUtility.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"traceUtility.js","sourceRoot":"","sources":["../../../src/agents/traceUtility.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  AgentsApiResponseFormat,\n  AgentsApiResponseFormatOption,\n  ThreadMessageOptions,\n  ToolOutput,\n} from \"../generated/src/models.js\";\nimport type {\n  MessageContentOutput,\n  RunStepCompletionUsageOutput,\n  ThreadMessageOutput,\n} from \"../generated/src/outputModels.js\";\nimport type { OptionsWithTracing, Span, TracingAttributeOptions } from \"../tracing.js\";\nimport { TracingAttributes, TracingUtility } from \"../tracing.js\";\nimport { getTelemetryOptions } from \"../telemetry/telemetry.js\";\n\nexport function traceStartAgentGeneric<Options extends OptionsWithTracing>(\n  span: Span,\n  options: Options,\n): void {\n  const attributeOptions = options.tracingAttributeOptions || {};\n  TracingUtility.setSpanAttributes(\n    span,\n    options.tracingAttributeOptions?.operationName || \"Agent_Operation\",\n    UpdateWithAgentAttributes(attributeOptions),\n  );\n}\nexport function traceEndAgentGeneric<Options extends OptionsWithTracing>(\n  span: Span,\n  _options: Options,\n): void {\n  const attributeOptions = {};\n  TracingUtility.updateSpanAttributes(span, UpdateWithAgentAttributes(attributeOptions));\n}\n\nexport function UpdateWithAgentAttributes(\n  attributeOptions: Omit<TracingAttributeOptions, \"operationName\">,\n): Omit<TracingAttributeOptions, \"operationName\"> {\n  attributeOptions.genAiSystem = TracingAttributes.AZ_AI_AGENT_SYSTEM;\n  return attributeOptions;\n}\n\n/**\n * Adds a message event to the span.\n * @param span - The span to add the event to.\n * @param messageAttributes - The attributes of the message event.\n */\nexport function addMessageEvent(\n  span: Span,\n  messageAttributes: ThreadMessageOptions | ThreadMessageOutput,\n  usage?: RunStepCompletionUsageOutput,\n): void {\n  const eventBody: Record<string, unknown> = {};\n  const telemetryOptions = getTelemetryOptions();\n  if (telemetryOptions.enableContentRecording) {\n    eventBody.content = getMessageContent(messageAttributes.content);\n  }\n  eventBody.role = messageAttributes.role;\n  if (messageAttributes.attachments) {\n    eventBody.attachments = messageAttributes.attachments.map((attachment) => {\n      return {\n        id: attachment.file_id,\n        tools: attachment.tools.map((tool) => tool.type),\n      };\n    });\n  }\n  const threadId = (messageAttributes as ThreadMessageOutput).thread_id;\n  const agentId = (messageAttributes as ThreadMessageOutput).assistant_id ?? undefined;\n  const threadRunId = (messageAttributes as ThreadMessageOutput).run_id;\n  const messageStatus = (messageAttributes as ThreadMessageOutput).status;\n  const messageId = (messageAttributes as ThreadMessageOutput).id;\n  const incompleteDetails = (messageAttributes as ThreadMessageOutput).incomplete_details;\n  if (incompleteDetails) {\n    eventBody.incomplete_details = incompleteDetails;\n  }\n  const usagePromptTokens = usage?.prompt_tokens;\n  const usageCompletionTokens = usage?.completion_tokens;\n  const attributes = {\n    eventContent: JSON.stringify(eventBody),\n    threadId,\n    agentId,\n    threadRunId,\n    messageStatus,\n    messageId,\n    usagePromptTokens,\n    usageCompletionTokens,\n    genAiSystem: TracingAttributes.AZ_AI_AGENT_SYSTEM,\n  };\n\n  TracingUtility.addSpanEvent(span, `gen_ai.${messageAttributes.role}.message`, attributes);\n}\n\n/**\n * Adds an instruction event to the span.\n * @param span - The span to add the event to.\n * @param instructionAttributes - The attributes of the instruction event.\n */\nexport function addInstructionsEvent(\n  span: Span,\n  instructionAttributes: {\n    instructions?: string | null;\n    additional_instructions?: string | null;\n    threadId?: string;\n    agentId?: string;\n  },\n): void {\n  const eventBody: Record<string, unknown> = {};\n  if (instructionAttributes.instructions || instructionAttributes.additional_instructions) {\n    eventBody.content =\n      instructionAttributes.instructions && instructionAttributes.additional_instructions\n        ? `${instructionAttributes.instructions} ${instructionAttributes.additional_instructions}`\n        : instructionAttributes.instructions || instructionAttributes.additional_instructions;\n  }\n  const attributes = {\n    eventContent: JSON.stringify(eventBody),\n    threadId: instructionAttributes.threadId,\n    agentId: instructionAttributes.agentId,\n    genAiSystem: TracingAttributes.AZ_AI_AGENT_SYSTEM,\n  };\n  TracingUtility.addSpanEvent(span, \"gen_ai.system.message\", attributes);\n}\n\n/**\n * Formats the agent API response.\n * @param responseFormat - The response format option.\n * @returns The formatted response as a string, or null/undefined.\n */\nexport function formatAgentApiResponse(\n  responseFormat: AgentsApiResponseFormatOption | null | undefined,\n): string | undefined {\n  if (\n    typeof responseFormat === \"string\" ||\n    responseFormat === undefined ||\n    responseFormat === null\n  ) {\n    return responseFormat ?? undefined;\n  }\n  if ((responseFormat as AgentsApiResponseFormat).type) {\n    return (responseFormat as AgentsApiResponseFormat).type ?? undefined;\n  }\n  return undefined;\n}\n\n/**\n * Adds a tool messages event to the span\n * @param span - The span to add the event to.\n * @param tool_outputs - List of tool oupts\n */\nexport function addToolMessagesEvent(span: Span, tool_outputs: Array<ToolOutput>): void {\n  tool_outputs.forEach((tool_output) => {\n    const eventBody = { content: tool_output.output, id: tool_output.tool_call_id };\n    TracingUtility.addSpanEvent(span, \"gen_ai.tool.message\", {\n      eventContent: JSON.stringify(eventBody),\n      genAiSystem: TracingAttributes.AZ_AI_AGENT_SYSTEM,\n    });\n  });\n}\n\nfunction getMessageContent(messageContent: string | MessageContentOutput[]): string | {} {\n  type MessageContentExtended = MessageContentOutput & { [key: string]: any };\n  if (!Array.isArray(messageContent)) {\n    return messageContent;\n  }\n  const contentBody: { [key: string]: any } = {};\n  messageContent.forEach((content) => {\n    const typedContent = content.type;\n    const { value, annotations } = (content as MessageContentExtended)[typedContent];\n    contentBody[typedContent] = { value, annotations };\n  });\n  return contentBody;\n}\n"]}

package/dist/commonjs/agents/utils.d.ts

@@ -1,209 +0,0 @@
-import type { AzureAISearchToolDefinition, AzureFunctionToolDefinition, CodeInterpreterToolDefinition, FileSearchToolDefinition, FileSearchToolDefinitionDetails, FunctionDefinition, FunctionToolDefinition, OpenApiFunctionDefinition, OpenApiToolDefinition, RequiredActionOutput, RequiredToolCallOutput, ToolDefinition, ToolDefinitionOutputParent, ToolResources, VectorStoreConfigurations, VectorStoreDataSource, AzureFunctionStorageQueue, AzureFunctionDefinition } from "./inputOutputs.js";
-/**
- * Determines if the given output is of the specified type.
- *
- * @typeParam T - The type to check against, which extends one of the possible output parent types.
- * @param output - The action to check, which can be of type `RequiredActionOutput`, `RequiredToolCallOutput`, or `ToolDefinitionOutputParent`.
- * @param type - The type to check the action against.
- * @returns A boolean indicating whether the action is of the specified type.
- */
-export declare function isOutputOfType<T extends {
-    type: string;
-}>(output: RequiredActionOutput | RequiredToolCallOutput | ToolDefinitionOutputParent, type: string): output is T;
-/** Types of connection tools used to configure an agent */
-export declare enum connectionToolType {
-    /** Bing grounding search tool */
-    BingGrounding = "bing_grounding",
-    /** Microsoft Fabric tool */
-    MicrosoftFabric = "fabric_dataagent",
-    /** Sharepoint tool */
-    SharepointGrounding = "sharepoint_grounding",
-    /** Azure Function tool */
-    AzureFunction = "azure_function"
-}
-/**
- * Utility class for creating various tools.
- */
-export declare class ToolUtility {
-    /**
-     * Creates a connection tool
-     *
-     * @param toolType - The type of the connection tool.
-     * @param connectionIds - A list of the IDs of the connections to use.
-     * @returns An object containing the definition for the connection tool
-     */
-    static createConnectionTool(toolType: connectionToolType, connectionIds: string[]): {
-        definition: ToolDefinition;
-    };
-    /**
-     * Creates a file search tool
-     *
-     * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.
-     * @param vectorStores - The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.
-     * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.
-     *
-     * @returns An object containing the definition and resources for the file search tool
-     */
-    static createFileSearchTool(vectorStoreIds?: string[], vectorStores?: Array<VectorStoreConfigurations>, definitionDetails?: FileSearchToolDefinitionDetails): {
-        definition: FileSearchToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Creates a code interpreter tool
-     *
-     * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.
-     * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.
-     *
-     * @returns An object containing the definition and resources for the code interpreter tool.
-     */
-    static createCodeInterpreterTool(fileIds?: string[], dataSources?: Array<VectorStoreDataSource>): {
-        definition: CodeInterpreterToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Creates an Azure Function tool
-     * @param name - The name of the Azure Function.
-     * @param description - The description of the Azure Function.
-     * @param parameters - The parameters of the Azure Function.
-     * @param inputQueue - The input queue configuration.
-     * @param outputQueue - The output queue configuration.
-     * @returns An object containing the definition and resources for the Azure Function tool.
-     */
-    static createAzureFunctionTool(name: string, description: string, parameters: unknown, inputQueue: AzureFunctionStorageQueue, outputQueue: AzureFunctionStorageQueue, definitionDetails: AzureFunctionDefinition): {
-        definition: AzureFunctionToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Creates an Azure AI search tool
-     *
-     * @param indexConnectionId - The connection ID of the Azure AI search index.
-     * @param indexName - The name of the Azure AI search index.
-     *
-     * @returns An object containing the definition and resources for the Azure AI search tool.
-     */
-    static createAzureAISearchTool(indexConnectionId: string, indexName: string): {
-        definition: AzureAISearchToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Creates a Microsoft Fabric tool
-     *
-     * @param connectionIds - A list of the IDs of the Fabric connections to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    static createFabricTool(connectionId: string): {
-        definition: ToolDefinition;
-    };
-    /**
-     * Creates a function tool
-     *
-     * @param functionDefinition - The function definition to use.
-     *
-     * @returns An object containing the definition for the function tool.
-     */
-    static createFunctionTool(functionDefinition: FunctionDefinition): {
-        definition: FunctionToolDefinition;
-    };
-    /**
-     * Creates an OpenApi tool
-     *
-     * @param openApiFunctionDefinition - The OpenApi function definition to use.
-     *
-     * @returns An object containing the definition for the OpenApi tool.
-     */
-    static createOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {
-        definition: OpenApiToolDefinition;
-    };
-}
-/**
- * Represents a set of tools with their definitions and resources.
- */
-export declare class ToolSet {
-    /** A list of tool definitions that have been added to the tool set. */
-    toolDefinitions: ToolDefinition[];
-    /** A collection of resources associated with the tools in the tool set. */
-    toolResources: ToolResources;
-    /**
-     * Adds a connection tool to the tool set.
-     *
-     * @param toolType - The type of the connection tool.
-     * @param connectionIds - A list of the IDs of the connections to use.
-     *
-     * @returns An object containing the definition for the connection tool
-     */
-    addConnectionTool(toolType: connectionToolType, connectionIds: string[]): {
-        definition: ToolDefinition;
-    };
-    /**
-     * Adds a file search tool to the tool set.
-     *
-     * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.
-     * @param vectorStores -  The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.
-     * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.
-     *
-     * @returns An object containing the definition and resources for the file search tool
-     */
-    addFileSearchTool(vectorStoreIds?: string[], vectorStores?: Array<VectorStoreConfigurations>, definitionDetails?: FileSearchToolDefinitionDetails): {
-        definition: FileSearchToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Adds a code interpreter tool to the tool set.
-     *
-     * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.
-     * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.
-     *
-     * @returns An object containing the definition and resources for the code interpreter tool
-     */
-    addCodeInterpreterTool(fileIds?: string[], dataSources?: Array<VectorStoreDataSource>): {
-        definition: CodeInterpreterToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Adds an Azure AI search tool to the tool set.
-     *
-     * @param indexConnectionId - The connection ID of the Azure AI search index.
-     * @param indexName - The name of the Azure AI search index.
-     *
-     * @returns An object containing the definition and resources for the Azure AI search tool
-     */
-    addAzureAISearchTool(indexConnectionId: string, indexName: string): {
-        definition: AzureAISearchToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Adds an OpenApi tool to the tool set.
-     *
-     * @param openApiFunctionDefinition - The OpenApi function definition to use.
-     *
-     * @returns An object containing the definition for the OpenApi tool
-     */
-    addOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {
-        definition: OpenApiToolDefinition;
-    };
-    /**
-     * Adds an Azure Function tool to the tool set.
-     *
-     * @param name - The name of the Azure Function.
-     * @param description - The description of the Azure Function.
-     * @param parameters - The parameters of the Azure Function.
-     * @param inputQueue - The input queue configuration.
-     * @param outputQueue - The output queue configuration.
-     *
-     * @returns An object containing the definition and resources for the Azure Function tool.
-     */
-    addAzureFunctionTool(name: string, description: string, parameters: unknown, inputQueue: AzureFunctionStorageQueue, outputQueue: AzureFunctionStorageQueue, definitionDetails: AzureFunctionDefinition): {
-        definition: AzureFunctionToolDefinition;
-        resources: ToolResources;
-    };
-    /**
-     * Adds a Microsoft Fabric tool to the tool set.
-     *
-     * @param connectionId - The ID of the Fabric connection to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    addFabricTool(connectionId: string): {
-        definition: ToolDefinition;
-    };
-}
-//# sourceMappingURL=utils.d.ts.map

package/dist/commonjs/agents/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/agents/utils.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/agents/utils.js

@@ -1,286 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolSet = exports.ToolUtility = exports.connectionToolType = void 0;
-exports.isOutputOfType = isOutputOfType;
-/**
- * Determines if the given output is of the specified type.
- *
- * @typeParam T - The type to check against, which extends one of the possible output parent types.
- * @param output - The action to check, which can be of type `RequiredActionOutput`, `RequiredToolCallOutput`, or `ToolDefinitionOutputParent`.
- * @param type - The type to check the action against.
- * @returns A boolean indicating whether the action is of the specified type.
- */
-function isOutputOfType(output, type) {
-    return output.type === type;
-}
-/** Types of connection tools used to configure an agent */
-var connectionToolType;
-(function (connectionToolType) {
-    /** Bing grounding search tool */
-    connectionToolType["BingGrounding"] = "bing_grounding";
-    /** Microsoft Fabric tool */
-    connectionToolType["MicrosoftFabric"] = "fabric_dataagent";
-    /** Sharepoint tool */
-    connectionToolType["SharepointGrounding"] = "sharepoint_grounding";
-    /** Azure Function tool */
-    connectionToolType["AzureFunction"] = "azure_function";
-})(connectionToolType || (exports.connectionToolType = connectionToolType = {}));
-const toolMap = {
-    bing_grounding: "bingGrounding",
-    fabric_dataagent: "fabric_dataagent",
-    sharepoint_grounding: "sharepointGrounding",
-    azure_function: "azureFunction",
-};
-/**
- * Utility class for creating various tools.
- */
-class ToolUtility {
-    /**
-     * Creates a connection tool
-     *
-     * @param toolType - The type of the connection tool.
-     * @param connectionIds - A list of the IDs of the connections to use.
-     * @returns An object containing the definition for the connection tool
-     */
-    static createConnectionTool(toolType, connectionIds) {
-        return {
-            definition: {
-                type: toolType,
-                [toolMap[toolType]]: {
-                    connections: connectionIds.map((connectionId) => ({ connectionId: connectionId })),
-                },
-            },
-        };
-    }
-    /**
-     * Creates a file search tool
-     *
-     * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.
-     * @param vectorStores - The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.
-     * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.
-     *
-     * @returns An object containing the definition and resources for the file search tool
-     */
-    static createFileSearchTool(vectorStoreIds, vectorStores, definitionDetails) {
-        return {
-            definition: { type: "file_search", fileSearch: definitionDetails },
-            resources: { fileSearch: { vectorStoreIds: vectorStoreIds, vectorStores: vectorStores } },
-        };
-    }
-    /**
-     * Creates a code interpreter tool
-     *
-     * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.
-     * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.
-     *
-     * @returns An object containing the definition and resources for the code interpreter tool.
-     */
-    static createCodeInterpreterTool(fileIds, dataSources) {
-        if (fileIds && dataSources) {
-            throw new Error("Cannot specify both fileIds and dataSources");
-        }
-        return {
-            definition: { type: "code_interpreter" },
-            resources: { codeInterpreter: { fileIds: fileIds, dataSources: dataSources } },
-        };
-    }
-    /**
-     * Creates an Azure Function tool
-     * @param name - The name of the Azure Function.
-     * @param description - The description of the Azure Function.
-     * @param parameters - The parameters of the Azure Function.
-     * @param inputQueue - The input queue configuration.
-     * @param outputQueue - The output queue configuration.
-     * @returns An object containing the definition and resources for the Azure Function tool.
-     */
-    static createAzureFunctionTool(name, description, parameters, inputQueue, outputQueue, definitionDetails) {
-        return {
-            definition: { type: "azure_function", azureFunction: definitionDetails },
-            resources: {
-                azureFunction: {
-                    name: name,
-                    description: description,
-                    parameters: parameters,
-                    inputQueue: inputQueue,
-                    outputQueue: outputQueue,
-                },
-            },
-        };
-    }
-    /**
-     * Creates an Azure AI search tool
-     *
-     * @param indexConnectionId - The connection ID of the Azure AI search index.
-     * @param indexName - The name of the Azure AI search index.
-     *
-     * @returns An object containing the definition and resources for the Azure AI search tool.
-     */
-    static createAzureAISearchTool(indexConnectionId, indexName) {
-        return {
-            definition: { type: "azure_ai_search" },
-            resources: {
-                azureAISearch: {
-                    indexes: [{ indexConnectionId: indexConnectionId, indexName: indexName }],
-                },
-            },
-        };
-    }
-    /**
-     * Creates a Microsoft Fabric tool
-     *
-     * @param connectionIds - A list of the IDs of the Fabric connections to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    static createFabricTool(connectionId) {
-        return {
-            definition: {
-                type: "fabric_dataagent",
-                fabricDataAgent: {
-                    connections: [{ connectionId: connectionId }],
-                },
-            },
-        };
-    }
-    /**
-     * Creates a function tool
-     *
-     * @param functionDefinition - The function definition to use.
-     *
-     * @returns An object containing the definition for the function tool.
-     */
-    static createFunctionTool(functionDefinition) {
-        return {
-            definition: {
-                type: "function",
-                function: functionDefinition,
-            },
-        };
-    }
-    /**
-     * Creates an OpenApi tool
-     *
-     * @param openApiFunctionDefinition - The OpenApi function definition to use.
-     *
-     * @returns An object containing the definition for the OpenApi tool.
-     */
-    static createOpenApiTool(openApiFunctionDefinition) {
-        return {
-            definition: {
-                type: "openapi",
-                openapi: openApiFunctionDefinition,
-            },
-        };
-    }
-}
-exports.ToolUtility = ToolUtility;
-/**
- * Represents a set of tools with their definitions and resources.
- */
-class ToolSet {
-    constructor() {
-        /** A list of tool definitions that have been added to the tool set. */
-        this.toolDefinitions = [];
-        /** A collection of resources associated with the tools in the tool set. */
-        this.toolResources = {};
-    }
-    /**
-     * Adds a connection tool to the tool set.
-     *
-     * @param toolType - The type of the connection tool.
-     * @param connectionIds - A list of the IDs of the connections to use.
-     *
-     * @returns An object containing the definition for the connection tool
-     */
-    addConnectionTool(toolType, connectionIds) {
-        const tool = ToolUtility.createConnectionTool(toolType, connectionIds);
-        this.toolDefinitions.push(tool.definition);
-        return tool;
-    }
-    /**
-     * Adds a file search tool to the tool set.
-     *
-     * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.
-     * @param vectorStores -  The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.
-     * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.
-     *
-     * @returns An object containing the definition and resources for the file search tool
-     */
-    addFileSearchTool(vectorStoreIds, vectorStores, definitionDetails) {
-        const tool = ToolUtility.createFileSearchTool(vectorStoreIds, vectorStores, definitionDetails);
-        this.toolDefinitions.push(tool.definition);
-        this.toolResources = Object.assign(Object.assign({}, this.toolResources), tool.resources);
-        return tool;
-    }
-    /**
-     * Adds a code interpreter tool to the tool set.
-     *
-     * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.
-     * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.
-     *
-     * @returns An object containing the definition and resources for the code interpreter tool
-     */
-    addCodeInterpreterTool(fileIds, dataSources) {
-        const tool = ToolUtility.createCodeInterpreterTool(fileIds, dataSources);
-        this.toolDefinitions.push(tool.definition);
-        this.toolResources = Object.assign(Object.assign({}, this.toolResources), tool.resources);
-        return tool;
-    }
-    /**
-     * Adds an Azure AI search tool to the tool set.
-     *
-     * @param indexConnectionId - The connection ID of the Azure AI search index.
-     * @param indexName - The name of the Azure AI search index.
-     *
-     * @returns An object containing the definition and resources for the Azure AI search tool
-     */
-    addAzureAISearchTool(indexConnectionId, indexName) {
-        const tool = ToolUtility.createAzureAISearchTool(indexConnectionId, indexName);
-        this.toolDefinitions.push(tool.definition);
-        this.toolResources = Object.assign(Object.assign({}, this.toolResources), tool.resources);
-        return tool;
-    }
-    /**
-     * Adds an OpenApi tool to the tool set.
-     *
-     * @param openApiFunctionDefinition - The OpenApi function definition to use.
-     *
-     * @returns An object containing the definition for the OpenApi tool
-     */
-    addOpenApiTool(openApiFunctionDefinition) {
-        const tool = ToolUtility.createOpenApiTool(openApiFunctionDefinition);
-        this.toolDefinitions.push(tool.definition);
-        return tool;
-    }
-    /**
-     * Adds an Azure Function tool to the tool set.
-     *
-     * @param name - The name of the Azure Function.
-     * @param description - The description of the Azure Function.
-     * @param parameters - The parameters of the Azure Function.
-     * @param inputQueue - The input queue configuration.
-     * @param outputQueue - The output queue configuration.
-     *
-     * @returns An object containing the definition and resources for the Azure Function tool.
-     */
-    addAzureFunctionTool(name, description, parameters, inputQueue, outputQueue, definitionDetails) {
-        const tool = ToolUtility.createAzureFunctionTool(name, description, parameters, inputQueue, outputQueue, definitionDetails);
-        this.toolDefinitions.push(tool.definition);
-        this.toolResources = Object.assign(Object.assign({}, this.toolResources), tool.resources);
-        return tool;
-    }
-    /**
-     * Adds a Microsoft Fabric tool to the tool set.
-     *
-     * @param connectionId - The ID of the Fabric connection to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    addFabricTool(connectionId) {
-        const tool = ToolUtility.createFabricTool(connectionId);
-        this.toolDefinitions.push(tool.definition);
-        return tool;
-    }
-}
-exports.ToolSet = ToolSet;
-//# sourceMappingURL=utils.js.map