Repository navigation
Azathoth 1.4.0a3
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).