@bluefly/openstandardagents 0.2.5-RC → 0.2.7

package/website/content/docs/api-reference/unified-agent-gateway.md

@@ -0,0 +1,599 @@
+# Unified Agent Gateway
+
+**Version**: 1.0.0
+
+**Single Entry Point for All LLM Platform Agents**
+
+This gateway provides a unified OpenAPI interface for:
+- OSSA-compliant agents (validation, deployment, orchestration)
+- Drupal llm-platform (content, users, sites, data management)
+- Agent Studio (Mac/iOS/CarPlay/VSCode/IDE)
+- Agent Chat (Claude Code replacement)
+- Langflow/LangChain/K-Agent workflows
+- BuildKit (agent lifecycle management)
+- GitLab CI/CD orchestration
+
+**Architecture**:
+- Protocol: HTTP/REST + gRPC (agent-mesh)
+- Auth: API Key + JWT (GitLab SSO)
+- Registry: agent-router (service discovery)
+- Tracing: Phoenix (all requests)
+- Metrics: Prometheus
+- Storage: Drupal llm-platform (single source of truth)
+
+
+## Base URL
+
+- `https://gateway.agent-buildkit.orb.local/api/v1` - Production
+- `http://localhost:8080/api/v1` - Local development (Orbstack)
+
+## Authentication
+
+This API requires authentication. See [Authentication Guide](../authentication.md) for details.
+
+## Endpoints
+
+### Create and deploy new agent
+
+```http
+POST /agents
+```
+
+**Description**: Creates an OSSA-compliant agent and deploys to K8s via Helm.
+Registers with agent-router, starts Phoenix tracing.
+
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**201**: Agent created and deployed
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/agents" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### List all agents
+
+```http
+GET /agents
+```
+
+**Parameters**:
+
+- `undefined` (undefined) - No description
+- `undefined` (undefined) - No description
+- `undefined` (undefined) - No description
+
+**Responses**:
+
+**200**: List of agents
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/agents" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Get agent details
+
+```http
+GET /agents/{agentId}
+```
+
+**Parameters**:
+
+- `undefined` (undefined) - No description
+
+**Responses**:
+
+**200**: Agent details
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/agents/{agentId}" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Update agent
+
+```http
+PUT /agents/{agentId}
+```
+
+**Parameters**:
+
+- `undefined` (undefined) - No description
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**200**: Agent updated
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X PUT "https://api.ossa.dev/agents/{agentId}" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Delete agent
+
+```http
+DELETE /agents/{agentId}
+```
+
+**Parameters**:
+
+- `undefined` (undefined) - No description
+
+**Responses**:
+
+**204**: Agent deleted
+
+**Example**:
+
+```bash
+curl -X DELETE "https://api.ossa.dev/agents/{agentId}" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Execute agent task
+
+```http
+POST /agents/{agentId}/execute
+```
+
+**Description**: Send task to agent and get response
+
+**Parameters**:
+
+- `undefined` (undefined) - No description
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**200**: Task executed
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/agents/{agentId}/execute" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Create Drupal content
+
+```http
+POST /drupal/content
+```
+
+**Description**: Create content node via llm-platform API
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**201**: Content created
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/drupal/content" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Query Drupal content
+
+```http
+GET /drupal/content
+```
+
+**Parameters**:
+
+- `type` (query) - No description
+- `status` (query) - No description
+
+**Responses**:
+
+**200**: Content list
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/drupal/content" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Create Drupal user
+
+```http
+POST /drupal/users
+```
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**201**: User created
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/drupal/users" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### List users
+
+```http
+GET /drupal/users
+```
+
+**Responses**:
+
+**200**: User list
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/drupal/users" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Build new Drupal site
+
+```http
+POST /drupal/sites
+```
+
+**Description**: Agent creates complete Drupal site with modules/config
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**202**: Site creation started
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/drupal/sites" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Create workflow
+
+```http
+POST /workflows
+```
+
+**Description**: Create Langflow or LangChain workflow
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**201**: Workflow created
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/workflows" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### List workflows
+
+```http
+GET /workflows
+```
+
+**Parameters**:
+
+- `framework` (query) - No description
+
+**Responses**:
+
+**200**: Workflow list
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/workflows" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Execute workflow
+
+```http
+POST /workflows/{workflowId}/execute
+```
+
+**Parameters**:
+
+- `workflowId` (path, required) - No description
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**200**: Workflow executed
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/workflows/{workflowId}/execute" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Create remote coding session
+
+```http
+POST /studio/sessions
+```
+
+**Description**: Creates coding session accessible from iOS/CarPlay.
+Agent continues work when you're away from computer.
+
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**201**: Session created
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/studio/sessions" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### List active sessions
+
+```http
+GET /studio/sessions
+```
+
+**Responses**:
+
+**200**: Active sessions
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/studio/sessions" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Queue task for agent
+
+```http
+POST /studio/sessions/{sessionId}/tasks
+```
+
+**Description**: Queue coding task to run while you're mobile
+
+**Parameters**:
+
+- `sessionId` (path, required) - No description
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**202**: Task queued
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/studio/sessions/{sessionId}/tasks" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### Trigger pipeline for project
+
+```http
+POST /gitlab/pipelines
+```
+
+**Request Body**:
+
+```json
+{}
+```
+
+**Responses**:
+
+**202**: Pipeline triggered
+
+**Example**:
+
+```bash
+curl -X POST "https://api.ossa.dev/gitlab/pipelines" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d @request.json
+```
+
+### List pipelines
+
+```http
+GET /gitlab/pipelines
+```
+
+**Responses**:
+
+**200**: Pipeline list
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/gitlab/pipelines" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### List available packages
+
+```http
+GET /gitlab/packages
+```
+
+**Description**: Query package registry
+
+**Parameters**:
+
+- `scope` (query) - No description
+
+**Responses**:
+
+**200**: Package list
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/gitlab/packages" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### Discover services
+
+```http
+GET /registry/discover
+```
+
+**Description**: Query agent-router for available services/agents
+
+**Parameters**:
+
+- `capability` (query) - No description
+- `framework` (query) - No description
+
+**Responses**:
+
+**200**: Discovered services
+
+```json
+{}
+```
+
+**Example**:
+
+```bash
+curl -X GET "https://api.ossa.dev/registry/discover" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+## Related Documentation
+
+- [CLI Reference](../cli-reference/index.md)
+- [Schema Reference](../schema-reference/index.md)
+- [Authentication Guide](../authentication.md)

