@adminide-stack/yantra-help-browser 12.0.16-alpha.6 → 12.0.16

package/lib/templates/content/subscription-billing/payment-methods.md

@@ -0,0 +1,77 @@
+# Payment Methods
+
+Manage how you pay for Yantra — add, update, or remove payment methods at any time.
+
+---
+
+## Accepted Payment Methods
+
+| Method            | Cards/Services                               | Auto-renewal   |
+| ----------------- | -------------------------------------------- | -------------- |
+| **Credit cards**  | Visa, Mastercard, American Express, Discover | Yes            |
+| **Debit cards**   | Visa, Mastercard with debit capability       | Yes            |
+| **PayPal**        | PayPal account balance, linked bank, or card | Yes            |
+| **Bank transfer** | Enterprise annual contracts only             | Manual renewal |
+| **Wire transfer** | Enterprise invoiced accounts only            | Manual renewal |
+
+---
+
+## Adding a Payment Method
+
+1. Go to **Settings > Billing > Payment Methods**.
+2. Click **+ Add Payment Method**.
+3. Choose card or PayPal.
+4. For cards: enter card number, expiration, CVC, and billing address.
+5. Click **Save**.
+
+The first payment method you add becomes the default. You can add multiple methods and switch between them.
+
+---
+
+## Updating or Removing
+
+### Update a card
+
+If your card was reissued with a new number or expiration:
+
+1. Go to **Settings > Billing > Payment Methods**.
+2. Click **Edit** next to the card.
+3. Update the details and click **Save**.
+
+### Remove a payment method
+
+1. Click **Remove** next to the payment method.
+2. Confirm removal.
+
+> **Note:** You must have at least one active payment method on paid plans. To remove your last card, downgrade to Free first.
+
+---
+
+## Payment Security
+
+- **PCI DSS compliant** — Yantra never stores raw card numbers. All payment data is handled by Stripe, a PCI Level 1 certified processor.
+- **3D Secure** — Supported for cards that require additional verification (Verified by Visa, Mastercard SecureCode).
+- **Encrypted transmission** — All payment data is transmitted over TLS 1.3.
+- **Fraud detection** — Stripe's ML-based fraud detection protects against unauthorized transactions.
+
+---
+
+## Troubleshooting
+
+### Card declined
+
+Common reasons and fixes:
+
+| Reason              | Fix                                                       |
+| ------------------- | --------------------------------------------------------- |
+| Insufficient funds  | Ensure adequate balance or credit limit                   |
+| Card expired        | Update with your new card details                         |
+| International block | Call your bank to authorize international online payments |
+| Fraud flag          | Contact your bank to whitelist Yantra charges             |
+| Incorrect details   | Double-check card number, expiration, and CVC             |
+
+### PayPal issues
+
+- Ensure your PayPal account has a valid funding source (bank or card).
+- Check that your PayPal email matches what's configured in Yantra.
+- Re-authorize the PayPal connection if it was disconnected.

package/lib/templates/content/subscription-billing/promotional-offers.md

