PHPackages                             cognesy/instructor-addons - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. cognesy/instructor-addons

ActiveLibrary[Utility & Helpers](/categories/utility)

cognesy/instructor-addons
=========================

Optional addons for Instructor library, should be used with Instructor or Polyglot

v2.3.1(1mo ago)0206MITPHPPHP ^8.3

Since Apr 22Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/cognesy/instructor-addons)[ Packagist](https://packagist.org/packages/cognesy/instructor-addons)[ Docs](https://instructorphp.com)[ RSS](/packages/cognesy-instructor-addons/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (27)Versions (86)Used By (0)

Overview
========

[](#overview)

This repository contains the source code for the addons to Instructor, which are extra capabilities useful in certain scenarios.

Addons expand LLM capabilities but are not required for basic functionality.

Key Components
--------------

[](#key-components)

- **Agent** - Tool-calling agent with iterative execution, state management, and extensible capabilities. See `AGENT.md`.
- **StepByStep** - Foundational architecture for iterative, state-based processes with configurable continuation criteria. See `STEPBYSTEP.md`.
- **ToolUse** - LLM tool calling with automatic execution and result handling. See `TOOLUSE.md`.
- **Chat** - Multi-participant conversations with configurable behavior. See `CHAT.md`.

Recent Updates (2026-01-16)
---------------------------

[](#recent-updates-2026-01-16)

- **Continuation Observability**: `ContinuationOutcome` and `ContinuationEvaluation` provide full decision tracing
- **Error Policy**: Configurable retry behavior with `ErrorPolicy::retryToolErrors()`, `stopOnAnyError()`, etc.
- **Time Tracking**: Per-execution timing (`executionStartedAt`) and cumulative timeout support
- **Slim Serialization**: `SlimAgentStateSerializer` for compact state payloads
- **Message Helpers**: `isAssistant()`, `isTool()`, `isUser()`, `isSystem()`, `hasRole()` on Message class
- **Broadcasting**: `AgentEventEnvelopeAdapter` supports Laravel Reverb/Pusher with a wiretap integration

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance90

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

85

Last Release

50d ago

Major Versions

0.17.11 → 1.0-rc12025-06-11

v1.22.0 → v2.0.02026-03-13

PHP version history (2 changes)0.13.9PHP ^8.2

v1.19.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/d11593cece5bb65ba5eea704a91e1dda72362e86f8fe0e99295f291ba7628cac?d=identicon)[ddebowczyk](/maintainers/ddebowczyk)

---

Top Contributors

[![ddebowczyk](https://avatars.githubusercontent.com/u/184133?v=4)](https://github.com/ddebowczyk "ddebowczyk (196 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cognesy-instructor-addons/health.svg)

```
[![Health](https://phpackages.com/badges/cognesy-instructor-addons/health.svg)](https://phpackages.com/packages/cognesy-instructor-addons)
```

###  Alternatives

[baibaratsky/yii2-serialized-attributes-behavior

Yii2 Serialized Attributes Behavior

1174.1k9](/packages/baibaratsky-yii2-serialized-attributes-behavior)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)