abstractflow 0.3.0__tar.gz → 0.3.1__tar.gz

{abstractflow-0.3.0 → abstractflow-0.3.1}/CHANGELOG.md

@@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
-- **AbstractCode UI event demo flows** (`abstractflow/web/flows/*.json`):
+- **AbstractCode UI event demo flows** (`web/flows/*.json`):
   - `acagent_message_demo.json`: `abstractcode.message`
   - `acagent_ask_demo.json`: durable ask+wait via `wait_event.prompt`
   - `acagent_tool_events_demo.json`: `abstractcode.tool_execution` + `abstractcode.tool_result`
@@ -19,15 +19,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `Stringify JSON` (`stringify_json`): Render JSON (or JSON-ish strings) into text with a `mode` dropdown (`none` | `beautify` | `minified`). Implementation delegates to `abstractruntime.rendering.stringify_json` for consistent host behavior.
   - `Agent Trace Report` (`agent_trace_report`): Render an agent scratchpad (`node_traces`) into a condensed Markdown timeline of LLM calls and tool actions (full tool args + results, no truncation). Implementation delegates to `abstractruntime.rendering.render_agent_trace_markdown`.
 
+### Changed
+- **Run Flow modal (array parameters)**: Array pins now render as a Blueprint-style item list (add/remove items) with a "Raw JSON (advanced)" escape hatch for non-string arrays.
+
 ### Fixed
 - **FlowRunner SUBWORKFLOW auto-drive**: `FlowRunner.run()` no longer hangs if the runtime registry contains only subworkflow specs (common in unit tests). It now falls back to the runner’s own root `WorkflowSpec` when resuming/bubbling parents.
 
+## [0.3.1] - 2026-02-04
+
+### Added
+- **User-facing documentation set** for public release:
+  - Core docs: `README.md`, `docs/getting-started.md`, `docs/architecture.md`, `docs/api.md`, `docs/faq.md`
+  - Repo policies: `CONTRIBUTING.md`, `SECURITY.md`, `ACKNOWLEDMENTS.md`
+  - Agentic index: `llms.txt`, `llms-full.txt`
+
+### Changed
+- **Documentation accuracy + structure**: refreshed docs to match the implemented code (VisualFlow portability, runtime wiring, CLI bundle tooling, web editor layout) and improved cross-references for first-time users.
+
 ## [0.3.0] - 2025-01-06
 
 ### Added
 - **VisualFlow Interface System** (`abstractflow/visual/interfaces.py`): Declarative workflow interface markers for portable host validation, enabling workflows to be run as specialized capabilities with known IO contracts
-  - `abstractcode.agent.v1` interface: Host-configurable request → response contract for running a workflow as an AbstractCode agent
-  - Interface validation with required/recommended pin specifications (provider/model/tools/request/response)
+  - `abstractcode.agent.v1` interface: Host-configurable prompt → response contract for running a workflow as an AbstractCode agent
+  - Interface validation with required/recommended pin specifications (provider/model/tools/prompt/response)
   - Auto-scaffolding support: enabling `abstractcode.agent.v1` auto-creates `On Flow Start` / `On Flow End` nodes with required pins
 - **Structured Output Support**: Visual `LLM Call` and `Agent` nodes accept optional `response_schema` input pin (JSON Schema object) for schema-conformant responses
   - New literal node `JSON Schema` (`json_schema`) to author schema objects
@@ -133,7 +147,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Run history replay synthesizes missing `node_complete` events for steps left open in durable ledger
 - **Canvas Highlighting**: Robust to fast child-run emissions (race with `node_start` before `runId` state update fixed)
 - **WebSocket Subworkflow Waits**: Correctly close waiting node when run resumes past `WAITING(reason=SUBWORKFLOW)`
-- **Web Run History**: Reliably shows persisted runs regardless of server working directory (backend defaults to `abstractflow/web/runtime` unless `ABSTRACTFLOW_RUNTIME_DIR` set)
+- **Web Run History**: Reliably shows persisted runs regardless of server working directory (backend defaults to `web/runtime` unless `ABSTRACTFLOW_RUNTIME_DIR` set)
 - **Cancel Run**: No longer surfaces as `flow_error` from `asyncio.CancelledError` (treated as expected control-plane operation)
 - **Markdown Code Blocks**: "Copy" now copies original raw code (preserves newlines/indentation) after syntax highlighting
 
@@ -147,15 +161,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 12 new example workflow JSON files in `web/flows/`
 
 ### Notes
