syllable-sdk 0.1.0-alpha.24 → 0.1.0-alpha.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/api-reference/sdks/agents/README.md +224 -0
  2. package/api-reference/sdks/availabletargets/README.md +49 -0
  3. package/api-reference/sdks/channels/README.md +92 -0
  4. package/api-reference/sdks/chats/README.md +55 -0
  5. package/api-reference/sdks/conversations/README.md +91 -0
  6. package/api-reference/sdks/dashboards/README.md +321 -0
  7. package/api-reference/sdks/events/README.md +50 -0
  8. package/api-reference/sdks/greetings/README.md +223 -0
  9. package/api-reference/sdks/organizations/README.md +48 -0
  10. package/api-reference/sdks/prompts/README.md +225 -0
  11. package/api-reference/sdks/sessions/README.md +50 -0
  12. package/api-reference/sdks/syllable/README.md +22 -0
  13. package/api-reference/sdks/targets/README.md +194 -0
  14. package/api-reference/sdks/tools/README.md +92 -0
  15. package/docs/sdks/channels/README.md +2 -2
  16. package/docs/sdks/targets/README.md +2 -4
  17. package/funcs/channelsDelete.d.ts +4 -2
  18. package/funcs/channelsDelete.d.ts.map +1 -1
  19. package/funcs/channelsDelete.js +5 -2
  20. package/funcs/channelsDelete.js.map +1 -1
  21. package/funcs/channelsTargetsUpdate.d.ts.map +1 -1
  22. package/funcs/channelsTargetsUpdate.js +3 -1
  23. package/funcs/channelsTargetsUpdate.js.map +1 -1
  24. package/lib/config.d.ts +3 -3
  25. package/lib/config.js +5 -5
  26. package/models/components/channel.d.ts +0 -3
  27. package/models/components/channel.d.ts.map +1 -1
  28. package/models/components/channel.js.map +1 -1
  29. package/models/components/channeltarget.d.ts +10 -0
  30. package/models/components/channeltarget.d.ts.map +1 -1
  31. package/models/components/channeltarget.js +11 -0
  32. package/models/components/channeltarget.js.map +1 -1
  33. package/models/components/channeltargetupdaterequest.d.ts +41 -0
  34. package/models/components/channeltargetupdaterequest.d.ts.map +1 -0
  35. package/models/components/channeltargetupdaterequest.js +88 -0
  36. package/models/components/channeltargetupdaterequest.js.map +1 -0
  37. package/models/components/daochanneltargetagent.d.ts +47 -0
  38. package/models/components/daochanneltargetagent.d.ts.map +1 -0
  39. package/models/components/daochanneltargetagent.js +92 -0
  40. package/models/components/daochanneltargetagent.js.map +1 -0
  41. package/models/components/index.d.ts +3 -0
  42. package/models/components/index.d.ts.map +1 -1
  43. package/models/components/index.js +3 -0
  44. package/models/components/index.js.map +1 -1
  45. package/models/components/llmconfig.d.ts +3 -34
  46. package/models/components/llmconfig.d.ts.map +1 -1
  47. package/models/components/llmconfig.js +4 -26
  48. package/models/components/llmconfig.js.map +1 -1
  49. package/models/components/prompt.d.ts +0 -3
  50. package/models/components/prompt.d.ts.map +1 -1
  51. package/models/components/prompt.js.map +1 -1
  52. package/models/components/promptcreate.d.ts +0 -3
  53. package/models/components/promptcreate.d.ts.map +1 -1
  54. package/models/components/promptcreate.js.map +1 -1
  55. package/models/components/promptupdate.d.ts +0 -3
  56. package/models/components/promptupdate.d.ts.map +1 -1
  57. package/models/components/promptupdate.js.map +1 -1
  58. package/models/components/provider.d.ts +34 -0
  59. package/models/components/provider.d.ts.map +1 -0
  60. package/models/components/provider.js +54 -0
  61. package/models/components/provider.js.map +1 -0
  62. package/models/components/target.d.ts +0 -3
  63. package/models/components/target.d.ts.map +1 -1
  64. package/models/components/target.js.map +1 -1
  65. package/models/operations/channeltargetsupdate.d.ts +2 -2
  66. package/models/operations/channeltargetsupdate.d.ts.map +1 -1
  67. package/models/operations/channeltargetsupdate.js +4 -4
  68. package/models/operations/channeltargetsupdate.js.map +1 -1
  69. package/package.json +1 -1
  70. package/sdk/channels.d.ts +4 -1
  71. package/sdk/channels.d.ts.map +1 -1
  72. package/sdk/channels.js +3 -0
  73. package/sdk/channels.js.map +1 -1
  74. package/src/funcs/channelsDelete.ts +7 -4
  75. package/src/funcs/channelsTargetsUpdate.ts +3 -1
  76. package/src/lib/config.ts +5 -5
  77. package/src/models/components/channel.ts +0 -3
  78. package/src/models/components/channeltarget.ts +27 -0
  79. package/src/models/components/channeltargetupdaterequest.ts +107 -0
  80. package/src/models/components/daochanneltargetagent.ts +117 -0
  81. package/src/models/components/index.ts +3 -0
  82. package/src/models/components/llmconfig.ts +9 -36
  83. package/src/models/components/prompt.ts +0 -3
  84. package/src/models/components/promptcreate.ts +0 -3
  85. package/src/models/components/promptupdate.ts +0 -3
  86. package/src/models/components/provider.ts +37 -0
  87. package/src/models/components/target.ts +0 -3
  88. package/src/models/operations/channeltargetsupdate.ts +8 -6
  89. package/src/sdk/channels.ts +4 -1
