robot_lab 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (242) hide show
  1. checksums.yaml +4 -4
  2. data/.architecture/AGENTS.md +32 -0
  3. data/.architecture/config.yml +8 -0
  4. data/.architecture/members.yml +60 -0
  5. data/.architecture/reviews/feature-free-will.md +490 -0
  6. data/.architecture/reviews/overall-codebase.md +427 -0
  7. data/.claude/settings.local.json +57 -0
  8. data/.codex/config.toml +2 -0
  9. data/.irbrc +2 -2
  10. data/.rubocop.yml +172 -0
  11. data/CHANGELOG.md +72 -0
  12. data/CLAUDE.md +139 -0
  13. data/README.md +91 -95
  14. data/Rakefile +109 -3
  15. data/agent2agent_review.md +192 -0
  16. data/agentf_improvements.md +253 -0
  17. data/agents.md +14 -0
  18. data/docs/examples/index.md +37 -2
  19. data/docs/getting-started/configuration.md +20 -7
  20. data/docs/guides/index.md +16 -16
  21. data/docs/guides/knowledge.md +7 -1
  22. data/docs/guides/observability.md +132 -0
  23. data/docs/index.md +30 -3
  24. data/docs/superpowers/plans/2026-05-06-agentskills.md +1303 -0
  25. data/docs/superpowers/specs/2026-05-06-agentskills-design.md +247 -0
  26. data/examples/.envrc +1 -0
  27. data/examples/01_simple_robot.rb +5 -9
  28. data/examples/02_tools.rb +5 -9
  29. data/examples/03_network.rb +8 -9
  30. data/examples/04_mcp.rb +21 -29
  31. data/examples/05_streaming.rb +12 -18
  32. data/examples/06_prompt_templates.rb +11 -19
  33. data/examples/07_network_memory.rb +16 -31
  34. data/examples/08_llm_config.rb +10 -22
  35. data/examples/09_chaining.rb +16 -27
  36. data/examples/10_memory.rb +12 -28
  37. data/examples/11_network_introspection.rb +15 -29
  38. data/examples/12_message_bus.rb +5 -12
  39. data/examples/13_spawn.rb +5 -10
  40. data/examples/14_rusty_circuit/.envrc +1 -0
  41. data/examples/14_rusty_circuit/comic.rb +2 -0
  42. data/examples/14_rusty_circuit/heckler.rb +1 -1
  43. data/examples/14_rusty_circuit/open_mic.rb +1 -3
  44. data/examples/14_rusty_circuit/scout.rb +2 -0
  45. data/examples/15_memory_network_and_bus/.envrc +1 -0
  46. data/examples/15_memory_network_and_bus/editorial_pipeline.rb +6 -3
  47. data/examples/15_memory_network_and_bus/linux_writer.rb +1 -1
  48. data/examples/15_memory_network_and_bus/output/combined_article.md +6 -6
  49. data/examples/15_memory_network_and_bus/output/final_article.md +6 -8
  50. data/examples/15_memory_network_and_bus/output/linux_draft.md +4 -2
  51. data/examples/15_memory_network_and_bus/output/mac_draft.md +3 -3
  52. data/examples/15_memory_network_and_bus/output/memory.json +6 -6
  53. data/examples/15_memory_network_and_bus/output/revision_1.md +10 -11
  54. data/examples/15_memory_network_and_bus/output/revision_2.md +6 -8
  55. data/examples/15_memory_network_and_bus/output/windows_draft.md +3 -3
  56. data/examples/16_writers_room/.envrc +1 -0
  57. data/examples/16_writers_room/writers_room.rb +2 -4
  58. data/examples/17_skills.rb +8 -17
  59. data/examples/18_rails/Gemfile +1 -0
  60. data/examples/19_token_tracking.rb +9 -15
  61. data/examples/20_circuit_breaker.rb +10 -19
  62. data/examples/21_learning_loop.rb +11 -20
  63. data/examples/22_context_compression.rb +6 -13
  64. data/examples/23_convergence.rb +6 -17
  65. data/examples/24_structured_delegation.rb +11 -15
  66. data/examples/25_history_search.rb +5 -12
  67. data/examples/26_document_store.rb +6 -13
  68. data/examples/27_incident_response/incident_response.rb +4 -5
  69. data/examples/28_mcp_discovery.rb +8 -11
  70. data/examples/29_ractor_tools.rb +4 -9
  71. data/examples/30_ractor_network.rb +10 -19
  72. data/examples/31_launch_assessment.rb +10 -23
  73. data/examples/32_newsletter_reader.rb +188 -0
  74. data/examples/33_stock_generator.rb +80 -0
  75. data/examples/33_stock_predictor.rb +306 -0
  76. data/examples/34_agentskills.rb +72 -0
  77. data/examples/README.md +1 -1
  78. data/examples/common.rb +76 -0
  79. data/examples/ruboruby.md +423 -0
  80. data/examples/temp.md +51 -0
  81. data/lib/robot_lab/agent_skill.rb +63 -0
  82. data/lib/robot_lab/agent_skill_catalog.rb +74 -0
  83. data/lib/robot_lab/ask_user.rb +2 -2
  84. data/lib/robot_lab/bus_poller.rb +12 -5
  85. data/lib/robot_lab/config.rb +1 -12
  86. data/lib/robot_lab/delegation_future.rb +1 -1
  87. data/lib/robot_lab/doom_loop_detector.rb +98 -0
  88. data/lib/robot_lab/history_compressor.rb +4 -10
  89. data/lib/robot_lab/mcp/client.rb +1 -2
  90. data/lib/robot_lab/mcp/connection_poller.rb +3 -3
  91. data/lib/robot_lab/mcp/server.rb +1 -1
  92. data/lib/robot_lab/mcp/server_discovery.rb +0 -2
  93. data/lib/robot_lab/memory.rb +32 -27
  94. data/lib/robot_lab/memory_change.rb +2 -2
  95. data/lib/robot_lab/message.rb +4 -4
  96. data/lib/robot_lab/network.rb +11 -6
  97. data/lib/robot_lab/robot/agent_skill_matching.rb +99 -0
  98. data/lib/robot_lab/robot/bus_messaging.rb +9 -27
  99. data/lib/robot_lab/robot/history_search.rb +4 -1
  100. data/lib/robot_lab/robot/mcp_management.rb +5 -11
  101. data/lib/robot_lab/robot/template_rendering.rb +60 -40
  102. data/lib/robot_lab/robot.rb +323 -206
  103. data/lib/robot_lab/robot_result.rb +6 -5
  104. data/lib/robot_lab/run_config.rb +5 -11
  105. data/lib/robot_lab/script_tool.rb +76 -0
  106. data/lib/robot_lab/state_proxy.rb +7 -5
  107. data/lib/robot_lab/tool.rb +3 -3
  108. data/lib/robot_lab/tool_config.rb +1 -1
  109. data/lib/robot_lab/tool_manifest.rb +5 -7
  110. data/lib/robot_lab/user_message.rb +2 -2
  111. data/lib/robot_lab/version.rb +1 -1
  112. data/lib/robot_lab/waiter.rb +1 -1
  113. data/lib/robot_lab.rb +41 -52
  114. data/logfile +8 -0
  115. data/mkdocs.yml +2 -3
  116. data/robot_concurrency.md +38 -0
  117. data/simple_acp_review.md +298 -0
  118. data/site/404.html +2300 -0
  119. data/site/api/core/index.html +2706 -0
  120. data/site/api/core/memory/index.html +3793 -0
  121. data/site/api/core/network/index.html +3500 -0
  122. data/site/api/core/robot/index.html +4566 -0
  123. data/site/api/core/state/index.html +3390 -0
  124. data/site/api/core/tool/index.html +3843 -0
  125. data/site/api/index.html +2635 -0
  126. data/site/api/mcp/client/index.html +3435 -0
  127. data/site/api/mcp/index.html +2783 -0
  128. data/site/api/mcp/server/index.html +3252 -0
  129. data/site/api/mcp/transports/index.html +3352 -0
  130. data/site/api/messages/index.html +2641 -0
  131. data/site/api/messages/text-message/index.html +3087 -0
  132. data/site/api/messages/tool-call-message/index.html +3159 -0
  133. data/site/api/messages/tool-result-message/index.html +3252 -0
  134. data/site/api/messages/user-message/index.html +3212 -0
  135. data/site/api/streaming/context/index.html +3282 -0
  136. data/site/api/streaming/events/index.html +3347 -0
  137. data/site/api/streaming/index.html +2738 -0
  138. data/site/architecture/core-concepts/index.html +3757 -0
  139. data/site/architecture/index.html +2797 -0
  140. data/site/architecture/message-flow/index.html +3238 -0
  141. data/site/architecture/network-orchestration/index.html +3433 -0
  142. data/site/architecture/robot-execution/index.html +3140 -0
  143. data/site/architecture/state-management/index.html +3498 -0
  144. data/site/assets/css/custom.css +56 -0
  145. data/site/assets/images/favicon.png +0 -0
  146. data/site/assets/images/robot_lab.jpg +0 -0
  147. data/site/assets/javascripts/bundle.79ae519e.min.js +16 -0
  148. data/site/assets/javascripts/bundle.79ae519e.min.js.map +7 -0
  149. data/site/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
  150. data/site/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
  151. data/site/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
  152. data/site/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
  153. data/site/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
  154. data/site/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
  155. data/site/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
  156. data/site/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
  157. data/site/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
  158. data/site/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
  159. data/site/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
  160. data/site/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
  161. data/site/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
  162. data/site/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
  163. data/site/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
  164. data/site/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
  165. data/site/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
  166. data/site/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
  167. data/site/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
  168. data/site/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
  169. data/site/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
  170. data/site/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
  171. data/site/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
  172. data/site/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
  173. data/site/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
  174. data/site/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
  175. data/site/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
  176. data/site/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
  177. data/site/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
  178. data/site/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
  179. data/site/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
  180. data/site/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
  181. data/site/assets/javascripts/lunr/tinyseg.js +206 -0
  182. data/site/assets/javascripts/lunr/wordcut.js +6708 -0
  183. data/site/assets/javascripts/workers/search.2c215733.min.js +42 -0
  184. data/site/assets/javascripts/workers/search.2c215733.min.js.map +7 -0
  185. data/site/assets/stylesheets/main.484c7ddc.min.css +1 -0
  186. data/site/assets/stylesheets/main.484c7ddc.min.css.map +1 -0
  187. data/site/assets/stylesheets/palette.ab4e12ef.min.css +1 -0
  188. data/site/assets/stylesheets/palette.ab4e12ef.min.css.map +1 -0
  189. data/site/concepts/index.html +3455 -0
  190. data/site/examples/basic-chat/index.html +2880 -0
  191. data/site/examples/index.html +2907 -0
  192. data/site/examples/mcp-server/index.html +3018 -0
  193. data/site/examples/multi-robot-network/index.html +3131 -0
  194. data/site/examples/rails-application/index.html +3329 -0
  195. data/site/examples/tool-usage/index.html +3085 -0
  196. data/site/getting-started/configuration/index.html +3745 -0
  197. data/site/getting-started/index.html +2572 -0
  198. data/site/getting-started/installation/index.html +2981 -0
  199. data/site/getting-started/quick-start/index.html +2942 -0
  200. data/site/guides/building-robots/index.html +4290 -0
  201. data/site/guides/creating-networks/index.html +3858 -0
  202. data/site/guides/index.html +2586 -0
  203. data/site/guides/mcp-integration/index.html +3581 -0
  204. data/site/guides/memory/index.html +3586 -0
  205. data/site/guides/rails-integration/index.html +4019 -0
  206. data/site/guides/streaming/index.html +3157 -0
  207. data/site/guides/using-tools/index.html +3802 -0
  208. data/site/index.html +2671 -0
  209. data/site/search/search_index.json +1 -0
  210. data/site/sitemap.xml +183 -0
  211. data/site/sitemap.xml.gz +0 -0
  212. data/site/tags.json +1 -0
  213. data/temp.md +6 -0
  214. data/tool_manifest_plan.md +155 -0
  215. metadata +154 -92
  216. data/docs/examples/rails-application.md +0 -419
  217. data/docs/guides/ractor-parallelism.md +0 -364
  218. data/docs/guides/rails-integration.md +0 -681
  219. data/docs/superpowers/plans/2026-04-14-ractor-integration.md +0 -1538
  220. data/docs/superpowers/specs/2026-04-14-ractor-integration-design.md +0 -258
  221. data/lib/generators/robot_lab/install_generator.rb +0 -90
  222. data/lib/generators/robot_lab/job_generator.rb +0 -40
  223. data/lib/generators/robot_lab/robot_generator.rb +0 -55
  224. data/lib/generators/robot_lab/templates/initializer.rb.tt +0 -42
  225. data/lib/generators/robot_lab/templates/job.rb.tt +0 -21
  226. data/lib/generators/robot_lab/templates/migration.rb.tt +0 -32
  227. data/lib/generators/robot_lab/templates/result_model.rb.tt +0 -52
  228. data/lib/generators/robot_lab/templates/robot.rb.tt +0 -31
  229. data/lib/generators/robot_lab/templates/robot_job.rb.tt +0 -18
  230. data/lib/generators/robot_lab/templates/robot_test.rb.tt +0 -34
  231. data/lib/generators/robot_lab/templates/routing_robot.rb.tt +0 -59
  232. data/lib/generators/robot_lab/templates/thread_model.rb.tt +0 -40
  233. data/lib/robot_lab/document_store.rb +0 -155
  234. data/lib/robot_lab/ractor_boundary.rb +0 -42
  235. data/lib/robot_lab/ractor_job.rb +0 -37
  236. data/lib/robot_lab/ractor_memory_proxy.rb +0 -85
  237. data/lib/robot_lab/ractor_network_scheduler.rb +0 -154
  238. data/lib/robot_lab/ractor_worker_pool.rb +0 -117
  239. data/lib/robot_lab/rails_integration/engine.rb +0 -29
  240. data/lib/robot_lab/rails_integration/job.rb +0 -158
  241. data/lib/robot_lab/rails_integration/railtie.rb +0 -51
  242. data/lib/robot_lab/rails_integration/turbo_stream_callbacks.rb +0 -72
