pyagentprolog-fona 0.1.0__tar.gz

pyagentprolog_fona-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrey Vorfolomeev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyagentprolog_fona-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: pyagentprolog-fona
+Version: 0.1.0
+Summary: Decorator-based framework for background AI agents on PyAgentProlog
+Author-email: Andrey Vorfolomeev <binom0x@proton.me>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.29
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.6
+Requires-Dist: transformers>=4.40
+Requires-Dist: huggingface_hub>=0.23
+Requires-Dist: pyagentprolog>=1.0.1
+Requires-Dist: pyagentprolog-hf>=1.0.2
+Provides-Extra: torch
+Requires-Dist: torch>=2.0; extra == "torch"
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=3.0; extra == "semantic"
+Provides-Extra: all
+Requires-Dist: torch>=2.0; extra == "all"
+Requires-Dist: sentence-transformers>=3.0; extra == "all"
+Dynamic: license-file
+
+# Fona
+
+**Minimalist framework for background AI agents on PyAgentProlog.**
+
+An agent is a Prolog program plus Python actions. It runs as an HTTP server with a chat UI and a REST API, can talk to users and to other agents, and can be launched from a dashboard.
+
+---
+
+## What it looks like
+
+```python
+from fona import agent
+
+@agent.action
+def now_iso():
+    import time
+    return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+
+@agent.program
+PROGRAM = r"""
+run :-
+    ui_print('Hello. Type "time" or "quit".'),
+    on_user_input.
+
+on_user_input :-
+    ui_read(Input),
+    (   Input == quit -> ui_print('Bye.')
+    ;   Input == time -> now_iso(T), ui_print(T), on_user_input
+    ;   ui_print('Unknown.'), on_user_input
+    ).
+"""
+
+if __name__ == '__main__':
+    agent.run(port=8000)
+```
+
+```bash
+python hello.py
+# open http://127.0.0.1:8000/
+```
+
+---
+
+## Install
+
+```bash
+pip install pyagentprolog-fona
+```
+
+Python 3.10+. `torch` / `sentence-transformers` are optional (`[torch]`, `[semantic]`, `[all]`).
+
+---
+
+## What you get
+
+- **`@agent.program`** — declare the agent's logic in Prolog.
+- **`@agent.action` / `@agent.effect` / `@agent.generate`** — expose Python functions as Prolog predicates.
+- **`agent.run()`** — serve a chat UI and a REST API (`/api/v1/query`, `/api/v1/ui/*`).
+- **Prolog-only inter-agent protocol** — peers call `/api/v1/query` with Prolog text; errors are `"err:..."` atoms, not exceptions.
+- **Declarative config** — `load_config(...)` reads env once, returns an immutable object.
+- **HF models** — `Agent.from_hub("user/repo")`; the user's `PROGRAM` is prepended to the model's program.
+- **Dashboard** — `python -m fona.dashboard`; a project is a folder holding `team.json`, `scripts/`, `logs/`.
+- **Orchestrator UI** — `python -m fona.orchestrator_app`; three-column view of goal, plan, chat, subordinates.
+- **Natural language ↔ Prolog** — optional `@agent.action` companions to the HITL loop, not part of the protocol.
+
+---
+
+## Documentation
+
+The full guide — architecture, decorators, HITL, inter-agent protocol, `query_one`, REST contract, HF cache, dashboard, orchestrator, security, testing, releases, known limitations — lives in [docs/guide.md](https://github.com/binom0x/pyagentprolog-fona/blob/main/doc/guide.md)
+
+Start there. This README intentionally does not duplicate it.
+
+---
+
+## Examples
+
+| File | Shows |
+|---|---|
+| `examples/hello.py` | smallest agent: `run/0` + `ui_print` |
+| `examples/server_agent.py` | facts server + `handle_request/2` (incoming) |
+| `examples/client_agent.py` | `call_peer/3` (outgoing) |
+| `examples/template_agent.py` | reference: HITL, peers, protocol, NL ↔ Prolog, `query_one` |
+| `examples/with_hf.py` | `Agent.from_hub` + prepended `PROGRAM` |
+
+---
+
+## Protocol in one paragraph
+
+Every agent can answer `POST /api/v1/query` with body `{"query": "<Prolog text>"}`. The response is `{"success": bool, "solutions": [{"Var": value}], "count": int}`. The recommended handler is `handle_request(Kind, Payload) -> str` with `Kind ∈ {ping, echo, status}`, extensible via `register_protocol(agent, extra={...})`. Outgoing calls use `call_peer(Peer, Query) -> "ok:<v>" | "err:<r>"`, registered by `register_peers(agent, CFG)`. Peers are configured via `FONA_PEERS="name=url,..."`. No special language, no special client — just Prolog over HTTP.
+
+---
+
+## Requirements
+
+- Core: `fastapi`, `uvicorn`, `httpx`, `pydantic`, `transformers`, `huggingface_hub`, `pyagentprolog`, `pyagentprolog-hf`.
+- Optional: `torch`, `sentence-transformers`.
+- For private HF models: `FONA_HF_TOKEN`.
+- For non-local bind: `FONA_TOKEN` (REST auth) — see §16 of the guide.
+
+---
+
+## Status
+
+`0.1.0` — in development. The public API and the inter-agent protocol are stable; the dashboard and orchestrator UI may change. Semver applies to `Agent`, `agent`, the decorators, and `load_config` / `register_*`.
+
+---
+
+## License
+
+See `LICENSE`.
+
+---
+
+**One line:** Fona lets you write an agent as a Prolog program plus Python actions, serve it over HTTP with a chat UI, and let it talk to other agents — all through one Prolog-only protocol. For everything else, read [docs/guide.md](https://github.com/binom0x/pyagentprolog-fona/blob/main/doc/guide.md)

pyagentprolog_fona-0.1.0/README.md

@@ -0,0 +1,115 @@
+# Fona
+
+**Minimalist framework for background AI agents on PyAgentProlog.**
+
+An agent is a Prolog program plus Python actions. It runs as an HTTP server with a chat UI and a REST API, can talk to users and to other agents, and can be launched from a dashboard.
+
+---
+
+## What it looks like
+
+```python
+from fona import agent
+
+@agent.action
+def now_iso():
+    import time
+    return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+
+@agent.program
+PROGRAM = r"""
+run :-
+    ui_print('Hello. Type "time" or "quit".'),
+    on_user_input.
+
+on_user_input :-
+    ui_read(Input),
+    (   Input == quit -> ui_print('Bye.')
+    ;   Input == time -> now_iso(T), ui_print(T), on_user_input
+    ;   ui_print('Unknown.'), on_user_input
+    ).
+"""
+
+if __name__ == '__main__':
+    agent.run(port=8000)
+```
+
+```bash
+python hello.py
+# open http://127.0.0.1:8000/
+```
+
+---
+
+## Install
+
+```bash
+pip install pyagentprolog-fona
+```
+
+Python 3.10+. `torch` / `sentence-transformers` are optional (`[torch]`, `[semantic]`, `[all]`).
+
+---
+
+## What you get
+
+- **`@agent.program`** — declare the agent's logic in Prolog.
+- **`@agent.action` / `@agent.effect` / `@agent.generate`** — expose Python functions as Prolog predicates.
+- **`agent.run()`** — serve a chat UI and a REST API (`/api/v1/query`, `/api/v1/ui/*`).
+- **Prolog-only inter-agent protocol** — peers call `/api/v1/query` with Prolog text; errors are `"err:..."` atoms, not exceptions.
+- **Declarative config** — `load_config(...)` reads env once, returns an immutable object.
+- **HF models** — `Agent.from_hub("user/repo")`; the user's `PROGRAM` is prepended to the model's program.
+- **Dashboard** — `python -m fona.dashboard`; a project is a folder holding `team.json`, `scripts/`, `logs/`.
+- **Orchestrator UI** — `python -m fona.orchestrator_app`; three-column view of goal, plan, chat, subordinates.
+- **Natural language ↔ Prolog** — optional `@agent.action` companions to the HITL loop, not part of the protocol.
+
+---
+
+## Documentation
+
+The full guide — architecture, decorators, HITL, inter-agent protocol, `query_one`, REST contract, HF cache, dashboard, orchestrator, security, testing, releases, known limitations — lives in [docs/guide.md](https://github.com/binom0x/pyagentprolog-fona/blob/main/doc/guide.md)
+
+Start there. This README intentionally does not duplicate it.
+
+---
+
+## Examples
+
+| File | Shows |
+|---|---|
+| `examples/hello.py` | smallest agent: `run/0` + `ui_print` |
+| `examples/server_agent.py` | facts server + `handle_request/2` (incoming) |
+| `examples/client_agent.py` | `call_peer/3` (outgoing) |
+| `examples/template_agent.py` | reference: HITL, peers, protocol, NL ↔ Prolog, `query_one` |
+| `examples/with_hf.py` | `Agent.from_hub` + prepended `PROGRAM` |
+
+---
+
+## Protocol in one paragraph
+
+Every agent can answer `POST /api/v1/query` with body `{"query": "<Prolog text>"}`. The response is `{"success": bool, "solutions": [{"Var": value}], "count": int}`. The recommended handler is `handle_request(Kind, Payload) -> str` with `Kind ∈ {ping, echo, status}`, extensible via `register_protocol(agent, extra={...})`. Outgoing calls use `call_peer(Peer, Query) -> "ok:<v>" | "err:<r>"`, registered by `register_peers(agent, CFG)`. Peers are configured via `FONA_PEERS="name=url,..."`. No special language, no special client — just Prolog over HTTP.
+
+---
+
+## Requirements
+
+- Core: `fastapi`, `uvicorn`, `httpx`, `pydantic`, `transformers`, `huggingface_hub`, `pyagentprolog`, `pyagentprolog-hf`.
+- Optional: `torch`, `sentence-transformers`.
+- For private HF models: `FONA_HF_TOKEN`.
+- For non-local bind: `FONA_TOKEN` (REST auth) — see §16 of the guide.
+
+---
+
+## Status
+
+`0.1.0` — in development. The public API and the inter-agent protocol are stable; the dashboard and orchestrator UI may change. Semver applies to `Agent`, `agent`, the decorators, and `load_config` / `register_*`.
+
+---
+
+## License
+
+See `LICENSE`.
+
+---
+
+**One line:** Fona lets you write an agent as a Prolog program plus Python actions, serve it over HTTP with a chat UI, and let it talk to other agents — all through one Prolog-only protocol. For everything else, read [docs/guide.md](https://github.com/binom0x/pyagentprolog-fona/blob/main/doc/guide.md)

pyagentprolog_fona-0.1.0/fona/__init__.py

@@ -0,0 +1,15 @@
+"""Fona — минималистичный фреймворк фоновых ИИ-агентов на PyAgentProlog."""
+from .agent import Agent, agent
+from .config import load_config, FonaConfig
+from .peers import call_peer, register_peers
+from .protocol import register_protocol
+from .team import team_resolver
+
+__all__ = [
+    'Agent', 'agent',
+    'load_config', 'FonaConfig',
+    'call_peer', 'register_peers',
+    'register_protocol',
+    'team_resolver',
+]
+__version__ = '0.1.0'