databricks-agentbricks 0.7.1__tar.gz → 0.8.0__tar.gz

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 (229) hide show
  1. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/PKG-INFO +179 -41
  2. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/README.md +176 -40
  3. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/pyproject.toml +4 -1
  4. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/app.py +38 -3
  5. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/auth.py +6 -2
  6. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/deploy.py +8 -4
  7. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/dev.py +26 -13
  8. databricks_agentbricks-0.8.0/src/databricks_agentbricks/cli/endpoint.py +206 -0
  9. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/memory.py +20 -4
  10. databricks_agentbricks-0.8.0/src/databricks_agentbricks/cli/permissions.py +185 -0
  11. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/sessions.py +4 -0
  12. databricks_agentbricks-0.8.0/src/databricks_agentbricks/clients/app_probe.py +82 -0
  13. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/apps_client.py +46 -6
  14. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/conversation_store_client.py +10 -4
  15. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/databricks_cli.py +48 -2
  16. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/local_ports.py +14 -2
  17. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/deploy.py +3 -0
  18. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/dev.py +14 -3
  19. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/help.py +78 -5
  20. databricks_agentbricks-0.8.0/src/databricks_agentbricks/presentation/loadtest.py +162 -0
  21. databricks_agentbricks-0.8.0/src/databricks_agentbricks/presentation/permissions.py +25 -0
  22. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deploy_service.py +99 -1
  23. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/deploy_state.py +2 -0
  24. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/dev_service.py +17 -10
  25. databricks_agentbricks-0.7.1/src/databricks_agentbricks/services/invoke_service.py → databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/endpoint_service.py +94 -34
  26. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/transport.py +11 -3
  27. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/__init__.py +1 -0
  28. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/_locustfile.py +305 -0
  29. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/plan.py +77 -0
  30. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/request.py +72 -0
  31. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/runner.py +165 -0
  32. databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/streaming.py +175 -0
  33. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/SKILL.md +3 -2
  34. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/references/deployment.md +2 -2
  35. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/references/state-and-tools.md +27 -0
  36. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/AGENTS.md +2 -2
  37. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/README.md +1 -2
  38. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/pyproject.toml +1 -1
  39. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/AGENTS.md +2 -2
  40. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/README.md +1 -2
  41. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/pyproject.toml +1 -1
  42. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/pyproject.toml +1 -1
  43. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/pyproject.toml +1 -1
  44. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/CHAT_APP.md +7 -2
  45. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/runtime/ui.py +106 -0
  46. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/tests/test_demo_ui.py +30 -0
  47. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/app.js +203 -47
  48. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/index.html +39 -22
  49. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/styles.css +170 -11
  50. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/CHAT_APP.md +7 -2
  51. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/runtime/ui.py +106 -0
  52. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/tests/test_demo_ui.py +30 -0
  53. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/app.js +203 -47
  54. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/index.html +39 -22
  55. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/styles.css +170 -11
  56. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/__init__.py +3 -0
  57. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/_api_client.py +77 -11
  58. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/_pagination.py +6 -6
  59. databricks_agentbricks-0.8.0/src/databricks_agentkit/_permissions.py +44 -0
  60. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/memory_store.py +69 -7
  61. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/ARCHITECTURE.md +29 -5
  62. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/README.md +34 -7
  63. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/app.py +99 -35
  64. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/auth.py +4 -0
  65. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/execution.py +2 -2
  66. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/lakebase_runtime_store.py +196 -74
  67. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/recovery.py +1 -1
  68. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/store.py +6 -2
  69. databricks_agentbricks-0.8.0/src/databricks_agentkit/runtime/errors.py +247 -0
  70. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/execution.py +13 -1
  71. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/runtime.py +6 -0
  72. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/store.py +9 -1
  73. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/types.py +2 -0
  74. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/session_store.py +69 -7
  75. databricks_agentbricks-0.7.1/src/databricks_agentbricks/cli/endpoint.py +0 -81
  76. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/.gitignore +0 -0
  77. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/NOTICE +0 -0
  78. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/__init__.py +0 -0
  79. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/agent_hint.py +0 -0
  80. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/__init__.py +0 -0
  81. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/__main__.py +0 -0
  82. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/doctor.py +0 -0
  83. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/experimental.py +0 -0
  84. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/init.py +0 -0
  85. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/mcp.py +0 -0
  86. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/models.py +0 -0
  87. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/pipeline.py +0 -0
  88. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/prompts.py +0 -0
  89. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/sandbox.py +0 -0
  90. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/telemetry.py +0 -0
  91. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/tools.py +0 -0
  92. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/tracing.py +0 -0
  93. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/__init__.py +0 -0
  94. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/api_client_provider.py +0 -0
  95. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/apps_user_auth_client.py +0 -0
  96. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/legacy_runtime_store.py +0 -0
  97. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/local_tracing_client.py +0 -0
  98. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/managed_runtime_store.py +0 -0
  99. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/mlflow_trace_client.py +0 -0
  100. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/tracing_client.py +0 -0
  101. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/errors.py +0 -0
  102. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/model_upgrade.py +0 -0
  103. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/__init__.py +0 -0
  104. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/endpoint.py +0 -0
  105. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/group.py +0 -0
  106. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/render.py +0 -0
  107. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/reporter.py +0 -0
  108. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/theme.py +0 -0
  109. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/tracing.py +0 -0
  110. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/__init__.py +0 -0
  111. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/agent_project.py +0 -0
  112. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/app_manifest.py +0 -0
  113. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/config.py +0 -0
  114. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/resolver.py +0 -0
  115. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/types.py +0 -0
  116. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/py.typed +0 -0
  117. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/reporting.py +0 -0
  118. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/__init__.py +0 -0
  119. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/__init__.py +0 -0
  120. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/app_provisioner.py +0 -0
  121. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/config.py +0 -0
  122. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/model_binding_provisioner.py +0 -0
  123. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/names.py +0 -0
  124. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/provisioners.py +0 -0
  125. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/tool_access.py +0 -0
  126. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/tool_access_provisioner.py +0 -0
  127. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/__init__.py +0 -0
  128. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/auth.py +0 -0
  129. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/request.py +0 -0
  130. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing/__init__.py +0 -0
  131. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing/targets.py +0 -0
  132. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing_service.py +0 -0
  133. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/skills.py +0 -0
  134. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-migrate/SKILL.md +0 -0
  135. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/.env.example +0 -0
  136. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/.gitignore +0 -0
  137. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/AGENTKIT_CONTRACT.md +0 -0
  138. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/CLAUDE.md +0 -0
  139. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/__init__.py +0 -0
  140. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/agent.py +0 -0
  141. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/mcps.py +0 -0
  142. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/__init__.py +0 -0
  143. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/sample_tool.py +0 -0
  144. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/send_message.py +0 -0
  145. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/app.yaml +0 -0
  146. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/__init__.py +0 -0
  147. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/adapter.py +0 -0
  148. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/main.py +0 -0
  149. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/__init__.py +0 -0
  150. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_agent.py +0 -0
  151. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_runtime.py +0 -0
  152. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_workspace.py +0 -0
  153. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/.env.example +0 -0
  154. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/.gitignore +0 -0
  155. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/AGENTKIT_CONTRACT.md +0 -0
  156. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/CLAUDE.md +0 -0
  157. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/__init__.py +0 -0
  158. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/agent.py +0 -0
  159. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/checkpoints.py +0 -0
  160. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/mcps.py +0 -0
  161. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/__init__.py +0 -0
  162. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/sample_tool.py +0 -0
  163. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/send_message.py +0 -0
  164. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/app.yaml +0 -0
  165. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/__init__.py +0 -0
  166. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/adapter.py +0 -0
  167. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/main.py +0 -0
  168. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/__init__.py +0 -0
  169. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_agent.py +0 -0
  170. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_checkpoints.py +0 -0
  171. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_runtime.py +0 -0
  172. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_workspace.py +0 -0
  173. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/.env.example +0 -0
  174. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/.gitignore +0 -0
  175. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/README.md +0 -0
  176. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/agent/__init__.py +0 -0
  177. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/agent/agent.py +0 -0
  178. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/app.yaml +0 -0
  179. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/runtime/__init__.py +0 -0
  180. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/runtime/main.py +0 -0
  181. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/tests/test_runtime.py +0 -0
  182. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/.env.example +0 -0
  183. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/.gitignore +0 -0
  184. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/README.md +0 -0
  185. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/agent/__init__.py +0 -0
  186. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/agent/agent.py +0 -0
  187. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/app.yaml +0 -0
  188. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/runtime/__init__.py +0 -0
  189. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/runtime/main.py +0 -0
  190. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/tests/test_runtime.py +0 -0
  191. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/sandbox_mcp.py +0 -0
  192. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/sandbox_mcp_langgraph.py +0 -0
  193. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/runtime/main.py +0 -0
  194. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/agentbricks-mark.png +0 -0
  195. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/markdown-it-15.0.2.min.js +0 -0
  196. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/runtime/main.py +0 -0
  197. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/agentbricks-mark.png +0 -0
  198. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/markdown-it-15.0.2.min.js +0 -0
  199. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/client.py +0 -0
  200. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/__init__.py +0 -0
  201. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/genie.py +0 -0
  202. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/history.py +0 -0
  203. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/mcp.py +0 -0
  204. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/memory.py +0 -0
  205. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/responses.py +0 -0
  206. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/session_store.py +0 -0
  207. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/model_upgrades/__init__.py +0 -0
  208. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/model_upgrades/optimization.py +0 -0
  209. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/models.py +0 -0
  210. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/__init__.py +0 -0
  211. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/genie.py +0 -0
  212. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/history.py +0 -0
  213. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/mcp.py +0 -0
  214. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/memory.py +0 -0
  215. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/sessions.py +0 -0
  216. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/py.typed +0 -0
  217. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/__init__.py +0 -0
  218. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/cors.py +0 -0
  219. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/__init__.py +0 -0
  220. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/heartbeat.py +0 -0
  221. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/genie.py +0 -0
  222. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/mcp_auth.py +0 -0
  223. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/model_services.py +0 -0
  224. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/prompt_registry.py +0 -0
  225. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/session_store_client.py +0 -0
  226. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/tool_manifest.py +0 -0
  227. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/tracing.py +0 -0
  228. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/workspace.py +0 -0
  229. {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/timefmt.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: databricks-agentbricks
3
- Version: 0.7.1
3
+ Version: 0.8.0
4
4
  Summary: Agent Bricks CLI and AgentKit SDK for custom agents on Databricks
5
5
  Author-email: Databricks <agent-feedback@databricks.com>
6
6
  License-File: NOTICE
@@ -27,6 +27,8 @@ Requires-Dist: langchain>=1.0.0; extra == 'langgraph'
27
27
  Requires-Dist: langgraph>=1.1.0; extra == 'langgraph'
28
28
  Requires-Dist: mlflow>=3.10.1; extra == 'langgraph'
29
29
  Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.25.0; extra == 'langgraph'
30
+ Provides-Extra: loadtest
31
+ Requires-Dist: locust>=2.31; extra == 'loadtest'
30
32
  Provides-Extra: openai
31
33
  Requires-Dist: databricks-agents>=1.9.3; extra == 'openai'
32
34
  Requires-Dist: databricks-openai>=0.13.0; extra == 'openai'
@@ -232,10 +234,10 @@ agentbricks deployments wait agent-bricks-my-agent
232
234
  ```
233
235
 
234
236
  `deployments wait` returns within 100 seconds (`--timeout`). Exit 0 means the agent is deployed and
235
- running, and it prints the URL; exit 1 means the deploy failed, and it prints the error and the end
236
- of the deploy log; exit 75 means it is still deploying, so run the same command again. Don't poll
237
- with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`, whose stdout
238
- is a single JSON document. A second `deploy` of the same app is refused while one is still running
237
+ answering requests, and it prints the URL; exit 1 means the deploy failed, and it prints the error
238
+ and the end of the deploy log; exit 75 means it is still deploying, so run the same command again.
239
+ Don't poll with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
240
+ whose stdout is a single JSON document. A second `deploy` of the same app is refused while one is still running
239
241
  from the project; the deploy's state and background log are in `.agentbricks/deploy-<app>.json` and
240
242
  `.agentbricks/deploy-<app>.log`. If the App is busy with another operation, `deploy` retries for
241
243
  about two minutes before failing.
@@ -374,9 +376,9 @@ writers to one path can overwrite each other. `add()`'s `write_mode` argument is
374
376
  deprecated; use `put()` instead. `memory_store.list(actor_id=..., path=...)` returns the
375
377
  memories at one exact path.
376
378
 
377
- All `list()` methods return iterators that automatically consume server pages. List
378
- `page_size` and search `limit` values must be between 1 and 100. `session.list_items()`
379
- also auto-pages. `session.fork(...)` creates an independent copy, optionally through
379
+ All `list()` methods return iterators that automatically consume server pages. Store and content list
380
+ `page_size` and search `limit` values must be between 1 and 100; permission lists accept 1–1000.
381
+ `session.list_items()` also auto-pages. `session.fork(...)` creates an independent copy, optionally through
380
382
  a specific item. Deleting a session with descendants requires
381
383
  `session.delete(force=True)` to cascade the deletion.
382
384
 
@@ -401,9 +403,8 @@ agentbricks dev
401
403
  agentbricks --profile <profile> deploy my-agent
402
404
  ```
403
405
 
404
- Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). The `localhost:8001` line from the
405
- wrapped `databricks apps run-local` is its proxy to the same app. Requests can fail with HTTP 500 for
406
- a few seconds while the app starts.
406
+ Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). Agents on different ports can run
407
+ side by side. Requests can fail with HTTP 500 for a few seconds while the app starts.
407
408
 
408
409
  Use `--framework openai` for OpenAI Agents. Templates keep agent code separate from the runtime
409
410
  adapter and declare default Session and Memory Store bindings in `agent.toml`.
@@ -436,9 +437,10 @@ while its record is retained; using the ID for a different request returns `409`
436
437
 
437
438
  `agentbricks dev` keeps execution state in process and loses it on restart. For projects with
438
439
  `[agent].server = "agentbricks"`, `agentbricks deploy` provisions a persistent Runtime Store for requests,
439
- status, events, and results. Register `@app.recover` to restart interrupted app-auth work after
440
- worker failures. Recovery is at-least-once, so external side effects must be idempotent. Session
441
- and Memory Stores separately preserve the state used by your agent.
440
+ status, events, and results. Queued work is reserved for the worker that accepted it, so other
441
+ replicas cannot start it through normal claims. Register `@app.recover` to restart interrupted
442
+ app-auth work or take over abandoned queued work after worker failures. Recovery is at-least-once,
443
+ so external side effects must be idempotent. Session and Memory Stores separately preserve agent state.
442
444
 
443
445
  The managed path uses the internal Runtime Store API to create a dedicated database in the
444
446
  workspace's shared Lakebase project and give the app SP ownership. The managed runtime initializes its schema and
@@ -450,8 +452,9 @@ The switch does not migrate existing deployments between backends. Managed clean
450
452
  the app for retry. Direct app deletion bypasses managed store cleanup.
451
453
 
452
454
  For a tool using `auth = "user"`, the Runtime Store still records token-free invocation state,
453
- events, and results. The forwarded user credential remains process-local for the active attempt and
454
- is never written to the Runtime Store. A replacement attempt after failure recovery stops with
455
+ events, and results. The forwarded user credential remains in memory on the receiving worker while
456
+ queued and during the first attempt; it is never written to the Runtime Store. A replacement attempt
457
+ after failure recovery, including takeover before execution started, stops with
455
458
  `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because the original request credential is no longer present.
456
459
 
457
460
  Use `server = "custom"` to deploy your own HTTP server without provisioning a Runtime Store.
@@ -683,6 +686,60 @@ agent = create_agent(model=..., tools=[*your_tools, *memory_tools(actor)])
683
686
  > `session_store.grant_permission(principal_id)` or `memory_store.grant_permission(principal_id)`;
684
687
  > `agentbricks deploy` does this for the deployed app automatically.
685
688
 
689
+ ### Managing store permissions
690
+
691
+ Both store types support `permissions get`, `list`, `grant`, and `revoke`:
692
+
693
+ ```sh
694
+ # Inspect your own effective access, or list explicit grants as the creator/admin.
695
+ agentbricks sessions stores permissions get support-agent-sessions
696
+ agentbricks memory stores permissions list memory-stores/<id> --all
697
+
698
+ # Grant a user READ or an app service principal WRITE.
699
+ agentbricks sessions stores permissions grant support-agent-sessions \
700
+ --user teammate@example.com --permission READ
701
+ agentbricks memory stores permissions grant memory-stores/<id> \
702
+ --service-principal <application-id> --permission WRITE
703
+
704
+ # Remove both READ and WRITE grants. --yes skips confirmation.
705
+ agentbricks memory stores permissions revoke memory-stores/<id> \
706
+ --service-principal <application-id> --yes
707
+ ```
708
+
709
+ Session stores accept their configured name or `session-stores/<name>`. Memory stores accept an ID
710
+ or `memory-stores/<id>`; permission Get also accepts the display-name lookup supported by store Get
711
+ and rejects ambiguous matches. The global `--profile` and `--output json` options go before
712
+ `sessions` or `memory`. List follows the existing CLI pagination convention: one JSON/piped page
713
+ with `next_page_token`, interactive text pages, or every page with `--all`.
714
+
715
+ Get always returns the authenticated caller's effective permission, including
716
+ `PERMISSION_LEVEL_UNSPECIFIED` for no access (shown as "No access" in text). List reports direct
717
+ grants and excludes implicit ownership and inherited access. Grant/List/Revoke require the store
718
+ creator or a workspace admin, even if the caller has WRITE. Service principals use application/client
719
+ IDs, not numeric SCIM IDs. WRITE includes READ; granting READ preserves existing WRITE. Revoke
720
+ removes both levels of direct grants, is idempotent, and cannot revoke ownership or inherited access.
721
+ A later deploy can restore the app's grants. These APIs require workspace preview/feature enablement.
722
+
723
+ The Python SDK exposes the same operations on both store objects:
724
+
725
+ ```python
726
+ # Existing service-principal grants retain the WRITE default.
727
+ session_store.grant_permission("<application-id>")
728
+ memory_store.grant_permission("teammate@example.com", principal_type="USER", permission="READ")
729
+
730
+ permission = session_store.get_permission()
731
+ print(permission.principal.name, permission.principal.principal_type, permission.permission)
732
+ for grant in memory_store.list_permissions(page_size=100):
733
+ print(grant.principal.name, grant.permission)
734
+
735
+ memory_store.revoke_permission("teammate@example.com", principal_type="USER")
736
+ ```
737
+
738
+ `get_permission()` returns a `StorePermission`; `list_permissions()` returns an iterator of those
739
+ values and automatically follows every page. Each contains a `Principal` with `name` and
740
+ `principal_type`, plus a `permission` value. Grant/Revoke default to `SERVICE_PRINCIPAL`;
741
+ pass `principal_type="USER"` for user emails.
742
+
686
743
  ### How sessions and memory are keyed
687
744
 
688
745
  In an agent generated by `agentbricks init`, each invocation picks its session and its memory
@@ -732,7 +789,7 @@ Memory and session stores are independent resources: deleting one never affects
732
789
  For projects with `agent.toml`, unbinding either store removes its declaration; the next deploy
733
790
  removes the corresponding `AGENT_MEMORY_STORE` or `AGENT_SESSION_STORE` entry from `app.yaml`.
734
791
  Unbinding does not delete the store or revoke an existing grant to the App's service principal.
735
- If access must be revoked, coordinate that separately with the store owner or workspace admin.
792
+ Use the permission commands below as the store creator or a workspace admin to revoke access.
736
793
 
737
794
  ## Model and prompt upgrades (experimental)
738
795
 
@@ -867,6 +924,9 @@ agentbricks [-p <profile>] [-o text|json]
867
924
  list | get | logs | start | stop | delete
868
925
  endpoint
869
926
  invoke [APP] --path PATH [--url URL] [--json JSON] [--sse]
927
+ loadtest [APP] --path PATH [--url URL] [--requests FILE] [--sse]
928
+ [--concurrency N] [--max-duration SECONDS] [--max-requests N] [--no-warmup]
929
+ [--report-dir PATH] [--save-responses FILE]
870
930
  ```
871
931
 
872
932
  ## Bring an existing agent
@@ -967,6 +1027,96 @@ as the session id - put the session id at the top level of the `--json` body for
967
1027
  also works with a direct App URL and with the generated runtime on localhost. OAuth and session headers are managed by
968
1028
  the runtime; arbitrary custom request headers are intentionally not exposed by this command.
969
1029
 
1030
+ ## Load test HTTP endpoints
1031
+
1032
+ `agentbricks endpoint loadtest` repeats HTTP requests with Locust. The load generator runs on the
1033
+ machine where you execute the command; the target can be a deployed Databricks App, localhost, or
1034
+ another HTTP server. Each measured request is one HTTP exchange, including the complete response
1035
+ body or SSE stream. A `202 Accepted` response measures submission, not eventual background work.
1036
+
1037
+ Install the optional dependency and create a JSON array of complete request bodies. A one-element
1038
+ array repeats one body; multiple bodies cycle in order. Omit `--requests` for a bodyless request.
1039
+ `endpoint invoke` retains `--json` for a single request; load testing uses only `--requests`.
1040
+
1041
+ ```sh
1042
+ pip install 'databricks-agentbricks[loadtest]'
1043
+ cat > requests.json <<'JSON'
1044
+ [
1045
+ {
1046
+ "id": "{{request_id}}",
1047
+ "session_id": "{{user_id}}",
1048
+ "input": [{"role": "user", "content": "Hello"}],
1049
+ "stream": true
1050
+ }
1051
+ ]
1052
+ JSON
1053
+ agentbricks --profile <profile> endpoint loadtest agent-bricks-my-agent \
1054
+ --path /api/invocations --requests requests.json --sse \
1055
+ --concurrency 5 --max-duration 60 --max-requests 200 --report-dir results/loadtest
1056
+ ```
1057
+
1058
+ `--concurrency` sets simultaneous users (default: 1). Each sends another request after its previous
1059
+ request finishes. `--max-duration` is in seconds (default: 60); `--max-requests` optionally caps measured
1060
+ requests. Whichever limit is reached first stops dispatch, then in-flight requests drain for up to
1061
+ `--timeout` seconds. Ctrl-C also drains and preserves a partial report. Failed or incomplete
1062
+ requests make the command exit nonzero; cancellation exits 130 or 143 for SIGINT or SIGTERM.
1063
+
1064
+ By default, one real **warm-up** request runs before measurement using the first body. It can incur
1065
+ model/tool costs, mutate state, and warm the endpoint. Its request and latency, including cold-start
1066
+ latency, are excluded from the cap, report counts, and timings. A failed warm-up stops the test.
1067
+ Use `--no-warmup` to send only measured requests, including any cold-start latency. Reports state
1068
+ whether the excluded warm-up ran. Set a suitable `--timeout` for the complete response.
1069
+
1070
+ Request bodies support two identity lifetimes:
1071
+
1072
+ | Placeholder | Lifetime | Example use |
1073
+ | --- | --- | --- |
1074
+ | `{{request_id}}` | Fresh UUID per request, including the excluded warm-up | Agent invocation/idempotency ID |
1075
+ | `{{user_id}}` | Stable UUID per simulated user; warm-up uses its own identity | Agent session ID |
1076
+ | `{{uuid}}` | Alias of the current `{{request_id}}` | Existing request datasets |
1077
+
1078
+ Durable agents need a fresh invocation `id` for every request; a fixed ID can replay cached output.
1079
+ Use `{{request_id}}` for `id` and `{{user_id}}` for a session that should persist across one user's
1080
+ requests. By default, each App user's `X-Routing-Key` matches its generated user identity; an explicit
1081
+ `--routing-key` pins all users to that routing key. Routing and session contents are separate: include
1082
+ `session_id` in the body when the server requires it. Tests run closed-loop, without a think-time pause.
1083
+
1084
+ The final summary includes counts, throughput including drain, successful-only and all-completed
1085
+ latency percentiles, answer-text TTFT, token usage, coverage, incomplete attempts, and generator CPU
1086
+ warnings. With `--output json` before `endpoint`, stdout contains one Agent Bricks summary object;
1087
+ progress stays on stderr. This is the same object saved as `summary.json`.
1088
+ Locust's rounded histogram buckets are used for percentiles; all-completed timings include failures.
1089
+ These bounded tests measure the selected workload and do not establish sustainable capacity or answer quality.
1090
+
1091
+ `--report-dir` writes **all HTML, CSV, and JSON formats together**: `index.html`, native `locust.html`
1092
+ charts, `locust_*.csv` statistics/history/errors, and `summary.json`. There is no format selector.
1093
+ Use a new or empty directory. Reports contain metrics and the target host, without raw request or
1094
+ answer content or credentials. Review the target host before sharing a report.
1095
+
1096
+ For SSE responses, latency includes stream completion. Answer-text TTFT recognizes supported
1097
+ DurableAgentServer, OpenAI Chat Completions, and Responses SSE events, ignoring metadata and tool
1098
+ events. Missing text/token usage is unknown, with coverage reported; token counts are never inferred.
1099
+ Runtime model-message usage is summed across distinct messages; repeated message IDs update that
1100
+ message's total. Chat Completions and Responses usage snapshots replace earlier totals.
1101
+ Recognized error events and truncated supported streams fail the request. This command does not
1102
+ perform background polling, reconnect, or stream replay.
1103
+
1104
+ To save responses, add `--save-responses responses.json`. This exports **every successful measured
1105
+ request**, without sampling; it excludes warm-up, failed requests, and incomplete responses.
1106
+ The new file has mode 0600 and must be outside `--report-dir`, in an existing parent directory.
1107
+ It contains raw request inputs, outputs, and explicit trace IDs returned by an already instrumented
1108
+ agent (`X-MLflow-Trace-ID` or top-level `trace_id`). Keep it private and out of shared report bundles.
1109
+ The export is streamed to disk rather than retaining all results in memory; size grows with the load.
1110
+
1111
+ ```json
1112
+ {"schema_version":1,"case_count":1,"observations":[{"case_index":0,"inputs":{},"outputs":"...","trace_id":null}]}
1113
+ ```
1114
+
1115
+ `case_index` is zero-based. Supported SSE outputs contain accumulated answer text; JSON outputs use
1116
+ its `output` value when present, otherwise the response body. Bodyless inputs are `null`.
1117
+ Use native MLflow APIs separately for evaluation; load testing does not run scorers, fetch traces,
1118
+ or enable server tracing.
1119
+
970
1120
  ## Command help
971
1121
 
972
1122
  Use the conventional help flag at any command level. Every command's help includes runnable
@@ -996,6 +1146,9 @@ agentbricks tools remove mcp system.ai.web_search
996
1146
  agentbricks tools list
997
1147
  ```
998
1148
 
1149
+ `agentbricks tools list` shows integrations you can add. To see the tools an agent already has, open
1150
+ **Tools** under Capabilities in the chat app.
1151
+
999
1152
  ### Managed tool identity and migration
1000
1153
 
1001
1154
  `agentbricks tools add mcp`, `agentbricks tools add sandbox`, `agentbricks tools add uc-function`,
@@ -1091,11 +1244,16 @@ generated request-aware agent function.
1091
1244
 
1092
1245
  Request-user invocations use the same synchronous, streaming, background, status, event-replay,
1093
1246
  and idempotency APIs as app-auth invocations. The Runtime Store records only token-free request
1094
- state, events, and results. The forwarded credential stays process-local for the active first
1095
- attempt and closes when that attempt completes, fails, or is cancelled. A replacement attempt after
1247
+ state, events, and results. The forwarded credential stays process-local while queued and during
1248
+ the first attempt, and closes when that attempt completes, fails, or is cancelled. The store
1249
+ enforces affinity to the accepting worker. A replacement attempt after
1096
1250
  failure recovery stops with `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because no user credential is
1097
1251
  available; neither the invoke nor recovery handler runs for that attempt.
1098
1252
 
1253
+ Event reconnection does not resume execution. OBO approval/resume remains unsupported
1254
+ (`MCP_USER_AUTH_HITL_UNSUPPORTED`). Upgrade all replicas before relying on affinity; see the
1255
+ [runtime guide](src/databricks_agentkit/runtime/README.md#deployed-execution) for details.
1256
+
1099
1257
  Before deploying user-auth tools from an older project, migrate its request handler and framework
1100
1258
  adapter to the current request-auth-aware `DurableAgentServer` template, then explicitly choose `user` or
1101
1259
  `app` on **every** managed MCP, sandbox, or Genie entry. Changing `agent.toml` alone does not
@@ -1220,16 +1378,8 @@ with TOML inspection. Replace `agentbricks mcp list [--schema catalog.schema]` w
1220
1378
  `agentbricks tools list --kind mcp [--schema catalog.schema]`; the former command is removed. Use
1221
1379
  `agentbricks tools list --help` for the new discovery contract.
1222
1380
 
1223
- Read-only live discovery can be checked against the installed wheel without creating a project
1224
- or deploying an agent:
1225
-
1226
- ```sh
1227
- AGENTBRICKS_E2E_PROFILE=<profile> .venv-functional/bin/pytest tests/e2e/tool_discovery_test.py -v
1228
- ```
1229
-
1230
- The live checks compare default and MCP-filtered discovery with the compatibility service list.
1231
- Set `AGENTBRICKS_E2E_SCHEMA=catalog.schema` to exercise an additional schema. The installed CLI's local
1232
- add/review/remove flows and all updated help pages are covered by `tests/functional/cli_smoke_test.py`.
1381
+ The local add/review/remove flows and all updated help pages are covered by the unit tests
1382
+ (`tools_test.py`, `tools_discovery_test.py`, `cli_test.py`).
1233
1383
 
1234
1384
  In managed-server templates, custom Python tools are code-first. Write them with the framework's native
1235
1385
  decorator in `agent/tools/`: LangGraph uses `@tool`, while OpenAI Agents uses `@function_tool`. The
@@ -1358,18 +1508,6 @@ The effective caller needs access to the data, the SQL warehouse, and the select
1358
1508
  where applicable. Agent Bricks CLI does not grant permissions or promise a service-principal fallback when
1359
1509
  caller credentials lack access. An offline add succeeding does not establish runtime access.
1360
1510
 
1361
- The opt-in live tests exercise both frameworks against the configured workspace and an existing
1362
- Genie space. From `integrations/agentbricks`, with both framework extras installed:
1363
-
1364
- ```sh
1365
- DATABRICKS_CONFIG_PROFILE=my-workspace RUN_AGENTBRICKS_GENIE_TESTS=1 \
1366
- AGENTBRICKS_GENIE_SPACE_ID=SPACE_ID \
1367
- uv run pytest tests/integration_tests/genie_tools_test.py
1368
- ```
1369
-
1370
- By default they ask for the row count of `samples.nyctaxi.trips`. Set `AGENTBRICKS_GENIE_QUESTION` for
1371
- another dataset and `AGENTBRICKS_GENIE_EXPECTED_VALUE` to assert a known result cell.
1372
-
1373
1511
  ## Initialize the chat app demo
1374
1512
 
1375
1513
  The chat app is a LangGraph-specific init overlay, not a command that mutates an existing project.
@@ -191,10 +191,10 @@ agentbricks deployments wait agent-bricks-my-agent
191
191
  ```
192
192
 
193
193
  `deployments wait` returns within 100 seconds (`--timeout`). Exit 0 means the agent is deployed and
194
- running, and it prints the URL; exit 1 means the deploy failed, and it prints the error and the end
195
- of the deploy log; exit 75 means it is still deploying, so run the same command again. Don't poll
196
- with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`, whose stdout
197
- is a single JSON document. A second `deploy` of the same app is refused while one is still running
194
+ answering requests, and it prints the URL; exit 1 means the deploy failed, and it prints the error
195
+ and the end of the deploy log; exit 75 means it is still deploying, so run the same command again.
196
+ Don't poll with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
197
+ whose stdout is a single JSON document. A second `deploy` of the same app is refused while one is still running
198
198
  from the project; the deploy's state and background log are in `.agentbricks/deploy-<app>.json` and
199
199
  `.agentbricks/deploy-<app>.log`. If the App is busy with another operation, `deploy` retries for
200
200
  about two minutes before failing.
@@ -333,9 +333,9 @@ writers to one path can overwrite each other. `add()`'s `write_mode` argument is
333
333
  deprecated; use `put()` instead. `memory_store.list(actor_id=..., path=...)` returns the
334
334
  memories at one exact path.
335
335
 
336
- All `list()` methods return iterators that automatically consume server pages. List
337
- `page_size` and search `limit` values must be between 1 and 100. `session.list_items()`
338
- also auto-pages. `session.fork(...)` creates an independent copy, optionally through
336
+ All `list()` methods return iterators that automatically consume server pages. Store and content list
337
+ `page_size` and search `limit` values must be between 1 and 100; permission lists accept 1–1000.
338
+ `session.list_items()` also auto-pages. `session.fork(...)` creates an independent copy, optionally through
339
339
  a specific item. Deleting a session with descendants requires
340
340
  `session.delete(force=True)` to cascade the deletion.
341
341
 
@@ -360,9 +360,8 @@ agentbricks dev
360
360
  agentbricks --profile <profile> deploy my-agent
361
361
  ```
362
362
 
363
- Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). The `localhost:8001` line from the
364
- wrapped `databricks apps run-local` is its proxy to the same app. Requests can fail with HTTP 500 for
365
- a few seconds while the app starts.
363
+ Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). Agents on different ports can run
364
+ side by side. Requests can fail with HTTP 500 for a few seconds while the app starts.
366
365
 
