talkops-opscloud 0.3.0b1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (309) hide show
  1. opscloud/__init__.py +5 -0
  2. opscloud/__main__.py +6 -0
  3. opscloud/_constants.py +53 -0
  4. opscloud/_debug.py +145 -0
  5. opscloud/_debug_buffer.py +250 -0
  6. opscloud/_textual_patches.py +367 -0
  7. opscloud/_version.py +15 -0
  8. opscloud/agent/__init__.py +27 -0
  9. opscloud/agent/config.py +168 -0
  10. opscloud/agent/factory.py +1103 -0
  11. opscloud/approval_mode.py +44 -0
  12. opscloud/backend/__init__.py +49 -0
  13. opscloud/backend/composite.py +89 -0
  14. opscloud/backend/local.py +183 -0
  15. opscloud/backend/registry.py +79 -0
  16. opscloud/backend/sandbox_config.py +107 -0
  17. opscloud/backend/sandbox_factory.py +432 -0
  18. opscloud/built_in_skills/remember/SKILL.md +124 -0
  19. opscloud/built_in_skills/skill-creator/SKILL.md +348 -0
  20. opscloud/built_in_skills/skill-creator/scripts/init_skill.py +371 -0
  21. opscloud/built_in_skills/skill-creator/scripts/quick_validate.py +165 -0
  22. opscloud/cli/__init__.py +1 -0
  23. opscloud/cli/commands/__init__.py +15 -0
  24. opscloud/cli/commands/auth.py +45 -0
  25. opscloud/cli/commands/doctor.py +100 -0
  26. opscloud/cli/commands/mcp.py +137 -0
  27. opscloud/cli/commands/threads.py +51 -0
  28. opscloud/cli/interactive.py +154 -0
  29. opscloud/cli/main.py +903 -0
  30. opscloud/cli/non_interactive.py +425 -0
  31. opscloud/cli/server_manager.py +58 -0
  32. opscloud/commands/__init__.py +19 -0
  33. opscloud/commands/_base.py +110 -0
  34. opscloud/commands/_guards.py +52 -0
  35. opscloud/commands/_router.py +146 -0
  36. opscloud/commands/_types.py +36 -0
  37. opscloud/commands/core/__init__.py +47 -0
  38. opscloud/commands/core/auth.py +94 -0
  39. opscloud/commands/core/bug.py +46 -0
  40. opscloud/commands/core/clear.py +106 -0
  41. opscloud/commands/core/cloud.py +185 -0
  42. opscloud/commands/core/compact.py +128 -0
  43. opscloud/commands/core/config_cmd.py +120 -0
  44. opscloud/commands/core/context.py +220 -0
  45. opscloud/commands/core/cost.py +44 -0
  46. opscloud/commands/core/doctor.py +535 -0
  47. opscloud/commands/core/effort.py +108 -0
  48. opscloud/commands/core/exit_cmd.py +41 -0
  49. opscloud/commands/core/fast.py +148 -0
  50. opscloud/commands/core/help_cmd.py +94 -0
  51. opscloud/commands/core/mcp.py +134 -0
  52. opscloud/commands/core/model.py +109 -0
  53. opscloud/commands/core/permissions.py +196 -0
  54. opscloud/commands/core/plugins.py +92 -0
  55. opscloud/commands/core/pool.py +108 -0
  56. opscloud/commands/core/resume.py +97 -0
  57. opscloud/commands/core/skills.py +178 -0
  58. opscloud/commands/power/__init__.py +51 -0
  59. opscloud/commands/power/agents.py +98 -0
  60. opscloud/commands/power/btw.py +85 -0
  61. opscloud/commands/power/copy.py +97 -0
  62. opscloud/commands/power/goal.py +548 -0
  63. opscloud/commands/power/loop.py +295 -0
  64. opscloud/commands/power/memory.py +287 -0
  65. opscloud/commands/power/review.py +152 -0
  66. opscloud/commands/power/rubric.py +287 -0
  67. opscloud/commands/power/runtime.py +321 -0
  68. opscloud/commands/power/skill_creator.py +70 -0
  69. opscloud/commands/power/skill_invoke.py +165 -0
  70. opscloud/commands/power/tasks.py +209 -0
  71. opscloud/commands/power/trace.py +117 -0
  72. opscloud/commands/power/ui_toggles.py +135 -0
  73. opscloud/commands/power/version.py +52 -0
  74. opscloud/commands/registry.py +176 -0
  75. opscloud/config/__init__.py +114 -0
  76. opscloud/config/adapters/__init__.py +5 -0
  77. opscloud/config/adapters/postgres.py +776 -0
  78. opscloud/config/adapters/sqlite.py +769 -0
  79. opscloud/config/aws.py +248 -0
  80. opscloud/config/cloud_profiles.py +437 -0
  81. opscloud/config/env_vars.py +81 -0
  82. opscloud/config/langsmith.py +319 -0
  83. opscloud/config/manifest.py +817 -0
  84. opscloud/config/metadata.py +205 -0
  85. opscloud/config/paths.py +604 -0
  86. opscloud/config/plugins.py +130 -0
  87. opscloud/config/settings.py +834 -0
  88. opscloud/config/store.py +453 -0
  89. opscloud/config/store_factory.py +97 -0
  90. opscloud/config/toml_config.py +562 -0
  91. opscloud/editor.py +173 -0
  92. opscloud/exceptions.py +65 -0
  93. opscloud/file_ops.py +217 -0
  94. opscloud/hooks/__init__.py +139 -0
  95. opscloud/hooks/env.py +44 -0
  96. opscloud/hooks/interrupt.py +121 -0
  97. opscloud/hooks/models/__init__.py +109 -0
  98. opscloud/hooks/models/adapters.py +19 -0
  99. opscloud/hooks/models/config.py +79 -0
  100. opscloud/hooks/models/domain.py +434 -0
  101. opscloud/hooks/models/transport.py +37 -0
  102. opscloud/hooks/tools.py +231 -0
  103. opscloud/input.py +48 -0
  104. opscloud/integrations/__init__.py +80 -0
  105. opscloud/integrations/base.py +153 -0
  106. opscloud/integrations/content_filter.py +119 -0
  107. opscloud/integrations/event_bus.py +480 -0
  108. opscloud/integrations/hooks.py +238 -0
  109. opscloud/integrations/identity.py +181 -0
  110. opscloud/integrations/notifications.py +134 -0
  111. opscloud/integrations/stream_bridge.py +397 -0
  112. opscloud/integrations/thread_store.py +81 -0
  113. opscloud/json_types.py +20 -0
  114. opscloud/mcp/__init__.py +57 -0
  115. opscloud/mcp/config.py +203 -0
  116. opscloud/mcp/discovery.py +229 -0
  117. opscloud/mcp/mcp_info.py +109 -0
  118. opscloud/mcp/middleware.py +102 -0
  119. opscloud/mcp/preload.py +505 -0
  120. opscloud/mcp/raw_config.py +149 -0
  121. opscloud/mcp/semantic_profiler.py +305 -0
  122. opscloud/mcp/session_manager.py +727 -0
  123. opscloud/mcp/trust.py +105 -0
  124. opscloud/memory/__init__.py +27 -0
  125. opscloud/memory/branch.py +61 -0
  126. opscloud/memory/guard.py +19 -0
  127. opscloud/memory/onboarding.py +120 -0
  128. opscloud/memory/registry.py +134 -0
  129. opscloud/memory/store.py +223 -0
  130. opscloud/middleware/__init__.py +106 -0
  131. opscloud/middleware/_repository_bounds.py +459 -0
  132. opscloud/middleware/ask_user.py +152 -0
  133. opscloud/middleware/auto_mode.py +60 -0
  134. opscloud/middleware/auto_mode_hitl.py +2434 -0
  135. opscloud/middleware/compaction.py +566 -0
  136. opscloud/middleware/configurable_model.py +233 -0
  137. opscloud/middleware/cost_tracking.py +1021 -0
  138. opscloud/middleware/glm_stall_recovery.py +109 -0
  139. opscloud/middleware/goal_criteria.py +1234 -0
  140. opscloud/middleware/goal_state_notice.py +712 -0
  141. opscloud/middleware/goal_tools.py +407 -0
  142. opscloud/middleware/headless_mcp_guard.py +88 -0
  143. opscloud/middleware/jev_model_router.py +1018 -0
  144. opscloud/middleware/local_context.py +460 -0
  145. opscloud/middleware/mcp_context.py +151 -0
  146. opscloud/middleware/mcp_middleware.py +146 -0
  147. opscloud/middleware/memory_guard.py +393 -0
  148. opscloud/middleware/model_retry.py +205 -0
  149. opscloud/middleware/registry.py +137 -0
  150. opscloud/middleware/reliable_rubric.py +709 -0
  151. opscloud/middleware/resume_state.py +91 -0
  152. opscloud/middleware/server_hooks.py +1189 -0
  153. opscloud/middleware/shell_allow_list.py +90 -0
  154. opscloud/middleware/skills.py +382 -0
  155. opscloud/middleware/subagent_artifacts.py +84 -0
  156. opscloud/middleware/subagent_telemetry.py +261 -0
  157. opscloud/middleware/subagents.py +243 -0
  158. opscloud/middleware/tool_filter.py +384 -0
  159. opscloud/middleware/unified_system_message.py +62 -0
  160. opscloud/model/__init__.py +37 -0
  161. opscloud/model/config.py +2992 -0
  162. opscloud/model/factory.py +477 -0
  163. opscloud/model/pool.py +459 -0
  164. opscloud/model/reasoning.py +282 -0
  165. opscloud/offload.py +173 -0
  166. opscloud/output.py +64 -0
  167. opscloud/plugins/__init__.py +189 -0
  168. opscloud/plugins/_json.py +22 -0
  169. opscloud/plugins/adapters/__init__.py +13 -0
  170. opscloud/plugins/adapters/agents.py +112 -0
  171. opscloud/plugins/adapters/commands.py +190 -0
  172. opscloud/plugins/adapters/mcp.py +363 -0
  173. opscloud/plugins/adapters/skills.py +132 -0
  174. opscloud/plugins/commands_cli.py +541 -0
  175. opscloud/plugins/discovery.py +512 -0
  176. opscloud/plugins/manifest.py +335 -0
  177. opscloud/plugins/marketplace.py +893 -0
  178. opscloud/plugins/models.py +334 -0
  179. opscloud/plugins/project_plugins.py +317 -0
  180. opscloud/plugins/protocol.py +31 -0
  181. opscloud/plugins/store.py +905 -0
  182. opscloud/plugins/substitution.py +122 -0
  183. opscloud/project_utils.py +145 -0
  184. opscloud/prompts/__init__.py +37 -0
  185. opscloud/prompts/system.py +483 -0
  186. opscloud/prompts/templates/system_prompt.md +166 -0
  187. opscloud/prompts/types.py +54 -0
  188. opscloud/rubrics/__init__.py +42 -0
  189. opscloud/rubrics/evaluator.py +404 -0
  190. opscloud/rubrics/evidence_extractor.py +229 -0
  191. opscloud/rubrics/generator.py +239 -0
  192. opscloud/rubrics/jev_compiler.py +175 -0
  193. opscloud/rubrics/jev_grader.py +297 -0
  194. opscloud/rubrics/middleware.py +8 -0
  195. opscloud/schema/__init__.py +107 -0
  196. opscloud/schema/interrupts.py +981 -0
  197. opscloud/security/__init__.py +91 -0
  198. opscloud/security/approval_mode.py +528 -0
  199. opscloud/security/approval_mode_source.py +230 -0
  200. opscloud/security/cli_ast_evaluator.py +552 -0
  201. opscloud/security/jev_classifier.py +651 -0
  202. opscloud/security/shell_safety.py +340 -0
  203. opscloud/security/unicode_security.py +439 -0
  204. opscloud/security/url_validation.py +160 -0
  205. opscloud/server/__init__.py +13 -0
  206. opscloud/server/_server_config.py +158 -0
  207. opscloud/server/server.py +242 -0
  208. opscloud/server/server_graph.py +93 -0
  209. opscloud/skills/__init__.py +91 -0
  210. opscloud/skills/commands.py +1099 -0
  211. opscloud/skills/invocation.py +200 -0
  212. opscloud/skills/load.py +388 -0
  213. opscloud/skills/loader.py +23 -0
  214. opscloud/skills/merge.py +65 -0
  215. opscloud/skills/registry.py +263 -0
  216. opscloud/skills/sources.py +174 -0
  217. opscloud/skills/trust.py +417 -0
  218. opscloud/state/__init__.py +142 -0
  219. opscloud/state/base.py +154 -0
  220. opscloud/state/cloud_context.py +262 -0
  221. opscloud/state/goal_channels.py +124 -0
  222. opscloud/state/goal_state_limits.py +175 -0
  223. opscloud/state/resume_state.py +58 -0
  224. opscloud/state/service_context.py +281 -0
  225. opscloud/state/session.py +957 -0
  226. opscloud/state/state_migration.py +86 -0
  227. opscloud/subagents/__init__.py +30 -0
  228. opscloud/subagents/loader.py +331 -0
  229. opscloud/subagents/subagents_parser.py +117 -0
  230. opscloud/subagents/types.py +25 -0
  231. opscloud/tools/__init__.py +36 -0
  232. opscloud/tools/catalog.py +37 -0
  233. opscloud/tools/display.py +24 -0
  234. opscloud/tools/fetch_url.py +176 -0
  235. opscloud/tools/goal_tools.py +423 -0
  236. opscloud/tools/registry.py +105 -0
  237. opscloud/tools/thread.py +32 -0
  238. opscloud/tools/web_search.py +215 -0
  239. opscloud/ui/__init__.py +119 -0
  240. opscloud/ui/app.py +5400 -0
  241. opscloud/ui/app.tcss +479 -0
  242. opscloud/ui/clipboard.py +147 -0
  243. opscloud/ui/command_registry.py +482 -0
  244. opscloud/ui/message_store.py +152 -0
  245. opscloud/ui/permission_store.py +360 -0
  246. opscloud/ui/preferences.py +113 -0
  247. opscloud/ui/prompt_manager.py +96 -0
  248. opscloud/ui/remote_client.py +505 -0
  249. opscloud/ui/textual_adapter.py +1269 -0
  250. opscloud/ui/theme.py +728 -0
  251. opscloud/ui/ui_help.py +415 -0
  252. opscloud/ui/widgets/__init__.py +383 -0
  253. opscloud/ui/widgets/_ask_user_types.py +81 -0
  254. opscloud/ui/widgets/_copy_spans.py +52 -0
  255. opscloud/ui/widgets/_inline_prompt.py +290 -0
  256. opscloud/ui/widgets/_js_eval_display.py +139 -0
  257. opscloud/ui/widgets/_links.py +175 -0
  258. opscloud/ui/widgets/_tool_stream.py +308 -0
  259. opscloud/ui/widgets/agent_selector.py +297 -0
  260. opscloud/ui/widgets/approval.py +741 -0
  261. opscloud/ui/widgets/ask_user.py +539 -0
  262. opscloud/ui/widgets/auth.py +695 -0
  263. opscloud/ui/widgets/auth_manager.py +214 -0
  264. opscloud/ui/widgets/auto_mode_notice.py +146 -0
  265. opscloud/ui/widgets/autocomplete.py +709 -0
  266. opscloud/ui/widgets/chat_input.py +805 -0
  267. opscloud/ui/widgets/cloud_selector.py +528 -0
  268. opscloud/ui/widgets/config_manager.py +652 -0
  269. opscloud/ui/widgets/debug_console.py +1269 -0
  270. opscloud/ui/widgets/devops_renderers.py +184 -0
  271. opscloud/ui/widgets/diff.py +237 -0
  272. opscloud/ui/widgets/effort_selector.py +166 -0
  273. opscloud/ui/widgets/goal_review.py +612 -0
  274. opscloud/ui/widgets/goal_status.py +57 -0
  275. opscloud/ui/widgets/infra_panel.py +141 -0
  276. opscloud/ui/widgets/install_confirm.py +114 -0
  277. opscloud/ui/widgets/loading.py +170 -0
  278. opscloud/ui/widgets/mcp_viewer.py +1204 -0
  279. opscloud/ui/widgets/messages.py +4461 -0
  280. opscloud/ui/widgets/model_selector.py +863 -0
  281. opscloud/ui/widgets/notification_center.py +108 -0
  282. opscloud/ui/widgets/notification_settings.py +119 -0
  283. opscloud/ui/widgets/operation_card.py +106 -0
  284. opscloud/ui/widgets/permissions_manager.py +667 -0
  285. opscloud/ui/widgets/plugin_manager.py +1212 -0
  286. opscloud/ui/widgets/pool_selector.py +376 -0
  287. opscloud/ui/widgets/preamble.py +53 -0
  288. opscloud/ui/widgets/skills_viewer.py +432 -0
  289. opscloud/ui/widgets/status.py +1037 -0
  290. opscloud/ui/widgets/subagent_panel.py +927 -0
  291. opscloud/ui/widgets/theme_selector.py +232 -0
  292. opscloud/ui/widgets/thread_selector.py +358 -0
  293. opscloud/ui/widgets/toast.py +31 -0
  294. opscloud/ui/widgets/tool_display.py +325 -0
  295. opscloud/ui/widgets/tool_renderers.py +234 -0
  296. opscloud/ui/widgets/tool_widgets.py +278 -0
  297. opscloud/ui/widgets/welcome.py +421 -0
  298. opscloud/ui/widgets/welcome_popup.py +102 -0
  299. opscloud/utils/__init__.py +24 -0
  300. opscloud/utils/cost_estimation.py +169 -0
  301. opscloud/utils/git.py +390 -0
  302. opscloud/utils/logger.py +571 -0
  303. opscloud/utils/session_stats.py +115 -0
  304. opscloud/utils/startup_error.py +37 -0
  305. talkops_opscloud-0.3.0b1.dist-info/METADATA +449 -0
  306. talkops_opscloud-0.3.0b1.dist-info/RECORD +309 -0
  307. talkops_opscloud-0.3.0b1.dist-info/WHEEL +4 -0
  308. talkops_opscloud-0.3.0b1.dist-info/entry_points.txt +2 -0
  309. talkops_opscloud-0.3.0b1.dist-info/licenses/LICENSE +175 -0
