PHPackages cognesy/instructor-symfony - 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. [Logging & Monitoring](/categories/logging) 4. / 5. cognesy/instructor-symfony ActiveLibrary[Logging & Monitoring](/categories/logging) cognesy/instructor-symfony ========================== Batteries-included Symfony integration for Instructor PHP v2.3.1(3mo ago)00MITPHPPHP ^8.3 Since Mar 30Pushed 3mo agoCompare [ Source](https://github.com/cognesy/instructor-symfony)[ Packagist](https://packagist.org/packages/cognesy/instructor-symfony)[ Docs](https://instructorphp.com)[ RSS](/packages/cognesy-instructor-symfony/feed)WikiDiscussions main Synced 3w ago READMEChangelog (2)Dependencies (21)Versions (3)Used By (0) Symfony Package =============== [](#symfony-package) Batteries-included Symfony integration for InstructorPHP. It is intended to become the first-party framework package for Symfony applications using: - Instructor primitives - Polyglot inference and embeddings - native `Cognesy\Agents` - `AgentCtrl` - shared events, logging, and telemetry wiring - testing helpers and Symfony-native bundle integration The package is being introduced in phases. The current baseline already includes the bundle surface, config translation, initial container bindings for core runtime services, the first AgentCtrl container/runtime adapters, native-agent registry/session wiring, and the initial Messenger delivery seam. The current baseline also includes an explicit session-persistence seam under `instructor.sessions`, with built-in in-memory and file-backed storage paths for native agents. Telemetry is now package-owned too: explicit exporter selection, projector composition, shared event-bus bridge wiring, and lifecycle cleanup for HTTP, console, and Messenger worker contexts all live under `instructor.telemetry`. Later tasks will expand broader testing and the migration path. Planned Surface --------------- [](#planned-surface) - bundle entrypoint under `Cognesy\Instructor\Symfony\` - one public `instructor` config root with explicit subtrees - framework-owned integration for core runtime services, agents, observability, and testing Current Container Entry Points ------------------------------ [](#current-container-entry-points) The package now registers the initial core contracts and developer-facing services: - `Cognesy\Config\Contracts\CanProvideConfig` - `Cognesy\Http\Contracts\CanSendHttpRequests` - `Cognesy\Instructor\Symfony\AgentCtrl\SymfonyAgentCtrl` - `Cognesy\Instructor\Symfony\AgentCtrl\SymfonyAgentCtrlRuntimes` - `Cognesy\Polyglot\Inference\Contracts\CanCreateInference` - `Cognesy\Polyglot\Embeddings\Contracts\CanCreateEmbeddings` - `Cognesy\Instructor\Contracts\CanCreateStructuredOutput` - `Cognesy\Instructor\Symfony\Delivery\Messenger\ExecuteAgentCtrlPromptMessageHandler` - `Cognesy\Instructor\Symfony\Delivery\Messenger\ExecuteNativeAgentPromptMessageHandler` - `Cognesy\Polyglot\Inference\Inference` - `Cognesy\Polyglot\Embeddings\Embeddings` - `Cognesy\Instructor\StructuredOutput` The AgentCtrl runtime layer now includes context-aware `cli`, `http`, and `messenger` adapters plus typed continuation and handoff references. The package also exposes explicit Messenger message and handler seams for queued AgentCtrl prompts, queued native-agent prompts, and opt-in runtime observation forwarding. Native agent tools, capabilities, `AgentDefinition` services, and `SchemaRegistration` services now autoconfigure into the package-owned registries, while manual `AgentRegistryTags::*` tags remain available for explicit overrides. Ownership boundaries: - `packages/symfony` owns Symfony bundle registration, config normalization, service wiring, and framework defaults - `packages/events` continues to own reusable event-dispatch primitives such as the raw Symfony bridge - `packages/logging` continues to own reusable logging primitives, while the Symfony-facing logging bundle path is planned to migrate behind `packages/symfony` Documentation ------------- [](#documentation) - `packages/symfony/docs/overview.md` - `packages/symfony/docs/configuration.md` - `packages/symfony/docs/runtime-surfaces.md` - `packages/symfony/docs/sessions.md` - `packages/symfony/docs/testing.md` - `packages/symfony/docs/telemetry.md` - `packages/symfony/docs/quickstart.md` - `packages/symfony/docs/logging.md` - `packages/symfony/docs/delivery.md` - `packages/symfony/docs/operations.md` - `packages/symfony/docs/migration.md` - `packages/symfony/CHEATSHEET.md` Distribution Readiness ---------------------- [](#distribution-readiness) The split-workflow matrix is now generated with `packages/symfony` included. Remaining bootstrap steps outside this package task: 1. Create the split repository `cognesy/instructor-symfony`. 2. Let the split workflow populate the repository, or bootstrap it manually if publication is needed immediately. 3. Verify the split repo `main` branch contains at least `composer.json`, `src/`, and `README.md`. 4. Submit the split repository to Packagist. 5. Verify Packagist metadata and package resolution endpoints after submission. ### Health Score 36 — LowBetter than 79% of packages Maintenance82 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 Maturing project, gaining track record 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 ~0 days Total 2 Last Release 91d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/184133?v=4)[Dariusz Debowczyk](/maintainers/ddebowczyk)[@ddebowczyk](https://github.com/ddebowczyk) --- Top Contributors [![ddebowczyk](https://avatars.githubusercontent.com/u/184133?v=4)](https://github.com/ddebowczyk "ddebowczyk (5 commits)") --- Tags symfonyloggingaitelemetryagentsllminstructoragentctrl ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/cognesy-instructor-symfony/health.svg) ``` [![Health](https://phpackages.com/badges/cognesy-instructor-symfony/health.svg)](https://phpackages.com/packages/cognesy-instructor-symfony) ``` ### Alternatives [sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.4M196](/packages/sulu-sulu)[easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k17.5M378](/packages/easycorp-easyadmin-bundle)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.4M521](/packages/shopware-core)[chameleon-system/chameleon-base The Chameleon System core. 1027.9k4](/packages/chameleon-system-chameleon-base)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 9317.2k55](/packages/open-dxp-opendxp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)