@signalhousellc/sdk 1.0.65 → 1.0.67

package/src/domains/Agents.js

@@ -0,0 +1,456 @@
+/**
+ * @typedef {Object} CreateAgentProfileData
+ * @property {string} groupId - The parent group id (at least 8 characters, starts with 'G').
+ * @property {string|null} [subgroupId] - Optional subgroup id (at least 8 characters, starts with 'S'); null/omitted = group-level agent.
+ * @property {string} name - The agent's name (required).
+ * @property {string} [status] - Lifecycle status: "active" or "inactive" (defaults to "active").
+ * @property {string} [systemPrompt] - Base system prompt composed into every conversation.
+ * @property {string} [greeting] - Opening line the agent leads with.
+ * @property {string} [guardrails] - Freeform guardrail instructions appended to the composed prompt.
+ * @property {string|null} [voiceId] - ElevenLabs voice id for the voice channel; null until set.
+ * @property {string} [llmProvider] - LLM backend: "bedrock", "openai", "anthropic", or "groq" (defaults to "bedrock").
+ * @property {string|null} [llmModel] - Concrete model id for the provider; null = provider default.
+ * @property {number} [temperature] - Sampling temperature (0-2).
+ */
+
+/**
+ * @typedef {Object} UpdateAgentProfileData
+ * @property {string} [name] - The agent's name.
+ * @property {string} [status] - Lifecycle status: "active" or "inactive".
+ * @property {string} [systemPrompt] - Base system prompt composed into every conversation.
+ * @property {string} [greeting] - Opening line the agent leads with.
+ * @property {string} [guardrails] - Freeform guardrail instructions appended to the composed prompt.
+ * @property {string|null} [voiceId] - ElevenLabs voice id for the voice channel.
+ * @property {string} [llmProvider] - LLM backend: "bedrock", "openai", "anthropic", or "groq".
+ * @property {string|null} [llmModel] - Concrete model id for the provider; null = provider default.
+ * @property {number} [temperature] - Sampling temperature (0-2).
+ */
+
+export class Agents {
+	constructor(client, enableAdmin) {
+		this.client = client;
+		this.enableAdmin = enableAdmin;
+	}
+
+	/**
+	 * List the agent profiles under a group.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing agent profiles.
+	 * @param {string} params.groupId - The group whose profiles to list (required).
+	 * @param {number} [params.page] - The page number for pagination.
+	 * @param {number} [params.limit] - The number of items per page for pagination.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The list of agent profiles returned from the server.
+	 */
+	async getAgentProfiles({ groupId, page, limit, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, page, limit });
+		return this.client(`/agent/profiles${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Get a single agent profile by id.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting an agent profile.
+	 * @param {string} params.agentProfileId - The id of the agent profile to fetch.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentProfileId parameter is missing.
+	 * @returns {Promise<Object>} - The agent profile returned from the server.
+	 */
+	async getAgentProfile({ agentProfileId, options = {} }) {
+		this.client._require({ agentProfileId });
+		const safeId = encodeURIComponent(agentProfileId);
+		return this.client(`/agent/profiles/${safeId}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create a new agent profile.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for creating an agent profile (see CreateAgentProfileData typedef).
+	 * @param {CreateAgentProfileData} params.profileData - The data for the agent profile to create, including required fields groupId and name.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the profileData parameter is missing.
+	 * @returns {Promise<Object>} - The created agent profile returned from the server.
+	 */
+	async createAgentProfile({ profileData, options = {} }) {
+		this.client._require({ profileData });
+		return this.client(`/agent/profiles`, { method: "POST", body: profileData, ...options });
+	}
+
+	/**
+	 * Update an existing agent profile.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for updating an agent profile (see UpdateAgentProfileData typedef).
+	 * @param {string} params.id - The id of the agent profile to update.
+	 * @param {UpdateAgentProfileData} params.updateData - The data for the agent profile to update.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id or updateData parameter is missing.
+	 * @returns {Promise<Object>} - The updated agent profile returned from the server.
+	 */
+	async updateAgentProfile({ id, updateData, options = {} }) {
+		this.client._require({ id, updateData });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/profiles/${safeId}`, { method: "PUT", body: updateData, ...options });
+	}
+
+	/**
+	 * Delete (inactivate) an agent profile by its id.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for deleting an agent profile.
+	 * @param {string} params.id - The id of the agent profile to delete.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id parameter is missing.
+	 * @returns {Promise<Object>} - The inactivated agent profile returned from the server.
+	 */
+	async deleteAgentProfile({ id, options = {} }) {
+		this.client._require({ id });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/profiles/${safeId}`, { method: "DELETE", ...options });
+	}
+
+	/**
+	 * Send a message to an agent and get its reply — the app-native conversation
+	 * endpoint (webchat / SMS). Omit conversationId to start a new conversation, or
+	 * pass one to continue an existing one. Runs the agent's LLM tool loop server-side
+	 * and returns the assistant's reply along with any tools it invoked.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for sending a message.
+	 * @param {string} params.agentProfileId - The agent to talk to (required).
+	 * @param {string} params.channel - The channel: "webchat", "sms", or "voice" (required).
+	 * @param {string} params.message - The user's message (required).
+	 * @param {string} [params.conversationId] - Continue this conversation; omit to start a new one.
+	 * @param {string} [params.contactIdentifier] - The far-end identifier (webchat visitor id, sender number).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if agentProfileId, channel, or message is missing.
+	 * @returns {Promise<Object>} - `{ conversationId, conversationSessionId, reply, toolInvocations, ok }` from the server.
+	 */
+	async sendAgentMessage({ agentProfileId, channel, message, conversationId, contactIdentifier, options = {} }) {
+		this.client._require({ agentProfileId, channel, message });
+		const body = { agentProfileId, channel, message };
+		if (conversationId !== undefined && conversationId !== null) body.conversationId = conversationId;
+		if (contactIdentifier !== undefined && contactIdentifier !== null) body.contactIdentifier = contactIdentifier;
+		return this.client(`/agent/messages`, { method: "POST", body, ...options });
+	}
+
+	/**
+	 * List an agent's per-channel settings (the tools enabled per channel, whether the
+	 * channel is on, and any channel-specific prompt/greeting).
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing channel settings.
+	 * @param {string} params.agentProfileId - The agent whose channel settings to list.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentProfileId parameter is missing.
+	 * @returns {Promise<Object>} - The agent's channel settings returned from the server.
+	 */
+	async getAgentChannelSettings({ agentProfileId, options = {} }) {
+		this.client._require({ agentProfileId });
+		const safeId = encodeURIComponent(agentProfileId);
+		return this.client(`/agent/profiles/${safeId}/channels`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Get a single per-channel setting for an agent.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting a channel setting.
+	 * @param {string} params.agentProfileId - The agent the setting belongs to.
+	 * @param {string} params.channel - The channel: "webchat", "sms", or "voice".
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if agentProfileId or channel is missing.
+	 * @returns {Promise<Object>} - The channel setting returned from the server.
+	 */
+	async getAgentChannelSetting({ agentProfileId, channel, options = {} }) {
+		this.client._require({ agentProfileId, channel });
+		const safeId = encodeURIComponent(agentProfileId);
+		const safeChannel = encodeURIComponent(channel);
+		return this.client(`/agent/profiles/${safeId}/channels/${safeChannel}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create or update (upsert) an agent's per-channel setting. One row per (agent, channel);
+	 * the channel is taken from the path, the fields from settingData.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the upsert.
+	 * @param {string} params.agentProfileId - The agent the setting belongs to.
+	 * @param {string} params.channel - The channel: "webchat", "sms", or "voice".
+	 * @param {Object} [params.settingData] - The fields to set: allowedTools (string[]), enabled (boolean), channelPrompt (string), greeting (string|null).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if agentProfileId or channel is missing.
+	 * @returns {Promise<Object>} - The created or updated channel setting returned from the server.
+	 */
+	async upsertAgentChannelSetting({ agentProfileId, channel, settingData = {}, options = {} }) {
+		this.client._require({ agentProfileId, channel });
+		const safeId = encodeURIComponent(agentProfileId);
+		const safeChannel = encodeURIComponent(channel);
+		return this.client(`/agent/profiles/${safeId}/channels/${safeChannel}`, { method: "PUT", body: settingData, ...options });
+	}
+
+	/**
+	 * Delete an agent's per-channel setting.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the delete.
+	 * @param {string} params.agentProfileId - The agent the setting belongs to.
+	 * @param {string} params.channel - The channel: "webchat", "sms", or "voice".
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if agentProfileId or channel is missing.
+	 * @returns {Promise<Object>} - The delete confirmation returned from the server.
+	 */
+	async deleteAgentChannelSetting({ agentProfileId, channel, options = {} }) {
+		this.client._require({ agentProfileId, channel });
+		const safeId = encodeURIComponent(agentProfileId);
+		const safeChannel = encodeURIComponent(channel);
+		return this.client(`/agent/profiles/${safeId}/channels/${safeChannel}`, { method: "DELETE", ...options });
+	}
+
+	/**
+	 * Read the tenant AI settings for a scope (group, or a subgroup within it) — brand, tone,
+	 * timezone, business hours, and after-hours message. Returns the scope's own row only (no
+	 * group-level fallback).
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for reading tenant settings.
+	 * @param {string} params.groupId - The group (required).
+	 * @param {string} [params.subgroupId] - The subgroup; omit for the group-level settings.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The tenant settings returned from the server.
+	 */
+	async getTenantAiSettings({ groupId, subgroupId, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId });
+		return this.client(`/agent/tenant-settings${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create or update (upsert) the tenant AI settings for a scope. The scope is identified by
+	 * the query params; the body carries the settings fields.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the upsert.
+	 * @param {string} params.groupId - The group (required).
+	 * @param {string} [params.subgroupId] - The subgroup; omit for the group-level settings.
+	 * @param {Object} [params.settingsData] - Fields to set: brandName (string), tone (string), timezone (IANA string), businessHours (array of {day, closed, open, close}), afterHoursMessage (string).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The created or updated tenant settings returned from the server.
+	 */
+	async upsertTenantAiSettings({ groupId, subgroupId, settingsData = {}, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId });
+		return this.client(`/agent/tenant-settings${queryString}`, { method: "PUT", body: settingsData, ...options });
+	}
+
+	/**
+	 * Delete the tenant AI settings for a scope.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the delete.
+	 * @param {string} params.groupId - The group (required).
+	 * @param {string} [params.subgroupId] - The subgroup; omit for the group-level settings.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The delete confirmation returned from the server.
+	 */
+	async deleteTenantAiSettings({ groupId, subgroupId, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId });
+		return this.client(`/agent/tenant-settings${queryString}`, { method: "DELETE", ...options });
+	}
+
+	/**
+	 * List the knowledge-base items an agent can answer from (RAG), scoped to a group and
+	 * optionally narrowed to a subgroup and/or a single agent.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing knowledge items.
+	 * @param {string} params.groupId - The group whose knowledge to list (required).
+	 * @param {string} [params.subgroupId] - Narrow to a subgroup.
+	 * @param {string} [params.agentProfileId] - Narrow to one agent.
+	 * @param {number} [params.page] - Page number (1-based) for pagination.
+	 * @param {number} [params.limit] - Items per page (max 100; server default 25).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The knowledge items returned from the server.
+	 */
+	async getKnowledgeItems({ groupId, subgroupId, agentProfileId, page, limit, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId, agentProfileId, page, limit });
+		return this.client(`/agent/knowledge${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Get a single knowledge item by id.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting a knowledge item.
+	 * @param {string} params.knowledgeItemId - The id of the knowledge item to fetch.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the knowledgeItemId parameter is missing.
+	 * @returns {Promise<Object>} - The knowledge item returned from the server.
+	 */
+	async getKnowledgeItem({ knowledgeItemId, options = {} }) {
+		this.client._require({ knowledgeItemId });
+		const safeId = encodeURIComponent(knowledgeItemId);
+		return this.client(`/agent/knowledge/${safeId}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create a knowledge item. The raw `text` is stored and Atlas Vector Search owns the
+	 * embedding — there is no embedding to supply.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for creating a knowledge item.
+	 * @param {Object} params.itemData - The knowledge fields. Required: groupId (starts with 'G'), text.
+	 *                                   Optional: subgroupId (starts with 'S', nullable), agentProfileId
+	 *                                   (nullable = shared across the tenant's agents), title, source
+	 *                                   ("manual" | "url" | "document" | "import"), enabled (boolean), metadata (object|null).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the itemData parameter is missing.
+	 * @returns {Promise<Object>} - The created knowledge item returned from the server.
+	 */
+	async createKnowledgeItem({ itemData, options = {} }) {
+		this.client._require({ itemData });
+		return this.client(`/agent/knowledge`, { method: "POST", body: itemData, ...options });
+	}
+
+	/**
+	 * Update a knowledge item. The item's scope (group/subgroup/agent) is immutable and
+	 * cannot be changed.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for updating a knowledge item.
+	 * @param {string} params.id - The id of the knowledge item to update.
+	 * @param {Object} params.updateData - The fields to update: title, text, source, enabled, metadata.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id or updateData parameter is missing.
+	 * @returns {Promise<Object>} - The updated knowledge item returned from the server.
+	 */
+	async updateKnowledgeItem({ id, updateData, options = {} }) {
+		this.client._require({ id, updateData });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/knowledge/${safeId}`, { method: "PUT", body: updateData, ...options });
+	}
+
+	/**
+	 * Delete a knowledge item by its id.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for deleting a knowledge item.
+	 * @param {string} params.id - The id of the knowledge item to delete.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id parameter is missing.
+	 * @returns {Promise<Object>} - The delete confirmation returned from the server.
+	 */
+	async deleteKnowledgeItem({ id, options = {} }) {
+		this.client._require({ id });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/knowledge/${safeId}`, { method: "DELETE", ...options });
+	}
+
+	/**
+	 * List the tools defined under a group — custom webhook tools, configured built-ins, and
+	 * (future) MCP. `webhookAuth` secrets are redacted in the response.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing tools.
+	 * @param {string} params.groupId - The group whose tools to list (required).
+	 * @param {string} [params.subgroupId] - Narrow to a subgroup.
+	 * @param {string} [params.agentProfileId] - Narrow to one agent.
+	 * @param {string} [params.type] - Narrow to a tool type: "builtin", "webhook", or "mcp".
+	 * @param {number} [params.page] - Page number (1-based) for pagination.
+	 * @param {number} [params.limit] - Items per page (max 100; server default 25).
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<Object>} - The tools returned from the server (secrets redacted).
+	 */
+	async getAgentTools({ groupId, subgroupId, agentProfileId, type, page, limit, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId, agentProfileId, type, page, limit });
+		return this.client(`/agent/tools${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Get a single agent tool by id. `webhookAuth` secrets are redacted in the response.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting a tool.
+	 * @param {string} params.agentToolId - The id of the tool to fetch.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentToolId parameter is missing.
+	 * @returns {Promise<Object>} - The tool returned from the server (secrets redacted).
+	 */
+	async getAgentTool({ agentToolId, options = {} }) {
+		this.client._require({ agentToolId });
+		const safeId = encodeURIComponent(agentToolId);
+		return this.client(`/agent/tools/${safeId}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create an agent tool. For a webhook tool, `webhookUrl` must be an https URL that does not
+	 * target a private/internal address (rejected otherwise). `webhookAuth` is stored and never
+	 * echoed back.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for creating a tool.
+	 * @param {Object} params.toolData - The tool fields. Required: groupId (starts with 'G'), name, description.
+	 *                                   Type-specific: type ("builtin" | "webhook" | "mcp"); webhook → webhookUrl, builtin →
+	 *                                   builtinKey, mcp → mcpServerUrl. Optional: subgroupId, agentProfileId (nullable = shared),
+	 *                                   parametersSchema, config, channels (string[]), enabled (boolean), and webhookAuth —
+	 *                                   which MUST be `{ headers?: { [name]: value }, signingSecret?: string }` (any other shape,
+	 *                                   e.g. `{ header, value }`, is rejected with a 400). `headers` are sent verbatim on every
+	 *                                   call (reserved/framing and `x-signalhouse-*` names are rejected); `signingSecret` makes us
+	 *                                   send `X-SignalHouse-Signature: sha256=HMAC-SHA256(`${X-SignalHouse-Timestamp}.${rawBody}`)`
+	 *                                   so you can verify the call and reject replays. Stored, never returned.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the toolData parameter is missing.
+	 * @returns {Promise<Object>} - The created tool returned from the server (secrets redacted).
+	 */
+	async createAgentTool({ toolData, options = {} }) {
+		this.client._require({ toolData });
+		return this.client(`/agent/tools`, { method: "POST", body: toolData, ...options });
+	}
+
+	/**
+	 * Update an agent tool. The tool's scope (group/subgroup/agent) is immutable. A supplied
+	 * `webhookUrl` is SSRF-checked.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for updating a tool.
+	 * @param {string} params.id - The id of the tool to update.
+	 * @param {Object} params.updateData - The fields to update: name, description, type, builtinKey, parametersSchema, config, webhookUrl, webhookAuth, mcpServerUrl, channels, enabled.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id or updateData parameter is missing.
+	 * @returns {Promise<Object>} - The updated tool returned from the server (secrets redacted).
+	 */
+	async updateAgentTool({ id, updateData, options = {} }) {
+		this.client._require({ id, updateData });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/tools/${safeId}`, { method: "PUT", body: updateData, ...options });
+	}
+
+	/**
+	 * Delete an agent tool by its id.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for deleting a tool.
+	 * @param {string} params.id - The id of the tool to delete.
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the id parameter is missing.
+	 * @returns {Promise<Object>} - The delete confirmation returned from the server.
+	 */
+	async deleteAgentTool({ id, options = {} }) {
+		this.client._require({ id });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/agent/tools/${safeId}`, { method: "DELETE", ...options });
+	}
+}