nduka 1.0.0

package/config/secure-tools.example.json

@@ -0,0 +1,200 @@
+{
+  "version": 1,
+  "tools": [
+    {
+      "type": "mock",
+      "name": "rental_fee_lookup",
+      "description": "Look up a customer's rental fee balance from a connected rental system.",
+      "enabled": true,
+      "riskLevel": "sensitive_read",
+      "ownerOnly": false,
+      "tenantScoped": true,
+      "requiresApproval": false,
+      "naturalLanguage": {
+        "enabled": true,
+        "customerFacingName": "rental fee lookup",
+        "useWhen": "Use this tool when a customer asks about rental fees, rent balance, amount due, due dates, owed rent, rental payment status, or rental account charges.",
+        "triggerPhrases": ["rental fee", "rent balance", "amount due", "how much do i owe", "rent due", "rental payment"],
+        "examples": ["How much is my rental fee?", "Can you check my rent balance?", "Do I owe anything for rent?"],
+        "tags": ["rent", "rental", "balance", "due", "payable"],
+        "approvalPrompt": "I can check your rental fee balance, but I need your approval first."
+      },
+      "routing": {
+        "minConfidence": 0.72,
+        "clarifyBelow": 0.72,
+        "ignoreBelow": 0.35,
+        "clarificationPrompt": "Do you want me to check your rental balance?"
+      },
+      "verification": {
+        "mode": "profile_or_collect",
+        "identityFields": ["customer_id"],
+        "maxAttempts": 3
+      },
+      "inputSchema": {
+        "customer_id": {
+          "type": "string",
+          "required": true,
+          "description": "Customer ID from trusted profile or from customer if this tool is configured to ask.",
+          "source": "profile_or_customer",
+          "askIfMissing": true,
+          "prompt": "Please send your customer ID so I can check your rental balance.",
+          "validationRegex": "^[A-Za-z0-9_-]{3,64}$",
+          "validationMessage": "That customer ID format does not look right. Please check it and send it again.",
+          "maxAttempts": 3
+        }
+      },
+      "outputSchema": {
+        "balance_due": { "type": "number" },
+        "currency": { "type": "string" },
+        "due_date": { "type": "string" }
+      },
+      "mockResponse": {
+        "balance_due": 2500,
+        "currency": "AED",
+        "due_date": "2026-07-05"
+      }
+    },
+    {
+      "type": "webhook",
+      "name": "weather_lookup",
+      "description": "Fetch weather for a location using an external weather API.",
+      "enabled": false,
+      "riskLevel": "public_read",
+      "ownerOnly": false,
+      "tenantScoped": false,
+      "requiresApproval": false,
+      "naturalLanguage": {
+        "enabled": true,
+        "customerFacingName": "weather lookup",
+        "useWhen": "Use this when a user asks about current weather or forecast for a city or location.",
+        "triggerPhrases": ["weather", "forecast", "temperature"],
+        "examples": ["What's the weather in Dubai?", "Is it raining in London?"]
+      },
+      "verification": { "mode": "none" },
+      "inputSchema": {
+        "location": {
+          "type": "string",
+          "required": true,
+          "source": "customer",
+          "askIfMissing": true,
+          "prompt": "Which city or location should I check?",
+          "minLength": 2,
+          "maxAttempts": 2
+        }
+      },
+      "outputSchema": {},
+      "api": {
+        "url": "https://api.example.com/weather",
+        "method": "GET",
+        "allowedHosts": ["api.example.com"],
+        "timeoutMs": 30000,
+        "auth": { "mode": "none" }
+      }
+    },
+    {
+      "type": "mock",
+      "name": "account_login_verify",
+      "description": "Verify username and password before an account-sensitive lookup.",
+      "enabled": false,
+      "riskLevel": "sensitive_read",
+      "ownerOnly": false,
+      "tenantScoped": true,
+      "requiresApproval": false,
+      "naturalLanguage": { "enabled": false, "triggerPhrases": ["login verify"] },
+      "inputSchema": {
+        "username": { "type": "string", "required": true, "source": "customer", "askIfMissing": true },
+        "password": { "type": "string", "required": true, "source": "customer_secret", "askIfMissing": true, "secret": true }
+      },
+      "outputSchema": { "ok": { "type": "boolean" }, "customer_id": { "type": "string" } },
+      "mockResponse": { "ok": true, "customer_id": "cust_verified" }
+    },
+    {
+      "type": "mock",
+      "name": "account_details_lookup",
+      "description": "Look up account details after configured verification.",
+      "enabled": false,
+      "riskLevel": "sensitive_read",
+      "ownerOnly": false,
+      "tenantScoped": true,
+      "requiresApproval": true,
+      "naturalLanguage": {
+        "enabled": true,
+        "customerFacingName": "account details lookup",
+        "useWhen": "Use this when a user asks to view account details, profile details, subscription information, or account status.",
+        "triggerPhrases": ["account details", "my profile", "subscription status", "account status"],
+        "examples": ["Can you check my account details?", "What subscription am I on?"]
+      },
+      "routing": {
+        "minConfidence": 0.72,
+        "ignoreBelow": 0.35,
+        "clarificationPrompt": "Do you want me to check your account details?"
+      },
+      "verification": {
+        "mode": "collect_and_verify",
+        "identityFields": ["username"],
+        "secretFields": ["password"],
+        "verifyWithTool": "account_login_verify",
+        "onSuccessAssign": {
+          "session.customer_id": "response.customer_id"
+        },
+        "maxAttempts": 3
+      },
+      "inputSchema": {
+        "username": {
+          "type": "string",
+          "required": true,
+          "source": "customer",
+          "askIfMissing": true,
+          "prompt": "Please send your username.",
+          "validationRegex": "^[A-Za-z0-9_.-]{3,64}$",
+          "maxAttempts": 3
+        },
+        "password": {
+          "type": "string",
+          "required": true,
+          "source": "customer_secret",
+          "askIfMissing": true,
+          "prompt": "Please send your password.",
+          "secret": true,
+          "exposeToModel": false,
+          "minLength": 6,
+          "maxAttempts": 3
+        }
+      },
+      "outputSchema": { "plan": { "type": "string" }, "status": { "type": "string" } },
+      "mockResponse": { "plan": "Premium", "status": "active" }
+    },
+    {
+      "type": "mcp",
+      "name": "mcp_calendar_lookup",
+      "description": "Example MCP-backed tool metadata. Requires an MCP executor adapter before enabling.",
+      "enabled": false,
+      "riskLevel": "sensitive_read",
+      "ownerOnly": false,
+      "tenantScoped": true,
+      "requiresApproval": true,
+      "naturalLanguage": {
+        "enabled": true,
+        "customerFacingName": "calendar lookup",
+        "useWhen": "Use this when a user asks to inspect calendar availability through a configured MCP server.",
+        "triggerPhrases": ["calendar availability", "available time", "schedule lookup"],
+        "examples": ["Do I have time tomorrow afternoon?"]
+      },
+      "verification": { "mode": "chat_link" },
+      "inputSchema": {
+        "chat_jid": {
+          "type": "string",
+          "required": true,
+          "source": "system",
+          "systemKey": "chatJid"
+        }
+      },
+      "outputSchema": {},
+      "mcp": {
+        "serverName": "calendar",
+        "toolName": "lookup_availability",
+        "timeoutMs": 30000
+      }
+    }
+  ]
+}

