@getsupervisor/agents-studio-sdk 1.41.0 → 1.41.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 CHANGED
@@ -1,10 +1,31 @@
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
+
1
22
  ## v1.40.0
2
23
 
3
24
  ## [1.40.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.39.0...v1.40.0) (2025-12-04)
4
25
 
5
26
  ### Features
6
27
 
7
- * integrate BlueprintVariablesService into agent blueprint and stage handlers, enhancing variable management ([a798152](https://github.com/julio-supervisor/agents-studio-be/commit/a798152b3ee2b99f594ad0f16d79653d7a3abbff))
28
+ - integrate BlueprintVariablesService into agent blueprint and stage handlers, enhancing variable management ([a798152](https://github.com/julio-supervisor/agents-studio-be/commit/a798152b3ee2b99f594ad0f16d79653d7a3abbff))
8
29
 
9
30
  ## v1.39.0
10
31
 
@@ -12,10 +33,10 @@
12
33
 
13
34
  ### Features
14
35
 
15
- * add content hash and variable management to blueprints and stages ([632ff03](https://github.com/julio-supervisor/agents-studio-be/commit/632ff031aaf4a63af09985ba336c67f7a69bfdf9))
16
- * enhance DomainExceptionFilter to handle multiple domain exceptions and improve response structure ([02371e8](https://github.com/julio-supervisor/agents-studio-be/commit/02371e8d2bc197d6e04f169b75ffa1a57591a9f2))
17
- * update voiceId usage in agent blueprint tests and integration specs ([560373d](https://github.com/julio-supervisor/agents-studio-be/commit/560373da338c0525a27352a59ffe5c97c2b38372))
18
- * validate workspace identifier as UUID in WorkspaceGuard ([645d7a6](https://github.com/julio-supervisor/agents-studio-be/commit/645d7a668cfc424cacfd4829aa36c622b187d559))
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))
19
40
 
20
41
  ## v1.38.0
21
42
 
@@ -23,13 +44,13 @@
23
44
 
24
45
  ### Features
25
46
 
26
- * add ListAgentSchedulesHandler to query handlers ([a29436f](https://github.com/julio-supervisor/agents-studio-be/commit/a29436f0c514a7257742ae1c7920ed7a040cd94e))
27
- * add normalization for HH:mm:ss time values in AgentScheduleTypeormMapper ([de560f6](https://github.com/julio-supervisor/agents-studio-be/commit/de560f61a2c15f98f5004a062faea8bc4edcde3c))
28
- * add test for ignoring orphaned slot values when the day is disabled ([65c699c](https://github.com/julio-supervisor/agents-studio-be/commit/65c699cf3405fae26d561563808dc87044ccaf72))
29
- * add voiceId support to agent blueprints and related services ([00897a8](https://github.com/julio-supervisor/agents-studio-be/commit/00897a8bc5d0728d763b690ee7cc3bc9e27c1645))
30
- * format listAgentScheduleExceptions method for improved readability ([f72000b](https://github.com/julio-supervisor/agents-studio-be/commit/f72000bdea34a8786035fae8c77650393d50c89f))
31
- * implement AgentInitialVersionSubscriber to create initial agent versions and update related events ([76d59aa](https://github.com/julio-supervisor/agents-studio-be/commit/76d59aaa20288fe55835c70b9de81f9f55f1a29b))
32
- * refactor listAgentScheduleExceptions method in AgentSchedulesController ([bf0494f](https://github.com/julio-supervisor/agents-studio-be/commit/bf0494f2159bcca7c7dcd875b6d20741d2c927fb))
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))
33
54
 
34
55
  ## v1.37.0
35
56
 
@@ -37,17 +58,17 @@
37
58
 
38
59
  ### Features
39
60
 
40
- * add BlueprintWorkflowClonerService and integrate it into agent version handlers ([f585285](https://github.com/julio-supervisor/agents-studio-be/commit/f585285c827760567622ca6f63b5e5ca8a19ba3f))
41
- * add tests for SDK APIs and enhance agent schedule tools ([5af2da3](https://github.com/julio-supervisor/agents-studio-be/commit/5af2da3ec0cc8acd2d6a06fb71cb5271a4348042))
42
- * add unit tests for ListAgentSchedulesHandler with pagination, sorting, and error handling ([eb142f4](https://github.com/julio-supervisor/agents-studio-be/commit/eb142f4c47925eda6e989dd5987f0ae2645e3c74))
43
- * enhance version publishing logic to prevent publishing active versions and unsupported statuses ([c332dd9](https://github.com/julio-supervisor/agents-studio-be/commit/c332dd912a4cbc5bee15836ff6676d6a48c55cc8))
44
- * implement cloning of the latest blueprint in CreateAgentVersionHandler ([33eca82](https://github.com/julio-supervisor/agents-studio-be/commit/33eca82553190d48147382b4da3befe5a7506f63))
45
- * implement listing and querying of agent schedules with pagination and sorting ([35dd513](https://github.com/julio-supervisor/agents-studio-be/commit/35dd513078a3081a4bafbc1094f0927efd44359e))
46
- * update agent schedule handler tests to include scheduleId and improve specifications ([1e9c228](https://github.com/julio-supervisor/agents-studio-be/commit/1e9c2284b7fe4d220b14d82b5dc44cd332ac7cac))
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))
47
68
 
48
69
  ### Bug Fixes
49
70
 
50
- * remove unused workspaceId from ToolConnectionsCreateTool test ([b2702c8](https://github.com/julio-supervisor/agents-studio-be/commit/b2702c8e80cab01c02e2bcb87bc90e6325f368cb))
71
+ - remove unused workspaceId from ToolConnectionsCreateTool test ([b2702c8](https://github.com/julio-supervisor/agents-studio-be/commit/b2702c8e80cab01c02e2bcb87bc90e6325f368cb))
51
72
 
52
73
  ## v1.36.1
53
74
 
@@ -55,7 +76,7 @@
55
76
 
56
77
  ### Bug Fixes
57
78
 
58
- * reorder imports and exports for consistency across modules ([23cfc68](https://github.com/julio-supervisor/agents-studio-be/commit/23cfc6823789532f6198d9f4362f808f27fc9b3a))
79
+ - reorder imports and exports for consistency across modules ([23cfc68](https://github.com/julio-supervisor/agents-studio-be/commit/23cfc6823789532f6198d9f4362f808f27fc9b3a))
59
80
 
60
81
  ## v1.36.0
61
82
 
@@ -63,8 +84,8 @@
63
84
 
64
85
  ### Features
65
86
 
66
- * add BlueprintCatalogValidationService and integrate catalog validation in agent blueprint handlers ([e611fe4](https://github.com/julio-supervisor/agents-studio-be/commit/e611fe41e075811353b4c51aea4e4651f8493d01))
67
- * add type aliases for agent and webhook requests and responses ([48224ec](https://github.com/julio-supervisor/agents-studio-be/commit/48224ec1a0617b9224ebca0ef41637e44fd8f7d2))
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))
68
89
 
69
90
  ## v1.35.0
70
91
 
@@ -72,8 +93,8 @@
72
93
 
73
94
  ### Features
74
95
 
75
- * add default language constant and update RetellBlueprintMapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
76
- * implement delete instruction functionality with command handler and controller ([af983f5](https://github.com/julio-supervisor/agents-studio-be/commit/af983f5254055d35d3972d0bcbdb12a52b48c785))
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))
77
98
 
78
99
  ## v1.34.0
79
100
 
@@ -81,10 +102,9 @@
81
102
 
82
103
  ### Features
83
104
 
84
- * 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))
85
- * implement VoiceBlueprintSyncService for Retell synchronization ([6b8f03f](https://github.com/julio-supervisor/agents-studio-be/commit/6b8f03f77ca1d2b91a9628db055e2799aa039f53))
86
- * introduce buildClientMock helper for consistent workspaceId handling in tests ([ae6eb30](https://github.com/julio-supervisor/agents-studio-be/commit/ae6eb305b16f677dea03a21bdfc8559c13cc641a))
87
-
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))
88
108
 
89
109
  ## v1.33.0
90
110
 
@@ -92,9 +112,8 @@
92
112
 
93
113
  ### Features
94
114
 
95
- * enhance agent instruction management with status and deletion tracking ([3a2c97a](https://github.com/julio-supervisor/agents-studio-be/commit/3a2c97a038a44aa236de1077f02e7eabc45cee81))
96
- * simplify payload construction by always including workspaceId in tool execution ([4992d5c](https://github.com/julio-supervisor/agents-studio-be/commit/4992d5c14cb8e8ce6efdb7345a2d7a054b48f16c))
97
-
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))
98
117
 
99
118
  ## v1.32.0
100
119
 
@@ -102,16 +121,16 @@
102
121
 
103
122
  ### Features
104
123
 
105
- * add AgentVersionsApi and related functionality ([c797b12](https://github.com/julio-supervisor/agents-studio-be/commit/c797b12e41d717cb7e0b29cc387a0fd4ff929d2e))
106
- * add API reference documentation for agent templates and update navigation structure ([103c67d](https://github.com/julio-supervisor/agents-studio-be/commit/103c67dee465cea19819a10967ea62a4aa9f9493))
107
- * add endpoint to create agent from template with request schema and response examples ([0f4b9a3](https://github.com/julio-supervisor/agents-studio-be/commit/0f4b9a327f388edb2bf6eb1d724aa4585f530359))
108
- * create migration for agent_instructions table with foreign key constraints ([f5cadbd](https://github.com/julio-supervisor/agents-studio-be/commit/f5cadbdad5601a8ffd761781284a408650f7f097))
109
- * implement reorder blueprint stages functionality with command and handler ([8d2f6c9](https://github.com/julio-supervisor/agents-studio-be/commit/8d2f6c901e03851d3960abde340ca96191ecdf89))
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))
110
129
 
111
130
  ### Bug Fixes
112
131
 
113
- * correct description formatting for UpdateAgentBlueprintRequest in API documentation ([8e0ebce](https://github.com/julio-supervisor/agents-studio-be/commit/8e0ebced952516965e3cfc8778bbdb20297810ab))
114
- * remove unused CatalogItemsCreateTool and CatalogItemsDeleteTool imports from mcp.module.ts ([d787d4e](https://github.com/julio-supervisor/agents-studio-be/commit/d787d4e707fdbab229f988de375183d3707bde12))
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))
115
134
 
116
135
  ## v1.31.0
117
136
 
@@ -119,11 +138,11 @@
119
138
 
120
139
  ### Features
121
140
 
122
- * add migration for Prospecting Agent Template with initial agent configuration and stages ([0560563](https://github.com/julio-supervisor/agents-studio-be/commit/05605631e051c7cd4705e34bc3c76c90f8373702))
141
+ - add migration for Prospecting Agent Template with initial agent configuration and stages ([0560563](https://github.com/julio-supervisor/agents-studio-be/commit/05605631e051c7cd4705e34bc3c76c90f8373702))
123
142
 
124
143
  ### Bug Fixes
125
144
 
126
- * update endpoint path for forking agents from template to use correct URL format ([9d00f93](https://github.com/julio-supervisor/agents-studio-be/commit/9d00f9350b33847a6fd582417654336769c645c3))
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))
127
146
 
128
147
  ## v1.30.0
129
148
 
@@ -131,23 +150,23 @@
131
150
 
132
151
  ### Features
133
152
 
134
- * implement catalog templates API and tools, including listing and filtering functionality ([9467fb2](https://github.com/julio-supervisor/agents-studio-be/commit/9467fb21c19a35f45e8ec8dcb2bfc26254558371))
135
- * use forwardRef for AgentBlueprintsModule import in blueprint-stages.module.ts ([63420a1](https://github.com/julio-supervisor/agents-studio-be/commit/63420a1710305fee8e22f0826665b0eedb866107))
136
- *
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
+
137
157
  ## v1.29.0
138
158
 
139
159
  ## [1.29.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.28.0...v1.29.0) (2025-11-10)
140
160
 
141
161
  ### Features
142
162
 
143
- * 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))
144
- * add ForkAgentFromTemplateRequest schema and endpoint ([394c9d7](https://github.com/julio-supervisor/agents-studio-be/commit/394c9d7ed327f0a7cccedf0e8b18218357976c15))
145
- * add unit tests for CatalogTemplateTypeormSpecificationFactory, covering various filtering and ordering scenarios ([827825b](https://github.com/julio-supervisor/agents-studio-be/commit/827825b55cf97ab21de8698025ad611abe377771))
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))
146
166
 
147
167
  ### Bug Fixes
148
168
 
149
- * 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))
150
-
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))
151
170
 
152
171
  ## v1.27.0
153
172
 
@@ -155,21 +174,20 @@
155
174
 
156
175
  ### Features
157
176
 
158
- * add migration to include 'order' column in blueprint_stages table ([79e7cd8](https://github.com/julio-supervisor/agents-studio-be/commit/79e7cd80a046f6049abd8df5fec1333de7dc2851))
159
- * add order property to blueprint stages and update related logic ([b7dc672](https://github.com/julio-supervisor/agents-studio-be/commit/b7dc6727e8543f39d665b1e904bc08449ccb386d))
160
- * add orderByOrderAsc method and related tests for blueprint stages ([ab46a4f](https://github.com/julio-supervisor/agents-studio-be/commit/ab46a4f4b6ff50409e0f878228579dad152b147f))
161
- * add startSpeaker property to agent blueprints and related components ([b1ea8ef](https://github.com/julio-supervisor/agents-studio-be/commit/b1ea8ef76d200484f40cee10ec7c0a6159ff9032))
162
- * add tests for BlueprintStageTriggerCondition and enhance validation for rule type values ([42cde2a](https://github.com/julio-supervisor/agents-studio-be/commit/42cde2a5e5e2b49df2cf9f51097dbca2b914bde7))
163
- * add versioning details to AgentBlueprint and AgentVersion in tests ([d655d88](https://github.com/julio-supervisor/agents-studio-be/commit/d655d8836fd17d4bdeaf919f74c2fd72f87c3ea1))
164
- * enhance stage result handling with agentId context and normalize stage order input ([8238b5d](https://github.com/julio-supervisor/agents-studio-be/commit/8238b5da1993d89a1def73d2821b3fc46ffabea2))
165
- * enhance toStageTriggerResult mapping to include blueprintId and improve header normalization in PublicApiToolBase ([27298c8](https://github.com/julio-supervisor/agents-studio-be/commit/27298c8bc040190a97996cacfbad36a6aa919d9d))
166
- * enhance toStageTriggerResult to accept blueprintId from context and update related methods ([f6f8598](https://github.com/julio-supervisor/agents-studio-be/commit/f6f8598e41ca7ff559b192cef3ccd86a28377dda))
167
- * include blueprint in payload mapping for voice blueprint sync ([ce3ebd1](https://github.com/julio-supervisor/agents-studio-be/commit/ce3ebd11ec57e81ab49626b6996ac55e4a4fc3f0))
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))
168
187
 
169
188
  ### Bug Fixes
170
189
 
171
- * remove tsconfig-paths/register from Docker entrypoint and CMD ([054ceeb](https://github.com/julio-supervisor/agents-studio-be/commit/054ceeb8ad53f6b4bfce38fa0effe00128e2c77e))
172
-
190
+ - remove tsconfig-paths/register from Docker entrypoint and CMD ([054ceeb](https://github.com/julio-supervisor/agents-studio-be/commit/054ceeb8ad53f6b4bfce38fa0effe00128e2c77e))
173
191
 
174
192
  ## v1.26.0
175
193
 
@@ -177,8 +195,7 @@
177
195
 
178
196
  ### Features
179
197
 
180
- * enhance agent stages API to include blueprintId in all relevant methods ([0de45da](https://github.com/julio-supervisor/agents-studio-be/commit/0de45da137e1fa4d79bc5aabe86d068dbe8465e1))
181
-
198
+ - enhance agent stages API to include blueprintId in all relevant methods ([0de45da](https://github.com/julio-supervisor/agents-studio-be/commit/0de45da137e1fa4d79bc5aabe86d068dbe8465e1))
182
199
 
183
200
  ## v1.25.0
184
201
 
@@ -186,11 +203,10 @@
186
203
 
187
204
  ### Features
188
205
 
189
- * enhance blueprint stage functionality with goalPrompt and promptInstructions attributes ([9d13681](https://github.com/julio-supervisor/agents-studio-be/commit/9d13681346f9ea48f5dd6b9c16ab90c95a81356d))
190
- * implement blueprint stages and triggers ([b94e0d9](https://github.com/julio-supervisor/agents-studio-be/commit/b94e0d9723bf6406a9163d3d9dc998ada06be10a))
191
- * refactor agent creation and blueprint building for improved test clarity and functionality ([136d5b1](https://github.com/julio-supervisor/agents-studio-be/commit/136d5b12a725d65e6d2fd77e224cc6615e3707d1))
192
- * update blueprint stage to use goalPrompt and promptInstructions ([0e7bf89](https://github.com/julio-supervisor/agents-studio-be/commit/0e7bf89ed94853ad856c155e0f71e1ba1dafea84))
193
-
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))
194
210
 
195
211
  ## v1.24.0
196
212
 
@@ -198,15 +214,16 @@
198
214
 
199
215
  ### Features
200
216
 
201
- * add optional avatarUrl and debounceDelayMs to agent schema ([b909f45](https://github.com/julio-supervisor/agents-studio-be/commit/b909f457ef82df455e77ae8ec772a4ff1de3b763))
202
- *
217
+ - add optional avatarUrl and debounceDelayMs to agent schema ([b909f45](https://github.com/julio-supervisor/agents-studio-be/commit/b909f457ef82df455e77ae8ec772a4ff1de3b763))
218
+ -
219
+
203
220
  ## v1.23.0
204
221
 
205
222
  ## [1.23.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.22.2...v1.23.0) (2025-11-05)
206
223
 
207
224
  ### Features
208
225
 
209
- * implement Agent Stages and Triggers API ([c0b997f](https://github.com/julio-supervisor/agents-studio-be/commit/c0b997fd233f8cb1fb4fc2f43b36344e46675191))
226
+ - implement Agent Stages and Triggers API ([c0b997f](https://github.com/julio-supervisor/agents-studio-be/commit/c0b997fd233f8cb1fb4fc2f43b36344e46675191))
210
227
 
211
228
  ## v1.22.2
212
229
 
@@ -214,8 +231,7 @@
214
231
 
215
232
  ### Bug Fixes
216
233
 
217
- * update API base URL to production endpoint across multiple files ([7491ce7](https://github.com/julio-supervisor/agents-studio-be/commit/7491ce700f348682d6559a5f3e9cf93f4aa9bc70))
218
-
234
+ - update API base URL to production endpoint across multiple files ([7491ce7](https://github.com/julio-supervisor/agents-studio-be/commit/7491ce700f348682d6559a5f3e9cf93f4aa9bc70))
219
235
 
220
236
  ## v1.22.1
221
237
 
@@ -223,7 +239,7 @@
223
239
 
224
240
  ### Bug Fixes
225
241
 
226
- * update docker-compose context for public-api service ([1f1cfaf](https://github.com/julio-supervisor/agents-studio-be/commit/1f1cfafa50e9f499ea44e8552fd71f2ddcf97ac9))
242
+ - update docker-compose context for public-api service ([1f1cfaf](https://github.com/julio-supervisor/agents-studio-be/commit/1f1cfafa50e9f499ea44e8552fd71f2ddcf97ac9))
227
243
 
228
244
  ## v1.22.0
229
245
 
@@ -231,8 +247,8 @@
231
247
 
232
248
  ### Features
233
249
 
234
- * add integration guide for AG-UI in NestJS monolithic applications ([f8944d0](https://github.com/julio-supervisor/agents-studio-be/commit/f8944d0686515dee17d20e0e3ad29e25b3d7bd8f))
235
- * integrate schedule call functionality and update related prompts and templates ([8fffd67](https://github.com/julio-supervisor/agents-studio-be/commit/8fffd67b6a4f1abfc8bbd9735034a7d905159afd))
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))
236
252
 
237
253
  ## v1.21.0
238
254
 
@@ -240,21 +256,20 @@
240
256
 
241
257
  ### Features
242
258
 
243
- * add callerApiKey to ScheduleCall interfaces and update related logic ([6c92042](https://github.com/julio-supervisor/agents-studio-be/commit/6c920426ec45bd21ec8e4ae79f5bb96705681434))
244
- * add quick code review checklist and enhance agent schedules documentation ([877d196](https://github.com/julio-supervisor/agents-studio-be/commit/877d196461470434e08781b1edcae9689f25339c))
245
- * add schedule call tool integration and usage guidance ([9bcb5dd](https://github.com/julio-supervisor/agents-studio-be/commit/9bcb5dd1d3206de5191f0e1c535600a4fed9d8ba))
246
- * add Step Functions configuration for scheduling calls in dev and prod environments ([3b787d6](https://github.com/julio-supervisor/agents-studio-be/commit/3b787d6251882dab6e0fc820d2a3789950db58a2))
247
- * integrate agent availability checks in voice call execution tools ([f8401d8](https://github.com/julio-supervisor/agents-studio-be/commit/f8401d8a5ea3a835a6ee1bb0001e0fb8eab3f4be))
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))
248
264
 
249
265
  ### Bug Fixes
250
266
 
251
- * enhance IAM role policy to allow additional CloudWatch log actions ([4503712](https://github.com/julio-supervisor/agents-studio-be/commit/4503712ee8799c54ec733d5c861148f2633e3f95))
252
- * remove unnecessary Sid from IAM role policy for Step Functions logging ([dad9e96](https://github.com/julio-supervisor/agents-studio-be/commit/dad9e9602bffa09193bae95f56ba8f8db0e69349))
253
- * standardize formatting in IAM role policy for CloudWatch log actions ([85fb9b0](https://github.com/julio-supervisor/agents-studio-be/commit/85fb9b0166b7c0831e41be89d9c8fbb190b150bc))
254
- * update comments and standardize variable names in Step Functions configuration ([7d25b37](https://github.com/julio-supervisor/agents-studio-be/commit/7d25b3754309cf50055aba451d29977cf9f778be))
255
- * update log_destination format in Step Functions logging configuration ([1830502](https://github.com/julio-supervisor/agents-studio-be/commit/18305027a64b2e82780dcb3d21c8ca622bdc6452))
256
- * update logging configuration in Step Functions to use log_destination ([7eb4243](https://github.com/julio-supervisor/agents-studio-be/commit/7eb4243710e70d516d398d227e6a41795d1eccb3))
257
-
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))
258
273
 
259
274
  ## v1.20.0
260
275
 
@@ -401,4 +416,3 @@ Sin cambios en el SDK JS.
401
416
  ### Features
402
417
 
403
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)).
404
-
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
@@ -74,6 +82,16 @@ await client.tools.uploadResource(tools.data[0].identifier, formData);
74
82
  // eliminar un agente
75
83
  await client.agents.delete(agent.agentId);
76
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
+
77
95
  // campañas masivas desde CSV
78
96
  const campaign = await client.campaigns.create(agent.agentId, versionId, {
79
97
  name: 'Holiday follow-up',
@@ -397,6 +415,8 @@ createClient({
397
415
 
398
416
  Puedes fijar el workspace al crear el cliente, actualizarlo en caliente o delegar en una función:
399
417
 
418
+ > Nota: los recursos _scoped por workspace_ (por ejemplo `client.agents.*`) requieren un workspace seleccionado. Si `client.workspace.get()` retorna `undefined`, el SDK lanzará un error antes de hacer la request.
419
+
400
420
  ```ts
401
421
  const client = createClient({
402
422
  baseUrl,