@bluefly/openstandardagents 0.4.8 → 0.4.9

package/spec/v0.5/extensions/cognition/thought-node.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/extensions/cognition/thought-node.schema.json",
+  "title": "OSSA ThoughtNode (v0.5.0 draft)",
+  "description": "Single node in a reasoning thought graph. Used by agent-brain and agent-tracer for persistence and analytics.",
+  "type": "object",
+  "required": ["id", "content", "thought_number", "timestamp"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique node identifier"
+    },
+    "agent_gaid": {
+      "type": "string",
+      "description": "Agent GAID (e.g. did:ossa:<uuid>)"
+    },
+    "session_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Session or run identifier"
+    },
+    "thought_number": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Ordinal step in the reasoning chain"
+    },
+    "content": {
+      "type": "string",
+      "description": "Thought step content"
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Confidence score for this step"
+    },
+    "parent": {
+      "type": ["string", "null"],
+      "format": "uuid",
+      "description": "Previous thought node id"
+    },
+    "branches": {
+      "type": "array",
+      "items": { "type": "string", "format": "uuid" },
+      "description": "Alternative paths explored from this node"
+    },
+    "revision_of": {
+      "type": ["string", "null"],
+      "format": "uuid",
+      "description": "If this step revises a prior thought"
+    },
+    "tools_invoked": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Tools called during this thought step"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO8601 timestamp"
+    },
+    "duration_ms": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Duration of this step in milliseconds"
+    },
+    "token_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Tokens consumed for this step"
+    },
+    "governance_triggers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Which governance triggers fired, if any"
+    }
+  },
+  "additionalProperties": false
+}

package/spec/v0.5/extensions/crewai/crewai.schema.json