367
366
  Use `--framework openai` for OpenAI Agents. Templates keep agent code separate from the runtime
368
367
  adapter and declare default Session and Memory Store bindings in `agent.toml`.
@@ -395,9 +394,10 @@ while its record is retained; using the ID for a different request returns `409`
395
394
 
396
395
  `agentbricks dev` keeps execution state in process and loses it on restart. For projects with
397
396
  `[agent].server = "agentbricks"`, `agentbricks deploy` provisions a persistent Runtime Store for requests,
398
- status, events, and results. Register `@app.recover` to restart interrupted app-auth work after
399
- worker failures. Recovery is at-least-once, so external side effects must be idempotent. Session
400
- and Memory Stores separately preserve the state used by your agent.
397
+ status, events, and results. Queued work is reserved for the worker that accepted it, so other
398
+ replicas cannot start it through normal claims. Register `@app.recover` to restart interrupted
399
+ app-auth work or take over abandoned queued work after worker failures. Recovery is at-least-once,
400
+ so external side effects must be idempotent. Session and Memory Stores separately preserve agent state.
401
401
 
402
402
  The managed path uses the internal Runtime Store API to create a dedicated database in the
403
403
  workspace's shared Lakebase project and give the app SP ownership. The managed runtime initializes its schema and
@@ -409,8 +409,9 @@ The switch does not migrate existing deployments between backends. Managed clean
409
409
  the app for retry. Direct app deletion bypasses managed store cleanup.
