vis-agent 0.5.19.dev9137__tar.gz → 0.5.19.dev9166__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 (180) hide show
  1. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/PKG-INFO +1 -1
  2. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/config.json +15 -1
  3. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/gateway.json +164 -2
  4. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/pyproject.toml +1 -1
  5. vis_agent-0.5.19.dev9166/release-tag +1 -0
  6. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/__init__.py +2 -0
  7. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_agent.py +5 -3
  8. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_client.py +199 -8
  9. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_host.py +2 -2
  10. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_local.py +2 -1
  11. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/views.py +1 -0
  12. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_api_guides.py +1 -1
  13. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_client.py +113 -0
  14. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_contracts.py +4 -4
  15. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_sdk_typing.py +41 -2
  16. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_views.py +15 -0
  17. vis_agent-0.5.19.dev9137/release-tag +0 -1
  18. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/.gitignore +0 -0
  19. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/LICENSE +0 -0
  20. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/README.md +0 -0
  21. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-arguments.json +0 -0
  22. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-cases.json +0 -0
  23. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-copy.json +0 -0
  24. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-execution.json +0 -0
  25. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-groups.json +0 -0
  26. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-read-session.json +0 -0
  27. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-reads.json +0 -0
  28. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-results.json +0 -0
  29. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-stream.json +0 -0
  30. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity-tables.json +0 -0
  31. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/activity.json +0 -0
  32. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/app-log.json +0 -0
  33. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/app-pictures.json +0 -0
  34. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/attachment-reference.json +0 -0
  35. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/attachment-verbs.json +0 -0
  36. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/diff.json +0 -0
  37. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/live-primitives.json +0 -0
  38. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/live-view-checks.json +0 -0
  39. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/message-links.json +0 -0
  40. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/session-health.json +0 -0
  41. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/setting-models.json +0 -0
  42. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/setting-presets.json +0 -0
  43. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/shell-handle.json +0 -0
  44. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/team-updated.json +0 -0
  45. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/fixtures/view.json +0 -0
  46. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/activity.json +0 -0
  47. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/agents.json +0 -0
  48. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/automations.json +0 -0
  49. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/common.json +0 -0
  50. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/content.json +0 -0
  51. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/council.json +0 -0
  52. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/diff.json +0 -0
  53. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/evals.json +0 -0
  54. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/keymap.json +0 -0
  55. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/provider.json +0 -0
  56. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/symbol.json +0 -0
  57. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/toggle.json +0 -0
  58. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/contracts/schema/view.json +0 -0
  59. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/examples/greeter/tests/test_greeter.py +0 -0
  60. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/hatch_build.py +0 -0
  61. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/__init__.py +0 -0
  62. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/_contracts.py +0 -0
  63. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/_outside.py +0 -0
  64. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/_wire.py +0 -0
  65. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/activity.py +0 -0
  66. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_agents.py +0 -0
  67. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_council.py +0 -0
  68. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_extensions.py +0 -0
  69. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_groups.py +0 -0
  70. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_install.py +0 -0
  71. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_models.py +0 -0
  72. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_sounds.py +0 -0
  73. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/engine/_speech.py +0 -0
  74. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/__init__.py +0 -0
  75. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/_gateway.py +0 -0
  76. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/agent.py +0 -0
  77. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/bench.py +0 -0
  78. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/check.py +0 -0
  79. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/compare.py +0 -0
  80. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/environment.py +0 -0
  81. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/grade.py +0 -0
  82. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/harbor.py +0 -0
  83. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/judge-rubric.toml +0 -0
  84. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/judge.py +0 -0
  85. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/labels.py +0 -0
  86. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/leaderboard.py +0 -0
  87. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/lic.py +0 -0
  88. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/longmemeval.py +0 -0
  89. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/mrcr.py +0 -0
  90. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/repeats.py +0 -0
  91. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/report.py +0 -0
  92. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/reports.py +0 -0
  93. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/rounds.py +0 -0
  94. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/stages.py +0 -0
  95. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/stats.py +0 -0
  96. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/evals/trajectory.py +0 -0
  97. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/extension.py +0 -0
  98. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/extension_package.py +0 -0
  99. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/live_check.py +0 -0
  100. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/src/blockether/vis/py.typed +0 -0
  101. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/conftest.py +0 -0
  102. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/evals_atif.py +0 -0
  103. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_activity.py +0 -0
  104. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_agent.py +0 -0
  105. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_agent_extension_lifecycle.py +0 -0
  106. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_agent_extensions.py +0 -0
  107. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_agents.py +0 -0
  108. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_app_attachments.py +0 -0
  109. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_app_door.py +0 -0
  110. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_app_images.py +0 -0
  111. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_attach_parity.py +0 -0
  112. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_attachments.py +0 -0
  113. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_authoring.py +0 -0
  114. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_automations.py +0 -0
  115. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_catalog.py +0 -0
  116. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_catalog_recipe.py +0 -0
  117. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_ci_report_recipe.py +0 -0
  118. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_client_extensions_engine.py +0 -0
  119. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_code_quality_recipe.py +0 -0
  120. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_contract_catalogs.py +0 -0
  121. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_council.py +0 -0
  122. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_declarations.py +0 -0
  123. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_engine.py +0 -0
  124. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_engine_docstrings.py +0 -0
  125. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_agent.py +0 -0
  126. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_bench.py +0 -0
  127. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_check.py +0 -0
  128. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_compare.py +0 -0
  129. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_environment.py +0 -0
  130. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_gateway.py +0 -0
  131. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_grade.py +0 -0
  132. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_guards.py +0 -0
  133. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_harbor.py +0 -0
  134. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_judge.py +0 -0
  135. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_labels.py +0 -0
  136. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_lic.py +0 -0
  137. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_longmemeval.py +0 -0
  138. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_mrcr.py +0 -0
  139. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_repeats.py +0 -0
  140. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_report.py +0 -0
  141. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_rounds.py +0 -0
  142. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_stages.py +0 -0
  143. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_stats.py +0 -0
  144. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_tasks.py +0 -0
  145. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_evals_trajectory.py +0 -0
  146. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_extension_package.py +0 -0
  147. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_extension_reference.py +0 -0
  148. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_gateway_performance.py +0 -0
  149. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_goals.py +0 -0
  150. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_install.py +0 -0
  151. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_keybindings.py +0 -0
  152. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_live_check.py +0 -0
  153. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_live_primitives.py +0 -0
  154. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_live_view_checks.py +0 -0
  155. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_live_wait.py +0 -0
  156. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_local.py +0 -0
  157. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_method_typing.py +0 -0
  158. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_models.py +0 -0
  159. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_monitor_recipe.py +0 -0
  160. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_namespace.py +0 -0
  161. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_outside.py +0 -0
  162. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_private_file.py +0 -0
  163. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_providers.py +0 -0
  164. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_read_session.py +0 -0
  165. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_record_arguments.py +0 -0
  166. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_registration.py +0 -0
  167. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_repair_hooks.py +0 -0
  168. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_result_sequence.py +0 -0
  169. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_scoped_settings.py +0 -0
  170. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_sdk_guide.py +0 -0
  171. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_shell_contract.py +0 -0
  172. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_shell_handle.py +0 -0
  173. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_shortcuts_live.py +0 -0
  174. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_sounds.py +0 -0
  175. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_speech.py +0 -0
  176. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_structured_live.py +0 -0
  177. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_symbol_contract.py +0 -0
  178. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_testing.py +0 -0
  179. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_text_list_arguments.py +0 -0
  180. {vis_agent-0.5.19.dev9137 → vis_agent-0.5.19.dev9166}/tests/test_tools.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: vis-agent
