[AI-05] ACP choreography (G3 Flash) (retry 1)

{
  "code": "File: ntq-poc/src/lib/acp-agents.ts\n\nACP (Agent Communication Protocol) module for buyer/seller marketplace agents.\n\nContents:\n1. **Zod Schemas** (module-level, .safeParse()):\n   - `AgentRoleSchema`: buyer_agent | seller_agent | marketplace_orchestrator\n   - `ACPMessageTypeSchema`: 13 message types (price_inquiry, negotiate_offer, order_intent, etc.)\n   - `ACPMessageSchema`: Full message envelope with id, type, from, to, payload, correlation_id, timestamp, ttl_ms\n   - `ACPSessionSchema`: Session state (idle→negotiating→agreed→ordering→completed/cancelled)\n   - `NegotiationResultSchema`: Outcome with final_price, rounds, buyer/seller initial offers\n\n2. **BuyerAgent class**:\n   - `createPriceInquiry()` — initiates price discovery\n   - `createAvailabilityCheck()` — checks stock\n   - `respondToPrice()` — evaluates seller price → accept/counter/reject with configurable step\n   - `createOrderIntent()` — places order after agreement\n\n3. **SellerAgent class**:\n   - `respondToPriceInquiry()` — returns listed price + negotiable flag\n   - `respondToAvailabilityCheck()` — checks inventory Map\n   - `respondToOffer()` — evaluates buyer offer → accept/counter/reject\n   - `confirmOrder()` — reserves inventory or cancels if insufficient\n\n4. **`runNegotiation()`** — Full choreography: buyer starts at 70% of list price, iterates up to maxRounds with alternating counter-offers. Returns NegotiationResult.\n\n5. **Helpers**: `buildMessage()` (auto UUID + timestamp + Zod validation), `validateACPMessage()` (returns {data, error} pattern)\n\nConventions: Trilingual comments (EN/VI/ES), Zod at module level, {data, error} return pattern, SPEC Section AI-05 refs.",
  "content": "File: ntq-poc/src/lib/acp-agents.ts\n\nACP (Agent Communication Protocol) module for buyer/seller marketplace agents.\n\nContents:\n1. **Zod Schemas** (module-level, .safeParse()):\n   - `AgentRoleSchema`: buyer_agent | seller_agent | marketplace_orchestrator\n   - `ACPMessageTypeSchema`: 13 message types (price_inquiry, negotiate_offer, order_intent, etc.)\n   - `ACPMessageSchema`: Full message envelope with id, type, from, to, payload, correlation_id, timestamp, ttl_ms\n   - `ACPSessionSchema`: Session state (idle→negotiating→agreed→ordering→completed/cancelled)\n   - `NegotiationResultSchema`: Outcome with final_price, rounds, buyer/seller initial offers\n\n2. **BuyerAgent class**:\n   - `createPriceInquiry()` — initiates price discovery\n   - `createAvailabilityCheck()` — checks stock\n   - `respondToPrice()` — evaluates seller price → accept/counter/reject with configurable step\n   - `createOrderIntent()` — places order after agreement\n\n3. **SellerAgent class**:\n   - `respondToPriceInquiry()` — returns listed price + negotiable flag\n   - `respondToAvailabilityCheck()` — checks inventory Map\n   - `respondToOffer()` — evaluates buyer offer → accept/counter/reject\n   - `confirmOrder()` — reserves inventory or cancels if insufficient\n\n4. **`runNegotiation()`** — Full choreography: buyer starts at 70% of list price, iterates up to maxRounds with alternating counter-offers. Returns NegotiationResult.\n\n5. **Helpers**: `buildMessage()` (auto UUID + timestamp + Zod validation), `validateACPMessage()` (returns {data, error} pattern)\n\nConventions: Trilingual comments (EN/VI/ES), Zod at module level, {data, error} return pattern, SPEC Section AI-05 refs."
}