410
410
 
411
411
  For a tool using `auth = "user"`, the Runtime Store still records token-free invocation state,
412
- events, and results. The forwarded user credential remains process-local for the active attempt and
413
- is never written to the Runtime Store. A replacement attempt after failure recovery stops with
412
+ events, and results. The forwarded user credential remains in memory on the receiving worker while
413
+ queued and during the first attempt; it is never written to the Runtime Store. A replacement attempt
414
+ after failure recovery, including takeover before execution started, stops with
414
415
  `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because the original request credential is no longer present.
415
416
 
416
417
  Use `server = "custom"` to deploy your own HTTP server without provisioning a Runtime Store.
@@ -642,6 +643,60 @@ agent = create_agent(model=..., tools=[*your_tools, *memory_tools(actor)])
642
643
  > `session_store.grant_permission(principal_id)` or `memory_store.grant_permission(principal_id)`;
643
644
  > `agentbricks deploy` does this for the deployed app automatically.
644
645
 
646
+ ### Managing store permissions
647
+
648
+ Both store types support `permissions get`, `list`, `grant`, and `revoke`:
649
+
650
+ ```sh
651
+ # Inspect your own effective access, or list explicit grants as the creator/admin.
652
+ agentbricks sessions stores permissions get support-agent-sessions
653
+ agentbricks memory stores permissions list memory-stores/<id> --all
654
+
655
+ # Grant a user READ or an app service principal WRITE.
656
+ agentbricks sessions stores permissions grant support-agent-sessions \
657
+ --user teammate@example.com --permission READ
658
+ agentbricks memory stores permissions grant memory-stores/<id> \
659
+ --service-principal <application-id> --permission WRITE
660
+
661
+ # Remove both READ and WRITE grants. --yes skips confirmation.
662
+ agentbricks memory stores permissions revoke memory-stores/<id> \
663
+ --service-principal <application-id> --yes
664
+ ```
665
+
666
+ Session stores accept their configured name or `session-stores/<name>`. Memory stores accept an ID
667
+ or `memory-stores/<id>`; permission Get also accepts the display-name lookup supported by store Get
668
+ and rejects ambiguous matches. The global `--profile` and `--output json` options go before
669
+ `sessions` or `memory`. List follows the existing CLI pagination convention: one JSON/piped page
670
+ with `next_page_token`, interactive text pages, or every page with `--all`.
671
+
672
+ Get always returns the authenticated caller's effective permission, including
673
+ `PERMISSION_LEVEL_UNSPECIFIED` for no access (shown as "No access" in text). List reports direct
674
+ grants and excludes implicit ownership and inherited access. Grant/List/Revoke require the store
675
+ creator or a workspace admin, even if the caller has WRITE. Service principals use application/client
676
+ IDs, not numeric SCIM IDs. WRITE includes READ; granting READ preserves existing WRITE. Revoke
677
+ removes both levels of direct grants, is idempotent, and cannot revoke ownership or inherited access.
678
+ A later deploy can restore the app's grants. These APIs require workspace preview/feature enablement.
679
+
680
+ The Python SDK exposes the same operations on both store objects:
681
+
682
+ ```python
683
+ # Existing service-principal grants retain the WRITE default.
684
+ session_store.grant_permission("<application-id>")
685
+ memory_store.grant_permission("teammate@example.com", principal_type="USER", permission="READ")
686
+
687
+ permission = session_store.get_permission()
688
+ print(permission.principal.name, permission.principal.principal_type, permission.permission)
689
+ for grant in memory_store.list_permissions(page_size=100):
690
+ print(grant.principal.name, grant.permission)
691
+
692
+ memory_store.revoke_permission("teammate@example.com", principal_type="USER")
693
+ ```
694
+
695
+ `get_permission()` returns a `StorePermission`; `list_permissions()` returns an iterator of those
696
+ values and automatically follows every page. Each contains a `Principal` with `name` and
697
+ `principal_type`, plus a `permission` value. Grant/Revoke default to `SERVICE_PRINCIPAL`;
698
+ pass `principal_type="USER"` for user emails.
699
+
645
700
  ### How sessions and memory are keyed
646
701
 
647
702
  In an agent generated by `agentbricks init`, each invocation picks its session and its memory
@@ -691,7 +746,7 @@ Memory and session stores are independent resources: deleting one never affects
691
746
  For projects with `agent.toml`, unbinding either store removes its declaration; the next deploy
692
747
  removes the corresponding `AGENT_MEMORY_STORE` or `AGENT_SESSION_STORE` entry from `app.yaml`.
693
748
  Unbinding does not delete the store or revoke an existing grant to the App's service principal.
694
- If access must be revoked, coordinate that separately with the store owner or workspace admin.
749
+ Use the permission commands below as the store creator or a workspace admin to revoke access.
695
750
 
696
751
  ## Model and prompt upgrades (experimental)
697
752
 
@@ -826,6 +881,9 @@ agentbricks [-p <profile>] [-o text|json]
826
881
  list | get | logs | start | stop | delete
827
882
  endpoint
828
883
  invoke [APP] --path PATH [--url URL] [--json JSON] [--sse]
884
+ loadtest [APP] --path PATH [--url URL] [--requests FILE] [--sse]
885
+ [--concurrency N] [--max-duration SECONDS] [--max-requests N] [--no-warmup]
886
+ [--report-dir PATH] [--save-responses FILE]
829
887
  ```
