@easynet/agent-tool 1.0.0

package/dist/registry/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,sCAAsC;IACtC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAM9B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,EAAE;IA0C1C;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/report/AgentReportGenerator.d.ts

@@ -0,0 +1,53 @@
+import type { AgentReportData, AgentReportStep, CollectStreamStepsOptions, CollectStreamStepsResult, RunAgentWithReportOptions, RunAgentWithReportResult, StreamableAgent, WriteReportFromStreamOptions } from "./types.js";
+/** Path to the default HTML template (dist/report/ when built, src/report/ in dev). */
+export declare const DEFAULT_REPORT_TEMPLATE_PATH: string;
+/**
+ * Generate an HTML report from template and data.
+ * Uses the built-in HTML template file when templatePath is not provided.
+ *
+ * @param data - Report data (prompts, markdown, steps)
+ * @param options.outputPath - Path to write the HTML file (required)
+ * @param options.templatePath - Path to a custom HTML template (optional; uses built-in file if not set)
+ * @returns Path to the written file
+ */
+export declare function generateAgentReport(data: AgentReportData, options: {
+    outputPath: string;
+    templatePath?: string;
+}): string;
+/**
+ * Serialize a stream chunk value for the report (messages and metadata to plain JSON).
+ */
+export declare function serializeStepOutput(value: unknown): unknown;
+/**
+ * Format a step for console progress (e.g. "[1] agent | tools → foo | tokens: in=10 out=5").
+ */
+export declare function formatStepProgress(step: AgentReportStep): string;
+/**
+ * Consume an agent stream and collect steps. Optionally call onStep for each step (e.g. progress logging).
+ * Also captures the last AI message content for use as report body when no reportPath is provided.
+ *
+ * @param stream - AsyncIterable from agent.stream()
+ * @param options.onStep - Called for each step
+ * @returns Collected steps and last AI content
+ */
+export declare function collectStreamSteps(stream: AsyncIterable<Record<string, unknown>>, options?: CollectStreamStepsOptions): Promise<CollectStreamStepsResult>;
+/**
+ * Run an agent stream, collect steps, optionally read report file and write HTML report.
+ * Use this to support progress callbacks and HTML report generation at the framework level.
+ *
+ * @param agent - Agent with .stream(input, config) (e.g. LangChain createAgent())
+ * @param input - Input to agent.stream()
+ * @param options - systemPrompt, userPrompt, reportPath, htmlReportPath, templatePath, streamConfig, onStep
+ * @returns { steps, reportMarkdown, htmlPath? }
+ */
+export declare function runAgentWithReport(agent: StreamableAgent, input: unknown, options: RunAgentWithReportOptions): Promise<RunAgentWithReportResult>;
+/**
+ * Consume an agent stream and optionally write the HTML report.
+ * Use this with regular LangChain usage: get the stream from agent.stream(), then pass it here.
+ *
+ * @param stream - Stream from agent.stream(input, config)
+ * @param options - systemPrompt, userPrompt, reportPath?, htmlReportPath?, templatePath?, onStep?
+ * @returns { steps, reportMarkdown, htmlPath? }
+ */
+export declare function writeReportFromStream(stream: AsyncIterable<Record<string, unknown>>, options: WriteReportFromStreamOptions): Promise<RunAgentWithReportResult>;
+//# sourceMappingURL=AgentReportGenerator.d.ts.map

package/dist/report/AgentReportGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentReportGenerator.d.ts","sourceRoot":"","sources":["../../src/report/AgentReportGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,EACf,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AASpB,uFAAuF;AACvF,eAAO,MAAM,4BAA4B,QAKrC,CAAC;AAEL;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAsB3D;AAeD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAiBhE;AA0DD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9C,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,wBAAwB,CAAC,CA0CnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CA4BnC"}

package/dist/report/agent-report-template.html

