zerochat 7.3.0__py3-none-any.whl

zerochat_runtime/assets/js/tools/builtin/agent-checkpoint.tool.js

@@ -0,0 +1,212 @@
+/** Tool autocontenida: agent_checkpoint. */
+(function (root, factory) {
+  if (typeof exports === 'object' && typeof module !== 'undefined') module.exports = factory();
+  else root.ChatBuiltinAgentCheckpointTool = factory();
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const definition = {
+    name: 'agent_checkpoint',
+    description: 'Agentic checkpoint for consolidating findings and recording the next step: invoke it after querying sources, verifying whether information is sufficient, or validating the final answer.',
+    parameters: {
+      type: 'object',
+      properties: {
+        findings: {
+          type: 'string',
+          description: 'Structured, concise summary of the data, figures, or confirmed facts gathered so far (working memory).'
+        },
+        ready_to_respond: {
+          type: 'boolean',
+          description: 'Whether enough information is available to formulate the final answer to the user (true) or more queries are still needed (false).'
+        },
+        missing_info: {
+          type: 'string',
+          description: 'Specific data or contrasts that still need to be investigated (only when ready_to_respond is false).'
+        },
+        next_action: {
+          type: 'string',
+          description: 'Next hypothesis, tool, or specific query planned (only when ready_to_respond is false).'
+        }
+      },
+      required: ['findings', 'ready_to_respond']
+    }
+  };
+
+  const CHECKPOINT_ICON_SVG = '<svg class="ui-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 6H5a2 2 0 0 0-2 2v3a2 2 0 0 0 2 2h13l4-3.5L18 6Z"></path><line x1="12" y1="13" x2="12" y2="21"></line></svg>';
+
+  function createCardWrapper(ui) {
+    if (ui?.createCardWrapper) return ui.createCardWrapper();
+    const doc = ui?.document || (typeof document !== 'undefined' ? document : null);
+    if (!doc) return null;
+    const cardDiv = doc.createElement('div');
+    cardDiv.className = 'tool-card-wrapper';
+    return cardDiv;
+  }
+
+  const safeEscapeHtml = (value) => String(value || '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+
+  function createLiveCard(args, ui) {
+    const cardDiv = createCardWrapper(ui);
+    if (!cardDiv) return null;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || (typeof window !== 'undefined' && window.ChatUtils) || { escapeHtml: safeEscapeHtml };
+    const t = ui?.t || ((key) => key);
+    const spinner = ui?.SPINNER_SVG || '';
+    const chevron = ui?.CHEVRON_SVG || '';
+    const title = t('tool_agent_checkpoint_title') || 'Punto de control agéntico';
+    const statusText = t('tool_agent_checkpoint_loading') || 'Consolidando hallazgos...';
+
+    cardDiv.innerHTML = `<div class="tool-execution-card agent-checkpoint-card"><div class="tool-card-header"><div class="tool-card-title"><span>${CHECKPOINT_ICON_SVG}</span><span>${title}</span></div><div class="tool-card-header-actions"><span class="tool-card-badge status-loading">${spinner} <span>${statusText}</span></span><button type="button" class="btn-tool-collapse" title="${t('tool_btn_collapse') || 'Minimizar'}">${chevron}</button></div></div><div class="tool-card-collapsible-body"><div class="tool-card-result"><div class="checkpoint-findings"><strong>${t('tool_agent_checkpoint_findings') || 'Hallazgos clave:'}</strong><div class="checkpoint-findings-text">${Markdown.escapeHtml(args?.findings || '')}</div></div></div></div></div>`;
+    return cardDiv;
+  }
+
+  function updateLiveCard(cardDiv, args, result = {}, elapsedMs = 0, ui) {
+    if (!cardDiv) return;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || (typeof window !== 'undefined' && window.ChatUtils) || { escapeHtml: safeEscapeHtml };
+    const t = ui?.t || ((key) => key);
+    const checkSvg = ui?.CHECK_SVG || '';
+    const errorSvg = ui?.ERROR_SVG || '';
+    const isReady = result?.action === 'conclude' || args?.ready_to_respond === true || args?.ready_to_respond === 'true';
+    const success = result?.success !== false && !result?.error;
+
+    const badge = cardDiv.querySelector('.tool-card-badge');
+    if (badge) {
+      badge.className = `tool-card-badge ${success ? 'status-success' : 'status-error'}`;
+      const label = isReady
+        ? (t('tool_agent_checkpoint_ready') || 'Listo para responder')
+        : (t('tool_agent_checkpoint_continue') || 'Continuando análisis');
+      badge.innerHTML = success
+        ? `${checkSvg} <span>${label} (${elapsedMs || 0}ms)</span>`
+        : `${errorSvg} <span>${result?.error || 'Error'}</span>`;
+    }
+
+    const body = cardDiv.querySelector('.tool-card-result');
+    if (body) {
+      const findings = result?.findings || args?.findings || '';
+      const missing = result?.missing_info || args?.missing_info || '';
+      const nextAction = result?.next_action || args?.next_action || '';
+      const guidance = result?.guidance || '';
+
+      let contentHtml = `<div class="checkpoint-findings" style="margin-bottom: 6px;"><div class="checkpoint-label" style="font-weight: 600; opacity: 0.85; margin-bottom: 2px;">${t('tool_agent_checkpoint_findings') || 'Hallazgos clave:'}</div><div class="checkpoint-text" style="white-space: pre-wrap; font-size: 0.9em;">${Markdown.escapeHtml(findings)}</div></div>`;
+
+      if (missing) {
+        contentHtml += `<div class="checkpoint-missing" style="margin-bottom: 6px; font-size: 0.88em;"><span style="font-weight: 600; opacity: 0.85;">${t('tool_agent_checkpoint_missing') || 'Información faltante:'} </span><span>${Markdown.escapeHtml(missing)}</span></div>`;
+      }
+
+      if (nextAction) {
+        contentHtml += `<div class="checkpoint-next" style="margin-bottom: 6px; font-size: 0.88em;"><span style="font-weight: 600; opacity: 0.85;">${t('tool_agent_checkpoint_next') || 'Siguiente hipótesis / paso:'} </span><span>${Markdown.escapeHtml(nextAction)}</span></div>`;
+      }
+
+      if (guidance) {
+        contentHtml += `<div class="checkpoint-guidance" style="padding-top: 4px; border-top: 1px dashed var(--border-color, #444); font-size: 0.85em; opacity: 0.9;"><em>${Markdown.escapeHtml(guidance)}</em></div>`;
+      }
+
+      body.innerHTML = contentHtml;
+    }
+  }
+
+  function renderHistoricalCard(args, toolMessage, ui) {
+    const cardDiv = createLiveCard(args, ui);
+    if (!cardDiv) return null;
+    let result = {};
+    if (toolMessage?.content) {
+      try {
+        result = JSON.parse(toolMessage.content);
+      } catch (e) {
+        result = { findings: toolMessage.content };
+      }
+    }
+    updateLiveCard(cardDiv, args, result, 0, ui);
+    return cardDiv;
+  }
+
+  function createTool(Tool) {
+    if (typeof Tool !== 'function') throw new Error('La clase Tool es necesaria para crear agent_checkpoint.');
+    return new Tool({
+      id: definition.name,
+      definition,
+      aliases: ['checkpoint', 'agentcheckpoint', 'checkpoint_agent', 'punto_control'],
+      category: 'agent',
+      metadata: { icon: 'milestone', label: definition.name },
+      settings: {
+        titleKey: 'agent_checkpoint_title',
+        titleFallback: 'Punto de Control Agéntico',
+        descKey: 'agent_checkpoint_desc',
+        descFallback: 'Permite al modelo consolidar hallazgos, solicitar asistencia y registrar el siguiente paso para razonar sin pérdida de foco.',
+        icon: 'milestone',
+        defaultEnabled: false,
+        showInSettings: true
+      },
+      promptGuide: () => '- `agent_checkpoint(findings="...", ready_to_respond=true|false, missing_info="...", next_action="...")`: Consolidates multi-step findings, records the current plan, and verifies whether to conclude or continue searching.',
+      execute: async (args = {}, context = {}) => {
+        const isReady = args.ready_to_respond === true || args.ready_to_respond === 'true';
+        const findings = String(args.findings || args.summary || args.state || '').trim();
+        const missingInfo = String(args.missing_info || args.missing || '').trim();
+        const nextAction = String(args.next_action || args.hypothesis || args.next || '').trim();
+
+        if (isReady) {
+          return {
+            success: true,
+            status: 'acknowledged',
+            action: 'conclude',
+            findings,
+            guidance: 'Findings consolidated and verified. Proceed immediately to formulate your complete, structured, and detailed final answer to the user.'
+          };
+        }
+
+        return {
+          success: true,
+          status: 'acknowledged',
+          action: 'continue',
+          findings,
+          missing_info: missingInfo,
+          next_action: nextAction,
+          guidance: `Checkpoint recorded. Proceed with your planned next action: ${nextAction || 'perform the pending query.'}`
+        };
+      },
+      result: {
+        toModel: (_args, result) => typeof result === 'string' ? result : JSON.stringify(result || {}),
+        toMarkdown: (args, result) => {
+          const status = result?.action === 'conclude' ? 'Listo para responder' : 'Continuar análisis';
+          return `> **agent_checkpoint** [${status}]\n> *Hallazgos:* ${args.findings || ''}\n\n`;
+        }
+      },
+      displayMode: 'collapsed',
+      view: {
+        id: definition.name,
+        displayMode: 'collapsed',
+        createLiveCard,
+        updateLiveCard,
+        renderHistoricalCard
+      }
+    });
+  }
+
+  const toolModule = {
+    id: definition.name,
+    definition,
+    displayMode: 'collapsed',
+    createTool,
+    view: {
+      id: definition.name,
+      displayMode: 'collapsed',
+      createLiveCard,
+      updateLiveCard,
+      renderHistoricalCard
+    }
+  };
+
+  let manifestApi = null;
+  if (typeof window !== 'undefined' && window.ChatToolManifest) {
+    manifestApi = window.ChatToolManifest;
+  } else if (typeof require !== 'undefined') {
+    try {
+      manifestApi = require('../tool-manifest.js');
+    } catch (e) {}
+  }
+
+  if (manifestApi?.builtin && !manifestApi.builtin.has(toolModule.id)) {
+    manifestApi.builtin.register(toolModule);
+  }
+
+  return toolModule;
+});

zerochat_runtime/assets/js/tools/builtin/download-pdf.tool.js

@@ -0,0 +1,111 @@
+/** Tool autocontenida: download_pdf. */
+(function (root, factory) {
+  if (typeof exports === 'object' && typeof module !== 'undefined') module.exports = factory();
+  else root.ChatBuiltinDownloadPdfTool = factory();
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const definition = {
+    name: 'download_pdf',
+    description: 'Downloads a PDF file or document from a web URL and extracts all its readable text to analyze and include in the context (e.g. "https://arxiv.org/pdf/2310.06825.pdf").',
+    parameters: { type: 'object', properties: { url: { type: 'string', description: 'Direct URL of the PDF document to download and extract.' } }, required: ['url'] }
+  };
+
+  function getUrl(args) {
+    return args?.url || args?.URL || args?.uri || args?.link || args?.href || args?.path || args?.input || (typeof args === 'string' ? args : '');
+  }
+
+  function createCardWrapper(ui) {
+    if (ui?.createCardWrapper) return ui.createCardWrapper();
+    const doc = ui?.document || (typeof document !== 'undefined' ? document : null);
+    if (!doc) return null;
+    const cardDiv = doc.createElement('div');
+    cardDiv.className = 'tool-card-wrapper';
+    return cardDiv;
+  }
+
+  const PDF_ICON_SVG = '<svg class="ui-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline><line x1="16" y1="13" x2="8" y2="13"></line><line x1="16" y1="17" x2="8" y2="17"></line><polyline points="10 9 9 9 8 9"></polyline></svg>';
+
+  function getHtmlSafety() {
+    if (typeof window !== 'undefined' && window.ChatUtils) return window.ChatUtils;
+    if (typeof require !== 'undefined') { try { return require('../../utils.js'); } catch (_) {} }
+    return { escapeHtml: () => '', sanitizeUrl: () => '#' };
+  }
+
+  function createLiveCard(args, ui) {
+    const cardDiv = createCardWrapper(ui);
+    if (!cardDiv) return null;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || getHtmlSafety();
+    const t = ui?.t || ((key) => key);
+    const spinner = ui?.SPINNER_SVG || '';
+    const chevron = ui?.CHEVRON_SVG || '';
+    const url = getUrl(args);
+    cardDiv.innerHTML = `<div class="web-request-card pdf-request-card"><div class="web-card-header"><div class="web-card-title"><span>${PDF_ICON_SVG}</span><span>${t('tool_pdf_title')}</span></div><div class="tool-card-header-actions"><span class="web-card-badge status-loading">${spinner} <span>${t('tool_badge_downloading') || 'Descargando...'}</span></span><button type="button" class="btn-tool-collapse" title="${t('tool_btn_collapse') || 'Minimizar'}">${chevron}</button></div></div><div class="tool-card-collapsible-body"><div class="web-card-section web-request-section"><div class="section-label">${t('tool_web_requested_url')}</div><div class="url-badge"><a href="${Markdown.sanitizeUrl(url)}" target="_blank" rel="noopener noreferrer">${Markdown.escapeHtml(url)}</a></div></div><div class="web-card-section web-response-section"><div class="section-label section-response-label">${t('tool_web_receiving') || 'Recibiendo contenido...'}</div><div class="web-response-body tool-loading-placeholder">${spinner} <span>${t('tool_loading_pdf')}</span></div></div></div></div>`;
+    return cardDiv;
+  }
+
+  function updateLiveCard(cardDiv, _args, result = {}, elapsedMs = 0, ui) {
+    if (!cardDiv) return;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || getHtmlSafety();
+    const t = ui?.t || ((key) => key);
+    const checkSvg = ui?.CHECK_SVG || '';
+    const errorSvg = ui?.ERROR_SVG || '';
+    const success = result?.success !== false && !result?.error;
+    const content = result?.content || result?.error || '';
+    const badge = cardDiv.querySelector('.web-card-badge');
+    if (badge) {
+      badge.className = `web-card-badge ${success ? 'status-success' : 'status-error'}`;
+      badge.innerHTML = success
+        ? `${checkSvg} <span>PDF OK (${elapsedMs || 0}ms)</span>`
+        : `${errorSvg} <span>Error PDF (${elapsedMs || 0}ms)</span>`;
+    }
+    const label = cardDiv.querySelector('.section-response-label');
+    if (label) label.textContent = t('tool_web_content_received', { size: `${content.length} chars` }) || `Contenido recibido (${content.length} caracteres):`;
+    const body = cardDiv.querySelector('.web-response-body');
+    if (body) { body.className = 'web-response-body'; body.innerHTML = `<code>${Markdown.escapeHtml(content.slice(0, 1500))}${content.length > 1500 ? '...' : ''}</code>`; }
+  }
+
+  function renderHistoricalCard(args, toolMessage, ui) {
+    const cardDiv = createLiveCard(args, ui);
+    if (!cardDiv) return null;
+    let result = {};
+    if (toolMessage?.content) { try { result = JSON.parse(toolMessage.content); } catch (e) { result = { content: toolMessage.content }; } }
+    updateLiveCard(cardDiv, args, result, 0, ui);
+    return cardDiv;
+  }
+
+  function createTool(Tool) {
+    if (typeof Tool !== 'function') throw new Error('La clase Tool es necesaria para crear download_pdf.');
+    return new Tool({
+      id: definition.name,
+      definition,
+      aliases: ['downloadpdf', 'fetch_pdf', 'download_pdf_document', 'fetch_pdf_document', 'download_file', 'getpdf', 'readpdf'],
+      category: 'web',
+      metadata: { icon: 'file-text', label: definition.name },
+      settings: {
+        titleKey: 'agent_pdf_title', titleFallback: 'Descarga y Lectura de Documentos PDF',
+        descKey: 'agent_pdf_desc', descFallback: 'Permite al modelo descargar documentos PDF desde la web y extraer todo su texto al contexto en tiempo real.',
+        icon: 'file-text', defaultEnabled: true, showInSettings: true
+      },
+      promptGuide: () => '- `download_pdf(url="...")`: Downloads a PDF file from a URL and extracts its readable text into the prompt context.',
+      execute: async (args, context = {}) => {
+        const WebBrowser = context.services?.webBrowser;
+        if (!WebBrowser || !WebBrowser.downloadPdf) return { success: false, error: 'Módulo WebBrowser no disponible.' };
+        return WebBrowser.downloadPdf(getUrl(args), context.options || {});
+      },
+      result: {
+        toModel: (_args, result) => JSON.stringify(result || {}),
+        toMarkdown: (args) => `> **download_pdf**\n> URL: "${args.url || ''}"\n\n`
+      },
+      displayMode: 'collapsed',
+      view: { id: definition.name, displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard }
+    });
+  }
+
+  const toolModule = { id: definition.name, definition, displayMode: 'collapsed', createTool, getUrl, view: { id: definition.name, displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard } };
+  let manifestApi = null;
+  if (typeof window !== 'undefined' && window.ChatToolManifest) manifestApi = window.ChatToolManifest;
+  else if (typeof require !== 'undefined') { try { manifestApi = require('../tool-manifest.js'); } catch (e) {} }
+  if (manifestApi?.builtin && !manifestApi.builtin.has(toolModule.id)) manifestApi.builtin.register(toolModule);
+  return toolModule;
+});

zerochat_runtime/assets/js/tools/builtin/execute-javascript.tool.js

@@ -0,0 +1,219 @@
+/**
+ * Tool autocontenida: execute_javascript.
+ *
+ * La dependencia del ejecutor de JavaScript se recibe desde ToolExecutionContext.services;
+ * este módulo no depende de globals ni de resolutores del núcleo agéntico.
+ */
+(function (root, factory) {
+  if (typeof exports === 'object' && typeof module !== 'undefined') {
+    module.exports = factory();
+  } else {
+    root.ChatBuiltinExecuteJavascriptTool = factory();
+  }
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const definition = {
+    name: 'execute_javascript',
+    description: 'Executes JavaScript code in an isolated local worker to assist with calculations and data processing under technical user supervision. Always use return <value> or console.log() to emit the result.',
+    parameters: {
+      type: 'object',
+      properties: {
+        code: { type: 'string', description: 'Executable JS code. Always use return <value> or console.log() to emit output.' }
+      },
+      required: ['code']
+    }
+  };
+
+  function getCode(args) {
+    const raw = args?.code || args?.javascript || args?.js || args?.script || args?.input || (typeof args === 'string' ? args : '');
+    if (typeof raw !== 'string') return '';
+    let code = raw.trim();
+    if (code.startsWith('```')) {
+      code = code.replace(/^```(?:javascript|js)?\s*\n?/, '').replace(/\n?```\s*$/, '');
+    }
+    return code;
+  }
+
+  function toModel(_args, result, outcome) {
+    return result?.success
+      ? (result.result || (result.logs && result.logs.length > 0 ? result.logs.join('\n') : 'undefined'))
+      : `Error: ${result?.error || outcome?.error || 'Error de ejecución'}`;
+  }
+
+  function toMarkdown(args, result, outcome) {
+    const code = getCode(args);
+    const output = toModel(args, result, outcome);
+    return `> ⚡ **execute_javascript**\n> \`\`\`javascript\n> ${code.split('\n').join('\n> ')}\n> \`\`\`\n> \`\`\`\n> ${String(output).split('\n').join('\n> ')}\n> \`\`\``;
+  }
+
+  function createCardWrapper(ui) {
+    if (ui?.createCardWrapper) return ui.createCardWrapper();
+    const doc = ui?.document || (typeof document !== 'undefined' ? document : null);
+    if (!doc) return null;
+    const cardDiv = doc.createElement('div');
+    cardDiv.className = 'tool-card-wrapper';
+    return cardDiv;
+  }
+
+  const safeEscapeHtml = (value) => String(value || '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+
+  function getUiHelpers(ui) {
+    return {
+      Markdown: ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || (typeof window !== 'undefined' && window.ChatUtils) || { escapeHtml: safeEscapeHtml },
+      t: ui?.t || ((key) => key),
+      spinner: ui?.SPINNER_SVG || '',
+      checkSvg: ui?.CHECK_SVG || '',
+      errorSvg: ui?.ERROR_SVG || '',
+      chevron: ui?.CHEVRON_SVG || ''
+    };
+  }
+
+  const JS_ICON_SVG = '<svg class="ui-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="4 17 10 11 4 5"></polyline><line x1="12" y1="19" x2="20" y2="19"></line></svg>';
+
+  function createLiveCard(args, ui) {
+    const cardDiv = createCardWrapper(ui);
+    if (!cardDiv) return null;
+    const { Markdown, t, spinner, chevron } = getUiHelpers(ui);
+    const code = getCode(args);
+    cardDiv.innerHTML = `
+      <div class="tool-execution-card">
+        <div class="tool-card-header">
+          <div class="tool-card-title">
+            <span>${JS_ICON_SVG}</span>
+            <span>${t('tool_js_title_running') || 'execute_javascript'}</span>
+          </div>
+          <div class="tool-card-header-actions">
+            <span class="tool-card-badge status-loading">${spinner} <span>${t('tool_badge_executing') || 'Ejecutando...'}</span></span>
+            <button type="button" class="btn-tool-collapse" title="${t('tool_btn_collapse') || 'Minimizar'}">${chevron}</button>
+          </div>
+        </div>
+        <div class="tool-card-collapsible-body">
+          <pre class="tool-card-code"><code>${Markdown.escapeHtml(code)}</code></pre>
+          <div class="tool-card-result">
+            <div class="tool-loading-placeholder">${spinner} <span>${t('tool_loading_js') || 'Ejecutando código JavaScript...'}</span></div>
+          </div>
+        </div>
+      </div>
+    `;
+    return cardDiv;
+  }
+
+  function updateLiveCard(cardDiv, _args, result = {}, elapsedMs = 0, ui) {
+    if (!cardDiv) return;
+    const { Markdown, t, checkSvg, errorSvg } = getUiHelpers(ui);
+    const isSuccess = result?.success !== false && !result?.error;
+    const badgeEl = cardDiv.querySelector('.tool-card-badge');
+    if (badgeEl) {
+      badgeEl.className = `tool-card-badge ${isSuccess ? 'status-success' : 'status-error'}`;
+      badgeEl.innerHTML = isSuccess
+        ? `${checkSvg} <span>${t('tool_status_success') || 'Completado'} (${elapsedMs || 0}ms)</span>`
+        : `${errorSvg} <span>Error (${elapsedMs || 0}ms)</span>`;
+    }
+    const resContainer = cardDiv.querySelector('.tool-card-result');
+    if (resContainer) {
+      const output = isSuccess
+        ? (result.result || (result.logs && result.logs.length > 0 ? result.logs.join('\n') : 'undefined'))
+        : `Error: ${result.error || 'Error de ejecución'}`;
+      const cleanOutput = String(output ?? '').trim();
+      resContainer.innerHTML = `<div class="tool-result-label">${t('tool_sandbox_output') || 'Resultado:'}</div><pre class="tool-result-pre"><code>${Markdown.escapeHtml(cleanOutput)}</code></pre>`;
+    }
+  }
+
+  function renderHistoricalCard(args, toolMessage, ui) {
+    const cardDiv = createCardWrapper(ui);
+    if (!cardDiv) return null;
+    const { Markdown, t, checkSvg, chevron } = getUiHelpers(ui);
+    let output = '';
+    if (toolMessage?.content) {
+      try {
+        const parsed = JSON.parse(toolMessage.content);
+        output = parsed.result || (parsed.logs && parsed.logs.length > 0
+          ? parsed.logs.join('\n')
+          : (parsed.error ? `Error: ${parsed.error}` : toolMessage.content));
+      } catch (e) {
+        output = toolMessage.content;
+      }
+    }
+    const cleanOutput = String(output ?? '').trim();
+    cardDiv.innerHTML = `
+      <div class="tool-execution-card">
+        <div class="tool-card-header">
+          <div class="tool-card-title"><span>${JS_ICON_SVG}</span><span>${t('tool_js_title_running') || 'execute_javascript'}</span></div>
+          <div class="tool-card-header-actions">
+            <span class="tool-card-badge status-success">${checkSvg} <span>${t('tool_status_success') || 'Completado'}</span></span>
+            <button type="button" class="btn-tool-collapse" title="${t('tool_btn_collapse') || 'Minimizar'}">${chevron}</button>
+          </div>
+        </div>
+        <div class="tool-card-collapsible-body">
+          <pre class="tool-card-code"><code>${Markdown.escapeHtml(getCode(args).trim())}</code></pre>
+          <div class="tool-card-result"><div class="tool-result-label">${t('tool_sandbox_output') || 'Resultado:'}</div><pre class="tool-result-pre"><code>${Markdown.escapeHtml(cleanOutput)}</code></pre></div>
+        </div>
+      </div>
+    `;
+    return cardDiv;
+  }
+
+  function createTool(Tool) {
+    if (typeof Tool !== 'function') {
+      throw new Error('La clase Tool es necesaria para crear execute_javascript.');
+    }
+
+    return new Tool({
+      id: definition.name,
+      definition,
+      aliases: ['executejs', 'execute_js', 'run_javascript', 'run_js', 'javascript', 'evaljs'],
+      category: 'computation',
+      metadata: { icon: 'zap', label: definition.name },
+      settings: {
+        titleKey: 'agent_js_title',
+        titleFallback: 'Ejecución de JavaScript (Cálculos locales)',
+        descKey: 'agent_js_desc',
+        descFallback: 'Permite al modelo invocar execute_javascript para calcular, procesar datos o validar algoritmos directamente en el navegador bajo supervisión técnica.',
+        icon: 'zap',
+        defaultEnabled: true,
+        showInSettings: true
+      },
+      promptGuide: () => '- `execute_javascript(code="...")`: Runs JavaScript locally in an isolated worker to assist with calculations and logic. Always use `return <value>` or `console.log(...)` to output results.',
+      execute: async (args, context = {}) => {
+        const Sandbox = context.services?.sandbox;
+        if (!Sandbox || !Sandbox.execute) {
+          return { success: false, error: 'Módulo de ejecución de JavaScript no disponible.' };
+        }
+        const timeoutMs = typeof context.timeoutMs === 'number'
+          ? context.timeoutMs
+          : (typeof context.options?.timeoutMs === 'number' ? context.options.timeoutMs : undefined);
+        return Sandbox.execute(getCode(args), timeoutMs);
+      },
+      result: { toModel, toMarkdown },
+      displayMode: 'collapsed',
+      view: { id: 'execute_javascript', displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard }
+    });
+  }
+
+  const toolModule = {
+    id: definition.name,
+    definition,
+    displayMode: 'collapsed',
+    createTool,
+    getCode,
+    toModel,
+    toMarkdown,
+    view: { id: 'execute_javascript', displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard }
+  };
+
+  function registerWithBuiltinManifest() {
+    let manifestApi = null;
+    if (typeof window !== 'undefined' && window.ChatToolManifest) {
+      manifestApi = window.ChatToolManifest;
+    } else if (typeof require !== 'undefined') {
+      try { manifestApi = require('../tool-manifest.js'); } catch (e) {}
+    }
+    if (manifestApi?.builtin && !manifestApi.builtin.has(toolModule.id)) {
+      manifestApi.builtin.register(toolModule);
+    }
+  }
+
+  registerWithBuiltinManifest();
+  return toolModule;
+});

zerochat_runtime/assets/js/tools/builtin/fetch-web-page.tool.js

@@ -0,0 +1,112 @@
+/** Tool autocontenida: fetch_web_page. */
+(function (root, factory) {
+  if (typeof exports === 'object' && typeof module !== 'undefined') module.exports = factory();
+  else root.ChatBuiltinFetchWebPageTool = factory();
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const definition = {
+    name: 'fetch_web_page',
+    description: 'Downloads and reads the text and content of a public web page or HTML article from its URL (e.g. "https://en.wikipedia.org/wiki/Sun").',
+    parameters: { type: 'object', properties: { url: { type: 'string', description: 'URL of the web page to read.' } }, required: ['url'] }
+  };
+
+  function getUrl(args) {
+    return args?.url || args?.URL || args?.uri || args?.link || args?.href || args?.path || args?.input || (typeof args === 'string' ? args : '');
+  }
+
+  function createCardWrapper(ui) {
+    if (ui?.createCardWrapper) return ui.createCardWrapper();
+    const doc = ui?.document || (typeof document !== 'undefined' ? document : null);
+    if (!doc) return null;
+    const cardDiv = doc.createElement('div');
+    cardDiv.className = 'tool-card-wrapper';
+    return cardDiv;
+  }
+
+  const GLOBE_ICON_SVG = '<svg class="ui-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"></circle><line x1="2" y1="12" x2="22" y2="12"></line><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"></path></svg>';
+
+  function getHtmlSafety() {
+    if (typeof window !== 'undefined' && window.ChatUtils) return window.ChatUtils;
+    if (typeof require !== 'undefined') { try { return require('../../utils.js'); } catch (_) {} }
+    return { escapeHtml: () => '', sanitizeUrl: () => '#' };
+  }
+
+  function createLiveCard(args, ui) {
+    const cardDiv = createCardWrapper(ui);
+    if (!cardDiv) return null;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || getHtmlSafety();
+    const t = ui?.t || ((key) => key);
+    const spinner = ui?.SPINNER_SVG || '';
+    const chevron = ui?.CHEVRON_SVG || '';
+    const url = getUrl(args);
+    cardDiv.innerHTML = `<div class="web-request-card"><div class="web-card-header"><div class="web-card-title"><span>${GLOBE_ICON_SVG}</span><span>${t('tool_web_title')}</span></div><div class="tool-card-header-actions"><span class="web-card-badge status-loading">${spinner} <span>${t('tool_badge_fetching') || 'Consultando...'}</span></span><button type="button" class="btn-tool-collapse" title="${t('tool_btn_collapse') || 'Minimizar'}">${chevron}</button></div></div><div class="tool-card-collapsible-body"><div class="web-card-section web-request-section"><div class="section-label">${t('tool_web_requested_url')}</div><div class="url-badge"><a href="${Markdown.sanitizeUrl(url)}" target="_blank" rel="noopener noreferrer">${Markdown.escapeHtml(url)}</a></div></div><div class="web-card-section web-response-section"><div class="section-label section-response-label">${t('tool_web_receiving') || 'Recibiendo contenido...'}</div><div class="web-response-body tool-loading-placeholder">${spinner} <span>${t('tool_loading_web')}</span></div></div></div></div>`;
+    return cardDiv;
+  }
+
+  function updateLiveCard(cardDiv, _args, result = {}, elapsedMs = 0, ui) {
+    if (!cardDiv) return;
+    const Markdown = ui?.markdown || (typeof window !== 'undefined' && window.ChatMarkdown) || getHtmlSafety();
+    const t = ui?.t || ((key) => key);
+    const checkSvg = ui?.CHECK_SVG || '';
+    const errorSvg = ui?.ERROR_SVG || '';
+    const success = result?.success !== false && !result?.error;
+    const status = result?.status || (success ? 200 : 500);
+    const content = result?.content || result?.error || '';
+    const badge = cardDiv.querySelector('.web-card-badge');
+    if (badge) {
+      badge.className = `web-card-badge ${success ? 'status-success' : 'status-error'}`;
+      badge.innerHTML = success
+        ? `${checkSvg} <span>HTTP ${status} OK (${elapsedMs || 0}ms)</span>`
+        : `${errorSvg} <span>HTTP ${status} Error (${elapsedMs || 0}ms)</span>`;
+    }
+    const label = cardDiv.querySelector('.section-response-label');
+    if (label) label.textContent = t('tool_web_content_received', { size: `${content.length} chars` }) || `Contenido recibido (${content.length} caracteres):`;
+    const body = cardDiv.querySelector('.web-response-body');
+    if (body) { body.className = 'web-response-body'; body.innerHTML = `<code>${Markdown.escapeHtml(content.slice(0, 1500))}${content.length > 1500 ? '...' : ''}</code>`; }
+  }
+
+  function renderHistoricalCard(args, toolMessage, ui) {
+    const cardDiv = createLiveCard(args, ui);
+    if (!cardDiv) return null;
+    let result = {};
+    if (toolMessage?.content) { try { result = JSON.parse(toolMessage.content); } catch (e) { result = { content: toolMessage.content }; } }
+    updateLiveCard(cardDiv, args, result, 0, ui);
+    return cardDiv;
+  }
+
+  function createTool(Tool) {
+    if (typeof Tool !== 'function') throw new Error('La clase Tool es necesaria para crear fetch_web_page.');
+    return new Tool({
+      id: definition.name,
+      definition,
+      aliases: ['fetchwebpage', 'fetch_web', 'fetch_url', 'get_web_page', 'read_web_page', 'web_fetch', 'browse_web', 'webpage'],
+      category: 'web',
+      metadata: { icon: 'globe', label: definition.name },
+      settings: {
+        titleKey: 'agent_web_title', titleFallback: 'Navegación Web en Tiempo Real',
+        descKey: 'agent_web_desc', descFallback: 'Permite al modelo invocar fetch_web_page para consultar páginas web públicas y extraer su contenido textual en tiempo real.',
+        icon: 'globe', defaultEnabled: true, showInSettings: true
+      },
+      promptGuide: () => '- `fetch_web_page(url="...")`: Downloads and extracts clean text content from public web pages or HTML articles.',
+      execute: async (args, context = {}) => {
+        const WebBrowser = context.services?.webBrowser;
+        if (!WebBrowser || !WebBrowser.fetchPage) return { success: false, error: 'Módulo WebBrowser no disponible.' };
+        return WebBrowser.fetchPage(getUrl(args), context.options || {});
+      },
+      result: {
+        toModel: (_args, result) => JSON.stringify(result || {}),
+        toMarkdown: (args) => `> **fetch_web_page**\n> URL: "${args.url || ''}"\n\n`
+      },
+      displayMode: 'collapsed',
+      view: { id: definition.name, displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard }
+    });
+  }
+
+  const toolModule = { id: definition.name, definition, displayMode: 'collapsed', createTool, getUrl, view: { id: definition.name, displayMode: 'collapsed', createLiveCard, updateLiveCard, renderHistoricalCard } };
+  let manifestApi = null;
+  if (typeof window !== 'undefined' && window.ChatToolManifest) manifestApi = window.ChatToolManifest;
+  else if (typeof require !== 'undefined') { try { manifestApi = require('../tool-manifest.js'); } catch (e) {} }
+  if (manifestApi?.builtin && !manifestApi.builtin.has(toolModule.id)) manifestApi.builtin.register(toolModule);
+  return toolModule;
+});