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,384 @@
1
+ """Tool filtering proxy middleware for restricting subagent tool access."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from collections.abc import Callable, Mapping, Sequence
6
+ import fnmatch
7
+ from typing import Any
8
+
9
+ from langchain.agents.middleware.types import AgentMiddleware
10
+ from langchain_core.messages import ToolMessage
11
+ from langgraph.prebuilt.tool_node import ToolCallRequest
12
+
13
+ from opscloud.middleware.registry import register_middleware
14
+ from opscloud.utils.logger import get_logger
15
+
16
+ logger = get_logger(__name__)
17
+
18
+
19
+ TOOL_ALIAS_MAP: dict[str, tuple[str, ...]] = {
20
+ "read": ("read_file", "view_file", "read_url_content"),
21
+ "read_file": ("read_file", "view_file", "read_url_content"),
22
+ "write": ("write_to_file", "write_file"),
23
+ "write_file": ("write_to_file", "write_file"),
24
+ "edit": ("replace_file_content", "multi_replace_file_content", "edit_file"),
25
+ "edit_file": ("replace_file_content", "multi_replace_file_content", "edit_file"),
26
+ "grep": ("grep_search", "grep"),
27
+ "grep_search": ("grep_search", "grep"),
28
+ "search": ("grep_search", "grep", "file_search"),
29
+ "glob": ("glob", "file_search", "dir_list"),
30
+ "ls": ("ls", "list_dir", "dir_list"),
31
+ "list_dir": ("ls", "list_dir", "dir_list"),
32
+ "bash": ("run_command", "execute"),
33
+ "execute": ("run_command", "execute"),
34
+ }
35
+
36
+ ALWAYS_ALLOWED_SYSTEM_TOOLS: frozenset[str] = frozenset({
37
+ "compact_conversation",
38
+ "ask_user",
39
+ })
40
+
41
+
42
+ def _mcp_server_from_tool(tool: object | None) -> str | None:
43
+ """Extract MCP server name from tool metadata."""
44
+ if tool is None:
45
+ return None
46
+ metadata = getattr(tool, "metadata", None)
47
+ if isinstance(metadata, Mapping):
48
+ for key in ("_mcp_server", "mcp_server", "mcp_server_name", "server_name"):
49
+ val = metadata.get(key)
50
+ if isinstance(val, str) and val:
51
+ return val
52
+ return None
53
+
54
+
55
+ def _mcp_original_name_from_tool(tool: object | None) -> str | None:
56
+ """Extract bare original MCP tool name from tool metadata."""
57
+ if tool is None:
58
+ return None
59
+ metadata = getattr(tool, "metadata", None)
60
+ if isinstance(metadata, Mapping):
61
+ for key in ("_mcp_original_name", "mcp_original_name", "original_name"):
62
+ val = metadata.get(key)
63
+ if isinstance(val, str) and val:
64
+ return val
65
+ orig = getattr(tool, "original_name", None)
66
+ return str(orig) if orig else None
67
+
68
+
69
+ def _parse_mcp_pattern(
70
+ pattern: str,
71
+ known_servers: set[str],
72
+ subagent_name: str | None = None,
73
+ ) -> tuple[str | None, str | None]:
74
+ """Parse (server_name, tool_pattern) from an MCP tool pattern.
75
+
76
+ Supports:
77
+ - mcp__plugin_<subagent>_<server>__<tool>
78
+ - mcp__plugin__<subagent>__<server>__<tool>
79
+ - mcp__<server>__<tool>
80
+ - <server>:<tool>
81
+ - <server>_*
82
+ """
83
+ if pattern.startswith("mcp__"):
84
+ content = pattern[5:]
85
+ parts = content.split("__")
86
+ if len(parts) == 2:
87
+ server_part, tool_pat = parts[0], parts[1]
88
+ if server_part.startswith("plugin_"):
89
+ rest = server_part[7:]
90
+ if subagent_name and rest.startswith(f"{subagent_name}_"):
91
+ return rest[len(subagent_name) + 1 :], tool_pat
92
+ for srv in sorted(known_servers, key=len, reverse=True):
93
+ if rest.endswith(f"_{srv}"):
94
+ return srv, tool_pat
95
+ if "_" in rest:
96
+ return rest.rsplit("_", 1)[1], tool_pat
97
+ return rest, tool_pat
98
+ return server_part, tool_pat
99
+ elif len(parts) >= 3:
100
+ tool_pat = parts[-1]
101
+ if parts[0] == "plugin":
102
+ server = parts[-2]
103
+ return server, tool_pat
104
+ return parts[0], tool_pat
105
+ elif ":" in pattern:
106
+ srv, tool_pat = pattern.split(":", 1)
107
+ return srv, tool_pat
108
+ elif pattern.endswith("_*"):
109
+ srv = pattern[:-2]
110
+ if srv in known_servers:
111
+ return srv, "*"
112
+ return None, None
113
+
114
+
115
+ def _expand_tool_patterns(
116
+ patterns: Sequence[str],
117
+ known_servers: set[str] | None = None,
118
+ subagent_name: str | None = None,
119
+ ) -> tuple[str, ...]:
120
+ """Expand tool pattern list with aliases, wire projections, and provider-safe variations."""
121
+ expanded: list[str] = []
122
+ seen: set[str] = set()
123
+
124
+ def _add(p: str | None) -> None:
125
+ if p and p not in seen:
126
+ seen.add(p)
127
+ expanded.append(p)
128
+
129
+ known = set(known_servers or ())
130
+
131
+ for pattern in patterns:
132
+ _add(pattern)
133
+ clean = pattern.strip().lower()
134
+ if clean in TOOL_ALIAS_MAP:
135
+ for alias in TOOL_ALIAS_MAP[clean]:
136
+ _add(alias)
137
+
138
+ server, tool_pat = _parse_mcp_pattern(pattern, known, subagent_name)
139
+ if server:
140
+ known.add(server)
141
+ _add(f"mcp__{server}__{tool_pat}")
142
+ _add(f"{server}:{tool_pat}")
143
+ _add(f"{server}_{tool_pat}")
144
+ if subagent_name:
145
+ _add(f"mcp__plugin_{subagent_name}_{server}__{tool_pat}")
146
+ _add(f"mcp__plugin__{subagent_name}__{server}__{tool_pat}")
147
+ if tool_pat == "*":
148
+ _add(server)
149
+ _add(f"{server}_*")
150
+ _add(f"{server}:*")
151
+ _add(f"mcp__{server}__*")
152
+ else:
153
+ _add(tool_pat)
154
+
155
+ return tuple(expanded)
156
+
157
+
158
+ _GLOB_METACHARS = frozenset("*?[")
159
+
160
+
161
+ def _entry_matches_tool(
162
+ pattern: str,
163
+ cand: str,
164
+ base_name: str,
165
+ server_name: str | None = None,
166
+ ) -> bool:
167
+ """Check if an allowed pattern matches a tool call under any valid naming projection."""
168
+ if server_name:
169
+ if pattern in {
170
+ f"mcp__{server_name}__*",
171
+ f"{server_name}:*",
172
+ f"{server_name}_*",
173
+ server_name,
174
+ }:
175
+ return True
176
+ if fnmatch.fnmatch(server_name, pattern) or fnmatch.fnmatch(server_name.lower(), pattern.lower()):
177
+ return True
178
+
179
+ is_glob = any(ch in _GLOB_METACHARS for ch in pattern)
180
+ if is_glob:
181
+ if fnmatch.fnmatch(cand, pattern) or fnmatch.fnmatch(cand.lower(), pattern.lower()):
182
+ return True
183
+ else:
184
+ if cand == pattern or cand.lower() == pattern.lower():
185
+ return True
186
+
187
+ return False
188
+
189
+
190
+ @register_middleware(name="tool_filter")
191
+ class ToolFilterMiddleware(AgentMiddleware[Any, Any]):
192
+ """Filters tool calls against an allowlist of allowed tool patterns (fnmatch format)."""
193
+
194
+ def __init__(
195
+ self,
196
+ allowed_patterns: Sequence[str | dict[str, Any]] | None = None,
197
+ capabilities: Sequence[dict[str, Any] | str] | None = None,
198
+ subagent_name: str | None = None,
199
+ mcp_tools: Sequence[Any] | None = None,
200
+ known_mcp_servers: Sequence[str] | set[str] | None = None,
201
+ ) -> None:
202
+ super().__init__()
203
+ self._subagent_name = subagent_name
204
+ self._known_mcp_servers: set[str] = set(known_mcp_servers or ())
205
+ self._tool_to_server: dict[str, str] = {}
206
+ self._tool_to_orig_name: dict[str, str] = {}
207
+
208
+ if mcp_tools:
209
+ for tool in mcp_tools:
210
+ name = getattr(tool, "name", None)
211
+ if isinstance(name, str) and name:
212
+ srv = _mcp_server_from_tool(tool)
213
+ if srv:
214
+ self._tool_to_server[name] = srv
215
+ self._known_mcp_servers.add(srv)
216
+ orig = _mcp_original_name_from_tool(tool)
217
+ if orig:
218
+ self._tool_to_orig_name[name] = orig
219
+
220
+ patterns: list[str] = []
221
+
222
+ if allowed_patterns is not None:
223
+ for item in allowed_patterns:
224
+ if isinstance(item, dict):
225
+ server = item.get("mcp_server")
226
+ if server and item.get("allow_all"):
227
+ patterns.append(f"mcp__{server}__*")
228
+ patterns.append(f"{server}:*")
229
+ patterns.append(f"{server}_*")
230
+ if "tools" in item and isinstance(item["tools"], (list, tuple)):
231
+ patterns.extend(str(t) for t in item["tools"])
232
+ elif isinstance(item, str):
233
+ patterns.append(item)
234
+
235
+ if capabilities:
236
+ for cap in capabilities:
237
+ if isinstance(cap, dict):
238
+ server = cap.get("mcp_server")
239
+ if server and cap.get("allow_all"):
240
+ patterns.append(f"mcp__{server}__*")
241
+ patterns.append(f"{server}:*")
242
+ patterns.append(f"{server}_*")
243
+ if "tools" in cap and isinstance(cap["tools"], (list, tuple)):
244
+ patterns.extend(str(t) for t in cap["tools"])
245
+ elif isinstance(cap, str):
246
+ patterns.append(cap)
247
+
248
+ self._allowed_patterns: tuple[str, ...] = (
249
+ _expand_tool_patterns(patterns, self._known_mcp_servers, self._subagent_name)
250
+ if patterns
251
+ else ()
252
+ )
253
+
254
+ def is_tool_allowed(self, tool_name: str, tool_obj: Any = None) -> bool:
255
+ """Check if a tool name matches any allowed patterns."""
256
+ if tool_name in ALWAYS_ALLOWED_SYSTEM_TOOLS:
257
+ return True
258
+ if not self._allowed_patterns:
259
+ return True
260
+
261
+ server_name: str | None = None
262
+ base_name: str | None = None
263
+
264
+ if tool_obj is not None:
265
+ server_name = _mcp_server_from_tool(tool_obj)
266
+ base_name = _mcp_original_name_from_tool(tool_obj)
267
+ if server_name:
268
+ self._known_mcp_servers.add(server_name)
269
+ self._tool_to_server[tool_name] = server_name
270
+
271
+ if not server_name and tool_name in self._tool_to_server:
272
+ server_name = self._tool_to_server[tool_name]
273
+ base_name = self._tool_to_orig_name.get(tool_name)
274
+
275
+ if not server_name:
276
+ if tool_name.startswith("mcp__"):
277
+ parts = tool_name[5:].split("__")
278
+ if len(parts) == 2:
279
+ server_name, base_name = parts[0], parts[1]
280
+ elif len(parts) >= 3:
281
+ base_name = parts[-1]
282
+ server_part = parts[-2]
283
+ for srv in sorted(self._known_mcp_servers, key=len, reverse=True):
284
+ if parts[1].endswith(f"_{srv}") or parts[1].endswith(f"__{srv}") or parts[1] == srv:
285
+ server_name = srv
286
+ break
287
+ if not server_name:
288
+ server_name = server_part
289
+ elif ":" in tool_name:
290
+ server_name, base_name = tool_name.split(":", 1)
291
+ else:
292
+ for srv in sorted(self._known_mcp_servers, key=len, reverse=True):
293
+ if tool_name.startswith(f"{srv}_"):
294
+ server_name = srv
295
+ base_name = tool_name[len(srv) + 1 :]
296
+ break
297
+
298
+ if not base_name:
299
+ base_name = tool_name
300
+
301
+ candidates: list[str] = [tool_name, base_name]
302
+ if server_name:
303
+ candidates.extend([
304
+ f"{server_name}_{base_name}",
305
+ f"{server_name}:{base_name}",
306
+ f"mcp__{server_name}__{base_name}",
307
+ server_name,
308
+ ])
309
+ if self._subagent_name:
310
+ candidates.extend([
311
+ f"mcp__plugin_{self._subagent_name}_{server_name}__{base_name}",
312
+ f"mcp__plugin__{self._subagent_name}__{server_name}__{base_name}",
313
+ ])
314
+
315
+ from opscloud.hooks.tools import to_wire_tool_name
316
+
317
+ wire_name = to_wire_tool_name(tool_name, mcp_server=server_name)
318
+ if wire_name not in candidates:
319
+ candidates.append(wire_name)
320
+
321
+ for cand in candidates:
322
+ for pattern in self._allowed_patterns:
323
+ if _entry_matches_tool(pattern, cand, base_name, server_name):
324
+ return True
325
+
326
+ return False
327
+
328
+ def _validate_tool_call(self, request: ToolCallRequest) -> ToolMessage | None:
329
+ tool_name = (
330
+ request.tool_call.get("name", "")
331
+ if getattr(request, "tool_call", None) and isinstance(request.tool_call, dict)
332
+ else ""
333
+ )
334
+ tool_obj = getattr(request, "tool", None)
335
+ if self.is_tool_allowed(tool_name, tool_obj=tool_obj):
336
+ return None
337
+
338
+ allowed_str = ", ".join(self._allowed_patterns)
339
+
340
+ logger.warning(
341
+ "Tool call %r blocked for subagent (not in allowed list: %s)",
342
+ tool_name,
343
+ allowed_str,
344
+ )
345
+ return ToolMessage(
346
+ content=(
347
+ f"Tool call rejected: tool `{tool_name}` is restricted for this subagent. "
348
+ f"Allowed tool patterns: [{allowed_str}]."
349
+ ),
350
+ name=tool_name,
351
+ tool_call_id=(
352
+ request.tool_call.get("id", "")
353
+ if getattr(request, "tool_call", None) and isinstance(request.tool_call, dict)
354
+ else ""
355
+ ),
356
+ status="error",
357
+ )
358
+
359
+ def wrap_tool_call(
360
+ self,
361
+ request: ToolCallRequest,
362
+ handler: Callable[[ToolCallRequest], Any],
363
+ ) -> Any:
364
+ err = self._validate_tool_call(request)
365
+ if err is not None:
366
+ return err
367
+ return handler(request)
368
+
369
+ async def awrap_tool_call(
370
+ self,
371
+ request: ToolCallRequest,
372
+ handler: Callable[[ToolCallRequest], Any],
373
+ ) -> Any:
374
+ err = self._validate_tool_call(request)
375
+ if err is not None:
376
+ return err
377
+ return await handler(request)
378
+
379
+
380
+ __all__ = [
381
+ "ALWAYS_ALLOWED_SYSTEM_TOOLS",
382
+ "TOOL_ALIAS_MAP",
383
+ "ToolFilterMiddleware",
384
+ ]
@@ -0,0 +1,62 @@
1
+ """Middleware to collapse list-based system message content blocks into a single string."""
2
+
3
+ from typing import Any, Awaitable, Callable
4
+
5
+ from opscloud.utils.logger import get_logger
6
+ from langchain.agents.middleware.types import (
7
+ AgentMiddleware,
8
+ ExtendedModelResponse,
9
+ ModelRequest,
10
+ ModelResponse,
11
+ )
12
+ from langchain_core.messages import SystemMessage
13
+
14
+ from opscloud.middleware.registry import register_middleware
15
+
16
+ logger = get_logger(__name__)
17
+
18
+
19
+ def unify_system_message(system_message: SystemMessage | None) -> SystemMessage | None:
20
+ if system_message is None:
21
+ return None
22
+ content = getattr(system_message, "content", None)
23
+ if isinstance(content, str):
24
+ return system_message
25
+
26
+ if isinstance(content, list):
27
+ parts: list[str] = []
28
+ for block in content:
29
+ if isinstance(block, dict) and block.get("type") == "text":
30
+ txt = block.get("text", "")
31
+ if txt:
32
+ parts.append(txt)
33
+ elif isinstance(block, str) and block:
34
+ parts.append(block)
35
+ unified_text = "".join(parts).strip()
36
+ return SystemMessage(content=unified_text)
37
+ return system_message
38
+
39
+
40
+ @register_middleware(name="unified_system_message")
41
+ class UnifiedSystemMessageMiddleware(AgentMiddleware[Any, Any]):
42
+ """Middleware that collapses SystemMessage content blocks into a single string."""
43
+
44
+ def wrap_model_call(
45
+ self,
46
+ request: ModelRequest,
47
+ handler: Callable[[ModelRequest], ModelResponse],
48
+ ) -> ModelResponse | ExtendedModelResponse:
49
+ unified_msg = unify_system_message(request.system_message)
50
+ if unified_msg is not None and unified_msg is not request.system_message:
51
+ request = request.override(system_message=unified_msg)
52
+ return handler(request)
53
+
54
+ async def awrap_model_call(
55
+ self,
56
+ request: ModelRequest,
57
+ handler: Callable[[ModelRequest], Awaitable[ModelResponse]],
58
+ ) -> ModelResponse | ExtendedModelResponse:
59
+ unified_msg = unify_system_message(request.system_message)
60
+ if unified_msg is not None and unified_msg is not request.system_message:
61
+ request = request.override(system_message=unified_msg)
62
+ return await handler(request)
@@ -0,0 +1,37 @@
1
+ """Model creation and configuration package for opscloud."""
2
+
3
+ from opscloud.model.config import (
4
+ MODEL_PROFILES,
5
+ PROVIDER_API_KEY_ENV,
6
+ PROVIDER_BASE_URL_ENV,
7
+ ModelConfig,
8
+ ModelSpec,
9
+ apply_stored_credentials,
10
+ clear_default_model,
11
+ detect_provider,
12
+ load_default_model,
13
+ normalize_model_spec,
14
+ save_default_model,
15
+ )
16
+ from opscloud.model.factory import (
17
+ ModelResult,
18
+ clear_model_cache,
19
+ create_model,
20
+ )
21
+
22
+ __all__ = [
23
+ "ModelConfig",
24
+ "ModelSpec",
25
+ "ModelResult",
26
+ "apply_stored_credentials",
27
+ "clear_default_model",
28
+ "clear_model_cache",
29
+ "create_model",
30
+ "detect_provider",
31
+ "load_default_model",
32
+ "normalize_model_spec",
33
+ "save_default_model",
34
+ "PROVIDER_API_KEY_ENV",
35
+ "PROVIDER_BASE_URL_ENV",
36
+ "MODEL_PROFILES",
37
+ ]