@bluefly/openstandardagents 0.2.7 → 0.2.9

package/README.md

@@ -1,366 +1,301 @@
 # OSSA - Open Standard for Scalable AI Agents
 
-> **📦 NPM Package**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
+> **The OpenAPI for AI Agents**
 > 
-> - **🐙 GitHub**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents) - Submit PRs and issues
+> - **🦊 GitLab**: [gitlab.com/blueflyio/openstandardagents](https://gitlab.com/blueflyio/openstandardagents) (Primary)
+> - **🐙 GitHub**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents) (Mirror)
+> - **📦 npm**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
 > - **🌐 Website**: [openstandardagents.org](https://openstandardagents.org)
-> - **💬 Discord**: [Open Standard for AI Agents (OSSA)](https://discord.com/channels/1440574820390801561/1440574821841899562)
+> - **💬 Discord**: [Join our community](https://discord.gg/ossa)
+>
+> ⚠️ **Note**: GitHub is a read-only mirror. All development happens on GitLab.
 
 ---
 
-**The OpenAPI for AI Agents**
-
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![npm version](https://img.shields.io/npm/v/@bluefly/openstandardagents)](https://www.npmjs.com/package/@bluefly/openstandardagents)
-[![GitLab](https://img.shields.io/badge/GitLab-OSSA-orange.svg)](https://github.com/blueflyio/openstandardagents)
 [![GitHub](https://img.shields.io/badge/GitHub-OSSA-black.svg)](https://github.com/blueflyio/openstandardagents)
-[![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://github.com/blueflyio/openstandardagents)
+
+**Vendor-neutral, compliance-ready, enterprise-grade**
+
+- ✅ Switch between AI providers without code changes
+- ✅ Built-in compliance and security frameworks
+- ✅ Standardized agent lifecycle and governance
+- ✅ Multi-runtime support (Node.js, Python, more)
 
 ---
 
 ## What is OSSA?
 
-**OSSA: Open Standard for Scalable AI Agents** - The definitive open standard for defining and connecting AI agents.
+**Open Standard Agents (OSSA)** is an open, vendor-neutral specification for defining AI agents, similar to how OpenAPI standardizes REST APIs. It enables interoperability across frameworks, runtimes, and organizations.
 
-Just as OpenAPI standardized REST APIs, OSSA standardizes AI agent interaction, enabling vendor-neutral interoperability across frameworks. OSSA provides a unified schema for AI agents to communicate, ensuring compatibility across frameworks and enhancing trust in autonomous systems.
+### OSSA is NOT a Framework
 
-**OSSA is NOT a framework** - it's a standard that defines the contract. Implementations provide the functionality.
+OSSA is a **specification standard** that defines the contract for agent definition, deployment, and management.
 
-**Key Qualities:**
-- **Vendor-Neutral** - Community-driven, not controlled by any single company
-- **Interoperable** - Common language enabling diverse AI agents to work together
-- **Trustworthy** - Built with compliance and security in mind
-- **Open** - Collaborative effort for the "Internet of Agents"
+Just like OpenAPI doesn't implement APIs, OSSA doesn't implement agents. It provides the standard that implementations follow.
 
-| Component | Role | Comparable To |
-|-----------|------|---------------|
-| OSSA Specification | Standard definition | OpenAPI Specification |
-| OSSA CLI | Validation & generation | OpenAPI Generator (minimal) |
-| agent-buildkit | Reference implementation | Kong API Gateway |
-| OSSA Registry | Agent distribution | npm Registry |
+### Why Does This Matter?
 
----
+**Portability: Avoid Vendor Lock-in**  
+Switch between AI providers (OpenAI, Anthropic, Azure) without rewriting code. Define your agent once in OSSA format, deploy anywhere.
 
-## Core Principles
+**Regulatory Compliance: Built-in Frameworks**  
+Meet SOC2, FedRAMP, HIPAA, and GDPR requirements with standardized security models, audit trails, and data boundary controls.
 
-1. **Specification-Driven** - OSSA defines the standard
-2. **Implementation-Agnostic** - Any runtime can implement it
-3. **Minimal Tooling** - Basic CLI for validation & generation
-4. **No Vendor Lock-in** - Deploy to any infrastructure
+**Vendor Independence: True Interoperability**  
+Community-driven standard, not controlled by any single company. Works with LangChain, CrewAI, AutoGen, and any framework.
+
+**One standard. Any framework. True portability.**
 
 ---
 
-## Quick Start
+## Get Started in Minutes
 
-### Installation
+### 1. Install CLI
 
 ```bash
 npm install -g @bluefly/openstandardagents
 ```
 
-### Create Agent
+### 2. Create Agent
 
 ```bash
-ossa generate worker --name "My Agent" --id my-agent
-# Creates agent.ossa.yaml
+ossa init my-agent
+cd my-agent
 ```
 
-### Validate
+### 3. Validate
 
 ```bash
-ossa validate agent.yml
+ossa validate my-agent.ossa.yaml
 ```
 
-### Run Your Agent
+### 4. Run
 
 ```bash
 # Set your API key
 export OPENAI_API_KEY=sk-your-key-here
 
 # Run interactively
-ossa run agent.ossa.yaml
-
-# Or send a single message
-ossa run agent.ossa.yaml -m "Hello, how can you help me?"
-
-# With verbose output
-ossa run agent.ossa.yaml -v
+ossa run my-agent.ossa.yaml
 ```
 
-### Deploy
-
-Deploy to **YOUR** infrastructure:
-- AWS, GCP, Azure
-- Kubernetes, Docker
-- On-premise
-- Serverless
-
-OSSA doesn't care - it's just a standard.
-
----
-
-## OSSA CLI (Minimal Tooling)
-
-The OSSA CLI provides basic tooling:
+### 5. Export to Any Framework
 
 ```bash
-ossa validate <path>    # Validate against OSSA schema
-ossa generate <type>    # Generate agent from template (chat, workflow, compliance, etc.)
-ossa migrate <source>   # Migrate between OSSA versions
-ossa run <path>         # Run agents with OpenAI adapter
+ossa export --to cursor
+ossa export --to langchain
+ossa export --to crewai
 ```
 
-**What OSSA CLI does:**
-- Validate agent manifests
-- Generate project scaffolding
-- Provide templates
-- Run agents interactively (OpenAI adapter)
-
-**What OSSA CLI does NOT do:**
-- Runtime orchestration
-- Deployment
-- Production monitoring
-- Infrastructure management
-
-For production features, see [Agent Buildkit](https://github.com/blueflyio/agent-buildkit).
+[Read Full Getting Started Guide](https://openstandardagents.org/docs/getting-started/)
 
-### Running Agents
-
-The `ossa run` command allows you to execute agents using the OpenAI adapter:
-
-```bash
-# Interactive mode (REPL)
-ossa run my-agent.ossa.yaml
-
-# Single message mode
-ossa run my-agent.ossa.yaml -m "What is the weather today?"
+---
 
-# Verbose output (show tool calls)
-ossa run my-agent.ossa.yaml -v
+## Minimal Example
 
-# Custom options
-ossa run my-agent.ossa.yaml --max-turns 20 --no-validate
+```yaml
+apiVersion: ossa/v0.2.9
+kind: Agent
+
+metadata:
+  name: my-agent
+  version: "1.0.0"
+  description: My first OSSA agent
+
+spec:
+  role: |
+    You are a helpful assistant that answers questions.
+  
+  llm:
+    provider: openai
+    model: gpt-4
+  
+  tools:
+    - type: function
+      name: get_weather
+      capabilities:
+        - name: get_current_weather
+          description: Get current weather for a location
+          input_schema:
+            type: object
+            properties:
+              location:
+                type: string
+            required: [location]
 ```
 
-**Features:**
-- Interactive REPL mode for conversations
-- Single message mode for quick queries
-- Tool execution with custom handlers
-- Verbose mode for debugging
-- Configurable max turns to prevent loops
-
-**Requirements:**
-- OpenAI API key: `export OPENAI_API_KEY=sk-...`
-- Valid OSSA manifest (YAML or JSON)
-
-See [Running Agents Guide](https://openstandardagents.org/docs/getting-started/running-agents) for more details.
-
 ---
 
-## Specification
+## Why OSSA?
 
-OSSA v0.2.6 Schema: [`spec/v0.2.6/ossa-0.2.6.schema.json`](spec/v0.2.6/ossa-0.2.6.schema.json)
+### Framework-Agnostic
+Works with LangChain, Anthropic, OpenAI, CrewAI, Langflow, AutoGen, and more. No vendor lock-in.
 
-### Required Fields
+### Portable
+Move agents between teams, organizations, and infrastructures without rewriting code.
 
-```yaml
-ossaVersion: "0.2.6"
-
-agent:
-  id: my-agent                    # DNS-1123 format
-  name: My Agent                  # Human-readable
-  version: "1.0.0"                # Semantic version
-  role: worker                    # Agent role
-
-  runtime:
-    type: k8s                     # Runtime type
-
-  capabilities:                   # At least one capability
-    - name: process_data
-      description: Process data
-      input_schema: { ... }
-      output_schema: { ... }
-```
+### Validatable
+JSON Schema validation ensures correctness before deployment. Catch errors early.
 
-Full schema documentation: [`docs/specification/`](docs/specification/)
+### Well-Documented
+Comprehensive documentation, examples, and tooling. Built for developers, by developers.
 
----
+### Open Source
+Apache 2.0 licensed. Community-driven. Transparent development process.
 
-## Production-Ready Example: GitLab Kubernetes Agent Ecosystem
+### Fast Integration
+Export to any framework format. Import existing agents. Seamless migration paths.
 
-**NEW**: Complete production ecosystem with **8 specialized agents** for GitLab-integrated Kubernetes deployments.
+### Secure by Design
+Built-in security patterns, authentication, and compliance features.
 
-[**View Full Documentation**](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
+### Observable
+Built-in observability, logging, and monitoring. Track agent performance and behavior.
 
-### Highlights
+---
 
-- **8 OSSA-compliant agents**: Security, Performance, Database, Config, Monitoring, Rollback, Cost, Compliance
-- **Agent mesh** with Istio + STRICT mTLS
-- **Elite DORA metrics**: 12 deployments/day, 45min lead time, 8.5% change failure rate
-- **Massive ROI**: $80-145K/month cost savings (31-57x return)
-- **Full compliance**: SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP
+## Works With Your Favorite Tools
 
-### Quick Deploy
+OSSA integrates seamlessly with leading AI frameworks, platforms, and tools:
 
-```bash
-# Deploy agent mesh
-kubectl apply -f .gitlab/agents/mesh-config.yaml
-
-# Deploy all 8 agents
-for agent in security-scanner performance-optimizer db-migrator \
-             config-validator monitoring-agent rollback-coordinator \
-             cost-analyzer compliance-auditor; do
-  buildkit agents deploy .gitlab/agents/$agent/manifest.ossa.yaml
-done
-```
-
-**Location**: [`.gitlab/agents/`](.gitlab/agents/)
+**LLM Providers**: OpenAI, Anthropic, Google Gemini, Azure OpenAI, Ollama
 
----
+**Frameworks**: LangChain, CrewAI, AutoGen, LlamaIndex, LangGraph, Langflow
 
-## Examples
+**Platforms**: Kubernetes, Docker, AWS, Azure, GCP
 
-Reference implementations: [`examples/`](examples/)
+**Tools**: MCP, Drupal, LibreChat, Cursor, VS Code
 
-- `compliance-agent.yml` - FedRAMP compliance
-- `chat-agent.yml` - Conversation agent
-- `workflow-agent.yml` - Workflow orchestration
-- **GitLab K8s Ecosystem** - Production-ready multi-agent system (see above)
+[View All Integrations](https://openstandardagents.org/docs/ecosystem/framework-support/)
 
 ---
 
-## OSSA Ecosystem
-
-### Core Products
-
-**OSSA** (This Repository) - The specification standard
-- JSON Schema specification
-- CLI for validation & generation
-- Reference implementations
-- Documentation
+## Examples
 
-**Agent Buildkit** - CLI tool for building and managing OSSA-compliant agents
-- Modern, fast, minimal CLI
-- GitLab integration
-- Kubernetes deployment
-- Production monitoring
+We provide comprehensive examples for all major frameworks:
 
-**Agent Studio** - GUI platform for agent orchestration
-- macOS-aligned design
-- Visual workflow design
-- Agent monitoring and debugging
-- End-to-end agent lifecycle management
+### Framework Integration Examples
 
-### Part of the OSSA Ecosystem
+- **OpenAI** - [examples/openai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/openai)
+- **Anthropic** - [examples/anthropic/](https://github.com/blueflyio/openstandardagents/tree/main/examples/anthropic)
+- **LangChain** - [examples/langchain/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langchain)
+- **CrewAI** - [examples/crewai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/crewai)
+- **AutoGen** - [examples/autogen/](https://github.com/blueflyio/openstandardagents/tree/main/examples/autogen)
+- **LlamaIndex** - [examples/llamaindex/](https://github.com/blueflyio/openstandardagents/tree/main/examples/llamaindex)
+- **LangGraph** - [examples/langgraph/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langgraph)
+- **Langflow** - [examples/langflow/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langflow)
+- **Vercel AI** - [examples/vercel/](https://github.com/blueflyio/openstandardagents/tree/main/examples/vercel)
+- **Cursor** - [examples/cursor/](https://github.com/blueflyio/openstandardagents/tree/main/examples/cursor)
 
-All three products work together:
-- **OSSA** defines the standard
-- **Agent Buildkit** provides CLI tooling
-- **Agent Studio** offers visual management
+### Production Examples
 
-Together, they form a complete ecosystem for AI agent development, deployment, and management.
+**GitLab Kubernetes Ecosystem** - [.gitlab/agents/](https://github.com/blueflyio/openstandardagents/tree/main/.gitlab/agents)
+- 8 specialized agents for production Kubernetes deployments
+- Security, Performance, Database, Config, Monitoring, Rollback, Cost, Compliance
+- Full documentation: [Wiki](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
 
-**Others welcome** - OSSA is an open standard, anyone can implement it.
+[View All Examples](https://openstandardagents.org/examples/)
 
 ---
 
-## Why OSSA?
+## Documentation
 
-### For Enterprises
+### Official Website
 
-- **Lightweight** - Just a standard, minimal dependencies
-- **No Vendor Lock-in** - Use any implementation
-- **Deploy Anywhere** - Your infrastructure, your choice
-- **Clear Specification** - Well-defined contract
+**Live Website**: [openstandardagents.org](https://openstandardagents.org)
 
-### For Framework Builders
+Features:
+- **Interactive Documentation** - Complete OSSA specification
+- **Schema Validator** - Validate your manifests in the browser
+- **Playground** - Test agents interactively
+- **Migration Guides** - From LangChain, MCP, OpenAI Swarm, CrewAI, Langflow, Drupal ECA
 
-- **Standard to Build On** - Like OpenAPI for APIs
-- **Reference Implementation** - Agent Buildkit shows the way
-- **Clear Boundaries** - Standard vs. implementation
+### Resources
 
----
+- **Getting Started**: [openstandardagents.org/docs/getting-started/](https://openstandardagents.org/docs/getting-started/)
+- **Full Documentation**: [openstandardagents.org/docs/](https://openstandardagents.org/docs/)
+- **Schema Reference**: [openstandardagents.org/schema/](https://openstandardagents.org/schema/)
+- **Specification**: [spec/v0.2.9/ossa-0.2.9.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.9/ossa-0.2.9.schema.json)
+- **Examples**: [openstandardagents.org/examples/](https://openstandardagents.org/examples/)
+- **Blog**: [openstandardagents.org/blog/](https://openstandardagents.org/blog/)
 
-## Installation & Usage
+---
 
-### As a Standard (Validation Only)
+## How OSSA Compares
 
-```bash
-npm install -g @bluefly/openstandardagents
-ossa validate my-agent.yml
-```
+| Feature | OSSA | LangChain | AutoGen | MCP | Semantic Kernel |
+|---------|------|-----------|---------|-----|-----------------|
+| Vendor Neutral | ✅ | ❌ | ❌ | ✅ | ❌ |
+| Formal Standard | ✅ | ❌ | ❌ | ✅ | ❌ |
+| Multi-runtime | ✅ | ⚠️ | ⚠️ | ✅ | ⚠️ |
+| Enterprise Governance | ✅ | ❌ | ❌ | ❌ | ⚠️ |
+| Compliance Ready | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Open Source | ✅ | ✅ | ✅ | ✅ | ✅ |
 
-### With Production Features
+**OSSA**: Vendor-neutral specification standard  
+**LangChain/AutoGen/Semantic Kernel**: Framework-specific implementations  
+**MCP**: Formal standard focused on context, not full agent lifecycle
 
-```bash
-npm install -g @bluefly/agent-buildkit
-buildkit ossa validate my-agent.yml  # Uses OSSA + adds features
-buildkit ossa sync-docs               # GitLab integration
-```
+- **Specification**: [spec/v0.2.9/ossa-0.2.9.schema.json](spec/v0.2.9/ossa-0.2.9.schema.json)
+- **Examples**: [examples/](examples/)
+- **API Reference**: [docs/](docs/)
+- **Deployment Guides**: [GitHub Mirroring](https://openstandardagents.org/docs/deployment/github-mirroring)
+- **GitHub Issues**: https://github.com/blueflyio/openstandardagents/issues
 
 ---
 
-## Documentation
+## Contributing
 
-### Official Website & Documentation Portal
+OSSA is an open-source, community-driven project. We welcome contributions!
 
-**Live Website**: https://openstandardagents.org
+**Primary Repository**: [GitLab](https://gitlab.com/blueflyio/openstandardagents)  
+**GitHub Mirror**: [GitHub](https://github.com/blueflyio/openstandardagents) (read-only, automatically synced)
 
-The OSSA website features:
-- **Interactive Documentation** - Browse the complete OSSA wiki with an enhanced UI
-- **GitLab Wiki Integration** - Automatically synced from the official GitLab wiki
-- **Interactive Examples** - Explore OSSA manifests with live validation and URL tracking
-- **Schema Validator** - Validate your OSSA manifests in the browser
-- **Migration Guides** - Step-by-step guides from 6 major frameworks
-- **Responsive Design** - Beautiful, accessible UI built with Next.js 15 and Tailwind CSS
+> ⚠️ **Important**: The GitHub repository is a read-only mirror. All development happens on GitLab.
+> 
+> - ✅ **GitLab**: Create issues, merge requests, discussions
+> - ❌ **GitHub**: Do not create PRs or issues - they will not be reviewed
 
-The documentation is organized into:
-- **Getting Started** - Quick start guides, installation, and first agent creation
-- **Core Concepts** - OSSA specification, agent types, capabilities, and runtime models
-- **Advanced Topics** - Security, deployment, monitoring, and scaling
-- **For Your Role** - Tailored guides for developers, architects, enterprises, and researchers
-- **Migration Guides** - From LangChain, MCP, OpenAI Swarm, CrewAI, Langflow, and Drupal ECA
-- **Reference** - Complete schema, CLI, and OpenAPI extension reference
+### How to Contribute
 
-### Additional Resources
+1. Fork the repository on [GitLab](https://gitlab.com/blueflyio/openstandardagents)
+2. Create a feature branch
+3. Make your changes
+4. Submit a merge request on GitLab
 
-- **Specification**: [spec/v0.2.6/ossa-0.2.6.schema.json](spec/v0.2.6/ossa-0.2.6.schema.json)
-- **Examples**: [examples/](examples/)
-- **API Reference**: [docs/](docs/)
-- **Deployment Guides**: [GitHub Mirroring](https://openstandardagents.org/docs/deployment/github-mirroring)
-- **GitHub Issues**: https://github.com/blueflyio/openstandardagents/issues
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
 
----
+### Ways to Contribute
 
-## Contributing
+- **Code** - Improve the CLI, add examples, fix bugs
+- **Documentation** - Improve docs, write tutorials
+- **Examples** - Add framework integrations
+- **Feedback** - Report issues, suggest features
+- **Community** - Help others, answer questions
 
-OSSA is an open standard. Contributions welcome.
+---
 
-**Repository**: https://github.com/blueflyio/openstandardagents/  
-**Homepage**: https://openstandardagents.org  
-**Issues**: https://github.com/blueflyio/openstandardagents/issues
+## Community
 
-1. Fork the repository on GitHub
-2. Create feature branch
-3. Submit pull request
+Join our growing community:
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+- **Discord**: [Join our community](https://discord.gg/ossa)
+- **GitHub Discussions**: [github.com/blueflyio/openstandardagents/discussions](https://github.com/blueflyio/openstandardagents/discussions)
+- **GitHub Issues**: [github.com/blueflyio/openstandardagents/issues](https://github.com/blueflyio/openstandardagents/issues)
 
 ---
 
 ## License
 
-Apache 2.0 - see [LICENSE](LICENSE) for details.
+Apache 2.0 - see [LICENSE](https://github.com/blueflyio/openstandardagents/blob/main/LICENSE) for details.
 
 ---
 
-## Part of the OSSA Ecosystem
-
-OSSA is part of a unified ecosystem for AI agent development:
+## About
 
-- **OSSA** - The open standard (this repository)
-- **Agent Buildkit** - CLI for building and managing agents
-- **Agent Studio** - GUI platform for agent orchestration
+Open Standard Agents (OSSA) is a vendor-neutral specification created by Thomas Scola, founder of Bluefly.io.
 
 **OSSA: Open. Interoperable. Trustworthy.**
 

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  */
 export * from './types/index.js';
 export * from './types/openapi-extensions.js';
+export { getVersionInfo, getVersion, getSchemaPath, getApiVersion, getSchemaDir, isPrerelease, getSupportedVersions, resolveSchemaPath, type VersionInfo } from './utils/version.js';
 export { SchemaRepository } from './repositories/schema.repository.js';
 export { ManifestRepository } from './repositories/manifest.repository.js';
 export { ValidationService } from './services/validation.service.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -5,6 +5,8 @@
 // Types
 export * from './types/index.js';
 export * from './types/openapi-extensions.js';
+// Version utilities (dynamic version detection)
+export { getVersionInfo, getVersion, getSchemaPath, getApiVersion, getSchemaDir, isPrerelease, getSupportedVersions, resolveSchemaPath } from './utils/version.js';
 // Repositories
 export { SchemaRepository } from './repositories/schema.repository.js';
 export { ManifestRepository } from './repositories/manifest.repository.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAE9C,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAE9C,gDAAgD;AAChD,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAE5B,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/repositories/schema.repository.d.ts

@@ -32,9 +32,14 @@ export declare class SchemaRepository implements ISchemaRepository {
      * @returns Array of available version strings
      */
     private discoverAvailableVersions;
+    /**
+     * Check if a directory contains an OSSA spec directory
+     * Uses dynamic discovery - no hardcoded version numbers
+     */
+    private hasSpecDirectory;
     /**
      * Find OSSA package root directory
-     * Looks for package.json with @bluefly/openstandardagents
+     * Looks for package.json with @bluefly/openstandardagents or spec/ directory
      */
     private findOssaRoot;
     /**

package/dist/repositories/schema.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.repository.d.ts","sourceRoot":"","sources":["../../src/repositories/schema.repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvE,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,WAAW,CAAmD;IACtE,OAAO,CAAC,kBAAkB,CAAyB;IAEnD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAShC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IA0B3B;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA0BzE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoCrB;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IA+BjC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkGpB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"schema.repository.d.ts","sourceRoot":"","sources":["../../src/repositories/schema.repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvE,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,WAAW,CAAmD;IACtE,OAAO,CAAC,kBAAkB,CAAyB;IAEnD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAShC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IA0B3B;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA0BzE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoCrB;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IA+BjC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAmFpB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}