Test

Instructions

Implementation Reference

• src/index.ts:713-764 (handler)

  Main handler function for the 'opzet_hypotheek_uitgebreid' tool. Validates and normalizes input arguments, constructs the payload for the external Replit API (REPLIT_API_URL_OPZET), performs the API call, and formats the response using formatResponse.
  async function handleOpzetUitgebreid(request: any): Promise<ToolResponse> { const rawArgs = requireArguments<OpzetUitgebreidArguments>(request); const normalizedArgs = rawArgs.is_doorstromer ? (normalizeOpzetDoorstromerArgs(rawArgs) as OpzetUitgebreidArguments) : (normalizeOpzetAanvragerShape(rawArgs) as OpzetUitgebreidArguments); const logger = createLogger(normalizedArgs.session_id); const aanvrager = requireOpzetAanvrager(normalizedArgs); validateOpzetAanvrager(aanvrager); if (normalizedArgs.is_doorstromer && normalizedArgs.bestaande_hypotheek) { validateBestaandeHypotheek(normalizedArgs.bestaande_hypotheek); } enforceRateLimit(normalizedArgs.session_id); const payload: any = { aanvrager: mapOpzetAanvrager(aanvrager), nieuwe_woning: { waarde_woning: normalizedArgs.nieuwe_woning.waarde_woning, bedrag_verbouwen: normalizedArgs.nieuwe_woning.bedrag_verbouwen ?? 0, bedrag_verduurzamen: normalizedArgs.nieuwe_woning.bedrag_verduurzamen ?? 0, kosten_percentage: normalizedArgs.nieuwe_woning.kosten_percentage ?? 0.05, energielabel: normalizeEnergielabel(normalizedArgs.nieuwe_woning.energielabel || ''), }, }; if (normalizedArgs.is_doorstromer && normalizedArgs.waarde_huidige_woning && normalizedArgs.bestaande_hypotheek) { payload.bestaande_hypotheek = { waarde_huidige_woning: normalizedArgs.waarde_huidige_woning, leningdelen: normalizedArgs.bestaande_hypotheek.leningdelen, }; } const maatwerk = (normalizedArgs as any).nieuwe_hypotheek ?? (normalizedArgs as any).nieuwe_lening; const nieuweLening = buildNieuweLeningPayload(maatwerk); if (nieuweLening) { payload.nieuwe_lening = nieuweLening; } if (normalizedArgs.session_id) { payload.session_id = normalizedArgs.session_id; } const apiClient = getApiClient(); const { data } = await apiClient.post( REPLIT_API_URL_OPZET, payload, { correlationId: normalizedArgs.session_id } ); logger.info('Toolcall succesvol', { tool: 'opzet_hypotheek_uitgebreid' }); return successResponse(formatResponse(data, "opzet_hypotheek_uitgebreid")); }
• src/index.ts:766-774 (registration)

  Registration of the tool handler in the TOOL_HANDLERS object, which maps the tool name 'opzet_hypotheek_uitgebreid' to its handler function. This map is used by the CallToolRequestSchema handler to dispatch requests.
  const TOOL_HANDLERS: Record<string, ToolHandler> = { bereken_hypotheek_starter: handleBerekenStarter, bereken_hypotheek_doorstromer: handleBerekenDoorstromer, bereken_hypotheek_uitgebreid: handleBerekenUitgebreid, haal_actuele_rentes_op: handleActueleRentes, opzet_hypotheek_starter: handleOpzetStarter, opzet_hypotheek_doorstromer: handleOpzetDoorstromer, opzet_hypotheek_uitgebreid: handleOpzetUitgebreid, };
