vellum-ai 0.8.9 → 0.8.10

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 (42) hide show
  1. package/.mock/definition/__package__.yml +5657 -0
  2. package/.mock/definition/adHoc.yml +40 -0
  3. package/.mock/definition/api.yml +17 -0
  4. package/.mock/definition/deployments.yml +261 -0
  5. package/.mock/definition/documentIndexes.yml +429 -0
  6. package/.mock/definition/documents.yml +261 -0
  7. package/.mock/definition/folderEntities.yml +41 -0
  8. package/.mock/definition/sandboxes.yml +194 -0
  9. package/.mock/definition/testSuiteRuns.yml +148 -0
  10. package/.mock/definition/testSuites.yml +153 -0
  11. package/.mock/definition/workflowDeployments.yml +181 -0
  12. package/.mock/definition/workflowSandboxes.yml +85 -0
  13. package/.mock/fern.config.json +4 -0
  14. package/.mock/openapi/openapi.yml +10092 -0
  15. package/Client.js +9 -9
  16. package/api/client/requests/GenerateStreamBodyRequest.d.ts +4 -1
  17. package/api/resources/adHoc/client/Client.js +1 -1
  18. package/api/resources/adHoc/client/requests/AdHocExecutePromptStreamRequest.d.ts +3 -1
  19. package/api/resources/deployments/client/Client.js +5 -5
  20. package/api/resources/documentIndexes/client/Client.js +8 -8
  21. package/api/resources/documents/client/Client.js +5 -5
  22. package/api/resources/folderEntities/client/Client.js +1 -1
  23. package/api/resources/sandboxes/client/Client.js +3 -3
  24. package/api/resources/testSuiteRuns/client/Client.js +3 -3
  25. package/api/resources/testSuites/client/Client.js +4 -4
  26. package/api/resources/workflowDeployments/client/Client.js +4 -4
  27. package/api/resources/workflowSandboxes/client/Client.js +1 -1
  28. package/dist/Client.js +9 -9
  29. package/dist/api/client/requests/GenerateStreamBodyRequest.d.ts +4 -1
  30. package/dist/api/resources/adHoc/client/Client.js +1 -1
  31. package/dist/api/resources/adHoc/client/requests/AdHocExecutePromptStreamRequest.d.ts +3 -1
  32. package/dist/api/resources/deployments/client/Client.js +5 -5
  33. package/dist/api/resources/documentIndexes/client/Client.js +8 -8
  34. package/dist/api/resources/documents/client/Client.js +5 -5
  35. package/dist/api/resources/folderEntities/client/Client.js +1 -1
  36. package/dist/api/resources/sandboxes/client/Client.js +3 -3
  37. package/dist/api/resources/testSuiteRuns/client/Client.js +3 -3
  38. package/dist/api/resources/testSuites/client/Client.js +4 -4
  39. package/dist/api/resources/workflowDeployments/client/Client.js +4 -4
  40. package/dist/api/resources/workflowSandboxes/client/Client.js +1 -1
  41. package/package.json +1 -1
  42. package/reference.md +17 -3
