axonflow 0.11.0__tar.gz → 1.4.0__tar.gz

{axonflow-0.11.0 → axonflow-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axonflow
-Version: 0.11.0
+Version: 1.4.0
 Summary: AxonFlow Python SDK - Enterprise AI Governance in 3 Lines of Code
 Author-email: AxonFlow <dev@getaxonflow.com>
 Maintainer-email: AxonFlow <dev@getaxonflow.com>
@@ -89,7 +89,7 @@ from axonflow import AxonFlow
 
 async def main():
     async with AxonFlow(
-        agent_url="https://your-agent.axonflow.com",
+        endpoint="https://your-agent.axonflow.com",
         client_id="your-client-id",
         client_secret="your-client-secret"
     ) as client:
@@ -110,7 +110,7 @@ asyncio.run(main())
 from axonflow import AxonFlow
 
 with AxonFlow.sync(
-    agent_url="https://your-agent.axonflow.com",
+    endpoint="https://your-agent.axonflow.com",
     client_id="your-client-id",
     client_secret="your-client-secret"
 ) as client:
@@ -202,6 +202,38 @@ result = await client.query_connector(
 )
 ```
 
+### MCP Policy Features (v3.2.0)
+
+**Exfiltration Detection** - Prevent large-scale data extraction:
+
+```python
+# Query with exfiltration limits (default: 10K rows, 10MB)
+result = await client.query_connector(
+    user_token="user-jwt",
+    connector_name="postgres",
+    operation="query",
+    params={"sql": "SELECT * FROM customers"}
+)
+
+# Check exfiltration info
+if result.policy_info.exfiltration_check.exceeded:
+    print(f"Limit exceeded: {result.policy_info.exfiltration_check.limit_type}")
+
+# Configure: MCP_MAX_ROWS_PER_QUERY=1000, MCP_MAX_BYTES_PER_QUERY=5242880
+```
+
+**Dynamic Policy Evaluation** - Orchestrator-based rate limiting, budget controls:
+
+```python
+# Response includes dynamic policy info when enabled
+if result.policy_info.dynamic_policy_info.orchestrator_reachable:
+    print(f"Policies evaluated: {result.policy_info.dynamic_policy_info.policies_evaluated}")
+    for policy in result.policy_info.dynamic_policy_info.matched_policies:
+        print(f"  {policy.policy_name}: {policy.action}")
+
+# Enable: MCP_DYNAMIC_POLICIES_ENABLED=true
+```
+
 ### Multi-Agent Planning
 
 Generate and execute multi-agent plans:
@@ -226,10 +258,9 @@ print(f"Result: {result.result}")
 from axonflow import AxonFlow, Mode, RetryConfig
 
 client = AxonFlow(
-    agent_url="https://your-agent.axonflow.com",
-    client_id="your-client-id",
-    client_secret="your-client-secret",
-    license_key="optional-license-key",      # For enterprise features
+    endpoint="https://your-agent.axonflow.com",
+    client_id="your-client-id",               # Required for enterprise features
+    client_secret="your-client-secret",       # Required for enterprise features
     mode=Mode.PRODUCTION,                     # or Mode.SANDBOX
     debug=True,                               # Enable debug logging
     timeout=60.0,                             # Request timeout in seconds
@@ -305,12 +336,102 @@ ruff format .
 mypy axonflow
 ```
 
+## Examples
+
+Complete working examples for all features are available in the [examples folder](https://github.com/getaxonflow/axonflow/tree/main/examples).
+
+### Community Features
+
+```python
+# PII Detection - Automatically detect sensitive data
+result = await client.get_policy_approved_context(
+    user_token="user-123",
+    query="My SSN is 123-45-6789"
+)
+# result.approved = True, result.requires_redaction = True (SSN detected)
+
+# SQL Injection Detection - Block malicious queries
+result = await client.get_policy_approved_context(
+    user_token="user-123",
+    query="SELECT * FROM users; DROP TABLE users;"
+)
+# result.approved = False, result.block_reason = "SQL injection detected"
+
+# Static Policies - List and manage built-in policies
+policies = await client.list_policies()
+# Returns: [Policy(name="pii-detection", enabled=True), ...]
+
+# Dynamic Policies - Create runtime policies
+await client.create_dynamic_policy(
+    name="block-competitor-queries",
+    conditions={"contains": ["competitor", "pricing"]},
+    action="block"
+)
+
+# MCP Connectors - Query external data sources
+resp = await client.query_connector(
+    user_token="user-123",
+    connector_name="postgres-db",
+    operation="query",
+    params={"sql": "SELECT name FROM customers"}
+)
+
+# Multi-Agent Planning - Orchestrate complex workflows
+plan = await client.generate_plan(
+    query="Research AI governance regulations",
+    domain="legal"
+)
+result = await client.execute_plan(plan.plan_id)
+
+# Audit Logging - Track all LLM interactions
+await client.audit_llm_call(
+    context_id=ctx.context_id,
+    response_summary="AI response summary",
+    provider="openai",
+    model="gpt-4",
+    token_usage=TokenUsage(prompt_tokens=100, completion_tokens=200, total_tokens=300),
+    latency_ms=450
+)
+```
+
+### Enterprise Features
+
+These features require an AxonFlow Enterprise license:
+
+```python
+# Code Governance - Automated PR reviews with AI
+pr_result = await client.review_pull_request(
+    repo_owner="your-org",
+    repo_name="your-repo",
+    pr_number=123,
+    check_types=["security", "style", "performance"]
+)
+
+# Cost Controls - Budget management for LLM usage
+budget = await client.get_budget("team-engineering")
+# Returns: Budget(limit=1000.00, used=234.56, remaining=765.44)
+
+# MCP Policy Enforcement - Automatic PII redaction in connector responses
+resp = await client.query_connector("user", "postgres", "SELECT * FROM customers", {})
+# resp.policy_info.redacted = True
+# resp.policy_info.redacted_fields = ["ssn", "credit_card"]
+```
+
+For enterprise features, contact [sales@getaxonflow.com](mailto:sales@getaxonflow.com).
+
 ## Documentation
 
 - [Getting Started](https://docs.getaxonflow.com/sdk/python-getting-started)
 - [Gateway Mode Guide](https://docs.getaxonflow.com/sdk/gateway-mode)
-- [Examples](https://github.com/getaxonflow/axonflow/tree/main/examples)
+
+## Support
+
+- **Documentation**: https://docs.getaxonflow.com
+- **Issues**: https://github.com/getaxonflow/axonflow-sdk-python/issues
+- **Email**: dev@getaxonflow.com
 
 ## License
 
 MIT - See [LICENSE](LICENSE) for details.
+
+<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=fbda6e64-1812-428b-b135-ed2b548ce50d" />

{axonflow-0.11.0 → axonflow-1.4.0}/README.md

@@ -30,7 +30,7 @@ from axonflow import AxonFlow
 
 async def main():
     async with AxonFlow(
-        agent_url="https://your-agent.axonflow.com",
+        endpoint="https://your-agent.axonflow.com",
         client_id="your-client-id",
         client_secret="your-client-secret"
     ) as client:
@@ -51,7 +51,7 @@ asyncio.run(main())
 from axonflow import AxonFlow
 
 with AxonFlow.sync(
-    agent_url="https://your-agent.axonflow.com",
+    endpoint="https://your-agent.axonflow.com",
     client_id="your-client-id",
     client_secret="your-client-secret"
 ) as client:
@@ -143,6 +143,38 @@ result = await client.query_connector(
 )
 ```
 
+### MCP Policy Features (v3.2.0)
+
+**Exfiltration Detection** - Prevent large-scale data extraction:
+
+```python
+# Query with exfiltration limits (default: 10K rows, 10MB)
+result = await client.query_connector(
+    user_token="user-jwt",
+    connector_name="postgres",
+    operation="query",
+    params={"sql": "SELECT * FROM customers"}
+)
+
+# Check exfiltration info
+if result.policy_info.exfiltration_check.exceeded:
+    print(f"Limit exceeded: {result.policy_info.exfiltration_check.limit_type}")
+
+# Configure: MCP_MAX_ROWS_PER_QUERY=1000, MCP_MAX_BYTES_PER_QUERY=5242880
+```
+
+**Dynamic Policy Evaluation** - Orchestrator-based rate limiting, budget controls:
+
+```python
+# Response includes dynamic policy info when enabled
+if result.policy_info.dynamic_policy_info.orchestrator_reachable:
+    print(f"Policies evaluated: {result.policy_info.dynamic_policy_info.policies_evaluated}")
+    for policy in result.policy_info.dynamic_policy_info.matched_policies:
+        print(f"  {policy.policy_name}: {policy.action}")
+
+# Enable: MCP_DYNAMIC_POLICIES_ENABLED=true
+```
+
 ### Multi-Agent Planning
 
 Generate and execute multi-agent plans:
@@ -167,10 +199,9 @@ print(f"Result: {result.result}")
 from axonflow import AxonFlow, Mode, RetryConfig
 
 client = AxonFlow(
-    agent_url="https://your-agent.axonflow.com",
-    client_id="your-client-id",
-    client_secret="your-client-secret",
-    license_key="optional-license-key",      # For enterprise features
+    endpoint="https://your-agent.axonflow.com",
+    client_id="your-client-id",               # Required for enterprise features
+    client_secret="your-client-secret",       # Required for enterprise features
     mode=Mode.PRODUCTION,                     # or Mode.SANDBOX
     debug=True,                               # Enable debug logging
     timeout=60.0,                             # Request timeout in seconds
@@ -246,12 +277,102 @@ ruff format .
 mypy axonflow
 ```
 
+## Examples
+
+Complete working examples for all features are available in the [examples folder](https://github.com/getaxonflow/axonflow/tree/main/examples).
+
+### Community Features
+
+```python
+# PII Detection - Automatically detect sensitive data
+result = await client.get_policy_approved_context(
+    user_token="user-123",
+    query="My SSN is 123-45-6789"
+)
+# result.approved = True, result.requires_redaction = True (SSN detected)
+
+# SQL Injection Detection - Block malicious queries
+result = await client.get_policy_approved_context(
+    user_token="user-123",
+    query="SELECT * FROM users; DROP TABLE users;"
+)
+# result.approved = False, result.block_reason = "SQL injection detected"
+
+# Static Policies - List and manage built-in policies
+policies = await client.list_policies()
+# Returns: [Policy(name="pii-detection", enabled=True), ...]
+
+# Dynamic Policies - Create runtime policies
+await client.create_dynamic_policy(
+    name="block-competitor-queries",
+    conditions={"contains": ["competitor", "pricing"]},
+    action="block"
+)
+
+# MCP Connectors - Query external data sources
+resp = await client.query_connector(
+    user_token="user-123",
+    connector_name="postgres-db",
+    operation="query",
+    params={"sql": "SELECT name FROM customers"}
+)
+
+# Multi-Agent Planning - Orchestrate complex workflows
+plan = await client.generate_plan(
+    query="Research AI governance regulations",
+    domain="legal"
+)
+result = await client.execute_plan(plan.plan_id)
+
+# Audit Logging - Track all LLM interactions
+await client.audit_llm_call(
+    context_id=ctx.context_id,
+    response_summary="AI response summary",
+    provider="openai",
+    model="gpt-4",
+    token_usage=TokenUsage(prompt_tokens=100, completion_tokens=200, total_tokens=300),
+    latency_ms=450
+)
+```
+
+### Enterprise Features
+
+These features require an AxonFlow Enterprise license:
+
+```python
+# Code Governance - Automated PR reviews with AI
+pr_result = await client.review_pull_request(
+    repo_owner="your-org",
+    repo_name="your-repo",
+    pr_number=123,
+    check_types=["security", "style", "performance"]
+)
+
+# Cost Controls - Budget management for LLM usage
+budget = await client.get_budget("team-engineering")
+# Returns: Budget(limit=1000.00, used=234.56, remaining=765.44)
+
+# MCP Policy Enforcement - Automatic PII redaction in connector responses
+resp = await client.query_connector("user", "postgres", "SELECT * FROM customers", {})
+# resp.policy_info.redacted = True
+# resp.policy_info.redacted_fields = ["ssn", "credit_card"]
+```
+
+For enterprise features, contact [sales@getaxonflow.com](mailto:sales@getaxonflow.com).
+
 ## Documentation
 
 - [Getting Started](https://docs.getaxonflow.com/sdk/python-getting-started)
 - [Gateway Mode Guide](https://docs.getaxonflow.com/sdk/gateway-mode)
-- [Examples](https://github.com/getaxonflow/axonflow/tree/main/examples)
+
+## Support
+
+- **Documentation**: https://docs.getaxonflow.com
+- **Issues**: https://github.com/getaxonflow/axonflow-sdk-python/issues
+- **Email**: dev@getaxonflow.com
 
 ## License
 
 MIT - See [LICENSE](LICENSE) for details.
+
+<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=fbda6e64-1812-428b-b135-ed2b548ce50d" />

{axonflow-0.11.0 → axonflow-1.4.0}/axonflow/__init__.py

@@ -9,7 +9,7 @@ Example:
     >>>
     >>> # Async usage
     >>> async with AxonFlow(
-    ...     agent_url="https://your-agent.axonflow.com",
+    ...     endpoint="https://your-agent.axonflow.com",
     ...     client_id="your-client-id",
     ...     client_secret="your-client-secret"
     ... ) as client:
@@ -18,7 +18,7 @@ Example:
     >>>
     >>> # Sync usage
     >>> client = AxonFlow.sync(
-    ...     agent_url="https://your-agent.axonflow.com",
+    ...     endpoint="https://your-agent.axonflow.com",
     ...     client_id="your-client-id",
     ...     client_secret="your-client-secret"
     ... )
@@ -61,8 +61,8 @@ from axonflow.policies import (
     CreatePolicyOverrideRequest,
     CreateStaticPolicyRequest,
     DynamicPolicy,
+    DynamicPolicyAction,
     DynamicPolicyCondition,
-    DynamicPolicyConfig,
     EffectivePoliciesOptions,
     ListDynamicPoliciesOptions,
     ListStaticPoliciesOptions,
@@ -128,7 +128,7 @@ from axonflow.types import (
     UsageSummary,
 )
 
-__version__ = "0.6.0"
+__version__ = "1.2.0"
 __all__ = [
     # Main client
     "AxonFlow",
@@ -173,7 +173,7 @@ __all__ = [
     "DynamicPolicy",
     "PolicyOverride",
     "PolicyVersion",
-    "DynamicPolicyConfig",
+    "DynamicPolicyAction",
     "DynamicPolicyCondition",
     "TestPatternResult",
     "TestPatternMatch",