@bluefly/openstandardagents 0.4.4 → 0.4.6

package/dist/package.json

@@ -1,26 +1,10 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "exports": {
     "./schema": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4.1": "./spec/v0.4/agent.schema.json",
-    "./schema/v0.3.6": "./spec/v0.3/ossa-0.3.6.schema.json",
-    "./schema/v0.3.5": "./spec/v0.3/ossa-0.3.5.schema.json",
-    "./schema/v0.3.4": "./spec/v0.3/ossa-v0.3.schema.json",
-    "./schema/v0.3.3": "./spec/v0.3/ossa-v0.3.schema.json",
-    "./ag2/swarm-topology": "./spec/v0.3.4/extensions/ag2/swarm-topology.schema.json",
-    "./ag2/group-chat": "./spec/v0.3.4/extensions/ag2/group-chat.schema.json",
-    "./ag2/nested-chat": "./spec/v0.3.4/extensions/ag2/nested-chat.schema.json",
-    "./hitl/intervention-points": "./spec/v0.3.4/protocols/hitl/intervention-points.schema.json",
-    "./hitl/human-input-modes": "./spec/v0.3.4/protocols/hitl/human-input-modes.schema.json",
-    "./hitl/approval-workflows": "./spec/v0.3.4/protocols/hitl/approval-workflows.schema.json",
-    "./a2a/service-discovery": "./spec/v0.3.4/protocols/a2a/service-discovery.schema.json",
-    "./a2a/handoff-protocol": "./spec/v0.3.4/protocols/a2a/handoff-protocol.schema.json",
-    "./a2a/capability-advertisement": "./spec/v0.3.4/protocols/a2a/capability-advertisement.schema.json",
-    "./state/context-serialization": "./spec/v0.3.4/runtime/state/context-serialization.schema.json",
-    "./state/memory-portability": "./spec/v0.3.4/runtime/state/memory-portability.schema.json",
-    "./state/teachability": "./spec/v0.3.4/runtime/state/teachability.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -57,13 +41,66 @@
       "import": "./dist/mesh/index.js",
       "require": "./dist/mesh/index.js"
     },
+    "./agent-card": {
+      "types": "./dist/services/agent-card-generator.d.ts",
+      "import": "./dist/services/agent-card-generator.js",
+      "require": "./dist/services/agent-card-generator.js"
+    },
+    "./agent-card-schema": "./spec/v0.4/agent-card.schema.json",
+    "./sdk": {
+      "types": "./dist/sdk.d.ts",
+      "import": "./dist/sdk.js",
+      "require": "./dist/sdk.js"
+    },
     "./version-management": {
       "types": "./dist/version-management/index.d.ts",
       "import": "./dist/version-management/index.js",
       "require": "./dist/version-management/index.js"
+    },
+    "./mcp-server": "./dist/mcp-server/index.js",
+    "./data/marketplace-skills-catalog": {
+      "types": "./dist/data/marketplace-skills-catalog.d.ts",
+      "import": "./dist/data/marketplace-skills-catalog.js",
+      "require": "./dist/data/marketplace-skills-catalog.js"
+    },
+    "./kagent": {
+      "types": "./dist/sdks/kagent/index.d.ts",
+      "import": "./dist/sdks/kagent/index.js",
+      "require": "./dist/sdks/kagent/index.js"
+    },
+    "./trust": {
+      "types": "./dist/services/trust/trust.service.d.ts",
+      "import": "./dist/services/trust/trust.service.js",
+      "require": "./dist/services/trust/trust.service.js"
     }
   },