package/config/test.env

@@ -0,0 +1,2 @@
+CHAT_RATE_LIMIT_MAX_TOKENS=50
+CHAT_RATE_LIMIT_REFILL_PER_SECOND=50

package/config/tools.chatbot.json

@@ -0,0 +1,318 @@
+{
+  "version": 1,
+  "responses": {
+    "checking": [
+      "I’m checking that now.",
+      "I’ll check the configured source now.",
+      "Let me verify that with the available lookup."
+    ],
+    "clarify": [
+      "I need one more detail before I can check that.",
+      "Please confirm exactly what you want me to look up.",
+      "Which specific topic, person, place, account, team, or date should I check?"
+    ],
+    "manualReview": [
+      "I could not safely confirm this from the available sources, so I have flagged it for review.",
+      "I could not verify that automatically, so this has been marked for manual review."
+    ],
+    "blocked": [
+      "I cannot help with that request."
+    ]
+  },
+  "providers": {
+    "crunchtrova": {
+      "enabled": true,
+      "adapter": "crunchtrova",
+      "operations": {
+        "web": {
+          "kind": "web_search",
+          "resultMode": "list",
+          "timeoutSeconds": 180,
+          "maxResults": 5,
+          "paths": [
+            "/search/web",
+            "/web/search",
+            "/search",
+            "/tools/google-search",
+            "/tools/google_search",
+            "/tool/google_search",
+            "/google/search",
+            "/search/google"
+          ]
+        },
+        "news": {
+          "kind": "news_search",
+          "resultMode": "list",
+          "timeoutSeconds": 180,
+          "maxResults": 5,
+          "paths": [
+            "/search/news",
+            "/news/search",
+            "/news",
+            "/tools/news-search",
+            "/tools/news_search",
+            "/tool/news_search"
+          ]
+        },
+        "fetch": {
+          "kind": "url_fetch",
+          "resultMode": "document",
+          "timeoutSeconds": 180,
+          "maxResults": 1,
+          "paths": [
+            "/fetch/url",
+            "/url/fetch",
+            "/fetch",
+            "/tools/url-search",
+            "/tools/url_search",
+            "/tool/url_search",
+            "/url/search"
+          ]
+        }
+      }
+    }
+  },
+  "tools": {
+    "web_search": {
+      "enabled": true,
+      "description": "Search the web for current, external, factual, public, or time-sensitive information.",
+      "capabilityTags": [
+        "public_web",
+        "current_info",
+        "factual_lookup"
+      ],
+      "provider": "crunchtrova",
+      "operation": "web",
+      "public": true,
+      "ownerOnly": false,
+      "customerCallable": true,
+      "requiresApproval": false,
+      "requiresIdentity": false,
+      "tenantScoped": false,
+      "syncEligible": false,
+      "asyncEligible": true,
+      "synthesis": true,
+      "rawAllowed": true,
+      "aliases": [
+        "search"
+      ],
+      "inputSchema": {
+        "query": {
+          "type": "string",
+          "required": true,
+          "description": "Search query"
+        }
+      },
+      "outputSchema": {
+        "title": {
+          "type": "string",
+          "description": "Result title"
+        },
+        "snippet": {
+          "type": "string",
+          "description": "Result summary or snippet"
+        },
+        "url": {
+          "type": "string",
+          "description": "Source URL"
+        }
+      },
+      "groundingPolicy": {
+        "requiresToolResult": true,
+        "allowModelEstimates": false,
+        "requiredFields": [
+          "title",
+          "snippet"
+        ]
+      },
+      "clarification": {
+        "missingRequiredArg": "I can check that, but I need to know exactly what you want me to search for.",
+        "lowConfidence": "I may need to search for that, but I need a little more detail first.",
+        "noMatchingTool": "I do not have a matching public lookup for that yet."
+      },
+      "failurePolicy": {
+        "onNoMatch": "clarify",
+        "onToolError": "manual_review",
+        "onEmptyResult": "clarify"
+      },
+      "timeouts": {
+        "timeoutSeconds": 180,
+        "maxRetries": 2
+      },
+      "commands": {
+        "aliases": [
+          "search",
+          "s"
+        ],
+        "rawAliases": [
+          "searchraw",
+          "sraw"
+        ],
+        "usage": "/search <query>",
+        "rawUsage": "/searchraw <query>",
+        "title": "Web Search",
+        "rawTitle": "Raw Web Search",
+        "icon": "🔍"
+      }
+    },
+    "news_search": {
+      "enabled": true,
+      "description": "Search recent public news articles and current headlines.",
+      "capabilityTags": [
+        "public_news",
+        "current_info",
+        "factual_lookup"
+      ],
+      "provider": "crunchtrova",
+      "operation": "news",
+      "public": true,
+      "ownerOnly": false,
+      "customerCallable": true,
+      "requiresApproval": false,
+      "requiresIdentity": false,
+      "tenantScoped": false,
+      "syncEligible": false,
+      "asyncEligible": true,
+      "synthesis": true,
+      "rawAllowed": true,
+      "aliases": [
+        "news"
+      ],
+      "inputSchema": {
+        "query": {
+          "type": "string",
+          "required": true,
+          "description": "News query"
+        }
+      },
+      "outputSchema": {
+        "title": {
+          "type": "string",
+          "description": "Article title"
+        },
+        "snippet": {
+          "type": "string",
+          "description": "Article summary or snippet"
+        },
+        "url": {
+          "type": "string",
+          "description": "Source URL"
+        },
+        "publishedAt": {
+          "type": "string",
+          "description": "Publication timestamp when available"
+        }
+      },
+      "groundingPolicy": {
+        "requiresToolResult": true,
+        "allowModelEstimates": false,
+        "requiredFields": [
+          "title",
+          "snippet"
+        ]
+      },
+      "clarification": {
+        "missingRequiredArg": "I can check the news, but I need the topic, place, person, or organization you want checked.",
+        "lowConfidence": "I may need to check the news for that, but I need a little more detail first.",
+        "noMatchingTool": "I do not have a matching news lookup for that yet."
+      },
+      "failurePolicy": {
+        "onNoMatch": "clarify",
+        "onToolError": "manual_review",
+        "onEmptyResult": "clarify"
+      },
+      "timeouts": {
+        "timeoutSeconds": 180,
+        "maxRetries": 2
+      },
+      "commands": {
+        "aliases": [
+          "news",
+          "n"
+        ],
+        "rawAliases": [
+          "newsraw",
+          "nraw"
+        ],
+        "usage": "/news <query>",
+        "rawUsage": "/newsraw <query>",
+        "title": "News Search",
+        "rawTitle": "Raw News Search",
+        "icon": "📰"
+      }
+    },
+    "url_fetch": {
+      "enabled": true,
+      "description": "Fetch and read a specific web page when the URL is provided.",
+      "capabilityTags": [
+        "url_fetch",
+        "document_reading",
+        "public_web"
+      ],
+      "provider": "crunchtrova",
+      "operation": "fetch",
+      "public": false,
+      "ownerOnly": true,
+      "customerCallable": false,
+      "requiresApproval": true,
+      "requiresIdentity": false,
+      "tenantScoped": false,
+      "syncEligible": false,
+      "asyncEligible": false,
+      "synthesis": true,
+      "rawAllowed": true,
+      "aliases": [
+        "fetch"
+      ],
+      "inputSchema": {
+        "url": {
+          "type": "string",
+          "required": true,
+          "description": "URL to fetch"
+        }
+      },
+      "outputSchema": {
+        "content": {
+          "type": "string",
+          "required": true,
+          "description": "Fetched page content"
+        },
+        "url": {
+          "type": "string",
+          "description": "Fetched source URL"
+        }
+      },
+      "groundingPolicy": {
+        "requiresToolResult": true,
+        "allowModelEstimates": false,
+        "requiredFields": [
+          "content"
+        ]
+      },
+      "failurePolicy": {
+        "onNoMatch": "clarify",
+        "onToolError": "manual_review",
+        "onEmptyResult": "clarify"
+      },
+      "timeouts": {
+        "timeoutSeconds": 180,
+        "maxRetries": 1
+      },
+      "commands": {
+        "aliases": [
+          "fetch",
+          "f"
+        ],
+        "rawAliases": [
+          "fetchraw",
+          "fraw"
+        ],
+        "usage": "/fetch <url>",
+        "rawUsage": "/fetchraw <url>",
+        "title": "Fetch",
+        "rawTitle": "Raw Fetch",
+        "icon": "📄"
+      }
+    }
+  }
+}

