Releases: baseitdev/openokapi
Releases · baseitdev/openokapi
2026.4.15
[2026.4.15]
Added
-
Extended control-plane modules and configs:
- New config modules: automations, hooks, scheduler, heartbeat, standing-orders, task-flow, tasks ledger, capabilities, cache, budget, guardrails, profiles, pricing, conversations, escalations
- New runtime modules: status, self-test, doctor, alerts, incidents, maintenance windows, escalations, smart router, profile runner, automation engine, hooks engine, event bus, backup, reset, security audit, budget enforcer, conversation chat
- New utility modules: response cache, pricing/cost helpers, template rendering
-
New CLI commands:
profile,cache,costs,replay,chat,pricing,capabilities,integrations,router,guardrails,eval,budget,automations,hooks,scheduler,self-test,standing-orders,task-flow,heartbeat,tasks,doctor,backup,reset,security,status,alerts,incidents,maintenance-windows,escalations
-
Gateway/API expansion:
- New route families: cache, costs, pricing, profiles, chat, capabilities, integrations (incl. DLQ ops), router, guardrails, evals, budget, automations, hooks, scheduler, heartbeat, standing-orders, task-flow, tasks, doctor, backup, reset, security, status, alerts, incidents, maintenance-windows, escalations, system self-test
-
Operational features:
- Background task ledger with audit, maintenance, cancellation, and notify policies
- Task flow orchestration with audit and retention maintenance
- Scheduler engine with
cron,every, andatscheduling modes - Heartbeat engine for periodic autonomous checks
- Incidents + alerts model with maintenance mute logic
- Escalation rules with cooldown and optional auto-incident creation
- Backup snapshot creation and checksum verification
- Reset planner/executor for scoped local state cleanup
-
Integration improvements:
- New
pagerdutyintegration type support across config/CLI/routes - PagerDuty-specific payload mapping (
trigger/resolve, severity mapping, dedup key handling)
- New
Changed
-
Maintenance-aware behavior:
- Alert reporting can bypass mute using
ignoreMute - Incident creation supports forced mode during maintenance (
forceWhenMuted/ CLI--force)
- Alert reporting can bypass mute using
-
Security and reset coverage:
- Security audit and reset scopes now include maintenance windows and escalations state files
Documentation
- Updated main docs and localized docs (
README.md,docs/COMMANDS.md,lang/pl/README.md,lang/de/README.md) to include:- New control-plane commands
- Maintenance windows and escalations workflows
- PagerDuty integration usage examples
- Additional automation and diagnostics coverage
2026.4.14
[2026.4.14]
Added
-
Request History System:
- New module
src/utils/request-history.tswith local JSONL-based request logging - New CLI command:
openokapi historywith--summary,--recent,--clearoptions and filters (--provider,--source,--action) - New HTTP endpoints:
GET /api/history/summary,GET /api/history/recent,DELETE /api/history - Request history persisted in
~/.openokapi/request-history.jsonlwith read-only file permissions (0600) - Automatic history tracking across CLI and API calls
- New module
-
Failover and Batch Processing:
- New failover execution layer in
src/functions/failover.tsfor automatic provider fallback - New CLI command:
openokapi batchwith--fileand--concurrencyoptions for batch request processing - New HTTP endpoint:
POST /api/batchfor concurrent multi-provider requests - Configurable fallback provider via
openokapi config --set-fallback
- New failover execution layer in
-
Streaming Endpoints:
- New
POST /api/claude/stream,POST /api/openai/stream,POST /api/ollama/streamendpoints with SSE (Server-Sent Events) - Real-time response streaming across all AI providers
- New
-
Web Panel UI:
- Full-featured web panel served at
GET /panelwith in-browser HTML/CSS/JS - API key login with localStorage session persistence
- Chat interface with provider/model selection
- Streaming mode toggle and manual ask/stream endpoints
- Batch request runner with JSON payload input and concurrency control
- History viewer with recent requests filtering
- Responsive design with mobile drawer menu and adaptive layout
- Panel client authenticated via
X-OpenOKAPI-Client: web-panelheader
- Full-featured web panel served at
-
Web Panel UI/UX Refinements:
- Removed Stream checkbox from navbar (always uses streaming by default)
- Reduced composer action button sizes: 36x36px (desktop), 34x34px (tablet), 32x32px (mobile)
- Reduced button SVG icons to 16x16px for better proportions
- Changed user message bubble background to match composer (#2b2b2f) for visual cohesion
- Reduced composer input font size: 15px (desktop), 13px (mobile/tablet) for subtler appearance
- Removed border and padding from provider/model selector container for cleaner layout
- Improved responsive breakpoint alignment (979px for mobile drawer trigger)
- Ensured consistent button layout (Clear chat left, Send right) across all device sizes
Changed
-
Security Hardening:
- Enhanced API key validation with User-Agent verification in gateway middleware
- Config file permissions updated to 0600 (read-only by owner) for API keys and history
- Config directory permissions set to 0700 (secure directory access)
- Improved error messages to avoid leaking sensitive provider information in CLI/API responses
-
provider Routes (OpenAI, Claude, Ollama):
- Integrated failover logic for automatic fallback between providers
- Enhanced streaming response handling with specific error messages (e.g., rate limit detection)
- Added request metadata tracking (provider used, fallback status)
-
CLI Commands:
- Updated
askcommands across all providers (OpenAI, Claude, Ollama) to support failover - Improved error handling and user feedback in CLI output
- Updated
-
Documentation:
- Updated
README.mdwith complete Gateway API section including streaming, batch, and history - Updated Polish translation (
lang/pl/README.md) with Gateway API details - Updated German translation (
lang/de/README.md) with Gateway API details - Updated
docs/COMMANDS.mdwith new CLI commands (history, batch, set-fallback)
- Updated
Fixed
- Fixed CLI build packaging path issues for filesystems with spaces
- Fixed global CLI wrapper path resolution for consistent installation
- Improved OpenAI stream error handling to detect and report specific errors (rate limits, auth failures) instead of generic messages
- Stabilized TypeScript strict mode (
exactOptionalPropertyTypes) across all endpoint implementations - Fixed concurrent batch request handling edge cases