Repository navigation
Releases
Releases · oscova/oscova-agents
Oscova Agents 3.8.0
Breaking changes
- Plugins that set or call
AgentTaskContext.SerializeLiveSessionAsyncmust pass the handoff text, or null to persist, and rebuild against Oscova.Agents 5.5.0.
Improved
- Chats switch to the configured backup model when Ollama, OpenAI Responses or Anthropic fail before any text, reasoning or tool output arrives.
Fixed
- The session inspector masks known secrets in reasoning, and Markdown file previews require a click to open external images.
- Stale settings tabs no longer overwrite General, MCP, offline mode, model provider or plugin changes saved in another tab.
- Subagents awaiting approval stop spinning, overlapping channel approval prompts stay separate, and rescheduled one-shot tasks run again.
- Memory indexes rebuild for every user after an embedding-model change, and interrupted indexing no longer duplicates excerpts.
- Reconnected devices show plugins as Preparing until ready, Docker output appears before a newline, GGUF chats stay separate, and Gmail reads attachment-stored bodies.
For plugin developers
AgentTaskContext.SerializeLiveSessionAsyncis nowFunc<string?, CancellationToken, ValueTask<JsonElement?>>?, taking the handoff text for a snapshot or null to persist.- Framework file access no longer blocks on Unix named pipes, Windows edits keep restrictive permissions, and vector indexes recover from interrupted appends and dimension resets.
- First-party plugins require Oscova.Agents 5.5.0, so rebuild third-party plugins that use
SerializeLiveSessionAsyncagainst 5.5.0 and updateframeworkVersionRange.
Known limitations
- Foundry Local and Local Speech Synthesis are unavailable on Intel Macs.
Packages
| Package | Version |
|---|---|
| Oscova.Agents | 5.5.0 |
| Oscova.Agents.App | 3.8.0 |
| Oscova.Agents.Plugins.AgentTemplates | 4.8.0 |
| Oscova.Agents.Plugins.Browser | 2.4.0 |
| Oscova.Agents.Plugins.Discord | 4.8.0 |
| Oscova.Agents.Plugins.Docker | 2.4.0 |
| Oscova.Agents.Plugins.ElevenLabs | 2.4.0 |
| Oscova.Agents.Plugins.FoundryLocal | 4.8.0 |
| Oscova.Agents.Plugins.GoogleWorkspace | 4.9.0 |
| Oscova.Agents.Plugins.LlamaSharp | 4.8.0 |
| Oscova.Agents.Plugins.LocalSpeechRecognition | 2.4.0 |
| Oscova.Agents.Plugins.LocalSpeechSynthesis | 2.4.0 |
| Oscova.Agents.Plugins.MicrosoftGraph | 4.9.0 |
| Oscova.Agents.Plugins.Mxc | 2.4.0 |
| Oscova.Agents.Plugins.OpenAI | 2.4.0 |
| Oscova.Agents.Plugins.Slack | 4.8.0 |
| Oscova.Agents.Plugins.Telegram | 4.8.0 |
| Oscova.Agents.Plugins.Web | 4.8.0 |
Update
dotnet tool update --global Oscova.Agents.AppOscova Agents 3.7.0
Fixed
- The update check no longer offers plugins that have no package for your platform, such as Foundry Local and Local Speech Synthesis on Intel Macs.
- Updates name the platform when disabling such plugins, and the Plugins page marks them not available so you can uninstall them.
For plugin developers
- The plugin settings API reports the new
UnavailableOnPlatformstatus for installed plugins that have no package for the current platform.
Known limitations
- Foundry Local and Local Speech Synthesis are unavailable on Intel Macs.
Packages
| Package | Version |
|---|---|
| Oscova.Agents.App | 3.7.0 |
Update
dotnet tool update --global Oscova.Agents.AppOscova Agents 3.6.0
Breaking changes
- Avatar clothing is replaced by complete outfits, and earlier top and bottom choices are not carried over, so pick an outfit in Avatar settings.
- The
avatar_clothing_listandavatar_clothing_selectMCP tools are replaced byavatar_outfit_listandavatar_outfit_select. - Outfits and gestures need Avatar Engine 0.3, so update it from Updates > Avatar Engine after updating Oscova.
- Plugins that call the removed Avatar clothing APIs must move to the outfit APIs and rebuild against Oscova.Agents 5.4.0.
- Avatar bridge HTTP clients must replace the clothing routes with
GET api/avatarbridge/outfitsandPOST api/avatarbridge/outfit/select, selecting withAvatarNameandOutfitId.
Improved
- Avatar settings list the outfits each Engine avatar offers, and spoken replies can play stationary gestures alongside emotion cues.
- Tools with non-ASCII names, such as MCP tools, work on Gemini and OpenAI-compatible providers, including after tool search loads them.
- Disabling a plugin that running work depends on now asks first, and helper agents awaiting approval keep waiting for your answer.
Fixed
- Provider streams that report an error mid-response, including OpenRouter, now fail with the provider's message instead of ending empty or failing to parse.
- Operators cannot read other users' logs, failed exports keep the existing backup, and agent saves, editor sessions and to-do deletions keep changes.
- Discord replies no longer ping everyone or roles, Microsoft To Do updates keep unchanged fields, and file edits keep Linux and macOS permissions.
For plugin developers
IAvatarBridgeServicereplacesListClothingOptionsAsyncandSelectClothingAsyncwithListOutfitsAsyncandSelectOutfitAsync, and addsListGesturesAsyncandSelectGestureAsync.AvatarClothingListResponse,AvatarClothingOption,AvatarClothingSelectRequestandAvatarClothingSelectResponsebecomeAvatarOutfitListResponse,AvatarOutfitOption,AvatarOutfitSelectRequestandAvatarOutfitSelectResponse.- Gestures use the new
AvatarGestureListResponse,AvatarGestureRequestandAvatarGestureResponsecontracts. - First-party plugins require Oscova.Agents 5.4.0, so rebuild third-party plugins that use Avatar clothing against 5.4.0 and update
frameworkVersionRange.
Known limitations
- Foundry Local and Local Speech Synthesis are unavailable on Intel Macs.
Packages
| Package | Version |
|---|---|
| Oscova.Agents | 5.4.0 |
| Oscova.Agents.App | 3.6.0 |
| Oscova.Agents.Plugins.AgentTemplates | 4.7.0 |
| Oscova.Agents.Plugins.Browser | 2.3.0 |
| Oscova.Agents.Plugins.Discord | 4.7.0 |
| Oscova.Agents.Plugins.Docker | 2.3.0 |
| Oscova.Agents.Plugins.ElevenLabs | 2.3.0 |
| Oscova.Agents.Plugins.FoundryLocal | 4.7.0 |
| Oscova.Agents.Plugins.GoogleWorkspace | 4.8.0 |
| Oscova.Agents.Plugins.LlamaSharp | 4.7.0 |
| Oscova.Agents.Plugins.LocalSpeechRecognition | 2.3.0 |
| Oscova.Agents.Plugins.LocalSpeechSynthesis | 2.3.0 |
| Oscova.Agents.Plugins.MicrosoftGraph | 4.8.0 |
| Oscova.Agents.Plugins.Mxc | 2.3.0 |
| Oscova.Agents.Plugins.OpenAI | 2.3.0 |
| Oscova.Agents.Plugins.Slack | 4.7.0 |
| Oscova.Agents.Plugins.Telegram | 4.7.0 |
| Oscova.Agents.Plugins.Web | 4.7.0 |
Update
dotnet tool update --global Oscova.Agents.App
Oscova Agents 3.5.1
Improved
- Local models show hardware requirements, memory estimates and a verified test run, and LlamaSharp adds CUDA 13 GPU offload.
- The app source is published on the
appbranch, beside the framework and plugins onmain. - MCP search reports total and omitted matches, and web fetch states which content types it reads.
- UI fonts ship with the app instead of loading from Google, and the sign-in picker shows initials.
Fixed
- Scheduled tasks keep their shared-folder setting, and stopped chats stay saved after model-provider settings change.
- Native Windows MCP servers start reliably, plugin installs keep pending choices, and muted notices reappear in the bell without replaying alerts.
For plugin developers
IModelProviderConfiguration,IModelHardwareProviderandILocalModelDiagnosticProviderlet model-provider plugins expose options, hardware placement and diagnostic test runs.- Plugin manifests can declare hardware requirements through
PluginHardwareRequirement, and settings contributions can extend model-provider setup throughGetModelProviderSettings. - The framework additions are compatible, so plugins whose
frameworkVersionRangeincludes 5.3.0 keep working, and first-party plugins now require 5.3.0.
Known limitations
- Foundry Local and Local Speech Synthesis are unavailable on Intel Macs.
Packages
| Package | Version |
|---|---|
| Oscova.Agents | 5.3.0 |
| Oscova.Agents.App | 3.5.1 |
| Oscova.Agents.Plugins.AgentTemplates | 4.6.0 |
| Oscova.Agents.Plugins.Browser | 2.2.0 |
| Oscova.Agents.Plugins.Discord | 4.6.0 |
| Oscova.Agents.Plugins.Docker | 2.2.0 |
| Oscova.Agents.Plugins.ElevenLabs | 2.2.0 |
| Oscova.Agents.Plugins.FoundryLocal | 4.6.0 |
| Oscova.Agents.Plugins.GoogleWorkspace | 4.7.0 |
| Oscova.Agents.Plugins.LlamaSharp | 4.6.0 |
| Oscova.Agents.Plugins.LocalSpeechRecognition | 2.2.0 |
| Oscova.Agents.Plugins.LocalSpeechSynthesis | 2.2.0 |
| Oscova.Agents.Plugins.MicrosoftGraph | 4.7.0 |
| Oscova.Agents.Plugins.Mxc | 2.2.0 |
| Oscova.Agents.Plugins.OpenAI | 2.2.0 |
| Oscova.Agents.Plugins.Slack | 4.6.0 |
| Oscova.Agents.Plugins.Telegram | 4.6.0 |
| Oscova.Agents.Plugins.Web | 4.6.0 |
Update
dotnet tool update --global Oscova.Agents.App
Oscova Agents 3.5.0
Breaking changes
- Saved tasks drop their notification channel setting, so name the channel in the task instruction instead.
- Egress API and CLI JSON records replace agent, provider, task and thread names with
agentId,mcpServerIdand entry labels. - Plugins built for Oscova.Agents 5.1.0 must be rebuilt against 5.2.0, as listed under For plugin developers.
Improved
- Agents keep a to-do backlog, the Night Shift task works through agent items overnight, and the Morning Brief task summarizes results each morning.
- Users on one server share files in Files > Shared and through agents at
/shared, controlled by a new Shared folder permission. - The
/researchchat command saves a sourced Markdown report, and agents can search and read saved chats and task runs. - First-run setup preselects sensible defaults, asking what Oscova can do gives a short introduction, and follow-up messages default to Queue.
Fixed
- Saves retry database locks caused by concurrent reads, and pages stay responsive after a refused model download or deleted in-use secret.
- Logs, metrics, egress and notifications no longer store plaintext agent, provider or server names, and agent folders work under macOS
/private.
For plugin developers
- Task agents choose the channel through the notify tool, removing the
NotificationChannelproperties andIChannelNotificationService.NotifyAsync, andHandoffAsyncgains atitleparameter. ProviderEgressDescriptortakesAgentIdand a requiredProviderId, andAgentToolCollection.Addgains an optionalserverIdparameter.- The agent's own folder is
/self, so usePathHelper.SelfAgentPathandROOT_SELFinstead of/privateandROOT_PRIVATE. /sharedis a reserved agent path,[WorkspacePath]accepts path arrays, andEncryptedFileContent.TryDecryptgains an optionalpurposeparameter.ContextTextBudget.Truncate,AgentTaskDefinition.RequiresHandler,IAgentTaskCatalog.TryGetHandlerKeyandAgentTaskCatalogEntry.HandlerKeyare removed.IAgentTaskRepositorygainsDeleteRunAsync,AgentTaskDefinitiongainsKeepLastRuns, andEncryptedKnowledgeStoregainsReadConceptAsync,UpdateAsyncandDeleteAllAsync.- Plugin manifests can declare
supportedRuntimeIdentifiers, and plugins without the declaration stay unrestricted. - First-party plugins require Oscova.Agents 5.2.0, so rebuild third-party plugins against 5.2.0 and update
frameworkVersionRange.
Known limitations
- Foundry Local and Local Speech Synthesis are unavailable on Intel Macs.
- Existing plaintext
.encfiles stay plaintext until you save them again in Files. - Slack
/newneeds the/newslash command registered, thecommandsbot scope added and the Slack app reinstalled.
Packages
| Package | Version |
|---|---|
| Oscova.Agents | 5.2.0 |
| Oscova.Agents.App | 3.5.0 |
| Oscova.Agents.Plugins.AgentTemplates | 4.5.0 |
| Oscova.Agents.Plugins.Browser | 2.1.0 |
| Oscova.Agents.Plugins.Discord | 4.5.0 |
| Oscova.Agents.Plugins.Docker | 2.1.0 |
| Oscova.Agents.Plugins.ElevenLabs | 2.1.0 |
| Oscova.Agents.Plugins.FoundryLocal | 4.5.0 |
| Oscova.Agents.Plugins.GoogleWorkspace | 4.6.0 |
| Oscova.Agents.Plugins.LlamaSharp | 4.5.0 |
| Oscova.Agents.Plugins.LocalSpeechRecognition | 2.1.0 |
| Oscova.Agents.Plugins.LocalSpeechSynthesis | 2.1.0 |
| Oscova.Agents.Plugins.MicrosoftGraph | 4.6.0 |
| Oscova.Agents.Plugins.Mxc | 2.1.0 |
| Oscova.Agents.Plugins.OpenAI | 2.1.0 |
| Oscova.Agents.Plugins.Slack | 4.5.0 |
| Oscova.Agents.Plugins.Telegram | 4.5.0 |
| Oscova.Agents.Plugins.Web | 4.5.0 |
Update
dotnet tool update --global Oscova.Agents.App
Oscova Agents 3.4.1
Breaking changes
- Plugins built for Oscova.Agents 5.0.0 must be rebuilt against 5.1.0, as listed under For plugin developers.
Improved
- Agents can hand work to up to four subagents of the same agent and wait on them with Steer, Queue or Stop.
oscova updateruns in one visible console with stable plugin updates, andoscova update --version <N>installs or returns to a version.- Google Workspace adds a Gmail send tool, and Microsoft To Do due dates follow the user's time zone.
- First-run guidance adds start cards, a welcome screen and setup hints, and onboarding no longer requires a provider or speech.
Fixed
- Regular users can no longer use shared Avatar tools, and bell notifications no longer show private message text.
- Long text is counted quickly, setup wizard dropdowns stay readable in light mode, and Agent Templates installs on first start.
For plugin developers
AgentAsToolProviderhas a new constructor, andWaitToolset.WaitAsyncis now an instance method.IAgentTaskRepositoryaddsValidateTask, and theIAvatarBridgeServicespeech and shutdown signatures changed.- First-party plugins require Oscova.Agents 5.1.0, so rebuild third-party plugins against 5.1.0 and update
frameworkVersionRange.
Packages
| Package | Version |
|---|---|
| Oscova.Agents | 5.1.0 |
| Oscova.Agents.App | 3.4.1 |
| Oscova.Agents.Plugins.AgentTemplates | 4.4.1 |
| Oscova.Agents.Plugins.Browser | 2.0.1 |
| Oscova.Agents.Plugins.Discord | 4.4.1 |
| Oscova.Agents.Plugins.Docker | 2.0.1 |
| Oscova.Agents.Plugins.ElevenLabs | 2.0.1 |
| Oscova.Agents.Plugins.FoundryLocal | 4.4.1 |
| Oscova.Agents.Plugins.GoogleWorkspace | 4.5.0 |
| Oscova.Agents.Plugins.LlamaSharp | 4.4.1 |
| Oscova.Agents.Plugins.LocalSpeechRecognition | 2.0.1 |
| Oscova.Agents.Plugins.LocalSpeechSynthesis | 2.0.1 |
| Oscova.Agents.Plugins.MicrosoftGraph | 4.5.0 |
| Oscova.Agents.Plugins.Mxc | 2.0.1 |
| Oscova.Agents.Plugins.OpenAI | 2.0.1 |
| Oscova.Agents.Plugins.Slack | 4.4.1 |
| Oscova.Agents.Plugins.Telegram | 4.4.1 |
| Oscova.Agents.Plugins.Web | 4.4.1 |
Update
dotnet tool update --global Oscova.Agents.App