feat(tools): add safety package init and example outputs

Author: DNKYr

docs/tools_safety/tool_safety_audit.jsonl

@@ -0,0 +1,2 @@
+{"timestamp":"2026-07-10T12:00:00.000Z","tool_name":"bash_tool","decision":"deny","risk_level":"critical","rule_ids":["DANGEROUS_DELETE_001"],"scan_duration_ms":3.2,"sanitized":false,"intercepted":true,"script_hash":"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"}
+{"timestamp":"2026-07-10T12:01:00.000Z","tool_name":"python_tool","decision":"allow","risk_level":null,"rule_ids":[],"scan_duration_ms":1.1,"sanitized":false,"intercepted":false,"script_hash":"d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4"}

docs/tools_safety/tool_safety_report.json

@@ -0,0 +1,17 @@
+{
+  "decision": "deny",
+  "risk_level": "critical",
+  "findings": [
+    {
+      "rule_id": "DANGEROUS_DELETE_001",
+      "risk_type": "dangerous_file_operation",
+      "risk_level": "critical",
+      "evidence": "rm -rf /home/user/data",
+      "message": "Dangerous file deletion detected",
+      "recommendation": "Use temporary directories or confirm deletion intent"
+    }
+  ],
+  "scan_duration_ms": 3.2,
+  "script_snippet": "rm -rf /home/user/data\n",
+  "scan_error": null
+}

trpc_agent_sdk/tools/safety/__init__.py

@@ -3,3 +3,34 @@
 # Copyright (C) 2026 Tencent. All rights reserved.
 #
 # tRPC-Agent-Python is licensed under Apache-2.0.
+"""Tool Script Safety Guard for tRPC-Agent-Python.
+
+Provides pre-execution safety scanning for Python scripts and Bash commands
+executed by tools. Integrates as a BaseFilter and as a standalone scanner.
+"""
+
+from ._audit import SafetyAuditLogger
+from ._filter import ToolSafetyFilter
+from ._policy import SafetyPolicy
+from ._scanner import ToolSafetyScanner
+from ._telemetry import set_safety_span_attrs
+from ._types import AuditEvent
+from ._types import Decision
+from ._types import RiskLevel
+from ._types import RiskType
+from ._types import RuleFinding
+from ._types import ScanReport
+
+__all__ = [
+    "ToolSafetyScanner",
+    "ToolSafetyFilter",
+    "SafetyPolicy",
+    "SafetyAuditLogger",
+    "set_safety_span_attrs",
+    "AuditEvent",
+    "Decision",
+    "RiskLevel",
+    "RiskType",
+    "RuleFinding",
+    "ScanReport",
+]