3
- Version: 0.5.19.dev9137
3
+ Version: 0.5.19.dev9166
4
4
  Summary: The Vis Python SDK — author extensions and control local or remote engines.
5
5
  Project-URL: Homepage, https://vis.blockether.com
6
6
  Project-URL: Documentation, https://vis.blockether.com
@@ -1413,10 +1413,24 @@
1413
1413
  "minLength": 1,
1414
1414
  "maxLength": 80,
1415
1415
  "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f-\\u009f]+$",
1416
- "description": "Coding-agent name shared by the JVM prompt and gateway clients. Defaults to Vis."
1416
+ "description": "Coding-agent name shared by the JVM prompt and gateway clients. Defaults to Vis. The environment variable VIS_AGENT_NAME overrides it and locks it."
1417
+ },
1418
+ "agent_name_locked": {
1419
+ "type": "boolean",
1420
+ "description": "Only in the machine configuration. true makes the machine `agent_name` the only name of the agent: no project changes it and no client can rename the agent."
1421
+ },
1422
+ "machine_name": {
1423
+ "$ref": "#/$defs/machineName"
1417
1424
  }
1418
1425
  },
1419
1426
  "additionalProperties": false
1427
+ },
1428
+ "machineName": {
1429
+ "type": "string",
1430
+ "minLength": 1,
1431
+ "maxLength": 64,
1432
+ "pattern": "^(?=.*\\S)[^\\u0000-\\u001f\\u007f-\\u009f]+$",
1433
+ "description": "Name of this machine that the gateway reports to its clients. The environment variable VIS_MACHINE_NAME overrides it. Without a name, a client shows the host of the gateway address."
1420
1434
  }