@@ -0,0 +1,224 @@
1
+ # Agents
2
+ (*agents*)
3
+
4
+ ## Overview
5
+
6
+ Operations related to agents
7
+
8
+ ### Available Operations
9
+
10
+ * [list](#list) - Agent List
11
+ * [create](#create) - Create Agent
12
+ * [update](#update) - Update Agent
13
+ * [get_by_id](#get_by_id) - Get Agent By Id
14
+ * [delete](#delete) - Delete Agent
15
+
16
+ ## list
17
+
18
+ List the existing agents
19
+
20
+ ### Example Usage
21
+
22
+ ```python
23
+ import os
24
+ from syllable_sdk import Syllable
25
+
26
+ s = Syllable(
27
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
28
+ )
29
+
30
+ res = s.agents.list()
31
+
32
+ if res is not None:
33
+ # handle response
34
+ pass
35
+
36
+ ```
37
+
38
+ ### Parameters
39
+
40
+ | Parameter | Type | Required | Description |
41
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
42
+ | `request` | [models.AgentListRequest](../../models/agentlistrequest.md) | :heavy_check_mark: | The request object to use for the request. |
43
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
44
+
45
+ ### Response
46
+
47
+ **[models.AgentListResponse](../../models/agentlistresponse.md)**
48
+
49
+ ### Errors
50
+
51
+ | Error Type | Status Code | Content Type |
52
+ | -------------------------- | -------------------------- | -------------------------- |
53
+ | models.HTTPValidationError | 422 | application/json |
54
+ | models.SDKError | 4XX, 5XX | \*/\* |
55
+
56
+ ## create
57
+
58
+ Create a new agent
59
+
60
+ ### Example Usage
61
+
62
+ ```python
63
+ import os
64
+ from syllable_sdk import Syllable
65
+
66
+ s = Syllable(
67
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
68
+ )
69
+
70
+ res = s.agents.create(request={
71
+ "name": "<value>",
72
+ "timezone": "Antarctica/Rothera",
73
+ "type_extra": {},
74
+ })
75
+
76
+ if res is not None:
77
+ # handle response
78
+ pass
79
+
80
+ ```
81
+
82
+ ### Parameters
83
+
84
+ | Parameter | Type | Required | Description |
85
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
86
+ | `request` | [models.AgentCreate](../../models/agentcreate.md) | :heavy_check_mark: | The request object to use for the request. |
87
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
88
+
89
+ ### Response
90
+
91
+ **[models.Agent](../../models/agent.md)**
92
+
93
+ ### Errors
94
+
95
+ | Error Type | Status Code | Content Type |
96
+ | -------------------------- | -------------------------- | -------------------------- |
97
+ | models.HTTPValidationError | 422 | application/json |
98
+ | models.SDKError | 4XX, 5XX | \*/\* |
99
+
100
+ ## update
101
+
102
+ Update an existing agent
103
+
104
+ ### Example Usage
105
+
106
+ ```python
107
+ import os
108
+ from syllable_sdk import Syllable
109
+
110
+ s = Syllable(
111
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
112
+ )
113
+
114
+ res = s.agents.update(request={
115
+ "name": "<value>",
116
+ "timezone": "Europe/Tallinn",
117
+ "type_extra": {},
118
+ "id": 597129,
119
+ })
120
+
121
+ if res is not None:
122
+ # handle response
123
+ pass
124
+
125
+ ```
126
+
127
+ ### Parameters
128
+
129
+ | Parameter | Type | Required | Description |
130
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
131
+ | `request` | [models.Agent](../../models/agent.md) | :heavy_check_mark: | The request object to use for the request. |
132
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
133
+
134
+ ### Response
135
+
136
+ **[models.Agent](../../models/agent.md)**
137
+
138
+ ### Errors
139
+
140
+ | Error Type | Status Code | Content Type |
141
+ | -------------------------- | -------------------------- | -------------------------- |
142
+ | models.HTTPValidationError | 422 | application/json |
143
+ | models.SDKError | 4XX, 5XX | \*/\* |
144
+
145
+ ## get_by_id
146
+
147
+ Get an agent by ID.
148
+
149
+ ### Example Usage
150
+
151
+ ```python
152
+ import os
153
+ from syllable_sdk import Syllable
154
+
155
+ s = Syllable(
156
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
157
+ )
158
+
159
+ res = s.agents.get_by_id(agent_id=931598)
160
+
161
+ if res is not None:
162
+ # handle response
163
+ pass
164
+
165
+ ```
166
+
167
+ ### Parameters
168
+
169
+ | Parameter | Type | Required | Description |
170
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
171
+ | `agent_id` | *int* | :heavy_check_mark: | N/A |
172
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
173
+
174
+ ### Response
175
+
176
+ **[models.Agent](../../models/agent.md)**
177
+
178
+ ### Errors
179
+
180
+ | Error Type | Status Code | Content Type |
181
+ | -------------------------- | -------------------------- | -------------------------- |
182
+ | models.HTTPValidationError | 422 | application/json |
183
+ | models.SDKError | 4XX, 5XX | \*/\* |
184
+
185
+ ## delete
186
+
187
+ Delete an agent by ID
188
+
189
+ ### Example Usage
190
+
191
+ ```python
192
+ import os
193
+ from syllable_sdk import Syllable
194
+
195
+ s = Syllable(
196
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
197
+ )
198
+
199
+ res = s.agents.delete(agent_id=5705, reason="<value>")
200
+
201
+ if res is not None:
202
+ # handle response
203
+ pass
204
+
205
+ ```
206
+
207
+ ### Parameters
208
+
209
+ | Parameter | Type | Required | Description |
210
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
211
+ | `agent_id` | *int* | :heavy_check_mark: | N/A |
212
+ | `reason` | *str* | :heavy_check_mark: | N/A |
213
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
214
+
215
+ ### Response
216
+
217
+ **[Any](../../models/.md)**
218
+
219
+ ### Errors
220
+
221
+ | Error Type | Status Code | Content Type |
222
+ | -------------------------- | -------------------------- | -------------------------- |
223
+ | models.HTTPValidationError | 422 | application/json |
224
+ | models.SDKError | 4XX, 5XX | \*/\* |
@@ -0,0 +1,49 @@
1
+ # AvailableTargets
2
+ (*channels.available_targets*)
3
+
4
+ ## Overview
5
+
6
+ ### Available Operations
7
+
8
+ * [list](#list) - Available Targets List
9
+
10
+ ## list
11
+
12
+ List the available phone numbers
13
+
14
+ ### Example Usage
15
+
16
+ ```python
17
+ import os
18
+ from syllable_sdk import Syllable
19
+
20
+ s = Syllable(
21
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
22
+ )
23
+
24
+ res = s.channels.available_targets.list()
25
+
26
+ if res is not None:
27
+ # handle response
28
+ pass
29
+
30
+ ```
31
+
32
+ ### Parameters
33
+
34
+ | Parameter | Type | Required | Description |
35
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
36
+ | `page` | *OptionalNullable[int]* | :heavy_minus_sign: | N/A |
37
+ | `limit` | *Optional[int]* | :heavy_minus_sign: | N/A |
38
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
39
+
40
+ ### Response
41
+
42
+ **[models.AvailableTargetsListResponse](../../models/availabletargetslistresponse.md)**
43
+
44
+ ### Errors
45
+
46
+ | Error Type | Status Code | Content Type |
47
+ | -------------------------- | -------------------------- | -------------------------- |
48
+ | models.HTTPValidationError | 422 | application/json |
49
+ | models.SDKError | 4XX, 5XX | \*/\* |
@@ -0,0 +1,92 @@
1
+ # Channels
2
+ (*channels*)
3
+
4
+ ## Overview
5
+
6
+ Operations related to channels
7
+
8
+ ### Available Operations
9
+
10
+ * [list](#list) - Get Channels
11
+ * [delete](#delete) - Delete Channel
12
+
13
+ ## list
14
+
15
+ Get Channels
16
+
17
+ ### Example Usage
18
+
19
+ ```python
20
+ import os
21
+ from syllable_sdk import Syllable
22
+
23
+ s = Syllable(
24
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
25
+ )
26
+
27
+ res = s.channels.list()
28
+
29
+ if res is not None:
30
+ # handle response
31
+ pass
32
+
33
+ ```
34
+
35
+ ### Parameters
36
+
37
+ | Parameter | Type | Required | Description |
38
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
39
+ | `page` | *OptionalNullable[int]* | :heavy_minus_sign: | N/A |
40
+ | `limit` | *Optional[int]* | :heavy_minus_sign: | N/A |
41
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
42
+
43
+ ### Response
44
+
45
+ **[models.ChannelListResponse](../../models/channellistresponse.md)**
46
+
47
+ ### Errors
48
+
49
+ | Error Type | Status Code | Content Type |
50
+ | -------------------------- | -------------------------- | -------------------------- |
51
+ | models.HTTPValidationError | 422 | application/json |
52
+ | models.SDKError | 4XX, 5XX | \*/\* |
53
+
54
+ ## delete
55
+
56
+ Delete channel by ID
57
+
58
+ ### Example Usage
59
+
60
+ ```python
61
+ import os
62
+ from syllable_sdk import Syllable
63
+
64
+ s = Syllable(
65
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
66
+ )
67
+
68
+ res = s.channels.delete(channel_id="<id>")
69
+
70
+ if res is not None:
71
+ # handle response
72
+ pass
73
+
74
+ ```
75
+
76
+ ### Parameters
77
+
78
+ | Parameter | Type | Required | Description |
79
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
80
+ | `channel_id` | *str* | :heavy_check_mark: | N/A |
81
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
82
+
83
+ ### Response
84
+
85
+ **[models.ChannelTarget](../../models/channeltarget.md)**
86
+
87
+ ### Errors
88
+
89
+ | Error Type | Status Code | Content Type |
90
+ | -------------------------- | -------------------------- | -------------------------- |
91
+ | models.HTTPValidationError | 422 | application/json |
92
+ | models.SDKError | 4XX, 5XX | \*/\* |
@@ -0,0 +1,55 @@
1
+ # Chats
2
+ (*agents.chats*)
3
+
4
+ ## Overview
5
+
6
+ ### Available Operations
7
+
8
+ * [send_message](#send_message) - Send New Message
9
+
10
+ ## send_message
11
+
12
+ Send a new message
13
+
14
+ ### Example Usage
15
+
16
+ ```python
17
+ import os
18
+ from syllable_sdk import Syllable
19
+
20
+ s = Syllable(
21
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
22
+ )
23
+
24
+ res = s.agents.chats.send_message(request={
25
+ "service_name": "<value>",
26
+ "source_name": "<value>",
27
+ "chat_id": "<id>",
28
+ "agent_id": "<id>",
29
+ "org_name": "<value>",
30
+ "text": "<value>",
31
+ })
32
+
33
+ if res is not None:
34
+ # handle response
35
+ pass
36
+
37
+ ```
38
+
39
+ ### Parameters
40
+
41
+ | Parameter | Type | Required | Description |
42
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
43
+ | `request` | [models.ChatMessage](../../models/chatmessage.md) | :heavy_check_mark: | The request object to use for the request. |
44
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
45
+
46
+ ### Response
47
+
48
+ **[models.ChatMessageResponse](../../models/chatmessageresponse.md)**
49
+
50
+ ### Errors
51
+
52
+ | Error Type | Status Code | Content Type |
53
+ | -------------------------- | -------------------------- | -------------------------- |
54
+ | models.HTTPValidationError | 422 | application/json |
55
+ | models.SDKError | 4XX, 5XX | \*/\* |
@@ -0,0 +1,91 @@
1
+ # Conversations
2
+ (*conversations*)
3
+
4
+ ## Overview
5
+
6
+ Operations related to conversations
7
+
8
+ ### Available Operations
9
+
10
+ * [list](#list) - Conversations List
11
+ * [get](#get) - Get Conversation By Id
12
+
13
+ ## list
14
+
15
+ Conversations List
16
+
17
+ ### Example Usage
18
+
19
+ ```python
20
+ import os
21
+ from syllable_sdk import Syllable
22
+
23
+ s = Syllable(
24
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
25
+ )
26
+
27
+ res = s.conversations.list()
28
+
29
+ if res is not None:
30
+ # handle response
31
+ pass
32
+
33
+ ```
34
+
35
+ ### Parameters
36
+
37
+ | Parameter | Type | Required | Description |
38
+ | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
39
+ | `request` | [models.ConversationsListRequest](../../models/conversationslistrequest.md) | :heavy_check_mark: | The request object to use for the request. |
40
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
41
+
42
+ ### Response
43
+
44
+ **[models.ConversationListResponse](../../models/conversationlistresponse.md)**
45
+
46
+ ### Errors
47
+
48
+ | Error Type | Status Code | Content Type |
49
+ | -------------------------- | -------------------------- | -------------------------- |
50
+ | models.HTTPValidationError | 422 | application/json |
51
+ | models.SDKError | 4XX, 5XX | \*/\* |
52
+
53
+ ## get
54
+
55
+ Get Conversation By Id
56
+
57
+ ### Example Usage
58
+
59
+ ```python
60
+ import os
61
+ from syllable_sdk import Syllable
62
+
63
+ s = Syllable(
64
+ api_key_header=os.getenv("SYLLABLE_API_KEY_HEADER", ""),
65
+ )
66
+
67
+ res = s.conversations.get(conversation_id="<id>")
68
+
69
+ if res is not None:
70
+ # handle response
71
+ pass
72
+
73
+ ```
74
+
75
+ ### Parameters
76
+
77
+ | Parameter | Type | Required | Description |
78
+ | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
79
+ | `conversation_id` | *str* | :heavy_check_mark: | N/A |
80
+ | `retries` | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md) | :heavy_minus_sign: | Configuration to override the default retry behavior of the client. |
81
+
82
+ ### Response
83
+
84
+ **[models.ConversationTranscriptionResponse](../../models/conversationtranscriptionresponse.md)**
85
+
86
+ ### Errors
87
+
88
+ | Error Type | Status Code | Content Type |
89
+ | -------------------------- | -------------------------- | -------------------------- |
90
+ | models.HTTPValidationError | 422 | application/json |
91
+ | models.SDKError | 4XX, 5XX | \*/\* |