@zavudev/sdk 0.16.0 → 0.18.0

package/resources/senders/agent/knowledge-bases/knowledge-bases.d.ts

@@ -0,0 +1,147 @@
+import { APIResource } from "../../../../core/resource.js";
+import * as DocumentsAPI from "./documents.js";
+import { DocumentCreateParams, DocumentCreateResponse, DocumentDeleteParams, DocumentListParams, Documents } from "./documents.js";
+import { APIPromise } from "../../../../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../../../../core/pagination.js";
+import { RequestOptions } from "../../../../internal/request-options.js";
+export declare class KnowledgeBases extends APIResource {
+    documents: DocumentsAPI.Documents;
+    /**
+     * Create a new knowledge base for an agent.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.create(
+     *     'senderId',
+     *     {
+     *       name: 'Product FAQ',
+     *       description:
+     *         'Frequently asked questions about our products',
+     *     },
+     *   );
+     * ```
+     */
+    create(senderID: string, body: KnowledgeBaseCreateParams, options?: RequestOptions): APIPromise<KnowledgeBaseCreateResponse>;
+    /**
+     * Get a specific knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.retrieve(
+     *     'kbId',
+     *     { senderId: 'senderId' },
+     *   );
+     * ```
+     */
+    retrieve(kbID: string, params: KnowledgeBaseRetrieveParams, options?: RequestOptions): APIPromise<KnowledgeBaseRetrieveResponse>;
+    /**
+     * Update a knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.update('kbId', {
+     *     senderId: 'senderId',
+     *   });
+     * ```
+     */
+    update(kbID: string, params: KnowledgeBaseUpdateParams, options?: RequestOptions): APIPromise<KnowledgeBaseUpdateResponse>;
+    /**
+     * List knowledge bases for an agent.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentKnowledgeBase of client.senders.agent.knowledgeBases.list(
+     *   'senderId',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(senderID: string, query?: KnowledgeBaseListParams | null | undefined, options?: RequestOptions): PagePromise<AgentKnowledgeBasesCursor, AgentKnowledgeBase>;
+    /**
+     * Delete a knowledge base and all its documents.
+     *
+     * @example
+     * ```ts
+     * await client.senders.agent.knowledgeBases.delete('kbId', {
+     *   senderId: 'senderId',
+     * });
+     * ```
+     */
+    delete(kbID: string, params: KnowledgeBaseDeleteParams, options?: RequestOptions): APIPromise<void>;
+}
+export type AgentKnowledgeBasesCursor = Cursor<AgentKnowledgeBase>;
+export type AgentDocumentsCursor = Cursor<AgentDocument>;
+export interface AgentDocument {
+    id: string;
+    /**
+     * Number of chunks created from this document.
+     */
+    chunkCount: number;
+    /**
+     * Length of the document content in characters.
+     */
+    contentLength: number;
+    createdAt: string;
+    /**
+     * Whether the document has been processed for RAG.
+     */
+    isProcessed: boolean;
+    knowledgeBaseId: string;
+    title: string;
+    updatedAt: string;
+}
+export interface AgentKnowledgeBase {
+    id: string;
+    agentId: string;
+    createdAt: string;
+    documentCount: number;
+    name: string;
+    totalChunks: number;
+    updatedAt: string;
+    description?: string | null;
+}
+export interface KnowledgeBaseCreateResponse {
+    knowledgeBase: AgentKnowledgeBase;
+}
+export interface KnowledgeBaseRetrieveResponse {
+    knowledgeBase: AgentKnowledgeBase;
+}
+export interface KnowledgeBaseUpdateResponse {
+    knowledgeBase: AgentKnowledgeBase;
+}
+export interface KnowledgeBaseCreateParams {
+    name: string;
+    description?: string;
+}
+export interface KnowledgeBaseRetrieveParams {
+    senderId: string;
+}
+export interface KnowledgeBaseUpdateParams {
+    /**
+     * Path param:
+     */
+    senderId: string;
+    /**
+     * Body param:
+     */
+    description?: string | null;
+    /**
+     * Body param:
+     */
+    name?: string;
+}
+export interface KnowledgeBaseListParams extends CursorParams {
+}
+export interface KnowledgeBaseDeleteParams {
+    senderId: string;
+}
+export declare namespace KnowledgeBases {
+    export { type AgentDocument as AgentDocument, type AgentKnowledgeBase as AgentKnowledgeBase, type KnowledgeBaseCreateResponse as KnowledgeBaseCreateResponse, type KnowledgeBaseRetrieveResponse as KnowledgeBaseRetrieveResponse, type KnowledgeBaseUpdateResponse as KnowledgeBaseUpdateResponse, type AgentKnowledgeBasesCursor as AgentKnowledgeBasesCursor, type KnowledgeBaseCreateParams as KnowledgeBaseCreateParams, type KnowledgeBaseRetrieveParams as KnowledgeBaseRetrieveParams, type KnowledgeBaseUpdateParams as KnowledgeBaseUpdateParams, type KnowledgeBaseListParams as KnowledgeBaseListParams, type KnowledgeBaseDeleteParams as KnowledgeBaseDeleteParams, };
+    export { Documents as Documents, type DocumentCreateResponse as DocumentCreateResponse, type DocumentCreateParams as DocumentCreateParams, type DocumentListParams as DocumentListParams, type DocumentDeleteParams as DocumentDeleteParams, };
+}
+//# sourceMappingURL=knowledge-bases.d.ts.map

