@talqing/sdk 0.2.1 → 0.4.0

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

@@ -251,28 +251,78 @@ export class Agents extends HeyApiClient {
         return this._versions ?? (this._versions = new Versions({ client: this.client }));
     }
 }
-export class Auth extends HeyApiClient {
+export 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 = 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 = 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 = buildClientParams([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -280,11 +330,17 @@ export class Auth extends HeyApiClient {
                     name: 'talqing_session',
                     type: 'apiKey'
                 }],
-            url: '/v1/auth/me',
-            ...options
+            url: '/v1/billing/credits/ledger',
+            ...options,
+            ...params
         });
     }
 }
+export class Billing extends HeyApiClient {
+    get credits() {
+        return this._credits ?? (this._credits = new Credits({ client: this.client }));
+    }
+}
 export class ProviderKeys extends HeyApiClient {
     /**
      * List Provider Keys
@@ -1899,9 +1955,10 @@ export 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 = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'batch_id' }] }]);
@@ -2157,8 +2214,10 @@ export 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 = buildClientParams([parameters], [{ args: [
@@ -2654,113 +2713,6 @@ export class Knowledge2 extends HeyApiClient {
         return this._pages ?? (this._pages = new Pages({ client: this.client }));
     }
 }
-export 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 = 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 = 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 = 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
-        });
-    }
-}
 export class Observability extends HeyApiClient {
     /**
      * Get Observability
@@ -2802,218 +2754,19 @@ export class Observability extends HeyApiClient {
         });
     }
 }
-export 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 = 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 = 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 = 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
-        });
-    }
-}
-export class Members extends HeyApiClient {
-    /**
-     * List Members
-     *
-     * Every member sees the roster; only an ADMIN can change it.
-     */
-    list(parameters, options) {
-        const params = 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
-        });
-    }
+export 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 = 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 = 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
-            }
-        });
-    }
-}
-export 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 = 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 = buildClientParams([parameters], [{ args: [{ in: 'query', key: 'limit' }, { in: 'query', key: 'offset' }] }]);
+    get(parameters, options) {
+        const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'name' }] }]);
         return (options?.client ?? this.client).get({
             responseStyle: 'data',
             security: [{ scheme: 'bearer', type: 'http' }, {
@@ -3021,66 +2774,11 @@ export 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 = 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 = 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 }));
-    }
 }
 export class Schemas extends HeyApiClient {
     /**
@@ -3113,6 +2811,9 @@ export class Schemas extends HeyApiClient {
             ...params
         });
     }
+    get functions() {
+        return this._functions ?? (this._functions = new Functions({ client: this.client }));
+    }
 }
 export class Secrets extends HeyApiClient {
     /**
@@ -3299,7 +3000,8 @@ export 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
@@ -4248,8 +3950,8 @@ export 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({
@@ -4261,8 +3963,8 @@ export 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 }));
@@ -4288,15 +3990,9 @@ export 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 }));
     }