3tears-agent-workspace 0.17.9

workspace primitives for 3tears agents: workspace entities, sandbox, format handlers, tools

3tears-agent-workspace

Workspace primitives for 3tears agents: workspace entities, sandbox, format handlers, and tools.

This package provides WorkspaceConfig and related Pydantic models consumed by the platform SDK to declare per-agent workspace configuration (templates, bind root, read/write allow-lists, validator hooks).

Audit emission

Workspace tools publish unified threetears.agent.audit.AuditEvent envelopes via threetears.agent.audit.publish_audit on the dotted subject {ns}.audit.workspace.{event_type_verb} (e.g. workspace.fs_write, workspace.materialize, workspace.rollback). This package does NOT define its own audit envelope type and does NOT run its own consumer. A platform-side unified audit consumer subscribes to the whole {ns}.audit.> subtree and owns persistence. Every dispatch also produces a baseline event_type='tool.call' row stamped by ToolServer (see 3tears-agent-tools); the workspace-specific event is additive under the same correlation_id.