@@ -0,0 +1,158 @@
1
+ """Typed configuration for app-to-server subprocess communication."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import os
6
+ from dataclasses import dataclass
7
+ from pathlib import Path
8
+ from typing import Any
9
+
10
+ from opscloud._constants import DEFAULT_ASSISTANT_ID, SERVER_ENV_PREFIX
11
+
12
+
13
+ def _read_env_bool(suffix: str, *, default: bool = False) -> bool:
14
+ raw = os.environ.get(f"{SERVER_ENV_PREFIX}{suffix}")
15
+ if raw is None:
16
+ return default
17
+ return raw.lower() == "true"
18
+
19
+
20
+ def _read_env_str(suffix: str) -> str | None:
21
+ return os.environ.get(f"{SERVER_ENV_PREFIX}{suffix}")
22
+
23
+
24
+ @dataclass(frozen=True)
25
+ class ServerConfig:
26
+ """Configuration payload passed to the LangGraph server subprocess."""
27
+
28
+ model: str | None = None
29
+ assistant_id: str = DEFAULT_ASSISTANT_ID
30
+ system_prompt: str | None = None
31
+ auto_approve: bool = False
32
+ interactive: bool = True
33
+ enable_shell: bool = True
34
+ cwd: str | None = None
35
+ project_root: str | None = None
36
+ approval_mode: str = "manual"
37
+ shell_allow_list: tuple[str, ...] | None = None
38
+ read_only: bool = False
39
+ aws_profile: str | None = None
40
+ aws_region: str | None = None
41
+ mcp_config_path: str | None = None
42
+ no_mcp: bool = False
43
+ trust_project_mcp: bool = False
44
+ server_log_level: str = "WARNING"
45
+
46
+ def to_env(self) -> dict[str, str]:
47
+ env: dict[str, str] = {
48
+ f"{SERVER_ENV_PREFIX}ASSISTANT_ID": self.assistant_id,
49
+ f"{SERVER_ENV_PREFIX}AUTO_APPROVE": str(self.auto_approve).lower(),
50
+ f"{SERVER_ENV_PREFIX}INTERACTIVE": str(self.interactive).lower(),
51
+ f"{SERVER_ENV_PREFIX}ENABLE_SHELL": str(self.enable_shell).lower(),
52
+ f"{SERVER_ENV_PREFIX}APPROVAL_MODE": self.approval_mode,
53
+ f"{SERVER_ENV_PREFIX}READ_ONLY": str(self.read_only).lower(),
54
+ f"{SERVER_ENV_PREFIX}NO_MCP": str(self.no_mcp).lower(),
55
+ f"{SERVER_ENV_PREFIX}TRUST_PROJECT_MCP": str(self.trust_project_mcp).lower(),
56
+ f"{SERVER_ENV_PREFIX}LOG_LEVEL": self.server_log_level,
57
+ }
58
+ if self.model:
59
+ env[f"{SERVER_ENV_PREFIX}MODEL"] = self.model
60
+ if self.system_prompt:
61
+ env[f"{SERVER_ENV_PREFIX}SYSTEM_PROMPT"] = self.system_prompt
62
+ effective_cwd = self.cwd or str(Path.cwd().resolve())
63
+ env[f"{SERVER_ENV_PREFIX}CWD"] = effective_cwd
64
+ from opscloud.config.paths import find_project_root
65
+
66
+ resolved_root = self.project_root or find_project_root(effective_cwd)
67
+ if resolved_root:
68
+ env[f"{SERVER_ENV_PREFIX}PROJECT_ROOT"] = str(resolved_root)
69
+ if self.shell_allow_list:
70
+ env[f"{SERVER_ENV_PREFIX}SHELL_ALLOW_LIST"] = ",".join(self.shell_allow_list)
71
+ if self.aws_profile:
72
+ env[f"{SERVER_ENV_PREFIX}AWS_PROFILE"] = self.aws_profile
73
+ if self.aws_region:
74
+ env[f"{SERVER_ENV_PREFIX}AWS_REGION"] = self.aws_region
75
+ if self.mcp_config_path:
76
+ env[f"{SERVER_ENV_PREFIX}MCP_CONFIG_PATH"] = self.mcp_config_path
77
+ return env
78
+
79
+ @classmethod
80
+ def from_env(cls) -> ServerConfig:
81
+ raw_sal = _read_env_str("SHELL_ALLOW_LIST")
82
+ shell_allow_list = tuple(s.strip() for s in raw_sal.split(",") if s.strip()) if raw_sal else None
83
+ server_log_level = _read_env_str("LOG_LEVEL") or "WARNING"
84
+ return cls(
85
+ model=_read_env_str("MODEL"),
86
+ assistant_id=_read_env_str("ASSISTANT_ID") or DEFAULT_ASSISTANT_ID,
87
+ system_prompt=_read_env_str("SYSTEM_PROMPT"),
88
+ auto_approve=_read_env_bool("AUTO_APPROVE", default=False),
89
+ interactive=_read_env_bool("INTERACTIVE", default=True),
90
+ enable_shell=_read_env_bool("ENABLE_SHELL", default=True),
91
+ cwd=_read_env_str("CWD"),
92
+ project_root=_read_env_str("PROJECT_ROOT"),
93
+ approval_mode=_read_env_str("APPROVAL_MODE") or "manual",
94
+ shell_allow_list=shell_allow_list,
95
+ read_only=_read_env_bool("READ_ONLY", default=False),
96
+ aws_profile=_read_env_str("AWS_PROFILE"),
97
+ aws_region=_read_env_str("AWS_REGION"),
98
+ mcp_config_path=_read_env_str("MCP_CONFIG_PATH"),
99
+ no_mcp=_read_env_bool("NO_MCP", default=False),
100
+ trust_project_mcp=_read_env_bool("TRUST_PROJECT_MCP", default=False),
101
+ server_log_level=server_log_level,
102
+ )
103
+
104
+ @classmethod
105
+ def from_cli_args(
106
+ cls,
107
+ *,
108
+ project_context: Any = None,
109
+ model_name: str | None = None,
110
+ model: str | None = None,
111
+ assistant_id: str = DEFAULT_ASSISTANT_ID,
112
+ system_prompt: str | None = None,
113
+ auto_approve: bool = False,
114
+ interactive: bool = True,
115
+ enable_shell: bool = True,
116
+ cwd: str | None = None,
117
+ project_root: str | None = None,
118
+ approval_mode: str = "manual",
119
+ shell_allow_list: tuple[str, ...] | list[str] | None = None,
120
+ read_only: bool = False,
121
+ aws_profile: str | None = None,
122
+ aws_region: str | None = None,
123
+ mcp_config_path: str | None = None,
124
+ no_mcp: bool = False,
125
+ trust_project_mcp: bool = False,
126
+ server_log_level: str = "WARNING",
127
+ ) -> ServerConfig:
128
+ resolved_cwd = (
129
+ str(project_context.user_cwd)
130
+ if project_context is not None
131
+ else (cwd or str(Path.cwd().resolve()))
132
+ )
133
+ resolved_project_root = (
134
+ str(project_context.project_root)
135
+ if project_context is not None and project_context.project_root is not None
136
+ else project_root
137
+ )
138
+ sal = tuple(shell_allow_list) if shell_allow_list else None
139
+ return cls(
140
+ model=model or model_name,
141
+ assistant_id=assistant_id,
142
+ system_prompt=system_prompt,
143
+ auto_approve=auto_approve,
144
+ interactive=interactive,
145
+ enable_shell=enable_shell,
146
+ cwd=resolved_cwd,
147
+ project_root=resolved_project_root,
148
+ approval_mode=approval_mode,
149
+ shell_allow_list=sal,
150
+ read_only=read_only,
151
+ aws_profile=aws_profile,
152
+ aws_region=aws_region,
153
+ mcp_config_path=mcp_config_path,
154
+ no_mcp=no_mcp,
155
+ trust_project_mcp=trust_project_mcp,
156
+ server_log_level=server_log_level,
157
+ )
158
+
@@ -0,0 +1,242 @@
1
+ """LangGraph server process lifecycle manager."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import json
7
+ import os
8
+ import signal
9
+ import socket
10
+ import subprocess
11
+ import sys
12
+ import time
13
+ import atexit
14
+ from pathlib import Path
15
+ from typing import Any
16
+
17
+ import httpx
18
+
19
+ from opscloud._constants import DEFAULT_PORT, SERVER_RUNTIME_DIR
20
+ from opscloud.server._server_config import ServerConfig
21
+ from opscloud.utils.logger import get_active_log_file, get_logger
22
+
23
+ logger = get_logger(__name__)
24
+
25
+ _DEFAULT_HOST = "127.0.0.1"
26
+ _LOG_TAIL_CHARS = 3000
27
+
28
+
29
+ def find_free_port(host: str = _DEFAULT_HOST) -> int:
30
+ with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
31
+ s.bind((host, 0))
32
+ return s.getsockname()[1]
33
+
34
+
35
+ def generate_langgraph_json(
36
+ output_dir: Path,
37
+ graph_ref: str = "./server_graph.py:make_graph",
38
+ checkpointer_path: str = "./checkpointer.py:create_checkpointer",
39
+ ) -> Path:
40
+ output_dir.mkdir(parents=True, exist_ok=True)
41
+ config = {
42
+ "dependencies": ["."],
43
+ "graphs": {
44
+ "opscloud": graph_ref,
45
+ "agent": graph_ref,
46
+ },
47
+ "checkpointer": {
48
+ "path": checkpointer_path,
49
+ },
50
+ "env": ".env",
51
+ }
52
+ target = output_dir / "langgraph.json"
53
+ target.write_text(json.dumps(config, indent=2), encoding="utf-8")
54
+
55
+ # Link or create server_graph.py in output_dir
56
+ server_graph_file = output_dir / "server_graph.py"
57
+ server_graph_code = "from opscloud.server.server_graph import make_graph\n"
58
+ server_graph_file.write_text(server_graph_code, encoding="utf-8")
59
+
60
+ # Link or create checkpointer.py in output_dir (connects to sessions.db)
61
+ checkpointer_file = output_dir / "checkpointer.py"
62
+ checkpointer_code = (
63
+ "from opscloud.state.session import get_checkpointer\n"
64
+ "create_checkpointer = get_checkpointer\n"
65
+ )
66
+ checkpointer_file.write_text(checkpointer_code, encoding="utf-8")
67
+ return target
68
+
69
+
70
+ class ServerProcess:
71
+ """Manages the background langgraph dev subprocess."""
72
+
73
+ def __init__(
74
+ self,
75
+ config: ServerConfig,
76
+ *,
77
+ host: str = _DEFAULT_HOST,
78
+ port: int = DEFAULT_PORT,
79
+ ) -> None:
80
+ self.config = config
81
+ self.host = host
82
+ self.port = port or find_free_port(host)
83
+ self.process: subprocess.Popen[str] | None = None
84
+ self.url = f"http://{self.host}:{self.port}"
85
+ self.runtime_dir = SERVER_RUNTIME_DIR
86
+ self.log_file = get_active_log_file()
87
+ self._log_fp: Any = None
88
+
89
+ def _read_log_tail(self) -> str:
90
+ """Read the tail of the server log file for diagnostics."""
91
+ if not self.log_file.exists():
92
+ return ""
93
+ try:
94
+ content = self.log_file.read_text(encoding="utf-8", errors="replace")
95
+ return content[-_LOG_TAIL_CHARS:]
96
+ except Exception:
97
+ return ""
98
+
99
+ def start(self) -> str:
100
+ """Start the langgraph server process synchronously and wait for it to become healthy."""
101
+ generate_langgraph_json(self.runtime_dir)
102
+
103
+ env = os.environ.copy()
104
+ env.update(self.config.to_env())
105
+ # Ensure python path includes current package and src
106
+ src_path = str(Path.cwd() / "src")
107
+ env["PYTHONPATH"] = f"{src_path}:{env.get('PYTHONPATH', '')}" if "PYTHONPATH" in env else src_path
108
+
109
+ server_log_level = getattr(self.config, "server_log_level", "WARNING") or "WARNING"
110
+ # Silence noisy startup/profiler heartbeats in LangGraph API by defaulting LOG_LEVEL to WARNING
111
+ env.setdefault("LOG_LEVEL", server_log_level)
112
+
113
+ cmd = [
114
+ sys.executable,
115
+ "-m",
116
+ "langgraph_cli",
117
+ "dev",
118
+ "--host",
119
+ self.host,
120
+ "--port",
121
+ str(self.port),
122
+ "--no-browser",
123
+ "--no-reload",
124
+ "--config",
125
+ str(self.runtime_dir / "langgraph.json"),
126
+ "--server-log-level",
127
+ server_log_level,
128
+ ]
129
+
130
+ self.runtime_dir.mkdir(parents=True, exist_ok=True)
131
+ self.log_file.parent.mkdir(parents=True, exist_ok=True)
132
+ self._log_fp = open(self.log_file, "a", encoding="utf-8")
133
+ logger.info("Spawning server: %s (url=%s, server_log=%s)", " ".join(cmd), self.url, self.log_file)
134
+
135
+ popen_kwargs: dict[str, Any] = {
136
+ "cwd": str(self.runtime_dir),
137
+ "env": env,
138
+ "stdout": self._log_fp,
139
+ "stderr": subprocess.STDOUT,
140
+ "text": True,
141
+ }
142
+ # Start in dedicated process group so descendants can be cleanly reaped
143
+ if os.name != "nt":
144
+ popen_kwargs["start_new_session"] = True
145
+ else:
146
+ popen_kwargs["creationflags"] = 0x00000200 # CREATE_NEW_PROCESS_GROUP
147
+
148
+ self.process = subprocess.Popen(cmd, **popen_kwargs)
149
+ atexit.register(self.stop)
150
+
151
+ try:
152
+ self.wait_until_healthy(timeout=30.0)
153
+ self.wait_for_graph_ready(timeout=30.0)
154
+ except Exception:
155
+ self.stop()
156
+ raise
157
+
158
+ return self.url
159
+
160
+ def wait_until_healthy(self, timeout: float = 30.0) -> None:
161
+ start_time = time.monotonic()
162
+ while time.monotonic() - start_time < timeout:
163
+ if self.process and self.process.poll() is not None:
164
+ err = self._read_log_tail()
165
+ raise RuntimeError(f"Server exited prematurely with code {self.process.returncode}:\n{err}")
166
+ try:
167
+ resp = httpx.get(f"{self.url}/ok", timeout=1.0)
168
+ if resp.status_code == 200:
169
+ logger.info("Server is healthy at %s", self.url)
170
+ return
171
+ except Exception:
172
+ time.sleep(0.2)
173
+ err = self._read_log_tail()
174
+ raise TimeoutError(f"Server at {self.url} failed to become healthy within {timeout}s:\n{err}")
175
+
176
+ def wait_for_graph_ready(self, graph_name: str = "agent", timeout: float = 30.0) -> None:
177
+ """Resolve the served graph once so lazy startup failures surface immediately."""
178
+ deadline = time.monotonic() + timeout
179
+ graph_url = f"{self.url}/assistants/{graph_name}/graph"
180
+
181
+ while time.monotonic() < deadline:
182
+ if self.process and self.process.poll() is not None:
183
+ err = self._read_log_tail()
184
+ raise RuntimeError(f"Server exited prematurely with code {self.process.returncode}:\n{err}")
185
+ try:
186
+ resp = httpx.get(graph_url, timeout=2.0)
187
+ if resp.status_code == 200:
188
+ logger.info("Server graph %r is ready at %s", graph_name, self.url)
189
+ return
190
+ elif resp.status_code == 404 and graph_name == "agent":
191
+ graph_name = "opscloud"
192
+ graph_url = f"{self.url}/assistants/{graph_name}/graph"
193
+ except Exception:
194
+ time.sleep(0.2)
195
+
196
+ def _stop_process(self) -> None:
197
+ """Stop only the server subprocess and its log file handle."""
198
+ if self.process and self.process.poll() is None:
199
+ logger.info("Stopping server process PID %d", self.process.pid)
200
+ pgid = None
201
+ if os.name != "nt":
202
+ try:
203
+ pgid = os.getpgid(self.process.pid)
204
+ except Exception:
205
+ pass
206
+
207
+ try:
208
+ if pgid is not None:
209
+ os.killpg(pgid, signal.SIGTERM)
210
+ else:
211
+ self.process.terminate()
212
+ self.process.wait(timeout=3.0)
213
+ except Exception:
214
+ if pgid is not None and os.name != "nt":
215
+ try:
216
+ os.killpg(pgid, signal.SIGKILL)
217
+ except Exception:
218
+ pass
219
+ else:
220
+ try:
221
+ self.process.kill()
222
+ except Exception:
223
+ pass
224
+ self.process = None
225
+
226
+ if self._log_fp and not getattr(self._log_fp, "closed", True):
227
+ try:
228
+ self._log_fp.close()
229
+ except Exception:
230
+ pass
231
+ self._log_fp = None
232
+
233
+ def stop(self) -> None:
234
+ """Gracefully terminate server and child process group, escalating to kill if needed."""
235
+ self._stop_process()
236
+ atexit.unregister(self.stop)
237
+
238
+ async def restart(self, timeout: float = 30.0) -> None:
239
+ """Restart the server process with the existing configuration."""
240
+ logger.info("Restarting langgraph dev server (url=%s)", self.url)
241
+ await asyncio.to_thread(self._stop_process)
242
+ await asyncio.to_thread(self.start)
@@ -0,0 +1,93 @@
1
+ """Server-side graph entry point for `langgraph dev`."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import asyncio
6
+ import os
7
+ import sys
8
+ from typing import Any
9
+
10
+ from opscloud.server._server_config import ServerConfig
11
+ from opscloud.utils.logger import get_logger
12
+
13
+ logger = get_logger(__name__)
14
+
15
+
16
+ def _make_graph_sync() -> Any:
17
+ """Synchronously create and compile the OpsCloud agent graph."""
18
+ from opscloud.agent.factory import create_opscloud_agent
19
+ from opscloud.model.factory import create_model
20
+ from opscloud.project_utils import get_server_project_context
21
+
22
+ config = ServerConfig.from_env()
23
+
24
+ if config.cwd:
25
+ os.environ["OPSCLOUD_SERVER_CWD"] = config.cwd
26
+ if config.project_root:
27
+ os.environ["OPSCLOUD_SERVER_PROJECT_ROOT"] = config.project_root
28
+
29
+ project_context = get_server_project_context()
30
+
31
+ if config.aws_profile:
32
+ os.environ["AWS_PROFILE"] = config.aws_profile
33
+ if config.aws_region:
34
+ os.environ["AWS_REGION"] = config.aws_region
35
+ if config.aws_profile or config.aws_region:
36
+ from opscloud.config.settings import sync_aws_env_aliases
37
+
38
+ sync_aws_env_aliases()
39
+
40
+ if config.read_only:
41
+ os.environ["OPSCLOUD_READ_ONLY"] = "true"
42
+ if config.shell_allow_list:
43
+ os.environ["OPSCLOUD_SHELL_ALLOW_LIST"] = ",".join(config.shell_allow_list)
44
+
45
+ model_spec = config.model or "anthropic:claude-3-5-sonnet-latest"
46
+ model_res = create_model(model_spec)
47
+
48
+ effective_cwd = project_context.user_cwd if project_context else config.cwd
49
+
50
+ agent, _composite_backend = create_opscloud_agent(
51
+ model=model_res.model,
52
+ assistant_id=config.assistant_id,
53
+ system_prompt=config.system_prompt,
54
+ interactive=config.interactive,
55
+ auto_approve=config.auto_approve,
56
+ enable_shell=config.enable_shell,
57
+ cwd=effective_cwd,
58
+ project_context=project_context,
59
+ )
60
+ return agent
61
+
62
+
63
+ _precompiled_graph: Any = None
64
+ _graph_lock = asyncio.Lock()
65
+
66
+ # When running in server mode (ServerProcess sets OPSCLOUD_SERVER_ASSISTANT_ID),
67
+ # eagerly compile the graph during module import / container startup.
68
+ # Official LangChain guidance: "Move expensive initialization (API clients, DB connections,
69
+ # model loading) from graph factory if you are seeing API slowness. Export an already-compiled
70
+ # CompiledGraph instance... or keep factory functions lightweight since they run on every invocation."
71
+ if "OPSCLOUD_SERVER_ASSISTANT_ID" in os.environ:
72
+ try:
73
+ _precompiled_graph = _make_graph_sync()
74
+ except Exception as exc:
75
+ logger.critical("Failed to precompile server graph during startup: %s", exc, exc_info=True)
76
+ print(f"Failed to precompile server graph during startup: {exc}", file=sys.stderr)
77
+ raise
78
+
79
+
80
+ async def make_graph() -> Any:
81
+ """Return the agent graph for `langgraph dev`.
82
+
83
+ Returns the pre-compiled graph in <1ms without incurring per-request compilation latency.
84
+ """
85
+ global _precompiled_graph
86
+ if _precompiled_graph is not None:
87
+ return _precompiled_graph
88
+
89
+ # Fallback for environments where OPSCLOUD_SERVER_ASSISTANT_ID wasn't pre-set
90
+ async with _graph_lock:
91
+ if _precompiled_graph is None:
92
+ _precompiled_graph = await asyncio.to_thread(_make_graph_sync)
93
+ return _precompiled_graph
@@ -0,0 +1,91 @@
1
+ """Skills module for OpsCloud.
2
+
3
+ Public CLI API:
4
+ - execute_skills_command: Execute skills subcommands (list/create/info/delete/trust)
5
+ - setup_skills_parser: Setup argparse configuration for skills commands
6
+
7
+ Public runtime & loader API:
8
+ - list_skills: Discover available skills across built-in, plugin, user, project, and Claude sources
9
+ - load_skill_content: Read SKILL.md content with containment validation
10
+ - build_skill_invocation_envelope: Wrap skill instructions with structured invocation metadata
11
+ - discover_skills_and_roots: Discover skills and pre-resolved containment roots
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ from opscloud.skills.commands import (
17
+ execute_skills_command,
18
+ list_skills_command,
19
+ setup_skills_parser,
20
+ trust_skill_command,
21
+ )
22
+ from opscloud.skills.invocation import (
23
+ STATIC_SKILL_ALIASES,
24
+ SkillInvocationEnvelope,
25
+ build_skill_invocation_envelope,
26
+ discover_skills_and_roots,
27
+ parse_skill_command,
28
+ )
29
+ from opscloud.skills.load import (
30
+ ExtendedSkillMetadata,
31
+ SkillMetadata,
32
+ get_skill_by_name,
33
+ get_skill_content_by_name,
34
+ list_skills,
35
+ load_skill_content,
36
+ )
37
+ from opscloud.skills.merge import merge_skill
38
+ from opscloud.skills.registry import (
39
+ SkillRegistry,
40
+ SkillSource,
41
+ get_skill_registry,
42
+ )
43
+ from opscloud.skills.sources import (
44
+ CodeSkillSource,
45
+ DirectorySkillSource,
46
+ PluginSkillSource,
47
+ get_skill_sources,
48
+ )
49
+ from opscloud.skills.trust import (
50
+ RevokeResult,
51
+ SkillTrustStore,
52
+ clear_trusted_skill_dirs,
53
+ is_skill_dir_trusted,
54
+ list_trusted_skill_dir_entries,
55
+ list_trusted_skill_dirs,
56
+ load_trusted_skill_dirs,
57
+ revoke_skill_dir_trust,
58
+ trust_skill_dir,
59
+ )
60
+
61
+ __all__ = [
62
+ "STATIC_SKILL_ALIASES",
63
+ "ExtendedSkillMetadata",
64
+ "RevokeResult",
65
+ "SkillInvocationEnvelope",
66
+ "SkillMetadata",
67
+ "SkillRegistry",
68
+ "SkillSource",
69
+ "SkillTrustStore",
70
+ "build_skill_invocation_envelope",
71
+ "clear_trusted_skill_dirs",
72
+ "discover_skills_and_roots",
73
+ "execute_skills_command",
74
+ "get_skill_by_name",
75
+ "get_skill_content_by_name",
76
+ "get_skill_registry",
77
+ "get_skill_sources",
78
+ "is_skill_dir_trusted",
79
+ "list_skills",
80
+ "list_skills_command",
81
+ "list_trusted_skill_dir_entries",
82
+ "list_trusted_skill_dirs",
83
+ "load_skill_content",
84
+ "load_trusted_skill_dirs",
85
+ "merge_skill",
86
+ "parse_skill_command",
87
+ "revoke_skill_dir_trust",
88
+ "setup_skills_parser",
89
+ "trust_skill_command",
90
+ "trust_skill_dir",
91
+ ]