Feature/genai support

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "toin0u/digitalocean-v2",
+    "name": "hardcod3r/do-client",
     "description": "DigitalOcean API v2 client for PHP",
     "keywords": ["DigitalOcean", "API", "Cloud Hosting", "SSD", "VPS"],
     "license": "MIT",

digitalocean-genai-sdk-summary.md

@@ -0,0 +1,77 @@
+# DigitalOcean GenAI Laravel SDK Extension (Entity-Based)
+
+## ✅ Supported Resources & Endpoints
+
+---
+
+### 🧠 Agents (`Agent.php` / `AgentEntity.php`)
+- `GET    /v2/gen-ai/agents` → `all(): Agent[]`
+- `POST   /v2/gen-ai/agents` → `create(array): Agent`
+- `GET    /v2/gen-ai/agents/{uuid}` → `retrieve(string): Agent`
+- `PUT    /v2/gen-ai/agents/{uuid}` → `update(string, array): Agent`
+- `DELETE /v2/gen-ai/agents/{uuid}` → `destroy(string): void`
+
+---
+
+### 🔗 Agent Relationships (`AgentRelationship.php`)
+- `GET    /v2/gen-ai/agents/{uuid}/child_agents` → `list(string): Agent[]`
+- `POST   /v2/gen-ai/agents/{parent}/child_agents/{child}` → `attach(parent, child): Agent`
+- `DELETE /v2/gen-ai/agents/{parent}/child_agents/{child}` → `detach(parent, child): void`
+
+---
+
+### 🔑 OpenAI Keys (`OpenAiKey.php` / `OpenAiKeyEntity.php`)
+- `GET    /v2/gen-ai/openai/keys` → `all(): OpenAiKey[]`
+- `POST   /v2/gen-ai/openai/keys` → `create(array): OpenAiKey`
+- `GET    /v2/gen-ai/openai/keys/{uuid}` → `retrieve(string): OpenAiKey`
+- `PUT    /v2/gen-ai/openai/keys/{uuid}` → `update(string, array): OpenAiKey`
+- `DELETE /v2/gen-ai/openai/keys/{uuid}` → `destroy(string): void`
+- `GET    /v2/gen-ai/openai/keys/{uuid}/agents` → `listAgents(string): Agent[]`
+
+---
+
+### 👤 Anthropic Keys (`AnthropicKey.php` / `AnthropicKeyEntity.php`)
+- `GET    /v2/gen-ai/anthropic/keys` → `all(): AnthropicKey[]`
+- `POST   /v2/gen-ai/anthropic/keys` → `create(array): AnthropicKey`
+- `GET    /v2/gen-ai/anthropic/keys/{uuid}` → `retrieve(string): AnthropicKey`
+- `PUT    /v2/gen-ai/anthropic/keys/{uuid}` → `update(string, array): AnthropicKey`
+- `DELETE /v2/gen-ai/anthropic/keys/{uuid}` → `destroy(string): void`
+- `GET    /v2/gen-ai/anthropic/keys/{uuid}/agents` → `listAgents(string): Agent[]`
+
+---
+
+### 📚 Knowledge Bases (`KnowledgeBase.php` / `KnowledgeBaseEntity.php`)
+- `GET    /v2/gen-ai/knowledge_bases` → `all(): KnowledgeBase[]`
+- `POST   /v2/gen-ai/knowledge_bases` → `create(array): KnowledgeBase`
+- `GET    /v2/gen-ai/knowledge_bases/{uuid}` → `retrieve(string): KnowledgeBase`
+- `DELETE /v2/gen-ai/knowledge_bases/{uuid}` → `destroy(string): void`
+
+---
+
+### 🔍 Indexing Jobs (`IndexingJob.php` / `IndexingJobEntity.php`)
+- `GET    /v2/gen-ai/indexing_jobs` → `all(): IndexingJob[]`
+
+---
+
+## 🧩 Binding Summary (`Client.php`)
+
+```php
+$client->genAiAgent();
+$client->genAiAgentRelationships();
+$client->genAiOpenAiKeys();
+$client->genAiAnthropicKeys();
+$client->genAiKnowledgeBases();
+$client->genAiIndexingJobs();
+```
+
+---
+
+## 📦 Entities Implemented
+
+- `Agent`
+- `OpenAiKey`
+- `AnthropicKey`
+- `KnowledgeBase`
+- `IndexingJob`
+
+All extend `AbstractEntity` and use `setCreatedAt()`, `setUpdatedAt()`, etc. for normalization.

src/Api/GenAi/Agent.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use DigitalOceanV2\Entity\GenAi\Agent as AgentEntity;
+use stdClass;
+
+class Agent extends AbstractApi
+{
+    /**
+     * @return AgentEntity[]
+     */
+    public function all(): array
+    {
+        $response = $this->get('gen-ai/agents');
+
+        return array_map(
+            fn ($agent) => new AgentEntity($agent),
+            $response->agents
+        );
+    }
+
+    public function create(array $data): AgentEntity
+    {
+        $response = $this->post('gen-ai/agents', $data);
+
+        return new AgentEntity($response->agent);
+    }
+
+    public function retrieve(string $uuid): AgentEntity
+    {
+        $response = $this->get("gen-ai/agents/{$uuid}");
+
+        return new AgentEntity($response->agent);
+    }
+
+    public function update(string $uuid, array $data): AgentEntity
+    {
+        $response = $this->put("gen-ai/agents/{$uuid}", $data);
+
+        return new AgentEntity($response->agent);
+    }
+
+    public function destroy(string $uuid): void
+    {
+        $this->delete("gen-ai/agents/{$uuid}");
+    }
+}

src/Api/GenAi/AgentRelationship.php

