@proteos/sdk 0.36.1 → 0.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.36.1",
+  "version": "0.38.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {

package/src/connector/types.ts

@@ -165,7 +165,8 @@ export interface ListConnectorConnectionsQuery {
 export interface ListResponse<T> {
   data: T[]
   meta: {
-    pagination: { page: number; page_size: number }
+    page: number
+    page_size: number
     items_total: number
     pages_total: number
   }

package/src/conversation/types.ts

@@ -397,11 +397,36 @@ export interface AgentListenerTriggerConfig {
   phrases?: string[]
 }
 
+/**
+ * How the dispatcher immediately acknowledges a triggering message once the
+ * agent turn is queued: '' = none, 'reaction' places an emoji on the message
+ * (reaction-capable connections only), 'message' posts a short text.
+ */
+export type AgentListenerAcknowledgementType = '' | 'reaction' | 'message'
+
+/**
+ * Discriminated by the sibling acknowledgement_type; serialized as the bare
+ * variant, both fields optional here.
+ */
+export interface AgentListenerAcknowledgementConfig {
+  /** Reaction type: connector-native emoji token ("eyes", no colons). */
+  emoji?: string
+  /** Message type: the acknowledgement text. */
+  text?: string
+}
+
 export interface AgentListener {
   id: string
   org_id: string
   connection_id: string
   conversation_id: string
+  /**
+   * Optionally NARROWS a connection-bound listener to one room — the internal
+   * room id (`Room.id`), matched against the conversation's room at dispatch.
+   * Absent/empty ⇒ the whole connection. The most specific scope wins:
+   * conversation > room > connection; priority orders within a tier.
+   */
+  room_id?: string
   name: string
   agent_key: string
   trigger_type: AgentListenerTriggerType
@@ -412,6 +437,13 @@ export interface AgentListener {
    * connected the trigger drives it normally. Empty/absent ⇒ no gate.
    */
   wake_phrase?: string
+  /**
+   * Immediate platform acknowledgement of the triggering message, executed by
+   * the dispatcher once the agent turn is queued ('' = none). The agent is
+   * told not to acknowledge again.
+   */
+  acknowledgement_type: AgentListenerAcknowledgementType
+  acknowledgement_config?: AgentListenerAcknowledgementConfig
   /** The user the dispatcher acts as when driving the agent. */
   acting_user: UserRef
   is_enabled: boolean
@@ -511,12 +543,24 @@ export interface UpdateDraftRequest {
 export interface CreateAgentListenerRequest {
   connection_id?: string
   conversation_id?: string
+  /**
+   * Only with `connection_id`: narrow the listener to one room. Pass the
+   * internal room id (`Room.id` from listRooms), NOT the provider channel id.
+   */
+  room_id?: string
   name: string
   agent_key: string
   trigger_type: AgentListenerTriggerType
   trigger_config?: AgentListenerTriggerConfig
   /** Gate the listener behind a wake word; omit or leave empty for no gate. */
   wake_phrase?: string
+  /**
+   * Immediate platform acknowledgement; omit or '' for none. 'reaction'
+   * requires a reaction-capable connection and { emoji } in the config;
+   * 'message' requires { text }.
+   */
+  acknowledgement_type?: AgentListenerAcknowledgementType
+  acknowledgement_config?: AgentListenerAcknowledgementConfig
   /** A bare user id; the service wraps it into a person UserRef. */
   acting_user_id: string
   /** Omit to default to enabled. */
@@ -531,12 +575,24 @@ export interface CreateAgentListenerRequest {
 }
 
 export interface UpdateAgentListenerRequest {
+  /**
+   * Set to narrow the listener to a room (internal `Room.id`); pass "" to
+   * clear. Only valid on connection-scoped listeners — the connection/
+   * conversation target itself is fixed at creation.
+   */
+  room_id?: string
   name?: string
   agent_key?: string
   trigger_type?: AgentListenerTriggerType
   trigger_config?: AgentListenerTriggerConfig
   /** Set to gate the listener; pass "" to clear an existing wake phrase. */
   wake_phrase?: string
+  /**
+   * Set to change the acknowledgement; pass '' to clear. A non-empty type
+   * requires acknowledgement_config in the same request.
+   */
+  acknowledgement_type?: AgentListenerAcknowledgementType
+  acknowledgement_config?: AgentListenerAcknowledgementConfig
   acting_user_id?: string
   is_enabled?: boolean
   /** Toggle whether the platform auto-forwards the agent's text reply. */
@@ -699,6 +755,7 @@ export interface ListMessagesQuery extends PaginationQuery {
 export interface ListAgentListenersQuery extends PaginationQuery {
   connection_id?: string
   conversation_id?: string
+  room_id?: string
   agent_key?: string
   is_enabled?: boolean
 }

package/src/index.ts

@@ -185,6 +185,8 @@ export type {
   AcceptMistranscribedTermRequest,
   AddressFilterConfig,
   AgentListener,
+  AgentListenerAcknowledgementConfig,
+  AgentListenerAcknowledgementType,
   AgentListenerService,
   AgentListenerTriggerType,
   AllFilterConfig,

package/src/workflow/types.ts

@@ -609,6 +609,9 @@ export interface ExecutionTriggerContext {
   // message
   conversation_id?: string
   channel?: string
+  // connector
+  connector_key?: string
+  connection_id?: string
   // workflow (child executions)
   parent_execution_id?: string
   payload?: unknown