830
888
 
831
889
  ## Bring an existing agent
@@ -926,6 +984,96 @@ as the session id - put the session id at the top level of the `--json` body for
926
984
  also works with a direct App URL and with the generated runtime on localhost. OAuth and session headers are managed by
927
985
  the runtime; arbitrary custom request headers are intentionally not exposed by this command.
928
986
 
987
+ ## Load test HTTP endpoints
988
+
989
+ `agentbricks endpoint loadtest` repeats HTTP requests with Locust. The load generator runs on the
990
+ machine where you execute the command; the target can be a deployed Databricks App, localhost, or
991
+ another HTTP server. Each measured request is one HTTP exchange, including the complete response
992
+ body or SSE stream. A `202 Accepted` response measures submission, not eventual background work.
993
+
994
+ Install the optional dependency and create a JSON array of complete request bodies. A one-element
995
+ array repeats one body; multiple bodies cycle in order. Omit `--requests` for a bodyless request.
996
+ `endpoint invoke` retains `--json` for a single request; load testing uses only `--requests`.
997
+
998
+ ```sh
999
+ pip install 'databricks-agentbricks[loadtest]'
1000
+ cat > requests.json <<'JSON'
1001
+ [
1002
+ {
1003
+ "id": "{{request_id}}",
1004
+ "session_id": "{{user_id}}",
1005
+ "input": [{"role": "user", "content": "Hello"}],
1006
+ "stream": true
1007
+ }
1008
+ ]
1009
+ JSON
1010
+ agentbricks --profile <profile> endpoint loadtest agent-bricks-my-agent \
1011
+ --path /api/invocations --requests requests.json --sse \
1012
+ --concurrency 5 --max-duration 60 --max-requests 200 --report-dir results/loadtest
1013
+ ```
1014
+
1015
+ `--concurrency` sets simultaneous users (default: 1). Each sends another request after its previous
1016
+ request finishes. `--max-duration` is in seconds (default: 60); `--max-requests` optionally caps measured
1017
+ requests. Whichever limit is reached first stops dispatch, then in-flight requests drain for up to
1018
+ `--timeout` seconds. Ctrl-C also drains and preserves a partial report. Failed or incomplete
1019
+ requests make the command exit nonzero; cancellation exits 130 or 143 for SIGINT or SIGTERM.
1020
+
1021
+ By default, one real **warm-up** request runs before measurement using the first body. It can incur
1022
+ model/tool costs, mutate state, and warm the endpoint. Its request and latency, including cold-start
1023
+ latency, are excluded from the cap, report counts, and timings. A failed warm-up stops the test.
1024
+ Use `--no-warmup` to send only measured requests, including any cold-start latency. Reports state
1025
+ whether the excluded warm-up ran. Set a suitable `--timeout` for the complete response.
1026
+
1027
+ Request bodies support two identity lifetimes:
1028
+
1029
+ | Placeholder | Lifetime | Example use |
1030
+ | --- | --- | --- |
1031
+ | `{{request_id}}` | Fresh UUID per request, including the excluded warm-up | Agent invocation/idempotency ID |
1032
+ | `{{user_id}}` | Stable UUID per simulated user; warm-up uses its own identity | Agent session ID |
1033
+ | `{{uuid}}` | Alias of the current `{{request_id}}` | Existing request datasets |
1034
+
1035
+ Durable agents need a fresh invocation `id` for every request; a fixed ID can replay cached output.
1036
+ Use `{{request_id}}` for `id` and `{{user_id}}` for a session that should persist across one user's
1037
+ requests. By default, each App user's `X-Routing-Key` matches its generated user identity; an explicit
1038
+ `--routing-key` pins all users to that routing key. Routing and session contents are separate: include
1039
+ `session_id` in the body when the server requires it. Tests run closed-loop, without a think-time pause.
1040
+
1041
+ The final summary includes counts, throughput including drain, successful-only and all-completed
1042
+ latency percentiles, answer-text TTFT, token usage, coverage, incomplete attempts, and generator CPU
1043
+ warnings. With `--output json` before `endpoint`, stdout contains one Agent Bricks summary object;
1044
+ progress stays on stderr. This is the same object saved as `summary.json`.
1045
+ Locust's rounded histogram buckets are used for percentiles; all-completed timings include failures.
1046
+ These bounded tests measure the selected workload and do not establish sustainable capacity or answer quality.
1047
+
1048
+ `--report-dir` writes **all HTML, CSV, and JSON formats together**: `index.html`, native `locust.html`
1049
+ charts, `locust_*.csv` statistics/history/errors, and `summary.json`. There is no format selector.
1050
+ Use a new or empty directory. Reports contain metrics and the target host, without raw request or
1051
+ answer content or credentials. Review the target host before sharing a report.
1052
+
1053
+ For SSE responses, latency includes stream completion. Answer-text TTFT recognizes supported
1054
+ DurableAgentServer, OpenAI Chat Completions, and Responses SSE events, ignoring metadata and tool
1055
+ events. Missing text/token usage is unknown, with coverage reported; token counts are never inferred.
1056
+ Runtime model-message usage is summed across distinct messages; repeated message IDs update that
1057
+ message's total. Chat Completions and Responses usage snapshots replace earlier totals.
1058
+ Recognized error events and truncated supported streams fail the request. This command does not
1059
+ perform background polling, reconnect, or stream replay.
1060
+
1061
+ To save responses, add `--save-responses responses.json`. This exports **every successful measured
1062
+ request**, without sampling; it excludes warm-up, failed requests, and incomplete responses.
1063
+ The new file has mode 0600 and must be outside `--report-dir`, in an existing parent directory.
1064
+ It contains raw request inputs, outputs, and explicit trace IDs returned by an already instrumented
1065
+ agent (`X-MLflow-Trace-ID` or top-level `trace_id`). Keep it private and out of shared report bundles.
1066
+ The export is streamed to disk rather than retaining all results in memory; size grows with the load.
1067
+
1068
+ ```json
1069
+ {"schema_version":1,"case_count":1,"observations":[{"case_index":0,"inputs":{},"outputs":"...","trace_id":null}]}
1070
+ ```
1071
+
1072
+ `case_index` is zero-based. Supported SSE outputs contain accumulated answer text; JSON outputs use
1073
+ its `output` value when present, otherwise the response body. Bodyless inputs are `null`.
1074
+ Use native MLflow APIs separately for evaluation; load testing does not run scorers, fetch traces,
1075
+ or enable server tracing.
1076
+
929
1077
  ## Command help
