@bluefly/openstandardagents 0.4.6 → 0.4.8

package/examples/drupal/ai_agents_agentscope/src/Plugin/AiProvider/AgentScopeProvider.php

@@ -0,0 +1,217 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\ai_agents_agentscope\Plugin\AiProvider;
+
+use Drupal\ai\Attribute\AiProvider;
+use Drupal\ai\Base\AiProviderClientBase;
+use Drupal\ai\Exception\AiResponseErrorException;
+use Drupal\ai\OperationType\Chat\ChatInput;
+use Drupal\ai\OperationType\Chat\ChatInterface;
+use Drupal\ai\OperationType\Chat\ChatMessage;
+use Drupal\ai\OperationType\Chat\ChatOutput;
+use Drupal\Core\Config\ImmutableConfig;
+use Drupal\Core\StringTranslation\TranslatableMarkup;
+use GuzzleHttp\Exception\GuzzleException;
+
+/**
+ * AiProvider plugin that bridges to AgentScope's Python HTTP API.
+ *
+ * This is a thin bridge. All agent plugin derivation, manifest reading,
+ * and OSSA integration is handled by ai_agents_ossa. This provider ONLY
+ * provides the HTTP transport layer to speak AgentScope's REST API.
+ *
+ * AgentScope runtime exposes:
+ * - POST /api/v1/agent/message — send a message, get a response
+ * - GET  /api/v1/health        — health check
+ * - GET  /api/v1/agents        — list registered agents
+ */
+#[AiProvider(
+  id: 'agentscope',
+  label: new TranslatableMarkup('AgentScope'),
+)]
+class AgentScopeProvider extends AiProviderClientBase implements ChatInterface {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getConfiguredModels(?string $operation_type = NULL, array $capabilities = []): array {
+    // AgentScope doesn't expose a model list — agents are the unit of work.
+    // Return a single virtual model representing the AgentScope runtime.
+    return [
+      'agentscope-runtime' => [
+        'label' => 'AgentScope Runtime',
+        'model_id' => 'agentscope-runtime',
+        'operation_types' => ['chat'],
+      ],
+    ];
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function isUsable(?string $operation_type = NULL, array $capabilities = []): bool {
+    $config = $this->getConfig();
+    $endpoint = $config->get('endpoint');
+
+    if (empty($endpoint)) {
+      return FALSE;
+    }
+
+    if ($operation_type) {
+      return in_array($operation_type, $this->getSupportedOperationTypes());
+    }
+
+    return TRUE;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getSupportedOperationTypes(): array {
+    return ['chat'];
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getConfig(): ImmutableConfig {
+    return $this->configFactory->get('ai_agents_agentscope.settings');
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getApiDefinition(): array {
+    return [
+      'chat' => [
+        'temperature' => [
+          'type' => 'float',
+          'default' => 0.7,
+          'description' => 'Sampling temperature for the agent response.',
+        ],
+        'max_tokens' => [
+          'type' => 'integer',
+          'default' => 2048,
+          'description' => 'Maximum tokens in the response.',
+        ],
+      ],
+    ];
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getModelSettings(string $model_id, array $generalConfig = []): array {
+    return $generalConfig;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function setAuthentication(mixed $authentication): void {
+    // AgentScope runtime may not require auth, but store it if provided.
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function chat(array|string|ChatInput $input, string $model_id, array $tags = []): ChatOutput {
+    $config = $this->getConfig();
+    $endpoint = rtrim($config->get('endpoint') ?? 'http://127.0.0.1:12310', '/');
+    $timeout = (int) ($config->get('timeout') ?? 60);
+
+    // Build the message payload from ChatInput.
+    $messages = [];
+    if ($input instanceof ChatInput) {
+      foreach ($input->getMessages() as $message) {
+        $messages[] = [
+          'role' => $message->getRole(),
+          'content' => $message->getText(),
+        ];
+      }
+    }
+    elseif (is_string($input)) {
+      $messages[] = [
+        'role' => 'user',
+        'content' => $input,
+      ];
+    }
+    elseif (is_array($input)) {
+      $messages = $input;
+    }
+
+    // Extract the last user message as the prompt for AgentScope.
+    $prompt = '';
+    foreach (array_reverse($messages) as $msg) {
+      if (($msg['role'] ?? '') === 'user') {
+        $prompt = $msg['content'] ?? '';
+        break;
+      }
+    }
+
+    if (empty($prompt)) {
+      $prompt = end($messages)['content'] ?? '';
+    }
+
+    // Determine agent_id from tags or model_id.
+    $agentId = $tags['agent_id'] ?? $model_id;
+
+    $payload = [
+      'agent_id' => $agentId,
+      'message' => $prompt,
+    ];
+
+    // Pass model configuration if available from tags.
+    if (!empty($tags['model_config'])) {
+      $payload['config'] = $tags['model_config'];
+    }
+
+    try {
+      $response = $this->httpClient->request('POST', $endpoint . '/api/v1/agent/message', [
+        'json' => $payload,
+        'timeout' => $timeout,
+        'headers' => array_filter([
+          'Accept' => 'application/json',
+          'Content-Type' => 'application/json',
+          'Authorization' => $config->get('api_key') ? 'Bearer ' . $config->get('api_key') : NULL,
+        ]),
+      ]);
+
+      $body = json_decode((string) $response->getBody(), TRUE);
+      $content = $body['content'] ?? $body['response'] ?? '';
+
+      $message = new ChatMessage('model', $content);
+      return new ChatOutput($message, $body, $body['metadata'] ?? []);
+    }
+    catch (GuzzleException $e) {
+      throw new AiResponseErrorException(
+        sprintf('AgentScope runtime request failed: %s', $e->getMessage())
+      );
+    }
+  }
+
+  /**
+   * Checks if the AgentScope runtime is reachable.
+   *
+   * @return bool
+   *   TRUE if the runtime health check passes.
+   */
+  public function isHealthy(): bool {
+    $config = $this->getConfig();
+    $endpoint = rtrim($config->get('endpoint') ?? 'http://127.0.0.1:12310', '/');
+
+    try {
+      $response = $this->httpClient->request('GET', $endpoint . '/api/v1/health', [
+        'timeout' => 5,
+      ]);
+
+      return $response->getStatusCode() === 200;
+    }
+    catch (GuzzleException) {
+      return FALSE;
+    }
+  }
+
+}

package/examples/drupal/ai_agents_agentscope/src/Plugin/Derivative/AgentScopeDeriver.php

@@ -0,0 +1,10 @@
+<?php
+
+/**
+ * @file
+ * DELETED - This file is no longer needed.
+ *
+ * The ai_agents_ossa module provides OssaAgentDeriver which already derives
+ * AiAgent plugins from OSSA config entities. This duplicate deriver was
+ * unnecessary. Remove this file.
+ */

package/examples/drupal/ai_agents_agentscope/src/Service/AgentScopeAdapter.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * @file
+ * DELETED — This file is no longer needed.
+ *
+ * The ai_agents_ossa module handles all manifest reading and entity management.
+ * This adapter was duplicating that functionality. Remove this file.
+ */

package/examples/drupal/content-moderator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: content_moderator

package/examples/drupal/gitlab-ml-recommender.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: gitlab-ml-recommender

package/examples/export/langchain/production-agent-with-memory/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: production-agent-with-memory

package/examples/export/langchain/production-agent-with-tools/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: production-agent-with-tools

package/examples/extensions/agents-md-advanced.yml

@@ -1,7 +1,7 @@
 # OSSA agents.md Extension - Advanced Example
 # Demonstrates advanced features including Cursor integration and custom sections
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: fullstack-dev-agent

package/examples/extensions/agents-md-basic.yml

@@ -1,7 +1,7 @@
 # OSSA agents.md Extension - Basic Example
 # Demonstrates basic agents.md generation from OSSA manifest
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: code-review-agent

package/examples/extensions/agents-md-sync.yml

@@ -1,7 +1,7 @@
 # OSSA agents.md Extension - Sync Example
 # Demonstrates automatic synchronization configuration
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: docs-agent

package/examples/extensions/agents-md-v1.yml

@@ -2,7 +2,7 @@
 # agents.md standard: repository-level agent guidance (AAIF / agents.md)
 # See: https://agents.md | https://github.com/agentsmd/agents.md
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: ExtensionSchema
 metadata:
   name: agents-md-extension

package/examples/extensions/drupal-v1.yml

@@ -2,7 +2,7 @@
 # Extension specification for Drupal LLM Platform deployment
 # Compatible with Drupal 10+ and llm-platform modules
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: ExtensionSchema
 metadata:
   name: drupal-extension

package/examples/extensions/encryption-multi-provider.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: secure-agent
@@ -28,7 +28,7 @@ spec:
         interval_days: 90
         
 ---
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: vault-encrypted-agent
@@ -57,7 +57,7 @@ spec:
         - "*"  # Encrypt all fields
       
 ---
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: gcp-kms-agent
@@ -86,7 +86,7 @@ spec:
         - pii_fields
       
 ---
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: azure-keyvault-agent

package/examples/extensions/kagent-v1.yml

@@ -2,7 +2,7 @@
 # Production-grade specification for Kubernetes-native agent deployment
 # Compatible with kagent.dev/v1alpha1 CRDs
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: ExtensionSchema
 metadata:
   name: kagent-extension

package/examples/extensions/knowledge-sources.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: rag-agent

package/examples/extensions/mcp-full-featured.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: mcp-powered-agent

package/examples/getting-started/01-minimal-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: hello-world-agent

package/examples/getting-started/02-agent-with-tools.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: code-assistant

package/examples/getting-started/03-agent-with-safety.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: secure-assistant

package/examples/getting-started/04-agent-with-messaging.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: security-scanner

package/examples/getting-started/05-workflow-composition.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Workflow
 metadata:
   name: code-review-pipeline

package/examples/getting-started/hello-world-complete.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: hello-world-agent

package/examples/gitlab-agents/daily-code-scan/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:daily-code-scan:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/gitlab-agents/duo-comment-responder/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:duo-comment-responder:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/gitlab-agents/mr-reviewer/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:mr-reviewer:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/gitlab-agents/pipeline-auto-fix/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:pipeline-auto-fix:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/gitlab-agents/pre-commit-quality-check/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:pre-commit-quality-check:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/gitlab-agents/pre-push-validation/.gitlab-ci.yml

@@ -20,9 +20,9 @@ build:
 
 deploy:pre-push-validation:
   stage: deploy
-  image: docker:24
+  image: docker:27
   services:
-    - docker:24-dind
+    - docker:27-dind
   before_script:
     - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
   script:

package/examples/hierarchical-agent.ossa.yaml

@@ -12,7 +12,7 @@
 #   - Context isolation enforced for all subagents
 #   - Results flow up: subagent -> parent -> user
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: code-review-pipeline

package/examples/infrastructure/token-rotation/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: token-rotation-manager

package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: workflow-orchestrator

package/examples/kagent/compliance-validator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/kagent/cost-optimizer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: cost-optimizer

package/examples/kagent/documentation-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: documentation-agent

package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: k8s-troubleshooter

package/examples/kagent/k8s-troubleshooter.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: k8s-troubleshooter

package/examples/kagent/security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: security-scanner

package/examples/knowledge-graph/drupal-agent-with-kg.ossa.yaml

@@ -1,7 +1,7 @@
 # OSSA v0.4.1 Agent with Knowledge Graph Extension
 # Portable, configurable - works with ANY git platform, vector DB, wiki format
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 
 metadata:

package/examples/mcp/browser-puppeteer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: browser-automation-agent

package/examples/mcp/database-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: database-assistant

package/examples/mcp/filesystem-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: filesystem-assistant

package/examples/messaging/dependency-healer.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent monitors dependencies, detects outdated packages, and coordinates
 # updates while communicating with security scanners via OSSA messaging.
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: dependency-healer

package/examples/messaging/incident-responder.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent receives security incidents from multiple sources and coordinates
 # response activities across teams via OSSA messaging.
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: incident-responder

package/examples/messaging/routing-rules.ossa.yaml

@@ -4,7 +4,7 @@
 # in a multi-agent security system. It implements the routing rules
 # for the security-scanner, dependency-healer, and incident-responder agents.
 
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Workflow
 metadata:
   name: security-workflow-routing

package/examples/messaging/security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.4.7
 kind: Agent
 metadata:
   name: security-scanner