package/resources/senders/agent/knowledge-bases/knowledge-bases.d.ts.map

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

package/resources/senders/agent/knowledge-bases/knowledge-bases.js

@@ -0,0 +1,106 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeBases = void 0;
+const tslib_1 = require("../../../../internal/tslib.js");
+const resource_1 = require("../../../../core/resource.js");
+const DocumentsAPI = tslib_1.__importStar(require("./documents.js"));
+const documents_1 = require("./documents.js");
+const pagination_1 = require("../../../../core/pagination.js");
+const headers_1 = require("../../../../internal/headers.js");
+const path_1 = require("../../../../internal/utils/path.js");
+class KnowledgeBases extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.documents = new DocumentsAPI.Documents(this._client);
+    }
+    /**
+     * Create a new knowledge base for an agent.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.create(
+     *     'senderId',
+     *     {
+     *       name: 'Product FAQ',
+     *       description:
+     *         'Frequently asked questions about our products',
+     *     },
+     *   );
+     * ```
+     */
+    create(senderID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/senders/${senderID}/agent/knowledge-bases`, { body, ...options });
+    }
+    /**
+     * Get a specific knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.retrieve(
+     *     'kbId',
+     *     { senderId: 'senderId' },
+     *   );
+     * ```
+     */
+    retrieve(kbID, params, options) {
+        const { senderId } = params;
+        return this._client.get((0, path_1.path) `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, options);
+    }
+    /**
+     * Update a knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.update('kbId', {
+     *     senderId: 'senderId',
+     *   });
+     * ```
+     */
+    update(kbID, params, options) {
+        const { senderId, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List knowledge bases for an agent.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentKnowledgeBase of client.senders.agent.knowledgeBases.list(
+     *   'senderId',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(senderID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/senders/${senderID}/agent/knowledge-bases`, (pagination_1.Cursor), { query, ...options });
+    }
+    /**
+     * Delete a knowledge base and all its documents.
+     *
+     * @example
+     * ```ts
+     * await client.senders.agent.knowledgeBases.delete('kbId', {
+     *   senderId: 'senderId',
+     * });
+     * ```
+     */
+    delete(kbID, params, options) {
+        const { senderId } = params;
+        return this._client.delete((0, path_1.path) `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.KnowledgeBases = KnowledgeBases;
+KnowledgeBases.Documents = documents_1.Documents;
+//# sourceMappingURL=knowledge-bases.js.map

package/resources/senders/agent/knowledge-bases/knowledge-bases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.js","sourceRoot":"","sources":["../../../../src/resources/senders/agent/knowledge-bases/knowledge-bases.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,2DAAwD;AACxD,qEAA4C;AAC5C,8CAMqB;AAErB,+DAAqF;AACrF,6DAA4D;AAE5D,6DAAuD;AAEvD,MAAa,cAAe,SAAQ,sBAAW;IAA/C;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgH/E,CAAC;IA9GC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,QAAgB,EAChB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,wBAAwB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,IAAY,EACZ,MAAmC,EACnC,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,IAAY,EACZ,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,QAAgB,EAChB,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,eAAe,QAAQ,wBAAwB,EACnD,CAAA,mBAA0B,CAAA,EAC1B,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAY,EAAE,MAAiC,EAAE,OAAwB;QAC9E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE;YACtF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAjHD,wCAiHC;AAgGD,cAAc,CAAC,SAAS,GAAG,qBAAS,CAAC"}

package/resources/senders/agent/knowledge-bases/knowledge-bases.mjs

@@ -0,0 +1,101 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../core/resource.mjs";
+import * as DocumentsAPI from "./documents.mjs";
+import { Documents, } from "./documents.mjs";
+import { Cursor } from "../../../../core/pagination.mjs";
+import { buildHeaders } from "../../../../internal/headers.mjs";
+import { path } from "../../../../internal/utils/path.mjs";
+export class KnowledgeBases extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.documents = new DocumentsAPI.Documents(this._client);
+    }
+    /**
+     * Create a new knowledge base for an agent.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.create(
+     *     'senderId',
+     *     {
+     *       name: 'Product FAQ',
+     *       description:
+     *         'Frequently asked questions about our products',
+     *     },
+     *   );
+     * ```
+     */
+    create(senderID, body, options) {
+        return this._client.post(path `/v1/senders/${senderID}/agent/knowledge-bases`, { body, ...options });
+    }
+    /**
+     * Get a specific knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.retrieve(
+     *     'kbId',
+     *     { senderId: 'senderId' },
+     *   );
+     * ```
+     */
+    retrieve(kbID, params, options) {
+        const { senderId } = params;
+        return this._client.get(path `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, options);
+    }
+    /**
+     * Update a knowledge base.
+     *
+     * @example
+     * ```ts
+     * const knowledgeBase =
+     *   await client.senders.agent.knowledgeBases.update('kbId', {
+     *     senderId: 'senderId',
+     *   });
+     * ```
+     */
+    update(kbID, params, options) {
+        const { senderId, ...body } = params;
+        return this._client.patch(path `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List knowledge bases for an agent.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentKnowledgeBase of client.senders.agent.knowledgeBases.list(
+     *   'senderId',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(senderID, query = {}, options) {
+        return this._client.getAPIList(path `/v1/senders/${senderID}/agent/knowledge-bases`, (Cursor), { query, ...options });
+    }
+    /**
+     * Delete a knowledge base and all its documents.
+     *
+     * @example
+     * ```ts
+     * await client.senders.agent.knowledgeBases.delete('kbId', {
+     *   senderId: 'senderId',
+     * });
+     * ```
+     */
+    delete(kbID, params, options) {
+        const { senderId } = params;
+        return this._client.delete(path `/v1/senders/${senderId}/agent/knowledge-bases/${kbID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+KnowledgeBases.Documents = Documents;
+//# sourceMappingURL=knowledge-bases.mjs.map

package/resources/senders/agent/knowledge-bases/knowledge-bases.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.mjs","sourceRoot":"","sources":["../../../../src/resources/senders/agent/knowledge-bases/knowledge-bases.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAKL,SAAS,GACV;OAEM,EAAE,MAAM,EAAkC;OAC1C,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,cAAe,SAAQ,WAAW;IAA/C;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgH/E,CAAC;IA9GC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,QAAgB,EAChB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,eAAe,QAAQ,wBAAwB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,IAAY,EACZ,MAAmC,EACnC,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,IAAY,EACZ,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,QAAgB,EAChB,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,eAAe,QAAQ,wBAAwB,EACnD,CAAA,MAA0B,CAAA,EAC1B,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAY,EAAE,MAAiC,EAAE,OAAwB;QAC9E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,eAAe,QAAQ,0BAA0B,IAAI,EAAE,EAAE;YACtF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAgGD,cAAc,CAAC,SAAS,GAAG,SAAS,CAAC"}

package/resources/senders/agent/knowledge-bases.d.mts

@@ -0,0 +1,2 @@
+export * from "./knowledge-bases/index.mjs";
+//# sourceMappingURL=knowledge-bases.d.mts.map

package/resources/senders/agent/knowledge-bases.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.d.mts","sourceRoot":"","sources":["../../../src/resources/senders/agent/knowledge-bases.ts"],"names":[],"mappings":""}

package/resources/senders/agent/knowledge-bases.d.ts

@@ -0,0 +1,2 @@
+export * from "./knowledge-bases/index.js";
+//# sourceMappingURL=knowledge-bases.d.ts.map

package/resources/senders/agent/knowledge-bases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.d.ts","sourceRoot":"","sources":["../../../src/resources/senders/agent/knowledge-bases.ts"],"names":[],"mappings":""}

package/resources/senders/agent/knowledge-bases.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../../internal/tslib.js");
+tslib_1.__exportStar(require("./knowledge-bases/index.js"), exports);
+//# sourceMappingURL=knowledge-bases.js.map

package/resources/senders/agent/knowledge-bases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.js","sourceRoot":"","sources":["../../../src/resources/senders/agent/knowledge-bases.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qEAAwC"}

package/resources/senders/agent/knowledge-bases.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./knowledge-bases/index.mjs";
+//# sourceMappingURL=knowledge-bases.mjs.map

package/resources/senders/agent/knowledge-bases.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.mjs","sourceRoot":"","sources":["../../../src/resources/senders/agent/knowledge-bases.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/senders/agent/tools.d.mts

@@ -0,0 +1,242 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Tools extends APIResource {
+    /**
+     * Create a new tool for an agent. Tools allow the agent to call external webhooks.
+     *
+     * @example
+     * ```ts
+     * const tool = await client.senders.agent.tools.create(
+     *   'senderId',
+     *   {
+     *     description: 'Get the status of a customer order',
+     *     name: 'get_order_status',
+     *     parameters: {
+     *       type: 'object',
+     *       properties: {
+     *         order_id: {
+     *           type: 'string',
+     *           description: 'The order ID to look up',
+     *         },
+     *       },
+     *       required: ['order_id'],
+     *     },
+     *     webhookUrl:
+     *       'https://api.example.com/webhooks/order-status',
+     *     webhookSecret: 'whsec_...',
+     *   },
+     * );
+     * ```
+     */
+    create(senderID: string, body: ToolCreateParams, options?: RequestOptions): APIPromise<ToolCreateResponse>;
+    /**
+     * Get a specific tool.
+     *
+     * @example
+     * ```ts
+     * const tool = await client.senders.agent.tools.retrieve(
+     *   'toolId',
+     *   { senderId: 'senderId' },
+     * );
+     * ```
+     */
+    retrieve(toolID: string, params: ToolRetrieveParams, options?: RequestOptions): APIPromise<ToolRetrieveResponse>;
+    /**
+     * Update a tool.
+     *
+     * @example
+     * ```ts
+     * const tool = await client.senders.agent.tools.update(
+     *   'toolId',
+     *   { senderId: 'senderId' },
+     * );
+     * ```
+     */
+    update(toolID: string, params: ToolUpdateParams, options?: RequestOptions): APIPromise<ToolUpdateResponse>;
+    /**
+     * List tools for an agent.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentTool of client.senders.agent.tools.list(
+     *   'senderId',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(senderID: string, query?: ToolListParams | null | undefined, options?: RequestOptions): PagePromise<AgentToolsCursor, AgentTool>;
+    /**
+     * Delete a tool.
+     *
+     * @example
+     * ```ts
+     * await client.senders.agent.tools.delete('toolId', {
+     *   senderId: 'senderId',
+     * });
+     * ```
+     */
+    delete(toolID: string, params: ToolDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Test a tool by triggering its webhook with test parameters.
+     *
+     * @example
+     * ```ts
+     * const response = await client.senders.agent.tools.test(
+     *   'toolId',
+     *   {
+     *     senderId: 'senderId',
+     *     testParams: { order_id: 'ORD-12345' },
+     *   },
+     * );
+     * ```
+     */
+    test(toolID: string, params: ToolTestParams, options?: RequestOptions): APIPromise<ToolTestResponse>;
+}
+export type AgentToolsCursor = Cursor<AgentTool>;
+export interface AgentTool {
+    id: string;
+    agentId: string;
+    createdAt: string;
+    /**
+     * Description for the LLM to understand when to use this tool.
+     */
+    description: string;
+    enabled: boolean;
+    name: string;
+    parameters: AgentTool.Parameters;
+    updatedAt: string;
+    /**
+     * HTTPS URL to call when the tool is executed.
+     */
+    webhookUrl: string;
+}
+export declare namespace AgentTool {
+    interface Parameters {
+        properties: {
+            [key: string]: Parameters.Properties;
+        };
+        required: Array<string>;
+        type: 'object';
+    }
+    namespace Parameters {
+        interface Properties {
+            description?: string;
+            type?: string;
+        }
+    }
+}
+export interface ToolCreateResponse {
+    tool: AgentTool;
+}
+export interface ToolRetrieveResponse {
+    tool: AgentTool;
+}
+export interface ToolUpdateResponse {
+    tool: AgentTool;
+}
+export interface ToolTestResponse {
+    scheduled: boolean;
+}
+export interface ToolCreateParams {
+    description: string;
+    name: string;
+    parameters: ToolCreateParams.Parameters;
+    /**
+     * Must be HTTPS.
+     */
+    webhookUrl: string;
+    enabled?: boolean;
+    /**
+     * Optional secret for webhook signature verification.
+     */
+    webhookSecret?: string;
+}
+export declare namespace ToolCreateParams {
+    interface Parameters {
+        properties: {
+            [key: string]: Parameters.Properties;
+        };
+        required: Array<string>;
+        type: 'object';
+    }
+    namespace Parameters {
+        interface Properties {
+            description?: string;
+            type?: string;
+        }
+    }
+}
+export interface ToolRetrieveParams {
+    senderId: string;
+}
+export interface ToolUpdateParams {
+    /**
+     * Path param:
+     */
+    senderId: string;
+    /**
+     * Body param:
+     */
+    description?: string;
+    /**
+     * Body param:
+     */
+    enabled?: boolean;
+    /**
+     * Body param:
+     */
+    name?: string;
+    /**
+     * Body param:
+     */
+    parameters?: ToolUpdateParams.Parameters;
+    /**
+     * Body param:
+     */
+    webhookSecret?: string | null;
+    /**
+     * Body param:
+     */
+    webhookUrl?: string;
+}
+export declare namespace ToolUpdateParams {
+    interface Parameters {
+        properties: {
+            [key: string]: Parameters.Properties;
+        };
+        required: Array<string>;
+        type: 'object';
+    }
+    namespace Parameters {
+        interface Properties {
+            description?: string;
+            type?: string;
+        }
+    }
+}
+export interface ToolListParams extends CursorParams {
+    enabled?: boolean;
+}
+export interface ToolDeleteParams {
+    senderId: string;
+}
+export interface ToolTestParams {
+    /**
+     * Path param:
+     */
+    senderId: string;
+    /**
+     * Body param: Parameters to pass to the tool for testing.
+     */
+    testParams: {
+        [key: string]: unknown;
+    };
+}
+export declare namespace Tools {
+    export { type AgentTool as AgentTool, type ToolCreateResponse as ToolCreateResponse, type ToolRetrieveResponse as ToolRetrieveResponse, type ToolUpdateResponse as ToolUpdateResponse, type ToolTestResponse as ToolTestResponse, type AgentToolsCursor as AgentToolsCursor, type ToolCreateParams as ToolCreateParams, type ToolRetrieveParams as ToolRetrieveParams, type ToolUpdateParams as ToolUpdateParams, type ToolListParams as ToolListParams, type ToolDeleteParams as ToolDeleteParams, type ToolTestParams as ToolTestParams, };
+}
+//# sourceMappingURL=tools.d.mts.map

package/resources/senders/agent/tools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.mts","sourceRoot":"","sources":["../../../src/resources/senders/agent/tools.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE;OAE1C,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAI1G;;;;;;;;;;OAUG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;IAKnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAK1G;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAO3C;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQ5F;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAIrG;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,EAAE,OAAO,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC;IAEjC,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,SAAS,CAAC;IACzB,UAAiB,UAAU;QACzB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAA;SAAE,CAAC;QAErD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,EAAE,QAAQ,CAAC;KAChB;IAED,UAAiB,UAAU,CAAC;QAC1B,UAAiB,UAAU;YACzB,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf;KACF;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,EAAE,MAAM,CAAC;IAEb,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;IAExC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,UAAU;QACzB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAA;SAAE,CAAC;QAErD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,EAAE,QAAQ,CAAC;KAChB;IAED,UAAiB,UAAU,CAAC;QAC1B,UAAiB,UAAU;YACzB,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf;KACF;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC;IAEzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,UAAU;QACzB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAA;SAAE,CAAC;QAErD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,EAAE,QAAQ,CAAC;KAChB;IAED,UAAiB,UAAU,CAAC;QAC1B,UAAiB,UAAU;YACzB,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf;KACF;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}