@apiosk/mcp 1.7.0 → 2.0.0

package/src/gateway-v2-card-budget.mjs

@@ -0,0 +1,21 @@
+// A budget refusal is not an expired login. Open the existing settings without
+// revoking tokens, pretending to reconnect, or approving/replaying the task.
+export const V2_CARD_BUDGET = `
+function renderApprovalRecovery(response,data){
+ const codes=[response?.error_code,...(response?.errors||[]).map(error=>error.code)];
+ if(!codes.some(code=>['approval_per_request_limit','approval_daily_limit'].includes(code)))return;
+ const actions=byId('feedback-actions');
+ let url=null;try{url=trustedShortcut(new URL('/connections',dataApprovalOrigin()).href,'/connections')}catch{}
+ const button=el('button','primary','Set higher limits');button.type='button';
+ const help=el('p','meta','Choose your connection, change its per-request and daily limits, and save. Then return here and check status before approving.');
+ button.onclick=async()=>{
+  if(output!==data){showFeedback('This request was updated. Check status before continuing.','error');return}
+  if(!url||!await window.apiosk.openLink(url).catch(()=>false)){
+   help.textContent='Open Apiosk > Integrations, choose your connection, set higher spending limits and save. Then return here and check status before approving.';
+   window.apiosk.resize();
+  }
+ };
+ actions.append(button,help,el('p','meta','Or reconnect Apiosk in your chatbot and choose higher limits on the connection screen. After reconnecting, ask the question again using the new connection.'));
+ window.apiosk.resize();
+}
+`;

package/src/gateway-v2-card-cbs.mjs

