@talqing/sdk 0.2.1 → 0.4.0

package/dist/cjs/gen/sdk.gen.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TalqingApi = exports.Webhooks = exports.Tools2 = exports.Versions2 = exports.Telephony = exports.Providers = exports.PhoneNumbers = exports.Accounts = exports.Tasks2 = exports.Runs = exports.Secrets = exports.Schemas = exports.Orgs = exports.Members = exports.Invites = exports.Observability = exports.Tokens = exports.Knowledge2 = exports.Pages = exports.Nodes = exports.Integrations = exports.Triggers = exports.McpTools = exports.Email = exports.Senders = exports.Batches2 = exports.Recipients2 = exports.Copilot = exports.Tools = exports.Tasks = exports.Knowledge = exports.Agents2 = exports.Conversations = exports.Sessions = exports.Items = exports.Messages = exports.Catalog = exports.Voices = exports.Elevenlabs = exports.Avatars = exports.Calls = exports.ScreenRecording = exports.Recording = exports.Batches = exports.Recipients = exports.Analysis = exports.ProviderKeys = exports.Auth = exports.Agents = exports.Versions = void 0;
+exports.TalqingApi = exports.Webhooks = exports.Tools2 = exports.Versions2 = exports.Telephony = exports.Providers = exports.PhoneNumbers = exports.Accounts = exports.Tasks2 = exports.Runs = exports.Secrets = exports.Schemas = exports.Functions = exports.Observability = exports.Knowledge2 = exports.Pages = exports.Nodes = exports.Integrations = exports.Triggers = exports.McpTools = exports.Email = exports.Senders = exports.Batches2 = exports.Recipients2 = exports.Copilot = exports.Tools = exports.Tasks = exports.Knowledge = exports.Agents2 = exports.Conversations = exports.Sessions = exports.Items = exports.Messages = exports.Catalog = exports.Voices = exports.Elevenlabs = exports.Avatars = exports.Calls = exports.ScreenRecording = exports.Recording = exports.Batches = exports.Recipients = exports.Analysis = exports.ProviderKeys = exports.Billing = exports.Credits = exports.Agents = exports.Versions = void 0;
 const client_gen_js_1 = require("./client.gen.js");
 const index_js_1 = require("./client/index.js");
 class HeyApiClient {
@@ -256,28 +256,78 @@ class Agents extends HeyApiClient {
     }
 }
 exports.Agents = Agents;
-class Auth extends HeyApiClient {
+class Credits extends HeyApiClient {
     /**
-     * Logout
+     * Get Credits
+     *
+     * This workspace's credit balance in this region, what it buys, and what a
+     * top-up costs.
+     *
+     * Readable by every role: a VIEWER can start a web call, so a VIEWER must be
+     * able to see why one was refused.
+     *
+     * This is also where credit the control plane could not deliver lands. Anything
+     * it has issued for this workspace here — a purchase, a signup grant, a
+     * reversal — that this region has not written yet is applied before the balance
+     * is read. That is the backstop for a failed push, and it is a reconcile on
+     * demand rather than a timer: the moment someone cares is the moment this page
+     * loads, whether they arrived from the payment processor or from the "out of
+     * credits" banner. It costs nothing when there is nothing to apply, which is
+     * almost always.
      */
-    logout(options) {
-        return (options?.client ?? this.client).post({
+    get(parameters, options) {
+        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'topup' }] }]);
+        return (options?.client ?? this.client).get({
             responseStyle: 'data',
-            url: '/v1/auth/logout',
-            ...options
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_session',
+                    type: 'apiKey'
+                }],
+            url: '/v1/billing/credits',
+            ...options,
+            ...params
         });
     }
     /**
-     * Me
+     * Create Credit Checkout
+     *
+     * Start a credit purchase and return the hosted checkout URL to open.
      *
-     * Who this credential is: the signed-in user, their role, and the organization.
+     * Organization admins only — spending the workspace's money is an admin act,
+     * the same as storing a secret or a provider key.
+     *
+     * The credit lands in THIS region, and that is decided by which region's API
+     * you called rather than by anything in the request. A slug in a body could be
+     * pointed at the other region, where the money would then be stuck: balances
+     * are per region and there is no transfer between them.
+     */
+    checkout(parameters, options) {
+        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ key: 'creditCheckoutRequest', map: 'body' }] }]);
+        return (options?.client ?? this.client).post({
+            responseStyle: 'data',
+            security: [{ scheme: 'bearer', type: 'http' }, {
+                    in: 'cookie',
+                    name: 'talqing_session',
+                    type: 'apiKey'
+                }],
+            url: '/v1/billing/credits/checkout',
+            ...options,
+            ...params,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+                ...params.headers
+            }
+        });
+    }
+    /**
+     * List Credit Ledger
      *
-     * Everything else you can reach is scoped to that organization, and `role`
-     * (`ADMIN`, `EDITOR` or `VIEWER`) decides whether writes will be accepted. A
-     * user may belong to several organizations with a different role in each; this
-     * reports the one this credential is for.
+     * Every movement of this region's balance, newest first, with what caused each.
      */
