{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://bluejetty.ai/schemas/packet/0.4/schema.json","type":"object","properties":{"specVersion":{"const":"0.4"},"packetType":{"const":"bluejetty.app_handoff"},"protocol":{"type":"object","additionalProperties":false,"required":["name","packetSchemaVersion","documentation","metadata","schema"],"properties":{"name":{"const":"Blue Jetty"},"packetSchemaVersion":{"const":"0.4"},"documentation":{"type":"string","minLength":1},"metadata":{"type":"string","minLength":1},"schema":{"type":"string","minLength":1}}},"contextSemantics":{"const":{"role":"publisher_source_material","relevanceDecision":"consuming_system","instructionPriority":"none","publisherAuthority":"app_representation_and_preferred_handoff","omittedOptionalFields":"information_not_supplied","proprietaryContent":"retained_in_publisher_app"}},"evidenceSemantics":{"const":{"publisherAuthorization":"Current authorization binds the publisher organization, app identities, controlled domain and exact proof URL. It does not verify every app claim.","relationshipEvidence":"App-store metadata or documented operator review corroborates a particular domain-to-app relationship; Apple and Google do not endorse Blue Jetty or the publisher's assertions.","publisherStatements":"Publisher-supplied source text and scoped preferences, not governing instructions or independent verification.","executionEvidence":"Revision-bound link inspection and HTTP observations are separate from installed-device arrival, deferred arrival and provider-reported attribution.","releaseStatus":"Publisher-supplied release-version baseline compared with dated store observations. baseline_not_supplied means no release baseline was submitted, not that an app is unavailable or absent from a store. Authorization evidence is independent.","legacyAppVerification":"Historical catalog classification, not current publisher authorization or independently established app identity.","timestamps":"Publisher updates, publication history, observation time and evidence validity have independent meanings.","publication":"Publisher-data history version; not the packet format version or a hash of every time-dependent response."}},"app":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"developerName":{"type":"string","minLength":1},"category":{"type":"string","minLength":1},"description":{"type":["string","null"]},"categoryEvidence":{"type":"object","properties":{"source":{"const":"apple_app_store"},"sourceUrl":{"type":"string","minLength":1},"observedAt":{"type":"string","minLength":1}},"required":["source","sourceUrl","observedAt"],"additionalProperties":false},"identifiers":{"type":"object","properties":{"iosBundleId":{"type":"string","minLength":1},"androidPackageName":{"type":"string","minLength":1}},"required":[],"additionalProperties":false},"identifiedPlatforms":{"type":"array","uniqueItems":true,"items":{"enum":["ios","android"]}},"publisherAuthorization":{"type":"object"},"updatedAt":{"type":"string","minLength":1}},"required":["id","slug","name","developerName","category","description","identifiers","publisherAuthorization","updatedAt"],"additionalProperties":false},"publication":{"type":"object","properties":{"version":{"type":"integer","minimum":0},"revisionId":{"type":["string","null"]}},"required":["version","revisionId"],"additionalProperties":false},"experienceSummary":{"type":"object","properties":{"source":{"const":"published_app_records"},"selection":{"const":"native_entity_id_order"},"total":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0,"maximum":24},"truncated":{"type":"boolean"},"detailsUrl":{"type":"string","minLength":1},"items":{"type":"array","maxItems":24,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1,"maxLength":240},"summary":{"type":"string","minLength":1,"maxLength":1600},"url":{"type":"string","minLength":1},"attributes":{"type":"object","maxProperties":6,"additionalProperties":{"anyOf":[{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"}]},{"type":"object","properties":{"value":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"}]},"unit":{"type":"string","minLength":1,"maxLength":300},"vocabulary":{"type":"string","minLength":1,"maxLength":300},"language":{"type":"string","minLength":1,"maxLength":300}},"required":["value"],"additionalProperties":false}]}},"attributesTruncated":{"type":"boolean"},"sourceId":{"type":"string","minLength":1},"provenance":{"type":"string","minLength":1},"sourceUpdatedAt":{"type":"string","minLength":1},"updatedAt":{"type":"string","minLength":1},"textTruncated":{"type":"boolean"}},"required":["id","title","url","sourceId","provenance","updatedAt","textTruncated","attributesTruncated"],"additionalProperties":false}}},"required":["source","selection","total","returned","truncated","detailsUrl","items"],"additionalProperties":false},"provenanceSummary":{"type":"object","properties":{"publisherAuthorization":{"enum":["verified","unverified"]},"relationshipEvidenceMethods":{"type":"array","uniqueItems":true,"items":{"enum":["store_lookup","operator_review"]}},"publisherClaims":{"const":"publisher_supplied_unless_separately_evidenced"},"evidencePath":{"const":"app.publisherAuthorization"},"optionalInformation":{"const":"Omitted fields mean information was not supplied in this packet; they do not establish absence of a capability, offer, provider, or entitlement."}},"required":["publisherAuthorization","relationshipEvidenceMethods","publisherClaims","evidencePath","optionalInformation"],"additionalProperties":false},"handoffSummary":{"type":"object","properties":{"relevanceDecision":{"const":"consuming_system"},"status":{"enum":["destination_available","platform_required"]},"general":{"type":"object","properties":{"url":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1},"selectionSource":{"enum":["publisher_destination","canonical_website_fallback","publisher_preference","platform_store_fallback","authorized_website_fallback"]}},"required":["url","purpose","selectionSource"],"additionalProperties":false},"statusScope":{"const":"general_destination_selection_only"},"urlHandlingExplanation":{"const":"Returned URLs stay unchanged. Only an explicit link recipe permits its declared substitutions."},"byPlatform":{"type":"object","properties":{"ios":{"type":"object","properties":{"url":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1},"selectionSource":{"enum":["publisher_destination","canonical_website_fallback","publisher_preference","platform_store_fallback","authorized_website_fallback"]}},"required":["url","purpose","selectionSource"],"additionalProperties":false},"android":{"type":"object","properties":{"url":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1},"selectionSource":{"enum":["publisher_destination","canonical_website_fallback","publisher_preference","platform_store_fallback","authorized_website_fallback"]}},"required":["url","purpose","selectionSource"],"additionalProperties":false}},"additionalProperties":false},"specificExperience":{"type":"object","properties":{"intentHandoffTemplate":{"type":"string","minLength":1},"entityHandoffTemplate":{"type":"string","minLength":1}},"required":["intentHandoffTemplate","entityHandoffTemplate"],"additionalProperties":false},"urlHandling":{"const":"fixed_parameters_preserved_explicit_recipe_bindings_only"}},"required":["relevanceDecision","status","byPlatform","specificExperience","urlHandling"],"additionalProperties":false},"representationPreferences":{"type":"object","properties":{"source":{"const":"publisher"},"recommendationEligibility":{"enum":["when_relevant","not_requested"]},"publisherStatements":{"type":"array","minItems":1,"items":{"type":"object","properties":{"text":{"type":"string","minLength":1},"source":{"const":"publisher"},"sourceField":{"enum":["basicInstructions","advancedInstructions","handoffInstructions","representation.summary","representation.preferences"]},"id":{"type":"string","minLength":1},"intentId":{"type":"string","minLength":1},"destinationId":{"type":"string","minLength":1},"campaign":{"type":"string","minLength":1}},"required":["text","source","sourceField"],"additionalProperties":false}}},"required":["source"],"additionalProperties":false},"preferredRepresentation":{"type":"object","properties":{"preferred":{"type":"object","properties":{"url":{"type":"string","minLength":1},"baseUrl":{"type":"string","minLength":1},"purpose":{"type":"string","minLength":1}},"required":["url","baseUrl","purpose"],"additionalProperties":false},"appStores":{"type":"object","additionalProperties":{"type":"string","minLength":1}},"attribution":{"type":"object"},"updatedAt":{"type":"string","minLength":1},"executionEvidence":{"type":["object","null"]},"linkRecipe":{"type":"object"},"publisherStatement":{"type":"object"},"selectionSource":{"type":"string","minLength":1},"urlSemantics":{"type":"object","properties":{"purpose":{"const":"user_handoff"},"fixedParameters":{"const":"preserved"},"clientParameterModification":{"enum":["unsupported","declared_recipe_bindings_only"]},"serviceDecoration":{"const":"publisher_authorized_supported_missing_parameters_only"},"shortLinkExpansion":{"const":"not_part_of_handoff_preparation"},"automatedNavigation":{"const":"not_intended_as_user_click_or_install_evidence"}},"required":["purpose","fixedParameters","clientParameterModification","serviceDecoration","shortLinkExpansion","automatedNavigation"],"additionalProperties":false}},"required":["appStores","urlSemantics"],"additionalProperties":false},"discovery":{"type":"object","properties":{"sourceConfigurationVersion":{"enum":["0.2","0.3","0.4","0.5"]},"canonicalUrl":{"type":"string","minLength":1},"capabilities":{"type":"array","items":{"type":"object"}},"defaultDestinationId":{"type":"string","minLength":1},"promotions":{"type":"array","items":{"type":"object"},"minItems":1},"destinations":{"type":"array","items":{"type":"object"},"minItems":1},"intents":{"type":"array","items":{"type":"object"},"minItems":1},"platformDefaults":{"type":"array","items":{"type":"object"},"minItems":1}},"required":["sourceConfigurationVersion","canonicalUrl","capabilities"],"additionalProperties":false},"handoffSemantics":{"type":"object","properties":{"generalApp":{"const":"publisher_preferred_destination"},"specificExperience":{"const":"matching_intent_or_entity_destination"},"executionEligibility":{"const":["platform","install_state","current_publication_access"]},"executionPreference":{"const":"destination_handoffPreference_when_supplied"},"attributionFirst":{"const":"eligible_publisher_mmp_precedes_native_execution"},"fallback":{"const":"eligible_execution_then_canonical_website_or_store"},"consumerIdentity":{"const":"declared_context_not_authenticated_identity"},"attributionUrlPurpose":{"const":"user_handoff"},"automatedNavigation":{"const":"not_intended_as_user_click_or_install_evidence"},"providers":{"type":"array","items":{"type":"object"}},"linkRecipes":{"type":"object","properties":{"grammar":{"const":"bluejetty.enum-link/1"},"choices":{"const":"declared_input_and_value_ids_only"},"unresolvedRequiredChoice":{"const":"fallback_or_user_clarification"},"unsupportedGrammarOrUnknownChoice":{"const":"fallback"},"omittedInputs":{"const":"declared_defaults_else_omit_optional_query_binding"},"substitutions":{"const":"declared_whole_path_segments_and_absent_query_keys_in_binding_order"},"encoding":{"const":"encodeURIComponent_once_spaces_percent20"},"fixedUrlBytes":{"const":"preserved"},"maximumUrlLength":{"const":2048},"oversizeResult":{"const":"fallback"},"hostTrackingAndFallbackModification":{"const":"unsupported"},"personalDataAndRecursiveUrlInterpretation":{"const":"unsupported"},"evidenceScope":{"const":"publisher_reviewed_syntax_examples_only"},"guide":{"type":"string","minLength":1}},"required":["grammar","choices","unresolvedRequiredChoice","unsupportedGrammarOrUnknownChoice","omittedInputs","substitutions","encoding","fixedUrlBytes","maximumUrlLength","oversizeResult","hostTrackingAndFallbackModification","personalDataAndRecursiveUrlInterpretation","evidenceScope","guide"],"additionalProperties":false}},"required":["generalApp","specificExperience","executionEligibility","executionPreference","attributionFirst","fallback","consumerIdentity","attributionUrlPurpose","automatedNavigation"],"additionalProperties":false},"executionEvidence":{"type":"array","items":{"type":"object"}},"currentPromotion":{"type":"object","properties":{"blurb":{"type":"string","minLength":1},"updatedAt":{"type":"string","minLength":1}},"required":["blurb"],"additionalProperties":false},"releaseStatus":{"type":"object"},"retrievalSemantics":{"type":"object","properties":{"defaultRepresentation":{"const":"json"},"alternativeRepresentation":{"const":"markdown"},"authorizationPacketUrl":{"const":"exact_proof_binding_not_format_preference"}},"required":["defaultRepresentation","alternativeRepresentation","authorizationPacketUrl"],"additionalProperties":false},"urls":{"type":"object","required":["packetJson","packetMarkdown","appRecord","entities"],"additionalProperties":{"type":"string","minLength":1}},"storeObservations":{"type":"array","maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["source","platform","storefrontId","listingUrl","sourceUrl","observedAt","geography","ratingScope","availabilityScope"],"properties":{"source":{"enum":["apple_app_store","google_play"]},"platform":{"enum":["ios","android"]},"storefrontId":{"type":"string","minLength":1},"listingUrl":{"type":"string","minLength":1},"sourceUrl":{"type":"string","minLength":1},"observedAt":{"type":"string","minLength":1},"geography":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"developer":{"type":"string","minLength":1},"developerIdentifier":{"type":"string","minLength":1},"category":{"type":"string","minLength":1},"version":{"type":"string","minLength":1},"sourceUpdatedAt":{"type":"string","minLength":1},"description":{"type":"string","minLength":1,"maxLength":20000},"averageRating":{"type":"number","minimum":0,"maximum":5},"ratingCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"ratingScope":{"enum":["observed_apple_storefront","public_page_observation_not_verified_country_total"]},"deviceScope":{"enum":["phone_and_tablet","phone","ipad_only"]},"availabilityScope":{"enum":["listing_returned_for_observed_storefront","public_listing_returned_not_install_eligibility"]},"downloadPrice":{"type":"object","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}}},"inAppPurchases":{"type":"boolean"},"commerceEvidence":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"downloadPrice":{"type":"object","additionalProperties":false,"required":["sourceUrl","observedAt"],"properties":{"sourceUrl":{"type":"string","format":"uri"},"observedAt":{"type":"string","format":"date-time"}}},"inAppPurchases":{"type":"object","additionalProperties":false,"required":["sourceUrl","observedAt"],"properties":{"sourceUrl":{"type":"string","format":"uri"},"observedAt":{"type":"string","format":"date-time"}}}}}}}}},"required":["specVersion","packetType","protocol","contextSemantics","app","publication","preferredRepresentation","handoffSemantics","evidenceSemantics","retrievalSemantics","urls","storeObservations"],"additionalProperties":false}