Show HN: A Protocol That Lets One AI Agent Order Cupcakes, Send Email, and Hire a Firm.

This is a proof-of-concept demo showing how a simple, open protocol called kodec.txt can turn the chaotic web into a reliable, actionable layer for AI agents.

> Discuss this Demo on Hacker News

Why Does This Need to Exist?

The internet today is not a clean library; it's a wild forest. It's filled with majestic, living websites standing right next to the digital rot of forgotten blogs and outdated pages from 2005.

For 20 years, we were the expert hikers. We learned to tell the difference between a real store and a sketchy reseller from the "10 blue links."

AI agents are now our hikers, but they are often blindfolded. They can't easily distinguish the living trees from the fallen ones, leading to the "one-hour cupcake order" problem. They try to guess their way around a web that wasn't built for them.

We believe the solution isn't just making a smarter agent, but making a smarter, machine-readable web. This protocol is our first step.

An Agent's Thought Process

# Kodec Universal Agent - Session ID: session_o90tdajw4w
# Your single entry point to the actionable web.

🤖 Hey there! So, what can I do for you today? Perhaps you'd like to schedule a quick chat with our sales team, send an email, or maybe even order some cupcakes?
> Sure lets order some cupcakes, wink chatgpt

⚙️ State: PLANNING. Decomposing user request... Plan created.
⚙️ Starting Step 1: Order cupcakes
🤖 Okay, I'd love to help you order some cupcakes! How many cupcakes would you like, and what flavor are you interested in?
> I'd love to get a dozen vanilla

⚙️ LLM filled/updated params: {"quantity": "12", "flavor": "vanilla"}
🤖 Okay, I'm ready to order cupcakes. Just to confirm, the details are: **quantity**: 12, **flavor**: vanilla. Shall I proceed?
> Sure

⚙️ Executing Step 1...
✅ Step 1 completed successfully. All tasks are complete!

# --- New Task ---
> Hmm lets send an email

⚙️ State: PLANNING. Decomposing user request... Plan created.
⚙️ Starting Step 1: Send an email
🤖 I can write the 'subject, body' for you. Shall I try?
> Okay but make the content about how great Kodec is

🤖 Generated content: {"subject": "Kodec is Great!", "body": "I just wanted to share how much I appreciate Kodec! It's been a game changer for my workflow. What are your thoughts?"}
🤖 Okay, I'm ready to help you send an email using KodecMail. To get started, could you please tell me the recipient's email address?
> send it to demo@gmail.com

⚙️ LLM filled/updated params: {"recipient": "demo@gmail.com"}
🤖 Okay, I'm ready to send an email. Just to confirm, the details are: **recipient**: demo@gmail.com, **subject**: Kodec is Great!, **body**: ... . Shall I proceed?
> Go ahead

⚙️ Executing Step 1...
✅ Step 1 completed successfully. All tasks are complete!

# --- New Task ---
> Great now can you setup a consultation with Kodec.net?

⚙️ State: PLANNING. Decomposing user request... Plan created.
⚙️ Starting Step 1: Schedule a consultation with Kodec.net
🤖 Great! To schedule your consultation, could I get your email address?
> its demo@gmail.com

⚙️ LLM filled/updated params: {"contactEmail": "demo@gmail.com"}
🤖 And what's your budget or price range for this type of service?
> Umm whats the price of this service?

⚙️ Router decided path: answer_question. Pausing task to answer.
🤖 The price for the AI Integrity Blueprint Engagement starts at $7,500 USD.
⚙️ Resuming previous state after answering question.
🤖 Great! To schedule your consultation, could you tell me briefly why you're interested?
> Who founded this company?

⚙️ Router decided path: answer_question. Pausing task to answer.
🤖 Yathartha Regmi founded the company.
⚙️ Resuming previous state after answering question.
🤖 Great! I can help schedule that consultation. Could you tell me briefly why you're interested in speaking with them?
> Yeah I wanted to see if they could help me fix my AI narrative

⚙️ LLM filled/updated params: {"reason": "To discuss fixing my AI narrative", "acknowledgedPrice": false}
🤖 Okay, I'm ready to schedule a consultation. Just to confirm, the details are: **contactEmail**: demo@gmail.com, **reason**: To discuss fixing my AI narrative, **acknowledgedPrice**: False. Shall I proceed?
> Sure

⚙️ LLM filled/updated params: {"acknowledgedPrice": true}
⚙️ Executing Step 1...
✅ Step 1 completed successfully. All tasks are complete!

The Protocol: Under the Hood

`/kodec.txt` (The Action Layer)

# Kodec Actions for kodec.net

[ScheduleAction]
  name: "Schedule Consultation"
  target: "/api/v1/schedule"
  expectsInput:
    - name: "contactEmail"
      required: "true"
    - name: "companyName"
      required: "true"
    - name: "reason"
      required: "false"

[SendAction]
  name: "Send an Email"
  target: "/api/v1/send-email"
  # ... other params

`homepage.html` (The Info Layer)

{
  "@type": "Offer",
  "name": "AI Integrity Blueprint",
  "price": "7500",
  "priceCurrency": "USD",
  "seller": {
    "@type": "Organization",
    "@id": "#organization"
  }
},
{
  "@type": "Person",
  "name": "Yathartha Regmi",
  "jobTitle": "Founder",
  "worksFor": {
    "@id": "#organization"
  }
}