package/website/content/docs/cli-reference/index.md

@@ -0,0 +1,111 @@
+# CLI Reference
+
+The OSSA CLI provides commands for managing AI agents throughout their lifecycle.
+
+## Installation
+
+```bash
+npm install -g @bluefly/openstandardagents
+```
+
+## Quick Start
+
+```bash
+# Validate an agent manifest
+ossa validate agent.ossa.yaml
+
+# Generate a new agent
+ossa generate worker --name "My Agent"
+
+# Run an agent locally
+ossa run agent.ossa.yaml
+```
+
+## Commands
+
+### [ossa validate](./ossa-validate.md)
+
+Validate OSSA agent manifests against the schema
+
+### [ossa generate](./ossa-generate.md)
+
+Generate OSSA agent manifests from templates
+
+### [ossa migrate](./ossa-migrate.md)
+
+Migrate agent manifests between OSSA versions
+
+### [ossa run](./ossa-run.md)
+
+Run an OSSA agent locally
+
+### [ossa init](./ossa-init.md)
+
+Initialize a new OSSA project
+
+### [ossa setup](./ossa-setup.md)
+
+Set up OSSA development environment
+
+### [ossa export](./ossa-export.md)
+
+Export agent manifest to different formats
+
+### [ossa import](./ossa-import.md)
+
+Import agents from other frameworks
+
+### [ossa schema](./ossa-schema.md)
+
+View and manage OSSA schemas
+
+### [ossa gitlab-agent](./ossa-gitlab-agent.md)
+
+Manage GitLab agent integration
+
+### [ossa agents](./ossa-agents.md)
+
+Manage OSSA agents
+
+
+## Global Options
+
+- `--help` - Show help for any command
+- `--version` - Show OSSA CLI version
+- `--config <path>` - Path to config file
+- `--verbose` - Enable verbose logging
+- `--quiet` - Suppress output
+
+## Configuration
+
+The OSSA CLI can be configured via:
+
+1. **Config file**: `.ossarc.json` or `.ossarc.yaml`
+2. **Environment variables**: `OSSA_*`
+3. **Command-line flags**
+
+Example `.ossarc.json`:
+
+```json
+{
+  "registry": "https://registry.ossa.dev",
+  "defaultVersion": "0.2.5-RC",
+  "validation": {
+    "strict": true
+  }
+}
+```
+
+## Environment Variables
+
+- `OSSA_REGISTRY` - Agent registry URL
+- `OSSA_API_KEY` - API authentication key
+- `OSSA_VERSION` - Default OSSA version
+- `OSSA_DEBUG` - Enable debug mode
+
+## Related Documentation
+
+- [API Reference](../api-reference/index.md)
+- [Schema Reference](../schema-reference/index.md)
+- [Getting Started](../getting-started/index.md)
+- [Guides](../guides/index.md)