Spectra v0.6.1

Spectra v0.6.1

Published packages

• @mohanscodex/spectra-agent@0.6.1
• @mohanscodex/spectra-ai@0.6.1
• @mohanscodex/spectra-app@0.6.1
• @mohanscodex/spectra-code@0.6.1

Release notes

Patch Changes

Fix the update dialog to copy bun add -g @mohanscodex/spectra-code@latest so users can cross 0.x minor version boundaries.

Spectra v0.6.0

Spectra v0.6.0

Published packages

• @mohanscodex/spectra-agent@0.6.0
• @mohanscodex/spectra-ai@0.6.0
• @mohanscodex/spectra-app@0.6.0
• @mohanscodex/spectra-code@0.6.0

Release notes

Spectra v0.6.0

Core packages

• @mohanscodex/spectra-ai, @mohanscodex/spectra-agent, and @mohanscodex/spectra-app remain the unified core SDK packages.
• @mohanscodex/spectra-code is the terminal TUI app built on the core packages with OpenTUI. The archived @mohanscodex/spectra-tui package is not part of the release train.

Provider and model layer

• Added file content blocks with filename, path, MIME, size, and data fields so prompts can carry local file attachments through provider serialization.
• Expanded built-in provider coverage for OpenAI-compatible cloud providers, coding-plan endpoints, and local runtimes including Ollama, LM Studio, llama.cpp, vLLM, and SGLang.
• Added OAuth/device-login support for Kimi Code and OpenAI Codex style coding providers.
• Added provider usage recording and reporting, including live usage fetches for supported coding plans and cache-aware token accounting.
• Refreshed generated model metadata for newer provider models.

Agent and orchestration

• Added the runSubagent primitive for bounded child-agent execution with model overrides, budgets, event forwarding, abort propagation, and error reporting.
• Improved steering and follow-up queue semantics so queued messages drain reliably during active streams without duplicate submissions.
• Surfaced loop-end reasons and kept loop warnings in UI status/toasts instead of injecting them into tool messages.
• Added structured task reporting for background and foreground subagent work.

Spectra App infrastructure

• Added layer-2 orchestration that wires AgentRegistry delegation through runSubagent.
• Improved session provenance and parity behavior across session stores.
• Kept the fixed-version core package release unified across ai, agent, app, and the code app.

Spectra Code TUI app

• Added multi-agent collaboration with foreground subagents, background task mode, child-session navigation, and subagent status rendering.
• Added local file attachments: @ fuzzy file autocomplete, MIME detection, file visuals, prompt badges, transcript persistence, and provider handoff.
• Added the phased todo tool and /todo command with inline hierarchical rendering, validation errors, import/export/edit/copy flows, and command palette integration.
• Added memory tool rendering with scope-aware theming and skipped unnecessary permission prompts for non-file utility tools.
• Added prompt-anchored autocomplete for slash command arguments and file paths, plus command/menu selection-window refinements.
• Added shell timing metadata, timeout footers, syntax highlighting parser registration, source-aware code block styles, and improved file-icon/color visuals.
• Improved provider, skills, memory, usage, cost, settings, update, doctor, and modal dialog polish.
• Moved steering message display to render immediately and fixed duplicated or delayed steering submissions.
• Fixed child-session filtering, subagent view layout, bottom navigation controls, tool status icons, shell metadata display, edit diff spacing, inline tool titles, and redundant icons.

Release and CI/CD

• Updated release automation to delete package-scoped tags/releases, create or update one unified vX.Y.Z GitHub release, and trigger platform binary builds for that unified tag.
• Expanded published-package smoke testing to include @mohanscodex/spectra-code alongside the core packages.
• Fixed Windows binary packaging by dynamically generating WiX components, installing WiX v4 through the dotnet toolchain, and correcting variable usage.
• Updated READMEs to reflect the current core package split, OpenTUI-based Spectra Code app, feature matrix, providers, attachments, todos, and release packaging.

Patch Changes

Spectra v0.5.1

What's Changed

Parallel Sessions

• Multi-session agent history with persistence and compaction
• Per-session state isolation — messages, loading states, and streaming don't leak across sessions
• Per-session streaming guard so new sessions aren't blocked by running ones
• Session status bar showing background session activity
• SwitchSession wired into handleSubmit for immediate message rendering

Provider Integrations

