@bluefly/openstandardagents 0.4.9 → 0.5.1

package/examples/agentscope/react-assistant/agent.ossa.yaml

@@ -1,10 +1,10 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: agentscope-react-assistant
-  namespace: bluefly/examples
-  version: "1.0.0"
-  description: "Example ReAct agent powered by AgentScope runtime with MCP tool integration, A2A protocol support, and Mem0 long-term memory."
+  namespace: bluefly-examples
+  version: 1.0.0
+  description: Example ReAct agent powered by AgentScope runtime with MCP tool integration, A2A protocol support, and Mem0 long-term memory.
   agentType: agentscope
   agentKind: assistant
   status: active
@@ -14,17 +14,14 @@ metadata:
     framework: agentscope
   identity:
     agent_id: agentscope-react-assistant
-    namespace: bluefly/examples
-    version: "1.0.0"
+    namespace: bluefly-examples
+    version: 1.0.0
     publisher:
       name: BlueFly Collective
       website: https://bluefly.io
-
 spec:
-  role: >
-    You are a helpful assistant that uses tools to answer questions accurately.
-    Always verify information before responding. Use available MCP tools for
-    real-time data retrieval and knowledge base queries.
+  role: |
+    You are a helpful assistant that uses tools to answer questions accurately. Always verify information before responding. Use available MCP tools for real-time data retrieval and knowledge base queries.
   llm:
     provider: anthropic
     model: claude-sonnet-4-20250514
@@ -38,19 +35,20 @@ spec:
   tools:
     - type: mcp
       name: knowledge-base
-      endpoint: https://gkg.blueflyagents.com/mcp/sse
-      description: "Graph knowledge base for codebase analysis"
+      endpoint: https://gkg.bluefly.internal/mcp/sse
+      description: Graph knowledge base for codebase analysis
     - type: mcp
       name: web-search
       endpoint: https://mcp.blueflyagents.com/api/mcp/sse
-      description: "Web search and content retrieval"
+      description: Web search and content retrieval
   inputs:
     type: object
     properties:
       query:
         type: string
-        description: "User query or task"
-    required: [query]
+        description: User query or task
+    required:
+      - query
   outputs:
     type: object
     properties:
@@ -60,23 +58,26 @@ spec:
         type: integer
       confidence:
         type: number
-
 security:
   tier: tier_1_read
   capabilities:
-    required: [network-outbound, tool-execution]
-    optional: [memory-extended]
+    required:
+      - network-outbound
+      - tool-execution
+    optional:
+      - memory-extended
   network_access:
     allowed_domains:
-      - "*.blueflyagents.com"
-      - "api.anthropic.com"
-    protocols: [https, wss]
+      - '*.blueflyagents.com'
+      - api.anthropic.com
+    protocols:
+      - https
+      - wss
     egress_policy: allow-list
   data_classification: internal
-
 protocols:
   mcp:
-    version: "1.0.0"
+    version: 1.0.0
     role: client
     capabilities:
       tools: true
@@ -84,23 +85,22 @@ protocols:
       prompts: false
       sampling: false
   a2a:
-    version: "0.2.1"
+    version: 0.2.1
     endpoint: https://agents.blueflyagents.com/a2a/react-assistant
     agent_card:
       name: AgentScope React Assistant
-      description: "ReAct agent with tool use and memory"
+      description: ReAct agent with tool use and memory
       skills:
         - id: question-answering
           name: Question Answering
-          description: "Answer questions using tools and knowledge"
+          description: Answer questions using tools and knowledge
         - id: code-analysis
           name: Code Analysis
-          description: "Analyze code using knowledge graph"
+          description: Analyze code using knowledge graph
     capabilities:
       streaming: true
       pushNotifications: false
       stateTransitionHistory: false
-
 token_efficiency:
   serialization_profile: compact
   observation_format: projected
@@ -109,13 +109,17 @@ token_efficiency:
     max_output_tokens: 4096
     allocation_strategy: adaptive
   routing:
