AbstractRuntime 0.0.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

abstractruntime-0.2.0.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: AbstractRuntime
+Version: 0.2.0
+Summary: AbstractRuntime: a durable graph runner designed to pair with AbstractCore.
+Project-URL: AbstractCore (website), https://www.abstractcore.ai/
+Project-URL: AbstractCore (GitHub), https://github.com/lpalbou/abstractruntime
+Author: Laurent-Philippe Albou
+License: MIT
+License-File: LICENSE
+Keywords: agents,checkpoint,durable,graph,llm,resume,workflow
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+## AbstractRuntime
+
+**AbstractRuntime** is a low-level **durable workflow runtime**:
+- Execute workflow graphs (state machines)
+- **Interrupt → checkpoint → resume** (hours/days) without keeping Python stacks alive
+- Append-only **ledger** ("journal d’exécution") for audit/debug/provenance
+
+**Status**: MVP kernel + file persistence + AbstractCore integration adapters are implemented.
+
+---
+
+### Key concepts
+- **WorkflowSpec**: graph definition (node handlers keyed by id)
+- **RunState**: durable state (`current_node`, `vars`, `waiting`, etc.)
+- **Effect**: a side-effect request (`llm_call`, `tool_calls`, `ask_user`, `wait_event`, ...)
+- **Ledger**: append-only step records (`StepRecord`) describing what happened
+
+---
+
+### Quick start (pause + resume)
+
+```python
+from abstractruntime import Effect, EffectType, Runtime, StepPlan, WorkflowSpec
+from abstractruntime.storage import InMemoryLedgerStore, InMemoryRunStore
+
+
+def ask(run, ctx):
+    return StepPlan(
+        node_id="ask",
+        effect=Effect(
+            type=EffectType.ASK_USER,
+            payload={"prompt": "Continue?"},
+            result_key="user_answer",
+        ),
+        next_node="done",
+    )
+
+
+def done(run, ctx):
+    return StepPlan(node_id="done", complete_output={"answer": run.vars.get("user_answer")})
+
+
+wf = WorkflowSpec(workflow_id="demo", entry_node="ask", nodes={"ask": ask, "done": done})
+rt = Runtime(run_store=InMemoryRunStore(), ledger_store=InMemoryLedgerStore())
+
+run_id = rt.start(workflow=wf)
+state = rt.tick(workflow=wf, run_id=run_id)
+assert state.status.value == "waiting"
+
+state = rt.resume(
+    workflow=wf,
+    run_id=run_id,
+    wait_key=state.waiting.wait_key,
+    payload={"text": "yes"},
+)
+assert state.status.value == "completed"
+```
+
+---
+
+### Built-in Scheduler
+
+AbstractRuntime includes a zero-config scheduler for automatic run resumption:
+
+```python
+from abstractruntime import create_scheduled_runtime
+
+# Zero-config: defaults to in-memory storage, auto-starts scheduler
+sr = create_scheduled_runtime()
+
+# run() does start + tick in one call
+run_id, state = sr.run(my_workflow)
+
+# If waiting for user input, respond (auto-finds wait_key)
+if state.status.value == "waiting":
+    state = sr.respond(run_id, {"answer": "yes"})
+
+# Stop scheduler when done
+sr.stop()
+```
+
+For production with persistent storage:
+
+```python
+from abstractruntime import create_scheduled_runtime, JsonFileRunStore, JsonlLedgerStore
+
+sr = create_scheduled_runtime(
+    run_store=JsonFileRunStore("./data"),
+    ledger_store=JsonlLedgerStore("./data"),
+)
+```
+
+---
+
+### AbstractCore integration (LLM + tools)
+
+AbstractRuntime’s kernel stays dependency-light; AbstractCore integration lives in:
+- `src/abstractruntime/integrations/abstractcore/`
+
+Execution modes:
+- **Local**: in-process AbstractCore providers + local tool execution
+- **Remote**: HTTP to AbstractCore server (`/v1/chat/completions`) + tool passthrough (default)
+- **Hybrid**: remote LLM + local tool execution
+
+See: `docs/integrations/abstractcore.md`.
+
+---
+
+### Snapshots / bookmarks
+
+Snapshots are named, searchable checkpoints of a run state:
+- `Snapshot(snapshot_id, run_id, name, description, tags, run_state)`
+
+See: `docs/snapshots.md`.
+
+---
+
+### Provenance (tamper-evident ledger)
+
+You can wrap any `LedgerStore` with a hash chain:
+
+- `HashChainedLedgerStore(inner_store)`
+- `verify_ledger_chain(records)`
+
+This is **tamper-evident**, not non-forgeable (signatures are optional future work).
+
+See: `docs/provenance.md`.
+
+---
+
+### Documentation index
+
+| Document | Description |
+|----------|-------------|
+| [Proposal](docs/proposal.md) | Design goals, core concepts, and scope |
+| [ROADMAP](ROADMAP.md) | Prioritized next steps with rationale |
+| [ADRs](docs/adr/) | Architectural decisions and their rationale |
+| [Backlog](docs/backlog/) | Completed and planned work items |
+| [Integrations](docs/integrations/) | AbstractCore integration guide |
+| [Snapshots](docs/snapshots.md) | Named checkpoints for run state |
+| [Provenance](docs/provenance.md) | Tamper-evident ledger documentation |

