Dont depend on symfony/ai directly : it can be used standalone or in combination.

Author: veewee

README.md

@@ -8,7 +8,7 @@ Perfect for building chatbots, AI agents, CLI wizards, or any system that guides
 
 Agent Rules provides a logical processing unit for handling **unstructured input in a structured and interactive way**. It enables you to define validation rules that can request missing information, enforce business logic, and provide intelligent feedback to users or AI agents.
 
-Built on top of [Symfony AI Agent](https://github.com/symfony/ai-agent), this library integrates seamlessly with AI-powered tools and conversational interfaces.
+Built to be compatible with [Symfony AI Agent](https://github.com/symfony/ai-agent), this library integrates seamlessly with AI-powered tools and conversational interfaces.
 
 ## Key Features
 
@@ -17,7 +17,7 @@ Built on top of [Symfony AI Agent](https://github.com/symfony/ai-agent), this li
 - **Interactive Feedback**: Rules can request missing data with structured result types
 - **Composable Logic**: Combine rules with `Sequence` (AND), `Any` (OR), and `Either` patterns
 - **Type-Safe**: Full PHP 8.4+ type safety with readonly classes and generic support
-- **AI Agent Integration**: Built-in support for Symfony AI Agent's source tracking and tool system
+- **Framework Agnostic**: Works independently with optional Symfony AI integration
 
 ## Installation
 
@@ -247,66 +247,36 @@ The engine automatically:
 - Detects cyclic dependencies
 - Validates that all dependencies exist
 
-## Integration with Symfony AI Agent
+## Adding Context with Sources
 
-### Creating an AI Tool
+You can attach contextual information to results that helps users or AI agents understand where to find more information:
 
 ```php
-use Symfony\AI\Agent\Toolbox\Attribute\AsTool;
-use Symfony\AI\Agent\Toolbox\Source\HasSourcesInterface;
-use Symfony\AI\Agent\Toolbox\Source\HasSourcesTrait;
+use Phpro\AgentRules\Source\Source;
 
-#[AsTool(
-    name: 'validate_order',
-    description: 'Validates customer order information and guides through missing data.'
-)]
-final class OrderValidationTool implements HasSourcesInterface
-{
-    use HasSourcesTrait;
-
-    public function __construct(
-        private RuleEngine $ruleEngine,
-    ) {}
-
-    public function __invoke(
-        string $email,
-        ?string $productId = null,
-        ?int $quantity = null,
-    ): ResultInterface {
-        $request = new OrderRequest($email, $productId, $quantity);
-        $evaluation = $this->ruleEngine->evaluate($request);
-
-        $result = $evaluation->result ?? new CompleteResult(
-            message: 'Order validation complete!'
-        );
-
-        // Track sources for AI agent context
-        foreach ($result->sources()->getSources() as $source) {
-            $this->addSource($source);
-        }
-
-        return $result;
-    }
-}
-```
-
-### Adding Sources for Context
+$result = new IncompleteResult(
+    missingField: 'productId',
+    message: 'Please provide the product ID.'
+);
 
-```php
-return RuleEvaluation::respond(
-    (new IncompleteResult(
-        missingField: 'productId',
-        message: 'Please provide the product ID.'
-    ))->addSources(
-        new Source(
-            name: 'Product Catalog',
-            reference: 'https://example.com/products',
-            content: 'Browse our product catalog to find product IDs.'
-        )
+$result->sources()->add(
+    new Source(
+        name: 'Product Catalog',
+        reference: 'https://example.com/products',
+        content: 'Browse our product catalog to find product IDs.'
     )
 );
+
+return RuleEvaluation::respond($result);
 ```
 
+Sources are particularly useful for:
+- Documentation links
+- Example values
+- Help text
+- Related resources
+- API references
+
 ### Symfony Configuration
 
 Configure the rule engine as a service:
@@ -383,10 +353,15 @@ sequenceDiagram
 
 ```php
 // 1. Define the request context
+
+use Symfony\AI\Platform\Contract\JsonSchema\Attribute\With;
+
 final class RegistrationRequest
 {
     public function __construct(
         public readonly ?string $email = null,
+        #[With(minLength: 10, maxLength: 255)]
+        #[\SensitiveParameter]
         public readonly ?string $password = null,
         public readonly ?string $fullName = null,
         public readonly ?bool $termsAccepted = null,
@@ -469,23 +444,22 @@ final class RegistrationTool implements HasSourcesInterface
     ) {}
 
     public function __invoke(
-        ?string $email = null,
-        ?string $password = null,
-        ?string $fullName = null,
-        ?bool $termsAccepted = null,
+        RegistrationRequest $request,
     ): ResultInterface {
-        $request = new RegistrationRequest(
-            email: $email,
-            password: $password,
-            fullName: $fullName,
-            termsAccepted: $termsAccepted,
-        );
-
         $evaluation = $this->ruleEngine->evaluate($request);
-
-        return $evaluation->result ?? new CompleteResult(
+        $result = $evaluation->result ?? new CompleteResult(
             message: 'Registration validated! Your account has been created.'
         );
+        
+        foreach ($result->sources() as $source) {
+            $this->addSource(new \Symfony\AI\Agent\Toolbox\Source\Source(
+                name: $source->name,
+                reference: $source->reference,
+                content: $source->content
+            ));
+        }
+        
+        return $result;
     }
 }
 

composer.json

@@ -4,8 +4,7 @@
     "type": "library",
     "require": {
         "php": "~8.3.0 || ~8.4.0 || ~8.5.0",
-        "azjezz/psl": "^4.2",
-        "symfony/ai-agent": "^0.2.0"
+        "azjezz/psl": "^4.2"
     },
     "license": "MIT",
     "autoload": {

mago.toml

@@ -20,7 +20,7 @@ literal-named-argument = { enabled = false }
 halstead = { effort-threshold = 7000 }
 
 [analyzer]
-excludes = ["tests/**/*.php"]
+excludes = ["tests/"]
 plugins = ["psl"]
 find-unused-definitions = true
 find-unused-expressions = true

src/Result/AbstractResult.php

@@ -4,8 +4,7 @@
 
 namespace Phpro\AgentRules\Result;
 
-use Symfony\AI\Agent\Toolbox\Source\Source;
-use Symfony\AI\Agent\Toolbox\Source\SourceMap;
+use Phpro\AgentRules\Source\SourceMap;
 
 abstract readonly class AbstractResult implements ResultInterface
 {
@@ -22,15 +21,6 @@ public function sources(): SourceMap
         return $this->sources;
     }
 
-    public function addSources(Source ... $sources): self
-    {
-        foreach ($sources as $source) {
-            $this->sources->addSource($source);
-        }
-
-        return $this;
-    }
-
     #[\Override]
     public function jsonSerialize(): array
     {

src/Result/ResultInterface.php

@@ -5,7 +5,8 @@
 
 namespace Phpro\AgentRules\Result;
 
-use Symfony\AI\Agent\Toolbox\Source\SourceMap;
+
+use Phpro\AgentRules\Source\SourceMap;
 
 interface ResultInterface extends \JsonSerializable
 {

src/Source/Source.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+
+namespace Phpro\AgentRules\Source;
+
+final readonly class Source
+{
+    public function __construct(
+        public string $name,
+        public string $reference,
+        public string $content,
+    ) {
+    }
+}

src/Source/SourceMap.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+
+namespace Phpro\AgentRules\Source;
+
+final class SourceMap
+{
+    /**
+     * @var list<Source>
+     */
+    public array $sources;
+
+    /**
+     * @no-named-arguments
+     */
+    public function __construct(
+        Source ... $sources,
+    ) {
+        $this->sources = $sources;
+    }
+
+    /**
+     * @return list<Source>
+     */
+    public function sources(): array
+    {
+        return $this->sources;
+    }
+
+    public function add(Source ... $sources): self
+    {
+        $this->sources = [...$this->sources, ...$sources];
+
+        return $this;
+    }
+}

tests/Result/BlockedResultTest.php

@@ -8,7 +8,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 use Phpro\AgentRules\Result\BlockedResult;
-use Symfony\AI\Agent\Toolbox\Source\Source;
+use Phpro\AgentRules\Source\Source;
 
 #[CoversClass(BlockedResult::class)]
 final class BlockedResultTest extends TestCase
@@ -38,7 +38,7 @@ public function it_returns_empty_source_map(): void
     {
         $result = new BlockedResult('test_reason', 'Test message');
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
 
         static::assertCount(0, $sources);
     }
@@ -47,11 +47,14 @@ public function it_returns_empty_source_map(): void
     public function it_can_add_sources_to_result(): void
     {
         $result = new BlockedResult('test_reason', 'Test message');
-        $source = new Source('test-source', 'ref', 'content');
+        $source = new Source('Policy Document', 'https://policy.example.com', 'See policy for details');
 
-        $result->addSources($source);
+        $result->sources()->add($source);
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
         static::assertCount(1, $sources);
+        static::assertSame('Policy Document', $sources[0]->name);
+        static::assertSame('https://policy.example.com', $sources[0]->reference);
+        static::assertSame('See policy for details', $sources[0]->content);
     }
 }

tests/Result/CompleteResultTest.php

@@ -8,7 +8,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 use Phpro\AgentRules\Result\CompleteResult;
-use Symfony\AI\Agent\Toolbox\Source\Source;
+use Phpro\AgentRules\Source\Source;
 
 #[CoversClass(CompleteResult::class)]
 final class CompleteResultTest extends TestCase
@@ -37,7 +37,7 @@ public function it_returns_empty_source_map(): void
     {
         $result = new CompleteResult('Task completed');
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
 
         static::assertCount(0, $sources);
     }
@@ -46,11 +46,14 @@ public function it_returns_empty_source_map(): void
     public function it_can_add_sources_to_result(): void
     {
         $result = new CompleteResult('Task completed');
-        $source = new Source('test-source', 'ref', 'content');
+        $source = new Source('Documentation', 'https://docs.example.com', 'See the docs for more info');
 
-        $result->addSources($source);
+        $result->sources()->add($source);
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
         static::assertCount(1, $sources);
+        static::assertSame('Documentation', $sources[0]->name);
+        static::assertSame('https://docs.example.com', $sources[0]->reference);
+        static::assertSame('See the docs for more info', $sources[0]->content);
     }
 }

tests/Result/ErrorResultTest.php

@@ -8,7 +8,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 use Phpro\AgentRules\Result\ErrorResult;
-use Symfony\AI\Agent\Toolbox\Source\Source;
+use Phpro\AgentRules\Source\Source;
 
 #[CoversClass(ErrorResult::class)]
 final class ErrorResultTest extends TestCase
@@ -41,7 +41,7 @@ public function it_returns_empty_source_map(): void
     {
         $result = new ErrorResult('Error occurred', 'Fix the issue');
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
 
         static::assertCount(0, $sources);
     }
@@ -50,11 +50,14 @@ public function it_returns_empty_source_map(): void
     public function it_can_add_sources_to_result(): void
     {
         $result = new ErrorResult('Error occurred', 'Fix the issue');
-        $source = new Source('test-source', 'ref', 'content');
+        $source = new Source('Error Log', 'https://logs.example.com', 'Stack trace details');
 
-        $result->addSources($source);
+        $result->sources()->add($source);
 
-        $sources = $result->sources()->getSources();
+        $sources = $result->sources()->sources();
         static::assertCount(1, $sources);
+        static::assertSame('Error Log', $sources[0]->name);
+        static::assertSame('https://logs.example.com', $sources[0]->reference);
+        static::assertSame('Stack trace details', $sources[0]->content);
     }
 }