{
  "product": "tw_procurement_supplier_signals",
  "mode": "agent_research_preview",
  "endpoint": "/v1/preview/tw-procurement/supplier-lead-pack",
  "generated_at": "2026-07-21T09:34:12.544Z",
  "retrieved_at": "2026-07-06T16:46:24.684Z",
  "source_freshness": {
    "status": "mixed_window",
    "retrieved_at": "2026-07-06T16:46:24.684Z",
    "oldest_retrieved_at": "2026-07-06T16:46:24.684Z",
    "newest_retrieved_at": "2026-07-14T20:44:19.640Z",
    "source_row_count": 6,
    "valid_retrieved_at_count": 6,
    "missing_or_invalid_retrieved_at_count": 0,
    "policy": "retrieved_at uses the oldest valid source-row timestamp so mixed datasets do not overstate freshness."
  },
  "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
  "metadata": {
    "schema_version": "sourcestrand-agent-trust-metadata-v1",
    "product_id": "tw_procurement_supplier_signals",
    "source_model": "taiwan_supplier_lead_pack_by_keyword_v1",
    "source_system": "source_strand_taiwan_procurement_official_open_data",
    "source_dataset": "tw_procurement_supplier_signals",
    "last_updated_at": "2026-07-06T16:46:24.684Z",
    "generated_at": null,
    "retrieved_at": "2026-07-06T16:46:24.684Z",
    "valid_until": null,
    "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
    "output_hash": null,
    "source_mode": null,
    "snapshot_version": null,
    "update_cadence": "official_source_rows_as_loaded_by_gateway",
    "cache_ttl_seconds": null,
    "stale_after_seconds": null,
    "safe_to_cache": null,
    "freshness": {
      "status": "mixed_window",
      "retrieved_at": "2026-07-06T16:46:24.684Z",
      "oldest_retrieved_at": "2026-07-06T16:46:24.684Z",
      "newest_retrieved_at": "2026-07-14T20:44:19.640Z",
      "source_row_count": 6,
      "valid_retrieved_at_count": 6,
      "missing_or_invalid_retrieved_at_count": 0,
      "policy": "retrieved_at uses the oldest valid source-row timestamp so mixed datasets do not overstate freshness."
    },
    "provenance_fields": [
      "metadata.source_model",
      "metadata.last_updated_at",
      "source_hash",
      "data_lineage",
      "limitations"
    ],
    "data_lineage_count": 6,
    "limitation_count": 6,
    "trust_note": "Use this keyword-first pack for supplier lead discovery with public procurement lineage; it is not supplier ranking or procurement advice."
  },
  "query": {
    "q": "software",
    "limit": 3
  },
  "query_interpretation": {
    "original_query": "software",
    "normalized_query": "software",
    "taxonomy_categories": [
      "information_technology"
    ],
    "matched_english_terms": [
      "software"
    ],
    "expanded_zh_hant_terms": [
      "資訊服務",
      "資訊系統",
      "軟體",
      "雲端",
      "人工智慧",
      "資安",
      "數位轉型",
      "電腦設備"
    ],
    "effective_terms": [
      "software",
      "資訊服務",
      "資訊系統",
      "軟體",
      "雲端",
      "人工智慧",
      "AI",
      "資安",
      "數位轉型",
      "電腦設備",
      "cloud",
      "artificial intelligence",
      "cybersecurity"
    ],
    "excluded_generic_terms": [],
    "scoring_version": "tw-procurement-relevance-v1",
    "minimum_score": 30,
    "interpretation_note": "Specific buyer terms and supported English-to-zh-Hant taxonomy terms are scored by matched field; generic procurement words cannot qualify a record by themselves."
  },
  "relevance_summary": {
    "scoring_version": "tw-procurement-relevance-v1",
    "minimum_score": 30,
    "matched_records": 6,
    "high_relevance_matches": 0,
    "medium_relevance_matches": 6,
    "low_relevance_matches": 0,
    "note": "Generic words such as services, procurement, and supplier cannot qualify a record by themselves."
  },
  "ranked_results": [
    {
      "kind": "award",
      "agency_name": "運動部全民運動署",
      "case_no": "115-02-002",
      "case_name": "115年度全民運動資訊系統維運及擴充案",
      "procurement_type": "services",
      "procurement_type_en": "services",
      "award_date": "2026-05-13",
      "award_amount_twd": 19000000,
      "supplier_name": "宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.)",
      "supplier_business_id": null,
      "supplier_match_status": "name_candidate",
      "identity_resolution": null,
      "retrieved_at": "2026-07-14T20:44:19.64+00:00",
      "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
      "relevance": {
        "score": 67,
        "band": "medium",
        "matched_fields": [
          "case_name",
          "supplier_name"
        ],
        "matched_terms": [
          "資訊系統",
          "資訊服務"
        ],
        "taxonomy_categories": [
          "information_technology"
        ],
        "rationale": "Matched 資訊系統, 資訊服務 in case_name, supplier_name; score uses field-specific weights and does not treat generic procurement words as sufficient evidence."
      },
      "opportunity_context": {
        "record_role": "historical_award_evidence",
        "buyer_use": "Use as incumbent and past-activity evidence for account research; do not present it as an open tender.",
        "caution": "Historical award evidence is not proof of current supplier status, future award likelihood, or procurement suitability."
      },
      "data_lineage": [
        {
          "dataset": "Recent six-month GPA award open data",
          "provider": "Public Construction Commission",
          "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
          "retrieved_at": "2026-07-14T20:44:19.640Z"
        }
      ],
      "record_summary_en": "Award record from 運動部全民運動署; case 115-02-002; supplier 宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.); type services."
    },
    {
      "kind": "notice",
      "agency_name": "內政部國土管理署",
      "case_no": "113A-078",
      "case_name": "「113年度住宅及不動產資訊系統擴充及管理維護」委託資訊服務案",
      "notice_type": "tender",
      "procurement_type": "services",
      "procurement_type_en": "services",
      "tender_method": "經公開評選或公開徵求之限制性招標",
      "announcement_date": null,
      "deadline_date": "2024-11-25",
      "budget_amount_twd": null,
      "retrieved_at": "2026-07-06T16:46:24.684+00:00",
      "source_hash": "sha256:c5fb372df9cc08bf264332a3ebc78cd40efaccf24189c35256b3346ca9230f45",
      "relevance": {
        "score": 62,
        "band": "medium",
        "matched_fields": [
          "case_name"
        ],
        "matched_terms": [
          "資訊服務",
          "資訊系統"
        ],
        "taxonomy_categories": [
          "information_technology"
        ],
        "rationale": "Matched 資訊服務, 資訊系統 in case_name; score uses field-specific weights and does not treat generic procurement words as sufficient evidence."
      },
      "opportunity_context": {
        "record_role": "tender_notice",
        "deadline_date": "2024-11-25",
        "buyer_use": "Review scope, deadline, agency, and source evidence before deciding whether this notice is an actionable sales opportunity.",
        "caution": "A notice is not an award, supplier endorsement, or guarantee that the opportunity remains open."
      },
      "data_lineage": [
        {
          "dataset": "Recent six-month GPA tender open data",
          "provider": "Public Construction Commission",
          "source_hash": "sha256:c5fb372df9cc08bf264332a3ebc78cd40efaccf24189c35256b3346ca9230f45",
          "retrieved_at": "2026-07-06T16:46:24.684Z"
        }
      ],
      "record_summary_en": "Tender notice from 內政部國土管理署; case 113A-078; type services."
    },
    {
      "kind": "award",
      "agency_name": "中華郵政股份有限公司",
      "case_no": "115-4-1025",
      "case_name": "115年資訊服務管理制度暨系統維護與增修服務",
      "procurement_type": "services",
      "procurement_type_en": "services",
      "award_date": "2026-04-14",
      "award_amount_twd": 18720000,
      "supplier_name": "勤業眾信聯合會計師事務所",
      "supplier_business_id": null,
      "supplier_match_status": "name_candidate",
      "identity_resolution": null,
      "retrieved_at": "2026-07-14T20:44:19.64+00:00",
      "source_hash": "sha256:6d67a67f7b44ccfa4285936b0ea4d8809ba089a762f92ea0d7e3d6c76f42a12d",
      "relevance": {
        "score": 60,
        "band": "medium",
        "matched_fields": [
          "case_name"
        ],
        "matched_terms": [
          "資訊服務"
        ],
        "taxonomy_categories": [
          "information_technology"
        ],
        "rationale": "Matched 資訊服務 in case_name; score uses field-specific weights and does not treat generic procurement words as sufficient evidence."
      },
      "opportunity_context": {
        "record_role": "historical_award_evidence",
        "buyer_use": "Use as incumbent and past-activity evidence for account research; do not present it as an open tender.",
        "caution": "Historical award evidence is not proof of current supplier status, future award likelihood, or procurement suitability."
      },
      "data_lineage": [
        {
          "dataset": "Recent six-month GPA award open data",
          "provider": "Public Construction Commission",
          "source_hash": "sha256:6d67a67f7b44ccfa4285936b0ea4d8809ba089a762f92ea0d7e3d6c76f42a12d",
          "retrieved_at": "2026-07-14T20:44:19.640Z"
        }
      ],
      "record_summary_en": "Award record from 中華郵政股份有限公司; case 115-4-1025; supplier 勤業眾信聯合會計師事務所; type services."
    }
  ],
  "change_since_last_run": {
    "comparison_status": "baseline_not_provided",
    "baseline_since": null,
    "comparison_scope": "current_ranked_query_results",
    "scoring_version": "tw-procurement-relevance-v1",
    "previous_source_hash_count": 0,
    "current_source_hash_count": 6,
    "added_source_hashes": [],
    "unchanged_source_hashes": [],
    "missing_previous_source_hashes": [],
    "records_with_event_date_since": null,
    "latest_event_date": "2026-05-13",
    "methodology": "No prior source hashes or since value were supplied, so change is not asserted.",
    "limitations": [
      "A missing_previous_source_hash means only that the hash is absent from this current query result; it does not prove upstream deletion.",
      "Event dates describe source events, not ingestion or first-observed timestamps.",
      "Compare baselines produced with the same query, result limit, and scoring_version; query, pagination, taxonomy, or threshold changes can alter the ranked result without an upstream record change.",
      "Persist the returned ranked_results source_hash values and send them as previous_source_hashes on the next run for a deterministic comparison."
    ]
  },
  "package_scope": {
    "tier": "free_preview",
    "buyer_pack_type": "supplier_lead_pack_by_keyword",
    "primary_paid_entrypoint": "/v1/paid/tw-procurement/supplier-lead-pack?q=software",
    "matched_award_count": 3,
    "matched_notice_count": 3,
    "supplier_candidate_count": 2,
    "sample_record_count": 1,
    "result_limit": 3,
    "sample_record_limit": 1,
    "supplier_candidate_limit": 2,
    "paid_upgrade_note": "The paid supplier-lead-pack endpoint raises the query limit, returns more sample records and supplier candidates, and adds paid workflow handoff metadata."
  },
  "commercial_preflight": {
    "payment_available": true,
    "result_count": 6,
    "reason": "Relevant production-backed records are present.",
    "settlement_policy": "The paid handler performs the same non-empty relevance check before settlement."
  },
  "evidence_quality": {
    "schema_version": "sourcestrand-procurement-evidence-quality-v1",
    "response_scope": {
      "basis": "matched_source_rows_examined_before_response_shaping",
      "per_collection_query_limit": 3,
      "matched_source_rows_examined": 6,
      "examined_award_rows": 3,
      "examined_notice_rows": 3,
      "primary_result_rows_returned": 3,
      "primary_result_limit": 3,
      "may_be_source_truncated": true,
      "source_truncation_basis": "post_filter_collection_reached_configured_limit",
      "complete_history": false,
      "full_market_coverage": false
    },
    "identity_coverage": {
      "examined_award_rows": 3,
      "exact_business_id_rows": 0,
      "audited_unique_exact_name_rows": 0,
      "name_candidate_rows": 3,
      "unmatched_rows": 0,
      "exact_business_id_rate": 0
    },
    "field_coverage": {
      "award_amount_present_rows": 3,
      "award_date_present_rows": 3
    },
    "competition_evidence": {
      "normalized_bid_participants_available": false,
      "observed_non_winner_rows": 0,
      "observed_non_winner_frequency_available": false,
      "verified_same_tender_competitors_available": false
    },
    "relationship_intelligence": {
      "available": false,
      "schema_version": null,
      "analysis_sample_status": null,
      "known_amount_coverage_rate": null,
      "concentration_basis": "audited identity-linked awards in the stated observation window",
      "complete_market_coverage": false
    },
    "confidence_policy": {
      "aggregate_confidence": null,
      "exact_business_id_confidence": 1,
      "audited_unique_exact_name_confidence": 0.99,
      "name_only_identity_confidence": null
    },
    "claim_boundaries": {
      "permitted": [
        "observed award activity in returned connected-source rows",
        "audited unique exact-name identity links",
        "observed same-tender winner and non-winner evidence",
        "observed award count and known-amount agency concentration",
        "observed repeat-award agency relationships across captured years",
        "supplier-name candidate discovery",
        "incumbent and peer-supplier evidence review"
      ],
      "not_supported": [
        "complete three-year win rate",
        "verified competitor identities or a complete same-tender competitor network",
        "government revenue dependency",
        "contract renewal or continuation",
        "complete Taiwan procurement coverage"
      ]
    }
  },
  "why_buy_paid": [
    "$0.01 is a low-friction paid validation step after the free preview.",
    "The paid agent package returns more rows and more supplier candidates than the free preview.",
    "Responses preserve official-source lineage, limitations, retrieval timestamps, and hashes for downstream audit.",
    "English buyer summaries and English query expansion reduce the translation burden for global market research workflows."
  ],
  "paid_response_delta": {
    "preview_limit": 3,
    "preview_sample_records": 1,
    "preview_supplier_candidates": 2,
    "paid_agent_research_limit": 20,
    "paid_sample_records": 10,
    "paid_supplier_candidates": 10,
    "paid_adds": [
      "More field-weighted tender and award rows for the same buyer query.",
      "More sample records for evidence review before deeper company activity or supplier-pack calls.",
      "More supplier candidate groups with explicit identity evidence and null confidence when no verified identifier exists.",
      "query_interpretation, relevance_summary, ranked_results, and honest change_since_last_run metadata.",
      "agent_handoff metadata for buyer agents to preserve lineage, limitations, retrieved_at, and source_hash.",
      "For business_id supplier-profile calls, audited unique-exact company links, annual award activity, agency count concentration, coverage-gated known-amount concentration, repeat-award relationships, and bounded same-tender co-occurrence evidence."
    ],
    "evidence_delta": {
      "preview": "A bounded evidence sample with the same identity and coverage caveats.",
      "paid": "A larger bounded evidence set with more sample rows and supplier candidate groups.",
      "does_not_add": [
        "full-market procurement coverage",
        "verified identity for name-only supplier candidates",
        "complete win-rate evidence",
        "government-revenue dependency evidence",
        "contract-renewal evidence",
        "a complete competitor graph"
      ]
    },
    "upgrade_path": [
      {
        "endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
        "price": "$0.01",
        "when_to_use": "First paid step after preview when an AI agent or analyst needs a structured supplier lead pack by keyword."
      },
      {
        "endpoint": "/v1/paid/tw-procurement/tender-search?q={keyword}",
        "price": "$0.03",
        "when_to_use": "Use for broader keyword, agency, supplier, case name, or case number discovery."
      },
      {
        "endpoint": "/v1/paid/tw-procurement/company-activity?business_id={business_id}",
        "price": "$0.05",
        "when_to_use": "Use when a Taiwan business_id is available and the buyer wants company-level activity."
      },
      {
        "endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
        "price": "$0.05",
        "when_to_use": "Use after a target supplier is selected and the buyer needs audited identity links, annual awards, agency concentration, repeat-award relationships, and bounded same-tender co-occurrence evidence.",
        "repeat_purchase_preflight": "/v1/preview/tw-procurement/supplier-pack-state?business_id={business_id}&since={prior_output_hash}",
        "conditional_paid_endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}&since={prior_output_hash}",
        "unchanged_http_status": 304,
        "unchanged_is_charged": false
      }
    ]
  },
  "recommended_paid_call": {
    "endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q=software",
    "price": "$0.01",
    "buyer_hint_header": "x-buyer-hint: caller-installation-id",
    "resource_url": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-lead-pack?q=software",
    "checkout_url": "https://api.sourcestrand.com/checkout?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Fsupplier-lead-pack%3Fq%3Dsoftware",
    "payment_intent_url": "https://api.sourcestrand.com/v1/payment/intent?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Fsupplier-lead-pack%3Fq%3Dsoftware"
  },
  "agent_summary": {
    "one_liner": "Found 3 award records and 3 tender notice records for \"software\" in currently loaded Taiwan public procurement data.",
    "key_findings": [
      "3 matching award records.",
      "3 matching tender notice records.",
      "2 supplier candidate groups surfaced from award rows.",
      "Known disclosed award amount total in matched award rows is 41200000 TWD."
    ],
    "top_agencies": [
      "中華郵政股份有限公司",
      "內政部國土管理署",
      "核能安全委員會",
      "經濟部產業發展署",
      "農業部農田水利署"
    ],
    "best_used_for": [
      "Fast supplier lead preflight before a paid tender-search or company-level call.",
      "B2B account discovery where Taiwan public-sector activity is relevant.",
      "Incumbent and peer-supplier monitoring with source lineage."
    ],
    "action_boundary": "Factual public procurement discovery only; not procurement advice, supplier ranking, legal advice, credit scoring, investment advice, or a risk clearance."
  },
  "english_summary": {
    "one_liner": "Taiwan public procurement activity was found for \"software\": 3 award records and 3 tender notice records.",
    "key_findings": [
      "3 award records matched.",
      "3 tender notice records matched.",
      "Top agencies include 中華郵政股份有限公司, 內政部國土管理署, 核能安全委員會.",
      "Known disclosed award amount total is 41200000 TWD."
    ],
    "search_terms_en": [
      "B2B supplier research",
      "government tender",
      "public-sector award",
      "services",
      "supplier activity",
      "Taiwan procurement"
    ],
    "source_language": "zh-Hant",
    "summary_language": "en",
    "translation_method": "Template-based English buyer summary from structured Taiwan official-source fields; original Taiwan source-language fields are preserved."
  },
  "global_buyer_context": {
    "market": "Taiwan",
    "market_scope": "Taiwan public procurement open-data rows currently loaded into this x402 gateway; not a full-market commercial registry.",
    "buyer_language": "en",
    "source_language": "zh-Hant",
    "best_for": [
      "Global B2B account discovery where Taiwan public-sector activity is relevant.",
      "Agent preflight before paid tender search, company activity, or supplier-pack calls.",
      "Incumbent and peer-supplier monitoring with retained source lineage."
    ],
    "caveats": [
      "Original Taiwan source-language names remain the source of truth for legal and audit use.",
      "English summaries are template-based buyer-facing interpretations, not certified translations.",
      "English buyer queries are expanded into selected Taiwan source-language terms before matching currently loaded procurement rows.",
      "Absence of a match is not evidence that no public procurement activity exists."
    ]
  },
  "supplier_candidates": [
    {
      "supplier_name": "宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.)",
      "supplier_business_id": null,
      "match_basis": "supplier_name_from_award_row",
      "identity_resolution": {
        "status": "unresolved_name_only",
        "confidence": null,
        "confidence_basis": "not_scored",
        "evidence": [
          {
            "case_no": "115-02-002",
            "supplier_name": "宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.)",
            "supplier_business_id": null,
            "supplier_match_status": "name_candidate",
            "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417"
          }
        ],
        "limitations": [
          "The source rows contain a supplier name but no business_id; numeric identity confidence is not asserted."
        ]
      },
      "award_count": 1,
      "total_award_amount_twd": 19000000,
      "latest_award_date": "2026-05-13",
      "agencies": [
        "運動部全民運動署"
      ],
      "sample_case_numbers": [
        "115-02-002"
      ],
      "next_available_calls": [
        {
          "label": "supplier_name_search_paid",
          "endpoint": "/v1/paid/tw-procurement/tender-search?q=%E5%AE%8F%E7%A2%81%E8%B3%87%E8%A8%8A%E6%9C%8D%E5%8B%99%E8%82%A1%E4%BB%BD%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8%20(ACER%20E-ENABLING%20SERVICE%20BUSINESS%20INC.)",
          "price": "$0.03"
        }
      ],
      "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417"
    },
    {
      "supplier_name": "勤業眾信聯合會計師事務所",
      "supplier_business_id": null,
      "match_basis": "supplier_name_from_award_row",
      "identity_resolution": {
        "status": "unresolved_name_only",
        "confidence": null,
        "confidence_basis": "not_scored",
        "evidence": [
          {
            "case_no": "115-4-1025",
            "supplier_name": "勤業眾信聯合會計師事務所",
            "supplier_business_id": null,
            "supplier_match_status": "name_candidate",
            "source_hash": "sha256:6d67a67f7b44ccfa4285936b0ea4d8809ba089a762f92ea0d7e3d6c76f42a12d"
          }
        ],
        "limitations": [
          "The source rows contain a supplier name but no business_id; numeric identity confidence is not asserted."
        ]
      },
      "award_count": 1,
      "total_award_amount_twd": 18720000,
      "latest_award_date": "2026-04-14",
      "agencies": [
        "中華郵政股份有限公司"
      ],
      "sample_case_numbers": [
        "115-4-1025"
      ],
      "next_available_calls": [
        {
          "label": "supplier_name_search_paid",
          "endpoint": "/v1/paid/tw-procurement/tender-search?q=%E5%8B%A4%E6%A5%AD%E7%9C%BE%E4%BF%A1%E8%81%AF%E5%90%88%E6%9C%83%E8%A8%88%E5%B8%AB%E4%BA%8B%E5%8B%99%E6%89%80",
          "price": "$0.03"
        }
      ],
      "source_hash": "sha256:6d67a67f7b44ccfa4285936b0ea4d8809ba089a762f92ea0d7e3d6c76f42a12d"
    }
  ],
  "sample_records": [
    {
      "kind": "award",
      "agency_name": "運動部全民運動署",
      "case_no": "115-02-002",
      "case_name": "115年度全民運動資訊系統維運及擴充案",
      "procurement_type": "services",
      "procurement_type_en": "services",
      "award_date": "2026-05-13",
      "award_amount_twd": 19000000,
      "supplier_name": "宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.)",
      "supplier_business_id": null,
      "supplier_match_status": "name_candidate",
      "identity_resolution": null,
      "retrieved_at": "2026-07-14T20:44:19.64+00:00",
      "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
      "relevance": {
        "score": 67,
        "band": "medium",
        "matched_fields": [
          "case_name",
          "supplier_name"
        ],
        "matched_terms": [
          "資訊系統",
          "資訊服務"
        ],
        "taxonomy_categories": [
          "information_technology"
        ],
        "rationale": "Matched 資訊系統, 資訊服務 in case_name, supplier_name; score uses field-specific weights and does not treat generic procurement words as sufficient evidence."
      },
      "opportunity_context": {
        "record_role": "historical_award_evidence",
        "buyer_use": "Use as incumbent and past-activity evidence for account research; do not present it as an open tender.",
        "caution": "Historical award evidence is not proof of current supplier status, future award likelihood, or procurement suitability."
      },
      "data_lineage": [
        {
          "dataset": "Recent six-month GPA award open data",
          "provider": "Public Construction Commission",
          "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
          "retrieved_at": "2026-07-14T20:44:19.640Z"
        }
      ],
      "record_summary_en": "Award record from 運動部全民運動署; case 115-02-002; supplier 宏碁資訊服務股份有限公司 (ACER E-ENABLING SERVICE BUSINESS INC.); type services."
    }
  ],
  "agent_handoff": {
    "primary_paid_endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q=software",
    "buyer_hint_header": "x-buyer-hint: caller-installation-id",
    "recommended_next_steps": [
      "Use supplier_candidates to decide whether to run supplier-name tender search or business_id company activity.",
      "Use sample_records for quick evidence review before requesting deeper supplier packs.",
      "Preserve data_lineage, limitations, retrieved_at, and source_hash when storing or displaying results."
    ],
    "copy_ready_fields": [
      "agent_summary.one_liner",
      "agent_summary.key_findings",
      "supplier_candidates",
      "sample_records",
      "paid_unlock",
      "evidence_quality",
      "data_lineage",
      "limitations"
    ]
  },
  "paid_unlock": {
    "supplier_lead_pack": {
      "endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q=software",
      "resource_url": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-lead-pack?q=software",
      "checkout_url": "https://api.sourcestrand.com/checkout?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Fsupplier-lead-pack%3Fq%3Dsoftware",
      "payment_intent_url": "https://api.sourcestrand.com/v1/payment/intent?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Fsupplier-lead-pack%3Fq%3Dsoftware",
      "price": "$0.01",
      "includes": "Keyword-first Taiwan supplier lead pack with supplier candidates, agencies, incumbent and peer-supplier evidence, sample records, marketplace metadata, lineage, and limitations."
    },
    "tender_search": {
      "endpoint": "/v1/paid/tw-procurement/tender-search?q=software",
      "resource_url": "https://api.sourcestrand.com/v1/paid/tw-procurement/tender-search?q=software",
      "checkout_url": "https://api.sourcestrand.com/checkout?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Ftender-search%3Fq%3Dsoftware",
      "payment_intent_url": "https://api.sourcestrand.com/v1/payment/intent?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-procurement%2Ftender-search%3Fq%3Dsoftware",
      "price": "$0.03",
      "includes": "Full tender and award search results with the configured paid result limit, source lineage, limitations, and product metadata."
    },
    "company_activity": {
      "endpoint_template": "/v1/paid/tw-procurement/company-activity?business_id={business_id}",
      "price": "$0.05",
      "includes": "Company-level supplier activity when a Taiwan business_id is available."
    },
    "supplier_pack": {
      "endpoint_template": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
      "price": "$0.05",
      "includes": "Buyer-ready supplier activity pack with audited unique-exact identity links, observed three-year linked-award context, bounded same-tender winner/non-winner evidence, awards, related notices, lineage, and limitations where available."
    },
    "buyer_hint_header": "x-buyer-hint: caller-installation-id"
  },
  "marketplace_test_metadata": {
    "service_name": "Taiwan Supplier Lead Pack by Keyword",
    "test_endpoint": "/v1/preview/tw-procurement/supplier-lead-pack?q={keyword}",
    "paid_endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
    "legacy_test_endpoint": "/v1/preview/tw-procurement/agent-research?q={keyword}",
    "legacy_payment_available": false,
    "positioning": "Agent-ready Taiwan supplier lead pack by keyword for B2B account discovery, incumbent and peer-supplier research, and tender monitoring.",
    "tags": [
      "taiwan procurement",
      "taiwan supplier lead pack",
      "government contracts",
      "supplier intelligence",
      "supplier candidates",
      "tender search",
      "b2b sales",
      "asia company data",
      "x402 paid api"
    ],
    "bazaar_shape_preview": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "q": "software"
        }
      },
      "output": {
        "type": "json",
        "includes": [
          "agent_summary",
          "supplier_candidates",
          "sample_records",
          "paid_unlock",
          "data_lineage",
          "limitations"
        ]
      }
    }
  },
  "product_metadata": {
    "title": "Taiwan Procurement Supplier Intelligence",
    "product_id": "tw_procurement_supplier_signals",
    "primary_paid_entrypoint": "/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
    "buyer_use_cases": [
      "B2B sales account research",
      "Supplier evaluation research",
      "Government tender monitoring",
      "Incumbent and peer-supplier evidence tracking",
      "Government-customer concentration and repeat-award relationship research"
    ],
    "search_hints": [
      "Start with supplier-lead-pack by English keyword when the buyer does not know a Taiwan business_id yet.",
      "Search by case number, for example 110A-134.",
      "Search by agency name, supplier name, procurement type, or case name.",
      "English buyer queries such as software, AI, cybersecurity, construction, medical, education, transport, security, or cleaning are expanded into selected Taiwan source-language terms; generic terms cannot qualify a record alone.",
      "Use company-activity or supplier-pack when a Taiwan business_id is available."
    ],
    "coverage_note": "Official public procurement open-data rows currently loaded into this gateway; coverage is not the full universe of Taiwan procurement activity.",
    "coverage_snapshot": {
      "inventory_source": "live Supabase admin inventory",
      "static_marketing_counts_used": false,
      "scope_note": "Per-response results expose source evidence and timestamps; the dataset is selected official open-data coverage, not a full-market registry."
    },
    "source_trust": {
      "provider": "Public Construction Commission, Taiwan",
      "source_type": "official public open data",
      "source_language": "zh-Hant",
      "source_note": "Original Taiwan source-language fields are preserved for audit use; English summaries are buyer-facing interpretations, not certified translations."
    },
    "machine_readable_offer": {
      "primary": "/ai-offer.json",
      "alias": "/data-products/tw-procurement.json"
    },
    "language_strategy": {
      "source_language": "zh-Hant",
      "buyer_language": "en",
      "original_fields_preserved": true,
      "english_query_supported": true,
      "english_summary_method": "Template-based buyer summaries from structured official-source fields; not certified translations.",
      "query_expansion_method": "English buyer keywords are expanded into selected Taiwan procurement source terms before source search; original Taiwan source-language fields remain preserved in records."
    },
    "available_paid_endpoints": [
      {
        "method": "GET",
        "path": "/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
        "price": "$0.01",
        "best_for": "Agent-ready Taiwan supplier lead pack by keyword: supplier candidates, incumbents, peer suppliers, agencies, evidence rows, lineage, and next company lookups.",
        "best_first_paid_step": true
      },
      {
        "method": "GET",
        "path": "/v1/paid/tw-procurement/tender-search?q={keyword}",
        "price": "$0.03",
        "best_for": "Low-cost discovery by keyword, agency, supplier, case name, or case number."
      },
      {
        "method": "GET",
        "path": "/v1/paid/tw-procurement/company-activity?business_id={business_id}",
        "price": "$0.05",
        "best_for": "Company-level supplier activity summary linked to Taiwan Company Intelligence."
      },
      {
        "method": "GET",
        "path": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
        "conditional_path": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}&since={prior_output_hash}",
        "free_state_manifest_path": "/v1/preview/tw-procurement/supplier-pack-state?business_id={business_id}&since={prior_output_hash}",
        "unchanged_http_status": 304,
        "unchanged_is_charged": false,
        "price": "$0.05",
        "best_for": "Audited supplier profile with annual award activity, agency count concentration, coverage-gated known-amount concentration, repeat-award relationships, and bounded same-tender co-occurrence evidence; introductory parity pricing remains while coverage expands."
      }
    ],
    "paid_response_delta": {
      "preview_limit": 3,
      "preview_sample_records": 1,
      "preview_supplier_candidates": 2,
      "paid_agent_research_limit": 20,
      "paid_sample_records": 10,
      "paid_supplier_candidates": 10,
      "paid_adds": [
        "More field-weighted tender and award rows for the same buyer query.",
        "More sample records for evidence review before deeper company activity or supplier-pack calls.",
        "More supplier candidate groups with explicit identity evidence and null confidence when no verified identifier exists.",
        "query_interpretation, relevance_summary, ranked_results, and honest change_since_last_run metadata.",
        "agent_handoff metadata for buyer agents to preserve lineage, limitations, retrieved_at, and source_hash.",
        "For business_id supplier-profile calls, audited unique-exact company links, annual award activity, agency count concentration, coverage-gated known-amount concentration, repeat-award relationships, and bounded same-tender co-occurrence evidence."
      ],
      "evidence_delta": {
        "preview": "A bounded evidence sample with the same identity and coverage caveats.",
        "paid": "A larger bounded evidence set with more sample rows and supplier candidate groups.",
        "does_not_add": [
          "full-market procurement coverage",
          "verified identity for name-only supplier candidates",
          "complete win-rate evidence",
          "government-revenue dependency evidence",
          "contract-renewal evidence",
          "a complete competitor graph"
        ]
      },
      "upgrade_path": [
        {
          "endpoint": "/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
          "price": "$0.01",
          "when_to_use": "First paid step after preview when an AI agent or analyst needs a structured supplier lead pack by keyword."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/tender-search?q={keyword}",
          "price": "$0.03",
          "when_to_use": "Use for broader keyword, agency, supplier, case name, or case number discovery."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/company-activity?business_id={business_id}",
          "price": "$0.05",
          "when_to_use": "Use when a Taiwan business_id is available and the buyer wants company-level activity."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
          "price": "$0.05",
          "when_to_use": "Use after a target supplier is selected and the buyer needs audited identity links, annual awards, agency concentration, repeat-award relationships, and bounded same-tender co-occurrence evidence.",
          "repeat_purchase_preflight": "/v1/preview/tw-procurement/supplier-pack-state?business_id={business_id}&since={prior_output_hash}",
          "conditional_paid_endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id={business_id}&since={prior_output_hash}",
          "unchanged_http_status": 304,
          "unchanged_is_charged": false
        }
      ]
    },
    "free_sample_endpoint": "/samples/tw-procurement-supplier-signal.json",
    "free_supplier_pack_state_endpoint": "/v1/preview/tw-procurement/supplier-pack-state?business_id={business_id}&since={prior_output_hash}",
    "advice_boundary": "Factual supplier activity signals only; not procurement advice, legal advice, credit scoring, investment advice, or supplier ranking."
  },
  "data_lineage": [
    {
      "dataset": "Recent six-month GPA award open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:acd18a0c22cc1711391d25a47876c22626aa80fade011f173c6c8b3bf24b4417",
      "retrieved_at": "2026-07-14T20:44:19.640Z"
    },
    {
      "dataset": "Recent six-month GPA award open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:6d67a67f7b44ccfa4285936b0ea4d8809ba089a762f92ea0d7e3d6c76f42a12d",
      "retrieved_at": "2026-07-14T20:44:19.640Z"
    },
    {
      "dataset": "Recent six-month GPA award open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:125d230870d701481fa2dac299a1369dbcfc098eba764ac6c8f46843aae789c9",
      "retrieved_at": "2026-07-14T20:44:19.640Z"
    },
    {
      "dataset": "Recent six-month GPA tender open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:c5fb372df9cc08bf264332a3ebc78cd40efaccf24189c35256b3346ca9230f45",
      "retrieved_at": "2026-07-06T16:46:24.684Z"
    },
    {
      "dataset": "Recent six-month GPA tender open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:600b290cc492c72cb7c473ccf8eb3e5fe6405826a36a26fafdc6b8758c6ce34b",
      "retrieved_at": "2026-07-06T16:46:24.684Z"
    },
    {
      "dataset": "Recent six-month GPA tender open data",
      "provider": "Public Construction Commission",
      "source_hash": "sha256:008167716d1b0f26452ba0fd63caff3d503b59817b641f02a540067ba07c3353",
      "retrieved_at": "2026-07-06T16:46:24.684Z"
    }
  ],
  "limitations": [
    {
      "code": "official_open_data_scope",
      "message": "This response summarizes records loaded from official public procurement open-data downloads that were available to this gateway.",
      "severity": "info"
    },
    {
      "code": "supplier_name_matching_unverified",
      "message": "Supplier business_id linkage may be unavailable when official procurement rows provide supplier names but not unified business numbers.",
      "severity": "caution"
    },
    {
      "code": "not_procurement_recommendation",
      "message": "Supplier activity signals are factual summaries only and are not procurement advice, legal advice, credit scores, or risk clearances.",
      "severity": "caution"
    },
    {
      "code": "bounded_returned_row_scope",
      "message": "Counts and field coverage describe matched source rows examined under per-collection query limits; primary response rows may be separately ranked or sampled. Source truncation remains unknown when raw query limit-hit metadata is unavailable, and these are not complete historical or full-market statistics.",
      "severity": "caution"
    },
    {
      "code": "bid_participants_not_available_for_returned_rows",
      "message": "Normalized same-tender bidder evidence was not available for the returned company activity rows.",
      "severity": "caution"
    },
    {
      "code": "award_amount_not_recognized_revenue",
      "message": "Disclosed award amounts are procurement evidence, not recognized company revenue and not a government-revenue dependency ratio.",
      "severity": "caution"
    }
  ],
  "not_legal_advice": true,
  "not_financial_advice": true,
  "not_procurement_advice": true
}