@talqing/sdk 0.11.0 → 0.13.0

package/dist/esm/gen/sdk.gen.js

@@ -885,7 +885,8 @@ export class Calls extends HeyApiClient {
                     { in: 'query', key: 'outcome' },
                     { in: 'query', key: 'contact_key' },
                     { in: 'query', key: 'close_reason' },
-                    { in: 'query', key: 'batch_id' }
+                    { in: 'query', key: 'batch_id' },
+                    { in: 'query', key: 'metadata' }
                 ] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
@@ -1073,8 +1074,9 @@ export class Calls extends HeyApiClient {
      *
      * Mint a token for a new web call that continues one that ended.
      *
-     * It answers with the agent that held the floor, with the context it had. 409
-     * if the call is not a web call, is still ending, or was already resumed.
+     * It answers with the agent that held the floor, with the context it had, in the
+     * dropped call's region unless you pass `region`. 409 if the call is not a web
+     * call, is still ending, or was already resumed.
      */
     resume(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'session_id' }, { key: 'resumeCallRequest', map: 'body' }] }]);
@@ -1468,7 +1470,8 @@ export class Chats extends HeyApiClient {
                     { in: 'query', key: 'offset' },
                     { in: 'query', key: 'agent_id' },
                     { in: 'query', key: 'contact_key' },
-                    { in: 'query', key: 'status' }
+                    { in: 'query', key: 'status' },
+                    { in: 'query', key: 'metadata' }
                 ] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
@@ -1599,6 +1602,30 @@ export class Chats extends HeyApiClient {
     }
 }
 export class Items2 extends HeyApiClient {
+    /**
+     * Create Conversation Item
+     *
+     * Post a template, agent text, note or instruction into a conversation, or start one with a person.
+     */
+    create(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ key: 'postItemRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/conversations/items',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
     /**
      * List Conversation Items
      *
@@ -2748,6 +2775,107 @@ export class Faqs extends HeyApiClient {
         return this._entries ?? (this._entries = new Entries({ client: this.client }));
     }
 }
+export class InboundWebhook extends HeyApiClient {
+    /**
+     * Delete Inbound Webhook
+     *
+     * Remove the inbound session webhook.
+     */
+    delete(options) {
+        return (options?.client ?? this.client).delete({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/inbound-webhook',
+            ...options
+        });
+    }
+    /**
+     * Get Inbound Webhook
+     *
+     * Get the workspace's inbound session webhook.
+     */
+    get(options) {
+        return (options?.client ?? this.client).get({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/inbound-webhook',
+            ...options
+        });
+    }
+    /**
+     * Set Inbound Webhook
+     *
+     * Set the URL asked for an inbound session's configuration.
+     */
+    set(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ key: 'setInboundWebhookRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).put({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/inbound-webhook',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
+    /**
+     * Rotate Inbound Webhook Secret
+     *
+     * Issue a new signing secret; the old one stops working at once.
+     */
+    rotateSecret(options) {
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/inbound-webhook/rotate-secret',
+            ...options
+        });
+    }
+    /**
+     * Test Inbound Webhook
+     *
+     * Send a sample request and check the reply against the response schema.
+     */
+    test(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ key: 'testInboundWebhookRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/inbound-webhook/test',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
+}
 export class McpTools extends HeyApiClient {
     /**
      * List Integration Mcp Tools
@@ -3736,18 +3864,19 @@ export class Telephony extends HeyApiClient {
         return this._providers ?? (this._providers = new Providers({ client: this.client }));
     }
 }
-export class Runs extends HeyApiClient {
+export class TaskRuns extends HeyApiClient {
     /**
      * List Task Runs
      *
-     * This task's runs, newest first, each with its output, trace and cost.
-     *
-     * `task_version` says which published definition each one ran, and is null for
-     * a run of the draft.
+     * Task runs, newest first, without traces or inputs.
      */
     list(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [
-                    { in: 'path', key: 'task_id' },
+                    { in: 'query', key: 'task_id' },
+                    { in: 'query', key: 'status' },
+                    { in: 'query', key: 'metadata' },
+                    { in: 'query', key: 'created_after' },
+                    { in: 'query', key: 'created_before' },
                     { in: 'query', key: 'limit' },
                     { in: 'query', key: 'offset' }
                 ] }]);
@@ -3758,7 +3887,7 @@ export class Runs extends HeyApiClient {
                     name: 'talqing_sid',
                     type: 'apiKey'
                 }],
-            url: '/v1/tasks/{task_id}/runs',
+            url: '/v1/task-runs',
             ...options,
             ...params
         });
