Skip to main content

Demiurge 0.3.1

Demiurge is alpha / developer-preview software. APIs, runtime layout, and authoring contracts may still change.

Summary​

This release extends package recipes with first-class bootstrap components and moves the built-in memory_basic package onto the host bootstrap context snapshot.

User-Visible Changes​

  • Package recipes can now install kind: bootstrap components into agent/bootstrap/<slot_id>.
  • Package install and uninstall maintain agent/bootstrap/pipeline.yaml for bootstrap components. Bootstrap package pipeline edits are serial-only.
  • memory_basic now installs its memory context as agent/bootstrap/memory_basic instead of an input module.
  • memory_basic no longer writes its own session JSON snapshot. Memory context is frozen through the host-owned bootstrap_context.md snapshot.
  • memory_basic keeps live tool reads and durable writes to MEMORY.md and USER.md; writes still affect future sessions rather than the current bootstrap snapshot.

Breaking Changes​

  • Runtime cores with an installed pre-0.3.1 memory_basic package keep the old installed agent/input/memory_context files until the package is reinstalled or the runtime core is refreshed.
  • Package recipes that want bootstrap installation must use kind: bootstrap; using kind: input for session-start context is no longer the recommended package shape.

Known Limitations​

  • The package catalog is still local-only.
  • Code slots run in the host-shared Python environment by default.
  • Telegram is long-polling only.
  • Candidate core evolution and automatic promotion are still incomplete.
  • Package installation does not migrate already-installed runtime package records or rewrite existing runtime cores automatically.

Verification​

  • uv run pytest tests/packages/test_packages.py tests/packages/test_memory_basic_package.py tests/core/test_loader.py
  • uv run python -c 'import tomllib, demiurge; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"]); print(demiurge.__version__)'
  • git diff --check
  • rg -n "memory_context|agent/input/memory_context" agent-catalog tests docs/authoring docs/reference README.md README.zh-CN.md