1421
1435
  },
1422
1436
  "$ref": "#/$defs/config"
@@ -73,7 +73,8 @@
73
73
  "operations": {
74
74
  "get": {
75
75
  "request": "none",
76
- "response": "json"
76
+ "response": "json",
77
+ "response_schema": "health"
77
78
  }
78
79
  },
79
80
  "path": "/healthz"
@@ -103,7 +104,8 @@
103
104
  "operations": {
104
105
  "get": {
105
106
  "request": "none",
106
- "response": "json"
107
+ "response": "json",
108
+ "response_schema": "health"
107
109
  }
108
110
  },
109
111
  "path": "/readyz"
@@ -1801,6 +1803,27 @@
1801
1803
  },
1802
1804
  "path": "/v1/web/launches/redeem"
1803
1805
  },
1806
+ {
1807
+ "audience": "sdk",
1808
+ "operations": {
1809
+ "get": {
1810
+ "request": "none",
1811
+ "response": "json",
1812
+ "response_schema": "web_brand"
1813
+ },
1814
+ "put": {
1815
+ "request": "json",
1816
+ "response": "json",
1817
+ "request_schema": "web_brand",
1818
+ "response_schema": "web_brand"
1819
+ },
1820
+ "delete": {
1821
+ "request": "none",
1822
+ "response": "empty"
1823
+ }
1824
+ },
1825
+ "path": "/v1/web/brand"
1826
+ },
1804
1827
  {
1805
1828
  "audience": "sdk",
1806
1829
  "path": "/v1/automations",
@@ -2030,6 +2053,133 @@
2030
2053
  },
