@bluefly/openstandardagents 0.5.0 → 0.5.3

package/dist/types/index.d.ts

@@ -1,665 +0,0 @@
-/**
- * OSSA Core Types
- * Type definitions for OSSA specification
- */
-import { ErrorObject } from 'ajv';
-export * from './tool.js';
-export { createTool, isTool, validateToolConfig } from './tool.js';
-export type { Tool, ToolAuth, ToolType } from './tool.js';
-export * from './task.js';
-export { createTaskManifest, isOssaTask } from './task.js';
-export type { OssaTask, RuntimeBinding, TaskSpec } from './task.js';
-export * from './workflow.js';
-export { createStep, createWorkflowManifest, expr, isOssaWorkflow } from './workflow.js';
-export type { OssaWorkflow, WorkflowSpec, WorkflowStep } from './workflow.js';
-export * from './messaging.js';
-export type { Command, MessageEnvelope, MessagingExtension, PublishedChannel, ReliabilityConfig, RoutingRule, Subscription } from './messaging.js';
-export * from './identity.js';
-export type { Adapter, CredentialSource, GenerationContext, Principal } from './identity.js';
-export * from './architect.js';
-export type { ArchitectRecommendation, ArchitectureConstraint, Blueprint, BlueprintKind } from './architect.js';
-export * from './security.js';
-export type { AuditConfig, DataClassification, EgressPolicy, NetworkAccessConfig, NetworkProtocol, ResourceLimits, SandboxingConfig, SandboxType, SecurityCapability, SecurityPosture, ThreatCategory, ThreatModelEntry, ThreatSeverity } from './security.js';
-export { isOssaSkill } from './skill.js';
-export type { OssaSkill } from './skill.js';
-export { createRoleManifest, isOssaRole } from './role.js';
-export type { OssaRole, RoleActivation, RoleContext, RoleExtension, RoleHooks, RoleInstructions, RoleMCPServer, RoleProtocols, RoleSpec, RoleTools } from './role.js';
-export { isOssaMCPServer } from './mcp-server-manifest.js';
-export type { OssaMCPServer } from './mcp-server-manifest.js';
-export * from './protocols.js';
-export type { A2AAgentCard, A2AAuthentication, A2ACapabilities, A2AProtocol, A2ASkill, ANPDiscovery, ANPProtocol, MCPCapabilities, MCPProtocol, MCPRole, MCPServerConfig, MCPTransport, ProtocolDeclarations, VerifiableCredentialRef } from './protocols.js';
-/**
- * Agent Taxonomy Types (v0.4.4+)
- * Defines WHO executes, WHAT they do, and HOW they're structured
- */
-/**
- * Agent Type - Runtime platform/framework for agent execution
- * Specifies which platform will execute this agent
- */
-export type AgentType = 'claude' | 'kagent' | 'openai' | 'langchain' | 'crewai' | 'autogen' | 'llamaindex' | 'haystack' | 'semantic-kernel' | 'vertex-ai' | 'bedrock' | 'pydantic-ai' | 'swarm' | 'a2a' | 'mcp-server' | 'agent-sdk' | 'adk' | 'agentscope' | 'custom';
-/**
- * Agent Kind - Functional role of the agent
- * Describes WHAT the agent does in the system
- */
-export type AgentKind = 'assistant' | 'orchestrator' | 'worker' | 'coordinator' | 'supervisor' | 'tool' | 'reviewer' | 'planner' | 'executor' | 'monitor' | 'analyst' | 'researcher' | 'specialist' | 'team-lead' | 'teammate' | 'subagent' | 'debugger';
-/**
- * Architecture Pattern - How the agent is structured
- */
-export type ArchitecturePattern = 'single' | 'swarm' | 'pipeline' | 'graph' | 'hierarchical' | 'reactive' | 'cognitive' | 'lead-teammate';
-/**
- * Agent Capabilities - What the agent can do
- */
-export type AgentCapability = 'handoff' | 'streaming' | 'context' | 'tools' | 'vision' | 'code' | 'audio' | 'video' | 'function-calling' | 'parallel-tools' | 'memory' | 'retrieval' | 'web-search';
-/**
- * Handoff Strategy - How agents coordinate handoffs
- */
-export type HandoffStrategy = 'manual' | 'automatic' | 'conditional' | 'supervised';
-/**
- * Scalability Model - How the agent scales
- */
-export type ScalabilityModel = 'single-instance' | 'horizontal' | 'serverless';
-/**
- * Execution Model - How the agent executes
- */
-export type ExecutionModel = 'synchronous' | 'asynchronous' | 'streaming' | 'batch';
-/**
- * Agent Architecture - Complete architecture definition
- */
-export interface AgentArchitecture {
-    /** Architecture pattern */
-    pattern?: ArchitecturePattern;
-    /** Agent capabilities */
-    capabilities?: AgentCapability[];
-    /** Multi-agent coordination config */
-    coordination?: {
-        /** How agents coordinate handoffs */
-        handoffStrategy?: HandoffStrategy;
-        /** Leader/orchestrator agent name */
-        leaderAgent?: string;
-        /** Maximum orchestration depth */
-        maxDepth?: number;
-        /** Team coordination model */
-        teamModel?: 'lead-teammate' | 'peer-to-peer' | 'hierarchical' | 'swarm';
-        /** Communication pattern between agents */
-        communicationPattern?: 'task-list' | 'mailbox' | 'shared-file' | 'direct-message' | 'broadcast';
-        /** Task coordination strategy */
-        taskCoordination?: 'sequential' | 'parallel' | 'dependency-wave';
-        /** Conflict resolution strategy */
-        conflictResolution?: 'leader-decides' | 'vote' | 'round-robin';
-        /** How task state is persisted */
-        taskPersistence?: 'file-backed' | 'in-memory' | 'database';
-        /** Whether to track task dependencies */
-        dependencyTracking?: boolean;
-    };
-    /** Runtime configuration hints */
-    runtime?: {
-        /** Preferred deployment region */
-        preferredRegion?: string;
-        /** Scalability model */
-        scalability?: ScalabilityModel;
-        /** Execution model */
-        executionModel?: ExecutionModel;
-    };
-}
-/**
- * Capability definition (OpenAPI-style operation)
- */
-export interface Capability {
-    id: string;
-    description: string;
-    inputSchema: Record<string, unknown> | string;
-    outputSchema: Record<string, unknown> | string;
-    authRequirements?: {
-        type: string;
-        scopes?: string[];
-    };
-    idempotencySemantics?: 'idempotent' | 'non-idempotent';
-    slo?: {
-        maxLatencySeconds?: number;
-        maxErrorRate?: number;
-    };
-    telemetryRequirements?: {
-        metrics?: string[];
-        logs?: string[];
-        trace?: boolean;
-    };
-    examples?: Array<{
-        name?: string;
-        input?: Record<string, unknown>;
-        output?: Record<string, unknown>;
-    }>;
-    timeout_seconds?: number;
-    retry_policy?: {
-        max_attempts?: number;
-        backoff?: 'linear' | 'exponential';
-    };
-}
-import { Adapter, Principal } from './identity.js';
-import type { ProtocolDeclarations } from './protocols.js';
-import type { SecurityPosture } from './security.js';
-/**
- * Publisher information for agent attribution and trust (v0.5)
- */
-export interface Publisher {
-    /** Publisher display name */
-    name: string;
-    /** Publisher contact email */
-    email?: string;
-    /** Publisher website URL */
-    website?: string;
-    /** PGP public key fingerprint or URL */
-    pgp_key?: string;
-    /** URL to the publisher's agent registry */
-    registry_url?: string;
-}
-/**
- * Agent Identity Model (v0.5)
- * Enables unique identification, versioning, and publisher attribution.
- */
-export interface AgentIdentity {
-    /** Hierarchical namespace for scoping agent identifiers */
-    namespace?: string;
-    /** Unique agent identifier within the namespace */
-    agent_id: string;
-    /** Agent identity version (semver) */
-    version?: string;
-    /** Publisher information */
-    publisher?: Publisher;
-    /** Content-addressable checksum for integrity verification */
-    checksum?: string;
-    /** ISO 8601 creation timestamp */
-    created_at?: string;
-    /** ISO 8601 last update timestamp */
-    updated_at?: string;
-}
-/**
- * Team member definition (v0.4.6+)
- */
-export interface TeamMember {
-    name: string;
-    kind?: 'team-lead' | 'teammate' | 'subagent' | 'reviewer' | 'specialist';
-    role: string;
-    model?: string;
-    tools?: string[];
-    skills?: string[];
-    contextIsolation?: boolean;
-    maxTokenBudget?: number;
-}
-/**
- * Team definition for multi-agent teams (v0.4.6+)
- */
-export interface TeamDefinition {
-    model: 'lead-teammate' | 'peer-to-peer' | 'hierarchical' | 'swarm';
-    lead?: string;
-    delegateMode?: 'task-list' | 'round-robin' | 'capability-match' | 'load-balance';
-    members: TeamMember[];
-    taskList?: {
-        persistence?: 'file-backed' | 'in-memory' | 'database';
-        format?: 'markdown' | 'json' | 'yaml';
-        path?: string;
-        dependencyTracking?: boolean;
-    };
-    communication?: {
-        channel?: 'task-list' | 'mailbox' | 'shared-file' | 'direct-message' | 'broadcast';
-        consensus?: 'leader-decides' | 'vote' | 'round-robin';
-    };
-    deployment?: {
-        backend?: 'in-process' | 'split-pane' | 'distributed' | 'kubernetes';
-        maxConcurrency?: number;
-    };
-}
-/**
- * Subagent definition for parent-child delegation (v0.4.6+)
- */
-export interface SubagentDefinition {
-    name: string;
-    kind?: 'subagent' | 'worker' | 'specialist' | 'reviewer' | 'debugger';
-    role: string;
-    model?: string;
-    tools?: string[];
-    contextIsolation?: boolean;
-    reportTo?: string;
-    maxTokenBudget?: number;
-}
-/**
- * OSSA Agent manifest structure (k8s-style format)
- * Supports both k8s-style (apiVersion/kind/metadata/spec) and legacy (ossaVersion/agent) formats
- * Compatible with all v0.2.x schema versions
- */
-export interface OssaAgent {
-    apiVersion?: string;
-    kind?: string;
-    metadata?: {
-        name: string;
-        version?: string;
-        description?: string;
-        author?: string;
-        license?: string;
-        labels?: Record<string, string>;
-        annotations?: Record<string, string>;
-        tags?: string[];
-        mesh_bindings?: {
-            source_project_id?: string;
-            execution_node_id?: string;
-        };
-        lifecycle?: {
-            state?: 'active' | 'deprecated' | 'retired';
-            maturity?: 'alpha' | 'beta' | 'stable' | 'deprecated' | 'retired';
-            deprecation?: {
-                sunsetDate?: string;
-                replacement?: string;
-                reason?: string;
-            };
-        };
-        agentType?: AgentType;
-        agentKind?: AgentKind;
-        agentArchitecture?: AgentArchitecture;
-        idCard?: {
-            nickname?: string;
-            displayName?: string;
-            avatar?: string;
-            registryId?: string;
-            fingerprint?: string;
-            birthHash?: string;
-            provenance?: {
-                createdBy?: string;
-                createdAt?: string;
-                createdWith?: string;
-                lineage?: Array<{
-                    ancestor: string;
-                    relationship: 'forked-from' | 'cloned-from' | 'derived-from' | 'inspired-by' | 'upgraded-from';
-                    timestamp: string;
-                    commitHash?: string;
-                }>;
-            };
-            auditTrail?: {
-                hashAlgorithm?: 'sha256' | 'sha384' | 'sha512';
-                chainType?: 'merkle' | 'linear' | 'signed';
-                genesisHash?: string;
-                entries?: Array<{
-                    seq: number;
-                    action: string;
-                    timestamp: string;
-                    actor: string;
-                    hash: string;
-                    prevHash?: string | null;
-                    details?: Record<string, unknown>;
-                    signature?: string;
-                }>;
-            };
-        };
-        identity?: {
-            publicKey: string;
-            algorithm: string;
-        };
-    };
-    /**
-     * Legacy agent format support (v0.2.x)
-     */
-    agent?: {
-        id: string;
-        name: string;
-        version: string;
-        description?: string;
-        role: string;
-        llm?: {
-            provider: string;
-            model: string;
-            temperature?: number;
-            maxTokens?: number;
-            topP?: number;
-        };
-        capabilities?: any[];
-        runtime?: {
-            type: string;
-            image?: string;
-            config?: Record<string, unknown>;
-        };
-        tools?: any[];
-    };
-    skills?: string[];
-    spec?: {
-        role: string;
-        instructions?: string;
-        workflow?: {
-            steps?: Array<Record<string, unknown>>;
-            [key: string]: unknown;
-        };
-        llm?: {
-            provider: string;
-            model: string;
-            temperature?: number;
-            maxTokens?: number;
-            topP?: number;
-        };
-        adapters?: Adapter[];
-        principal?: Principal;
-        personality?: {
-            system_prompt?: string;
-            tone?: string;
-            expertise?: string[];
-        };
-        mcp?: {
-            servers?: Array<{
-                label: string;
-                url: string;
-                transport?: string;
-            }>;
-        };
-        safety?: {
-            guardrails?: Array<{
-                name: string;
-                type: 'input' | 'output';
-                blocked_patterns?: string[];
-                maxLength?: number;
-            }>;
-        };
-        tools?: Array<{
-            type: string;
-            name?: string;
-            description?: string;
-            server?: string;
-            namespace?: string;
-            endpoint?: string;
-            capabilityId?: string;
-            capabilities?: string[];
-            config?: Record<string, unknown>;
-            auth?: {
-                type: string;
-                credentials?: string;
-            };
-            inputSchema?: Record<string, unknown> | string;
-            outputSchema?: Record<string, unknown> | string;
-        }>;
-        autonomy?: {
-            level?: string;
-            approval_required?: boolean;
-            allowed_actions?: string[];
-            blocked_actions?: string[];
-        };
-        constraints?: {
-            cost?: {
-                maxTokensPerDay?: number;
-                maxTokensPerRequest?: number;
-                maxCostPerDay?: number;
-                currency?: string;
-            };
-            performance?: {
-                maxLatencySeconds?: number;
-                maxErrorRate?: number;
-                timeoutSeconds?: number;
-            };
-            resources?: {
-                cpu?: string;
-                memory?: string;
-                gpu?: string;
-            };
-        };
-        observability?: {
-            tracing?: {
-                enabled?: boolean;
-                exporter?: string;
-                endpoint?: string;
-            };
-            metrics?: {
-                enabled?: boolean;
-                exporter?: string;
-                endpoint?: string;
-            };
-            logging?: {
-                level?: string;
-                format?: string;
-            };
-        };
-        messaging?: {
-            publishes?: Array<{
-                channel: string;
-                description?: string;
-                schema: Record<string, unknown>;
-                examples?: Record<string, unknown>[];
-                contentType?: string;
-                tags?: string[];
-            }>;
-            subscribes?: Array<{
-                channel: string;
-                description?: string;
-                schema?: Record<string, unknown>;
-                handler?: string;
-                filter?: {
-                    expression?: string;
-                    fields?: Record<string, unknown>;
-                };
-                priority?: 'low' | 'normal' | 'high' | 'critical';
-                maxConcurrency?: number;
-            }>;
-            commands?: Array<{
-                name: string;
-                description?: string;
-                inputSchema: Record<string, unknown>;
-                outputSchema?: Record<string, unknown>;
-                timeoutSeconds?: number;
-                idempotent?: boolean;
-                async?: boolean;
-            }>;
-            reliability?: {
-                deliveryGuarantee?: 'at-least-once' | 'at-most-once' | 'exactly-once';
-                retry?: {
-                    maxAttempts?: number;
-                    backoffMs?: number;
-                    maxBackoffMs?: number;
-                };
-                deadLetterQueue?: {
-                    enabled?: boolean;
-                    maxRetries?: number;
-                };
-                ordering?: {
-                    enabled?: boolean;
-                    key?: string;
-                };
-            };
-        };
-        dependencies?: {
-            agents?: Array<{
-                name: string;
-                version?: string;
-                contract?: {
-                    channels?: string[];
-                    commands?: string[];
-                };
-            }>;
-        };
-        capabilities?: (Capability | string)[];
-        policies?: Array<{
-            name: string;
-            type: string;
-            rules: unknown[];
-            [key: string]: unknown;
-        }>;
-        tests?: Array<{
-            id: string;
-            name?: string;
-            type?: 'unit' | 'integration' | 'capability' | 'policy';
-            assertions: Array<{
-                type: string;
-                actual: string;
-                expected: unknown;
-            }>;
-            [key: string]: unknown;
-        }>;
-        environments?: Record<string, {
-            version: string;
-            deployedAt: string;
-            deployedBy: string;
-            status: 'deployed' | 'healthy' | 'degraded' | 'failed';
-            endpoint?: string;
-        }>;
-        /** Multi-agent team definition (v0.4.6+) */
-        team?: TeamDefinition;
-        /** Child agents for delegation (v0.4.6+) */
-        subagents?: SubagentDefinition[];
-    };
-    security?: SecurityPosture;
-    protocols?: ProtocolDeclarations;
-    extensions?: {
-        agents_md?: AgentsMdExtension;
-        llms_txt?: LlmsTxtExtension;
-        cursor?: CursorExtension;
-        openai_agents_sdk?: {
-            model_override?: string;
-            handoff_targets?: string[];
-            mcp_servers?: Array<{
-                label: string;
-                url: string;
-            }>;
-        };
-        [key: string]: unknown;
-    };
-}
-/**
- * agents.md section configuration
- */
-export interface AgentsMdSection {
-    enabled?: boolean;
-    source?: string;
-    custom?: string;
-    append?: string;
-    prepend?: string;
-    title_format?: string;
-}
-/**
- * agents.md extension configuration
- */
-export interface AgentsMdExtension {
-    enabled?: boolean;
-    generate?: boolean;
-    output_path?: string;
-    sections?: {
-        dev_environment?: AgentsMdSection;
-        testing?: AgentsMdSection;
-        pr_instructions?: AgentsMdSection;
-    };
-    sync?: {
-        on_manifest_change?: boolean;
-        include_comments?: boolean;
-    };
-    cursor_integration?: boolean;
-}
-/**
- * llms.txt section configuration
- */
-export interface LlmsTxtSection {
-    enabled?: boolean;
-    source?: string;
-    custom?: string;
-    append?: string;
-    prepend?: string;
-    title?: string;
-    file_list?: string[];
-}
-/**
- * llms.txt extension configuration
- */
-export interface LlmsTxtExtension {
-    enabled?: boolean;
-    generate?: boolean;
-    file_path?: string;
-    auto_discover?: boolean;
-    format?: {
-        include_h1_title?: boolean;
-        include_blockquote?: boolean;
-        include_h2_sections?: boolean;
-        include_optional?: boolean;
-    };
-    sections?: {
-        core_specification?: LlmsTxtSection;
-        quick_start?: LlmsTxtSection;
-        cli_tools?: LlmsTxtSection;
-        sdks?: LlmsTxtSection;
-        examples?: LlmsTxtSection;
-        migration_guides?: LlmsTxtSection;
-        development?: LlmsTxtSection;
-        specification_versions?: LlmsTxtSection;
-        openapi_specifications?: LlmsTxtSection;
-        documentation?: LlmsTxtSection;
-        optional?: LlmsTxtSection;
-        custom?: LlmsTxtSection[];
-    };
-    sync?: {
-        on_manifest_change?: boolean;
-        include_comments?: boolean;
-        preserve_custom?: boolean;
-        watch?: boolean;
-    };
-    mapping?: {
-        metadata_to_h1?: boolean;
-        description_to_blockquote?: boolean;
-        spec_to_core_specification?: boolean;
-        tools_to_cli_tools?: boolean;
-        examples_to_examples?: boolean;
-        migrations_to_migration_guides?: boolean;
-    };
-    include_metadata?: boolean;
-}
-/**
- * Cursor extension configuration
- */
-export interface CursorExtension {
-    enabled?: boolean;
-    agent_type?: string;
-    workspace_config?: {
-        rules_file?: string;
-        context_files?: string[];
-        ignore_patterns?: string[];
-        agents_md_path?: string;
-    };
-    capabilities?: Record<string, boolean>;
-    model?: {
-        provider?: string;
-        name?: string;
-    };
-}
-/**
- * Validation result
- */
-export interface ValidationResult {
-    valid: boolean;
-    errors: ErrorObject[];
-    warnings: string[];
-    manifest?: OssaAgent;
-}
-/**
- * Agent template for generation
- */
-export interface AgentTemplate {
-    id: string;
-    name: string;
-    role: string;
-    description?: string;
-    /** Agent version (not OSSA spec version) */
-    version?: string;
-    runtimeType?: string;
-    capabilities?: Capability[];
-}
-/**
- * Schema versions supported
- * Dynamic: versions are discovered from spec/ directory at runtime
- * Supports any version pattern like 0.2.5-RC, 0.2.6, etc.
- */
-export type SchemaVersion = string;
-/**
- * Service interfaces
- */
-export interface IValidationService {
-    validate(manifest: unknown, version: SchemaVersion): Promise<ValidationResult>;
-}
-export interface ISchemaRepository {
-    getSchema(version: SchemaVersion): Promise<Record<string, unknown>>;
-    clearCache(): void;
-    getAvailableVersions(): string[];
-    getCurrentVersion(): string;
-}
-export interface IManifestRepository {
-    load(path: string): Promise<OssaAgent>;
-    save(path: string, manifest: OssaAgent): Promise<void>;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -1,30 +0,0 @@
-/**
- * OSSA Core Types
- * Type definitions for OSSA specification
- */
-// Export Tool types
-export * from './tool.js';
-export { createTool, isTool, validateToolConfig } from './tool.js';
-// Export Task types (v0.3.0)
-export * from './task.js';
-export { createTaskManifest, isOssaTask } from './task.js';
-// Export Workflow types (v0.3.0)
-export * from './workflow.js';
-export { createStep, createWorkflowManifest, expr, isOssaWorkflow } from './workflow.js';
-// Export Messaging types (v0.3.0)
-export * from './messaging.js';
-// Export Identity & Adapter types (v0.3.6)
-export * from './identity.js';
-// Export Architect types (v0.3.6)
-export * from './architect.js';
-// Export Security Posture types (v0.5)
-export * from './security.js';
-// Export Skill types (AgentSkills / OSSA skills)
-export { isOssaSkill } from './skill.js';
-// Export Role types (v0.5 — IDE operator contexts)
-export { createRoleManifest, isOssaRole } from './role.js';
-// Export MCP server manifest types
-export { isOssaMCPServer } from './mcp-server-manifest.js';
-// Export Protocol Declaration types (v0.5)
-export * from './protocols.js';
-//# sourceMappingURL=index.js.map