Module agent_context 

Unified Agent Execution Context (Task 16)

Stateful session management for agentic use cases:

• Session variables and working directory
• Transaction scope (ACID across all operations)
• Permissions and sandboxing
• Audit logging for reproducibility

Example

Agent session abc123:
  cwd: /agents/abc123
  vars: $model = "gpt-4", $budget = 1000
  permissions: fs:rw, db:rw, calc:*
  audit: [read /data/users, write /agents/abc123/cache]

Structs

AgentContext

Agent session context

AgentPermissions

Agent permissions

AuditEntry

Audit trail entry

DbPermissions

Database permissions

FsPermissions

Filesystem permissions

NetworkPermissions

Network permissions (for future use)

OperationBudget

Operation budget tracking

PendingWrite

Pending write for transaction rollback

SessionManager

Session manager for multiple agent contexts

ToolCallRecord

Record of a tool call made during the session

ToolDefinition

Definition of a tool available to the agent

TransactionScope

Transaction scope

Enums

AuditOperation

Audit operation types

AuditResult

Audit result

ContextError

Context error

ContextValue

Context variable value

ResourceType

Resource type

Type Aliases

SessionId

Session identifier (UUID v7 for time-ordering)