Repository navigation
[0.1.0] - First Release
Added
-
Backend foundation: FastAPI API, PostgreSQL with Alembic migrations, Redis cache with an
in-memory fallback, Argon2id passwords, JWT access tokens with rotating refresh tokens, scoped API
keys, councils, Docker images and CI. -
Multi-provider LLM layer: Anthropic (official SDK), OpenAI, Gemini, Mistral, Groq,
OpenRouter, DeepSeek, xAI, Together, Ollama, vLLM, LM Studio, llama.cpp, custom
OpenAI-compatible endpoints and an offline mock provider, with routing, fallbacks, caching and
cost accounting; provider health checks and masked key hints. -
Council runtime: planning, parallel execution, a thought bus with interception and
correction, guardrails, approvals with argument editing, votes, an append-only event log and live
Server-Sent Events with resumption. -
Agent protocols: MCP server and client, A2A, ACP, and a per-user hash-chained protocol ledger
with verification; liveprotocol.callevents; MCP trust levels, per-tool approval and a
remote-agent approval flag; MCP discovery and A2A/ACP refreshes ledgered. -
Modes and outputs: a coding sandbox container with no network route, research tools with
numbered sources, chat; exports to txt, md, html, LaTeX, PDF, DOCX and JSON. -
Skills:
SKILL.mdpackages loaded on demand, six built-in skills, an eight-skill marketplace,
import and export, and version history with restore. -
CLI agents: council seats on the vendors' official CLIs (Claude Code, Codex CLI, Gemini CLI),
signed in with the owner's own account or a per-user CLI API key, run by an opt-inrunner
container with every built-in CLI tool off; vendor sessions kept per seat, hybrid councils with
per-seat fallback chains, subscription usage reported apart from API spend, and
scripts/agent-login.sh. Off unlessARGUS_CLI_AGENTS_ENABLED=true. -
Sub-councils: the
subcounciltool with clamped guardrails, budget charge-back, a depth
limit and a live relay into the parent's stream. -
Knowledge: knowledge bases with BM25 search and citations, and council-scoped memory.
-
API integration: signed webhooks with retries, idempotent run creation, write scopes on
every router and protocol write path, run templates with variables, and in-app notifications. -
Roles: admin, member and viewer, with admin user management.
-
Observability: Prometheus metrics, an audit log and run insights.
-
Data: scheduled retention for runs, events and audit rows, account export and deletion.
-
Web UI: run composer, command palette, live run workspace with Timeline, Map, Gantt, Heatmap
and Route views and replay, council builder, skills library and editor, knowledge, templates,
connections and ledger browser, insights, audit log, and settings for profile, API keys,
webhooks, data and users. -
Operations:
deploy.sh,update.sh(backup and automatic rollback),restore.sh,
build.shandsmoke.sh. -
Reviews: implementation, design consistency and UI specification reports in
docs/, and a
security audit and threat model indocs/security/with aSECURITY.mdreporting policy. -
Reliability: runs always reach a final status (database blips, restarts, start failures,
cancels racing starts), transient provider errors are retried, live streams end on shutdown,
sub-councils have their own timeout and share the parent's budget, protocol calls no longer hold
database connections, and a Redis outage degrades instead of failing every request. One JSON
error envelope with a request id, bounded Prometheus labels, failure-mode metrics and alert rules
indeploy/prometheus/. -
Data: a durable, bounded webhook outbox; PDF uploads to the knowledge base; a server-side
ledger purpose filter; account export and deletion that cover everything a user owns; insights
that count sub-council spend once. -
Security: SSRF and DNS-rebinding guards on every outbound connection, a sandbox with no
network that is reached over a Unix socket, server-side logout and session revocation, login
throttling that cannot be bypassed with forwarded headers, admin changes restricted to sessions
or full-scope keys, optional TOTP two-factor sign-in with recovery codes, a separate uid for every
sandbox execution, capped peer response bodies, and a smoke test that no longer leaves a known
admin account behind. -
Operations:
backup.shwith verified, checksummed backups;update.shrollback that
restores or downgrades the schema; immutable rollback image tags; a stub-docker test harness and
a real backup, update, rollback and restore run in CI. -
Web UI consistency: shared page widths, headers, breadcrumbs, filters, form actions and
segmented controls; a More tab on phones; the run inspector and council rail on small screens;
field-level sign-in errors; a session that survives rate limits and outages at startup; one
toolbar across the run views; 24 px and 44 px touch targets; accessibility fixes. -
Brand and documentation: the Argus Council mark and lockups (
docs/brand/, generated by
tools/build_brand.py), a README with Mermaid diagrams, a MkDocs Material documentation site
published to GitHub Pages with a generated API reference, a wiki mirror, contributor files,
issue and pull request templates, and Dependabot. -
Auto councils: the composer can compose the council for the task (Council: Auto). A planner
model reads the topic and picks the roles, how many of each and a focus per seat, always with a
chair and an overseer; with no model reachable a keyword planner does it instead. Preview the
council before starting, or let the server plan when the run starts (RunIn.auto_council,
POST /runs/plan, explicitRunIn.seats). -
Auto models per seat (Model: Auto): every seat gets a model from the providers you have
connected (RunIn.auto_models), chosen by competence for the role against expected cost. Each
role states the competences it needs (reasoning, coding, writing, speed), a floor and how many
input and output tokens a seat uses over a run; each model has a competence profile and a price per
input and output token (billing price, public list price, or a flagged name-based estimate; free
for subscription CLI accounts and self-hosted endpoints). A strategy (model_strategy:quality,
balanced,economy) sets the trade-off, and the council is fitted to the run's dollar budget by
the cheapest downgrades first and, for an auto council, by shedding optional seats. The planner is
told what seats cost, the plan preview shows each seat's competence and expected spend and the
total, andARGUS_MODEL_PROFILESoverrides competence and reference prices. -
Competence-aware step assignment: a step the chair's plan does not assign goes to the member
most competent for that kind of work, net of load and cost (no more round robin); a role held by
several members goes to the least loaded. Sub-councils pick a model per child seat from the parent
council's models within the child's budget. -
Structured reports for research and general runs (Reports): a
pipeline of specialised agents (architect, data analyst, parallel section authors, editor, reviewer,
revisers) buildsreport.jsonwith an outline check-in (validator, independent reviewer and,
withguardrails.report.human_checkins, you), analyst-only chart data, a review loop of autofix,
a deterministic validator (structure, data shapes, citations, provenance of numbers, placeholders)
and a reviewer agent that revises flagged sections until the report passes (rolling back any
revision that scores worse), budget-aware fallbacks at every stage, and a quality-assurance
appendix. Rendered to PDF (cover, linked contents, lists of figures and tables, bookmarks, KPI
cards, vector charts, risk matrix), self-contained HTML (inline SVG charts with data tables, dark
mode), DOCX (charts as images), LaTeX (pgfplots), Markdown (Mermaid), text (ASCII charts) and JSON;
every export is read back and checked, and retried more conservatively when it fails
(guardrails.report:depth,max_review_rounds,pass_score,human_checkins). -
Research library: every page agents read is captured, with its source URL and the run that
read it, into a per-user knowledge base that every later run searches. Deduplicated by URL and
capped, evicting the least recently used sources (ARGUS_KNOWLEDGE_CAPTURE_ENABLED). -
Knowledge without files: add pasted text or a page fetched from a URL to any knowledge base
(POST /knowledge-bases/{id}/documents/textand/url). -
Linked knowledge: attach knowledge bases to a run before it starts (
knowledge_base_ids) or
while it runs (POST /runs/{id}/knowledge); agents are told about them from their next turn. -
Run archive and trash: archive runs out of the main list, move runs to a restorable trash,
empty it, and purge it automatically afterARGUS_RETENTION_TRASH_DAYS(30). -
Council map levels: oversight, council, and tools sit on separate boards at separate levels
(sub-councils and you on boards of their own), and conduits are routed in gutters, through gaps
and along spines with their own lanes instead of cutting across platforms. -
Live web data:
market_data(quotes and daily history for stocks, indices, FX, crypto and
futures, from the Yahoo Finance chart API with a Stooq fallback) andnews_search(Google News,
by recency and region). Both are keyless, so they work without a search provider, run under the
same network checks asweb_fetchand record every data URL as a source with its retrieval time.
web_fetchalso reads CSV, TSV, RSS and Atom documents. -
New roles:
scout(live web and news gathering),market_analyst(live market data),
fact_checker(verifies figures and claims against live sources) anddata_analyst(works over
spreadsheets in full). Auto councils pick them from the topic; the research roster's second
researcher is now a scout. -
Spreadsheets in knowledge bases:
.csv,.tsvand.xlsxuploads, every sheet stored row by
row with each cell labelled by its column and chunked on row boundaries.knowledge_readreads a
whole document or sheet in order, so agents can compute over full tables. -
Raising limits instead of halting: a run that reaches its step, per-agent iteration, runtime or
token limit asks you in the approval queue to raise it (guardrails.extensions); approve and it
carries on, reject and it halts as before. Waiting does not count toward the runtime. -
Context condensation: an agent whose history outgrows
guardrails.context.budget_chars, after
old tool outputs are trimmed, has the middle of it summarised into its task by its own model.
Changed
deploy.shis the single install-and-update command: it runs every pending migration as an
explicit step (also inupdate.sh, before the new API starts), with--pullto update.- The offline
mockprovider is no longer offered anywhere unlessARGUS_ENABLE_MOCK_PROVIDERis
set (it stays on for the test suite). - Skill descriptions may be up to 20,000 words; agents see a summary in their skill index and the
full text when they load the skill. Loaded skills are never trimmed from an agent's context.
Fixed
- PDF reports print the rupee sign and other non-Latin-1 characters instead of black boxes: reports
and charts embed DejaVu Sans (shipped with the backend) in place of the standard Helvetica and
Courier. KPI cards shrink a long value to fit and break a range after its dash, never mid-number. pypdf6.21.4 fixes three denial-of-service issues in PDF parsing (CVE-2026-119203,
CVE-2026-119204, CVE-2026-119205) that failed the image scan.- OpenAI's reasoning models (GPT-5, o-series) work: the official API is sent
max_completion_tokens
instead ofmax_tokens, and notemperaturefor models that only take the default. Any
OpenAI-compatible endpoint that rejects either parameter with a 400 is retried once with the
adjusted request, and the adjustment is remembered for that model. - Guardrail warnings no longer look like failures: only events that blocked or halted something are
red; warnings and redactions are amber. Each one is a one-line summary that expands to the rule,
limit, what was observed, the tool, the source page and, for flagged instruction-like text, the
matched phrase with the text around it. Such warnings now count as medium in Insights and as
status, not errors, in the communications heatmap. - Sandbox commands that leave a background process holding stdout or stderr open (
cmd &) no
longer hang until the timeout and report a kill: once the command exits, background processes
get a one-second grace to finish writing, then everything the run started is stopped. This was
the cause of the failing CI compose smoke test. - Test connection works for every provider, not only Anthropic: it no longer needs a default model,
and any model id can be tested. Hosted kinds now suggest models. notes_write(and other list arguments) accept a comma-separated or JSON-encoded string, which
models often send, instead of failing with "Input should be a valid list".
What's Changed
- Ton of Upgrades by @morpheuslord in #1
- Bump node from 22-alpine to 26-alpine in /frontend by @dependabot[bot] in #2
- Bump @types/node from 22.20.5 to 26.6.5 in /frontend by @dependabot[bot] in #6
- Bump astral-sh/setup-uv from 10.3.0 to 10.3.2 in the actions group by @dependabot[bot] in #3
- Bump @testing-library/jest-dom from 6.9.1 to 7.0.1 in /frontend by @dependabot[bot] in #9
- Bump jsdom from 25.0.1 to 30.1.3 in /frontend by @dependabot[bot] in #8
- Bump react-markdown from 9.1.0 to 10.1.0 in /frontend by @dependabot[bot] in #7
- Bump zustand from 4.5.7 to 5.0.16 in /frontend by @dependabot[bot] in #4
- code fixes by @morpheuslord in #10
- Knowledge library archive map by @morpheuslord in #11
- Skip the wiki sync with a warning until the wiki exists by @morpheuslord in #12
- Auto council by @morpheuslord in #14
- Run CI's UI end-to-end test with the offline mock provider by @morpheuslord in #13
- Softer guardrail warnings by @morpheuslord in #15
- OpenAI max completion tokens by @morpheuslord in #16
- Remove the UI end-to-end step from CI's docker job by @morpheuslord in #17
- Pick models by competence and token cost; build reports with checked … by @morpheuslord in #18
- Add live web data agents, limit raising, context condensation and spr… by @morpheuslord in #19
New Contributors
- @morpheuslord made their first contribution in #1
- @dependabot[bot] made their first contribution in #2
Full Changelog: https://github.com/lordprime/Argus-Council/commits/v0.1.0