-    me(options) {
+    ledger(parameters, options) {
+        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -285,12 +335,19 @@ class Auth extends HeyApiClient {
                     name: 'talqing_session',
                     type: 'apiKey'
                 }],
-            url: '/v1/auth/me',
-            ...options
+            url: '/v1/billing/credits/ledger',
+            ...options,
+            ...params
         });
     }
 }
-exports.Auth = Auth;
+exports.Credits = Credits;
+class Billing extends HeyApiClient {
+    get credits() {
+        return this._credits ?? (this._credits = new Credits({ client: this.client }));
+    }
+}
+exports.Billing = Billing;
 class ProviderKeys extends HeyApiClient {
     /**
      * List Provider Keys
@@ -1926,9 +1983,10 @@ class Batches2 extends HeyApiClient {
     /**
      * Get Email Batch
      *
-     * One batch: its policy, its per-status counts, what drafting has cost so
-     * far, and — while it is waiting on a start time or a closed window —
-     * `next_draft_at`.
+     * One batch: its policy, its per-status counts and what drafting has cost.
+     *
+     * While the batch is waiting on a start time or a closed window, the response
+     * also carries `next_draft_at`.
      */
     get(parameters, options) {
         const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'batch_id' }] }]);
@@ -2188,8 +2246,10 @@ class Triggers extends HeyApiClient {
      * Patch Integration Trigger
      *
      * Update a trigger: reassign the agent, change reply mode, enable or
-     * disable it. Omitted fields are left unchanged. The same checks as creation
-     * run when enabling.
+     * disable it.
+     *
+     * Omitted fields are left unchanged, and enabling one runs the same checks
+     * creating it did.
      */
     update(parameters, options) {
         const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [
@@ -2690,114 +2750,6 @@ class Knowledge2 extends HeyApiClient {
     }
 }
 exports.Knowledge2 = Knowledge2;
-class Tokens extends HeyApiClient {
-    /**
-     * Mcp Token
-     *
-     * This user's MCP token, in plaintext, with the API URL to pair it with.
-     *
-     * Unlike a token created by hand, this one can be read whenever it is needed:
-     * the dashboard renders it into ready-to-paste MCP configuration for Claude
-     * Code, Codex and Grok. The value is re-derived from the token's row, not
-     * stored, and is the same string every time — so a configuration a user
-     * already saved keeps working.
-     *
-     * It is always the caller's own token, never anyone else's, and is created on
-     * the spot for a user who somehow has none. Delete it from the tokens list to
-     * revoke it; the next call issues a new one, which rotates the credential.
-     */
-    mcp(options) {
-        return (options?.client ?? this.client).get({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/mcp-token',
-            ...options
-        });
-    }
-    /**
-     * List Tokens
-     *
-     * List personal access tokens: your own, or every one in the organization
-     * if you are an admin.
-     *
-     * Who holds which credential is organization-admin information, so an EDITOR
-     * or VIEWER sees only what they created. Plaintext token values are never
-     * returned. A token with `kind: mcp` was issued automatically for the
-     * dashboard's MCP setup; the rest were created by hand.
-     */
-    list(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
-        return (options?.client ?? this.client).get({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/tokens',
-            ...options,
-            ...params
-        });
-    }
-    /**
-     * Create Token
-     *
-     * Create a personal access token for driving this API without the dashboard.
-     *
-     * The token authenticates as its creator and acts with that user's live role,
-     * so it can never do more than they can. It does not expire; deleting it is
-     * the revocation. The plaintext value is returned once here and never again —
-     * treat it like a password and do not echo it back into a conversation.
-     */
-    create(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ key: 'createTokenRequest', map: 'body' }] }]);
-        return (options?.client ?? this.client).post({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/tokens',
-            ...options,
-            ...params,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options?.headers,
-                ...params.headers
-            }
-        });
-    }
-    /**
-     * Delete Token
-     *
-     * Revoke a token immediately and permanently.
-     *
-     * Owners can delete their own; organization admins can delete any in the
-     * organization. Deleting an `mcp` token rotates it: the owner's next dashboard
-     * visit issues a replacement, and anything still configured with the old one
-     * stops working.
-     */
-    delete(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'token_id' }] }]);
-        return (options?.client ?? this.client).delete({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/tokens/{token_id}',
-            ...options,
-            ...params
-        });
-    }
-}
-exports.Tokens = Tokens;
 class Observability extends HeyApiClient {
     /**
      * Get Observability
@@ -2840,220 +2792,19 @@ class Observability extends HeyApiClient {
     }
 }
 exports.Observability = Observability;
-class Invites extends HeyApiClient {
-    /**
-     * List Invites
-     *
-     * Invites waiting on a first login. Accepted and revoked ones drop off the
-     * list — an accepted invite is a member, and belongs on the roster instead.
-     */
-    list(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
-        return (options?.client ?? this.client).get({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/invites',
-            ...options,
-            ...params
-        });
-    }
-    /**
-     * Create Invite
-     *
-     * Invite an email address into this organization with a role.
-     *
-     * There is no invite link and no accept step: the invite is keyed to a Google
-     * identity, so signing in with that address *is* the check. Someone who
-     * already has an account joins immediately; anyone else joins the first time
-     * they sign in.
-     *
-     * No email is sent at MVP, so an existing user finds out by seeing the
-     * organization appear in their switcher — tell them yourself.
-     */
-    create(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ key: 'inviteRequest', map: 'body' }] }]);
-        return (options?.client ?? this.client).post({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/invites',
-            ...options,
-            ...params,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options?.headers,
-                ...params.headers
-            }
-        });
-    }
-    /**
-     * Revoke Invite
-     *
-     * Withdraw a pending invite, so signing in with that address no longer
-     * joins this organization.
-     */
-    revoke(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'invite_id' }] }]);
-        return (options?.client ?? this.client).delete({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/invites/{invite_id}',
-            ...options,
-            ...params
-        });
-    }
-}
-exports.Invites = Invites;
-class Members extends HeyApiClient {
-    /**
-     * List Members
-     *
-     * Every member sees the roster; only an ADMIN can change it.
-     */
-    list(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
-        return (options?.client ?? this.client).get({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/members',
-            ...options,
-            ...params
-        });
-    }
+class Functions extends HeyApiClient {
     /**
-     * Remove Member
+     * Describe Function
      *
-     * Remove someone from this organization.
+     * The full argument schema of one function, by name.
      *
-     * They lose access on their next request, and their access tokens for this
-     * organization stop working with them. Nothing they created is deleted.
-     *
-     * Allowed even when this is the only organization they belong to — whether
-     * they have somewhere else to go is not this organization's problem, and their
-     * next sign-in gives them one of their own.
+     * Every function's arguments are fetched here rather than shown up front, so
+     * call this before the first time you use one. Two exceptions, which carry
+     * their own shape because they would otherwise be uncallable: this function
+     * and `describe_schema`.
      */
-    remove(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'user_id' }] }]);
-        return (options?.client ?? this.client).delete({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/members/{user_id}',
-            ...options,
-            ...params
-        });
-    }
-    /**
-     * Set Member Role
-     *
-     * Change a member's role. Takes effect on their very next request.
-     */
-    setRole(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'user_id' }, { key: 'roleRequest', map: 'body' }] }]);
-        return (options?.client ?? this.client).patch({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/members/{user_id}',
-            ...options,
-            ...params,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options?.headers,
-                ...params.headers
-            }
-        });
-    }
-}
-exports.Members = Members;
-class Orgs extends HeyApiClient {
-    /**
-     * Patch Org
-     *
-     * Change this organization's name or its data retention policy.
-     *
-     * The name is display only — nothing keys on it.
-     *
-     * `retention_days` is how long call and conversation *content* is kept:
-     * recordings, transcripts, summaries, extracted fields and the phone numbers
-     * on a call. When it passes, all of that is deleted and the call itself
-     * remains, with its duration, outcome and cost, so past invoices still
-     * resolve. `null` keeps everything forever, which is the default.
-     *
-     * It applies to calls from now on: a call already in the system keeps the
-     * deadline it was given when it ended, so shortening the policy never
-     * retroactively destroys anything. Erasing a contact's last call also resets
-     * what your agents remember about that person.
-     */
-    update(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ key: 'patchOrgRequest', map: 'body' }] }]);
-        return (options?.client ?? this.client).patch({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org',
-            ...options,
-            ...params,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options?.headers,
-                ...params.headers
-            }
-        });
-    }
-    /**
-     * Leave Org
-     *
-     * Leave this organization. Any member may, including an admin who has
-     * promoted a successor. Nothing they created is deleted.
-     */
-    leave(options) {
-        return (options?.client ?? this.client).post({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/org/leave',
-            ...options
-        });
-    }
-    /**
-     * List Orgs
-     *
-     * Every organization the signed-in user belongs to, with their role in each.
-     *
-     * Newest membership first, deliberately: an admin can add you to their
-     * organization without you being asked or emailed, so the one you did not know
-     * about is the one that needs to be visible.
-     */
-    list(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
+    get(parameters, options) {
+        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'name' }] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -3061,68 +2812,13 @@ class Orgs extends HeyApiClient {
                     name: 'talqing_session',
                     type: 'apiKey'
                 }],