2031
2054
  "require_token": {
2032
2055
  "type": "boolean"
2056
+ },
2057
+ "machine_name": {
2058
+ "$ref": "config.json#/$defs/machineName"
2059
+ }
2060
+ }
2061
+ },
2062
+ "health": {
2063
+ "description": "The answer of /healthz and /readyz: the stable id of the gateway, its protocol and the machine name that its operator set. A gateway without a name omits machine_name. The answer also carries process counters that have no contract.",
2064
+ "type": "object",
2065
+ "required": [
2066
+ "status",
2067
+ "id",
2068
+ "protocol"
2069
+ ],
2070
+ "properties": {
2071
+ "status": {
2072
+ "const": "ok"
2073
+ },
2074
+ "id": {
2075
+ "type": "string",
2076
+ "minLength": 1
2077
+ },
2078
+ "protocol": {
2079
+ "$ref": "#/$defs/handshake"
2080
+ },
2081
+ "machine_name": {
2082
+ "$ref": "config.json#/$defs/machineName"
2083
+ },
2084
+ "require_token": {
2085
+ "type": "boolean"
2086
+ },
2087
+ "secret_match": {
2088
+ "type": "boolean"
2089
+ }
2090
+ }
2091
+ },
2092
+ "web_brand": {
2093
+ "description": "The white label of the web app that this gateway serves. An absent key keeps the Vis default. A GET needs no token, because the app shows the brand before it connects.",
2094
+ "type": "object",
2095
+ "additionalProperties": false,
2096
+ "properties": {
2097
+ "name": {
2098
+ "description": "The name beside the logo and in the page title.",
2099
+ "type": "string",
2100
+ "minLength": 1,
2101
+ "maxLength": 24
2102
+ },
2103
+ "logo": {
2104
+ "description": "The picture of the brand: an `https://` address, a path of the web app, or a base64 `data:image/` URL of a PNG, JPEG, WebP or SVG picture.",
2105
+ "type": "string",
2106
+ "maxLength": 262144,
2107
+ "pattern": "^(https://|/[^/]|data:image/(png|jpeg|webp|svg\\+xml);base64,)"
2108
+ },
2109
+ "href": {
2110
+ "description": "The address that the logo opens.",
2111
+ "$ref": "#/$defs/web_brand_href"
2112
+ },
2113
+ "links": {
2114
+ "description": "The icon links of the header, in order.",
2115
+ "type": "array",
2116
+ "maxItems": 6,
2117
+ "items": {
2118
+ "$ref": "#/$defs/web_brand_link"
2119
+ }
2120
+ },
2121
+ "theme": {
2122
+ "$ref": "#/$defs/web_brand_theme"
2123
+ }
2124
+ }
2125
+ },
2126
+ "web_brand_href": {
2127
+ "type": "string",
2128
+ "maxLength": 2048,
2129
+ "pattern": "^https?://"
2130
+ },
2131
+ "web_brand_link": {
2132
+ "description": "One icon link of the header. It opens in a new tab.",
2133
+ "type": "object",
2134
+ "additionalProperties": false,
2135
+ "required": [
2136
+ "icon",
2137
+ "label",
2138
+ "href"
2139
+ ],
2140
+ "properties": {
2141
+ "icon": {
2142
+ "$ref": "view.json#/$defs/app_icon"
2143
+ },
2144
+ "label": {
2145
+ "description": "The accessible name and the tooltip of the link.",
2146
+ "type": "string",
2147
+ "minLength": 1,
2148
+ "maxLength": 40
2149
+ },
2150
+ "href": {
2151
+ "$ref": "#/$defs/web_brand_href"
2152
+ }
2153
+ }
2154
+ },
2155
+ "web_brand_theme": {
2156
+ "description": "The only theme of the web app. While a brand has one, the app shows no theme choice. `base` names a theme that the app ships. `colors` replaces CSS variables of that theme.",
2157
+ "type": "object",
2158
+ "additionalProperties": false,
2159
+ "required": [
2160
+ "base"
2161
+ ],
2162
+ "properties": {
2163
+ "label": {
2164
+ "type": "string",
2165
+ "minLength": 1,
2166
+ "maxLength": 40
2167
+ },
2168
+ "base": {
2169
+ "type": "string",
2170
+ "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
2171
+ "maxLength": 64
2172
+ },
2173
+ "colors": {
2174
+ "type": "object",
2175
+ "maxProperties": 128,
2176
+ "propertyNames": {
2177
+ "pattern": "^--[a-z0-9]+(-[a-z0-9]+)*$"
2178
+ },
2179
+ "additionalProperties": {
2180
+ "type": "string",
2181
+ "pattern": "^#[0-9a-fA-F]{6}$"
2182
+ }
2033
2183
  }
2034
2184
  }
2035
2185
  },
@@ -3692,6 +3842,14 @@
3692
3842
  "type": "integer",
3693
3843
  "minimum": 1
3694
3844
  },
3845
+ "is_optional": {
3846
+ "type": "boolean",
3847
+ "description": "A string row that accepts a blank value. A blank value removes the saved value."
3848
+ },
3849
+ "lock_reason": {
3850
+ "type": "string",
3851
+ "description": "Present when a client cannot change this row. The text tells a person why. A client shows the row read-only."
3852
+ },
3695
3853
  "inheritance": {
3696
3854
  "$ref": "toggle.json#/$defs/contribution/properties/inheritance"
3697
3855
  },
@@ -3935,6 +4093,10 @@
3935
4093
  },
3936
4094
  "value": {
3937
4095
  "$ref": "#/$defs/setting_value"
4096
+ },
4097
+ "is_locked": {
4098
+ "type": "boolean",
4099
+ "description": "Only for `agent_name`, with the value action. true saves the name and locks it: the gateway then answers 409 to a write without this key. false saves the name and removes the lock."
3938
4100
  }
3939
4101
  },