• src/index.ts:940-1097 (schema)

  Input schema and metadata definition for the tool, provided in the ListTools response. Includes detailed properties, descriptions, enums, and required fields for validation and documentation.
  { name: "opzet_hypotheek_uitgebreid", description: `GEAVANCEERDE opzet hypotheek berekening met VOLLEDIGE controle over alle parameters. Gebruik deze variant alleen wanneer er een concrete woning is én de gebruiker/adviseur expliciet scenario’s wil tweaken (andere rentes, looptijden, specifieke nieuwe leningdelen). Voor snelle beantwoording zonder maatwerk blijft u bij opzet_hypotheek_starter of opzet_hypotheek_doorstromer. **Output bevat alles van de starter/doorstromer tools, plus:** - Mogelijkheid om elk leningdeel handmatig te definiëren - Custom rentepercentages, looptijden en rentevast periodes - NHG, energielabel en verbouwing/duurzaamheidsbudget in één scenario - Volledige balans check en praktische toelichtingen Gebruik deze tool alleen wanneer afwijkende parameters nodig zijn; anders de specifieke starter/doorstromer varianten gebruiken. **Doorstromer invoerbeleid:** - Vraag óók hier: "Wilt u een snelle globale berekening (met een samenvatting van uw hypotheek) of een detailberekening waarbij u alle leningdelen invoert?" - Snelle route → één samenvattend leningdeel (totale schuld, gemiddelde rente/looptijd, optionele maandlast). - Detailroute → volledige lijst leningdelen met de exacte waarden per deel. Kopieer deze rechtstreeks in de leningdelen array.`, inputSchema: { type: "object", properties: { aanvrager: aanvragerSchema, is_doorstromer: { type: "boolean", description: "Is dit een doorstromer met bestaande woning en hypotheek?", }, waarde_huidige_woning: { type: "number", description: "OPTIONEEL - Alleen voor doorstromers: huidige woningwaarde in euro's", }, bestaande_hypotheek: { type: "object", description: "OPTIONEEL - Alleen voor doorstromers: gegevens van de bestaande hypotheek.", properties: { leningdelen: { type: "array", items: { type: "object", properties: { huidige_schuld: { type: "number", description: "Restschuld in euro's", }, huidige_rente: { type: "number", description: "Rente als decimaal (bijv. 0.041 voor 4.1%)", }, resterende_looptijd_in_maanden: { type: "number", description: "Resterende looptijd in MAANDEN", }, rentevasteperiode_maanden: { type: "number", description: "Resterende rentevaste periode in MAANDEN", }, hypotheekvorm: { type: "string", description: "Type hypotheek", enum: ["annuiteit", "lineair", "aflossingsvrij"], }, }, required: ["huidige_schuld", "huidige_rente", "resterende_looptijd_in_maanden", "rentevasteperiode_maanden", "hypotheekvorm"], }, }, }, required: ["leningdelen"], }, nieuwe_woning: { type: "object", description: "Gegevens van de nieuwe woning die gekocht wordt", properties: { waarde_woning: { type: "number", description: "Koopsom van de nieuwe woning in euro's", }, bedrag_verbouwen: { type: "number", description: "OPTIONEEL - Geschatte kosten voor verbouwing/meerwerk in euro's.", default: 0, }, bedrag_verduurzamen: { type: "number", description: "OPTIONEEL - Geschatte kosten voor verduurzaming in euro's.", default: 0, }, kosten_percentage: { type: "number", description: "OPTIONEEL - Koperkosten als decimaal (bijv. 0.05 voor 5%). Standaard: 0.05", default: 0.05, }, energielabel: { type: "string", description: "OPTIONEEL - Energielabel van de nieuwe woning.", enum: ["A++++ (met garantie)", "A++++", "A+++", "A++", "A+", "A", "B", "C", "D", "E", "F", "G"], }, }, required: ["waarde_woning"], }, nieuwe_lening: { type: "object", description: "OPTIONEEL - Specifieke parameters voor de nieuwe lening. Gebruik deze sectie om looptijd, rentevast periode, NHG of renteklassen aan te passen.", properties: { looptijd_jaren: { type: "number", description: "Looptijd van de hypotheek in JAREN. Standaard: 30 jaar. Voorbeelden: 20, 25, 30", default: 30, }, rentevast_periode_jaren: { type: "number", description: "Rentevaste periode in JAREN. Standaard: 10 jaar. Voorbeelden: 5, 10, 15, 20", default: 10, }, nhg: { type: "boolean", description: "Nationale Hypotheek Garantie aanvragen? Standaard: false", default: false, }, renteklassen: { type: "array", description: "OPTIONEEL - Custom renteklassen met specifieke LTV-grenzen en rentepercentages. Alleen invullen als je specifieke renteklassen wilt definiëren.", items: { type: "object", properties: { naam: { type: "string", description: "Naam van de renteklasse (bijv. 'NHG 0-200', 'Niet-NHG 75-90')", }, lowerbound_ltv_pct: { type: "number", description: "Ondergrens LTV in procenten (bijv. 0.0, 75.0)", }, higherbound_ltv_pct: { type: "number", description: "Bovengrens LTV in procenten (bijv. 75.0, 200.0)", }, nhg: { type: "boolean", description: "Is dit een NHG renteklasse?", }, rente_jaarlijks_pct: { type: "number", description: "Rentepercentage als getal (bijv. 3.2 voor 3.2%, 4.0 voor 4.0%)", }, }, required: ["naam", "lowerbound_ltv_pct", "higherbound_ltv_pct", "nhg", "rente_jaarlijks_pct"], }, }, }, }, session_id: { type: "string", description: "OPTIONEEL - Sessie ID voor het traceren van de conversatie. Haal deze waarde uit de n8n chat trigger: 'When chat message received' -> sessionId variabele.", }, }, required: [ "aanvrager", "nieuwe_woning", ], }, },