abstractruntime-0.2.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+abstractruntime/__init__.py,sha256=oobR5VlwZgxJKWr7hmjwVEGgYakHQt4oJNrdxcj6Nsc,2547
+abstractruntime/core/__init__.py,sha256=msUcfYjAwjkiEgvi-twteo1H11oBclYJFXqYVWlf8JQ,547
+abstractruntime/core/config.py,sha256=dQnWCpGL5fFV2y_KOhTjLVu5fzhcOfUnbLjd3uMcRCs,3922
+abstractruntime/core/models.py,sha256=JmuDpM8jjzcr6lc0yv7oBTSrzCtID4Pz21eVDDcQnKk,8142
+abstractruntime/core/policy.py,sha256=C8tmxaY8YCTvs8_5-5Ns6tsFdCVE_G2vHBOiEckeg9Y,5115
+abstractruntime/core/runtime.py,sha256=ZPERZuvtVCBEhWPKXTO2K_7mwnBZd1FAjubp5uiV-Ck,27653
+abstractruntime/core/spec.py,sha256=SBxAFaaIe9eJTRDMEgDub-GaF2McHTDkEgIl3L-DXbE,1461
+abstractruntime/core/vars.py,sha256=ghe9WkjlOuVbIgN86V2RXRVqpd0D9qNmoBz_Xf30hqw,2995
+abstractruntime/identity/__init__.py,sha256=aV_aA6lfqsIQMPE2S0B0AKi0rnb-_vmKYpgv1wWoaq8,119
+abstractruntime/identity/fingerprint.py,sha256=axQFEHSJFsrYGNkikkfEVhNNQxdR8wBmv4TuVbTs0lM,1748
+abstractruntime/integrations/__init__.py,sha256=CnhKNxeT-rCeJRURWOXT8YBZ7HJPOESJROV5cnEwJoQ,408
+abstractruntime/integrations/abstractcore/__init__.py,sha256=txcjiJD7ETRyQMjQQ8zeSrlxpAHAsRjObU7fGLIoNbg,1302
+abstractruntime/integrations/abstractcore/effect_handlers.py,sha256=Zwl5-v6HKgdCUdfuiXOCU3LphKsAL_LxfdSIG4PKudg,4467
+abstractruntime/integrations/abstractcore/factory.py,sha256=r7ZtojoDLObe16gKsp0h04EliVAlbFl8aeXcuw6o9sw,6339
+abstractruntime/integrations/abstractcore/llm_client.py,sha256=KA-GDb8yhcOA93tbNugrtdOPITJQYPsds5IFLe6JdIk,13654
+abstractruntime/integrations/abstractcore/logging.py,sha256=iYmibudvLXs83hhF-dpbgEoyUdzTo8tnT4dV-cC6uyE,683
+abstractruntime/integrations/abstractcore/tool_executor.py,sha256=yZq3txNlm00Xa-m7KfUN3_6ACKXGOZLnyslAI-CA-fs,5528
+abstractruntime/scheduler/__init__.py,sha256=ZwFJQrBN3aQOv7xuGXsURXEEBJAHV6qVQy13DYvbhqw,337
+abstractruntime/scheduler/convenience.py,sha256=Rremvw_P3JMQ-NOkwn7ATlD5HPkKxRtSGJRfBkimyJY,10278
+abstractruntime/scheduler/registry.py,sha256=0iqcTcCV0bYmhw-T7n8TFoZXVkhBRZt89AebXz_Z5fc,2969
+abstractruntime/scheduler/scheduler.py,sha256=Z3dIwz0e7bP7c_S_VoclgY1Fjw7NxFez_wsst-dYVT8,13535
+abstractruntime/storage/__init__.py,sha256=KSg4V-0Ge_BWFnm_a-XsKezNdtUhUBUuvfsvRKUiDUo,702
+abstractruntime/storage/artifacts.py,sha256=xIWR2Es4W4j3w3GJj1L4qrrRG4mkgiUagFucV_Cggio,15570
+abstractruntime/storage/base.py,sha256=QkNjtHRhqRHHg5FbEP9CVNjL97RTFcy4y8vNRPtVVvc,2758
+abstractruntime/storage/in_memory.py,sha256=baSlhu5ZPEFS82PvYwW89n0PbK7JmS1H07qlrPf40rI,3534
+abstractruntime/storage/json_files.py,sha256=txj3deVXlhK2fXFquUEvPfhGCc5k4pxIKVR9FXJIugU,6954
+abstractruntime/storage/ledger_chain.py,sha256=TnAWacQ9e58RAg2vKP8OU6WN8Re1PdqN72g574A2CGA,4717
+abstractruntime/storage/snapshots.py,sha256=-IUlZ40Vxcyl3hKzKk_IxYxm9zumBhkSAzrcL9WpmcU,6481
+abstractruntime-0.2.0.dist-info/METADATA,sha256=eeIBiGaa-l8bYfUj1pqMNKnQGOT08xZ3d41zRDahZ1Q,4997
+abstractruntime-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+abstractruntime-0.2.0.dist-info/licenses/LICENSE,sha256=6rL4UIO5IdK59THf7fx0q6Hmxp5grSFi7-kWLcczseA,1083
+abstractruntime-0.2.0.dist-info/RECORD,,

