vellum-ai 1.5.4__py3-none-any.whl → 1.5.6__py3-none-any.whl

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 (66) hide show
  1. vellum/__init__.py +36 -0
  2. vellum/client/__init__.py +6 -0
  3. vellum/client/core/client_wrapper.py +2 -2
  4. vellum/client/reference.md +497 -11
  5. vellum/client/resources/__init__.py +4 -0
  6. vellum/client/resources/integration_auth_configs/__init__.py +4 -0
  7. vellum/client/resources/integration_auth_configs/client.py +186 -0
  8. vellum/client/resources/integration_auth_configs/raw_client.py +171 -0
  9. vellum/client/resources/integration_providers/__init__.py +4 -0
  10. vellum/client/resources/integration_providers/client.py +279 -0
  11. vellum/client/resources/integration_providers/raw_client.py +255 -0
  12. vellum/client/resources/integrations/client.py +226 -28
  13. vellum/client/resources/integrations/raw_client.py +257 -20
  14. vellum/client/resources/test_suite_runs/client.py +6 -6
  15. vellum/client/resources/test_suite_runs/raw_client.py +6 -6
  16. vellum/client/types/__init__.py +32 -0
  17. vellum/client/types/components_schemas_composio_integration_exec_config.py +5 -0
  18. vellum/client/types/components_schemas_slim_composio_tool_definition.py +5 -0
  19. vellum/client/types/composio_integration_exec_config.py +20 -0
  20. vellum/client/types/composio_tool_definition.py +4 -1
  21. vellum/client/types/integration_auth_config_integration.py +23 -0
  22. vellum/client/types/integration_auth_config_integration_credential.py +19 -0
  23. vellum/client/types/integration_credential_access_type.py +5 -0
  24. vellum/client/types/integration_name.py +20 -0
  25. vellum/client/types/integration_provider.py +5 -0
  26. vellum/client/types/integration_read.py +30 -0
  27. vellum/client/types/paginated_slim_integration_auth_config_read_list.py +23 -0
  28. vellum/client/types/paginated_slim_integration_read_list.py +23 -0
  29. vellum/client/types/paginated_slim_tool_definition_list.py +23 -0
  30. vellum/client/types/slim_composio_tool_definition.py +23 -0
  31. vellum/client/types/slim_integration_auth_config_read.py +29 -0
  32. vellum/client/types/slim_integration_read.py +25 -0
  33. vellum/client/types/tool_definition_integration.py +23 -0
  34. vellum/resources/integration_auth_configs/__init__.py +3 -0
  35. vellum/resources/integration_auth_configs/client.py +3 -0
  36. vellum/resources/integration_auth_configs/raw_client.py +3 -0
  37. vellum/resources/integration_providers/__init__.py +3 -0
  38. vellum/resources/integration_providers/client.py +3 -0
  39. vellum/resources/integration_providers/raw_client.py +3 -0
  40. vellum/types/components_schemas_composio_integration_exec_config.py +3 -0
  41. vellum/types/components_schemas_slim_composio_tool_definition.py +3 -0
  42. vellum/types/composio_integration_exec_config.py +3 -0
  43. vellum/types/integration_auth_config_integration.py +3 -0
  44. vellum/types/integration_auth_config_integration_credential.py +3 -0
  45. vellum/types/integration_credential_access_type.py +3 -0
  46. vellum/types/integration_name.py +3 -0
  47. vellum/types/integration_provider.py +3 -0
  48. vellum/types/integration_read.py +3 -0
  49. vellum/types/paginated_slim_integration_auth_config_read_list.py +3 -0
  50. vellum/types/paginated_slim_integration_read_list.py +3 -0
  51. vellum/types/paginated_slim_tool_definition_list.py +3 -0
  52. vellum/types/slim_composio_tool_definition.py +3 -0
  53. vellum/types/slim_integration_auth_config_read.py +3 -0
  54. vellum/types/slim_integration_read.py +3 -0
  55. vellum/types/tool_definition_integration.py +3 -0
  56. vellum/workflows/integrations/tests/test_vellum_integration_service.py +26 -19
  57. vellum/workflows/integrations/vellum_integration_service.py +5 -5
  58. vellum/workflows/nodes/displayable/tool_calling_node/node.py +2 -4
  59. vellum/workflows/types/definition.py +1 -1
  60. vellum/workflows/types/tests/test_definition.py +40 -2
  61. {vellum_ai-1.5.4.dist-info → vellum_ai-1.5.6.dist-info}/METADATA +1 -1
  62. {vellum_ai-1.5.4.dist-info → vellum_ai-1.5.6.dist-info}/RECORD +66 -21
  63. vellum_ee/workflows/display/tests/workflow_serialization/test_basic_tool_calling_node_vellum_integration_serialization.py +68 -0
  64. {vellum_ai-1.5.4.dist-info → vellum_ai-1.5.6.dist-info}/LICENSE +0 -0
  65. {vellum_ai-1.5.4.dist-info → vellum_ai-1.5.6.dist-info}/WHEEL +0 -0
  66. {vellum_ai-1.5.4.dist-info → vellum_ai-1.5.6.dist-info}/entry_points.txt +0 -0