930
1078
 
931
1079
  Use the conventional help flag at any command level. Every command's help includes runnable
@@ -955,6 +1103,9 @@ agentbricks tools remove mcp system.ai.web_search
955
1103
  agentbricks tools list
956
1104
  ```
957
1105
 
1106
+ `agentbricks tools list` shows integrations you can add. To see the tools an agent already has, open
1107
+ **Tools** under Capabilities in the chat app.
1108
+
958
1109
  ### Managed tool identity and migration
959
1110
 
960
1111
  `agentbricks tools add mcp`, `agentbricks tools add sandbox`, `agentbricks tools add uc-function`,
@@ -1050,11 +1201,16 @@ generated request-aware agent function.
1050
1201
 
1051
1202
  Request-user invocations use the same synchronous, streaming, background, status, event-replay,
1052
1203
  and idempotency APIs as app-auth invocations. The Runtime Store records only token-free request
1053
- state, events, and results. The forwarded credential stays process-local for the active first
1054
- attempt and closes when that attempt completes, fails, or is cancelled. A replacement attempt after
1204
+ state, events, and results. The forwarded credential stays process-local while queued and during
1205
+ the first attempt, and closes when that attempt completes, fails, or is cancelled. The store
1206
+ enforces affinity to the accepting worker. A replacement attempt after
1055
1207
  failure recovery stops with `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because no user credential is
