SDK changelog · Liyagent Documentation

What changed in each release of the SDKs. Install and quickstart are on SDKs.

Python: `liyagent` on PyPI

AsyncClient: every call of Client for asyncio (await, and
async for over agents.list()), over httpx.AsyncClient.
Retries with exponential backoff and jitter: a 429 or 503 (any method)
and an unreachable server are sent again, and a 500, 502, 504 or read timeout for GET, PUT and DELETE; Retry-After is respected. max_retries= (default 2, 0 turns them off).
An exception class per kind, all subclasses of LiyagentError:
AuthenticationError, PermissionDeniedError, NotFoundError, BadRequestError, ConflictError, RateLimitError, InternalServerError, APIConnectionError. Each carries request_id (the server's X-Request-Id, also in the message), method and path. 429 is now kind rate_limited and 5xx kind server (both were error).
A refused sign-in or service-account exchange says the server's reason;
a sign-in that asks for an authenticator code says to use a service account. knowledge.answer without an API key says to pass api_key=.
README rewritten for a first-time user: a quickstart that runs, where the
token comes from, core concepts, errors, retries, asyncio. Package links to the docs, the changelog and support.

Release-ready package metadata (classifiers, URLs, py.typed), the
version read from liyagent.__version__, and a GitHub Actions release to PyPI by trusted publishing.
Typed request bodies (liyagent.models: a TypedDict per body and
REQUEST_BODIES) generated from the server's OpenAPI document.
templates.install(..., params=) sends template parameters.
Authoring the tenant's own templates: templates.authored,
authored_versions, validate, draft_from_agent, save_draft, publish, delete_draft, withdraw.

First version: agents, runs, evals, knowledge, approvals and solution
templates over httpx; check_server().

CommonJS as well as ES modules: require("@liyagent/sdk") works (0.2.0
was ESM only), each with its own type declarations.
Works in browsers and edge runtimes: the global fetch is no longer
called as a method of the client (which threw "Illegal invocation").
Retries with exponential backoff and jitter: a 429 or 503 (any method)
and an unreachable server are sent again, and a 500, 502 or 504 for GET, PUT and DELETE; Retry-After is respected. maxRetries (default 2) and timeoutMs (default 60000) options.
An error class per kind, all subclasses of LiyagentError:
AuthenticationError, PermissionDeniedError, NotFoundError, BadRequestError, ConflictError, RateLimitError, InternalServerError, APIConnectionError (a network failure, which 0.2.0 let through as a bare TypeError). Each carries requestId. A non-JSON error body (a proxy's HTML page) no longer throws a SyntaxError.
The Python SDK's calls: agents.list (an async iterator over every
page), delete, start, stop, workflows, workflowRun; runs; evals.dataset, createDataset, runs, compare, wait; knowledge.collections, articles, approveArticle, rejectArticle; approvals.get; templates.get, installs; checkServer() and missingOperations().
username/password sign-in, and LIYA_URL, LIYA_TOKEN and
LIYA_API_KEY read where there is a process.env.
send<T>() takes the response type.
README rewritten for a first-time user; package links to the docs and
support.

First release-ready package: dist/ built with declarations, exports
map, engines, npm pack builds first (prepack), published with npm provenance from GitHub Actions.
Typed request bodies (models.ts) generated from the server's OpenAPI
document; templates.install/preview, agents.apply and templates.draftFromAgent take them.
templates.install sends template parameters (params).
Authoring the tenant's own templates: authored, authoredVersions,
validate, draftFromAgent, saveDraft, publish, deleteDraft, withdraw.
VERSION export.