PhyAgentOS-ai 1.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. phyagentos_ai-1.1.1/.dockerignore +13 -0
  2. phyagentos_ai-1.1.1/.gitignore +28 -0
  3. phyagentos_ai-1.1.1/CHANGELOG.md +218 -0
  4. phyagentos_ai-1.1.1/Dockerfile +49 -0
  5. phyagentos_ai-1.1.1/LICENSE +21 -0
  6. phyagentos_ai-1.1.1/PKG-INFO +412 -0
  7. phyagentos_ai-1.1.1/PhyAgentOS/__init__.py +6 -0
  8. phyagentos_ai-1.1.1/PhyAgentOS/__main__.py +8 -0
  9. phyagentos_ai-1.1.1/PhyAgentOS/agent/__init__.py +21 -0
  10. phyagentos_ai-1.1.1/PhyAgentOS/agent/context.py +253 -0
  11. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/__init__.py +40 -0
  12. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/activation.py +323 -0
  13. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/analyzer.py +214 -0
  14. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/contracts.py +330 -0
  15. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/coordinator.py +406 -0
  16. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/evolution.py +896 -0
  17. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/redaction.py +46 -0
  18. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/source.py +184 -0
  19. phyagentos_ai-1.1.1/PhyAgentOS/agent/experience/store.py +780 -0
  20. phyagentos_ai-1.1.1/PhyAgentOS/agent/interaction/__init__.py +1 -0
  21. phyagentos_ai-1.1.1/PhyAgentOS/agent/interaction/model.py +89 -0
  22. phyagentos_ai-1.1.1/PhyAgentOS/agent/interaction/runner.py +856 -0
  23. phyagentos_ai-1.1.1/PhyAgentOS/agent/interaction/supervisor.py +248 -0
  24. phyagentos_ai-1.1.1/PhyAgentOS/agent/loop.py +822 -0
  25. phyagentos_ai-1.1.1/PhyAgentOS/agent/memory.py +289 -0
  26. phyagentos_ai-1.1.1/PhyAgentOS/agent/session_verifier.py +277 -0
  27. phyagentos_ai-1.1.1/PhyAgentOS/agent/skills.py +374 -0
  28. phyagentos_ai-1.1.1/PhyAgentOS/agent/subagent.py +235 -0
  29. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/__init__.py +6 -0
  30. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/agent.py +125 -0
  31. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/base.py +181 -0
  32. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/cron.py +158 -0
  33. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/filesystem.py +365 -0
  34. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/forge_task.py +235 -0
  35. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/forge_tool_api.py +407 -0
  36. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/image.py +547 -0
  37. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/mcp.py +148 -0
  38. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/message.py +109 -0
  39. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/registry.py +74 -0
  40. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/scene_graph.py +89 -0
  41. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/shell.py +179 -0
  42. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/skill_activation.py +60 -0
  43. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/spawn.py +63 -0
  44. phyagentos_ai-1.1.1/PhyAgentOS/agent/tools/web.py +188 -0
  45. phyagentos_ai-1.1.1/PhyAgentOS/bus/__init__.py +6 -0
  46. phyagentos_ai-1.1.1/PhyAgentOS/bus/events.py +38 -0
  47. phyagentos_ai-1.1.1/PhyAgentOS/bus/queue.py +44 -0
  48. phyagentos_ai-1.1.1/PhyAgentOS/channels/__init__.py +6 -0
  49. phyagentos_ai-1.1.1/PhyAgentOS/channels/base.py +134 -0
  50. phyagentos_ai-1.1.1/PhyAgentOS/channels/dingtalk.py +479 -0
  51. phyagentos_ai-1.1.1/PhyAgentOS/channels/discord.py +377 -0
  52. phyagentos_ai-1.1.1/PhyAgentOS/channels/email.py +409 -0
  53. phyagentos_ai-1.1.1/PhyAgentOS/channels/feishu.py +1008 -0
  54. phyagentos_ai-1.1.1/PhyAgentOS/channels/manager.py +155 -0
  55. phyagentos_ai-1.1.1/PhyAgentOS/channels/matrix.py +704 -0
  56. phyagentos_ai-1.1.1/PhyAgentOS/channels/mochat.py +896 -0
  57. phyagentos_ai-1.1.1/PhyAgentOS/channels/qq.py +161 -0
  58. phyagentos_ai-1.1.1/PhyAgentOS/channels/registry.py +35 -0
  59. phyagentos_ai-1.1.1/PhyAgentOS/channels/slack.py +280 -0
  60. phyagentos_ai-1.1.1/PhyAgentOS/channels/telegram.py +776 -0
  61. phyagentos_ai-1.1.1/PhyAgentOS/channels/wecom.py +353 -0
  62. phyagentos_ai-1.1.1/PhyAgentOS/channels/whatsapp.py +171 -0
  63. phyagentos_ai-1.1.1/PhyAgentOS/cli/__init__.py +1 -0
  64. phyagentos_ai-1.1.1/PhyAgentOS/cli/commands.py +1743 -0
  65. phyagentos_ai-1.1.1/PhyAgentOS/cli/providers.py +516 -0
  66. phyagentos_ai-1.1.1/PhyAgentOS/config/__init__.py +30 -0
  67. phyagentos_ai-1.1.1/PhyAgentOS/config/loader.py +129 -0
  68. phyagentos_ai-1.1.1/PhyAgentOS/config/paths.py +80 -0
  69. phyagentos_ai-1.1.1/PhyAgentOS/config/schema.py +626 -0
  70. phyagentos_ai-1.1.1/PhyAgentOS/cron/__init__.py +6 -0
  71. phyagentos_ai-1.1.1/PhyAgentOS/cron/service.py +400 -0
  72. phyagentos_ai-1.1.1/PhyAgentOS/cron/types.py +59 -0
  73. phyagentos_ai-1.1.1/PhyAgentOS/embodiment_registry.py +109 -0
  74. phyagentos_ai-1.1.1/PhyAgentOS/forge/__init__.py +6 -0
  75. phyagentos_ai-1.1.1/PhyAgentOS/forge/binding.py +319 -0
  76. phyagentos_ai-1.1.1/PhyAgentOS/forge/evidence.py +356 -0
  77. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/__init__.py +1 -0
  78. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/binding.py +149 -0
  79. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/client.py +209 -0
  80. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/contracts.py +161 -0
  81. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/evidence.py +163 -0
  82. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/runner_store.py +495 -0
  83. phyagentos_ai-1.1.1/PhyAgentOS/forge/interaction/service.py +373 -0
  84. phyagentos_ai-1.1.1/PhyAgentOS/forge/observation.py +354 -0
  85. phyagentos_ai-1.1.1/PhyAgentOS/forge/task.py +1564 -0
  86. phyagentos_ai-1.1.1/PhyAgentOS/forge/tool_client.py +306 -0
  87. phyagentos_ai-1.1.1/PhyAgentOS/heartbeat/__init__.py +5 -0
  88. phyagentos_ai-1.1.1/PhyAgentOS/heartbeat/service.py +173 -0
  89. phyagentos_ai-1.1.1/PhyAgentOS/plugins/__init__.py +2 -0
  90. phyagentos_ai-1.1.1/PhyAgentOS/providers/__init__.py +28 -0
  91. phyagentos_ai-1.1.1/PhyAgentOS/providers/_openai_client.py +65 -0
  92. phyagentos_ai-1.1.1/PhyAgentOS/providers/azure_openai_provider.py +219 -0
  93. phyagentos_ai-1.1.1/PhyAgentOS/providers/base.py +308 -0
  94. phyagentos_ai-1.1.1/PhyAgentOS/providers/custom_provider.py +83 -0
  95. phyagentos_ai-1.1.1/PhyAgentOS/providers/discovery.py +102 -0
  96. phyagentos_ai-1.1.1/PhyAgentOS/providers/effort.py +161 -0
  97. phyagentos_ai-1.1.1/PhyAgentOS/providers/errors.py +45 -0
  98. phyagentos_ai-1.1.1/PhyAgentOS/providers/litellm_provider.py +325 -0
  99. phyagentos_ai-1.1.1/PhyAgentOS/providers/openai_codex_provider.py +325 -0
  100. phyagentos_ai-1.1.1/PhyAgentOS/providers/openai_responses_provider.py +196 -0
  101. phyagentos_ai-1.1.1/PhyAgentOS/providers/providers_manager.py +226 -0
  102. phyagentos_ai-1.1.1/PhyAgentOS/providers/registry.py +560 -0
  103. phyagentos_ai-1.1.1/PhyAgentOS/providers/service.py +568 -0
  104. phyagentos_ai-1.1.1/PhyAgentOS/providers/transcription.py +64 -0
  105. phyagentos_ai-1.1.1/PhyAgentOS/session/__init__.py +5 -0
  106. phyagentos_ai-1.1.1/PhyAgentOS/session/manager.py +213 -0
  107. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/__init__.py +25 -0
  108. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/archive.py +293 -0
  109. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/catalog.py +78 -0
  110. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/installer.py +553 -0
  111. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/integration.py +388 -0
  112. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/locking.py +79 -0
  113. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/manager.py +698 -0
  114. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/manifest.py +348 -0
  115. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/node_manifest.py +185 -0
  116. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/registry.py +503 -0
  117. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/runtime_manifest.py +189 -0
  118. phyagentos_ai-1.1.1/PhyAgentOS/skill_runtime/state.py +230 -0
  119. phyagentos_ai-1.1.1/PhyAgentOS/skills/README.md +38 -0
  120. phyagentos_ai-1.1.1/PhyAgentOS/skills/agent-mode/SKILL.md +87 -0
  121. phyagentos_ai-1.1.1/PhyAgentOS/skills/clawhub/SKILL.md +53 -0
  122. phyagentos_ai-1.1.1/PhyAgentOS/skills/cron/SKILL.md +57 -0
  123. phyagentos_ai-1.1.1/PhyAgentOS/skills/github/SKILL.md +48 -0
  124. phyagentos_ai-1.1.1/PhyAgentOS/skills/image/SKILL.md +98 -0
  125. phyagentos_ai-1.1.1/PhyAgentOS/skills/memory/SKILL.md +37 -0
  126. phyagentos_ai-1.1.1/PhyAgentOS/skills/skill-creator/SKILL.md +374 -0
  127. phyagentos_ai-1.1.1/PhyAgentOS/skills/skill-creator/scripts/init_skill.py +378 -0
  128. phyagentos_ai-1.1.1/PhyAgentOS/skills/skill-creator/scripts/package_skill.py +154 -0
  129. phyagentos_ai-1.1.1/PhyAgentOS/skills/skill-creator/scripts/quick_validate.py +213 -0
  130. phyagentos_ai-1.1.1/PhyAgentOS/skills/summarize/SKILL.md +67 -0
  131. phyagentos_ai-1.1.1/PhyAgentOS/skills/tmux/SKILL.md +121 -0
  132. phyagentos_ai-1.1.1/PhyAgentOS/skills/tmux/scripts/find-sessions.sh +112 -0
  133. phyagentos_ai-1.1.1/PhyAgentOS/skills/tmux/scripts/wait-for-text.sh +83 -0
  134. phyagentos_ai-1.1.1/PhyAgentOS/skills/weather/SKILL.md +49 -0
  135. phyagentos_ai-1.1.1/PhyAgentOS/templates/AGENTS.md +21 -0
  136. phyagentos_ai-1.1.1/PhyAgentOS/templates/EMBODIED.md +12 -0
  137. phyagentos_ai-1.1.1/PhyAgentOS/templates/ENVIRONMENT.md +22 -0
  138. phyagentos_ai-1.1.1/PhyAgentOS/templates/HEARTBEAT.md +17 -0
  139. phyagentos_ai-1.1.1/PhyAgentOS/templates/LESSONS.md +11 -0
  140. phyagentos_ai-1.1.1/PhyAgentOS/templates/ORCHESTRATOR.md +23 -0
  141. phyagentos_ai-1.1.1/PhyAgentOS/templates/SKILLS.md +46 -0
  142. phyagentos_ai-1.1.1/PhyAgentOS/templates/SOUL.md +21 -0
  143. phyagentos_ai-1.1.1/PhyAgentOS/templates/TASK.md +13 -0
  144. phyagentos_ai-1.1.1/PhyAgentOS/templates/TOOLS.md +15 -0
  145. phyagentos_ai-1.1.1/PhyAgentOS/templates/USER.md +49 -0
  146. phyagentos_ai-1.1.1/PhyAgentOS/templates/__init__.py +0 -0
  147. phyagentos_ai-1.1.1/PhyAgentOS/templates/memory/MEMORY.md +23 -0
  148. phyagentos_ai-1.1.1/PhyAgentOS/templates/memory/__init__.py +0 -0
  149. phyagentos_ai-1.1.1/PhyAgentOS/utils/__init__.py +5 -0
  150. phyagentos_ai-1.1.1/PhyAgentOS/utils/atomic_file.py +26 -0
  151. phyagentos_ai-1.1.1/PhyAgentOS/utils/helpers.py +255 -0
  152. phyagentos_ai-1.1.1/PhyAgentOS/verification/__init__.py +39 -0
  153. phyagentos_ai-1.1.1/PhyAgentOS/verification/contracts.py +406 -0
  154. phyagentos_ai-1.1.1/PhyAgentOS/verification/engine.py +34 -0
  155. phyagentos_ai-1.1.1/PhyAgentOS/verification/request_builder.py +397 -0
  156. phyagentos_ai-1.1.1/PhyAgentOS/verification/service.py +308 -0
  157. phyagentos_ai-1.1.1/README.md +354 -0
  158. phyagentos_ai-1.1.1/README_zh.md +355 -0
  159. phyagentos_ai-1.1.1/bridge/package-lock.json +1373 -0
  160. phyagentos_ai-1.1.1/bridge/package.json +26 -0
  161. phyagentos_ai-1.1.1/bridge/src/index.ts +51 -0
  162. phyagentos_ai-1.1.1/bridge/src/server.ts +129 -0
  163. phyagentos_ai-1.1.1/bridge/src/types.d.ts +3 -0
  164. phyagentos_ai-1.1.1/bridge/src/whatsapp.ts +239 -0
  165. phyagentos_ai-1.1.1/bridge/tsconfig.json +16 -0
  166. phyagentos_ai-1.1.1/docker-compose.yml +31 -0
  167. phyagentos_ai-1.1.1/docs/README.md +63 -0
  168. phyagentos_ai-1.1.1/docs/README_zh.md +62 -0
  169. phyagentos_ai-1.1.1/docs/benchmarks.md +92 -0
  170. phyagentos_ai-1.1.1/docs/en/01-framework-introduction.md +178 -0
  171. phyagentos_ai-1.1.1/docs/en/02-user-manual.md +516 -0
  172. phyagentos_ai-1.1.1/docs/en/03-developer-manual.md +185 -0
  173. phyagentos_ai-1.1.1/docs/en/04-forge-configuration-reference.md +281 -0
  174. phyagentos_ai-1.1.1/docs/en/05-agent-experience-and-skill-evolution.md +207 -0
  175. phyagentos_ai-1.1.1/docs/forge/README.md +227 -0
  176. phyagentos_ai-1.1.1/docs/forge/README_zh.md +213 -0
  177. phyagentos_ai-1.1.1/docs/imgs/HCP.jpg +0 -0
  178. phyagentos_ai-1.1.1/docs/imgs/Pengcheng.png +0 -0
  179. phyagentos_ai-1.1.1/docs/imgs/PhyAgentOS.png +0 -0
  180. phyagentos_ai-1.1.1/docs/imgs/PhyAgentOS_en.png +0 -0
  181. phyagentos_ai-1.1.1/docs/imgs/PhyAgentOS_zh.png +0 -0
  182. phyagentos_ai-1.1.1/docs/imgs/SYSU.png +0 -0
  183. phyagentos_ai-1.1.1/docs/imgs/benchmark-libero-long-en.png +0 -0
  184. phyagentos_ai-1.1.1/docs/imgs/benchmark-libero-long-original.png +0 -0
  185. phyagentos_ai-1.1.1/docs/imgs/benchmark-robodojo-en.png +0 -0
  186. phyagentos_ai-1.1.1/docs/imgs/benchmark-robodojo-original.png +0 -0
  187. phyagentos_ai-1.1.1/docs/imgs/benchmark-robotwin-en.png +0 -0
  188. phyagentos_ai-1.1.1/docs/imgs/benchmark-robotwin-original.png +0 -0
  189. phyagentos_ai-1.1.1/docs/imgs/control-modes-en.png +0 -0
  190. phyagentos_ai-1.1.1/docs/imgs/control-modes-original.jpg +0 -0
  191. phyagentos_ai-1.1.1/docs/imgs/english-images.prompts.md +19 -0
  192. phyagentos_ai-1.1.1/docs/imgs/framework.png +0 -0
  193. phyagentos_ai-1.1.1/docs/imgs/gosim-shenzhen-2026.jpg +0 -0
  194. phyagentos_ai-1.1.1/docs/imgs/logo-xera-mark.png +0 -0
  195. phyagentos_ai-1.1.1/docs/imgs/logo_en.png +0 -0
  196. phyagentos_ai-1.1.1/docs/imgs/quickstart/robot-control-sim-eef-control.gif +0 -0
  197. phyagentos_ai-1.1.1/docs/imgs/quickstart/robot-control-sim-joint-control.gif +0 -0
  198. phyagentos_ai-1.1.1/docs/imgs/quickstart/robot-control-sim-startup.gif +0 -0
  199. phyagentos_ai-1.1.1/docs/imgs/runtime-control-modes.png +0 -0
  200. phyagentos_ai-1.1.1/docs/imgs/runtime-control-modes.prompt.md +12 -0
  201. phyagentos_ai-1.1.1/docs/interaction/README.md +193 -0
  202. phyagentos_ai-1.1.1/docs/interaction/README_zh.md +144 -0
  203. phyagentos_ai-1.1.1/docs/news/gosim-shenzhen-2026.md +38 -0
  204. phyagentos_ai-1.1.1/docs/news/gosim-shenzhen-2026_zh.md +38 -0
  205. phyagentos_ai-1.1.1/docs/user_development_guide/COMMUNICATION.md +126 -0
  206. phyagentos_ai-1.1.1/docs/user_development_guide/COMMUNICATION_zh.md +122 -0
  207. phyagentos_ai-1.1.1/docs/user_development_guide/PIPER_X_DEMO.md +308 -0
  208. phyagentos_ai-1.1.1/docs/user_development_guide/PIPER_X_DEMO_zh.md +303 -0
  209. phyagentos_ai-1.1.1/docs/user_development_guide/README.md +295 -0
  210. phyagentos_ai-1.1.1/docs/user_development_guide/README_zh.md +282 -0
  211. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/PROTOCOLS.md +151 -0
  212. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/PROTOCOLS_zh.md +150 -0
  213. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/README.md +104 -0
  214. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/README_zh.md +102 -0
  215. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/REPOSITORIES.md +148 -0
  216. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/REPOSITORIES_zh.md +147 -0
  217. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/RUNTIME.md +296 -0
  218. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/RUNTIME_zh.md +297 -0
  219. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/SKILL_DEVELOPMENT.md +289 -0
  220. phyagentos_ai-1.1.1/docs/user_development_guide/track_b/SKILL_DEVELOPMENT_zh.md +290 -0
  221. phyagentos_ai-1.1.1/docs/user_manual/DOCKER.md +199 -0
  222. phyagentos_ai-1.1.1/docs/user_manual/DOCKER_zh.md +196 -0
  223. phyagentos_ai-1.1.1/docs/user_manual/README.md +199 -0
  224. phyagentos_ai-1.1.1/docs/user_manual/README_zh.md +194 -0
  225. phyagentos_ai-1.1.1/docs/zh/01-framework-introduction.md +170 -0
  226. phyagentos_ai-1.1.1/docs/zh/02-user-manual.md +483 -0
  227. phyagentos_ai-1.1.1/docs/zh/03-developer-manual.md +175 -0
  228. phyagentos_ai-1.1.1/docs/zh/04-forge-configuration-reference.md +274 -0
  229. phyagentos_ai-1.1.1/docs/zh/05-agent-experience-and-skill-evolution.md +207 -0
  230. phyagentos_ai-1.1.1/environment.yml +10 -0
  231. phyagentos_ai-1.1.1/example/robot-control-sim-piper-x/README.md +32 -0
  232. phyagentos_ai-1.1.1/example/robot-control-sim-piper-x/README_zh.md +25 -0
  233. phyagentos_ai-1.1.1/pyproject.toml +131 -0
  234. phyagentos_ai-1.1.1/scripts/install.sh +140 -0
  235. phyagentos_ai-1.1.1/scripts/package_skill.py +147 -0