-  "description": "OSSA - Open Standard for Software Agents. The OpenAPI for agents. A specification standard (not a framework) that defines contracts/metadata for production agent systems.",
+  "description": "OSSA - Open Standard for Software Agents. Infrastructure bridge between agent protocols (MCP, A2A) and deployment platforms. Define once in YAML, export to 9+ platforms (Docker, Kubernetes, LangChain, CrewAI, Claude Skills, etc.).",
+  "keywords": [
+    "ossa",
+    "ai-agents",
+    "agent-framework",
+    "agent-orchestration",
+    "multi-agent",
+    "openapi",
+    "json-schema",
+    "kubernetes",
+    "docker",
+    "langchain",
+    "crewai",
+    "autogen",
+    "claude",
+    "llm",
+    "agent-mesh",
+    "agent-standard",
+    "kagent",
+    "cli",
+    "validation",
+    "agent-generation",
+    "agent-deployment",
+    "agent-interoperability"
+  ],
+  "author": "OSSA Contributors",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -71,10 +108,17 @@
     "ossa": "bin/ossa",
     "ossa-dev": "bin/ossa-dev",
     "ossa-version": "bin/ossa-version",
-    "ossa-validate-all": "bin/ossa-validate-all"
+    "ossa-validate-all": "bin/ossa-validate-all",
+    "ossa-mcp": "dist/mcp-server/index.js"
   },
   "files": [
     "dist/",
+    "!dist/dev-cli/",
+    "!dist/services/release-automation/",
+    "!dist/sdks/python-generator/",
+    "!dist/sdks/typescript/",
+    "!dist/**/*.js.map",
+    "!dist/**/*.d.ts.map",
     "spec/",
     "bin/",
     "examples/",
@@ -92,7 +136,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://gitlab.com/blueflyio/ossa/openstandardagents/"
+    "url": "git+https://gitlab.com/blueflyio/ossa/openstandardagents.git"
   },
   "bugs": {
     "url": "https://gitlab.com/blueflyio/ossa/openstandardagents/-/issues"
@@ -101,9 +145,10 @@
   "scripts": {
     "// ─────────────────────────────────────────────────────────────────────────────": "",
     "// BUILD & DEVELOPMENT": "",
+    "mcp": "node dist/mcp-server/index.js",
     "prebuild": "npm run docs:process",
     "build": "tsc && npm run build:assets",
-    "build:assets": "cp -r spec dist/ && cp package.json dist/",
+    "build:assets": "cp -r spec dist/ && cp package.json .version.json dist/",
     "build:clean": "npm run clean && npm run build",
     "dev": "tsc --watch",
     "clean": "rm -rf dist coverage .tsbuildinfo",
@@ -121,18 +166,20 @@
     "test:mutation:ci": "stryker run --logLevel error",
     "test:watch": "jest --watch",
     "test:ci": "jest --ci --coverage --reporters=default --reporters=jest-junit",
+    "test:mcp": "vitest run src/mcp-server/__tests__/mcp-server.spec.ts",
+    "test:mcp:watch": "vitest watch src/mcp-server/__tests__/mcp-server.spec.ts",
     "ci:validate": "npm run build:clean && npm run quality && npm run test:unit && npm run test:smoke && npm run validate:all",
-    "ci:validate:fast": "npm run typecheck && npm run lint && npm run test:unit && npm run validate:schema",
+    "ci:validate:fast": "npm run typecheck && npm run test:unit && npm run validate:schema",
     "// CODE QUALITY": "",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src tests --ext .ts",
     "lint:fix": "eslint src tests --ext .ts --fix",
     "format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
     "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts'",
-    "quality": "npm run typecheck && npm run lint && npm run format:check",
-    "quality:fix": "npm run lint:fix && npm run format",
+    "quality": "npm run typecheck && npm run format:check",
+    "quality:fix": "npm run format",
     "// VALIDATION": "",
-    "validate": "npm run validate:schema && npm run validate:examples",
+    "validate": "npm run validate:no-symlinks && npm run validate:schema && npm run validate:openapi && npm run validate:examples",
     "validate:all": "npm run validate && npm run validate:sdks",
     "validate:sdks": "npm run validate:sdk:typescript && npm run validate:sdk:python",
     "validate:sdk:typescript": "cd src/sdks/typescript && npm install && npm run build && npm run typecheck",
@@ -140,20 +187,23 @@
     "validate:schema": "npx ajv-cli compile -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") -r $(node -p \"require('./.version.json').spec_path\")/extensions/kagent/kagent.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/mcp/mcp.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/a2a/a2a.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langchain/langchain.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langgraph/langgraph.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/ag2/ag2.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/crewai/crewai.schema.json --strict=false --allow-union-types",
     "validate:manifest": "npx ajv-cli validate -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") --strict=false --allow-union-types -d",
     "validate:examples": "find examples \\( -name '*.ossa.yaml' -o -name '*.ossa.yml' \\) | grep -v 'swarm-to-ossa' | head -20 | xargs -I {} npm run validate:manifest -- {} || true",
-    "validate:versions": "tsx tools/validate-versions.ts",
-    "fix:versions": "tsx tools/fix-versions.ts",
+    "validate:versions": "tsx src/tools/validate-versions.ts",
+    "fix:versions": "tsx src/tools/fix-versions.ts",
     "validate:power": "tsx src/tools/validation/validate-ossa.ts",
-    "validate:openapi": "tsx src/tools/validation/validate-openapi-extensions.ts",
+    "validate:openapi": "spectral lint openapi/**/*.yaml --ruleset .spectral.yml 2>/dev/null || spectral lint openapi/**/*.yaml",
+    "validate:openapi:ossa": "tsx src/tools/validation/validate-openapi-extensions.ts",
+    "validate:no-symlinks": "tsx src/tools/validate-no-symlinks.ts",
     "// VERSION MANAGEMENT (via ossa-dev CLI - single source of truth)": "",
     "version:release": "tsx src/dev-cli/src/index.ts version release",
     "version:validate": "tsx src/dev-cli/src/index.ts version validate",
     "version:sync": "tsx src/dev-cli/src/index.ts version sync",
     "version:detect": "tsx src/dev-cli/src/index.ts version detect",
     "version:audit": "tsx src/dev-cli/src/index.ts version audit",
-    "// INFRASTRUCTURE (TODO: Move to buildkit)": "",
+    "// INFRASTRUCTURE (deploy tooling out of scope for OSSA)": "",
     "env:list": "tsx src/dev-cli/src/index.ts env-cleanup --list",
     "env:cleanup": "tsx src/dev-cli/src/index.ts env-cleanup --stop-stuck",
     "// DOCUMENTATION": "",
+    "wiki:publish": "node .gitlab/wiki-publish.cjs",
     "docs:process": "tsx src/tools/docs/process-doc-templates.ts",
     "docs:check": "test -f README.md && test -f CHANGELOG.md",
     "docs:generate": "tsx src/tools/docs/generate-api-docs.ts && tsx src/tools/docs/generate-cli-docs.ts && tsx src/tools/docs/generate-schema-docs.ts && tsx src/tools/docs/generate-examples-docs.ts && tsx src/tools/generators/generate-agents-catalog.ts && tsx src/tools/docs/generate-types-docs.ts && tsx src/tools/docs/generate-errors-docs.ts && tsx src/tools/docs/generate-config-docs.ts && tsx src/tools/docs/lowercase-docs.ts",
@@ -177,44 +227,38 @@
     "prepare": "lefthook install || true",
     "postinstall": "node bin/postinstall || true",
     "// RELEASE & PUBLISH": "",
-    "prerelease": "npm run quality && npm run test && npm run validate",
-    "prepublishOnly": "tsx tools/validate-package.ts",
-    "validate:deps": "tsx tools/validate-dependencies.ts",
-    "validate:package": "tsx tools/validate-package.ts",
-    "release:check": "npm run prerelease && echo '✅ Ready for release'",
-    "release:verify": "tsx src/dev-cli/src/index.ts release verify",
-    "release:prep": "tsx src/dev-cli/src/index.ts release prep v$(node -p \"require('./.version.json').latest_stable\")"
+    "prepublishOnly": "publint && 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",
+    "release:check": "npm run typecheck && npm run test:unit && npm run validate:schema && publint",
+    "release:semantic": "npx semantic-release",
+    "release:semantic:dry": "npx semantic-release --dry-run"
   },
