Skip to content

Symbiont v1.0.0

Choose a tag to compare

View all tags
@jaschadub jaschadub released this 08 Feb 05:32
· 54 commits to main since this release
v1.0.0
dd36ae6

Symbiont v1.0.0

The first stable release of Symbiont — an AI-native agent framework for building autonomous, policy-aware agents with scheduling, channel adapters, cryptographic identity, and multi-language SDKs.

Highlights

Production-Ready Scheduling

  • Session Isolation: Per-run AgentContext with HeartbeatContextMode control (EphemeralWithSummary, SharedPersistent, FullyEphemeral)
  • Jitter Support: Random delay to prevent thundering herd in multi-job deployments
  • Per-Job Concurrency Guards: Configurable max_concurrent to prevent resource exhaustion
  • Dead-Letter Queue: Jobs exceeding max_retries move to DeadLetter status with manual recovery workflow
  • CronMetrics Observability: Prometheus-compatible metrics (runs_total, execution_duration_seconds, in_flight_jobs, dead_letter_total)
  • Health Endpoint: /api/v1/health/scheduler for ops monitoring
  • AgentPin JWT: ES256 cryptographic identity verification on scheduled jobs

Security Enhancements

  • New security event types: CronJobDeadLettered, AgentPinVerificationFailed
  • Enhanced policy enforcement: time window restrictions, capability requirements, human approval workflows, AgentPin verification

Delivery Routing

  • Six built-in output channels: Webhook, Slack, Email, Custom, Stdout, LogFile
  • Pluggable DeliveryRouter trait for custom routing

Channel Adapters

  • Slack (community): Bidirectional messaging with webhook verification, HMAC signing, and OAuth support
  • Microsoft Teams (enterprise): Azure AD OAuth2, Bot Framework API, Adaptive Cards
  • Mattermost (enterprise): REST v4 API, HMAC-SHA256 webhook verification, self-hosted support
  • 12 REST endpoints for channel lifecycle management (register, start, stop, health, identity mapping, audit)
  • DSL channel block for declarative channel configuration

HTTP API

  • 10 RESTful schedule management endpoints with OpenAPI/Swagger documentation
  • 12 channel management endpoints with OpenAPI/Swagger documentation
  • Complete CRUD + pause/resume/trigger/history/next-run operations
  • HTTP Input module for webhook integrations with Bearer/JWT auth and rate limiting

SDK Support

  • JavaScript SDK: Full TypeScript ScheduleClient and ChannelClient with CRUD operations
  • Python SDK: Async ScheduleClient and ChannelClient with full API coverage

Documentation

  • Comprehensive scheduling guide in 6 languages (EN, DE, ES, JA, PT, ZH-CN)
  • Full API reference, DSL guide, runtime architecture docs
  • Available at docs.symbiont.dev

Reliability & Performance

  • Graceful shutdown with in-flight job tracking
  • Exponential backoff retry logic
  • ACID-guaranteed job state transitions
  • Optimized tick loop and configurable global concurrency

Breaking Changes

  • CronJobDefinition has new optional fields (max_concurrent, agent_pin_jwt) — existing jobs work without changes
  • HeartbeatContextMode enum added — defaults to EphemeralWithSummary (previous behavior)

Migration from v0.9.0

No breaking API changes. All v0.9.0 scheduled jobs continue to work. See CHANGELOG.md for optional enhancement steps.

Crates

Published to crates.io:

Full Changelog: https://github.com/ThirdKeyAI/Symbiont/blob/main/CHANGELOG.md

Assets 2
Loading