@@ -0,0 +1,56 @@
+// Display only: join the returned CBS codebooks, never substitute missing values.
+export function cbsAnnualView(data, results) {
+  const question = data.context_view?.conversation?.[0]?.question || '';
+  const years = [...new Set(question.match(/\b(?:19|20)\d{2}\b/g) || [])].sort();
+  if (!years.length || years.length > 2) return null;
+  const base = '/odata/v1/CBS/85809NED/';
+  const observations = results.find(r => r.source?.provider === 'cbs-statline' && r.source.path === base + 'Observations');
+  const entity = observations?.subject?.entity_ref;
+  if (!entity) return null;
+  const names = ['Observations', 'MeasureCodes', 'PeriodenCodes', 'BedrijfstakkenBranchesSBI2008Codes', 'BedrijfsgrootteCodes', 'Properties'];
+  const records = names.map(name => results.find(r => r.source?.provider === 'cbs-statline' && r.source.path === base + name && r.subject?.entity_ref === entity));
+  if (records.some(r => !r?.data || r.coverage === 'partial')) return null;
+  const [values, measures, periods, sectors, sizes, properties] = records.map(r => r.data);
+  if (![values, measures, periods, sectors, sizes].every(d => Array.isArray(d.value))) return null;
+  const selected = values.value.filter(r => years.some(year => r.Perioden === year + 'JJ00'));
+  if (!selected.length || years.some(year => !selected.some(r => r.Perioden === year + 'JJ00'))) return null;
+  const rows = [];
+  for (const row of selected) {
+    const measure = measures.value.find(v => v.Identifier === row.Measure);
+    const period = periods.value.find(v => v.Identifier === row.Perioden);
+    const sector = sectors.value.find(v => v.Identifier === row.BedrijfstakkenBranchesSBI2008);
+    const size = sizes.value.find(v => v.Identifier === row.Bedrijfsgrootte);
+    if (!measure?.Title || !measure.Unit || !period?.Title || !sector?.Title || !size?.Title) return null;
+    rows.push({period:period.Title.trim(), measure:measure.Title, unit:measure.Unit,
+      code:row.Measure, value:typeof row.Value === 'number' && Number.isFinite(row.Value) ? row.Value : 'Niet beschikbaar',
+      status:period.Status || 'Niet vermeld', sector:sector.Title, size:size.Title});
+  }
+  rows.sort((a,b) => a.period.localeCompare(b.period) || a.measure.localeCompare(b.measure));
+  const scopes = [...new Set(rows.map(r => r.sector + ' · ' + r.size))];
+  if (scopes.length !== 1) return null;
+  const url = properties.Distributions?.find(d => /^https:\/\/(?:dataportal|opendata)\.cbs\.nl\//.test(d.AccessUrl || ''))?.AccessUrl;
+  return {records, rows, subject:observations.subject.label, scope:scopes[0], title:properties.Title || observations.subject.label,
+    modified:properties.Modified || properties.ModificationDate, retrieved:observations.source.retrieved_at, url};
+}
+
+export const V2_CARD_CBS = `
+${cbsAnnualView.toString()}
+function renderCbsAnnual(view){
+ const s=section(view.subject||view.title);s.classList.add('answer-section');
+ const number=value=>typeof value==='number'?new Intl.NumberFormat('nl-NL',{maximumFractionDigits:6}).format(value):value;
+ const growth=view.rows.filter(r=>r.code==='M004926'&&r.unit==='%'),latest=growth.at(-1);
+ if(latest){s.append(el('p','answer-number',(typeof latest.value==='number'&&latest.value>0?'+':'')+number(latest.value)+(typeof latest.value==='number'?'%':'')));s.append(el('p','answer-caption','Omzet in '+latest.period+' ten opzichte van '+(Number(latest.period)-1)));const previous=growth.at(-2);if(previous)s.append(el('p','meta','In '+previous.period+': '+number(previous.value)+(typeof previous.value==='number'?'%':'')+' ten opzichte van '+(Number(previous.period)-1)))}
+ const states=[...new Set(view.rows.map(r=>r.status))];s.append(el('p','answer-source','CBS StatLine'+(states.length===1?' · '+states[0]:'')));
+ const links=el('div','result-links');if(view.url){const link=el('button','text-action','Bron bekijken');link.onclick=()=>window.apiosk.openLink(view.url);links.append(link)}s.append(links);
+ const full=el('details','compact-details result-details');full.append(el('summary','','Details'));full.ontoggle=()=>window.apiosk.resize();
+ full.append(el('p','meta',view.scope));
+ const wrap=el('div','cbs-table-wrap'),table=el('table','cbs-table'),head=el('tr');for(const label of ['Jaar','Maatstaf','Waarde','Eenheid','Status'])head.append(el('th','',label));const thead=el('thead');thead.append(head);table.append(thead);const body=el('tbody');
+ for(const row of view.rows){const tr=el('tr');for(const value of [row.period,row.measure,number(row.value),row.unit,row.status])tr.append(el('td','',value));body.append(tr)}table.append(body);wrap.append(table);full.append(wrap);
+ if(view.modified)full.append(el('p','meta','CBS bijgewerkt: '+new Date(view.modified).toLocaleDateString('nl-NL')));
+ if(view.retrieved)full.append(el('p','meta','Opgehaald: '+new Date(view.retrieved).toLocaleString('nl-NL')));
+ const raw=el('details','full-result');raw.append(el('summary','','Brongegevens'),el('pre','',JSON.stringify(view.records,null,2)));full.append(raw);s.append(full);
+ if(!latest)full.open=true;
+ return {section:s,details:full,links};
+}
+`;
+

package/src/gateway-v2-card-choices.mjs

@@ -0,0 +1,4 @@
+// Company selection changes only the visible name; entity references stay exact.
+export const V2_CARD_CHOICES = `
+function renderChoices(data){const select=(data.next_actions||[]).find(a=>a.kind==='select_entity'),candidates=data.context_view?.candidates;if(!select||!Array.isArray(candidates)||!candidates.length)return;const s=section('Which company do you mean?');s.classList.add('choice-section');s.setAttribute('role','region');s.setAttribute('aria-label','Choose the right company');s.append(el('p','meta','Choose once to continue within your approved amount.'));const list=el('div','choice-list');for(const c of candidates){const copy=el('span'),name=(c.facts||[]).find(f=>f.type==='company.name');copy.append(el('strong','',formatDisplayText(text(name?.value||c.label))));const identifiers=(c.facts||[]).filter(f=>/kvk|city|country|lei/i.test(f.type)).map(f=>(/kvk/i.test(f.type)?'KVK ':'')+text(f.value));copy.append(el('span','meta',identifiers.join(' · ')));const b=el('button');b.append(copy,el('span','','Select'));b.onclick=()=>callAction(select,{entity_ref:c.entity_ref});list.append(b)}s.append(list)}
+`;

package/src/gateway-v2-card-clarification.mjs

@@ -0,0 +1,25 @@
+export const V2_CARD_CLARIFICATION = `
+function renderInput(data){
+ const action=(data.next_actions||[]).find(a=>a.kind==='supply_input');
+ if(!action){renderClarification(data);return}
+ const schema=action.input_schema?.properties?.value||{},raw=text(action.label).replace(/^Provide\\s+/i,'').trim();
+ const names={'web.query':'Search query','web.source_search_query':'Search query','domain.name':'Website domain','company_registry.kvknummer':'KVK number','company.registration.lei':'LEI code','company.name':'Company name'};
+ const title=schema.title||names[raw]||(raw?pretty(raw):'');
+ if(!title){section('Request details unavailable').append(el('p','notice','The request did not identify the missing detail. Use Check status to reload the saved request.'));return}
+ const s=section(title),form=el('form','field actions'),field=el('input'),b=el('button','quiet','Continue');
+ const message=data.context_view?.clarification?.message||schema.description||(names[raw]==='Search query'?'What should the web search look for?':'Enter the '+title.toLowerCase()+' to continue.');
+ s.append(el('p','meta',message));field.id='requested-input';field.required=true;field.autocomplete='off';field.setAttribute('aria-label',title);
+ field.placeholder=Array.isArray(schema.examples)&&schema.examples.length?'For example: '+text(schema.examples[0]):title;
+ form.append(field,b);form.onsubmit=e=>{e.preventDefault();if(output!==data||busy||!field.value.trim())return;let value=field.value.trim();const type=schema.type;if(type==='integer'||type==='number')value=Number(value);else if(type==='boolean')value=value==='true';return callAction(action,{value})};s.append(form);
+}
+function renderClarification(data){
+ if(data.status!=='needs_input')return;
+ const turn=data.context_view?.conversation?.at(-1),message=data.context_view?.clarification?.message||turn?.reply;
+ const s=section('One detail is needed');s.append(el('p','notice',message||'Add the missing detail in your chat, or check the saved request status.'));
+ if(!message||!turn?.question||!data.state)return;
+ const form=el('form','field actions'),field=el('input'),b=el('button','quiet','Send answer');
+ field.required=true;field.autocomplete='off';field.placeholder='Your answer';field.setAttribute('aria-label','Your answer to the clarification');form.append(field,b);
+ form.onsubmit=async e=>{e.preventDefault();const answer=field.value.trim();if(!answer||busy||output!==data)return;busy=true;b.disabled=true;showFeedback('Updating your request…');try{const next=await window.apiosk.callTool('apiosk_discover',{question:turn.question+'\\n\\nUser clarification: '+answer,state:data.state});acceptResponse(next)}catch(error){showFeedback(error?.message||'Could not send your answer. Check status and try again.','error')}finally{busy=false;b.disabled=false}};
+ s.append(form);
+}
+`;

package/src/gateway-v2-card-compact.mjs

@@ -0,0 +1,34 @@
+// The execution graph stays private; only consent, choices and results are visible.
+export const V2_CARD_COMPACT = `
+renderPlan=function(data){
+ const p=data.proposal;if(!p||['cancelled','succeeded','partial','failed','unsupported','needs_selection'].includes(data.status))return;
+ const details=p.step_details||[],subjects=[...new Set(details.map(d=>d.subject).filter(Boolean))];
+ const sources=[...new Map(details.filter(d=>d.source).map(d=>[d.source.directory_slug||d.source.slug||d.source.name,{...d.source,name:d.source.directory_name||d.source.name}])).values()];
+ const s=section(formatDisplayNarrative(subjects.join(' · ')||p.label||'Data request',data));s.classList.add('request-section');planSurface=s;
+ if(data.billing?.authorization_active||data.status==='running'){
+  s.append(el('p','compact-status','Getting your data…'));
+  s.append(el('p','meta','Approved up to '+money(p.max_total_atomic,p.currency,true)));return;
+ }
+ if(sources.length)s.append(el('p','meta',sources.length+(sources.length===1?' source':' sources')));
+ const price=el('div','request-price');price.append(el('span','price-label','Maximum total'),el('strong','',money(p.max_total_atomic,p.currency,true)));s.append(price);
+ s.append(el('p','meta','Approve once. The entire request stays within this amount.'));
+ const disclosure=el('details','compact-details'),list=el('div','compact-sources');disclosure.append(el('summary','','Details'));
+ for(const source of sources)list.append(sourceLine(source));disclosure.append(list);s.append(disclosure);
+};
+const renderExpandedCard=render;
+render=function(data){
+ renderExpandedCard(data);if(!data||typeof data!=='object')return;
+ for(const section of sections.querySelectorAll(':scope > .section')){
+  const heading=section.querySelector('h3');
+  if(heading?.textContent==='Payment summary'){
+   const dutch=!!cbsAnnualView(data,data.context_view?.results||[]),charged=money(data.billing?.total_charged,data.billing?.currency),disclosure=el('details','compact-details');
+   disclosure.append(el('summary','',charged==null?(dutch?'Betalingsdetails':'Payment details'):(dutch?'Betaald ':'Charged ')+charged+(data.billing?.reserved&&data.billing.reserved!=='0'?' · Reserved '+money(data.billing.reserved,data.billing.currency):'')+(dutch?' · Betalingsdetails':' · Payment details')));
+   const grid=section.querySelector('.balances');if(grid)disclosure.append(grid);section.replaceChildren(disclosure);
+  }
+ }
+ for(const detail of data.proposal?.step_details||[]){if(detail.error?.message&&!(data.errors||[]).some(e=>e.message===detail.error.message))section('Needs attention').append(el('p','notice error',detail.error.message))}
+ if(planSurface){const disclosure=planSurface.querySelector('.compact-details');if(disclosure)planSurface.append(disclosure)}
+ if(typeof observeTask==='function')observeTask(data);
+ window.apiosk.resize();
+};
+`;

package/src/gateway-v2-card-events.mjs

@@ -0,0 +1,41 @@
+// Task-scoped SSE and recovery only read saved state; never authorize spending.
+export const V2_CARD_EVENTS = `
+let taskEvents=null,eventTask=null,eventUrl=null,eventRecovery=null,eventFailures=0;
+function observeTask(data){
+ const ref=data.state?.state_ref,url=data.context_view?.events_url;
+ const idle=!data.context_view?.worker_active&&['needs_input','cancelled','succeeded','partial','failed','unsupported'].includes(data.status);
+ if(eventTask!==ref){eventFailures=0;if(eventRecovery){clearTimeout(eventRecovery);eventRecovery=null}}
+ if(eventTask===ref&&eventUrl===url&&taskEvents&&!idle)return;
+ if(taskEvents){taskEvents.close();taskEvents=null}
+ if(idle){if(eventRecovery){clearTimeout(eventRecovery);eventRecovery=null}return}
+ if(!ref||!url||typeof EventSource==='undefined'||eventRecovery||eventFailures>=3)return;
+ let parsed;try{parsed=new URL(url)}catch{return}
+ if(parsed.origin!=='__APIOSK_GATEWAY_ORIGIN__'||parsed.pathname!=='/v2/tasks/'+ref+'/events')return;
+ eventTask=ref;eventUrl=url;
+ const recover=()=>{
+  if(output?.state?.state_ref!==ref||taskEvents!==stream)return;
+  stream.close();taskEvents=null;eventFailures++;
+  showFeedback('Live updates are unavailable. Checking the saved request…');
+  eventRecovery=setTimeout(async()=>{
+   eventRecovery=null;if(output?.state?.state_ref!==ref)return;
+   const refreshed=await refreshTask(false);
+   if(output?.state?.state_ref!==ref)return;
+   if(!refreshed||eventFailures>=3)showFeedback('Use Check status to refresh the saved request.');
+   if(refreshed)observeTask(output);
+  },2000*eventFailures);
+ };
+ let stream;try{stream=new EventSource(url);taskEvents=stream}catch{showFeedback('Use Check status to refresh the saved request.');return}
+ stream.addEventListener('task',event=>{
+  if(taskEvents!==stream||output?.state?.state_ref!==ref)return;
+  try{
+   const next=JSON.parse(event.data);
+   if(next.state?.state_ref!==ref||Number(next.state.revision)<Number(output.state.revision))return;
+   if(next.context_view?.events_path)next.context_view.events_url=new URL(next.context_view.events_path,parsed.origin).href;
+   const documents=[next.context_view,next.result,...(next.context_view?.results||[]),...(next.context_view?.conversation||[]).flatMap(t=>[t.output,t.output?.result,...(t.output?.results||[])])];
+   for(const doc of documents){const path=doc?.report?.download_path;if(typeof path==='string'&&path.startsWith('/v2/tasks/'+ref+'/'))doc.report.url=new URL(path,parsed.origin).href;const evidence=doc?.report?.evidence_download_path;if(typeof evidence==='string'&&evidence.startsWith('/v2/tasks/'+ref+'/reports/')&&evidence.includes('/evidence.zip?'))doc.report.evidence_url=new URL(evidence,parsed.origin).href}
+   acceptResponse(next);
+  }catch{recover()}
+ });
+ stream.onerror=recover;
+}
+`;

package/src/gateway-v2-card-presentation.mjs

@@ -0,0 +1,125 @@
+import { sourceCurrency } from './source-value-format.mjs';
+import { answerValue, answerValueContext } from './gateway-v2-card-answer-text.mjs';
+// The App's answer tables for version-1 analyses: `analysis.presentation`
+// (table, comparison, chart) and, without one, only the records and fields the
+// saved answer cites. Never a dump of a provider's raw rows
+// (app/src/lib/domain/answer-presentation.ts). Keep in sync with the App.
+export function presentationTable(p, results = [], locale = 'en-US') {
+  const columns = Array.isArray(p.columns) ? p.columns : [], rows = Array.isArray(p.rows) ? p.rows : [];
+  const currencyColumn = columns.findIndex(c => /^(currency|valuta)$/i.test(String(c?.value)));
+  return {
+    title: p.title, columns: columns.map(c => String(c?.value)), rows: rows.map(r => (r || []).map(c => c?.value)), locale,
+    displayRows: rows.map(row => (row || []).map((cell, i) => {
+      if (!cell || !/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(String(cell.value))) return cell?.value;
+      const context = cell.result_ref && cell.pointer ? answerValueContext({ result_ref: cell.result_ref, pointer: cell.pointer }, results) : null;
+      return answerValue(cell.value, context?.field || String(columns[i]?.value), context?.currency ?? sourceCurrency(row[currencyColumn]?.value), locale);
+    })),
+    note: p.returned_count !== undefined ? rows.length + ' selected from ' + p.returned_count + ' returned records. This is not necessarily the complete search.' : 'Based on saved source data. Missing values are unknown.',
+  };
+}
+function presentationEvidence(row, field, value) {
+  if (!row.has(field)) { row.set(field, value);return; }
+  const previous = row.get(field);
+  if (previous !== value) row.set(field, [...new Set([...(Array.isArray(previous) ? previous : [previous]), value])]);
+}
+export function legacyAnswerTables(question, results, analysis) {
+  if (analysis?.presentation || !analysis?.observations?.length || !/\b(overzicht|tabel|table|overview|list|lijst|welke|which|vergelijk|compare|comparison)\b/i.test(question || '')) return [];
+  const record = v => v && typeof v === 'object' && !Array.isArray(v) ? v : {}, groups = new Map();
+  for (const evidence of analysis.observations.flatMap(o => o?.evidence || [])) {
+    const doc = (results || []).map(record).find(d => d.result_ref === evidence?.result_ref), pointer = String(evidence?.pointer || '');
+    if (!doc || !pointer.startsWith('/data/')) continue;
+    const parts = pointer.split('/').slice(1).map(p => p.replaceAll('~1', '/').replaceAll('~0', '~'));
+    let node = { ...doc, data: doc.data ?? doc.preview_data }, groupPath = '', rowPath = '', field = parts.slice(1).join(' / '), rowRecord = {};
+    for (let i = 0; i < parts.length; i++) {
+      if (Array.isArray(node) && /^(0|[1-9]\d*)$/.test(parts[i])) { groupPath = JSON.stringify(parts.slice(0, i));rowPath = JSON.stringify(parts.slice(0, i + 1));field = parts.slice(i + 1).join(' / ');rowRecord = record(node[Number(parts[i])]);break; }
+      node = record(node)[parts[i]];
+    }
+    const key = JSON.stringify([evidence.result_ref, groupPath]);
+    let group = groups.get(key);
+    if (!group) { const source = record(doc.source), subject = record(doc.subject);group = { name: String(subject.label ?? source.name ?? source.provider ?? 'Answer'), columns: [], rows: new Map() };groups.set(key, group); }
+    if (!rowPath) {
+      group.columns = ['Field', 'Source value'];
+      const row = group.rows.get(pointer) ?? new Map([['Field', field]]);
+      presentationEvidence(row, 'Source value', evidence.value);group.rows.set(pointer, row);continue;
+    }
+    let row = group.rows.get(rowPath);
+    if (!row) { row = new Map();group.rows.set(rowPath, row); }
+    if (!group.columns.includes(field)) group.columns.push(field);
+    presentationEvidence(row, field, evidence.value);
+    const link = rowRecord.url ?? record(rowRecord.link).href ?? record(record(rowRecord._links).self).href;
+    if (typeof link === 'string' && /^https?:\/\//i.test(link)) { if (!group.columns.includes('Source')) group.columns.push('Source');row.set('Source', link); }
+  }
+  const humanize = label => label.replace(/([a-z])([A-Z])/g, '$1 $2').replaceAll('_', ' ');
+  const tables = [...groups.values()].map(g => ({ title: g.name, columns: g.columns.map(humanize), rows: [...g.rows.values()].map(r => g.columns.map(c => r.get(c))), note: 'Only records and fields cited in this saved answer. Full source data is available in Details.' }));
+  if (/\b(vergelijk|compare|comparison)\b/i.test(question) && tables.length > 1 && tables.every(t => t.columns[0] === 'Field') && new Set(tables.map(t => t.title)).size === tables.length) {
+    const fields = [...new Set(tables.flatMap(t => t.rows.map(r => String(r[0]))))];
+    return [{ title: 'Comparison', columns: ['Feature', ...tables.map(t => t.title)], rows: fields.map(f => [humanize(f), ...tables.map(t => t.rows.find(r => r[0] === f)?.[1])]), note: 'Only facts cited in the saved answer. Missing values are unknown; retain differences in units and reporting periods.' }];
+  }
+  return tables;
+}
+
+// ---- DOM, run inside the card only --------------------------------------------
+function renderAnswerPresentation(question, results, analysis) {
+  const p = analysis?.presentation, tables = p && typeof p === 'object' && 'title' in p ? [presentationTable(p, results, answerLocale(question, analysis))] : legacyAnswerTables(question, results, analysis);
+  if (!tables.length) return null;
+  const wrap = el('div', 'answer-blocks');wrap.setAttribute('aria-label', 'Answer data');
+  for (const table of tables) wrap.append(selectedTable(table, p?.kind === 'chart'));
+  return wrap;
+}
+function selectedTable(table, chart) {
+  const wrap = el('div', 'answer-table');let shown = 10;
+  const draw = () => {
+    const visible = { ...table, rows: table.rows.slice(0, shown) }, parts = [], figure = chart ? presentationChart(visible, table) : null;
+    if (figure) parts.push(figure);
+    parts.push(sourceTable(visible));
+    if (shown < table.rows.length) parts.push(blockMore('Show more selected rows (' + (table.rows.length - shown) + ' remaining)', () => { shown += 10;draw(); }));
+    if (shown > 10) parts.push(blockMore('Show fewer rows', () => { shown = 10;draw(); }));
+    wrap.replaceChildren(...parts);
+  };
+  draw();
+  return wrap;
+}
+function presentationChart(table, scale) {
+  const points = t => t.rows.filter(r => typeof r[0] === 'string' && typeof r[1] === 'number' && Number.isFinite(r[1]));
+  const shown = points(table);
+  if (!shown.length || shown.length !== table.rows.length) return null;
+  const all = points(scale).map(r => r[1]), min = Math.min(0, ...all), max = Math.max(0, ...all), range = max - min || 1, zero = (0 - min) / range * 100;
+  const figure = el('figure', 'answer-block bar-chart');figure.setAttribute('aria-label', table.title + ' chart');
+  figure.append(el('figcaption', '', table.title + ' · ' + table.columns[1]));
+  shown.forEach(([label, value], i) => {
+    const row = el('div', 'bar-row'), line = el('div', 'bar-line');
+    line.append(el('span', 'bar-label', label), el('span', 'fact-value', String(table.displayRows?.[i]?.[1] ?? new Intl.NumberFormat(table.locale ?? 'nl-NL', { maximumFractionDigits: 10 }).format(value))));
+    row.append(line, answerBar(zero, (value - min) / range * 100));figure.append(row);
+  });
+  return figure;
+}
+function presentationCell(value, key, locale = 'nl-NL') {
+  if (value == null || value === '') return el('span', '', '—');
+  if (Array.isArray(value)) { const list = el('ul', 'cell-list');for (const item of value) { const li = el('li');li.append(presentationCell(item, key, locale));list.append(li); }return list; }
+  if (typeof value === 'number' || typeof value === 'string' && /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(value)) return el('span', '', answerValue(value, key, null, locale));
+  if (typeof value === 'boolean') return el('span', '', value ? 'Yes' : 'No');
+  if (typeof value !== 'string') return el('span', '', JSON.stringify(displayData(value, key)));
+  if (/^https?:\/\//i.test(value)) { try { const url = new URL(value);if (!url.username && !url.password) { const link = bodyLink(url.href, 'Open source ↗');link.title = url.href;link.setAttribute('aria-label', 'Open source: ' + url.hostname);return link; } } catch {} }
+  return el('span', '', formatDisplayText(value, key));
+}
+function sourceTable(table) {
+  const s = el('section', 'answer-block');s.setAttribute('aria-label', table.title);
+  s.append(el('h3', '', table.title), el('p', 'meta', table.rows.length + ' rows shown' + (table.total !== undefined ? ' · ' + new Intl.NumberFormat('nl-NL').format(table.total) + ' total matches' : '') + '. ' + table.note));
+  if (!table.rows.length) { s.append(el('p', '', 'No records returned.'));return s; }
+  const link = row => { for (const value of row.slice(1)) { if (typeof value !== 'string' || !/^https?:\/\//i.test(value)) continue;try { const url = new URL(value);if (!url.username && !url.password) return url.href; } catch {} }return null; };
+  const region = blockTable(table.title + ' table', table.columns, table.rows.map((row, i) => {
+    const tr = el('tr'), href = typeof row[0] === 'string' && !/^https?:\/\//i.test(row[0]) ? link(row) : null;
+    row.forEach((value, j) => {
+      const td = el('td'), shown = table.displayRows?.[i]?.[j] ?? value, cell = presentationCell(shown, j === 0 || table.columns[j] !== 'Source value' ? table.columns[j] : String(row[0]), table.locale);
+      td.append(j === 0 && href ? bodyLink(href, cell.textContent) : cell);tr.append(td);
+    });
+    return tr;
+  }));
+  if (table.columns.length > 3) region.querySelector('table')?.setAttribute('style', 'min-width:' + table.columns.length * 150 + 'px');
+  s.append(region);
+  return s;
+}
+
+export const V2_CARD_PRESENTATION = [
+  presentationTable, presentationEvidence, legacyAnswerTables, renderAnswerPresentation, selectedTable, presentationChart, presentationCell, sourceTable,
+].map(fn => fn.toString()).join('\n');

package/src/gateway-v2-card-research.mjs

@@ -0,0 +1,63 @@
+import { V2_CARD_CBS } from './gateway-v2-card-cbs.mjs';
+import { V2_CARD_VERDICT } from './gateway-v2-card-verdict.mjs';
+import { V2_CARD_ANSWER } from './gateway-v2-card-answer.mjs';
+import { V2_CARD_ANSWER_TEXT } from './gateway-v2-card-answer-text.mjs';
+import { V2_CARD_BLOCKS } from './gateway-v2-card-blocks.mjs';
+import { V2_CARD_PRESENTATION } from './gateway-v2-card-presentation.mjs';
+// All source values remain text nodes. This layer has no purchasing authority.
+export const V2_CARD_RESEARCH = `
+${V2_CARD_CBS}
+${V2_CARD_VERDICT}
+${V2_CARD_ANSWER_TEXT}
+${V2_CARD_BLOCKS}
+${V2_CARD_PRESENTATION}
+${V2_CARD_ANSWER}
+const renderSingleResult=renderResult;
+const sourceDisclosureState=new Map();
+function sourceGroupKey(result){const source=result?.source||{};return source.provider||source.name||source.url||'Source'}
+function sourceMetric(group,names){for(const result of group){const body=displayData(result?.data!=null?result.data:result);if(!body||typeof body!=='object'||Array.isArray(body))continue;for(const name of names){const value=body[name];if(value!=null&&['string','number','boolean'].includes(typeof value))return value}}return null}
+function sourceResultCount(group){const explicit=sourceMetric(group,['total_results','totalResults','total_count','totalCount','number_of_results','numberOfResults']);if(explicit!=null)return explicit;let count=0,found=false;for(const result of group){const body=displayData(result?.data!=null?result.data:result);for(const name of ['results','items','resultaten'])if(Array.isArray(body?.[name])){count+=body[name].length;found=true}if(body?.responses&&typeof body.responses==='object'){for(const response of Object.values(body.responses)){const total=response?.total?.value;if(typeof total==='number'){count+=total;found=true}else if(Array.isArray(response?.results)){count+=response.results.length;found=true}}}}return found?count:null}
+function sourceSummaryCell(label,value){const cell=el('span','source-result-cell');cell.append(el('span','source-result-label',label),el('span','source-result-value',value==null||value===''?'—':value));return cell}
+function renderSourceGroup(data,group){const source=group[0]?.source||{},details=el('details','source-result-group'),summary=el('summary','source-result-summary'),logo=sourceLogo(source);logo.classList.add('mini');summary.append(logo,el('span','source-result-name',source.name||source.provider||'Source'),sourceSummaryCell('Kind',sourceMetric(group,['kind'])),sourceSummaryCell('Results',sourceResultCount(group)),sourceSummaryCell('Items per page',sourceMetric(group,['items_per_page','itemsPerPage','page_size','pageSize'])),sourceSummaryCell('Page number',sourceMetric(group,['page_number','pageNumber','page'])),sourceSummaryCell('Start index',sourceMetric(group,['start_index','startIndex','offset'])));const body=el('div','source-result-details');for(const result of group){renderSingleResult({...data,result});const node=sections.lastElementChild;if(node)body.append(node)}details.append(summary,body);details.ontoggle=()=>window.apiosk.resize();return details}
+function reportButton(label,url){const b=el('button','text-action',label);b.onclick=()=>window.apiosk.openLink(url);return b}
+// The App's details drawer (GatewayV2OutputDetails): downloads, limitations and
+// cited evidence above the source records. The answer text already carries the
+// observations, so they are not repeated here.
+function detailNotes(analysis,data,cbs){
+ const notes=el('div','detail-notes'),limitations=(analysis.limitations||[]).filter(t=>typeof t==='string'&&t.trim()),evidence=(analysis.observations||[]).flatMap(o=>o?.evidence||[]);
+ if(limitations.length){const list=el('ul');for(const limitation of limitations)list.append(el('li','',formatDisplayNarrative(limitation,data)));notes.append(el('h4','',cbs?'Toelichting':'Source limitations'),list)}
+ if(evidence.length){const list=el('ul','evidence-list');for(const item of evidence){const li=el('li');li.append(el('span','',(item.source?.name??formatDisplayNarrative(item.subject?.label||'Source',data))+' · '+(item.field??item.pointer)+': '+formatSourceValue(item.value,item.field||item.pointer,null,data)),el('span','fact-source',item.pointer));list.append(li)}notes.append(el('h4','',cbs?'Onderbouwing':'Source evidence'),list)}
+ return notes.children.length?notes:null}
+renderResult=function(data){
+ const results=data.context_view?.results?.length?data.context_view.results:data.result==null?[]:[data.result],analysis=data.context_view?.analysis;
+ const verdict=supplierVerdictView(supplierVerdictAnalysis(data)),cbs=verdict?null:cbsAnnualView(data,results);const surface=verdict?renderSupplierVerdict(verdict):cbs?renderCbsAnnual(cbs):renderResearchAnswer(data,results);
+ // Without an analysis the source result is the answer, drawn as the App's
+ // purchase panel draws it: the primary result open, lookups under details.
+ let primary=null,primarySection=null;
+ if(!surface&&!analysis&&!data.context_view?.analyzing&&results.length){primary=data.result??results.at(-1);renderSingleResult({...data,result:primary});primarySection=sections.lastElementChild}
+ const rest=primary?results.filter(r=>r!==primary&&!(r?.result_ref&&r.result_ref===primary.result_ref)):results;
+ const report=data.context_view?.report,question=data.context_view?.conversation?.at(-1)?.question||'';
+ const pdf=report?.format==='pdf'&&typeof report.url==='string'&&report.url.startsWith('https://')?report.url:null,zip=typeof report?.evidence_url==='string'&&report.evidence_url.startsWith('https://')?report.evidence_url:null;
+ const notes=analysis&&!verdict?detailNotes(analysis,data,cbs):null;
+ if(rest.length||notes||pdf||zip){
+  const sourceCount=new Set(rest.map(result=>result.source?.provider||result.source?.name||'Source')).size;
+  const s=section('Sources and details');s.classList.add('source-results-section');
+  const disclosure=el('details','source-results-toggle');disclosure.append(el('summary','','Sources and details'+(rest.length?' · '+sourceCount+(sourceCount===1?' source':' sources')+' · '+rest.length+(rest.length===1?' result':' results'):'')));
+  const key=data.state?.state_ref;disclosure.open=key?sourceDisclosureState.get(key)===true:false;
+  disclosure.ontoggle=()=>{if(key){sourceDisclosureState.set(key,disclosure.open);if(sourceDisclosureState.size>20)sourceDisclosureState.delete(sourceDisclosureState.keys().next().value)}window.apiosk.resize()};
+  if(pdf||zip){const links=el('div','result-links');if(pdf)links.append(reportButton('Download PDF',pdf));if(zip)links.append(reportButton('Download evidence',zip));disclosure.append(links)}
+  if(notes)disclosure.append(notes);
+  const list=el('div','source-results-list'),groups=new Map();disclosure.append(list);s.append(disclosure);
+  for(const result of rest){if(cbs?.records.includes(result))continue;const key=sourceGroupKey(result);if(!groups.has(key))groups.set(key,[]);groups.get(key).push(result)}
+  for(const group of groups.values())list.append(renderSourceGroup(data,group));
+ }
+ if(surface?.title){byId('title').textContent=surface.title;byId('subtitle').textContent=surface.subtitle}
+ // A report is shown with the answer only when the question asked for a document.
+ if(pdf&&answerDocumentRequested(analysis,question)){const target=surface?.links||primarySection;if(target){const links=surface?.links||el('div','result-links');links.append(reportButton('Download PDF',pdf));if(!surface)target.append(links)}}
+ if(data.context_view?.analyzing)section('Analysis').append(el('p','notice','Analyzing the saved source results…'));
+ const cooldown=data.context_view?.cooldown;
+ if(cooldown){const kvk=/KVK/.test(cooldown.message||''),s=section(kvk?'Waiting for KVK':'Waiting for the source'),timer=el('p','notice');s.append(el('p','meta',cooldown.message),timer);const tick=()=>{const seconds=Math.max(0,Math.ceil((Date.parse(cooldown.until)-Date.now())/1000));timer.textContent=seconds?(kvk?'Next annual report in ':'Checking again in ')+Math.floor(seconds/60)+':'+String(seconds%60).padStart(2,'0'):'Continuing the approved request…'};tick();const interval=setInterval(()=>{if(!timer.isConnected){clearInterval(interval);return}tick()},1000);if(data.billing?.authorization_active&&data.billing.quote_ref===data.proposal?.quote_ref)watchUntil=Math.max(watchUntil,Date.parse(cooldown.until)+300000)}
+};
+const renderOriginalPlan=renderPlan;
+renderPlan=function(data){renderOriginalPlan(data);if(!planSurface)return;const notices=data.context_view?.coverage_notices;if(Array.isArray(notices)&&notices.length){const coverage=el('div','plan-coverage');coverage.append(el('p','key','Scope of this check'));for(const notice of notices.slice(0,8)){if(typeof notice==='string')coverage.append(el('p','notice',notice))}planSurface.append(coverage)}const rows=planSurface.querySelectorAll('.step');for(const [index,row] of rows.entries()){const detail=data.proposal?.step_details?.[index];const copy=row.lastElementChild;if(detail?.subject)copy.prepend(el('p','step-title',formatDisplayNarrative(detail.subject,data)));if(detail?.error?.message)copy.append(el('p','notice error',detail.error.message))}};
+`;

package/src/gateway-v2-card-result.mjs

@@ -0,0 +1,32 @@
+import { V2_SOURCE_VALUE_FORMAT } from './source-value-format.mjs';
+import { V2_CARD_BODY } from './gateway-v2-card-body.mjs';
+// One source result, as the App shows it: the readable answer body (purchase
+// panel), filing fields and KVK company rows (GatewayV2Result), then the full
+// source data collapsed. Source JSON stays unchanged; formatting is display-only.
+export const V2_CARD_RESULT = `
+${V2_SOURCE_VALUE_FORMAT}
+${V2_CARD_BODY}
+function filingRows(fields,depth=0,rows=[],currency=null){if(depth>12||!Array.isArray(fields))return rows;for(const field of fields.slice(0,200)){if(rows.length>=100)break;if(field&&typeof field.key==='string'&&['string','number','boolean'].includes(typeof field.value))rows.push([field.key.replace(/([a-z])([A-Z])/g,'$1 $2'),formatSourceValue(field.value,field.key,sourceCurrency(field)||currency)]);if(field?.opendataFields)filingRows(field.opendataFields,depth+1,rows,currency)}return rows}
+function resultBody(result){return result&&typeof result==='object'?result.data!==undefined?result.data:result.preview_data!==undefined?result.preview_data:result:result}
+function companyTable(companies,body){
+ const wrap=el('div','result-companies'),region=el('div','body-table-wrap'),table=el('table','body-table'),head=el('tr'),thead=el('thead'),tbody=el('tbody');
+ wrap.append(el('p','meta',companies.length+' results shown'+(typeof body.totaal==='number'?' of '+body.totaal:'')+(typeof body.pagina==='number'?' · Page '+body.pagina:'')));
+ for(const label of ['Company','KVK number','City'])head.append(el('th','',label));thead.append(head);
+ for(const row of companies){const tr=el('tr');for(const value of [row.naam,row.kvkNummer,row.adres?.binnenlandsAdres?.plaats??'—'])tr.append(el('td','',value));tbody.append(tr)}
+ table.append(thead,tbody);region.append(table);wrap.append(region);
+ if(body.volgende)wrap.append(el('p','meta','The source has more results. This response contains the current page.'));
+ return wrap}
+function renderResult(data){if(data.result==null)return;byId('title').textContent=data.status==='partial'?'Partial source result':'Source result';byId('subtitle').textContent='Returned by the selected source.';
+ const result=data.result,source=result&&result.source||{},subject=result?.subject?.label,s=section(typeof subject==='string'&&subject?'Result · '+formatDisplayNarrative(subject,result):'Result'),wrap=el('div','result'),body=displayData(resultBody(result)),currency=sourceCurrency(body);
+ const companies=Array.isArray(body?.resultaten)&&body.resultaten.every(r=>typeof r?.naam==='string'&&typeof r?.kvkNummer==='string')?body.resultaten:null,filing=Array.isArray(body?.opendataFields);
+ const report=result?.report,links=el('div','result-links');wrap.append(links);
+ if(report?.format==='pdf'&&typeof report.url==='string'&&report.url.startsWith('https://')){const download=el('button','text-action','Download PDF');download.onclick=()=>window.apiosk.openLink(report.url);links.append(download)}
+ if(companies)wrap.append(companyTable(companies,body));
+ else if(filing){wrap.append(el('p','meta','Selected fields from the deposited annual accounts. '+(currency?'Currency: '+currency+'.':'No currency is specified in this response.')));const dl=el('dl','body-fields');for(const [key,value] of filingRows(body.opendataFields,0,[],currency)){const row=el('div','result-row');row.append(el('dt','key',key),el('dd','value',value));dl.append(row)}wrap.append(dl)}
+ else wrap.append(answerBody(resultBody(result)));
+ const origin=el('div','result-source');origin.append(sourceLine(source));
+ if(typeof source.url==='string'&&source.url.startsWith('https://')){const link=el('button','text-action','View source');link.onclick=()=>window.apiosk.openLink(source.url);origin.append(link)}
+ if(source.retrieved_at)origin.append(el('span','meta','Retrieved '+new Date(source.retrieved_at).toLocaleString()));
+ const full=el('details','full-result');full.append(el('summary','','Full source data'),el('pre','',JSON.stringify(result,null,2)));full.ontoggle=()=>window.apiosk.resize();
+ wrap.append(origin,full);s.append(wrap)}
+`;

package/src/gateway-v2-card-search.mjs

@@ -0,0 +1,39 @@
+// Runs inside the card: the source search view (`view: "source_search"`), as
+// the App's Ask v2 source table draws it. Read-only: nothing here quotes,
+// approves or buys; a row only says what a source is, costs and needs.
+export const V2_CARD_SEARCH = `
+function searchPriceAtomic(candidate){
+ const exact=candidate?.endpoint?.price?.buyer_atomic;if(typeof exact==='string'&&/^\\d+$/.test(exact))return exact;
+ const match=String(candidate?.price??'').trim().match(/^(\\d+)(?:\\.(\\d{1,6}))?(?:\\s+USDC?)?$/i);
+ return match?String(BigInt(match[1])*1000000n+BigInt((match[2]||'').padEnd(6,'0'))):null}
+function searchInputLabel(input){
+ const names={'company.name':'Company name','company_registry.kvknummer':'KVK number','company.registration.lei':'LEI code','domain.name':'Website domain','web.query':'Search query'};
+ return input?.schema?.title||names[input?.field]||pretty(input?.field||'')}
+function searchRow(candidate){
+ const source=candidate.endpoint?.source||{},row=el('div','search-row'),copy=el('div','search-copy'),side=el('div','search-side');
+ const name=candidate.name||source.name||candidate.source_slug||'Source',supported=candidate.availability==='supported';
+ copy.append(el('p','search-name',name));
+ const about=candidate.description||candidate.endpoint?.description;if(about)copy.append(el('p','search-about',about));
+ const inputs=supported?(candidate.endpoint?.inputs||[]).filter(input=>input?.required):[];
+ if(inputs.length)copy.append(el('p','search-inputs','Needs '+inputs.map(searchInputLabel).filter(Boolean).join(', ')));
+ const atomic=searchPriceAtomic(candidate),price=atomic&&money(atomic,'USD');
+ side.append(el('span','search-price',price||'—'),el('span','search-state'+(supported?' supported':''),({supported:'Available',discovery_only:'Discovery only',unverified:'Unverified'})[candidate.availability]||pretty(candidate.availability||'Unverified')));
+ row.append(sourceLogo({name,logo_url:candidate.logo_url||source.logo_url}),copy,side);return row}
+function renderSourceSearch(data){
+ const matches=Array.isArray(data.matches)?data.matches:[],capabilities=data.parsed_request?.capabilities||[],seen=new Set();let total=0;
+ for(const match of matches)for(const candidate of [...(match.apiosk||[]),...(match.coinbase||[])]){const key=candidate.endpoint_id||candidate.url||(candidate.source_slug||candidate.name)+':'+(candidate.capability||'');if(!seen.has(key)){seen.add(key);total++}}
+ byId('title').textContent=total===1?'1 matching source':total+' matching sources';
+ byId('subtitle').textContent=Number.isInteger(data.apiosk_sources_searched)?'Searched '+data.apiosk_sources_searched+' Apiosk sources. Nothing is bought from this list.':'Nothing is bought from this list.';
+ if(!matches.length)section('Sources').append(el('p','meta','No requested capability was recognised. Rephrase the question or browse all sources.'));
+ for(const match of matches){
+  const capability=capabilities.find(c=>c?.slug===match.slug),candidates=[...(match.apiosk||[]),...(match.coinbase||[])];
+  const s=section(capability?.name||pretty(match.slug||'Requested data'),candidates.length===1?'1 source':candidates.length+' sources');s.classList.add('search-section');
+  if(capability?.description)s.append(el('p','meta search-capability',capability.description));
+  const list=el('div','search-list');list.setAttribute('role','list');
+  for(const candidate of candidates){const row=searchRow(candidate);row.setAttribute('role','listitem');list.append(row)}
+  if(candidates.length)s.append(list);else s.append(el('p','meta','No matching source was found for this part of the question.'));
+  if(match.coinbase_status==='unavailable')s.append(el('p','meta','Coinbase Bazaar search is unavailable right now.'));
+ }
+ if(data.notice)section('About these results').append(el('p','meta',data.notice));
+}
+`;

package/src/gateway-v2-card-sources.mjs

@@ -0,0 +1,32 @@
+// Runs inside the card: the source list, and what it is honest to print on it.
+export const V2_CARD_SOURCES = `
+/* Buyer-facing counts include only runtime-supported functions. Registered
+   endpoints belong in the integration audit, never in this overview. */
+function coverage(source){const r=source&&source.readiness,c=(r&&r.contracts)||{};
+ if(!r||!r.status)return{label:'Availability unknown',unavailable:false};
+ if(r.status==='blocked')return{label:'Not purchasable',unavailable:true};
+ const usable=c.supported_endpoints||0;
+ if(!usable)return{label:'Not executable',unavailable:true};
+ return{label:text(usable)+(usable===1?' available function':' available functions'),unavailable:false}}
+function renderSources(data){
+ const rows=Array.isArray(data.sources)?data.sources:[];
+ byId('title').textContent=data.total===1?'1 matching source':text(data.total||rows.length)+' matching sources';
+ byId('subtitle').textContent='Choose a source or narrow the search.';
+ const s=section('Sources',text(data.offset||0)+'–'+text((data.offset||0)+rows.length)+' of '+text(data.total||rows.length)),list=el('div','sources');
+ for(const source of rows){
+  const group=el('div'),row=el('div','source'),copy=el('div'),name=el('div','source-name',source.name||source.slug),meta=el('div','source-meta',[source.category,...(source.capabilities||[]).slice(0,2)].filter(Boolean).map(pretty).join(' · '));
+  copy.append(name,meta);const reach=coverage(source);
+  row.append(sourceLogo(source),copy,el('span','count'+(reach.unavailable?' unavailable':''),source.service_count?text(source.service_count)+' services':reach.label));
+  group.append(row);
+  if(Array.isArray(source.services)&&source.services.length){
+   const count=source.matching_service_count||source.services.length,detail=el('details','compact-details');detail.append(el('summary','','View '+text(count)+(count===1?' service':' services')));
+   for(const service of source.services){const item=el('div','source-service');item.append(el('strong','',service.name),el('p','meta',service.description));detail.append(item)}
+   detail.ontoggle=()=>window.apiosk.resize();group.append(detail);
+  }
+  list.append(group);
+ }
+ s.append(list);const actions=el('div','actions');
+ if(Number.isInteger(data.next_offset)){const b=el('button','quiet','Next page');b.onclick=async()=>{if(busy)return;busy=true;showFeedback('Loading the next sources…');try{const args={...input,offset:data.next_offset,limit:input.limit||20};render(await window.apiosk.callTool('apiosk_sources',args))}catch(e){showFeedback(e&&e.message||'Could not load the next page.','error')}finally{busy=false}};actions.append(b)}
+ if(actions.childNodes.length)s.append(actions)
+}
+`;