refactor: adjusts function requirements

Author: JasonTheAdams

src/Tools/DTO/FunctionCall.php

@@ -17,14 +17,14 @@
 class FunctionCall implements WithJsonSchemaInterface
 {
     /**
-     * @var string Unique identifier for this function call.
+     * @var string|null Unique identifier for this function call.
      */
-    private string $id;
+    private ?string $id;
 
     /**
-     * @var string The name of the function to call.
+     * @var string|null The name of the function to call.
      */
-    private string $name;
+    private ?string $name;
 
     /**
      * @var array<string, mixed> The arguments to pass to the function.
@@ -36,12 +36,17 @@ class FunctionCall implements WithJsonSchemaInterface
      *
      * @since n.e.x.t
      *
-     * @param string $id Unique identifier for this function call.
-     * @param string $name The name of the function to call.
+     * @param string|null $id Unique identifier for this function call.
+     * @param string|null $name The name of the function to call.
      * @param array<string, mixed> $args The arguments to pass to the function.
+     * @throws \InvalidArgumentException If neither id nor name is provided.
      */
-    public function __construct(string $id, string $name, array $args)
+    public function __construct(?string $id = null, ?string $name = null, array $args = [])
     {
+        if ($id === null && $name === null) {
+            throw new \InvalidArgumentException('At least one of id or name must be provided.');
+        }
+
         $this->id = $id;
         $this->name = $name;
         $this->args = $args;
@@ -52,9 +57,9 @@ public function __construct(string $id, string $name, array $args)
      *
      * @since n.e.x.t
      *
-     * @return string The unique identifier.
+     * @return string|null The unique identifier.
      */
-    public function getId(): string
+    public function getId(): ?string
     {
         return $this->id;
     }
@@ -64,9 +69,9 @@ public function getId(): string
      *
      * @since n.e.x.t
      *
-     * @return string The function name.
+     * @return string|null The function name.
      */
-    public function getName(): string
+    public function getName(): ?string
     {
         return $this->name;
     }
@@ -107,7 +112,17 @@ public static function getJsonSchema(): array
                     'additionalProperties' => true,
                 ],
             ],
-            'required' => ['id', 'name', 'args'],
+            'oneOf' => [
+                [
+                    'required' => ['id'],
+                ],
+                [
+                    'required' => ['name'],
+                ],
+                [
+                    'required' => ['id', 'name'],
+                ],
+            ],
         ];
     }
 }

src/Tools/DTO/FunctionDeclaration.php

@@ -27,7 +27,7 @@ class FunctionDeclaration implements WithJsonSchemaInterface
     private string $description;
 
     /**
-     * @var mixed The JSON schema for the function parameters.
+     * @var mixed|null The JSON schema for the function parameters.
      */
     private $parameters;
 
@@ -38,9 +38,9 @@ class FunctionDeclaration implements WithJsonSchemaInterface
      *
      * @param string $name The name of the function.
      * @param string $description A description of what the function does.
-     * @param mixed $parameters The JSON schema for the function parameters.
+     * @param mixed|null $parameters The JSON schema for the function parameters.
      */
-    public function __construct(string $name, string $description, $parameters)
+    public function __construct(string $name, string $description, $parameters = null)
     {
         $this->name = $name;
         $this->description = $description;
@@ -76,7 +76,7 @@ public function getDescription(): string
      *
      * @since n.e.x.t
      *
-     * @return mixed The parameters schema.
+     * @return mixed|null The parameters schema.
      */
     public function getParameters()
     {
@@ -106,7 +106,7 @@ public static function getJsonSchema(): array
                     'description' => 'The JSON schema for the function parameters.',
                 ],
             ],
-            'required' => ['name', 'description', 'parameters'],
+            'required' => ['name', 'description'],
         ];
     }
 }