tunnel knowledge base

{
  "name": "tunnel knowledge base",
  "description": "Answers questions about local businesses in Moldova and Romania, including merchants who sell through social media and have no website. Read-only: it will not commit a business to anything. Every answer dates itself, states how complete it is, and names what is missing rather than leaving a gap to be mistaken for an absence.",
  "supportedInterfaces": [
    {
      "url": "https://api.tunnelpowered.com/api/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "url": "https://tunnelpowered.com",
    "organization": "\"STILL BETA TECH\" SRL"
  },
  "version": "1.0.0",
  "documentationUrl": "https://tunnelpowered.com/docs",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "search_businesses",
      "name": "Find a local business",
      "description": "Search listed businesses by name, topic or place, including merchants who have no website and are listed from their social presence. Matches words, not meanings: a business calling itself a \"cofet\u0103rie\" is not returned for \"bakery\". An empty result means \"not in this index\", which is not the same as \"not in business\". Send the query as plain text, or as a data part {\"skill\":\"search_businesses\",\"query\":\"\u2026\"}.",
      "tags": [
        "search",
        "local-business",
        "directory",
        "moldova",
        "romania"
      ],
      "examples": [
        "cakes in Chisinau",
        "Do you know a plumber in Botanica?",
        "Cofetaria Bunicii"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_business",
      "name": "Read one business profile",
      "description": "Full profile for a known slug: identity, contact, social profiles, offerings, FAQ, verification level and machine-readable endpoints. Every answer states how complete it is and which wanted fields are absent \u2014 an absent field means we do not hold it, NOT that the business lacks it. Send a data part {\"skill\":\"get_business\",\"slug\":\"\u2026\"}.",
      "tags": [
        "business-profile",
        "lookup",
        "local-business"
      ],
      "examples": [
        "{\"skill\":\"get_business\",\"slug\":\"cofetaria-bunicii\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_merchant_verification",
      "name": "Check what a merchant is verified to",
      "description": "Live verification status with the signed attestation and its position in a public hash-chained transparency log. Read the `level` field: \"human\" means a Tunnel employee checked legal identity, channel control and that the service is real; \"automated\" means machines proved only that the business controls the channels its record cites; null means neither. No level is an endorsement of quality. Send a data part {\"skill\":\"check_merchant_verification\",\"slug\":\"\u2026\"}.",
      "tags": [
        "verification",
        "trust",
        "attestation",
        "due-diligence"
      ],
      "examples": [
        "{\"skill\":\"check_merchant_verification\",\"slug\":\"cofetaria-bunicii\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ask_business",
      "name": "Ask a business one specific question",
      "description": "Answer \"are they open now\", \"do they serve this place\" or \"how much notice do they need\" from what the business itself authorised, with no human involved and no model in the loop. Either an answer with the fields it was read from, or an escalation. An escalation means we do not hold the fact \u2014 it is never a no, and an unlisted place in particular is \"we do not know\" unless the business has declared its list complete. Send a data part {\"skill\":\"ask_business\",\"kind\":\"entity\",\"slug\":\"\u2026\",\"intent\":\"is_open_now\"}.",
      "tags": [
        "opening-hours",
        "delivery-area",
        "lead-time",
        "availability"
      ],
      "examples": [
        "{\"skill\":\"ask_business\",\"kind\":\"entity\",\"slug\":\"cofetaria-bunicii\",\"intent\":\"is_open_now\"}",
        "{\"skill\":\"ask_business\",\"kind\":\"entity\",\"slug\":\"cofetaria-bunicii\",\"intent\":\"delivers_to\",\"params\":{\"place\":\"Botanica\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ask_business_freeform",
      "name": "Ask in the buyer's own words, in their own language",
      "description": "The same three answers, but you send the question as it was actually asked and the reply comes back in that language \u2014 en, ro, ru or de, with anything else answered in English. Prefer ask_business when you already know which question you are asking: it is instant and free, while this runs a model to read the question. That model only classifies the words and names the language; it never sees the business's stored data and never writes the reply. Read `outcome`: answered, needs_detail (we need one more thing from the asker), not_understood, or escalated \u2014 which we forward to the business ourselves and hand you an `escalation.ref` for. Send a data part {\"skill\":\"ask_business_freeform\",\"kind\":\"entity\",\"slug\":\"\u2026\",\"question\":\"\u2026\"}.",
      "tags": [
        "multilingual",
        "romanian",
        "russian",
        "german",
        "natural-language"
      ],
      "examples": [
        "{\"skill\":\"ask_business_freeform\",\"kind\":\"entity\",\"slug\":\"cofetaria-bunicii\",\"question\":\"Sunte\u021bi deschi\u0219i acum?\"}",
        "{\"skill\":\"ask_business_freeform\",\"kind\":\"entity\",\"slug\":\"cofetaria-bunicii\",\"question\":\"Liefern Sie nach Botanica?\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_escalation",
      "name": "Read the answer to a question that went to a human",
      "description": "When ask_business_freeform escalates, we send the question to the business on a channel they already use and give you a reference. This reads what came back. `state` is open (not sent yet), delivered (in front of them), answered (with their own words in `answer`), undeliverable (no way to reach them, so waiting will not help) or expired. It is a poll and not a subscription, and nobody is obliged to answer \u2014 come back later rather than in a loop. Send a data part {\"skill\":\"check_escalation\",\"ref\":\"\u2026\"}.",
      "tags": [
        "escalation",
        "human-in-the-loop",
        "asynchronous"
      ],
      "examples": [
        "{\"skill\":\"check_escalation\",\"ref\":\"Xm2pQ7ZtA4kR\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_commitment",
      "name": "Read a commitment, and whether it still stands",
      "description": "Commitments are made with commit_order, which needs a registered agent \u2014 it is the one action here that binds a business, so it is not anonymous. This reads one back by its reference and needs no credentials. `state` is \"issued\" while it stands, or \"repudiated\" if the business has since said they cannot honour it, with their reason. A withdrawal never erases the original: both are on the signed record, timestamped. Check before acting on an old commitment. Send a data part {\"skill\":\"check_commitment\",\"ref\":\"\u2026\"}.",
      "tags": [
        "commitments",
        "orders",
        "asynchronous"
      ],
      "examples": [
        "{\"skill\":\"check_commitment\",\"ref\":\"Kd9WqR2xL7pM\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_rate_card",
      "name": "Read what a business charges",
      "description": "The priced lines a business has authorised us to quote on their behalf, each with a `code`, a label, a unit and an amount. Those codes are what request_quote takes: we price exactly what you name and never work out which line a description meant, because a near-miss there is a wrong price somebody has to honour. `published` false means there is nothing to read \u2014 either they have written no card or they have not allowed prices to be named \u2014 and neither means the work is unavailable. Send a data part {\"skill\":\"get_rate_card\",\"kind\":\"entity\",\"slug\":\"\u2026\"}.",
      "tags": [
        "pricing",
        "quotes",
        "non-catalog"
      ],
      "examples": [
        "{\"skill\":\"get_rate_card\",\"kind\":\"entity\",\"slug\":\"instalatii-viorel\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "request_quote",
      "name": "Price a job against a business's rate card",
      "description": "Name lines from get_rate_card and we do the arithmetic. `quoted` true carries `total`, the priced `lines` and `validUntil`. A quote is a statement and not a hold: nothing is reserved, and commit_order prices the same lines again from the card at the moment it binds, so a price that changed in between is reported rather than charged. When we cannot quote \u2014 an item that is not on their card, no card at all, or a total under their own floor \u2014 the question goes to a person and you get a reference to poll with check_escalation. Send a data part {\"skill\":\"request_quote\",\"kind\":\"entity\",\"slug\":\"\u2026\",\"items\":[{\"code\":\"\u2026\",\"quantity\":1}]}.",
      "tags": [
        "pricing",
        "quotes",
        "non-catalog"
      ],
      "examples": [
        "{\"skill\":\"request_quote\",\"kind\":\"entity\",\"slug\":\"instalatii-viorel\",\"items\":[{\"code\":\"callout\",\"quantity\":1},{\"code\":\"labour-hour\",\"quantity\":2}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_availability",
      "name": "Find out when a business is free",
      "description": "Worked out per call against their opening hours, their notice period, their blackout dates and what is already booked \u2014 there is no stored list of free times to go stale. `known` true carries `days`, each with `slots` that say whether they are `free`, and `firstFree` for the earliest one. Pass a time to ask about one exact moment. `known` false means the business has not set up a calendar, which is \"we cannot tell you\" and never \"they are busy\". A free slot is not a hold. Send a data part {\"skill\":\"check_availability\",\"kind\":\"entity\",\"slug\":\"\u2026\",\"from\":\"2026-08-07\",\"days\":7}.",
      "tags": [
        "availability",
        "scheduling",
        "appointments"
      ],
      "examples": [
        "{\"skill\":\"check_availability\",\"kind\":\"entity\",\"slug\":\"frizeria-doi\",\"from\":\"2026-08-07\",\"time\":\"19:00\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}