-            url: '/v1/orgs',
-            ...options,
-            ...params
-        });
-    }
-    /**
-     * Create Org
-     *
-     * Create a new, empty organization with the caller as its ADMIN.
-     *
-     * Any member can do this — it grants nothing in the organization they are
-     * currently in. Switch into it to start working there.
-     */
-    create(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ key: 'orgNameRequest', map: 'body' }] }]);
-        return (options?.client ?? this.client).post({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/orgs',
-            ...options,
-            ...params,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options?.headers,
-                ...params.headers
-            }
-        });
-    }
-    /**
-     * Switch Org
-     *
-     * Point the dashboard session at another of the caller's organizations.
-     *
-     * The session cookie carries the organization, so switching re-issues it — the
-     * caller's role, resources and billing all move with it. Reload after this.
-     */
-    switch(parameters, options) {
-        const params = (0, index_js_1.buildClientParams)([parameters], [{ args: [{ in: 'path', key: 'org_id' }] }]);
-        return (options?.client ?? this.client).post({
-            responseStyle: 'data',
-            security: [{ scheme: 'bearer', type: 'http' }, {
-                    in: 'cookie',
-                    name: 'talqing_session',
-                    type: 'apiKey'
-                }],
-            url: '/v1/orgs/{org_id}/switch',
+            url: '/v1/schemas/functions/{name}',
             ...options,
             ...params
         });
     }
