@bluefly/openstandardagents 0.4.6 → 0.4.9

package/dist/config/cli-config.js

@@ -0,0 +1,107 @@
+/**
+ * OSSA CLI config file (e.g. ~/.ossa/config.json).
+ * Values here override defaults; process.env overrides config file.
+ * Use: ossa config set SKILLS_PATH /path/to/skills
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+const OSSA_DIR = process.env.OSSA_CONFIG_DIR || path.join(homedir(), '.ossa');
+const CONFIG_FILE = process.env.OSSA_CONFIG_PATH || path.join(OSSA_DIR, 'config.json');
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function loadRaw() {
+    if (!fs.existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        const data = JSON.parse(raw);
+        if (data && typeof data === 'object' && !Array.isArray(data)) {
+            const out = {};
+            for (const [k, v] of Object.entries(data)) {
+                if (typeof v === 'string')
+                    out[k] = v;
+                else if (v != null)
+                    out[k] = String(v);
+            }
+            return out;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {};
+}
+function saveRaw(data) {
+    ensureDir(path.dirname(CONFIG_FILE));
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Config file path (for display).
+ */
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * Get a config value. Resolution: process.env[key] then config file.
+ */
+export function getConfigValue(key) {
+    const envVal = process.env[key];
+    if (envVal !== undefined && envVal !== '') {
+        return envVal;
+    }
+    const data = loadRaw();
+    return data[key];
+}
+/**
+ * Set a config value (writes to config file). Does not set process.env.
+ */
+export function setConfigValue(key, value) {
+    const data = loadRaw();
+    data[key] = value;
+    saveRaw(data);
+}
+/**
+ * Remove a key from the config file.
+ */
+export function unsetConfigValue(key) {
+    const data = loadRaw();
+    if (!(key in data))
+        return false;
+    delete data[key];
+    saveRaw(data);
+    return true;
+}
+/**
+ * List all keys and values from the config file (not env).
+ */
+export function listConfig() {
+    return loadRaw();
+}
+/** Known keys documented in `ossa config --help`. */
+export const KNOWN_KEYS = [
+    'SKILLS_PATH',
+    'BLUEFLY_SKILLS_MARKETPLACE',
+    'BLUEFLY_SKILLS_CATALOG',
+    'BLUEFLY_SKILLS_PATH',
+    'OSSA_WEBAGENTS_API_URL',
+    'OSSA_CONFIG_PATH',
+    'MCP_URL',
+    'GITLAB_URL',
+    'GITLAB_TOKEN',
+];
+/**
+ * Default directory for skills add/list. Resolution: config SKILLS_PATH, then env SKILLS_PATH/BLUEFLY_SKILLS_PATH, then ~/.claude/skills.
+ */
+export function getSkillsPathDefault() {
+    return (getConfigValue('SKILLS_PATH') ||
+        getConfigValue('BLUEFLY_SKILLS_PATH') ||
+        process.env.SKILLS_PATH ||
+        process.env.BLUEFLY_SKILLS_PATH ||
+        (process.env.HOME ? `${process.env.HOME}/.claude/skills` : '.claude/skills'));
+}
+//# sourceMappingURL=cli-config.js.map

package/dist/data/platform-matrix.js

@@ -423,6 +423,35 @@ export const PLATFORM_MATRIX = [
         importHow: 'no',
         specUsage: ['Export produces Warp-compatible agent config from manifest.'],
     },