@@ -0,0 +1,81 @@
+# Promotional Offers
+
+Take advantage of special pricing, discounts, and promotions to get more out of Yantra.
+
+---
+
+## Current Promotions
+
+| Offer                  | Details                                       | Eligibility                                    |
+| ---------------------- | --------------------------------------------- | ---------------------------------------------- |
+| **Annual discount**    | Save ~17% with annual billing (2 months free) | All users                                      |
+| **Student discount**   | 50% off Pro plan                              | Verified students                              |
+| **Startup program**    | Free Team plan for 6 months                   | Startups with < 20 employees and < $5M funding |
+| **Nonprofit discount** | 30% off any paid plan                         | Verified 501(c)(3) or equivalent               |
+
+_Promotions are subject to change. Check [yantra.ai/pricing](https://yantra.ai/pricing) for the latest offers._
+
+---
+
+## Applying a Promo Code
+
+1. Go to **Settings > Billing > Change Plan** or upgrade during checkout.
+2. Click **Have a promo code?** below the plan selection.
+3. Enter your code and click **Apply**.
+4. The discount is reflected in the total before you confirm.
+
+### Promo code rules
+
+- One promo code per account at a time.
+- Promo codes cannot be combined with other active discounts (except annual billing discount).
+- Most codes have an expiration date — apply before it expires.
+- Codes are case-insensitive.
+
+---
+
+## Referral Program
+
+Earn credits by referring others to Yantra:
+
+| Action                       | Reward                             |
+| ---------------------------- | ---------------------------------- |
+| You refer someone            | $10 credit applied to your account |
+| They sign up for a paid plan | They get $10 off their first month |
+| Referral cap                 | Up to $500 in credits per year     |
+
+### How to refer
+
+1. Go to **Settings > Referrals**.
+2. Copy your unique referral link.
+3. Share via email, social media, or Slack.
+4. Credits are applied automatically when your referral subscribes to a paid plan.
+
+---
+
+## Startup Program
+
+Eligible startups get the **Team plan free for 6 months**:
+
+### Eligibility
+
+- Company is less than 3 years old.
+- Fewer than 20 employees.
+- Less than $5M in total funding.
+- Not currently on an Enterprise plan.
+
+### How to apply
+
+1. Visit [yantra.ai/startups](https://yantra.ai/startups).
+2. Fill out the application (company details, founding date, team size, funding).
+3. Applications are reviewed within 5 business days.
+4. If approved, the Team plan is activated immediately for 6 months.
+
+---
+
+## Nonprofit Discount
+
+Verified nonprofit organizations receive **30% off** any paid plan:
+
+1. Email **support@yantra.ai** with your organization's name and proof of nonprofit status (501(c)(3) letter, equivalent certification, or charity registration number).
+2. We'll verify within 3 business days.
+3. The discount is applied to your account and renews automatically.

package/lib/templates/content/subscription-billing/refund-policy.md

@@ -0,0 +1,80 @@
+# Refund Policy
+
+Yantra's refund policy is designed to be fair and straightforward.
+
+---
+
+## Eligibility
+
+### When refunds are available
+
+| Scenario                      | Refund window   | Refund type    |
+| ----------------------------- | --------------- | -------------- |
+| New subscription (first-time) | Within 7 days   | Full refund    |
+| Annual plan renewal           | Within 14 days  | Full refund    |
+| Accidental upgrade            | Within 48 hours | Full refund    |
+| Service outage (SLA breach)   | Per SLA terms   | Account credit |
+| Duplicate charge              | Any time        | Full refund    |
+
+### When refunds are not available
+
+- Monthly subscriptions after the first 7 days.
+- Partial-month usage on downgraded plans.
+- Charges older than 90 days.
+- Free trial conversions after the trial ends.
+
+---
+
+## How to Request a Refund
+
+### Self-service
+
+1. Go to **Settings > Billing > Invoice History**.
+2. Click on the charge you'd like refunded.
+3. Click **Request Refund**.
+4. Select a reason and submit.
+
+### Via support
+
+Email **billing@yantra.ai** with:
+
+- Your account email
+- Date and amount of the charge
+- Reason for the refund request
+
+---
+
+## Processing Times
+
+| Refund type    | Processing time     |
+| -------------- | ------------------- |
+| Credit card    | 5–10 business days  |
+| PayPal         | 3–5 business days   |
+| Bank transfer  | 10–15 business days |
+| Account credit | Instant             |
+
+> **Where does the refund go?** Refunds are returned to the original payment method used for the charge.
+
+---
+
+## Account Credits
+
+In some cases, we issue account credits instead of monetary refunds:
+
+- **SLA credits** — Issued when our service availability falls below the guaranteed SLA.
+- **Goodwill credits** — Issued at our discretion for service issues that don't meet the formal refund criteria.
+- **Promotional credits** — From referrals, promotions, or startup programs.
+
+Credits are applied automatically to your next billing cycle and are visible at **Settings > Billing > Credits**.
+
+---
+
+## Disputes
+
+If your refund request is denied and you believe it was in error:
+
+1. Reply to the denial email with additional context.
+2. A senior billing specialist will review within 2 business days.
+3. If still unresolved, request escalation to the billing manager.
+
+> **Please contact us before filing a chargeback.** We resolve most disputes quickly, and chargebacks can result in temporary account restrictions.

package/lib/templates/content/subscription-billing/student-discounts.md

@@ -0,0 +1,88 @@
+# Student Discounts
+
+Students get 50% off Yantra Pro — because great research tools shouldn't be out of reach.
+
+---
+
+## What You Get
+
+| Feature          | Free Plan        | Student Pro (50% off)                    |
+| ---------------- | ---------------- | ---------------------------------------- |
+| Price            | $0/month         | **$10/month** (normally $20)             |
+| Daily searches   | 20               | Unlimited                                |
+| Pro Search       | 5/day            | Unlimited                                |
+| Deep Research    | 3/day            | Unlimited                                |
+| Model selection  | GPT-4o mini only | All models                               |
+| Export formats   | Plain text       | All formats (PDF, Markdown, etc.)        |
+| Source citations | Basic            | Full academic citations (APA, MLA, etc.) |
+
+---
+
+## Eligibility
+
+You qualify for the student discount if you:
+
+- Are enrolled in an accredited college, university, or high school.
+- Have a valid **.edu** email address (or equivalent academic email).
+- Are at least 16 years old.
+
+Graduate students, PhD candidates, post-docs, and continuing education students are all eligible.
+
+---
+
+## How to Apply
+
+### With a .edu email
+
+1. Go to **Settings > Billing > Student Discount**.
+2. Enter your .edu email address.
+3. Click **Verify**.
+4. Check your .edu inbox for a verification link.
+5. Click the link — the discount is applied instantly.
+
+### Without a .edu email
+
+If your institution doesn't use .edu emails:
+
+1. Go to **Settings > Billing > Student Discount**.
+2. Click **Manual Verification**.
+3. Upload one of the following:
+    - Student ID card (photo)
+    - Enrollment letter
+    - Tuition receipt from the current academic year
+4. Verification is completed within 2 business days.
+
+---
+
+## Duration & Renewal
+
+- The discount is valid for **12 months** from verification.
+- Before expiration, you'll receive an email to **re-verify** your student status.
+- If you're still a student, re-verification is instant with a .edu email.
+- After graduation, your plan converts to the standard Pro price on the next billing cycle.
+
+---
+
+## Student + Annual Billing
+
+Stack your savings:
+
+| Billing | Regular Pro              | Student Pro                 |
+| ------- | ------------------------ | --------------------------- |
+| Monthly | $20/month                | $10/month                   |
+| Annual  | $200/year ($16.67/month) | **$100/year** ($8.33/month) |
+
+> **Best deal:** Student discount + annual billing = **$100/year** — that's $8.33/month for full Pro access.
+
+---
+
+## FAQ
+
+**Can I use the student discount on a Team plan?**
+No, the student discount applies only to individual Pro plans.
+
+**Can I combine the student discount with a promo code?**
+The student discount cannot be combined with other coupon codes, but it does stack with annual billing savings.
+
+**What happens after I graduate?**
+Your plan continues at the student rate until your next re-verification date. After that, it converts to the standard rate.

package/lib/templates/content/subscription-billing/tax-information.md

@@ -0,0 +1,86 @@
+# Tax Information
+
+How taxes are applied to your Yantra subscription and how to manage tax-related settings.
+
+---
+
+## How Taxes Work
+
+Yantra is required to collect sales tax, VAT, or GST depending on your location:
+
+| Region         | Tax type        | Rate                        |
+| -------------- | --------------- | --------------------------- |
+| United States  | Sales tax       | Varies by state (0–10.25%)  |
+| European Union | VAT             | 17–27% depending on country |
+| United Kingdom | VAT             | 20%                         |
+| Australia      | GST             | 10%                         |
+| India          | GST             | 18%                         |
+| Canada         | GST/HST         | 5–15% depending on province |
+| Japan          | Consumption tax | 10%                         |
+
+> **Tax-exempt?** See the section below on claiming exemptions.
+
+---
+
+## Adding Your Tax ID
+
+Add your tax identification number so it appears on invoices:
+
+1. Go to **Settings > Billing > Invoice Settings**.
+2. Under **Tax ID**, enter your:
+    - **VAT number** (EU businesses) — e.g., DE123456789
+    - **GST number** (India/Australia) — e.g., 29ABCDE1234F1Z5
+    - **ABN** (Australia) — e.g., 12 345 678 901
+    - **EIN** (US businesses) — e.g., 12-3456789
+3. Click **Save**.
+
+Your tax ID is validated automatically. If valid, it appears on all future invoices.
+
+---
+
+## Tax Exemptions
+
+### EU businesses (reverse charge)
+
+If you're a VAT-registered business in the EU purchasing from outside your country, you may qualify for the **VAT reverse charge** mechanism:
+
+1. Enter your valid EU VAT number in **Settings > Billing > Invoice Settings**.
+2. Once validated, VAT is removed from your invoices.
+3. You self-account for VAT on your local tax return.
+
+### US tax-exempt organizations
+
+1. Email **billing@yantra.ai** with your tax exemption certificate.
+2. We'll verify and apply the exemption within 3 business days.
+3. Future invoices will not include sales tax.
+
+### Other jurisdictions
+
+Contact **billing@yantra.ai** with your exemption documentation. We'll review and apply applicable exemptions.
+
+---
+
+## Tax on Invoices
+
+Every invoice includes a detailed tax breakdown:
+
+| Line item                     | Example    |
+| ----------------------------- | ---------- |
+| Subtotal                      | $20.00     |
+| Tax (state sales tax, 8.875%) | $1.78      |
+| **Total**                     | **$21.78** |
+
+Tax type and rate are shown on each invoice based on your billing address.
+
+---
+
+## FAQ
+
+**Why am I being charged tax now when I wasn't before?**
+Tax regulations change as jurisdictions update their digital services tax rules. Yantra applies taxes as required by law.
+
+**Can I get a refund on taxes?**
+Taxes collected and remitted to authorities cannot be refunded by Yantra. If you qualify for a tax exemption, apply it proactively for future invoices.
+
+**What if my tax ID isn't accepted?**
+Ensure you're entering the correct format for your region. If it's still not accepted, contact billing@yantra.ai with your tax ID and country.

package/lib/templates/content/technical-questions/ai-models-technical.md

@@ -0,0 +1,87 @@
+# AI Models & Machine Learning
+
+A deep dive into how Yantra leverages artificial intelligence — from model selection to real-time inference.
+
+---
+
+## Model Architecture
+
+Yantra uses a **multi-model architecture** that intelligently routes each request to the most suitable AI model based on the task type, complexity, and latency requirements.
+
+### Supported model families
+
+| Model Family          | Purpose                                         | Examples                             |
+| --------------------- | ----------------------------------------------- | ------------------------------------ |
+| Large Language Models | Complex reasoning, generation, summarization    | GPT-4o, Claude 3.5 Sonnet            |
+| Embedding Models      | Semantic search, similarity matching            | text-embedding-3-large, Cohere Embed |
+| Classification Models | Intent detection, content tagging, routing      | Custom fine-tuned BERT variants      |
+| Generation Models     | Content drafting, code generation, translations | GPT-4o, Claude, Llama 3              |
+
+### Model routing
+
+Every incoming request passes through Yantra's **Intelligent Router**, which considers:
+
+- **Task type** — Is this a search, generation, classification, or extraction task?
+- **Complexity score** — Simple lookups route to faster/cheaper models; nuanced tasks go to frontier models.
+- **Latency budget** — Real-time interactions use low-latency models; batch jobs use high-throughput models.
+- **Fallback chain** — If the primary model is unavailable or rate-limited, the router automatically falls back to an alternate provider with no user-visible disruption.
+
+---
+
+## Processing Pipeline
+
+### How a query becomes a response
+
+1. **Preprocessing** — The raw query is normalized: typos are corrected, abbreviations expanded, and language detected.
+2. **Intent classification** — A lightweight classifier determines what the user wants (search, summarize, compare, generate, etc.).
+3. **Entity extraction** — Named entities (people, products, dates, code references) are identified for context enrichment.
+4. **Context assembly** — Relevant conversation history, user preferences, and retrieved documents are bundled into the prompt.
+5. **Inference** — The selected model generates a response.
+6. **Post-processing** — The response is validated for factual grounding, formatted, and annotated with source citations.
+
+---
+
+## Performance & Optimization
+
+### Inference optimization techniques
+
+- **Quantization** — Models are served in INT8/FP16 precision where quality allows, reducing GPU memory by up to 50%.
+- **KV-cache reuse** — Multi-turn conversations reuse key-value caches to avoid recomputing prior context.
+- **Speculative decoding** — A small draft model proposes tokens that the full model verifies in parallel, boosting throughput.
+- **Batching** — Requests with similar properties are dynamically batched to maximize GPU utilization.
+
+### Monitoring and quality
+
+| Metric               | Target                   | How we track it                  |
+| -------------------- | ------------------------ | -------------------------------- |
+| Median latency (P50) | < 800 ms                 | Prometheus + Grafana dashboards  |
+| Answer accuracy      | > 95% grounded responses | Automated fact-checking pipeline |
+| Fallback rate        | < 2%                     | Model router telemetry           |
+| Error rate           | < 0.1%                   | Sentry + PagerDuty alerts        |
+
+---
+
+## Custom Models & Fine-Tuning
+
+### When to consider fine-tuning
+
+Fine-tuning is valuable when your domain has specialized vocabulary, unique workflows, or strict formatting requirements that general-purpose models handle inconsistently.
+
+### Fine-tuning workflow
+
+1. **Data preparation** — Curate a labeled dataset of 500 to 5,000 examples in JSONL format.
+2. **Training** — Yantra runs supervised fine-tuning on a base model with your data, typically completing in 1-4 hours.
+3. **Evaluation** — The fine-tuned model is benchmarked against a held-out test set. Key metrics: accuracy, latency, and regression on general tasks.
+4. **A/B deployment** — The model is deployed alongside the baseline with traffic split 50/50. If quality metrics improve, traffic gradually shifts to 100%.
+5. **Versioning** — Every model version is immutable and tagged. Rollback to any previous version is instant.
+
+---
+
+## Safety & Responsible AI
+
+- **Content filtering** — All outputs pass through a safety classifier that flags harmful, biased, or inappropriate content before delivery.
+- **Hallucination detection** — A secondary verification step cross-references generated claims against retrieved source documents.
+- **PII redaction** — Personally identifiable information is automatically detected and masked in both inputs and outputs.
+- **Audit trail** — Every model invocation is logged with input hash, model version, latency, and token count for compliance and debugging.
+
+> **Enterprise customers** can configure custom safety policies, blocklists, and output constraints via the Admin Dashboard.

package/lib/templates/content/technical-questions/api-technical.md

@@ -0,0 +1,158 @@
+# API Architecture & Reference
+
+Everything you need to know about Yantra's RESTful API — from authentication to advanced batch operations.
+
+---
+
+## API Design Principles
+
+Yantra's API follows REST conventions with predictable, resource-oriented URLs, standard HTTP methods, and consistent JSON responses.
+
+### Base URL
+
+All API requests are made to:
+
+```
+https://api.yantra.ai/v1
+```
+
+### Request format
+
+| Method   | Usage                                                                    |
+| -------- | ------------------------------------------------------------------------ |
+| `GET`    | Retrieve resources. Supports pagination, filtering, and field selection. |
+| `POST`   | Create new resources or trigger actions. Request body is JSON.           |
+| `PUT`    | Full replacement of a resource.                                          |
+| `PATCH`  | Partial update of specific fields.                                       |
+| `DELETE` | Remove a resource. Returns 204 No Content on success.                    |
+
+### Response structure
+
+Every response follows a consistent envelope:
+
+```json
+{
+  "data": { ... },
+  "meta": { "request_id": "req_abc123", "timestamp": "2026-02-28T12:00:00Z" },
+  "errors": []
+}
+```
+
+---
+
+## Authentication & Security
+
+### Authentication methods
+
+| Method     | Best for                      | How to use                                        |
+| ---------- | ----------------------------- | ------------------------------------------------- |
+| API Key    | Server-to-server integrations | Pass via `Authorization: Bearer <key>` header     |
+| OAuth 2.0  | User-facing applications      | Standard authorization code flow with PKCE        |
+| JWT Tokens | Session-based access          | Returned on login, expires in 1 hour, refreshable |
+
+### Security measures
+
+- **HTTPS only** — All traffic is encrypted with TLS 1.3. Plain HTTP requests are rejected.
+- **Rate limiting** — Default: 1,000 requests/minute per API key. Enterprise plans support custom limits.
+- **Input validation** — All inputs are validated and sanitized against injection attacks.
+- **Audit logging** — Every API call is logged with timestamp, IP, method, endpoint, and response code.
+
+---
+
+## Core Endpoints
+
+### Search API
+
+```
+POST /v1/search
+```
+
+Execute a semantic or keyword search across your indexed content.
+
+**Parameters:**
+
+| Field     | Type    | Required | Description                                            |
+| --------- | ------- | -------- | ------------------------------------------------------ |
+| `query`   | string  | Yes      | The search query                                       |
+| `mode`    | string  | No       | `semantic`, `keyword`, or `hybrid` (default: `hybrid`) |
+| `limit`   | integer | No       | Max results to return (default: 10, max: 100)          |
+| `filters` | object  | No       | Filter by date, source, tag, or content type           |
+
+### User API
+
+```
+GET /v1/users/me
+PUT /v1/users/me
+```
+
+Retrieve or update the authenticated user's profile, preferences, and settings.
+
+### Content API
+
+```
+GET /v1/content
+POST /v1/content
+DELETE /v1/content/:id
+```
+
+Manage indexed content — upload documents, list sources, or remove specific items.
+
+---
+
+## Advanced Features
+
+### Batch operations
+
+```
+POST /v1/batch
+```
+
+Submit up to 100 operations in a single request. Each operation is processed independently, and the response includes individual status codes.
+
+### Webhooks
+
+Configure webhooks to receive real-time notifications when events occur (e.g., content indexed, search completed, error triggered).
+
+```
+POST /v1/webhooks
+```
+
+Webhook payloads are signed with HMAC-SHA256 so you can verify authenticity.
+
+### Pagination
+
+All list endpoints support cursor-based pagination:
+
+```
+GET /v1/content?cursor=eyJpZCI6MTIzfQ&limit=25
+```
+
+The response includes a `next_cursor` field. Pass it as the `cursor` parameter to fetch the next page.
+
+---
+
+## SDKs & Libraries
+
+| Language   | Package       | Install                                  |
+| ---------- | ------------- | ---------------------------------------- |
+| Python     | `yantra-sdk`  | `pip install yantra-sdk`                 |
+| JavaScript | `@yantra/sdk` | `npm install @yantra/sdk`                |
+| Go         | `go-yantra`   | `go get github.com/yantra-app/go-yantra` |
+
+All SDKs include TypeScript definitions, automatic retry logic, and built-in rate limit handling.
+
+---
+
+## Rate Limits & Error Codes
+
+### Common error codes
+
+| Code | Meaning               | What to do                                                    |
+| ---- | --------------------- | ------------------------------------------------------------- |
+| 400  | Bad Request           | Check your request body and parameters                        |
+| 401  | Unauthorized          | Verify your API key or refresh your JWT                       |
+| 403  | Forbidden             | You don't have permission for this resource                   |
+| 429  | Too Many Requests     | Back off and retry after the `Retry-After` header value       |
+| 500  | Internal Server Error | Retry with exponential backoff; contact support if persistent |
+
+> **Tip:** All SDKs handle 429 and 5xx errors automatically with exponential backoff and jitter.