@tool functions with @dmint.protected:import json from datetime import datetime, timezone, timedelta from langchain_core.tools import tool from dmint import Dmint, Policy, SQLiteApprovalStore, PolicyProvenance, policy_digest from dmint.models import TrustedContext from dmint.errors import ApprovalRequiredError, AuthorizationError # Initialize Dmint store = SQLiteApprovalStore("./approvals.sqlite3", deployment_epoch="prod-v1") with open("policy.json", "r", encoding="utf-8") as f: policy = Policy.from_mapping(json.load(f)) provenance = PolicyProvenance("prod-v1", policy_digest(policy), datetime.now(timezone.utc)) dmint = Dmint( policy=policy, approval_store=store, context=TrustedContext({}), agent_id="langchain-agent", approval_ttl=timedelta(minutes=15), policy_provenance=provenance, ) @tool @dmint.protected("system.execute_sql") def execute_sql(query: str) -> str: """Execute a raw SQL query against the database.""" # This code only runs if Dmint evaluates ALLOW return f"Executed SQL: {query}"
try: result = execute_sql.invoke({"query": "UPDATE accounts SET balance = 0 WHERE id = 1"}) except ApprovalRequiredError as exc: # Tool paused fail-closed. # The request is now visible in dmint dashboard. print(f"Action intercepted: {exc} (approval_id={exc.approval_id})") except AuthorizationError as exc: print(f"Action forbidden: {exc}")
BaseTool and protect the _run method:import json from datetime import datetime, timezone, timedelta from crewai.tools import BaseTool from dmint import Dmint, Policy, SQLiteApprovalStore, PolicyProvenance, policy_digest from dmint.errors import ApprovalRequiredError, AuthorizationError from dmint.models import TrustedContext store = SQLiteApprovalStore("./approvals.sqlite3", deployment_epoch="prod-v1") with open("policy.json", "r", encoding="utf-8") as f: policy = Policy.from_mapping(json.load(f)) provenance = PolicyProvenance("prod-v1", policy_digest(policy), datetime.now(timezone.utc)) dmint = Dmint( policy=policy, approval_store=store, context=TrustedContext({}), agent_id="crewai-ops-agent", approval_ttl=timedelta(minutes=15), policy_provenance=provenance, ) @dmint.protected("filesystem.delete") def execute_file_delete(file_path: str) -> str: return f"Successfully deleted {file_path}" class ProtectedFileDeleteTool(BaseTool): name: str = "delete_file" description: str = "Deletes a file from the server." def _run(self, file_path: str) -> str: try: return execute_file_delete(file_path) except ApprovalRequiredError as exc: return f"APPROVAL_REQUIRED: Action paused. Approval ID is {exc.approval_id}." except AuthorizationError as exc: return f"DENIED: Action forbidden by policy: {exc}"
import time from dmint import ApprovalStore, ApprovalRecord, ApprovalState def wait_for_human_approval(store: ApprovalStore, approval_id: str, timeout_sec: int = 300) -> ApprovalRecord: start = time.time() while time.time() - start < timeout_sec: record = store.get(approval_id) if record and record.state == ApprovalState.APPROVED: return record elif record and record.state == ApprovalState.REJECTED: raise PermissionError("Human operator rejected the action.") time.sleep(2) raise TimeoutError("Approval request timed out.")
dmint.retry:# Agent receives approval assertion and retries tool call: result = dmint.retry( execute_file_delete, "/var/data/old_report.csv", approval_credential=assertion, )
consumed_record = store.consume_approved( approval_id=record.approval_id, credential=assertion, expected_request=tool_request, verifier=approval_verifier, )
approval_records:record_checksum across all schema columns.UPDATE approval_records SET state = 'CONSUMED') breaks the integrity checksum, causing subsequent operations to fail with CorruptApprovalRecordError: stored approval integrity check failed. Always transition state programmatically through dmint.retry(...) or store.consume_approved(...).