• Coding plan provider integrations with live model fetching
• Configurable cache retention for Anthropic client
• Prompt caching hints for Anthropic and OpenRouter

Reliability & Edge Cases

• Propagate abort signal to subagents and fix interrupted indicator ordering
• Handle interrupt edge cases for DeepSeek and other strict providers
• Preserve thinking-only messages on interrupt, only pop truly empty ones
• Doom loop detector only triggers on 5+ continuous identical calls
• Increase shell tool timeout to 30 min default, 60 min max

TUI & UX

• Tool display overlap fix, shell title dimness, and agent maxTurns optional
• Clearer tool display labels
• Toast feedback for auto-copy on selection and manual copy actions
• Correct bundled skills count from 185+ to 60+

Testing & CI

• Fix ACP test to include 'general' agent definition
• Use bun:sqlite with better-sqlite3 fallback for tests
• Move better-sqlite3 to runtime dependencies
• Fix flaky session store test with timing delay
• CI: matrix build with native runners, build-binaries workflow with smoke test
• Platform-native release binaries: Windows .msi, macOS .dmg, Linux .tar.gz

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.5.1
@mohanscodex/spectra-agent	0.5.1
@mohanscodex/spectra-app	0.5.1
@mohanscodex/spectra-code	0.5.1

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.5.1
bun add @mohanscodex/spectra-agent@0.5.1
bun add @mohanscodex/spectra-app@0.5.1

# CLI (global install)
bun add -g @mohanscodex/spectra-code@0.5.1

Full Changelog: v0.5.0...v0.5.1

Spectra v0.5.0

What's Changed

Skills System

• TF-IDF skill discovery — find_skills tool with scored search, skill tool to load on demand
• 65+ bundled skills — debugging, deployment, testing, collaboration, security, and more
• Evolving skills — auto-synthesized from session traces, saved to ~/.spectra/skills/, available in future sessions
• 3-tier precedence — user-defined > evolving > bundled (highest wins)
• Auto-tag extraction — tags from directory category, name segments, section headers, description keywords
• CRLF line ending support — skills from any OS parsed correctly

Pricing & Cost Tracking

• models.dev pricing — fetches per-model pricing with hardcoded fallbacks
• Cost display — real-time cost in prompt bar status bar next to context usage
• Cost dialog — /cost opens detailed breakdown (model, tokens, rates, total)
• Token colors — teal-green input and amber-gold output in prompt bar

Slash Commands

• /cost, /tokens, /stats, /context, /status — observability commands with real data
• /save, /search, /export, /history, /compress — session management
• /theme, /permissions, /settings — configuration dialogs
• Stubs show toast notifications instead of doing nothing

Agent System

• Blacklist-based tool gating — agents define blockedTools instead of allowed tools; new tools available automatically
• Hidden agents — hidden field on AgentDefinition for system agents
• Per-agent model override — model field on AgentDefinition
• Hidden title agent — generates session names using cheap model (deepseek-v4-flash)
• Terminal title — shows Spectra | session name on launch
• Split definitions — each agent in its own file

Bug Fixes

• Fix stderr bleed in TUI from glob/grep when commands fail (pipe stdio)
• Fix CRLF line endings breaking skill frontmatter parsing
• Fix scrollbar padding in chat area
• Fix session listing scoped to current directory

Testing

• 49 new tests: skill system, evolving skills, pricing, ACP updates
• All 277 tests passing

Infrastructure

• Build-binaries workflow for cross-platform releases
• Smoke test step in release workflow
• Linux x64 OpenTUI dependencies

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.5.0
@mohanscodex/spectra-agent	0.5.0
@mohanscodex/spectra-app	0.5.0
@mohanscodex/spectra-code	0.5.0

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.5.0
bun add @mohanscodex/spectra-agent@0.5.0
bun add @mohanscodex/spectra-app@0.5.0

# CLI (global install)
bun add -g @mohanscodex/spectra-code@0.5.0

Spectra v0.4.9

What's Changed

@mohanscodex/spectra-ai

Patch Changes

• Updated dependencies.

@mohanscodex/spectra-agent

Patch Changes

• Updated dependencies.

@mohanscodex/spectra-app

Patch Changes

• Updated dependencies.

@mohanscodex/spectra-code

Patch Changes

