{
  "schema_version": "0.1-draft",
  "name": "New Build Ventures",
  "index": "https://nbvn.com/ventures/",
  "ventures": [
    {
      "id": "nbvn.venture.escalation",
      "name": "Escalation Venture",
      "slug": "escalation",
      "url": "https://nbvn.com/ventures/escalation/",
      "summary": "Human agents take over conversations your AI support cannot or should not finish.",
      "request_category": "ai_escalation",
      "human_does": "Reads the AI transcript, resolves or routes the case within the customer's written policy, records the outcome in the customer's helpdesk.",
      "inputs": [
        {
          "name": "channels",
          "type": "enum[] chat,email,ticket",
          "required": true,
          "description": "Channels the handover arrives on: chat, email, ticket"
        },
        {
          "name": "helpdesk_system",
          "type": "string",
          "required": true,
          "description": "Helpdesk the human works in, e.g. Zendesk"
        },
        {
          "name": "escalation_triggers",
          "type": "string",
          "required": true,
          "description": "When your agent should hand over"
        },
        {
          "name": "monthly_volume",
          "type": "integer",
          "required": true,
          "description": "Rough escalations per month"
        },
        {
          "name": "hours",
          "type": "string",
          "required": true,
          "description": "Hours of coverage, with time zone"
        },
        {
          "name": "knowledge_base_url",
          "type": "url",
          "required": false,
          "description": "Your help content or written policy"
        },
        {
          "name": "handoff_payload",
          "type": "string",
          "required": false,
          "description": "What each handover contains, e.g. transcript plus customer id"
        }
      ],
      "common_inputs": [
        {
          "name": "requester_contact",
          "type": "object{name,email,org}",
          "required": true,
          "example": {
            "name": "Dana Test",
            "email": "dana@nbvn-qa.example",
            "org": "Example AI Inc"
          }
        },
        {
          "name": "authorized_by",
          "type": "string",
          "required": true,
          "example": "Customer ops lead, Example AI Inc"
        },
        {
          "name": "agent_note",
          "type": "string",
          "required": false,
          "example": "Submitted by support agent bot on behalf of Example AI Inc"
        },
        {
          "name": "languages",
          "type": "string[]",
          "required": true,
          "example": [
            "English"
          ]
        },
        {
          "name": "customer_geography",
          "type": "string[]",
          "required": true,
          "example": [
            "US"
          ]
        },
        {
          "name": "start",
          "type": "date",
          "required": false,
          "example": "2026-12-01"
        },
        {
          "name": "budget",
          "type": "string",
          "required": false,
          "example": "to be discussed"
        },
        {
          "name": "data_sensitivity",
          "type": "enum[none,pii,payment,health]",
          "required": true,
          "example": "pii"
        }
      ],
      "outputs": [
        "case_id",
        "resolution",
        "notes",
        "handled_by_role",
        "closed_at",
        "needs_customer_action"
      ],
      "status_values": [
        "received",
        "reviewing",
        "fulfillment_decided",
        "scoping",
        "in_delivery",
        "delivered",
        "closed",
        "declined"
      ],
      "decline_response": {
        "status": "declined",
        "reason_code": "one of fulfillment_decision.reason_codes.decline"
      },
      "legacy_capability_ids": [
        "nbvn.cap.ai_escalation",
        "nbvn.cap.customer_support"
      ],
      "exclusions": [
        "legally regulated work requiring a license or registration (legal advice, medical, financial advice, insurance, licensed investigation)",
        "debt collection or collections calls",
        "cold outbound sales or telemarketing without documented prior consent",
        "anything legally stretchy or unclear in law, at APON discretion",
        "payment card handling beyond what an agreed compliant setup allows",
        "impersonation, deception, or contacting people who have not agreed to be contacted",
        "giving legal, medical or financial advice"
      ],
      "status": "manual_matching",
      "provider_of_record": "APON (Apon Labs)",
      "delivery": "Reviewed case by case; delivered in-house or through a vetted partner. Philippines-based teams first.",
      "submit": {
        "form": "https://nbvn.com/request/?venture=escalation",
        "api": {
          "method": "POST",
          "url": "https://nbvn.com/api/request",
          "content_type": "application/json",
          "example": {
            "venture_id": "nbvn.venture.escalation",
            "description": "[TEST] An AI chat agent for an online store meets a customer disputing a double charge. It hands the case to a person, who reviews the order history provided, explains the next step to the customer and returns a resolution note.",
            "requester_contact": {
              "name": "Dana Test",
              "email": "dana@nbvn-qa.example",
              "org": "Example AI Inc"
            },
            "authorized_by": "Customer ops lead, Example AI Inc",
            "agent_note": "Submitted by our agent on behalf of Example AI Inc",
            "languages": [
              "English"
            ],
            "customer_geography": [
              "US"
            ],
            "start": "2026-12-01",
            "budget": "to be discussed",
            "data_sensitivity": "pii",
            "channels": [
              "chat",
              "email"
            ],
            "helpdesk_system": "Zendesk",
            "escalation_triggers": "refund over policy, angry customer, bot loop",
            "monthly_volume": 3000,
            "hours": "Mon to Sun 08:00 to 22:00 PT",
            "knowledge_base_url": "https://example.com/help",
            "handoff_payload": "conversation transcript plus customer id",
            "consent": "yes"
          }
        }
      },
      "api_mcp": "planned",
      "spec_source": "from_corleone/ventures_v2.json (2026-10-30)",
      "alias": "service_id is accepted as venture_id"
    },
    {
      "id": "nbvn.venture.call_overflow",
      "name": "Call Overflow Venture",
      "slug": "call-overflow",
      "url": "https://nbvn.com/ventures/call-overflow/",
      "summary": "Human callers answer inbound calls your voice agent hands off or cannot take, and make outbound calls only to people with lawful consent, which is the customer's responsibility.",
      "request_category": "calling",
      "human_does": "Takes the transferred call, follows the approved script, resolves or logs the call, and hands back a written summary.",
      "inputs": [
        {
          "name": "call_direction",
          "type": "enum[inbound,outbound_consented]",
          "required": true,
          "description": "inbound, or outbound_consented (only to people with lawful consent, which you are responsible for)"
        },
        {
          "name": "phone_numbers",
          "type": "string[]",
          "required": true,
          "description": "Numbers involved"
        },
        {
          "name": "telephony_system",
          "type": "string",
          "required": true,
          "description": "How calls are transferred, e.g. Twilio"
        },
        {
          "name": "monthly_minutes",
          "type": "integer",
          "required": true,
          "description": "Rough call time per month"
        },
        {
          "name": "hours",
          "type": "string",
          "required": true,
          "description": "Hours of coverage, with time zone"
        },
        {
          "name": "call_script_url",
          "type": "url",
          "required": false,
          "description": "Approved script or talking points"
        },
        {
          "name": "consent_record",
          "type": "string",
          "required": false,
          "description": "How consent was obtained and stored (outbound)"
        }
      ],
      "common_inputs": [
        {
          "name": "requester_contact",
          "type": "object{name,email,org}",
          "required": true,
          "example": {
            "name": "Dana Test",
            "email": "dana@nbvn-qa.example",
            "org": "Example AI Inc"
          }
        },
        {
          "name": "authorized_by",
          "type": "string",
          "required": true,
          "example": "Customer ops lead, Example AI Inc"
        },
        {
          "name": "agent_note",
          "type": "string",
          "required": false,
          "example": "Submitted by support agent bot on behalf of Example AI Inc"
        },
        {
          "name": "languages",
          "type": "string[]",
          "required": true,
          "example": [
            "English"
          ]
        },
        {
          "name": "customer_geography",
          "type": "string[]",
          "required": true,
          "example": [
            "US"
          ]
        },
        {
          "name": "start",
          "type": "date",
          "required": false,
          "example": "2026-12-01"
        },
        {
          "name": "budget",
          "type": "string",
          "required": false,
          "example": "to be discussed"
        },
        {
          "name": "data_sensitivity",
          "type": "enum[none,pii,payment,health]",
          "required": true,
          "example": "pii"
        }
      ],
      "outputs": [
        "call_id",
        "disposition",
        "summary",
        "callback_needed",
        "recording_ref"
      ],
      "status_values": [
        "received",
        "reviewing",
        "fulfillment_decided",
        "scoping",
        "in_delivery",
        "delivered",
        "closed",
        "declined"
      ],
      "decline_response": {
        "status": "declined",
        "reason_code": "one of fulfillment_decision.reason_codes.decline"
      },
      "legacy_capability_ids": [
        "nbvn.cap.inbound_calling",
        "nbvn.cap.outbound_calling"
      ],
      "exclusions": [
        "legally regulated work requiring a license or registration (legal advice, medical, financial advice, insurance, licensed investigation)",
        "debt collection or collections calls",
        "cold outbound sales or telemarketing without documented prior consent",
        "anything legally stretchy or unclear in law, at APON discretion",
        "payment card handling beyond what an agreed compliant setup allows",
        "impersonation, deception, or contacting people who have not agreed to be contacted",
        "outbound calls without documented consent",
        "debt or payment chasing"
      ],
      "status": "manual_matching",
      "provider_of_record": "APON (Apon Labs)",
      "delivery": "Reviewed case by case; delivered in-house or through a vetted partner. Philippines-based teams first.",
      "submit": {
        "form": "https://nbvn.com/request/?venture=call-overflow",
        "api": {
          "method": "POST",
          "url": "https://nbvn.com/api/request",
          "content_type": "application/json",
          "example": {
            "venture_id": "nbvn.venture.call_overflow",
            "description": "[TEST] A clinic's AI receptionist answers routine calls but transfers callers who ask something outside its script to a human, who answers from the clinic's approved information or takes a message.",
            "requester_contact": {
              "name": "Dana Test",
              "email": "dana@nbvn-qa.example",
              "org": "Example AI Inc"
            },
            "authorized_by": "Customer ops lead, Example AI Inc",
            "agent_note": "Submitted by our agent on behalf of Example AI Inc",
            "languages": [
              "English"
            ],
            "customer_geography": [
              "US"
            ],
            "start": "2026-12-01",
            "budget": "to be discussed",
            "data_sensitivity": "pii",
            "call_direction": "inbound",
            "phone_numbers": [
              "+1 555 0142"
            ],
            "telephony_system": "Twilio",
            "monthly_minutes": 5000,
            "hours": "Mon to Sun 08:00 to 22:00 PT",
            "call_script_url": "https://example.com/script",
            "consent_record": "opt in via web form, stored in CRM",
            "consent": "yes"
          }
        }
      },
      "api_mcp": "planned",
      "spec_source": "from_corleone/ventures_v2.json (2026-10-30)",
      "alias": "service_id is accepted as venture_id"
    },
    {
      "id": "nbvn.venture.booking",
      "name": "Booking Venture",
      "slug": "booking",
      "url": "https://nbvn.com/ventures/booking/",
      "summary": "People make, confirm, reschedule or cancel appointments and reservations for your users.",
      "request_category": "calling",
      "human_does": "Contacts the named person through the agreed channel, confirms or changes the booking, updates the calendar.",
      "inputs": [
        {
          "name": "booking_type",
          "type": "string",
          "required": true,
          "description": "What is being booked or confirmed"
        },
        {
          "name": "calendar_system",
          "type": "string",
          "required": true,
          "description": "Calendar to update"
        },
        {
          "name": "monthly_bookings",
          "type": "integer",
          "required": true,
          "description": "Rough bookings per month"
        },
        {
          "name": "contact_method",
          "type": "enum[] call,sms,email",
          "required": true,
          "description": "call, sms, email"
        },
        {
          "name": "sample_contact_phone",
          "type": "string",
          "required": false,
          "description": "Example contact number"
        },
        {
          "name": "rules",
          "type": "string",
          "required": true,
          "description": "Your booking rules, e.g. confirm ahead, reschedule window"
        }
      ],
      "common_inputs": [
        {
          "name": "requester_contact",
          "type": "object{name,email,org}",
          "required": true,
          "example": {
            "name": "Dana Test",
            "email": "dana@nbvn-qa.example",
            "org": "Example AI Inc"
          }
        },
        {
          "name": "authorized_by",
          "type": "string",
          "required": true,
          "example": "Customer ops lead, Example AI Inc"
        },
        {
          "name": "agent_note",
          "type": "string",
          "required": false,
          "example": "Submitted by support agent bot on behalf of Example AI Inc"
        },
        {
          "name": "languages",
          "type": "string[]",
          "required": true,
          "example": [
            "English"
          ]
        },
        {
          "name": "customer_geography",
          "type": "string[]",
          "required": true,
          "example": [
            "US"
          ]
        },
        {
          "name": "start",
          "type": "date",
          "required": false,
          "example": "2026-12-01"
        },
        {
          "name": "budget",
          "type": "string",
          "required": false,
          "example": "to be discussed"
        },
        {
          "name": "data_sensitivity",
          "type": "enum[none,pii,payment,health]",
          "required": true,
          "example": "pii"
        }
      ],
      "outputs": [
        "booking_id",
        "outcome enum confirmed,rescheduled,cancelled,no_answer",
        "new_time",
        "notes"
      ],
      "status_values": [
        "received",
        "reviewing",
        "fulfillment_decided",
        "scoping",
        "in_delivery",
        "delivered",
        "closed",
        "declined"
      ],
      "decline_response": {
        "status": "declined",
        "reason_code": "one of fulfillment_decision.reason_codes.decline"
      },
      "legacy_capability_ids": [
        "nbvn.cap.appointment_coordination"
      ],
      "exclusions": [
        "legally regulated work requiring a license or registration (legal advice, medical, financial advice, insurance, licensed investigation)",
        "debt collection or collections calls",
        "cold outbound sales or telemarketing without documented prior consent",
        "anything legally stretchy or unclear in law, at APON discretion",
        "payment card handling beyond what an agreed compliant setup allows",
        "impersonation, deception, or contacting people who have not agreed to be contacted",
        "medical, legal or licensed content in any contact"
      ],
      "status": "manual_matching",
      "provider_of_record": "APON (Apon Labs)",
      "delivery": "Reviewed case by case; delivered in-house or through a vetted partner. Philippines-based teams first.",
      "submit": {
        "form": "https://nbvn.com/request/?venture=booking",
        "api": {
          "method": "POST",
          "url": "https://nbvn.com/api/request",
          "content_type": "application/json",
          "example": {
            "venture_id": "nbvn.venture.booking",
            "description": "[TEST] A salon's AI assistant books online, but many clients never confirm. A person calls or texts each client ahead of the visit, confirms or moves the slot within the salon's rules and updates the calendar.",
            "requester_contact": {
              "name": "Dana Test",
              "email": "dana@nbvn-qa.example",
              "org": "Example AI Inc"
            },
            "authorized_by": "Customer ops lead, Example AI Inc",
            "agent_note": "Submitted by our agent on behalf of Example AI Inc",
            "languages": [
              "English"
            ],
            "customer_geography": [
              "US"
            ],
            "start": "2026-12-01",
            "budget": "to be discussed",
            "data_sensitivity": "pii",
            "booking_type": "clinic appointment reminders (non medical content)",
            "calendar_system": "Google Calendar",
            "monthly_bookings": 800,
            "contact_method": [
              "call",
              "email"
            ],
            "sample_contact_phone": "+1 555 0118",
            "rules": "confirm 48h ahead, reschedule within same week",
            "consent": "yes"
          }
        }
      },
      "api_mcp": "planned",
      "spec_source": "from_corleone/ventures_v2.json (2026-10-30)",
      "alias": "service_id is accepted as venture_id"
    },
    {
      "id": "nbvn.venture.field_verification",
      "name": "Field Verification Venture",
      "slug": "field-verification",
      "url": "https://nbvn.com/ventures/field-verification/",
      "summary": "A person checks a real-world fact: a business exists, a listing is accurate, a document or address is real. Phone, online and document checks at launch; in-person checks on request, reviewed case by case.",
      "request_category": "verification",
      "human_does": "Performs the listed checks by the agreed method and records evidence; in person checks only where APON can arrange them.",
      "inputs": [
        {
          "name": "verification_target",
          "type": "string",
          "required": true,
          "description": "The business, listing, document or address to check"
        },
        {
          "name": "checks",
          "type": "string[]",
          "required": true,
          "description": "The specific things to confirm"
        },
        {
          "name": "method",
          "type": "enum[] phone,online_research,in_person",
          "required": true,
          "description": "phone, online_research; in_person on request only"
        },
        {
          "name": "contact_phone",
          "type": "string",
          "required": false,
          "description": "Number to call, if any"
        },
        {
          "name": "batch_size",
          "type": "integer",
          "required": true,
          "description": "Number of items"
        },
        {
          "name": "evidence_required",
          "type": "string",
          "required": false,
          "description": "Evidence you want recorded"
        }
      ],
      "common_inputs": [
        {
          "name": "requester_contact",
          "type": "object{name,email,org}",
          "required": true,
          "example": {
            "name": "Dana Test",
            "email": "dana@nbvn-qa.example",
            "org": "Example AI Inc"
          }
        },
        {
          "name": "authorized_by",
          "type": "string",
          "required": true,
          "example": "Customer ops lead, Example AI Inc"
        },
        {
          "name": "agent_note",
          "type": "string",
          "required": false,
          "example": "Submitted by support agent bot on behalf of Example AI Inc"
        },
        {
          "name": "languages",
          "type": "string[]",
          "required": true,
          "example": [
            "English"
          ]
        },
        {
          "name": "customer_geography",
          "type": "string[]",
          "required": true,
          "example": [
            "US"
          ]
        },
        {
          "name": "start",
          "type": "date",
          "required": false,
          "example": "2026-12-01"
        },
        {
          "name": "budget",
          "type": "string",
          "required": false,
          "example": "to be discussed"
        },
        {
          "name": "data_sensitivity",
          "type": "enum[none,pii,payment,health]",
          "required": true,
          "example": "pii"
        }
      ],
      "outputs": [
        "item_id",
        "result enum verified,not_verified,inconclusive",
        "evidence",
        "checked_at",
        "method_used"
      ],
      "status_values": [
        "received",
        "reviewing",
        "fulfillment_decided",
        "scoping",
        "in_delivery",
        "delivered",
        "closed",
        "declined"
      ],
      "decline_response": {
        "status": "declined",
        "reason_code": "one of fulfillment_decision.reason_codes.decline"
      },
      "legacy_capability_ids": [
        "nbvn.cap.human_verification_research"
      ],
      "exclusions": [
        "legally regulated work requiring a license or registration (legal advice, medical, financial advice, insurance, licensed investigation)",
        "debt collection or collections calls",
        "cold outbound sales or telemarketing without documented prior consent",
        "anything legally stretchy or unclear in law, at APON discretion",
        "payment card handling beyond what an agreed compliant setup allows",
        "impersonation, deception, or contacting people who have not agreed to be contacted",
        "licensed private investigation, background checks under FCRA, or surveillance"
      ],
      "status": "manual_matching",
      "provider_of_record": "APON (Apon Labs)",
      "delivery": "Reviewed case by case; delivered in-house or through a vetted partner. Philippines-based teams first.",
      "submit": {
        "form": "https://nbvn.com/request/?venture=field-verification",
        "api": {
          "method": "POST",
          "url": "https://nbvn.com/api/request",
          "content_type": "application/json",
          "example": {
            "venture_id": "nbvn.venture.field_verification",
            "description": "[TEST] A procurement agent shortlists a supplier. A person calls the listed number and confirms the company operates, the address and the contact person, and notes anything that does not match.",
            "requester_contact": {
              "name": "Dana Test",
              "email": "dana@nbvn-qa.example",
              "org": "Example AI Inc"
            },
            "authorized_by": "Customer ops lead, Example AI Inc",
            "agent_note": "Submitted by our agent on behalf of Example AI Inc",
            "languages": [
              "English"
            ],
            "customer_geography": [
              "US"
            ],
            "start": "2026-12-01",
            "budget": "to be discussed",
            "data_sensitivity": "pii",
            "verification_target": "storefront at 123 Example St, Springfield",
            "checks": [
              "open for business",
              "signage matches name"
            ],
            "method": [
              "phone",
              "online_research"
            ],
            "contact_phone": "+1 555 0177",
            "batch_size": 50,
            "evidence_required": "photo or call note",
            "consent": "yes"
          }
        }
      },
      "api_mcp": "planned",
      "spec_source": "from_corleone/ventures_v2.json (2026-10-30)",
      "alias": "service_id is accepted as venture_id"
    },
    {
      "id": "nbvn.venture.back_office",
      "name": "Back Office Venture",
      "slug": "back-office",
      "url": "https://nbvn.com/ventures/back-office/",
      "summary": "A human queue for tasks your agent queues: data entry, cleanup, research, document handling.",
      "request_category": "back_office",
      "human_does": "Works the queue to the written instructions, flags exceptions, returns completed items.",
      "inputs": [
        {
          "name": "task_description",
          "type": "string",
          "required": true,
          "description": "What the work is, step by step"
        },
        {
          "name": "systems_access",
          "type": "string",
          "required": true,
          "description": "How work and tools are shared"
        },
        {
          "name": "volume",
          "type": "string",
          "required": true,
          "description": "Size or frequency of the queue"
        },
        {
          "name": "quality_rule",
          "type": "string",
          "required": true,
          "description": "What correct output looks like"
        },
        {
          "name": "turnaround_request",
          "type": "string",
          "required": false,
          "description": "When you would like it; a request, not a promise"
        }
      ],
      "common_inputs": [
        {
          "name": "requester_contact",
          "type": "object{name,email,org}",
          "required": true,
          "example": {
            "name": "Dana Test",
            "email": "dana@nbvn-qa.example",
            "org": "Example AI Inc"
          }
        },
        {
          "name": "authorized_by",
          "type": "string",
          "required": true,
          "example": "Customer ops lead, Example AI Inc"
        },
        {
          "name": "agent_note",
          "type": "string",
          "required": false,
          "example": "Submitted by support agent bot on behalf of Example AI Inc"
        },
        {
          "name": "languages",
          "type": "string[]",
          "required": true,
          "example": [
            "English"
          ]
        },
        {
          "name": "customer_geography",
          "type": "string[]",
          "required": true,
          "example": [
            "US"
          ]
        },
        {
          "name": "start",
          "type": "date",
          "required": false,
          "example": "2026-12-01"
        },
        {
          "name": "budget",
          "type": "string",
          "required": false,
          "example": "to be discussed"
        },
        {
          "name": "data_sensitivity",
          "type": "enum[none,pii,payment,health]",
          "required": true,
          "example": "pii"
        }
      ],
      "outputs": [
        "batch_id",
        "items_done",
        "exceptions",
        "notes"
      ],
      "status_values": [
        "received",
        "reviewing",
        "fulfillment_decided",
        "scoping",
        "in_delivery",
        "delivered",
        "closed",
        "declined"
      ],
      "decline_response": {
        "status": "declined",
        "reason_code": "one of fulfillment_decision.reason_codes.decline"
      },
      "legacy_capability_ids": [
        "nbvn.cap.back_office"
      ],
      "exclusions": [
        "legally regulated work requiring a license or registration (legal advice, medical, financial advice, insurance, licensed investigation)",
        "debt collection or collections calls",
        "cold outbound sales or telemarketing without documented prior consent",
        "anything legally stretchy or unclear in law, at APON discretion",
        "payment card handling beyond what an agreed compliant setup allows",
        "impersonation, deception, or contacting people who have not agreed to be contacted",
        "regulated bookkeeping, tax or legal filings"
      ],
      "status": "manual_matching",
      "provider_of_record": "APON (Apon Labs)",
      "delivery": "Reviewed case by case; delivered in-house or through a vetted partner. Philippines-based teams first.",
      "submit": {
        "form": "https://nbvn.com/request/?venture=back-office",
        "api": {
          "method": "POST",
          "url": "https://nbvn.com/api/request",
          "content_type": "application/json",
          "example": {
            "venture_id": "nbvn.venture.back_office",
            "description": "[TEST] An invoice automation rejects handwritten and low quality scans. A team keys them into the customer's template and flags anything unreadable.",
            "requester_contact": {
              "name": "Dana Test",
              "email": "dana@nbvn-qa.example",
              "org": "Example AI Inc"
            },
            "authorized_by": "Customer ops lead, Example AI Inc",
            "agent_note": "Submitted by our agent on behalf of Example AI Inc",
            "languages": [
              "English"
            ],
            "customer_geography": [
              "US"
            ],
            "start": "2026-12-01",
            "budget": "to be discussed",
            "data_sensitivity": "pii",
            "task_description": "normalize 2,000 supplier records into the attached template",
            "systems_access": "shared Google Sheet",
            "volume": "2,000 records per month",
            "quality_rule": "double check 10 percent sample",
            "turnaround_request": "weekly batch",
            "consent": "yes"
          }
        }
      },
      "api_mcp": "planned",
      "spec_source": "from_corleone/ventures_v2.json (2026-10-30)",
      "alias": "service_id is accepted as venture_id"
    }
  ]
}