@@ -3766,21 +3895,12 @@ export class Runs extends HeyApiClient {
     /**
      * Run Task
      *
-     * Run the task once with the variables you supply, and wait for the result.
-     *
-     * **This executes for real**: the tools call your endpoints with your secrets,
-     * the MCP servers spend your credits, and the model spends your tokens. A task
-     * that books a slot, charges a card or sends a message will do so.
+     * Run a task for real: its tools, MCP servers and model all act and spend.
      *
-     * Runs the published version unless `version` names another one, or `"draft"`
-     * to run the unpublished config. `vars` must match what that version declares
-     * — an unknown name is refused rather than dropped. The response is the whole
-     * run: the structured `output`, a `trace` of every tool call, the steps used
-     * and what the tokens cost. On failure `error.type` says whose problem it is.
-     * Secrets are redacted.
+     * Waits and returns the finished run, or with `background: true` queues it and returns 202.
      */
     create(parameters, options) {
-        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'task_id' }, { key: 'runTaskRequest', map: 'body' }] }]);
+        const params = buildClientParams([parameters], [{ args: [{ key: 'createTaskRunRequest', map: 'body' }] }]);
         return (options?.client ?? this.client).post({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -3788,7 +3908,7 @@ export class Runs extends HeyApiClient {
                     name: 'talqing_sid',
                     type: 'apiKey'
                 }],
-            url: '/v1/tasks/{task_id}/runs',
+            url: '/v1/task-runs',
             ...options,
             ...params,
             headers: {
@@ -3799,17 +3919,79 @@ export class Runs extends HeyApiClient {
         });
     }
     /**
-     * Get Task Run
+     * Run Task Batch
      *
-     * One run in full: what it produced, every tool it called on the way, and
-     * what it cost.
+     * Queue up to 1000 runs of one task, in the background. One invalid item refuses all.
+     */
+    createBatch(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ key: 'createTaskRunBatchRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/task-runs/batch',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
+    /**
+     * Delete Task Runs
      *
-     * This is what answers "why did it write that" for a caller holding one run id
-     * — an email batch's review table links each drafted row here. Secret values
-     * are redacted from the trace, and a trace that was cut reports it.
+     * Delete the content of every run whose metadata matches, as `delete_task_run` does.
+     */
+    deleteMany(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ key: 'deleteTaskRunsRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/task-runs/delete',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
+    /**
+     * Delete Task Run
+     *
+     * Delete a run's inputs, files, output and trace; its cost and metadata stay.
+     */
+    delete(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'run_id' }] }]);
+        return (options?.client ?? this.client).delete({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/task-runs/{run_id}',
+            ...options,
+            ...params
+        });
+    }
+    /**
+     * Get Task Run
+     *
+     * One run in full: its config, inputs, output, trace and cost. Secrets are redacted.
      */
     get(parameters, options) {
-        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'task_id' }, { in: 'path', key: 'run_id' }] }]);
+        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'run_id' }] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -3817,7 +3999,26 @@ export class Runs extends HeyApiClient {
                     name: 'talqing_sid',
                     type: 'apiKey'
                 }],
-            url: '/v1/tasks/{task_id}/runs/{run_id}',
+            url: '/v1/task-runs/{run_id}',
+            ...options,
+            ...params
+        });
+    }
+    /**
+     * Cancel Task Run
+     *
+     * Cancel a queued or background run. A running one stops within seconds.
+     */
+    cancel(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'run_id' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_sid',
+                    type: 'apiKey'
+                }],
+            url: '/v1/task-runs/{run_id}/cancel',
             ...options,
             ...params
         });
@@ -3906,7 +4107,7 @@ export class Tasks2 extends HeyApiClient {
      * `output` is what makes this a task rather than a chat agent — declare the
      * fields the model must produce and it is given a `submit_result` tool built
      * from them. `vars` are its inputs, read as `{{vars.name}}`. The task starts
-     * unpublished; publish it before running it.
+     * unpublished; publish it before running it with `POST /task-runs`.
      */
     create(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [{ key: 'createTaskRequest', map: 'body' }] }]);
@@ -4041,9 +4242,6 @@ export class Tasks2 extends HeyApiClient {
             ...params
         });
     }
-    get runs() {
-        return this._runs ?? (this._runs = new Runs({ client: this.client }));
-    }
     get versions() {
         return this._versions ?? (this._versions = new Versions2({ client: this.client }));
     }
@@ -4911,6 +5109,9 @@ export class TalqingApi extends HeyApiClient {
     get faqs() {
         return this._faqs ?? (this._faqs = new Faqs({ client: this.client }));
     }
+    get inboundWebhook() {
+        return this._inboundWebhook ?? (this._inboundWebhook = new InboundWebhook({ client: this.client }));
+    }
     get integrations() {
         return this._integrations ?? (this._integrations = new Integrations({ client: this.client }));
     }
@@ -4926,6 +5127,9 @@ export class TalqingApi extends HeyApiClient {
     get telephony() {
         return this._telephony ?? (this._telephony = new Telephony({ client: this.client }));
     }
+    get taskRuns() {
+        return this._taskRuns ?? (this._taskRuns = new TaskRuns({ client: this.client }));
+    }
     get tasks() {
         return this._tasks ?? (this._tasks = new Tasks2({ client: this.client }));
     }