• Fix git branch path flash on Windows — use execFileSync with stdio ignore instead of bash redirect
• Add update check dialog on startup — checks npm registry with 24h cache, shows version and install command
• Add prompt badge mode — pastes >500 chars collapse into compact badge, enter to send, esc to edit
• Fix shell tool console bleed on Windows — always route through PowerShell to avoid cmd.exe output leaks
• Fix shell tool display — always show block view with "No output" indicator when empty
• Fix edit tool block — add blank line after heading for visual separation
• Move toast notifications to top-right corner
• Remove graphify extension

Infrastructure

• Clean release workflow — remove automated body generation, delete per-package tags
• Restore lockstep versioning across all 4 packages
• Update Rust feature matrix — Provenance now available in Rust SDK

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.4.9
@mohanscodex/spectra-agent	0.4.9
@mohanscodex/spectra-app	0.4.9
@mohanscodex/spectra-code	0.4.9

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.4.9
bun add @mohanscodex/spectra-agent@0.4.9
bun add @mohanscodex/spectra-app@0.4.9

# CLI (global install)
bun add -g @mohanscodex/spectra-code@0.4.9

Spectra v0.4.7

What's Changed

@mohanscodex/spectra-ai

Patch Changes

• 3665fe5 Thanks @codex-mohan! - Fix security and reliability issues in TypeScript SDK

  • Implement sanitizeSurrogates to properly remove unpaired Unicode surrogates
  • Fix retry logic: remove orphaned partial messages from history before retry
  • Replace brittle string-based error detection with status code checks and regex
  • Add abort-aware sleep with jitter for retry backoff
  • Add onRetry hook for consumer visibility and control over retry decisions
  • Remove redundant Groq provider (now uses OpenAI-compatible wrapper)
  • Fix EventStream.result() hanging forever if stream ends without completion event
  • Add res.ok check to OpenRouter fetchLiveModels

@mohanscodex/spectra-agent

Patch Changes

• 3665fe5 Thanks @codex-mohan! - Fix security and reliability issues in TypeScript SDK

  • Implement sanitizeSurrogates to properly remove unpaired Unicode surrogates
  • Fix retry logic: remove orphaned partial messages from history before retry
  • Replace brittle string-based error detection with status code checks and regex
  • Add abort-aware sleep with jitter for retry backoff
  • Add onRetry hook for consumer visibility and control over retry decisions
  • Remove redundant Groq provider (now uses OpenAI-compatible wrapper)
  • Fix EventStream.result() hanging forever if stream ends without completion event
  • Add res.ok check to OpenRouter fetchLiveModels

• Updated dependencies [3665fe5]:

  • @mohanscodex/spectra-ai@0.4.7

@mohanscodex/spectra-app

Patch Changes

• Updated dependencies [3665fe5]:
  • @mohanscodex/spectra-ai@0.4.7
  • @mohanscodex/spectra-agent@0.4.7

@mohanscodex/spectra-code

Patch Changes

• Updated dependencies [3665fe5]:
  • @mohanscodex/spectra-ai@0.4.7
  • @mohanscodex/spectra-agent@0.4.7

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.4.7
@mohanscodex/spectra-agent	0.4.7
@mohanscodex/spectra-app	0.4.7
@mohanscodex/spectra-code	0.4.7

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.4.7
bun add @mohanscodex/spectra-agent@0.4.7
bun add @mohanscodex/spectra-app@0.4.7

# CLI (global install)
bun add -g @mohanscodex/spectra-code@0.4.7

# Or via install script
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.sh | bash

# Windows
iwr -useb https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.ps1 | iex

Spectra v0.4.6

What's Changed

@mohanscodex/spectra-agent

Patch Changes

• Updated dependencies []:
  • @mohanscodex/spectra-ai@0.4.6

@mohanscodex/spectra-app

Patch Changes

• Updated dependencies []:
  • @mohanscodex/spectra-ai@0.4.6
  • @mohanscodex/spectra-agent@0.4.6

@mohanscodex/spectra-code

Patch Changes

• 911eb91 Thanks @codex-mohan! - Replace hardcoded version strings in about-dialog and debug-dialog with auto-resolved import from package.json.

