@bluefly/openstandardagents 0.4.5 → 0.4.6

package/dist/mesh/types.d.ts

@@ -136,6 +136,44 @@ export interface AgentCard {
     };
     status?: AgentStatus;
     lastHeartbeat?: string;
+    state?: AgentCardState;
+    tokenEfficiencySummary?: TokenEfficiencySummary;
+    manifestRef?: string;
+    manifestDigest?: string;
+    separation?: AgentCardSeparation;
+    cardProfile?: 'minimal' | 'discovery' | 'full';
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Agent card state hint — for discovery and session resume.
+ * SoD: defined in OSSA manifest spec.state; projected here.
+ */
+export interface AgentCardState {
+    mode?: 'stateless' | 'session' | 'long_running';
+    storageHint?: string;
+    sessionEndpoint?: string;
+    checkpointIntervalSeconds?: number;
+    retention?: string;
+}
+/**
+ * Token efficiency summary — for routing and cost-aware clients.
+ * SoD: defined in OSSA manifest token_efficiency; projected here.
+ */
+export interface TokenEfficiencySummary {
+    serializationProfile?: 'compact' | 'full' | 'fingerprint';
+    observationFormat?: 'projected' | 'summary' | 'diff' | 'full';
+    maxInputTokens?: number;
+    cascade?: string[];
+    consolidationStrategy?: string;
+}
+/**
+ * Separation of duties — for discovery and policy.
+ * SoD: defined in OSSA spec.access and spec.separation; projected here.
+ */
+export interface AgentCardSeparation {
+    accessTier?: 'tier_1_read' | 'tier_2_write_limited' | 'tier_3_write_elevated' | 'tier_4_policy';
+    role?: string;
+    conflictsWith?: string[];
 }
 /**
  * Agent Taxonomy

package/dist/observability/metrics.d.ts

@@ -15,15 +15,15 @@ export declare const metricsRegistry: Registry<"text/plain; version=0.0.4; chars
 /**
  * HTTP request counter
  */
-export declare const httpRequestsTotal: Counter<"route" | "method" | "status_code">;
+export declare const httpRequestsTotal: Counter<"method" | "route" | "status_code">;
 /**
  * HTTP request duration histogram (milliseconds)
  */
-export declare const httpRequestDuration: Histogram<"route" | "method" | "status_code">;
+export declare const httpRequestDuration: Histogram<"method" | "route" | "status_code">;
 /**
  * HTTP errors counter
  */
-export declare const httpErrorsTotal: Counter<"route" | "method" | "status_code" | "error_code">;
+export declare const httpErrorsTotal: Counter<"method" | "route" | "status_code" | "error_code">;
 /**
  * Agent validation counter
  */

package/dist/package.json

@@ -1,26 +1,10 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.5",
+  "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,10 +41,37 @@
       "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. 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.).",
@@ -97,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/",
@@ -118,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"
@@ -127,6 +145,7 @@
   "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 .version.json dist/",
@@ -147,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",
@@ -166,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",
@@ -203,17 +227,16 @@
     "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",
-    "publish:check": "tsx tools/pre-publish-check.ts",
+    "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 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\")"
+    "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"
   },
   "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",
@@ -223,6 +246,7 @@
     "@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",
@@ -250,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",
@@ -269,6 +296,7 @@
     "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"
@@ -280,18 +308,22 @@
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "@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",
@@ -302,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",
@@ -309,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"
@@ -316,5 +356,9 @@
   "volta": {
     "node": "18.20.8",
     "npm": "10.9.4"
-  }
+  },
+  "bundleDependencies": [
+    "ajv",
+    "ajv-formats"
+  ]
 }

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
      */