@@ -0,0 +1,362 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Agent Run Report</title>
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet">
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.1/font/bootstrap-icons.css" rel="stylesheet">
+  <style>
+    :root {
+      --report-bg: #f0f4f8;
+      --report-surface: #ffffff;
+      --report-border: #e2e6ea;
+      --report-border-light: #eef0f2;
+      --report-text: #2c3e50;
+      --report-text-muted: #5c6b7a;
+      --report-accent: #2563eb;
+      --report-accent-hover: #1d4ed8;
+      --report-accent-bg: #eff6ff;
+      --report-secondary: #059669;
+      --report-secondary-bg: #ecfdf5;
+      --report-code-bg: #f1f5f9;
+      --report-prompt-bg: #f8fafc;
+      --report-heading: #1e40af;
+      --report-heading-alt: #047857;
+      --report-tint: #e0e7ff;
+      --report-table-head: #dbeafe;
+      --report-table-head-text: #1e3a8a;
+    }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      background: var(--report-bg);
+      color: var(--report-text);
+      font-size: 15px;
+      line-height: 1.55;
+    }
+    .report-header {
+      background: linear-gradient(135deg, #ffffff 0%, #f0f9ff 100%);
+      border-bottom: 3px solid var(--report-accent);
+      box-shadow: 0 1px 3px rgba(37, 99, 235, 0.08);
+    }
+    .report-title {
+      font-weight: 600;
+      color: var(--report-accent);
+      font-size: 1.1rem;
+      letter-spacing: -0.01em;
+    }
+    .report-header .form-label {
+      color: var(--report-secondary);
+      font-weight: 600;
+      letter-spacing: 0.02em;
+    }
+    .prompt-block {
+      background: var(--report-prompt-bg);
+      border: 1px solid var(--report-tint);
+      border-left: 4px solid var(--report-accent);
+      border-radius: 6px;
+      font-size: 0.9rem;
+      word-break: break-word;
+      color: var(--report-text);
+    }
+    .prompt-block.markdown-body { white-space: normal; padding: 1rem 1.25rem; }
+    .nav-tabs {
+      border-bottom: 2px solid var(--report-border);
+    }
+    .nav-tabs .nav-link {
+      color: var(--report-text-muted);
+      font-weight: 500;
+      border: none;
+      padding: 0.5rem 1rem 0.6rem;
+      margin-bottom: -2px;
+    }
+    .nav-tabs .nav-link:hover { color: var(--report-accent); }
+    .nav-tabs .nav-link.active {
+      color: var(--report-accent);
+      border-bottom: 2px solid var(--report-accent);
+      background: var(--report-accent-bg);
+    }
+    .card {
+      background: var(--report-surface);
+      border: 1px solid var(--report-border-light);
+      border-radius: 8px;
+      box-shadow: 0 1px 3px rgba(0,0,0,0.06);
+    }
+    .card-header {
+      background: var(--report-surface);
+      border-bottom: 1px solid var(--report-tint);
+      color: var(--report-heading);
+      font-weight: 600;
+    }
+    .step-tree { list-style: none; padding-left: 0; }
+    .step-tree .step-item {
+      padding: 0.5rem 0.75rem;
+      border-radius: 4px;
+      cursor: pointer;
+      border-left: 3px solid transparent;
+      color: var(--report-text);
+    }
+    .step-tree .step-item:hover { background: var(--report-accent-bg); }
+    .step-tree .step-item.active {
+      background: var(--report-accent-bg);
+      border-left-color: var(--report-accent);
+    }
+    .step-tree .step-item .step-node { font-weight: 500; }
+    .step-tree .step-item .step-meta { font-size: 0.8rem; color: var(--report-text-muted); }
+    .detail-panel {
+      background: var(--report-surface);
+      border-radius: 6px;
+      border: 1px solid var(--report-border-light);
+      min-height: 200px;
+    }
+    .detail-section { margin-bottom: 1rem; }
+    .detail-section h6 {
+      color: var(--report-secondary);
+      font-weight: 600;
+      margin-bottom: 0.5rem;
+      font-size: 0.8rem;
+      text-transform: uppercase;
+      letter-spacing: 0.03em;
+    }
+    .detail-pre {
+      background: var(--report-code-bg);
+      border: 1px solid var(--report-tint);
+      padding: 1rem 1.25rem;
+      border-radius: 4px;
+      font-size: 0.8rem;
+      overflow-x: auto;
+      max-height: 400px;
+      overflow-y: auto;
+      color: var(--report-text);
+    }
+    .markdown-body {
+      padding: 1.5rem 1.75rem;
+      color: var(--report-text);
+      font-size: 1rem;
+      line-height: 1.6;
+    }
+    .markdown-body h1 {
+      font-size: 1.375rem;
+      font-weight: 600;
+      color: var(--report-heading);
+      margin: 0 0 0.25rem 0;
+      line-height: 1.3;
+    }
+    .markdown-body h1 + p {
+      font-size: 0.9375rem;
+      color: var(--report-text-muted);
+      margin-top: 0;
+      margin-bottom: 1.25rem;
+    }
+    .markdown-body h2 {
+      font-size: 1.125rem;
+      font-weight: 600;
+      color: var(--report-heading);
+      margin: 1.5rem 0 0.5rem 0;
+      padding-bottom: 0.25rem;
+      border-bottom: 2px solid var(--report-tint);
+    }
+    .markdown-body h3 {
+      font-size: 1.0625rem;
+      font-weight: 600;
+      color: var(--report-heading-alt);
+      margin: 1.25rem 0 0.4rem 0;
+    }
+    .markdown-body h4 { font-size: 1rem; font-weight: 600; margin: 1rem 0 0.35rem 0; color: var(--report-heading-alt); }
+    .markdown-body p {
+      margin: 0 0 0.75rem 0;
+      font-size: 1rem;
+    }
+    .markdown-body ul, .markdown-body ol { margin: 0 0 0.75rem 0; padding-left: 1.5rem; }
+    .markdown-body li { margin-bottom: 0.25rem; }
+    .markdown-body table {
+      font-size: 0.9375rem;
+      margin: 0.75rem 0;
+      border-collapse: collapse;
+      width: 100%;
+    }
+    .markdown-body th, .markdown-body td {
+      padding: 0.5rem 0.75rem;
+      border: 1px solid var(--report-tint);
+      text-align: left;
+    }
+    .markdown-body th {
+      font-weight: 600;
+      background: var(--report-table-head);
+      color: var(--report-table-head-text);
+      border-color: var(--report-accent);
+    }
+    .markdown-body tbody tr:nth-child(even) { background: var(--report-secondary-bg); }
+    .markdown-body pre, .markdown-body code {
+      background: var(--report-code-bg);
+      border: 1px solid var(--report-tint);
+      border-radius: 4px;
+      color: var(--report-text);
+      font-size: 0.875rem;
+    }
+    .markdown-body pre { padding: 1rem 1.25rem; overflow-x: auto; }
+    .empty-state { color: var(--report-text-muted); text-align: center; padding: 2rem; }
+  </style>
+</head>
+<body>
+  <div class="report-header py-3 px-4">
+    <h5 class="report-title mb-3">Agent Run Report</h5>
+    <div class="row g-3">
+      <div class="col-12">
+        <label class="form-label small text-muted text-uppercase">System Prompt</label>
+        <div class="prompt-block markdown-body" id="system-prompt"></div>
+      </div>
+      <div class="col-12">
+        <label class="form-label small text-muted text-uppercase">User Prompt</label>
+        <div class="prompt-block markdown-body" id="user-prompt"></div>
+      </div>
+    </div>
+  </div>
+
+  <div class="container-fluid py-3">
+    <ul class="nav nav-tabs mb-3" role="tablist">
+      <li class="nav-item">
+        <a class="nav-link active" data-bs-toggle="tab" href="#tab-report">Report</a>
+      </li>
+      <li class="nav-item">
+        <a class="nav-link" data-bs-toggle="tab" href="#tab-debug">Debug</a>
+      </li>
+    </ul>
+
+    <div class="tab-content">
+      <div class="tab-pane fade show active" id="tab-report">
+        <div class="card border-0 shadow-sm">
+          <div class="card-body markdown-body" id="report-markdown"></div>
+        </div>
+      </div>
+      <div class="tab-pane fade" id="tab-debug">
+        <div class="row g-3">
+          <div class="col-md-4">
+            <div class="card border-0 shadow-sm h-100">
+              <div class="card-header bg-white border-bottom py-2">
+                <span class="fw-semibold">Steps</span>
+              </div>
+              <div class="card-body p-0 overflow-auto" style="max-height: 70vh;">
+                <ul class="step-tree list-unstyled mb-0 p-2" id="step-tree"></ul>
+              </div>
+            </div>
+          </div>
+          <div class="col-md-8">
+            <div class="card border-0 shadow-sm h-100">
+              <div class="card-header bg-white border-bottom py-2">
+                <span class="fw-semibold">Step Detail</span>
+                <span class="text-muted small ms-2" id="step-detail-title"></span>
+              </div>
+              <div class="card-body detail-panel">
+                <div id="step-detail-empty" class="empty-state">Select a step</div>
+                <div id="step-detail-content" class="d-none">
+                  <div class="detail-section">
+                    <h6>Input</h6>
+                    <pre class="detail-pre mb-0" id="step-input"></pre>
+                  </div>
+                  <div class="detail-section">
+                    <h6>Output</h6>
+                    <pre class="detail-pre mb-0" id="step-output"></pre>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+  <script type="application/json" id="agent-report-data">__REPORT_DATA__</script>
+  <script>
+    (function() {
+      const el = document.getElementById('agent-report-data');
+      const raw = el && el.textContent ? el.textContent.trim() : '{}';
+      let data = {};
+      try {
+        data = raw === '' ? {} : JSON.parse(raw);
+      } catch (e) {
+        console.error('Invalid report data', e);
+      }
+
+      const systemPrompt = data.systemPrompt || '';
+      const userPrompt = data.userPrompt || '';
+      const reportMarkdown = data.reportMarkdown || '';
+      const steps = Array.isArray(data.steps) ? data.steps : [];
+
+      const markdownOpts = { gfm: true, breaks: true };
+      function renderMarkdown(elId, text, fallback) {
+        const el = document.getElementById(elId);
+        if (!el) return;
+        const content = (text || '').trim();
+        if (!content) {
+          el.innerHTML = fallback ? '<p class="text-muted">' + fallback + '</p>' : '';
+          return;
+        }
+        if (typeof marked !== 'undefined') {
+          el.innerHTML = marked.parse(content, markdownOpts);
+        } else {
+          el.textContent = content;
+        }
+      }
+      renderMarkdown('system-prompt', systemPrompt, '(none)');
+      renderMarkdown('user-prompt', userPrompt, '(none)');
+
+      if (reportMarkdown) {
+        if (typeof marked !== 'undefined') {
+          document.getElementById('report-markdown').innerHTML = marked.parse(reportMarkdown, markdownOpts);
+        } else {
+          document.getElementById('report-markdown').textContent = reportMarkdown;
+        }
+      } else {
+        document.getElementById('report-markdown').innerHTML = '<p class="text-muted">No report content.</p>';
+      }
+
+      const treeEl = document.getElementById('step-tree');
+      const detailTitle = document.getElementById('step-detail-title');
+      const detailEmpty = document.getElementById('step-detail-empty');
+      const detailContent = document.getElementById('step-detail-content');
+      const inputPre = document.getElementById('step-input');
+      const outputPre = document.getElementById('step-output');
+
+      steps.forEach(function(s, i) {
+        const li = document.createElement('li');
+        li.className = 'step-item';
+        li.dataset.index = String(i);
+        const node = s.node || '?';
+        const meta = [];
+        if (s.toolCalls && s.toolCalls.length) meta.push(s.toolCalls.map(function(t) { return t.name; }).join(', '));
+        if (s.usage) meta.push('tokens: ' + (s.usage.total_tokens || (s.usage.input_tokens + s.usage.output_tokens) || '-'));
+        li.innerHTML = '<span class="step-node">[' + (i + 1) + '] ' + escapeHtml(node) + '</span>' +
+          (meta.length ? '<div class="step-meta mt-1">' + escapeHtml(meta.join(' | ')) + '</div>' : '');
+        li.addEventListener('click', function() {
+          document.querySelectorAll('.step-tree .step-item.active').forEach(function(x) { x.classList.remove('active'); });
+          li.classList.add('active');
+          detailEmpty.classList.add('d-none');
+          detailContent.classList.remove('d-none');
+          detailTitle.textContent = 'Step ' + (i + 1) + ' — ' + node;
+          inputPre.textContent = formatJson(s.input);
+          outputPre.textContent = formatJson(s.output);
+        });
+        treeEl.appendChild(li);
+      });
+
+      function escapeHtml(str) {
+        const div = document.createElement('div');
+        div.textContent = str;
+        return div.innerHTML;
+      }
+      function formatJson(obj) {
+        if (obj === undefined || obj === null) return '(none)';
+        try {
+          return JSON.stringify(obj, null, 2);
+        } catch (e) {
+          return String(obj);
+        }
+      }
+    })();
+  </script>
+</body>
+</html>

package/dist/report/index.d.ts

@@ -0,0 +1,3 @@
+export { generateAgentReport, serializeStepOutput, formatStepProgress, collectStreamSteps, runAgentWithReport, writeReportFromStream, } from "./AgentReportGenerator.js";
+export type { AgentReportData, AgentReportStep, StreamableAgent, CollectStreamStepsOptions, CollectStreamStepsResult, RunAgentWithReportOptions, RunAgentWithReportResult, WriteReportFromStreamOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/report/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Step data for the agent run report (serializable).
+ */
+export interface AgentReportStep {
+    stepIndex: number;
+    node: string;
+    input?: unknown;
+    output?: unknown;
+    toolCalls?: Array<{
+        name: string;
+        args?: Record<string, unknown>;
+    }>;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        total_tokens?: number;
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    };
+}
+/**
+ * Data passed to the HTML report template.
+ */
+export interface AgentReportData {
+    systemPrompt: string;
+    userPrompt: string;
+    reportMarkdown: string;
+    steps: AgentReportStep[];
+}
+/**
+ * Agent-like interface: has stream(input, config) returning AsyncIterable.
+ */
+export interface StreamableAgent {
+    stream(input: unknown, config?: {
+        recursionLimit?: number;
+        [key: string]: unknown;
+    }): Promise<AsyncIterable<Record<string, unknown>>>;
+}
+/**
+ * Options for collecting steps from an agent stream.
+ */
+export interface CollectStreamStepsOptions {
+    /** Called for each step (e.g. to log progress). */
+    onStep?: (step: AgentReportStep) => void;
+}
+/**
+ * Result of collectStreamSteps (steps plus last AI message content for report tab).
+ */
+export interface CollectStreamStepsResult {
+    steps: AgentReportStep[];
+    /** Last AI message content from the stream (for Report tab when no reportPath). */
+    lastAiContent: string;
+}
+/**
+ * Options for runAgentWithReport.
+ */
+export interface RunAgentWithReportOptions {
+    /** System prompt (for report header and HTML). */
+    systemPrompt: string;
+    /** User prompt (for report header and HTML). */
+    userPrompt: string;
+    /** Path to markdown report file to read after run (optional). */
+    reportPath?: string;
+    /** Path to write the HTML report (required if writing report). */
+    htmlReportPath?: string;
+    /** Path to HTML template (optional). */
+    templatePath?: string;
+    /** Passed to agent.stream(input, streamConfig). */
+    streamConfig?: {
+        recursionLimit?: number;
+        [key: string]: unknown;
+    };
+    /** Called for each step during stream (e.g. console progress). */
+    onStep?: (step: AgentReportStep) => void;
+}
+/**
+ * Result of runAgentWithReport and writeReportFromStream.
+ */
+export interface RunAgentWithReportResult {
+    steps: AgentReportStep[];
+    reportMarkdown: string;
+    htmlPath?: string;
+}
+/**
+ * Options for writeReportFromStream (pass stream from agent.stream() to generate report).
+ */
+export interface WriteReportFromStreamOptions {
+    /** System prompt (for report header and HTML). */
+    systemPrompt: string;
+    /** User prompt (for report header and HTML). */
+    userPrompt: string;
+    /** Path to markdown report file to read after stream ends (optional). */
+    reportPath?: string;
+    /** Path to write the HTML report (optional). */
+    htmlReportPath?: string;
+    /** Path to custom HTML template (optional; uses built-in if not set). */
+    templatePath?: string;
+    /** Called for each step while consuming the stream (e.g. console progress). */
+    onStep?: (step: AgentReportStep) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/report/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/report/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACpE,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CACJ,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAC3D,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,YAAY,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACnE,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1C"}

package/dist/runAgent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Run ReAct agent using agent.yaml: llm section from agent-llm, tools from builtin + example.
+ * Use: runAgent(agentYamlPath, task, options).
+ */
+import type { ReActAgentRunOptions, ReActAgentRunResult } from "./llm/ReActAgent.js";
+export interface AgentRunConfig {
+    /** Path to agent.yaml (default: cwd/agent.yaml) */
+    configPath?: string;
+    /** User task (instruction) */
+    task: string;
+    /** System prompt (optional) */
+    systemPrompt?: string;
+    /** ReAct run options (maxSteps, timeoutMs) */
+    runOptions?: ReActAgentRunOptions;
+    /** Sandbox root for core tools (default: cwd) */
+    sandboxRoot?: string;
+    /** Allowed hosts for HTTP/SSRF (default: ["*"]) */
+    allowedHosts?: string[];
+}
+export interface AgentRunResult extends ReActAgentRunResult {
+}
+/** Minimal agent.yaml shape: llm section (agent-llm format), optional tools list. */
+export interface AgentYamlShape {
+    llm?: unknown;
+    tools?: string[] | Record<string, unknown>;
+    mode?: string;
+}
+/**
+ * Load agent.yaml and return parsed llm section and optional tools.
+ */
+export declare function loadAgentConfig(configPath: string): AgentYamlShape;
+/**
+ * Run the ReAct agent: load agent.yaml llm section → create LLM from agent-llm →
+ * wrap with adapter → run ReActAgent with builtin + example tools.
+ */
+export declare function runAgent(configPath: string, task: string, options?: Omit<AgentRunConfig, "configPath" | "task">): Promise<AgentRunResult>;
+//# sourceMappingURL=runAgent.d.ts.map

package/dist/runAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAgent.d.ts","sourceRoot":"","sources":["../src/runAgent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAqB,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAexG,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;CAAG;AAE9D,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAMlE;AA0BD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,MAAM,CAAC,GACpD,OAAO,CAAC,cAAc,CAAC,CA6DzB"}

package/dist/runtime/Budget.d.ts

@@ -0,0 +1,63 @@
+import { type CircuitBreakerPolicy, type BulkheadPolicy } from "cockatiel";
+/**
+ * Budget configuration for a tool or global scope.
+ */
+export interface BudgetOptions {
+    /** Default timeout in ms for tool invocations */
+    defaultTimeoutMs?: number;
+    /** Max concurrent invocations per tool */
+    maxConcurrency?: number;
+    /** Rate limit: max calls per window */
+    rateLimit?: {
+        maxCalls: number;
+        windowMs: number;
+    };
+    /** Circuit breaker config */
+    circuitBreaker?: {
+        /** Number of consecutive failures before opening */
+        threshold: number;
+        /** Half-open reset time in ms */
+        halfOpenAfterMs: number;
+    };
+}
+/**
+ * Budget manager that provides timeout, rate limiting, concurrency control,
+ * and circuit breaker per tool.
+ */
+export declare class BudgetManager {
+    private readonly defaultTimeoutMs;
+    private readonly bulkheads;
+    private readonly circuitBreakers;
+    private readonly rateLimiters;
+    private readonly options;
+    constructor(options?: BudgetOptions);
+    /**
+     * Get effective timeout for a tool invocation.
+     */
+    getTimeout(_toolName: string, contextTimeoutMs?: number): number;
+    /**
+     * Check rate limit for a tool. Returns true if allowed.
+     */
+    checkRateLimit(toolName: string): boolean;
+    /**
+     * Get or create a bulkhead (concurrency limiter) for a tool.
+     */
+    getBulkhead(toolName: string): BulkheadPolicy | undefined;
+    /**
+     * Get or create a circuit breaker for a tool.
+     */
+    getCircuitBreaker(toolName: string): CircuitBreakerPolicy | undefined;
+    /**
+     * Execute a function within budget constraints (bulkhead + circuit breaker).
+     */
+    execute<T>(toolName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Reset all policies for a tool (useful for testing).
+     */
+    reset(toolName: string): void;
+    /**
+     * Reset all policies globally.
+     */
+    resetAll(): void;
+}
+//# sourceMappingURL=Budget.d.ts.map

package/dist/runtime/Budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Budget.d.ts","sourceRoot":"","sources":["../../src/runtime/Budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,6BAA6B;IAC7B,cAAc,CAAC,EAAE;QACf,oDAAoD;QACpD,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAiCD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,GAAE,aAAkB;IAKvC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAIhE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAazC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUzD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAarE;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBpE;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/runtime/Evidence.d.ts

@@ -0,0 +1,19 @@
+import type { ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+import type { Evidence } from "../types/ToolResult.js";
+/**
+ * Options for building evidence from a tool invocation.
+ */
+export interface BuildEvidenceOptions {
+    spec: ToolSpec;
+    args: unknown;
+    result: unknown;
+    raw?: unknown;
+    ctx: ExecContext;
+    durationMs?: number;
+}
+/**
+ * Build evidence records from a tool invocation result.
+ */
+export declare function buildEvidence(options: BuildEvidenceOptions): Evidence[];
+//# sourceMappingURL=Evidence.d.ts.map

package/dist/runtime/Evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Evidence.d.ts","sourceRoot":"","sources":["../../src/runtime/Evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,EAAE,CAgDvE"}