@bluefly/openstandardagents 0.5.0 → 0.5.3

package/examples/drupal/QUICKSTART.md

@@ -1,453 +0,0 @@
-# Drupal Module Generator - Quick Start Guide
-
-Generate a complete, production-ready Drupal module from an OSSA agent manifest in seconds.
-
-## TL;DR
-
-```bash
-# 1. Generate module
-buildkit export agent.ossa.yaml -p drupal
-
-# 2. Install
-cp -r module_name /path/to/drupal/web/modules/custom/
-cd /path/to/drupal
-composer require ossa/symfony-bundle
-drush en module_name
-
-# 3. Configure
-export ANTHROPIC_API_KEY="sk-ant-..."
-drush cr
-
-# 4. Test
-drush ossa:agent:execute module-name "Test input"
-```
-
-## Step-by-Step
-
-### 1. Create Your Agent Manifest
-
-Create `creative-agent-naming.ossa.yaml`:
-
-```yaml
-apiVersion: ossa/v0.4.5
-kind: Agent
-metadata:
-  name: my_agent
-  version: 1.0.0
-  description: My AI agent for Drupal
-
-spec:
-  role: "You are a helpful assistant"
-
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4-20250514
-    temperature: 0.7
-    maxTokens: 2048
-
-  tools:
-    - type: api
-      name: my_tool
-      description: My custom tool
-
-  capabilities:
-    - capability-1
-    - capability-2
-```
-
-### 2. Generate Drupal Module
-
-```bash
-buildkit export creative-agent-naming.ossa.yaml -p drupal
-```
-
-This creates a complete Drupal module in `./my_agent/` with:
-- 15+ generated files
-- Full DI configuration
-- Queue worker for async execution
-- Entity storage
-- Admin UI
-- REST API endpoints
-- Configuration forms
-- Documentation
-
-### 3. Install Module
-
-```bash
-# Copy to Drupal
-cp -r my_agent /path/to/drupal/web/modules/custom/
-
-# Install symfony-bundle dependency
-cd /path/to/drupal
-composer require ossa/symfony-bundle
-
-# Enable module
-drush en my_agent
-```
-
-### 4. Configure API Keys
-
-**Option A: Environment Variables (Recommended)**
-
-```bash
-export ANTHROPIC_API_KEY="sk-ant-..."
-export OPENAI_API_KEY="sk-..."
-export GOOGLE_API_KEY="..."
-```
-
-**Option B: settings.php**
-
-Add to `sites/default/settings.php`:
-
-```php
-$config['ossa']['providers']['anthropic']['api_key'] = getenv('ANTHROPIC_API_KEY');
-$config['ossa']['providers']['openai']['api_key'] = getenv('OPENAI_API_KEY');
-```
-
-### 5. Configure Module
-
-Visit: `/admin/config/my_agent`
-
-- Select LLM provider
-- Choose model
-- Set temperature
-- Configure auto-execution (optional)
-
-### 6. Execute Agent
-
-**Via Admin UI**: `/admin/my_agent/execute`
-
-**Via Drush**:
-```bash
-drush ossa:agent:execute creative-agent-naming "Hello, agent!"
-```
-
-**Via REST API**:
-```bash
-curl -X POST http://localhost/api/my_agent/execute \
-  -H "Content-Type: application/json" \
-  -d '{"input": "Hello, agent!"}'
-```
-
-**Via PHP**:
-```php
-$agent = \Drupal::service('my_agent.agent_executor');
-$result = $agent->execute('Hello, agent!');
-print_r($result);
-```
-
-### 7. View Results
-
-**Via UI**: `/admin/my_agent/results`
-
-**Via Drush**:
-```bash
-drush sqlq "SELECT * FROM my_agent_result"
-```
-
-**Via Views**: Create custom Views using the `my_agent_result` entity type
-
-## Example: Content Moderator
-
-We've included a complete example. Try it:
-
-```bash
-# Generate from example
-buildkit export examples/drupal/content-moderator.ossa.yaml -p drupal
-
-# Install
-cp -r content_moderator /path/to/drupal/web/modules/custom/
-cd /path/to/drupal
-composer require ossa/symfony-bundle
-drush en content_moderator
-
-# Configure
-export ANTHROPIC_API_KEY="sk-ant-..."
-drush cr
-
-# Test
-drush ossa:agent:execute content-moderator "Check this spam content: BUY NOW!"
-```
-
-## Common Use Cases
-
-### 1. Content Moderation
-
-```yaml
-apiVersion: ossa/v0.4.5
-kind: Agent
-metadata:
-  name: content_moderator
-spec:
-  role: "Review content for spam and policy violations"
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4-20250514
-```
-
-**Use**: Auto-moderate user comments on entity save
-
-### 2. Content Generation
-
-```yaml
-apiVersion: ossa/v0.4.5
-kind: Agent
-metadata:
-  name: content_generator
-spec:
-  role: "Generate SEO-optimized blog posts"
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4-20250514
-    temperature: 0.8
-```
-
-**Use**: Generate article drafts from keywords
-
-### 3. Customer Support
-
-```yaml
-apiVersion: ossa/v0.4.5
-kind: Agent
-metadata:
-  name: support_bot
-spec:
-  role: "Answer customer support questions"
-  llm:
-    provider: anthropic
-    model: claude-sonnet-4-20250514
-```
-
-**Use**: Chatbot for support tickets
-
-### 4. Data Analysis
-
-```yaml
-apiVersion: ossa/v0.4.5
-kind: Agent
-metadata:
-  name: data_analyst
-spec:
-  role: "Analyze data and generate insights"
-  llm:
-    provider: openai
-    model: gpt-4-turbo
-    temperature: 0.2
-```
-
-**Use**: Generate reports from Drupal data
-
-## Advanced Features
-
-### Auto-Execute on Entity Save
-
-Enable in module config (`/admin/config/MODULE`):
-
-1. Check "Auto-execute on entity save"
-2. Select entity types (node, comment, user)
-3. Save
-
-Now the agent runs automatically when entities are saved.
-
-### Async Queue Processing
-
-Queue items for background processing:
-
-```php
-$agent = \Drupal::service('my_agent.agent_executor');
-$queue_id = $agent->executeAsync('Long running task', $context);
-```
-
-Process queue:
-```bash
-drush cron  # Automatic
-drush queue:run my_agent_agent_queue  # Manual
-```
-
-### Custom Hooks
-
-Modify agent behavior:
-
-```php
-/**
- * Implements hook_ossa_agent_execute().
- */
-function my_module_ossa_agent_execute($agent_name, $input, &$context) {
-  // Add custom context
-  $context['custom_data'] = 'value';
-}
-
-/**
- * Implements hook_ossa_agent_response_alter().
- */
-function my_module_ossa_agent_response_alter(&$response, $agent_name) {
-  // Modify response
-  $response['custom_field'] = 'value';
-}
-```
-
-## Troubleshooting
-
-### "Missing API key"
-
-**Fix**: Set environment variable or settings.php
-
-```bash
-export ANTHROPIC_API_KEY="sk-ant-..."
-drush cr
-```
-
-### "Agent not found"
-
-**Fix**: Clear cache
-
-```bash
-drush cr
-```
-
-### "Permission denied"
-
-**Fix**: Grant permissions at `/admin/people/permissions`
-
-- Check "Administer MODULE"
-- Check "Access content"
-
-### "Queue not processing"
-
-**Fix**: Run cron
-
-```bash
-drush cron
-```
-
-## Generator Options
-
-### Basic
-
-```bash
-buildkit export agent.ossa.yaml -p drupal
-```
-
-### With Options
-
-```bash
-# Specify output directory
-buildkit export agent.ossa.yaml -p drupal -o ./custom-dir
-
-# Dry run (preview only)
-buildkit export agent.ossa.yaml -p drupal --dry-run
-
-# Verbose output
-buildkit export agent.ossa.yaml -p drupal --verbose
-
-# Skip validation
-buildkit export agent.ossa.yaml -p drupal --no-validate
-```
-
-## What Gets Generated
-
-```
-my_agent/
-├── my_agent.info.yml              # Module metadata
-├── my_agent.services.yml          # DI configuration
-├── my_agent.module                # Drupal hooks
-├── my_agent.routing.yml           # Routes
-├── my_agent.links.menu.yml        # Menu links
-├── my_agent.views.inc             # Views integration
-├── composer.json                  # Dependencies
-├── README.md                      # Documentation
-├── INSTALL.md                     # Install guide
-│
-├── src/
-│   ├── Service/
-│   │   └── AgentExecutorService.php
-│   ├── Plugin/QueueWorker/
-│   │   └── AgentQueueWorker.php
-│   ├── Entity/
-│   │   ├── AgentResult.php
-│   │   └── AgentResultInterface.php
-│   ├── Controller/
-│   │   └── AgentController.php
-│   └── Form/
-│       └── AgentConfigForm.php
-│
-├── config/
-│   ├── schema/my_agent.schema.yml
-│   ├── install/my_agent.settings.yml
-│   └── ossa/agent.ossa.yaml
-│
-└── templates/
-    ├── agent-result.html.twig
-    └── agent-execute-form.html.twig
-```
-
-## Architecture
-
-```
-User Input
-    ↓
-AgentController (Drupal UI/API)
-    ↓
-AgentExecutorService (Drupal wrapper)
-    ↓
-AgentExecutor (ossa/symfony-bundle)
-    ↓
-LLM Provider (Anthropic/OpenAI/etc)
-    ↓
-Response → Entity Storage → Views
-```
-
-## Integration Points
-
-- ✅ **Drupal Entity API**: Store results as entities
-- ✅ **Drupal Queue API**: Async processing
-- ✅ **Drupal Form API**: Config forms
-- ✅ **Drupal Hook System**: Customization
-- ✅ **Drupal Views**: Browse results
-- ✅ **REST API**: External integration
-- ✅ **Drush**: CLI commands
-- ✅ **Symfony DI**: Service injection
-
-## Requirements
-
-- **Drupal**: 10.x or 11.x
-- **PHP**: 8.2 or higher
-- **Composer**: Latest version
-- **API Key**: Anthropic, OpenAI, Google, or Azure
-
-## Support
-
-- **Documentation**: [Full Guide](../../docs/adapters/drupal-module-generator.md)
-- **Example**: [content-moderator.ossa.yaml](./content-moderator.ossa.yaml)
-- **Issues**: https://gitlab.com/blueflyio/ossa/openstandardagents/-/issues
-- **OSSA Spec**: https://openstandardagents.org/
-
-## Example: AgentScope ReAct Assistant
-
-A complete Drupal module integrating [AgentScope](https://github.com/modelscope/agentscope) ReAct agents:
-
-```bash
-# Copy to Drupal
-cp -r examples/drupal/ai_agents_agentscope /path/to/drupal/web/modules/custom/
-drush en ai_agents_agentscope
-drush cr
-```
-
-See [`ai_agents_agentscope/README.md`](./ai_agents_agentscope/README.md) for details.
-
-## Next Steps
-
-1. Read the [full documentation](../../docs/adapters/drupal-module-generator.md)
-2. Try the [content moderator example](./content-moderator.ossa.yaml)
-3. Try the [AgentScope example](./ai_agents_agentscope/)
-4. Create your own agent manifests
-5. Generate and deploy modules
-6. Share your agents with the community
-
----
-
-**Ready to build AI-powered Drupal modules?** Start with our example:
-
-```bash
-buildkit export examples/drupal/content-moderator.ossa.yaml -p drupal
-```

package/examples/drupal/ai_agents_agentscope/README.md

@@ -1,62 +0,0 @@
-# AI Agents: AgentScope Provider
-
-Thin AiProvider bridge that connects Drupal's `drupal/ai` system to an [AgentScope](https://github.com/modelscope/agentscope) Python HTTP runtime.
-
-## What This Module Does
-
-Provides **one thing**: an `AiProvider` plugin (`agentscope`) that speaks AgentScope's REST API.
-
-Everything else is handled by contrib:
-- **Agent plugin derivation** -- `ai_agents_ossa` (reads OSSA manifests, creates AiAgent plugins)
-- **Tool registration** -- `drupal/ai` Tool API
-- **Manifest management** -- `ai_agents_ossa` config entities
-
-## Requirements
-
-- Drupal 10.4+ or 11.x
-- PHP 8.3+
-- `drupal/ai` module (provides AiProvider plugin system)
-- `ai_agents_ossa` module (OSSA manifest bridge)
-- AgentScope Python runtime running as HTTP service
-
-## Installation
-
-```bash
-drush en ai_agents_agentscope
-drush cr
-```
-
-## Configuration
-
-Settings at `ai_agents_agentscope.settings`:
-
-| Setting | Default | Description |
-|---------|---------|-------------|
-| `endpoint` | `http://127.0.0.1:12310` | AgentScope HTTP API URL |
-| `timeout` | `60` | Request timeout (seconds) |
-| `api_key` | `` | Optional API key for runtime auth |
-
-## AgentScope Runtime
-
-```bash
-pip install agentscope
-agentscope serve --port 12310
-```
-
-## Architecture
-
-```
-ai_agents_ossa (config entity + deriver + agent plugin)
-    |
-    v
-AgentScopeProvider (THIS MODULE -- AiProvider, HTTP transport only)
-    |
-    v
-AgentScope Python Runtime (POST /api/v1/agent/message)
-```
-
-## Links
-
-- [AgentScope](https://github.com/modelscope/agentscope)
-- [OSSA Specification](https://openstandardagents.org/)
-- [Drupal AI Module](https://www.drupal.org/project/ai)

package/examples/drupal/ai_agents_agentscope/ai_agents_agentscope.info.yml

@@ -1,13 +0,0 @@
-name: 'AI Agents: AgentScope Provider'
-type: module
-description: 'Thin AiProvider bridge to AgentScope Python HTTP runtime. Agent plugins are handled by ai_agents_ossa.'
-core_version_requirement: ^10.4 || ^11
-package: AI
-php: 8.3
-
-dependencies:
-  - drupal:ai
-  - ai_agents_ossa:ai_agents_ossa
-
-lifecycle: experimental
-configure: ai_agents_agentscope.settings

package/examples/drupal/ai_agents_agentscope/ai_agents_agentscope.services.yml

@@ -1,4 +0,0 @@
-services:
-  logger.channel.ai_agents_agentscope:
-    parent: logger.channel_base
-    arguments: ['ai_agents_agentscope']

package/examples/drupal/ai_agents_agentscope/config/install/ai_agents_agentscope.settings.yml

@@ -1,3 +0,0 @@
-endpoint: 'http://127.0.0.1:12310'
-timeout: 60
-api_key: ''

package/examples/drupal/ai_agents_agentscope/config/schema/ai_agents_agentscope.schema.yml

@@ -1,14 +0,0 @@
-ai_agents_agentscope.settings:
-  type: config_object
-  label: 'AI Agents AgentScope settings'
-  mapping:
-    endpoint:
-      type: string
-      label: 'AgentScope HTTP endpoint'
-      description: 'URL of the AgentScope Python runtime API.'
-    timeout:
-      type: integer
-      label: 'Request timeout in seconds'
-    api_key:
-      type: string
-      label: 'API key for AgentScope runtime (optional)'

package/examples/drupal/ai_agents_agentscope/src/AgentScopeRuntime.php

@@ -1,11 +0,0 @@
-<?php
-
-/**
- * @file
- * DELETED — This file is no longer needed.
- *
- * Runtime HTTP communication is now handled directly by
- * AgentScopeProvider (src/Plugin/AiProvider/AgentScopeProvider.php)
- * which extends AiProviderClientBase and uses its built-in httpClient.
- * Remove this file.
- */

package/examples/drupal/ai_agents_agentscope/src/Plugin/AiAgent/AgentScopeAgent.php

@@ -1,10 +0,0 @@
-<?php
-
-/**
- * @file
- * DELETED — This file is no longer needed.
- *
- * The ai_agents_ossa module provides OssaAgentPlugin which handles all agent
- * plugin functionality. This module only needs to provide an AiProvider.
- * Remove this file.
- */