@@ -0,0 +1,41 @@
1
+ service:
2
+ auth: false
3
+ base-path: ''
4
+ endpoints:
5
+ add_entity_to_folder:
6
+ path: /v1/folders/{folder_id}/add-entity
7
+ method: POST
8
+ auth: true
9
+ docs: >-
10
+ Add an entity to a specific folder or root directory.
11
+
12
+
13
+ Adding an entity to a folder will remove it from any other folders it
14
+ might have been a member of.
15
+ path-parameters:
16
+ folder_id:
17
+ type: string
18
+ docs: >-
19
+ The ID of the folder to which the entity should be added. This can
20
+ be a UUID of a folder, or the name of a root directory (e.g.
21
+ "PROMPT_SANDBOX").
22
+ request:
23
+ name: AddEntityToFolderRequest
24
+ body:
25
+ properties:
26
+ entity_id:
27
+ type: string
28
+ docs: The ID of the entity you would like to move.
29
+ validation:
30
+ format: uuid
31
+ url: Default
32
+ availability: pre-release
33
+ examples:
34
+ - path-parameters:
35
+ folder_id: folder_id
36
+ request:
37
+ entity_id: entity_id
38
+ audiences:
39
+ - customers
40
+ source:
41
+ openapi: openapi/openapi.yml
@@ -0,0 +1,194 @@
1
+ imports:
2
+ root: __package__.yml
3
+ service:
4
+ auth: false
5
+ base-path: ''
6
+ endpoints:
7
+ deploy_prompt:
8
+ path: /v1/sandboxes/{id}/prompts/{prompt_variant_id}/deploy
9
+ method: POST
10
+ auth: true
11
+ path-parameters:
12
+ id:
13
+ type: string
14
+ docs: A UUID string identifying this sandbox.
15
+ prompt_variant_id:
16
+ type: string
17
+ docs: An ID identifying the Prompt you'd like to deploy.
18
+ request:
19
+ name: DeploySandboxPromptRequest
20
+ body:
21
+ properties:
22
+ prompt_deployment_id:
23
+ type: optional<string>
24
+ docs: >-
25
+ The Vellum-generated ID of the Prompt Deployment you'd like to
26
+ update. Cannot specify both this and prompt_deployment_name.
27
+ Leave null to create a new Prompt Deployment.
28
+ validation:
29
+ format: uuid
30
+ prompt_deployment_name:
31
+ type: optional<string>
32
+ docs: >-
33
+ The unique name of the Prompt Deployment you'd like to either
34
+ create or update. Cannot specify both this and
35
+ prompt_deployment_id. If provided and matches an existing Prompt
36
+ Deployment, that Prompt Deployment will be updated. Otherwise, a
37
+ new Prompt Deployment will be created.
38
+ validation:
39
+ minLength: 1
40
+ label:
41
+ type: optional<string>
42
+ docs: >-
43
+ In the event that a new Prompt Deployment is created, this will
44
+ be the label it's given.
45
+ validation:
46
+ minLength: 1
47
+ release_tags:
48
+ type: optional<list<string>>
49
+ docs: >-
50
+ Optionally provide the release tags that you'd like to be
51
+ associated with the latest release of the created/updated Prompt
52
+ Deployment.
53
+ response:
54
+ docs: ''
55
+ type: root.DeploymentRead
56
+ url: Default
57
+ availability: pre-release
58
+ examples:
59
+ - path-parameters:
60
+ id: id
61
+ prompt_variant_id: prompt_variant_id
62
+ request: {}
63
+ response:
64
+ body:
65
+ id: id
66
+ created: '2024-01-15T09:30:00Z'
67
+ label: label
68
+ name: name
69
+ status: ACTIVE
70
+ environment: DEVELOPMENT
71
+ last_deployed_on: '2024-01-15T09:30:00Z'
72
+ input_variables:
73
+ - id: id
74
+ key: key
75
+ type: STRING
76
+ description: description
77
+ active_model_version_ids:
78
+ - active_model_version_ids
79
+ last_deployed_history_item_id: last_deployed_history_item_id
80
+ audiences:
81
+ - customers
82
+ upsert_sandbox_scenario:
83
+ path: /v1/sandboxes/{id}/scenarios
84
+ method: POST
85
+ auth: true
86
+ docs: >-
87
+ Upserts a new scenario for a sandbox, keying off of the optionally
88
+ provided scenario id.
89
+
90
+
91
+ If an id is provided and has a match, the scenario will be updated. If
92
+ no id is provided or no match
93
+
94
+ is found, a new scenario will be appended to the end.
95
+
96
+
97
+ Note that a full replacement of the scenario is performed, so any fields
98
+ not provided will be removed
99
+
100
+ or overwritten with default values.
101
+ path-parameters:
102
+ id:
103
+ type: string
104
+ docs: A UUID string identifying this sandbox.
105
+ request:
106
+ name: UpsertSandboxScenarioRequest
107
+ body:
108
+ properties:
109
+ label:
110
+ type: optional<string>
111
+ default: Untitled Scenario
112
+ inputs:
113
+ docs: The inputs for the scenario
114
+ type: list<root.NamedScenarioInputRequest>
115
+ scenario_id:
116
+ type: optional<string>
117
+ docs: >-
118
+ The id of the scenario to update. If none is provided, an id
119
+ will be generated and a new scenario will be appended.
120
+ validation:
121
+ minLength: 1
122
+ response:
123
+ docs: ''
124
+ type: root.SandboxScenario
125
+ url: Default
126
+ availability: pre-release
127
+ examples:
128
+ - name: Basic Example
129
+ path-parameters:
130
+ id: id
131
+ request:
132
+ label: Scenario 1
133
+ inputs:
134
+ - type: STRING
135
+ value: Hello, world!
136
+ name: var_1
137
+ - type: STRING
138
+ value: Why hello, there!
139
+ name: var_2
140
+ response:
141
+ body:
142
+ label: label
143
+ inputs:
144
+ - type: STRING
145
+ value: value
146
+ input_variable_id: input_variable_id
147
+ id: id
148
+ - name: Chat History Example
149
+ path-parameters:
150
+ id: id
151
+ request:
152
+ label: Scenario 2
153
+ inputs:
154
+ - type: CHAT_HISTORY
155
+ value:
156
+ - text: What's your favorite color?
157
+ role: USER
158
+ - text: AI's don't have a favorite color.... Yet.
159
+ role: ASSISTANT
160
+ name: chat_history
161
+ response:
162
+ body:
163
+ label: label
164
+ inputs:
165
+ - type: STRING
166
+ value: value
167
+ input_variable_id: input_variable_id
168
+ id: id
169
+ audiences:
170
+ - customers
171
+ delete_sandbox_scenario:
172
+ path: /v1/sandboxes/{id}/scenarios/{scenario_id}
173
+ method: DELETE
174
+ auth: true
175
+ docs: >-
176
+ Deletes an existing scenario from a sandbox, keying off of the provided
177
+ scenario id.
178
+ path-parameters:
179
+ id:
180
+ type: string
181
+ docs: A UUID string identifying this sandbox.
182
+ scenario_id:
183
+ type: string
184
+ docs: An id identifying the scenario that you'd like to delete
185
+ url: Default
186
+ availability: pre-release
187
+ examples:
188
+ - path-parameters:
189
+ id: id
190
+ scenario_id: scenario_id
191
+ audiences:
192
+ - customers
193
+ source:
194
+ openapi: openapi/openapi.yml
@@ -0,0 +1,148 @@
1
+ imports:
2
+ root: __package__.yml
3
+ service:
4
+ auth: false
5
+ base-path: ''
6
+ endpoints:
7
+ create:
8
+ path: /v1/test-suite-runs
9
+ method: POST
10
+ auth: true
11
+ docs: Trigger a Test Suite and create a new Test Suite Run
12
+ request:
13
+ name: TestSuiteRunCreateRequest
14
+ body:
15
+ properties:
16
+ test_suite_id:
17
+ type: string
18
+ docs: The ID of the Test Suite to run
19
+ validation:
20
+ format: uuid
21
+ exec_config:
22
+ type: root.TestSuiteRunExecConfigRequest
23
+ docs: Configuration that defines how the Test Suite should be run
24
+ response:
25
+ docs: ''
26
+ type: root.TestSuiteRunRead
27
+ url: Default
28
+ availability: pre-release
29
+ examples:
30
+ - request:
31
+ test_suite_id: test_suite_id
32
+ exec_config:
33
+ type: DEPLOYMENT_RELEASE_TAG
34
+ data:
35
+ deployment_id: deployment_id
36
+ response:
37
+ body:
38
+ id: id
39
+ created: '2024-01-15T09:30:00Z'
40
+ test_suite:
41
+ id: id
42
+ history_item_id: history_item_id
43
+ label: label
44
+ state: QUEUED
45
+ exec_config:
46
+ type: DEPLOYMENT_RELEASE_TAG
47
+ data:
48
+ deployment_id: deployment_id
49
+ tag: tag
50
+ test_case_ids:
51
+ - test_case_ids
52
+ audiences:
53
+ - customers
54
+ retrieve:
55
+ path: /v1/test-suite-runs/{id}
56
+ method: GET
57
+ auth: true
58
+ docs: Retrieve a specific Test Suite Run by ID
59
+ path-parameters:
60
+ id:
61
+ type: string
62
+ docs: A UUID string identifying this test suite run.
63
+ response:
64
+ docs: ''
65
+ type: root.TestSuiteRunRead
66
+ url: Default
67
+ availability: pre-release
68
+ examples:
69
+ - path-parameters:
70
+ id: id
71
+ response:
72
+ body:
73
+ id: id
74
+ created: '2024-01-15T09:30:00Z'
75
+ test_suite:
76
+ id: id
77
+ history_item_id: history_item_id
78
+ label: label
79
+ state: QUEUED
80
+ exec_config:
81
+ type: DEPLOYMENT_RELEASE_TAG
82
+ data:
83
+ deployment_id: deployment_id
84
+ tag: tag
85
+ test_case_ids:
86
+ - test_case_ids
87
+ audiences:
88
+ - customers
89
+ listExecutions:
90
+ path: /v1/test-suite-runs/{id}/executions
91
+ method: GET
92
+ auth: true
93
+ path-parameters:
94
+ id:
95
+ type: string
96
+ docs: A UUID string identifying this test suite run.
97
+ request:
98
+ name: TestSuiteRunsListExecutionsRequest
99
+ query-parameters:
100
+ expand:
101
+ type: optional<string>
102
+ allow-multiple: true
103
+ docs: >-
104
+ The response fields to expand for more information.
105
+
106
+ - 'results.metric_results.metric_label' expands the metric label
107
+ for each metric result.
108
+
109
+ - 'results.metric_results.metric_definition' expands the metric
110
+ definition for each metric result.
111
+
112
+ - 'results.metric_results.metric_definition.name' expands the
113
+ metric definition name for each metric result.
114
+ limit:
115
+ type: optional<integer>
116
+ docs: Number of results to return per page.
117
+ offset:
118
+ type: optional<integer>
119
+ docs: The initial index from which to return the results.
120
+ response:
121
+ docs: ''
122
+ type: root.PaginatedTestSuiteRunExecutionList
123
+ url: Default
124
+ availability: pre-release
125
+ examples:
126
+ - path-parameters:
127
+ id: id
128
+ response:
129
+ body:
130
+ count: 123
131
+ next: http://api.example.org/accounts/?offset=400&limit=100
132
+ previous: http://api.example.org/accounts/?offset=200&limit=100
133
+ results:
134
+ - id: id
135
+ test_case_id: test_case_id
136
+ outputs:
137
+ - name: name
138
+ type: STRING
139
+ output_variable_id: output_variable_id
140
+ metric_results:
141
+ - metric_id: metric_id
142
+ outputs:
143
+ - type: STRING
144
+ name: name
145
+ audiences:
146
+ - customers
147
+ source:
148
+ openapi: openapi/openapi.yml
@@ -0,0 +1,153 @@
1
+ imports:
2
+ root: __package__.yml
3
+ service:
4
+ auth: false
5
+ base-path: ''
6
+ endpoints:
7
+ list_test_suite_test_cases:
8
+ path: /v1/test-suites/{id}/test-cases
9
+ method: GET
10
+ auth: true
11
+ docs: List the Test Cases associated with a Test Suite
12
+ path-parameters:
13
+ id:
14
+ type: string
15
+ docs: A UUID string identifying this test suite.
16
+ request:
17
+ name: ListTestSuiteTestCasesRequest
18
+ query-parameters:
19
+ limit:
20
+ type: optional<integer>
21
+ docs: Number of results to return per page.
22
+ offset:
23
+ type: optional<integer>
24
+ docs: The initial index from which to return the results.
25
+ response:
26
+ docs: ''
27
+ type: root.PaginatedTestSuiteTestCaseList
28
+ url: Default
29
+ availability: pre-release
30
+ examples:
31
+ - path-parameters:
32
+ id: id
33
+ response:
34
+ body:
35
+ count: 123
36
+ next: http://api.example.org/accounts/?offset=400&limit=100
37
+ previous: http://api.example.org/accounts/?offset=200&limit=100
38
+ results:
39
+ - id: id
40
+ external_id: external_id
41
+ label: label
42
+ input_values:
43
+ - variable_id: variable_id
44
+ name: name
45
+ type: STRING
46
+ evaluation_values:
47
+ - variable_id: variable_id
48
+ name: name
49
+ type: STRING
50
+ audiences:
51
+ - customers
52
+ upsert_test_suite_test_case:
53
+ path: /v1/test-suites/{id}/test-cases
54
+ method: POST
55
+ auth: true
56
+ docs: >-
57
+ Upserts a new test case for a test suite, keying off of the optionally
58
+ provided test case id.
59
+
60
+
61
+ If an id is provided and has a match, the test case will be updated. If
62
+ no id is provided or no match
63
+
64
+ is found, a new test case will be appended to the end.
65
+
66
+
67
+ Note that a full replacement of the test case is performed, so any
68
+ fields not provided will be removed
69
+
70
+ or overwritten with default values.
71
+ path-parameters:
72
+ id:
73
+ type: string
74
+ docs: A UUID string identifying this test suite.
75
+ request:
76
+ body: root.UpsertTestSuiteTestCaseRequest
77
+ response:
78
+ docs: ''
79
+ type: root.TestSuiteTestCase
80
+ url: Default
81
+ availability: pre-release
82
+ examples:
83
+ - path-parameters:
84
+ id: id
85
+ request:
86
+ input_values:
87
+ - type: STRING
88
+ name: name
89
+ evaluation_values:
90
+ - type: STRING
91
+ name: name
92
+ response:
93
+ body:
94
+ id: id
95
+ external_id: external_id
96
+ label: label
97
+ input_values:
98
+ - variable_id: variable_id
99
+ name: name
100
+ type: STRING
101
+ value: value
102
+ evaluation_values:
103
+ - variable_id: variable_id
104
+ name: name
105
+ type: STRING
106
+ value: value
107
+ audiences:
108
+ - customers
109
+ test_suite_test_cases_bulk:
110
+ path: /v1/test-suites/{id}/test-cases-bulk
111
+ method: POST
112
+ auth: true
113
+ docs: >-
114
+ Created, replace, and delete Test Cases within the specified Test Suite
115
+ in bulk
116
+ path-parameters:
117
+ id:
118
+ type: string
119
+ docs: A UUID string identifying this test suite.
120
+ request:
121
+ body: list<root.TestSuiteTestCaseBulkOperationRequest>
122
+ response-stream:
123
+ docs: ''
124
+ type: list<root.TestSuiteTestCaseBulkResult>
125
+ format: json
126
+ url: Default
127
+ availability: pre-release
128
+ audiences:
129
+ - customers
130
+ delete_test_suite_test_case:
131
+ path: /v1/test-suites/{id}/test-cases/{test_case_id}
132
+ method: DELETE
133
+ auth: true
134
+ docs: >
135
+ Deletes an existing test case for a test suite, keying off of the test
136
+ case id.
137
+ path-parameters:
138
+ id:
139
+ type: string
140
+ docs: A UUID string identifying this test suite.
141
+ test_case_id:
142
+ type: string
143
+ docs: An id identifying the test case that you'd like to delete
144
+ url: Default
145
+ availability: pre-release
146
+ examples:
147
+ - path-parameters:
148
+ id: id
149
+ test_case_id: test_case_id
150
+ audiences:
151
+ - customers
152
+ source:
153
+ openapi: openapi/openapi.yml