-- In this monorepo, `abstractflow` contains a working Flow compiler/runner and VisualFlow execution utilities. Packaging/docs alignment is tracked in `docs/backlog/planned/093-framework-packaging-alignment-flow-runtime.md`.
-
-### Planned
-- Visual workflow editor with drag-and-drop interface
-- Real-time workflow execution and monitoring
-- Integration with AbstractCore for multi-provider LLM support
-- Custom node development SDK
-- Cloud deployment capabilities
-- Collaborative workflow development features
+- This repository includes the published Python package (`abstractflow/`) and a reference visual editor app (`web/`).
 
 ## [0.1.0] - 2025-01-15
 
@@ -170,5 +176,3 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - This is a placeholder release to secure the `abstractflow` name on PyPI
 - No functional code is included in this version
 - Follow the GitHub repository for development updates and release timeline
-
-

abstractflow-0.3.1/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: abstractflow
+Version: 0.3.1
+Summary: Diagram-based AI workflow generation built on AbstractCore
+Author-email: AbstractFlow Team <contact@abstractflow.ai>
+Maintainer-email: AbstractFlow Team <contact@abstractflow.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/lpalbou/AbstractFlow
+Project-URL: Documentation, https://abstractflow.readthedocs.io
+Project-URL: Repository, https://github.com/lpalbou/AbstractFlow
+Project-URL: Bug Tracker, https://github.com/lpalbou/AbstractFlow/issues
+Project-URL: Changelog, https://github.com/lpalbou/AbstractFlow/blob/main/CHANGELOG.md
+Keywords: ai,workflow,diagram,llm,automation,visual-programming,abstractcore,machine-learning
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: AbstractRuntime>=0.4.0
+Requires-Dist: abstractcore[tools]>=2.6.8
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: agent
+Requires-Dist: abstractagent>=0.2.0; extra == "agent"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Provides-Extra: server
+Requires-Dist: fastapi>=0.100.0; extra == "server"
+Requires-Dist: uvicorn[standard]>=0.23.0; extra == "server"
+Requires-Dist: websockets>=11.0.0; extra == "server"
+Provides-Extra: ui
+Requires-Dist: streamlit>=1.28.0; extra == "ui"
+Requires-Dist: plotly>=5.15.0; extra == "ui"
+Requires-Dist: networkx>=3.1.0; extra == "ui"
+Provides-Extra: all
+Requires-Dist: abstractflow[agent,dev,server,ui]; extra == "all"
+Dynamic: license-file
+
+# AbstractFlow
+
+Diagram-based, **durable** AI workflows for Python.
+
+AbstractFlow provides:
+- A portable workflow format (`VisualFlow` JSON) and helpers to execute it from any host (`abstractflow.visual`).
+- A simple programmatic API (`Flow`, `FlowRunner`) backed by **AbstractRuntime**.
+- A reference visual editor app in `web/` (FastAPI backend + React frontend).
+
+Project status: **Pre-alpha** (`pyproject.toml`: `Development Status :: 2 - Pre-Alpha`). Expect breaking changes.
+
+## Capabilities (implemented)
+
+- Execute programmatic flows (`Flow` → `FlowRunner`) with a default in-memory runtime.
+- Execute portable `VisualFlow` JSON from any host process (`abstractflow.visual`).
+- Durable waits and resumption via AbstractRuntime (e.g. user/event/schedule waits).
+- Package a flow tree as a WorkflowBundle (`.flow`) via the CLI.
+- Author/run VisualFlows in the reference web editor (`web/`).
+
+Evidence (code): `abstractflow/runner.py`, `abstractflow/visual/executor.py`, `abstractflow/cli.py`, `web/backend/routes/ws.py`.
+
+## Docs
+
+- Start here: `docs/getting-started.md`
+- API reference: `docs/api.md`
+- VisualFlow format: `docs/visualflow.md`
+- Visual editor: `docs/web-editor.md`
+- CLI: `docs/cli.md`
+- FAQ: `docs/faq.md`
+- Architecture: `docs/architecture.md`
+- Docs index: `docs/README.md`
+
+## Installation
+
+```bash
+pip install abstractflow
+```
+
+Requirements: Python **3.10+** (`pyproject.toml`: `requires-python`).
+
+Optional extras:
+- Agent nodes (ReAct workflows): `pip install "abstractflow[agent]"`
+- Dev tools (tests/formatting): `pip install "abstractflow[dev]"`
+
+Notes:
+- `abstractflow` depends on `AbstractRuntime` and `abstractcore[tools]` (see `pyproject.toml`).
+- Some VisualFlow node types require additional packages (e.g. `memory_kg_*` nodes need `abstractmemory`).
+
+## Quickstart (programmatic)
+
+```python
+from abstractflow import Flow, FlowRunner
+
+flow = Flow("linear")
+flow.add_node("double", lambda x: x * 2, input_key="value", output_key="doubled")
+flow.add_node("add_ten", lambda x: x + 10, input_key="doubled", output_key="final")
+flow.add_edge("double", "add_ten")
+flow.set_entry("double")
+
+result = FlowRunner(flow).run({"value": 5})
+print(result)  # {"success": True, "result": 20}
+```
+
+## Quickstart (execute a VisualFlow JSON)
+
+```python
+import json
+from abstractflow.visual import VisualFlow, execute_visual_flow
+
+with open("my-flow.json", "r", encoding="utf-8") as f:
+    vf = VisualFlow.model_validate(json.load(f))
+result = execute_visual_flow(vf, {"prompt": "Hello"}, flows={vf.id: vf})
+print(result)  # {"success": True, "waiting": False, "result": ...}
+```
+
+If your flow uses subflows, load all referenced `*.json` into the `flows={...}` mapping (see `docs/getting-started.md`).
+
+## Visual editor (from source)
+
+The visual editor is a dev/reference app in `web/` (not shipped as a Python package on PyPI).
+
+```bash
+git clone https://github.com/lpalbou/AbstractFlow.git
+cd AbstractFlow
+
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[server,agent]"
+
+# Terminal 1: Backend (FastAPI)
+cd web && python -m backend --reload --port 8080
+
+# Terminal 2: Frontend (Vite)
+cd web/frontend && npm install && npm run dev
+```
+
+Open the frontend at http://localhost:3003 (default Vite port). See `docs/web-editor.md`.
+
+## CLI (WorkflowBundle `.flow`)
+
+```bash
+abstractflow bundle pack web/flows/ac-echo.json --out /tmp/ac-echo.flow
+abstractflow bundle inspect /tmp/ac-echo.flow
+abstractflow bundle unpack /tmp/ac-echo.flow --dir /tmp/ac-echo
+```
+
+See `docs/cli.md` and `abstractflow/cli.py`.
+
+## Related projects
+
+- AbstractRuntime (durable execution kernel): https://github.com/lpalbou/AbstractRuntime
+- AbstractCore (providers/models/tools): https://github.com/lpalbou/AbstractCore
+- AbstractAgent (ReAct/CodeAct): https://github.com/lpalbou/AbstractAgent
+
+## Changelog
+
+See `CHANGELOG.md`.
+
+## Contributing
+
+See `CONTRIBUTING.md`.
+
+## Security
+
+See `SECURITY.md`.
+
+## Acknowledgments
+
+See `ACKNOWLEDMENTS.md`.
+
+## License
+
+MIT. See `LICENSE`.