• Updated dependencies []:

  • @mohanscodex/spectra-ai@0.4.6
  • @mohanscodex/spectra-agent@0.4.6

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.4.6
@mohanscodex/spectra-agent	0.4.6
@mohanscodex/spectra-app	0.4.6
@mohanscodex/spectra-code	0.4.6

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.4.6
bun add @mohanscodex/spectra-agent@0.4.6
bun add @mohanscodex/spectra-app@0.4.6

# CLI (global install)
bun add -g @mohanscodex/spectra-code@0.4.6

# Or via install script
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.sh | bash

# Windows
iwr -useb https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.ps1 | iex

Spectra v0.4.5

What's Changed

@mohanscodex/spectra-code

• Expanded system prompt � Rewrote the 6-line agent stubs into full coding agent personas (build/plan/debug/explore) with tool selection guidance, code style enforcement, git safety rules, security policy, output format conventions, and professional stance. Wired the previously-dead getSystemPrompt() into agent, ACP adapter, and sub-agent task tool.
• Modularized TUI � Split the 1227-line app.tsx into 8 focused modules: hooks/use-agent, hooks/use-chat-submit, hooks/use-app-keyboard, hooks/use-revert, hooks/use-permission-queue, utils/model-config, utils/session-messages, utils/version.
• NPM publishing support � Un-privated @mohanscodex/spectra-code, added bin/engines/exports, fixed shebang to use Bun (required by @opentui/react).
• Install scripts � Added install.sh (macOS/Linux) and install.ps1 (Windows) with multi-package-manager detection (bun > pnpm > yarn > npm).
• Version display fix � Replaced hardcoded version strings in about-dialog and debug-dialog with auto-resolved import from package.json.
• Permission system overhaul � Eliminated redundant permission dialogs, auto-allow workspace files, switched bash permission model from allow-list to deny-list.
• UI fixes � Restored dialog title visibility, aligned footer padding, fixed debug dialog overflow, fixed doctor scrollbar visibility.

Docs

• Replaced outdated docs/PLAN.md with TODO.md roadmap.
• Added banner image to README.
• Documented spectra-code package and deprecated spectra-tui.
• Added post-merge pull step to release workflow instructions in AGENTS.md.

Dependencies

• @mohanscodex/spectra-ai@0.4.5 � no code changes (version bump only)
• @mohanscodex/spectra-agent@0.4.5 � no code changes (version bump only)
• @mohanscodex/spectra-app@0.4.5 � no code changes (version bump only)

Published Packages

Package	Version
@mohanscodex/spectra-ai	0.4.5
@mohanscodex/spectra-agent	0.4.5
@mohanscodex/spectra-app	0.4.5
@mohanscodex/spectra-code	0.4.5

Install

# SDK packages
bun add @mohanscodex/spectra-ai@0.4.5
bun add @mohanscodex/spectra-agent@0.4.5
bun add @mohanscodex/spectra-app@0.4.5

# CLI (global)
bun add -g @mohanscodex/spectra-code@0.4.5

# Or via install script
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.sh | bash

# Windows
iwr -useb https://raw.githubusercontent.com/codex-mohan/spectra/main/scripts/install.ps1 | iex

Spectra v0.4.4

0.4.4

Patch Changes

• bacb73d Thanks @codex-mohan! - Inject synthetic error tool results in convertMessages when tool calls lack matching toolResult messages, preventing strict providers (DeepSeek, Anthropic) from rejecting requests with unmatched tool_call_ids.

Published Packages

• @mohanscodex/spectra-ai@0.4.4 — npm
• @mohanscodex/spectra-agent@0.4.4 — npm
• @mohanscodex/spectra-app@0.4.4 — npm

Install

bun add @mohanscodex/spectra-ai@0.4.4 @mohanscodex/spectra-agent@0.4.4
bun add @mohanscodex/spectra-app@0.4.4

Spectra v0.4.3

0.4.3

Patch Changes

• e29e755 Thanks @codex-mohan! - Fix OpenRouter models being incorrectly categorized into native provider buckets (e.g. deepseek/deepseek-v3.2 showing under deepseek instead of openrouter)

Published Packages

• @mohanscodex/spectra-ai@0.4.3 — npm
• @mohanscodex/spectra-agent@0.4.3 — npm
• @mohanscodex/spectra-app@0.4.3 — npm

Install

bun add @mohanscodex/spectra-ai@0.4.3 @mohanscodex/spectra-agent@0.4.3
bun add @mohanscodex/spectra-app@0.4.3