agenticdome-python-sdk 1.2.18__tar.gz → 1.2.21__tar.gz

{agenticdome_python_sdk-1.2.18 → agenticdome_python_sdk-1.2.21}/MANIFEST.in

@@ -9,7 +9,7 @@ include setup.py
 recursive-include examples *.py
 recursive-include examples *.md
 recursive-include docs *.md
-recursive-include tests *.py
+prune tests
 global-exclude __pycache__
 global-exclude *.py[cod]
 global-exclude .DS_Store

{agenticdome_python_sdk-1.2.18 → agenticdome_python_sdk-1.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenticdome-python-sdk
-Version: 1.2.18
+Version: 1.2.21
 Summary: Official Python SDK for AgenticDome security guardrails, DLP, tool authorization, and multi-agent delegation enforcement.
 Author: AgenticDome
 License-Expression: Apache-2.0
@@ -32,20 +32,20 @@ License-File: NOTICE
 Requires-Dist: requests>=2.31.0
 Requires-Dist: urllib3>=2.0.0
 Provides-Extra: crewai
-Requires-Dist: crewai<=1.15.16,>=1.15.5; extra == "crewai"
+Requires-Dist: crewai<=1.15.17,>=1.15.5; extra == "crewai"
 Provides-Extra: redis
 Requires-Dist: redis>=4.5.0; extra == "redis"
 Provides-Extra: pop
 Requires-Dist: cryptography>=42.0.0; extra == "pop"
 Provides-Extra: pydanticai
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "pydanticai"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "pydanticai"
 Requires-Dist: anyio>=4.0.0; extra == "pydanticai"
 Provides-Extra: pydantic
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "pydantic"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "pydantic"
 Requires-Dist: anyio>=4.0.0; extra == "pydantic"
 Provides-Extra: langgraph
 Requires-Dist: langgraph<=1.2.11,>=1.2.9; extra == "langgraph"
-Requires-Dist: langchain-core<=1.5.5,>=1.5.0; extra == "langgraph"
+Requires-Dist: langchain-core<=1.6.0,>=1.5.0; extra == "langgraph"
 Requires-Dist: langchain-openai==1.3.5; extra == "langgraph"
 Requires-Dist: anyio>=4.0.0; extra == "langgraph"
 Provides-Extra: microsoft
@@ -59,46 +59,46 @@ Requires-Dist: azure-identity==1.25.3; extra == "foundry"
 Provides-Extra: agno
 Requires-Dist: agno<=2.9.0,>=2.8.0; extra == "agno"
 Provides-Extra: openai-agents
-Requires-Dist: openai-agents<=0.21.0,>=0.18.3; extra == "openai-agents"
+Requires-Dist: openai-agents<=0.22.0,>=0.18.3; extra == "openai-agents"
 Provides-Extra: mcp
 Requires-Dist: mcp<=1.28.1,>=1.26.0; extra == "mcp"
 Provides-Extra: bedrock
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "bedrock"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "bedrock"
 Provides-Extra: aws-bedrock
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "aws-bedrock"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "aws-bedrock"
 Provides-Extra: llamaindex
-Requires-Dist: llama-index==0.14.23; extra == "llamaindex"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "llamaindex"
 Provides-Extra: llama-index
-Requires-Dist: llama-index==0.14.23; extra == "llama-index"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "llama-index"
 Provides-Extra: google-adk
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "google-adk"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "google-adk"
 Provides-Extra: adk
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "adk"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "adk"
 Provides-Extra: claude
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "claude"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "claude"
 Provides-Extra: claude-agent-sdk
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "claude-agent-sdk"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "claude-agent-sdk"
 Provides-Extra: smolagents
 Requires-Dist: smolagents==1.26.0; extra == "smolagents"
 Provides-Extra: all
-Requires-Dist: crewai<=1.15.16,>=1.15.5; extra == "all"
+Requires-Dist: crewai<=1.15.17,>=1.15.5; extra == "all"
 Requires-Dist: redis>=4.5.0; extra == "all"
 Requires-Dist: cryptography>=42.0.0; extra == "all"
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "all"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "all"
 Requires-Dist: anyio>=4.0.0; extra == "all"
 Requires-Dist: langgraph<=1.2.11,>=1.2.9; extra == "all"
-Requires-Dist: langchain-core<=1.5.5,>=1.5.0; extra == "all"
+Requires-Dist: langchain-core<=1.6.0,>=1.5.0; extra == "all"
 Requires-Dist: langchain-openai==1.3.5; extra == "all"
 Requires-Dist: autogen-agentchat==0.7.5; extra == "all"
 Requires-Dist: agno<=2.9.0,>=2.8.0; extra == "all"
 Requires-Dist: azure-ai-projects<=2.4.0,>=2.3.0; extra == "all"
 Requires-Dist: azure-identity==1.25.3; extra == "all"
-Requires-Dist: openai-agents<=0.21.0,>=0.18.3; extra == "all"
+Requires-Dist: openai-agents<=0.22.0,>=0.18.3; extra == "all"
 Requires-Dist: mcp<=1.28.1,>=1.26.0; extra == "all"
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "all"
-Requires-Dist: llama-index==0.14.23; extra == "all"
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "all"
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "all"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "all"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "all"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "all"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "all"
 Requires-Dist: smolagents==1.26.0; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"

{agenticdome_python_sdk-1.2.18 → agenticdome_python_sdk-1.2.21}/agenticdome_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenticdome-python-sdk
-Version: 1.2.18
+Version: 1.2.21
 Summary: Official Python SDK for AgenticDome security guardrails, DLP, tool authorization, and multi-agent delegation enforcement.
 Author: AgenticDome
 License-Expression: Apache-2.0
@@ -32,20 +32,20 @@ License-File: NOTICE
 Requires-Dist: requests>=2.31.0
 Requires-Dist: urllib3>=2.0.0
 Provides-Extra: crewai
-Requires-Dist: crewai<=1.15.16,>=1.15.5; extra == "crewai"
+Requires-Dist: crewai<=1.15.17,>=1.15.5; extra == "crewai"
 Provides-Extra: redis
 Requires-Dist: redis>=4.5.0; extra == "redis"
 Provides-Extra: pop
 Requires-Dist: cryptography>=42.0.0; extra == "pop"
 Provides-Extra: pydanticai
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "pydanticai"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "pydanticai"
 Requires-Dist: anyio>=4.0.0; extra == "pydanticai"
 Provides-Extra: pydantic
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "pydantic"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "pydantic"
 Requires-Dist: anyio>=4.0.0; extra == "pydantic"
 Provides-Extra: langgraph
 Requires-Dist: langgraph<=1.2.11,>=1.2.9; extra == "langgraph"
-Requires-Dist: langchain-core<=1.5.5,>=1.5.0; extra == "langgraph"
+Requires-Dist: langchain-core<=1.6.0,>=1.5.0; extra == "langgraph"
 Requires-Dist: langchain-openai==1.3.5; extra == "langgraph"
 Requires-Dist: anyio>=4.0.0; extra == "langgraph"
 Provides-Extra: microsoft
@@ -59,46 +59,46 @@ Requires-Dist: azure-identity==1.25.3; extra == "foundry"
 Provides-Extra: agno
 Requires-Dist: agno<=2.9.0,>=2.8.0; extra == "agno"
 Provides-Extra: openai-agents
-Requires-Dist: openai-agents<=0.21.0,>=0.18.3; extra == "openai-agents"
+Requires-Dist: openai-agents<=0.22.0,>=0.18.3; extra == "openai-agents"
 Provides-Extra: mcp
 Requires-Dist: mcp<=1.28.1,>=1.26.0; extra == "mcp"
 Provides-Extra: bedrock
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "bedrock"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "bedrock"
 Provides-Extra: aws-bedrock
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "aws-bedrock"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "aws-bedrock"
 Provides-Extra: llamaindex
-Requires-Dist: llama-index==0.14.23; extra == "llamaindex"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "llamaindex"
 Provides-Extra: llama-index
-Requires-Dist: llama-index==0.14.23; extra == "llama-index"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "llama-index"
 Provides-Extra: google-adk
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "google-adk"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "google-adk"
 Provides-Extra: adk
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "adk"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "adk"
 Provides-Extra: claude
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "claude"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "claude"
 Provides-Extra: claude-agent-sdk
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "claude-agent-sdk"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "claude-agent-sdk"
 Provides-Extra: smolagents
 Requires-Dist: smolagents==1.26.0; extra == "smolagents"
 Provides-Extra: all
-Requires-Dist: crewai<=1.15.16,>=1.15.5; extra == "all"
+Requires-Dist: crewai<=1.15.17,>=1.15.5; extra == "all"
 Requires-Dist: redis>=4.5.0; extra == "all"
 Requires-Dist: cryptography>=42.0.0; extra == "all"
-Requires-Dist: pydantic-ai<=2.31.0,>=2.16.0; extra == "all"
+Requires-Dist: pydantic-ai<=2.32.1,>=2.16.0; extra == "all"
 Requires-Dist: anyio>=4.0.0; extra == "all"
 Requires-Dist: langgraph<=1.2.11,>=1.2.9; extra == "all"
-Requires-Dist: langchain-core<=1.5.5,>=1.5.0; extra == "all"
+Requires-Dist: langchain-core<=1.6.0,>=1.5.0; extra == "all"
 Requires-Dist: langchain-openai==1.3.5; extra == "all"
 Requires-Dist: autogen-agentchat==0.7.5; extra == "all"
 Requires-Dist: agno<=2.9.0,>=2.8.0; extra == "all"
 Requires-Dist: azure-ai-projects<=2.4.0,>=2.3.0; extra == "all"
 Requires-Dist: azure-identity==1.25.3; extra == "all"
-Requires-Dist: openai-agents<=0.21.0,>=0.18.3; extra == "all"
+Requires-Dist: openai-agents<=0.22.0,>=0.18.3; extra == "all"
 Requires-Dist: mcp<=1.28.1,>=1.26.0; extra == "all"
-Requires-Dist: boto3<=1.43.72,>=1.43.54; extra == "all"
-Requires-Dist: llama-index==0.14.23; extra == "all"
-Requires-Dist: google-adk<=2.7.0,>=2.5.0; extra == "all"
-Requires-Dist: claude-agent-sdk<=0.2.139,>=0.2.126; extra == "all"
+Requires-Dist: boto3<=1.43.75,>=1.43.54; extra == "all"
+Requires-Dist: llama-index<=0.14.24,>=0.14.23; extra == "all"
+Requires-Dist: google-adk<=2.7.1,>=2.5.0; extra == "all"
+Requires-Dist: claude-agent-sdk<=0.2.142,>=0.2.126; extra == "all"
 Requires-Dist: smolagents==1.26.0; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"

{agenticdome_python_sdk-1.2.18 → agenticdome_python_sdk-1.2.21}/agenticdome_python_sdk.egg-info/SOURCES.txt

@@ -20,9 +20,12 @@ agenticdome_sdk/autogen.py
 agenticdome_sdk/aws_bedrock.py
 agenticdome_sdk/claude.py
 agenticdome_sdk/client.py
+agenticdome_sdk/copilot_ir.py
+agenticdome_sdk/copilot_ir_collector.cjs
 agenticdome_sdk/crewai.py
 agenticdome_sdk/demo.py
 agenticdome_sdk/google_adk.py
+agenticdome_sdk/hook_catalog.py
 agenticdome_sdk/identity.py
 agenticdome_sdk/langgraph.py
 agenticdome_sdk/llamaindex.py
@@ -77,26 +80,4 @@ examples/frameworks/microsoft_agent_framework.py
 examples/frameworks/microsoft_ai_foundry.py
 examples/frameworks/openai_agents.py
 examples/frameworks/pydanticai.py
-examples/frameworks/smolagents.py
-tests/test_agno_integration.py
-tests/test_attack_demo.py
-tests/test_autogen_integration.py
-tests/test_aws_bedrock_integration.py
-tests/test_claude_integration.py
-tests/test_client.py
-tests/test_crewai_integration.py
-tests/test_execution_broker.py
-tests/test_framework_guides.py
-tests/test_google_adk_integration.py
-tests/test_identity_context.py
-tests/test_langgraph_integration.py
-tests/test_llamaindex_integration.py
-tests/test_local_simulation.py
-tests/test_mcp_host_integration.py
-tests/test_mcp_launch_example.py
-tests/test_microsoft_agent_framework_integration.py
-tests/test_microsoft_ai_foundry_integration.py
-tests/test_onboarding_cli.py
-tests/test_openai_agents_integration.py
-tests/test_pydanticai_integration.py
-tests/test_smolagents_integration.py
+examples/frameworks/smolagents.py

{agenticdome_python_sdk-1.2.18 → agenticdome_python_sdk-1.2.21}/agenticdome_python_sdk.egg-info/requires.txt

@@ -2,49 +2,49 @@ requests>=2.31.0
 urllib3>=2.0.0
 
 [adk]
-google-adk<=2.7.0,>=2.5.0
+google-adk<=2.7.1,>=2.5.0
 
 [agno]
 agno<=2.9.0,>=2.8.0
 
 [all]
-crewai<=1.15.16,>=1.15.5
+crewai<=1.15.17,>=1.15.5
 redis>=4.5.0
 cryptography>=42.0.0
-pydantic-ai<=2.31.0,>=2.16.0
+pydantic-ai<=2.32.1,>=2.16.0
 anyio>=4.0.0
 langgraph<=1.2.11,>=1.2.9
-langchain-core<=1.5.5,>=1.5.0
+langchain-core<=1.6.0,>=1.5.0
 langchain-openai==1.3.5
 autogen-agentchat==0.7.5
 agno<=2.9.0,>=2.8.0
 azure-ai-projects<=2.4.0,>=2.3.0
 azure-identity==1.25.3
-openai-agents<=0.21.0,>=0.18.3
+openai-agents<=0.22.0,>=0.18.3
 mcp<=1.28.1,>=1.26.0
-boto3<=1.43.72,>=1.43.54
-llama-index==0.14.23
-google-adk<=2.7.0,>=2.5.0
-claude-agent-sdk<=0.2.139,>=0.2.126
+boto3<=1.43.75,>=1.43.54
+llama-index<=0.14.24,>=0.14.23
+google-adk<=2.7.1,>=2.5.0
+claude-agent-sdk<=0.2.142,>=0.2.126
 smolagents==1.26.0
 
 [autogen]
 autogen-agentchat==0.7.5
 
 [aws-bedrock]
-boto3<=1.43.72,>=1.43.54
+boto3<=1.43.75,>=1.43.54
 
 [bedrock]
-boto3<=1.43.72,>=1.43.54
+boto3<=1.43.75,>=1.43.54
 
 [claude]
-claude-agent-sdk<=0.2.139,>=0.2.126
+claude-agent-sdk<=0.2.142,>=0.2.126
 
 [claude-agent-sdk]
-claude-agent-sdk<=0.2.139,>=0.2.126
+claude-agent-sdk<=0.2.142,>=0.2.126
 
 [crewai]
-crewai<=1.15.16,>=1.15.5
+crewai<=1.15.17,>=1.15.5
 
 [dev]
 pytest>=8.0.0
@@ -62,19 +62,19 @@ azure-ai-projects<=2.4.0,>=2.3.0
 azure-identity==1.25.3
 
 [google-adk]
-google-adk<=2.7.0,>=2.5.0
+google-adk<=2.7.1,>=2.5.0
 
 [langgraph]
 langgraph<=1.2.11,>=1.2.9
-langchain-core<=1.5.5,>=1.5.0
+langchain-core<=1.6.0,>=1.5.0
 langchain-openai==1.3.5
 anyio>=4.0.0
 
 [llama-index]
-llama-index==0.14.23
+llama-index<=0.14.24,>=0.14.23
 
 [llamaindex]
-llama-index==0.14.23
+llama-index<=0.14.24,>=0.14.23
 
 [mcp]
 mcp<=1.28.1,>=1.26.0
@@ -85,17 +85,17 @@ mcp<=1.28.1,>=1.26.0
 autogen-agentchat==0.7.5
 
 [openai-agents]
-openai-agents<=0.21.0,>=0.18.3
+openai-agents<=0.22.0,>=0.18.3
 
 [pop]
 cryptography>=42.0.0
 
 [pydantic]
-pydantic-ai<=2.31.0,>=2.16.0
+pydantic-ai<=2.32.1,>=2.16.0
 anyio>=4.0.0
 
 [pydanticai]
-pydantic-ai<=2.31.0,>=2.16.0
+pydantic-ai<=2.32.1,>=2.16.0
 anyio>=4.0.0
 
 [redis]

agenticdome_python_sdk-1.2.21/agenticdome_sdk/copilot_ir.py

@@ -0,0 +1,294 @@
+"""Generic, source-free AST collection for the AgenticDome Integration Copilot.
+
+This public module deliberately performs no placement ranking, guard-dominance
+reasoning, bypass scoring or compatibility decisions. Those protectable
+capabilities live in the private Copilot Core. The collector emits bounded
+structural metadata and never emits source text, literals or absolute paths.
+"""
+
+from __future__ import annotations
+
+import ast
+import json
+import re
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any, Dict, List, Sequence, Tuple
+
+
+IR_SCHEMA = "agenticdome.copilot-ir.v1"
+MAX_IR_FILES = 1_000
+
+
+def _relative(path: Path, root: Path) -> str:
+    try:
+        return path.resolve().relative_to(root.resolve()).as_posix()
+    except (OSError, ValueError):
+        return path.name
+
+
+def _dotted_name(node: ast.AST) -> str:
+    if isinstance(node, ast.Name):
+        return node.id.lower()
+    if isinstance(node, ast.Attribute):
+        left = _dotted_name(node.value)
+        return (left + "." if left else "") + node.attr.lower()
+    if isinstance(node, ast.Call):
+        return _dotted_name(node.func)
+    return ""
+
+
+def _tail(value: str) -> str:
+    return str(value or "").rsplit(".", 1)[-1].lower()
+
+
+def _literal_enum(node: ast.AST | None, allowed: set[str]) -> str:
+    if isinstance(node, ast.Constant) and isinstance(node.value, str):
+        value = node.value.strip().lower()
+        return value if value in allowed else ""
+    return ""
+
+
+def _call_hints(node: ast.Call) -> Dict[str, Any]:
+    hints: Dict[str, Any] = {}
+    has_tool_binding = False
+    for keyword in node.keywords:
+        if keyword.arg == "direction":
+            direction = _literal_enum(keyword.value, {"input", "inbound", "output", "outbound"})
+            if direction:
+                hints["direction"] = direction
+        elif keyword.arg in {"tool_name", "tool_args"}:
+            has_tool_binding = True
+        elif keyword.arg == "policy_context" and isinstance(keyword.value, ast.Dict):
+            for key, value in zip(keyword.value.keys, keyword.value.values):
+                if _literal_enum(key, {"request_purpose"}) != "request_purpose":
+                    continue
+                purpose = _literal_enum(
+                    value,
+                    {"prompt_input", "tool_execution", "output_review", "sdk_onboarding_verification"},
+                )
+                if purpose:
+                    hints["request_purpose"] = purpose
+    if has_tool_binding:
+        hints["has_tool_binding"] = True
+    return hints
+
+
+class _PythonIRVisitor(ast.NodeVisitor):
+    def __init__(self, path: str) -> None:
+        self.path = path
+        self.stack: List[str] = ["<module>"]
+        self.flow_stack: List[str] = []
+        self.functions: Dict[str, Dict[str, Any]] = {
+            "<module>": {
+                "symbol": "<module>",
+                "path": path,
+                "line": 1,
+                "hints": {"entrypoint": True, "parameters": [], "decorators": []},
+                "events": [],
+            }
+        }
+        self.features = {"functions": 0, "calls": 0, "returns": 0}
+
+    @property
+    def current(self) -> Dict[str, Any]:
+        return self.functions[self.stack[-1]]
+
+    def _visit_function(self, node: ast.AST) -> None:
+        name = str(getattr(node, "name", "anonymous"))
+        parent = self.stack[-1]
+        symbol = name if parent == "<module>" else parent + "." + name
+        decorators = [_dotted_name(item) for item in getattr(node, "decorator_list", [])]
+        parameters = [arg.arg.lower() for arg in getattr(getattr(node, "args", None), "args", [])]
+        self.functions[symbol] = {
+            "symbol": symbol,
+            "path": self.path,
+            "line": int(getattr(node, "lineno", 1)),
+            "hints": {"parameters": parameters[:100], "decorators": decorators[:50]},
+            "events": [],
+        }
+        self.features["functions"] += 1
+        self.stack.append(symbol)
+        for statement in getattr(node, "body", []):
+            self.visit(statement)
+        self.stack.pop()
+
+    def visit_FunctionDef(self, node: ast.FunctionDef) -> None:  # noqa: N802
+        self._visit_function(node)
+
+    def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> None:  # noqa: N802
+        self._visit_function(node)
+
+    def visit_Call(self, node: ast.Call) -> None:  # noqa: N802
+        self.features["calls"] += 1
+        self.current["events"].append({
+            "event": "call",
+            "callee": _dotted_name(node.func),
+            "line": int(getattr(node, "lineno", self.current["line"])),
+            "flow_scope": list(self.flow_stack),
+            "hints": _call_hints(node),
+        })
+        self.generic_visit(node)
+
+    def visit_Return(self, node: ast.Return) -> None:  # noqa: N802
+        self.features["returns"] += 1
+        if node.value is not None:
+            self.visit(node.value)
+        self.current["events"].append({
+            "event": "return",
+            "callee": "return",
+            "line": int(getattr(node, "lineno", self.current["line"])),
+            "flow_scope": list(self.flow_stack),
+        })
+
+    def visit_Assign(self, node: ast.Assign) -> None:  # noqa: N802
+        role = "user_input" if any(_tail(_dotted_name(target)) in {"user_input", "user_query", "user_message"} for target in node.targets) else ""
+        if role:
+            self.current["events"].append({
+                "event": "assignment",
+                "assignment_role": role,
+                "callee": "assignment",
+                "line": int(getattr(node, "lineno", self.current["line"])),
+                "flow_scope": list(self.flow_stack),
+            })
+        self.generic_visit(node)
+
+    def _visit_branch(self, node: ast.AST, arms: Sequence[Tuple[str, Sequence[ast.stmt]]]) -> None:
+        test = getattr(node, "test", None)
+        if isinstance(test, ast.AST):
+            self.visit(test)
+        marker = node.__class__.__name__.lower() + "@" + str(getattr(node, "lineno", 1))
+        for arm, statements in arms:
+            self.flow_stack.append(marker + ":" + arm)
+            for statement in statements:
+                self.visit(statement)
+            self.flow_stack.pop()
+
+    def visit_If(self, node: ast.If) -> None:  # noqa: N802
+        self._visit_branch(node, (("body", node.body), ("else", node.orelse)))
+
+    def visit_For(self, node: ast.For) -> None:  # noqa: N802
+        self.visit(node.iter)
+        self._visit_branch(node, (("body", node.body), ("else", node.orelse)))
+
+    def visit_AsyncFor(self, node: ast.AsyncFor) -> None:  # noqa: N802
+        self.visit_For(node)
+
+    def visit_While(self, node: ast.While) -> None:  # noqa: N802
+        self._visit_branch(node, (("body", node.body), ("else", node.orelse)))
+
+    def visit_Try(self, node: ast.Try) -> None:  # noqa: N802
+        arms: List[Tuple[str, Sequence[ast.stmt]]] = [("body", node.body)]
+        arms.extend(("except" + str(index), handler.body) for index, handler in enumerate(node.handlers))
+        arms.extend((("else", node.orelse), ("finally", node.finalbody)))
+        self._visit_branch(node, arms)
+
+
+def _collect_python(root: Path, paths: Sequence[Path]) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+    functions: List[Dict[str, Any]] = []
+    parsed = 0
+    parse_errors = 0
+    features = {"functions": 0, "calls": 0, "returns": 0}
+    for path in paths[:MAX_IR_FILES]:
+        try:
+            tree = ast.parse(path.read_text(encoding="utf-8", errors="ignore"), filename=path.name)
+        except (OSError, SyntaxError, ValueError):
+            parse_errors += 1
+            continue
+        visitor = _PythonIRVisitor(_relative(path, root))
+        visitor.visit(tree)
+        parsed += 1
+        functions.extend(visitor.functions.values())
+        for key, value in visitor.features.items():
+            features[key] += value
+    return functions, {
+        "engine": "python-ast",
+        "available": True,
+        "files_parsed": parsed,
+        "parse_errors": parse_errors,
+        "features": features,
+        "claim": "Generic AST structure collection; private reasoning is performed by the assigned Copilot service",
+    }
+
+
+def _collect_typescript(root: Path, paths: Sequence[Path]) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+    if not paths:
+        return [], {"engine": "typescript-compiler-api", "available": False, "files_parsed": 0, "reason": "No TypeScript or JavaScript source was found."}
+    node = shutil.which("node")
+    helper = Path(__file__).with_name("copilot_ir_collector.cjs")
+    if not node or not helper.exists():
+        return _typescript_fallback(root, paths, "Node.js or the packaged IR collector is unavailable.")
+    try:
+        completed = subprocess.run(
+            [node, str(helper)],
+            input=json.dumps({"root": str(root), "files": [str(path) for path in paths[:MAX_IR_FILES]]}),
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.DEVNULL,
+            check=False,
+            timeout=20,
+            cwd=root,
+        )
+        result = json.loads(completed.stdout or "{}") if completed.returncode == 0 else {}
+    except (OSError, subprocess.TimeoutExpired, json.JSONDecodeError):
+        result = {}
+    if not isinstance(result, dict) or not result.get("available"):
+        return _typescript_fallback(root, paths, str(result.get("reason", "The TypeScript compiler is unavailable."))[:160] if isinstance(result, dict) else "The TypeScript compiler is unavailable.")
+    functions = result.get("functions") if isinstance(result.get("functions"), list) else []
+    return [item for item in functions if isinstance(item, dict)], {
+        "engine": "typescript-compiler-api",
+        "available": True,
+        "files_parsed": max(0, int(result.get("files_parsed", 0))),
+        "parse_errors": max(0, int(result.get("parse_errors", 0))),
+        "typescript_version": str(result.get("typescript_version", ""))[:40],
+        "claim": "Generic compiler AST structure collection; private reasoning is performed by the assigned Copilot service",
+    }
+
+
+def _typescript_fallback(root: Path, paths: Sequence[Path], reason: str) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+    functions: List[Dict[str, Any]] = []
+    parsed = 0
+    call_pattern = re.compile(r"\b([A-Za-z_$][\w$]*(?:\s*\.\s*[A-Za-z_$][\w$]*)*)\s*\(")
+    for path in paths[:MAX_IR_FILES]:
+        try:
+            lines = path.read_text(encoding="utf-8", errors="ignore").splitlines()
+        except OSError:
+            continue
+        events = []
+        for line_number, line in enumerate(lines, start=1):
+            for match in call_pattern.finditer(line):
+                events.append({"event": "call", "callee": re.sub(r"\s+", "", match.group(1)).lower(), "line": line_number, "flow_scope": []})
+            if re.search(r"\breturn\b", line):
+                events.append({"event": "return", "callee": "return", "line": line_number, "flow_scope": []})
+        functions.append({"symbol": "<module>", "path": _relative(path, root), "line": 1, "hints": {"entrypoint": True, "parameters": [], "decorators": []}, "events": events[:500]})
+        parsed += 1
+    return functions, {
+        "engine": "typescript-structural-fallback",
+        "available": False,
+        "files_parsed": parsed,
+        "parse_errors": 0,
+        "reason": reason,
+        "claim": "Generic structural collection only; install TypeScript for compiler AST evidence",
+    }
+
+
+def collect_repository_ir(root: Path, paths: Sequence[Path]) -> Dict[str, Any]:
+    """Collect bounded metadata for private reasoning without emitting source."""
+    python_paths = [path for path in paths if path.suffix.lower() in {".py", ".pyi"}]
+    typescript_paths = [path for path in paths if path.suffix.lower() in {".js", ".jsx", ".ts", ".tsx"}]
+    python_functions, python_engine = _collect_python(root, python_paths)
+    typescript_functions, typescript_engine = _collect_typescript(root, typescript_paths)
+    return {
+        "schema": IR_SCHEMA,
+        "source_upload": False,
+        "collector_mode": "generic_ast_metadata_only",
+        "engines": {"python": python_engine, "typescript": typescript_engine},
+        "functions": (python_functions + typescript_functions)[:20_000],
+        "privacy": {
+            "source_text": False,
+            "string_literals": False,
+            "absolute_paths": False,
+            "environment_values": False,
+        },
+    }