-    cascade: [claude-haiku-4-5-20251001, claude-sonnet-4-20250514, claude-opus-4-20250514]
-    complexity_threshold: [0.3, 0.7]
+    cascade:
+      - claude-haiku-4-5-20251001
+      - claude-sonnet-4-20250514
+      - claude-opus-4-20250514
+    complexity_threshold:
+      - 0.3
+      - 0.7
     strategy: cost_optimized
-
 extensions:
   agentscope:
-    version: "1.0.16"
+    version: 1.0.16
     agent_class: ReActAgent
     capabilities:
       - rag

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

@@ -1,7 +1,7 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
-  name: content_moderator
+  name: content-moderator
   version: 1.0.0
   description: AI-powered content moderation agent for Drupal
   labels:

package/examples/drupal/drupal-contributor-agent/.eslintrc.json

@@ -0,0 +1,58 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint", "import"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking",
+    "plugin:import/recommended",
+    "plugin:import/typescript",
+    "prettier"
+  ],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/explicit-function-return-type": "warn",
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/no-floating-promises": "error",
+    "@typescript-eslint/no-misused-promises": "error",
+    "import/order": [
+      "error",
+      {
+        "groups": [
+          "builtin",
+          "external",
+          "internal",
+          "parent",
+          "sibling",
+          "index"
+        ],
+        "newlines-between": "always",
+        "alphabetize": {
+          "order": "asc",
+          "caseInsensitive": true
+        }
+      }
+    ],
+    "no-console": "warn"
+  },
+  "settings": {
+    "import/resolver": {
+      "typescript": {
+        "alwaysTryTypes": true,
+        "project": "./tsconfig.json"
+      }
+    }
+  }
+}

package/examples/drupal/drupal-contributor-agent/.prettierrc.json

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/examples/drupal/drupal-contributor-agent/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@bluefly/drupal-contributor-agent",
+  "version": "1.0.0",
+  "description": "Enterprise-ready autonomous OSSA/DUADP agent for Drupal.org contributions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src tests --ext .ts",
+    "lint:fix": "eslint src tests --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --run --coverage",
+    "test:unit": "vitest --run --testPathPattern=tests/unit",
+    "test:integration": "vitest --run --testPathPattern=tests/integration",
+    "test:properties": "vitest --run --testPathPattern=tests/properties",
+    "typecheck": "tsc --noEmit",
+    "validate": "npm run typecheck && npm run lint && npm run format:check && npm run test"
+  },
+  "keywords": [
+    "ossa",
+    "duadp",
+    "drupal",
+    "agent",
+    "autonomous",
+    "mcp"
+  ],
+  "author": "Bluefly",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-cedar": "^3.0.0",
+    "fast-check": "^3.15.0",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/coverage-v8": "^1.2.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "prettier": "^3.2.4",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  }
+}

package/examples/drupal/drupal-contributor-agent/src/core/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent Core Engine
+ *
+ * Manages the agent's lifecycle and orchestrates all operations.
+ */
+
+export * from './agent-core';
+export * from './event-system';
+export * from './state-manager';
+

package/examples/drupal/drupal-contributor-agent/src/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Drupal Contributor Agent - Main Entry Point
+ *
+ * Enterprise-ready autonomous OSSA/DUADP agent for Drupal.org contributions.
+ * This agent demonstrates the full OSSA/DUADP stack working together to
+ * contribute to Drupal.org issues with enterprise governance and security.
+ */
+
+export * from './core';
+export * from './discovery';
+export * from './governance';
+export * from './identity';
+export * from './observability';
+export * from './tools';
+export * from './types';
+export * from './workspace';
+

package/examples/drupal/drupal-contributor-agent/src/types/index.ts

