0.8.5

Sessions, commands and preferences now use simpler interfaces for applications built with Neuron AI.

• Replace CommandArguments with a plain string $value in command execution.
• Rename SelectionRequest to Selection, retaining deferred selection through requestSelection().
• Remove CommandAdapterInterface::useSession(); commands install history directly with agent()->setChatHistory().
• Replace named configuration objects with direct per-user preferences through ConfigurationStore, including typed fallback reads.
• Clarify the library description and update examples and documentation.

Upgrade notes

Custom commands and adapters must adopt the new signatures and selection type. Replace calls to useSession() with direct Agent history updates and synchronize presentation in the host application. Replace configuration object reads and writes with read($key, $fallback), write($key, $value), delete($key) and entries(). Legacy named configuration documents remain untouched and are not automatically migrated.

This release stays in the 0.8.x series according to the repository release policy, despite these interface changes.

Validation

• 164 tests, 706 assertions passed.
• PHPStan passed.
• Composer metadata validated with Neuron AI 3 dependencies.

0.8.4

This release simplifies command mounting and distinguishes informational messages, warnings and expected errors.

Changes

• Add ConcurrentCommandInterface for commands that can run without interfering with active Agent work. Help and Leave implement the marker; admission remains the Adapter's responsibility.
• Replace command kits with explicit command instances or arrays. Remove CommandKitInterface, AbstractCommandKit and SessionCommandKit.
• Replace say() with notify() and add error() alongside warn() on CommandAdapterInterface.
• Report an unknown Session key as an error and an empty Session collection as a warning.
• Rename ConfigurationStore::save() to write().
• Update backend examples and documentation for the revised contracts.

Upgrade notes

Replace say($text) calls with notify($text) and implement error() in custom Adapters. Messages do not interrupt execution or change its technical status: return explicitly when a command cannot continue.

Mount new ClearCommand() and new ResumeCommand() directly instead of using SessionCommandKit. Replace custom kits with arrays of commands. Rename configuration persistence calls from save($configuration) to write($configuration).

These interface changes remain in the 0.8.x series according to the repository release policy.

Full changelog

0.8.3

Maintenance release for the 0.8.x series. Removes completed scratch documents. No library code or dependency changes.

0.8.2

Document Composer installation and compatibility.

• Add installation instructions using composer require asterixcapri/neuron-interaction.
• State the PHP 8.4.1+ requirement and Neuron AI 3 compatibility for the 0.8.x branch.
• Explain that Composer installs Neuron AI as a dependency and that Neuron TUI already includes Neuron Interaction.

Documentation-only release; no library code or dependency changes.

Full changelog

0.8.1

Reduce distribution archive contents through .gitattributes export exclusions.

• Exclude tests, documentation, examples, scratch files and development configuration from exported archives.
• Exclude the Composer lockfile from exported archives.

No library code or dependency requirement changes.

Full changelog

0.8.0

Reusable, presentation-independent modules for applications built with Neuron AI 3.

• Persist, list, resume and delete user-owned Sessions that can be installed directly as Agent chat history.
• Store Session metadata and filter Session listings by exact metadata values.
• Dispatch commands through an application-supplied Adapter with admission and completion phases.
• Provide Clear, Resume, Help and Leave commands, plus command kits for grouping commands.
• Describe deferred choices with SelectionRequest and SelectionOption, allowing a later invocation to complete the interaction.
• Record submitted input and provide optional recall navigation.
• Persist named configurations and provide interchangeable in-memory and JSON-file storage.
• Include backend examples that demonstrate command flows without an HTTP server or model requests.

Requires PHP 8.4.1+ and Neuron AI ^3.0. The Host Application controls presentation, Agent execution and streaming.

The command contracts at this tag use CommandArguments, SelectionRequest and say(). Later releases revise those interfaces and configuration storage; consult their upgrade notes when moving forward.

Source at 0.8.0