@bluefly/openstandardagents 0.2.4 → 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/architecture/execution-flow.md

@@ -326,9 +326,9 @@ gantt
 ## Related Documentation
 
 - [Stack Integration](stack-integration) - Where OSSA fits in your architecture
-- [Tool Integration Patterns](../Technical/Tool-Integration) - Detailed tool execution patterns
-- [Runtime Deployment](../Technical/Runtime-Deployment) - How to deploy OSSA agents
-- [Specification Deep-Dive](../Technical/Specification-Deep-Dive) - Full OSSA spec details
+- [Schema Reference](/docs/schema-reference) - Detailed tool execution patterns
+- [Specification](/docs/specification) - Full OSSA spec details
+- [Ecosystem Overview](/docs/ecosystem/overview) - Framework integrations
 
 ---
 

package/website/content/docs/architecture/multi-agent-systems.md

@@ -330,7 +330,7 @@ spec:
 POST /api/agents/sales-agent/tasks
 Content-Type: application/json
 X-OSSA-Agent: customer-agent
-X-OSSA-Version: v0.2.2
+X-OSSA-Version: v0.2.x
 
 {
   "task": "create_order",
@@ -729,9 +729,9 @@ graph TB
 
 - [Execution Flow](execution-flow) - How individual agents process requests
 - [Stack Integration](stack-integration) - Where multi-agent systems fit
-- [Integration Patterns](../Examples/Integration-Patterns) - Real-world patterns
-- [Specification Deep-Dive](../Technical/Specification-Deep-Dive) - OSSA spec details
+- [Ecosystem Overview](/docs/ecosystem/overview) - Real-world patterns
+- [Specification](/docs/specification) - OSSA spec details
 
 ---
 
-**Next Steps**: Explore [Integration Patterns](../Examples/Integration-Patterns) for real-world multi-agent examples
+**Next Steps**: Explore [Ecosystem Overview](/docs/ecosystem/overview) for real-world multi-agent examples

package/website/content/docs/architecture/overview.md

@@ -103,10 +103,10 @@ Deploy OSSA agents anywhere:
 
 ## Related Documentation
 
-- [Specification Deep-Dive](../Technical/Specification-Deep-Dive) - Technical details of the OSSA spec
-- [Runtime Deployment](../Technical/Runtime-Deployment) - Deployment patterns and guides
-- [Tool Integration](../Technical/Tool-Integration) - Connecting external tools to agents
-- [Integration Patterns](../Examples/Integration-Patterns) - Real-world integration examples
+- [Specification](/docs/specification) - Technical details of the OSSA spec
+- [Schema Reference](/docs/schema-reference) - Complete schema documentation
+- [Ecosystem Overview](/docs/ecosystem/overview) - Framework integrations
+- [Migration Guides](/docs/migration-guides/langchain-to-ossa) - Real-world migration examples
 
 ---
 

package/website/content/docs/architecture/stack-integration.md

@@ -29,7 +29,7 @@ graph TB
 
     subgraph "OSSA Specification Layer"
         Manifest[OSSA Manifests<br/>agent.ossa.yaml]
-        Schema[JSON Schema<br/>v0.2.2]
+        Schema[JSON Schema<br/>v0.2.x]
         CLI_Tool[OSSA CLI<br/>Validation]
         Registry[Agent Registry]
     end
@@ -144,7 +144,7 @@ response = agent.run(user_message="Hello")
 
 **Components:**
 - **OSSA Manifests**: YAML/JSON files defining agents
-- **JSON Schema**: Validation schema (v0.2.2)
+- **JSON Schema**: Validation schema (v0.2.x)
 - **OSSA CLI**: Validation and generation tools
 - **Agent Registry**: Discovery and versioning
 
@@ -452,8 +452,8 @@ Change any layer without affecting others:
 ## Related Documentation
 
 - [Execution Flow](execution-flow) - How requests flow through OSSA agents
-- [Runtime Deployment](../Technical/Runtime-Deployment) - Deployment guides
-- [Integration Patterns](../Examples/Integration-Patterns) - Real-world examples
+- [Specification](/docs/specification) - Deployment guides
+- [Ecosystem Overview](/docs/ecosystem/overview) - Real-world examples
 - [Multi-Agent Systems](multi-agent-systems) - Agent-to-agent communication
 
 ---

package/website/content/docs/changelog.md

@@ -24,7 +24,7 @@ This release represents a complete transformation of OSSA into an enterprise-gra
 - **Getting Started Guide** - Clear, technical quick-start documentation
 
 ### Changed
-- **Package Name Standardized** - Now `@bluefly/openstandardagents` (consistent with npm)
+- **Package Name Standardized** - Now `@bluefly/open-standards-scalable-agents` (consistent with npm)
 - **Version Unified to 1.0.0** - Aligned package.json, schema, and documentation versions
 - **Dependencies Minimized** - Reduced from 8 to 4 deps, removed runtime services (qdrant, redis, pg, zod)
   - **Before**: 12MB+ with runtime dependencies
@@ -81,10 +81,10 @@ This release represents a complete transformation of OSSA into an enterprise-gra
 **For npm users**:
 ```bash
 # Old (not published)
-npm install -g @bluefly/openstandardagents
+npm install -g @ossa/standard
 
 # New (v1.0.0+)
-npm install -g @bluefly/openstandardagents
+npm install -g @bluefly/open-standards-scalable-agents
 ```
 
 **For developers**:
@@ -93,7 +93,7 @@ npm install -g @bluefly/openstandardagents
 - Examples unchanged (`examples/`)
 
 **For documentation**:
-- Comprehensive guides → GitLab Wiki (https://github.com/blueflyio/openstandardagents/wiki)
+- Comprehensive guides → GitLab Wiki (https://github.com/blueflyio/openstandardagents/wiki/home)
 - Core specification docs → `docs/` directory
 - API documentation → GitLab Pages (automated)