Files
WolfandClaude Opus 5.5 248ea1636d Bring in desk from news
The plugin contract, the model task and the tools roledesk imports, copied
rather than reached through an editable install of news, which also exposes
a package named pipeline. news stays the source of truth for desk.

Refreshed from news/desk at a275c38a1aa0fe80a7ec7dd5781ecccf683f71c6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 12:29:17 +02:00

34 lines
1.7 KiB
Python

"""The shared core: what any desk-shaped app is built from.
An app here is something that pulls things in from sources, runs work over
them as jobs, asks a model for the parts a model is good at, and shows the
result. newsdesk is the first one. A library of things added by hand and a
board of job postings are the next two, and they share everything in this
package and nothing outside it.
tools/ machinery with no opinion about the app: a model, an
encoder, an HTTP session, a video read as text
sources/ the plugin contract, the registry that finds plugins on
disk, and the built-in sources
models.py the shapes an app hands round — an item, a link — plus the
queue's own, re-exported from `pipeline.models`
modeltask.py a job that needs a model: chunk the batch, ask, apply the
answers, and give up on a row no model will settle rather
than paying for it every run
notices.py which failures newsdesk will interrupt you about, and the
sentence it uses. The queue's half of this is
`pipeline/notices.py`
config.py the settings sections an app composes into its own config
The job queue used to be `desk/pipeline/`. It is `pipeline/` at the top of
the repository now, one tree below this one, because it turned out to be the
part worth copying into other projects and a folder cannot be copied if it
imports the tree above it. `docs/pipeline-package.md` is why and how.
Nothing in here imports from an app. `tests/test_architecture.py` holds it
to that, and to one door per package: from outside, `desk.sources` is
imported by that name and nothing behind it.
"""
__version__ = "0.1.0"