What changed,
without the noise.
Review the adoption impact of each SDK release. These notes consolidate coordinated package updates while the linked changelogs remain the exhaustive technical record.
Polished multimodal React chat
React 0.3 upgrades the ready-made chat with bounded attachments, richer run and tool feedback, safer errors, explicit themes, and a more accessible responsive UI.
- Add starter prompts plus file, image, and audio attachments through selection, paste, or drag-and-drop with application-controlled type, count, and size limits.
- Show expandable run activity, grouped tool execution, message status and copy actions, optional idempotent retry, and governed approval rejection reasons.
- Choose system, light, or dark themes and comfortable or compact density, customize stable data-slot attributes, and rely on improved keyboard, screen-reader, and responsive behavior.
@zhivex-ai/react@0.3.0Focused entrypoints, capability profiles, and runtime hardening
TypeScript 1.7 makes package boundaries explicit, gives the SDK ownership of the release-managed model catalog, adds richer Beta provider contracts, and hardens shared runtime behavior.
- Import focused Core contracts, runtime, workflow, UI, Node, or testing surfaces without relying on internal files; use explicit SDK catalog, Beta, and Experimental entrypoints when those boundaries matter.
- Use the SDK-owned default model catalog for future inventory updates, while provider authors can model native, prompted, conditional, or unsupported capabilities and dispatch provider-neutral resource operations.
- Isolate generation caches by authentication scope, persist file caches through bounded private atomic storage, preserve abort reasons with cleanup, and cover streamed failures with per-model circuit-breaker probes.
@zhivex-ai/sdk@1.7.0@zhivex-ai/core@1.7.0@zhivex-ai/anthropic@0.7.4@zhivex-ai/azure-openai@0.6.12@zhivex-ai/bedrock@1.0.2@zhivex-ai/deepseek@0.4.3@zhivex-ai/gemini@0.10.5@zhivex-ai/kimi@0.7.6@zhivex-ai/meta@0.2.2@zhivex-ai/ollama@0.5.1@zhivex-ai/openai@0.9.6@zhivex-ai/openrouter@0.5.17@zhivex-ai/qwen@0.10.2@zhivex-ai/vertex@0.9.5@zhivex-ai/xai@0.1.6@zhivex-ai/zai@0.1.1Stable artifacts, catalog, OpenTelemetry, and CLI
Artifact persistence, immutable model catalogs, privacy-first OpenTelemetry adapters, and the installed zhivex-ai CLI are now Stable contracts.
- Persist bounded, schema-versioned artifacts through in-memory, file, SQLite, or Postgres services with integrity checks and explicit external references.
- Use immutable provider-scoped model catalog snapshots with aliases, recommendations, versioned pricing metadata, and explicit pinned or rolling update policy.
- Instrument model, agent, tool, and workflow activity with Stable OpenTelemetry adapters, or use the schema-backed local CLI with strict argument validation and dry-run-first pruning.
@zhivex-ai/sdk@1.6.0@zhivex-ai/core@1.6.0Stable SQL workflows, evaluation gates, and agent control plane
SQLite and Postgres workflow state, workflow evaluation baselines and regression gates, and the focused Agent Control Plane contract are now Stable.
- Run durable workflows on SQLite or Postgres through the same Stable state-service contract used by in-memory and file implementations.
- Create versioned workflow evaluation baselines and fail-closed regression gates for deterministic or model-judged CI evidence.
- Use @zhivex-ai/agents/control-plane for capsules, approval queues, ledgers, capability routing, governance policy, and durable single-consumer approval resume.
@zhivex-ai/sdk@1.5.0@zhivex-ai/core@1.5.0@zhivex-ai/agents@1.2.0Stable realtime sessions and live agents
The shared realtime and live-agent lifecycle is now Stable, with hardened transport, tools, approvals, persistence, and provider-specific Live protocol behavior.
- Build raw realtime sessions or compose local tools, guardrails, telemetry, and optional durable state with streamLiveAgent().
- Use the shared contract across OpenAI, Azure OpenAI, Gemini, Vertex, and Qwen while keeping model and preview availability provider-scoped.
- Rely on stricter frame bounds, tool-call deduplication, post-tool continuation, cancellation, idempotency, memory context, and fail-closed approvals.
@zhivex-ai/sdk@1.4.0@zhivex-ai/core@1.4.0@zhivex-ai/agents@1.1.0@zhivex-ai/azure-openai@0.6.11@zhivex-ai/gemini@0.10.4@zhivex-ai/qwen@0.10.1@zhivex-ai/vertex@0.9.4Meta agents, safer tools, and restored publication
Python 0.18.2 publishes the complete 0.18 line with Beta Meta Model API support, stronger typed agent controls, richer evaluations, and a repaired PyPI release path.
- Use the Beta Meta Model API adapter for Muse Spark text, streaming, JSON Schema output, callable and hosted tools, files, and continuation.
- Build typed tools with schema-derived inputs, guardrails, cooperative cancellation, and bounded agent-group execution.
- Install the successfully published 0.18.2 artifacts; the failed 0.18.0 and 0.18.1 tags were preserved while the publication workflow was repaired.
zhivex-ai-sdk@0.18.2Native Z.ai and refreshed Meta models
Zhivex adds a first-party Z.ai adapter and refreshes Meta, Ollama, OpenRouter, Gateway, and catalog support around current GLM and Muse model families.
- Use GLM-5.3 and GLM-5.2 through a native Z.ai provider with model-aware reasoning, tools, streaming, and JSON output.
- Use Muse Spark 1.2 directly through Meta, with corrected tool choice, retry, and Responses streaming behavior.
- Discover the new models through the shared catalog, Gateway registration, CLI scaffolding, and provider smoke coverage.
@zhivex-ai/sdk@1.3.0@zhivex-ai/core@1.3.0@zhivex-ai/gateway@1.1.0@zhivex-ai/meta@0.2.0@zhivex-ai/ollama@0.5.0@zhivex-ai/zai@0.1.0Ollama REST parity and Ollama Cloud
The Ollama adapter now follows the native REST contract more closely across tools, reasoning, streaming errors, cloud authentication, and the current model catalog.
- Tool arguments and correlated tool results now use the object shapes expected by Ollama.
- Thinking is preserved through streamed and non-streamed tool loops, with shared reasoning controls.
- Ollama Cloud authentication and current Gemma, Qwen, GPT-OSS, and EmbeddingGemma catalog entries are included.
@zhivex-ai/sdk@1.2.0@zhivex-ai/core@1.2.0@zhivex-ai/ollama@0.4.0Durability, approvals, and release trust hardening
A coordinated patch strengthens durable subagent recovery, state persistence, approvals, provider diagnostics, authenticated redirects, and release artifact verification.
- File-backed state uses safer atomic persistence and stronger revision conflict handling.
- Approval, redaction, remote media, and provider diagnostic boundaries fail more safely.
- Published artifacts are checked more tightly against the intended release source and provenance.
@zhivex-ai/sdk@1.1.2@zhivex-ai/core@1.1.2@zhivex-ai/agents@1.0.2@zhivex-ai/anthropic@0.7.3@zhivex-ai/azure-openai@0.6.10@zhivex-ai/gateway@1.0.3@zhivex-ai/gemini@0.10.3@zhivex-ai/kimi@0.7.5@zhivex-ai/react@0.2.2@zhivex-ai/vertex@0.9.3Qwen 3.8 Max and fenced workflow recovery
Python adds the production Qwen 3.8 Max contract, explicit workflow definition revisions, typed workflow failures, and stronger lease and checkpoint fencing.
- Qwen 3.8 Max covers text, streaming, reasoning, multimodal inputs, tools, and hosted-tool contracts.
- Workflow steps and edges can carry definition revisions so configuration changes invalidate unsafe resumes.
- Postgres workflow stores gain bounded pools, namespaces, explicit lifecycle control, schema checks, and server-clock leases.
zhivex-ai-sdk@0.17.0Production Qwen 3.8 Max support
Qwen 3.8 Max moves onto the production Model Studio contract with hybrid reasoning, multimodal input, tools, structured output, catalog metadata, and smoke coverage.
- Use the pay-as-you-go qwen3.8-max model separately from the Token Plan preview contract.
- Text, images, tools, structured output, and reasoning are validated against the model-specific transport rules.
- Examples, catalog metadata, and provider regression coverage now target the production model.
@zhivex-ai/sdk@1.1.1@zhivex-ai/core@1.1.1@zhivex-ai/qwen@0.10.0Stable workflows and a stronger React chat surface
Declarative workflows graduate to Stable while the React package gains safer server boundaries, richer multimodal chat, controlled sessions, and broader browser coverage.
- Workflow creation, execution, replay, schema contracts, and in-memory or file state services are now Stable.
- SQL workflow state, workflow evaluation, artifacts, and CLI workflow helpers remain Beta.
- React adds server-safe subpaths, multimodal input, bounded streaming updates, stopped-message state, and accessibility improvements.
@zhivex-ai/sdk@1.1.0@zhivex-ai/core@1.1.0@zhivex-ai/gemini@0.10.2@zhivex-ai/react@0.2.1@zhivex-ai/vertex@0.9.2Evaluations, protocols, CLI, and workflow leases
The SDK adds Beta evaluation experiments, A2A and AG-UI adapters, a constrained Responses host, a local CLI, and execution leases for durable workflows.
- Run repeatable evaluation variants with thresholds, regression gates, redacted trajectories, JSON artifacts, and JUnit output.
- Expose server-owned agents through constrained A2A, AG-UI, and Responses-compatible adapters.
- Coordinate durable workers with heartbeat, cancellation, and fenced execution leases.
zhivex-ai-sdk@0.16.0Durable workflow graphs
Python gains durable workflow graphs with append-only checkpoints, resume and fork, bounded parallel execution, retries, and adapter contracts for external workflow engines.
- Build versioned graphs with persisted routing decisions and fail-closed definition validation.
- Resume interrupted runs or fork a new run from an immutable checkpoint without rewriting lineage.
- Use in-memory, SQLite, or Postgres stores with optimistic sequence and idempotency checks.
zhivex-ai-sdk@0.15.0Typed agent dependencies and outputs
Agent dependencies, context, tools, middleware, hooks, and final outputs gain stronger generic typing and top-level static declarations.
- Carry typed application dependencies across tools, handoffs, streaming, approvals, and idempotent reuse.
- Validate the complete agent result against the root output type, including terminal handoff responses.
- Use stable lifecycle hooks and middleware with improved static inference from public imports.
zhivex-ai-sdk@0.14.0Stable DeepSeek V4 provider
DeepSeek joins the tier-1 portable provider set with current V4 generation, streaming, structured output, tools, reasoning, usage, retry, and routing contracts.
- Use create_deepseek() through the documented stable public surface.
- Preserve reasoning content safely across tool loops and normalize provider usage metadata.
- Keep unsupported vision, files, embeddings, audio, moderation, and hosted tools explicit.
zhivex-ai-sdk@0.13.0