@getsupervisor/agents-studio-sdk 1.39.0 → 1.41.0-patch.1
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.
- package/CHANGELOG.md +162 -60
- package/README.md +40 -0
- package/dist/index.cjs +154 -50
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +104 -14
- package/dist/index.d.ts +104 -14
- package/dist/index.js +153 -50
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,12 +1,119 @@
|
|
|
1
|
+
## Unreleased
|
|
2
|
+
|
|
3
|
+
### Breaking Changes
|
|
4
|
+
|
|
5
|
+
- SDK endpoints no longer include the `/v1` prefix. Backends now serve routes without that versioned segment, so existing consumers must drop `/v1` from any custom base URLs or proxy rewrites. The `/v1` paths are no longer supported, making this a hard breaking change that requires all clients to update their configuration before upgrading the SDK.
|
|
6
|
+
|
|
7
|
+
## v1.41.0
|
|
8
|
+
|
|
9
|
+
## [1.41.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.40.0...v1.41.0) (2025-12-07)
|
|
10
|
+
|
|
11
|
+
### Features
|
|
12
|
+
|
|
13
|
+
- add GitHub token support for paths-filter in CI workflow ([3a6dbbd](https://github.com/julio-supervisor/agents-studio-be/commit/3a6dbbd0a40f625c0b7738d5e7c59c981cabbe34))
|
|
14
|
+
- add manual SDK patch release workflow for npm packages ([ac51b11](https://github.com/julio-supervisor/agents-studio-be/commit/ac51b116cfadeb0eddba35136563ee1ae45fc9f4))
|
|
15
|
+
- add S3 bucket configuration for campaigns storage with versioning and force destroy options ([ed5ae10](https://github.com/julio-supervisor/agents-studio-be/commit/ed5ae101f0d6d5402f47a76897b4efb4f89d1bc5))
|
|
16
|
+
- campaigns with stats and executions ([bc6df2a](https://github.com/julio-supervisor/agents-studio-be/commit/bc6df2a8b47d6db361c576c48183b794111f9793))
|
|
17
|
+
- **campaigns:** Implement campaign management functionality ([5cdd179](https://github.com/julio-supervisor/agents-studio-be/commit/5cdd179708d62f65ddefe15c832c8a1b10e29af3))
|
|
18
|
+
- enhance CI workflow to detect code changes in specific directories and files ([eda224c](https://github.com/julio-supervisor/agents-studio-be/commit/eda224c2807fb21c679a5116cbba433590c6d3fd))
|
|
19
|
+
- improve service_slug formatting for campaigns storage by replacing special characters ([cfde4e9](https://github.com/julio-supervisor/agents-studio-be/commit/cfde4e9d8a5078bb041977958222f14f5cf0c462))
|
|
20
|
+
- update campaigns storage configuration comments for clarity ([998fdb0](https://github.com/julio-supervisor/agents-studio-be/commit/998fdb0683195fff7e3d92264cca51a0248f96bb))
|
|
21
|
+
|
|
22
|
+
## v1.40.0
|
|
23
|
+
|
|
24
|
+
## [1.40.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.39.0...v1.40.0) (2025-12-04)
|
|
25
|
+
|
|
26
|
+
### Features
|
|
27
|
+
|
|
28
|
+
- integrate BlueprintVariablesService into agent blueprint and stage handlers, enhancing variable management ([a798152](https://github.com/julio-supervisor/agents-studio-be/commit/a798152b3ee2b99f594ad0f16d79653d7a3abbff))
|
|
29
|
+
|
|
30
|
+
## v1.39.0
|
|
31
|
+
|
|
32
|
+
## [1.39.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.38.0...v1.39.0) (2025-12-02)
|
|
33
|
+
|
|
34
|
+
### Features
|
|
35
|
+
|
|
36
|
+
- add content hash and variable management to blueprints and stages ([632ff03](https://github.com/julio-supervisor/agents-studio-be/commit/632ff031aaf4a63af09985ba336c67f7a69bfdf9))
|
|
37
|
+
- enhance DomainExceptionFilter to handle multiple domain exceptions and improve response structure ([02371e8](https://github.com/julio-supervisor/agents-studio-be/commit/02371e8d2bc197d6e04f169b75ffa1a57591a9f2))
|
|
38
|
+
- update voiceId usage in agent blueprint tests and integration specs ([560373d](https://github.com/julio-supervisor/agents-studio-be/commit/560373da338c0525a27352a59ffe5c97c2b38372))
|
|
39
|
+
- validate workspace identifier as UUID in WorkspaceGuard ([645d7a6](https://github.com/julio-supervisor/agents-studio-be/commit/645d7a668cfc424cacfd4829aa36c622b187d559))
|
|
40
|
+
|
|
41
|
+
## v1.38.0
|
|
42
|
+
|
|
43
|
+
## [1.38.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.37.0...v1.38.0) (2025-12-01)
|
|
44
|
+
|
|
45
|
+
### Features
|
|
46
|
+
|
|
47
|
+
- add ListAgentSchedulesHandler to query handlers ([a29436f](https://github.com/julio-supervisor/agents-studio-be/commit/a29436f0c514a7257742ae1c7920ed7a040cd94e))
|
|
48
|
+
- add normalization for HH:mm:ss time values in AgentScheduleTypeormMapper ([de560f6](https://github.com/julio-supervisor/agents-studio-be/commit/de560f61a2c15f98f5004a062faea8bc4edcde3c))
|
|
49
|
+
- add test for ignoring orphaned slot values when the day is disabled ([65c699c](https://github.com/julio-supervisor/agents-studio-be/commit/65c699cf3405fae26d561563808dc87044ccaf72))
|
|
50
|
+
- add voiceId support to agent blueprints and related services ([00897a8](https://github.com/julio-supervisor/agents-studio-be/commit/00897a8bc5d0728d763b690ee7cc3bc9e27c1645))
|
|
51
|
+
- format listAgentScheduleExceptions method for improved readability ([f72000b](https://github.com/julio-supervisor/agents-studio-be/commit/f72000bdea34a8786035fae8c77650393d50c89f))
|
|
52
|
+
- implement AgentInitialVersionSubscriber to create initial agent versions and update related events ([76d59aa](https://github.com/julio-supervisor/agents-studio-be/commit/76d59aaa20288fe55835c70b9de81f9f55f1a29b))
|
|
53
|
+
- refactor listAgentScheduleExceptions method in AgentSchedulesController ([bf0494f](https://github.com/julio-supervisor/agents-studio-be/commit/bf0494f2159bcca7c7dcd875b6d20741d2c927fb))
|
|
54
|
+
|
|
55
|
+
## v1.37.0
|
|
56
|
+
|
|
57
|
+
## [1.37.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.36.1...v1.37.0) (2025-11-28)
|
|
58
|
+
|
|
59
|
+
### Features
|
|
60
|
+
|
|
61
|
+
- add BlueprintWorkflowClonerService and integrate it into agent version handlers ([f585285](https://github.com/julio-supervisor/agents-studio-be/commit/f585285c827760567622ca6f63b5e5ca8a19ba3f))
|
|
62
|
+
- add tests for SDK APIs and enhance agent schedule tools ([5af2da3](https://github.com/julio-supervisor/agents-studio-be/commit/5af2da3ec0cc8acd2d6a06fb71cb5271a4348042))
|
|
63
|
+
- add unit tests for ListAgentSchedulesHandler with pagination, sorting, and error handling ([eb142f4](https://github.com/julio-supervisor/agents-studio-be/commit/eb142f4c47925eda6e989dd5987f0ae2645e3c74))
|
|
64
|
+
- enhance version publishing logic to prevent publishing active versions and unsupported statuses ([c332dd9](https://github.com/julio-supervisor/agents-studio-be/commit/c332dd912a4cbc5bee15836ff6676d6a48c55cc8))
|
|
65
|
+
- implement cloning of the latest blueprint in CreateAgentVersionHandler ([33eca82](https://github.com/julio-supervisor/agents-studio-be/commit/33eca82553190d48147382b4da3befe5a7506f63))
|
|
66
|
+
- implement listing and querying of agent schedules with pagination and sorting ([35dd513](https://github.com/julio-supervisor/agents-studio-be/commit/35dd513078a3081a4bafbc1094f0927efd44359e))
|
|
67
|
+
- update agent schedule handler tests to include scheduleId and improve specifications ([1e9c228](https://github.com/julio-supervisor/agents-studio-be/commit/1e9c2284b7fe4d220b14d82b5dc44cd332ac7cac))
|
|
68
|
+
|
|
69
|
+
### Bug Fixes
|
|
70
|
+
|
|
71
|
+
- remove unused workspaceId from ToolConnectionsCreateTool test ([b2702c8](https://github.com/julio-supervisor/agents-studio-be/commit/b2702c8e80cab01c02e2bcb87bc90e6325f368cb))
|
|
72
|
+
|
|
73
|
+
## v1.36.1
|
|
74
|
+
|
|
75
|
+
## [1.36.1](https://github.com/julio-supervisor/agents-studio-be/compare/v1.36.0...v1.36.1) (2025-11-27)
|
|
76
|
+
|
|
77
|
+
### Bug Fixes
|
|
78
|
+
|
|
79
|
+
- reorder imports and exports for consistency across modules ([23cfc68](https://github.com/julio-supervisor/agents-studio-be/commit/23cfc6823789532f6198d9f4362f808f27fc9b3a))
|
|
80
|
+
|
|
81
|
+
## v1.36.0
|
|
82
|
+
|
|
83
|
+
## [1.36.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.35.0...v1.36.0) (2025-11-27)
|
|
84
|
+
|
|
85
|
+
### Features
|
|
86
|
+
|
|
87
|
+
- add BlueprintCatalogValidationService and integrate catalog validation in agent blueprint handlers ([e611fe4](https://github.com/julio-supervisor/agents-studio-be/commit/e611fe41e075811353b4c51aea4e4651f8493d01))
|
|
88
|
+
- add type aliases for agent and webhook requests and responses ([48224ec](https://github.com/julio-supervisor/agents-studio-be/commit/48224ec1a0617b9224ebca0ef41637e44fd8f7d2))
|
|
89
|
+
|
|
90
|
+
## v1.35.0
|
|
91
|
+
|
|
92
|
+
## [1.35.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.34.0...v1.35.0) (2025-11-16)
|
|
93
|
+
|
|
94
|
+
### Features
|
|
95
|
+
|
|
96
|
+
- add default language constant and update RetellBlueprintMapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
|
|
97
|
+
- implement delete instruction functionality with command handler and controller ([af983f5](https://github.com/julio-supervisor/agents-studio-be/commit/af983f5254055d35d3972d0bcbdb12a52b48c785))
|
|
98
|
+
|
|
99
|
+
## v1.34.0
|
|
100
|
+
|
|
101
|
+
## [1.34.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.33.0...v1.34.0) (2025-11-16)
|
|
102
|
+
|
|
103
|
+
### Features
|
|
104
|
+
|
|
105
|
+
- enhance instruction management by adding active and non-deleted filtering, and integrate instructions into the Retell blueprint mapping ([baadb5f](https://github.com/julio-supervisor/agents-studio-be/commit/baadb5f561749d441c4757435fb920bb48556d7d))
|
|
106
|
+
- implement VoiceBlueprintSyncService for Retell synchronization ([6b8f03f](https://github.com/julio-supervisor/agents-studio-be/commit/6b8f03f77ca1d2b91a9628db055e2799aa039f53))
|
|
107
|
+
- introduce buildClientMock helper for consistent workspaceId handling in tests ([ae6eb30](https://github.com/julio-supervisor/agents-studio-be/commit/ae6eb305b16f677dea03a21bdfc8559c13cc641a))
|
|
108
|
+
|
|
1
109
|
## v1.33.0
|
|
2
110
|
|
|
3
111
|
## [1.33.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.32.0...v1.33.0) (2025-11-14)
|
|
4
112
|
|
|
5
113
|
### Features
|
|
6
114
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
115
|
+
- enhance agent instruction management with status and deletion tracking ([3a2c97a](https://github.com/julio-supervisor/agents-studio-be/commit/3a2c97a038a44aa236de1077f02e7eabc45cee81))
|
|
116
|
+
- simplify payload construction by always including workspaceId in tool execution ([4992d5c](https://github.com/julio-supervisor/agents-studio-be/commit/4992d5c14cb8e8ce6efdb7345a2d7a054b48f16c))
|
|
10
117
|
|
|
11
118
|
## v1.32.0
|
|
12
119
|
|
|
@@ -14,16 +121,16 @@
|
|
|
14
121
|
|
|
15
122
|
### Features
|
|
16
123
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
124
|
+
- add AgentVersionsApi and related functionality ([c797b12](https://github.com/julio-supervisor/agents-studio-be/commit/c797b12e41d717cb7e0b29cc387a0fd4ff929d2e))
|
|
125
|
+
- add API reference documentation for agent templates and update navigation structure ([103c67d](https://github.com/julio-supervisor/agents-studio-be/commit/103c67dee465cea19819a10967ea62a4aa9f9493))
|
|
126
|
+
- add endpoint to create agent from template with request schema and response examples ([0f4b9a3](https://github.com/julio-supervisor/agents-studio-be/commit/0f4b9a327f388edb2bf6eb1d724aa4585f530359))
|
|
127
|
+
- create migration for agent_instructions table with foreign key constraints ([f5cadbd](https://github.com/julio-supervisor/agents-studio-be/commit/f5cadbdad5601a8ffd761781284a408650f7f097))
|
|
128
|
+
- implement reorder blueprint stages functionality with command and handler ([8d2f6c9](https://github.com/julio-supervisor/agents-studio-be/commit/8d2f6c901e03851d3960abde340ca96191ecdf89))
|
|
22
129
|
|
|
23
130
|
### Bug Fixes
|
|
24
131
|
|
|
25
|
-
|
|
26
|
-
|
|
132
|
+
- correct description formatting for UpdateAgentBlueprintRequest in API documentation ([8e0ebce](https://github.com/julio-supervisor/agents-studio-be/commit/8e0ebced952516965e3cfc8778bbdb20297810ab))
|
|
133
|
+
- remove unused CatalogItemsCreateTool and CatalogItemsDeleteTool imports from mcp.module.ts ([d787d4e](https://github.com/julio-supervisor/agents-studio-be/commit/d787d4e707fdbab229f988de375183d3707bde12))
|
|
27
134
|
|
|
28
135
|
## v1.31.0
|
|
29
136
|
|
|
@@ -31,11 +138,11 @@
|
|
|
31
138
|
|
|
32
139
|
### Features
|
|
33
140
|
|
|
34
|
-
|
|
141
|
+
- add migration for Prospecting Agent Template with initial agent configuration and stages ([0560563](https://github.com/julio-supervisor/agents-studio-be/commit/05605631e051c7cd4705e34bc3c76c90f8373702))
|
|
35
142
|
|
|
36
143
|
### Bug Fixes
|
|
37
144
|
|
|
38
|
-
|
|
145
|
+
- update endpoint path for forking agents from template to use correct URL format ([9d00f93](https://github.com/julio-supervisor/agents-studio-be/commit/9d00f9350b33847a6fd582417654336769c645c3))
|
|
39
146
|
|
|
40
147
|
## v1.30.0
|
|
41
148
|
|
|
@@ -43,23 +150,23 @@
|
|
|
43
150
|
|
|
44
151
|
### Features
|
|
45
152
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
153
|
+
- implement catalog templates API and tools, including listing and filtering functionality ([9467fb2](https://github.com/julio-supervisor/agents-studio-be/commit/9467fb21c19a35f45e8ec8dcb2bfc26254558371))
|
|
154
|
+
- use forwardRef for AgentBlueprintsModule import in blueprint-stages.module.ts ([63420a1](https://github.com/julio-supervisor/agents-studio-be/commit/63420a1710305fee8e22f0826665b0eedb866107))
|
|
155
|
+
-
|
|
156
|
+
|
|
49
157
|
## v1.29.0
|
|
50
158
|
|
|
51
159
|
## [1.29.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.28.0...v1.29.0) (2025-11-10)
|
|
52
160
|
|
|
53
161
|
### Features
|
|
54
162
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
163
|
+
- add comprehensive tests for catalog templates, including handlers, controller, and DTOs; implement in-memory repository specifications ([1a2d81e](https://github.com/julio-supervisor/agents-studio-be/commit/1a2d81e1b25d4495c240d8af021894e30c6a814c))
|
|
164
|
+
- add ForkAgentFromTemplateRequest schema and endpoint ([394c9d7](https://github.com/julio-supervisor/agents-studio-be/commit/394c9d7ed327f0a7cccedf0e8b18218357976c15))
|
|
165
|
+
- add unit tests for CatalogTemplateTypeormSpecificationFactory, covering various filtering and ordering scenarios ([827825b](https://github.com/julio-supervisor/agents-studio-be/commit/827825b55cf97ab21de8698025ad611abe377771))
|
|
58
166
|
|
|
59
167
|
### Bug Fixes
|
|
60
168
|
|
|
61
|
-
|
|
62
|
-
|
|
169
|
+
- update workspaceId parameter to be required in createAgent and forkAgentFromTemplate methods; improve error messages for UUID validation ([b272a8f](https://github.com/julio-supervisor/agents-studio-be/commit/b272a8fbc1b56a9d511bb2ecc904d8aed59c07b6))
|
|
63
170
|
|
|
64
171
|
## v1.27.0
|
|
65
172
|
|
|
@@ -67,21 +174,20 @@
|
|
|
67
174
|
|
|
68
175
|
### Features
|
|
69
176
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
177
|
+
- add migration to include 'order' column in blueprint_stages table ([79e7cd8](https://github.com/julio-supervisor/agents-studio-be/commit/79e7cd80a046f6049abd8df5fec1333de7dc2851))
|
|
178
|
+
- add order property to blueprint stages and update related logic ([b7dc672](https://github.com/julio-supervisor/agents-studio-be/commit/b7dc6727e8543f39d665b1e904bc08449ccb386d))
|
|
179
|
+
- add orderByOrderAsc method and related tests for blueprint stages ([ab46a4f](https://github.com/julio-supervisor/agents-studio-be/commit/ab46a4f4b6ff50409e0f878228579dad152b147f))
|
|
180
|
+
- add startSpeaker property to agent blueprints and related components ([b1ea8ef](https://github.com/julio-supervisor/agents-studio-be/commit/b1ea8ef76d200484f40cee10ec7c0a6159ff9032))
|
|
181
|
+
- add tests for BlueprintStageTriggerCondition and enhance validation for rule type values ([42cde2a](https://github.com/julio-supervisor/agents-studio-be/commit/42cde2a5e5e2b49df2cf9f51097dbca2b914bde7))
|
|
182
|
+
- add versioning details to AgentBlueprint and AgentVersion in tests ([d655d88](https://github.com/julio-supervisor/agents-studio-be/commit/d655d8836fd17d4bdeaf919f74c2fd72f87c3ea1))
|
|
183
|
+
- enhance stage result handling with agentId context and normalize stage order input ([8238b5d](https://github.com/julio-supervisor/agents-studio-be/commit/8238b5da1993d89a1def73d2821b3fc46ffabea2))
|
|
184
|
+
- enhance toStageTriggerResult mapping to include blueprintId and improve header normalization in PublicApiToolBase ([27298c8](https://github.com/julio-supervisor/agents-studio-be/commit/27298c8bc040190a97996cacfbad36a6aa919d9d))
|
|
185
|
+
- enhance toStageTriggerResult to accept blueprintId from context and update related methods ([f6f8598](https://github.com/julio-supervisor/agents-studio-be/commit/f6f8598e41ca7ff559b192cef3ccd86a28377dda))
|
|
186
|
+
- include blueprint in payload mapping for voice blueprint sync ([ce3ebd1](https://github.com/julio-supervisor/agents-studio-be/commit/ce3ebd11ec57e81ab49626b6996ac55e4a4fc3f0))
|
|
80
187
|
|
|
81
188
|
### Bug Fixes
|
|
82
189
|
|
|
83
|
-
|
|
84
|
-
|
|
190
|
+
- remove tsconfig-paths/register from Docker entrypoint and CMD ([054ceeb](https://github.com/julio-supervisor/agents-studio-be/commit/054ceeb8ad53f6b4bfce38fa0effe00128e2c77e))
|
|
85
191
|
|
|
86
192
|
## v1.26.0
|
|
87
193
|
|
|
@@ -89,8 +195,7 @@
|
|
|
89
195
|
|
|
90
196
|
### Features
|
|
91
197
|
|
|
92
|
-
|
|
93
|
-
|
|
198
|
+
- enhance agent stages API to include blueprintId in all relevant methods ([0de45da](https://github.com/julio-supervisor/agents-studio-be/commit/0de45da137e1fa4d79bc5aabe86d068dbe8465e1))
|
|
94
199
|
|
|
95
200
|
## v1.25.0
|
|
96
201
|
|
|
@@ -98,11 +203,10 @@
|
|
|
98
203
|
|
|
99
204
|
### Features
|
|
100
205
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
206
|
+
- enhance blueprint stage functionality with goalPrompt and promptInstructions attributes ([9d13681](https://github.com/julio-supervisor/agents-studio-be/commit/9d13681346f9ea48f5dd6b9c16ab90c95a81356d))
|
|
207
|
+
- implement blueprint stages and triggers ([b94e0d9](https://github.com/julio-supervisor/agents-studio-be/commit/b94e0d9723bf6406a9163d3d9dc998ada06be10a))
|
|
208
|
+
- refactor agent creation and blueprint building for improved test clarity and functionality ([136d5b1](https://github.com/julio-supervisor/agents-studio-be/commit/136d5b12a725d65e6d2fd77e224cc6615e3707d1))
|
|
209
|
+
- update blueprint stage to use goalPrompt and promptInstructions ([0e7bf89](https://github.com/julio-supervisor/agents-studio-be/commit/0e7bf89ed94853ad856c155e0f71e1ba1dafea84))
|
|
106
210
|
|
|
107
211
|
## v1.24.0
|
|
108
212
|
|
|
@@ -110,15 +214,16 @@
|
|
|
110
214
|
|
|
111
215
|
### Features
|
|
112
216
|
|
|
113
|
-
|
|
114
|
-
|
|
217
|
+
- add optional avatarUrl and debounceDelayMs to agent schema ([b909f45](https://github.com/julio-supervisor/agents-studio-be/commit/b909f457ef82df455e77ae8ec772a4ff1de3b763))
|
|
218
|
+
-
|
|
219
|
+
|
|
115
220
|
## v1.23.0
|
|
116
221
|
|
|
117
222
|
## [1.23.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.22.2...v1.23.0) (2025-11-05)
|
|
118
223
|
|
|
119
224
|
### Features
|
|
120
225
|
|
|
121
|
-
|
|
226
|
+
- implement Agent Stages and Triggers API ([c0b997f](https://github.com/julio-supervisor/agents-studio-be/commit/c0b997fd233f8cb1fb4fc2f43b36344e46675191))
|
|
122
227
|
|
|
123
228
|
## v1.22.2
|
|
124
229
|
|
|
@@ -126,8 +231,7 @@
|
|
|
126
231
|
|
|
127
232
|
### Bug Fixes
|
|
128
233
|
|
|
129
|
-
|
|
130
|
-
|
|
234
|
+
- update API base URL to production endpoint across multiple files ([7491ce7](https://github.com/julio-supervisor/agents-studio-be/commit/7491ce700f348682d6559a5f3e9cf93f4aa9bc70))
|
|
131
235
|
|
|
132
236
|
## v1.22.1
|
|
133
237
|
|
|
@@ -135,7 +239,7 @@
|
|
|
135
239
|
|
|
136
240
|
### Bug Fixes
|
|
137
241
|
|
|
138
|
-
|
|
242
|
+
- update docker-compose context for public-api service ([1f1cfaf](https://github.com/julio-supervisor/agents-studio-be/commit/1f1cfafa50e9f499ea44e8552fd71f2ddcf97ac9))
|
|
139
243
|
|
|
140
244
|
## v1.22.0
|
|
141
245
|
|
|
@@ -143,8 +247,8 @@
|
|
|
143
247
|
|
|
144
248
|
### Features
|
|
145
249
|
|
|
146
|
-
|
|
147
|
-
|
|
250
|
+
- add integration guide for AG-UI in NestJS monolithic applications ([f8944d0](https://github.com/julio-supervisor/agents-studio-be/commit/f8944d0686515dee17d20e0e3ad29e25b3d7bd8f))
|
|
251
|
+
- integrate schedule call functionality and update related prompts and templates ([8fffd67](https://github.com/julio-supervisor/agents-studio-be/commit/8fffd67b6a4f1abfc8bbd9735034a7d905159afd))
|
|
148
252
|
|
|
149
253
|
## v1.21.0
|
|
150
254
|
|
|
@@ -152,21 +256,20 @@
|
|
|
152
256
|
|
|
153
257
|
### Features
|
|
154
258
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
259
|
+
- add callerApiKey to ScheduleCall interfaces and update related logic ([6c92042](https://github.com/julio-supervisor/agents-studio-be/commit/6c920426ec45bd21ec8e4ae79f5bb96705681434))
|
|
260
|
+
- add quick code review checklist and enhance agent schedules documentation ([877d196](https://github.com/julio-supervisor/agents-studio-be/commit/877d196461470434e08781b1edcae9689f25339c))
|
|
261
|
+
- add schedule call tool integration and usage guidance ([9bcb5dd](https://github.com/julio-supervisor/agents-studio-be/commit/9bcb5dd1d3206de5191f0e1c535600a4fed9d8ba))
|
|
262
|
+
- add Step Functions configuration for scheduling calls in dev and prod environments ([3b787d6](https://github.com/julio-supervisor/agents-studio-be/commit/3b787d6251882dab6e0fc820d2a3789950db58a2))
|
|
263
|
+
- integrate agent availability checks in voice call execution tools ([f8401d8](https://github.com/julio-supervisor/agents-studio-be/commit/f8401d8a5ea3a835a6ee1bb0001e0fb8eab3f4be))
|
|
160
264
|
|
|
161
265
|
### Bug Fixes
|
|
162
266
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
267
|
+
- enhance IAM role policy to allow additional CloudWatch log actions ([4503712](https://github.com/julio-supervisor/agents-studio-be/commit/4503712ee8799c54ec733d5c861148f2633e3f95))
|
|
268
|
+
- remove unnecessary Sid from IAM role policy for Step Functions logging ([dad9e96](https://github.com/julio-supervisor/agents-studio-be/commit/dad9e9602bffa09193bae95f56ba8f8db0e69349))
|
|
269
|
+
- standardize formatting in IAM role policy for CloudWatch log actions ([85fb9b0](https://github.com/julio-supervisor/agents-studio-be/commit/85fb9b0166b7c0831e41be89d9c8fbb190b150bc))
|
|
270
|
+
- update comments and standardize variable names in Step Functions configuration ([7d25b37](https://github.com/julio-supervisor/agents-studio-be/commit/7d25b3754309cf50055aba451d29977cf9f778be))
|
|
271
|
+
- update log_destination format in Step Functions logging configuration ([1830502](https://github.com/julio-supervisor/agents-studio-be/commit/18305027a64b2e82780dcb3d21c8ca622bdc6452))
|
|
272
|
+
- update logging configuration in Step Functions to use log_destination ([7eb4243](https://github.com/julio-supervisor/agents-studio-be/commit/7eb4243710e70d516d398d227e6a41795d1eccb3))
|
|
170
273
|
|
|
171
274
|
## v1.20.0
|
|
172
275
|
|
|
@@ -313,4 +416,3 @@ Sin cambios en el SDK JS.
|
|
|
313
416
|
### Features
|
|
314
417
|
|
|
315
418
|
- Publicación inicial del SDK con estructura hexagonal, cliente HTTP, módulos de herramientas y workspaces, y tipados OpenAPI generados ([c6f9e6f](https://github.com/julio-supervisor/agents-studio-be/commit/c6f9e6f40ea25026c73bef801fe84095bcff3c91)).
|
|
316
|
-
|
package/README.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
SDK JS/TS oficial para interactuar con la Public API de Agents Studio.
|
|
4
4
|
|
|
5
|
+
## Convenciones para releases del SDK
|
|
6
|
+
|
|
7
|
+
- Usa commits convencionales con el scope `sdk-js` para **cualquier cambio dentro de `apps/public-api/sdk/js/**`** (ejemplo: `feat(sdk-js): agrega soporte a X`).
|
|
8
|
+
- Solo los commits con ese scope generan nuevas versiones y entradas en el CHANGELOG; otros cambios quedan ignorados por el pipeline de publicación.
|
|
9
|
+
- Si un PR mezcla cambios del SDK con otros módulos, asegúrate de dividirlos o añadir un commit independiente con el scope correcto para que la release refleje únicamente los cambios del cliente.
|
|
10
|
+
|
|
11
|
+
Sin el scope `sdk-js` el workflow de publicación puede ejecutarse, pero no cortará una release en npm.
|
|
12
|
+
|
|
5
13
|
## Instalación
|
|
6
14
|
|
|
7
15
|
```bash
|
|
@@ -73,6 +81,38 @@ await client.tools.uploadResource(tools.data[0].identifier, formData);
|
|
|
73
81
|
|
|
74
82
|
// eliminar un agente
|
|
75
83
|
await client.agents.delete(agent.agentId);
|
|
84
|
+
|
|
85
|
+
// listar workspaces y tomar el primero (refrescando caché local)
|
|
86
|
+
const workspaces = await client.workspaces.list({
|
|
87
|
+
limit: 10,
|
|
88
|
+
refreshCache: true,
|
|
89
|
+
});
|
|
90
|
+
const firstWorkspaceId = workspaces.data[0]?.id;
|
|
91
|
+
if (firstWorkspaceId) {
|
|
92
|
+
client.workspace.set(firstWorkspaceId);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// campañas masivas desde CSV
|
|
96
|
+
const campaign = await client.campaigns.create(agent.agentId, versionId, {
|
|
97
|
+
name: 'Holiday follow-up',
|
|
98
|
+
objective: 'Re-engage dormant customers',
|
|
99
|
+
file: new File([csvBlob], 'campaign-rows.csv', { type: 'text/csv' }),
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
const recentCampaigns = await client.campaigns.list({ limit: 10 });
|
|
103
|
+
console.log(recentCampaigns.data.map((item) => item.name));
|
|
104
|
+
|
|
105
|
+
// ejecuciones individuales con correlación al toolExecutionId
|
|
106
|
+
const executions = await client.campaigns.listExecutions(campaign.campaignId, {
|
|
107
|
+
limit: 20,
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
executions.data.forEach((row) => {
|
|
111
|
+
console.log(
|
|
112
|
+
`Row ${row.rowNumber} => status=${row.status} agentExecutionId=${row.agentExecutionId}`,
|
|
113
|
+
);
|
|
114
|
+
});
|
|
115
|
+
// agentExecutionId coincide con el toolExecutionId expuesto por client.tools.execute
|
|
76
116
|
```
|
|
77
117
|
|
|
78
118
|
## Catálogos (Catalogs)
|