{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.codefrost.dev/api/v1/offerings.schema.json","title":"Codefrost public agent responses","description":"Schema for the public offerings catalog, deterministic service recommendations, and visible input errors.","oneOf":[{"type":"object","required":["schema_version","schema_url","canonical_url","representations","products","services","recommendation_contract","scope"],"properties":{"schema_version":{"const":"1.0"},"schema_url":{"const":"https://www.codefrost.dev/api/v1/offerings.schema.json"},"canonical_url":{"const":"https://www.codefrost.dev/agents"},"representations":{"type":"object","required":["html","json","text","schema","llms","mcp"],"properties":{"html":{"type":"string"},"json":{"type":"string"},"text":{"type":"string"},"schema":{"type":"string"},"llms":{"type":"string"},"mcp":{"type":"string"}},"additionalProperties":false},"products":{"type":"array","minItems":1,"items":{"type":"object","required":["id","name","tagline","description","category","status","platforms","tech_stack","stats","pricing","canonical_url","links"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"status":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}},"tech_stack":{"type":"array","items":{"type":"string"}},"stats":{"type":"array","items":{"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}},"pricing":{"type":"object","required":["model","price","free_features"],"properties":{"model":{"type":"string"},"price":{"type":["string","null"]},"free_features":{"type":["string","null"]}},"additionalProperties":false},"canonical_url":{"type":"string"},"links":{"type":"array","items":{"type":"object","required":["type","url"],"properties":{"type":{"type":"string"},"url":{"type":"string"},"label":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"services":{"type":"array","minItems":5,"items":{"type":"object","required":["id","name","audience","description","deliverables","pricing","service_url","next_step"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"audience":{"type":"string"},"description":{"type":"string"},"deliverables":{"type":"array","items":{"type":"string"}},"pricing":{"type":"object","required":["publicly_listed","note"],"properties":{"publicly_listed":{"const":false},"note":{"type":"string"}},"additionalProperties":false},"service_url":{"type":"string"},"next_step":{"type":"object","required":["label","url","note"],"properties":{"label":{"type":"string"},"url":{"type":"string"},"note":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}},"recommendation_contract":{"type":"object","required":["method","endpoint","input_schema","ordered_rules"],"properties":{"method":{"const":"codefrost_service_rules_v1"},"endpoint":{"type":"string"},"input_schema":{"type":"object"},"ordered_rules":{"type":"array","minItems":1,"items":{"type":"string"}}},"additionalProperties":false},"scope":{"type":"object","required":["covers","does_not_do","sensitive_data_warning"],"properties":{"covers":{"type":"string"},"does_not_do":{"type":"string"},"sensitive_data_warning":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["schema_version","schema_url","recommendation","representations"],"properties":{"schema_version":{"const":"1.0"},"schema_url":{"const":"https://www.codefrost.dev/api/v1/offerings.schema.json"},"recommendation":{"type":"object","required":["recommended_service","recommended_service_name","reason","service_url","next_step","urgency_note","submits_anything","disclaimer"],"properties":{"recommended_service":{"type":"string"},"recommended_service_name":{"type":"string"},"reason":{"type":"string"},"service_url":{"type":"string"},"next_step":{"type":"object","required":["label","url","note"],"properties":{"label":{"type":"string"},"url":{"type":"string"},"note":{"type":"string"}},"additionalProperties":false},"urgency_note":{"type":["string","null"]},"submits_anything":{"const":false},"disclaimer":{"type":"string"}},"additionalProperties":false},"representations":{"type":"object","required":["offerings_catalog","agent_documentation"],"properties":{"offerings_catalog":{"type":"string"},"agent_documentation":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["schema_version","schema_url","error"],"properties":{"schema_version":{"const":"1.0"},"schema_url":{"const":"https://www.codefrost.dev/api/v1/offerings.schema.json"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"const":"invalid_recommendation_input"},"message":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}]}