cognesy/instructor-addons

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

Installs: 206

Dependents: 0

Suggesters: 1

Security: 0

Stars: 0

Watchers: 1

Forks: 0

pkg:composer/cognesy/instructor-addons

v1.21.0 2026-01-19 20:14 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