# Changelog

> What's new in K-Agent. Version 1.0 was released on 6 October 2026.

## v1.0 — 2026-10-06

The first release of K-Agent: one agent, use it anywhere. API version `2026-10-06`.

### Use your agent anywhere

- **One-shot answers** with `POST /v1/agents/{agent}/ask`, including caller-supplied history, per-request overrides, a private `store: false` mode and opt-in actions.
- **Chat sessions** with platform `sess_` IDs or **your own `external_id`**, get-or-create, addressable by either ID everywhere — the published [session ID contract](/docs/en/concepts/sessions/#the-session-id-contract).
- **Streaming** over Server-Sent Events, resumable with `Last-Event-ID`, with authoritative `*.completed` events.
- **Concurrency policies** per session: `queue`, `reject` and `interrupt`.
- **OpenAI-compatible endpoint** at `/openai/v1/chat/completions`, with the agent slug as the model, optional sessions and a `kagent` extension.
- **Web widget** (`<k-agent-chat>`) with publishable keys, allowed origins, anonymous visitors and verified users via client tokens.

### Configure once, see everything

- One configuration document covering identity, Arabic dialect and tone, instructions, knowledge, tools, guardrails, handoff, business hours, conversation, model, variables, overrides, fallback and widget — always returned complete.
- **Drafts and versions:** auto-published v1, `If-Match` editing with JSON merge patch, publish, restore, diff, export and import, `config_hash` on every run.
- **Prompt X-ray** (`prompt_preview`) showing every block with its source, version and tokens.
- **Readiness** with explicit blockers, and pause switches `ai_paused` and `actions_paused`.
- Starter templates: customer support, sales questions, booking assistant and internal FAQ.

### Safety in code

- The never-handle list, on by default and placed last in the prompt.
- The verbatim escalation reply for liability handoffs, in Arabic and English.
- Truthful handoff results (`queued`, `recorded`, `recorded_closed`, `already`, `failed`) and the never-silent rule with retries, fallback models and a fallback message.
- Sliding handoff expiry, technical handoffs that don't mute the conversation, and the **Handoff Desk** with claim, reply, internal notes, release, close and take-over.

### Tools and knowledge

- Built-in tools: `transfer_to_human`, `create_ticket`, `flag_conversation` and `search_knowledge`.
- **HTTP tools** with fail-closed templating, secrets with allowed hosts, identity from verified end users, response projection, a live test endpoint and signed outbound calls.
- **Client tools** with `requires_action` and `submit_tool_outputs`.
- Knowledge sources (`text`, `catalog`, `api`) in `always` or `searchable` mode, with Arabic-aware search and scheduled API refresh that keeps the last good copy.
- A protected network client for every URL you configure.

### Platform

- Secret keys with scopes and agent restrictions, publishable keys, client tokens, and team roles (owner, admin, developer, editor, support, viewer).
- Standard Webhooks with retries, a delivery log and test events; an event log at `/v1/events`.
- The **AI conversation** billing unit with model weights, quotas and alerts, and the usage API.
- Bring your own model key (OpenAI, Anthropic, DeepSeek or any OpenAI-compatible provider), checked live.
- Audit log, end-user erasure and retention settings.
- Bilingual docs in Arabic and English, an interactive API reference, `llms.txt` and a Markdown version of every page.