Skip to main content

Code Craft AI Extension

The codecraftai-extension package provides the lightweight extension and factory machinery that other ccai packages use to allow third-party code to plug in new resource types, coordinators, and protocol handlers without modifying the host package. Extensions are discovered by scanning the ccai.factories namespace on sys.path (and via explicit module registration through SuperFactory.add_factory_module), and are picked up by extension-aware packages such as codecraftai-landscaping, codecraftai-interop, and the codecraftai-interop-ext-* packages.

Highlights

  • FactoryExtension plus FactoryProtocolBase and SuperFactory for pluggable object construction.

  • ResourceExtension for resources that must be discovered and registered at runtime.

  • ccai.factories namespace scanning (plus explicit module registration) so third-party packages can contribute without modifying host code.

  • Used as the substrate for the composable codecraftai-interop-ext-* ecosystem of device types, protocols, and services.

Repository Structure

  • development/ - Runtime environment scripts.

  • repository-setup/ - Repository homing and setup scripts.

  • source/packages/ - Package source code.

  • source/tests/ - unittest-based tests.

  • specs/ - Requirements, design, and task documentation.

  • userguide/ - Standards, conventions, and documentation.

Environment Setup

When working in a Codex container:

./development/setup-agent-container

For local development:

./repository-setup/rehome-repository
./development/setup-environment

Running Tests

Activate the virtual environment:

source .venv/bin/activate

Run unittest tests:

python -m unittest discover -s source/tests -p "test_*.py"

Standards and Conventions

  • Naming conventions: userguide/10-02-naming-conventions.rst

  • Code organization: userguide/10-01-code-organization.rst

  • Coding standards: userguide/10-00-coding-standards.rst

Additional Resources

  • User guide entry point: userguide/userguide.rst

  • Design documentation: specs/design.md

  • Requirements: specs/requirements.md

Metadata

Release files for codecraftai-extension 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codecraftai-extension 1.3.0
File Size Uploaded Provenance
codecraftai_extension-1.3.0.tar.gz 14.6 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for codecraftai-extension 1.3.0
File Interpreter ABI Platform
codecraftai_extension-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 31.8 kB

Release files / codecraftai_extension-1.3.0.tar.gz

Download URL codecraftai_extension-1.3.0.tar.gz
Size 14.6 kB
Tags Source
SHA-256 checksum
How to use checksums
5f1d14ce01a4d86550f33a95adb263224d1baf2171709984a8f441ee7e3a8b06
BLAKE2b-256 checksum
How to use checksums
028f557b53ff01fa94986a4d6b51c1efed294f43783e19d1418632fae3beb096
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / codecraftai_extension-1.3.0-py3-none-any.whl

Download URL codecraftai_extension-1.3.0-py3-none-any.whl
Size 17.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
91a298a0fb3b9ce2cd679c85da157de33d803dc6ed2f4e306024f810373e7ecb
BLAKE2b-256 checksum
How to use checksums
a27668136a800ddc2cf377aad614157da943bdf4d17ba56013c792f3cb0d2032
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for codecraftai-extension 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for codecraftai_extension-1.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page