@@ -0,0 +1,13 @@
1
+ __pycache__
2
+ *.pyc
3
+ *.pyo
4
+ *.pyd
5
+ *.egg-info
6
+ dist/
7
+ build/
8
+ .git
9
+ .env
10
+ .assets
11
+ node_modules/
12
+ bridge/dist/
13
+ workspace/
@@ -0,0 +1,28 @@
1
+ .worktrees/
2
+ .assets
3
+ .env
4
+ *.pyc
5
+ dist/
6
+ build/
7
+ *.egg-info/
8
+ *.egg
9
+ *.pyc
10
+ *.pyo
11
+ *.pyd
12
+ *.pyw
13
+ *.pyz
14
+ *.pywz
15
+ *.pyzz
16
+ .venv/
17
+ venv/
18
+ __pycache__/
19
+ poetry.lock
20
+ .pytest_cache/
21
+ botpy.log
22
+ nano.*.save
23
+ SECURITY.md
24
+ .kilo
25
+ *.codegraph
26
+ uv.lock
27
+ plan/
28
+ external/
@@ -0,0 +1,218 @@
1
+ # Changelog
2
+
3
+ All notable changes to PhyAgentOS are documented here. Categories follow Keep a Changelog.
4
+
5
+ ## [v1.1.1] - 2026-10-23
6
+
7
+ Skill development, execution reliability and the Opper gateway. Changes since v1.1.0.
8
+
9
+ ### Added
10
+
11
+ - Opper as an OpenAI-compatible gateway, with provider selection, environment
12
+ credentials and model identifiers preserved in routed requests.
13
+ - Bilingual Track B development guides and an independent Piper X simulation
14
+ Skill example covering model conversion, original Node locks, packaging,
15
+ and validation with its recorded runtime baseline.
16
+ - Bilingual contribution guides, MuJoCo Quickstart GIFs, and a GOSIM Shenzhen
17
+ 2026 announcement.
18
+
19
+ ### Changed
20
+
21
+ - Local workflow-document and Node-executable modifications produce warnings
22
+ during task creation and Runtime startup. Bindings freeze the activated
23
+ workflow document hash and experience records use it for attribution.
24
+ - Consolidate bilingual manuals, developer references and documentation
25
+ navigation while retaining benchmark documentation links.
26
+ - Synchronize package, CLI, bundled bridge, Docker, release-build defaults,
27
+ README and current documentation versions to 1.1.1.
28
+
29
+ ### Fixed
30
+
31
+ - Keep explicit Node verification and install-cache acceptance strict for
32
+ modified executables, and retain Skill/Runtime version compatibility checks.
33
+ - Record structured Gateway rejections known to occur before Action dispatch
34
+ as failed, allowing a later retry without the unknown-execution guard.
35
+ Timeouts, transport failures and identified remote invocations remain unknown.
36
+ - Exclude pre-dispatch rejections from task finalization and cancellation
37
+ execution facts; a task with no executed calls still fails. Structured
38
+ admission rejection codes require Forge Gateway 1.1.2 or newer; older
39
+ unstructured responses retain conservative handling.
40
+ - Add regression coverage for Opper routing, local Node modifications and
41
+ pre-dispatch Action rejection handling.
42
+
43
+ [Full comparison: v1.1.0...v1.1.1](https://github.com/PhyAgentOS/PhyAgentOS-core/compare/v1.1.0...v1.1.1)
44
+
45
+ ## [v1.1.0] - 2026-10-09
46
+
47
+ Provider management, Skill Runtime and governed interactions. Changes since v1.0.0.
48
+
49
+ ### Added
50
+
51
+ - Centralized provider management with configuration, testing, authentication,
52
+ model discovery, saved model selection and per-session runtime overrides.
53
+ - Direct OpenAI Responses API support, including tool calls, multimodal input,
54
+ reasoning effort and integration with the Forge verifier.
55
+ - Requesty, Cheaper Inference and API Route as OpenAI-compatible gateways.
56
+ - `directory_tar_gz` Forge Node packages for executables with bundled runtime
57
+ dependencies and validated internal relative symbolic links.
58
+ - An opt-in interaction foundation connecting AgentTask, Session, multi-step
59
+ decisions, independent root verification and one deduplicated experience
60
+ episode, backed by frozen bindings, a persistent Runner and a Supervisor.
61
+
62
+ ### Changed
63
+
64
+ - Skill profiles support startup timeouts and `required_tools` overrides; startup
65
+ hooks receive profile, Python and Skill context for LIBERO 0.3.4 prerequisites.
66
+ - Custom and Responses providers support configurable timeouts and retries,
67
+ with improved `max_completion_tokens` compatibility.
68
+ - Failed model completions return explicit errors while retaining user input
69
+ and completed tool exchanges without storing error text as assistant history.
70
+ - Ordinary and interactive tasks reject new Query, Action and Session intents
71
+ after cancellation is persisted or the task leaves the executing state.
72
+
73
+ ### Fixed
74
+
75
+ - Preserve valid cron jobs when individual records are malformed; quarantine
76
+ unreadable stores and refuse to overwrite them if quarantine fails.
77
+ - Parse Dora JSON and NDJSON status output and inject profile environments into
78
+ rendered dataflow nodes to avoid stale flow and daemon-environment effects.
79
+ - Improve archive path containment, symbolic-link validation, image-path cleanup
80
+ and compatibility across providers.
81
+ - Pin Runtime identity for interaction dispatch, discard late decisions after
82
+ cancellation, prevent automatic retransmission of uncertain operations and
83
+ retain resource guards until outstanding execution is reconciled.
84
+ - Expand regression coverage and build checks; improve bilingual documentation,
85
+ Piper and LIBERO-10 quickstarts, and benchmark scope and result reporting.
86
+
87
+ [Full comparison: v1.0.0...v1.1.0](https://github.com/PhyAgentOS/PhyAgentOS-core/compare/v1.0.0...v1.1.0)
88
+
89
+ ## [v1.0.0] - 2026-08-30
90
+
91
+ Initial stable release of PhyAgentOS.
92
+
93
+ ### Security
94
+
95
+ - Upgraded `@whiskeysockets/baileys` to `7.0.0-rc14` to address
96
+ `CVE-2026-48063` / `GHSA-qvv5-jq5g-4cgg`, and locked the Bridge dependency graph.
97
+
98
+ ## [v0.2.3] - 2026-08-27
99
+
100
+ PhyAgentOS can run independently distributed Forge Skills through a task-scoped, immutable
101
+ Skill/Runtime/ToolSpec binding while keeping Gateway as the execution authority.
102
+
103
+ ### Added
104
+
105
+ - Added first-class Query, Action, and Session Tool API lifecycles, including Session ownership,
106
+ status/result reconciliation, and owned stop behavior.
107
+ - Added activation-time binding previews and task-time frozen bindings containing exact Skill
108
+ version, manifest and workflow hashes, Runtime/Gateway identity, ToolSpec hashes, and Node locks.
109
+ - Added crash recovery that reconciles persisted invocation IDs using reads only, plus
110
+ version-scoped Forge experience and Lessons.
111
+ - Added deterministic Skill bundle packaging and exact single-executable Node archive locks.
112
+ - Added the optional Bundle startup hook
113
+ `bash <bundle>/start.sh <skill-name> <skill-version>` and supplies `PAOS_SKILL_NAME` and
114
+ `PAOS_SKILL_VERSION` to rendered dataflows and Dora process environments.
115
+
116
+ ### Changed
117
+
118
+ - Forge Gateway selection now comes only from one explicitly started, healthy installed Skill
119
+ Runtime; static `forge.enabled`, `forge.baseUrl`, and `forge.apiVersion` selectors are rejected.
120
+ - Runtime state uses schema v2 so Runtime/Gateway identities, Session references, task bindings,
121
+ and force-stop audit records are mandatory and stable across restarts.
122
+ - Action admission persists a PAOS-generated caller ID and intent before the remote request.
123
+ Timeouts and unknown results cannot trigger an automatic POST retry.
124
+ - Runtime stop and switching account for active invocations, Sessions, and task bindings; forced
125
+ stop records an audit event.
126
+ - Resource Registry Skill lookup uses the name endpoint. `paos skill install --version` validates
127
+ the downloaded manifest as a client-side constraint before Node resolution and installation
128
+ commit; schema-v3 static indexes retain version selection.
129
+ - Runtime environment identity now covers the selected dataflow path and profile file digests, so
130
+ configuration edits and dataflow-path changes rematerialize the environment.
131
+ - Expanded the bilingual integration guide with Bundle packaging, local validation, immutable
132
+ Node/Bundle publication order, and Registry acceptance guidance.
133
+
134
+ ### Fixed
135
+
136
+ - Forge Node downloads accept Registry responses that omit duplicate digest and size fields. The
137
+ verified Skill lock remains the digest authority, while the direct-download endpoint supplies
138
+ the content length before the archive is downloaded and checked.
139
+ - Documented the Dora CLI v0.4.1 and `dora-message` v0.7.0 Forge Skill compatibility baseline,
140
+ version-pinned installation methods, PATH and lifecycle checks, and RuntimeManager's automatic
141
+ local Dora service startup.
142
+ - Startup-hook failures, missing Bash, and execution errors now persist a `failed` lifecycle state
143
+ and diagnostic log before Dora can start, rather than leaving stale or unstarted state.
144
+ - Start, stop, install/update commit, and removal now use a non-blocking cross-process lock per
145
+ Skill, preventing overlapping lifecycle mutations while allowing automatic release on process
146
+ exit.
147
+
148
+ ### Removed
149
+
150
+ - Removed the concrete Forge Skill, simulation profile, and remote bundle-fetch helper from the
151
+ PhyAgentOS distribution. Forge Skills and their nodes, models, and assets are installed
152
+ independently when required.
153
+
154
+ ### Security
155
+
156
+ - Skill and Node downloads require exact size and SHA-256 metadata, archive extraction remains
157
+ bounded and link-safe, and mutations require task ownership plus live binding revalidation.
158
+ - Unknown remote effects retain Runtime safety guards until explicit operator resolution.
159
+
160
+ ## [v0.2.2] - 2026-08-21
161
+
162
+ PhyAgentOS now uses one Forge Query/Action Tool API execution plane while retaining Agent verification, experience, evolution, and the existing general-purpose tool platform.
163
+
164
+ ### Added
165
+
166
+ - Added the AgentTask lifecycle tools `forge_task_create`, `forge_task_get`, `forge_task_begin_revision`, `forge_task_finalize`, and `forge_task_cancel` with one global non-terminal task, immutable PlanRevisions, bound Query records, Action invocation references, evidence, and aggregate verification.
167
+ - Added the Forge Tool API tools `forge_tool_context`, `forge_tool_query`, `forge_tool_start_action`, `forge_tool_action_status`, `forge_tool_action_result`, and `forge_tool_cancel_action` for bound and unbound Query/Action calls.
168
+ - Added the manifest-v2 Skill Runtime, catalog, archive validation, transactional installation, persistent runtime state, Resource Registry support, and `paos skill` / `paos forge-node` lifecycle commands.
169
+ - Added the built-in `move-arm-by-ee` v0.2 Skill with a MuJoCo profile, relative-pose Query, motion Action, gripper Action, ToolSpecs, and independently locked Forge nodes.
170
+ - Added backward-compatible AgentTask, PlanRevision, ToolInvocation, and attempt references to task experience and evolution records.
171
+
172
+ ### Changed
173
+
174
+ - Robot execution now follows `AgentTask-bound or unbound call → ForgeToolClient → Gateway /tools → ToolInvocation → ToolEndpoint → Dora/robot`; operation `max_concurrency` remains the execution concurrency authority.
175
+ - Task verification now aggregates all calls bound to one AgentTask. A recovery verdict appends a bounded PlanRevision to the same task and continues through the existing verification and evolution policies.
176
+ - Skill discovery now combines workspace, installed, and built-in Skills. A healthy active Runtime contributes availability and its manifest `gateway_url` takes precedence over `forge.baseUrl`.
177
+ - `ForgeConfig` now represents `forge-tool-api.v1`; Resource Registry configuration is available through `resourceRegistry.url` or `PAOS_RESOURCE_REGISTRY_URL` and never triggers an implicit unconfigured download.
178
+ - Existing Agent tools, dynamic MCP tools, verification contracts, experience storage, evolution storage, and Skill activation remain available with their existing contracts.
179
+
180
+ ### Removed
181
+
182
+ - Removed the PAOS Forge Session execution path and the seven Session-specific Agent tools: `forge_execute_task`, `forge_get_session`, `forge_cancel_session`, `forge_get_context`, `forge_reset`, `verify_forge_session`, and `create_replanned_forge_session`.
183
+ - Removed the built-in `pipergo2-demo`; `move-arm-by-ee` is the maintained robot Skill example.
184
+
185
+ ### Fixed
186
+
187
+ - Cancellation acceptance, local timeout, and `unknown` invocation outcomes no longer imply that physical execution stopped and do not trigger blind retries.
188
+ - Skill and node installation now verifies SHA-256 metadata, blocks path traversal and unsafe links, validates locked node digests, and rolls back incomplete replacements.
189
+
190
+ ### Security
191
+
192
+ - Runtime artifacts require verified size and digest metadata before installation; archive extraction is bounded and atomic, and no Registry download occurs without explicit configuration.
193
+
194
+ ## [v0.2.1] - 2026-08-14
195
+
196
+ PhyAgentOS can turn verified Forge task outcomes into scoped, auditable workflow experience and supply activated Skill Lessons to verification as bounded, non-authoritative advice without changing the Forge execution path.
197
+
198
+ ### Added
199
+
200
+ - Added explicit `activate_skill(name, role)` activation with one primary Skill, optional supporting Skills, applicable scoped Lessons, and task-to-Skill attribution.
201
+ - Added versioned task-outcome, episode, assessment, Skill candidate, failure observation, Lesson cluster, abstraction-validation, and scoped-Lesson contracts.
202
+ - Added a crash-safe SQLite WAL experience ledger, asynchronous reflection jobs, structured evolution events, Skill revision history, and generated per-Skill Lesson projections.
203
+ - Added guarded Skill creation/update after independent semantic-success support, including managed workflow blocks, workspace overrides for built-in Skills, reload validation, atomic writes, and rollback.
204
+ - Added workflow-related failure eligibility, normalized observation clustering, independent root-lineage support, Lesson synthesis, and abstraction validation.
205
+
206
+ ### Changed
207
+
208
+ - Skill summaries now direct the Agent to activate a matching workflow before tool execution when evolution is enabled; direct `SKILL.md` reads are not treated as activation.
209
+ - Learned Lessons are loaded dynamically with the activated Skill. The root `LESSONS.md` remains available as legacy/human-authored material but is no longer injected globally while evolution is enabled.
210
+ - Forge verification uses the active scoped Lessons frozen with the root task's explicit Skill activations. Evolution mode never reads root `LESSONS.md` for automatic verification or review, and tasks without an activated Skill receive no learned Lesson context.
211
+ - Verifier prompts treat Lessons as untrusted, non-authoritative workflow advice that cannot establish criterion status, replace execution evidence, or appear as evidence references.
212
+ - Failures caused by unsatisfiable tasks, verifier/evidence limits, infrastructure, user constraints, or uncertain attribution remain diagnostic-only.
213
+ - Built-in Skills remain immutable; promoted revisions are written as workspace overrides and only the PAOS-managed workflow block is replaced on later updates.
214
+
215
+ ### Security
216
+
217
+ - Experience records redact endpoint-, credential-, path-, executable-ID-, and action-assignment-shaped data and persist only workflow structure, input field names, opaque evidence references, and immutable record references.
218
+ - Lesson and Skill policies reject task-specific answers, fixed coordinates/values, credentials, endpoints, Gateway IDs, Action Manifest copies, prompt injection, and instructions that bypass Forge or verification.
@@ -0,0 +1,49 @@
1
+ FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim
2
+
3
+ LABEL org.opencontainers.image.title="PhyAgentOS" \
4
+ org.opencontainers.image.version="1.1.1" \
5
+ org.opencontainers.image.source="https://github.com/PhyAgentOS/PhyAgentOS-core"
6
+
7
+ # Install Node.js 20 for the WhatsApp bridge
8
+ RUN apt-get update && \
9
+ apt-get install -y --no-install-recommends curl ca-certificates gnupg git && \
10
+ mkdir -p /etc/apt/keyrings && \
11
+ curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg && \
12
+ echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" > /etc/apt/sources.list.d/nodesource.list && \
13
+ apt-get update && \
14
+ apt-get install -y --no-install-recommends nodejs && \
15
+ apt-get purge -y gnupg && \
16
+ apt-get autoremove -y && \
17
+ rm -rf /var/lib/apt/lists/*
18
+
19
+ WORKDIR /app
20
+
21
+ # Install Python dependencies first (cached layer)
22
+ COPY pyproject.toml README.md LICENSE ./
23
+ RUN mkdir -p PhyAgentOS bridge && touch PhyAgentOS/__init__.py && \
24
+ uv pip install --system --no-cache . && \
25
+ rm -rf PhyAgentOS bridge
26
+
27
+ # Copy the full source and install
28
+ COPY PhyAgentOS/ PhyAgentOS/
29
+ COPY bridge/ bridge/
30
+ RUN uv pip install --system --no-cache .
31
+
32
+ # Build the WhatsApp bridge from the committed lock file. A failed dependency
33
+ # install or TypeScript compilation must fail the image build.
34
+ WORKDIR /app/bridge
35
+ RUN npm ci && npm run build
36
+ WORKDIR /app
37
+
38
+ # Release smoke check: verifies the installed console entry point and runtime version.
39
+ RUN paos --version
40
+
41
+ # Create config directory
42
+ RUN mkdir -p /root/.PhyAgentOS
43
+
44
+ # NOTE: The gateway is a message-bus service (agent + channels + cron +
45
+ # heartbeat). It makes outbound connections only and does NOT bind an inbound
46
+ # port, so no EXPOSE is needed. If an inbound HTTP endpoint is added later,
47
+ # re-add EXPOSE <port> here.
48
+ ENTRYPOINT ["paos"]
49
+ CMD ["agent"]
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 PhyAgentOS contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.