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.
- opscloud/__init__.py +5 -0
- opscloud/__main__.py +6 -0
- opscloud/_constants.py +53 -0
- opscloud/_debug.py +145 -0
- opscloud/_debug_buffer.py +250 -0
- opscloud/_textual_patches.py +367 -0
- opscloud/_version.py +15 -0
- opscloud/agent/__init__.py +27 -0
- opscloud/agent/config.py +168 -0
- opscloud/agent/factory.py +1103 -0
- opscloud/approval_mode.py +44 -0
- opscloud/backend/__init__.py +49 -0
- opscloud/backend/composite.py +89 -0
- opscloud/backend/local.py +183 -0
- opscloud/backend/registry.py +79 -0
- opscloud/backend/sandbox_config.py +107 -0
- opscloud/backend/sandbox_factory.py +432 -0
- opscloud/built_in_skills/remember/SKILL.md +124 -0
- opscloud/built_in_skills/skill-creator/SKILL.md +348 -0
- opscloud/built_in_skills/skill-creator/scripts/init_skill.py +371 -0
- opscloud/built_in_skills/skill-creator/scripts/quick_validate.py +165 -0
- opscloud/cli/__init__.py +1 -0
- opscloud/cli/commands/__init__.py +15 -0
- opscloud/cli/commands/auth.py +45 -0
- opscloud/cli/commands/doctor.py +100 -0
- opscloud/cli/commands/mcp.py +137 -0
- opscloud/cli/commands/threads.py +51 -0
- opscloud/cli/interactive.py +154 -0
- opscloud/cli/main.py +903 -0
- opscloud/cli/non_interactive.py +425 -0
- opscloud/cli/server_manager.py +58 -0
- opscloud/commands/__init__.py +19 -0
- opscloud/commands/_base.py +110 -0
- opscloud/commands/_guards.py +52 -0
- opscloud/commands/_router.py +146 -0
- opscloud/commands/_types.py +36 -0
- opscloud/commands/core/__init__.py +47 -0
- opscloud/commands/core/auth.py +94 -0
- opscloud/commands/core/bug.py +46 -0
- opscloud/commands/core/clear.py +106 -0
- opscloud/commands/core/cloud.py +185 -0
- opscloud/commands/core/compact.py +128 -0
- opscloud/commands/core/config_cmd.py +120 -0
- opscloud/commands/core/context.py +220 -0
- opscloud/commands/core/cost.py +44 -0
- opscloud/commands/core/doctor.py +535 -0
- opscloud/commands/core/effort.py +108 -0
- opscloud/commands/core/exit_cmd.py +41 -0
- opscloud/commands/core/fast.py +148 -0
- opscloud/commands/core/help_cmd.py +94 -0
- opscloud/commands/core/mcp.py +134 -0
- opscloud/commands/core/model.py +109 -0
- opscloud/commands/core/permissions.py +196 -0
- opscloud/commands/core/plugins.py +92 -0
- opscloud/commands/core/pool.py +108 -0
- opscloud/commands/core/resume.py +97 -0
- opscloud/commands/core/skills.py +178 -0
- opscloud/commands/power/__init__.py +51 -0
- opscloud/commands/power/agents.py +98 -0
- opscloud/commands/power/btw.py +85 -0
- opscloud/commands/power/copy.py +97 -0
- opscloud/commands/power/goal.py +548 -0
- opscloud/commands/power/loop.py +295 -0
- opscloud/commands/power/memory.py +287 -0
- opscloud/commands/power/review.py +152 -0
- opscloud/commands/power/rubric.py +287 -0
- opscloud/commands/power/runtime.py +321 -0
- opscloud/commands/power/skill_creator.py +70 -0
- opscloud/commands/power/skill_invoke.py +165 -0
- opscloud/commands/power/tasks.py +209 -0
- opscloud/commands/power/trace.py +117 -0
- opscloud/commands/power/ui_toggles.py +135 -0
- opscloud/commands/power/version.py +52 -0
- opscloud/commands/registry.py +176 -0
- opscloud/config/__init__.py +114 -0
- opscloud/config/adapters/__init__.py +5 -0
- opscloud/config/adapters/postgres.py +776 -0
- opscloud/config/adapters/sqlite.py +769 -0
- opscloud/config/aws.py +248 -0
- opscloud/config/cloud_profiles.py +437 -0
- opscloud/config/env_vars.py +81 -0
- opscloud/config/langsmith.py +319 -0
- opscloud/config/manifest.py +817 -0
- opscloud/config/metadata.py +205 -0
- opscloud/config/paths.py +604 -0
- opscloud/config/plugins.py +130 -0
- opscloud/config/settings.py +834 -0
- opscloud/config/store.py +453 -0
- opscloud/config/store_factory.py +97 -0
- opscloud/config/toml_config.py +562 -0
- opscloud/editor.py +173 -0
- opscloud/exceptions.py +65 -0
- opscloud/file_ops.py +217 -0
- opscloud/hooks/__init__.py +139 -0
- opscloud/hooks/env.py +44 -0
- opscloud/hooks/interrupt.py +121 -0
- opscloud/hooks/models/__init__.py +109 -0
- opscloud/hooks/models/adapters.py +19 -0
- opscloud/hooks/models/config.py +79 -0
- opscloud/hooks/models/domain.py +434 -0
- opscloud/hooks/models/transport.py +37 -0
- opscloud/hooks/tools.py +231 -0
- opscloud/input.py +48 -0
- opscloud/integrations/__init__.py +80 -0
- opscloud/integrations/base.py +153 -0
- opscloud/integrations/content_filter.py +119 -0
- opscloud/integrations/event_bus.py +480 -0
- opscloud/integrations/hooks.py +238 -0
- opscloud/integrations/identity.py +181 -0
- opscloud/integrations/notifications.py +134 -0
- opscloud/integrations/stream_bridge.py +397 -0
- opscloud/integrations/thread_store.py +81 -0
- opscloud/json_types.py +20 -0
- opscloud/mcp/__init__.py +57 -0
- opscloud/mcp/config.py +203 -0
- opscloud/mcp/discovery.py +229 -0
- opscloud/mcp/mcp_info.py +109 -0
- opscloud/mcp/middleware.py +102 -0
- opscloud/mcp/preload.py +505 -0
- opscloud/mcp/raw_config.py +149 -0
- opscloud/mcp/semantic_profiler.py +305 -0
- opscloud/mcp/session_manager.py +727 -0
- opscloud/mcp/trust.py +105 -0
- opscloud/memory/__init__.py +27 -0
- opscloud/memory/branch.py +61 -0
- opscloud/memory/guard.py +19 -0
- opscloud/memory/onboarding.py +120 -0
- opscloud/memory/registry.py +134 -0
- opscloud/memory/store.py +223 -0
- opscloud/middleware/__init__.py +106 -0
- opscloud/middleware/_repository_bounds.py +459 -0
- opscloud/middleware/ask_user.py +152 -0
- opscloud/middleware/auto_mode.py +60 -0
- opscloud/middleware/auto_mode_hitl.py +2434 -0
- opscloud/middleware/compaction.py +566 -0
- opscloud/middleware/configurable_model.py +233 -0
- opscloud/middleware/cost_tracking.py +1021 -0
- opscloud/middleware/glm_stall_recovery.py +109 -0
- opscloud/middleware/goal_criteria.py +1234 -0
- opscloud/middleware/goal_state_notice.py +712 -0
- opscloud/middleware/goal_tools.py +407 -0
- opscloud/middleware/headless_mcp_guard.py +88 -0
- opscloud/middleware/jev_model_router.py +1018 -0
- opscloud/middleware/local_context.py +460 -0
- opscloud/middleware/mcp_context.py +151 -0
- opscloud/middleware/mcp_middleware.py +146 -0
- opscloud/middleware/memory_guard.py +393 -0
- opscloud/middleware/model_retry.py +205 -0
- opscloud/middleware/registry.py +137 -0
- opscloud/middleware/reliable_rubric.py +709 -0
- opscloud/middleware/resume_state.py +91 -0
- opscloud/middleware/server_hooks.py +1189 -0
- opscloud/middleware/shell_allow_list.py +90 -0
- opscloud/middleware/skills.py +382 -0
- opscloud/middleware/subagent_artifacts.py +84 -0
- opscloud/middleware/subagent_telemetry.py +261 -0
- opscloud/middleware/subagents.py +243 -0
- opscloud/middleware/tool_filter.py +384 -0
- opscloud/middleware/unified_system_message.py +62 -0
- opscloud/model/__init__.py +37 -0
- opscloud/model/config.py +2992 -0
- opscloud/model/factory.py +477 -0
- opscloud/model/pool.py +459 -0
- opscloud/model/reasoning.py +282 -0
- opscloud/offload.py +173 -0
- opscloud/output.py +64 -0
- opscloud/plugins/__init__.py +189 -0
- opscloud/plugins/_json.py +22 -0
- opscloud/plugins/adapters/__init__.py +13 -0
- opscloud/plugins/adapters/agents.py +112 -0
- opscloud/plugins/adapters/commands.py +190 -0
- opscloud/plugins/adapters/mcp.py +363 -0
- opscloud/plugins/adapters/skills.py +132 -0
- opscloud/plugins/commands_cli.py +541 -0
- opscloud/plugins/discovery.py +512 -0
- opscloud/plugins/manifest.py +335 -0
- opscloud/plugins/marketplace.py +893 -0
- opscloud/plugins/models.py +334 -0
- opscloud/plugins/project_plugins.py +317 -0
- opscloud/plugins/protocol.py +31 -0
- opscloud/plugins/store.py +905 -0
- opscloud/plugins/substitution.py +122 -0
- opscloud/project_utils.py +145 -0
- opscloud/prompts/__init__.py +37 -0
- opscloud/prompts/system.py +483 -0
- opscloud/prompts/templates/system_prompt.md +166 -0
- opscloud/prompts/types.py +54 -0
- opscloud/rubrics/__init__.py +42 -0
- opscloud/rubrics/evaluator.py +404 -0
- opscloud/rubrics/evidence_extractor.py +229 -0
- opscloud/rubrics/generator.py +239 -0
- opscloud/rubrics/jev_compiler.py +175 -0
- opscloud/rubrics/jev_grader.py +297 -0
- opscloud/rubrics/middleware.py +8 -0
- opscloud/schema/__init__.py +107 -0
- opscloud/schema/interrupts.py +981 -0
- opscloud/security/__init__.py +91 -0
- opscloud/security/approval_mode.py +528 -0
- opscloud/security/approval_mode_source.py +230 -0
- opscloud/security/cli_ast_evaluator.py +552 -0
- opscloud/security/jev_classifier.py +651 -0
- opscloud/security/shell_safety.py +340 -0
- opscloud/security/unicode_security.py +439 -0
- opscloud/security/url_validation.py +160 -0
- opscloud/server/__init__.py +13 -0
- opscloud/server/_server_config.py +158 -0
- opscloud/server/server.py +242 -0
- opscloud/server/server_graph.py +93 -0
- opscloud/skills/__init__.py +91 -0
- opscloud/skills/commands.py +1099 -0
- opscloud/skills/invocation.py +200 -0
- opscloud/skills/load.py +388 -0
- opscloud/skills/loader.py +23 -0
- opscloud/skills/merge.py +65 -0
- opscloud/skills/registry.py +263 -0
- opscloud/skills/sources.py +174 -0
- opscloud/skills/trust.py +417 -0
- opscloud/state/__init__.py +142 -0
- opscloud/state/base.py +154 -0
- opscloud/state/cloud_context.py +262 -0
- opscloud/state/goal_channels.py +124 -0
- opscloud/state/goal_state_limits.py +175 -0
- opscloud/state/resume_state.py +58 -0
- opscloud/state/service_context.py +281 -0
- opscloud/state/session.py +957 -0
- opscloud/state/state_migration.py +86 -0
- opscloud/subagents/__init__.py +30 -0
- opscloud/subagents/loader.py +331 -0
- opscloud/subagents/subagents_parser.py +117 -0
- opscloud/subagents/types.py +25 -0
- opscloud/tools/__init__.py +36 -0
- opscloud/tools/catalog.py +37 -0
- opscloud/tools/display.py +24 -0
- opscloud/tools/fetch_url.py +176 -0
- opscloud/tools/goal_tools.py +423 -0
- opscloud/tools/registry.py +105 -0
- opscloud/tools/thread.py +32 -0
- opscloud/tools/web_search.py +215 -0
- opscloud/ui/__init__.py +119 -0
- opscloud/ui/app.py +5400 -0
- opscloud/ui/app.tcss +479 -0
- opscloud/ui/clipboard.py +147 -0
- opscloud/ui/command_registry.py +482 -0
- opscloud/ui/message_store.py +152 -0
- opscloud/ui/permission_store.py +360 -0
- opscloud/ui/preferences.py +113 -0
- opscloud/ui/prompt_manager.py +96 -0
- opscloud/ui/remote_client.py +505 -0
- opscloud/ui/textual_adapter.py +1269 -0
- opscloud/ui/theme.py +728 -0
- opscloud/ui/ui_help.py +415 -0
- opscloud/ui/widgets/__init__.py +383 -0
- opscloud/ui/widgets/_ask_user_types.py +81 -0
- opscloud/ui/widgets/_copy_spans.py +52 -0
- opscloud/ui/widgets/_inline_prompt.py +290 -0
- opscloud/ui/widgets/_js_eval_display.py +139 -0
- opscloud/ui/widgets/_links.py +175 -0
- opscloud/ui/widgets/_tool_stream.py +308 -0
- opscloud/ui/widgets/agent_selector.py +297 -0
- opscloud/ui/widgets/approval.py +741 -0
- opscloud/ui/widgets/ask_user.py +539 -0
- opscloud/ui/widgets/auth.py +695 -0
- opscloud/ui/widgets/auth_manager.py +214 -0
- opscloud/ui/widgets/auto_mode_notice.py +146 -0
- opscloud/ui/widgets/autocomplete.py +709 -0
- opscloud/ui/widgets/chat_input.py +805 -0
- opscloud/ui/widgets/cloud_selector.py +528 -0
- opscloud/ui/widgets/config_manager.py +652 -0
- opscloud/ui/widgets/debug_console.py +1269 -0
- opscloud/ui/widgets/devops_renderers.py +184 -0
- opscloud/ui/widgets/diff.py +237 -0
- opscloud/ui/widgets/effort_selector.py +166 -0
- opscloud/ui/widgets/goal_review.py +612 -0
- opscloud/ui/widgets/goal_status.py +57 -0
- opscloud/ui/widgets/infra_panel.py +141 -0
- opscloud/ui/widgets/install_confirm.py +114 -0
- opscloud/ui/widgets/loading.py +170 -0
- opscloud/ui/widgets/mcp_viewer.py +1204 -0
- opscloud/ui/widgets/messages.py +4461 -0
- opscloud/ui/widgets/model_selector.py +863 -0
- opscloud/ui/widgets/notification_center.py +108 -0
- opscloud/ui/widgets/notification_settings.py +119 -0
- opscloud/ui/widgets/operation_card.py +106 -0
- opscloud/ui/widgets/permissions_manager.py +667 -0
- opscloud/ui/widgets/plugin_manager.py +1212 -0
- opscloud/ui/widgets/pool_selector.py +376 -0
- opscloud/ui/widgets/preamble.py +53 -0
- opscloud/ui/widgets/skills_viewer.py +432 -0
- opscloud/ui/widgets/status.py +1037 -0
- opscloud/ui/widgets/subagent_panel.py +927 -0
- opscloud/ui/widgets/theme_selector.py +232 -0
- opscloud/ui/widgets/thread_selector.py +358 -0
- opscloud/ui/widgets/toast.py +31 -0
- opscloud/ui/widgets/tool_display.py +325 -0
- opscloud/ui/widgets/tool_renderers.py +234 -0
- opscloud/ui/widgets/tool_widgets.py +278 -0
- opscloud/ui/widgets/welcome.py +421 -0
- opscloud/ui/widgets/welcome_popup.py +102 -0
- opscloud/utils/__init__.py +24 -0
- opscloud/utils/cost_estimation.py +169 -0
- opscloud/utils/git.py +390 -0
- opscloud/utils/logger.py +571 -0
- opscloud/utils/session_stats.py +115 -0
- opscloud/utils/startup_error.py +37 -0
- talkops_opscloud-0.3.0b1.dist-info/METADATA +449 -0
- talkops_opscloud-0.3.0b1.dist-info/RECORD +309 -0
- talkops_opscloud-0.3.0b1.dist-info/WHEEL +4 -0
- talkops_opscloud-0.3.0b1.dist-info/entry_points.txt +2 -0
- 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
|
+
]
|