@@ -0,0 +1,256 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4.6/extensions/crewai/crewai.json",
+  "title": "CrewAI Extension",
+  "description": "Native integration with CrewAI framework for role-based multi-agent collaboration with sequential and hierarchical processes.",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable CrewAI integration"
+    },
+    "crew": {
+      "$ref": "#/definitions/CrewConfig",
+      "description": "Crew configuration"
+    },
+    "agent": {
+      "$ref": "#/definitions/AgentConfig",
+      "description": "Agent-specific configuration"
+    },
+    "task": {
+      "$ref": "#/definitions/TaskConfig",
+      "description": "Task configuration"
+    },
+    "process": {
+      "type": "string",
+      "enum": ["sequential", "hierarchical"],
+      "default": "sequential",
+      "description": "Crew process type"
+    },
+    "manager_llm": {
+      "type": "object",
+      "description": "Manager LLM configuration for hierarchical process"
+    },
+    "memory": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable crew memory"
+    },
+    "cache": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable tool result caching"
+    },
+    "max_rpm": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum requests per minute"
+    },
+    "verbose": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 2,
+      "default": 0,
+      "description": "Verbosity level (0=silent, 1=normal, 2=debug)"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "CrewConfig": {
+      "type": "object",
+      "description": "Crew configuration",
+      "required": ["agents", "tasks"],
+      "properties": {
+        "agents": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "pattern": "^@[a-z0-9-]+$"
+          },
+          "description": "Agent IDs in the crew"
+        },
+        "tasks": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/CrewTask"
+          },
+          "description": "Tasks for the crew"
+        },
+        "process": {
+          "type": "string",
+          "enum": ["sequential", "hierarchical"],
+          "default": "sequential",
+          "description": "Task execution process"
+        },
+        "manager_agent": {
+          "type": "string",
+          "pattern": "^@[a-z0-9-]+$",
+          "description": "Manager agent ID (for hierarchical process)"
+        },
+        "function_calling_llm": {
+          "type": "object",
+          "description": "LLM for function calling"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Additional crew configuration"
+        }
+      },
+      "additionalProperties": false
+    },
+    "AgentConfig": {
+      "type": "object",
+      "description": "CrewAI agent configuration",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Agent role (e.g., 'Senior Developer', 'Content Writer')"
+        },
+        "goal": {
+          "type": "string",
+          "description": "Agent goal"
+        },
+        "backstory": {
+          "type": "string",
+          "description": "Agent backstory providing context"
+        },
+        "allow_delegation": {
+          "type": "boolean",
+          "default": true,
+          "description": "Allow agent to delegate tasks"
+        },
+        "verbose": {
+          "type": "boolean",
+          "default": false,
+          "description": "Verbose logging for agent"
+        },
+        "max_iter": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 15,
+          "description": "Maximum iterations for task completion"
+        },
+        "max_rpm": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum requests per minute"
+        },
+        "max_execution_time": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum execution time in seconds"
+        },
+        "step_callback": {
+          "type": "string",
+          "description": "Step callback function"
+        }
+      },
+      "additionalProperties": false
+    },
+    "TaskConfig": {
+      "type": "object",
+      "description": "CrewAI task configuration",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Task description"
+        },
+        "expected_output": {
+          "type": "string",
+          "description": "Expected output format/content"
+        },
+        "agent": {
+          "type": "string",
+          "pattern": "^@[a-z0-9-]+$",
+          "description": "Agent ID assigned to task"
+        },
+        "async_execution": {
+          "type": "boolean",
+          "default": false,
+          "description": "Execute task asynchronously"
+        },
+        "context": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Context task IDs"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Additional task configuration"
+        },
+        "output_file": {
+          "type": "string",
+          "description": "Output file path"
+        },
+        "output_json": {
+          "type": "object",
+          "description": "JSON schema for output"
+        },
+        "output_pydantic": {
+          "type": "string",
+          "description": "Pydantic model for output"
+        },
+        "callback": {
+          "type": "string",
+          "description": "Task completion callback"
+        }
+      },
+      "additionalProperties": false
+    },
+    "CrewTask": {
+      "type": "object",
+      "description": "Crew task definition",
+      "required": ["id", "description", "agent"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Task identifier"
+        },
+        "description": {
+          "type": "string",
+          "description": "Task description"
+        },
+        "expected_output": {
+          "type": "string",
+          "description": "Expected output"
+        },
+        "agent": {
+          "type": "string",
+          "pattern": "^@[a-z0-9-]+$",
+          "description": "Assigned agent ID"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Tools available for task"
+        },
+        "async_execution": {
+          "type": "boolean",
+          "default": false,
+          "description": "Execute asynchronously"
+        },
+        "context": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Context task IDs"
+        },
+        "output_file": {
+          "type": "string",
+          "description": "Output file path"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/spec/v0.5/extensions/drupal/drupal.schema.json

@@ -0,0 +1,318 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4/extensions/drupal/drupal.json",
+  "title": "Drupal Extension Schema",
+  "description": "Drupal CMS integration extension for OSSA agents. Maps OSSA manifests to Drupal's ai_agents module, Tool API, and ECA event system.",
+  "type": "object",
+  "properties": {
+    "ai_agent_plugin": {
+      "type": "string",
+      "description": "Plugin ID for the Drupal ai_agents module (e.g. 'ossa_agent')",
+      "default": "ossa_agent"
+    },
+    "tools": {
+      "type": "array",
+      "description": "Drupal Tool API plugin IDs to grant this agent (e.g. 'tool:read:content_load')",
+      "items": {
+        "type": "string",
+        "pattern": "^tool:[a-z_]+:[a-z_]+$"
+      },
+      "uniqueItems": true,
+      "examples": [
+        "tool:read:content_load",
+        "tool:explain:code_review",
+        "tool:create:content_create"
+      ]
+    },
+    "eca_events": {
+      "type": "array",
+      "description": "ECA (Event-Condition-Action) events this agent reacts to",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "examples": [
+        "entity:node:presave",
+        "entity:node:insert",
+        "cron"
+      ]
+    },
+    "permissions": {
+      "type": "array",
+      "description": "Drupal permissions required for this agent to operate",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "examples": [
+        "access content",
+        "edit any article content",
+        "administer nodes"
+      ]
+    },
+    "content_types": {
+      "type": "array",
+      "description": "Drupal content types this agent operates on",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$"
+      },
+      "uniqueItems": true,
+      "examples": [
+        "article",
+        "page",
+        "blog_post"
+      ]
+    },
+    "views_displays": {
+      "type": "array",
+      "description": "Views displays to expose agent data",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true
+    },
+    "execution_model": {
+      "type": "string",
+      "description": "How the agent is executed within Drupal. 'eca' uses Event-Condition-Action rules, 'ai-agent-runner' uses the ai_agents module runner, 'queue' defers to Drupal's queue system, 'direct' invokes synchronously.",
+      "enum": ["eca", "ai-agent-runner", "queue", "direct"],
+      "default": "ai-agent-runner"
+    },
+    "drupal_version": {
+      "type": "string",
+      "description": "Drupal core version constraint using Composer semver syntax (e.g. '^11' or '^11 || ^12')",
+      "examples": ["^11", "^11 || ^12", "^10 || ^11"]
+    },
+    "php_version": {
+      "type": "string",
+      "description": "Minimum PHP version required by this agent's Drupal integration",
+      "examples": ["8.3", "8.2", "8.4"]
+    },
+    "module_dependencies": {
+      "type": "array",
+      "description": "Drupal contributed or core module machine names required for this agent to function",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$"
+      },
+      "uniqueItems": true,
+      "examples": [
+        ["ai", "ai_agents", "eca", "tool"]
+      ]
+    },
+    "tool_plugins": {
+      "type": "array",
+      "description": "Maps OSSA tool definitions to Drupal Tool API plugins. Each entry defines a Drupal tool plugin that wraps an OSSA tool reference, specifying the CRUD operation, input/output schemas, and whether the tool is callable by AI agents.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Drupal Tool API plugin ID (e.g. 'ossa_content_load')",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "ossa_tool_ref": {
+            "type": "string",
+            "description": "Reference to the OSSA tool definition in the agent manifest (e.g. 'tools/content_load' or a fully-qualified OSSA tool URI)"
+          },
+          "operation": {
+            "type": "string",
+            "description": "The CRUD operation category this tool performs, aligning with Drupal's Tool API operation types",
+            "enum": ["read", "create", "update", "delete", "explain"]
+          },
+          "input_schema": {
+            "type": "object",
+            "description": "JSON Schema defining the input parameters accepted by this tool plugin. Used by the Drupal Tool API for validation and by AI agents for parameter discovery."
+          },
+          "output_schema": {
+            "type": "object",
+            "description": "JSON Schema defining the output structure returned by this tool plugin. Used by the Drupal Tool API for response validation and by AI agents for result parsing."
+          },
+          "ai_callable": {
+            "type": "boolean",
+            "description": "Whether this tool can be invoked directly by AI agents via the Drupal AI module. When false, the tool is only available programmatically.",
+            "default": true
+          }
+        },
+        "required": ["id", "ossa_tool_ref", "operation"],
+        "additionalProperties": false
+      }
+    },
+    "actions": {
+      "type": "array",
+      "description": "Drupal Action plugin IDs provided or consumed by this agent (e.g. ECA actions, core actions)",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "examples": [
+        ["ossa_invoke_agent", "node_publish_action", "eca_send_email"]
+      ]
+    },
+    "conditions": {
+      "type": "array",
+      "description": "Drupal Condition plugin IDs evaluated by this agent's ECA rules or access control",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "examples": [
+        ["entity_bundle:node", "user_role", "request_path"]
+      ]
+    },
+    "queue_workers": {
+      "type": "array",
+      "description": "Drupal queue worker definitions for deferred or batch agent processing. Each worker processes items from a named queue on cron.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Queue worker plugin ID (e.g. 'ossa_agent_task_queue')",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable title for this queue worker"
+          },
+          "cron_time": {
+            "type": "integer",
+            "description": "Maximum number of seconds this queue worker may run per cron invocation",
+            "minimum": 1,
+            "default": 60
+          }
+        },
+        "required": ["id", "title"],
+        "additionalProperties": false
+      }
+    },
+    "blocks": {
+      "type": "array",
+      "description": "Drupal Block plugin IDs provided by this agent for placement in page layouts and regions",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "examples": [
+        ["ossa_agent_status_block", "ossa_agent_chat_block"]
+      ]
+    },
+    "recipes": {
+      "type": "array",
+      "description": "Drupal recipes bundled with this agent. Recipes provide reusable configuration packages that can be applied to install content types, views, permissions, and module configuration in one step.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Machine name of the recipe (e.g. 'ossa_content_moderator_setup')"
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of what this recipe configures"
+          },
+          "type": {
+            "type": "string",
+            "description": "Recipe type category (e.g. 'content-type', 'site-setup', 'workflow', 'agent-config')"
+          },
+          "install": {
+            "type": "array",
+            "description": "List of module machine names or recipe names to install as part of this recipe",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true
+          }
+        },
+        "required": ["name", "description"],
+        "additionalProperties": false
+      }
+    },
+    "hooks": {
+      "type": "array",
+      "description": "Drupal hook implementations provided by this agent's module. In Drupal 11+, hooks are implemented as class methods using the #[Hook] attribute.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "hook_name": {
+            "type": "string",
+            "description": "The hook name without the 'hook_' prefix (e.g. 'cron', 'entity_presave', 'install')"
+          },
+          "class_name": {
+            "type": "string",
+            "description": "Fully-qualified PHP class name implementing this hook (e.g. 'Drupal\\ossa_agent\\Hook\\EntityHooks')"
+          },
+          "method": {
+            "type": "string",
+            "description": "Method name on the class that implements this hook"
+          }
+        },
+        "required": ["hook_name", "class_name", "method"],
+        "additionalProperties": false
+      }
+    },
+    "event_subscribers": {
+      "type": "array",
+      "description": "Symfony event subscribers registered by this agent's module. Used for reacting to kernel, entity, and custom events in Drupal's event-driven architecture.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "Fully-qualified event class name or event constant (e.g. 'Drupal\\core\\Entity\\EntityEvents::PRESAVE' or 'kernel.request')"
+          },
+          "method": {
+            "type": "string",
+            "description": "Method name on the subscriber class that handles this event"
+          },
+          "priority": {
+            "type": "integer",
+            "description": "Subscriber priority. Higher values mean earlier execution. Defaults to 0.",
+            "default": 0
+          }
+        },
+        "required": ["event", "method"],
+        "additionalProperties": false
+      }
+    },
+    "config_entities": {
+      "type": "array",
+      "description": "Custom configuration entity types defined by this agent's module. Config entities store structured settings in Drupal's configuration management system.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Config entity type machine name (e.g. 'ossa_agent_config')",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "label": {
+            "type": "string",
+            "description": "Human-readable label for this config entity type"
+          },
+          "properties": {
+            "type": "object",
+            "description": "JSON Schema-style property definitions for this config entity's fields. Keys are property names, values are objects with 'type' and 'description'.",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "description": "Data type of this property (e.g. 'string', 'integer', 'boolean', 'array')"
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Human-readable description of this config property"
+                }
+              },
+              "required": ["type"]
+            }
+          }
+        },
+        "required": ["id", "label"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}