@bluefly/openstandardagents 0.2.5-RC → 0.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.devfile.yaml +1 -1
- package/.env.example +1 -1
- package/.github/ISSUE_TEMPLATE/bug_report.yml +63 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +40 -0
- package/.github/workflows/dependabot-comment.yml +34 -0
- package/.github/workflows/pr-comment.yml +33 -0
- package/.husky/pre-commit +5 -0
- package/.kiro/config.json +21 -0
- package/.kiro/settings/mcp.json +61 -0
- package/.kiro/specs/scripts-migration-api-first/design.md +883 -0
- package/.kiro/specs/scripts-migration-api-first/requirements.md +165 -0
- package/.kiro/specs/scripts-migration-api-first/tasks.md +539 -0
- package/.kiro/specs/{website-design-audit → website-brand-identity}/design.md +381 -0
- package/.kiro/specs/{website-design-audit → website-brand-identity}/requirements.md +88 -0
- package/.kiro/specs/website-brand-identity/tasks.md +981 -0
- package/.version.json +2 -2
- package/.wiki-config.json +24 -0
- package/CHANGELOG.md +34 -18
- package/CODEOWNERS +75 -0
- package/CONTRIBUTING.md +1 -1
- package/README.md +176 -239
- package/bin/ossa-dev +42 -0
- package/bin/ossa-export +32 -0
- package/bin/ossa-generate +60 -0
- package/bin/ossa-health +40 -0
- package/bin/ossa-init +26 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/repositories/schema.repository.d.ts +6 -1
- package/dist/repositories/schema.repository.d.ts.map +1 -1
- package/dist/repositories/schema.repository.js +63 -36
- package/dist/repositories/schema.repository.js.map +1 -1
- package/dist/services/github-sync/github-client.d.ts +14 -0
- package/dist/services/github-sync/github-client.d.ts.map +1 -0
- package/dist/services/github-sync/github-client.js +41 -0
- package/dist/services/github-sync/github-client.js.map +1 -0
- package/dist/services/github-sync/gitlab-client.d.ts +17 -0
- package/dist/services/github-sync/gitlab-client.d.ts.map +1 -0
- package/dist/services/github-sync/gitlab-client.js +42 -0
- package/dist/services/github-sync/gitlab-client.js.map +1 -0
- package/dist/services/github-sync/schemas.d.ts +46 -0
- package/dist/services/github-sync/schemas.d.ts.map +1 -0
- package/dist/services/github-sync/schemas.js +36 -0
- package/dist/services/github-sync/schemas.js.map +1 -0
- package/dist/services/github-sync/sync.service.d.ts +27 -0
- package/dist/services/github-sync/sync.service.d.ts.map +1 -0
- package/dist/services/github-sync/sync.service.js +99 -0
- package/dist/services/github-sync/sync.service.js.map +1 -0
- package/dist/services/migration.service.d.ts +4 -3
- package/dist/services/migration.service.d.ts.map +1 -1
- package/dist/services/migration.service.js +11 -10
- package/dist/services/migration.service.js.map +1 -1
- package/dist/services/release-automation/release.service.js +1 -1
- package/dist/services/release-automation/release.service.js.map +1 -1
- package/dist/services/release-automation/schemas/release.schema.js +1 -1
- package/dist/services/runtime/claude/capability-mapper.d.ts +84 -0
- package/dist/services/runtime/claude/capability-mapper.d.ts.map +1 -0
- package/dist/services/runtime/claude/capability-mapper.js +245 -0
- package/dist/services/runtime/claude/capability-mapper.js.map +1 -0
- package/dist/services/runtime/claude/claude-adapter.d.ts +80 -0
- package/dist/services/runtime/claude/claude-adapter.d.ts.map +1 -0
- package/dist/services/runtime/claude/claude-adapter.js +287 -0
- package/dist/services/runtime/claude/claude-adapter.js.map +1 -0
- package/dist/services/runtime/claude/manifest-parser.d.ts +77 -0
- package/dist/services/runtime/claude/manifest-parser.d.ts.map +1 -0
- package/dist/services/runtime/claude/manifest-parser.js +169 -0
- package/dist/services/runtime/claude/manifest-parser.js.map +1 -0
- package/dist/services/runtime/claude/types.d.ts +115 -0
- package/dist/services/runtime/claude/types.d.ts.map +1 -0
- package/dist/services/runtime/claude/types.js +6 -0
- package/dist/services/runtime/claude/types.js.map +1 -0
- package/dist/services/validation.service.d.ts.map +1 -1
- package/dist/services/validation.service.js +12 -1
- package/dist/services/validation.service.js.map +1 -1
- package/dist/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
- package/dist/spec/v0.2.6/CHANGELOG.md +401 -0
- package/dist/spec/v0.2.6/README.md +72 -0
- package/dist/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/dist/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
- package/dist/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
- package/dist/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
- package/dist/spec/v0.2.6-dev/CHANGELOG.md +164 -0
- package/dist/spec/v0.2.6-dev/README.md +75 -0
- package/dist/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
- package/dist/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/dist/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
- package/dist/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
- package/dist/spec/v0.2.7/core/agentgraph.md +324 -0
- package/dist/spec/v0.2.7/resources/agentgraph.yaml +135 -0
- package/dist/spec/v0.2.8/CHANGELOG.md +401 -0
- package/dist/spec/v0.2.8/README.md +72 -0
- package/dist/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/dist/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
- package/dist/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
- package/dist/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
- package/dist/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
- package/dist/types/index.d.ts +3 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/utils/index.d.ts +6 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +6 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/version.d.ts +68 -0
- package/dist/utils/version.d.ts.map +1 -0
- package/dist/utils/version.js +156 -0
- package/dist/utils/version.js.map +1 -0
- package/docs/brand-guide/01-brand-overview.md +37 -0
- package/docs/brand-guide/02-logo-usage.md +43 -0
- package/docs/brand-guide/03-color-palette.md +70 -0
- package/docs/brand-guide/04-typography.md +82 -0
- package/docs/brand-guide/05-voice-and-tone.md +108 -0
- package/docs/brand-guide/06-visual-elements.md +137 -0
- package/docs/brand-guide/07-application-examples.md +153 -0
- package/docs/brand-guide/OssaLogo/OssA_Logo.svg +21 -0
- package/docs/brand-guide/OssaLogo/brand.af +0 -0
- package/docs/brand-guide/README.md +107 -0
- package/docs/comparison.md +315 -0
- package/docs/operations/automation-roadmap.md +245 -0
- package/docs/operations/github-sync-strategy.md +357 -0
- package/eslint-report.json +1 -0
- package/examples/adk-integration/code-review-workflow.yml +1 -1
- package/examples/adk-integration/customer-support.yml +1 -1
- package/examples/adk-integration/data-pipeline.yml +1 -1
- package/examples/advanced/workflows/hybrid-model-strategy.yaml +1 -1
- package/examples/agent-manifests/critics/critic-agent.yaml +1 -1
- package/examples/agent-manifests/governors/governor-agent.yaml +1 -1
- package/examples/agent-manifests/integrators/integrator-agent.yaml +1 -1
- package/examples/agent-manifests/judges/judge-agent.yaml +1 -1
- package/examples/agent-manifests/monitors/monitor-agent.yaml +1 -1
- package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +1 -1
- package/examples/agent-manifests/sample-compliant-agent.yaml +1 -1
- package/examples/agent-manifests/workers/worker-agent.yaml +1 -1
- package/examples/anthropic/claude-assistant.ossa.json +5 -4
- package/examples/autogen/multi-agent.ossa.json +6 -4
- package/examples/claude-code/code-reviewer.ossa.yaml +78 -0
- package/examples/claude-code/ossa-validator.ossa.yaml +80 -0
- package/examples/common_npm/agent-router.ossa.yaml +1 -0
- package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +1 -1
- package/examples/crewai/research-team.ossa.json +14 -5
- package/examples/cursor/code-review-agent.ossa.json +21 -6
- package/examples/drupal/gitlab-ml-recommender.ossa.yaml +1 -0
- package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +1 -1
- package/examples/extensions/drupal-v1.yml +1 -1
- package/examples/extensions/kagent-v1.yml +1 -1
- package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
- package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
- package/examples/kagent/compliance-validator.ossa.yaml +1 -1
- package/examples/kagent/cost-optimizer.ossa.yaml +1 -1
- package/examples/kagent/documentation-agent.ossa.yaml +1 -1
- package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +1 -0
- package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +1 -1
- package/examples/kagent/k8s-troubleshooter.ossa.yaml +1 -1
- package/examples/kagent/security-scanner.ossa.yaml +1 -1
- package/examples/langchain/chain-agent.ossa.json +21 -5
- package/examples/langflow/workflow-agent.ossa.json +2 -3
- package/examples/langgraph/state-machine-agent.ossa.json +2 -3
- package/examples/llamaindex/rag-agent.ossa.json +2 -3
- package/examples/migration-guides/from-langchain-to-ossa.yaml +4 -4
- package/examples/multi-agent/README.md +74 -0
- package/examples/multi-agent/conditional-router.ossa.yaml +42 -0
- package/examples/multi-agent/parallel-execution.ossa.yaml +54 -0
- package/examples/multi-agent/sequential-pipeline.ossa.yaml +45 -0
- package/examples/openai/basic-agent.ossa.yaml +1 -1
- package/examples/openai/multi-tool-agent.ossa.json +33 -10
- package/examples/openai/swarm-agent.ossa.json +18 -5
- package/examples/production/document-analyzer-openai.yml +1 -1
- package/examples/quickstart/support-agent.ossa.yaml +1 -1
- package/examples/spec-examples/audit-agent.yml +1 -1
- package/examples/spec-examples/chat-agent.yml +1 -1
- package/examples/spec-examples/compliance-agent.yml +1 -1
- package/examples/spec-examples/monitoring-agent.yml +1 -1
- package/examples/spec-examples/workflow-agent.yml +1 -1
- package/examples/templates/ossa-compliance.yaml +1 -1
- package/examples/vercel/edge-agent.ossa.json +5 -4
- package/gl-code-quality-report.json +62 -0
- package/llms-ctx-full.txt +39 -0
- package/llms-ctx.txt +39 -0
- package/llms.txt +47 -0
- package/openapi/github-sync.yaml +115 -0
- package/package.json +26 -4
- package/scripts/README.md +103 -0
- package/scripts/auto-rebase-mrs.ts +106 -0
- package/scripts/batch-dependabot.sh +57 -0
- package/scripts/configure-gitlab-branch-protection.ts +95 -0
- package/scripts/create-issue-helper.ts +238 -0
- package/scripts/create-milestone-issue.ts +73 -0
- package/scripts/eslint-to-codequality.cjs +34 -0
- package/scripts/fix-schema-formats.js +82 -0
- package/scripts/generate-agents-catalog.ts +77 -0
- package/scripts/generate-api-docs.ts +218 -0
- package/scripts/generate-cli-docs.ts +410 -0
- package/scripts/generate-config-docs.ts +109 -0
- package/scripts/generate-errors-docs.ts +76 -0
- package/scripts/generate-examples-docs.ts +99 -0
- package/scripts/generate-llms-ctx.sh +17 -0
- package/scripts/generate-schema-docs.ts +317 -0
- package/scripts/generate-types-docs.ts +48 -0
- package/scripts/lowercase-docs.ts +43 -0
- package/scripts/manage-milestone-mrs.ts +279 -0
- package/scripts/rebase-all-mrs.sh +75 -0
- package/scripts/sync-github-pr.sh +48 -0
- package/scripts/sync-version.js +32 -0
- package/scripts/sync-wiki.sh +50 -0
- package/scripts/validate-all.js +127 -0
- package/scripts/validate-schema.ts +2 -1
- package/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
- package/spec/v0.2.6/CHANGELOG.md +401 -0
- package/spec/v0.2.6/README.md +72 -0
- package/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
- package/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
- package/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
- package/spec/v0.2.6-dev/CHANGELOG.md +164 -0
- package/spec/v0.2.6-dev/README.md +75 -0
- package/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
- package/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
- package/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
- package/spec/v0.2.7/core/agentgraph.md +324 -0
- package/spec/v0.2.7/resources/agentgraph.yaml +135 -0
- package/spec/v0.2.8/CHANGELOG.md +401 -0
- package/spec/v0.2.8/README.md +72 -0
- package/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
- package/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
- package/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
- package/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
- package/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
- package/test-results/junit.xml +299 -0
- package/.kiro/specs/agent-buildkit-templates/design.md +0 -495
- package/.kiro/specs/agent-buildkit-templates/requirements.md +0 -165
- package/.kiro/specs/kiro-ide-supercharger/README.md +0 -202
- package/.kiro/specs/kiro-ide-supercharger/design.md +0 -1005
- package/.kiro/specs/kiro-ide-supercharger/requirements.md +0 -141
- package/.kiro/specs/kiro-ide-supercharger/tasks.md +0 -507
- package/bin/validate-ossa-0.2.5-RC.ts +0 -244
- package/docs/issue-19-completion-summary.md +0 -648
- package/docs/issue-19-validation.md +0 -351
- package/scripts/lib/exec.ts +0 -37
- package/scripts/lib/file-ops.ts +0 -58
- package/scripts/lib/version.ts +0 -83
- package/website/.lighthouserc.ts +0 -24
- package/website/.prettierrc +0 -10
- package/website/Dockerfile +0 -30
- package/website/app/about/page.tsx +0 -295
- package/website/app/blog/[slug]/page.tsx +0 -208
- package/website/app/blog/page.tsx +0 -249
- package/website/app/design-guide/page.tsx +0 -511
- package/website/app/docs/[[...slug]]/page.tsx +0 -847
- package/website/app/docs/core-concepts/project-structure/page.tsx +0 -349
- package/website/app/ecosystem/page.tsx +0 -375
- package/website/app/examples/page.tsx +0 -133
- package/website/app/globals.scss +0 -135
- package/website/app/layout.tsx +0 -106
- package/website/app/license/page.tsx +0 -183
- package/website/app/not-found.tsx +0 -18
- package/website/app/page.tsx +0 -474
- package/website/app/playground/page.tsx +0 -487
- package/website/app/robots.ts +0 -19
- package/website/app/rss.xml/route.ts +0 -74
- package/website/app/schema/page.tsx +0 -1001
- package/website/app/sitemap.ts +0 -56
- package/website/app/specification/page.tsx +0 -287
- package/website/components/InstallCommand.tsx +0 -96
- package/website/components/Logo.tsx +0 -97
- package/website/components/StructuredData.tsx +0 -65
- package/website/components/docs/DocsSearch.tsx +0 -104
- package/website/components/docs/DocsSidebar.tsx +0 -155
- package/website/components/docs/MarkdownContent.tsx +0 -401
- package/website/components/docs/VersionSelector.tsx +0 -105
- package/website/components/examples/ExamplesViewer.tsx +0 -293
- package/website/components/layout/Footer.tsx +0 -116
- package/website/components/layout/Header.tsx +0 -168
- package/website/components/schema/SchemaComponentsAccordion.tsx +0 -84
- package/website/components/schema/SchemaExplorer.tsx +0 -213
- package/website/content/blog/OpenAPI-AI-Agents-Standard.md +0 -285
- package/website/content/blog/Why-Formal-Standards-Matter-Now.md +0 -198
- package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +0 -286
- package/website/content/blog/introducing-ossa-framework.md +0 -328
- package/website/content/blog/ossa-production-results.md +0 -279
- package/website/content/blog/welcome-to-ossa.md +0 -43
- package/website/content/blog/why-ai-agents-need-open-standard.md +0 -98
- package/website/content/docs/00-HOME.md +0 -153
- package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +0 -107
- package/website/content/docs/Examples.md +0 -71
- package/website/content/docs/OpenAPI-Extensions.md +0 -934
- package/website/content/docs/adapters/openai-adapter.md +0 -693
- package/website/content/docs/architecture/execution-flow.md +0 -335
- package/website/content/docs/architecture/multi-agent-systems.md +0 -737
- package/website/content/docs/architecture/overview.md +0 -121
- package/website/content/docs/architecture/stack-integration.md +0 -461
- package/website/content/docs/changelog.md +0 -246
- package/website/content/docs/contributing.md +0 -599
- package/website/content/docs/core-concepts/Project-Structure.md +0 -348
- package/website/content/docs/ecosystem/framework-support.md +0 -819
- package/website/content/docs/ecosystem/overview.md +0 -366
- package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md +0 -107
- package/website/content/docs/examples/Migration-Guides.md +0 -214
- package/website/content/docs/for-audiences/Architects.md +0 -224
- package/website/content/docs/for-audiences/Developers.md +0 -220
- package/website/content/docs/for-audiences/Enterprises.md +0 -256
- package/website/content/docs/for-audiences/Students-Researchers.md +0 -122
- package/website/content/docs/getting-started/5-Minute-Overview.md +0 -85
- package/website/content/docs/getting-started/First-Agent.md +0 -196
- package/website/content/docs/getting-started/Hello-World.md +0 -184
- package/website/content/docs/getting-started/Installation.md +0 -155
- package/website/content/docs/getting-started/index.md +0 -92
- package/website/content/docs/getting-started/running-agents.md +0 -309
- package/website/content/docs/getting-started.md +0 -91
- package/website/content/docs/integrations/aiflow.md +0 -104
- package/website/content/docs/integrations/drupal.md +0 -105
- package/website/content/docs/migration-guides/00-INDEX.md +0 -76
- package/website/content/docs/migration-guides/README.md +0 -133
- package/website/content/docs/migration-guides/agent-schema-comparison.md +0 -232
- package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +0 -1750
- package/website/content/docs/migration-guides/crewai-to-ossa.md +0 -274
- package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +0 -2017
- package/website/content/docs/migration-guides/general-agent-schema.yml +0 -247
- package/website/content/docs/migration-guides/index.md +0 -133
- package/website/content/docs/migration-guides/langchain-to-ossa.md +0 -1714
- package/website/content/docs/migration-guides/langflow-to-ossa.md +0 -2075
- package/website/content/docs/migration-guides/migration-manifest.json +0 -64
- package/website/content/docs/migration-guides/openai-to-ossa.md +0 -1202
- package/website/content/docs/openapi-extensions/examples.md +0 -550
- package/website/content/docs/openapi-extensions/index.md +0 -551
- package/website/content/docs/openapi-extensions/operation-extensions.md +0 -457
- package/website/content/docs/openapi-extensions/root-extensions.md +0 -410
- package/website/content/docs/ossa-compliant-badge.md +0 -251
- package/website/content/docs/pre-release/index.md +0 -175
- package/website/content/docs/quick-reference.md +0 -17
- package/website/content/docs/readme.md +0 -35
- package/website/content/docs/schema-reference/agent-spec.md +0 -406
- package/website/content/docs/schema-reference/autonomy.md +0 -568
- package/website/content/docs/schema-reference/constraints.md +0 -543
- package/website/content/docs/schema-reference/index.md +0 -176
- package/website/content/docs/schema-reference/llm-config.md +0 -445
- package/website/content/docs/schema-reference/observability.md +0 -654
- package/website/content/docs/schema-reference/ossa-manifest.md +0 -309
- package/website/content/docs/schema-reference/taxonomy.md +0 -509
- package/website/content/docs/schema-reference/tools.md +0 -628
- package/website/content/docs/templates/blog-post.md +0 -43
- package/website/content/docs/use-cases/00-index.md +0 -395
- package/website/content/docs/use-cases/cicd-code-review.md +0 -1236
- package/website/content/docs/use-cases/customer-support.md +0 -1234
- package/website/content/docs/use-cases/enterprise-compliance.md +0 -1208
- package/website/content/docs/use-cases/research-multi-agent.md +0 -1161
- package/website/content/docs/versioning.md +0 -288
- package/website/lib/version.ts +0 -35
- package/website/lib/versions.json +0 -78
- package/website/next.config.ts +0 -18
- package/website/nginx.conf +0 -32
- package/website/package-lock.json +0 -9679
- package/website/package.json +0 -59
- package/website/postcss.config.mjs +0 -9
- package/website/scripts/fetch-versions.js +0 -166
- package/website/scripts/generate-examples-index.js +0 -163
- package/website/scripts/merge-docs-to-wiki.ts +0 -207
- package/website/scripts/sync-version.js +0 -72
- package/website/scripts/sync-wiki.ts +0 -322
- package/website/scripts/upload-wiki.ts +0 -199
- package/website/styles/_variables.scss +0 -36
- package/website/tailwind.config.ts +0 -136
- /package/dist/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
- /package/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
package/README.md
CHANGED
|
@@ -1,357 +1,294 @@
|
|
|
1
1
|
# OSSA - Open Standard for Scalable AI Agents
|
|
2
2
|
|
|
3
|
-
**The OpenAPI for AI Agents**
|
|
3
|
+
> **The OpenAPI for AI Agents**
|
|
4
|
+
>
|
|
5
|
+
> - **🐙 GitHub**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
|
|
6
|
+
> - **📦 npm**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
|
|
7
|
+
> - **🌐 Website**: [openstandardagents.org](https://openstandardagents.org)
|
|
8
|
+
> - **💬 Discord**: [Join our community](https://discord.gg/ossa)
|
|
9
|
+
|
|
10
|
+
---
|
|
4
11
|
|
|
5
12
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
6
13
|
[](https://www.npmjs.com/package/@bluefly/openstandardagents)
|
|
7
|
-
[](https://github.com/blueflyio/openstandardagents)
|
|
8
14
|
[](https://github.com/blueflyio/openstandardagents)
|
|
9
|
-
|
|
15
|
+
|
|
16
|
+
**Vendor-neutral, compliance-ready, enterprise-grade**
|
|
17
|
+
|
|
18
|
+
- ✅ Switch between AI providers without code changes
|
|
19
|
+
- ✅ Built-in compliance and security frameworks
|
|
20
|
+
- ✅ Standardized agent lifecycle and governance
|
|
21
|
+
- ✅ Multi-runtime support (Node.js, Python, more)
|
|
10
22
|
|
|
11
23
|
---
|
|
12
24
|
|
|
13
25
|
## What is OSSA?
|
|
14
26
|
|
|
15
|
-
**
|
|
27
|
+
**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.
|
|
16
28
|
|
|
17
|
-
|
|
29
|
+
### OSSA is NOT a Framework
|
|
18
30
|
|
|
19
|
-
|
|
31
|
+
OSSA is a **specification standard** that defines the contract for agent definition, deployment, and management.
|
|
20
32
|
|
|
21
|
-
|
|
22
|
-
- **Vendor-Neutral** - Community-driven, not controlled by any single company
|
|
23
|
-
- **Interoperable** - Common language enabling diverse AI agents to work together
|
|
24
|
-
- **Trustworthy** - Built with compliance and security in mind
|
|
25
|
-
- **Open** - Collaborative effort for the "Internet of Agents"
|
|
33
|
+
Just like OpenAPI doesn't implement APIs, OSSA doesn't implement agents. It provides the standard that implementations follow.
|
|
26
34
|
|
|
27
|
-
|
|
28
|
-
|-----------|------|---------------|
|
|
29
|
-
| OSSA Specification | Standard definition | OpenAPI Specification |
|
|
30
|
-
| OSSA CLI | Validation & generation | OpenAPI Generator (minimal) |
|
|
31
|
-
| agent-buildkit | Reference implementation | Kong API Gateway |
|
|
32
|
-
| OSSA Registry | Agent distribution | npm Registry |
|
|
35
|
+
### Why Does This Matter?
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
**Portability: Avoid Vendor Lock-in**
|
|
38
|
+
Switch between AI providers (OpenAI, Anthropic, Azure) without rewriting code. Define your agent once in OSSA format, deploy anywhere.
|
|
39
|
+
|
|
40
|
+
**Regulatory Compliance: Built-in Frameworks**
|
|
41
|
+
Meet SOC2, FedRAMP, HIPAA, and GDPR requirements with standardized security models, audit trails, and data boundary controls.
|
|
35
42
|
|
|
36
|
-
|
|
43
|
+
**Vendor Independence: True Interoperability**
|
|
44
|
+
Community-driven standard, not controlled by any single company. Works with LangChain, CrewAI, AutoGen, and any framework.
|
|
37
45
|
|
|
38
|
-
|
|
39
|
-
2. **Implementation-Agnostic** - Any runtime can implement it
|
|
40
|
-
3. **Minimal Tooling** - Basic CLI for validation & generation
|
|
41
|
-
4. **No Vendor Lock-in** - Deploy to any infrastructure
|
|
46
|
+
**One standard. Any framework. True portability.**
|
|
42
47
|
|
|
43
48
|
---
|
|
44
49
|
|
|
45
|
-
##
|
|
50
|
+
## Get Started in Minutes
|
|
46
51
|
|
|
47
|
-
###
|
|
52
|
+
### 1. Install CLI
|
|
48
53
|
|
|
49
54
|
```bash
|
|
50
55
|
npm install -g @bluefly/openstandardagents
|
|
51
56
|
```
|
|
52
57
|
|
|
53
|
-
### Create Agent
|
|
58
|
+
### 2. Create Agent
|
|
54
59
|
|
|
55
60
|
```bash
|
|
56
|
-
ossa
|
|
57
|
-
|
|
61
|
+
ossa init my-agent
|
|
62
|
+
cd my-agent
|
|
58
63
|
```
|
|
59
64
|
|
|
60
|
-
### Validate
|
|
65
|
+
### 3. Validate
|
|
61
66
|
|
|
62
67
|
```bash
|
|
63
|
-
ossa validate agent.
|
|
68
|
+
ossa validate my-agent.ossa.yaml
|
|
64
69
|
```
|
|
65
70
|
|
|
66
|
-
### Run
|
|
71
|
+
### 4. Run
|
|
67
72
|
|
|
68
73
|
```bash
|
|
69
74
|
# Set your API key
|
|
70
75
|
export OPENAI_API_KEY=sk-your-key-here
|
|
71
76
|
|
|
72
77
|
# Run interactively
|
|
73
|
-
ossa run agent.ossa.yaml
|
|
74
|
-
|
|
75
|
-
# Or send a single message
|
|
76
|
-
ossa run agent.ossa.yaml -m "Hello, how can you help me?"
|
|
77
|
-
|
|
78
|
-
# With verbose output
|
|
79
|
-
ossa run agent.ossa.yaml -v
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
### Deploy
|
|
83
|
-
|
|
84
|
-
Deploy to **YOUR** infrastructure:
|
|
85
|
-
- AWS, GCP, Azure
|
|
86
|
-
- Kubernetes, Docker
|
|
87
|
-
- On-premise
|
|
88
|
-
- Serverless
|
|
89
|
-
|
|
90
|
-
OSSA doesn't care - it's just a standard.
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## OSSA CLI (Minimal Tooling)
|
|
95
|
-
|
|
96
|
-
The OSSA CLI provides basic tooling:
|
|
97
|
-
|
|
98
|
-
```bash
|
|
99
|
-
ossa validate <path> # Validate against OSSA schema
|
|
100
|
-
ossa generate <type> # Generate agent from template (chat, workflow, compliance, etc.)
|
|
101
|
-
ossa migrate <source> # Migrate between OSSA versions
|
|
102
|
-
ossa run <path> # Run agents with OpenAI adapter
|
|
78
|
+
ossa run my-agent.ossa.yaml
|
|
103
79
|
```
|
|
104
80
|
|
|
105
|
-
|
|
106
|
-
- Validate agent manifests
|
|
107
|
-
- Generate project scaffolding
|
|
108
|
-
- Provide templates
|
|
109
|
-
- Run agents interactively (OpenAI adapter)
|
|
110
|
-
|
|
111
|
-
**What OSSA CLI does NOT do:**
|
|
112
|
-
- Runtime orchestration
|
|
113
|
-
- Deployment
|
|
114
|
-
- Production monitoring
|
|
115
|
-
- Infrastructure management
|
|
116
|
-
|
|
117
|
-
For production features, see [Agent Buildkit](https://github.com/blueflyio/agent-buildkit).
|
|
118
|
-
|
|
119
|
-
### Running Agents
|
|
120
|
-
|
|
121
|
-
The `ossa run` command allows you to execute agents using the OpenAI adapter:
|
|
81
|
+
### 5. Export to Any Framework
|
|
122
82
|
|
|
123
83
|
```bash
|
|
124
|
-
|
|
125
|
-
ossa
|
|
126
|
-
|
|
127
|
-
# Single message mode
|
|
128
|
-
ossa run my-agent.ossa.yaml -m "What is the weather today?"
|
|
129
|
-
|
|
130
|
-
# Verbose output (show tool calls)
|
|
131
|
-
ossa run my-agent.ossa.yaml -v
|
|
132
|
-
|
|
133
|
-
# Custom options
|
|
134
|
-
ossa run my-agent.ossa.yaml --max-turns 20 --no-validate
|
|
84
|
+
ossa export --to cursor
|
|
85
|
+
ossa export --to langchain
|
|
86
|
+
ossa export --to crewai
|
|
135
87
|
```
|
|
136
88
|
|
|
137
|
-
|
|
138
|
-
- Interactive REPL mode for conversations
|
|
139
|
-
- Single message mode for quick queries
|
|
140
|
-
- Tool execution with custom handlers
|
|
141
|
-
- Verbose mode for debugging
|
|
142
|
-
- Configurable max turns to prevent loops
|
|
143
|
-
|
|
144
|
-
**Requirements:**
|
|
145
|
-
- OpenAI API key: `export OPENAI_API_KEY=sk-...`
|
|
146
|
-
- Valid OSSA manifest (YAML or JSON)
|
|
147
|
-
|
|
148
|
-
See [Running Agents Guide](https://openstandardagents.org/docs/getting-started/running-agents) for more details.
|
|
89
|
+
[Read Full Getting Started Guide](https://openstandardagents.org/docs/getting-started/)
|
|
149
90
|
|
|
150
91
|
---
|
|
151
92
|
|
|
152
|
-
##
|
|
153
|
-
|
|
154
|
-
OSSA v0.2.5-RC Schema: [`spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json`](spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
|
|
155
|
-
|
|
156
|
-
### Required Fields
|
|
93
|
+
## Minimal Example
|
|
157
94
|
|
|
158
95
|
```yaml
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
name:
|
|
164
|
-
version: "1.0.0"
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
96
|
+
apiVersion: ossa/v0.2.8
|
|
97
|
+
kind: Agent
|
|
98
|
+
|
|
99
|
+
metadata:
|
|
100
|
+
name: my-agent
|
|
101
|
+
version: "1.0.0"
|
|
102
|
+
description: My first OSSA agent
|
|
103
|
+
|
|
104
|
+
spec:
|
|
105
|
+
role: |
|
|
106
|
+
You are a helpful assistant that answers questions.
|
|
107
|
+
|
|
108
|
+
llm:
|
|
109
|
+
provider: openai
|
|
110
|
+
model: gpt-4
|
|
111
|
+
|
|
112
|
+
tools:
|
|
113
|
+
- type: function
|
|
114
|
+
name: get_weather
|
|
115
|
+
capabilities:
|
|
116
|
+
- name: get_current_weather
|
|
117
|
+
description: Get current weather for a location
|
|
118
|
+
input_schema:
|
|
119
|
+
type: object
|
|
120
|
+
properties:
|
|
121
|
+
location:
|
|
122
|
+
type: string
|
|
123
|
+
required: [location]
|
|
175
124
|
```
|
|
176
125
|
|
|
177
|
-
Full schema documentation: [`docs/specification/`](docs/specification/)
|
|
178
|
-
|
|
179
126
|
---
|
|
180
127
|
|
|
181
|
-
##
|
|
182
|
-
|
|
183
|
-
**NEW**: Complete production ecosystem with **8 specialized agents** for GitLab-integrated Kubernetes deployments.
|
|
184
|
-
|
|
185
|
-
[**View Full Documentation**](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
|
|
186
|
-
|
|
187
|
-
### Highlights
|
|
128
|
+
## Why OSSA?
|
|
188
129
|
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
- **Elite DORA metrics**: 12 deployments/day, 45min lead time, 8.5% change failure rate
|
|
192
|
-
- **Massive ROI**: $80-145K/month cost savings (31-57x return)
|
|
193
|
-
- **Full compliance**: SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP
|
|
130
|
+
### Framework-Agnostic
|
|
131
|
+
Works with LangChain, Anthropic, OpenAI, CrewAI, Langflow, AutoGen, and more. No vendor lock-in.
|
|
194
132
|
|
|
195
|
-
###
|
|
133
|
+
### Portable
|
|
134
|
+
Move agents between teams, organizations, and infrastructures without rewriting code.
|
|
196
135
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
kubectl apply -f .gitlab/agents/mesh-config.yaml
|
|
200
|
-
|
|
201
|
-
# Deploy all 8 agents
|
|
202
|
-
for agent in security-scanner performance-optimizer db-migrator \
|
|
203
|
-
config-validator monitoring-agent rollback-coordinator \
|
|
204
|
-
cost-analyzer compliance-auditor; do
|
|
205
|
-
buildkit agents deploy .gitlab/agents/$agent/manifest.ossa.yaml
|
|
206
|
-
done
|
|
207
|
-
```
|
|
136
|
+
### Validatable
|
|
137
|
+
JSON Schema validation ensures correctness before deployment. Catch errors early.
|
|
208
138
|
|
|
209
|
-
|
|
139
|
+
### Well-Documented
|
|
140
|
+
Comprehensive documentation, examples, and tooling. Built for developers, by developers.
|
|
210
141
|
|
|
211
|
-
|
|
142
|
+
### Open Source
|
|
143
|
+
Apache 2.0 licensed. Community-driven. Transparent development process.
|
|
212
144
|
|
|
213
|
-
|
|
145
|
+
### Fast Integration
|
|
146
|
+
Export to any framework format. Import existing agents. Seamless migration paths.
|
|
214
147
|
|
|
215
|
-
|
|
148
|
+
### Secure by Design
|
|
149
|
+
Built-in security patterns, authentication, and compliance features.
|
|
216
150
|
|
|
217
|
-
|
|
218
|
-
-
|
|
219
|
-
- `workflow-agent.yml` - Workflow orchestration
|
|
220
|
-
- **GitLab K8s Ecosystem** - Production-ready multi-agent system (see above)
|
|
151
|
+
### Observable
|
|
152
|
+
Built-in observability, logging, and monitoring. Track agent performance and behavior.
|
|
221
153
|
|
|
222
154
|
---
|
|
223
155
|
|
|
224
|
-
##
|
|
156
|
+
## Works With Your Favorite Tools
|
|
225
157
|
|
|
226
|
-
|
|
158
|
+
OSSA integrates seamlessly with leading AI frameworks, platforms, and tools:
|
|
227
159
|
|
|
228
|
-
**
|
|
229
|
-
- JSON Schema specification
|
|
230
|
-
- CLI for validation & generation
|
|
231
|
-
- Reference implementations
|
|
232
|
-
- Documentation
|
|
160
|
+
**LLM Providers**: OpenAI, Anthropic, Google Gemini, Azure OpenAI, Ollama
|
|
233
161
|
|
|
234
|
-
**
|
|
235
|
-
- Modern, fast, minimal CLI
|
|
236
|
-
- GitLab integration
|
|
237
|
-
- Kubernetes deployment
|
|
238
|
-
- Production monitoring
|
|
162
|
+
**Frameworks**: LangChain, CrewAI, AutoGen, LlamaIndex, LangGraph, Langflow
|
|
239
163
|
|
|
240
|
-
**
|
|
241
|
-
- macOS-aligned design
|
|
242
|
-
- Visual workflow design
|
|
243
|
-
- Agent monitoring and debugging
|
|
244
|
-
- End-to-end agent lifecycle management
|
|
164
|
+
**Platforms**: Kubernetes, Docker, AWS, Azure, GCP
|
|
245
165
|
|
|
246
|
-
|
|
166
|
+
**Tools**: MCP, Drupal, LibreChat, Cursor, VS Code
|
|
247
167
|
|
|
248
|
-
All
|
|
249
|
-
- **OSSA** defines the standard
|
|
250
|
-
- **Agent Buildkit** provides CLI tooling
|
|
251
|
-
- **Agent Studio** offers visual management
|
|
252
|
-
|
|
253
|
-
Together, they form a complete ecosystem for AI agent development, deployment, and management.
|
|
254
|
-
|
|
255
|
-
**Others welcome** - OSSA is an open standard, anyone can implement it.
|
|
168
|
+
[View All Integrations](https://openstandardagents.org/docs/ecosystem/framework-support/)
|
|
256
169
|
|
|
257
170
|
---
|
|
258
171
|
|
|
259
|
-
##
|
|
172
|
+
## Examples
|
|
260
173
|
|
|
261
|
-
|
|
174
|
+
We provide comprehensive examples for all major frameworks:
|
|
262
175
|
|
|
263
|
-
|
|
264
|
-
- **No Vendor Lock-in** - Use any implementation
|
|
265
|
-
- **Deploy Anywhere** - Your infrastructure, your choice
|
|
266
|
-
- **Clear Specification** - Well-defined contract
|
|
176
|
+
### Framework Integration Examples
|
|
267
177
|
|
|
268
|
-
|
|
178
|
+
- **OpenAI** - [examples/openai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/openai)
|
|
179
|
+
- **Anthropic** - [examples/anthropic/](https://github.com/blueflyio/openstandardagents/tree/main/examples/anthropic)
|
|
180
|
+
- **LangChain** - [examples/langchain/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langchain)
|
|
181
|
+
- **CrewAI** - [examples/crewai/](https://github.com/blueflyio/openstandardagents/tree/main/examples/crewai)
|
|
182
|
+
- **AutoGen** - [examples/autogen/](https://github.com/blueflyio/openstandardagents/tree/main/examples/autogen)
|
|
183
|
+
- **LlamaIndex** - [examples/llamaindex/](https://github.com/blueflyio/openstandardagents/tree/main/examples/llamaindex)
|
|
184
|
+
- **LangGraph** - [examples/langgraph/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langgraph)
|
|
185
|
+
- **Langflow** - [examples/langflow/](https://github.com/blueflyio/openstandardagents/tree/main/examples/langflow)
|
|
186
|
+
- **Vercel AI** - [examples/vercel/](https://github.com/blueflyio/openstandardagents/tree/main/examples/vercel)
|
|
187
|
+
- **Cursor** - [examples/cursor/](https://github.com/blueflyio/openstandardagents/tree/main/examples/cursor)
|
|
269
188
|
|
|
270
|
-
|
|
271
|
-
- **Reference Implementation** - Agent Buildkit shows the way
|
|
272
|
-
- **Clear Boundaries** - Standard vs. implementation
|
|
189
|
+
### Production Examples
|
|
273
190
|
|
|
274
|
-
|
|
191
|
+
**GitLab Kubernetes Ecosystem** - [.gitlab/agents/](https://github.com/blueflyio/openstandardagents/tree/main/.gitlab/agents)
|
|
192
|
+
- 8 specialized agents for production Kubernetes deployments
|
|
193
|
+
- Security, Performance, Database, Config, Monitoring, Rollback, Cost, Compliance
|
|
194
|
+
- Full documentation: [Wiki](https://github.com/blueflyio/openstandardagents/wiki/OSSA-Agent-Ecosystem-for-GitLab-Kubernetes-Deployments)
|
|
275
195
|
|
|
276
|
-
|
|
196
|
+
[View All Examples](https://openstandardagents.org/examples/)
|
|
277
197
|
|
|
278
|
-
|
|
198
|
+
---
|
|
279
199
|
|
|
280
|
-
|
|
281
|
-
npm install -g @bluefly/openstandardagents
|
|
282
|
-
ossa validate my-agent.yml
|
|
283
|
-
```
|
|
200
|
+
## Documentation
|
|
284
201
|
|
|
285
|
-
###
|
|
202
|
+
### Official Website
|
|
286
203
|
|
|
287
|
-
|
|
288
|
-
npm install -g @bluefly/agent-buildkit
|
|
289
|
-
buildkit ossa validate my-agent.yml # Uses OSSA + adds features
|
|
290
|
-
buildkit ossa sync-docs # GitLab integration
|
|
291
|
-
```
|
|
204
|
+
**Live Website**: [openstandardagents.org](https://openstandardagents.org)
|
|
292
205
|
|
|
293
|
-
|
|
206
|
+
Features:
|
|
207
|
+
- **Interactive Documentation** - Complete OSSA specification
|
|
208
|
+
- **Schema Validator** - Validate your manifests in the browser
|
|
209
|
+
- **Playground** - Test agents interactively
|
|
210
|
+
- **Migration Guides** - From LangChain, MCP, OpenAI Swarm, CrewAI, Langflow, Drupal ECA
|
|
294
211
|
|
|
295
|
-
|
|
212
|
+
### Resources
|
|
296
213
|
|
|
297
|
-
|
|
214
|
+
- **Getting Started**: [openstandardagents.org/docs/getting-started/](https://openstandardagents.org/docs/getting-started/)
|
|
215
|
+
- **Full Documentation**: [openstandardagents.org/docs/](https://openstandardagents.org/docs/)
|
|
216
|
+
- **Schema Reference**: [openstandardagents.org/schema/](https://openstandardagents.org/schema/)
|
|
217
|
+
- **Specification**: [spec/v0.2.8/ossa-0.2.8.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.8/ossa-0.2.8.schema.json)
|
|
218
|
+
- **Examples**: [openstandardagents.org/examples/](https://openstandardagents.org/examples/)
|
|
219
|
+
- **Blog**: [openstandardagents.org/blog/](https://openstandardagents.org/blog/)
|
|
298
220
|
|
|
299
|
-
|
|
221
|
+
---
|
|
300
222
|
|
|
301
|
-
|
|
302
|
-
- **Interactive Documentation** - Browse the complete OSSA wiki with an enhanced UI
|
|
303
|
-
- **GitLab Wiki Integration** - Automatically synced from the official GitLab wiki
|
|
304
|
-
- **Interactive Examples** - Explore OSSA manifests with live validation and URL tracking
|
|
305
|
-
- **Schema Validator** - Validate your OSSA manifests in the browser
|
|
306
|
-
- **Migration Guides** - Step-by-step guides from 6 major frameworks
|
|
307
|
-
- **Responsive Design** - Beautiful, accessible UI built with Next.js 15 and Tailwind CSS
|
|
223
|
+
## How OSSA Compares
|
|
308
224
|
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
-
|
|
314
|
-
|
|
315
|
-
|
|
225
|
+
| Feature | OSSA | LangChain | AutoGen | MCP | Semantic Kernel |
|
|
226
|
+
|---------|------|-----------|---------|-----|-----------------|
|
|
227
|
+
| Vendor Neutral | ✅ | ❌ | ❌ | ✅ | ❌ |
|
|
228
|
+
| Formal Standard | ✅ | ❌ | ❌ | ✅ | ❌ |
|
|
229
|
+
| Multi-runtime | ✅ | ⚠️ | ⚠️ | ✅ | ⚠️ |
|
|
230
|
+
| Enterprise Governance | ✅ | ❌ | ❌ | ❌ | ⚠️ |
|
|
231
|
+
| Compliance Ready | ✅ | ❌ | ❌ | ❌ | ❌ |
|
|
232
|
+
| Open Source | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
316
233
|
|
|
317
|
-
|
|
234
|
+
**OSSA**: Vendor-neutral specification standard
|
|
235
|
+
**LangChain/AutoGen/Semantic Kernel**: Framework-specific implementations
|
|
236
|
+
**MCP**: Formal standard focused on context, not full agent lifecycle
|
|
318
237
|
|
|
319
|
-
- **Specification**: [spec/v0.2.
|
|
238
|
+
- **Specification**: [spec/v0.2.8/ossa-0.2.8.schema.json](spec/v0.2.8/ossa-0.2.8.schema.json)
|
|
320
239
|
- **Examples**: [examples/](examples/)
|
|
321
240
|
- **API Reference**: [docs/](docs/)
|
|
241
|
+
- **Deployment Guides**: [GitHub Mirroring](https://openstandardagents.org/docs/deployment/github-mirroring)
|
|
322
242
|
- **GitHub Issues**: https://github.com/blueflyio/openstandardagents/issues
|
|
323
243
|
|
|
324
244
|
---
|
|
325
245
|
|
|
326
246
|
## Contributing
|
|
327
247
|
|
|
328
|
-
OSSA is an open
|
|
248
|
+
OSSA is an open-source, community-driven project. We welcome contributions!
|
|
249
|
+
|
|
250
|
+
**Repository**: [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
|
|
251
|
+
**Issues**: [github.com/blueflyio/openstandardagents/issues](https://github.com/blueflyio/openstandardagents/issues)
|
|
252
|
+
**Discussions**: [github.com/blueflyio/openstandardagents/discussions](https://github.com/blueflyio/openstandardagents/discussions)
|
|
329
253
|
|
|
330
|
-
|
|
331
|
-
**Homepage**: https://openstandardagents.org
|
|
332
|
-
**Issues**: https://github.com/blueflyio/openstandardagents/issues
|
|
254
|
+
### How to Contribute
|
|
333
255
|
|
|
334
256
|
1. Fork the repository on GitHub
|
|
335
|
-
2. Create feature branch
|
|
336
|
-
3.
|
|
257
|
+
2. Create a feature branch
|
|
258
|
+
3. Make your changes
|
|
259
|
+
4. Submit a pull request
|
|
337
260
|
|
|
338
|
-
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
261
|
+
See [CONTRIBUTING.md](https://github.com/blueflyio/openstandardagents/blob/main/CONTRIBUTING.md) for detailed guidelines.
|
|
262
|
+
|
|
263
|
+
### Ways to Contribute
|
|
264
|
+
|
|
265
|
+
- **Code** - Improve the CLI, add examples, fix bugs
|
|
266
|
+
- **Documentation** - Improve docs, write tutorials
|
|
267
|
+
- **Examples** - Add framework integrations
|
|
268
|
+
- **Feedback** - Report issues, suggest features
|
|
269
|
+
- **Community** - Help others, answer questions
|
|
339
270
|
|
|
340
271
|
---
|
|
341
272
|
|
|
342
|
-
##
|
|
273
|
+
## Community
|
|
274
|
+
|
|
275
|
+
Join our growing community:
|
|
343
276
|
|
|
344
|
-
|
|
277
|
+
- **Discord**: [Join our community](https://discord.gg/ossa)
|
|
278
|
+
- **GitHub Discussions**: [github.com/blueflyio/openstandardagents/discussions](https://github.com/blueflyio/openstandardagents/discussions)
|
|
279
|
+
- **GitHub Issues**: [github.com/blueflyio/openstandardagents/issues](https://github.com/blueflyio/openstandardagents/issues)
|
|
345
280
|
|
|
346
281
|
---
|
|
347
282
|
|
|
348
|
-
##
|
|
283
|
+
## License
|
|
284
|
+
|
|
285
|
+
Apache 2.0 - see [LICENSE](https://github.com/blueflyio/openstandardagents/blob/main/LICENSE) for details.
|
|
286
|
+
|
|
287
|
+
---
|
|
349
288
|
|
|
350
|
-
|
|
289
|
+
## About
|
|
351
290
|
|
|
352
|
-
|
|
353
|
-
- **Agent Buildkit** - CLI for building and managing agents
|
|
354
|
-
- **Agent Studio** - GUI platform for agent orchestration
|
|
291
|
+
Open Standard Agents (OSSA) is a vendor-neutral specification created by Thomas Scola, founder of Bluefly.io.
|
|
355
292
|
|
|
356
293
|
**OSSA: Open. Interoperable. Trustworthy.**
|
|
357
294
|
|
package/bin/ossa-dev
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { spawn } from 'child_process';
|
|
4
|
+
import { watch } from 'fs';
|
|
5
|
+
import { resolve } from 'path';
|
|
6
|
+
|
|
7
|
+
const args = process.argv.slice(2);
|
|
8
|
+
const agentPath = args[0] || './agent.yaml';
|
|
9
|
+
const port = args[1] || '3000';
|
|
10
|
+
|
|
11
|
+
let server;
|
|
12
|
+
|
|
13
|
+
function startServer() {
|
|
14
|
+
if (server) server.kill();
|
|
15
|
+
|
|
16
|
+
console.log(`\n🚀 Starting OSSA agent: ${agentPath}`);
|
|
17
|
+
server = spawn('node', ['--loader', 'tsx', '-e', `
|
|
18
|
+
import { readFileSync } from 'fs';
|
|
19
|
+
import { createServer } from 'http';
|
|
20
|
+
|
|
21
|
+
const agent = readFileSync('${agentPath}', 'utf-8');
|
|
22
|
+
|
|
23
|
+
createServer((req, res) => {
|
|
24
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
25
|
+
res.end(JSON.stringify({ status: 'ok', agent: '${agentPath}' }));
|
|
26
|
+
}).listen(${port}, () => {
|
|
27
|
+
console.log('✓ Agent running on http://localhost:${port}');
|
|
28
|
+
});
|
|
29
|
+
`], { stdio: 'inherit' });
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
watch(resolve(agentPath), () => {
|
|
33
|
+
console.log('📝 Agent config changed, reloading...');
|
|
34
|
+
startServer();
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
startServer();
|
|
38
|
+
|
|
39
|
+
process.on('SIGINT', () => {
|
|
40
|
+
if (server) server.kill();
|
|
41
|
+
process.exit(0);
|
|
42
|
+
});
|
package/bin/ossa-export
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* OSSA Export Utility
|
|
5
|
+
* Quick export of OSSA manifests to various formats
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
const { execSync } = require('child_process');
|
|
9
|
+
const path = require('path');
|
|
10
|
+
|
|
11
|
+
const args = process.argv.slice(2);
|
|
12
|
+
const format = args[0];
|
|
13
|
+
const file = args[1];
|
|
14
|
+
|
|
15
|
+
if (!format || !file) {
|
|
16
|
+
console.log('Usage: ossa-export <format> <file>');
|
|
17
|
+
console.log('');
|
|
18
|
+
console.log('Formats:');
|
|
19
|
+
console.log(' cursor - Export to Cursor AI format');
|
|
20
|
+
console.log(' langchain - Export to LangChain format');
|
|
21
|
+
console.log(' openai - Export to OpenAI Assistants format');
|
|
22
|
+
console.log(' anthropic - Export to Anthropic Claude format');
|
|
23
|
+
console.log('');
|
|
24
|
+
console.log('Example: ossa-export cursor my-agent.ossa.yaml');
|
|
25
|
+
process.exit(1);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
try {
|
|
29
|
+
execSync(`ossa export --to ${format} ${file}`, { stdio: 'inherit' });
|
|
30
|
+
} catch (error) {
|
|
31
|
+
process.exit(1);
|
|
32
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { writeFileSync, mkdirSync } from 'fs';
|
|
4
|
+
import { join } from 'path';
|
|
5
|
+
|
|
6
|
+
const [type, name] = process.argv.slice(2);
|
|
7
|
+
|
|
8
|
+
if (!type || !name) {
|
|
9
|
+
console.log('Usage: ossa-generate <agent|adapter> <name>');
|
|
10
|
+
process.exit(1);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
const templates = {
|
|
14
|
+
agent: `apiVersion: ossa.ai/v0.2.6
|
|
15
|
+
kind: Agent
|
|
16
|
+
metadata:
|
|
17
|
+
name: ${name}
|
|
18
|
+
version: 1.0.0
|
|
19
|
+
spec:
|
|
20
|
+
description: ${name} agent
|
|
21
|
+
capabilities:
|
|
22
|
+
- text-generation
|
|
23
|
+
interface:
|
|
24
|
+
input:
|
|
25
|
+
type: object
|
|
26
|
+
properties:
|
|
27
|
+
prompt:
|
|
28
|
+
type: string
|
|
29
|
+
output:
|
|
30
|
+
type: object
|
|
31
|
+
properties:
|
|
32
|
+
response:
|
|
33
|
+
type: string
|
|
34
|
+
`,
|
|
35
|
+
adapter: `import { Adapter } from '@ossa/core';
|
|
36
|
+
|
|
37
|
+
export class ${name.charAt(0).toUpperCase() + name.slice(1)}Adapter implements Adapter {
|
|
38
|
+
async execute(input: any): Promise<any> {
|
|
39
|
+
// Implementation
|
|
40
|
+
return { result: 'success' };
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
`
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
if (!templates[type]) {
|
|
47
|
+
console.log('❌ Unknown type. Use: agent or adapter');
|
|
48
|
+
process.exit(1);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
const ext = type === 'agent' ? 'yaml' : 'ts';
|
|
52
|
+
const filename = `${name}.${ext}`;
|
|
53
|
+
|
|
54
|
+
try {
|
|
55
|
+
writeFileSync(filename, templates[type]);
|
|
56
|
+
console.log(`✓ Created ${type}: ${filename}`);
|
|
57
|
+
} catch (err) {
|
|
58
|
+
console.error('❌ Error:', err.message);
|
|
59
|
+
process.exit(1);
|
|
60
|
+
}
|