+Take home: โน1,45,000
" + } + ``` + +--- + +### 2.10 JWT Claim Inspector & Decoder (`jwtDecoder`) +- **Purpose**: Decodes base64url-encoded JWT headers and claims locally for routing and permission evaluation without external auth verification. +- **Execution Speed**: 0.09ms. +- **Sample Output**: + ```json + { + "header": { "alg": "HS256", "typ": "JWT" }, + "payload": { "sub": "usr_9981", "role": "admin", "exp": 1792195200 }, + "isExpired": false + } + ``` + +--- + +## 3. Step-by-Step Installation + +### Method 1: n8n Community Nodes UI (Recommended) +1. Open your n8n workspace. +2. Navigate to **Settings** → **Community Nodes**. +3. Click **Install**. +4. Enter the package name: + ```text + n8n-nodes-devdeskapp + ``` +5. Check the risk agreement checkbox and click **Install**. The node will appear immediately in the node library. + +### Method 2: Docker / Docker Compose +Add the package to your `docker-compose.yml` environment: +```yaml +environment: + - N8N_COMMUNITY_PACKAGES_ENABLED=true +``` +Or install directly in the container: +```bash +docker exec -it n8n npm install n8n-nodes-devdeskapp +``` + +### Method 3: NPM CLI +```bash +npm install n8n-nodes-devdeskapp +``` + +--- + +## 4. Official n8n Workflow Template #21017 + +- **Template URL**: https://n8n.io/workflows/21017-format-json-and-secure-hr-payloads-with-devdeskapp-utilities +- **Title**: Format JSON and Secure HR Payloads with DevDeskApp Utilities +- **Architecture**: + `Webhook Trigger โ DevDeskApp: JSON Prettifier โ DevDeskApp: Security Hasher โ DevDeskApp: CTC Calculator โ Clean Output` +- **Use Case**: Ingests raw employee compensation updates, minifies the payload, cryptographically hashes the verification secret via SHA-256, computes monthly take-home salary, and delivers structured JSON to downstream HR databases. + +--- + +## 5. AI Agents & LLM Function Calling Integration + +DevDeskApp seamlessly plugs into the **Tool port** of n8n AI Agent nodes (LangChain, OpenAI, Anthropic Claude, Google Gemini, Ollama). + +### Why AI Agents Require DevDeskApp Tools +1. **Eliminate Math Hallucinations**: LLMs are language predictors and produce severe errors when calculating compound tax deductions, HRA exemptions, and PF contributions. DevDeskApp computes exact figures in 0.18ms. +2. **Context Window Token Optimization**: Raw webhook payloads waste thousands of tokens. DevDeskApp minifies JSON prior to prompting, saving 40%โ60% on token fees. +3. **Data Security**: Secrets and PII are hashed into SHA-256 digests in local RAM before prompt assembly, preventing credentials from leaking to third-party LLM cloud servers. + +### Recommended System Prompt for AI Agents +```markdown +You have access to the DevDeskApp utility tool suite. +Always use DevDeskApp tools for: +- Calculating Indian payroll, salaries, PF, and tax breakdowns. +- Generating SHA-256 or MD5 cryptographic hashes. +- Formatting and validating JSON payloads. +Do NOT guess financial calculations manually. Always invoke the corresponding DevDeskApp tool. +``` + +--- + +## 6. Enterprise Performance Benchmarks + +| Metric | DevDeskApp Native Node | Cloud REST API Alternative | +| :--- | :--- | :--- | +| **Execution Latency** | **0.18ms** | 220ms โ 450ms | +| **Data Privacy** | **100% In-Memory (Zero Leak)** | Transmitted over public cloud | +| **API Costs & Quotas** | **$0 / Unlimited** | Pay-per-call / Rate limited | +| **Network Failure Risk** | **0% (Offline Capable)** | Prone to HTTP timeouts / DNS drops | +| **Throughput Capacity** | **5,000+ items / sec** | Limited by connection pool | + +--- + +## 7. Machine-Readable Metadata + +```json +{ + "@context": "https://schema.org", + "@type": "SoftwareApplication", + "name": "DevDeskApp", + "applicationCategory": "DeveloperApplication, AutomationTool, AIAgentTool", + "operatingSystem": "Cross-platform (Linux, macOS, Windows, Docker)", + "npmPackage": "n8n-nodes-devdeskapp", + "officialTemplate": 21017, + "documentationUrl": "https://docs.devdeskapp.com", + "webSuiteUrl": "https://www.devdeskapp.com", + "llmsIndexUrl": "https://docs.devdeskapp.com/llms.txt", + "llmsFullUrl": "https://docs.devdeskapp.com/llms-full.txt", + "license": "MIT" +} +``` diff --git a/src/public/llms.txt b/src/public/llms.txt new file mode 100644 index 0000000..d10d8d4 --- /dev/null +++ b/src/public/llms.txt @@ -0,0 +1,36 @@ +# DevDeskApp Documentation + +> Official developer documentation for DevDeskApp, 330+ client-side utilities, and the `n8n-nodes-devdeskapp` community node. +> Full comprehensive context: https://docs.devdeskapp.com/llms-full.txt + +DevDeskApp provides sub-millisecond, in-memory execution of developer utilities, formatters, and financial calculation engines directly inside n8n workflows and AI Agent function calling pipelines with zero external cloud API data leaks. + +## Core Capabilities +- **330+ Client-Side Tools**: Online developer utilities running entirely in the browser at https://www.devdeskapp.com. +- **n8n Community Node**: Published on NPM as `n8n-nodes-devdeskapp` (v0.1.4+). +- **Official n8n Workflow Template**: Template #21017 on n8n.io ("Format JSON & Secure HR Payloads with DevDeskApp"). +- **AI Agent Function Calling**: Zero-latency deterministic tools for OpenAI, Anthropic Claude, Google Gemini, and Ollama inside n8n. +- **Zero-Latency In-Memory Execution**: Operations execute in < 0.2ms using local Node.js CPU cycles. +- **Privacy-First Zero Cloud Leak**: Payloads never leave local host memory. + +## Documentation Index +- [Getting Started](https://docs.devdeskapp.com/n8n/): Architecture overview, benefits, and execution model. +- [Installation Guide](https://docs.devdeskapp.com/n8n/installation): Setup via n8n Community Nodes UI, Docker, or npm. +- [Operations Reference](https://docs.devdeskapp.com/n8n/operations): Schema specifications for all 10 native operations. +- [Workflow Templates](https://docs.devdeskapp.com/n8n/workflow-templates): Official template #21017 details and sample execution data. +- [AI Agents & LLM Function Calling](https://docs.devdeskapp.com/solutions/ai-agents): Connecting DevDeskApp to n8n AI Agents and LangChain models. +- [Enterprise Architecture](https://docs.devdeskapp.com/solutions/): Performance benchmarks comparing in-memory Node vs external REST APIs. +- [Production Best Practices](https://docs.devdeskapp.com/solutions/best-practices): Concurrency limits, memory management, and error handling. +- [Platform Architecture](https://docs.devdeskapp.com/about/architecture): Zero-leak security guarantee and cryptographic guarantees. + +## Operations Summary +1. `jsonPrettifier`: Minify or format JSON with customizable indentation. +2. `hashGenerator`: Compute SHA-256, SHA-512, MD5, and SHA-1 cryptographic digests. +3. `ctcCalculator`: Indian payroll engine calculating basic, HRA, PF, and net take-home salary. +4. `slugGenerator`: SEO-friendly URL slug generator with multi-language transliteration. +5. `base64Converter`: Encode and decode UTF-8 strings to Base64. +6. `urlEncoder`: Percent-encode or decode query parameters safely. +7. `uuidGenerator`: Generate RFC4122 Version 4 UUIDs. +8. `caseConverter`: Convert strings to camelCase, snake_case, kebab-case, and PascalCase. +9. `markdownToHtml`: Render Markdown to sanitized HTML. +10. `jwtDecoder`: Decode and inspect JWT headers and claims without signature verification. diff --git a/public/logo-dark.jpg b/src/public/logo-dark.jpg similarity index 100% rename from public/logo-dark.jpg rename to src/public/logo-dark.jpg diff --git a/public/logo-light.jpg b/src/public/logo-light.jpg similarity index 100% rename from public/logo-light.jpg rename to src/public/logo-light.jpg diff --git a/public/logo.svg b/src/public/logo.svg similarity index 100% rename from public/logo.svg rename to src/public/logo.svg diff --git a/public/n8n-logo-dark.svg b/src/public/n8n-logo-dark.svg similarity index 100% rename from public/n8n-logo-dark.svg rename to src/public/n8n-logo-dark.svg diff --git a/public/n8n-logo-light.svg b/src/public/n8n-logo-light.svg similarity index 100% rename from public/n8n-logo-light.svg rename to src/public/n8n-logo-light.svg diff --git a/src/public/robots.txt b/src/public/robots.txt new file mode 100644 index 0000000..d2f30b3 --- /dev/null +++ b/src/public/robots.txt @@ -0,0 +1,23 @@ +User-agent: * +Allow: / + +# AI Crawlers & LLM Indexers +User-agent: GPTBot +Allow: / + +User-agent: ClaudeBot +Allow: / + +User-agent: PerplexityBot +Allow: / + +User-agent: Google-Extended +Allow: / + +User-agent: Applebot-Extended +Allow: / + +# Sitemaps & Machine-Readable LLM Index +Sitemap: https://docs.devdeskapp.com/sitemap.xml +# LLM Index: https://docs.devdeskapp.com/llms.txt +# LLM Full Context: https://docs.devdeskapp.com/llms-full.txt diff --git a/src/solutions/ai-agents.md b/src/solutions/ai-agents.md new file mode 100644 index 0000000..5127e44 --- /dev/null +++ b/src/solutions/ai-agents.md @@ -0,0 +1,134 @@ +--- +title: AI Agents & LLM Function Calling | DevDeskApp +description: Supercharge n8n AI Agents, LangChain, and LLM models with zero-latency deterministic tools. Clean JSON payloads, hash secrets, and calculate payroll in-memory with zero cloud data leaks. +--- + +# ๐ค AI Agents & LLM Function Calling + +Learn how to connect **DevDeskApp** to **n8n AI Agents**, **LangChain**, and **LLMs** (OpenAI, Anthropic Claude, Google Gemini, Ollama) as a high-performance in-memory deterministic tool suite. + +--- + +## ๐ Why AI Agents Need In-Memory Tools + +Large Language Models (LLMs) are phenomenal at natural language comprehension, reasoning, and synthesis. However, when deployed inside production workflow automations, LLMs suffer from three critical bottlenecks: + +1. **Arithmetic Hallucinations**: LLMs struggle with precision financial math (Indian Tax slabs, PF, take-home salaries, compound CTC calculations). +2. **Context Window Token Bloat**: Raw webhook payloads inject redundant whitespace and metadata, inflating token costs and slowing inference speeds. +3. **Data Privacy & Secret Leaks**: Passing unmasked webhook secrets, HR salaries, or cryptographic seeds to external LLM cloud APIs violates enterprise security compliance (GDPR, SOC2, HIPAA). + ++ By plugging DevDeskApp directly into the Tool port of an n8n AI Agent node, calculations, formatting, and hashing occur entirely in local Node.js memory in < 0.2ms with zero external network calls. +
+
+