abstractflow-0.3.1/README.md

@@ -0,0 +1,133 @@
+# AbstractFlow
+
+Diagram-based, **durable** AI workflows for Python.
+
+AbstractFlow provides:
+- A portable workflow format (`VisualFlow` JSON) and helpers to execute it from any host (`abstractflow.visual`).
+- A simple programmatic API (`Flow`, `FlowRunner`) backed by **AbstractRuntime**.
+- A reference visual editor app in `web/` (FastAPI backend + React frontend).
+
+Project status: **Pre-alpha** (`pyproject.toml`: `Development Status :: 2 - Pre-Alpha`). Expect breaking changes.
+
+## Capabilities (implemented)
+
+- Execute programmatic flows (`Flow` → `FlowRunner`) with a default in-memory runtime.
+- Execute portable `VisualFlow` JSON from any host process (`abstractflow.visual`).
+- Durable waits and resumption via AbstractRuntime (e.g. user/event/schedule waits).
+- Package a flow tree as a WorkflowBundle (`.flow`) via the CLI.
+- Author/run VisualFlows in the reference web editor (`web/`).
+
+Evidence (code): `abstractflow/runner.py`, `abstractflow/visual/executor.py`, `abstractflow/cli.py`, `web/backend/routes/ws.py`.
+
+## Docs
+
+- Start here: `docs/getting-started.md`
+- API reference: `docs/api.md`
+- VisualFlow format: `docs/visualflow.md`
+- Visual editor: `docs/web-editor.md`
+- CLI: `docs/cli.md`
+- FAQ: `docs/faq.md`
+- Architecture: `docs/architecture.md`
+- Docs index: `docs/README.md`
+
+## Installation
+
+```bash
+pip install abstractflow
+```
+
+Requirements: Python **3.10+** (`pyproject.toml`: `requires-python`).
+
+Optional extras:
+- Agent nodes (ReAct workflows): `pip install "abstractflow[agent]"`
+- Dev tools (tests/formatting): `pip install "abstractflow[dev]"`
+
+Notes:
+- `abstractflow` depends on `AbstractRuntime` and `abstractcore[tools]` (see `pyproject.toml`).
+- Some VisualFlow node types require additional packages (e.g. `memory_kg_*` nodes need `abstractmemory`).
+
+## Quickstart (programmatic)
+
+```python
+from abstractflow import Flow, FlowRunner
+
+flow = Flow("linear")
+flow.add_node("double", lambda x: x * 2, input_key="value", output_key="doubled")
+flow.add_node("add_ten", lambda x: x + 10, input_key="doubled", output_key="final")
+flow.add_edge("double", "add_ten")
+flow.set_entry("double")
+
+result = FlowRunner(flow).run({"value": 5})
+print(result)  # {"success": True, "result": 20}
+```
+
+## Quickstart (execute a VisualFlow JSON)
+
+```python
+import json
+from abstractflow.visual import VisualFlow, execute_visual_flow
+
+with open("my-flow.json", "r", encoding="utf-8") as f:
+    vf = VisualFlow.model_validate(json.load(f))
+result = execute_visual_flow(vf, {"prompt": "Hello"}, flows={vf.id: vf})
+print(result)  # {"success": True, "waiting": False, "result": ...}
+```
+
+If your flow uses subflows, load all referenced `*.json` into the `flows={...}` mapping (see `docs/getting-started.md`).
+
+## Visual editor (from source)
+
+The visual editor is a dev/reference app in `web/` (not shipped as a Python package on PyPI).
+
+```bash
+git clone https://github.com/lpalbou/AbstractFlow.git
+cd AbstractFlow
+
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[server,agent]"
+
+# Terminal 1: Backend (FastAPI)
+cd web && python -m backend --reload --port 8080
+
+# Terminal 2: Frontend (Vite)
+cd web/frontend && npm install && npm run dev
+```
+
+Open the frontend at http://localhost:3003 (default Vite port). See `docs/web-editor.md`.
+
+## CLI (WorkflowBundle `.flow`)
+
+```bash
+abstractflow bundle pack web/flows/ac-echo.json --out /tmp/ac-echo.flow
+abstractflow bundle inspect /tmp/ac-echo.flow
+abstractflow bundle unpack /tmp/ac-echo.flow --dir /tmp/ac-echo
+```
+
+See `docs/cli.md` and `abstractflow/cli.py`.
+
+## Related projects
+
+- AbstractRuntime (durable execution kernel): https://github.com/lpalbou/AbstractRuntime
+- AbstractCore (providers/models/tools): https://github.com/lpalbou/AbstractCore
+- AbstractAgent (ReAct/CodeAct): https://github.com/lpalbou/AbstractAgent
+
+## Changelog
+
+See `CHANGELOG.md`.
+
+## Contributing
+
+See `CONTRIBUTING.md`.
+
+## Security
+
+See `SECURITY.md`.
+
+## Acknowledgments
+
+See `ACKNOWLEDMENTS.md`.
+
+## License
+
+MIT. See `LICENSE`.

