@bluefly/openstandardagents 0.3.5 → 0.3.6

package/dist/validation/error-codes.d.ts

@@ -0,0 +1,170 @@
+/**
+ * OSSA Validation Error Code Catalog
+ *
+ * Comprehensive error codes for OSSA manifest validation with remediation steps.
+ * Enables programmatic error handling and detailed debugging.
+ *
+ * Error Code Format: OSSA-XXX
+ * - 001-099: Schema validation errors
+ * - 100-199: Identity & DID errors
+ * - 200-299: Genetics & breeding errors
+ * - 300-399: Lifecycle errors
+ * - 400-499: Economics & marketplace errors
+ * - 500-599: Taxonomy errors
+ * - 600-699: Access control & separation of duties errors
+ * - 700-799: Revolutionary features errors
+ * - 800-899: Naming & format errors
+ * - 900-999: Catalog & publishing errors
+ */
+export declare enum OSSAErrorCode {
+    OSSA_001 = "OSSA-001",// Missing required field
+    OSSA_002 = "OSSA-002",// Invalid field type
+    OSSA_003 = "OSSA-003",// Invalid apiVersion format
+    OSSA_004 = "OSSA-004",// Invalid kind value
+    OSSA_005 = "OSSA-005",// Missing spec field
+    OSSA_006 = "OSSA-006",// Invalid spec for kind
+    OSSA_007 = "OSSA-007",// Invalid enum value
+    OSSA_008 = "OSSA-008",// Pattern mismatch
+    OSSA_009 = "OSSA-009",// Invalid array item
+    OSSA_010 = "OSSA-010",// Duplicate array values
+    OSSA_011 = "OSSA-011",// Invalid JSON format
+    OSSA_012 = "OSSA-012",// Schema version mismatch
+    OSSA_013 = "OSSA-013",// Additional properties not allowed
+    OSSA_014 = "OSSA-014",// Invalid number range
+    OSSA_015 = "OSSA-015",// Invalid string length
+    OSSA_100 = "OSSA-100",// Invalid DID format
+    OSSA_101 = "OSSA-101",// DID pattern mismatch
+    OSSA_102 = "OSSA-102",// Missing DID for genetics
+    OSSA_103 = "OSSA-103",// Missing DID for economics
+    OSSA_104 = "OSSA-104",// DID without credentials
+    OSSA_105 = "OSSA-105",// Invalid credential format
+    OSSA_106 = "OSSA-106",// Expired credential
+    OSSA_107 = "OSSA-107",// Invalid reputation score
+    OSSA_108 = "OSSA-108",// Missing credit_score
+    OSSA_109 = "OSSA-109",// Invalid service account provider
+    OSSA_110 = "OSSA-110",// Missing service account details
+    OSSA_111 = "OSSA-111",// Invalid GitLab scopes
+    OSSA_112 = "OSSA-112",// Scope conflicts with tier
+    OSSA_200 = "OSSA-200",// Invalid generation number
+    OSSA_201 = "OSSA-201",// Missing parent DIDs
+    OSSA_202 = "OSSA-202",// Invalid parent DID count
+    OSSA_203 = "OSSA-203",// Invalid fitness score
+    OSSA_204 = "OSSA-204",// Missing fitness score
+    OSSA_205 = "OSSA-205",// Invalid task success rate
+    OSSA_206 = "OSSA-206",// Invalid user satisfaction
+    OSSA_207 = "OSSA-207",// Invalid cost efficiency
+    OSSA_208 = "OSSA-208",// Missing breeding criteria
+    OSSA_209 = "OSSA-209",// Invalid mutation count
+    OSSA_210 = "OSSA-210",// Invalid trait
+    OSSA_211 = "OSSA-211",// Generation mismatch with parents
+    OSSA_212 = "OSSA-212",// Breeding ineligible fitness
+    OSSA_300 = "OSSA-300",// Invalid lifecycle stage
+    OSSA_301 = "OSSA-301",// Missing retired_at timestamp
+    OSSA_302 = "OSSA-302",// Retirement without legacy
+    OSSA_303 = "OSSA-303",// Invalid promotion entry
+    OSSA_304 = "OSSA-304",// Missing training hours
+    OSSA_305 = "OSSA-305",// Invalid certifications
+    OSSA_306 = "OSSA-306",// Stage transition violation
+    OSSA_307 = "OSSA-307",// Senior without promotions
+    OSSA_308 = "OSSA-308",// Invalid skill level
+    OSSA_309 = "OSSA-309",// Missing onboarding date
+    OSSA_310 = "OSSA-310",// Invalid retirement eligibility
+    OSSA_311 = "OSSA-311",// Lifecycle state inconsistency
+    OSSA_400 = "OSSA-400",// Negative wallet balance
+    OSSA_401 = "OSSA-401",// Missing wallet for marketplace
+    OSSA_402 = "OSSA-402",// Invalid offering price
+    OSSA_403 = "OSSA-403",// Missing payment method
+    OSSA_404 = "OSSA-404",// Invalid currency
+    OSSA_405 = "OSSA-405",// Marketplace offering without DID
+    OSSA_406 = "OSSA-406",// Invalid transaction history
+    OSSA_407 = "OSSA-407",// Retired agent with offerings
+    OSSA_408 = "OSSA-408",// Invalid pricing model
+    OSSA_409 = "OSSA-409",// Missing service description
+    OSSA_410 = "OSSA-410",// Invalid revenue share
+    OSSA_411 = "OSSA-411",// Offering price inconsistency
+    OSSA_500 = "OSSA-500",// Missing domain
+    OSSA_501 = "OSSA-501",// Invalid domain value
+    OSSA_502 = "OSSA-502",// Invalid subdomain for domain
+    OSSA_503 = "OSSA-503",// Invalid capability pattern
+    OSSA_504 = "OSSA-504",// Invalid concern value
+    OSSA_505 = "OSSA-505",// Type-domain mismatch
+    OSSA_506 = "OSSA-506",// Missing taxonomy classification
+    OSSA_507 = "OSSA-507",// Tier-domain mismatch
+    OSSA_508 = "OSSA-508",// Invalid recommended_tier
+    OSSA_600 = "OSSA-600",// Invalid access tier
+    OSSA_601 = "OSSA-601",// Missing tier configuration
+    OSSA_602 = "OSSA-602",// Invalid permission
+    OSSA_603 = "OSSA-603",// Permission-tier mismatch
+    OSSA_604 = "OSSA-604",// Invalid audit level
+    OSSA_605 = "OSSA-605",// Missing approval chain
+    OSSA_606 = "OSSA-606",// Invalid isolation level
+    OSSA_607 = "OSSA-607",// Role conflict detected
+    OSSA_608 = "OSSA-608",// Invalid role value
+    OSSA_609 = "OSSA-609",// Prohibited action in role
+    OSSA_610 = "OSSA-610",// Invalid delegation tier
+    OSSA_611 = "OSSA-611",// Delegation to higher tier
+    OSSA_612 = "OSSA-612",// Missing delegation token
+    OSSA_613 = "OSSA-613",// Self-delegation prohibited
+    OSSA_614 = "OSSA-614",// Conflicting roles assigned
+    OSSA_700 = "OSSA-700",// Feature requires DID
+    OSSA_701 = "OSSA-701",// Incompatible feature combination
+    OSSA_702 = "OSSA-702",// Missing prerequisite feature
+    OSSA_703 = "OSSA-703",// Feature tier restriction
+    OSSA_704 = "OSSA-704",// Team membership without lifecycle
+    OSSA_705 = "OSSA-705",// Invalid team role
+    OSSA_706 = "OSSA-706",// Team hierarchy violation
+    OSSA_800 = "OSSA-800",// Invalid DNS-1123 format
+    OSSA_801 = "OSSA-801",// Name too long
+    OSSA_802 = "OSSA-802",// Name contains invalid characters
+    OSSA_803 = "OSSA-803",// Invalid URL format
+    OSSA_804 = "OSSA-804",// Invalid email format
+    OSSA_805 = "OSSA-805",// Invalid date format
+    OSSA_806 = "OSSA-806",// Invalid version format
+    OSSA_900 = "OSSA-900",// Published without documentation
+    OSSA_901 = "OSSA-901",// Invalid visibility value
+    OSSA_902 = "OSSA-902",// Public agent without ratings
+    OSSA_903 = "OSSA-903",// Missing license for public agent
+    OSSA_904 = "OSSA-904",// Invalid rating value
+    OSSA_905 = "OSSA-905",// Missing catalog metadata
+    OSSA_906 = "OSSA-906"
+}
+export interface ErrorDetails {
+    code: OSSAErrorCode;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    remediation: string;
+    docsUrl: string;
+    examples?: ErrorExample[];
+    tags?: string[];
+}
+export interface ErrorExample {
+    title: string;
+    invalid: string;
+    valid: string;
+    explanation: string;
+}
+/**
+ * Comprehensive error catalog with remediation steps
+ */
+export declare const ERROR_CATALOG: Record<OSSAErrorCode, ErrorDetails>;
+/**
+ * Get error details by code
+ */
+export declare function getErrorDetails(code: OSSAErrorCode): ErrorDetails | undefined;
+/**
+ * Search errors by tag
+ */
+export declare function searchErrorsByTag(tag: string): ErrorDetails[];
+/**
+ * Search errors by severity
+ */
+export declare function searchErrorsBySeverity(severity: 'error' | 'warning' | 'info'): ErrorDetails[];
+/**
+ * Get all error codes
+ */
+export declare function getAllErrorCodes(): OSSAErrorCode[];
+/**
+ * Get error count by severity
+ */
+export declare function getErrorCountBySeverity(): Record<string, number>;
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/validation/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/validation/error-codes.ts"],"names":[],"mappings":"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"}