• src/index.ts:465-522 (helper)

  Helper function used in the handler to construct the 'nieuwe_lening' payload from optional maatwerk parameters like looptijd_jaren, rentevast_periode_jaren, nhg, and renteklassen.
  function buildNieuweLeningPayload(raw: any): any | undefined { if (!raw || typeof raw !== 'object') { return undefined; } const payload: Record<string, unknown> = {}; const looptijdMaanden = raw.looptijd_maanden ?? (typeof raw.looptijd_jaren === 'number' ? raw.looptijd_jaren * 12 : undefined); if (looptijdMaanden) { payload.looptijd_maanden = looptijdMaanden; } const rentevastMaanden = raw.rentevaste_periode_maanden ?? (typeof raw.rentevast_periode_jaren === 'number' ? raw.rentevast_periode_jaren * 12 : undefined); if (rentevastMaanden) { payload.rentevaste_periode_maanden = rentevastMaanden; } if (raw.rente !== undefined) { payload.rente = raw.rente; } if (raw.hypotheekvorm) { payload.hypotheekvorm = raw.hypotheekvorm; } else if (raw.type) { payload.hypotheekvorm = raw.type; } if (raw.energielabel) { payload.energielabel = normalizeEnergielabel(raw.energielabel); } if (raw.nhg !== undefined) { payload.nhg = raw.nhg; } if (raw.ltv !== undefined) { let ltvValue: number | undefined; if (typeof raw.ltv === 'string') { const parsed = parseFloat(raw.ltv.replace('%', '')); ltvValue = Number.isFinite(parsed) ? parsed / 100 : undefined; } else if (typeof raw.ltv === 'number') { ltvValue = raw.ltv; } if (ltvValue !== undefined) { payload.ltv = ltvValue; } } if (Array.isArray(raw.renteklassen) && raw.renteklassen.length > 0) { payload.renteklassen = raw.renteklassen; } return Object.keys(payload).length > 0 ? payload : undefined; }
• src/index.ts:137-143 (schema)

  TypeScript interface defining the expected arguments structure for the tool handler.
  interface OpzetUitgebreidArguments extends OpzetBaseArguments { nieuwe_woning: NieuweWoning; is_doorstromer?: boolean; waarde_huidige_woning?: number; bestaande_hypotheek?: BestaandeHypotheek; nieuwe_lening?: OpzetNieuweLening; }