agentphone 1.0.10 → 1.0.12

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.10";
+export declare const SDK_VERSION = "1.0.12";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.10";
+export const SDK_VERSION = "1.0.12";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentphone",
-    "version": "1.0.10",
+    "version": "1.0.12",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -1,142 +1,4 @@
 # Reference
-## AgentSignup
-<details><summary><code>client.agentSignup.<a href="/src/api/resources/agentSignup/client/Client.ts">agentSignUp</a>({ ...params }) -> unknown</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Kick off agent self-signup.
-
-Sends a 6-digit OTP to the human's email. Nothing is provisioned server-side
-until /v0/agent/verify is called with the code.
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.agentSignup.agentSignUp({
-    human_email: "human_email"
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**request:** `AgentPhone.AgentSignUpRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentSignupClient.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentSignup.<a href="/src/api/resources/agentSignup/client/Client.ts">agentVerify</a>({ ...params }) -> unknown</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Verify the OTP and atomically provision everything.
-
-Creates: User + Project (+ mirrored Account) + starter hosted Agent + phone number
-+ first-month charge + API key. Returns the key once — agents must save it.
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.agentSignup.agentVerify({
-    verification_id: "verification_id",
-    otp_code: "otp_code"
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**request:** `AgentPhone.AgentVerifyRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentSignupClient.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
 ## Agents
 <details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">listVoices</a>() -> unknown</code></summary>
 <dl>
@@ -150,7 +12,7 @@ await client.agentSignup.agentVerify({
 <dl>
 <dd>
 
-Return available voices from the call provider (Retell).
+Return available voices from the configured voice provider.
 </dd>
 </dl>
 </dd>
@@ -2175,7 +2037,7 @@ await client.contacts.updateContact({
 List all conversations for this account.
 
 Sorted by most recent activity (lastMessageAt desc).
-Also includes conversations on shared lines owned by this account.
+Sorted by most recent activity.
 </dd>
 </dl>
 </dd>
@@ -2495,6 +2357,144 @@ await client.conversations.sendTypingIndicator({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">setChatBackground</a>({ ...params }) -> AgentPhone.SetBackgroundResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Set a custom wallpaper for the chat (iMessage only).
+
+Customer sends `image_url`; we fetch (≤10MB, JPEG/PNG/GIF/WebP/HEIC),
+validate, and forward as multipart to the iMessage provider. Idempotent —
+re-setting replaces. Recipients on iOS < 18 fall back to the default
+silently.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.setChatBackground({
+    conversation_id: "conversation_id",
+    image_url: "https://example.com/wallpaper.jpg"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.SetBackgroundRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">removeChatBackground</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Clear the custom wallpaper for the chat (iMessage only).
+
+Idempotent: deleting a default-background chat returns 204 (no-op).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.removeChatBackground({
+    conversation_id: "conversation_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.RemoveChatBackgroundV1ConversationsConversationIdBackgroundDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2794,10 +2794,10 @@ await client.calls.getCall({
 
 Terminate an ongoing call.
 
-Works for both hosted-mode and webhook-mode calls.  The call_ended
-webhook from Retell updates status/endedAt asynchronously, so this
-endpoint returns the current call as soon as the stop request is
-accepted by Retell.
+Works for both hosted-mode and webhook-mode calls. The call_ended
+webhook from the voice provider updates status/endedAt asynchronously,
+so this endpoint returns the current call as soon as the stop request
+is accepted upstream.
 </dd>
 </dl>
 </dd>
@@ -3795,6 +3795,105 @@ await client.contactCards.deleteContactCard({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Registration
+<details><summary><code>client.registration.<a href="/src/api/resources/registration/client/Client.ts">registerA2P</a>({ ...params }) -> AgentPhone.RegistrationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Submit an A2P 10DLC registration to enable outbound SMS on your account.
+
+US carriers require 10DLC registration before your AI agent can send text messages. This endpoint accepts both `sole_proprietor` and `standard_brand` registration types.
+
+### How it works
+
+1. Submit your registration details via this endpoint
+2. We validate your submission and flag any issues (RED = blocked, YELLOW = warning)
+3. On success, you receive a Stripe payment URL to pay the one-time registration fee
+4. After payment, we submit your registration to the carriers on your behalf
+5. Carrier approval typically takes 7-10 business days
+
+### Registration types
+
+- **`sole_proprietor`** — For individuals or small businesses. Simpler requirements, fewer fields.
+- **`standard_brand`** — For established businesses. Requires `business_name`, `privacy_policy_url`, `terms_of_service_url`, `sample_message_1`, and `sample_message_2`.
+
+### Opt-in image
+
+`opt_in_image_url` must be a publicly accessible HTTPS URL to a screenshot showing how users opt in to receive messages from you (e.g. a consent checkbox on your signup form). Supports PNG, JPG, WEBP, and GIF up to 2MB. Google Drive links (`drive.google.com/file/d/.../view`) are automatically converted if the file is shared publicly.
+
+### Re-submitting
+
+If you've already submitted but haven't completed payment, calling this endpoint again returns the payment URL without re-sending the registration email.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.registration.registerA2P({
+    registration_type: "registration_type",
+    first_name: "first_name",
+    last_name: "last_name",
+    email: "email",
+    phone_number: "phone_number",
+    street_address: "street_address",
+    city: "city",
+    state: "state",
+    zip_code: "zip_code",
+    use_case_description: "use_case_description",
+    opt_in_image_url: "opt_in_image_url"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.RegistrationRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `RegistrationClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

package/dist/cjs/api/resources/agentSignup/client/Client.d.ts

@@ -1,50 +0,0 @@
-import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
-import { type NormalizedClientOptions } from "../../../../BaseClient.js";
-import * as core from "../../../../core/index.js";
-import * as AgentPhone from "../../../index.js";
-export declare namespace AgentSignupClient {
-    type Options = BaseClientOptions;
-    interface RequestOptions extends BaseRequestOptions {
-    }
-}
-export declare class AgentSignupClient {
-    protected readonly _options: NormalizedClientOptions<AgentSignupClient.Options>;
-    constructor(options?: AgentSignupClient.Options);
-    /**
-     * Kick off agent self-signup.
-     *
-     * Sends a 6-digit OTP to the human's email. Nothing is provisioned server-side
-     * until /v0/agent/verify is called with the code.
-     *
-     * @param {AgentPhone.AgentSignUpRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentSignUp({
-     *         human_email: "human_email"
-     *     })
-     */
-    agentSignUp(request: AgentPhone.AgentSignUpRequest, requestOptions?: AgentSignupClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __agentSignUp;
-    /**
-     * Verify the OTP and atomically provision everything.
-     *
-     * Creates: User + Project (+ mirrored Account) + starter hosted Agent + phone number
-     * + first-month charge + API key. Returns the key once — agents must save it.
-     *
-     * @param {AgentPhone.AgentVerifyRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentVerify({
-     *         verification_id: "verification_id",
-     *         otp_code: "otp_code"
-     *     })
-     */
-    agentVerify(request: AgentPhone.AgentVerifyRequest, requestOptions?: AgentSignupClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __agentVerify;
-}

package/dist/cjs/api/resources/agentSignup/client/requests/AgentVerifyRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * @example
- *     {
- *         verification_id: "verification_id",
- *         otp_code: "otp_code"
- *     }
- */
-export interface AgentVerifyRequest {
-    verification_id: string;
-    otp_code: string;
-}

package/dist/cjs/api/resources/agentSignup/client/requests/index.d.ts

@@ -1,2 +0,0 @@
-export type { AgentSignUpRequest } from "./AgentSignUpRequest.js";
-export type { AgentVerifyRequest } from "./AgentVerifyRequest.js";

package/dist/esm/api/resources/agentSignup/client/Client.d.mts

@@ -1,50 +0,0 @@
-import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
-import { type NormalizedClientOptions } from "../../../../BaseClient.mjs";
-import * as core from "../../../../core/index.mjs";
-import * as AgentPhone from "../../../index.mjs";
-export declare namespace AgentSignupClient {
-    type Options = BaseClientOptions;
-    interface RequestOptions extends BaseRequestOptions {
-    }
-}
-export declare class AgentSignupClient {
-    protected readonly _options: NormalizedClientOptions<AgentSignupClient.Options>;
-    constructor(options?: AgentSignupClient.Options);
-    /**
-     * Kick off agent self-signup.
-     *
-     * Sends a 6-digit OTP to the human's email. Nothing is provisioned server-side
-     * until /v0/agent/verify is called with the code.
-     *
-     * @param {AgentPhone.AgentSignUpRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentSignUp({
-     *         human_email: "human_email"
-     *     })
-     */
-    agentSignUp(request: AgentPhone.AgentSignUpRequest, requestOptions?: AgentSignupClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __agentSignUp;
-    /**
-     * Verify the OTP and atomically provision everything.
-     *
-     * Creates: User + Project (+ mirrored Account) + starter hosted Agent + phone number
-     * + first-month charge + API key. Returns the key once — agents must save it.
-     *
-     * @param {AgentPhone.AgentVerifyRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentVerify({
-     *         verification_id: "verification_id",
-     *         otp_code: "otp_code"
-     *     })
-     */
-    agentVerify(request: AgentPhone.AgentVerifyRequest, requestOptions?: AgentSignupClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __agentVerify;
-}

package/dist/esm/api/resources/agentSignup/client/Client.mjs

@@ -1,133 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { normalizeClientOptions } from "../../../../BaseClient.mjs";
-import { mergeHeaders } from "../../../../core/headers.mjs";
-import * as core from "../../../../core/index.mjs";
-import * as environments from "../../../../environments.mjs";
-import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
-import * as errors from "../../../../errors/index.mjs";
-import * as AgentPhone from "../../../index.mjs";
-export class AgentSignupClient {
-    constructor(options = {}) {
-        this._options = normalizeClientOptions(options);
-    }
-    /**
-     * Kick off agent self-signup.
-     *
-     * Sends a 6-digit OTP to the human's email. Nothing is provisioned server-side
-     * until /v0/agent/verify is called with the code.
-     *
-     * @param {AgentPhone.AgentSignUpRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentSignUp({
-     *         human_email: "human_email"
-     *     })
-     */
-    agentSignUp(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__agentSignUp(request, requestOptions));
-    }
-    __agentSignUp(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, "v0/agent/sign-up"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 422:
-                        throw new AgentPhone.UnprocessableEntityError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.AgentPhoneError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/agent/sign-up");
-        });
-    }
-    /**
-     * Verify the OTP and atomically provision everything.
-     *
-     * Creates: User + Project (+ mirrored Account) + starter hosted Agent + phone number
-     * + first-month charge + API key. Returns the key once — agents must save it.
-     *
-     * @param {AgentPhone.AgentVerifyRequest} request
-     * @param {AgentSignupClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link AgentPhone.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.agentSignup.agentVerify({
-     *         verification_id: "verification_id",
-     *         otp_code: "otp_code"
-     *     })
-     */
-    agentVerify(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__agentVerify(request, requestOptions));
-    }
-    __agentVerify(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, "v0/agent/verify"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 422:
-                        throw new AgentPhone.UnprocessableEntityError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.AgentPhoneError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/agent/verify");
-        });
-    }
-}