Skip to main content

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

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

afs_core-1.0.0.tar.gz (18.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

afs_core-1.0.0-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

Details for the file afs_core-1.0.0.tar.gz.

File metadata

  • Download URL: afs_core-1.0.0.tar.gz
  • Upload date:
  • Size: 18.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for afs_core-1.0.0.tar.gz
Algorithm Hash digest
SHA256 2dc4040d5b6e307516e3a2ba01cb8c8e5299f0114a708e748aac533fe7e32013
MD5 9b9025462ce7e9cdf215b86ad17d86e4
BLAKE2b-256 a3ac7780e14fa65969095bd3a730e15dcc36374af5fc7e9aec2389c9bc47debe

See more details on using hashes here.

File details

Details for the file afs_core-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: afs_core-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 23.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for afs_core-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 12c2f6a21cad932f30b967e0938a7cb485c58775e43e715a3b7ad28450ba8b9f
MD5 a0eaa0c84e08aac649b6122d76703750
BLAKE2b-256 39165b3d4c3bb398b92c86fec41508b6dbeda67b6439e41f2ae61fac126f77e9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page