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.1.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.1-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: afs_core-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 4d5bf5d2cc39b0ddedff78eeee78f4729e539492d6c749c373155eaf99505003
MD5 b00885df5fcf3738cf3296d4c55ab1cb
BLAKE2b-256 6c3689fe1faec8d81a204054a49cf6a2e1f1b465f2dbc301978e11af22c093bb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: afs_core-1.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f540fcf408e50aa3beee823ada829317d1f9ac1371a636fee25411738ac8ef53
MD5 84da23fc30cf0865806807f17e23b8cc
BLAKE2b-256 641f32861fc84094d95a8b18077647327570b5dca99b29c945a09d13eb09f4d1

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