+    {
+        id: 'agentscope',
+        name: 'AgentScope',
+        description: 'AgentScope multi-agent Python framework with MCP tool integration, A2A support, and Mem0 memory',
+        status: 'beta',
+        whatTheyNeed: [
+            'Python 3.9+',
+            'AgentScope SDK (pip install agentscope)',
+            'LLM API key (OpenAI, Anthropic, etc.)',
+            'Optional: Mem0 for long-term memory',
+        ],
+        folderStructure: [
+            '.agents/{name}/manifest.ossa.yaml',
+            '.agents/{name}/src/ (Python agent code)',
+            'requirements.txt with agentscope',
+        ],
+        sdkNpm: [
+            'agentscope (PyPI)',
+            'agentscope[service] (with tool service)',
+        ],
+        exportHow: 'ossa export <manifest> --platform agentscope -o dist/',
+        importHow: 'partial',
+        specUsage: [
+            'Map spec.role to system message; spec.llm to model_config; spec.tools to service_toolkit.',
+            'extensions.agentscope.agent_class selects AgentScope agent type (ReActAgent, DialogAgent, etc.).',
+            'extensions.agentscope.memory_backend configures memory (mem0, local, etc.).',
+            'extensions.agentscope.orchestration selects multi-agent pattern (msghub, pipeline, etc.).',
+        ],
+    },
     {
         id: 'symfony',
         name: 'Symfony AI Agent',

package/dist/mesh/discovery-providers.js

@@ -237,7 +237,7 @@ export class ConsulDiscoveryProvider {
     }
     consulServiceToAgent(service) {
         return {
-            uri: service.Meta.uri || `agent://consul/${service.ID}`,
+            uri: service.Meta.uri || `uadp://consul/${service.ID}`,
             name: service.Service,
             version: service.Meta.version || '1.0.0',
             ossaVersion: service.Meta.ossaVersion || getApiVersion(),
@@ -372,7 +372,7 @@ export class KubernetesDiscoveryProvider {
         const labels = service.metadata.labels || {};
         return {
             uri: annotations['ossa.io/agent-uri'] ||
-                `agent://k8s/${service.metadata.name}`,
+                `uadp://k8s/${service.metadata.name}`,
             name: service.metadata.name,
             version: labels['app.kubernetes.io/version'] || '1.0.0',
             ossaVersion: annotations['ossa.io/version'] || getApiVersion(),

package/dist/mesh/discovery.js

@@ -201,7 +201,7 @@ export class AgentUriParser {
      * Build an agent URI from namespace and name
      */
     static build(namespace, name) {
-        return `agent://${namespace}/${name}`;
+        return `uadp://${namespace}/${name}`;
     }
     /**
      * Validate an agent URI

package/dist/mesh/index.d.ts

@@ -21,7 +21,7 @@
  *
  * // Define local agent
  * const localAgent = {
- *   uri: 'agent://team-a/my-agent',
+ *   uri: 'uadp://team-a/my-agent',
  *   name: 'My Agent',
  *   version: '1.0.0',
  *   ossaVersion: '0.3.0',
@@ -62,7 +62,7 @@
  *
  * // Request/response
  * const response = await client.request(
- *   'agent://team-b/analyzer',
+ *   'uadp://team-b/analyzer',
  *   { action: 'analyze', data: 'sample' }
  * );
  *

package/dist/mesh/index.js

@@ -21,7 +21,7 @@
  *
  * // Define local agent
  * const localAgent = {
- *   uri: 'agent://team-a/my-agent',
+ *   uri: 'uadp://team-a/my-agent',
  *   name: 'My Agent',
  *   version: '1.0.0',
  *   ossaVersion: '0.3.0',
@@ -62,7 +62,7 @@
  *
  * // Request/response
  * const response = await client.request(
- *   'agent://team-b/analyzer',
+ *   'uadp://team-b/analyzer',
  *   { action: 'analyze', data: 'sample' }
  * );
  *

package/dist/mesh/types.d.ts

@@ -45,7 +45,7 @@ export interface MessageEnvelope<T = unknown> {
     id: string;
     /** Message creation timestamp (ISO 8601) */
     timestamp: string;
-    /** Sender agent URI (format: agent://{namespace}/{name}) */
+    /** Sender agent URI (format: uadp://{namespace}/{name}) */
     from: string;
     /** Recipient agent URI or topic */
     to: string;
@@ -107,6 +107,8 @@ export interface AgentCard {
     name: string;
     version: string;
     ossaVersion: string;
+    uuid?: string;
+    gaid?: string;
     taxonomy?: AgentTaxonomy;
     capabilities: string[];
     tools?: ToolDescriptor[];
@@ -374,6 +376,205 @@ export interface AgentObservability {
         format?: string;
     };
 }
+/**
+ * Agent Taxonomy
+ * Classifies the agent by runtime platform, functional role, and architecture pattern.
+ */
+export interface AgentTaxonomy {
+    /** Runtime platform: claude, kagent, openai, langchain, crewai, etc. */
+    agentType?: string;
+    /** Functional role: orchestrator, worker, reviewer, analyzer, etc. */
+    agentKind?: string;
+    /** Architecture pattern and capabilities */
+    architecture?: {
+        /** Pattern: swarm, pipeline, tree, graph, etc. */
+        pattern?: string;
+        /** Architecture capabilities: handoff, streaming, context, tools, vision */
+        capabilities?: string[];
+        /** Coordination strategy */
+        coordination?: {
+            handoffStrategy?: string;
+            maxDepth?: number;
+        };
+        /** Runtime characteristics */
+        runtime?: {
+            scalability?: string;
+            executionModel?: string;
+            preferredRegion?: string;
+        };
+    };
+}
+/**
+ * Agent Model Info
+ * LLM configuration powering this agent.
+ */
+export interface AgentModelInfo {
+    provider?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+}
+/**
+ * MCP Server Descriptor
+ * Model Context Protocol server this agent connects to.
+ */
+export interface McpServerDescriptor {
+    name: string;
+    description?: string;
+    transport?: {
+        type: string;
+        command?: string;
+        args?: string[];
+        url?: string;
+    };
+    version?: string;
+    capabilities?: {
+        resources?: {
+            subscribe?: boolean;
+            listChanged?: boolean;
+        };
+        tools?: {
+            listChanged?: boolean;
+        };
+        logging?: {
+            enabled?: boolean;
+            level?: string;
+        };
+    };
+    resources?: McpResourceDescriptor[];
+}
+/**
+ * MCP Resource Descriptor
+ */
+export interface McpResourceDescriptor {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * A2A Protocol Descriptor
+ * How this agent communicates with other agents.
+ */
+export interface A2AProtocolDescriptor {
+    /** Protocol type and version */
+    protocol?: {
+        type?: string;
+        version?: string;
+        messageFormat?: string;
+    };
+    /** Connected agent endpoints */
+    agentEndpoints?: Array<{
+        agentId: string;
+        url: string;
+        capabilities?: string[];
+        priority?: number;
+    }>;
+    /** Routing configuration */
+    routing?: {
+        strategy?: string;
+        rules?: Array<{
+            name: string;
+            condition: string;
+            target: string;
+            priority?: number;
+        }>;
+    };
+    /** Delegation and handoff rules */
+    delegation?: {
+        enabled?: boolean;
+        maxDepth?: number;
+        timeout?: number;
+        handoffRules?: Array<{
+            name: string;
+            condition: string;
+            target: string;
+            message?: string;
+        }>;
+    };
+    /** Completion signals */
+    completionSignals?: {
+        signals?: string[];
+        handlers?: Array<{
+            signal: string;
+            action: string;
+            target?: string;
+        }>;
+    };
+    /** Retry policy */
+    retryPolicy?: {
+        maxRetries?: number;
+        backoff?: string;
+        retryableErrors?: string[];
+    };
+    /** Circuit breaker */
+    circuitBreaker?: {
+        enabled?: boolean;
+        failureThreshold?: number;
+        timeout?: number;
+    };
+}
+/**
+ * Agent Handoff
+ * Direct delegation targets from spec.handoffs.
+ */
+export interface AgentHandoff {
+    to: string;
+    condition?: string;
+}
+/**
+ * Agent Autonomy
+ * How independently this agent operates.
+ */
+export interface AgentAutonomy {
+    level?: string;
+    approvalRequired?: boolean;
+    allowedActions?: string[];
+    blockedActions?: string[];
+}
+/**
+ * Agent Constraints
+ * Operational limits for cost, performance, and resources.
+ */
+export interface AgentConstraints {
+    cost?: {
+        maxTokensPerDay?: number;
+        maxTokensPerRequest?: number;
+        maxCostPerDay?: number;
+        currency?: string;
+    };
+    performance?: {
+        maxLatencySeconds?: number;
+        maxConcurrentRequests?: number;
+        timeoutSeconds?: number;
+    };
+    resources?: {
+        cpu?: string;
+        memory?: string;
+    };
+}
+/**
+ * Agent Observability
+ * Tracing, metrics, and logging configuration.
+ */
+export interface AgentObservability {
+    tracing?: {
+        enabled?: boolean;
+        exporter?: string;
+        endpoint?: string;
+        samplingRate?: number;
+    };
+    metrics?: {
+        enabled?: boolean;
+        exporter?: string;
+        endpoint?: string;
+    };
+    logging?: {
+        level?: string;
+        format?: string;
+    };
+}
 /**
  * Tool Descriptor
  */

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.6",
+  "version": "0.4.9",
   "exports": {
     "./schema": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4": "./spec/v0.4/agent.schema.json",
@@ -114,7 +114,6 @@
   "files": [
     "dist/",
     "!dist/dev-cli/",
-    "!dist/services/release-automation/",
     "!dist/sdks/python-generator/",
     "!dist/sdks/typescript/",
     "!dist/**/*.js.map",
@@ -227,7 +226,7 @@
     "prepare": "lefthook install || true",
     "postinstall": "node bin/postinstall || true",
     "// RELEASE & PUBLISH": "",
-    "prepublishOnly": "publint && npm run build",
+    "prepublishOnly": "publint && npm run test:unit && npm run build",
     "validate:deps": "depcheck --ignore-dirs=examples --ignores='@anthropic-ai/claude-agent-sdk,@langchain/openai,@openai/agents,@temporalio/activity,@temporalio/workflow,pino-pretty,readline,@types/*,ts-jest,eslint*,prettier*,lefthook,jest*,vitest,semantic-release*,@semantic-release/*,keep-a-changelog,jest-junit,publint,conventional-changelog-conventionalcommits,ajv-cli,json-schema-to-typescript,json-schema-to-zod,ts-node,@playwright/test,@langchain/anthropic,@langchain/core,langchain'",
     "validate:package": "publint",
     "publish:dry-run": "npm publish --dry-run",
@@ -239,6 +238,7 @@
     "@anthropic-ai/claude-agent-sdk": "^0.2.50",
     "@anthropic-ai/sdk": "^0.71.0",
     "@aws-sdk/client-bedrock-runtime": "^3.955.0",
+    "@cedar-policy/cedar-wasm": "^4.9.1",
     "@gitbeaker/node": "^35.8.1",
     "@gitbeaker/rest": "^43.8.0",
     "@google/generative-ai": "^0.21.0",
@@ -302,6 +302,7 @@
     "zod": "^4.1.11"
   },
   "devDependencies": {
+    "@bluefly/duadp": "^0.1.3",
     "@jest/globals": "^29.7.0",
     "@octokit/rest": "^22.0.1",
     "@semantic-release/changelog": "^6.0.3",
@@ -345,20 +346,12 @@
   "optionalDependencies": {
     "nodemailer": "^6.9.0"
   },
-  "bundledDependencies": [
-    "ajv",
-    "ajv-formats"
-  ],
   "engines": {
-    "node": ">=16.20.0 || >=18.0.0 || >=20.0.0 || >=22.0.0",
-    "npm": ">=8.0.0"
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
   },
   "volta": {
-    "node": "18.20.8",
-    "npm": "10.9.4"
-  },
-  "bundleDependencies": [
-    "ajv",
-    "ajv-formats"
-  ]
+    "node": "22.19.0",
+    "npm": "11.10.0"
+  }
 }

package/dist/services/agent-card-generator.d.ts

@@ -16,10 +16,10 @@
  * - manifestRef, manifestDigest: options or metadata.manifest_ref, metadata.manifest_digest
  * - tokenEfficiencySummary: top-level token_efficiency
  */
-import type { OssaAgent } from '../types/index.js';
 import type { AgentCard } from '../mesh/types.js';
+import type { OssaAgent } from '../types/index.js';
 export interface AgentCardGeneratorOptions {
-    /** Override the agent URI (default: agent://{namespace}/{name}) */
+    /** Override the agent URI (default: uadp://{namespace}/{name}) */
     uri?: string;
     /** Namespace for the agent URI (default: 'default') */
     namespace?: string;

package/dist/services/agent-card-generator.js

@@ -49,7 +49,7 @@ export class AgentCardGenerator {
         const name = manifest.metadata.name;
         const version = manifest.metadata?.version || '1.0.0';
         const namespace = options?.namespace || 'default';
-        const uri = options?.uri || `agent://${namespace}/${name}`;
+        const uri = options?.uri || `uadp://${namespace}/${name}`;
         // Extract all features
         const taxonomy = this.extractTaxonomy(manifest);
         const capabilities = this.extractCapabilities(manifest, taxonomy);
@@ -88,6 +88,8 @@ export class AgentCardGenerator {
             name,
             version,
             ossaVersion: manifest.apiVersion || 'ossa/v0.4',
+            ...(manifest.metadata?.identity?.uuid ? { uuid: manifest.metadata.identity.uuid } : {}),
+            ...(manifest.metadata?.identity?.gaid ? { gaid: manifest.metadata.identity.gaid } : {}),
             // Taxonomy — what kind of agent
             ...(taxonomy ? { taxonomy } : {}),
             // Capabilities & tools

package/dist/services/agents-md/agents-md.service.d.ts

@@ -7,6 +7,10 @@ import type { OssaAgent } from '../../types/index.js';
  * Service for generating and managing agents.md files from OSSA manifests
  */
 export declare class AgentsMdService {
+    /**
+     * Append optional configured block content to a generated section.
+     */
+    private addOptionalBlock;
     /**
      * Generate AGENTS.md content from OSSA manifest
      * @param manifest - OSSA agent manifest

package/dist/services/agents-md/agents-md.service.js

@@ -15,6 +15,15 @@ import { watch } from 'fs';
  * Service for generating and managing agents.md files from OSSA manifests
  */
 let AgentsMdService = class AgentsMdService {
+    /**
+     * Append optional configured block content to a generated section.
+     */
+    addOptionalBlock(lines, content) {
+        if (!content?.trim()) {
+            return;
+        }
+        lines.push('', content);
+    }
     /**
      * Generate AGENTS.md content from OSSA manifest
      * @param manifest - OSSA agent manifest
@@ -61,9 +70,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generateDevEnvironmentSection(manifest, config) {
         const lines = ['# Dev environment tips'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.tools if source is specified
@@ -92,6 +103,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Ensure all required dependencies are installed');
             lines.push('- Configure environment variables as needed');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**
@@ -99,9 +111,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generateTestingSection(manifest, config) {
         const lines = ['# Testing instructions'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.constraints if source is specified
@@ -133,6 +147,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Ensure code coverage meets project standards');
             lines.push('- Validate against OSSA schema: `ossa validate manifest.yaml`');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**
@@ -140,9 +155,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generatePRInstructionsSection(manifest, config) {
         const lines = ['# PR instructions'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.autonomy if source is specified
@@ -176,6 +193,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Update documentation as needed');
             lines.push('- Ensure CI passes before requesting review');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**

package/dist/services/governance/cedar-provider.js

@@ -1,3 +1,4 @@
+import { SPEC_VERSION } from '../../version.js';
 /**
  * Cedar Governance Provider
  *
@@ -7,7 +8,7 @@
  */
 export class CedarGovernanceProvider {
     name = 'cedar';
-    version = 'v0.4.6';
+    version = `v${SPEC_VERSION}`;
     /**
      * Checks if the agent's governance config satisfies basic Cedar alignment.
      * e.g., missing clearance levels when policies require them.

package/dist/services/governance/cedar-validator.service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cedar Policy Validator Service
+ *
+ * Uses @cedar-policy/cedar-wasm to validate Cedar policies embedded in OSSA manifests.
+ * This is OSSA's responsibility: schema definition + offline validation.
+ * Runtime enforcement belongs to DUADP.
+ */
+export interface CedarValidationResult {
+    valid: boolean;
+    policyId?: string;
+    errors: string[];
+    warnings: string[];
+}
+export interface CedarManifestValidationResult {
+    valid: boolean;
+    policyCount: number;
+    results: CedarValidationResult[];
+    hasSchema: boolean;
+}
+/**
+ * Validate a single Cedar policy text for syntax correctness.
+ */
+export declare function validatePolicyText(policyText: string, policyId?: string): CedarValidationResult;
+/**
+ * Validate a Cedar policy against a Cedar schema.
+ */
+export declare function validatePolicyWithSchema(policyText: string, schemaText: string, policyId?: string): CedarValidationResult;
+/**
+ * Extract and validate all Cedar policies from an OSSA manifest.
+ */
+export declare function validateManifestCedarPolicies(manifest: Record<string, unknown>): CedarManifestValidationResult;
+//# sourceMappingURL=cedar-validator.service.d.ts.map