package/dist/acceptance/index.d.ts

@@ -0,0 +1,3 @@
+export { AcceptanceRunner, ACCEPTANCE_STEPS } from './runner.js';
+export type { AcceptanceStep, AcceptanceResult, AcceptanceReport } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/acceptance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acceptance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/acceptance/index.js

@@ -0,0 +1,2 @@
+export { AcceptanceRunner, ACCEPTANCE_STEPS } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/acceptance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acceptance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/acceptance/runner.d.ts

@@ -0,0 +1,57 @@
+/**
+ * WhatsApp Acceptance Test Runner
+ *
+ * Interactive test runner for validating real WhatsApp functionality.
+ * Guides the operator through 15 steps of testing:
+ *  - QR pairing
+ *  - Text/Image/PDF/Voice reception
+ *  - Message edit/delete/reaction
+ *  - Group interactions
+ *  - Outbound messages
+ *  - Session persistence on restart
+ *  - Network disconnect/reconnect recovery
+ */
+import { EventEmitter } from 'node:events';
+export type AcceptanceStep = {
+    id: number;
+    name: string;
+    instruction: string;
+    expectedBehavior: string;
+    timeoutMs: number;
+    requiresOperator: boolean;
+};
+export interface AcceptanceResult {
+    stepId: number;
+    name: string;
+    passed: boolean;
+    durationMs: number;
+    error?: string;
+    operatorNotes?: string;
+}
+export interface AcceptanceReport {
+    totalSteps: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    durationMs: number;
+    results: AcceptanceResult[];
+    readyForProduction: boolean;
+}
+export declare const ACCEPTANCE_STEPS: AcceptanceStep[];
+export declare class AcceptanceRunner extends EventEmitter {
+    private results;
+    private currentStep;
+    private startTime;
+    /**
+     * Run all acceptance steps.
+     */
+    runAll(): Promise<AcceptanceReport>;
+    /**
+     * Generate the acceptance report.
+     */
+    generateReport(): AcceptanceReport;
+    private simulateOperatorWait;
+    private executeAutomatedStep;
+    private delay;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/acceptance/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/acceptance/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAID,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAyH5C,CAAC;AAIF,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;IAEtB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAkDzC;;OAEG;IACH,cAAc,IAAI,gBAAgB;YAkBpB,oBAAoB;YAMpB,oBAAoB;IAMlC,OAAO,CAAC,KAAK;CAGd"}