{
  "schema_version": "sourcestrand-product-offer-v1",
  "product_id": "tw_factory_operational_risk_pack",
  "title": "Taiwan Factory Operational Risk Pack",
  "service_name": "Taiwan Factory Operational Risk Pack",
  "buyer_summary": "Which Taiwan factory, grid, drought, air-quality, and environmental streams help a buyer or AI assistant add operational context around supplier sites?",
  "canonical_base_url": "https://api.sourcestrand.com",
  "primary_buyer_jobs": [
    "Hardware, semiconductor, and sourcing teams adding public operational context around Taiwan supplier sites.",
    "AI agents preparing a site-context packet before requesting company or semiconductor paid endpoints.",
    "Market-entry analysts comparing factory footprint, grid, water, air-quality, and environmental public-record streams."
  ],
  "free_validation": {
    "preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/factory-operational-risk",
    "expected_preview_shape": [
      "product",
      "package_scope",
      "streams",
      "sample_records",
      "concrete_sample_records",
      "record_backed_pack",
      "agent_specific_contracts",
      "entity_linking_contract",
      "change_feed_preview",
      "supplier_candidate_workflow",
      "stream_readiness",
      "coverage_summary",
      "freshness_policy",
      "agent_cache",
      "buyer_action_pack",
      "paid_unlock",
      "data_lineage",
      "limitations"
    ],
    "agent_tools_url": "https://api.sourcestrand.com/agent-tools.json",
    "route_intent_url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={buyer_question}",
    "change_feed_preview_url": "https://api.sourcestrand.com/v1/preview/changes/tw-data-packs?pack=factory-operational-risk&since={iso_datetime}",
    "dossier_preview_url": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}"
  },
  "agent_purchase_hint": {
    "recommended_base_url": "https://api.sourcestrand.com",
    "recommended_network": "eip155:8453",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "pay_when": [
      "The free preview matches the buyer task and the agent needs the complete record-backed buyer pack.",
      "The buyer wants to decide which Taiwan official-source streams should become the next paid data package.",
      "The buyer wants supplier candidates, sample record shapes, top fields, and next endpoint paths in one agent handoff.",
      "The response will be used to brief a human analyst or agent workflow with lineage and limitations preserved."
    ],
    "do_not_pay_when": [
      "A facility uptime guarantee, production-capacity certification, insurance risk score, or site safety clearance.",
      "A substitute for supplier audit, engineering due diligence, environmental review, or legal advice.",
      "Credit scoring, procurement decisioning, investment advice, or trading advice."
    ]
  },
  "paid_endpoints": [
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/factory-operational-risk",
      "price": "$0.03",
      "best_first_paid_step": true
    }
  ],
  "deeper_packs": [
    {
      "pack_id": "tw_semiconductor_supplier_search",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-semiconductor/supplier-search?q={keyword}",
      "use_when": "The buyer is screening semiconductor or hardware suppliers by role, city, science park, or segment."
    },
    {
      "pack_id": "tw_company_brief",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "use_when": "The buyer has a business_id from a factory or supplier candidate and needs company-level context."
    },
    {
      "pack_id": "tw_compliance_risk_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/compliance-risk",
      "use_when": "The buyer wants public compliance, labor, environment, and ESG streams attached to operational context."
    }
  ],
  "entity_linking_contract": {
    "schema_version": "taiwan-entity-linking-contract-v1",
    "identity_keys": [
      "business_id",
      "company_name_zh",
      "company_name_en",
      "stock_code",
      "factory_name_zh",
      "source_record_key"
    ],
    "normalization_steps": [
      "Preserve original source-language names.",
      "Normalize whitespace and punctuation only for matching.",
      "Treat business_id and stock_code as routing hints, not legal identity certification."
    ],
    "next_free_endpoint": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}",
    "next_paid_endpoints": [
      "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-procurement/company-activity?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-entity-graph/relationship-pack?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-semiconductor/company-pack?business_id={business_id}"
    ],
    "boundary": "Entity linking is for buyer workflow routing and enrichment. It is not legal identity certification, beneficial ownership proof, credit scoring, or supplier ranking."
  },
  "freshness_policy": {
    "cache_ttl_seconds": 21600,
    "stale_after_seconds": 16200,
    "safe_to_cache": true,
    "valid_until_basis": "Preview and product metadata are generated per request; agents should re-fetch when stale before paying."
  },
  "x402_purchase": {
    "protocol": "x402",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED, Bazaar discovery metadata, and machine-readable x402 accepts when no valid payment header is provided.",
    "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
  },
  "advice_boundary": "Informational record-backed buyer pack only; not legal, compliance, procurement, credit, investment, tax, accounting, or trading advice."
}