-  "keywords": [
-    "ossa",
-    "ai-agents",
-    "openapi",
-    "standard",
-    "kubernetes",
-    "kagent",
-    "cli",
-    "validation",
-    "agent-generation"
-  ],
-  "author": "OSSA Standards Team",
-  "license": "Apache-2.0",
   "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.50",
     "@anthropic-ai/sdk": "^0.71.0",
     "@aws-sdk/client-bedrock-runtime": "^3.955.0",
     "@gitbeaker/node": "^35.8.1",
+    "@gitbeaker/rest": "^43.8.0",
     "@google/generative-ai": "^0.21.0",
     "@langchain/anthropic": "^0.3.10",
     "@langchain/core": "^0.3.29",
     "@langchain/openai": "^0.3.17",
     "@modelcontextprotocol/sdk": "^0.6.0",
+    "@noble/ed25519": "^2.3.0",
     "@octokit/rest": "^20.0.0",
+    "@openai/agents": "^0.4.6",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-jaeger": "^1.28.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.211.0",
     "@opentelemetry/exporter-metrics-otlp-http": "^0.54.0",
     "@opentelemetry/exporter-prometheus": "^0.54.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.54.0",
     "@opentelemetry/exporter-zipkin": "^1.28.0",
     "@opentelemetry/resources": "^1.28.0",
