Metadata-Version: 2.4
Name: 3tears-agent-workspace
Version: 0.14.0
Summary: workspace primitives for 3tears agents: workspace entities, sandbox, format handlers, tools
Project-URL: Repository, https://github.com/pacepace/3tears
Author: pace
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.14
Requires-Dist: 3tears
Requires-Dist: 3tears-agent-acl
Requires-Dist: 3tears-agent-audit
Requires-Dist: 3tears-agent-tools
Requires-Dist: 3tears-nats
Requires-Dist: 3tears-observe
Requires-Dist: jsonpath-ng>=1.6
Requires-Dist: pydantic>=2.0
Requires-Dist: ruamel-yaml>=0.18
Requires-Dist: watchfiles>=1.1.1
Description-Content-Type: text/markdown

# 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`.
