@amigo-ai/platform-sdk 0.41.0 → 0.44.0

package/api.md

@@ -256,6 +256,17 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `textStreamUrl`
 - `sessionConnectUrl`
 
+### `channels`
+
+**`channels.sesSetup`**
+
+- `create`
+- `list`
+- `listAutoPaging`
+- `get`
+- `verify`
+- `delete`
+
 ### `phoneNumbers`
 
 - `provision`
@@ -451,6 +462,8 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 ### `events`
 
+- `subscribeToWorkspace`
+
 ### `functions`
 
 - `list`

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   AmigoError: () => AmigoError,
   AuthenticationError: () => AuthenticationError,
   BadRequestError: () => BadRequestError,
+  ChannelsResource: () => ChannelsResource,
   ConfigurationError: () => ConfigurationError,
   ConflictError: () => ConflictError,
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
@@ -53,6 +54,7 @@ __export(index_exports, {
   RequestTimeoutError: () => RequestTimeoutError,
   ServerError: () => ServerError,
   ServiceUnavailableError: () => ServiceUnavailableError,
+  SesSetupResource: () => SesSetupResource,
   TokenManager: () => TokenManager,
   ValidationError: () => ValidationError,
   WebhookVerificationError: () => WebhookVerificationError,
@@ -2561,6 +2563,92 @@ function parseTurnStreamFrame(eventName, dataJson) {
   return { ...payload, event: eventName };
 }
 
+// src/resources/channels/ses-setup.ts
+var SesSetupResource = class extends WorkspaceScopedResource {
+  /**
+   * Create an SES tenant + verified domain identity for this workspace.
+   *
+   * Returns the DNS records the customer must publish at their DNS provider.
+   * The setup is unusable for sending until every record's ``verified`` flag
+   * flips to ``true`` (call ``verify`` after publishing DNS to refresh).
+   */
+  async create(body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/channels/ses-setup", {
+        params: { path: { workspace_id: this.workspaceId } },
+        body
+      })
+    );
+  }
+  /**
+   * List SES setups owned by this workspace.
+   *
+   * Each item carries the cached ``dns_verified`` aggregate; call ``get``
+   * for per-record DNS detail.
+   */
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/channels/ses-setup", {
+        params: { path: { workspace_id: this.workspaceId }, query: params }
+      })
+    );
+  }
+  /** Auto-paginating async iterable over every SES setup in the workspace. */
+  listAutoPaging(params) {
+    return this.iteratePaginatedList((pageParams) => this.list(pageParams), params);
+  }
+  /**
+   * Get an SES setup with a live DNS verification refresh.
+   *
+   * Channel-manager re-runs ``GetEmailIdentity`` + DMARC/MX resolvers on
+   * every call, so each ``get`` is a live check rather than a cache read.
+   */
+  async get(setupId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/channels/ses-setup/{setup_id}", {
+        params: { path: { workspace_id: this.workspaceId, setup_id: setupId } }
+      })
+    );
+  }
+  /**
+   * Explicit DNS refresh — equivalent to ``get`` but exposed as a POST so UI
+   * "Verify now" actions read as actions rather than reads.
+   */
+  async verify(setupId) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/channels/ses-setup/{setup_id}/verify", {
+        params: { path: { workspace_id: this.workspaceId, setup_id: setupId } }
+      })
+    );
+  }
+  /**
+   * Tear down the upstream SES tenant + identity and soft-delete the
+   * workspace binding. Throws ``ConflictError`` (HTTP 409) if any use case
+   * still references the setup — delete those use cases first.
+   *
+   * Routed through ``extractData`` so 4xx/5xx responses surface as typed
+   * SDK errors (matching every other resource's ``delete``); the
+   * ``ConflictError`` mapping fires here instead of relying on the
+   * underlying client's accidental throw.
+   */
+  async delete(setupId) {
+    return extractData(
+      await this.client.DELETE("/v1/{workspace_id}/channels/ses-setup/{setup_id}", {
+        params: { path: { workspace_id: this.workspaceId, setup_id: setupId } }
+      })
+    );
+  }
+};
+
+// src/resources/channels/index.ts
+var ChannelsResource = class extends WorkspaceScopedResource {
+  sesSetup;
+  constructor(client, workspaceId2) {
+    super(client, workspaceId2);
+    this.sesSetup = new SesSetupResource(client, workspaceId2);
+  }
+};
+
 // src/resources/phone-numbers.ts
 var PhoneNumbersResource = class extends WorkspaceScopedResource {
   /** Create a new phone number */
@@ -4301,6 +4389,14 @@ var FunctionsResource = class extends WorkspaceScopedResource {
    * Test invoke — same as ``invoke`` plus persists ``last_test_*``
    * telemetry on the version row so the DC tool list can show
    * health without re-running.
+   *
+   * Returns :type:`TestInvokeResponse` (superset of `InvokeResponse`)
+   * so callers can read ``status`` / ``error`` / ``test_duration_ms``
+   * directly off the response. The platform-api route catches
+   * ``ServiceUnavailableError`` and converts it into ``status='fail'``
+   * with the executor's error string in ``error`` — so even on a
+   * blown-up SQL execution the response is a 200 with the failure
+   * detail surfaced to the caller.
    */
   async testV2(functionName, body) {
     return extractData(
@@ -6232,6 +6328,7 @@ var AmigoClient = class _AmigoClient {
   world;
   calls;
   conversations;
+  channels;
   phoneNumbers;
   integrations;
   analytics;
@@ -6374,6 +6471,7 @@ var AmigoClient = class _AmigoClient {
     mutable.world = new WorldResource(client, workspaceId2);
     mutable.calls = new CallsResource(client, workspaceId2);
     mutable.conversations = new ConversationsResource(client, workspaceId2, agentBaseUrl);
+    mutable.channels = new ChannelsResource(client, workspaceId2);
     mutable.phoneNumbers = new PhoneNumbersResource(client, workspaceId2);
     mutable.integrations = new IntegrationsResource(client, workspaceId2);
     mutable.analytics = new AnalyticsResource(client, workspaceId2);