+    "@opentelemetry/sdk-logs": "^0.211.0",
+    "@opentelemetry/sdk-metrics": "^2.5.0",
     "@opentelemetry/sdk-node": "^0.54.0",
     "@opentelemetry/sdk-trace-base": "^1.28.0",
     "@qdrant/js-client-rest": "^1.9.0",
@@ -230,13 +274,16 @@
     "chokidar": "^5.0.0",
     "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
+    "did-resolver": "^4.1.0",
     "express": "^4.18.2",
     "fast-glob": "^3.3.2",
     "glob": "^11.0.3",
     "gradient-string": "^2.0.2",
     "inquirer": "^9.2.12",
     "inversify": "^7.10.4",
+    "jose": "^5.9.6",
     "js-yaml": "^4.1.0",
+    "json-canonicalize": "^1.0.6",
     "langchain": "^0.3.9",
     "open": "^11.0.0",
     "openai": "^6.9.1",
@@ -249,31 +296,34 @@
     "semver": "^7.7.3",
     "tar": "^7.5.3",
     "uuid": "^11.0.5",
+    "web-did-resolver": "^2.0.32",
     "ws": "^8.19.0",
     "yaml": "^2.3.0",
     "zod": "^4.1.11"
   },
   "devDependencies": {
-    "@gitbeaker/rest": "^43.8.0",
     "@jest/globals": "^29.7.0",
     "@octokit/rest": "^22.0.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.0",
     "@semantic-release/gitlab": "^13.2.9",
+    "@stoplight/spectral-cli": "^6.15.0",
     "@types/express": "^4.17.21",
     "@types/gradient-string": "^1.1.6",
     "@types/inquirer": "^9.0.9",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.19",
+    "@types/nodemailer": "^6.4.0",
     "@types/pg": "^8.15.5",
     "@types/redis": "^4.0.10",
     "@types/semver": "^7.7.1",
     "@typescript-eslint/eslint-plugin": "^8.48.0",
     "@typescript-eslint/parser": "^8.48.0",
     "ajv-cli": "^5.0.0",
+    "conventional-changelog-conventionalcommits": "^9.2.0",
+    "depcheck": "^1.4.7",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -284,6 +334,7 @@
     "keep-a-changelog": "^2.8.0",
     "lefthook": "^1.12.3",
     "prettier": "^3.6.2",
+    "publint": "^0.3.18",
     "semantic-release": "^25.0.1",
     "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
@@ -291,6 +342,13 @@
     "typescript": "^5.9.3",
     "vitest": "^2.1.8"
   },
+  "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"
@@ -298,5 +356,9 @@
   "volta": {
     "node": "18.20.8",
     "npm": "10.9.4"
-  }
+  },
+  "bundleDependencies": [
+    "ajv",
+    "ajv-formats"
+  ]
 }

package/dist/repositories/schema.repository.js

