Skip to content

Documentation

This folder contains user-facing docs (how to use AbstractRuntime) and maintainer docs (ADRs/backlog).

If you are new: read getting-started.md → api.md → architecture.md.

Ecosystem

AbstractRuntime is part of the wider AbstractFramework ecosystem: - AbstractFramework umbrella: lpalbou/AbstractFramework - AbstractCore (LLM + tools): lpalbou/abstractcore

In this repo, the AbstractCore wiring lives under src/abstractruntime/integrations/abstractcore/* and is documented in integrations/abstractcore.md.

Start here

  • ../README.md — install + quick start
  • getting-started.md — first steps (recommended)
  • api.md — public API surface (imports + pointers)
  • architecture.md — how the runtime is structured (with diagrams)
  • troubleshooting.md — symptom-oriented setup, runtime, and integration fixes
  • proposal.md — design goals and scope boundaries

Guides

  • faq.md — common questions (recommended)
  • troubleshooting.md — symptom-oriented setup, runtime, and integration fixes
  • manual_testing.md — manual smoke tests and how to run the test suite
  • artifacts.md — Runtime artifact identity, descriptors, provenance, catalog search, and access stats
  • integrations/abstractcore.md — wiring LLM_CALL / TOOL_CALLS, cached sessions, durable bloc prompt-cache control, media inputs, generated media outputs, video progress events, and tool approval waits via AbstractCore
  • tools-comms.md — enabling the optional comms toolset (email/WhatsApp/Telegram)
  • api.md#workflowbundles-flow-and-visualflow-distribution — VisualFlow compiler APIs, media nodes, and PDF document nodes (read_pdf / write_pdf)

Features (reference)

  • evidence.md — artifact-backed evidence capture for external-boundary tools
  • mcp-worker.md — MCP worker CLI (abstractruntime-mcp-worker)
  • snapshots.md — snapshot/bookmark model and stores
  • provenance.md — tamper-evident hash-chained ledger
  • limits.md — runtime-aware _limits namespace and APIs
  • workflow-bundles.md — .flow bundle format, VisualFlow distribution, and multi-entry fan-in metadata

Maintainers

  • ../CHANGELOG.md — release notes
  • ../CODE_OF_CONDUCT.md — contributor conduct expectations
  • ../CONTRIBUTING.md — how to build/test and submit changes
  • ../SECURITY.md — responsible vulnerability reporting
  • ../ACKNOWLEDGMENTS.md — credits
  • ../ROADMAP.md — prioritized next steps
  • adr/README.md — architectural decisions (why)
  • backlog/README.md — implemented and planned work items (what/how)