@amigo-ai/platform-sdk 0.40.0 → 0.43.0

package/api.md

@@ -149,6 +149,11 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getAuditLog`
 - `getAuditLogAutoPaging`
 
+### `promptLogs`
+
+- `list`
+- `listAutoPaging`
+
 ### `triggers`
 
 - `list`
@@ -251,6 +256,17 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `textStreamUrl`
 - `sessionConnectUrl`
 
+### `channels`
+
+**`channels.sesSetup`**
+
+- `create`
+- `list`
+- `listAutoPaging`
+- `get`
+- `verify`
+- `delete`
+
 ### `phoneNumbers`
 
 - `provision`
@@ -446,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,
@@ -1519,6 +1521,56 @@ var OperatorsResource = class extends WorkspaceScopedResource {
   }
 };
 
+// src/resources/prompt-logs.ts
+var PromptLogsResource = class extends WorkspaceScopedResource {
+  /**
+   * One page of prompt-log entries, newest-first.
+   *
+   * When ``params.conversation_id`` is supplied, the response surfaces
+   * ``resolved_call_sid`` (the call_sid the lookup mapped to) and
+   * ``resolved_conversation_kind`` (``"call"`` for voice/sim/scribe,
+   * ``"conversation"`` for text/sms/whatsapp/email) so you can drill
+   * into per-call surfaces afterward without re-querying
+   * ``world.entities``.
+   *
+   * When no selectivity-bearing filter is supplied (no conversation_id /
+   * call_sid / time range), the query is auto-capped to the last 7 days.
+   * The applied window is reported in ``applied_time_window_days``.
+   */
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/prompt-logs", {
+        params: { path: { workspace_id: this.workspaceId }, query: params }
+      })
+    );
+  }
+  /**
+   * Auto-paginating async iterator over prompt-log entries. Walks
+   * ``next_offset`` until ``has_more`` is false, yielding individual
+   * entries. Use this when consuming logs at scale (e.g. nightly
+   * backfills) rather than rendering one page in a UI.
+   *
+   * Bounded by the same per-call hard caps as ``list`` (200 items per
+   * page, 10,000 cumulative offset).
+   */
+  async *listAutoPaging(params) {
+    let offset = 0;
+    while (true) {
+      const page = await this.list({ ...params, offset });
+      for (const entry of page.items) {
+        yield entry;
+      }
+      if (!page.has_more || page.next_offset == null) {
+        return;
+      }
+      if (page.next_offset === offset) {
+        return;
+      }
+      offset = page.next_offset;
+    }
+  }
+};
+
 // src/resources/triggers.ts
 var TriggersResource = class extends WorkspaceScopedResource {
   async list(params) {
@@ -2511,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 */
@@ -6174,6 +6312,7 @@ var AmigoClient = class _AmigoClient {
   skills;
   actions;
   operators;
+  promptLogs;
   triggers;
   services;
   contextGraphs;
@@ -6181,6 +6320,7 @@ var AmigoClient = class _AmigoClient {
   world;
   calls;
   conversations;
+  channels;
   phoneNumbers;
   integrations;
   analytics;
@@ -6315,6 +6455,7 @@ var AmigoClient = class _AmigoClient {
     mutable.skills = new SkillsResource(client, workspaceId2);
     mutable.actions = new ActionsResource(client, workspaceId2);
     mutable.operators = new OperatorsResource(client, workspaceId2);
+    mutable.promptLogs = new PromptLogsResource(client, workspaceId2);
     mutable.triggers = new TriggersResource(client, workspaceId2);
     mutable.services = new ServicesResource(client, workspaceId2);
     mutable.contextGraphs = new ContextGraphsResource(client, workspaceId2);
@@ -6322,6 +6463,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);