Repository navigation
Azathoth 1.4.0b1
Pre-release
Pre-release
azathoth.api, a public service API that the command line, azathoth-mcp
and the coming local editor all call. It browses and imports workflows,
tools and benchmarks, lists the models providers serve, keeps the model
portfolio, initializes databases, and runs and invokes workflows,
reporting each step and context change to a callback as it happens and
stopping when cancelled. It returns its own
frozen models, each with its equivalentazathothcommand, raises errors
with stable codes, and is provisional until 1.4.0
(ADR 0120).- azathoth-mcp runs each tool call through the service API. A call now asks
the providers what they serve, asazathoth job rundoes, rather than
once while production stays the same, so a model authorized or a tool
imported reaches a running server at once; a call the client cancels
cancels its invocation, which the same call under its key resumes
(ADR 0120). azathoth.apiruns and invokes a workflow on a file:RunFileholds a
document or an image, JSON or text, checked and kept as--input-file
keeps one, and refused before anything runs when it is not its media type
(ADR 0121).azathoth.apichecks a workflow document without saving it, naming every
problem with where it is and its step; says, step by step, whether a
document could run here now and on which models; and lists the
portfolio's models that meet a step's requirements, by the rules a run
uses
(ADR 0121).azathoth.apireads back the runs an instance kept: a workflow's runs
newest first, and one run with its input, its result, and each step's
output, values, measurements and failed attempts
(ADR 0121).azathoth.apitries one step of a workflow document alone, on the inputs
given, a file among them, reporting its events as a run does and keeping
no run
(ADR 0121).- Every workflow, tool and benchmark revision records its lineage: a
revision digest that covers its content and every revision before it, the
revision it was built on, and who imported it. Every portfolio entry
records its digest, who authorized it and when. The database schema is now
version 3; runazathoth initonce to upgrade a PostgreSQL database, which
records the lineage it already holds. An SQLite file is upgraded when it is
opened
(ADR 0122). - Importing a document identical to the latest revision appends nothing and
says so:Workflow <WORKFLOW_ID> is unchanged at revision <NUMBER>., and
likewise for tools and benchmarks. Before, it appended a duplicate
revision. Importing an earlier revision's document still appends a revert
(ADR 0122). - Who imports is
AZATHOTH_AUTHOR, asName <email>orName, or else the
operating system's username; a malformedAZATHOTH_AUTHORstops the
import, authorizing a model, and adding a benchmark case. The standard
tools are recorded as Azathoth's
(ADR 0122). workflow showandbenchmark showname each revision's digest, parent
and author, and history lines end with who imported each revision when
that is known
(ADR 0122).azathoth.apireports each revision's revision digest, parent and author,
and each portfolio entry's digest, author and time. Imports take
based_on, building on an earlier revision to fork, and return
WorkflowImport,ToolImportandBenchmarkImport, which say whether a
revision was created;api.opentakes theauthorto record
(ADR 0122).- Sensitivity labels: a run's input, a job's input and a benchmark case may
be labelledpublic,internalorrestricted, with--sensitivity,
an input source'ssensitivityor the service API'ssensitivity=.
Unlabelled data is internal and unchanged. A child workflow and a case
made from a run are never less sensitive than their source, and a
benchmark is as sensitive as its most sensitive case
(ADR 0123). - Each portfolio model declares what its provider does with data:
model authorize --no-retention --no-training, ormodel policyat any
time, which also shows who declared it and when. The database schema is
now version 4; runazathoth initonce to upgrade a PostgreSQL database
(ADR 0123). - Restricted input reaches only models declared to neither retain nor train
on data. A context prompt step that would send it anywhere else sends
nothing and says which model and what to declare, and a production
invocation's caller is told the same. Steps that choose a model, and
production with approved substitutes, choose a private one first;
semantic judges and the optimizer's substitutes of restricted cases must
be private; readiness and model matching take a label
(ADR 0123). - azathoth-mcp: an exposure document's tool may take
"sensitivity": "restricted", the operator's declaration that its client may hold
restricted data. Its calls are restricted, andget_invocationreturns no
restricted invocation through a tool not so exposed
(ADR 0123). - Labels are shown wherever data is: the API's run, invocation and
benchmark views, aSensitivity:line in show commands for data that is
not internal, a warning on standard error from every command that prints
restricted data, and theazathoth.sensitivityspan attribute. Tools are
not gated by labels in 1.4
(ADR 0123). - A remote:
azathoth remote serveserves an instance's workflows, tools
and benchmarks over HTTP, for other instances to push to and pull from,
with the newremoteextra.azathoth remote pushandpull, and the
service API'sinstance.remote(url), send each document's latest
revision, the revisions it was reached by, and the tool versions, child
workflows and benchmark content it needs, sending only what the other
side lacks. Production state, the portfolio and runs never travel
(ADR 0124). - Revision digests are a revision's identity everywhere; each instance
numbers what it saves. A remote moves only forward: a push whose lineage
diverged there is refused, and a pull forks a lineage that diverged here
on the revision its pulled revisions build on, so nothing is lost
(ADR 0124). - A remote's owner issues bearer tokens with
azathoth remote token create,
shown once and kept only as digests;listandrevokemanage them, and
a client reads its token fromAZATHOTH_REMOTE_TOKEN. The database schema
is now version 5; runazathoth initonce to upgrade a PostgreSQL
database
(ADR 0124). - A remote refuses restricted data unless it is served with
--accept-restricted, and a pull brings restricted benchmarks only with
--include-restricted
(ADR 0124). - A remote's authentication, policy and audit are seams a plugin fills,
through theazathoth.remoteentry-point group; the core's let only the
owner in and audit nothing. A remote's capabilities name its protocol,
versions, edition and plugins, and a client refuses another protocol
before sending anything
(ADR 0124). azathoth.api'smodels.matching(..., scope="catalog")matches every
model the providers serve, marked authorized or not, for a pulled
workflow's steps. The container image includes theremoteextra
(ADR 0124).azathoth.api'sremote.status()compares this instance with a remote:
each workflow, tool version and benchmark is in sync, ahead, behind,
diverged, or held by one side only, a workflow names the revision in
production at the remote, and each model says whether it is authorized
here and there. A remote that cannot be reached is no error: its side is
unknown, and its models are read from the portfolio last read from it
(ADR 0125).- A remote answers
/v1/heads,/v1/portfolioand/v1/credentials,
read-only, under a newread_portfolioaction andportfolio_readaudit
event. The credential check is asked by name, and never returns a value
(ADR 0125). azathoth remote pushwarns, after its report, of a credential its tools
need that the remote does not set, a child workflow the remote runs at
another revision or not at all, and a model its steps fix that the remote
has not authorized; a warning never refuses the push
(ADR 0125).- Database schema version 6 keeps the last portfolio read from each remote
(ADR 0125). azathoth remote add <NAME> <URL>names a remote, with the environment
variable its token is read from,AZATHOTH_REMOTE_TOKENunless
--token-variablenames another; the token itself is never kept.
remote listlists the names andremote removeforgets one, with the
last portfolio read from it.azathoth.api'sinstance.remotesdoes the
same
(ADR 0126).azathoth remote push,pullandstatus, andinstance.remote, take a
remote's name or its URL; anything holding:,/or.is read as a
URL, so a host given without its scheme is refused as one
(ADR 0126).azathoth remote status <REMOTE>reports how each workflow, tool version
and benchmark relates to the remote's, which revision is in production
there, and where each model is authorized; a remote that cannot be
reached is no failure, its models read from the last portfolio kept.
--output jsonwrites the service API'sRemoteStatus
(ADR 0126).- The database schema is now version 7, keeping the remotes an instance
names; runazathoth initonce to upgrade a PostgreSQL database
(ADR 0126).