@bluefly/openstandardagents 0.4.8 → 0.5.0

package/dist/spec/v0.5/role.schema.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/role.schema.json",
+  "title": "OSSA v0.5 Role Manifest Schema",
+  "description": "Open Standard for Software Agents (OSSA) v0.5 - Role manifest. Defines behavioral overlays for IDE/CLI agents (Claude Code, Cursor, etc.) with instructions, tool sets, hooks, MCP connections, and activation conditions.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "pattern": "^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$",
+      "description": "OSSA API version",
+      "examples": ["ossa/v0.5", "ossa/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "const": "Role",
+      "description": "Resource type — must be Role"
+    },
+    "metadata": {
+      "$ref": "#/definitions/RoleMetadata"
+    },
+    "spec": {
+      "$ref": "#/definitions/RoleSpec"
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Platform-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "definitions": {
+    "RoleMetadata": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "DNS-style role name (lowercase, hyphens)",
+          "examples": ["drupal-developer", "security-auditor", "platform-operator"]
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$",
+          "description": "Semantic version",
+          "examples": ["1.0.0", "2.1.0-beta"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description"
+        },
+        "labels": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Key-value labels for filtering and categorization"
+        },
+        "annotations": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Non-identifying metadata"
+        }
+      }
+    },
+    "RoleSpec": {
+      "type": "object",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "System prompt / persona definition"
+        },
+        "instructions": {
+          "$ref": "#/definitions/RoleInstructions"
+        },
+        "tools": {
+          "$ref": "#/definitions/RoleTools"
+        },
+        "hooks": {
+          "$ref": "#/definitions/RoleHooks"
+        },
+        "context": {
+          "$ref": "#/definitions/RoleContext"
+        },
+        "protocols": {
+          "$ref": "#/definitions/RoleProtocols"
+        },
+        "extends": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleExtension" },
+          "description": "Role composition — inherit from other roles"
+        },
+        "activation": {
+          "$ref": "#/definitions/RoleActivation"
+        }
+      }
+    },
+    "RoleInstructions": {
+      "type": "object",
+      "properties": {
+        "preamble": {
+          "type": "string",
+          "description": "Markdown content prepended to every conversation"
+        },
+        "constraints": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Hard rules — MUST/MUST NOT statements"
+        }
+      }
+    },
+    "RoleTools": {
+      "type": "object",
+      "properties": {
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Whitelist of allowed tool names"
+        },
+        "denied": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Blacklist of denied tool names (overrides allowed)"
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "References to OSSA Skill manifests"
+        }
+      }
+    },
+    "RoleHooks": {
+      "type": "object",
+      "properties": {
+        "on_activate": {
+          "type": "string",
+          "description": "Run when role is activated"
+        },
+        "on_deactivate": {
+          "type": "string",
+          "description": "Run when switching away from this role"
+        },
+        "pre_commit": {
+          "type": "string",
+          "description": "Run before git commits"
+        },
+        "post_save": {
+          "type": "string",
+          "description": "Run after file saves"
+        }
+      }
+    },
+    "RoleContext": {
+      "type": "object",
+      "properties": {
+        "schemas": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to JSON Schema or OpenAPI spec files"
+        },
+        "files": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleContextFile" },
+          "description": "Files to include in agent context"
+        },
+        "knowledge": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to knowledge base documents"
+        }
+      }
+    },
+    "RoleContextFile": {
+      "type": "object",
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File path or glob pattern"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of what this file provides"
+        }
+      }
+    },
+    "RoleProtocols": {
+      "type": "object",
+      "properties": {
+        "mcp": {
+          "$ref": "#/definitions/RoleMCPConfig"
+        }
+      }
+    },
+    "RoleMCPConfig": {
+      "type": "object",
+      "properties": {
+        "servers": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleMCPServer" },
+          "description": "MCP servers available when this role is active"
+        }
+      }
+    },
+    "RoleMCPServer": {
+      "type": "object",
+      "required": ["name", "transport"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Server identifier"
+        },
+        "transport": {
+          "type": "string",
+          "enum": ["stdio", "sse"],
+          "description": "Transport type"
+        },
+        "command": {
+          "type": "string",
+          "description": "Command to spawn (stdio transport)"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments (stdio transport)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Endpoint URL (SSE transport)"
+        }
+      }
+    },
+    "RoleExtension": {
+      "type": "object",
+      "required": ["role"],
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Name of the parent role to inherit from"
+        },
+        "override": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, child fields replace parent fields; if false, they merge"
+        }
+      }
+    },
+    "RoleActivation": {
+      "type": "object",
+      "properties": {
+        "file_patterns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns — activate when matching files are open"
+        },
+        "command": {
+          "type": "string",
+          "description": "CLI command to activate (e.g., /role drupal)"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variable conditions (all must match)"
+        }
+      }
+    }
+  }
+}

