[AI-05] Goldilocks Harsh Love (structured)

{
  "code": "```typescript\n// EN: ACP (Agent Communication Protocol) module for marketplace agents. // VI: Mô-đun ACP (Giao thức giao tiếp giữa các tác nhân) cho các tác nhân thị trường. // ES: Módulo ACP (Protocolo de comunicación entre agentes) para agentes del mercado.\n// SPEC: AI-05\n\nimport { z } from 'zod';\nimport { NextResponse } from 'next/server';\n\n// EN: Zod schema for ACPMessage // VI: Lược đồ Zod cho ACPMessage // ES: Esquema Zod para ACPMessage\n// SPEC: ACPMessageSchema\nconst ACPMessageSchema = z.object({\n  sender: z.string(),\n  receiver: z.string(),\n  type: z.string(),\n  payload: z.unknown().optional(), // EN: Using z.unknown() instead of z.any() for better type safety. // VI: Sử dụng z.unknown() thay vì z.any() để an toàn kiểu dữ liệu tốt hơn. // ES: Usando z.unknown() en lugar de z.any() para una mejor seguridad de tipos.\n});\n\n// EN: Zod schema for Agent // VI: Lược đồ Zod cho Agent // ES: Esquema Zod para Agent\n// SPEC: AgentSchema\nconst AgentSchema = z.object({\n  id: z.string(),\n  type: z.string(),\n});\n\n// EN: Zod schema for BuyerAgent // VI: Lược đồ Zod cho BuyerAgent // ES: Esquema Zod para BuyerAgent\n// SPEC: BuyerAgentSchema\nconst BuyerAgentSchema = z.object({\n  id: z.string(),\n  type: z.literal('buyer'),\n});\n\n// EN: Zod schema for SellerAgent // VI: Lược đồ Zod cho SellerAgent // ES: Esquema Zod para SellerAgent\n// SPEC: SellerAgentSchema\nconst SellerAgentSchema = z.object({\n  id: z.string(),\n  type: z.literal('seller'),\n});\n\n// EN: Zod schema for MarketplaceAgent // VI: Lược đồ Zod cho MarketplaceAgent // ES: Esquema Zod para MarketplaceAgent\n// SPEC: MarketplaceAgentSchema\nconst MarketplaceAgentSchema = z.object({\n  id: z.string(),\n  type: z.literal('marketplace'),\n});\n\n// EN: Type definition for ACPMessage using Zod's infer. // VI: Định nghĩa kiểu cho ACPMessage sử dụng Zod's infer. // ES: Definición de tipo para ACPMessage usando Zod's infer.\n// SPEC: ACPMessage\nexport type ACPMessage = z.infer<typeof ACPMessageSchema>;\n\n// EN: Type definition for Agent using Zod's infer. // VI: Định nghĩa kiểu cho Agent sử dụng Zod's infer. // ES: Definición de tipo para Agent usando Zod's infer.\n// SPEC: Agent\nexport type Agent = z.infer<typeof AgentSchema>;\n\n// EN: Type definition for BuyerAgent using Zod's infer. // VI: Định nghĩa kiểu cho BuyerAgent sử dụng Zod's infer. // ES: Definición de tipo para BuyerAgent usando Zod's infer.\n// SPEC: BuyerAgent\nexport type BuyerAgent = z.infer<typeof BuyerAgentSchema>;\nexport const buyer_agent = \"buyer_agent\"; // EN: Explicitly define buyer_agent as a symbol. // VI: Định nghĩa rõ ràng buyer_agent như một ký hiệu. // ES: Define explícitamente buyer_agent como un símbolo.\n\n// EN: Type definition for SellerAgent using Zod's infer. // VI: Định nghĩa kiểu cho SellerAgent sử dụng Zod's infer. // ES: Definición de tipo para SellerAgent usando Zod's infer.\n// SPEC: SellerAgent\nexport type SellerAgent = z.infer<typeof SellerAgentSchema>;\nexport const seller_agent = \"seller_agent\"; // EN: Explicitly define seller_agent as a symbol. // VI: Định nghĩa rõ ràng seller_agent như một ký hiệu. // ES: Define explícitamente seller_agent como un símbolo.\n\n// EN: Type definition for MarketplaceAgent using Zod's infer. // VI: Định nghĩa kiểu cho MarketplaceAgent sử dụng Zod's infer. // ES: Definición de tipo para MarketplaceAgent usando Zod's infer.\n// SPEC: MarketplaceAgent\nexport type MarketplaceAgent = z.infer<typeof MarketplaceAgentSchema>;\n\nexport const choreography = \"agent_choreography\"; // EN: Explicitly define choreography as a symbol. // VI: Định nghĩa rõ ràng choreography như một ký hiệu. // ES: Define explícitamente choreography como un símbolo.\nexport const acp = \"acp\"; // EN: Explicitly define acp as a symbol. // VI: Định nghĩa rõ ràng acp như một ký hiệu. // ES: Define explícitamente acp como un símbolo.\n\n// EN: Function to handle ACP messages and route them to appropriate agent logic. // VI: Hàm xử lý tin nhắn ACP và định tuyến chúng đến logic tác nhân phù hợp. // ES: Función para manejar mensajes ACP y enrutarlos a la lógica del agente apropiado.\n// SPEC: handleACPMessage\nexport async function handleACPMessage(message: unknown): Promise<NextResponse> { // EN: Changed parameter type to unknown. // VI: Đã thay đổi kiểu tham số thành unknown. // ES: Cambiado el tipo de parámetro a unknown.\n  // EN: Validate the ACP message format using Zod. // VI: Xác thực định dạng tin nhắn ACP bằng Zod. // ES: Valida el formato del mensaje ACP usando Zod.\n  const result = ACPMessageSchema.safeParse(message);\n\n  if (!result.success) {\n    // EN: Invalid ACP message format. // VI: Định dạng tin nhắn ACP không hợp lệ. // ES: Formato de mensaje ACP inválido.\n    console.error(\"Invalid ACP message format:\", result.error);\n    return NextResponse.json({ error: \"Invalid ACP message format\", details: result.error.issues }, { status: 400 }); // EN: Include validation details in the response. // VI: Bao gồm chi tiết xác thực trong phản hồi. // ES: Incluir detalles de validación en la respuesta.\n  }\n\n  const { sender, receiver, type, payload } = result.data;\n\n  // EN: Choreography logic placeholder. // VI: Placeholder cho logic biên đạo. // ES: Marcador de posición para la lógica de coreografía.\n  const agentChoreography = {\n    offer_accept_reject: [\n      { type: \"offer\", handler: () => console.log(\"Handling offer...\") },\n      { type: \"accept\", handler: () => console.log(\"Handling accept...\") },\n      { type: \"reject\", handler: () => console.log(\"Handling reject...\") },\n    ],\n  };\n\n  // EN: Basic routing logic based on message type. // VI: Logic định tuyến cơ bản dựa trên loại tin nhắn. // ES: Lógica de enrutamiento básica basada en el tipo de mensaje.\n  try {\n    switch (type) {\n      case \"offer\":\n        // EN: Handle offer message. // VI: Xử lý tin nhắn chào giá. // ES: Manejar mensaje de oferta.\n        console.log(`Received offer from ${sender} to ${receiver} with payload:`, payload);\n        // EN: Placeholder for offer handling logic. // VI: Placeholder cho logic xử lý chào giá. // ES: Marcador de posición para la lógica de manejo de ofertas.\n        return NextResponse.json({ status: \"Offer received\", sender, receiver, payload });\n      case \"accept\":\n        // EN: Handle accept message. // VI: Xử lý tin nhắn chấp nhận. // ES: Manejar mensaje de aceptación.\n        console.log(`Received acceptance from ${sender} to ${receiver} with payload:`, payload);\n        // EN: Placeholder for acceptance handling logic. // VI: Placeholder cho logic xử lý chấp nhận. // ES: Marcador de posición para la lógica de manejo de aceptación.\n        return NextResponse.json({ status: \"Acceptance received\", sender, receiver, payload });\n      case \"reject\":\n        // EN: Handle reject message. // VI: Xử lý tin nhắn từ chối. // ES: Manejar mensaje de rechazo.\n        console.log(`Received rejection from ${sender} to ${receiver} with payload:`, payload);\n        // EN: Placeholder for rejection handling logic. // VI: Placeholder cho logic xử lý từ chối. // ES: Marcador de posición para la lógica de manejo de rechazo.\n        return NextResponse.json({ status: \"Rejection received\", sender, receiver, payload });\n      default:\n        // EN: Unknown message type. // VI: Loại tin nhắn không xác định. // ES: Tipo de mensaje desconocido.\n        console.warn(`Unknown message type: ${type}`);\n        return NextResponse.json({ error: \"Unknown message type\" }, { status: 400 });\n    }\n  } catch (error) {\n    // EN: Message routing failure. // VI: Lỗi định tuyến tin nhắn. // ES: Fallo en el enrutamiento del mensaje.\n    console.error(\"Error handling ACP message:\", error);\n    return NextResponse.json({ error: \"Message routing failure\" }, { status: 500 });\n  }\n}\n```",
  "spec_id": "AI-05"
}