@@ -1286,8 +1286,8 @@ client = Vellum(
1286
1286
  api_key="YOUR_API_KEY",
1287
1287
  )
1288
1288
  client.integrations.retrieve_integration_tool_definition(
1289
- integration="integration",
1290
- provider="provider",
1289
+ integration_name="integration_name",
1290
+ integration_provider="integration_provider",
1291
1291
  tool_name="tool_name",
1292
1292
  )
1293
1293
 
@@ -1305,7 +1305,7 @@ client.integrations.retrieve_integration_tool_definition(
1305
1305
  <dl>
1306
1306
  <dd>
1307
1307
 
1308
- **integration:** `str` — The integration name
1308
+ **integration_name:** `str` — The integration name
1309
1309
 
1310
1310
  </dd>
1311
1311
  </dl>
@@ -1313,7 +1313,7 @@ client.integrations.retrieve_integration_tool_definition(
1313
1313
  <dl>
1314
1314
  <dd>
1315
1315
 
1316
- **provider:** `str` — The integration provider name
1316
+ **integration_provider:** `str` — The integration provider name
1317
1317
 
1318
1318
  </dd>
1319
1319
  </dl>
@@ -1361,8 +1361,8 @@ client = Vellum(
1361
1361
  api_key="YOUR_API_KEY",
1362
1362
  )
1363
1363
  client.integrations.execute_integration_tool(
1364
- integration="integration",
1365
- provider="provider",
1364
+ integration_name="integration_name",
1365
+ integration_provider="integration_provider",
1366
1366
  tool_name="tool_name",
1367
1367
  arguments={"arguments": {"key": "value"}},
1368
1368
  )
@@ -1381,7 +1381,7 @@ client.integrations.execute_integration_tool(
1381
1381
  <dl>
1382
1382
  <dd>
1383
1383
 
1384
- **integration:** `str` — The integration name
1384
+ **integration_name:** `str` — The integration name
1385
1385
 
1386
1386
  </dd>
1387
1387
  </dl>
@@ -1389,7 +1389,7 @@ client.integrations.execute_integration_tool(
1389
1389
  <dl>
1390
1390
  <dd>
1391
1391
 
1392
- **provider:** `str` — The integration provider name
1392
+ **integration_provider:** `str` — The integration provider name
1393
1393
 
1394
1394
  </dd>
1395
1395
  </dl>
@@ -1421,6 +1421,178 @@ client.integrations.execute_integration_tool(
1421
1421
  </dl>
1422
1422
 
1423
1423
 
1424
+ </dd>
1425
+ </dl>
1426
+ </details>
1427
+
1428
+ <details><summary><code>client.integrations.<a href="src/vellum/resources/integrations/client.py">list</a>(...)</code></summary>
1429
+ <dl>
1430
+ <dd>
1431
+
1432
+ #### 📝 Description
1433
+
1434
+ <dl>
1435
+ <dd>
1436
+
1437
+ <dl>
1438
+ <dd>
1439
+
1440
+ List all integrations
1441
+ </dd>
1442
+ </dl>
1443
+ </dd>
1444
+ </dl>
1445
+
1446
+ #### 🔌 Usage
1447
+
1448
+ <dl>
1449
+ <dd>
1450
+
1451
+ <dl>
1452
+ <dd>
1453
+
1454
+ ```python
1455
+ from vellum import Vellum
1456
+
1457
+ client = Vellum(
1458
+ api_version="YOUR_API_VERSION",
1459
+ api_key="YOUR_API_KEY",
1460
+ )
1461
+ client.integrations.list()
1462
+
1463
+ ```
1464
+ </dd>
1465
+ </dl>
1466
+ </dd>
1467
+ </dl>
1468
+
1469
+ #### ⚙️ Parameters
1470
+
1471
+ <dl>
1472
+ <dd>
1473
+
1474
+ <dl>
1475
+ <dd>
1476
+
1477
+ **integration_provider:** `typing.Optional[typing.Literal["COMPOSIO"]]` — * `COMPOSIO` - Composio
1478
+
1479
+ </dd>
1480
+ </dl>
1481
+
1482
+ <dl>
1483
+ <dd>
1484
+
1485
+ **limit:** `typing.Optional[int]` — Number of results to return per page.
1486
+
1487
+ </dd>
1488
+ </dl>
1489
+
1490
+ <dl>
1491
+ <dd>
1492
+
1493
+ **offset:** `typing.Optional[int]` — The initial index from which to return the results.
1494
+
1495
+ </dd>
1496
+ </dl>
1497
+
1498
+ <dl>
1499
+ <dd>
1500
+
1501
+ **ordering:** `typing.Optional[str]` — Which field to use when ordering the results.
1502
+
1503
+ </dd>
1504
+ </dl>
1505
+
1506
+ <dl>
1507
+ <dd>
1508
+
1509
+ **search:** `typing.Optional[str]` — A search term.
1510
+
1511
+ </dd>
1512
+ </dl>
1513
+
1514
+ <dl>
1515
+ <dd>
1516
+
1517
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
1518
+
1519
+ </dd>
1520
+ </dl>
1521
+ </dd>
1522
+ </dl>
1523
+
1524
+
1525
+ </dd>
1526
+ </dl>
1527
+ </details>
1528
+
1529
+ <details><summary><code>client.integrations.<a href="src/vellum/resources/integrations/client.py">retrieve</a>(...)</code></summary>
1530
+ <dl>
1531
+ <dd>
1532
+
1533
+ #### 📝 Description
1534
+
1535
+ <dl>
1536
+ <dd>
1537
+
1538
+ <dl>
1539
+ <dd>
1540
+
1541
+ Retrieve an integration
1542
+ </dd>
1543
+ </dl>
1544
+ </dd>
1545
+ </dl>
1546
+
1547
+ #### 🔌 Usage
1548
+
1549
+ <dl>
1550
+ <dd>
1551
+
1552
+ <dl>
1553
+ <dd>
1554
+
1555
+ ```python
1556
+ from vellum import Vellum
1557
+
1558
+ client = Vellum(
1559
+ api_version="YOUR_API_VERSION",
1560
+ api_key="YOUR_API_KEY",
1561
+ )
1562
+ client.integrations.retrieve(
1563
+ id="id",
1564
+ )
1565
+
1566
+ ```
1567
+ </dd>
1568
+ </dl>
1569
+ </dd>
1570
+ </dl>
1571
+
1572
+ #### ⚙️ Parameters
1573
+
1574
+ <dl>
1575
+ <dd>
1576
+
1577
+ <dl>
1578
+ <dd>
1579
+
1580
+ **id:** `str` — A UUID string identifying this integration.
1581
+
1582
+ </dd>
1583
+ </dl>
1584
+
1585
+ <dl>
1586
+ <dd>
1587
+
1588
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
1589
+
1590
+ </dd>
1591
+ </dl>
1592
+ </dd>
1593
+ </dl>
1594
+
1595
+
1424
1596
  </dd>
1425
1597
  </dl>
1426
1598
  </details>
@@ -4112,6 +4284,320 @@ directory. Supported root directories include:
4112
4284
  </dl>
4113
4285
 
4114
4286
 
4287
+ </dd>
4288
+ </dl>
4289
+ </details>
4290
+
4291
+ ## IntegrationAuthConfigs
4292
+ <details><summary><code>client.integration_auth_configs.<a href="src/vellum/resources/integration_auth_configs/client.py">list_integration_auth_configs</a>(...)</code></summary>
4293
+ <dl>
4294
+ <dd>
4295
+
4296
+ #### 📝 Description
4297
+
4298
+ <dl>
4299
+ <dd>
4300
+
4301
+ <dl>
4302
+ <dd>
4303
+
4304
+ List Integration Auth Configs
4305
+ </dd>
4306
+ </dl>
4307
+ </dd>
4308
+ </dl>
4309
+
4310
+ #### 🔌 Usage
4311
+
4312
+ <dl>
4313
+ <dd>
4314
+
4315
+ <dl>
4316
+ <dd>
4317
+
4318
+ ```python
4319
+ from vellum import Vellum
4320
+
4321
+ client = Vellum(
4322
+ api_version="YOUR_API_VERSION",
4323
+ api_key="YOUR_API_KEY",
4324
+ )
4325
+ client.integration_auth_configs.list_integration_auth_configs()
4326
+
4327
+ ```
4328
+ </dd>
4329
+ </dl>
4330
+ </dd>
4331
+ </dl>
4332
+
4333
+ #### ⚙️ Parameters
4334
+
4335
+ <dl>
4336
+ <dd>
4337
+
4338
+ <dl>
4339
+ <dd>
4340
+
4341
+ **expand:** `typing.Optional[typing.Union[str, typing.Sequence[str]]]`
4342
+
4343
+ The response fields to expand for more information.
4344
+ - 'integration_credentials' expands the list of integration credentials that the authenticated entity has access to for the auth config.
4345
+
4346
+ </dd>
4347
+ </dl>
4348
+
4349
+ <dl>
4350
+ <dd>
4351
+
4352
+ **integration_name:** `typing.Optional[str]`
4353
+
4354
+ </dd>
4355
+ </dl>
4356
+
4357
+ <dl>
4358
+ <dd>
4359
+
4360
+ **integration_provider:** `typing.Optional[str]`
4361
+
4362
+ </dd>
4363
+ </dl>
4364
+
4365
+ <dl>
4366
+ <dd>
4367
+
4368
+ **limit:** `typing.Optional[int]` — Number of results to return per page.
4369
+
4370
+ </dd>
4371
+ </dl>
4372
+
4373
+ <dl>
4374
+ <dd>
4375
+
4376
+ **offset:** `typing.Optional[int]` — The initial index from which to return the results.
4377
+
4378
+ </dd>
4379
+ </dl>
4380
+
4381
+ <dl>
4382
+ <dd>
4383
+
4384
+ **ordering:** `typing.Optional[str]` — Which field to use when ordering the results.
4385
+
4386
+ </dd>
4387
+ </dl>
4388
+
4389
+ <dl>
4390
+ <dd>
4391
+
4392
+ **search:** `typing.Optional[str]` — A search term.
4393
+
4394
+ </dd>
4395
+ </dl>
4396
+
4397
+ <dl>
4398
+ <dd>
4399
+
4400
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
4401
+
4402
+ </dd>
4403
+ </dl>
4404
+ </dd>
4405
+ </dl>
4406
+
4407
+
4408
+ </dd>
4409
+ </dl>
4410
+ </details>
4411
+
4412
+ ## IntegrationProviders
4413
+ <details><summary><code>client.integration_providers.<a href="src/vellum/resources/integration_providers/client.py">retrieve_integration_provider_tool_definition</a>(...)</code></summary>
4414
+ <dl>
4415
+ <dd>
4416
+
4417
+ #### 📝 Description
4418
+
4419
+ <dl>
4420
+ <dd>
4421
+
4422
+ <dl>
4423
+ <dd>
4424
+
4425
+ Retrieve a specific integration tool definition.
4426
+ </dd>
4427
+ </dl>
4428
+ </dd>
4429
+ </dl>
4430
+
4431
+ #### 🔌 Usage
4432
+
4433
+ <dl>
4434
+ <dd>
4435
+
4436
+ <dl>
4437
+ <dd>
4438
+
4439
+ ```python
4440
+ from vellum import Vellum
4441
+
4442
+ client = Vellum(
4443
+ api_version="YOUR_API_VERSION",
4444
+ api_key="YOUR_API_KEY",
4445
+ )
4446
+ client.integration_providers.retrieve_integration_provider_tool_definition(
4447
+ integration_name="integration_name",
4448
+ integration_provider="integration_provider",
4449
+ tool_name="tool_name",
4450
+ )
4451
+
4452
+ ```
4453
+ </dd>
4454
+ </dl>
4455
+ </dd>
4456
+ </dl>
4457
+
4458
+ #### ⚙️ Parameters
4459
+
4460
+ <dl>
4461
+ <dd>
4462
+
4463
+ <dl>
4464
+ <dd>
4465
+
4466
+ **integration_name:** `str` — The integration name
4467
+
4468
+ </dd>
4469
+ </dl>
4470
+
4471
+ <dl>
4472
+ <dd>
4473
+
4474
+ **integration_provider:** `str` — The integration provider name
4475
+
4476
+ </dd>
4477
+ </dl>
4478
+
4479
+ <dl>
4480
+ <dd>
4481
+
4482
+ **tool_name:** `str` — The tool's unique name, as specified by the integration provider
4483
+
4484
+ </dd>
4485
+ </dl>
4486
+
4487
+ <dl>
4488
+ <dd>
4489
+
4490
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
4491
+
4492
+ </dd>
4493
+ </dl>
4494
+ </dd>
4495
+ </dl>
4496
+
4497
+
4498
+ </dd>
4499
+ </dl>
4500
+ </details>
4501
+
4502
+ <details><summary><code>client.integration_providers.<a href="src/vellum/resources/integration_providers/client.py">list_integration_tools</a>(...)</code></summary>
4503
+ <dl>
4504
+ <dd>
4505
+
4506
+ #### 📝 Description
4507
+
4508
+ <dl>
4509
+ <dd>
4510
+
4511
+ <dl>
4512
+ <dd>
4513
+
4514
+ List all integration tools for a given provider and integration.
4515
+ </dd>
4516
+ </dl>
4517
+ </dd>
4518
+ </dl>
4519
+
4520
+ #### 🔌 Usage
4521
+
4522
+ <dl>
4523
+ <dd>
4524
+
4525
+ <dl>
4526
+ <dd>
4527
+
4528
+ ```python
4529
+ from vellum import Vellum
4530
+
4531
+ client = Vellum(
4532
+ api_version="YOUR_API_VERSION",
4533
+ api_key="YOUR_API_KEY",
4534
+ )
4535
+ client.integration_providers.list_integration_tools(
4536
+ integration_provider="integration_provider",
4537
+ )
4538
+
4539
+ ```
4540
+ </dd>
4541
+ </dl>
4542
+ </dd>
4543
+ </dl>
4544
+
4545
+ #### ⚙️ Parameters
4546
+
4547
+ <dl>
4548
+ <dd>
4549
+
4550
+ <dl>
4551
+ <dd>
4552
+
4553
+ **integration_provider:** `str` — The integration provider name
4554
+
4555
+ </dd>
4556
+ </dl>
4557
+
4558
+ <dl>
4559
+ <dd>
4560
+
4561
+ **integration_name:** `typing.Optional[str]` — The Vellum Integration name
4562
+
4563
+ </dd>
4564
+ </dl>
4565
+
4566
+ <dl>
4567
+ <dd>
4568
+
4569
+ **limit:** `typing.Optional[int]` — Number of results to return per page.
4570
+
4571
+ </dd>
4572
+ </dl>
4573
+
4574
+ <dl>
4575
+ <dd>
4576
+
4577
+ **offset:** `typing.Optional[int]` — The initial index from which to return the results.
4578
+
4579
+ </dd>
4580
+ </dl>
4581
+
4582
+ <dl>
4583
+ <dd>
4584
+
4585
+ **search:** `typing.Optional[str]` — The search term to filter the tools by
4586
+
4587
+ </dd>
4588
+ </dl>
4589
+
4590
+ <dl>
4591
+ <dd>
4592
+
4593
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
4594
+
4595
+ </dd>
4596
+ </dl>
4597
+ </dd>
4598
+ </dl>
4599
+
4600
+
4115
4601
  </dd>
4116
4602
  </dl>
4117
4603
  </details>
@@ -5115,9 +5601,9 @@ client.test_suite_runs.list_executions(
5115
5601
  **expand:** `typing.Optional[typing.Union[str, typing.Sequence[str]]]`
5116
5602
 
5117
5603
  The response fields to expand for more information.
5118
- - 'results.metric_results.metric_label' expands the metric label for each metric result.
5119
- - 'results.metric_results.metric_definition' expands the metric definition for each metric result.
5120
- - 'results.metric_results.metric_definition.name' expands the metric definition name for each metric result.
5604
+ - 'metric_results.metric_label' expands the metric label for each metric result.
5605
+ - 'metric_results.metric_definition' expands the metric definition for each metric result.
5606
+ - 'metric_results.metric_definition.name' expands the metric definition name for each metric result.
5121
5607
 
5122
5608
  </dd>
5123
5609
  </dl>
@@ -10,6 +10,8 @@ from . import (
10
10
  documents,
11
11
  events,
12
12
  folder_entities,
13
+ integration_auth_configs,
14
+ integration_providers,
13
15
  integrations,
14
16
  metric_definitions,
15
17
  ml_models,
@@ -46,6 +48,8 @@ __all__ = [
46
48
  "documents",
47
49
  "events",
48
50
  "folder_entities",
51
+ "integration_auth_configs",
52
+ "integration_providers",
49
53
  "integrations",
50
54
  "metric_definitions",
51
55
  "ml_models",
@@ -0,0 +1,4 @@
1
+ # This file was auto-generated by Fern from our API Definition.
2
+
3
+ # isort: skip_file
4
+