Agent Permissions & Audit

Tool scopes, policy and call history

PO

Allowed tool calls

6

Within the approved scope

Blocked by policy

1

Not errors — denials

Held for approval

1

Restricted actions

6

Never available to an agent

Agent access matrix

Least privilege · deny by default · scoped per environment

AgentMax tierApproved toolsEscalationStatus

Product Analyst

Requirements and feature specifications

read3repo.read, docs.read, issues.writeProduct leadidle

Architecture Agent

System design and module boundaries

read3repo.read, docs.write, diagram.renderPlatform architectidle

Frontend Agent

React and TypeScript development

development4repo.read, repo.branch, tests.run, pr.openFrontend leadactive

Backend Agent

Nitro API routes and business logic

development5repo.read, repo.branch, tests.run, pr.open, staging.deployBackend leadactive

Database Agent

PostgreSQL schema, migrations and query performance

development4repo.read, schema.lint, explain.plan, migration.draftDatabase administratorapproval required

QA Agent

Automated testing and regression checks

testing3tests.run, coverage.read, issues.writeQA leadactive

Security Agent

Vulnerability checks and access-control reviews

testing3deps.scan, policy.read, secrets.auditSecurity auditoractive

DevOps Agent

CI/CD, staging, releases and rollback preparation

operations4ci.read, ci.trigger, staging.deploy, release.prepareRelease managerfailed

Reliability Agent

Monitoring, incidents and recovery recommendations

operations4metrics.read, logs.read, incidents.write, node.inspectInfrastructure engineeractive

Support Agent

Customer tickets, feedback and knowledge base

read3tickets.read, tickets.draft, kb.readSupport leadactive

Licensing Agent

Subscription status, renewal workflows and billing triage

read3licence.read, payments.read, tickets.draftBilling administratorpaused

Documentation Agent

Technical documentation and release notes

development3repo.read, docs.write, pr.openDocumentation owneridle

Tool call audit

Agent, task, tool, target, outcome and duration — append-only

CallAgentToolTargetOutcomeDurationWhen
CALL-90412Database Agentexplain.planplatform.licencesallowed640ms27 Oct, 09:47 am
CALL-90411DevOps Agentstaging.deployadmin@1.9.0-rc2allowed184.0s27 Oct, 09:31 am
CALL-90410DevOps Agentrelease.productionadmin@1.9.0approval required40ms27 Oct, 09:20 am
CALL-90409Support Agentrecords.readapp.voter_recordsblocked18ms27 Oct, 09:12 am
CALL-90408Reliability Agentnode.inspectworker-01allowed210ms27 Oct, 08:58 am
CALL-90407QA Agenttests.runsuite:webhook-idempotencyallowed96.0s27 Oct, 08:44 am
CALL-90406Frontend Agentrepo.branchfeat/org-licence-filtersallowed1.2s27 Oct, 08:30 am
CALL-90405Licensing Agentpayments.readplatform.payment_transactionsallowed88ms26 Oct, 05:28 pm

Tool calls, workflow runs and audit records are append-only. Agent actions are recorded in agent_tool_calls and agent_audit_logs; permission changes also land in admin_audit_logs.

Restricted actions

Authorization + approval, never a default

  • Production releases and rollbacks
  • Licence blocking, suspension and manual activation
  • Payment gateway configuration and refunds
  • Secrets, keys and credential rotation
  • Destructive database operations and restores
  • Role, permission and account-wide security changes

Enforcement

Where policy actually lives

  • Tools check a policy table before every call — not a prompt instruction.
  • Agents hold no database credential for app-schema business data.
  • Cross-organization reads are impossible: no agent tool exposes tenant records.
  • Emergency stop pauses all agents and drains running tasks immediately.