activegraph 1.0.0rc2__py3-none-any.whl

activegraph-1.0.0rc2.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: activegraph
+Version: 1.0.0rc2
+Summary: An event-sourced reactive graph runtime for long-running, auditable, agentic systems.
+Author: Active Graph contributors
+License: MIT
+Project-URL: Homepage, https://github.com/yoheinakajima/activegraph
+Keywords: graph,agents,event-sourcing,runtime
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click<9,>=8
+Requires-Dist: pydantic>=2
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40; extra == "llm"
+Requires-Dist: pydantic>=2; extra == "llm"
+Provides-Extra: sqlite
+Provides-Extra: postgres
+Requires-Dist: psycopg[binary]<4,>=3.1; extra == "postgres"
+Provides-Extra: prometheus
+Requires-Dist: prometheus_client>=0.20; extra == "prometheus"
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40; extra == "all"
+Requires-Dist: pydantic>=2; extra == "all"
+Requires-Dist: psycopg[binary]<4,>=3.1; extra == "all"
+Requires-Dist: prometheus_client>=0.20; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pydantic>=2; extra == "dev"
+Requires-Dist: prometheus_client>=0.20; extra == "dev"
+Requires-Dist: psycopg[binary]<4,>=3.1; extra == "dev"
+
+# Active Graph
+
+> The graph is the world. Behaviors are physics. The trace is the proof.
+
+An event-sourced reactive graph runtime for long-running, auditable,
+agentic systems. Behaviors react to a shared graph instead of talking
+to each other. Every change is traceable. Every run is resumable,
+forkable, and diff-able from its event log.
+
+If chat-based agents are a group conversation, Active Graph is a
+shared workspace where everyone can see what changed, who changed
+it, and why.
+
+## Try it in 30 seconds
+
+```bash
+pip install activegraph
+activegraph quickstart
+```
+
+The bundled Diligence pack runs against recorded fixtures: no API
+key, no configuration, byte-deterministic output. You see what the
+framework does before you read about how it does it.
+
+Then walk the 10-minute tutorial:
+
+```bash
+activegraph quickstart --interactive
+```
+
+It scaffolds a behavior, runs it against the same fixtures, and ends
+with the fork-and-diff workflow — the framework's most differentiated
+capability.
+
+## Install
+
+```bash
+pip install activegraph                    # core runtime + SQLite store + Diligence pack
+pip install "activegraph[llm]"             # Anthropic provider
+pip install "activegraph[postgres]"        # Postgres-backed event store
+pip install "activegraph[prometheus]"      # Prometheus metrics
+pip install "activegraph[all]"             # everything
+```
+
+Python 3.11+. Two hard dependencies (`click` for the CLI, `pydantic`
+for the pack format); persistence backends and provider integrations
+are opt-in extras.
+
+## What you get
+
+- **Event-sourced graph runtime.** Objects + typed relations + an
+  append-only event log. Every mutation is an event; the trace is the
+  audit trail.
+- **Reactive behaviors as first-class.** Function, class, LLM-backed,
+  or attached to typed edges (the relation-behavior primitive — edges
+  with logic). Subscriptions are event type + predicate + a Cypher
+  subset for graph-shape patterns.
+- **Fork-and-diff.** Branch any run at any event into an independent
+  fork, configure it differently, and structurally diff the result
+  against the parent. Cache replay means the shared prefix doesn't
+  re-execute (no new LLM calls). Most agent frameworks can't do this.
+- **Packs.** A pack bundles object types, behaviors, tools, prompts,
+  and policies for a specific domain. The bundled
+  [Diligence pack](activegraph/packs/diligence) is the reference:
+  8 object types, 7 behaviors, 3 tools, recorded fixtures.
+- **Per-error reference pages.** Every error message ends with a
+  `More:` link to a page that explains when it fires, why, and how to
+  fix it. Catalog at [docs.activegraph.dev/reference/errors](https://docs.activegraph.dev/reference/errors/).
+
+## A small example
+
+The relation-behavior primitive — coordination logic on the edge,
+not on either endpoint:
+
+```python
+from activegraph import Graph, Runtime, behavior, relation_behavior
+
+graph = Graph()
+runtime = Runtime(graph, budget={"max_events": 200, "max_seconds": 60})
+
+@behavior(name="planner", on=["goal.created"])
+def planner(event, graph, ctx):
+    research = graph.add_object("task", {"title": "Research", "status": "open"})
+    memo = graph.add_object("task", {"title": "Draft memo", "status": "blocked"})
+    graph.add_relation(research.id, memo.id, "depends_on")
+
+@behavior(name="researcher", on=["object.created"], where={"object.type": "task"})
+def researcher(event, graph, ctx):
+    task = event.payload["object"]
+    if task["data"]["status"] != "open" or "Research" not in task["data"]["title"]:
+        return
+    graph.add_object("claim", {"text": "Market early but growing.", "confidence": 0.7})
+    graph.emit("task.completed", {"task_id": task["id"]})
+
+@relation_behavior(name="unblock", relation_type="depends_on", on=["task.completed"])
+def unblock(relation, event, graph, ctx):
+    if event.payload["task_id"] == relation.source:
+        graph.patch_object(relation.target, {"status": "open"})
+
+runtime.run_goal("Evaluate this startup idea")
+runtime.print_trace()
+```
+
+The `unblock` relation behavior fires only for events touching one of
+its edge endpoints. The conceptual deep-dive on edges-with-logic is
+in [`docs/concepts/relations.md`](https://docs.activegraph.dev/concepts/relations/).
+
+## Documentation
+
+- **[docs.activegraph.dev](https://docs.activegraph.dev/)** — full doc site:
+  concepts, guides, cookbook, CLI reference, API reference, the
+  per-error catalog.
+- **[10-minute tutorial](https://docs.activegraph.dev/quickstart/)** — install
+  to a working custom behavior, including fork-and-diff.
+- **[CHANGELOG.md](CHANGELOG.md)** — every release, with per-version
+  migration notes.
+- **[CONTRACT.md](CONTRACT.md)** — locked design decisions, version
+  by version. Useful when you want to know *why* something is the way
+  it is.
+- **[examples/](examples)** — runnable end-to-end demos:
+  [`diligence_real_run.py`](examples/diligence_real_run.py),
+  [`resume_and_fork.py`](examples/resume_and_fork.py),
+  [`llm_claim_extraction.py`](examples/llm_claim_extraction.py),
+  [`diligence_with_tools.py`](examples/diligence_with_tools.py),
+  [`operate_a_run.py`](examples/operate_a_run.py).
+
+## What this is not
+
+- Not a chat framework. If your problem fits in one conversation, use
+  a chat framework.
+- Not a workflow engine. Workflows model control flow. This models
+  world state.
+- Not a rules engine, exactly. Rules engines forward-chain over
+  facts. This event-sources over a graph and supports LLM behaviors
+  as first-class.
+- Not a production graph database. The default store is SQLite,
+  optionally Postgres. For a high-throughput graph backend, plug one
+  in behind the `EventStore` protocol.
+- Not magic. Bad behaviors produce bad graphs. The runtime makes the
+  badness inspectable, not absent.
+
+## Status
+
+**v1.0-rc1** (2026-05). v1.0 final ships after the first-time-user
+gate per [CONTRACT v1.0 #C4](CONTRACT.md#v10-c4-v10-ships-as-v10-rc1-first-time-user-gate-is-owned-externally).
+See [CHANGELOG.md](CHANGELOG.md) for the full v0 → v1.0 history and
+per-version migration notes.
+
+Major shipped milestones:
+
+- **v1.0 (rc1)** — error hierarchy rewrite with per-error reference
+  pages, doc site at [docs.activegraph.dev](https://docs.activegraph.dev/),
+  `activegraph quickstart` command, mypy `--strict` and docstring
+  coverage CI gates.
+- **v0.9** — pack format and the Diligence reference pack (8 object
+  types, 7 behaviors, 3 tools, recorded fixtures).
+- **v0.8** — operator surface: structured logging, Prometheus
+  metrics, `runtime.status()`, full `activegraph` CLI,
+  `PostgresEventStore`.
+- **v0.7** — `@tool` decorator, Cypher-subset pattern subscriptions,
+  temporal predicates.
+- **v0.6** — `@llm_behavior` with structured output, frame-aware
+  prompt construction, cost accounting.
+- **v0.5** — full event-log persistence, save/load across processes,
+  fork from any historical event, structural diff between runs.
+- **v0** — core runtime: graph, behaviors, relation behaviors,
+  patches with optimistic concurrency, views, frames, policies,
+  budgets, the trace.
+
+Roadmap items planned for v1.1 are tracked in
+[CONTRACT.md § v1.1](CONTRACT.md).
+
+## License
+
+MIT.
+
+## Contributing
+
+The core runtime stays small and sharp. Contributions to packs,
+backends, and LLM integrations are especially welcome. Open an issue
+before large changes — the abstractions are still settling.
+
+**Test discipline:** tests must remain deterministic. No live network
+calls in CI. LLM and tool tests use recorded fixtures
+(`RecordedLLMProvider`, `RecordedToolProvider`). If a contribution
+adds a test that would only pass with a live API key or live HTTP,
+it cannot land.
+
+---
+
+The graph is the world. Behaviors are physics. The trace is the proof.

activegraph-1.0.0rc2.dist-info/RECORD

@@ -0,0 +1,82 @@
+activegraph/__init__.py,sha256=yX-NpJeHfqUGS07ZcmmsT_83tMUd4QAcNLmVwLzIiSA,5594
+activegraph/__main__.py,sha256=llxXBaMVgcU891cIt3g4Cy0lk-eG5OcNHukSqoQjtxQ,118
+activegraph/errors.py,sha256=FgNaJsbz5yjXPerJlBQ_M_CMDO2RdGqr4sfGTuN9IZw,12532
+activegraph/frame.py,sha256=Wo35msB2gLFXLtk-rbO0OnyXchlvvuvOVuD2ImHjw2s,384
+activegraph/policy.py,sha256=L2meukP8tyAS1bBF1xsJytOw_Y5tBRGkcfg-9OhameM,743
+activegraph/behaviors/__init__.py,sha256=RiVSowhQZ27MYY-djO0uYiIof27mkv__rlXwI858Cfo,78
+activegraph/behaviors/base.py,sha256=366fMvfjFhfdhKMHl_CE9yENDljUWD7Twl50NkQ7fr4,5487
+activegraph/behaviors/decorators.py,sha256=wLY3Miyq0XRhIkSmvx2Q6_8tK8ZhNki4KnStzAPPWpU,7302
+activegraph/cli/__init__.py,sha256=G_yz3MG14Yz78YmG9sbNYTd9d7-6afGI3SqUGVspCq4,521
+activegraph/cli/main.py,sha256=xnBxQFBV_QDxkT_uv9va9OuNg5iIgvOnj6Ix5Nu82IM,26778
+activegraph/cli/quickstart.py,sha256=Yr0FODUURDank0FOK0846aNsA1MyREiSNyi3vKJm2j0,20643
+activegraph/core/__init__.py,sha256=qc5isDQs1xRdVf67KEvMvIeXEhzWwSpvslgpQkIKr7w,65
+activegraph/core/clock.py,sha256=apCa10mtdHvg_oH5ihtnVFMI-YE8Yv13y94UYTcFUmY,1256
+activegraph/core/event.py,sha256=seA7lS_Qha7uz4x9KxeolIOuzvXHtJPSVmQWDosD-NA,960
+activegraph/core/graph.py,sha256=RiAC3bJcaSzbgZ4RTxJulZkw-HN80SnUUBnnKEWQCFE,29158
+activegraph/core/ids.py,sha256=Mri3PxnuEZRHUal1Gu_dtIds5nAosj_LaSVYE5oi35A,4676
+activegraph/core/patch.py,sha256=M4-moXMOzsibJfpM5OVhz62gwUK2BsBU-bWyA8naPTE,1448
+activegraph/core/view.py,sha256=ESdC0aY7a-Rw-FcFQHoEAb76kQSEXMn7wO5qoO8pyAc,1668
+activegraph/llm/__init__.py,sha256=8Wc1FIXkFX9D5X13KrkYJHHhbrZj8BJ3hTAqMWnt10g,1824
+activegraph/llm/anthropic.py,sha256=2CPc7nO5D8eKPUOeqMzPRqVzMYsR33CgW-cEXn4hbiA,11730
+activegraph/llm/cache.py,sha256=LvI6cpKXabcY9-eGCBBo00CGVR9y5Ren-k7q6qMsSZk,6388
+activegraph/llm/errors.py,sha256=Y8UX2WvQYDL9Fetp5Qcc7-cZy1Qiqx8gP_BNr5NQx2U,11799
+activegraph/llm/prompt.py,sha256=cg8LWKai8CqlTh2XpT83fhYJ8-AhhzWOiW3222AlwNg,13518
+activegraph/llm/provider.py,sha256=gB9lmZ22KuSXXxd1P1_g3Ua8EO5agLZSU0g5JA1RJZM,1998
+activegraph/llm/recorded.py,sha256=ZK9Ad92XFUX40qB8oZqIzzRB6PgXKLNKukmK2jDc0TQ,9029
+activegraph/llm/types.py,sha256=hn1m4rHShQAkP144iVTa4TWuzwFXwru6wpeJAochX1E,4553
+activegraph/observability/__init__.py,sha256=cBChBnlVO8Nolz13pkVcmkpNZdCgZ88uWt1hviZjHP4,1561
+activegraph/observability/logging.py,sha256=ox-bczq34kdZ_76a4THRlt3HSYTFiYMM7jfDh-ZsOoM,6666
+activegraph/observability/metrics.py,sha256=6rs7gt5VJ46TDtbnOQE716CnPRZTXm0LwbJsg5dWCjo,6572
+activegraph/observability/migration.py,sha256=Gr6SlYavZkpyl0c5yZSKV_S3LW-DiXdI8lqk0pNBVo8,14183
+activegraph/observability/prometheus.py,sha256=NkSm-ub_Q_eJn15iJ30fomdP6Re6DTSUvHgRdRDZN4w,3375
+activegraph/observability/status.py,sha256=v3YexsS1ZZDGy7paKuzliqyV0gFDE3K0gN4Nkd5cRH4,2363
+activegraph/packs/__init__.py,sha256=Ln6ad9X0aIWRfz7D7s9n74iv8l7r_N574sv_hMN5GY8,35971
+activegraph/packs/loader.py,sha256=eIiuzrpuuO79X9NLFRwIkzUMvKL0WRBq1aEZhgeRyO8,29959
+activegraph/packs/scaffold.py,sha256=817ymv0ijuUZhadbE_JVGgXxnRIerfoj_bwcE0qvzPQ,8343
+activegraph/packs/diligence/__init__.py,sha256=Z4ePKbxauiznywlUYCDgYU9FMA81q090SmkstOynpF0,3033
+activegraph/packs/diligence/behaviors.py,sha256=cMlckVaQ6iwctJqNFXSVvVzuLgDd66j259p40T4DbS4,15229
+activegraph/packs/diligence/object_types.py,sha256=KywLMKi19l343G0i9i44IoOSPebR7wZl7kzx1n-LJA4,4926
+activegraph/packs/diligence/settings.py,sha256=UwvZuyDrpmaFzM7mzXm48X3YuNTNUtzZrpqf7zDJKXQ,2269
+activegraph/packs/diligence/tools.py,sha256=MAQImvXgI7lzajTbnz4pGePNGv5wlXAqx9SoP1_Qaqk,3618
+activegraph/packs/diligence/fixtures/__init__.py,sha256=wW64z7OiKmfw0_ye0Hg0OJtpm3SeIpZkojqBbyGLj-U,12216
+activegraph/packs/diligence/fixtures/companies.py,sha256=ozki5gbeHLrx_R3t99cRCuKIbO9Y1QjyHML2R_Pgzg4,24292
+activegraph/runtime/__init__.py,sha256=amm1uU8YT7WTj6k1nF72U9ZDD9N_2-x5FAjkAMTYub8,51
+activegraph/runtime/behavior_graph.py,sha256=9cmYh7yFva31EzQhGDWm0S08z5g4gRnctrUJMh-G9yc,5172
+activegraph/runtime/budget.py,sha256=GlJUPguVdWZ9tdcRCwd-hJ5Pjp7FtVZOPgaONig4CoQ,4368
+activegraph/runtime/config_errors.py,sha256=bHmVbvn8acdfZC8naEGG3tsVqs2wevP-pYTlJUbabS8,3922
+activegraph/runtime/diff.py,sha256=VkDd9TfpsjjzTrW8HKlLXCkzxblymgN-2hpx0FE94PU,5053
+activegraph/runtime/errors.py,sha256=4E02S8c7hjyAcZLC3jJFd9ytlyjXfFx-UW87Wh6r9o4,9339
+activegraph/runtime/exec_errors.py,sha256=3wPxccdivB00fZK62e92rR87mkhBP0ZTMsOqpiYQK3Q,9912
+activegraph/runtime/patterns.py,sha256=KFH4EeRQ9f79eruTu-s-Yh58nu1zkmUZoQzZUTyVUxg,35141
+activegraph/runtime/queue.py,sha256=Ct0eKPhbRq_4ZBd2jJ4KISucNJX46VnOKUe-WRpwj3I,616
+activegraph/runtime/registration_errors.py,sha256=1zwZLSKKo_TKt4QaEUCYzit0_9X_P8RxUDkng_Vyup0,11545
+activegraph/runtime/registry.py,sha256=TxyJg_uoCoXr4rbci7alKfsnFFPyPinTSsMwzoxN9rI,3859
+activegraph/runtime/runtime.py,sha256=-t1khv6g33yh02S-rO1AmmCaQ7Rmebm3xHdubBMM71E,100559
+activegraph/runtime/scheduler.py,sha256=KQaVKPuAQ_XYGQM9F8K60wu4bVhCw7yw78Yh4jTKiXI,7404
+activegraph/runtime/view_builder.py,sha256=NIp7n0Zj5290xdwrKfDpur6RoCt6xB25VHmes0EOwLk,1882
+activegraph/store/__init__.py,sha256=T97zSLwgiVCvjmRhni9ijOATANc2D_k2GOoUaeaXsqM,1403
+activegraph/store/base.py,sha256=W274nFexXe6FdhVdzVz_aNcftJkCndHrhTfp_PSrNRM,1855
+activegraph/store/conformance.py,sha256=MuAzb0BAbei2vgNwQ17oZPjGDLQxguG6ykTv1WwmsLo,5460
+activegraph/store/errors.py,sha256=egLqaUrsZxtO0SHhtvATe0laAypDwy3dEKFy9s4LTHw,3119
+activegraph/store/memory.py,sha256=zpgJFymJw22dC4JorKAXJNgvRIxzfZ_t2PK-qr307x4,4808
+activegraph/store/postgres.py,sha256=olejMn4IDXu1FqW5738GybWGZ1URv6d-ch944ipJVLk,22798
+activegraph/store/serde.py,sha256=v7nJhlP7moug1qBn506h8vgKRVGqBMTtUilX42URfR0,8824
+activegraph/store/sqlite.py,sha256=mt_6vHRW1WPl_K9wx9oWRMh1OfFBOZiR35P2hvR5_pM,16301
+activegraph/store/url.py,sha256=t1kV0zn-akR1S4VjTDsgffzdC8HwPE_PasgnQd71Kww,8579
+activegraph/tools/__init__.py,sha256=atcQfLQn-DPpGnE0cGy27vTATcfGVBfwFwNusAvdmlY,2343
+activegraph/tools/base.py,sha256=xEnC2FVkRpTvs32e4rHW47jAKwPbzJRqGuDmOYqgXR8,2117
+activegraph/tools/cache.py,sha256=eWMQKl5W3YvOaAdqetZ9AK6sz4Rrq7cxOr-42YZsmU0,5201
+activegraph/tools/context.py,sha256=TjKkEcLhUv7_5pSwbZ8FexzH5AMQbex0aqrZUSjQzCk,1858
+activegraph/tools/decorators.py,sha256=aPGeOGqsbsLIoRiYStjZavUIpCiIE9HyiWQe52dG5CA,1985
+activegraph/tools/errors.py,sha256=UrSwAwPPFDQQyqesReRVYdHr_pFucg4tx_Io5ewVT6o,13972
+activegraph/tools/graph_query.py,sha256=HHIb2G_CLudmSJTmYTllHKyRcQfTDF4IJKkk2npVDYY,3357
+activegraph/tools/recorded.py,sha256=f8dKHMiYBF9g7cYXj0udSPiJ2bIaUr39gQ0QxHW6034,7007
+activegraph/tools/web_fetch.py,sha256=An0HKIGqsvmC1Lm7SWtOn5MsJN__VT5IkfiIBsOrV6E,2541
+activegraph/trace/__init__.py,sha256=0x8WsSczh97pTT2hMxwIWFwCZMSR0wJC2kRWRKbxUDo,77
+activegraph/trace/causal.py,sha256=uZD9N50XAJkPpw4C2y8P6HWEGdZOfcHFDrU1XiXIjsQ,4673
+activegraph/trace/printer.py,sha256=qTkPueatHYm0GHlCgMfErDXNQ5d3pIXgAn1nHYRs3Iw,17500
+activegraph-1.0.0rc2.dist-info/METADATA,sha256=uXnOfX1l58pvw8kTyUZt9ancA8EldbTr1pIaWJTpavg,9195
+activegraph-1.0.0rc2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+activegraph-1.0.0rc2.dist-info/entry_points.txt,sha256=dhpJ7jGTS24NzVDZrrN_-k29N3bCgRZLysVmz33l9rg,124
+activegraph-1.0.0rc2.dist-info/top_level.txt,sha256=-N9134CRIXyBGLncyVFkCzYUgNfpUR-_NItwz4Lvad0,12
+activegraph-1.0.0rc2.dist-info/RECORD,,

activegraph-1.0.0rc2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

activegraph-1.0.0rc2.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[activegraph.packs]
+diligence = activegraph.packs.diligence:pack
+
+[console_scripts]
+activegraph = activegraph.cli.main:main

activegraph-1.0.0rc2.dist-info/top_level.txt

@@ -0,0 +1 @@
+activegraph