lyrenth-agents 0.1.0__tar.gz

lyrenth_agents-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+build/
+dist/
+*.egg-info/
+.venv/
+.pytest_cache/
+.env

lyrenth_agents-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksma AI, Inc.
+
+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.

lyrenth_agents-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.5
+Name: lyrenth-agents
+Version: 0.1.0
+Summary: A library of small agents that read the web through Lyrenth: pick a recipe, give it URLs, get a cited answer.
+Project-URL: Homepage, https://lyrenth.com
+Project-URL: Documentation, https://lyrenth.com/docs/quickstart
+Author: Lyrenth
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,aidocument,citations,llm,lyrenth,prompt,recipes,web
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: lyrenth>=0.1.1
+Description-Content-Type: text/markdown
+
+# lyrenth-agents
+
+Ten agents that read the web and finish the job.
+
+Give one a few URLs and it hands back the thing you actually wanted: a
+comparison table, a brief on a company, the answer to a documentation
+question with the heading it came from, a sheet you open in Excel. Every
+claim carries the number of the page it came from, and every page that
+could not be read is named with the reason.
+
+The reading goes through [Lyrenth](https://lyrenth.com), which serves each
+page as clean text instead of HTML, so the pages arrive without the menus,
+banners, scripts and markup.
+
+```bash
+export LYRENTH_API_KEY=...        # free key: https://lyrenth.com/signup
+
+uvx lyrenth-agents compare \
+  https://en.wikipedia.org/wiki/PostgreSQL \
+  https://en.wikipedia.org/wiki/MySQL
+```
+
+With that key alone, the agent reads the pages and prints the finished
+prompt with its numbered sources, ready to paste into whichever assistant
+you already use. Point it at a model and it answers on its own:
+
+```bash
+export LLM_BASE_URL=https://api.example.com/v1   # any OpenAI-compatible endpoint
+export LLM_MODEL=your-model-name
+export LLM_API_KEY=...
+```
+
+## The ten
+
+| Command | Give it | Get back |
+|---|---|---|
+| `compare` | Two or more product pages | One table of what is actually different |
+| `brief` | A company's own pages | What they do, who they sell to, and what their pages never answer |
+| `answers -q "..."` | The documentation that should hold the answer | The answer with the page and heading behind every line |
+| `research -q "..."` | The pages you trust | Plain prose with a number on every claim |
+| `summarise` | A long article | What it claims, what that rests on, what it leaves out |
+| `extract` | Several pages of the same kind | One row per page, a column for every shared field |
+| `terms` | A terms page or a privacy policy | What you agree to, what data is taken, what happens in a dispute |
+| `people` | A team page and a careers page | Who the pages name, and what the company is hiring for |
+| `integrations` | The pages that say what a product connects to | The tools, grouped, and how firmly each one is claimed |
+| `digest` | The last few days of articles | What happened, what is new, where the sources disagree |
+
+`lyrenth-agents --list` prints the same list with an example command for
+each one. Every agent also has a page at
+[lyrenth.com/agents](https://lyrenth.com/agents) showing a real run.
+
+## A real run
+
+Against the live API on 21 September 2026, unedited. The progress lines go
+to stderr, the answer to stdout.
+
+```text
+$ uvx lyrenth-agents compare https://en.wikipedia.org/wiki/PostgreSQL https://en.wikipedia.org/wiki/MySQL
+recipe   compare: Product comparison
+read [1] PostgreSQL - Wikipedia  30,000 tokens  https://en.wikipedia.org/wiki/PostgreSQL
+read [2] MySQL - Wikipedia  30,000 tokens  https://en.wikipedia.org/wiki/MySQL
+context  60,000 tokens from 2 sources (raw HTML would be 412,333)
+
+| Feature | PostgreSQL | MySQL |
+| :--- | :--- | :--- |
+| Software Type | Free and open-source object relational database management system [1] | free and open-source relational database management system (RDBMS) [2] |
+| License | PostgreSQL License (free and open-source, permissive) [1] | GPLv2 or proprietary [2] |
+| Developer | PostgreSQL Global Development Group [1] | Oracle Corporation [2] |
+| Initial Release | 8 July 1996; 30 years ago (1996-07-08) [1] | 23 May 1995; 31 years ago (1995-05-23) [2] |
+| Stable Release | 18.6 / 13 August 2026 [1] | 26.7.0 / 28 July 2026 [2] |
+| Written In | C (and C++ for the LLVM dependency) [1] | C, C++ [2] |
+...
+```
+
+Two encyclopedia articles that weigh 412,333 tokens as raw HTML arrived as
+60,000 tokens of text, and the answer cites which of the two every cell
+came from.
+
+## What it does with the pages
+
+1. **Reads text, not markup.** Each page arrives as an AIDocument: the
+   content, its canonical URL, when it was read, and what it costs in
+   tokens.
+2. **Shares the budget between the pages.** Every page gets an equal share
+   and a short page gives its leftover back to the long ones, so a
+   comparison never comes back with one product filled in and the other
+   column empty.
+3. **Reads each page once.** A mobile copy, a tracking parameter or an old
+   redirect resolves to the same canonical URL and is dropped as a
+   duplicate.
+4. **Keeps provenance.** Title, canonical URL and read time go into the
+   prompt with the source number, which is what makes the citations
+   checkable.
+5. **Fails out loud.** A page that could not be read is listed with the
+   reason, and a citation pointing at a source number that does not exist
+   is flagged.
+
+## Write your own
+
+A recipe is data: the instructions for the model and the shape of the
+output. Register one and it runs on the same engine.
+
+```python
+from lyrenth_agents import Recipe, get, register, run
+
+register(
+    Recipe(
+        slug="changelog",
+        name="Release notes",
+        category="content",
+        tagline="Turn release pages into one list of what changed.",
+        what_you_give="The release or changelog pages, newest first.",
+        what_you_get="One list of changes, newest first, with the page each came from.",
+        system_prompt="You read release pages and list what changed...",
+        output_hint="One list, newest first, with a source number on every line.",
+        example_urls=["https://example.com/releases"],
+    )
+)
+
+result = run(get("changelog"), ["https://example.com/releases"])
+print(result.answer or result.prompt)
+```
+
+## Options
+
+| Flag | What it does |
+|---|---|
+| `--list` | The recipes, with an example command for each |
+| `-q`, `--question` | What to ask of the pages (`answers` and `research` need one) |
+| `--sources-only` | Print the numbered sources and stop |
+| `--json` | The whole result as JSON, including the prompt |
+| `--budget` | Token budget for all the pages together |
+| `--fresh` | Ask Lyrenth for a fresh fetch instead of the stored page |
+| `--model-url`, `--model` | The model endpoint, instead of the environment |
+
+## Licence
+
+MIT. See [LICENSE](LICENSE).

lyrenth_agents-0.1.0/README.md

@@ -0,0 +1,138 @@
+# lyrenth-agents
+
+Ten agents that read the web and finish the job.
+
+Give one a few URLs and it hands back the thing you actually wanted: a
+comparison table, a brief on a company, the answer to a documentation
+question with the heading it came from, a sheet you open in Excel. Every
+claim carries the number of the page it came from, and every page that
+could not be read is named with the reason.
+
+The reading goes through [Lyrenth](https://lyrenth.com), which serves each
+page as clean text instead of HTML, so the pages arrive without the menus,
+banners, scripts and markup.
+
+```bash
+export LYRENTH_API_KEY=...        # free key: https://lyrenth.com/signup
+
+uvx lyrenth-agents compare \
+  https://en.wikipedia.org/wiki/PostgreSQL \
+  https://en.wikipedia.org/wiki/MySQL
+```
+
+With that key alone, the agent reads the pages and prints the finished
+prompt with its numbered sources, ready to paste into whichever assistant
+you already use. Point it at a model and it answers on its own:
+
+```bash
+export LLM_BASE_URL=https://api.example.com/v1   # any OpenAI-compatible endpoint
+export LLM_MODEL=your-model-name
+export LLM_API_KEY=...
+```
+
+## The ten
+
+| Command | Give it | Get back |
+|---|---|---|
+| `compare` | Two or more product pages | One table of what is actually different |
+| `brief` | A company's own pages | What they do, who they sell to, and what their pages never answer |
+| `answers -q "..."` | The documentation that should hold the answer | The answer with the page and heading behind every line |
+| `research -q "..."` | The pages you trust | Plain prose with a number on every claim |
+| `summarise` | A long article | What it claims, what that rests on, what it leaves out |
+| `extract` | Several pages of the same kind | One row per page, a column for every shared field |
+| `terms` | A terms page or a privacy policy | What you agree to, what data is taken, what happens in a dispute |
+| `people` | A team page and a careers page | Who the pages name, and what the company is hiring for |
+| `integrations` | The pages that say what a product connects to | The tools, grouped, and how firmly each one is claimed |
+| `digest` | The last few days of articles | What happened, what is new, where the sources disagree |
+
+`lyrenth-agents --list` prints the same list with an example command for
+each one. Every agent also has a page at
+[lyrenth.com/agents](https://lyrenth.com/agents) showing a real run.
+
+## A real run
+
+Against the live API on 21 September 2026, unedited. The progress lines go
+to stderr, the answer to stdout.
+
+```text
+$ uvx lyrenth-agents compare https://en.wikipedia.org/wiki/PostgreSQL https://en.wikipedia.org/wiki/MySQL
+recipe   compare: Product comparison
+read [1] PostgreSQL - Wikipedia  30,000 tokens  https://en.wikipedia.org/wiki/PostgreSQL
+read [2] MySQL - Wikipedia  30,000 tokens  https://en.wikipedia.org/wiki/MySQL
+context  60,000 tokens from 2 sources (raw HTML would be 412,333)
+
+| Feature | PostgreSQL | MySQL |
+| :--- | :--- | :--- |
+| Software Type | Free and open-source object relational database management system [1] | free and open-source relational database management system (RDBMS) [2] |
+| License | PostgreSQL License (free and open-source, permissive) [1] | GPLv2 or proprietary [2] |
+| Developer | PostgreSQL Global Development Group [1] | Oracle Corporation [2] |
+| Initial Release | 8 July 1996; 30 years ago (1996-07-08) [1] | 23 May 1995; 31 years ago (1995-05-23) [2] |
+| Stable Release | 18.6 / 13 August 2026 [1] | 26.7.0 / 28 July 2026 [2] |
+| Written In | C (and C++ for the LLVM dependency) [1] | C, C++ [2] |
+...
+```
+
+Two encyclopedia articles that weigh 412,333 tokens as raw HTML arrived as
+60,000 tokens of text, and the answer cites which of the two every cell
+came from.
+
+## What it does with the pages
+
+1. **Reads text, not markup.** Each page arrives as an AIDocument: the
+   content, its canonical URL, when it was read, and what it costs in
+   tokens.
+2. **Shares the budget between the pages.** Every page gets an equal share
+   and a short page gives its leftover back to the long ones, so a
+   comparison never comes back with one product filled in and the other
+   column empty.
+3. **Reads each page once.** A mobile copy, a tracking parameter or an old
+   redirect resolves to the same canonical URL and is dropped as a
+   duplicate.
+4. **Keeps provenance.** Title, canonical URL and read time go into the
+   prompt with the source number, which is what makes the citations
+   checkable.
+5. **Fails out loud.** A page that could not be read is listed with the
+   reason, and a citation pointing at a source number that does not exist
+   is flagged.
+
+## Write your own
+
+A recipe is data: the instructions for the model and the shape of the
+output. Register one and it runs on the same engine.
+
+```python
+from lyrenth_agents import Recipe, get, register, run
+
+register(
+    Recipe(
+        slug="changelog",
+        name="Release notes",
+        category="content",
+        tagline="Turn release pages into one list of what changed.",
+        what_you_give="The release or changelog pages, newest first.",
+        what_you_get="One list of changes, newest first, with the page each came from.",
+        system_prompt="You read release pages and list what changed...",
+        output_hint="One list, newest first, with a source number on every line.",
+        example_urls=["https://example.com/releases"],
+    )
+)
+
+result = run(get("changelog"), ["https://example.com/releases"])
+print(result.answer or result.prompt)
+```
+
+## Options
+
+| Flag | What it does |
+|---|---|
+| `--list` | The recipes, with an example command for each |
+| `-q`, `--question` | What to ask of the pages (`answers` and `research` need one) |
+| `--sources-only` | Print the numbered sources and stop |
+| `--json` | The whole result as JSON, including the prompt |
+| `--budget` | Token budget for all the pages together |
+| `--fresh` | Ask Lyrenth for a fresh fetch instead of the stored page |
+| `--model-url`, `--model` | The model endpoint, instead of the environment |
+
+## Licence
+
+MIT. See [LICENSE](LICENSE).

lyrenth_agents-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lyrenth-agents"
+version = "0.1.0"
+description = "A library of small agents that read the web through Lyrenth: pick a recipe, give it URLs, get a cited answer."
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "Lyrenth" }]
+keywords = ["agents", "recipes", "citations", "llm", "web", "lyrenth", "aidocument", "prompt"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Environment :: Console",
+]
+dependencies = ["lyrenth>=0.1.1"]
+readme = "README.md"
+
+[project.scripts]
+lyrenth-agents = "lyrenth_agents.cli:main"
+
+[project.urls]
+Homepage = "https://lyrenth.com"
+Documentation = "https://lyrenth.com/docs/quickstart"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lyrenth_agents"]

lyrenth_agents-0.1.0/src/lyrenth_agents/__init__.py

@@ -0,0 +1,72 @@
+"""A library of small agents that read the web through Lyrenth.
+
+One engine, many recipes. A recipe is data: the instructions for the model and
+the shape of the output. The engine reads the pages, numbers them so they can
+be cited, and either asks a model or hands you the finished prompt.
+
+    from lyrenth_agents import get, run
+
+    result = run(get("some-recipe"), ["https://example.com/page"])
+    print(result.answer or result.prompt)
+
+Reading goes through Lyrenth (LYRENTH_API_KEY, free key at
+https://lyrenth.com/signup). A model is optional: with none configured,
+`result.answer` is None and `result.prompt` holds the finished prompt, ready
+to paste into any assistant. Configure one with LLM_BASE_URL and LLM_MODEL
+(any OpenAI-compatible endpoint) to have the engine answer directly.
+"""
+
+__version__ = "0.1.0"
+
+from .engine import (  # noqa: E402
+    AgentResult,
+    Gathered,
+    ModelError,
+    Skipped,
+    Source,
+    answer_into,
+    build_messages,
+    build_prompt,
+    build_sources_block,
+    call_model,
+    check_citations,
+    gather,
+    model_is_configured,
+    read_for,
+    run,
+)
+from .recipes import (  # noqa: E402
+    REGISTRY,
+    Recipe,
+    UnknownRecipe,
+    all_recipes,
+    get,
+    load_error,
+    register,
+)
+
+__all__ = [
+    "AgentResult",
+    "Gathered",
+    "ModelError",
+    "REGISTRY",
+    "Recipe",
+    "Skipped",
+    "Source",
+    "UnknownRecipe",
+    "all_recipes",
+    "answer_into",
+    "build_messages",
+    "build_prompt",
+    "build_sources_block",
+    "call_model",
+    "check_citations",
+    "gather",
+    "get",
+    "load_error",
+    "model_is_configured",
+    "read_for",
+    "register",
+    "run",
+    "__version__",
+]