package/dist/types/index.d.ts

@@ -22,6 +22,8 @@ export * from './security.js';
 export type { AuditConfig, DataClassification, EgressPolicy, NetworkAccessConfig, NetworkProtocol, ResourceLimits, SandboxingConfig, SandboxType, SecurityCapability, SecurityPosture, ThreatCategory, ThreatModelEntry, ThreatSeverity } from './security.js';
 export { isOssaSkill } from './skill.js';
 export type { OssaSkill } from './skill.js';
+export { createRoleManifest, isOssaRole } from './role.js';
+export type { OssaRole, RoleActivation, RoleContext, RoleExtension, RoleHooks, RoleInstructions, RoleMCPServer, RoleProtocols, RoleSpec, RoleTools } from './role.js';
 export { isOssaMCPServer } from './mcp-server-manifest.js';
 export type { OssaMCPServer } from './mcp-server-manifest.js';
 export * from './protocols.js';
@@ -34,7 +36,7 @@ export type { A2AAgentCard, A2AAuthentication, A2ACapabilities, A2AProtocol, A2A
  * Agent Type - Runtime platform/framework for agent execution
  * Specifies which platform will execute this agent
  */
-export type AgentType = 'claude' | 'kagent' | 'openai' | 'langchain' | 'crewai' | 'autogen' | 'llamaindex' | 'haystack' | 'semantic-kernel' | 'vertex-ai' | 'bedrock' | 'pydantic-ai' | 'swarm' | 'a2a' | 'mcp-server' | 'agent-sdk' | 'adk' | 'custom';
+export type AgentType = 'claude' | 'kagent' | 'openai' | 'langchain' | 'crewai' | 'autogen' | 'llamaindex' | 'haystack' | 'semantic-kernel' | 'vertex-ai' | 'bedrock' | 'pydantic-ai' | 'swarm' | 'a2a' | 'mcp-server' | 'agent-sdk' | 'adk' | 'agentscope' | 'custom';
 /**
  * Agent Kind - Functional role of the agent
  * Describes WHAT the agent does in the system
@@ -520,6 +522,8 @@ export interface AgentsMdSection {
     enabled?: boolean;
     source?: string;
     custom?: string;
+    append?: string;
+    prepend?: string;
     title_format?: string;
 }
 /**

package/dist/types/index.js

@@ -21,6 +21,8 @@ export * from './architect.js';
 export * from './security.js';
 // Export Skill types (AgentSkills / OSSA skills)
 export { isOssaSkill } from './skill.js';
+// Export Role types (v0.5 — IDE operator contexts)
+export { createRoleManifest, isOssaRole } from './role.js';
 // Export MCP server manifest types
 export { isOssaMCPServer } from './mcp-server-manifest.js';
 // Export Protocol Declaration types (v0.5)

package/dist/types/role.d.ts

@@ -0,0 +1,126 @@
+/**
+ * OSSA Role Manifest Types
+ * Type definitions for role.ossa.yaml manifests (kind: Role)
+ *
+ * Roles define behavioral overlays for IDE/CLI agents (Claude Code, Cursor, etc.)
+ * Unlike Agents (autonomous loops), Roles configure operator context — instructions,
+ * tool access, hooks, MCP connections, and activation conditions.
+ */
+export interface OssaRole {
+    apiVersion: string;
+    kind: 'Role';
+    metadata: RoleMetadata;
+    spec: RoleSpec;
+    extensions?: Record<string, unknown>;
+}
+export interface RoleMetadata {
+    /** DNS-style role name (lowercase, hyphens) */
+    name: string;
+    /** Semantic version */
+    version?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Key-value labels for filtering and categorization */
+    labels?: Record<string, string>;
+    /** Non-identifying metadata */
+    annotations?: Record<string, string>;
+}
+export interface RoleSpec {
+    /** System prompt / persona definition */
+    role?: string;
+    /** Behavioral instructions */
+    instructions?: RoleInstructions;
+    /** Tool access configuration */
+    tools?: RoleTools;
+    /** Lifecycle hooks */
+    hooks?: RoleHooks;
+    /** Context injection */
+    context?: RoleContext;
+    /** Protocol connections */
+    protocols?: RoleProtocols;
+    /** Role composition — inherit from other roles */
+    extends?: RoleExtension[];
+    /** Activation conditions */
+    activation?: RoleActivation;
+}
+export interface RoleInstructions {
+    /** Markdown content prepended to every conversation */
+    preamble?: string;
+    /** Hard rules — MUST/MUST NOT statements */
+    constraints?: string[];
+}
+export interface RoleTools {
+    /** Whitelist of allowed tool names */
+    allowed?: string[];
+    /** Blacklist of denied tool names (overrides allowed) */
+    denied?: string[];
+    /** References to OSSA Skill manifests */
+    skills?: string[];
+}
+export interface RoleHooks {
+    /** Run when role is activated */
+    on_activate?: string;
+    /** Run when switching away from this role */
+    on_deactivate?: string;
+    /** Run before git commits */
+    pre_commit?: string;
+    /** Run after file saves */
+    post_save?: string;
+}
+export interface RoleContext {
+    /** Paths to JSON Schema or OpenAPI spec files */
+    schemas?: string[];
+    /** Files to include in agent context */
+    files?: RoleContextFile[];
+    /** Paths to knowledge base documents */
+    knowledge?: string[];
+}
+export interface RoleContextFile {
+    /** File path or glob pattern */
+    path: string;
+    /** Description of what this file provides */
+    description?: string;
+}
+export interface RoleProtocols {
+    /** MCP server connections */
+    mcp?: RoleMCPConfig;
+}
+export interface RoleMCPConfig {
+    /** MCP servers available when this role is active */
+    servers?: RoleMCPServer[];
+}
+export interface RoleMCPServer {
+    /** Server identifier */
+    name: string;
+    /** Transport type */
+    transport: 'stdio' | 'sse';
+    /** Command to spawn (stdio transport) */
+    command?: string;
+    /** Command arguments (stdio transport) */
+    args?: string[];
+    /** Endpoint URL (SSE transport) */
+    url?: string;
+}
+export interface RoleExtension {
+    /** Name of the parent role to inherit from */
+    role: string;
+    /** If true, child fields replace parent fields; if false, they merge */
+    override?: boolean;
+}
+export interface RoleActivation {
+    /** Glob patterns — activate when matching files are open */
+    file_patterns?: string[];
+    /** CLI command to activate (e.g., "/role drupal") */
+    command?: string;
+    /** Environment variable conditions (all must match) */
+    env?: Record<string, string>;
+}
+/**
+ * Type guard for OssaRole
+ */
+export declare function isOssaRole(obj: unknown): obj is OssaRole;
+/**
+ * Create a minimal OssaRole manifest
+ */
+export declare function createRoleManifest(name: string, description: string, role?: string): OssaRole;
+//# sourceMappingURL=role.d.ts.map

package/dist/types/role.js

@@ -0,0 +1,38 @@
+/**
+ * OSSA Role Manifest Types
+ * Type definitions for role.ossa.yaml manifests (kind: Role)
+ *
+ * Roles define behavioral overlays for IDE/CLI agents (Claude Code, Cursor, etc.)
+ * Unlike Agents (autonomous loops), Roles configure operator context — instructions,
+ * tool access, hooks, MCP connections, and activation conditions.
+ */
+/**
+ * Type guard for OssaRole
+ */
+export function isOssaRole(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const o = obj;
+    return (o.kind === 'Role' &&
+        typeof o.apiVersion === 'string' &&
+        o.metadata != null &&
+        o.spec != null);
+}
+/**
+ * Create a minimal OssaRole manifest
+ */
+export function createRoleManifest(name, description, role) {
+    return {
+        apiVersion: 'ossa/v0.5',
+        kind: 'Role',
+        metadata: {
+            name,
+            version: '1.0.0',
+            description,
+        },
+        spec: {
+            ...(role ? { role } : {}),
+        },
+    };
+}
+//# sourceMappingURL=role.js.map

package/dist/validation/progressive-scorer.d.ts

@@ -58,7 +58,7 @@ export declare class ProgressiveScorer {
     /**
      * Score a manifest
      */
-    score(manifest: OssaAgent, validationResult: ValidationResult): ValidationScore;
+    score(manifest: OssaAgent, _validationResult: ValidationResult): ValidationScore;
     /**
      * Score compatibility (agentType × capabilities)
      */

package/dist/validation/progressive-scorer.js

@@ -25,7 +25,7 @@ export class ProgressiveScorer {
     /**
      * Score a manifest
      */
-    score(manifest, validationResult) {
+    score(manifest, _validationResult) {
         const dimensions = {
             compatibility: this.scoreCompatibility(manifest),
             performance: this.scorePerformance(manifest),
@@ -122,6 +122,23 @@ export class ProgressiveScorer {
             }
             return 1.0;
         }
+        // AgentScope support
+        if (agentType === 'agentscope') {
+            const unsupported = capabilities.filter((c) => ![
+                'handoff',
+                'streaming',
+                'context',
+                'tools',
+                'memory',
+                'rag',
+                'parallel_tool_calls',
+            ].includes(c));
+            if (unsupported.length > 0) {
+                issues.push(`AgentScope may not support: ${unsupported.join(', ')}`);
+                return 1.0 - unsupported.length / capabilities.length;
+            }
+            return 1.0;
+        }
         // Unknown agent type
         if (!agentType) {
             issues.push('No agentType specified');
@@ -276,7 +293,7 @@ export class ProgressiveScorer {
     /**
      * Rank improvements by ROI (impact / effort)
      */
-    rankImprovements(manifest, dimensions) {
+    rankImprovements(_manifest, dimensions) {
         const improvements = [];
         // Generate improvements from each dimension
         for (const [dimName, dim] of Object.entries(dimensions)) {

package/dist/validation/validator.js

@@ -22,7 +22,7 @@ export class OSSAValidator {
         });
         addFormats(this.ajv);
         // Load schema
-        const defaultSchemaPath = join(__dirname, '../spec/v0.4/agent.schema.json');
+        const defaultSchemaPath = join(__dirname, '../spec/v0.5/agent.schema.json');
         const resolvedPath = schemaPath || defaultSchemaPath;
         try {
             const schemaContent = readFileSync(resolvedPath, 'utf-8');

package/dist/version-management/api/server.d.ts

@@ -1,3 +1,3 @@
-declare const app: import("express-serve-static-core").Express;
+declare const app: any;
 export default app;
 //# sourceMappingURL=server.d.ts.map