cognesy/instructor-addons

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

Maintainers

Package info

github.com/cognesy/instructor-addons

Homepage

Issues

pkg:composer/cognesy/instructor-addons

Statistics

Installs: 206

Dependents: 0

Suggesters: 1

Stars: 0

v2.0.0 2026-03-13 19:48 UTC

README

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

  • 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)

  • 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