@@ -142,15 +142,21 @@ let SchemaRepository = class SchemaRepository {
         const entries = fs.readdirSync(specDir, { withFileTypes: true });
         for (const entry of entries) {
             if (entry.isDirectory() && entry.name.startsWith('v')) {
-                // Extract version from directory name (e.g., "v0.3" -> "0.3")
+                // Extract version from directory name (e.g., "v0.3" -> "0.3", "v0.4" -> "0.4")
                 const dirVersion = entry.name.substring(1);
-                // For minor version directories (e.g., v0.3), look for any schema files inside
+                // For minor version directories (e.g., v0.3, v0.4), look for any schema files inside
                 const versionDir = path.join(specDir, entry.name);
                 const schemaFiles = fs
                     .readdirSync(versionDir)
-                    .filter((f) => f.startsWith('ossa-') && f.endsWith('.schema.json'));
+                    .filter((f) => f.endsWith('.schema.json'));
                 for (const schemaFile of schemaFiles) {
-                    // Extract version from schema file name (e.g., "ossa-0.3.5.schema.json" -> "0.3.5")
+                    // Check for generic agent.schema.json (v0.4+ pattern)
+                    if (schemaFile === 'agent.schema.json') {
+                        // Use directory version for generic schema files
+                        versions.push(dirVersion);
+                        continue;
+                    }
+                    // Extract version from legacy schema file name (e.g., "ossa-0.3.5.schema.json" -> "0.3.5")
                     const match = schemaFile.match(/ossa-(?:v)?(\d+\.\d+\.\d+)\.schema\.json/);
                     if (match) {
                         versions.push(match[1]);

package/dist/sdk.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OSSA SDK - Single entry for programmatic use in other projects.
+ *
+ * Exposes agent card generation, lightweight validation, and types.
+ * For full ValidationService (schema repo, DI) use @bluefly/openstandardagents/validation.
+ * For mesh use @bluefly/openstandardagents/mesh.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   AgentCardGenerator,
+ *   validateManifest,
+ *   loadManifestFromFile,
+ *   loadManifestFromString,
+ *   OSSAValidator,
+ * } from '@bluefly/openstandardagents/sdk';
+ * import type { AgentCard, OssaAgent, ValidationResult } from '@bluefly/openstandardagents/sdk';
+ *
+ * const manifest = loadManifestFromFile('agent.ossa.yaml');
+ * const result = validateManifest(manifest);
+ * if (result.valid) {
+ *   const gen = new AgentCardGenerator();
+ *   const cardResult = gen.generate(manifest, { namespace: 'myteam' });
+ *   if (cardResult.success && cardResult.card) console.log(cardResult.card.uri);
+ * }
+ * ```
+ */
+export { AgentCardGenerator } from './services/agent-card-generator.js';
+export type { AgentCardGeneratorOptions, AgentCardResult, } from './services/agent-card-generator.js';
+export { OSSAValidator } from './validation/validator.js';
+export type { ValidationResult } from './validation/validator.js';
+export { checkVersionCompliance, MIN_API_VERSION_ALLOWED, } from './validation/version-compliance.js';
+export type { VersionComplianceResult } from './validation/version-compliance.js';
+/**
+ * Load manifest from file path (YAML or JSON). Does not validate; call validateManifest after if needed.
+ */
+export declare function loadManifestFromFile(filePath: string): Record<string, unknown>;
+/**
+ * Load manifest from string (YAML or JSON). Does not validate; call validateManifest after if needed.
+ */
+export declare function loadManifestFromString(content: string, format?: 'yaml' | 'json'): Record<string, unknown>;
+/**
+ * Validate an OSSA manifest (sync, schema + separation-of-duties).
+ * Uses default v0.4 schema from package dist. For custom schema use OSSAValidator directly.
+ */
+export declare function validateManifest(manifest: Record<string, unknown>): import('./validation/validator.js').ValidationResult;
+export type { OssaAgent, SchemaVersion } from './types/index.js';
+export type { AgentCard, AgentCardState, TokenEfficiencySummary, AgentCardSeparation, } from './mesh/types.js';
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.js

@@ -0,0 +1,66 @@
+/**
+ * OSSA SDK - Single entry for programmatic use in other projects.
+ *
+ * Exposes agent card generation, lightweight validation, and types.
+ * For full ValidationService (schema repo, DI) use @bluefly/openstandardagents/validation.
+ * For mesh use @bluefly/openstandardagents/mesh.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   AgentCardGenerator,
+ *   validateManifest,
+ *   loadManifestFromFile,
+ *   loadManifestFromString,
+ *   OSSAValidator,
+ * } from '@bluefly/openstandardagents/sdk';
+ * import type { AgentCard, OssaAgent, ValidationResult } from '@bluefly/openstandardagents/sdk';
+ *
+ * const manifest = loadManifestFromFile('agent.ossa.yaml');
+ * const result = validateManifest(manifest);
+ * if (result.valid) {
+ *   const gen = new AgentCardGenerator();
+ *   const cardResult = gen.generate(manifest, { namespace: 'myteam' });
+ *   if (cardResult.success && cardResult.card) console.log(cardResult.card.uri);
+ * }
+ * ```
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { OSSAValidator as ValidatorClass } from './validation/validator.js';
+import { safeParseYAML } from './utils/yaml-parser.js';
+export { AgentCardGenerator } from './services/agent-card-generator.js';
+export { OSSAValidator } from './validation/validator.js';
+export { checkVersionCompliance, MIN_API_VERSION_ALLOWED, } from './validation/version-compliance.js';
+const _distDir = dirname(fileURLToPath(import.meta.url));
+const _defaultSchemaPath = join(_distDir, 'spec', 'v0.4', 'agent.schema.json');
+let _validator = null;
+/**
+ * Load manifest from file path (YAML or JSON). Does not validate; call validateManifest after if needed.
+ */
+export function loadManifestFromFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const isYaml = filePath.endsWith('.yaml') || filePath.endsWith('.yml');
+    return (isYaml
+        ? safeParseYAML(content)
+        : JSON.parse(content));
+}
+/**
+ * Load manifest from string (YAML or JSON). Does not validate; call validateManifest after if needed.
+ */
+export function loadManifestFromString(content, format = 'yaml') {
+    return (format === 'yaml'
+        ? safeParseYAML(content)
+        : JSON.parse(content));
+}
+/**
+ * Validate an OSSA manifest (sync, schema + separation-of-duties).
+ * Uses default v0.4 schema from package dist. For custom schema use OSSAValidator directly.
+ */
+export function validateManifest(manifest) {
+    if (!_validator)
+        _validator = new ValidatorClass(_defaultSchemaPath);
+    return _validator.validate(manifest);
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdks/kagent/crd-generator.d.ts

@@ -4,7 +4,7 @@
  * Generates production-grade Kubernetes manifests with complete resource specs
  */
 import type { OssaAgent } from '../../types/index.js';
-import type { KAgentCRD, KAgentDeploymentOptions, KubernetesManifestBundle } from './types.js';
+import type { KAgentCRD, KAgentDeploymentOptions, KubernetesManifestBundle, KAgentV1Alpha2Agent, KAgentV1Alpha2ModelConfig } from './types.js';
 export declare class KAgentCRDGenerator {
     /**
      * Generate complete Kubernetes manifest bundle
@@ -55,6 +55,25 @@ export declare class KAgentCRDGenerator {
      * Generate comprehensive README documentation
      */
     private generateReadme;
+    /**
+     * Generate kagent.dev v1alpha2 Declarative Agent (and optional ModelConfig) for POC / native kagent installs
+     */
+    generateV1Alpha2(manifest: OssaAgent, options?: KAgentDeploymentOptions): {
+        agent: KAgentV1Alpha2Agent;
+        modelConfig?: KAgentV1Alpha2ModelConfig;
+    };
+    /**
+     * Build v1alpha2 ModelConfig from OSSA spec.llm (optional; use when not relying on default-model-config)
+     */
+    private buildV1Alpha2ModelConfig;
+    /**
+     * Extract tools in kagent v1alpha2 format (McpServer with toolNames, or Agent ref)
+     */
+    private extractToolsForV1Alpha2;
+    /**
+     * Extract A2A skills from OSSA manifest (extensions.kagent.a2aConfig.skills or single skill from description)
+     */
+    private extractA2ASkills;
     /**
      * Extract tools from OSSA spec
      */