PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

1.0.1

PyPI

afs-core

agentic-fs core contracts, DTOs, key scheme, and conformance kits. Depends on pydantic only.

agentic-fsagentsconformancecontractsfilesystemmcp
Published15 Jun 2026
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 1.0.1 documentation

afs-core

The contracts package for agentic-fs: typing.Protocol interfaces, pydantic DTOs, the single key scheme, the closed error vocabulary, versioned event contracts, and the conformance test kits. Depends on pydantic only — it imports without the server, so connectors and adopters can build against it without pulling in afs-server.

Status

Foundations slice (M0, in progress):

  • afs_core.keys — the single definition of the S3 key scheme: build, parse, validate, and is_indexable(). Nothing else concatenates a key.
  • afs_core.errors — the closed ErrorCode vocabulary + the AfsError hierarchy (RFC 9457 problem+json shape).
  • afs_core.models — core DTOs (Page[T], CatalogEntry, ExtractionState, …) and control records (TenantRecord, NamespaceRecord, PrincipalRecord).

Coming next: afs_core.contracts (the async Protocols), afs_core.testing (conformance kits + in-memory fakes), afs_core.events.

Develop

uv sync
uv run pytest packages/afs-core

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 3

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.12",
  "evaluation": "NOT_EVALUATED"
}
pydantic>=2.7runtime
pytest-asyncio
Environment
{
  "extras": "",
  "marker": "extra == \"testing\"",
  "requires_python": ">=3.12",
  "evaluation": "NOT_EVALUATED"
}
pytest-asyncio>=0.24; extra == "testing"runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"testing\"",
  "requires_python": ">=3.12",
  "evaluation": "NOT_EVALUATED"
}
pytest>=8; extra == "testing"runtime

Distribution files

2 collected
afs_core-1.0.1-py3-none-any.whl

bdist_wheel · 22.73 KB · Python py3

Source file
afs_core-1.0.1.tar.gz

sdist · 18.42 KB · Python source

Source file

Repository

PENDING
vivekkhimani/agentic-fs

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:13 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:eaff484eba911594cb58795ff7d563dbbd7bd72d19129ae2217bf5a0459176b3

Other collected versions

View all collected versions →