@bluefly/openstandardagents 0.5.0 → 0.5.1

package/dist/types/index.js

@@ -10,7 +10,7 @@ export * from './task.js';
 export { createTaskManifest, isOssaTask } from './task.js';
 // Export Workflow types (v0.3.0)
 export * from './workflow.js';
-export { createStep, createWorkflowManifest, expr, isOssaWorkflow } from './workflow.js';
+export { createStep, createWorkflowManifest, expr, isOssaWorkflow, } from './workflow.js';
 // Export Messaging types (v0.3.0)
 export * from './messaging.js';
 // Export Identity & Adapter types (v0.3.6)
@@ -25,6 +25,8 @@ export { isOssaSkill } from './skill.js';
 export { createRoleManifest, isOssaRole } from './role.js';
 // Export MCP server manifest types
 export { isOssaMCPServer } from './mcp-server-manifest.js';
-// Export Protocol Declaration types (v0.5)
+// Export Cognition types (v0.4 — CAOE)
+export * from './cognition.zod.js';
+// v0.5: Protocol Declarations
 export * from './protocols.js';
 //# sourceMappingURL=index.js.map

package/dist/types/personality.zod.d.ts

@@ -165,9 +165,9 @@ export declare const ExpertiseEntrySchema: z.ZodObject<{
     specializations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const UncertaintyHandlingSchema: z.ZodEnum<{
+    defer: "defer";
     acknowledge: "acknowledge";
     investigate: "investigate";
-    defer: "defer";
     estimate: "estimate";
 }>;
 export declare const ErrorResponseSchema: z.ZodEnum<{
@@ -202,9 +202,9 @@ export declare const RiskToleranceSchema: z.ZodEnum<{
 }>;
 export declare const BehavioralTraitsSchema: z.ZodObject<{
     uncertainty_handling: z.ZodOptional<z.ZodEnum<{
+        defer: "defer";
         acknowledge: "acknowledge";
         investigate: "investigate";
-        defer: "defer";
         estimate: "estimate";
     }>>;
     error_response: z.ZodOptional<z.ZodEnum<{
@@ -403,9 +403,9 @@ export declare const PersonalitySpecSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     traits: z.ZodOptional<z.ZodObject<{
         uncertainty_handling: z.ZodOptional<z.ZodEnum<{
+            defer: "defer";
             acknowledge: "acknowledge";
             investigate: "investigate";
-            defer: "defer";
             estimate: "estimate";
         }>>;
         error_response: z.ZodOptional<z.ZodEnum<{

package/dist/utils/http-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OSSA HTTP Client — wraps fetch with proxy support and standard user-agent.
+ *
+ * Two usage patterns:
+ * 1. Direct: `import { ossaFetch } from './http-client.js'` — explicit proxy+UA fetch
+ * 2. Global: `import { installGlobalFetch } from './http-client.js'` — patches globalThis.fetch
+ *    so ALL existing fetch() calls automatically get proxy + UA. Call once at startup.
+ */
+export interface OssaFetchOptions extends RequestInit {
+    agentName?: string;
+}
+/**
+ * Proxy-aware fetch with standard OSSA user-agent header.
+ * Drop-in replacement for fetch() — same API, adds proxy + UA automatically.
+ */
+export declare function ossaFetch(url: string | URL, options?: OssaFetchOptions): Promise<Response>;
+/**
+ * Patch globalThis.fetch so ALL fetch() calls in the process get proxy + UA.
+ * Call once at CLI entry point. Safe to call multiple times (idempotent).
+ */
+export declare function installGlobalFetch(): void;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/utils/http-client.js

@@ -0,0 +1,51 @@
+/**
+ * OSSA HTTP Client — wraps fetch with proxy support and standard user-agent.
+ *
+ * Two usage patterns:
+ * 1. Direct: `import { ossaFetch } from './http-client.js'` — explicit proxy+UA fetch
+ * 2. Global: `import { installGlobalFetch } from './http-client.js'` — patches globalThis.fetch
+ *    so ALL existing fetch() calls automatically get proxy + UA. Call once at startup.
+ */
+import { getProxyAgent } from './proxy-resolver.js';
+import { getOssaUserAgent } from './user-agent.js';
+/**
+ * Proxy-aware fetch with standard OSSA user-agent header.
+ * Drop-in replacement for fetch() — same API, adds proxy + UA automatically.
+ */
+export async function ossaFetch(url, options = {}) {
+    const { agentName, ...fetchOpts } = options;
+    const headers = new Headers(fetchOpts.headers);
+    if (!headers.has('user-agent')) {
+        headers.set('user-agent', getOssaUserAgent(agentName));
+    }
+    const dispatcher = getProxyAgent();
+    return fetch(url, {
+        ...fetchOpts,
+        headers,
+        ...(dispatcher ? { dispatcher } : {}),
+    });
+}
+let installed = false;
+/**
+ * Patch globalThis.fetch so ALL fetch() calls in the process get proxy + UA.
+ * Call once at CLI entry point. Safe to call multiple times (idempotent).
+ */
+export function installGlobalFetch() {
+    if (installed)
+        return;
+    installed = true;
+    const originalFetch = globalThis.fetch;
+    globalThis.fetch = async function patchedFetch(input, init) {
+        const headers = new Headers(init?.headers);
+        if (!headers.has('user-agent')) {
+            headers.set('user-agent', getOssaUserAgent());
+        }
+        const dispatcher = getProxyAgent();
+        return originalFetch(input, {
+            ...init,
+            headers,
+            ...(dispatcher ? { dispatcher } : {}),
+        });
+    };
+}
+//# sourceMappingURL=http-client.js.map

package/dist/utils/index.d.ts

@@ -6,4 +6,7 @@ export * from './version.js';
 export * from './type-guards.js';
 export * from './constants.js';
 export * from './yaml-parser.js';
+export * from './proxy-resolver.js';
+export * from './user-agent.js';
+export * from './http-client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -6,4 +6,7 @@ export * from './version.js';
 export * from './type-guards.js';
 export * from './constants.js';
 export * from './yaml-parser.js';
+export * from './proxy-resolver.js';
+export * from './user-agent.js';
+export * from './http-client.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/proxy-resolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Proxy Resolver — Auto-detect and configure HTTP proxies for all agent HTTP clients.
+ *
+ * Uses proxy-agent to support HTTP, HTTPS, SOCKS4/5, and PAC proxies.
+ * Respects HTTP_PROXY, HTTPS_PROXY, NO_PROXY environment variables.
+ *
+ * Usage:
+ *   import { getProxyAgent } from './proxy-resolver';
+ *   const agent = getProxyAgent();
+ *   fetch(url, { agent });
+ */
+import type { Agent } from 'http';
+/**
+ * Get a proxy-aware HTTP agent. Auto-detects from env vars:
+ * - HTTP_PROXY / http_proxy
+ * - HTTPS_PROXY / https_proxy
+ * - NO_PROXY / no_proxy
+ * - ALL_PROXY / all_proxy
+ *
+ * Returns undefined if no proxy is configured (direct connection).
+ */
+export declare function getProxyAgent(): Agent | undefined;
+/**
+ * Check if a proxy is configured in the environment.
+ */
+export declare function isProxyConfigured(): boolean;
+/**
+ * Get proxy configuration summary for diagnostics/logging.
+ */
+export declare function getProxyInfo(): {
+    configured: boolean;
+    httpProxy?: string;
+    httpsProxy?: string;
+    noProxy?: string;
+};
+//# sourceMappingURL=proxy-resolver.d.ts.map

package/dist/utils/proxy-resolver.js

@@ -0,0 +1,59 @@
+/**
+ * Proxy Resolver — Auto-detect and configure HTTP proxies for all agent HTTP clients.
+ *
+ * Uses proxy-agent to support HTTP, HTTPS, SOCKS4/5, and PAC proxies.
+ * Respects HTTP_PROXY, HTTPS_PROXY, NO_PROXY environment variables.
+ *
+ * Usage:
+ *   import { getProxyAgent } from './proxy-resolver';
+ *   const agent = getProxyAgent();
+ *   fetch(url, { agent });
+ */
+import { ProxyAgent } from 'proxy-agent';
+let cachedAgent;
+/**
+ * Get a proxy-aware HTTP agent. Auto-detects from env vars:
+ * - HTTP_PROXY / http_proxy
+ * - HTTPS_PROXY / https_proxy
+ * - NO_PROXY / no_proxy
+ * - ALL_PROXY / all_proxy
+ *
+ * Returns undefined if no proxy is configured (direct connection).
+ */
+export function getProxyAgent() {
+    const proxyUrl = process.env.HTTP_PROXY ||
+        process.env.http_proxy ||
+        process.env.HTTPS_PROXY ||
+        process.env.https_proxy ||
+        process.env.ALL_PROXY ||
+        process.env.all_proxy;
+    if (!proxyUrl)
+        return undefined;
+    if (!cachedAgent) {
+        cachedAgent = new ProxyAgent();
+    }
+    return cachedAgent;
+}
+/**
+ * Check if a proxy is configured in the environment.
+ */
+export function isProxyConfigured() {
+    return !!(process.env.HTTP_PROXY ||
+        process.env.http_proxy ||
+        process.env.HTTPS_PROXY ||
+        process.env.https_proxy ||
+        process.env.ALL_PROXY ||
+        process.env.all_proxy);
+}
+/**
+ * Get proxy configuration summary for diagnostics/logging.
+ */
+export function getProxyInfo() {
+    return {
+        configured: isProxyConfigured(),
+        httpProxy: process.env.HTTP_PROXY || process.env.http_proxy,
+        httpsProxy: process.env.HTTPS_PROXY || process.env.https_proxy,
+        noProxy: process.env.NO_PROXY || process.env.no_proxy,
+    };
+}
+//# sourceMappingURL=proxy-resolver.js.map

package/dist/utils/user-agent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * User Agent — Consistent identification for all OSSA agent HTTP requests.
+ *
+ * Uses universal-user-agent for cross-runtime compatibility.
+ */
+/**
+ * Get the OSSA user-agent string for HTTP requests.
+ * Format: ossa-cli/{version} ({agentName}) {runtimeUA}
+ */
+export declare function getOssaUserAgent(agentName?: string): string;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/utils/user-agent.js

@@ -0,0 +1,17 @@
+/**
+ * User Agent — Consistent identification for all OSSA agent HTTP requests.
+ *
+ * Uses universal-user-agent for cross-runtime compatibility.
+ */
+import { getUserAgent } from 'universal-user-agent';
+const BASE_USER_AGENT = getUserAgent();
+/**
+ * Get the OSSA user-agent string for HTTP requests.
+ * Format: ossa-cli/{version} ({agentName}) {runtimeUA}
+ */
+export function getOssaUserAgent(agentName) {
+    const version = process.env.npm_package_version || '0.5.1';
+    const agent = agentName ? ` (${agentName})` : '';
+    return `ossa-cli/${version}${agent} ${BASE_USER_AGENT}`;
+}
+//# sourceMappingURL=user-agent.js.map

package/dist/validation/version-compliance.js

@@ -7,7 +7,7 @@ export const MIN_API_VERSION_ALLOWED = {
     'ossa/v0.4': new Set([
         'ossa/v0.4',
         'ossa/v0.4.1',
-        'ossa.bluefly.io/v1alpha1',
+        'ossa/v0.5.1',
     ]),
 };
 /**

package/examples/agentscope/react-assistant/README.md

@@ -71,7 +71,7 @@ agent = ReActAgent(
 
 The manifest declares two MCP tool servers under `spec.tools`:
 
-1. **knowledge-base** -- Graph knowledge base at `gkg.blueflyagents.com` for codebase analysis and structured queries.
+1. **knowledge-base** -- Graph knowledge base at `gkg.bluefly.internal` for codebase analysis and structured queries.
 2. **web-search** -- General MCP server at `mcp.blueflyagents.com` for web search and content retrieval.
 
 At runtime, the adapter connects to these SSE endpoints, discovers available tools, and registers them with the AgentScope `ReActAgent` tool list.

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

@@ -35,7 +35,7 @@ spec:
   tools:
     - type: mcp
       name: knowledge-base
-      endpoint: https://gkg.blueflyagents.com/mcp/sse
+      endpoint: https://gkg.bluefly.internal/mcp/sse
       description: Graph knowledge base for codebase analysis
     - type: mcp
       name: web-search

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"]
+}

package/examples/getting-started/01-minimal-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.5.0
+apiVersion: ossa/v0.5.1
 kind: Agent
 metadata:
   name: hello-world-agent