@@ -0,0 +1,180 @@
+/**
+ * Core type definitions for the Drupal Contributor Agent
+ */
+
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+  identity: IdentityConfig;
+  discovery: DiscoveryConfig;
+  governance: GovernanceConfig;
+  workspace: WorkspaceConfig;
+  observability: ObservabilityConfig;
+}
+
+/**
+ * Identity configuration
+ */
+export interface IdentityConfig {
+  gaid: string; // W3C Decentralized Identifier
+  manifestPath: string;
+  privateKeyPath?: string;
+}
+
+/**
+ * Discovery configuration
+ */
+export interface DiscoveryConfig {
+  endpoint: string;
+  port: number;
+}
+
+/**
+ * Governance configuration
+ */
+export interface GovernanceConfig {
+  cedarPoliciesPath: string;
+  approvalWebhookUrl?: string;
+  auditLogPath: string;
+}
+
+/**
+ * Workspace configuration
+ */
+export interface WorkspaceConfig {
+  rootPath: string;
+  isolation: 'container' | 'process' | 'none';
+  maxDiskUsage: string;
+  maxMemory: string;
+}
+
+/**
+ * Observability configuration
+ */
+export interface ObservabilityConfig {
+  metricsPort: number;
+  logLevel: 'debug' | 'info' | 'warn' | 'error';
+  tracingEnabled: boolean;
+  tracingSampleRate: number;
+}
+
+/**
+ * Agent state
+ */
+export interface AgentState {
+  status: 'initializing' | 'ready' | 'processing' | 'error' | 'shutdown';
+  currentIssue?: string;
+  currentWorkspace?: string;
+  lastError?: Error;
+}
+
+/**
+ * Issue processing result
+ */
+export interface IssueResult {
+  issueId: string;
+  status: 'completed' | 'failed' | 'pending_approval';
+  mergeRequestUrl?: string;
+  evidence: Evidence[];
+  auditTrail: AuditEntry[];
+}
+
+/**
+ * Evidence for validation and review
+ */
+export interface Evidence {
+  type: 'diff' | 'test_result' | 'analysis' | 'screenshot' | 'log';
+  title: string;
+  description: string;
+  content: {
+    format: 'text' | 'json' | 'binary';
+    data: string | Buffer;
+    encoding?: string;
+  };
+  metadata: {
+    tool: string;
+    version: string;
+    timestamp: Date;
+    checksum: string;
+  };
+  validation: {
+    verified: boolean;
+    signature?: string;
+  };
+}
+
+/**
+ * Audit trail entry
+ */
+export interface AuditEntry {
+  id: string;
+  timestamp: Date;
+  tenantId: string;
+  workspaceId: string;
+  actor: {
+    type: 'agent' | 'human';
+    id: string;
+    gaid?: string;
+  };
+  action: {
+    type: string;
+    description: string;
+    parameters: Record<string, unknown>;
+  };
+  resource: {
+    type: string;
+    id: string;
+    path?: string;
+  };
+  result: {
+    status: 'success' | 'failure' | 'pending';
+    message?: string;
+    evidence?: Evidence[];
+  };
+  governance: {
+    policyEvaluation: AuthorizationResult;
+    approvals?: ApprovalRecord[];
+  };
+  context: {
+    correlationId: string;
+    traceId: string;
+    sessionId: string;
+  };
+}
+
+/**
+ * Authorization result from Cedar policy engine
+ */
+export interface AuthorizationResult {
+  decision: 'Allow' | 'Deny';
+  reasons: string[];
+  requiredApprovals?: ApprovalGate[];
+}
+
+/**
+ * Approval gate definition
+ */
+export interface ApprovalGate {
+  id: string;
+  type: string;
+  description: string;
+  approvers: string[];
+  timeout?: number;
+}
+
+/**
+ * Approval record
+ */
+export interface ApprovalRecord {
+  gateId: string;
+  approver: string;
+  decision: 'approved' | 'denied';
+  timestamp: Date;
+  reason?: string;
+}
+
+/**
+ * Event handler function
+ */
+export type EventHandler = (data: unknown) => void | Promise<void>;

package/examples/drupal/drupal-contributor-agent/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "removeComments": false,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}