3940
4102
  "allOf": [
@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
8
8
 
9
9
  [project]
10
10
  name = "vis-agent"
11
- version = "0.5.19.dev9137"
11
+ version = "0.5.19.dev9166"
12
12
  description = "The Vis Python SDK — author extensions and control local or remote engines."
13
13
  readme = "README.md"
14
14
  requires-python = ">=3.12"
@@ -0,0 +1 @@
1
+ beta-fcc6a3566cfca98269b9a33b703ec908e17b8913
@@ -20,6 +20,7 @@ from ._client import (
20
20
  Query,
21
21
  Response,
22
22
  Session,
23
+ SessionOptions,
23
24
  TransportError,
24
25
  Turn,
25
26
  VisTimeout,
@@ -69,6 +70,7 @@ __all__ = [
69
70
  "Session",
70
71
  "SessionGroup",
71
72
  "SessionModel",
73
+ "SessionOptions",
72
74
  "SoundPreset",
73
75
  "Sounds",
74
76
  "SoundSettings",
@@ -4,7 +4,7 @@ import json
4
4
  import math
5
5
  import re
6
6
  import time
7
- from collections.abc import Callable
7
+ from collections.abc import Callable, Mapping
8
8
  from functools import lru_cache
9
9
  from itertools import islice
10
10
  from typing import Any, TypeVar, overload
@@ -239,7 +239,7 @@ def _syntax_message(answer: str, error: json.JSONDecodeError) -> str:
239
239
  return f"not valid JSON: {error.msg} at {where}"
240
240
 
241
241
 
242
- def final_answer(turn: dict) -> str | None:
242
+ def final_answer(turn: Mapping[str, object]) -> str | None:
243
243
  """Return the final answer text of the turn record `turn`, or None.
244
244
 
245
245
  A turn record has no `answer` field. The answer is the Markdown of the last
@@ -487,7 +487,9 @@ class Agent:
487
487
  self.execution_layer = (
488
488
  LocalEngine(root=project) if execution_layer is None else execution_layer
489
489
  )
490
- self._session_options = self.execution_layer.session_options(project)
490
+ self._session_options: dict[str, Any] = dict(
491
+ self.execution_layer.session_options(project)
492
+ )
491
493
  if tools is not None:
492
494
  self._session_options["tools"] = tools
493
495
  self.project = self._session_options["root"]
@@ -18,7 +18,15 @@ from abc import ABC, abstractmethod
18
18
  from collections.abc import Iterable, Mapping
19
19
  from dataclasses import dataclass, field
20
20
  from pathlib import PurePosixPath
21
- from typing import TYPE_CHECKING, Any, BinaryIO, TypeAlias, overload
21
+ from typing import (
22
+ TYPE_CHECKING,
23
+ Any,
24
+ BinaryIO,
25
+ NotRequired,
26
+ TypeAlias,
27
+ TypedDict,
28
+ overload,
29
+ )
22
30
  from urllib.error import HTTPError, URLError
23
31
  from urllib.parse import quote, urlencode, urlsplit
24
32
  from urllib.request import HTTPRedirectHandler, Request, build_opener
@@ -39,6 +47,18 @@ JSONValue: TypeAlias = (
39
47
  )
40
48
  Query: TypeAlias = Mapping[str, str | int | float | bool | None]
41
49
 
50
+
51
+ class SessionOptions(TypedDict):
52
+ """The session creation options of a project, from `session_options`.
53
+
54
+ Give them to `create_session` with `**`. `root` is the folder that the
55
+ session works in. `channel` names the kind of client.
56
+ """
57
+
58
+ root: str
59
+ channel: NotRequired[str]
60
+
61
+
42
62
  _PROTOCOL = definition("gateway", "handshake")["properties"]["protocol"]["const"]
43
63
  _MIN_GATEWAY = definition("gateway", "handshake")["properties"]["min_gateway"]["const"]
44
64
  _ROUTES = schema("gateway")["x-vis-routes"]
@@ -190,6 +210,26 @@ def _group(data: Any) -> SessionGroup:
190
210
  raise ProtocolError("invalid session group response") from None
191
211
 
192
212
 
213
+ def _agent_name(row: Any) -> str:
214
+ """The name of an `agent_name` setting answer."""
215
+ if not isinstance(row, dict) or row.get("id") != "agent_name":
216
+ raise ProtocolError("invalid agent_name setting answer")
217
+ value = row.get("value")
218
+ if not isinstance(value, str) or not value.strip():
219
+ raise ProtocolError("invalid agent_name setting answer")
220
+ return value.strip()
221
+
222
+
223
+ def _machine_name(row: Any) -> str | None:
224
+ """The effective name of a `machine_name` setting answer. Blank is no name."""
225
+ if not isinstance(row, dict) or row.get("id") != "machine_name":
226
+ raise ProtocolError("invalid machine_name setting answer")
227
+ value = row.get("value")
228
+ if value is not None and not isinstance(value, str):
229
+ raise ProtocolError("invalid machine_name setting answer")
230
+ return (value or "").strip() or None
231
+
232
+
193
233
  def _field(data: Any, name: str, kind: type) -> Any:
194
234
  """Validate a consumed field without reflecting a potentially sensitive body."""
195
235
  value = data.get(name) if isinstance(data, dict) else None
@@ -340,7 +380,7 @@ class ExecutionLayer(ABC):
340
380
  """Release this layer's resources without deleting remote sessions."""
341
381
 
342
382
  @abstractmethod
343
- def session_options(self, project=".") -> dict[str, JSONValue]:
383
+ def session_options(self, project=".") -> SessionOptions:
344
384
  """Validate a project and return its wire-ready session creation options."""
345
385
 
346
386
  @abstractmethod
@@ -524,14 +564,69 @@ class ExecutionLayer(ABC):
524
564
  validate("view", "operator_action", body)
525
565
  return self.post_app_actions(view_id, body=body)
526
566
 
567
+ def web_brand(self) -> dict[str, JSONValue]:
568
+ """Read the white label of the web app that this gateway serves.
569
+
570
+ The answer has only the keys that are set: `name`, `logo`, `href`,
571
+ `links` and `theme`. An empty answer means the Vis default.
572
+ """
573
+ brand = self.get_web_brand()
574
+ if not isinstance(brand, dict):
575
+ raise ProtocolError("invalid web brand response")
576
+ return brand
577
+
578
+ def set_web_brand(
579
+ self,
580
+ *,
581
+ name: str | None = None,
582
+ logo: str | None = None,
583
+ href: str | None = None,
584
+ links: Iterable[Mapping[str, str]] | None = None,
585
+ theme: Mapping[str, JSONValue] | None = None,
586
+ ) -> dict[str, JSONValue]:
587
+ """Replace the white label of the web app that this gateway serves.
588
+
589
+ `name` shows beside the logo and in the page title. `logo` is an
590
+ `https://` address, a path of the web app or a base64 `data:image/`
591
+ URL. `href` is the address that the logo opens. `links` are the icon
592
+ links of the header: each has `icon` (an app icon name), `label` and
593
+ `href`. `theme` makes one theme the only theme, and the app then shows
594
+ no theme choice: `base` names a shipped theme, `colors` replaces its
595
+ CSS variables and `label` names it.
596
+
597
+ The call replaces the whole brand: an argument that is None goes back
598
+ to the Vis default. An open page shows the new brand after a reload.
599
+ Answers the saved brand.
600
+ """
601
+ body: dict[str, JSONValue] = {}
602
+ if name is not None:
603
+ body["name"] = name
604
+ if logo is not None:
605
+ body["logo"] = logo
606
+ if href is not None:
607
+ body["href"] = href
608
+ if links is not None:
609
+ body["links"] = [{**link} for link in links]
610
+ if theme is not None:
611
+ body["theme"] = {**theme}
612
+ validate("gateway", "web_brand", body)
613
+ brand = self.put_web_brand(body=body)
614
+ if not isinstance(brand, dict):
615
+ raise ProtocolError("invalid web brand response")
616
+ return brand
617
+
618
+ def clear_web_brand(self) -> None:
619
+ """Remove the white label: the web app shows the Vis default again."""
620
+ self.delete_web_brand()
621
+
527
622
  def create_session(
528
623
  self,
529
624
  *,
530
625
  provider: str | None = None,
531
626
  model: str | None = None,
532
627
  group: SessionGroup | str | None = None,
533
- timeout=None,
534
- **options,
628
+ timeout: float | None = None,
629
+ **options: object,
535
630
  ) -> Session:
536
631
  """Create a conversation and return a `Session` handle.
537
632
 
@@ -664,6 +759,67 @@ class ExecutionLayer(ABC):
664
759
  mode = "delete" if delete_sessions else "detach"
665
760
  return self.delete_session_group(_group_id(group), query={"sessions": mode})
666
761
 
762
+ def agent_name(self) -> str:
763
+ """Return the name that the gateway gives to the agent.
764
+
765
+ This is the name for a session without a project name. The environment
766
+ variable `VIS_AGENT_NAME` of the gateway and a locked name are the name
767
+ of the agent in each project.
768
+ """
769
+ return _agent_name(self.get_setting("agent_name", query={"scope": "global"}))
770
+
771
+ def set_agent_name(self, name: str, *, locked: bool | None = None) -> str:
772
+ """Save the agent name of the gateway and return the name in effect.
773
+
774
+ `locked=True` also locks the name: it is then the only name of the
775
+ agent, no project changes it and no client can rename the agent.
776
+ `locked=False` removes the lock. Without `locked`, the lock stays as it
777
+ is, and the gateway refuses the change of a locked name with
778
+ `GatewayError` (status 409). While `VIS_AGENT_NAME` is set on the
779
+ gateway, the gateway refuses each change in the same way.
780
+ """
781
+ if not isinstance(name, str):
782
+ raise TypeError("an agent name must be text")
783
+ if locked is not None and not isinstance(locked, bool):
784
+ raise TypeError("locked must be True, False or None")
785
+ body: dict[str, JSONValue] = {
786
+ "scope": "global",
787
+ "id": "agent_name",
788
+ "action": "value",
789
+ "value": name.strip(),
790
+ }
791
+ if locked is not None:
792
+ body["is_locked"] = locked
793
+ return _agent_name(self.post_settings(body=body))
794
+
795
+ def machine_name(self) -> str | None:
796
+ """Return the name of the gateway machine, or None when it has no name.
797
+
798
+ Clients show this name for the machine in place of the host of its URL.
799
+ The environment variable `VIS_MACHINE_NAME` of the gateway wins over the
800
+ saved name.
801
+ """
802
+ return _machine_name(
803
+ self.get_setting("machine_name", query={"scope": "global"})
804
+ )
805
+
806
+ def set_machine_name(self, name: str | None) -> str | None:
807
+ """Save the name of the gateway machine and return the name in effect.
808
+
809
+ None or a blank name removes the saved name. The gateway refuses a name
810
+ that is too long or has control characters with `GatewayError`. When
811
+ `VIS_MACHINE_NAME` is set on the gateway, the answer is still the name
812
+ from that variable: the saved name applies when the variable is not set.
813
+ """
814
+ if name is not None and not isinstance(name, str):
815
+ raise TypeError("a machine name must be text or None")
816
+ body: dict[str, JSONValue] = {"scope": "global", "id": "machine_name"}
817
+ if name is None or not name.strip():
818
+ body["action"] = "inherit"
819
+ else:
820
+ body.update(action="value", value=name.strip())
821
+ return _machine_name(self.post_settings(body=body))
822
+
667
823
  def restore_session(
668
824
  self,
669
825
  data: bytes,
@@ -2529,6 +2685,35 @@ class ExecutionLayer(ABC):
2529
2685
  )
2530
2686
  return response.json()
2531
2687
 
2688
+ def get_web_brand(
2689
+ self, *, query: Query | None = None, timeout: float | None = None
2690
+ ) -> JSONValue:
2691
+ """GET /v1/web/brand — json response."""
2692
+ response = self._request(
2693
+ "GET", "/v1/web/brand", path={}, query=query, timeout=timeout
2694
+ )
2695
+ return response.json()
2696
+
2697
+ def put_web_brand(
2698
+ self,
2699
+ *,
2700
+ query: Query | None = None,
2701
+ timeout: float | None = None,
2702
+ body: JSONValue = None,
2703
+ ) -> JSONValue:
2704
+ """PUT /v1/web/brand — json response."""
2705
+ response = self._request(
2706
+ "PUT", "/v1/web/brand", path={}, query=query, timeout=timeout, body=body
2707
+ )
2708
+ return response.json()
2709
+
2710
+ def delete_web_brand(
2711
+ self, *, query: Query | None = None, timeout: float | None = None
2712
+ ) -> None:
2713
+ """DELETE /v1/web/brand — empty response."""
2714
+ self._request("DELETE", "/v1/web/brand", path={}, query=query, timeout=timeout)
2715
+ return None
2716
+
2532
2717
  def post_session_voice(
2533
2718
  self,
2534
2719
  sid: str,
@@ -3612,7 +3797,7 @@ class GatewayClient(ExecutionLayer):
3612
3797
  self._lease = None
3613
3798
  self._token = None
3614
3799
 
3615
- def session_options(self, project=".") -> dict[str, JSONValue]:
3800
+ def session_options(self, project=".") -> SessionOptions:
3616
3801
  """Prepare an app-channel session using a path on the gateway machine."""
3617
3802
  path = PurePosixPath(project)
3618
3803
  if not path.is_absolute():
@@ -3681,7 +3866,7 @@ class Session:
3681
3866
  self.client._pump_client_extensions(self.id)
3682
3867
  return self._call("GET")
3683
3868
 
3684
- def update(self, **fields):
3869
+ def update(self, **fields: object) -> JSONValue:
3685
3870
  """Patch session fields and return the engine's JSON response.
3686
3871
 
3687
3872
  Field names and validation follow the gateway session-update contract.
@@ -3707,7 +3892,9 @@ class Session:
3707
3892
  """
3708
3893
  return self._call("DELETE")
3709
3894
 
3710
- def turns(self, **query):
3895
+ def turns(
3896
+ self, **query: str | int | float | bool | None
3897
+ ) -> list[dict[str, JSONValue]]:
3711
3898
  """Read turn history, or the queued subset with status='queued'."""
3712
3899
  return _field(self._call("GET", "/turns", query=query), "turns", list)
3713
3900
 
@@ -3829,7 +4016,11 @@ class Session:
3829
4016
  return self.send(f"/goal {budget}-- {objective.strip()}", **options)
3830
4017
 
3831
4018
  def send(
3832
- self, request: str, *, idempotency_key: str | None = None, **options
4019
+ self,
4020
+ request: str,
4021
+ *,
4022
+ idempotency_key: str | None = None,
4023
+ **options: object,
3833
4024
  ) -> Turn:
3834
4025
  """Submit a user message or slash command and return its `Turn` handle.
3835
4026
 
@@ -14,8 +14,8 @@ from pathlib import PurePosixPath
14
14
 
15
15
  from ._client import (
16
16
  ExecutionLayer,
17
- JSONValue,
18
17
  ProtocolError,
18
+ SessionOptions,
19
19
  TransportError,
20
20
  )
21
21
  from ._local import _envelope, _LocalJobEvents, _LocalSession, _reply, _request_frame
@@ -45,7 +45,7 @@ class HostLayer(ExecutionLayer):
45
45
  self._closed = True
46
46
  self._clear_client_extensions()
47
47
 
48
- def session_options(self, project=".") -> dict[str, JSONValue]:
48
+ def session_options(self, project=".") -> SessionOptions:
49
49
  """Prepare an app-channel session for an absolute path on the host machine."""
50
50
  path = PurePosixPath(project)
51
51
  if not path.is_absolute():
@@ -30,6 +30,7 @@ from ._client import (
30
30
  JobEvents,
31
31
  ProtocolError,
32
32
  Session,
33
+ SessionOptions,
33
34
  TransportError,
34
35
  VisTimeout,
35
36
  _duration,
@@ -155,7 +156,7 @@ class LocalEngine(ExecutionLayer):
155
156
  # The stdio frames carry no request ids, so only one exchange can be in flight.
156
157
  self._exchange = threading.RLock()
157
158
 
158
- def session_options(self, project=".") -> dict:
159
+ def session_options(self, project=".") -> SessionOptions:
159
160
  """Resolve an existing local directory before the caller changes directory."""
160
161
  path = Path(project).resolve(strict=True)
161
162
  if not path.is_dir():
@@ -90,6 +90,7 @@ class LiveView(_ViewRecord):
90
90
  shortcuts: tuple[Mapping[str, Any], ...] | None = None
91
91
  agent_note: str | None = None
92
92
  surfaces: Mapping[str, Any] | None = None
93
+ icon: str | None = None
93
94
  settings_key: str | None = None
94
95
  scope: str | None = None
95
96
  is_persistent: bool | None = None
@@ -93,7 +93,7 @@ _CONCEPTS = sorted(
93
93
 
94
94
  def test_pages_name_gateway_routes_only_on_http_pages():
95
95
  # An empty topic list once turned the parametrized cases below into zero cases.
96
- assert len(_CONCEPTS) == 9, f"merged API pages found: {_CONCEPTS}"
96
+ assert len(_CONCEPTS) == 10, f"merged API pages found: {_CONCEPTS}"
97
97
  for page in _PAGES:
98
98
  if page.name == "http-api.md":
99
99
  continue