abstractcode 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

abstractcode/workflow_cli.py

@@ -0,0 +1,229 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Optional
+
+
+def _gateway_api(*, gateway_url: Optional[str], gateway_token: Optional[str]):
+    from .gateway_cli import GatewayApi, default_gateway_token, default_gateway_url
+
+    url = str(gateway_url or "").strip() or default_gateway_url()
+    token_raw = str(gateway_token or "").strip()
+    token = token_raw if token_raw else default_gateway_token()
+    return GatewayApi(base_url=url, token=token)
+
+
+def install_workflow_bundle_command(
+    *,
+    source: str,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    overwrite: bool = False,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    try:
+        resp = api.upload_bundle(path=source, overwrite=bool(overwrite), reload=True)
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    out = dict(resp or {})
+    out.setdefault("gateway_url", str(getattr(api, "base_url", "") or ""))
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        bref = str(out.get("bundle_ref") or "").strip() or str(out.get("bundle_id") or "").strip() or "?"
+        print(f"Installed on gateway: {bref}")
+    return out
+
+
+def list_workflow_bundles_command(
+    *,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    interface: Optional[str] = None,
+    all_versions: bool = False,
+    include_deprecated: bool = False,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    try:
+        resp = api.list_bundles(all_versions=bool(all_versions), include_deprecated=bool(include_deprecated))
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    bundles_raw = resp.get("items") if isinstance(resp, dict) and isinstance(resp.get("items"), list) else []
+    items: list[dict[str, Any]] = []
+    for b in bundles_raw:
+        if not isinstance(b, dict):
+            continue
+        bid = str(b.get("bundle_id") or "").strip()
+        bver = str(b.get("bundle_version") or "").strip()
+        bref = str(b.get("bundle_ref") or "").strip() or (f"{bid}@{bver}" if bid and bver else bid)
+        eps_raw = b.get("entrypoints") if isinstance(b.get("entrypoints"), list) else []
+        default_fid = str(b.get("default_entrypoint") or "").strip()
+        implied_default = len(eps_raw) == 1
+        for ep in eps_raw:
+            if not isinstance(ep, dict):
+                continue
+            fid = str(ep.get("flow_id") or "").strip()
+            if not fid:
+                continue
+            deprecated = bool(ep.get("deprecated") is True)
+            interfaces = [str(x).strip() for x in list(ep.get("interfaces") or []) if isinstance(x, str) and x.strip()]
+            if interface and interface not in interfaces:
+                continue
+            items.append(
+                {
+                    "bundle_id": bid,
+                    "bundle_version": bver,
+                    "bundle_ref": bref,
+                    "workflow_id": f"{bref}:{fid}" if bref and fid else None,
+                    "flow_id": fid,
+                    "name": str(ep.get("name") or "") or fid,
+                    "description": str(ep.get("description") or "") or "",
+                    "interfaces": interfaces,
+                    "default": bool(implied_default or (default_fid and fid == default_fid)),
+                    "deprecated": bool(deprecated),
+                    "deprecated_reason": str(ep.get("deprecated_reason") or "") or "",
+                }
+            )
+
+    items.sort(key=lambda x: (str(x.get("bundle_id") or ""), str(x.get("bundle_version") or ""), str(x.get("flow_id") or "")))
+    out = {"ok": True, "gateway_url": str(getattr(api, "base_url", "") or ""), "count": len(items), "entrypoints": items}
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        if not items:
+            print("No workflows found on the gateway.")
+        for it in items:
+            name = it.get("name") or it.get("workflow_id") or ""
+            iface = ""
+            interfaces = it.get("interfaces") or []
+            if isinstance(interfaces, list) and interfaces:
+                iface = f" [{', '.join(interfaces)}]"
+            default = " *" if it.get("default") else ""
+            dep = " (deprecated)" if it.get("deprecated") else ""
+            wid = str(it.get("workflow_id") or it.get("bundle_ref") or "")
+            print(f"{wid}{default}{dep}  {name}{iface}")
+    return out
+
+
+def workflow_bundle_info_command(
+    *,
+    bundle_ref: str,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    ref = str(bundle_ref or "").strip()
+    if not ref:
+        return {"ok": False, "error": "bundle_ref is required"}
+    bid, ver = (ref.split("@", 1) + [""])[:2] if "@" in ref else (ref, "")
+    ver2 = ver.strip() or None
+    try:
+        resp = api.get_bundle(bundle_id=str(bid).strip(), bundle_version=ver2)
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    out = dict(resp or {})
+    out.setdefault("ok", True)
+    out.setdefault("gateway_url", str(getattr(api, "base_url", "") or ""))
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        bref = str(out.get("bundle_ref") or out.get("bundle_id") or "").strip()
+        print(bref or ref)
+        de = out.get("default_entrypoint")
+        if isinstance(de, str) and de.strip():
+            print(f"default: {de.strip()}")
+        eps = out.get("entrypoints") if isinstance(out.get("entrypoints"), list) else []
+        for ep in eps:
+            if not isinstance(ep, dict):
+                continue
+            fid = str(ep.get("flow_id") or "").strip()
+            name = str(ep.get("name") or "").strip() or fid
+            if fid:
+                print(f"- {fid}  {name}")
+    return out
+
+
+def remove_workflow_bundle_command(
+    *,
+    bundle_ref: str,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    try:
+        resp = api.remove_bundle(bundle_ref=str(bundle_ref or "").strip(), reload=True)
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    out = dict(resp or {})
+    out.setdefault("gateway_url", str(getattr(api, "base_url", "") or ""))
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        removed = out.get("removed")
+        bref = str(out.get("bundle_ref") or bundle_ref or "").strip() or "?"
+        print(f"Removed {removed} bundle(s) from gateway for {bref}")
+    return out
+
+
+def deprecate_workflow_bundle_command(
+    *,
+    bundle_id: str,
+    flow_id: Optional[str] = None,
+    reason: Optional[str] = None,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    bid = str(bundle_id or "").strip()
+    if not bid:
+        return {"ok": False, "error": "bundle_id is required"}
+    try:
+        resp = api.deprecate_bundle(bundle_id=bid, flow_id=flow_id, reason=reason)
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    out = dict(resp or {})
+    out.setdefault("gateway_url", str(getattr(api, "base_url", "") or ""))
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        fid = str(out.get("flow_id") or "").strip() or "*"
+        print(f"Deprecated on gateway: {bid}:{fid}")
+    return out
+
+
+def undeprecate_workflow_bundle_command(
+    *,
+    bundle_id: str,
+    flow_id: Optional[str] = None,
+    gateway_url: Optional[str] = None,
+    gateway_token: Optional[str] = None,
+    output_json: bool = False,
+) -> dict[str, Any]:
+    api = _gateway_api(gateway_url=gateway_url, gateway_token=gateway_token)
+    bid = str(bundle_id or "").strip()
+    if not bid:
+        return {"ok": False, "error": "bundle_id is required"}
+    try:
+        resp = api.undeprecate_bundle(bundle_id=bid, flow_id=flow_id)
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+    out = dict(resp or {})
+    out.setdefault("gateway_url", str(getattr(api, "base_url", "") or ""))
+    if output_json:
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        fid = str(out.get("flow_id") or "").strip() or "*"
+        removed = bool(out.get("removed") is True)
+        print(f"Undeprecated on gateway: {bid}:{fid} ({'changed' if removed else 'no-op'})")
+    return out

abstractcode-0.3.2.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: abstractcode
+Version: 0.3.2
+Summary: A clean terminal CLI for multi-agent agentic coding
+Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
+Maintainer-email: Laurent-Philippe Albou <contact@abstractcore.ai>
+License: MIT
+Project-URL: Homepage, https://abstractcore.ai
+Project-URL: Documentation, https://abstractcore.ai
+Project-URL: Repository, https://github.com/lpalbou/abstractcode
+Project-URL: Bug Tracker, https://github.com/lpalbou/abstractcode/issues
+Keywords: ai,llm,cli,coding,agent,multi-agent,agentic,terminal,abstractcore,abstractruntime,abstractagent
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: abstractagent>=0.2.0
+Requires-Dist: abstractruntime>=0.2.0
+Requires-Dist: abstractcore[tools]>=2.6.8
+Requires-Dist: ddgs<10.0.0,>=9.10.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: flow
+Requires-Dist: abstractflow>=0.1.0; extra == "flow"
+Dynamic: license-file
+
+# AbstractCode
+
+Durable terminal TUI for agentic coding on the Abstract* stack (**AbstractAgent + AbstractRuntime + AbstractCore**).
+
+Status: **pre-alpha** (APIs and UX may change).
+
+Next: [`docs/getting-started.md`](docs/getting-started.md).
+
+## Features
+
+- Interactive TUI (`abstractcode`) with **durable runs** (resume/pause/cancel), snapshots, and logs
+- **Approval-gated tools** by default (with an allowlist you can configure)
+- Built-in agents: `react`, `memact`, `codeact`
+- VisualFlow workflows:
+  - run locally: `abstractcode flow ...` (optional extra)
+  - run as an agent: `abstractcode --agent <flow_ref>`
+- Remote tool execution via **MCP** (`/mcp`, `/executor`)
+- Optional gateway-first Web UI in `web/`
+
+## Install
+
+Python: **3.10+**
+
+```bash
+pip install abstractcode
+```
+
+Optional (run VisualFlow locally via `abstractcode flow ...`):
+
+```bash
+pip install "abstractcode[flow]"
+```
+
+From source (development):
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quickstart (TUI)
+
+Ollama (default provider):
+
+```bash
+abstractcode --provider ollama --model qwen3:1.7b-q4_K_M
+```
+
+OpenAI-compatible server (e.g. LM Studio):
+
+```bash
+abstractcode --provider openai --base-url http://127.0.0.1:1234/v1 --model qwen/qwen3-next-80b
+```
+
+Inside the app:
+- `/help` shows the authoritative command list
+- type a task (or use `/task ...`)
+- tool approvals: `/auto-accept` (or start with `--auto-approve`)
+- attach files with `@path/to/file` in your prompt
+
+## Persistence (durable runs)
+
+Default paths:
+- state file: `~/.abstractcode/state.json`
+- durable stores: `~/.abstractcode/state.d/`
+- saved settings: `~/.abstractcode/state.config.json`
+
+Disable persistence:
+
+```bash
+abstractcode --no-state
+```
+
+## Workflows
+
+- Local runs: `abstractcode flow run <flow_id_or_path> ...` (requires `abstractcode[flow]`)
+- Workflow agent: `abstractcode --agent /path/to/workflow.json ...`
+- Remote control-plane: `abstractcode gateway --help`
+- Bundle management on a gateway: `abstractcode workflow --help`
+
+Details: [`docs/workflows.md`](docs/workflows.md).
+
+## Web UI
+
+The web host lives in `web/` and connects to an `abstractgateway` at `/api/gateway/*`.
+
+Start here:
+- [`docs/web.md`](docs/web.md)
+- [`docs/deployment-web.md`](docs/deployment-web.md)
+
+## Documentation
+
+- Start here: [`docs/getting-started.md`](docs/getting-started.md)
+- FAQ: [`docs/faq.md`](docs/faq.md)
+- Docs index: [`docs/README.md`](docs/README.md)
+- [`docs/architecture.md`](docs/architecture.md)
+- [`docs/cli.md`](docs/cli.md)
+- [`docs/api.md`](docs/api.md)
+- [`docs/workflows.md`](docs/workflows.md)
+- [`docs/ui_events.md`](docs/ui_events.md)
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest -q
+ruff check .
+black .
+```
+
+## Project
+
+- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
+- Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+- Security: [`SECURITY.md`](SECURITY.md)
+- Acknowledgments: [`ACKNOWLEDMENTS.md`](ACKNOWLEDMENTS.md)
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).

abstractcode-0.3.2.dist-info/RECORD

@@ -0,0 +1,21 @@
+abstractcode/__init__.py,sha256=O-DbZctdBATghwjZUCeHBYwe84a5wuRK6cd4z3kkyzg,658
+abstractcode/cli.py,sha256=sDpKTREeRGWcXyFwnVEZLBuLQcpD4WuOnGU9nTx6SMU,44440
+abstractcode/file_mentions.py,sha256=KFtFX_Ofjk_9r9Nirt1IXKLWr1VsSrXimHnRYxxvRYs,8664
+abstractcode/flow_cli.py,sha256=CQq1g4rFylSW7y8ZZeQYmfroAXG1dDtmuOF8tc1BF2Y,49235
+abstractcode/fullscreen_ui.py,sha256=rcYETwA5nMFNE1cNgIDTF3zUFLlqtJoveQ2W6feR7Ao,117536
+abstractcode/gateway_cli.py,sha256=ajAYI0IUK3FBAVx5HdDh_zThyU7-tABre8meAUuO_cU,25251
+abstractcode/input_handler.py,sha256=W2ImW4Yr3HMMD5SNPZOZJendVL-CRdYR5idXTWroxAY,2240
+abstractcode/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+abstractcode/react_shell.py,sha256=lgydDok2ZgNwVDForvAYT9MxVYk7SiVmuUFMnYEOpvg,387224
+abstractcode/recall.py,sha256=xu-xz8-kvkmAW6pKoAIcwox5jHWMBfBKExsA8fgwg_A,13040
+abstractcode/remember.py,sha256=cmJlw-nR0OvK7tkN5B0sZSMaYlECl_tAyO34c-IL0Uo,6158
+abstractcode/terminal_markdown.py,sha256=mL3YdBZt25DoJec23EXgve2zH4OMDJLxBnQfWvsSSh0,21465
+abstractcode/theme.py,sha256=WWlMsbqIj4Z-jylOTnmV_zTirf87tdbrlrRsIaTBfQE,6689
+abstractcode/workflow_agent.py,sha256=J8pw7r79lJZ58aqMXsRTabbgxEJzIlJHb8__oUPg_08,56744
+abstractcode/workflow_cli.py,sha256=gabA7RzPe9-qkI3MSaRCrxErWeCl1faRa-oTGULxp_w,8936
+abstractcode-0.3.2.dist-info/licenses/LICENSE,sha256=f8z-PbFM_xH0eqLsha8_nEg1jbm1eVtC2NNjtXhtuCo,1080
+abstractcode-0.3.2.dist-info/METADATA,sha256=_gu5zFXrd6aZScr8oUGK_9mz0YNwPDsLQABJB-mK5dE,4657
+abstractcode-0.3.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+abstractcode-0.3.2.dist-info/entry_points.txt,sha256=M4AOKb4h2vKWy5OMg-czeJE2aXunVKlljUPN8BUtwoE,51
+abstractcode-0.3.2.dist-info/top_level.txt,sha256=n9Hfv6cnmL55HoxXsA3V1YLbQxYAr58-UMLbdr-FCNw,13
+abstractcode-0.3.2.dist-info/RECORD,,

{abstractcode-0.3.0.dist-info → abstractcode-0.3.2.dist-info}/WHEEL

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

abstractcode-0.3.0.dist-info/METADATA

@@ -1,270 +0,0 @@
-Metadata-Version: 2.4
-Name: abstractcode
-Version: 0.3.0
-Summary: A clean terminal CLI for multi-agent agentic coding
-Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
-Maintainer-email: Laurent-Philippe Albou <contact@abstractcore.ai>
-License: MIT
-Project-URL: Homepage, https://abstractcore.ai
-Project-URL: Documentation, https://abstractcore.ai
-Project-URL: Repository, https://github.com/lpalbou/abstractcode
-Project-URL: Bug Tracker, https://github.com/lpalbou/abstractcode/issues
-Keywords: ai,llm,cli,coding,agent,multi-agent,agentic,terminal,abstractcore,abstractruntime,abstractagent
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-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 :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: abstractagent>=0.2.0
-Requires-Dist: abstractruntime>=0.2.0
-Requires-Dist: abstractcore[tools]>=2.6.8
-Requires-Dist: ddgs<10.0.0,>=9.10.0
-Requires-Dist: prompt_toolkit>=3.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Provides-Extra: flow
-Requires-Dist: abstractflow>=0.1.0; extra == "flow"
-Dynamic: license-file
-
-# AbstractCode
-
-Terminal TUI for the AbstractFramework:
-- run **agents** (ReAct / CodeAct)
-- run **workflows** authored in AbstractFlow (VisualFlow JSON)
-- keep everything **durable** via AbstractRuntime (runs, ledger, artifacts)
-
-## Install
-
-```bash
-pip install abstractcode
-```
-
-To run AbstractFlow workflows from AbstractCode:
-
-```bash
-pip install "abstractcode[flow]"
-```
-
-## Start the TUI (Agents)
-
-```bash
-abstractcode --provider lmstudio --model qwen/qwen3-next-80b
-```
-
-Interaction model:
-- commands are slash-prefixed (`/help`)
-- any non-command line starts a task (same as `/task ...`)
-
-### Useful commands
-- `/status` (run status)
-- `/auto-accept on|off` (tool approvals)
-- `/max-tokens N` (or `-1` auto-detect)
-- `/compact [light|standard|heavy] [--preserve N] [focus...]` (durable compaction)
-- `/spans`, `/expand <span> [--show] [--into-context]` (provenance recall)
-- `/recall [--since ISO] [--until ISO] [--tag k=v] [--q text] [--into-context]`
-- `/snapshot save|load|list`
-
-### Persistence
-By default, AbstractCode uses `~/.abstractcode/state.json` and stores the durable data in `~/.abstractcode/state.d/`.
-- disable persistence: `abstractcode --no-state`
-- override path: `ABSTRACTCODE_STATE_FILE=... abstractcode`
-
-## Workflow Agents (VisualFlow as `--agent`)
-
-AbstractCode can run an AbstractFlow VisualFlow workflow *as an agent* (instead of using the built-in `react|codeact|memact` agents).
-
-### Requirements (`abstractcode.agent.v1`)
-- The workflow JSON must declare: `interfaces: ["abstractcode.agent.v1"]`
-- The workflow must expose these pins:
-  - `On Flow Start`: output pins:
-    - `request` (type `string`)
-    - `provider` (type `provider`)
-    - `model` (type `model`)
-    - `tools` (type `tools`)
-  - `On Flow End`: input pin `response` (type `string`)
-
-Recommended (optional) pins:
-- `On Flow Start`: `context` (object), `max_iterations` (number)
-- `On Flow End`: `meta` (object), `scratchpad` (object), `raw_result` (object)
-
-### Authoring in the AbstractFlow visual editor
-- **Mark the interface**: click `📂 Load` → select the workflow → in the right preview panel find **Interfaces** → click the ✏️ icon → enable **AbstractCode Agent (v1)** → **Save Interfaces**
-- **Pins are scaffolded automatically**: when the interface is enabled, AbstractFlow will ensure `On Flow Start` and `On Flow End` have the required pins. You can still add/remove optional pins as needed.
-
-Tip: an example workflow is shipped at `abstractflow/web/flows/acagent01.json` (implements the interface).
-
-### What is `meta` and how do I use it?
-`On Flow End.meta` is an **optional JSON object** for host-facing metadata (usage, trace ids, warnings, raw provider info, etc.).
-
-It is intentionally **not strictly validated** today (the host treats it as opaque JSON). To make workflows portable and predictable across hosts, we recommend using a small “envelope” shape:
-
-```json
-{
-  "schema": "abstractcode.agent.v1.meta",
-  "version": 1,
-  "provider": "lmstudio",
-  "model": "qwen/qwen3-next-80b",
-  "usage": { "input_tokens": 123, "output_tokens": 456 },
-  "trace": { "trace_id": "..." },
-  "warnings": ["..."],
-  "debug": {}
-}
-```
-
-Hosts should treat unknown fields as allowed and ignore what they don’t understand (forward-compatible).
-
-Typical ways to produce it inside a workflow:
-- Wire `LLM Call.result` (object) → `On Flow End.meta`
-- Wire `Agent.result` (object) → `On Flow End.meta`
-- Or build your own object and wire it into `meta`
-
-When present, AbstractCode attaches it to the assistant message metadata as `workflow_meta`.
-
-### Workflow-driven status updates (footer / live UX)
-Inside a workflow, you can update AbstractCode’s footer status text by emitting the reserved event:
-- Add an **Emit Event** node
-- Set **name** to `abstractcode.status`
-- Set **payload** to:
-  - a string (e.g. `"Enrich Query..."`), or
-  - an object like `{ "text": "Enrich Query...", "duration": -1 }`
-
-`duration` is seconds:
-- default: `-1` (sticky)
-- if `> 0`: auto-clears after the timeout unless superseded by a newer status
-
-Example workflow: `abstractflow/web/flows/acagent_status_demo.json` (3 status updates, each separated by a 2s Delay).
-
-### Workflow-driven UI events (messages + tool UX)
-Workflows can also emit additional reserved events for host UX:
-- `abstractcode.message`: show a message/notification (payload is a string or `{text, level?, title?}`)
-- `abstractcode.tool_execution`: render a tool-call block (payload is a tool call object or a list)
-  - recommended shape: `{name, arguments, call_id?}`
-- `abstractcode.tool_result`: render a tool-result block (payload is a tool result object or a list)
-  - recommended shape: `{name, call_id?, success?, output?, error?}`
-
-Full contract (recommended for integrators): `docs/ui_events.md`
-
-Example workflows:
-- `abstractflow/web/flows/acagent_message_demo.json`
-- `abstractflow/web/flows/acagent_tool_events_demo.json`
-
-### Durable ask+wait (prompt the user and resume)
-For workflows that need human input, you can:
-- use the **Ask User** node (WAIT_USER), or
-- use **Wait Event** with a `prompt` field (WAIT_EVENT), which is also durable and network-friendly.
-
-Example workflow: `abstractflow/web/flows/acagent_ask_demo.json`
-
-### Run
-Use `--agent` with a workflow id/name (from the flows directory) or a direct JSON path:
-
-```bash
-abstractcode --agent acagent01
-abstractcode --agent abstractflow/web/flows/acagent01.json
-
-# If your flows are stored elsewhere:
-ABSTRACTFLOW_FLOWS_DIR=/path/to/flows abstractcode --agent my_flow_id
-```
-
-## Run Workflows (AbstractFlow VisualFlow)
-
-### From the CLI
-
-```bash
-abstractcode flow run <flow_id_or_path> [inputs...]
-```
-
-Inputs can be passed as flags (no JSON typing required):
-
-```bash
-abstractcode flow run abstractflow/web/flows/4e2f2329.json --query "who are you?"
-
-abstractcode flow run abstractflow/web/flows/b3a9d7c1.json \
-  --query "who are you?" \
-  --max_web_search 15 \
-  --max_fetch_url 50 \
-  --follow_up_questions true
-```
-
-Other input options:
-
-```bash
-abstractcode flow run deep-research-pro --input-json-file params.json
-abstractcode flow run deep-research-pro --param max_web_search=15 --param follow_up_questions=true
-```
-
-Tool approvals:
-- approval-gated by default (type `a` once to approve all remaining calls for that run)
-- auto-approve (unsafe): `--accept-tools` (alias `--auto-approve`)
-
-Controls:
-
-```bash
-abstractcode flow resume
-abstractcode flow pause
-abstractcode flow resume-run
-abstractcode flow cancel
-```
-
-Run discovery and event injection:
-
-```bash
-abstractcode flow runs
-abstractcode flow attach <run_id>
-abstractcode flow emit --name my_event --scope session --payload-json '{"k":"v"}'
-```
-
-Flow state:
-- default: `~/.abstractcode/flow_state.json` (stores in `~/.abstractcode/flow_state.d/`)
-- override with `ABSTRACTCODE_FLOW_STATE_FILE=...`
-- flow discovery default dir: `ABSTRACTFLOW_FLOWS_DIR=...`
-
-### From inside the TUI (keeps outputs in context)
-
-```text
-/flow run deep-research-pro --query "..." --max_web_search 10 --follow_up_questions true
-```
-
-`ANSWER_USER` outputs from the workflow are appended into the current conversation’s active context so you can continue the dialogue naturally.
-
-## Development (Monorepo)
-
-```bash
-pip install -e ./abstractcore -e ./abstractruntime -e ./abstractagent -e ./abstractflow -e ./abstractcode
-abstractcode --help
-```
-
-## Environment variables
-- `ABSTRACTCODE_STATE_FILE`
-- `ABSTRACTCODE_FLOW_STATE_FILE`
-- `ABSTRACTFLOW_FLOWS_DIR`
-
-## Default Tools
-
-AbstractCode provides a curated set of 10 tools for coding tasks (ReAct agent):
-
-| Tool | Description |
-|------|-------------|
-| `list_files` | Find and list files using glob patterns (case-insensitive) |
-| `search_files` | Search for text patterns inside files using regex |
-| `analyze_code` | Outline a Python/JS file (imports/classes/functions + line ranges) |
-| `read_file` | Read file contents with optional line range |
-| `write_file` | Write content to files, creating directories as needed |
-| `edit_file` | Edit files by replacing text patterns (supports regex, line ranges, preview mode) |
-| `execute_command` | Execute shell commands with security controls |
-| `web_search` | Search the web via DuckDuckGo (no API key required) |
-| `fetch_url` | Fetch a URL and return text/metadata (best-effort parsing) |
-| `self_improve` | Log improvement suggestions for later review |
-
-When running `--agent codeact`, AbstractCode exposes `execute_python` instead of the ReAct toolset.