awrun 0.2.2__tar.gz → 0.2.4__tar.gz

{awrun-0.2.2 → awrun-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awrun
-Version: 0.2.2
+Version: 0.2.4
 Summary: A priority-aware queue and dispatcher for agentic runs and ad-hoc CI builds — real dynamic priority for the class of work we control, instead of GitHub Actions' opaque FIFO.
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/Aitherium/awrun
@@ -33,7 +33,7 @@ Dynamic: license-file
 
 **[Docs](https://aitherium.github.io/awrun/)**  ·  [Source](https://github.com/Aitherium/awrun)  ·  `pip install awrun`  ·  [The Aither World](https://aitherium.github.io/)
 
-> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 55 bricks — each installs on its own, runs offline, and needs no account.
+> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 65 bricks — each installs on its own, runs offline, and needs no account.
 >
 > **Start here:** Queue two runs at different priorities and watch the urgent one overtake.
 
@@ -225,6 +225,7 @@ Each installs on its own, works offline, and needs no account.
 | [awgraph](https://github.com/Aitherium/awgraph) | that grep found everything | an AST + tree-sitter call graph an agent can traverse |
 | [awgit](https://github.com/Aitherium/awgit) | that no one else is editing this file | a lease, refused at commit time if you do not hold it |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | one agent's confident take on a decision | the round trace, the anonymity, and who dissents |
+| [awclassify](https://github.com/Aitherium/awclassify) | a filename, a folder, or whoever last touched it | doc_type, visibility, audience and topics, with the evidence lines that decided each |
 | [awtoll](https://github.com/Aitherium/awtoll) | that your tooling is saving you context | the measured token cost of each tool call, and what the alternative cost |
 | [awseal](https://github.com/Aitherium/awseal) | that the artifact came from who you think | an Ed25519 seal — the key that verifies is not the key that forges |
 | [awshare](https://github.com/Aitherium/awshare) | that the download is intact | content-addressed bundles, verified on fetch |
@@ -237,11 +238,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrelay](https://github.com/Aitherium/awrelay) | a SaaS in the middle of your agents | findings, alerts and coordination over your own transport |
 | [awask](https://github.com/Aitherium/awask) | that anyone read the paragraph where you asked | the ask itself, with a button that steers the session that raised it |
 | [awmail](https://github.com/Aitherium/awmail) | a mailbox somebody else can read | mail your agents send and receive over your own server |
+| [awswarm](https://github.com/Aitherium/awswarm) | that a model either fits your GPU or it doesn't run at all | a placement plan and an acquisition-probability estimate before you spend on a run |
 | [awfind](https://github.com/Aitherium/awfind) | one vendor's idea of the web | results from whichever providers you configured |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | that the page said what you were told | the render, the DOM and the requests it made |
 | [awvoice](https://github.com/Aitherium/awvoice) | that a cloud vendor may hold your audio | a transcript and a wav from a service you host |
 | [awvision](https://github.com/Aitherium/awvision) | a filename and a caption somebody wrote | what a model actually reports about the pixels |
 | [awscreen](https://github.com/Aitherium/awscreen) | a selector that was true when the page was written | the elements actually rendered, by what they look like |
+| [awbeads](https://github.com/Aitherium/awbeads) | that a layout your users built survives the next deploy | the arrangement as data you can read back, diff, and hand to another surface |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | that inference always means a request left the machine | a WebGPU model answering on the tab's own GPU, with a consent record logged before it ever loaded |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | the model to keep a 300-message campaign coherent by itself | campaign facts recalled from scoped memory you can list and edit |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | a vendor's quantisation defaults | sub-byte KV cache kernels you can benchmark yourself |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | a hand-rolled split script and a hand-edited worker manifest | byte-verified parts in a release, served with Range + CORS, sizes asserted by a live gate |
@@ -251,11 +255,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrecurse](https://github.com/Aitherium/awrecurse) | that everything you pasted in was actually read | which slices it opened, and what it concluded from each |
 | [awprism](https://github.com/Aitherium/awprism) | the first explanation that fits | the ranked alternatives, and the observation that separates them |
 | [awrepl](https://github.com/Aitherium/awrepl) | what the agent believes the value is | the value, printed from the live session |
+| [awreport](https://github.com/Aitherium/awreport) | that the report you pasted carried no token in it | a redacted report, and the duplicate it merged into instead of filing twice |
 | [awresearch](https://github.com/Aitherium/awresearch) | a summary of pages nobody opened | every claim against the source it came from |
 | [awfocus](https://github.com/Aitherium/awfocus) | twelve terminal tabs and a bad memory | one command that names every session, finds any transcript, and opens or steers the one you want |
 | [awgym](https://github.com/Aitherium/awgym) | that a world model learned anything from the games it saw | transitions captured from real play, fed back, and the retrodiction score falling on grids it never saw |
 | [awpredict](https://github.com/Aitherium/awpredict) | a model because it trained without erroring | its prediction against a self-updating lookup, on the rows that are actually novel |
+| [awevolve](https://github.com/Aitherium/awevolve) | that your optimisation loop is finding anything | every version it kept, the score that version earned, and the edit that produced it |
 | [awsh](https://github.com/Aitherium/awsh) | that you already know the name of the command | what it decided your line meant, before it acts on it |
+| [awmine](https://github.com/Aitherium/awmine) | that a session's lesson survived the session | a row per outcome, a candidate per lesson, and the transcript line each one came from |
 | [awrise](https://github.com/Aitherium/awrise) | that a scheduled agent ran at all, and ran exactly once | a durable record of every wake -- fired, skipped, overlapped or timed out -- each with its reason |
 | [awkno](https://github.com/Aitherium/awkno) | that the docs site is up, or that you remember the family | the whole ecosystem in your terminal, with no network at all |
 | [awwall](https://github.com/Aitherium/awwall) | that a service only talks to the hosts you think it talks to | an explicit egress allowlist, where a denial names the rule that denied it |
@@ -282,6 +289,7 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awgraph](https://github.com/Aitherium/awgraph) | A semantic code graph for agents — AST + tree-sitter, call graphs | [docs](https://aitherium.github.io/awgraph/) |
 | [awgit](https://github.com/Aitherium/awgit) | Semantic version control on top of git — edit-ops and leases | [docs](https://aitherium.github.io/awgit/) |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | Anonymous multi-round expert panels — a converged answer with a trace | [docs](https://aitherium.github.io/awdelphi/) |
+| [awclassify](https://github.com/Aitherium/awclassify) | Classify any document -- what it is, who may read it, who it is for, what it is about | — |
 | [awtoll](https://github.com/Aitherium/awtoll) | What every tool call costs you in context, measured from your own transcripts | [docs](https://aitherium.github.io/awtoll/) |
 | [awseal](https://github.com/Aitherium/awseal) | Sign an artifact so a stranger can verify it | [docs](https://aitherium.github.io/awseal/) |
 | [awshare](https://github.com/Aitherium/awshare) | Publish an artifact and fetch it back verified | [docs](https://aitherium.github.io/awshare/) |
@@ -299,12 +307,17 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awask](https://github.com/Aitherium/awask) | Your agent asks you a question — and acts on your answer | [docs](https://aitherium.github.io/awask/) |
 | [awmail](https://github.com/Aitherium/awmail) | Give an agent an email address — send, and actually receive | [docs](https://aitherium.github.io/awmail/) |
 | [awnet](https://github.com/Aitherium/awnet) | The agentic web — agents host a mesh, and agents join one | [docs](https://aitherium.github.io/awnet/) |
+| [awswarm](https://github.com/Aitherium/awswarm) | Run one model too big for any single GPU across a pool of small ones | — |
 | [awfind](https://github.com/Aitherium/awfind) | A portable search client — query, results, ranking | [docs](https://aitherium.github.io/awfind/) |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | A portable browser client — navigate, console, network, DOM, screenshot | [docs](https://aitherium.github.io/awbrowse/) |
 | [awvoice](https://github.com/Aitherium/awvoice) | Hear and speak — transcribe audio, synthesize a voice | [docs](https://aitherium.github.io/awvoice/) |
 | [awvision](https://github.com/Aitherium/awvision) | See an image — describe it, ask it a question, compare two | [docs](https://aitherium.github.io/awvision/) |
 | [awscreen](https://github.com/Aitherium/awscreen) | See this machine — what is on screen, and where to click it | [docs](https://aitherium.github.io/awscreen/) |
+| [awkit](https://github.com/Aitherium/awkit) | Render an agent panel from a tool result — one component, any React app | — |
+| [awbeads](https://github.com/Aitherium/awbeads) | A spatial canvas for a page — arrange things, connect them, and keep the arrangement | — |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | Run a real model in the visitor's own browser — no server round trip, no upload | — |
 | [awknowledge](https://github.com/Aitherium/awknowledge) | How to run a coding agent so the result survives — the laws, with evidence | [docs](https://aitherium.github.io/awknowledge/) |
+| [awbrain](https://github.com/Aitherium/awbrain) | Your history as a wiki of linked markdown — claims pinned to the evidence | — |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | GobboNet campaigns with a real agent brain — scoped memory, graph recall | [docs](https://aitherium.github.io/gawbbonet/) |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | Near-optimal KV cache quantization for LLM inference — sub-byte compression | [docs](https://aitherium.github.io/aitherkvcache/) |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | Deliberately chunk artifacts into GitHub release assets — the productized aitherkvcache mirror lane | [docs](https://aitherium.github.io/awrtifact/) |
@@ -314,14 +327,18 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awrecurse](https://github.com/Aitherium/awrecurse) | Answer a question over a context far larger than the window — recursively, with the trace kept | [docs](https://aitherium.github.io/awrecurse/) |
 | [awprism](https://github.com/Aitherium/awprism) | Turn a failure into ranked hypotheses — and say what would confirm each one | [docs](https://aitherium.github.io/awprism/) |
 | [awrepl](https://github.com/Aitherium/awrepl) | A REPL an agent can actually use — state that survives between turns | [docs](https://aitherium.github.io/awrepl/) |
+| [awreport](https://github.com/Aitherium/awreport) | File a bug report that has already scrubbed your secrets and collapsed the duplicate | — |
 | [awresearch](https://github.com/Aitherium/awresearch) | Ask a research question, get a cited report you can check | [docs](https://aitherium.github.io/awresearch/) |
 | [awfocus](https://github.com/Aitherium/awfocus) | See, search and steer every Claude session from one command | [docs](https://aitherium.github.io/awfocus/) |
 | [awgym](https://github.com/Aitherium/awgym) | An ARC training gym — a game a world model can watch, and six roles that play through it | [docs](https://aitherium.github.io/awgym/) |
 | [awpredict](https://github.com/Aitherium/awpredict) | Predict what your environment does next, and how surprised you were | [docs](https://aitherium.github.io/awpredict/) |
+| [awevolve](https://github.com/Aitherium/awevolve) | Point an agent at a file and a command that scores it, and let it improve | — |
 | [awsh](https://github.com/Aitherium/awsh) | Your terminal answers you -- type a question where a command would go | [docs](https://aitherium.github.io/awsh/) |
+| [awmine](https://github.com/Aitherium/awmine) | Mine what your agents did -- outcomes, lessons and procedures out of the transcripts they left behind | — |
 | [awrise](https://github.com/Aitherium/awrise) | Wake an agent on a schedule, let it do one thing, and put it back to sleep | [docs](https://aitherium.github.io/awrise/) |
 | [awkno](https://github.com/Aitherium/awkno) | The man page for the Aither World — every brick, stack and law, offline | [docs](https://aitherium.github.io/awkno/) |
 | [awwall](https://github.com/Aitherium/awwall) | Say what a workload may reach, and watch everything else fail closed | [docs](https://aitherium.github.io/awwall/) |
+| [awrouter](https://github.com/Aitherium/awrouter) | OpenRouter for your own fleet: pick a model backend by cost/latency/ capability, fail over, fit the context window, stream. Standalone, OpenAI-compatible, no Aither-specifics required to be valuable | — |
 | [awembed](https://github.com/Aitherium/awembed) | Train an embedding model that knows your corpus, and prove it beats the big one | [docs](https://aitherium.github.io/awembed/) |
 | [awtax](https://github.com/Aitherium/awtax) | Turn any tax PDF -- returns, W-2, 1099, statements, even scans -- into structured data you can check | [docs](https://aitherium.github.io/awtax/) |
 | [awflow](https://github.com/Aitherium/awflow) | A deterministic workflow runtime — chain agent calls with journal replay and budget control | [docs](https://aitherium.github.io/awflow/) |

{awrun-0.2.2 → awrun-0.2.4}/README.md

@@ -4,7 +4,7 @@
 
 **[Docs](https://aitherium.github.io/awrun/)**  ·  [Source](https://github.com/Aitherium/awrun)  ·  `pip install awrun`  ·  [The Aither World](https://aitherium.github.io/)
 
-> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 55 bricks — each installs on its own, runs offline, and needs no account.
+> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 65 bricks — each installs on its own, runs offline, and needs no account.
 >
 > **Start here:** Queue two runs at different priorities and watch the urgent one overtake.
 
@@ -196,6 +196,7 @@ Each installs on its own, works offline, and needs no account.
 | [awgraph](https://github.com/Aitherium/awgraph) | that grep found everything | an AST + tree-sitter call graph an agent can traverse |
 | [awgit](https://github.com/Aitherium/awgit) | that no one else is editing this file | a lease, refused at commit time if you do not hold it |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | one agent's confident take on a decision | the round trace, the anonymity, and who dissents |
+| [awclassify](https://github.com/Aitherium/awclassify) | a filename, a folder, or whoever last touched it | doc_type, visibility, audience and topics, with the evidence lines that decided each |
 | [awtoll](https://github.com/Aitherium/awtoll) | that your tooling is saving you context | the measured token cost of each tool call, and what the alternative cost |
 | [awseal](https://github.com/Aitherium/awseal) | that the artifact came from who you think | an Ed25519 seal — the key that verifies is not the key that forges |
 | [awshare](https://github.com/Aitherium/awshare) | that the download is intact | content-addressed bundles, verified on fetch |
@@ -208,11 +209,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrelay](https://github.com/Aitherium/awrelay) | a SaaS in the middle of your agents | findings, alerts and coordination over your own transport |
 | [awask](https://github.com/Aitherium/awask) | that anyone read the paragraph where you asked | the ask itself, with a button that steers the session that raised it |
 | [awmail](https://github.com/Aitherium/awmail) | a mailbox somebody else can read | mail your agents send and receive over your own server |
+| [awswarm](https://github.com/Aitherium/awswarm) | that a model either fits your GPU or it doesn't run at all | a placement plan and an acquisition-probability estimate before you spend on a run |
 | [awfind](https://github.com/Aitherium/awfind) | one vendor's idea of the web | results from whichever providers you configured |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | that the page said what you were told | the render, the DOM and the requests it made |
 | [awvoice](https://github.com/Aitherium/awvoice) | that a cloud vendor may hold your audio | a transcript and a wav from a service you host |
 | [awvision](https://github.com/Aitherium/awvision) | a filename and a caption somebody wrote | what a model actually reports about the pixels |
 | [awscreen](https://github.com/Aitherium/awscreen) | a selector that was true when the page was written | the elements actually rendered, by what they look like |
+| [awbeads](https://github.com/Aitherium/awbeads) | that a layout your users built survives the next deploy | the arrangement as data you can read back, diff, and hand to another surface |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | that inference always means a request left the machine | a WebGPU model answering on the tab's own GPU, with a consent record logged before it ever loaded |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | the model to keep a 300-message campaign coherent by itself | campaign facts recalled from scoped memory you can list and edit |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | a vendor's quantisation defaults | sub-byte KV cache kernels you can benchmark yourself |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | a hand-rolled split script and a hand-edited worker manifest | byte-verified parts in a release, served with Range + CORS, sizes asserted by a live gate |
@@ -222,11 +226,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrecurse](https://github.com/Aitherium/awrecurse) | that everything you pasted in was actually read | which slices it opened, and what it concluded from each |
 | [awprism](https://github.com/Aitherium/awprism) | the first explanation that fits | the ranked alternatives, and the observation that separates them |
 | [awrepl](https://github.com/Aitherium/awrepl) | what the agent believes the value is | the value, printed from the live session |
+| [awreport](https://github.com/Aitherium/awreport) | that the report you pasted carried no token in it | a redacted report, and the duplicate it merged into instead of filing twice |
 | [awresearch](https://github.com/Aitherium/awresearch) | a summary of pages nobody opened | every claim against the source it came from |
 | [awfocus](https://github.com/Aitherium/awfocus) | twelve terminal tabs and a bad memory | one command that names every session, finds any transcript, and opens or steers the one you want |
 | [awgym](https://github.com/Aitherium/awgym) | that a world model learned anything from the games it saw | transitions captured from real play, fed back, and the retrodiction score falling on grids it never saw |
 | [awpredict](https://github.com/Aitherium/awpredict) | a model because it trained without erroring | its prediction against a self-updating lookup, on the rows that are actually novel |
+| [awevolve](https://github.com/Aitherium/awevolve) | that your optimisation loop is finding anything | every version it kept, the score that version earned, and the edit that produced it |
 | [awsh](https://github.com/Aitherium/awsh) | that you already know the name of the command | what it decided your line meant, before it acts on it |
+| [awmine](https://github.com/Aitherium/awmine) | that a session's lesson survived the session | a row per outcome, a candidate per lesson, and the transcript line each one came from |
 | [awrise](https://github.com/Aitherium/awrise) | that a scheduled agent ran at all, and ran exactly once | a durable record of every wake -- fired, skipped, overlapped or timed out -- each with its reason |
 | [awkno](https://github.com/Aitherium/awkno) | that the docs site is up, or that you remember the family | the whole ecosystem in your terminal, with no network at all |
 | [awwall](https://github.com/Aitherium/awwall) | that a service only talks to the hosts you think it talks to | an explicit egress allowlist, where a denial names the rule that denied it |
@@ -253,6 +260,7 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awgraph](https://github.com/Aitherium/awgraph) | A semantic code graph for agents — AST + tree-sitter, call graphs | [docs](https://aitherium.github.io/awgraph/) |
 | [awgit](https://github.com/Aitherium/awgit) | Semantic version control on top of git — edit-ops and leases | [docs](https://aitherium.github.io/awgit/) |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | Anonymous multi-round expert panels — a converged answer with a trace | [docs](https://aitherium.github.io/awdelphi/) |
+| [awclassify](https://github.com/Aitherium/awclassify) | Classify any document -- what it is, who may read it, who it is for, what it is about | — |
 | [awtoll](https://github.com/Aitherium/awtoll) | What every tool call costs you in context, measured from your own transcripts | [docs](https://aitherium.github.io/awtoll/) |
 | [awseal](https://github.com/Aitherium/awseal) | Sign an artifact so a stranger can verify it | [docs](https://aitherium.github.io/awseal/) |
 | [awshare](https://github.com/Aitherium/awshare) | Publish an artifact and fetch it back verified | [docs](https://aitherium.github.io/awshare/) |
@@ -270,12 +278,17 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awask](https://github.com/Aitherium/awask) | Your agent asks you a question — and acts on your answer | [docs](https://aitherium.github.io/awask/) |
 | [awmail](https://github.com/Aitherium/awmail) | Give an agent an email address — send, and actually receive | [docs](https://aitherium.github.io/awmail/) |
 | [awnet](https://github.com/Aitherium/awnet) | The agentic web — agents host a mesh, and agents join one | [docs](https://aitherium.github.io/awnet/) |
+| [awswarm](https://github.com/Aitherium/awswarm) | Run one model too big for any single GPU across a pool of small ones | — |
 | [awfind](https://github.com/Aitherium/awfind) | A portable search client — query, results, ranking | [docs](https://aitherium.github.io/awfind/) |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | A portable browser client — navigate, console, network, DOM, screenshot | [docs](https://aitherium.github.io/awbrowse/) |
 | [awvoice](https://github.com/Aitherium/awvoice) | Hear and speak — transcribe audio, synthesize a voice | [docs](https://aitherium.github.io/awvoice/) |
 | [awvision](https://github.com/Aitherium/awvision) | See an image — describe it, ask it a question, compare two | [docs](https://aitherium.github.io/awvision/) |
 | [awscreen](https://github.com/Aitherium/awscreen) | See this machine — what is on screen, and where to click it | [docs](https://aitherium.github.io/awscreen/) |
+| [awkit](https://github.com/Aitherium/awkit) | Render an agent panel from a tool result — one component, any React app | — |
+| [awbeads](https://github.com/Aitherium/awbeads) | A spatial canvas for a page — arrange things, connect them, and keep the arrangement | — |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | Run a real model in the visitor's own browser — no server round trip, no upload | — |
 | [awknowledge](https://github.com/Aitherium/awknowledge) | How to run a coding agent so the result survives — the laws, with evidence | [docs](https://aitherium.github.io/awknowledge/) |
+| [awbrain](https://github.com/Aitherium/awbrain) | Your history as a wiki of linked markdown — claims pinned to the evidence | — |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | GobboNet campaigns with a real agent brain — scoped memory, graph recall | [docs](https://aitherium.github.io/gawbbonet/) |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | Near-optimal KV cache quantization for LLM inference — sub-byte compression | [docs](https://aitherium.github.io/aitherkvcache/) |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | Deliberately chunk artifacts into GitHub release assets — the productized aitherkvcache mirror lane | [docs](https://aitherium.github.io/awrtifact/) |
@@ -285,14 +298,18 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awrecurse](https://github.com/Aitherium/awrecurse) | Answer a question over a context far larger than the window — recursively, with the trace kept | [docs](https://aitherium.github.io/awrecurse/) |
 | [awprism](https://github.com/Aitherium/awprism) | Turn a failure into ranked hypotheses — and say what would confirm each one | [docs](https://aitherium.github.io/awprism/) |
 | [awrepl](https://github.com/Aitherium/awrepl) | A REPL an agent can actually use — state that survives between turns | [docs](https://aitherium.github.io/awrepl/) |
+| [awreport](https://github.com/Aitherium/awreport) | File a bug report that has already scrubbed your secrets and collapsed the duplicate | — |
 | [awresearch](https://github.com/Aitherium/awresearch) | Ask a research question, get a cited report you can check | [docs](https://aitherium.github.io/awresearch/) |
 | [awfocus](https://github.com/Aitherium/awfocus) | See, search and steer every Claude session from one command | [docs](https://aitherium.github.io/awfocus/) |
 | [awgym](https://github.com/Aitherium/awgym) | An ARC training gym — a game a world model can watch, and six roles that play through it | [docs](https://aitherium.github.io/awgym/) |
 | [awpredict](https://github.com/Aitherium/awpredict) | Predict what your environment does next, and how surprised you were | [docs](https://aitherium.github.io/awpredict/) |
+| [awevolve](https://github.com/Aitherium/awevolve) | Point an agent at a file and a command that scores it, and let it improve | — |
 | [awsh](https://github.com/Aitherium/awsh) | Your terminal answers you -- type a question where a command would go | [docs](https://aitherium.github.io/awsh/) |
+| [awmine](https://github.com/Aitherium/awmine) | Mine what your agents did -- outcomes, lessons and procedures out of the transcripts they left behind | — |
 | [awrise](https://github.com/Aitherium/awrise) | Wake an agent on a schedule, let it do one thing, and put it back to sleep | [docs](https://aitherium.github.io/awrise/) |
 | [awkno](https://github.com/Aitherium/awkno) | The man page for the Aither World — every brick, stack and law, offline | [docs](https://aitherium.github.io/awkno/) |
 | [awwall](https://github.com/Aitherium/awwall) | Say what a workload may reach, and watch everything else fail closed | [docs](https://aitherium.github.io/awwall/) |
+| [awrouter](https://github.com/Aitherium/awrouter) | OpenRouter for your own fleet: pick a model backend by cost/latency/ capability, fail over, fit the context window, stream. Standalone, OpenAI-compatible, no Aither-specifics required to be valuable | — |
 | [awembed](https://github.com/Aitherium/awembed) | Train an embedding model that knows your corpus, and prove it beats the big one | [docs](https://aitherium.github.io/awembed/) |
 | [awtax](https://github.com/Aitherium/awtax) | Turn any tax PDF -- returns, W-2, 1099, statements, even scans -- into structured data you can check | [docs](https://aitherium.github.io/awtax/) |
 | [awflow](https://github.com/Aitherium/awflow) | A deterministic workflow runtime — chain agent calls with journal replay and budget control | [docs](https://aitherium.github.io/awflow/) |

{awrun-0.2.2 → awrun-0.2.4}/awrun/__init__.py

@@ -24,4 +24,4 @@ __all__ = [
     "runs_dir",
 ]
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{awrun-0.2.2 → awrun-0.2.4}/awrun/cli.py

@@ -42,6 +42,44 @@ def _add_monorepo_root_to_syspath() -> None:
         _sys.path.insert(0, str(root))
 
 
+def _load_host_plugin():
+    """Load the host capacity plugin from a FILE path and return the module.
+
+    The path is ``$AWRUN_CAPACITY_PLUGIN`` when set, else the marker file found
+    by :func:`_monorepo_root`. Raises ImportError when there is neither, or the
+    file fails to load -- the caller records why.
+    """
+    import importlib.util
+
+    override = os.environ.get("AWRUN_CAPACITY_PLUGIN", "").strip()
+    if override:
+        path = Path(override)
+    else:
+        root = _monorepo_root()
+        if root is None:
+            raise ImportError("no host capacity plugin: AWRUN_CAPACITY_PLUGIN is "
+                              "unset and no checkout marker was found")
+        path = root.joinpath(*_MONOREPO_MARKER)
+    if not path.is_file():
+        raise ImportError(f"host capacity plugin not found: {path}")
+    name = "_awrun_host_capacity_plugin"
+    cached = sys.modules.get(name)
+    if cached is not None and getattr(cached, "__file__", None) == str(path):
+        return cached
+    spec = importlib.util.spec_from_file_location(name, path)
+    if spec is None or spec.loader is None:
+        raise ImportError(f"cannot load host capacity plugin: {path}")
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[name] = module
+    try:
+        spec.loader.exec_module(module)
+    except Exception as exc:  # noqa: BLE001 - surfaced as ImportError, with cause
+        sys.modules.pop(name, None)
+        raise ImportError(f"host capacity plugin failed to load ({path}): "
+                          f"{type(exc).__name__}: {exc}") from exc
+    return module
+
+
 def _register_capacity_provider() -> None:
     """Register the host's capacity provisioner with awrun.plugins if available.
 
@@ -71,19 +109,19 @@ def _register_capacity_provider() -> None:
     _add_monorepo_root_to_syspath()
 
     try:
-        # Try to import from the monorepo dev tools
-        # This succeeds only on the host; it fails gracefully on PyPI/strangers
-        from AitherOS.dev.tools.awrun_capacity import (
-            provision_capacity,
-            reap_capacity,
-        )
-        plugins.register(plugins.PROVISION_CAPACITY, provision_capacity)
+        # The provider is a host FILE, loaded by path -- never a package import,
+        # so the published awrun names no module it does not ship.
+        # AWRUN_CAPACITY_PLUGIN overrides the discovered path.
+        host = _load_host_plugin()
+        plugins.register(plugins.PROVISION_CAPACITY, host.provision_capacity)
         # Registered in the SAME place as the provisioner on purpose: an
         # autoscaler that can grow and cannot shrink is a spend generator, and
         # wiring the two halves apart is how one of them stays unwired.
-        plugins.register(getattr(plugins, "REAP_CAPACITY", "reap_capacity"),
-                         reap_capacity)
-    except (ImportError, ModuleNotFoundError) as exc:
+        plugins.register(plugins.REAP_CAPACITY, host.reap_capacity)
+        token_source = getattr(host, "github_token_source", None)
+        if callable(token_source) and plugins.get(plugins.GITHUB_TOKEN_SOURCE) is None:
+            plugins.register(plugins.GITHUB_TOKEN_SOURCE, token_source)
+    except (ImportError, AttributeError) as exc:
         # Absent is FINE for a stranger: awrun ships to PyPI and still measures
         # saturation without a provisioner. But on a host that plainly HAS the
         # monorepo, a swallowed ImportError is how a provisioner stays dead for
@@ -685,7 +723,7 @@ def _self_test() -> int:
                 tunnel_args = argparse.Namespace(
                     kind="tunnel", priority=0, paths=[], json=False,
                     action="expose", hostname="demo.example.com",
-                    origin="http://aitheros-veil:3000", plane="tunnel",
+                    origin="http://app-web:3000", plane="tunnel",
                 )
                 os.environ.pop("AWRUN_TUNNEL_OPERATORS", None)
                 rc5 = cmd_submit(tunnel_args, store)
@@ -697,7 +735,7 @@ def _self_test() -> int:
                 check("a tunnel operator's expose reaches the queue with the decided spec shape",
                       rc6 == 0 and len(queued_t) == 1 and queued_t[0].spec == {
                           "action": "expose", "hostname": "demo.example.com",
-                          "origin": "http://aitheros-veil:3000", "plane": "tunnel"})
+                          "origin": "http://app-web:3000", "plane": "tunnel"})
             bad = argparse.Namespace(kind="tunnel", priority=0, paths=[], json=False,
                                      action="retire", hostname="demo.example.com",
                                      origin="http://x:1", plane="tunnel")
@@ -707,7 +745,7 @@ def _self_test() -> int:
                   and len(store.list(statuses=["queued"], kind="tunnel")) == tunnels_before)
             bad2 = argparse.Namespace(kind="tunnel", priority=0, paths=[], json=False,
                                       action="expose", hostname="demo.example.com",
-                                      origin="aitheros-veil:3000", plane="tunnel")
+                                      origin="app-web:3000", plane="tunnel")
             check("expose without a scheme on the origin is refused (exit 2)",
                   cmd_submit(bad2, store) == 2)
         finally:

{awrun-0.2.2 → awrun-0.2.4}/awrun/dispatcher.py

@@ -66,7 +66,7 @@ import urllib.request
 from pathlib import Path
 from typing import Callable, Optional
 
-from awrun import confine, trail
+from awrun import confine, host_admission, trail
 from awrun.store import GPU_KINDS, RunItem, RunStore, get_store
 
 logger = logging.getLogger(__name__)
@@ -680,6 +680,23 @@ def dispatch_once(store: RunStore, *, worker_id: str,
     if gap is not None:
         runnable = False
 
+    # ── Host admission: a heavy item never starts on a starving host ────────
+    # Asked before the GPU lease so a deferral holds no card. "Not now" is a
+    # requeue with backoff, exactly like a lease refusal -- never `failed`.
+    if runnable:
+        admitted, why, host_now = host_admission.admit(claimed.kind)
+        if not admitted:
+            delay = _lease_backoff_s(claimed.requeues, None)
+            back = store.requeue(claimed.id, now_fn() + delay,
+                                 wait={"reason": f"host over budget: {why}",
+                                       "host": host_now})
+            logger.warning("awrun: %s [%s] host over budget (%s) -- requeued, retry in %.0fs",
+                           claimed.id, claimed.kind, why, delay)
+            if back is not None:
+                _broadcast(back, f"requeued: host over budget ({why}), retry in {delay:.0f}s",
+                           client=relay_client)
+            return back
+
     # ── GPU lease: asked BEFORE start, so a refusal is claimed -> queued ────
     # Only when there is something to run: a lease taken for a handler that
     # can only say "not implemented" would evict real work for nothing.

awrun-0.2.4/awrun/host_admission.py

@@ -0,0 +1,90 @@
+"""Host admission: do not start heavy work on a host that is already starving.
+
+A queue that only asks "is a runner free?" will happily start three builds on a
+box whose memory is already stalled, and the services sharing that box pay for
+it. Before a heavy item runs, awrun reads Linux pressure-stall information
+(``/proc/pressure``), the load average and ``MemAvailable``. When any is over
+budget, the item goes back to ``queued/`` with a backoff -- "not now", never
+"failed".
+
+Budget: the defaults below, overridden by ``AWRUN_HOST_BUDGET`` (a JSON object
+with any of the same keys); ``AWRUN_HOST_ADMISSION=off`` disables the check.
+A host without ``/proc/pressure`` (Windows, macOS, an old kernel) cannot be
+judged and is ADMITTED, and the verdict says so.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from typing import Dict, Optional, Tuple
+
+#: Kinds that build, render, train or deploy: the ones that can starve a host.
+HEAVY_KINDS = frozenset({"ci", "comet-deploy", "render", "artpack", "solve"})
+
+DEFAULT_BUDGET: Dict[str, float] = {
+    "memory_full_avg60_pct": 10.0,
+    "cpu_some_avg60_pct": 60.0,
+    "load_per_cpu": 3.0,
+    "mem_available_min_gb": 12.0,
+}
+
+
+def budget() -> Dict[str, float]:
+    out = dict(DEFAULT_BUDGET)
+    raw = os.environ.get("AWRUN_HOST_BUDGET", "").strip()
+    if raw:
+        try:
+            out.update({k: float(v) for k, v in json.loads(raw).items()})
+        except (ValueError, TypeError, AttributeError):
+            out = dict(DEFAULT_BUDGET)  # a malformed override keeps the defaults
+    return out
+
+
+def _avg60(path: Path, head: str) -> float:
+    for line in path.read_text(encoding="utf-8").splitlines():
+        if line.startswith(head + " "):
+            for field in line.split()[1:]:
+                k, _, v = field.partition("=")
+                if k == "avg60":
+                    return float(v)
+    return 0.0
+
+
+def sample(proc: Path = Path("/proc")) -> Dict[str, float]:
+    mem_kb = 0
+    for line in (proc / "meminfo").read_text(encoding="utf-8").splitlines():
+        if line.startswith("MemAvailable:"):
+            mem_kb = int(line.split()[1])
+    load1 = float((proc / "loadavg").read_text(encoding="utf-8").split()[0])
+    return {
+        "memory_full_avg60_pct": _avg60(proc / "pressure" / "memory", "full"),
+        "cpu_some_avg60_pct": _avg60(proc / "pressure" / "cpu", "some"),
+        "load_per_cpu": load1 / max(os.cpu_count() or 1, 1),
+        "mem_available_gb": mem_kb / (1024 * 1024),
+    }
+
+
+def decide(now: Dict[str, float], limits: Dict[str, float]) -> Tuple[bool, str]:
+    for key, limit in limits.items():
+        if key == "mem_available_min_gb":
+            if now.get("mem_available_gb", limit) < limit:
+                return False, f"MemAvailable {now['mem_available_gb']:.1f} GB < {limit:g} GB"
+        elif key in now and now[key] > limit:
+            return False, f"{key} {now[key]:.1f} > {limit:g}"
+    return True, "within host budget"
+
+
+def admit(kind: str, proc: Path = Path("/proc")) -> Tuple[bool, str, Optional[dict]]:
+    """(run?, why, sample-or-None). Light kinds and unjudgeable hosts are admitted."""
+    if kind not in HEAVY_KINDS:
+        return True, f"{kind} is not a heavy kind", None
+    if os.environ.get("AWRUN_HOST_ADMISSION", "").strip().lower() == "off":
+        return True, "host admission disabled (AWRUN_HOST_ADMISSION=off)", None
+    try:
+        now = sample(proc)
+    except (OSError, ValueError, IndexError) as exc:
+        return True, f"host pressure unreadable ({exc}) -- admitted unjudged", None
+    ok, why = decide(now, budget())
+    return ok, why, now

{awrun-0.2.2 → awrun-0.2.4}/awrun/plugins.py

@@ -40,6 +40,12 @@ REAP_CAPACITY = "reap_capacity"
 #: environment and reports "no door" when there is none.
 GPU_LEASE_CLIENT = "gpu_lease_client"
 
+#: () -> str. A GitHub token from wherever the HOST keeps credentials (a vault,
+#: a keyring). Consulted only after GH_TOKEN / GITHUB_TOKEN / AWRUN_GH_TOKEN are
+#: all unset; an empty string or a failure means "none here" and the next
+#: fallback is tried. awrun itself knows no vault.
+GITHUB_TOKEN_SOURCE = "github_token_source"
+
 #: Why the host provisioner failed to import, when it did. None means it was
 #: never attempted or it succeeded. Recorded rather than swallowed: a silent
 #: ImportError leaves `awrun capacity --add` exiting 0 having done nothing,

{awrun-0.2.2 → awrun-0.2.4}/awrun/runner_groups.py

@@ -49,11 +49,28 @@ class RunnerGroupError(RuntimeError):
     """Something we could not do, stated plainly enough to act on."""
 
 
+def _vault_token() -> str:
+    """A token from the HOST's credential store, via the plugin seam.
+
+    Inside a larger system the token may live in a vault rather than the
+    environment (an env copy can be stale and answer 401 while the vault's
+    answers 200). awrun ships standalone and knows no vault: the host registers
+    ``plugins.GITHUB_TOKEN_SOURCE``. Nothing registered, or a hook that fails
+    or returns nothing, means "not a path here" and the env rule stands."""
+    from . import plugins
+
+    v = plugins.call(plugins.GITHUB_TOKEN_SOURCE)
+    return v.strip() if isinstance(v, str) else ""
+
+
 def _token() -> str:
     for var in ("GH_TOKEN", "GITHUB_TOKEN", "AWRUN_GH_TOKEN"):
         v = os.environ.get(var, "").strip()
         if v:
             return v
+    v = _vault_token()
+    if v:
+        return v
     raise RunnerGroupError(
         "no GitHub token: set GH_TOKEN (or GITHUB_TOKEN). It is read from the "
         "environment and never accepted as an argument, because an argv token "

{awrun-0.2.2 → awrun-0.2.4}/awrun.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awrun
-Version: 0.2.2
+Version: 0.2.4
 Summary: A priority-aware queue and dispatcher for agentic runs and ad-hoc CI builds — real dynamic priority for the class of work we control, instead of GitHub Actions' opaque FIFO.
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/Aitherium/awrun
@@ -33,7 +33,7 @@ Dynamic: license-file
 
 **[Docs](https://aitherium.github.io/awrun/)**  ·  [Source](https://github.com/Aitherium/awrun)  ·  `pip install awrun`  ·  [The Aither World](https://aitherium.github.io/)
 
-> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 55 bricks — each installs on its own, runs offline, and needs no account.
+> **The Aither World** is an operating system for agents — a Linux you can hand to one, the runtimes it works in, and the tools it works with. [awnix](https://github.com/Aitherium/awnix) is the Linux underneath it; **awrun** is one of its 65 bricks — each installs on its own, runs offline, and needs no account.
 >
 > **Start here:** Queue two runs at different priorities and watch the urgent one overtake.
 
@@ -225,6 +225,7 @@ Each installs on its own, works offline, and needs no account.
 | [awgraph](https://github.com/Aitherium/awgraph) | that grep found everything | an AST + tree-sitter call graph an agent can traverse |
 | [awgit](https://github.com/Aitherium/awgit) | that no one else is editing this file | a lease, refused at commit time if you do not hold it |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | one agent's confident take on a decision | the round trace, the anonymity, and who dissents |
+| [awclassify](https://github.com/Aitherium/awclassify) | a filename, a folder, or whoever last touched it | doc_type, visibility, audience and topics, with the evidence lines that decided each |
 | [awtoll](https://github.com/Aitherium/awtoll) | that your tooling is saving you context | the measured token cost of each tool call, and what the alternative cost |
 | [awseal](https://github.com/Aitherium/awseal) | that the artifact came from who you think | an Ed25519 seal — the key that verifies is not the key that forges |
 | [awshare](https://github.com/Aitherium/awshare) | that the download is intact | content-addressed bundles, verified on fetch |
@@ -237,11 +238,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrelay](https://github.com/Aitherium/awrelay) | a SaaS in the middle of your agents | findings, alerts and coordination over your own transport |
 | [awask](https://github.com/Aitherium/awask) | that anyone read the paragraph where you asked | the ask itself, with a button that steers the session that raised it |
 | [awmail](https://github.com/Aitherium/awmail) | a mailbox somebody else can read | mail your agents send and receive over your own server |
+| [awswarm](https://github.com/Aitherium/awswarm) | that a model either fits your GPU or it doesn't run at all | a placement plan and an acquisition-probability estimate before you spend on a run |
 | [awfind](https://github.com/Aitherium/awfind) | one vendor's idea of the web | results from whichever providers you configured |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | that the page said what you were told | the render, the DOM and the requests it made |
 | [awvoice](https://github.com/Aitherium/awvoice) | that a cloud vendor may hold your audio | a transcript and a wav from a service you host |
 | [awvision](https://github.com/Aitherium/awvision) | a filename and a caption somebody wrote | what a model actually reports about the pixels |
 | [awscreen](https://github.com/Aitherium/awscreen) | a selector that was true when the page was written | the elements actually rendered, by what they look like |
+| [awbeads](https://github.com/Aitherium/awbeads) | that a layout your users built survives the next deploy | the arrangement as data you can read back, diff, and hand to another surface |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | that inference always means a request left the machine | a WebGPU model answering on the tab's own GPU, with a consent record logged before it ever loaded |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | the model to keep a 300-message campaign coherent by itself | campaign facts recalled from scoped memory you can list and edit |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | a vendor's quantisation defaults | sub-byte KV cache kernels you can benchmark yourself |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | a hand-rolled split script and a hand-edited worker manifest | byte-verified parts in a release, served with Range + CORS, sizes asserted by a live gate |
@@ -251,11 +255,14 @@ Each installs on its own, works offline, and needs no account.
 | [awrecurse](https://github.com/Aitherium/awrecurse) | that everything you pasted in was actually read | which slices it opened, and what it concluded from each |
 | [awprism](https://github.com/Aitherium/awprism) | the first explanation that fits | the ranked alternatives, and the observation that separates them |
 | [awrepl](https://github.com/Aitherium/awrepl) | what the agent believes the value is | the value, printed from the live session |
+| [awreport](https://github.com/Aitherium/awreport) | that the report you pasted carried no token in it | a redacted report, and the duplicate it merged into instead of filing twice |
 | [awresearch](https://github.com/Aitherium/awresearch) | a summary of pages nobody opened | every claim against the source it came from |
 | [awfocus](https://github.com/Aitherium/awfocus) | twelve terminal tabs and a bad memory | one command that names every session, finds any transcript, and opens or steers the one you want |
 | [awgym](https://github.com/Aitherium/awgym) | that a world model learned anything from the games it saw | transitions captured from real play, fed back, and the retrodiction score falling on grids it never saw |
 | [awpredict](https://github.com/Aitherium/awpredict) | a model because it trained without erroring | its prediction against a self-updating lookup, on the rows that are actually novel |
+| [awevolve](https://github.com/Aitherium/awevolve) | that your optimisation loop is finding anything | every version it kept, the score that version earned, and the edit that produced it |
 | [awsh](https://github.com/Aitherium/awsh) | that you already know the name of the command | what it decided your line meant, before it acts on it |
+| [awmine](https://github.com/Aitherium/awmine) | that a session's lesson survived the session | a row per outcome, a candidate per lesson, and the transcript line each one came from |
 | [awrise](https://github.com/Aitherium/awrise) | that a scheduled agent ran at all, and ran exactly once | a durable record of every wake -- fired, skipped, overlapped or timed out -- each with its reason |
 | [awkno](https://github.com/Aitherium/awkno) | that the docs site is up, or that you remember the family | the whole ecosystem in your terminal, with no network at all |
 | [awwall](https://github.com/Aitherium/awwall) | that a service only talks to the hosts you think it talks to | an explicit egress allowlist, where a denial names the rule that denied it |
@@ -282,6 +289,7 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awgraph](https://github.com/Aitherium/awgraph) | A semantic code graph for agents — AST + tree-sitter, call graphs | [docs](https://aitherium.github.io/awgraph/) |
 | [awgit](https://github.com/Aitherium/awgit) | Semantic version control on top of git — edit-ops and leases | [docs](https://aitherium.github.io/awgit/) |
 | [awdelphi](https://github.com/Aitherium/awdelphi) | Anonymous multi-round expert panels — a converged answer with a trace | [docs](https://aitherium.github.io/awdelphi/) |
+| [awclassify](https://github.com/Aitherium/awclassify) | Classify any document -- what it is, who may read it, who it is for, what it is about | — |
 | [awtoll](https://github.com/Aitherium/awtoll) | What every tool call costs you in context, measured from your own transcripts | [docs](https://aitherium.github.io/awtoll/) |
 | [awseal](https://github.com/Aitherium/awseal) | Sign an artifact so a stranger can verify it | [docs](https://aitherium.github.io/awseal/) |
 | [awshare](https://github.com/Aitherium/awshare) | Publish an artifact and fetch it back verified | [docs](https://aitherium.github.io/awshare/) |
@@ -299,12 +307,17 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awask](https://github.com/Aitherium/awask) | Your agent asks you a question — and acts on your answer | [docs](https://aitherium.github.io/awask/) |
 | [awmail](https://github.com/Aitherium/awmail) | Give an agent an email address — send, and actually receive | [docs](https://aitherium.github.io/awmail/) |
 | [awnet](https://github.com/Aitherium/awnet) | The agentic web — agents host a mesh, and agents join one | [docs](https://aitherium.github.io/awnet/) |
+| [awswarm](https://github.com/Aitherium/awswarm) | Run one model too big for any single GPU across a pool of small ones | — |
 | [awfind](https://github.com/Aitherium/awfind) | A portable search client — query, results, ranking | [docs](https://aitherium.github.io/awfind/) |
 | [awbrowse](https://github.com/Aitherium/awbrowse) | A portable browser client — navigate, console, network, DOM, screenshot | [docs](https://aitherium.github.io/awbrowse/) |
 | [awvoice](https://github.com/Aitherium/awvoice) | Hear and speak — transcribe audio, synthesize a voice | [docs](https://aitherium.github.io/awvoice/) |
 | [awvision](https://github.com/Aitherium/awvision) | See an image — describe it, ask it a question, compare two | [docs](https://aitherium.github.io/awvision/) |
 | [awscreen](https://github.com/Aitherium/awscreen) | See this machine — what is on screen, and where to click it | [docs](https://aitherium.github.io/awscreen/) |
+| [awkit](https://github.com/Aitherium/awkit) | Render an agent panel from a tool result — one component, any React app | — |
+| [awbeads](https://github.com/Aitherium/awbeads) | A spatial canvas for a page — arrange things, connect them, and keep the arrangement | — |
+| [awbonsai](https://github.com/Aitherium/awbonsai) | Run a real model in the visitor's own browser — no server round trip, no upload | — |
 | [awknowledge](https://github.com/Aitherium/awknowledge) | How to run a coding agent so the result survives — the laws, with evidence | [docs](https://aitherium.github.io/awknowledge/) |
+| [awbrain](https://github.com/Aitherium/awbrain) | Your history as a wiki of linked markdown — claims pinned to the evidence | — |
 | [gawbbonet](https://github.com/Aitherium/gawbbonet) | GobboNet campaigns with a real agent brain — scoped memory, graph recall | [docs](https://aitherium.github.io/gawbbonet/) |
 | [aitherkvcache](https://github.com/Aitherium/aitherkvcache) | Near-optimal KV cache quantization for LLM inference — sub-byte compression | [docs](https://aitherium.github.io/aitherkvcache/) |
 | [awrtifact](https://github.com/Aitherium/awrtifact) | Deliberately chunk artifacts into GitHub release assets — the productized aitherkvcache mirror lane | [docs](https://aitherium.github.io/awrtifact/) |
@@ -314,14 +327,18 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awrecurse](https://github.com/Aitherium/awrecurse) | Answer a question over a context far larger than the window — recursively, with the trace kept | [docs](https://aitherium.github.io/awrecurse/) |
 | [awprism](https://github.com/Aitherium/awprism) | Turn a failure into ranked hypotheses — and say what would confirm each one | [docs](https://aitherium.github.io/awprism/) |
 | [awrepl](https://github.com/Aitherium/awrepl) | A REPL an agent can actually use — state that survives between turns | [docs](https://aitherium.github.io/awrepl/) |
+| [awreport](https://github.com/Aitherium/awreport) | File a bug report that has already scrubbed your secrets and collapsed the duplicate | — |
 | [awresearch](https://github.com/Aitherium/awresearch) | Ask a research question, get a cited report you can check | [docs](https://aitherium.github.io/awresearch/) |
 | [awfocus](https://github.com/Aitherium/awfocus) | See, search and steer every Claude session from one command | [docs](https://aitherium.github.io/awfocus/) |
 | [awgym](https://github.com/Aitherium/awgym) | An ARC training gym — a game a world model can watch, and six roles that play through it | [docs](https://aitherium.github.io/awgym/) |
 | [awpredict](https://github.com/Aitherium/awpredict) | Predict what your environment does next, and how surprised you were | [docs](https://aitherium.github.io/awpredict/) |
+| [awevolve](https://github.com/Aitherium/awevolve) | Point an agent at a file and a command that scores it, and let it improve | — |
 | [awsh](https://github.com/Aitherium/awsh) | Your terminal answers you -- type a question where a command would go | [docs](https://aitherium.github.io/awsh/) |
+| [awmine](https://github.com/Aitherium/awmine) | Mine what your agents did -- outcomes, lessons and procedures out of the transcripts they left behind | — |
 | [awrise](https://github.com/Aitherium/awrise) | Wake an agent on a schedule, let it do one thing, and put it back to sleep | [docs](https://aitherium.github.io/awrise/) |
 | [awkno](https://github.com/Aitherium/awkno) | The man page for the Aither World — every brick, stack and law, offline | [docs](https://aitherium.github.io/awkno/) |
 | [awwall](https://github.com/Aitherium/awwall) | Say what a workload may reach, and watch everything else fail closed | [docs](https://aitherium.github.io/awwall/) |
+| [awrouter](https://github.com/Aitherium/awrouter) | OpenRouter for your own fleet: pick a model backend by cost/latency/ capability, fail over, fit the context window, stream. Standalone, OpenAI-compatible, no Aither-specifics required to be valuable | — |
 | [awembed](https://github.com/Aitherium/awembed) | Train an embedding model that knows your corpus, and prove it beats the big one | [docs](https://aitherium.github.io/awembed/) |
 | [awtax](https://github.com/Aitherium/awtax) | Turn any tax PDF -- returns, W-2, 1099, statements, even scans -- into structured data you can check | [docs](https://aitherium.github.io/awtax/) |
 | [awflow](https://github.com/Aitherium/awflow) | A deterministic workflow runtime — chain agent calls with journal replay and budget control | [docs](https://aitherium.github.io/awflow/) |

{awrun-0.2.2 → awrun-0.2.4}/awrun.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ awrun/dispatcher.py
 awrun/egress.py
 awrun/gpu_lease.py
 awrun/handoff.py
+awrun/host_admission.py
 awrun/plugins.py
 awrun/runner_groups.py
 awrun/store.py
@@ -27,5 +28,6 @@ awrun.egg-info/top_level.txt
 tests/test_dispatcher_gpu_lease.py
 tests/test_gpu_lease.py
 tests/test_handoff.py
+tests/test_host_admission.py
 tests/test_store.py
 tests/test_suspend_apply_confine.py

{awrun-0.2.2 → awrun-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "awrun"
-version = "0.2.2"
+version = "0.2.4"
 description = "A priority-aware queue and dispatcher for agentic runs and ad-hoc CI builds — real dynamic priority for the class of work we control, instead of GitHub Actions' opaque FIFO."
 readme = "README.md"
 requires-python = ">=3.10"

awrun-0.2.4/tests/test_host_admission.py

@@ -0,0 +1,90 @@
+"""Host admission: a heavy item never starts on a starving host, and a deferral
+is a requeue with backoff -- never a failure, never a run."""
+
+from __future__ import annotations
+
+import pytest
+from awrun import dispatcher, host_admission
+from awrun.dispatcher import dispatch_once
+from awrun.store import STATUS_FAILED, STATUS_QUEUED, RunStore
+
+CALM = {"memory_full_avg60_pct": 0.5, "cpu_some_avg60_pct": 5.0, "load_per_cpu": 1.0,
+        "mem_available_gb": 30.0}
+STARVING = {**CALM, "memory_full_avg60_pct": 84.6, "load_per_cpu": 21.2,
+            "mem_available_gb": 9.0}
+
+
+@pytest.fixture(autouse=True)
+def _on(monkeypatch):
+    monkeypatch.delenv("AWRUN_HOST_ADMISSION", raising=False)
+    monkeypatch.delenv("AWRUN_HOST_BUDGET", raising=False)
+    monkeypatch.setattr(dispatcher, "_relay_client", lambda: None)
+
+
+def _fake_proc(tmp_path, mem_full: float):
+    (tmp_path / "pressure").mkdir()
+    (tmp_path / "pressure" / "memory").write_text(
+        f"some avg10=0 avg60=1.00 avg300=0 total=1\n"
+        f"full avg10=0 avg60={mem_full:.2f} avg300=0 total=1\n", encoding="utf-8")
+    (tmp_path / "pressure" / "cpu").write_text(
+        "some avg10=0 avg60=2.00 avg300=0 total=1\n", encoding="utf-8")
+    (tmp_path / "loadavg").write_text("1.0 1.0 1.0 1/1 1\n", encoding="utf-8")
+    (tmp_path / "meminfo").write_text("MemAvailable:   33554432 kB\n", encoding="utf-8")
+    return tmp_path
+
+
+def test_decide_calm_and_starving():
+    assert host_admission.decide(CALM, host_admission.budget())[0] is True
+    ok, why = host_admission.decide(STARVING, host_admission.budget())
+    assert ok is False and "memory_full_avg60_pct" in why
+
+
+def test_admit_reads_proc(tmp_path):
+    ok, why, now = host_admission.admit("ci", proc=_fake_proc(tmp_path, 45.0))
+    assert ok is False and now["memory_full_avg60_pct"] == 45.0
+
+
+def test_light_kind_always_admitted(tmp_path):
+    ok, why, _ = host_admission.admit("agent", proc=_fake_proc(tmp_path, 99.0))
+    assert ok is True and "not a heavy kind" in why
+
+
+def test_unreadable_host_is_admitted_and_says_so(tmp_path):
+    ok, why, now = host_admission.admit("ci", proc=tmp_path / "missing")
+    assert ok is True and "unjudged" in why and now is None
+
+
+def test_budget_override_and_malformed(monkeypatch):
+    monkeypatch.setenv("AWRUN_HOST_BUDGET", '{"memory_full_avg60_pct": 90}')
+    assert host_admission.budget()["memory_full_avg60_pct"] == 90.0
+    monkeypatch.setenv("AWRUN_HOST_BUDGET", "not json")
+    assert host_admission.budget() == host_admission.DEFAULT_BUDGET
+
+
+def test_dispatch_requeues_heavy_item_on_starving_host(tmp_path, monkeypatch):
+    store = RunStore(tmp_path / "q")
+    item = store.submit("ci", {"job": "x"})
+    monkeypatch.setattr(host_admission, "sample", lambda proc=None: dict(STARVING))
+    ran: list = []
+
+    def fn(i):
+        ran.append(i.id)
+        return 0, "ok"
+
+    back = dispatch_once(store, worker_id="w1", run_fns={"ci": fn}, now_fn=lambda: 1000.0)
+    assert back is not None and back.id == item.id
+    assert back.status == STATUS_QUEUED and ran == []
+    assert store.list(statuses=[STATUS_FAILED]) == []
+    assert "host over budget" in (back.wait or {}).get("reason", "")
+    assert back.not_before > 1000.0
+
+
+def test_dispatch_runs_heavy_item_on_calm_host(tmp_path, monkeypatch):
+    store = RunStore(tmp_path / "q")
+    store.submit("ci", {"job": "x"})
+    monkeypatch.setattr(host_admission, "sample", lambda proc=None: dict(CALM))
+    ran: list = []
+    dispatch_once(store, worker_id="w1",
+                  run_fns={"ci": lambda i: (ran.append(i.id), (0, "ok"))[1]},
+                  now_fn=lambda: 1000.0)
+    assert len(ran) == 1