v0.5.0

npx @edgaralochi/yada@0.5.0 init my-agent

• New default widget look: monochrome, with Yada's face changing as a run progresses.
• New widget API, covered by semver: name, subtitle, avatar, header, fill, colorScheme, styles, unstyled, composer, suggestions, render hooks, formatApprovalPreview, documented CSS parts and variables, slots, lifecycle events, and data-state, data-connection and data-mood on the host.
• quota, limits and provider on a profile can be a value or a function, resolved once per run. A run keeps its starting values.
• Corrupt records are quarantined and fail their run cleanly, with quarantined() to inspect them.
• BrowserClient has timeoutMs, and resuming a missing run clears quietly.

Behaviour changes. The default look, title and composer changed. Approve is now green and decline red. Usage events with cache or server tool fields no longer corrupt runs. Runs have a new corrupt_record failure code. Client requests time out after 15 seconds by default. Upgrade notes

Requires Node 24. The attached archive is the package published to npm; verify it with shasum -a 256 -c SHA256SUMS.

v0.4.0

npx @edgaralochi/yada@0.4.0 init my-agent

• Per-actor MCP connections with createMcpActorPool: one tool catalog, pooled OAuth connections, public tools and a connect flow.
• hiddenArguments fills arguments such as idempotency keys on the server, derived from the operation id.
• rememberApprovals restricts or turns off remembered approvals on the handler and worker.
• Typed ToolCallError with code and delivery, and reconnection after expired MCP sessions without repeating writes.
• Cost reservations at submission and an optional global budget for quotas.
• eraseActor, OAuth token revocation on disconnect and cleanup of unused OAuth records.
• Widget: yada-run-end event, and messages sent as a run finishes are no longer lost.

Behaviour changes. Standard JSON Schema formats are now enforced on MCP inputs, outputs and elicitation answers. Actions have a new undelivered status. Runs that exhaust their retries now add their cost to quotas. Upgrade notes

Requires Node 24. The attached archive is the package published to npm; verify it with shasum -a 256 -c SHA256SUMS.

v0.3.0

Create a standalone Yada agent with one command:

npx @edgaralochi/yada@0.3.0 init my-agent

Set your provider credentials in my-agent/.env, then run npm start from that directory.

• One provider config: YADA_LLM_PROVIDER, YADA_LLM_MODEL and YADA_LLM_API_KEY, with native Gemini, the OpenAI Responses API and provider-hosted web search on by default.
• Durable sub-agents, mid-run steering, long-term memory, persisted conversation summaries and tenant quotas.
• MCP sampling and elicitation, OpenTelemetry through @edgaralochi/yada/otel, and evals through @edgaralochi/yada/evals.
• More reliable runtime and service: model-call retries, fallback models, approval recovery, shared rate limits, storage key rotation and streaming backups.
• A much smaller widget bundle (about 25 KB).

Breaking changes. Stop older Yada versions before upgrading, because they can't read the new storage format. Remembered approvals are reset, the conversation-list cursor format changed, client errors now return 4xx, JSON endpoints require Content-Type: application/json, and chatModelAdapter and otelTracer moved to @edgaralochi/yada/langchain and @edgaralochi/yada/otel. See the upgrade notes.

Requires Node 24. The attached archive is the package published to npm; verify it with shasum -a 256 -c SHA256SUMS.

Starter guide · Skills guide

v0.2.0

Create a standalone Yada agent with one command:

npx @edgaralochi/yada@0.2.0 init my-agent

Set your provider credentials in my-agent/.env.starter, then run npm start from that directory.

• Packaged initializer with private config, SQLite storage, a skills folder and the wired starter.
• Optional workspace login and the branded chat widget.
• Reusable SKILL.md instructions and text resources from Claude, Cursor and Codex. Script execution and product-specific hooks still require host integration.

Requires Node 24. The attached archive is the package published to npm; verify it with shasum -a 256 -c SHA256SUMS.

Starter guide · Skills guide

v0.1.0

First public release of Yada, a TypeScript runtime for in-app AI assistants with typed tools, configurable providers, approval flows, and durable conversations.

Published as @edgaralochi/yada@0.1.0 under the MIT license. Requires Node 24.

npm install @edgaralochi/yada

The attached npm archive matches the submitted npm package. Verify it with shasum -a 256 -c SHA256SUMS.