{abstractruntime-0.0.0.dist-info → abstractruntime-0.2.0.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 AbstractRuntime Contributors
+Copyright (c) 2025 Laurent-Philippe Albou
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -21,3 +21,5 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
+
+

abstractruntime-0.0.0.dist-info/METADATA

@@ -1,89 +0,0 @@
-Metadata-Version: 2.4
-Name: AbstractRuntime
-Version: 0.0.0
-Summary: Placeholder for AbstractRuntime: a durable graph runner designed to pair with AbstractCore.
-Project-URL: AbstractCore (website), https://www.abstractcore.ai/
-Project-URL: AbstractCore (GitHub), https://github.com/lpalbou/abstractcore
-Author: AbstractRuntime Contributors
-License: MIT
-License-File: LICENSE
-Keywords: agents,checkpoint,durable,graph,llm,resume,workflow
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
-## AbstractRuntime
-
-**Status:** placeholder package (planning stage). **No runtime implementation yet.**
-
-AbstractRuntime is intended to be a **durable graph runner** designed to pair with **AbstractCore** (unified LLM interface: [website](https://www.abstractcore.ai/), [GitHub](https://github.com/lpalbou/abstractcore)).
-
-### Problem this package is meant to solve
-
-Agentic systems are inherently **multi-step** and frequently **interruptible**:
-
-- **External calls** (LLM providers, tools, jobs) can fail transiently, time out, or be rate-limited.
-- **Human-in-the-loop steps** require pausing, collecting input, and resuming later.
-- **Long-running workflows** must survive process restarts and redeploys.
-
-AbstractRuntime’s goal is to provide a **general-purpose execution substrate** that can:
-
-- **Interrupt → checkpoint → resume** at *any* step boundary
-- Support heterogeneous step types (LLM call, tool call, wait-until time, wait-job, ask-user, subgraph, etc.)
-- Maintain a durable **step ledger** (append-only history of attempts and outcomes)
-
-### Design targets (intended capabilities)
-
-- **Durable execution model**
-  - Steps are executed with **durable state transitions** persisted to storage.
-  - A run can be safely resumed after crash/restart without losing progress.
-  - Clear semantics for retries and backoff without “double-applying” effects.
-
-- **Interrupt / resume primitives**
-  - Explicit “pause points” for ask-user / wait steps.
-  - Resume via a stable run identifier + persisted checkpoint.
-
-- **Step ledger (audit + debugging)**
-  - Append-only records for: step identity, inputs, outputs, errors, timestamps, attempt numbers, and metadata.
-  - Designed to support observability, replay analysis, and compliance/audit needs.
-
-- **Step type extensibility**
-  - A common “step contract” that can represent:
-    - LLM calls (with AbstractCore)
-    - Tool calls (side-effecting or pure)
-    - Wait-until (time-based scheduling)
-    - Wait-job (external job orchestration)
-    - Ask-user (HITL)
-    - Subgraph / dynamic branching
-
-- **Storage backends (planned)**
-  - Pluggable persistence for checkpoints + ledgers (e.g., SQLite/Postgres/file).
-  - Strong focus on correctness and durability over early optimization.
-
-### Relationship to AbstractCore
-
-AbstractCore provides a **provider-agnostic LLM interface** and media/tooling primitives (see [AbstractCore website](https://www.abstractcore.ai/) and [AbstractCore GitHub](https://github.com/lpalbou/abstractcore)). AbstractRuntime is intended to orchestrate *when* and *how* those calls happen in larger workflows, with durability guarantees.
-
-### Non-goals (initially)
-
-- A full workflow DSL or UI.
-- A distributed queue system replacement.
-- A specific persistence backend mandate (storage will be abstracted).
-
-### Installation
-
-This package is currently a placeholder for PyPI name reservation and documentation.
-
-### License
-
-MIT (see `LICENSE`).
-
-

abstractruntime-0.0.0.dist-info/RECORD

@@ -1,5 +0,0 @@
-abstractruntime/__init__.py,sha256=0yfPLNKDzm5Ysix1FCMLU4vN3XHCYAGseoUguAFG1tM,160
-abstractruntime-0.0.0.dist-info/METADATA,sha256=bUReg7RLj44aOfeo35ECvTO6v-gLnRDZ8H9buXvv8iU,3904
-abstractruntime-0.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-abstractruntime-0.0.0.dist-info/licenses/LICENSE,sha256=kzHeLsFARPLuhRrmBfR3ISCnJ8uxrAAAEPDwvbmcE7M,1087
-abstractruntime-0.0.0.dist-info/RECORD,,