1056
1208
  available; neither the invoke nor recovery handler runs for that attempt.
1057
1209
 
1210
+ Event reconnection does not resume execution. OBO approval/resume remains unsupported
1211
+ (`MCP_USER_AUTH_HITL_UNSUPPORTED`). Upgrade all replicas before relying on affinity; see the
1212
+ [runtime guide](src/databricks_agentkit/runtime/README.md#deployed-execution) for details.
1213
+
1058
1214
  Before deploying user-auth tools from an older project, migrate its request handler and framework
1059
1215
  adapter to the current request-auth-aware `DurableAgentServer` template, then explicitly choose `user` or
1060
1216
  `app` on **every** managed MCP, sandbox, or Genie entry. Changing `agent.toml` alone does not
@@ -1179,16 +1335,8 @@ with TOML inspection. Replace `agentbricks mcp list [--schema catalog.schema]` w
1179
1335
  `agentbricks tools list --kind mcp [--schema catalog.schema]`; the former command is removed. Use
1180
1336
  `agentbricks tools list --help` for the new discovery contract.
1181
1337
 
1182
- Read-only live discovery can be checked against the installed wheel without creating a project
1183
- or deploying an agent:
1184
-
1185
- ```sh
1186
- AGENTBRICKS_E2E_PROFILE=<profile> .venv-functional/bin/pytest tests/e2e/tool_discovery_test.py -v
1187
- ```
1188
-
1189
- The live checks compare default and MCP-filtered discovery with the compatibility service list.
1190
- Set `AGENTBRICKS_E2E_SCHEMA=catalog.schema` to exercise an additional schema. The installed CLI's local
1191
- add/review/remove flows and all updated help pages are covered by `tests/functional/cli_smoke_test.py`.
1338
+ The local add/review/remove flows and all updated help pages are covered by the unit tests
1339
+ (`tools_test.py`, `tools_discovery_test.py`, `cli_test.py`).
1192
1340
 
1193
1341
  In managed-server templates, custom Python tools are code-first. Write them with the framework's native
1194
1342
  decorator in `agent/tools/`: LangGraph uses `@tool`, while OpenAI Agents uses `@function_tool`. The
@@ -1317,18 +1465,6 @@ The effective caller needs access to the data, the SQL warehouse, and the select
1317
1465
  where applicable. Agent Bricks CLI does not grant permissions or promise a service-principal fallback when
1318
1466
  caller credentials lack access. An offline add succeeding does not establish runtime access.
1319
1467
 
1320
- The opt-in live tests exercise both frameworks against the configured workspace and an existing
1321
- Genie space. From `integrations/agentbricks`, with both framework extras installed:
1322
-
1323
- ```sh
1324
- DATABRICKS_CONFIG_PROFILE=my-workspace RUN_AGENTBRICKS_GENIE_TESTS=1 \
1325
- AGENTBRICKS_GENIE_SPACE_ID=SPACE_ID \
1326
- uv run pytest tests/integration_tests/genie_tools_test.py
1327
- ```
1328
-
1329
- By default they ask for the row count of `samples.nyctaxi.trips`. Set `AGENTBRICKS_GENIE_QUESTION` for
1330
- another dataset and `AGENTBRICKS_GENIE_EXPECTED_VALUE` to assert a known result cell.
1331
-
1332
1468
  ## Initialize the chat app demo
1333
1469
 
1334
1470
  The chat app is a LangGraph-specific init overlay, not a command that mutates an existing project.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "databricks-agentbricks"
3
- version = "0.7.1"
3
+ version = "0.8.0"
4
4
  description = "Agent Bricks CLI and AgentKit SDK for custom agents on Databricks"
5
5
  authors = [
6
6
  { name="Databricks", email="agent-feedback@databricks.com" },
@@ -33,6 +33,9 @@ dependencies = [
33
33
  ]
34
34
 
35
35
  [project.optional-dependencies]
36
+ loadtest = [
37
+ "locust>=2.31",
38
+ ]
36
39
  # Framework adapters are optional; the CLI, store SDK, and HTTP runtime install by default.
37
40
  langgraph = [
38
41
  "databricks-langchain==0.21.0",