@@ -0,0 +1,24 @@
+<?php declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use stdClass;
+
+class AgentRelationship extends AbstractApi
+{
+    public function list(string $uuid): stdClass
+    {
+        return $this->get("gen-ai/agents/{$uuid}/child_agents");
+    }
+
+    public function attach(string $parentUuid, string $childUuid): stdClass
+    {
+        return $this->post("gen-ai/agents/{$parentUuid}/child_agents/{$childUuid}");
+    }
+
+    public function detach(string $parentUuid, string $childUuid): void
+    {
+        $this->delete("gen-ai/agents/{$parentUuid}/child_agents/{$childUuid}");
+    }
+}

src/Api/GenAi/AnthropicKey.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use DigitalOceanV2\Entity\GenAi\AnthropicKey as AnthropicKeyEntity;
+use DigitalOceanV2\Entity\GenAi\Agent as AgentEntity;
+
+class AnthropicKey extends AbstractApi
+{
+    /**
+     * @return AnthropicKeyEntity[]
+     */
+    public function all(): array
+    {
+        $response = $this->get('gen-ai/anthropic/keys');
+
+        return array_map(
+            fn ($key) => new AnthropicKeyEntity($key),
+            $response->keys
+        );
+    }
+
+    public function create(array $data): AnthropicKeyEntity
+    {
+        $response = $this->post('gen-ai/anthropic/keys', $data);
+
+        return new AnthropicKeyEntity($response->key);
+    }
+
+    public function retrieve(string $uuid): AnthropicKeyEntity
+    {
+        $response = $this->get("gen-ai/anthropic/keys/{$uuid}");
+
+        return new AnthropicKeyEntity($response->key);
+    }
+
+    public function update(string $uuid, array $data): AnthropicKeyEntity
+    {
+        $response = $this->put("gen-ai/anthropic/keys/{$uuid}", $data);
+
+        return new AnthropicKeyEntity($response->key);
+    }
+
+    public function destroy(string $uuid): void
+    {
+        $this->delete("gen-ai/anthropic/keys/{$uuid}");
+    }
+
+    /**
+     * @return AgentEntity[]
+     */
+    public function listAgents(string $uuid): array
+    {
+        $response = $this->get("gen-ai/anthropic/keys/{$uuid}/agents");
+
+        return array_map(
+            fn ($agent) => new AgentEntity($agent),
+            $response->agents
+        );
+    }
+}

src/Api/GenAi/IndexingJob.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use DigitalOceanV2\Entity\GenAi\IndexingJob as IndexingJobEntity;
+
+class IndexingJob extends AbstractApi
+{
+    /**
+     * @return IndexingJobEntity[]
+     */
+    public function all(): array
+    {
+        $response = $this->get('gen-ai/indexing_jobs');
+
+        return array_map(
+            fn ($job) => new IndexingJobEntity($job),
+            $response->indexing_jobs
+        );
+    }
+}

src/Api/GenAi/KnowledgeBase.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use DigitalOceanV2\Entity\GenAi\KnowledgeBase as KnowledgeBaseEntity;
+
+class KnowledgeBase extends AbstractApi
+{
+    /**
+     * @return KnowledgeBaseEntity[]
+     */
+    public function all(): array
+    {
+        $response = $this->get('gen-ai/knowledge_bases');
+
+        return array_map(
+            fn ($kb) => new KnowledgeBaseEntity($kb),
+            $response->knowledge_bases
+        );
+    }
+
+    public function create(array $data): KnowledgeBaseEntity
+    {
+        $response = $this->post('gen-ai/knowledge_bases', $data);
+
+        return new KnowledgeBaseEntity($response->knowledge_base);
+    }
+
+    public function retrieve(string $uuid): KnowledgeBaseEntity
+    {
+        $response = $this->get("gen-ai/knowledge_bases/{$uuid}");
+
+        return new KnowledgeBaseEntity($response->knowledge_base);
+    }
+
+    public function destroy(string $uuid): void
+    {
+        $this->delete("gen-ai/knowledge_bases/{$uuid}");
+    }
+}

src/Api/GenAi/OpenAiKey.php

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalOceanV2\Api\GenAi;
+
+use DigitalOceanV2\Api\AbstractApi;
+use DigitalOceanV2\Entity\GenAi\OpenAiKey as OpenAiKeyEntity;
+
+class OpenAiKey extends AbstractApi
+{
+    /**
+     * @return OpenAiKeyEntity[]
+     */
+    public function all(): array
+    {
+        $response = $this->get('gen-ai/openai/keys');
+
+        return array_map(
+            fn ($key) => new OpenAiKeyEntity($key),
+            $response->keys
+        );
+    }
+
+    public function create(array $data): OpenAiKeyEntity
+    {
+        $response = $this->post('gen-ai/openai/keys', $data);
+
+        return new OpenAiKeyEntity($response->key);
+    }
+
+    public function retrieve(string $uuid): OpenAiKeyEntity
+    {
+        $response = $this->get("gen-ai/openai/keys/{$uuid}");
+
+        return new OpenAiKeyEntity($response->key);
+    }
+
+    public function update(string $uuid, array $data): OpenAiKeyEntity
+    {
+        $response = $this->put("gen-ai/openai/keys/{$uuid}", $data);
+
+        return new OpenAiKeyEntity($response->key);
+    }
+
+    public function destroy(string $uuid): void
+    {
+        $this->delete("gen-ai/openai/keys/{$uuid}");
+    }
+
+    /**
+     * @return AgentEntity[]
+     */
+    public function listAgents(string $uuid): array
+    {
+        $response = $this->get("gen-ai/openai/keys/{$uuid}/agents");
+
+        return array_map(
+            fn ($agent) => new \DigitalOceanV2\Entity\GenAi\Agent($agent),
+            $response->agents
+        );
+    }
+}