{abstractflow-0.3.0 → abstractflow-0.3.1}/abstractflow/__init__.py

@@ -39,9 +39,9 @@ For agent-based flows:
     >>> result = runner.run({"context": {"task": "Build a REST API"}})
 """
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 __author__ = "Laurent-Philippe Albou"
-__email__ = "contact@abstractcore.ai"
+__email__ = "contact@abstractflow.ai"
 __license__ = "MIT"
 
 # Core classes

abstractflow-0.3.1/abstractflow/adapters/agent_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.agent_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/control_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.control_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/effect_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.effect_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/event_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.event_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/function_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.function_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/subflow_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.subflow_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/adapters/variable_adapter.py

@@ -0,0 +1,5 @@
+"""Re-export: AbstractRuntime VisualFlow compiler adapter."""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.adapters.variable_adapter import *  # noqa: F401,F403

abstractflow-0.3.1/abstractflow/cli.py

@@ -0,0 +1,89 @@
+"""Command-line interface for AbstractFlow.
+
+Current implemented features:
+- WorkflowBundle (.flow) pack/inspect/unpack (backlog 314)
+
+Other commands are intentionally kept minimal for now.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from typing import List, Optional
+
+from .workflow_bundle import inspect_workflow_bundle, pack_workflow_bundle, unpack_workflow_bundle
+from abstractruntime.workflow_bundle import workflow_bundle_manifest_to_dict
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(prog="abstractflow", add_help=True)
+    sub = p.add_subparsers(dest="command")
+
+    bundle = sub.add_parser("bundle", help="WorkflowBundle (.flow) tools")
+    bundle_sub = bundle.add_subparsers(dest="bundle_cmd")
+
+    pack = bundle_sub.add_parser("pack", help="Pack a .flow bundle from a root VisualFlow JSON file")
+    pack.add_argument("root", help="Path to root VisualFlow JSON (e.g., ./flows/<id>.json)")
+    pack.add_argument("--out", required=True, help="Output .flow path")
+    pack.add_argument("--bundle-id", default=None, help="Bundle id (default: root flow id)")
+    pack.add_argument("--bundle-version", default="0.0.0", help="Bundle version (default: 0.0.0)")
+    pack.add_argument("--flows-dir", default=None, help="Directory containing flow JSON files (default: root's directory)")
+    pack.add_argument(
+        "--entrypoint",
+        action="append",
+        default=None,
+        help="Entrypoint flow id (repeatable). Default: root flow id",
+    )
+
+    insp = bundle_sub.add_parser("inspect", help="Print bundle manifest (JSON)")
+    insp.add_argument("bundle", help="Path to .flow (zip) or extracted directory")
+
+    unpack = bundle_sub.add_parser("unpack", help="Extract a .flow bundle to a directory")
+    unpack.add_argument("bundle", help="Path to .flow (zip) or extracted directory")
+    unpack.add_argument("--dir", required=True, help="Output directory")
+
+    return p
+
+
+def main(args: Optional[List[str]] = None) -> int:
+    if args is None:
+        args = sys.argv[1:]
+
+    parser = _build_parser()
+    ns = parser.parse_args(args)
+
+    if ns.command == "bundle":
+        if ns.bundle_cmd == "pack":
+            packed = pack_workflow_bundle(
+                root_flow_json=ns.root,
+                out_path=ns.out,
+                bundle_id=ns.bundle_id,
+                bundle_version=ns.bundle_version,
+                flows_dir=ns.flows_dir,
+                entrypoints=list(ns.entrypoint) if isinstance(ns.entrypoint, list) and ns.entrypoint else None,
+            )
+            sys.stdout.write(str(packed.path) + "\n")
+            return 0
+
+        if ns.bundle_cmd == "inspect":
+            man = inspect_workflow_bundle(bundle_path=ns.bundle)
+            sys.stdout.write(json.dumps(workflow_bundle_manifest_to_dict(man), indent=2, ensure_ascii=False) + "\n")
+            return 0
+
+        if ns.bundle_cmd == "unpack":
+            out = unpack_workflow_bundle(bundle_path=ns.bundle, out_dir=ns.dir)
+            sys.stdout.write(str(out) + "\n")
+            return 0
+
+        parser.error("Missing bundle subcommand (pack|inspect|unpack)")
+
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+
+

abstractflow-0.3.1/abstractflow/compiler.py

@@ -0,0 +1,23 @@
+"""AbstractFlow compiler shim.
+
+AbstractFlow no longer owns workflow compilation semantics. The single source of
+truth for VisualFlow/Flow compilation lives in `abstractruntime.visualflow_compiler`.
+"""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.compiler import (
+    _create_visual_agent_effect_handler,
+    _sync_effect_results_to_node_outputs,
+    compile_flow,
+    compile_visualflow,
+    compile_visualflow_tree,
+)
+
+__all__ = [
+    "compile_flow",
+    "compile_visualflow",
+    "compile_visualflow_tree",
+    "_create_visual_agent_effect_handler",
+    "_sync_effect_results_to_node_outputs",
+]

abstractflow-0.3.1/abstractflow/core/flow.py

@@ -0,0 +1,11 @@
+"""Flow definition classes for AbstractFlow.
+
+This module is a thin re-export of AbstractRuntime's Flow IR so there is a
+single semantics + IR surface shared across hosts.
+"""
+
+from __future__ import annotations
+
+from abstractruntime.visualflow_compiler.flow import Flow, FlowEdge, FlowNode
+
+__all__ = ["Flow", "FlowNode", "FlowEdge"]