data/site/architecture/core-concepts/index.html ADDED
@@ -0,0 +1,3757 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Multi-robot LLM workflow orchestration for Ruby">
10
+
11
+
12
+ <meta name="author" content="Dewayne VanHoozer">
13
+
14
+
15
+ <link rel="canonical" href="https://madbomber.github.io/robot_lab/architecture/core-concepts/">
16
+
17
+
18
+ <link rel="prev" href="../">
19
+
20
+
21
+ <link rel="next" href="../robot-execution/">
22
+
23
+
24
+
25
+
26
+
27
+ <link rel="icon" href="../../assets/images/favicon.png">
28
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
29
+
30
+
31
+
32
+ <title>Core Concepts - RobotLab</title>
33
+
34
+
35
+
36
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
+
38
+
39
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
+
56
+
57
+
58
+ <link rel="stylesheet" href="../../assets/css/custom.css">
59
+
60
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
+
62
+
63
+
64
+
65
+
66
+
67
+
68
+ </head>
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+
77
+
78
+ <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber">
79
+
80
+
81
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
82
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
83
+ <label class="md-overlay" for="__drawer"></label>
84
+ <div data-md-component="skip">
85
+
86
+
87
+ <a href="#core-concepts" class="md-skip">
88
+ Skip to content
89
+ </a>
90
+
91
+ </div>
92
+ <div data-md-component="announce">
93
+
94
+ </div>
95
+
96
+
97
+
98
+
99
+
100
+
101
+ <header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
102
+ <nav class="md-header__inner md-grid" aria-label="Header">
103
+ <a href="../.." title="RobotLab" class="md-header__button md-logo" aria-label="RobotLab" data-md-component="logo">
104
+
105
+
106
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
107
+
108
+ </a>
109
+ <label class="md-header__button md-icon" for="__drawer">
110
+
111
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
112
+ </label>
113
+ <div class="md-header__title" data-md-component="header-title">
114
+ <div class="md-header__ellipsis">
115
+ <div class="md-header__topic">
116
+ <span class="md-ellipsis">
117
+ RobotLab
118
+ </span>
119
+ </div>
120
+ <div class="md-header__topic" data-md-component="header-topic">
121
+ <span class="md-ellipsis">
122
+
123
+ Core Concepts
124
+
125
+ </span>
126
+ </div>
127
+ </div>
128
+ </div>
129
+
130
+
131
+ <form class="md-header__option" data-md-component="palette">
132
+
133
+
134
+
135
+
136
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
137
+
138
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
139
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
140
+ </label>
141
+
142
+
143
+
144
+
145
+
146
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
147
+
148
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
149
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
150
+ </label>
151
+
152
+
153
+ </form>
154
+
155
+
156
+
157
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
158
+
159
+
160
+
161
+
162
+
163
+ <label class="md-header__button md-icon" for="__search">
164
+
165
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
166
+ </label>
167
+ <div class="md-search" data-md-component="search" role="dialog">
168
+ <label class="md-search__overlay" for="__search"></label>
169
+ <div class="md-search__inner" role="search">
170
+ <form class="md-search__form" name="search">
171
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
172
+ <label class="md-search__icon md-icon" for="__search">
173
+
174
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
175
+
176
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
177
+ </label>
178
+ <nav class="md-search__options" aria-label="Search">
179
+
180
+ <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
181
+
182
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
183
+ </a>
184
+
185
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
186
+
187
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
188
+ </button>
189
+ </nav>
190
+
191
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
192
+
193
+ </form>
194
+ <div class="md-search__output">
195
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
196
+ <div class="md-search-result" data-md-component="search-result">
197
+ <div class="md-search-result__meta">
198
+ Initializing search
199
+ </div>
200
+ <ol class="md-search-result__list" role="presentation"></ol>
201
+ </div>
202
+ </div>
203
+ </div>
204
+ </div>
205
+ </div>
206
+
207
+
208
+
209
+ <div class="md-header__source">
210
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
211
+ <div class="md-source__icon md-icon">
212
+
213
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
214
+ </div>
215
+ <div class="md-source__repository">
216
+ madbomber/robot_lab
217
+ </div>
218
+ </a>
219
+ </div>
220
+
221
+ </nav>
222
+
223
+
224
+
225
+ <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
226
+ <div class="md-grid">
227
+ <ul class="md-tabs__list">
228
+
229
+
230
+
231
+
232
+
233
+
234
+
235
+
236
+ <li class="md-tabs__item">
237
+ <a href="../.." class="md-tabs__link">
238
+
239
+
240
+
241
+
242
+
243
+ Home
244
+
245
+ </a>
246
+ </li>
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+
255
+
256
+
257
+
258
+ <li class="md-tabs__item">
259
+ <a href="../../getting-started/" class="md-tabs__link">
260
+
261
+
262
+
263
+
264
+
265
+ Getting Started
266
+
267
+ </a>
268
+ </li>
269
+
270
+
271
+
272
+
273
+
274
+
275
+
276
+
277
+
278
+
279
+
280
+
281
+
282
+ <li class="md-tabs__item md-tabs__item--active">
283
+ <a href="../" class="md-tabs__link">
284
+
285
+
286
+
287
+
288
+
289
+ Architecture
290
+
291
+ </a>
292
+ </li>
293
+
294
+
295
+
296
+
297
+
298
+
299
+
300
+
301
+
302
+
303
+
304
+ <li class="md-tabs__item">
305
+ <a href="../../guides/" class="md-tabs__link">
306
+
307
+
308
+
309
+
310
+
311
+ Guides
312
+
313
+ </a>
314
+ </li>
315
+
316
+
317
+
318
+
319
+
320
+
321
+
322
+
323
+
324
+
325
+
326
+ <li class="md-tabs__item">
327
+ <a href="../../api/" class="md-tabs__link">
328
+
329
+
330
+
331
+
332
+
333
+ API Reference
334
+
335
+ </a>
336
+ </li>
337
+
338
+
339
+
340
+
341
+
342
+
343
+
344
+
345
+
346
+
347
+
348
+ <li class="md-tabs__item">
349
+ <a href="../../examples/" class="md-tabs__link">
350
+
351
+
352
+
353
+
354
+
355
+ Examples
356
+
357
+ </a>
358
+ </li>
359
+
360
+
361
+
362
+
363
+ </ul>
364
+ </div>
365
+ </nav>
366
+
367
+
368
+ </header>
369
+
370
+ <div class="md-container" data-md-component="container">
371
+
372
+
373
+
374
+
375
+ <main class="md-main" data-md-component="main">
376
+ <div class="md-main__inner md-grid">
377
+
378
+
379
+
380
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
381
+ <div class="md-sidebar__scrollwrap">
382
+ <div class="md-sidebar__inner">
383
+
384
+
385
+
386
+
387
+
388
+
389
+ <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
390
+ <label class="md-nav__title" for="__drawer">
391
+ <a href="../.." title="RobotLab" class="md-nav__button md-logo" aria-label="RobotLab" data-md-component="logo">
392
+
393
+
394
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
395
+
396
+ </a>
397
+ RobotLab
398
+ </label>
399
+
400
+ <div class="md-nav__source">
401
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
402
+ <div class="md-source__icon md-icon">
403
+
404
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
405
+ </div>
406
+ <div class="md-source__repository">
407
+ madbomber/robot_lab
408
+ </div>
409
+ </a>
410
+ </div>
411
+
412
+ <ul class="md-nav__list" data-md-scrollfix>
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+
423
+
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+ <li class="md-nav__item md-nav__item--nested">
437
+
438
+
439
+
440
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
441
+
442
+
443
+ <div class="md-nav__link md-nav__container">
444
+ <a href="../.." class="md-nav__link ">
445
+
446
+
447
+
448
+ <span class="md-ellipsis">
449
+
450
+
451
+ Home
452
+
453
+
454
+
455
+ </span>
456
+
457
+
458
+
459
+ </a>
460
+
461
+
462
+ <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
463
+ <span class="md-nav__icon md-icon"></span>
464
+ </label>
465
+
466
+ </div>
467
+
468
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
469
+ <label class="md-nav__title" for="__nav_1">
470
+ <span class="md-nav__icon md-icon"></span>
471
+
472
+
473
+ Home
474
+
475
+
476
+ </label>
477
+ <ul class="md-nav__list" data-md-scrollfix>
478
+
479
+
480
+
481
+
482
+
483
+
484
+
485
+
486
+
487
+ <li class="md-nav__item">
488
+ <a href="../../concepts/" class="md-nav__link">
489
+
490
+
491
+
492
+ <span class="md-ellipsis">
493
+
494
+
495
+ Concepts
496
+
497
+
498
+
499
+ </span>
500
+
501
+
502
+
503
+ </a>
504
+ </li>
505
+
506
+
507
+
508
+
509
+ </ul>
510
+ </nav>
511
+
512
+ </li>
513
+
514
+
515
+
516
+
517
+
518
+
519
+
520
+
521
+
522
+
523
+
524
+
525
+
526
+
527
+
528
+
529
+
530
+
531
+
532
+
533
+
534
+
535
+
536
+
537
+
538
+
539
+
540
+
541
+
542
+ <li class="md-nav__item md-nav__item--nested">
543
+
544
+
545
+
546
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
547
+
548
+
549
+ <div class="md-nav__link md-nav__container">
550
+ <a href="../../getting-started/" class="md-nav__link ">
551
+
552
+
553
+
554
+ <span class="md-ellipsis">
555
+
556
+
557
+ Getting Started
558
+
559
+
560
+
561
+ </span>
562
+
563
+
564
+
565
+ </a>
566
+
567
+
568
+ <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
569
+ <span class="md-nav__icon md-icon"></span>
570
+ </label>
571
+
572
+ </div>
573
+
574
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
575
+ <label class="md-nav__title" for="__nav_2">
576
+ <span class="md-nav__icon md-icon"></span>
577
+
578
+
579
+ Getting Started
580
+
581
+
582
+ </label>
583
+ <ul class="md-nav__list" data-md-scrollfix>
584
+
585
+
586
+
587
+
588
+
589
+
590
+
591
+
592
+
593
+ <li class="md-nav__item">
594
+ <a href="../../getting-started/installation/" class="md-nav__link">
595
+
596
+
597
+
598
+ <span class="md-ellipsis">
599
+
600
+
601
+ Installation
602
+
603
+
604
+
605
+ </span>
606
+
607
+
608
+
609
+ </a>
610
+ </li>
611
+
612
+
613
+
614
+
615
+
616
+
617
+
618
+
619
+
620
+
621
+ <li class="md-nav__item">
622
+ <a href="../../getting-started/quick-start/" class="md-nav__link">
623
+
624
+
625
+
626
+ <span class="md-ellipsis">
627
+
628
+
629
+ Quick Start
630
+
631
+
632
+
633
+ </span>
634
+
635
+
636
+
637
+ </a>
638
+ </li>
639
+
640
+
641
+
642
+
643
+
644
+
645
+
646
+
647
+
648
+
649
+ <li class="md-nav__item">
650
+ <a href="../../getting-started/configuration/" class="md-nav__link">
651
+
652
+
653
+
654
+ <span class="md-ellipsis">
655
+
656
+
657
+ Configuration
658
+
659
+
660
+
661
+ </span>
662
+
663
+
664
+
665
+ </a>
666
+ </li>
667
+
668
+
669
+
670
+
671
+ </ul>
672
+ </nav>
673
+
674
+ </li>
675
+
676
+
677
+
678
+
679
+
680
+
681
+
682
+
683
+
684
+
685
+
686
+
687
+
688
+
689
+
690
+
691
+
692
+
693
+
694
+
695
+
696
+
697
+
698
+
699
+
700
+
701
+
702
+
703
+
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+
712
+
713
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
714
+
715
+
716
+
717
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
718
+
719
+
720
+ <div class="md-nav__link md-nav__container">
721
+ <a href="../" class="md-nav__link ">
722
+
723
+
724
+
725
+ <span class="md-ellipsis">
726
+
727
+
728
+ Architecture
729
+
730
+
731
+
732
+ </span>
733
+
734
+
735
+
736
+ </a>
737
+
738
+
739
+ <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
740
+ <span class="md-nav__icon md-icon"></span>
741
+ </label>
742
+
743
+ </div>
744
+
745
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
746
+ <label class="md-nav__title" for="__nav_3">
747
+ <span class="md-nav__icon md-icon"></span>
748
+
749
+
750
+ Architecture
751
+
752
+
753
+ </label>
754
+ <ul class="md-nav__list" data-md-scrollfix>
755
+
756
+
757
+
758
+
759
+
760
+
761
+
762
+
763
+
764
+
765
+
766
+ <li class="md-nav__item md-nav__item--active">
767
+
768
+ <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
769
+
770
+
771
+
772
+
773
+
774
+ <label class="md-nav__link md-nav__link--active" for="__toc">
775
+
776
+
777
+
778
+ <span class="md-ellipsis">
779
+
780
+
781
+ Core Concepts
782
+
783
+
784
+
785
+ </span>
786
+
787
+
788
+
789
+ <span class="md-nav__icon md-icon"></span>
790
+ </label>
791
+
792
+ <a href="./" class="md-nav__link md-nav__link--active">
793
+
794
+
795
+
796
+ <span class="md-ellipsis">
797
+
798
+
799
+ Core Concepts
800
+
801
+
802
+
803
+ </span>
804
+
805
+
806
+
807
+ </a>
808
+
809
+
810
+
811
+
812
+
813
+ <nav class="md-nav md-nav--secondary" aria-label="On this page">
814
+
815
+
816
+
817
+
818
+
819
+
820
+ <label class="md-nav__title" for="__toc">
821
+ <span class="md-nav__icon md-icon"></span>
822
+ On this page
823
+ </label>
824
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
825
+
826
+ <li class="md-nav__item">
827
+ <a href="#robot" class="md-nav__link">
828
+ <span class="md-ellipsis">
829
+
830
+ Robot
831
+
832
+ </span>
833
+ </a>
834
+
835
+ <nav class="md-nav" aria-label="Robot">
836
+ <ul class="md-nav__list">
837
+
838
+ <li class="md-nav__item">
839
+ <a href="#robot-anatomy" class="md-nav__link">
840
+ <span class="md-ellipsis">
841
+
842
+ Robot Anatomy
843
+
844
+ </span>
845
+ </a>
846
+
847
+ </li>
848
+
849
+ <li class="md-nav__item">
850
+ <a href="#robot-lifecycle" class="md-nav__link">
851
+ <span class="md-ellipsis">
852
+
853
+ Robot Lifecycle
854
+
855
+ </span>
856
+ </a>
857
+
858
+ </li>
859
+
860
+ <li class="md-nav__item">
861
+ <a href="#robot-properties" class="md-nav__link">
862
+ <span class="md-ellipsis">
863
+
864
+ Robot Properties
865
+
866
+ </span>
867
+ </a>
868
+
869
+ </li>
870
+
871
+ <li class="md-nav__item">
872
+ <a href="#running-a-robot" class="md-nav__link">
873
+ <span class="md-ellipsis">
874
+
875
+ Running a Robot
876
+
877
+ </span>
878
+ </a>
879
+
880
+ </li>
881
+
882
+ </ul>
883
+ </nav>
884
+
885
+ </li>
886
+
887
+ <li class="md-nav__item">
888
+ <a href="#tool" class="md-nav__link">
889
+ <span class="md-ellipsis">
890
+
891
+ Tool
892
+
893
+ </span>
894
+ </a>
895
+
896
+ <nav class="md-nav" aria-label="Tool">
897
+ <ul class="md-nav__list">
898
+
899
+ <li class="md-nav__item">
900
+ <a href="#rubyllmtool-subclass-primary" class="md-nav__link">
901
+ <span class="md-ellipsis">
902
+
903
+ RubyLLM::Tool Subclass (Primary)
904
+
905
+ </span>
906
+ </a>
907
+
908
+ </li>
909
+
910
+ <li class="md-nav__item">
911
+ <a href="#robotlabtoolcreate-factory" class="md-nav__link">
912
+ <span class="md-ellipsis">
913
+
914
+ RobotLab::Tool.create Factory
915
+
916
+ </span>
917
+ </a>
918
+
919
+ </li>
920
+
921
+ <li class="md-nav__item">
922
+ <a href="#tool-execution" class="md-nav__link">
923
+ <span class="md-ellipsis">
924
+
925
+ Tool Execution
926
+
927
+ </span>
928
+ </a>
929
+
930
+ </li>
931
+
932
+ <li class="md-nav__item">
933
+ <a href="#error-handling" class="md-nav__link">
934
+ <span class="md-ellipsis">
935
+
936
+ Error Handling
937
+
938
+ </span>
939
+ </a>
940
+
941
+ </li>
942
+
943
+ </ul>
944
+ </nav>
945
+
946
+ </li>
947
+
948
+ <li class="md-nav__item">
949
+ <a href="#memory" class="md-nav__link">
950
+ <span class="md-ellipsis">
951
+
952
+ Memory
953
+
954
+ </span>
955
+ </a>
956
+
957
+ <nav class="md-nav" aria-label="Memory">
958
+ <ul class="md-nav__list">
959
+
960
+ <li class="md-nav__item">
961
+ <a href="#standalone-vs-network-memory" class="md-nav__link">
962
+ <span class="md-ellipsis">
963
+
964
+ Standalone vs Network Memory
965
+
966
+ </span>
967
+ </a>
968
+
969
+ </li>
970
+
971
+ <li class="md-nav__item">
972
+ <a href="#reserved-keys" class="md-nav__link">
973
+ <span class="md-ellipsis">
974
+
975
+ Reserved Keys
976
+
977
+ </span>
978
+ </a>
979
+
980
+ </li>
981
+
982
+ <li class="md-nav__item">
983
+ <a href="#reactive-features" class="md-nav__link">
984
+ <span class="md-ellipsis">
985
+
986
+ Reactive Features
987
+
988
+ </span>
989
+ </a>
990
+
991
+ </li>
992
+
993
+ </ul>
994
+ </nav>
995
+
996
+ </li>
997
+
998
+ <li class="md-nav__item">
999
+ <a href="#message-types" class="md-nav__link">
1000
+ <span class="md-ellipsis">
1001
+
1002
+ Message Types
1003
+
1004
+ </span>
1005
+ </a>
1006
+
1007
+ <nav class="md-nav" aria-label="Message Types">
1008
+ <ul class="md-nav__list">
1009
+
1010
+ <li class="md-nav__item">
1011
+ <a href="#message-roles" class="md-nav__link">
1012
+ <span class="md-ellipsis">
1013
+
1014
+ Message Roles
1015
+
1016
+ </span>
1017
+ </a>
1018
+
1019
+ </li>
1020
+
1021
+ <li class="md-nav__item">
1022
+ <a href="#stop-reasons" class="md-nav__link">
1023
+ <span class="md-ellipsis">
1024
+
1025
+ Stop Reasons
1026
+
1027
+ </span>
1028
+ </a>
1029
+
1030
+ </li>
1031
+
1032
+ </ul>
1033
+ </nav>
1034
+
1035
+ </li>
1036
+
1037
+ <li class="md-nav__item">
1038
+ <a href="#robotresult" class="md-nav__link">
1039
+ <span class="md-ellipsis">
1040
+
1041
+ RobotResult
1042
+
1043
+ </span>
1044
+ </a>
1045
+
1046
+ <nav class="md-nav" aria-label="RobotResult">
1047
+ <ul class="md-nav__list">
1048
+
1049
+ <li class="md-nav__item">
1050
+ <a href="#accessing-response-content" class="md-nav__link">
1051
+ <span class="md-ellipsis">
1052
+
1053
+ Accessing Response Content
1054
+
1055
+ </span>
1056
+ </a>
1057
+
1058
+ </li>
1059
+
1060
+ </ul>
1061
+ </nav>
1062
+
1063
+ </li>
1064
+
1065
+ <li class="md-nav__item">
1066
+ <a href="#configuration" class="md-nav__link">
1067
+ <span class="md-ellipsis">
1068
+
1069
+ Configuration
1070
+
1071
+ </span>
1072
+ </a>
1073
+
1074
+ </li>
1075
+
1076
+ <li class="md-nav__item">
1077
+ <a href="#configuration-hierarchy" class="md-nav__link">
1078
+ <span class="md-ellipsis">
1079
+
1080
+ Configuration Hierarchy
1081
+
1082
+ </span>
1083
+ </a>
1084
+
1085
+ </li>
1086
+
1087
+ <li class="md-nav__item">
1088
+ <a href="#message-bus" class="md-nav__link">
1089
+ <span class="md-ellipsis">
1090
+
1091
+ Message Bus
1092
+
1093
+ </span>
1094
+ </a>
1095
+
1096
+ <nav class="md-nav" aria-label="Message Bus">
1097
+ <ul class="md-nav__list">
1098
+
1099
+ <li class="md-nav__item">
1100
+ <a href="#how-it-works" class="md-nav__link">
1101
+ <span class="md-ellipsis">
1102
+
1103
+ How It Works
1104
+
1105
+ </span>
1106
+ </a>
1107
+
1108
+ </li>
1109
+
1110
+ <li class="md-nav__item">
1111
+ <a href="#robotmessage" class="md-nav__link">
1112
+ <span class="md-ellipsis">
1113
+
1114
+ RobotMessage
1115
+
1116
+ </span>
1117
+ </a>
1118
+
1119
+ </li>
1120
+
1121
+ <li class="md-nav__item">
1122
+ <a href="#sending-and-receiving" class="md-nav__link">
1123
+ <span class="md-ellipsis">
1124
+
1125
+ Sending and Receiving
1126
+
1127
+ </span>
1128
+ </a>
1129
+
1130
+ </li>
1131
+
1132
+ <li class="md-nav__item">
1133
+ <a href="#dynamic-spawning" class="md-nav__link">
1134
+ <span class="md-ellipsis">
1135
+
1136
+ Dynamic Spawning
1137
+
1138
+ </span>
1139
+ </a>
1140
+
1141
+ </li>
1142
+
1143
+ <li class="md-nav__item">
1144
+ <a href="#bus-vs-network" class="md-nav__link">
1145
+ <span class="md-ellipsis">
1146
+
1147
+ Bus vs Network
1148
+
1149
+ </span>
1150
+ </a>
1151
+
1152
+ </li>
1153
+
1154
+ </ul>
1155
+ </nav>
1156
+
1157
+ </li>
1158
+
1159
+ <li class="md-nav__item">
1160
+ <a href="#network" class="md-nav__link">
1161
+ <span class="md-ellipsis">
1162
+
1163
+ Network
1164
+
1165
+ </span>
1166
+ </a>
1167
+
1168
+ </li>
1169
+
1170
+ <li class="md-nav__item">
1171
+ <a href="#next-steps" class="md-nav__link">
1172
+ <span class="md-ellipsis">
1173
+
1174
+ Next Steps
1175
+
1176
+ </span>
1177
+ </a>
1178
+
1179
+ </li>
1180
+
1181
+ </ul>
1182
+
1183
+ </nav>
1184
+
1185
+ </li>
1186
+
1187
+
1188
+
1189
+
1190
+
1191
+
1192
+
1193
+
1194
+
1195
+
1196
+ <li class="md-nav__item">
1197
+ <a href="../robot-execution/" class="md-nav__link">
1198
+
1199
+
1200
+
1201
+ <span class="md-ellipsis">
1202
+
1203
+
1204
+ Robot Execution
1205
+
1206
+
1207
+
1208
+ </span>
1209
+
1210
+
1211
+
1212
+ </a>
1213
+ </li>
1214
+
1215
+
1216
+
1217
+
1218
+
1219
+
1220
+
1221
+
1222
+
1223
+
1224
+ <li class="md-nav__item">
1225
+ <a href="../network-orchestration/" class="md-nav__link">
1226
+
1227
+
1228
+
1229
+ <span class="md-ellipsis">
1230
+
1231
+
1232
+ Network Orchestration
1233
+
1234
+
1235
+
1236
+ </span>
1237
+
1238
+
1239
+
1240
+ </a>
1241
+ </li>
1242
+
1243
+
1244
+
1245
+
1246
+
1247
+
1248
+
1249
+
1250
+
1251
+
1252
+ <li class="md-nav__item">
1253
+ <a href="../state-management/" class="md-nav__link">
1254
+
1255
+
1256
+
1257
+ <span class="md-ellipsis">
1258
+
1259
+
1260
+ State Management
1261
+
1262
+
1263
+
1264
+ </span>
1265
+
1266
+
1267
+
1268
+ </a>
1269
+ </li>
1270
+
1271
+
1272
+
1273
+
1274
+
1275
+
1276
+
1277
+
1278
+
1279
+
1280
+ <li class="md-nav__item">
1281
+ <a href="../message-flow/" class="md-nav__link">
1282
+
1283
+
1284
+
1285
+ <span class="md-ellipsis">
1286
+
1287
+
1288
+ Message Flow
1289
+
1290
+
1291
+
1292
+ </span>
1293
+
1294
+
1295
+
1296
+ </a>
1297
+ </li>
1298
+
1299
+
1300
+
1301
+
1302
+ </ul>
1303
+ </nav>
1304
+
1305
+ </li>
1306
+
1307
+
1308
+
1309
+
1310
+
1311
+
1312
+
1313
+
1314
+
1315
+
1316
+
1317
+
1318
+
1319
+
1320
+
1321
+
1322
+
1323
+
1324
+
1325
+
1326
+
1327
+
1328
+
1329
+
1330
+
1331
+
1332
+
1333
+
1334
+
1335
+
1336
+
1337
+
1338
+
1339
+
1340
+
1341
+
1342
+
1343
+ <li class="md-nav__item md-nav__item--nested">
1344
+
1345
+
1346
+
1347
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
1348
+
1349
+
1350
+ <div class="md-nav__link md-nav__container">
1351
+ <a href="../../guides/" class="md-nav__link ">
1352
+
1353
+
1354
+
1355
+ <span class="md-ellipsis">
1356
+
1357
+
1358
+ Guides
1359
+
1360
+
1361
+
1362
+ </span>
1363
+
1364
+
1365
+
1366
+ </a>
1367
+
1368
+
1369
+ <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="0">
1370
+ <span class="md-nav__icon md-icon"></span>
1371
+ </label>
1372
+
1373
+ </div>
1374
+
1375
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
1376
+ <label class="md-nav__title" for="__nav_4">
1377
+ <span class="md-nav__icon md-icon"></span>
1378
+
1379
+
1380
+ Guides
1381
+
1382
+
1383
+ </label>
1384
+ <ul class="md-nav__list" data-md-scrollfix>
1385
+
1386
+
1387
+
1388
+
1389
+
1390
+
1391
+
1392
+
1393
+
1394
+ <li class="md-nav__item">
1395
+ <a href="../../guides/building-robots/" class="md-nav__link">
1396
+
1397
+
1398
+
1399
+ <span class="md-ellipsis">
1400
+
1401
+
1402
+ Building Robots
1403
+
1404
+
1405
+
1406
+ </span>
1407
+
1408
+
1409
+
1410
+ </a>
1411
+ </li>
1412
+
1413
+
1414
+
1415
+
1416
+
1417
+
1418
+
1419
+
1420
+
1421
+
1422
+ <li class="md-nav__item">
1423
+ <a href="../../guides/creating-networks/" class="md-nav__link">
1424
+
1425
+
1426
+
1427
+ <span class="md-ellipsis">
1428
+
1429
+
1430
+ Creating Networks
1431
+
1432
+
1433
+
1434
+ </span>
1435
+
1436
+
1437
+
1438
+ </a>
1439
+ </li>
1440
+
1441
+
1442
+
1443
+
1444
+
1445
+
1446
+
1447
+
1448
+
1449
+
1450
+ <li class="md-nav__item">
1451
+ <a href="../../guides/using-tools/" class="md-nav__link">
1452
+
1453
+
1454
+
1455
+ <span class="md-ellipsis">
1456
+
1457
+
1458
+ Using Tools
1459
+
1460
+
1461
+
1462
+ </span>
1463
+
1464
+
1465
+
1466
+ </a>
1467
+ </li>
1468
+
1469
+
1470
+
1471
+
1472
+
1473
+
1474
+
1475
+
1476
+
1477
+
1478
+ <li class="md-nav__item">
1479
+ <a href="../../guides/mcp-integration/" class="md-nav__link">
1480
+
1481
+
1482
+
1483
+ <span class="md-ellipsis">
1484
+
1485
+
1486
+ MCP Integration
1487
+
1488
+
1489
+
1490
+ </span>
1491
+
1492
+
1493
+
1494
+ </a>
1495
+ </li>
1496
+
1497
+
1498
+
1499
+
1500
+
1501
+
1502
+
1503
+
1504
+
1505
+
1506
+ <li class="md-nav__item">
1507
+ <a href="../../guides/streaming/" class="md-nav__link">
1508
+
1509
+
1510
+
1511
+ <span class="md-ellipsis">
1512
+
1513
+
1514
+ Streaming Responses
1515
+
1516
+
1517
+
1518
+ </span>
1519
+
1520
+
1521
+
1522
+ </a>
1523
+ </li>
1524
+
1525
+
1526
+
1527
+
1528
+
1529
+
1530
+
1531
+
1532
+
1533
+
1534
+ <li class="md-nav__item">
1535
+ <a href="../../guides/memory/" class="md-nav__link">
1536
+
1537
+
1538
+
1539
+ <span class="md-ellipsis">
1540
+
1541
+
1542
+ Memory System
1543
+
1544
+
1545
+
1546
+ </span>
1547
+
1548
+
1549
+
1550
+ </a>
1551
+ </li>
1552
+
1553
+
1554
+
1555
+
1556
+
1557
+
1558
+
1559
+
1560
+
1561
+
1562
+ <li class="md-nav__item">
1563
+ <a href="../../guides/rails-integration/" class="md-nav__link">
1564
+
1565
+
1566
+
1567
+ <span class="md-ellipsis">
1568
+
1569
+
1570
+ Rails Integration
1571
+
1572
+
1573
+
1574
+ </span>
1575
+
1576
+
1577
+
1578
+ </a>
1579
+ </li>
1580
+
1581
+
1582
+
1583
+
1584
+ </ul>
1585
+ </nav>
1586
+
1587
+ </li>
1588
+
1589
+
1590
+
1591
+
1592
+
1593
+
1594
+
1595
+
1596
+
1597
+
1598
+
1599
+
1600
+
1601
+
1602
+
1603
+
1604
+
1605
+
1606
+
1607
+
1608
+
1609
+
1610
+
1611
+
1612
+
1613
+
1614
+
1615
+
1616
+
1617
+
1618
+
1619
+ <li class="md-nav__item md-nav__item--nested">
1620
+
1621
+
1622
+
1623
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
1624
+
1625
+
1626
+ <div class="md-nav__link md-nav__container">
1627
+ <a href="../../api/" class="md-nav__link ">
1628
+
1629
+
1630
+
1631
+ <span class="md-ellipsis">
1632
+
1633
+
1634
+ API Reference
1635
+
1636
+
1637
+
1638
+ </span>
1639
+
1640
+
1641
+
1642
+ </a>
1643
+
1644
+
1645
+ <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="0">
1646
+ <span class="md-nav__icon md-icon"></span>
1647
+ </label>
1648
+
1649
+ </div>
1650
+
1651
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
1652
+ <label class="md-nav__title" for="__nav_5">
1653
+ <span class="md-nav__icon md-icon"></span>
1654
+
1655
+
1656
+ API Reference
1657
+
1658
+
1659
+ </label>
1660
+ <ul class="md-nav__list" data-md-scrollfix>
1661
+
1662
+
1663
+
1664
+
1665
+
1666
+
1667
+
1668
+
1669
+
1670
+
1671
+
1672
+
1673
+
1674
+
1675
+
1676
+
1677
+
1678
+
1679
+
1680
+
1681
+
1682
+
1683
+
1684
+
1685
+
1686
+
1687
+
1688
+
1689
+
1690
+
1691
+
1692
+
1693
+
1694
+ <li class="md-nav__item md-nav__item--nested">
1695
+
1696
+
1697
+
1698
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
1699
+
1700
+
1701
+ <div class="md-nav__link md-nav__container">
1702
+ <a href="../../api/core/" class="md-nav__link ">
1703
+
1704
+
1705
+
1706
+ <span class="md-ellipsis">
1707
+
1708
+
1709
+ Core Classes
1710
+
1711
+
1712
+
1713
+ </span>
1714
+
1715
+
1716
+
1717
+ </a>
1718
+
1719
+
1720
+ <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
1721
+ <span class="md-nav__icon md-icon"></span>
1722
+ </label>
1723
+
1724
+ </div>
1725
+
1726
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
1727
+ <label class="md-nav__title" for="__nav_5_2">
1728
+ <span class="md-nav__icon md-icon"></span>
1729
+
1730
+
1731
+ Core Classes
1732
+
1733
+
1734
+ </label>
1735
+ <ul class="md-nav__list" data-md-scrollfix>
1736
+
1737
+
1738
+
1739
+
1740
+
1741
+
1742
+
1743
+
1744
+
1745
+ <li class="md-nav__item">
1746
+ <a href="../../api/core/robot/" class="md-nav__link">
1747
+
1748
+
1749
+
1750
+ <span class="md-ellipsis">
1751
+
1752
+
1753
+ Robot
1754
+
1755
+
1756
+
1757
+ </span>
1758
+
1759
+
1760
+
1761
+ </a>
1762
+ </li>
1763
+
1764
+
1765
+
1766
+
1767
+
1768
+
1769
+
1770
+
1771
+
1772
+
1773
+ <li class="md-nav__item">
1774
+ <a href="../../api/core/network/" class="md-nav__link">
1775
+
1776
+
1777
+
1778
+ <span class="md-ellipsis">
1779
+
1780
+
1781
+ Network
1782
+
1783
+
1784
+
1785
+ </span>
1786
+
1787
+
1788
+
1789
+ </a>
1790
+ </li>
1791
+
1792
+
1793
+
1794
+
1795
+
1796
+
1797
+
1798
+
1799
+
1800
+
1801
+ <li class="md-nav__item">
1802
+ <a href="../../api/core/state/" class="md-nav__link">
1803
+
1804
+
1805
+
1806
+ <span class="md-ellipsis">
1807
+
1808
+
1809
+ State
1810
+
1811
+
1812
+
1813
+ </span>
1814
+
1815
+
1816
+
1817
+ </a>
1818
+ </li>
1819
+
1820
+
1821
+
1822
+
1823
+
1824
+
1825
+
1826
+
1827
+
1828
+
1829
+ <li class="md-nav__item">
1830
+ <a href="../../api/core/tool/" class="md-nav__link">
1831
+
1832
+
1833
+
1834
+ <span class="md-ellipsis">
1835
+
1836
+
1837
+ Tool
1838
+
1839
+
1840
+
1841
+ </span>
1842
+
1843
+
1844
+
1845
+ </a>
1846
+ </li>
1847
+
1848
+
1849
+
1850
+
1851
+
1852
+
1853
+
1854
+
1855
+
1856
+
1857
+ <li class="md-nav__item">
1858
+ <a href="../../api/core/memory/" class="md-nav__link">
1859
+
1860
+
1861
+
1862
+ <span class="md-ellipsis">
1863
+
1864
+
1865
+ Memory
1866
+
1867
+
1868
+
1869
+ </span>
1870
+
1871
+
1872
+
1873
+ </a>
1874
+ </li>
1875
+
1876
+
1877
+
1878
+
1879
+ </ul>
1880
+ </nav>
1881
+
1882
+ </li>
1883
+
1884
+
1885
+
1886
+
1887
+
1888
+
1889
+
1890
+
1891
+
1892
+
1893
+
1894
+
1895
+
1896
+
1897
+
1898
+
1899
+
1900
+
1901
+
1902
+
1903
+
1904
+
1905
+
1906
+
1907
+
1908
+
1909
+
1910
+
1911
+
1912
+
1913
+
1914
+
1915
+ <li class="md-nav__item md-nav__item--nested">
1916
+
1917
+
1918
+
1919
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
1920
+
1921
+
1922
+ <div class="md-nav__link md-nav__container">
1923
+ <a href="../../api/messages/" class="md-nav__link ">
1924
+
1925
+
1926
+
1927
+ <span class="md-ellipsis">
1928
+
1929
+
1930
+ Messages
1931
+
1932
+
1933
+
1934
+ </span>
1935
+
1936
+
1937
+
1938
+ </a>
1939
+
1940
+
1941
+ <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
1942
+ <span class="md-nav__icon md-icon"></span>
1943
+ </label>
1944
+
1945
+ </div>
1946
+
1947
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
1948
+ <label class="md-nav__title" for="__nav_5_3">
1949
+ <span class="md-nav__icon md-icon"></span>
1950
+
1951
+
1952
+ Messages
1953
+
1954
+
1955
+ </label>
1956
+ <ul class="md-nav__list" data-md-scrollfix>
1957
+
1958
+
1959
+
1960
+
1961
+
1962
+
1963
+
1964
+
1965
+
1966
+ <li class="md-nav__item">
1967
+ <a href="../../api/messages/user-message/" class="md-nav__link">
1968
+
1969
+
1970
+
1971
+ <span class="md-ellipsis">
1972
+
1973
+
1974
+ UserMessage
1975
+
1976
+
1977
+
1978
+ </span>
1979
+
1980
+
1981
+
1982
+ </a>
1983
+ </li>
1984
+
1985
+
1986
+
1987
+
1988
+
1989
+
1990
+
1991
+
1992
+
1993
+
1994
+ <li class="md-nav__item">
1995
+ <a href="../../api/messages/text-message/" class="md-nav__link">
1996
+
1997
+
1998
+
1999
+ <span class="md-ellipsis">
2000
+
2001
+
2002
+ TextMessage
2003
+
2004
+
2005
+
2006
+ </span>
2007
+
2008
+
2009
+
2010
+ </a>
2011
+ </li>
2012
+
2013
+
2014
+
2015
+
2016
+
2017
+
2018
+
2019
+
2020
+
2021
+
2022
+ <li class="md-nav__item">
2023
+ <a href="../../api/messages/tool-call-message/" class="md-nav__link">
2024
+
2025
+
2026
+
2027
+ <span class="md-ellipsis">
2028
+
2029
+
2030
+ ToolCallMessage
2031
+
2032
+
2033
+
2034
+ </span>
2035
+
2036
+
2037
+
2038
+ </a>
2039
+ </li>
2040
+
2041
+
2042
+
2043
+
2044
+
2045
+
2046
+
2047
+
2048
+
2049
+
2050
+ <li class="md-nav__item">
2051
+ <a href="../../api/messages/tool-result-message/" class="md-nav__link">
2052
+
2053
+
2054
+
2055
+ <span class="md-ellipsis">
2056
+
2057
+
2058
+ ToolResultMessage
2059
+
2060
+
2061
+
2062
+ </span>
2063
+
2064
+
2065
+
2066
+ </a>
2067
+ </li>
2068
+
2069
+
2070
+
2071
+
2072
+ </ul>
2073
+ </nav>
2074
+
2075
+ </li>
2076
+
2077
+
2078
+
2079
+
2080
+
2081
+
2082
+
2083
+
2084
+
2085
+
2086
+
2087
+
2088
+
2089
+
2090
+
2091
+
2092
+
2093
+
2094
+
2095
+
2096
+
2097
+
2098
+
2099
+
2100
+
2101
+
2102
+
2103
+
2104
+
2105
+
2106
+ <li class="md-nav__item md-nav__item--nested">
2107
+
2108
+
2109
+
2110
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
2111
+
2112
+
2113
+ <div class="md-nav__link md-nav__container">
2114
+ <a href="../../api/mcp/" class="md-nav__link ">
2115
+
2116
+
2117
+
2118
+ <span class="md-ellipsis">
2119
+
2120
+
2121
+ MCP
2122
+
2123
+
2124
+
2125
+ </span>
2126
+
2127
+
2128
+
2129
+ </a>
2130
+
2131
+
2132
+ <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
2133
+ <span class="md-nav__icon md-icon"></span>
2134
+ </label>
2135
+
2136
+ </div>
2137
+
2138
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
2139
+ <label class="md-nav__title" for="__nav_5_4">
2140
+ <span class="md-nav__icon md-icon"></span>
2141
+
2142
+
2143
+ MCP
2144
+
2145
+
2146
+ </label>
2147
+ <ul class="md-nav__list" data-md-scrollfix>
2148
+
2149
+
2150
+
2151
+
2152
+
2153
+
2154
+
2155
+
2156
+
2157
+ <li class="md-nav__item">
2158
+ <a href="../../api/mcp/client/" class="md-nav__link">
2159
+
2160
+
2161
+
2162
+ <span class="md-ellipsis">
2163
+
2164
+
2165
+ Client
2166
+
2167
+
2168
+
2169
+ </span>
2170
+
2171
+
2172
+
2173
+ </a>
2174
+ </li>
2175
+
2176
+
2177
+
2178
+
2179
+
2180
+
2181
+
2182
+
2183
+
2184
+
2185
+ <li class="md-nav__item">
2186
+ <a href="../../api/mcp/server/" class="md-nav__link">
2187
+
2188
+
2189
+
2190
+ <span class="md-ellipsis">
2191
+
2192
+
2193
+ Server
2194
+
2195
+
2196
+
2197
+ </span>
2198
+
2199
+
2200
+
2201
+ </a>
2202
+ </li>
2203
+
2204
+
2205
+
2206
+
2207
+
2208
+
2209
+
2210
+
2211
+
2212
+
2213
+ <li class="md-nav__item">
2214
+ <a href="../../api/mcp/transports/" class="md-nav__link">
2215
+
2216
+
2217
+
2218
+ <span class="md-ellipsis">
2219
+
2220
+
2221
+ Transports
2222
+
2223
+
2224
+
2225
+ </span>
2226
+
2227
+
2228
+
2229
+ </a>
2230
+ </li>
2231
+
2232
+
2233
+
2234
+
2235
+ </ul>
2236
+ </nav>
2237
+
2238
+ </li>
2239
+
2240
+
2241
+
2242
+
2243
+
2244
+
2245
+
2246
+
2247
+
2248
+
2249
+
2250
+
2251
+
2252
+
2253
+
2254
+
2255
+
2256
+
2257
+
2258
+
2259
+
2260
+
2261
+
2262
+
2263
+
2264
+
2265
+
2266
+
2267
+ <li class="md-nav__item md-nav__item--nested">
2268
+
2269
+
2270
+
2271
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
2272
+
2273
+
2274
+ <div class="md-nav__link md-nav__container">
2275
+ <a href="../../api/streaming/" class="md-nav__link ">
2276
+
2277
+
2278
+
2279
+ <span class="md-ellipsis">
2280
+
2281
+
2282
+ Streaming
2283
+
2284
+
2285
+
2286
+ </span>
2287
+
2288
+
2289
+
2290
+ </a>
2291
+
2292
+
2293
+ <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
2294
+ <span class="md-nav__icon md-icon"></span>
2295
+ </label>
2296
+
2297
+ </div>
2298
+
2299
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
2300
+ <label class="md-nav__title" for="__nav_5_5">
2301
+ <span class="md-nav__icon md-icon"></span>
2302
+
2303
+
2304
+ Streaming
2305
+
2306
+
2307
+ </label>
2308
+ <ul class="md-nav__list" data-md-scrollfix>
2309
+
2310
+
2311
+
2312
+
2313
+
2314
+
2315
+
2316
+
2317
+
2318
+ <li class="md-nav__item">
2319
+ <a href="../../api/streaming/context/" class="md-nav__link">
2320
+
2321
+
2322
+
2323
+ <span class="md-ellipsis">
2324
+
2325
+
2326
+ Context
2327
+
2328
+
2329
+
2330
+ </span>
2331
+
2332
+
2333
+
2334
+ </a>
2335
+ </li>
2336
+
2337
+
2338
+
2339
+
2340
+
2341
+
2342
+
2343
+
2344
+
2345
+
2346
+ <li class="md-nav__item">
2347
+ <a href="../../api/streaming/events/" class="md-nav__link">
2348
+
2349
+
2350
+
2351
+ <span class="md-ellipsis">
2352
+
2353
+
2354
+ Events
2355
+
2356
+
2357
+
2358
+ </span>
2359
+
2360
+
2361
+
2362
+ </a>
2363
+ </li>
2364
+
2365
+
2366
+
2367
+
2368
+ </ul>
2369
+ </nav>
2370
+
2371
+ </li>
2372
+
2373
+
2374
+
2375
+
2376
+ </ul>
2377
+ </nav>
2378
+
2379
+ </li>
2380
+
2381
+
2382
+
2383
+
2384
+
2385
+
2386
+
2387
+
2388
+
2389
+
2390
+
2391
+
2392
+
2393
+
2394
+
2395
+
2396
+
2397
+
2398
+
2399
+
2400
+
2401
+
2402
+
2403
+
2404
+
2405
+
2406
+
2407
+
2408
+
2409
+
2410
+
2411
+
2412
+
2413
+ <li class="md-nav__item md-nav__item--nested">
2414
+
2415
+
2416
+
2417
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
2418
+
2419
+
2420
+ <div class="md-nav__link md-nav__container">
2421
+ <a href="../../examples/" class="md-nav__link ">
2422
+
2423
+
2424
+
2425
+ <span class="md-ellipsis">
2426
+
2427
+
2428
+ Examples
2429
+
2430
+
2431
+
2432
+ </span>
2433
+
2434
+
2435
+
2436
+ </a>
2437
+
2438
+
2439
+ <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="0">
2440
+ <span class="md-nav__icon md-icon"></span>
2441
+ </label>
2442
+
2443
+ </div>
2444
+
2445
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
2446
+ <label class="md-nav__title" for="__nav_6">
2447
+ <span class="md-nav__icon md-icon"></span>
2448
+
2449
+
2450
+ Examples
2451
+
2452
+
2453
+ </label>
2454
+ <ul class="md-nav__list" data-md-scrollfix>
2455
+
2456
+
2457
+
2458
+
2459
+
2460
+
2461
+
2462
+
2463
+
2464
+ <li class="md-nav__item">
2465
+ <a href="../../examples/basic-chat/" class="md-nav__link">
2466
+
2467
+
2468
+
2469
+ <span class="md-ellipsis">
2470
+
2471
+
2472
+ Basic Chat
2473
+
2474
+
2475
+
2476
+ </span>
2477
+
2478
+
2479
+
2480
+ </a>
2481
+ </li>
2482
+
2483
+
2484
+
2485
+
2486
+
2487
+
2488
+
2489
+
2490
+
2491
+
2492
+ <li class="md-nav__item">
2493
+ <a href="../../examples/multi-robot-network/" class="md-nav__link">
2494
+
2495
+
2496
+
2497
+ <span class="md-ellipsis">
2498
+
2499
+
2500
+ Multi-Robot Network
2501
+
2502
+
2503
+
2504
+ </span>
2505
+
2506
+
2507
+
2508
+ </a>
2509
+ </li>
2510
+
2511
+
2512
+
2513
+
2514
+
2515
+
2516
+
2517
+
2518
+
2519
+
2520
+ <li class="md-nav__item">
2521
+ <a href="../../examples/tool-usage/" class="md-nav__link">
2522
+
2523
+
2524
+
2525
+ <span class="md-ellipsis">
2526
+
2527
+
2528
+ Tool Usage
2529
+
2530
+
2531
+
2532
+ </span>
2533
+
2534
+
2535
+
2536
+ </a>
2537
+ </li>
2538
+
2539
+
2540
+
2541
+
2542
+
2543
+
2544
+
2545
+
2546
+
2547
+
2548
+ <li class="md-nav__item">
2549
+ <a href="../../examples/mcp-server/" class="md-nav__link">
2550
+
2551
+
2552
+
2553
+ <span class="md-ellipsis">
2554
+
2555
+
2556
+ MCP Server
2557
+
2558
+
2559
+
2560
+ </span>
2561
+
2562
+
2563
+
2564
+ </a>
2565
+ </li>
2566
+
2567
+
2568
+
2569
+
2570
+
2571
+
2572
+
2573
+
2574
+
2575
+
2576
+ <li class="md-nav__item">
2577
+ <a href="../../examples/rails-application/" class="md-nav__link">
2578
+
2579
+
2580
+
2581
+ <span class="md-ellipsis">
2582
+
2583
+
2584
+ Rails Application
2585
+
2586
+
2587
+
2588
+ </span>
2589
+
2590
+
2591
+
2592
+ </a>
2593
+ </li>
2594
+
2595
+
2596
+
2597
+
2598
+ </ul>
2599
+ </nav>
2600
+
2601
+ </li>
2602
+
2603
+
2604
+
2605
+ </ul>
2606
+ </nav>
2607
+ </div>
2608
+ </div>
2609
+ </div>
2610
+
2611
+
2612
+
2613
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
2614
+ <div class="md-sidebar__scrollwrap">
2615
+ <div class="md-sidebar__inner">
2616
+
2617
+
2618
+
2619
+
2620
+ <nav class="md-nav md-nav--secondary" aria-label="On this page">
2621
+
2622
+
2623
+
2624
+
2625
+
2626
+
2627
+ <label class="md-nav__title" for="__toc">
2628
+ <span class="md-nav__icon md-icon"></span>
2629
+ On this page
2630
+ </label>
2631
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
2632
+
2633
+ <li class="md-nav__item">
2634
+ <a href="#robot" class="md-nav__link">
2635
+ <span class="md-ellipsis">
2636
+
2637
+ Robot
2638
+
2639
+ </span>
2640
+ </a>
2641
+
2642
+ <nav class="md-nav" aria-label="Robot">
2643
+ <ul class="md-nav__list">
2644
+
2645
+ <li class="md-nav__item">
2646
+ <a href="#robot-anatomy" class="md-nav__link">
2647
+ <span class="md-ellipsis">
2648
+
2649
+ Robot Anatomy
2650
+
2651
+ </span>
2652
+ </a>
2653
+
2654
+ </li>
2655
+
2656
+ <li class="md-nav__item">
2657
+ <a href="#robot-lifecycle" class="md-nav__link">
2658
+ <span class="md-ellipsis">
2659
+
2660
+ Robot Lifecycle
2661
+
2662
+ </span>
2663
+ </a>
2664
+
2665
+ </li>
2666
+
2667
+ <li class="md-nav__item">
2668
+ <a href="#robot-properties" class="md-nav__link">
2669
+ <span class="md-ellipsis">
2670
+
2671
+ Robot Properties
2672
+
2673
+ </span>
2674
+ </a>
2675
+
2676
+ </li>
2677
+
2678
+ <li class="md-nav__item">
2679
+ <a href="#running-a-robot" class="md-nav__link">
2680
+ <span class="md-ellipsis">
2681
+
2682
+ Running a Robot
2683
+
2684
+ </span>
2685
+ </a>
2686
+
2687
+ </li>
2688
+
2689
+ </ul>
2690
+ </nav>
2691
+
2692
+ </li>
2693
+
2694
+ <li class="md-nav__item">
2695
+ <a href="#tool" class="md-nav__link">
2696
+ <span class="md-ellipsis">
2697
+
2698
+ Tool
2699
+
2700
+ </span>
2701
+ </a>
2702
+
2703
+ <nav class="md-nav" aria-label="Tool">
2704
+ <ul class="md-nav__list">
2705
+
2706
+ <li class="md-nav__item">
2707
+ <a href="#rubyllmtool-subclass-primary" class="md-nav__link">
2708
+ <span class="md-ellipsis">
2709
+
2710
+ RubyLLM::Tool Subclass (Primary)
2711
+
2712
+ </span>
2713
+ </a>
2714
+
2715
+ </li>
2716
+
2717
+ <li class="md-nav__item">
2718
+ <a href="#robotlabtoolcreate-factory" class="md-nav__link">
2719
+ <span class="md-ellipsis">
2720
+
2721
+ RobotLab::Tool.create Factory
2722
+
2723
+ </span>
2724
+ </a>
2725
+
2726
+ </li>
2727
+
2728
+ <li class="md-nav__item">
2729
+ <a href="#tool-execution" class="md-nav__link">
2730
+ <span class="md-ellipsis">
2731
+
2732
+ Tool Execution
2733
+
2734
+ </span>
2735
+ </a>
2736
+
2737
+ </li>
2738
+
2739
+ <li class="md-nav__item">
2740
+ <a href="#error-handling" class="md-nav__link">
2741
+ <span class="md-ellipsis">
2742
+
2743
+ Error Handling
2744
+
2745
+ </span>
2746
+ </a>
2747
+
2748
+ </li>
2749
+
2750
+ </ul>
2751
+ </nav>
2752
+
2753
+ </li>
2754
+
2755
+ <li class="md-nav__item">
2756
+ <a href="#memory" class="md-nav__link">
2757
+ <span class="md-ellipsis">
2758
+
2759
+ Memory
2760
+
2761
+ </span>
2762
+ </a>
2763
+
2764
+ <nav class="md-nav" aria-label="Memory">
2765
+ <ul class="md-nav__list">
2766
+
2767
+ <li class="md-nav__item">
2768
+ <a href="#standalone-vs-network-memory" class="md-nav__link">
2769
+ <span class="md-ellipsis">
2770
+
2771
+ Standalone vs Network Memory
2772
+
2773
+ </span>
2774
+ </a>
2775
+
2776
+ </li>
2777
+
2778
+ <li class="md-nav__item">
2779
+ <a href="#reserved-keys" class="md-nav__link">
2780
+ <span class="md-ellipsis">
2781
+
2782
+ Reserved Keys
2783
+
2784
+ </span>
2785
+ </a>
2786
+
2787
+ </li>
2788
+
2789
+ <li class="md-nav__item">
2790
+ <a href="#reactive-features" class="md-nav__link">
2791
+ <span class="md-ellipsis">
2792
+
2793
+ Reactive Features
2794
+
2795
+ </span>
2796
+ </a>
2797
+
2798
+ </li>
2799
+
2800
+ </ul>
2801
+ </nav>
2802
+
2803
+ </li>
2804
+
2805
+ <li class="md-nav__item">
2806
+ <a href="#message-types" class="md-nav__link">
2807
+ <span class="md-ellipsis">
2808
+
2809
+ Message Types
2810
+
2811
+ </span>
2812
+ </a>
2813
+
2814
+ <nav class="md-nav" aria-label="Message Types">
2815
+ <ul class="md-nav__list">
2816
+
2817
+ <li class="md-nav__item">
2818
+ <a href="#message-roles" class="md-nav__link">
2819
+ <span class="md-ellipsis">
2820
+
2821
+ Message Roles
2822
+
2823
+ </span>
2824
+ </a>
2825
+
2826
+ </li>
2827
+
2828
+ <li class="md-nav__item">
2829
+ <a href="#stop-reasons" class="md-nav__link">
2830
+ <span class="md-ellipsis">
2831
+
2832
+ Stop Reasons
2833
+
2834
+ </span>
2835
+ </a>
2836
+
2837
+ </li>
2838
+
2839
+ </ul>
2840
+ </nav>
2841
+
2842
+ </li>
2843
+
2844
+ <li class="md-nav__item">
2845
+ <a href="#robotresult" class="md-nav__link">
2846
+ <span class="md-ellipsis">
2847
+
2848
+ RobotResult
2849
+
2850
+ </span>
2851
+ </a>
2852
+
2853
+ <nav class="md-nav" aria-label="RobotResult">
2854
+ <ul class="md-nav__list">
2855
+
2856
+ <li class="md-nav__item">
2857
+ <a href="#accessing-response-content" class="md-nav__link">
2858
+ <span class="md-ellipsis">
2859
+
2860
+ Accessing Response Content
2861
+
2862
+ </span>
2863
+ </a>
2864
+
2865
+ </li>
2866
+
2867
+ </ul>
2868
+ </nav>
2869
+
2870
+ </li>
2871
+
2872
+ <li class="md-nav__item">
2873
+ <a href="#configuration" class="md-nav__link">
2874
+ <span class="md-ellipsis">
2875
+
2876
+ Configuration
2877
+
2878
+ </span>
2879
+ </a>
2880
+
2881
+ </li>
2882
+
2883
+ <li class="md-nav__item">
2884
+ <a href="#configuration-hierarchy" class="md-nav__link">
2885
+ <span class="md-ellipsis">
2886
+
2887
+ Configuration Hierarchy
2888
+
2889
+ </span>
2890
+ </a>
2891
+
2892
+ </li>
2893
+
2894
+ <li class="md-nav__item">
2895
+ <a href="#message-bus" class="md-nav__link">
2896
+ <span class="md-ellipsis">
2897
+
2898
+ Message Bus
2899
+
2900
+ </span>
2901
+ </a>
2902
+
2903
+ <nav class="md-nav" aria-label="Message Bus">
2904
+ <ul class="md-nav__list">
2905
+
2906
+ <li class="md-nav__item">
2907
+ <a href="#how-it-works" class="md-nav__link">
2908
+ <span class="md-ellipsis">
2909
+
2910
+ How It Works
2911
+
2912
+ </span>
2913
+ </a>
2914
+
2915
+ </li>
2916
+
2917
+ <li class="md-nav__item">
2918
+ <a href="#robotmessage" class="md-nav__link">
2919
+ <span class="md-ellipsis">
2920
+
2921
+ RobotMessage
2922
+
2923
+ </span>
2924
+ </a>
2925
+
2926
+ </li>
2927
+
2928
+ <li class="md-nav__item">
2929
+ <a href="#sending-and-receiving" class="md-nav__link">
2930
+ <span class="md-ellipsis">
2931
+
2932
+ Sending and Receiving
2933
+
2934
+ </span>
2935
+ </a>
2936
+
2937
+ </li>
2938
+
2939
+ <li class="md-nav__item">
2940
+ <a href="#dynamic-spawning" class="md-nav__link">
2941
+ <span class="md-ellipsis">
2942
+
2943
+ Dynamic Spawning
2944
+
2945
+ </span>
2946
+ </a>
2947
+
2948
+ </li>
2949
+
2950
+ <li class="md-nav__item">
2951
+ <a href="#bus-vs-network" class="md-nav__link">
2952
+ <span class="md-ellipsis">
2953
+
2954
+ Bus vs Network
2955
+
2956
+ </span>
2957
+ </a>
2958
+
2959
+ </li>
2960
+
2961
+ </ul>
2962
+ </nav>
2963
+
2964
+ </li>
2965
+
2966
+ <li class="md-nav__item">
2967
+ <a href="#network" class="md-nav__link">
2968
+ <span class="md-ellipsis">
2969
+
2970
+ Network
2971
+
2972
+ </span>
2973
+ </a>
2974
+
2975
+ </li>
2976
+
2977
+ <li class="md-nav__item">
2978
+ <a href="#next-steps" class="md-nav__link">
2979
+ <span class="md-ellipsis">
2980
+
2981
+ Next Steps
2982
+
2983
+ </span>
2984
+ </a>
2985
+
2986
+ </li>
2987
+
2988
+ </ul>
2989
+
2990
+ </nav>
2991
+ </div>
2992
+ </div>
2993
+ </div>
2994
+
2995
+
2996
+
2997
+ <div class="md-content" data-md-component="content">
2998
+
2999
+
3000
+
3001
+
3002
+
3003
+
3004
+
3005
+ <article class="md-content__inner md-typeset">
3006
+
3007
+
3008
+
3009
+
3010
+
3011
+ <a href="https://github.com/madbomber/robot_lab/edit/main/docs/architecture/core-concepts.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
3012
+
3013
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
3014
+ </a>
3015
+
3016
+
3017
+
3018
+
3019
+
3020
+ <a href="https://github.com/madbomber/robot_lab/raw/main/docs/architecture/core-concepts.md" title="View source of this page" class="md-content__button md-icon">
3021
+
3022
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
3023
+ </a>
3024
+
3025
+
3026
+
3027
+ <h1 id="core-concepts">Core Concepts<a class="headerlink" href="#core-concepts" title="Permanent link">&para;</a></h1>
3028
+ <p>This page provides an in-depth look at RobotLab's fundamental building blocks.</p>
3029
+ <h2 id="robot">Robot<a class="headerlink" href="#robot" title="Permanent link">&para;</a></h2>
3030
+ <p>A Robot is the primary unit of computation in RobotLab. It is a subclass of <code>RubyLLM::Agent</code> that wraps a persistent <code>@chat</code> with:</p>
3031
+ <ul>
3032
+ <li>A unique identity (name, description)</li>
3033
+ <li>A personality (system prompt and/or template)</li>
3034
+ <li>Capabilities (tools, MCP connections)</li>
3035
+ <li>Model and inference configuration</li>
3036
+ <li>Inherent memory (key-value store)</li>
3037
+ </ul>
3038
+ <h3 id="robot-anatomy">Robot Anatomy<a class="headerlink" href="#robot-anatomy" title="Permanent link">&para;</a></h3>
3039
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
3040
+ </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support_agent&quot;</span><span class="p">,</span><span class="w"> </span><span class="c1"># Unique identifier</span>
3041
+ </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w"> </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Handles support requests&quot;</span><span class="p">,</span><span class="w"> </span><span class="c1"># Used for routing hints</span>
3042
+ </span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w"> </span><span class="ss">model</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;claude-sonnet-4&quot;</span><span class="p">,</span><span class="w"> </span><span class="c1"># LLM model</span>
3043
+ </span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span><span class="p">,</span><span class="w"> </span><span class="c1"># Inline system prompt</span>
3044
+ </span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="sh"> You are a friendly customer support agent for Acme Corp.</span>
3045
+ </span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="sh"> Always be polite and helpful. If you don&#39;t know something,</span>
3046
+ </span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="sh"> say so honestly.</span>
3047
+ </span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="dl"> PROMPT</span>
3048
+ </span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w"> </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">OrderLookup</span><span class="p">,</span><span class="w"> </span><span class="no">RefundProcessor</span><span class="o">]</span><span class="p">,</span><span class="w"> </span><span class="c1"># RubyLLM::Tool subclasses</span>
3049
+ </span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w"> </span><span class="ss">mcp</span><span class="p">:</span><span class="w"> </span><span class="ss">:inherit</span><span class="p">,</span><span class="w"> </span><span class="c1"># Use network&#39;s MCP servers</span>
3050
+ </span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w"> </span><span class="ss">temperature</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="o">.</span><span class="mi">7</span><span class="w"> </span><span class="c1"># Inference parameter</span>
3051
+ </span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="p">)</span>
3052
+ </span></code></pre></div>
3053
+ <p>Or with a template:</p>
3054
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
3055
+ </span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support_agent&quot;</span><span class="p">,</span>
3056
+ </span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span><span class="w"> </span><span class="c1"># Loads prompts/support.md</span>
3057
+ </span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Acme Corp&quot;</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="c1"># Template variables</span>
3058
+ </span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w"> </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">OrderLookup</span><span class="o">]</span>
3059
+ </span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="p">)</span>
3060
+ </span></code></pre></div>
3061
+ <h3 id="robot-lifecycle">Robot Lifecycle<a class="headerlink" href="#robot-lifecycle" title="Permanent link">&para;</a></h3>
3062
+ <pre class="mermaid"><code>stateDiagram-v2
3063
+ [*] --&gt; Created: RobotLab.build / Robot.new
3064
+ Created --&gt; Running: robot.run("message")
3065
+ Running --&gt; ToolLoop: tool_call from LLM
3066
+ ToolLoop --&gt; Running: tool result sent back
3067
+ Running --&gt; Completed: final text response
3068
+ Completed --&gt; Running: robot.run("next message")
3069
+ Completed --&gt; [*]: robot.disconnect</code></pre>
3070
+ <p>The persistent <code>@chat</code> maintains conversation history across multiple <code>run</code> calls, making the robot stateful.</p>
3071
+ <h3 id="robot-properties">Robot Properties<a class="headerlink" href="#robot-properties" title="Permanent link">&para;</a></h3>
3072
+ <table>
3073
+ <thead>
3074
+ <tr>
3075
+ <th>Property</th>
3076
+ <th>Type</th>
3077
+ <th>Description</th>
3078
+ </tr>
3079
+ </thead>
3080
+ <tbody>
3081
+ <tr>
3082
+ <td><code>name</code></td>
3083
+ <td><code>String</code></td>
3084
+ <td>Unique identifier within network</td>
3085
+ </tr>
3086
+ <tr>
3087
+ <td><code>description</code></td>
3088
+ <td><code>String</code>, <code>nil</code></td>
3089
+ <td>What the robot does</td>
3090
+ </tr>
3091
+ <tr>
3092
+ <td><code>model</code></td>
3093
+ <td><code>String</code></td>
3094
+ <td>LLM model ID (resolved from chat)</td>
3095
+ </tr>
3096
+ <tr>
3097
+ <td><code>template</code></td>
3098
+ <td><code>Symbol</code>, <code>nil</code></td>
3099
+ <td>Prompt template identifier</td>
3100
+ </tr>
3101
+ <tr>
3102
+ <td><code>system_prompt</code></td>
3103
+ <td><code>String</code>, <code>nil</code></td>
3104
+ <td>Inline system prompt</td>
3105
+ </tr>
3106
+ <tr>
3107
+ <td><code>local_tools</code></td>
3108
+ <td><code>Array</code></td>
3109
+ <td>Locally defined tools</td>
3110
+ </tr>
3111
+ <tr>
3112
+ <td><code>mcp_clients</code></td>
3113
+ <td><code>Hash</code></td>
3114
+ <td>Connected MCP clients by server name</td>
3115
+ </tr>
3116
+ <tr>
3117
+ <td><code>mcp_tools</code></td>
3118
+ <td><code>Array</code></td>
3119
+ <td>Tools discovered from MCP servers</td>
3120
+ </tr>
3121
+ <tr>
3122
+ <td><code>memory</code></td>
3123
+ <td><code>Memory</code></td>
3124
+ <td>Inherent key-value memory</td>
3125
+ </tr>
3126
+ <tr>
3127
+ <td><code>bus</code></td>
3128
+ <td><code>TypedBus::MessageBus</code>, <code>nil</code></td>
3129
+ <td>Message bus instance</td>
3130
+ </tr>
3131
+ <tr>
3132
+ <td><code>outbox</code></td>
3133
+ <td><code>Hash</code></td>
3134
+ <td>Sent messages tracked with status and replies</td>
3135
+ </tr>
3136
+ <tr>
3137
+ <td><code>mcp_config</code></td>
3138
+ <td><code>Symbol</code>, <code>Array</code></td>
3139
+ <td>Build-time MCP configuration</td>
3140
+ </tr>
3141
+ <tr>
3142
+ <td><code>tools_config</code></td>
3143
+ <td><code>Symbol</code>, <code>Array</code></td>
3144
+ <td>Build-time tools configuration</td>
3145
+ </tr>
3146
+ </tbody>
3147
+ </table>
3148
+ <h3 id="running-a-robot">Running a Robot<a class="headerlink" href="#running-a-robot" title="Permanent link">&para;</a></h3>
3149
+ <p>The primary method is <code>robot.run("message")</code>:</p>
3150
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;What is the weather in Berlin?&quot;</span><span class="p">)</span>
3151
+ </span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
3152
+ </span></code></pre></div>
3153
+ <p>With runtime overrides:</p>
3154
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Analyze this&quot;</span><span class="p">,</span>
3155
+ </span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w"> </span><span class="ss">memory</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">data</span><span class="p">:</span><span class="w"> </span><span class="n">report</span><span class="w"> </span><span class="p">},</span>
3156
+ </span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w"> </span><span class="ss">mcp</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span><span class="p">,</span>
3157
+ </span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w"> </span><span class="ss">tools</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span>
3158
+ </span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="p">)</span>
3159
+ </span></code></pre></div>
3160
+ <p>With streaming:</p>
3161
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Tell me a story&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">event</span><span class="o">|</span>
3162
+ </span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w"> </span><span class="nb">print</span><span class="w"> </span><span class="n">event</span><span class="o">.</span><span class="n">text</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">event</span><span class="o">.</span><span class="n">respond_to?</span><span class="p">(</span><span class="ss">:text</span><span class="p">)</span>
3163
+ </span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="k">end</span>
3164
+ </span></code></pre></div>
3165
+ <h2 id="tool">Tool<a class="headerlink" href="#tool" title="Permanent link">&para;</a></h2>
3166
+ <p>Tools give robots the ability to interact with external systems. There are two patterns for defining tools.</p>
3167
+ <h3 id="rubyllmtool-subclass-primary">RubyLLM::Tool Subclass (Primary)<a class="headerlink" href="#rubyllmtool-subclass-primary" title="Permanent link">&para;</a></h3>
3168
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">GetWeather</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RubyLLM</span><span class="o">::</span><span class="no">Tool</span>
3169
+ </span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w"> </span><span class="n">description</span><span class="w"> </span><span class="s2">&quot;Get current weather for a location&quot;</span>
3170
+ </span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>
3171
+ </span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:location</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;string&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;City name&quot;</span>
3172
+ </span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:unit</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;string&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;celsius or fahrenheit&quot;</span>
3173
+ </span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>
3174
+ </span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="ss">location</span><span class="p">:,</span><span class="w"> </span><span class="ss">unit</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;celsius&quot;</span><span class="p">)</span>
3175
+ </span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w"> </span><span class="no">WeatherAPI</span><span class="o">.</span><span class="n">current</span><span class="p">(</span><span class="n">location</span><span class="p">,</span><span class="w"> </span><span class="ss">unit</span><span class="p">:</span><span class="w"> </span><span class="n">unit</span><span class="p">)</span>
3176
+ </span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w"> </span><span class="k">end</span>
3177
+ </span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="k">end</span>
3178
+ </span></code></pre></div>
3179
+ <p>Tools defined as <code>RubyLLM::Tool</code> subclasses are passed to robots via <code>local_tools:</code>:</p>
3180
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
3181
+ </span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;weather_bot&quot;</span><span class="p">,</span>
3182
+ </span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You provide weather information.&quot;</span><span class="p">,</span>
3183
+ </span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w"> </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">GetWeather</span><span class="o">]</span>
3184
+ </span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="p">)</span>
3185
+ </span></code></pre></div>
3186
+ <h3 id="robotlabtoolcreate-factory">RobotLab::Tool.create Factory<a class="headerlink" href="#robotlabtoolcreate-factory" title="Permanent link">&para;</a></h3>
3187
+ <p>For simpler tools that do not need a class:</p>
3188
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="n">tool</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Tool</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
3189
+ </span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;get_time&quot;</span><span class="p">,</span>
3190
+ </span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Get the current time&quot;</span>
3191
+ </span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="o">|</span><span class="n">_args</span><span class="o">|</span><span class="w"> </span><span class="no">Time</span><span class="o">.</span><span class="n">now</span><span class="o">.</span><span class="n">to_s</span><span class="w"> </span><span class="p">}</span>
3192
+ </span></code></pre></div>
3193
+ <p>With parameter schema:</p>
3194
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="n">tool</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Tool</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
3195
+ </span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;get_weather&quot;</span><span class="p">,</span>
3196
+ </span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w"> </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Get weather for a location&quot;</span><span class="p">,</span>
3197
+ </span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w"> </span><span class="ss">parameters</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
3198
+ </span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;object&quot;</span><span class="p">,</span>
3199
+ </span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w"> </span><span class="ss">properties</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
3200
+ </span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w"> </span><span class="ss">location</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;string&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;City name&quot;</span><span class="w"> </span><span class="p">}</span>
3201
+ </span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w"> </span><span class="p">},</span>
3202
+ </span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w"> </span><span class="ss">required</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="s2">&quot;location&quot;</span><span class="o">]</span>
3203
+ </span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w"> </span><span class="p">}</span>
3204
+ </span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="o">|</span><span class="n">args</span><span class="o">|</span><span class="w"> </span><span class="no">WeatherAPI</span><span class="o">.</span><span class="n">current</span><span class="p">(</span><span class="n">args</span><span class="o">[</span><span class="ss">:location</span><span class="o">]</span><span class="p">)</span><span class="w"> </span><span class="p">}</span>
3205
+ </span></code></pre></div>
3206
+ <h3 id="tool-execution">Tool Execution<a class="headerlink" href="#tool-execution" title="Permanent link">&para;</a></h3>
3207
+ <p>When an LLM decides to use a tool:</p>
3208
+ <ol>
3209
+ <li>LLM generates a tool call with tool name and arguments</li>
3210
+ <li><code>@chat</code> (RubyLLM) identifies the tool from its registered tools</li>
3211
+ <li>Calls the <code>execute</code> method with keyword arguments</li>
3212
+ <li>Result is sent back to the LLM for continued processing</li>
3213
+ <li>Loop repeats until the LLM produces a final text response</li>
3214
+ </ol>
3215
+ <h3 id="error-handling">Error Handling<a class="headerlink" href="#error-handling" title="Permanent link">&para;</a></h3>
3216
+ <p>Tool errors are captured and returned to the LLM:</p>
3217
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="ss">order_id</span><span class="p">:)</span>
3218
+ </span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w"> </span><span class="n">order</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">ORDERS</span><span class="o">[</span><span class="n">order_id</span><span class="o">]</span>
3219
+ </span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">order</span>
3220
+ </span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w"> </span><span class="n">order</span>
3221
+ </span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w"> </span><span class="k">else</span>
3222
+ </span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">error</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Order not found&quot;</span><span class="w"> </span><span class="p">}</span>
3223
+ </span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w"> </span><span class="k">end</span>
3224
+ </span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="k">end</span>
3225
+ </span></code></pre></div>
3226
+ <h2 id="memory">Memory<a class="headerlink" href="#memory" title="Permanent link">&para;</a></h2>
3227
+ <p>Memory is a reactive key-value store used by robots and networks.</p>
3228
+ <h3 id="standalone-vs-network-memory">Standalone vs Network Memory<a class="headerlink" href="#standalone-vs-network-memory" title="Permanent link">&para;</a></h3>
3229
+ <ul>
3230
+ <li><strong>Standalone</strong>: Each robot has its own inherent <code>Memory</code> instance (<code>robot.memory</code>)</li>
3231
+ <li><strong>In a Network</strong>: All robots share the network's <code>Memory</code> instance</li>
3232
+ </ul>
3233
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="c1"># Standalone memory</span>
3234
+ </span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="n">robot</span><span class="o">.</span><span class="n">memory</span><span class="o">[</span><span class="ss">:user_id</span><span class="o">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">123</span>
3235
+ </span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="n">robot</span><span class="o">.</span><span class="n">memory</span><span class="o">[</span><span class="ss">:user_id</span><span class="o">]</span><span class="w"> </span><span class="c1"># =&gt; 123</span>
3236
+ </span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a>
3237
+ </span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="c1"># Network memory is passed automatically</span>
3238
+ </span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="n">network</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">create_network</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;pipeline&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">do</span>
3239
+ </span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:robot_a</span><span class="p">,</span><span class="w"> </span><span class="n">robot_a</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span>
3240
+ </span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:robot_b</span><span class="p">,</span><span class="w"> </span><span class="n">robot_b</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:robot_a</span><span class="o">]</span>
3241
+ </span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="k">end</span>
3242
+ </span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="c1"># Both robot_a and robot_b share network.memory during execution</span>
3243
+ </span></code></pre></div>
3244
+ <h3 id="reserved-keys">Reserved Keys<a class="headerlink" href="#reserved-keys" title="Permanent link">&para;</a></h3>
3245
+ <table>
3246
+ <thead>
3247
+ <tr>
3248
+ <th>Key</th>
3249
+ <th>Type</th>
3250
+ <th>Description</th>
3251
+ </tr>
3252
+ </thead>
3253
+ <tbody>
3254
+ <tr>
3255
+ <td><code>:data</code></td>
3256
+ <td><code>Hash</code></td>
3257
+ <td>Runtime data (accessible via <code>memory.data.key_name</code>)</td>
3258
+ </tr>
3259
+ <tr>
3260
+ <td><code>:results</code></td>
3261
+ <td><code>Array</code></td>
3262
+ <td>Accumulated robot results</td>
3263
+ </tr>
3264
+ <tr>
3265
+ <td><code>:messages</code></td>
3266
+ <td><code>Array</code></td>
3267
+ <td>Conversation history</td>
3268
+ </tr>
3269
+ <tr>
3270
+ <td><code>:session_id</code></td>
3271
+ <td><code>String</code></td>
3272
+ <td>Session identifier</td>
3273
+ </tr>
3274
+ <tr>
3275
+ <td><code>:cache</code></td>
3276
+ <td><code>Module</code></td>
3277
+ <td>Semantic cache (RubyLLM::SemanticCache)</td>
3278
+ </tr>
3279
+ </tbody>
3280
+ </table>
3281
+ <h3 id="reactive-features">Reactive Features<a class="headerlink" href="#reactive-features" title="Permanent link">&para;</a></h3>
3282
+ <p>Memory supports pub/sub semantics for inter-robot communication:</p>
3283
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="c1"># Write a value (notifies subscribers, wakes waiters)</span>
3284
+ </span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="n">memory</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="ss">:sentiment</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">score</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="o">.</span><span class="mi">8</span><span class="w"> </span><span class="p">})</span>
3285
+ </span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>
3286
+ </span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="c1"># Read a value (non-blocking)</span>
3287
+ </span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="n">memory</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="ss">:sentiment</span><span class="p">)</span><span class="w"> </span><span class="c1"># =&gt; { score: 0.8 } or nil</span>
3288
+ </span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a>
3289
+ </span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="c1"># Blocking read (waits until value exists)</span>
3290
+ </span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="n">memory</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="ss">:sentiment</span><span class="p">,</span><span class="w"> </span><span class="ss">wait</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span><span class="p">)</span><span class="w"> </span><span class="c1"># Blocks indefinitely</span>
3291
+ </span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="n">memory</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="ss">:sentiment</span><span class="p">,</span><span class="w"> </span><span class="ss">wait</span><span class="p">:</span><span class="w"> </span><span class="mi">30</span><span class="p">)</span><span class="w"> </span><span class="c1"># Blocks up to 30 seconds</span>
3292
+ </span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a>
3293
+ </span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="c1"># Subscribe to changes</span>
3294
+ </span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="n">memory</span><span class="o">.</span><span class="n">subscribe</span><span class="p">(</span><span class="ss">:sentiment</span><span class="p">)</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">change</span><span class="o">|</span>
3295
+ </span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w"> </span><span class="nb">puts</span><span class="w"> </span><span class="s2">&quot;</span><span class="si">#{</span><span class="n">change</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2"> = </span><span class="si">#{</span><span class="n">change</span><span class="o">.</span><span class="n">value</span><span class="si">}</span><span class="s2"> (written by </span><span class="si">#{</span><span class="n">change</span><span class="o">.</span><span class="n">writer</span><span class="si">}</span><span class="s2">)&quot;</span>
3296
+ </span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="k">end</span>
3297
+ </span></code></pre></div>
3298
+ <h2 id="message-types">Message Types<a class="headerlink" href="#message-types" title="Permanent link">&para;</a></h2>
3299
+ <p>RobotLab uses a type hierarchy for messages:</p>
3300
+ <pre class="mermaid"><code>classDiagram
3301
+ Message &lt;|-- TextMessage
3302
+ Message &lt;|-- ToolCallMessage
3303
+ Message &lt;|-- ToolResultMessage
3304
+
3305
+ class Message {
3306
+ +String type
3307
+ +String role
3308
+ +content
3309
+ +String stop_reason
3310
+ +text?()
3311
+ +tool_call?()
3312
+ +tool_result?()
3313
+ +stopped?()
3314
+ }
3315
+
3316
+ class TextMessage {
3317
+ +String content
3318
+ }
3319
+
3320
+ class ToolCallMessage {
3321
+ +Array~ToolMessage~ tools
3322
+ }
3323
+
3324
+ class ToolResultMessage {
3325
+ +ToolMessage tool
3326
+ +Hash content
3327
+ +success?()
3328
+ +error?()
3329
+ }</code></pre>
3330
+ <h3 id="message-roles">Message Roles<a class="headerlink" href="#message-roles" title="Permanent link">&para;</a></h3>
3331
+ <table>
3332
+ <thead>
3333
+ <tr>
3334
+ <th>Role</th>
3335
+ <th>Description</th>
3336
+ </tr>
3337
+ </thead>
3338
+ <tbody>
3339
+ <tr>
3340
+ <td><code>user</code></td>
3341
+ <td>Input from the user</td>
3342
+ </tr>
3343
+ <tr>
3344
+ <td><code>assistant</code></td>
3345
+ <td>Response from the LLM</td>
3346
+ </tr>
3347
+ <tr>
3348
+ <td><code>system</code></td>
3349
+ <td>System instructions</td>
3350
+ </tr>
3351
+ <tr>
3352
+ <td><code>tool_result</code></td>
3353
+ <td>Tool execution result</td>
3354
+ </tr>
3355
+ </tbody>
3356
+ </table>
3357
+ <h3 id="stop-reasons">Stop Reasons<a class="headerlink" href="#stop-reasons" title="Permanent link">&para;</a></h3>
3358
+ <table>
3359
+ <thead>
3360
+ <tr>
3361
+ <th>Reason</th>
3362
+ <th>Description</th>
3363
+ </tr>
3364
+ </thead>
3365
+ <tbody>
3366
+ <tr>
3367
+ <td><code>stop</code></td>
3368
+ <td>Natural completion</td>
3369
+ </tr>
3370
+ <tr>
3371
+ <td><code>tool</code></td>
3372
+ <td>Tool call requested</td>
3373
+ </tr>
3374
+ </tbody>
3375
+ </table>
3376
+ <h2 id="robotresult">RobotResult<a class="headerlink" href="#robotresult" title="Permanent link">&para;</a></h2>
3377
+ <p>The output from a robot execution:</p>
3378
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Hello!&quot;</span><span class="p">)</span>
3379
+ </span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>
3380
+ </span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="n">result</span><span class="o">.</span><span class="n">robot_name</span><span class="w"> </span><span class="c1"># =&gt; &quot;support_agent&quot;</span>
3381
+ </span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="n">result</span><span class="o">.</span><span class="n">output</span><span class="w"> </span><span class="c1"># =&gt; [TextMessage, ...]</span>
3382
+ </span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="n">result</span><span class="o">.</span><span class="n">tool_calls</span><span class="w"> </span><span class="c1"># =&gt; [ToolResultMessage, ...]</span>
3383
+ </span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="n">result</span><span class="o">.</span><span class="n">stop_reason</span><span class="w"> </span><span class="c1"># =&gt; &quot;stop&quot;</span>
3384
+ </span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="n">result</span><span class="o">.</span><span class="n">created_at</span><span class="w"> </span><span class="c1"># =&gt; Time</span>
3385
+ </span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="n">result</span><span class="o">.</span><span class="n">id</span><span class="w"> </span><span class="c1"># =&gt; UUID string</span>
3386
+ </span></code></pre></div>
3387
+ <h3 id="accessing-response-content">Accessing Response Content<a class="headerlink" href="#accessing-response-content" title="Permanent link">&para;</a></h3>
3388
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="c1"># Get last text response (most common)</span>
3389
+ </span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="n">text</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
3390
+ </span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>
3391
+ </span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="c1"># Check if tools were called</span>
3392
+ </span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="n">has_tools</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">has_tool_calls?</span>
3393
+ </span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a>
3394
+ </span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="c1"># Check if execution completed naturally</span>
3395
+ </span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="n">result</span><span class="o">.</span><span class="n">stopped?</span>
3396
+ </span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a>
3397
+ </span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="c1"># Serialization</span>
3398
+ </span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="n">result</span><span class="o">.</span><span class="n">export</span><span class="w"> </span><span class="c1"># =&gt; Hash (excludes debug fields)</span>
3399
+ </span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="n">result</span><span class="o">.</span><span class="n">to_h</span><span class="w"> </span><span class="c1"># =&gt; Hash (includes debug fields)</span>
3400
+ </span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="n">result</span><span class="o">.</span><span class="n">to_json</span><span class="w"> </span><span class="c1"># =&gt; JSON string</span>
3401
+ </span></code></pre></div>
3402
+ <h2 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h2>
3403
+ <p>RobotLab uses <code>MywayConfig</code> for configuration. There is no <code>RobotLab.configure</code> block. Configuration is loaded from:</p>
3404
+ <ol>
3405
+ <li>Bundled defaults (<code>lib/robot_lab/config/defaults.yml</code>)</li>
3406
+ <li>Environment-specific overrides</li>
3407
+ <li>XDG config files (<code>~/.config/robot_lab/config.yml</code>)</li>
3408
+ <li>Project config (<code>./config/robot_lab.yml</code>)</li>
3409
+ <li>Environment variables (<code>ROBOT_LAB_*</code> prefix)</li>
3410
+ </ol>
3411
+ <p>Access via <code>RobotLab.config</code>:</p>
3412
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">model</span><span class="w"> </span><span class="c1"># =&gt; &quot;claude-sonnet-4&quot;</span>
3413
+ </span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">request_timeout</span><span class="w"> </span><span class="c1"># =&gt; 120</span>
3414
+ </span></code></pre></div>
3415
+ <h2 id="configuration-hierarchy">Configuration Hierarchy<a class="headerlink" href="#configuration-hierarchy" title="Permanent link">&para;</a></h2>
3416
+ <p>Tools and MCP servers use a cascading configuration system:</p>
3417
+ <div class="language-text highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>RobotLab.config (global)
3418
+ </span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>|
3419
+ </span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>+-- mcp: [server1, server2]
3420
+ </span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>+-- tools: [tool1, tool2]
3421
+ </span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>|
3422
+ </span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>+-- Network
3423
+ </span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a>| |
3424
+ </span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a>| +-- mcp: :inherit | :none | [servers]
3425
+ </span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a>| +-- tools: :inherit | :none | [tools]
3426
+ </span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a>| |
3427
+ </span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a>| +-- Task (per-step config)
3428
+ </span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a>| | +-- context: { department: &quot;billing&quot; }
3429
+ </span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a>| | +-- mcp: :none | :inherit | [servers]
3430
+ </span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a>| | +-- tools: :none | :inherit | [tools]
3431
+ </span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a>| |
3432
+ </span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a>| +-- Robot (build-time config)
3433
+ </span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a>| |
3434
+ </span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a>| +-- mcp: :inherit | :none | [servers]
3435
+ </span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a>| +-- tools: :inherit | :none | [tools]
3436
+ </span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a>| |
3437
+ </span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a>| +-- run() call (runtime config)
3438
+ </span><span id="__span-15-22"><a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a>| +-- mcp: :none | [servers]
3439
+ </span><span id="__span-15-23"><a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a>| +-- tools: :none | [tools]
3440
+ </span></code></pre></div>
3441
+ <p>Resolution order: <strong>runtime &gt; robot build-time &gt; task &gt; network &gt; global config</strong>.</p>
3442
+ <p>The <code>:inherit</code> value pulls from the parent level. <code>:none</code> explicitly disables.</p>
3443
+ <h2 id="message-bus">Message Bus<a class="headerlink" href="#message-bus" title="Permanent link">&para;</a></h2>
3444
+ <p>The <strong>Message Bus</strong> provides bidirectional, cyclic communication between robots, independent of the Network pipeline. While Networks enforce DAG-based (acyclic) execution, the bus enables negotiation loops, convergence patterns, and multi-turn dialogues.</p>
3445
+ <h3 id="how-it-works">How It Works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h3>
3446
+ <p>Robots connect to a shared <code>TypedBus::MessageBus</code> via the <code>bus:</code> parameter. Each robot gets a typed channel (accepting only <code>RobotMessage</code> objects) named after its <code>name</code>. Messages are delivered asynchronously via the <code>async</code> gem's fiber scheduler.</p>
3447
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="n">bus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">TypedBus</span><span class="o">::</span><span class="no">MessageBus</span><span class="o">.</span><span class="n">new</span>
3448
+ </span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>
3449
+ </span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="n">bob</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bob&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You tell jokes.&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
3450
+ </span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="n">alice</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;alice&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You evaluate jokes.&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
3451
+ </span></code></pre></div>
3452
+ <h3 id="robotmessage">RobotMessage<a class="headerlink" href="#robotmessage" title="Permanent link">&para;</a></h3>
3453
+ <p><code>RobotMessage</code> is an immutable <code>Data.define</code> value object used as the typed envelope:</p>
3454
+ <table>
3455
+ <thead>
3456
+ <tr>
3457
+ <th>Field</th>
3458
+ <th>Type</th>
3459
+ <th>Description</th>
3460
+ </tr>
3461
+ </thead>
3462
+ <tbody>
3463
+ <tr>
3464
+ <td><code>id</code></td>
3465
+ <td><code>Integer</code></td>
3466
+ <td>Per-robot sequential counter</td>
3467
+ </tr>
3468
+ <tr>
3469
+ <td><code>from</code></td>
3470
+ <td><code>String</code></td>
3471
+ <td>Sender's robot name (= channel name)</td>
3472
+ </tr>
3473
+ <tr>
3474
+ <td><code>content</code></td>
3475
+ <td><code>String</code>, <code>Hash</code></td>
3476
+ <td>Message payload</td>
3477
+ </tr>
3478
+ <tr>
3479
+ <td><code>in_reply_to</code></td>
3480
+ <td><code>String</code>, <code>nil</code></td>
3481
+ <td>Composite key of the original message (e.g., <code>"alice:1"</code>)</td>
3482
+ </tr>
3483
+ </tbody>
3484
+ </table>
3485
+ <p>Methods: <code>key</code> returns <code>"from:id"</code> composite identity; <code>reply?</code> returns true when <code>in_reply_to</code> is set.</p>
3486
+ <h3 id="sending-and-receiving">Sending and Receiving<a class="headerlink" href="#sending-and-receiving" title="Permanent link">&para;</a></h3>
3487
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="c1"># Send a message to another robot</span>
3488
+ </span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="n">alice</span><span class="o">.</span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:bob</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Tell me a joke.&quot;</span><span class="p">)</span>
3489
+ </span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>
3490
+ </span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="c1"># Handle incoming messages with auto-ack (1 arg)</span>
3491
+ </span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="n">bob</span><span class="o">.</span><span class="n">on_message</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">message</span><span class="o">|</span>
3492
+ </span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="w"> </span><span class="n">joke</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">bob</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">message</span><span class="o">.</span><span class="n">content</span><span class="o">.</span><span class="n">to_s</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span>
3493
+ </span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="w"> </span><span class="n">bob</span><span class="o">.</span><span class="n">send_reply</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="n">message</span><span class="o">.</span><span class="n">from</span><span class="o">.</span><span class="n">to_sym</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="n">joke</span><span class="p">,</span><span class="w"> </span><span class="ss">in_reply_to</span><span class="p">:</span><span class="w"> </span><span class="n">message</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
3494
+ </span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="k">end</span>
3495
+ </span></code></pre></div>
3496
+ <p>Block arity controls delivery handling: 1 argument auto-acks; 2 arguments give manual control over <code>delivery.ack!</code>/<code>delivery.nack!</code>.</p>
3497
+ <h3 id="dynamic-spawning">Dynamic Spawning<a class="headerlink" href="#dynamic-spawning" title="Permanent link">&para;</a></h3>
3498
+ <p>Robots can create new robots at runtime using <code>spawn</code>. The bus is created lazily — no upfront wiring required:</p>
3499
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="n">dispatcher</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;dispatcher&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You delegate work.&quot;</span><span class="p">)</span>
3500
+ </span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>
3501
+ </span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="c1"># spawn creates a child on the same bus (bus created automatically)</span>
3502
+ </span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="n">helper</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">dispatcher</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;helper&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You answer questions.&quot;</span><span class="p">)</span>
3503
+ </span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a>
3504
+ </span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="c1"># The child can immediately communicate with the parent</span>
3505
+ </span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="n">answer</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">helper</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;What is 2+2?&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span>
3506
+ </span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="n">helper</span><span class="o">.</span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:dispatcher</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="n">answer</span><span class="p">)</span>
3507
+ </span></code></pre></div>
3508
+ <p>Robots can also join a bus after creation using <code>with_bus</code>:</p>
3509
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="n">bot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;late_joiner&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Hello.&quot;</span><span class="p">)</span>
3510
+ </span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="n">bot</span><span class="o">.</span><span class="n">with_bus</span><span class="p">(</span><span class="n">existing_bus</span><span class="p">)</span><span class="w"> </span><span class="c1"># now connected to the bus</span>
3511
+ </span></code></pre></div>
3512
+ <p><strong>Fan-out messaging</strong>: Multiple robots with the same name all subscribe to the same channel. Messages sent to that name are delivered to all subscribers:</p>
3513
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="n">worker1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">dispatcher</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;worker&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Worker 1&quot;</span><span class="p">)</span>
3514
+ </span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="n">worker2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">dispatcher</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;worker&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Worker 2&quot;</span><span class="p">)</span>
3515
+ </span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="n">dispatcher</span><span class="o">.</span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:worker</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Do this task&quot;</span><span class="p">)</span>
3516
+ </span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="c1"># Both worker1 and worker2 receive the message</span>
3517
+ </span></code></pre></div>
3518
+ <h3 id="bus-vs-network">Bus vs Network<a class="headerlink" href="#bus-vs-network" title="Permanent link">&para;</a></h3>
3519
+ <table>
3520
+ <thead>
3521
+ <tr>
3522
+ <th>Feature</th>
3523
+ <th>Network</th>
3524
+ <th>Message Bus</th>
3525
+ </tr>
3526
+ </thead>
3527
+ <tbody>
3528
+ <tr>
3529
+ <td>Execution model</td>
3530
+ <td>DAG (acyclic)</td>
3531
+ <td>Cyclic, bidirectional</td>
3532
+ </tr>
3533
+ <tr>
3534
+ <td>Communication</td>
3535
+ <td>Sequential pipeline</td>
3536
+ <td>Pub/sub channels</td>
3537
+ </tr>
3538
+ <tr>
3539
+ <td>Memory</td>
3540
+ <td>Shared network memory</td>
3541
+ <td>Independent per-robot</td>
3542
+ </tr>
3543
+ <tr>
3544
+ <td>Use case</td>
3545
+ <td>Linear workflows</td>
3546
+ <td>Negotiation, convergence</td>
3547
+ </tr>
3548
+ </tbody>
3549
+ </table>
3550
+ <p>The bus is purely additive — robots without <code>bus:</code> work exactly as before.</p>
3551
+ <h2 id="network">Network<a class="headerlink" href="#network" title="Permanent link">&para;</a></h2>
3552
+ <p>A Network orchestrates multiple robots in a pipeline workflow using SimpleFlow:</p>
3553
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="n">network</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">create_network</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">do</span>
3554
+ </span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:classifier</span><span class="p">,</span><span class="w"> </span><span class="n">classifier_robot</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span>
3555
+ </span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:billing</span><span class="p">,</span><span class="w"> </span><span class="n">billing_robot</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:optional</span>
3556
+ </span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:technical</span><span class="p">,</span><span class="w"> </span><span class="n">technical_robot</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:optional</span>
3557
+ </span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="k">end</span>
3558
+ </span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a>
3559
+ </span><span id="__span-21-7"><a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">network</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="ss">message</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;I need help with billing&quot;</span><span class="p">)</span>
3560
+ </span></code></pre></div>
3561
+ <p>Networks provide:</p>
3562
+ <ul>
3563
+ <li><strong>DAG-based execution</strong> via SimpleFlow with <code>depends_on:</code> for sequencing</li>
3564
+ <li><strong>Parallel execution</strong> for tasks with the same dependencies</li>
3565
+ <li><strong>Optional tasks</strong> activated dynamically by classifier robots</li>
3566
+ <li><strong>Shared memory</strong> for inter-robot communication</li>
3567
+ <li><strong>Per-task configuration</strong> via the <code>Task</code> wrapper</li>
3568
+ <li><strong>Broadcast messaging</strong> for network-wide announcements</li>
3569
+ </ul>
3570
+ <h2 id="next-steps">Next Steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
3571
+ <ul>
3572
+ <li><a href="../robot-execution/">Robot Execution</a> - Detailed execution flow</li>
3573
+ <li><a href="../network-orchestration/">Network Orchestration</a> - Multi-robot coordination</li>
3574
+ <li><a href="../../guides/using-tools/">Using Tools</a> - Creating and using tools</li>
3575
+ </ul>
3576
+
3577
+
3578
+
3579
+
3580
+
3581
+
3582
+
3583
+
3584
+
3585
+
3586
+
3587
+
3588
+
3589
+ <form class="md-feedback" name="feedback" hidden>
3590
+ <fieldset>
3591
+ <legend class="md-feedback__title">
3592
+ Was this page helpful?
3593
+ </legend>
3594
+ <div class="md-feedback__inner">
3595
+ <div class="md-feedback__list">
3596
+
3597
+ <button class="md-feedback__icon md-icon" type="submit" title="This page was helpful" data-md-value="1">
3598
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81"/></svg>
3599
+ </button>
3600
+
3601
+ <button class="md-feedback__icon md-icon" type="submit" title="This page could be improved" data-md-value="0">
3602
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14"/></svg>
3603
+ </button>
3604
+
3605
+ </div>
3606
+ <div class="md-feedback__note">
3607
+
3608
+ <div data-md-value="1" hidden>
3609
+
3610
+
3611
+
3612
+
3613
+
3614
+
3615
+
3616
+
3617
+
3618
+ Thanks for your feedback!
3619
+ </div>
3620
+
3621
+ <div data-md-value="0" hidden>
3622
+
3623
+
3624
+
3625
+
3626
+
3627
+
3628
+
3629
+
3630
+
3631
+ Thanks for your feedback! Help us improve by creating an issue.
3632
+ </div>
3633
+
3634
+ </div>
3635
+ </div>
3636
+ </fieldset>
3637
+ </form>
3638
+
3639
+
3640
+
3641
+ </article>
3642
+ </div>
3643
+
3644
+
3645
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
3646
+
3647
+ <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
3648
+ </div>
3649
+
3650
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
3651
+
3652
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
3653
+ Back to top
3654
+ </button>
3655
+
3656
+ </main>
3657
+
3658
+ <footer class="md-footer">
3659
+
3660
+
3661
+
3662
+ <nav class="md-footer__inner md-grid" aria-label="Footer" >
3663
+
3664
+
3665
+ <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Architecture Overview">
3666
+ <div class="md-footer__button md-icon">
3667
+
3668
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
3669
+ </div>
3670
+ <div class="md-footer__title">
3671
+ <span class="md-footer__direction">
3672
+ Previous
3673
+ </span>
3674
+ <div class="md-ellipsis">
3675
+ Architecture Overview
3676
+ </div>
3677
+ </div>
3678
+ </a>
3679
+
3680
+
3681
+
3682
+ <a href="../robot-execution/" class="md-footer__link md-footer__link--next" aria-label="Next: Robot Execution">
3683
+ <div class="md-footer__title">
3684
+ <span class="md-footer__direction">
3685
+ Next
3686
+ </span>
3687
+ <div class="md-ellipsis">
3688
+ Robot Execution
3689
+ </div>
3690
+ </div>
3691
+ <div class="md-footer__button md-icon">
3692
+
3693
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
3694
+ </div>
3695
+ </a>
3696
+
3697
+ </nav>
3698
+
3699
+
3700
+ <div class="md-footer-meta md-typeset">
3701
+ <div class="md-footer-meta__inner md-grid">
3702
+ <div class="md-copyright">
3703
+
3704
+ <div class="md-copyright__highlight">
3705
+ Copyright &copy; 2025 Dewayne VanHoozer
3706
+ </div>
3707
+
3708
+
3709
+ Made with
3710
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
3711
+ Material for MkDocs
3712
+ </a>
3713
+
3714
+ </div>
3715
+
3716
+
3717
+ <div class="md-social">
3718
+
3719
+
3720
+
3721
+
3722
+
3723
+ <a href="https://github.com/madbomber/robot_lab" target="_blank" rel="noopener" title="RobotLab on GitHub" class="md-social__link">
3724
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
3725
+ </a>
3726
+
3727
+
3728
+
3729
+
3730
+
3731
+ <a href="https://rubygems.org/gems/robot_lab" target="_blank" rel="noopener" title="RobotLab on RubyGems" class="md-social__link">
3732
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M116.7 33.8c4.5-6.1 11.7-9.8 19.3-9.8h240c7.6 0 14.8 3.6 19.3 9.8l112 152c6.8 9.2 6.1 21.9-1.5 30.4l-232 256c-4.5 5-11 7.9-17.8 7.9s-13.2-2.9-17.8-7.9l-232-256c-7.7-8.5-8.3-21.2-1.5-30.4zm38.5 39.8c-3.3 2.5-4.2 7-2.1 10.5l57.4 95.7L63.3 192c-4.1.3-7.3 3.8-7.3 8s3.2 7.6 7.3 8l192 16h1.3l192-16c4.1-.3 7.3-3.8 7.3-8s-3.2-7.6-7.3-8l-147.2-12.3 57.4-95.6c2.1-3.5 1.2-8.1-2.1-10.5s-7.9-2-10.7 1l-90 97.6-90.1-97.6c-2.8-3-7.4-3.4-10.7-1"/></svg>
3733
+ </a>
3734
+
3735
+ </div>
3736
+
3737
+ </div>
3738
+ </div>
3739
+ </footer>
3740
+
3741
+ </div>
3742
+ <div class="md-dialog" data-md-component="dialog">
3743
+ <div class="md-dialog__inner md-typeset"></div>
3744
+ </div>
3745
+
3746
+
3747
+
3748
+
3749
+
3750
+ <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer", "toc.follow", "search.suggest", "search.highlight", "search.share", "header.autohide", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.tooltips", "content.action.edit", "content.action.view"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
3751
+
3752
+
3753
+ <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
3754
+
3755
+
3756
+ </body>
3757
+ </html>