-    get invites() {
-        return this._invites ?? (this._invites = new Invites({ client: this.client }));
-    }
-    get members() {
-        return this._members ?? (this._members = new Members({ client: this.client }));
-    }
 }
-exports.Orgs = Orgs;
+exports.Functions = Functions;
 class Schemas extends HeyApiClient {
     /**
      * Describe Schema
@@ -3154,6 +2850,9 @@ class Schemas extends HeyApiClient {
             ...params
         });
     }
+    get functions() {
+        return this._functions ?? (this._functions = new Functions({ client: this.client }));
+    }
 }
 exports.Schemas = Schemas;
 class Secrets extends HeyApiClient {
@@ -3343,7 +3042,8 @@ class Tasks2 extends HeyApiClient {
     /**
      * Create Task
      *
-     * Create an agent task.
+     * Create an agent task: an agent nobody talks to, which takes named inputs
+     * and returns a typed result.
      *
      * A task has no draft and no publish step: it is valid the moment it saves and
      * callable immediately. An invalid config is a 400 listing every problem and
@@ -4300,8 +4000,8 @@ class TalqingApi extends HeyApiClient {
      *
      * Liveness probe: `200` once this process is serving. Unauthenticated.
      *
-     * It answers for the API process, not its dependencies — a `200` here does not
-     * promise Postgres, Redis or LiveKit are reachable.
+     * It answers for the API process, not its dependencies — a `200` here does
+     * not promise Postgres, Redis or LiveKit are reachable.
      */
     health(options) {
         return (options?.client ?? this.client).get({
@@ -4313,8 +4013,8 @@ class TalqingApi extends HeyApiClient {
     get agents() {
         return this._agents ?? (this._agents = new Agents({ client: this.client }));
     }
-    get auth() {
-        return this._auth ?? (this._auth = new Auth({ client: this.client }));
+    get billing() {
+        return this._billing ?? (this._billing = new Billing({ client: this.client }));
     }
     get providerKeys() {
         return this._providerKeys ?? (this._providerKeys = new ProviderKeys({ client: this.client }));
@@ -4340,15 +4040,9 @@ class TalqingApi extends HeyApiClient {
     get knowledge() {
         return this._knowledge ?? (this._knowledge = new Knowledge2({ client: this.client }));
     }
-    get tokens() {
-        return this._tokens ?? (this._tokens = new Tokens({ client: this.client }));
-    }
     get observability() {
         return this._observability ?? (this._observability = new Observability({ client: this.client }));
     }
-    get orgs() {
-        return this._orgs ?? (this._orgs = new Orgs({ client: this.client }));
-    }
     get schemas() {
         return this._schemas ?? (this._schemas = new Schemas({ client: this.client }));
     }